@m3e/core 1.0.0-rc.2 → 1.0.0-rc.3

package/dist/src/a11y/AriaDescriber.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Adapted from Angular Material CDK ARIA Describer
+ * Source: https://github.com/angular/components/blob/main/src/cdk/a11y/aria-describer/aria-describer.ts
+ *
+ * @license MIT
+ * Copyright (c) 2025 Google LLC
+ * See LICENSE file in the project root for full license text.
+ */
+/** Utility for generating visually hidden elements that convey descriptive messages using `aria-describedby`. */
+export declare class M3eAriaDescriber {
+    #private;
+    /**
+     * Adds an `aria-describedby` reference to a hidden element that contains the message.
+     * @param {Element} element The element for which to provide a visually hidden description.
+     * @param {string} message The message used to describe `element`.
+     * @param {string} [role="tooltip"] The ARIA role of the message.
+     */
+    static describe(element: Element, message: string, role?: string): void;
+    /**
+     * Removes an `aria-describedby` reference to a hidden element that contains the message.
+     * @param {Element} element The element from which to remove a visually hidden description.
+     * @param {string} message The message used to describe `element`.
+     * @param {string} [role="tooltip"] The ARIA role of the message.
+     */
+    static removeDescription(element: Element, message: string, role?: string): void;
+}
+declare global {
+    /** Utility for generating visually hidden elements that convey descriptive messages using `aria-describedby`. */
+    var M3eAriaDescriber: M3eAriaDescriber;
+}
+//# sourceMappingURL=AriaDescriber.d.ts.map

package/dist/src/a11y/AriaDescriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AriaDescriber.d.ts","sourceRoot":"","sources":["../../../src/a11y/AriaDescriber.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,iHAAiH;AACjH,qBAAa,gBAAgB;;IAU3B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI;IAmClF;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI;CAkD5F;AAED,OAAO,CAAC,MAAM,CAAC;IACb,iHAAiH;IACjH,IAAI,gBAAgB,EAAE,gBAAgB,CAAC;CACxC"}

package/dist/src/a11y/FocusTrapElement.d.ts

@@ -0,0 +1,25 @@
+import { CSSResultGroup, LitElement } from "lit";
+declare const M3eFocusTrapElement_base: import("../shared/mixins/Constructor").Constructor<import("..").DisabledMixin> & typeof LitElement;
+/**
+ * A non-visual element used to trap focus within nested content.
+ * @tag m3e-focus-trap
+ *
+ * @slot - Renders content for which to trap focus.
+ *
+ * @attr disabled - Disables the focus trap.
+ */
+export declare class M3eFocusTrapElement extends M3eFocusTrapElement_base {
+    #private;
+    /** The styles of the element. */
+    static styles: CSSResultGroup;
+    /** @private */ private readonly _firstTrap;
+    /** @inheritdoc */
+    protected render(): unknown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "m3e-focus-trap": M3eFocusTrapElement;
+    }
+}
+export {};
+//# sourceMappingURL=FocusTrapElement.d.ts.map

package/dist/src/a11y/FocusTrapElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusTrapElement.d.ts","sourceRoot":"","sources":["../../../src/a11y/FocusTrapElement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,cAAc,EAAQ,UAAU,EAAE,MAAM,KAAK,CAAC;;AAO5D;;;;;;;GAOG;AACH,qBACa,mBAAoB,SAAQ,wBAAoB;;IAC3D,iCAAiC;IACjC,OAAgB,MAAM,EAAE,cAAc,CAOpC;IAEF,eAAe,CAAiB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IAEjF,kBAAkB;cACC,MAAM,IAAI,OAAO;CAkGrC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,mBAAmB,CAAC;KACvC;CACF"}

package/dist/src/a11y/InteractivityChecker.d.ts

