@siliconst/metaui 1.0.0 → 1.2.0

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

@@ -1,31 +1,157 @@
-/**
- * @file SchemaNormalizer.ts
- * @description Transforms and validates incoming JSON payloads into the strict ISchema matrix.
- */
-
-import { ISchema } from "../interfaces/ISchema";
-
-/**
- * Utility class ensuring data fidelity before layout construction begins.
- */
-export class SchemaNormalizer {
-    
-    /**
-     * Validates that the provided raw payload conforms to the required ISchema structures.
-     * @param rawSchema The heterogeneous JSON object provided to the Engine.
-     * @returns The strictly cast ISchema matrix.
-     * @throws Error if the mandatory schema properties are missing.
-     */
-    public static normalize(rawSchema: any): ISchema {
-        if (!rawSchema || typeof rawSchema !== 'object') {
-            throw new Error("[MetaUI] Invalid Schema Payload: Payload is not an object.");
-        }
-        
-        if (!rawSchema.mode || !rawSchema.rootFields || !rawSchema.tables) {
-            throw new Error("[MetaUI] Invalid Schema Payload: Missing required structures (mode, rootFields, tables).");
-        }
-
-        // Return the strongly typed and validated schema block.
-        return rawSchema as ISchema;
-    }
-}
+/**
+ * @file SchemaNormalizer.ts
+ * @description Transforms and validates incoming JSON payloads into the strict v2 ISchema dictionary matrix.
+ */
+
+import { ISchema, IPropertyMetadata, FieldType } from "../interfaces/ISchema";
+
+export class SchemaNormalizer {
+    
+    /**
+     * Validates that the provided raw payload conforms to the required ISchema structures.
+     */
+    public static normalize(rawSchema?: any, data?: any): ISchema {
+        let schemaObj = rawSchema;
+
+        if (typeof schemaObj === "string") {
+            try {
+                schemaObj = JSON.parse(schemaObj);
+            } catch (e) {
+                console.warn("[MetaUI] Failed to parse schema string, falling back to inference.", e);
+                schemaObj = null;
+            }
+        }
+
+        if (!schemaObj || typeof schemaObj !== 'object' || Array.isArray(schemaObj)) {
+            return this.inferSchemaFromData(data);
+        }
+
+        // It is an object. Ensure it conforms to v2 structure.
+        const normalized: ISchema = {
+            title: schemaObj.title || "MetaUI Generated Form",
+            type: schemaObj.type || (schemaObj.items ? "array" : "object"),
+        };
+
+        if (normalized.type === "object") {
+            normalized.properties = this.normalizeProperties(schemaObj.properties || {});
+        } else if (normalized.type === "array") {
+            normalized.items = this.normalizePropertyMetadata(schemaObj.items || { type: "object", properties: {} }, "items");
+        }
+
+        return normalized;
+    }
+
+    private static normalizeProperties(properties: any): Record<string, IPropertyMetadata> {
+        const normalizedProps: Record<string, IPropertyMetadata> = {};
+        for (const key of Object.keys(properties)) {
+            normalizedProps[key] = this.normalizePropertyMetadata(properties[key], key);
+        }
+        return normalizedProps;
+    }
+
+    private static normalizePropertyMetadata(prop: any, keyName: string): IPropertyMetadata {
+        const normalized: IPropertyMetadata = {
+            type: prop.type || "string",
+            ui: {
+                label: prop.ui?.label || this.generateLabel(keyName),
+                isKey: !!prop.ui?.isKey,
+                readOnly: !!prop.ui?.readOnly,
+                widget: prop.ui?.widget,
+                group: prop.ui?.group,
+                visibleOn: prop.ui?.visibleOn,
+                enabledOn: prop.ui?.enabledOn,
+                format: prop.ui?.format
+            },
+            required: !!prop.required,
+            maxLength: prop.maxLength,
+            minimum: prop.minimum,
+            maximum: prop.maximum,
+            pattern: prop.pattern,
+            precision: prop.precision,
+            scale: prop.scale,
+            valueHelp: prop.valueHelp
+        };
+
+        if (normalized.type === "object" && prop.properties) {
+            normalized.properties = this.normalizeProperties(prop.properties);
+        } else if (normalized.type === "array" && prop.items) {
+            normalized.items = this.normalizePropertyMetadata(prop.items, "items");
+        }
+
+        return normalized;
+    }
+
+    /**
+     * Generates a Title Case label from camelCase or snake_case technical names.
+     */
+    private static generateLabel(name: string): string {
+        if (!name) return "";
+        let spaced = name.replace(/([A-Z])/g, " $1").replace(/_/g, " ");
+        return spaced.split(' ')
+            .filter(w => w.length > 0)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join(' ')
+            .trim();
+    }
+
+    /**
+     * Infers a v2 ISchema structure dynamically from a plain data payload.
+     */
+    private static inferSchemaFromData(data: any): ISchema {
+        const schema: ISchema = { type: "object", properties: {} };
+        
+        if (!data || typeof data !== "object") {
+            return schema;
+        }
+
+        if (Array.isArray(data)) {
+            schema.type = "array";
+            schema.items = {
+                type: "object",
+                properties: data.length > 0 ? this.inferPropertiesFromObject(data[0]) : {}
+            };
+        } else {
+            schema.type = "object";
+            schema.properties = this.inferPropertiesFromObject(data);
+        }
+
+        return schema;
+    }
+
+    private static inferPropertiesFromObject(obj: any): Record<string, IPropertyMetadata> {
+        const properties: Record<string, IPropertyMetadata> = {};
+        if (!obj || typeof obj !== "object") return properties;
+
+        for (const key of Object.keys(obj)) {
+            const val = obj[key];
+            if (val === null || val === undefined) continue;
+            
+            if (typeof val === "object" && !Array.isArray(val)) continue;
+
+            let type: FieldType = "string";
+            let items: IPropertyMetadata | undefined;
+
+            if (typeof val === "number") type = "number";
+            else if (typeof val === "boolean") type = "boolean";
+            else if (Array.isArray(val)) {
+                type = "array";
+                items = {
+                    type: "object",
+                    properties: val.length > 0 ? this.inferPropertiesFromObject(val[0]) : {}
+                };
+            }
+            
+            properties[key] = {
+                type,
+                items,
+                ui: {
+                    label: this.generateLabel(key),
+                    isKey: false,
+                    readOnly: false
+                }
+            };
+        }
+
+        return properties;
+    }
+}

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

