@a11y-oracle/core-engine 1.0.0

package/dist/lib/speech-engine.js

@@ -0,0 +1,219 @@
+/**
+ * @module speech-engine
+ *
+ * The central class of A11y-Oracle. {@link SpeechEngine} connects to the
+ * browser's Accessibility Tree via the Chrome DevTools Protocol and generates
+ * standardized speech output following the format:
+ *
+ * ```
+ * [Computed Name], [Role], [State/Properties]
+ * ```
+ *
+ * Chrome's CDP already computes accessible names per the W3C AccName spec,
+ * so the engine's job is to:
+ * 1. Fetch the AXTree via `Accessibility.getFullAXTree()`
+ * 2. Find the currently focused node
+ * 3. Map the node's role and properties to human-readable strings
+ * 4. Assemble the final speech string
+ *
+ * @example
+ * ```typescript
+ * import { SpeechEngine } from '@a11y-oracle/core-engine';
+ *
+ * const engine = new SpeechEngine(cdpSession);
+ * await engine.enable();
+ *
+ * const result = await engine.getSpeech();
+ * console.log(result?.speech); // "Products, button, collapsed"
+ * ```
+ */
+import { ROLE_TO_SPEECH, LANDMARK_ROLES } from './role-map.js';
+import { extractStates } from './state-map.js';
+/**
+ * Generates standardized speech output from the browser's Accessibility Tree.
+ *
+ * The engine operates through a {@link CDPSessionLike} interface, making it
+ * framework-agnostic. It works with Playwright's CDP sessions, raw WebSocket
+ * connections, or any other CDP-compatible client.
+ *
+ * ## Speech Output Format
+ *
+ * Every element produces a string in this format:
+ * ```
+ * [Computed Name], [Role], [State/Properties]
+ * ```
+ *
+ * Parts are omitted if they are empty. For example:
+ * - `"Products, button, collapsed"` — name + role + state
+ * - `"Main, navigation landmark"` — name + role (landmark)
+ * - `"Home, link"` — name + role (no states)
+ *
+ * ## Landmark Roles
+ *
+ * Landmark roles (navigation, main, banner, etc.) automatically append
+ * the word "landmark" to their role string unless
+ * {@link SpeechEngineOptions.includeLandmarks} is set to `false`.
+ */
+export class SpeechEngine {
+    cdp;
+    options;
+    /**
+     * Create a new SpeechEngine instance.
+     *
+     * @param cdp - A CDP session-like object for sending protocol commands.
+     * @param options - Optional configuration for speech output behavior.
+     */
+    constructor(cdp, options = {}) {
+        this.cdp = cdp;
+        this.options = {
+            includeLandmarks: options.includeLandmarks ?? true,
+            includeDescription: options.includeDescription ?? false,
+        };
+    }
+    /**
+     * Enable the CDP Accessibility domain.
+     *
+     * Must be called before any other method. Enables the browser to
+     * start tracking and reporting accessibility tree data.
+     */
+    async enable() {
+        await this.cdp.send('Accessibility.enable');
+    }
+    /**
+     * Disable the CDP Accessibility domain.
+     *
+     * Call this when you're done using the engine to free browser resources.
+     */
+    async disable() {
+        await this.cdp.send('Accessibility.disable');
+    }
+    /**
+     * Get the speech output for the currently focused element.
+     *
+     * Fetches the full AXTree, locates the node with `focused: true`,
+     * and computes its speech string.
+     *
+     * @returns The {@link SpeechResult} for the focused element, or `null`
+     *          if no element has focus or the focused element is ignored.
+     *
+     * @example
+     * ```typescript
+     * // After pressing Tab to focus a button
+     * const result = await engine.getSpeech();
+     * console.log(result?.speech); // "Products, button, collapsed"
+     * console.log(result?.name);   // "Products"
+     * console.log(result?.role);   // "button"
+     * console.log(result?.states); // ["collapsed"]
+     * ```
+     */
+    async getSpeech() {
+        const { nodes } = await this.cdp.send('Accessibility.getFullAXTree');
+        const focusedNode = this.findFocusedNode(nodes);
+        if (!focusedNode)
+            return null;
+        return this.computeSpeech(focusedNode);
+    }
+    /**
+     * Get speech output for ALL non-ignored, non-silent nodes in the tree.
+     *
+     * Useful for asserting on landmarks, headings, or other structural
+     * elements that may not have focus.
+     *
+     * @returns An array of {@link SpeechResult} objects for every visible
+     *          node that produces speech output.
+     *
+     * @example
+     * ```typescript
+     * const all = await engine.getFullTreeSpeech();
+     * const nav = all.find(r => r.speech === 'Main, navigation landmark');
+     * expect(nav).toBeDefined();
+     * ```
+     */
+    async getFullTreeSpeech() {
+        const { nodes } = await this.cdp.send('Accessibility.getFullAXTree');
+        return nodes
+            .map((node) => this.computeSpeech(node))
+            .filter((result) => result !== null);
+    }
+    /**
+     * Find the most specific focused node in the flat AXTree node list.
+     *
+     * CDP returns the AXTree as a flat array with the document node first
+     * and more specific nodes later. Multiple nodes can report `focused: true`
+     * (e.g., both the RootWebArea and the actual focused element). This method
+     * returns the **last** focused node, which is the most specific (deepest)
+     * element that actually has user focus.
+     *
+     * @param nodes - The flat array of AXNodes from `getFullAXTree()`.
+     * @returns The most specific focused node, or `null` if no node is focused.
+     */
+    findFocusedNode(nodes) {
+        let lastFocused = null;
+        for (const node of nodes) {
+            const focused = node.properties?.find((p) => p.name === 'focused');
+            if (focused?.value?.value === true) {
+                lastFocused = node;
+            }
+        }
+        return lastFocused;
+    }
+    /**
+     * Compute the speech string for a single AXNode.
+     *
+     * Follows the output format: `[Computed Name], [Role], [State/Properties]`.
+     * Parts are omitted when empty. Ignored nodes and nodes with no
+     * meaningful content return `null`.
+     *
+     * @param node - A CDP AXNode from the accessibility tree.
+     * @returns A {@link SpeechResult} with the computed speech, or `null`
+     *          if the node should be silent (ignored, no role, no name).
+     *
+     * @example
+     * ```typescript
+     * const result = engine.computeSpeech(axNode);
+     * // { speech: "Products, button, collapsed", name: "Products", ... }
+     * ```
+     */
+    computeSpeech(node) {
+        const role = node.role?.value;
+        if (!role)
+            return null;
+        // Skip ignored/invisible nodes
+        if (node.ignored)
+            return null;
+        const name = node.name?.value ?? '';
+        let speechRole = ROLE_TO_SPEECH[role] ?? role;
+        // Skip nodes with no role output and no name (generic containers, etc.)
+        if (!speechRole && !name)
+            return null;
+        // Append "landmark" to landmark roles
+        if (this.options.includeLandmarks && LANDMARK_ROLES.has(role)) {
+            speechRole = `${speechRole} landmark`;
+        }
+        const states = extractStates(node.properties);
+        // Build the speech parts: [name], [role], [states...]
+        const parts = [];
+        if (name)
+            parts.push(name);
+        if (speechRole)
+            parts.push(speechRole);
+        parts.push(...states);
+        // Optionally include description
+        if (this.options.includeDescription) {
+            const description = node.description?.value ?? '';
+            if (description)
+                parts.push(description);
+        }
+        const speech = parts.join(', ');
+        // Don't return results with empty speech
+        if (!speech)
+            return null;
+        return {
+            speech,
+            name,
+            role: speechRole,
+            states,
+            rawNode: node,
+        };
+    }
+}

