@siliconst/metaui 1.0.2 → 1.4.4

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

@@ -0,0 +1,139 @@
+/**
+ * @file CompactLayout.ts
+ * @description Generates a lightweight, dense VBox layout for use inside tight spaces like table cells.
+ */
+
+import VBox from "sap/m/VBox";
+import Label from "sap/m/Label";
+import Title from "sap/ui/core/Title";
+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";
+
+/**
+ * Layout Manager responsible for generating a dense, lightweight layout (no SimpleForm padding).
+ * Ideal for rendering objects dynamically inside table cells or side-panels.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.layouts
+ * @public
+ */
+export class CompactLayout implements ILayoutManager {
+    /**
+     * Renders the JSON Schema properties into a dense VBox layout.
+     * 
+     * @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 compact form.
+     */
+    public render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control {
+        const container = new VBox({ renderType: "Bare" });
+        container.addStyleClass("sapUiTinyMargin");
+
+        if (!schema.uiLayout || !Array.isArray(schema.uiLayout)) {
+            Logger.warn("[MetaUI] Missing 'uiLayout' array in schema. CompactLayout will not render any fields.");
+            return container;
+        }
+
+        const tableElements: { scope: string, meta: IPropertyMetadata, label?: string }[] = [];
+
+        // Recursively render layout elements
+        const renderElement = (element: ILayoutElement) => {
+            if (element.type === "Group") {
+                if (element.label) {
+                    const title = new sap.m.Title({ text: element.label, level: "H5" });
+                    title.addStyleClass("sapUiTinyMarginTop sapUiTinyMarginBottom");
+                    container.addItem(title);
+                }
+                
+                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.`, "", "CompactLayout");
+                    return;
+                }
+                
+                const propKey = element.scope.replace("#/properties/", "");
+                const meta = schema.properties?.[propKey];
+                
+                if (!meta) {
+                    Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions.`, "", "CompactLayout");
+                    return;
+                }
+
+                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 CompactLayout]", `Routing property '${propKey}' to Table Sub-Layout.`, "CompactLayout");
+                    tableElements.push({ scope: propKey, meta, label: element.label });
+                } else {
+                    Logger.debug("[MetaUI CompactLayout]", `Rendering scalar field '${propKey}'.`, "CompactLayout");
+                    this._renderScalarField(container, element, propKey, meta, modelName, engine);
+                }
+            } else {
+                Logger.warn(`[MetaUI] Unsupported layout element type '${element.type}'.`, "", "CompactLayout");
+            }
+        };
+
+        // Render everything defined in the layout
+        schema.uiLayout.forEach(renderElement);
+
+        // Render array/table sub-layouts full width below the fields
+        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
+                };
+                
+                const control = engine.generateLayout(subSchema as ISchema, modelName, `/${field.scope}`);
+                if (control) {
+                    control.addStyleClass("sapUiTinyMarginTop");
+                    container.addItem(control);
+                }
+            } catch (error) {
+                const msg = (error as Error).message;
+                Logger.error(`[MetaUI] Failed to render array field ${field.scope}`, msg, "CompactLayout");
+                Logger.showErrorPopup(`Failed to render array field '${field.scope}'.\n\nDetails: ${msg}`);
+            }
+        });
+
+        return container;
+    }
+
+    private _renderScalarField(container: VBox, 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
+            });
+            label.addStyleClass("sapUiTinyMarginTop");
+
+            const effectiveMeta = { ...meta };
+            if (element.widget) {
+                effectiveMeta.ui = { ...meta.ui, widget: element.widget };
+            }
+
+            const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);
+            control.addStyleClass("sapUiTinyMarginBottom");
+
+            // Wrap label and field tightly
+            const fieldBox = new VBox({ renderType: "Bare", items: [label, control] });
+            container.addItem(fieldBox);
+        } catch (error) {
+            const msg = (error as Error).message;
+            Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, "CompactLayout");
+            Logger.showErrorPopup(`Failed to render field '${propKey}'.\n\nDetails: ${msg}`);
+        }
+    }
+}

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

