a2ui-project / a2ui-project/a2ui
[FEATURE]: Add catalog semantics metadata for roles, names, state, and interactions
- 主要语言
- 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