@happyvertical/smrt-svelte 0.51.39 → 0.53.0

package/AGENTS.md

@@ -20,6 +20,9 @@ subpath you are editing. This file keeps what holds in every module.
 | `src/web/webmcp-provider.ts` | Provider config for generated data/model WebMCP tools: definitions, effect policy, namespace, budget, legacy/canonical filters, and fetcher seams (#2520) | — |
 | `src/web/webmcp-ui.ts` | Fixed, low-cardinality WebMCP adapter over the Provider's mounted form-control and data-surface registries (#2521) | — |
 | `src/web/webmcp.svelte.ts` (`useWebMcpTool`) | Component-owned bespoke WebMCP tool. Routes through `@happyvertical/smrt-web`'s `registerWebMcpBespokeTool`, so it shares the fail-closed effect classification and `effects` exposure policy of generated tools — undeclared `annotations` classify destructive and are excluded by default. `namespace` and `maxTools` never apply to a bespoke tool (#2586) | — |
+| `src/web/{list,link,step}-surface.svelte.ts` (`useListSurface`, `useLinkSurface`, `useStepSurface`) | Lifecycle hooks mounting a rendered list (projected `state.rows` + a `find` text lookup), a menu/tab row (`open` → `navigate`, hrefs never published), and a wizard (`next`/`back`/`go-to`; a writing step is revealed via `showNext`, never pressed) on the Provider's data-surface registry. The Svelte-free halves live in `@happyvertical/smrt-ui/data` | — |
+| `src/web/webmcp-ui-context.ts` (`useWebMcpUi`, `tryUseWebMcpUi`) | Provider mounted-UI registries; `tryUseWebMcpUi` returns `null` instead of throwing when there is no Provider or its WebMCP UI is off (#2915) | — |
+| `src/components/forms/Form.svelte` + `FormScope.svelte` | Rich Form spreads native attributes/attachments, takes `enhance`, and its `*_stage_changes` tool covers smrt-ui controls via `controlProposalProperties`/`stageControlProposals` (smrt-ui); `FormScope` is the same without a `<form>` element | — |
 
 The composed WebMCP fixture in
 `src/web/__tests__/webmcp-composed.integration.svelte.test.ts` mounts a real

package/README.md

@@ -182,6 +182,25 @@ default) — except a canonical table-control id (`set-filters`, `reset`,
 reaches `onControl`, even under a custom label. See
 `docs/data-surface-conformance.md` for the full contract.
 
+Three lifecycle hooks cover the common page shapes without any registration
+code; each resolves the nearest Provider's registry (or an explicit one),
+re-mounts on an identity change, and unmounts with the component:
+
+- `useListSurface(() => ({ surfaceId, label, description, columns, rows }))`
+  publishes the page's rendered rows, projected to the declared columns and
+  capped (`maxRows`, default 50), as `state.rows`. Columns marked
+  `searchable` enable a `find` control: `{ text }` publishes the rows whose
+  searchable columns contain the text (any case, accents ignored) across all
+  rows, with `state.find = { text, matches }` — so an agent can look an
+  article up by title on the page. It narrows only what the agent reads;
+  table commands stay refused and the page's own controls stay in charge.
+- `useLinkSurface(() => ({ surfaceId, label, description, links, navigate }))`
+  exposes a menu or tab row as an `open` control (see `registerLinkSurface`
+  in smrt-ui).
+- `useStepSurface(() => ({ surfaceId, …, steps, current, next, back,
+  nextWrites, showNext }))` exposes a wizard's `next`/`back`/`go-to`; a step
+  whose forward button writes is revealed for the person, never pressed.
+
 The default prefix is `smrt_ui_`. Configure `ui.prefix` when multiple Providers
 must coexist in one document; the same prefix cannot be registered twice. The
 six derived names are reserved through the document-global tool-name lock, so
@@ -201,6 +220,47 @@ hidden data-surface columns are not serialized. Read responses are marked as
 untrusted content. Bespoke `useWebMcpTool` and `<Form webmcp>` tools retain their
 existing lifecycle and submit behavior.
 
+#### `<Form webmcp>` with SvelteKit `enhance` and smrt-ui fields
+
+The rich `Form` renders its own `<form>`, so it forwards every native form
+attribute (`method`, `action`, `enctype`, `novalidate`, `autocomplete`,
+`aria-*`, `data-*`, …) and attachments (`{@attach …}`) to that element. A
+component cannot take `use:`, so pass SvelteKit's `enhance` as a prop — it is
+applied to the rendered `<form>` and torn down with it. Without `onsubmit`
+the Form never prevents submission, so `enhance` (or a native POST) runs as
+usual and an error summary above the fields keeps working:
+
+```svelte
+<script lang="ts">
+  import { enhance } from '$app/forms';
+  import { Form } from '@happyvertical/smrt-svelte/forms';
+  import { ErrorSummary, FormGroup, Input } from '@happyvertical/smrt-ui/forms';
+</script>
+
+<Form formId="setup-network" webmcp method="POST" action="?/create" novalidate
+  enhance={(form) => enhance(form, submit)}>
+  <ErrorSummary errors={errors} />
+  <FormGroup label="Network name" id="name"><Input name="name" bind:value={name} /></FormGroup>
+</Form>
+```
+
+Its `<formId>_stage_changes` tool describes rich fields (`TextInput`,
+`MoneyInput`, …) and every other control the registry holds for the form:
+smrt-ui primitives (`FormGroup` + `Input`/`Select`/`Textarea`/`Combobox`/…)
+and composites registered with `useControlRegistration`. Proposals for either
+kind are staged for the person to review and apply; nothing is written or
+submitted by the tool.
+
+`FormScope` (`@happyvertical/smrt-svelte/forms`) is the same tool and review
+surface without a `<form>` element — for a fetch-driven wizard, an editor
+saved in parts, or a page that must keep its own `<form>` markup. It joins
+the nearest Provider's control registry (or a local one) and registers no
+tool until at least one proposable control is mounted.
+
+`tryUseWebMcpUi()` returns the Provider's mounted-UI registries, or `null`
+when there is no Provider or its WebMCP UI is off — use it to fall back to a
+local registry instead of catching `useWebMcpUi()`'s throw (#2915).
+
 Custom rich fields may continue to call `registerField(field)` and later
 `unregisterField(name)`. New code should retain and invoke the disposer returned
 by `registerField`: it is bound to that exact registration, so cleanup cannot
@@ -319,6 +379,112 @@ fetch) and mount `AdminShell` in `+layout.svelte`. The `template-sveltekit`
 scaffold adopts AdminShell as its default chrome exactly this way; copy its
 `src/routes/+layout.server.ts` / `+layout.svelte` / `settings/+page.svelte`.
 
+#### Responsive chrome and resizable edges
+
+AdminShell carries the phone/tablet/desktop chrome itself, so hosts do not
+wrap it in a frame. Everything below is opt-in; without these props and config
+keys the shell renders exactly as before.
+
+```svelte
+<script lang="ts">
+  import {
+    AdminShell,
+    createShellState,
+    PhoneBottomBar,
+    PhoneTopBar,
+    ShellNavToggle,
+    ShellTitle,
+    phoneTopBarFor,
+  } from '@happyvertical/smrt-svelte/workspace';
+
+  const shell = createShellState({
+    config: {
+      top: false,
+      bottom: false,
+      left: {
+        label: 'Navigation',
+        // Drawer on phones, icons on tablets, open on desktop.
+        viewportDefaults: { phone: 'collapsed', tablet: 'collapsed', desktop: 'expanded' },
+      },
+      right: {
+        label: 'Assistant',
+        expandedSize: '28rem',
+        resizable: { min: 320, max: 720 }, // drag, arrows, Home/End, double-click resets
+        phone: 'sheet', // or 'hidden' when the host shows it elsewhere on phones
+        keepMounted: true, // closing the sheet keeps the chat (and its draft) alive
+        overlayMedia: '(max-width: 99.9375rem)', // slide over the page below 1600px
+      },
+    },
+    storageKey: 'my-app-shell',
+  });
+</script>
+
+<AdminShell state={shell} path={page.url.pathname} phone={{ scrim: true, swipeToClose: true }}>
+  {#snippet header()}
+    <ShellNavToggle expanded={shell.panels.left === 'expanded'} onclick={() => shell.togglePanel('left')} />
+    <ShellTitle title="Acme" href="/" />
+  {/snippet}
+  {#snippet phoneTopBar()}
+    <PhoneTopBar model={phoneTopBarFor({ path, homeHref: '/', homeTitle: 'Acme', navItems })} homeHref="/" />
+  {/snippet}
+  {#snippet phoneBottomBar()}
+    <PhoneBottomBar {items} />
+  {/snippet}
+  {#snippet overlays({ viewport })}<!-- PhoneSheet, WorkingStrip, … -->{/snippet}
+  …
+</AdminShell>
+```
+
+- **`header`** is a full-width row above every edge (`#smrt-admin-shell-header`,
+  `--smrt-admin-shell-header-size`, default 3.5rem). On phones it is replaced
+  by `phoneTopBar` when one is given.
+- **Viewport classes**: `shell.viewport` is `phone` (≤ 48rem), `tablet`
+  (≤ 64rem) or `desktop`; `ADMIN_SHELL_PHONE_QUERY` / `ADMIN_SHELL_DESKTOP_QUERY`.
+  `viewportDefaults` apply on first render and whenever the class changes; such
+  an edge never persists its open/closed state.
+- **Phone chrome**: `phoneTopBar` overlays the top of the main region and hides
+  on scroll (`phone.hideOnScroll`, pinned by `pinChrome` or an open drawer);
+  `phoneBottomBar` is a bottom row that a form's `[data-form-action-bar]` (see
+  smrt-ui `FormActionBar`) replaces and the on-screen keyboard hides
+  (`:root[data-keyboard-open]`). `phone.scrim` dims the page behind a drawer or
+  sheet, `phone.swipeToClose` closes drawers by swiping. A `path` change on a
+  phone closes open drawers. `overlays` is a layer above the edges (and above
+  the bottom bar's row) for `PhoneSheet`s and status strips.
+- **Page contracts** on phones: `data-shell-breadcrumbs` is hidden,
+  `data-shell-page-title` is visually hidden while the phone top bar shows
+  (the bar carries the title), `data-shell-tabs` sticks under the top bar and
+  slides away with it. smrt-ui's `PageHeader` renders the first two.
+- **Page trail**: `shellPageTrailFor({ path, homeHref, homeTitle, navItems,
+  parents })` is the one source for a page's ancestors: section homes (home
+  and top-level nav pages) have none; other pages get the home, the nav items
+  above them, then page-given `parents`, never the page itself. Pass the
+  `crumbs` to `PageHeader`; `phoneTopBarFor` (same input plus `pageTitle`)
+  sends the phone back arrow to the last crumb.
+- **Resizable edges**: `resizable` on a `push` side edge adds a
+  `role="separator"` (with `aria-valuenow/min/max` in px) on its inner border.
+  Sizes are stored as `ShellSettingsDelta.sizes` through the settings adapter;
+  `persist: false` / `{ state?: false, size?: false }` opts an edge out of
+  storage.
+- **Overlay edges**: `overlayMedia` on a side edge is a media query under
+  which the expanded edge slides over the page (above a scrim, content keeps
+  its width) instead of pushing it, on tablet and desktop; above it the edge
+  docks. `shell.presentationFor(edge)` reports the live presentation. While
+  an overlay is open the page and the other edge are `inert`, the panel takes
+  focus (unless something inside already has it) and returns it on close;
+  Escape or a scrim click closes it, sliding it back out as the scrim fades
+  (no motion under `prefers-reduced-motion`). Resizing applies only while docked.
+- **Kept panels**: `keepMounted: true` keeps a collapsed edge's panel content
+  (`appPanel`, `tenantPanel`, the focus panel, `systemPanel`) mounted with the
+  `hidden` attribute instead of unmounting it, so component state (a chat
+  draft, scroll position) survives closing. The rail renders as usual; the
+  left edge keeps only a `tenantPanel`.
+- **Nav attention**: a `ShellNavItem` with `attention: true` (or a string
+  label) shows a dot in `TenantNav`, over the icon when collapsed, and
+  announces the label ("Needs attention" by default) inside the link.
+- **Public region ids** (`ADMIN_SHELL_REGION_IDS`): `smrt-admin-shell-header`,
+  `smrt-admin-shell-{top,left,right,bottom}-panel`, and
+  `smrt-admin-shell-main`, which is the page scroller.
+
 - **Migration guide** (first-generation `WorkspaceShell`/`RoleShell` →
   `AdminShell`; adoption is additive and non-breaking):
   [`src/components/workspace/MIGRATION.md`](./src/components/workspace/MIGRATION.md)
