glirastes 0.4.0 → 0.5.1

package/dist/react/components/voice-input-addon.js

@@ -1,29 +1,266 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback } from 'react';
-import { useDeepgramTranscription } from '../hooks/use-deepgram-transcription.js';
+import { useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
+import { DeepgramSttAdapter } from '../stt/deepgram.js';
+import { useStt } from '../stt/use-stt.js';
+import { ChatContext } from '../provider/chat-context.js';
+import { DEFAULT_PUSH_TO_TALK_HOTKEY, parseHoldCombo, usePushToTalkHotkey, } from '../hooks/use-push-to-talk-hotkey.js';
 import { RecordingBar } from './recording-bar.js';
-export function VoiceInputAddon({ disabled, language, baseUrl, getToken, onTranscript, onError, showRecordingBar = true, recordingBarVariant = 'inline', }) {
-    const { isRecording, isConnecting, startRecording, stopRecording, } = useDeepgramTranscription({
-        language,
+import { ChatWindowVisibilityContext } from './chat-window-visibility.js';
+const DEFAULT_HOLD_THRESHOLD_MS = 350;
+// One owner per hotkey for the whole page. A second composer (another
+// provider, an embedded chat next to the host's own) listens on the same
+// window, so without a claim one key press would open two microphone streams.
+// The first claimant owns the key until it unmounts or stops wanting it; the
+// next one in line takes over. Later claimants are ignored while it holds.
+const hotkeyClaims = new Map();
+const hotkeyClaimListeners = new Set();
+function notifyHotkeyClaims() {
+    for (const listener of [...hotkeyClaimListeners])
+        listener();
+}
+function subscribeToHotkeyClaims(listener) {
+    hotkeyClaimListeners.add(listener);
+    return () => { hotkeyClaimListeners.delete(listener); };
+}
+function claimHotkey(combo, owner) {
+    hotkeyClaims.set(combo, [...(hotkeyClaims.get(combo) ?? []), owner]);
+    notifyHotkeyClaims();
+    return () => {
+        const rest = (hotkeyClaims.get(combo) ?? []).filter((claimant) => claimant !== owner);
+        if (rest.length > 0)
+            hotkeyClaims.set(combo, rest);
+        else
+            hotkeyClaims.delete(combo);
+        notifyHotkeyClaims();
+    };
+}
+/** Spelling-independent identity of a combo, e.g. `Shift+Mod+Space`. */
+function hotkeyIdentity(hotkey) {
+    if (!hotkey)
+        return null;
+    const combo = parseHoldCombo(hotkey);
+    return combo ? `${combo.mod}:${combo.shift}:${combo.alt}:${combo.key}` : null;
+}
+function useHotkeyOwnership(hotkey, wanted) {
+    const [owner] = useState(() => Symbol('push-to-talk'));
+    const combo = hotkeyIdentity(hotkey);
+    useEffect(() => {
+        if (!wanted || combo === null)
+            return;
+        return claimHotkey(combo, owner);
+    }, [wanted, combo, owner]);
+    return useSyncExternalStore(subscribeToHotkeyClaims, () => combo !== null && hotkeyClaims.get(combo)?.[0] === owner, () => false);
+}
+/**
+ * The composer's single STT controller and microphone stream. Stop inserts
+ * the transcript into the draft for editing; nothing is sent automatically.
+ * Hide, route change, session switch and unmount release the microphone.
+ */
+export function VoiceInputAddon({ disabled, language, baseUrl, getToken, adapter, onTranscript, onError, showRecordingBar = true, recordingBarVariant = 'inline', pushToTalk, routeKey, now = Date.now, }) {
+    const visible = useContext(ChatWindowVisibilityContext);
+    const chat = useContext(ChatContext);
+    const transcriptCallback = useRef(onTranscript);
+    transcriptCallback.current = onTranscript;
+    const getTokenRef = useRef(getToken);
+    getTokenRef.current = getToken;
+    const pendingStop = useRef(null);
+    const resolvedAdapter = useMemo(() => adapter ?? new DeepgramSttAdapter({
         baseUrl,
-        getToken,
-        onError,
-    });
+        getToken: () => getTokenRef.current?.(),
+    }), [adapter, baseUrl]);
+    const { phase, isRecording, isConnecting, displayTranscript, stream, startRecording, stopRecording, cancelRecording, retry, } = useStt({ adapter: resolvedAdapter, language, onError });
+    const active = isRecording || isConnecting;
+    const activeRef = useRef(active);
+    activeRef.current = active;
+    // Multiple controls and a visibility change may stop the same recording.
+    // The controller coalesces cleanup; this boundary also inserts text once.
     const stopAndSubmit = useCallback(() => {
-        const transcript = stopRecording().trim();
-        if (transcript.length > 0) {
-            onTranscript(transcript);
+        if (pendingStop.current)
+            return pendingStop.current;
+        const pending = Promise.resolve().then(async () => {
+            const transcript = (await stopRecording()).trim();
+            if (transcript.length > 0)
+                transcriptCallback.current(transcript);
+        }).catch(() => {
+            // The shared controller has already reported the provider error through
+            // onError and released its resources. No unhandled event promise.
+        }).finally(() => { if (pendingStop.current === pending)
+            pendingStop.current = null; });
+        pendingStop.current = pending;
+        return pending;
+    }, [stopRecording]);
+    const stopAndSubmitRef = useRef(stopAndSubmit);
+    stopAndSubmitRef.current = stopAndSubmit;
+    const start = useCallback(() => {
+        // Failures surface through onError and the failed phase (retry button).
+        void startRecording().catch(() => { });
+    }, [startRecording]);
+    useEffect(() => {
+        if (!visible && active)
+            void stopAndSubmit();
+    }, [visible, active, stopAndSubmit]);
+    // Route and session changes end the recording; the speech stays as draft.
+    const routeRef = useRef(routeKey);
+    useEffect(() => {
+        if (routeRef.current === routeKey)
+            return;
+        routeRef.current = routeKey;
+        if (activeRef.current)
+            void stopAndSubmitRef.current();
+    }, [routeKey]);
+    const sessionId = chat?.activeSessionId;
+    const sessionRef = useRef(sessionId);
+    useEffect(() => {
+        if (sessionRef.current === sessionId)
+            return;
+        sessionRef.current = sessionId;
+        if (activeRef.current)
+            void stopAndSubmitRef.current();
+    }, [sessionId]);
+    useEffect(() => {
+        const onHistory = () => {
+            if (activeRef.current)
+                void stopAndSubmitRef.current();
+        };
+        window.addEventListener('popstate', onHistory);
+        window.addEventListener('hashchange', onHistory);
+        return () => {
+            window.removeEventListener('popstate', onHistory);
+            window.removeEventListener('hashchange', onHistory);
+        };
+    }, []);
+    // Push-to-talk: a hold of at least the threshold stops on release; a
+    // shorter tap keeps recording (toggle). Keyboard activation toggles.
+    const pushToTalkEnabled = pushToTalk !== false;
+    const configuredThreshold = pushToTalk === false ? undefined : pushToTalk?.holdThresholdMs;
+    const holdThresholdMs = typeof configuredThreshold === 'number'
+        && Number.isFinite(configuredThreshold) && configuredThreshold >= 0
+        ? configuredThreshold
+        : DEFAULT_HOLD_THRESHOLD_MS;
+    const nowRef = useRef(now);
+    nowRef.current = now;
+    const holdThresholdRef = useRef(holdThresholdMs);
+    holdThresholdRef.current = holdThresholdMs;
+    const suppressClick = useRef(false);
+    const releasedOverButton = useRef(false);
+    const suppressTimer = useRef(null);
+    const touchStartedRecording = useRef(false);
+    const stopWatchingPress = useRef(null);
+    const hotkeyHeld = useRef(false);
+    const cancelSuppressTimer = () => {
+        if (suppressTimer.current === null)
+            return;
+        clearTimeout(suppressTimer.current);
+        suppressTimer.current = null;
+    };
+    const handlePointerDown = (event) => {
+        touchStartedRecording.current = false;
+        if (!pushToTalkEnabled || disabled || activeRef.current)
+            return;
+        if (typeof event.button === 'number' && event.button !== 0)
+            return;
+        stopWatchingPress.current?.();
+        cancelSuppressTimer();
+        const startedAt = nowRef.current();
+        suppressClick.current = true;
+        releasedOverButton.current = false;
+        touchStartedRecording.current = event.pointerType === 'touch';
+        const stopWatching = () => {
+            window.removeEventListener('pointerup', release);
+            window.removeEventListener('pointercancel', release);
+            if (stopWatchingPress.current === stopWatching)
+                stopWatchingPress.current = null;
+        };
+        const release = () => {
+            stopWatching();
+            // A release over the button is followed by a click that handleClick
+            // swallows. A release elsewhere or a cancelled pointer is followed by
+            // none, and the flag would swallow the next, unrelated click instead.
+            if (!releasedOverButton.current) {
+                suppressClick.current = false;
+            }
+            else {
+                // Touch capture reports every release as "over the button", even one
+                // that ends away from it with no click at all. The click of a press
+                // is dispatched in the task of its pointerup, before any timer, so
+                // the flag outlives it by no more than a timer turn.
+                suppressTimer.current = setTimeout(() => {
+                    suppressTimer.current = null;
+                    suppressClick.current = false;
+                }, 0);
+            }
+            releasedOverButton.current = false;
+            if (nowRef.current() - startedAt >= holdThresholdRef.current) {
+                void stopAndSubmitRef.current();
+            }
+        };
+        stopWatchingPress.current = stopWatching;
+        window.addEventListener('pointerup', release);
+        window.addEventListener('pointercancel', release);
+        start();
+    };
+    // React handles the event before the window listener above sees it.
+    const handlePointerUp = () => {
+        releasedOverButton.current = true;
+    };
+    // The end of a finger's tap is followed by a click, which the browser
+    // hit-tests against the layout of that moment. Recording began on
+    // pointerdown and the inline recording bar has since moved its controls
+    // under the finger, so that click would press Stop and end the recording
+    // the tap just started. The press has done its work; no click is wanted.
+    const handleTouchEnd = (event) => {
+        if (!touchStartedRecording.current)
+            return;
+        touchStartedRecording.current = false;
+        if (event.cancelable)
+            event.preventDefault();
+    };
+    const handleTouchCancel = () => {
+        touchStartedRecording.current = false;
+    };
+    useEffect(() => () => {
+        stopWatchingPress.current?.();
+        cancelSuppressTimer();
+    }, []);
+    const handleClick = () => {
+        if (suppressClick.current) {
+            suppressClick.current = false;
+            return;
         }
-    }, [onTranscript, stopRecording]);
-    const handleClick = useCallback(async () => {
         if (isRecording) {
-            stopAndSubmit();
+            void stopAndSubmit();
             return;
         }
-        await startRecording();
-    }, [isRecording, startRecording, stopAndSubmit]);
-    return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: () => {
-                    void handleClick();
-                }, disabled: disabled || isConnecting, "data-component": "voice-input-addon", "data-state": isConnecting ? 'connecting' : isRecording ? 'recording' : 'idle', children: isRecording ? 'stop' : 'mic' }), showRecordingBar && isRecording && (_jsx(RecordingBar, { isConnecting: isConnecting, onCancel: stopRecording, onStop: stopAndSubmit, variant: recordingBarVariant }))] }));
+        if (!isConnecting)
+            start();
+    };
+    const hotkey = pushToTalk === false
+        ? false
+        : pushToTalk?.hotkey ?? DEFAULT_PUSH_TO_TALK_HOTKEY;
+    const ownsHotkey = useHotkeyOwnership(hotkey, pushToTalkEnabled && visible && !disabled);
+    usePushToTalkHotkey({
+        hotkey,
+        enabled: ownsHotkey,
+        onPress: () => {
+            if (activeRef.current)
+                return;
+            hotkeyHeld.current = true;
+            start();
+        },
+        onRelease: () => {
+            if (!hotkeyHeld.current)
+                return;
+            hotkeyHeld.current = false;
+            void stopAndSubmitRef.current();
+        },
+    });
+    const state = phase === 'failed'
+        ? 'failed'
+        : isConnecting
+            ? 'connecting'
+            : isRecording
+                ? 'recording'
+                : 'idle';
+    return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onPointerDown: handlePointerDown, onPointerUp: handlePointerUp, onTouchEnd: handleTouchEnd, onTouchCancel: handleTouchCancel, onClick: handleClick, disabled: disabled, "aria-busy": isConnecting, "data-component": "voice-input-addon", "data-state": state, children: isRecording ? 'stop' : 'mic' }), phase === 'failed' && (_jsx("button", { type: "button", onClick: () => { void retry().catch(() => { }); }, disabled: disabled, "aria-label": chat?.locale.retryRecordingAriaLabel ?? 'Retry recording', "data-action": "retry-recording", children: "retry" })), showRecordingBar && active && (_jsx(RecordingBar, { isConnecting: isConnecting, stream: stream, transcript: displayTranscript, onCancel: () => { void cancelRecording().catch(() => { }); }, onStop: () => { void stopAndSubmit(); }, variant: recordingBarVariant }))] }));
 }
 //# sourceMappingURL=voice-input-addon.js.map

