@obinexusltd/obix-driver-accessibility-tree 0.1.0 → 0.1.1

package/dist/framework-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-integration.d.ts","sourceRoot":"","sources":["../src/framework-integration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,0BAA0B,CAAC;IACnC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,uBAAwB,SAAQ,UAAU;IACzD,qBAAqB,IAAI,eAAe,CAAC;IACzC,uBAAuB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9E,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACtE,WAAW,IAAI,iBAAiB,EAAE,CAAC;IACnC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,uBAAuB,IAAI;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,uBAAuB,CAsHzB"}

package/dist/framework-integration.js

@@ -0,0 +1,110 @@
+/**
+ * Feature 10: OBINexus Framework Integration
+ * Accessible navigation pathways, interaction modes, unified facade
+ */
+export function createFrameworkIntegration(config) {
+    const pathways = new Map();
+    const modeHandlers = new Set();
+    let currentMode = "pointer";
+    const listeners = [];
+    function setMode(mode) {
+        if (mode === currentMode)
+            return;
+        currentMode = mode;
+        for (const handler of modeHandlers) {
+            handler(mode);
+        }
+    }
+    function onKeyDown(e) {
+        const event = e;
+        if (event.key === "Tab" || event.key.startsWith("Arrow")) {
+            setMode("keyboard");
+        }
+    }
+    function onPointerDown() {
+        setMode("pointer");
+    }
+    function onTouchStart() {
+        setMode("touch");
+    }
+    function addListener(target, type, handler) {
+        target.addEventListener(type, handler);
+        listeners.push({ target, type, handler });
+    }
+    // Set up interaction mode detection
+    if (typeof config.rootElement.addEventListener === "function") {
+        addListener(config.rootElement, "keydown", onKeyDown);
+        addListener(config.rootElement, "pointerdown", onPointerDown);
+        addListener(config.rootElement, "touchstart", onTouchStart);
+    }
+    return {
+        detectInteractionMode() {
+            return currentMode;
+        },
+        onInteractionModeChange(handler) {
+            modeHandlers.add(handler);
+            return () => { modeHandlers.delete(handler); };
+        },
+        registerPathway(pathway) {
+            pathways.set(pathway.id, pathway);
+        },
+        removePathway(id) {
+            pathways.delete(id);
+        },
+        navigateToLandmark(pathwayId, landmarkLabel) {
+            const pathway = pathways.get(pathwayId);
+            if (!pathway)
+                return false;
+            const landmark = pathway.landmarks.find((l) => l.label === landmarkLabel);
+            if (!landmark)
+                return false;
+            // Use focus manager if available, otherwise direct focus
+            if (config.focusManager) {
+                config.focusManager.moveFocus(landmark.element);
+            }
+            else if (typeof landmark.element.focus === "function") {
+                landmark.element.focus();
+            }
+            // Announce navigation if screen reader bridge is available
+            if (config.screenReaderBridge) {
+                config.screenReaderBridge.announcePolite(`Navigated to ${landmarkLabel}`);
+            }
+            else if (config.liveRegionManager) {
+                config.liveRegionManager.announceGlobal(`Navigated to ${landmarkLabel}`);
+            }
+            return true;
+        },
+        getPathways() {
+            return Array.from(pathways.values());
+        },
+        announceNavigation(description) {
+            if (config.screenReaderBridge) {
+                config.screenReaderBridge.announcePolite(description);
+            }
+            else if (config.liveRegionManager) {
+                config.liveRegionManager.announceGlobal(description);
+            }
+        },
+        getAccessibilitySummary() {
+            let landmarkCount = 0;
+            for (const pathway of pathways.values()) {
+                landmarkCount += pathway.landmarks.length;
+            }
+            return {
+                landmarks: landmarkCount,
+                liveRegions: config.liveRegionManager?.getActiveRegions().length ?? 0,
+                interactionMode: currentMode,
+                pathways: pathways.size,
+            };
+        },
+        destroy() {
+            for (const { target, type, handler } of listeners) {
+                target.removeEventListener(type, handler);
+            }
+            listeners.length = 0;
+            pathways.clear();
+            modeHandlers.clear();
+        },
+    };
+}
+//# sourceMappingURL=framework-integration.js.map

package/dist/framework-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-integration.js","sourceRoot":"","sources":["../src/framework-integration.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,37 +2,17 @@
  * Accessibility Tree Driver
  * ARIA/live region management and screen reader bridge
  */
