@siliconst/metaui 1.4.21 → 1.4.37

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer-dbg.js

@@ -0,0 +1,142 @@
+sap.ui.define(["./PluginRegistry", "../utils/Logger", "../constants/MetaUIConstants"], function (___PluginRegistry, ___utils_Logger, ___constants_MetaUIConstants) {
+  "use strict";
+
+  /**
+   * @file LayoutScorer.ts
+   * @description Core utility that calculates the nested footprint score of schemas 
+   * to determine if they should be rendered inline or overflowed into a dialog button.
+   */
+  const PluginRegistry = ___PluginRegistry["PluginRegistry"];
+  const Logger = ___utils_Logger["Logger"];
+  const RENDER_MODE = ___constants_MetaUIConstants["RENDER_MODE"];
+  const SCHEMA_TYPE = ___constants_MetaUIConstants["SCHEMA_TYPE"];
+  const OPENAPI_PREFIX = ___constants_MetaUIConstants["OPENAPI_PREFIX"];
+  const WIDGET_TYPE = ___constants_MetaUIConstants["WIDGET_TYPE"];
+  class LayoutScorer {
+    /**
+     * Recursively computes scores and annotates the schema with `renderMode`.
+     * 
+     * @param schema The normalized schema root.
+     * @param budget The remaining layout budget (e.g., 50).
+     */
+    static apply(schema, budget, schemaDefinitions) {
+      if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).
+
+      const visited = new WeakSet();
+      const activeRefs = new Set();
+
+      // We only score the root properties (not the root object itself).
+      if (schema.properties) {
+        for (const key in schema.properties) {
+          const prop = schema.properties[key];
+          if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {
+            this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);
+          }
+        }
+      }
+    }
+
+    /**
+     * Traverses a node, computing its total footprint.
+     * If the score > budget, forces `renderMode = "dialog"`.
+     * If the score <= budget, forces `renderMode = "inline"`.
+     */
+    static _scoreNode(node, budget, visited, activeRefs, path, schemaDefinitions) {
+      if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;
+      if (visited.has(node)) {
+        Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, "", "LayoutScorer");
+        node.ui = node.ui || {};
+        node.ui.renderMode = RENDER_MODE.DIALOG;
+        node.ui.layoutBudget = budget;
+        return 1; // A dialog button is just 1 unit
+      }
+      visited.add(node);
+      if (node.$ref && schemaDefinitions) {
+        let key = node.$ref;
+        if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);
+        if (activeRefs.has(key)) {
+          Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, "", "LayoutScorer");
+          node.ui = node.ui || {};
+          node.ui.renderMode = RENDER_MODE.DIALOG;
+          return 1;
+        }
+        const resolvedOriginal = schemaDefinitions[key];
+        if (resolvedOriginal) {
+          activeRefs.add(key);
+
+          // Deep clone it BEFORE scoring so we don't mutate the global dictionary
+          const resolved = JSON.parse(JSON.stringify(resolvedOriginal));
+          const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);
+          activeRefs.delete(key);
+          node.ui = node.ui || {};
+          node.ui.layoutBudget = budget;
+          if (resolvedScore <= budget) {
+            // Merge it permanently in the layout!
+            Object.assign(node, resolved);
+            delete node.$ref;
+            if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;
+            node.ui.renderMode = RENDER_MODE.INLINE;
+            visited.delete(node);
+            return resolvedScore;
+          } else {
+            node.ui.renderMode = RENDER_MODE.DIALOG;
+            visited.delete(node);
+            return 1;
+          }
+        }
+      }
+      if (node.type === SCHEMA_TYPE.ARRAY) {
+        let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);
+
+        // Traverse array items!
+        if (node.items) {
+          const itemsSchema = node.items;
+          if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {
+            arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);
+          }
+        }
+        node.ui = node.ui || {};
+        node.ui.layoutBudget = budget;
+        if (arrayScore <= budget) {
+          node.ui.renderMode = RENDER_MODE.INLINE;
+          visited.delete(node);
+          return arrayScore;
+        } else {
+          node.ui.renderMode = RENDER_MODE.DIALOG;
+          visited.delete(node);
+          return 1;
+        }
+      }
+      let totalScore = 0;
+      if (node.properties) {
+        for (const key in node.properties) {
+          const child = node.properties[key];
+          if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {
+            totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);
+          } else {
+            totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);
+          }
+        }
+      } else {
+        // An open dictionary (additionalProperties) is scored as a single table
+        totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap
+      }
+      node.ui = node.ui || {};
+      node.ui.layoutBudget = budget;
+      visited.delete(node);
+      if (totalScore <= budget) {
+        node.ui.renderMode = RENDER_MODE.INLINE;
+        return totalScore;
+      } else {
+        node.ui.renderMode = RENDER_MODE.DIALOG;
+        return 1; // It collapsed into an "Edit Details" button
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.LayoutScorer = LayoutScorer;
+  return __exports;
+});
+//# sourceMappingURL=LayoutScorer-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutScorer-dbg.js","names":["PluginRegistry","___PluginRegistry","Logger","___utils_Logger","RENDER_MODE","___constants_MetaUIConstants","SCHEMA_TYPE","OPENAPI_PREFIX","WIDGET_TYPE","LayoutScorer","apply","schema","budget","schemaDefinitions","visited","WeakSet","activeRefs","Set","properties","key","prop","type","OBJECT","ARRAY","$ref","_scoreNode","node","path","has","warn","ui","renderMode","DIALOG","layoutBudget","add","startsWith","DEFINITIONS","substring","length","COMPONENTS_SCHEMAS","resolvedOriginal","resolved","JSON","parse","stringify","resolvedScore","delete","Object","assign","widget","REFERENCE","INLINE","arrayScore","getInstance","getPluginScore","items","itemsSchema","totalScore","child","STRING","__exports","__esModule"],"sources":["LayoutScorer.ts"],"sourcesContent":["/**\n * @file LayoutScorer.ts\n * @description Core utility that calculates the nested footprint score of schemas \n * to determine if they should be rendered inline or overflowed into a dialog button.\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport { Logger } from \"../utils/Logger\";\nimport { RENDER_MODE, SCHEMA_TYPE, OPENAPI_PREFIX, WIDGET_TYPE } from \"../constants/MetaUIConstants\";\n\nexport class LayoutScorer {\n    /**\n     * Recursively computes scores and annotates the schema with `renderMode`.\n     * \n     * @param schema The normalized schema root.\n     * @param budget The remaining layout budget (e.g., 50).\n     */\n    public static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void {\n        if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).\n\n        const visited = new WeakSet<object>();\n        const activeRefs = new Set<string>();\n\n        // We only score the root properties (not the root object itself).\n        if (schema.properties) {\n            for (const key in schema.properties) {\n                const prop = schema.properties[key];\n                if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {\n                    this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);\n                }\n            }\n        }\n    }\n\n    /**\n     * Traverses a node, computing its total footprint.\n     * If the score > budget, forces `renderMode = \"dialog\"`.\n     * If the score <= budget, forces `renderMode = \"inline\"`.\n     */\n    private static _scoreNode(node: IPropertyMetadata, budget: number, visited: WeakSet<object>, activeRefs: Set<string>, path: string, schemaDefinitions?: Record<string, ISchema>): number {\n        if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;\n\n        if (visited.has(node)) {\n            Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n            node.ui = node.ui || {};\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            node.ui.layoutBudget = budget;\n            return 1; // A dialog button is just 1 unit\n        }\n        visited.add(node);\n\n        if (node.$ref && schemaDefinitions) {\n            let key = node.$ref;\n            if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);\n            else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);\n\n            if (activeRefs.has(key)) {\n                Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n                node.ui = node.ui || {};\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                return 1;\n            }\n\n            const resolvedOriginal = schemaDefinitions[key];\n            if (resolvedOriginal) {\n                activeRefs.add(key);\n                \n                // Deep clone it BEFORE scoring so we don't mutate the global dictionary\n                const resolved = JSON.parse(JSON.stringify(resolvedOriginal));\n                \n                const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);\n                activeRefs.delete(key);\n                \n                node.ui = node.ui || {};\n                node.ui.layoutBudget = budget;\n                if (resolvedScore <= budget) {\n                    // Merge it permanently in the layout!\n                    Object.assign(node, resolved);\n                    delete node.$ref;\n                    if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;\n                    \n                    node.ui.renderMode = RENDER_MODE.INLINE;\n                    visited.delete(node);\n                    return resolvedScore;\n                } else {\n                    node.ui.renderMode = RENDER_MODE.DIALOG;\n                    visited.delete(node);\n                    return 1;\n                }\n            }\n        }\n\n        if (node.type === SCHEMA_TYPE.ARRAY) {\n            let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);\n            \n            // Traverse array items!\n            if (node.items) {\n                const itemsSchema = node.items as ISchema;\n                if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {\n                    arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);\n                }\n            }\n\n            node.ui = node.ui || {};\n            node.ui.layoutBudget = budget;\n            if (arrayScore <= budget) {\n                node.ui.renderMode = RENDER_MODE.INLINE;\n                visited.delete(node);\n                return arrayScore;\n            } else {\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                visited.delete(node);\n                return 1;\n            }\n        }\n\n        let totalScore = 0;\n\n        if (node.properties) {\n            for (const key in node.properties) {\n                const child = node.properties[key] as IPropertyMetadata;\n                if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {\n                    totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);\n                } else {\n                    totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);\n                }\n            }\n        } else {\n            // An open dictionary (additionalProperties) is scored as a single table\n            totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap\n        }\n\n        node.ui = node.ui || {};\n        node.ui.layoutBudget = budget;\n        \n        visited.delete(node);\n\n        if (totalScore <= budget) {\n            node.ui.renderMode = RENDER_MODE.INLINE;\n            return totalScore;\n        } else {\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            return 1; // It collapsed into an \"Edit Details\" button\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.d.ts

