igniteui-webcomponents 7.2.4 → 7.3.0-beta.1

package/internals/controllers/aria-projection.d.ts

@@ -0,0 +1,144 @@
+import { type LitElement, type ReactiveController, type ReactiveControllerHost } from 'lit';
+import { Directive, type DirectiveParameters, type ElementPart, type PartInfo } from 'lit/directive.js';
+type ControllerHost = ReactiveControllerHost & LitElement;
+/**
+ * ARIA semantics a composite host projects onto the native editor of an
+ * input-shaped component.
+ *
+ * The host cannot publish these itself: it delegates focus, so the native
+ * editor inside the input component's shadow root is what assistive technology
+ * lands on and reports. All relations travel as element references - an IDREF
+ * cannot cross a shadow boundary, while ARIA element reflection resolves into
+ * ancestor tree scopes.
+ */
+export type ProjectedARIA = {
+    role?: string;
+    hasPopup?: string;
+    expanded?: string;
+    disabled?: string;
+    label?: string;
+    controls?: ReadonlyArray<Element> | null;
+    describedBy?: ReadonlyArray<Element> | null;
+    labelledBy?: ReadonlyArray<Element> | null;
+    activeDescendant?: Element | null;
+};
+/** Configuration for the {@link AriaTargetController}. */
+type AriaTargetConfig = {
+    /** Resolves the component's own `ElementInternals` labels. */
+    labels: () => ReadonlyArray<Element> | null;
+    /**
+     * Resolves the component's own description element (its helper-text
+     * container), or `null` when it currently renders no description content.
+     */
+    description: () => Element | null;
+};
+/**
+ * Binding values for a native editor element, resolved from the projected
+ * state merged with the editor's own ARIA. Applied onto the editor with the
+ * {@link ariaBindings} directive: scalars bind as attributes, relations bind
+ * through the ARIA element-reflection properties.
+ */
+export type ResolvedARIABindings = {
+    role?: string;
+    hasPopup?: string;
+    expanded?: string;
+    disabled?: string;
+    label?: string;
+    /**
+     * Same-root IDREF for the editor's own description, applied while no
+     * description is projected. Unlike element reflection, a content attribute
+     * stays visible to tooling that only reads attributes (e.g. axe).
+     */
+    describedByRef?: string;
+    labelledBy: ReadonlyArray<Element> | null;
+    controls: ReadonlyArray<Element> | null;
+    describedBy: ReadonlyArray<Element> | null;
+    activeDescendant: Element | null;
+};
+/**
+ * The receiving end of an ARIA projection, added by every input-shaped
+ * component. Holds the state a composite host currently projects and resolves
+ * it against the component's own ARIA when the native editor is rendered.
+ *
+ * Not a reactive controller - it needs no lifecycle hooks, only a render
+ * scheduled on the host when the projected state changes.
+ */
+declare class AriaTargetController {
+    private readonly _host;
+    private readonly _config;
+    private _projected;
+    constructor(host: ControllerHost, config: AriaTargetConfig);
+    /**
+     * Replaces the projected state, scheduling a host render only when it
+     * actually changed so projecting on every host update stays cheap.
+     */
+    setProjected(state: ProjectedARIA): void;
+    /**
+     * Mirrors the projected `role`/`hasPopup` as `data-role`/`data-haspopup`
+     * attributes on the component itself. The input themes style anchors of
+     * composite widgets differently and key off these; the ARIA itself lives on
+     * the native editor inside the shadow root, where `:host()` selectors
+     * cannot observe it.
+     */
+    private _reflectStylingHooks;
+    /**
+     * Resolves the binding values for the native editor element by merging the
+     * projected state with the editor's own ARIA.
+     *
+     * Projected labels take precedence over the component's own. The editor's
+     * description stays a same-root IDREF ({@link ResolvedARIABindings.describedByRef})
+     * while nothing is projected; once a host projects a description, the whole
+     * relation switches to element references - attribute and reflection cannot
+     * coexist - with the editor's own description element joining the projected
+     * ones.
+     */
+    resolveBindings(): ResolvedARIABindings;
+}
+/**
+ * Applies {@link ResolvedARIABindings} onto the native editor element -
+ * relations on every render, scalar attributes only when they changed.
+ */
+declare class AriaBindingsDirective extends Directive {
+    private _previous?;
+    constructor(partInfo: PartInfo);
+    render(_: ResolvedARIABindings): unknown;
+    update(part: ElementPart, [bindings]: DirectiveParameters<this>): unknown;
+}
+/**
+ * Binds resolved ARIA state onto a native editor element as a single element
+ * expression, e.g. `<input ${ariaBindings(aria)} />`.
+ */
+export declare const ariaBindings: (_: ResolvedARIABindings) => import("lit-html/directive.js").DirectiveResult<typeof AriaBindingsDirective>;
+/** Configuration for the {@link AriaProjectorController}. */
+type AriaProjectorConfig = {
+    /** Resolves the input-shaped component the ARIA state is projected onto. */
+    target: () => Element | null | undefined;
+    /** Computes the ARIA state to project. Invoked after every host update. */
+    state: () => ProjectedARIA;
+};
+/**
+ * The sending end of an ARIA projection, added by composite hosts
+ * (e.g. `igc-select`). After every host update it pushes the computed ARIA
+ * state onto the target component's {@link AriaTargetController}.
+ */
+declare class AriaProjectorController implements ReactiveController {
+    private readonly _host;
+    private readonly _config;
+    private _retryScheduled;
+    constructor(host: ControllerHost, config: AriaProjectorConfig);
+    /** @internal */
+    hostUpdated(): void;
+}
+/**
+ * Creates and adds an {@link AriaTargetController} to an input-shaped
+ * component, making its native editor a valid target for
+ * {@link addAriaProjector} - the editor is what assistive technology lands on
+ * and reports once the component's host delegates focus to it.
+ */
+export declare function addAriaTarget(host: ControllerHost, config: AriaTargetConfig): AriaTargetController;
+/**
+ * Creates and adds an {@link AriaProjectorController} to a composite host,
+ * projecting ARIA semantics onto the native editor of the target component.
+ */
+export declare function addAriaProjector(host: ControllerHost, config: AriaProjectorConfig): AriaProjectorController;
+export type { AriaProjectorController, AriaTargetController };

package/internals/controllers/aria-projection.js