@@ -1,57 +1,170 @@
-sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "../core/PluginRegistry"], function (SimpleForm, Label, ___core_PluginRegistry) {
-  "use strict";
-
-  const PluginRegistry = ___core_PluginRegistry["PluginRegistry"];
-  /**
-   * Utility class strictly for constructing Form layouts without custom CSS.
-   */
-  class FormLayout {
-    /**
-     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.
-     * @param fields The array of root fields to render as FormElements.
-     * @returns A fully populated sap.ui.layout.form.SimpleForm.
-     */
-    static build(fields) {
-      const form = new SimpleForm({
-        editable: true,
-        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 registry = PluginRegistry.getInstance();
-      fields.forEach(field => {
-        // Respect Fiori accessibility standards by enforcing the required flag on labels
-        const label = new Label({
-          text: field.label,
-          required: field.isRequired
-        });
-
-        // Instantiate the correct plugin for the data type
-        const plugin = registry.getPlugin(field.type);
-
-        // In the isolated state manager architecture, the binding path maps exactly to the fieldName.
-        const control = plugin.render(field, `/${field.fieldName}`);
-        form.addContent(label);
-        form.addContent(control);
-      });
-      return form;
-    }
-  }
-  var __exports = {
-    __esModule: true
-  };
-  __exports.FormLayout = FormLayout;
-  return __exports;
-});
+sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Title", "sap/m/VBox", "../utils/Logger"], function (SimpleForm, Label, Title, VBox, ___utils_Logger) {
+  "use strict";
+
+  const Logger = ___utils_Logger["Logger"];
+  /**
+   * 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
+   */
+  class FormLayout {
+    /**
+     * 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.
+     */
+    render(schema, modelName, engine, onSubmit) {
+      const container = new VBox({
+        renderType: "Bare"
+      });
+      const form = new SimpleForm({
+        editable: true,
+        title: schema.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 (!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;
+      }
+      const tableElements = [];
+      let hasFormFields = false;
+
+      // Recursively render layout elements
+      const renderElement = element => {
+        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");
+        }
+      };
+
+      // 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, 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;
+    }
+    _renderScalarField(form, element, propKey, meta, modelName, engine) {
+      try {
+        const labelText = element.label || meta.ui?.label || propKey;
+        const label = new Label({
+          text: labelText,
+          required: meta.required
+        });
+
+        // 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 => {
+            control.setLayoutData(new GridData({
+              span: "XL12 L12 M12 S12"
+            }));
+          });
+        }
+        form.addContent(label);
+        form.addContent(control);
+      } catch (error) {
+        const msg = error.message;
+        Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, "FormLayout");
+        Logger.showErrorPopup(`Failed to render field '${propKey}'.\n\nDetails: ${msg}`);
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.FormLayout = FormLayout;
+  return __exports;
+});
 //# sourceMappingURL=FormLayout-dbg.js.map

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","fields","form","SimpleForm","editable","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","registry","getInstance","forEach","field","label","Label","text","required","isRequired","plugin","getPlugin","type","control","render","fieldName","addContent","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\r\n * @file FormLayout.ts\r\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\r\n */\r\n\r\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\r\nimport Label from \"sap/m/Label\";\r\nimport { IFieldMetadata } from \"../interfaces/ISchema\";\r\nimport { PluginRegistry } from \"../core/PluginRegistry\";\r\n\r\n/**\r\n * Utility class strictly for constructing Form layouts without custom CSS.\r\n */\r\nexport class FormLayout {\r\n    /**\r\n     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.\r\n     * @param fields The array of root fields to render as FormElements.\r\n     * @returns A fully populated sap.ui.layout.form.SimpleForm.\r\n     */\r\n    public static build(fields: IFieldMetadata[]): SimpleForm {\r\n        const form = new SimpleForm({\r\n            editable: true,\r\n            layout: \"ResponsiveGridLayout\",\r\n            labelSpanXL: 4,\r\n            labelSpanL: 4,\r\n            labelSpanM: 4,\r\n            labelSpanS: 12,\r\n            adjustLabelSpan: false,\r\n            emptySpanXL: 0,\r\n            emptySpanL: 0,\r\n            emptySpanM: 0,\r\n            emptySpanS: 0,\r\n            columnsXL: 1,\r\n            columnsL: 1,\r\n            columnsM: 1,\r\n            singleContainerFullSize: false\r\n        });\r\n\r\n        const registry = PluginRegistry.getInstance();\r\n\r\n        fields.forEach((field) => {\r\n            // Respect Fiori accessibility standards by enforcing the required flag on labels\r\n            const label = new Label({\r\n                text: field.label,\r\n                required: field.isRequired\r\n            });\r\n\r\n            // Instantiate the correct plugin for the data type\r\n            const plugin = registry.getPlugin(field.type);\r\n            \r\n            // In the isolated state manager architecture, the binding path maps exactly to the fieldName.\r\n            const control = plugin.render(field, `/${field.fieldName}`);\r\n\r\n            form.addContent(label);\r\n            form.addContent(control);\r\n        });\r\n\r\n        return form;\r\n    }\r\n}\r\n"],"mappings":";;;QAQSA,cAAc,GAAAC,sBAAA;EAEvB;AACA;AACA;EACO,MAAMC,UAAU,CAAC;IACpB;AACJ;AACA;AACA;AACA;IACI,OAAcC,KAAKA,CAACC,MAAwB,EAAc;MACtD,MAAMC,IAAI,GAAG,IAAIC,UAAU,CAAC;QACxBC,QAAQ,EAAE,IAAI;QACdC,MAAM,EAAE,sBAAsB;QAC9BC,WAAW,EAAE,CAAC;QACdC,UAAU,EAAE,CAAC;QACbC,UAAU,EAAE,CAAC;QACbC,UAAU,EAAE,EAAE;QACdC,eAAe,EAAE,KAAK;QACtBC,WAAW,EAAE,CAAC;QACdC,UAAU,EAAE,CAAC;QACbC,UAAU,EAAE,CAAC;QACbC,UAAU,EAAE,CAAC;QACbC,SAAS,EAAE,CAAC;QACZC,QAAQ,EAAE,CAAC;QACXC,QAAQ,EAAE,CAAC;QACXC,uBAAuB,EAAE;MAC7B,CAAC,CAAC;MAEF,MAAMC,QAAQ,GAAGtB,cAAc,CAACuB,WAAW,CAAC,CAAC;MAE7CnB,MAAM,CAACoB,OAAO,CAAEC,KAAK,IAAK;QACtB;QACA,MAAMC,KAAK,GAAG,IAAIC,KAAK,CAAC;UACpBC,IAAI,EAAEH,KAAK,CAACC,KAAK;UACjBG,QAAQ,EAAEJ,KAAK,CAACK;QACpB,CAAC,CAAC;;QAEF;QACA,MAAMC,MAAM,GAAGT,QAAQ,CAACU,SAAS,CAACP,KAAK,CAACQ,IAAI,CAAC;;QAE7C;QACA,MAAMC,OAAO,GAAGH,MAAM,CAACI,MAAM,CAACV,KAAK,EAAE,IAAIA,KAAK,CAACW,SAAS,EAAE,CAAC;QAE3D/B,IAAI,CAACgC,UAAU,CAACX,KAAK,CAAC;QACtBrB,IAAI,CAACgC,UAAU,CAACH,OAAO,CAAC;MAC5B,CAAC,CAAC;MAEF,OAAO7B,IAAI;IACf;EACJ;EAAC,IAAAiC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApC,UAAA,GAAAA,UAAA;EAAA,OAAAoC,SAAA;AAAA","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 { IFieldMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    /**
-     * Utility class strictly for constructing Form layouts without custom CSS.
-     */
-    export class FormLayout {
+    export class FormLayout implements ILayoutManager {
         /**
-         * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.
-         * @param fields The array of root fields to render as FormElements.
-         * @returns A fully populated sap.ui.layout.form.SimpleForm.
+         * 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(fields: IFieldMetadata[]): 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;IAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;IAG/E;;OAEG;IACH,MAAa,UAAU;QACnB;;;;WAIG;eACW,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU;KAwC5D;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","../core/PluginRegistry"],function(e,n,t){"use strict";const a=t["PluginRegistry"];class l{static build(t){const l=new e({editable:true,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 s=a.getInstance();t.forEach(e=>{const t=new n({text:e.label,required:e.isRequired});const a=s.getPlugin(e.type);const o=a.render(e,`/${e.fieldName}`);l.addContent(t);l.addContent(o)});return l}}var s={__esModule:true};s.FormLayout=l;return s});
+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","fields","form","SimpleForm","editable","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","registry","getInstance","forEach","field","label","Label","text","required","isRequired","plugin","getPlugin","type","control","render","fieldName","addContent","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\r\n * @file FormLayout.ts\r\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\r\n */\r\n\r\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\r\nimport Label from \"sap/m/Label\";\r\nimport { IFieldMetadata } from \"../interfaces/ISchema\";\r\nimport { PluginRegistry } from \"../core/PluginRegistry\";\r\n\r\n/**\r\n * Utility class strictly for constructing Form layouts without custom CSS.\r\n */\r\nexport class FormLayout {\r\n    /**\r\n     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.\r\n     * @param fields The array of root fields to render as FormElements.\r\n     * @returns A fully populated sap.ui.layout.form.SimpleForm.\r\n     */\r\n    public static build(fields: IFieldMetadata[]): SimpleForm {\r\n        const form = new SimpleForm({\r\n            editable: true,\r\n            layout: \"ResponsiveGridLayout\",\r\n            labelSpanXL: 4,\r\n            labelSpanL: 4,\r\n            labelSpanM: 4,\r\n            labelSpanS: 12,\r\n            adjustLabelSpan: false,\r\n            emptySpanXL: 0,\r\n            emptySpanL: 0,\r\n            emptySpanM: 0,\r\n            emptySpanS: 0,\r\n            columnsXL: 1,\r\n            columnsL: 1,\r\n            columnsM: 1,\r\n            singleContainerFullSize: false\r\n        });\r\n\r\n        const registry = PluginRegistry.getInstance();\r\n\r\n        fields.forEach((field) => {\r\n            // Respect Fiori accessibility standards by enforcing the required flag on labels\r\n            const label = new Label({\r\n                text: field.label,\r\n                required: field.isRequired\r\n            });\r\n\r\n            // Instantiate the correct plugin for the data type\r\n            const plugin = registry.getPlugin(field.type);\r\n            \r\n            // In the isolated state manager architecture, the binding path maps exactly to the fieldName.\r\n            const control = plugin.render(field, `/${field.fieldName}`);\r\n\r\n            form.addContent(label);\r\n            form.addContent(control);\r\n        });\r\n\r\n        return form;\r\n    }\r\n}\r\n"],"mappings":"0HAQSA,EAAcC,EAAA,kBAKhB,MAAMC,EAMT,YAAcC,CAAMC,GAChB,MAAMC,EAAO,IAAIC,EAAW,CACxBC,SAAU,KACVC,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,EAAWtB,EAAeuB,cAEhCnB,EAAOoB,QAASC,IAEZ,MAAMC,EAAQ,IAAIC,EAAM,CACpBC,KAAMH,EAAMC,MACZG,SAAUJ,EAAMK,aAIpB,MAAMC,EAAST,EAASU,UAAUP,EAAMQ,MAGxC,MAAMC,EAAUH,EAAOI,OAAOV,EAAO,IAAIA,EAAMW,aAE/C/B,EAAKgC,WAAWX,GAChBrB,EAAKgC,WAAWH,KAGpB,OAAO7B,CACX,EACH,IAAAiC,EAAA,CAAAC,WAAA,MAAAD,EAAApC,aAAA,OAAAoC,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":[]}