igniteui-webcomponents 7.1.2 → 7.2.0

package/components/combo/controllers/navigation.js

@@ -38,6 +38,9 @@ export class ComboNavigationController {
                 if (shiftKey) {
                     this._host.focus();
                 }
+                if (this._host.singleSelect && this.active > -1) {
+                    this._config.interactions.select(this.active);
+                }
                 await this._config.interactions.hide();
             }
         };

package/components/combo/controllers/navigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../../src/components/combo/controllers/navigation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,MAAM,EACN,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,OAAO,EAEP,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,MAAM,0CAA0C,CAAC;AAsBlD,MAAM,OAAO,yBAAyB;IAOpC,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAClC,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,IAAY,UAAU;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IAMD,YACE,IAAkB,EAClB,KAAmB,EACnB,MAA6B;QALxB,WAAM,GAAG,CAAC,CAAC,CAAC;QA+DX,aAAQ,GAAG,GAAS,EAAE;YAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC;QAEM,aAAQ,GAAG,KAAK,IAAmB,EAAE;YAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrB,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChD,CAAC;gBACD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;oBAC3C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACtB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEM,WAAM,GAAG,KAAK,EAAE,EAAE,QAAQ,EAAiB,EAAiB,EAAE;YACpE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpB,IAAI,QAAQ,EAAE,CAAC;oBAGb,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;gBACD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;QAEM,cAAS,GAAG,KAAK,IAAmB,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;YAC7C,CAAC;YAED,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QAEM,0BAAqB,GAAG,KAAK,IAAmB,EAAE;YACxD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAClE,OAAO;YACT,CAAC;YAED,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QAEM,uBAAkB,GAAG,GAAS,EAAE;YACtC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC;QAEM,YAAO,GAAG,GAAS,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC;QAEM,WAAM,GAAG,GAAS,EAAE;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC;QAEM,eAAU,GAAG,GAAS,EAAE;YAC9B,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC;QAEM,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC;QApIA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,eAAe,GAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAGhD,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;aAClD,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;aACnD,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE;YACpC,cAAc,EAAE,KAAK;SACtB,CAAC;aACD,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAGlC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACvB,eAAe;SAChB,CAAC;aACC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC;aAC5C,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC;aACpD,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,qBAAqB,CAAC;aAC1C,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAGhC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACxB,eAAe;SAChB,CAAC;aACC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;aAC5B,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAG3C,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACtB,eAAe;SAChB,CAAC;aACC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;aAC7B,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;aACjC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;aAC1B,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;aACxB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;aAC5B,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEM,gBAAgB;QACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnB,CAAC;IAsFO,eAAe,CAAC,QAAyB;QAC/C,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;YAC/C,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,QAAQ,IAAI,MAAM;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAC9B,CAAC;IAEO,eAAe,CAAC,KAAa,EAAE,KAAa;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE5B,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEtD,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACnD,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE;gBAClC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE;gBAC5B,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CAGF","sourcesContent":["import type { Ref } from 'lit/directives/ref.js';\nimport {\n  addKeybindings,\n  altKey,\n  arrowDown,\n  arrowUp,\n  endKey,\n  enterKey,\n  escapeKey,\n  homeKey,\n  type KeyBindingOptions,\n  shiftKey,\n  spaceBar,\n  tabKey,\n} from '../../common/controllers/key-bindings.js';\nimport type IgcInputComponent from '../../input/input.js';\nimport type IgcComboListComponent from '../combo-list.js';\nimport type { ComboHost } from '../types.js';\nimport type { DataState } from './data.js';\n\ntype ComboNavigationConfig = {\n  /** The primary input of the combo component. */\n  input: Ref<IgcInputComponent>;\n  /** The search input of the combo component. */\n  search: Ref<IgcInputComponent>;\n  /** The combo virtualized dropdown list. */\n  list: Ref<IgcComboListComponent>;\n  interactions: {\n    show: () => Promise<boolean>;\n    hide: () => Promise<boolean>;\n    toggleSelection: (index: number) => void;\n    select: (index: number) => void;\n    clearSelection: () => void;\n  };\n};\n\nexport class ComboNavigationController<T extends object> {\n  //#region Internal state\n\n  private readonly _host: ComboHost<T>;\n  private readonly _state: DataState<T>;\n  private readonly _config: ComboNavigationConfig;\n\n  private get _input(): IgcInputComponent | undefined {\n    return this._config.input.value;\n  }\n\n  private get _searchInput(): IgcInputComponent | undefined {\n    return this._config.search.value;\n  }\n\n  private get _list(): IgcComboListComponent | undefined {\n    return this._config.list.value;\n  }\n\n  private get _firstItem(): number {\n    return this._state.dataState.findIndex((rec) => !rec.header);\n  }\n\n  private get _lastItem(): number {\n    return this._state.dataState.length - 1;\n  }\n\n  //#endregion\n\n  public active = -1;\n\n  constructor(\n    host: ComboHost<T>,\n    state: DataState<T>,\n    config: ComboNavigationConfig\n  ) {\n    this._host = host;\n    this._state = state;\n    this._config = config;\n    this._host.addController(this);\n\n    const bindingDefaults: KeyBindingOptions = { repeat: true };\n    const skip = (): boolean => this._host.disabled;\n\n    // Combo\n    addKeybindings(this._host, { skip, bindingDefaults })\n      .set(tabKey, this._onTab, { preventDefault: false })\n      .set([shiftKey, tabKey], this._onTab, {\n        preventDefault: false,\n      })\n      .set(escapeKey, this._onEscape);\n\n    // Main input\n    addKeybindings(this._host, {\n      skip,\n      ref: this._config.input,\n      bindingDefaults,\n    })\n      .set(arrowUp, this._config.interactions.hide)\n      .set([altKey, arrowDown], this._onMainInputArrowDown)\n      .set(arrowDown, this._onMainInputArrowDown)\n      .set(enterKey, this._onEnter);\n\n    // Search input\n    addKeybindings(this._host, {\n      skip,\n      ref: this._config.search,\n      bindingDefaults,\n    })\n      .set(arrowUp, this._onEscape)\n      .set(arrowDown, this._onSearchArrowDown);\n\n    // List\n    addKeybindings(this._host, {\n      skip,\n      ref: this._config.list,\n      bindingDefaults,\n    })\n      .set(arrowUp, this._onArrowUp)\n      .set(arrowDown, this._onArrowDown)\n      .set(homeKey, this._onHome)\n      .set(endKey, this._onEnd)\n      .set(spaceBar, this._onSpace)\n      .set(enterKey, this._onEnter);\n  }\n\n  public hostDisconnected(): void {\n    this.active = -1;\n  }\n\n  //#region Event handlers\n\n  private _onSpace = (): void => {\n    if (this.active > -1) {\n      this._config.interactions.toggleSelection(this.active);\n    }\n  };\n\n  private _onEnter = async (): Promise<void> => {\n    if (this.active > -1) {\n      if (this._host.singleSelect) {\n        this._config.interactions.select(this.active);\n      }\n      if (await this._config.interactions.hide()) {\n        this._input?.select();\n        this._host.focus();\n      }\n    }\n  };\n\n  private _onTab = async ({ shiftKey }: KeyboardEvent): Promise<void> => {\n    if (this._host.open) {\n      if (shiftKey) {\n        // Move focus to the main input of the combo\n        // before the Shift+Tab behavior kicks in.\n        this._host.focus();\n      }\n      await this._config.interactions.hide();\n    }\n  };\n\n  private _onEscape = async (): Promise<void> => {\n    if (!this._host.open) {\n      this._config.interactions.clearSelection();\n    }\n\n    if (await this._config.interactions.hide()) {\n      this._input?.focus();\n    }\n  };\n\n  private _onMainInputArrowDown = async (): Promise<void> => {\n    if (!this._host.open && !(await this._config.interactions.show())) {\n      return;\n    }\n\n    if (this._host.singleSelect) {\n      this._onSearchArrowDown();\n    }\n  };\n\n  private _onSearchArrowDown = (): void => {\n    this._list?.focus();\n    this._onArrowDown();\n  };\n\n  private _onHome = (): void => {\n    const previous = this.active;\n    this.active = this._firstItem;\n    this._scrollToActive();\n    this._host.requestUpdate('_activeIndex', previous);\n  };\n\n  private _onEnd = (): void => {\n    const previous = this.active;\n    this.active = this._lastItem;\n    this._scrollToActive();\n    this._host.requestUpdate('_activeIndex', previous);\n  };\n\n  private _onArrowUp = (): void => {\n    this._getNextItem(-1);\n    this._scrollToActive();\n  };\n\n  private _onArrowDown = (): void => {\n    this._getNextItem(1);\n    this._scrollToActive();\n  };\n\n  //#endregion\n\n  //#region Internal helper methods\n\n  private _scrollToActive(behavior?: ScrollBehavior): void {\n    this._list?.element(this.active)?.scrollIntoView({\n      block: 'center',\n      behavior: behavior ?? 'auto',\n    });\n\n    this._list?.requestUpdate();\n  }\n\n  private _getNearestItem(start: number, delta: -1 | 1): number {\n    const items = this._state.dataState;\n    const length = items.length;\n\n    for (let i = start + delta; i >= 0 && i < length; i += delta) {\n      if (!items[i].header) {\n        return i;\n      }\n    }\n\n    return -1;\n  }\n\n  private _getNextItem(delta: -1 | 1): void {\n    const next = this._getNearestItem(this.active, delta);\n\n    if (next === -1 && this.active === this._firstItem) {\n      this._searchInput?.checkVisibility() // Non single-select or disable-filtering combo configuration\n        ? this._searchInput?.focus() // Delegate to search input handlers\n        : this._onEscape(); // Close dropdown and move focus back to main input\n      return;\n    }\n\n    if (next !== -1) {\n      const previous = this.active;\n      this.active = next;\n      this._host.requestUpdate('_activeIndex', previous);\n    }\n  }\n\n  //#endregion\n}\n"]}
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../../src/components/combo/controllers/navigation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,MAAM,EACN,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,OAAO,EAEP,QAAQ,EACR,QAAQ,EACR,MAAM,GACP,MAAM,0CAA0C,CAAC;AAsBlD,MAAM,OAAO,yBAAyB;IAOpC,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAClC,CAAC;IAED,IAAY,YAAY;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACnC,CAAC;IAED,IAAY,KAAK;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACjC,CAAC;IAED,IAAY,UAAU;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,IAAY,SAAS;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IAMD,YACE,IAAkB,EAClB,KAAmB,EACnB,MAA6B;QALxB,WAAM,GAAG,CAAC,CAAC,CAAC;QA+DX,aAAQ,GAAG,GAAS,EAAE;YAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC;QAEM,aAAQ,GAAG,KAAK,IAAmB,EAAE;YAC3C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrB,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChD,CAAC;gBACD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;oBAC3C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACtB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEM,WAAM,GAAG,KAAK,EAAE,EAAE,QAAQ,EAAiB,EAAiB,EAAE;YACpE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpB,IAAI,QAAQ,EAAE,CAAC;oBAGb,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;gBAED,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;oBAChD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAChD,CAAC;gBAED,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;QAEM,cAAS,GAAG,KAAK,IAAmB,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;YAC7C,CAAC;YAED,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QAEM,0BAAqB,GAAG,KAAK,IAAmB,EAAE;YACxD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAClE,OAAO;YACT,CAAC;YAED,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBAC5B,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QAEM,uBAAkB,GAAG,GAAS,EAAE;YACtC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,CAAC;QAEM,YAAO,GAAG,GAAS,EAAE;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;YAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC;QAEM,WAAM,GAAG,GAAS,EAAE;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC;QAEM,eAAU,GAAG,GAAS,EAAE;YAC9B,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC;QAEM,iBAAY,GAAG,GAAS,EAAE;YAChC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC,CAAC;QAzIA,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,eAAe,GAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,GAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAGhD,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;aAClD,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;aACnD,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE;YACpC,cAAc,EAAE,KAAK;SACtB,CAAC;aACD,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAGlC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACvB,eAAe;SAChB,CAAC;aACC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC;aAC5C,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC;aACpD,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,qBAAqB,CAAC;aAC1C,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAGhC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACxB,eAAe;SAChB,CAAC;aACC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;aAC5B,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAG3C,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE;YACzB,IAAI;YACJ,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACtB,eAAe;SAChB,CAAC;aACC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;aAC7B,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;aACjC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;aAC1B,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;aACxB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;aAC5B,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEM,gBAAgB;QACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnB,CAAC;IA2FO,eAAe,CAAC,QAAyB;QAC/C,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;YAC/C,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,QAAQ,IAAI,MAAM;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAC9B,CAAC;IAEO,eAAe,CAAC,KAAa,EAAE,KAAa;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE5B,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEtD,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACnD,IAAI,CAAC,YAAY,EAAE,eAAe,EAAE;gBAClC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE;gBAC5B,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CAGF","sourcesContent":["import type { Ref } from 'lit/directives/ref.js';\nimport {\n  addKeybindings,\n  altKey,\n  arrowDown,\n  arrowUp,\n  endKey,\n  enterKey,\n  escapeKey,\n  homeKey,\n  type KeyBindingOptions,\n  shiftKey,\n  spaceBar,\n  tabKey,\n} from '../../common/controllers/key-bindings.js';\nimport type IgcInputComponent from '../../input/input.js';\nimport type IgcComboListComponent from '../combo-list.js';\nimport type { ComboHost } from '../types.js';\nimport type { DataState } from './data.js';\n\ntype ComboNavigationConfig = {\n  /** The primary input of the combo component. */\n  input: Ref<IgcInputComponent>;\n  /** The search input of the combo component. */\n  search: Ref<IgcInputComponent>;\n  /** The combo virtualized dropdown list. */\n  list: Ref<IgcComboListComponent>;\n  interactions: {\n    show: () => Promise<boolean>;\n    hide: () => Promise<boolean>;\n    toggleSelection: (index: number) => void;\n    select: (index: number) => void;\n    clearSelection: () => void;\n  };\n};\n\nexport class ComboNavigationController<T extends object> {\n  //#region Internal state\n\n  private readonly _host: ComboHost<T>;\n  private readonly _state: DataState<T>;\n  private readonly _config: ComboNavigationConfig;\n\n  private get _input(): IgcInputComponent | undefined {\n    return this._config.input.value;\n  }\n\n  private get _searchInput(): IgcInputComponent | undefined {\n    return this._config.search.value;\n  }\n\n  private get _list(): IgcComboListComponent | undefined {\n    return this._config.list.value;\n  }\n\n  private get _firstItem(): number {\n    return this._state.dataState.findIndex((rec) => !rec.header);\n  }\n\n  private get _lastItem(): number {\n    return this._state.dataState.length - 1;\n  }\n\n  //#endregion\n\n  public active = -1;\n\n  constructor(\n    host: ComboHost<T>,\n    state: DataState<T>,\n    config: ComboNavigationConfig\n  ) {\n    this._host = host;\n    this._state = state;\n    this._config = config;\n    this._host.addController(this);\n\n    const bindingDefaults: KeyBindingOptions = { repeat: true };\n    const skip = (): boolean => this._host.disabled;\n\n    // Combo\n    addKeybindings(this._host, { skip, bindingDefaults })\n      .set(tabKey, this._onTab, { preventDefault: false })\n      .set([shiftKey, tabKey], this._onTab, {\n        preventDefault: false,\n      })\n      .set(escapeKey, this._onEscape);\n\n    // Main input\n    addKeybindings(this._host, {\n      skip,\n      ref: this._config.input,\n      bindingDefaults,\n    })\n      .set(arrowUp, this._config.interactions.hide)\n      .set([altKey, arrowDown], this._onMainInputArrowDown)\n      .set(arrowDown, this._onMainInputArrowDown)\n      .set(enterKey, this._onEnter);\n\n    // Search input\n    addKeybindings(this._host, {\n      skip,\n      ref: this._config.search,\n      bindingDefaults,\n    })\n      .set(arrowUp, this._onEscape)\n      .set(arrowDown, this._onSearchArrowDown);\n\n    // List\n    addKeybindings(this._host, {\n      skip,\n      ref: this._config.list,\n      bindingDefaults,\n    })\n      .set(arrowUp, this._onArrowUp)\n      .set(arrowDown, this._onArrowDown)\n      .set(homeKey, this._onHome)\n      .set(endKey, this._onEnd)\n      .set(spaceBar, this._onSpace)\n      .set(enterKey, this._onEnter);\n  }\n\n  public hostDisconnected(): void {\n    this.active = -1;\n  }\n\n  //#region Event handlers\n\n  private _onSpace = (): void => {\n    if (this.active > -1) {\n      this._config.interactions.toggleSelection(this.active);\n    }\n  };\n\n  private _onEnter = async (): Promise<void> => {\n    if (this.active > -1) {\n      if (this._host.singleSelect) {\n        this._config.interactions.select(this.active);\n      }\n      if (await this._config.interactions.hide()) {\n        this._input?.select();\n        this._host.focus();\n      }\n    }\n  };\n\n  private _onTab = async ({ shiftKey }: KeyboardEvent): Promise<void> => {\n    if (this._host.open) {\n      if (shiftKey) {\n        // Move focus to the main input of the combo\n        // before the Shift+Tab behavior kicks in.\n        this._host.focus();\n      }\n\n      if (this._host.singleSelect && this.active > -1) {\n        this._config.interactions.select(this.active);\n      }\n\n      await this._config.interactions.hide();\n    }\n  };\n\n  private _onEscape = async (): Promise<void> => {\n    if (!this._host.open) {\n      this._config.interactions.clearSelection();\n    }\n\n    if (await this._config.interactions.hide()) {\n      this._input?.focus();\n    }\n  };\n\n  private _onMainInputArrowDown = async (): Promise<void> => {\n    if (!this._host.open && !(await this._config.interactions.show())) {\n      return;\n    }\n\n    if (this._host.singleSelect) {\n      this._onSearchArrowDown();\n    }\n  };\n\n  private _onSearchArrowDown = (): void => {\n    this._list?.focus();\n    this._onArrowDown();\n  };\n\n  private _onHome = (): void => {\n    const previous = this.active;\n    this.active = this._firstItem;\n    this._scrollToActive();\n    this._host.requestUpdate('_activeIndex', previous);\n  };\n\n  private _onEnd = (): void => {\n    const previous = this.active;\n    this.active = this._lastItem;\n    this._scrollToActive();\n    this._host.requestUpdate('_activeIndex', previous);\n  };\n\n  private _onArrowUp = (): void => {\n    this._getNextItem(-1);\n    this._scrollToActive();\n  };\n\n  private _onArrowDown = (): void => {\n    this._getNextItem(1);\n    this._scrollToActive();\n  };\n\n  //#endregion\n\n  //#region Internal helper methods\n\n  private _scrollToActive(behavior?: ScrollBehavior): void {\n    this._list?.element(this.active)?.scrollIntoView({\n      block: 'center',\n      behavior: behavior ?? 'auto',\n    });\n\n    this._list?.requestUpdate();\n  }\n\n  private _getNearestItem(start: number, delta: -1 | 1): number {\n    const items = this._state.dataState;\n    const length = items.length;\n\n    for (let i = start + delta; i >= 0 && i < length; i += delta) {\n      if (!items[i].header) {\n        return i;\n      }\n    }\n\n    return -1;\n  }\n\n  private _getNextItem(delta: -1 | 1): void {\n    const next = this._getNearestItem(this.active, delta);\n\n    if (next === -1 && this.active === this._firstItem) {\n      this._searchInput?.checkVisibility() // Non single-select or disable-filtering combo configuration\n        ? this._searchInput?.focus() // Delegate to search input handlers\n        : this._onEscape(); // Close dropdown and move focus back to main input\n      return;\n    }\n\n    if (next !== -1) {\n      const previous = this.active;\n      this.active = next;\n      this._host.requestUpdate('_activeIndex', previous);\n    }\n  }\n\n  //#endregion\n}\n"]}

package/components/common/controllers/command.d.ts

@@ -0,0 +1,62 @@
+import type { LitElement, ReactiveController } from 'lit';
+/**
+ * A Lit reactive controller that bridges the native
+ * [Invoker Commands API](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API)
+ * with a component's programmatic API.
+ *
+ * When an `igc-button` (or any element using the `command` / `commandfor`
+ * attributes) invokes a command on the host, the browser dispatches a
+ * `CommandEvent` on the target element. This controller listens for that
+ * event and forwards it to the registered callback for the given command
+ * string.
+ *
+ * @example
+ * ```ts
+ * class IgcDialogComponent extends LitElement {
+ *   private readonly _commands = addCommandController(this)
+ *     .set('open', this.show)
+ *     .set('close', this.hide)
+ *     .set('toggle-popover', this.toggle);
+ * }
+ * ```
+ *
+ * With the above setup, a button in the document can control the dialog
+ * declaratively:
+ *
+ * ```html
+ * <igc-button command="open" commandfor="my-dialog">Open</igc-button>
+ * <igc-dialog id="my-dialog"></igc-dialog>
+ * ```
+ */
+declare class CommandController implements ReactiveController {
+    private readonly _host;
+    private readonly _commandMap;
+    constructor(host: LitElement);
+    /**
+     * Registers a command string and its corresponding handler callback.
+     *
+     * Returns `this` to allow chained calls:
+     * ```ts
+     * addCommandController(this)
+     *   .set('open', this.show)
+     *   .set('close', this.hide);
+     * ```
+     *
+     * @param command - The command string to listen for (e.g. `'open'`,
+     *   `'toggle-popover'`, or a custom `'--my-command'`).
+     * @param callback - The method to invoke when the command is received.
+     *   Called with the host as `this`.
+     */
+    set(command: string, callback: () => unknown): this;
+    /** @internal */
+    hostConnected(): void;
+    /** @internal */
+    hostDisconnected(): void;
+    /** @internal */
+    handleEvent(event: Event): void;
+}
+/**
+ * Creates a {@link CommandController} and attaches it to the given host.
+ */
+export declare function addCommandController(host: LitElement): CommandController;
+export type { CommandController };

package/components/common/controllers/command.js

@@ -0,0 +1,25 @@
+class CommandController {
+    constructor(host) {
+        this._commandMap = new Map();
+        this._host = host;
+        host.addController(this);
+    }
+    set(command, callback) {
+        this._commandMap.set(command, callback);
+        return this;
+    }
+    hostConnected() {
+        this._host.addEventListener('command', this);
+    }
+    hostDisconnected() {
+        this._host.removeEventListener('command', this);
+    }
+    handleEvent(event) {
+        const commandEvent = event;
+        this._commandMap.get(commandEvent.command)?.call(this._host);
+    }
+}
+export function addCommandController(host) {
+    return new CommandController(host);
+}
+//# sourceMappingURL=command.js.map

package/components/common/controllers/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../../src/components/common/controllers/command.ts"],"names":[],"mappings":"AA+BA,MAAM,iBAAiB;IAIrB,YAAY,IAAgB;QAFX,gBAAW,GAAG,IAAI,GAAG,EAAyB,CAAC;QAG9D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAiBM,GAAG,CAAC,OAAe,EAAE,QAAuB;QACjD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAGM,aAAa;QAClB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAGM,gBAAgB;QACrB,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAGM,WAAW,CAAC,KAAY;QAC7B,MAAM,YAAY,GAAG,KAAqB,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;CACF;AAKD,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC","sourcesContent":["import type { LitElement, ReactiveController } from 'lit';\n\n/**\n * A Lit reactive controller that bridges the native\n * [Invoker Commands API](https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API)\n * with a component's programmatic API.\n *\n * When an `igc-button` (or any element using the `command` / `commandfor`\n * attributes) invokes a command on the host, the browser dispatches a\n * `CommandEvent` on the target element. This controller listens for that\n * event and forwards it to the registered callback for the given command\n * string.\n *\n * @example\n * ```ts\n * class IgcDialogComponent extends LitElement {\n *   private readonly _commands = addCommandController(this)\n *     .set('open', this.show)\n *     .set('close', this.hide)\n *     .set('toggle-popover', this.toggle);\n * }\n * ```\n *\n * With the above setup, a button in the document can control the dialog\n * declaratively:\n *\n * ```html\n * <igc-button command=\"open\" commandfor=\"my-dialog\">Open</igc-button>\n * <igc-dialog id=\"my-dialog\"></igc-dialog>\n * ```\n */\nclass CommandController implements ReactiveController {\n  private readonly _host: LitElement;\n  private readonly _commandMap = new Map<string, () => unknown>();\n\n  constructor(host: LitElement) {\n    this._host = host;\n    host.addController(this);\n  }\n\n  /**\n   * Registers a command string and its corresponding handler callback.\n   *\n   * Returns `this` to allow chained calls:\n   * ```ts\n   * addCommandController(this)\n   *   .set('open', this.show)\n   *   .set('close', this.hide);\n   * ```\n   *\n   * @param command - The command string to listen for (e.g. `'open'`,\n   *   `'toggle-popover'`, or a custom `'--my-command'`).\n   * @param callback - The method to invoke when the command is received.\n   *   Called with the host as `this`.\n   */\n  public set(command: string, callback: () => unknown): this {\n    this._commandMap.set(command, callback);\n    return this;\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._host.addEventListener('command', this);\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    this._host.removeEventListener('command', this);\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    const commandEvent = event as CommandEvent;\n    this._commandMap.get(commandEvent.command)?.call(this._host);\n  }\n}\n\n/**\n * Creates a {@link CommandController} and attaches it to the given host.\n */\nexport function addCommandController(host: LitElement): CommandController {\n  return new CommandController(host);\n}\n\nexport type { CommandController };\n"]}

package/components/common/controllers/id-resolver.d.ts

@@ -0,0 +1,31 @@
+import { type LitElement, type ReactiveController } from 'lit';
+/**
+ * Reactive controller that allows a host component to resolve ID references
+ * scoped to its root node, and react to changes in those references.
+ */
+declare class IdRefResolverController implements ReactiveController {
+    private readonly _host;
+    private readonly _callback;
+    private _active;
+    private _connected;
+    private _emitter;
+    constructor(host: LitElement, callback: (ids: Set<string>) => unknown);
+    private _observe;
+    private _unobserve;
+    /** @internal */
+    handleEvent(event: Event): void;
+    /** @internal */
+    hostConnected(): void;
+    /** @internal */
+    hostDisconnected(): void;
+    /** Start tracking ID reference changes in the document. */
+    observe(): void;
+    /** Stop tracking ID reference changes in the document. */
+    unobserve(): void;
+}
+/**
+ * Adds an ID reference resolver controller to the host component, allowing it to resolve ID references scoped to
+ * its root node and react to changes in those references.
+ */
+export declare function addIdRefResolver(host: LitElement, callback: (ids: Set<string>) => unknown): IdRefResolverController;
+export type { IdRefResolverController };

package/components/common/controllers/id-resolver.js

@@ -0,0 +1,136 @@
+import { isServer } from 'lit';
+import { isDocument, isElement } from '../util.js';
+const ID_REF_EMITTERS = new WeakMap();
+const ID_REF_EVENT = 'id-refs-change';
+function getEmitter(root) {
+    let emitter = ID_REF_EMITTERS.get(root);
+    if (!emitter) {
+        emitter = new IdRefChangeEmitter(root);
+        ID_REF_EMITTERS.set(root, emitter);
+    }
+    return emitter;
+}
+function refObserverCallback(mutations, emitter) {
+    const affected = new Set();
+    for (const mutation of mutations) {
+        if (mutation.type === 'attributes') {
+            if (!isElement(mutation.target))
+                continue;
+            const oldId = mutation.oldValue;
+            const newId = mutation.target.id;
+            if (oldId)
+                affected.add(oldId);
+            if (newId)
+                affected.add(newId);
+        }
+        else {
+            for (const node of mutation.addedNodes) {
+                if (!isElement(node))
+                    continue;
+                if (node.id)
+                    affected.add(node.id);
+                for (const child of node.querySelectorAll('[id]')) {
+                    if (child.id)
+                        affected.add(child.id);
+                }
+            }
+            for (const node of mutation.removedNodes) {
+                if (!isElement(node))
+                    continue;
+                if (node.id)
+                    affected.add(node.id);
+                for (const child of node.querySelectorAll('[id]')) {
+                    if (child.id)
+                        affected.add(child.id);
+                }
+            }
+        }
+    }
+    if (affected.size > 0) {
+        emitter.dispatchEvent(new CustomEvent(ID_REF_EVENT, { detail: affected }));
+    }
+}
+class IdRefChangeEmitter extends EventTarget {
+    constructor(root) {
+        super();
+        this._refCount = 0;
+        this._root = root;
+        if (!isServer) {
+            this._observer = new MutationObserver((mutations) => refObserverCallback(mutations, this));
+        }
+    }
+    retain() {
+        if (this._refCount++ === 0) {
+            const root = isDocument(this._root) ? this._root.body : this._root;
+            this._observer?.observe(root, {
+                attributeFilter: ['id'],
+                attributeOldValue: true,
+                subtree: true,
+                childList: true,
+            });
+        }
+    }
+    release() {
+        if (this._refCount > 0 && --this._refCount === 0) {
+            this._observer?.disconnect();
+        }
+    }
+}
+class IdRefResolverController {
+    constructor(host, callback) {
+        this._active = false;
+        this._connected = false;
+        this._emitter = null;
+        this._host = host;
+        this._host.addController(this);
+        this._callback = callback;
+    }
+    _observe() {
+        const root = this._host.getRootNode();
+        this._emitter = getEmitter(root);
+        this._emitter.retain();
+        this._emitter.addEventListener(ID_REF_EVENT, this);
+    }
+    _unobserve() {
+        if (this._emitter) {
+            this._emitter.removeEventListener(ID_REF_EVENT, this);
+            this._emitter.release();
+            this._emitter = null;
+        }
+    }
+    handleEvent(event) {
+        this._callback.call(this._host, event.detail);
+    }
+    hostConnected() {
+        this._connected = true;
+        if (this._active) {
+            this._observe();
+        }
+    }
+    hostDisconnected() {
+        if (this._active) {
+            this._unobserve();
+        }
+        this._connected = false;
+    }
+    observe() {
+        if (this._active)
+            return;
+        this._active = true;
+        if (this._connected) {
+            this._observe();
+        }
+    }
+    unobserve() {
+        if (!this._active)
+            return;
+        this._active = false;
+        if (this._connected) {
+            this._unobserve();
+        }
+    }
+}
+export function addIdRefResolver(host, callback) {
+    return new IdRefResolverController(host, callback);
+}
+//# sourceMappingURL=id-resolver.js.map

package/components/common/controllers/id-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-resolver.js","sourceRoot":"","sources":["../../../../src/components/common/controllers/id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer, type LitElement, type ReactiveController } from 'lit';\nimport { isDocument, isElement } from '../util.js';\n\nconst ID_REF_EMITTERS = new WeakMap<Node, IdRefChangeEmitter>();\nconst ID_REF_EVENT = 'id-refs-change';\n\nfunction getEmitter(root: Node): IdRefChangeEmitter {\n  let emitter = ID_REF_EMITTERS.get(root);\n  if (!emitter) {\n    emitter = new IdRefChangeEmitter(root);\n    ID_REF_EMITTERS.set(root, emitter);\n  }\n  return emitter;\n}\n\nfunction refObserverCallback(\n  mutations: MutationRecord[],\n  emitter: IdRefChangeEmitter\n): void {\n  const affected = new Set<string>();\n\n  for (const mutation of mutations) {\n    if (mutation.type === 'attributes') {\n      if (!isElement(mutation.target)) continue;\n      const oldId = mutation.oldValue;\n      const newId = mutation.target.id;\n      if (oldId) affected.add(oldId);\n      if (newId) affected.add(newId);\n    } else {\n      for (const node of mutation.addedNodes) {\n        if (!isElement(node)) continue;\n        if (node.id) affected.add(node.id);\n        for (const child of node.querySelectorAll('[id]')) {\n          if (child.id) affected.add(child.id);\n        }\n      }\n      for (const node of mutation.removedNodes) {\n        if (!isElement(node)) continue;\n        if (node.id) affected.add(node.id);\n        for (const child of node.querySelectorAll('[id]')) {\n          if (child.id) affected.add(child.id);\n        }\n      }\n    }\n  }\n\n  if (affected.size > 0) {\n    emitter.dispatchEvent(new CustomEvent(ID_REF_EVENT, { detail: affected }));\n  }\n}\n\n/**\n * Emits events when ID references in a root node change, allowing components to reactively update resolved references.\n * Uses a reference counting mechanism to avoid unnecessary observation when no components are using it.\n */\nclass IdRefChangeEmitter extends EventTarget {\n  private readonly _observer?: MutationObserver;\n  private readonly _root: Node;\n  private _refCount = 0;\n\n  constructor(root: Node) {\n    super();\n    this._root = root;\n\n    if (!isServer) {\n      this._observer = new MutationObserver((mutations) =>\n        refObserverCallback(mutations, this)\n      );\n    }\n  }\n\n  /**\n   * Increment the reference count. Starts the underlying MutationObserver on the first call.\n   */\n  public retain(): void {\n    if (this._refCount++ === 0) {\n      const root = isDocument(this._root) ? this._root.body : this._root;\n      this._observer?.observe(root, {\n        attributeFilter: ['id'],\n        attributeOldValue: true,\n        subtree: true,\n        childList: true,\n      });\n    }\n  }\n\n  /**\n   * Decrement the reference count. Stops the underlying MutationObserver when the count reaches zero.\n   */\n  public release(): void {\n    if (this._refCount > 0 && --this._refCount === 0) {\n      this._observer?.disconnect();\n    }\n  }\n}\n\n/**\n * Reactive controller that allows a host component to resolve ID references\n * scoped to its root node, and react to changes in those references.\n */\nclass IdRefResolverController implements ReactiveController {\n  private readonly _host: LitElement;\n  private readonly _callback: (ids: Set<string>) => unknown;\n  private _active = false;\n  private _connected = false;\n  private _emitter: IdRefChangeEmitter | null = null;\n\n  constructor(host: LitElement, callback: (ids: Set<string>) => unknown) {\n    this._host = host;\n    this._host.addController(this);\n    this._callback = callback;\n  }\n\n  private _observe(): void {\n    const root = this._host.getRootNode();\n    this._emitter = getEmitter(root);\n    this._emitter.retain();\n    this._emitter.addEventListener(ID_REF_EVENT, this);\n  }\n\n  private _unobserve(): void {\n    if (this._emitter) {\n      this._emitter.removeEventListener(ID_REF_EVENT, this);\n      this._emitter.release();\n      this._emitter = null;\n    }\n  }\n\n  /** @internal */\n  public handleEvent(event: Event): void {\n    this._callback.call(this._host, (event as CustomEvent<Set<string>>).detail);\n  }\n\n  /** @internal */\n  public hostConnected(): void {\n    this._connected = true;\n    if (this._active) {\n      this._observe();\n    }\n  }\n\n  /** @internal */\n  public hostDisconnected(): void {\n    if (this._active) {\n      this._unobserve();\n    }\n    this._connected = false;\n  }\n\n  /** Start tracking ID reference changes in the document. */\n  public observe(): void {\n    if (this._active) return;\n    this._active = true;\n    if (this._connected) {\n      this._observe();\n    }\n  }\n\n  /** Stop tracking ID reference changes in the document. */\n  public unobserve(): void {\n    if (!this._active) return;\n    this._active = false;\n    if (this._connected) {\n      this._unobserve();\n    }\n  }\n}\n\n/**\n * Adds an ID reference resolver controller to the host component, allowing it to resolve ID references scoped to\n * its root node and react to changes in those references.\n */\nexport function addIdRefResolver(\n  host: LitElement,\n  callback: (ids: Set<string>) => unknown\n): IdRefResolverController {\n  return new IdRefResolverController(host, callback);\n}\n\nexport type { IdRefResolverController };\n"]}

package/components/common/i18n/EN/calendar.resources.d.ts

@@ -1,17 +1,19 @@
+/** @deprecated since 7.2.0. Please use the newly provided ICalendarResourceStrings interface or set global resource strings using `registerI18n` method. */
 export interface IgcCalendarResourceStrings {
-    selectMonth: string;
-    selectYear: string;
-    selectDate: string;
-    selectRange: string;
-    selectedDate: string;
-    startDate: string;
-    endDate: string;
-    previousMonth: string;
-    nextMonth: string;
-    previousYear: string;
-    nextYear: string;
-    previousYears: string;
-    nextYears: string;
-    weekLabel: string;
+    selectMonth?: string;
+    selectYear?: string;
+    selectDate?: string;
+    selectRange?: string;
+    selectedDate?: string;
+    startDate?: string;
+    endDate?: string;
+    previousMonth?: string;
+    nextMonth?: string;
+    previousYear?: string;
+    nextYear?: string;
+    previousYears?: string;
+    nextYears?: string;
+    weekLabel?: string;
 }
+/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */
 export declare const IgcCalendarResourceStringEN: IgcCalendarResourceStrings;

package/components/common/i18n/EN/calendar.resources.js

@@ -1,7 +1,7 @@
 import { CalendarResourceStringsEN } from 'igniteui-i18n-core';
 import { convertToIgcResource } from '../utils.js';
 export const IgcCalendarResourceStringEN = {
-    ...convertToIgcResource(CalendarResourceStringsEN),
+    ...convertToIgcResource(CalendarResourceStringsEN, 'calendar'),
     ...{ weekLabel: 'Wk' },
 };
 //# sourceMappingURL=calendar.resources.js.map

package/components/common/i18n/EN/calendar.resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/calendar.resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAuBnD,MAAM,CAAC,MAAM,2BAA2B,GAA+B;IACrE,GAAG,oBAAoB,CAAC,yBAAyB,CAAC;IAClD,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;CACvB,CAAC","sourcesContent":["import { CalendarResourceStringsEN } from 'igniteui-i18n-core';\nimport { convertToIgcResource } from '../utils.js';\n\n/* blazorSuppress */\nexport interface IgcCalendarResourceStrings {\n  selectMonth: string;\n  selectYear: string;\n  selectDate: string;\n  selectRange: string;\n  selectedDate: string;\n  startDate: string;\n  endDate: string;\n  previousMonth: string;\n  nextMonth: string;\n  previousYear: string;\n  nextYear: string;\n  previousYears: string;\n  nextYears: string;\n  weekLabel: string;\n}\n\n// Because weekLabel should be retrieved from the i18n formatter, but previously was present in resources.\n// Manually add it for now, as part of the default EN. When updating make sure to switch in source\n// the week start to be retrieved using a formatter instead of locale.\nexport const IgcCalendarResourceStringEN: IgcCalendarResourceStrings = {\n  ...convertToIgcResource(CalendarResourceStringsEN),\n  ...{ weekLabel: 'Wk' },\n};\n"]}
+{"version":3,"file":"calendar.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/calendar.resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAyBnD,MAAM,CAAC,MAAM,2BAA2B,GAA+B;IACrE,GAAG,oBAAoB,CAAC,yBAAyB,EAAE,UAAU,CAAC;IAC9D,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE;CACvB,CAAC","sourcesContent":["import { CalendarResourceStringsEN } from 'igniteui-i18n-core';\nimport { convertToIgcResource } from '../utils.js';\n\n/* blazorSuppress */\n/** @deprecated since 7.2.0. Please use the newly provided ICalendarResourceStrings interface or set global resource strings using `registerI18n` method. */\nexport interface IgcCalendarResourceStrings {\n  selectMonth?: string;\n  selectYear?: string;\n  selectDate?: string;\n  selectRange?: string;\n  selectedDate?: string;\n  startDate?: string;\n  endDate?: string;\n  previousMonth?: string;\n  nextMonth?: string;\n  previousYear?: string;\n  nextYear?: string;\n  previousYears?: string;\n  nextYears?: string;\n  weekLabel?: string;\n}\n\n// Because weekLabel should be retrieved from the i18n formatter, but previously was present in resources.\n// Manually add it for now, as part of the default EN. When updating make sure to switch in source\n// the week start to be retrieved using a formatter instead of locale.\n/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */\nexport const IgcCalendarResourceStringEN: IgcCalendarResourceStrings = {\n  ...convertToIgcResource(CalendarResourceStringsEN, 'calendar'),\n  ...{ weekLabel: 'Wk' },\n};\n"]}

package/components/common/i18n/EN/chat.resources.d.ts

@@ -1,11 +1,13 @@
+/** @deprecated since 7.2.0. Please use the newly provided `IChatResourceStrings` interfaces from or set global resource strings using `registerI18n` method. */
 export interface IgcChatResourceStrings {
-    suggestionsHeader: string;
-    reactionCopy: string;
-    reactionLike: string;
-    reactionDislike: string;
-    reactionRegenerate: string;
-    attachmentLabel: string;
-    attachmentsListLabel: string;
-    messageCopied: string;
+    suggestionsHeader?: string;
+    reactionCopy?: string;
+    reactionLike?: string;
+    reactionDislike?: string;
+    reactionRegenerate?: string;
+    attachmentLabel?: string;
+    attachmentsListLabel?: string;
+    messageCopied?: string;
 }
+/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */
 export declare const IgcChatResourceStringEN: IgcChatResourceStrings;

package/components/common/i18n/EN/chat.resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/chat.resources.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,iBAAiB,EAAE,aAAa;IAChC,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,SAAS;IAC1B,kBAAkB,EAAE,YAAY;IAChC,eAAe,EAAE,YAAY;IAC7B,oBAAoB,EAAE,aAAa;IACnC,aAAa,EAAE,6BAA6B;CAC7C,CAAC","sourcesContent":["/* blazorSuppress */\nexport interface IgcChatResourceStrings {\n  suggestionsHeader: string;\n  reactionCopy: string;\n  reactionLike: string;\n  reactionDislike: string;\n  reactionRegenerate: string;\n  attachmentLabel: string;\n  attachmentsListLabel: string;\n  messageCopied: string;\n}\n\nexport const IgcChatResourceStringEN: IgcChatResourceStrings = {\n  suggestionsHeader: 'Suggestions',\n  reactionCopy: 'Copy',\n  reactionLike: 'Like',\n  reactionDislike: 'Dislike',\n  reactionRegenerate: 'Regenerate',\n  attachmentLabel: 'Attachment',\n  attachmentsListLabel: 'Attachments',\n  messageCopied: 'Message copied to clipboard',\n};\n"]}
+{"version":3,"file":"chat.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/chat.resources.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,iBAAiB,EAAE,aAAa;IAChC,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,SAAS;IAC1B,kBAAkB,EAAE,YAAY;IAChC,eAAe,EAAE,YAAY;IAC7B,oBAAoB,EAAE,aAAa;IACnC,aAAa,EAAE,6BAA6B;CAC7C,CAAC","sourcesContent":["/* blazorSuppress */\n/** @deprecated since 7.2.0. Please use the newly provided `IChatResourceStrings` interfaces from or set global resource strings using `registerI18n` method. */\nexport interface IgcChatResourceStrings {\n  suggestionsHeader?: string;\n  reactionCopy?: string;\n  reactionLike?: string;\n  reactionDislike?: string;\n  reactionRegenerate?: string;\n  attachmentLabel?: string;\n  attachmentsListLabel?: string;\n  messageCopied?: string;\n}\n\n/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */\nexport const IgcChatResourceStringEN: IgcChatResourceStrings = {\n  suggestionsHeader: 'Suggestions',\n  reactionCopy: 'Copy',\n  reactionLike: 'Like',\n  reactionDislike: 'Dislike',\n  reactionRegenerate: 'Regenerate',\n  attachmentLabel: 'Attachment',\n  attachmentsListLabel: 'Attachments',\n  messageCopied: 'Message copied to clipboard',\n};\n"]}

package/components/common/i18n/EN/date-picker.resources.d.ts

@@ -0,0 +1,8 @@
+import { type IgcCalendarResourceStrings } from './calendar.resources.js';
+/** @deprecated since 7.2.0. Please use the newly provided `IDatePickerResourceStrings` and `ICalendarResourceStrings` interfaces or set global resource strings using `registerI18n` method. */
+export interface IgcDatePickerResourceStrings extends IgcCalendarResourceStrings {
+    changeDate: string;
+    chooseDate: string;
+}
+/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */
+export declare const IgcDatePickerResourceStringsEN: IgcDatePickerResourceStrings;

package/components/common/i18n/EN/date-picker.resources.js

@@ -0,0 +1,8 @@
+import { DatePickerResourceStringsEN } from 'igniteui-i18n-core';
+import { convertToIgcResource } from '../utils.js';
+import { IgcCalendarResourceStringEN, } from './calendar.resources.js';
+export const IgcDatePickerResourceStringsEN = {
+    ...convertToIgcResource(DatePickerResourceStringsEN, 'date-picker'),
+    ...IgcCalendarResourceStringEN,
+};
+//# sourceMappingURL=date-picker.resources.js.map

package/components/common/i18n/EN/date-picker.resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/date-picker.resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,2BAA2B,GAE5B,MAAM,yBAAyB,CAAC;AAUjC,MAAM,CAAC,MAAM,8BAA8B,GAAiC;IAC1E,GAAG,oBAAoB,CAAC,2BAA2B,EAAE,aAAa,CAAC;IACnE,GAAG,2BAA2B;CAC/B,CAAC","sourcesContent":["import { DatePickerResourceStringsEN } from 'igniteui-i18n-core';\nimport { convertToIgcResource } from '../utils.js';\nimport {\n  IgcCalendarResourceStringEN,\n  type IgcCalendarResourceStrings,\n} from './calendar.resources.js';\n\n/* blazorSuppress */\n/** @deprecated since 7.2.0. Please use the newly provided `IDatePickerResourceStrings` and `ICalendarResourceStrings` interfaces or set global resource strings using `registerI18n` method. */\nexport interface IgcDatePickerResourceStrings extends IgcCalendarResourceStrings {\n  changeDate: string;\n  chooseDate: string;\n}\n\n/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */\nexport const IgcDatePickerResourceStringsEN: IgcDatePickerResourceStrings = {\n  ...convertToIgcResource(DatePickerResourceStringsEN, 'date-picker'),\n  ...IgcCalendarResourceStringEN,\n};\n"]}

package/components/common/i18n/EN/date-range-picker.resources.d.ts

@@ -1,11 +1,13 @@
 import { type IgcCalendarResourceStrings } from './calendar.resources.js';
+/** @deprecated since 7.2.0. Please use the newly provided `ICalendarResourceStrings` and `IDateRangePickerResourceStrings` interfaces or set global resource strings using `registerI18n` method. */
 export interface IgcDateRangePickerResourceStrings extends IgcCalendarResourceStrings {
-    separator: string;
-    done: string;
-    cancel: string;
-    last7Days: string;
-    last30Days: string;
-    currentMonth: string;
-    yearToDate: string;
+    separator?: string;
+    done?: string;
+    cancel?: string;
+    last7Days?: string;
+    last30Days?: string;
+    currentMonth?: string;
+    yearToDate?: string;
 }
+/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */
 export declare const IgcDateRangePickerResourceStringsEN: IgcDateRangePickerResourceStrings;

package/components/common/i18n/EN/date-range-picker.resources.js

@@ -2,7 +2,7 @@ import { DateRangePickerResourceStringsEN } from 'igniteui-i18n-core';
 import { convertToIgcResource } from '../utils.js';
 import { IgcCalendarResourceStringEN, } from './calendar.resources.js';
 export const IgcDateRangePickerResourceStringsEN = {
-    ...convertToIgcResource(DateRangePickerResourceStringsEN),
+    ...convertToIgcResource(DateRangePickerResourceStringsEN, 'date-range-picker'),
     ...IgcCalendarResourceStringEN,
 };
 //# sourceMappingURL=date-range-picker.resources.js.map

package/components/common/i18n/EN/date-range-picker.resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"date-range-picker.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/date-range-picker.resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,2BAA2B,GAE5B,MAAM,yBAAyB,CAAC;AAajC,MAAM,CAAC,MAAM,mCAAmC,GAC9C;IACE,GAAG,oBAAoB,CAAC,gCAAgC,CAAC;IACzD,GAAG,2BAA2B;CAC/B,CAAC","sourcesContent":["import { DateRangePickerResourceStringsEN } from 'igniteui-i18n-core';\nimport { convertToIgcResource } from '../utils.js';\nimport {\n  IgcCalendarResourceStringEN,\n  type IgcCalendarResourceStrings,\n} from './calendar.resources.js';\n\n/* blazorSuppress */\nexport interface IgcDateRangePickerResourceStrings extends IgcCalendarResourceStrings {\n  separator: string;\n  done: string;\n  cancel: string;\n  last7Days: string;\n  last30Days: string;\n  currentMonth: string;\n  yearToDate: string;\n}\n\nexport const IgcDateRangePickerResourceStringsEN: IgcDateRangePickerResourceStrings =\n  {\n    ...convertToIgcResource(DateRangePickerResourceStringsEN),\n    ...IgcCalendarResourceStringEN,\n  };\n"]}
+{"version":3,"file":"date-range-picker.resources.js","sourceRoot":"","sources":["../../../../../src/components/common/i18n/EN/date-range-picker.resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,2BAA2B,GAE5B,MAAM,yBAAyB,CAAC;AAejC,MAAM,CAAC,MAAM,mCAAmC,GAC9C;IACE,GAAG,oBAAoB,CACrB,gCAAgC,EAChC,mBAAmB,CACpB;IACD,GAAG,2BAA2B;CAC/B,CAAC","sourcesContent":["import { DateRangePickerResourceStringsEN } from 'igniteui-i18n-core';\nimport { convertToIgcResource } from '../utils.js';\nimport {\n  IgcCalendarResourceStringEN,\n  type IgcCalendarResourceStrings,\n} from './calendar.resources.js';\n\n/* blazorSuppress */\n/** @deprecated since 7.2.0. Please use the newly provided `ICalendarResourceStrings` and `IDateRangePickerResourceStrings` interfaces or set global resource strings using `registerI18n` method. */\nexport interface IgcDateRangePickerResourceStrings extends IgcCalendarResourceStrings {\n  separator?: string;\n  done?: string;\n  cancel?: string;\n  last7Days?: string;\n  last30Days?: string;\n  currentMonth?: string;\n  yearToDate?: string;\n}\n\n/** @deprecated since 7.2.0. Please use the newly provided resources from the igniteui-i18n-resources package. */\nexport const IgcDateRangePickerResourceStringsEN: IgcDateRangePickerResourceStrings =\n  {\n    ...convertToIgcResource(\n      DateRangePickerResourceStringsEN,\n      'date-range-picker'\n    ),\n    ...IgcCalendarResourceStringEN,\n  };\n"]}

package/components/common/i18n/i18n-controller.d.ts

@@ -1,5 +1,6 @@
 import { type IResourceChangeEventArgs } from 'igniteui-i18n-core';
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type I18nResourceMapNames } from './utils.js';
 /**
  * Defines the structure for the host element that will use this controller.
  * The host must be a Lit element (ReactiveControllerHost) and an HTMLElement.
@@ -11,8 +12,10 @@ interface I18nControllerHost extends ReactiveControllerHost, HTMLElement {
 type ResourceChangeCallback = (event: CustomEvent<IResourceChangeEventArgs>) => unknown;
 /** Configuration object for the I18nController. */
 type I18nControllerConfig<T extends object> = {
-    /** The full default English resource strings object for the component. */
+    /** The full default English resource strings object for the component. Should always come from igniteui-i18n-core. */
     defaultEN: T;
+    /** @deprecated since 7.2.0. Optional name if component uses mixed resource strings. To be removed with deprecated resources. */
+    resourceMapName?: I18nResourceMapNames;
     /** An optional callback to execute when the global locale changes. */
     onResourceChange?: ResourceChangeCallback;
 };
