igniteui-webcomponents 7.3.2 → 7.4.0

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.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" | "too-long" | "too-short" | "custom-error" | "range-overflow" | "range-underflow" | "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":"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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 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[];
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"mask-parser.js","sourceRoot":"","sources":["../../../src/components/mask-input/mask-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/** Options for the {@link MaskParser} */\nexport interface MaskOptions {\n  /**\n   * The mask format string (e.g., '00/00/0000' for dates, 'AAA-000' for custom IDs).\n   *\n   * Supported flags: a, A, C, L, 0, 9, #, &, ?.\n   *\n   * Use `'\\'` to escape a flag character if it should be treated as a literal.\n   * @default 'CCCCCCCCCC'\n   */\n  format?: string;\n\n  /**\n   * The character used to prompt for input in unfilled mask positions.\n   *\n   * Only the first character is used, and a mask flag is rejected in favor of the\n   * default - the same rules the `prompt` accessor applies.\n   * @default '_'\n   */\n  promptCharacter?: string;\n}\n\n/** Internal options with all required fields */\ninterface MaskOptionsInternal {\n  format: string;\n  promptCharacter: string;\n}\n\n/**\n * Result type for the replace operation, containing the new masked value and the\n * ideal cursor position.\n */\ntype MaskReplaceResult = {\n  value: string;\n  end: number;\n};\n\nconst MASK_FLAGS = new Set('aACL09#&?');\nconst MASK_REQUIRED_FLAGS = new Set('0#LA&');\n\nconst ESCAPE_CHAR = '\\\\';\nconst DEFAULT_FORMAT = 'CCCCCCCCCC';\nconst DEFAULT_PROMPT = '_';\n\nconst ASCII_ZERO = 0x0030;\nconst DIGIT_ZERO_CODEPOINTS = [\n  ASCII_ZERO, // ASCII\n  0x0660, // Arabic-Indic\n  0x06f0, // Extended Arabic-Indic\n  0x0966, // Devanagari\n  0x09e6, // Bengali\n  0x0a66, // Gurmukhi\n  0x0ae6, // Gujarati\n  0x0b66, // Oriya\n  0x0c66, // Telugu\n  0x0ce6, // Kannada\n  0x0d66, // Malayalam\n  0x0e50, // Thai\n  0x0ed0, // Lao\n  0x0f20, // Tibetan\n  0x1040, // Myanmar\n  0x17e0, // Khmer\n  0x1810, // Mongolian\n  0xff10, // Full-width\n] as const;\n\n/**\n * Precomputed map of Unicode digit codepoints to their ASCII equivalents.\n * This eliminates the need for iteration during conversion.\n */\nconst UNICODE_DIGIT_TO_ASCII = new Map<number, string>(\n  DIGIT_ZERO_CODEPOINTS.flatMap((zeroCodePoint) =>\n    Array.from({ length: 10 }, (_, i) => [\n      zeroCodePoint + i,\n      String.fromCharCode(ASCII_ZERO + i),\n    ])\n  )\n);\n\n/**\n * Narrows a prompt down to the single character the parser will actually use.\n *\n * Falls back to `current` when the prompt is empty or collides with a mask flag - a flag\n * standing in for an unfilled position could not be told apart from one the user typed.\n */\nfunction normalizePrompt(value: string | undefined, current: string): string {\n  const char = value ? value.substring(0, 1) : current;\n  return MASK_FLAGS.has(char) ? current : char;\n}\n\nfunction replaceUnicodeNumbers(text: string): string {\n  const matcher = /\\p{Nd}/gu;\n\n  return text.replace(matcher, (digit) => {\n    return UNICODE_DIGIT_TO_ASCII.get(digit.charCodeAt(0)) ?? digit;\n  });\n}\n\nconst MASK_PATTERNS = new Map<string, RegExp>([\n  ['C', /[\\s\\S]/u], // Any single character (including newlines)\n  ['&', /[^\\p{Separator}]/u], // Any non-separator character (excludes spaces, line/paragraph separators)\n  ['a', /[\\p{Letter}\\p{Number}\\p{Separator}]/u], // Alphanumeric and separator characters (Unicode-aware)\n  ['A', /[\\p{Letter}\\p{Number}]/u], // Alphanumeric (Unicode-aware)\n  ['?', /[\\p{Letter}\\p{Separator}]/u], // Alphabetic and separator characters (Unicode-aware)\n  ['L', /\\p{Letter}/u], // Alphabetic (Unicode-aware)\n  ['0', /\\p{Number}/u], // Numeric (Unicode-aware, converted to ASCII 0-9 during processing)\n  ['9', /[\\p{Number}\\p{Separator}]/u], // Numeric and separator characters (Unicode-aware)\n  ['#', /[\\p{Number}\\-+]/u], // Numeric and sign characters (+, -)\n]);\n\nfunction validate(char: string, flag: string): boolean {\n  return MASK_PATTERNS.get(flag)?.test(char) ?? false;\n}\n\n/**\n * A class for parsing and applying masks to strings, typically for input fields.\n * It handles mask definitions, literals, character validation, and cursor positioning.\n */\nexport class MaskParser {\n  protected readonly _options: MaskOptionsInternal;\n\n  /** Stores literal characters and their original positions in the mask (e.g., '(', ')', '-'). */\n  protected readonly _literals = new Map<number, string>();\n\n  /** A Set of positions where literals occur in the `_escapedMask`. */\n  protected _literalPositions = new Set<number>();\n\n  /** The mask format after processing escape characters */\n  protected _escapedMask = '';\n\n  /** Cached array of required non-literal positions for validation */\n  protected _requiredPositions: number[] = [];\n\n  /**\n   * Declared without an initializer on purpose. With `useDefineForClassFields: false`\n   * nothing is emitted for it, so {@link _invalidate} can safely run from the\n   * constructor - before subclass fields exist.\n   */\n  private _emptyMask?: string;\n\n  /**\n   * Returns a set of the all the literal positions in the mask.\n   * These positions are fixed characters that are not part of the input.\n   */\n  public get literalPositions(): ReadonlySet<number> {\n    return this._literalPositions;\n  }\n\n  /**\n   * Returns the escaped mask string.\n   * This is the mask after processing any escape sequences.\n   */\n  public get escapedMask(): string {\n    return this._escapedMask;\n  }\n\n  /**\n   * Returns the result of applying an empty string over the mask pattern.\n   */\n  public get emptyMask(): string {\n    this._emptyMask ??= this.apply();\n    return this._emptyMask;\n  }\n\n  /**\n   * Gets the unescaped mask string (the original format string).\n   * If the mask has no escape sequences, then `mask === escapedMask`.\n   */\n  public get mask(): string {\n    return this._options.format;\n  }\n\n  /**\n   * Sets the mask of the parser.\n   * When the mask is set, it triggers a re-parsing of the mask literals and escaped mask.\n   */\n  public set mask(value: string) {\n    this._options.format = value || this._options.format;\n    this._parseMaskLiterals();\n  }\n\n  /**\n   * Gets the prompt character used for unfilled mask positions.\n   */\n  public get prompt(): string {\n    return this._options.promptCharacter;\n  }\n\n  /**\n   * Sets the prompt character. Only the first character of the provided string is used.\n   * @remarks The prompt character cannot be a mask flag character.\n   */\n  public set prompt(value: string) {\n    this._options.promptCharacter = normalizePrompt(\n      value,\n      this._options.promptCharacter\n    );\n    this._invalidate();\n  }\n\n  constructor(options?: MaskOptions) {\n    this._options = {\n      format: options?.format || DEFAULT_FORMAT,\n      promptCharacter: normalizePrompt(\n        options?.promptCharacter,\n        DEFAULT_PROMPT\n      ),\n    };\n    this._parseMaskLiterals();\n  }\n\n  private _isEscapedFlag(char: string, nextChar: string): boolean {\n    return char === ESCAPE_CHAR && MASK_FLAGS.has(nextChar);\n  }\n\n  /**\n   * The pattern the literal parser consumes. Subclasses whose public format is not itself\n   * a mask pattern - date formats, for instance - translate it here.\n   */\n  protected _toMaskFormat(format: string): string {\n    return format;\n  }\n\n  /**\n   * Drops everything derived from the mask. Runs on every mask *and* prompt change, and\n   * from the constructor, so overrides must not touch fields with initializers.\n   */\n  protected _invalidate(): void {\n    this._emptyMask = undefined;\n  }\n\n  /**\n   * Parses the mask format string to identify literal characters and\n   * create the escaped mask. This method is called whenever the mask format changes.\n   */\n  protected _parseMaskLiterals(): void {\n    const mask = this._toMaskFormat(this._options.format);\n    const length = mask.length;\n    const escapedMaskChars: string[] = [];\n\n    let currentPos = 0;\n\n    this._literals.clear();\n\n    for (let i = 0; i < length; i++) {\n      const [current, next] = [mask.charAt(i), mask.charAt(i + 1)];\n\n      if (this._isEscapedFlag(current, next)) {\n        // Escaped character - push next as a literal character and skip processing it\n        this._literals.set(currentPos, next);\n        escapedMaskChars.push(next);\n        i++;\n      } else if (MASK_FLAGS.has(current)) {\n        // Regular flag character\n        escapedMaskChars.push(current);\n      } else {\n        // Literal character\n        this._literals.set(currentPos, current);\n        escapedMaskChars.push(current);\n      }\n\n      currentPos++;\n    }\n\n    this._escapedMask = escapedMaskChars.join('');\n    this._literalPositions = new Set(this._literals.keys());\n    this._requiredPositions = this._computeRequiredPositions();\n    this._invalidate();\n  }\n\n  /**\n   * Computes an array of positions in the escaped mask that correspond to\n   * required input flags (e.g., '0', 'L') and are not literal characters.\n   *\n   * These positions must be filled for the masked string to be valid.\n   */\n  protected _computeRequiredPositions(): number[] {\n    const literalPositions = this._literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const result: number[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = escapedMask[i];\n      if (MASK_REQUIRED_FLAGS.has(char) && !literalPositions.has(i)) {\n        result.push(i);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *before* the given start position.\n   * Useful for backward navigation (e.g., backspace).\n   *\n   * @remarks\n   * If no non-literal is found before `start`, return 0.\n   */\n  public getPreviousNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n\n    for (let i = start - 1; i >= 0; i--) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return 0;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *after* the given start position.\n   * Useful for forward navigation (e.g., arrow keys, delete key or initial cursor placement).\n   *\n   * @remarks\n   * If no non-literal is found after `start`, return the mask length.\n   */\n  public getNextNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n    const length = this._escapedMask.length;\n\n    for (let i = Math.max(0, start); i < length; i++) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return length;\n  }\n\n  /**\n   * Replaces a segment of the masked string with new input, simulating typing or pasting.\n   * It handles clearing the selected range and inserting new characters according to the mask.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * const current = '__/__/____';\n   * const result = parser.replace(current, '12', 0, 0);\n   * // result.value = '12/__/____', result.end = 2\n   * ```\n   */\n  public replace(\n    maskString: string,\n    value: string,\n    start: number,\n    end: number\n  ): MaskReplaceResult {\n    const literalPositions = this.literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const prompt = this.prompt;\n    const endBoundary = Math.min(end, length);\n\n    // Initialize the array for the masked string or get a fresh mask with prompts and/or literals\n    const maskedChars = maskString ? [...maskString] : [...this.emptyMask];\n\n    const inputChars = Array.from(replaceUnicodeNumbers(value));\n    const inputLength = inputChars.length;\n\n    // Clear any non-literal positions from `start` to `endBoundary`\n    for (let i = start; i < endBoundary; i++) {\n      if (!literalPositions.has(i)) {\n        maskedChars[i] = prompt;\n      }\n    }\n\n    let cursor = start;\n    let inputIndex = 0;\n    let maskPosition = start;\n\n    // Iterate through the mask starting at `start` as long as there are input characters and mask positions available\n    // and start placing characters or skipping literals and invalid characters\n    for (; maskPosition < length && inputIndex < inputLength; maskPosition++) {\n      if (literalPositions.has(maskPosition)) {\n        cursor = maskPosition + 1;\n        continue;\n      }\n\n      const char = inputChars[inputIndex];\n\n      if (validate(char, escapedMask[maskPosition]) && char !== prompt) {\n        maskedChars[maskPosition] = char;\n        cursor = maskPosition + 1;\n        inputIndex++;\n      } else {\n        inputIndex++;\n        maskPosition--;\n      }\n    }\n\n    // Move the cursor to the next non-literal position or the end of the mask\n    while (cursor < length && literalPositions.has(cursor)) {\n      cursor++;\n    }\n\n    return {\n      value: maskedChars.join(''),\n      end: cursor,\n    };\n  }\n\n  /**\n   * Parses the masked string, extracting only the valid input characters.\n   * This effectively \"unmasks\" the string, removing prompts and literals.\n   */\n  public parse(masked = ''): string {\n    const literalPositions = this.literalPositions;\n    const prompt = this.prompt;\n    const length = masked.length;\n    const result: string[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = masked[i];\n      if (!literalPositions.has(i) && char !== prompt) {\n        result.push(char);\n      }\n    }\n\n    return result.join('');\n  }\n\n  /**\n   * Checks if the masked string is valid, specifically if all required mask positions are filled\n   * with valid, non-prompt characters.\n   */\n  public isValidString(input = ''): boolean {\n    const prompt = this.prompt;\n\n    return this._requiredPositions.every((position) => {\n      const char = input[position];\n      return validate(char, this._escapedMask[position]) && char !== prompt;\n    });\n  }\n\n  /**\n   * Applies the mask format to an input string. This attempts to fit the input\n   * into the mask from left to right, filling valid positions and skipping invalid\n   * input characters.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * parser.apply('12252023'); // Returns '12/25/2023'\n   * ```\n   */\n  public apply(input = ''): string {\n    const literals = this._literals;\n    const prompt = this.prompt;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n\n    // Initialize the result array with prompt characters\n    const result = new Array(length).fill(prompt);\n\n    // Place all literal characters into the result array\n    for (const [position, literal] of literals.entries()) {\n      result[position] = literal;\n    }\n\n    if (!input) {\n      return result.join('');\n    }\n\n    // Normalize Unicode digits to ASCII\n    const normalizedInput = replaceUnicodeNumbers(input);\n    const inputLength = normalizedInput.length;\n    let inputIndex = 0;\n\n    // Iterate through the mask placing input characters skipping literals and invalid ones\n    for (let i = 0; i < length; i++) {\n      if (inputIndex >= inputLength) {\n        break;\n      }\n\n      if (literals.has(i)) {\n        continue;\n      }\n\n      if (validate(normalizedInput[inputIndex], escapedMask[i])) {\n        result[i] = normalizedInput[inputIndex];\n      }\n\n      // Always advance - invalid characters are consumed/skipped\n      inputIndex++;\n    }\n\n    return result.join('');\n  }\n}\n"]}
+{"version":3,"file":"mask-parser.js","sourceRoot":"","sources":["../../../src/components/mask-input/mask-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/** Options for the {@link MaskParser} */\nexport interface MaskOptions {\n  /**\n   * The mask format string (e.g., '00/00/0000' for dates, 'AAA-000' for custom IDs).\n   *\n   * Supported flags: a, A, C, L, 0, 9, #, &, ?.\n   *\n   * Use `'\\'` to escape a flag character if it should be treated as a literal.\n   * @default 'CCCCCCCCCC'\n   */\n  format?: string;\n\n  /**\n   * The character used to prompt for input in unfilled mask positions.\n   *\n   * Only the first character is used, and a mask flag is rejected in favor of the\n   * default - the same rules the `prompt` accessor applies.\n   * @default '_'\n   */\n  promptCharacter?: string;\n}\n\n/** Internal options with all required fields */\ninterface MaskOptionsInternal {\n  format: string;\n  promptCharacter: string;\n}\n\n/**\n * Result type for the replace operation, containing the new masked value and the\n * ideal cursor position.\n */\ntype MaskReplaceResult = {\n  value: string;\n  end: number;\n};\n\nconst MASK_FLAGS = new Set('aACL09#&?');\nconst MASK_REQUIRED_FLAGS = new Set('0#LA&');\n\nconst ESCAPE_CHAR = '\\\\';\nconst DEFAULT_FORMAT = 'CCCCCCCCCC';\nconst DEFAULT_PROMPT = '_';\n\nconst ASCII_ZERO = 0x0030;\nconst DIGIT_ZERO_CODEPOINTS = [\n  ASCII_ZERO, // ASCII\n  0x0660, // Arabic-Indic\n  0x06f0, // Extended Arabic-Indic\n  0x0966, // Devanagari\n  0x09e6, // Bengali\n  0x0a66, // Gurmukhi\n  0x0ae6, // Gujarati\n  0x0b66, // Oriya\n  0x0c66, // Telugu\n  0x0ce6, // Kannada\n  0x0d66, // Malayalam\n  0x0e50, // Thai\n  0x0ed0, // Lao\n  0x0f20, // Tibetan\n  0x1040, // Myanmar\n  0x17e0, // Khmer\n  0x1810, // Mongolian\n  0xff10, // Full-width\n] as const;\n\n/**\n * Precomputed map of Unicode digit codepoints to their ASCII equivalents.\n * This eliminates the need for iteration during conversion.\n */\nconst UNICODE_DIGIT_TO_ASCII = new Map<number, string>(\n  DIGIT_ZERO_CODEPOINTS.flatMap((zeroCodePoint) =>\n    Array.from({ length: 10 }, (_, i) => [\n      zeroCodePoint + i,\n      String.fromCharCode(ASCII_ZERO + i),\n    ])\n  )\n);\n\n/**\n * Narrows a prompt down to the single character the parser will actually use.\n *\n * Falls back to `current` when the prompt is empty or collides with a mask flag - a flag\n * standing in for an unfilled position could not be told apart from one the user typed.\n */\nfunction normalizePrompt(value: string | undefined, current: string): string {\n  const char = value ? value.substring(0, 1) : current;\n  return MASK_FLAGS.has(char) ? current : char;\n}\n\nfunction replaceUnicodeNumbers(text: string): string {\n  const matcher = /\\p{Nd}/gu;\n\n  return text.replace(matcher, (digit) => {\n    return UNICODE_DIGIT_TO_ASCII.get(digit.charCodeAt(0)) ?? digit;\n  });\n}\n\nconst MASK_PATTERNS = new Map<string, RegExp>([\n  ['C', /[\\s\\S]/u], // Any single character (including newlines)\n  ['&', /[^\\p{Separator}]/u], // Any non-separator character (excludes spaces, line/paragraph separators)\n  ['a', /[\\p{Letter}\\p{Number}\\p{Separator}]/u], // Alphanumeric and separator characters (Unicode-aware)\n  ['A', /[\\p{Letter}\\p{Number}]/u], // Alphanumeric (Unicode-aware)\n  ['?', /[\\p{Letter}\\p{Separator}]/u], // Alphabetic and separator characters (Unicode-aware)\n  ['L', /\\p{Letter}/u], // Alphabetic (Unicode-aware)\n  ['0', /\\p{Number}/u], // Numeric (Unicode-aware, converted to ASCII 0-9 during processing)\n  ['9', /[\\p{Number}\\p{Separator}]/u], // Numeric and separator characters (Unicode-aware)\n  ['#', /[\\p{Number}\\-+]/u], // Numeric and sign characters (+, -)\n]);\n\nfunction validate(char: string, flag: string): boolean {\n  return MASK_PATTERNS.get(flag)?.test(char) ?? false;\n}\n\n/**\n * A class for parsing and applying masks to strings, typically for input fields.\n * It handles mask definitions, literals, character validation, and cursor positioning.\n */\nexport class MaskParser {\n  protected readonly _options: MaskOptionsInternal;\n\n  /** Stores literal characters and their original positions in the mask (e.g., '(', ')', '-'). */\n  protected readonly _literals = new Map<number, string>();\n\n  /** A Set of positions where literals occur in the `_escapedMask`. */\n  protected _literalPositions = new Set<number>();\n\n  /** The mask format after processing escape characters */\n  protected _escapedMask = '';\n\n  /** Cached array of required non-literal positions for validation */\n  protected _requiredPositions: number[] = [];\n\n  /**\n   * Declared with no initializer. `useDefineForClassFields: false` emits nothing\n   * for it, so {@link _invalidate} can run from the constructor, before the\n   * subclass fields exist.\n   */\n  private _emptyMask?: string;\n\n  /**\n   * Returns a set of the all the literal positions in the mask.\n   * These positions are fixed characters that are not part of the input.\n   */\n  public get literalPositions(): ReadonlySet<number> {\n    return this._literalPositions;\n  }\n\n  /**\n   * Returns the escaped mask string.\n   * This is the mask after processing any escape sequences.\n   */\n  public get escapedMask(): string {\n    return this._escapedMask;\n  }\n\n  /**\n   * Returns the result of applying an empty string over the mask pattern.\n   */\n  public get emptyMask(): string {\n    this._emptyMask ??= this.apply();\n    return this._emptyMask;\n  }\n\n  /**\n   * Gets the unescaped mask string (the original format string).\n   * If the mask has no escape sequences, then `mask === escapedMask`.\n   */\n  public get mask(): string {\n    return this._options.format;\n  }\n\n  /**\n   * Sets the mask of the parser.\n   * When the mask is set, it triggers a re-parsing of the mask literals and escaped mask.\n   */\n  public set mask(value: string) {\n    this._options.format = value || this._options.format;\n    this._parseMaskLiterals();\n  }\n\n  /**\n   * Gets the prompt character used for unfilled mask positions.\n   */\n  public get prompt(): string {\n    return this._options.promptCharacter;\n  }\n\n  /**\n   * Sets the prompt character. Only the first character of the provided string is used.\n   * @remarks The prompt character cannot be a mask flag character.\n   */\n  public set prompt(value: string) {\n    this._options.promptCharacter = normalizePrompt(\n      value,\n      this._options.promptCharacter\n    );\n    this._invalidate();\n  }\n\n  constructor(options?: MaskOptions) {\n    this._options = {\n      format: options?.format || DEFAULT_FORMAT,\n      promptCharacter: normalizePrompt(\n        options?.promptCharacter,\n        DEFAULT_PROMPT\n      ),\n    };\n    this._parseMaskLiterals();\n  }\n\n  private _isEscapedFlag(char: string, nextChar: string): boolean {\n    return char === ESCAPE_CHAR && MASK_FLAGS.has(nextChar);\n  }\n\n  /**\n   * The pattern for the literal parser. A subclass whose public format is not a\n   * mask pattern, such as a date format, converts it here.\n   */\n  protected _toMaskFormat(format: string): string {\n    return format;\n  }\n\n  /**\n   * Drops all that comes from the mask. Runs on each mask and prompt change, and\n   * from the constructor, so an override must not touch an initialized field.\n   */\n  protected _invalidate(): void {\n    this._emptyMask = undefined;\n  }\n\n  /**\n   * Finds the literal characters of the mask format and builds the escaped\n   * mask. Runs on each mask format change.\n   */\n  protected _parseMaskLiterals(): void {\n    const mask = this._toMaskFormat(this._options.format);\n    const length = mask.length;\n    const escapedMaskChars: string[] = [];\n\n    let currentPos = 0;\n\n    this._literals.clear();\n\n    for (let i = 0; i < length; i++) {\n      const [current, next] = [mask.charAt(i), mask.charAt(i + 1)];\n\n      if (this._isEscapedFlag(current, next)) {\n        // Escaped character - push next as a literal character and skip processing it\n        this._literals.set(currentPos, next);\n        escapedMaskChars.push(next);\n        i++;\n      } else if (MASK_FLAGS.has(current)) {\n        // Regular flag character\n        escapedMaskChars.push(current);\n      } else {\n        // Literal character\n        this._literals.set(currentPos, current);\n        escapedMaskChars.push(current);\n      }\n\n      currentPos++;\n    }\n\n    this._escapedMask = escapedMaskChars.join('');\n    this._literalPositions = new Set(this._literals.keys());\n    this._requiredPositions = this._computeRequiredPositions();\n    this._invalidate();\n  }\n\n  /**\n   * The positions of the escaped mask that hold a required input flag, such as\n   * '0' or 'L', and are not literals. A valid masked string fills them all.\n   */\n  protected _computeRequiredPositions(): number[] {\n    const literalPositions = this._literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const result: number[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = escapedMask[i];\n      if (MASK_REQUIRED_FLAGS.has(char) && !literalPositions.has(i)) {\n        result.push(i);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *before* the given start position.\n   * Useful for backward navigation (e.g., backspace).\n   *\n   * @remarks\n   * If no non-literal is found before `start`, return 0.\n   */\n  public getPreviousNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n\n    for (let i = start - 1; i >= 0; i--) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return 0;\n  }\n\n  /**\n   * Finds the closest non-literal position in the mask *after* the given start position.\n   * Useful for forward navigation (e.g., arrow keys, delete key or initial cursor placement).\n   *\n   * @remarks\n   * If no non-literal is found after `start`, return the mask length.\n   */\n  public getNextNonLiteralPosition(start: number): number {\n    const literalPositions = this._literalPositions;\n    const length = this._escapedMask.length;\n\n    for (let i = Math.max(0, start); i < length; i++) {\n      if (!literalPositions.has(i)) {\n        return i;\n      }\n    }\n\n    return length;\n  }\n\n  /**\n   * Replaces a segment of the masked string with new input, simulating typing or pasting.\n   * It handles clearing the selected range and inserting new characters according to the mask.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * const current = '__/__/____';\n   * const result = parser.replace(current, '12', 0, 0);\n   * // result.value = '12/__/____', result.end = 2\n   * ```\n   */\n  public replace(\n    maskString: string,\n    value: string,\n    start: number,\n    end: number\n  ): MaskReplaceResult {\n    const literalPositions = this.literalPositions;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n    const prompt = this.prompt;\n    const endBoundary = Math.min(end, length);\n\n    // Initialize the array for the masked string or get a fresh mask with prompts and/or literals\n    const maskedChars = maskString ? [...maskString] : [...this.emptyMask];\n\n    const inputChars = Array.from(replaceUnicodeNumbers(value));\n    const inputLength = inputChars.length;\n\n    // Clear any non-literal positions from `start` to `endBoundary`\n    for (let i = start; i < endBoundary; i++) {\n      if (!literalPositions.has(i)) {\n        maskedChars[i] = prompt;\n      }\n    }\n\n    let cursor = start;\n    let inputIndex = 0;\n    let maskPosition = start;\n\n    // Iterate through the mask starting at `start` as long as there are input characters and mask positions available\n    // and start placing characters or skipping literals and invalid characters\n    for (; maskPosition < length && inputIndex < inputLength; maskPosition++) {\n      if (literalPositions.has(maskPosition)) {\n        cursor = maskPosition + 1;\n        continue;\n      }\n\n      const char = inputChars[inputIndex];\n\n      if (validate(char, escapedMask[maskPosition]) && char !== prompt) {\n        maskedChars[maskPosition] = char;\n        cursor = maskPosition + 1;\n        inputIndex++;\n      } else {\n        inputIndex++;\n        maskPosition--;\n      }\n    }\n\n    // Move the cursor to the next non-literal position or the end of the mask\n    while (cursor < length && literalPositions.has(cursor)) {\n      cursor++;\n    }\n\n    return {\n      value: maskedChars.join(''),\n      end: cursor,\n    };\n  }\n\n  /**\n   * Parses the masked string, extracting only the valid input characters.\n   * This effectively \"unmasks\" the string, removing prompts and literals.\n   */\n  public parse(masked = ''): string {\n    const literalPositions = this.literalPositions;\n    const prompt = this.prompt;\n    const length = masked.length;\n    const result: string[] = [];\n\n    for (let i = 0; i < length; i++) {\n      const char = masked[i];\n      if (!literalPositions.has(i) && char !== prompt) {\n        result.push(char);\n      }\n    }\n\n    return result.join('');\n  }\n\n  /**\n   * Checks if the masked string is valid, specifically if all required mask positions are filled\n   * with valid, non-prompt characters.\n   */\n  public isValidString(input = ''): boolean {\n    const prompt = this.prompt;\n\n    return this._requiredPositions.every((position) => {\n      const char = input[position];\n      return validate(char, this._escapedMask[position]) && char !== prompt;\n    });\n  }\n\n  /**\n   * Applies the mask format to an input string. This attempts to fit the input\n   * into the mask from left to right, filling valid positions and skipping invalid\n   * input characters.\n   *\n   * @example\n   * ```ts\n   * const parser = new MaskParser({ format: '00/00/0000' });\n   * parser.apply('12252023'); // Returns '12/25/2023'\n   * ```\n   */\n  public apply(input = ''): string {\n    const literals = this._literals;\n    const prompt = this.prompt;\n    const escapedMask = this._escapedMask;\n    const length = escapedMask.length;\n\n    // Initialize the result array with prompt characters\n    const result = new Array(length).fill(prompt);\n\n    // Place all literal characters into the result array\n    for (const [position, literal] of literals.entries()) {\n      result[position] = literal;\n    }\n\n    if (!input) {\n      return result.join('');\n    }\n\n    // Normalize Unicode digits to ASCII\n    const normalizedInput = replaceUnicodeNumbers(input);\n    const inputLength = normalizedInput.length;\n    let inputIndex = 0;\n\n    // Iterate through the mask placing input characters skipping literals and invalid ones\n    for (let i = 0; i < length; i++) {\n      if (inputIndex >= inputLength) {\n        break;\n      }\n\n      if (literals.has(i)) {\n        continue;\n      }\n\n      if (validate(normalizedInput[inputIndex], escapedMask[i])) {\n        result[i] = normalizedInput[inputIndex];\n      }\n\n      // Always advance - invalid characters are consumed/skipped\n      inputIndex++;\n    }\n\n    return result.join('');\n  }\n}\n"]}