a2ui-project / a2ui-project/a2ui

[FEATURE]: Add catalog semantics metadata for roles, names, state, and interactions

未关闭
#2,242 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
P2 status: first-line-handled type: feature/enhancement
主要语言
TypeScript
星标
16.4k
派生
1.3k
平均合并
3 天 15 小时
30 天内合并 PR
134

描述

- [x] I have searched the existing issues to make sure this feature has not already been requested.

## Is your feature request related to a problem? Please describe.

Catalog schemas describe wire shape but not framework-neutral semantic role, accessible-name source, structural child slots, state/value bindings, or supported interactions. Renderers know this behavior in code; accessibility, testing, inspection, and policy tools otherwise hard-code component names or infer arbitrary property names.

## Describe the Proposed Solution

Define optional versioned declarative catalog metadata for semantic role, accessible-name source/normalization, structural slots, value/data-path and enabled/selected/checked/validation sources, and supported interactions with their binding/action property. Include it in catalog version/digest inputs. It must contain no executable callbacks, and tooling should fail closed when required metadata is absent.

## Describe Alternatives Considered

Component-name inference fails for custom catalogs. Inspecting Flutter widgets or a DOM is renderer-specific. Private registries fragment semantics and drift from the advertised catalog.

## Additional Context

#2197 covers action intent and #1528 covers schema-driven child resolution; both are complementary to this broader catalog-owned semantics contract.

贡献指南

打开贡献指南

调研方向

该 issue 提议向 catalog schema 添加声明式元数据。首先阅读现有的 catalog schema 定义以及相关 issue #2197 和 #1528。理解语义角色、可访问名称来源、结构槽位和状态绑定等概念。确定 catalog 元数据目前在代码库中的处理位置,以及如何在不使用可执行回调的情况下扩展它。

由索引模型根据 Issue 内容生成。

评估

技术栈
typescript
领域
backend-api-design, documentation
Issue 类型
功能
难度
5/5
预计耗时
一周以上
活跃度
活跃
描述清晰度
需要澄清
新手友好度
20/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。