@acorex/components 22.2.1 → 22.2.3

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "22.2.1",
+  "version": "22.2.3",
   "peerDependencies": {
-    "@acorex/core": "22.2.1",
-    "@acorex/cdk": "22.2.1",
+    "@acorex/core": "22.2.3",
+    "@acorex/cdk": "22.2.3",
     "@angular/aria": ">=22.1.0",
     "polytype": ">=0.17.0",
     "hammerjs": ">=2.0.8",

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

@@ -895,5 +895,65 @@ 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;
+    /** 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>;
+/**
+ * Recursively filters a nested tree by `textField` (case-insensitive contains).
+ * A node is kept if it matches or any descendant matches. Matching parents keep
+ * all children. Every kept ancestor is a new object with `expanded: true` so
+ * nested hits are visible without mutating the original tree.
+ */
+declare function filterTreeNodes(nodes: AXLookupItem[], textField: 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 };