@siliconst/metaui 1.2.0 → 1.4.5

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

@@ -1,6 +1,7 @@
-sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
+sap.ui.define(["sap/ui/model/json/JSONModel", "./PipelineManager", "sap/ui/core/message/Message", "sap/ui/core/library", "sap/ui/core/Messaging"], function (JSONModel, ___PipelineManager, Message, coreLibrary, Messaging) {
   "use strict";
 
+  const GlobalPipeline = ___PipelineManager["GlobalPipeline"];
   /**
    * Manages the isolated internal data payload for the MetaUI engine.
    */
@@ -8,12 +9,88 @@ sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
     /**
      * Initializes the state manager with an optional initial payload.
      * @param initialData The initial JSON payload to populate the fields.
+     * @param schema The normalized schema for live validation.
+     * @param modelName The UI5 model alias used for isolation.
      */
-    constructor(initialData = {}) {
+    constructor(initialData = {}, schema, modelName = "meta") {
+      this.activeModelName = modelName;
+      this.schema = schema;
+
       // Deep copy to ensure no reference leakage from the host application
       const safeData = JSON.parse(JSON.stringify(initialData));
       this.model = new JSONModel(safeData);
       this.model.setDefaultBindingMode("TwoWay");
+
+      // Centralized Model-Level Validation Interceptor
+      const originalSetProperty = this.model.setProperty.bind(this.model);
+      this.model.setProperty = (sPath, oValue, oContext, bAsyncUpdate) => {
+        const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);
+        this.validatePath(sPath, oValue);
+        return result;
+      };
+    }
+
+    /**
+     * Validates a specific path against the schema and updates the MessageManager.
+     */
+    validatePath(sPath, value) {
+      const fieldKey = sPath.replace(/^\//, "");
+      const metadata = this.findMetadataForPath(fieldKey);
+      const messageManager = Messaging;
+      const targetPath = sPath.startsWith("/") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path
+
+      // 1. Remove existing messages (strictly for THIS model instance)
+      const existingMessages = messageManager.getMessageModel().getData();
+      const messagesToRemove = existingMessages.filter(msg => {
+        const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();
+        return isMatch;
+      });
+      if (messagesToRemove.length > 0) {
+        messageManager.removeMessages(messagesToRemove);
+      }
+      if (!metadata) return;
+
+      // 2. Run GlobalPipeline
+      const validatorsToRun = [];
+      const argsMap = {};
+      if (metadata.required) {
+        validatorsToRun.push("required");
+      }
+      if (metadata.type === "string" && metadata.maxLength) {
+        validatorsToRun.push("maxLength");
+        argsMap["maxLength"] = {
+          max: metadata.maxLength
+        };
+      }
+      if (metadata.ui?.validators) {
+        for (const v of metadata.ui.validators) {
+          if (typeof v === "string") {
+            validatorsToRun.push(v);
+          } else if (v && v.name) {
+            validatorsToRun.push(v.name);
+            if (v.args !== undefined) {
+              argsMap[v.name] = v.args;
+            }
+          }
+        }
+      }
+      if (validatorsToRun.length > 0) {
+        const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);
+        if (!validationResult.isValid) {
+          const newMsg = new Message({
+            message: validationResult.errorMessage || "Invalid value.",
+            type: coreLibrary.MessageType.Error,
+            target: targetPath,
+            processor: this.model
+          });
+          messageManager.addMessages(newMsg);
+        }
+      }
+    }
+    findMetadataForPath(path) {
+      if (!this.schema || !this.schema.properties) return undefined;
+      // Basic single-level support for now. Nested object resolution would split by '.' or '/'
+      return this.schema.properties[path];
     }
 
     /**
@@ -46,6 +123,15 @@ sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
       const data = this.model.getData();
       return JSON.parse(JSON.stringify(data));
     }
+
+    /**
+     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
+     */
+    destroy() {
+      if (this.model) {
+        this.model.destroy();
+      }
+    }
   }
   var __exports = {
     __esModule: true

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager-dbg.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     */\n    constructor(initialData: Record<string, any> = {}) {\n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n    }\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n}\n"],"mappings":";;;EAQA;AACA;AACA;EACO,MAAMA,YAAY,CAAC;IAGtB;AACJ;AACA;AACA;IACIC,WAAWA,CAACC,WAAgC,GAAG,CAAC,CAAC,EAAE;MAC/C;MACA,MAAMC,QAAQ,GAAGC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACJ,WAAW,CAAC,CAAC;MACxD,IAAI,CAACK,KAAK,GAAG,IAAIC,SAAS,CAACL,QAAQ,CAAC;MACpC,IAAI,CAACI,KAAK,CAACE,qBAAqB,CAAC,QAAQ,CAAC;IAC9C;;IAEA;AACJ;AACA;AACA;IACWC,QAAQA,CAAA,EAAc;MACzB,OAAO,IAAI,CAACH,KAAK;IACrB;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACWI,WAAWA,CAACC,OAAsB,EAAEC,QAAgB,EAAEC,WAAmB,EAAQ;MACpFF,OAAO,CAACG,YAAY,CAACF,QAAQ,EAAE;QAC3BG,IAAI,EAAEF,WAAW;QACjBP,KAAK,EAAE,MAAM,CAAC;MAClB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;IACWU,cAAcA,CAAA,EAAwB;MACzC;MACA,MAAMC,IAAI,GAAG,IAAI,CAACX,KAAK,CAACY,OAAO,CAAC,CAAC;MACjC,OAAOf,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACY,IAAI,CAAC,CAAC;IAC3C;EACJ;EAAC,IAAAE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApB,YAAA,GAAAA,YAAA;EAAA,OAAAoB,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"StateManager-dbg.js","names":["GlobalPipeline","___PipelineManager","StateManager","constructor","initialData","schema","modelName","activeModelName","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","originalSetProperty","setProperty","bind","sPath","oValue","oContext","bAsyncUpdate","result","validatePath","value","fieldKey","replace","metadata","findMetadataForPath","messageManager","Messaging","targetPath","startsWith","existingMessages","getMessageModel","getData","messagesToRemove","filter","msg","isMatch","getTarget","getMessageProcessor","getId","length","removeMessages","validatorsToRun","argsMap","required","push","type","maxLength","max","ui","validators","v","name","args","undefined","validationResult","executeValidation","isValid","newMsg","Message","message","errorMessage","coreLibrary","MessageType","Error","target","processor","addMessages","path","properties","getModel","bindControl","control","property","bindingPath","bindProperty","extractPayload","data","destroy","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { GlobalPipeline } from \"./PipelineManager\";\nimport Message from \"sap/ui/core/message/Message\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n    private activeModelName: string;\n    private schema: ISchema;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     * @param schema The normalized schema for live validation.\n     * @param modelName The UI5 model alias used for isolation.\n     */\n    constructor(initialData: Record<string, any> = {}, schema: ISchema, modelName: string = \"meta\") {\n        this.activeModelName = modelName;\n        this.schema = schema;\n        \n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n\n        // Centralized Model-Level Validation Interceptor\n        const originalSetProperty = this.model.setProperty.bind(this.model);\n        this.model.setProperty = (sPath: string, oValue: any, oContext?: any, bAsyncUpdate?: boolean) => {\n            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);\n            this.validatePath(sPath, oValue);\n            return result;\n        };\n    }\n\n    /**\n     * Validates a specific path against the schema and updates the MessageManager.\n     */\n    private validatePath(sPath: string, value: any): void {\n        const fieldKey = sPath.replace(/^\\//, \"\");\n        const metadata = this.findMetadataForPath(fieldKey);\n        \n        const messageManager = Messaging;\n        const targetPath = sPath.startsWith(\"/\") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path\n        \n        // 1. Remove existing messages (strictly for THIS model instance)\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove = existingMessages.filter((msg: any) => {\n            const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();\n            return isMatch;\n        });\n        \n        \n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        if (!metadata) return;\n\n        // 2. Run GlobalPipeline\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, any> = {};\n\n        if (metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (metadata.type === \"string\" && metadata.maxLength) {\n            validatorsToRun.push(\"maxLength\");\n            argsMap[\"maxLength\"] = { max: metadata.maxLength };\n        }\n        if (metadata.ui?.validators) {\n            for (const v of metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length > 0) {\n            const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);\n            if (!validationResult.isValid) {\n                const newMsg = new Message({\n                    message: validationResult.errorMessage || \"Invalid value.\",\n                    type: coreLibrary.MessageType.Error,\n                    target: targetPath,\n                    processor: this.model\n                });\n                messageManager.addMessages(newMsg);\n            }\n        }\n    }\n\n    private findMetadataForPath(path: string): IPropertyMetadata | undefined {\n        if (!this.schema || !this.schema.properties) return undefined;\n        // Basic single-level support for now. Nested object resolution would split by '.' or '/'\n        return this.schema.properties[path];\n    }\n\n\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n\n    /**\n     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.\n     */\n    public destroy(): void {\n        \n        if (this.model) {\n            this.model.destroy();\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -5,16 +5,26 @@ declare module "nz/co/siliconst/ui5/metaui/core/StateManager" {
      */
     import JSONModel from "sap/ui/model/json/JSONModel";
     import ManagedObject from "sap/ui/base/ManagedObject";
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     /**
      * Manages the isolated internal data payload for the MetaUI engine.
      */
     export class StateManager {
         private model;
+        private activeModelName;
+        private schema;
         /**
          * Initializes the state manager with an optional initial payload.
          * @param initialData The initial JSON payload to populate the fields.
+         * @param schema The normalized schema for live validation.
+         * @param modelName The UI5 model alias used for isolation.
          */
-        constructor(initialData?: Record<string, any>);
+        constructor(initialData: Record<string, any>, schema: ISchema, modelName?: string);
+        /**
+         * Validates a specific path against the schema and updates the MessageManager.
+         */
+        private validatePath;
+        private findMetadataForPath;
         /**
          * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
          * @returns The internal JSONModel.
@@ -32,6 +42,10 @@ declare module "nz/co/siliconst/ui5/metaui/core/StateManager" {
          * @returns A serialized record of the data payload, free of UI5 wrappers.
          */
         extractPayload(): Record<string, any>;
+        /**
+         * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
+         */
+        destroy(): void;
     }
 }
 //# sourceMappingURL=StateManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAEtD;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QAEzB;;;WAGG;oBACS,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;QAOjD;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;KAK/C;CAEA"}
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IACtD,OAAO,EAAE,OAAO,EAAqB,MAAM,+CAA+C,CAAC;IAQ3F;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QACzB,OAAO,CAAC,eAAe,CAAS;QAChC,OAAO,CAAC,MAAM,CAAU;QAExB;;;;;WAKG;oBACS,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAE,MAAe;QAkB9F;;WAEG;QACH,OAAO,CAAC,YAAY;QA2DpB,OAAO,CAAC,mBAAmB;QAQ3B;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;QAM5C;;WAEG;QACI,OAAO,IAAI,IAAI;KAMzB;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["sap/ui/model/json/JSONModel"],function(e){"use strict";class t{constructor(t={}){const o=JSON.parse(JSON.stringify(t));this.model=new e(o);this.model.setDefaultBindingMode("TwoWay")}getModel(){return this.model}bindControl(e,t,o){e.bindProperty(t,{path:o,model:"meta"})}extractPayload(){const e=this.model.getData();return JSON.parse(JSON.stringify(e))}}var o={__esModule:true};o.StateManager=t;return o});
+sap.ui.define(["sap/ui/model/json/JSONModel","./PipelineManager","sap/ui/core/message/Message","sap/ui/core/library","sap/ui/core/Messaging"],function(e,t,s,a,i){"use strict";const r=t["GlobalPipeline"];class o{constructor(t={},s,a="meta"){this.activeModelName=a;this.schema=s;const i=JSON.parse(JSON.stringify(t));this.model=new e(i);this.model.setDefaultBindingMode("TwoWay");const r=this.model.setProperty.bind(this.model);this.model.setProperty=(e,t,s,a)=>{const i=r(e,t,s,a);this.validatePath(e,t);return i}}validatePath(e,t){const o=e.replace(/^\//,"");const n=this.findMetadataForPath(o);const d=i;const l=e.startsWith("/")?e:`/${e}`;const g=d.getMessageModel().getData();const h=g.filter(e=>{const t=e.getTarget()===l&&e.getMessageProcessor()&&e.getMessageProcessor().getId()===this.model.getId();return t});if(h.length>0){d.removeMessages(h)}if(!n)return;const c=[];const m={};if(n.required){c.push("required")}if(n.type==="string"&&n.maxLength){c.push("maxLength");m["maxLength"]={max:n.maxLength}}if(n.ui?.validators){for(const e of n.ui.validators){if(typeof e==="string"){c.push(e)}else if(e&&e.name){c.push(e.name);if(e.args!==undefined){m[e.name]=e.args}}}}if(c.length>0){const e=r.executeValidation(t,c,m);if(!e.isValid){const t=new s({message:e.errorMessage||"Invalid value.",type:a.MessageType.Error,target:l,processor:this.model});d.addMessages(t)}}}findMetadataForPath(e){if(!this.schema||!this.schema.properties)return undefined;return this.schema.properties[e]}getModel(){return this.model}bindControl(e,t,s){e.bindProperty(t,{path:s,model:"meta"})}extractPayload(){const e=this.model.getData();return JSON.parse(JSON.stringify(e))}destroy(){if(this.model){this.model.destroy()}}}var n={__esModule:true};n.StateManager=o;return n});
 //# sourceMappingURL=StateManager.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"StateManager.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","this","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     */\n    constructor(initialData: Record<string, any> = {}) {\n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n    }\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n}\n"],"mappings":"uEAWO,MAAMA,EAOTC,YAAYC,EAAmC,CAAC,GAE5C,MAAMC,EAAWC,KAAKC,MAAMD,KAAKE,UAAUJ,IAC3CK,KAAKC,MAAQ,IAAIC,EAAUN,GAC3BI,KAAKC,MAAME,sBAAsB,SACrC,CAMOC,WACH,OAAOJ,KAAKC,KAChB,CAQOI,YAAYC,EAAwBC,EAAkBC,GACzDF,EAAQG,aAAaF,EAAU,CAC3BG,KAAMF,EACNP,MAAO,QAEf,CAMOU,iBAEH,MAAMC,EAAOZ,KAAKC,MAAMY,UACxB,OAAOhB,KAAKC,MAAMD,KAAKE,UAAUa,GACrC,EACH,IAAAE,EAAA,CAAAC,WAAA,MAAAD,EAAArB,eAAA,OAAAqB,CAAA","ignoreList":[]}
+{"version":3,"file":"StateManager.js","names":["GlobalPipeline","___PipelineManager","StateManager","constructor","initialData","schema","modelName","this","activeModelName","safeData","JSON","parse","stringify","model","JSONModel","setDefaultBindingMode","originalSetProperty","setProperty","bind","sPath","oValue","oContext","bAsyncUpdate","result","validatePath","value","fieldKey","replace","metadata","findMetadataForPath","messageManager","Messaging","targetPath","startsWith","existingMessages","getMessageModel","getData","messagesToRemove","filter","msg","isMatch","getTarget","getMessageProcessor","getId","length","removeMessages","validatorsToRun","argsMap","required","push","type","maxLength","max","ui","validators","v","name","args","undefined","validationResult","executeValidation","isValid","newMsg","Message","message","errorMessage","coreLibrary","MessageType","Error","target","processor","addMessages","path","properties","getModel","bindControl","control","property","bindingPath","bindProperty","extractPayload","data","destroy","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { GlobalPipeline } from \"./PipelineManager\";\nimport Message from \"sap/ui/core/message/Message\";\nimport coreLibrary from \"sap/ui/core/library\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n    private activeModelName: string;\n    private schema: ISchema;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     * @param schema The normalized schema for live validation.\n     * @param modelName The UI5 model alias used for isolation.\n     */\n    constructor(initialData: Record<string, any> = {}, schema: ISchema, modelName: string = \"meta\") {\n        this.activeModelName = modelName;\n        this.schema = schema;\n        \n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n\n        // Centralized Model-Level Validation Interceptor\n        const originalSetProperty = this.model.setProperty.bind(this.model);\n        this.model.setProperty = (sPath: string, oValue: any, oContext?: any, bAsyncUpdate?: boolean) => {\n            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);\n            this.validatePath(sPath, oValue);\n            return result;\n        };\n    }\n\n    /**\n     * Validates a specific path against the schema and updates the MessageManager.\n     */\n    private validatePath(sPath: string, value: any): void {\n        const fieldKey = sPath.replace(/^\\//, \"\");\n        const metadata = this.findMetadataForPath(fieldKey);\n        \n        const messageManager = Messaging;\n        const targetPath = sPath.startsWith(\"/\") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path\n        \n        // 1. Remove existing messages (strictly for THIS model instance)\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove = existingMessages.filter((msg: any) => {\n            const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();\n            return isMatch;\n        });\n        \n        \n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n\n        if (!metadata) return;\n\n        // 2. Run GlobalPipeline\n        const validatorsToRun: string[] = [];\n        const argsMap: Record<string, any> = {};\n\n        if (metadata.required) {\n            validatorsToRun.push(\"required\");\n        }\n        if (metadata.type === \"string\" && metadata.maxLength) {\n            validatorsToRun.push(\"maxLength\");\n            argsMap[\"maxLength\"] = { max: metadata.maxLength };\n        }\n        if (metadata.ui?.validators) {\n            for (const v of metadata.ui.validators) {\n                if (typeof v === \"string\") {\n                    validatorsToRun.push(v);\n                } else if (v && v.name) {\n                    validatorsToRun.push(v.name);\n                    if (v.args !== undefined) {\n                        argsMap[v.name] = v.args;\n                    }\n                }\n            }\n        }\n\n        if (validatorsToRun.length > 0) {\n            const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);\n            if (!validationResult.isValid) {\n                const newMsg = new Message({\n                    message: validationResult.errorMessage || \"Invalid value.\",\n                    type: coreLibrary.MessageType.Error,\n                    target: targetPath,\n                    processor: this.model\n                });\n                messageManager.addMessages(newMsg);\n            }\n        }\n    }\n\n    private findMetadataForPath(path: string): IPropertyMetadata | undefined {\n        if (!this.schema || !this.schema.properties) return undefined;\n        // Basic single-level support for now. Nested object resolution would split by '.' or '/'\n        return this.schema.properties[path];\n    }\n\n\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n\n    /**\n     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.\n     */\n    public destroy(): void {\n        \n        if (this.model) {\n            this.model.destroy();\n        }\n    }\n}\n"],"mappings":"qLAQSA,EAAcC,EAAA,kBAUhB,MAAMC,EAWTC,YAAYC,EAAmC,CAAC,EAAGC,EAAiBC,EAAoB,QACpFC,KAAKC,gBAAkBF,EACvBC,KAAKF,OAASA,EAGd,MAAMI,EAAWC,KAAKC,MAAMD,KAAKE,UAAUR,IAC3CG,KAAKM,MAAQ,IAAIC,EAAUL,GAC3BF,KAAKM,MAAME,sBAAsB,UAGjC,MAAMC,EAAsBT,KAAKM,MAAMI,YAAYC,KAAKX,KAAKM,OAC7DN,KAAKM,MAAMI,YAAc,CAACE,EAAeC,EAAaC,EAAgBC,KAClE,MAAMC,EAASP,EAAoBG,EAAOC,EAAQC,EAAUC,GAC5Df,KAAKiB,aAAaL,EAAOC,GACzB,OAAOG,EAEf,CAKQC,aAAaL,EAAeM,GAChC,MAAMC,EAAWP,EAAMQ,QAAQ,MAAO,IACtC,MAAMC,EAAWrB,KAAKsB,oBAAoBH,GAE1C,MAAMI,EAAiBC,EACvB,MAAMC,EAAab,EAAMc,WAAW,KAAOd,EAAQ,IAAIA,IAGvD,MAAMe,EAAmBJ,EAAeK,kBAAkBC,UAC1D,MAAMC,EAAmBH,EAAiBI,OAAQC,IAC9C,MAAMC,EAAUD,EAAIE,cAAgBT,GAAcO,EAAIG,uBAAyBH,EAAIG,sBAAsBC,UAAYpC,KAAKM,MAAM8B,QAChI,OAAOH,IAIX,GAAIH,EAAiBO,OAAS,EAAG,CAC7Bd,EAAee,eAAeR,EAClC,CAEA,IAAKT,EAAU,OAGf,MAAMkB,EAA4B,GAClC,MAAMC,EAA+B,CAAC,EAEtC,GAAInB,EAASoB,SAAU,CACnBF,EAAgBG,KAAK,WACzB,CACA,GAAIrB,EAASsB,OAAS,UAAYtB,EAASuB,UAAW,CAClDL,EAAgBG,KAAK,aACrBF,EAAQ,aAAe,CAAEK,IAAKxB,EAASuB,UAC3C,CACA,GAAIvB,EAASyB,IAAIC,WAAY,CACzB,IAAK,MAAMC,KAAK3B,EAASyB,GAAGC,WAAY,CACpC,UAAWC,IAAM,SAAU,CACvBT,EAAgBG,KAAKM,EACzB,MAAO,GAAIA,GAAKA,EAAEC,KAAM,CACpBV,EAAgBG,KAAKM,EAAEC,MACvB,GAAID,EAAEE,OAASC,UAAW,CACtBX,EAAQQ,EAAEC,MAAQD,EAAEE,IACxB,CACJ,CACJ,CACJ,CAEA,GAAIX,EAAgBF,OAAS,EAAG,CAC5B,MAAMe,EAAmB3D,EAAe4D,kBAAkBnC,EAAOqB,EAAiBC,GAClF,IAAKY,EAAiBE,QAAS,CAC3B,MAAMC,EAAS,IAAIC,EAAQ,CACvBC,QAASL,EAAiBM,cAAgB,iBAC1Cf,KAAMgB,EAAYC,YAAYC,MAC9BC,OAAQrC,EACRsC,UAAW/D,KAAKM,QAEpBiB,EAAeyC,YAAYT,EAC/B,CACJ,CACJ,CAEQjC,oBAAoB2C,GACxB,IAAKjE,KAAKF,SAAWE,KAAKF,OAAOoE,WAAY,OAAOf,UAEpD,OAAOnD,KAAKF,OAAOoE,WAAWD,EAClC,CAQOE,WACH,OAAOnE,KAAKM,KAChB,CAQO8D,YAAYC,EAAwBC,EAAkBC,GACzDF,EAAQG,aAAaF,EAAU,CAC3BL,KAAMM,EACNjE,MAAO,QAEf,CAMOmE,iBAEH,MAAMC,EAAO1E,KAAKM,MAAMuB,UACxB,OAAO1B,KAAKC,MAAMD,KAAKE,UAAUqE,GACrC,CAKOC,UAEH,GAAI3E,KAAKM,MAAO,CACZN,KAAKM,MAAMqE,SACf,CACJ,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAAjF,eAAA,OAAAiF,CAAA","ignoreList":[]}

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

@@ -5,24 +5,116 @@
 
 import JSONModel from "sap/ui/model/json/JSONModel";
 import ManagedObject from "sap/ui/base/ManagedObject";
+import { ISchema, IPropertyMetadata } from "../interfaces/ISchema";
+import { GlobalPipeline } from "./PipelineManager";
+import Message from "sap/ui/core/message/Message";
+import coreLibrary from "sap/ui/core/library";
+import Core from "sap/ui/core/Core";
+import Messaging from "sap/ui/core/Messaging";
+
 
 /**
  * Manages the isolated internal data payload for the MetaUI engine.
  */
 export class StateManager {
     private model: JSONModel;
+    private activeModelName: string;
+    private schema: ISchema;
 
     /**
      * Initializes the state manager with an optional initial payload.
      * @param initialData The initial JSON payload to populate the fields.
+     * @param schema The normalized schema for live validation.
+     * @param modelName The UI5 model alias used for isolation.
      */
-    constructor(initialData: Record<string, any> = {}) {
+    constructor(initialData: Record<string, any> = {}, schema: ISchema, modelName: string = "meta") {
+        this.activeModelName = modelName;
+        this.schema = schema;
+        
         // Deep copy to ensure no reference leakage from the host application
         const safeData = JSON.parse(JSON.stringify(initialData));
         this.model = new JSONModel(safeData);
         this.model.setDefaultBindingMode("TwoWay");
+
+        // Centralized Model-Level Validation Interceptor
+        const originalSetProperty = this.model.setProperty.bind(this.model);
+        this.model.setProperty = (sPath: string, oValue: any, oContext?: any, bAsyncUpdate?: boolean) => {
+            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);
+            this.validatePath(sPath, oValue);
+            return result;
+        };
     }
 
+    /**
+     * Validates a specific path against the schema and updates the MessageManager.
+     */
+    private validatePath(sPath: string, value: any): void {
+        const fieldKey = sPath.replace(/^\//, "");
+        const metadata = this.findMetadataForPath(fieldKey);
+        
+        const messageManager = Messaging;
+        const targetPath = sPath.startsWith("/") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path
+        
+        // 1. Remove existing messages (strictly for THIS model instance)
+        const existingMessages = messageManager.getMessageModel().getData();
+        const messagesToRemove = existingMessages.filter((msg: any) => {
+            const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();
+            return isMatch;
+        });
+        
+        
+        if (messagesToRemove.length > 0) {
+            messageManager.removeMessages(messagesToRemove);
+        }
+
+        if (!metadata) return;
+
+        // 2. Run GlobalPipeline
+        const validatorsToRun: string[] = [];
+        const argsMap: Record<string, any> = {};
+
+        if (metadata.required) {
+            validatorsToRun.push("required");
+        }
+        if (metadata.type === "string" && metadata.maxLength) {
+            validatorsToRun.push("maxLength");
+            argsMap["maxLength"] = { max: metadata.maxLength };
+        }
+        if (metadata.ui?.validators) {
+            for (const v of metadata.ui.validators) {
+                if (typeof v === "string") {
+                    validatorsToRun.push(v);
+                } else if (v && v.name) {
+                    validatorsToRun.push(v.name);
+                    if (v.args !== undefined) {
+                        argsMap[v.name] = v.args;
+                    }
+                }
+            }
+        }
+
+        if (validatorsToRun.length > 0) {
+            const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);
+            if (!validationResult.isValid) {
+                const newMsg = new Message({
+                    message: validationResult.errorMessage || "Invalid value.",
+                    type: coreLibrary.MessageType.Error,
+                    target: targetPath,
+                    processor: this.model
+                });
+                messageManager.addMessages(newMsg);
+            }
+        }
+    }
+
+    private findMetadataForPath(path: string): IPropertyMetadata | undefined {
+        if (!this.schema || !this.schema.properties) return undefined;
+        // Basic single-level support for now. Nested object resolution would split by '.' or '/'
+        return this.schema.properties[path];
+    }
+
+
+
     /**
      * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
      * @returns The internal JSONModel.
@@ -53,4 +145,14 @@ export class StateManager {
         const data = this.model.getData();
         return JSON.parse(JSON.stringify(data));
     }
+
+    /**
+     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
+     */
+    public destroy(): void {
+        
+        if (this.model) {
+            this.model.destroy();
+        }
+    }
 }

package/src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ILayoutManager-dbg.js","names":[],"sources":["ILayoutManager.ts"],"sourcesContent":["/**\n * @file ILayoutManager.ts\n * @description Factory contract for generating UI5 layout containers (Forms/Tables).\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nimport { IPlugin } from \"./IPlugin\";\n\nexport interface ILayoutManager {\n    /**\n     * Renders a form-style layout for the root fields defined in the schema.\n     */\n    renderForm(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;\n\n    /**\n     * Renders a tabular layout for the provided array metadata.\n     */\n    renderTable(tableMeta: IPropertyMetadata, modelName?: string, tableTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ILayoutManager-dbg.js","names":[],"sources":["ILayoutManager.ts"],"sourcesContent":["/**\n * @file ILayoutManager.ts\n * @description Factory contract for generating UI5 layout containers (Forms/Tables).\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nimport { IPlugin } from \"./IPlugin\";\n\nexport interface ILayoutManager {\n    /**\n     * Renders a UI container based on the provided schema.\n     * @param schema The schema defining the layout content.\n     * @param modelName The UI5 JSONModel name for data binding.\n     * @param engine Reference back to the Engine for recursive internal field generation.\n     * @param onSubmit Callback to trigger form submission from the layout natively (e.g. Wizard complete)\n     * @param bindingPath Optional path to bind the layout (e.g. for nested array tables)\n     */\n    render(schema: import(\"./ISchema\").ISchema, modelName: string, engine: import(\"../core/Engine\").Engine, onSubmit?: () => void, bindingPath?: string): Control;\n}\n"],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager.d.ts

@@ -4,17 +4,16 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager" {
      * @description Factory contract for generating UI5 layout containers (Forms/Tables).
      */
     import Control from "sap/ui/core/Control";
-    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    import { IPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/IPlugin";
     export interface ILayoutManager {
         /**
-         * Renders a form-style layout for the root fields defined in the schema.
+         * Renders a UI container based on the provided schema.
+         * @param schema The schema defining the layout content.
+         * @param modelName The UI5 JSONModel name for data binding.
+         * @param engine Reference back to the Engine for recursive internal field generation.
+         * @param onSubmit Callback to trigger form submission from the layout natively (e.g. Wizard complete)
+         * @param bindingPath Optional path to bind the layout (e.g. for nested array tables)
          */
-        renderForm(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
-        /**
-         * Renders a tabular layout for the provided array metadata.
-         */
-        renderTable(tableMeta: IPropertyMetadata, modelName?: string, tableTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
+        render(schema: import("./ISchema").ISchema, modelName: string, engine: import("nz/co/siliconst/ui5/metaui/core/Engine").Engine, onSubmit?: () => void, bindingPath?: string): Control;
     }
 }
 //# sourceMappingURL=ILayoutManager.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ILayoutManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sDAAsD,CAAC;IACtE;;;OAGG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IAExE,UAAiB,cAAc;QAC3B;;WAEG;QACH,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;QAEpJ;;WAEG;QACH,WAAW,CAAC,SAAS,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;KACxI;CAEA"}
+{"version":3,"file":"ILayoutManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sDAAsD,CAAC;IACtE;;;OAGG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAK1C,UAAiB,cAAc;QAC3B;;;;;;;WAOG;QACH,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,wCAAwC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACzL;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager.ts

@@ -10,12 +10,12 @@ import { IPlugin } from "./IPlugin";
 
 export interface ILayoutManager {
     /**
-     * Renders a form-style layout for the root fields defined in the schema.
+     * Renders a UI container based on the provided schema.
+     * @param schema The schema defining the layout content.
+     * @param modelName The UI5 JSONModel name for data binding.
+     * @param engine Reference back to the Engine for recursive internal field generation.
+     * @param onSubmit Callback to trigger form submission from the layout natively (e.g. Wizard complete)
+     * @param bindingPath Optional path to bind the layout (e.g. for nested array tables)
      */
-    renderForm(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
-
-    /**
-     * Renders a tabular layout for the provided array metadata.
-     */
-    renderTable(tableMeta: IPropertyMetadata, modelName?: string, tableTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
+    render(schema: import("./ISchema").ISchema, modelName: string, engine: import("../core/Engine").Engine, onSubmit?: () => void, bindingPath?: string): Control;
 }

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline-dbg.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IPipeline-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPipeline-dbg.js","names":[],"sources":["IPipeline.ts"],"sourcesContent":["/**\n * @file IPipeline.ts\n * @description Interfaces for the generic data manipulation pipeline (Formatters, Parsers, Validators).\n */\n\nexport interface IFormatter {\n    /**\n     * Formats raw JSON model data into a UI-friendly string.\n     * @param rawValue The raw value from the JSON payload.\n     * @param args Optional arguments provided in the schema.\n     * @returns The formatted string for the UI control.\n     */\n    format(rawValue: unknown, args?: unknown): string;\n}\n\nexport interface IParser {\n    /**\n     * Parses UI-formatted strings back into raw data types.\n     * @param uiValue The value extracted from the UI control.\n     * @param args Optional arguments provided in the schema.\n     * @returns The raw typed value for the JSON payload.\n     */\n    parse(uiValue: any, args?: unknown): any;\n}\n\nexport interface IValidationResult {\n    isValid: boolean;\n    errorMessage?: string;\n}\n\nexport interface IValidator {\n    /**\n     * Validates parsed data before it enters the JSON model.\n     * @param parsedValue The cleaned data to validate.\n     * @param args Optional arguments provided in the schema (e.g. max length number)\n     * @returns IValidationResult containing status and optional error message.\n     */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult;\n}\n"],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.d.ts

@@ -0,0 +1,38 @@
+declare module "nz/co/siliconst/ui5/metaui/interfaces/IPipeline" {
+    /**
+     * @file IPipeline.ts
+     * @description Interfaces for the generic data manipulation pipeline (Formatters, Parsers, Validators).
+     */
+    export interface IFormatter {
+        /**
+         * Formats raw JSON model data into a UI-friendly string.
+         * @param rawValue The raw value from the JSON payload.
+         * @param args Optional arguments provided in the schema.
+         * @returns The formatted string for the UI control.
+         */
+        format(rawValue: unknown, args?: unknown): string;
+    }
+    export interface IParser {
+        /**
+         * Parses UI-formatted strings back into raw data types.
+         * @param uiValue The value extracted from the UI control.
+         * @param args Optional arguments provided in the schema.
+         * @returns The raw typed value for the JSON payload.
+         */
+        parse(uiValue: any, args?: unknown): any;
+    }
+    export interface IValidationResult {
+        isValid: boolean;
+        errorMessage?: string;
+    }
+    export interface IValidator {
+        /**
+         * Validates parsed data before it enters the JSON model.
+         * @param parsedValue The cleaned data to validate.
+         * @param args Optional arguments provided in the schema (e.g. max length number)
+         * @returns IValidationResult containing status and optional error message.
+         */
+        validate(parsedValue: unknown, args?: unknown): IValidationResult;
+    }
+}
+//# sourceMappingURL=IPipeline.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPipeline.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;OAGG;IAEH,UAAiB,UAAU;QACvB;;;;;WAKG;QACH,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;KACrD;IAED,UAAiB,OAAO;QACpB;;;;;WAKG;QACH,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,GAAG,CAAC;KAC5C;IAED,UAAiB,iBAAiB;QAC9B,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB;IAED,UAAiB,UAAU;QACvB;;;;;WAKG;QACH,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;KACrE;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IPipeline.js.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPipeline.js","names":[],"sources":[],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.ts

@@ -0,0 +1,39 @@
+/**
+ * @file IPipeline.ts
+ * @description Interfaces for the generic data manipulation pipeline (Formatters, Parsers, Validators).
+ */
+
+export interface IFormatter {
+    /**
+     * Formats raw JSON model data into a UI-friendly string.
+     * @param rawValue The raw value from the JSON payload.
+     * @param args Optional arguments provided in the schema.
+     * @returns The formatted string for the UI control.
+     */
+    format(rawValue: unknown, args?: unknown): string;
+}
+
+export interface IParser {
+    /**
+     * Parses UI-formatted strings back into raw data types.
+     * @param uiValue The value extracted from the UI control.
+     * @param args Optional arguments provided in the schema.
+     * @returns The raw typed value for the JSON payload.
+     */
+    parse(uiValue: any, args?: unknown): any;
+}
+
+export interface IValidationResult {
+    isValid: boolean;
+    errorMessage?: string;
+}
+
+export interface IValidator {
+    /**
+     * Validates parsed data before it enters the JSON model.
+     * @param parsedValue The cleaned data to validate.
+     * @param args Optional arguments provided in the schema (e.g. max length number)
+     * @returns IValidationResult containing status and optional error message.
+     */
+    validate(parsedValue: unknown, args?: unknown): IValidationResult;
+}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"IPlugin-dbg.js","names":[],"sources":["IPlugin.ts"],"sourcesContent":["/**\n * @file IPlugin.ts\n * @description Contract for all discrete UI control generation plugins.\n * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nexport interface IPlugin {\n    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;\n    validate(): boolean;\n    onStateChange(newMetadata: IPropertyMetadata): void;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"IPlugin-dbg.js","names":[],"sources":["IPlugin.ts"],"sourcesContent":["/**\n * @file IPlugin.ts\n * @description Contract for all discrete UI control generation plugins.\n * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nexport interface IPluginValidationResult {\n    isValid: boolean;\n    errorMessage?: string;\n    fieldKey?: string;\n}\n\nexport interface IPlugin {\n    /**\n     * Instantiates the raw UI5 control and binds it to the specified data model.\n     * \n     * @param fieldMetadata The JSON Schema defining the field's constraints and UI hints.\n     * @param bindingPath The specific JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel alias used for data binding (defaults to 'meta').\n     * @param engineScopeId The deterministic scope ID provided by the Engine.\n     * @param onChange The callback fired natively when a field value blur/change occurs.\n     * @returns {Control} The generated UI5 control ready to be mounted.\n     */\n    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;\n\n    /**\n     * Triggers the internal validation pipeline for this specific plugin instance.\n     * \n     * @returns {IPluginValidationResult} The structural validity state and error messages.\n     */\n    validate(): IPluginValidationResult;\n\n    /**\n     * Executes when the ConditionEngine pushes dynamic metadata mutations to the field.\n     * \n     * @param newMetadata The mutated schema metadata.\n     */\n    onStateChange(newMetadata: IPropertyMetadata): void;\n\n    /**\n     * Optional lifecycle hook executed when the parent layout is destroyed.\n     * Plugins must use this to destroy isolated JSONModels, custom EventBus listeners, \n     * or embedded Dialogs to prevent memory leaks in the SAP Fiori Launchpad.\n     */\n    destroy?(): void;\n\n    /**\n     * Injects the global display mode context into the plugin before rendering.\n     * @param mode True if the plugin should render in a read-only display mode.\n     */\n    setDisplayMode?(mode: boolean): void;\n}\n"],"mappings":"","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.d.ts

@@ -6,10 +6,46 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/IPlugin" {
      */
     import Control from "sap/ui/core/Control";
     import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    export interface IPluginValidationResult {
+        isValid: boolean;
+        errorMessage?: string;
+        fieldKey?: string;
+    }
     export interface IPlugin {
-        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
-        validate(): boolean;
+        /**
+         * Instantiates the raw UI5 control and binds it to the specified data model.
+         *
+         * @param fieldMetadata The JSON Schema defining the field's constraints and UI hints.
+         * @param bindingPath The specific JSON path representing the field within the payload.
+         * @param modelName The UI5 JSONModel alias used for data binding (defaults to 'meta').
+         * @param engineScopeId The deterministic scope ID provided by the Engine.
+         * @param onChange The callback fired natively when a field value blur/change occurs.
+         * @returns {Control} The generated UI5 control ready to be mounted.
+         */
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;
+        /**
+         * Triggers the internal validation pipeline for this specific plugin instance.
+         *
+         * @returns {IPluginValidationResult} The structural validity state and error messages.
+         */
+        validate(): IPluginValidationResult;
+        /**
+         * Executes when the ConditionEngine pushes dynamic metadata mutations to the field.
+         *
+         * @param newMetadata The mutated schema metadata.
+         */
         onStateChange(newMetadata: IPropertyMetadata): void;
+        /**
+         * Optional lifecycle hook executed when the parent layout is destroyed.
+         * Plugins must use this to destroy isolated JSONModels, custom EventBus listeners,
+         * or embedded Dialogs to prevent memory leaks in the SAP Fiori Launchpad.
+         */
+        destroy?(): void;
+        /**
+         * Injects the global display mode context into the plugin before rendering.
+         * @param mode True if the plugin should render in a read-only display mode.
+         */
+        setDisplayMode?(mode: boolean): void;
     }
 }
 //# sourceMappingURL=IPlugin.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;OAIG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,UAAiB,OAAO;QACpB,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3F,QAAQ,IAAI,OAAO,CAAC;QACpB,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;KACvD;CAEA"}
+{"version":3,"file":"IPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;OAIG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,UAAiB,uBAAuB;QACpC,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,OAAO;QACpB;;;;;;;;;WASG;QACH,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;QAExN;;;;WAIG;QACH,QAAQ,IAAI,uBAAuB,CAAC;QAEpC;;;;WAIG;QACH,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEpD;;;;WAIG;QACH,OAAO,CAAC,IAAI,IAAI,CAAC;QAEjB;;;WAGG;QACH,cAAc,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;KACxC;CAEA"}