@siliconst/metaui 1.0.2 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/controls/VoiceInputControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceInputControl.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/VoiceInputControl.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,uDAAuD,CAAC;IACvE,OAAO,mBAAmB,MAAM,yDAAyD,CAAC;IAQ1F;;;OAGG;IACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,mBAAmB;QAC9D,MAAM,CAAC,QAAQ,CAAC,QAAQ,qEAAqE;QAC7F,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;UAGtB;QAEF,OAAO,CAAC,IAAI,CAAQ;QACpB,OAAO,CAAC,QAAQ,CAAY;QAC5B,OAAO,CAAC,QAAQ,CAAU;QAC1B,OAAO,CAAC,OAAO,CAAU;QAEzB,OAAO,CAAC,WAAW,CAAa;QAChC,OAAO,CAAC,WAAW,CAAkB;QAE9B,IAAI,IAAI,IAAI;QA+BnB,OAAO,CAAC,eAAe;QAQvB,OAAO,CAAC,qBAAqB;QA2D7B,OAAO,CAAC,cAAc;QAmBtB,OAAO,CAAC,aAAa;QAad,iBAAiB,IAAI,IAAI;QAgBzB,IAAI,IAAI,IAAI;KAWtB;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/VoiceInputControl.js

@@ -0,0 +1,2 @@
+sap.ui.define(["./BaseHardwareControl","sap/m/Button","sap/m/VBox","sap/m/TextArea","sap/m/MessageToast","sap/m/HBox","../utils/Logger"],function(t,e,i,s,n,o,r){"use strict";function a(t){return t&&t.__esModule&&typeof t.default!=="undefined"?t.default:t}const c=a(t);const h=r["Logger"];class l extends c{static renderer="nz.co.siliconst.ui5.metaui.controls.BaseHardwareControlRenderer";static metadata={properties:{},events:{}};recognition=null;isRecording=false;init(){super.init();this.textArea=new s({rows:3,width:"100%",placeholder:"Dictated text will appear here...",liveChange:t=>{this.setValueAndFire(t.getParameter("value"))}});this.startBtn=new e({icon:"sap-icon://microphone",text:"Start Dictation",type:"Emphasized",press:this.toggleDictation.bind(this)});const t=new o({items:[this.startBtn]}).addStyleClass("sapUiSmallMarginTop");this.vBox=new i({items:[this.textArea,t]});this.setAggregation("_content",this.vBox);this.initSpeechRecognition()}toggleDictation(){if(this.isRecording){this.stopDictation()}else{this.startDictation()}}initSpeechRecognition(){const t=window.SpeechRecognition||window.webkitSpeechRecognition;if(t){this.recognition=new t;this.recognition.continuous=true;this.recognition.interimResults=true;this.recognition.onresult=t=>{let e="";let i="";for(let s=t.resultIndex;s<t.results.length;++s){if(t.results[s].isFinal){e+=t.results[s][0].transcript}else{i+=t.results[s][0].transcript}}const s=this.getValue()||"";const n=s?s+" "+e:e;if(e){this.textArea.setValue(n);this.setValueAndFire(n)}else if(i){this.textArea.setValue(s?s+" "+i:i)}};this.recognition.onstart=()=>{this.isRecording=true;this.startBtn.setIcon("sap-icon://stop");this.startBtn.setText("Stop Recording");this.startBtn.setType("Reject");n.show("Listening... Please speak now.")};this.recognition.onerror=t=>{h.error("Speech recognition error",t.error,"VoiceInputControl");sap.ui.require(["sap/m/MessageBox"],e=>{e.error("Microphone Error: "+t.error+"\n\nPlease ensure you have a working microphone attached and have not blocked access in your browser settings.")});this.stopDictation()};this.recognition.onend=()=>{this.stopDictation()}}else{h.warn("Web Speech API not supported in this browser.","","VoiceInputControl");this.startBtn.setEnabled(false);this.startBtn.setTooltip("Speech Recognition is not supported in this browser.")}}startDictation(){if(!this.recognition)return;try{this.recognition.start();n.show("Requesting microphone access...");this.startBtn.setIcon("sap-icon://stop");this.startBtn.setText("Requesting mic...");this.startBtn.setType("Reject")}catch(t){h.error("Failed to start speech recognition",t.message||t,"VoiceInputControl");sap.ui.require(["sap/m/MessageBox"],e=>{e.error("Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\n\nDetails: "+(t.message||t))});this.stopDictation()}}stopDictation(){if(!this.recognition)return;try{this.recognition.stop()}catch(t){}this.isRecording=false;this.startBtn.setIcon("sap-icon://microphone");this.startBtn.setText("Start Dictation");this.startBtn.setType("Emphasized")}onBeforeRendering(){const t=this.getProperty("readOnly");this.textArea.setEditable(!t);this.startBtn.setEnabled(!t&&!!this.recognition);const e=this.getProperty("value");if(e!==undefined&&e!==null){if(!this.isRecording){this.textArea.setValue(e)}}}exit(){this.stopDictation();if(this.recognition){this.recognition.onstart=null;this.recognition.onresult=null;this.recognition.onerror=null;this.recognition.onend=null;this.recognition=null}super.exit()}}return l});
+//# sourceMappingURL=VoiceInputControl.js.map