-export type AriaLiveRegion = "off" | "polite" | "assertive";
-export type AriaRole = string;
-export interface LiveRegionDefaults {
-    level?: AriaLiveRegion;
-    atomic?: boolean;
-    relevant?: string[];
-    label?: string;
-}
-export interface AccessibilityTreeDriverConfig {
-    /** Root element for accessibility tree */
-    rootElement: Element;
-    /** Default configuration for live regions */
-    liveRegionDefaults?: LiveRegionDefaults;
-    /** Screen reader hints and optimizations */
-    screenReaderHints?: boolean;
-}
-export interface AccessibilityNode {
-    role: AriaRole;
-    label?: string;
-    description?: string;
-    attributes?: Record<string, string>;
-    children?: AccessibilityNode[];
-}
-export interface AccessibilityTreeDriverAPI {
-    initialize(): Promise<void>;
-    registerLiveRegion(element: Element, config?: LiveRegionDefaults): Promise<void>;
-    announce(message: string, level?: AriaLiveRegion): void;
-    updateAccessibilityNode(element: Element, node: AccessibilityNode): void;
-    getAccessibilityTree(): AccessibilityNode;
-    setScreenReaderMode(enabled: boolean): void;
-    destroy(): Promise<void>;
-}
+export * from "./types.js";
+export * from "./live-region-manager.js";
+export * from "./state-properties-manager.js";
+export * from "./focus-management.js";
+export * from "./screen-reader-bridge.js";
+export * from "./keyboard-navigation.js";
+export * from "./accessibility-tree-mirror.js";
+export * from "./semantic-html-enhancer.js";
+export * from "./aria-widget-compliance.js";
+export * from "./axe-core-integration.js";
+export * from "./framework-integration.js";
+import type { AccessibilityTreeDriverConfig, AccessibilityTreeDriverAPI } from "./types.js";
 export declare function createAccessibilityTreeDriver(config: AccessibilityTreeDriverConfig): AccessibilityTreeDriverAPI;
 //# 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;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,0CAA0C;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxD,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzE,oBAAoB,IAAI,iBAAiB,CAAC;IAC1C,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,0BAA0B,CAoD5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,KAAK,EAIV,6BAA6B,EAC7B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAYpB,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,0BAA0B,CA0L5B"}

package/dist/index.js

@@ -2,29 +2,133 @@
  * Accessibility Tree Driver
  * ARIA/live region management and screen reader bridge
  */