@@ -0,0 +1,22 @@
+/** Utility for checking the interactivity of an element, such as whether it is focusable. */
+export declare class M3eInteractivityChecker {
+    #private;
+    /**
+     * Determines whether a given element can receive focus.
+     * @param {Element} element The element to test.
+     * @param {readonly Element[]} [parents = undefined] The known parent elements to test. The default value is `undefined`.
+     * @returns {boolean} Whether `element` can receive focus.
+     */
+    static isFocusable(element: Element, parents?: readonly Element[]): boolean;
+    /**
+     * Finds interactive elements that descend from the specified element.
+     * @param {HTMLElement} element The `HTMLElement` to search.
+     * @returns {HTMLElement[]} The interactive elements that descend from `element`.
+     */
+    static findInteractiveElements(element: HTMLElement): HTMLElement[];
+}
+declare global {
+    /** Utility for checking the interactivity of an element, such as whether it is focusable. */
+    var M3eInteractivityChecker: M3eInteractivityChecker;
+}
+//# sourceMappingURL=InteractivityChecker.d.ts.map

package/dist/src/a11y/InteractivityChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractivityChecker.d.ts","sourceRoot":"","sources":["../../../src/a11y/InteractivityChecker.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,qBAAa,uBAAuB;;IAClC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO;IA4B3E;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,EAAE;CAapE;AAED,OAAO,CAAC,MAAM,CAAC;IACb,6FAA6F;IAC7F,IAAI,uBAAuB,EAAE,uBAAuB,CAAC;CACtD"}

package/dist/src/a11y/LiveAnnouncer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Adapted from Angular Material CDK Live Announcer
+ * Source: https://github.com/angular/components/blob/main/src/cdk/a11y/live-announcer/live-announcer.ts
+ *
+ * @license MIT
+ * Copyright (c) 2025 Google LLC
+ * See LICENSE file in the project root for full license text.
+ */
+/** Specifies the possible politeness levels in which to announce messages. */
+export type ARIALivePoliteness = "off" | "polite" | "assertive";
+/** Utility for announcing messages to screen readers. */
+export declare class M3eLiveAnnouncer {
+    #private;
+    /**
+     * Announces the specified message to screen readers.
+     * @param {string} message The message to announce.
+     * @returns {Promise<void>} A `Promise` that resolves when `message` is added to the DOM.
+     */
+    static announce(message: string): Promise<void>;
+    /**
+     * Announces the specified message to screen readers.
+     * @param {string} message The message to announce.
+     * @param {ARIALivePoliteness | undefined} politeness The politeness in which to announce `message`.
+     * @returns {Promise<void>} A `Promise` that resolves when `message` is added to the DOM.
+     */
+    static announce(message: string, politeness?: ARIALivePoliteness): Promise<void>;
+    /**
+     * Announces the specified message to screen readers.
+     * @param {string} message The message to announce.
+     * @param {number | undefined} duration The duration, in milliseconds, after which to clear the announcement. Note
+     * that this takes effect after the message has been added to the DOM, which can be up to
+     * 100ms after `announce` has been called.
+     * @returns {Promise<void>} A `Promise` that resolves when `message` is added to the DOM.
+     */
+    static announce(message: string, duration?: number): Promise<void>;
+    /**
+     * Announces the specified message to screen readers.
+     * @param {string} message The message to announce.
+     * @param {ARIALivePoliteness | undefined} politeness The politeness in which to announce `message`.
+     * @param {number | undefined} duration The duration, in milliseconds, after which to clear the announcement. Note
+     * that this takes effect after the message has been added to the DOM, which can be up to 100ms after `announce` has been called.
+     * @returns {Promise<void>} A `Promise` that resolves when `message` is added to the DOM.
+     */
+    static announce(message: string, politeness?: ARIALivePoliteness, duration?: number): Promise<void>;
+    /**
+     * Clears the current text from the announcer element. Can be used to prevent
+     * screen readers from reading the text out again while the user is going
+     * through page landmarks.
+     */
+    static clear(): void;
+}
+declare global {
+    /** Utility for announcing messages to screen readers. */
+    var M3eLiveAnnouncer: M3eLiveAnnouncer;
+}
+//# sourceMappingURL=LiveAnnouncer.d.ts.map

