@loadsmart/miranda-wc 1.48.1 → 1.50.0

package/dist/controllers/focus-manager/focus-manager.controller.d.ts

@@ -0,0 +1,89 @@
+import type { ReactiveControllerHost, ReactiveController } from 'lit';
+export declare const SEARCH_BUFFER_TIMEOUT = 500;
+export type FocusManagerControllerHost = ReactiveControllerHost & HTMLElement;
+export type FocusManagerControllerOptions = {
+    query: string | string[];
+    focusOnType?: boolean;
+    getInteractiveElement?: (host: FocusManagerControllerHost) => HTMLElement;
+};
+export type PositionalFocus = 'first' | 'last' | 'previous' | 'next';
+/**
+ * Check if `keyboardEventKey` is a character, and more specifically, anything
+ * other than a space, tab, or newline.
+ */
+export declare function isPrintableCharacter(keyboardEventKey: string): boolean;
+/**
+ * Manages **virtual/visual** focus, for a11y purposes.
+ */
+export declare class FocusManagerController implements ReactiveController {
+    #private;
+    host: FocusManagerControllerHost;
+    activeDescendant: string | null;
+    /**
+     * Keys (printable characters) the user typed on the watched host.
+     * The expectation is that the user wants to focus/select something.
+     */
+    quickSearchBuffer: string;
+    /**
+     * Timeout to clear the buffer.
+     */
+    quickSearchBufferTimeout?: number | null;
+    /**
+     * Query to get virtually focusable elements inside the `host`.
+     */
+    query: string;
+    /**
+     * When user types printable characters, should the focus move to the next `queried` item whose label
+     * starts with `quickSearchBuffer`, if such an item exists (otherwise, focus does not move)?
+     */
+    focusOnType: boolean;
+    /**
+     * Get the element that will receive the `aria-activedescendant` attribute. This is necessary when the
+     * host element is not the one directly hosting the focusable elements.
+     * If no override is provided, the `host` element itself is used.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-activedescendant MDN, aria-activedescendant}
+     */
+    getInteractiveElement: (host: FocusManagerControllerHost) => HTMLElement;
+    constructor(host: FocusManagerControllerHost, options: FocusManagerControllerOptions);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Get the list of elements matching the given `options.query`.
+     */
+    get queried(): HTMLElement[];
+    /**
+     * Get the currently focused element, based on `activeDescendant`.
+     */
+    get focused(): HTMLElement | null;
+    /**
+     * If none of the options are selected, the first option receives focus; otherwise, the
+     * focus moves to the next option.
+     * If we are at the end of the `queried` array, the focus moves to the first option.
+     */
+    focusNext(): void;
+    /**
+     * If none of the options are selected, the last option receives focus; otherwise, the
+     * focus moves to the next option.
+     * If we are at the start of the `queried` array, the focus moves to the last option.
+     */
+    focusPrevious(): void;
+    /**
+     * Focus the first element in `queried`.
+     */
+    focusFirst(): void;
+    /**
+     * Focus the last element in `queried`.
+     */
+    focusLast(): void;
+    /**
+     * Focus the given element or the element at the given index or position, based on `queried`.
+     */
+    focus(where: number | HTMLElement | PositionalFocus): void;
+    /**
+     * Remove the visual focus (`.is-focused` class) from the currently focused element and
+     * clear the `activeDescendant` attribute.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=focus-manager.controller.d.ts.map

package/dist/controllers/focus-manager/focus-manager.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-manager.controller.d.ts","sourceRoot":"","sources":["../../../src/controllers/focus-manager/focus-manager.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,KAAK,CAAC;AAGtE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,GAAG,WAAW,CAAC;AAE9E,MAAM,MAAM,6BAA6B,GAAG;IAC3C,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,WAAW,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAWrE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED;;GAEG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;;IAChE,IAAI,EAAE,0BAA0B,CAAC;IAEjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEvC;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;;;OAMG;IACH,qBAAqB,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,WAAW,CAAC;gBAGxE,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,6BAA6B;IAevC,aAAa;IAWb,gBAAgB;IAIhB;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,EAAE,CAE3B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,WAAW,GAAG,IAAI,CAMhC;IAED;;;;OAIG;IACH,SAAS;IAIT;;;;OAIG;IACH,aAAa;IAIb;;OAEG;IACH,UAAU;IAIV;;OAEG;IACH,SAAS;IAIT;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe;IAUnD;;;OAGG;IACH,KAAK;CAyKL"}

package/dist/controllers/focus-manager/index.d.ts

@@ -0,0 +1,3 @@
+export { FocusManagerController } from './focus-manager.controller';
+export type { PositionalFocus, FocusManagerControllerHost, FocusManagerControllerOptions, } from './focus-manager.controller';
+//# sourceMappingURL=index.d.ts.map

package/dist/controllers/focus-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controllers/focus-manager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACX,eAAe,EACf,0BAA0B,EAC1B,6BAA6B,GAC7B,MAAM,4BAA4B,CAAC"}

package/dist/controllers/keyboard-support/index.d.ts

@@ -0,0 +1,2 @@
+export { KeyboardSupportController, getShortcutKey, } from './keyboard-support.controller';
+//# sourceMappingURL=index.d.ts.map

package/dist/controllers/keyboard-support/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/controllers/keyboard-support/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,yBAAyB,EACzB,cAAc,GACd,MAAM,+BAA+B,CAAC"}

package/dist/controllers/keyboard-support/keyboard-support.controller.d.ts

@@ -0,0 +1,55 @@
+import type { LitElement, ReactiveControllerHost, ReactiveController } from 'lit';
+export type KeyboardSupportControllerHost = ReactiveControllerHost & LitElement;
+export type Shortcut = {
+    /**
+     * key identifier for the pressed key
+     */
+    key: string;
+    /**
+     * is the meta (Command for Mac, Windows for MS Windows) key pressed?
+     */
+    meta?: boolean;
+    /**
+     * is the shift key pressed?
+     */
+    shift?: boolean;
+    /**
+     * is the ctrl key pressed?
+     */
+    ctrl?: boolean;
+    /**
+     * is the alt key pressed?
+     */
+    alt?: boolean;
+};
+export type ShortcutHandler = (event: KeyboardEvent) => void;
+export type Keymap = {
+    shortcut: Shortcut | Shortcut[];
+    handler: ShortcutHandler;
+};
+export type KeyboardSupportControllerOptions = {
+    getEventTarget: (host: KeyboardSupportControllerHost) => HTMLElement;
+};
+export declare function getShortcutKey(shortcut: Shortcut): string;
+/**
+ * Enable a component to implement behavior based on shortcuts.
+ */
+export declare class KeyboardSupportController implements ReactiveController {
+    #private;
+    host: KeyboardSupportControllerHost;
+    keymap: Map<string, ShortcutHandler>;
+    /**
+     * Get the element to which the keyboard event listener should be attached.
+     * This can be useful when you want to prevent [retargetting](https://lit.dev/docs/components/events/#shadowdom), which
+     * happens for events fired from the component's shadow DOM.
+     *
+     * By default, the target element will be the `host` element.
+     *
+     * @see {@link https://lit.dev/docs/components/events/#adding-event-listeners-to-the-component-or-its-shadow-root Lit, Adding event listeners to the component or its shadow root}
+     */
+    getEventTarget: KeyboardSupportControllerOptions['getEventTarget'];
+    constructor(host: KeyboardSupportControllerHost, keymap: Keymap | Keymap[], options?: KeyboardSupportControllerOptions | null);
+    hostConnected(): Promise<void>;
+    hostDisconnected(): void;
+}
+//# sourceMappingURL=keyboard-support.controller.d.ts.map

