@siliconst/metaui 1.2.0 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/layouts/FormLayout-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormLayout-dbg.js","names":["PluginRegistry","___core_PluginRegistry","FormLayout","build","properties","modelName","formTitle","trackPlugin","form","SimpleForm","editable","title","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","registry","getInstance","groups","DEFAULT_GROUP","key","Object","keys","meta","groupName","ui","group","push","addContent","Title","text","forEach","field","label","Label","required","visibleOn","expr","replace","bindProperty","parts","path","formatter","plugin","getPlugin","type","widget","control","render","fullWidth","sap","require","GridData","setLayoutData","span","error","Log","message","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\n * @file FormLayout.ts\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\n */\n\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\nimport Label from \"sap/m/Label\";\nimport Title from \"sap/ui/core/Title\";\nimport { IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\nimport { IPlugin } from \"../interfaces/IPlugin\";\n\nexport class FormLayout {\n    /**\n     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.\n     * @param properties The dictionary of fields to render.\n     * @param modelName The dynamic model name.\n     * @param formTitle Optional title for the form block.\n     * @param trackPlugin Optional callback to track instantiated plugins.\n     */\n    public static build(properties: Record<string, IPropertyMetadata>, modelName: string = \"meta\", formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): SimpleForm {\n        const form = new SimpleForm({\n            editable: true,\n            title: formTitle,\n            layout: \"ResponsiveGridLayout\",\n            labelSpanXL: 4,\n            labelSpanL: 4,\n            labelSpanM: 4,\n            labelSpanS: 12,\n            adjustLabelSpan: false,\n            emptySpanXL: 0,\n            emptySpanL: 0,\n            emptySpanM: 0,\n            emptySpanS: 0,\n            columnsXL: 1,\n            columnsL: 1,\n            columnsM: 1,\n            singleContainerFullSize: false\n        });\n\n        const registry = PluginRegistry.getInstance();\n        \n        // Group fields by their ui.group directive\n        const groups: Record<string, { key: string; meta: IPropertyMetadata }[]> = {};\n        const DEFAULT_GROUP = \"__DEFAULT__\";\n        \n        for (const key of Object.keys(properties)) {\n            const meta = properties[key];\n            const groupName = meta.ui?.group || DEFAULT_GROUP;\n            if (!groups[groupName]) groups[groupName] = [];\n            groups[groupName].push({ key, meta });\n        }\n\n        // Render groups\n        for (const groupName of Object.keys(groups)) {\n            if (groupName !== DEFAULT_GROUP) {\n                form.addContent(new Title({ text: groupName }));\n            }\n            \n            groups[groupName].forEach((field) => {\n                try {\n                    const label = new Label({\n                        text: field.meta.ui?.label || field.key,\n                        required: field.meta.required\n                    });\n\n                    // Attach visibility condition to label and control container logic\n                    if (field.meta.ui?.visibleOn) {\n                        const expr = `{= ${field.meta.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n                        label.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false}); // temporary, condition engine does this usually\n                    }\n\n                    const plugin = registry.getPlugin(field.meta.type, field.meta.ui?.widget);\n                    if (trackPlugin) trackPlugin(plugin);\n                    const control = plugin.render(field.meta, `/${field.key}`, modelName);\n\n                    if (field.meta.ui?.fullWidth) {\n                        sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                            control.setLayoutData(new GridData({\n                                span: \"XL12 L12 M12 S12\"\n                            }));\n                        });\n                    }\n\n                    form.addContent(label);\n                    form.addContent(control);\n                } catch (error) {\n                    sap.ui.require([\"sap/base/Log\"], (Log: any) => {\n                        if (Log) Log.error(`[MetaUI] Failed to render field ${field.key}`, (error as Error).message, \"FormLayout\");\n                    });\n                }\n            });\n        }\n\n        return form;\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"FormLayout-dbg.js","names":["Logger","___utils_Logger","FormLayout","render","schema","modelName","engine","onSubmit","container","VBox","renderType","form","SimpleForm","editable","title","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","uiLayout","Array","isArray","warn","addItem","tableElements","hasFormFields","renderElement","element","type","label","addContent","Title","text","elements","forEach","scope","startsWith","error","propKey","replace","meta","properties","isCollectionOfRecords","items","hasExplicitWidget","ui","widget","isSubLayout","debug","push","_renderScalarField","field","subSchema","control","generateLayout","addStyleClass","msg","message","showErrorPopup","labelText","Label","required","effectiveMeta","generateField","fullWidth","sap","require","GridData","setLayoutData","span","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\n * @file FormLayout.ts\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\n */\n\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\nimport Label from \"sap/m/Label\";\nimport Title from \"sap/ui/core/Title\";\nimport VBox from \"sap/m/VBox\";\nimport { IPropertyMetadata, ISchema, ILayoutElement } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { Engine } from \"../core/Engine\";\nimport { Logger } from \"../utils/Logger\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Layout Manager responsible for generating a fully responsive SAP Fiori SimpleForm.\n * It traverses the `uiLayout` tree defined in the schema to build the form groups and fields,\n * completely separating visual orchestration from data modeling.\n * @namespace nz.co.siliconst.ui5.metaui.layouts\n * @public\n */\nexport class FormLayout implements ILayoutManager {\n    /**\n     * Renders the JSON Schema properties into a UI5 SimpleForm using the uiLayout definitions.\n     * \n     * @param schema The active JSON schema subset.\n     * @param modelName The bound UI5 model name.\n     * @param engine The central orchestrator for delegating plugin generation.\n     * @param onSubmit Optional submit hook.\n     * @returns {Control} The VBox wrapper containing the generated form.\n     */\n    public render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control {\n        const container = new VBox({ renderType: \"Bare\" });\n        const form = new SimpleForm({\n            editable: true,\n            title: schema.title,\n            layout: \"ResponsiveGridLayout\",\n            labelSpanXL: 4, labelSpanL: 4, labelSpanM: 4, labelSpanS: 12,\n            adjustLabelSpan: false,\n            emptySpanXL: 0, emptySpanL: 0, emptySpanM: 0, emptySpanS: 0,\n            columnsXL: 1, columnsL: 1, columnsM: 1,\n            singleContainerFullSize: false\n        });\n\n        if (!schema.uiLayout || !Array.isArray(schema.uiLayout)) {\n            Logger.warn(\"[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.\");\n            container.addItem(form);\n            return container;\n        }\n\n        const tableElements: { scope: string, meta: IPropertyMetadata, label?: string }[] = [];\n        let hasFormFields = false;\n\n        // Recursively render layout elements\n        const renderElement = (element: ILayoutElement) => {\n            if (element.type === \"Group\") {\n                if (element.label) {\n                    form.addContent(new Title({ text: element.label }));\n                }\n                \n                if (element.elements && Array.isArray(element.elements)) {\n                    element.elements.forEach(renderElement);\n                }\n            } else if (element.type === \"Control\") {\n                if (!element.scope || !element.scope.startsWith(\"#/properties/\")) {\n                    Logger.error(`[MetaUI] Invalid scope '${element.scope}' in uiLayout Control.`, \"\", \"FormLayout\");\n                    return;\n                }\n                \n                const propKey = element.scope.replace(\"#/properties/\", \"\");\n                const meta = schema.properties?.[propKey];\n                \n                if (!meta) {\n                    Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions.`, \"\", \"FormLayout\");\n                    return;\n                }\n\n                // Architectural Boundary: Separate Field Controls (Plugins) from Sub-Layouts (LayoutManagers)\n                // A property is delegated to a Sub-Layout Manager (Table) ONLY if it represents a collection of complex objects.\n                // Collections of primitives, or explicitly assigned widgets (like multiSelect), remain in the Form as Field Plugins.\n                const isCollectionOfRecords = meta.items?.type === \"object\" || meta.items?.properties;\n                const hasExplicitWidget = !!meta.ui?.widget;\n                const isSubLayout = meta.type === \"array\" && isCollectionOfRecords && !hasExplicitWidget;\n\n                if (isSubLayout) {\n                    Logger.debug(\"[MetaUI FormLayout]\", `Routing property '${propKey}' to Table Sub-Layout.`, \"FormLayout\");\n                    tableElements.push({ scope: propKey, meta, label: element.label });\n                } else {\n                    hasFormFields = true;\n                    Logger.debug(\"[MetaUI FormLayout]\", `Rendering scalar field '${propKey}'.`, \"FormLayout\");\n                    this._renderScalarField(form, element, propKey, meta, modelName, engine);\n                }\n            } else {\n                Logger.warn(`[MetaUI] Unsupported layout element type '${element.type}'.`, \"\", \"FormLayout\");\n            }\n        };\n\n        // Render everything defined in the layout\n        schema.uiLayout.forEach(renderElement);\n\n        if (hasFormFields) {\n            container.addItem(form);\n        }\n\n        // Render array/table sub-layouts full width below the form\n        tableElements.forEach(field => {\n            try {\n                const subSchema = {\n                    type: \"array\",\n                    title: field.label || field.meta.ui?.label || field.scope,\n                    items: field.meta.items || { type: \"object\", properties: {} },\n                    uiLayout: field.meta.items?.uiLayout // Pass down sub-layout if available\n                };\n                \n                const control = engine.generateLayout(subSchema as ISchema, modelName, `/${field.scope}`);\n                if (control) {\n                    control.addStyleClass(\"sapUiSmallMarginTop\");\n                    container.addItem(control);\n                }\n            } catch (error) {\n                const msg = (error as Error).message;\n                Logger.error(`[MetaUI] Failed to render array field ${field.scope}`, msg, \"FormLayout\");\n                Logger.showErrorPopup(`Failed to render array field '${field.scope}'.\\n\\nDetails: ${msg}`);\n            }\n        });\n\n        return container;\n    }\n\n    private _renderScalarField(form: SimpleForm, element: ILayoutElement, propKey: string, meta: IPropertyMetadata, modelName: string, engine: Engine): void {\n        try {\n            const labelText = element.label || meta.ui?.label || propKey;\n            const label = new Label({\n                text: labelText,\n                required: meta.required\n            });\n\n            // Override widget if specified in the layout element\n            const effectiveMeta = { ...meta };\n            if (element.widget) {\n                effectiveMeta.ui = { ...meta.ui, widget: element.widget };\n            }\n\n            const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);\n\n            if (effectiveMeta.ui?.fullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                    control.setLayoutData(new GridData({ span: \"XL12 L12 M12 S12\" }));\n                });\n            }\n\n            form.addContent(label);\n            form.addContent(control);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, \"FormLayout\");\n            Logger.showErrorPopup(`Failed to render field '${propKey}'.\\n\\nDetails: ${msg}`);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.d.ts

