@ibiz-template/model-helper 0.7.41-alpha.13 → 0.7.41-alpha.130

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} pathPattern 路径表达式
+ * @param {ModelHandler} handler 模型处理器
+ */
+export declare function registerModelHandler(pathPattern: 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,WAAW,EAAE,MAAM,EACnB,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} pathPattern 路径表达式
+ * @param {ModelHandler} handler 模型处理器
+ */
+export function registerModelHandler(pathPattern, handler) {
+    ModelTransformer.getInstance().registerHandler(pathPattern, handler);
+}

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

@@ -0,0 +1,63 @@
+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 路径匹配器（支持通配符路径匹配）
+     * @private
+     * @type {ReturnType<typeof AntPathMatcher>}
+     * @memberof ModelTransformer
+     */
+    private pathMatcher;
+    /**
+     * @description 注册模型处理器
+     * @param {string} pathPattern 路径表达式（奇数位路径段支持通配符）
+     * @param {IModelHandler} handler 执行器
+     * @memberof ModelTransformer
+     */
+    registerHandler(pathPattern: string, handler: ModelHandler): void;
+    /**
+     * @description 校验模型路径，从0开始数，偶数位路径段（如PSSYSAPPS、PSAPPDATAENTITIES等类型段）不允许使用通配符，奇数位路径段可使用
+     * @private
+     * @param {string} pathPattern 路径表达式
+     * @returns {*}  {boolean}
+     * @memberof ModelTransformer
+     */
+    private validatePattern;
+    /**
+     * @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":"AACA,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,WAAW,CAAoB;IAEvC;;;;;OAKG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAYxE;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;;;;OAMG;IACI,SAAS,CAAC,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAiDnE"}

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

@@ -0,0 +1,125 @@
+import AntPathMatcher from '@maxbilbow/ant-path-matcher';
+/**
+ * @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 路径匹配器（支持通配符路径匹配）
+         * @private
+         * @type {ReturnType<typeof AntPathMatcher>}
+         * @memberof ModelTransformer
+         */
+        this.pathMatcher = AntPathMatcher();
+    }
+    /**
+     * @description 获取 ModelTransformer 单例对象
+     * @static
+     * @returns {*}  {ModelTransformer}
+     * @memberof ModelTransformer
+     */
+    static getInstance() {
+        if (!this.modelTransformer) {
+            this.modelTransformer = new ModelTransformer();
+        }
+        return this.modelTransformer;
+    }
+    /**
+     * @description 注册模型处理器
+     * @param {string} pathPattern 路径表达式（奇数位路径段支持通配符）
+     * @param {IModelHandler} handler 执行器
+     * @memberof ModelTransformer
+     */
+    registerHandler(pathPattern, handler) {
+        if (!this.validatePattern(pathPattern)) {
+            return;
+        }
+        const handlers = this.handlerMap.get(pathPattern);
+        if (handlers) {
+            handlers.push(handler);
+        }
+        else {
+            this.handlerMap.set(pathPattern, [handler]);
+        }
+    }
+    /**
+     * @description 校验模型路径，从0开始数，偶数位路径段（如PSSYSAPPS、PSAPPDATAENTITIES等类型段）不允许使用通配符，奇数位路径段可使用
+     * @private
+     * @param {string} pathPattern 路径表达式
+     * @returns {*}  {boolean}
+     * @memberof ModelTransformer
+     */
+    validatePattern(pathPattern) {
+        const segments = pathPattern.split('/');
+        const isValid = segments.every((segment, index) => {
+            // 偶数位不允许出现通配符，奇数位有无通配符均可
+            return index % 2 === 1 || !/[*?]/.test(segment);
+        });
+        if (!isValid) {
+            ibiz.log.error(ibiz.i18n.t('modelHelper.utils.invalidPathPattern', {
+                pathPattern,
+            }));
+        }
+        return isValid;
+    }
+    /**
+     * @description 变换模型
+     * @param {string} dynaModelFilePath 模型路径
+     * @param {IModel} model 原始模型
+     * @returns {*}  {IModel}
+     * @memberof ModelTransformer
+     */
+    transform(dynaModelFilePath, model) {
+        ibiz.log.debug(ibiz.i18n.t('modelHelper.utils.tryGetModel', {
+            dynaModelFilePath,
+        }));
+        // 收集所有匹配当前路径的处理器（支持通配符路径）
+        const matchedHandlers = [];
+        this.handlerMap.forEach((handlers, pattern) => {
+            if (this.pathMatcher.match(pattern, dynaModelFilePath)) {
+                matchedHandlers.push(...handlers);
+            }
+        });
+        if (matchedHandlers.length === 0) {
+            return model;
+        }
+        // 按照优先级升序排序，优先级高的后执行
+        const sortedHandlers = [...matchedHandlers].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;
+            }
+        }
+        return result;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibiz-template/model-helper",
-  "version": "0.7.41-alpha.13",
+  "version": "0.7.41-alpha.130",
   "description": "模型辅助库",
   "main": "out/index.js",
   "types": "out/index.d.ts",
