imm-element-ui 2.4.7 → 2.4.9

package/lib/am/am.component.d.ts

@@ -6,6 +6,7 @@ import { ConfirmationService, MessageService } from 'primeng/api';
 import { ActivatedRoute, Router } from '@angular/router';
 import { LoadingService } from '../service/loading.service';
 import { I18nService } from '../service/i18n.service';
+import { toPrimeNGTree as _toPrimeNGTree } from '../share/data-utils';
 import * as i0 from "@angular/core";
 export interface Param {
     id?: number;
@@ -158,6 +159,7 @@ export declare class AmComponent {
     route: ActivatedRoute;
     router: Router;
     i18n: I18nService;
+    toPrimeNGTree: typeof _toPrimeNGTree;
     constructor();
     rfd(prm: Rfd): Observable<any>;
     webget(param: amWeb): Observable<any>;

package/lib/form/form/form.component.d.ts

@@ -40,6 +40,7 @@ export declare class FormComponent {
     fieldList: FormField[];
     hookObservers: Function[];
     labelMinWidth: import("@angular/core").WritableSignal<string | undefined>;
+    private fallbackUpsert;
     isMain: boolean;
     subsert: any;
     extra: any;
@@ -55,6 +56,7 @@ export declare class FormComponent {
     parseFields(fields: FormField[]): void;
     handleFieldControl(field: FormField): void;
     handleValueChange(value: any, field: FormField): void;
+    private getUpsertState;
     handleUpsert(key: string, value: any, isLog?: boolean): void;
     handleSubsert(key: string, value: any, field: FormField): void;
     handleHideExpression(): void;

package/lib/grid/cell-render/async-link-renderer.d.ts

@@ -0,0 +1,14 @@
+import { Observable } from 'rxjs';
+import { Router } from '@angular/router';
+import * as i0 from "@angular/core";
+export declare class AsyncLinkRenderer {
+    label: any;
+    params: any;
+    router: Router;
+    optionsHook?: (value: any) => Observable<any[]>;
+    agInit(params: any): void;
+    triggerOptionsHook(value: any): void;
+    onLink(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AsyncLinkRenderer, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AsyncLinkRenderer, "ng-component", never, {}, {}, never, never, true, never>;
+}

package/lib/grid/grid/grid.component.d.ts

@@ -54,6 +54,7 @@ export declare class GridComponent {
         rowSpanRenderer: typeof import("../cell-render/row-span").RowSpanRenderer;
         cellEditSelectFieldComponent: typeof import("imm-element-ui").CellEditSelectFieldComponent;
         primeActionsRenderer: typeof import("../cell-render/primeAct-renderer").PrimeActionsRenderer;
+        asyncLinkRenderer: typeof import("../cell-render/async-link-renderer").AsyncLinkRenderer;
     };
     columnDefs: ColDef[];
     initGrid: boolean;
@@ -93,6 +94,7 @@ export declare class GridComponent {
     noRows: boolean;
     showHorizontal: boolean;
     dragBeforeIndex: number;
+    private searchPrmSub;
     onResize(): void;
     constructor(action: ActionService);
     ngOnInit(): void;

package/lib/grid/mock-data.d.ts

@@ -5,6 +5,7 @@ import { ChipRenderer } from './cell-render/chip-render';
 import { ImgRenderer } from './cell-render/img-renderer';
 import { RowSpanRenderer } from './cell-render/row-span';
 import { PrimeActionsRenderer } from './cell-render/primeAct-renderer';
+import { AsyncLinkRenderer } from './cell-render/async-link-renderer';
 export declare const CLIENTLIMIT = 9999;
 export declare const components: {
     cellEditInputNumberCompoent: typeof CellEditInputNumberCompoent;
@@ -19,4 +20,5 @@ export declare const components: {
     rowSpanRenderer: typeof RowSpanRenderer;
     cellEditSelectFieldComponent: typeof CellEditSelectFieldComponent;
     primeActionsRenderer: typeof PrimeActionsRenderer;
+    asyncLinkRenderer: typeof AsyncLinkRenderer;
 };

package/lib/page-form/page-form.component.d.ts

@@ -2,6 +2,7 @@ import { UserHistoryService } from '../service/userHistory.service';
 import { AfterContentInit, AfterViewInit, OnDestroy, OnInit, QueryList, TemplateRef } from '@angular/core';
 import { FormComponent, FormOptions } from '../form/form/form.component';
 import { RowSelectorComponent } from '../row-selector/row-selector.component';
+import { TreeNode } from 'primeng/api';
 import { Step, StepsComponent } from '../steps/steps.component';
 import { GridComponent, GridOptions } from '../grid/grid/grid.component';
 import { AmComponent, Get, Search } from '../am/am.component';
@@ -64,9 +65,13 @@ export declare class PageFormComponent extends AmComponent implements OnInit, On
     selectionKeys: any[];
     subDeleteIds: any[];
     leftPanelItems: any[];
+    leftPanelTreeNodes: TreeNode[];
+    leftPanelSelectedNode: TreeNode | null;
     leftPanelSelectedValue: any;
     leftPanelSelectedItem: any;
+    leftPanelExpandedKeys: Record<string, boolean>;
     leftPanelInitialized: boolean;
+    private leftPanelInitializedMode;
     private baseGridListSnapshot;
     stepsVisible: boolean;
     private destroy$;
@@ -92,16 +97,53 @@ export declare class PageFormComponent extends AmComponent implements OnInit, On
     ngAfterContentInit(): void;
     ngOnInit(): void;
     ngOnDestroy(): void;
+    private resetLeftPanelState;
     private initializeLeftPanel;
+    private initializeLeftPanelList;
     private loadLeftPanelItems;
+    private getLeftPanelMode;
+    getPanelOptionLabel(): string;
+    getPanelOptionValue(): string;
+    getPanelAllowDeselect(): boolean;
+    getPanelEmptyMessage(): string;
+    private getPanelDataSource;
+    private getTreeChildrenField;
+    private getTreeParentSelectable;
+    private getTreeExpandedKeysStateKey;
+    private getTreeFieldValue;
     private resolveMaybeAsync;
     private createLeftPanelEventContext;
     private runLeftPanelEvent;
-    private resolveLeftPanelValue;
+    private resolvePanelOptionValue;
     onLeftPanelSelectionChange(event: SingleSelectListboxChangeEvent): Promise<void>;
     private applyLeftPanelSelection;
     private syncGetPrmFiterPreloads;
     private syncGetPrmForCurrentView;
+    private syncLeftPanelSelectionState;
+    private initializeLeftPanelTree;
+    private buildTreeNodes;
+    private buildTreeNodeKey;
+    private resolveTreeNodeLabel;
+    private shouldExpandTreeNode;
+    private readTreeExpandedKeysState;
+    private syncTreeExpandedKeysState;
+    private applyTreeDefaultSelection;
+    private findFirstSelectableTreeNode;
+    private resolveTreeNodeBySelection;
+    private findTreeNodeByValue;
+    private findTreeNodeByKey;
+    private isTreeParentNode;
+    private isSelectableTreeNode;
+    onLeftPanelTreeNodeSelect(event: {
+        node: TreeNode;
+    }): Promise<void>;
+    onLeftPanelTreeNodeExpand(event: {
+        node: TreeNode;
+    }): void;
+    onLeftPanelTreeNodeCollapse(event: {
+        node: TreeNode;
+    }): void;
+    private applyLeftPanelTreeSelection;
     private buildFormOptions;
     private resolveLeftPanelAppendGroups;
     private mergeDetailWithLeftPanel;

package/lib/page-form/page-form.interface.d.ts

@@ -83,6 +83,12 @@ export interface PageLeftPanelTreeConfig {
     nodeValue?: string;
     childrenField?: string;
     defaultExpand?: boolean;
+    expandedKeysStateKey?: string;
+    iconField?: string;
+    leafField?: string;
+    disabledField?: string;
+    parentSelectable?: boolean;
+    emptyMessage?: string;
     dataSource?: PageLeftPanelDataSource;
 }
 export interface PageLeftPanelConfig {
@@ -90,6 +96,11 @@ export interface PageLeftPanelConfig {
     mode?: 'list' | 'tree';
     stateKey?: string;
     panelSelectedDataKey?: string;
+    optionLabel?: string;
+    optionValue?: string;
+    allowDeselect?: boolean;
+    emptyMessage?: string;
+    dataSource?: PageLeftPanelDataSource;
     appendGroups?: any[] | ((context?: any) => any[]);
     list?: PageLeftPanelListConfig;
     tree?: PageLeftPanelTreeConfig;

package/lib/share/data-utils.d.ts

@@ -0,0 +1,49 @@
+import { TreeNode } from 'primeng/api';
+/**
+ * 树形结构转换配置项
+ */
+export interface TreeConvertOptions {
+    /** 节点唯一标识字段名，默认 'id' */
+    idKey?: string;
+    /** 父节点标识字段名，默认 'pid' */
+    pidKey?: string;
+    /** 节点显示文本字段名，默认 'orgName' */
+    labelKey?: string;
+    /** 子节点存放字段名，默认 'children' */
+    childrenKey?: string;
+    /** 根节点的pid值，默认 undefined（pid不存在或为null/undefined的作为根节点） */
+    rootPidValue?: any;
+    /** 是否保留原始数据，默认 true */
+    preserveData?: boolean;
+}
+/**
+ * 将扁平数组转换为 PrimeNG TreeNode 树形结构
+ * @param list 原始数据数组
+ * @param options 配置项
+ * @returns PrimeNG TreeNode 数组
+ */
+export declare function toPrimeNGTree<T extends Record<string, any>>(list: T[], options?: TreeConvertOptions): TreeNode[];
+/**
+ * 简化版：只指定关键字段
+ * @param list 原始数据
+ * @param idField id字段名
+ * @param pidField 父id字段名
+ * @param labelField 显示文本字段名
+ */
+export declare function toPrimeNGTreeSimple<T extends Record<string, any>>(list: T[], idField?: string, pidField?: string, labelField?: string): TreeNode[];
+/**
+ * 从树中查找节点
+ * @param tree 树形数据
+ * @param predicate 查找条件
+ */
+export declare function findTreeNode(tree: TreeNode[], predicate: (node: TreeNode) => boolean): TreeNode | null;
+/**
+ * 展开/折叠所有节点
+ * @param tree 树形数据
+ * @param expanded 是否展开
+ */
+export declare function expandAllTreeNodes(tree: TreeNode[], expanded?: boolean): void;
+/**
+ * 获取树的所有叶子节点
+ */
+export declare function getLeafNodes(tree: TreeNode[]): TreeNode[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imm-element-ui",
-  "version": "2.4.7",
+  "version": "2.4.9",
   "peerDependencies": {
     "@angular/common": "^18.2.0",
     "@angular/core": "^18.2.0"

package/src/lib/page-form/page-form.component.scss

@@ -17,6 +17,10 @@
 		// color: #1F2937 !important;
 		border-color: #d8dadd;
 	}
+	.page-form-left-tree {
+		border: none !important;
+		padding: 0 !important;
+	}
 }
 .form-panel {
 	border: solid 1px #dbdbdb;
@@ -24,6 +28,20 @@
 .page-form-left-panel {
 	height: 100%;
 }
+.page-form-tree-panel {
+	border: 1px solid #e2e8f0;
+	border-radius: 4px;
+	background: #fff;
+	padding: 4px;
+}
+.page-form-left-panel-empty {
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	min-height: 160px;
+	color: #94a3b8;
+	font-size: 12px;
+}
 .icon-sidebar {
 	color: #334155;
 	padding: 2.5px;