@@ -357,7 +523,7 @@ resolve against `smrt-ui`:
 | `@happyvertical/smrt-ui` | `PermissionCheck`, `permission` / `hasPermission` / `hasAnyPermission` / `hasAllPermissions` |
 | `@happyvertical/smrt-ui/ui` | UI primitives (Button, Card, Badge, Pagination) |
 | `@happyvertical/smrt-ui/layout` | Layout (Container, Grid, Header, Footer, Masthead, etc.) |
-| `@happyvertical/smrt-ui/calendar` | Calendar and DayView |
+| `@happyvertical/smrt-ui/calendar` | CalendarView (deprecated: Calendar, DayView) |
 | `@happyvertical/smrt-ui/data` | DataTable, CollectionList/ContentList, CollectionToolbar |
 | `@happyvertical/smrt-ui/feedback` | Modal, ConfirmDialog, LoadingOverlay, ProgressBar |
 | `@happyvertical/smrt-ui/chat` | Message bubble, reaction picker, typing indicator |
@@ -447,3 +613,50 @@ public registry interactions. It does not require `document.modelContext` or
 export mounted closures to remote MCP. Agent proposals retain trusted human
 staged review. See the [bridge contract](../mcp-apps/README.md) for origin
 configuration, capabilities, fallback and synthetic-browser evidence limits.