@@ -0,0 +1,24 @@
+declare module "nz/co/siliconst/ui5/metaui/core/LayoutScorer" {
+    /**
+     * @file LayoutScorer.ts
+     * @description Core utility that calculates the nested footprint score of schemas
+     * to determine if they should be rendered inline or overflowed into a dialog button.
+     */
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    export class LayoutScorer {
+        /**
+         * Recursively computes scores and annotates the schema with `renderMode`.
+         *
+         * @param schema The normalized schema root.
+         * @param budget The remaining layout budget (e.g., 50).
+         */
+        static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void;
+        /**
+         * Traverses a node, computing its total footprint.
+         * If the score > budget, forces `renderMode = "dialog"`.
+         * If the score <= budget, forces `renderMode = "inline"`.
+         */
+        private static _scoreNode;
+    }
+}
+//# sourceMappingURL=LayoutScorer.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutScorer.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;;OAIG;IAEH,OAAO,EAAE,OAAO,EAAqB,MAAM,+CAA+C,CAAC;IAK3F,MAAa,YAAY;QACrB;;;;;WAKG;eACW,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;QAiB9G;;;;WAIG;QACH,OAAO,CAAC,MAAM,CAAC,UAAU;KA0G5B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./PluginRegistry","../utils/Logger","../constants/MetaUIConstants"],function(e,t,r){"use strict";const i=e["PluginRegistry"];const o=t["Logger"];const s=r["RENDER_MODE"];const n=r["SCHEMA_TYPE"];const u=r["OPENAPI_PREFIX"];const d=r["WIDGET_TYPE"];class c{static apply(e,t,r){if(!e||t<=0)return;const i=new WeakSet;const o=new Set;if(e.properties){for(const s in e.properties){const u=e.properties[s];if(u.type===n.OBJECT||u.type===n.ARRAY||u.$ref){this._scoreNode(u,t,i,o,s,r)}}}}static _scoreNode(e,t,r,c,a,g){if(!e||typeof e!==n.OBJECT)return 0;if(r.has(e)){o.warn(`[MetaUI LayoutScorer] Circular reference detected at '${a}'. Forcing dialog mode to prevent crash.`,"","LayoutScorer");e.ui=e.ui||{};e.ui.renderMode=s.DIALOG;e.ui.layoutBudget=t;return 1}r.add(e);if(e.$ref&&g){let i=e.$ref;if(i.startsWith(u.DEFINITIONS))i=i.substring(u.DEFINITIONS.length);else if(i.startsWith(u.COMPONENTS_SCHEMAS))i=i.substring(u.COMPONENTS_SCHEMAS.length);if(c.has(i)){o.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${a}' for '${i}'. Forcing dialog mode to prevent crash.`,"","LayoutScorer");e.ui=e.ui||{};e.ui.renderMode=s.DIALOG;return 1}const n=g[i];if(n){c.add(i);const o=JSON.parse(JSON.stringify(n));const u=this._scoreNode(o,t,r,c,a,g);c.delete(i);e.ui=e.ui||{};e.ui.layoutBudget=t;if(u<=t){Object.assign(e,o);delete e.$ref;if(e.ui?.widget===d.REFERENCE)delete e.ui.widget;e.ui.renderMode=s.INLINE;r.delete(e);return u}else{e.ui.renderMode=s.DIALOG;r.delete(e);return 1}}}if(e.type===n.ARRAY){let o=i.getInstance().getPluginScore(n.ARRAY,e.ui?.widget);if(e.items){const i=e.items;if(i.type===n.OBJECT||i.type===n.ARRAY||i.$ref){o+=this._scoreNode(i,t,r,c,`${a}/items`,g)}}e.ui=e.ui||{};e.ui.layoutBudget=t;if(o<=t){e.ui.renderMode=s.INLINE;r.delete(e);return o}else{e.ui.renderMode=s.DIALOG;r.delete(e);return 1}}let l=0;if(e.properties){for(const o in e.properties){const s=e.properties[o];if(s.type===n.OBJECT||s.type===n.ARRAY||s.$ref){l+=this._scoreNode(s,t,r,c,`${a}/${o}`,g)}else{l+=i.getInstance().getPluginScore(s.type||n.STRING,s.ui?.widget)}}}else{l+=i.getInstance().getPluginScore(n.OBJECT,e.ui?.widget)}e.ui=e.ui||{};e.ui.layoutBudget=t;r.delete(e);if(l<=t){e.ui.renderMode=s.INLINE;return l}else{e.ui.renderMode=s.DIALOG;return 1}}}var a={__esModule:true};a.LayoutScorer=c;return a});
+//# sourceMappingURL=LayoutScorer.js.map

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutScorer.js","names":["PluginRegistry","___PluginRegistry","Logger","___utils_Logger","RENDER_MODE","___constants_MetaUIConstants","SCHEMA_TYPE","OPENAPI_PREFIX","WIDGET_TYPE","LayoutScorer","apply","schema","budget","schemaDefinitions","visited","WeakSet","activeRefs","Set","properties","key","prop","type","OBJECT","ARRAY","$ref","this","_scoreNode","node","path","has","warn","ui","renderMode","DIALOG","layoutBudget","add","startsWith","DEFINITIONS","substring","length","COMPONENTS_SCHEMAS","resolvedOriginal","resolved","JSON","parse","stringify","resolvedScore","delete","Object","assign","widget","REFERENCE","INLINE","arrayScore","getInstance","getPluginScore","items","itemsSchema","totalScore","child","STRING","__exports","__esModule"],"sources":["LayoutScorer.ts"],"sourcesContent":["/**\n * @file LayoutScorer.ts\n * @description Core utility that calculates the nested footprint score of schemas \n * to determine if they should be rendered inline or overflowed into a dialog button.\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport { Logger } from \"../utils/Logger\";\nimport { RENDER_MODE, SCHEMA_TYPE, OPENAPI_PREFIX, WIDGET_TYPE } from \"../constants/MetaUIConstants\";\n\nexport class LayoutScorer {\n    /**\n     * Recursively computes scores and annotates the schema with `renderMode`.\n     * \n     * @param schema The normalized schema root.\n     * @param budget The remaining layout budget (e.g., 50).\n     */\n    public static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void {\n        if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).\n\n        const visited = new WeakSet<object>();\n        const activeRefs = new Set<string>();\n\n        // We only score the root properties (not the root object itself).\n        if (schema.properties) {\n            for (const key in schema.properties) {\n                const prop = schema.properties[key];\n                if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {\n                    this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);\n                }\n            }\n        }\n    }\n\n    /**\n     * Traverses a node, computing its total footprint.\n     * If the score > budget, forces `renderMode = \"dialog\"`.\n     * If the score <= budget, forces `renderMode = \"inline\"`.\n     */\n    private static _scoreNode(node: IPropertyMetadata, budget: number, visited: WeakSet<object>, activeRefs: Set<string>, path: string, schemaDefinitions?: Record<string, ISchema>): number {\n        if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;\n\n        if (visited.has(node)) {\n            Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n            node.ui = node.ui || {};\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            node.ui.layoutBudget = budget;\n            return 1; // A dialog button is just 1 unit\n        }\n        visited.add(node);\n\n        if (node.$ref && schemaDefinitions) {\n            let key = node.$ref;\n            if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);\n            else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);\n\n            if (activeRefs.has(key)) {\n                Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, \"\", \"LayoutScorer\");\n                node.ui = node.ui || {};\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                return 1;\n            }\n\n            const resolvedOriginal = schemaDefinitions[key];\n            if (resolvedOriginal) {\n                activeRefs.add(key);\n                \n                // Deep clone it BEFORE scoring so we don't mutate the global dictionary\n                const resolved = JSON.parse(JSON.stringify(resolvedOriginal));\n                \n                const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);\n                activeRefs.delete(key);\n                \n                node.ui = node.ui || {};\n                node.ui.layoutBudget = budget;\n                if (resolvedScore <= budget) {\n                    // Merge it permanently in the layout!\n                    Object.assign(node, resolved);\n                    delete node.$ref;\n                    if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;\n                    \n                    node.ui.renderMode = RENDER_MODE.INLINE;\n                    visited.delete(node);\n                    return resolvedScore;\n                } else {\n                    node.ui.renderMode = RENDER_MODE.DIALOG;\n                    visited.delete(node);\n                    return 1;\n                }\n            }\n        }\n\n        if (node.type === SCHEMA_TYPE.ARRAY) {\n            let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);\n            \n            // Traverse array items!\n            if (node.items) {\n                const itemsSchema = node.items as ISchema;\n                if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {\n                    arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);\n                }\n            }\n\n            node.ui = node.ui || {};\n            node.ui.layoutBudget = budget;\n            if (arrayScore <= budget) {\n                node.ui.renderMode = RENDER_MODE.INLINE;\n                visited.delete(node);\n                return arrayScore;\n            } else {\n                node.ui.renderMode = RENDER_MODE.DIALOG;\n                visited.delete(node);\n                return 1;\n            }\n        }\n\n        let totalScore = 0;\n\n        if (node.properties) {\n            for (const key in node.properties) {\n                const child = node.properties[key] as IPropertyMetadata;\n                if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {\n                    totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);\n                } else {\n                    totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);\n                }\n            }\n        } else {\n            // An open dictionary (additionalProperties) is scored as a single table\n            totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap\n        }\n\n        node.ui = node.ui || {};\n        node.ui.layoutBudget = budget;\n        \n        visited.delete(node);\n\n        if (totalScore <= budget) {\n            node.ui.renderMode = RENDER_MODE.INLINE;\n            return totalScore;\n        } else {\n            node.ui.renderMode = RENDER_MODE.DIALOG;\n            return 1; // It collapsed into an \"Edit Details\" button\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/LayoutScorer.ts