package/dist/src/a11y/LiveAnnouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveAnnouncer.d.ts","sourceRoot":"","sources":["../../../src/a11y/LiveAnnouncer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhE,yDAAyD;AACzD,qBAAa,gBAAgB;;IAO3B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhF;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CnG;;;;OAIG;IACH,MAAM,CAAC,KAAK;CAyBb;AAED,OAAO,CAAC,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,gBAAgB,EAAE,gBAAgB,CAAC;CACxC"}

package/dist/src/a11y/aria-reference.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Adapted from Angular Material CDK AriaDescriber
+ * Source: https://github.com/angular/components/blob/main/src/cdk/a11y/aria-describer/aria-reference.ts
+ *
+ * @license MIT
+ * Copyright (c) 2025 Google LLC
+ * See LICENSE file in the project root for full license text.
+ */
+/**
+ * Gets a list of IDs referenced by an element for the specified ARIA attribute.
+ * @param {Element} element The element from which to get referenced IDs.
+ * @param {`aria-${string}`} attribute The ARIA attribute from which to get referenced IDs.
+ * @returns {string[]} a list of IDs referenced by `element` for `attribute`.
+ */
+export declare function getAriaReferenceIds(element: Element, attribute: `aria-${string}`): string[];
+/**
+ * Adds an ID to the list of IDs referenced by an element for a given ARIA attribute.
+ * @param {Element} element The element to which to add a referenced ID.
+ * @param {`aria-${string}`} attribute The ARIA attribute to which to add an ID.
+ * @param {string} id The ID to add.
+ */
+export declare function addAriaReferencedId(element: Element, attribute: `aria-${string}`, id: string): void;
+/**
+ * Removes an ID from a list of IDs referenced by an element for the specified ARIA attribute.
+ * @param {Element} element The element from which to remove an ID.
+ * @param {`aria-${string}`} attribute The ARIA attribute from which to remove an ID.
+ * @param {string} id The ID to remove.
+ */
+export declare function removeAriaReferencedId(element: Element, attribute: `aria-${string}`, id: string): void;
+//# sourceMappingURL=aria-reference.d.ts.map

package/dist/src/a11y/aria-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-reference.d.ts","sourceRoot":"","sources":["../../../src/a11y/aria-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,EAAE,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAQnG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAStG"}

package/dist/src/a11y/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./list-key";
+export * from "./keycodes";
+export * from "./aria-reference";
+export * from "./AriaDescriber";
+export * from "./FocusTrapElement";
+export * from "./InteractivityChecker";
+export * from "./LiveAnnouncer";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/a11y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/a11y/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC"}

package/dist/src/a11y/keycodes/KeyCode.d.ts

