@siliconst/metaui 1.4.21 → 1.4.37

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

@@ -5,7 +5,9 @@
  * with a proprietary 'ui' directive block for Fiori visual orchestration.
  */
 
-export type FieldType = "string" | "number" | "integer" | "boolean" | "date" | "array" | "object";
+import { RenderModeType, SchemaTypeType } from "../constants/MetaUIConstants";
+
+export type FieldType = SchemaTypeType | "date";
 
 /**
  * Value help structure mapping SAP Key/Text pairs.
@@ -43,11 +45,15 @@ export interface IUIDirective {
     enabledOn?: string;
     format?: string;
     rows?: number;
+    expandable?: boolean;
     fullWidth?: boolean;
+    controlProps?: Record<string, unknown>;
     validators?: (string | IValidationRule)[];
     formatter?: string;
     args?: unknown;
     dialogButtonText?: string;
+    layoutBudget?: number;
+    renderMode?: RenderModeType;
 }
 
 export interface IRemoteValueHelpConfig {
@@ -56,6 +62,25 @@ export interface IRemoteValueHelpConfig {
     textPath: string;
 }
 
+export type PolicyEffectType = "Require" | "Hide" | "Disable" | "Invalidate" | "Show" | "Enable" | "Validate" | "Optional";
+
+export interface IPolicyCondition {
+    NumericGreaterThan?: Record<string, number>;
+    NumericLessThan?: Record<string, number>;
+    StringEquals?: Record<string, string>;
+    DateLessThan?: Record<string, string>;
+    IsNull?: string[];
+    IsNotNull?: string[];
+    [operator: string]: unknown; // Extensible for other operators
+}
+
+export interface IPolicy {
+    effect: PolicyEffectType;
+    targets: string[];
+    condition: IPolicyCondition;
+    message?: string;
+}
+
 /**
  * Standard JSON-Schema property definition.
  */
