@dreamtree-org/twreact-ui 1.1.11 → 1.1.12

package/dist/index.esm.js

@@ -15953,9 +15953,19 @@ var SpeechToText = /*#__PURE__*/forwardRef(function (_ref, ref) {
     _ref$autoStart = _ref.autoStart,
     autoStart = _ref$autoStart === void 0 ? false : _ref$autoStart,
     _ref$disabled = _ref.disabled,
-    disabled = _ref$disabled === void 0 ? false : _ref$disabled;
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    _ref$maxAlternatives = _ref.maxAlternatives,
+    maxAlternatives = _ref$maxAlternatives === void 0 ? 1 : _ref$maxAlternatives,
+    _ref$grammars = _ref.grammars,
+    grammars = _ref$grammars === void 0 ? null : _ref$grammars,
+    _ref$timeout = _ref.timeout,
+    timeout = _ref$timeout === void 0 ? null : _ref$timeout,
+    _ref$clearOnStop = _ref.clearOnStop,
+    clearOnStop = _ref$clearOnStop === void 0 ? false : _ref$clearOnStop;
   var recognitionRef = useRef(null);
   var finalTranscriptRef = useRef("");
+  var timeoutRef = useRef(null);
+  var isMountedRef = useRef(true);
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     _isListening = _useState2[0],
@@ -15964,34 +15974,48 @@ var SpeechToText = /*#__PURE__*/forwardRef(function (_ref, ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     _isSupported = _useState4[0],
     setIsSupported = _useState4[1];
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    error = _useState6[0],
+    setError = _useState6[1];
+
+  // Check browser support
   useEffect(function () {
-    if (!("webkitSpeechRecognition" in window) && !("SpeechRecognition" in window)) {
-      setIsSupported(false);
-    } else {
-      setIsSupported(true);
+    var supported = "webkitSpeechRecognition" in window || "SpeechRecognition" in window;
+    setIsSupported(supported);
+    if (!supported) {
+      var err = new Error("Speech recognition not supported in this browser");
+      setError(err);
+      onError(err);
     }
-  }, []);
-  useEffect(function () {
-    if (autoStart && _isSupported) {
-      startListening();
+  }, [onError]);
+
+  // Clear timeout helper
+  var clearInactivityTimeout = useCallback(function () {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
     }
-    return function () {
-      if (recognitionRef.current) {
-        try {
-          recognitionRef.current.onresult = null;
-          recognitionRef.current.onerror = null;
-          recognitionRef.current.onend = null;
-          recognitionRef.current.onstart = null;
-          recognitionRef.current.stop();
-        } catch (e) {}
+  }, []);
+
+  // Reset inactivity timeout
+  var resetInactivityTimeout = useCallback(function () {
+    if (!timeout) return;
+    clearInactivityTimeout();
+    timeoutRef.current = setTimeout(function () {
+      if (recognitionRef.current && _isListening) {
+        stopListening();
       }
-    };
-  }, [autoStart, _isSupported]);
-  function initializeRecognition() {
+    }, timeout);
+  }, [timeout, _isListening]);
+
+  // Initialize recognition
+  var initializeRecognition = useCallback(function () {
     if (recognitionRef.current) return recognitionRef.current;
     var SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
     if (!SpeechRecognition) {
       var err = new Error("SpeechRecognition API not available");
+      setError(err);
       onError(err);
       return null;
     }
@@ -15999,12 +16023,21 @@ var SpeechToText = /*#__PURE__*/forwardRef(function (_ref, ref) {
     recognition.continuous = !!continuous;
     recognition.interimResults = !!interimResults;
     recognition.lang = lang;
+    recognition.maxAlternatives = maxAlternatives;
+    if (grammars) {
+      recognition.grammars = grammars;
+    }
     recognition.onstart = function () {
+      if (!isMountedRef.current) return;
       finalTranscriptRef.current = finalTranscriptRef.current || "";
       setIsListening(true);
+      setError(null);
+      resetInactivityTimeout();
       onStart();
     };
     recognition.onresult = function (event) {
+      if (!isMountedRef.current) return;
+      resetInactivityTimeout();
       var interim = "";
       var finalPart = "";
       for (var i = event.resultIndex; i < event.results.length; i++) {
@@ -16024,21 +16057,48 @@ var SpeechToText = /*#__PURE__*/forwardRef(function (_ref, ref) {
       }
     };
     recognition.onerror = function (event) {
-      var err = event && event.error ? new Error(event.error) : new Error("Speech recognition error");
-      onError(err);
+      if (!isMountedRef.current) return;
+      clearInactivityTimeout();
+      var errorMessage = (event === null || event === void 0 ? void 0 : event.error) || "Speech recognition error";
+      var err = new Error(errorMessage);
+      setError(err);
       setIsListening(false);
+      onError(err);
+
+      // Handle specific errors
+      if (errorMessage === "not-allowed" || errorMessage === "service-not-allowed") {
+        console.warn("Microphone permission denied");
+      } else if (errorMessage === "no-speech") {
+        console.warn("No speech detected");
+      } else if (errorMessage === "aborted") {
+        console.warn("Speech recognition aborted");
+      }
     };
     recognition.onend = function () {
+      if (!isMountedRef.current) return;
+      clearInactivityTimeout();
       setIsListening(false);
+      var finalText = (finalTranscriptRef.current || "").trim();
+      onSpeechComplete(finalText);
       onStop();
-      onSpeechComplete((finalTranscriptRef.current || "").trim());
+      if (clearOnStop) {
+        finalTranscriptRef.current = "";
+      }
     };
     recognitionRef.current = recognition;
     return recognition;
-  }
-  function startListening() {
+  }, [continuous, interimResults, lang, maxAlternatives, grammars, onStart, onSpeaking, onSpeechComplete, onError, onStop, clearOnStop, resetInactivityTimeout, clearInactivityTimeout]);
+
+  // Start listening
+  var startListening = useCallback(function () {
     if (!_isSupported) {
-      onError(new Error("Speech recognition not supported in this browser"));
+      var err = new Error("Speech recognition not supported in this browser");
+      setError(err);
+      onError(err);
+      return;
+    }
+    if (_isListening) {
+      console.warn("Already listening");
       return;
     }
     try {
@@ -16046,24 +16106,68 @@ var SpeechToText = /*#__PURE__*/forwardRef(function (_ref, ref) {
       if (!rec) return;
       rec.start();
     } catch (err) {
+      var _err$message;
+      // Handle "already started" error
+      if ((_err$message = err.message) !== null && _err$message !== void 0 && _err$message.includes("already started")) {
+        console.warn("Recognition already in progress");
+        return;
+      }
+      setError(err);
       onError(err);
     }
-  }
-  function stopListening() {
+  }, [_isSupported, _isListening, initializeRecognition, onError]);
+
+  // Stop listening
+  var stopListening = useCallback(function () {
     if (recognitionRef.current) {
       try {
+        clearInactivityTimeout();
         recognitionRef.current.stop();
-      } catch (e) {}
+      } catch (err) {
+        console.error("Error stopping recognition:", err);
+      }
     }
-  }
-  function toggleListening() {
+  }, [clearInactivityTimeout]);
+
+  // Toggle listening
+  var toggleListening = useCallback(function () {
     if (disabled) return;
     if (_isListening) {
       stopListening();
     } else {
       startListening();
     }
-  }
+  }, [disabled, _isListening, startListening, stopListening]);
+
+  // Auto-start effect
+  useEffect(function () {
+    if (autoStart && _isSupported && !disabled) {
+      startListening();
+    }
+  }, [autoStart, _isSupported, disabled, startListening]);
+
+  // Cleanup on unmount
+  useEffect(function () {
+    isMountedRef.current = true;
+    return function () {
+      isMountedRef.current = false;
+      clearInactivityTimeout();
+      if (recognitionRef.current) {
+        try {
+          recognitionRef.current.onresult = null;
+          recognitionRef.current.onerror = null;
+          recognitionRef.current.onend = null;
+          recognitionRef.current.onstart = null;
+          recognitionRef.current.stop();
+        } catch (err) {
+          console.error("Cleanup error:", err);
+        }
+        recognitionRef.current = null;
+      }
+    };
+  }, [clearInactivityTimeout]);
+
+  // Imperative handle
   useImperativeHandle(ref, function () {
     return {
       start: startListening,
@@ -16080,26 +16184,39 @@ var SpeechToText = /*#__PURE__*/forwardRef(function (_ref, ref) {
       },
       clearTranscript: function clearTranscript() {
         finalTranscriptRef.current = "";
+      },
+      getError: function getError() {
+        return error;
       }
     };
-  }, [_isListening, _isSupported]);
+  }, [_isListening, _isSupported, error, startListening, stopListening, toggleListening]);
+
+  // Custom button renderer
   if (renderButton && typeof renderButton === "function") {
     return renderButton({
       isListening: _isListening,
       isSupported: _isSupported,
+      error: error,
       start: startListening,
       stop: stopListening,
       toggle: toggleListening,
-      disabled: disabled
+      disabled: disabled || !_isSupported
     });
   }
+
+  // Default button
   return /*#__PURE__*/React__default.createElement("button", {
     type: "button",
     "aria-pressed": _isListening,
+    "aria-label": _isListening ? "Stop listening" : "Start listening",
     onClick: toggleListening,
-    disabled: disabled || !_isSupported
-  }, _isListening ? "Stop" : "Start");
+    disabled: disabled || !_isSupported,
+    style: {
+      cursor: disabled || !_isSupported ? "not-allowed" : "pointer"
+    }
+  }, _isListening ? "🎤 Stop" : "🎤 Start");
 });
+SpeechToText.displayName = "SpeechToText";
 
 var TextToSpeech = function TextToSpeech(_ref) {
   var _ref$text = _ref.text,

package/dist/index.js

@@ -15973,9 +15973,19 @@ var SpeechToText = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _ref$autoStart = _ref.autoStart,
     autoStart = _ref$autoStart === void 0 ? false : _ref$autoStart,
     _ref$disabled = _ref.disabled,
-    disabled = _ref$disabled === void 0 ? false : _ref$disabled;
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
+    _ref$maxAlternatives = _ref.maxAlternatives,
+    maxAlternatives = _ref$maxAlternatives === void 0 ? 1 : _ref$maxAlternatives,
+    _ref$grammars = _ref.grammars,
+    grammars = _ref$grammars === void 0 ? null : _ref$grammars,
+    _ref$timeout = _ref.timeout,
+    timeout = _ref$timeout === void 0 ? null : _ref$timeout,
+    _ref$clearOnStop = _ref.clearOnStop,
+    clearOnStop = _ref$clearOnStop === void 0 ? false : _ref$clearOnStop;
   var recognitionRef = React.useRef(null);
   var finalTranscriptRef = React.useRef("");
+  var timeoutRef = React.useRef(null);
+  var isMountedRef = React.useRef(true);
   var _useState = React.useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     _isListening = _useState2[0],
@@ -15984,34 +15994,48 @@ var SpeechToText = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     _isSupported = _useState4[0],
     setIsSupported = _useState4[1];
+  var _useState5 = React.useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    error = _useState6[0],
+    setError = _useState6[1];
+
+  // Check browser support
   React.useEffect(function () {
-    if (!("webkitSpeechRecognition" in window) && !("SpeechRecognition" in window)) {
-      setIsSupported(false);
-    } else {
-      setIsSupported(true);
+    var supported = "webkitSpeechRecognition" in window || "SpeechRecognition" in window;
+    setIsSupported(supported);
+    if (!supported) {
+      var err = new Error("Speech recognition not supported in this browser");
+      setError(err);
+      onError(err);
     }
-  }, []);
-  React.useEffect(function () {
-    if (autoStart && _isSupported) {
-      startListening();
+  }, [onError]);
+
+  // Clear timeout helper
+  var clearInactivityTimeout = React.useCallback(function () {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
     }
-    return function () {
-      if (recognitionRef.current) {
-        try {
-          recognitionRef.current.onresult = null;
-          recognitionRef.current.onerror = null;
-          recognitionRef.current.onend = null;
-          recognitionRef.current.onstart = null;
-          recognitionRef.current.stop();
-        } catch (e) {}
+  }, []);
+
+  // Reset inactivity timeout
+  var resetInactivityTimeout = React.useCallback(function () {
+    if (!timeout) return;
+    clearInactivityTimeout();
+    timeoutRef.current = setTimeout(function () {
+      if (recognitionRef.current && _isListening) {
+        stopListening();
       }
-    };
-  }, [autoStart, _isSupported]);
-  function initializeRecognition() {
+    }, timeout);
+  }, [timeout, _isListening]);
+
+  // Initialize recognition
+  var initializeRecognition = React.useCallback(function () {
     if (recognitionRef.current) return recognitionRef.current;
     var SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
     if (!SpeechRecognition) {
       var err = new Error("SpeechRecognition API not available");
+      setError(err);
       onError(err);
       return null;
     }
@@ -16019,12 +16043,21 @@ var SpeechToText = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
     recognition.continuous = !!continuous;
     recognition.interimResults = !!interimResults;
     recognition.lang = lang;
+    recognition.maxAlternatives = maxAlternatives;
+    if (grammars) {
+      recognition.grammars = grammars;
+    }
     recognition.onstart = function () {
+      if (!isMountedRef.current) return;
       finalTranscriptRef.current = finalTranscriptRef.current || "";
       setIsListening(true);
+      setError(null);
+      resetInactivityTimeout();
       onStart();
     };
     recognition.onresult = function (event) {
+      if (!isMountedRef.current) return;
+      resetInactivityTimeout();
       var interim = "";
       var finalPart = "";
       for (var i = event.resultIndex; i < event.results.length; i++) {
@@ -16044,21 +16077,48 @@ var SpeechToText = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       }
     };
     recognition.onerror = function (event) {
-      var err = event && event.error ? new Error(event.error) : new Error("Speech recognition error");
-      onError(err);
+      if (!isMountedRef.current) return;
+      clearInactivityTimeout();
+      var errorMessage = (event === null || event === void 0 ? void 0 : event.error) || "Speech recognition error";
+      var err = new Error(errorMessage);
+      setError(err);
       setIsListening(false);
+      onError(err);
+
+      // Handle specific errors
+      if (errorMessage === "not-allowed" || errorMessage === "service-not-allowed") {
+        console.warn("Microphone permission denied");
+      } else if (errorMessage === "no-speech") {
+        console.warn("No speech detected");
+      } else if (errorMessage === "aborted") {
+        console.warn("Speech recognition aborted");
+      }
     };
     recognition.onend = function () {
+      if (!isMountedRef.current) return;
+      clearInactivityTimeout();
       setIsListening(false);
+      var finalText = (finalTranscriptRef.current || "").trim();
+      onSpeechComplete(finalText);
       onStop();
-      onSpeechComplete((finalTranscriptRef.current || "").trim());
+      if (clearOnStop) {
+        finalTranscriptRef.current = "";
+      }
     };
     recognitionRef.current = recognition;
     return recognition;
-  }
-  function startListening() {
+  }, [continuous, interimResults, lang, maxAlternatives, grammars, onStart, onSpeaking, onSpeechComplete, onError, onStop, clearOnStop, resetInactivityTimeout, clearInactivityTimeout]);
+
+  // Start listening
+  var startListening = React.useCallback(function () {
     if (!_isSupported) {
-      onError(new Error("Speech recognition not supported in this browser"));
+      var err = new Error("Speech recognition not supported in this browser");
+      setError(err);
+      onError(err);
+      return;
+    }
+    if (_isListening) {
+      console.warn("Already listening");
       return;
     }
     try {
@@ -16066,24 +16126,68 @@ var SpeechToText = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       if (!rec) return;
       rec.start();
     } catch (err) {
+      var _err$message;
+      // Handle "already started" error
+      if ((_err$message = err.message) !== null && _err$message !== void 0 && _err$message.includes("already started")) {
+        console.warn("Recognition already in progress");
+        return;
+      }
+      setError(err);
       onError(err);
     }
-  }
-  function stopListening() {
+  }, [_isSupported, _isListening, initializeRecognition, onError]);
+
+  // Stop listening
+  var stopListening = React.useCallback(function () {
     if (recognitionRef.current) {
       try {
+        clearInactivityTimeout();
         recognitionRef.current.stop();
-      } catch (e) {}
+      } catch (err) {
+        console.error("Error stopping recognition:", err);
+      }
     }
-  }
-  function toggleListening() {
+  }, [clearInactivityTimeout]);
+
+  // Toggle listening
+  var toggleListening = React.useCallback(function () {
     if (disabled) return;
     if (_isListening) {
       stopListening();
     } else {
       startListening();
     }
-  }
+  }, [disabled, _isListening, startListening, stopListening]);
+
+  // Auto-start effect
+  React.useEffect(function () {
+    if (autoStart && _isSupported && !disabled) {
+      startListening();
+    }
+  }, [autoStart, _isSupported, disabled, startListening]);
+
+  // Cleanup on unmount
+  React.useEffect(function () {
+    isMountedRef.current = true;
+    return function () {
+      isMountedRef.current = false;
+      clearInactivityTimeout();
+      if (recognitionRef.current) {
+        try {
+          recognitionRef.current.onresult = null;
+          recognitionRef.current.onerror = null;
+          recognitionRef.current.onend = null;
+          recognitionRef.current.onstart = null;
+          recognitionRef.current.stop();
+        } catch (err) {
+          console.error("Cleanup error:", err);
+        }
+        recognitionRef.current = null;
+      }
+    };
+  }, [clearInactivityTimeout]);
+
+  // Imperative handle
   React.useImperativeHandle(ref, function () {
     return {
       start: startListening,
@@ -16100,26 +16204,39 @@ var SpeechToText = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
       },
       clearTranscript: function clearTranscript() {
         finalTranscriptRef.current = "";
+      },
+      getError: function getError() {
+        return error;
       }
     };
-  }, [_isListening, _isSupported]);
+  }, [_isListening, _isSupported, error, startListening, stopListening, toggleListening]);
+
+  // Custom button renderer
   if (renderButton && typeof renderButton === "function") {
     return renderButton({
       isListening: _isListening,
       isSupported: _isSupported,
+      error: error,
       start: startListening,
       stop: stopListening,
       toggle: toggleListening,
-      disabled: disabled
+      disabled: disabled || !_isSupported
     });
   }
+
+  // Default button
   return /*#__PURE__*/React.createElement("button", {
     type: "button",
     "aria-pressed": _isListening,
+    "aria-label": _isListening ? "Stop listening" : "Start listening",
     onClick: toggleListening,
-    disabled: disabled || !_isSupported
-  }, _isListening ? "Stop" : "Start");
+    disabled: disabled || !_isSupported,
+    style: {
+      cursor: disabled || !_isSupported ? "not-allowed" : "pointer"
+    }
+  }, _isListening ? "🎤 Stop" : "🎤 Start");
 });
+SpeechToText.displayName = "SpeechToText";
 
 var TextToSpeech = function TextToSpeech(_ref) {
   var _ref$text = _ref.text,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamtree-org/twreact-ui",
-  "version": "1.1.11",
+  "version": "1.1.12",
   "description": "A comprehensive React + Tailwind components library for building modern web apps",
   "author": {
     "name": "Partha Preetham Krishna",