@acorex/components 22.1.7 → 22.2.0-next.0

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';
@@ -42,6 +42,17 @@ interface AXLookupColumn {
  * `valueField` / `textField` / `disabledField` mappings.
  */
 type AXLookupItem = Record<string, unknown>;
+/**
+ * Multi-select bound value when the user selects all items (optionally with exclusions).
+ * Used with `multi-select` and `multi-select-tree` via `[(value)]` / `[(ngModel)]`.
+ */
+interface AXLookupSelectAllValue {
+    selectAll: true;
+    /** Value keys (`valueField`) that are not selected while `selectAll` is true. */
+    excluded?: unknown[];
+}
+/** Bound value in multi-select lookup modes. */
+type AXLookupMultiValue = unknown[] | AXLookupSelectAllValue | null;
 /**
  * Internal event emitted by the mini view components when the user picks or toggles an item.
  */
@@ -54,71 +65,7 @@ interface AXLookupItemClickEvent {
  */
 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>;
-    /**
-     * 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; }; "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>;
+    value: unknown | unknown[] | AXLookupSelectAllValue | null;
 }
 
 /**
@@ -147,6 +94,14 @@ declare abstract class AXLookupListViewBase {
      * Currently selected values (always an array, even for single selection).
      */
     selectedValues: _angular_core.InputSignal<unknown[]>;
+    /**
+     * When `true`, every non-disabled row is selected except keys listed in `excludedValues`.
+     */
+    selectAllActive: _angular_core.InputSignal<boolean>;
+    /**
+     * Value keys excluded from selection while `selectAllActive` is true.
+     */
+    excludedValues: _angular_core.InputSignal<unknown[]>;
     /**
      * The fixed row height in pixels used by the virtual scroll viewport.
      */
@@ -201,7 +156,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;
@@ -218,7 +173,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; }; "highlightText": { "alias": "highlightText"; "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; }; "selectAllActive": { "alias": "selectAllActive"; "required": false; "isSignal": true; }; "excludedValues": { "alias": "excludedValues"; "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>;
 }
 
 /**
@@ -235,6 +190,8 @@ interface AXLookupTreeSelectionEvent {
  * @category Components
  */
 declare class AXLookupMultiSelectTreeComponent {
+    #private;
+    constructor();
     /**
      * The tree datasource: an array of nodes or a lazy children callback.
      */
@@ -267,6 +224,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.
      */
@@ -293,7 +258,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; }; "highlightText": { "alias": "highlightText"; "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>;
 }
 
 /**
@@ -320,7 +285,7 @@ declare class AXLookupMultiSelectTreeComponent {
  *
  * @category Components
  */
-declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent implements FormValueControl<unknown | unknown[] | null> {
+declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent implements FormValueControl<unknown | unknown[] | AXLookupSelectAllValue | null> {
     #private;
     /**
      * The name of the form field, used by validation rules and `ax-form.validate(names)`.
@@ -374,6 +339,7 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
      * 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>;
@@ -385,6 +351,7 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
     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>;
     /**
@@ -396,12 +363,18 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
      * 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.
      */
@@ -451,11 +424,13 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
      */
     loadingTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
     /**
-     * The selected value(s): a scalar in single modes, an array in
-     * `multi-select` / `multi-select-tree`. Supports `[(value)]`, `[(ngModel)]`, and signal forms
-     * via {@link FormValueControl}.
+     * The selected value(s): a scalar in single modes; in `multi-select` / `multi-select-tree` an array
+     * of keys or `{ selectAll: true, excluded?: [...] }` when the default header “Select all” is used.
+     * Supports `[(value)]`, `[(ngModel)]`, and signal forms via {@link FormValueControl}.
      */
     readonly value: _angular_core.ModelSignal<unknown>;
+    /** Projected popover header; when set, replaces the default multi-select “Select all” header. */
+    private readonly projectedHeader;
     /**
      * Full items that resolve the current `value` key(s) without calling datasource `byKey`.
      * Use when the parent already has the selected entity (e.g. edit forms). Seeds the internal
@@ -510,6 +485,7 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
     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). */
@@ -517,12 +493,27 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
     /** 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. */
+    /** Explicit key list (empty when multi value is select-all object). */
     protected selectedValues: _angular_core.Signal<unknown[]>;
+    protected multiSelectAllActive: _angular_core.Signal<boolean>;
+    protected multiExcludedValues: _angular_core.Signal<unknown[]>;
+    protected hasProjectedHeader: _angular_core.Signal<boolean>;
+    protected showDefaultSelectAllHeader: _angular_core.Signal<boolean>;
+    protected selectAllHeaderChecked: _angular_core.Signal<boolean>;
+    protected selectAllHeaderIndeterminate: _angular_core.Signal<boolean>;
+    /** Keys used for tree controlled selection when leaving select-all mode. */
+    protected effectiveSelectedKeys: _angular_core.Signal<unknown[]>;
+    protected hasSelection: _angular_core.Signal<boolean>;
     /** The resolved selected items (via cache, datasource `find`/`byKey`, or tree node lookup). */
     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.
@@ -541,8 +532,6 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
     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. */
@@ -553,6 +542,10 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
      * 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.
      */
@@ -565,6 +558,12 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
     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;
+    /**
+     * Toggles the default header “Select all” checkbox; updates `value` only (no separate event).
+     */
+    protected onSelectAllHeaderChanged(checked: boolean): void;
+    /** Toggles select-all from the header row so the checkbox stays pointer-events-none like option rows. */
+    protected onSelectAllHeaderMouseDown(event: Event): void;
     /** Blocks typing when the trigger is not editable (keeps Tab / keyboard open working). */
     protected onBeforeInput(event: Event): void;
     /**
@@ -631,7 +630,7 @@ declare class AXLookupComponent<T = AXLookupItem> extends NXValueComponent imple
      */
     reset(isUserInteraction?: boolean): void;
     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>;
+    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"; }, ["projectedHeader"], ["ax-prefix", "ax-clear-button", "ax-suffix", "ax-header", "ax-footer", "ax-validation-rule"], true, never>;
 }
 
 /**
@@ -656,6 +655,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
@@ -764,6 +837,8 @@ declare class AXLookupMultiColumnComponent {
  * @category Components
  */
 declare class AXLookupMultiColumnTreeComponent {
+    #private;
+    constructor();
     /**
      * The datasource providing hierarchical rows (roots on load, children via `parentField`).
      */
@@ -860,5 +935,78 @@ 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 };
+/**
+ * Multi-select value when the user chooses “select all” instead of an explicit key list.
+ */
+declare function isLookupSelectAllValue(value: unknown): value is AXLookupSelectAllValue;
+/** Excluded value keys when `selectAll` is active (empty when not in select-all mode). */
+declare function lookupExcludedValues(value: unknown): unknown[];
+/** Whether the bound multi value is in select-all mode. */
+declare function lookupSelectAllActive(value: unknown): boolean;
+/** Normalized explicit key list for array-mode multi values. */
+declare function lookupArrayValues(value: unknown): unknown[];
+declare function createLookupSelectAllValue(excluded?: unknown[]): AXLookupSelectAllValue;
+/** Deep equality for lookup multi values (arrays and select-all objects). */
+declare function lookupMultiValuesEqual(a: unknown, b: unknown): boolean;
+
+/** 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, createLookupSelectAllValue, createLookupTreeTableDataSource, filterTreeNodes, flattenTreeNodes, hydrateLookupTree, isLookupSelectAllValue, lookupArrayValues, lookupExcludedValues, lookupMultiValuesEqual, lookupSelectAllActive, lookupTreeNodeMayHaveChildren, matchesLookupText, prepareFilteredTreeTableRows };
+export type { AXLookupArrayDataSourceOptions, AXLookupColumn, AXLookupItem, AXLookupItemClickEvent, AXLookupMode, AXLookupMultiValue, AXLookupSelectAllValue, 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 {

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

@@ -72,6 +72,7 @@ type AXContextMenuItemsClickEvent = AXMenuItemClickBaseEvent<AXContextMenuCompon
  * @category Components
  */
 declare class AXContextMenuComponent extends NXComponent {
+    protected readonly supportsHeader = true;
     readonly orientation: _angular_core.InputSignal<AXOrientation>;
     readonly openOn: _angular_core.InputSignal<AXMenuOpenTrigger>;
     readonly closeOn: _angular_core.InputSignal<AXMenuCloseTrigger>;
@@ -115,6 +116,10 @@ declare class AXContextMenuComponent extends NXComponent {
     private backdropElement;
     private originalNextSibling;
     private originalParent;
+    private readonly headerSlot;
+    private floatingHeader;
+    private headerOriginalParent;
+    private headerOriginalNextSibling;
     protected items: _angular_core.WritableSignal<AXMenuItem[]>;
     /** @ignore */
     private setupCloseOnRouteChange;
@@ -130,24 +135,30 @@ declare class AXContextMenuComponent extends NXComponent {
     private internalShowAt;
     /**
      * Positions the menu at `point`, flipping when it would overflow the viewport.
-     * Uses a temporary visible layout pass so parents that hide the host (e.g. side-menu `display: none`) do not yield a zero-sized rect.
+     * When a floating header is present, positions header and panel as one clamped block.
      */
     private positionAtPoint;
     /** Measures menu size even when an ancestor hides the host with `display: none`. */
     private measureMenuRect;
+    /** Measures the floating header bar using the same hidden-layout pass as the menu panel. */
+    private measureFloatingRect;
     /** @ignore */
     private createBackdrop;
+    /** Moves the projected header slot into the backdrop as a floating sibling of the panel. */
+    private floatHeaderToBackdrop;
+    /** Restores the header slot to its original parent before the backdrop is removed. */
+    private restoreFloatingHeader;
     /** @ignore */
     private resolveContextMenuTarget;
     /** @ignore */
     private removeBackdrop;
     private createEventListeners;
     /** @ignore */
-    onWindowEvent(): void;
+    onWindowEvent(event?: Event): void;
     /** @ignore */
     get __hostClass(): any;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXContextMenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXContextMenuComponent, "ax-context-menu", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "openOn": { "alias": "openOn"; "required": false; "isSignal": true; }; "closeOn": { "alias": "closeOn"; "required": false; "isSignal": true; }; "closeOnRouteChange": { "alias": "closeOnRouteChange"; "required": false; "isSignal": true; }; "originalItems": { "alias": "items"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; }, { "onItemClick": "onItemClick"; "onOpening": "onOpening"; "onClose": "onClose"; }, never, ["ax-menu-item,ax-divider,ax-title,ng-container"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXContextMenuComponent, "ax-context-menu", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "openOn": { "alias": "openOn"; "required": false; "isSignal": true; }; "closeOn": { "alias": "closeOn"; "required": false; "isSignal": true; }; "closeOnRouteChange": { "alias": "closeOnRouteChange"; "required": false; "isSignal": true; }; "originalItems": { "alias": "items"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; }, { "onItemClick": "onItemClick"; "onOpening": "onOpening"; "onClose": "onClose"; }, never, ["ax-header", "ax-menu-item,ax-divider,ax-title,ng-container"], true, never>;
 }
 
 type AXMenuItemClickEvent = AXMenuItemClickBaseEvent<AXMenuItemComponent>;
@@ -292,7 +303,7 @@ declare class AXMenuService {
     markOpen(item: AXMenuItemComponentBase): void;
     markClosed(item: AXMenuItemComponentBase): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMenuService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMenuService>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
 }
 
 type AXMenuItemsClickEvent = AXMenuItemClickBaseEvent<AXMenuComponent>;
@@ -301,6 +312,7 @@ type AXMenuItemsClickEvent = AXMenuItemClickBaseEvent<AXMenuComponent>;
  * @category Components
  */
 declare class AXMenuComponent extends NXComponent {
+    protected readonly supportsHeader = false;
     constructor();
     orientation: _angular_core.InputSignal<AXOrientation>;
     openOn: _angular_core.InputSignal<AXMenuOpenTrigger>;
@@ -318,7 +330,7 @@ declare class AXMenuComponent extends NXComponent {
      */
     close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMenuComponent, "ax-menu", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "openOn": { "alias": "openOn"; "required": false; "isSignal": true; }; "closeOn": { "alias": "closeOn"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "hasArrow": { "alias": "hasArrow"; "required": false; "isSignal": true; }; }, { "onItemClick": "onItemClick"; }, never, ["ax-menu-item,ax-divider,ax-title,ng-container"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMenuComponent, "ax-menu", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "openOn": { "alias": "openOn"; "required": false; "isSignal": true; }; "closeOn": { "alias": "closeOn"; "required": false; "isSignal": true; }; "items": { "alias": "items"; "required": false; "isSignal": true; }; "hasArrow": { "alias": "hasArrow"; "required": false; "isSignal": true; }; }, { "onItemClick": "onItemClick"; }, never, ["ax-header", "ax-menu-item,ax-divider,ax-title,ng-container"], true, never>;
 }
 
 declare class AXMenuModule {