@@ -121,6 +146,7 @@ export interface IPropertyMetadata {
  */
 export interface ISchema {
     title?: string;
+    uiPolicies?: IPolicy[];
     layoutStrategy?: string;
     type?: "object" | "array"; // Implicit layout hinting
     properties?: Record<string, IPropertyMetadata>;

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

@@ -1,8 +1,9 @@
-sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Title", "sap/m/VBox", "../core/SchemaNormalizer", "../utils/Logger"], function (SimpleForm, Label, Title, VBox, ___core_SchemaNormalizer, ___utils_Logger) {
+sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Title", "sap/m/VBox", "../core/SchemaNormalizer", "../utils/Logger", "../core/PluginRegistry"], function (SimpleForm, Label, Title, VBox, ___core_SchemaNormalizer, ___utils_Logger, ___core_PluginRegistry) {
   "use strict";
 
   const SchemaNormalizer = ___core_SchemaNormalizer["SchemaNormalizer"];
   const Logger = ___utils_Logger["Logger"];
+  const PluginRegistry = ___core_PluginRegistry["PluginRegistry"];
   /**
    * 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,
@@ -47,7 +48,6 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
         container.addItem(form);
         return container;
       }
-      const tableElements = [];
       let hasFormFields = false;
 
       // Recursively render layout elements
@@ -81,14 +81,34 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
           // 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: bindingPath,
-              meta,
-              label: element.label
-            });
+          const isTableSubLayout = meta.type === "array" && isCollectionOfRecords && !hasExplicitWidget;
+          if (isTableSubLayout) {
+            Logger.debug("[MetaUI FormLayout]", `Routing property '${propKey}' to Table Sub-Layout inline.`, "FormLayout");
+            hasFormFields = true;
+            try {
+              const subSchema = {
+                type: "array",
+                title: element.label || meta.ui?.label || propKey,
+                items: meta.items || {
+                  type: "object",
+                  properties: {}
+                },
+                uiLayout: meta.items?.uiLayout // Pass down sub-layout if available
+              };
+              const control = engine.generateLayout(subSchema, modelName, `/${bindingPath}`);
+              if (control) {
+                sap.ui.require(["sap/ui/layout/GridData"], GridData => {
+                  control.setLayoutData(new GridData({
+                    span: "XL12 L12 M12 S12"
+                  }));
+                });
+                form.addContent(control);
+              }
+            } catch (error) {
+              const msg = error.message;
+              Logger.error(`[MetaUI] Failed to render inline array field ${bindingPath}`, msg, "FormLayout");
+              Logger.showErrorPopup(`Failed to render array field '${bindingPath}'.\n\nDetails: ${msg}`);
+            }
           } else {
             hasFormFields = true;
             Logger.debug("[MetaUI FormLayout]", `Rendering scalar field '${bindingPath}'.`, "FormLayout");
@@ -104,30 +124,6 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
       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, modelName, `/${field.scope}`);
-          if (control) {
-            control.addStyleClass("sapUiSmallMarginTop");
-            container.addItem(control);
-          }
-        } catch (error) {
-          const msg = 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;
     }
 
@@ -161,8 +157,7 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
         const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);
 
         // Automatically apply fullWidth layout data if natively wide or explicitly requested
-        const widget = effectiveMeta.ui?.widget;
-        const isNativelyWide = widget === "codeEditor" || widget === "textArea" || widget === "richText";
+        const isNativelyWide = PluginRegistry.getInstance().isPluginNativelyWide(effectiveMeta.type || "string", effectiveMeta.ui?.widget);
         const isFullWidth = effectiveMeta.ui?.fullWidth !== undefined ? effectiveMeta.ui?.fullWidth : isNativelyWide;
         if (isFullWidth) {
           sap.ui.require(["sap/ui/layout/GridData"], GridData => {

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayout-dbg.js","names":["SchemaNormalizer","___core_SchemaNormalizer","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","meta","bindingPath","propKey","resolveScope","isCollectionOfRecords","items","properties","hasExplicitWidget","ui","widget","isSubLayout","debug","push","_renderScalarField","field","subSchema","control","generateLayout","addStyleClass","msg","message","showErrorPopup","labelText","Label","required","effectiveMeta","generateField","isNativelyWide","isFullWidth","fullWidth","undefined","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 { SchemaNormalizer } from \"../core/SchemaNormalizer\";\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 { meta, bindingPath, propKey } = SchemaNormalizer.resolveScope(schema, element.scope);\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: bindingPath, meta, label: element.label });\n                } else {\n                    hasFormFields = true;\n                    Logger.debug(\"[MetaUI FormLayout]\", `Rendering scalar field '${bindingPath}'.`, \"FormLayout\");\n                    this._renderScalarField(form, element, bindingPath, 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    /**\n     * Synthesizes a primitive field into the Form.\n     * @param form The SimpleForm instance.\n     * @param element The layout element definition.\n     * @param propKey The bound property key.\n     * @param meta The inferred metadata schema.\n     * @param modelName The UI5 data model name.\n     * @param engine The core Engine instance.\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            // Automatically apply fullWidth layout data if natively wide or explicitly requested\n            const widget = effectiveMeta.ui?.widget;\n            const isNativelyWide = widget === \"codeEditor\" || widget === \"textArea\" || widget === \"richText\";\n            const isFullWidth = effectiveMeta.ui?.fullWidth !== undefined ? effectiveMeta.ui?.fullWidth : isNativelyWide;\n\n            if (isFullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: typeof import(\"sap/ui/layout/GridData\").default) => {\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":[]}
+{"version":3,"file":"FormLayout-dbg.js","names":["SchemaNormalizer","___core_SchemaNormalizer","Logger","___utils_Logger","PluginRegistry","___core_PluginRegistry","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","hasFormFields","renderElement","element","type","label","addContent","Title","text","elements","forEach","scope","startsWith","error","meta","bindingPath","propKey","resolveScope","isCollectionOfRecords","items","properties","hasExplicitWidget","ui","widget","isTableSubLayout","debug","subSchema","control","generateLayout","sap","require","GridData","setLayoutData","span","msg","message","showErrorPopup","_renderScalarField","labelText","Label","required","effectiveMeta","generateField","isNativelyWide","getInstance","isPluginNativelyWide","isFullWidth","fullWidth","undefined","__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 { SchemaNormalizer } from \"../core/SchemaNormalizer\";\nimport { Logger } from \"../utils/Logger\";\nimport Control from \"sap/ui/core/Control\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\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        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 { meta, bindingPath, propKey } = SchemaNormalizer.resolveScope(schema, element.scope);\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 isTableSubLayout = meta.type === \"array\" && isCollectionOfRecords && !hasExplicitWidget;\n\n                if (isTableSubLayout) {\n                    Logger.debug(\"[MetaUI FormLayout]\", `Routing property '${propKey}' to Table Sub-Layout inline.`, \"FormLayout\");\n                    hasFormFields = true;\n                    try {\n                        const subSchema = {\n                            type: \"array\",\n                            title: element.label || meta.ui?.label || propKey,\n                            items: meta.items || { type: \"object\", properties: {} },\n                            uiLayout: meta.items?.uiLayout // Pass down sub-layout if available\n                        };\n                        \n                        const control = engine.generateLayout(subSchema as ISchema, modelName, `/${bindingPath}`);\n                        if (control) {\n                            sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: typeof import(\"sap/ui/layout/GridData\").default) => {\n                                control.setLayoutData(new GridData({ span: \"XL12 L12 M12 S12\" }));\n                            });\n                            form.addContent(control);\n                        }\n                    } catch (error) {\n                        const msg = (error as Error).message;\n                        Logger.error(`[MetaUI] Failed to render inline array field ${bindingPath}`, msg, \"FormLayout\");\n                        Logger.showErrorPopup(`Failed to render array field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n                    }\n                } else {\n                    hasFormFields = true;\n                    Logger.debug(\"[MetaUI FormLayout]\", `Rendering scalar field '${bindingPath}'.`, \"FormLayout\");\n                    this._renderScalarField(form, element, bindingPath, 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        return container;\n    }\n\n    /**\n     * Synthesizes a primitive field into the Form.\n     * @param form The SimpleForm instance.\n     * @param element The layout element definition.\n     * @param propKey The bound property key.\n     * @param meta The inferred metadata schema.\n     * @param modelName The UI5 data model name.\n     * @param engine The core Engine instance.\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            // Automatically apply fullWidth layout data if natively wide or explicitly requested\n            const isNativelyWide = PluginRegistry.getInstance().isPluginNativelyWide(effectiveMeta.type || \"string\", effectiveMeta.ui?.widget);\n            const isFullWidth = effectiveMeta.ui?.fullWidth !== undefined ? effectiveMeta.ui?.fullWidth : isNativelyWide;\n\n            if (isFullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: typeof import(\"sap/ui/layout/GridData\").default) => {\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.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;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;IAGhE,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;QAiGjG;;;;;;;;WAQG;QACH,OAAO,CAAC,kBAAkB;KAmC7B;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;IAGhE,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C;;;;;;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;QA8FjG;;;;;;;;WAQG;QACH,OAAO,CAAC,kBAAkB;KAkC7B;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","sap/m/VBox","../core/SchemaNormalizer","../utils/Logger"],function(e,t,a,r,o,i){"use strict";const n=o["SchemaNormalizer"];const s=i["Logger"];class l{render(t,o,i,l){const u=new r({renderType:"Bare"});const p=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)){s.warn("[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.");u.addItem(p);return u}const d=[];let c=false;const y=e=>{if(e.type==="Group"){if(e.label){p.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/")){s.error(`[MetaUI] Invalid scope '${e.scope}' in uiLayout Control.`,"","FormLayout");return}const{meta:a,bindingPath:r,propKey:l}=n.resolveScope(t,e.scope);if(!a){s.error(`[MetaUI] Property '${l}' not found in schema definitions.`,"","FormLayout");return}const u=a.items?.type==="object"||a.items?.properties;const y=!!a.ui?.widget;const m=a.type==="array"&&u&&!y;if(m){s.debug("[MetaUI FormLayout]",`Routing property '${l}' to Table Sub-Layout.`,"FormLayout");d.push({scope:r,meta:a,label:e.label})}else{c=true;s.debug("[MetaUI FormLayout]",`Rendering scalar field '${r}'.`,"FormLayout");this._renderScalarField(p,e,r,a,o,i)}}else{s.warn(`[MetaUI] Unsupported layout element type '${e.type}'.`,"","FormLayout")}};t.uiLayout.forEach(y);if(c){u.addItem(p)}d.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=i.generateLayout(t,o,`/${e.scope}`);if(a){a.addStyleClass("sapUiSmallMarginTop");u.addItem(a)}}catch(t){const a=t.message;s.error(`[MetaUI] Failed to render array field ${e.scope}`,a,"FormLayout");s.showErrorPopup(`Failed to render array field '${e.scope}'.\n\nDetails: ${a}`)}});return u}_renderScalarField(e,a,r,o,i,n){try{const s=a.label||o.ui?.label||r;const l=new t({text:s,required:o.required});const u={...o};if(a.widget){u.ui={...o.ui,widget:a.widget}}const p=n.generateField(u,`/${r}`,i);const d=u.ui?.widget;const c=d==="codeEditor"||d==="textArea"||d==="richText";const y=u.ui?.fullWidth!==undefined?u.ui?.fullWidth:c;if(y){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;s.error(`[MetaUI] Failed to render field ${r}`,t,"FormLayout");s.showErrorPopup(`Failed to render field '${r}'.\n\nDetails: ${t}`)}}}var u={__esModule:true};u.FormLayout=l;return u});
+sap.ui.define(["sap/ui/layout/form/SimpleForm","sap/m/Label","sap/ui/core/Title","sap/m/VBox","../core/SchemaNormalizer","../utils/Logger","../core/PluginRegistry"],function(e,t,a,r,o,i,n){"use strict";const s=o["SchemaNormalizer"];const l=i["Logger"];const u=n["PluginRegistry"];class d{render(t,o,i,n){const u=new r({renderType:"Bare"});const d=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)){l.warn("[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.");u.addItem(d);return u}let p=false;const y=e=>{if(e.type==="Group"){if(e.label){d.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/")){l.error(`[MetaUI] Invalid scope '${e.scope}' in uiLayout Control.`,"","FormLayout");return}const{meta:a,bindingPath:r,propKey:n}=s.resolveScope(t,e.scope);if(!a){l.error(`[MetaUI] Property '${n}' not found in schema definitions.`,"","FormLayout");return}const u=a.items?.type==="object"||a.items?.properties;const y=!!a.ui?.widget;const c=a.type==="array"&&u&&!y;if(c){l.debug("[MetaUI FormLayout]",`Routing property '${n}' to Table Sub-Layout inline.`,"FormLayout");p=true;try{const t={type:"array",title:e.label||a.ui?.label||n,items:a.items||{type:"object",properties:{}},uiLayout:a.items?.uiLayout};const s=i.generateLayout(t,o,`/${r}`);if(s){sap.ui.require(["sap/ui/layout/GridData"],e=>{s.setLayoutData(new e({span:"XL12 L12 M12 S12"}))});d.addContent(s)}}catch(e){const t=e.message;l.error(`[MetaUI] Failed to render inline array field ${r}`,t,"FormLayout");l.showErrorPopup(`Failed to render array field '${r}'.\n\nDetails: ${t}`)}}else{p=true;l.debug("[MetaUI FormLayout]",`Rendering scalar field '${r}'.`,"FormLayout");this._renderScalarField(d,e,r,a,o,i)}}else{l.warn(`[MetaUI] Unsupported layout element type '${e.type}'.`,"","FormLayout")}};t.uiLayout.forEach(y);if(p){u.addItem(d)}return u}_renderScalarField(e,a,r,o,i,n){try{const s=a.label||o.ui?.label||r;const l=new t({text:s,required:o.required});const d={...o};if(a.widget){d.ui={...o.ui,widget:a.widget}}const p=n.generateField(d,`/${r}`,i);const y=u.getInstance().isPluginNativelyWide(d.type||"string",d.ui?.widget);const c=d.ui?.fullWidth!==undefined?d.ui?.fullWidth:y;if(c){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;l.error(`[MetaUI] Failed to render field ${r}`,t,"FormLayout");l.showErrorPopup(`Failed to render field '${r}'.\n\nDetails: ${t}`)}}}var p={__esModule:true};p.FormLayout=d;return p});
 //# sourceMappingURL=FormLayout.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayout.js","names":["SchemaNormalizer","___core_SchemaNormalizer","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","meta","bindingPath","propKey","resolveScope","isCollectionOfRecords","items","properties","hasExplicitWidget","ui","widget","isSubLayout","debug","push","this","_renderScalarField","field","subSchema","control","generateLayout","addStyleClass","msg","message","showErrorPopup","labelText","Label","required","effectiveMeta","generateField","isNativelyWide","isFullWidth","fullWidth","undefined","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 { SchemaNormalizer } from \"../core/SchemaNormalizer\";\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 { meta, bindingPath, propKey } = SchemaNormalizer.resolveScope(schema, element.scope);\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: bindingPath, meta, label: element.label });\n                } else {\n                    hasFormFields = true;\n                    Logger.debug(\"[MetaUI FormLayout]\", `Rendering scalar field '${bindingPath}'.`, \"FormLayout\");\n                    this._renderScalarField(form, element, bindingPath, 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    /**\n     * Synthesizes a primitive field into the Form.\n     * @param form The SimpleForm instance.\n     * @param element The layout element definition.\n     * @param propKey The bound property key.\n     * @param meta The inferred metadata schema.\n     * @param modelName The UI5 data model name.\n     * @param engine The core Engine instance.\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            // Automatically apply fullWidth layout data if natively wide or explicitly requested\n            const widget = effectiveMeta.ui?.widget;\n            const isNativelyWide = widget === \"codeEditor\" || widget === \"textArea\" || widget === \"richText\";\n            const isFullWidth = effectiveMeta.ui?.fullWidth !== undefined ? effectiveMeta.ui?.fullWidth : isNativelyWide;\n\n            if (isFullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: typeof import(\"sap/ui/layout/GridData\").default) => {\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":[]}
+{"version":3,"file":"FormLayout.js","names":["SchemaNormalizer","___core_SchemaNormalizer","Logger","___utils_Logger","PluginRegistry","___core_PluginRegistry","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","hasFormFields","renderElement","element","type","label","addContent","Title","text","elements","forEach","scope","startsWith","error","meta","bindingPath","propKey","resolveScope","isCollectionOfRecords","items","properties","hasExplicitWidget","ui","widget","isTableSubLayout","debug","subSchema","control","generateLayout","sap","require","GridData","setLayoutData","span","msg","message","showErrorPopup","this","_renderScalarField","labelText","Label","required","effectiveMeta","generateField","isNativelyWide","getInstance","isPluginNativelyWide","isFullWidth","fullWidth","undefined","__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 { SchemaNormalizer } from \"../core/SchemaNormalizer\";\nimport { Logger } from \"../utils/Logger\";\nimport Control from \"sap/ui/core/Control\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\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        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 { meta, bindingPath, propKey } = SchemaNormalizer.resolveScope(schema, element.scope);\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 isTableSubLayout = meta.type === \"array\" && isCollectionOfRecords && !hasExplicitWidget;\n\n                if (isTableSubLayout) {\n                    Logger.debug(\"[MetaUI FormLayout]\", `Routing property '${propKey}' to Table Sub-Layout inline.`, \"FormLayout\");\n                    hasFormFields = true;\n                    try {\n                        const subSchema = {\n                            type: \"array\",\n                            title: element.label || meta.ui?.label || propKey,\n                            items: meta.items || { type: \"object\", properties: {} },\n                            uiLayout: meta.items?.uiLayout // Pass down sub-layout if available\n                        };\n                        \n                        const control = engine.generateLayout(subSchema as ISchema, modelName, `/${bindingPath}`);\n                        if (control) {\n                            sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: typeof import(\"sap/ui/layout/GridData\").default) => {\n                                control.setLayoutData(new GridData({ span: \"XL12 L12 M12 S12\" }));\n                            });\n                            form.addContent(control);\n                        }\n                    } catch (error) {\n                        const msg = (error as Error).message;\n                        Logger.error(`[MetaUI] Failed to render inline array field ${bindingPath}`, msg, \"FormLayout\");\n                        Logger.showErrorPopup(`Failed to render array field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n                    }\n                } else {\n                    hasFormFields = true;\n                    Logger.debug(\"[MetaUI FormLayout]\", `Rendering scalar field '${bindingPath}'.`, \"FormLayout\");\n                    this._renderScalarField(form, element, bindingPath, 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        return container;\n    }\n\n    /**\n     * Synthesizes a primitive field into the Form.\n     * @param form The SimpleForm instance.\n     * @param element The layout element definition.\n     * @param propKey The bound property key.\n     * @param meta The inferred metadata schema.\n     * @param modelName The UI5 data model name.\n     * @param engine The core Engine instance.\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            // Automatically apply fullWidth layout data if natively wide or explicitly requested\n            const isNativelyWide = PluginRegistry.getInstance().isPluginNativelyWide(effectiveMeta.type || \"string\", effectiveMeta.ui?.widget);\n            const isFullWidth = effectiveMeta.ui?.fullWidth !== undefined ? effectiveMeta.ui?.fullWidth : isNativelyWide;\n\n            if (isFullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: typeof import(\"sap/ui/layout/GridData\").default) => {\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

@@ -13,6 +13,7 @@ import { Engine } from "../core/Engine";
 import { SchemaNormalizer } from "../core/SchemaNormalizer";
 import { Logger } from "../utils/Logger";
 import Control from "sap/ui/core/Control";
+import { PluginRegistry } from "../core/PluginRegistry";
 
 /**
  * Layout Manager responsible for generating a fully responsive SAP Fiori SimpleForm.
@@ -50,7 +51,6 @@ export class FormLayout implements ILayoutManager {
             return container;
         }
 
-        const tableElements: { scope: string, meta: IPropertyMetadata, label?: string }[] = [];
         let hasFormFields = false;
 
         // Recursively render layout elements
@@ -81,11 +81,31 @@ export class FormLayout implements ILayoutManager {
                 // 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;
+                const isTableSubLayout = meta.type === "array" && isCollectionOfRecords && !hasExplicitWidget;
 
-                if (isSubLayout) {
-                    Logger.debug("[MetaUI FormLayout]", `Routing property '${propKey}' to Table Sub-Layout.`, "FormLayout");
-                    tableElements.push({ scope: bindingPath, meta, label: element.label });
+                if (isTableSubLayout) {
+                    Logger.debug("[MetaUI FormLayout]", `Routing property '${propKey}' to Table Sub-Layout inline.`, "FormLayout");
+                    hasFormFields = true;
+                    try {
+                        const subSchema = {
+                            type: "array",
+                            title: element.label || meta.ui?.label || propKey,
+                            items: meta.items || { type: "object", properties: {} },
+                            uiLayout: meta.items?.uiLayout // Pass down sub-layout if available
+                        };
+                        
+                        const control = engine.generateLayout(subSchema as ISchema, modelName, `/${bindingPath}`);
+                        if (control) {
+                            sap.ui.require(["sap/ui/layout/GridData"], (GridData: typeof import("sap/ui/layout/GridData").default) => {
+                                control.setLayoutData(new GridData({ span: "XL12 L12 M12 S12" }));
+                            });
+                            form.addContent(control);
+                        }
+                    } catch (error) {
+                        const msg = (error as Error).message;
+                        Logger.error(`[MetaUI] Failed to render inline array field ${bindingPath}`, msg, "FormLayout");
+                        Logger.showErrorPopup(`Failed to render array field '${bindingPath}'.\n\nDetails: ${msg}`);
+                    }
                 } else {
                     hasFormFields = true;
                     Logger.debug("[MetaUI FormLayout]", `Rendering scalar field '${bindingPath}'.`, "FormLayout");
@@ -103,28 +123,6 @@ export class FormLayout implements ILayoutManager {
             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;
     }
 
@@ -154,8 +152,7 @@ export class FormLayout implements ILayoutManager {
             const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);
 
             // Automatically apply fullWidth layout data if natively wide or explicitly requested
-            const widget = effectiveMeta.ui?.widget;
-            const isNativelyWide = widget === "codeEditor" || widget === "textArea" || widget === "richText";
+            const isNativelyWide = PluginRegistry.getInstance().isPluginNativelyWide(effectiveMeta.type || "string", effectiveMeta.ui?.widget);
             const isFullWidth = effectiveMeta.ui?.fullWidth !== undefined ? effectiveMeta.ui?.fullWidth : isNativelyWide;
 
             if (isFullWidth) {

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

@@ -1,8 +1,10 @@
-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/SchemaNormalizer", "../utils/Logger"], function (Table, Column, Text, ColumnListItem, Toolbar, Title, ToolbarSpacer, Button, ___core_SchemaNormalizer, ___utils_Logger) {
+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/SchemaNormalizer", "../utils/Logger", "../constants/MetaUIConstants"], function (Table, Column, Text, ColumnListItem, Toolbar, Title, ToolbarSpacer, Button, ___core_SchemaNormalizer, ___utils_Logger, ___constants_MetaUIConstants) {
   "use strict";
 
   const SchemaNormalizer = ___core_SchemaNormalizer["SchemaNormalizer"];
   const Logger = ___utils_Logger["Logger"];
+  const WIDGET_TYPE = ___constants_MetaUIConstants["WIDGET_TYPE"];
+  const SCHEMA_TYPE = ___constants_MetaUIConstants["SCHEMA_TYPE"];
   /**
    * 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'.
@@ -25,10 +27,11 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
      */
     render(schema, modelName, engine, onSubmit, bindingPath = "/") {
       let itemsSchema = schema.items;
-      if (itemsSchema && !itemsSchema.properties && itemsSchema.ui?.widget === "reference" && itemsSchema.$ref) {
+      if (itemsSchema && !itemsSchema.properties && itemsSchema.ui?.widget === WIDGET_TYPE.REFERENCE && itemsSchema.$ref) {
         Logger.debug(`[MetaUI] TableLayout detecting reference widget for ${bindingPath}. Resolving ${itemsSchema.$ref}`, "", "TableLayout");
-        if (engine.host && engine.host.getSchemaDefinition) {
-          const resolved = engine.host.getSchemaDefinition(itemsSchema.$ref);
+        const host = engine.host;
+        if (host && typeof host.getSchemaDefinition === "function") {
+          const resolved = host.getSchemaDefinition(itemsSchema.$ref);
           Logger.debug(`[MetaUI] Resolved schema for ${itemsSchema.$ref}: ${!!resolved} ${resolved ? Object.keys(resolved) : ""}`, "", "TableLayout");
           if (resolved && resolved.properties) {
             itemsSchema = resolved;
@@ -36,13 +39,32 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
             Logger.error(`[MetaUI] TableLayout resolved schema but it has no properties!`, "", "TableLayout");
           }
         } else {
-          Logger.error(`[MetaUI] TableLayout cannot resolve ${itemsSchema.$ref} because engine.host.getSchemaDefinition is missing! host: ${engine.host?.getMetadata().getName()}`, "", "TableLayout");
+          Logger.error(`[MetaUI] TableLayout cannot resolve ${itemsSchema.$ref} because engine.host.getSchemaDefinition is missing! host: ${host?.getMetadata().getName()}`, "", "TableLayout");
         }
       }
-      if (schema.type !== "array" || !itemsSchema || !itemsSchema.properties) {
+      const isPrimitive = itemsSchema && !itemsSchema.properties && ["string", "number", "boolean"].includes(itemsSchema.type);
+      if (schema.type !== SCHEMA_TYPE.ARRAY || !itemsSchema || !itemsSchema.properties && !isPrimitive) {
         Logger.error(`[MetaUI] TableLayout fatal error! schema.type: ${schema.type}, itemsSchema: ${!!itemsSchema}, properties: ${itemsSchema ? !!itemsSchema.properties : false}`, "", "TableLayout");
-        throw new Error("[MetaUI] TableLayout requires an array schema with items.properties.");
+        throw new Error("[MetaUI] TableLayout requires an array schema with items.properties or primitive items.");
       }
+      const createSkeleton = meta => {
+        if (meta.type === "object" && meta.properties) {
+          const obj = {};
+          for (const key of Object.keys(meta.properties)) {
+            obj[key] = createSkeleton(meta.properties[key]);
+          }
+          return obj;
+        } else if (meta.type === "array") {
+          return [];
+        } else if (meta.type === "string") {
+          return meta.default !== undefined ? meta.default : meta.enum ? meta.enum[0] : "";
+        } else if (meta.type === "number") {
+          return meta.default !== undefined ? meta.default : 0;
+        } else if (meta.type === "boolean") {
+          return meta.default !== undefined ? meta.default : false;
+        }
+        return "";
+      };
       const tableTitle = schema.title || "Table";
       const actualModelName = modelName;
       const actualPath = bindingPath;
@@ -55,13 +77,13 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
             icon: "sap-icon://add",
             press: oEvent => {
               const btn = oEvent.getSource();
-              const tbl = btn.getParent().getParent();
+              const tbl = btn.getParent()?.getParent();
               const model = tbl.getModel(actualModelName);
               const info = tbl.getBindingInfo("items");
               if (!info || !info.path) return;
               const rawData = model.getProperty(info.path);
               const data = Array.isArray(rawData) ? rawData : [];
-              const newData = [...data, {}];
+              const newData = [...data, createSkeleton(itemsSchema)];
               model.setProperty(info.path, newData);
 
               // CRITICAL: Notify the engine so it extracts payload and triggers liveUpdate
@@ -75,7 +97,8 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
         mode: !engine.isEditable ? "None" : "Delete",
         delete: oEvent => {
           const item = oEvent.getParameter("listItem");
-          const path = item.getBindingContext(actualModelName).getPath();
+          const path = item.getBindingContext(actualModelName)?.getPath();
+          if (!path) return;
           const model = item.getModel(actualModelName);
           const splitPaths = path.split("/");
           const index = parseInt(splitPaths.pop() || "0", 10);
@@ -91,12 +114,25 @@ sap.ui.define(["sap/m/Table", "sap/m/Column", "sap/m/Text", "sap/m/ColumnListIte
           if (engine.onChange) {
             engine.onChange(true, actualPath.replace(/^\//, ""));
           }
+
+          // CRITICAL: Clear ghost errors that shifted due to array mutation
+          if (typeof engine.onArrayMutated === "function") {
+            engine.onArrayMutated(arrayPath);
+          }
         }
       });
       const templateCells = [];
       const props = itemsSchema.properties;
       const layoutElements = schema.uiLayout;
-      if (layoutElements && Array.isArray(layoutElements)) {
+      if (isPrimitive) {
+        table.addColumn(new Column({
+          header: new Text({
+            text: "Value"
+          })
+        }));
+        const control = engine.generateField(itemsSchema, "", actualModelName || "meta", true);
+        templateCells.push(control);
+      } else if (layoutElements && Array.isArray(layoutElements)) {
         // Only render columns defined in uiLayout
         layoutElements.forEach(element => {
           if (element.type === "Control" && element.scope) {