@siliconst/metaui 1.2.0 → 1.4.5

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

@@ -7,8 +7,49 @@
 import Control from "sap/ui/core/Control";
 import { IPropertyMetadata } from "./ISchema";
 
+export interface IPluginValidationResult {
+    isValid: boolean;
+    errorMessage?: string;
+    fieldKey?: string;
+}
+
 export interface IPlugin {
-    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
-    validate(): boolean;
+    /**
+     * Instantiates the raw UI5 control and binds it to the specified data model.
+     * 
+     * @param fieldMetadata The JSON Schema defining the field's constraints and UI hints.
+     * @param bindingPath The specific JSON path representing the field within the payload.
+     * @param modelName The UI5 JSONModel alias used for data binding (defaults to 'meta').
+     * @param engineScopeId The deterministic scope ID provided by the Engine.
+     * @param onChange The callback fired natively when a field value blur/change occurs.
+     * @returns {Control} The generated UI5 control ready to be mounted.
+     */
+    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control;
+
+    /**
+     * Triggers the internal validation pipeline for this specific plugin instance.
+     * 
+     * @returns {IPluginValidationResult} The structural validity state and error messages.
+     */
+    validate(): IPluginValidationResult;
+
+    /**
+     * Executes when the ConditionEngine pushes dynamic metadata mutations to the field.
+     * 
+     * @param newMetadata The mutated schema metadata.
+     */
     onStateChange(newMetadata: IPropertyMetadata): void;
+
+    /**
+     * Optional lifecycle hook executed when the parent layout is destroyed.
+     * Plugins must use this to destroy isolated JSONModels, custom EventBus listeners, 
+     * or embedded Dialogs to prevent memory leaks in the SAP Fiori Launchpad.
+     */
+    destroy?(): void;
+
+    /**
+     * Injects the global display mode context into the plugin before rendering.
+     * @param mode True if the plugin should render in a read-only display mode.
+     */
+    setDisplayMode?(mode: boolean): void;
 }

package/src/nz/co/siliconst/ui5/metaui/interfaces/ISchema-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ISchema-dbg.js","names":[],"sources":["ISchema.ts"],"sourcesContent":["/**\n * @file ISchema.ts\n * @description MetaUI v2 Core Schema Contract.\n * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,\n * with a proprietary 'ui' directive block for Fiori visual orchestration.\n */\n\nexport type FieldType = \"string\" | \"number\" | \"boolean\" | \"date\" | \"dropdown\" | \"time\" | \"datetime\" | \"array\" | \"object\";\n\n/**\n * Value help structure mapping SAP Key/Text pairs.\n */\nexport interface IValueHelp {\n    key: string;\n    text: string;\n}\n\n/**\n * Visual orchestration directives to separate layout from data modeling.\n */\nexport interface IUIDirective {\n    label?: string;\n    isKey?: boolean;\n    readOnly?: boolean;\n    widget?: string;\n    group?: string;\n    visibleOn?: string;\n    enabledOn?: string;\n    format?: string;\n    rows?: number;\n    fullWidth?: boolean;\n}\n\n/**\n * Standard JSON-Schema property definition.\n */\nexport interface IPropertyMetadata {\n    type: FieldType;\n    \n    // MetaUI specific orchestration\n    ui?: IUIDirective;\n    \n    // Standard validations\n    required?: boolean;\n    maxLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    \n    // Numeric specifics\n    precision?: number;\n    scale?: number;\n    \n    // Value constraints\n    valueHelp?: IValueHelp[];\n    \n    // Nested recursion for objects and arrays\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n}\n\n/**\n * The master schema contract ingested by the Engine.\n */\nexport interface ISchema {\n    title?: string;\n    type?: \"object\" | \"array\"; // Implicit layout hinting\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ISchema-dbg.js","names":[],"sources":["ISchema.ts"],"sourcesContent":["/**\n * @file ISchema.ts\n * @description MetaUI v2 Core Schema Contract.\n * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,\n * with a proprietary 'ui' directive block for Fiori visual orchestration.\n */\n\nexport type FieldType = \"string\" | \"number\" | \"integer\" | \"boolean\" | \"date\" | \"array\" | \"object\";\n\n/**\n * Value help structure mapping SAP Key/Text pairs.\n */\nexport interface IValueHelp {\n    key: string;\n    text: string;\n}\n\nexport interface IValidationRule {\n    name: string;\n    args?: unknown;\n}\n\n/**\n * An element in the visual layout tree.\n */\nexport interface ILayoutElement {\n    type: \"Group\" | \"Control\" | \"HorizontalLayout\" | \"VerticalLayout\" | \"WizardStep\";\n    label?: string;\n    scope?: string; // JSON Pointer to property, e.g. \"#/properties/FirstName\"\n    elements?: ILayoutElement[];\n    widget?: string; // Optional override for the widget\n}\n\n/**\n * Visual orchestration directives to separate layout from data modeling.\n */\nexport interface IUIDirective {\n    label?: string;\n    isKey?: boolean;\n    readOnly?: boolean;\n    widget?: string;\n    visibleOn?: string;\n    enabledOn?: string;\n    format?: string;\n    rows?: number;\n    fullWidth?: boolean;\n    validators?: (string | IValidationRule)[];\n    formatter?: string;\n    args?: unknown;\n    dialogButtonText?: string;\n}\n\nexport interface IRemoteValueHelpConfig {\n    url: string;\n    keyPath: string;\n    textPath: string;\n}\n\n/**\n * Standard JSON-Schema property definition.\n */\nexport interface IPropertyMetadata {\n    type: FieldType;\n    \n    // MetaUI specific orchestration\n    ui?: IUIDirective;\n    \n    // Standard validations\n    required?: boolean;\n    maxLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    \n    // Numeric specifics\n    precision?: number;\n    scale?: number;\n    multipleOf?: number;\n    \n    // Value constraints\n    valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;\n    enum?: string[] | number[];\n    \n    // Nested recursion for objects and arrays\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n}\n\n/**\n * The master schema contract ingested by the Engine.\n */\nexport interface ISchema {\n    title?: string;\n    layoutStrategy?: string;\n    type?: \"object\" | \"array\"; // Implicit layout hinting\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -5,7 +5,7 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
      * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,
      * with a proprietary 'ui' directive block for Fiori visual orchestration.
      */
-    export type FieldType = "string" | "number" | "boolean" | "date" | "dropdown" | "time" | "datetime" | "array" | "object";
+    export type FieldType = "string" | "number" | "integer" | "boolean" | "date" | "array" | "object";
     /**
      * Value help structure mapping SAP Key/Text pairs.
      */
@@ -13,6 +13,20 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         key: string;
         text: string;
     }
