@siliconst/metaui 1.0.2 → 1.4.4

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

@@ -1,56 +1,158 @@
-/**
- * @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";
+import { ISchema, IPropertyMetadata } from "../interfaces/ISchema";
+import { GlobalPipeline } from "./PipelineManager";
+import Message from "sap/ui/core/message/Message";
+import coreLibrary from "sap/ui/core/library";
+import Core from "sap/ui/core/Core";
+import Messaging from "sap/ui/core/Messaging";
+
+
+/**
+ * Manages the isolated internal data payload for the MetaUI engine.
+ */
+export class StateManager {
+    private model: JSONModel;
+    private activeModelName: string;
+    private schema: ISchema;
+
+    /**
+     * Initializes the state manager with an optional initial payload.
+     * @param initialData The initial JSON payload to populate the fields.
+     * @param schema The normalized schema for live validation.
+     * @param modelName The UI5 model alias used for isolation.
+     */
+    constructor(initialData: Record<string, any> = {}, schema: ISchema, modelName: string = "meta") {
+        this.activeModelName = modelName;
+        this.schema = schema;
+        
+        // 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");
+
+        // Centralized Model-Level Validation Interceptor
+        const originalSetProperty = this.model.setProperty.bind(this.model);
+        this.model.setProperty = (sPath: string, oValue: any, oContext?: any, bAsyncUpdate?: boolean) => {
+            const result = originalSetProperty(sPath, oValue, oContext, bAsyncUpdate);
+            this.validatePath(sPath, oValue);
+            return result;
+        };
+    }
+
+    /**
+     * Validates a specific path against the schema and updates the MessageManager.
+     */
+    private validatePath(sPath: string, value: any): void {
+        const fieldKey = sPath.replace(/^\//, "");
+        const metadata = this.findMetadataForPath(fieldKey);
+        
+        const messageManager = Messaging;
+        const targetPath = sPath.startsWith("/") ? sPath : `/${sPath}`; // Pure UI5: target MUST be absolute path
+        
+        // 1. Remove existing messages (strictly for THIS model instance)
+        const existingMessages = messageManager.getMessageModel().getData();
+        const messagesToRemove = existingMessages.filter((msg: any) => {
+            const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();
+            return isMatch;
+        });
+        
+        
+        if (messagesToRemove.length > 0) {
+            messageManager.removeMessages(messagesToRemove);
+        }
+
+        if (!metadata) return;
+
+        // 2. Run GlobalPipeline
+        const validatorsToRun: string[] = [];
+        const argsMap: Record<string, any> = {};
+
+        if (metadata.required) {
+            validatorsToRun.push("required");
+        }
+        if (metadata.type === "string" && metadata.maxLength) {
+            validatorsToRun.push("maxLength");
+            argsMap["maxLength"] = { max: metadata.maxLength };
+        }
+        if (metadata.ui?.validators) {
+            for (const v of metadata.ui.validators) {
+                if (typeof v === "string") {
+                    validatorsToRun.push(v);
+                } else if (v && v.name) {
+                    validatorsToRun.push(v.name);
+                    if (v.args !== undefined) {
+                        argsMap[v.name] = v.args;
+                    }
+                }
+            }
+        }
+
+        if (validatorsToRun.length > 0) {
+            const validationResult = GlobalPipeline.executeValidation(value, validatorsToRun, argsMap);
+            if (!validationResult.isValid) {
+                const newMsg = new Message({
+                    message: validationResult.errorMessage || "Invalid value.",
+                    type: coreLibrary.MessageType.Error,
+                    target: targetPath,
+                    processor: this.model
+                });
+                messageManager.addMessages(newMsg);
+            }
+        }
+    }
+
+    private findMetadataForPath(path: string): IPropertyMetadata | undefined {
+        if (!this.schema || !this.schema.properties) return undefined;
+        // Basic single-level support for now. Nested object resolution would split by '.' or '/'
+        return this.schema.properties[path];
+    }
+
+
+
+    /**
+     * 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));
+    }
+
+    /**
+     * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
+     */
+    public destroy(): void {
+        
+        if (this.model) {
+            this.model.destroy();
+        }
+    }
+}

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 UI container based on the provided schema.\n     * @param schema The schema defining the layout content.\n     * @param modelName The UI5 JSONModel name for data binding.\n     * @param engine Reference back to the Engine for recursive internal field generation.\n     * @param onSubmit Callback to trigger form submission from the layout natively (e.g. Wizard complete)\n     * @param bindingPath Optional path to bind the layout (e.g. for nested array tables)\n     */\n    render(schema: import(\"./ISchema\").ISchema, modelName: string, engine: import(\"../core/Engine\").Engine, onSubmit?: () => void, bindingPath?: string): Control;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -4,23 +4,16 @@ 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.
-     */
     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).
+         * Renders a UI container based on the provided schema.
+         * @param schema The schema defining the layout content.
+         * @param modelName The UI5 JSONModel name for data binding.
+         * @param engine Reference back to the Engine for recursive internal field generation.
+         * @param onSubmit Callback to trigger form submission from the layout natively (e.g. Wizard complete)
+         * @param bindingPath Optional path to bind the layout (e.g. for nested array tables)
          */
-        renderTable(tableMeta: ITableMetadata): Control;
+        render(schema: import("./ISchema").ISchema, modelName: string, engine: import("nz/co/siliconst/ui5/metaui/core/Engine").Engine, onSubmit?: () => void, bindingPath?: string): 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;IAK1C,UAAiB,cAAc;QAC3B;;;;;;;WAOG;QACH,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,wCAAwC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACzL;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 UI container based on the provided schema.
+     * @param schema The schema defining the layout content.
+     * @param modelName The UI5 JSONModel name for data binding.
+     * @param engine Reference back to the Engine for recursive internal field generation.
+     * @param onSubmit Callback to trigger form submission from the layout natively (e.g. Wizard complete)
+     * @param bindingPath Optional path to bind the layout (e.g. for nested array tables)
+     */
+    render(schema: import("./ISchema").ISchema, modelName: string, engine: import("../core/Engine").Engine, onSubmit?: () => void, bindingPath?: string): Control;
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"IPipeline-dbg.js","names":[],"sources":["IPipeline.ts"],"sourcesContent":["/**\n * @file IPipeline.ts\n * @description Interfaces for the generic data manipulation pipeline (Formatters, Parsers, Validators).\n */\n\nexport interface IFormatter {\n    /**\n     * Formats raw JSON model data into a UI-friendly string.\n     * @param rawValue The raw value from the JSON payload.\n     * @param args Optional arguments provided in the schema.\n     * @returns The formatted string for the UI control.\n     */\n    format(rawValue: unknown, args?: unknown): string;\n}\n\nexport interface IParser {\n    /**\n     * Parses UI-formatted strings back into raw data types.\n     * @param uiValue The value extracted from the UI control.\n     * @param args Optional arguments provided in the schema.\n     * @returns The raw typed value for the JSON payload.\n     */\n    parse(uiValue: any, args?: unknown): any;\n}\n\nexport interface IValidationResult {\n    isValid: boolean;\n    errorMessage?: string;\n}\n\nexport interface IValidator {\n    /**\n     * Validates parsed data before it enters the JSON model.\n     * @param parsedValue The cleaned data to validate.\n     * @param args Optional arguments provided in the schema (e.g. max length number)\n     * @returns IValidationResult containing status and optional error message.\n     */\n    validate(parsedValue: unknown, args?: unknown): IValidationResult;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,38 @@
+declare module "nz/co/siliconst/ui5/metaui/interfaces/IPipeline" {
+    /**
+     * @file IPipeline.ts
+     * @description Interfaces for the generic data manipulation pipeline (Formatters, Parsers, Validators).
+     */
+    export interface IFormatter {
+        /**
+         * Formats raw JSON model data into a UI-friendly string.
+         * @param rawValue The raw value from the JSON payload.
+         * @param args Optional arguments provided in the schema.
+         * @returns The formatted string for the UI control.
+         */
+        format(rawValue: unknown, args?: unknown): string;
+    }
+    export interface IParser {
+        /**
+         * Parses UI-formatted strings back into raw data types.
+         * @param uiValue The value extracted from the UI control.
+         * @param args Optional arguments provided in the schema.
+         * @returns The raw typed value for the JSON payload.
+         */
+        parse(uiValue: any, args?: unknown): any;
+    }
+    export interface IValidationResult {
+        isValid: boolean;
+        errorMessage?: string;
+    }
+    export interface IValidator {
+        /**
+         * Validates parsed data before it enters the JSON model.
+         * @param parsedValue The cleaned data to validate.
+         * @param args Optional arguments provided in the schema (e.g. max length number)
+         * @returns IValidationResult containing status and optional error message.
+         */
+        validate(parsedValue: unknown, args?: unknown): IValidationResult;
+    }
+}
+//# sourceMappingURL=IPipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IPipeline.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iDAAiD,CAAC;IACjE;;;OAGG;IAEH,UAAiB,UAAU;QACvB;;;;;WAKG;QACH,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;KACrD;IAED,UAAiB,OAAO;QACpB;;;;;WAKG;QACH,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,GAAG,CAAC;KAC5C;IAED,UAAiB,iBAAiB;QAC9B,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB;IAED,UAAiB,UAAU;QACvB;;;;;WAKG;QACH,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC;KACrE;CAEA"}

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

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

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * @file IPipeline.ts
+ * @description Interfaces for the generic data manipulation pipeline (Formatters, Parsers, Validators).
+ */
+
+export interface IFormatter {
+    /**
+     * Formats raw JSON model data into a UI-friendly string.
+     * @param rawValue The raw value from the JSON payload.
+     * @param args Optional arguments provided in the schema.
+     * @returns The formatted string for the UI control.
+     */
+    format(rawValue: unknown, args?: unknown): string;
+}
+
+export interface IParser {
+    /**
+     * Parses UI-formatted strings back into raw data types.
+     * @param uiValue The value extracted from the UI control.
+     * @param args Optional arguments provided in the schema.
+     * @returns The raw typed value for the JSON payload.
+     */
+    parse(uiValue: any, args?: unknown): any;
+}
+
+export interface IValidationResult {
+    isValid: boolean;
+    errorMessage?: string;
+}
+
+export interface IValidator {
+    /**
+     * Validates parsed data before it enters the JSON model.
+     * @param parsedValue The cleaned data to validate.
+     * @param args Optional arguments provided in the schema (e.g. max length number)
+     * @returns IValidationResult containing status and optional error message.
+     */
+    validate(parsedValue: unknown, args?: unknown): IValidationResult;
+}

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

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

@@ -5,28 +5,47 @@ 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 IPluginValidationResult {
+        isValid: boolean;
+        errorMessage?: string;
+        fieldKey?: string;
+    }
     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.
+         * 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.
          */
-        render(fieldMetadata: IFieldMetadata, bindingPath: string): Control;
+        onStateChange(newMetadata: IPropertyMetadata): void;
         /**
-         * 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.
+         * 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.
          */
-        validate(): boolean;
+        destroy?(): void;
         /**
-         * 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.
+         * 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.
          */
-        onStateChange(newMetadata: IFieldMetadata): void;
+        setDisplayMode?(mode: boolean): 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,uBAAuB;QACpC,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB;IAED,UAAiB,OAAO;QACpB;;;;;;;;;WASG;QACH,MAAM,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;QAExN;;;;WAIG;QACH,QAAQ,IAAI,uBAAuB,CAAC;QAEpC;;;;WAIG;QACH,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEpD;;;;WAIG;QACH,OAAO,CAAC,IAAI,IAAI,CAAC;QAEjB;;;WAGG;QACH,cAAc,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;KACxC;CAEA"}

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

@@ -1,33 +1,55 @@
-/**
- * @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 IPluginValidationResult {
+    isValid: boolean;
+    errorMessage?: string;
+    fieldKey?: string;
+}
+
+export interface IPlugin {
+    /**
+     * 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

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