@@ -0,0 +1,118 @@
+/** Specifies known key code values. */
+export declare enum KeyCode {
+    Backspace = 8,
+    Tab = 9,
+    Enter = 13,
+    Shift = 16,
+    Ctrl = 17,
+    Alt = 18,
+    PauseBreak = 19,
+    CapsLock = 20,
+    Escape = 27,
+    Space = 32,
+    PageUp = 33,
+    PageDown = 34,
+    End = 35,
+    Home = 36,
+    LeftArrow = 37,
+    UpArrow = 38,
+    RightArrow = 39,
+    DownArrow = 40,
+    Insert = 45,
+    Delete = 46,
+    Zero = 48,
+    ClosedParen = 48,
+    One = 49,
+    ExclamationMark = 49,
+    Two = 50,
+    AtSign = 50,
+    Three = 51,
+    PoundSign = 51,
+    Hash = 51,
+    Four = 52,
+    DollarSign = 52,
+    Five = 53,
+    PercentSign = 53,
+    Six = 54,
+    Caret = 54,
+    Hat = 54,
+    Seven = 55,
+    Ampersand = 55,
+    Eight = 56,
+    Star = 56,
+    Asterik = 56,
+    Nine = 57,
+    OpenParen = 57,
+    A = 65,
+    B = 66,
+    C = 67,
+    D = 68,
+    E = 69,
+    F = 70,
+    G = 71,
+    H = 72,
+    I = 73,
+    J = 74,
+    K = 75,
+    L = 76,
+    M = 77,
+    N = 78,
+    O = 79,
+    P = 80,
+    Q = 81,
+    R = 82,
+    S = 83,
+    T = 84,
+    U = 85,
+    V = 86,
+    W = 87,
+    X = 88,
+    Y = 89,
+    Z = 90,
+    LeftWindowKey = 91,
+    RightWindowKey = 92,
+    SelectKey = 93,
+    Numpad0 = 96,
+    Numpad1 = 97,
+    Numpad2 = 98,
+    Numpad3 = 99,
+    Numpad4 = 100,
+    Numpad5 = 101,
+    Numpad6 = 102,
+    Numpad7 = 103,
+    Numpad8 = 104,
+    Numpad9 = 105,
+    Multiply = 106,
+    Add = 107,
+    Subtract = 109,
+    DecimalPoint = 110,
+    Divide = 111,
+    F1 = 112,
+    F2 = 113,
+    F3 = 114,
+    F4 = 115,
+    F5 = 116,
+    F6 = 117,
+    F7 = 118,
+    F8 = 119,
+    F9 = 120,
+    F10 = 121,
+    F11 = 122,
+    F12 = 123,
+    NumLock = 144,
+    ScrollLock = 145,
+    SemiColon = 186,
+    Equals = 187,
+    Comma = 188,
+    Dash = 189,
+    Period = 190,
+    UnderScore = 189,
+    PlusSign = 187,
+    ForwardSlash = 191,
+    Tilde = 192,
+    GraveAccent = 192,
+    OpenBracket = 219,
+    ClosedBracket = 221,
+    Quote = 222
+}
+//# sourceMappingURL=KeyCode.d.ts.map

package/dist/src/a11y/keycodes/KeyCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyCode.d.ts","sourceRoot":"","sources":["../../../../src/a11y/keycodes/KeyCode.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,oBAAY,OAAO;IACjB,SAAS,IAAI;IACb,GAAG,IAAI;IACP,KAAK,KAAK;IACV,KAAK,KAAK;IACV,IAAI,KAAK;IACT,GAAG,KAAK;IACR,UAAU,KAAK;IACf,QAAQ,KAAK;IACb,MAAM,KAAK;IACX,KAAK,KAAK;IACV,MAAM,KAAK;IACX,QAAQ,KAAK;IACb,GAAG,KAAK;IACR,IAAI,KAAK;IAET,SAAS,KAAK;IACd,OAAO,KAAK;IACZ,UAAU,KAAK;IACf,SAAS,KAAK;IAEd,MAAM,KAAK;IACX,MAAM,KAAK;IAEX,IAAI,KAAK;IACT,WAAW,KAAO;IAClB,GAAG,KAAK;IACR,eAAe,KAAM;IACrB,GAAG,KAAK;IACR,MAAM,KAAM;IACZ,KAAK,KAAK;IACV,SAAS,KAAQ;IACjB,IAAI,KAAY;IAChB,IAAI,KAAK;IACT,UAAU,KAAO;IACjB,IAAI,KAAK;IACT,WAAW,KAAO;IAClB,GAAG,KAAK;IACR,KAAK,KAAM;IACX,GAAG,KAAQ;IACX,KAAK,KAAK;IACV,SAAS,KAAQ;IACjB,KAAK,KAAK;IACV,IAAI,KAAQ;IACZ,OAAO,KAAO;IACd,IAAI,KAAK;IACT,SAAS,KAAO;IAEhB,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IACN,CAAC,KAAK;IAEN,aAAa,KAAK;IAClB,cAAc,KAAK;IACnB,SAAS,KAAK;IAEd,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,OAAO,MAAM;IACb,OAAO,MAAM;IACb,OAAO,MAAM;IACb,OAAO,MAAM;IACb,OAAO,MAAM;IACb,OAAO,MAAM;IAEb,QAAQ,MAAM;IACd,GAAG,MAAM;IACT,QAAQ,MAAM;IACd,YAAY,MAAM;IAClB,MAAM,MAAM;IAEZ,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,EAAE,MAAM;IACR,GAAG,MAAM;IACT,GAAG,MAAM;IACT,GAAG,MAAM;IAET,OAAO,MAAM;IACb,UAAU,MAAM;IAEhB,SAAS,MAAM;IACf,MAAM,MAAM;IACZ,KAAK,MAAM;IACX,IAAI,MAAM;IACV,MAAM,MAAM;IACZ,UAAU,MAAO;IACjB,QAAQ,MAAS;IACjB,YAAY,MAAM;IAClB,KAAK,MAAM;IACX,WAAW,MAAQ;IAEnB,WAAW,MAAM;IACjB,aAAa,MAAM;IACnB,KAAK,MAAM;CACZ"}