+    export interface IValidationRule {
+        name: string;
+        args?: unknown;
+    }
+    /**
+     * An element in the visual layout tree.
+     */
+    export interface ILayoutElement {
+        type: "Group" | "Control" | "HorizontalLayout" | "VerticalLayout" | "WizardStep";
+        label?: string;
+        scope?: string;
+        elements?: ILayoutElement[];
+        widget?: string;
+    }
     /**
      * Visual orchestration directives to separate layout from data modeling.
      */
@@ -21,12 +35,20 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         isKey?: boolean;
         readOnly?: boolean;
         widget?: string;
-        group?: string;
         visibleOn?: string;
         enabledOn?: string;
         format?: string;
         rows?: number;
         fullWidth?: boolean;
+        validators?: (string | IValidationRule)[];
+        formatter?: string;
+        args?: unknown;
+        dialogButtonText?: string;
+    }
+    export interface IRemoteValueHelpConfig {
+        url: string;
+        keyPath: string;
+        textPath: string;
     }
     /**
      * Standard JSON-Schema property definition.
@@ -41,18 +63,25 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         pattern?: string;
         precision?: number;
         scale?: number;
-        valueHelp?: IValueHelp[];
+        multipleOf?: number;
+        valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;
+        enum?: string[] | number[];
         properties?: Record<string, IPropertyMetadata>;
         items?: IPropertyMetadata;
+        uiLayout?: ILayoutElement[];
+        additionalProperties?: boolean;
     }
     /**
      * The master schema contract ingested by the Engine.
      */
     export interface ISchema {
         title?: string;
+        layoutStrategy?: string;
         type?: "object" | "array";
         properties?: Record<string, IPropertyMetadata>;
         items?: IPropertyMetadata;
+        uiLayout?: ILayoutElement[];
+        additionalProperties?: boolean;
     }
 }
 //# sourceMappingURL=ISchema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ISchema.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;;OAKG;IAEH,KAAY,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEzH;;OAEG;IACH,UAAiB,UAAU;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KAChB;IAED;;OAEG;IACH,UAAiB,YAAY;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;KACvB;IAED;;OAEG;IACH,UAAiB,iBAAiB;QAC9B,IAAI,EAAE,SAAS,CAAC;QAGhB,EAAE,CAAC,EAAE,YAAY,CAAC;QAGlB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QAGf,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;QAGzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC/C,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC7B;IAED;;OAEG;IACH,UAAiB,OAAO;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC/C,KAAK,CAAC,EAAE,iBAAiB,CAAC;KAC7B;CAEA"}
