@siliconst/metaui 1.4.34 → 1.4.44

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

@@ -0,0 +1,229 @@
+sap.ui.define(["./PluginRegistry", "../utils/Logger"], function (___PluginRegistry, ___utils_Logger) {
+  "use strict";
+
+  const PluginRegistry = ___PluginRegistry["PluginRegistry"];
+  const Logger = ___utils_Logger["Logger"];
+  /**
+   * The PolicyEngine is responsible for evaluating complex, cross-field conditional logic defined in the schema's `uiPolicies` array.
+   * It operates strictly on the JSON payload structure and returns an array of `IDeltaState` mutations which the GeneratorHost
+   * then applies to the individual active plugins.
+   * 
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.core
+   */
+  class PolicyEngine {
+    /** Caches the last computed state matrix for differential delta emission */
+
+    /**
+     * Instantiates the PolicyEngine with an array of policies.
+     * @param policies Array of uiPolicies defined in the root schema.
+     */
+    constructor(policies) {
+      this.policies = policies || [];
+      this.lastStateMatrix = new Map();
+    }
+
+    /**
+     * Safely traverses a JSON payload using a JSON pointer.
+     * Handles UI5 model prefixes (like metaui>) seamlessly.
+     * 
+     * @param data The root JSON object representing the form payload.
+     * @param pointer The JSON pointer to traverse (e.g., "/Customer/Age").
+     * @returns The resolved value, or undefined if the path does not exist.
+     */
+    resolvePointer(data, pointer) {
+      if (!data || !pointer) return undefined;
+      // Strip leading slash and any UI5 prefixes
+      const cleanPointer = pointer.replace(/^\//, "").replace(/^metaui>\/?/, "");
+      if (!cleanPointer) return data;
+      const parts = cleanPointer.split("/");
+      let current = data;
+      for (const part of parts) {
+        if (current === undefined || current === null) return undefined;
+        current = current[part];
+      }
+      return current;
+    }
+
+    /**
+     * Evaluates a complex condition tree against the live JSON payload.
+     * 
+     * @param condition The condition block to evaluate.
+     * @param data The live JSON payload from the StateManager.
+     * @returns True if all condition parameters are met, otherwise false.
+     */
+    evaluateCondition(condition, data) {
+      // If there are multiple operators, we treat them as AND for now
+      let result = true;
+      const registry = PluginRegistry.getInstance();
+      for (const [key, payload] of Object.entries(condition)) {
+        const plugin = registry.getPolicyConditionPlugin(key);
+        if (plugin) {
+          if (!plugin.evaluate(payload, data, this.resolvePointer.bind(this))) {
+            result = false;
+          }
+        } else {
+          Logger.warn(`[MetaUI PolicyEngine] Unrecognized condition operator: ${key}`);
+        }
+      }
+      return result;
+    }
+
+    /**
+     * Expands relative $row policies into absolute index policies for each physical row.
+     * Uses generic stringification to decouple from specific condition operator plugins.
+     */
+    expandRowPolicies(data, policies) {
+      const expanded = [];
+      for (const policy of policies) {
+        const policyStr = JSON.stringify(policy);
+        if (policyStr.includes("$row")) {
+          // Extract the array path (everything before "/$row" inside a JSON string value)
+          const match = policyStr.match(/"([^"]+)\/\$row/);
+          if (match) {
+            const arrayPath = match[1];
+            const arrayData = this.resolvePointer(data, arrayPath);
+            if (Array.isArray(arrayData)) {
+              for (let i = 0; i < arrayData.length; i++) {
+                const cloneStr = policyStr.replace(/\$row/g, String(i));
+                expanded.push(JSON.parse(cloneStr));
+              }
+            }
+          } else {
+            // Fallback if path couldn't be parsed
+            expanded.push(policy);
+          }
+        } else {
+          expanded.push(policy);
+        }
+      }
+      return expanded;
+    }
+
+    /**
+     * Evaluates policies against the given data payload using a State Resolution Matrix.
+     * @param data The JSON data payload.
+     * @returns Array of delta states to apply to the UI.
+     */
+    evaluate(data) {
+      if (!this.policies || this.policies.length === 0) {
+        return [];
+      }
+      const expandedPolicies = this.expandRowPolicies(data, this.policies);
+
+      // Ledger: target -> property -> { forcedFalse: number, forcedTrue: number, lastMessage?: string }
+      const ledger = new Map();
+      const initTargetInLedger = target => {
+        if (!ledger.has(target)) {
+          ledger.set(target, {
+            visibility: {
+              forcedFalse: 0,
+              forcedTrue: 0
+            },
+            validity: {
+              forcedFalse: 0,
+              forcedTrue: 0
+            },
+            required: {
+              forcedFalse: 0,
+              forcedTrue: 0
+            },
+            editable: {
+              forcedFalse: 0,
+              forcedTrue: 0
+            }
+          });
+        }
+      };
+
+      // 1. Build the Composite State Ledger Matrix
+      for (const policy of expandedPolicies) {
+        const isConditionMet = this.evaluateCondition(policy.condition, data);
+        for (const target of policy.targets) {
+          initTargetInLedger(target);
+          const currentLedger = ledger.get(target);
+          const effectPlugin = PluginRegistry.getInstance().getPolicyEffectPlugin(policy.effect);
+          if (!effectPlugin) {
+            Logger.error(`[MetaUI PolicyEngine] Unrecognized policy effect: ${policy.effect}`);
+            continue;
+          }
+          const mapped = effectPlugin.resolveState(isConditionMet, policy.effect);
+
+          // Track forces. For restrictable properties (visibility, validity, editable), forcedFalse acts as a lock.
+          // For required, forcedTrue acts as a lock.
+          if (mapped.value) {
+            currentLedger[mapped.property].forcedTrue++;
+          } else {
+            currentLedger[mapped.property].forcedFalse++;
+            if (mapped.property === "validity" && isConditionMet && policy.message) {
+              currentLedger.validity.lastMessage = policy.message;
+            }
+          }
+        }
+      }
+      const newStateMatrix = new Map();
+
+      // 2. Resolve the Ledger into a concrete State Matrix
+      for (const [target, stateMap] of ledger.entries()) {
+        newStateMatrix.set(target, {
+          // False (Hidden) wins if ANY policy forced it false
+          visibility: stateMap.visibility.forcedFalse > 0 ? false : true,
+          // False (Invalid) wins if ANY policy forced it false
+          validity: stateMap.validity.forcedFalse > 0 ? false : true,
+          // True (Required) wins if ANY policy forced it true
+          required: stateMap.required.forcedTrue > 0 ? true : false,
+          // False (Disabled) wins if ANY policy forced it false
+          editable: stateMap.editable.forcedFalse > 0 ? false : true,
+          errorMessage: stateMap.validity.lastMessage
+        });
+      }
+      const deltas = [];
+
+      // 3. Differential Emission
+      for (const [target, newState] of newStateMatrix.entries()) {
+        const lastState = this.lastStateMatrix.get(target) || {};
+        if (newState.visibility !== undefined && newState.visibility !== lastState.visibility) {
+          deltas.push({
+            target,
+            property: "visibility",
+            value: newState.visibility
+          });
+        }
+        if (newState.validity !== undefined && newState.validity !== lastState.validity) {
+          if (newState.validity !== lastState.validity || newState.errorMessage !== lastState.errorMessage) {
+            deltas.push({
+              target,
+              property: "validity",
+              value: newState.validity,
+              errorMessage: newState.errorMessage
+            });
+          }
+        }
+        if (newState.required !== undefined && newState.required !== lastState.required) {
+          deltas.push({
+            target,
+            property: "required",
+            value: newState.required
+          });
+        }
+        if (newState.editable !== undefined && newState.editable !== lastState.editable) {
+          deltas.push({
+            target,
+            property: "editable",
+            value: newState.editable
+          });
+        }
+      }
+
+      // Cache for next evaluation sweep
+      this.lastStateMatrix = newStateMatrix;
+      return deltas;
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.PolicyEngine = PolicyEngine;
+  return __exports;
+});
+//# sourceMappingURL=PolicyEngine-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEngine-dbg.js","names":["PluginRegistry","___PluginRegistry","Logger","___utils_Logger","PolicyEngine","constructor","policies","lastStateMatrix","Map","resolvePointer","data","pointer","undefined","cleanPointer","replace","parts","split","current","part","evaluateCondition","condition","result","registry","getInstance","key","payload","Object","entries","plugin","getPolicyConditionPlugin","evaluate","bind","warn","expandRowPolicies","expanded","policy","policyStr","JSON","stringify","includes","match","arrayPath","arrayData","Array","isArray","i","length","cloneStr","String","push","parse","expandedPolicies","ledger","initTargetInLedger","target","has","set","visibility","forcedFalse","forcedTrue","validity","required","editable","isConditionMet","targets","currentLedger","get","effectPlugin","getPolicyEffectPlugin","effect","error","mapped","resolveState","value","property","message","lastMessage","newStateMatrix","stateMap","errorMessage","deltas","newState","lastState","__exports","__esModule"],"sources":["PolicyEngine.ts"],"sourcesContent":["import { IPolicy, IPolicyCondition, PolicyEffectType } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport { Logger } from \"../utils/Logger\";\n\nexport type PropertyName = \"visibility\" | \"validity\" | \"required\" | \"editable\";\n\nexport interface IDeltaState {\n    /** The absolute JSON pointer path of the target property (e.g., \"/VisitorInfo/PassportNumber\") */\n    target: string;\n    /** The UI5 visual or structural state to mutate */\n    property: PropertyName;\n    /** The boolean value to apply to the state */\n    value: boolean;\n    /** An optional custom error message to paint onto the field if validity is false */\n    errorMessage?: string;\n}\n\ninterface ITargetState {\n    visibility?: boolean;\n    validity?: boolean;\n    required?: boolean;\n    editable?: boolean;\n    errorMessage?: string;\n}\n\n/**\n * The PolicyEngine is responsible for evaluating complex, cross-field conditional logic defined in the schema's `uiPolicies` array.\n * It operates strictly on the JSON payload structure and returns an array of `IDeltaState` mutations which the GeneratorHost\n * then applies to the individual active plugins.\n * \n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n */\nexport class PolicyEngine {\n    private policies: IPolicy[];\n\n    /** Caches the last computed state matrix for differential delta emission */\n    private lastStateMatrix: Map<string, ITargetState>;\n\n    /**\n     * Instantiates the PolicyEngine with an array of policies.\n     * @param policies Array of uiPolicies defined in the root schema.\n     */\n    constructor(policies: IPolicy[]) {\n        this.policies = policies || [];\n        this.lastStateMatrix = new Map();\n    }\n\n    /**\n     * Safely traverses a JSON payload using a JSON pointer.\n     * Handles UI5 model prefixes (like metaui>) seamlessly.\n     * \n     * @param data The root JSON object representing the form payload.\n     * @param pointer The JSON pointer to traverse (e.g., \"/Customer/Age\").\n     * @returns The resolved value, or undefined if the path does not exist.\n     */\n    private resolvePointer(data: unknown, pointer: string): unknown {\n        if (!data || !pointer) return undefined;\n        // Strip leading slash and any UI5 prefixes\n        const cleanPointer = pointer.replace(/^\\//, \"\").replace(/^metaui>\\/?/, \"\");\n        if (!cleanPointer) return data;\n\n        const parts = cleanPointer.split(\"/\");\n        let current = data as Record<string, unknown>;\n        for (const part of parts) {\n            if (current === undefined || current === null) return undefined;\n            current = current[part] as Record<string, unknown>;\n        }\n        return current;\n    }\n\n    /**\n     * Evaluates a complex condition tree against the live JSON payload.\n     * \n     * @param condition The condition block to evaluate.\n     * @param data The live JSON payload from the StateManager.\n     * @returns True if all condition parameters are met, otherwise false.\n     */\n    private evaluateCondition(condition: IPolicyCondition, data: unknown): boolean {\n        // If there are multiple operators, we treat them as AND for now\n        let result = true;\n        const registry = PluginRegistry.getInstance();\n\n        for (const [key, payload] of Object.entries(condition)) {\n            const plugin = registry.getPolicyConditionPlugin(key);\n            if (plugin) {\n                if (!plugin.evaluate(payload, data, this.resolvePointer.bind(this))) {\n                    result = false;\n                }\n            } else {\n                Logger.warn(`[MetaUI PolicyEngine] Unrecognized condition operator: ${key}`);\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Expands relative $row policies into absolute index policies for each physical row.\n     * Uses generic stringification to decouple from specific condition operator plugins.\n     */\n    private expandRowPolicies(data: unknown, policies: IPolicy[]): IPolicy[] {\n        const expanded: IPolicy[] = [];\n        for (const policy of policies) {\n            const policyStr = JSON.stringify(policy);\n            if (policyStr.includes(\"$row\")) {\n                // Extract the array path (everything before \"/$row\" inside a JSON string value)\n                const match = policyStr.match(/\"([^\"]+)\\/\\$row/);\n                if (match) {\n                    const arrayPath = match[1];\n                    const arrayData = this.resolvePointer(data, arrayPath);\n                    if (Array.isArray(arrayData)) {\n                        for (let i = 0; i < arrayData.length; i++) {\n                            const cloneStr = policyStr.replace(/\\$row/g, String(i));\n                            expanded.push(JSON.parse(cloneStr));\n                        }\n                    }\n                } else {\n                    // Fallback if path couldn't be parsed\n                    expanded.push(policy);\n                }\n            } else {\n                expanded.push(policy);\n            }\n        }\n        return expanded;\n    }\n\n    /**\n     * Evaluates policies against the given data payload using a State Resolution Matrix.\n     * @param data The JSON data payload.\n     * @returns Array of delta states to apply to the UI.\n     */\n    public evaluate(data: unknown): IDeltaState[] {\n        if (!this.policies || this.policies.length === 0) {\n            return [];\n        }\n\n        const expandedPolicies = this.expandRowPolicies(data, this.policies);\n\n        // Ledger: target -> property -> { forcedFalse: number, forcedTrue: number, lastMessage?: string }\n        const ledger = new Map<string, Record<PropertyName, { forcedFalse: number, forcedTrue: number, lastMessage?: string }>>();\n\n        const initTargetInLedger = (target: string) => {\n            if (!ledger.has(target)) {\n                ledger.set(target, {\n                    visibility: { forcedFalse: 0, forcedTrue: 0 },\n                    validity: { forcedFalse: 0, forcedTrue: 0 },\n                    required: { forcedFalse: 0, forcedTrue: 0 },\n                    editable: { forcedFalse: 0, forcedTrue: 0 }\n                });\n            }\n        };\n\n        // 1. Build the Composite State Ledger Matrix\n        for (const policy of expandedPolicies) {\n            const isConditionMet = this.evaluateCondition(policy.condition, data);\n\n            for (const target of policy.targets) {\n                initTargetInLedger(target);\n                const currentLedger = ledger.get(target)!;\n\n                const effectPlugin = PluginRegistry.getInstance().getPolicyEffectPlugin(policy.effect);\n                if (!effectPlugin) {\n                    Logger.error(`[MetaUI PolicyEngine] Unrecognized policy effect: ${policy.effect}`);\n                    continue;\n                }\n                const mapped = effectPlugin.resolveState(isConditionMet, policy.effect);\n\n                // Track forces. For restrictable properties (visibility, validity, editable), forcedFalse acts as a lock.\n                // For required, forcedTrue acts as a lock.\n                if (mapped.value) {\n                    currentLedger[mapped.property].forcedTrue++;\n                } else {\n                    currentLedger[mapped.property].forcedFalse++;\n                    if (mapped.property === \"validity\" && isConditionMet && policy.message) {\n                        currentLedger.validity.lastMessage = policy.message;\n                    }\n                }\n            }\n        }\n\n        const newStateMatrix = new Map<string, ITargetState>();\n\n        // 2. Resolve the Ledger into a concrete State Matrix\n        for (const [target, stateMap] of ledger.entries()) {\n            newStateMatrix.set(target, {\n                // False (Hidden) wins if ANY policy forced it false\n                visibility: stateMap.visibility.forcedFalse > 0 ? false : true,\n                // False (Invalid) wins if ANY policy forced it false\n                validity: stateMap.validity.forcedFalse > 0 ? false : true,\n                // True (Required) wins if ANY policy forced it true\n                required: stateMap.required.forcedTrue > 0 ? true : false,\n                // False (Disabled) wins if ANY policy forced it false\n                editable: stateMap.editable.forcedFalse > 0 ? false : true,\n                errorMessage: stateMap.validity.lastMessage\n            });\n        }\n\n        const deltas: IDeltaState[] = [];\n\n        // 3. Differential Emission\n        for (const [target, newState] of newStateMatrix.entries()) {\n            const lastState = this.lastStateMatrix.get(target) || {};\n\n            if (newState.visibility !== undefined && newState.visibility !== lastState.visibility) {\n                deltas.push({ target, property: \"visibility\", value: newState.visibility });\n            }\n            if (newState.validity !== undefined && newState.validity !== lastState.validity) {\n                if (newState.validity !== lastState.validity || newState.errorMessage !== lastState.errorMessage) {\n                    deltas.push({ target, property: \"validity\", value: newState.validity, errorMessage: newState.errorMessage });\n                }\n            }\n            if (newState.required !== undefined && newState.required !== lastState.required) {\n                deltas.push({ target, property: \"required\", value: newState.required });\n            }\n            if (newState.editable !== undefined && newState.editable !== lastState.editable) {\n                deltas.push({ target, property: \"editable\", value: newState.editable });\n            }\n        }\n\n        // Cache for next evaluation sweep\n        this.lastStateMatrix = newStateMatrix;\n\n        return deltas;\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,68 @@
+declare module "nz/co/siliconst/ui5/metaui/core/PolicyEngine" {
+    import { IPolicy } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    export type PropertyName = "visibility" | "validity" | "required" | "editable";
+    export interface IDeltaState {
+        /** The absolute JSON pointer path of the target property (e.g., "/VisitorInfo/PassportNumber") */
+        target: string;
+        /** The UI5 visual or structural state to mutate */
+        property: PropertyName;
+        /** The boolean value to apply to the state */
+        value: boolean;
+        /** An optional custom error message to paint onto the field if validity is false */
+        errorMessage?: string;
+    }
+    interface ITargetState {
+        visibility?: boolean;
+        validity?: boolean;
+        required?: boolean;
+        editable?: boolean;
+        errorMessage?: string;
+    }
+    /**
+     * The PolicyEngine is responsible for evaluating complex, cross-field conditional logic defined in the schema's `uiPolicies` array.
+     * It operates strictly on the JSON payload structure and returns an array of `IDeltaState` mutations which the GeneratorHost
+     * then applies to the individual active plugins.
+     *
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.core
+     */
+    export class PolicyEngine {
+        private policies;
+        /** Caches the last computed state matrix for differential delta emission */
+        private lastStateMatrix;
+        /**
+         * Instantiates the PolicyEngine with an array of policies.
+         * @param policies Array of uiPolicies defined in the root schema.
+         */
+        constructor(policies: IPolicy[]);
+        /**
+         * Safely traverses a JSON payload using a JSON pointer.
+         * Handles UI5 model prefixes (like metaui>) seamlessly.
+         *
+         * @param data The root JSON object representing the form payload.
+         * @param pointer The JSON pointer to traverse (e.g., "/Customer/Age").
+         * @returns The resolved value, or undefined if the path does not exist.
+         */
+        private resolvePointer;
+        /**
+         * Evaluates a complex condition tree against the live JSON payload.
+         *
+         * @param condition The condition block to evaluate.
+         * @param data The live JSON payload from the StateManager.
+         * @returns True if all condition parameters are met, otherwise false.
+         */
+        private evaluateCondition;
+        /**
+         * Expands relative $row policies into absolute index policies for each physical row.
+         * Uses generic stringification to decouple from specific condition operator plugins.
+         */
+        private expandRowPolicies;
+        /**
+         * Evaluates policies against the given data payload using a State Resolution Matrix.
+         * @param data The JSON data payload.
+         * @returns Array of delta states to apply to the UI.
+         */
+        evaluate(data: unknown): IDeltaState[];
+    }
+}
+//# sourceMappingURL=PolicyEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEngine.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/PolicyEngine.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,8CAA8C,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAsC,MAAM,+CAA+C,CAAC;IAI5G,KAAY,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IAE/E,UAAiB,WAAW;QACxB,kGAAkG;QAClG,MAAM,EAAE,MAAM,CAAC;QACf,mDAAmD;QACnD,QAAQ,EAAE,YAAY,CAAC;QACvB,8CAA8C;QAC9C,KAAK,EAAE,OAAO,CAAC;QACf,oFAAoF;QACpF,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB;IAED,UAAU,YAAY;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB;IAED;;;;;;;OAOG;IACH,MAAa,YAAY;QACrB,OAAO,CAAC,QAAQ,CAAY;QAE5B,4EAA4E;QAC5E,OAAO,CAAC,eAAe,CAA4B;QAEnD;;;WAGG;oBACS,QAAQ,EAAE,OAAO,EAAE;QAK/B;;;;;;;WAOG;QACH,OAAO,CAAC,cAAc;QAetB;;;;;;WAMG;QACH,OAAO,CAAC,iBAAiB;QAmBzB;;;WAGG;QACH,OAAO,CAAC,iBAAiB;QA2BzB;;;;WAIG;QACI,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE;KA6FhD;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["./PluginRegistry","../utils/Logger"],function(e,i){"use strict";const t=e["PluginRegistry"];const r=i["Logger"];class s{constructor(e){this.policies=e||[];this.lastStateMatrix=new Map}resolvePointer(e,i){if(!e||!i)return undefined;const t=i.replace(/^\//,"").replace(/^metaui>\/?/,"");if(!t)return e;const r=t.split("/");let s=e;for(const e of r){if(s===undefined||s===null)return undefined;s=s[e]}return s}evaluateCondition(e,i){let s=true;const o=t.getInstance();for(const[t,n]of Object.entries(e)){const e=o.getPolicyConditionPlugin(t);if(e){if(!e.evaluate(n,i,this.resolvePointer.bind(this))){s=false}}else{r.warn(`[MetaUI PolicyEngine] Unrecognized condition operator: ${t}`)}}return s}expandRowPolicies(e,i){const t=[];for(const r of i){const i=JSON.stringify(r);if(i.includes("$row")){const s=i.match(/"([^"]+)\/\$row/);if(s){const r=s[1];const o=this.resolvePointer(e,r);if(Array.isArray(o)){for(let e=0;e<o.length;e++){const r=i.replace(/\$row/g,String(e));t.push(JSON.parse(r))}}}else{t.push(r)}}else{t.push(r)}}return t}evaluate(e){if(!this.policies||this.policies.length===0){return[]}const i=this.expandRowPolicies(e,this.policies);const s=new Map;const o=e=>{if(!s.has(e)){s.set(e,{visibility:{forcedFalse:0,forcedTrue:0},validity:{forcedFalse:0,forcedTrue:0},required:{forcedFalse:0,forcedTrue:0},editable:{forcedFalse:0,forcedTrue:0}})}};for(const n of i){const i=this.evaluateCondition(n.condition,e);for(const e of n.targets){o(e);const a=s.get(e);const l=t.getInstance().getPolicyEffectPlugin(n.effect);if(!l){r.error(`[MetaUI PolicyEngine] Unrecognized policy effect: ${n.effect}`);continue}const c=l.resolveState(i,n.effect);if(c.value){a[c.property].forcedTrue++}else{a[c.property].forcedFalse++;if(c.property==="validity"&&i&&n.message){a.validity.lastMessage=n.message}}}}const n=new Map;for(const[e,i]of s.entries()){n.set(e,{visibility:i.visibility.forcedFalse>0?false:true,validity:i.validity.forcedFalse>0?false:true,required:i.required.forcedTrue>0?true:false,editable:i.editable.forcedFalse>0?false:true,errorMessage:i.validity.lastMessage})}const a=[];for(const[e,i]of n.entries()){const t=this.lastStateMatrix.get(e)||{};if(i.visibility!==undefined&&i.visibility!==t.visibility){a.push({target:e,property:"visibility",value:i.visibility})}if(i.validity!==undefined&&i.validity!==t.validity){if(i.validity!==t.validity||i.errorMessage!==t.errorMessage){a.push({target:e,property:"validity",value:i.validity,errorMessage:i.errorMessage})}}if(i.required!==undefined&&i.required!==t.required){a.push({target:e,property:"required",value:i.required})}if(i.editable!==undefined&&i.editable!==t.editable){a.push({target:e,property:"editable",value:i.editable})}}this.lastStateMatrix=n;return a}}var o={__esModule:true};o.PolicyEngine=s;return o});
+//# sourceMappingURL=PolicyEngine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEngine.js","names":["PluginRegistry","___PluginRegistry","Logger","___utils_Logger","PolicyEngine","constructor","policies","this","lastStateMatrix","Map","resolvePointer","data","pointer","undefined","cleanPointer","replace","parts","split","current","part","evaluateCondition","condition","result","registry","getInstance","key","payload","Object","entries","plugin","getPolicyConditionPlugin","evaluate","bind","warn","expandRowPolicies","expanded","policy","policyStr","JSON","stringify","includes","match","arrayPath","arrayData","Array","isArray","i","length","cloneStr","String","push","parse","expandedPolicies","ledger","initTargetInLedger","target","has","set","visibility","forcedFalse","forcedTrue","validity","required","editable","isConditionMet","targets","currentLedger","get","effectPlugin","getPolicyEffectPlugin","effect","error","mapped","resolveState","value","property","message","lastMessage","newStateMatrix","stateMap","errorMessage","deltas","newState","lastState","__exports","__esModule"],"sources":["PolicyEngine.ts"],"sourcesContent":["import { IPolicy, IPolicyCondition, PolicyEffectType } from \"../interfaces/ISchema\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport { Logger } from \"../utils/Logger\";\n\nexport type PropertyName = \"visibility\" | \"validity\" | \"required\" | \"editable\";\n\nexport interface IDeltaState {\n    /** The absolute JSON pointer path of the target property (e.g., \"/VisitorInfo/PassportNumber\") */\n    target: string;\n    /** The UI5 visual or structural state to mutate */\n    property: PropertyName;\n    /** The boolean value to apply to the state */\n    value: boolean;\n    /** An optional custom error message to paint onto the field if validity is false */\n    errorMessage?: string;\n}\n\ninterface ITargetState {\n    visibility?: boolean;\n    validity?: boolean;\n    required?: boolean;\n    editable?: boolean;\n    errorMessage?: string;\n}\n\n/**\n * The PolicyEngine is responsible for evaluating complex, cross-field conditional logic defined in the schema's `uiPolicies` array.\n * It operates strictly on the JSON payload structure and returns an array of `IDeltaState` mutations which the GeneratorHost\n * then applies to the individual active plugins.\n * \n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n */\nexport class PolicyEngine {\n    private policies: IPolicy[];\n\n    /** Caches the last computed state matrix for differential delta emission */\n    private lastStateMatrix: Map<string, ITargetState>;\n\n    /**\n     * Instantiates the PolicyEngine with an array of policies.\n     * @param policies Array of uiPolicies defined in the root schema.\n     */\n    constructor(policies: IPolicy[]) {\n        this.policies = policies || [];\n        this.lastStateMatrix = new Map();\n    }\n\n    /**\n     * Safely traverses a JSON payload using a JSON pointer.\n     * Handles UI5 model prefixes (like metaui>) seamlessly.\n     * \n     * @param data The root JSON object representing the form payload.\n     * @param pointer The JSON pointer to traverse (e.g., \"/Customer/Age\").\n     * @returns The resolved value, or undefined if the path does not exist.\n     */\n    private resolvePointer(data: unknown, pointer: string): unknown {\n        if (!data || !pointer) return undefined;\n        // Strip leading slash and any UI5 prefixes\n        const cleanPointer = pointer.replace(/^\\//, \"\").replace(/^metaui>\\/?/, \"\");\n        if (!cleanPointer) return data;\n\n        const parts = cleanPointer.split(\"/\");\n        let current = data as Record<string, unknown>;\n        for (const part of parts) {\n            if (current === undefined || current === null) return undefined;\n            current = current[part] as Record<string, unknown>;\n        }\n        return current;\n    }\n\n    /**\n     * Evaluates a complex condition tree against the live JSON payload.\n     * \n     * @param condition The condition block to evaluate.\n     * @param data The live JSON payload from the StateManager.\n     * @returns True if all condition parameters are met, otherwise false.\n     */\n    private evaluateCondition(condition: IPolicyCondition, data: unknown): boolean {\n        // If there are multiple operators, we treat them as AND for now\n        let result = true;\n        const registry = PluginRegistry.getInstance();\n\n        for (const [key, payload] of Object.entries(condition)) {\n            const plugin = registry.getPolicyConditionPlugin(key);\n            if (plugin) {\n                if (!plugin.evaluate(payload, data, this.resolvePointer.bind(this))) {\n                    result = false;\n                }\n            } else {\n                Logger.warn(`[MetaUI PolicyEngine] Unrecognized condition operator: ${key}`);\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Expands relative $row policies into absolute index policies for each physical row.\n     * Uses generic stringification to decouple from specific condition operator plugins.\n     */\n    private expandRowPolicies(data: unknown, policies: IPolicy[]): IPolicy[] {\n        const expanded: IPolicy[] = [];\n        for (const policy of policies) {\n            const policyStr = JSON.stringify(policy);\n            if (policyStr.includes(\"$row\")) {\n                // Extract the array path (everything before \"/$row\" inside a JSON string value)\n                const match = policyStr.match(/\"([^\"]+)\\/\\$row/);\n                if (match) {\n                    const arrayPath = match[1];\n                    const arrayData = this.resolvePointer(data, arrayPath);\n                    if (Array.isArray(arrayData)) {\n                        for (let i = 0; i < arrayData.length; i++) {\n                            const cloneStr = policyStr.replace(/\\$row/g, String(i));\n                            expanded.push(JSON.parse(cloneStr));\n                        }\n                    }\n                } else {\n                    // Fallback if path couldn't be parsed\n                    expanded.push(policy);\n                }\n            } else {\n                expanded.push(policy);\n            }\n        }\n        return expanded;\n    }\n\n    /**\n     * Evaluates policies against the given data payload using a State Resolution Matrix.\n     * @param data The JSON data payload.\n     * @returns Array of delta states to apply to the UI.\n     */\n    public evaluate(data: unknown): IDeltaState[] {\n        if (!this.policies || this.policies.length === 0) {\n            return [];\n        }\n\n        const expandedPolicies = this.expandRowPolicies(data, this.policies);\n\n        // Ledger: target -> property -> { forcedFalse: number, forcedTrue: number, lastMessage?: string }\n        const ledger = new Map<string, Record<PropertyName, { forcedFalse: number, forcedTrue: number, lastMessage?: string }>>();\n\n        const initTargetInLedger = (target: string) => {\n            if (!ledger.has(target)) {\n                ledger.set(target, {\n                    visibility: { forcedFalse: 0, forcedTrue: 0 },\n                    validity: { forcedFalse: 0, forcedTrue: 0 },\n                    required: { forcedFalse: 0, forcedTrue: 0 },\n                    editable: { forcedFalse: 0, forcedTrue: 0 }\n                });\n            }\n        };\n\n        // 1. Build the Composite State Ledger Matrix\n        for (const policy of expandedPolicies) {\n            const isConditionMet = this.evaluateCondition(policy.condition, data);\n\n            for (const target of policy.targets) {\n                initTargetInLedger(target);\n                const currentLedger = ledger.get(target)!;\n\n                const effectPlugin = PluginRegistry.getInstance().getPolicyEffectPlugin(policy.effect);\n                if (!effectPlugin) {\n                    Logger.error(`[MetaUI PolicyEngine] Unrecognized policy effect: ${policy.effect}`);\n                    continue;\n                }\n                const mapped = effectPlugin.resolveState(isConditionMet, policy.effect);\n\n                // Track forces. For restrictable properties (visibility, validity, editable), forcedFalse acts as a lock.\n                // For required, forcedTrue acts as a lock.\n                if (mapped.value) {\n                    currentLedger[mapped.property].forcedTrue++;\n                } else {\n                    currentLedger[mapped.property].forcedFalse++;\n                    if (mapped.property === \"validity\" && isConditionMet && policy.message) {\n                        currentLedger.validity.lastMessage = policy.message;\n                    }\n                }\n            }\n        }\n\n        const newStateMatrix = new Map<string, ITargetState>();\n\n        // 2. Resolve the Ledger into a concrete State Matrix\n        for (const [target, stateMap] of ledger.entries()) {\n            newStateMatrix.set(target, {\n                // False (Hidden) wins if ANY policy forced it false\n                visibility: stateMap.visibility.forcedFalse > 0 ? false : true,\n                // False (Invalid) wins if ANY policy forced it false\n                validity: stateMap.validity.forcedFalse > 0 ? false : true,\n                // True (Required) wins if ANY policy forced it true\n                required: stateMap.required.forcedTrue > 0 ? true : false,\n                // False (Disabled) wins if ANY policy forced it false\n                editable: stateMap.editable.forcedFalse > 0 ? false : true,\n                errorMessage: stateMap.validity.lastMessage\n            });\n        }\n\n        const deltas: IDeltaState[] = [];\n\n        // 3. Differential Emission\n        for (const [target, newState] of newStateMatrix.entries()) {\n            const lastState = this.lastStateMatrix.get(target) || {};\n\n            if (newState.visibility !== undefined && newState.visibility !== lastState.visibility) {\n                deltas.push({ target, property: \"visibility\", value: newState.visibility });\n            }\n            if (newState.validity !== undefined && newState.validity !== lastState.validity) {\n                if (newState.validity !== lastState.validity || newState.errorMessage !== lastState.errorMessage) {\n                    deltas.push({ target, property: \"validity\", value: newState.validity, errorMessage: newState.errorMessage });\n                }\n            }\n            if (newState.required !== undefined && newState.required !== lastState.required) {\n                deltas.push({ target, property: \"required\", value: newState.required });\n            }\n            if (newState.editable !== undefined && newState.editable !== lastState.editable) {\n                deltas.push({ target, property: \"editable\", value: newState.editable });\n            }\n        }\n\n        // Cache for next evaluation sweep\n        this.lastStateMatrix = newStateMatrix;\n\n        return deltas;\n    }\n}\n"],"mappings":"sFACSA,EAAcC,EAAA,wBACdC,EAAMC,EAAA,UA+BR,MAAMC,EAUTC,YAAYC,GACRC,KAAKD,SAAWA,GAAY,GAC5BC,KAAKC,gBAAkB,IAAIC,GAC/B,CAUQC,eAAeC,EAAeC,GAClC,IAAKD,IAASC,EAAS,OAAOC,UAE9B,MAAMC,EAAeF,EAAQG,QAAQ,MAAO,IAAIA,QAAQ,cAAe,IACvE,IAAKD,EAAc,OAAOH,EAE1B,MAAMK,EAAQF,EAAaG,MAAM,KACjC,IAAIC,EAAUP,EACd,IAAK,MAAMQ,KAAQH,EAAO,CACtB,GAAIE,IAAYL,WAAaK,IAAY,KAAM,OAAOL,UACtDK,EAAUA,EAAQC,EACtB,CACA,OAAOD,CACX,CASQE,kBAAkBC,EAA6BV,GAEnD,IAAIW,EAAS,KACb,MAAMC,EAAWvB,EAAewB,cAEhC,IAAK,MAAOC,EAAKC,KAAYC,OAAOC,QAAQP,GAAY,CACpD,MAAMQ,EAASN,EAASO,yBAAyBL,GACjD,GAAII,EAAQ,CACR,IAAKA,EAAOE,SAASL,EAASf,EAAMJ,KAAKG,eAAesB,KAAKzB,OAAQ,CACjEe,EAAS,KACb,CACJ,KAAO,CACHpB,EAAO+B,KAAK,0DAA0DR,IAC1E,CACJ,CAEA,OAAOH,CACX,CAMQY,kBAAkBvB,EAAeL,GACrC,MAAM6B,EAAsB,GAC5B,IAAK,MAAMC,KAAU9B,EAAU,CAC3B,MAAM+B,EAAYC,KAAKC,UAAUH,GACjC,GAAIC,EAAUG,SAAS,QAAS,CAE5B,MAAMC,EAAQJ,EAAUI,MAAM,mBAC9B,GAAIA,EAAO,CACP,MAAMC,EAAYD,EAAM,GACxB,MAAME,EAAYpC,KAAKG,eAAeC,EAAM+B,GAC5C,GAAIE,MAAMC,QAAQF,GAAY,CAC1B,IAAK,IAAIG,EAAI,EAAGA,EAAIH,EAAUI,OAAQD,IAAK,CACvC,MAAME,EAAWX,EAAUtB,QAAQ,SAAUkC,OAAOH,IACpDX,EAASe,KAAKZ,KAAKa,MAAMH,GAC7B,CACJ,CACJ,KAAO,CAEHb,EAASe,KAAKd,EAClB,CACJ,KAAO,CACHD,EAASe,KAAKd,EAClB,CACJ,CACA,OAAOD,CACX,CAOOJ,SAASpB,GACZ,IAAKJ,KAAKD,UAAYC,KAAKD,SAASyC,SAAW,EAAG,CAC9C,MAAO,EACX,CAEA,MAAMK,EAAmB7C,KAAK2B,kBAAkBvB,EAAMJ,KAAKD,UAG3D,MAAM+C,EAAS,IAAI5C,IAEnB,MAAM6C,EAAsBC,IACxB,IAAKF,EAAOG,IAAID,GAAS,CACrBF,EAAOI,IAAIF,EAAQ,CACfG,WAAY,CAAEC,YAAa,EAAGC,WAAY,GAC1CC,SAAU,CAAEF,YAAa,EAAGC,WAAY,GACxCE,SAAU,CAAEH,YAAa,EAAGC,WAAY,GACxCG,SAAU,CAAEJ,YAAa,EAAGC,WAAY,IAEhD,GAIJ,IAAK,MAAMxB,KAAUgB,EAAkB,CACnC,MAAMY,EAAiBzD,KAAKa,kBAAkBgB,EAAOf,UAAWV,GAEhE,IAAK,MAAM4C,KAAUnB,EAAO6B,QAAS,CACjCX,EAAmBC,GACnB,MAAMW,EAAgBb,EAAOc,IAAIZ,GAEjC,MAAMa,EAAepE,EAAewB,cAAc6C,sBAAsBjC,EAAOkC,QAC/E,IAAKF,EAAc,CACflE,EAAOqE,MAAM,qDAAqDnC,EAAOkC,UACzE,QACJ,CACA,MAAME,EAASJ,EAAaK,aAAaT,EAAgB5B,EAAOkC,QAIhE,GAAIE,EAAOE,MAAO,CACdR,EAAcM,EAAOG,UAAUf,YACnC,KAAO,CACHM,EAAcM,EAAOG,UAAUhB,cAC/B,GAAIa,EAAOG,WAAa,YAAcX,GAAkB5B,EAAOwC,QAAS,CACpEV,EAAcL,SAASgB,YAAczC,EAAOwC,OAChD,CACJ,CACJ,CACJ,CAEA,MAAME,EAAiB,IAAIrE,IAG3B,IAAK,MAAO8C,EAAQwB,KAAa1B,EAAOzB,UAAW,CAC/CkD,EAAerB,IAAIF,EAAQ,CAEvBG,WAAYqB,EAASrB,WAAWC,YAAc,EAAI,MAAQ,KAE1DE,SAAUkB,EAASlB,SAASF,YAAc,EAAI,MAAQ,KAEtDG,SAAUiB,EAASjB,SAASF,WAAa,EAAI,KAAO,MAEpDG,SAAUgB,EAAShB,SAASJ,YAAc,EAAI,MAAQ,KACtDqB,aAAcD,EAASlB,SAASgB,aAExC,CAEA,MAAMI,EAAwB,GAG9B,IAAK,MAAO1B,EAAQ2B,KAAaJ,EAAelD,UAAW,CACvD,MAAMuD,EAAY5E,KAAKC,gBAAgB2D,IAAIZ,IAAW,CAAC,EAEvD,GAAI2B,EAASxB,aAAe7C,WAAaqE,EAASxB,aAAeyB,EAAUzB,WAAY,CACnFuB,EAAO/B,KAAK,CAAEK,SAAQoB,SAAU,aAAcD,MAAOQ,EAASxB,YAClE,CACA,GAAIwB,EAASrB,WAAahD,WAAaqE,EAASrB,WAAasB,EAAUtB,SAAU,CAC7E,GAAIqB,EAASrB,WAAasB,EAAUtB,UAAYqB,EAASF,eAAiBG,EAAUH,aAAc,CAC9FC,EAAO/B,KAAK,CAAEK,SAAQoB,SAAU,WAAYD,MAAOQ,EAASrB,SAAUmB,aAAcE,EAASF,cACjG,CACJ,CACA,GAAIE,EAASpB,WAAajD,WAAaqE,EAASpB,WAAaqB,EAAUrB,SAAU,CAC7EmB,EAAO/B,KAAK,CAAEK,SAAQoB,SAAU,WAAYD,MAAOQ,EAASpB,UAChE,CACA,GAAIoB,EAASnB,WAAalD,WAAaqE,EAASnB,WAAaoB,EAAUpB,SAAU,CAC7EkB,EAAO/B,KAAK,CAAEK,SAAQoB,SAAU,WAAYD,MAAOQ,EAASnB,UAChE,CACJ,CAGAxD,KAAKC,gBAAkBsE,EAEvB,OAAOG,CACX,EACH,IAAAG,EAAA,CAAAC,WAAA,MAAAD,EAAAhF,eAAA,OAAAgF,CAAA","ignoreList":[]}

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

@@ -0,0 +1,227 @@
+import { IPolicy, IPolicyCondition, PolicyEffectType } from "../interfaces/ISchema";
+import { PluginRegistry } from "./PluginRegistry";
+import { Logger } from "../utils/Logger";
+
+export type PropertyName = "visibility" | "validity" | "required" | "editable";
+
+export interface IDeltaState {
+    /** The absolute JSON pointer path of the target property (e.g., "/VisitorInfo/PassportNumber") */
+    target: string;
+    /** The UI5 visual or structural state to mutate */
+    property: PropertyName;
+    /** The boolean value to apply to the state */
+    value: boolean;
+    /** An optional custom error message to paint onto the field if validity is false */
+    errorMessage?: string;
+}
+
+interface ITargetState {
+    visibility?: boolean;
+    validity?: boolean;
+    required?: boolean;
+    editable?: boolean;
+    errorMessage?: string;
+}
+
+/**
+ * The PolicyEngine is responsible for evaluating complex, cross-field conditional logic defined in the schema's `uiPolicies` array.
+ * It operates strictly on the JSON payload structure and returns an array of `IDeltaState` mutations which the GeneratorHost
+ * then applies to the individual active plugins.
+ * 
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ */
+export class PolicyEngine {
+    private policies: IPolicy[];
+
+    /** Caches the last computed state matrix for differential delta emission */
+    private lastStateMatrix: Map<string, ITargetState>;
+
+    /**
+     * Instantiates the PolicyEngine with an array of policies.
+     * @param policies Array of uiPolicies defined in the root schema.
+     */
+    constructor(policies: IPolicy[]) {
+        this.policies = policies || [];
+        this.lastStateMatrix = new Map();
+    }
+
+    /**
+     * Safely traverses a JSON payload using a JSON pointer.
+     * Handles UI5 model prefixes (like metaui>) seamlessly.
+     * 
+     * @param data The root JSON object representing the form payload.
+     * @param pointer The JSON pointer to traverse (e.g., "/Customer/Age").
+     * @returns The resolved value, or undefined if the path does not exist.
+     */
+    private resolvePointer(data: unknown, pointer: string): unknown {
+        if (!data || !pointer) return undefined;
+        // Strip leading slash and any UI5 prefixes
+        const cleanPointer = pointer.replace(/^\//, "").replace(/^metaui>\/?/, "");
+        if (!cleanPointer) return data;
+
+        const parts = cleanPointer.split("/");
+        let current = data as Record<string, unknown>;
+        for (const part of parts) {
+            if (current === undefined || current === null) return undefined;
+            current = current[part] as Record<string, unknown>;
+        }
+        return current;
+    }
+
+    /**
+     * Evaluates a complex condition tree against the live JSON payload.
+     * 
+     * @param condition The condition block to evaluate.
+     * @param data The live JSON payload from the StateManager.
+     * @returns True if all condition parameters are met, otherwise false.
+     */
+    private evaluateCondition(condition: IPolicyCondition, data: unknown): boolean {
+        // If there are multiple operators, we treat them as AND for now
+        let result = true;
+        const registry = PluginRegistry.getInstance();
+
+        for (const [key, payload] of Object.entries(condition)) {
+            const plugin = registry.getPolicyConditionPlugin(key);
+            if (plugin) {
+                if (!plugin.evaluate(payload, data, this.resolvePointer.bind(this))) {
+                    result = false;
+                }
+            } else {
+                Logger.warn(`[MetaUI PolicyEngine] Unrecognized condition operator: ${key}`);
+            }
+        }
+
+        return result;
+    }
+
+    /**
+     * Expands relative $row policies into absolute index policies for each physical row.
+     * Uses generic stringification to decouple from specific condition operator plugins.
+     */
+    private expandRowPolicies(data: unknown, policies: IPolicy[]): IPolicy[] {
+        const expanded: IPolicy[] = [];
+        for (const policy of policies) {
+            const policyStr = JSON.stringify(policy);
+            if (policyStr.includes("$row")) {
+                // Extract the array path (everything before "/$row" inside a JSON string value)
+                const match = policyStr.match(/"([^"]+)\/\$row/);
+                if (match) {
+                    const arrayPath = match[1];
+                    const arrayData = this.resolvePointer(data, arrayPath);
+                    if (Array.isArray(arrayData)) {
+                        for (let i = 0; i < arrayData.length; i++) {
+                            const cloneStr = policyStr.replace(/\$row/g, String(i));
+                            expanded.push(JSON.parse(cloneStr));
+                        }
+                    }
+                } else {
+                    // Fallback if path couldn't be parsed
+                    expanded.push(policy);
+                }
+            } else {
+                expanded.push(policy);
+            }
+        }
+        return expanded;
+    }
+
+    /**
+     * Evaluates policies against the given data payload using a State Resolution Matrix.
+     * @param data The JSON data payload.
+     * @returns Array of delta states to apply to the UI.
+     */
+    public evaluate(data: unknown): IDeltaState[] {
+        if (!this.policies || this.policies.length === 0) {
+            return [];
+        }
+
+        const expandedPolicies = this.expandRowPolicies(data, this.policies);
+
+        // Ledger: target -> property -> { forcedFalse: number, forcedTrue: number, lastMessage?: string }
+        const ledger = new Map<string, Record<PropertyName, { forcedFalse: number, forcedTrue: number, lastMessage?: string }>>();
+
+        const initTargetInLedger = (target: string) => {
+            if (!ledger.has(target)) {
+                ledger.set(target, {
+                    visibility: { forcedFalse: 0, forcedTrue: 0 },
+                    validity: { forcedFalse: 0, forcedTrue: 0 },
+                    required: { forcedFalse: 0, forcedTrue: 0 },
+                    editable: { forcedFalse: 0, forcedTrue: 0 }
+                });
+            }
+        };
+
+        // 1. Build the Composite State Ledger Matrix
+        for (const policy of expandedPolicies) {
+            const isConditionMet = this.evaluateCondition(policy.condition, data);
+
+            for (const target of policy.targets) {
+                initTargetInLedger(target);
+                const currentLedger = ledger.get(target)!;
+
+                const effectPlugin = PluginRegistry.getInstance().getPolicyEffectPlugin(policy.effect);
+                if (!effectPlugin) {
+                    Logger.error(`[MetaUI PolicyEngine] Unrecognized policy effect: ${policy.effect}`);
+                    continue;
+                }
+                const mapped = effectPlugin.resolveState(isConditionMet, policy.effect);
+
+                // Track forces. For restrictable properties (visibility, validity, editable), forcedFalse acts as a lock.
+                // For required, forcedTrue acts as a lock.
+                if (mapped.value) {
+                    currentLedger[mapped.property].forcedTrue++;
+                } else {
+                    currentLedger[mapped.property].forcedFalse++;
+                    if (mapped.property === "validity" && isConditionMet && policy.message) {
+                        currentLedger.validity.lastMessage = policy.message;
+                    }
+                }
+            }
+        }
+
+        const newStateMatrix = new Map<string, ITargetState>();
+
+        // 2. Resolve the Ledger into a concrete State Matrix
+        for (const [target, stateMap] of ledger.entries()) {
+            newStateMatrix.set(target, {
+                // False (Hidden) wins if ANY policy forced it false
+                visibility: stateMap.visibility.forcedFalse > 0 ? false : true,
+                // False (Invalid) wins if ANY policy forced it false
+                validity: stateMap.validity.forcedFalse > 0 ? false : true,
+                // True (Required) wins if ANY policy forced it true
+                required: stateMap.required.forcedTrue > 0 ? true : false,
+                // False (Disabled) wins if ANY policy forced it false
+                editable: stateMap.editable.forcedFalse > 0 ? false : true,
+                errorMessage: stateMap.validity.lastMessage
+            });
+        }
+
+        const deltas: IDeltaState[] = [];
+
+        // 3. Differential Emission
+        for (const [target, newState] of newStateMatrix.entries()) {
+            const lastState = this.lastStateMatrix.get(target) || {};
+
+            if (newState.visibility !== undefined && newState.visibility !== lastState.visibility) {
+                deltas.push({ target, property: "visibility", value: newState.visibility });
+            }
+            if (newState.validity !== undefined && newState.validity !== lastState.validity) {
+                if (newState.validity !== lastState.validity || newState.errorMessage !== lastState.errorMessage) {
+                    deltas.push({ target, property: "validity", value: newState.validity, errorMessage: newState.errorMessage });
+                }
+            }
+            if (newState.required !== undefined && newState.required !== lastState.required) {
+                deltas.push({ target, property: "required", value: newState.required });
+            }
+            if (newState.editable !== undefined && newState.editable !== lastState.editable) {
+                deltas.push({ target, property: "editable", value: newState.editable });
+            }
+        }
+
+        // Cache for next evaluation sweep
+        this.lastStateMatrix = newStateMatrix;
+
+        return deltas;
+    }
+}