igniteui-webcomponents 7.3.2 → 7.4.1

package/components/file-input/file-input.d.ts

@@ -18,7 +18,7 @@ declare const IgcFileInputComponent_base: AbstractConstructor<import("#internals
  * @slot custom-error - Renders content when setCustomValidity(message) is set.
  * @slot invalid - Renders content when the component is in invalid state (validity.valid = false).
  *
- * @fires igcChange - Emitted when the control's checked state changes.
+ * @fires igcChange - Emitted when the selection of the control changes.
  * @fires igcCancel - Emitted when the control's file picker dialog is canceled.
  *
  * @csspart container - The main wrapper that holds all main input elements.
@@ -35,7 +35,7 @@ export default class IgcFileInputComponent extends IgcFileInputComponent_base {
     static styles: import("lit").CSSResult[];
     static register(): void;
     protected readonly _themes: import("#theming/theming-controller.js").ThemingController;
-    protected readonly _slots: import("#internals/controllers/slot.js").SlotController<"invalid" | "prefix" | "helper-text" | "[default]" | "suffix" | "value-missing" | "custom-error" | "file-selector-text" | "file-missing-text">;
+    protected readonly _slots: import("#internals/controllers/slot.js").SlotController<"invalid" | "prefix" | "[default]" | "suffix" | "helper-text" | "value-missing" | "custom-error" | "file-selector-text" | "file-missing-text">;
     protected readonly _formValue: import("#internals/mixins/forms/form-value.js").FormValue<FileList | null>;
     protected get __validators(): import("../../internals/validators.js").Validator<IgcFileInputComponent>[];
     private get _fileNames();
@@ -85,6 +85,11 @@ export default class IgcFileInputComponent extends IgcFileInputComponent_base {
     private _handleCancel;
     protected _handleBlur(): void;
     protected _handleClick(): void;
+    /**
+     * Focuses the native input and opens the file picker. Delegated focus alone
+     * goes to the browse button.
+     */
+    protected _handleLabelActivation(): void;
     protected _renderFileParts(): import("lit-html").TemplateResult<1>;
     protected _renderInput(): import("lit-html").TemplateResult<1>;
 }

package/components/file-input/file-input.js

@@ -101,6 +101,10 @@ export default class IgcFileInputComponent extends I18nMixin(EventEmitterMixin(I
     _handleClick() {
         this._filePickerActive = true;
     }
+    _handleLabelActivation() {
+        this._input?.focus();
+        this._input?.click();
+    }
     _renderFileParts() {
         const emptyText = this.placeholder ?? this.resourceStrings.file_input_placeholder;
         return html `

package/components/file-input/file-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-input.js","sourceRoot":"","sources":["../../../src/components/file-input/file-input.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FileInputResourceStringsEN,\n  type IFileInputResourceStrings,\n} from 'igniteui-i18n-core';\nimport { html } from 'lit';\nimport { property, state } from 'lit/decorators.js';\nimport { ariaBindings } from '#internals/controllers/aria-projection.js';\nimport { addSlotController, setSlots } from '#internals/controllers/slot.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport type { I18nControllerConfig } from '#internals/i18n/i18n-controller.js';\nimport type { AbstractConstructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { FormValueFileListTransformers } from '#internals/mixins/forms/form-transformers.js';\nimport { createFormValueState } from '#internals/mixins/forms/form-value.js';\nimport { I18nMixin } from '#internals/mixins/i18n.js';\nimport { partMap } from '#internals/part-map.js';\nimport { hasFiles } from '#internals/utils/dom.js';\nimport { bindIf } from '#internals/utils/lit.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport IgcButtonComponent from '../button/button.js';\nimport {\n  IgcInputBaseComponent,\n  type IgcInputComponentEventMap,\n} from '../input/input-base.js';\nimport { styles as baseStyle } from '../input/themes/input.base.css.js';\nimport { styles as shared } from '../input/themes/shared/input.common.css.js';\nimport IgcValidationContainerComponent from '../validation-container/validation-container.js';\nimport { styles } from './themes/file-input.base.css.js';\nimport { all } from './themes/themes.js';\nimport { fileValidators } from './validators.js';\n\n/* blazorSuppress */\nexport interface IgcFileInputComponentEventMap extends Omit<\n  IgcInputComponentEventMap,\n  'igcChange' | 'igcInput'\n> {\n  igcCancel: CustomEvent<FileList>;\n  igcChange: CustomEvent<FileList>;\n}\n\nconst Slots = setSlots(\n  'prefix',\n  'suffix',\n  'helper-text',\n  'file-selector-text',\n  'file-missing-text',\n  'value-missing',\n  'custom-error',\n  'invalid'\n);\n\nconst i18n: I18nControllerConfig<IFileInputResourceStrings> = {\n  defaultEN: FileInputResourceStringsEN,\n};\n\n/* blazorSuppress */\n/**\n * @element igc-file-input\n *\n * @slot prefix - Renders content before the input.\n * @slot suffix - Renders content after input.\n * @slot helper-text - Renders content below the input.\n * @slot file-selector-text - Renders content for the browse button when input type is file.\n * @slot file-missing-text - Renders content when input type is file and no file is chosen.\n * @slot value-missing - Renders content when the required validation fails.\n * @slot custom-error - Renders content when setCustomValidity(message) is set.\n * @slot invalid - Renders content when the component is in invalid state (validity.valid = false).\n *\n * @fires igcChange - Emitted when the control's checked state changes.\n * @fires igcCancel - Emitted when the control's file picker dialog is canceled.\n *\n * @csspart container - The main wrapper that holds all main input elements.\n * @csspart input - The native input element.\n * @csspart label - The native label element.\n * @csspart file-names - The file names wrapper when input type is 'file'.\n * @csspart file-selector-button - The browse button when input type is 'file'.\n * @csspart prefix - The prefix wrapper.\n * @csspart suffix - The suffix wrapper.\n * @csspart helper-text - The helper text wrapper.\n */\nexport default class IgcFileInputComponent extends I18nMixin(\n  EventEmitterMixin<\n    IgcFileInputComponentEventMap,\n    AbstractConstructor<IgcInputBaseComponent>\n  >(IgcInputBaseComponent),\n  i18n\n) {\n  public static readonly tagName = 'igc-file-input';\n  public static styles = [baseStyle, shared, styles];\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(\n      IgcFileInputComponent,\n      IgcValidationContainerComponent,\n      IgcButtonComponent\n    );\n  }\n\n  //#region Internal attributes and properties\n\n  protected override readonly _themes = addThemingController(this, all);\n\n  protected override readonly _slots = addSlotController(this, {\n    slots: Slots,\n  });\n\n  protected override readonly _formValue = createFormValueState(this, {\n    initialValue: null,\n    transformers: FormValueFileListTransformers,\n  });\n\n  protected override get __validators() {\n    return fileValidators;\n  }\n\n  private get _fileNames(): string | null {\n    if (!hasFiles(this)) {\n      return null;\n    }\n\n    return Array.from(this.files)\n      .map((file) => file.name || 'unnamed')\n      .join(', ');\n  }\n\n  /**\n   * Indicates whether the file picker dialog is currently active.\n   * Used to manage validation on blur.\n   */\n  @state()\n  private _filePickerActive = false;\n\n  //#endregion\n\n  //#region Public attributes and properties\n\n  /* @tsTwoWayProperty(true, \"igcChange\", \"detail\", false) */\n  /**\n   * The value of the control.\n   * Similar to native file input, this property is read-only and cannot be set programmatically.\n   * @attr\n   */\n  @property()\n  public set value(value: string) {\n    if (value === '' && this._input) {\n      this._input.value = value;\n    }\n  }\n\n  public get value(): string {\n    return this._input?.value ?? '';\n  }\n\n  /**\n   * Whether the control allows the user to select more than one file.\n   *\n   * @attr\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public multiple = false;\n\n  /**\n   * The file types the control accepts, as a comma-separated list.\n   * @attr\n   */\n  @property()\n  public accept = '';\n\n  /**\n   * Whether the control should receive focus automatically.\n   * @attr\n   */\n  @property({ type: Boolean })\n  public override autofocus!: boolean;\n\n  /** Returns the list of selected files. */\n  public get files(): FileList {\n    return this._input?.files ?? new DataTransfer().files;\n  }\n\n  //#endregion\n\n  //#region Internal methods\n\n  /**\n   * A file input cannot have a default file list, so the `value` attribute\n   * never contributes a default - otherwise its string would be stored as the\n   * FileList default and submitted character-by-character after a form reset.\n   */\n  protected override _setDefaultValue(): void {\n    this._formValue.defaultValue = null;\n  }\n\n  /**\n   * Restores directly instead of through the `value` setter: the setter is\n   * deliberately inert (read-only semantics) and never updates the form state.\n   */\n  protected override _restoreDefaultValue(): void {\n    if (this._input) {\n      this._input.value = '';\n    }\n    this._formValue.setValueAndFormState(this._formValue.defaultValue);\n    this.requestUpdate();\n  }\n\n  //#endregion\n\n  //#region Event Handlers\n\n  private _handleChange(): void {\n    this._filePickerActive = false;\n    this._setTouchedState();\n    this._formValue.setValueAndFormState(this.files);\n\n    this.requestUpdate();\n    this.emitEvent('igcChange', { detail: this.files });\n  }\n\n  private _handleCancel(): void {\n    this._filePickerActive = false;\n    this._setTouchedState();\n    this._validate();\n\n    this.emitEvent('igcCancel', { detail: this.files });\n  }\n\n  protected override _handleBlur(): void {\n    this._filePickerActive ? this._validate() : super._handleBlur();\n  }\n\n  /* c8 ignore next 3 */\n  protected _handleClick(): void {\n    this._filePickerActive = true;\n  }\n\n  //#endregion\n\n  protected override _renderFileParts() {\n    const emptyText =\n      this.placeholder ?? this.resourceStrings.file_input_placeholder;\n\n    return html`\n      <div part=\"file-parts\">\n        <div part=\"file-selector-button\">\n          <igc-button variant=\"flat\" ?disabled=${this.disabled} tabindex=\"-1\">\n            <slot name=\"file-selector-text\"\n              >${this.resourceStrings.file_input_upload_button}</slot\n            >\n          </igc-button>\n        </div>\n        <div part=\"file-names\">\n          <span>\n            ${\n              this._fileNames ??\n              html`<slot name=\"file-missing-text\">${emptyText}</slot>`\n            }\n          </span>\n        </div>\n      </div>\n    `;\n  }\n\n  protected override _renderInput() {\n    const hasNegativeTabIndex = this.getAttribute('tabindex') === '-1';\n\n    return html`\n      <input\n        ${ariaBindings(this._ariaTarget.resolveBindings())}\n        id=${this._inputId}\n        part=${partMap(this._resolvePartNames('input'))}\n        type=\"file\"\n        ?disabled=${this.disabled}\n        ?required=${this.required}\n        ?autofocus=${this.autofocus}\n        ?multiple=${this.multiple}\n        tabindex=${bindIf(hasNegativeTabIndex, -1)}\n        accept=${bindIf(this.accept, this.accept)}\n        @click=${this._handleClick}\n        @change=${this._handleChange}\n        @cancel=${this._handleCancel}\n        @blur=${this._handleBlur}\n      />\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-file-input': IgcFileInputComponent;\n  }\n}\n"]}
+{"version":3,"file":"file-input.js","sourceRoot":"","sources":["../../../src/components/file-input/file-input.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  FileInputResourceStringsEN,\n  type IFileInputResourceStrings,\n} from 'igniteui-i18n-core';\nimport { html } from 'lit';\nimport { property, state } from 'lit/decorators.js';\nimport { ariaBindings } from '#internals/controllers/aria-projection.js';\nimport { addSlotController, setSlots } from '#internals/controllers/slot.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport type { I18nControllerConfig } from '#internals/i18n/i18n-controller.js';\nimport type { AbstractConstructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { FormValueFileListTransformers } from '#internals/mixins/forms/form-transformers.js';\nimport { createFormValueState } from '#internals/mixins/forms/form-value.js';\nimport { I18nMixin } from '#internals/mixins/i18n.js';\nimport { partMap } from '#internals/part-map.js';\nimport { hasFiles } from '#internals/utils/dom.js';\nimport { bindIf } from '#internals/utils/lit.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport IgcButtonComponent from '../button/button.js';\nimport {\n  IgcInputBaseComponent,\n  type IgcInputComponentEventMap,\n} from '../input/input-base.js';\nimport { styles as baseStyle } from '../input/themes/input.base.css.js';\nimport { styles as shared } from '../input/themes/shared/input.common.css.js';\nimport IgcValidationContainerComponent from '../validation-container/validation-container.js';\nimport { styles } from './themes/file-input.base.css.js';\nimport { all } from './themes/themes.js';\nimport { fileValidators } from './validators.js';\n\n/* blazorSuppress */\nexport interface IgcFileInputComponentEventMap extends Omit<\n  IgcInputComponentEventMap,\n  'igcChange' | 'igcInput'\n> {\n  igcCancel: CustomEvent<FileList>;\n  igcChange: CustomEvent<FileList>;\n}\n\nconst Slots = setSlots(\n  'prefix',\n  'suffix',\n  'helper-text',\n  'file-selector-text',\n  'file-missing-text',\n  'value-missing',\n  'custom-error',\n  'invalid'\n);\n\nconst i18n: I18nControllerConfig<IFileInputResourceStrings> = {\n  defaultEN: FileInputResourceStringsEN,\n};\n\n/* blazorSuppress */\n/**\n * @element igc-file-input\n *\n * @slot prefix - Renders content before the input.\n * @slot suffix - Renders content after input.\n * @slot helper-text - Renders content below the input.\n * @slot file-selector-text - Renders content for the browse button when input type is file.\n * @slot file-missing-text - Renders content when input type is file and no file is chosen.\n * @slot value-missing - Renders content when the required validation fails.\n * @slot custom-error - Renders content when setCustomValidity(message) is set.\n * @slot invalid - Renders content when the component is in invalid state (validity.valid = false).\n *\n * @fires igcChange - Emitted when the selection of the control changes.\n * @fires igcCancel - Emitted when the control's file picker dialog is canceled.\n *\n * @csspart container - The main wrapper that holds all main input elements.\n * @csspart input - The native input element.\n * @csspart label - The native label element.\n * @csspart file-names - The file names wrapper when input type is 'file'.\n * @csspart file-selector-button - The browse button when input type is 'file'.\n * @csspart prefix - The prefix wrapper.\n * @csspart suffix - The suffix wrapper.\n * @csspart helper-text - The helper text wrapper.\n */\nexport default class IgcFileInputComponent extends I18nMixin(\n  EventEmitterMixin<\n    IgcFileInputComponentEventMap,\n    AbstractConstructor<IgcInputBaseComponent>\n  >(IgcInputBaseComponent),\n  i18n\n) {\n  public static readonly tagName = 'igc-file-input';\n  public static styles = [baseStyle, shared, styles];\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(\n      IgcFileInputComponent,\n      IgcValidationContainerComponent,\n      IgcButtonComponent\n    );\n  }\n\n  //#region Internal attributes and properties\n\n  protected override readonly _themes = addThemingController(this, all);\n\n  protected override readonly _slots = addSlotController(this, {\n    slots: Slots,\n  });\n\n  protected override readonly _formValue = createFormValueState(this, {\n    initialValue: null,\n    transformers: FormValueFileListTransformers,\n  });\n\n  protected override get __validators() {\n    return fileValidators;\n  }\n\n  private get _fileNames(): string | null {\n    if (!hasFiles(this)) {\n      return null;\n    }\n\n    return Array.from(this.files)\n      .map((file) => file.name || 'unnamed')\n      .join(', ');\n  }\n\n  /**\n   * Indicates whether the file picker dialog is currently active.\n   * Used to manage validation on blur.\n   */\n  @state()\n  private _filePickerActive = false;\n\n  //#endregion\n\n  //#region Public attributes and properties\n\n  /* @tsTwoWayProperty(true, \"igcChange\", \"detail\", false) */\n  /**\n   * The value of the control.\n   * Similar to native file input, this property is read-only and cannot be set programmatically.\n   * @attr\n   */\n  @property()\n  public set value(value: string) {\n    if (value === '' && this._input) {\n      this._input.value = value;\n    }\n  }\n\n  public get value(): string {\n    return this._input?.value ?? '';\n  }\n\n  /**\n   * Whether the control allows the user to select more than one file.\n   *\n   * @attr\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public multiple = false;\n\n  /**\n   * The file types the control accepts, as a comma-separated list.\n   * @attr\n   */\n  @property()\n  public accept = '';\n\n  /**\n   * Whether the control should receive focus automatically.\n   * @attr\n   */\n  @property({ type: Boolean })\n  public override autofocus!: boolean;\n\n  /** Returns the list of selected files. */\n  public get files(): FileList {\n    return this._input?.files ?? new DataTransfer().files;\n  }\n\n  //#endregion\n\n  //#region Internal methods\n\n  /**\n   * A file input cannot have a default file list, so the `value` attribute\n   * never contributes a default - otherwise its string would be stored as the\n   * FileList default and submitted character-by-character after a form reset.\n   */\n  protected override _setDefaultValue(): void {\n    this._formValue.defaultValue = null;\n  }\n\n  /**\n   * Restores directly instead of through the `value` setter: the setter is\n   * deliberately inert (read-only semantics) and never updates the form state.\n   */\n  protected override _restoreDefaultValue(): void {\n    if (this._input) {\n      this._input.value = '';\n    }\n    this._formValue.setValueAndFormState(this._formValue.defaultValue);\n    this.requestUpdate();\n  }\n\n  //#endregion\n\n  //#region Event Handlers\n\n  private _handleChange(): void {\n    this._filePickerActive = false;\n    this._setTouchedState();\n    this._formValue.setValueAndFormState(this.files);\n\n    this.requestUpdate();\n    this.emitEvent('igcChange', { detail: this.files });\n  }\n\n  private _handleCancel(): void {\n    this._filePickerActive = false;\n    this._setTouchedState();\n    this._validate();\n\n    this.emitEvent('igcCancel', { detail: this.files });\n  }\n\n  protected override _handleBlur(): void {\n    this._filePickerActive ? this._validate() : super._handleBlur();\n  }\n\n  protected _handleClick(): void {\n    this._filePickerActive = true;\n  }\n\n  /**\n   * Focuses the native input and opens the file picker. Delegated focus alone\n   * goes to the browse button.\n   */\n  protected override _handleLabelActivation(): void {\n    this._input?.focus();\n    this._input?.click();\n  }\n\n  //#endregion\n\n  protected override _renderFileParts() {\n    const emptyText =\n      this.placeholder ?? this.resourceStrings.file_input_placeholder;\n\n    return html`\n      <div part=\"file-parts\">\n        <div part=\"file-selector-button\">\n          <igc-button variant=\"flat\" ?disabled=${this.disabled} tabindex=\"-1\">\n            <slot name=\"file-selector-text\"\n              >${this.resourceStrings.file_input_upload_button}</slot\n            >\n          </igc-button>\n        </div>\n        <div part=\"file-names\">\n          <span>\n            ${\n              this._fileNames ??\n              html`<slot name=\"file-missing-text\">${emptyText}</slot>`\n            }\n          </span>\n        </div>\n      </div>\n    `;\n  }\n\n  protected override _renderInput() {\n    const hasNegativeTabIndex = this.getAttribute('tabindex') === '-1';\n\n    return html`\n      <input\n        ${ariaBindings(this._ariaTarget.resolveBindings())}\n        id=${this._inputId}\n        part=${partMap(this._resolvePartNames('input'))}\n        type=\"file\"\n        ?disabled=${this.disabled}\n        ?required=${this.required}\n        ?autofocus=${this.autofocus}\n        ?multiple=${this.multiple}\n        tabindex=${bindIf(hasNegativeTabIndex, -1)}\n        accept=${bindIf(this.accept, this.accept)}\n        @click=${this._handleClick}\n        @change=${this._handleChange}\n        @cancel=${this._handleCancel}\n        @blur=${this._handleBlur}\n      />\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-file-input': IgcFileInputComponent;\n  }\n}\n"]}

package/components/icon/icon.d.ts

@@ -96,7 +96,7 @@ export default class IgcIconComponent extends LitElement {
     protected update(props: PropertyValues<this>): void;
     protected firstUpdated(): void;
     private _getIcon;
-    protected render(): typeof nothing | import("lit-html").TemplateResult<1>;
+    protected render(): import("lit-html").TemplateResult<1> | typeof nothing;
     protected registerIcon(name: string, url: string, collection?: string, stripMeta?: boolean): Promise<void>;
     protected registerIconFromText(name: string, iconText: string, collection?: string, stripMeta?: boolean): void;
     protected setIconRef(name: string, collection: string, icon: IconMeta): void;

package/components/icon/icon.registry.d.ts

@@ -1,15 +1,15 @@
 import type { Theme } from '#theming/types.js';
 import type { IconCallback, IconMeta, IconReferencePair, RegisterIconOptions, SvgIcon } from './registry/types.js';
 /**
- * Global singleton registry for managing SVG icons and their references.
+ * The global registry of SVG icons and their references.
  *
  * @remarks
- * The registry stores SVG icons in named collections, resolves aliases against
- * the active theme, notifies subscribers once per microtask however many icons
- * changed, and publishes user-set state to other browsing contexts (see
- * {@link IconsStateBroadcast}).
+ * The registry keeps the icons in named collections, resolves an alias against
+ * the active theme, notifies the subscribers one time per microtask however
+ * many icons changed, and publishes user-set state to the other browsing
+ * contexts. See {@link IconsStateBroadcast}.
  *
- * @internal Not exposed directly - use the exported functions.
+ * @internal Use the exported functions.
  */
 declare class IconsRegistry {
     private readonly _listeners;

package/components/icon/icon.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon.registry.js","sourceRoot":"","sources":["../../../src/components/icon/icon.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Theme } from '#theming/types.js';\nimport { ICON_REFERENCES } from './icon-references.js';\nimport { IconsStateBroadcast } from './icon-state.broadcast.js';\nimport { internalIcons } from './internal-icons-lib.js';\nimport { SvgIconParser } from './registry/parser.js';\nimport type {\n  IconCallback,\n  IconMeta,\n  IconReferencePair,\n  IconsCollection,\n  RegisterIconOptions,\n  SvgIcon,\n} from './registry/types.js';\nimport { ActionType } from './registry/types.js';\n\n/**\n * Normalizes the third argument of `registerIcon` / `registerIconFromText`,\n * which is either a collection name or a {@link RegisterIconOptions} object.\n */\nfunction resolveIconOptions(\n  collectionOrOptions?: string | RegisterIconOptions\n): Required<RegisterIconOptions> {\n  if (typeof collectionOrOptions === 'string') {\n    return { collection: collectionOrOptions, stripMeta: false };\n  }\n\n  return {\n    collection: collectionOrOptions?.collection ?? 'default',\n    stripMeta: collectionOrOptions?.stripMeta ?? false,\n  };\n}\n\n/** Returns the named collection, creating it when absent. */\nfunction collectionOf<V>(\n  collections: IconsCollection<V>,\n  name: string\n): Map<string, V> {\n  let collection = collections.get(name);\n\n  if (!collection) {\n    collection = new Map();\n    collections.set(name, collection);\n  }\n\n  return collection;\n}\n\n/**\n * Global singleton registry for managing SVG icons and their references.\n *\n * @remarks\n * The registry stores SVG icons in named collections, resolves aliases against\n * the active theme, notifies subscribers once per microtask however many icons\n * changed, and publishes user-set state to other browsing contexts (see\n * {@link IconsStateBroadcast}).\n *\n * @internal Not exposed directly - use the exported functions.\n */\nclass IconsRegistry {\n  private readonly _listeners = new Set<IconCallback>();\n  private readonly _references: IconsCollection<IconMeta> = new Map();\n  private readonly _collections: IconsCollection<SvgIcon> = new Map([\n    ['internal', internalIcons],\n  ]);\n  private readonly _svgIconParser = new SvgIconParser();\n  private readonly _broadcast = new IconsStateBroadcast(\n    this._collections,\n    this._references\n  );\n  private _notificationScheduled = false;\n\n  /**\n   * Parses and stores an SVG icon, then publishes and notifies.\n   *\n   * @param stripMeta - See {@link RegisterIconOptions.stripMeta}.\n   * @throws If the SVG text is malformed.\n   */\n  public register(\n    name: string,\n    iconText: string,\n    collection = 'default',\n    stripMeta = false\n  ): void {\n    const svgIcon = this._svgIconParser.parse(iconText, stripMeta);\n    collectionOf(this._collections, collection).set(name, svgIcon);\n\n    this._broadcast.send({\n      actionType: ActionType.RegisterIcon,\n      collections: new Map([[collection, new Map([[name, svgIcon]])]]),\n    });\n\n    this._notify();\n  }\n\n  /**\n   * Subscribes a callback to registry changes. It is invoked once per\n   * microtask, however many icons changed, so subscribers re-resolve their\n   * own state.\n   */\n  public subscribe(callback: IconCallback): void {\n    this._listeners.add(callback);\n  }\n\n  /** Unsubscribes a previously subscribed callback. */\n  public unsubscribe(callback: IconCallback): void {\n    this._listeners.delete(callback);\n  }\n\n  /**\n   * Aliases an icon name to another icon.\n   *\n   * @remarks\n   * `overwrite` stores the reference and notifies subscribers; `external`\n   * marks it as user-set, which takes precedence over the built-in theme\n   * aliases and is published to other browsing contexts.\n   */\n  public setIconRef(options: IconReferencePair): void {\n    const { alias, target, overwrite } = options;\n\n    if (overwrite) {\n      collectionOf(this._references, alias.collection).set(alias.name, {\n        name: target.name,\n        collection: target.collection,\n        external: target.external,\n      });\n      this._notify();\n    }\n\n    if (target.external) {\n      const ref = { name: target.name, collection: target.collection };\n\n      this._broadcast.send({\n        actionType: ActionType.UpdateIconReference,\n        references: new Map([[alias.collection, new Map([[alias.name, ref]])]]),\n      });\n    }\n  }\n\n  /**\n   * Resolves a name that may be an alias to the icon it points at, for the\n   * given theme. The result never carries the internal `external` flag.\n   */\n  public getIconRef(name: string, collection: string, theme?: Theme): IconMeta {\n    // Check for any user-set reference first (external or internal)\n    const storedRef = this._references.get(collection)?.get(name);\n    if (storedRef) {\n      return {\n        name: storedRef.name,\n        collection: storedRef.collection,\n      };\n    }\n\n    // Resolve theme-based alias for the default collection\n    if (collection === 'default' && theme) {\n      const targets = ICON_REFERENCES.get(name);\n      const target = targets?.get(theme) ?? targets?.get('default');\n\n      if (target) {\n        return target;\n      }\n    }\n\n    return { name, collection };\n  }\n\n  /** Retrieves an icon. Resolve aliases with `getIconRef` first. */\n  public get(name: string, collection = 'default'): SvgIcon | undefined {\n    return this._collections.get(collection)?.get(name);\n  }\n\n  /**\n   * Notifies subscribers, coalescing a burst of changes in the same microtask\n   * into a single notification.\n   */\n  private _notify(): void {\n    if (this._notificationScheduled) {\n      return;\n    }\n\n    this._notificationScheduled = true;\n\n    queueMicrotask(() => {\n      this._notificationScheduled = false;\n\n      for (const listener of this._listeners) {\n        listener();\n      }\n    });\n  }\n}\n\nconst registry = Symbol.for('igc.icons-registry.instance');\n\ntype IgcIconRegistry = typeof globalThis & {\n  [registry]?: IconsRegistry;\n};\n\n/**\n * Gets the icon registry, creating it on first use. The well-known symbol on\n * `globalThis` keeps it a single instance even across multiple bundles.\n */\nexport function getIconRegistry(): IconsRegistry {\n  const global = globalThis as IgcIconRegistry;\n  global[registry] ??= new IconsRegistry();\n  return global[registry];\n}\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param collection - The collection to register the icon in (default: `'default'`)\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collection?: string\n): Promise<void>;\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param options - Registration options: target collection and/or `stripMeta`\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n *\n * @remarks\n * This overload accepts a {@link RegisterIconOptions} object so you can control\n * the target collection **and** opt into SVG meta stripping in one call:\n *\n * ```typescript\n * // Strip <title>/<desc> to prevent browser-native tooltips on hover\n * await registerIcon('home', '/icons/home.svg', { stripMeta: true });\n *\n * // Or with a custom collection:\n * await registerIcon('home', '/icons/home.svg', {\n *   collection: 'my-lib',\n *   stripMeta: true,\n * });\n * ```\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  options?: RegisterIconOptions\n): Promise<void>;\n\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collectionOrOptions?: string | RegisterIconOptions\n): Promise<void> {\n  const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);\n  const response = await fetch(url);\n\n  if (response.ok) {\n    const value = await response.text();\n    getIconRegistry().register(name, value, collection, stripMeta);\n  } else {\n    throw new Error(`Icon request failed. Status: ${response.status}.`);\n  }\n}\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param collection - The collection to register the icon in (default: `'default'`)\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collection?: string\n): void;\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param options - Registration options: target collection and/or `stripMeta`\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n *\n * @remarks\n * This overload accepts a {@link RegisterIconOptions} object so you can control\n * the target collection **and** opt into SVG meta stripping in one call:\n *\n * ```typescript\n * const iconSvg = '<svg viewBox=\"0 0 24 24\"><title>Home</title><path d=\"...\"/></svg>';\n *\n * // Strip <title>/<desc> to prevent browser-native tooltips on hover\n * registerIconFromText('home', iconSvg, { stripMeta: true });\n *\n * // Or with a custom collection:\n * registerIconFromText('home', iconSvg, { collection: 'my-lib', stripMeta: true });\n * ```\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  options?: RegisterIconOptions\n): void;\n\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collectionOrOptions?: string | RegisterIconOptions\n): void {\n  const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);\n  getIconRegistry().register(name, iconText, collection, stripMeta);\n}\n\n/**\n * Sets an icon reference/alias that points to another icon.\n *\n * @param name - The alias name\n * @param collection - The collection for the alias\n * @param icon - The target icon metadata (name and collection)\n *\n * @remarks\n * Icon references allow you to create aliases that point to other icons.\n * This is useful for:\n * - Creating semantic names (e.g., 'close' → 'x')\n * - Overriding default icon mappings\n * - Providing fallbacks for missing icons\n *\n * User-set references are marked as external and have higher priority than\n * theme-based aliases. They are also published to other browsing contexts.\n *\n * @example\n * ```typescript\n * // Register target icon\n * registerIconFromText('x-mark', '<svg>...</svg>');\n *\n * // Create an alias\n * setIconRef('close', 'default', {\n *   name: 'x-mark',\n *   collection: 'default'\n * });\n *\n * // Both work the same way:\n * // <igc-icon name=\"close\"></igc-icon>\n * // <igc-icon name=\"x-mark\"></igc-icon>\n * ```\n */\nexport function setIconRef(name: string, collection: string, icon: IconMeta) {\n  getIconRegistry().setIconRef({\n    alias: { name, collection },\n    target: {\n      name: icon.name,\n      collection: icon.collection,\n      external: true,\n    },\n    overwrite: true,\n  });\n}\n"]}
+{"version":3,"file":"icon.registry.js","sourceRoot":"","sources":["../../../src/components/icon/icon.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Theme } from '#theming/types.js';\nimport { ICON_REFERENCES } from './icon-references.js';\nimport { IconsStateBroadcast } from './icon-state.broadcast.js';\nimport { internalIcons } from './internal-icons-lib.js';\nimport { SvgIconParser } from './registry/parser.js';\nimport type {\n  IconCallback,\n  IconMeta,\n  IconReferencePair,\n  IconsCollection,\n  RegisterIconOptions,\n  SvgIcon,\n} from './registry/types.js';\nimport { ActionType } from './registry/types.js';\n\n/**\n * Normalizes the third argument of `registerIcon` / `registerIconFromText`,\n * which is either a collection name or a {@link RegisterIconOptions} object.\n */\nfunction resolveIconOptions(\n  collectionOrOptions?: string | RegisterIconOptions\n): Required<RegisterIconOptions> {\n  if (typeof collectionOrOptions === 'string') {\n    return { collection: collectionOrOptions, stripMeta: false };\n  }\n\n  return {\n    collection: collectionOrOptions?.collection ?? 'default',\n    stripMeta: collectionOrOptions?.stripMeta ?? false,\n  };\n}\n\n/** Returns the named collection, creating it when absent. */\nfunction collectionOf<V>(\n  collections: IconsCollection<V>,\n  name: string\n): Map<string, V> {\n  let collection = collections.get(name);\n\n  if (!collection) {\n    collection = new Map();\n    collections.set(name, collection);\n  }\n\n  return collection;\n}\n\n/**\n * The global registry of SVG icons and their references.\n *\n * @remarks\n * The registry keeps the icons in named collections, resolves an alias against\n * the active theme, notifies the subscribers one time per microtask however\n * many icons changed, and publishes user-set state to the other browsing\n * contexts. See {@link IconsStateBroadcast}.\n *\n * @internal Use the exported functions.\n */\nclass IconsRegistry {\n  private readonly _listeners = new Set<IconCallback>();\n  private readonly _references: IconsCollection<IconMeta> = new Map();\n  private readonly _collections: IconsCollection<SvgIcon> = new Map([\n    ['internal', internalIcons],\n  ]);\n  private readonly _svgIconParser = new SvgIconParser();\n  private readonly _broadcast = new IconsStateBroadcast(\n    this._collections,\n    this._references\n  );\n  private _notificationScheduled = false;\n\n  /**\n   * Parses and stores an SVG icon, then publishes and notifies.\n   *\n   * @param stripMeta - See {@link RegisterIconOptions.stripMeta}.\n   * @throws If the SVG text is malformed.\n   */\n  public register(\n    name: string,\n    iconText: string,\n    collection = 'default',\n    stripMeta = false\n  ): void {\n    const svgIcon = this._svgIconParser.parse(iconText, stripMeta);\n    collectionOf(this._collections, collection).set(name, svgIcon);\n\n    this._broadcast.send({\n      actionType: ActionType.RegisterIcon,\n      collections: new Map([[collection, new Map([[name, svgIcon]])]]),\n    });\n\n    this._notify();\n  }\n\n  /**\n   * Subscribes a callback to registry changes. It is invoked once per\n   * microtask, however many icons changed, so subscribers re-resolve their\n   * own state.\n   */\n  public subscribe(callback: IconCallback): void {\n    this._listeners.add(callback);\n  }\n\n  /** Unsubscribes a previously subscribed callback. */\n  public unsubscribe(callback: IconCallback): void {\n    this._listeners.delete(callback);\n  }\n\n  /**\n   * Aliases an icon name to another icon.\n   *\n   * @remarks\n   * `overwrite` stores the reference and notifies subscribers; `external`\n   * marks it as user-set, which takes precedence over the built-in theme\n   * aliases and is published to other browsing contexts.\n   */\n  public setIconRef(options: IconReferencePair): void {\n    const { alias, target, overwrite } = options;\n\n    if (overwrite) {\n      collectionOf(this._references, alias.collection).set(alias.name, {\n        name: target.name,\n        collection: target.collection,\n        external: target.external,\n      });\n      this._notify();\n    }\n\n    if (target.external) {\n      const ref = { name: target.name, collection: target.collection };\n\n      this._broadcast.send({\n        actionType: ActionType.UpdateIconReference,\n        references: new Map([[alias.collection, new Map([[alias.name, ref]])]]),\n      });\n    }\n  }\n\n  /**\n   * Resolves a name that may be an alias to the icon it points at, for the\n   * given theme. The result never carries the internal `external` flag.\n   */\n  public getIconRef(name: string, collection: string, theme?: Theme): IconMeta {\n    // Check for any user-set reference first (external or internal)\n    const storedRef = this._references.get(collection)?.get(name);\n    if (storedRef) {\n      return {\n        name: storedRef.name,\n        collection: storedRef.collection,\n      };\n    }\n\n    // Resolve theme-based alias for the default collection\n    if (collection === 'default' && theme) {\n      const targets = ICON_REFERENCES.get(name);\n      const target = targets?.get(theme) ?? targets?.get('default');\n\n      if (target) {\n        return target;\n      }\n    }\n\n    return { name, collection };\n  }\n\n  /** Retrieves an icon. Resolve aliases with `getIconRef` first. */\n  public get(name: string, collection = 'default'): SvgIcon | undefined {\n    return this._collections.get(collection)?.get(name);\n  }\n\n  /**\n   * Notifies subscribers, coalescing a burst of changes in the same microtask\n   * into a single notification.\n   */\n  private _notify(): void {\n    if (this._notificationScheduled) {\n      return;\n    }\n\n    this._notificationScheduled = true;\n\n    queueMicrotask(() => {\n      this._notificationScheduled = false;\n\n      for (const listener of this._listeners) {\n        listener();\n      }\n    });\n  }\n}\n\nconst registry = Symbol.for('igc.icons-registry.instance');\n\ntype IgcIconRegistry = typeof globalThis & {\n  [registry]?: IconsRegistry;\n};\n\n/**\n * Gets the icon registry, creating it on first use. The well-known symbol on\n * `globalThis` keeps it a single instance even across multiple bundles.\n */\nexport function getIconRegistry(): IconsRegistry {\n  const global = globalThis as IgcIconRegistry;\n  global[registry] ??= new IconsRegistry();\n  return global[registry];\n}\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param collection - The collection to register the icon in (default: `'default'`)\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collection?: string\n): Promise<void>;\n\n/**\n * Registers an icon by fetching it from a URL.\n *\n * @param name - The unique name for the icon\n * @param url - The URL to fetch the SVG icon from\n * @param options - Registration options: target collection and/or `stripMeta`\n *\n * @returns A promise that resolves when the icon is registered\n *\n * @throws If the HTTP request fails or returns a non-OK status\n *\n * @remarks\n * This overload accepts a {@link RegisterIconOptions} object so you can control\n * the target collection **and** opt into SVG meta stripping in one call:\n *\n * ```typescript\n * // Strip <title>/<desc> to prevent browser-native tooltips on hover\n * await registerIcon('home', '/icons/home.svg', { stripMeta: true });\n *\n * // Or with a custom collection:\n * await registerIcon('home', '/icons/home.svg', {\n *   collection: 'my-lib',\n *   stripMeta: true,\n * });\n * ```\n */\nexport async function registerIcon(\n  name: string,\n  url: string,\n  options?: RegisterIconOptions\n): Promise<void>;\n\nexport async function registerIcon(\n  name: string,\n  url: string,\n  collectionOrOptions?: string | RegisterIconOptions\n): Promise<void> {\n  const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);\n  const response = await fetch(url);\n\n  if (response.ok) {\n    const value = await response.text();\n    getIconRegistry().register(name, value, collection, stripMeta);\n  } else {\n    throw new Error(`Icon request failed. Status: ${response.status}.`);\n  }\n}\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param collection - The collection to register the icon in (default: `'default'`)\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collection?: string\n): void;\n\n/**\n * Registers an icon from SVG text content.\n *\n * @param name - The unique name for the icon\n * @param iconText - The SVG markup as a string\n * @param options - Registration options: target collection and/or `stripMeta`\n *\n * @throws If the SVG text is malformed or doesn't contain an SVG element\n *\n * @remarks\n * This overload accepts a {@link RegisterIconOptions} object so you can control\n * the target collection **and** opt into SVG meta stripping in one call:\n *\n * ```typescript\n * const iconSvg = '<svg viewBox=\"0 0 24 24\"><title>Home</title><path d=\"...\"/></svg>';\n *\n * // Strip <title>/<desc> to prevent browser-native tooltips on hover\n * registerIconFromText('home', iconSvg, { stripMeta: true });\n *\n * // Or with a custom collection:\n * registerIconFromText('home', iconSvg, { collection: 'my-lib', stripMeta: true });\n * ```\n */\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  options?: RegisterIconOptions\n): void;\n\nexport function registerIconFromText(\n  name: string,\n  iconText: string,\n  collectionOrOptions?: string | RegisterIconOptions\n): void {\n  const { collection, stripMeta } = resolveIconOptions(collectionOrOptions);\n  getIconRegistry().register(name, iconText, collection, stripMeta);\n}\n\n/**\n * Sets an icon reference/alias that points to another icon.\n *\n * @param name - The alias name\n * @param collection - The collection for the alias\n * @param icon - The target icon metadata (name and collection)\n *\n * @remarks\n * Icon references allow you to create aliases that point to other icons.\n * This is useful for:\n * - Creating semantic names (e.g., 'close' → 'x')\n * - Overriding default icon mappings\n * - Providing fallbacks for missing icons\n *\n * User-set references are marked as external and have higher priority than\n * theme-based aliases. They are also published to other browsing contexts.\n *\n * @example\n * ```typescript\n * // Register target icon\n * registerIconFromText('x-mark', '<svg>...</svg>');\n *\n * // Create an alias\n * setIconRef('close', 'default', {\n *   name: 'x-mark',\n *   collection: 'default'\n * });\n *\n * // Both work the same way:\n * // <igc-icon name=\"close\"></igc-icon>\n * // <igc-icon name=\"x-mark\"></igc-icon>\n * ```\n */\nexport function setIconRef(name: string, collection: string, icon: IconMeta) {\n  getIconRegistry().setIconRef({\n    alias: { name, collection },\n    target: {\n      name: icon.name,\n      collection: icon.collection,\n      external: true,\n    },\n    overwrite: true,\n  });\n}\n"]}

package/components/input/input-base.d.ts

@@ -15,8 +15,8 @@ export declare abstract class IgcInputBaseComponent extends IgcInputBaseComponen
     protected readonly _inputId: string;
     protected readonly _input?: HTMLInputElement;
     /**
-     * Receives ARIA semantics projected by a composite host (e.g. `igc-select`)
-     * onto the inner native input. See {@link addAriaTarget}.
+     * Names and describes the native input, and applies the ARIA that a
+     * composite host, for example `igc-select`, projects. See {@link addAriaTarget}.
      */
     protected readonly _ariaTarget: import("#internals/controllers/aria-projection.js").AriaTargetController;
     /** The value of the control. */

package/components/input/input-base.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { LitElement, nothing } from 'lit';
 import { property, query } from 'lit/decorators.js';
 import { cache } from 'lit/directives/cache.js';
-import { addAriaTarget } from '#internals/controllers/aria-projection.js';
+import { addAriaTarget, helperText, } from '#internals/controllers/aria-projection.js';
 import { blazorDeepImport } from '#internals/decorators/blazorDeepImport.js';
 import { shadowOptions } from '#internals/decorators/shadow-options.js';
 import { EventEmitterMixin } from '#internals/mixins/event-emitter.js';
@@ -18,10 +18,8 @@ let IgcInputBaseComponent = class IgcInputBaseComponent extends FormAssociatedRe
         super(...arguments);
         this._inputId = nextInputId();
         this._ariaTarget = addAriaTarget(this, {
-            labels: () => this._internals.labels,
-            description: () => this._slots.hasAssignedElements('helper-text')
-                ? this.renderRoot.querySelector('#helper-text')
-                : null,
+            description: () => helperText(this, this._slots),
+            hasOwnLabel: () => Boolean(this.label),
         });
         this.outlined = false;
     }

package/components/input/input-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-base.js","sourceRoot":"","sources":["../../../src/components/input/input-base.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC;AAoBtC,IAAe,qBAAqB,GAApC,MAAe,qBAAsB,SAAQ,2BAA2B,CAC7E,iBAAiB,CACf,UAAU,CACX,CACF;IAJM;;QAQc,aAAQ,GAAG,WAAW,EAAE,CAAC;QASzB,gBAAW,GAAG,aAAa,CAAC,IAAI,EAAE;YACnD,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM;YACpC,WAAW,EAAE,GAAG,EAAE,CAChB,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC;gBAC5C,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,cAAc,CAAC;gBAC/C,CAAC,CAAC,IAAI;SACX,CAAC,CAAC;QAaI,aAAQ,GAAG,KAAK,CAAC;IA2D1B,CAAC;IAvCW,iBAAiB,CAAC,IAAY;QACtC,OAAO,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAGM,MAAM;QACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC;IAIe,KAAK,CAAC,OAAsB;QAC1C,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAIe,IAAI;QAClB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAIS,gBAAgB;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAEkB,MAAM;QACvB,OAAO,KAAK,CACV,gBAAgB,CAAC,IAAI,EAAE;YACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC;YACnD,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,eAAe,EAAE,IAAI,CAAC,gBAAgB;SACvC,CAAC,CACH,CAAC;IACJ,CAAC;CACF,CAAA;AApFoB;IADlB,KAAK,CAAC,OAAO,CAAC;qDAC8B;AAyBtC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;uDACnB;AAOjB;IADN,QAAQ,EAAE;0DACiB;AAOrB;IADN,QAAQ,EAAE;oDACW;AAlDF,qBAAqB;IAF1C,gBAAgB;IAChB,aAAa,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;GAClB,qBAAqB,CA+F1C","sourcesContent":["import { LitElement, nothing, type TemplateResult } from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { cache } from 'lit/directives/cache.js';\nimport { addAriaTarget } from '#internals/controllers/aria-projection.js';\nimport type { SlotController } from '#internals/controllers/slot.js';\nimport { blazorDeepImport } from '#internals/decorators/blazorDeepImport.js';\nimport { shadowOptions } from '#internals/decorators/shadow-options.js';\nimport type { Constructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { FormAssociatedRequiredMixin } from '#internals/mixins/forms/associated-required.js';\nimport {\n  nextInputId,\n  renderInputShell,\n  resolveInputPartNames,\n} from '#internals/templates/input-shell.js';\nimport type { ThemingController } from '#theming/theming-controller.js';\n\nexport interface IgcInputComponentEventMap {\n  /* alternateName: inputOcurred */\n  igcInput: CustomEvent<string>;\n  /* blazorSuppress */\n  igcChange: CustomEvent<string>;\n  // For analyzer meta only:\n  /* skipWCPrefix */\n  focus: FocusEvent;\n  /* skipWCPrefix */\n  blur: FocusEvent;\n}\n\n/* blazorIndirectRender */\n/* blazorSupportsVisualChildren */\n/* omitModule */\n@blazorDeepImport\n@shadowOptions({ delegatesFocus: true })\nexport abstract class IgcInputBaseComponent extends FormAssociatedRequiredMixin(\n  EventEmitterMixin<IgcInputComponentEventMap, Constructor<LitElement>>(\n    LitElement\n  )\n) {\n  protected abstract readonly _themes: ThemingController;\n  protected abstract readonly _slots: SlotController<any>;\n\n  protected readonly _inputId = nextInputId();\n\n  @query('input')\n  protected readonly _input?: HTMLInputElement;\n\n  /**\n   * Receives ARIA semantics projected by a composite host (e.g. `igc-select`)\n   * onto the inner native input. See {@link addAriaTarget}.\n   */\n  protected readonly _ariaTarget = addAriaTarget(this, {\n    labels: () => this._internals.labels,\n    description: () =>\n      this._slots.hasAssignedElements('helper-text')\n        ? this.renderRoot.querySelector('#helper-text')\n        : null,\n  });\n\n  /* blazorSuppress */\n  /** The value of the control. */\n  public abstract value: string;\n\n  /**\n   * Whether the control will have outlined appearance.\n   *\n   * @attr\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public outlined = false;\n\n  /**\n   * The placeholder text of the control.\n   * @attr\n   */\n  @property()\n  public placeholder!: string;\n\n  /**\n   * The label for the control.\n   * @attr\n   */\n  @property()\n  public label!: string;\n\n  /**\n   * Resolves the part names for the container based on the current state.\n   * Used to apply conditional styling via CSS parts.\n   */\n  protected _resolvePartNames(base: string) {\n    return resolveInputPartNames(this._slots, base, !!this.value);\n  }\n\n  /** Selects all the text inside the input. */\n  public select(): void {\n    this._input?.select();\n  }\n\n  /* alternateName: focusComponent */\n  /** Sets focus on the control. */\n  public override focus(options?: FocusOptions): void {\n    this._input?.focus(options);\n  }\n\n  /* alternateName: blurComponent */\n  /** Removes focus from the control. */\n  public override blur(): void {\n    this._input?.blur();\n  }\n\n  protected abstract _renderInput(): TemplateResult;\n\n  protected _renderFileParts(): TemplateResult | typeof nothing {\n    return nothing;\n  }\n\n  protected override render() {\n    return cache(\n      renderInputShell(this, {\n        theme: this._themes.theme,\n        label: this.label,\n        labelId: this._inputId,\n        containerParts: this._resolvePartNames('container'),\n        renderInput: this._renderInput,\n        renderFileParts: this._renderFileParts,\n      })\n    );\n  }\n}\n"]}
+{"version":3,"file":"input-base.js","sourceRoot":"","sources":["../../../src/components/input/input-base.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EACL,aAAa,EACb,UAAU,GACX,MAAM,2CAA2C,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC;AAoBtC,IAAe,qBAAqB,GAApC,MAAe,qBAAsB,SAAQ,2BAA2B,CAC7E,iBAAiB,CACf,UAAU,CACX,CACF;IAJM;;QAQc,aAAQ,GAAG,WAAW,EAAE,CAAC;QASzB,gBAAW,GAAG,aAAa,CAAC,IAAI,EAAE;YACnD,WAAW,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChD,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;SACvC,CAAC,CAAC;QAaI,aAAQ,GAAG,KAAK,CAAC;IA2D1B,CAAC;IAvCW,iBAAiB,CAAC,IAAY;QACtC,OAAO,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAGM,MAAM;QACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC;IAIe,KAAK,CAAC,OAAsB;QAC1C,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAIe,IAAI;QAClB,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAIS,gBAAgB;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAEkB,MAAM;QACvB,OAAO,KAAK,CACV,gBAAgB,CAAC,IAAI,EAAE;YACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC;YACnD,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,eAAe,EAAE,IAAI,CAAC,gBAAgB;SACvC,CAAC,CACH,CAAC;IACJ,CAAC;CACF,CAAA;AAjFoB;IADlB,KAAK,CAAC,OAAO,CAAC;qDAC8B;AAsBtC;IADN,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;uDACnB;AAOjB;IADN,QAAQ,EAAE;0DACiB;AAOrB;IADN,QAAQ,EAAE;oDACW;AA/CF,qBAAqB;IAF1C,gBAAgB;IAChB,aAAa,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;GAClB,qBAAqB,CA4F1C","sourcesContent":["import { LitElement, nothing, type TemplateResult } from 'lit';\nimport { property, query } from 'lit/decorators.js';\nimport { cache } from 'lit/directives/cache.js';\nimport {\n  addAriaTarget,\n  helperText,\n} from '#internals/controllers/aria-projection.js';\nimport type { SlotController } from '#internals/controllers/slot.js';\nimport { blazorDeepImport } from '#internals/decorators/blazorDeepImport.js';\nimport { shadowOptions } from '#internals/decorators/shadow-options.js';\nimport type { Constructor } from '#internals/mixins/constructor.js';\nimport { EventEmitterMixin } from '#internals/mixins/event-emitter.js';\nimport { FormAssociatedRequiredMixin } from '#internals/mixins/forms/associated-required.js';\nimport {\n  nextInputId,\n  renderInputShell,\n  resolveInputPartNames,\n} from '#internals/templates/input-shell.js';\nimport type { ThemingController } from '#theming/theming-controller.js';\n\nexport interface IgcInputComponentEventMap {\n  /* alternateName: inputOcurred */\n  igcInput: CustomEvent<string>;\n  /* blazorSuppress */\n  igcChange: CustomEvent<string>;\n  // For analyzer meta only:\n  /* skipWCPrefix */\n  focus: FocusEvent;\n  /* skipWCPrefix */\n  blur: FocusEvent;\n}\n\n/* blazorIndirectRender */\n/* blazorSupportsVisualChildren */\n/* omitModule */\n@blazorDeepImport\n@shadowOptions({ delegatesFocus: true })\nexport abstract class IgcInputBaseComponent extends FormAssociatedRequiredMixin(\n  EventEmitterMixin<IgcInputComponentEventMap, Constructor<LitElement>>(\n    LitElement\n  )\n) {\n  protected abstract readonly _themes: ThemingController;\n  protected abstract readonly _slots: SlotController<any>;\n\n  protected readonly _inputId = nextInputId();\n\n  @query('input')\n  protected readonly _input?: HTMLInputElement;\n\n  /**\n   * Names and describes the native input, and applies the ARIA that a\n   * composite host, for example `igc-select`, projects. See {@link addAriaTarget}.\n   */\n  protected readonly _ariaTarget = addAriaTarget(this, {\n    description: () => helperText(this, this._slots),\n    hasOwnLabel: () => Boolean(this.label),\n  });\n\n  /* blazorSuppress */\n  /** The value of the control. */\n  public abstract value: string;\n\n  /**\n   * Whether the control will have outlined appearance.\n   *\n   * @attr\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true })\n  public outlined = false;\n\n  /**\n   * The placeholder text of the control.\n   * @attr\n   */\n  @property()\n  public placeholder!: string;\n\n  /**\n   * The label for the control.\n   * @attr\n   */\n  @property()\n  public label!: string;\n\n  /**\n   * Resolves the part names for the container based on the current state.\n   * Used to apply conditional styling via CSS parts.\n   */\n  protected _resolvePartNames(base: string) {\n    return resolveInputPartNames(this._slots, base, !!this.value);\n  }\n\n  /** Selects all the text inside the input. */\n  public select(): void {\n    this._input?.select();\n  }\n\n  /* alternateName: focusComponent */\n  /** Sets focus on the control. */\n  public override focus(options?: FocusOptions): void {\n    this._input?.focus(options);\n  }\n\n  /* alternateName: blurComponent */\n  /** Removes focus from the control. */\n  public override blur(): void {\n    this._input?.blur();\n  }\n\n  protected abstract _renderInput(): TemplateResult;\n\n  protected _renderFileParts(): TemplateResult | typeof nothing {\n    return nothing;\n  }\n\n  protected override render() {\n    return cache(\n      renderInputShell(this, {\n        theme: this._themes.theme,\n        label: this.label,\n        labelId: this._inputId,\n        containerParts: this._resolvePartNames('container'),\n        renderInput: this._renderInput,\n        renderFileParts: this._renderFileParts,\n      })\n    );\n  }\n}\n"]}

package/components/input/input.d.ts

@@ -10,7 +10,7 @@ import { IgcInputBaseComponent } from './input-base.js';
  * @slot suffix - Renders content after input.
  * @slot helper-text - Renders content below the input.
  * @slot value-missing - Renders content when the required validation fails.
- * @slot type-mismatch - Renders content when the a type url/email input pattern validation fails.
+ * @slot type-mismatch - Renders content when the url/email type validation fails.
  * @slot pattern-mismatch - Renders content when the pattern validation fails.
  * @slot too-long - Renders content when the maxlength validation fails.
  * @slot too-short - Renders content when the minlength validation fails.
@@ -21,7 +21,7 @@ import { IgcInputBaseComponent } from './input-base.js';
  * @slot invalid - Renders content when the component is in invalid state (validity.valid = false).
  *
  * @fires igcInput - Emitted when the control input receives user input.
- * @fires igcChange - Emitted when the control's checked state changes.
+ * @fires igcChange - Emitted when the value of the control is committed.
  *
  * @csspart container - The main wrapper that holds all main input elements.
  * @csspart input - The native input element.
@@ -37,7 +37,7 @@ export default class IgcInputComponent extends IgcInputBaseComponent {
     private static readonly _revalidate;
     static register(): void;
     protected readonly _themes: import("#theming/theming-controller.js").ThemingController;
-    protected readonly _slots: import("#internals/controllers/slot.js").SlotController<"invalid" | "prefix" | "helper-text" | "[default]" | "suffix" | "value-missing" | "too-long" | "too-short" | "custom-error" | "range-overflow" | "range-underflow" | "type-mismatch" | "pattern-mismatch" | "step-mismatch">;
+    protected readonly _slots: import("#internals/controllers/slot.js").SlotController<"invalid" | "prefix" | "[default]" | "suffix" | "helper-text" | "value-missing" | "range-overflow" | "range-underflow" | "custom-error" | "too-long" | "too-short" | "type-mismatch" | "pattern-mismatch" | "step-mismatch">;
     protected readonly _formValue: import("#internals/mixins/forms/form-value.js").FormValue<string>;
     protected get __validators(): import("../../internals/validators.js").Validator<IgcInputComponent>[];
     /**

package/components/input/input.js.map

@@ -1 +1 @@
-{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/components/input/input.ts"],"names":[],"mappings":"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","sourcesContent":["import { html } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { live } from 'lit/directives/live.js';\nimport { ariaBindings } from '#internals/controllers/aria-projection.js';\nimport { addSlotController, setSlots } from '#internals/controllers/slot.js';\nimport {\n  coercedProperty,\n  type CoercedPropertyConfig,\n} from '#internals/decorators/coerced-property.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport { createFormValueState } from '#internals/mixins/forms/form-value.js';\nimport { partMap } from '#internals/part-map.js';\nimport { bindIf } from '#internals/utils/lit.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport type {\n  InputType,\n  RangeTextSelectMode,\n  SelectionRangeDirection,\n} from '../types.js';\nimport IgcValidationContainerComponent from '../validation-container/validation-container.js';\nimport { IgcInputBaseComponent } from './input-base.js';\nimport { styles } from './themes/input.base.css.js';\nimport { styles as shared } from './themes/shared/input.common.css.js';\nimport { all } from './themes/themes.js';\nimport { numberValidators, stringValidators } from './validators.js';\n\nconst Slots = setSlots(\n  'prefix',\n  'suffix',\n  'helper-text',\n  'value-missing',\n  'type-mismatch',\n  'pattern-mismatch',\n  'too-long',\n  'too-short',\n  'range-overflow',\n  'range-underflow',\n  'step-mismatch',\n  'custom-error',\n  'invalid'\n);\n\n/**\n * A highly customizable single-line text field for entering and editing data,\n * with support for prefix/suffix content, helper text, form integration, and built-in validation.\n *\n * @element igc-input\n *\n * @slot prefix - Renders content before the input.\n * @slot suffix - Renders content after input.\n * @slot helper-text - Renders content below the input.\n * @slot value-missing - Renders content when the required validation fails.\n * @slot type-mismatch - Renders content when the a type url/email input pattern validation fails.\n * @slot pattern-mismatch - Renders content when the pattern validation fails.\n * @slot too-long - Renders content when the maxlength validation fails.\n * @slot too-short - Renders content when the minlength validation fails.\n * @slot range-overflow - Renders content when the max validation fails.\n * @slot range-underflow - Renders content when the min validation fails.\n * @slot step-mismatch - Renders content when the step validation fails.\n * @slot custom-error - Renders content when setCustomValidity(message) is set.\n * @slot invalid - Renders content when the component is in invalid state (validity.valid = false).\n *\n * @fires igcInput - Emitted when the control input receives user input.\n * @fires igcChange - Emitted when the control's checked state changes.\n *\n * @csspart container - The main wrapper that holds all main input elements.\n * @csspart input - The native input element.\n * @csspart label - The native label element.\n * @csspart prefix - The prefix wrapper.\n * @csspart suffix - The suffix wrapper.\n * @csspart helper-text - The helper text wrapper.\n */\nexport default class IgcInputComponent extends IgcInputBaseComponent {\n  public static readonly tagName = 'igc-input';\n  public static styles = [styles, shared];\n\n  /** Shared config for the constraint properties - a change revalidates. */\n  private static readonly _revalidate: CoercedPropertyConfig<\n    unknown,\n    IgcInputComponent\n  > = {\n    onChange: ({ host }) => host._validate(),\n  };\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcInputComponent, IgcValidationContainerComponent);\n  }\n\n  protected override readonly _themes = addThemingController(this, all);\n\n  protected override readonly _slots = addSlotController(this, {\n    slots: Slots,\n  });\n\n  protected override readonly _formValue = createFormValueState(this, {\n    initialValue: '',\n  });\n\n  protected override get __validators() {\n    return this.type !== 'number' ? stringValidators : numberValidators;\n  }\n\n  /* @tsTwoWayProperty(true, \"igcChange\", \"detail\", false) */\n  /**\n   * The value of the control.\n   * @attr\n   */\n  @property()\n  public set value(value: string) {\n    this._formValue.setValueAndFormState(value);\n  }\n\n  public get value(): string {\n    return this._formValue.value;\n  }\n\n  /* alternateName: displayType */\n  /**\n   * The type of the control.\n   * @attr\n   */\n  @property({ reflect: true })\n  public type: InputType = 'text';\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   * A hint to the browser for which virtual keyboard layout to display.\n   * See [relevant MDN article](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inputmode)\n   * @attr inputmode\n   */\n  @property({ attribute: 'inputmode' })\n  public override inputMode!: string;\n\n  /**\n   * The regular expression the value is validated against.\n   * @attr\n   */\n  @property()\n  @coercedProperty(IgcInputComponent._revalidate)\n  public pattern?: string = undefined;\n\n  /**\n   * The minimum string length required by the control.\n   * @attr minlength\n   */\n  @property({ type: Number, attribute: 'minlength' })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public minLength?: number = undefined;\n\n  /**\n   * The maximum string length of the control.\n   * @attr maxlength\n   */\n  @property({ type: Number, attribute: 'maxlength' })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public maxLength?: number = undefined;\n\n  /**\n   * The minimum value the control accepts.\n   * @attr\n   */\n  @property({ type: Number })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public min?: number = undefined;\n\n  /**\n   * The maximum value the control accepts.\n   * @attr\n   */\n  @property({ type: Number })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public max?: number = undefined;\n\n  /**\n   * The granularity the value must adhere to.\n   * @attr\n   */\n  @property({ type: Number })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public step?: number = undefined;\n\n  /**\n   * Whether the control should receive focus automatically.\n   * @attr\n   */\n  @property({ type: Boolean })\n  public override autofocus!: boolean;\n\n  /**\n   * A hint for the browser on how to autofill the control.\n   * @attr\n   */\n  @property()\n  public autocomplete!: string;\n\n  /**\n   * Enables validation rules to be evaluated without restricting user input. This applies to the `maxLength` property for\n   * string-type inputs or allows spin buttons to exceed the predefined `min/max` limits for number-type inputs.\n   *\n   * @attr validate-only\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'validate-only' })\n  public validateOnly = false;\n\n  /* blazorSuppress */\n  /** Replaces the selected text in the input. */\n  public setRangeText(\n    replacement: string,\n    start?: number,\n    end?: number,\n    selectMode: RangeTextSelectMode = 'preserve'\n  ): void {\n    this._input?.setRangeText(replacement, start!, end!, selectMode);\n    this.value = this._input?.value ?? '';\n  }\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  }\n\n  /** Increments the numeric value of the input by one or more steps. */\n  public stepUp(n?: number): void {\n    this._input?.stepUp(n);\n    this.value = this._input?.value ?? '';\n  }\n\n  /** Decrements the numeric value of the input by one or more steps. */\n  public stepDown(n?: number): void {\n    this._input?.stepDown(n);\n    this.value = this._input?.value ?? '';\n  }\n\n  private _handleInput(): void {\n    this._commitValue(this._input?.value ?? '', 'igcInput');\n  }\n\n  private _handleChange(): void {\n    this._commitValue(this._input?.value ?? '', 'igcChange');\n  }\n\n  protected _renderInput() {\n    const hasNegativeTabIndex = this.getAttribute('tabindex') === '-1';\n\n    return html`\n      <input\n        ${ariaBindings(this._ariaTarget.resolveBindings())}\n        id=${this._inputId}\n        part=${partMap(this._resolvePartNames('input'))}\n        name=${ifDefined(this.name)}\n        type=${ifDefined(this.type)}\n        pattern=${ifDefined(this.pattern)}\n        placeholder=${ifDefined(this.placeholder)}\n        .value=${live(this.value)}\n        ?readonly=${this.readOnly}\n        ?disabled=${this.disabled}\n        ?required=${this.required}\n        ?autofocus=${this.autofocus}\n        tabindex=${bindIf(hasNegativeTabIndex, -1)}\n        autocomplete=${ifDefined(this.autocomplete as any)}\n        inputmode=${ifDefined(this.inputMode)}\n        min=${bindIf(!this.validateOnly, this.min)}\n        max=${bindIf(!this.validateOnly, this.max)}\n        minlength=${ifDefined(this.minLength)}\n        maxlength=${bindIf(!this.validateOnly, this.maxLength)}\n        step=${ifDefined(this.step)}\n        @keydown=${this._handleEnterKeydown}\n        @change=${this._handleChange}\n        @input=${this._handleInput}\n        @blur=${this._handleBlur}\n      />\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-input': IgcInputComponent;\n  }\n}\n"]}
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/components/input/input.ts"],"names":[],"mappings":"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","sourcesContent":["import { html } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { live } from 'lit/directives/live.js';\nimport { ariaBindings } from '#internals/controllers/aria-projection.js';\nimport { addSlotController, setSlots } from '#internals/controllers/slot.js';\nimport {\n  coercedProperty,\n  type CoercedPropertyConfig,\n} from '#internals/decorators/coerced-property.js';\nimport { registerComponent } from '#internals/definitions/register.js';\nimport { createFormValueState } from '#internals/mixins/forms/form-value.js';\nimport { partMap } from '#internals/part-map.js';\nimport { bindIf } from '#internals/utils/lit.js';\nimport { addThemingController } from '#theming/theming-controller.js';\nimport type {\n  InputType,\n  RangeTextSelectMode,\n  SelectionRangeDirection,\n} from '../types.js';\nimport IgcValidationContainerComponent from '../validation-container/validation-container.js';\nimport { IgcInputBaseComponent } from './input-base.js';\nimport { styles } from './themes/input.base.css.js';\nimport { styles as shared } from './themes/shared/input.common.css.js';\nimport { all } from './themes/themes.js';\nimport { numberValidators, stringValidators } from './validators.js';\n\nconst Slots = setSlots(\n  'prefix',\n  'suffix',\n  'helper-text',\n  'value-missing',\n  'type-mismatch',\n  'pattern-mismatch',\n  'too-long',\n  'too-short',\n  'range-overflow',\n  'range-underflow',\n  'step-mismatch',\n  'custom-error',\n  'invalid'\n);\n\n/**\n * A highly customizable single-line text field for entering and editing data,\n * with support for prefix/suffix content, helper text, form integration, and built-in validation.\n *\n * @element igc-input\n *\n * @slot prefix - Renders content before the input.\n * @slot suffix - Renders content after input.\n * @slot helper-text - Renders content below the input.\n * @slot value-missing - Renders content when the required validation fails.\n * @slot type-mismatch - Renders content when the url/email type validation fails.\n * @slot pattern-mismatch - Renders content when the pattern validation fails.\n * @slot too-long - Renders content when the maxlength validation fails.\n * @slot too-short - Renders content when the minlength validation fails.\n * @slot range-overflow - Renders content when the max validation fails.\n * @slot range-underflow - Renders content when the min validation fails.\n * @slot step-mismatch - Renders content when the step validation fails.\n * @slot custom-error - Renders content when setCustomValidity(message) is set.\n * @slot invalid - Renders content when the component is in invalid state (validity.valid = false).\n *\n * @fires igcInput - Emitted when the control input receives user input.\n * @fires igcChange - Emitted when the value of the control is committed.\n *\n * @csspart container - The main wrapper that holds all main input elements.\n * @csspart input - The native input element.\n * @csspart label - The native label element.\n * @csspart prefix - The prefix wrapper.\n * @csspart suffix - The suffix wrapper.\n * @csspart helper-text - The helper text wrapper.\n */\nexport default class IgcInputComponent extends IgcInputBaseComponent {\n  public static readonly tagName = 'igc-input';\n  public static styles = [styles, shared];\n\n  /** Shared config for the constraint properties - a change revalidates. */\n  private static readonly _revalidate: CoercedPropertyConfig<\n    unknown,\n    IgcInputComponent\n  > = {\n    onChange: ({ host }) => host._validate(),\n  };\n\n  /* blazorSuppress */\n  public static register(): void {\n    registerComponent(IgcInputComponent, IgcValidationContainerComponent);\n  }\n\n  protected override readonly _themes = addThemingController(this, all);\n\n  protected override readonly _slots = addSlotController(this, {\n    slots: Slots,\n  });\n\n  protected override readonly _formValue = createFormValueState(this, {\n    initialValue: '',\n  });\n\n  protected override get __validators() {\n    return this.type !== 'number' ? stringValidators : numberValidators;\n  }\n\n  /* @tsTwoWayProperty(true, \"igcChange\", \"detail\", false) */\n  /**\n   * The value of the control.\n   * @attr\n   */\n  @property()\n  public set value(value: string) {\n    this._formValue.setValueAndFormState(value);\n  }\n\n  public get value(): string {\n    return this._formValue.value;\n  }\n\n  /* alternateName: displayType */\n  /**\n   * The type of the control.\n   * @attr\n   */\n  @property({ reflect: true })\n  public type: InputType = 'text';\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   * A hint to the browser for which virtual keyboard layout to display.\n   * See [relevant MDN article](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inputmode)\n   * @attr inputmode\n   */\n  @property({ attribute: 'inputmode' })\n  public override inputMode!: string;\n\n  /**\n   * The regular expression the value is validated against.\n   * @attr\n   */\n  @property()\n  @coercedProperty(IgcInputComponent._revalidate)\n  public pattern?: string = undefined;\n\n  /**\n   * The minimum string length required by the control.\n   * @attr minlength\n   */\n  @property({ type: Number, attribute: 'minlength' })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public minLength?: number = undefined;\n\n  /**\n   * The maximum string length of the control.\n   * @attr maxlength\n   */\n  @property({ type: Number, attribute: 'maxlength' })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public maxLength?: number = undefined;\n\n  /**\n   * The minimum value the control accepts.\n   * @attr\n   */\n  @property({ type: Number })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public min?: number = undefined;\n\n  /**\n   * The maximum value the control accepts.\n   * @attr\n   */\n  @property({ type: Number })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public max?: number = undefined;\n\n  /**\n   * The granularity the value must adhere to.\n   * @attr\n   */\n  @property({ type: Number })\n  @coercedProperty(IgcInputComponent._revalidate)\n  public step?: number = undefined;\n\n  /**\n   * Whether the control should receive focus automatically.\n   * @attr\n   */\n  @property({ type: Boolean })\n  public override autofocus!: boolean;\n\n  /**\n   * A hint for the browser on how to autofill the control.\n   * @attr\n   */\n  @property()\n  public autocomplete!: string;\n\n  /**\n   * Enables validation rules to be evaluated without restricting user input. This applies to the `maxLength` property for\n   * string-type inputs or allows spin buttons to exceed the predefined `min/max` limits for number-type inputs.\n   *\n   * @attr validate-only\n   * @default false\n   */\n  @property({ type: Boolean, reflect: true, attribute: 'validate-only' })\n  public validateOnly = false;\n\n  /* blazorSuppress */\n  /** Replaces the selected text in the input. */\n  public setRangeText(\n    replacement: string,\n    start?: number,\n    end?: number,\n    selectMode: RangeTextSelectMode = 'preserve'\n  ): void {\n    this._input?.setRangeText(replacement, start!, end!, selectMode);\n    this.value = this._input?.value ?? '';\n  }\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  }\n\n  /** Increments the numeric value of the input by one or more steps. */\n  public stepUp(n?: number): void {\n    this._input?.stepUp(n);\n    this.value = this._input?.value ?? '';\n  }\n\n  /** Decrements the numeric value of the input by one or more steps. */\n  public stepDown(n?: number): void {\n    this._input?.stepDown(n);\n    this.value = this._input?.value ?? '';\n  }\n\n  private _handleInput(): void {\n    this._commitValue(this._input?.value ?? '', 'igcInput');\n  }\n\n  private _handleChange(): void {\n    this._commitValue(this._input?.value ?? '', 'igcChange');\n  }\n\n  protected _renderInput() {\n    const hasNegativeTabIndex = this.getAttribute('tabindex') === '-1';\n\n    return html`\n      <input\n        ${ariaBindings(this._ariaTarget.resolveBindings())}\n        id=${this._inputId}\n        part=${partMap(this._resolvePartNames('input'))}\n        name=${ifDefined(this.name)}\n        type=${ifDefined(this.type)}\n        pattern=${ifDefined(this.pattern)}\n        placeholder=${ifDefined(this.placeholder)}\n        .value=${live(this.value)}\n        ?readonly=${this.readOnly}\n        ?disabled=${this.disabled}\n        ?required=${this.required}\n        ?autofocus=${this.autofocus}\n        tabindex=${bindIf(hasNegativeTabIndex, -1)}\n        autocomplete=${ifDefined(this.autocomplete as any)}\n        inputmode=${ifDefined(this.inputMode)}\n        min=${bindIf(!this.validateOnly, this.min)}\n        max=${bindIf(!this.validateOnly, this.max)}\n        minlength=${ifDefined(this.minLength)}\n        maxlength=${bindIf(!this.validateOnly, this.maxLength)}\n        step=${ifDefined(this.step)}\n        @keydown=${this._handleEnterKeydown}\n        @change=${this._handleChange}\n        @input=${this._handleInput}\n        @blur=${this._handleBlur}\n      />\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'igc-input': IgcInputComponent;\n  }\n}\n"]}

package/components/mask-input/mask-history.d.ts

@@ -15,18 +15,20 @@ type MaskEditKind = 'insert' | 'delete-backward' | 'delete-forward' | 'atomic';
 /** Resolves the identity of the mask pattern the snapshots were taken against. */
 type MaskSignature = () => string;
 /**
- * The undo/redo history of a masked editor.
+ * The undo and redo history of a masked editor.
  *
- * Masked text is rendered through `.value=${live(...)}`, so every edit reassigns the
- * native input's value - which wipes the browser's own undo stack. This replaces it.
+ * @remarks
+ * `.value=${live(...)}` renders the masked text, so each edit assigns the value
+ * of the native input again and clears the undo stack of the browser. This
+ * history replaces that stack.
  *
- * It holds no timers: a run is coalesced purely from the caret geometry, so the same
- * sequence of edits always produces the same sequence of steps.
+ * It holds no timers. The caret geometry alone groups a run, so the same edits
+ * always give the same steps.
  *
- * The history is self-invalidating rather than instrumented. Anything that moves the
- * masked text without going through it - a programmatic `value`, `clear()`, a form reset -
- * is caught by comparing against the text it last observed, and a changed mask pattern is
- * caught by the signature. That is why no call site has to announce those changes.
+ * The history invalidates itself. It compares against the text it last saw to
+ * find a change that did not go through it, such as a `value` from code,
+ * `clear()` or a form reset, and the signature finds a changed mask pattern. No
+ * call site must report those changes.
  *
  * @hidden
  */
@@ -39,26 +41,28 @@ declare class MaskHistory {
     private _lastValue;
     private _pattern;
     /**
-     * The state the most recent traversal restored.
+     * The state that the last traversal restored.
      *
-     * Holding `Ctrl + Z` fires faster than the caret can be written back to the DOM, so the
-     * live selection is not a trustworthy counterpart entry for the opposite stack. The
-     * state we know we just restored is.
+     * @remarks
+     * A held `Ctrl + Z` repeats faster than the caret reaches the DOM, so the live
+     * selection is not a reliable entry for the opposite stack. This state holds
+     * the value and the caret that the traversal wrote, so it pushes the correct
+     * entry.
      */
     private _lastRestored;
     constructor(signature: MaskSignature);
     get canUndo(): boolean;
     get canRedo(): boolean;
     /**
-     * A run continues only while the caret stays where the previous edit left it, which is
-     * what makes a click or an arrow key break it without any extra hook. Replacing a
-     * selection is always a deliberate edit of its own.
+     * A run continues only while the caret stays where the last edit left it, so a
+     * click or an arrow key breaks it with no extra hook. A replaced selection is
+     * always its own edit.
      */
     private _shouldCoalesce;
     private _clear;
     /**
-     * Drops everything the history holds when the mask pattern changed or the text moved
-     * behind our back. Returns whether the snapshots are still usable.
+     * Drops all the history if the mask pattern changed, or if the text moved
+     * from outside. Returns whether the snapshots are still usable.
      */
     private _validate;
     /**

package/components/mask-input/mask-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"mask-history.js","sourceRoot":"","sources":["../../../src/components/mask-input/mask-history.ts"],"names":[],"mappings":"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","sourcesContent":["/** A snapshot of the editor state as it was *before* an edit was applied. */\ntype MaskHistoryState = {\n  value: string;\n  start: number;\n  end: number;\n};\n\n/**\n * The granularity an edit contributes to the history.\n *\n * The three granular kinds coalesce, so a run of typed characters or of deletions\n * collapses into a single step. Everything else - paste, drop, cut, composition,\n * auto-fill, spinning a date part, `setRangeText` - is `atomic` and gets its own step.\n */\ntype MaskEditKind = 'insert' | 'delete-backward' | 'delete-forward' | 'atomic';\n\n/** Resolves the identity of the mask pattern the snapshots were taken against. */\ntype MaskSignature = () => string;\n\nconst MAX_HISTORY_SIZE = 100;\n\n/**\n * The undo/redo history of a masked editor.\n *\n * Masked text is rendered through `.value=${live(...)}`, so every edit reassigns the\n * native input's value - which wipes the browser's own undo stack. This replaces it.\n *\n * It holds no timers: a run is coalesced purely from the caret geometry, so the same\n * sequence of edits always produces the same sequence of steps.\n *\n * The history is self-invalidating rather than instrumented. Anything that moves the\n * masked text without going through it - a programmatic `value`, `clear()`, a form reset -\n * is caught by comparing against the text it last observed, and a changed mask pattern is\n * caught by the signature. That is why no call site has to announce those changes.\n *\n * @hidden\n */\nclass MaskHistory {\n  private readonly _signature: MaskSignature;\n  private readonly _undoStack: MaskHistoryState[] = [];\n  private readonly _redoStack: MaskHistoryState[] = [];\n\n  private _lastKind: MaskEditKind | null = null;\n  private _lastCaret = -1;\n  private _lastValue = '';\n  private _pattern = '';\n\n  /**\n   * The state the most recent traversal restored.\n   *\n   * Holding `Ctrl + Z` fires faster than the caret can be written back to the DOM, so the\n   * live selection is not a trustworthy counterpart entry for the opposite stack. The\n   * state we know we just restored is.\n   */\n  private _lastRestored: MaskHistoryState | null = null;\n\n  constructor(signature: MaskSignature) {\n    this._signature = signature;\n  }\n\n  public get canUndo(): boolean {\n    return this._undoStack.length > 0;\n  }\n\n  public get canRedo(): boolean {\n    return this._redoStack.length > 0;\n  }\n\n  /**\n   * A run continues only while the caret stays where the previous edit left it, which is\n   * what makes a click or an arrow key break it without any extra hook. Replacing a\n   * selection is always a deliberate edit of its own.\n   */\n  private _shouldCoalesce(\n    kind: MaskEditKind,\n    state: MaskHistoryState\n  ): boolean {\n    if (\n      kind === 'atomic' ||\n      kind !== this._lastKind ||\n      !this.canUndo ||\n      state.start !== state.end\n    ) {\n      return false;\n    }\n\n    return kind === 'insert'\n      ? state.start === this._lastCaret\n      : state.end === this._lastCaret;\n  }\n\n  private _clear(): void {\n    this._undoStack.length = 0;\n    this._redoStack.length = 0;\n    this._lastKind = null;\n    this._lastCaret = -1;\n    this._lastRestored = null;\n  }\n\n  /**\n   * Drops everything the history holds when the mask pattern changed or the text moved\n   * behind our back. Returns whether the snapshots are still usable.\n   */\n  private _validate(value: string): boolean {\n    const pattern = this._signature();\n    const stale =\n      pattern !== this._pattern || (this.canUndo && value !== this._lastValue);\n\n    if (stale) {\n      this._pattern = pattern;\n      this._clear();\n      this._lastValue = value;\n    }\n\n    return !stale;\n  }\n\n  /**\n   * Records the state an edit is about to overwrite. Must be called *before* the mask is\n   * mutated, and only once the edit is known to change something.\n   */\n  public record(kind: MaskEditKind, state: MaskHistoryState): void {\n    this._validate(state.value);\n    this._redoStack.length = 0;\n    this._lastRestored = null;\n\n    if (!this._shouldCoalesce(kind, state)) {\n      this._undoStack.push({ ...state });\n\n      if (this._undoStack.length > MAX_HISTORY_SIZE) {\n        this._undoStack.shift();\n      }\n    }\n\n    this._lastKind = kind;\n  }\n\n  /**\n   * Reports the state an edit settled on, so that the next {@link record} can tell\n   * whether it continues the run.\n   */\n  public settle(value: string, caret: number): void {\n    this._lastValue = value;\n    this._lastCaret = caret;\n  }\n\n  /**\n   * Reconciles the history with the editor's current text, typically on focus where a\n   * date editor swaps the display format back for the input format. An unchanged\n   * document keeps its history, a changed one drops it, and either way the run ends.\n   */\n  public resync(value: string): void {\n    this._validate(value);\n\n    this._lastValue = value;\n    this._lastKind = null;\n    this._lastCaret = -1;\n    this._lastRestored = null;\n  }\n\n  /** Steps one edit back, handing `current` to the redo stack. */\n  public undo(current: MaskHistoryState): MaskHistoryState | null {\n    return this._step(this._undoStack, this._redoStack, current);\n  }\n\n  /** Steps one edit forward, handing `current` back to the undo stack. */\n  public redo(current: MaskHistoryState): MaskHistoryState | null {\n    return this._step(this._redoStack, this._undoStack, current);\n  }\n\n  private _step(\n    from: MaskHistoryState[],\n    to: MaskHistoryState[],\n    current: MaskHistoryState\n  ): MaskHistoryState | null {\n    // Traversing a history whose document has moved on would restore text belonging to a\n    // value the component no longer holds.\n    if (!this._validate(current.value)) {\n      return null;\n    }\n\n    const state = from.pop();\n\n    if (!state) {\n      return null;\n    }\n\n    to.push(this._lastRestored ?? { ...current });\n\n    // Typing after an undo must not extend the step that was just restored.\n    this._lastKind = null;\n    this._lastValue = state.value;\n    this._lastCaret = state.start;\n    this._lastRestored = { ...state };\n\n    return state;\n  }\n}\n\n/**\n * Creates a {@link MaskHistory} for a masked editor.\n *\n * @param signature - resolves the identity of the mask pattern the snapshots are taken\n * against. A callback rather than a value because the history is created by the mask\n * behavior mixin, whose fields initialize *before* the parser of the concrete component.\n *\n * @example\n * ```ts\n * const history = createMaskHistory(() => `${parser.mask} ${parser.prompt}`);\n * ```\n */\nexport function createMaskHistory(signature: MaskSignature): MaskHistory {\n  return new MaskHistory(signature);\n}\n\nexport type { MaskEditKind, MaskHistory, MaskHistoryState, MaskSignature };\n"]}
+{"version":3,"file":"mask-history.js","sourceRoot":"","sources":["../../../src/components/mask-input/mask-history.ts"],"names":[],"mappings":"AAmBA,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAoB7B,MAAM,WAAW;IAqBf,YAAY,SAAwB;QAnBnB,eAAU,GAAuB,EAAE,CAAC;QACpC,eAAU,GAAuB,EAAE,CAAC;QAE7C,cAAS,GAAwB,IAAI,CAAC;QACtC,eAAU,GAAG,CAAC,CAAC,CAAC;QAChB,eAAU,GAAG,EAAE,CAAC;QAChB,aAAQ,GAAG,EAAE,CAAC;QAWd,kBAAa,GAA4B,IAAI,CAAC;QAGpD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,CAAC;IAOO,eAAe,CACrB,IAAkB,EAClB,KAAuB;QAEvB,IACE,IAAI,KAAK,QAAQ;YACjB,IAAI,KAAK,IAAI,CAAC,SAAS;YACvB,CAAC,IAAI,CAAC,OAAO;YACb,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG,EACzB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,KAAK,QAAQ;YACtB,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU;YACjC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAMO,SAAS,CAAC,KAAa;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GACT,OAAO,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;QAE3E,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,OAAO,CAAC,KAAK,CAAC;IAChB,CAAC;IAMM,MAAM,CAAC,IAAkB,EAAE,KAAuB;QACvD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAEnC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBAC9C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAMM,MAAM,CAAC,KAAa,EAAE,KAAa;QACxC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAOM,MAAM,CAAC,KAAa;QACzB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEtB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAGM,IAAI,CAAC,OAAyB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAGM,IAAI,CAAC,OAAyB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAEO,KAAK,CACX,IAAwB,EACxB,EAAsB,EACtB,OAAyB;QAIzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAG9C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAElC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAcD,MAAM,UAAU,iBAAiB,CAAC,SAAwB;IACxD,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC","sourcesContent":["/** A snapshot of the editor state as it was *before* an edit was applied. */\ntype MaskHistoryState = {\n  value: string;\n  start: number;\n  end: number;\n};\n\n/**\n * The granularity an edit contributes to the history.\n *\n * The three granular kinds coalesce, so a run of typed characters or of deletions\n * collapses into a single step. Everything else - paste, drop, cut, composition,\n * auto-fill, spinning a date part, `setRangeText` - is `atomic` and gets its own step.\n */\ntype MaskEditKind = 'insert' | 'delete-backward' | 'delete-forward' | 'atomic';\n\n/** Resolves the identity of the mask pattern the snapshots were taken against. */\ntype MaskSignature = () => string;\n\nconst MAX_HISTORY_SIZE = 100;\n\n/**\n * The undo and redo history of a masked editor.\n *\n * @remarks\n * `.value=${live(...)}` renders the masked text, so each edit assigns the value\n * of the native input again and clears the undo stack of the browser. This\n * history replaces that stack.\n *\n * It holds no timers. The caret geometry alone groups a run, so the same edits\n * always give the same steps.\n *\n * The history invalidates itself. It compares against the text it last saw to\n * find a change that did not go through it, such as a `value` from code,\n * `clear()` or a form reset, and the signature finds a changed mask pattern. No\n * call site must report those changes.\n *\n * @hidden\n */\nclass MaskHistory {\n  private readonly _signature: MaskSignature;\n  private readonly _undoStack: MaskHistoryState[] = [];\n  private readonly _redoStack: MaskHistoryState[] = [];\n\n  private _lastKind: MaskEditKind | null = null;\n  private _lastCaret = -1;\n  private _lastValue = '';\n  private _pattern = '';\n\n  /**\n   * The state that the last traversal restored.\n   *\n   * @remarks\n   * A held `Ctrl + Z` repeats faster than the caret reaches the DOM, so the live\n   * selection is not a reliable entry for the opposite stack. This state holds\n   * the value and the caret that the traversal wrote, so it pushes the correct\n   * entry.\n   */\n  private _lastRestored: MaskHistoryState | null = null;\n\n  constructor(signature: MaskSignature) {\n    this._signature = signature;\n  }\n\n  public get canUndo(): boolean {\n    return this._undoStack.length > 0;\n  }\n\n  public get canRedo(): boolean {\n    return this._redoStack.length > 0;\n  }\n\n  /**\n   * A run continues only while the caret stays where the last edit left it, so a\n   * click or an arrow key breaks it with no extra hook. A replaced selection is\n   * always its own edit.\n   */\n  private _shouldCoalesce(\n    kind: MaskEditKind,\n    state: MaskHistoryState\n  ): boolean {\n    if (\n      kind === 'atomic' ||\n      kind !== this._lastKind ||\n      !this.canUndo ||\n      state.start !== state.end\n    ) {\n      return false;\n    }\n\n    return kind === 'insert'\n      ? state.start === this._lastCaret\n      : state.end === this._lastCaret;\n  }\n\n  private _clear(): void {\n    this._undoStack.length = 0;\n    this._redoStack.length = 0;\n    this._lastKind = null;\n    this._lastCaret = -1;\n    this._lastRestored = null;\n  }\n\n  /**\n   * Drops all the history if the mask pattern changed, or if the text moved\n   * from outside. Returns whether the snapshots are still usable.\n   */\n  private _validate(value: string): boolean {\n    const pattern = this._signature();\n    const stale =\n      pattern !== this._pattern || (this.canUndo && value !== this._lastValue);\n\n    if (stale) {\n      this._pattern = pattern;\n      this._clear();\n      this._lastValue = value;\n    }\n\n    return !stale;\n  }\n\n  /**\n   * Records the state an edit is about to overwrite. Must be called *before* the mask is\n   * mutated, and only once the edit is known to change something.\n   */\n  public record(kind: MaskEditKind, state: MaskHistoryState): void {\n    this._validate(state.value);\n    this._redoStack.length = 0;\n    this._lastRestored = null;\n\n    if (!this._shouldCoalesce(kind, state)) {\n      this._undoStack.push({ ...state });\n\n      if (this._undoStack.length > MAX_HISTORY_SIZE) {\n        this._undoStack.shift();\n      }\n    }\n\n    this._lastKind = kind;\n  }\n\n  /**\n   * Reports the state an edit settled on, so that the next {@link record} can tell\n   * whether it continues the run.\n   */\n  public settle(value: string, caret: number): void {\n    this._lastValue = value;\n    this._lastCaret = caret;\n  }\n\n  /**\n   * Reconciles the history with the editor's current text, typically on focus where a\n   * date editor swaps the display format back for the input format. An unchanged\n   * document keeps its history, a changed one drops it, and either way the run ends.\n   */\n  public resync(value: string): void {\n    this._validate(value);\n\n    this._lastValue = value;\n    this._lastKind = null;\n    this._lastCaret = -1;\n    this._lastRestored = null;\n  }\n\n  /** Steps one edit back, handing `current` to the redo stack. */\n  public undo(current: MaskHistoryState): MaskHistoryState | null {\n    return this._step(this._undoStack, this._redoStack, current);\n  }\n\n  /** Steps one edit forward, handing `current` back to the undo stack. */\n  public redo(current: MaskHistoryState): MaskHistoryState | null {\n    return this._step(this._redoStack, this._undoStack, current);\n  }\n\n  private _step(\n    from: MaskHistoryState[],\n    to: MaskHistoryState[],\n    current: MaskHistoryState\n  ): MaskHistoryState | null {\n    // Traversing a history whose document has moved on would restore text belonging to a\n    // value the component no longer holds.\n    if (!this._validate(current.value)) {\n      return null;\n    }\n\n    const state = from.pop();\n\n    if (!state) {\n      return null;\n    }\n\n    to.push(this._lastRestored ?? { ...current });\n\n    // Typing after an undo must not extend the step that was just restored.\n    this._lastKind = null;\n    this._lastValue = state.value;\n    this._lastCaret = state.start;\n    this._lastRestored = { ...state };\n\n    return state;\n  }\n}\n\n/**\n * Creates a {@link MaskHistory} for a masked editor.\n *\n * @param signature - resolves the identity of the mask pattern the snapshots are taken\n * against. A callback rather than a value because the history is created by the mask\n * behavior mixin, whose fields initialize *before* the parser of the concrete component.\n *\n * @example\n * ```ts\n * const history = createMaskHistory(() => `${parser.mask} ${parser.prompt}`);\n * ```\n */\nexport function createMaskHistory(signature: MaskSignature): MaskHistory {\n  return new MaskHistory(signature);\n}\n\nexport type { MaskEditKind, MaskHistory, MaskHistoryState, MaskSignature };\n"]}

package/components/mask-input/mask-input.d.ts

@@ -35,7 +35,7 @@ export default class IgcMaskInputComponent extends IgcMaskInputComponent_base {
     protected readonly _parser: MaskParser;
     protected get __validators(): import("../../internals/validators.js").Validator<IgcMaskInputComponent>[];
     protected readonly _themes: import("#theming/theming-controller.js").ThemingController;
-    protected readonly _slots: import("#internals/controllers/slot.js").SlotController<"invalid" | "prefix" | "helper-text" | "[default]" | "suffix" | "value-missing" | "custom-error" | "bad-input">;
+    protected readonly _slots: import("#internals/controllers/slot.js").SlotController<"invalid" | "prefix" | "[default]" | "suffix" | "helper-text" | "value-missing" | "custom-error" | "bad-input">;
     protected readonly _formValue: import("#internals/mixins/forms/form-value.js").FormValue<string>;
     protected get _isRawMode(): boolean;
     /**

package/components/mask-input/mask-parser.d.ts

@@ -46,9 +46,9 @@ export declare class MaskParser {
     /** Cached array of required non-literal positions for validation */
     protected _requiredPositions: number[];
     /**
-     * Declared without an initializer on purpose. With `useDefineForClassFields: false`
-     * nothing is emitted for it, so {@link _invalidate} can safely run from the
-     * constructor - before subclass fields exist.
+     * Declared with no initializer. `useDefineForClassFields: false` emits nothing
+     * for it, so {@link _invalidate} can run from the constructor, before the
+     * subclass fields exist.
      */
     private _emptyMask?;
     /**
@@ -87,25 +87,23 @@ export declare class MaskParser {
     constructor(options?: MaskOptions);
     private _isEscapedFlag;
     /**
-     * The pattern the literal parser consumes. Subclasses whose public format is not itself
-     * a mask pattern - date formats, for instance - translate it here.
+     * The pattern for the literal parser. A subclass whose public format is not a
+     * mask pattern, such as a date format, converts it here.
      */
     protected _toMaskFormat(format: string): string;
     /**
-     * Drops everything derived from the mask. Runs on every mask *and* prompt change, and
-     * from the constructor, so overrides must not touch fields with initializers.
+     * Drops all that comes from the mask. Runs on each mask and prompt change, and
+     * from the constructor, so an override must not touch an initialized field.
      */
     protected _invalidate(): void;
     /**
-     * Parses the mask format string to identify literal characters and
-     * create the escaped mask. This method is called whenever the mask format changes.
+     * Finds the literal characters of the mask format and builds the escaped
+     * mask. Runs on each mask format change.
      */
     protected _parseMaskLiterals(): void;
     /**
-     * Computes an array of positions in the escaped mask that correspond to
-     * required input flags (e.g., '0', 'L') and are not literal characters.
-     *
-     * These positions must be filled for the masked string to be valid.
+     * The positions of the escaped mask that hold a required input flag, such as
+     * '0' or 'L', and are not literals. A valid masked string fills them all.
      */
     protected _computeRequiredPositions(): number[];
     /**