+{"version":3,"file":"ISchema.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;;OAKG;IAEH,KAAY,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAElG;;OAEG;IACH,UAAiB,UAAU;QACvB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KAChB;IAED,UAAiB,eAAe;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB;IAED;;OAEG;IACH,UAAiB,cAAc;QAC3B,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,CAAC;QACjF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB;IAED;;OAEG;IACH,UAAiB,YAAY;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC;QAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B;IAED,UAAiB,sBAAsB;QACnC,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACpB;IAED;;OAEG;IACH,UAAiB,iBAAiB;QAC9B,IAAI,EAAE,SAAS,CAAC;QAGhB,EAAE,CAAC,EAAE,YAAY,CAAC;QAGlB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QAGpB,SAAS,CAAC,EAAE,UAAU,EAAE,GAAG,sBAAsB,CAAC;QAClD,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAG3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC/C,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAC1B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;QAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAClC;IAED;;OAEG;IACH,UAAiB,OAAO;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC/C,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAC1B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;QAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAClC;CAEA"}

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

@@ -5,7 +5,7 @@
  * with a proprietary 'ui' directive block for Fiori visual orchestration.
  */
 
-export type FieldType = "string" | "number" | "boolean" | "date" | "dropdown" | "time" | "datetime" | "array" | "object";
+export type FieldType = "string" | "number" | "integer" | "boolean" | "date" | "array" | "object";
 
 /**
  * Value help structure mapping SAP Key/Text pairs.
@@ -15,6 +15,22 @@ export interface IValueHelp {
     text: string;
 }
 
+export interface IValidationRule {
+    name: string;
+    args?: unknown;
+}
+
+/**
+ * An element in the visual layout tree.
+ */
+export interface ILayoutElement {
+    type: "Group" | "Control" | "HorizontalLayout" | "VerticalLayout" | "WizardStep";
+    label?: string;
+    scope?: string; // JSON Pointer to property, e.g. "#/properties/FirstName"
+    elements?: ILayoutElement[];
+    widget?: string; // Optional override for the widget
+}
+
 /**
  * Visual orchestration directives to separate layout from data modeling.
  */
@@ -23,12 +39,21 @@ export interface IUIDirective {
     isKey?: boolean;
     readOnly?: boolean;
     widget?: string;
-    group?: string;
     visibleOn?: string;
     enabledOn?: string;
     format?: string;
     rows?: number;
     fullWidth?: boolean;
+    validators?: (string | IValidationRule)[];
+    formatter?: string;
+    args?: unknown;
+    dialogButtonText?: string;
+}
+
+export interface IRemoteValueHelpConfig {
+    url: string;
+    keyPath: string;
+    textPath: string;
 }
 
 /**
@@ -50,13 +75,17 @@ export interface IPropertyMetadata {
     // Numeric specifics
     precision?: number;
     scale?: number;
+    multipleOf?: number;
     
     // Value constraints
-    valueHelp?: IValueHelp[];
+    valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;
+    enum?: string[] | number[];
     
     // Nested recursion for objects and arrays
     properties?: Record<string, IPropertyMetadata>;
     items?: IPropertyMetadata;
+    uiLayout?: ILayoutElement[];
+    additionalProperties?: boolean;
 }
 
 /**
@@ -64,7 +93,10 @@ export interface IPropertyMetadata {
  */
 export interface ISchema {
     title?: string;
+    layoutStrategy?: string;
     type?: "object" | "array"; // Implicit layout hinting
     properties?: Record<string, IPropertyMetadata>;
     items?: IPropertyMetadata;
+    uiLayout?: ILayoutElement[];
+    additionalProperties?: boolean;
 }

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