package/dist/lib/state-map.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @module state-map
+ *
+ * Maps Chrome DevTools Protocol AXNode property values to human-readable
+ * state strings used in speech output.
+ *
+ * CDP provides node properties as an array of `{ name, value }` objects.
+ * This module translates those boolean/enumerated properties into the
+ * words a screen reader would announce (e.g., `expanded: false` → `"collapsed"`).
+ */
+/**
+ * Defines how a single CDP AXNode property maps to spoken state strings.
+ *
+ * For boolean properties, `trueValue` is spoken when the property is `true`,
+ * and `falseValue` when `false`. An empty string means the state is not
+ * announced for that value.
+ */
+export interface StateMapping {
+    /** The CDP property name (e.g., `"expanded"`, `"checked"`). */
+    property: string;
+    /** The string to speak when the property value is `true`. */
+    trueValue: string;
+    /** The string to speak when the property value is `false`. Empty string means silent. */
+    falseValue: string;
+}
+/**
+ * Ordered list of CDP property → spoken state mappings.
+ *
+ * The order determines the sequence in which states appear in the speech
+ * output when multiple states are present. For example, a required invalid
+ * field produces `"..., required, invalid"`.
+ *
+ * @example
+ * ```
+ * aria-expanded="false" → "collapsed"
+ * aria-expanded="true"  → "expanded"
+ * aria-checked="true"   → "checked"
+ * aria-disabled="true"  → "dimmed"
+ * ```
+ */
+export declare const STATE_MAPPINGS: StateMapping[];
+/**
+ * Represents a single property from a CDP AXNode's `properties` array.
+ *
+ * CDP encodes property values as `{ type, value }` objects. For boolean
+ * properties, `type` is `"boolean"` or `"booleanOrUndefined"` and `value`
+ * is `true` or `false`.
+ */
+export interface AXNodeProperty {
+    name: string;
+    value: {
+        type: string;
+        value?: unknown;
+    };
+}
+/**
+ * Extract human-readable state strings from a CDP AXNode's properties array.
+ *
+ * Iterates through {@link STATE_MAPPINGS} and checks whether each mapped
+ * property is present in the node's properties. Also handles the special
+ * `level` property for headings.
+ *
+ * @param properties - The `properties` array from a CDP AXNode, or `undefined`.
+ * @returns An array of state strings (e.g., `["collapsed"]`, `["checked", "required"]`).
+ *          Returns an empty array if no properties are present or none match.
+ *
+ * @example
+ * ```typescript
+ * extractStates([
+ *   { name: 'expanded', value: { type: 'boolean', value: false } },
+ *   { name: 'required', value: { type: 'boolean', value: true } },
+ * ]);
+ * // → ['collapsed', 'required']
+ *
+ * extractStates([
+ *   { name: 'level', value: { type: 'integer', value: 2 } },
+ * ]);
+ * // → ['level 2']
+ * ```
+ */
+export declare function extractStates(properties: AXNodeProperty[] | undefined): string[];
+//# sourceMappingURL=state-map.d.ts.map