package/src/nz/co/siliconst/ui5/metaui/controls/VoiceInputControl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceInputControl.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","Logger","___utils_Logger","VoiceInputControl","static","properties","events","recognition","isRecording","init","super","this","textArea","TextArea","rows","width","placeholder","liveChange","oEvent","setValueAndFire","getParameter","startBtn","Button","icon","text","type","press","toggleDictation","bind","hBox","HBox","items","addStyleClass","vBox","VBox","setAggregation","initSpeechRecognition","stopDictation","startDictation","SpeechRecognition","window","webkitSpeechRecognition","continuous","interimResults","onresult","event","finalTranscript","interimTranscript","i","resultIndex","results","length","isFinal","transcript","currentVal","getValue","newVal","setValue","onstart","setIcon","setText","setType","MessageToast","show","onerror","error","sap","ui","require","MessageBox","onend","warn","setEnabled","setTooltip","start","err","message","stop","e","onBeforeRendering","readOnly","getProperty","setEditable","undefined","exit"],"sources":["VoiceInputControl.ts"],"sourcesContent":["import BaseHardwareControl from \"./BaseHardwareControl\";\nimport Button from \"sap/m/Button\";\nimport VBox from \"sap/m/VBox\";\nimport TextArea from \"sap/m/TextArea\";\nimport MessageToast from \"sap/m/MessageToast\";\nimport HBox from \"sap/m/HBox\";\nimport { Logger } from \"../utils/Logger\";\n\n/**\n * VoiceInputControl\n * Provides a UI to dictate text using the browser's native Web Speech API.\n */\nexport default class VoiceInputControl extends BaseHardwareControl {\n    static readonly renderer = \"nz.co.siliconst.ui5.metaui.controls.BaseHardwareControlRenderer\";\n    static readonly metadata = {\n        properties: {},\n        events: {}\n    };\n\n    private vBox!: VBox;\n    private textArea!: TextArea;\n    private startBtn!: Button;\n    private stopBtn!: Button;\n    \n    private recognition: any = null;\n    private isRecording: boolean = false;\n\n    public init(): void {\n        super.init();\n\n        this.textArea = new TextArea({\n            rows: 3,\n            width: \"100%\",\n            placeholder: \"Dictated text will appear here...\",\n            liveChange: (oEvent: sap.ui.base.Event) => {\n                this.setValueAndFire(oEvent.getParameter(\"value\"));\n            }\n        });\n\n        this.startBtn = new Button({\n            icon: \"sap-icon://microphone\",\n            text: \"Start Dictation\",\n            type: \"Emphasized\",\n            press: this.toggleDictation.bind(this)\n        });\n\n        const hBox = new HBox({\n            items: [this.startBtn]\n        }).addStyleClass(\"sapUiSmallMarginTop\");\n\n        this.vBox = new VBox({\n            items: [this.textArea, hBox]\n        });\n\n        this.setAggregation(\"_content\", this.vBox);\n        this.initSpeechRecognition();\n    }\n\n    private toggleDictation(): void {\n        if (this.isRecording) {\n            this.stopDictation();\n        } else {\n            this.startDictation();\n        }\n    }\n\n    private initSpeechRecognition(): void {\n        const SpeechRecognition = (window as unknown).SpeechRecognition || (window as unknown).webkitSpeechRecognition;\n        if (SpeechRecognition) {\n            this.recognition = new SpeechRecognition();\n            this.recognition.continuous = true;\n            this.recognition.interimResults = true;\n\n            this.recognition.onresult = (event: any) => {\n                let finalTranscript = \"\";\n                let interimTranscript = \"\";\n\n                for (let i = event.resultIndex; i < event.results.length; ++i) {\n                    if (event.results[i].isFinal) {\n                        finalTranscript += event.results[i][0].transcript;\n                    } else {\n                        interimTranscript += event.results[i][0].transcript;\n                    }\n                }\n\n                // Append the new final transcript to whatever was already in the textarea\n                const currentVal = this.getValue() || \"\";\n                const newVal = currentVal ? currentVal + \" \" + finalTranscript : finalTranscript;\n                \n                if (finalTranscript) {\n                    this.textArea.setValue(newVal);\n                    this.setValueAndFire(newVal);\n                } else if (interimTranscript) {\n                    // Just show interim temporarily in textarea without saving to model\n                    this.textArea.setValue(currentVal ? currentVal + \" \" + interimTranscript : interimTranscript);\n                }\n            };\n\n            this.recognition.onstart = () => {\n                this.isRecording = true;\n                this.startBtn.setIcon(\"sap-icon://stop\");\n                this.startBtn.setText(\"Stop Recording\");\n                this.startBtn.setType(\"Reject\");\n                MessageToast.show(\"Listening... Please speak now.\");\n            };\n\n            this.recognition.onerror = (event: any) => {\n                Logger.error(\"Speech recognition error\", event.error, \"VoiceInputControl\");\n                sap.ui.require([\"sap/m/MessageBox\"], (MessageBox: unknown) => {\n                    MessageBox.error(\"Microphone Error: \" + event.error + \"\\n\\nPlease ensure you have a working microphone attached and have not blocked access in your browser settings.\");\n                });\n                this.stopDictation();\n            };\n            \n            this.recognition.onend = () => {\n                // If it ends natively (e.g. timeout), update UI\n                this.stopDictation();\n            };\n        } else {\n            Logger.warn(\"Web Speech API not supported in this browser.\", \"\", \"VoiceInputControl\");\n            this.startBtn.setEnabled(false);\n            this.startBtn.setTooltip(\"Speech Recognition is not supported in this browser.\");\n        }\n    }\n\n    private startDictation(): void {\n        if (!this.recognition) return;\n        \n        try {\n            this.recognition.start();\n            MessageToast.show(\"Requesting microphone access...\");\n            // Provide immediate UI feedback in case browser delays the onstart event\n            this.startBtn.setIcon(\"sap-icon://stop\");\n            this.startBtn.setText(\"Requesting mic...\");\n            this.startBtn.setType(\"Reject\");\n        } catch (err: any) {\n            Logger.error(\"Failed to start speech recognition\", err.message || err, \"VoiceInputControl\");\n            sap.ui.require([\"sap/m/MessageBox\"], (MessageBox: unknown) => {\n                MessageBox.error(\"Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\\n\\nDetails: \" + (err.message || err));\n            });\n            this.stopDictation();\n        }\n    }\n\n    private stopDictation(): void {\n        if (!this.recognition) return;\n        \n        try {\n            this.recognition.stop();\n        } catch(e) {}\n        \n        this.isRecording = false;\n        this.startBtn.setIcon(\"sap-icon://microphone\");\n        this.startBtn.setText(\"Start Dictation\");\n        this.startBtn.setType(\"Emphasized\");\n    }\n\n    public onBeforeRendering(): void {\n        const readOnly = this.getProperty(\"readOnly\");\n        this.textArea.setEditable(!readOnly);\n        \n        // Only enable if it's not readonly AND the browser supports speech recognition\n        this.startBtn.setEnabled(!readOnly && !!this.recognition);\n\n        const currentVal = this.getProperty(\"value\");\n        if (currentVal !== undefined && currentVal !== null) {\n            // Only update text area if we aren't currently dictating interim results\n            if (!this.isRecording) {\n                this.textArea.setValue(currentVal as string);\n            }\n        }\n    }\n\n    public exit(): void {\n        this.stopDictation();\n        if (this.recognition) {\n            this.recognition.onstart = null;\n            this.recognition.onresult = null;\n            this.recognition.onerror = null;\n            this.recognition.onend = null;\n            this.recognition = null;\n        }\n        super.exit();\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/VoiceInputControl.ts