package/dist/src/a11y/keycodes/ModifierKeys.d.ts

@@ -0,0 +1,5 @@
+/** Specifies the keyboard modifier keys. */
+export type ModifierKey = "alt" | "shift" | "ctrl" | "meta";
+/** The modifier keys. */
+export declare const ModifierKeys: readonly ModifierKey[];
+//# sourceMappingURL=ModifierKeys.d.ts.map

package/dist/src/a11y/keycodes/ModifierKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModifierKeys.d.ts","sourceRoot":"","sources":["../../../../src/a11y/keycodes/ModifierKeys.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,yBAAyB;AACzB,eAAO,MAAM,YAAY,EAAE,SAAS,WAAW,EAAqC,CAAC"}

package/dist/src/a11y/keycodes/getKeyCode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves the key code for the specified `KeyboardEvent`.
+ * @param {KeyboardEvent} e The `KeyboardEvent` for which to resolve the key code.
+ * @returns {number} The key code for `e`.
+ */
+export declare function getKeyCode(e: KeyboardEvent): number;
+//# sourceMappingURL=getKeyCode.d.ts.map

package/dist/src/a11y/keycodes/getKeyCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKeyCode.d.ts","sourceRoot":"","sources":["../../../../src/a11y/keycodes/getKeyCode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAEnD"}

package/dist/src/a11y/keycodes/hasModifierKey.d.ts

@@ -0,0 +1,9 @@
+import { ModifierKey } from "./ModifierKeys";
+/**
+ * Determines whether a modifier key is pressed.
+ * @param {KeyboardEvent} e The `KeyboardEvent` to test.
+ * @param {ModifierKey[]} modifiers The modifier keys to test.
+ * @returns {boolean} A value indicating whether a modifier key is pressed.
+ */
+export declare function hasModifierKey(e: KeyboardEvent, ...modifiers: ModifierKey[]): boolean;
+//# sourceMappingURL=hasModifierKey.d.ts.map

package/dist/src/a11y/keycodes/hasModifierKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasModifierKey.d.ts","sourceRoot":"","sources":["../../../../src/a11y/keycodes/hasModifierKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAErF"}

package/dist/src/a11y/keycodes/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ModifierKeys";
+export * from "./KeyCode";
+export * from "./getKeyCode";
+export * from "./hasModifierKey";
+export * from "./isModifierAllowed";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/a11y/keycodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/a11y/keycodes/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/src/a11y/keycodes/isModifierAllowed.d.ts

@@ -0,0 +1,9 @@
+import { ModifierKey } from "./ModifierKeys";
+/**
+ * Determines whether the specified modifier keys are allowed.
+ * @param {KeyboardEvent} e The `KeyboardEvent` to test.
+ * @param {ModifierKey[]} modifiers The allowed modifier keys.
+ * @returns {boolean} A value indicating whether `modifiers` are allowed.
+ */
+export declare function isModifierAllowed(e: KeyboardEvent, ...modifiers: ModifierKey[]): boolean;
+//# sourceMappingURL=isModifierAllowed.d.ts.map

