Expand description
Accessibility capability contract (R0 invariant: every surface declares what it can expose to the a11y tree; degradation is declared, never silent). Accessibility contract — the invariant every content surface declares about what it can expose to the accessibility tree, plus the renderer-neutral document projection that carries those semantics to a host.
Adopted from the donor graphshell SUBSYSTEM_ACCESSIBILITY.md (per the
docs harvest
§1 and the adoption roadmap
R0). This is the contract (the rule), not the full a11y implementation;
the host’s AccessKit bridge (platen domains → uxtree) consumes it when the
a11y slice lands.
§The three invariants
- Capability-declaration — every engine/surface declares its
A11yCapabilityin one place (a11y_capability/a11y_capability). The host never guesses a surface’s accessibility from its kind; it reads the declaration. - Non-silent-degradation — a surface that cannot expose its content
must declare a lower capability (
A11yCapability::Partial/A11yCapability::Opaque). It must never present asA11yCapability::Fullwhile silently dropping semantics. Degradation is declared, never silent — so the host can surface “you can’t inspect inside this” honestly (cf. the scrying DOM-bridge brief, which lifts a WebView tile fromOpaquetowardPartial). - Cross-surface-parity — every engine speaks this one vocabulary, so the host treats accessibility uniformly regardless of which engine backs a tile (a nematic document, a Genet page, a scrying WebView).
Structs§
- Document
A11y Action Request - A host request addressed to one local semantic node.
- Document
A11y Bounds - Bounds in the final, current document-session viewport coordinate space.
- Document
A11y Click Target - A current, revalidated point at which a host may issue its ordinary click
path.
revisionmakes a stale geometry observation detectable. - Document
A11y Node - One semantic node in a renderer-neutral document projection.
- Document
A11y Node Id - Stable, document-local semantic identity.
- Document
A11y Point - A point in the final, current document-session viewport coordinate space.
- Document
A11y Projection - Renderer-neutral semantic snapshot of the current retained document.
- Document
A11y State - Platform-neutral state for one semantic node.
- Document
A11y Support - Coverage and explicit limitations of an accessibility projection.
Enums§
- A11y
Capability - What a content surface can expose to the accessibility tree. The single vocabulary all engines/surfaces speak (invariant 3). Ordered worst-to-best so capability can be compared / clamped.
- Document
A11y Action - An action the engine advertises for a semantic node.
- Document
A11y Action Data - Data carried by an accessibility action request.
- Document
A11y HasPopup - The kind of popup a semantic node can present.
- Document
A11y Live - Announcement priority for live regions.
- Document
A11y Orientation - The primary direction of an oriented control or container.
- Document
A11y Role - Semantic role vocabulary shared by retained document engines.
- Document
A11y Support Error - Why a projection cannot claim complete semantic coverage.
- Document
A11y Toggled - The three-value state used by switch and toggle controls.