@@ -1,20 +1,27 @@
 declare module "nz/co/siliconst/ui5/metaui/layouts/FormLayout" {
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import { ILayoutManager } from "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager";
+    import { Engine } from "nz/co/siliconst/ui5/metaui/core/Engine";
+    import Control from "sap/ui/core/Control";
     /**
-     * @file FormLayout.ts
-     * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).
+     * Layout Manager responsible for generating a fully responsive SAP Fiori SimpleForm.
+     * It traverses the `uiLayout` tree defined in the schema to build the form groups and fields,
+     * completely separating visual orchestration from data modeling.
+     * @namespace nz.co.siliconst.ui5.metaui.layouts
+     * @public
      */
-    import SimpleForm from "sap/ui/layout/form/SimpleForm";
-    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    import { IPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/IPlugin";
-    export class FormLayout {
+    export class FormLayout implements ILayoutManager {
         /**
-         * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.
-         * @param properties The dictionary of fields to render.
-         * @param modelName The dynamic model name.
-         * @param formTitle Optional title for the form block.
-         * @param trackPlugin Optional callback to track instantiated plugins.
+         * Renders the JSON Schema properties into a UI5 SimpleForm using the uiLayout definitions.
+         *
+         * @param schema The active JSON schema subset.
+         * @param modelName The bound UI5 model name.
+         * @param engine The central orchestrator for delegating plugin generation.
+         * @param onSubmit Optional submit hook.
+         * @returns {Control} The VBox wrapper containing the generated form.
          */
-        static build(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): SimpleForm;
+        render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control;
+        private _renderScalarField;
     }
 }
 //# sourceMappingURL=FormLayout.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormLayout.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;OAGG;IAEH,OAAO,UAAU,MAAM,+BAA+B,CAAC;IAGvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IAExE,MAAa,UAAU;QACnB;;;;;;WAMG;eACW,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,SAAS,GAAE,MAAe,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,UAAU;KA4E1K;CAEA"}
+{"version":3,"file":"FormLayout.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAU/D,OAAO,EAAqB,OAAO,EAAkB,MAAM,+CAA+C,CAAC;IAC3G,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;IACtF,OAAO,EAAE,MAAM,EAAE,MAAM,wCAAwC,CAAC;IAEhE,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAE1C;;;;;;OAMG;IACH,MAAa,UAAW,YAAW,cAAc;QAC7C;;;;;;;;WAQG;QACI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO;QAkGjG,OAAO,CAAC,kBAAkB;KA8B7B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.js

@@ -1,2 +1,2 @@
-sap.ui.define(["sap/ui/layout/form/SimpleForm","sap/m/Label","sap/ui/core/Title","../core/PluginRegistry"],function(e,t,a,n){"use strict";const i=n["PluginRegistry"];class s{static build(n,s="meta",o,r){const l=new e({editable:true,title:o,layout:"ResponsiveGridLayout",labelSpanXL:4,labelSpanL:4,labelSpanM:4,labelSpanS:12,adjustLabelSpan:false,emptySpanXL:0,emptySpanL:0,emptySpanM:0,emptySpanS:0,columnsXL:1,columnsL:1,columnsM:1,singleContainerFullSize:false});const u=i.getInstance();const p={};const c="__DEFAULT__";for(const e of Object.keys(n)){const t=n[e];const a=t.ui?.group||c;if(!p[a])p[a]=[];p[a].push({key:e,meta:t})}for(const e of Object.keys(p)){if(e!==c){l.addContent(new a({text:e}))}p[e].forEach(e=>{try{const a=new t({text:e.meta.ui?.label||e.key,required:e.meta.required});if(e.meta.ui?.visibleOn){const t=`{= ${e.meta.ui.visibleOn.replace(/\$root\./g,`${s}>/`).replace(/\./g,"/")} }`;a.bindProperty("visible",{parts:[{path:"meta>/"}],formatter:()=>false})}const n=u.getPlugin(e.meta.type,e.meta.ui?.widget);if(r)r(n);const i=n.render(e.meta,`/${e.key}`,s);if(e.meta.ui?.fullWidth){sap.ui.require(["sap/ui/layout/GridData"],e=>{i.setLayoutData(new e({span:"XL12 L12 M12 S12"}))})}l.addContent(a);l.addContent(i)}catch(t){sap.ui.require(["sap/base/Log"],a=>{if(a)a.error(`[MetaUI] Failed to render field ${e.key}`,t.message,"FormLayout")})}})}return l}}var o={__esModule:true};o.FormLayout=s;return o});
+sap.ui.define(["sap/ui/layout/form/SimpleForm","sap/m/Label","sap/ui/core/Title","sap/m/VBox","../utils/Logger"],function(e,t,a,r,o){"use strict";const i=o["Logger"];class s{render(t,o,s,n){const l=new r({renderType:"Bare"});const u=new e({editable:true,title:t.title,layout:"ResponsiveGridLayout",labelSpanXL:4,labelSpanL:4,labelSpanM:4,labelSpanS:12,adjustLabelSpan:false,emptySpanXL:0,emptySpanL:0,emptySpanM:0,emptySpanS:0,columnsXL:1,columnsL:1,columnsM:1,singleContainerFullSize:false});if(!t.uiLayout||!Array.isArray(t.uiLayout)){i.warn("[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.");l.addItem(u);return l}const p=[];let d=false;const y=e=>{if(e.type==="Group"){if(e.label){u.addContent(new a({text:e.label}))}if(e.elements&&Array.isArray(e.elements)){e.elements.forEach(y)}}else if(e.type==="Control"){if(!e.scope||!e.scope.startsWith("#/properties/")){i.error(`[MetaUI] Invalid scope '${e.scope}' in uiLayout Control.`,"","FormLayout");return}const a=e.scope.replace("#/properties/","");const r=t.properties?.[a];if(!r){i.error(`[MetaUI] Property '${a}' not found in schema definitions.`,"","FormLayout");return}const n=r.items?.type==="object"||r.items?.properties;const l=!!r.ui?.widget;const y=r.type==="array"&&n&&!l;if(y){i.debug("[MetaUI FormLayout]",`Routing property '${a}' to Table Sub-Layout.`,"FormLayout");p.push({scope:a,meta:r,label:e.label})}else{d=true;i.debug("[MetaUI FormLayout]",`Rendering scalar field '${a}'.`,"FormLayout");this._renderScalarField(u,e,a,r,o,s)}}else{i.warn(`[MetaUI] Unsupported layout element type '${e.type}'.`,"","FormLayout")}};t.uiLayout.forEach(y);if(d){l.addItem(u)}p.forEach(e=>{try{const t={type:"array",title:e.label||e.meta.ui?.label||e.scope,items:e.meta.items||{type:"object",properties:{}},uiLayout:e.meta.items?.uiLayout};const a=s.generateLayout(t,o,`/${e.scope}`);if(a){a.addStyleClass("sapUiSmallMarginTop");l.addItem(a)}}catch(t){const a=t.message;i.error(`[MetaUI] Failed to render array field ${e.scope}`,a,"FormLayout");i.showErrorPopup(`Failed to render array field '${e.scope}'.\n\nDetails: ${a}`)}});return l}_renderScalarField(e,a,r,o,s,n){try{const i=a.label||o.ui?.label||r;const l=new t({text:i,required:o.required});const u={...o};if(a.widget){u.ui={...o.ui,widget:a.widget}}const p=n.generateField(u,`/${r}`,s);if(u.ui?.fullWidth){sap.ui.require(["sap/ui/layout/GridData"],e=>{p.setLayoutData(new e({span:"XL12 L12 M12 S12"}))})}e.addContent(l);e.addContent(p)}catch(e){const t=e.message;i.error(`[MetaUI] Failed to render field ${r}`,t,"FormLayout");i.showErrorPopup(`Failed to render field '${r}'.\n\nDetails: ${t}`)}}}var n={__esModule:true};n.FormLayout=s;return n});
 //# sourceMappingURL=FormLayout.js.map

package/src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormLayout.js","names":["PluginRegistry","___core_PluginRegistry","FormLayout","build","properties","modelName","formTitle","trackPlugin","form","SimpleForm","editable","title","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","registry","getInstance","groups","DEFAULT_GROUP","key","Object","keys","meta","groupName","ui","group","push","addContent","Title","text","forEach","field","label","Label","required","visibleOn","expr","replace","bindProperty","parts","path","formatter","plugin","getPlugin","type","widget","control","render","fullWidth","sap","require","GridData","setLayoutData","span","error","Log","message","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\n * @file FormLayout.ts\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\n */\n\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\nimport Label from \"sap/m/Label\";\nimport Title from \"sap/ui/core/Title\";\nimport { IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\nimport { IPlugin } from \"../interfaces/IPlugin\";\n\nexport class FormLayout {\n    /**\n     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.\n     * @param properties The dictionary of fields to render.\n     * @param modelName The dynamic model name.\n     * @param formTitle Optional title for the form block.\n     * @param trackPlugin Optional callback to track instantiated plugins.\n     */\n    public static build(properties: Record<string, IPropertyMetadata>, modelName: string = \"meta\", formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): SimpleForm {\n        const form = new SimpleForm({\n            editable: true,\n            title: formTitle,\n            layout: \"ResponsiveGridLayout\",\n            labelSpanXL: 4,\n            labelSpanL: 4,\n            labelSpanM: 4,\n            labelSpanS: 12,\n            adjustLabelSpan: false,\n            emptySpanXL: 0,\n            emptySpanL: 0,\n            emptySpanM: 0,\n            emptySpanS: 0,\n            columnsXL: 1,\n            columnsL: 1,\n            columnsM: 1,\n            singleContainerFullSize: false\n        });\n\n        const registry = PluginRegistry.getInstance();\n        \n        // Group fields by their ui.group directive\n        const groups: Record<string, { key: string; meta: IPropertyMetadata }[]> = {};\n        const DEFAULT_GROUP = \"__DEFAULT__\";\n        \n        for (const key of Object.keys(properties)) {\n            const meta = properties[key];\n            const groupName = meta.ui?.group || DEFAULT_GROUP;\n            if (!groups[groupName]) groups[groupName] = [];\n            groups[groupName].push({ key, meta });\n        }\n\n        // Render groups\n        for (const groupName of Object.keys(groups)) {\n            if (groupName !== DEFAULT_GROUP) {\n                form.addContent(new Title({ text: groupName }));\n            }\n            \n            groups[groupName].forEach((field) => {\n                try {\n                    const label = new Label({\n                        text: field.meta.ui?.label || field.key,\n                        required: field.meta.required\n                    });\n\n                    // Attach visibility condition to label and control container logic\n                    if (field.meta.ui?.visibleOn) {\n                        const expr = `{= ${field.meta.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n                        label.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false}); // temporary, condition engine does this usually\n                    }\n\n                    const plugin = registry.getPlugin(field.meta.type, field.meta.ui?.widget);\n                    if (trackPlugin) trackPlugin(plugin);\n                    const control = plugin.render(field.meta, `/${field.key}`, modelName);\n\n                    if (field.meta.ui?.fullWidth) {\n                        sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                            control.setLayoutData(new GridData({\n                                span: \"XL12 L12 M12 S12\"\n                            }));\n                        });\n                    }\n\n                    form.addContent(label);\n                    form.addContent(control);\n                } catch (error) {\n                    sap.ui.require([\"sap/base/Log\"], (Log: any) => {\n                        if (Log) Log.error(`[MetaUI] Failed to render field ${field.key}`, (error as Error).message, \"FormLayout\");\n                    });\n                }\n            });\n        }\n\n        return form;\n    }\n}\n"],"mappings":"gJASSA,EAAcC,EAAA,kBAGhB,MAAMC,EAQT,YAAcC,CAAMC,EAA+CC,EAAoB,OAAQC,EAAoBC,GAC/G,MAAMC,EAAO,IAAIC,EAAW,CACxBC,SAAU,KACVC,MAAOL,EACPM,OAAQ,uBACRC,YAAa,EACbC,WAAY,EACZC,WAAY,EACZC,WAAY,GACZC,gBAAiB,MACjBC,YAAa,EACbC,WAAY,EACZC,WAAY,EACZC,WAAY,EACZC,UAAW,EACXC,SAAU,EACVC,SAAU,EACVC,wBAAyB,QAG7B,MAAMC,EAAW1B,EAAe2B,cAGhC,MAAMC,EAAqE,CAAC,EAC5E,MAAMC,EAAgB,cAEtB,IAAK,MAAMC,KAAOC,OAAOC,KAAK5B,GAAa,CACvC,MAAM6B,EAAO7B,EAAW0B,GACxB,MAAMI,EAAYD,EAAKE,IAAIC,OAASP,EACpC,IAAKD,EAAOM,GAAYN,EAAOM,GAAa,GAC5CN,EAAOM,GAAWG,KAAK,CAAEP,MAAKG,QAClC,CAGA,IAAK,MAAMC,KAAaH,OAAOC,KAAKJ,GAAS,CACzC,GAAIM,IAAcL,EAAe,CAC7BrB,EAAK8B,WAAW,IAAIC,EAAM,CAAEC,KAAMN,IACtC,CAEAN,EAAOM,GAAWO,QAASC,IACvB,IACI,MAAMC,EAAQ,IAAIC,EAAM,CACpBJ,KAAME,EAAMT,KAAKE,IAAIQ,OAASD,EAAMZ,IACpCe,SAAUH,EAAMT,KAAKY,WAIzB,GAAIH,EAAMT,KAAKE,IAAIW,UAAW,CAC1B,MAAMC,EAAO,MAAML,EAAMT,KAAKE,GAAGW,UAAUE,QAAQ,YAAa,GAAG3C,OAAe2C,QAAQ,MAAO,SACjGL,EAAMM,aAAa,UAAW,CAAEC,MAAO,CAAC,CAAEC,KAAM,WAAaC,UAAWA,IAAM,OAClF,CAEA,MAAMC,EAAS3B,EAAS4B,UAAUZ,EAAMT,KAAKsB,KAAMb,EAAMT,KAAKE,IAAIqB,QAClE,GAAIjD,EAAaA,EAAY8C,GAC7B,MAAMI,EAAUJ,EAAOK,OAAOhB,EAAMT,KAAM,IAAIS,EAAMZ,MAAOzB,GAE3D,GAAIqC,EAAMT,KAAKE,IAAIwB,UAAW,CAC1BC,IAAIzB,GAAG0B,QAAQ,CAAC,0BAA4BC,IACxCL,EAAQM,cAAc,IAAID,EAAS,CAC/BE,KAAM,uBAGlB,CAEAxD,EAAK8B,WAAWK,GAChBnC,EAAK8B,WAAWmB,EACpB,CAAE,MAAOQ,GACLL,IAAIzB,GAAG0B,QAAQ,CAAC,gBAAkBK,IAC9B,GAAIA,EAAKA,EAAID,MAAM,mCAAmCvB,EAAMZ,MAAQmC,EAAgBE,QAAS,eAErG,GAER,CAEA,OAAO3D,CACX,EACH,IAAA4D,EAAA,CAAAC,WAAA,MAAAD,EAAAlE,aAAA,OAAAkE,CAAA","ignoreList":[]}
+{"version":3,"file":"FormLayout.js","names":["Logger","___utils_Logger","FormLayout","render","schema","modelName","engine","onSubmit","container","VBox","renderType","form","SimpleForm","editable","title","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","uiLayout","Array","isArray","warn","addItem","tableElements","hasFormFields","renderElement","element","type","label","addContent","Title","text","elements","forEach","scope","startsWith","error","propKey","replace","meta","properties","isCollectionOfRecords","items","hasExplicitWidget","ui","widget","isSubLayout","debug","push","this","_renderScalarField","field","subSchema","control","generateLayout","addStyleClass","msg","message","showErrorPopup","labelText","Label","required","effectiveMeta","generateField","fullWidth","sap","require","GridData","setLayoutData","span","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\n * @file FormLayout.ts\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\n */\n\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\nimport Label from \"sap/m/Label\";\nimport Title from \"sap/ui/core/Title\";\nimport VBox from \"sap/m/VBox\";\nimport { IPropertyMetadata, ISchema, ILayoutElement } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { Engine } from \"../core/Engine\";\nimport { Logger } from \"../utils/Logger\";\nimport Control from \"sap/ui/core/Control\";\n\n/**\n * Layout Manager responsible for generating a fully responsive SAP Fiori SimpleForm.\n * It traverses the `uiLayout` tree defined in the schema to build the form groups and fields,\n * completely separating visual orchestration from data modeling.\n * @namespace nz.co.siliconst.ui5.metaui.layouts\n * @public\n */\nexport class FormLayout implements ILayoutManager {\n    /**\n     * Renders the JSON Schema properties into a UI5 SimpleForm using the uiLayout definitions.\n     * \n     * @param schema The active JSON schema subset.\n     * @param modelName The bound UI5 model name.\n     * @param engine The central orchestrator for delegating plugin generation.\n     * @param onSubmit Optional submit hook.\n     * @returns {Control} The VBox wrapper containing the generated form.\n     */\n    public render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control {\n        const container = new VBox({ renderType: \"Bare\" });\n        const form = new SimpleForm({\n            editable: true,\n            title: schema.title,\n            layout: \"ResponsiveGridLayout\",\n            labelSpanXL: 4, labelSpanL: 4, labelSpanM: 4, labelSpanS: 12,\n            adjustLabelSpan: false,\n            emptySpanXL: 0, emptySpanL: 0, emptySpanM: 0, emptySpanS: 0,\n            columnsXL: 1, columnsL: 1, columnsM: 1,\n            singleContainerFullSize: false\n        });\n\n        if (!schema.uiLayout || !Array.isArray(schema.uiLayout)) {\n            Logger.warn(\"[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.\");\n            container.addItem(form);\n            return container;\n        }\n\n        const tableElements: { scope: string, meta: IPropertyMetadata, label?: string }[] = [];\n        let hasFormFields = false;\n\n        // Recursively render layout elements\n        const renderElement = (element: ILayoutElement) => {\n            if (element.type === \"Group\") {\n                if (element.label) {\n                    form.addContent(new Title({ text: element.label }));\n                }\n                \n                if (element.elements && Array.isArray(element.elements)) {\n                    element.elements.forEach(renderElement);\n                }\n            } else if (element.type === \"Control\") {\n                if (!element.scope || !element.scope.startsWith(\"#/properties/\")) {\n                    Logger.error(`[MetaUI] Invalid scope '${element.scope}' in uiLayout Control.`, \"\", \"FormLayout\");\n                    return;\n                }\n                \n                const propKey = element.scope.replace(\"#/properties/\", \"\");\n                const meta = schema.properties?.[propKey];\n                \n                if (!meta) {\n                    Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions.`, \"\", \"FormLayout\");\n                    return;\n                }\n\n                // Architectural Boundary: Separate Field Controls (Plugins) from Sub-Layouts (LayoutManagers)\n                // A property is delegated to a Sub-Layout Manager (Table) ONLY if it represents a collection of complex objects.\n                // Collections of primitives, or explicitly assigned widgets (like multiSelect), remain in the Form as Field Plugins.\n                const isCollectionOfRecords = meta.items?.type === \"object\" || meta.items?.properties;\n                const hasExplicitWidget = !!meta.ui?.widget;\n                const isSubLayout = meta.type === \"array\" && isCollectionOfRecords && !hasExplicitWidget;\n\n                if (isSubLayout) {\n                    Logger.debug(\"[MetaUI FormLayout]\", `Routing property '${propKey}' to Table Sub-Layout.`, \"FormLayout\");\n                    tableElements.push({ scope: propKey, meta, label: element.label });\n                } else {\n                    hasFormFields = true;\n                    Logger.debug(\"[MetaUI FormLayout]\", `Rendering scalar field '${propKey}'.`, \"FormLayout\");\n                    this._renderScalarField(form, element, propKey, meta, modelName, engine);\n                }\n            } else {\n                Logger.warn(`[MetaUI] Unsupported layout element type '${element.type}'.`, \"\", \"FormLayout\");\n            }\n        };\n\n        // Render everything defined in the layout\n        schema.uiLayout.forEach(renderElement);\n\n        if (hasFormFields) {\n            container.addItem(form);\n        }\n\n        // Render array/table sub-layouts full width below the form\n        tableElements.forEach(field => {\n            try {\n                const subSchema = {\n                    type: \"array\",\n                    title: field.label || field.meta.ui?.label || field.scope,\n                    items: field.meta.items || { type: \"object\", properties: {} },\n                    uiLayout: field.meta.items?.uiLayout // Pass down sub-layout if available\n                };\n                \n                const control = engine.generateLayout(subSchema as ISchema, modelName, `/${field.scope}`);\n                if (control) {\n                    control.addStyleClass(\"sapUiSmallMarginTop\");\n                    container.addItem(control);\n                }\n            } catch (error) {\n                const msg = (error as Error).message;\n                Logger.error(`[MetaUI] Failed to render array field ${field.scope}`, msg, \"FormLayout\");\n                Logger.showErrorPopup(`Failed to render array field '${field.scope}'.\\n\\nDetails: ${msg}`);\n            }\n        });\n\n        return container;\n    }\n\n    private _renderScalarField(form: SimpleForm, element: ILayoutElement, propKey: string, meta: IPropertyMetadata, modelName: string, engine: Engine): void {\n        try {\n            const labelText = element.label || meta.ui?.label || propKey;\n            const label = new Label({\n                text: labelText,\n                required: meta.required\n            });\n\n            // Override widget if specified in the layout element\n            const effectiveMeta = { ...meta };\n            if (element.widget) {\n                effectiveMeta.ui = { ...meta.ui, widget: element.widget };\n            }\n\n            const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);\n\n            if (effectiveMeta.ui?.fullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                    control.setLayoutData(new GridData({ span: \"XL12 L12 M12 S12\" }));\n                });\n            }\n\n            form.addContent(label);\n            form.addContent(control);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, \"FormLayout\");\n            Logger.showErrorPopup(`Failed to render field '${propKey}'.\\n\\nDetails: ${msg}`);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/layouts/FormLayout.ts

@@ -6,92 +6,156 @@
 import SimpleForm from "sap/ui/layout/form/SimpleForm";
 import Label from "sap/m/Label";
 import Title from "sap/ui/core/Title";
-import { IPropertyMetadata } from "../interfaces/ISchema";
-import { PluginRegistry } from "../core/PluginRegistry";
-import { IPlugin } from "../interfaces/IPlugin";
+import VBox from "sap/m/VBox";
+import { IPropertyMetadata, ISchema, ILayoutElement } from "../interfaces/ISchema";
+import { ILayoutManager } from "../interfaces/ILayoutManager";
+import { Engine } from "../core/Engine";
+import { Logger } from "../utils/Logger";
+import Control from "sap/ui/core/Control";
 
-export class FormLayout {
+/**
+ * Layout Manager responsible for generating a fully responsive SAP Fiori SimpleForm.
+ * It traverses the `uiLayout` tree defined in the schema to build the form groups and fields,
+ * completely separating visual orchestration from data modeling.
+ * @namespace nz.co.siliconst.ui5.metaui.layouts
+ * @public
+ */
+export class FormLayout implements ILayoutManager {
     /**
-     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.
-     * @param properties The dictionary of fields to render.
-     * @param modelName The dynamic model name.
-     * @param formTitle Optional title for the form block.
-     * @param trackPlugin Optional callback to track instantiated plugins.
+     * Renders the JSON Schema properties into a UI5 SimpleForm using the uiLayout definitions.
+     * 
+     * @param schema The active JSON schema subset.
+     * @param modelName The bound UI5 model name.
+     * @param engine The central orchestrator for delegating plugin generation.
+     * @param onSubmit Optional submit hook.
+     * @returns {Control} The VBox wrapper containing the generated form.
      */
-    public static build(properties: Record<string, IPropertyMetadata>, modelName: string = "meta", formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): SimpleForm {
+    public render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control {
+        const container = new VBox({ renderType: "Bare" });
         const form = new SimpleForm({
             editable: true,
-            title: formTitle,
+            title: schema.title,
             layout: "ResponsiveGridLayout",
-            labelSpanXL: 4,
-            labelSpanL: 4,
-            labelSpanM: 4,
-            labelSpanS: 12,
+            labelSpanXL: 4, labelSpanL: 4, labelSpanM: 4, labelSpanS: 12,
             adjustLabelSpan: false,
-            emptySpanXL: 0,
-            emptySpanL: 0,
-            emptySpanM: 0,
-            emptySpanS: 0,
-            columnsXL: 1,
-            columnsL: 1,
-            columnsM: 1,
+            emptySpanXL: 0, emptySpanL: 0, emptySpanM: 0, emptySpanS: 0,
+            columnsXL: 1, columnsL: 1, columnsM: 1,
             singleContainerFullSize: false
         });
 
-        const registry = PluginRegistry.getInstance();
-        
-        // Group fields by their ui.group directive
-        const groups: Record<string, { key: string; meta: IPropertyMetadata }[]> = {};
-        const DEFAULT_GROUP = "__DEFAULT__";
-        
-        for (const key of Object.keys(properties)) {
-            const meta = properties[key];
-            const groupName = meta.ui?.group || DEFAULT_GROUP;
-            if (!groups[groupName]) groups[groupName] = [];
-            groups[groupName].push({ key, meta });
+        if (!schema.uiLayout || !Array.isArray(schema.uiLayout)) {
+            Logger.warn("[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.");
+            container.addItem(form);
+            return container;
         }
 
-        // Render groups
-        for (const groupName of Object.keys(groups)) {
-            if (groupName !== DEFAULT_GROUP) {
-                form.addContent(new Title({ text: groupName }));
+        const tableElements: { scope: string, meta: IPropertyMetadata, label?: string }[] = [];
+        let hasFormFields = false;
+
+        // Recursively render layout elements
+        const renderElement = (element: ILayoutElement) => {
+            if (element.type === "Group") {
+                if (element.label) {
+                    form.addContent(new Title({ text: element.label }));
+                }
+                
+                if (element.elements && Array.isArray(element.elements)) {
+                    element.elements.forEach(renderElement);
+                }
+            } else if (element.type === "Control") {
+                if (!element.scope || !element.scope.startsWith("#/properties/")) {
+                    Logger.error(`[MetaUI] Invalid scope '${element.scope}' in uiLayout Control.`, "", "FormLayout");
+                    return;
+                }
+                
+                const propKey = element.scope.replace("#/properties/", "");
+                const meta = schema.properties?.[propKey];
+                
+                if (!meta) {
+                    Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions.`, "", "FormLayout");
+                    return;
+                }
+
+                // Architectural Boundary: Separate Field Controls (Plugins) from Sub-Layouts (LayoutManagers)
+                // A property is delegated to a Sub-Layout Manager (Table) ONLY if it represents a collection of complex objects.
+                // Collections of primitives, or explicitly assigned widgets (like multiSelect), remain in the Form as Field Plugins.
+                const isCollectionOfRecords = meta.items?.type === "object" || meta.items?.properties;
+                const hasExplicitWidget = !!meta.ui?.widget;
+                const isSubLayout = meta.type === "array" && isCollectionOfRecords && !hasExplicitWidget;
+
+                if (isSubLayout) {
+                    Logger.debug("[MetaUI FormLayout]", `Routing property '${propKey}' to Table Sub-Layout.`, "FormLayout");
+                    tableElements.push({ scope: propKey, meta, label: element.label });
+                } else {
+                    hasFormFields = true;
+                    Logger.debug("[MetaUI FormLayout]", `Rendering scalar field '${propKey}'.`, "FormLayout");
+                    this._renderScalarField(form, element, propKey, meta, modelName, engine);
+                }
+            } else {
+                Logger.warn(`[MetaUI] Unsupported layout element type '${element.type}'.`, "", "FormLayout");
             }
-            
-            groups[groupName].forEach((field) => {
-                try {
-                    const label = new Label({
-                        text: field.meta.ui?.label || field.key,
-                        required: field.meta.required
-                    });
-
-                    // Attach visibility condition to label and control container logic
-                    if (field.meta.ui?.visibleOn) {
-                        const expr = `{= ${field.meta.ui.visibleOn.replace(/\$root\./g, `${modelName}>/`).replace(/\./g, '/')} }`;
-                        label.bindProperty("visible", { parts: [{ path: "meta>/" }], formatter: () => false}); // temporary, condition engine does this usually
-                    }
-
-                    const plugin = registry.getPlugin(field.meta.type, field.meta.ui?.widget);
-                    if (trackPlugin) trackPlugin(plugin);
-                    const control = plugin.render(field.meta, `/${field.key}`, modelName);
-
-                    if (field.meta.ui?.fullWidth) {
-                        sap.ui.require(["sap/ui/layout/GridData"], (GridData: any) => {
-                            control.setLayoutData(new GridData({
-                                span: "XL12 L12 M12 S12"
-                            }));
-                        });
-                    }
-
-                    form.addContent(label);
-                    form.addContent(control);
-                } catch (error) {
-                    sap.ui.require(["sap/base/Log"], (Log: any) => {
-                        if (Log) Log.error(`[MetaUI] Failed to render field ${field.key}`, (error as Error).message, "FormLayout");
-                    });
+        };
+
+        // Render everything defined in the layout
+        schema.uiLayout.forEach(renderElement);
+
+        if (hasFormFields) {
+            container.addItem(form);
+        }
+
+        // Render array/table sub-layouts full width below the form
+        tableElements.forEach(field => {
+            try {
+                const subSchema = {
+                    type: "array",
+                    title: field.label || field.meta.ui?.label || field.scope,
+                    items: field.meta.items || { type: "object", properties: {} },
+                    uiLayout: field.meta.items?.uiLayout // Pass down sub-layout if available
+                };
+                
+                const control = engine.generateLayout(subSchema as ISchema, modelName, `/${field.scope}`);
+                if (control) {
+                    control.addStyleClass("sapUiSmallMarginTop");
+                    container.addItem(control);
                 }
+            } catch (error) {
+                const msg = (error as Error).message;
+                Logger.error(`[MetaUI] Failed to render array field ${field.scope}`, msg, "FormLayout");
+                Logger.showErrorPopup(`Failed to render array field '${field.scope}'.\n\nDetails: ${msg}`);
+            }
+        });
+
+        return container;
+    }
+
+    private _renderScalarField(form: SimpleForm, element: ILayoutElement, propKey: string, meta: IPropertyMetadata, modelName: string, engine: Engine): void {
+        try {
+            const labelText = element.label || meta.ui?.label || propKey;
+            const label = new Label({
+                text: labelText,
+                required: meta.required
             });
-        }
 
-        return form;
+            // Override widget if specified in the layout element
+            const effectiveMeta = { ...meta };
+            if (element.widget) {
+                effectiveMeta.ui = { ...meta.ui, widget: element.widget };
+            }
+
+            const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);
+
+            if (effectiveMeta.ui?.fullWidth) {
+                sap.ui.require(["sap/ui/layout/GridData"], (GridData: any) => {
+                    control.setLayoutData(new GridData({ span: "XL12 L12 M12 S12" }));
+                });
+            }
+
+            form.addContent(label);
+            form.addContent(control);
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, "FormLayout");
+            Logger.showErrorPopup(`Failed to render field '${propKey}'.\n\nDetails: ${msg}`);
+        }
     }
 }

package/src/nz/co/siliconst/ui5/metaui/layouts/TableLayout-dbg.js

@@ -1,25 +1,39 @@
-sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListItem", "sap/m/Toolbar", "sap/m/Title", "sap/m/ToolbarSpacer", "sap/m/Button", "../core/PluginRegistry"], function (Table, Column, Text, ColumnListItem, Toolbar, Title, ToolbarSpacer, Button, ___core_PluginRegistry) {
+sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListItem", "sap/m/Toolbar", "sap/m/Title", "sap/m/ToolbarSpacer", "sap/m/Button", "../utils/Logger"], function (Table, Column, Text, ColumnListItem, Toolbar, Title, ToolbarSpacer, Button, ___utils_Logger) {
   "use strict";
 
-  const PluginRegistry = ___core_PluginRegistry["PluginRegistry"];
+  const Logger = ___utils_Logger["Logger"];
+  /**
+   * Layout Manager responsible for generating a responsive SAP Fiori Table.
+   * It is automatically utilized by the Engine when the schema root or property is of type 'array'.
+   * Includes built-in support for adding and deleting rows via dynamic data binding manipulation.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.layouts
+   * @public
+   */
   class TableLayout {
     /**
-     * Builds a responsive Table, dynamically calculating column priorities.
+     * Renders the JSON Schema array properties into a UI5 Table.
+     * 
+     * @param schema The active JSON schema array definition.
+     * @param modelName The UI5 JSONModel name used for data binding.
+     * @param engine The central orchestrator for delegating column plugin generation.
+     * @param onSubmit Optional submit hook.
+     * @param bindingPath The JSON path representing the array within the payload.
+     * @returns {Control} The generated sap.m.Table control.
+     * @throws {Error} If the provided schema is not of type 'array'.
      */
-    static build(tableMeta, bindingPath = "meta>/", tableTitle = "Table", trackPlugin) {
-      if (!tableMeta.properties) {
-        throw new Error("[MetaUI] Table requires an items schema with properties.");
+    render(schema, modelName, engine, onSubmit, bindingPath = "/") {
+      if (schema.type !== "array" || !schema.items || !schema.items.properties) {
+        throw new Error("[MetaUI] TableLayout requires an array schema with items.properties.");
       }
-      const parts = bindingPath.split(">");
-      const actualModelName = parts.length > 1 ? parts[0] : undefined;
-      const actualPath = parts.length > 1 ? parts[1] : bindingPath;
-      // e.g. "meta>/Contacts" -> actualModelName = "meta", actualPath = "/Contacts"
-
+      const tableTitle = schema.title || "Table";
+      const actualModelName = modelName;
+      const actualPath = bindingPath;
       const table = new Table({
         headerToolbar: new Toolbar({
           content: [new Title({
             text: tableTitle
-          }), new ToolbarSpacer(), new Button({
+          }), new ToolbarSpacer(), ...(engine.isDisplayMode ? [] : [new Button({
             text: "Add Row",
             icon: "sap-icon://add",
             press: oEvent => {
@@ -28,14 +42,15 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
               const model = tbl.getModel(actualModelName);
               const info = tbl.getBindingInfo("items");
               if (!info || !info.path) return;
-              const data = model.getProperty(info.path) || [];
-              data.push({}); // append empty row
-              model.setProperty(info.path, data);
+              const rawData = model.getProperty(info.path);
+              const data = Array.isArray(rawData) ? rawData : [];
+              const newData = [...data, {}];
+              model.setProperty(info.path, newData);
             }
-          })]
+          })])]
         }),
         fixedLayout: false,
-        mode: "Delete",
+        mode: engine.isDisplayMode ? "None" : "Delete",
         delete: oEvent => {
           const item = oEvent.getParameter("listItem");
           const path = item.getBindingContext(actualModelName).getPath();
@@ -44,47 +59,99 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
           const index = parseInt(splitPaths.pop() || "0", 10);
           let arrayPath = splitPaths.join("/");
           if (arrayPath === "") arrayPath = "/";
-          const data = model.getProperty(arrayPath);
-          data.splice(index, 1);
-          model.setProperty(arrayPath, data);
+          const rawData = model.getProperty(arrayPath);
+          const data = Array.isArray(rawData) ? rawData : [];
+          const newData = [...data];
+          newData.splice(index, 1);
+          model.setProperty(arrayPath, newData);
         }
       });
       const templateCells = [];
-      const registry = PluginRegistry.getInstance();
-      const props = tableMeta.properties;
-      Object.keys(props).forEach(key => {
-        try {
-          const fieldMeta = props[key];
-          const isKey = !!fieldMeta.ui?.isKey;
-          const column = new Column({
-            header: new Text({
-              text: fieldMeta.ui?.label || key
-            }),
-            demandPopin: !isKey,
-            minScreenWidth: isKey ? "" : "Tablet",
-            popinDisplay: "Inline"
-          });
-          table.addColumn(column);
-          const plugin = registry.getPlugin(fieldMeta.type, fieldMeta.ui?.widget);
-          if (trackPlugin) trackPlugin(plugin);
-          const control = plugin.render(fieldMeta, key, actualModelName); // No trailing slash for relative bindings
-          templateCells.push(control);
-        } catch (error) {
-          sap.ui.require(["sap/base/Log"], Log => {
-            if (Log) Log.error(`[MetaUI] Failed to render column ${key}`, error.message, "TableLayout");
-          });
+      const props = schema.items.properties;
+      const layoutElements = schema.uiLayout;
+      if (layoutElements && Array.isArray(layoutElements)) {
+        // Only render columns defined in uiLayout
+        layoutElements.forEach(element => {
+          if (element.type === "Control") {
+            if (!element.scope || !element.scope.startsWith("#/properties/")) {
+              Logger.error(`[MetaUI] Invalid scope '${element.scope}' in uiLayout Control for Table.`, "", "TableLayout");
+              return;
+            }
+            const propKey = element.scope.replace("#/properties/", "");
+            const fieldMeta = props[propKey];
+            if (!fieldMeta) {
+              Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions for Table.`, "", "TableLayout");
+              return;
+            }
+            try {
+              const isKey = !!fieldMeta.ui?.isKey;
+              const column = new Column({
+                header: new Text({
+                  text: element.label || fieldMeta.ui?.label || propKey
+                }),
+                demandPopin: !isKey,
+                minScreenWidth: isKey ? "" : "Tablet",
+                popinDisplay: "Inline"
+              });
+              table.addColumn(column);
 
-          // Add an empty text control as a fallback so the table columns match the cells array length
-          templateCells.push(new Text({
-            text: "Error"
-          }));
-        }
-      });
+              // Override widget if specified in the layout element
+              const effectiveMeta = {
+                ...fieldMeta
+              };
+              if (element.widget) {
+                effectiveMeta.ui = {
+                  ...fieldMeta.ui,
+                  widget: element.widget
+                };
+              }
+
+              // Use engine to generate fields natively and track validation
+              const control = engine.generateField(effectiveMeta, propKey, actualModelName || "meta", true);
+              templateCells.push(control);
+            } catch (error) {
+              const msg = error.message;
+              Logger.error(`[MetaUI] Failed to render column ${propKey}`, msg, "TableLayout");
+              Logger.showErrorPopup(`Failed to render table column '${propKey}'.\n\nDetails: ${msg}`);
+              templateCells.push(new Text({
+                text: "Error"
+              }));
+            }
+          } else {
+            Logger.warn(`[MetaUI] Unsupported layout element type '${element.type}' inside TableLayout. Only 'Control' is supported for columns.`, "", "TableLayout");
+          }
+        });
+      } else {
+        Logger.debug("[MetaUI TableLayout]", "No uiLayout provided. Falling back to rendering all properties as columns.", "TableLayout");
+        // Fallback: If no uiLayout is provided, render all properties as columns
+        Object.keys(props).forEach(key => {
+          try {
+            const fieldMeta = props[key];
+            const isKey = !!fieldMeta.ui?.isKey;
+            const column = new Column({
+              header: new Text({
+                text: fieldMeta.ui?.label || key
+              }),
+              demandPopin: !isKey,
+              minScreenWidth: isKey ? "" : "Tablet",
+              popinDisplay: "Inline"
+            });
+            table.addColumn(column);
+            const control = engine.generateField(fieldMeta, key, actualModelName || "meta", true);
+            templateCells.push(control);
+          } catch (error) {
+            const msg = error.message;
+            Logger.error(`[MetaUI] Failed to render fallback column ${key}`, msg, "TableLayout");
+            Logger.showErrorPopup(`Failed to render fallback table column '${key}'.\n\nDetails: ${msg}`);
+            templateCells.push(new Text({
+              text: "Error"
+            }));
+          }
+        });
+      }
       const rowTemplate = new ColumnListItem({
         cells: templateCells
       });
-
-      // V2 Fix: Actually bind the items to the table!
       table.bindItems({
         path: actualPath,
         model: actualModelName,