@happyvertical/smrt-svelte 0.30.0 → 0.31.0

package/dist/components/forms/PhoneInput.svelte

@@ -4,6 +4,7 @@ import { onDestroy, onMount } from 'svelte';
 import { useAppState } from '../../hooks/useAppState.svelte.js';
 import { useSTT } from '../../hooks/useSTT.svelte.js';
 import { M } from '../../i18n/strings.forms.js';
+import { logger } from '../../internal/logger.js';
 import {
   type FieldDefinition,
   tryGetFormContext,
@@ -162,15 +163,26 @@ onDestroy(() => {
 async function startHoldRecording() {
   if (!isSmrt || disabled || isProcessing) return;
 
-  if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
-    await stt.initialize({ type: 'whisper-wasm' });
-  }
-
   processError = null;
   recordingStartTime = Date.now();
   isHolding = true;
 
-  await stt.start({ continuous: true, interimResults: false });
+  // Guard STT init / mic acquisition so a rejection can't leave the field
+  // wedged in a permanent "Recording..." state with no visible error (C2).
+  try {
+    if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
+      await stt.initialize({ type: 'whisper-wasm' });
+    }
+    await stt.start({ continuous: true, interimResults: false });
+  } catch (err) {
+    isHolding = false;
+    processError =
+      err instanceof Error ? err.message : 'Could not start voice input';
+    logger.error('PhoneInput: failed to start voice recording', {
+      field: name,
+      error: err,
+    });
+  }
 }
 
 async function stopHoldRecording() {
@@ -232,6 +244,17 @@ function handleTouchEnd() {
   stopHoldRecording();
 }
 
+// Keyboard activation for the mic (WCAG 2.1.1): Enter/Space toggles recording.
+function handleMicKeydown(e: KeyboardEvent) {
+  if (e.key !== 'Enter' && e.key !== ' ') return;
+  e.preventDefault();
+  if (isHolding) {
+    stopHoldRecording();
+  } else {
+    startHoldRecording();
+  }
+}
+
 function handleInput(e: Event) {
   const target = e.target as HTMLInputElement;
   const formatted = formatPhoneNumber(target.value);
@@ -281,6 +304,7 @@ function handleInput(e: Event) {
         class="mic-btn"
         class:active={isHolding}
         {disabled}
+        onkeydown={handleMicKeydown}
         onmousedown={handleMouseDown}
         onmouseup={handleMouseUp}
         onmouseleave={handleMouseLeave}

package/dist/components/forms/PhoneInput.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/PhoneInput.svelte.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,KAAK;IACpB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAqRD,QAAA,MAAM,UAAU,gDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"PhoneInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/PhoneInput.svelte.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,KAAK;IACpB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AA4SD,QAAA,MAAM,UAAU,gDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/forms/TextInput.svelte

@@ -9,6 +9,7 @@ import { onDestroy, onMount } from 'svelte';
 import { useAppState } from '../../hooks/useAppState.svelte.js';
 import { useSTT } from '../../hooks/useSTT.svelte.js';
 import { M } from '../../i18n/strings.forms.js';
+import { logger } from '../../internal/logger.js';
 import {
   type FieldDefinition,
   tryGetFormContext,
@@ -115,19 +116,31 @@ onDestroy(() => {
 async function startHoldRecording() {
   if (!isSmrt || disabled || isProcessing) return;
 
-  // Initialize STT with Whisper v2 for speed + accuracy
-  if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
-    await stt.initialize({ type: 'whisper-wasm' });
-  }
-
   // Store current value for append mode
   valueBeforeRecording = value;
   processError = null;
   recordingStartTime = Date.now();
   isHolding = true;
 
-  // Use continuous mode to capture all speech while holding
-  await stt.start({ continuous: true, interimResults: false });
+  // STT init / mic acquisition can reject (model fetch failure, mic-permission
+  // denial). Without this guard `isHolding` would stay true and no error would
+  // surface, wedging the field in a permanent "Recording..." state (C2).
+  try {
+    // Initialize STT with Whisper v2 for speed + accuracy
+    if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
+      await stt.initialize({ type: 'whisper-wasm' });
+    }
+    // Use continuous mode to capture all speech while holding
+    await stt.start({ continuous: true, interimResults: false });
+  } catch (err) {
+    isHolding = false;
+    processError =
+      err instanceof Error ? err.message : 'Could not start voice input';
+    logger.error('TextInput: failed to start voice recording', {
+      field: name,
+      error: err,
+    });
+  }
 }
 
 async function stopHoldRecording() {
@@ -202,6 +215,20 @@ function handleMicClick(e: MouseEvent) {
   e.stopPropagation();
 }
 
+// Keyboard activation for the mic (WCAG 2.1.1). The pointer flow is
+// hold-to-record; keyboard maps to a toggle — Enter/Space starts recording,
+// pressing again stops. preventDefault stops Space from also firing the
+// button's synthetic click and from scrolling the page.
+function handleMicKeydown(e: KeyboardEvent) {
+  if (e.key !== 'Enter' && e.key !== ' ') return;
+  e.preventDefault();
+  if (isHolding) {
+    stopHoldRecording();
+  } else {
+    startHoldRecording();
+  }
+}
+
 function handleInput(e: Event) {
   const target = e.target as HTMLInputElement;
   updateValue(target.value);
@@ -253,6 +280,7 @@ function handleInput(e: Event) {
         {disabled}
         use:ripple
         onclick={handleMicClick}
+        onkeydown={handleMicKeydown}
         onmousedown={(e) => { e.stopPropagation(); if (e.button === 0) startHoldRecording(); }}
         onmouseup={handleMouseUp}
         onmouseleave={handleMouseLeave}

package/dist/components/forms/TextInput.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/TextInput.svelte.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,KAAK;IACpB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AA6ND,QAAA,MAAM,SAAS,gDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"TextInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/TextInput.svelte.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,KAAK;IACpB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAwPD,QAAA,MAAM,SAAS,gDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/components/forms/TextareaInput.svelte

@@ -6,6 +6,7 @@ import { onDestroy, onMount } from 'svelte';
 import { useAppState } from '../../hooks/useAppState.svelte.js';
 import { useSTT } from '../../hooks/useSTT.svelte.js';
 import { M } from '../../i18n/strings.forms.js';
+import { logger } from '../../internal/logger.js';
 import {
   type FieldDefinition,
   tryGetFormContext,
@@ -103,16 +104,27 @@ onDestroy(() => {
 async function startHoldRecording() {
   if (!isSmrt || disabled || isProcessing) return;
 
-  if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
-    await stt.initialize({ type: 'whisper-wasm' });
-  }
-
   valueBeforeRecording = value;
   processError = null;
   recordingStartTime = Date.now();
   isHolding = true;
 
-  await stt.start({ continuous: true, interimResults: false });
+  // Guard STT init / mic acquisition so a rejection can't leave the field
+  // wedged in a permanent "Recording..." state with no visible error (C2).
+  try {
+    if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
+      await stt.initialize({ type: 'whisper-wasm' });
+    }
+    await stt.start({ continuous: true, interimResults: false });
+  } catch (err) {
+    isHolding = false;
+    processError =
+      err instanceof Error ? err.message : 'Could not start voice input';
+    logger.error('TextareaInput: failed to start voice recording', {
+      field: name,
+      error: err,
+    });
+  }
 }
 
 async function stopHoldRecording() {
@@ -179,6 +191,17 @@ function handleTouchEnd() {
   stopHoldRecording();
 }
 
+// Keyboard activation for the mic (WCAG 2.1.1): Enter/Space toggles recording.
+function handleMicKeydown(e: KeyboardEvent) {
+  if (e.key !== 'Enter' && e.key !== ' ') return;
+  e.preventDefault();
+  if (isHolding) {
+    stopHoldRecording();
+  } else {
+    startHoldRecording();
+  }
+}
+
 function handleInput(e: Event) {
   const target = e.target as HTMLTextAreaElement;
   updateValue(target.value);
@@ -228,6 +251,7 @@ function handleInput(e: Event) {
         class:active={isHolding}
         {disabled}
         use:ripple
+        onkeydown={handleMicKeydown}
         onmousedown={(e) => { e.stopPropagation(); if (e.button === 0) startHoldRecording(); }}
         onmouseup={handleMouseUp}
         onmouseleave={handleMouseLeave}

package/dist/components/forms/TextareaInput.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextareaInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/TextareaInput.svelte.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,KAAK;IACpB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAuMD,QAAA,MAAM,aAAa,gDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"TextareaInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/TextareaInput.svelte.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,KAAK;IACpB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AA8ND,QAAA,MAAM,aAAa,gDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/forms/__tests__/FileUpload.error-alert.test.js

@@ -0,0 +1,37 @@
+/**
+ * Regression: FileUpload validation errors are announced (C7).
+ *
+ * The error `<p>` was a plain element, so async reject errors (wrong type /
+ * oversize) were not surfaced to screen readers — unlike Form/TextInput which
+ * announce. The fix makes it a live region (role="alert" + aria-live).
+ */
+import { render, screen, waitFor } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import { describe, expect, it } from 'vitest';
+import FileUpload from '../FileUpload.svelte';
+function fileInput(container) {
+    const input = container.querySelector('input[type="file"]');
+    if (!input)
+        throw new Error('file input not found');
+    return input;
+}
+describe('FileUpload — error live region (C7)', () => {
+    it('announces a max-size error via role="alert"', async () => {
+        const { container } = render(FileUpload, {
+            // maxSize forces a validation error without an `accept` filter (which
+            // userEvent.upload would otherwise apply before the file reaches the
+            // component, suppressing the error path under test).
+            props: { label: 'Upload', maxSize: 4 },
+        });
+        const big = new File(['way too many bytes'], 'big.bin', {
+            type: 'application/octet-stream',
+        });
+        await userEvent.upload(fileInput(container), big);
+        await waitFor(() => {
+            const alert = screen.getByRole('alert');
+            expect(alert).toBeInTheDocument();
+            expect(alert).toHaveAttribute('aria-live');
+            expect(alert.textContent).toMatch(/maximum size/i);
+        });
+    });
+});

package/dist/components/forms/__tests__/Form.stt-error.test.js

@@ -0,0 +1,57 @@
+/**
+ * Regression: Form voice-listening init failures don't wedge the form (C2/C3).
+ *
+ * `startFormListening` awaited `stt.initialize()`/`stt.start()` with no
+ * try/catch. On rejection the listening flags stayed set, the auto-stop $effect
+ * (gated on !isStarting) was suppressed, and the form was stuck in a permanent
+ * "listening" state with no surfaced error. The fix wraps the flow in
+ * try/catch/finally: reset the flags and show the error.
+ */
+import { render, screen, waitFor } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import { createRawSnippet } from 'svelte';
+import { describe, expect, it, vi } from 'vitest';
+const sttStub = {
+    isListening: false,
+    isInitializing: false,
+    isReady: false,
+    adapterType: null,
+    downloadProgress: 0,
+    lastResult: '',
+    initialize: vi.fn(async () => {
+        throw new Error('model download failed');
+    }),
+    start: vi.fn(async () => { }),
+    stop: vi.fn(async () => { }),
+};
+vi.mock('../../../hooks/useAppState.svelte.js', () => ({
+    useAppState: () => ({ state: { mode: 'smrt' }, setMode: vi.fn() }),
+}));
+vi.mock('../../../hooks/useSTT.svelte.js', () => ({
+    useSTT: () => sttStub,
+}));
+import Form from '../Form.svelte';
+function child() {
+    return createRawSnippet(() => ({
+        render: () => '<span>fields</span>',
+    }));
+}
+describe('Form — voice-listening init failure (C2)', () => {
+    it('surfaces an error and does not wedge when STT init rejects', async () => {
+        render(Form, {
+            props: { children: child(), showFormListen: true },
+        });
+        // The form-listen button is shown in smrt mode; clicking it starts listening.
+        const listenBtn = screen.getByRole('button');
+        await userEvent.click(listenBtn);
+        // initialize() rejected — an error must be surfaced (role=alert region).
+        await waitFor(() => {
+            expect(screen.getByRole('alert')).toBeInTheDocument();
+        });
+        expect(screen.getByRole('alert').textContent).toMatch(/model download failed/i);
+        // And the form is NOT wedged: the polite status region is not stuck on the
+        // "listening" message (listening flag was reset).
+        const status = screen.getByRole('status');
+        expect(status.textContent?.trim()).toBe('');
+    });
+});

package/dist/components/forms/__tests__/FormMicButton.test.js

@@ -68,6 +68,13 @@ describe('FormMicButton', () => {
         await userEvent.keyboard('{Enter}');
         expect(toggleListening).toHaveBeenCalledTimes(1);
     });
+    it('toggles listening when activated with Space (CS2)', async () => {
+        render(FormMicButton);
+        const button = screen.getByRole('button', { name: 'Click to speak' });
+        button.focus();
+        await userEvent.keyboard(' ');
+        expect(toggleListening).toHaveBeenCalledTimes(1);
+    });
     it('relabels to "Stop listening" once the form is listening', async () => {
         formState = { isFormListening: true, isExtracting: false };
         render(FormMicButton);

package/dist/components/forms/__tests__/mic-keyboard-a11y.test.js

@@ -0,0 +1,74 @@
+/**
+ * Regression: per-field voice mics are keyboard-operable (C1, WCAG 2.1.1).
+ *
+ * Before the fix the mic <button>s were bound only to mousedown/up + touch
+ * handlers (onclick was a no-op preventDefault), so a keyboard user could focus
+ * the mic but never record. The fix adds Enter/Space toggle activation, mirror-
+ * ing FormMicButton. TextInput is the representative editable field;
+ * DateTimeInput is covered too because its SMRT-mode text input is read-only —
+ * the mic is the ONLY keyboard entry path there.
+ *
+ * useAppState/useSTT throw outside a <Provider>, so both are mocked. The STT
+ * stub starts `isReady: true` so the hold flow skips initialize() and the
+ * start()/stop() spies fire synchronously enough to assert.
+ */
+import { render, screen } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const sttStub = {
+    isListening: false,
+    isInitializing: false,
+    isReady: true,
+    adapterType: 'whisper-wasm',
+    downloadProgress: 0,
+    lastResult: '',
+    initialize: vi.fn(async () => { }),
+    start: vi.fn(async () => { }),
+    stop: vi.fn(async () => { }),
+};
+vi.mock('../../../hooks/useAppState.svelte.js', () => ({
+    useAppState: () => ({ state: { mode: 'smrt' }, setMode: vi.fn() }),
+}));
+vi.mock('../../../hooks/useSTT.svelte.js', () => ({
+    useSTT: () => sttStub,
+}));
+import DateTimeInput from '../DateTimeInput.svelte';
+import TextInput from '../TextInput.svelte';
+beforeEach(() => {
+    vi.clearAllMocks();
+    sttStub.adapterType = 'whisper-wasm';
+});
+describe('TextInput mic — keyboard activation (C1)', () => {
+    it('exposes the mic as a focusable button with an accessible name', () => {
+        render(TextInput, { props: { name: 'note', label: 'Note' } });
+        const mic = screen.getByRole('button', { name: /speak|mic|voice/i });
+        expect(mic).toBeInTheDocument();
+        // Native <button> => in the tab order (not an empty/dead tab stop).
+        expect(mic).not.toHaveAttribute('tabindex', '-1');
+    });
+    it('starts recording on Enter and stops on the next Enter (toggle)', async () => {
+        render(TextInput, { props: { name: 'note', label: 'Note' } });
+        const mic = screen.getByRole('button', { name: /speak|mic|voice/i });
+        mic.focus();
+        await userEvent.keyboard('{Enter}');
+        expect(sttStub.start).toHaveBeenCalledTimes(1);
+        await userEvent.keyboard('{Enter}');
+        expect(sttStub.stop).toHaveBeenCalledTimes(1);
+    });
+    it('starts recording on Space', async () => {
+        render(TextInput, { props: { name: 'note', label: 'Note' } });
+        const mic = screen.getByRole('button', { name: /speak|mic|voice/i });
+        mic.focus();
+        await userEvent.keyboard(' ');
+        expect(sttStub.start).toHaveBeenCalledTimes(1);
+    });
+});
+describe('DateTimeInput mic — keyboard activation (C1)', () => {
+    it('records via keyboard even though the text field is read-only', async () => {
+        render(DateTimeInput, { props: { name: 'when', label: 'When' } });
+        const mic = screen.getByRole('button', { name: /speak|mic|voice|date/i });
+        mic.focus();
+        await userEvent.keyboard('{Enter}');
+        expect(sttStub.start).toHaveBeenCalledTimes(1);
+    });
+});

package/dist/hooks/__tests__/stt-consumer.fixture.svelte

@@ -0,0 +1,25 @@
+<script lang="ts">
+/**
+ * Test consumer that calls the real `useSTT()` hook so its `onDestroy`
+ * per-hook ownership logic (R4) runs when this component unmounts.
+ */
+import { type UseSTTReturn, useSTT } from '../useSTT.svelte.js';
+
+interface Props {
+  /** Hand the live hook back to the test so it can call start()/stop(). */
+  onReady?: (stt: UseSTTReturn) => void;
+  /** If true, start a listening session as soon as this consumer mounts. */
+  autoStart?: boolean;
+}
+
+const { onReady, autoStart = false }: Props = $props();
+
+const stt = useSTT();
+// This fixture intentionally snapshots props during setup (test-only).
+// svelte-ignore state_referenced_locally
+onReady?.(stt);
+// svelte-ignore state_referenced_locally
+if (autoStart) {
+  void stt.start();
+}
+</script>

package/dist/hooks/__tests__/stt-consumer.fixture.svelte.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Test consumer that calls the real `useSTT()` hook so its `onDestroy`
+ * per-hook ownership logic (R4) runs when this component unmounts.
+ */
+import { type UseSTTReturn } from '../useSTT.svelte.js';
+interface Props {
+    /** Hand the live hook back to the test so it can call start()/stop(). */
+    onReady?: (stt: UseSTTReturn) => void;
+    /** If true, start a listening session as soon as this consumer mounts. */
+    autoStart?: boolean;
+}
+declare const SttConsumer: import("svelte").Component<Props, {}, "">;
+type SttConsumer = ReturnType<typeof SttConsumer>;
+export default SttConsumer;
+//# sourceMappingURL=stt-consumer.fixture.svelte.d.ts.map

package/dist/hooks/__tests__/stt-consumer.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-consumer.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/stt-consumer.fixture.svelte.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,OAAO,EAAE,KAAK,YAAY,EAAU,MAAM,qBAAqB,CAAC;AAGhE,UAAU,KAAK;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAoBD,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/hooks/__tests__/stt-ownership-harness.svelte

@@ -0,0 +1,42 @@
+<script lang="ts">
+/**
+ * R4 harness: sets a fake app-state manager on context, then mounts/unmounts
+ * `useSTT()` consumers so the test can prove per-hook ownership — unmounting a
+ * consumer that did NOT start listening must not stop the shared singleton.
+ */
+import type { SmrtAppStateManager } from '../../state/app-state.svelte.js';
+import { setAppStateContext } from '../../state/context.js';
+import type { UseSTTReturn } from '../useSTT.svelte.js';
+import SttConsumer from './stt-consumer.fixture.svelte';
+
+interface Props {
+  manager: SmrtAppStateManager;
+  showA?: boolean;
+  showB?: boolean;
+  onReadyA?: (stt: UseSTTReturn) => void;
+  onReadyB?: (stt: UseSTTReturn) => void;
+  autoStartA?: boolean;
+  autoStartB?: boolean;
+}
+
+const {
+  manager,
+  showA = true,
+  showB = true,
+  onReadyA,
+  onReadyB,
+  autoStartA = false,
+  autoStartB = false,
+}: Props = $props();
+
+// Context is set once during setup with the initial manager (test-only).
+// svelte-ignore state_referenced_locally
+setAppStateContext(manager);
+</script>
+
+{#if showA}
+  <SttConsumer onReady={onReadyA} autoStart={autoStartA} />
+{/if}
+{#if showB}
+  <SttConsumer onReady={onReadyB} autoStart={autoStartB} />
+{/if}

package/dist/hooks/__tests__/stt-ownership-harness.svelte.d.ts

@@ -0,0 +1,20 @@
+/**
+ * R4 harness: sets a fake app-state manager on context, then mounts/unmounts
+ * `useSTT()` consumers so the test can prove per-hook ownership — unmounting a
+ * consumer that did NOT start listening must not stop the shared singleton.
+ */
+import type { SmrtAppStateManager } from '../../state/app-state.svelte.js';
+import type { UseSTTReturn } from '../useSTT.svelte.js';
+interface Props {
+    manager: SmrtAppStateManager;
+    showA?: boolean;
+    showB?: boolean;
+    onReadyA?: (stt: UseSTTReturn) => void;
+    onReadyB?: (stt: UseSTTReturn) => void;
+    autoStartA?: boolean;
+    autoStartB?: boolean;
+}
+declare const SttOwnershipHarness: import("svelte").Component<Props, {}, "">;
+type SttOwnershipHarness = ReturnType<typeof SttOwnershipHarness>;
+export default SttOwnershipHarness;
+//# sourceMappingURL=stt-ownership-harness.svelte.d.ts.map

package/dist/hooks/__tests__/stt-ownership-harness.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-ownership-harness.svelte.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/stt-ownership-harness.svelte.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,UAAU,KAAK;IACb,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiCD,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/hooks/__tests__/useSTT-ownership.test.js

@@ -0,0 +1,102 @@
+/**
+ * R4 regression (T2 #1403): useSTT()/useTTS() attach onDestroy to the
+ * Provider-level *singleton* manager. Before the fix, unmounting ANY hook
+ * consumer that found the manager listening would call stopListening() —
+ * aborting a recording another consumer had started. The fix tracks per-hook
+ * ownership: a consumer only stops the singleton if it started the session.
+ */
+import { render } from '@testing-library/svelte';
+import { tick } from 'svelte';
+import { describe, expect, it, vi } from 'vitest';
+import Harness from './stt-ownership-harness.svelte';
+/**
+ * Minimal fake manager exposing only what useSTT touches. `isListening`
+ * flips true once any consumer calls startListening().
+ */
+function makeFakeManager() {
+    const listening = { value: false };
+    const startListening = vi.fn(async () => {
+        listening.value = true;
+    });
+    const stopListening = vi.fn(async () => {
+        listening.value = false;
+    });
+    const manager = {
+        startListening,
+        stopListening,
+        initializeSTT: vi.fn(async () => ({})),
+        get state() {
+            return {
+                ai: {
+                    stt: {
+                        get isListening() {
+                            return listening.value;
+                        },
+                    },
+                },
+            };
+        },
+    };
+    return { manager, startListening, stopListening, listening };
+}
+describe('useSTT per-hook ownership (R4)', () => {
+    it("unmounting a non-owning consumer does not stop another consumer's recording", async () => {
+        const { manager, startListening, stopListening } = makeFakeManager();
+        let sttA;
+        const { rerender, unmount } = render(Harness, {
+            props: {
+                manager,
+                showA: true,
+                showB: true,
+                onReadyA: (s) => {
+                    sttA = s;
+                },
+            },
+        });
+        // Consumer A starts the shared listening session.
+        await sttA?.start();
+        await tick();
+        expect(startListening).toHaveBeenCalledTimes(1);
+        // Unmount consumer B (which never started). It must NOT stop A's session.
+        await rerender({ manager, showA: true, showB: false });
+        await tick();
+        expect(stopListening).not.toHaveBeenCalled();
+        // Now unmount everything: the owning consumer A stops its own session.
+        unmount();
+        await tick();
+        expect(stopListening).toHaveBeenCalledTimes(1);
+    });
+    it('an owning consumer stops the session it started on unmount', async () => {
+        const { manager, startListening, stopListening } = makeFakeManager();
+        let sttA;
+        const { unmount } = render(Harness, {
+            props: {
+                manager,
+                showA: true,
+                showB: false,
+                onReadyA: (s) => {
+                    sttA = s;
+                },
+            },
+        });
+        await sttA?.start();
+        await tick();
+        expect(startListening).toHaveBeenCalledTimes(1);
+        unmount();
+        await tick();
+        expect(stopListening).toHaveBeenCalledTimes(1);
+    });
+    it('a consumer that never started does not stop a session on unmount', async () => {
+        const { manager, stopListening, listening } = makeFakeManager();
+        // Simulate the singleton already listening (started elsewhere).
+        listening.value = true;
+        const { unmount } = render(Harness, {
+            props: { manager, showA: true, showB: false },
+        });
+        await tick();
+        // Consumer A never called start(); unmounting must leave the session alone.
+        unmount();
+        await tick();
+        expect(stopListening).not.toHaveBeenCalled();
+    });
+});

package/dist/hooks/useSTT.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSTT.svelte.d.ts","sourceRoot":"","sources":["../../src/hooks/useSTT.svelte.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,qBAAqB;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,gEAAgE;IAChE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAqEhE"}
+{"version":3,"file":"useSTT.svelte.d.ts","sourceRoot":"","sources":["../../src/hooks/useSTT.svelte.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,qBAAqB;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,gEAAgE;IAChE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CAmFhE"}