@happyvertical/smrt-svelte 0.30.0 → 0.31.0

package/AGENTS.md

@@ -198,7 +198,10 @@ await expectNoA11yViolations(container); // axe; color-contrast off (jsdom has n
 ## Dependencies
 
 - `@happyvertical/smrt-types` (shared types) — includes the identity data contracts (`User`, `Role`, `Membership`, `Tenant`) the role/membership components type against, so no dependency on `smrt-users` / `smrt-profiles` is needed
-- Peer: `svelte` >=5.18.2, `@happyvertical/smrt-agents`, `@happyvertical/smrt-jobs` (all optional)
+- `@happyvertical/smrt-ui` (UI runtime: primitives, theme system, i18n client, module registry) and `@happyvertical/smrt-agents` (admin shells type against its `/ui` contracts) are hard `dependencies`.
+- `@happyvertical/smrt-languages` is a hard `dependency` (not an optional peer): the Node-only `/i18n/server` subpath imports its resolver. The browser bundle still excludes it — the client `/i18n` layer never imports the languages root, so it tree-shakes out.
+- `@happyvertical/logger` (SDK) is a `dependency` — the browser-safe console logger used for voice/AI error reporting in the form components.
+- Peer (all optional): `svelte` >=5.18.2, plus the browser-AI engines (`@huggingface/transformers`, `@mlc-ai/web-llm`, `@remotion/whisper-web`, `@xenova/transformers`) and `chrono-node`.
 
 ## Workspace shell primitives
 

package/dist/Provider.svelte

