a2ui-project / a2ui-project/a2ui

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

Offen
#2,242 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
P2 status: first-line-handled type: feature/enhancement
Vorherrschende Sprache
TypeScript
Sterne
16.4k
Forks
1.3k
Ø Merge
3 T. 15 Std.
Gemergte PRs (30 T.)
134

Beschreibung

- [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.

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Der Issue schlägt vor, deklarative Metadaten zu Katalogschemata hinzuzufügen. Beginne damit, die vorhandenen Definitionen der Katalogschemata und die zugehörigen Issues #2197 und #1528 zu lesen. Verstehe die Konzepte semantischer Rollen, der Quellen für zugängliche Namen, struktureller Slots und Zustandsbindungen. Ermittle, wo Katalogmetadaten derzeit in der Codebasis verarbeitet werden und wie sie ohne ausführbare Callbacks erweitert werden können.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
typescript
Bereich
backend-api-design, documentation
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Aktiv
Klarheit
Muss geklärt werden
Anfängerfreundlichkeit
20/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.