@@ -0,0 +1,185 @@
+import BaseHardwareControl from "./BaseHardwareControl";
+import Button from "sap/m/Button";
+import VBox from "sap/m/VBox";
+import TextArea from "sap/m/TextArea";
+import MessageToast from "sap/m/MessageToast";
+import HBox from "sap/m/HBox";
+import { Logger } from "../utils/Logger";
+
+/**
+ * VoiceInputControl
+ * Provides a UI to dictate text using the browser's native Web Speech API.
+ */
+export default class VoiceInputControl extends BaseHardwareControl {
+    static readonly renderer = "nz.co.siliconst.ui5.metaui.controls.BaseHardwareControlRenderer";
+    static readonly metadata = {
+        properties: {},
+        events: {}
+    };
+
+    private vBox!: VBox;
+    private textArea!: TextArea;
+    private startBtn!: Button;
+    private stopBtn!: Button;
+    
+    private recognition: any = null;
+    private isRecording: boolean = false;
+
+    public init(): void {
+        super.init();
+
+        this.textArea = new TextArea({
+            rows: 3,
+            width: "100%",
+            placeholder: "Dictated text will appear here...",
+            liveChange: (oEvent: sap.ui.base.Event) => {
+                this.setValueAndFire(oEvent.getParameter("value"));
+            }
+        });
+
+        this.startBtn = new Button({
+            icon: "sap-icon://microphone",
+            text: "Start Dictation",
+            type: "Emphasized",
+            press: this.toggleDictation.bind(this)
+        });
+
+        const hBox = new HBox({
+            items: [this.startBtn]
+        }).addStyleClass("sapUiSmallMarginTop");
+
+        this.vBox = new VBox({
+            items: [this.textArea, hBox]
+        });
+
+        this.setAggregation("_content", this.vBox);
+        this.initSpeechRecognition();
+    }
+
+    private toggleDictation(): void {
+        if (this.isRecording) {
+            this.stopDictation();
+        } else {
+            this.startDictation();
+        }
+    }
+
+    private initSpeechRecognition(): void {
+        const SpeechRecognition = (window as unknown).SpeechRecognition || (window as unknown).webkitSpeechRecognition;
+        if (SpeechRecognition) {
+            this.recognition = new SpeechRecognition();
+            this.recognition.continuous = true;
+            this.recognition.interimResults = true;
+
+            this.recognition.onresult = (event: any) => {
+                let finalTranscript = "";
+                let interimTranscript = "";
+
+                for (let i = event.resultIndex; i < event.results.length; ++i) {
+                    if (event.results[i].isFinal) {
+                        finalTranscript += event.results[i][0].transcript;
+                    } else {
+                        interimTranscript += event.results[i][0].transcript;
+                    }
+                }
+
+                // Append the new final transcript to whatever was already in the textarea
+                const currentVal = this.getValue() || "";
+                const newVal = currentVal ? currentVal + " " + finalTranscript : finalTranscript;
+                
+                if (finalTranscript) {
+                    this.textArea.setValue(newVal);
+                    this.setValueAndFire(newVal);
+                } else if (interimTranscript) {
+                    // Just show interim temporarily in textarea without saving to model
+                    this.textArea.setValue(currentVal ? currentVal + " " + interimTranscript : interimTranscript);
+                }
+            };
+
+            this.recognition.onstart = () => {
+                this.isRecording = true;
+                this.startBtn.setIcon("sap-icon://stop");
+                this.startBtn.setText("Stop Recording");
+                this.startBtn.setType("Reject");
+                MessageToast.show("Listening... Please speak now.");
+            };
+
+            this.recognition.onerror = (event: any) => {
+                Logger.error("Speech recognition error", event.error, "VoiceInputControl");
+                sap.ui.require(["sap/m/MessageBox"], (MessageBox: unknown) => {
+                    MessageBox.error("Microphone Error: " + event.error + "\n\nPlease ensure you have a working microphone attached and have not blocked access in your browser settings.");
+                });
+                this.stopDictation();
+            };
+            
+            this.recognition.onend = () => {
+                // If it ends natively (e.g. timeout), update UI
+                this.stopDictation();
+            };
+        } else {
+            Logger.warn("Web Speech API not supported in this browser.", "", "VoiceInputControl");
+            this.startBtn.setEnabled(false);
+            this.startBtn.setTooltip("Speech Recognition is not supported in this browser.");
+        }
+    }
+
+    private startDictation(): void {
+        if (!this.recognition) return;
+        
+        try {
+            this.recognition.start();
+            MessageToast.show("Requesting microphone access...");
+            // Provide immediate UI feedback in case browser delays the onstart event
+            this.startBtn.setIcon("sap-icon://stop");
+            this.startBtn.setText("Requesting mic...");
+            this.startBtn.setType("Reject");
+        } catch (err: any) {
+            Logger.error("Failed to start speech recognition", err.message || err, "VoiceInputControl");
+            sap.ui.require(["sap/m/MessageBox"], (MessageBox: unknown) => {
+                MessageBox.error("Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\n\nDetails: " + (err.message || err));
+            });
+            this.stopDictation();
+        }
+    }
+
+    private stopDictation(): void {
+        if (!this.recognition) return;
+        
+        try {
+            this.recognition.stop();
+        } catch(e) {}
+        
+        this.isRecording = false;
+        this.startBtn.setIcon("sap-icon://microphone");
+        this.startBtn.setText("Start Dictation");
+        this.startBtn.setType("Emphasized");
+    }
+
+    public onBeforeRendering(): void {
+        const readOnly = this.getProperty("readOnly");
+        this.textArea.setEditable(!readOnly);
+        
+        // Only enable if it's not readonly AND the browser supports speech recognition
+        this.startBtn.setEnabled(!readOnly && !!this.recognition);
+
+        const currentVal = this.getProperty("value");
+        if (currentVal !== undefined && currentVal !== null) {
+            // Only update text area if we aren't currently dictating interim results
+            if (!this.isRecording) {
+                this.textArea.setValue(currentVal as string);
+            }
+        }
+    }
+
+    public exit(): void {
+        this.stopDictation();
+        if (this.recognition) {
+            this.recognition.onstart = null;
+            this.recognition.onresult = null;
+            this.recognition.onerror = null;
+            this.recognition.onend = null;
+            this.recognition = null;
+        }
+        super.exit();
+    }
+}

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