@@ -0,0 +1,148 @@
+sap.ui.define(["sap/m/VBox", "sap/m/Label", "../core/SchemaNormalizer", "../utils/Logger"], function (VBox, Label, ___core_SchemaNormalizer, ___utils_Logger) {
+  "use strict";
+
+  const SchemaNormalizer = ___core_SchemaNormalizer["SchemaNormalizer"];
+  const Logger = ___utils_Logger["Logger"];
+  /**
+   * 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
+   */
+  class CompactLayout {
+    /**
+     * 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.
+     */
+    render(schema, modelName, engine, onSubmit) {
+      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 = [];
+
+      // Recursively render layout elements
+      const renderElement = element => {
+        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 {
+            meta,
+            bindingPath,
+            propKey
+          } = SchemaNormalizer.resolveScope(schema, element.scope);
+          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: bindingPath,
+              meta,
+              label: element.label
+            });
+          } else {
+            Logger.debug("[MetaUI CompactLayout]", `Rendering scalar field '${bindingPath}'.`, "CompactLayout");
+            this._renderScalarField(container, element, bindingPath, 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, modelName, `/${field.scope}`);
+          if (control) {
+            control.addStyleClass("sapUiTinyMarginTop");
+            container.addItem(control);
+          }
+        } catch (error) {
+          const msg = 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;
+    }
+    _renderScalarField(container, element, propKey, meta, modelName, engine) {
+      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.message;
+        Logger.error(`[MetaUI] Failed to render field ${propKey}`, msg, "CompactLayout");
+        Logger.showErrorPopup(`Failed to render field '${propKey}'.\n\nDetails: ${msg}`);
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.CompactLayout = CompactLayout;
+  return __exports;
+});
+//# sourceMappingURL=CompactLayout-dbg.js.map

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

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

@@ -0,0 +1,27 @@
+declare module "nz/co/siliconst/ui5/metaui/layouts/CompactLayout" {
+    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";
+    /**
+     * 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.
+         */
+        render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control;
+        private _renderScalarField;
+    }
+}
+//# sourceMappingURL=CompactLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompactLayout.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/layouts/CompactLayout.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,kDAAkD,CAAC;IASlE,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,aAAc,YAAW,cAAc;QAChD;;;;;;;;WAQG;QACI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO;QAgFjG,OAAO,CAAC,kBAAkB;KA0B7B;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/m/VBox","sap/m/Label","../core/SchemaNormalizer","../utils/Logger"],function(e,t,a,r){"use strict";const o=a["SchemaNormalizer"];const i=r["Logger"];class s{render(t,a,r,s){const n=new e({renderType:"Bare"});n.addStyleClass("sapUiTinyMargin");if(!t.uiLayout||!Array.isArray(t.uiLayout)){i.warn("[MetaUI] Missing 'uiLayout' array in schema. CompactLayout will not render any fields.");return n}const l=[];const p=e=>{if(e.type==="Group"){if(e.label){const t=new sap.m.Title({text:e.label,level:"H5"});t.addStyleClass("sapUiTinyMarginTop sapUiTinyMarginBottom");n.addItem(t)}if(e.elements&&Array.isArray(e.elements)){e.elements.forEach(p)}}else if(e.type==="Control"){if(!e.scope||!e.scope.startsWith("#/properties/")){i.error(`[MetaUI] Invalid scope '${e.scope}' in uiLayout Control.`,"","CompactLayout");return}const{meta:s,bindingPath:p,propKey:c}=o.resolveScope(t,e.scope);if(!s){i.error(`[MetaUI] Property '${c}' not found in schema definitions.`,"","CompactLayout");return}const y=s.items?.type==="object"||s.items?.properties;const u=!!s.ui?.widget;const d=s.type==="array"&&y&&!u;if(d){i.debug("[MetaUI CompactLayout]",`Routing property '${c}' to Table Sub-Layout.`,"CompactLayout");l.push({scope:p,meta:s,label:e.label})}else{i.debug("[MetaUI CompactLayout]",`Rendering scalar field '${p}'.`,"CompactLayout");this._renderScalarField(n,e,p,s,a,r)}}else{i.warn(`[MetaUI] Unsupported layout element type '${e.type}'.`,"","CompactLayout")}};t.uiLayout.forEach(p);l.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 o=r.generateLayout(t,a,`/${e.scope}`);if(o){o.addStyleClass("sapUiTinyMarginTop");n.addItem(o)}}catch(t){const a=t.message;i.error(`[MetaUI] Failed to render array field ${e.scope}`,a,"CompactLayout");i.showErrorPopup(`Failed to render array field '${e.scope}'.\n\nDetails: ${a}`)}});return n}_renderScalarField(a,r,o,s,n,l){try{const i=r.label||s.ui?.label||o;const p=new t({text:i,required:s.required});p.addStyleClass("sapUiTinyMarginTop");const c={...s};if(r.widget){c.ui={...s.ui,widget:r.widget}}const y=l.generateField(c,`/${o}`,n);y.addStyleClass("sapUiTinyMarginBottom");const u=new e({renderType:"Bare",items:[p,y]});a.addItem(u)}catch(e){const t=e.message;i.error(`[MetaUI] Failed to render field ${o}`,t,"CompactLayout");i.showErrorPopup(`Failed to render field '${o}'.\n\nDetails: ${t}`)}}}var n={__esModule:true};n.CompactLayout=s;return n});
+//# sourceMappingURL=CompactLayout.js.map

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

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