@flighthq/accessibility 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -1,6 +1,6 @@
 # @flighthq/accessibility
 
-Assistive-technology (ARIA) bridge over a swappable web/native backend (a visually-hidden ARIA DOM overlay by default)
+Host-explicit assistive-technology bridge for mirrored semantic nodes, focus, and announcements
 
 ## Install
 
@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/accessibility`. The
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/accessibility@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/accessibility)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/accessibility@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/accessibility)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/accessibility.d.ts

@@ -1,15 +1,8 @@
-import type { AccessibilityBackend, AccessibilityLiveness, AccessibilityNode } from '@flighthq/types/contract';
-import type { BackendExplanation } from '@flighthq/types/contract';
-export declare function announceAccessibility(message: string, liveness?: AccessibilityLiveness): void;
-export declare function clearAccessibilityTree(): void;
-export declare function createWebAccessibilityBackend(container?: HTMLElement): AccessibilityBackend;
-export declare function explainAccessibilityBackend(): BackendExplanation;
-export declare function getAccessibilityBackend(): AccessibilityBackend;
-export declare function installAccessibilityHostBackend(backend: AccessibilityBackend): void;
-export declare function observeAccessibilityHostResult(operation: string, succeeded: boolean): void;
-export declare function removeAccessibilityNode(id: string): void;
-export declare function resetAccessibilityBackendForTest(): void;
-export declare function setAccessibilityBackend(backend: AccessibilityBackend | null): void;
-export declare function setAccessibilityFocus(id: string): boolean;
-export declare function setAccessibilityNode(node: Readonly<AccessibilityNode>): void;
+import type { AccessibilityLiveness, AccessibilityNode, AccessibilityOperationOutcome, HasAccessibilityProvider } from '@flighthq/types/contract';
+export declare function announceAccessibility(host: HasAccessibilityProvider, message: string, liveness?: AccessibilityLiveness): AccessibilityOperationOutcome<'destroyed' | 'no-dom'>;
+export declare function clearAccessibilityTree(host: HasAccessibilityProvider): AccessibilityOperationOutcome<'destroyed' | 'no-dom'>;
+export declare function destroyAccessibility(host: HasAccessibilityProvider): void;
+export declare function removeAccessibilityNode(host: HasAccessibilityProvider, id: string): AccessibilityOperationOutcome<'destroyed' | 'no-dom' | 'node-not-found'>;
+export declare function setAccessibilityFocus(host: HasAccessibilityProvider, id: string): AccessibilityOperationOutcome<'destroyed' | 'focus-not-moved' | 'no-dom' | 'node-not-found'>;
+export declare function setAccessibilityNode(host: HasAccessibilityProvider, node: Readonly<AccessibilityNode>): AccessibilityOperationOutcome<'destroyed' | 'no-dom'>;
 //# sourceMappingURL=accessibility.d.ts.map

package/dist/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../src/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAKnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,qBAAgC,GAAG,IAAI,CAEvG;AAID,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAQD,wBAAgB,6BAA6B,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAgE3F;AAED,wBAAgB,2BAA2B,IAAI,kBAAkB,CAahE;AAGD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAMnF;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAK1F;AAGD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAKvD;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAElF;AAID,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEzD;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE5E"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../src/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EACjB,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,qBAAgC,GACzC,6BAA6B,CAAC,WAAW,GAAG,QAAQ,CAAC,CAEvD;AAGD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,wBAAwB,GAC7B,6BAA6B,CAAC,WAAW,GAAG,QAAQ,CAAC,CAEvD;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAEzE;AAGD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,wBAAwB,EAC9B,EAAE,EAAE,MAAM,GACT,6BAA6B,CAAC,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC,CAE1E;AAGD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,wBAAwB,EAC9B,EAAE,EAAE,MAAM,GACT,6BAA6B,CAAC,WAAW,GAAG,iBAAiB,GAAG,QAAQ,GAAG,gBAAgB,CAAC,CAE9F;AAGD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,wBAAwB,EAC9B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAChC,6BAA6B,CAAC,WAAW,GAAG,QAAQ,CAAC,CAEvD"}

package/dist/accessibility.js

@@ -1,277 +1,26 @@
-// Speaks a transient message through the platform's live region. `liveness` picks urgency: 'polite'
-// waits for current speech, 'assertive' interrupts. Defaults to 'polite'. No-op when no backend can
-// speak.
-export function announceAccessibility(message, liveness = 'polite') {
-    getAccessibilityBackend().announce(message, liveness);
+// Speaks a transient message through the explicitly selected Host provider.
+export function announceAccessibility(host, message, liveness = 'polite') {
+    return host.accessibility.provider.announce(message, liveness);
 }
-// Empties the mirrored accessibility tree, removing every published node. Announcement live regions
-// are recreated lazily on the next announce.
-export function clearAccessibilityTree() {
-    getAccessibilityBackend().clear();
+// Empties the selected Host provider's mirrored tree while leaving the provider reusable.
+export function clearAccessibilityTree(host) {
+    return host.accessibility.provider.clear();
 }
-// Builds the default web backend: a visually-hidden ARIA DOM overlay. Created lazily by
-// getAccessibilityBackend — nothing touches the DOM at import time, so importing the package has no
-// side effect. Each published node becomes an element carrying `role` + `aria-*` attributes, nested
-// under its `parentId`'s element (or the container root). By default a hidden container is appended
-// to document.body on first use; pass `container` to host the overlay elsewhere. With no DOM present
-// every method is a sentinel no-op (setFocus returns false) rather than throwing.
-export function createWebAccessibilityBackend(container) {
-    const elements = new Map();
-    const liveRegions = new Map();
-    let root = container ?? null;
-    let rootResolved = container !== undefined;
-    // Resolves the overlay root, lazily creating and appending a hidden container on first use. Returns
-    // null when no DOM is available, which flips every method into a no-op.
-    function getRoot() {
-        if (rootResolved)
-            return root;
-        rootResolved = true;
-        if (typeof document === 'undefined' || document.body === null) {
-            root = null;
-            return null;
-        }
-        root = _createHiddenAccessibilityContainer(document);
-        document.body.appendChild(root);
-        return root;
-    }
-    return {
-        setNode(node) {
-            const overlayRoot = getRoot();
-            if (overlayRoot === null)
-                return;
-            let element = elements.get(node.id);
-            if (element === undefined) {
-                element = overlayRoot.ownerDocument.createElement('div');
-                element.setAttribute('data-flight-accessibility-id', node.id);
-                elements.set(node.id, element);
-            }
-            _applyAccessibilityElementAttributes(element, node);
-            _reparentAccessibilityElement(element, node.parentId, elements, overlayRoot);
-        },
-        removeNode(id) {
-            const element = elements.get(id);
-            if (element === undefined)
-                return;
-            // Drop the node and its entire descendant subtree (Node.contains is true for the element
-            // itself and every DOM descendant, matching the nested overlay layout).
-            for (const [key, other] of elements) {
-                if (element.contains(other))
-                    elements.delete(key);
-            }
-            if (element.parentNode !== null)
-                element.parentNode.removeChild(element);
-        },
-        clear() {
-            const overlayRoot = getRoot();
-            elements.clear();
-            liveRegions.clear();
-            if (overlayRoot !== null)
-                overlayRoot.replaceChildren();
-        },
-        setFocus(id) {
-            const overlayRoot = getRoot();
-            if (overlayRoot === null)
-                return false;
-            const element = elements.get(id);
-            if (element === undefined)
-                return false;
-            element.focus();
-            return overlayRoot.ownerDocument.activeElement === element;
-        },
-        announce(message, liveness) {
-            const overlayRoot = getRoot();
-            if (overlayRoot === null)
-                return;
-            const region = _getAccessibilityLiveRegion(overlayRoot, liveRegions, liveness);
-            region.textContent = message;
-        },
-    };
+// Terminates the selected Host provider and frees the non-GC resources it owns. Provider destruction
+// is idempotent; callers that share one provider across Hosts retain responsibility for its final release.
+export function destroyAccessibility(host) {
+    host.accessibility.provider.destroy();
 }
-export function explainAccessibilityBackend() {
-    if (_custom !== null) {
-        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
-    }
-    if (_host !== null) {
-        return {
-            conflict: _hostConflict,
-            layer: 'host',
-            operation: _hostObservation !== null ? _hostObservation.operation : null,
-            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
-        };
-    }
-    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
+// Removes a node and its entire descendant subtree from the selected Host provider.
+export function removeAccessibilityNode(host, id) {
+    return host.accessibility.provider.removeNode(id);
 }
-// The active accessibility backend. Precedence: custom > host > sentinel.
-export function getAccessibilityBackend() {
-    return _custom ?? _host ?? _sentinel;
+// Moves platform focus to a node published by the selected Host provider.
+export function setAccessibilityFocus(host, id) {
+    return host.accessibility.provider.setFocus(id);
 }
-export function installAccessibilityHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
+// Registers or updates a node in the selected Host provider's mirrored tree.
+export function setAccessibilityNode(host, node) {
+    return host.accessibility.provider.setNode(node);
 }
-export function observeAccessibilityHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
-}
-// Removes a node and its entire descendant subtree from the mirrored tree.
-export function removeAccessibilityNode(id) {
-    getAccessibilityBackend().removeNode(id);
-}
-export function resetAccessibilityBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
-}
-// Installs a custom accessibility backend; pass null to revert to precedence fallback.
-export function setAccessibilityBackend(backend) {
-    _custom = backend;
-}
-// Moves platform focus to the published node. Returns false when the node is missing or the platform
-// could not focus it — a sentinel, never a throw.
-export function setAccessibilityFocus(id) {
-    return getAccessibilityBackend().setFocus(id);
-}
-// Registers or updates a node in the mirrored tree, keyed by `node.id` and parented by
-// `node.parentId`. Re-issuing with the same id updates the existing node in place.
-export function setAccessibilityNode(node) {
-    getAccessibilityBackend().setNode(node);
-}
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
-const _sentinel = {
-    setNode() { },
-    removeNode() { },
-    clear() { },
-    setFocus() {
-        return false;
-    },
-    announce() { },
-};
-const _TEXT_NODE = 3;
-// Reflects a node's semantics onto its overlay element: role, the label/description/value text and
-// their ARIA attributes, focusability, and the mapped state attributes. Attributes are cleared when
-// their source field is absent, so an update that drops a field clears the stale attribute.
-function _applyAccessibilityElementAttributes(element, node) {
-    element.setAttribute('role', node.role);
-    _reflectAccessibilityAttribute(element, 'aria-label', node.label);
-    _reflectAccessibilityAttribute(element, 'aria-description', node.description);
-    _reflectAccessibilityAttribute(element, 'title', node.description);
-    _reflectAccessibilityAttribute(element, 'aria-valuetext', node.value);
-    _setAccessibilityElementValueText(element, node.value);
-    // Every node element is focusable so setFocus can move platform focus to it, including
-    // non-interactive roles (heading/region) a caller may want to move a screen reader to.
-    element.setAttribute('tabindex', '-1');
-    _applyAccessibilityStateAttributes(element, node.states ?? _EMPTY_STATE);
-}
-// Maps each AccessibilityState field to its ARIA attribute. Absent fields clear the attribute so a
-// state that was set then dropped does not linger.
-function _applyAccessibilityStateAttributes(element, state) {
-    _reflectAccessibilityBoolean(element, 'aria-disabled', state.disabled);
-    _reflectAccessibilityBoolean(element, 'aria-checked', state.checked);
-    _reflectAccessibilityBoolean(element, 'aria-expanded', state.expanded);
-    _reflectAccessibilityBoolean(element, 'aria-selected', state.selected);
-    _reflectAccessibilityBoolean(element, 'aria-pressed', state.pressed);
-    _reflectAccessibilityBoolean(element, 'aria-busy', state.busy);
-    _reflectAccessibilityBoolean(element, 'aria-hidden', state.hidden);
-    _reflectAccessibilityBoolean(element, 'aria-readonly', state.readonly);
-    _reflectAccessibilityBoolean(element, 'aria-required', state.required);
-    _reflectAccessibilityNumber(element, 'aria-level', state.level);
-    _reflectAccessibilityNumber(element, 'aria-valuemin', state.valueMin);
-    _reflectAccessibilityNumber(element, 'aria-valuemax', state.valueMax);
-    _reflectAccessibilityNumber(element, 'aria-valuenow', state.valueNow);
-}
-// Builds the visually-hidden overlay container. Uses the standard clip-rect "sr-only" inline styles
-// so the elements stay in the accessibility tree while drawing nothing on screen.
-function _createHiddenAccessibilityContainer(doc) {
-    const container = doc.createElement('div');
-    container.setAttribute('data-flight-accessibility', 'true');
-    const style = container.style;
-    style.position = 'absolute';
-    style.width = '1px';
-    style.height = '1px';
-    style.margin = '-1px';
-    style.padding = '0';
-    style.border = '0';
-    style.overflow = 'hidden';
-    style.clip = 'rect(0 0 0 0)';
-    style.clipPath = 'inset(50%)';
-    style.whiteSpace = 'nowrap';
-    return container;
-}
-// Resolves the persistent aria-live region for the given urgency, creating and appending it under
-// the container on first use (or when a prior clear removed it).
-function _getAccessibilityLiveRegion(root, liveRegions, liveness) {
-    let region = liveRegions.get(liveness);
-    if (region === undefined || region.parentNode === null) {
-        region = root.ownerDocument.createElement('div');
-        region.setAttribute('aria-live', liveness);
-        region.setAttribute('aria-atomic', 'true');
-        region.setAttribute('data-flight-accessibility-live', liveness);
-        liveRegions.set(liveness, region);
-        root.appendChild(region);
-    }
-    return region;
-}
-// Sets a string attribute, or removes it when the value is absent.
-function _reflectAccessibilityAttribute(element, attribute, value) {
-    if (value === undefined) {
-        element.removeAttribute(attribute);
-        return;
-    }
-    element.setAttribute(attribute, value);
-}
-// Sets a boolean attribute as 'true'/'false', or removes it when the value is absent.
-function _reflectAccessibilityBoolean(element, attribute, value) {
-    if (value === undefined) {
-        element.removeAttribute(attribute);
-        return;
-    }
-    element.setAttribute(attribute, value ? 'true' : 'false');
-}
-// Sets a numeric attribute as its decimal string, or removes it when the value is absent.
-function _reflectAccessibilityNumber(element, attribute, value) {
-    if (value === undefined) {
-        element.removeAttribute(attribute);
-        return;
-    }
-    element.setAttribute(attribute, String(value));
-}
-// Moves the element under the element of `parentId` (or the container root when the parent is unknown
-// or unset). Only touches the DOM when the parent actually changes, so re-issuing an unchanged node
-// causes no reparenting churn.
-function _reparentAccessibilityElement(element, parentId, elements, root) {
-    let parent = root;
-    if (parentId !== undefined) {
-        const found = elements.get(parentId);
-        if (found !== undefined)
-            parent = found;
-    }
-    if (element.parentNode !== parent)
-        parent.appendChild(element);
-}
-// Maintains the node's value as a leading text node so nested child elements survive value updates
-// (setting element.textContent would wipe the appended child nodes).
-function _setAccessibilityElementValueText(element, value) {
-    const first = element.firstChild;
-    if (value === undefined) {
-        if (first !== null && first.nodeType === _TEXT_NODE)
-            element.removeChild(first);
-        return;
-    }
-    if (first !== null && first.nodeType === _TEXT_NODE) {
-        first.nodeValue = value;
-        return;
-    }
-    element.insertBefore(element.ownerDocument.createTextNode(value), first);
-}
-const _EMPTY_STATE = {};
 //# sourceMappingURL=accessibility.js.map

package/dist/accessibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../src/accessibility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../src/accessibility.ts"],"names":[],"mappings":"AAOA,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CACnC,IAA8B,EAC9B,OAAe,EACf,WAAkC,QAAQ;IAE1C,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CACpC,IAA8B;IAE9B,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED,qGAAqG;AACrG,2GAA2G;AAC3G,MAAM,UAAU,oBAAoB,CAAC,IAA8B;IACjE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CACrC,IAA8B,EAC9B,EAAU;IAEV,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CACnC,IAA8B,EAC9B,EAAU;IAEV,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAClC,IAA8B,EAC9B,IAAiC;IAEjC,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { explainAccessibilityBackend, announceAccessibility, clearAccessibilityTree, removeAccessibilityNode, setAccessibilityFocus, setAccessibilityNode, } from './contract';
+export { announceAccessibility, clearAccessibilityTree, destroyAccessibility, removeAccessibilityNode, setAccessibilityFocus, setAccessibilityNode, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { explainAccessibilityBackend, announceAccessibility, clearAccessibilityTree, removeAccessibilityNode, setAccessibilityFocus, setAccessibilityNode, } from './contract';
+export { announceAccessibility, clearAccessibilityTree, destroyAccessibility, removeAccessibilityNode, setAccessibilityFocus, setAccessibilityNode, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/accessibility",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,11 +38,11 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
-  "description": "Assistive-technology (ARIA) bridge over a swappable web/native backend (a visually-hidden ARIA DOM overlay by default)",
+  "description": "Host-explicit assistive-technology bridge for mirrored semantic nodes, focus, and announcements",
   "sideEffects": false
 }

package/src/accessibility.test.ts

@@ -1,368 +1,90 @@
-import type { AccessibilityBackend, AccessibilityLiveness, AccessibilityNode } from '@flighthq/types/contract';
-import { afterEach, describe, expect, it, vi } from 'vitest';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+import type { AccessibilityBackend, AccessibilityNode, EntityWithoutRuntime } from '@flighthq/types/contract';
+import { vi } from 'vitest';
 
 import {
   announceAccessibility,
   clearAccessibilityTree,
-  createWebAccessibilityBackend,
-  getAccessibilityBackend,
+  destroyAccessibility,
   removeAccessibilityNode,
-  setAccessibilityBackend,
   setAccessibilityFocus,
   setAccessibilityNode,
-  explainAccessibilityBackend,
-  installAccessibilityHostBackend,
-  observeAccessibilityHostResult,
-  resetAccessibilityBackendForTest,
 } from './accessibility';
 
-afterEach(() => {
-  setAccessibilityBackend(null);
-  vi.unstubAllGlobals();
-  document.body.replaceChildren();
-});
-
 describe('announceAccessibility', () => {
-  it('dispatches the message and liveness to the backend', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    announceAccessibility('saved', 'assertive');
-    expect(mock.calls.announce).toEqual([['saved', 'assertive']]);
-  });
+  it('returns the selected Host provider outcome and supplies the default liveness', () => {
+    const provider = createProvider();
+    const host = { accessibility: { provider } };
 
-  it('defaults liveness to polite', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    announceAccessibility('loading');
-    expect(mock.calls.announce).toEqual([['loading', 'polite']]);
+    expect(announceAccessibility(host, 'saved')).toEqual({ reason: 'ok' });
+    expect(provider.announce).toHaveBeenCalledWith('saved', 'polite');
   });
 });
 
 describe('clearAccessibilityTree', () => {
-  it('dispatches a clear to the backend', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    clearAccessibilityTree();
-    expect(mock.calls.clear).toBe(1);
-  });
-});
-
-describe('createWebAccessibilityBackend', () => {
-  it('creates an element carrying role, aria-label, and mapped state attributes', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('play', 'button', { label: 'Play', states: { disabled: true, pressed: false } }));
-    const element = container.querySelector('[data-flight-accessibility-id="play"]');
-    expect(element).not.toBeNull();
-    expect(element?.getAttribute('role')).toBe('button');
-    expect(element?.getAttribute('aria-label')).toBe('Play');
-    expect(element?.getAttribute('aria-disabled')).toBe('true');
-    expect(element?.getAttribute('aria-pressed')).toBe('false');
-  });
-
-  it('maps description to aria-description and title, and value to text and aria-valuetext', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('vol', 'slider', { description: 'Volume level', value: '70%' }));
-    const element = container.querySelector('[data-flight-accessibility-id="vol"]');
-    expect(element?.getAttribute('aria-description')).toBe('Volume level');
-    expect(element?.getAttribute('title')).toBe('Volume level');
-    expect(element?.getAttribute('aria-valuetext')).toBe('70%');
-    expect(element?.textContent).toBe('70%');
-  });
-
-  it('maps range and level numerics to their aria attributes', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('bar', 'progressbar', { states: { valueMin: 0, valueMax: 100, valueNow: 42, level: 2 } }));
-    const element = container.querySelector('[data-flight-accessibility-id="bar"]');
-    expect(element?.getAttribute('aria-valuemin')).toBe('0');
-    expect(element?.getAttribute('aria-valuemax')).toBe('100');
-    expect(element?.getAttribute('aria-valuenow')).toBe('42');
-    expect(element?.getAttribute('aria-level')).toBe('2');
-  });
-
-  it('updates an existing node in place without duplicating the element', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('cb', 'checkbox', { label: 'Mute', states: { checked: false } }));
-    backend.setNode(node('cb', 'checkbox', { label: 'Muted', states: { checked: true } }));
-    const matches = container.querySelectorAll('[data-flight-accessibility-id="cb"]');
-    expect(matches.length).toBe(1);
-    expect(matches[0].getAttribute('aria-label')).toBe('Muted');
-    expect(matches[0].getAttribute('aria-checked')).toBe('true');
-  });
-
-  it('clears an attribute when an updated node drops the field', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('cb', 'checkbox', { label: 'Mute', states: { checked: true } }));
-    backend.setNode(node('cb', 'checkbox', {}));
-    const element = container.querySelector('[data-flight-accessibility-id="cb"]');
-    expect(element?.hasAttribute('aria-label')).toBe(false);
-    expect(element?.hasAttribute('aria-checked')).toBe(false);
-    expect(element?.textContent).toBe('');
-  });
-
-  it('nests a child element under its parentId element', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('menu', 'menu', { label: 'File' }));
-    backend.setNode(node('item', 'menuitem', { label: 'Open', parentId: 'menu' }));
-    const parent = container.querySelector('[data-flight-accessibility-id="menu"]');
-    const child = container.querySelector('[data-flight-accessibility-id="item"]');
-    expect(child?.parentElement).toBe(parent);
-  });
+  it('returns the selected Host provider outcome', () => {
+    const provider = createProvider({ clear: vi.fn(() => ({ reason: 'no-dom' as const })) });
 
-  it('re-parents an element when parentId changes', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('a', 'group', {}));
-    backend.setNode(node('b', 'group', {}));
-    backend.setNode(node('leaf', 'button', { parentId: 'a' }));
-    const child = () => container.querySelector('[data-flight-accessibility-id="leaf"]');
-    expect(child()?.parentElement?.getAttribute('data-flight-accessibility-id')).toBe('a');
-    backend.setNode(node('leaf', 'button', { parentId: 'b' }));
-    expect(child()?.parentElement?.getAttribute('data-flight-accessibility-id')).toBe('b');
-  });
-
-  it('removes a node and its descendant subtree', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('menu', 'menu', {}));
-    backend.setNode(node('item', 'menuitem', { parentId: 'menu' }));
-    backend.removeNode('menu');
-    expect(container.querySelector('[data-flight-accessibility-id="menu"]')).toBeNull();
-    expect(container.querySelector('[data-flight-accessibility-id="item"]')).toBeNull();
-    // The descendant id is dropped from tracking too, so re-adding it lands at the root.
-    backend.setNode(node('item', 'menuitem', { parentId: 'menu' }));
-    expect(container.querySelector('[data-flight-accessibility-id="item"]')?.parentElement).toBe(container);
-  });
-
-  it('focuses a node element and reports missing ids as false', () => {
-    const container = document.createElement('div');
-    document.body.appendChild(container);
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('field', 'textbox', { label: 'Name' }));
-    expect(backend.setFocus('field')).toBe(true);
-    const element = container.querySelector('[data-flight-accessibility-id="field"]');
-    expect(document.activeElement).toBe(element);
-    expect(backend.setFocus('missing')).toBe(false);
-  });
-
-  it('writes announcements into the polite and assertive live regions', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.announce('level complete', 'polite');
-    backend.announce('warning', 'assertive');
-    const polite = container.querySelector('[data-flight-accessibility-live="polite"]');
-    const assertive = container.querySelector('[data-flight-accessibility-live="assertive"]');
-    expect(polite?.getAttribute('aria-live')).toBe('polite');
-    expect(polite?.textContent).toBe('level complete');
-    expect(assertive?.getAttribute('aria-live')).toBe('assertive');
-    expect(assertive?.textContent).toBe('warning');
-  });
-
-  it('empties the container on clear', () => {
-    const container = document.createElement('div');
-    const backend = createWebAccessibilityBackend(container);
-    backend.setNode(node('a', 'button', {}));
-    backend.announce('hi', 'polite');
-    expect(container.childElementCount).toBeGreaterThan(0);
-    backend.clear();
-    expect(container.childElementCount).toBe(0);
-  });
-
-  it('defaults its container into document.body', () => {
-    const backend = createWebAccessibilityBackend();
-    backend.setNode(node('a', 'button', {}));
-    expect(document.querySelector('[data-flight-accessibility-id="a"]')).not.toBeNull();
-    expect(document.body.querySelector('[data-flight-accessibility]')).not.toBeNull();
-  });
-
-  it('is a sentinel no-op when no DOM is available', () => {
-    vi.stubGlobal('document', undefined);
-    const backend = createWebAccessibilityBackend();
-    expect(() => backend.setNode(node('a', 'button', {}))).not.toThrow();
-    expect(() => backend.removeNode('a')).not.toThrow();
-    expect(() => backend.announce('hi', 'polite')).not.toThrow();
-    expect(() => backend.clear()).not.toThrow();
-    expect(backend.setFocus('a')).toBe(false);
+    expect(clearAccessibilityTree({ accessibility: { provider } })).toEqual({ reason: 'no-dom' });
   });
 });
 
-describe('explainAccessibilityBackend', () => {
-  afterEach(() => resetAccessibilityBackendForTest());
+describe('destroyAccessibility', () => {
+  it('destroys the selected Host provider and no other provider', () => {
+    const first = createProvider();
+    const second = createProvider();
 
-  it('reports host-not-enabled when no backend is installed', () => {
-    resetAccessibilityBackendForTest();
-    const explanation = explainAccessibilityBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-    expect(explanation.viability).toBe('unobserved');
-  });
-
-  it('reports custom layer when a custom backend is set', () => {
-    setAccessibilityBackend(getAccessibilityBackend());
-    expect(explainAccessibilityBackend().layer).toBe('custom');
-  });
+    destroyAccessibility({ accessibility: { provider: first } });
 
-  it('reports host layer when a host backend is installed', () => {
-    installAccessibilityHostBackend(getAccessibilityBackend());
-    expect(explainAccessibilityBackend().layer).toBe('host');
-  });
-
-  it('reports conflict when two different host backends are installed', () => {
-    installAccessibilityHostBackend({ ...getAccessibilityBackend() });
-    installAccessibilityHostBackend({ ...getAccessibilityBackend() });
-    expect(explainAccessibilityBackend().conflict).toBe(true);
+    expect(first.destroy).toHaveBeenCalledOnce();
+    expect(second.destroy).not.toHaveBeenCalled();
   });
 });
 
-describe('getAccessibilityBackend', () => {
-  it('lazily returns a stable web default', () => {
-    const first = getAccessibilityBackend();
-    expect(first).toBe(getAccessibilityBackend());
-  });
+describe('removeAccessibilityNode', () => {
+  it('forwards the node id and returns a node-not-found outcome', () => {
+    const provider = createProvider({ removeNode: vi.fn(() => ({ reason: 'node-not-found' as const })) });
 
-  it('returns the installed backend', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    expect(getAccessibilityBackend()).toBe(mock.backend);
+    expect(removeAccessibilityNode({ accessibility: { provider } }, 'missing')).toEqual({
+      reason: 'node-not-found',
+    });
+    expect(provider.removeNode).toHaveBeenCalledWith('missing');
   });
 });
 
-describe('installAccessibilityHostBackend', () => {
-  afterEach(() => resetAccessibilityBackendForTest());
-
-  it('installs a host backend that getAccessibilityBackend returns', () => {
-    const backend = getAccessibilityBackend();
-    installAccessibilityHostBackend(backend);
-    expect(getAccessibilityBackend()).toBe(backend);
-  });
+describe('setAccessibilityFocus', () => {
+  it('forwards the node id and returns a focus-not-moved outcome', () => {
+    const provider = createProvider({ setFocus: vi.fn(() => ({ reason: 'focus-not-moved' as const })) });
 
-  it('is first-host-wins: a second different backend sets conflict', () => {
-    const first = { ...getAccessibilityBackend() };
-    const second = { ...getAccessibilityBackend() };
-    installAccessibilityHostBackend(first);
-    installAccessibilityHostBackend(second);
-    expect(getAccessibilityBackend()).toBe(first);
-    expect(explainAccessibilityBackend().conflict).toBe(true);
+    expect(setAccessibilityFocus({ accessibility: { provider } }, 'subject')).toEqual({
+      reason: 'focus-not-moved',
+    });
+    expect(provider.setFocus).toHaveBeenCalledWith('subject');
   });
 });
 
-describe('observeAccessibilityHostResult', () => {
-  afterEach(() => resetAccessibilityBackendForTest());
-
-  it('records a successful observation', () => {
-    installAccessibilityHostBackend(getAccessibilityBackend());
-    observeAccessibilityHostResult('setNode', true);
-    const explanation = explainAccessibilityBackend();
-    expect(explanation.operation).toBe('setNode');
-    expect(explanation.viability).toBe('available');
-  });
+describe('setAccessibilityNode', () => {
+  it('publishes only through the explicitly supplied Host', () => {
+    const first = createProvider();
+    const second = createProvider();
+    const subject: AccessibilityNode = { id: 'subject', label: 'Subject', role: 'button' };
 
-  it('records a failed observation', () => {
-    installAccessibilityHostBackend(getAccessibilityBackend());
-    observeAccessibilityHostResult('setNode', false);
-    expect(explainAccessibilityBackend().viability).toBe('runtime-api-unavailable');
-  });
-});
+    expect(setAccessibilityNode({ accessibility: { provider: first } }, subject)).toEqual({ reason: 'ok' });
 
-describe('removeAccessibilityNode', () => {
-  it('dispatches the id to the backend', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    removeAccessibilityNode('gone');
-    expect(mock.calls.removeNode).toEqual(['gone']);
+    expect(first.setNode).toHaveBeenCalledWith(subject);
+    expect(second.setNode).not.toHaveBeenCalled();
   });
 });
 
-function node(
-  id: string,
-  role: AccessibilityNode['role'],
-  rest: Readonly<Omit<AccessibilityNode, 'id' | 'role'>>,
-): AccessibilityNode {
-  return { id, role, ...rest };
-}
-
-interface MockAccessibilityCalls {
-  setNode: AccessibilityNode[];
-  removeNode: string[];
-  clear: number;
-  setFocus: string[];
-  announce: (readonly [string, AccessibilityLiveness])[];
-}
-
-function createMockAccessibilityBackend(): { backend: AccessibilityBackend; calls: MockAccessibilityCalls } {
-  const calls: MockAccessibilityCalls = { setNode: [], removeNode: [], clear: 0, setFocus: [], announce: [] };
-  const backend: AccessibilityBackend = {
-    setNode(target) {
-      calls.setNode.push(target as AccessibilityNode);
-    },
-    removeNode(id) {
-      calls.removeNode.push(id);
-    },
-    clear() {
-      calls.clear += 1;
-    },
-    setFocus(id) {
-      calls.setFocus.push(id);
-      return id === 'ok';
-    },
-    announce(message, liveness) {
-      calls.announce.push([message, liveness]);
-    },
+function createProvider(overrides: Partial<EntityWithoutRuntime<AccessibilityBackend>> = {}): AccessibilityBackend {
+  return {
+    [EntityRuntimeKey]: undefined,
+    announce: vi.fn(() => ({ reason: 'ok' as const })),
+    clear: vi.fn(() => ({ reason: 'ok' as const })),
+    destroy: vi.fn(),
+    removeNode: vi.fn(() => ({ reason: 'ok' as const })),
+    setFocus: vi.fn(() => ({ reason: 'ok' as const })),
+    setNode: vi.fn(() => ({ reason: 'ok' as const })),
+    ...overrides,
   };
-  return { backend, calls };
 }
-
-describe('resetAccessibilityBackendForTest', () => {
-  it('clears all backend slots', () => {
-    setAccessibilityBackend(getAccessibilityBackend());
-    installAccessibilityHostBackend(getAccessibilityBackend());
-    observeAccessibilityHostResult('setNode', true);
-    resetAccessibilityBackendForTest();
-    expect(explainAccessibilityBackend().layer).toBe('host-not-enabled');
-    expect(explainAccessibilityBackend().conflict).toBe(false);
-    expect(explainAccessibilityBackend().viability).toBe('unobserved');
-  });
-});
-
-describe('setAccessibilityBackend', () => {
-  it('installs a backend that later commands dispatch through', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    setAccessibilityNode(node('a', 'button', {}));
-    expect(mock.calls.setNode.length).toBe(1);
-  });
-
-  it('reverts to the sentinel when passed null', () => {
-    const sentinel = getAccessibilityBackend();
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    expect(getAccessibilityBackend()).toBe(mock.backend);
-    setAccessibilityBackend(null);
-    expect(getAccessibilityBackend()).toBe(sentinel);
-  });
-});
-
-describe('setAccessibilityFocus', () => {
-  it('dispatches the id and returns the backend result', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    expect(setAccessibilityFocus('ok')).toBe(true);
-    expect(setAccessibilityFocus('nope')).toBe(false);
-    expect(mock.calls.setFocus).toEqual(['ok', 'nope']);
-  });
-});
-
-describe('setAccessibilityNode', () => {
-  it('dispatches the node to the backend', () => {
-    const mock = createMockAccessibilityBackend();
-    setAccessibilityBackend(mock.backend);
-    const target = node('a', 'button', { label: 'Go' });
-    setAccessibilityNode(target);
-    expect(mock.calls.setNode).toEqual([target]);
-  });
-});