@siliconst/metaui 1.4.6 → 1.4.8

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

@@ -18,6 +18,10 @@ sap.ui.define(["./BaseHardwareControl", "sap/m/Button", "sap/m/VBox", "sap/m/Tex
     };
     recognition = null;
     isRecording = false;
+
+    /**
+     * Initializes the dictation interface and requests Web Speech API setup.
+     */
     init() {
       super.init();
       this.textArea = new TextArea({
@@ -51,9 +55,9 @@ sap.ui.define(["./BaseHardwareControl", "sap/m/Button", "sap/m/VBox", "sap/m/Tex
       }
     }
     initSpeechRecognition() {
-      const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
-      if (SpeechRecognition) {
-        this.recognition = new SpeechRecognition();
+      const SpeechRecognitionClass = window.SpeechRecognition || window.webkitSpeechRecognition;
+      if (SpeechRecognitionClass) {
+        this.recognition = new SpeechRecognitionClass();
         this.recognition.continuous = true;
         this.recognition.interimResults = true;
         this.recognition.onresult = event => {
@@ -112,9 +116,10 @@ sap.ui.define(["./BaseHardwareControl", "sap/m/Button", "sap/m/VBox", "sap/m/Tex
         this.startBtn.setText("Requesting mic...");
         this.startBtn.setType("Reject");
       } catch (err) {
-        Logger.error("Failed to start speech recognition", err.message || err, "VoiceInputControl");
+        const error = err;
+        Logger.error("Failed to start speech recognition", error.message || String(error), "VoiceInputControl");
         sap.ui.require(["sap/m/MessageBox"], MessageBox => {
-          MessageBox.error("Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\n\nDetails: " + (err.message || err));
+          MessageBox.error("Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\n\nDetails: " + (error.message || String(error)));
         });
         this.stopDictation();
       }
@@ -123,12 +128,19 @@ sap.ui.define(["./BaseHardwareControl", "sap/m/Button", "sap/m/VBox", "sap/m/Tex
       if (!this.recognition) return;
       try {
         this.recognition.stop();
-      } catch (e) {}
+      } catch (e) {
+        Logger.warn("Failed to gracefully stop speech recognition.", String(e), "VoiceInputControl");
+      }
       this.isRecording = false;
       this.startBtn.setIcon("sap-icon://microphone");
       this.startBtn.setText("Start Dictation");
       this.startBtn.setType("Emphasized");
     }
+
+    /**
+     * Lifecycle hook called before the control is rendered to the DOM.
+     * Handles browser support visual state.
+     */
     onBeforeRendering() {
       const readOnly = this.getProperty("readOnly");
       this.textArea.setEditable(!readOnly);
@@ -143,6 +155,10 @@ sap.ui.define(["./BaseHardwareControl", "sap/m/Button", "sap/m/VBox", "sap/m/Tex
         }
       }
     }
+
+    /**
+     * Cleans up hardware event listeners when the control is destroyed.
+     */
     exit() {
       this.stopDictation();
       if (this.recognition) {

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

@@ -1 +1 @@
-{"version":3,"file":"VoiceInputControl-dbg.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","Logger","___utils_Logger","VoiceInputControl","renderer","metadata","properties","events","recognition","isRecording","init","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":[]}
+{"version":3,"file":"VoiceInputControl-dbg.js","names":["BaseHardwareControl","_interopRequireDefault","__BaseHardwareControl","Logger","___utils_Logger","VoiceInputControl","renderer","metadata","properties","events","recognition","isRecording","init","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","SpeechRecognitionClass","window","SpeechRecognition","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","String","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\ndeclare global {\n    interface Window {\n        SpeechRecognition: new () => SpeechRecognition;\n        webkitSpeechRecognition: new () => SpeechRecognition;\n    }\n    interface SpeechRecognition {\n        continuous: boolean;\n        interimResults: boolean;\n        onresult: (event: SpeechRecognitionEvent) => void;\n        onstart: () => void;\n        onerror: (event: SpeechRecognitionErrorEvent) => void;\n        onend: () => void;\n        start(): void;\n        stop(): void;\n    }\n    interface SpeechRecognitionEvent {\n        resultIndex: number;\n        results: {\n            length: number;\n            [index: number]: {\n                isFinal: boolean;\n                [index: number]: {\n                    transcript: string;\n                };\n            };\n        };\n    }\n    interface SpeechRecognitionErrorEvent {\n        error: string;\n    }\n}\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: SpeechRecognition | null = null;\n    private isRecording: boolean = false;\n\n    /**\n     * Initializes the dictation interface and requests Web Speech API setup.\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 SpeechRecognitionClass = window.SpeechRecognition || window.webkitSpeechRecognition;\n        if (SpeechRecognitionClass) {\n            this.recognition = new SpeechRecognitionClass();\n            this.recognition.continuous = true;\n            this.recognition.interimResults = true;\n\n            this.recognition.onresult = (event: SpeechRecognitionEvent) => {\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: SpeechRecognitionErrorEvent) => {\n                Logger.error(\"Speech recognition error\", event.error, \"VoiceInputControl\");\n                sap.ui.require([\"sap/m/MessageBox\"], (MessageBox: typeof import(\"sap/m/MessageBox\").default) => {\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) {\n            const error = err as Error;\n            Logger.error(\"Failed to start speech recognition\", error.message || String(error), \"VoiceInputControl\");\n            sap.ui.require([\"sap/m/MessageBox\"], (MessageBox: typeof import(\"sap/m/MessageBox\").default) => {\n                MessageBox.error(\"Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\\n\\nDetails: \" + (error.message || String(error)));\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            Logger.warn(\"Failed to gracefully stop speech recognition.\", String(e), \"VoiceInputControl\");\n        }\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    /**\n     * Lifecycle hook called before the control is rendered to the DOM.\n     * Handles browser support visual state.\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    /**\n     * Cleans up hardware event listeners when the control is destroyed.\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.d.ts

@@ -1,5 +1,36 @@
 declare module "nz/co/siliconst/ui5/metaui/controls/VoiceInputControl" {
     import BaseHardwareControl from "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl";
+    global {
+        interface Window {
+            SpeechRecognition: new () => SpeechRecognition;
+            webkitSpeechRecognition: new () => SpeechRecognition;
+        }
+        interface SpeechRecognition {
+            continuous: boolean;
+            interimResults: boolean;
+            onresult: (event: SpeechRecognitionEvent) => void;
+            onstart: () => void;
+            onerror: (event: SpeechRecognitionErrorEvent) => void;
+            onend: () => void;
+            start(): void;
+            stop(): void;
+        }
+        interface SpeechRecognitionEvent {
+            resultIndex: number;
+            results: {
+                length: number;
+                [index: number]: {
+                    isFinal: boolean;
+                    [index: number]: {
+                        transcript: string;
+                    };
+                };
+            };
+        }
+        interface SpeechRecognitionErrorEvent {
+            error: string;
+        }
+    }
     /**
      * VoiceInputControl
      * Provides a UI to dictate text using the browser's native Web Speech API.
@@ -16,12 +47,22 @@ declare module "nz/co/siliconst/ui5/metaui/controls/VoiceInputControl" {
         private stopBtn;
         private recognition;
         private isRecording;
+        /**
+         * Initializes the dictation interface and requests Web Speech API setup.
+         */
         init(): void;
         private toggleDictation;
         private initSpeechRecognition;
         private startDictation;
         private stopDictation;
+        /**
+         * Lifecycle hook called before the control is rendered to the DOM.
+         * Handles browser support visual state.
+         */
         onBeforeRendering(): void;
+        /**
+         * Cleans up hardware event listeners when the control is destroyed.
+         */
         exit(): void;
     }
 }

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

@@ -1 +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"}
+{"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;IAQlF,MAAM,CAAC;QACX,UAAU,MAAM;YACZ,iBAAiB,EAAE,UAAU,iBAAiB,CAAC;YAC/C,uBAAuB,EAAE,UAAU,iBAAiB,CAAC;SACxD;QACD,UAAU,iBAAiB;YACvB,UAAU,EAAE,OAAO,CAAC;YACpB,cAAc,EAAE,OAAO,CAAC;YACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;YAClD,OAAO,EAAE,MAAM,IAAI,CAAC;YACpB,OAAO,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAC;YACtD,KAAK,EAAE,MAAM,IAAI,CAAC;YAClB,KAAK,IAAI,IAAI,CAAC;YACd,IAAI,IAAI,IAAI,CAAC;SAChB;QACD,UAAU,sBAAsB;YAC5B,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE;gBACL,MAAM,EAAE,MAAM,CAAC;gBACf,CAAC,KAAK,EAAE,MAAM,GAAG;oBACb,OAAO,EAAE,OAAO,CAAC;oBACjB,CAAC,KAAK,EAAE,MAAM,GAAG;wBACb,UAAU,EAAE,MAAM,CAAC;qBACtB,CAAC;iBACL,CAAC;aACL,CAAC;SACL;QACD,UAAU,2BAA2B;YACjC,KAAK,EAAE,MAAM,CAAC;SACjB;KACJ;IAED;;;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,CAAkC;QACrD,OAAO,CAAC,WAAW,CAAkB;QAErC;;WAEG;QACI,IAAI,IAAI,IAAI;QA+BnB,OAAO,CAAC,eAAe;QAQvB,OAAO,CAAC,qBAAqB;QA2D7B,OAAO,CAAC,cAAc;QAoBtB,OAAO,CAAC,aAAa;QAerB;;;WAGG;QACI,iBAAiB,IAAI,IAAI;QAgBhC;;WAEG;QACI,IAAI,IAAI,IAAI;KAWtB;CAEA"}

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

@@ -1,2 +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});
+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){const e=t;h.error("Failed to start speech recognition",e.message||String(e),"VoiceInputControl");sap.ui.require(["sap/m/MessageBox"],t=>{t.error("Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\n\nDetails: "+(e.message||String(e)))});this.stopDictation()}}stopDictation(){if(!this.recognition)return;try{this.recognition.stop()}catch(t){h.warn("Failed to gracefully stop speech recognition.",String(t),"VoiceInputControl")}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

@@ -1 +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":[]}
+{"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","SpeechRecognitionClass","window","SpeechRecognition","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","String","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\ndeclare global {\n    interface Window {\n        SpeechRecognition: new () => SpeechRecognition;\n        webkitSpeechRecognition: new () => SpeechRecognition;\n    }\n    interface SpeechRecognition {\n        continuous: boolean;\n        interimResults: boolean;\n        onresult: (event: SpeechRecognitionEvent) => void;\n        onstart: () => void;\n        onerror: (event: SpeechRecognitionErrorEvent) => void;\n        onend: () => void;\n        start(): void;\n        stop(): void;\n    }\n    interface SpeechRecognitionEvent {\n        resultIndex: number;\n        results: {\n            length: number;\n            [index: number]: {\n                isFinal: boolean;\n                [index: number]: {\n                    transcript: string;\n                };\n            };\n        };\n    }\n    interface SpeechRecognitionErrorEvent {\n        error: string;\n    }\n}\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: SpeechRecognition | null = null;\n    private isRecording: boolean = false;\n\n    /**\n     * Initializes the dictation interface and requests Web Speech API setup.\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 SpeechRecognitionClass = window.SpeechRecognition || window.webkitSpeechRecognition;\n        if (SpeechRecognitionClass) {\n            this.recognition = new SpeechRecognitionClass();\n            this.recognition.continuous = true;\n            this.recognition.interimResults = true;\n\n            this.recognition.onresult = (event: SpeechRecognitionEvent) => {\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: SpeechRecognitionErrorEvent) => {\n                Logger.error(\"Speech recognition error\", event.error, \"VoiceInputControl\");\n                sap.ui.require([\"sap/m/MessageBox\"], (MessageBox: typeof import(\"sap/m/MessageBox\").default) => {\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) {\n            const error = err as Error;\n            Logger.error(\"Failed to start speech recognition\", error.message || String(error), \"VoiceInputControl\");\n            sap.ui.require([\"sap/m/MessageBox\"], (MessageBox: typeof import(\"sap/m/MessageBox\").default) => {\n                MessageBox.error(\"Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\\n\\nDetails: \" + (error.message || String(error)));\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            Logger.warn(\"Failed to gracefully stop speech recognition.\", String(e), \"VoiceInputControl\");\n        }\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    /**\n     * Lifecycle hook called before the control is rendered to the DOM.\n     * Handles browser support visual state.\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    /**\n     * Cleans up hardware event listeners when the control is destroyed.\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

@@ -6,6 +6,38 @@ import MessageToast from "sap/m/MessageToast";
 import HBox from "sap/m/HBox";
 import { Logger } from "../utils/Logger";
 
+declare global {
+    interface Window {
+        SpeechRecognition: new () => SpeechRecognition;
+        webkitSpeechRecognition: new () => SpeechRecognition;
+    }
+    interface SpeechRecognition {
+        continuous: boolean;
+        interimResults: boolean;
+        onresult: (event: SpeechRecognitionEvent) => void;
+        onstart: () => void;
+        onerror: (event: SpeechRecognitionErrorEvent) => void;
+        onend: () => void;
+        start(): void;
+        stop(): void;
+    }
+    interface SpeechRecognitionEvent {
+        resultIndex: number;
+        results: {
+            length: number;
+            [index: number]: {
+                isFinal: boolean;
+                [index: number]: {
+                    transcript: string;
+                };
+            };
+        };
+    }
+    interface SpeechRecognitionErrorEvent {
+        error: string;
+    }
+}
+
 /**
  * VoiceInputControl
  * Provides a UI to dictate text using the browser's native Web Speech API.
@@ -22,9 +54,12 @@ export default class VoiceInputControl extends BaseHardwareControl {
     private startBtn!: Button;
     private stopBtn!: Button;
     
-    private recognition: any = null;
+    private recognition: SpeechRecognition | null = null;
     private isRecording: boolean = false;
 
+    /**
+     * Initializes the dictation interface and requests Web Speech API setup.
+     */
     public init(): void {
         super.init();
 
@@ -65,13 +100,13 @@ export default class VoiceInputControl extends BaseHardwareControl {
     }
 
     private initSpeechRecognition(): void {
-        const SpeechRecognition = (window as unknown).SpeechRecognition || (window as unknown).webkitSpeechRecognition;
-        if (SpeechRecognition) {
-            this.recognition = new SpeechRecognition();
+        const SpeechRecognitionClass = window.SpeechRecognition || window.webkitSpeechRecognition;
+        if (SpeechRecognitionClass) {
+            this.recognition = new SpeechRecognitionClass();
             this.recognition.continuous = true;
             this.recognition.interimResults = true;
 
-            this.recognition.onresult = (event: any) => {
+            this.recognition.onresult = (event: SpeechRecognitionEvent) => {
                 let finalTranscript = "";
                 let interimTranscript = "";
 
@@ -104,9 +139,9 @@ export default class VoiceInputControl extends BaseHardwareControl {
                 MessageToast.show("Listening... Please speak now.");
             };
 
-            this.recognition.onerror = (event: any) => {
+            this.recognition.onerror = (event: SpeechRecognitionErrorEvent) => {
                 Logger.error("Speech recognition error", event.error, "VoiceInputControl");
-                sap.ui.require(["sap/m/MessageBox"], (MessageBox: unknown) => {
+                sap.ui.require(["sap/m/MessageBox"], (MessageBox: typeof import("sap/m/MessageBox").default) => {
                     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();
@@ -133,10 +168,11 @@ export default class VoiceInputControl extends BaseHardwareControl {
             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));
+        } catch (err) {
+            const error = err as Error;
+            Logger.error("Failed to start speech recognition", error.message || String(error), "VoiceInputControl");
+            sap.ui.require(["sap/m/MessageBox"], (MessageBox: typeof import("sap/m/MessageBox").default) => {
+                MessageBox.error("Failed to start dictation. Please ensure you have a working microphone and have granted browser permissions.\n\nDetails: " + (error.message || String(error)));
             });
             this.stopDictation();
         }
@@ -147,7 +183,9 @@ export default class VoiceInputControl extends BaseHardwareControl {
         
         try {
             this.recognition.stop();
-        } catch(e) {}
+        } catch(e) {
+            Logger.warn("Failed to gracefully stop speech recognition.", String(e), "VoiceInputControl");
+        }
         
         this.isRecording = false;
         this.startBtn.setIcon("sap-icon://microphone");
@@ -155,6 +193,10 @@ export default class VoiceInputControl extends BaseHardwareControl {
         this.startBtn.setType("Emphasized");
     }
 
+    /**
+     * Lifecycle hook called before the control is rendered to the DOM.
+     * Handles browser support visual state.
+     */
     public onBeforeRendering(): void {
         const readOnly = this.getProperty("readOnly");
         this.textArea.setEditable(!readOnly);
@@ -171,6 +213,9 @@ export default class VoiceInputControl extends BaseHardwareControl {
         }
     }
 
+    /**
+     * Cleans up hardware event listeners when the control is destroyed.
+     */
     public exit(): void {
         this.stopDictation();
         if (this.recognition) {

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

@@ -1,4 +1,4 @@
-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) {
+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", "../../core/PluginRegistry"], function (Control, ____utils_Logger, ____core_SchemaNormalizer, ____core_SchemaValidator, ____core_Engine, ____core_StateManager, ___delegates_DataSyncDelegate, ___delegates_ValidationDelegate, ___delegates_DialogDelegate, MessageBox, ____core_PluginRegistry) {
   "use strict";
 
   const Logger = ____utils_Logger["Logger"];
@@ -9,6 +9,7 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
   const DataSyncDelegate = ___delegates_DataSyncDelegate["DataSyncDelegate"];
   const ValidationDelegate = ___delegates_ValidationDelegate["ValidationDelegate"];
   const DialogDelegate = ___delegates_DialogDelegate["DialogDelegate"];
+  const PluginRegistry = ____core_PluginRegistry["PluginRegistry"];
   /**
    * Base wrapper element for embedding the dynamic form natively via Explicit Schemas.
    * 
@@ -159,6 +160,11 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
       this.activeModelName = "";
       /** Cached schema for intelligent diffing during inference mode hot-swaps */
       this.parsedSchema = null;
+      /**
+       * Internal reference to the active debounce timeout.
+       * Prevents sequential redundant layouts from being generated when properties are set rapidly.
+       */
+      this._generateTimeoutId = null;
     },
     /**
      * Initializes the control and instantiates the composition delegates.
@@ -357,11 +363,25 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
       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.
+     * The core rendering pipeline entry point.
+     * Uses Promise resolution to debounce concurrent or rapid consecutive calls natively without arbitrary timeouts.
+     * @returns Promise that resolves when the layout is successfully built and mounted.
      */
-    generate: function _generate() {
+    generate: async function _generate() {
+      return Promise.resolve().then(async () => {
+        try {
+          await this._doGenerate();
+        } catch (e) {
+          Logger.error("[MetaUI]", "Error in deferred generate: " + e, "GeneratorHost");
+        }
+      });
+    },
+    /**
+     * The underlying synchronous generator orchestration method.
+     * Normalizes the schema, sets up the state manager, loads missing plugins over the network,
+     * orchestrates the Engine build, and mounts the generated UI components into the internal tree.
+     */
+    _doGenerate: async function _doGenerate() {
       try {
         this.tearDownGeneratedLayout();
 
@@ -416,6 +436,13 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
             }
           }
         }
+        const pathsToLoad = PluginRegistry.getInstance().getPathsToLoad(normalizedSchema);
+        const needsNetworkLoad = Array.from(pathsToLoad).some(path => !sap.ui.require(path));
+        if (needsNetworkLoad) {
+          this.setBusy(true);
+          await PluginRegistry.getInstance().preloadDependencies(normalizedSchema);
+          this.setBusy(false);
+        }
         this.activeModelName = "metaUI_" + this.getId();
         this.stateManager = new StateManager(finalData, normalizedSchema, this.activeModelName);
         this.setModel(this.stateManager.getModel(), this.activeModelName);
@@ -426,6 +453,7 @@ sap.ui.define(["sap/ui/core/Control", "../../utils/Logger", "../../core/SchemaNo
         const payload = this.stateManager.extractPayload();
         this.dataSyncDelegate.pushToBindings(payload);
       } catch (error) {
+        this.setBusy(false);
         Logger.error("[MetaUI]", "Fatal crash during layout generation: " + error.message, "GeneratorHost");
         this.validationDelegate.mountCrashBoundary(error);
       }