igniteui-webcomponents 7.3.1 → 7.4.0

package/internals/part-map.js.map

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

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

@@ -1,13 +1,9 @@
 import { nothing, type TemplateResult } from 'lit';
 import type { SlotController } from '../controllers/slot.js';
 import type { IgcFormControl } from '../mixins/forms/types.js';
-/** Returns a unique id for native input elements rendered by input components. */
+/** Returns a unique id for a native input element. */
 export declare const nextInputId: () => string;
-/**
- * Resolves the shared container part names of an input-like component based
- * on its current slotted and filled state.
- * Used to apply conditional styling via CSS parts.
- */
+/** Returns the shared container part names of an input-like component. */
 export declare function resolveInputPartNames(slots: Pick<SlotController<'prefix' | 'suffix'>, 'hasAssignedElements'>, base: string, filled: boolean): Record<string, boolean>;
 export interface InputShellOptions {
     /** Active theme name. The `material` theme uses the notch layout. */
@@ -20,23 +16,18 @@ export interface InputShellOptions {
     containerParts: Record<string, boolean>;
     /** Renders the native `<input>` element. */
     renderInput: () => TemplateResult;
-    /** Optional renderer for components that need extra parts inside the container (e.g. file-input). */
+    /** Renders extra parts inside the container, as `igc-file-input` needs. */
     renderFileParts?: () => TemplateResult | typeof nothing;
-    /**
-     * Container part names contributed only by the material notch layout
-     * (e.g. the `placeholder` part of `igc-textarea`).
-     */
+    /** Container part names that only the material notch layout adds. */
     materialParts?: Record<string, boolean>;
     /**
-     * Whether the prefix/suffix wrappers are hidden while their slot has no
-     * visible assigned elements, driven by the `prefixed` and `suffixed` entries
-     * of `containerParts`. Off by default, so the wrappers always render.
+     * Hides the prefix and suffix wrappers whose `containerParts` entry is
+     * false. Off by default, so the wrappers always render.
      */
     hideEmptyAffixes?: boolean;
 }
 /**
- * Renders the shared input chrome (label, prefix, suffix, validator container)
- * around a leaf-provided input template, switching layouts between the
- * material notch and the standard flow.
+ * Renders the label, prefix, suffix and validation container around the input
+ * template of a leaf component, in the notch or the standard layout.
  */
 export declare function renderInputShell(host: IgcFormControl, { containerParts, materialParts, hideEmptyAffixes, renderFileParts, renderInput, theme, label, labelId, }: InputShellOptions): TemplateResult;

package/internals/templates/input-shell.js

@@ -1,6 +1,7 @@
 import { html, nothing } from 'lit';
 import IgcValidationContainerComponent from '../../components/validation-container/validation-container.js';
 import { partMap } from '../part-map.js';
+import { stopPropagation } from '../utils/events.js';
 import { createIdGenerator } from '../utils/strings.js';
 export const nextInputId = createIdGenerator('input');
 export function resolveInputPartNames(slots, base, filled) {
@@ -17,7 +18,9 @@ export function resolveInputPartNames(slots, base, filled) {
 }
 function renderLabel(forId, label) {
     return label
-        ? html `<label part="label" for=${forId}>${label}</label>`
+        ? html `<label part="label" for=${forId} @click=${stopPropagation}
+        >${label}</label
+      >`
         : nothing;
 }
 function renderAffix(name, hidden) {

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

@@ -1 +1 @@
-{"version":3,"file":"input-shell.js","sourceRoot":"","sources":["../../../src/internals/templates/input-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AACzD,OAAO,+BAA+B,MAAM,+DAA+D,CAAC;AAG5G,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAOtD,MAAM,UAAU,qBAAqB,CACnC,KAAuE,EACvE,IAAY,EACZ,MAAe;IAEf,OAAO;QACL,CAAC,IAAI,CAAC,EAAE,IAAI;QACZ,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE;YAC5C,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE;YAC5C,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AA4BD,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa;IAC/C,OAAO,KAAK;QACV,CAAC,CAAC,IAAI,CAAA,2BAA2B,KAAK,IAAI,KAAK,UAAU;QACzD,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAyB,EAAE,MAAe;IAC7D,OAAO,IAAI,CAAA,aAAa,IAAI,YAAY,MAAM;iBAC/B,IAAI;SACZ,CAAC;AACV,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAC9B,IAAoB,EACpB,EACE,cAAc,EACd,aAAa,EACb,gBAAgB,GAAG,KAAK,EACxB,eAAe,EACf,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,GACW;IAEpB,MAAM,SAAS,GAAG,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;IACzD,MAAM,MAAM,GAAG,WAAW,CACxB,QAAQ,EACR,gBAAgB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAC7C,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,CACxB,QAAQ,EACR,gBAAgB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAC7C,CAAC;IAEF,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;;eAEA,OAAO,CAAC;YACb,GAAG,cAAc;YACjB,GAAG,aAAa;YAChB,QAAQ,EAAE,CAAC,CAAC,KAAK;SAClB,CAAC;;4BAEkB,MAAM;UACxB,KAAK,GAAG,SAAS;4BACC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;;0BAE7B,MAAM;;QAExB,SAAS;KACZ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAA;MACP,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;gBACjB,OAAO,CAAC,cAAc,CAAC;QAC/B,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM;;MAErC,SAAS;GACZ,CAAC;AACJ,CAAC","sourcesContent":["import { html, nothing, type TemplateResult } from 'lit';\nimport IgcValidationContainerComponent from '../../components/validation-container/validation-container.js';\nimport type { SlotController } from '../controllers/slot.js';\nimport type { IgcFormControl } from '../mixins/forms/types.js';\nimport { partMap } from '../part-map.js';\nimport { createIdGenerator } from '../utils/strings.js';\n\n/** Returns a unique id for native input elements rendered by input components. */\nexport const nextInputId = createIdGenerator('input');\n\n/**\n * Resolves the shared container part names of an input-like component based\n * on its current slotted and filled state.\n * Used to apply conditional styling via CSS parts.\n */\nexport function resolveInputPartNames(\n  slots: Pick<SlotController<'prefix' | 'suffix'>, 'hasAssignedElements'>,\n  base: string,\n  filled: boolean\n): Record<string, boolean> {\n  return {\n    [base]: true,\n    prefixed: slots.hasAssignedElements('prefix', {\n      selector: '[slot=\"prefix\"]:not([hidden])',\n    }),\n    suffixed: slots.hasAssignedElements('suffix', {\n      selector: '[slot=\"suffix\"]:not([hidden])',\n    }),\n    filled,\n  };\n}\n\nexport interface InputShellOptions {\n  /** Active theme name. The `material` theme uses the notch layout. */\n  theme: string;\n  /** The label text. Empty string skips label rendering. */\n  label: string;\n  /** The id of the input element used by the label `for` attribute. */\n  labelId: string;\n  /** Resolved part-name map for the container element. */\n  containerParts: Record<string, boolean>;\n  /** Renders the native `<input>` element. */\n  renderInput: () => TemplateResult;\n  /** Optional renderer for components that need extra parts inside the container (e.g. file-input). */\n  renderFileParts?: () => TemplateResult | typeof nothing;\n  /**\n   * Container part names contributed only by the material notch layout\n   * (e.g. the `placeholder` part of `igc-textarea`).\n   */\n  materialParts?: Record<string, boolean>;\n  /**\n   * Whether the prefix/suffix wrappers are hidden while their slot has no\n   * visible assigned elements, driven by the `prefixed` and `suffixed` entries\n   * of `containerParts`. Off by default, so the wrappers always render.\n   */\n  hideEmptyAffixes?: boolean;\n}\n\nfunction renderLabel(forId: string, label: string) {\n  return label\n    ? html`<label part=\"label\" for=${forId}>${label}</label>`\n    : nothing;\n}\n\nfunction renderAffix(name: 'prefix' | 'suffix', hidden: boolean) {\n  return html`<div part=${name} ?hidden=${hidden}>\n    <slot name=${name}></slot>\n  </div>`;\n}\n\n/**\n * Renders the shared input chrome (label, prefix, suffix, validator container)\n * around a leaf-provided input template, switching layouts between the\n * material notch and the standard flow.\n */\nexport function renderInputShell(\n  host: IgcFormControl,\n  {\n    containerParts,\n    materialParts,\n    hideEmptyAffixes = false,\n    renderFileParts,\n    renderInput,\n    theme,\n    label,\n    labelId,\n  }: InputShellOptions\n): TemplateResult {\n  const validator = IgcValidationContainerComponent.create(host);\n  const input = renderInput.call(host);\n  const fileParts = renderFileParts?.call(host) ?? nothing;\n  const prefix = renderAffix(\n    'prefix',\n    hideEmptyAffixes && !containerParts.prefixed\n  );\n  const suffix = renderAffix(\n    'suffix',\n    hideEmptyAffixes && !containerParts.suffixed\n  );\n\n  if (theme === 'material') {\n    return html`\n      <div\n        part=${partMap({\n          ...containerParts,\n          ...materialParts,\n          labelled: !!label,\n        })}\n      >\n        <div part=\"start\">${prefix}</div>\n        ${input}${fileParts}\n        <div part=\"notch\">${renderLabel(labelId, label)}</div>\n        <div part=\"filler\"></div>\n        <div part=\"end\">${suffix}</div>\n      </div>\n      ${validator}\n    `;\n  }\n\n  return html`\n    ${renderLabel(labelId, label)}\n    <div part=${partMap(containerParts)}>\n      ${prefix}${fileParts}${input}${suffix}\n    </div>\n    ${validator}\n  `;\n}\n"]}
+{"version":3,"file":"input-shell.js","sourceRoot":"","sources":["../../../src/internals/templates/input-shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAuB,MAAM,KAAK,CAAC;AACzD,OAAO,+BAA+B,MAAM,+DAA+D,CAAC;AAG5G,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAGtD,MAAM,UAAU,qBAAqB,CACnC,KAAuE,EACvE,IAAY,EACZ,MAAe;IAEf,OAAO;QACL,CAAC,IAAI,CAAC,EAAE,IAAI;QACZ,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE;YAC5C,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE;YAC5C,QAAQ,EAAE,+BAA+B;SAC1C,CAAC;QACF,MAAM;KACP,CAAC;AACJ,CAAC;AAkCD,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa;IAC/C,OAAO,KAAK;QACV,CAAC,CAAC,IAAI,CAAA,2BAA2B,KAAK,WAAW,eAAe;WACzD,KAAK;QACR;QACJ,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAyB,EAAE,MAAe;IAC7D,OAAO,IAAI,CAAA,aAAa,IAAI,YAAY,MAAM;iBAC/B,IAAI;SACZ,CAAC;AACV,CAAC;AAMD,MAAM,UAAU,gBAAgB,CAC9B,IAAoB,EACpB,EACE,cAAc,EACd,aAAa,EACb,gBAAgB,GAAG,KAAK,EACxB,eAAe,EACf,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,GACW;IAEpB,MAAM,SAAS,GAAG,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC;IACzD,MAAM,MAAM,GAAG,WAAW,CACxB,QAAQ,EACR,gBAAgB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAC7C,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,CACxB,QAAQ,EACR,gBAAgB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAC7C,CAAC;IAEF,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;;eAEA,OAAO,CAAC;YACb,GAAG,cAAc;YACjB,GAAG,aAAa;YAChB,QAAQ,EAAE,CAAC,CAAC,KAAK;SAClB,CAAC;;4BAEkB,MAAM;UACxB,KAAK,GAAG,SAAS;4BACC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;;0BAE7B,MAAM;;QAExB,SAAS;KACZ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAA;MACP,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;gBACjB,OAAO,CAAC,cAAc,CAAC;QAC/B,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM;;MAErC,SAAS;GACZ,CAAC;AACJ,CAAC","sourcesContent":["import { html, nothing, type TemplateResult } from 'lit';\nimport IgcValidationContainerComponent from '../../components/validation-container/validation-container.js';\nimport type { SlotController } from '../controllers/slot.js';\nimport type { IgcFormControl } from '../mixins/forms/types.js';\nimport { partMap } from '../part-map.js';\nimport { stopPropagation } from '../utils/events.js';\nimport { createIdGenerator } from '../utils/strings.js';\n\n/** Returns a unique id for a native input element. */\nexport const nextInputId = createIdGenerator('input');\n\n/** Returns the shared container part names of an input-like component. */\nexport function resolveInputPartNames(\n  slots: Pick<SlotController<'prefix' | 'suffix'>, 'hasAssignedElements'>,\n  base: string,\n  filled: boolean\n): Record<string, boolean> {\n  return {\n    [base]: true,\n    prefixed: slots.hasAssignedElements('prefix', {\n      selector: '[slot=\"prefix\"]:not([hidden])',\n    }),\n    suffixed: slots.hasAssignedElements('suffix', {\n      selector: '[slot=\"suffix\"]:not([hidden])',\n    }),\n    filled,\n  };\n}\n\nexport interface InputShellOptions {\n  /** Active theme name. The `material` theme uses the notch layout. */\n  theme: string;\n  /** The label text. Empty string skips label rendering. */\n  label: string;\n  /** The id of the input element used by the label `for` attribute. */\n  labelId: string;\n  /** Resolved part-name map for the container element. */\n  containerParts: Record<string, boolean>;\n  /** Renders the native `<input>` element. */\n  renderInput: () => TemplateResult;\n  /** Renders extra parts inside the container, as `igc-file-input` needs. */\n  renderFileParts?: () => TemplateResult | typeof nothing;\n  /** Container part names that only the material notch layout adds. */\n  materialParts?: Record<string, boolean>;\n  /**\n   * Hides the prefix and suffix wrappers whose `containerParts` entry is\n   * false. Off by default, so the wrappers always render.\n   */\n  hideEmptyAffixes?: boolean;\n}\n\n/**\n * Renders the label of the input.\n *\n * @remarks\n * A label click reaches the host twice: the label click, then the synthetic\n * click that label activation sends to the input. That double-fires a\n * consumer click handler and breaks the toggles of `igc-combo` and\n * `igc-select`. The label therefore keeps its own click inside the shadow\n * root; activation is a default action, so focus still moves to the input.\n */\nfunction renderLabel(forId: string, label: string) {\n  return label\n    ? html`<label part=\"label\" for=${forId} @click=${stopPropagation}\n        >${label}</label\n      >`\n    : nothing;\n}\n\nfunction renderAffix(name: 'prefix' | 'suffix', hidden: boolean) {\n  return html`<div part=${name} ?hidden=${hidden}>\n    <slot name=${name}></slot>\n  </div>`;\n}\n\n/**\n * Renders the label, prefix, suffix and validation container around the input\n * template of a leaf component, in the notch or the standard layout.\n */\nexport function renderInputShell(\n  host: IgcFormControl,\n  {\n    containerParts,\n    materialParts,\n    hideEmptyAffixes = false,\n    renderFileParts,\n    renderInput,\n    theme,\n    label,\n    labelId,\n  }: InputShellOptions\n): TemplateResult {\n  const validator = IgcValidationContainerComponent.create(host);\n  const input = renderInput.call(host);\n  const fileParts = renderFileParts?.call(host) ?? nothing;\n  const prefix = renderAffix(\n    'prefix',\n    hideEmptyAffixes && !containerParts.prefixed\n  );\n  const suffix = renderAffix(\n    'suffix',\n    hideEmptyAffixes && !containerParts.suffixed\n  );\n\n  if (theme === 'material') {\n    return html`\n      <div\n        part=${partMap({\n          ...containerParts,\n          ...materialParts,\n          labelled: !!label,\n        })}\n      >\n        <div part=\"start\">${prefix}</div>\n        ${input}${fileParts}\n        <div part=\"notch\">${renderLabel(labelId, label)}</div>\n        <div part=\"filler\"></div>\n        <div part=\"end\">${suffix}</div>\n      </div>\n      ${validator}\n    `;\n  }\n\n  return html`\n    ${renderLabel(labelId, label)}\n    <div part=${partMap(containerParts)}>\n      ${prefix}${fileParts}${input}${suffix}\n    </div>\n    ${validator}\n  `;\n}\n"]}

package/internals/templates/masked-input.d.ts

@@ -9,7 +9,7 @@ export interface MaskedInputOptions {
     name?: string;
     /** Current value to render through `live()`. */
     value: string;
-    /** Pre-resolved placeholder text. Caller decides empty-string semantics. */
+    /** The resolved placeholder text. The caller defines an empty string. */
     placeholder: string;
     readOnly: boolean;
     disabled: boolean;
@@ -18,17 +18,17 @@ export interface MaskedInputOptions {
     /** When provided, sets the `tabindex` attribute. */
     tabindex?: number;
     /**
-     * Resolved ARIA bindings for the native input - the projected host state
-     * merged with the editor's own (see `AriaTargetController.resolveBindings`).
+     * The projected host state merged with the editor bindings. See
+     * `AriaTargetController.resolveBindings`.
      */
     aria: ResolvedARIABindings;
     onInput: (event: InputEvent) => void;
-    /** Wired to `beforeinput` so the component owns `historyUndo` / `historyRedo`. */
+    /** Owns `historyUndo` and `historyRedo` through `beforeinput`. */
     onBeforeInput: (event: InputEvent) => void;
     onFocus: (event: FocusEvent) => void;
     onBlur: (event: FocusEvent) => void;
     onClick: () => void;
-    /** Wired to `keydown`, `cut`, and `dragstart` to capture the current selection. */
+    /** Captures the selection on `keydown`, `cut` and `dragstart`. */
     onSetMaskSelection: (event: Event) => void;
     onCompositionStart: () => void;
     onCompositionEnd: (event: CompositionEvent) => void;
@@ -38,8 +38,7 @@ export interface MaskedInputOptions {
     onDragLeave?: () => void;
 }
 /**
- * Renders the native `<input>` element shared by mask-driven components
- * (`igc-mask-input`, `igc-date-time-input`, `igc-date-range-input`).
- * Centralizes mask event wiring so leaves only describe their extras.
+ * Renders the native `<input>` of the mask-driven components, with the mask
+ * event bindings, so a leaf component describes only its extras.
  */
 export declare function renderMaskedNativeInput(opts: MaskedInputOptions): TemplateResult;

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

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

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

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

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

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

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

@@ -2,7 +2,7 @@ import { type TemplateResult } from 'lit';
 export interface ToggleShellOptions {
     /** The type of the native input element. */
     type: 'checkbox' | 'radio';
-    /** The id of the native input; the wrapping label points at it through `for`. */
+    /** The id of the native input; the `for` target of the wrapping label. */
     inputId: string;
     /** The id of the label span, the fallback `aria-labelledby` target. */
     labelId: string;
@@ -23,8 +23,8 @@ export interface ToggleShellOptions {
     required: boolean;
     disabled: boolean;
     /**
-     * Current indeterminate state rendered through `live()`. When absent, the
-     * binding stays `false` and `live()` skips the property write entirely.
+     * The current indeterminate state, rendered through `live()`. Defaults to
+     * `false`, and `live()` then writes nothing.
      */
     indeterminate?: boolean;
     /** When provided, sets the `tabindex` attribute. */
@@ -38,9 +38,8 @@ export interface ToggleShellOptions {
     onBlur?: () => void;
 }
 /**
- * Renders the label-wrapped native input shared by the toggle controls
- * (`igc-checkbox`, `igc-switch`, `igc-radio`).
- * Centralizes the input binding set so leaves only describe their part maps
- * and control indicator.
+ * Renders the native input and its wrapping label for a toggle control, with
+ * the input bindings, so a leaf component describes only its part maps and
+ * its control indicator.
  */
 export declare function renderToggleShell(options: ToggleShellOptions): TemplateResult;

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

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

package/internals/timing.d.ts

@@ -1,24 +1,15 @@
-/**
- * A restartable timeout handle. See {@link createTimer}.
- */
+/** A restartable timeout handle. See {@link createTimer}. */
 export type Timer = {
     /** Whether the timer is currently armed. */
     readonly active: boolean;
-    /**
-     * (Re)arms the timer, canceling a previously armed run.
-     *
-     * When `delay` is omitted, the default delay of the timer is used.
-     */
+    /** Arms the timer, cancels an armed run, and defaults `delay`. */
     start(delay?: number): void;
-    /** Cancels the armed run, if any. */
+    /** Cancels the armed run, if there is one. */
     stop(): void;
 };
 /**
- * Creates a restartable timeout around `callback`.
- *
- * Every `start` supersedes the previous one, so the callback runs at most once,
- * `delay` milliseconds after the most recent `start` - the recurring
- * "clear the stored handle, then set it again" bookkeeping is kept in one place.
+ * Creates a restartable timeout around `callback`. The callback runs one time
+ * at most, `delay` milliseconds after the most recent `start` call.
  *
  * @example
  * ```typescript

package/internals/timing.js.map

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

package/internals/utils/arrays.d.ts

@@ -1,36 +1,23 @@
-/**
- * Returns the first element of the given array.
- *
- * @remarks
- * Assumes a non-empty array - for an empty one it returns `undefined`
- * typed as `T`.
- */
+/** Returns the first element, typed as `T` even for an empty array. */
 export declare function firstOf<T>(arr: T[]): T;
-/**
- * Returns the last element of the given array.
- *
- * @remarks
- * Assumes a non-empty array - for an empty one it returns `undefined`
- * typed as `T`.
- */
+/** Returns the last element, typed as `T` even for an empty array. */
 export declare function lastOf<T>(arr: T[]): T;
 /**
- * Splits an array into chunks of a specified size and returns a generator that yields each chunk.
+ * Splits an array into chunks of the given size.
  *
  * @example
  * ```typescript
  * [...chunk([1, 2, 3, 4, 5], 2)]; // [[1, 2], [3, 4], [5]]
  * ```
  *
- * @throws If the `size` parameter is not a safe integer greater than or equal to 1.
+ * @throws If the `size` parameter is not a safe integer greater than or
+ * equal to 1.
  */
 export declare function chunk<T>(arr: T[], size: number): Generator<T[]>;
-/**
- * Returns whether a given collection is empty.
- */
+/** Returns whether a given collection is empty. */
 export declare function isEmpty<T, U extends object>(x: ArrayLike<T> | Set<T> | Map<U, T>): boolean;
 /**
- * Ensures the given value is wrapped in an array. If the value is already an array, it is returned as-is. If the value is undefined, an empty array is returned.
+ * Returns the given value as an array. An empty value gives an empty array.
  *
  * @example
  * ```typescript
@@ -41,7 +28,20 @@ export declare function isEmpty<T, U extends object>(x: ArrayLike<T> | Set<T> |
  */
 export declare function asArray<T>(value?: T | T[]): T[];
 /**
- * Splits an array into two based on a predicate function, returning a tuple of [truthy, falsy] arrays.
+ * Returns whether two collections hold the same items, in the same order and
+ * by identity. Two empty values match; an empty value differs from a
+ * collection.
+ *
+ * @example
+ * ```typescript
+ * sameItems([a, b], [a, b]); // true
+ * sameItems([a, b], [b, a]); // false
+ * sameItems(null, undefined); // true
+ * ```
+ */
+export declare function sameItems<T>(a: ArrayLike<T> | null | undefined, b: ArrayLike<T> | null | undefined): boolean;
+/**
+ * Splits an array in two with a predicate: matching items first.
  *
  * @example
  * ```typescript

package/internals/utils/arrays.js

@@ -20,6 +20,20 @@ export function asArray(value) {
         return [];
     return Array.isArray(value) ? value : [value];
 }
+export function sameItems(a, b) {
+    if (a == null || b == null) {
+        return a == null && b == null;
+    }
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i]) {
+            return false;
+        }
+    }
+    return true;
+}
 export function partition(array, isTruthy) {
     const truthy = [];
     const falsy = [];

package/internals/utils/arrays.js.map

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