@@ -0,0 +1,138 @@
+import { noChange, } from 'lit';
+import { Directive, directive, PartType, } from 'lit/directive.js';
+const targets = new WeakMap();
+function elementsEqual(a, b) {
+    if (a == null || b == null) {
+        return a == null && b == null;
+    }
+    return a.length === b.length && a.every((element, i) => element === b[i]);
+}
+function projectionsEqual(a, b) {
+    return (a.role === b.role &&
+        a.hasPopup === b.hasPopup &&
+        a.expanded === b.expanded &&
+        a.disabled === b.disabled &&
+        a.label === b.label &&
+        (a.activeDescendant ?? null) === (b.activeDescendant ?? null) &&
+        elementsEqual(a.controls, b.controls) &&
+        elementsEqual(a.describedBy, b.describedBy) &&
+        elementsEqual(a.labelledBy, b.labelledBy));
+}
+class AriaTargetController {
+    constructor(host, config) {
+        this._projected = {};
+        this._host = host;
+        this._config = config;
+        targets.set(host, this);
+    }
+    setProjected(state) {
+        if (!projectionsEqual(this._projected, state)) {
+            this._projected = state;
+            this._reflectStylingHooks();
+            this._host.requestUpdate();
+        }
+    }
+    _reflectStylingHooks() {
+        const host = this._host;
+        const { role, hasPopup } = this._projected;
+        role
+            ? host.setAttribute('data-role', role)
+            : host.removeAttribute('data-role');
+        hasPopup
+            ? host.setAttribute('data-haspopup', hasPopup)
+            : host.removeAttribute('data-haspopup');
+    }
+    resolveBindings() {
+        const projected = this._projected;
+        const description = this._config.description();
+        return {
+            role: projected.role,
+            hasPopup: projected.hasPopup,
+            expanded: projected.expanded,
+            disabled: projected.disabled,
+            label: projected.label,
+            labelledBy: projected.labelledBy ?? this._config.labels(),
+            controls: projected.controls ?? null,
+            describedBy: projected.describedBy
+                ? description
+                    ? [description, ...projected.describedBy]
+                    : projected.describedBy
+                : null,
+            describedByRef: projected.describedBy
+                ? undefined
+                : description?.id || undefined,
+            activeDescendant: projected.activeDescendant ?? null,
+        };
+    }
+}
+const scalarBindings = [
+    ['role', 'role'],
+    ['hasPopup', 'aria-haspopup'],
+    ['expanded', 'aria-expanded'],
+    ['disabled', 'aria-disabled'],
+    ['label', 'aria-label'],
+    ['describedByRef', 'aria-describedby'],
+];
+class AriaBindingsDirective extends Directive {
+    constructor(partInfo) {
+        super(partInfo);
+        if (partInfo.type !== PartType.ELEMENT) {
+            throw new Error('`ariaBindings()` can only be used as an element expression.');
+        }
+    }
+    render(_) {
+        return noChange;
+    }
+    update(part, [bindings]) {
+        const element = part.element;
+        const previous = this._previous;
+        this._previous = bindings;
+        element.ariaLabelledByElements = bindings.labelledBy;
+        element.ariaControlsElements = bindings.controls;
+        element.ariaDescribedByElements = bindings.describedBy;
+        element.ariaActiveDescendantElement = bindings.activeDescendant;
+        for (const [key, attribute] of scalarBindings) {
+            const value = bindings[key];
+            if (!previous || previous[key] !== value) {
+                value != null
+                    ? element.setAttribute(attribute, value)
+                    : element.removeAttribute(attribute);
+            }
+        }
+        return noChange;
+    }
+}
+export const ariaBindings = directive(AriaBindingsDirective);
+class AriaProjectorController {
+    constructor(host, config) {
+        this._retryScheduled = false;
+        this._host = host;
+        this._config = config;
+        host.addController(this);
+    }
+    hostUpdated() {
+        const element = this._config.target();
+        if (!element) {
+            return;
+        }
+        const target = targets.get(element);
+        if (target) {
+            target.setProjected(this._config.state());
+            return;
+        }
+        if (!this._retryScheduled) {
+            this._retryScheduled = true;
+            customElements.whenDefined(element.localName).then(() => {
+                this._retryScheduled = false;
+                this._host.requestUpdate();
+            });
+        }
+    }
+}
+export function addAriaTarget(host, config) {
+    return new AriaTargetController(host, config);
+}
+export function addAriaProjector(host, config) {
+    return new AriaProjectorController(host, config);
+}
+//# sourceMappingURL=aria-projection.js.map

