@siliconst/metaui 1.2.0 → 1.4.5

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

@@ -3,14 +3,75 @@ declare module "nz/co/siliconst/ui5/metaui/core/Engine" {
      * @file Engine.ts
      * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).
      */
-    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import { ISchema, IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     import { ILayoutManager } from "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager";
+    import { IPluginValidationResult } from "nz/co/siliconst/ui5/metaui/interfaces/IPlugin";
     import Control from "sap/ui/core/Control";
+    import { Registry } from "nz/co/siliconst/ui5/metaui/core/Registry";
+    /**
+     * The Engine is responsible for translating a normalized schema into a physical UI5 layout.
+     * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.
+     * It is NOT a God Class; it strictly routes execution flow and tracks active plugins for validation.
+     * It embodies the "Plugin-First Philosophy" by routing all complex field and layout rendering
+     * through discrete, decoupled plugins rather than handling native overrides.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.core
+     * @public
+     */
     export class Engine {
+        /** Global registry of all available layout strategies (e.g. Form, Table, Wizard). */
+        static layoutRegistry: Registry<ILayoutManager>;
+        /** Handles dynamic conditional logic across the active form. */
         private conditionEngine;
+        /** Array of all instantiated plugins generated during the current build. */
         private activePlugins;
-        build(schema: ISchema, layoutManager: ILayoutManager, modelName?: string): Control;
-        validateAll(): boolean;
+        /** Deterministic scope ID injected by the host control to prevent clone collisions. */
+        engineScopeId?: string;
+        private activeModel?;
+        /** Tracks whether the entire engine is running in Read-Only Display mode. */
+        readonly isDisplayMode: boolean;
+        constructor(displayMode?: boolean);
+        /**
+         * Bootstraps the layout generation process by resolving the correct layout strategy.
+         *
+         * @param schema The normalized JSON schema representing the view.
+         * @param model The active StateManager JSONModel instance.
+         * @param modelName The UI5 model alias used for isolation.
+         * @param onSubmit Callback fired when form is submitted.
+         * @param engineScopeId Deterministic scope ID for this engine instance.
+         * @param onChange Callback fired when field values change.
+         * @returns The generated root UI5 Control container.
+         */
+        build(schema: ISchema, model: sap.ui.model.Model, modelName?: string, onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;
+        /**
+         * Instantiates the correct plugin for a specific field based on type and widget hints,
+         * and tracks the plugin for global validation.
+         *
+         * @param fieldMeta The metadata schema specific to the field.
+         * @param bindingPath The JSON path representing the field within the payload.
+         * @param modelName The UI5 JSONModel name used for data binding.
+         * @returns The generated UI5 Control for the field.
+         */
+        generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate?: boolean): Control;
+        /**
+         * Generates a sub-layout (like an embedded table or nested form) without
+         * destroying the current Engine state or Condition tracking.
+         *
+         * @param schema The normalized JSON schema representing the view.
+         * @param modelName The UI5 JSONModel name used for data binding (defaults to "meta").
+         * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.
+         * @returns The generated root UI5 Control container.
+         */
+        generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control;
+        /**
+         * Iterates through all active plugins and triggers their internal validation pipelines.
+         *
+         * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
+         */
+        validateAll(): IPluginValidationResult[];
+        /**
+         * Cleans up internal state and destroys the condition engine to prevent memory leaks.
+         */
         destroy(): void;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Engine.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wCAAwC,CAAC;IACxD;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAqB,MAAM,+CAA+C,CAAC;IAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;IAGtF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C,MAAa,MAAM;QACf,OAAO,CAAC,eAAe,CAAgC;QACvD,OAAO,CAAC,aAAa,CAAiB;QAE/B,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,GAAE,MAAe,GAAG,OAAO;QAgD1F,WAAW,IAAI,OAAO;QAUtB,OAAO,IAAI,IAAI;KAOzB;CAEA"}
+{"version":3,"file":"Engine.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wCAAwC,CAAC;IACxD;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;IACtF,OAAO,EAAW,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;IAGjG,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;IAMpE;;;;;;;;;OASG;IACH,MAAa,MAAM;QACf,qFAAqF;QACrF,OAAc,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;QACvD,gEAAgE;QAChE,OAAO,CAAC,eAAe,CAAgC;QAEvD,4EAA4E;QAC5E,OAAO,CAAC,aAAa,CAA2C;QAEhE,uFAAuF;QAChF,aAAa,CAAC,EAAE,MAAM,CAAC;QAE9B,OAAO,CAAC,WAAW,CAAC,CAAqB;QAEzC,6EAA6E;QAC7E,SAAgB,aAAa,EAAE,OAAO,CAAS;oBAEnC,WAAW,GAAE,OAAe;QAIxC;;;;;;;;;;WAUG;QACI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,GAAE,MAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,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;QAgCjP;;;;;;;;WAQG;QACI,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,OAAO;QAwBhI;;;;;;;;WAQG;QACI,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO;QAaxF;;;;WAIG;QACI,WAAW,IAAI,uBAAuB,EAAE;QAe/C;;WAEG;QACI,OAAO,IAAI,IAAI;KAiCzB;CAEA"}

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

@@ -1,2 +1,2 @@
-sap.ui.define(["./ConditionEngine","sap/m/VBox"],function(e,t){"use strict";const i=e["ConditionEngine"];class n{conditionEngine=null;activePlugins=[];build(e,n,s="meta"){this.conditionEngine=new i(e);this.activePlugins=[];const r=e=>this.activePlugins.push(e);if(e.type==="array"){if(!e.items){throw new Error("[MetaUI] Array schema must define 'items'.")}return n.renderTable(e.items,`${s}>/`,e.title)}if(e.type==="object"){const i=new t({renderType:"Bare"});const o=e.properties||{};const a={};const c=[];for(const e of Object.keys(o)){if(o[e].type==="array"){c.push({key:e,meta:o[e]})}else{a[e]=o[e]}}if(Object.keys(a).length>0){i.addItem(n.renderForm(a,s,e.title,r))}for(const e of c){if(e.meta.items){i.addItem(n.renderTable(e.meta.items,`${s}>/${e.key}`,e.meta.ui?.label||e.key))}}return i}throw new Error(`[MetaUI] Unsupported schema type: ${e.type}`)}validateAll(){let e=true;for(const t of this.activePlugins){if(!t.validate()){e=false}}return e}destroy(){if(this.conditionEngine){this.conditionEngine.destroy();this.conditionEngine=null}this.activePlugins=[]}}var s={__esModule:true};s.Engine=n;return s});
+sap.ui.define(["./ConditionEngine","./PluginRegistry","sap/m/Text","../utils/Logger","./DefaultLayoutGenerator","sap/ui/core/Messaging"],function(e,t,n,i,r,o){"use strict";const s=e["ConditionEngine"];const a=t["PluginRegistry"];const g=i["Logger"];const l=r["DefaultLayoutGenerator"];class u{conditionEngine=null;activePlugins=[];isDisplayMode=false;constructor(e=false){this.isDisplayMode=e}build(e,t,i="meta",r,o,a){this.conditionEngine=new s(e);this.activePlugins=[];this.activeModel=t;this.engineScopeId=o;this.onChange=(e,t,n,i)=>{if(this.conditionEngine&&t){this.conditionEngine.handleEvent(t,e)}if(a){a(e,t,n,i)}};try{if(l.ensureLayout(e)){g.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.")}const t=e.layoutStrategy||(e.type==="array"?"table":"form");const n=u.layoutRegistry.getStrict(t);return n.render(e,i,this,r)}catch(e){const t=e.message;g.error("[MetaUI Engine] Critical error during layout generation",t);g.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${t}`);return new n({text:"Critical Layout Error"})}}generateField(e,t,i,r=false){try{const n=a.getInstance().getPlugin(e.type||"string",e.ui?.widget);n.setDisplayMode(this.isDisplayMode);if(!r){this.activePlugins.push({plugin:n,path:t})}const o=r?undefined:this.engineScopeId;const s=n.render(e,t,i,o,this.onChange);if(this.conditionEngine){this.conditionEngine.registerPlugin(t,n)}return s}catch(e){const i=e.message;g.error(`[MetaUI Engine] Failed to generate field at ${t}`,i);g.showErrorPopup(`Failed to generate field '${t}'.\n\nDetails: ${i}`);return new n({text:`[Error generating field ${t}]`})}}generateLayout(e,t,i){try{const n=e.layoutStrategy||(e.type==="array"?"table":"form");const r=u.layoutRegistry.getStrict(n);return r.render(e,t,this,undefined,i)}catch(e){const t=e.message;g.error(`[MetaUI Engine] Critical error generating sub-layout for ${i}`,t);g.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${t}`);return new n({text:"Critical Sub-Layout Error"})}}validateAll(){const e=[];for(const t of this.activePlugins){const n=t.plugin.validate();if(!n.isValid){n.fieldKey=n.fieldKey||t.path.replace(/^\//,"");e.push(n);g.error("[MetaUI Validation] Plugin failed validation silently:",t.path||t.plugin.constructor.name)}}return e}destroy(){if(this.conditionEngine){this.conditionEngine.destroy();this.conditionEngine=null}const e=o;const t=e.getMessageModel().getData();const n=[];for(const e of this.activePlugins){if(this.activeModel){const i=`/${e.path.replace(/^\//,"")}`;const r=t.filter(e=>e.getTarget()===i&&e.getMessageProcessor()&&e.getMessageProcessor().getId()===this.activeModel.getId());n.push(...r)}if(typeof e.plugin.destroy==="function"){e.plugin.destroy()}}if(n.length>0){e.removeMessages(n)}this.activePlugins=[]}}var c={__esModule:true};c.Engine=u;return c});
 //# sourceMappingURL=Engine.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Engine.js","names":["ConditionEngine","___ConditionEngine","Engine","conditionEngine","activePlugins","build","schema","layoutManager","modelName","this","trackPlugin","plugin","push","type","items","Error","renderTable","title","container","VBox","renderType","props","properties","formProps","tableProps","key","Object","keys","meta","length","addItem","renderForm","tableProp","ui","label","validateAll","isValid","validate","destroy","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\n\nexport class Engine {\n    private conditionEngine: ConditionEngine | null = null;\n    private activePlugins: IPlugin[] = [];\n    \n    public build(schema: ISchema, layoutManager: ILayoutManager, modelName: string = \"meta\"): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n\n        const trackPlugin = (plugin: IPlugin) => this.activePlugins.push(plugin);\n        \n        // Implicit layout routing based on root type\n        if (schema.type === \"array\") {\n            if (!schema.items) {\n                throw new Error(\"[MetaUI] Array schema must define 'items'.\");\n            }\n            return layoutManager.renderTable(schema.items, `${modelName}>/`, schema.title);\n        }\n        \n        if (schema.type === \"object\") {\n            const container = new VBox({ renderType: \"Bare\" });\n            const props = schema.properties || {};\n            \n            // Separate scalar properties (form fields) from root array properties (inline tables)\n            const formProps: Record<string, IPropertyMetadata> = {};\n            const tableProps: { key: string; meta: IPropertyMetadata }[] = [];\n            \n            for (const key of Object.keys(props)) {\n                if (props[key].type === \"array\") {\n                    tableProps.push({ key, meta: props[key] });\n                } else {\n                    formProps[key] = props[key];\n                }\n            }\n            \n            // Render the top-level form if there are scalar fields\n            if (Object.keys(formProps).length > 0) {\n                container.addItem(layoutManager.renderForm(formProps, modelName, schema.title, trackPlugin));\n            }\n            \n            // Render root-level arrays as massive native tables below the form\n            for (const tableProp of tableProps) {\n                if (tableProp.meta.items) {\n                    container.addItem(layoutManager.renderTable(tableProp.meta.items, `${modelName}>/${tableProp.key}`, tableProp.meta.ui?.label || tableProp.key));\n                }\n            }\n            \n            return container;\n        }\n        \n        throw new Error(`[MetaUI] Unsupported schema type: ${schema.type}`);\n    }\n\n    public validateAll(): boolean {\n        let isValid = true;\n        for (const plugin of this.activePlugins) {\n            if (!plugin.validate()) {\n                isValid = false;\n            }\n        }\n        return isValid;\n    }\n\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"4EAAA,MAQSA,EAAeC,EAAA,mBAIjB,MAAMC,EACDC,gBAA0C,KAC1CC,cAA2B,GAE5BC,MAAMC,EAAiBC,EAA+BC,EAAoB,QAC7EC,KAAKN,gBAAkB,IAAIH,EAAgBM,GAC3CG,KAAKL,cAAgB,GAErB,MAAMM,EAAeC,GAAoBF,KAAKL,cAAcQ,KAAKD,GAGjE,GAAIL,EAAOO,OAAS,QAAS,CACzB,IAAKP,EAAOQ,MAAO,CACf,MAAM,IAAIC,MAAM,6CACpB,CACA,OAAOR,EAAcS,YAAYV,EAAOQ,MAAO,GAAGN,MAAeF,EAAOW,MAC5E,CAEA,GAAIX,EAAOO,OAAS,SAAU,CAC1B,MAAMK,EAAY,IAAIC,EAAK,CAAEC,WAAY,SACzC,MAAMC,EAAQf,EAAOgB,YAAc,CAAC,EAGpC,MAAMC,EAA+C,CAAC,EACtD,MAAMC,EAAyD,GAE/D,IAAK,MAAMC,KAAOC,OAAOC,KAAKN,GAAQ,CAClC,GAAIA,EAAMI,GAAKZ,OAAS,QAAS,CAC7BW,EAAWZ,KAAK,CAAEa,MAAKG,KAAMP,EAAMI,IACvC,KAAO,CACHF,EAAUE,GAAOJ,EAAMI,EAC3B,CACJ,CAGA,GAAIC,OAAOC,KAAKJ,GAAWM,OAAS,EAAG,CACnCX,EAAUY,QAAQvB,EAAcwB,WAAWR,EAAWf,EAAWF,EAAOW,MAAOP,GACnF,CAGA,IAAK,MAAMsB,KAAaR,EAAY,CAChC,GAAIQ,EAAUJ,KAAKd,MAAO,CACtBI,EAAUY,QAAQvB,EAAcS,YAAYgB,EAAUJ,KAAKd,MAAO,GAAGN,MAAcwB,EAAUP,MAAOO,EAAUJ,KAAKK,IAAIC,OAASF,EAAUP,KAC9I,CACJ,CAEA,OAAOP,CACX,CAEA,MAAM,IAAIH,MAAM,qCAAqCT,EAAOO,OAChE,CAEOsB,cACH,IAAIC,EAAU,KACd,IAAK,MAAMzB,KAAUF,KAAKL,cAAe,CACrC,IAAKO,EAAO0B,WAAY,CACpBD,EAAU,KACd,CACJ,CACA,OAAOA,CACX,CAEOE,UACH,GAAI7B,KAAKN,gBAAiB,CACtBM,KAAKN,gBAAgBmC,UACrB7B,KAAKN,gBAAkB,IAC3B,CACAM,KAAKL,cAAgB,EACzB,EACH,IAAAmC,EAAA,CAAAC,WAAA,MAAAD,EAAArC,SAAA,OAAAqC,CAAA","ignoreList":[]}
+{"version":3,"file":"Engine.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isDisplayMode","constructor","displayMode","this","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","layoutRegistry","getStrict","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getInstance","getPlugin","ui","widget","setDisplayMode","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","errors","item","result","validate","replace","name","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Registry } from \"./Registry\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It is NOT a God Class; it strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Global registry of all available layout strategies (e.g. Form, Table, Wizard). */\n    public static layoutRegistry: Registry<ILayoutManager>;\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n    \n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n    \n    private activeModel?: sap.ui.model.Model;\n    \n    /** Tracks whether the entire engine is running in Read-Only Display mode. */\n    public readonly isDisplayMode: boolean = false;\n\n    constructor(displayMode: boolean = false) {\n        this.isDisplayMode = displayMode;\n    }\n    \n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n        \n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);\n            \n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            plugin.setDisplayMode(this.isDisplayMode);\n            \n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);\n            \n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n            \n            return control;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            const result = item.plugin.validate();\n            if (!result.isValid) {\n                // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                errors.push(result);\n                // Add console log to find which plugin fails silently\n                Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n        \n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: any[] = [];\n        \n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = existingMessages.filter((msg: any) => \n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n        \n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n        \n        this.activePlugins = [];\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -5,78 +5,201 @@
 
 import { ISchema, IPropertyMetadata } from "../interfaces/ISchema";
 import { ILayoutManager } from "../interfaces/ILayoutManager";
-import { IPlugin } from "../interfaces/IPlugin";
+import { IPlugin, IPluginValidationResult } from "../interfaces/IPlugin";
 import { ConditionEngine } from "./ConditionEngine";
+import { PluginRegistry } from "./PluginRegistry";
 import Control from "sap/ui/core/Control";
 import VBox from "sap/m/VBox";
+import Text from "sap/m/Text";
+import { Registry } from "./Registry";
+import { Logger } from "../utils/Logger";
+import { DefaultLayoutGenerator } from "./DefaultLayoutGenerator";
+import Core from "sap/ui/core/Core";
+import Messaging from "sap/ui/core/Messaging";
 
+/**
+ * The Engine is responsible for translating a normalized schema into a physical UI5 layout.
+ * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.
+ * It is NOT a God Class; it strictly routes execution flow and tracks active plugins for validation.
+ * It embodies the "Plugin-First Philosophy" by routing all complex field and layout rendering
+ * through discrete, decoupled plugins rather than handling native overrides.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
+ */
 export class Engine {
+    /** Global registry of all available layout strategies (e.g. Form, Table, Wizard). */
+    public static layoutRegistry: Registry<ILayoutManager>;
+    /** Handles dynamic conditional logic across the active form. */
     private conditionEngine: ConditionEngine | null = null;
-    private activePlugins: IPlugin[] = [];
     
-    public build(schema: ISchema, layoutManager: ILayoutManager, modelName: string = "meta"): Control {
+    /** Array of all instantiated plugins generated during the current build. */
+    private activePlugins: { plugin: IPlugin, path: string }[] = [];
+
+    /** Deterministic scope ID injected by the host control to prevent clone collisions. */
+    public engineScopeId?: string;
+    
+    private activeModel?: sap.ui.model.Model;
+    
+    /** Tracks whether the entire engine is running in Read-Only Display mode. */
+    public readonly isDisplayMode: boolean = false;
+
+    constructor(displayMode: boolean = false) {
+        this.isDisplayMode = displayMode;
+    }
+    
+    /**
+     * Bootstraps the layout generation process by resolving the correct layout strategy.
+     * 
+     * @param schema The normalized JSON schema representing the view.
+     * @param model The active StateManager JSONModel instance.
+     * @param modelName The UI5 model alias used for isolation.
+     * @param onSubmit Callback fired when form is submitted.
+     * @param engineScopeId Deterministic scope ID for this engine instance.
+     * @param onChange Callback fired when field values change.
+     * @returns The generated root UI5 Control container.
+     */
+    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = "meta", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {
         this.conditionEngine = new ConditionEngine(schema);
         this.activePlugins = [];
-
-        const trackPlugin = (plugin: IPlugin) => this.activePlugins.push(plugin);
-        
-        // Implicit layout routing based on root type
-        if (schema.type === "array") {
-            if (!schema.items) {
-                throw new Error("[MetaUI] Array schema must define 'items'.");
+        this.activeModel = model;
+        this.engineScopeId = engineScopeId;
+        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {
+            if (this.conditionEngine && fieldKey) {
+                this.conditionEngine.handleEvent(fieldKey, isValid);
             }
-            return layoutManager.renderTable(schema.items, `${modelName}>/`, schema.title);
-        }
+            if (onChange) {
+                onChange(isValid, fieldKey, errorMessage, controlId);
+            }
+        };
         
-        if (schema.type === "object") {
-            const container = new VBox({ renderType: "Bare" });
-            const props = schema.properties || {};
-            
-            // Separate scalar properties (form fields) from root array properties (inline tables)
-            const formProps: Record<string, IPropertyMetadata> = {};
-            const tableProps: { key: string; meta: IPropertyMetadata }[] = [];
-            
-            for (const key of Object.keys(props)) {
-                if (props[key].type === "array") {
-                    tableProps.push({ key, meta: props[key] });
-                } else {
-                    formProps[key] = props[key];
-                }
+        try {
+            // Intercept and synthesize a default layout if the developer/backend failed to provide one
+            if (DefaultLayoutGenerator.ensureLayout(schema)) {
+                Logger.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.");
             }
+
+            const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
+            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);
             
-            // Render the top-level form if there are scalar fields
-            if (Object.keys(formProps).length > 0) {
-                container.addItem(layoutManager.renderForm(formProps, modelName, schema.title, trackPlugin));
+            return layoutManager.render(schema, modelName, this, onSubmit);
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error("[MetaUI Engine] Critical error during layout generation", msg);
+            Logger.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${msg}`);
+            return new Text({ text: "Critical Layout Error" });
+        }
+    }
+
+    /**
+     * Instantiates the correct plugin for a specific field based on type and widget hints,
+     * and tracks the plugin for global validation.
+     * 
+     * @param fieldMeta The metadata schema specific to the field.
+     * @param bindingPath The JSON path representing the field within the payload.
+     * @param modelName The UI5 JSONModel name used for data binding.
+     * @returns The generated UI5 Control for the field.
+     */
+    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {
+        try {
+            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || "string", fieldMeta.ui?.widget);
+            plugin.setDisplayMode(this.isDisplayMode);
+            
+            if (!isTemplate) {
+                this.activePlugins.push({ plugin, path: bindingPath });
             }
+            const scopeId = isTemplate ? undefined : this.engineScopeId;
+            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);
             
-            // Render root-level arrays as massive native tables below the form
-            for (const tableProp of tableProps) {
-                if (tableProp.meta.items) {
-                    container.addItem(layoutManager.renderTable(tableProp.meta.items, `${modelName}>/${tableProp.key}`, tableProp.meta.ui?.label || tableProp.key));
-                }
+            if (this.conditionEngine) {
+                this.conditionEngine.registerPlugin(bindingPath, plugin);
             }
             
-            return container;
+            return control;
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);
+            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\n\nDetails: ${msg}`);
+            return new Text({ text: `[Error generating field ${bindingPath}]` });
         }
-        
-        throw new Error(`[MetaUI] Unsupported schema type: ${schema.type}`);
     }
 
-    public validateAll(): boolean {
-        let isValid = true;
-        for (const plugin of this.activePlugins) {
-            if (!plugin.validate()) {
-                isValid = false;
+    /**
+     * Generates a sub-layout (like an embedded table or nested form) without 
+     * destroying the current Engine state or Condition tracking.
+     * 
+     * @param schema The normalized JSON schema representing the view.
+     * @param modelName The UI5 JSONModel name used for data binding (defaults to "meta").
+     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.
+     * @returns The generated root UI5 Control container.
+     */
+    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {
+        try {
+            const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
+            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);
+            return layoutManager.render(schema, modelName, this, undefined, bindingPath);
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);
+            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${msg}`);
+            return new Text({ text: "Critical Sub-Layout Error" });
+        }
+    }
+
+    /**
+     * Iterates through all active plugins and triggers their internal validation pipelines.
+     * 
+     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
+     */
+    public validateAll(): IPluginValidationResult[] {
+        const errors: IPluginValidationResult[] = [];
+        for (const item of this.activePlugins) {
+            const result = item.plugin.validate();
+            if (!result.isValid) {
+                // Ensure the path is bound to the error so GeneratorHost knows where to target it
+                result.fieldKey = result.fieldKey || item.path.replace(/^\//, "");
+                errors.push(result);
+                // Add console log to find which plugin fails silently
+                Logger.error("[MetaUI Validation] Plugin failed validation silently:", item.path || item.plugin.constructor.name);
             }
         }
-        return isValid;
+        return errors;
     }
 
+    /**
+     * Cleans up internal state and destroys the condition engine to prevent memory leaks.
+     */
     public destroy(): void {
         if (this.conditionEngine) {
             this.conditionEngine.destroy();
             this.conditionEngine = null;
         }
+        
+        // ------------------------------------------------------------------------
+        // Ghost Error Prevention
+        // Flush MessageManager for active plugins before destroying their controls
+        // ------------------------------------------------------------------------
+        const messageManager = Messaging;
+        const existingMessages = messageManager.getMessageModel().getData();
+        const messagesToRemove: any[] = [];
+        
+        for (const item of this.activePlugins) {
+            if (this.activeModel) {
+                const targetPath = `/${item.path.replace(/^\//, "")}`;
+                const matched = existingMessages.filter((msg: any) => 
+                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()
+                );
+                messagesToRemove.push(...matched);
+            }
+            if (typeof item.plugin.destroy === "function") {
+                item.plugin.destroy();
+            }
+        }
+        
+        if (messagesToRemove.length > 0) {
+            messageManager.removeMessages(messagesToRemove);
+        }
+        
         this.activePlugins = [];
     }
 }

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

@@ -0,0 +1,32 @@
+sap.ui.define(["./Registry", "../layouts/FormLayout", "../layouts/TableLayout", "../layouts/WizardLayout", "../layouts/CompactLayout", "./Engine"], function (___Registry, ___layouts_FormLayout, ___layouts_TableLayout, ___layouts_WizardLayout, ___layouts_CompactLayout, ___Engine) {
+  "use strict";
+
+  /**
+   * @file LayoutRegistry.ts
+   * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).
+   */
+  const Registry = ___Registry["Registry"];
+  const FormLayout = ___layouts_FormLayout["FormLayout"];
+  const TableLayout = ___layouts_TableLayout["TableLayout"];
+  const WizardLayout = ___layouts_WizardLayout["WizardLayout"];
+  const CompactLayout = ___layouts_CompactLayout["CompactLayout"];
+  const Engine = ___Engine["Engine"];
+  /** 
+   * The globally exposed registry containing instantiations of the layout strategies.
+   * It is injected directly into the Engine to avoid circular dependencies.
+   * 
+   * @public
+   */
+  const LayoutRegistry = new Registry("Layouts");
+  LayoutRegistry.register("form", new FormLayout());
+  LayoutRegistry.register("table", new TableLayout());
+  LayoutRegistry.register("wizard", new WizardLayout());
+  LayoutRegistry.register("compact", new CompactLayout());
+  Engine.layoutRegistry = LayoutRegistry;
+  var __exports = {
+    __esModule: true
+  };
+  __exports.LayoutRegistry = LayoutRegistry;
+  return __exports;
+});
+//# sourceMappingURL=LayoutRegistry-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRegistry-dbg.js","names":["Registry","___Registry","FormLayout","___layouts_FormLayout","TableLayout","___layouts_TableLayout","WizardLayout","___layouts_WizardLayout","CompactLayout","___layouts_CompactLayout","Engine","___Engine","LayoutRegistry","register","layoutRegistry","__exports","__esModule"],"sources":["LayoutRegistry.ts"],"sourcesContent":["/**\n * @file LayoutRegistry.ts\n * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).\n */\nimport { Registry } from \"./Registry\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { FormLayout } from \"../layouts/FormLayout\";\nimport { TableLayout } from \"../layouts/TableLayout\";\nimport { WizardLayout } from \"../layouts/WizardLayout\";\nimport { CompactLayout } from \"../layouts/CompactLayout\";\nimport { Engine } from \"./Engine\";\n\n/** \n * The globally exposed registry containing instantiations of the layout strategies.\n * It is injected directly into the Engine to avoid circular dependencies.\n * \n * @public\n */\nexport const LayoutRegistry = new Registry<ILayoutManager>(\"Layouts\");\n\nLayoutRegistry.register(\"form\", new FormLayout());\nLayoutRegistry.register(\"table\", new TableLayout());\nLayoutRegistry.register(\"wizard\", new WizardLayout());\nLayoutRegistry.register(\"compact\", new CompactLayout());\n\nEngine.layoutRegistry = LayoutRegistry;\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAISA,QAAQ,GAAAC,WAAA;EAAA,MAERC,UAAU,GAAAC,qBAAA;EAAA,MACVC,WAAW,GAAAC,sBAAA;EAAA,MACXC,YAAY,GAAAC,uBAAA;EAAA,MACZC,aAAa,GAAAC,wBAAA;EAAA,MACbC,MAAM,GAAAC,SAAA;EAEf;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,cAAc,GAAG,IAAIZ,QAAQ,CAAiB,SAAS,CAAC;EAErEY,cAAc,CAACC,QAAQ,CAAC,MAAM,EAAE,IAAIX,UAAU,CAAC,CAAC,CAAC;EACjDU,cAAc,CAACC,QAAQ,CAAC,OAAO,EAAE,IAAIT,WAAW,CAAC,CAAC,CAAC;EACnDQ,cAAc,CAACC,QAAQ,CAAC,QAAQ,EAAE,IAAIP,YAAY,CAAC,CAAC,CAAC;EACrDM,cAAc,CAACC,QAAQ,CAAC,SAAS,EAAE,IAAIL,aAAa,CAAC,CAAC,CAAC;EAEvDE,MAAM,CAACI,cAAc,GAAGF,cAAc;EAAC,IAAAG,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAH,cAAA,GAAAA,cAAA;EAAA,OAAAG,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,16 @@
+declare module "nz/co/siliconst/ui5/metaui/core/LayoutRegistry" {
+    /**
+     * @file LayoutRegistry.ts
+     * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).
+     */
+    import { Registry } from "nz/co/siliconst/ui5/metaui/core/Registry";
+    import { ILayoutManager } from "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager";
+    /**
+     * The globally exposed registry containing instantiations of the layout strategies.
+     * It is injected directly into the Engine to avoid circular dependencies.
+     *
+     * @public
+     */
+    export const LayoutRegistry: Registry<ILayoutManager>;
+}
+//# sourceMappingURL=LayoutRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRegistry.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/LayoutRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,gDAAgD,CAAC;IAChE;;;OAGG;IACH,OAAO,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;IACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;IAOtF;;;;;OAKG;IACI,MAAM,cAAc,0BAA0C,CAAC;CASrE"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["./Registry","../layouts/FormLayout","../layouts/TableLayout","../layouts/WizardLayout","../layouts/CompactLayout","./Engine"],function(t,o,e,a,s,r){"use strict";const u=t["Registry"];const n=o["FormLayout"];const y=e["TableLayout"];const i=a["WizardLayout"];const c=s["CompactLayout"];const g=r["Engine"];const L=new u("Layouts");L.register("form",new n);L.register("table",new y);L.register("wizard",new i);L.register("compact",new c);g.layoutRegistry=L;var l={__esModule:true};l.LayoutRegistry=L;return l});
+//# sourceMappingURL=LayoutRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRegistry.js","names":["Registry","___Registry","FormLayout","___layouts_FormLayout","TableLayout","___layouts_TableLayout","WizardLayout","___layouts_WizardLayout","CompactLayout","___layouts_CompactLayout","Engine","___Engine","LayoutRegistry","register","layoutRegistry","__exports","__esModule"],"sources":["LayoutRegistry.ts"],"sourcesContent":["/**\n * @file LayoutRegistry.ts\n * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).\n */\nimport { Registry } from \"./Registry\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { FormLayout } from \"../layouts/FormLayout\";\nimport { TableLayout } from \"../layouts/TableLayout\";\nimport { WizardLayout } from \"../layouts/WizardLayout\";\nimport { CompactLayout } from \"../layouts/CompactLayout\";\nimport { Engine } from \"./Engine\";\n\n/** \n * The globally exposed registry containing instantiations of the layout strategies.\n * It is injected directly into the Engine to avoid circular dependencies.\n * \n * @public\n */\nexport const LayoutRegistry = new Registry<ILayoutManager>(\"Layouts\");\n\nLayoutRegistry.register(\"form\", new FormLayout());\nLayoutRegistry.register(\"table\", new TableLayout());\nLayoutRegistry.register(\"wizard\", new WizardLayout());\nLayoutRegistry.register(\"compact\", new CompactLayout());\n\nEngine.layoutRegistry = LayoutRegistry;\n"],"mappings":"iLAAA,MAISA,EAAQC,EAAA,kBAERC,EAAUC,EAAA,oBACVC,EAAWC,EAAA,qBACXC,EAAYC,EAAA,sBACZC,EAAaC,EAAA,uBACbC,EAAMC,EAAA,UAQR,MAAMC,EAAiB,IAAIZ,EAAyB,WAE3DY,EAAeC,SAAS,OAAQ,IAAIX,GACpCU,EAAeC,SAAS,QAAS,IAAIT,GACrCQ,EAAeC,SAAS,SAAU,IAAIP,GACtCM,EAAeC,SAAS,UAAW,IAAIL,GAEvCE,EAAOI,eAAiBF,EAAe,IAAAG,EAAA,CAAAC,WAAA,MAAAD,EAAAH,iBAAA,OAAAG,CAAA","ignoreList":[]}

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

@@ -0,0 +1,26 @@
+/**
+ * @file LayoutRegistry.ts
+ * @description Centralized registry for all available layout managers (e.g. Form, Table, Wizard).
+ */
+import { Registry } from "./Registry";
+import { ILayoutManager } from "../interfaces/ILayoutManager";
+import { FormLayout } from "../layouts/FormLayout";
+import { TableLayout } from "../layouts/TableLayout";
+import { WizardLayout } from "../layouts/WizardLayout";
+import { CompactLayout } from "../layouts/CompactLayout";
+import { Engine } from "./Engine";
+
+/** 
+ * The globally exposed registry containing instantiations of the layout strategies.
+ * It is injected directly into the Engine to avoid circular dependencies.
+ * 
+ * @public
+ */
+export const LayoutRegistry = new Registry<ILayoutManager>("Layouts");
+
+LayoutRegistry.register("form", new FormLayout());
+LayoutRegistry.register("table", new TableLayout());
+LayoutRegistry.register("wizard", new WizardLayout());
+LayoutRegistry.register("compact", new CompactLayout());
+
+Engine.layoutRegistry = LayoutRegistry;

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

@@ -0,0 +1,123 @@
+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 (___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) {
+  "use strict";
+
+  /**
+   * @file PipelineManager.ts
+   * @description Central manager for the data manipulation pipeline. 
+   * Orchestrates Formatting, Parsing, and Validating data using the generic Registry.
+   */
+  const Registry = ___Registry["Registry"];
+  const PatternValidatorPlugin = ___plugins_validators_PatternValidatorPlugin["PatternValidatorPlugin"];
+  const MinLengthValidatorPlugin = ___plugins_validators_MinLengthValidatorPlugin["MinLengthValidatorPlugin"];
+  const RangeValidatorPlugin = ___plugins_validators_RangeValidatorPlugin["RangeValidatorPlugin"];
+  const UrlValidatorPlugin = ___plugins_validators_UrlValidatorPlugin["UrlValidatorPlugin"];
+  const IbanValidatorPlugin = ___plugins_validators_IbanValidatorPlugin["IbanValidatorPlugin"];
+  const EmailValidatorPlugin = ___plugins_validators_EmailValidatorPlugin["EmailValidatorPlugin"];
+  const DateFormatterPlugin = ___plugins_formatters_DateFormatterPlugin["DateFormatterPlugin"];
+  const PhoneFormatterPlugin = ___plugins_formatters_PhoneFormatterPlugin["PhoneFormatterPlugin"];
+  const TextCaseFormatterPlugin = ___plugins_formatters_TextCaseFormatterPlugin["TextCaseFormatterPlugin"];
+  const Logger = ___utils_Logger["Logger"]; // --- Built-in Default Validators ---
+  class RequiredValidator {
+    validate(parsedValue, args) {
+      if (parsedValue === null || parsedValue === undefined || parsedValue === "") {
+        return {
+          isValid: false,
+          errorMessage: "This field is required."
+        };
+      }
+      return {
+        isValid: true
+      };
+    }
+  }
+  class MaxLengthValidator {
+    validate(parsedValue, args) {
+      if (typeof parsedValue === "string" && args && typeof args === "number") {
+        if (parsedValue.length > args) {
+          return {
+            isValid: false,
+            errorMessage: `Maximum length is ${args} characters.`
+          };
+        }
+      }
+      return {
+        isValid: true
+      };
+    }
+  }
+
+  /**
+   * The core engine responsible for marshalling data through the validation, formatting, and parsing phases.
+   * Pluggable design allows new validators to be registered dynamically.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.core
+   * @public
+   */
+  class PipelineManager {
+    /** Registry of data formatters applied before pushing to the UI. */
+    formatters = new Registry("Formatters");
+    /** Registry of data parsers applied when pulling data from the UI. */
+    parsers = new Registry("Parsers");
+    /** Registry of business logic validators. */
+    validators = new Registry("Validators");
+
+    /**
+     * Bootstraps the PipelineManager with default validators (required, maxLength, email).
+     */
+    constructor() {
+      // Register default validators
+      this.validators.register("required", new RequiredValidator());
+      this.validators.register("maxLength", new MaxLengthValidator());
+      this.validators.register("pattern", new PatternValidatorPlugin());
+      this.validators.register("minLength", new MinLengthValidatorPlugin());
+      this.validators.register("range", new RangeValidatorPlugin());
+      this.validators.register("url", new UrlValidatorPlugin());
+      this.validators.register("iban", new IbanValidatorPlugin());
+      this.validators.register("email", new EmailValidatorPlugin());
+
+      // Register default formatters
+      this.formatters.register("date", new DateFormatterPlugin());
+      this.formatters.register("phone", new PhoneFormatterPlugin());
+      this.formatters.register("textCase", new TextCaseFormatterPlugin());
+    }
+
+    /**
+     * Executes the validation pipeline sequentially. Fails fast on the first encountered error.
+     * 
+     * @param parsedValue The raw extracted value from the UI control.
+     * @param requestedValidators Array of validation rule keys (e.g. ['required', 'email']).
+     * @param argsMap Optional map of parameters required by specific rules (e.g. { maxLength: 50 }).
+     * @returns {IValidationResult} The final result state and any associated error message.
+     */
+    executeValidation(parsedValue, requestedValidators, argsMap) {
+      for (const rule of requestedValidators) {
+        const validator = this.validators.get(rule);
+        if (validator) {
+          const args = argsMap ? argsMap[rule] : undefined;
+          const result = validator.validate(parsedValue, args);
+          if (!result.isValid) {
+            return result; // Fast fail on first error
+          }
+        } else {
+          Logger.warn(`[MetaUI] PipelineManager: Requested validator '${rule}' not found in registry.`);
+        }
+      }
+      return {
+        isValid: true
+      };
+    }
+  }
+
+  /** 
+   * Singleton instance for global access to the active validation pipeline. 
+   * @public 
+   */
+  const GlobalPipeline = new PipelineManager();
+  var __exports = {
+    __esModule: true
+  };
+  __exports.PipelineManager = PipelineManager;
+  __exports.GlobalPipeline = GlobalPipeline;
+  return __exports;
+});
+//# sourceMappingURL=PipelineManager-dbg.js.map