@siliconst/metaui 1.2.0 → 1.4.5

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

@@ -1,19 +1,32 @@
-sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Title", "../core/PluginRegistry"], function (SimpleForm, Label, Title, ___core_PluginRegistry) {
+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) {
   "use strict";
 
-  const PluginRegistry = ___core_PluginRegistry["PluginRegistry"];
+  const SchemaNormalizer = ___core_SchemaNormalizer["SchemaNormalizer"];
+  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 {
     /**
-     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.
-     * @param properties The dictionary of fields to render.
-     * @param modelName The dynamic model name.
-     * @param formTitle Optional title for the form block.
-     * @param trackPlugin Optional callback to track instantiated plugins.
+     * Renders the JSON Schema properties into a UI5 SimpleForm using the uiLayout definitions.
+     * 
+     * @param schema The active JSON schema subset.
+     * @param modelName The bound UI5 model name.
+     * @param engine The central orchestrator for delegating plugin generation.
+     * @param onSubmit Optional submit hook.
+     * @returns {Control} The VBox wrapper containing the generated form.
      */
-    static build(properties, modelName = "meta", formTitle, trackPlugin) {
+    render(schema, modelName, engine, onSubmit) {
+      const container = new VBox({
+        renderType: "Bare"
+      });
       const form = new SimpleForm({
         editable: true,
-        title: formTitle,
+        title: schema.title,
         layout: "ResponsiveGridLayout",
         labelSpanXL: 4,
         labelSpanL: 4,
@@ -29,65 +42,127 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
         columnsM: 1,
         singleContainerFullSize: false
       });
-      const registry = PluginRegistry.getInstance();
-
-      // Group fields by their ui.group directive
-      const groups = {};
-      const DEFAULT_GROUP = "__DEFAULT__";
-      for (const key of Object.keys(properties)) {
-        const meta = properties[key];
-        const groupName = meta.ui?.group || DEFAULT_GROUP;
-        if (!groups[groupName]) groups[groupName] = [];
-        groups[groupName].push({
-          key,
-          meta
-        });
+      if (!schema.uiLayout || !Array.isArray(schema.uiLayout)) {
+        Logger.warn("[MetaUI] Missing 'uiLayout' array in schema. Form will not render any fields.");
+        container.addItem(form);
+        return container;
       }
+      const tableElements = [];
+      let hasFormFields = false;
 
-      // Render groups
-      for (const groupName of Object.keys(groups)) {
-        if (groupName !== DEFAULT_GROUP) {
-          form.addContent(new Title({
-            text: groupName
-          }));
-        }
-        groups[groupName].forEach(field => {
-          try {
-            const label = new Label({
-              text: field.meta.ui?.label || field.key,
-              required: field.meta.required
-            });
+      // 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 {
+            meta,
+            bindingPath,
+            propKey
+          } = SchemaNormalizer.resolveScope(schema, element.scope);
+          if (!meta) {
+            Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions.`, "", "FormLayout");
+            return;
+          }
 
-            // Attach visibility condition to label and control container logic
-            if (field.meta.ui?.visibleOn) {
-              const expr = `{= ${field.meta.ui.visibleOn.replace(/\$root\./g, `${modelName}>/`).replace(/\./g, '/')} }`;
-              label.bindProperty("visible", {
-                parts: [{
-                  path: "meta>/"
-                }],
-                formatter: () => false
-              }); // temporary, condition engine does this usually
-            }
-            const plugin = registry.getPlugin(field.meta.type, field.meta.ui?.widget);
-            if (trackPlugin) trackPlugin(plugin);
-            const control = plugin.render(field.meta, `/${field.key}`, modelName);
-            if (field.meta.ui?.fullWidth) {
-              sap.ui.require(["sap/ui/layout/GridData"], GridData => {
-                control.setLayoutData(new GridData({
-                  span: "XL12 L12 M12 S12"
-                }));
-              });
-            }
-            form.addContent(label);
-            form.addContent(control);
-          } catch (error) {
-            sap.ui.require(["sap/base/Log"], Log => {
-              if (Log) Log.error(`[MetaUI] Failed to render field ${field.key}`, error.message, "FormLayout");
+          // 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: bindingPath,
+              meta,
+              label: element.label
             });
+          } else {
+            hasFormFields = true;
+            Logger.debug("[MetaUI FormLayout]", `Rendering scalar field '${bindingPath}'.`, "FormLayout");
+            this._renderScalarField(form, element, bindingPath, 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}`);
       }
-      return form;
     }
   }
   var __exports = {

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayout-dbg.js","names":["PluginRegistry","___core_PluginRegistry","FormLayout","build","properties","modelName","formTitle","trackPlugin","form","SimpleForm","editable","title","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","registry","getInstance","groups","DEFAULT_GROUP","key","Object","keys","meta","groupName","ui","group","push","addContent","Title","text","forEach","field","label","Label","required","visibleOn","expr","replace","bindProperty","parts","path","formatter","plugin","getPlugin","type","widget","control","render","fullWidth","sap","require","GridData","setLayoutData","span","error","Log","message","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\n * @file FormLayout.ts\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\n */\n\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\nimport Label from \"sap/m/Label\";\nimport Title from \"sap/ui/core/Title\";\nimport { IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\nimport { IPlugin } from \"../interfaces/IPlugin\";\n\nexport class FormLayout {\n    /**\n     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.\n     * @param properties The dictionary of fields to render.\n     * @param modelName The dynamic model name.\n     * @param formTitle Optional title for the form block.\n     * @param trackPlugin Optional callback to track instantiated plugins.\n     */\n    public static build(properties: Record<string, IPropertyMetadata>, modelName: string = \"meta\", formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): SimpleForm {\n        const form = new SimpleForm({\n            editable: true,\n            title: formTitle,\n            layout: \"ResponsiveGridLayout\",\n            labelSpanXL: 4,\n            labelSpanL: 4,\n            labelSpanM: 4,\n            labelSpanS: 12,\n            adjustLabelSpan: false,\n            emptySpanXL: 0,\n            emptySpanL: 0,\n            emptySpanM: 0,\n            emptySpanS: 0,\n            columnsXL: 1,\n            columnsL: 1,\n            columnsM: 1,\n            singleContainerFullSize: false\n        });\n\n        const registry = PluginRegistry.getInstance();\n        \n        // Group fields by their ui.group directive\n        const groups: Record<string, { key: string; meta: IPropertyMetadata }[]> = {};\n        const DEFAULT_GROUP = \"__DEFAULT__\";\n        \n        for (const key of Object.keys(properties)) {\n            const meta = properties[key];\n            const groupName = meta.ui?.group || DEFAULT_GROUP;\n            if (!groups[groupName]) groups[groupName] = [];\n            groups[groupName].push({ key, meta });\n        }\n\n        // Render groups\n        for (const groupName of Object.keys(groups)) {\n            if (groupName !== DEFAULT_GROUP) {\n                form.addContent(new Title({ text: groupName }));\n            }\n            \n            groups[groupName].forEach((field) => {\n                try {\n                    const label = new Label({\n                        text: field.meta.ui?.label || field.key,\n                        required: field.meta.required\n                    });\n\n                    // Attach visibility condition to label and control container logic\n                    if (field.meta.ui?.visibleOn) {\n                        const expr = `{= ${field.meta.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n                        label.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false}); // temporary, condition engine does this usually\n                    }\n\n                    const plugin = registry.getPlugin(field.meta.type, field.meta.ui?.widget);\n                    if (trackPlugin) trackPlugin(plugin);\n                    const control = plugin.render(field.meta, `/${field.key}`, modelName);\n\n                    if (field.meta.ui?.fullWidth) {\n                        sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                            control.setLayoutData(new GridData({\n                                span: \"XL12 L12 M12 S12\"\n                            }));\n                        });\n                    }\n\n                    form.addContent(label);\n                    form.addContent(control);\n                } catch (error) {\n                    sap.ui.require([\"sap/base/Log\"], (Log: any) => {\n                        if (Log) Log.error(`[MetaUI] Failed to render field ${field.key}`, (error as Error).message, \"FormLayout\");\n                    });\n                }\n            });\n        }\n\n        return form;\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"FormLayout-dbg.js","names":["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","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 { 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    private _renderScalarField(form: SimpleForm, element: ILayoutElement, propKey: string, meta: IPropertyMetadata, modelName: string, engine: Engine): void {\n        try {\n            const labelText = element.label || meta.ui?.label || propKey;\n            const label = new Label({\n                text: labelText,\n                required: meta.required\n            });\n\n            // Override widget if specified in the layout element\n            const effectiveMeta = { ...meta };\n            if (element.widget) {\n                effectiveMeta.ui = { ...meta.ui, widget: element.widget };\n            }\n\n            const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);\n\n            if (effectiveMeta.ui?.fullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                    control.setLayoutData(new GridData({ span: \"XL12 L12 M12 S12\" }));\n                });\n            }\n\n            form.addContent(label);\n            form.addContent(control);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, \"FormLayout\");\n            Logger.showErrorPopup(`Failed to render field '${propKey}'.\\n\\nDetails: ${msg}`);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

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

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

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

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

@@ -1,2 +1,2 @@
-sap.ui.define(["sap/ui/layout/form/SimpleForm","sap/m/Label","sap/ui/core/Title","../core/PluginRegistry"],function(e,t,a,n){"use strict";const i=n["PluginRegistry"];class s{static build(n,s="meta",o,r){const l=new e({editable:true,title:o,layout:"ResponsiveGridLayout",labelSpanXL:4,labelSpanL:4,labelSpanM:4,labelSpanS:12,adjustLabelSpan:false,emptySpanXL:0,emptySpanL:0,emptySpanM:0,emptySpanS:0,columnsXL:1,columnsL:1,columnsM:1,singleContainerFullSize:false});const u=i.getInstance();const p={};const c="__DEFAULT__";for(const e of Object.keys(n)){const t=n[e];const a=t.ui?.group||c;if(!p[a])p[a]=[];p[a].push({key:e,meta:t})}for(const e of Object.keys(p)){if(e!==c){l.addContent(new a({text:e}))}p[e].forEach(e=>{try{const a=new t({text:e.meta.ui?.label||e.key,required:e.meta.required});if(e.meta.ui?.visibleOn){const t=`{= ${e.meta.ui.visibleOn.replace(/\$root\./g,`${s}>/`).replace(/\./g,"/")} }`;a.bindProperty("visible",{parts:[{path:"meta>/"}],formatter:()=>false})}const n=u.getPlugin(e.meta.type,e.meta.ui?.widget);if(r)r(n);const i=n.render(e.meta,`/${e.key}`,s);if(e.meta.ui?.fullWidth){sap.ui.require(["sap/ui/layout/GridData"],e=>{i.setLayoutData(new e({span:"XL12 L12 M12 S12"}))})}l.addContent(a);l.addContent(i)}catch(t){sap.ui.require(["sap/base/Log"],a=>{if(a)a.error(`[MetaUI] Failed to render field ${e.key}`,t.message,"FormLayout")})}})}return l}}var o={__esModule:true};o.FormLayout=s;return o});
+sap.ui.define(["sap/ui/layout/form/SimpleForm","sap/m/Label","sap/ui/core/Title","sap/m/VBox","../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 y=false;const c=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(c)}}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 c=!!a.ui?.widget;const m=a.type==="array"&&u&&!c;if(m){s.debug("[MetaUI FormLayout]",`Routing property '${l}' to Table Sub-Layout.`,"FormLayout");d.push({scope:r,meta:a,label:e.label})}else{y=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(c);if(y){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);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;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});
 //# sourceMappingURL=FormLayout.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormLayout.js","names":["PluginRegistry","___core_PluginRegistry","FormLayout","build","properties","modelName","formTitle","trackPlugin","form","SimpleForm","editable","title","layout","labelSpanXL","labelSpanL","labelSpanM","labelSpanS","adjustLabelSpan","emptySpanXL","emptySpanL","emptySpanM","emptySpanS","columnsXL","columnsL","columnsM","singleContainerFullSize","registry","getInstance","groups","DEFAULT_GROUP","key","Object","keys","meta","groupName","ui","group","push","addContent","Title","text","forEach","field","label","Label","required","visibleOn","expr","replace","bindProperty","parts","path","formatter","plugin","getPlugin","type","widget","control","render","fullWidth","sap","require","GridData","setLayoutData","span","error","Log","message","__exports","__esModule"],"sources":["FormLayout.ts"],"sourcesContent":["/**\n * @file FormLayout.ts\n * @description Generates a fully responsive SAP Fiori Form layout (SimpleForm).\n */\n\nimport SimpleForm from \"sap/ui/layout/form/SimpleForm\";\nimport Label from \"sap/m/Label\";\nimport Title from \"sap/ui/core/Title\";\nimport { IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"../core/PluginRegistry\";\nimport { IPlugin } from \"../interfaces/IPlugin\";\n\nexport class FormLayout {\n    /**\n     * Builds a SimpleForm with ResponsiveGridLayout, injecting the requested plugins.\n     * @param properties The dictionary of fields to render.\n     * @param modelName The dynamic model name.\n     * @param formTitle Optional title for the form block.\n     * @param trackPlugin Optional callback to track instantiated plugins.\n     */\n    public static build(properties: Record<string, IPropertyMetadata>, modelName: string = \"meta\", formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): SimpleForm {\n        const form = new SimpleForm({\n            editable: true,\n            title: formTitle,\n            layout: \"ResponsiveGridLayout\",\n            labelSpanXL: 4,\n            labelSpanL: 4,\n            labelSpanM: 4,\n            labelSpanS: 12,\n            adjustLabelSpan: false,\n            emptySpanXL: 0,\n            emptySpanL: 0,\n            emptySpanM: 0,\n            emptySpanS: 0,\n            columnsXL: 1,\n            columnsL: 1,\n            columnsM: 1,\n            singleContainerFullSize: false\n        });\n\n        const registry = PluginRegistry.getInstance();\n        \n        // Group fields by their ui.group directive\n        const groups: Record<string, { key: string; meta: IPropertyMetadata }[]> = {};\n        const DEFAULT_GROUP = \"__DEFAULT__\";\n        \n        for (const key of Object.keys(properties)) {\n            const meta = properties[key];\n            const groupName = meta.ui?.group || DEFAULT_GROUP;\n            if (!groups[groupName]) groups[groupName] = [];\n            groups[groupName].push({ key, meta });\n        }\n\n        // Render groups\n        for (const groupName of Object.keys(groups)) {\n            if (groupName !== DEFAULT_GROUP) {\n                form.addContent(new Title({ text: groupName }));\n            }\n            \n            groups[groupName].forEach((field) => {\n                try {\n                    const label = new Label({\n                        text: field.meta.ui?.label || field.key,\n                        required: field.meta.required\n                    });\n\n                    // Attach visibility condition to label and control container logic\n                    if (field.meta.ui?.visibleOn) {\n                        const expr = `{= ${field.meta.ui.visibleOn.replace(/\\$root\\./g, `${modelName}>/`).replace(/\\./g, '/')} }`;\n                        label.bindProperty(\"visible\", { parts: [{ path: \"meta>/\" }], formatter: () => false}); // temporary, condition engine does this usually\n                    }\n\n                    const plugin = registry.getPlugin(field.meta.type, field.meta.ui?.widget);\n                    if (trackPlugin) trackPlugin(plugin);\n                    const control = plugin.render(field.meta, `/${field.key}`, modelName);\n\n                    if (field.meta.ui?.fullWidth) {\n                        sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                            control.setLayoutData(new GridData({\n                                span: \"XL12 L12 M12 S12\"\n                            }));\n                        });\n                    }\n\n                    form.addContent(label);\n                    form.addContent(control);\n                } catch (error) {\n                    sap.ui.require([\"sap/base/Log\"], (Log: any) => {\n                        if (Log) Log.error(`[MetaUI] Failed to render field ${field.key}`, (error as Error).message, \"FormLayout\");\n                    });\n                }\n            });\n        }\n\n        return form;\n    }\n}\n"],"mappings":"gJASSA,EAAcC,EAAA,kBAGhB,MAAMC,EAQT,YAAcC,CAAMC,EAA+CC,EAAoB,OAAQC,EAAoBC,GAC/G,MAAMC,EAAO,IAAIC,EAAW,CACxBC,SAAU,KACVC,MAAOL,EACPM,OAAQ,uBACRC,YAAa,EACbC,WAAY,EACZC,WAAY,EACZC,WAAY,GACZC,gBAAiB,MACjBC,YAAa,EACbC,WAAY,EACZC,WAAY,EACZC,WAAY,EACZC,UAAW,EACXC,SAAU,EACVC,SAAU,EACVC,wBAAyB,QAG7B,MAAMC,EAAW1B,EAAe2B,cAGhC,MAAMC,EAAqE,CAAC,EAC5E,MAAMC,EAAgB,cAEtB,IAAK,MAAMC,KAAOC,OAAOC,KAAK5B,GAAa,CACvC,MAAM6B,EAAO7B,EAAW0B,GACxB,MAAMI,EAAYD,EAAKE,IAAIC,OAASP,EACpC,IAAKD,EAAOM,GAAYN,EAAOM,GAAa,GAC5CN,EAAOM,GAAWG,KAAK,CAAEP,MAAKG,QAClC,CAGA,IAAK,MAAMC,KAAaH,OAAOC,KAAKJ,GAAS,CACzC,GAAIM,IAAcL,EAAe,CAC7BrB,EAAK8B,WAAW,IAAIC,EAAM,CAAEC,KAAMN,IACtC,CAEAN,EAAOM,GAAWO,QAASC,IACvB,IACI,MAAMC,EAAQ,IAAIC,EAAM,CACpBJ,KAAME,EAAMT,KAAKE,IAAIQ,OAASD,EAAMZ,IACpCe,SAAUH,EAAMT,KAAKY,WAIzB,GAAIH,EAAMT,KAAKE,IAAIW,UAAW,CAC1B,MAAMC,EAAO,MAAML,EAAMT,KAAKE,GAAGW,UAAUE,QAAQ,YAAa,GAAG3C,OAAe2C,QAAQ,MAAO,SACjGL,EAAMM,aAAa,UAAW,CAAEC,MAAO,CAAC,CAAEC,KAAM,WAAaC,UAAWA,IAAM,OAClF,CAEA,MAAMC,EAAS3B,EAAS4B,UAAUZ,EAAMT,KAAKsB,KAAMb,EAAMT,KAAKE,IAAIqB,QAClE,GAAIjD,EAAaA,EAAY8C,GAC7B,MAAMI,EAAUJ,EAAOK,OAAOhB,EAAMT,KAAM,IAAIS,EAAMZ,MAAOzB,GAE3D,GAAIqC,EAAMT,KAAKE,IAAIwB,UAAW,CAC1BC,IAAIzB,GAAG0B,QAAQ,CAAC,0BAA4BC,IACxCL,EAAQM,cAAc,IAAID,EAAS,CAC/BE,KAAM,uBAGlB,CAEAxD,EAAK8B,WAAWK,GAChBnC,EAAK8B,WAAWmB,EACpB,CAAE,MAAOQ,GACLL,IAAIzB,GAAG0B,QAAQ,CAAC,gBAAkBK,IAC9B,GAAIA,EAAKA,EAAID,MAAM,mCAAmCvB,EAAMZ,MAAQmC,EAAgBE,QAAS,eAErG,GAER,CAEA,OAAO3D,CACX,EACH,IAAA4D,EAAA,CAAAC,WAAA,MAAAD,EAAAlE,aAAA,OAAAkE,CAAA","ignoreList":[]}
+{"version":3,"file":"FormLayout.js","names":["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","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 { 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    private _renderScalarField(form: SimpleForm, element: ILayoutElement, propKey: string, meta: IPropertyMetadata, modelName: string, engine: Engine): void {\n        try {\n            const labelText = element.label || meta.ui?.label || propKey;\n            const label = new Label({\n                text: labelText,\n                required: meta.required\n            });\n\n            // Override widget if specified in the layout element\n            const effectiveMeta = { ...meta };\n            if (element.widget) {\n                effectiveMeta.ui = { ...meta.ui, widget: element.widget };\n            }\n\n            const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);\n\n            if (effectiveMeta.ui?.fullWidth) {\n                sap.ui.require([\"sap/ui/layout/GridData\"], (GridData: any) => {\n                    control.setLayoutData(new GridData({ span: \"XL12 L12 M12 S12\" }));\n                });\n            }\n\n            form.addContent(label);\n            form.addContent(control);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, \"FormLayout\");\n            Logger.showErrorPopup(`Failed to render field '${propKey}'.\\n\\nDetails: ${msg}`);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

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