@@ -0,0 +1,443 @@
+sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNormalizer", "../../core/SchemaValidator", "../../core/Engine", "../../core/StateManager", "./delegates/DataSyncDelegate", "./delegates/ValidationDelegate", "./delegates/DialogDelegate", "sap/m/MessageBox"], function (Control, ____utils_Logger, ____core_SchemaNormalizer, ____core_SchemaValidator, ____core_Engine, ____core_StateManager, ___delegates_DataSyncDelegate, ___delegates_ValidationDelegate, ___delegates_DialogDelegate, MessageBox) {
+  "use strict";
+
+  const Logger = ____utils_Logger["Logger"];
+  const SchemaNormalizer = ____core_SchemaNormalizer["SchemaNormalizer"];
+  const SchemaValidator = ____core_SchemaValidator["SchemaValidator"];
+  const Engine = ____core_Engine["Engine"];
+  const StateManager = ____core_StateManager["StateManager"];
+  const DataSyncDelegate = ___delegates_DataSyncDelegate["DataSyncDelegate"];
+  const ValidationDelegate = ___delegates_ValidationDelegate["ValidationDelegate"];
+  const DialogDelegate = ___delegates_DialogDelegate["DialogDelegate"];
+  /**
+   * Base wrapper element for embedding the dynamic form natively via Explicit Schemas.
+   * 
+   * This class serves as the core rendering engine for standard MetaUI implementations.
+   * It manages the lifecycle of the Engine, StateManager, and the delegation of 
+   * data synchronization, validation, and dialog interactions.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.controls.host
+   */
+  const GeneratorHost = Control.extend("nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost", {
+    renderer: {
+      apiVersion: 2,
+      render(rm, control) {
+        rm.openStart("div", control);
+        rm.style("width", "100%");
+        rm.style("height", "100%");
+        rm.openEnd();
+        const content = control.getAggregation("_content");
+        if (content) {
+          rm.renderControl(content);
+        }
+        rm.close("div");
+      }
+    },
+    metadata: {
+      properties: {
+        schemaDefinition: {
+          type: "any",
+          defaultValue: null
+        },
+        data: {
+          type: "object",
+          defaultValue: null,
+          bindable: "bindable"
+        },
+        dataJson: {
+          type: "string",
+          defaultValue: null,
+          bindable: "bindable"
+        },
+        liveUpdate: {
+          type: "boolean",
+          defaultValue: false
+        },
+        isValid: {
+          type: "boolean",
+          defaultValue: true
+        },
+        useMessageManager: {
+          type: "boolean",
+          defaultValue: false
+        },
+        modelName: {
+          type: "string",
+          defaultValue: "meta"
+        },
+        debugMode: {
+          type: "boolean",
+          defaultValue: false
+        },
+        displayMode: {
+          type: "boolean",
+          defaultValue: false
+        }
+      },
+      aggregations: {
+        _content: {
+          type: "sap.ui.core.Control",
+          multiple: false,
+          visibility: "hidden"
+        }
+      },
+      events: {
+        beforeSubmit: {
+          parameters: {
+            payload: {
+              type: "object"
+            },
+            addError: {
+              type: "function"
+            },
+            preventDefault: {
+              type: "function"
+            }
+          }
+        },
+        submit: {
+          parameters: {
+            payload: {
+              type: "object"
+            },
+            payloadJson: {
+              type: "string"
+            }
+          }
+        },
+        cancel: {},
+        fieldChange: {
+          parameters: {
+            fieldPath: {
+              type: "string"
+            },
+            value: {
+              type: "any"
+            },
+            payload: {
+              type: "object"
+            },
+            isValid: {
+              type: "boolean"
+            }
+          }
+        },
+        validationStateChanged: {
+          parameters: {
+            isValid: {
+              type: "boolean"
+            }
+          }
+        },
+        validationError: {
+          parameters: {
+            fieldPath: {
+              type: "string"
+            },
+            message: {
+              type: "string"
+            }
+          }
+        },
+        validationSuccess: {
+          parameters: {
+            fieldPath: {
+              type: "string"
+            }
+          }
+        }
+      }
+    },
+    /**
+     * Standard UI5 Constructor.
+     */
+    constructor: function _constructor(idOrSettings, settings) {
+      Control.prototype.constructor.call(this, idOrSettings, settings);
+      this.stateManager = null;
+      this.generatedContent = null;
+      this.engine = null;
+      this.activeModelName = "";
+      /** Cached schema for intelligent diffing during inference mode hot-swaps */
+      this.parsedSchema = null;
+    },
+    /**
+     * Initializes the control and instantiates the composition delegates.
+     * Delegates must be initialized here rather than in the constructor so they are 
+     * available before `applySettings` runs during UI5's control lifecycle.
+     */
+    init: function _init() {
+      Control.prototype.init.call(this);
+
+      // Initialize Composition Delegates
+      this.dataSyncDelegate = new DataSyncDelegate(this);
+      this.validationDelegate = new ValidationDelegate(this);
+      this.dialogDelegate = new DialogDelegate(this);
+      this.onInternalFieldChange = this.onInternalFieldChange.bind(this);
+    },
+    /**
+     * Enables or disables debug mode.
+     */
+    setDebugMode: function _setDebugMode(enabled) {
+      this.setProperty("debugMode", enabled, true);
+      Logger.setDebugMode(enabled);
+      return this;
+    },
+    /**
+     * Returns the active state manager instance managing the JSON payload.
+     */
+    getStateManager: function _getStateManager() {
+      return this.stateManager;
+    },
+    /**
+     * Safely destroys the currently generated UI tree and cleans up references.
+     * This is called before every regeneration to prevent memory leaks.
+     */
+    tearDownGeneratedLayout: function _tearDownGeneratedLayout() {
+      if (this.generatedContent) {
+        this.validationDelegate.unregisterObject(this.generatedContent);
+        this.generatedContent.destroy();
+        this.generatedContent = null;
+      }
+    },
+    /**
+     * Internal event handler triggered by the Engine when a field value changes.
+     * Coordinates LiveUpdate syncs, validation state tracking, and bubbling the change upwards.
+     */
+    onInternalFieldChange: function _onInternalFieldChange(isValid, fieldKey, errorMessage, controlId) {
+      const payload = this.stateManager ? this.stateManager.extractPayload() : {};
+      if (this.getProperty("liveUpdate") === true) {
+        if (this.getProperty("debugMode")) {
+          Logger.debug("[MetaUI]", "liveUpdate is enabled, pushing outbound payload.", "GeneratorHost");
+        }
+        this.dataSyncDelegate.pushToBindings(payload);
+      }
+      const currentValidity = this.getProperty("isValid");
+      if (isValid !== currentValidity) {
+        this.setProperty("isValid", isValid, true);
+        this.fireEvent("validationStateChanged", {
+          isValid
+        });
+        if (this.getProperty("debugMode")) {
+          Logger.debug("[MetaUI]", `Validation state shifted to: ${isValid}`, "GeneratorHost");
+        }
+      }
+      this.fireEvent("fieldChange", {
+        fieldPath: fieldKey || "",
+        value: undefined,
+        payload: payload,
+        isValid: isValid
+      });
+    },
+    /**
+     * Standard UI5 Exit Hook. Ensures complete teardown of the engine and state manager.
+     */
+    exit: function _exit() {
+      if (this.engine) {
+        this.engine.destroy();
+        this.engine = null;
+      }
+      if (this.stateManager) {
+        this.stateManager.getModel().destroy();
+        this.stateManager = null;
+      }
+      if (this.generatedContent) {
+        this.generatedContent.destroy();
+        this.generatedContent = null;
+      }
+    },
+    /**
+     * Exposes the parsed schema to the DataSyncDelegate for diffing.
+     */
+    getParsedSchema: function _getParsedSchema() {
+      return this.parsedSchema;
+    },
+    /**
+     * Standard UI5 Rendering Hook.
+     * Evaluates whether it possesses a schema or data. If so, triggers the internal engine generation.
+     */
+    onBeforeRendering: function _onBeforeRendering() {
+      if (this.getProperty("debugMode")) {
+        Logger.debug("[MetaUI GeneratorHost]", `onBeforeRendering called. Engine boot state: schemaDefinition exists = ${!!this.getProperty("schemaDefinition")}, data exists = ${!!this.getProperty("data")}, dataJson exists = ${!!this.getProperty("dataJson")}`, "GeneratorHost");
+      }
+      if (!this.generatedContent) {
+        const hasSchema = !!this.getProperty("schemaDefinition");
+        const hasData = !!this.getProperty("dataJson") || !!this.getProperty("data");
+        if (hasSchema || hasData) {
+          this.generate();
+        } else if (this.getProperty("debugMode")) {
+          Logger.debug("[MetaUI]", "GeneratorHost skipped rendering. Neither 'schemaDefinition' nor data was provided.", "GeneratorHost");
+        }
+      }
+    },
+    /**
+     * Public API method to manually trigger form submission.
+     * Executes all structural validations, clears old messages, and pushes payload to bindings.
+     * @returns boolean True if submission succeeded, false if validation failed.
+     */
+    triggerSubmit: function _triggerSubmit() {
+      if (this.stateManager && this.engine) {
+        let isPrevented = false;
+        this.validationDelegate.removeAllMessages();
+        const errors = this.engine.validateAll();
+        if (errors.length > 0) {
+          this.validationDelegate.pushMessage("", "One or more fields failed schema validation. Please review the highlighted fields.");
+          for (const err of errors) {
+            if (err.fieldKey && err.errorMessage) {
+              this.validationDelegate.pushMessage(err.fieldKey, err.errorMessage);
+            }
+          }
+          return false;
+        }
+        const payload = this.stateManager.extractPayload();
+        const payloadJson = JSON.stringify(payload);
+        this.fireEvent("beforeSubmit", {
+          payload,
+          preventDefault: () => {
+            isPrevented = true;
+          },
+          addError: (propertyPath, errorMessage) => {
+            isPrevented = true;
+            this.validationDelegate.pushMessage(propertyPath, errorMessage);
+          }
+        });
+        if (isPrevented) {
+          return false;
+        }
+        this.dataSyncDelegate.pushToBindings(payload);
+        this.fireEvent("submit", {
+          payload,
+          payloadJson
+        });
+        return true;
+      }
+      return false;
+    },
+    /**
+     * Injects a custom error message onto a specific field.
+     */
+    addCustomError: function _addCustomError(fieldPath, message) {
+      this.validationDelegate.addCustomError(fieldPath, message);
+    },
+    /**
+     * Clears a custom error message from a specific field.
+     */
+    clearCustomError: function _clearCustomError(fieldPath) {
+      this.validationDelegate.clearCustomError(fieldPath);
+    },
+    /**
+     * Toggles busy state on the host control.
+     */
+    setBusy: function _setBusy(isBusy) {
+      Control.prototype.setBusy.call(this, isBusy);
+      return this;
+    },
+    /**
+     * Intercepts property changes. Hot-swaps data gracefully if it's an inputData change,
+     * or forces a full UI teardown if it's a structural property change (like schemaDefinition).
+     */
+    setProperty: function _setProperty(propertyName, value, suppressInvalidate) {
+      if (propertyName === "dataJson" || propertyName === "data") {
+        this.dataSyncDelegate.handleInputDataHotSwap(propertyName, value, suppressInvalidate);
+        return this;
+      }
+      if (propertyName === "displayMode" || propertyName === "debugMode" || propertyName === "schemaDefinition") {
+        const currentVal = this.getProperty(propertyName);
+        if (currentVal !== value) {
+          Control.prototype.setProperty.call(this, propertyName, value, suppressInvalidate);
+          this.tearDownGeneratedLayout();
+        }
+        return this;
+      }
+      return Control.prototype.setProperty.call(this, propertyName, value, suppressInvalidate);
+    },
+    /**
+     * Bypasses the interceptor to write directly to the base UI5 control.
+     */
+    setBaseProperty: function _setBaseProperty(propertyName, value, suppressInvalidate) {
+      return Control.prototype.setProperty.call(this, propertyName, value, suppressInvalidate);
+    },
+    /**
+     * The core rendering pipeline.
+     * Normalizes the schema, sets up the state manager, orchestrates the engine build,
+     * and sets the generated UI components into the internal aggregation tree.
+     */
+    generate: function _generate() {
+      try {
+        this.tearDownGeneratedLayout();
+
+        // CRITICAL FIX: Extract the unsaved internal payload BEFORE destroying the state manager
+        // Otherwise, toggling displayMode (or other structural properties) will wipe user inputs!
+        let internalPayload = null;
+        if (this.stateManager) {
+          internalPayload = this.stateManager.extractPayload();
+        }
+        if (this.engine) {
+          this.engine.destroy();
+          this.engine = null;
+        }
+        if (this.stateManager) {
+          this.stateManager.getModel().destroy();
+          this.stateManager = null;
+        }
+        const rawSchema = this.getProperty("schemaDefinition");
+        let inputData = this.getProperty("data");
+        const inputDataJson = this.getProperty("dataJson");
+        if (inputDataJson) {
+          try {
+            inputData = JSON.parse(inputDataJson);
+          } catch (e) {
+            Logger.error("[MetaUI]", "Failed to parse inputDataJson string: " + e.message, "GeneratorHost");
+          }
+        } else if (typeof inputData === "string") {
+          try {
+            inputData = JSON.parse(inputData);
+          } catch (e) {
+            Logger.error("[MetaUI]", "Failed to parse inputData string: " + e.message, "GeneratorHost");
+          }
+        }
+
+        // The internal payload represents the user's latest un-extracted edits. It must take priority.
+        const finalData = internalPayload || inputData || {};
+        const normalizedSchema = SchemaNormalizer.normalize(rawSchema, finalData);
+
+        // Cache the parsed/inferred schema so DataSyncDelegate can diff against it later
+        this.parsedSchema = normalizedSchema;
+        if (normalizedSchema) {
+          const schemaErrors = SchemaValidator.validateSchemaStructure(normalizedSchema);
+          if (schemaErrors.length > 0) {
+            const errorMsg = "Schema Structural Errors Found:\n- " + schemaErrors.join("\n- ");
+            // Let's log it out loudly regardless of debug mode, so developers can see why it didn't render
+            Logger.error("[MetaUI]", errorMsg, "GeneratorHost");
+            if (this.getProperty("debugMode")) {
+              MessageBox.error(errorMsg, {
+                title: "MetaUI Schema Error"
+              });
+              return;
+            }
+          }
+        }
+        this.activeModelName = "metaUI_" + this.getId();
+        this.stateManager = new StateManager(finalData, normalizedSchema, this.activeModelName);
+        this.setModel(this.stateManager.getModel(), this.activeModelName);
+        this.engine = new Engine(this.getProperty("displayMode"));
+        this.generatedContent = this.engine.build(normalizedSchema, this.stateManager.getModel(), this.activeModelName, this.triggerSubmit.bind(this), this.getId(), this.onInternalFieldChange.bind(this));
+        this.setAggregation("_content", this.generatedContent);
+        this.validationDelegate.registerObject(this.generatedContent);
+        const payload = this.stateManager.extractPayload();
+        this.dataSyncDelegate.pushToBindings(payload);
+      } catch (error) {
+        Logger.error("[MetaUI]", "Fatal crash during layout generation: " + error.message, "GeneratorHost");
+        this.validationDelegate.mountCrashBoundary(error);
+      }
+    },
+    /**
+     * Programmatic API. Re-parents the generated content into a dialog and opens it.
+     */
+    openInDialog: function _openInDialog(title = "Form", submitButtonText = "OK") {
+      const isGenerated = !!this.generatedContent;
+      this.dialogDelegate.openInDialog(title, submitButtonText, isGenerated);
+    }
+  });
+  return GeneratorHost;
+});
+//# sourceMappingURL=GeneratorHost-dbg.js.map