@@ -7,6 +7,7 @@ import {
 import type { Snippet } from 'svelte';
 import { onDestroy, untrack } from 'svelte';
 import AILoadingOverlay from './browser-ai/svelte/components/AILoadingOverlay.svelte';
+import { logger } from './internal/logger.js';
 import type {
   AIConfig,
   AILoadingState,
@@ -188,9 +189,18 @@ $effect(() => {
   }
 });
 
-// Cleanup on destroy
+// Cleanup on destroy. Dispose the whole manager (not just the socket) so it
+// unsubscribes its listeners from the module-surviving warm AI adapters; left
+// attached, each destroyed Provider would keep pinning its `_state` proxy via
+// those adapters' listener `Set`s and leak one set per navigation (R1). The
+// warm cache itself survives — dispose() leaves cached adapters intact.
 onDestroy(() => {
-  appState.disconnectSocket();
+  // dispose() is async; isolate + log its rejection so a failing adapter
+  // teardown surfaces as a logged error instead of an unhandled promise
+  // rejection during Provider teardown.
+  void appState.dispose().catch((error) => {
+    logger.error('AppState dispose failed during Provider teardown', { error });
+  });
 });
 </script>
 

package/dist/Provider.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Provider.svelte.d.ts","sourceRoot":"","sources":["../src/Provider.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,OAAO,EACP,YAAY,EACZ,IAAI,EACL,MAAM,sBAAsB,CAAC;AAK9B,UAAU,KAAK;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAiID,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Provider.svelte.d.ts","sourceRoot":"","sources":["../src/Provider.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,OAAO,EACP,YAAY,EACZ,IAAI,EACL,MAAM,sBAAsB,CAAC;AAK9B,UAAU,KAAK;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AA2ID,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/components/admin/AgentSettingsShell.svelte

@@ -49,7 +49,11 @@ const {
   dbConfigs = {},
 }: Props = $props();
 
+// Stable per-instance id base so multiple shells don't collide on tab/panel ids.
+const idBase = $props.id();
+
 let activeAgentId = $state<string | null>(null);
+let tablistEl: HTMLElement | null = $state(null);
 
 // Initialize to first agent
 $effect(() => {
@@ -64,6 +68,50 @@ function handleAgentClick(agentId: string) {
   activeAgentId = agentId;
 }
 
+/**
+ * Roving-tabindex keyboard navigation for the agent switcher (C8). The list is
+ * a vertical tablist, so Up/Down move between agents (plus Home/End); mirrors
+ * the horizontal pattern in AgentAdminTabs.
+ */
+function handleAgentKeydown(event: KeyboardEvent, currentAgentId: string) {
+  const currentIndex = agents.findIndex((a) => a.id === currentAgentId);
+  if (currentIndex === -1) return;
+
+  let nextIndex: number | null = null;
+  switch (event.key) {
+    case 'ArrowDown':
+    case 'ArrowRight':
+      event.preventDefault();
+      nextIndex = (currentIndex + 1) % agents.length;
+      break;
+    case 'ArrowUp':
+    case 'ArrowLeft':
+      event.preventDefault();
+      nextIndex = (currentIndex - 1 + agents.length) % agents.length;
+      break;
+    case 'Home':
+      event.preventDefault();
+      nextIndex = 0;
+      break;
+    case 'End':
+      event.preventDefault();
+      nextIndex = agents.length - 1;
+      break;
+  }
+
+  if (nextIndex !== null && nextIndex !== currentIndex) {
+    const nextAgentId = agents[nextIndex].id;
+    activeAgentId = nextAgentId;
+    // Focus the newly-selected tab after the DOM updates.
+    requestAnimationFrame(() => {
+      const tabButton = tablistEl?.querySelector(
+        `[data-agent-id="${CSS.escape(nextAgentId)}"]`,
+      ) as HTMLElement | null;
+      tabButton?.focus();
+    });
+  }
+}
+
 async function handleSave(slotId: string, config: unknown) {
   if (activeAgentId && onSave) {
     await onSave(activeAgentId, slotId, config);
@@ -74,13 +122,26 @@ async function handleSave(slotId: string, config: unknown) {
 <div class="agent-settings-shell" class:single-agent={agents.length === 1}>
 	{#if agents.length > 1}
 		<aside class="agents-sidebar">
-			<h3 class="sidebar-title">Agents</h3>
-			<nav class="agents-list">
+			<h3 class="sidebar-title" id="{idBase}-agents-title">Agents</h3>
+			<div
+				class="agents-list"
+				role="tablist"
+				aria-orientation="vertical"
+				aria-labelledby="{idBase}-agents-title"
+				bind:this={tablistEl}
+			>
 				{#each agents as agent}
 					<button
 						class="agent-button"
 						class:active={activeAgentId === agent.id}
+						role="tab"
+						aria-selected={activeAgentId === agent.id}
+						aria-controls="{idBase}-panel"
+						id="{idBase}-tab-{agent.id}"
+						data-agent-id={agent.id}
+						tabindex={activeAgentId === agent.id ? 0 : -1}
 						onclick={() => handleAgentClick(agent.id)}
+						onkeydown={(e) => handleAgentKeydown(e, agent.id)}
 					>
 						<span class="agent-class">{agent.agentClass}</span>
 						{#if agent.name}
@@ -88,11 +149,18 @@ async function handleSave(slotId: string, config: unknown) {
 						{/if}
 					</button>
 				{/each}
-			</nav>
+			</div>
 		</aside>
 	{/if}
 
-	<main class="agent-content">
+	<main
+		class="agent-content"
+		id="{idBase}-panel"
+		role={agents.length > 1 ? 'tabpanel' : undefined}
+		aria-labelledby={agents.length > 1 && activeAgentId
+			? `${idBase}-tab-${activeAgentId}`
+			: undefined}
+	>
 		{#if activeAgent}
 			<header class="agent-header">
 				<h2 class="agent-title">{activeAgent.agentClass}</h2>

package/dist/components/admin/AgentSettingsShell.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSettingsShell.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/admin/AgentSettingsShell.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EACxB,YAAY,EACb,MAAM,+BAA+B,CAAC;AAMvC;;;GAGG;AACH,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,wBAAwB,CAAC;IACnC,iEAAiE;IACjE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAsFD,QAAA,MAAM,kBAAkB,2CAAwC,CAAC;AACjE,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"AgentSettingsShell.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/admin/AgentSettingsShell.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EACxB,YAAY,EACb,MAAM,+BAA+B,CAAC;AAMvC;;;GAGG;AACH,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,wBAAwB,CAAC;IACnC,iEAAiE;IACjE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAwID,QAAA,MAAM,kBAAkB,2CAAwC,CAAC;AACjE,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,eAAe,kBAAkB,CAAC"}

package/dist/components/admin/__tests__/AgentSettingsShell.tablist.test.js

@@ -0,0 +1,93 @@
+/**
+ * Regression: the agent switcher is a proper ARIA tablist (C8).
+ *
+ * It was a <nav> of <button>s acting as single-select tabs, with no
+ * role/aria-selected/roving-tabindex/arrow-key nav — unlike sibling
+ * AgentAdminTabs which does the full tablist. The fix adds role="tablist" +
+ * role="tab" + aria-selected + roving tabindex + Up/Down/Home/End navigation,
+ * and marks the content panel role="tabpanel".
+ */
+import { createUIRegistry } from '@happyvertical/smrt-agents/ui';
+import { render, screen, waitFor, within } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import { describe, expect, it } from 'vitest';
+import AgentSettingsShell from '../AgentSettingsShell.svelte';
+/**
+ * Roving focus moves via requestAnimationFrame, so wait for the expected tab to
+ * actually receive focus before dispatching the next key (otherwise the next
+ * keydown fires on the previously-focused tab).
+ */
+async function expectFocused(el) {
+    await waitFor(() => expect(el).toHaveFocus());
+}
+function agents() {
+    return [
+        { id: 'a1', agentClass: 'Praeco', name: 'Alpha', slots: {} },
+        { id: 'a2', agentClass: 'Caelus', name: 'Beta', slots: {} },
+        { id: 'a3', agentClass: 'Nimbus', name: 'Gamma', slots: {} },
+    ];
+}
+function renderShell() {
+    return render(AgentSettingsShell, {
+        props: {
+            registry: createUIRegistry(),
+            agents: agents(),
+            configs: {},
+        },
+    });
+}
+/**
+ * The shell embeds AgentAdminTabs (its own slot tablist), so scope queries to
+ * the agent-switcher tablist — identified by its "Agents" accessible name.
+ */
+function switcher() {
+    return screen.getByRole('tablist', { name: 'Agents' });
+}
+function switcherTabs() {
+    return within(switcher()).getAllByRole('tab');
+}
+describe('AgentSettingsShell — agent switcher tablist (C8)', () => {
+    it('renders a tablist of tabs with the first selected', () => {
+        renderShell();
+        expect(switcher()).toBeInTheDocument();
+        const tabs = switcherTabs();
+        expect(tabs).toHaveLength(3);
+        expect(tabs[0]).toHaveAttribute('aria-selected', 'true');
+        expect(tabs[1]).toHaveAttribute('aria-selected', 'false');
+    });
+    it('uses a roving tabindex (only the selected tab is tabbable)', () => {
+        renderShell();
+        const tabs = switcherTabs();
+        expect(tabs[0]).toHaveAttribute('tabindex', '0');
+        expect(tabs[1]).toHaveAttribute('tabindex', '-1');
+        expect(tabs[2]).toHaveAttribute('tabindex', '-1');
+    });
+    it('moves selection with ArrowDown / ArrowUp', async () => {
+        renderShell();
+        switcherTabs()[0].focus();
+        await userEvent.keyboard('{ArrowDown}');
+        expect(switcherTabs()[1]).toHaveAttribute('aria-selected', 'true');
+        await expectFocused(switcherTabs()[1]);
+        await userEvent.keyboard('{ArrowUp}');
+        expect(switcherTabs()[0]).toHaveAttribute('aria-selected', 'true');
+        await expectFocused(switcherTabs()[0]);
+    });
+    it('jumps to last/first with End / Home', async () => {
+        renderShell();
+        switcherTabs()[0].focus();
+        await userEvent.keyboard('{End}');
+        expect(switcherTabs()[2]).toHaveAttribute('aria-selected', 'true');
+        await expectFocused(switcherTabs()[2]);
+        await userEvent.keyboard('{Home}');
+        expect(switcherTabs()[0]).toHaveAttribute('aria-selected', 'true');
+        await expectFocused(switcherTabs()[0]);
+    });
+    it('exposes a tabpanel wired to the selected tab', () => {
+        renderShell();
+        const panel = screen.getByRole('tabpanel');
+        const selectedTab = switcherTabs().find((t) => t.getAttribute('aria-selected') === 'true');
+        expect(selectedTab).toBeTruthy();
+        expect(panel).toHaveAttribute('aria-labelledby', selectedTab?.id);
+        expect(selectedTab).toHaveAttribute('aria-controls', panel.id);
+    });
+});

package/dist/components/forms/DateRangeInput.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,
@@ -219,15 +220,26 @@ onDestroy(() => {
 async function startRecording() {
   if (!isSmrt || disabled || isParsing) return;
 
-  if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
-    await stt.initialize({ type: 'whisper-wasm' });
-  }
-
   parseError = null;
   recordingStartTime = Date.now();
   isRecording = 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) {
+    isRecording = false;
+    parseError =
+      err instanceof Error ? err.message : 'Could not start voice input';
+    logger.error('DateRangeInput: failed to start voice recording', {
+      field: name,
+      error: err,
+    });
+  }
 }
 
 async function stopRecording() {
@@ -307,6 +319,17 @@ function handleTouchEnd() {
   stopRecording();
 }
 
+// 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 (isRecording) {
+    stopRecording();
+  } else {
+    startRecording();
+  }
+}
+
 const primaryControlId = $derived(isSmrt ? `${name}_voice` : `${name}_start`);
 </script>
 
@@ -342,6 +365,7 @@ const primaryControlId = $derived(isSmrt ? `${name}_voice` : `${name}_start`);
           class="mic-btn"
           class:active={isRecording}
           disabled={disabled || isParsing}
+          onkeydown={handleMicKeydown}
           onmousedown={handleMouseDown}
           onmouseup={handleMouseUp}
           onmouseleave={handleMouseLeave}

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

@@ -1 +1 @@
-{"version":3,"file":"DateRangeInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/DateRangeInput.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,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,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C;AA2WD,QAAA,MAAM,cAAc,gEAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"DateRangeInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/DateRangeInput.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,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,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C;AAkYD,QAAA,MAAM,cAAc,gEAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/forms/DateTimeInput.svelte

@@ -5,6 +5,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,
@@ -177,17 +178,28 @@ async function parseNaturalLanguage(text: string): Promise<string> {
 async function startHoldRecording() {
   if (!isSmrt || disabled || isParsing) return;
 
-  // Initialize STT with Whisper v2 for speed + accuracy
-  if (!stt.isReady || stt.adapterType !== 'whisper-wasm') {
-    await stt.initialize({ type: 'whisper-wasm' });
-  }
-
   parseError = null;
   recordingStartTime = Date.now();
   isHolding = true;
 
-  // Use continuous mode to capture all speech while holding
-  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 {
+    // 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;
+    parseError =
+      err instanceof Error ? err.message : 'Could not start voice input';
+    logger.error('DateTimeInput: failed to start voice recording', {
+      field: name,
+      error: err,
+    });
+  }
 }
 
 async function stopHoldRecording() {
@@ -276,6 +288,20 @@ function handleMicTouchStart(e: TouchEvent) {
   startHoldRecording();
 }
 
+// Keyboard activation for the mic (WCAG 2.1.1): Enter/Space toggles recording.
+// In SMRT mode the text field is read-only, so this is the only keyboard path
+// to enter a value — it must not be removed.
+function handleMicKeydown(e: KeyboardEvent) {
+  if (e.key !== 'Enter' && e.key !== ' ') return;
+  e.preventDefault();
+  e.stopPropagation();
+  if (isHolding) {
+    stopHoldRecording();
+  } else {
+    startHoldRecording();
+  }
+}
+
 function handleNativeChange(e: Event) {
   const target = e.target as HTMLInputElement;
   updateValue(target.value);
@@ -319,6 +345,7 @@ function handleNativeChange(e: Event) {
         class:active={isHolding}
         disabled={disabled || isParsing}
         onclick={handleMicClick}
+        onkeydown={handleMicKeydown}
         onmousedown={handleMicMouseDown}
         onmouseup={handleMouseUp}
         onmouseleave={handleMouseLeave}

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

@@ -1 +1 @@
-{"version":3,"file":"DateTimeInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/DateTimeInput.svelte.ts"],"names":[],"mappings":"AAeA,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,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,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;AAmTD,QAAA,MAAM,aAAa,gDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"DateTimeInput.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/DateTimeInput.svelte.ts"],"names":[],"mappings":"AAgBA,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,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,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;AA6UD,QAAA,MAAM,aAAa,gDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/forms/FileUpload.svelte

@@ -204,7 +204,9 @@ function formatFileSize(bytes: number): string {
   </div>
 
   {#if error}
-    <p class="file-upload__error">{error}</p>
+    <!-- Live region so async validation/reject errors are announced (C7),
+         matching the Form/TextInput announcing pattern. -->
+    <p class="file-upload__error" role="alert" aria-live="assertive">{error}</p>
   {/if}
 
   {#if files.length > 0}

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

@@ -1 +1 @@
-{"version":3,"file":"FileUpload.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/FileUpload.svelte.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,KAAK;IACpB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACnC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAyLD,QAAA,MAAM,UAAU,gDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"FileUpload.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/FileUpload.svelte.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,KAAK;IACpB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACnC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA0LD,QAAA,MAAM,UAAU,gDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/forms/Form.svelte

@@ -5,6 +5,7 @@ import { onDestroy } 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,
   type SMRTFormContext,
@@ -253,7 +254,6 @@ async function startAudioLevelMonitoring(stream: MediaStream) {
 
     const dataArray = new Uint8Array(analyser.frequencyBinCount);
     const SPEECH_THRESHOLD = 20; // Lowered from 30 for better sensitivity
-    let checksWithSpeech = 0;
 
     audioLevelInterval = setInterval(() => {
       if (!analyser || !isFormListening) return;
@@ -261,17 +261,22 @@ async function startAudioLevelMonitoring(stream: MediaStream) {
       analyser.getByteFrequencyData(dataArray);
       const average = dataArray.reduce((a, b) => a + b, 0) / dataArray.length;
 
-      // Log periodically to debug
-      checksWithSpeech++;
-      if (checksWithSpeech % 10 === 0) {
-      }
-
       if (average > SPEECH_THRESHOLD) {
         // Speech detected - reset silence timer
         resetSilenceTimer();
       }
     }, 200); // Check every 200ms
-  } catch (err) {}
+  } catch (err) {
+    // Audio-level monitoring is a silence-detection enhancement, not the
+    // recording path itself — surface the failure but don't abort listening.
+    // A getUserMedia/AudioContext denial here usually means mic-permission
+    // issues the user needs to see (C3).
+    extractError =
+      err instanceof Error
+        ? `Microphone monitoring unavailable: ${err.message}`
+        : 'Microphone monitoring unavailable';
+    logger.warn('Form: audio-level monitoring failed to start', { error: err });
+  }
 }
 
 // Stop audio level monitoring
@@ -369,37 +374,68 @@ async function startFormListening() {
   // Set starting flag to prevent premature stop detection
   isStarting = true;
 
-  // Initialize STT with selected adapter
-  if (!stt.isReady || stt.adapterType !== sttAdapter) {
-    await stt.initialize({ type: sttAdapter });
-  }
-
-  extractError = null;
-  spokenText = '';
-  // Set to current stale result so the effect skips it, but new results will be processed
-  lastProcessedResult = stt.lastResult || '';
-  isFormListening = true;
-  isStopping = false;
-  lastSpeechTime = Date.now();
+  // STT init / start can reject (model fetch failure, mic-permission denial).
+  // Without this guard `isStarting`/`isFormListening` would stay set, the
+  // auto-stop $effect (gated on `!isStarting`) would stay suppressed, and the
+  // form would wedge in a permanent "listening" state with no surfaced error
+  // (C2). On failure: tear down, reset flags, and show the error.
+  try {
+    // Initialize STT with selected adapter
+    if (!stt.isReady || stt.adapterType !== sttAdapter) {
+      await stt.initialize({ type: sttAdapter });
+    }
 
-  // Start silence timer
-  resetSilenceTimer();
+    extractError = null;
+    spokenText = '';
+    // Set to current stale result so the effect skips it, but new results will be processed
+    lastProcessedResult = stt.lastResult || '';
+    isFormListening = true;
+    isStopping = false;
+    lastSpeechTime = Date.now();
+
+    // Start silence timer
+    resetSilenceTimer();
+
+    // Start audio level monitoring for Whisper (no interim results)
+    // Browser STT has interim results so doesn't need this
+    if (sttAdapter === 'whisper-wasm') {
+      try {
+        const levelStream = await navigator.mediaDevices.getUserMedia({
+          audio: true,
+        });
+        startAudioLevelMonitoring(levelStream);
+      } catch (err) {
+        // Mic-permission denial / no device — surface it; the user must see
+        // why dictation isn't working (C3).
+        extractError =
+          err instanceof Error
+            ? `Microphone access failed: ${err.message}`
+            : 'Microphone access failed';
+        logger.warn('Form: getUserMedia failed for audio-level monitoring', {
+          error: err,
+        });
+      }
+    }
 
-  // Start audio level monitoring for Whisper (no interim results)
-  // Browser STT has interim results so doesn't need this
-  if (sttAdapter === 'whisper-wasm') {
-    try {
-      const levelStream = await navigator.mediaDevices.getUserMedia({
-        audio: true,
-      });
-      startAudioLevelMonitoring(levelStream);
-    } catch (err) {}
+    await stt.start({ continuous: true, interimResults: true });
+  } catch (err) {
+    // Reset listening state so the form isn't wedged, and stop any monitoring
+    // that may have started before the failure.
+    isFormListening = false;
+    stopAudioLevelMonitoring();
+    if (silenceTimer) {
+      clearTimeout(silenceTimer);
+      silenceTimer = null;
+    }
+    extractError =
+      err instanceof Error
+        ? err.message
+        : 'Could not start voice input. Check microphone permissions.';
+    logger.error('Form: failed to start form listening', { error: err });
+  } finally {
+    // Clear starting flag now that STT is actually listening (or has failed).
+    isStarting = false;
   }
-
-  await stt.start({ continuous: true, interimResults: true });
-
-  // Clear starting flag now that STT is actually listening
-  isStarting = false;
 }
 
 async function stopFormListening() {
@@ -730,7 +766,7 @@ function getFormData(): Record<string, unknown> {
        was never emitted (issue #1431); color-mix derives the alpha from the
        emitted `--smrt-color-primary` token instead. */
     background: color-mix(in srgb, var(--smrt-color-primary, #166534) 90%, transparent);
-    color: white;
+    color: var(--smrt-color-on-primary, #fff);
     font-size: var(--smrt-typography-body-medium-size, 0.875rem);
     box-shadow: 0 -2px 12px color-mix(in srgb, var(--smrt-color-shadow) 15%, transparent);
     z-index: var(--smrt-z-index-toast, 1500);

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

@@ -1 +1 @@
-{"version":3,"file":"Form.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/Form.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAUtC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,KAAK;IACpB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnD,4DAA4D;IAC5D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0hBD,QAAA,MAAM,IAAI,2CAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Form.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/Form.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG7D,MAAM,WAAW,KAAK;IACpB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnD,4DAA4D;IAC5D,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA8jBD,QAAA,MAAM,IAAI,2CAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

package/dist/components/forms/FormMicButton.svelte

@@ -29,13 +29,8 @@ let isExtracting = $state(false);
 $effect(() => {
   const checkState = () => {
     if (formContext) {
-      const newListening = formContext.isFormListening;
-      const newExtracting = formContext.isExtracting;
-      // Only log on change to reduce noise
-      if (newListening !== isListening || newExtracting !== isExtracting) {
-      }
-      isListening = newListening;
-      isExtracting = newExtracting;
+      isListening = formContext.isFormListening;
+      isExtracting = formContext.isExtracting;
     }
   };
 
@@ -51,6 +46,14 @@ $effect(() => {
 function handleClick() {
   formContext?.toggleListening();
 }
+
+// Keyboard activation for the role="button" span. A native <button> activates
+// on both Enter and Space; this custom control must replicate both (CS2).
+function handleKeydown(e: KeyboardEvent) {
+  if (e.key !== 'Enter' && e.key !== ' ') return;
+  e.preventDefault();
+  handleClick();
+}
 </script>
 
 {#if isSmrt && formContext}
@@ -59,7 +62,7 @@ function handleClick() {
     class:listening={isListening}
     class:extracting={isExtracting}
     onclick={handleClick}
-    onkeydown={(e) => e.key === 'Enter' && handleClick()}
+    onkeydown={handleKeydown}
     role="button"
     tabindex="0"
     aria-label={isListening ? 'Stop listening' : 'Click to speak'}
@@ -131,8 +134,8 @@ function handleClick() {
     transform: translateX(-50%);
     margin-top: 0.5rem;
     padding: 0.5rem 0.75rem;
-    background: var(--smrt-color-on-surface, #1f2937);
-    color: white;
+    background: var(--smrt-color-inverse-surface, var(--smrt-color-on-surface, #1f2937));
+    color: var(--smrt-color-inverse-on-surface, #fff);
     font-size: var(--smrt-typography-label-medium-size, 0.75rem);
     font-weight: var(--smrt-typography-weight-normal, 400);
     border-radius: 0.375rem;
@@ -148,7 +151,7 @@ function handleClick() {
     left: 50%;
     transform: translateX(-50%);
     border: 6px solid transparent;
-    border-bottom-color: var(--smrt-color-on-surface);
+    border-bottom-color: var(--smrt-color-inverse-surface, var(--smrt-color-on-surface));
   }
 
   @keyframes pulse {

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

@@ -1 +1 @@
-{"version":3,"file":"FormMicButton.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/FormMicButton.svelte.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,KAAK;IACpB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyED,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"FormMicButton.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/forms/FormMicButton.svelte.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,KAAK;IACpB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4ED,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}