a11y-kit 0.1.0

Accessibility semantics layer for the estate — platform-free semantic node model (role, name, states, relations), tree audit as a CI gate, AccessKit conversion behind a feature. The layer nobody funds, owned
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! Typed audit failures. Every variant names the node — a gate that says
//! "something is wrong with the a11y tree" is a gate nobody can fix.

use crate::node::NodeId;

/// Why an accessibility tree failed its audit.
#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
pub enum AuditError {
    /// Two nodes share an id.
    #[error("duplicate node id {0}")]
    DuplicateId(NodeId),
    /// A parent or relation points at a node that does not exist.
    #[error("node {node} references missing node {target}")]
    DanglingReference {
        /// The referencing node.
        node: NodeId,
        /// The missing node.
        target: NodeId,
    },
    /// The parent chain loops.
    #[error("node {node} is part of a parent cycle")]
    Cycle {
        /// A node on the cycle.
        node: NodeId,
    },
    /// An interactive role has no accessible name.
    #[error("interactive node {0} has no accessible name")]
    MissingAccessibleName(NodeId),
    /// More than one node claims focus.
    #[error("multiple nodes claim focus: {0:?}")]
    MultipleFocus(Vec<NodeId>),
    /// The focused node is not reachable from any root (an orphan subtree).
    #[error("focused node {0} is unreachable from any root")]
    UnreachableFocus(NodeId),
}