igniteui-webcomponents 7.2.4 → 7.3.0-beta.0

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/{components/common → internals}/controllers/drag.js

@@ -1,6 +1,7 @@
-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 } from '../utils/dom.js';
+import { getElementFromPath } from '../utils/events.js';
 const additionalEvents = [
     'pointermove',
     'lostpointercapture',

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 } from '../utils/dom.js';\nimport { getElementFromPath } from '../utils/events.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    const key = event.key.toLowerCase();\n\n    if (this._hasPointerCapture && key === 'escape') {\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    Object.assign(this._element.style, {\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  Object.assign(element.style, {\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 {
     /**

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

@@ -77,9 +77,7 @@ class GesturesController extends EventTarget {
         return { x, y, time: Date.now() };
     }
     _setTouchActionState(disabled) {
-        Object.assign(this._element.style, {
-            touchAction: disabled ? 'none' : undefined,
-        });
+        this._element.style.touchAction = disabled ? 'none' : '';
     }
     _resetState() {
         this._pointerState.start = defaultState;
@@ -92,8 +90,10 @@ class GesturesController extends EventTarget {
             : this._element.releasePointerCapture(event.pointerId);
     }
     _handlePointerDown(event) {
+        const state = this._getGestureState(event);
         this._setTouchActionState(true);
-        this._pointerState.start = this._getGestureState(event);
+        this._pointerState.start = state;
+        this._pointerState.current = state;
         this._setPointerCaptureState(event, true);
     }
     _handlePointerMove(event) {

package/internals/controllers/gestures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestures.js","sourceRoot":"","sources":["../../../src/internals/controllers/gestures.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\nimport type { Ref } from 'lit/directives/ref.js';\nimport { createAbortHandle } from '../abort-handler.js';\n\nconst Events = [\n  'pointerdown',\n  'pointermove',\n  'lostpointercapture',\n  'pointercancel',\n] as const;\nconst defaultState: GestureState = Object.freeze({ x: 0, y: 0, time: 0 });\n\n/**\n * Configuration object for a {@link GesturesController} instance.\n * @hidden\n */\nexport interface GesturesOptions {\n  /**\n   * By default, the controller listens for pointer/touch events in the context of the host element.\n   * If you pass a `ref`, you can limit the observation to a certain DOM part of the host scope.\n   */\n  ref?: Ref<HTMLElement>;\n  /**\n   * The maximum amount of milliseconds between the start and end of a gesture combination\n   * before it is recognized as such.\n   */\n  thresholdTime?: number;\n  /**\n   * The minimum amount a \"pointer\" should travel in pixels, before being recognized as a\n   * gesture.\n   */\n  thresholdDistance?: number;\n  /**\n   * When enabled, the controller will skip events generated by a mouse device.\n   */\n  touchOnly?: boolean;\n}\n\ntype GestureState = {\n  x: number;\n  y: number;\n  time: number;\n};\n\ntype GestureDirection = 'left' | 'up' | 'right' | 'down';\ntype SwipeEvents =\n  | 'swipe'\n  | 'swipe-left'\n  | 'swipe-up'\n  | 'swipe-right'\n  | 'swipe-down';\n\nexport type GestureData = {\n  direction: GestureDirection;\n  type: string;\n  xStart: number;\n  xEnd: number;\n  yStart: number;\n  yEnd: number;\n};\n\n/* blazorSuppress */\nexport class SwipeEvent extends Event {\n  public readonly data: GestureData;\n  public readonly name: string;\n\n  constructor(name: string, data: GestureData, initOptions?: EventInit) {\n    super(name, initOptions);\n    this.name = name;\n    this.data = data;\n  }\n}\n\nclass GesturesController extends EventTarget implements ReactiveController {\n  private readonly _host: ReactiveControllerHost & HTMLElement;\n  private readonly _ref?: Ref<HTMLElement>;\n  private readonly _abortHandle = createAbortHandle();\n\n  private _options: GesturesOptions = {\n    thresholdDistance: 100,\n    thresholdTime: 500,\n    touchOnly: false,\n  };\n\n  private _pointerState = {\n    captured: false,\n    start: defaultState,\n    current: defaultState,\n  };\n\n  protected get _element() {\n    return this._ref ? this._ref.value! : this._host;\n  }\n\n  /** Get the current configuration object */\n  public get options(): GesturesOptions {\n    return this._options;\n  }\n\n  constructor(\n    host: ReactiveControllerHost & HTMLElement,\n    options?: GesturesOptions\n  ) {\n    super();\n\n    Object.assign(this._options, options);\n    this._ref = this._options.ref;\n\n    this._host = host;\n    this._host.addController(this);\n  }\n\n  /**\n   * Add an event listener for a given swipe event.\n   */\n  public set(\n    type: SwipeEvents,\n    callback: (event: SwipeEvent) => void,\n    options?: AddEventListenerOptions\n  ): this {\n    const bound = callback.bind(this._host) as EventListener;\n\n    this.addEventListener(type, bound, options);\n    return this;\n  }\n\n  /** @internal */\n  public handleEvent(event: PointerEvent): void {\n    if (this._options.touchOnly && event.pointerType === 'mouse') {\n      return;\n    }\n\n    switch (event.type) {\n      case 'pointerdown':\n        this._handlePointerDown(event);\n        break;\n      case 'pointermove':\n        this._handlePointerMove(event);\n        break;\n      case 'lostpointercapture':\n      case 'pointercancel':\n        this._handleLostPointerCapture(event);\n    }\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    const { signal } = this._abortHandle;\n\n    this._host.updateComplete.then(() => {\n      for (const event of Events) {\n        this._element.addEventListener(event, this, { passive: true, signal });\n      }\n    });\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._abortHandle.abort();\n  }\n\n  /** Updates the configuration of the controller */\n  public updateOptions(options: Omit<GesturesOptions, 'ref'>): void {\n    Object.assign(this._options, options);\n  }\n\n  private _getGestureState({\n    clientX: x,\n    clientY: y,\n  }: PointerEvent): GestureState {\n    return { x, y, time: Date.now() };\n  }\n\n  private _setTouchActionState(disabled: boolean) {\n    this._element.style.touchAction = disabled ? 'none' : '';\n  }\n\n  private _resetState() {\n    this._pointerState.start = defaultState;\n    this._pointerState.current = defaultState;\n  }\n\n  private _setPointerCaptureState(event: PointerEvent, state: boolean) {\n    this._pointerState.captured = state;\n    state\n      ? this._element.setPointerCapture(event.pointerId)\n      : this._element.releasePointerCapture(event.pointerId);\n  }\n\n  private _handlePointerDown(event: PointerEvent) {\n    const state = this._getGestureState(event);\n\n    this._setTouchActionState(true);\n    // Seeded so that a press without any movement resolves to a zero delta\n    // instead of being measured against the zeroed default state.\n    this._pointerState.start = state;\n    this._pointerState.current = state;\n    this._setPointerCaptureState(event, true);\n  }\n\n  private _handlePointerMove(event: PointerEvent) {\n    if (this._pointerState.captured) {\n      this._pointerState.current = this._getGestureState(event);\n    }\n  }\n\n  private _emit(name: SwipeEvents, data: GestureData) {\n    return this.dispatchEvent(new SwipeEvent(name, data));\n  }\n\n  private _createEventArgs() {\n    const { start, current } = this._pointerState;\n\n    return {\n      xStart: start.x,\n      xEnd: current.x,\n      yStart: start.y,\n      yEnd: current.y,\n    };\n  }\n\n  protected _recognize(): GestureDirection | false {\n    const { start, current } = this._pointerState;\n\n    const dt = current.time - start.time;\n    const dx = current.x - start.x;\n    const dy = current.y - start.y;\n\n    const time = this._options.thresholdTime ?? 500;\n    const distance = this._options.thresholdDistance ?? 100;\n\n    if (dt > time) {\n      return false;\n    }\n\n    if (dx > distance && Math.abs(dy) < distance) {\n      return 'right';\n    }\n\n    if (-dx > distance && Math.abs(dy) < distance) {\n      return 'left';\n    }\n\n    if (dy > distance && Math.abs(dx) < distance) {\n      return 'down';\n    }\n\n    if (-dy > distance && Math.abs(dx) < distance) {\n      return 'up';\n    }\n\n    return false;\n  }\n\n  private _handleLostPointerCapture(event: PointerEvent) {\n    this._setPointerCaptureState(event, false);\n    const state = this._recognize();\n\n    if (state) {\n      const args: GestureData = Object.assign(this._createEventArgs(), {\n        type: event.pointerType,\n        direction: state,\n      });\n\n      this._emit('swipe', args);\n      this._emit(`swipe-${state}`, args);\n    }\n\n    this._resetState();\n    this._setTouchActionState(false);\n  }\n}\n\n/**\n * Adds a {@link GesturesController} responsible for managing gesture behaviors\n * for the given host element.\n */\nexport function addGesturesController(\n  host: ReactiveControllerHost & HTMLElement,\n  options?: GesturesOptions\n) {\n  return new GesturesController(host, options);\n}\n"]}

package/{components/common → internals}/controllers/id-resolver.js

@@ -1,5 +1,5 @@
 import { isServer } from 'lit';
-import { isDocument, isElement } from '../util.js';
+import { isDocument, isElement } from '../utils/dom.js';
 const ID_REF_EMITTERS = new WeakMap();
 const ID_REF_EVENT = 'id-refs-change';
 function getEmitter(root) {
@@ -10,6 +10,18 @@ function getEmitter(root) {
     }
     return emitter;
 }
+function collectIds(nodes, affected) {
+    for (const node of nodes) {
+        if (!isElement(node))
+            continue;
+        if (node.id)
+            affected.add(node.id);
+        for (const child of node.querySelectorAll('[id]')) {
+            if (child.id)
+                affected.add(child.id);
+        }
+    }
+}
 function refObserverCallback(mutations, emitter) {
     const affected = new Set();
     for (const mutation of mutations) {
@@ -24,26 +36,8 @@ function refObserverCallback(mutations, emitter) {
                 affected.add(newId);
         }
         else {
-            for (const node of mutation.addedNodes) {
-                if (!isElement(node))
-                    continue;
-                if (node.id)
-                    affected.add(node.id);
-                for (const child of node.querySelectorAll('[id]')) {
-                    if (child.id)
-                        affected.add(child.id);
-                }
-            }
-            for (const node of mutation.removedNodes) {
-                if (!isElement(node))
-                    continue;
-                if (node.id)
-                    affected.add(node.id);
-                for (const child of node.querySelectorAll('[id]')) {
-                    if (child.id)
-                        affected.add(child.id);
-                }
-            }
+            collectIds(mutation.addedNodes, affected);
+            collectIds(mutation.removedNodes, affected);
         }
     }
     if (affected.size > 0) {

package/internals/controllers/id-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-resolver.js","sourceRoot":"","sources":["../../../src/internals/controllers/id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer, type LitElement, type ReactiveController } from 'lit';\nimport { isDocument, isElement } from '../utils/dom.js';\n\nconst ID_REF_EMITTERS = new WeakMap<Node, IdRefChangeEmitter>();\nconst ID_REF_EVENT = 'id-refs-change';\n\nfunction getEmitter(root: Node): IdRefChangeEmitter {\n  let emitter = ID_REF_EMITTERS.get(root);\n  if (!emitter) {\n    emitter = new IdRefChangeEmitter(root);\n    ID_REF_EMITTERS.set(root, emitter);\n  }\n  return emitter;\n}\n\n/** Adds the ids of `nodes` and of any of their descendants to `affected`. */\nfunction collectIds(nodes: NodeList, affected: Set<string>): void {\n  for (const node of nodes) {\n    if (!isElement(node)) continue;\n    if (node.id) affected.add(node.id);\n    for (const child of node.querySelectorAll('[id]')) {\n      if (child.id) affected.add(child.id);\n    }\n  }\n}\n\nfunction refObserverCallback(\n  mutations: MutationRecord[],\n  emitter: IdRefChangeEmitter\n): void {\n  const affected = new Set<string>();\n\n  for (const mutation of mutations) {\n    if (mutation.type === 'attributes') {\n      if (!isElement(mutation.target)) continue;\n      const oldId = mutation.oldValue;\n      const newId = mutation.target.id;\n      if (oldId) affected.add(oldId);\n      if (newId) affected.add(newId);\n    } else {\n      collectIds(mutation.addedNodes, affected);\n      collectIds(mutation.removedNodes, affected);\n    }\n  }\n\n  if (affected.size > 0) {\n    emitter.dispatchEvent(new CustomEvent(ID_REF_EVENT, { detail: affected }));\n  }\n}\n\n/**\n * Emits events when ID references in a root node change, allowing components to reactively update resolved references.\n * Uses a reference counting mechanism to avoid unnecessary observation when no components are using it.\n */\nclass IdRefChangeEmitter extends EventTarget {\n  private readonly _observer?: MutationObserver;\n  private readonly _root: Node;\n  private _refCount = 0;\n\n  constructor(root: Node) {\n    super();\n    this._root = root;\n\n    if (!isServer) {\n      this._observer = new MutationObserver((mutations) =>\n        refObserverCallback(mutations, this)\n      );\n    }\n  }\n\n  /**\n   * Increment the reference count. Starts the underlying MutationObserver on the first call.\n   */\n  public retain(): void {\n    if (this._refCount++ === 0) {\n      const root = isDocument(this._root) ? this._root.body : this._root;\n      this._observer?.observe(root, {\n        attributeFilter: ['id'],\n        attributeOldValue: true,\n        subtree: true,\n        childList: true,\n      });\n    }\n  }\n\n  /**\n   * Decrement the reference count. Stops the underlying MutationObserver when the count reaches zero.\n   */\n  public release(): void {\n    if (this._refCount > 0 && --this._refCount === 0) {\n      this._observer?.disconnect();\n    }\n  }\n}\n\n/**\n * Reactive controller that allows a host component to resolve ID references\n * scoped to its root node, and react to changes in those references.\n */\nclass IdRefResolverController implements ReactiveController {\n  private readonly _host: LitElement;\n  private readonly _callback: (ids: Set<string>) => unknown;\n  private _active = false;\n  private _connected = false;\n  private _emitter: IdRefChangeEmitter | null = null;\n\n  constructor(host: LitElement, callback: (ids: Set<string>) => unknown) {\n    this._host = host;\n    this._host.addController(this);\n    this._callback = callback;\n  }\n\n  private _observe(): void {\n    const root = this._host.getRootNode();\n    this._emitter = getEmitter(root);\n    this._emitter.retain();\n    this._emitter.addEventListener(ID_REF_EVENT, this);\n  }\n\n  private _unobserve(): void {\n    if (this._emitter) {\n      this._emitter.removeEventListener(ID_REF_EVENT, this);\n      this._emitter.release();\n      this._emitter = null;\n    }\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    this._callback.call(this._host, (event as CustomEvent<Set<string>>).detail);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._connected = true;\n    if (this._active) {\n      this._observe();\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    if (this._active) {\n      this._unobserve();\n    }\n    this._connected = false;\n  }\n\n  /** Start tracking ID reference changes in the document. */\n  public observe(): void {\n    if (this._active) return;\n    this._active = true;\n    if (this._connected) {\n      this._observe();\n    }\n  }\n\n  /** Stop tracking ID reference changes in the document. */\n  public unobserve(): void {\n    if (!this._active) return;\n    this._active = false;\n    if (this._connected) {\n      this._unobserve();\n    }\n  }\n}\n\n/**\n * Adds an ID reference resolver controller to the host component, allowing it to resolve ID references scoped to\n * its root node and react to changes in those references.\n */\nexport function addIdRefResolver(\n  host: LitElement,\n  callback: (ids: Set<string>) => unknown\n): IdRefResolverController {\n  return new IdRefResolverController(host, callback);\n}\n\nexport type { IdRefResolverController };\n"]}