package/dist/controllers/keyboard-support/keyboard-support.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-support.controller.d.ts","sourceRoot":"","sources":["../../../src/controllers/keyboard-support/keyboard-support.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,sBAAsB,EACtB,kBAAkB,EAClB,MAAM,KAAK,CAAC;AAGb,MAAM,MAAM,6BAA6B,GAAG,sBAAsB,GAAG,UAAU,CAAC;AAEhF,MAAM,MAAM,QAAQ,GAAG;IACtB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE7D,MAAM,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAChC,OAAO,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC9C,cAAc,EAAE,CAAC,IAAI,EAAE,6BAA6B,KAAK,WAAW,CAAC;CACrE,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAUzD;AAED;;GAEG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;;IACnE,IAAI,EAAE,6BAA6B,CAAC;IAEpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAa;IAEjD;;;;;;;;OAQG;IACH,cAAc,EAAE,gCAAgC,CAAC,gBAAgB,CAAC,CAAC;gBAGlE,IAAI,EAAE,6BAA6B,EACnC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,OAAO,CAAC,EAAE,gCAAgC,GAAG,IAAI;IAgB5C,aAAa;IAInB,gBAAgB;CAwBhB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@loadsmart/miranda-wc",
-	"version": "1.48.1",
+	"version": "1.50.0",
 	"description": "Miranda Web Components component library",
 	"main": "dist/index.js",
 	"type": "module",