igniteui-webcomponents 7.3.2 → 7.4.1

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

@@ -1,15 +1,40 @@
 import { type LitElement, type ReactiveController, type ReactiveControllerHost } from 'lit';
 import { Directive, type DirectiveParameters, type ElementPart, type PartInfo } from 'lit/directive.js';
+import type { SlotController } from './slot.js';
 type ControllerHost = ReactiveControllerHost & LitElement;
+/** The host attributes that {@link resolveNaming} reads. */
+export declare const NAMING_ATTRIBUTES: string[];
+/** The name sources of a component, resolved by {@link resolveNaming}. */
+export type ResolvedNaming = {
+    /** The elements that name the component, bound as element references. */
+    labelledBy: ReadonlyArray<Element> | null;
+    /** The id of the own label in the shadow root, bound as an IDREF. */
+    labelledByRef?: string;
+    /** The host `aria-label` or the fallback, when no label names the component. */
+    label?: string;
+};
+/**
+ * Resolves the name of a form associated component. The first source that is
+ * present wins: the host `aria-labelledby`, the external `<label>` elements,
+ * the own label of the component, the host `aria-label`, and `fallback`.
+ *
+ * `ownLabel` is the id of the own label in the shadow root, or `true` for an
+ * own label that names the control natively, for example a `<label for>`.
+ *
+ * @remarks
+ * Assistive technology reads the native control in the shadow root, so the
+ * name moves from the host to that control. `host.ariaLabelledByElements`
+ * resolves the host IDREFs in the host tree. An external label replaces the
+ * own label. A wrapping label contains the own label text.
+ */
+export declare function resolveNaming(host: Element, ownLabel: string | boolean, fallback?: string): ResolvedNaming;
 /**
- * ARIA semantics a composite host projects onto the native editor of an
- * input-shaped component.
+ * The ARIA semantics that a composite host projects onto the native editor.
  *
- * 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.
+ * @remarks
+ * The host delegates focus, so assistive technology lands on the editor of
+ * the input-shaped component and reports it. Every relation travels as an
+ * element reference, because an IDREF does not cross a shadow boundary.
  */
 export type ProjectedARIA = {
     role?: string;
@@ -22,21 +47,21 @@ export type ProjectedARIA = {
     labelledBy?: ReadonlyArray<Element> | null;
     activeDescendant?: Element | null;
 };
-/** Configuration for the {@link AriaTargetController}. */
+/** The id of the helper-text container of `IgcValidationContainerComponent`. */
+export declare const HELPER_TEXT_ID = "helper-text";
+/** Returns the helper-text container when the `helper-text` slot has content. */
+export declare function helperText(host: LitElement, slots: Pick<SlotController<'helper-text'>, 'hasAssignedElements'>): Element | null;
 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;
+    /** Resolves the helper-text container, or `null` when there is none. */
+    description?: () => Element | null;
+    /** Whether an own label names the editor natively, for example a `<label for>`. */
+    hasOwnLabel?: () => boolean;
 };
 /**
- * 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.
+ * The binding values for a native editor element, resolved from the projected
+ * state and the own ARIA of the editor, and applied by the
+ * {@link ariaBindings} directive. A scalar binds as an attribute, a relation
+ * through an ARIA element-reflection property.
  */
 export type ResolvedARIABindings = {
     role?: string;
@@ -45,100 +70,114 @@ export type ResolvedARIABindings = {
     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).
+     * The IDREF of the own description in the same root. The directive binds it
+     * while `describedBy` is null, so a tool that reads only attributes, for
+     * example axe, still sees the relation.
      */
     describedByRef?: string;
+    /** The IDREF of the own label in the same root. It binds as `describedByRef`. */
+    labelledByRef?: 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.
+ * The receiving end of an ARIA projection. It names the native control in the
+ * shadow root, see {@link resolveNaming}, and applies the state that a
+ * composite host projects.
  *
- * Not a reactive controller - it needs no lifecycle hooks, only a render
- * scheduled on the host when the projected state changes.
+ * @remarks
+ * Not a reactive controller. The host render resolves the bindings, and the
+ * form associated mixin renders the host again when the name sources change.
  */
 declare class AriaTargetController {
     private readonly _host;
     private readonly _config;
     private _projected;
+    /** The bindings last resolved for the native editor. */
+    private _resolved?;
     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.
+     * Replaces the projected state.
+     *
+     * @remarks
+     * A host render happens only when the resolved bindings change, so a
+     * projection on every host update stays inexpensive. The comparison uses
+     * the resolved bindings, so it also catches a change to the own labels or
+     * description, which the component cannot observe.
      */
     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.
+     * Mirrors the projected `role` and `hasPopup` onto `data-role` and
+     * `data-haspopup`.
+     *
+     * @remarks
+     * The input themes style the anchor of a composite widget from these
+     * attributes. The ARIA itself stays on the editor in the shadow root, where
+     * a `:host()` selector 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.
+     * Resolves the binding values for the native editor element. A projected
+     * value wins over the own naming.
      */
     resolveBindings(): ResolvedARIABindings;
 }
+/** The bindings that {@link ariaBindings} accepts. Each key is optional. */
+export type ARIABindings = Partial<ResolvedARIABindings>;
 /**
- * Applies {@link ResolvedARIABindings} onto the native editor element -
- * relations on every render, scalar attributes only when they changed.
+ * Applies {@link ARIABindings} to the native editor. It writes only changed
+ * values, and only to the attributes that its bindings set.
  */
 declare class AriaBindingsDirective extends Directive {
     private _previous?;
     constructor(partInfo: PartInfo);
-    render(_: ResolvedARIABindings): unknown;
+    render(_: ARIABindings): 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)} />`.
+ * Binds the resolved ARIA state onto a native editor element as one element
+ * expression, for example `<input ${ariaBindings(aria)} />`.
  */
-export declare const ariaBindings: (_: ResolvedARIABindings) => import("lit-html/directive.js").DirectiveResult<typeof AriaBindingsDirective>;
-/** Configuration for the {@link AriaProjectorController}. */
+export declare const ariaBindings: (_: Partial<ResolvedARIABindings>) => import("lit-html/directive.js").DirectiveResult<typeof AriaBindingsDirective>;
 type AriaProjectorConfig = {
-    /** Resolves the input-shaped component the ARIA state is projected onto. */
+    /** Resolves the input-shaped component that receives the ARIA state. */
     target: () => Element | null | undefined;
-    /** Computes the ARIA state to project. Invoked after every host update. */
+    /** Computes the ARIA state to project, after every host update. */
     state: () => ProjectedARIA;
+    /**
+     * Whether the host shows an own label. When set, the projector also
+     * projects the name of the host, see {@link resolveNaming}.
+     */
+    hasOwnLabel?: () => boolean;
+    /** Resolves the name to use when no other source names the host. */
+    fallbackLabel?: () => string;
 };
 /**
- * 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}.
+ * The sending end of an ARIA projection. A composite host such as
+ * `igc-select` adds it to push the computed ARIA state onto the
+ * {@link AriaTargetController} of the target after every host update.
  */
 declare class AriaProjectorController implements ReactiveController {
     private readonly _host;
     private readonly _config;
     private _retryScheduled;
     constructor(host: ControllerHost, config: AriaProjectorConfig);
+    /** Computes the state, with the name of the host when it is configured. */
+    private _state;
     /** @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.
+ * Creates an {@link AriaTargetController} and adds it to an input-shaped
+ * component. It makes the native editor of the component a valid target for
+ * {@link addAriaProjector}.
  */
 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.
+ * Creates an {@link AriaProjectorController} and adds it to a composite host.
+ * It projects ARIA 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

@@ -1,23 +1,34 @@
 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;
+import { sameItems } from '../utils/arrays.js';
+import { isString } from '../utils/types.js';
+import { internalsOf } from './internals.js';
+export const NAMING_ATTRIBUTES = ['aria-label', 'aria-labelledby'];
+export function resolveNaming(host, ownLabel, fallback) {
+    const referenced = host.ariaLabelledByElements;
+    if (referenced?.length) {
+        return { labelledBy: referenced };
+    }
+    const labels = internalsOf(host)?.labels;
+    if (labels) {
+        return { labelledBy: labels };
+    }
+    const naming = {
+        labelledBy: null,
+        label: ownLabel ? undefined : host.getAttribute('aria-label') || fallback,
+    };
+    if (isString(ownLabel)) {
+        naming.labelledByRef = ownLabel;
     }
-    return a.length === b.length && a.every((element, i) => element === b[i]);
+    return naming;
 }
-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));
+export const HELPER_TEXT_ID = 'helper-text';
+export function helperText(host, slots) {
+    return slots.hasAssignedElements('helper-text')
+        ? host.renderRoot.querySelector(`#${HELPER_TEXT_ID}`)
+        : null;
 }