package/dist/src/a11y/keycodes/isModifierAllowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isModifierAllowed.d.ts","sourceRoot":"","sources":["../../../../src/a11y/keycodes/isModifierAllowed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,MAAM,gBAAgB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAExF"}

package/dist/src/a11y/list-key/FocusKeyManager.d.ts

@@ -0,0 +1,17 @@
+import { ListKeyManager } from "./ListKeyManager";
+/**
+ * Utility for managing keyboard events for selectable lists whose items directly receive focus.
+ * @template T The type of managed item.
+ */
+export declare class FocusKeyManager<T extends HTMLElement> extends ListKeyManager<T> {
+    #private;
+    /** @inheritdoc */
+    setActiveItem(item: T | null | undefined): void;
+    /**
+     * Configures the key manager with options used to focus items.
+     * @param {FocusOptions} options Options used to focus items.
+     * @returns {FocusKeyManager<T>} The configured key manager.
+     */
+    withOptions(options: FocusOptions): this;
+}
+//# sourceMappingURL=FocusKeyManager.d.ts.map

package/dist/src/a11y/list-key/FocusKeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusKeyManager.d.ts","sourceRoot":"","sources":["../../../../src/a11y/list-key/FocusKeyManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,WAAW,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;;IAG3E,kBAAkB;IACT,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAKxD;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;CAIzC"}

package/dist/src/a11y/list-key/ListKeyManager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Adapted from Angular Material CDK KeyManager
+ * Source: https://github.com/angular/components/blob/main/src/cdk/a11y/key-manager/list-key-manager.ts
+ *
+ * @license MIT
+ * Copyright (c) 2025 Google LLC
+ * See LICENSE file in the project root for full license text.
+ */
+import { ModifierKey } from "../keycodes";
+import { ListManager } from "./ListManager";
+import { TypeaheadItem } from "./Typeahead";
+/**
+ * Utility for managing keyboard events for selectable lists.
+ * @template T The type of managed item.
+ */
+export declare class ListKeyManager<T extends HTMLElement & TypeaheadItem> extends ListManager<T> {
+    #private;
+    /**
+     * Whether the active item will wrap to the other end of
+     * list when there are no more items in the given direction.
+     * @default false
+     */
+    wrap: boolean;
+    /**
+     * Whether to activate the first and last items respectively when
+     * the `HOME` or `END` key is pressed.
+     * @default false
+     */
+    homeAndEnd: boolean;
+    /**
+     * Whether to activate every 10th (or configured) first/last item
+     * in the up/down direction when the `PAGEUP` or `PAGEDOWN` key is pressed.
+     * @default false
+     */
+    pageUpAndDown: boolean;
+    /**
+     * The number of items to skip when the `PAGEUP` or `PAGEDOWN` key is pressed.
+     * @default 10
+     */
+    pageDelta: number;
+    /**
+     * Whether to the list is oriented vertically.
+     * @default false
+     */
+    vertical: boolean;
+    /** The allowed modifier keys.
+     * @default []
+     */
+    allowedModifiers: ModifierKey[];
+    /**
+     * A function used to skip items.
+     * @param {T} item The item to test.
+     * @returns {boolean} Whether `item` should be skipped.
+     */
+    skipPredicate: (item: T) => boolean;
+    /** @inheritdoc */
+    setItems(items: T[]): {
+        added: readonly T[];
+        removed: readonly T[];
+    };
+    /** @inheritdoc */
+    updateActiveItem(item: T | null | undefined): void;
+    /**
+     * Configures the key manager to activate the first and last items respectively when the `HOME` or `END` key is pressed.
+     * @param {boolean} [enabled = true] Whether to activate the first and last items respectively when
+     * the `HOME` or `END` key is pressed.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withHomeAndEnd(enabled?: boolean): this;
+    /**
+     * Configures the key manager to page up and down when the `PAGEUP` or `PAGEDOWN` key is pressed.
+     * @param {boolean} [enabled = true] Whether to activate page up and down when the `PAGEUP` or `PAGEDOWN` key is pressed.
+     * @param {number} [pageDelta=10] The number of items to skip when the `PAGEUP` or `PAGEDOWN` key is pressed.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withPageUpAndDown(enabled?: boolean, pageDelta?: number): this;
+    /**
+     * Configures wrapping mode, which determines whether the active item will wrap to the other end of list when there are no more items in the given direction.
+     * @param {boolean} [enabled = true] Whether the active item will wrap to the other end of
+     * list when there are no more items in the given direction.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withWrap(enabled?: boolean): this;
+    /**
+     * Configures whether to move the selection vertically.
+     * @param {boolean} [enabled = true] Whether to move selection vertically.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withVerticalOrientation(enabled?: boolean): this;
+    /**
+     * Configured allowed modifier keys.
+     * @param {ModifierKey[]} modifiers The allowed modifier keys.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withAllowedModifiers(...modifiers: ModifierKey[]): this;
+    /**
+     * Configures whether typeahead is enabled.
+     * @param {boolean} [enabled = true] Whether typeahead is enabled.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withTypeahead(enabled?: boolean): this;
+    /**
+     * Configures a function used to test whether an item should be skipped.
+     * @param skipPredicate A function used to determine whether an item should be skipped.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withSkipPredicate(skipPredicate: (item: T) => boolean): this;
+    /**
+     * Sets the active item depending on the key event passed in.
+     * @param {KeyboardEvent} e The keyboard event to be used for determining which element should be active.
+     */
+    onKeyDown(e: KeyboardEvent): void;
+}
+//# sourceMappingURL=ListKeyManager.d.ts.map