package/dist/react/components/voice-input-addon.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-input-addon.js","sourceRoot":"","sources":["../../../src/react/components/voice-input-addon.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAclD,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,gBAAgB,GAAG,IAAI,EACvB,mBAAmB,GAAG,QAAQ,GACT;IACrB,MAAM,EACJ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,GACd,GAAG,wBAAwB,CAAC;QAC3B,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;QACrC,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,YAAY,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IAElC,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,IAAI,WAAW,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAEjD,OAAO,CACL,8BACE,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE;oBACZ,KAAK,WAAW,EAAE,CAAC;gBACrB,CAAC,EACD,QAAQ,EAAE,QAAQ,IAAI,YAAY,oBACnB,mBAAmB,gBACtB,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,YAE3E,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GACtB,EAER,gBAAgB,IAAI,WAAW,IAAI,CAClC,KAAC,YAAY,IACX,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,mBAAmB,GAC5B,CACH,IACA,CACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"voice-input-addon.js","sourceRoot":"","sources":["../../../src/react/components/voice-input-addon.tsx"],"names":[],"mappings":"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"}

package/dist/react/components/voice-input-button.js

@@ -38,7 +38,7 @@ export function VoiceInputButton({ onTranscript, disabled = false, className, la
     });
     const handleClick = useCallback(async () => {
         if (isRecording) {
-            const finalText = stopRecording();
+            const finalText = await stopRecording();
             if (finalText.trim()) {
                 onTranscript(finalText);
             }

package/dist/react/components/voice-input-button.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-input-button.js","sourceRoot":"","sources":["../../../src/react/components/voice-input-button.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"voice-input-button.js","sourceRoot":"","sources":["../../../src/react/components/voice-input-button.tsx"],"names":[],"mappings":"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"}

package/dist/react/hooks/use-chat-shortcuts.d.ts

@@ -0,0 +1,33 @@
+/** What a keyboard shortcut can do to the chat window. */
+export type ChatShortcutAction = 'toggle' | 'toggleLayout' | 'toggleCollapse' | 'newChat' | 'focusInput' | 'close';
+/** A combination such as `mod+i` or `alt+shift+d` per action; `false` switches the action off. */
+export type ChatShortcutMap = Partial<Record<ChatShortcutAction, string | false>>;
+/**
+ * Defaults that stay clear of the common browser and system shortcuts on
+ * macOS, Windows and Linux. `mod` is Command on Apple platforms and Control
+ * elsewhere. An app that already uses one of them passes its own.
+ */
+export declare const DEFAULT_CHAT_SHORTCUTS: Record<ChatShortcutAction, string | false>;
+export declare function resolveChatShortcuts(overrides?: ChatShortcutMap): Record<ChatShortcutAction, string | false>;
+/**
+ * Whether a key press is exactly this combination. Letters and digits match
+ * by physical key too, because Option on macOS turns them into symbols.
+ * A press with further modifiers (AltGr reports Control+Alt) does not match.
+ */
+export declare function matchesShortcut(event: KeyboardEvent, combo: string | false | null | undefined): boolean;
+/** `⌘I` on Apple platforms, `Ctrl+I` elsewhere; empty for a switched-off action. */
+export declare function formatShortcut(combo: string | false | null | undefined): string;
+export interface UseChatShortcutsOptions {
+    /** The app's own combinations; anything left out keeps its default. */
+    shortcuts?: ChatShortcutMap;
+    /** Default: true. */
+    enabled?: boolean;
+    /** Return true to let a key press pass, for example while a dialog owns the keyboard. */
+    shouldIgnore?: (event: KeyboardEvent) => boolean;
+}
+/**
+ * Keyboard control of the chat window, the same on macOS, Windows and Linux.
+ * Only actions with a handler listen. Returns the combinations in effect,
+ * for tooltips via `formatShortcut`.
+ */
+export declare function useChatShortcuts(handlers: Partial<Record<ChatShortcutAction, () => void>>, options?: UseChatShortcutsOptions): Record<ChatShortcutAction, string | false>;

package/dist/react/hooks/use-chat-shortcuts.js

@@ -0,0 +1,133 @@
+import { useEffect, useMemo, useRef } from 'react';
+/**
+ * Defaults that stay clear of the common browser and system shortcuts on
+ * macOS, Windows and Linux. `mod` is Command on Apple platforms and Control
+ * elsewhere. An app that already uses one of them passes its own.
+ */
+export const DEFAULT_CHAT_SHORTCUTS = Object.freeze({
+    toggle: 'mod+i',
+    toggleLayout: 'alt+shift+d',
+    toggleCollapse: 'alt+shift+c',
+    newChat: 'alt+shift+n',
+    focusInput: 'alt+shift+i',
+    close: false,
+});
+export function resolveChatShortcuts(overrides) {
+    const resolved = { ...DEFAULT_CHAT_SHORTCUTS };
+    for (const [action, combo] of Object.entries(overrides ?? {})) {
+        if (combo !== undefined && action in resolved)
+            resolved[action] = combo;
+    }
+    return resolved;
+}
+const KEY_ALIASES = { esc: 'escape', return: 'enter', space: ' ', period: '.', comma: ',', slash: '/' };
+const KEY_CODES = { ' ': 'Space', '.': 'Period', ',': 'Comma', '/': 'Slash' };
+function isApplePlatform() {
+    if (typeof navigator === 'undefined')
+        return false;
+    return /Mac|iPhone|iPad|iPod/.test(navigator.platform || navigator.userAgent || '');
+}
+function parse(combo) {
+    const result = { key: '', mod: false, shift: false, alt: false };
+    for (const part of combo.toLowerCase().split('+').map((p) => p.trim()).filter(Boolean)) {
+        if (['mod', 'cmd', 'ctrl', 'meta', 'control'].includes(part))
+            result.mod = true;
+        else if (part === 'shift')
+            result.shift = true;
+        else if (['alt', 'option', 'opt'].includes(part))
+            result.alt = true;
+        else
+            result.key = KEY_ALIASES[part] ?? part;
+    }
+    return result.key ? result : null;
+}
+/** The physical key of a combination, where it has one that is the same on every layout we care about. */
+function codeOf(key) {
+    if (/^[a-z]$/.test(key))
+        return `Key${key.toUpperCase()}`;
+    if (/^[0-9]$/.test(key))
+        return `Digit${key}`;
+    return KEY_CODES[key] ?? null;
+}
+/**
+ * Whether a key press is exactly this combination. Letters and digits match
+ * by physical key too, because Option on macOS turns them into symbols.
+ * A press with further modifiers (AltGr reports Control+Alt) does not match.
+ */
+export function matchesShortcut(event, combo) {
+    const parsed = combo ? parse(combo) : null;
+    if (!parsed)
+        return false;
+    const apple = isApplePlatform();
+    const mod = apple ? event.metaKey : event.ctrlKey;
+    const otherMod = apple ? event.ctrlKey : event.metaKey;
+    if (mod !== parsed.mod || otherMod || event.shiftKey !== parsed.shift || event.altKey !== parsed.alt)
+        return false;
+    const key = typeof event.key === 'string' ? event.key.toLowerCase() : '';
+    if (key === parsed.key)
+        return true;
+    const code = codeOf(parsed.key);
+    return code !== null && event.code === code;
+}
+/** `⌘I` on Apple platforms, `Ctrl+I` elsewhere; empty for a switched-off action. */
+export function formatShortcut(combo) {
+    const parsed = combo ? parse(combo) : null;
+    if (!parsed)
+        return '';
+    const apple = isApplePlatform();
+    const key = parsed.key === ' ' ? 'Space' : parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key.charAt(0).toUpperCase() + parsed.key.slice(1);
+    const parts = [
+        parsed.mod ? (apple ? '⌘' : 'Ctrl') : '',
+        parsed.alt ? (apple ? '⌥' : 'Alt') : '',
+        parsed.shift ? (apple ? '⇧' : 'Shift') : '',
+        key,
+    ].filter(Boolean);
+    return parts.join(apple ? '' : '+');
+}
+function isEditable(target) {
+    if (!(target instanceof HTMLElement))
+        return false;
+    return ['INPUT', 'TEXTAREA', 'SELECT'].includes(target.tagName) || target.isContentEditable;
+}
+/**
+ * Keyboard control of the chat window, the same on macOS, Windows and Linux.
+ * Only actions with a handler listen. Returns the combinations in effect,
+ * for tooltips via `formatShortcut`.
+ */
+export function useChatShortcuts(handlers, options = {}) {
+    const { shortcuts, enabled = true, shouldIgnore } = options;
+    const key = JSON.stringify(shortcuts ?? {});
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const resolved = useMemo(() => resolveChatShortcuts(shortcuts), [key]);
+    const handlersRef = useRef(handlers);
+    handlersRef.current = handlers;
+    const ignoreRef = useRef(shouldIgnore);
+    ignoreRef.current = shouldIgnore;
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const listener = (event) => {
+            if (event.defaultPrevented || event.repeat)
+                return;
+            for (const action of Object.keys(resolved)) {
+                const combo = resolved[action];
+                const handler = handlersRef.current[action];
+                if (!combo || !handler || !matchesShortcut(event, combo))
+                    continue;
+                // A bare key belongs to the text field it is typed into; Escape does not.
+                const bare = !event.ctrlKey && !event.metaKey && !event.altKey && event.key !== 'Escape';
+                if (bare && isEditable(event.target))
+                    return;
+                if (ignoreRef.current?.(event))
+                    return;
+                event.preventDefault();
+                handler();
+                return;
+            }
+        };
+        window.addEventListener('keydown', listener);
+        return () => window.removeEventListener('keydown', listener);
+    }, [enabled, resolved]);
+    return resolved;
+}
+//# sourceMappingURL=use-chat-shortcuts.js.map

package/dist/react/hooks/use-chat-shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-shortcuts.js","sourceRoot":"","sources":["../../../src/react/hooks/use-chat-shortcuts.ts"],"names":[],"mappings":"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"}

package/dist/react/hooks/use-deepgram-transcription.d.ts

@@ -1,2 +1,6 @@
 import type { UseDeepgramTranscriptionOptions, UseDeepgramTranscriptionReturn } from '../types.js';
+/**
+ * Compatibility entry point backed by the provider-neutral STT controller.
+ * New integrations may use `useStt` with their own provider adapter.
+ */
 export declare function useDeepgramTranscription(options?: UseDeepgramTranscriptionOptions): UseDeepgramTranscriptionReturn;