@@ -0,0 +1,56 @@
+sap.ui.define(["sap/ui/model/json/JSONModel"], function (JSONModel) {
+  "use strict";
+
+  /**
+   * Manages the isolated internal data payload for the MetaUI engine.
+   */
+  class StateManager {
+    /**
+     * Initializes the state manager with an optional initial payload.
+     * @param initialData The initial JSON payload to populate the fields.
+     */
+    constructor(initialData = {}) {
+      // 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.
+     */
+    getModel() {
+      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.
+     */
+    bindControl(control, property, bindingPath) {
+      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.
+     */
+    extractPayload() {
+      // Create a deep copy to prevent accidental mutations by the host
+      const data = this.model.getData();
+      return JSON.parse(JSON.stringify(data));
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.StateManager = StateManager;
+  return __exports;
+});
+//# sourceMappingURL=StateManager-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateManager-dbg.js","names":["StateManager","constructor","initialData","safeData","JSON","parse","stringify","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":";;;EAQA;AACA;AACA;EACO,MAAMA,YAAY,CAAC;IAGtB;AACJ;AACA;AACA;IACIC,WAAWA,CAACC,WAAgC,GAAG,CAAC,CAAC,EAAE;MAC/C;MACA,MAAMC,QAAQ,GAAGC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACJ,WAAW,CAAC,CAAC;MACxD,IAAI,CAACK,KAAK,GAAG,IAAIC,SAAS,CAACL,QAAQ,CAAC;MACpC,IAAI,CAACI,KAAK,CAACE,qBAAqB,CAAC,QAAQ,CAAC;IAC9C;;IAEA;AACJ;AACA;AACA;IACWC,QAAQA,CAAA,EAAc;MACzB,OAAO,IAAI,CAACH,KAAK;IACrB;;IAEA;AACJ;AACA;AACA;AACA;AACA;IACWI,WAAWA,CAACC,OAAsB,EAAEC,QAAgB,EAAEC,WAAmB,EAAQ;MACpFF,OAAO,CAACG,YAAY,CAACF,QAAQ,EAAE;QAC3BG,IAAI,EAAEF,WAAW;QACjBP,KAAK,EAAE,MAAM,CAAC;MAClB,CAAC,CAAC;IACN;;IAEA;AACJ;AACA;AACA;IACWU,cAAcA,CAAA,EAAwB;MACzC;MACA,MAAMC,IAAI,GAAG,IAAI,CAACX,KAAK,CAACY,OAAO,CAAC,CAAC;MACjC,OAAOf,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,SAAS,CAACY,IAAI,CAAC,CAAC;IAC3C;EACJ;EAAC,IAAAE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAApB,YAAA,GAAAA,YAAA;EAAA,OAAAoB,SAAA;AAAA","ignoreList":[]}

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

@@ -0,0 +1,37 @@
+declare module "nz/co/siliconst/ui5/metaui/core/StateManager" {
+    /**
+     * @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;
+        /**
+         * Initializes the state manager with an optional initial payload.
+         * @param initialData The initial JSON payload to populate the fields.
+         */
+        constructor(initialData?: Record<string, any>);
+        /**
+         * Retrieves the isolated JSONModel instance to attach to the root GeneratorHost control.
+         * @returns The internal JSONModel.
+         */
+        getModel(): JSONModel;
+        /**
+         * 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.
+         */
+        bindControl(control: ManagedObject, property: string, bindingPath: string): void;
+        /**
+         * Extracts the flat JavaScript object representing the current state of the UI.
+         * @returns A serialized record of the data payload, free of UI5 wrappers.
+         */
+        extractPayload(): Record<string, any>;
+    }
+}
+//# sourceMappingURL=StateManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateManager.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/StateManager.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D;;;OAGG;IAEH,OAAO,SAAS,MAAM,6BAA6B,CAAC;IACpD,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAEtD;;OAEG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,KAAK,CAAY;QAEzB;;;WAGG;oBACS,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;QAOjD;;;WAGG;QACI,QAAQ,IAAI,SAAS;QAI5B;;;;;WAKG;QACI,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;QAOvF;;;WAGG;QACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;KAK/C;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/ui/model/json/JSONModel"],function(e){"use strict";class t{constructor(t={}){const o=JSON.parse(JSON.stringify(t));this.model=new e(o);this.model.setDefaultBindingMode("TwoWay")}getModel(){return this.model}bindControl(e,t,o){e.bindProperty(t,{path:o,model:"meta"})}extractPayload(){const e=this.model.getData();return JSON.parse(JSON.stringify(e))}}var o={__esModule:true};o.StateManager=t;return o});
+//# sourceMappingURL=StateManager.js.map

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

@@ -0,0 +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":["/**\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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,29 @@
+declare module "nz/co/siliconst/ui5/metaui/interfaces/IEventBus" {
+    /**
+     * @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;
+    }
+}
+//# sourceMappingURL=IEventBus.d.ts.map

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

@@ -0,0 +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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"IEventBus.js","names":[],"sources":[],"mappings":"","ignoreList":[]}

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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,20 @@
+declare module "nz/co/siliconst/ui5/metaui/interfaces/ILayoutManager" {
+    /**
+     * @file ILayoutManager.ts
+     * @description Factory contract for generating UI5 layout containers (Forms/Tables).
+     */
+    import Control from "sap/ui/core/Control";
+    import { IPropertyMetadata } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import { IPlugin } from "nz/co/siliconst/ui5/metaui/interfaces/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;
+    }
+}
+//# sourceMappingURL=ILayoutManager.d.ts.map

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

@@ -0,0 +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,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.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ILayoutManager.js","names":[],"sources":[],"mappings":"","ignoreList":[]}

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

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

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

@@ -0,0 +1 @@
+{"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":[]}