@ibiz-template/model-helper 0.7.41-alpha.124 → 0.7.41-alpha.126

package/out/index.d.ts

@@ -1,7 +1,8 @@
 import '@ibiz/model-core';
 import '@ibiz-template/runtime';
+export type { IModelHandler } from './interface';
 export * from './model-helper';
 export * from './locale';
 export { ModelHelper } from './model-helper';
-export { MergeSubModelHelper } from './utils';
+export { MergeSubModelHelper, registerModelHandler, ModelHandler, } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,wBAAwB,CAAC;AAEhC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,wBAAwB,CAAC;AAEhC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,SAAS,CAAC"}

package/out/index.js

@@ -3,4 +3,4 @@ import '@ibiz-template/runtime';
 export * from './model-helper';
 export * from './locale';
 export { ModelHelper } from './model-helper';
-export { MergeSubModelHelper } from './utils';
+export { MergeSubModelHelper, registerModelHandler, ModelHandler, } from './utils';

package/out/interface/i-model-handler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @description 模型处理器
+ * @export
+ * @interface IModelHandler
+ */
+export interface IModelHandler {
+    /**
+     * @description 执行模型处理
+     *
+     * 调用约定：
+     * - 入参 `model` 为当前已处理的模型对象，处理器可就地修改该对象，也可返回一个新的模型对象。
+     * - 返回值将作为下一个处理器的入参，并最终作为该路径模型的最终结果被缓存。
+     * - 若返回 `null`、`undefined` 等假值，将中断当前路径后续处理器的执行，并回退到原始模型。
+     * - 处理器抛出异常时同样会中断后续执行，并回退到原始模型。
+     * @param {IModel} model 当前待处理的模型对象
+     * @returns {IModel} 处理后的模型对象
+     */
+    execute(model: IModel): IModel;
+}
+//# sourceMappingURL=i-model-handler.d.ts.map

package/out/interface/i-model-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-model-handler.d.ts","sourceRoot":"","sources":["../../src/interface/i-model-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC"}

package/out/interface/i-model-handler.js

@@ -0,0 +1 @@
+export {};

package/out/interface/index.d.ts

@@ -0,0 +1,2 @@
+export type { IModelHandler } from './i-model-handler';
+//# sourceMappingURL=index.d.ts.map

package/out/interface/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interface/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/out/interface/index.js

@@ -0,0 +1 @@
+export {};

package/out/locale/en/index.d.ts

@@ -5,6 +5,9 @@ export declare const en: {
             maximumTier: string;
             circularRecursive: string;
             calculatedEntities: string;
+            transformNoModelData: string;
+            transformException: string;
+            tryGetModel: string;
         };
         noInitialized: string;
         noFoundEntity: string;

package/out/locale/en/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/locale/en/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;CAed,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/locale/en/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;CAqBd,CAAC"}

package/out/locale/en/index.js

@@ -5,6 +5,9 @@ export const en = {
             maximumTier: 'Service path calculation exceeds maximum tier 10',
             circularRecursive: 'A circular recursive reference appears in the computational resource relationship path, triggering the entity:',
             calculatedEntities: 'Current list of calculated entities. ',
+            transformNoModelData: '[{dynaModelFilePath}] model transformation exception, no model data returned',
+            transformException: '[{dynaModelFilePath}] model transformation exception',
+            tryGetModel: '[Custom extension model data] Try to get the extension model of path [{dynaModelFilePath}]',
         },
         noInitialized: '[{appId}] is not initialized, please call initModelUtil method to initialize it first',
         noFoundEntity: 'Application [{appId}] data entity not found [{tag}]',

package/out/locale/zh-CN/index.d.ts

@@ -5,6 +5,9 @@ export declare const zhCn: {
             maximumTier: string;
             circularRecursive: string;
             calculatedEntities: string;
+            transformNoModelData: string;
+            transformException: string;
+            tryGetModel: string;
         };
         noInitialized: string;
         noFoundEntity: string;

package/out/locale/zh-CN/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/locale/zh-CN/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI;;;;;;;;;;;;;CAahB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/locale/zh-CN/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;CAiBhB,CAAC"}

package/out/locale/zh-CN/index.js