package/dist/src/a11y/list-key/ListKeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListKeyManager.d.ts","sourceRoot":"","sources":["../../../../src/a11y/list-key/ListKeyManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAqC,WAAW,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAa,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,aAAa,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;;IAGvF;;;;OAIG;IACI,IAAI,UAAS;IAEpB;;;;OAIG;IACI,UAAU,UAAS;IAE1B;;;;OAIG;IACI,aAAa,UAAS;IAE7B;;;OAGG;IACI,SAAS,SAAM;IAEtB;;;OAGG;IACI,QAAQ,UAAS;IAExB;;OAEG;IACI,gBAAgB,EAAE,WAAW,EAAE,CAAM;IAE5C;;;;OAIG;IACI,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAoD;IAE9F,kBAAkB;IACT,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;KAAE;IAK7E,kBAAkB;IACT,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAO3D;;;;;OAKG;IACH,cAAc,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAK7C;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,GAAE,OAAc,EAAE,SAAS,GAAE,MAAW,GAAG,IAAI;IAMxE;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAKvC;;;;OAIG;IACH,uBAAuB,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAKtD;;;;OAIG;IACH,oBAAoB,CAAC,GAAG,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI;IAKvD;;;;OAIG;IACH,aAAa,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAS5C;;;;OAIG;IACH,iBAAiB,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI;IAK5D;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;CA0LlC"}

package/dist/src/a11y/list-key/ListManager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Utility for managing a list of items which supports activation.
+ * @template T The type of managed item.
+ */
+export declare class ListManager<T> {
+    #private;
+    /** The items being managed. */
+    get items(): ReadonlyArray<T>;
+    /** The active item. */
+    get activeItem(): T | null;
+    /**
+     * Sets the items to manage.
+     * @param {Array<T>} items The new items.
+     * @returns {{ added: ReadonlyArray<T>; removed: ReadonlyArray<T> }} An object specifying added and removed items.
+     */
+    setItems(items: Array<T>): {
+        added: ReadonlyArray<T>;
+        removed: ReadonlyArray<T>;
+    };
+    /**
+     * Sets the active item.
+     * @param {T | null | undefined} item The new active item.
+     */
+    setActiveItem(item: T | null | undefined): void;
+    /**
+     * Updates the active item.
+     * @param {T | null | undefined} item The active item.
+     */
+    updateActiveItem(item: T | null | undefined): void;
+    /**
+     * Configures the list manager with a callback invoked when an item is activated.
+     * @param {() => void} callback The callback invoked when an item is activated.
+     * @returns {ListManager<T>} The configured list manager.
+     */
+    onActiveItemChange(callback: () => void): this;
+}
+//# sourceMappingURL=ListManager.d.ts.map