@@ -0,0 +1,147 @@
+/**
+ * @file LayoutScorer.ts
+ * @description Core utility that calculates the nested footprint score of schemas 
+ * to determine if they should be rendered inline or overflowed into a dialog button.
+ */
+
+import { ISchema, IPropertyMetadata } from "../interfaces/ISchema";
+import { PluginRegistry } from "./PluginRegistry";
+import { Logger } from "../utils/Logger";
+import { RENDER_MODE, SCHEMA_TYPE, OPENAPI_PREFIX, WIDGET_TYPE } from "../constants/MetaUIConstants";
+
+export class LayoutScorer {
+    /**
+     * Recursively computes scores and annotates the schema with `renderMode`.
+     * 
+     * @param schema The normalized schema root.
+     * @param budget The remaining layout budget (e.g., 50).
+     */
+    public static apply(schema: ISchema | null, budget: number, schemaDefinitions?: Record<string, ISchema>): void {
+        if (!schema || budget <= 0) return; // 0 budget means default fallback (no inline budget logic).
+
+        const visited = new WeakSet<object>();
+        const activeRefs = new Set<string>();
+
+        // We only score the root properties (not the root object itself).
+        if (schema.properties) {
+            for (const key in schema.properties) {
+                const prop = schema.properties[key];
+                if (prop.type === SCHEMA_TYPE.OBJECT || prop.type === SCHEMA_TYPE.ARRAY || prop.$ref) {
+                    this._scoreNode(prop, budget, visited, activeRefs, key, schemaDefinitions);
+                }
+            }
+        }
+    }
+
+    /**
+     * Traverses a node, computing its total footprint.
+     * If the score > budget, forces `renderMode = "dialog"`.
+     * If the score <= budget, forces `renderMode = "inline"`.
+     */
+    private static _scoreNode(node: IPropertyMetadata, budget: number, visited: WeakSet<object>, activeRefs: Set<string>, path: string, schemaDefinitions?: Record<string, ISchema>): number {
+        if (!node || typeof node !== SCHEMA_TYPE.OBJECT) return 0;
+
+        if (visited.has(node)) {
+            Logger.warn(`[MetaUI LayoutScorer] Circular reference detected at '${path}'. Forcing dialog mode to prevent crash.`, "", "LayoutScorer");
+            node.ui = node.ui || {};
+            node.ui.renderMode = RENDER_MODE.DIALOG;
+            node.ui.layoutBudget = budget;
+            return 1; // A dialog button is just 1 unit
+        }
+        visited.add(node);
+
+        if (node.$ref && schemaDefinitions) {
+            let key = node.$ref;
+            if (key.startsWith(OPENAPI_PREFIX.DEFINITIONS)) key = key.substring(OPENAPI_PREFIX.DEFINITIONS.length);
+            else if (key.startsWith(OPENAPI_PREFIX.COMPONENTS_SCHEMAS)) key = key.substring(OPENAPI_PREFIX.COMPONENTS_SCHEMAS.length);
+
+            if (activeRefs.has(key)) {
+                Logger.warn(`[MetaUI LayoutScorer] Circular OpenAPI $ref detected at '${path}' for '${key}'. Forcing dialog mode to prevent crash.`, "", "LayoutScorer");
+                node.ui = node.ui || {};
+                node.ui.renderMode = RENDER_MODE.DIALOG;
+                return 1;
+            }
+
+            const resolvedOriginal = schemaDefinitions[key];
+            if (resolvedOriginal) {
+                activeRefs.add(key);
+                
+                // Deep clone it BEFORE scoring so we don't mutate the global dictionary
+                const resolved = JSON.parse(JSON.stringify(resolvedOriginal));
+                
+                const resolvedScore = this._scoreNode(resolved, budget, visited, activeRefs, path, schemaDefinitions);
+                activeRefs.delete(key);
+                
+                node.ui = node.ui || {};
+                node.ui.layoutBudget = budget;
+                if (resolvedScore <= budget) {
+                    // Merge it permanently in the layout!
+                    Object.assign(node, resolved);
+                    delete node.$ref;
+                    if (node.ui?.widget === WIDGET_TYPE.REFERENCE) delete node.ui.widget;
+                    
+                    node.ui.renderMode = RENDER_MODE.INLINE;
+                    visited.delete(node);
+                    return resolvedScore;
+                } else {
+                    node.ui.renderMode = RENDER_MODE.DIALOG;
+                    visited.delete(node);
+                    return 1;
+                }
+            }
+        }
+
+        if (node.type === SCHEMA_TYPE.ARRAY) {
+            let arrayScore = PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.ARRAY, node.ui?.widget);
+            
+            // Traverse array items!
+            if (node.items) {
+                const itemsSchema = node.items as ISchema;
+                if (itemsSchema.type === SCHEMA_TYPE.OBJECT || itemsSchema.type === SCHEMA_TYPE.ARRAY || itemsSchema.$ref) {
+                    arrayScore += this._scoreNode(itemsSchema, budget, visited, activeRefs, `${path}/items`, schemaDefinitions);
+                }
+            }
+
+            node.ui = node.ui || {};
+            node.ui.layoutBudget = budget;
+            if (arrayScore <= budget) {
+                node.ui.renderMode = RENDER_MODE.INLINE;
+                visited.delete(node);
+                return arrayScore;
+            } else {
+                node.ui.renderMode = RENDER_MODE.DIALOG;
+                visited.delete(node);
+                return 1;
+            }
+        }
+
+        let totalScore = 0;
+
+        if (node.properties) {
+            for (const key in node.properties) {
+                const child = node.properties[key] as IPropertyMetadata;
+                if (child.type === SCHEMA_TYPE.OBJECT || child.type === SCHEMA_TYPE.ARRAY || child.$ref) {
+                    totalScore += this._scoreNode(child, budget, visited, activeRefs, `${path}/${key}`, schemaDefinitions);
+                } else {
+                    totalScore += PluginRegistry.getInstance().getPluginScore(child.type || SCHEMA_TYPE.STRING, child.ui?.widget);
+                }
+            }
+        } else {
+            // An open dictionary (additionalProperties) is scored as a single table
+            totalScore += PluginRegistry.getInstance().getPluginScore(SCHEMA_TYPE.OBJECT, node.ui?.widget); // e.g. dictionaryMap
+        }
+
+        node.ui = node.ui || {};
+        node.ui.layoutBudget = budget;
+        
+        visited.delete(node);
+
+        if (totalScore <= budget) {
+            node.ui.renderMode = RENDER_MODE.INLINE;
+            return totalScore;
+        } else {
+            node.ui.renderMode = RENDER_MODE.DIALOG;
+            return 1; // It collapsed into an "Edit Details" button
+        }
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/core/PipelineManager-dbg.js

@@ -95,6 +95,14 @@ sap.ui.define(["./Registry", "../plugins/validators/PatternValidatorPlugin", "..
      * @returns {IValidationResult} The final result state and any associated error message.
      */
     executeValidation(parsedValue, requestedValidators, argsMap) {
+      // Global short-circuit: if the field is completely empty and NOT required, skip all downstream string constraint checks.
+      const isEmpty = parsedValue === null || parsedValue === undefined || parsedValue === "";
+      const isRequired = requestedValidators.includes("required");
+      if (isEmpty && !isRequired) {
+        return {
+          isValid: true
+        };
+      }
       for (const rule of requestedValidators) {
         const validator = this.validators.get(rule);
         if (validator) {

package/src/nz/co/siliconst/ui5/metaui/core/PipelineManager-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineManager-dbg.js","names":["Registry","___Registry","PatternValidatorPlugin","___plugins_validators_PatternValidatorPlugin","MinLengthValidatorPlugin","___plugins_validators_MinLengthValidatorPlugin","RangeValidatorPlugin","___plugins_validators_RangeValidatorPlugin","UrlValidatorPlugin","___plugins_validators_UrlValidatorPlugin","IbanValidatorPlugin","___plugins_validators_IbanValidatorPlugin","EmailValidatorPlugin","___plugins_validators_EmailValidatorPlugin","DateFormatterPlugin","___plugins_formatters_DateFormatterPlugin","PhoneFormatterPlugin","___plugins_formatters_PhoneFormatterPlugin","TextCaseFormatterPlugin","___plugins_formatters_TextCaseFormatterPlugin","Logger","___utils_Logger","RequiredValidator","validate","parsedValue","args","undefined","isValid","errorMessage","MaxLengthValidator","length","PipelineManager","formatters","parsers","validators","constructor","register","executeValidation","requestedValidators","argsMap","rule","validator","get","result","error","msg","message","warn","GlobalPipeline","__exports","__esModule"],"sources":["PipelineManager.ts"],"sourcesContent":["/**\n * @file PipelineManager.ts\n * @description Central manager for the data manipulation pipeline. \n * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.\n */\n\nimport { Registry } from \"./Registry\";\nimport { IFormatter, IParser, IValidator, IValidationResult } from \"../interfaces/IPipeline\";\nimport { PatternValidatorPlugin } from \"../plugins/validators/PatternValidatorPlugin\";\nimport { MinLengthValidatorPlugin } from \"../plugins/validators/MinLengthValidatorPlugin\";\nimport { RangeValidatorPlugin } from \"../plugins/validators/RangeValidatorPlugin\";\nimport { UrlValidatorPlugin } from \"../plugins/validators/UrlValidatorPlugin\";\nimport { IbanValidatorPlugin } from \"../plugins/validators/IbanValidatorPlugin\";\nimport { EmailValidatorPlugin } from \"../plugins/validators/EmailValidatorPlugin\";\nimport { DateFormatterPlugin } from \"../plugins/formatters/DateFormatterPlugin\";\nimport { PhoneFormatterPlugin } from \"../plugins/formatters/PhoneFormatterPlugin\";\nimport { TextCaseFormatterPlugin } from \"../plugins/formatters/TextCaseFormatterPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\n// --- Built-in Default Validators ---\n/** Internal rule for required fields. */\nclass RequiredValidator implements IValidator {\n    /** Validates that the value is not null, undefined, or empty string. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (parsedValue === null || parsedValue === undefined || parsedValue === \"\") {\n            return { isValid: false, errorMessage: \"This field is required.\" };\n        }\n        return { isValid: true };\n    }\n}\n\n/** Internal rule for string maximum length. */\nclass MaxLengthValidator implements IValidator {\n    /** Validates that a string does not exceed the provided argument length. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (typeof parsedValue === \"string\" && args && typeof args === \"number\") {\n            if (parsedValue.length > args) {\n                return { isValid: false, errorMessage: `Maximum length is ${args} characters.` };\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n\n/**\n * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.\n * Pluggable design allows new validators to be registered dynamically.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PipelineManager {\n    /** Registry of data formatters applied before pushing to the UI. */\n    public readonly formatters: Registry<IFormatter> = new Registry<IFormatter>(\"Formatters\");\n    /** Registry of data parsers applied when pulling data from the UI. */\n    public readonly parsers: Registry<IParser> = new Registry<IParser>(\"Parsers\");\n    /** Registry of business logic validators. */\n    public readonly validators: Registry<IValidator> = new Registry<IValidator>(\"Validators\");\n\n    /**\n     * Bootstraps the PipelineManager with default validators (required, maxLength, email).\n     */\n    constructor() {\n        // Register default validators\n        this.validators.register(\"required\", new RequiredValidator());\n        this.validators.register(\"maxLength\", new MaxLengthValidator());\n        this.validators.register(\"pattern\", new PatternValidatorPlugin());\n        this.validators.register(\"minLength\", new MinLengthValidatorPlugin());\n        this.validators.register(\"range\", new RangeValidatorPlugin());\n        this.validators.register(\"url\", new UrlValidatorPlugin());\n        this.validators.register(\"iban\", new IbanValidatorPlugin());\n        this.validators.register(\"email\", new EmailValidatorPlugin());\n\n        // Register default formatters\n        this.formatters.register(\"date\", new DateFormatterPlugin());\n        this.formatters.register(\"phone\", new PhoneFormatterPlugin());\n        this.formatters.register(\"textCase\", new TextCaseFormatterPlugin());\n    }\n\n    /**\n     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.\n     * \n     * @param parsedValue The raw extracted value from the UI control.\n     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).\n     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).\n     * @returns {IValidationResult} The final result state and any associated error message.\n     */\n    public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, unknown>): IValidationResult {\n        for (const rule of requestedValidators) {\n            const validator = this.validators.get(rule);\n            if (validator) {\n                const args = argsMap ? argsMap[rule] : undefined;\n                try {\n                    const result = validator.validate(parsedValue, args);\n                    if (!result.isValid) {\n                        return result; // Fast fail on first error\n                    }\n                } catch (error) {\n                    const msg = (error as Error).message;\n                    Logger.error(`[MetaUI] PipelineManager: Validator '${rule}' crashed during execution.`, msg);\n                    return { isValid: false, errorMessage: `System validation error: ${msg}` };\n                }\n            } else {\n                Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n/** \n * Singleton instance for global access to the active validation pipeline. \n * @public \n */\nexport const GlobalPipeline = new PipelineManager();\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"PipelineManager-dbg.js","names":["Registry","___Registry","PatternValidatorPlugin","___plugins_validators_PatternValidatorPlugin","MinLengthValidatorPlugin","___plugins_validators_MinLengthValidatorPlugin","RangeValidatorPlugin","___plugins_validators_RangeValidatorPlugin","UrlValidatorPlugin","___plugins_validators_UrlValidatorPlugin","IbanValidatorPlugin","___plugins_validators_IbanValidatorPlugin","EmailValidatorPlugin","___plugins_validators_EmailValidatorPlugin","DateFormatterPlugin","___plugins_formatters_DateFormatterPlugin","PhoneFormatterPlugin","___plugins_formatters_PhoneFormatterPlugin","TextCaseFormatterPlugin","___plugins_formatters_TextCaseFormatterPlugin","Logger","___utils_Logger","RequiredValidator","validate","parsedValue","args","undefined","isValid","errorMessage","MaxLengthValidator","length","PipelineManager","formatters","parsers","validators","constructor","register","executeValidation","requestedValidators","argsMap","isEmpty","isRequired","includes","rule","validator","get","result","error","msg","message","warn","GlobalPipeline","__exports","__esModule"],"sources":["PipelineManager.ts"],"sourcesContent":["/**\n * @file PipelineManager.ts\n * @description Central manager for the data manipulation pipeline. \n * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.\n */\n\nimport { Registry } from \"./Registry\";\nimport { IFormatter, IParser, IValidator, IValidationResult } from \"../interfaces/IPipeline\";\nimport { PatternValidatorPlugin } from \"../plugins/validators/PatternValidatorPlugin\";\nimport { MinLengthValidatorPlugin } from \"../plugins/validators/MinLengthValidatorPlugin\";\nimport { RangeValidatorPlugin } from \"../plugins/validators/RangeValidatorPlugin\";\nimport { UrlValidatorPlugin } from \"../plugins/validators/UrlValidatorPlugin\";\nimport { IbanValidatorPlugin } from \"../plugins/validators/IbanValidatorPlugin\";\nimport { EmailValidatorPlugin } from \"../plugins/validators/EmailValidatorPlugin\";\nimport { DateFormatterPlugin } from \"../plugins/formatters/DateFormatterPlugin\";\nimport { PhoneFormatterPlugin } from \"../plugins/formatters/PhoneFormatterPlugin\";\nimport { TextCaseFormatterPlugin } from \"../plugins/formatters/TextCaseFormatterPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\n// --- Built-in Default Validators ---\n/** Internal rule for required fields. */\nclass RequiredValidator implements IValidator {\n    /** Validates that the value is not null, undefined, or empty string. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (parsedValue === null || parsedValue === undefined || parsedValue === \"\") {\n            return { isValid: false, errorMessage: \"This field is required.\" };\n        }\n        return { isValid: true };\n    }\n}\n\n/** Internal rule for string maximum length. */\nclass MaxLengthValidator implements IValidator {\n    /** Validates that a string does not exceed the provided argument length. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (typeof parsedValue === \"string\" && args && typeof args === \"number\") {\n            if (parsedValue.length > args) {\n                return { isValid: false, errorMessage: `Maximum length is ${args} characters.` };\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n\n/**\n * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.\n * Pluggable design allows new validators to be registered dynamically.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PipelineManager {\n    /** Registry of data formatters applied before pushing to the UI. */\n    public readonly formatters: Registry<IFormatter> = new Registry<IFormatter>(\"Formatters\");\n    /** Registry of data parsers applied when pulling data from the UI. */\n    public readonly parsers: Registry<IParser> = new Registry<IParser>(\"Parsers\");\n    /** Registry of business logic validators. */\n    public readonly validators: Registry<IValidator> = new Registry<IValidator>(\"Validators\");\n\n    /**\n     * Bootstraps the PipelineManager with default validators (required, maxLength, email).\n     */\n    constructor() {\n        // Register default validators\n        this.validators.register(\"required\", new RequiredValidator());\n        this.validators.register(\"maxLength\", new MaxLengthValidator());\n        this.validators.register(\"pattern\", new PatternValidatorPlugin());\n        this.validators.register(\"minLength\", new MinLengthValidatorPlugin());\n        this.validators.register(\"range\", new RangeValidatorPlugin());\n        this.validators.register(\"url\", new UrlValidatorPlugin());\n        this.validators.register(\"iban\", new IbanValidatorPlugin());\n        this.validators.register(\"email\", new EmailValidatorPlugin());\n\n        // Register default formatters\n        this.formatters.register(\"date\", new DateFormatterPlugin());\n        this.formatters.register(\"phone\", new PhoneFormatterPlugin());\n        this.formatters.register(\"textCase\", new TextCaseFormatterPlugin());\n    }\n\n    /**\n     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.\n     * \n     * @param parsedValue The raw extracted value from the UI control.\n     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).\n     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).\n     * @returns {IValidationResult} The final result state and any associated error message.\n     */\n    public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, unknown>): IValidationResult {\n        // Global short-circuit: if the field is completely empty and NOT required, skip all downstream string constraint checks.\n        const isEmpty = parsedValue === null || parsedValue === undefined || parsedValue === \"\";\n        const isRequired = requestedValidators.includes(\"required\");\n        if (isEmpty && !isRequired) {\n            return { isValid: true };\n        }\n\n        for (const rule of requestedValidators) {\n            const validator = this.validators.get(rule);\n            if (validator) {\n                const args = argsMap ? argsMap[rule] : undefined;\n                try {\n                    const result = validator.validate(parsedValue, args);\n                    if (!result.isValid) {\n                        return result; // Fast fail on first error\n                    }\n                } catch (error) {\n                    const msg = (error as Error).message;\n                    Logger.error(`[MetaUI] PipelineManager: Validator '${rule}' crashed during execution.`, msg);\n                    return { isValid: false, errorMessage: `System validation error: ${msg}` };\n                }\n            } else {\n                Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n/** \n * Singleton instance for global access to the active validation pipeline. \n * @public \n */\nexport const GlobalPipeline = new PipelineManager();\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/PipelineManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/PipelineManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;;OAIG;IAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;IACpE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;IAarH,yCAAyC;IACzC,MAAM,iBAAkB,YAAW,UAAU;QACzC,wEAAwE;QACxE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;KAMpE;IAED,+CAA+C;IAC/C,MAAM,kBAAmB,YAAW,UAAU;QAC1C,4EAA4E;QAC5E,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;KAQpE;IAGD;;;;;;OAMG;IACH,MAAa,eAAe;QACxB,oEAAoE;QACpE,SAAgB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAA0C;QAC1F,sEAAsE;QACtE,SAAgB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAoC;QAC9E,6CAA6C;QAC7C,SAAgB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAA0C;QAE1F;;WAEG;;QAkBH;;;;;;;WAOG;QACI,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;KAqBtI;IAED;;;OAGG;IACI,MAAM,cAAc,iBAAwB,CAAC;CAEnD"}
+{"version":3,"file":"PipelineManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/PipelineManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;;OAIG;IAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;IACpE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;IAarH,yCAAyC;IACzC,MAAM,iBAAkB,YAAW,UAAU;QACzC,wEAAwE;QACxE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;KAMpE;IAED,+CAA+C;IAC/C,MAAM,kBAAmB,YAAW,UAAU;QAC1C,4EAA4E;QAC5E,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB;KAQpE;IAGD;;;;;;OAMG;IACH,MAAa,eAAe;QACxB,oEAAoE;QACpE,SAAgB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAA0C;QAC1F,sEAAsE;QACtE,SAAgB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAoC;QAC9E,6CAA6C;QAC7C,SAAgB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAA0C;QAE1F;;WAEG;;QAkBH;;;;;;;WAOG;QACI,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;KA4BtI;IAED;;;OAGG;IACI,MAAM,cAAc,iBAAwB,CAAC;CAEnD"}

package/src/nz/co/siliconst/ui5/metaui/core/PipelineManager.js

@@ -1,2 +1,2 @@
-sap.ui.define(["./Registry","../plugins/validators/PatternValidatorPlugin","../plugins/validators/MinLengthValidatorPlugin","../plugins/validators/RangeValidatorPlugin","../plugins/validators/UrlValidatorPlugin","../plugins/validators/IbanValidatorPlugin","../plugins/validators/EmailValidatorPlugin","../plugins/formatters/DateFormatterPlugin","../plugins/formatters/PhoneFormatterPlugin","../plugins/formatters/TextCaseFormatterPlugin","../utils/Logger"],function(e,t,r,i,a,s,n,l,o,g,u){"use strict";const d=e["Registry"];const c=t["PatternValidatorPlugin"];const P=r["MinLengthValidatorPlugin"];const f=i["RangeValidatorPlugin"];const h=a["UrlValidatorPlugin"];const m=s["IbanValidatorPlugin"];const v=n["EmailValidatorPlugin"];const V=l["DateFormatterPlugin"];const p=o["PhoneFormatterPlugin"];const w=g["TextCaseFormatterPlugin"];const M=u["Logger"];class x{validate(e,t){if(e===null||e===undefined||e===""){return{isValid:false,errorMessage:"This field is required."}}return{isValid:true}}}class y{validate(e,t){if(typeof e==="string"&&t&&typeof t==="number"){if(e.length>t){return{isValid:false,errorMessage:`Maximum length is ${t} characters.`}}}return{isValid:true}}}class F{formatters=new d("Formatters");parsers=new d("Parsers");validators=new d("Validators");constructor(){this.validators.register("required",new x);this.validators.register("maxLength",new y);this.validators.register("pattern",new c);this.validators.register("minLength",new P);this.validators.register("range",new f);this.validators.register("url",new h);this.validators.register("iban",new m);this.validators.register("email",new v);this.formatters.register("date",new V);this.formatters.register("phone",new p);this.formatters.register("textCase",new w)}executeValidation(e,t,r){for(const i of t){const t=this.validators.get(i);if(t){const a=r?r[i]:undefined;try{const r=t.validate(e,a);if(!r.isValid){return r}}catch(e){const t=e.message;M.error(`[MetaUI] PipelineManager: Validator '${i}' crashed during execution.`,t);return{isValid:false,errorMessage:`System validation error: ${t}`}}}else{M.warn(`[MetaUI] PipelineManager: Requested validator '${i}' not found in registry.`)}}return{isValid:true}}}const L=new F;var b={__esModule:true};b.PipelineManager=F;b.GlobalPipeline=L;return b});
+sap.ui.define(["./Registry","../plugins/validators/PatternValidatorPlugin","../plugins/validators/MinLengthValidatorPlugin","../plugins/validators/RangeValidatorPlugin","../plugins/validators/UrlValidatorPlugin","../plugins/validators/IbanValidatorPlugin","../plugins/validators/EmailValidatorPlugin","../plugins/formatters/DateFormatterPlugin","../plugins/formatters/PhoneFormatterPlugin","../plugins/formatters/TextCaseFormatterPlugin","../utils/Logger"],function(e,t,r,i,a,s,n,l,o,g,u){"use strict";const d=e["Registry"];const c=t["PatternValidatorPlugin"];const f=r["MinLengthValidatorPlugin"];const P=i["RangeValidatorPlugin"];const h=a["UrlValidatorPlugin"];const m=s["IbanValidatorPlugin"];const V=n["EmailValidatorPlugin"];const v=l["DateFormatterPlugin"];const p=o["PhoneFormatterPlugin"];const w=g["TextCaseFormatterPlugin"];const M=u["Logger"];class x{validate(e,t){if(e===null||e===undefined||e===""){return{isValid:false,errorMessage:"This field is required."}}return{isValid:true}}}class y{validate(e,t){if(typeof e==="string"&&t&&typeof t==="number"){if(e.length>t){return{isValid:false,errorMessage:`Maximum length is ${t} characters.`}}}return{isValid:true}}}class F{formatters=new d("Formatters");parsers=new d("Parsers");validators=new d("Validators");constructor(){this.validators.register("required",new x);this.validators.register("maxLength",new y);this.validators.register("pattern",new c);this.validators.register("minLength",new f);this.validators.register("range",new P);this.validators.register("url",new h);this.validators.register("iban",new m);this.validators.register("email",new V);this.formatters.register("date",new v);this.formatters.register("phone",new p);this.formatters.register("textCase",new w)}executeValidation(e,t,r){const i=e===null||e===undefined||e==="";const a=t.includes("required");if(i&&!a){return{isValid:true}}for(const i of t){const t=this.validators.get(i);if(t){const a=r?r[i]:undefined;try{const r=t.validate(e,a);if(!r.isValid){return r}}catch(e){const t=e.message;M.error(`[MetaUI] PipelineManager: Validator '${i}' crashed during execution.`,t);return{isValid:false,errorMessage:`System validation error: ${t}`}}}else{M.warn(`[MetaUI] PipelineManager: Requested validator '${i}' not found in registry.`)}}return{isValid:true}}}const L=new F;var b={__esModule:true};b.PipelineManager=F;b.GlobalPipeline=L;return b});
 //# sourceMappingURL=PipelineManager.js.map

package/src/nz/co/siliconst/ui5/metaui/core/PipelineManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"PipelineManager.js","names":["Registry","___Registry","PatternValidatorPlugin","___plugins_validators_PatternValidatorPlugin","MinLengthValidatorPlugin","___plugins_validators_MinLengthValidatorPlugin","RangeValidatorPlugin","___plugins_validators_RangeValidatorPlugin","UrlValidatorPlugin","___plugins_validators_UrlValidatorPlugin","IbanValidatorPlugin","___plugins_validators_IbanValidatorPlugin","EmailValidatorPlugin","___plugins_validators_EmailValidatorPlugin","DateFormatterPlugin","___plugins_formatters_DateFormatterPlugin","PhoneFormatterPlugin","___plugins_formatters_PhoneFormatterPlugin","TextCaseFormatterPlugin","___plugins_formatters_TextCaseFormatterPlugin","Logger","___utils_Logger","RequiredValidator","validate","parsedValue","args","undefined","isValid","errorMessage","MaxLengthValidator","length","PipelineManager","formatters","parsers","validators","constructor","this","register","executeValidation","requestedValidators","argsMap","rule","validator","get","result","error","msg","message","warn","GlobalPipeline","__exports","__esModule"],"sources":["PipelineManager.ts"],"sourcesContent":["/**\n * @file PipelineManager.ts\n * @description Central manager for the data manipulation pipeline. \n * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.\n */\n\nimport { Registry } from \"./Registry\";\nimport { IFormatter, IParser, IValidator, IValidationResult } from \"../interfaces/IPipeline\";\nimport { PatternValidatorPlugin } from \"../plugins/validators/PatternValidatorPlugin\";\nimport { MinLengthValidatorPlugin } from \"../plugins/validators/MinLengthValidatorPlugin\";\nimport { RangeValidatorPlugin } from \"../plugins/validators/RangeValidatorPlugin\";\nimport { UrlValidatorPlugin } from \"../plugins/validators/UrlValidatorPlugin\";\nimport { IbanValidatorPlugin } from \"../plugins/validators/IbanValidatorPlugin\";\nimport { EmailValidatorPlugin } from \"../plugins/validators/EmailValidatorPlugin\";\nimport { DateFormatterPlugin } from \"../plugins/formatters/DateFormatterPlugin\";\nimport { PhoneFormatterPlugin } from \"../plugins/formatters/PhoneFormatterPlugin\";\nimport { TextCaseFormatterPlugin } from \"../plugins/formatters/TextCaseFormatterPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\n// --- Built-in Default Validators ---\n/** Internal rule for required fields. */\nclass RequiredValidator implements IValidator {\n    /** Validates that the value is not null, undefined, or empty string. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (parsedValue === null || parsedValue === undefined || parsedValue === \"\") {\n            return { isValid: false, errorMessage: \"This field is required.\" };\n        }\n        return { isValid: true };\n    }\n}\n\n/** Internal rule for string maximum length. */\nclass MaxLengthValidator implements IValidator {\n    /** Validates that a string does not exceed the provided argument length. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (typeof parsedValue === \"string\" && args && typeof args === \"number\") {\n            if (parsedValue.length > args) {\n                return { isValid: false, errorMessage: `Maximum length is ${args} characters.` };\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n\n/**\n * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.\n * Pluggable design allows new validators to be registered dynamically.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PipelineManager {\n    /** Registry of data formatters applied before pushing to the UI. */\n    public readonly formatters: Registry<IFormatter> = new Registry<IFormatter>(\"Formatters\");\n    /** Registry of data parsers applied when pulling data from the UI. */\n    public readonly parsers: Registry<IParser> = new Registry<IParser>(\"Parsers\");\n    /** Registry of business logic validators. */\n    public readonly validators: Registry<IValidator> = new Registry<IValidator>(\"Validators\");\n\n    /**\n     * Bootstraps the PipelineManager with default validators (required, maxLength, email).\n     */\n    constructor() {\n        // Register default validators\n        this.validators.register(\"required\", new RequiredValidator());\n        this.validators.register(\"maxLength\", new MaxLengthValidator());\n        this.validators.register(\"pattern\", new PatternValidatorPlugin());\n        this.validators.register(\"minLength\", new MinLengthValidatorPlugin());\n        this.validators.register(\"range\", new RangeValidatorPlugin());\n        this.validators.register(\"url\", new UrlValidatorPlugin());\n        this.validators.register(\"iban\", new IbanValidatorPlugin());\n        this.validators.register(\"email\", new EmailValidatorPlugin());\n\n        // Register default formatters\n        this.formatters.register(\"date\", new DateFormatterPlugin());\n        this.formatters.register(\"phone\", new PhoneFormatterPlugin());\n        this.formatters.register(\"textCase\", new TextCaseFormatterPlugin());\n    }\n\n    /**\n     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.\n     * \n     * @param parsedValue The raw extracted value from the UI control.\n     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).\n     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).\n     * @returns {IValidationResult} The final result state and any associated error message.\n     */\n    public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, unknown>): IValidationResult {\n        for (const rule of requestedValidators) {\n            const validator = this.validators.get(rule);\n            if (validator) {\n                const args = argsMap ? argsMap[rule] : undefined;\n                try {\n                    const result = validator.validate(parsedValue, args);\n                    if (!result.isValid) {\n                        return result; // Fast fail on first error\n                    }\n                } catch (error) {\n                    const msg = (error as Error).message;\n                    Logger.error(`[MetaUI] PipelineManager: Validator '${rule}' crashed during execution.`, msg);\n                    return { isValid: false, errorMessage: `System validation error: ${msg}` };\n                }\n            } else {\n                Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n/** \n * Singleton instance for global access to the active validation pipeline. \n * @public \n */\nexport const GlobalPipeline = new PipelineManager();\n"],"mappings":"sfAAA,MAMSA,EAAQC,EAAA,kBAERC,EAAsBC,EAAA,gCACtBC,EAAwBC,EAAA,kCACxBC,EAAoBC,EAAA,8BACpBC,EAAkBC,EAAA,4BAClBC,EAAmBC,EAAA,6BACnBC,EAAoBC,EAAA,8BACpBC,EAAmBC,EAAA,6BACnBC,EAAoBC,EAAA,8BACpBC,EAAuBC,EAAA,iCACvBC,EAAMC,EAAA,UAIf,MAAMC,EAEFC,SAASC,EAAsBC,GAC3B,GAAID,IAAgB,MAAQA,IAAgBE,WAAaF,IAAgB,GAAI,CACzE,MAAO,CAAEG,QAAS,MAAOC,aAAc,0BAC3C,CACA,MAAO,CAAED,QAAS,KACtB,EAIJ,MAAME,EAEFN,SAASC,EAAsBC,GAC3B,UAAWD,IAAgB,UAAYC,UAAeA,IAAS,SAAU,CACrE,GAAID,EAAYM,OAASL,EAAM,CAC3B,MAAO,CAAEE,QAAS,MAAOC,aAAc,qBAAqBH,gBAChE,CACJ,CACA,MAAO,CAAEE,QAAS,KACtB,EAWG,MAAMI,EAEOC,WAAmC,IAAIhC,EAAqB,cAE5DiC,QAA6B,IAAIjC,EAAkB,WAEnDkC,WAAmC,IAAIlC,EAAqB,cAK5EmC,cAEIC,KAAKF,WAAWG,SAAS,WAAY,IAAIf,GACzCc,KAAKF,WAAWG,SAAS,YAAa,IAAIR,GAC1CO,KAAKF,WAAWG,SAAS,UAAW,IAAInC,GACxCkC,KAAKF,WAAWG,SAAS,YAAa,IAAIjC,GAC1CgC,KAAKF,WAAWG,SAAS,QAAS,IAAI/B,GACtC8B,KAAKF,WAAWG,SAAS,MAAO,IAAI7B,GACpC4B,KAAKF,WAAWG,SAAS,OAAQ,IAAI3B,GACrC0B,KAAKF,WAAWG,SAAS,QAAS,IAAIzB,GAGtCwB,KAAKJ,WAAWK,SAAS,OAAQ,IAAIvB,GACrCsB,KAAKJ,WAAWK,SAAS,QAAS,IAAIrB,GACtCoB,KAAKJ,WAAWK,SAAS,WAAY,IAAInB,EAC7C,CAUOoB,kBAAkBd,EAAsBe,EAA+BC,GAC1E,IAAK,MAAMC,KAAQF,EAAqB,CACpC,MAAMG,EAAYN,KAAKF,WAAWS,IAAIF,GACtC,GAAIC,EAAW,CACX,MAAMjB,EAAOe,EAAUA,EAAQC,GAAQf,UACvC,IACI,MAAMkB,EAASF,EAAUnB,SAASC,EAAaC,GAC/C,IAAKmB,EAAOjB,QAAS,CACjB,OAAOiB,CACX,CACJ,CAAE,MAAOC,GACL,MAAMC,EAAOD,EAAgBE,QAC7B3B,EAAOyB,MAAM,wCAAwCJ,+BAAmCK,GACxF,MAAO,CAAEnB,QAAS,MAAOC,aAAc,4BAA4BkB,IACvE,CACJ,KAAO,CACH1B,EAAO4B,KAAK,kDAAkDP,4BAClE,CACJ,CACA,MAAO,CAAEd,QAAS,KACtB,EAOG,MAAMsB,EAAiB,IAAIlB,EAAkB,IAAAmB,EAAA,CAAAC,WAAA,MAAAD,EAAAnB,kBAAAmB,EAAAD,iBAAA,OAAAC,CAAA","ignoreList":[]}
+{"version":3,"file":"PipelineManager.js","names":["Registry","___Registry","PatternValidatorPlugin","___plugins_validators_PatternValidatorPlugin","MinLengthValidatorPlugin","___plugins_validators_MinLengthValidatorPlugin","RangeValidatorPlugin","___plugins_validators_RangeValidatorPlugin","UrlValidatorPlugin","___plugins_validators_UrlValidatorPlugin","IbanValidatorPlugin","___plugins_validators_IbanValidatorPlugin","EmailValidatorPlugin","___plugins_validators_EmailValidatorPlugin","DateFormatterPlugin","___plugins_formatters_DateFormatterPlugin","PhoneFormatterPlugin","___plugins_formatters_PhoneFormatterPlugin","TextCaseFormatterPlugin","___plugins_formatters_TextCaseFormatterPlugin","Logger","___utils_Logger","RequiredValidator","validate","parsedValue","args","undefined","isValid","errorMessage","MaxLengthValidator","length","PipelineManager","formatters","parsers","validators","constructor","this","register","executeValidation","requestedValidators","argsMap","isEmpty","isRequired","includes","rule","validator","get","result","error","msg","message","warn","GlobalPipeline","__exports","__esModule"],"sources":["PipelineManager.ts"],"sourcesContent":["/**\n * @file PipelineManager.ts\n * @description Central manager for the data manipulation pipeline. \n * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.\n */\n\nimport { Registry } from \"./Registry\";\nimport { IFormatter, IParser, IValidator, IValidationResult } from \"../interfaces/IPipeline\";\nimport { PatternValidatorPlugin } from \"../plugins/validators/PatternValidatorPlugin\";\nimport { MinLengthValidatorPlugin } from \"../plugins/validators/MinLengthValidatorPlugin\";\nimport { RangeValidatorPlugin } from \"../plugins/validators/RangeValidatorPlugin\";\nimport { UrlValidatorPlugin } from \"../plugins/validators/UrlValidatorPlugin\";\nimport { IbanValidatorPlugin } from \"../plugins/validators/IbanValidatorPlugin\";\nimport { EmailValidatorPlugin } from \"../plugins/validators/EmailValidatorPlugin\";\nimport { DateFormatterPlugin } from \"../plugins/formatters/DateFormatterPlugin\";\nimport { PhoneFormatterPlugin } from \"../plugins/formatters/PhoneFormatterPlugin\";\nimport { TextCaseFormatterPlugin } from \"../plugins/formatters/TextCaseFormatterPlugin\";\nimport { Logger } from \"../utils/Logger\";\n\n// --- Built-in Default Validators ---\n/** Internal rule for required fields. */\nclass RequiredValidator implements IValidator {\n    /** Validates that the value is not null, undefined, or empty string. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (parsedValue === null || parsedValue === undefined || parsedValue === \"\") {\n            return { isValid: false, errorMessage: \"This field is required.\" };\n        }\n        return { isValid: true };\n    }\n}\n\n/** Internal rule for string maximum length. */\nclass MaxLengthValidator implements IValidator {\n    /** Validates that a string does not exceed the provided argument length. */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult {\n        if (typeof parsedValue === \"string\" && args && typeof args === \"number\") {\n            if (parsedValue.length > args) {\n                return { isValid: false, errorMessage: `Maximum length is ${args} characters.` };\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n\n/**\n * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.\n * Pluggable design allows new validators to be registered dynamically.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class PipelineManager {\n    /** Registry of data formatters applied before pushing to the UI. */\n    public readonly formatters: Registry<IFormatter> = new Registry<IFormatter>(\"Formatters\");\n    /** Registry of data parsers applied when pulling data from the UI. */\n    public readonly parsers: Registry<IParser> = new Registry<IParser>(\"Parsers\");\n    /** Registry of business logic validators. */\n    public readonly validators: Registry<IValidator> = new Registry<IValidator>(\"Validators\");\n\n    /**\n     * Bootstraps the PipelineManager with default validators (required, maxLength, email).\n     */\n    constructor() {\n        // Register default validators\n        this.validators.register(\"required\", new RequiredValidator());\n        this.validators.register(\"maxLength\", new MaxLengthValidator());\n        this.validators.register(\"pattern\", new PatternValidatorPlugin());\n        this.validators.register(\"minLength\", new MinLengthValidatorPlugin());\n        this.validators.register(\"range\", new RangeValidatorPlugin());\n        this.validators.register(\"url\", new UrlValidatorPlugin());\n        this.validators.register(\"iban\", new IbanValidatorPlugin());\n        this.validators.register(\"email\", new EmailValidatorPlugin());\n\n        // Register default formatters\n        this.formatters.register(\"date\", new DateFormatterPlugin());\n        this.formatters.register(\"phone\", new PhoneFormatterPlugin());\n        this.formatters.register(\"textCase\", new TextCaseFormatterPlugin());\n    }\n\n    /**\n     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.\n     * \n     * @param parsedValue The raw extracted value from the UI control.\n     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).\n     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).\n     * @returns {IValidationResult} The final result state and any associated error message.\n     */\n    public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, unknown>): IValidationResult {\n        // Global short-circuit: if the field is completely empty and NOT required, skip all downstream string constraint checks.\n        const isEmpty = parsedValue === null || parsedValue === undefined || parsedValue === \"\";\n        const isRequired = requestedValidators.includes(\"required\");\n        if (isEmpty && !isRequired) {\n            return { isValid: true };\n        }\n\n        for (const rule of requestedValidators) {\n            const validator = this.validators.get(rule);\n            if (validator) {\n                const args = argsMap ? argsMap[rule] : undefined;\n                try {\n                    const result = validator.validate(parsedValue, args);\n                    if (!result.isValid) {\n                        return result; // Fast fail on first error\n                    }\n                } catch (error) {\n                    const msg = (error as Error).message;\n                    Logger.error(`[MetaUI] PipelineManager: Validator '${rule}' crashed during execution.`, msg);\n                    return { isValid: false, errorMessage: `System validation error: ${msg}` };\n                }\n            } else {\n                Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);\n            }\n        }\n        return { isValid: true };\n    }\n}\n\n/** \n * Singleton instance for global access to the active validation pipeline. \n * @public \n */\nexport const GlobalPipeline = new PipelineManager();\n"],"mappings":"sfAAA,MAMSA,EAAQC,EAAA,kBAERC,EAAsBC,EAAA,gCACtBC,EAAwBC,EAAA,kCACxBC,EAAoBC,EAAA,8BACpBC,EAAkBC,EAAA,4BAClBC,EAAmBC,EAAA,6BACnBC,EAAoBC,EAAA,8BACpBC,EAAmBC,EAAA,6BACnBC,EAAoBC,EAAA,8BACpBC,EAAuBC,EAAA,iCACvBC,EAAMC,EAAA,UAIf,MAAMC,EAEFC,SAASC,EAAsBC,GAC3B,GAAID,IAAgB,MAAQA,IAAgBE,WAAaF,IAAgB,GAAI,CACzE,MAAO,CAAEG,QAAS,MAAOC,aAAc,0BAC3C,CACA,MAAO,CAAED,QAAS,KACtB,EAIJ,MAAME,EAEFN,SAASC,EAAsBC,GAC3B,UAAWD,IAAgB,UAAYC,UAAeA,IAAS,SAAU,CACrE,GAAID,EAAYM,OAASL,EAAM,CAC3B,MAAO,CAAEE,QAAS,MAAOC,aAAc,qBAAqBH,gBAChE,CACJ,CACA,MAAO,CAAEE,QAAS,KACtB,EAWG,MAAMI,EAEOC,WAAmC,IAAIhC,EAAqB,cAE5DiC,QAA6B,IAAIjC,EAAkB,WAEnDkC,WAAmC,IAAIlC,EAAqB,cAK5EmC,cAEIC,KAAKF,WAAWG,SAAS,WAAY,IAAIf,GACzCc,KAAKF,WAAWG,SAAS,YAAa,IAAIR,GAC1CO,KAAKF,WAAWG,SAAS,UAAW,IAAInC,GACxCkC,KAAKF,WAAWG,SAAS,YAAa,IAAIjC,GAC1CgC,KAAKF,WAAWG,SAAS,QAAS,IAAI/B,GACtC8B,KAAKF,WAAWG,SAAS,MAAO,IAAI7B,GACpC4B,KAAKF,WAAWG,SAAS,OAAQ,IAAI3B,GACrC0B,KAAKF,WAAWG,SAAS,QAAS,IAAIzB,GAGtCwB,KAAKJ,WAAWK,SAAS,OAAQ,IAAIvB,GACrCsB,KAAKJ,WAAWK,SAAS,QAAS,IAAIrB,GACtCoB,KAAKJ,WAAWK,SAAS,WAAY,IAAInB,EAC7C,CAUOoB,kBAAkBd,EAAsBe,EAA+BC,GAE1E,MAAMC,EAAUjB,IAAgB,MAAQA,IAAgBE,WAAaF,IAAgB,GACrF,MAAMkB,EAAaH,EAAoBI,SAAS,YAChD,GAAIF,IAAYC,EAAY,CACxB,MAAO,CAAEf,QAAS,KACtB,CAEA,IAAK,MAAMiB,KAAQL,EAAqB,CACpC,MAAMM,EAAYT,KAAKF,WAAWY,IAAIF,GACtC,GAAIC,EAAW,CACX,MAAMpB,EAAOe,EAAUA,EAAQI,GAAQlB,UACvC,IACI,MAAMqB,EAASF,EAAUtB,SAASC,EAAaC,GAC/C,IAAKsB,EAAOpB,QAAS,CACjB,OAAOoB,CACX,CACJ,CAAE,MAAOC,GACL,MAAMC,EAAOD,EAAgBE,QAC7B9B,EAAO4B,MAAM,wCAAwCJ,+BAAmCK,GACxF,MAAO,CAAEtB,QAAS,MAAOC,aAAc,4BAA4BqB,IACvE,CACJ,KAAO,CACH7B,EAAO+B,KAAK,kDAAkDP,4BAClE,CACJ,CACA,MAAO,CAAEjB,QAAS,KACtB,EAOG,MAAMyB,EAAiB,IAAIrB,EAAkB,IAAAsB,EAAA,CAAAC,WAAA,MAAAD,EAAAtB,kBAAAsB,EAAAD,iBAAA,OAAAC,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/PipelineManager.ts

@@ -87,6 +87,13 @@ export class PipelineManager {
      * @returns {IValidationResult} The final result state and any associated error message.
      */
     public executeValidation(parsedValue: unknown, requestedValidators: string[], argsMap?: Record<string, unknown>): IValidationResult {
+        // Global short-circuit: if the field is completely empty and NOT required, skip all downstream string constraint checks.
+        const isEmpty = parsedValue === null || parsedValue === undefined || parsedValue === "";
+        const isRequired = requestedValidators.includes("required");
+        if (isEmpty && !isRequired) {
+            return { isValid: true };
+        }
+
         for (const rule of requestedValidators) {
             const validator = this.validators.get(rule);
             if (validator) {