@@ -5,6 +5,9 @@ export const zhCn = {
             maximumTier: '服务路径计算超过最大层级 10',
             circularRecursive: '计算资源关系路径出现循环递归引用，触发实体：',
             calculatedEntities: '当前已计算过实体清单: ',
+            transformNoModelData: '[{dynaModelFilePath}]模型转化异常，未返回模型数据',
+            transformException: '[{dynaModelFilePath}]模型转化异常',
+            tryGetModel: '[自定义扩展模型数据] 尝试获取路径[{dynaModelFilePath}]的扩展模型',
         },
         noInitialized: '[{appId}]未初始化，请先调用 initModelUtil 方法初始化',
         noFoundEntity: '应用[{appId}]未找到数据实体[{tag}]',

package/out/model-util.d.ts

@@ -164,14 +164,15 @@ export declare class ModelUtil {
      */
     getModel(modelPath: string, params?: IParams, isDynamic?: boolean): Promise<IModel>;
     /**
-     * 递归填充应用标识
+     * 递归填充模型，包括填充模型appId、变换模型
      *
      * @author chitanda
      * @date 2023-08-21 10:08:41
      * @protected
      * @param {IModel} model
+     * @return {*}  {IModel} 返回处理后的模型，若处理器返回新对象则替换原引用
      */
-    protected deepFillAppId(model: IModel): void;
+    protected deepFillModel(model: IModel): IModel;
     /**
      * 计算应用模型请求路径
      *

package/out/model-util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-util.d.ts","sourceRoot":"","sources":["../src/model-util.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,eAAe,EAAE,MAAM,SAAS,CAAC;AAGlE;;;;;;;GAOG;AACH,qBAAa,SAAS;IA0ClB,SAAS,CAAC,KAAK,EAAE,MAAM;IACvB,SAAS,CAAC,QAAQ,EAAE,MAAM;IAC1B,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC;IACjE,SAAS,CAAC,GAAG,EAAE,OAAO;IACtB,SAAS,CAAC,UAAU,EAAE,OAAO;IAC7B,SAAS,CAAC,UAAU,EAAE,OAAO;IA9C/B;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAEtD;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAE5B;;;;;;OAMG;IACH,eAAe,EAAG,eAAe,CAAC;IAElC;;;;;;;;;;OAUG;gBAES,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,EACvD,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,OAAO,EACnB,UAAU,GAAE,OAAc;IAGtC;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C3B;;;;;;;OAOG;cACa,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhD;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAepC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqB3C;;;;;;;;;OASG;IACG,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAc,EACpB,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,MAAM,CAAC;IA8BlB;;;;;;;;;OASG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC;IAiBlB;;;;;;;OAOG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBrD;;;;;;;OAOG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjD;;;;;;;OAOG;IACG,mBAAmB,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWlE;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW/D;;;;;;;OAOG;IACG,eAAe,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW9D;;;;;;;;;OASG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC;IAmBlB;;;;;;;OAOG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmB5C;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM;IAW5E;;;;;;;;;OASG;IACH,SAAS,CAAC,cAAc,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,OAAe,GACzB,MAAM;CAQV"}
+{"version":3,"file":"model-util.d.ts","sourceRoot":"","sources":["../src/model-util.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB;;;;;;;GAOG;AACH,qBAAa,SAAS;IA0ClB,SAAS,CAAC,KAAK,EAAE,MAAM;IACvB,SAAS,CAAC,QAAQ,EAAE,MAAM;IAC1B,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC;IACjE,SAAS,CAAC,GAAG,EAAE,OAAO;IACtB,SAAS,CAAC,UAAU,EAAE,OAAO;IAC7B,SAAS,CAAC,UAAU,EAAE,OAAO;IA9C/B;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAEtD;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,EAAG,MAAM,CAAC;IAE5B;;;;;;OAMG;IACH,eAAe,EAAG,eAAe,CAAC;IAElC;;;;;;;;;;OAUG;gBAES,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,EACvD,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,OAAO,EACnB,UAAU,GAAE,OAAc;IAGtC;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C3B;;;;;;;OAOG;cACa,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhD;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAepC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqB3C;;;;;;;;;OASG;IACG,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAc,EACpB,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,MAAM,CAAC;IA8BlB;;;;;;;;;OASG;IACG,eAAe,CACnB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC;IAiBlB;;;;;;;OAOG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBrD;;;;;;;OAOG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjD;;;;;;;OAOG;IACG,mBAAmB,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWlE;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW/D;;;;;;;OAOG;IACG,eAAe,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW9D;;;;;;;;;OASG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,MAAM,CAAC;IAmBlB;;;;;;;;OAQG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA6B9C;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM;IAW5E;;;;;;;;;OASG;IACH,SAAS,CAAC,cAAc,CACtB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,OAAe,GACzB,MAAM;CAQV"}

package/out/model-util.js

@@ -1,6 +1,6 @@
 import { calcUniqueTag } from '@ibiz/rt-model-api';
 import { isEmpty } from 'ramda';
-import { formatPath, mergeModel, ServicePathUtil } from './utils';
+import { formatPath, mergeModel, ModelTransformer, ServicePathUtil, } from './utils';
 import { PSSysApp } from './model/PSSYSAPP';
 /**
  * 全动模型处理工具类,每个App一个实例
@@ -331,38 +331,46 @@ export class ModelUtil {
             return this.modelCache.get(url);
         }
         const model = await this.get(url, params);
+        const filledModel = this.deepFillModel(model);
         if (!isParams) {
-            this.modelCache.set(url, model);
+            this.modelCache.set(url, filledModel);
         }
-        this.deepFillAppId(model);
-        return model;
+        return filledModel;
     }
     /**
-     * 递归填充应用标识
+     * 递归填充模型，包括填充模型appId、变换模型
      *
      * @author chitanda
      * @date 2023-08-21 10:08:41
      * @protected
      * @param {IModel} model
+     * @return {*}  {IModel} 返回处理后的模型，若处理器返回新对象则替换原引用
      */
-    deepFillAppId(model) {
-        model.appId = this.appId;
-        const keys = Object.keys(model);
+    deepFillModel(model) {
+        // 变换模型
+        let result = model;
+        if (model.dynaModelFilePath) {
+            result = ModelTransformer.getInstance().transform(model.dynaModelFilePath, model);
+        }
+        // 填充模型appId
+        result.appId = this.appId;
+        const keys = Object.keys(result);
         keys.forEach(key => {
-            const value = model[key];
+            const value = result[key];
             if (value && typeof value === 'object') {
                 if (Array.isArray(value)) {
-                    value.forEach(item => {
+                    value.forEach((item, index) => {
                         if (item && typeof item === 'object') {
-                            this.deepFillAppId(item);
+                            value[index] = this.deepFillModel(item);
                         }
                     });
                 }
                 else {
-                    this.deepFillAppId(value);
+                    result[key] = this.deepFillModel(value);
                 }
             }
         });
+        return result;
     }
     /**
      * 计算应用模型请求路径

package/out/utils/index.d.ts

@@ -3,4 +3,7 @@ export { mergeModel } from './merge-model/merge-model';
 export { plural, pluralLower } from './plural/plural';
 export { ServicePathDeep, ServicePathItem, ServicePathUtil, } from './service-path-util/service-path-util';
 export { MergeSubModelHelper } from './merge-model/merge-model-helper';
+export { ModelHandler } from './model-transformer/model-handler';
+export { ModelTransformer } from './model-transformer/model-transformer';
+export { registerModelHandler } from './model-transformer/model-register';
 //# sourceMappingURL=index.d.ts.map

package/out/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC"}

package/out/utils/index.js

@@ -3,3 +3,6 @@ export { mergeModel } from './merge-model/merge-model';
 export { plural, pluralLower } from './plural/plural';
 export { ServicePathUtil, } from './service-path-util/service-path-util';
 export { MergeSubModelHelper } from './merge-model/merge-model-helper';
+export { ModelHandler } from './model-transformer/model-handler';
+export { ModelTransformer } from './model-transformer/model-transformer';
+export { registerModelHandler } from './model-transformer/model-register';

package/out/utils/model-transformer/model-handler.d.ts

@@ -0,0 +1,32 @@
+import { IModelHandler } from '../../interface';
+/**
+ * @description 模型变换处理器
+ * @export
+ * @abstract
+ * @class ModelHandler
+ * @implements {IModelHandler}
+ */
+export declare abstract class ModelHandler implements IModelHandler {
+    /**
+     * @description 优先级，默认值为1
+     * @public
+     * @type {number}
+     * @memberof ModelHandler
+     */
+    priority: number;
+    /**
+     * Creates an instance of ModelHandler.
+     * @param {number} [priority=1] 优先级，数值越小越先执行
+     * @memberof ModelHandler
+     */
+    constructor(priority?: number);
+    /**
+     * @description 执行器
+     * @abstract
+     * @param {IModel} model
+     * @returns {*}  {IModel}
+     * @memberof ModelHandler
+     */
+    abstract execute(model: IModel): IModel;
+}
+//# sourceMappingURL=model-handler.d.ts.map

package/out/utils/model-transformer/model-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/model-transformer/model-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;GAMG;AACH,8BAAsB,YAAa,YAAW,aAAa;IACzD;;;;;OAKG;IACI,QAAQ,EAAE,MAAM,CAAK;IAE5B;;;;OAIG;gBACS,QAAQ,GAAE,MAAU;IAIhC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CACxC"}

package/out/utils/model-transformer/model-handler.js

@@ -0,0 +1,24 @@
+/**
+ * @description 模型变换处理器
+ * @export
+ * @abstract
+ * @class ModelHandler
+ * @implements {IModelHandler}
+ */
+export class ModelHandler {
+    /**
+     * Creates an instance of ModelHandler.
+     * @param {number} [priority=1] 优先级，数值越小越先执行
+     * @memberof ModelHandler
+     */
+    constructor(priority = 1) {
+        /**
+         * @description 优先级，默认值为1
+         * @public
+         * @type {number}
+         * @memberof ModelHandler
+         */
+        this.priority = 1;
+        this.priority = priority;
+    }
+}

package/out/utils/model-transformer/model-register.d.ts

@@ -0,0 +1,9 @@
+import { ModelHandler } from './model-handler';
+/**
+ * @description 注册模型处理器
+ * @export
+ * @param {string} dynaModelFilePath 模型路径
+ * @param {ModelHandler} handler 模型处理器
+ */
+export declare function registerModelHandler(dynaModelFilePath: string, handler: ModelHandler): void;
+//# sourceMappingURL=model-register.d.ts.map

package/out/utils/model-transformer/model-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-register.d.ts","sourceRoot":"","sources":["../../../src/utils/model-transformer/model-register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,YAAY,GACpB,IAAI,CAEN"}

package/out/utils/model-transformer/model-register.js

@@ -0,0 +1,10 @@
+import { ModelTransformer } from './model-transformer';
+/**
+ * @description 注册模型处理器
+ * @export
+ * @param {string} dynaModelFilePath 模型路径
+ * @param {ModelHandler} handler 模型处理器
+ */
+export function registerModelHandler(dynaModelFilePath, handler) {
+    ModelTransformer.getInstance().registerHandler(dynaModelFilePath, handler);
+}

package/out/utils/model-transformer/model-transformer.d.ts

@@ -0,0 +1,55 @@
+import { ModelHandler } from './model-handler';
+/**
+ * @description 模型变换器
+ * @author tony001
+ * @date 2026-08-13 09:08:03
+ * @export
+ * @class ModelTransformer
+ */
+export declare class ModelTransformer {
+    /**
+     * @description 单例变量声明
+     * @private
+     * @static
+     * @type {ModelTransformer}
+     * @memberof ModelTransformer
+     */
+    private static modelTransformer;
+    /**
+     * @description 获取 ModelTransformer 单例对象
+     * @static
+     * @returns {*}  {ModelTransformer}
+     * @memberof ModelTransformer
+     */
+    static getInstance(): ModelTransformer;
+    /**
+     * @description 模型处理器Map
+     * @private
+     * @type {Map<string, ModelHandler[]>}
+     * @memberof ModelTransformer
+     */
+    private handlerMap;
+    /**
+     * @description 模型缓存Map
+     * @private
+     * @type {Map<string, IModel>}
+     * @memberof ModelTransformer
+     */
+    private modelCacheMap;
+    /**
+     * @description 注册模型处理器
+     * @param {string} dynaModelFilePath 模型路径
+     * @param {IModelHandler} handler 执行器
+     * @memberof ModelTransformer
+     */
+    registerHandler(dynaModelFilePath: string, handler: ModelHandler): void;
+    /**
+     * @description 变换模型
+     * @param {string} dynaModelFilePath 模型路径
+     * @param {IModel} model 原始模型
+     * @returns {*}  {IModel}
+     * @memberof ModelTransformer
+     */
+    transform(dynaModelFilePath: string, model: IModel): IModel;
+}
+//# sourceMappingURL=model-transformer.d.ts.map

package/out/utils/model-transformer/model-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-transformer.d.ts","sourceRoot":"","sources":["../../../src/utils/model-transformer/model-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAmB;IAElD;;;;;OAKG;WACW,WAAW,IAAI,gBAAgB;IAO7C;;;;;OAKG;IACH,OAAO,CAAC,UAAU,CAA0C;IAE5D;;;;;OAKG;IACH,OAAO,CAAC,aAAa,CAAkC;IAEvD;;;;;OAKG;IACI,eAAe,CACpB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,YAAY,GACpB,IAAI;IAWP;;;;;;OAMG;IACI,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAgDnE"}

package/out/utils/model-transformer/model-transformer.js

@@ -0,0 +1,102 @@
+/**
+ * @description 模型变换器
+ * @author tony001
+ * @date 2026-08-13 09:08:03
+ * @export
+ * @class ModelTransformer
+ */
+export class ModelTransformer {
+    constructor() {
+        /**
+         * @description 模型处理器Map
+         * @private
+         * @type {Map<string, ModelHandler[]>}
+         * @memberof ModelTransformer
+         */
+        this.handlerMap = new Map();
+        /**
+         * @description 模型缓存Map
+         * @private
+         * @type {Map<string, IModel>}
+         * @memberof ModelTransformer
+         */
+        this.modelCacheMap = new Map();
+    }
+    /**
+     * @description 获取 ModelTransformer 单例对象
+     * @static
+     * @returns {*}  {ModelTransformer}
+     * @memberof ModelTransformer
+     */
+    static getInstance() {
+        if (!this.modelTransformer) {
+            this.modelTransformer = new ModelTransformer();
+        }
+        return this.modelTransformer;
+    }
+    /**
+     * @description 注册模型处理器
+     * @param {string} dynaModelFilePath 模型路径
+     * @param {IModelHandler} handler 执行器
+     * @memberof ModelTransformer
+     */
+    registerHandler(dynaModelFilePath, handler) {
+        const handlers = this.handlerMap.get(dynaModelFilePath);
+        if (handlers) {
+            handlers.push(handler);
+        }
+        else {
+            this.handlerMap.set(dynaModelFilePath, [handler]);
+        }
+        // 注册新处理器后清除该路径的模型缓存，确保新处理器能生效
+        this.modelCacheMap.delete(dynaModelFilePath);
+    }
+    /**
+     * @description 变换模型
+     * @param {string} dynaModelFilePath 模型路径
+     * @param {IModel} model 原始模型
+     * @returns {*}  {IModel}
+     * @memberof ModelTransformer
+     */
+    transform(dynaModelFilePath, model) {
+        ibiz.log.debug(ibiz.i18n.t('modelHelper.utils.tryGetModel', {
+            dynaModelFilePath,
+        }));
+        if (this.modelCacheMap.has(dynaModelFilePath)) {
+            return this.modelCacheMap.get(dynaModelFilePath);
+        }
+        const handlers = this.handlerMap.get(dynaModelFilePath);
+        if (!handlers || handlers.length === 0) {
+            this.modelCacheMap.set(dynaModelFilePath, model);
+            return model;
+        }
+        // 按照优先级升序排序，优先级高的后执行
+        const sortedHandlers = [...handlers].sort((a, b) => a.priority - b.priority);
+        // 模型处理
+        let result = model;
+        for (const handler of sortedHandlers) {
+            try {
+                const next = handler.execute(result);
+                if (next) {
+                    result = next;
+                }
+                else {
+                    ibiz.log.error(ibiz.i18n.t('modelHelper.utils.transformNoModelData', {
+                        dynaModelFilePath,
+                    }));
+                    // 未返回模型数据时返回传入的原始模型，防止界面异常
+                    return model;
+                }
+            }
+            catch (error) {
+                ibiz.log.error(ibiz.i18n.t('modelHelper.utils.transformException', {
+                    dynaModelFilePath,
+                }), error);
+                // 执行异常时返回传入的原始模型，防止界面异常
+                return model;
+            }
+        }
+        this.modelCacheMap.set(dynaModelFilePath, result);
+        return result;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibiz-template/model-helper",
-  "version": "0.7.41-alpha.124",
+  "version": "0.7.41-alpha.126",
   "description": "模型辅助库",
   "main": "out/index.js",
   "types": "out/index.d.ts",
@@ -38,7 +38,7 @@
     "ramda": "^0.29.1"
   },
   "devDependencies": {
-    "@ibiz-template/runtime": "^0.7.41-alpha.124",
+    "@ibiz-template/runtime": "^0.7.41-alpha.126",
     "@types/pluralize": "^0.0.33",
     "@types/ramda": "^0.29.10"
   },
@@ -46,5 +46,5 @@
     "@ibiz-template/runtime": "^0.6.0",
     "ramda": "^0.29.0"
   },
-  "gitHead": "a0501c822177c396a8209d3cee75a9a2c494e46a"
+  "gitHead": "1dc811502125ae2ca520bc1ad303a1a8d5b63b66"
 }

package/src/index.ts

@@ -1,7 +1,12 @@
 import '@ibiz/model-core';
 import '@ibiz-template/runtime';
 
+export type { IModelHandler } from './interface';
 export * from './model-helper';
 export * from './locale';
 export { ModelHelper } from './model-helper';
-export { MergeSubModelHelper } from './utils';
+export {
+  MergeSubModelHelper,
+  registerModelHandler,
+  ModelHandler,
+} from './utils';

package/src/interface/i-model-handler.ts

@@ -0,0 +1,19 @@
+/**
+ * @description 模型处理器
+ * @export
+ * @interface IModelHandler
+ */
+export interface IModelHandler {
+  /**
+   * @description 执行模型处理
+   *
+   * 调用约定：
+   * - 入参 `model` 为当前已处理的模型对象，处理器可就地修改该对象，也可返回一个新的模型对象。
+   * - 返回值将作为下一个处理器的入参，并最终作为该路径模型的最终结果被缓存。
+   * - 若返回 `null`、`undefined` 等假值，将中断当前路径后续处理器的执行，并回退到原始模型。
+   * - 处理器抛出异常时同样会中断后续执行，并回退到原始模型。
+   * @param {IModel} model 当前待处理的模型对象
+   * @returns {IModel} 处理后的模型对象
+   */
+  execute(model: IModel): IModel;
+}

package/src/interface/index.ts

@@ -0,0 +1 @@
+export type { IModelHandler } from './i-model-handler';

package/src/locale/en/index.ts

@@ -6,6 +6,12 @@ export const en = {
       circularRecursive:
         'A circular recursive reference appears in the computational resource relationship path, triggering the entity:',
       calculatedEntities: 'Current list of calculated entities. ',
+      transformNoModelData:
+        '[{dynaModelFilePath}] model transformation exception, no model data returned',
+      transformException:
+        '[{dynaModelFilePath}] model transformation exception',
+      tryGetModel:
+        '[Custom extension model data] Try to get the extension model of path [{dynaModelFilePath}]',
     },
     noInitialized:
       '[{appId}] is not initialized, please call initModelUtil method to initialize it first',

package/src/locale/zh-CN/index.ts

@@ -5,6 +5,10 @@ export const zhCn = {
       maximumTier: '服务路径计算超过最大层级 10',
       circularRecursive: '计算资源关系路径出现循环递归引用，触发实体：',
       calculatedEntities: '当前已计算过实体清单: ',
+      transformNoModelData: '[{dynaModelFilePath}]模型转化异常，未返回模型数据',
+      transformException: '[{dynaModelFilePath}]模型转化异常',
+      tryGetModel:
+        '[自定义扩展模型数据] 尝试获取路径[{dynaModelFilePath}]的扩展模型',
     },
     noInitialized: '[{appId}]未初始化，请先调用 initModelUtil 方法初始化',
     noFoundEntity: '应用[{appId}]未找到数据实体[{tag}]',