@m3e/web 2.0.0

package/dist/src/chips/SuggestionChipElement.d.ts

@@ -0,0 +1,84 @@
+import { M3eChipElement } from "./ChipElement";
+declare const M3eSuggestionChipElement_base: import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").FormSubmitterMixin> & import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").AttachInternalsMixin> & import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").LinkButtonMixin> & import("../core/shared/mixins/Constructor").Constructor & import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").DisabledInteractiveMixin> & import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").DisabledMixin> & typeof M3eChipElement;
+/**
+ * A chip used to help narrow a user's intent by presenting dynamically generated suggestions, such as
+ * suggested responses or search filters.
+ *
+ * @description
+ * The `m3e-suggestion-chip` component presents a suggestion chip, offering users contextually relevant
+ * actions or responses. It is designed for dynamic suggestion scenarios, such as search filters or
+ * smart replies, and supports accessibility, keyboard interaction, and expressive state styling in line
+ * with Material 3 guidelines.  Appearance variants include `elevated` and `outlined`, enabling visual
+ * differentiation and contextual emphasis.
+ *
+ * @example
+ * The following example illustrates use of the `m3e-suggestion-chip`.  In this example, multiple chips are nested inside
+ * a `m3e-chip-set` container to create a cohesive set of chips. The container is given the ARIA `role="group"` to convey
+ * to assistive technologies that the chips are part of a related set of element.
+ * ```html
+ * <m3e-chip-set role="group" aria-label="Suggested replies">
+ *  <m3e-suggestion-chip>Sounds good!</m3e-suggestion-chip>
+ *  <m3e-suggestion-chip>Can you clarify?</m3e-suggestion-chip>
+ *  <m3e-suggestion-chip>Let's do it.</m3e-suggestion-chip>
+ *  <m3e-suggestion-chip>Maybe later.</m3e-suggestion-chip>
+ * </m3e-chip-set>
+ * ```
+ *
+ * @tag m3e-suggestion-chip
+ *
+ * @slot - Renders the label of the chip.
+ * @slot icon - Renders an icon before the chip's label.
+ *
+ * @attr disabled - A value indicating whether the element is disabled.
+ * @attr disabled-interactive - A value indicating whether the element is disabled and interactive.
+ * @attr download - A value indicating whether the `target` of the link button will be downloaded, optionally specifying the new name of the file.
+ * @attr href - The URL to which the link button points.
+ * @attr name - The name of the element, submitted as a pair with the element's `value` as part of form data, when the element is used to submit a form.
+ * @attr rel - The relationship between the `target` of the link button and the document.
+ * @attr target - The target of the link button.
+ * @attr type - The type of the element.
+ * @attr value - A string representing the value of the chip.
+ * @attr variant - The appearance variant of the chip.
+ *
+ * @fires click - Emitted when the element is clicked.
+ *
+ * @cssprop --m3e-chip-container-shape - Border radius of the chip container.
+ * @cssprop --m3e-chip-container-height - Base height of the chip container before density adjustment.
+ * @cssprop --m3e-chip-label-text-font-size - Font size of the chip label text.
+ * @cssprop --m3e-chip-label-text-font-weight - Font weight of the chip label text.
+ * @cssprop --m3e-chip-label-text-line-height - Line height of the chip label text.
+ * @cssprop --m3e-chip-label-text-tracking - Letter spacing of the chip label text.
+ * @cssprop --m3e-chip-label-text-color - Label text color in default state.
+ * @cssprop --m3e-chip-icon-color - Icon color in default state.
+ * @cssprop --m3e-chip-icon-size - Font size of leading/trailing icons.
+ * @cssprop --m3e-chip-spacing - Horizontal gap between chip content elements.
+ * @cssprop --m3e-chip-padding-start - Default start padding when no icon is present.
+ * @cssprop --m3e-chip-padding-end - Default end padding when no trailing icon is present.
+ * @cssprop --m3e-chip-with-icon-padding-start - Start padding when leading icon is present.
+ * @cssprop --m3e-chip-with-icon-padding-end - End padding when trailing icon is present.
+ * @cssprop --m3e-chip-disabled-label-text-color - Base color for disabled label text.
+ * @cssprop --m3e-chip-disabled-label-text-opacity - Opacity applied to disabled label text.
+ * @cssprop --m3e-chip-disabled-icon-color - Base color for disabled icons.
+ * @cssprop --m3e-chip-disabled-icon-opacity - Opacity applied to disabled icons.
+ * @cssprop --m3e-elevated-chip-container-color - Background color for elevated variant.
+ * @cssprop --m3e-elevated-chip-elevation - Elevation level for elevated variant.
+ * @cssprop --m3e-elevated-chip-hover-elevation - Elevation level on hover.
+ * @cssprop --m3e-elevated-chip-disabled-container-color - Background color for disabled elevated variant.
+ * @cssprop --m3e-elevated-chip-disabled-container-opacity - Opacity applied to disabled elevated background.
+ * @cssprop --m3e-elevated-chip-disabled-elevation - Elevation level for disabled elevated variant.
+ * @cssprop --m3e-outlined-chip-outline-thickness - Outline thickness for outlined variant.
+ * @cssprop --m3e-outlined-chip-outline-color - Outline color for outlined variant.
+ * @cssprop --m3e-outlined-chip-disabled-outline-color - Outline color for disabled outlined variant.
+ * @cssprop --m3e-outlined-chip-disabled-outline-opacity - Opacity applied to disabled outline.
+ */
+export declare class M3eSuggestionChipElement extends M3eSuggestionChipElement_base {
+    /** @internal @inheritdoc */
+    protected _renderTrailingIcon(): unknown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "m3e-suggestion-chip": M3eSuggestionChipElement;
+    }
+}
+export {};
+//# sourceMappingURL=SuggestionChipElement.d.ts.map