package/dist/src/a11y/list-key/ListManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListManager.d.ts","sourceRoot":"","sources":["../../../../src/a11y/list-key/ListManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC;;IAKxB,+BAA+B;IAC/B,IAAI,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAE5B;IAED,uBAAuB;IACvB,IAAI,UAAU,IAAI,CAAC,GAAG,IAAI,CAEzB;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;KAAE;IAajF;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAO/C;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAIlD;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAI/C"}

package/dist/src/a11y/list-key/RadioKeyManager.d.ts

@@ -0,0 +1,20 @@
+import { LitElement } from "lit";
+import { CheckedOrSelectedMixin } from "../../shared/mixins/CheckedOrSelected";
+import { DisabledMixin } from "../../shared/mixins/Disabled";
+import { RovingTabIndexManager } from "./RovingTabIndexManager";
+/**
+ * Utility for managing keyboard events for selectable lists whose items behave like a radio.
+ * @template T The type of managed item.
+ */
+export declare class RadioKeyManager<T extends LitElement & DisabledMixin & CheckedOrSelectedMixin> extends RovingTabIndexManager<T> {
+    #private;
+    /** A value indicating whether managed items are disabled. */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    /** @inheritdoc */
+    setItems(items: T[]): {
+        added: readonly T[];
+        removed: readonly T[];
+    };
+}
+//# sourceMappingURL=RadioKeyManager.d.ts.map

package/dist/src/a11y/list-key/RadioKeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadioKeyManager.d.ts","sourceRoot":"","sources":["../../../../src/a11y/list-key/RadioKeyManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEjC,OAAO,EAAE,sBAAsB,EAAuB,MAAM,uCAAuC,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,eAAe,CAC1B,CAAC,SAAS,UAAU,GAAG,aAAa,GAAG,sBAAsB,CAC7D,SAAQ,qBAAqB,CAAC,CAAC,CAAC;;IAGhC,6DAA6D;IAC7D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAG1B;IAED,kBAAkB;IACT,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;KAAE;CAsB9E"}

package/dist/src/a11y/list-key/RovingTabIndexManager.d.ts

@@ -0,0 +1,22 @@
+import { FocusKeyManager } from "./FocusKeyManager";
+/**
+ * Utility for managing keyboard events and a roving tab index for selectable lists whose items directly receive focus.
+ * @template T The type of managed item.
+ */
+export declare class RovingTabIndexManager<T extends HTMLElement> extends FocusKeyManager<T> {
+    #private;
+    /** @inheritdoc */
+    updateActiveItem(item: T | null | undefined): void;
+    /** @inheritdoc */
+    setItems(items: T[]): {
+        added: readonly T[];
+        removed: readonly T[];
+    };
+    /**
+     * Configures whether roving tab index is disabled.
+     * @param {boolean} [disabled=true] Whether the roving tab index is disabled.
+     * @returns {RovingTabIndexManager<T>} The configured roving tab index manager.
+     */
+    disableRovingTabIndex(disabled?: boolean): this;
+}
+//# sourceMappingURL=RovingTabIndexManager.d.ts.map

package/dist/src/a11y/list-key/RovingTabIndexManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RovingTabIndexManager.d.ts","sourceRoot":"","sources":["../../../../src/a11y/list-key/RovingTabIndexManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;GAGG;AACH,qBAAa,qBAAqB,CAAC,CAAC,SAAS,WAAW,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;;IAGlF,kBAAkB;IACT,gBAAgB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAa3D,kBAAkB;IACT,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;KAAE;IAc7E;;;;OAIG;IACH,qBAAqB,CAAC,QAAQ,GAAE,OAAc,GAAG,IAAI;CAYtD"}