package/dist/lib/state-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-map.d.ts","sourceRoot":"","sources":["../../src/lib/state-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAUxC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,cAAc,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CAwBV"}

package/dist/lib/state-map.js

@@ -0,0 +1,86 @@
+/**
+ * @module state-map
+ *
+ * Maps Chrome DevTools Protocol AXNode property values to human-readable
+ * state strings used in speech output.
+ *
+ * CDP provides node properties as an array of `{ name, value }` objects.
+ * This module translates those boolean/enumerated properties into the
+ * words a screen reader would announce (e.g., `expanded: false` → `"collapsed"`).
+ */
+/**
+ * Ordered list of CDP property → spoken state mappings.
+ *
+ * The order determines the sequence in which states appear in the speech
+ * output when multiple states are present. For example, a required invalid
+ * field produces `"..., required, invalid"`.
+ *
+ * @example
+ * ```
+ * aria-expanded="false" → "collapsed"
+ * aria-expanded="true"  → "expanded"
+ * aria-checked="true"   → "checked"
+ * aria-disabled="true"  → "dimmed"
+ * ```
+ */
+export const STATE_MAPPINGS = [
+    { property: 'expanded', trueValue: 'expanded', falseValue: 'collapsed' },
+    { property: 'checked', trueValue: 'checked', falseValue: 'not checked' },
+    { property: 'selected', trueValue: 'selected', falseValue: '' },
+    { property: 'pressed', trueValue: 'pressed', falseValue: 'not pressed' },
+    { property: 'disabled', trueValue: 'dimmed', falseValue: '' },
+    { property: 'required', trueValue: 'required', falseValue: '' },
+    { property: 'invalid', trueValue: 'invalid', falseValue: '' },
+    { property: 'readonly', trueValue: 'read only', falseValue: '' },
+    { property: 'multiselectable', trueValue: 'multi selectable', falseValue: '' },
+];
+/**
+ * Extract human-readable state strings from a CDP AXNode's properties array.
+ *
+ * Iterates through {@link STATE_MAPPINGS} and checks whether each mapped
+ * property is present in the node's properties. Also handles the special
+ * `level` property for headings.
+ *
+ * @param properties - The `properties` array from a CDP AXNode, or `undefined`.
+ * @returns An array of state strings (e.g., `["collapsed"]`, `["checked", "required"]`).
+ *          Returns an empty array if no properties are present or none match.
+ *
+ * @example
+ * ```typescript
+ * extractStates([
+ *   { name: 'expanded', value: { type: 'boolean', value: false } },
+ *   { name: 'required', value: { type: 'boolean', value: true } },
+ * ]);
+ * // → ['collapsed', 'required']
+ *
+ * extractStates([
+ *   { name: 'level', value: { type: 'integer', value: 2 } },
+ * ]);
+ * // → ['level 2']
+ * ```
+ */
+export function extractStates(properties) {
+    if (!properties || properties.length === 0)
+        return [];
+    const states = [];
+    for (const mapping of STATE_MAPPINGS) {
+        const prop = properties.find((p) => p.name === mapping.property);
+        if (!prop)
+            continue;
+        const val = prop.value?.value;
+        if (val === true || val === 'true') {
+            if (mapping.trueValue)
+                states.push(mapping.trueValue);
+        }
+        else if (val === false || val === 'false') {
+            if (mapping.falseValue)
+                states.push(mapping.falseValue);
+        }
+    }
+    // Handle heading level (special property, not boolean)
+    const level = properties.find((p) => p.name === 'level');
+    if (level?.value?.value !== undefined) {
+        states.push(`level ${level.value.value}`);
+    }
+    return states;
+}

