@siliconst/metaui 1.0.2 → 1.2.0

package/src/nz/co/siliconst/ui5/metaui/core/StateManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateManager.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","this","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\r\n * @file StateManager.ts\r\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\r\n */\r\n\r\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\r\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\r\n\r\n/**\r\n * Manages the isolated internal data payload for the MetaUI engine.\r\n */\r\nexport class StateManager {\r\n    private model: JSONModel;\r\n\r\n    /**\r\n     * Initializes the state manager with an optional initial payload.\r\n     * @param initialData The initial JSON payload to populate the fields.\r\n     */\r\n    constructor(initialData: Record<string, any> = {}) {\r\n        // Deep copy to ensure no reference leakage from the host application\r\n        const safeData = JSON.parse(JSON.stringify(initialData));\r\n        this.model = new JSONModel(safeData);\r\n        this.model.setDefaultBindingMode(\"TwoWay\");\r\n    }\r\n\r\n    /**\r\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\r\n     * @returns The internal JSONModel.\r\n     */\r\n    public getModel(): JSONModel {\r\n        return this.model;\r\n    }\r\n\r\n    /**\r\n     * Binds a generated UI control property to a path in the internal model.\r\n     * @param control The target UI5 Control.\r\n     * @param property The UI5 property name (e.g., 'value').\r\n     * @param bindingPath The exact path in the JSON payload.\r\n     */\r\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\r\n        control.bindProperty(property, {\r\n            path: bindingPath,\r\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Extracts the flat JavaScript object representing the current state of the UI.\r\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\r\n     */\r\n    public extractPayload(): Record<string, any> {\r\n        // Create a deep copy to prevent accidental mutations by the host\r\n        const data = this.model.getData();\r\n        return JSON.parse(JSON.stringify(data));\r\n    }\r\n}\r\n"],"mappings":"uEAWO,MAAMA,EAOTC,YAAYC,EAAmC,CAAC,GAE5C,MAAMC,EAAWC,KAAKC,MAAMD,KAAKE,UAAUJ,IAC3CK,KAAKC,MAAQ,IAAIC,EAAUN,GAC3BI,KAAKC,MAAME,sBAAsB,SACrC,CAMOC,WACH,OAAOJ,KAAKC,KAChB,CAQOI,YAAYC,EAAwBC,EAAkBC,GACzDF,EAAQG,aAAaF,EAAU,CAC3BG,KAAMF,EACNP,MAAO,QAEf,CAMOU,iBAEH,MAAMC,EAAOZ,KAAKC,MAAMY,UACxB,OAAOhB,KAAKC,MAAMD,KAAKE,UAAUa,GACrC,EACH,IAAAE,EAAA,CAAAC,WAAA,MAAAD,EAAArB,eAAA,OAAAqB,CAAA","ignoreList":[]}
+{"version":3,"file":"StateManager.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","this","model","JSONModel","setDefaultBindingMode","getModel","bindControl","control","property","bindingPath","bindProperty","path","extractPayload","data","getData","__exports","__esModule"],"sources":["StateManager.ts"],"sourcesContent":["/**\n * @file StateManager.ts\n * @description Isolated internal state management. Decouples the MetaUI engine from external host models.\n */\n\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport ManagedObject from \"sap/ui/base/ManagedObject\";\n\n/**\n * Manages the isolated internal data payload for the MetaUI engine.\n */\nexport class StateManager {\n    private model: JSONModel;\n\n    /**\n     * Initializes the state manager with an optional initial payload.\n     * @param initialData The initial JSON payload to populate the fields.\n     */\n    constructor(initialData: Record<string, any> = {}) {\n        // Deep copy to ensure no reference leakage from the host application\n        const safeData = JSON.parse(JSON.stringify(initialData));\n        this.model = new JSONModel(safeData);\n        this.model.setDefaultBindingMode(\"TwoWay\");\n    }\n\n    /**\n     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.\n     * @returns The internal JSONModel.\n     */\n    public getModel(): JSONModel {\n        return this.model;\n    }\n\n    /**\n     * Binds a generated UI control property to a path in the internal model.\n     * @param control The target UI5 Control.\n     * @param property The UI5 property name (e.g., 'value').\n     * @param bindingPath The exact path in the JSON payload.\n     */\n    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {\n        control.bindProperty(property, {\n            path: bindingPath,\n            model: \"meta\" // Assumes the model is bound to the root container with the name 'meta'\n        });\n    }\n\n    /**\n     * Extracts the flat JavaScript object representing the current state of the UI.\n     * @returns A serialized record of the data payload, free of UI5 wrappers.\n     */\n    public extractPayload(): Record<string, any> {\n        // Create a deep copy to prevent accidental mutations by the host\n        const data = this.model.getData();\n        return JSON.parse(JSON.stringify(data));\n    }\n}\n"],"mappings":"uEAWO,MAAMA,EAOTC,YAAYC,EAAmC,CAAC,GAE5C,MAAMC,EAAWC,KAAKC,MAAMD,KAAKE,UAAUJ,IAC3CK,KAAKC,MAAQ,IAAIC,EAAUN,GAC3BI,KAAKC,MAAME,sBAAsB,SACrC,CAMOC,WACH,OAAOJ,KAAKC,KAChB,CAQOI,YAAYC,EAAwBC,EAAkBC,GACzDF,EAAQG,aAAaF,EAAU,CAC3BG,KAAMF,EACNP,MAAO,QAEf,CAMOU,iBAEH,MAAMC,EAAOZ,KAAKC,MAAMY,UACxB,OAAOhB,KAAKC,MAAMD,KAAKE,UAAUa,GACrC,EACH,IAAAE,EAAA,CAAAC,WAAA,MAAAD,EAAArB,eAAA,OAAAqB,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/StateManager.ts

@@ -1,56 +1,56 @@
-/**
- * @file StateManager.ts
- * @description Isolated internal state management. Decouples the MetaUI engine from external host models.
- */
-
-import JSONModel from "sap/ui/model/json/JSONModel";
-import ManagedObject from "sap/ui/base/ManagedObject";
-
-/**
- * Manages the isolated internal data payload for the MetaUI engine.
- */
-export class StateManager {
-    private model: JSONModel;
-
-    /**
-     * Initializes the state manager with an optional initial payload.
-     * @param initialData The initial JSON payload to populate the fields.
-     */
-    constructor(initialData: Record<string, any> = {}) {
-        // Deep copy to ensure no reference leakage from the host application
-        const safeData = JSON.parse(JSON.stringify(initialData));
-        this.model = new JSONModel(safeData);
-        this.model.setDefaultBindingMode("TwoWay");
-    }
-
-    /**
-     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
-     * @returns The internal JSONModel.
-     */
-    public getModel(): JSONModel {
-        return this.model;
-    }
-
-    /**
-     * Binds a generated UI control property to a path in the internal model.
-     * @param control The target UI5 Control.
-     * @param property The UI5 property name (e.g., 'value').
-     * @param bindingPath The exact path in the JSON payload.
-     */
-    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {
-        control.bindProperty(property, {
-            path: bindingPath,
-            model: "meta" // Assumes the model is bound to the root container with the name 'meta'
-        });
-    }
-
-    /**
-     * Extracts the flat JavaScript object representing the current state of the UI.
-     * @returns A serialized record of the data payload, free of UI5 wrappers.
-     */
-    public extractPayload(): Record<string, any> {
-        // Create a deep copy to prevent accidental mutations by the host
-        const data = this.model.getData();
-        return JSON.parse(JSON.stringify(data));
-    }
-}
+/**
+ * @file StateManager.ts
+ * @description Isolated internal state management. Decouples the MetaUI engine from external host models.
+ */
+
+import JSONModel from "sap/ui/model/json/JSONModel";
+import ManagedObject from "sap/ui/base/ManagedObject";
+
+/**
+ * Manages the isolated internal data payload for the MetaUI engine.
+ */
+export class StateManager {
+    private model: JSONModel;
+
+    /**
+     * Initializes the state manager with an optional initial payload.
+     * @param initialData The initial JSON payload to populate the fields.
+     */
+    constructor(initialData: Record<string, any> = {}) {
+        // Deep copy to ensure no reference leakage from the host application
+        const safeData = JSON.parse(JSON.stringify(initialData));
+        this.model = new JSONModel(safeData);
+        this.model.setDefaultBindingMode("TwoWay");
+    }
+
+    /**
+     * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
+     * @returns The internal JSONModel.
+     */
+    public getModel(): JSONModel {
+        return this.model;
+    }
+
+    /**
+     * Binds a generated UI control property to a path in the internal model.
+     * @param control The target UI5 Control.
+     * @param property The UI5 property name (e.g., 'value').
+     * @param bindingPath The exact path in the JSON payload.
+     */
+    public bindControl(control: ManagedObject, property: string, bindingPath: string): void {
+        control.bindProperty(property, {
+            path: bindingPath,
+            model: "meta" // Assumes the model is bound to the root container with the name 'meta'
+        });
+    }
+
+    /**
+     * Extracts the flat JavaScript object representing the current state of the UI.
+     * @returns A serialized record of the data payload, free of UI5 wrappers.
+     */
+    public extractPayload(): Record<string, any> {
+        // Create a deep copy to prevent accidental mutations by the host
+        const data = this.model.getData();
+        return JSON.parse(JSON.stringify(data));
+    }
+}

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

@@ -1,2 +1,2 @@
-
+
 //# sourceMappingURL=IEventBus-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"IEventBus-dbg.js","names":[],"sources":["IEventBus.ts"],"sourcesContent":["/**\r\n * @file IEventBus.ts\r\n * @description Pub/Sub interface for localized cross-field communication and state logic.\r\n */\r\n\r\n/**\r\n * Describes a state change payload fired by a plugin.\r\n */\r\nexport interface IFieldChangeEvent {\r\n    fieldName: string;\r\n    newValue: any;\r\n}\r\n\r\n/**\r\n * Contract for the internal event orchestrator to manage conditional UI logic.\r\n */\r\nexport interface IEventBus {\r\n    /**\r\n     * Publishes a value change event to the internal channel.\r\n     * @param event The structured event detailing which field changed and its new value.\r\n     */\r\n    publishFieldChange(event: IFieldChangeEvent): void;\r\n\r\n    /**\r\n     * Subscribes a listener to react to field value changes.\r\n     * @param listener The callback function to execute when a change occurs.\r\n     */\r\n    subscribe(listener: (event: IFieldChangeEvent) => void): void;\r\n}\r\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"IEventBus-dbg.js","names":[],"sources":["IEventBus.ts"],"sourcesContent":["/**\n * @file IEventBus.ts\n * @description Pub/Sub interface for localized cross-field communication and state logic.\n */\n\n/**\n * Describes a state change payload fired by a plugin.\n */\nexport interface IFieldChangeEvent {\n    fieldName: string;\n    newValue: any;\n}\n\n/**\n * Contract for the internal event orchestrator to manage conditional UI logic.\n */\nexport interface IEventBus {\n    /**\n     * Publishes a value change event to the internal channel.\n     * @param event The structured event detailing which field changed and its new value.\n     */\n    publishFieldChange(event: IFieldChangeEvent): void;\n\n    /**\n     * Subscribes a listener to react to field value changes.\n     * @param listener The callback function to execute when a change occurs.\n     */\n    subscribe(listener: (event: IFieldChangeEvent) => void): void;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"IEventBus.d.ts","sourceRoot":"..\\..\\..\\..\\..\\..\\..\\..","sources":["src\\nz\\co\\siliconst\\ui5\\metaui\\interfaces\\IEventBus.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;OAGG;IAEH;;OAEG;IACH,UAAiB,iBAAiB;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,GAAG,CAAC;KACjB;IAED;;OAEG;IACH,UAAiB,SAAS;QACtB;;;WAGG;QACH,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEnD;;;WAGG;QACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;KACjE;CAEA"}
+{"version":3,"file":"IEventBus.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IEventBus.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;OAGG;IAEH;;OAEG;IACH,UAAiB,iBAAiB;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,GAAG,CAAC;KACjB;IAED;;OAEG;IACH,UAAiB,SAAS;QACtB;;;WAGG;QACH,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEnD;;;WAGG;QACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAAC;KACjE;CAEA"}

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

@@ -1,29 +1,29 @@
-/**
- * @file IEventBus.ts
- * @description Pub/Sub interface for localized cross-field communication and state logic.
- */
-
-/**
- * Describes a state change payload fired by a plugin.
- */
-export interface IFieldChangeEvent {
-    fieldName: string;
-    newValue: any;
-}
-
-/**
- * Contract for the internal event orchestrator to manage conditional UI logic.
- */
-export interface IEventBus {
-    /**
-     * Publishes a value change event to the internal channel.
-     * @param event The structured event detailing which field changed and its new value.
-     */
-    publishFieldChange(event: IFieldChangeEvent): void;
-
-    /**
-     * Subscribes a listener to react to field value changes.
-     * @param listener The callback function to execute when a change occurs.
-     */
-    subscribe(listener: (event: IFieldChangeEvent) => void): void;
-}
+/**
+ * @file IEventBus.ts
+ * @description Pub/Sub interface for localized cross-field communication and state logic.
+ */
+
+/**
+ * Describes a state change payload fired by a plugin.
+ */
+export interface IFieldChangeEvent {
+    fieldName: string;
+    newValue: any;
+}
+
+/**
+ * Contract for the internal event orchestrator to manage conditional UI logic.
+ */
+export interface IEventBus {
+    /**
+     * Publishes a value change event to the internal channel.
+     * @param event The structured event detailing which field changed and its new value.
+     */
+    publishFieldChange(event: IFieldChangeEvent): void;
+
+    /**
+     * Subscribes a listener to react to field value changes.
+     * @param listener The callback function to execute when a change occurs.
+     */
+    subscribe(listener: (event: IFieldChangeEvent) => void): void;
+}

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

@@ -1,2 +1,2 @@
-
+
 //# sourceMappingURL=ILayoutManager-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ILayoutManager-dbg.js","names":[],"sources":["ILayoutManager.ts"],"sourcesContent":["/**\r\n * @file ILayoutManager.ts\r\n * @description Factory contract for generating UI5 layout containers (Forms/Tables).\r\n */\r\n\r\nimport Control from \"sap/ui/core/Control\";\r\nimport { ISchema, ITableMetadata } from \"./ISchema\";\r\n\r\n/**\r\n * The factory interface responsible for structuring the visual grid.\r\n */\r\nexport interface ILayoutManager {\r\n    /**\r\n     * Constructs a responsive form layout container utilizing native UI5 grids.\r\n     * @param schema The master schema containing rootFields to be mounted.\r\n     * @returns A populated UI5 container (e.g., sap.ui.layout.form.SimpleForm).\r\n     */\r\n    renderForm(schema: ISchema): Control;\r\n\r\n    /**\r\n     * Constructs an analytical or responsive table layout.\r\n     * @param tableMeta The metadata defining the table columns.\r\n     * @returns A UI5 Table control (e.g., sap.m.Table or sap.ui.table.Table).\r\n     */\r\n    renderTable(tableMeta: ITableMetadata): Control;\r\n}\r\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ILayoutManager-dbg.js","names":[],"sources":["ILayoutManager.ts"],"sourcesContent":["/**\n * @file ILayoutManager.ts\n * @description Factory contract for generating UI5 layout containers (Forms/Tables).\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nimport { IPlugin } from \"./IPlugin\";\n\nexport interface ILayoutManager {\n    /**\n     * Renders a form-style layout for the root fields defined in the schema.\n     */\n    renderForm(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;\n\n    /**\n     * Renders a tabular layout for the provided array metadata.\n     */\n    renderTable(tableMeta: IPropertyMetadata, modelName?: string, tableTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -4,23 +4,17 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager" {
      * @description Factory contract for generating UI5 layout containers (Forms/Tables).
      */
     import Control from "sap/ui/core/Control";
-    import { ISchema, ITableMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    /**
-     * The factory interface responsible for structuring the visual grid.
-     */
+    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import { IPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/IPlugin";
     export interface ILayoutManager {
         /**
-         * Constructs a responsive form layout container utilizing native UI5 grids.
-         * @param schema The master schema containing rootFields to be mounted.
-         * @returns A populated UI5 container (e.g., sap.ui.layout.form.SimpleForm).
+         * Renders a form-style layout for the root fields defined in the schema.
          */
-        renderForm(schema: ISchema): Control;
+        renderForm(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
         /**
-         * Constructs an analytical or responsive table layout.
-         * @param tableMeta The metadata defining the table columns.
-         * @returns A UI5 Table control (e.g., sap.m.Table or sap.ui.table.Table).
+         * Renders a tabular layout for the provided array metadata.
          */
-        renderTable(tableMeta: ITableMetadata): Control;
+        renderTable(tableMeta: IPropertyMetadata, modelName?: string, tableTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
     }
 }
 //# sourceMappingURL=ILayoutManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ILayoutManager.d.ts","sourceRoot":"..\\..\\..\\..\\..\\..\\..\\..","sources":["src\\nz\\co\\siliconst\\ui5\\metaui\\interfaces\\ILayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sDAAsD,CAAC;IACtE;;;OAGG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;IAExF;;OAEG;IACH,UAAiB,cAAc;QAC3B;;;;WAIG;QACH,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAErC;;;;WAIG;QACH,WAAW,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC;KACnD;CAEA"}
+{"version":3,"file":"ILayoutManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,sDAAsD,CAAC;IACtE;;;OAGG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;IAExE,UAAiB,cAAc;QAC3B;;WAEG;QACH,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;QAEpJ;;WAEG;QACH,WAAW,CAAC,SAAS,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;KACxI;CAEA"}

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

@@ -1,26 +1,21 @@
-/**
- * @file ILayoutManager.ts
- * @description Factory contract for generating UI5 layout containers (Forms/Tables).
- */
-
-import Control from "sap/ui/core/Control";
-import { ISchema, ITableMetadata } from "./ISchema";
-
-/**
- * The factory interface responsible for structuring the visual grid.
- */
-export interface ILayoutManager {
-    /**
-     * Constructs a responsive form layout container utilizing native UI5 grids.
-     * @param schema The master schema containing rootFields to be mounted.
-     * @returns A populated UI5 container (e.g., sap.ui.layout.form.SimpleForm).
-     */
-    renderForm(schema: ISchema): Control;
-
-    /**
-     * Constructs an analytical or responsive table layout.
-     * @param tableMeta The metadata defining the table columns.
-     * @returns A UI5 Table control (e.g., sap.m.Table or sap.ui.table.Table).
-     */
-    renderTable(tableMeta: ITableMetadata): Control;
-}
+/**
+ * @file ILayoutManager.ts
+ * @description Factory contract for generating UI5 layout containers (Forms/Tables).
+ */
+
+import Control from "sap/ui/core/Control";
+import { IPropertyMetadata } from "./ISchema";
+
+import { IPlugin } from "./IPlugin";
+
+export interface ILayoutManager {
+    /**
+     * Renders a form-style layout for the root fields defined in the schema.
+     */
+    renderForm(properties: Record<string, IPropertyMetadata>, modelName?: string, formTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
+
+    /**
+     * Renders a tabular layout for the provided array metadata.
+     */
+    renderTable(tableMeta: IPropertyMetadata, modelName?: string, tableTitle?: string, trackPlugin?: (plugin: IPlugin) => void): Control;
+}

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

@@ -1,2 +1,2 @@
-
+
 //# sourceMappingURL=IPlugin-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"IPlugin-dbg.js","names":[],"sources":["IPlugin.ts"],"sourcesContent":["/**\r\n * @file IPlugin.ts\r\n * @description Contract for all discrete UI control generation plugins.\r\n * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.\r\n */\r\n\r\nimport Control from \"sap/ui/core/Control\";\r\nimport { IFieldMetadata } from \"./ISchema\";\r\n\r\n/**\r\n * Defines the contract that every MetaUI plugin must fulfill.\r\n */\r\nexport interface IPlugin {\r\n    /**\r\n     * Instantiates and binds the appropriate UI5 control based on the field metadata.\r\n     * @param fieldMetadata The immutable schema configuration for this specific field.\r\n     * @param bindingPath The exact model path where this field's data is stored.\r\n     * @returns The fully constructed and bound UI5 Control ready for layout insertion.\r\n     */\r\n    render(fieldMetadata: IFieldMetadata, bindingPath: string): Control;\r\n\r\n    /**\r\n     * Evaluates the current state of the UI5 control against the required schema rules.\r\n     * @returns True if the input is valid, false otherwise. Must set ValueState natively.\r\n     */\r\n    validate(): boolean;\r\n\r\n    /**\r\n     * Hook triggered when a cross-field dependency requires this field to re-evaluate its state.\r\n     * @param newMetadata The dynamically updated schema rules for this field.\r\n     */\r\n    onStateChange(newMetadata: IFieldMetadata): void;\r\n}\r\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"IPlugin-dbg.js","names":[],"sources":["IPlugin.ts"],"sourcesContent":["/**\n * @file IPlugin.ts\n * @description Contract for all discrete UI control generation plugins.\n * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.\n */\n\nimport Control from \"sap/ui/core/Control\";\nimport { IPropertyMetadata } from \"./ISchema\";\n\nexport interface IPlugin {\n    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;\n    validate(): boolean;\n    onStateChange(newMetadata: IPropertyMetadata): void;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -5,28 +5,11 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/IPlugin" {
      * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.
      */
     import Control from "sap/ui/core/Control";
-    import { IFieldMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
-    /**
-     * Defines the contract that every MetaUI plugin must fulfill.
-     */
+    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
     export interface IPlugin {
-        /**
-         * Instantiates and binds the appropriate UI5 control based on the field metadata.
-         * @param fieldMetadata The immutable schema configuration for this specific field.
-         * @param bindingPath The exact model path where this field's data is stored.
-         * @returns The fully constructed and bound UI5 Control ready for layout insertion.
-         */
-        render(fieldMetadata: IFieldMetadata, bindingPath: string): Control;
-        /**
-         * Evaluates the current state of the UI5 control against the required schema rules.
-         * @returns True if the input is valid, false otherwise. Must set ValueState natively.
-         */
+        render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
         validate(): boolean;
-        /**
-         * Hook triggered when a cross-field dependency requires this field to re-evaluate its state.
-         * @param newMetadata The dynamically updated schema rules for this field.
-         */
-        onStateChange(newMetadata: IFieldMetadata): void;
+        onStateChange(newMetadata: IPropertyMetadata): void;
     }
 }
 //# sourceMappingURL=IPlugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IPlugin.d.ts","sourceRoot":"..\\..\\..\\..\\..\\..\\..\\..","sources":["src\\nz\\co\\siliconst\\ui5\\metaui\\interfaces\\IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;OAIG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;IAE/E;;OAEG;IACH,UAAiB,OAAO;QACpB;;;;;WAKG;QACH,MAAM,CAAC,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAEpE;;;WAGG;QACH,QAAQ,IAAI,OAAO,CAAC;QAEpB;;;WAGG;QACH,aAAa,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI,CAAC;KACpD;CAEA"}
+{"version":3,"file":"IPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,+CAA+C,CAAC;IAC/D;;;;OAIG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAElF,UAAiB,OAAO;QACpB,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3F,QAAQ,IAAI,OAAO,CAAC;QACpB,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;KACvD;CAEA"}

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

@@ -1,33 +1,14 @@
-/**
- * @file IPlugin.ts
- * @description Contract for all discrete UI control generation plugins.
- * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.
- */
-
-import Control from "sap/ui/core/Control";
-import { IFieldMetadata } from "./ISchema";
-
-/**
- * Defines the contract that every MetaUI plugin must fulfill.
- */
-export interface IPlugin {
-    /**
-     * Instantiates and binds the appropriate UI5 control based on the field metadata.
-     * @param fieldMetadata The immutable schema configuration for this specific field.
-     * @param bindingPath The exact model path where this field's data is stored.
-     * @returns The fully constructed and bound UI5 Control ready for layout insertion.
-     */
-    render(fieldMetadata: IFieldMetadata, bindingPath: string): Control;
-
-    /**
-     * Evaluates the current state of the UI5 control against the required schema rules.
-     * @returns True if the input is valid, false otherwise. Must set ValueState natively.
-     */
-    validate(): boolean;
-
-    /**
-     * Hook triggered when a cross-field dependency requires this field to re-evaluate its state.
-     * @param newMetadata The dynamically updated schema rules for this field.
-     */
-    onStateChange(newMetadata: IFieldMetadata): void;
-}
+/**
+ * @file IPlugin.ts
+ * @description Contract for all discrete UI control generation plugins.
+ * Enforces a strict lifecycle for rendering, validation, and dynamic state updates.
+ */
+
+import Control from "sap/ui/core/Control";
+import { IPropertyMetadata } from "./ISchema";
+
+export interface IPlugin {
+    render(fieldMetadata: IPropertyMetadata, bindingPath: string, modelName?: string): Control;
+    validate(): boolean;
+    onStateChange(newMetadata: IPropertyMetadata): void;
+}

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

@@ -1,2 +1,2 @@
-
+
 //# sourceMappingURL=ISchema-dbg.js.map

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":["/**\r\n * @file ISchema.ts\r\n * @description Defines the core structural contract for the MetaUI engine.\r\n * The schema maps perfectly to the JSON payload generated by the ABAP RTTI extractor.\r\n */\r\n\r\n/**\r\n * Supported data primitive types that drive plugin selection.\r\n */\r\nexport type FieldType = \"string\" | \"number\" | \"boolean\" | \"date\" | \"dropdown\";\r\n\r\n/**\r\n * Value help structure mapping SAP Key/Text pairs.\r\n */\r\nexport interface IValueHelp {\r\n    /** The technical key passed back to the backend. */\r\n    key: string;\r\n    /** The localized descriptive text displayed to the user. */\r\n    text: string;\r\n}\r\n\r\n/**\r\n * Metadata definition for a single atomic input field.\r\n */\r\nexport interface IFieldMetadata {\r\n    /** The technical field name mapping to the data model property. */\r\n    fieldName: string;\r\n    /** The primitive type determining the rendering plugin. */\r\n    type: FieldType;\r\n    /** The localized label text for the UI. */\r\n    label: string;\r\n    /** Indicates if the field is a primary key (often rendered first or highlighted). */\r\n    isKey: boolean;\r\n    /** If true, the field is rendered as a non-editable display element. */\r\n    isReadOnly: boolean;\r\n    /** If true, triggers UI5 validation to ensure a value exists. */\r\n    isRequired: boolean;\r\n    /** Maximum allowed character length for string-based inputs. */\r\n    maxLength?: number;\r\n    /** The total number of significant digits for numeric inputs. */\r\n    precision?: number;\r\n    /** The number of decimal places for numeric inputs. */\r\n    scale?: number;\r\n    /** Pre-loaded static value help arrays for dropdowns. */\r\n    valueHelp?: IValueHelp[];\r\n}\r\n\r\n/**\r\n * Metadata definition for a tabular structure.\r\n */\r\nexport interface ITableMetadata {\r\n    /** The internal ID/name of the table. */\r\n    tableName: string;\r\n    /** The localized table header label. */\r\n    label: string;\r\n    /** Array of field definitions dictating the table's columns. */\r\n    fields: IFieldMetadata[];\r\n}\r\n\r\n/**\r\n * The master schema contract ingested by the Engine to build the UI5 layout.\r\n */\r\nexport interface ISchema {\r\n    /** Determines the root container layout strategy. */\r\n    mode: \"form\" | \"table\" | \"mixed\";\r\n    /** The fields to be rendered at the root level (typically form inputs). */\r\n    rootFields: IFieldMetadata[];\r\n    /** The table structures to be rendered sequentially. */\r\n    tables: ITableMetadata[];\r\n}\r\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\" | \"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":[]}

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

@@ -1,68 +1,58 @@
 declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
     /**
      * @file ISchema.ts
-     * @description Defines the core structural contract for the MetaUI engine.
-     * The schema maps perfectly to the JSON payload generated by the ABAP RTTI extractor.
+     * @description MetaUI v2 Core Schema Contract.
+     * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,
+     * with a proprietary 'ui' directive block for Fiori visual orchestration.
      */
-    /**
-     * Supported data primitive types that drive plugin selection.
-     */
-    export type FieldType = "string" | "number" | "boolean" | "date" | "dropdown";
+    export type FieldType = "string" | "number" | "boolean" | "date" | "dropdown" | "time" | "datetime" | "array" | "object";
     /**
      * Value help structure mapping SAP Key/Text pairs.
      */
     export interface IValueHelp {
-        /** The technical key passed back to the backend. */
         key: string;
-        /** The localized descriptive text displayed to the user. */
         text: string;
     }
     /**
-     * Metadata definition for a single atomic input field.
+     * Visual orchestration directives to separate layout from data modeling.
+     */
+    export interface IUIDirective {
+        label?: string;
+        isKey?: boolean;
+        readOnly?: boolean;
+        widget?: string;
+        group?: string;
+        visibleOn?: string;
+        enabledOn?: string;
+        format?: string;
+        rows?: number;
+        fullWidth?: boolean;
+    }
+    /**
+     * Standard JSON-Schema property definition.
      */
-    export interface IFieldMetadata {
-        /** The technical field name mapping to the data model property. */
-        fieldName: string;
-        /** The primitive type determining the rendering plugin. */
+    export interface IPropertyMetadata {
         type: FieldType;
-        /** The localized label text for the UI. */
-        label: string;
-        /** Indicates if the field is a primary key (often rendered first or highlighted). */
-        isKey: boolean;
-        /** If true, the field is rendered as a non-editable display element. */
-        isReadOnly: boolean;
-        /** If true, triggers UI5 validation to ensure a value exists. */
-        isRequired: boolean;
-        /** Maximum allowed character length for string-based inputs. */
+        ui?: IUIDirective;
+        required?: boolean;
         maxLength?: number;
-        /** The total number of significant digits for numeric inputs. */
+        minimum?: number;
+        maximum?: number;
+        pattern?: string;
         precision?: number;
-        /** The number of decimal places for numeric inputs. */
         scale?: number;
-        /** Pre-loaded static value help arrays for dropdowns. */
         valueHelp?: IValueHelp[];
+        properties?: Record<string, IPropertyMetadata>;
+        items?: IPropertyMetadata;
     }
     /**
-     * Metadata definition for a tabular structure.
-     */
-    export interface ITableMetadata {
-        /** The internal ID/name of the table. */
-        tableName: string;
-        /** The localized table header label. */
-        label: string;
-        /** Array of field definitions dictating the table's columns. */
-        fields: IFieldMetadata[];
-    }
-    /**
-     * The master schema contract ingested by the Engine to build the UI5 layout.
+     * The master schema contract ingested by the Engine.
      */
     export interface ISchema {
-        /** Determines the root container layout strategy. */
-        mode: "form" | "table" | "mixed";
-        /** The fields to be rendered at the root level (typically form inputs). */
-        rootFields: IFieldMetadata[];
-        /** The table structures to be rendered sequentially. */
-        tables: ITableMetadata[];
+        title?: string;
+        type?: "object" | "array";
+        properties?: Record<string, IPropertyMetadata>;
+        items?: IPropertyMetadata;
     }
 }
 //# 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;;;;OAIG;IAEH;;OAEG;IACH,KAAY,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAE9E;;OAEG;IACH,UAAiB,UAAU;QACvB,oDAAoD;QACpD,GAAG,EAAE,MAAM,CAAC;QACZ,4DAA4D;QAC5D,IAAI,EAAE,MAAM,CAAC;KAChB;IAED;;OAEG;IACH,UAAiB,cAAc;QAC3B,mEAAmE;QACnE,SAAS,EAAE,MAAM,CAAC;QAClB,2DAA2D;QAC3D,IAAI,EAAE,SAAS,CAAC;QAChB,2CAA2C;QAC3C,KAAK,EAAE,MAAM,CAAC;QACd,qFAAqF;QACrF,KAAK,EAAE,OAAO,CAAC;QACf,wEAAwE;QACxE,UAAU,EAAE,OAAO,CAAC;QACpB,iEAAiE;QACjE,UAAU,EAAE,OAAO,CAAC;QACpB,gEAAgE;QAChE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iEAAiE;QACjE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,yDAAyD;QACzD,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;KAC5B;IAED;;OAEG;IACH,UAAiB,cAAc;QAC3B,yCAAyC;QACzC,SAAS,EAAE,MAAM,CAAC;QAClB,wCAAwC;QACxC,KAAK,EAAE,MAAM,CAAC;QACd,gEAAgE;QAChE,MAAM,EAAE,cAAc,EAAE,CAAC;KAC5B;IAED;;OAEG;IACH,UAAiB,OAAO;QACpB,qDAAqD;QACrD,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;QACjC,2EAA2E;QAC3E,UAAU,EAAE,cAAc,EAAE,CAAC;QAC7B,wDAAwD;QACxD,MAAM,EAAE,cAAc,EAAE,CAAC;KAC5B;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,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"}