package/internals/controllers/aria-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-projection.js","sourceRoot":"","sources":["../../../src/internals/controllers/aria-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type LitElement,\n  noChange,\n  type ReactiveController,\n  type ReactiveControllerHost,\n} from 'lit';\nimport {\n  Directive,\n  type DirectiveParameters,\n  directive,\n  type ElementPart,\n  type PartInfo,\n  PartType,\n} from 'lit/directive.js';\n\ntype ControllerHost = ReactiveControllerHost & LitElement;\n\n/**\n * ARIA semantics a composite host projects onto the native editor of an\n * input-shaped component.\n *\n * The host cannot publish these itself: it delegates focus, so the native\n * editor inside the input component's shadow root is what assistive technology\n * lands on and reports. All relations travel as element references - an IDREF\n * cannot cross a shadow boundary, while ARIA element reflection resolves into\n * ancestor tree scopes.\n */\nexport type ProjectedARIA = {\n  role?: string;\n  hasPopup?: string;\n  expanded?: string;\n  disabled?: string;\n  label?: string;\n  controls?: ReadonlyArray<Element> | null;\n  describedBy?: ReadonlyArray<Element> | null;\n  labelledBy?: ReadonlyArray<Element> | null;\n  activeDescendant?: Element | null;\n};\n\n/** Configuration for the {@link AriaTargetController}. */\ntype AriaTargetConfig = {\n  /** Resolves the component's own `ElementInternals` labels. */\n  labels: () => ReadonlyArray<Element> | null;\n  /**\n   * Resolves the component's own description element (its helper-text\n   * container), or `null` when it currently renders no description content.\n   */\n  description: () => Element | null;\n};\n\n/**\n * Binding values for a native editor element, resolved from the projected\n * state merged with the editor's own ARIA. Applied onto the editor with the\n * {@link ariaBindings} directive: scalars bind as attributes, relations bind\n * through the ARIA element-reflection properties.\n */\nexport type ResolvedARIABindings = {\n  role?: string;\n  hasPopup?: string;\n  expanded?: string;\n  disabled?: string;\n  label?: string;\n  /**\n   * Same-root IDREF for the editor's own description, applied while no\n   * description is projected. Unlike element reflection, a content attribute\n   * stays visible to tooling that only reads attributes (e.g. axe).\n   */\n  describedByRef?: string;\n  labelledBy: ReadonlyArray<Element> | null;\n  controls: ReadonlyArray<Element> | null;\n  describedBy: ReadonlyArray<Element> | null;\n  activeDescendant: Element | null;\n};\n\n/**\n * Internal registry resolving an input-shaped component to its ARIA target\n * controller, so composite hosts can project state without the component\n * exposing a public member for it.\n */\nconst targets = new WeakMap<Element, AriaTargetController>();\n\nfunction elementsEqual(\n  a: ReadonlyArray<Element> | null | undefined,\n  b: ReadonlyArray<Element> | null | undefined\n): boolean {\n  if (a == null || b == null) {\n    return a == null && b == null;\n  }\n\n  return a.length === b.length && a.every((element, i) => element === b[i]);\n}\n\nfunction projectionsEqual(a: ProjectedARIA, b: ProjectedARIA): boolean {\n  return (\n    a.role === b.role &&\n    a.hasPopup === b.hasPopup &&\n    a.expanded === b.expanded &&\n    a.disabled === b.disabled &&\n    a.label === b.label &&\n    (a.activeDescendant ?? null) === (b.activeDescendant ?? null) &&\n    elementsEqual(a.controls, b.controls) &&\n    elementsEqual(a.describedBy, b.describedBy) &&\n    elementsEqual(a.labelledBy, b.labelledBy)\n  );\n}\n\n/**\n * The receiving end of an ARIA projection, added by every input-shaped\n * component. Holds the state a composite host currently projects and resolves\n * it against the component's own ARIA when the native editor is rendered.\n *\n * Not a reactive controller - it needs no lifecycle hooks, only a render\n * scheduled on the host when the projected state changes.\n */\nclass AriaTargetController {\n  private readonly _host: ControllerHost;\n  private readonly _config: AriaTargetConfig;\n  private _projected: ProjectedARIA = {};\n\n  constructor(host: ControllerHost, config: AriaTargetConfig) {\n    this._host = host;\n    this._config = config;\n    targets.set(host, this);\n  }\n\n  /**\n   * Replaces the projected state, scheduling a host render only when it\n   * actually changed so projecting on every host update stays cheap.\n   */\n  public setProjected(state: ProjectedARIA): void {\n    if (!projectionsEqual(this._projected, state)) {\n      this._projected = state;\n      this._reflectStylingHooks();\n      this._host.requestUpdate();\n    }\n  }\n\n  /**\n   * Mirrors the projected `role`/`hasPopup` as `data-role`/`data-haspopup`\n   * attributes on the component itself. The input themes style anchors of\n   * composite widgets differently and key off these; the ARIA itself lives on\n   * the native editor inside the shadow root, where `:host()` selectors\n   * cannot observe it.\n   */\n  private _reflectStylingHooks(): void {\n    const host = this._host;\n    const { role, hasPopup } = this._projected;\n\n    role\n      ? host.setAttribute('data-role', role)\n      : host.removeAttribute('data-role');\n    hasPopup\n      ? host.setAttribute('data-haspopup', hasPopup)\n      : host.removeAttribute('data-haspopup');\n  }\n\n  /**\n   * Resolves the binding values for the native editor element by merging the\n   * projected state with the editor's own ARIA.\n   *\n   * Projected labels take precedence over the component's own. The editor's\n   * description stays a same-root IDREF ({@link ResolvedARIABindings.describedByRef})\n   * while nothing is projected; once a host projects a description, the whole\n   * relation switches to element references - attribute and reflection cannot\n   * coexist - with the editor's own description element joining the projected\n   * ones.\n   */\n  public resolveBindings(): ResolvedARIABindings {\n    const projected = this._projected;\n    const description = this._config.description();\n\n    return {\n      role: projected.role,\n      hasPopup: projected.hasPopup,\n      expanded: projected.expanded,\n      disabled: projected.disabled,\n      label: projected.label,\n      labelledBy: projected.labelledBy ?? this._config.labels(),\n      controls: projected.controls ?? null,\n      describedBy: projected.describedBy\n        ? description\n          ? [description, ...projected.describedBy]\n          : projected.describedBy\n        : null,\n      describedByRef: projected.describedBy\n        ? undefined\n        : description?.id || undefined,\n      activeDescendant: projected.activeDescendant ?? null,\n    };\n  }\n}\n\nconst scalarBindings = [\n  ['role', 'role'],\n  ['hasPopup', 'aria-haspopup'],\n  ['expanded', 'aria-expanded'],\n  ['disabled', 'aria-disabled'],\n  ['label', 'aria-label'],\n  ['describedByRef', 'aria-describedby'],\n] as const;\n\n/**\n * Applies {@link ResolvedARIABindings} onto the native editor element -\n * relations on every render, scalar attributes only when they changed.\n */\nclass AriaBindingsDirective extends Directive {\n  private _previous?: ResolvedARIABindings;\n\n  constructor(partInfo: PartInfo) {\n    super(partInfo);\n\n    if (partInfo.type !== PartType.ELEMENT) {\n      throw new Error(\n        '`ariaBindings()` can only be used as an element expression.'\n      );\n    }\n  }\n\n  public override render(_: ResolvedARIABindings): unknown {\n    return noChange;\n  }\n\n  public override update(\n    part: ElementPart,\n    [bindings]: DirectiveParameters<this>\n  ): unknown {\n    const element = part.element;\n    const previous = this._previous;\n    this._previous = bindings;\n\n    // Relations are re-asserted on every render: element references assigned\n    // while the editor is detached (its first render commits inside the\n    // template fragment) are dropped by the browser, so memoizing them here\n    // would leave the associations permanently missing.\n    // Assigning them first also means the scalar pass below always observes\n    // the final state, since a reflection property detaches the corresponding\n    // content attribute.\n    element.ariaLabelledByElements = bindings.labelledBy;\n    element.ariaControlsElements = bindings.controls;\n    element.ariaDescribedByElements = bindings.describedBy;\n    element.ariaActiveDescendantElement = bindings.activeDescendant;\n\n    for (const [key, attribute] of scalarBindings) {\n      const value = bindings[key];\n\n      if (!previous || previous[key] !== value) {\n        value != null\n          ? element.setAttribute(attribute, value)\n          : element.removeAttribute(attribute);\n      }\n    }\n\n    return noChange;\n  }\n}\n\n/**\n * Binds resolved ARIA state onto a native editor element as a single element\n * expression, e.g. `<input ${ariaBindings(aria)} />`.\n */\nexport const ariaBindings = directive(AriaBindingsDirective);\n\n/** Configuration for the {@link AriaProjectorController}. */\ntype AriaProjectorConfig = {\n  /** Resolves the input-shaped component the ARIA state is projected onto. */\n  target: () => Element | null | undefined;\n  /** Computes the ARIA state to project. Invoked after every host update. */\n  state: () => ProjectedARIA;\n};\n\n/**\n * The sending end of an ARIA projection, added by composite hosts\n * (e.g. `igc-select`). After every host update it pushes the computed ARIA\n * state onto the target component's {@link AriaTargetController}.\n */\nclass AriaProjectorController implements ReactiveController {\n  private readonly _host: ControllerHost;\n  private readonly _config: AriaProjectorConfig;\n  private _retryScheduled = false;\n\n  constructor(host: ControllerHost, config: AriaProjectorConfig) {\n    this._host = host;\n    this._config = config;\n    host.addController(this);\n  }\n\n  /** @internal */\n  public hostUpdated(): void {\n    const element = this._config.target();\n\n    if (!element) {\n      return;\n    }\n\n    const target = targets.get(element);\n\n    if (target) {\n      target.setProjected(this._config.state());\n      return;\n    }\n\n    // The target exists but has no controller yet - it is not upgraded on the\n    // host's first render when definitions register late. Re-project once its\n    // definition resolves.\n    if (!this._retryScheduled) {\n      this._retryScheduled = true;\n\n      customElements.whenDefined(element.localName).then(() => {\n        this._retryScheduled = false;\n        this._host.requestUpdate();\n      });\n    }\n  }\n}\n\n/**\n * Creates and adds an {@link AriaTargetController} to an input-shaped\n * component, making its native editor a valid target for\n * {@link addAriaProjector} - the editor is what assistive technology lands on\n * and reports once the component's host delegates focus to it.\n */\nexport function addAriaTarget(\n  host: ControllerHost,\n  config: AriaTargetConfig\n): AriaTargetController {\n  return new AriaTargetController(host, config);\n}\n\n/**\n * Creates and adds an {@link AriaProjectorController} to a composite host,\n * projecting ARIA semantics onto the native editor of the target component.\n */\nexport function addAriaProjector(\n  host: ControllerHost,\n  config: AriaProjectorConfig\n): AriaProjectorController {\n  return new AriaProjectorController(host, config);\n}\n\nexport type { AriaProjectorController, AriaTargetController };\n"]}

package/{components/common → internals}/controllers/async-consumer.js

@@ -9,14 +9,15 @@ export class AsyncContextConsumer {
         return this._consumer?.value;
     }
     async hostConnected() {
-        await this._host.updateComplete;
-        if (!this._consumer) {
-            this._consumer = new ContextConsumer(this._host, {
-                context: this._options.context,
-                callback: this._options.callback,
-                subscribe: this._options.subscribe,
-            });
+        if (this._consumer) {
+            return;
         }
+        await this._host.updateComplete;
+        this._consumer ??= new ContextConsumer(this._host, {
+            context: this._options.context,
+            callback: this._options.callback,
+            subscribe: this._options.subscribe,
+        });
     }
 }
 export function createAsyncContext(host, context, callback) {

package/internals/controllers/async-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-consumer.js","sourceRoot":"","sources":["../../../src/internals/controllers/async-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,EAAoB,MAAM,cAAc,CAAC;AAc/E,MAAM,OAAO,oBAAoB;IAQ/B,YAAY,IAAU,EAAE,OAA+B;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;IAC/B,CAAC;IAKM,KAAK,CAAC,aAAa;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;QAEhC,IAAI,CAAC,SAAS,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE;YACjD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAChC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;SACnC,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAIhC,IAAU,EACV,OAAU,EACV,QAAgE;IAEhE,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE;QACpC,OAAO;QACP,QAAQ;QACR,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { type Context, ContextConsumer, type ContextType } from '@lit/context';\nimport type {\n  LitElement,\n  ReactiveController,\n  ReactiveControllerHost,\n} from 'lit';\n\ntype AsyncContextOptions<T extends Context<unknown, unknown>> = {\n  context: T;\n  callback?: (value: ContextType<T>, dispose?: () => void) => void;\n  subscribe?: boolean;\n};\n\n/* blazorSuppress */\nexport class AsyncContextConsumer<\n  T extends Context<unknown, unknown>,\n  Host extends ReactiveControllerHost & HTMLElement,\n> implements ReactiveController {\n  protected _host: Host;\n  protected _options: AsyncContextOptions<T>;\n  protected _consumer?: ContextConsumer<T, Host>;\n\n  constructor(host: Host, options: AsyncContextOptions<T>) {\n    this._host = host;\n    this._options = options;\n\n    this._host.addController(this);\n  }\n\n  public get value(): ContextType<T> | undefined {\n    return this._consumer?.value;\n  }\n\n  // If there is already an instance of a consumer (because of an attach/detach cycle),\n  // skip creating a new instance for this host - checked both before and after the\n  // await, since a reconnect can land in between.\n  public async hostConnected(): Promise<void> {\n    if (this._consumer) {\n      return;\n    }\n\n    await this._host.updateComplete;\n\n    this._consumer ??= new ContextConsumer(this._host, {\n      context: this._options.context,\n      callback: this._options.callback,\n      subscribe: this._options.subscribe,\n    });\n  }\n}\n\nexport function createAsyncContext<\n  T extends Context<unknown, unknown>,\n  Host extends ReactiveControllerHost & LitElement,\n>(\n  host: Host,\n  context: T,\n  callback?: (value: ContextType<T>, dispose?: () => void) => void\n): AsyncContextConsumer<T, Host> {\n  return new AsyncContextConsumer(host, {\n    context,\n    callback,\n    subscribe: true,\n  });\n}\n"]}

package/internals/controllers/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/internals/controllers/command.ts"],"names":[],"mappings":"AA+BA,MAAM,iBAAiB;IAIrB,YAAY,IAAgB;QAFX,gBAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;QAG9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAiBM,GAAG,CAAC,OAAe,EAAE,QAAuB;QACjD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAGM,aAAa;QAClB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAGM,WAAW,CAAC,KAAY;QAC7B,MAAM,YAAY,GAAG,KAAqB,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;CACF;AAKD,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import type { LitElement, ReactiveController } from 'lit';\n\n/**\n * A Lit reactive controller that bridges the native\n * [Invoker Commands API](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API)\n * with a component's programmatic API.\n *\n * When an `igc-button` (or any element using the `command` / `commandfor`\n * attributes) invokes a command on the host, the browser dispatches a\n * `CommandEvent` on the target element. This controller listens for that\n * event and forwards it to the registered callback for the given command\n * string.\n *\n * @example\n * ```ts\n * class IgcDialogComponent extends LitElement {\n *   private readonly _commands = addCommandController(this)\n *     .set('open', this.show)\n *     .set('close', this.hide)\n *     .set('toggle-popover', this.toggle);\n * }\n * ```\n *\n * With the above setup, a button in the document can control the dialog\n * declaratively:\n *\n * ```html\n * <igc-button command=\"open\" commandfor=\"my-dialog\">Open</igc-button>\n * <igc-dialog id=\"my-dialog\"></igc-dialog>\n * ```\n */\nclass CommandController implements ReactiveController {\n  private readonly _host: LitElement;\n  private readonly _commandMap = new Map<string, () => unknown>();\n\n  constructor(host: LitElement) {\n    this._host = host;\n    host.addController(this);\n  }\n\n  /**\n   * Registers a command string and its corresponding handler callback.\n   *\n   * Returns `this` to allow chained calls:\n   * ```ts\n   * addCommandController(this)\n   *   .set('open', this.show)\n   *   .set('close', this.hide);\n   * ```\n   *\n   * @param command - The command string to listen for (e.g. `'open'`,\n   *   `'toggle-popover'`, or a custom `'--my-command'`).\n   * @param callback - The method to invoke when the command is received.\n   *   Called with the host as `this`.\n   */\n  public set(command: string, callback: () => unknown): this {\n    this._commandMap.set(command, callback);\n    return this;\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._host.addEventListener('command', this);\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._host.removeEventListener('command', this);\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    const commandEvent = event as CommandEvent;\n    this._commandMap.get(commandEvent.command)?.call(this._host);\n  }\n}\n\n/**\n * Creates a {@link CommandController} and attaches it to the given host.\n */\nexport function addCommandController(host: LitElement): CommandController {\n  return new CommandController(host);\n}\n\nexport type { CommandController };\n"]}

package/internals/controllers/context-provider.d.ts

@@ -0,0 +1,48 @@
+import { type Context, type ContextType } from '@lit/context';
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+type ProviderHost = ReactiveControllerHost & HTMLElement;
+type ContextProviderControllerOptions<C extends Context<unknown, unknown>, H extends ProviderHost> = {
+    /** The context to provide. */
+    context: C;
+    /** Computes the context value published to subscribers. */
+    value: () => ContextType<C>;
+    /**
+     * Host properties whose changes republish the context. Anything else that must
+     * republish calls {@link ContextProviderController.publish}.
+     */
+    watch?: readonly (keyof H)[];
+};
+/**
+ * Provides a context from the host and keeps subscribers current: the value
+ * is published when the host connects, republished before an update whenever
+ * one of the watched host properties has changed, and on demand via
+ * {@link ContextProviderController.publish}.
+ *
+ * Every publish notifies subscribers, also when the value keeps its identity -
+ * hosts that share one mutable context object still propagate their changes.
+ *
+ * @example
+ * ```typescript
+ * private readonly _provider = addContextProvider(this, {
+ *   context: themeContext,
+ *   watch: ['theme', 'variant'],
+ *   value: () => ({ theme: this.theme, variant: this.variant }),
+ * });
+ * ```
+ */
+declare class ContextProviderController<C extends Context<unknown, unknown>, H extends ProviderHost> implements ReactiveController {
+    private readonly _host;
+    private readonly _options;
+    private readonly _provider;
+    private readonly _snapshot;
+    constructor(host: H, options: ContextProviderControllerOptions<C, H>);
+    /** @internal */
+    hostConnected(): void;
+    /** @internal */
+    hostUpdate(): void;
+    /** Publishes the current value to the subscribers. */
+    publish(): void;
+}
+/** Creates and adds a {@link ContextProviderController} to the given host. */
+export declare function addContextProvider<C extends Context<unknown, unknown>, H extends ProviderHost>(host: H, options: ContextProviderControllerOptions<C, H>): ContextProviderController<C, H>;
+export type { ContextProviderController, ContextProviderControllerOptions };

package/internals/controllers/context-provider.js

@@ -0,0 +1,29 @@
+import { ContextProvider } from '@lit/context';
+class ContextProviderController {
+    constructor(host, options) {
+        this._snapshot = new Map();
+        this._host = host;
+        this._options = options;
+        this._provider = new ContextProvider(host, { context: options.context });
+        host.addController(this);
+    }
+    hostConnected() {
+        this.publish();
+    }
+    hostUpdate() {
+        const watched = this._options.watch;
+        if (watched?.some((key) => this._host[key] !== this._snapshot.get(key))) {
+            this.publish();
+        }
+    }
+    publish() {
+        for (const key of this._options.watch ?? []) {
+            this._snapshot.set(key, this._host[key]);
+        }
+        this._provider.setValue(this._options.value.call(this._host), true);
+    }
+}
+export function addContextProvider(host, options) {
+    return new ContextProviderController(host, options);
+}
+//# sourceMappingURL=context-provider.js.map

package/internals/controllers/context-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-provider.js","sourceRoot":"","sources":["../../../src/internals/controllers/context-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,EAAoB,MAAM,cAAc,CAAC;AAsC/E,MAAM,yBAAyB;IAS7B,YAAY,IAAO,EAAE,OAA+C;QAFnD,cAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;QAGvD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAEzE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAGM,aAAa;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAGM,UAAU;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAEpC,IAAI,OAAO,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAGM,OAAO;QACZ,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IACtE,CAAC;CACF;AAGD,MAAM,UAAU,kBAAkB,CAIhC,IAAO,EACP,OAA+C;IAE/C,OAAO,IAAI,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { type Context, ContextProvider, type ContextType } from '@lit/context';\nimport type { ReactiveController, ReactiveControllerHost } from 'lit';\n\ntype ProviderHost = ReactiveControllerHost & HTMLElement;\n\ntype ContextProviderControllerOptions<\n  C extends Context<unknown, unknown>,\n  H extends ProviderHost,\n> = {\n  /** The context to provide. */\n  context: C;\n  /** Computes the context value published to subscribers. */\n  value: () => ContextType<C>;\n  /**\n   * Host properties whose changes republish the context. Anything else that must\n   * republish calls {@link ContextProviderController.publish}.\n   */\n  watch?: readonly (keyof H)[];\n};\n\n/**\n * Provides a context from the host and keeps subscribers current: the value\n * is published when the host connects, republished before an update whenever\n * one of the watched host properties has changed, and on demand via\n * {@link ContextProviderController.publish}.\n *\n * Every publish notifies subscribers, also when the value keeps its identity -\n * hosts that share one mutable context object still propagate their changes.\n *\n * @example\n * ```typescript\n * private readonly _provider = addContextProvider(this, {\n *   context: themeContext,\n *   watch: ['theme', 'variant'],\n *   value: () => ({ theme: this.theme, variant: this.variant }),\n * });\n * ```\n */\nclass ContextProviderController<\n  C extends Context<unknown, unknown>,\n  H extends ProviderHost,\n> implements ReactiveController {\n  private readonly _host: H;\n  private readonly _options: ContextProviderControllerOptions<C, H>;\n  private readonly _provider: ContextProvider<C, H>;\n  private readonly _snapshot = new Map<keyof H, unknown>();\n\n  constructor(host: H, options: ContextProviderControllerOptions<C, H>) {\n    this._host = host;\n    this._options = options;\n    this._provider = new ContextProvider(host, { context: options.context });\n\n    host.addController(this);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this.publish();\n  }\n\n  /** @internal */\n  public hostUpdate(): void {\n    const watched = this._options.watch;\n\n    if (watched?.some((key) => this._host[key] !== this._snapshot.get(key))) {\n      this.publish();\n    }\n  }\n\n  /** Publishes the current value to the subscribers. */\n  public publish(): void {\n    for (const key of this._options.watch ?? []) {\n      this._snapshot.set(key, this._host[key]);\n    }\n\n    this._provider.setValue(this._options.value.call(this._host), true);\n  }\n}\n\n/** Creates and adds a {@link ContextProviderController} to the given host. */\nexport function addContextProvider<\n  C extends Context<unknown, unknown>,\n  H extends ProviderHost,\n>(\n  host: H,\n  options: ContextProviderControllerOptions<C, H>\n): ContextProviderController<C, H> {\n  return new ContextProviderController(host, options);\n}\n\nexport type { ContextProviderController, ContextProviderControllerOptions };\n"]}

package/{components/common → internals}/controllers/drag.js

@@ -1,6 +1,8 @@
-import { getDefaultLayer } from '../../resize-container/default-ghost.js';
+import { getDefaultLayer } from '../../components/resize-container/default-ghost.js';
 import { createAbortHandle } from '../abort-handler.js';
-import { getElementFromPath, getRoot, isLTR, roundByDPR } from '../util.js';
+import { getRoot, isLTR, roundByDPR, setStyles } from '../utils/dom.js';
+import { getElementFromPath } from '../utils/events.js';
+import { escapeKey, isKey } from './key-bindings.js';
 const additionalEvents = [
     'pointermove',
     'lostpointercapture',
@@ -133,8 +135,7 @@ class DragController {
         this.dispose();
     }
     _handleCancel(event) {
-        const key = event.key.toLowerCase();
-        if (this._hasPointerCapture && key === 'escape') {
+        if (this._hasPointerCapture && isKey(event, escapeKey)) {
             this._options.cancel?.call(this._host, this._stateParameters);
         }
     }
@@ -163,7 +164,7 @@ class DragController {
     _setDragState(enabled = true) {
         this._hasPointerCapture = enabled;
         const cssValue = enabled ? 'none' : '';
-        Object.assign(this._element.style, {
+        setStyles(this._element, {
             touchAction: cssValue,
             userSelect: cssValue,
             webkitUserSelect: cssValue,
@@ -265,13 +266,13 @@ class DragController {
 }
 function createDefaultDragGhost({ x, y, width, height }) {
     const element = document.createElement('div');
-    Object.assign(element.style, {
+    setStyles(element, {
         position: 'absolute',
         left: `${x}px`,
         top: `${y}px`,
         width: `${width}px`,
         height: `${height}px`,
-        zIndex: 1000,
+        zIndex: '1000',
         background: 'gold',
     });
     return element;

package/internals/controllers/drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.js","sourceRoot":"","sources":["../../../src/internals/controllers/drag.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  LitElement,\n  ReactiveController,\n  ReactiveControllerHost,\n} from 'lit';\nimport type { Ref } from 'lit/directives/ref.js';\n\nimport { getDefaultLayer } from '../../components/resize-container/default-ghost.js';\nimport { createAbortHandle } from '../abort-handler.js';\nimport { getRoot, isLTR, roundByDPR, setStyles } from '../utils/dom.js';\nimport { getElementFromPath } from '../utils/events.js';\nimport { escapeKey, isKey } from './key-bindings.js';\n\ntype DragCallback = (parameters: DragCallbackParameters) => unknown;\ntype DragCancelCallback = (state: DragState) => unknown;\n\nexport type DragCallbackParameters = {\n  event: PointerEvent;\n  state: DragState;\n};\n\ntype State = {\n  initial: DOMRect;\n  current: DOMRect;\n  position: { x: number; y: number };\n  offset: { x: number; y: number };\n  pointerState: {\n    previous: { x: number; y: number };\n    current: { x: number; y: number };\n    direction: Direction;\n  };\n};\n\ntype DragState = State & {\n  ghost: HTMLElement | null;\n  element: Element | null;\n};\n\ntype Direction = 'start' | 'end' | 'bottom' | 'top';\n\ntype DragControllerConfiguration = {\n  /** Whether the drag feature is enabled for the current host. */\n  enabled?: boolean;\n  /**\n   * The mode of the drag operation.\n   *\n   * Deferred will create a ghost element and keep the original element\n   * at its place until the operation completes successfully.\n   */\n  mode?: 'immediate' | 'deferred';\n  /**\n   * Whether starting a drag operation should snap the dragged item's top left corner\n   * to the cursor position.\n   */\n  snapToCursor?: boolean;\n  /**\n   * Guard function invoked during the `start` callback.\n   * Returning a truthy value will stop the current drag operation.\n   */\n  skip?: (event: PointerEvent) => boolean;\n\n  matchTarget?: (target: Element) => boolean;\n  /**\n   *\n   */\n  trigger?: () => HTMLElement;\n  /**\n   * Contain drag operations to the scope of the passed DOM element.\n   */\n  container?: Ref<HTMLElement>;\n  /**\n   * The DOM element that will \"host\" the ghost drag element when the controller\n   * is set to **deferred**.\n   *\n   * @remarks\n   * In **immediate** mode, this property is ignored.\n   */\n  layer?: () => HTMLElement;\n\n  ghost?: () => HTMLElement;\n\n  /** Callback invoked at the beginning of a drag operation. */\n  start?: DragCallback;\n  /** Callback invoked while dragging the target element.  */\n  move?: DragCallback;\n\n  enter?: DragCallback;\n\n  leave?: DragCallback;\n\n  over?: DragCallback;\n\n  /** Callback invoked during a drop operation. */\n  end?: DragCallback;\n  /** Callback invoked when a drag is cancelled */\n  cancel?: DragCancelCallback;\n};\n\nconst additionalEvents = [\n  'pointermove',\n  'lostpointercapture',\n  'contextmenu',\n] as const;\n\nclass DragController implements ReactiveController {\n  private readonly _host: ReactiveControllerHost & LitElement;\n  private readonly _options: DragControllerConfiguration = {\n    enabled: true,\n    mode: 'deferred',\n    snapToCursor: false,\n    layer: getDefaultLayer,\n  };\n\n  private readonly _abortHandle = createAbortHandle();\n\n  private _state!: State;\n\n  private _matchedElement!: Element | null;\n\n  private _id = -1;\n  private _hasPointerCapture = false;\n\n  private _ghost: HTMLElement | null = null;\n\n  /** Whether `snapToCursor` is enabled for the controller. */\n  private get _hasSnapping(): boolean {\n    return Boolean(this._options.snapToCursor);\n  }\n\n  /** Whether the current drag mode is deferred. */\n  private get _isDeferred(): boolean {\n    return this._options.mode === 'deferred';\n  }\n\n  /**\n   * The source element which will capture pointer events and initiate drag mode.\n   *\n   * @remarks\n   * By default that will be the host element itself, unless `trigger` is passed in.\n   */\n  private get _element(): HTMLElement {\n    return this._options.trigger?.() ?? this._host;\n  }\n\n  /**\n   * The element being dragged.\n   *\n   * @remarks\n   * When in **deferred** mode this returns a reference to the drag ghost element,\n   * otherwise it is the host element.\n   */\n  private get _dragItem(): HTMLElement {\n    return this._isDeferred ? this._ghost! : this._host;\n  }\n\n  /**\n   * The DOM element that will \"host\" the ghost drag element when the controller\n   * is set to **deferred**.\n   *\n   * @remarks\n   * In **immediate** mode, this property is ignored.\n   */\n  private get _layer(): HTMLElement {\n    if (!this._isDeferred) {\n      return this._host;\n    }\n\n    return this._options.layer?.() ?? this._host;\n  }\n\n  private get _stateParameters(): DragState {\n    return {\n      ...this._state,\n      ghost: this._ghost,\n      element: this._matchedElement,\n    };\n  }\n\n  constructor(\n    host: ReactiveControllerHost & LitElement,\n    options?: DragControllerConfiguration\n  ) {\n    this._host = host;\n    this._host.addController(this);\n    this.set(options);\n  }\n\n  // #region Public API\n\n  /** Whether the drag controller is enabled. */\n  public get enabled(): boolean {\n    return Boolean(this._options.enabled);\n  }\n\n  /** Updates the drag controller configuration. */\n  public set(options?: DragControllerConfiguration): void {\n    Object.assign(this._options, options);\n  }\n\n  /** Stops any drag operation and cleans up state, additional event listeners and elements. */\n  public dispose(): void {\n    this._matchedElement = null;\n    this._removeGhost();\n    this._setDragState(false);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n\n    this._host.addEventListener('dragstart', this, { signal });\n    this._host.addEventListener('touchstart', this, { passive: false, signal });\n    this._host.addEventListener('pointerdown', this, { signal });\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n    this._setDragCancelListener(false);\n    this._removeGhost();\n  }\n\n  /** @internal */\n  public handleEvent(event: PointerEvent & KeyboardEvent): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    switch (event.type) {\n      case 'touchstart':\n      case 'dragstart':\n      // Prevent contextmenu default behavior during drag\n      case 'contextmenu':\n        event.preventDefault();\n        break;\n      case 'keydown':\n        this._handleCancel(event);\n        break;\n      case 'pointerdown':\n        this._handlePointerDown(event);\n        break;\n      case 'pointermove':\n        this._handlePointerMove(event);\n        break;\n      case 'lostpointercapture':\n        this._handlePointerEnd(event);\n        break;\n    }\n  }\n\n  // #endregion\n\n  // #region Event handlers\n\n  private _handlePointerDown(event: PointerEvent): void {\n    if (this._shouldSkip(event)) {\n      return;\n    }\n\n    this._setInitialState(event);\n    this._createDragGhost();\n    this._updatePosition(event);\n\n    const parameters = {\n      event,\n      state: this._stateParameters,\n    };\n\n    if (this._options.start?.call(this._host, parameters) === false) {\n      this.dispose();\n      return;\n    }\n\n    this._assignPosition(this._dragItem);\n    this._setDragState();\n  }\n\n  private _handlePointerMove(event: PointerEvent): void {\n    if (!this._hasPointerCapture) {\n      return;\n    }\n\n    this._updatePosition(event);\n    this._updatePointerState(event);\n    this._updateMatcher(event);\n\n    const parameters = {\n      event,\n      state: this._stateParameters,\n    };\n\n    this._options.move?.call(this._host, parameters);\n\n    this._assignPosition(this._dragItem);\n  }\n\n  private _handlePointerEnd(event: PointerEvent): void {\n    this._options.end?.call(this._host, {\n      event,\n      state: this._stateParameters,\n    });\n    this.dispose();\n  }\n\n  private _handleCancel(event: KeyboardEvent): void {\n    if (this._hasPointerCapture && isKey(event, escapeKey)) {\n      // Reset state\n      this._options.cancel?.call(this._host, this._stateParameters);\n    }\n  }\n\n  // #endregion\n\n  private _setDragCancelListener(enabled = true): void {\n    enabled\n      ? globalThis.addEventListener('keydown', this)\n      : globalThis.removeEventListener('keydown', this);\n  }\n\n  private _setInitialState({\n    pointerId,\n    clientX,\n    clientY,\n  }: PointerEvent): void {\n    const rect = this._host.getBoundingClientRect();\n    const position = { x: rect.x, y: rect.y };\n    const offset = { x: rect.x - clientX, y: rect.y - clientY };\n\n    this._id = pointerId;\n    this._state = {\n      initial: rect,\n      current: structuredClone(rect),\n      position,\n      offset,\n      pointerState: {\n        previous: { x: clientX, y: clientY },\n        current: { x: clientX, y: clientY },\n        direction: 'end',\n      },\n    };\n  }\n\n  private _setDragState(enabled = true): void {\n    this._hasPointerCapture = enabled;\n    const cssValue = enabled ? 'none' : '';\n\n    setStyles(this._element, {\n      touchAction: cssValue,\n      userSelect: cssValue,\n      webkitUserSelect: cssValue,\n    });\n\n    this._toggleTextSelection(enabled);\n\n    enabled\n      ? this._element.setPointerCapture(this._id)\n      : this._element.releasePointerCapture(this._id);\n\n    this._setDragCancelListener(enabled);\n\n    // Toggle additional events\n    for (const type of additionalEvents) {\n      enabled\n        ? this._host.addEventListener(type, this)\n        : this._host.removeEventListener(type, this);\n    }\n  }\n\n  /**\n   * Toggles text selection for the duration of a drag operation.\n   *\n   * @remarks\n   * Disabling `user-select` only on the dragged element is not enough, since browsers\n   * (notably Safari) will still create a text selection in whatever elements sit under\n   * the pointer while dragging. Applying it to the owner document's body prevents that\n   * across the page for the active drag and is reverted once the operation completes.\n   */\n  private _toggleTextSelection(disabled: boolean): void {\n    const value = disabled ? 'none' : '';\n    const { style } = this._host.ownerDocument.body;\n\n    style.userSelect = value;\n    style.webkitUserSelect = value;\n\n    if (disabled) {\n      this._host.ownerDocument.getSelection()?.removeAllRanges();\n    }\n  }\n\n  private _updateMatcher(event: PointerEvent) {\n    if (!this._options.matchTarget) {\n      return;\n    }\n\n    const match = getRoot(this._host)\n      .elementsFromPoint(event.clientX, event.clientY)\n      .find((element) => this._options.matchTarget!.call(this._host, element));\n\n    if (match && !this._matchedElement) {\n      this._matchedElement = match;\n      this._options.enter?.call(this._host, {\n        event,\n        state: this._stateParameters,\n      });\n      return;\n    }\n\n    if (!match && this._matchedElement) {\n      this._options.leave?.call(this._host, {\n        event,\n        state: this._stateParameters,\n      });\n      this._matchedElement = null;\n      return;\n    }\n\n    if (match && match === this._matchedElement) {\n      this._options.over?.call(this._host, {\n        event,\n        state: this._stateParameters,\n      });\n    }\n  }\n\n  private _updatePosition({ clientX, clientY }: PointerEvent): void {\n    const { x, y } = this._state.offset;\n    const { x: layerX, y: layerY } = this._isDeferred\n      ? this._layer.getBoundingClientRect()\n      : this._state.initial;\n\n    const posX = this._hasSnapping ? clientX - layerX : clientX - layerX + x;\n    const posY = this._hasSnapping ? clientY - layerY : clientY - layerY + y;\n\n    this._state.position = { x: posX, y: posY };\n  }\n\n  private _updatePointerState({ clientX, clientY }: PointerEvent): void {\n    const state = this._state.pointerState;\n\n    state.previous = { ...state.current };\n    state.current = { x: clientX, y: clientY };\n\n    const dx = state.current.x - state.previous.x;\n    const dy = state.current.y - state.previous.y;\n\n    if (Math.abs(dx) >= Math.abs(dy)) {\n      const swapHorizontal = isLTR(this._host) ? dx >= 0 : dx <= 0;\n      state.direction = swapHorizontal ? 'end' : 'start';\n    } else {\n      state.direction = dy >= 0 ? 'bottom' : 'top';\n    }\n  }\n\n  private _assignPosition(element: HTMLElement): void {\n    element.style.transform = `translate3d(${roundByDPR(this._state.position.x)}px,${roundByDPR(this._state.position.y)}px,0)`;\n  }\n\n  private _createDragGhost(): void {\n    if (!this._isDeferred) {\n      return;\n    }\n\n    this._ghost =\n      this._options.ghost?.call(this._host) ??\n      createDefaultDragGhost(this._host.getBoundingClientRect());\n\n    this._layer.append(this._ghost);\n  }\n\n  private _removeGhost(): void {\n    this._ghost?.remove();\n    this._ghost = null;\n  }\n\n  private _shouldSkip(event: PointerEvent): boolean {\n    return (\n      Boolean(event.button) ||\n      this._options.skip?.call(this._host, event) ||\n      !getElementFromPath((e) => e === this._element, event)\n    );\n  }\n}\n\nfunction createDefaultDragGhost({ x, y, width, height }: DOMRect): HTMLElement {\n  const element = document.createElement('div');\n\n  setStyles(element, {\n    position: 'absolute',\n    left: `${x}px`,\n    top: `${y}px`,\n    width: `${width}px`,\n    height: `${height}px`,\n    zIndex: '1000',\n    background: 'gold',\n  });\n\n  return element;\n}\n\n/**\n * Adds a drag and drop controller to the given host\n */\nexport function addDragController(\n  host: ReactiveControllerHost & LitElement,\n  options?: DragControllerConfiguration\n): DragController {\n  return new DragController(host, options);\n}\n"]}

package/{components/common → internals}/controllers/focus-ring.js

@@ -20,8 +20,11 @@ class KeyboardFocusRingController {
         this._abortHandle.abort();
     }
     handleEvent(event) {
-        this._isKeyboardFocused = event.type === 'keyup';
-        this._host.requestUpdate();
+        const focused = event.type === 'keyup';
+        if (focused !== this._isKeyboardFocused) {
+            this._isKeyboardFocused = focused;
+            this._host.requestUpdate();
+        }
     }
 }
 export function addKeyboardFocusRing(host) {

package/internals/controllers/focus-ring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-ring.js","sourceRoot":"","sources":["../../../src/internals/controllers/focus-ring.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAmBxD,MAAM,2BAA2B;aACP,YAAO,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAU,AAA9C,CAA+C;IAS9E,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,YAAY,IAA0C;QAVrC,iBAAY,GAAG,iBAAiB,EAAE,CAAC;QAC5C,uBAAkB,GAAG,KAAK,CAAC;QAUjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAGM,aAAa;QAClB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;QAErC,KAAK,MAAM,KAAK,IAAI,2BAA2B,CAAC,OAAO,EAAE,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAGM,WAAW,CAAC,KAAY;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;QAEvC,IAAI,OAAO,KAAK,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxC,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;;AAWH,MAAM,UAAU,oBAAoB,CAClC,IAA0C;IAE1C,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport { createAbortHandle } from '../abort-handler.js';\n\n/**\n * A controller class which determines whether a focus ring should be shown to indicate keyboard focus.\n * Focus rings are visible only when the user is interacting with a keyboard, not with a mouse, touch, or other input methods.\n *\n * By default the class attaches a keyup event handler on the component host and will update its keyboard focus\n * state based on it.\n *\n * **Important Note:** This controller is designed for use with **atomic web components** that represent single,\n * interactive elements (e.g., buttons, form fields, interactive icons). It helps these components correctly\n * display a focus indicator *only* when keyboard navigation is occurring, improving accessibility without\n * visual clutter during mouse or touch interactions.\n *\n * **Do not use this controller as a general-purpose shortcut for managing focus state in complex components or layouts.**\n * Misusing it in this way can lead to incorrect focus ring behavior, accessibility issues, and make your\n * application harder to maintain. For managing focus within larger, composite components, consider alternative\n * strategies like ARIA attributes, managing `tabindex`, or a bespoke implementation if needed.\n */\nclass KeyboardFocusRingController implements ReactiveController {\n  private static readonly _events = ['keyup', 'focusout', 'pointerup'] as const;\n\n  private readonly _host: ReactiveControllerHost & HTMLElement;\n  private readonly _abortHandle = createAbortHandle();\n  private _isKeyboardFocused = false;\n\n  /**\n   * Gets whether the current focus state is activated through a keyboard interaction.\n   */\n  public get focused(): boolean {\n    return this._isKeyboardFocused;\n  }\n\n  constructor(host: ReactiveControllerHost & HTMLElement) {\n    this._host = host;\n    host.addController(this);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n\n    for (const event of KeyboardFocusRingController._events) {\n      this._host.addEventListener(event, this, { passive: true, signal });\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    const focused = event.type === 'keyup';\n\n    if (focused !== this._isKeyboardFocused) {\n      this._isKeyboardFocused = focused;\n      this._host.requestUpdate();\n    }\n  }\n}\n\nexport type { KeyboardFocusRingController };\n\n/**\n * Adds a {@link KeyboardFocusRingController} responsible for managing keyboard focus state.\n *\n * This utility function is intended for use with **atomic web components** that require\n * dynamic focus ring visibility based on keyboard interaction.\n */\nexport function addKeyboardFocusRing(\n  host: ReactiveControllerHost & HTMLElement\n): KeyboardFocusRingController {\n  return new KeyboardFocusRingController(host);\n}\n"]}

package/{components/common → internals}/controllers/fullscreen.js

@@ -15,11 +15,14 @@ class FullscreenController {
             return;
         }
         this._fullscreen = fullscreen;
-        if (this._fullscreen) {
-            this._host.requestFullscreen();
+        if (fullscreen) {
+            this._host.requestFullscreen().catch(() => {
+                this._fullscreen = false;
+                this._host.requestUpdate();
+            });
         }
         else if (document.fullscreenElement) {
-            document.exitFullscreen();
+            document.exitFullscreen().catch(() => { });
         }
     }
     handleEvent() {

package/internals/controllers/fullscreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.js","sourceRoot":"","sources":["../../../src/internals/controllers/fullscreen.ts"],"names":[],"mappings":"AAwBA,MAAM,oBAAoB;IAMxB,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,YACE,IAA0C,EAC1C,OAA2C;QAVrC,aAAQ,GAAsC,EAAE,CAAC;QAEjD,gBAAW,GAAG,KAAK,CAAC;QAU1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAMM,QAAQ,CAAC,UAAmB;QACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAEvE,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAE9B,IAAI,UAAU,EAAE,CAAC;YAGf,IAAI,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;gBACxC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACtC,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAGM,WAAW;QAChB,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAGM,aAAa;QAClB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CACrC,IAA0C,EAC1C,OAA2C;IAE3C,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\n\n/**\n * Callback invoked when the host element is about to enter/leave fullscreen mode.\n *\n * The callback is passed the current fullscreen `state`.\n * Returning a falsy value from the callback will stop the current fullscreen state change.\n */\ntype FullscreenControllerCallback = (state: boolean) => boolean;\n\n/** Configuration object for the fullscreen controller. */\ntype FullscreenControllerConfiguration = {\n  /**\n   * Invoked when the host element is entering fullscreen mode.\n   * See the {@link FullscreenControllerCallback} for details.\n   */\n  enter?: FullscreenControllerCallback;\n  /**\n   * Invoked when the host element is leaving fullscreen mode.\n   * See the {@link FullscreenControllerCallback} for details.\n   */\n  exit?: FullscreenControllerCallback;\n};\n\nclass FullscreenController implements ReactiveController {\n  private _host: ReactiveControllerHost & HTMLElement;\n  private _options: FullscreenControllerConfiguration = {};\n\n  private _fullscreen = false;\n\n  public get fullscreen(): boolean {\n    return this._fullscreen;\n  }\n\n  constructor(\n    host: ReactiveControllerHost & HTMLElement,\n    options?: FullscreenControllerConfiguration\n  ) {\n    this._host = host;\n    Object.assign(this._options, options);\n    host.addController(this);\n  }\n\n  /**\n   * Transitions the host element to/from fullscreen mode.\n   * This method **will invoke** enter/exit callbacks if present.\n   */\n  public setState(fullscreen: boolean): void {\n    const callback = fullscreen ? this._options.enter : this._options.exit;\n\n    if (callback && !callback.call(this._host, fullscreen)) {\n      return;\n    }\n\n    this._fullscreen = fullscreen;\n\n    if (fullscreen) {\n      // Rejects when the request is not user activated or the element is not\n      // allowed to go fullscreen - roll the state back so the host re-renders.\n      this._host.requestFullscreen().catch(() => {\n        this._fullscreen = false;\n        this._host.requestUpdate();\n      });\n    } else if (document.fullscreenElement) {\n      document.exitFullscreen().catch(() => {});\n    }\n  }\n\n  /** @internal */\n  public handleEvent(): void {\n    if (!document.fullscreenElement && this._fullscreen) {\n      this.setState(false);\n    }\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._host.addEventListener('fullscreenchange', this);\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._host.removeEventListener('fullscreenchange', this);\n  }\n}\n\nexport function addFullscreenController(\n  host: ReactiveControllerHost & HTMLElement,\n  options?: FullscreenControllerConfiguration\n): FullscreenController {\n  return new FullscreenController(host, options);\n}\n"]}

package/{components/common → internals}/controllers/gestures.d.ts

@@ -2,7 +2,7 @@ import type { ReactiveController, ReactiveControllerHost } from 'lit';
 import type { Ref } from 'lit/directives/ref.js';
 /**
  * Configuration object for a {@link GesturesController} instance.
- * @ignore
+ * @hidden
  */
 export interface GesturesOptions {
     /**