igniteui-webcomponents 7.2.4 → 7.3.0-beta.1

package/{components/common → internals}/templates/input-shell.d.ts

@@ -1,7 +1,14 @@
 import { nothing, type TemplateResult } from 'lit';
+import type { SlotController } from '../controllers/slot.js';
 import type { IgcFormControl } from '../mixins/forms/types.js';
 /** Returns a unique id for native input elements rendered by input components. */
-export declare function nextInputId(): string;
+export declare const nextInputId: () => string;
+/**
+ * Resolves the shared container part names of an input-like component based
+ * on its current slotted and filled state.
+ * Used to apply conditional styling via CSS parts.
+ */
+export declare function resolveInputPartNames(slots: Pick<SlotController<'prefix' | 'suffix'>, 'hasAssignedElements'>, base: string, filled: boolean): Record<string, boolean>;
 export interface InputShellOptions {
     /** Active theme name. The `material` theme uses the notch layout. */
     theme: string;

package/{components/common → internals}/templates/input-shell.js

@@ -1,9 +1,19 @@
 import { html, nothing } from 'lit';
-import IgcValidationContainerComponent from '../../validation-container/validation-container.js';
+import IgcValidationContainerComponent from '../../components/validation-container/validation-container.js';
 import { partMap } from '../part-map.js';
-let _nextInputId = 1;
-export function nextInputId() {
-    return `input-${_nextInputId++}`;
+import { createIdGenerator } from '../utils/strings.js';
+export const nextInputId = createIdGenerator('input');
+export function resolveInputPartNames(slots, base, filled) {
+    return {
+        [base]: true,
+        prefixed: slots.hasAssignedElements('prefix', {
+            selector: '[slot="prefix"]:not([hidden])',
+        }),
+        suffixed: slots.hasAssignedElements('suffix', {
+            selector: '[slot="suffix"]:not([hidden])',
+        }),
+        filled,
+    };
 }
 function renderLabel(forId, label) {
     return label

package/internals/templates/input-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-shell.js","sourceRoot":"","sources":["../../../src/internals/templates/input-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AACzD,OAAO,+BAA+B,MAAM,+DAA+D,CAAC;AAG5G,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAOtD,MAAM,UAAU,qBAAqB,CACnC,KAAuE,EACvE,IAAY,EACZ,MAAe;IAEf,OAAO;QACL,CAAC,IAAI,CAAC,EAAE,IAAI;QACZ,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE;YAC5C,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE;YAC5C,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AAiBD,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa;IAC/C,OAAO,KAAK;QACV,CAAC,CAAC,IAAI,CAAA,2BAA2B,KAAK,IAAI,KAAK,UAAU;QACzD,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,CAAA,sDAAsD,CAAC;AACpE,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,IAAI,CAAA,sDAAsD,CAAC;AACpE,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAC9B,IAAoB,EACpB,EACE,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,GACW;IAEpB,MAAM,SAAS,GAAG,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;IAEzD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;kBACG,OAAO,CAAC,EAAE,GAAG,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;4BACvC,YAAY,EAAE;UAChC,KAAK,GAAG,SAAS;4BACC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;;0BAE7B,YAAY,EAAE;;QAEhC,SAAS;KACZ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAA;MACP,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;gBACjB,OAAO,CAAC,cAAc,CAAC;QAC/B,YAAY,EAAE,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,EAAE;;MAErD,SAAS;GACZ,CAAC;AACJ,CAAC","sourcesContent":["import { html, nothing, type TemplateResult } from 'lit';\nimport IgcValidationContainerComponent from '../../components/validation-container/validation-container.js';\nimport type { SlotController } from '../controllers/slot.js';\nimport type { IgcFormControl } from '../mixins/forms/types.js';\nimport { partMap } from '../part-map.js';\nimport { createIdGenerator } from '../utils/strings.js';\n\n/** Returns a unique id for native input elements rendered by input components. */\nexport const nextInputId = createIdGenerator('input');\n\n/**\n * Resolves the shared container part names of an input-like component based\n * on its current slotted and filled state.\n * Used to apply conditional styling via CSS parts.\n */\nexport function resolveInputPartNames(\n  slots: Pick<SlotController<'prefix' | 'suffix'>, 'hasAssignedElements'>,\n  base: string,\n  filled: boolean\n): Record<string, boolean> {\n  return {\n    [base]: true,\n    prefixed: slots.hasAssignedElements('prefix', {\n      selector: '[slot=\"prefix\"]:not([hidden])',\n    }),\n    suffixed: slots.hasAssignedElements('suffix', {\n      selector: '[slot=\"suffix\"]:not([hidden])',\n    }),\n    filled,\n  };\n}\n\nexport interface InputShellOptions {\n  /** Active theme name. The `material` theme uses the notch layout. */\n  theme: string;\n  /** The label text. Empty string skips label rendering. */\n  label: string;\n  /** The id of the input element used by the label `for` attribute. */\n  labelId: string;\n  /** Resolved part-name map for the container element. */\n  containerParts: Record<string, boolean>;\n  /** Renders the native `<input>` element. */\n  renderInput: () => TemplateResult;\n  /** Optional renderer for components that need extra parts inside the container (e.g. file-input). */\n  renderFileParts?: () => TemplateResult | typeof nothing;\n}\n\nfunction renderLabel(forId: string, label: string) {\n  return label\n    ? html`<label part=\"label\" for=${forId}>${label}</label>`\n    : nothing;\n}\n\nfunction renderPrefix() {\n  return html`<div part=\"prefix\"><slot name=\"prefix\"></slot></div>`;\n}\n\nfunction renderSuffix() {\n  return html`<div part=\"suffix\"><slot name=\"suffix\"></slot></div>`;\n}\n\n/**\n * Renders the shared input chrome (label, prefix, suffix, validator container)\n * around a leaf-provided input template, switching layouts between the\n * material notch and the standard flow.\n */\nexport function renderInputShell(\n  host: IgcFormControl,\n  {\n    containerParts,\n    renderFileParts,\n    renderInput,\n    theme,\n    label,\n    labelId,\n  }: InputShellOptions\n): TemplateResult {\n  const validator = IgcValidationContainerComponent.create(host);\n  const input = renderInput.call(host);\n  const fileParts = renderFileParts?.call(host) ?? nothing;\n\n  if (theme === 'material') {\n    return html`\n      <div part=${partMap({ ...containerParts, labelled: !!label })}>\n        <div part=\"start\">${renderPrefix()}</div>\n        ${input}${fileParts}\n        <div part=\"notch\">${renderLabel(labelId, label)}</div>\n        <div part=\"filler\"></div>\n        <div part=\"end\">${renderSuffix()}</div>\n      </div>\n      ${validator}\n    `;\n  }\n\n  return html`\n    ${renderLabel(labelId, label)}\n    <div part=${partMap(containerParts)}>\n      ${renderPrefix()}${fileParts}${input}${renderSuffix()}\n    </div>\n    ${validator}\n  `;\n}\n"]}

package/{components/common → internals}/templates/masked-input.d.ts

@@ -1,4 +1,5 @@
 import { type TemplateResult } from 'lit';
+import { type ResolvedARIABindings } from '../controllers/aria-projection.js';
 export interface MaskedInputOptions {
     /** Optional id for the native input element. */
     id?: string;
@@ -16,11 +17,14 @@ export interface MaskedInputOptions {
     inputMode?: string;
     /** When provided, sets the `tabindex` attribute. */
     tabindex?: number;
-    /** When provided, sets the `aria-describedby` attribute. */
-    ariaDescribedBy?: string;
-    /** When provided, sets the `aria-labelledby` attribute using the provided elements. */
-    ariaLabelledByElements?: ReadonlyArray<Element> | null;
+    /**
+     * Resolved ARIA bindings for the native input - the projected host state
+     * merged with the editor's own (see `AriaTargetController.resolveBindings`).
+     */
+    aria: ResolvedARIABindings;
     onInput: (event: InputEvent) => void;
+    /** Wired to `beforeinput` so the component owns `historyUndo` / `historyRedo`. */
+    onBeforeInput: (event: InputEvent) => void;
     onFocus: (event: FocusEvent) => void;
     onBlur: (event: FocusEvent) => void;
     onClick: () => void;

package/{components/common → internals}/templates/masked-input.js

@@ -1,8 +1,9 @@
 import { html } from 'lit';
 import { ifDefined } from 'lit/directives/if-defined.js';
 import { live } from 'lit/directives/live.js';
+import { ariaBindings, } from '../controllers/aria-projection.js';
 import { partMap } from '../part-map.js';
-import { bindIf } from '../util.js';
+import { bindIf } from '../utils/lit.js';
 export function renderMaskedNativeInput(opts) {
     return html `
     <input
@@ -17,9 +18,9 @@ export function renderMaskedNativeInput(opts) {
       ?autofocus=${opts.autofocus}
       inputmode=${ifDefined(opts.inputMode)}
       tabindex=${bindIf(opts.tabindex != null, opts.tabindex)}
-      aria-describedby=${bindIf(!!opts.ariaDescribedBy, opts.ariaDescribedBy)}
-      .ariaLabelledByElements=${opts.ariaLabelledByElements ?? null}
+      ${ariaBindings(opts.aria)}
       @input=${opts.onInput}
+      @beforeinput=${opts.onBeforeInput}
       @focus=${opts.onFocus}
       @blur=${opts.onBlur}
       @click=${opts.onClick}

package/internals/templates/masked-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"masked-input.js","sourceRoot":"","sources":["../../../src/internals/templates/masked-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EACL,YAAY,GAEb,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAiDzC,MAAM,UAAU,uBAAuB,CACrC,IAAwB;IAExB,OAAO,IAAI,CAAA;;WAEF,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;;aAEhB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;aACvB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;eAClB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;qBACV,IAAI,CAAC,WAAW;kBACnB,IAAI,CAAC,QAAQ;kBACb,IAAI,CAAC,QAAQ;mBACZ,IAAI,CAAC,SAAS;kBACf,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;iBAC1B,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;QACrD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;eAChB,IAAI,CAAC,OAAO;qBACN,IAAI,CAAC,aAAa;eACxB,IAAI,CAAC,OAAO;cACb,IAAI,CAAC,MAAM;eACV,IAAI,CAAC,OAAO;iBACV,IAAI,CAAC,kBAAkB;aAC3B,IAAI,CAAC,kBAAkB;mBACjB,IAAI,CAAC,kBAAkB;0BAChB,IAAI,CAAC,kBAAkB;wBACzB,IAAI,CAAC,gBAAgB;gBAC7B,IAAI,CAAC,QAAQ;eACd,IAAI,CAAC,OAAO;mBACR,IAAI,CAAC,WAAW;mBAChB,IAAI,CAAC,WAAW;;GAEhC,CAAC;AACJ,CAAC","sourcesContent":["import { html, type TemplateResult } from 'lit';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { live } from 'lit/directives/live.js';\nimport {\n  ariaBindings,\n  type ResolvedARIABindings,\n} from '../controllers/aria-projection.js';\nimport { partMap } from '../part-map.js';\nimport { bindIf } from '../utils/lit.js';\n\nexport interface MaskedInputOptions {\n  /** Optional id for the native input element. */\n  id?: string;\n  /** Resolved part-name map applied to the input. */\n  partNames: Record<string, boolean>;\n  /** The form-associated name attribute. */\n  name?: string;\n  /** Current value to render through `live()`. */\n  value: string;\n  /** Pre-resolved placeholder text. Caller decides empty-string semantics. */\n  placeholder: string;\n  readOnly: boolean;\n  disabled: boolean;\n  autofocus?: boolean;\n  inputMode?: string;\n  /** When provided, sets the `tabindex` attribute. */\n  tabindex?: number;\n  /**\n   * Resolved ARIA bindings for the native input - the projected host state\n   * merged with the editor's own (see `AriaTargetController.resolveBindings`).\n   */\n  aria: ResolvedARIABindings;\n\n  // Required mask handlers\n  onInput: (event: InputEvent) => void;\n  /** Wired to `beforeinput` so the component owns `historyUndo` / `historyRedo`. */\n  onBeforeInput: (event: InputEvent) => void;\n  onFocus: (event: FocusEvent) => void;\n  onBlur: (event: FocusEvent) => void;\n  onClick: () => void;\n  /** Wired to `keydown`, `cut`, and `dragstart` to capture the current selection. */\n  onSetMaskSelection: (event: Event) => void;\n  onCompositionStart: () => void;\n  onCompositionEnd: (event: CompositionEvent) => void;\n\n  // Optional handlers\n  onChange?: () => void;\n  onWheel?: (event: WheelEvent) => void;\n  onDragEnter?: () => void;\n  onDragLeave?: () => void;\n}\n\n/**\n * Renders the native `<input>` element shared by mask-driven components\n * (`igc-mask-input`, `igc-date-time-input`, `igc-date-range-input`).\n * Centralizes mask event wiring so leaves only describe their extras.\n */\nexport function renderMaskedNativeInput(\n  opts: MaskedInputOptions\n): TemplateResult {\n  return html`\n    <input\n      id=${ifDefined(opts.id)}\n      type=\"text\"\n      part=${partMap(opts.partNames)}\n      name=${ifDefined(opts.name)}\n      .value=${live(opts.value)}\n      .placeholder=${opts.placeholder}\n      ?readonly=${opts.readOnly}\n      ?disabled=${opts.disabled}\n      ?autofocus=${opts.autofocus}\n      inputmode=${ifDefined(opts.inputMode)}\n      tabindex=${bindIf(opts.tabindex != null, opts.tabindex)}\n      ${ariaBindings(opts.aria)}\n      @input=${opts.onInput}\n      @beforeinput=${opts.onBeforeInput}\n      @focus=${opts.onFocus}\n      @blur=${opts.onBlur}\n      @click=${opts.onClick}\n      @keydown=${opts.onSetMaskSelection}\n      @cut=${opts.onSetMaskSelection}\n      @dragstart=${opts.onSetMaskSelection}\n      @compositionstart=${opts.onCompositionStart}\n      @compositionend=${opts.onCompositionEnd}\n      @change=${opts.onChange}\n      @wheel=${opts.onWheel}\n      @dragenter=${opts.onDragEnter}\n      @dragleave=${opts.onDragLeave}\n    />\n  `;\n}\n"]}

package/internals/templates/slotted-icon.d.ts

@@ -0,0 +1,32 @@
+import { type TemplateResult } from 'lit';
+import '../../components/icon/icon.js';
+export interface SlottedIconOptions {
+    /** The name of the slot that overrides the default icon. */
+    slot: string;
+    /** The registry name of the default icon rendered as fallback content. */
+    icon: string;
+    /** Controls the `hidden` attribute of the slot element. */
+    hidden?: boolean;
+    /** The `title` of the default icon. */
+    title?: string;
+    /**
+     * The accessible label of the default icon. When set, the icon is exposed
+     * to the accessibility tree with that label instead of being `aria-hidden`.
+     */
+    label?: string;
+    /**
+     * Whether an unlabeled default icon carries `aria-hidden="true"`.
+     * Pass false when an ancestor element already hides the icon from the
+     * accessibility tree.
+     *
+     * @default true
+     */
+    ariaHidden?: boolean;
+}
+/**
+ * Renders a named slot with a default icon from the internal collection as
+ * fallback content - the "overridable built-in control" idiom of the library.
+ * Callers own the wrapping element with its parts, visibility gating and
+ * event handlers, and must register the icon component themselves.
+ */
+export declare function renderSlottedIcon(options: SlottedIconOptions): TemplateResult;

package/internals/templates/slotted-icon.js

@@ -0,0 +1,19 @@
+import { html } from 'lit';
+import { ifDefined } from 'lit/directives/if-defined.js';
+import '../../components/icon/icon.js';
+import { bindIf } from '../utils/lit.js';
+export function renderSlottedIcon(options) {
+    const ariaHidden = options.label ? false : (options.ariaHidden ?? true);
+    return html `
+    <slot name=${options.slot} ?hidden=${options.hidden ?? false}>
+      <igc-icon
+        name=${options.icon}
+        collection="default"
+        title=${ifDefined(options.title)}
+        aria-label=${ifDefined(options.label)}
+        aria-hidden=${bindIf(ariaHidden, 'true')}
+      ></igc-icon>
+    </slot>
+  `;
+}
+//# sourceMappingURL=slotted-icon.js.map

package/internals/templates/slotted-icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotted-icon.js","sourceRoot":"","sources":["../../../src/internals/templates/slotted-icon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,+BAA+B,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAgCzC,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IAExE,OAAO,IAAI,CAAA;iBACI,OAAO,CAAC,IAAI,YAAY,OAAO,CAAC,MAAM,IAAI,KAAK;;eAEjD,OAAO,CAAC,IAAI;;gBAEX,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;qBACnB,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;sBACvB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC;;;GAG7C,CAAC;AACJ,CAAC","sourcesContent":["import { html, type TemplateResult } from 'lit';\nimport { ifDefined } from 'lit/directives/if-defined.js';\n// The import satisfies the lit-analyzer element resolution for `igc-icon`.\n// It carries no side effects - registration stays with the consuming components.\nimport '../../components/icon/icon.js';\nimport { bindIf } from '../utils/lit.js';\n\nexport interface SlottedIconOptions {\n  /** The name of the slot that overrides the default icon. */\n  slot: string;\n  /** The registry name of the default icon rendered as fallback content. */\n  icon: string;\n  /** Controls the `hidden` attribute of the slot element. */\n  hidden?: boolean;\n  /** The `title` of the default icon. */\n  title?: string;\n  /**\n   * The accessible label of the default icon. When set, the icon is exposed\n   * to the accessibility tree with that label instead of being `aria-hidden`.\n   */\n  label?: string;\n  /**\n   * Whether an unlabeled default icon carries `aria-hidden=\"true\"`.\n   * Pass false when an ancestor element already hides the icon from the\n   * accessibility tree.\n   *\n   * @default true\n   */\n  ariaHidden?: boolean;\n}\n\n/**\n * Renders a named slot with a default icon from the internal collection as\n * fallback content - the \"overridable built-in control\" idiom of the library.\n * Callers own the wrapping element with its parts, visibility gating and\n * event handlers, and must register the icon component themselves.\n */\nexport function renderSlottedIcon(options: SlottedIconOptions): TemplateResult {\n  const ariaHidden = options.label ? false : (options.ariaHidden ?? true);\n\n  return html`\n    <slot name=${options.slot} ?hidden=${options.hidden ?? false}>\n      <igc-icon\n        name=${options.icon}\n        collection=\"default\"\n        title=${ifDefined(options.title)}\n        aria-label=${ifDefined(options.label)}\n        aria-hidden=${bindIf(ariaHidden, 'true')}\n      ></igc-icon>\n    </slot>\n  `;\n}\n"]}

package/internals/templates/toggle-shell.d.ts

@@ -0,0 +1,46 @@
+import { type TemplateResult } from 'lit';
+export interface ToggleShellOptions {
+    /** The type of the native input element. */
+    type: 'checkbox' | 'radio';
+    /** The id of the native input; the wrapping label points at it through `for`. */
+    inputId: string;
+    /** The id of the label span, the fallback `aria-labelledby` target. */
+    labelId: string;
+    /** Resolved part-name map for the wrapping label element. */
+    baseParts: Record<string, boolean>;
+    /** Resolved part-name map for the control span. */
+    controlParts: Record<string, boolean>;
+    /** Resolved part-name map for the label span. */
+    labelParts: Record<string, boolean>;
+    /** Renders the control indicator inside the control span. */
+    renderControl: () => TemplateResult;
+    /** Current checked state rendered through `live()`. */
+    checked: boolean;
+    /** Hides the label span when the default slot has no assigned content. */
+    hideLabel: boolean;
+    name?: string;
+    value?: string;
+    required: boolean;
+    disabled: boolean;
+    /**
+     * Current indeterminate state rendered through `live()`. When absent, the
+     * binding stays `false` and `live()` skips the property write entirely.
+     */
+    indeterminate?: boolean;
+    /** When provided, sets the `tabindex` attribute. */
+    tabindex?: number;
+    /** Resolved `aria-labelledby` target - an external id or `labelId`. */
+    ariaLabelledBy: string;
+    /** When provided, sets the `aria-describedby` attribute. */
+    ariaDescribedBy?: string;
+    onClick: (event: PointerEvent) => void;
+    onKeyDown: (event: KeyboardEvent) => void;
+    onBlur?: () => void;
+}
+/**
+ * Renders the label-wrapped native input shared by the toggle controls
+ * (`igc-checkbox`, `igc-switch`, `igc-radio`).
+ * Centralizes the input binding set so leaves only describe their part maps
+ * and control indicator.
+ */
+export declare function renderToggleShell(options: ToggleShellOptions): TemplateResult;

package/internals/templates/toggle-shell.js

@@ -0,0 +1,38 @@
+import { html, nothing } from 'lit';
+import { ifDefined } from 'lit/directives/if-defined.js';
+import { live } from 'lit/directives/live.js';
+import { partMap } from '../part-map.js';
+import { bindIf } from '../utils/lit.js';
+export function renderToggleShell(options) {
+    return html `
+    <label part=${partMap(options.baseParts)} for=${options.inputId}>
+      <input
+        id=${options.inputId}
+        type=${options.type}
+        name=${ifDefined(options.name)}
+        value=${ifDefined(options.value)}
+        ?required=${options.required}
+        ?disabled=${options.disabled}
+        .checked=${live(options.checked)}
+        .indeterminate=${live(options.indeterminate ?? false)}
+        tabindex=${bindIf(options.tabindex != null, options.tabindex)}
+        aria-labelledby=${options.ariaLabelledBy}
+        aria-describedby=${ifDefined(options.ariaDescribedBy)}
+        @keydown=${options.onKeyDown}
+        @click=${options.onClick}
+        @blur=${options.onBlur ?? nothing}
+      />
+      <span part=${partMap(options.controlParts)}
+        >${options.renderControl()}</span
+      >
+      <span
+        id=${options.labelId}
+        part=${partMap(options.labelParts)}
+        ?hidden=${options.hideLabel}
+      >
+        <slot></slot>
+      </span>
+    </label>
+  `;
+}
+//# sourceMappingURL=toggle-shell.js.map

package/internals/templates/toggle-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-shell.js","sourceRoot":"","sources":["../../../src/internals/templates/toggle-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAgDzC,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,OAAO,IAAI,CAAA;kBACK,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,OAAO,CAAC,OAAO;;aAEtD,OAAO,CAAC,OAAO;eACb,OAAO,CAAC,IAAI;eACZ,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;gBACtB,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;oBACpB,OAAO,CAAC,QAAQ;oBAChB,OAAO,CAAC,QAAQ;mBACjB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;yBACf,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;mBAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC;0BAC3C,OAAO,CAAC,cAAc;2BACrB,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC;mBAC1C,OAAO,CAAC,SAAS;iBACnB,OAAO,CAAC,OAAO;gBAChB,OAAO,CAAC,MAAM,IAAI,OAAO;;mBAEtB,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;WACrC,OAAO,CAAC,aAAa,EAAE;;;aAGrB,OAAO,CAAC,OAAO;eACb,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;kBACxB,OAAO,CAAC,SAAS;;;;;GAKhC,CAAC;AACJ,CAAC","sourcesContent":["import { html, nothing, type TemplateResult } from 'lit';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { live } from 'lit/directives/live.js';\nimport { partMap } from '../part-map.js';\nimport { bindIf } from '../utils/lit.js';\n\nexport interface ToggleShellOptions {\n  /** The type of the native input element. */\n  type: 'checkbox' | 'radio';\n  /** The id of the native input; the wrapping label points at it through `for`. */\n  inputId: string;\n  /** The id of the label span, the fallback `aria-labelledby` target. */\n  labelId: string;\n  /** Resolved part-name map for the wrapping label element. */\n  baseParts: Record<string, boolean>;\n  /** Resolved part-name map for the control span. */\n  controlParts: Record<string, boolean>;\n  /** Resolved part-name map for the label span. */\n  labelParts: Record<string, boolean>;\n  /** Renders the control indicator inside the control span. */\n  renderControl: () => TemplateResult;\n  /** Current checked state rendered through `live()`. */\n  checked: boolean;\n  /** Hides the label span when the default slot has no assigned content. */\n  hideLabel: boolean;\n  name?: string;\n  value?: string;\n  required: boolean;\n  disabled: boolean;\n  /**\n   * Current indeterminate state rendered through `live()`. When absent, the\n   * binding stays `false` and `live()` skips the property write entirely.\n   */\n  indeterminate?: boolean;\n  /** When provided, sets the `tabindex` attribute. */\n  tabindex?: number;\n  /** Resolved `aria-labelledby` target - an external id or `labelId`. */\n  ariaLabelledBy: string;\n  /** When provided, sets the `aria-describedby` attribute. */\n  ariaDescribedBy?: string;\n\n  onClick: (event: PointerEvent) => void;\n  onKeyDown: (event: KeyboardEvent) => void;\n  onBlur?: () => void;\n}\n\n/**\n * Renders the label-wrapped native input shared by the toggle controls\n * (`igc-checkbox`, `igc-switch`, `igc-radio`).\n * Centralizes the input binding set so leaves only describe their part maps\n * and control indicator.\n */\nexport function renderToggleShell(options: ToggleShellOptions): TemplateResult {\n  return html`\n    <label part=${partMap(options.baseParts)} for=${options.inputId}>\n      <input\n        id=${options.inputId}\n        type=${options.type}\n        name=${ifDefined(options.name)}\n        value=${ifDefined(options.value)}\n        ?required=${options.required}\n        ?disabled=${options.disabled}\n        .checked=${live(options.checked)}\n        .indeterminate=${live(options.indeterminate ?? false)}\n        tabindex=${bindIf(options.tabindex != null, options.tabindex)}\n        aria-labelledby=${options.ariaLabelledBy}\n        aria-describedby=${ifDefined(options.ariaDescribedBy)}\n        @keydown=${options.onKeyDown}\n        @click=${options.onClick}\n        @blur=${options.onBlur ?? nothing}\n      />\n      <span part=${partMap(options.controlParts)}\n        >${options.renderControl()}</span\n      >\n      <span\n        id=${options.labelId}\n        part=${partMap(options.labelParts)}\n        ?hidden=${options.hideLabel}\n      >\n        <slot></slot>\n      </span>\n    </label>\n  `;\n}\n"]}

package/internals/timing.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A restartable timeout handle. See {@link createTimer}.
+ */
+export type Timer = {
+    /** Whether the timer is currently armed. */
+    readonly active: boolean;
+    /**
+     * (Re)arms the timer, canceling a previously armed run.
+     *
+     * When `delay` is omitted, the default delay of the timer is used.
+     */
+    start(delay?: number): void;
+    /** Cancels the armed run, if any. */
+    stop(): void;
+};
+/**
+ * Creates a restartable timeout around `callback`.
+ *
+ * Every `start` supersedes the previous one, so the callback runs at most once,
+ * `delay` milliseconds after the most recent `start` - the recurring
+ * "clear the stored handle, then set it again" bookkeeping is kept in one place.
+ *
+ * @example
+ * ```typescript
+ * const timer = createTimer(() => this.hideTooltip(), 500);
+ *
+ * timer.start(); // arms the timer with the default delay
+ * timer.start(1000); // supersedes the run above
+ * timer.stop(); // cancels it altogether
+ * ```
+ */
+export declare function createTimer(callback: () => void, defaultDelay?: number): Timer;

package/internals/timing.js

@@ -0,0 +1,20 @@
+export function createTimer(callback, defaultDelay = 0) {
+    let handle;
+    return {
+        get active() {
+            return handle !== undefined;
+        },
+        start(delay = defaultDelay) {
+            clearTimeout(handle);
+            handle = setTimeout(() => {
+                handle = undefined;
+                callback();
+            }, delay);
+        },
+        stop() {
+            clearTimeout(handle);
+            handle = undefined;
+        },
+    };
+}
+//# sourceMappingURL=timing.js.map

package/internals/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/internals/timing.ts"],"names":[],"mappings":"AAgCA,MAAM,UAAU,WAAW,CAAC,QAAoB,EAAE,YAAY,GAAG,CAAC;IAChE,IAAI,MAAiD,CAAC;IAEtD,OAAO;QACL,IAAI,MAAM;YACR,OAAO,MAAM,KAAK,SAAS,CAAC;QAC9B,CAAC;QACD,KAAK,CAAC,KAAK,GAAG,YAAY;YACxB,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;gBACvB,MAAM,GAAG,SAAS,CAAC;gBACnB,QAAQ,EAAE,CAAC;YACb,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC;QACD,IAAI;YACF,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * A restartable timeout handle. See {@link createTimer}.\n */\nexport type Timer = {\n  /** Whether the timer is currently armed. */\n  readonly active: boolean;\n  /**\n   * (Re)arms the timer, canceling a previously armed run.\n   *\n   * When `delay` is omitted, the default delay of the timer is used.\n   */\n  start(delay?: number): void;\n  /** Cancels the armed run, if any. */\n  stop(): void;\n};\n\n/**\n * Creates a restartable timeout around `callback`.\n *\n * Every `start` supersedes the previous one, so the callback runs at most once,\n * `delay` milliseconds after the most recent `start` - the recurring\n * \"clear the stored handle, then set it again\" bookkeeping is kept in one place.\n *\n * @example\n * ```typescript\n * const timer = createTimer(() => this.hideTooltip(), 500);\n *\n * timer.start(); // arms the timer with the default delay\n * timer.start(1000); // supersedes the run above\n * timer.stop(); // cancels it altogether\n * ```\n */\nexport function createTimer(callback: () => void, defaultDelay = 0): Timer {\n  let handle: ReturnType<typeof setTimeout> | undefined;\n\n  return {\n    get active(): boolean {\n      return handle !== undefined;\n    },\n    start(delay = defaultDelay): void {\n      clearTimeout(handle);\n      handle = setTimeout(() => {\n        handle = undefined;\n        callback();\n      }, delay);\n    },\n    stop(): void {\n      clearTimeout(handle);\n      handle = undefined;\n    },\n  };\n}\n"]}

package/internals/utils/arrays.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Returns the first element of the given array.
+ *
+ * @remarks
+ * Assumes a non-empty array - for an empty one it returns `undefined`
+ * typed as `T`.
+ */
+export declare function firstOf<T>(arr: T[]): T;
+/**
+ * Returns the last element of the given array.
+ *
+ * @remarks
+ * Assumes a non-empty array - for an empty one it returns `undefined`
+ * typed as `T`.
+ */
+export declare function lastOf<T>(arr: T[]): T;
+/**
+ * Splits an array into chunks of a specified size and returns a generator that yields each chunk.
+ *
+ * @example
+ * ```typescript
+ * [...chunk([1, 2, 3, 4, 5], 2)]; // [[1, 2], [3, 4], [5]]
+ * ```
+ *
+ * @throws If the `size` parameter is not a safe integer greater than or equal to 1.
+ */
+export declare function chunk<T>(arr: T[], size: number): Generator<T[]>;
+/**
+ * Returns whether a given collection is empty.
+ */
+export declare function isEmpty<T, U extends object>(x: ArrayLike<T> | Set<T> | Map<U, T>): boolean;
+/**
+ * Ensures the given value is wrapped in an array. If the value is already an array, it is returned as-is. If the value is undefined, an empty array is returned.
+ *
+ * @example
+ * ```typescript
+ * asArray(5); // [5]
+ * asArray([1, 2, 3]); // [1, 2, 3]
+ * asArray(undefined); // []
+ * ```
+ */
+export declare function asArray<T>(value?: T | T[]): T[];
+/**
+ * Splits an array into two based on a predicate function, returning a tuple of [truthy, falsy] arrays.
+ *
+ * @example
+ * ```typescript
+ * const [evens, odds] = partition([1, 2, 3, 4], x => x % 2 === 0);
+ * console.log(evens); // [2, 4]
+ * console.log(odds); // [1, 3]
+ * ```
+ */
+export declare function partition<T>(array: T[], isTruthy: (value: T) => boolean): [truthy: T[], falsy: T[]];

package/internals/utils/arrays.js

@@ -0,0 +1,31 @@
+export function firstOf(arr) {
+    return arr.at(0);
+}
+export function lastOf(arr) {
+    return arr.at(-1);
+}
+export function* chunk(arr, size) {
+    if (!Number.isSafeInteger(size) || size < 1) {
+        throw new Error('size must be an integer >= 1');
+    }
+    for (let i = 0; i < arr.length; i += size) {
+        yield arr.slice(i, i + size);
+    }
+}
+export function isEmpty(x) {
+    return 'length' in x ? x.length < 1 : x.size < 1;
+}
+export function asArray(value) {
+    if (value == null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+export function partition(array, isTruthy) {
+    const truthy = [];
+    const falsy = [];
+    for (const item of array) {
+        (isTruthy(item) ? truthy : falsy).push(item);
+    }
+    return [truthy, falsy];
+}
+//# sourceMappingURL=arrays.js.map

package/internals/utils/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../../src/internals/utils/arrays.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,OAAO,CAAI,GAAQ;IACjC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAM,CAAC;AACxB,CAAC;AASD,MAAM,UAAU,MAAM,CAAI,GAAQ;IAChC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAM,CAAC;AACzB,CAAC;AAYD,MAAM,SAAS,CAAC,CAAC,KAAK,CAAI,GAAQ,EAAE,IAAY;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,OAAO,CACrB,CAAoC;IAEpC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;AACnD,CAAC;AAYD,MAAM,UAAU,OAAO,CAAI,KAAe;IACxC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAYD,MAAM,UAAU,SAAS,CACvB,KAAU,EACV,QAA+B;IAE/B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,KAAK,GAAQ,EAAE,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC","sourcesContent":["/**\n * Returns the first element of the given array.\n *\n * @remarks\n * Assumes a non-empty array - for an empty one it returns `undefined`\n * typed as `T`.\n */\nexport function firstOf<T>(arr: T[]) {\n  return arr.at(0) as T;\n}\n\n/**\n * Returns the last element of the given array.\n *\n * @remarks\n * Assumes a non-empty array - for an empty one it returns `undefined`\n * typed as `T`.\n */\nexport function lastOf<T>(arr: T[]) {\n  return arr.at(-1) as T;\n}\n\n/**\n * Splits an array into chunks of a specified size and returns a generator that yields each chunk.\n *\n * @example\n * ```typescript\n * [...chunk([1, 2, 3, 4, 5], 2)]; // [[1, 2], [3, 4], [5]]\n * ```\n *\n * @throws If the `size` parameter is not a safe integer greater than or equal to 1.\n */\nexport function* chunk<T>(arr: T[], size: number): Generator<T[]> {\n  if (!Number.isSafeInteger(size) || size < 1) {\n    throw new Error('size must be an integer >= 1');\n  }\n\n  for (let i = 0; i < arr.length; i += size) {\n    yield arr.slice(i, i + size);\n  }\n}\n\n/**\n * Returns whether a given collection is empty.\n */\nexport function isEmpty<T, U extends object>(\n  x: ArrayLike<T> | Set<T> | Map<U, T>\n): boolean {\n  return 'length' in x ? x.length < 1 : x.size < 1;\n}\n\n/**\n * Ensures the given value is wrapped in an array. If the value is already an array, it is returned as-is. If the value is undefined, an empty array is returned.\n *\n * @example\n * ```typescript\n * asArray(5); // [5]\n * asArray([1, 2, 3]); // [1, 2, 3]\n * asArray(undefined); // []\n * ```\n */\nexport function asArray<T>(value?: T | T[]): T[] {\n  if (value == null) return [];\n  return Array.isArray(value) ? value : [value];\n}\n\n/**\n * Splits an array into two based on a predicate function, returning a tuple of [truthy, falsy] arrays.\n *\n * @example\n * ```typescript\n * const [evens, odds] = partition([1, 2, 3, 4], x => x % 2 === 0);\n * console.log(evens); // [2, 4]\n * console.log(odds); // [1, 3]\n * ```\n */\nexport function partition<T>(\n  array: T[],\n  isTruthy: (value: T) => boolean\n): [truthy: T[], falsy: T[]] {\n  const truthy: T[] = [];\n  const falsy: T[] = [];\n\n  for (const item of array) {\n    (isTruthy(item) ? truthy : falsy).push(item);\n  }\n\n  return [truthy, falsy];\n}\n"]}

package/internals/utils/dom.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Returns whether an element has a Left-to-Right directionality.
+ */
+export declare function isLTR(element: HTMLElement): boolean;
+/**
+ * Resolves a CSS length to pixels in the context of `element`.
+ *
+ * A registered custom property computes to an absolute length, which lets the
+ * browser do the conversion for font, viewport and container relative units
+ * instead of them being read as raw numbers. Percentages are not lengths -
+ * resolve those against whatever basis applies to the property at hand.
+ *
+ * Returns 0 for percentages, for values that are not valid lengths, and where
+ * the resolution is unavailable - during server-side rendering, or without
+ * support for registered custom properties. Guessing from the raw token would
+ * read `5rem` as 5 pixels, so callers get an obvious zero instead.
+ *
+ * @example
+ * ```typescript
+ * resolveCssLength(element, '5rem'); // 80
+ * resolveCssLength(element, '2em'); // 2 x the element font size
+ * ```
+ */
+export declare function resolveCssLength(element: HTMLElement, value: string): number;
+export type IterNodesOptions<T = Node> = {
+    show?: keyof typeof NodeFilter;
+    filter?: (node: T) => boolean;
+};
+/**
+ * Iterates over the DOM subtree of `root` in document order, yielding the nodes
+ * matching the passed {@link IterNodesOptions | options}.
+ *
+ * @example
+ * ```typescript
+ * for (const button of iterNodes<HTMLButtonElement>(root, { show: 'SHOW_ELEMENT', filter: isButton })) { ... }
+ * ```
+ */
+export declare function iterNodes<T extends Node>(root: Node, options?: IterNodesOptions<T>): Generator<T>;
+/**
+ * Iterates over `node` and its ancestors, crossing shadow DOM boundaries.
+ *
+ * Shadow roots are traversed through their host, so only elements are yielded.
+ *
+ * @example
+ * ```typescript
+ * for (const ancestor of iterAncestors(element)) { ... }
+ * ```
+ */
+export declare function iterAncestors(node?: Node | null): Generator<Element>;
+/** Returns the root node (document or shadow root) of the given element. */
+export declare function getRoot(element: Element, options?: GetRootNodeOptions): Document | ShadowRoot;
+/** Returns the element with the given id in the root node of `root`, if any. */
+export declare function getElementByIdFromRoot(root: HTMLElement, id: string): HTMLElement | null;
+export declare function isElement(node: unknown): node is Element;
+export declare function isDocument(node: unknown): node is Document;
+/** Returns the center x/y coordinate of a given element. */
+export declare function getCenterPoint(element: Element): {
+    x: number;
+    y: number;
+};
+/**
+ * Maps a pointer's `clientX` coordinate to a fraction in the [0, 1] range of the
+ * element's bounding box width, measured from the element's logical start edge -
+ * the left edge when `ltr` is true, the right one otherwise.
+ *
+ * Returns 0 for an element without layout.
+ *
+ * @example
+ * ```typescript
+ * // Pointer 30px into a 120px wide element
+ * pointToFraction(element, event.clientX); // 0.25
+ * pointToFraction(element, event.clientX, false); // 0.75
+ * ```
+ */
+export declare function pointToFraction(element: Element, clientX: number, ltr?: boolean): number;
+/**
+ * Concatenates the text content of the given nodes into a single string,
+ * trimmed and with consecutive whitespace collapsed.
+ *
+ * Useful for deriving an accessible label from projected content.
+ */
+export declare function normalizedTextContent(nodes: Iterable<Node>): string;
+/** Returns whether the given client coordinates lie within the bounding box of the element. */
+export declare function isPointInsideElement(element: Element, x: number, y: number): boolean;
+/** Returns the scale factor of a given element based on its bounding client rect and offset dimensions. */
+export declare function getScaleFactor(element: HTMLElement): {
+    x: number;
+    y: number;
+};
+/** Rounds a CSS pixel value to the closest device-pixel boundary to avoid blurry rendering. */
+export declare function roundByDPR(value: number): number;
+/** Null-safe `Element.scrollIntoView` defaulting to the nearest block/inline position. */
+export declare function scrollIntoView(element?: HTMLElement | null, config?: ScrollIntoViewOptions): void;
+/** Applies the given CSS declarations to the inline style of the element. */
+export declare function setStyles(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
+/** Returns whether the given input has at least one selected file. */
+export declare function hasFiles(input: {
+    files: FileList | null;
+}): boolean;
+/**
+ * Returns whether the given element is currently an open popover or not.
+ * This is useful to determine if the popover is open without relying on the `open` property, which may not be in sync with the actual popover state if the opening/closing animations are still running.
+ * Note: This function only works for elements that use the `:popover-open` pseudo-class to indicate
+ */
+export declare function isPopoverOpen(element?: Element): boolean;
+/**
+ * Returns whether the given element, or any of its ancestors across shadow DOM
+ * boundaries, is positioned as `sticky`.
+ */
+export declare function hasStickyAncestor(element: Element): boolean;
+/**
+ * Returns the nearest visible ancestor of a given node, traversing through shadow DOM boundaries if necessary. If no visible ancestor is found, returns null.
+ */
+export declare function getVisibleAncestor(startNode: Node): HTMLElement | null;