+
+AdminShell's optional `homeHref` turns default branding into a named home link.
+Use `logoSrc`/`logoAlt` for a logo or a `brand` snippet receiving `{ compact }`
+for custom marks. A collapsed tenant rail keeps a compact linked logo or initial;
+the default app bar keeps the full brand visible at narrow widths. A custom
+`appBar` continues to own its branding. Without these props, branding stays text.
+
+### Voice mode migration (#3261)
+
+**Changed default:** Provider and standalone `createAppState()` now keep voice
+mode off unless explicitly requested. Omitted `autoEnableSmrt` defaults to
+`false`; speech-capable browsers stay in `default` mode. Apps that relied on
+automatic voice activation must opt in with `autoEnableSmrt={true}`. Use
+`mode="smrt"` for an explicit voice-mode choice. An explicit `mode="default"`
+wins over auto-detection from the start of initialization, including when
+`autoEnableSmrt` is true; no transient voice-mode activation occurs.
+Standalone state callers can opt in through initial session preferences
+(`autoEnableSmrt: true`); `initialMode` takes precedence. Runtime mode prop
+updates retain their existing behavior.
+
+### Runtime panel controls (#3246)
+
+Use `shell.setPanelState(edge, 'hidden' | 'collapsed' | 'expanded')` to persist
+runtime panel preferences; app-configured hidden edges remain unavailable.
+AdminShell keeps a discoverable tenant collapse control with supplied navigation
+(`showTenantToggle={false}` opts out), a Menu opener in narrow layouts, and the
+system toggle alongside a custom `systemBar`. Closed narrow drawers are inert;
+opening focuses the first control, and closing or Escape restores the opener.
+TenantNav accepts `density="touch"` for canonical 48px link targets, including
+collapsed rail links; omit density to inherit the theme's control density.
+
+`AdminShell` keeps a supplied `tenantFooter` in the app bar while the left pane
+is collapsed, hidden, or a closed narrow drawer; it moves back to the expanded
+pane without duplicate account controls. Use the optional `account` snippet for
+an account permanently in the app bar (including with a custom `appBar`).
+`WorkspaceAccountMenu density="touch"` sizes its trigger and menu actions to the
+canonical 48px target; omit density to inherit the theme, or choose
+`"comfortable"`. Account menus in the shell app bar open below the bar so the
+existing footer's default placement stays reachable on narrow screens.
+
+`TenantNav` accepts optional `groups: ShellNavGroup[]` (`{ heading, items }`)
+next to its existing flat `items`. Each group has a labelled `role="group"` and
+native disclosure summary; keyboard and touch users can collapse it even in the
+icon rail. Groups start open, preserve nested links and active-route markers,
+and inherit the navigation density. Supply `aria-label="Shop navigation"` for
+an instance-specific landmark name; omission uses the localized default.
+`ShellNavGroup` is exported from `@happyvertical/smrt-svelte/workspace`.