+// Re-export all types
+export * from "./types.js";
+// Re-export all feature factories and their types
+export * from "./live-region-manager.js";
+export * from "./state-properties-manager.js";
+export * from "./focus-management.js";
+export * from "./screen-reader-bridge.js";
+export * from "./keyboard-navigation.js";
+export * from "./accessibility-tree-mirror.js";
+export * from "./semantic-html-enhancer.js";
+export * from "./aria-widget-compliance.js";
+export * from "./axe-core-integration.js";
+export * from "./framework-integration.js";
+import { createLiveRegionManager } from "./live-region-manager.js";
+import { createAriaStateManager } from "./state-properties-manager.js";
+import { createFocusManager } from "./focus-management.js";
+import { createScreenReaderBridge } from "./screen-reader-bridge.js";
+import { createKeyboardNavigationController } from "./keyboard-navigation.js";
+import { createAccessibilityTreeMirror } from "./accessibility-tree-mirror.js";
+import { createSemanticEnhancer } from "./semantic-html-enhancer.js";
+import { createWidgetComplianceEngine } from "./aria-widget-compliance.js";
+import { createAxeIntegration } from "./axe-core-integration.js";
+import { createFrameworkIntegration } from "./framework-integration.js";
 export function createAccessibilityTreeDriver(config) {
     let initialized = false;
-    let screenReaderMode = Boolean(config.screenReaderHints);
+    // Sub-features (created lazily during initialize)
+    let liveRegions;
+    let stateManager;
+    let focusManager;
+    let screenReaderBridge;
+    let keyboardNav;
+    let treeMirror;
+    let semanticEnhancer;
+    let widgetCompliance;
+    let axeIntegration;
+    let framework;
+    // Legacy compatibility: node map for updateAccessibilityNode
     const nodeMap = new Map();
-    const liveRegions = new Map();
-    let lastAnnouncement = "";
-    return {
+    const driver = {
         async initialize() {
+            if (initialized)
+                return;
             initialized = true;
+            // Create all sub-features
+            stateManager = createAriaStateManager();
+            focusManager = createFocusManager();
+            liveRegions = createLiveRegionManager({
+                container: config.rootElement,
+                defaultLevel: config.liveRegionDefaults?.level ?? "polite",
+            });
+            screenReaderBridge = createScreenReaderBridge({
+                liveRegionManager: liveRegions,
+                enableDetection: config.screenReaderHints,
+            });
+            keyboardNav = createKeyboardNavigationController();
+            treeMirror = createAccessibilityTreeMirror({
+                rootElement: config.rootElement,
+                observe: false,
+            });
+            semanticEnhancer = createSemanticEnhancer({
+                rootElement: config.rootElement,
+                stateManager,
+            });
+            widgetCompliance = createWidgetComplianceEngine({
+                stateManager,
+                focusManager,
+                keyboardNav,
+            });
+            axeIntegration = createAxeIntegration({
+                rootElement: config.rootElement,
+            });
+            framework = createFrameworkIntegration({
+                rootElement: config.rootElement,
+                driver,
+                liveRegionManager: liveRegions,
+                focusManager,
+                screenReaderBridge,
+                stateManager,
+            });
+            // Start tree observation
+            treeMirror.observe();
+            // Set screen reader mode if configured
+            if (config.screenReaderHints) {
+                screenReaderBridge.setOptimizationMode(true);
+            }
         },
         async registerLiveRegion(element, overrides) {
-            liveRegions.set(element, { ...config.liveRegionDefaults, ...overrides });
+            if (liveRegions) {
+                const id = element.id || `region-${Date.now()}`;
+                liveRegions.createRegion(id, { ...config.liveRegionDefaults, ...overrides });
+            }
         },
         announce(message, level = "polite") {
-            lastAnnouncement = message;
-            if (typeof config.rootElement.setAttribute === "function") {
+            if (screenReaderBridge) {
+                if (level === "assertive") {
+                    screenReaderBridge.announceAssertive(message);
+                }
+                else {
+                    screenReaderBridge.announcePolite(message);
+                }
+            }
+            else if (liveRegions) {
+                liveRegions.announceGlobal(message, level);
+            }
+            else if (typeof config.rootElement.setAttribute === "function") {
+                // Fallback for uninitialized state
                 config.rootElement.setAttribute("aria-live", level);
                 config.rootElement.setAttribute("aria-label", message);
             }
         },
         updateAccessibilityNode(element, node) {
             nodeMap.set(element, node);
-            if (typeof element.setAttribute === "function") {
+            if (stateManager) {
+                stateManager.setState(element, "role", node.role);
+                if (node.label) {
+                    stateManager.setState(element, "aria-label", node.label);
+                }
+                if (node.description) {
+                    stateManager.setState(element, "aria-describedby", node.description);
+                }
+                if (node.attributes) {
+                    for (const [key, value] of Object.entries(node.attributes)) {
+                        stateManager.setState(element, key, value);
+                    }
+                }
+            }
+            else if (typeof element.setAttribute === "function") {
                 element.setAttribute("role", node.role);
                 if (node.label) {
                     element.setAttribute("aria-label", node.label);
@@ -32,26 +136,61 @@ export function createAccessibilityTreeDriver(config) {
             }
         },
         getAccessibilityTree() {
+            if (treeMirror) {
+                return treeMirror.snapshot();
+            }
+            // Fallback for uninitialized state
             const children = Array.from(nodeMap.values());
             return {
                 role: "root",
-                label: lastAnnouncement || "accessibility-tree",
+                label: "accessibility-tree",
                 children,
             };
         },
         setScreenReaderMode(enabled) {
-            screenReaderMode = enabled;
+            if (screenReaderBridge) {
+                screenReaderBridge.setOptimizationMode(enabled);
+            }
             if (typeof config.rootElement.setAttribute === "function") {
-                config.rootElement.setAttribute("data-screen-reader-mode", String(screenReaderMode));
+                config.rootElement.setAttribute("data-screen-reader-mode", String(enabled));
             }
         },
         async destroy() {
-            initialized = false;
+            framework?.destroy();
+            axeIntegration?.destroy();
+            widgetCompliance?.destroy();
+            semanticEnhancer?.destroy();
+            treeMirror?.destroy();
+            keyboardNav?.destroy();
+            screenReaderBridge?.destroy();
+            focusManager?.destroy();
+            liveRegions?.destroy();
+            stateManager?.destroy();
+            framework = undefined;
+            axeIntegration = undefined;
+            widgetCompliance = undefined;
+            semanticEnhancer = undefined;
+            treeMirror = undefined;
+            keyboardNav = undefined;
+            screenReaderBridge = undefined;
+            focusManager = undefined;
+            liveRegions = undefined;
+            stateManager = undefined;
             nodeMap.clear();
-            liveRegions.clear();
-            lastAnnouncement = "";
-            void initialized;
+            initialized = false;
         },
+        // Sub-feature accessors
+        get liveRegions() { return liveRegions; },
+        get stateManager() { return stateManager; },
+        get focusManager() { return focusManager; },
+        get screenReaderBridge() { return screenReaderBridge; },
+        get keyboardNav() { return keyboardNav; },
+        get treeMirror() { return treeMirror; },
+        get semanticEnhancer() { return semanticEnhancer; },
+        get widgetCompliance() { return widgetCompliance; },
+        get axeIntegration() { return axeIntegration; },
+        get framework() { return framework; },
     };
+    return driver;
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuCH,MAAM,UAAU,6BAA6B,CAC3C,MAAqC;IAErC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC3D,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAE1B,OAAO;QACL,KAAK,CAAC,UAAU;YACd,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS;YACzC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,QAAQ,CAAC,OAAO,EAAE,KAAK,GAAG,QAAQ;YAChC,gBAAgB,GAAG,OAAO,CAAC;YAC3B,IAAI,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC1D,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBACpD,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QACD,uBAAuB,CAAC,OAAO,EAAE,IAAI;YACnC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3B,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC/C,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;QACD,oBAAoB;YAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,gBAAgB,IAAI,oBAAoB;gBAC/C,QAAQ;aACT,CAAC;QACJ,CAAC;QACD,mBAAmB,CAAC,OAAO;YACzB,gBAAgB,GAAG,OAAO,CAAC;YAC3B,IAAI,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC1D,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,yBAAyB,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QACD,KAAK,CAAC,OAAO;YACX,WAAW,GAAG,KAAK,CAAC;YACpB,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,gBAAgB,GAAG,EAAE,CAAC;YACtB,KAAK,WAAW,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/keyboard-navigation.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Feature 7: Keyboard Navigation Controller
+ * ARIA widget keyboard patterns (roving tabindex, activedescendant, type-ahead)
+ */
+import type { Disposable } from "./types.js";
+import type { FocusManagerAPI } from "./focus-management.js";
+export type KeyboardPattern = "roving-tabindex" | "activedescendant" | "grid";
+export interface KeyboardNavigationConfig {
+    container: Element;
+    pattern: KeyboardPattern;
+    orientation?: "horizontal" | "vertical" | "both";
+    wrap?: boolean;
+    typeAhead?: boolean;
+    focusManager: FocusManagerAPI;
+}
+export interface KeyboardNavigationHandle extends Disposable {
+    activate(): void;
+    deactivate(): void;
+    setItems(items: Element[]): void;
+    getCurrentItem(): Element | null;
+    moveTo(index: number): void;
+}
+export interface KeyboardNavigationAPI extends Disposable {
+    createNavigation(id: string, config: KeyboardNavigationConfig): KeyboardNavigationHandle;
+    getNavigation(id: string): KeyboardNavigationHandle | undefined;
+    destroyNavigation(id: string): void;
+}
+export declare function createKeyboardNavigationController(): KeyboardNavigationAPI;
+//# sourceMappingURL=keyboard-navigation.d.ts.map

package/dist/keyboard-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-navigation.d.ts","sourceRoot":"","sources":["../src/keyboard-navigation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAE9E,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IAC1D,QAAQ,IAAI,IAAI,CAAC;IACjB,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjC,cAAc,IAAI,OAAO,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,wBAAwB,CAAC;IACzF,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAAC;IAChE,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wBAAgB,kCAAkC,IAAI,qBAAqB,CA0L1E"}

package/dist/keyboard-navigation.js

@@ -0,0 +1,182 @@
+/**
+ * Feature 7: Keyboard Navigation Controller
+ * ARIA widget keyboard patterns (roving tabindex, activedescendant, type-ahead)
+ */
+export function createKeyboardNavigationController() {
+    const navigations = new Map();
+    return {
+        createNavigation(id, config) {
+            if (navigations.has(id)) {
+                return navigations.get(id);
+            }
+            let items = [];
+            let currentIndex = -1;
+            let active = false;
+            let typeBuffer = "";
+            let typeTimer = null;
+            const orientation = config.orientation ?? "vertical";
+            const wrap = config.wrap ?? true;
+            function isForward(key) {
+                if (orientation === "horizontal" || orientation === "both") {
+                    if (key === "ArrowRight")
+                        return true;
+                }
+                if (orientation === "vertical" || orientation === "both") {
+                    if (key === "ArrowDown")
+                        return true;
+                }
+                return false;
+            }
+            function isBackward(key) {
+                if (orientation === "horizontal" || orientation === "both") {
+                    if (key === "ArrowLeft")
+                        return true;
+                }
+                if (orientation === "vertical" || orientation === "both") {
+                    if (key === "ArrowUp")
+                        return true;
+                }
+                return false;
+            }
+            function focusItem(index) {
+                if (index < 0 || index >= items.length)
+                    return;
+                const prev = currentIndex;
+                currentIndex = index;
+                if (config.pattern === "roving-tabindex") {
+                    if (prev >= 0 && prev < items.length) {
+                        items[prev].setAttribute("tabindex", "-1");
+                    }
+                    items[currentIndex].setAttribute("tabindex", "0");
+                    items[currentIndex].focus();
+                }
+                else if (config.pattern === "activedescendant") {
+                    const itemId = items[currentIndex].id ||
+                        `${config.container.id || "nav"}-item-${currentIndex}`;
+                    if (!items[currentIndex].id) {
+                        items[currentIndex].id = itemId;
+                    }
+                    config.container.setAttribute("aria-activedescendant", itemId);
+                }
+            }
+            function moveForward() {
+                if (items.length === 0)
+                    return;
+                let next = currentIndex + 1;
+                if (next >= items.length) {
+                    next = wrap ? 0 : items.length - 1;
+                }
+                focusItem(next);
+            }
+            function moveBackward() {
+                if (items.length === 0)
+                    return;
+                let prev = currentIndex - 1;
+                if (prev < 0) {
+                    prev = wrap ? items.length - 1 : 0;
+                }
+                focusItem(prev);
+            }
+            function handleTypeAhead(char) {
+                typeBuffer += char.toLowerCase();
+                if (typeTimer)
+                    clearTimeout(typeTimer);
+                typeTimer = setTimeout(() => { typeBuffer = ""; }, 500);
+                const match = items.findIndex((item) => (item.textContent ?? "").toLowerCase().startsWith(typeBuffer));
+                if (match !== -1) {
+                    focusItem(match);
+                }
+            }
+            function handleKeyDown(e) {
+                const event = e;
+                if (isForward(event.key)) {
+                    event.preventDefault();
+                    moveForward();
+                }
+                else if (isBackward(event.key)) {
+                    event.preventDefault();
+                    moveBackward();
+                }
+                else if (event.key === "Home") {
+                    event.preventDefault();
+                    focusItem(0);
+                }
+                else if (event.key === "End") {
+                    event.preventDefault();
+                    focusItem(items.length - 1);
+                }
+                else if (config.typeAhead && event.key.length === 1 && !event.ctrlKey && !event.metaKey) {
+                    handleTypeAhead(event.key);
+                }
+            }
+            const handle = {
+                activate() {
+                    if (active)
+                        return;
+                    active = true;
+                    config.container.addEventListener("keydown", handleKeyDown);
+                    if (config.pattern === "roving-tabindex") {
+                        for (const item of items) {
+                            item.setAttribute("tabindex", "-1");
+                        }
+                        if (items.length > 0) {
+                            focusItem(0);
+                        }
+                    }
+                    else if (config.pattern === "activedescendant") {
+                        config.container.setAttribute("tabindex", "0");
+                        if (items.length > 0) {
+                            focusItem(0);
+                        }
+                    }
+                },
+                deactivate() {
+                    if (!active)
+                        return;
+                    active = false;
+                    config.container.removeEventListener("keydown", handleKeyDown);
+                    if (typeTimer) {
+                        clearTimeout(typeTimer);
+                        typeTimer = null;
+                    }
+                    typeBuffer = "";
+                },
+                setItems(newItems) {
+                    items = [...newItems];
+                    currentIndex = items.length > 0 ? 0 : -1;
+                },
+                getCurrentItem() {
+                    if (currentIndex >= 0 && currentIndex < items.length) {
+                        return items[currentIndex];
+                    }
+                    return null;
+                },
+                moveTo(index) {
+                    focusItem(index);
+                },
+                destroy() {
+                    handle.deactivate();
+                    navigations.delete(id);
+                },
+            };
+            navigations.set(id, handle);
+            return handle;
+        },
+        getNavigation(id) {
+            return navigations.get(id);
+        },
+        destroyNavigation(id) {
+            const handle = navigations.get(id);
+            if (handle) {
+                handle.destroy();
+            }
+        },
+        destroy() {
+            for (const handle of navigations.values()) {
+                handle.deactivate();
+            }
+            navigations.clear();
+        },
+    };
+}
+//# sourceMappingURL=keyboard-navigation.js.map

package/dist/keyboard-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-navigation.js","sourceRoot":"","sources":["../src/keyboard-navigation.ts"],"names":[],"mappings":"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"}