react-hook-toolkit 3.0.3 → 3.0.4

package/dist/chunk1516/chunk0021.d.ts

@@ -11,10 +11,30 @@ export declare function useIsMounted(): boolean;
 export declare function useCss(css: string): {
     error: Error | null;
 };
-export declare function useSpeak(text: string): {
-    speak: () => void;
+type VoiceStatus = 'idle' | 'playing' | 'paused' | 'ended' | 'error';
+interface ISpeakOptions {
+    rate?: number;
+    pitch?: number;
+    volume?: number;
+    lang?: string;
+    voice?: SpeechSynthesisVoice | null;
+    onStart?: () => void;
+    onEnd?: () => void;
+    onPause?: () => void;
+    onError?: (error: Error) => void;
+}
+interface ISpeakResult {
+    speak: (text: string, options?: ISpeakOptions) => void;
+    stop: () => void;
+    pause: () => void;
+    resume: () => void;
+    isPlaying: boolean;
+    isPaused: boolean;
+    status: VoiceStatus;
+    isSupported: boolean;
     error: Error | null;
-};
+}
+export declare function useSpeak(): ISpeakResult;
 export declare function useCountUp(target: number, duration: number): {
     count: number;
     error: Error | null;

package/dist/chunk1516/chunk0021.js

@@ -60,18 +60,136 @@ export function useCss(css) {
     }, [css]);
     return { error };
 }