@@ -9,6 +9,7 @@
   "files": [
     "dist",
     "out",
+    "src",
     "README.md"
   ],
   "scripts": {
@@ -30,14 +31,15 @@
   "author": "iBiz",
   "license": "MIT",
   "dependencies": {
-    "@ibiz-template/core": "^0.7.41-alpha.12",
-    "@ibiz/model-core": "^0.1.79",
-    "@ibiz/rt-model-api": "0.2.77",
+    "@ibiz-template/core": "^0.7.41-alpha.119",
+    "@ibiz/model-core": "^0.1.89",
+    "@ibiz/rt-model-api": "0.2.90",
+    "@maxbilbow/ant-path-matcher": "0.0.2",
     "pluralize": "^8.0.0",
     "ramda": "^0.29.1"
   },
   "devDependencies": {
-    "@ibiz-template/runtime": "^0.7.41-alpha.13",
+    "@ibiz-template/runtime": "^0.7.41-alpha.130",
     "@types/pluralize": "^0.0.33",
     "@types/ramda": "^0.29.10"
   },
@@ -45,5 +47,5 @@
     "@ibiz-template/runtime": "^0.6.0",
     "ramda": "^0.29.0"
   },
-  "gitHead": "ca5d3c23544b7a4e956c8c78d9545bfaa8bfadd9"
+  "gitHead": "884c135f203cf1a0ae3977442b559b757acd6b47"
 }

package/src/index.ts

@@ -0,0 +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,
+  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

@@ -0,0 +1,24 @@
+export const en = {
+  modelHelper: {
+    utils: {
+      noFoundEntity: 'Entity not found {id}',
+      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}]',
+      invalidPathPattern:
+        '[Model handler path validation failed]: wildcards are not allowed in even-position path segments, [{pathPattern}] registration skipped',
+    },
+    noInitialized:
+      '[{appId}] is not initialized, please call initModelUtil method to initialize it first',
+    noFoundEntity: 'Application [{appId}] data entity not found [{tag}]',
+    noFoundView: 'Application [{appId}] view not found [{tag}]',
+    noSupported: '[{language}] language not supported',
+  },
+};

package/src/locale/index.ts

@@ -0,0 +1,2 @@
+export { en } from './en';
+export { zhCn } from './zh-CN';

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

@@ -0,0 +1,20 @@
+export const zhCn = {
+  modelHelper: {
+    utils: {
+      noFoundEntity: '未找到实体 {id}',
+      maximumTier: '服务路径计算超过最大层级 10',
+      circularRecursive: '计算资源关系路径出现循环递归引用，触发实体：',
+      calculatedEntities: '当前已计算过实体清单: ',
+      transformNoModelData: '[{dynaModelFilePath}]模型转化异常，未返回模型数据',
+      transformException: '[{dynaModelFilePath}]模型转化异常',
+      tryGetModel:
+        '[自定义扩展模型数据] 尝试获取路径[{dynaModelFilePath}]的扩展模型',
+      invalidPathPattern:
+        '[模型处理器校验路径失败]，偶数位路径段不允许使用通配符，[{pathPattern}]已跳过注册',
+    },
+    noInitialized: '[{appId}]未初始化，请先调用 initModelUtil 方法初始化',
+    noFoundEntity: '应用[{appId}]未找到数据实体[{tag}]',
+    noFoundView: '应用[{appId}]未找到视图[{tag}]',
+    noSupported: '[{language}]语言未支持',
+  },
+};

package/src/model/PSSYSAPP.ts

@@ -0,0 +1,12 @@
+export const PSSysApp: IModel = {
+  getAllPSAppDEUIActions: {
+    New: {
+      refreshMode: 1,
+      reloadData: true,
+      showBusyIndicator: true,
+    },
+    Save: {
+      showBusyIndicator: false,
+    },
+  },
+};