package/dist/src/chips/SuggestionChipElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionChipElement.d.ts","sourceRoot":"","sources":["../../../src/chips/SuggestionChipElement.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,qBACa,wBAAyB,SAAQ,6BAK7C;IACC,4BAA4B;cACT,mBAAmB,IAAI,OAAO;CAGlD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,qBAAqB,EAAE,wBAAwB,CAAC;KACjD;CACF"}

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

@@ -0,0 +1,10 @@
+export * from "./AssistChipElement";
+export * from "./ChipElement";
+export * from "./ChipSetElement";
+export * from "./ChipVariant";
+export * from "./FilterChipElement";
+export * from "./FilterChipSetElement";
+export * from "./InputChipElement";
+export * from "./InputChipSetElement";
+export * from "./SuggestionChipElement";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chips/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/src/core/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/core/a11y/AriaDescriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AriaDescriber.d.ts","sourceRoot":"","sources":["../../../../src/core/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/core/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/core/a11y/FocusTrapElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusTrapElement.d.ts","sourceRoot":"","sources":["../../../../src/core/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;CA2GrC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,mBAAmB,CAAC;KACvC;CACF"}

package/dist/src/core/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/core/a11y/InteractivityChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractivityChecker.d.ts","sourceRoot":"","sources":["../../../../src/core/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/core/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/core/a11y/LiveAnnouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveAnnouncer.d.ts","sourceRoot":"","sources":["../../../../src/core/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;IAgDnG;;;;OAIG;IACH,MAAM,CAAC,KAAK;CAyBb;AAED,OAAO,CAAC,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,gBAAgB,EAAE,gBAAgB,CAAC;CACxC"}

package/dist/src/core/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/core/a11y/aria-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-reference.d.ts","sourceRoot":"","sources":["../../../../src/core/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/core/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/core/a11y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/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/core/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/core/a11y/keycodes/KeyCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyCode.d.ts","sourceRoot":"","sources":["../../../../../src/core/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/core/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/core/a11y/keycodes/ModifierKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModifierKeys.d.ts","sourceRoot":"","sources":["../../../../../src/core/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/core/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/core/a11y/keycodes/getKeyCode.d.ts.map

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

package/dist/src/core/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/core/a11y/keycodes/hasModifierKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasModifierKey.d.ts","sourceRoot":"","sources":["../../../../../src/core/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/core/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/core/a11y/keycodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/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/core/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/core/a11y/keycodes/isModifierAllowed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isModifierAllowed.d.ts","sourceRoot":"","sources":["../../../../../src/core/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/core/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/core/a11y/list-key/FocusKeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusKeyManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/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/core/a11y/list-key/ListKeyManager.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 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;
+    /**
+     * The directionality.
+     * @default "ltr"
+     */
+    directionality: "ltr" | "rtl";
+    /** @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;
+    /**
+     * Configures the directionality.
+     * @param {"ltr" | "rtl"} directionality The directionality.
+     * @returns {ListKeyManager<T>} The configured key manager.
+     */
+    withDirectionality(directionality: "ltr" | "rtl"): 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