-export function useSpeak(text) {
+const IS_SUPPORTED = typeof window !== 'undefined' && 'speechSynthesis' in window;
+export function useSpeak() {
+    const [status, setStatus] = useState('idle');
     const [error, setError] = useState(null);
-    const speak = () => {
-        try {
-            const utterance = new SpeechSynthesisUtterance(text);
-            speechSynthesis.speak(utterance);
+    const isMounted = useRef(true);
+    const utteranceRef = useRef(null);
+    const callbacksRef = useRef({});
+    // ── Derived state (no extra useState) ──────────────────────
+    const isPlaying = status === 'playing';
+    const isPaused = status === 'paused';
+    // ── Mount / Unmount ────────────────────────────────────────
+    useEffect(() => {
+        isMounted.current = true;
+        return () => {
+            var _a;
+            isMounted.current = false;
+            (_a = window.speechSynthesis) === null || _a === void 0 ? void 0 : _a.cancel();
+            utteranceRef.current = null;
+        };
+    }, []);
+    // ── Stable status setter ───────────────────────────────────
+    const safeSetStatus = useCallback((next) => {
+        if (isMounted.current)
+            setStatus(next);
+    }, []);
+    const safeSetError = useCallback((err) => {
+        if (isMounted.current)
+            setError(err);
+    }, []);
+    // ── Controls ───────────────────────────────────────────────
+    const stop = useCallback(() => {
+        var _a;
+        (_a = window.speechSynthesis) === null || _a === void 0 ? void 0 : _a.cancel();
+        safeSetStatus('idle');
+    }, [safeSetStatus]);
+    const pause = useCallback(() => {
+        var _a;
+        if (!isPlaying)
+            return;
+        (_a = window.speechSynthesis) === null || _a === void 0 ? void 0 : _a.pause();
+        safeSetStatus('paused');
+    }, [isPlaying, safeSetStatus]);
+    const resume = useCallback(() => {
+        var _a;
+        if (!isPaused)
+            return;
+        (_a = window.speechSynthesis) === null || _a === void 0 ? void 0 : _a.resume();
+        safeSetStatus('playing');
+    }, [isPaused, safeSetStatus]);
+    // ── Core speak ─────────────────────────────────────────────
+    const speak = useCallback((text, options = {}) => {
+        var _a, _b, _c, _d, _e;
+        // Guards
+        if (!IS_SUPPORTED) {
+            const err = new Error('SpeechSynthesis is not supported in this browser');
+            safeSetError(err);
+            (_a = options.onError) === null || _a === void 0 ? void 0 : _a.call(options, err);
+            return;
         }
-        catch (err) {
-            setError(err instanceof Error ? err : new Error('Failed to speak'));
+        const trimmed = text === null || text === void 0 ? void 0 : text.trim();
+        if (!trimmed) {
+            const err = new Error('Text cannot be empty');
+            safeSetError(err);
+            (_b = options.onError) === null || _b === void 0 ? void 0 : _b.call(options, err);
+            return;
         }
+        // Store latest callbacks in ref — avoids stale closure in handlers
+        callbacksRef.current = {
+            onStart: options.onStart,
+            onEnd: options.onEnd,
+            onPause: options.onPause,
+            onError: options.onError,
+        };
+        // Cancel any ongoing speech
+        window.speechSynthesis.cancel();
+        setError(null);
+        // Build utterance
+        const utterance = new SpeechSynthesisUtterance(trimmed);
+        utterance.rate = (_c = options.rate) !== null && _c !== void 0 ? _c : 1;
+        utterance.pitch = (_d = options.pitch) !== null && _d !== void 0 ? _d : 1;
+        utterance.volume = (_e = options.volume) !== null && _e !== void 0 ? _e : 1;
+        if (options.lang)
+            utterance.lang = options.lang;
+        if (options.voice)
+            utterance.voice = options.voice;
+        // ── Event handlers (read callbacks from ref — always fresh) ──
+        utterance.onstart = () => {
+            var _a, _b;
+            safeSetStatus('playing');
+            (_b = (_a = callbacksRef.current).onStart) === null || _b === void 0 ? void 0 : _b.call(_a);
+        };
+        utterance.onpause = () => {
+            var _a, _b;
+            safeSetStatus('paused');
+            (_b = (_a = callbacksRef.current).onPause) === null || _b === void 0 ? void 0 : _b.call(_a);
+        };
+        utterance.onresume = () => {
+            safeSetStatus('playing');
+        };
+        utterance.onend = () => {
+            var _a, _b;
+            safeSetStatus('ended');
+            (_b = (_a = callbacksRef.current).onEnd) === null || _b === void 0 ? void 0 : _b.call(_a);
+            utteranceRef.current = null;
+        };
+        utterance.onerror = (e) => {
+            var _a, _b;
+            // 'interrupted' fires on manual stop() — not a real error
+            if (e.error === 'interrupted' || e.error === 'canceled')
+                return;
+            const err = new Error(`Speech error: ${e.error}`);
+            safeSetStatus('error');
+            safeSetError(err);
+            (_b = (_a = callbacksRef.current).onError) === null || _b === void 0 ? void 0 : _b.call(_a, err);
+            utteranceRef.current = null;
+        };
+        utteranceRef.current = utterance;
+        window.speechSynthesis.speak(utterance);
+    }, [safeSetStatus, safeSetError]); // minimal deps — text passed at call time
+    return {
+        speak,
+        stop,
+        pause,
+        resume,
+        isPlaying,
+        isPaused,
+        status,
+        isSupported: IS_SUPPORTED,
+        error,
     };
-    return { speak, error };
 }
 export function useCountUp(target, duration) {
     const [count, setCount] = useState(0);

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import 'nprogress/nprogress.css';
 import { ReactHooksWrapper, getHook, setHook } from './chunk1415/chunk143';
 import { useHistoryState, useIdle, useIsFirstRender, useList, useLockBodyScroll, useLongPress, useRecentSearch, useSpeech, usePermission, usePageLeave, useMotion, useHoverDirty, useBeforeUnload, useClickAway, useResponsive, useUnmountedRef } from './chunk1516/chunk726433';
 import { useBrowser, useMenuNavigation, useNavigationState, useRouter } from './chunk1516/chunk0022';

package/dist/index.js

@@ -1,4 +1,3 @@
-import 'nprogress/nprogress.css';
 import { ReactHooksWrapper, getHook, setHook } from './chunk1415/chunk143';
 import { useHistoryState, useIdle, useIsFirstRender, useList, useLockBodyScroll, useLongPress, useRecentSearch, useSpeech, usePermission, usePageLeave, useMotion, useHoverDirty, useBeforeUnload, useClickAway, useResponsive, useUnmountedRef } from './chunk1516/chunk726433';
 import { useBrowser, useMenuNavigation, useNavigationState, useRouter } from './chunk1516/chunk0022';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-hook-toolkit",
-  "version": "3.0.3",
+  "version": "3.0.4",
   "description": "Ultimate package for React developers, offering a powerful collection of hooks and components to enhance their development experience.",
   "main": "dist/index.js",
   "module": "dist/index.js",