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

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

@@ -1,8 +1,9 @@
 import * as _angular_core from '@angular/core';
 import { TemplateRef, ElementRef } from '@angular/core';
-import { AXEvent, AXDataSource, AXListDataSource, AXHtmlEvent, NXComponent, AXStyleLookType, AXValueChangedEvent, AXFocusEvent, AXItemClickEvent, AXItemSelectedEvent } from '@acorex/cdk/common';
+import { AXEvent, AXDataSource, AXListDataSource, AXHtmlEvent, NXValueComponent, AXStyleLookType, AXValueChangedEvent, AXFocusEvent, AXItemClickEvent, AXItemSelectedEvent } from '@acorex/cdk/common';
 import { AXPopoverComponent } from '@acorex/components/popover';
-import { AXTreeViewNode, AXTreeViewDataSource, AXTreeViewSelectionBehavior, AXTreeViewItemTemplateContext, AXTreeViewSelectionChangeEvent } from '@acorex/components/tree-view';
+import { AXSearchBoxComponent } from '@acorex/components/search-box';
+import { AXTreeViewDataSource, AXTreeViewItemTemplateContext, AXTreeViewSelectionChangeEvent, AXTreeViewSelectionBehavior, AXTreeViewNode } 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';
@@ -16,19 +17,25 @@ import { AXDataTableComponent, AXDataTableRowClick } from '@acorex/components/da
  * - `drop-down-tree` — a tree-like structure for single item selection.
  * - `multi-select-tree` — a tree-like structure for multiple item selection.
  * - `multi-column` — a table-structured list for single selection.
+ * - `multi-column-tree` — a multi-column table with a drop-down tree inside it (expandable rows).
  */
-type AXLookupMode = 'drop-down-list' | 'multi-select' | 'drop-down-tree' | 'multi-select-tree' | 'multi-column';
+type AXLookupMode = 'drop-down-list' | 'multi-select' | 'drop-down-tree' | 'multi-select-tree' | 'multi-column' | 'multi-column-tree';
 /**
- * A column definition for the `multi-column` lookup mode (rendered via `ax-data-table`).
+ * A column definition for the `multi-column` and `multi-column-tree` lookup modes
+ * (rendered via `ax-data-table`).
  *
  * - `field` — the item property rendered in this column (`ax-text-column` `dataField`).
  * - `title` — the header text of the column (`ax-text-column` `caption`).
  * - `width` — optional column width (`120px`, `20%`, or `auto`). Defaults to `auto`.
+ * - `expandHandler` — when `true`, this column shows the tree expand/collapse control
+ *   (`multi-column-tree` only). If omitted, the column matching `textField` (or the first
+ *   column) is used.
  */
 interface AXLookupColumn {
     field: string;
     title: string;
     width?: string;
+    expandHandler?: boolean;
 }
 /**
  * A lookup item. Items are plain records; the lookup reads them through
@@ -50,6 +57,66 @@ interface AXLookupSelectionChangedEvent extends AXEvent {
     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`).
@@ -86,6 +153,7 @@ declare abstract class AXLookupListViewBase {
     maxVisibleItems: _angular_core.InputSignal<number>;
     /**
      * Custom template rendered for each item. Context: `$implicit` is the item.
+     * Default option chrome is not applied on top of the template.
      */
     itemTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
     /**
@@ -114,6 +182,10 @@ declare abstract class AXLookupListViewBase {
     protected totalCount: _angular_core.WritableSignal<number>;
     protected isLoading: _angular_core.WritableSignal<boolean>;
     protected isEmpty: _angular_core.Signal<boolean>;
+    /** Whether the filtered datasource currently has no items. */
+    hasNoMatches(): boolean;
+    /** Number of items in the current filtered result set. */
+    matchCount(): number;
     /** Viewport height so the popup grows with the items up to `maxVisibleItems`. */
     protected viewportHeight: _angular_core.Signal<number>;
     protected viewportRef: _angular_core.Signal<CdkVirtualScrollViewport>;
