Skip to main content

Module a11y

Module a11y 

Source
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

  1. Capability-declaration — every engine/surface declares its A11yCapability in one place (a11y_capability / a11y_capability). The host never guesses a surface’s accessibility from its kind; it reads the declaration.
  2. Non-silent-degradation — a surface that cannot expose its content must declare a lower capability (A11yCapability::Partial / A11yCapability::Opaque). It must never present as A11yCapability::Full while 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 from Opaque toward Partial).
  3. 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§

DocumentA11yActionRequest
A host request addressed to one local semantic node.
DocumentA11yBounds
Bounds in the final, current document-session viewport coordinate space.
DocumentA11yClickTarget
A current, revalidated point at which a host may issue its ordinary click path. revision makes a stale geometry observation detectable.
DocumentA11yNode
One semantic node in a renderer-neutral document projection.
DocumentA11yNodeId
Stable, document-local semantic identity.
DocumentA11yPoint
A point in the final, current document-session viewport coordinate space.
DocumentA11yProjection
Renderer-neutral semantic snapshot of the current retained document.
DocumentA11yState
Platform-neutral state for one semantic node.
DocumentA11ySupport
Coverage and explicit limitations of an accessibility projection.

Enums§

A11yCapability
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.
DocumentA11yAction
An action the engine advertises for a semantic node.
DocumentA11yActionData
Data carried by an accessibility action request.
DocumentA11yHasPopup
The kind of popup a semantic node can present.
DocumentA11yLive
Announcement priority for live regions.
DocumentA11yOrientation
The primary direction of an oriented control or container.
DocumentA11yRole
Semantic role vocabulary shared by retained document engines.
DocumentA11ySupportError
Why a projection cannot claim complete semantic coverage.
DocumentA11yToggled
The three-value state used by switch and toggle controls.