igniteui-webcomponents 7.2.4 → 7.3.0-beta.0

package/internals/mixins/mask-behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-behavior.js","sourceRoot":"","sources":["../../../src/internals/mixins/mask-behavior.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LitElement } from 'lit';\nimport { property, state } from 'lit/decorators.js';\nimport {\n  createMaskHistory,\n  type MaskEditKind,\n  type MaskHistory,\n  type MaskHistoryState,\n} from '../../components/mask-input/mask-history.js';\nimport type { MaskParser } from '../../components/mask-input/mask-parser.js';\nimport type {\n  RangeTextSelectMode,\n  SelectionRangeDirection,\n} from '../../components/types.js';\nimport {\n  addKeybindings,\n  ctrlKey,\n  metaKey,\n  shiftKey,\n} from '../controllers/key-bindings.js';\nimport type { AbstractConstructor } from './constructor.js';\n\nexport type MaskSelection = {\n  start: number;\n  end: number;\n};\n\n/**\n * The `inputType` values the mask editor models, mapped to their undo granularity.\n *\n * Anything absent is a native mutation we do not model - auto-fill is the empty-string\n * entry, `deleteWordBackward` and friends are simply not handled.\n */\nconst MaskEditKinds = new Map<string, MaskEditKind>([\n  ['insertText', 'insert'],\n  ['deleteContentBackward', 'delete-backward'],\n  ['deleteContentForward', 'delete-forward'],\n  ['deleteByCut', 'atomic'],\n  ['insertFromPaste', 'atomic'],\n  ['insertFromDrop', 'atomic'],\n  ['', 'atomic'],\n]);\n\n/**\n * Public + protected interface contributed by {@link MaskBehaviorMixin}.\n * Declared as a `declare class` so consumers can see protected members through\n * the cast return type (mirrors the pattern used by the form-associated mixins).\n */\nexport declare class MaskBehaviorElementInterface {\n  //#region Required from host\n\n  protected readonly _input?: HTMLInputElement;\n  protected readonly _parser: MaskParser;\n\n  /** Reflects the current parser state into the host's public value. */\n  protected _syncValueFromMask(): void;\n\n  /** Delegates Enter-key handling to the form-associated base. */\n  protected _handleEnterKeydown(event: KeyboardEvent): void;\n\n  //#endregion\n\n  //#region Internal state\n\n  protected _maskSelection: MaskSelection;\n  protected _compositionStart: number;\n  protected _focused: boolean;\n  protected _maskedValue: string;\n  protected readonly _history: MaskHistory;\n\n  protected get _inputSelection(): MaskSelection;\n  protected get _isEmptyMask(): boolean;\n  protected get _historyText(): string;\n\n  //#endregion\n\n  //#region Public attributes and properties\n\n  /**\n   * Makes the control a readonly field.\n   * @attr readonly\n   * @default false\n   */\n  public readOnly: boolean;\n\n  /**\n   * The mask pattern of the component.\n   * @attr\n   */\n  public get mask(): string;\n  public set mask(value: string);\n\n  /**\n   * The prompt symbol to use for unfilled parts of the mask pattern.\n   * @attr\n   * @default '_'\n   */\n  public get prompt(): string;\n  public set prompt(value: string);\n\n  //#endregion\n\n  //#region Event handlers\n\n  protected _handleInput(event: InputEvent): Promise<void>;\n  protected _handleBeforeInput(event: InputEvent): void;\n  protected _updateInput(text: string, range: MaskSelection): Promise<void>;\n  protected _commitMaskedValue(value: string): void;\n  protected _emitInputEvent(): void;\n  protected _setMaskSelection(event: Event): void;\n  protected _handleCompositionStart(): void;\n  protected _handleCompositionEnd(event: CompositionEvent): void;\n  protected _handleClick(): void;\n\n  //#endregion\n\n  //#region Undo/redo\n\n  protected _recordHistory(\n    kind: MaskEditKind,\n    next: string,\n    caret: number,\n    selection?: MaskSelection\n  ): void;\n\n  protected _historyStep(direction: 'undo' | 'redo'): Promise<void>;\n  protected _historyResync(): void;\n\n  //#endregion\n\n  //#region Public methods\n\n  /** Sets the text selection range of the control. */\n  public setSelectionRange(\n    start?: number,\n    end?: number,\n    direction?: SelectionRangeDirection\n  ): void;\n\n  /** Replaces the selected text in the control and re-applies the mask. */\n  public setRangeText(\n    replacement: string,\n    start?: number,\n    end?: number,\n    selectMode?: RangeTextSelectMode\n  ): void;\n\n  //#endregion\n}\n\n/**\n * Adds masked-input behavior (parser-driven editing, selection tracking,\n * composition handling, range text replacement) to a LitElement-derived class.\n *\n * The host class is expected to provide:\n * - `_input`            – the native `<input>` element (typically via `@query('input')`).\n * - `_parser`           – a {@link MaskParser} (or subclass) instance.\n * - `_setTouchedState`  – from `FormAssociatedMixin`.\n * - `emitEvent`         – from `EventEmitterMixin`.\n * - `select`            – from the host base.\n *\n * The host class must implement `_syncValueFromMask` to bridge the masked\n * text back into its public `value`. It is called by the default\n * `_commitMaskedValue` implementation.\n */\nexport function MaskBehaviorMixin<T extends AbstractConstructor<LitElement>>(\n  superClass: T\n): AbstractConstructor<MaskBehaviorElementInterface> & T {\n  abstract class MaskBehaviorElement extends superClass {\n    //#region Required from host\n\n    protected abstract readonly _input?: HTMLInputElement;\n    protected abstract readonly _parser: MaskParser;\n    protected abstract _setTouchedState(): void;\n    public abstract select(): void;\n    public abstract emitEvent(name: string, init?: CustomEventInit): boolean;\n\n    protected abstract _syncValueFromMask(): void;\n    protected abstract _handleEnterKeydown(event: KeyboardEvent): void;\n\n    //#endregion\n\n    //#region Internal state\n\n    protected _maskSelection: MaskSelection = { start: 0, end: 0 };\n    protected _compositionStart = 0;\n\n    /**\n     * The signature is the source pattern rather than the escaped one: the date parsers\n     * convert a date format into mask flags, so `MM/dd/yyyy` and `dd/MM/yyyy` share an\n     * escaped mask of `00/00/0000` while meaning entirely different things.\n     */\n    protected readonly _history = createMaskHistory(\n      () => `${this._parser.mask} ${this._parser.prompt}`\n    );\n\n    @state()\n    protected _focused = false;\n\n    @state()\n    protected _maskedValue = '';\n\n    protected get _inputSelection(): MaskSelection {\n      return {\n        start: this._input?.selectionStart || 0,\n        end: this._input?.selectionEnd || 0,\n      };\n    }\n\n    /** Indicates whether the current mask value is empty. */\n    protected get _isEmptyMask(): boolean {\n      return this._maskedValue === this._parser.emptyMask;\n    }\n\n    /**\n     * The masked text as the undo history sees it. `igc-mask-input` blanks it on blur and\n     * restores the empty mask on focus; both spell the same empty document, so without\n     * this normalization every focus of an empty editor would look like a foreign change.\n     */\n    protected get _historyText(): string {\n      return this._maskedValue || this._parser.emptyMask;\n    }\n\n    //#endregion\n\n    //#region Lifecycle\n\n    constructor(...args: any[]) {\n      super(...args);\n\n      // Assigning `input.value` - which every masked edit does - clears the browser's\n      // own undo stack, so the standard shortcuts have to be served from `_history`.\n      // The IME owns the text until `compositionend`, hence the `isComposing` guard.\n      const step =\n        (direction: 'undo' | 'redo') =>\n        (event: KeyboardEvent): void => {\n          if (!event.isComposing) {\n            this._historyStep(direction);\n          }\n        };\n\n      addKeybindings(this, {\n        skip: () => this.readOnly,\n        bindingDefaults: { repeat: true },\n      })\n        .set([ctrlKey, 'z'], step('undo'))\n        .set([metaKey, 'z'], step('undo'))\n        .set([ctrlKey, 'y'], step('redo'))\n        .set([ctrlKey, shiftKey, 'z'], step('redo'))\n        .set([metaKey, shiftKey, 'z'], step('redo'));\n    }\n\n    //#endregion\n\n    //#region Public attributes and properties\n\n    /**\n     * Makes the control a readonly field.\n     *\n     * @attr readonly\n     * @default false\n     */\n    @property({ type: Boolean, reflect: true })\n    public readOnly = false;\n\n    /**\n     * The mask pattern of the component.\n     *\n     * @attr\n     */\n    @property()\n    public set mask(value: string) {\n      this._parser.mask = value;\n    }\n\n    public get mask(): string {\n      return this._parser.mask;\n    }\n\n    /**\n     * The prompt symbol to use for unfilled parts of the mask pattern.\n     *\n     * @attr\n     * @default '_'\n     */\n    @property()\n    public set prompt(value: string) {\n      this._parser.prompt = value;\n    }\n\n    public get prompt(): string {\n      return this._parser.prompt;\n    }\n\n    //#endregion\n\n    //#region Event handlers\n\n    protected async _handleInput({\n      inputType,\n      isComposing,\n    }: InputEvent): Promise<void> {\n      const value = this._input?.value ?? '';\n      const { start, end } = this._maskSelection;\n      const deletePosition = this._parser.getNextNonLiteralPosition(end) + 1;\n\n      // Reachable only where `beforeinput` is not cancelable - normally the browser's\n      // history commands are intercepted before they ever mutate the input.\n      if (inputType === 'historyUndo' || inputType === 'historyRedo') {\n        return this._historyStep(inputType === 'historyUndo' ? 'undo' : 'redo');\n      }\n\n      // A composing backspace is handled by the composition events instead.\n      if (inputType === 'deleteContentBackward' && isComposing) {\n        return;\n      }\n\n      const kind = MaskEditKinds.get(inputType ?? '');\n\n      if (kind === undefined) {\n        // A non-modeled mutation has already changed the input's DOM value, so re-render\n        // to let the `live()` binding roll it back to the masked text. Never mid-IME\n        // though - `insertCompositionText` fires repeatedly there and resetting the value\n        // underneath the browser breaks composition outright.\n        if (!isComposing) {\n          this.requestUpdate();\n        }\n        return;\n      }\n\n      this._setTouchedState();\n\n      switch (inputType) {\n        case 'deleteContentForward': {\n          await this._updateInput('', { start, end: deletePosition }, kind);\n          this._input?.setSelectionRange(deletePosition, deletePosition);\n          // `_updateInput` settled on the parser's cursor, but the caret actually ends up\n          // past the deleted character - record that so a run of deletes coalesces.\n          this._history.settle(this._historyText, deletePosition);\n          return;\n        }\n\n        case 'deleteContentBackward':\n          return this._updateInput(\n            '',\n            {\n              start: this._parser.getPreviousNonLiteralPosition(\n                this._inputSelection.start + 1\n              ),\n              end,\n            },\n            kind\n          );\n\n        case 'deleteByCut':\n          return this._updateInput('', this._maskSelection, kind);\n\n        case 'insertText':\n          return this._updateInput(\n            value.substring(start, this._inputSelection.end),\n            this._maskSelection,\n            kind\n          );\n\n        case 'insertFromPaste':\n          return this._updateInput(\n            value.substring(start, this._inputSelection.end),\n            {\n              start,\n              end: this._inputSelection.start,\n            },\n            kind\n          );\n\n        case 'insertFromDrop':\n          // An external drop is preceded by no `dragstart`, so `_maskSelection` is stale.\n          return this._updateInput(\n            value.substring(\n              this._inputSelection.start,\n              this._inputSelection.end\n            ),\n            { ...this._inputSelection },\n            kind,\n            {\n              start: this._inputSelection.start,\n              end: this._inputSelection.start,\n            }\n          );\n\n        // Potential browser auto-fill behavior\n        case undefined:\n        case '':\n          return this._updateInput(\n            this._parser.parse(\n              value.substring(start, this._inputSelection.end)\n            ),\n            {\n              start,\n              end: this._inputSelection.end,\n            },\n            kind,\n            { start, end: start }\n          );\n      }\n    }\n\n    /**\n     * Default mask-update routine. Re-applies the parser, commits the result through\n     * {@link MaskBehaviorElementInterface._commitMaskedValue} and emits an input event\n     * when the edit is not at the trailing mask boundary.\n     */\n    protected async _updateInput(\n      text: string,\n      range: MaskSelection,\n      kind: MaskEditKind = 'atomic',\n      caretBefore?: MaskSelection\n    ): Promise<void> {\n      const { value, end } = this._parser.replace(\n        this._maskedValue,\n        text,\n        range.start,\n        range.end\n      );\n\n      this._recordHistory(kind, value, end, caretBefore ?? this._maskSelection);\n      this._commitMaskedValue(value);\n      this.requestUpdate();\n\n      if (range.start !== this._parser.mask.length) {\n        this._emitInputEvent();\n      }\n\n      await this.updateComplete;\n      this._input?.setSelectionRange(end, end);\n    }\n\n    /**\n     * Writes a fully-formed masked text into the component's value pipeline.\n     *\n     * This is the one step where the leaves genuinely differ - `igc-mask-input` commits\n     * straight to its form value, while the date editors keep the text as a draft until\n     * blur - so it is also the only thing undo/redo has to delegate.\n     */\n    protected _commitMaskedValue(value: string): void {\n      this._maskedValue = value;\n      this._syncValueFromMask();\n    }\n\n    /**\n     * Emits an `igcInput` event with the current masked value as detail.\n     * Override to emit a different payload (e.g. the parsed value).\n     */\n    protected _emitInputEvent(): void {\n      this._setTouchedState();\n      this.emitEvent('igcInput', { detail: this._maskedValue });\n    }\n\n    protected _setMaskSelection(event: Event): void {\n      this._maskSelection = this._inputSelection;\n      if (event instanceof KeyboardEvent) {\n        this._handleEnterKeydown(event);\n      }\n    }\n\n    protected _handleCompositionStart(): void {\n      this._compositionStart = this._inputSelection.start;\n    }\n\n    protected _handleCompositionEnd({ data }: CompositionEvent): void {\n      // The whole composed sequence is one undo step, anchored where it began.\n      this._updateInput(\n        data,\n        { start: this._compositionStart, end: this._inputSelection.end },\n        'atomic',\n        { start: this._compositionStart, end: this._compositionStart }\n      );\n    }\n\n    protected _handleClick(): void {\n      const { selectionStart: start, selectionEnd: end } = this._input ?? {\n        selectionStart: 0,\n        selectionEnd: 0,\n      };\n\n      // Clicking at the end of the input field will select the entire mask\n      if (start === end && start === this._maskedValue.length) {\n        this.select();\n      }\n    }\n\n    /**\n     * Intercepts the browser's own history commands - the Edit and context menus, and\n     * the software keyboard on mobile - which never reach the key bindings. The native\n     * stack is empty anyway, so letting one through would only de-sync the input's DOM\n     * value from the masked text.\n     */\n    protected _handleBeforeInput(event: InputEvent): void {\n      const { inputType } = event;\n\n      if (inputType !== 'historyUndo' && inputType !== 'historyRedo') {\n        return;\n      }\n\n      event.preventDefault();\n\n      if (!this.readOnly) {\n        this._historyStep(inputType === 'historyUndo' ? 'undo' : 'redo');\n      }\n    }\n\n    //#endregion\n\n    //#region Undo/redo\n\n    /**\n     * Snapshots the current masked text before `next` replaces it, then reports where the\n     * caret ends up. Must be called *before* the text is committed.\n     *\n     * Only a real change earns an undo step: a character the mask rejects, a backspace at\n     * position zero or a spin that hit a boundary would otherwise leave behind a step\n     * that appears to do nothing when undone.\n     */\n    protected _recordHistory(\n      kind: MaskEditKind,\n      next: string,\n      caret: number,\n      selection: MaskSelection = this._inputSelection\n    ): void {\n      const previous = this._historyText;\n\n      if (next !== previous) {\n        this._history.record(kind, { value: previous, ...selection });\n      }\n\n      this._history.settle(next, caret);\n    }\n\n    /** Reconciles the history with the current masked text. */\n    protected _historyResync(): void {\n      this._history.resync(this._historyText);\n    }\n\n    /** Restores the neighboring history state in the given direction. */\n    protected async _historyStep(direction: 'undo' | 'redo'): Promise<void> {\n      if (this.readOnly) {\n        return;\n      }\n\n      const current: MaskHistoryState = {\n        value: this._historyText,\n        ...this._inputSelection,\n      };\n\n      const state =\n        direction === 'undo'\n          ? this._history.undo(current)\n          : this._history.redo(current);\n\n      if (!state) {\n        return;\n      }\n\n      this._setTouchedState();\n      this._commitMaskedValue(state.value);\n      this.requestUpdate();\n\n      // Native inputs announce an undo as an `input` event, and the composite hosts\n      // (`igc-date-picker`, `igc-date-range-picker`) read the draft value from ours.\n      this._emitInputEvent();\n\n      await this.updateComplete;\n\n      // Through the mixin method, since the input's own keydown handler has already\n      // overwritten `_maskSelection` with the caret as it was before the restore.\n      this.setSelectionRange(state.start, state.end);\n    }\n\n    //#endregion\n\n    //#region Public methods\n\n    /* blazorSuppress */\n    /** Sets the text selection range of the control */\n    public setSelectionRange(\n      start?: number,\n      end?: number,\n      direction: SelectionRangeDirection = 'none'\n    ): void {\n      this._input?.setSelectionRange(start ?? null, end ?? null, direction);\n      this._maskSelection = { start: start ?? 0, end: end ?? 0 };\n    }\n\n    /* blazorSuppress */\n    /** Replaces the selected text in the control and re-applies the mask */\n    public setRangeText(\n      replacement: string,\n      start?: number,\n      end?: number,\n      selectMode?: RangeTextSelectMode\n    ): void {\n      const current = this._inputSelection;\n      const _start = start ?? current.start;\n      const _end = end ?? current.end;\n\n      const result = this._parser.replace(\n        this._maskedValue || this._parser.emptyMask,\n        replacement,\n        _start,\n        _end\n      );\n      const next = this._parser.apply(this._parser.parse(result.value));\n\n      this._recordHistory('atomic', next, _start, current);\n      this._commitMaskedValue(next);\n\n      this.updateComplete.then(() => {\n        switch (selectMode) {\n          case 'select':\n            this.setSelectionRange(_start, _end);\n            break;\n          case 'start':\n            this.setSelectionRange(_start, _start);\n            break;\n          case 'end':\n            this.setSelectionRange(_end, _end);\n            break;\n          default:\n            this.setSelectionRange(current.start, current.end);\n        }\n      });\n    }\n\n    //#endregion\n  }\n\n  return MaskBehaviorElement as unknown as AbstractConstructor<MaskBehaviorElementInterface> &\n    T;\n}\n"]}

package/{components/common → internals}/mixins/option.d.ts

@@ -33,7 +33,5 @@ export declare abstract class IgcBaseOptionLikeComponent extends LitElement {
      */
     set value(value: string);
     get value(): string;
-    /** @internal */
-    connectedCallback(): void;
     protected render(): import("lit-html").TemplateResult<1>;
 }

package/{components/common → internals}/mixins/option.js

@@ -12,6 +12,7 @@ export class IgcBaseOptionLikeComponent extends LitElement {
         super(...arguments);
         this._internals = addInternalsController(this, {
             initialARIA: { role: 'option' },
+            reflectRole: true,
         });
         this._active = false;
         this._disabled = false;
@@ -47,10 +48,6 @@ export class IgcBaseOptionLikeComponent extends LitElement {
     get value() {
         return this._value ? this._value : this._contentSlotText;
     }
-    connectedCallback() {
-        super.connectedCallback();
-        this.role = 'option';
-    }
     render() {
         return html `
       <section part="prefix">

package/internals/mixins/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../../../src/internals/mixins/option.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,MAAM,OAAgB,0BAA2B,SAAQ,UAAU;IAAnE;;QACqB,eAAU,GAAG,sBAAsB,CAAC,IAAI,EAAE;YAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEO,YAAO,GAAG,KAAK,CAAC;QAChB,cAAS,GAAG,KAAK,CAAC;QAClB,cAAS,GAAG,KAAK,CAAC;IAgF9B,CAAC;IA1EC,IAAc,gBAAgB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAOD,IAAW,MAAM,CAAC,KAAc;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAOD,IAAW,QAAQ,CAAC,KAAc;QAChC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAOD,IAAW,QAAQ,CAAC,KAAc;QAChC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IASD,IAAW,KAAK,CAAC,KAAa;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAC3D,CAAC;IAEkB,MAAM;QACvB,OAAO,IAAI,CAAA;;;;;;;;;;KAUV,CAAC;IACJ,CAAC;CACF;AA5EoB;IADlB,kBAAkB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;4DACO;AAW7C;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;wDAG1C;AAWD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;0DAI1C;AAWD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;0DAK1C;AAaD;IADC,QAAQ,EAAE;uDAGV","sourcesContent":["import { html, LitElement } from 'lit';\nimport { property, queryAssignedNodes } from 'lit/decorators.js';\nimport { addInternalsController } from '../controllers/internals.js';\n\n/* omitModule */\nexport abstract class IgcBaseOptionLikeComponent extends LitElement {\n  protected readonly _internals = addInternalsController(this, {\n    initialARIA: { role: 'option' },\n    reflectRole: true,\n  });\n\n  protected _active = false;\n  protected _disabled = false;\n  protected _selected = false;\n  protected _value!: string;\n\n  @queryAssignedNodes({ flatten: true })\n  protected readonly _content!: Array<Element>;\n\n  protected get _contentSlotText(): string {\n    return this._content.map((node) => node.textContent).join('');\n  }\n\n  /**\n   * Whether the item is active.\n   * @attr\n   */\n  @property({ type: Boolean, reflect: true })\n  public set active(value: boolean) {\n    this._active = Boolean(value);\n  }\n\n  public get active(): boolean {\n    return this._active;\n  }\n\n  /**\n   * Whether the item is disabled.\n   * @attr\n   */\n  @property({ type: Boolean, reflect: true })\n  public set disabled(value: boolean) {\n    this._disabled = Boolean(value);\n    this._internals.setARIA({ ariaDisabled: `${this.disabled}` });\n  }\n\n  public get disabled(): boolean {\n    return this._disabled;\n  }\n\n  /**\n   * Whether the item is selected.\n   * @attr\n   */\n  @property({ type: Boolean, reflect: true })\n  public set selected(value: boolean) {\n    this._selected = Boolean(value);\n    this._internals.setARIA({ ariaSelected: `${this._selected}` });\n    this.active = this.selected;\n  }\n\n  public get selected(): boolean {\n    return this._selected;\n  }\n\n  /**\n   * The current value of the item.\n   * If not specified, the element's text content is used.\n   *\n   * @attr\n   */\n  @property()\n  public set value(value: string) {\n    this._value = value;\n  }\n\n  public get value(): string {\n    return this._value ? this._value : this._contentSlotText;\n  }\n\n  protected override render() {\n    return html`\n      <section part=\"prefix\">\n        <slot name=\"prefix\"></slot>\n      </section>\n      <section part=\"content\">\n        <slot></slot>\n      </section>\n      <section part=\"suffix\">\n        <slot name=\"suffix\"></slot>\n      </section>\n    `;\n  }\n}\n"]}

package/internals/part-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"part-map.js","sourceRoot":"","sources":["../../src/internals/part-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAEL,SAAS,EAET,SAAS,EAET,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAM1B,MAAM,gBAAiB,SAAQ,SAAS;IAGtC,YAAY,QAAkB;QAC5B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEhB,IACE,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,SAAS;YACpC,QAAQ,CAAC,IAAI,KAAK,MAAM;YACvB,QAAQ,CAAC,OAAO,EAAE,MAAiB,GAAG,CAAC,EACxC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAEe,MAAM,CAAC,WAAwB;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;aAC5B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;aACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAEe,MAAM,CACpB,IAAmB,EACnB,CAAC,WAAW,CAA4B;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAEnC,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;YAEhC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACnB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACtB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAMD,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["import { noChange } from 'lit';\nimport {\n  type AttributePart,\n  Directive,\n  type DirectiveParameters,\n  directive,\n  type PartInfo,\n  PartType,\n} from 'lit/directive.js';\n\nexport interface PartMapInfo {\n  readonly [name: string]: boolean | null | undefined;\n}\n\nclass PartMapDirective extends Directive {\n  private _previousParts?: Set<string>;\n\n  constructor(partInfo: PartInfo) {\n    super(partInfo);\n\n    if (\n      partInfo.type !== PartType.ATTRIBUTE ||\n      partInfo.name !== 'part' ||\n      (partInfo.strings?.length as number) > 0\n    ) {\n      throw new Error(\n        '`partMap() can only be used in the `part` attribute and must be the only part in the attribute.'\n      );\n    }\n  }\n\n  public override render(partMapInfo: PartMapInfo): string {\n    return Object.keys(partMapInfo)\n      .filter((key) => partMapInfo[key])\n      .join(' ');\n  }\n\n  public override update(\n    part: AttributePart,\n    [partMapInfo]: DirectiveParameters<this>\n  ) {\n    const partList = part.element.part;\n\n    if (this._previousParts === undefined) {\n      this._previousParts = new Set();\n\n      for (const name in partMapInfo) {\n        if (partMapInfo[name]) {\n          partList.add(name);\n          this._previousParts.add(name);\n        }\n      }\n\n      return this.render(partMapInfo);\n    }\n\n    for (const name of this._previousParts) {\n      if (!(name in partMapInfo) || !partMapInfo[name]) {\n        partList.remove(name);\n        this._previousParts.delete(name);\n      }\n    }\n\n    for (const name in partMapInfo) {\n      const value = !!partMapInfo[name];\n      if (value && !this._previousParts.has(name)) {\n        partList.add(name);\n        this._previousParts.add(name);\n      }\n    }\n\n    return noChange;\n  }\n}\n\n/**\n * Similar to Lit's {@link https://lit.dev/docs/templates/directives/#classmap | `classMap`} and\n * {@link https://lit.dev/docs/templates/directives/#stylemap | `styleMap`} but for `part` attributes.\n */\nexport const partMap = directive(PartMapDirective);\nexport type { PartMapDirective };\n"]}

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/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,92 @@
+/**
+ * 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;
+};
+/** 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;

package/internals/utils/dom.js

@@ -0,0 +1,143 @@
+import { isServer } from 'lit';
+import { asNumber, numberInRangeInclusive } from './math.js';
+import { merge } from './objects.js';
+import { isDefined } from './types.js';
+export function isLTR(element) {
+    return element.matches(':dir(ltr)');
+}
+const LENGTH_PROPERTY = '--igc-resolved-length';
+const SUPPORTS_REGISTERED_PROPERTIES = !isServer && typeof CSS !== 'undefined' && 'registerProperty' in CSS;
+let lengthPropertyUsable;
+function canResolveLengths() {
+    if (lengthPropertyUsable === undefined) {
+        lengthPropertyUsable = SUPPORTS_REGISTERED_PROPERTIES;
+        if (lengthPropertyUsable) {
+            try {
+                CSS.registerProperty({
+                    name: LENGTH_PROPERTY,
+                    syntax: '<length>',
+                    inherits: false,
+                    initialValue: '0px',
+                });
+            }
+            catch {
+            }
+        }
+    }
+    return lengthPropertyUsable;
+}
+export function resolveCssLength(element, value) {
+    if (!canResolveLengths()) {
+        return 0;
+    }
+    const { style } = element;
+    const previous = style.getPropertyValue(LENGTH_PROPERTY);
+    const priority = style.getPropertyPriority(LENGTH_PROPERTY);
+    style.setProperty(LENGTH_PROPERTY, value);
+    const resolved = getComputedStyle(element).getPropertyValue(LENGTH_PROPERTY);
+    if (previous) {
+        style.setProperty(LENGTH_PROPERTY, previous, priority);
+    }
+    else {
+        style.removeProperty(LENGTH_PROPERTY);
+    }
+    return asNumber(resolved);
+}
+function createNodeFilter(predicate) {
+    return {
+        acceptNode: (node) => predicate(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,
+    };
+}
+export function* iterNodes(root, options) {
+    if (!isDefined(globalThis.document)) {
+        return;
+    }
+    const whatToShow = options?.show
+        ? NodeFilter[options.show]
+        : NodeFilter.SHOW_ALL;
+    const nodeFilter = options?.filter
+        ? createNodeFilter(options.filter)
+        : undefined;
+    const treeWalker = document.createTreeWalker(root, whatToShow, nodeFilter);
+    while (treeWalker.nextNode()) {
+        yield treeWalker.currentNode;
+    }
+}
+export function* iterAncestors(node) {
+    let current = node;
+    while (current) {
+        if (isElement(current)) {
+            yield current;
+        }
+        current = current instanceof ShadowRoot ? current.host : current.parentNode;
+    }
+}
+export function getRoot(element, options) {
+    return element.getRootNode(options);
+}
+export function getElementByIdFromRoot(root, id) {
+    return getRoot(root).getElementById(id);
+}
+export function isElement(node) {
+    return node instanceof Node && node.nodeType === Node.ELEMENT_NODE;
+}
+export function isDocument(node) {
+    return node instanceof Node && node.nodeType === Node.DOCUMENT_NODE;
+}
+export function getCenterPoint(element) {
+    const { left, top, width, height } = element.getBoundingClientRect();
+    return {
+        x: left + width * 0.5,
+        y: top + height * 0.5,
+    };
+}
+export function isPointInsideElement(element, x, y) {
+    const { left, right, top, bottom } = element.getBoundingClientRect();
+    return (numberInRangeInclusive(x, left, right) &&
+        numberInRangeInclusive(y, top, bottom));
+}
+export function getScaleFactor(element) {
+    const { offsetWidth, offsetHeight } = element;
+    const { width, height } = element.getBoundingClientRect();
+    return { x: offsetWidth / width || 1, y: offsetHeight / height || 1 };
+}
+export function roundByDPR(value) {
+    const dpr = globalThis.devicePixelRatio || 1;
+    return Math.round(value * dpr) / dpr;
+}
+export function scrollIntoView(element, config) {
+    if (!element) {
+        return;
+    }
+    element.scrollIntoView(Object.assign({
+        behavior: 'auto',
+        block: 'nearest',
+        inline: 'nearest',
+    }, config));
+}
+export function setStyles(element, styles) {
+    merge(element.style, styles);
+}
+export function hasFiles(input) {
+    return input.files != null && input.files.length > 0;
+}
+export function isPopoverOpen(element) {
+    return element?.matches(':popover-open') ?? false;
+}
+export function hasStickyAncestor(element) {
+    for (const ancestor of iterAncestors(element)) {
+        if (getComputedStyle(ancestor).position === 'sticky') {
+            return true;
+        }
+    }
+    return false;
+}
+export function getVisibleAncestor(startNode) {
+    for (const ancestor of iterAncestors(startNode.parentNode)) {
+        if (ancestor instanceof HTMLElement && ancestor.checkVisibility()) {
+            return ancestor;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=dom.js.map

package/internals/utils/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../src/internals/utils/dom.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer } from 'lit';\nimport { asNumber, numberInRangeInclusive } from './math.js';\nimport { merge } from './objects.js';\nimport { isDefined } from './types.js';\n\n/**\n * Returns whether an element has a Left-to-Right directionality.\n */\nexport function isLTR(element: HTMLElement) {\n  return element.matches(':dir(ltr)');\n}\n\nconst LENGTH_PROPERTY = '--igc-resolved-length';\n\nconst SUPPORTS_REGISTERED_PROPERTIES =\n  !isServer && typeof CSS !== 'undefined' && 'registerProperty' in CSS;\n\nlet lengthPropertyUsable: boolean | undefined;\n\nfunction canResolveLengths(): boolean {\n  if (lengthPropertyUsable === undefined) {\n    lengthPropertyUsable = SUPPORTS_REGISTERED_PROPERTIES;\n\n    if (lengthPropertyUsable) {\n      try {\n        CSS.registerProperty({\n          name: LENGTH_PROPERTY,\n          syntax: '<length>',\n          inherits: false,\n          initialValue: '0px',\n        });\n      } catch {\n        // The descriptor is a constant, so the only realistic rejection is a\n        // duplicate registration from another bundle instance - which leaves\n        // the property just as usable.\n      }\n    }\n  }\n\n  return lengthPropertyUsable;\n}\n\n/**\n * Resolves a CSS length to pixels in the context of `element`.\n *\n * A registered custom property computes to an absolute length, which lets the\n * browser do the conversion for font, viewport and container relative units\n * instead of them being read as raw numbers. Percentages are not lengths -\n * resolve those against whatever basis applies to the property at hand.\n *\n * Returns 0 for percentages, for values that are not valid lengths, and where\n * the resolution is unavailable - during server-side rendering, or without\n * support for registered custom properties. Guessing from the raw token would\n * read `5rem` as 5 pixels, so callers get an obvious zero instead.\n *\n * @example\n * ```typescript\n * resolveCssLength(element, '5rem'); // 80\n * resolveCssLength(element, '2em'); // 2 x the element font size\n * ```\n */\nexport function resolveCssLength(element: HTMLElement, value: string): number {\n  if (!canResolveLengths()) {\n    return 0;\n  }\n\n  const { style } = element;\n  const previous = style.getPropertyValue(LENGTH_PROPERTY);\n  const priority = style.getPropertyPriority(LENGTH_PROPERTY);\n\n  style.setProperty(LENGTH_PROPERTY, value);\n  const resolved = getComputedStyle(element).getPropertyValue(LENGTH_PROPERTY);\n\n  // Restore rather than remove - the caller may be using the property itself.\n  if (previous) {\n    style.setProperty(LENGTH_PROPERTY, previous, priority);\n  } else {\n    style.removeProperty(LENGTH_PROPERTY);\n  }\n\n  return asNumber(resolved);\n}\n\nexport type IterNodesOptions<T = Node> = {\n  show?: keyof typeof NodeFilter;\n  filter?: (node: T) => boolean;\n};\n\nfunction createNodeFilter<T extends Node>(predicate: (node: T) => boolean) {\n  return {\n    acceptNode: (node: T): number =>\n      predicate(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP,\n  };\n}\n\n/**\n * Iterates over the DOM subtree of `root` in document order, yielding the nodes\n * matching the passed {@link IterNodesOptions | options}.\n *\n * @example\n * ```typescript\n * for (const button of iterNodes<HTMLButtonElement>(root, { show: 'SHOW_ELEMENT', filter: isButton })) { ... }\n * ```\n */\nexport function* iterNodes<T extends Node>(\n  root: Node,\n  options?: IterNodesOptions<T>\n): Generator<T> {\n  if (!isDefined(globalThis.document)) {\n    return;\n  }\n\n  const whatToShow = options?.show\n    ? NodeFilter[options.show]\n    : NodeFilter.SHOW_ALL;\n\n  const nodeFilter = options?.filter\n    ? createNodeFilter(options.filter)\n    : undefined;\n\n  const treeWalker = document.createTreeWalker(root, whatToShow, nodeFilter);\n\n  while (treeWalker.nextNode()) {\n    yield treeWalker.currentNode as T;\n  }\n}\n\n/**\n * Iterates over `node` and its ancestors, crossing shadow DOM boundaries.\n *\n * Shadow roots are traversed through their host, so only elements are yielded.\n *\n * @example\n * ```typescript\n * for (const ancestor of iterAncestors(element)) { ... }\n * ```\n */\nexport function* iterAncestors(node?: Node | null): Generator<Element> {\n  let current: Node | null | undefined = node;\n\n  while (current) {\n    if (isElement(current)) {\n      yield current;\n    }\n\n    current = current instanceof ShadowRoot ? current.host : current.parentNode;\n  }\n}\n\n/** Returns the root node (document or shadow root) of the given element. */\nexport function getRoot(\n  element: Element,\n  options?: GetRootNodeOptions\n): Document | ShadowRoot {\n  return element.getRootNode(options) as Document | ShadowRoot;\n}\n\n/** Returns the element with the given id in the root node of `root`, if any. */\nexport function getElementByIdFromRoot(root: HTMLElement, id: string) {\n  return getRoot(root).getElementById(id);\n}\n\nexport function isElement(node: unknown): node is Element {\n  return node instanceof Node && node.nodeType === Node.ELEMENT_NODE;\n}\n\nexport function isDocument(node: unknown): node is Document {\n  return node instanceof Node && node.nodeType === Node.DOCUMENT_NODE;\n}\n\n/** Returns the center x/y coordinate of a given element. */\nexport function getCenterPoint(element: Element): { x: number; y: number } {\n  const { left, top, width, height } = element.getBoundingClientRect();\n\n  return {\n    x: left + width * 0.5,\n    y: top + height * 0.5,\n  };\n}\n\n/** Returns whether the given client coordinates lie within the bounding box of the element. */\nexport function isPointInsideElement(\n  element: Element,\n  x: number,\n  y: number\n): boolean {\n  const { left, right, top, bottom } = element.getBoundingClientRect();\n  return (\n    numberInRangeInclusive(x, left, right) &&\n    numberInRangeInclusive(y, top, bottom)\n  );\n}\n\n/** Returns the scale factor of a given element based on its bounding client rect and offset dimensions. */\nexport function getScaleFactor(element: HTMLElement): { x: number; y: number } {\n  const { offsetWidth, offsetHeight } = element;\n  const { width, height } = element.getBoundingClientRect();\n  return { x: offsetWidth / width || 1, y: offsetHeight / height || 1 };\n}\n\n/** Rounds a CSS pixel value to the closest device-pixel boundary to avoid blurry rendering. */\nexport function roundByDPR(value: number): number {\n  const dpr = globalThis.devicePixelRatio || 1;\n  return Math.round(value * dpr) / dpr;\n}\n\n/** Null-safe `Element.scrollIntoView` defaulting to the nearest block/inline position. */\nexport function scrollIntoView(\n  element?: HTMLElement | null,\n  config?: ScrollIntoViewOptions\n): void {\n  if (!element) {\n    return;\n  }\n\n  element.scrollIntoView(\n    Object.assign(\n      {\n        behavior: 'auto',\n        block: 'nearest',\n        inline: 'nearest',\n      },\n      config\n    )\n  );\n}\n\n/** Applies the given CSS declarations to the inline style of the element. */\nexport function setStyles(\n  element: HTMLElement,\n  styles: Partial<CSSStyleDeclaration>\n): void {\n  merge(element.style, styles);\n}\n\n/** Returns whether the given input has at least one selected file. */\nexport function hasFiles(input: { files: FileList | null }): boolean {\n  return input.files != null && input.files.length > 0;\n}\n\n/**\n * Returns whether the given element is currently an open popover or not.\n * 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.\n * Note: This function only works for elements that use the `:popover-open` pseudo-class to indicate\n */\nexport function isPopoverOpen(element?: Element): boolean {\n  return element?.matches(':popover-open') ?? false;\n}\n\n/**\n * Returns whether the given element, or any of its ancestors across shadow DOM\n * boundaries, is positioned as `sticky`.\n */\nexport function hasStickyAncestor(element: Element): boolean {\n  for (const ancestor of iterAncestors(element)) {\n    if (getComputedStyle(ancestor).position === 'sticky') {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Returns the nearest visible ancestor of a given node, traversing through shadow DOM boundaries if necessary. If no visible ancestor is found, returns null.\n */\nexport function getVisibleAncestor(startNode: Node): HTMLElement | null {\n  for (const ancestor of iterAncestors(startNode.parentNode)) {\n    if (ancestor instanceof HTMLElement && ancestor.checkVisibility()) {\n      return ancestor;\n    }\n  }\n\n  return null;\n}\n"]}