@siliconst/metaui 1.0.2 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DataSyncDelegate.ts

@@ -0,0 +1,119 @@
+import deepEqual from "sap/base/util/deepEqual";
+import extend from "sap/base/util/extend";
+import { Logger } from "../../../utils/Logger";
+import { SchemaNormalizer } from "../../../core/SchemaNormalizer";
+import PropertyBinding from "sap/ui/model/PropertyBinding";
+import { StateManager } from "../../../core/StateManager";
+
+export interface IHostDataSync {
+    getProperty(name: string): unknown;
+    setProperty(name: string, value: unknown, suppressInvalidate?: boolean): any;
+    setBaseProperty(name: string, value: unknown, suppressInvalidate?: boolean): any;
+    getBinding(name: string): any;
+    invalidate(): void;
+    getStateManager(): StateManager | null;
+    getParsedSchema?(): Record<string, unknown> | null;
+    tearDownGeneratedLayout(): void;
+}
+
+/**
+ * Handles two-way data sync, JSON parsing, loop-breaking, and inference structural diffs.
+ */
+export class DataSyncDelegate {
+    private host: IHostDataSync;
+    private _lastPushedPayloadJson: string | null = null;
+    private _lastPushedPayloadObj: Record<string, unknown> | null = null;
+    private _lastReceivedInputObj: Record<string, unknown> | null = null;
+
+    constructor(host: IHostDataSync) {
+        this.host = host;
+    }
+
+    /**
+     * Natively forces the UI5 framework to push updated properties back up to any bound ViewModels.
+     */
+    public pushToBindings(payload: Record<string, unknown>): void {
+        const payloadStr = JSON.stringify(payload, null, 2);
+
+        // Cache exact payload output to catch echoes on the inbound side
+        this._lastPushedPayloadJson = payloadStr;
+        this._lastPushedPayloadObj = deepEqual({}, payload) ? null : JSON.parse(JSON.stringify(payload)); // Safe clone
+
+        this.host.setProperty("data", payload, true);
+        this.host.setProperty("dataJson", payloadStr, true);
+    }
+
+    /**
+     * Intercepts and parses live updates to the data payload from two-way Fiori bindings.
+     */
+    public handleInputDataHotSwap(propertyName: string, value: unknown, suppressInvalidate?: boolean): void {
+        let incomingObj: Record<string, unknown> | null = null;
+
+        if (typeof value === "string") {
+            try {
+                incomingObj = JSON.parse(value) as Record<string, unknown>;
+            } catch (e) {
+                this.host.setBaseProperty(propertyName, value, true);
+                return;
+            }
+        } else {
+            incomingObj = value as Record<string, unknown>;
+        }
+
+        if (incomingObj === null) {
+            this.host.setBaseProperty(propertyName, value, true);
+            return;
+        }
+
+        // Loop Breaker 1: Stale Data Injection
+        if (this._lastReceivedInputObj && deepEqual(incomingObj, this._lastReceivedInputObj)) {
+            if (this.host.getProperty("debugMode")) {
+                Logger.debug("[MetaUI]", `Dropped stale data injection for ${propertyName}`, "DataSyncDelegate");
+            }
+            this.host.setBaseProperty(propertyName, value, suppressInvalidate);
+            return;
+        }
+
+        // Loop Breaker 2: Two-Way Data Echoes
+        if (this._lastPushedPayloadObj && deepEqual(incomingObj, this._lastPushedPayloadObj)) {
+            if (this.host.getProperty("debugMode")) {
+                Logger.debug("[MetaUI]", `Dropped echo for ${propertyName}`, "DataSyncDelegate");
+            }
+            this.host.setBaseProperty(propertyName, value, suppressInvalidate);
+            return;
+        }
+
+        this._lastReceivedInputObj = extend(true, {}, incomingObj) as Record<string, unknown>;
+
+        if (this.host.getProperty("debugMode")) {
+            Logger.debug("[MetaUI]", `Accepted external injection for ${propertyName}`, "DataSyncDelegate");
+        }
+
+        this.host.setBaseProperty(propertyName, value, true);
+
+        const stateManager = this.host.getStateManager();
+        if (!stateManager) {
+            this.host.invalidate();
+            return;
+        }
+
+        try {
+            stateManager.getModel().setData(incomingObj, false);
+
+            if (!this.host.getProperty("schemaDefinition") && typeof this.host.getParsedSchema === "function") {
+                const newInferredSchema = SchemaNormalizer.inferSchemaFromData(incomingObj);
+                const parsedSchema = this.host.getParsedSchema();
+                if (!deepEqual(newInferredSchema, parsedSchema)) {
+                    this.host.tearDownGeneratedLayout();
+                    this.host.invalidate();
+                }
+            }
+        } catch (e) {
+            const msg = `Failed to hot-swap ${propertyName}: ` + (e as Error).message;
+            Logger.error("[MetaUI]", msg, "DataSyncDelegate");
+            if (this.host.getProperty("debugMode")) {
+                sap.ui.require(["sap/m/MessageBox"], (MessageBox: unknown) => (MessageBox as Record<string, Function>).error(msg));
+            }
+        }
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate-dbg.js

@@ -0,0 +1,64 @@
+sap.ui.define(["sap/m/Dialog", "sap/m/Button", "../../../utils/Logger"], function (Dialog, Button, _____utils_Logger) {
+  "use strict";
+
+  const Logger = _____utils_Logger["Logger"];
+  /**
+   * Extracts all popup and dialog generation logic from the Host control.
+   */
+  class DialogDelegate {
+    constructor(host) {
+      this.host = host;
+    }
+
+    /**
+     * Dialog Modality: Opens the generated layout inside a sap.m.Dialog.
+     * Automatically wires up customizable submit (default: 'OK') and 'Cancel' buttons.
+     */
+    openInDialog(title = "Form", submitButtonText = "OK", isGenerated) {
+      if (!isGenerated) {
+        this.host.generate();
+      }
+      const dialog = new Dialog({
+        title: title,
+        contentWidth: "800px",
+        content: [this.host],
+        // Mount host inside the dialog
+        beginButton: new Button({
+          text: submitButtonText,
+          type: "Emphasized",
+          press: () => {
+            try {
+              const success = this.host.triggerSubmit();
+              if (success) {
+                dialog.close();
+              }
+            } catch (err) {
+              Logger.error("[MetaUI] Catastrophic error during validation/submit pipeline", err.message, "DialogDelegate");
+              this.host.fireEvent("validationError", {
+                fieldPath: "root",
+                message: err.message
+              });
+            }
+          }
+        }),
+        endButton: new Button({
+          text: "Cancel",
+          press: () => {
+            this.host.fireEvent("cancel");
+            dialog.close();
+          }
+        }),
+        afterClose: () => {
+          dialog.destroy();
+        }
+      });
+      dialog.open();
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.DialogDelegate = DialogDelegate;
+  return __exports;
+});
+//# sourceMappingURL=DialogDelegate-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogDelegate-dbg.js","names":["Logger","_____utils_Logger","DialogDelegate","constructor","host","openInDialog","title","submitButtonText","isGenerated","generate","dialog","Dialog","contentWidth","content","beginButton","Button","text","type","press","success","triggerSubmit","close","err","error","message","fireEvent","fieldPath","endButton","afterClose","destroy","open","__exports","__esModule"],"sources":["DialogDelegate.ts"],"sourcesContent":["import Dialog from \"sap/m/Dialog\";\nimport Button from \"sap/m/Button\";\nimport Control from \"sap/ui/core/Control\";\nimport { Logger } from \"../../../utils/Logger\";\n\nexport interface IHostDialog {\n    generate(): void;\n    triggerSubmit(): boolean;\n    fireEvent(eventName: string, parameters?: any): void;\n}\n\n/**\n * Extracts all popup and dialog generation logic from the Host control.\n */\nexport class DialogDelegate {\n    private host: IHostDialog & Control;\n\n    constructor(host: IHostDialog & Control) {\n        this.host = host;\n    }\n\n    /**\n     * Dialog Modality: Opens the generated layout inside a sap.m.Dialog.\n     * Automatically wires up customizable submit (default: 'OK') and 'Cancel' buttons.\n     */\n    public openInDialog(title: string = \"Form\", submitButtonText: string = \"OK\", isGenerated: boolean): void {\n        if (!isGenerated) {\n            this.host.generate();\n        }\n\n        const dialog = new Dialog({\n            title: title,\n            contentWidth: \"800px\",\n            content: [this.host], // Mount host inside the dialog\n            beginButton: new Button({\n                text: submitButtonText,\n                type: \"Emphasized\",\n                press: () => {\n                    try {\n                        const success = this.host.triggerSubmit();\n                        if (success) {\n                            dialog.close();\n                        }\n                    } catch (err) {\n                        Logger.error(\"[MetaUI] Catastrophic error during validation/submit pipeline\", (err as Error).message, \"DialogDelegate\");\n                        this.host.fireEvent(\"validationError\", { fieldPath: \"root\", message: (err as Error).message });\n                    }\n                }\n            }),\n            endButton: new Button({\n                text: \"Cancel\",\n                press: () => {\n                    this.host.fireEvent(\"cancel\");\n                    dialog.close();\n                }\n            }),\n            afterClose: () => {\n                dialog.destroy();\n            }\n        });\n\n        dialog.open();\n    }\n}\n"],"mappings":";;;QAGSA,MAAM,GAAAC,iBAAA;EAQf;AACA;AACA;EACO,MAAMC,cAAc,CAAC;IAGxBC,WAAWA,CAACC,IAA2B,EAAE;MACrC,IAAI,CAACA,IAAI,GAAGA,IAAI;IACpB;;IAEA;AACJ;AACA;AACA;IACWC,YAAYA,CAACC,KAAa,GAAG,MAAM,EAAEC,gBAAwB,GAAG,IAAI,EAAEC,WAAoB,EAAQ;MACrG,IAAI,CAACA,WAAW,EAAE;QACd,IAAI,CAACJ,IAAI,CAACK,QAAQ,CAAC,CAAC;MACxB;MAEA,MAAMC,MAAM,GAAG,IAAIC,MAAM,CAAC;QACtBL,KAAK,EAAEA,KAAK;QACZM,YAAY,EAAE,OAAO;QACrBC,OAAO,EAAE,CAAC,IAAI,CAACT,IAAI,CAAC;QAAE;QACtBU,WAAW,EAAE,IAAIC,MAAM,CAAC;UACpBC,IAAI,EAAET,gBAAgB;UACtBU,IAAI,EAAE,YAAY;UAClBC,KAAK,EAAEA,CAAA,KAAM;YACT,IAAI;cACA,MAAMC,OAAO,GAAG,IAAI,CAACf,IAAI,CAACgB,aAAa,CAAC,CAAC;cACzC,IAAID,OAAO,EAAE;gBACTT,MAAM,CAACW,KAAK,CAAC,CAAC;cAClB;YACJ,CAAC,CAAC,OAAOC,GAAG,EAAE;cACVtB,MAAM,CAACuB,KAAK,CAAC,+DAA+D,EAAGD,GAAG,CAAWE,OAAO,EAAE,gBAAgB,CAAC;cACvH,IAAI,CAACpB,IAAI,CAACqB,SAAS,CAAC,iBAAiB,EAAE;gBAAEC,SAAS,EAAE,MAAM;gBAAEF,OAAO,EAAGF,GAAG,CAAWE;cAAQ,CAAC,CAAC;YAClG;UACJ;QACJ,CAAC,CAAC;QACFG,SAAS,EAAE,IAAIZ,MAAM,CAAC;UAClBC,IAAI,EAAE,QAAQ;UACdE,KAAK,EAAEA,CAAA,KAAM;YACT,IAAI,CAACd,IAAI,CAACqB,SAAS,CAAC,QAAQ,CAAC;YAC7Bf,MAAM,CAACW,KAAK,CAAC,CAAC;UAClB;QACJ,CAAC,CAAC;QACFO,UAAU,EAAEA,CAAA,KAAM;UACdlB,MAAM,CAACmB,OAAO,CAAC,CAAC;QACpB;MACJ,CAAC,CAAC;MAEFnB,MAAM,CAACoB,IAAI,CAAC,CAAC;IACjB;EACJ;EAAC,IAAAC,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAA7B,cAAA,GAAAA,cAAA;EAAA,OAAA6B,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate.d.ts

@@ -0,0 +1,21 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate" {
+    import Control from "sap/ui/core/Control";
+    export interface IHostDialog {
+        generate(): void;
+        triggerSubmit(): boolean;
+        fireEvent(eventName: string, parameters?: any): void;
+    }
+    /**
+     * Extracts all popup and dialog generation logic from the Host control.
+     */
+    export class DialogDelegate {
+        private host;
+        constructor(host: IHostDialog & Control);
+        /**
+         * Dialog Modality: Opens the generated layout inside a sap.m.Dialog.
+         * Automatically wires up customizable submit (default: 'OK') and 'Cancel' buttons.
+         */
+        openInDialog(title: string, submitButtonText: string, isGenerated: boolean): void;
+    }
+}
+//# sourceMappingURL=DialogDelegate.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogDelegate.d.ts","sourceRoot":"../../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,mEAAmE,CAAC;IAGnF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAG1C,UAAiB,WAAW;QACxB,QAAQ,IAAI,IAAI,CAAC;QACjB,aAAa,IAAI,OAAO,CAAC;QACzB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;KACxD;IAED;;OAEG;IACH,MAAa,cAAc;QACvB,OAAO,CAAC,IAAI,CAAwB;oBAExB,IAAI,EAAE,WAAW,GAAG,OAAO;QAIvC;;;WAGG;QACI,YAAY,CAAC,KAAK,EAAE,MAAe,EAAE,gBAAgB,EAAE,MAAa,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;KAsC3G;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate.js

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/m/Dialog","sap/m/Button","../../../utils/Logger"],function(t,e,s){"use strict";const o=s["Logger"];class i{constructor(t){this.host=t}openInDialog(s="Form",i="OK",n){if(!n){this.host.generate()}const r=new t({title:s,contentWidth:"800px",content:[this.host],beginButton:new e({text:i,type:"Emphasized",press:()=>{try{const t=this.host.triggerSubmit();if(t){r.close()}}catch(t){o.error("[MetaUI] Catastrophic error during validation/submit pipeline",t.message,"DialogDelegate");this.host.fireEvent("validationError",{fieldPath:"root",message:t.message})}}}),endButton:new e({text:"Cancel",press:()=>{this.host.fireEvent("cancel");r.close()}}),afterClose:()=>{r.destroy()}});r.open()}}var n={__esModule:true};n.DialogDelegate=i;return n});
+//# sourceMappingURL=DialogDelegate.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogDelegate.js","names":["Logger","_____utils_Logger","DialogDelegate","constructor","host","this","openInDialog","title","submitButtonText","isGenerated","generate","dialog","Dialog","contentWidth","content","beginButton","Button","text","type","press","success","triggerSubmit","close","err","error","message","fireEvent","fieldPath","endButton","afterClose","destroy","open","__exports","__esModule"],"sources":["DialogDelegate.ts"],"sourcesContent":["import Dialog from \"sap/m/Dialog\";\nimport Button from \"sap/m/Button\";\nimport Control from \"sap/ui/core/Control\";\nimport { Logger } from \"../../../utils/Logger\";\n\nexport interface IHostDialog {\n    generate(): void;\n    triggerSubmit(): boolean;\n    fireEvent(eventName: string, parameters?: any): void;\n}\n\n/**\n * Extracts all popup and dialog generation logic from the Host control.\n */\nexport class DialogDelegate {\n    private host: IHostDialog & Control;\n\n    constructor(host: IHostDialog & Control) {\n        this.host = host;\n    }\n\n    /**\n     * Dialog Modality: Opens the generated layout inside a sap.m.Dialog.\n     * Automatically wires up customizable submit (default: 'OK') and 'Cancel' buttons.\n     */\n    public openInDialog(title: string = \"Form\", submitButtonText: string = \"OK\", isGenerated: boolean): void {\n        if (!isGenerated) {\n            this.host.generate();\n        }\n\n        const dialog = new Dialog({\n            title: title,\n            contentWidth: \"800px\",\n            content: [this.host], // Mount host inside the dialog\n            beginButton: new Button({\n                text: submitButtonText,\n                type: \"Emphasized\",\n                press: () => {\n                    try {\n                        const success = this.host.triggerSubmit();\n                        if (success) {\n                            dialog.close();\n                        }\n                    } catch (err) {\n                        Logger.error(\"[MetaUI] Catastrophic error during validation/submit pipeline\", (err as Error).message, \"DialogDelegate\");\n                        this.host.fireEvent(\"validationError\", { fieldPath: \"root\", message: (err as Error).message });\n                    }\n                }\n            }),\n            endButton: new Button({\n                text: \"Cancel\",\n                press: () => {\n                    this.host.fireEvent(\"cancel\");\n                    dialog.close();\n                }\n            }),\n            afterClose: () => {\n                dialog.destroy();\n            }\n        });\n\n        dialog.open();\n    }\n}\n"],"mappings":"yGAGSA,EAAMC,EAAA,UAWR,MAAMC,EAGTC,YAAYC,GACRC,KAAKD,KAAOA,CAChB,CAMOE,aAAaC,EAAgB,OAAQC,EAA2B,KAAMC,GACzE,IAAKA,EAAa,CACdJ,KAAKD,KAAKM,UACd,CAEA,MAAMC,EAAS,IAAIC,EAAO,CACtBL,MAAOA,EACPM,aAAc,QACdC,QAAS,CAACT,KAAKD,MACfW,YAAa,IAAIC,EAAO,CACpBC,KAAMT,EACNU,KAAM,aACNC,MAAOA,KACH,IACI,MAAMC,EAAUf,KAAKD,KAAKiB,gBAC1B,GAAID,EAAS,CACTT,EAAOW,OACX,CACJ,CAAE,MAAOC,GACLvB,EAAOwB,MAAM,gEAAkED,EAAcE,QAAS,kBACtGpB,KAAKD,KAAKsB,UAAU,kBAAmB,CAAEC,UAAW,OAAQF,QAAUF,EAAcE,SACxF,KAGRG,UAAW,IAAIZ,EAAO,CAClBC,KAAM,SACNE,MAAOA,KACHd,KAAKD,KAAKsB,UAAU,UACpBf,EAAOW,WAGfO,WAAYA,KACRlB,EAAOmB,aAIfnB,EAAOoB,MACX,EACH,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAA9B,iBAAA,OAAA8B,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/DialogDelegate.ts

@@ -0,0 +1,64 @@
+import Dialog from "sap/m/Dialog";
+import Button from "sap/m/Button";
+import Control from "sap/ui/core/Control";
+import { Logger } from "../../../utils/Logger";
+
+export interface IHostDialog {
+    generate(): void;
+    triggerSubmit(): boolean;
+    fireEvent(eventName: string, parameters?: any): void;
+}
+
+/**
+ * Extracts all popup and dialog generation logic from the Host control.
+ */
+export class DialogDelegate {
+    private host: IHostDialog & Control;
+
+    constructor(host: IHostDialog & Control) {
+        this.host = host;
+    }
+
+    /**
+     * Dialog Modality: Opens the generated layout inside a sap.m.Dialog.
+     * Automatically wires up customizable submit (default: 'OK') and 'Cancel' buttons.
+     */
+    public openInDialog(title: string = "Form", submitButtonText: string = "OK", isGenerated: boolean): void {
+        if (!isGenerated) {
+            this.host.generate();
+        }
+
+        const dialog = new Dialog({
+            title: title,
+            contentWidth: "800px",
+            content: [this.host], // Mount host inside the dialog
+            beginButton: new Button({
+                text: submitButtonText,
+                type: "Emphasized",
+                press: () => {
+                    try {
+                        const success = this.host.triggerSubmit();
+                        if (success) {
+                            dialog.close();
+                        }
+                    } catch (err) {
+                        Logger.error("[MetaUI] Catastrophic error during validation/submit pipeline", (err as Error).message, "DialogDelegate");
+                        this.host.fireEvent("validationError", { fieldPath: "root", message: (err as Error).message });
+                    }
+                }
+            }),
+            endButton: new Button({
+                text: "Cancel",
+                press: () => {
+                    this.host.fireEvent("cancel");
+                    dialog.close();
+                }
+            }),
+            afterClose: () => {
+                dialog.destroy();
+            }
+        });
+
+        dialog.open();
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate-dbg.js

@@ -0,0 +1,120 @@
+sap.ui.define(["sap/m/MessagePage", "sap/ui/core/Messaging", "../../../utils/Logger"], function (MessagePage, Messaging, _____utils_Logger) {
+  "use strict";
+
+  const Logger = _____utils_Logger["Logger"];
+  /**
+   * Handles Fiori MessageManager integration and provides a standardized Error Boundary UI fallback.
+   */
+  class ValidationDelegate {
+    constructor(host) {
+      this.host = host;
+    }
+
+    /**
+     * Registers a control and all its children with the global MessageManager.
+     */
+    registerObject(control) {
+      if (this.host.getProperty("useMessageManager")) {
+        Messaging.registerObject(control, true); // true = recurse all children
+      }
+    }
+
+    /**
+     * Unregisters a control from the global MessageManager.
+     */
+    unregisterObject(control) {
+      if (this.host.getProperty("useMessageManager")) {
+        Messaging.unregisterObject(control);
+      }
+    }
+
+    /**
+     * Clears all messages from the global MessageManager.
+     */
+    removeAllMessages() {
+      if (this.host.getProperty("useMessageManager")) {
+        Messaging.removeAllMessages();
+      }
+    }
+
+    /**
+     * Pushes a validation message to the console, and optionally to the MessageManager.
+     */
+    pushMessage(path, text) {
+      const targetPath = path ? `/${path.replace(/^\//, "")}` : "";
+      const displayText = path ? `Field '${path}': ${text}` : text;
+      if (path) {
+        Logger.warn(`[MetaUI Validation Error] ${displayText}`);
+      } else {
+        Logger.warn(`[MetaUI Validation Error] Global - ${text}`);
+      }
+      if (this.host.getProperty("useMessageManager")) {
+        sap.ui.require(["sap/ui/core/message/Message"], MessageClass => {
+          const messageManager = Messaging;
+          const stateManager = this.host.getStateManager();
+          messageManager.addMessages(new MessageClass({
+            message: displayText,
+            type: "Error",
+            target: targetPath,
+            processor: stateManager?.getModel()
+          }));
+        });
+      }
+    }
+
+    /**
+     * Imperatively invalidates a field and highlights it with an error message.
+     */
+    addCustomError(fieldPath, message) {
+      const useMessageManager = this.host.getProperty("useMessageManager");
+      const stateManager = this.host.getStateManager();
+      if (useMessageManager && stateManager) {
+        sap.ui.require(["sap/ui/core/message/Message"], MessageClass => {
+          const messageManager = Messaging;
+          messageManager.addMessages(new MessageClass({
+            message: message,
+            type: "Error",
+            target: `/${fieldPath.replace(/^\//, "")}`,
+            processor: stateManager.getModel()
+          }));
+        });
+      }
+    }
+
+    /**
+     * Reverts a custom error state on a field.
+     */
+    clearCustomError(fieldPath) {
+      const useMessageManager = this.host.getProperty("useMessageManager");
+      const stateManager = this.host.getStateManager();
+      if (useMessageManager && stateManager) {
+        const messageManager = Messaging;
+        const messages = messageManager.getMessageModel().getData();
+        const target = `/${fieldPath.replace(/^\//, "")}`;
+        const messageToRemove = messages.find(m => m.getTarget() === target && m.getMessageProcessor() && m.getMessageProcessor().getId() === stateManager.getModel().getId());
+        if (messageToRemove) {
+          messageManager.removeMessages(messageToRemove);
+        }
+      }
+    }
+
+    /**
+     * Triggers a visual Error Page (Crash Boundary) when generation catastrophically fails.
+     */
+    mountCrashBoundary(error) {
+      Logger.error("[MetaUI] Engine failed to generate layout. Preventing Launchpad crash.", error.message, "ValidationDelegate");
+      const errorPage = new MessagePage({
+        text: "UI Generation Failed",
+        description: "The dynamic schema could not be rendered. Please check the Fiori console for diagnostic logs.",
+        icon: "sap-icon://error"
+      });
+      this.host.setAggregation("_content", errorPage);
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.ValidationDelegate = ValidationDelegate;
+  return __exports;
+});
+//# sourceMappingURL=ValidationDelegate-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationDelegate-dbg.js","names":["Logger","_____utils_Logger","ValidationDelegate","constructor","host","registerObject","control","getProperty","Messaging","unregisterObject","removeAllMessages","pushMessage","path","text","targetPath","replace","displayText","warn","sap","ui","require","MessageClass","messageManager","stateManager","getStateManager","addMessages","message","type","target","processor","getModel","addCustomError","fieldPath","useMessageManager","clearCustomError","messages","getMessageModel","getData","messageToRemove","find","m","getTarget","getMessageProcessor","getId","removeMessages","mountCrashBoundary","error","errorPage","MessagePage","description","icon","setAggregation","__exports","__esModule"],"sources":["ValidationDelegate.ts"],"sourcesContent":["import MessagePage from \"sap/m/MessagePage\";\nimport Messaging from \"sap/ui/core/Messaging\";\nimport Control from \"sap/ui/core/Control\";\nimport { StateManager } from \"../../../core/StateManager\";\nimport { Logger } from \"../../../utils/Logger\";\nimport Message from \"sap/ui/core/message/Message\";\n\nexport interface IHostValidation {\n    getProperty(name: string): unknown;\n    setAggregation(aggregationName: string, object: any, suppressInvalidate?: boolean): any;\n    getStateManager(): StateManager | null;\n}\n\n/**\n * Handles Fiori MessageManager integration and provides a standardized Error Boundary UI fallback.\n */\nexport class ValidationDelegate {\n    private host: IHostValidation;\n\n    constructor(host: IHostValidation) {\n        this.host = host;\n    }\n\n    /**\n     * Registers a control and all its children with the global MessageManager.\n     */\n    public registerObject(control: Control): void {\n        if (this.host.getProperty(\"useMessageManager\")) {\n            Messaging.registerObject(control, true); // true = recurse all children\n        }\n    }\n\n    /**\n     * Unregisters a control from the global MessageManager.\n     */\n    public unregisterObject(control: Control): void {\n        if (this.host.getProperty(\"useMessageManager\")) {\n            Messaging.unregisterObject(control);\n        }\n    }\n\n    /**\n     * Clears all messages from the global MessageManager.\n     */\n    public removeAllMessages(): void {\n        if (this.host.getProperty(\"useMessageManager\")) {\n            Messaging.removeAllMessages();\n        }\n    }\n\n    /**\n     * Pushes a validation message to the console, and optionally to the MessageManager.\n     */\n    public pushMessage(path: string, text: string): void {\n        const targetPath = path ? `/${path.replace(/^\\//, \"\")}` : \"\";\n        const displayText = path ? `Field '${path}': ${text}` : text;\n\n        if (path) {\n            Logger.warn(`[MetaUI Validation Error] ${displayText}`);\n        } else {\n            Logger.warn(`[MetaUI Validation Error] Global - ${text}`);\n        }\n\n        if (this.host.getProperty(\"useMessageManager\")) {\n            sap.ui.require([\"sap/ui/core/message/Message\"], (MessageClass: any) => {\n                const messageManager = Messaging;\n                const stateManager = this.host.getStateManager();\n                messageManager.addMessages(new MessageClass({\n                    message: displayText,\n                    type: \"Error\" as unknown,\n                    target: targetPath,\n                    processor: stateManager?.getModel()\n                }));\n            });\n        }\n    }\n\n    /**\n     * Imperatively invalidates a field and highlights it with an error message.\n     */\n    public addCustomError(fieldPath: string, message: string): void {\n        const useMessageManager = this.host.getProperty(\"useMessageManager\") as boolean;\n        const stateManager = this.host.getStateManager();\n        if (useMessageManager && stateManager) {\n            sap.ui.require([\"sap/ui/core/message/Message\"], (MessageClass: any) => {\n                const messageManager = Messaging;\n                messageManager.addMessages(new MessageClass({\n                    message: message,\n                    type: \"Error\" as unknown,\n                    target: `/${fieldPath.replace(/^\\//, \"\")}`,\n                    processor: stateManager.getModel()\n                }));\n            });\n        }\n    }\n\n    /**\n     * Reverts a custom error state on a field.\n     */\n    public clearCustomError(fieldPath: string): void {\n        const useMessageManager = this.host.getProperty(\"useMessageManager\") as boolean;\n        const stateManager = this.host.getStateManager();\n        if (useMessageManager && stateManager) {\n            const messageManager = Messaging;\n            const messages = messageManager.getMessageModel().getData();\n            const target = `/${fieldPath.replace(/^\\//, \"\")}`;\n\n            const messageToRemove = messages.find((m: any) =>\n                m.getTarget() === target && m.getMessageProcessor() && m.getMessageProcessor().getId() === stateManager.getModel().getId()\n            );\n            if (messageToRemove) {\n                messageManager.removeMessages(messageToRemove);\n            }\n        }\n    }\n\n    /**\n     * Triggers a visual Error Page (Crash Boundary) when generation catastrophically fails.\n     */\n    public mountCrashBoundary(error: Error): void {\n        Logger.error(\"[MetaUI] Engine failed to generate layout. Preventing Launchpad crash.\", error.message, \"ValidationDelegate\");\n\n        const errorPage = new MessagePage({\n            text: \"UI Generation Failed\",\n            description: \"The dynamic schema could not be rendered. Please check the Fiori console for diagnostic logs.\",\n            icon: \"sap-icon://error\"\n        });\n\n        this.host.setAggregation(\"_content\", errorPage);\n    }\n}\n"],"mappings":";;;QAISA,MAAM,GAAAC,iBAAA;EASf;AACA;AACA;EACO,MAAMC,kBAAkB,CAAC;IAG5BC,WAAWA,CAACC,IAAqB,EAAE;MAC/B,IAAI,CAACA,IAAI,GAAGA,IAAI;IACpB;;IAEA;AACJ;AACA;IACWC,cAAcA,CAACC,OAAgB,EAAQ;MAC1C,IAAI,IAAI,CAACF,IAAI,CAACG,WAAW,CAAC,mBAAmB,CAAC,EAAE;QAC5CC,SAAS,CAACH,cAAc,CAACC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;MAC7C;IACJ;;IAEA;AACJ;AACA;IACWG,gBAAgBA,CAACH,OAAgB,EAAQ;MAC5C,IAAI,IAAI,CAACF,IAAI,CAACG,WAAW,CAAC,mBAAmB,CAAC,EAAE;QAC5CC,SAAS,CAACC,gBAAgB,CAACH,OAAO,CAAC;MACvC;IACJ;;IAEA;AACJ;AACA;IACWI,iBAAiBA,CAAA,EAAS;MAC7B,IAAI,IAAI,CAACN,IAAI,CAACG,WAAW,CAAC,mBAAmB,CAAC,EAAE;QAC5CC,SAAS,CAACE,iBAAiB,CAAC,CAAC;MACjC;IACJ;;IAEA;AACJ;AACA;IACWC,WAAWA,CAACC,IAAY,EAAEC,IAAY,EAAQ;MACjD,MAAMC,UAAU,GAAGF,IAAI,GAAG,IAAIA,IAAI,CAACG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE;MAC5D,MAAMC,WAAW,GAAGJ,IAAI,GAAG,UAAUA,IAAI,MAAMC,IAAI,EAAE,GAAGA,IAAI;MAE5D,IAAID,IAAI,EAAE;QACNZ,MAAM,CAACiB,IAAI,CAAC,6BAA6BD,WAAW,EAAE,CAAC;MAC3D,CAAC,MAAM;QACHhB,MAAM,CAACiB,IAAI,CAAC,sCAAsCJ,IAAI,EAAE,CAAC;MAC7D;MAEA,IAAI,IAAI,CAACT,IAAI,CAACG,WAAW,CAAC,mBAAmB,CAAC,EAAE;QAC5CW,GAAG,CAACC,EAAE,CAACC,OAAO,CAAC,CAAC,6BAA6B,CAAC,EAAGC,YAAiB,IAAK;UACnE,MAAMC,cAAc,GAAGd,SAAS;UAChC,MAAMe,YAAY,GAAG,IAAI,CAACnB,IAAI,CAACoB,eAAe,CAAC,CAAC;UAChDF,cAAc,CAACG,WAAW,CAAC,IAAIJ,YAAY,CAAC;YACxCK,OAAO,EAAEV,WAAW;YACpBW,IAAI,EAAE,OAAkB;YACxBC,MAAM,EAAEd,UAAU;YAClBe,SAAS,EAAEN,YAAY,EAAEO,QAAQ,CAAC;UACtC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;MACN;IACJ;;IAEA;AACJ;AACA;IACWC,cAAcA,CAACC,SAAiB,EAAEN,OAAe,EAAQ;MAC5D,MAAMO,iBAAiB,GAAG,IAAI,CAAC7B,IAAI,CAACG,WAAW,CAAC,mBAAmB,CAAY;MAC/E,MAAMgB,YAAY,GAAG,IAAI,CAACnB,IAAI,CAACoB,eAAe,CAAC,CAAC;MAChD,IAAIS,iBAAiB,IAAIV,YAAY,EAAE;QACnCL,GAAG,CAACC,EAAE,CAACC,OAAO,CAAC,CAAC,6BAA6B,CAAC,EAAGC,YAAiB,IAAK;UACnE,MAAMC,cAAc,GAAGd,SAAS;UAChCc,cAAc,CAACG,WAAW,CAAC,IAAIJ,YAAY,CAAC;YACxCK,OAAO,EAAEA,OAAO;YAChBC,IAAI,EAAE,OAAkB;YACxBC,MAAM,EAAE,IAAII,SAAS,CAACjB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;YAC1Cc,SAAS,EAAEN,YAAY,CAACO,QAAQ,CAAC;UACrC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;MACN;IACJ;;IAEA;AACJ;AACA;IACWI,gBAAgBA,CAACF,SAAiB,EAAQ;MAC7C,MAAMC,iBAAiB,GAAG,IAAI,CAAC7B,IAAI,CAACG,WAAW,CAAC,mBAAmB,CAAY;MAC/E,MAAMgB,YAAY,GAAG,IAAI,CAACnB,IAAI,CAACoB,eAAe,CAAC,CAAC;MAChD,IAAIS,iBAAiB,IAAIV,YAAY,EAAE;QACnC,MAAMD,cAAc,GAAGd,SAAS;QAChC,MAAM2B,QAAQ,GAAGb,cAAc,CAACc,eAAe,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC;QAC3D,MAAMT,MAAM,GAAG,IAAII,SAAS,CAACjB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;QAEjD,MAAMuB,eAAe,GAAGH,QAAQ,CAACI,IAAI,CAAEC,CAAM,IACzCA,CAAC,CAACC,SAAS,CAAC,CAAC,KAAKb,MAAM,IAAIY,CAAC,CAACE,mBAAmB,CAAC,CAAC,IAAIF,CAAC,CAACE,mBAAmB,CAAC,CAAC,CAACC,KAAK,CAAC,CAAC,KAAKpB,YAAY,CAACO,QAAQ,CAAC,CAAC,CAACa,KAAK,CAAC,CAC7H,CAAC;QACD,IAAIL,eAAe,EAAE;UACjBhB,cAAc,CAACsB,cAAc,CAACN,eAAe,CAAC;QAClD;MACJ;IACJ;;IAEA;AACJ;AACA;IACWO,kBAAkBA,CAACC,KAAY,EAAQ;MAC1C9C,MAAM,CAAC8C,KAAK,CAAC,wEAAwE,EAAEA,KAAK,CAACpB,OAAO,EAAE,oBAAoB,CAAC;MAE3H,MAAMqB,SAAS,GAAG,IAAIC,WAAW,CAAC;QAC9BnC,IAAI,EAAE,sBAAsB;QAC5BoC,WAAW,EAAE,+FAA+F;QAC5GC,IAAI,EAAE;MACV,CAAC,CAAC;MAEF,IAAI,CAAC9C,IAAI,CAAC+C,cAAc,CAAC,UAAU,EAAEJ,SAAS,CAAC;IACnD;EACJ;EAAC,IAAAK,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAlD,kBAAA,GAAAA,kBAAA;EAAA,OAAAkD,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate.d.ts

@@ -0,0 +1,45 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate" {
+    import Control from "sap/ui/core/Control";
+    import { StateManager } from "nz/co/siliconst/ui5/metaui/core/StateManager";
+    export interface IHostValidation {
+        getProperty(name: string): unknown;
+        setAggregation(aggregationName: string, object: any, suppressInvalidate?: boolean): any;
+        getStateManager(): StateManager | null;
+    }
+    /**
+     * Handles Fiori MessageManager integration and provides a standardized Error Boundary UI fallback.
+     */
+    export class ValidationDelegate {
+        private host;
+        constructor(host: IHostValidation);
+        /**
+         * Registers a control and all its children with the global MessageManager.
+         */
+        registerObject(control: Control): void;
+        /**
+         * Unregisters a control from the global MessageManager.
+         */
+        unregisterObject(control: Control): void;
+        /**
+         * Clears all messages from the global MessageManager.
+         */
+        removeAllMessages(): void;
+        /**
+         * Pushes a validation message to the console, and optionally to the MessageManager.
+         */
+        pushMessage(path: string, text: string): void;
+        /**
+         * Imperatively invalidates a field and highlights it with an error message.
+         */
+        addCustomError(fieldPath: string, message: string): void;
+        /**
+         * Reverts a custom error state on a field.
+         */
+        clearCustomError(fieldPath: string): void;
+        /**
+         * Triggers a visual Error Page (Crash Boundary) when generation catastrophically fails.
+         */
+        mountCrashBoundary(error: Error): void;
+    }
+}
+//# sourceMappingURL=ValidationDelegate.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationDelegate.d.ts","sourceRoot":"../../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uEAAuE,CAAC;IAGvF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;IAI5E,UAAiB,eAAe;QAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACnC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,GAAG,CAAC;QACxF,eAAe,IAAI,YAAY,GAAG,IAAI,CAAC;KAC1C;IAED;;OAEG;IACH,MAAa,kBAAkB;QAC3B,OAAO,CAAC,IAAI,CAAkB;oBAElB,IAAI,EAAE,eAAe;QAIjC;;WAEG;QACI,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;QAM7C;;WAEG;QACI,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;QAM/C;;WAEG;QACI,iBAAiB,IAAI,IAAI;QAMhC;;WAEG;QACI,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;QAwBpD;;WAEG;QACI,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;QAgB/D;;WAEG;QACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;QAiBhD;;WAEG;QACI,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;KAWhD;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate.js

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/m/MessagePage","sap/ui/core/Messaging","../../../utils/Logger"],function(e,s,t){"use strict";const r=t["Logger"];class a{constructor(e){this.host=e}registerObject(e){if(this.host.getProperty("useMessageManager")){s.registerObject(e,true)}}unregisterObject(e){if(this.host.getProperty("useMessageManager")){s.unregisterObject(e)}}removeAllMessages(){if(this.host.getProperty("useMessageManager")){s.removeAllMessages()}}pushMessage(e,t){const a=e?`/${e.replace(/^\//,"")}`:"";const o=e?`Field '${e}': ${t}`:t;if(e){r.warn(`[MetaUI Validation Error] ${o}`)}else{r.warn(`[MetaUI Validation Error] Global - ${t}`)}if(this.host.getProperty("useMessageManager")){sap.ui.require(["sap/ui/core/message/Message"],e=>{const t=s;const r=this.host.getStateManager();t.addMessages(new e({message:o,type:"Error",target:a,processor:r?.getModel()}))})}}addCustomError(e,t){const r=this.host.getProperty("useMessageManager");const a=this.host.getStateManager();if(r&&a){sap.ui.require(["sap/ui/core/message/Message"],r=>{const o=s;o.addMessages(new r({message:t,type:"Error",target:`/${e.replace(/^\//,"")}`,processor:a.getModel()}))})}}clearCustomError(e){const t=this.host.getProperty("useMessageManager");const r=this.host.getStateManager();if(t&&r){const t=s;const a=t.getMessageModel().getData();const o=`/${e.replace(/^\//,"")}`;const g=a.find(e=>e.getTarget()===o&&e.getMessageProcessor()&&e.getMessageProcessor().getId()===r.getModel().getId());if(g){t.removeMessages(g)}}}mountCrashBoundary(s){r.error("[MetaUI] Engine failed to generate layout. Preventing Launchpad crash.",s.message,"ValidationDelegate");const t=new e({text:"UI Generation Failed",description:"The dynamic schema could not be rendered. Please check the Fiori console for diagnostic logs.",icon:"sap-icon://error"});this.host.setAggregation("_content",t)}}var o={__esModule:true};o.ValidationDelegate=a;return o});
+//# sourceMappingURL=ValidationDelegate.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationDelegate.js","names":["Logger","_____utils_Logger","ValidationDelegate","constructor","host","this","registerObject","control","getProperty","Messaging","unregisterObject","removeAllMessages","pushMessage","path","text","targetPath","replace","displayText","warn","sap","ui","require","MessageClass","messageManager","stateManager","getStateManager","addMessages","message","type","target","processor","getModel","addCustomError","fieldPath","useMessageManager","clearCustomError","messages","getMessageModel","getData","messageToRemove","find","m","getTarget","getMessageProcessor","getId","removeMessages","mountCrashBoundary","error","errorPage","MessagePage","description","icon","setAggregation","__exports","__esModule"],"sources":["ValidationDelegate.ts"],"sourcesContent":["import MessagePage from \"sap/m/MessagePage\";\nimport Messaging from \"sap/ui/core/Messaging\";\nimport Control from \"sap/ui/core/Control\";\nimport { StateManager } from \"../../../core/StateManager\";\nimport { Logger } from \"../../../utils/Logger\";\nimport Message from \"sap/ui/core/message/Message\";\n\nexport interface IHostValidation {\n    getProperty(name: string): unknown;\n    setAggregation(aggregationName: string, object: any, suppressInvalidate?: boolean): any;\n    getStateManager(): StateManager | null;\n}\n\n/**\n * Handles Fiori MessageManager integration and provides a standardized Error Boundary UI fallback.\n */\nexport class ValidationDelegate {\n    private host: IHostValidation;\n\n    constructor(host: IHostValidation) {\n        this.host = host;\n    }\n\n    /**\n     * Registers a control and all its children with the global MessageManager.\n     */\n    public registerObject(control: Control): void {\n        if (this.host.getProperty(\"useMessageManager\")) {\n            Messaging.registerObject(control, true); // true = recurse all children\n        }\n    }\n\n    /**\n     * Unregisters a control from the global MessageManager.\n     */\n    public unregisterObject(control: Control): void {\n        if (this.host.getProperty(\"useMessageManager\")) {\n            Messaging.unregisterObject(control);\n        }\n    }\n\n    /**\n     * Clears all messages from the global MessageManager.\n     */\n    public removeAllMessages(): void {\n        if (this.host.getProperty(\"useMessageManager\")) {\n            Messaging.removeAllMessages();\n        }\n    }\n\n    /**\n     * Pushes a validation message to the console, and optionally to the MessageManager.\n     */\n    public pushMessage(path: string, text: string): void {\n        const targetPath = path ? `/${path.replace(/^\\//, \"\")}` : \"\";\n        const displayText = path ? `Field '${path}': ${text}` : text;\n\n        if (path) {\n            Logger.warn(`[MetaUI Validation Error] ${displayText}`);\n        } else {\n            Logger.warn(`[MetaUI Validation Error] Global - ${text}`);\n        }\n\n        if (this.host.getProperty(\"useMessageManager\")) {\n            sap.ui.require([\"sap/ui/core/message/Message\"], (MessageClass: any) => {\n                const messageManager = Messaging;\n                const stateManager = this.host.getStateManager();\n                messageManager.addMessages(new MessageClass({\n                    message: displayText,\n                    type: \"Error\" as unknown,\n                    target: targetPath,\n                    processor: stateManager?.getModel()\n                }));\n            });\n        }\n    }\n\n    /**\n     * Imperatively invalidates a field and highlights it with an error message.\n     */\n    public addCustomError(fieldPath: string, message: string): void {\n        const useMessageManager = this.host.getProperty(\"useMessageManager\") as boolean;\n        const stateManager = this.host.getStateManager();\n        if (useMessageManager && stateManager) {\n            sap.ui.require([\"sap/ui/core/message/Message\"], (MessageClass: any) => {\n                const messageManager = Messaging;\n                messageManager.addMessages(new MessageClass({\n                    message: message,\n                    type: \"Error\" as unknown,\n                    target: `/${fieldPath.replace(/^\\//, \"\")}`,\n                    processor: stateManager.getModel()\n                }));\n            });\n        }\n    }\n\n    /**\n     * Reverts a custom error state on a field.\n     */\n    public clearCustomError(fieldPath: string): void {\n        const useMessageManager = this.host.getProperty(\"useMessageManager\") as boolean;\n        const stateManager = this.host.getStateManager();\n        if (useMessageManager && stateManager) {\n            const messageManager = Messaging;\n            const messages = messageManager.getMessageModel().getData();\n            const target = `/${fieldPath.replace(/^\\//, \"\")}`;\n\n            const messageToRemove = messages.find((m: any) =>\n                m.getTarget() === target && m.getMessageProcessor() && m.getMessageProcessor().getId() === stateManager.getModel().getId()\n            );\n            if (messageToRemove) {\n                messageManager.removeMessages(messageToRemove);\n            }\n        }\n    }\n\n    /**\n     * Triggers a visual Error Page (Crash Boundary) when generation catastrophically fails.\n     */\n    public mountCrashBoundary(error: Error): void {\n        Logger.error(\"[MetaUI] Engine failed to generate layout. Preventing Launchpad crash.\", error.message, \"ValidationDelegate\");\n\n        const errorPage = new MessagePage({\n            text: \"UI Generation Failed\",\n            description: \"The dynamic schema could not be rendered. Please check the Fiori console for diagnostic logs.\",\n            icon: \"sap-icon://error\"\n        });\n\n        this.host.setAggregation(\"_content\", errorPage);\n    }\n}\n"],"mappings":"uHAISA,EAAMC,EAAA,UAYR,MAAMC,EAGTC,YAAYC,GACRC,KAAKD,KAAOA,CAChB,CAKOE,eAAeC,GAClB,GAAIF,KAAKD,KAAKI,YAAY,qBAAsB,CAC5CC,EAAUH,eAAeC,EAAS,KACtC,CACJ,CAKOG,iBAAiBH,GACpB,GAAIF,KAAKD,KAAKI,YAAY,qBAAsB,CAC5CC,EAAUC,iBAAiBH,EAC/B,CACJ,CAKOI,oBACH,GAAIN,KAAKD,KAAKI,YAAY,qBAAsB,CAC5CC,EAAUE,mBACd,CACJ,CAKOC,YAAYC,EAAcC,GAC7B,MAAMC,EAAaF,EAAO,IAAIA,EAAKG,QAAQ,MAAO,MAAQ,GAC1D,MAAMC,EAAcJ,EAAO,UAAUA,OAAUC,IAASA,EAExD,GAAID,EAAM,CACNb,EAAOkB,KAAK,6BAA6BD,IAC7C,KAAO,CACHjB,EAAOkB,KAAK,sCAAsCJ,IACtD,CAEA,GAAIT,KAAKD,KAAKI,YAAY,qBAAsB,CAC5CW,IAAIC,GAAGC,QAAQ,CAAC,+BAAiCC,IAC7C,MAAMC,EAAiBd,EACvB,MAAMe,EAAenB,KAAKD,KAAKqB,kBAC/BF,EAAeG,YAAY,IAAIJ,EAAa,CACxCK,QAASV,EACTW,KAAM,QACNC,OAAQd,EACRe,UAAWN,GAAcO,eAGrC,CACJ,CAKOC,eAAeC,EAAmBN,GACrC,MAAMO,EAAoB7B,KAAKD,KAAKI,YAAY,qBAChD,MAAMgB,EAAenB,KAAKD,KAAKqB,kBAC/B,GAAIS,GAAqBV,EAAc,CACnCL,IAAIC,GAAGC,QAAQ,CAAC,+BAAiCC,IAC7C,MAAMC,EAAiBd,EACvBc,EAAeG,YAAY,IAAIJ,EAAa,CACxCK,QAASA,EACTC,KAAM,QACNC,OAAQ,IAAII,EAAUjB,QAAQ,MAAO,MACrCc,UAAWN,EAAaO,eAGpC,CACJ,CAKOI,iBAAiBF,GACpB,MAAMC,EAAoB7B,KAAKD,KAAKI,YAAY,qBAChD,MAAMgB,EAAenB,KAAKD,KAAKqB,kBAC/B,GAAIS,GAAqBV,EAAc,CACnC,MAAMD,EAAiBd,EACvB,MAAM2B,EAAWb,EAAec,kBAAkBC,UAClD,MAAMT,EAAS,IAAII,EAAUjB,QAAQ,MAAO,MAE5C,MAAMuB,EAAkBH,EAASI,KAAMC,GACnCA,EAAEC,cAAgBb,GAAUY,EAAEE,uBAAyBF,EAAEE,sBAAsBC,UAAYpB,EAAaO,WAAWa,SAEvH,GAAIL,EAAiB,CACjBhB,EAAesB,eAAeN,EAClC,CACJ,CACJ,CAKOO,mBAAmBC,GACtB/C,EAAO+C,MAAM,yEAA0EA,EAAMpB,QAAS,sBAEtG,MAAMqB,EAAY,IAAIC,EAAY,CAC9BnC,KAAM,uBACNoC,YAAa,gGACbC,KAAM,qBAGV9C,KAAKD,KAAKgD,eAAe,WAAYJ,EACzC,EACH,IAAAK,EAAA,CAAAC,WAAA,MAAAD,EAAAnD,qBAAA,OAAAmD,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ValidationDelegate.ts

@@ -0,0 +1,131 @@
+import MessagePage from "sap/m/MessagePage";
+import Messaging from "sap/ui/core/Messaging";
+import Control from "sap/ui/core/Control";
+import { StateManager } from "../../../core/StateManager";
+import { Logger } from "../../../utils/Logger";
+import Message from "sap/ui/core/message/Message";
+
+export interface IHostValidation {
+    getProperty(name: string): unknown;
+    setAggregation(aggregationName: string, object: any, suppressInvalidate?: boolean): any;
+    getStateManager(): StateManager | null;
+}
+
+/**
+ * Handles Fiori MessageManager integration and provides a standardized Error Boundary UI fallback.
+ */
+export class ValidationDelegate {
+    private host: IHostValidation;
+
+    constructor(host: IHostValidation) {
+        this.host = host;
+    }
+
+    /**
+     * Registers a control and all its children with the global MessageManager.
+     */
+    public registerObject(control: Control): void {
+        if (this.host.getProperty("useMessageManager")) {
+            Messaging.registerObject(control, true); // true = recurse all children
+        }
+    }
+
+    /**
+     * Unregisters a control from the global MessageManager.
+     */
+    public unregisterObject(control: Control): void {
+        if (this.host.getProperty("useMessageManager")) {
+            Messaging.unregisterObject(control);
+        }
+    }
+
+    /**
+     * Clears all messages from the global MessageManager.
+     */
+    public removeAllMessages(): void {
+        if (this.host.getProperty("useMessageManager")) {
+            Messaging.removeAllMessages();
+        }
+    }
+
+    /**
+     * Pushes a validation message to the console, and optionally to the MessageManager.
+     */
+    public pushMessage(path: string, text: string): void {
+        const targetPath = path ? `/${path.replace(/^\//, "")}` : "";
+        const displayText = path ? `Field '${path}': ${text}` : text;
+
+        if (path) {
+            Logger.warn(`[MetaUI Validation Error] ${displayText}`);
+        } else {
+            Logger.warn(`[MetaUI Validation Error] Global - ${text}`);
+        }
+
+        if (this.host.getProperty("useMessageManager")) {
+            sap.ui.require(["sap/ui/core/message/Message"], (MessageClass: any) => {
+                const messageManager = Messaging;
+                const stateManager = this.host.getStateManager();
+                messageManager.addMessages(new MessageClass({
+                    message: displayText,
+                    type: "Error" as unknown,
+                    target: targetPath,
+                    processor: stateManager?.getModel()
+                }));
+            });
+        }
+    }
+
+    /**
+     * Imperatively invalidates a field and highlights it with an error message.
+     */
+    public addCustomError(fieldPath: string, message: string): void {
+        const useMessageManager = this.host.getProperty("useMessageManager") as boolean;
+        const stateManager = this.host.getStateManager();
+        if (useMessageManager && stateManager) {
+            sap.ui.require(["sap/ui/core/message/Message"], (MessageClass: any) => {
+                const messageManager = Messaging;
+                messageManager.addMessages(new MessageClass({
+                    message: message,
+                    type: "Error" as unknown,
+                    target: `/${fieldPath.replace(/^\//, "")}`,
+                    processor: stateManager.getModel()
+                }));
+            });
+        }
+    }
+
+    /**
+     * Reverts a custom error state on a field.
+     */
+    public clearCustomError(fieldPath: string): void {
+        const useMessageManager = this.host.getProperty("useMessageManager") as boolean;
+        const stateManager = this.host.getStateManager();
+        if (useMessageManager && stateManager) {
+            const messageManager = Messaging;
+            const messages = messageManager.getMessageModel().getData();
+            const target = `/${fieldPath.replace(/^\//, "")}`;
+
+            const messageToRemove = messages.find((m: any) =>
+                m.getTarget() === target && m.getMessageProcessor() && m.getMessageProcessor().getId() === stateManager.getModel().getId()
+            );
+            if (messageToRemove) {
+                messageManager.removeMessages(messageToRemove);
+            }
+        }
+    }
+
+    /**
+     * Triggers a visual Error Page (Crash Boundary) when generation catastrophically fails.
+     */
+    public mountCrashBoundary(error: Error): void {
+        Logger.error("[MetaUI] Engine failed to generate layout. Preventing Launchpad crash.", error.message, "ValidationDelegate");
+
+        const errorPage = new MessagePage({
+            text: "UI Generation Failed",
+            description: "The dynamic schema could not be rendered. Please check the Fiori console for diagnostic logs.",
+            icon: "sap-icon://error"
+        });
+
+        this.host.setAggregation("_content", errorPage);
+    }
+}