react-hook-toolkit 3.0.2 → 3.0.4

package/dist/chunk1516/chunk0022.js

@@ -1,70 +1,25 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { flattenArrayByKey, navigateTo } from "../utils";
-export var useBrowser = function () {
+export const useBrowser = () => {
     var _a, _b;
-    var _c = useState(new URL(window.location.href)), currentUrl = _c[0], setCurrentUrl = _c[1];
-    var _d = useState({
+    const [currentUrl, setCurrentUrl] = useState(new URL(window.location.href));
+    const [historyState, setHistoryState] = useState({
         canGoBack: ((_a = window.history.state) === null || _a === void 0 ? void 0 : _a.idx) > 0,
         canGoForward: ((_b = window.history.state) === null || _b === void 0 ? void 0 : _b.idx) < window.history.length - 1,
         historyLength: window.history.length,
-    }), historyState = _d[0], setHistoryState = _d[1];
-    var _e = useState(navigator.onLine), isOnline = _e[0], setIsOnline = _e[1];
-    var _f = useState(false), isFullscreen = _f[0], setIsFullscreen = _f[1];
-    var _g = useState({
+    });
+    const [isOnline, setIsOnline] = useState(navigator.onLine);
+    const [isFullscreen, setIsFullscreen] = useState(false);
+    const [viewportSize, setViewportSize] = useState({
         width: window.innerWidth,
         height: window.innerHeight,
-    }), viewportSize = _g[0], setViewportSize = _g[1];
-    var _h = useState({
+    });
+    const [screenSize, setScreenSize] = useState({
         width: window.screen.width,
         height: window.screen.height,
-    }), screenSize = _h[0], setScreenSize = _h[1];
+    });
     // Update URL and history state when changes occur
-    var updateState = useCallback(function () {
+    const updateState = useCallback(() => {
         var _a, _b;
         setCurrentUrl(new URL(window.location.href));
         setHistoryState({
@@ -74,11 +29,11 @@ export var useBrowser = function () {
         });
     }, []);
     // Event listeners setup
-    useEffect(function () {
-        var handlePopState = function () { return updateState(); };
-        var handleOnline = function () { return setIsOnline(true); };
-        var handleOffline = function () { return setIsOnline(false); };
-        var handleResize = function () {
+    useEffect(() => {
+        const handlePopState = () => updateState();
+        const handleOnline = () => setIsOnline(true);
+        const handleOffline = () => setIsOnline(false);
+        const handleResize = () => {
             setViewportSize({
                 width: window.innerWidth,
                 height: window.innerHeight,
@@ -88,7 +43,7 @@ export var useBrowser = function () {
                 height: window.screen.height,
             });
         };
-        var handleFullscreenChange = function () {
+        const handleFullscreenChange = () => {
             setIsFullscreen(!!document.fullscreenElement);
         };
         window.addEventListener('popstate', handlePopState);
@@ -96,7 +51,7 @@ export var useBrowser = function () {
         window.addEventListener('offline', handleOffline);
         window.addEventListener('resize', handleResize);
         document.addEventListener('fullscreenchange', handleFullscreenChange);
-        return function () {
+        return () => {
             window.removeEventListener('popstate', handlePopState);
             window.removeEventListener('online', handleOnline);
             window.removeEventListener('offline', handleOffline);
@@ -104,7 +59,7 @@ export var useBrowser = function () {
             document.removeEventListener('fullscreenchange', handleFullscreenChange);
         };
     }, [updateState]);
-    var goBack = useCallback(function () {
+    const goBack = useCallback(() => {
         try {
             if (historyState.canGoBack) {
                 window.history.back();
@@ -118,7 +73,7 @@ export var useBrowser = function () {
             window.location.href = '/';
         }
     }, [historyState.canGoBack]);
-    var goForward = useCallback(function () {
+    const goForward = useCallback(() => {
         try {
             if (historyState.canGoForward) {
                 window.history.forward();
@@ -131,9 +86,7 @@ export var useBrowser = function () {
             console.error('Error going forward:', error);
         }
     }, [historyState.canGoForward]);
-    var reload = useCallback(function (hardReload, scrollToTop) {
-        if (hardReload === void 0) { hardReload = false; }
-        if (scrollToTop === void 0) { scrollToTop = false; }
+    const reload = useCallback((hardReload = false, scrollToTop = false) => {
         try {
             if (scrollToTop) {
                 window.scrollTo(0, 0);
@@ -149,10 +102,9 @@ export var useBrowser = function () {
             console.error('Error reloading page:', error);
         }
     }, []);
-    var navigateTo = useCallback(function (url, replace) {
-        if (replace === void 0) { replace = false; }
+    const navigateTo = useCallback((url, replace = false) => {
         try {
-            var urlObj = typeof url === 'string' ? new URL(url, window.location.origin) : url;
+            const urlObj = typeof url === 'string' ? new URL(url, window.location.origin) : url;
             if (replace) {
                 window.location.replace(urlObj.href);
             }
@@ -161,79 +113,50 @@ export var useBrowser = function () {
             }
         }
         catch (error) {
-            console.error("Error navigating to ".concat(url, ":"), error);
+            console.error(`Error navigating to ${url}:`, error);
         }
     }, []);
-    var clearBrowserData = useCallback(function () {
-        var args_1 = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args_1[_i] = arguments[_i];
+    const clearBrowserData = useCallback(async (settings = {}) => {
+        const { clearCache = false, clearCookies = false, clearLocalStorage = false, clearSessionStorage = false, } = settings;
+        try {
+            if (clearLocalStorage) {
+                localStorage.clear();
+            }
+            if (clearSessionStorage) {
+                sessionStorage.clear();
+            }
+            if (clearCookies) {
+                document.cookie.split(';').forEach((cookie) => {
+                    const [name] = cookie.split('=');
+                    document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/`;
+                });
+            }
+            if (clearCache && 'caches' in window) {
+                const cacheKeys = await caches.keys();
+                await Promise.all(cacheKeys.map((key) => caches.delete(key)));
+            }
+        }
+        catch (error) {
+            console.error('Error clearing browser data:', error);
+            throw error;
         }
-        return __awaiter(void 0, __spreadArray([], args_1, true), void 0, function (settings) {
-            var _a, clearCache, _b, clearCookies, _c, clearLocalStorage, _d, clearSessionStorage, cacheKeys, error_1;
-            if (settings === void 0) { settings = {}; }
-            return __generator(this, function (_e) {
-                switch (_e.label) {
-                    case 0:
-                        _a = settings.clearCache, clearCache = _a === void 0 ? false : _a, _b = settings.clearCookies, clearCookies = _b === void 0 ? false : _b, _c = settings.clearLocalStorage, clearLocalStorage = _c === void 0 ? false : _c, _d = settings.clearSessionStorage, clearSessionStorage = _d === void 0 ? false : _d;
-                        _e.label = 1;
-                    case 1:
-                        _e.trys.push([1, 5, , 6]);
-                        if (clearLocalStorage) {
-                            localStorage.clear();
-                        }
-                        if (clearSessionStorage) {
-                            sessionStorage.clear();
-                        }
-                        if (clearCookies) {
-                            document.cookie.split(';').forEach(function (cookie) {
-                                var name = cookie.split('=')[0];
-                                document.cookie = "".concat(name, "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/");
-                            });
-                        }
-                        if (!(clearCache && 'caches' in window)) return [3 /*break*/, 4];
-                        return [4 /*yield*/, caches.keys()];
-                    case 2:
-                        cacheKeys = _e.sent();
-                        return [4 /*yield*/, Promise.all(cacheKeys.map(function (key) { return caches.delete(key); }))];
-                    case 3:
-                        _e.sent();
-                        _e.label = 4;
-                    case 4: return [3 /*break*/, 6];
-                    case 5:
-                        error_1 = _e.sent();
-                        console.error('Error clearing browser data:', error_1);
-                        throw error_1;
-                    case 6: return [2 /*return*/];
-                }
-            });
-        });
     }, []);
-    var copyCurrentUrl = useCallback(function () { return __awaiter(void 0, void 0, void 0, function () {
-        var error_2, textArea;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    _a.trys.push([0, 2, , 3]);
-                    return [4 /*yield*/, navigator.clipboard.writeText(window.location.href)];
-                case 1:
-                    _a.sent();
-                    return [3 /*break*/, 3];
-                case 2:
-                    error_2 = _a.sent();
-                    console.error('Error copying URL to clipboard:', error_2);
-                    textArea = document.createElement('textarea');
-                    textArea.value = window.location.href;
-                    document.body.appendChild(textArea);
-                    textArea.select();
-                    document.execCommand('copy');
-                    document.body.removeChild(textArea);
-                    return [3 /*break*/, 3];
-                case 3: return [2 /*return*/];
-            }
-        });
-    }); }, []);
-    var openNewTab = useCallback(function (url) {
+    const copyCurrentUrl = useCallback(async () => {
+        try {
+            await navigator.clipboard.writeText(window.location.href);
+        }
+        catch (error) {
+            console.error('Error copying URL to clipboard:', error);
+            // Fallback for browsers that don't support clipboard API
+            const textArea = document.createElement('textarea');
+            textArea.value = window.location.href;
+            document.body.appendChild(textArea);
+            textArea.select();
+            document.execCommand('copy');
+            document.body.removeChild(textArea);
+        }
+    }, []);
+    const openNewTab = useCallback((url) => {
         try {
             window.open(url || window.location.href, '_blank', 'noopener,noreferrer');
         }
@@ -241,104 +164,65 @@ export var useBrowser = function () {
             console.error('Error opening new tab:', error);
         }
     }, []);
-    var getFaviconUrl = useCallback(function (size) {
-        if (size === void 0) { size = 32; }
-        var url = new URL(window.location.origin);
+    const getFaviconUrl = useCallback((size = 32) => {
+        const url = new URL(window.location.origin);
         url.pathname = '/favicon.ico';
         url.searchParams.set('size', size.toString());
         return url.href;
     }, []);
-    var getPageTitle = useCallback(function () {
+    const getPageTitle = useCallback(() => {
         return document.title;
     }, []);
-    var setPageTitle = useCallback(function (title) {
+    const setPageTitle = useCallback((title) => {
         document.title = title;
     }, []);
-    var enableFullscreen = useCallback(function () { return __awaiter(void 0, void 0, void 0, function () {
-        var error_3;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    _a.trys.push([0, 7, , 8]);
-                    if (!document.documentElement.requestFullscreen) return [3 /*break*/, 2];
-                    return [4 /*yield*/, document.documentElement.requestFullscreen()];
-                case 1:
-                    _a.sent();
-                    return [3 /*break*/, 6];
-                case 2:
-                    if (!document.documentElement.webkitRequestFullscreen) return [3 /*break*/, 4];
-                    return [4 /*yield*/, document.documentElement.webkitRequestFullscreen()];
-                case 3:
-                    _a.sent();
-                    return [3 /*break*/, 6];
-                case 4:
-                    if (!document.documentElement.msRequestFullscreen) return [3 /*break*/, 6];
-                    return [4 /*yield*/, document.documentElement.msRequestFullscreen()];
-                case 5:
-                    _a.sent();
-                    _a.label = 6;
-                case 6: return [3 /*break*/, 8];
-                case 7:
-                    error_3 = _a.sent();
-                    console.error('Error enabling fullscreen:', error_3);
-                    throw error_3;
-                case 8: return [2 /*return*/];
+    const enableFullscreen = useCallback(async () => {
+        try {
+            if (document.documentElement.requestFullscreen) {
+                await document.documentElement.requestFullscreen();
             }
-        });
-    }); }, []);
-    var disableFullscreen = useCallback(function () { return __awaiter(void 0, void 0, void 0, function () {
-        var error_4;
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    _a.trys.push([0, 7, , 8]);
-                    if (!document.exitFullscreen) return [3 /*break*/, 2];
-                    return [4 /*yield*/, document.exitFullscreen()];
-                case 1:
-                    _a.sent();
-                    return [3 /*break*/, 6];
-                case 2:
-                    if (!document.webkitExitFullscreen) return [3 /*break*/, 4];
-                    return [4 /*yield*/, document.webkitExitFullscreen()];
-                case 3:
-                    _a.sent();
-                    return [3 /*break*/, 6];
-                case 4:
-                    if (!document.msExitFullscreen) return [3 /*break*/, 6];
-                    return [4 /*yield*/, document.msExitFullscreen()];
-                case 5:
-                    _a.sent();
-                    _a.label = 6;
-                case 6: return [3 /*break*/, 8];
-                case 7:
-                    error_4 = _a.sent();
-                    console.error('Error disabling fullscreen:', error_4);
-                    throw error_4;
-                case 8: return [2 /*return*/];
+            else if (document.documentElement.webkitRequestFullscreen) {
+                await document.documentElement.webkitRequestFullscreen();
             }
-        });
-    }); }, []);
-    var printPage = useCallback(function () {
+            else if (document.documentElement.msRequestFullscreen) {
+                await document.documentElement.msRequestFullscreen();
+            }
+        }
+        catch (error) {
+            console.error('Error enabling fullscreen:', error);
+            throw error;
+        }
+    }, []);
+    const disableFullscreen = useCallback(async () => {
+        try {
+            if (document.exitFullscreen) {
+                await document.exitFullscreen();
+            }
+            else if (document.webkitExitFullscreen) {
+                await document.webkitExitFullscreen();
+            }
+            else if (document.msExitFullscreen) {
+                await document.msExitFullscreen();
+            }
+        }
+        catch (error) {
+            console.error('Error disabling fullscreen:', error);
+            throw error;
+        }
+    }, []);
+    const printPage = useCallback(() => {
         window.print();
     }, []);
-    var getUserAgent = useCallback(function () {
+    const getUserAgent = useCallback(() => {
         return navigator.userAgent;
     }, []);
-    var shareContent = useCallback(function (data) { return __awaiter(void 0, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    if (!navigator.share) {
-                        throw new Error('Web Share API not supported');
-                    }
-                    return [4 /*yield*/, navigator.share(data)];
-                case 1:
-                    _a.sent();
-                    return [2 /*return*/];
-            }
-        });
-    }); }, []);
-    var closeCurrentTab = useCallback(function () {
+    const shareContent = useCallback(async (data) => {
+        if (!navigator.share) {
+            throw new Error('Web Share API not supported');
+        }
+        await navigator.share(data);
+    }, []);
+    const closeCurrentTab = useCallback(() => {
         try {
             // Note: This will only work if the tab was opened by JavaScript
             // Browsers typically prevent closing windows/tabs not opened by script
@@ -351,70 +235,69 @@ export var useBrowser = function () {
         }
     }, []);
     return {
-        currentUrl: currentUrl,
+        currentUrl,
         currentPath: currentUrl.pathname,
         currentHash: currentUrl.hash,
         currentSearchParams: currentUrl.searchParams,
-        goBack: goBack,
-        goForward: goForward,
-        reload: reload,
-        navigateTo: navigateTo,
-        clearBrowserData: clearBrowserData,
-        historyState: historyState,
-        isOnline: isOnline,
-        copyCurrentUrl: copyCurrentUrl,
-        openNewTab: openNewTab,
-        getFaviconUrl: getFaviconUrl,
-        getPageTitle: getPageTitle,
-        setPageTitle: setPageTitle,
+        goBack,
+        goForward,
+        reload,
+        navigateTo,
+        clearBrowserData,
+        historyState,
+        isOnline,
+        copyCurrentUrl,
+        openNewTab,
+        getFaviconUrl,
+        getPageTitle,
+        setPageTitle,
         isSecureContext: window.isSecureContext,
-        viewportSize: viewportSize,
-        screenSize: screenSize,
-        enableFullscreen: enableFullscreen,
-        disableFullscreen: disableFullscreen,
-        isFullscreen: isFullscreen,
-        printPage: printPage,
-        getUserAgent: getUserAgent,
-        shareContent: shareContent,
+        viewportSize,
+        screenSize,
+        enableFullscreen,
+        disableFullscreen,
+        isFullscreen,
+        printPage,
+        getUserAgent,
+        shareContent,
         isShareSupported: 'share' in navigator,
-        closeCurrentTab: closeCurrentTab,
+        closeCurrentTab,
     };
 };
-export function useRouter(initialPath) {
-    if (initialPath === void 0) { initialPath = window.location.pathname + window.location.search; }
-    var _a = useState(initialPath), path = _a[0], setPath = _a[1];
-    var _b = useMemo(function () {
-        var _a = path.split('?'), basePath = _a[0], queryString = _a[1];
+export function useRouter(initialPath = window.location.pathname + window.location.search) {
+    const [path, setPath] = useState(initialPath);
+    const { pathname, searchParams } = useMemo(() => {
+        const [basePath, queryString] = path.split('?');
         return {
             pathname: basePath,
             searchParams: new URLSearchParams(queryString || ''),
         };
-    }, [path]), pathname = _b.pathname, searchParams = _b.searchParams;
-    var navigate = useCallback(function (newPath) {
-        var newPathStr = String(newPath);
+    }, [path]);
+    const navigate = useCallback((newPath) => {
+        const newPathStr = String(newPath);
         setPath(newPathStr);
         window.history.pushState({}, '', newPathStr);
     }, []);
-    useEffect(function () {
-        var handlePopState = function () {
+    useEffect(() => {
+        const handlePopState = () => {
             setPath(window.location.pathname + window.location.search);
         };
         window.addEventListener('popstate', handlePopState);
-        return function () { return window.removeEventListener('popstate', handlePopState); };
+        return () => window.removeEventListener('popstate', handlePopState);
     }, []);
     return {
-        pathname: pathname,
-        searchParams: searchParams,
-        navigate: navigate,
+        pathname,
+        searchParams,
+        navigate,
     };
 }
 export function useNavigationState() {
-    var _a = useState({
+    const [location, setLocation] = useState({
         pathname: window.location.pathname,
         search: window.location.search,
         state: window.history.state,
-    }), location = _a[0], setLocation = _a[1];
-    var navigate = useCallback(function (newPath, options) {
+    });
+    const navigate = useCallback((newPath, options) => {
         window.history.pushState((options === null || options === void 0 ? void 0 : options.state) || {}, "", newPath);
         setLocation({
             pathname: window.location.pathname,
@@ -423,8 +306,8 @@ export function useNavigationState() {
         });
         window.dispatchEvent(new PopStateEvent("popstate"));
     }, []);
-    useEffect(function () {
-        var handlePopState = function () {
+    useEffect(() => {
+        const handlePopState = () => {
             setLocation({
                 pathname: window.location.pathname,
                 search: window.location.search,
@@ -432,31 +315,30 @@ export function useNavigationState() {
             });
         };
         window.addEventListener("popstate", handlePopState);
-        return function () { return window.removeEventListener("popstate", handlePopState); };
+        return () => window.removeEventListener("popstate", handlePopState);
     }, []);
-    var searchParams = useMemo(function () { return new URLSearchParams(location.search); }, [location.search]);
+    const searchParams = useMemo(() => new URLSearchParams(location.search), [location.search]);
     return {
         pathname: location.pathname,
         search: location.search,
-        searchParams: searchParams,
+        searchParams,
         state: location.state,
-        navigate: navigate,
+        navigate,
     };
 }
-export function useMenuNavigation(menuData, key) {
-    if (key === void 0) { key = 'children'; }
-    var _a = useState([]), menuList = _a[0], setMenuList = _a[1];
-    useEffect(function () {
+export function useMenuNavigation(menuData, key = 'children') {
+    const [menuList, setMenuList] = useState([]);
+    useEffect(() => {
         if (menuData.length > 0) {
-            var data = flattenArrayByKey(menuData, key);
+            const data = flattenArrayByKey(menuData, key);
             setMenuList(data);
         }
-        return function () { return setMenuList([]); };
+        return () => setMenuList([]);
     }, [menuData, key]);
-    var handleSelect = function (path) {
+    const handleSelect = (path) => {
         if (path) {
             navigateTo(path);
         }
     };
-    return { menuList: menuList, handleSelect: handleSelect };
+    return { menuList, handleSelect };
 }

package/dist/chunk1516/chunk3312.d.ts

@@ -0,0 +1,63 @@
+export type VoiceStatus = 'idle' | 'listening' | 'processing' | 'confirming' | 'error' | 'unsupported';
+export interface VoiceCommand {
+    keywords: string[];
+    label: string;
+    path?: string;
+    requiresConfirmation?: boolean;
+    action?: () => void;
+}
+export interface HistoryEntry {
+    text: string;
+    matched: boolean;
+    label?: string;
+    time: string;
+}
+export type NavigateFn = (path: string) => void;
+export interface UseVoiceOptions {
+    commands?: VoiceCommand[];
+    language?: string;
+    continuous?: boolean;
+    interimResults?: boolean;
+    autoNavigate?: boolean;
+    historySize?: number;
+    minConfidence?: number;
+    idleTimeoutMs?: number;
+    wakeWord?: string;
+    shortcut?: string;
+    navigate?: NavigateFn;
+    onMatch?: (command: VoiceCommand, text: string) => void;
+    onNoMatch?: (text: string, closest: VoiceCommand | null) => void;
+    onError?: (error: string) => void;
+    onStart?: () => void;
+    onEnd?: () => void;
+    onToast?: (type: 'success' | 'error' | 'warn', message: string) => void;
+}
+export interface UseVoiceResult {
+    status: VoiceStatus;
+    transcript: string;
+    audioLevel: number;
+    history: HistoryEntry[];
+    lastMatch: VoiceCommand | null;
+    pendingConfirm: VoiceCommand | null;
+    isSupported: boolean;
+    isContinuousSupported: boolean;
+    isListening: boolean;
+    isProcessing: boolean;
+    start: () => Promise<void>;
+    stop: () => void;
+    toggle: () => Promise<void>;
+    reset: () => void;
+    executeCommand: (text: string) => void;
+}
+/**
+ * Word-boundary match — avoids "home" firing on "homework".
+ * Splits both transcript and keyword on whitespace and checks for an
+ * exact word (or multi-word phrase) match.
+ */
+export declare function matchVoiceCommand(transcript: string, commands: VoiceCommand[]): VoiceCommand | null;
+/**
+ * Returns the command whose keywords share the most words with the transcript.
+ * Used for "did you mean?" hints on no-match.
+ */
+export declare function closestVoiceCommand(transcript: string, commands: VoiceCommand[]): VoiceCommand | null;
+export declare function useVoice(options?: UseVoiceOptions): UseVoiceResult;