@siliconst/metaui 1.2.0 → 1.4.5

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/ODataDelegate-dbg.js

@@ -0,0 +1,122 @@
+sap.ui.define(["../../../utils/Logger"], function (_____utils_Logger) {
+  "use strict";
+
+  const Logger = _____utils_Logger["Logger"];
+  /**
+   * Universal OData Delegate.
+   * Natively detects and manages two-way synchronization for both OData V2 and V4 contexts
+   * without requiring controller-level mappings.
+   */
+  class ODataDelegate {
+    odataType = null;
+    isSyncing = false;
+
+    /**
+     * Initializes a new instance of the ODataDelegate.
+     * 
+     * @param {DynamicHost} host The parent MetaUI DynamicHost instance managing the UI generation.
+     * @param {Context} context The active UI5 Model Context bound to the host.
+     */
+    constructor(host, context) {
+      this.host = host;
+      this.context = context;
+      this.detectODataType();
+    }
+
+    /**
+     * Evaluates the underlying UI5 Model bound to the context to determine if it is an
+     * OData V2 or OData V4 model. This determination drives the synchronization strategy.
+     * 
+     * @private
+     */
+    detectODataType() {
+      const model = this.context.getModel();
+      // sap.ui.model.odata.v4.ODataModel
+      // sap.ui.model.odata.v2.ODataModel
+      const sClassName = model.getMetadata().getName();
+      if (sClassName.indexOf("v4") > -1) {
+        this.odataType = "V4";
+      } else if (sClassName.indexOf("v2") > -1 || sClassName.indexOf("ODataModel") > -1) {
+        this.odataType = "V2";
+      }
+    }
+
+    /**
+     * Extracts the full entity payload from the bound OData context and pushes it to the Engine.
+     * V4 uses an asynchronous requestObject(), while V2 retrieves it synchronously.
+     * 
+     * @public
+     */
+    syncToEngine() {
+      if (!this.odataType) return;
+      if (this.odataType === "V4") {
+        // V4 uses async requestObject()
+        if (typeof this.context.requestObject === "function") {
+          this.context.requestObject().then(oData => {
+            this.pushPayload(oData);
+          }).catch(err => {
+            Logger.error("[MetaUI]", "Failed to extract V4 Context payload: " + err.message, "ODataDelegate");
+          });
+        }
+      } else if (this.odataType === "V2") {
+        // V2 uses sync getObject()
+        const oData = this.context.getObject();
+        if (oData) {
+          this.pushPayload(oData);
+        }
+      }
+    }
+
+    /**
+     * Cleans the raw OData payload by stripping framework metadata properties (keys starting with '@' or '__')
+     * and pushes the sanitized business data into the MetaUI DynamicHost state manager.
+     * 
+     * @param {any} oData The raw JSON object extracted from the OData model context.
+     * @private
+     */
+    pushPayload(oData) {
+      if (!oData) return;
+
+      // Remove OData metadata properties before pushing to MetaUI
+      const cleanData = {
+        ...oData
+      };
+      for (const key of Object.keys(cleanData)) {
+        if (key.startsWith("@") || key.startsWith("__")) {
+          delete cleanData[key];
+        }
+      }
+      this.isSyncing = true;
+      this.host.setProperty("data", cleanData);
+      this.isSyncing = false;
+    }
+
+    /**
+     * Intercepts a field change from the MetaUI Engine and translates it into an OData PATCH.
+     */
+    handleFieldChange(fieldPath, value) {
+      if (this.isSyncing || !this.odataType) return;
+      try {
+        if (this.odataType === "V4") {
+          // V4 sets property directly on context
+          this.context.setProperty(fieldPath, value);
+        } else if (this.odataType === "V2") {
+          // V2 sets property on model, specifying the context path
+          const model = this.context.getModel();
+          model.setProperty(fieldPath, value, this.context);
+        }
+        if (this.host.getProperty("debugMode")) {
+          Logger.debug("[MetaUI]", `ODataDelegate Patched ${fieldPath} = ${value} via ${this.odataType}`, "ODataDelegate");
+        }
+      } catch (e) {
+        Logger.error("[MetaUI]", `Failed to patch OData context: ${e.message}`, "ODataDelegate");
+      }
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.ODataDelegate = ODataDelegate;
+  return __exports;
+});
+//# sourceMappingURL=ODataDelegate-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ODataDelegate-dbg.js","names":["Logger","_____utils_Logger","ODataDelegate","odataType","isSyncing","constructor","host","context","detectODataType","model","getModel","sClassName","getMetadata","getName","indexOf","syncToEngine","requestObject","then","oData","pushPayload","catch","err","error","message","getObject","cleanData","key","Object","keys","startsWith","setProperty","handleFieldChange","fieldPath","value","getProperty","debug","e","__exports","__esModule"],"sources":["ODataDelegate.ts"],"sourcesContent":["import { DynamicHost } from \"../DynamicHost\";\nimport Context from \"sap/ui/model/Context\";\nimport { Logger } from \"../../../utils/Logger\";\n\n/**\n * Universal OData Delegate.\n * Natively detects and manages two-way synchronization for both OData V2 and V4 contexts\n * without requiring controller-level mappings.\n */\nexport class ODataDelegate {\n    private host: DynamicHost;\n    private context: Context;\n    private odataType: \"V2\" | \"V4\" | null = null;\n    private isSyncing: boolean = false;\n\n    /**\n     * Initializes a new instance of the ODataDelegate.\n     * \n     * @param {DynamicHost} host The parent MetaUI DynamicHost instance managing the UI generation.\n     * @param {Context} context The active UI5 Model Context bound to the host.\n     */\n    constructor(host: DynamicHost, context: Context) {\n        this.host = host;\n        this.context = context;\n        this.detectODataType();\n    }\n\n    /**\n     * Evaluates the underlying UI5 Model bound to the context to determine if it is an\n     * OData V2 or OData V4 model. This determination drives the synchronization strategy.\n     * \n     * @private\n     */\n    private detectODataType(): void {\n        const model = this.context.getModel();\n        // sap.ui.model.odata.v4.ODataModel\n        // sap.ui.model.odata.v2.ODataModel\n        const sClassName = model.getMetadata().getName();\n        if (sClassName.indexOf(\"v4\") > -1) {\n            this.odataType = \"V4\";\n        } else if (sClassName.indexOf(\"v2\") > -1 || sClassName.indexOf(\"ODataModel\") > -1) {\n            this.odataType = \"V2\";\n        }\n    }\n\n    /**\n     * Extracts the full entity payload from the bound OData context and pushes it to the Engine.\n     * V4 uses an asynchronous requestObject(), while V2 retrieves it synchronously.\n     * \n     * @public\n     */\n    public syncToEngine(): void {\n        if (!this.odataType) return;\n\n        if (this.odataType === \"V4\") {\n            // V4 uses async requestObject()\n            if (typeof (this.context as any).requestObject === \"function\") {\n                (this.context as any).requestObject().then((oData: any) => {\n                    this.pushPayload(oData);\n                }).catch((err: Error) => {\n                    Logger.error(\"[MetaUI]\", \"Failed to extract V4 Context payload: \" + err.message, \"ODataDelegate\");\n                });\n            }\n        } else if (this.odataType === \"V2\") {\n            // V2 uses sync getObject()\n            const oData = this.context.getObject();\n            if (oData) {\n                this.pushPayload(oData);\n            }\n        }\n    }\n\n    /**\n     * Cleans the raw OData payload by stripping framework metadata properties (keys starting with '@' or '__')\n     * and pushes the sanitized business data into the MetaUI DynamicHost state manager.\n     * \n     * @param {any} oData The raw JSON object extracted from the OData model context.\n     * @private\n     */\n    private pushPayload(oData: any): void {\n        if (!oData) return;\n        \n        // Remove OData metadata properties before pushing to MetaUI\n        const cleanData = { ...oData };\n        for (const key of Object.keys(cleanData)) {\n            if (key.startsWith(\"@\") || key.startsWith(\"__\")) {\n                delete cleanData[key];\n            }\n        }\n\n        this.isSyncing = true;\n        this.host.setProperty(\"data\", cleanData);\n        this.isSyncing = false;\n    }\n\n    /**\n     * Intercepts a field change from the MetaUI Engine and translates it into an OData PATCH.\n     */\n    public handleFieldChange(fieldPath: string, value: any): void {\n        if (this.isSyncing || !this.odataType) return;\n\n        try {\n            if (this.odataType === \"V4\") {\n                // V4 sets property directly on context\n                this.context.setProperty(fieldPath, value);\n            } else if (this.odataType === \"V2\") {\n                // V2 sets property on model, specifying the context path\n                const model = this.context.getModel();\n                model.setProperty(fieldPath, value, this.context);\n            }\n            if (this.host.getProperty(\"debugMode\")) {\n                Logger.debug(\"[MetaUI]\", `ODataDelegate Patched ${fieldPath} = ${value} via ${this.odataType}`, \"ODataDelegate\");\n            }\n        } catch (e) {\n            Logger.error(\"[MetaUI]\", `Failed to patch OData context: ${(e as Error).message}`, \"ODataDelegate\");\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,49 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/host/delegates/ODataDelegate" {
+    import { DynamicHost } from "nz/co/siliconst/ui5/metaui/controls/host/DynamicHost";
+    import Context from "sap/ui/model/Context";
+    /**
+     * Universal OData Delegate.
+     * Natively detects and manages two-way synchronization for both OData V2 and V4 contexts
+     * without requiring controller-level mappings.
+     */
+    export class ODataDelegate {
+        private host;
+        private context;
+        private odataType;
+        private isSyncing;
+        /**
+         * Initializes a new instance of the ODataDelegate.
+         *
+         * @param {DynamicHost} host The parent MetaUI DynamicHost instance managing the UI generation.
+         * @param {Context} context The active UI5 Model Context bound to the host.
+         */
+        constructor(host: DynamicHost, context: Context);
+        /**
+         * Evaluates the underlying UI5 Model bound to the context to determine if it is an
+         * OData V2 or OData V4 model. This determination drives the synchronization strategy.
+         *
+         * @private
+         */
+        private detectODataType;
+        /**
+         * Extracts the full entity payload from the bound OData context and pushes it to the Engine.
+         * V4 uses an asynchronous requestObject(), while V2 retrieves it synchronously.
+         *
+         * @public
+         */
+        syncToEngine(): void;
+        /**
+         * Cleans the raw OData payload by stripping framework metadata properties (keys starting with '@' or '__')
+         * and pushes the sanitized business data into the MetaUI DynamicHost state manager.
+         *
+         * @param {any} oData The raw JSON object extracted from the OData model context.
+         * @private
+         */
+        private pushPayload;
+        /**
+         * Intercepts a field change from the MetaUI Engine and translates it into an OData PATCH.
+         */
+        handleFieldChange(fieldPath: string, value: any): void;
+    }
+}
+//# sourceMappingURL=ODataDelegate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ODataDelegate.d.ts","sourceRoot":"../../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/host/delegates/ODataDelegate.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,kEAAkE,CAAC;IAClF,OAAO,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;IACnF,OAAO,OAAO,MAAM,sBAAsB,CAAC;IAG3C;;;;OAIG;IACH,MAAa,aAAa;QACtB,OAAO,CAAC,IAAI,CAAc;QAC1B,OAAO,CAAC,OAAO,CAAU;QACzB,OAAO,CAAC,SAAS,CAA4B;QAC7C,OAAO,CAAC,SAAS,CAAkB;QAEnC;;;;;WAKG;oBACS,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO;QAM/C;;;;;WAKG;QACH,OAAO,CAAC,eAAe;QAYvB;;;;;WAKG;QACI,YAAY,IAAI,IAAI;QAqB3B;;;;;;WAMG;QACH,OAAO,CAAC,WAAW;QAgBnB;;WAEG;QACI,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;KAmBhE;CAEA"}

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

@@ -0,0 +1,2 @@
+sap.ui.define(["../../../utils/Logger"],function(t){"use strict";const e=t["Logger"];class a{odataType=null;isSyncing=false;constructor(t,e){this.host=t;this.context=e;this.detectODataType()}detectODataType(){const t=this.context.getModel();const e=t.getMetadata().getName();if(e.indexOf("v4")>-1){this.odataType="V4"}else if(e.indexOf("v2")>-1||e.indexOf("ODataModel")>-1){this.odataType="V2"}}syncToEngine(){if(!this.odataType)return;if(this.odataType==="V4"){if(typeof this.context.requestObject==="function"){this.context.requestObject().then(t=>{this.pushPayload(t)}).catch(t=>{e.error("[MetaUI]","Failed to extract V4 Context payload: "+t.message,"ODataDelegate")})}}else if(this.odataType==="V2"){const t=this.context.getObject();if(t){this.pushPayload(t)}}}pushPayload(t){if(!t)return;const e={...t};for(const t of Object.keys(e)){if(t.startsWith("@")||t.startsWith("__")){delete e[t]}}this.isSyncing=true;this.host.setProperty("data",e);this.isSyncing=false}handleFieldChange(t,a){if(this.isSyncing||!this.odataType)return;try{if(this.odataType==="V4"){this.context.setProperty(t,a)}else if(this.odataType==="V2"){const e=this.context.getModel();e.setProperty(t,a,this.context)}if(this.host.getProperty("debugMode")){e.debug("[MetaUI]",`ODataDelegate Patched ${t} = ${a} via ${this.odataType}`,"ODataDelegate")}}catch(t){e.error("[MetaUI]",`Failed to patch OData context: ${t.message}`,"ODataDelegate")}}}var s={__esModule:true};s.ODataDelegate=a;return s});
+//# sourceMappingURL=ODataDelegate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ODataDelegate.js","names":["Logger","_____utils_Logger","ODataDelegate","odataType","isSyncing","constructor","host","context","this","detectODataType","model","getModel","sClassName","getMetadata","getName","indexOf","syncToEngine","requestObject","then","oData","pushPayload","catch","err","error","message","getObject","cleanData","key","Object","keys","startsWith","setProperty","handleFieldChange","fieldPath","value","getProperty","debug","e","__exports","__esModule"],"sources":["ODataDelegate.ts"],"sourcesContent":["import { DynamicHost } from \"../DynamicHost\";\nimport Context from \"sap/ui/model/Context\";\nimport { Logger } from \"../../../utils/Logger\";\n\n/**\n * Universal OData Delegate.\n * Natively detects and manages two-way synchronization for both OData V2 and V4 contexts\n * without requiring controller-level mappings.\n */\nexport class ODataDelegate {\n    private host: DynamicHost;\n    private context: Context;\n    private odataType: \"V2\" | \"V4\" | null = null;\n    private isSyncing: boolean = false;\n\n    /**\n     * Initializes a new instance of the ODataDelegate.\n     * \n     * @param {DynamicHost} host The parent MetaUI DynamicHost instance managing the UI generation.\n     * @param {Context} context The active UI5 Model Context bound to the host.\n     */\n    constructor(host: DynamicHost, context: Context) {\n        this.host = host;\n        this.context = context;\n        this.detectODataType();\n    }\n\n    /**\n     * Evaluates the underlying UI5 Model bound to the context to determine if it is an\n     * OData V2 or OData V4 model. This determination drives the synchronization strategy.\n     * \n     * @private\n     */\n    private detectODataType(): void {\n        const model = this.context.getModel();\n        // sap.ui.model.odata.v4.ODataModel\n        // sap.ui.model.odata.v2.ODataModel\n        const sClassName = model.getMetadata().getName();\n        if (sClassName.indexOf(\"v4\") > -1) {\n            this.odataType = \"V4\";\n        } else if (sClassName.indexOf(\"v2\") > -1 || sClassName.indexOf(\"ODataModel\") > -1) {\n            this.odataType = \"V2\";\n        }\n    }\n\n    /**\n     * Extracts the full entity payload from the bound OData context and pushes it to the Engine.\n     * V4 uses an asynchronous requestObject(), while V2 retrieves it synchronously.\n     * \n     * @public\n     */\n    public syncToEngine(): void {\n        if (!this.odataType) return;\n\n        if (this.odataType === \"V4\") {\n            // V4 uses async requestObject()\n            if (typeof (this.context as any).requestObject === \"function\") {\n                (this.context as any).requestObject().then((oData: any) => {\n                    this.pushPayload(oData);\n                }).catch((err: Error) => {\n                    Logger.error(\"[MetaUI]\", \"Failed to extract V4 Context payload: \" + err.message, \"ODataDelegate\");\n                });\n            }\n        } else if (this.odataType === \"V2\") {\n            // V2 uses sync getObject()\n            const oData = this.context.getObject();\n            if (oData) {\n                this.pushPayload(oData);\n            }\n        }\n    }\n\n    /**\n     * Cleans the raw OData payload by stripping framework metadata properties (keys starting with '@' or '__')\n     * and pushes the sanitized business data into the MetaUI DynamicHost state manager.\n     * \n     * @param {any} oData The raw JSON object extracted from the OData model context.\n     * @private\n     */\n    private pushPayload(oData: any): void {\n        if (!oData) return;\n        \n        // Remove OData metadata properties before pushing to MetaUI\n        const cleanData = { ...oData };\n        for (const key of Object.keys(cleanData)) {\n            if (key.startsWith(\"@\") || key.startsWith(\"__\")) {\n                delete cleanData[key];\n            }\n        }\n\n        this.isSyncing = true;\n        this.host.setProperty(\"data\", cleanData);\n        this.isSyncing = false;\n    }\n\n    /**\n     * Intercepts a field change from the MetaUI Engine and translates it into an OData PATCH.\n     */\n    public handleFieldChange(fieldPath: string, value: any): void {\n        if (this.isSyncing || !this.odataType) return;\n\n        try {\n            if (this.odataType === \"V4\") {\n                // V4 sets property directly on context\n                this.context.setProperty(fieldPath, value);\n            } else if (this.odataType === \"V2\") {\n                // V2 sets property on model, specifying the context path\n                const model = this.context.getModel();\n                model.setProperty(fieldPath, value, this.context);\n            }\n            if (this.host.getProperty(\"debugMode\")) {\n                Logger.debug(\"[MetaUI]\", `ODataDelegate Patched ${fieldPath} = ${value} via ${this.odataType}`, \"ODataDelegate\");\n            }\n        } catch (e) {\n            Logger.error(\"[MetaUI]\", `Failed to patch OData context: ${(e as Error).message}`, \"ODataDelegate\");\n        }\n    }\n}\n"],"mappings":"uEAESA,EAAMC,EAAA,UAOR,MAAMC,EAGDC,UAAgC,KAChCC,UAAqB,MAQ7BC,YAAYC,EAAmBC,GAC3BC,KAAKF,KAAOA,EACZE,KAAKD,QAAUA,EACfC,KAAKC,iBACT,CAQQA,kBACJ,MAAMC,EAAQF,KAAKD,QAAQI,WAG3B,MAAMC,EAAaF,EAAMG,cAAcC,UACvC,GAAIF,EAAWG,QAAQ,OAAS,EAAG,CAC/BP,KAAKL,UAAY,IACrB,MAAO,GAAIS,EAAWG,QAAQ,OAAS,GAAKH,EAAWG,QAAQ,eAAiB,EAAG,CAC/EP,KAAKL,UAAY,IACrB,CACJ,CAQOa,eACH,IAAKR,KAAKL,UAAW,OAErB,GAAIK,KAAKL,YAAc,KAAM,CAEzB,UAAYK,KAAKD,QAAgBU,gBAAkB,WAAY,CAC1DT,KAAKD,QAAgBU,gBAAgBC,KAAMC,IACxCX,KAAKY,YAAYD,KAClBE,MAAOC,IACNtB,EAAOuB,MAAM,WAAY,yCAA2CD,EAAIE,QAAS,kBAEzF,CACJ,MAAO,GAAIhB,KAAKL,YAAc,KAAM,CAEhC,MAAMgB,EAAQX,KAAKD,QAAQkB,YAC3B,GAAIN,EAAO,CACPX,KAAKY,YAAYD,EACrB,CACJ,CACJ,CASQC,YAAYD,GAChB,IAAKA,EAAO,OAGZ,MAAMO,EAAY,IAAKP,GACvB,IAAK,MAAMQ,KAAOC,OAAOC,KAAKH,GAAY,CACtC,GAAIC,EAAIG,WAAW,MAAQH,EAAIG,WAAW,MAAO,QACtCJ,EAAUC,EACrB,CACJ,CAEAnB,KAAKJ,UAAY,KACjBI,KAAKF,KAAKyB,YAAY,OAAQL,GAC9BlB,KAAKJ,UAAY,KACrB,CAKO4B,kBAAkBC,EAAmBC,GACxC,GAAI1B,KAAKJ,YAAcI,KAAKL,UAAW,OAEvC,IACI,GAAIK,KAAKL,YAAc,KAAM,CAEzBK,KAAKD,QAAQwB,YAAYE,EAAWC,EACxC,MAAO,GAAI1B,KAAKL,YAAc,KAAM,CAEhC,MAAMO,EAAQF,KAAKD,QAAQI,WAC3BD,EAAMqB,YAAYE,EAAWC,EAAO1B,KAAKD,QAC7C,CACA,GAAIC,KAAKF,KAAK6B,YAAY,aAAc,CACpCnC,EAAOoC,MAAM,WAAY,yBAAyBH,OAAeC,SAAa1B,KAAKL,YAAa,gBACpG,CACJ,CAAE,MAAOkC,GACLrC,EAAOuB,MAAM,WAAY,kCAAmCc,EAAYb,UAAW,gBACvF,CACJ,EACH,IAAAc,EAAA,CAAAC,WAAA,MAAAD,EAAApC,gBAAA,OAAAoC,CAAA","ignoreList":[]}

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

@@ -0,0 +1,118 @@
+import { DynamicHost } from "../DynamicHost";
+import Context from "sap/ui/model/Context";
+import { Logger } from "../../../utils/Logger";
+
+/**
+ * Universal OData Delegate.
+ * Natively detects and manages two-way synchronization for both OData V2 and V4 contexts
+ * without requiring controller-level mappings.
+ */
+export class ODataDelegate {
+    private host: DynamicHost;
+    private context: Context;
+    private odataType: "V2" | "V4" | null = null;
+    private isSyncing: boolean = false;
+
+    /**
+     * Initializes a new instance of the ODataDelegate.
+     * 
+     * @param {DynamicHost} host The parent MetaUI DynamicHost instance managing the UI generation.
+     * @param {Context} context The active UI5 Model Context bound to the host.
+     */
+    constructor(host: DynamicHost, context: Context) {
+        this.host = host;
+        this.context = context;
+        this.detectODataType();
+    }
+
+    /**
+     * Evaluates the underlying UI5 Model bound to the context to determine if it is an
+     * OData V2 or OData V4 model. This determination drives the synchronization strategy.
+     * 
+     * @private
+     */
+    private detectODataType(): void {
+        const model = this.context.getModel();
+        // sap.ui.model.odata.v4.ODataModel
+        // sap.ui.model.odata.v2.ODataModel
+        const sClassName = model.getMetadata().getName();
+        if (sClassName.indexOf("v4") > -1) {
+            this.odataType = "V4";
+        } else if (sClassName.indexOf("v2") > -1 || sClassName.indexOf("ODataModel") > -1) {
+            this.odataType = "V2";
+        }
+    }
+
+    /**
+     * Extracts the full entity payload from the bound OData context and pushes it to the Engine.
+     * V4 uses an asynchronous requestObject(), while V2 retrieves it synchronously.
+     * 
+     * @public
+     */
+    public syncToEngine(): void {
+        if (!this.odataType) return;
+
+        if (this.odataType === "V4") {
+            // V4 uses async requestObject()
+            if (typeof (this.context as any).requestObject === "function") {
+                (this.context as any).requestObject().then((oData: any) => {
+                    this.pushPayload(oData);
+                }).catch((err: Error) => {
+                    Logger.error("[MetaUI]", "Failed to extract V4 Context payload: " + err.message, "ODataDelegate");
+                });
+            }
+        } else if (this.odataType === "V2") {
+            // V2 uses sync getObject()
+            const oData = this.context.getObject();
+            if (oData) {
+                this.pushPayload(oData);
+            }
+        }
+    }
+
+    /**
+     * Cleans the raw OData payload by stripping framework metadata properties (keys starting with '@' or '__')
+     * and pushes the sanitized business data into the MetaUI DynamicHost state manager.
+     * 
+     * @param {any} oData The raw JSON object extracted from the OData model context.
+     * @private
+     */
+    private pushPayload(oData: any): void {
+        if (!oData) return;
+        
+        // Remove OData metadata properties before pushing to MetaUI
+        const cleanData = { ...oData };
+        for (const key of Object.keys(cleanData)) {
+            if (key.startsWith("@") || key.startsWith("__")) {
+                delete cleanData[key];
+            }
+        }
+
+        this.isSyncing = true;
+        this.host.setProperty("data", cleanData);
+        this.isSyncing = false;
+    }
+
+    /**
+     * Intercepts a field change from the MetaUI Engine and translates it into an OData PATCH.
+     */
+    public handleFieldChange(fieldPath: string, value: any): void {
+        if (this.isSyncing || !this.odataType) return;
+
+        try {
+            if (this.odataType === "V4") {
+                // V4 sets property directly on context
+                this.context.setProperty(fieldPath, value);
+            } else if (this.odataType === "V2") {
+                // V2 sets property on model, specifying the context path
+                const model = this.context.getModel();
+                model.setProperty(fieldPath, value, this.context);
+            }
+            if (this.host.getProperty("debugMode")) {
+                Logger.debug("[MetaUI]", `ODataDelegate Patched ${fieldPath} = ${value} via ${this.odataType}`, "ODataDelegate");
+            }
+        } catch (e) {
+            Logger.error("[MetaUI]", `Failed to patch OData context: ${(e as Error).message}`, "ODataDelegate");
+        }
+    }
+}