@@ -24,9 +27,15 @@ type I18nControllerConfig<T extends object> = {
 declare class I18nController<T extends object> implements ReactiveController {
     private readonly _host;
     private readonly _defaultEN;
-    private _resourceChangeCallback?;
-    private _defaultResourceStrings;
+    /** @deprecated since 7.2.0. Resource name to use when converting new to old and vice versa resource objects. */
+    private readonly _resourceMapName?;
+    private readonly _resourceChangeCallback?;
     private _locale?;
+    /** Cache of default resource strings coming from i18n Manager. */
+    private _defaultResourceStrings;
+    /** Collection containing only custom resource strings provided. Allows for partial override of resource strings. */
+    private _customResourceStrings?;
+    /** Merged collection of custom resource strings and default resource strings. */
     private _resourceStrings?;
     /**
      * Sets a custom locale that overrides the global one for this host component instance.
@@ -53,13 +62,6 @@ declare class I18nController<T extends object> implements ReactiveController {
     hostDisconnected(): void;
     /** @internal */
     handleEvent(event: CustomEvent<IResourceChangeEventArgs>): void;
-    /** Registers the default English resources with the global i18n manager. */
-    private _registerResources;
-    /**
-     * Helper to find the correct resource map based on the component's default resources (`#defaultEN`).
-     * This relies on structural checking (the component's key names).
-     */
-    private _getResourceMapForComponent;
     /**
      * Gets the current, locale-specific resource strings for the component.
      * The logic maps component keys (from defaultEN) to core library keys
@@ -67,7 +69,8 @@ declare class I18nController<T extends object> implements ReactiveController {
      *
      * Result is truncated, containing only relevant locale strings.
      */
-    private _getCurrentResourceStrings;
+    private _getDefaultResourceStrings;
+    private getMixedResourceStrings;
 }
 /** Returns the default date-time input format for a given locale */
 export declare function getDefaultDateTimeFormat(locale: string): string;