package/agents/components.md

@@ -34,7 +34,14 @@ props, a golden test, and a playground page (`playground/.../primitives`).
 migrate domain re-rolls *onto* them rather than build new primitives:
 
 - **`FileUpload`** (`./forms`) — the canonical upload input; replace ad-hoc
-  drop zones.
+  drop zones. With `name` it posts in a native `multipart/form-data` submit:
+  the accepted list (picks, drops, removals, bound resets) is mirrored onto the
+  visually-hidden input via `DataTransfer` — never `hidden`, which would break
+  `required` validation. Without that constructor the input keeps only a
+  native selection that matches the list, else clears (#3260). A reset of the
+  owning form (`form.reset()`, a reset button, `enhance`'s `update()`) empties
+  the list and reports `onchange([])`, so the list never shows files that no
+  longer post.
 - **`Modal` + forms** (`./feedback` + `./forms`) — compose for dialogs; no
   bespoke modal shells.
 - **`ConfirmDialog`** (`./feedback`) — the standard confirm/destructive-action

package/agents/workspace.md

@@ -45,6 +45,30 @@ App settings, tenant names and environment badges wrap within narrow drawers.
 system bars never clip wrapped chips. Custom bars must allow this flex child
 to shrink; use safe alignment if aligning its contents to the end.
 
+### Responsive chrome, viewport defaults, resizable edges
+
+The root grid has five rows: `header` · top edge · body · bottom edge · phone
+bottom bar. The header and phone-bar tracks are `0rem` unless their snippets
+render, so hosts that pass none of the new props get the original layout; keep
+that invariant (`AdminShell.responsive.test.ts` "backward compatibility").
+Phone drawers and the bottom drawer offset themselves by the header and phone
+bar tracks. `shell.viewport` comes from `ADMIN_SHELL_PHONE_QUERY` (48rem, the
+same boundary as the CSS media query — never make one configurable without the
+other) and `ADMIN_SHELL_DESKTOP_QUERY` (64rem); `installShellViewport` runs on
+mount and the `ShellState` constructor detects the initial class so the first
+paint is right.
+
+Edge config: `viewportDefaults` (applied per class change; such an edge never
+stores its state), `phone: 'drawer' | 'sheet' | 'hidden'` (`sheet` is right
+edge only), `resizable` (side edges, `push` only, not on phones) and `persist`.
+`stripUnpersistedSettings` runs on both `hydrate()` and adapter writes;
+runtime `applySettings` is never filtered. Resized widths live in
+`ShellSettingsDelta.sizes` (px; `null` = configured size, pruned on write).
+Drags update with `persist: false` and persist once on pointer up.
+
+The resize separator is a focusable `role="separator"`: its svelte-ignore of
+the non-interactive a11y warnings is deliberate (WAI-ARIA window splitter).
+
 Run `pnpm --filter @happyvertical/smrt-svelte test:e2e` after building the
 package dependencies. The package-local fixture exercises real Chromium bounds
 and touch input across mobile widths and desktop panel-state combinations.

package/dist/Provider.svelte

@@ -26,12 +26,12 @@ import { setWebMcpUiContext } from './web/webmcp-ui-context.js';
 interface Props {
   /**
    * Initial mode: 'default' | 'smrt'
-   * If not provided, mode is auto-detected based on capabilities
+   * Defaults to standard mode; auto-detection requires autoEnableSmrt=true
    */
   mode?: AppMode;
   /**
    * Whether to auto-enable smrt mode when capabilities are available
-   * @default true
+   * @default false
    */
   autoEnableSmrt?: boolean;
   /**
@@ -98,7 +98,7 @@ interface Props {
 
 const {
   mode,
-  autoEnableSmrt = true,
+  autoEnableSmrt = false,
   user = null,
   permissions = [],
   socket,
@@ -114,18 +114,22 @@ const {
 // Determine if we should show the loading overlay
 const showLoadingOverlay = $derived(ai?.showLoadingOverlay ?? true);
 
-// Create app state
-const appState = createAppState({
-  onCapabilitiesDetected: () => {
-    onReady?.();
-  },
-  onModeChange: (newMode) => {
-    onModeChange?.(newMode);
-  },
-  onAILoadingChange: (state) => {
-    onAILoadingChange?.(state);
-  },
-});
+// Capture initial props once; the effects below own subsequent prop updates.
+const appState = untrack(() =>
+  createAppState({
+    initialMode: mode,
+    session: { preferences: { autoEnableSmrt } },
+    onCapabilitiesDetected: () => {
+      onReady?.();
+    },
+    onModeChange: (newMode) => {
+      onModeChange?.(newMode);
+    },
+    onAILoadingChange: (state) => {
+      onAILoadingChange?.(state);
+    },
+  }),
+);
 
 const localControlRegistry = createControlInteractionRegistry();
 const localDataSurfaceRegistry = createDataSurfaceRegistry();

package/dist/Provider.svelte.d.ts

@@ -5,12 +5,12 @@ import type { WebMcpProviderConfig } from './web/webmcp-provider.js';
 interface Props {
     /**
      * Initial mode: 'default' | 'smrt'
-     * If not provided, mode is auto-detected based on capabilities
+     * Defaults to standard mode; auto-detection requires autoEnableSmrt=true
      */
     mode?: AppMode;
     /**
      * Whether to auto-enable smrt mode when capabilities are available
-     * @default true
+     * @default false
      */
     autoEnableSmrt?: boolean;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Provider.svelte.d.ts","sourceRoot":"","sources":["../src/Provider.svelte.ts"],"names":[],"mappings":"AAKA,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;AAI9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAKrE,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;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IACxC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AA4PD,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":"AAKA,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;AAI9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAKrE,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;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IACxC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAgQD,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/__tests__/provider-mode-harness.svelte

@@ -0,0 +1,14 @@
+<script lang="ts">
+import Provider from '../Provider.svelte';
+import type { AppMode } from '../state/app-state.js';
+import type { SmrtAppStateManager } from '../state/app-state.svelte.js';
+import Probe from './provider-mode-probe.svelte';
+
+interface Props {
+  mode?: AppMode;
+  autoEnableSmrt?: boolean;
+  capture: (state: SmrtAppStateManager) => void;
+}
+const { mode, autoEnableSmrt, capture }: Props = $props();
+</script>
+<Provider {mode} {autoEnableSmrt}><Probe {capture} /></Provider>

package/dist/__tests__/provider-mode-harness.svelte.d.ts

@@ -0,0 +1,11 @@
+import type { AppMode } from '../state/app-state.js';
+import type { SmrtAppStateManager } from '../state/app-state.svelte.js';
+interface Props {
+    mode?: AppMode;
+    autoEnableSmrt?: boolean;
+    capture: (state: SmrtAppStateManager) => void;
+}
+declare const ProviderModeHarness: import("svelte").Component<Props, {}, "">;
+type ProviderModeHarness = ReturnType<typeof ProviderModeHarness>;
+export default ProviderModeHarness;
+//# sourceMappingURL=provider-mode-harness.svelte.d.ts.map

package/dist/__tests__/provider-mode-harness.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-mode-harness.svelte.d.ts","sourceRoot":"","sources":["../../src/__tests__/provider-mode-harness.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAIxE,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC/C;AAaD,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/__tests__/provider-mode-probe.svelte

@@ -0,0 +1,13 @@
+<script lang="ts">
+import { untrack } from 'svelte';
+import type { SmrtAppStateManager } from '../state/app-state.svelte.js';
+import { getAppStateContext } from '../state/context.js';
+
+interface Props {
+  capture: (state: SmrtAppStateManager) => void;
+}
+const { capture }: Props = $props();
+const appState = getAppStateContext();
+untrack(() => capture(appState));
+</script>
+<output aria-label="App mode">{appState.state.mode}</output>

package/dist/__tests__/provider-mode-probe.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { SmrtAppStateManager } from '../state/app-state.svelte.js';
+interface Props {
+    capture: (state: SmrtAppStateManager) => void;
+}
+declare const ProviderModeProbe: import("svelte").Component<Props, {}, "">;
+type ProviderModeProbe = ReturnType<typeof ProviderModeProbe>;
+export default ProviderModeProbe;
+//# sourceMappingURL=provider-mode-probe.svelte.d.ts.map

package/dist/__tests__/provider-mode-probe.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-mode-probe.svelte.d.ts","sourceRoot":"","sources":["../../src/__tests__/provider-mode-probe.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAIxE,UAAU,KAAK;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC/C;AAcD,QAAA,MAAM,iBAAiB,2CAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/browser-ai/adapters/stt/browser-speech.d.ts

@@ -1,5 +1,14 @@
 import type { InitState, OnProgress } from '../../core/types.js';
 import type { BrowserSpeechSTTOptions, STTAdapter, STTCapabilities, STTOptions, STTResult } from './types.js';
+/**
+ * An error from the browser's speech recognition. `speechError` is the Web
+ * Speech error code (`network`, `not-allowed`, `service-not-allowed`,
+ * `no-speech`, `audio-capture`, `aborted`, `language-not-supported`, …).
+ */
+export type BrowserSpeechError = Error & {
+    speechError?: string;
+    speechMessage?: string;
+};
 /**
  * Browser Speech Recognition adapter
  */
@@ -9,6 +18,8 @@ export declare class BrowserSpeechSTTAdapter implements STTAdapter {
     private recognition;
     private options;
     private _isListening;
+    /** Set while our own `abort()` runs, so its `aborted` error is not reported. */
+    private aborting;
     private resultListeners;
     private errorListeners;
     private startListeners;

package/dist/browser-ai/adapters/stt/browser-speech.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-speech.d.ts","sourceRoot":"","sources":["../../../../src/browser-ai/adapters/stt/browser-speech.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAE1C,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAAyB;gBAEjC,OAAO,GAAE,uBAA4B;IAQjD,IAAI,SAAS,IAAI,SAAS,CAEzB;IAEK,iBAAiB,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChE,OAAO,CAAC,wBAAwB;IAwEhC,eAAe,IAAI,eAAe;IA2B5B,KAAK,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,KAAK,IAAI,IAAI;IAMb,WAAW,IAAI,OAAO;IAItB,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAK3D,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAKrD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKzC,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}
+{"version":3,"file":"browser-speech.d.ts","sourceRoot":"","sources":["../../../../src/browser-ai/adapters/stt/browser-speech.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AAWpB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,qBAAa,uBAAwB,YAAW,UAAU;IACxD,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAE1C,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAS;IAC7B,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,YAAY,CAAyB;gBAEjC,OAAO,GAAE,uBAA4B;IAQjD,IAAI,SAAS,IAAI,SAAS,CAEzB;IAEK,iBAAiB,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChE,OAAO,CAAC,wBAAwB;IAqFhC,eAAe,IAAI,eAAe;IA2B5B,KAAK,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,KAAK,IAAI,IAAI;IAOb,WAAW,IAAI,OAAO;IAItB,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAK3D,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAKrD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKzC,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}

package/dist/browser-ai/adapters/stt/browser-speech.js

@@ -23,6 +23,8 @@ export class BrowserSpeechSTTAdapter {
     recognition = null;
     options;
     _isListening = false;
+    /** Set while our own `abort()` runs, so its `aborted` error is not reported. */
+    aborting = false;
     // Event listeners
     resultListeners = new Set();
     errorListeners = new Set();
@@ -94,8 +96,13 @@ export class BrowserSpeechSTTAdapter {
             }
         };
         this.recognition.onerror = (event) => {
+            const code = event.error;
+            if (code === 'aborted' && this.aborting) {
+                // We called abort() ourselves: not an error.
+                return;
+            }
             let error;
-            switch (event.error) {
+            switch (code) {
                 case 'not-allowed':
                 case 'service-not-allowed':
                     error = new PermissionDeniedError('microphone', 'browser-speech');
@@ -110,11 +117,18 @@ export class BrowserSpeechSTTAdapter {
                     error = new Error('Network error during speech recognition');
                     break;
                 case 'aborted':
-                    // User aborted, not really an error
-                    return;
+                    // Not our abort(): the browser (or another tab) cut it off.
+                    error = new Error('Speech recognition was aborted');
+                    break;
                 default:
-                    error = new Error(`Speech recognition error: ${event.error}`);
+                    error = new Error(`Speech recognition error: ${code}`);
             }
+            // The Web Speech error code, so callers can tell `service-not-allowed`
+            // (the browser has no speech service, e.g. Brave) from `not-allowed`
+            // (the microphone is blocked), and `network` from everything else.
+            error.speechError = code;
+            if (event.message)
+                error.speechMessage = event.message;
             for (const cb of this.errorListeners) {
                 cb(error);
             }
@@ -127,6 +141,7 @@ export class BrowserSpeechSTTAdapter {
         };
         this.recognition.onend = () => {
             this._isListening = false;
+            this.aborting = false;
             for (const cb of this.endListeners) {
                 cb();
             }
@@ -181,6 +196,7 @@ export class BrowserSpeechSTTAdapter {
     }
     abort() {
         if (this.recognition && this._isListening) {
+            this.aborting = true;
             this.recognition.abort();
         }
     }