@acorex/components 22.1.0-next.31 → 22.1.0-next.32

package/types/acorex-components-lookup.d.ts

@@ -3,7 +3,7 @@ import { TemplateRef, ElementRef } from '@angular/core';
 import { AXEvent, AXDataSource, AXListDataSource, AXHtmlEvent, NXValueComponent, AXStyleLookType, AXValueChangedEvent, AXFocusEvent, AXItemClickEvent, AXItemSelectedEvent } from '@acorex/cdk/common';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import { AXSearchBoxComponent } from '@acorex/components/search-box';
-import { AXTreeViewDataSource, AXTreeViewItemTemplateContext, AXTreeViewSelectionChangeEvent, AXTreeViewSelectionBehavior, AXTreeViewNode } from '@acorex/components/tree-view';
+import { AXTreeViewNode, AXTreeViewDataSource, AXTreeViewSelectionBehavior, AXTreeViewItemTemplateContext, AXTreeViewSelectionChangeEvent } from '@acorex/components/tree-view';
 import { FormValueControl } from '@angular/forms/signals';
 import { AXListNavigationDirective, AXListNavigationItemDirective } from '@acorex/cdk/list-navigation';
 import { CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
@@ -52,71 +52,11 @@ interface AXLookupItemClickEvent {
 /**
  * Emitted by `ax-lookup` when the selection changes, carrying the resolved selected items.
  */
-interface AXLookupSelectionChangedEvent extends AXEvent {
-    items: AXLookupItem[];
+interface AXLookupSelectionChangedEvent<TItem = any> extends AXEvent {
+    items: TItem[];
     value: unknown | unknown[] | null;
 }
 
-/**
- * Internal mini component for the `drop-down-tree` lookup mode:
- * a predefined list rendered in a tree-like structure for single item selection.
- *
- * @category Components
- */
-declare class AXLookupDropDownTreeComponent {
-    /**
-     * The tree datasource: an array of nodes or a lazy children callback.
-     */
-    dataSource: _angular_core.InputSignal<AXTreeViewDataSource>;
-    /**
-     * The node property used as the selection value (tree `idField`).
-     */
-    valueField: _angular_core.InputSignal<string>;
-    /**
-     * The node property used as the display text (tree `titleField`).
-     */
-    textField: _angular_core.InputSignal<string>;
-    /**
-     * The node property marking a node as disabled.
-     */
-    disabledField: _angular_core.InputSignal<string>;
-    /**
-     * Currently selected values (at most one for single selection).
-     */
-    selectedValues: _angular_core.InputSignal<unknown[]>;
-    /**
-     * Custom template rendered for each tree node.
-     */
-    nodeTemplate: _angular_core.InputSignal<TemplateRef<AXTreeViewItemTemplateContext>>;
-    /**
-     * Custom template rendered when the filtered tree has no nodes.
-     */
-    emptyTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
-    /**
-     * When `true`, visible tree nodes use alternating background colors.
-     */
-    alternate: _angular_core.InputSignal<boolean>;
-    /**
-     * Unique id that changes on every search apply so a new tree instance is created.
-     */
-    filterKey: _angular_core.InputSignal<string>;
-    /**
-     * Emitted when the user selects a node.
-     */
-    itemClick: _angular_core.OutputEmitterRef<AXLookupItemClickEvent>;
-    protected selectedIds: _angular_core.Signal<string[]>;
-    protected isEmpty: _angular_core.Signal<boolean>;
-    protected treeInstances: _angular_core.Signal<{
-        id: string;
-        source: AXTreeViewDataSource;
-    }[]>;
-    /** Whether the filtered tree currently has no nodes. */
-    hasNoMatches(): boolean;
-    protected handleSelectionChange(e: AXTreeViewSelectionChangeEvent): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupDropDownTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupDropDownTreeComponent, "ax-lookup-drop-down-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "filterKey": { "alias": "filterKey"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
-}
-
 /**
  * Shared `AXDataSource` + CDK virtual scroll plumbing for the list-based lookup views
  * (`ax-lookup-drop-down-list`, `ax-lookup-multi-select`).
@@ -152,7 +92,8 @@ declare abstract class AXLookupListViewBase {
      */
     maxVisibleItems: _angular_core.InputSignal<number>;
     /**
-     * Custom template rendered for each item. Context: `$implicit` is the item.
+     * Custom template rendered for each item. Context: `$implicit` is the item;
+     * `highlightText` is the active search query when result highlighting is enabled.
      * Default option chrome is not applied on top of the template.
      */
     itemTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
@@ -168,6 +109,10 @@ declare abstract class AXLookupListViewBase {
      * When `true`, list rows use alternating background colors for easier scanning.
      */
     alternate: _angular_core.InputSignal<boolean>;
+    /**
+     * When set, matching characters in the default option label are highlighted.
+     */
+    highlightText: _angular_core.InputSignal<string>;
     /**
      * Emitted when the user picks (or toggles) an item.
      */
@@ -192,7 +137,7 @@ declare abstract class AXLookupListViewBase {
     protected listNavigation: _angular_core.Signal<AXListNavigationDirective>;
     protected navItems: _angular_core.Signal<readonly AXListNavigationItemDirective[]>;
     constructor();
-    /** Moves keyboard focus to the first rendered list option. */
+    /** Moves keyboard focus to the selected list option, or the first option when none is selected. */
     focusFirst(): void;
     protected getValue(item: AXLookupItem): unknown;
     protected getText(item: AXLookupItem): string;
@@ -209,7 +154,7 @@ declare abstract class AXLookupListViewBase {
     protected activateNavItem(nav: AXListNavigationDirective, item: AXListNavigationItemDirective): void;
     protected trackByIndex: (index: number) => number;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupListViewBase, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXLookupListViewBase, never, never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; "navigateOut": "navigateOut"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXLookupListViewBase, never, never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; "navigateOut": "navigateOut"; }, never, never, true, never>;
 }
 
 /**
@@ -226,6 +171,8 @@ interface AXLookupTreeSelectionEvent {
  * @category Components
  */
 declare class AXLookupMultiSelectTreeComponent {
+    #private;
+    constructor();
     /**
      * The tree datasource: an array of nodes or a lazy children callback.
      */
@@ -258,6 +205,14 @@ declare class AXLookupMultiSelectTreeComponent {
      * Custom template rendered when the filtered tree has no nodes.
      */
     emptyTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * Custom template rendered while the tree is hydrating for search.
+     */
+    loadingTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * When `true`, a loading placeholder is shown while lazy tree data is hydrated for search.
+     */
+    loading: _angular_core.InputSignal<boolean>;
     /**
      * When `true`, visible tree nodes use alternating background colors.
      */
@@ -266,6 +221,10 @@ declare class AXLookupMultiSelectTreeComponent {
      * Unique id that changes on every search apply so a new tree instance is created.
      */
     filterKey: _angular_core.InputSignal<string>;
+    /**
+     * When set, matching characters in the default node label are highlighted.
+     */
+    highlightText: _angular_core.InputSignal<string>;
     /**
      * Emitted when the user changes the tree selection.
      */
@@ -280,7 +239,7 @@ declare class AXLookupMultiSelectTreeComponent {
     hasNoMatches(): boolean;
     protected handleSelectionChange(e: AXTreeViewSelectionChangeEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupMultiSelectTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiSelectTreeComponent, "ax-lookup-multi-select-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "selectionBehavior": { "alias": "selectionBehavior"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "filterKey": { "alias": "filterKey"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiSelectTreeComponent, "ax-lookup-multi-select-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "selectionBehavior": { "alias": "selectionBehavior"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "filterKey": { "alias": "filterKey"; "required": false; "isSignal": true; }; "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 
 /**
@@ -289,6 +248,8 @@ declare class AXLookupMultiSelectTreeComponent {
  * Modes (each rendered by its own internal mini component):
  * - `drop-down-list` — a predefined list of options for picking single values.
  * - `multi-select` — a predefined list of options for multiple item selection (chips in the trigger).
+ *   In multi modes, Backspace with an empty trigger input removes the last chip; repeated presses clear
+ *   the whole selection.
  * - `drop-down-tree` — a tree-like structure for single item selection; when searchable, the trigger
  *   input filters nested nodes as you type (on small screens the search field is inside the actionsheet).
  * - `multi-select-tree` — a tree-like structure for multiple item selection; searchable the same way.
@@ -305,7 +266,7 @@ declare class AXLookupMultiSelectTreeComponent {
  *
  * @category Components
  */
-declare class AXLookupComponent extends NXValueComponent implements FormValueControl<unknown | unknown[] | null> {
+declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent implements FormValueControl<unknown | unknown[] | null> {
     #private;
     /**
      * The name of the form field, used by validation rules and `ax-form.validate(names)`.
@@ -320,7 +281,7 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      * and for `multi-column-tree` when `treeDataSource` is not set.
      * Accepts an `AXDataSource` (remote paging, `byKey`, server-side filter) or a plain array.
      */
-    dataSource: _angular_core.InputSignal<AXLookupItem[] | AXDataSource<AXLookupItem>>;
+    dataSource: _angular_core.InputSignal<AXDataSource<T> | T[]>;
     /**
      * The nodes source for tree modes (`drop-down-tree`, `multi-select-tree`, `multi-column-tree`):
      * an array of nodes or a lazy children callback.
@@ -359,6 +320,7 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      * Whether the trigger accepts typing and filters the datasource (`true`),
      * or is select-only with no writable input (`false`).
      * Applies to all modes, including `drop-down-tree` and `multi-select-tree`.
+     * Lazy callback trees are hydrated once per popup open and searched in full.
      * On small screens with `adaptivityEnabled`, search is typed in the actionsheet instead of the trigger.
      */
     searchable: _angular_core.InputSignal<boolean>;
@@ -370,6 +332,7 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
     adaptivityEnabled: _angular_core.InputSignal<boolean>;
     /**
      * Title shown in the actionsheet header on small screens. Falls back to `placeholder`.
+     * Supports i18n expressions (e.g. `@acorex:selectbox.popover.title`).
      */
     caption: _angular_core.InputSignal<string>;
     /**
@@ -381,12 +344,18 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      * Placeholder for the trigger search input when items are already selected
      * (mainly useful in `multi-select` / `multi-select-tree`), and for the in-sheet search field on small screens.
      * Falls back to `placeholder` when the selection is empty on desktop.
+     * Supports i18n expressions (e.g. `@acorex:common.actions.search`).
      */
     searchPlaceholder: _angular_core.InputSignal<string>;
     /**
      * The placeholder text shown when no value is selected.
+     * Supports i18n expressions (e.g. `@acorex:chat.placeholders.select-conversation`).
      */
     placeholder: _angular_core.InputSignal<string>;
+    /** Resolved `placeholder` (i18n-aware). */
+    protected translatedPlaceholder: _angular_core.Signal<string>;
+    /** Resolved `searchPlaceholder` (i18n-aware). */
+    protected translatedSearchPlaceholder: _angular_core.Signal<string>;
     /**
      * Whether the lookup is disabled.
      */
@@ -412,7 +381,13 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      */
     treeSelectionBehavior: _angular_core.InputSignal<AXTreeViewSelectionBehavior>;
     /**
-     * Custom template rendered for each item/node. Context: `$implicit` is the item.
+     * When `true` (default), matching characters in popup result items are highlighted
+     * while the user searches.
+     */
+    highlightSearch: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Custom template rendered for each item/node. Context: `$implicit` is the item;
+     * `highlightText` is the active search query when result highlighting is enabled.
      * Default option chrome (padding, typography, check icon) is not applied; only the
      * template's styles are used. Selection and hover backgrounds remain on the row.
      */
@@ -440,15 +415,15 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      * Use when the parent already has the selected entity (e.g. edit forms). Seeds the internal
      * item cache; missing keys still fall through to `find` / `byKey`.
      */
-    valueItems: _angular_core.InputSignal<AXLookupItem[]>;
+    valueItems: _angular_core.InputSignal<T[]>;
     /**
      * Emitted when the selected value changes.
      */
-    onValueChanged: _angular_core.OutputEmitterRef<AXValueChangedEvent<unknown>>;
+    onValueChanged: _angular_core.OutputEmitterRef<AXValueChangedEvent<any>>;
     /**
      * Emitted when the selection changes, carrying the resolved selected items.
      */
-    onSelectionChanged: _angular_core.OutputEmitterRef<AXLookupSelectionChangedEvent>;
+    onSelectionChanged: _angular_core.OutputEmitterRef<AXLookupSelectionChangedEvent<T>>;
     /**
      * Emitted when the trigger receives focus.
      */
@@ -489,8 +464,11 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
     protected isSheetSearchEnabled: _angular_core.Signal<boolean>;
     /** Query typed in the actionsheet search field (independent of the trigger display text). */
     protected sheetSearchText: _angular_core.WritableSignal<string>;
+    protected treeSearchLoading: _angular_core.WritableSignal<boolean>;
     /** Increments on every tree filter apply so the tree view remounts with a new instance. */
     protected treeFilterKey: _angular_core.Signal<string>;
+    /** Query passed to result-item highlighting (empty when disabled). */
+    protected highlightQuery: _angular_core.Signal<string>;
     /** The datasource for list-based modes; plain arrays are converted. */
     protected resolvedDataSource: _angular_core.Signal<AXDataSource<AXLookupItem>>;
     protected resolvedTreeDataSource: _angular_core.Signal<AXTreeViewDataSource>;
@@ -500,6 +478,12 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
     protected selectedItems: _angular_core.WritableSignal<AXLookupItem[]>;
     /** Display text shown in the trigger for single modes. */
     protected displayText: _angular_core.Signal<string>;
+    /** Resolved display text for the trigger input (i18n-aware). */
+    protected translatedDisplayText: _angular_core.Signal<string>;
+    /** Actionsheet header title with i18n fallback chain. */
+    protected actionsheetTitleSource: _angular_core.Signal<string>;
+    /** Resolved actionsheet title (i18n-aware). */
+    protected actionsheetTitle: _angular_core.Signal<string>;
     /**
      * Text typed in the editable trigger input.
      * Multi-select starts empty; single modes sync from the selected display text.
@@ -518,8 +502,6 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
     protected popupRef: _angular_core.Signal<ElementRef<HTMLElement>>;
     protected triggerSearchInput: _angular_core.Signal<ElementRef<HTMLInputElement>>;
     protected listView: _angular_core.Signal<AXLookupListViewBase>;
-    protected dropDownTreeView: _angular_core.Signal<AXLookupDropDownTreeComponent>;
-    protected multiSelectTreeView: _angular_core.Signal<AXLookupMultiSelectTreeComponent>;
     protected sheetSearchRef: _angular_core.Signal<AXSearchBoxComponent>;
     constructor();
     /** Returns the display text of an item using the `textField` mapping. */
@@ -530,12 +512,18 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      * Opens (editable trigger) or toggles the popup on trigger click.
      */
     protected onTriggerClick(): void;
+    /**
+     * Toggles the popup when the chevron button is clicked.
+     */
+    protected onChevronClick(event: Event): void;
     /**
      * Focuses the lookup trigger input.
      */
     focus(options?: FocusOptions): void;
     /**
      * Handles keyboard interaction on the trigger input.
+     * In multi modes, Backspace with an empty trigger input removes the last chip; repeated presses
+     * clear the whole selection.
      */
     protected onTriggerKeydown(e: KeyboardEvent): void;
     /** Filters the datasource from the actionsheet search field and handles Enter with no matches. */
@@ -597,7 +585,7 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      *
      * @param items - Full items that include `valueField` (and ideally `textField`) properties.
      */
-    seedItems(items: AXLookupItem[]): void;
+    seedItems(items: T[]): void;
     /**
      * Clears the whole selection.
      * Sets `null` in single modes and `[]` in multi modes. Used by projected `ax-clear-button`.
@@ -605,8 +593,8 @@ declare class AXLookupComponent extends NXValueComponent implements FormValueCon
      * @param isUserInteraction - Whether the clear was triggered by the user.
      */
     reset(isUserInteraction?: boolean): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupComponent, "ax-lookup", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "treeDataSource": { "alias": "treeDataSource"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "treeParentField": { "alias": "treeParentField"; "required": false; "isSignal": true; }; "hasChildrenField": { "alias": "hasChildrenField"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "adaptivityEnabled": { "alias": "adaptivityEnabled"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "treeSelectionBehavior": { "alias": "treeSelectionBehavior"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "selectedTemplate": { "alias": "selectedTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueItems": { "alias": "valueItems"; "required": false; "isSignal": true; }; }, { "look": "lookChange"; "value": "valueChange"; "onValueChanged": "onValueChanged"; "onSelectionChanged": "onSelectionChanged"; "onFocus": "onFocus"; "onBlur": "onBlur"; "onItemClick": "onItemClick"; "onItemSelected": "onItemSelected"; "onOpened": "onOpened"; "onClosed": "onClosed"; }, never, ["ax-prefix", "ax-clear-button", "ax-suffix", "ax-header", "ax-footer", "ax-validation-rule"], true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupComponent<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupComponent<any>, "ax-lookup", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "treeDataSource": { "alias": "treeDataSource"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "treeParentField": { "alias": "treeParentField"; "required": false; "isSignal": true; }; "hasChildrenField": { "alias": "hasChildrenField"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "adaptivityEnabled": { "alias": "adaptivityEnabled"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "treeSelectionBehavior": { "alias": "treeSelectionBehavior"; "required": false; "isSignal": true; }; "highlightSearch": { "alias": "highlightSearch"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "selectedTemplate": { "alias": "selectedTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueItems": { "alias": "valueItems"; "required": false; "isSignal": true; }; }, { "look": "lookChange"; "value": "valueChange"; "onValueChanged": "onValueChanged"; "onSelectionChanged": "onSelectionChanged"; "onFocus": "onFocus"; "onBlur": "onBlur"; "onItemClick": "onItemClick"; "onItemSelected": "onItemSelected"; "onOpened": "onOpened"; "onClosed": "onClosed"; }, never, ["ax-prefix", "ax-clear-button", "ax-suffix", "ax-header", "ax-footer", "ax-validation-rule"], true, never>;
 }
 
 /**
@@ -631,6 +619,80 @@ declare class AXLookupMultiSelectComponent extends AXLookupListViewBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiSelectComponent, "ax-lookup-multi-select", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Internal mini component for the `drop-down-tree` lookup mode:
+ * a predefined list rendered in a tree-like structure for single item selection.
+ *
+ * @category Components
+ */
+declare class AXLookupDropDownTreeComponent {
+    #private;
+    constructor();
+    /**
+     * The tree datasource: an array of nodes or a lazy children callback.
+     */
+    dataSource: _angular_core.InputSignal<AXTreeViewDataSource>;
+    /**
+     * The node property used as the selection value (tree `idField`).
+     */
+    valueField: _angular_core.InputSignal<string>;
+    /**
+     * The node property used as the display text (tree `titleField`).
+     */
+    textField: _angular_core.InputSignal<string>;
+    /**
+     * The node property marking a node as disabled.
+     */
+    disabledField: _angular_core.InputSignal<string>;
+    /**
+     * Currently selected values (at most one for single selection).
+     */
+    selectedValues: _angular_core.InputSignal<unknown[]>;
+    /**
+     * Custom template rendered for each tree node.
+     */
+    nodeTemplate: _angular_core.InputSignal<TemplateRef<AXTreeViewItemTemplateContext>>;
+    /**
+     * Custom template rendered when the filtered tree has no nodes.
+     */
+    emptyTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * Custom template rendered while the tree is hydrating for search.
+     */
+    loadingTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * When `true`, a loading placeholder is shown while lazy tree data is hydrated for search.
+     */
+    loading: _angular_core.InputSignal<boolean>;
+    /**
+     * When `true`, visible tree nodes use alternating background colors.
+     */
+    alternate: _angular_core.InputSignal<boolean>;
+    /**
+     * Unique id that changes on every search apply so a new tree instance is created.
+     */
+    filterKey: _angular_core.InputSignal<string>;
+    /**
+     * When set, matching characters in the default node label are highlighted.
+     */
+    highlightText: _angular_core.InputSignal<string>;
+    /**
+     * Emitted when the user selects a node.
+     */
+    itemClick: _angular_core.OutputEmitterRef<AXLookupItemClickEvent>;
+    protected selectedIds: _angular_core.Signal<string[]>;
+    protected isEmpty: _angular_core.Signal<boolean>;
+    protected treeInstances: _angular_core.Signal<{
+        id: string;
+        source: AXTreeViewDataSource;
+    }[]>;
+    /** Whether the filtered tree currently has no nodes. */
+    hasNoMatches(): boolean;
+    protected handleSelectionChange(e: AXTreeViewSelectionChangeEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupDropDownTreeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupDropDownTreeComponent, "ax-lookup-drop-down-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "filterKey": { "alias": "filterKey"; "required": false; "isSignal": true; }; "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
+}
+
 /**
  * Internal mini component for the `multi-column` lookup mode:
  * renders selectable rows in an `ax-data-table` grid and loads further
@@ -690,6 +752,10 @@ declare class AXLookupMultiColumnComponent {
      * When `true`, table rows use alternating background colors for easier scanning.
      */
     alternate: _angular_core.InputSignal<boolean>;
+    /**
+     * When set, matching text in table cells is highlighted.
+     */
+    highlightText: _angular_core.InputSignal<string>;
     /**
      * Emitted when the user picks a row.
      */
@@ -724,7 +790,7 @@ declare class AXLookupMultiColumnComponent {
     protected isDisabled(item: AXLookupItem): boolean;
     private getValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupMultiColumnComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiColumnComponent, "ax-lookup-multi-column", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiColumnComponent, "ax-lookup-multi-column", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
 
 /**
@@ -735,6 +801,8 @@ declare class AXLookupMultiColumnComponent {
  * @category Components
  */
 declare class AXLookupMultiColumnTreeComponent {
+    #private;
+    constructor();
     /**
      * The datasource providing hierarchical rows (roots on load, children via `parentField`).
      */
@@ -793,6 +861,10 @@ declare class AXLookupMultiColumnTreeComponent {
      * When `true`, table rows use alternating background colors for easier scanning.
      */
     alternate: _angular_core.InputSignal<boolean>;
+    /**
+     * When set, matching text in table cells is highlighted.
+     */
+    highlightText: _angular_core.InputSignal<string>;
     /**
      * Emitted when the user picks a row (not when expanding/collapsing).
      */
@@ -818,7 +890,7 @@ declare class AXLookupMultiColumnTreeComponent {
     protected isDisabled(item: AXLookupItem): boolean;
     private getValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupMultiColumnTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiColumnTreeComponent, "ax-lookup-multi-column-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "parentField": { "alias": "parentField"; "required": false; "isSignal": true; }; "hasChildrenField": { "alias": "hasChildrenField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupMultiColumnTreeComponent, "ax-lookup-multi-column-tree", never, { "dataSource": { "alias": "dataSource"; "required": true; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "parentField": { "alias": "parentField"; "required": false; "isSignal": true; }; "hasChildrenField": { "alias": "hasChildrenField"; "required": false; "isSignal": true; }; "selectedValues": { "alias": "selectedValues"; "required": false; "isSignal": true; }; "itemHeight": { "alias": "itemHeight"; "required": false; "isSignal": true; }; "maxVisibleItems": { "alias": "maxVisibleItems"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; "isSignal": true; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
 
 declare class AXLookupModule {
@@ -827,5 +899,64 @@ declare class AXLookupModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXLookupModule>;
 }
 
-export { AXLookupComponent, AXLookupDropDownListComponent, AXLookupDropDownTreeComponent, AXLookupModule, AXLookupMultiColumnComponent, AXLookupMultiColumnTreeComponent, AXLookupMultiSelectComponent, AXLookupMultiSelectTreeComponent };
-export type { AXLookupColumn, AXLookupItem, AXLookupItemClickEvent, AXLookupMode, AXLookupSelectionChangedEvent, AXLookupTreeSelectionEvent };
+/** Whether a tree node may have descendants (embedded children or lazy metadata). */
+declare function lookupTreeNodeMayHaveChildren(node: AXTreeViewNode): boolean;
+interface HydrateLookupTreeOptions {
+    valueField: string;
+    maxConcurrent?: number;
+    maxNodes?: number;
+    isCancelled?: () => boolean;
+}
+/**
+ * Loads a lazy tree into a nested in-memory snapshot using bounded-concurrency BFS.
+ * Returns new node objects and never mutates the input nodes.
+ */
+declare function hydrateLookupTree(roots: AXTreeViewNode[], loadChildren: (nodeId: string) => Promise<AXTreeViewNode[]>, options: HydrateLookupTreeOptions): Promise<AXTreeViewNode[]>;
+
+interface AXLookupArrayDataSourceOptions {
+    key: string;
+    pageSize: number;
+    textField: string;
+    translateText?: (text: string) => string;
+}
+/** Whether an item label matches a search query (raw or translated). */
+declare function matchesLookupText(text: string, query: string, translateText?: (text: string) => string): boolean;
+/**
+ * Array-backed datasource with optional i18n-aware text filtering.
+ */
+declare function convertLookupArrayToDataSource<T extends AXLookupItem>(items: T[], options: AXLookupArrayDataSourceOptions): AXDataSource<T>;
+/**
+ * Options used when adapting a lookup `treeDataSource` into an `AXDataSource`
+ * that `ax-data-table` can expand via `parentField`.
+ */
+interface AXLookupTreeTableDataSourceOptions {
+    valueField: string;
+    textField: string;
+    parentField: string;
+    hasChildrenField: string;
+    /**
+     * Fields matched by text search. Defaults to `textField` only. Supply the searchable
+     * column fields so values shown in other columns (codes, numbers) are matched too.
+     */
+    searchFields?: string[];
+    /** When set, used for text search instead of loading roots only (whole-tree lazy search). */
+    loadSearchRoots?: () => Promise<AXTreeViewNode[]>;
+}
+/**
+ * Converts a drop-down-tree datasource (nested array or lazy callback) into an
+ * `AXDataSource` that a multi-column data table can load and expand.
+ */
+declare function createLookupTreeTableDataSource(source: AXTreeViewDataSource, options: AXLookupTreeTableDataSourceOptions): AXDataSource<AXLookupItem>;
+declare function filterTreeNodes(nodes: AXLookupItem[], textField: string | string[], query: string, translateText?: (text: string) => string): AXLookupItem[];
+/**
+ * Maps `filterTreeNodes` output to data-table row metadata so matching branches
+ * are expanded and nested rows are visible for search highlighting.
+ */
+declare function prepareFilteredTreeTableRows(nodes: AXLookupItem[]): AXLookupItem[];
+/** Immutable copy of a nested tree so tree-view mutations cannot poison the source. */
+declare function cloneLookupTreeNodes(nodes: AXLookupItem[]): AXLookupItem[];
+/** Depth-first flattening of nested `children` arrays. */
+declare function flattenTreeNodes(nodes: AXLookupItem[]): AXLookupItem[];
+
+export { AXLookupComponent, AXLookupDropDownListComponent, AXLookupDropDownTreeComponent, AXLookupModule, AXLookupMultiColumnComponent, AXLookupMultiColumnTreeComponent, AXLookupMultiSelectComponent, AXLookupMultiSelectTreeComponent, cloneLookupTreeNodes, convertLookupArrayToDataSource, createLookupTreeTableDataSource, filterTreeNodes, flattenTreeNodes, hydrateLookupTree, lookupTreeNodeMayHaveChildren, matchesLookupText, prepareFilteredTreeTableRows };
+export type { AXLookupArrayDataSourceOptions, AXLookupColumn, AXLookupItem, AXLookupItemClickEvent, AXLookupMode, AXLookupSelectionChangedEvent, AXLookupTreeSelectionEvent, AXLookupTreeTableDataSourceOptions, HydrateLookupTreeOptions };

package/types/acorex-components-map.d.ts

@@ -584,6 +584,11 @@ declare class AXMapComponent extends NXComponent implements OnDestroy {
      * Refreshes POIs from providers, clearing existing POIs first
      */
     refreshPois(): Promise<void>;
+    /**
+     * Recalculates Leaflet tile layout after the map container is resized
+     * (for example after entering or exiting fullscreen).
+     */
+    invalidateSize(): void;
     /**
      * Cleanup function that destroys the map and unsubscribes from all subscriptions.
      */
@@ -1036,7 +1041,7 @@ declare class AXLeafletService {
      */
     private patchLeafletDraw;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLeafletService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXLeafletService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 interface AXPoiProvider {
@@ -1049,7 +1054,7 @@ declare class AXPoiProviderService {
     private cache;
     getList(): Promise<AXPoiMarker[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPoiProviderService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPoiProviderService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 export { AXLeafletService, AXMapComponent, AXMapDefaultConfig, AXMapModule, AXPoiProviderService, AX_MAP_CONFIG, AX_MAP_POI_PROVIDER, baseUrl, mapConfig };

package/types/acorex-components-media-viewer.d.ts

@@ -41,7 +41,7 @@ declare class AXMediaViewerBaseComponent {
         index: number;
     };
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMediaViewerBaseComponent, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMediaViewerBaseComponent>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 declare class AXMediaViewerService {
@@ -49,7 +49,7 @@ declare class AXMediaViewerService {
     selectedIndex: _angular_core.WritableSignal<number>;
     dirtyItems: Map<any, any>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMediaViewerService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMediaViewerService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 declare class AXMediaViewerContainerComponent implements OnDestroy {
@@ -83,10 +83,11 @@ declare class AXMediaViewerContainerComponent implements OnDestroy {
 
 declare class AXMediaViewerTypeRegistryService {
     private plugins;
+    constructor();
     register(...plugins: AXMediaViewerType[]): void;
     resolve(name: string): AXMediaViewerType | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMediaViewerTypeRegistryService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMediaViewerTypeRegistryService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 declare class AXMediaViewerSliderComponent {