react-voice-to-speech 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Felipe Carrillo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+Since your project is a specialized React component for voice-to-speech, your README should focus on the **Web Speech API** requirements and clear usage instructions.
+
+Here is a professional `README.md` template:
+
+---
+
+# react-voice-to-speech
+
+A lightweight, customizable React component and hook for integrated **Voice-to-Text** functionality using the Web Speech API.
+
+## 🚀 Features
+
+* **Simple Integration:** Use the pre-built button and stile it to your needs.
+* **Real-time Overlay:** Built-in overlay UI for recording with live feedback.
+* **SCSS Support:** Easily themeable with CSS variables or custom classes.
+* **Modern Testing:** 100% test coverage using Vitest Browser Mode.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install react-voice-to-speech
+
+```
+
+## 🛠️ Usage
+
+### Basic Component
+
+The easiest way to get started is using the `BasicVoiceToSpeechButton`.
+
+```tsx
+import { BasicVoiceToSpeechButton } from 'react-voice-to-speech';
+import 'react-voice-to-speech/dist/index.css';
+
+function App() {
+  const handleText = (data: VoiceResult) => {
+    console.log("Transcribed text:", data.text);
+  };
+
+  return (
+    <BasicVoiceToSpeechButton
+      onDataReady={handleText} 
+      language="en-US"
+    />
+  );
+}
+```
+---
+
+### Advance Component
+
+For full customization build your own button in your preferred framework using the overlay `OverlayVoiceToSpeech`.
+
+```tsx
+import React, { useState } from 'react';
+import {useDetectVoiceSupport} from "./useDetectVoiceSupport";
+import {OverlayVoiceToSpeech} from "./OverlayVoiceToSpeech";
+import type {VoiceResult} from "./commonInterfaces";
+import 'react-voice-to-speech/dist/index.css';
+
+interface Props {
+    language?: string;
+    onTextReady: (data: VoiceResult) => void;
+    labels?: {[key:string]: string};
+}
+
+export const YourVoiceToSpeechButton: React.FC<Props> = ({ language = 'en', onTextReady, labels }) => {
+    const [isOpen, setIsOpen] = useState(false);
+    const isSupported = useDetectVoiceSupport();
+
+    const handleData = (data: VoiceResult) => {
+        setIsOpen(false);
+        if (typeof onTextReady === "function")
+            onTextReady(data);
+    };
+
+    return (
+        <>
+            { /* Your own button here! */ }
+            <button onClick={() => setIsOpen(true)} disabled={!isSupported}>🎤</button>
+            {isOpen && (
+                <OverlayVoiceToSpeech
+                    language={language}
+                    onDataReady={handleData}
+                    onClose={() => setIsOpen(false)}
+                    labels={labels}
+                />
+            )}
+        </>
+    );
+};
+```
+---
+
+## ⚙️ API Reference
+
+### `BasicVoiceToSpeechButton` Props
+
+| Prop          | Type | Default | Description                                       |
+|---------------| --- | --- |---------------------------------------------------|
+| `onDataReady` | `(text: VoiceResult) => void` | **Required** | Callback fired when transcription is complete.    |
+| `language`        | `string` | `'en-US'` | BCP 47 language tag (e.g., `'es-ES'`, `'fr-FR'`). |
+| `className`   | `string` |  | Custom class for the button.                      |
+| `id`           | `string` |  | Assign an id.                                     |
+| `style`           | `React.CSSProperties` |  | Style                                             |
+| `children`           | `React.ReactNode` |  | Use your own icon                                 |
+| `labels`      | `VoiceToSpeechLabels`      | `` | Labels.                                           |
+
+### `OverlayVoiceToSpeech` Props
+
+| Prop          | Type                          | Default | Description                                       |
+|---------------|-------------------------------| -- |---------------------------------------------------|
+| `onDataReady` | `(text: VoiceResult) => void` | **Required** | Callback fired when transcription is complete.    |
+| `language`    | `string`                      | `'en-US'` | BCP 47 language tag (e.g., `'es-ES'`, `'fr-FR'`). |
+| `labels`      | `VoiceToSpeechLabels`      | `` | Labels.                                           |
+
+---
+
+## 🎙️ Browser Support & Permissions
+
+This library relies on the **Web Speech API**.
+
+* **Supported:** Chrome, Edge, Safari.
+* **Not Supported:** Firefox (limited support), IE.
+* **Permissions:** Browsers require an active **HTTPS** connection (or `localhost`) to access the microphone.
+
+---
+
+## 🧪 Development & Testing
+
+We use **Vitest Browser Mode** to test the component in a real Chromium environment.
+
+```bash
+# Run tests
+npm run test
+
+# Run tests in watch mode (interactive)
+npm run test:watch
+
+```
+
+### Mocking Speech in Tests
+
+If you want to test your implementation without a physical microphone, see the `tests/voice.test.tsx` file for examples of mocking the `SpeechRecognition` global object.
+
+---
+
+## 📄 License
+
+MIT © [Your Name/Organization]
+
+---

package/dist/index.cjs

@@ -0,0 +1,469 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// src/OverlayVoiceToSpeech.tsx
+var _react = require('react'); var _react2 = _interopRequireDefault(_react);
+var _reactdom = require('react-dom');
+
+// src/soundEffects.ts
+var playTone = (freq, type, duration) => {
+  const AudioContextClass = window.AudioContext || window.webkitAudioContext;
+  const ctx = new AudioContextClass();
+  const osc = ctx.createOscillator();
+  const gain = ctx.createGain();
+  osc.type = type;
+  osc.frequency.setValueAtTime(freq, ctx.currentTime);
+  gain.gain.setValueAtTime(0, ctx.currentTime);
+  gain.gain.linearRampToValueAtTime(0.2, ctx.currentTime + 0.01);
+  gain.gain.exponentialRampToValueAtTime(0.01, ctx.currentTime + duration);
+  osc.connect(gain);
+  gain.connect(ctx.destination);
+  osc.start();
+  osc.stop(ctx.currentTime + duration);
+};
+var playStartSound = () => playTone(523.25, "sine", 0.15);
+var playSuccessSound = () => {
+  playTone(659.25, "sine", 0.1);
+  setTimeout(() => playTone(880, "sine", 0.2), 100);
+};
+var playErrorSound = () => {
+  playTone(220, "triangle", 0.1);
+  setTimeout(() => playTone(220, "triangle", 0.1), 150);
+};
+
+// src/commonInterfaces.ts
+var DefaultVoiceToSpeechLabels = {
+  recordButtonAria: "Start voice recording",
+  nothingReceived: "Didn't catch that. Try again?",
+  listeningText: "Listening...",
+  errorPermission: "Microphone access denied",
+  errorPrefix: "Error",
+  deniedIcon: "\u{1F6AB}",
+  errorIcon: "\u26A0\uFE0F"
+};
+
+// src/OverlayVoiceToSpeech.tsx
+var OverlayVoiceToSpeech = ({ language, onDataReady, onClose, labels, children }) => {
+  const [status, setStatus] = _react.useState.call(void 0, "listening");
+  const [errorMessage, setErrorMessage] = _react.useState.call(void 0, "");
+  const [interim, setInterim] = _react.useState.call(void 0, "");
+  const [volume, setVolume] = _react.useState.call(void 0, 0);
+  const recognitionRef = _react.useRef.call(void 0, null);
+  const streamRef = _react.useRef.call(void 0, null);
+  const audioContextRef = _react.useRef.call(void 0, null);
+  const timeoutRef = _react.useRef.call(void 0, null);
+  const uiLabels = { ...DefaultVoiceToSpeechLabels, ...labels };
+  const handleStop = (e) => {
+    e.stopPropagation();
+    if (status === "listening" && recognitionRef.current) {
+      recognitionRef.current.stop();
+      if (!interim) {
+        onClose();
+      }
+    }
+  };
+  const resetSilenceTimer = () => {
+    if (timeoutRef.current) clearTimeout(timeoutRef.current);
+    timeoutRef.current = setTimeout(() => {
+      setStatus((prevStatus) => {
+        if (prevStatus === "listening") {
+          playErrorSound();
+          setErrorMessage(uiLabels.nothingReceived);
+          if (recognitionRef.current) {
+            recognitionRef.current.onresult = null;
+            recognitionRef.current.abort();
+          }
+          setTimeout(() => onClose(), 2e3);
+          return "error";
+        }
+        return prevStatus;
+      });
+    }, 8e3);
+  };
+  _react.useEffect.call(void 0, () => {
+    let isMounted = true;
+    resetSilenceTimer();
+    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    const recog = new SpeechRecognition();
+    recog.continuous = true;
+    recog.interimResults = true;
+    recog.lang = language;
+    recog.onstart = () => {
+      playStartSound();
+    };
+    recog.onresult = (event) => {
+      resetSilenceTimer();
+      let currentInterim = "";
+      for (let i = event.resultIndex; i < event.results.length; ++i) {
+        if (event.results[i].isFinal) {
+          playSuccessSound();
+          setStatus("success");
+          const result = {
+            text: event.results[i][0].transcript,
+            confidence: event.results[i][0].confidence,
+            timestamp: Date.now()
+          };
+          setTimeout(() => {
+            if (isMounted) onDataReady(result);
+          }, 400);
+          return;
+        } else {
+          currentInterim += event.results[i][0].transcript;
+        }
+      }
+      if (isMounted) setInterim(currentInterim);
+    };
+    recog.onerror = (event) => {
+      if (event.error === "no-speech") return;
+      if (event.error === "aborted") return;
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+      if (event.error === "not-allowed") {
+        playErrorSound();
+        setStatus("denied");
+        setErrorMessage(uiLabels.errorPermission);
+        setTimeout(() => {
+          if (isMounted) onClose();
+        }, 2e3);
+      } else {
+        playErrorSound();
+        setStatus("error");
+        setErrorMessage(`${uiLabels.errorPrefix || "Error"}: ${event.error}`);
+        setTimeout(() => {
+          if (isMounted) onClose();
+        }, 2e3);
+      }
+    };
+    recog.start();
+    recognitionRef.current = recog;
+    let animationFrame;
+    navigator.mediaDevices.getUserMedia({ audio: true }).then((stream) => {
+      if (!isMounted) {
+        stream.getTracks().forEach((t) => t.stop());
+        return;
+      }
+      streamRef.current = stream;
+      const ctx = new (window.AudioContext || window.webkitAudioContext)();
+      audioContextRef.current = ctx;
+      const source = ctx.createMediaStreamSource(stream);
+      const analyzer = ctx.createAnalyser();
+      analyzer.fftSize = 64;
+      source.connect(analyzer);
+      const data = new Uint8Array(analyzer.frequencyBinCount);
+      const update = () => {
+        analyzer.getByteFrequencyData(data);
+        const avg = data.reduce((a, b) => a + b) / data.length;
+        if (isMounted) {
+          setVolume(avg);
+          animationFrame = requestAnimationFrame(update);
+        }
+      };
+      update();
+    }).catch(() => {
+      if (isMounted) {
+        setStatus("denied");
+        setErrorMessage(uiLabels.errorPermission);
+        setTimeout(() => {
+          if (isMounted) onClose();
+        }, 2e3);
+      }
+    });
+    return () => {
+      isMounted = false;
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+      if (recognitionRef.current) recognitionRef.current.abort();
+      if (streamRef.current) streamRef.current.getTracks().forEach((t) => t.stop());
+      if (audioContextRef.current) audioContextRef.current.close();
+      cancelAnimationFrame(animationFrame);
+    };
+  }, []);
+  return _reactdom.createPortal.call(void 0, 
+    /* @__PURE__ */ _react2.default.createElement("div", { className: "voice-overlay-backdrop", onClick: onClose }, /* @__PURE__ */ _react2.default.createElement("div", { className: "voice-modal", onClick: (e) => e.stopPropagation() }, status === "listening" || status === "success" ? /* @__PURE__ */ _react2.default.createElement(_react2.default.Fragment, null, /* @__PURE__ */ _react2.default.createElement("div", { className: "interim-text" }, status === "success" ? "" : interim || uiLabels.listeningText), /* @__PURE__ */ _react2.default.createElement(
+      "div",
+      {
+        className: `mic-section ${status}`,
+        onClick: handleStop,
+        style: { cursor: "pointer" }
+      },
+      /* @__PURE__ */ _react2.default.createElement(
+        "div",
+        {
+          className: "pulse-ring",
+          style: { transform: status === "success" ? "scale(1.2)" : `scale(${1 + volume / 50})` }
+        }
+      ),
+      /* @__PURE__ */ _react2.default.createElement("div", { className: "mic-circle" }, children)
+    )) : /* @__PURE__ */ _react2.default.createElement("div", { className: "status-container" }, /* @__PURE__ */ _react2.default.createElement("span", { className: "status-icon" }, status === "denied" ? uiLabels.deniedIcon : uiLabels.errorIcon), /* @__PURE__ */ _react2.default.createElement("div", { className: "error-message" }, errorMessage)))),
+    document.body
+  );
+};
+
+// src/OverlayVoiceToSpeechWithPunctuation.tsx
+
+
+
+// src/PunctuationLangMap.ts
+var PunctuationLangMap = {
+  // WESTERN / LATIN
+  en: { "comma": ",", "coma": ",", "period": ".", "full stop": ".", "question mark": "?", "exclamation point": "!", "colon": ":" },
+  es: { "coma": ",", "punto": ".", "signo de interrogaci\xF3n": "?", "interrogaci\xF3n": "?", "signo de exclamaci\xF3n": "!", "exclamaci\xF3n": "!", "dos puntos": ":" },
+  fr: { "virgule": ",", "point": ".", "point d'interrogation": "?", "point d'exclamation": "!", "deux points": ":" },
+  de: { "komma": ",", "punkt": ".", "fragezeichen": "?", "ausrufezeichen": "!", "doppelpunkt": ":" },
+  it: { "virgola": ",", "punto": ".", "punto interrogativo": "?", "punto esclamativo": "!", "due punti": ":" },
+  pt: { "v\xEDrgula": ",", "ponto": ".", "ponto de interroga\xE7\xE3o": "?", "ponto de exclama\xE7\xE3o": "!", "dois pontos": ":" },
+  nl: { "komma": ",", "punt": ".", "vraagteken": "?", "uitroepteken": "!", "dubbelpunt": ":" },
+  sv: { "komma": ",", "punkt": ".", "fr\xE5getecken": "?", "utropstecken": "!", "kolon": ":" },
+  no: { "komma": ",", "punkt": ".", "sp\xF8rsm\xE5lstegn": "?", "utropstegn": "!", "kolon": ":" },
+  da: { "komma": ",", "punkt": ".", "sp\xF8rgsm\xE5lstegn": "?", "udr\xE5bstegn": "!", "kolon": ":" },
+  fi: { "pilkku": ",", "piste": ".", "kysymysmerkki": "?", "huutomerkki": "!", "kaksoispiste": ":" },
+  pl: { "przecinek": ",", "kropka": ".", "znak zapytania": "?", "wykrzyknik": "!", "dwukropek": ":" },
+  cs: { "\u010D\xE1rka": ",", "te\u010Dka": ".", "otazn\xEDk": "?", "vyk\u0159i\u010Dn\xEDk": "!", "dvojte\u010Dka": ":" },
+  sk: { "\u010Diarka": ",", "bodka": ".", "ot\xE1znik": "?", "v\xFDkri\u010Dn\xEDk": "!", "dvojbodka": ":" },
+  ro: { "virgul\u0103": ",", "punct": ".", "semnul \xEEntreb\u0103rii": "?", "semnul exclam\u0103rii": "!", "dou\u0103 puncte": ":" },
+  hu: { "vessz\u0151": ",", "pont": ".", "k\xE9rd\u0151jel": "?", "felki\xE1lt\xF3jel": "!", "kett\u0151spont": ":" },
+  el: { "\u03BA\u03CC\u03BC\u03BC\u03B1": ",", "\u03C4\u03B5\u03BB\u03B5\u03AF\u03B1": ".", "\u03B5\u03C1\u03C9\u03C4\u03B7\u03BC\u03B1\u03C4\u03B9\u03BA\u03CC": ";", "\u03B8\u03B1\u03C5\u03BC\u03B1\u03C3\u03C4\u03B9\u03BA\u03CC": "!", "\u03AC\u03BD\u03C9 \u03BA\u03AC\u03C4\u03C9 \u03C4\u03B5\u03BB\u03B5\u03AF\u03B1": ":" },
+  // SLAVIC
+  ru: { "\u0437\u0430\u043F\u044F\u0442\u0430\u044F": ",", "\u0442\u043E\u0447\u043A\u0430": ".", "\u0432\u043E\u043F\u0440\u043E\u0441\u0438\u0442\u0435\u043B\u044C\u043D\u044B\u0439 \u0437\u043D\u0430\u043A": "?", "\u0432\u043E\u0441\u043A\u043B\u0438\u0446\u0430\u0442\u0435\u043B\u044C\u043D\u044B\u0439 \u0437\u043D\u0430\u043A": "!", "\u0434\u0432\u043E\u0435\u0442\u043E\u0447\u0438\u0435": ":" },
+  uk: { "\u043A\u043E\u043C\u0430": ",", "\u043A\u0440\u0430\u043F\u043A\u0430": ".", "\u0437\u043D\u0430\u043A \u043F\u0438\u0442\u0430\u043D\u043D\u044F": "?", "\u0437\u043D\u0430\u043A \u043E\u043A\u043B\u0438\u043A\u0443": "!", "\u0434\u0432\u043E\u043A\u0440\u0430\u043F\u043A\u0430": ":" },
+  bg: { "\u0437\u0430\u043F\u0435\u0442\u0430\u044F": ",", "\u0442\u043E\u0447\u043A\u0430": ".", "\u0432\u044A\u043F\u0440\u043E\u0441\u0438\u0442\u0435\u043B\u0435\u043D \u0437\u043D\u0430\u043A": "?", "\u0443\u0434\u0438\u0432\u0438\u0442\u0435\u043B\u0435\u043D \u0437\u043D\u0430\u043A": "!", "\u0434\u0432\u043E\u0435\u0442\u043E\u0447\u0438\u0435": ":" },
+  // ASIAN (Using full-width punctuation where applicable)
+  zh: { "\u9017\u53F7": "\uFF0C", "\u53E5\u53F7": "\u3002", "\u95EE\u53F7": "\uFF1F", "\u611F\u53F9\u53F7": "\uFF01", "\u5192\u53F7": "\uFF1A" },
+  ja: { "\u3066\u3093": "\u3001", "\u307E\u308B": "\u3002", "\u306F\u3066\u306A": "\uFF1F", "\u3073\u3063\u304F\u308A": "\uFF01", "\u30B3\u30ED\u30F3": "\uFF1A" },
+  ko: { "\uC27C\uD45C": ",", "\uB9C8\uCE68\uD45C": ".", "\uBB3C\uC74C\uD45C": "?", "\uB290\uB08C\uD45C": "!", "\uCF5C\uB860": ":" },
+  vi: { "d\u1EA5u ph\u1EA9y": ",", "d\u1EA5u ch\u1EA5m": ".", "d\u1EA5u h\u1ECFi": "?", "d\u1EA5u ch\u1EA5m than": "!", "d\u1EA5u hai ch\u1EA5m": ":" },
+  th: { "\u0E08\u0E38\u0E25\u0E20\u0E32\u0E04": ",", "\u0E21\u0E2B\u0E31\u0E1E\u0E20\u0E32\u0E04": ".", "\u0E1B\u0E23\u0E31\u0E28\u0E19\u0E35": "?", "\u0E2D\u0E31\u0E28\u0E40\u0E08\u0E23\u0E35\u0E22\u0E4C": "!", "\u0E17\u0E27\u0E34\u0E20\u0E32\u0E04": ":" },
+  // SEMITIC (RTL Support)
+  ar: { "\u0641\u0627\u0635\u0644\u0629": "\u060C", "\u0646\u0642\u0637\u0629": ".", "\u0639\u0644\u0627\u0645\u0629 \u0627\u0633\u062A\u0641\u0647\u0627\u0645": "\u061F", "\u0639\u0644\u0627\u0645\u0629 \u062A\u0639\u062C\u0628": "!", "\u0646\u0642\u0637\u062A\u0627\u0646": ":" },
+  he: { "\u05E4\u05E1\u05D9\u05E7": ",", "\u05E0\u05E7\u05D5\u05D3\u05D4": ".", "\u05E1\u05D9\u05DE\u05DF \u05E9\u05D0\u05DC\u05D4": "?", "\u05E1\u05D9\u05DE\u05DF \u05E7\u05E8\u05D9\u05D0\u05D4": "!", "\u05E0\u05E7\u05D5\u05D3\u05EA\u05D9\u05D9\u05DD": ":" },
+  fa: { "\u06A9\u0627\u0645\u0627": "\u060C", "\u0646\u0642\u0637\u0647": ".", "\u0639\u0644\u0627\u0645\u0629 \u0633\u0648\u0627\u0644": "\u061F", "\u0639\u0644\u0627\u0645\u0629 \u062A\u0639\u062C\u0628": "!", "\u062F\u0648 \u0646\u0642\u0637\u0647": ":" },
+  // SOUTH ASIAN
+  hi: { "\u0905\u0932\u094D\u092A\u0935\u093F\u0930\u093E\u092E": ",", "\u092A\u0942\u0930\u094D\u0923 \u0935\u093F\u0930\u093E\u092E": ".", "\u092A\u094D\u0930\u0936\u094D\u0928\u0935\u093E\u091A\u0915": "?", "\u0935\u093F\u0938\u094D\u092E\u092F\u093E\u0926\u093F\u092C\u094B\u0927\u0915": "!", "\u0915\u094B\u0932\u0928": ":" },
+  bn: { "\u0995\u09AE\u09BE": ",", "\u09A6\u09BE\u0981\u09A1\u09BC\u09BF": "\u0964", "\u09AA\u09CD\u09B0\u09B6\u09CD\u09A8\u09AC\u09CB\u09A7\u0995 \u099A\u09BF\u09B9\u09CD\u09A8": "?", "\u09AC\u09BF\u09B8\u09CD\u09AE\u09AF\u09BC\u09B8\u09C2\u099A\u0995 \u099A\u09BF\u09B9\u09CD\u09A8": "!", "\u0995\u09CB\u09B2\u09A8": ":" },
+  ta: { "\u0B95\u0BBE\u0BB1\u0BCD\u0BAA\u0BC1\u0BB3\u0BCD\u0BB3\u0BBF": ",", "\u0BAE\u0BC1\u0BB1\u0BCD\u0BB1\u0BC1\u0BAA\u0BCD\u0BAA\u0BC1\u0BB3\u0BCD\u0BB3\u0BBF": ".", "\u0B95\u0BC7\u0BB3\u0BCD\u0BB5\u0BBF\u0B95\u0BCD\u0B95\u0BC1\u0BB1\u0BBF": "?", "\u0BB5\u0BBF\u0BAF\u0BAA\u0BCD\u0BAA\u0BC1\u0B95\u0BCD\u0B95\u0BC1\u0BB1\u0BBF": "!", "\u0BAE\u0BC1\u0B95\u0BCD\u0B95\u0BB1\u0BCD\u0BAA\u0BC1\u0BB3\u0BCD\u0BB3\u0BBF": ":" },
+  te: { "\u0C15\u0C3E\u0C2E\u0C3E": ",", "\u0C2A\u0C41\u0C32\u0C4D\u200C\u0C38\u0C4D\u0C1F\u0C3E\u0C2A\u0C4D": ".", "\u0C2A\u0C4D\u0C30\u0C36\u0C4D\u0C28\u0C3E\u0C30\u0C4D\u0C25\u0C15\u0C02": "?", "\u0C06\u0C36\u0C4D\u0C1A\u0C30\u0C4D\u0C2F\u0C3E\u0C30\u0C4D\u0C25\u0C15\u0C02": "!", "\u0C15\u0C4B\u0C32\u0C28\u0C4D": ":" },
+  // OTHER MAJOR
+  tr: { "virg\xFCl": ",", "nokta": ".", "soru i\u015Fareti": "?", "\xFCnlem i\u015Fareti": "!", "iki nokta": ":" },
+  id: { "koma": ",", "titik": ".", "tanda tanya": "?", "tanda seru": "!", "titik dua": ":" },
+  ms: { "koma": ",", "titik": ".", "tanda soal": "?", "tanda seru": "!", "titik bertindih": ":" },
+  sw: { "mkato": ",", "nukta": ".", "alama ya swali": "?", "alama ya hisia": "!", "nukta mbili": ":" }
+};
+
+// src/OverlayVoiceToSpeechWithPunctuation.tsx
+var OverlayVoiceToSpeechWithPunctuation = ({ lang, onDataReady, onClose, labels, children }) => {
+  const [status, setStatus] = _react.useState.call(void 0, "listening");
+  const [errorMessage, setErrorMessage] = _react.useState.call(void 0, "");
+  const [interim, setInterim] = _react.useState.call(void 0, "");
+  const [volume, setVolume] = _react.useState.call(void 0, 0);
+  const recognitionRef = _react.useRef.call(void 0, null);
+  const streamRef = _react.useRef.call(void 0, null);
+  const audioContextRef = _react.useRef.call(void 0, null);
+  const timeoutRef = _react.useRef.call(void 0, null);
+  const uiLabels = { ...DefaultVoiceToSpeechLabels, ...labels };
+  const handleStop = (e) => {
+    e.stopPropagation();
+    if (status === "listening" && recognitionRef.current) {
+      recognitionRef.current.stop();
+      if (!interim) {
+        onClose();
+      }
+    }
+  };
+  const resetSilenceTimer = () => {
+    if (timeoutRef.current) clearTimeout(timeoutRef.current);
+    timeoutRef.current = setTimeout(() => {
+      setStatus((prevStatus) => {
+        if (prevStatus === "listening") {
+          playErrorSound();
+          setErrorMessage(uiLabels.nothingReceived);
+          if (recognitionRef.current) {
+            recognitionRef.current.onresult = null;
+            recognitionRef.current.abort();
+          }
+          setTimeout(() => onClose(), 2e3);
+          return "error";
+        }
+        return prevStatus;
+      });
+    }, 8e3);
+  };
+  _react.useEffect.call(void 0, () => {
+    let isMounted = true;
+    resetSilenceTimer();
+    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    const recog = new SpeechRecognition();
+    recog.continuous = true;
+    recog.interimResults = true;
+    recog.lang = lang;
+    recog.onstart = () => {
+      playStartSound();
+    };
+    recog.onresult = (event) => {
+      resetSilenceTimer();
+      let currentInterim = "";
+      const shortLang = lang.split("-")[0].toLowerCase();
+      const activeMap = PunctuationLangMap[shortLang] || PunctuationLangMap["en"];
+      const sortedKeys = Object.keys(activeMap).sort((a, b) => b.length - a.length);
+      for (let i = event.resultIndex; i < event.results.length; ++i) {
+        let transcript = event.results[i][0].transcript;
+        sortedKeys.forEach((key) => {
+          const isNoSpaceLang = ["zh", "ja", "th"].includes(shortLang);
+          if (isNoSpaceLang) {
+            const regex = new RegExp(key, "gi");
+            transcript = transcript.replace(regex, activeMap[key]);
+          } else {
+            const regex = new RegExp(`\\s*${key}\\s*`, "gi");
+            transcript = transcript.replace(regex, ` ${activeMap[key]} `);
+          }
+        });
+        transcript = transcript.replace(/\s+/g, " ").replace(/\s([,.!?;:])/g, "$1").trim();
+        if (event.results[i].isFinal) {
+          playSuccessSound();
+          setStatus("success");
+          const result = {
+            text: transcript,
+            confidence: event.results[i][0].confidence,
+            timestamp: Date.now()
+          };
+          setTimeout(() => {
+            if (isMounted) onDataReady(result);
+          }, 400);
+          return;
+        } else {
+          currentInterim += transcript;
+        }
+      }
+      if (isMounted) setInterim(currentInterim);
+    };
+    recog.onerror = (event) => {
+      if (event.error === "no-speech") return;
+      if (event.error === "aborted") return;
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+      if (event.error === "not-allowed") {
+        playErrorSound();
+        setStatus("denied");
+        setErrorMessage(uiLabels.errorPermission);
+        setTimeout(() => {
+          if (isMounted) onClose();
+        }, 2e3);
+      } else {
+        playErrorSound();
+        setStatus("error");
+        setErrorMessage(`${uiLabels.errorPrefix || "Error"}: ${event.error}`);
+        setTimeout(() => {
+          if (isMounted) onClose();
+        }, 2e3);
+      }
+    };
+    recog.start();
+    recognitionRef.current = recog;
+    let animationFrame;
+    navigator.mediaDevices.getUserMedia({ audio: true }).then((stream) => {
+      if (!isMounted) {
+        stream.getTracks().forEach((t) => t.stop());
+        return;
+      }
+      streamRef.current = stream;
+      const ctx = new (window.AudioContext || window.webkitAudioContext)();
+      audioContextRef.current = ctx;
+      const source = ctx.createMediaStreamSource(stream);
+      const analyzer = ctx.createAnalyser();
+      analyzer.fftSize = 64;
+      source.connect(analyzer);
+      const data = new Uint8Array(analyzer.frequencyBinCount);
+      const update = () => {
+        analyzer.getByteFrequencyData(data);
+        const avg = data.reduce((a, b) => a + b) / data.length;
+        if (isMounted) {
+          setVolume(avg);
+          animationFrame = requestAnimationFrame(update);
+        }
+      };
+      update();
+    }).catch(() => {
+      if (isMounted) {
+        setStatus("denied");
+        setErrorMessage(uiLabels.errorPermission);
+        setTimeout(() => {
+          if (isMounted) onClose();
+        }, 2e3);
+      }
+    });
+    return () => {
+      isMounted = false;
+      if (timeoutRef.current) clearTimeout(timeoutRef.current);
+      if (recognitionRef.current) recognitionRef.current.abort();
+      if (streamRef.current) streamRef.current.getTracks().forEach((t) => t.stop());
+      if (audioContextRef.current) audioContextRef.current.close();
+      cancelAnimationFrame(animationFrame);
+    };
+  }, [lang]);
+  return _reactdom.createPortal.call(void 0, 
+    /* @__PURE__ */ _react2.default.createElement("div", { className: "voice-overlay-backdrop", onClick: onClose }, /* @__PURE__ */ _react2.default.createElement("div", { className: "voice-modal", onClick: (e) => e.stopPropagation() }, status === "listening" || status === "success" ? /* @__PURE__ */ _react2.default.createElement(_react2.default.Fragment, null, /* @__PURE__ */ _react2.default.createElement("div", { className: "interim-text" }, status === "success" ? "" : interim || uiLabels.listeningText), /* @__PURE__ */ _react2.default.createElement(
+      "div",
+      {
+        className: `mic-section ${status}`,
+        onClick: handleStop,
+        style: { cursor: "pointer" }
+      },
+      /* @__PURE__ */ _react2.default.createElement(
+        "div",
+        {
+          className: "pulse-ring",
+          style: { transform: status === "success" ? "scale(1.2)" : `scale(${1 + volume / 50})` }
+        }
+      ),
+      /* @__PURE__ */ _react2.default.createElement("div", { className: "mic-circle" }, children)
+    )) : /* @__PURE__ */ _react2.default.createElement("div", { className: "status-container" }, /* @__PURE__ */ _react2.default.createElement("span", { className: "status-icon" }, status === "denied" ? uiLabels.deniedIcon : uiLabels.errorIcon), /* @__PURE__ */ _react2.default.createElement("div", { className: "error-message" }, errorMessage)))),
+    document.body
+  );
+};
+
+// src/BasicVoiceToSpeechButton.tsx
+
+
+// src/useDetectVoiceSupport.ts
+
+var useDetectVoiceSupport = () => {
+  const [isSupported] = _react.useState.call(void 0, () => {
+    if (typeof window === "undefined") return false;
+    const hasAPI = !!(window.SpeechRecognition || window.webkitSpeechRecognition);
+    const isSecure = window.isSecureContext;
+    return hasAPI && isSecure;
+  });
+  return isSupported;
+};
+
+// src/BasicVoiceToSpeechButton.tsx
+var BasicVoiceToSpeechButton = ({ lang = "en", onDataReady, className, id, style, children, labels }) => {
+  const [isOpen, setIsOpen] = _react.useState.call(void 0, false);
+  const isSupported = useDetectVoiceSupport();
+  const handleData = (data) => {
+    setIsOpen(false);
+    if (typeof onDataReady === "function")
+      onDataReady(data);
+  };
+  const uiLabels = { ...DefaultVoiceToSpeechLabels, ...labels };
+  return /* @__PURE__ */ _react2.default.createElement(_react2.default.Fragment, null, /* @__PURE__ */ _react2.default.createElement(
+    "button",
+    {
+      onClick: () => setIsOpen(true),
+      disabled: !isSupported,
+      className,
+      id,
+      style,
+      "aria-label": uiLabels.recordButtonAria
+    },
+    children || "\u{1F3A4}"
+  ), isOpen && /* @__PURE__ */ _react2.default.createElement(
+    OverlayVoiceToSpeech,
+    {
+      language: lang,
+      labels,
+      onDataReady: handleData,
+      onClose: () => setIsOpen(false)
+    }
+  ));
+};
+
+
+
+
+
+
+exports.BasicVoiceToSpeechButton = BasicVoiceToSpeechButton; exports.DefaultVoiceToSpeechLabels = DefaultVoiceToSpeechLabels; exports.OverlayVoiceToSpeech = OverlayVoiceToSpeech; exports.OverlayVoiceToSpeechWithPunctuation = OverlayVoiceToSpeechWithPunctuation; exports.useDetectVoiceSupport = useDetectVoiceSupport;