@@ -127,6 +199,11 @@ declare abstract class AXLookupListViewBase {
     protected isSelected(item: AXLookupItem): boolean;
     protected isDisabled(item: AXLookupItem): boolean;
     protected handleItemClick(item: AXLookupItem | null | undefined): void;
+    /**
+     * Commit on mousedown (not click) so a searchable trigger blur cannot destroy the
+     * list before the pick is applied.
+     */
+    protected handleItemMouseDown(event: Event, item: AXLookupItem | null | undefined): void;
     protected handleItemKeypress(e: AXHtmlEvent<KeyboardEvent>, item: AXLookupItem | null | undefined): void;
     protected handleListKeypress(e: AXHtmlEvent<KeyboardEvent>): void;
     protected activateNavItem(nav: AXListNavigationDirective, item: AXListNavigationItemDirective): void;
@@ -177,25 +254,48 @@ declare class AXLookupMultiSelectTreeComponent {
      * 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 changes the tree selection.
      */
     selectionChange: _angular_core.OutputEmitterRef<AXLookupTreeSelectionEvent>;
     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<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; }; }, { "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; }; "alternate": { "alias": "alternate"; "required": false; "isSignal": true; }; "filterKey": { "alias": "filterKey"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 
 /**
- * An advanced drop-down (lookup) editor with five modes, `AXDataSource` support, and virtual scrolling.
+ * An advanced drop-down (lookup) editor with six modes, `AXDataSource` support, and virtual scrolling.
  *
  * 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).
- * - `drop-down-tree` — a predefined list rendered in a tree-like structure for single item selection.
- * - `multi-select-tree` — a tree-like structure for multiple item selection.
- * - `multi-column` — an `ax-data-table` grid; when searchable, the trigger input filters as you type.
+ * - `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.
+ * - `multi-column` — an `ax-data-table` grid; when searchable, the trigger input filters as you type
+ *   (on small screens the search field is inside the actionsheet).
+ * - `multi-column-tree` — a multi-column `ax-data-table` with a drop-down tree inside it
+ *   (expandable hierarchical rows). Uses `treeDataSource` + `columns`, or a hierarchical `dataSource`.
  *
  * With `adaptivityEnabled` (default `true`), the list opens as a bottom actionsheet on small
  * screens instead of an anchored dropdown — the same alternate presentation as `ax-select-box`.
@@ -205,19 +305,24 @@ declare class AXLookupMultiSelectTreeComponent {
  *
  * @category Components
  */
-declare class AXLookupComponent extends NXComponent implements FormValueControl<unknown | unknown[] | null> {
+declare class AXLookupComponent extends NXValueComponent implements FormValueControl<unknown | unknown[] | null> {
     #private;
+    /**
+     * The name of the form field, used by validation rules and `ax-form.validate(names)`.
+     */
+    name: _angular_core.InputSignal<string>;
     /**
      * The lookup rendering mode. Selects which mini component renders in the popup.
      */
     mode: _angular_core.InputSignal<AXLookupMode>;
     /**
-     * The items source for list-based modes (`drop-down-list`, `multi-select`, `multi-column`).
+     * The items source for list-based modes (`drop-down-list`, `multi-select`, `multi-column`)
+     * 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>>;
     /**
-     * The nodes source for tree modes (`drop-down-tree`, `multi-select-tree`):
+     * The nodes source for tree modes (`drop-down-tree`, `multi-select-tree`, `multi-column-tree`):
      * an array of nodes or a lazy children callback.
      */
     treeDataSource: _angular_core.InputSignal<AXTreeViewDataSource>;
@@ -235,18 +340,32 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
      */
     disabledField: _angular_core.InputSignal<string>;
     /**
-     * Column definitions for the `multi-column` mode (rendered as `ax-text-column` in `ax-data-table`).
+     * Column definitions for the `multi-column` and `multi-column-tree` modes
+     * (rendered as `ax-text-column` in `ax-data-table`).
      */
     columns: _angular_core.InputSignal<AXLookupColumn[]>;
+    /**
+     * Field used by `multi-column-tree` to fetch children when a row is expanded
+     * (`AXDataSource` filter). Defaults to `parentId`. Nested `children` arrays are also supported.
+     */
+    treeParentField: _angular_core.InputSignal<string>;
+    /**
+     * Field used by `multi-column-tree` to decide whether a row shows an expand control.
+     * Defaults to `hasChild`. Nodes with `children` / `childrenCount` are mapped automatically
+     * when using `treeDataSource`.
+     */
+    hasChildrenField: _angular_core.InputSignal<string>;
     /**
      * Whether the trigger accepts typing and filters the datasource (`true`),
      * or is select-only with no writable input (`false`).
-     * Applies to `drop-down-list`, `multi-select`, and `multi-column`. Tree modes ignore this.
+     * Applies to all modes, including `drop-down-tree` and `multi-select-tree`.
+     * On small screens with `adaptivityEnabled`, search is typed in the actionsheet instead of the trigger.
      */
     searchable: _angular_core.InputSignal<boolean>;
     /**
      * When `true` (default), the popup list uses the alternate actionsheet presentation on small
-     * screens (`SM`). When `false`, the list always opens as an anchored dropdown.
+     * screens (`SM`). Searchable list modes then show a search field inside the sheet. When `false`,
+     * the list always opens as an anchored dropdown.
      */
     adaptivityEnabled: _angular_core.InputSignal<boolean>;
     /**
@@ -255,12 +374,13 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
     caption: _angular_core.InputSignal<string>;
     /**
      * When `true`, list rows use alternating background colors for easier scanning
-     * (`drop-down-list`, `multi-select`, and `multi-column` modes).
+     * (all lookup modes, including drop-down-tree and multi-select-tree).
      */
     alternate: _angular_core.InputSignal<boolean>;
     /**
      * Placeholder for the trigger search input when items are already selected
-     * (mainly useful in `multi-select`). Falls back to `placeholder` when the selection is empty.
+     * (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.
      */
     searchPlaceholder: _angular_core.InputSignal<string>;
     /**
@@ -293,6 +413,8 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
     treeSelectionBehavior: _angular_core.InputSignal<AXTreeViewSelectionBehavior>;
     /**
      * Custom template rendered for each item/node. Context: `$implicit` is the item.
+     * 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.
      */
     itemTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
     /**
@@ -359,10 +481,19 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
     protected isMultiple: _angular_core.Signal<boolean>;
     /** Whether the current mode renders a tree. */
     protected isTreeMode: _angular_core.Signal<boolean>;
-    /** Whether the trigger input is writable and filters as you type. */
+    /** Whether the current mode can filter as you type (list, table, or tree). */
+    protected isListSearchMode: _angular_core.Signal<boolean>;
+    /** Whether the trigger input is writable and filters as you type (desktop only). */
     protected isEditableTrigger: _angular_core.Signal<boolean>;
+    /** Whether search is typed in the actionsheet instead of the trigger. */
+    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>;
+    /** Increments on every tree filter apply so the tree view remounts with a new instance. */
+    protected treeFilterKey: _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>;
     /** The current selection normalized to an array. */
     protected selectedValues: _angular_core.Signal<unknown[]>;
     /** The resolved selected items (via cache, datasource `find`/`byKey`, or tree node lookup). */
@@ -380,9 +511,16 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
      * the selected display text (same pattern as combo-box).
      */
     protected showSelectedTemplate: _angular_core.Signal<boolean>;
+    /** Placeholder for the editable trigger search input. */
+    protected triggerSearchPlaceholder: _angular_core.Signal<string>;
     protected popoverRef: _angular_core.Signal<AXPopoverComponent>;
+    protected originRef: _angular_core.Signal<ElementRef<HTMLElement>>;
+    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. */
     protected getItemText(item: AXLookupItem): string;
@@ -400,10 +538,12 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
      * Handles keyboard interaction on the trigger input.
      */
     protected onTriggerKeydown(e: KeyboardEvent): void;
+    /** Filters the datasource from the actionsheet search field and handles Enter with no matches. */
+    protected onSheetSearchKeydown(e: AXHtmlEvent<KeyboardEvent>): void;
     /** Blocks typing when the trigger is not editable (keeps Tab / keyboard open working). */
     protected onBeforeInput(event: Event): void;
     /**
-     * Returns focus to the trigger input when list navigation requests it.
+     * Returns focus to the search field when list navigation requests it.
      */
     protected onListNavigateOut(_reason: 'up' | 'typeahead'): void;
     protected focusListFirst(): void;
@@ -428,10 +568,10 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
      * Handles typing in the editable trigger input.
      */
     protected onTriggerSearchInput(text: string): void;
-    /** Placeholder for the editable trigger search input. */
-    protected triggerSearchPlaceholder: _angular_core.Signal<string>;
+    /** Filters the datasource from the actionsheet search field (reads the input so delayed ngModel cannot block typing). */
+    protected onSheetSearchInput(): void;
     /**
-     * Commits a single pick (drop-down-list, drop-down-tree, multi-column) and closes the popup.
+     * Commits a single pick (drop-down-list, drop-down-tree, multi-column, multi-column-tree) and closes the popup.
      */
     protected handleSinglePick(e: AXLookupItemClickEvent): void;
     /**
@@ -466,7 +606,7 @@ declare class AXLookupComponent extends NXComponent implements FormValueControl<
      */
     reset(isUserInteraction?: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXLookupComponent, "ax-lookup", never, { "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; }; "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"], true, 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>;
 }
 
 /**
@@ -492,72 +632,134 @@ declare class AXLookupMultiSelectComponent extends AXLookupListViewBase {
 }
 
 /**
- * Internal mini component for the `drop-down-tree` lookup mode:
- * a predefined list rendered in a tree-like structure for single item selection.
+ * Internal mini component for the `multi-column` lookup mode:
+ * renders selectable rows in an `ax-data-table` grid and loads further
+ * pages as the user scrolls (no pager UI).
  *
  * @category Components
  */
-declare class AXLookupDropDownTreeComponent {
+declare class AXLookupMultiColumnComponent {
+    #private;
     /**
-     * The tree datasource: an array of nodes or a lazy children callback.
+     * The datasource providing the grid rows (paged, remote-capable).
+     * Pages are fetched on demand as the user scrolls the table body.
      */
-    dataSource: _angular_core.InputSignal<AXTreeViewDataSource>;
+    dataSource: _angular_core.InputSignal<AXDataSource<AXLookupItem>>;
     /**
-     * The node property used as the selection value (tree `idField`).
+     * The item property used as the selection value.
      */
     valueField: _angular_core.InputSignal<string>;
     /**
-     * The node property used as the display text (tree `titleField`).
+     * The item property used as the display text.
      */
     textField: _angular_core.InputSignal<string>;
     /**
-     * The node property marking a node as disabled.
+     * The item property marking an item as disabled.
      */
     disabledField: _angular_core.InputSignal<string>;
     /**
-     * Currently selected values (at most one for single selection).
+     * Currently selected values (always an array, even for single selection).
      */
     selectedValues: _angular_core.InputSignal<unknown[]>;
     /**
-     * Custom template rendered for each tree node.
+     * The fixed row height in pixels passed to the data table.
      */
-    nodeTemplate: _angular_core.InputSignal<TemplateRef<AXTreeViewItemTemplateContext>>;
+    itemHeight: _angular_core.InputSignal<number>;
     /**
-     * Emitted when the user selects a node.
+     * The maximum number of body rows visible before the table scrolls.
+     */
+    maxVisibleItems: _angular_core.InputSignal<number>;
+    /**
+     * Column definitions rendered as `ax-text-column` instances.
+     */
+    columns: _angular_core.InputSignal<AXLookupColumn[]>;
+    /**
+     * Optional custom row content. Context: `$implicit` is the row item.
+     * When set, replaces the default multi-column cell layout.
+     */
+    itemTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * Custom template rendered when the datasource has no items.
+     */
+    emptyTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * Custom template rendered while the table is loading.
+     */
+    loadingTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
+    /**
+     * When `true`, table rows use alternating background colors for easier scanning.
+     */
+    alternate: _angular_core.InputSignal<boolean>;
+    /**
+     * Emitted when the user picks a row.
      */
     itemClick: _angular_core.OutputEmitterRef<AXLookupItemClickEvent>;
-    protected selectedIds: _angular_core.Signal<string[]>;
-    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; }; }, { "itemClick": "itemClick"; }, never, never, true, never>;
+    protected tableRef: _angular_core.Signal<AXDataTableComponent>;
+    /**
+     * Local table source: one page of whatever has been scrolled in so far.
+     * Kept as a stable instance so the table host is not recreated on each page load.
+     * `pageSize` grows with `#loadedItems` — never seed with a huge empty array (data-table
+     * initializes `displayedRows` as `new Array(pageSize)`, which caused NG0955-level jank).
+     */
+    protected readonly tableDataSource: AXDataSource<AXLookupItem>;
+    /**
+     * Header (~40px) + body rows. Grows with results up to `maxVisibleItems`,
+     * then the table body scrolls for the rest.
+     */
+    protected tableHeight: _angular_core.Signal<number>;
+    protected loadingConfig: _angular_core.Signal<{
+        enabled: boolean;
+        animation: boolean;
+        loadingTemplate: TemplateRef<unknown>;
+    }>;
+    constructor();
+    /** Stable unique key for `@for` — avoids NG0955 when `field` is missing or duplicated. */
+    protected trackColumnKey(index: number, column: AXLookupColumn): string;
+    protected resolveColumnWidth(column: AXLookupColumn): string | number | 'auto';
+    protected resolveRowCssClass: (row: unknown) => string;
+    protected handleRowClick(event: AXDataTableRowClick): void;
+    protected handleItemClick(item: AXLookupItem | null | undefined): void;
+    protected handleItemMouseDown(event: Event, item: AXLookupItem | null | undefined): void;
+    protected isSelected(item: AXLookupItem): boolean;
+    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>;
 }
 
 /**
- * Internal mini component for the `multi-column` lookup mode:
- * renders selectable rows in an `ax-data-table` grid and loads further
- * pages as the user scrolls (no pager UI).
+ * Internal mini component for the `multi-column-tree` lookup mode:
+ * a multi-column `ax-data-table` with a drop-down tree inside it.
+ * Rows expand/collapse via the data-table hierarchy (`parentField` / nested `children`).
  *
  * @category Components
  */
-declare class AXLookupMultiColumnComponent {
-    #private;
+declare class AXLookupMultiColumnTreeComponent {
     /**
-     * The datasource providing the grid rows (paged, remote-capable).
-     * Pages are fetched on demand as the user scrolls the table body.
+     * The datasource providing hierarchical rows (roots on load, children via `parentField`).
      */
     dataSource: _angular_core.InputSignal<AXDataSource<AXLookupItem>>;
     /**
-     * The item property used as the selection value.
+     * The item property used as the selection value (also the data-table row key).
      */
     valueField: _angular_core.InputSignal<string>;
     /**
-     * The item property used as the display text.
+     * The item property used as the display text. The matching column shows the expand control
+     * unless another column sets `expandHandler`.
      */
     textField: _angular_core.InputSignal<string>;
     /**
      * The item property marking an item as disabled.
      */
     disabledField: _angular_core.InputSignal<string>;
+    /**
+     * Field used by the data table to fetch children (`AXDataSource` filter on expand).
+     */
+    parentField: _angular_core.InputSignal<string>;
+    /**
+     * Field used by the data table to decide whether a row can expand.
+     */
+    hasChildrenField: _angular_core.InputSignal<string>;
     /**
      * Currently selected values (always an array, even for single selection).
      */
@@ -592,20 +794,11 @@ declare class AXLookupMultiColumnComponent {
      */
     alternate: _angular_core.InputSignal<boolean>;
     /**
-     * Emitted when the user picks a row.
+     * Emitted when the user picks a row (not when expanding/collapsing).
      */
     itemClick: _angular_core.OutputEmitterRef<AXLookupItemClickEvent>;
-    protected tableRef: _angular_core.Signal<AXDataTableComponent>;
-    /**
-     * Local table source: one page of whatever has been scrolled in so far.
-     * Kept as a stable instance so the table host is not recreated on each page load.
-     * `pageSize` grows with `#loadedItems` — never seed with a huge empty array (data-table
-     * initializes `displayedRows` as `new Array(pageSize)`, which caused NG0955-level jank).
-     */
-    protected readonly tableDataSource: AXDataSource<AXLookupItem>;
     /**
-     * Header (~40px) + body rows. Grows with results up to `maxVisibleItems`,
-     * then the table body scrolls for the rest.
+     * Header (~40px) + up to `maxVisibleItems` body rows. Expanded children scroll inside.
      */
     protected tableHeight: _angular_core.Signal<number>;
     protected loadingConfig: _angular_core.Signal<{
@@ -613,25 +806,26 @@ declare class AXLookupMultiColumnComponent {
         animation: boolean;
         loadingTemplate: TemplateRef<unknown>;
     }>;
-    constructor();
     /** Stable unique key for `@for` — avoids NG0955 when `field` is missing or duplicated. */
     protected trackColumnKey(index: number, column: AXLookupColumn): string;
     protected resolveColumnWidth(column: AXLookupColumn): string | number | 'auto';
+    protected isExpandColumn(index: number, column: AXLookupColumn): boolean;
     protected resolveRowCssClass: (row: unknown) => string;
     protected handleRowClick(event: AXDataTableRowClick): void;
     protected handleItemClick(item: AXLookupItem | null | undefined): void;
+    protected handleItemMouseDown(event: Event, item: AXLookupItem | null | undefined): void;
     protected isSelected(item: AXLookupItem): boolean;
     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 ɵ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>;
 }
 
 declare class AXLookupModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXLookupModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXLookupModule, never, [typeof AXLookupComponent, typeof AXLookupDropDownListComponent, typeof AXLookupMultiSelectComponent, typeof AXLookupDropDownTreeComponent, typeof AXLookupMultiSelectTreeComponent, typeof AXLookupMultiColumnComponent], [typeof AXLookupComponent, typeof AXLookupDropDownListComponent, typeof AXLookupMultiSelectComponent, typeof AXLookupDropDownTreeComponent, typeof AXLookupMultiSelectTreeComponent, typeof AXLookupMultiColumnComponent]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXLookupModule, never, [typeof AXLookupComponent, typeof AXLookupDropDownListComponent, typeof AXLookupMultiSelectComponent, typeof AXLookupDropDownTreeComponent, typeof AXLookupMultiSelectTreeComponent, typeof AXLookupMultiColumnComponent, typeof AXLookupMultiColumnTreeComponent], [typeof AXLookupComponent, typeof AXLookupDropDownListComponent, typeof AXLookupMultiSelectComponent, typeof AXLookupDropDownTreeComponent, typeof AXLookupMultiSelectTreeComponent, typeof AXLookupMultiColumnComponent, typeof AXLookupMultiColumnTreeComponent]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXLookupModule>;
 }
 
-export { AXLookupComponent, AXLookupDropDownListComponent, AXLookupDropDownTreeComponent, AXLookupModule, AXLookupMultiColumnComponent, AXLookupMultiSelectComponent, AXLookupMultiSelectTreeComponent };
+export { AXLookupComponent, AXLookupDropDownListComponent, AXLookupDropDownTreeComponent, AXLookupModule, AXLookupMultiColumnComponent, AXLookupMultiColumnTreeComponent, AXLookupMultiSelectComponent, AXLookupMultiSelectTreeComponent };
 export type { AXLookupColumn, AXLookupItem, AXLookupItemClickEvent, AXLookupMode, AXLookupSelectionChangedEvent, AXLookupTreeSelectionEvent };

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

@@ -186,6 +186,12 @@ declare class AXPopoverComponent extends MXBaseComponent implements OnDestroy {
     private setupScrollListener;
     /** @ignore */
     private removeScrollListener;
+    /**
+     * True when scroll is a side-effect of focusing an editable control inside the overlay
+     * (soft keyboard / visual viewport adjustment), mainly on iOS Safari.
+     * @ignore
+     */
+    private isKeyboardInducedScroll;
     /**
      * Checks whether the given element lives inside a child overlay
      * (an overlay stacked on top of this popover, e.g. a selectbox dropdown).

package/types/acorex-components-select-box.d.ts

@@ -58,6 +58,13 @@ declare class AXSelectBoxComponent extends AXSelectBoxComponent_base implements
     protected _dropdownWidth: _angular_core.WritableSignal<string>;
     /** @ignore */
     protected _dropdownHeight: _angular_core.WritableSignal<string>;
+    /**
+     * Pixel height for the popover list and CDK viewport. Uses the sized height
+     * when known, otherwise the standard `maxVisibleItems × itemHeight` viewport.
+     * Always a pixel value so virtual scroll has a definite size on first open.
+     * @ignore
+     */
+    protected _panelMinHeight: _angular_core.Signal<string>;
     /** @ignore */
     protected _listDataSource: AXDataSource<any>;
     /** @ignore */
@@ -161,6 +168,10 @@ declare class AXSelectBoxComponent extends AXSelectBoxComponent_base implements
     /** @ignore */
     protected _handleItemSelected(e: AXItemSelectedEvent): void;
     private resetSearchAfterSelection;
+    private _getListItemPx;
+    private _getMaxVisibleItems;
+    /** Standard popover list height: `maxVisibleItems` rows (default 5). */
+    private _getStandardListHeightPx;
     /** @ignore */
     private setDropdownSize;
     /**