package/dist/lib/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @module types
+ *
+ * Core type definitions for the A11y-Oracle speech engine.
+ *
+ * The key abstraction is {@link CDPSessionLike}, which decouples the engine
+ * from any specific test framework. Both Playwright's `CDPSession` and a raw
+ * WebSocket CDP client can satisfy this interface.
+ */
+import type { Protocol } from 'devtools-protocol';
+import type { CDPSessionLike as BaseCDPSessionLike } from '@a11y-oracle/cdp-types';
+/**
+ * Extended CDP session interface with typed Accessibility domain methods.
+ *
+ * Extends the base {@link BaseCDPSessionLike} from `@a11y-oracle/cdp-types`
+ * with specific overloads for the Accessibility CDP domain used by the
+ * speech engine and orchestrator.
+ */
+export interface CDPSessionLike extends BaseCDPSessionLike {
+    send(method: 'Accessibility.enable'): Promise<void>;
+    send(method: 'Accessibility.disable'): Promise<void>;
+    send(method: 'Accessibility.getFullAXTree', params?: {
+        depth?: number;
+        frameId?: string;
+    }): Promise<Protocol.Accessibility.GetFullAXTreeResponse>;
+    send(method: string, params?: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * The result of computing speech output for a single accessibility node.
+ *
+ * Contains both the final speech string and its constituent parts for
+ * granular assertions.
+ *
+ * @example
+ * ```typescript
+ * const result: SpeechResult = {
+ *   speech: 'Products, button, collapsed',
+ *   name: 'Products',
+ *   role: 'button',
+ *   states: ['collapsed'],
+ *   rawNode: { ... } // CDP AXNode
+ * };
+ * ```
+ */
+export interface SpeechResult {
+    /** The full speech string, e.g. `"Products, button, collapsed"`. */
+    speech: string;
+    /** The computed accessible name. */
+    name: string;
+    /** The human-readable role string (already mapped from CDP role). */
+    role: string;
+    /** Array of state strings, e.g. `["collapsed"]`, `["checked", "required"]`. */
+    states: string[];
+    /** The raw CDP AXNode for advanced inspection. */
+    rawNode: Protocol.Accessibility.AXNode;
+}
+/**
+ * DOM-level information about the currently focused element.
+ *
+ * This is the orchestrator's view of the focused element — a simpler,
+ * framework-agnostic shape compared to `FocusedElementInfo` from
+ * keyboard-engine (which is a raw CDP extraction type).
+ */
+export interface A11yFocusedElement {
+    /** Tag name, e.g. `'BUTTON'`. */
+    tag: string;
+    /** Element `id` attribute, or empty string. */
+    id: string;
+    /** Element `className` attribute, or empty string. */
+    className: string;
+    /** Trimmed text content of the element. */
+    textContent: string;
+    /** The element's `role` attribute, or empty string. */
+    role: string;
+    /** The element's `aria-label` attribute, or empty string. */
+    ariaLabel: string;
+    /** The element's `tabIndex` property. */
+    tabIndex: number;
+    /** Bounding rectangle in viewport coordinates. */
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Visual focus indicator analysis from CSS computed styles.
+ *
+ * A simplified projection of the full {@link FocusIndicator} from
+ * `@a11y-oracle/focus-analyzer`, carrying only the fields needed
+ * for unified state assertions.
+ */
+export interface A11yFocusIndicator {
+    /** Whether any visual focus indicator is detected. */
+    isVisible: boolean;
+    /**
+     * Contrast ratio of the focus indicator against the background.
+     * `null` if the colors could not be reliably parsed.
+     */
+    contrastRatio: number | null;
+    /**
+     * Whether the indicator meets WCAG 2.4.12 AA
+     * (contrast ≥ 3.0 and indicator is visible).
+     */
+    meetsWCAG_AA: boolean;
+}
+/**
+ * Unified accessibility state combining speech output, focus information,
+ * and visual indicator analysis.
+ *
+ * Returned by {@link A11yOrchestrator.pressKey} and
+ * {@link A11yOrchestrator.getState} to give a single snapshot of
+ * "what the screen reader says" + "where focus is" + "how focus looks".
+ *
+ * @example
+ * ```typescript
+ * const state = await orchestrator.pressKey('Tab');
+ * console.log(state.speech);           // "Products, button, collapsed"
+ * console.log(state.focusedElement?.tag); // "BUTTON"
+ * console.log(state.focusIndicator.meetsWCAG_AA); // true
+ * ```
+ */
+export interface A11yState {
+    /** The full speech string, e.g. `"Products, button, collapsed"`. */
+    speech: string;
+    /** The full speech result with raw AXNode data. `null` if no focused element. */
+    speechResult: SpeechResult | null;
+    /** DOM-level info about the focused element. `null` if no element has focus. */
+    focusedElement: A11yFocusedElement | null;
+    /** Visual focus indicator analysis. */
+    focusIndicator: A11yFocusIndicator;
+}
+/**
+ * Configuration options for the {@link A11yOrchestrator}.
+ */
+export interface A11yOrchestratorOptions extends SpeechEngineOptions {
+    /**
+     * Milliseconds to wait after a key press before reading state,
+     * allowing CSS transitions and focus events to settle.
+     * Defaults to `50`.
+     */
+    focusSettleMs?: number;
+}
+/**
+ * Configuration options for the {@link SpeechEngine}.
+ */
+export interface SpeechEngineOptions {
+    /**
+     * Whether to include landmark roles in speech output.
+     * When `true` (default), landmarks like `<nav>` produce
+     * `"Main, navigation landmark"`.
+     */
+    includeLandmarks?: boolean;
+    /**
+     * Whether to include the accessible description in speech output.
+     * When `true`, the description is appended after states.
+     * Defaults to `false`.
+     */
+    includeDescription?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,IAAI,CACF,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CACF,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,IAAI,CACF,MAAM,EAAE,6BAA6B,EACrC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,uCAAuC;IACvC,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/lib/types.js

@@ -0,0 +1,10 @@
+/**
+ * @module types
+ *
+ * Core type definitions for the A11y-Oracle speech engine.
+ *
+ * The key abstraction is {@link CDPSessionLike}, which decouples the engine
+ * from any specific test framework. Both Playwright's `CDPSession` and a raw
+ * WebSocket CDP client can satisfy this interface.
+ */
+export {};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@a11y-oracle/core-engine",
+  "version": "1.0.0",
+  "description": "Framework-agnostic accessibility speech engine and unified A11yOrchestrator via Chrome DevTools Protocol",
+  "license": "MIT",
+  "author": "a11y-oracle",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a11y-oracle/a11y-oracle.git",
+    "directory": "libs/core-engine"
+  },
+  "bugs": {
+    "url": "https://github.com/a11y-oracle/a11y-oracle/issues"
+  },
+  "homepage": "https://github.com/a11y-oracle/a11y-oracle/tree/main/libs/core-engine",
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "screen-reader",
+    "speech",
+    "wcag",
+    "aria",
+    "cdp",
+    "testing"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "@a11y-oracle/cdp-types": "1.0.0",
+    "@a11y-oracle/keyboard-engine": "1.0.0",
+    "@a11y-oracle/focus-analyzer": "1.0.0",
+    "devtools-protocol": "^0.0.1591961",
+    "tslib": "^2.3.0"
+  }
+}