@siliconst/metaui 1.4.34 → 1.4.44

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

@@ -6,7 +6,9 @@
 import JSONModel from "sap/ui/model/json/JSONModel";
 import ManagedObject from "sap/ui/base/ManagedObject";
 import { ISchema, IPropertyMetadata } from "../interfaces/ISchema";
+import { SCHEMA_TYPE } from "../constants/MetaUIConstants";
 import { GlobalPipeline } from "./PipelineManager";
+import { SchemaNormalizer } from "./SchemaNormalizer";
 import Message from "sap/ui/core/message/Message";
 import coreLibrary from "sap/ui/core/library";
 import Core from "sap/ui/core/Core";
@@ -63,17 +65,15 @@ export class StateManager {
         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)
-        if (this._useMessageManager) {
-            const existingMessages = messageManager.getMessageModel().getData();
-            const messagesToRemove = existingMessages.filter((msg: Message) => {
-                const isMatch = msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId();
-                return isMatch;
-            });
-            
-            if (messagesToRemove.length > 0) {
-                messageManager.removeMessages(messagesToRemove);
-            }
+        // 1. Remove existing messages (strictly for THIS model instance) unconditionally
+        const existingMessages = messageManager.getMessageModel().getData();
+        const messagesToRemove = existingMessages.filter((msg: Message) => {
+            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;
@@ -85,7 +85,7 @@ export class StateManager {
         if (metadata.required) {
             validatorsToRun.push("required");
         }
-        if (metadata.type === "string" && metadata.maxLength) {
+        if (metadata.type === SCHEMA_TYPE.STRING && metadata.maxLength) {
             validatorsToRun.push("maxLength");
             argsMap["maxLength"] = metadata.maxLength;
         }
@@ -108,7 +108,7 @@ export class StateManager {
         }
         if (metadata.ui?.validators) {
             for (const v of metadata.ui.validators) {
-                if (typeof v === "string") {
+                if (typeof v === SCHEMA_TYPE.STRING) {
                     validatorsToRun.push(v);
                 } else if (v && v.name) {
                     validatorsToRun.push(v.name);
@@ -133,6 +133,26 @@ export class StateManager {
         }
     }
 
+    /**
+     * Purges all MessageManager errors that start with a specific array path.
+     * Used to clean up "ghost errors" when array structural shifts (deletion) occur.
+     * @param arrayPath The root array path (e.g. /Items)
+     */
+    public clearArrayMessages(arrayPath: string): void {
+        const messageManager = Messaging;
+        const currentMessages = messageManager.getMessageModel().getData() as Message[];
+        
+        const pathPrefix = arrayPath.startsWith("/") ? arrayPath : `/${arrayPath}`;
+        
+        const messagesToRemove = currentMessages.filter(msg => {
+            return msg.getProcessor() === this.model && typeof msg.getTarget() === "string" && msg.getTarget().startsWith(pathPrefix);
+        });
+
+        if (messagesToRemove.length > 0) {
+            messageManager.removeMessages(messagesToRemove);
+        }
+    }
+
     /**
      * Resolves the schema metadata for a given internal binding path.
      * @param path The flat binding path representing the field.
@@ -140,8 +160,11 @@ export class StateManager {
      */
     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];
+        
+        // Deeply resolve the metadata using the SchemaNormalizer
+        const absoluteScope = "#/properties/" + path.replace(/\//g, "/properties/");
+        const { meta } = SchemaNormalizer.resolveScope(this.schema, absoluteScope);
+        return meta;
     }
 
 
@@ -173,16 +196,65 @@ export class StateManager {
      */
     public extractPayload(): Record<string, unknown> {
         // Create a deep copy to prevent accidental mutations by the host
+        // Uses a robust deep clone to avoid destructively coercing native objects (like Dates) to strings
         const data = this.model.getData();
-        return JSON.parse(JSON.stringify(data));
+        return this.deepClone(data) as Record<string, unknown>;
+    }
+
+    /**
+     * Recursively clones an object while preserving native Date instances and arrays.
+     */
+    private deepClone(obj: any): any {
+        if (obj === null || typeof obj !== "object") {
+            return obj;
+        }
+
+        if (obj instanceof Date) {
+            return new Date(obj.getTime());
+        }
+
+        if (Array.isArray(obj)) {
+            const arrCopy = [];
+            for (const item of obj) {
+                arrCopy.push(this.deepClone(item));
+            }
+            return arrCopy;
+        }
+
+        const objCopy: any = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                objCopy[key] = this.deepClone(obj[key]);
+            }
+        }
+        return objCopy;
+    }
+
+    /**
+     * Programmatically mutates the internal JSONModel property (e.g. for PBRE state pruning).
+     * @param path The path to the property.
+     * @param value The value to set.
+     */
+    public setProperty(path: string, value: unknown): void {
+        const absolutePath = path.startsWith("/") ? path : `/${path}`;
+        this.model.setProperty(absolutePath, value);
     }
 
     /**
      * Cleans up internal state and natively destroys the UI5 JSONModel to prevent memory leaks.
      */
     public destroy(): void {
-        
         if (this.model) {
+            // Fix Leaky Abstractions: Clean up any ghost errors in the global MessageManager bound to this model
+            const messageManager = Messaging;
+            const existingMessages = messageManager.getMessageModel().getData();
+            const messagesToRemove = existingMessages.filter((msg: Message) => 
+                msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.model.getId()
+            );
+            if (messagesToRemove.length > 0) {
+                messageManager.removeMessages(messagesToRemove);
+            }
+
             this.model.destroy();
         }
     }

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":["/**\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     * Instructs the plugin whether to delegate visual error states to the global MessageManager.\n     * @param useMessageManager True if the global MessageManager is active.\n     */\n    setUseMessageManager?(useMessageManager: boolean): void;\n\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, model?: unknown): 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     * Optionally allows the plugin to natively manage its own UI control's visual ValueState (e.g., red borders).\n     * Used when the global MessageManager is disabled.\n     * \n     * @param isValid Whether the field passed validation.\n     * @param errorMessage The error message to display if invalid.\n     */\n    setVisualValidationState?(isValid: boolean, errorMessage?: string): 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 editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in an editable mode.\n     */\n    setEditable?(editable: boolean): void;\n}\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    fieldLabel?: string;\n}\n\n/**\n * Standardized hooks for the Policy-Based Rule Engine (PBRE) to dynamically mutate visual state.\n */\nexport interface IPluginStateReceiver {\n    applyError?(errorMessage: string): void;\n    clearError?(): void;\n    applyVisibility?(isVisible: boolean): void;\n    applyRequired?(isRequired: boolean): void;\n    applyEditable?(isEditable: boolean): void;\n}\n\nexport interface IPlugin extends IPluginStateReceiver {\n    /**\n     * Instructs the plugin whether to delegate visual error states to the global MessageManager.\n     * @param useMessageManager True if the global MessageManager is active.\n     */\n    setUseMessageManager?(useMessageManager: boolean): void;\n\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, model?: unknown): 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     * Optionally allows the plugin to natively manage its own UI control's visual ValueState (e.g., red borders).\n     * Used when the global MessageManager is disabled.\n     * \n     * @param isValid Whether the field passed validation.\n     * @param errorMessage The error message to display if invalid.\n     */\n    setVisualValidationState?(isValid: boolean, errorMessage?: string): 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 editable mode context into the plugin before rendering.\n     * @param editable True if the plugin should render in an editable mode.\n     */\n    setEditable?(editable: boolean): void;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -10,8 +10,19 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/IPlugin" {
         isValid: boolean;
         errorMessage?: string;
         fieldKey?: string;
+        fieldLabel?: string;
     }
-    export interface IPlugin {
+    /**
+     * Standardized hooks for the Policy-Based Rule Engine (PBRE) to dynamically mutate visual state.
+     */
+    export interface IPluginStateReceiver {
+        applyError?(errorMessage: string): void;
+        clearError?(): void;
+        applyVisibility?(isVisible: boolean): void;
+        applyRequired?(isRequired: boolean): void;
+        applyEditable?(isEditable: boolean): void;
+    }
+    export interface IPlugin extends IPluginStateReceiver {
         /**
          * Instructs the plugin whether to delegate visual error states to the global MessageManager.
          * @param useMessageManager True if the global MessageManager is active.

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,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;;;WAGG;QACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;QAExD;;;;;;;;;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,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAEzO;;;;WAIG;QACH,QAAQ,IAAI,uBAAuB,CAAC;QAEpC;;;;WAIG;QACH,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEpD;;;;;;WAMG;QACH,wBAAwB,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzE;;;;WAIG;QACH,OAAO,CAAC,IAAI,IAAI,CAAC;QAEjB;;;WAGG;QACH,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;KACzC;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;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB;IAED;;OAEG;IACH,UAAiB,oBAAoB;QACjC,UAAU,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QACxC,UAAU,CAAC,IAAI,IAAI,CAAC;QACpB,eAAe,CAAC,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;QAC3C,aAAa,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;QAC1C,aAAa,CAAC,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;KAC7C;IAED,UAAiB,OAAQ,SAAQ,oBAAoB;QACjD;;;WAGG;QACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;QAExD;;;;;;;;;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,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAEzO;;;;WAIG;QACH,QAAQ,IAAI,uBAAuB,CAAC;QAEpC;;;;WAIG;QACH,aAAa,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;QAEpD;;;;;;WAMG;QACH,wBAAwB,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzE;;;;WAIG;QACH,OAAO,CAAC,IAAI,IAAI,CAAC;QAEjB;;;WAGG;QACH,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;KACzC;CAEA"}

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

@@ -11,9 +11,21 @@ export interface IPluginValidationResult {
     isValid: boolean;
     errorMessage?: string;
     fieldKey?: string;
+    fieldLabel?: string;
 }
 
-export interface IPlugin {
+/**
+ * Standardized hooks for the Policy-Based Rule Engine (PBRE) to dynamically mutate visual state.
+ */
+export interface IPluginStateReceiver {
+    applyError?(errorMessage: string): void;
+    clearError?(): void;
+    applyVisibility?(isVisible: boolean): void;
+    applyRequired?(isRequired: boolean): void;
+    applyEditable?(isEditable: boolean): void;
+}
+
+export interface IPlugin extends IPluginStateReceiver {
     /**
      * Instructs the plugin whether to delegate visual error states to the global MessageManager.
      * @param useMessageManager True if the global MessageManager is active.

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"IPolicyPlugin-dbg.js","names":[],"sources":["IPolicyPlugin.ts"],"sourcesContent":["/**\n * @file IPolicyPlugin.ts\n * @description Contracts for extending the PolicyEngine with custom evaluation and effect logic.\n * Enforces the Plugin-First architecture to prevent hardcoding rule sets.\n */\n\nimport { PolicyEffectType } from \"./ISchema\";\nimport { PropertyName } from \"../core/PolicyEngine\";\n\n/**\n * Resolves whether a specific schema condition passes or fails against the live UI data payload.\n */\nexport interface IPolicyConditionPlugin {\n    /**\n     * Identifies if this plugin handles a specific condition key (e.g., \"NumericGreaterThan\", \"StringEquals\").\n     * @param conditionKey The key extracted from the IPolicyCondition block.\n     * @returns True if this plugin should evaluate the block, false otherwise.\n     */\n    canHandle(conditionKey: string): boolean;\n\n    /**\n     * Evaluates the condition payload against the live data.\n     * @param conditionPayload The arbitrary payload attached to the condition key (e.g., { \"/Age\": 18 }).\n     * @param data The live JSON model payload.\n     * @param resolvePointer A utility function injected by the orchestrator to safely resolve JSON paths against the data.\n     * @returns True if the condition is satisfied, false otherwise.\n     */\n    evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean;\n}\n\n/**\n * Translates a semantic policy effect (e.g., \"Hide\", \"Invalidate\") into a strict binary structural property state.\n */\nexport interface IPolicyEffectPlugin {\n    /**\n     * Identifies if this plugin translates a specific semantic effect string.\n     * @param effect The semantic string defined in the schema (e.g., \"Hide\", \"Require\").\n     * @returns True if this plugin owns the translation, false otherwise.\n     */\n    canHandle(effect: PolicyEffectType | string): boolean;\n\n    /**\n     * Resolves the effect into a concrete structural delta for the UI components.\n     * Automatically handles the symmetrical reversal if the condition is false.\n     * @param isConditionMet Whether the governing policy condition passed or failed.\n     * @returns An object containing the exact property to alter (e.g., \"visibility\") and its new boolean state.\n     */\n    resolveState(isConditionMet: boolean, originalEffect: PolicyEffectType | string): { property: PropertyName, value: boolean };\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -0,0 +1,50 @@
+declare module "nz/co/siliconst/ui5/metaui/interfaces/IPolicyPlugin" {
+    /**
+     * @file IPolicyPlugin.ts
+     * @description Contracts for extending the PolicyEngine with custom evaluation and effect logic.
+     * Enforces the Plugin-First architecture to prevent hardcoding rule sets.
+     */
+    import { PolicyEffectType } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    import { PropertyName } from "nz/co/siliconst/ui5/metaui/core/PolicyEngine";
+    /**
+     * Resolves whether a specific schema condition passes or fails against the live UI data payload.
+     */
+    export interface IPolicyConditionPlugin {
+        /**
+         * Identifies if this plugin handles a specific condition key (e.g., "NumericGreaterThan", "StringEquals").
+         * @param conditionKey The key extracted from the IPolicyCondition block.
+         * @returns True if this plugin should evaluate the block, false otherwise.
+         */
+        canHandle(conditionKey: string): boolean;
+        /**
+         * Evaluates the condition payload against the live data.
+         * @param conditionPayload The arbitrary payload attached to the condition key (e.g., { "/Age": 18 }).
+         * @param data The live JSON model payload.
+         * @param resolvePointer A utility function injected by the orchestrator to safely resolve JSON paths against the data.
+         * @returns True if the condition is satisfied, false otherwise.
+         */
+        evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean;
+    }
+    /**
+     * Translates a semantic policy effect (e.g., "Hide", "Invalidate") into a strict binary structural property state.
+     */
+    export interface IPolicyEffectPlugin {
+        /**
+         * Identifies if this plugin translates a specific semantic effect string.
+         * @param effect The semantic string defined in the schema (e.g., "Hide", "Require").
+         * @returns True if this plugin owns the translation, false otherwise.
+         */
+        canHandle(effect: PolicyEffectType | string): boolean;
+        /**
+         * Resolves the effect into a concrete structural delta for the UI components.
+         * Automatically handles the symmetrical reversal if the condition is false.
+         * @param isConditionMet Whether the governing policy condition passed or failed.
+         * @returns An object containing the exact property to alter (e.g., "visibility") and its new boolean state.
+         */
+        resolveState(isConditionMet: boolean, originalEffect: PolicyEffectType | string): {
+            property: PropertyName;
+            value: boolean;
+        };
+    }
+}
+//# sourceMappingURL=IPolicyPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IPolicyPlugin.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/IPolicyPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,qDAAqD,CAAC;IACrE;;;;OAIG;IAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;IACjF,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;IAE5E;;OAEG;IACH,UAAiB,sBAAsB;QACnC;;;;WAIG;QACH,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAEzC;;;;;;WAMG;QACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC;KACnH;IAED;;OAEG;IACH,UAAiB,mBAAmB;QAChC;;;;WAIG;QACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;QAEtD;;;;;WAKG;QACH,YAAY,CAAC,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,GAAG,MAAM,GAAG;YAAE,QAAQ,EAAE,YAAY,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAC;KAChI;CAEA"}

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

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

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * @file IPolicyPlugin.ts
+ * @description Contracts for extending the PolicyEngine with custom evaluation and effect logic.
+ * Enforces the Plugin-First architecture to prevent hardcoding rule sets.
+ */
+
+import { PolicyEffectType } from "./ISchema";
+import { PropertyName } from "../core/PolicyEngine";
+
+/**
+ * Resolves whether a specific schema condition passes or fails against the live UI data payload.
+ */
+export interface IPolicyConditionPlugin {
+    /**
+     * Identifies if this plugin handles a specific condition key (e.g., "NumericGreaterThan", "StringEquals").
+     * @param conditionKey The key extracted from the IPolicyCondition block.
+     * @returns True if this plugin should evaluate the block, false otherwise.
+     */
+    canHandle(conditionKey: string): boolean;
+
+    /**
+     * Evaluates the condition payload against the live data.
+     * @param conditionPayload The arbitrary payload attached to the condition key (e.g., { "/Age": 18 }).
+     * @param data The live JSON model payload.
+     * @param resolvePointer A utility function injected by the orchestrator to safely resolve JSON paths against the data.
+     * @returns True if the condition is satisfied, false otherwise.
+     */
+    evaluate(conditionPayload: unknown, data: unknown, resolvePointer: (d: unknown, p: string) => unknown): boolean;
+}
+
+/**
+ * Translates a semantic policy effect (e.g., "Hide", "Invalidate") into a strict binary structural property state.
+ */
+export interface IPolicyEffectPlugin {
+    /**
+     * Identifies if this plugin translates a specific semantic effect string.
+     * @param effect The semantic string defined in the schema (e.g., "Hide", "Require").
+     * @returns True if this plugin owns the translation, false otherwise.
+     */
+    canHandle(effect: PolicyEffectType | string): boolean;
+
+    /**
+     * Resolves the effect into a concrete structural delta for the UI components.
+     * Automatically handles the symmetrical reversal if the condition is false.
+     * @param isConditionMet Whether the governing policy condition passed or failed.
+     * @returns An object containing the exact property to alter (e.g., "visibility") and its new boolean state.
+     */
+    resolveState(isConditionMet: boolean, originalEffect: PolicyEffectType | string): { property: PropertyName, value: boolean };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"ISchema-dbg.js","names":[],"sources":["ISchema.ts"],"sourcesContent":["/**\n * @file ISchema.ts\n * @description MetaUI v2 Core Schema Contract.\n * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,\n * with a proprietary 'ui' directive block for Fiori visual orchestration.\n */\n\nimport { RenderModeType, SchemaTypeType } from \"../constants/MetaUIConstants\";\n\nexport type FieldType = SchemaTypeType | \"date\";\n\n/**\n * Value help structure mapping SAP Key/Text pairs.\n */\nexport interface IValueHelp {\n    key: string;\n    text: string;\n}\n\nexport interface IValidationRule {\n    name: string;\n    args?: unknown;\n}\n\n/**\n * An element in the visual layout tree.\n */\nexport interface ILayoutElement {\n    type: \"Group\" | \"Control\" | \"HorizontalLayout\" | \"VerticalLayout\" | \"WizardStep\";\n    label?: string;\n    scope?: string; // JSON Pointer to property, e.g. \"#/properties/FirstName\"\n    elements?: ILayoutElement[];\n    widget?: string; // Optional override for the widget\n}\n\n/**\n * Visual orchestration directives to separate layout from data modeling.\n */\nexport interface IUIDirective {\n    label?: string;\n    isKey?: boolean;\n    readOnly?: boolean;\n    widget?: string;\n    visibleOn?: string;\n    enabledOn?: string;\n    format?: string;\n    rows?: number;\n    fullWidth?: boolean;\n    validators?: (string | IValidationRule)[];\n    formatter?: string;\n    args?: unknown;\n    dialogButtonText?: string;\n    layoutBudget?: number;\n    renderMode?: RenderModeType;\n}\n\nexport interface IRemoteValueHelpConfig {\n    url: string;\n    keyPath: string;\n    textPath: string;\n}\n\n/**\n * Standard JSON-Schema property definition.\n */\nexport interface IPropertyMetadata {\n    type: FieldType;\n    $ref?: string;\n    \n    // MetaUI specific orchestration\n    ui?: IUIDirective;\n    \n    // Standard validations\n    required?: boolean;\n    maxLength?: number;\n    minLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    \n    // Numeric specifics\n    precision?: number;\n    scale?: number;\n    multipleOf?: number;\n    \n    // Value constraints\n    valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;\n    enum?: string[] | number[];\n    \n    // OpenAPI Advanced features\n    default?: unknown;\n    nullable?: boolean;\n    writeOnly?: boolean;\n    readOnly?: boolean;\n    example?: unknown;\n    deprecated?: boolean;\n    exclusiveMinimum?: boolean | number;\n    exclusiveMaximum?: boolean | number;\n    \n    // Array Validation\n    maxItems?: number;\n    minItems?: number;\n    uniqueItems?: boolean;\n\n    // Object Validation\n    maxProperties?: number;\n    minProperties?: number;\n\n    // Polymorphism and Composition\n    oneOf?: IPropertyMetadata[];\n    anyOf?: IPropertyMetadata[];\n    allOf?: IPropertyMetadata[];\n    not?: IPropertyMetadata;\n    discriminator?: { propertyName: string, mapping?: Record<string, string> };\n    \n    // Nested recursion for objects and arrays\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean | IPropertyMetadata;\n}\n\n/**\n * The master schema contract ingested by the Engine.\n */\nexport interface ISchema {\n    title?: string;\n    layoutStrategy?: string;\n    type?: \"object\" | \"array\"; // Implicit layout hinting\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n    definitions?: Record<string, ISchema>;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"ISchema-dbg.js","names":[],"sources":["ISchema.ts"],"sourcesContent":["/**\n * @file ISchema.ts\n * @description MetaUI v2 Core Schema Contract.\n * Aligned with standard JSON-Schema syntax (properties, items) for native AI generation,\n * with a proprietary 'ui' directive block for Fiori visual orchestration.\n */\n\nimport { RenderModeType, SchemaTypeType } from \"../constants/MetaUIConstants\";\n\nexport type FieldType = SchemaTypeType | \"date\";\n\n/**\n * Value help structure mapping SAP Key/Text pairs.\n */\nexport interface IValueHelp {\n    key: string;\n    text: string;\n}\n\nexport interface IValidationRule {\n    name: string;\n    args?: unknown;\n}\n\n/**\n * An element in the visual layout tree.\n */\nexport interface ILayoutElement {\n    type: \"Group\" | \"Control\" | \"HorizontalLayout\" | \"VerticalLayout\" | \"WizardStep\";\n    label?: string;\n    scope?: string; // JSON Pointer to property, e.g. \"#/properties/FirstName\"\n    elements?: ILayoutElement[];\n    widget?: string; // Optional override for the widget\n}\n\n/**\n * Visual orchestration directives to separate layout from data modeling.\n */\nexport interface IUIDirective {\n    label?: string;\n    isKey?: boolean;\n    readOnly?: boolean;\n    widget?: string;\n    visibleOn?: string;\n    enabledOn?: string;\n    format?: string;\n    rows?: number;\n    expandable?: boolean;\n    fullWidth?: boolean;\n    controlProps?: Record<string, unknown>;\n    validators?: (string | IValidationRule)[];\n    formatter?: string;\n    args?: unknown;\n    dialogButtonText?: string;\n    layoutBudget?: number;\n    renderMode?: RenderModeType;\n}\n\nexport interface IRemoteValueHelpConfig {\n    url: string;\n    keyPath: string;\n    textPath: string;\n}\n\nexport type PolicyEffectType = \"Require\" | \"Hide\" | \"Disable\" | \"Invalidate\" | \"Show\" | \"Enable\" | \"Validate\" | \"Optional\";\n\nexport interface IPolicyCondition {\n    NumericGreaterThan?: Record<string, number>;\n    NumericLessThan?: Record<string, number>;\n    StringEquals?: Record<string, string>;\n    DateLessThan?: Record<string, string>;\n    IsNull?: string[];\n    IsNotNull?: string[];\n    [operator: string]: unknown; // Extensible for other operators\n}\n\nexport interface IPolicy {\n    effect: PolicyEffectType;\n    targets: string[];\n    condition: IPolicyCondition;\n    message?: string;\n}\n\n/**\n * Standard JSON-Schema property definition.\n */\nexport interface IPropertyMetadata {\n    type: FieldType;\n    $ref?: string;\n    \n    // MetaUI specific orchestration\n    ui?: IUIDirective;\n    \n    // Standard validations\n    required?: boolean | string[];\n    maxLength?: number;\n    minLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    \n    // Numeric specifics\n    precision?: number;\n    scale?: number;\n    multipleOf?: number;\n    \n    // Value constraints\n    valueHelp?: IValueHelp[] | IRemoteValueHelpConfig;\n    enum?: string[] | number[];\n    \n    // OpenAPI Advanced features\n    default?: unknown;\n    nullable?: boolean;\n    writeOnly?: boolean;\n    readOnly?: boolean;\n    example?: unknown;\n    deprecated?: boolean;\n    exclusiveMinimum?: boolean | number;\n    exclusiveMaximum?: boolean | number;\n    \n    // Array Validation\n    maxItems?: number;\n    minItems?: number;\n    uniqueItems?: boolean;\n\n    // Object Validation\n    maxProperties?: number;\n    minProperties?: number;\n\n    // Polymorphism and Composition\n    oneOf?: IPropertyMetadata[];\n    anyOf?: IPropertyMetadata[];\n    allOf?: IPropertyMetadata[];\n    not?: IPropertyMetadata;\n    discriminator?: { propertyName: string, mapping?: Record<string, string> };\n    \n    // Nested recursion for objects and arrays\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean | IPropertyMetadata;\n}\n\n/**\n * The master schema contract ingested by the Engine.\n */\nexport interface ISchema {\n    title?: string;\n    uiPolicies?: IPolicy[];\n    layoutStrategy?: string;\n    type?: \"object\" | \"array\"; // Implicit layout hinting\n    properties?: Record<string, IPropertyMetadata>;\n    items?: IPropertyMetadata;\n    uiLayout?: ILayoutElement[];\n    additionalProperties?: boolean;\n    required?: string[];\n    definitions?: Record<string, ISchema>;\n}\n"],"mappings":"","ignoreList":[]}

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

@@ -40,7 +40,9 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         enabledOn?: string;
         format?: string;
         rows?: number;
+        expandable?: boolean;
         fullWidth?: boolean;
+        controlProps?: Record<string, unknown>;
         validators?: (string | IValidationRule)[];
         formatter?: string;
         args?: unknown;
@@ -53,6 +55,22 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         keyPath: string;
         textPath: string;
     }
+    export type PolicyEffectType = "Require" | "Hide" | "Disable" | "Invalidate" | "Show" | "Enable" | "Validate" | "Optional";
+    export interface IPolicyCondition {
+        NumericGreaterThan?: Record<string, number>;
+        NumericLessThan?: Record<string, number>;
+        StringEquals?: Record<string, string>;
+        DateLessThan?: Record<string, string>;
+        IsNull?: string[];
+        IsNotNull?: string[];
+        [operator: string]: unknown;
+    }
+    export interface IPolicy {
+        effect: PolicyEffectType;
+        targets: string[];
+        condition: IPolicyCondition;
+        message?: string;
+    }
     /**
      * Standard JSON-Schema property definition.
      */
@@ -60,7 +78,7 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
         type: FieldType;
         $ref?: string;
         ui?: IUIDirective;
-        required?: boolean;
+        required?: boolean | string[];
         maxLength?: number;
         minLength?: number;
         minimum?: number;
@@ -102,12 +120,14 @@ declare module "nz/co/siliconst/ui5/metaui/interfaces/ISchema" {
      */
     export interface ISchema {
         title?: string;
+        uiPolicies?: IPolicy[];
         layoutStrategy?: string;
         type?: "object" | "array";
         properties?: Record<string, IPropertyMetadata>;
         items?: IPropertyMetadata;
         uiLayout?: ILayoutElement[];
         additionalProperties?: boolean;
+        required?: string[];
         definitions?: Record<string, ISchema>;
     }
 }

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":"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"}
+{"version":3,"file":"ISchema.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/interfaces/ISchema.ts"],"names":[],"mappings":"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"}

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

@@ -45,7 +45,9 @@ export interface IUIDirective {
     enabledOn?: string;
     format?: string;
     rows?: number;
+    expandable?: boolean;
     fullWidth?: boolean;
+    controlProps?: Record<string, unknown>;
     validators?: (string | IValidationRule)[];
     formatter?: string;
     args?: unknown;
@@ -60,6 +62,25 @@ export interface IRemoteValueHelpConfig {
     textPath: string;
 }
 
+export type PolicyEffectType = "Require" | "Hide" | "Disable" | "Invalidate" | "Show" | "Enable" | "Validate" | "Optional";
+
+export interface IPolicyCondition {
+    NumericGreaterThan?: Record<string, number>;
+    NumericLessThan?: Record<string, number>;
+    StringEquals?: Record<string, string>;
+    DateLessThan?: Record<string, string>;
+    IsNull?: string[];
+    IsNotNull?: string[];
+    [operator: string]: unknown; // Extensible for other operators
+}
+
+export interface IPolicy {
+    effect: PolicyEffectType;
+    targets: string[];
+    condition: IPolicyCondition;
+    message?: string;
+}
+
 /**
  * Standard JSON-Schema property definition.
  */
@@ -71,7 +92,7 @@ export interface IPropertyMetadata {
     ui?: IUIDirective;
     
     // Standard validations
-    required?: boolean;
+    required?: boolean | string[];
     maxLength?: number;
     minLength?: number;
     minimum?: number;
@@ -125,11 +146,13 @@ export interface IPropertyMetadata {
  */
 export interface ISchema {
     title?: string;
+    uiPolicies?: IPolicy[];
     layoutStrategy?: string;
     type?: "object" | "array"; // Implicit layout hinting
     properties?: Record<string, IPropertyMetadata>;
     items?: IPropertyMetadata;
     uiLayout?: ILayoutElement[];
     additionalProperties?: boolean;
+    required?: string[];
     definitions?: Record<string, ISchema>;
 }

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

@@ -48,7 +48,6 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
         container.addItem(form);
         return container;
       }
-      const tableElements = [];
       let hasFormFields = false;
 
       // Recursively render layout elements
@@ -84,12 +83,32 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
           const hasExplicitWidget = !!meta.ui?.widget;
           const isTableSubLayout = meta.type === "array" && isCollectionOfRecords && !hasExplicitWidget;
           if (isTableSubLayout) {
-            Logger.debug("[MetaUI FormLayout]", `Routing property '${propKey}' to Table Sub-Layout.`, "FormLayout");
-            tableElements.push({
-              scope: bindingPath,
-              meta,
-              label: element.label
-            });
+            Logger.debug("[MetaUI FormLayout]", `Routing property '${propKey}' to Table Sub-Layout inline.`, "FormLayout");
+            hasFormFields = true;
+            try {
+              const subSchema = {
+                type: "array",
+                title: element.label || meta.ui?.label || propKey,
+                items: meta.items || {
+                  type: "object",
+                  properties: {}
+                },
+                uiLayout: meta.items?.uiLayout // Pass down sub-layout if available
+              };
+              const control = engine.generateLayout(subSchema, modelName, `/${bindingPath}`);
+              if (control) {
+                sap.ui.require(["sap/ui/layout/GridData"], GridData => {
+                  control.setLayoutData(new GridData({
+                    span: "XL12 L12 M12 S12"
+                  }));
+                });
+                form.addContent(control);
+              }
+            } catch (error) {
+              const msg = error.message;
+              Logger.error(`[MetaUI] Failed to render inline array field ${bindingPath}`, msg, "FormLayout");
+              Logger.showErrorPopup(`Failed to render array field '${bindingPath}'.\n\nDetails: ${msg}`);
+            }
           } else {
             hasFormFields = true;
             Logger.debug("[MetaUI FormLayout]", `Rendering scalar field '${bindingPath}'.`, "FormLayout");
@@ -105,30 +124,6 @@ sap.ui.define(["sap/ui/layout/form/SimpleForm", "sap/m/Label", "sap/ui/core/Titl
       if (hasFormFields) {
         container.addItem(form);
       }
-
-      // Render array/table sub-layouts full width below the form
-      tableElements.forEach(field => {
-        try {
-          const subSchema = {
-            type: "array",
-            title: field.label || field.meta.ui?.label || field.scope,
-            items: field.meta.items || {
-              type: "object",
-              properties: {}
-            },
-            uiLayout: field.meta.items?.uiLayout // Pass down sub-layout if available
-          };
-          const control = engine.generateLayout(subSchema, modelName, `/${field.scope}`);
-          if (control) {
-            control.addStyleClass("sapUiSmallMarginTop");
-            container.addItem(control);
-          }
-        } catch (error) {
-          const msg = error.message;
-          Logger.error(`[MetaUI] Failed to render array field ${field.scope}`, msg, "FormLayout");
-          Logger.showErrorPopup(`Failed to render array field '${field.scope}'.\n\nDetails: ${msg}`);
-        }
-      });
       return container;
     }