+const targets = new WeakMap();
 class AriaTargetController {
     constructor(host, config) {
         this._projected = {};
@@ -26,8 +37,9 @@ class AriaTargetController {
         targets.set(host, this);
     }
     setProjected(state) {
-        if (!projectionsEqual(this._projected, state)) {
-            this._projected = state;
+        const previous = this._resolved;
+        this._projected = state;
+        if (!bindingsEqual(previous, this.resolveBindings())) {
             this._reflectStylingHooks();
             this._host.requestUpdate();
         }
@@ -44,25 +56,27 @@ class AriaTargetController {
     }
     resolveBindings() {
         const projected = this._projected;
-        const description = this._config.description();
-        return {
+        const description = this._config.description?.() ?? null;
+        const naming = projected.labelledBy
+            ? projected
+            : resolveNaming(this._host, this._config.hasOwnLabel?.() ?? false);
+        this._resolved = {
             role: projected.role,
             hasPopup: projected.hasPopup,
             expanded: projected.expanded,
             disabled: projected.disabled,
-            label: projected.label,
-            labelledBy: projected.labelledBy ?? this._config.labels(),
+            label: projected.label ?? naming.label,
+            labelledBy: naming.labelledBy ?? null,
             controls: projected.controls ?? null,
             describedBy: projected.describedBy
                 ? description
                     ? [description, ...projected.describedBy]
                     : projected.describedBy
                 : null,
-            describedByRef: projected.describedBy
-                ? undefined
-                : description?.id || undefined,
+            describedByRef: description?.id || undefined,
             activeDescendant: projected.activeDescendant ?? null,
         };
+        return this._resolved;
     }
 }
 const scalarBindings = [
@@ -71,8 +85,23 @@ const scalarBindings = [
     ['expanded', 'aria-expanded'],
     ['disabled', 'aria-disabled'],
     ['label', 'aria-label'],
-    ['describedByRef', 'aria-describedby'],
 ];
+const relationBindings = [
+    ['labelledBy', 'labelledByRef', 'ariaLabelledByElements', 'aria-labelledby'],
+    [
+        'describedBy',
+        'describedByRef',
+        'ariaDescribedByElements',
+        'aria-describedby',
+    ],
+    ['controls', null, 'ariaControlsElements', 'aria-controls'],
+];
+function bindingsEqual(a, b) {
+    return (a !== undefined &&
+        a.activeDescendant === b.activeDescendant &&
+        scalarBindings.every(([key]) => a[key] === b[key]) &&
+        relationBindings.every(([key, refKey]) => sameItems(a[key], b[key]) && (!refKey || a[refKey] === b[refKey])));
+}
 class AriaBindingsDirective extends Directive {
     constructor(partInfo) {
         super(partInfo);
@@ -87,13 +116,25 @@ class AriaBindingsDirective extends Directive {
         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, refKey, property, attribute] of relationBindings) {
+            const next = bindings[key] ?? (refKey && bindings[refKey]) ?? null;
+            const prev = previous?.[key] ?? (refKey && previous?.[refKey]) ?? null;
+            if (typeof next === 'string') {
+                if (next !== prev) {
+                    element.setAttribute(attribute, next);
+                }
+            }
+            else if (typeof prev === 'string' || !sameItems(prev, next)) {
+                element[property] = next;
+            }
+        }
+        const activeDescendant = bindings.activeDescendant ?? null;
+        if (activeDescendant !== (previous?.activeDescendant ?? null)) {
+            element.ariaActiveDescendantElement = activeDescendant;
+        }
         for (const [key, attribute] of scalarBindings) {
             const value = bindings[key];
-            if (!previous || previous[key] !== value) {
+            if (previous?.[key] !== value) {
                 value != null
                     ? element.setAttribute(attribute, value)
                     : element.removeAttribute(attribute);
@@ -110,6 +151,15 @@ class AriaProjectorController {
         this._config = config;
         host.addController(this);
     }
+    _state() {
+        const { state, hasOwnLabel, fallbackLabel } = this._config;
+        return hasOwnLabel
+            ? {
+                ...resolveNaming(this._host, hasOwnLabel(), fallbackLabel?.()),
+                ...state(),
+            }
+            : state();
+    }
     hostUpdated() {
         const element = this._config.target();
         if (!element) {
@@ -117,7 +167,7 @@ class AriaProjectorController {
         }
         const target = targets.get(element);
         if (target) {
-            target.setProjected(this._config.state());
+            target.setProjected(this._state());
             return;
         }
         if (!this._retryScheduled) {

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

@@ -1 +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"]}
+{"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';\nimport { sameItems } from '../utils/arrays.js';\nimport { isString } from '../utils/types.js';\nimport { internalsOf } from './internals.js';\nimport type { SlotController } from './slot.js';\n\ntype ControllerHost = ReactiveControllerHost & LitElement;\n\n/** The host attributes that {@link resolveNaming} reads. */\nexport const NAMING_ATTRIBUTES = ['aria-label', 'aria-labelledby'];\n\n/** The name sources of a component, resolved by {@link resolveNaming}. */\nexport type ResolvedNaming = {\n  /** The elements that name the component, bound as element references. */\n  labelledBy: ReadonlyArray<Element> | null;\n  /** The id of the own label in the shadow root, bound as an IDREF. */\n  labelledByRef?: string;\n  /** The host `aria-label` or the fallback, when no label names the component. */\n  label?: string;\n};\n\n/**\n * Resolves the name of a form associated component. The first source that is\n * present wins: the host `aria-labelledby`, the external `<label>` elements,\n * the own label of the component, the host `aria-label`, and `fallback`.\n *\n * `ownLabel` is the id of the own label in the shadow root, or `true` for an\n * own label that names the control natively, for example a `<label for>`.\n *\n * @remarks\n * Assistive technology reads the native control in the shadow root, so the\n * name moves from the host to that control. `host.ariaLabelledByElements`\n * resolves the host IDREFs in the host tree. An external label replaces the\n * own label. A wrapping label contains the own label text.\n */\nexport function resolveNaming(\n  host: Element,\n  ownLabel: string | boolean,\n  fallback?: string\n): ResolvedNaming {\n  const referenced = host.ariaLabelledByElements;\n\n  if (referenced?.length) {\n    return { labelledBy: referenced };\n  }\n\n  const labels = internalsOf(host)?.labels;\n\n  if (labels) {\n    return { labelledBy: labels };\n  }\n\n  const naming: ResolvedNaming = {\n    labelledBy: null,\n    label: ownLabel ? undefined : host.getAttribute('aria-label') || fallback,\n  };\n\n  if (isString(ownLabel)) {\n    naming.labelledByRef = ownLabel;\n  }\n\n  return naming;\n}\n\n/**\n * The ARIA semantics that a composite host projects onto the native editor.\n *\n * @remarks\n * The host delegates focus, so assistive technology lands on the editor of\n * the input-shaped component and reports it. Every relation travels as an\n * element reference, because an IDREF does not cross a shadow boundary.\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/** The id of the helper-text container of `IgcValidationContainerComponent`. */\nexport const HELPER_TEXT_ID = 'helper-text';\n\n/** Returns the helper-text container when the `helper-text` slot has content. */\nexport function helperText(\n  host: LitElement,\n  slots: Pick<SlotController<'helper-text'>, 'hasAssignedElements'>\n): Element | null {\n  return slots.hasAssignedElements('helper-text')\n    ? host.renderRoot.querySelector(`#${HELPER_TEXT_ID}`)\n    : null;\n}\n\ntype AriaTargetConfig = {\n  /** Resolves the helper-text container, or `null` when there is none. */\n  description?: () => Element | null;\n  /** Whether an own label names the editor natively, for example a `<label for>`. */\n  hasOwnLabel?: () => boolean;\n};\n\n/**\n * The binding values for a native editor element, resolved from the projected\n * state and the own ARIA of the editor, and applied by the\n * {@link ariaBindings} directive. A scalar binds as an attribute, a relation\n * through an ARIA element-reflection property.\n */\nexport type ResolvedARIABindings = {\n  role?: string;\n  hasPopup?: string;\n  expanded?: string;\n  disabled?: string;\n  label?: string;\n  /**\n   * The IDREF of the own description in the same root. The directive binds it\n   * while `describedBy` is null, so a tool that reads only attributes, for\n   * example axe, still sees the relation.\n   */\n  describedByRef?: string;\n  /** The IDREF of the own label in the same root. It binds as `describedByRef`. */\n  labelledByRef?: string;\n  labelledBy: ReadonlyArray<Element> | null;\n  controls: ReadonlyArray<Element> | null;\n  describedBy: ReadonlyArray<Element> | null;\n  activeDescendant: Element | null;\n};\n\n/**\n * Resolves an input-shaped component to its ARIA target controller, so the\n * component needs no public member for the projection.\n */\nconst targets = new WeakMap<Element, AriaTargetController>();\n\n/**\n * The receiving end of an ARIA projection. It names the native control in the\n * shadow root, see {@link resolveNaming}, and applies the state that a\n * composite host projects.\n *\n * @remarks\n * Not a reactive controller. The host render resolves the bindings, and the\n * form associated mixin renders the host again when the name sources change.\n */\nclass AriaTargetController {\n  private readonly _host: ControllerHost;\n  private readonly _config: AriaTargetConfig;\n  private _projected: ProjectedARIA = {};\n  /** The bindings last resolved for the native editor. */\n  private _resolved?: ResolvedARIABindings;\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.\n   *\n   * @remarks\n   * A host render happens only when the resolved bindings change, so a\n   * projection on every host update stays inexpensive. The comparison uses\n   * the resolved bindings, so it also catches a change to the own labels or\n   * description, which the component cannot observe.\n   */\n  public setProjected(state: ProjectedARIA): void {\n    const previous = this._resolved;\n    this._projected = state;\n\n    if (!bindingsEqual(previous, this.resolveBindings())) {\n      this._reflectStylingHooks();\n      this._host.requestUpdate();\n    }\n  }\n\n  /**\n   * Mirrors the projected `role` and `hasPopup` onto `data-role` and\n   * `data-haspopup`.\n   *\n   * @remarks\n   * The input themes style the anchor of a composite widget from these\n   * attributes. The ARIA itself stays on the editor in the shadow root, where\n   * a `:host()` selector 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. A projected\n   * value wins over the own naming.\n   */\n  public resolveBindings(): ResolvedARIABindings {\n    const projected = this._projected;\n    const description = this._config.description?.() ?? null;\n    const naming = projected.labelledBy\n      ? projected\n      : resolveNaming(this._host, this._config.hasOwnLabel?.() ?? false);\n\n    this._resolved = {\n      role: projected.role,\n      hasPopup: projected.hasPopup,\n      expanded: projected.expanded,\n      disabled: projected.disabled,\n      label: projected.label ?? naming.label,\n      labelledBy: naming.labelledBy ?? null,\n      controls: projected.controls ?? null,\n      describedBy: projected.describedBy\n        ? description\n          ? [description, ...projected.describedBy]\n          : projected.describedBy\n        : null,\n      describedByRef: description?.id || undefined,\n      activeDescendant: projected.activeDescendant ?? null,\n    };\n\n    return this._resolved;\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] as const;\n\n/** The relations: the key, the IDREF key, the property, and the attribute. */\nconst relationBindings = [\n  ['labelledBy', 'labelledByRef', 'ariaLabelledByElements', 'aria-labelledby'],\n  [\n    'describedBy',\n    'describedByRef',\n    'ariaDescribedByElements',\n    'aria-describedby',\n  ],\n  ['controls', null, 'ariaControlsElements', 'aria-controls'],\n] as const;\n\nfunction bindingsEqual(\n  a: ResolvedARIABindings | undefined,\n  b: ResolvedARIABindings\n): boolean {\n  return (\n    a !== undefined &&\n    a.activeDescendant === b.activeDescendant &&\n    scalarBindings.every(([key]) => a[key] === b[key]) &&\n    relationBindings.every(\n      ([key, refKey]) =>\n        sameItems(a[key], b[key]) && (!refKey || a[refKey] === b[refKey])\n    )\n  );\n}\n\n/** The bindings that {@link ariaBindings} accepts. Each key is optional. */\nexport type ARIABindings = Partial<ResolvedARIABindings>;\n\n/**\n * Applies {@link ARIABindings} to the native editor. It writes only changed\n * values, and only to the attributes that its bindings set.\n */\nclass AriaBindingsDirective extends Directive {\n  private _previous?: ARIABindings;\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(_: ARIABindings): 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    // A value is an element list, an IDREF string or null. An IDREF write\n    // clears the reflection. A null write removes the attribute.\n    for (const [key, refKey, property, attribute] of relationBindings) {\n      const next = bindings[key] ?? (refKey && bindings[refKey]) ?? null;\n      const prev = previous?.[key] ?? (refKey && previous?.[refKey]) ?? null;\n\n      if (typeof next === 'string') {\n        if (next !== prev) {\n          element.setAttribute(attribute, next);\n        }\n      } else if (typeof prev === 'string' || !sameItems(prev, next)) {\n        element[property] = next;\n      }\n    }\n\n    const activeDescendant = bindings.activeDescendant ?? null;\n\n    if (activeDescendant !== (previous?.activeDescendant ?? null)) {\n      element.ariaActiveDescendantElement = activeDescendant;\n    }\n\n    for (const [key, attribute] of scalarBindings) {\n      const value = bindings[key];\n\n      if (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 the resolved ARIA state onto a native editor element as one element\n * expression, for example `<input ${ariaBindings(aria)} />`.\n */\nexport const ariaBindings = directive(AriaBindingsDirective);\n\ntype AriaProjectorConfig = {\n  /** Resolves the input-shaped component that receives the ARIA state. */\n  target: () => Element | null | undefined;\n  /** Computes the ARIA state to project, after every host update. */\n  state: () => ProjectedARIA;\n  /**\n   * Whether the host shows an own label. When set, the projector also\n   * projects the name of the host, see {@link resolveNaming}.\n   */\n  hasOwnLabel?: () => boolean;\n  /** Resolves the name to use when no other source names the host. */\n  fallbackLabel?: () => string;\n};\n\n/**\n * The sending end of an ARIA projection. A composite host such as\n * `igc-select` adds it to push the computed ARIA state onto the\n * {@link AriaTargetController} of the target after every host update.\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  /** Computes the state, with the name of the host when it is configured. */\n  private _state(): ProjectedARIA {\n    const { state, hasOwnLabel, fallbackLabel } = this._config;\n\n    return hasOwnLabel\n      ? {\n          ...resolveNaming(this._host, hasOwnLabel(), fallbackLabel?.()),\n          ...state(),\n        }\n      : state();\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._state());\n      return;\n    }\n\n    // The target exists but is not upgraded yet, because its definition\n    // registered late. Project again once that 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 an {@link AriaTargetController} and adds it to an input-shaped\n * component. It makes the native editor of the component a valid target for\n * {@link addAriaProjector}.\n */\nexport function addAriaTarget(\n  host: ControllerHost,\n  config: AriaTargetConfig\n): AriaTargetController {\n  return new AriaTargetController(host, config);\n}\n\n/**\n * Creates an {@link AriaProjectorController} and adds it to a composite host.\n * It projects ARIA 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/internals/controllers/async-consumer.js.map

@@ -1 +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"]}
+{"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;IAIM,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  // The consumer survives a disconnect, and a reconnect can land during the\n  // await, so the guard runs on both sides of it.\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.d.ts

@@ -1,14 +1,13 @@
-import type { LitElement, ReactiveController } from 'lit';
+import type { LitElement } from 'lit';
 /**
- * A Lit reactive controller that bridges the native
+ * Connects the native
  * [Invoker Commands API](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API)
- * with a component's programmatic API.
+ * to the programmatic API of a component.
  *
- * When an `igc-button` (or any element using the `command` / `commandfor`
- * attributes) invokes a command on the host, the browser dispatches a
- * `CommandEvent` on the target element. This controller listens for that
- * event and forwards it to the registered callback for the given command
- * string.
+ * @remarks
+ * An element with the `command` and `commandfor` attributes makes the browser
+ * send a `CommandEvent` to the host, and the controller runs the callback of
+ * that command string.
  *
  * @example
  * ```ts
@@ -20,43 +19,29 @@ import type { LitElement, ReactiveController } from 'lit';
  * }
  * ```
  *
- * With the above setup, a button in the document can control the dialog
- * declaratively:
+ * A button in the document then controls the dialog declaratively:
  *
  * ```html
  * <igc-button command="open" commandfor="my-dialog">Open</igc-button>
  * <igc-dialog id="my-dialog"></igc-dialog>
  * ```
  */
-declare class CommandController implements ReactiveController {
+declare class CommandController {
     private readonly _host;
     private readonly _commandMap;
     constructor(host: LitElement);
     /**
-     * Registers a command string and its corresponding handler callback.
+     * Registers a command string and its handler callback.
      *
-     * Returns `this` to allow chained calls:
-     * ```ts
-     * addCommandController(this)
-     *   .set('open', this.show)
-     *   .set('close', this.hide);
-     * ```
-     *
-     * @param command - The command string to listen for (e.g. `'open'`,
-     *   `'toggle-popover'`, or a custom `'--my-command'`).
-     * @param callback - The method to invoke when the command is received.
-     *   Called with the host as `this`.
+     * @param command - The command string to listen for, for example `'open'`,
+     *   `'toggle-popover'`, or a custom `'--my-command'`.
+     * @param callback - The method that runs when the command arrives. The
+     *   controller calls it with the host as `this`.
      */
     set(command: string, callback: () => unknown): this;
     /** @internal */
-    hostConnected(): void;
-    /** @internal */
-    hostDisconnected(): void;
-    /** @internal */
     handleEvent(event: Event): void;
 }
-/**
- * Creates a {@link CommandController} and attaches it to the given host.
- */
+/** Creates a {@link CommandController} and adds it to the given host. */
 export declare function addCommandController(host: LitElement): CommandController;
 export type { CommandController };

package/internals/controllers/command.js

@@ -1,19 +1,14 @@
+import { addHostListeners } from './host-listeners.js';
 class CommandController {
     constructor(host) {
         this._commandMap = new Map();
         this._host = host;
-        host.addController(this);
+        addHostListeners(host, { events: ['command'], listener: this });
     }
     set(command, callback) {
         this._commandMap.set(command, callback);
         return this;
     }
-    hostConnected() {
-        this._host.addEventListener('command', this);
-    }
-    hostDisconnected() {
-        this._host.removeEventListener('command', this);
-    }
     handleEvent(event) {
         const commandEvent = event;
         this._commandMap.get(commandEvent.command)?.call(this._host);