@happyvertical/smrt-svelte 0.51.39 → 0.53.0

package/dist/web/__tests__/list-sort-surface.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-sort-surface.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/list-sort-surface.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACT,MAAM,6BAA6B,CAAC;AAGpC,KAAK,gBAAgB,GAAI;IACxB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAqCF,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/web/__tests__/list-sort-surface.svelte.test.js

@@ -0,0 +1,59 @@
+import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import { render, screen } from '@testing-library/svelte';
+import { tick } from 'svelte';
+import { describe, expect, it } from 'vitest';
+import Fixture from './list-sort-surface.fixture.svelte';
+const rows = [
+    { id: 's1', title: 'Budget passes', published: '2026-09-01' },
+    { id: 's2', title: 'Arena opens', published: '2026-09-20' },
+];
+const identity = { surfaceId: 'stories-ui', kind: 'list' };
+let sequence = 0;
+function setSorting(expectedRevision, sorting) {
+    sequence += 1;
+    return {
+        version: 1,
+        commandId: `sort-${sequence}`,
+        identity,
+        expectedRevision,
+        controlId: 'set-sorting',
+        payload: { sorting },
+    };
+}
+describe('useListSurface sorting', () => {
+    it('reports the page sort and applies an agent sort through onSort', async () => {
+        const registry = createDataSurfaceRegistry();
+        render(Fixture, { props: { registry, rows } });
+        await tick();
+        const before = registry.inspect(identity);
+        expect([...(before?.descriptor.query.sortableColumnIds ?? [])].sort()).toEqual(['published', 'title']);
+        expect(before?.descriptor.controls.map((control) => control.id)).toContain('set-sorting');
+        expect(before?.state.sort).toEqual({
+            columnId: 'published',
+            direction: 'desc',
+        });
+        const result = await registry.execute(setSorting(before?.revision ?? 0, [
+            { columnId: 'title', direction: 'asc' },
+        ]));
+        expect(result.ok).toBe(true);
+        await tick();
+        expect(screen.getByTestId('sort').textContent).toBe('title:asc');
+        expect(registry.inspect(identity)?.state.sort).toEqual({
+            columnId: 'title',
+            direction: 'asc',
+        });
+    });
+    it('refuses unsortable columns, multiple rules, and a denied onSort', async () => {
+        const registry = createDataSurfaceRegistry();
+        render(Fixture, { props: { registry, rows, deny: true } });
+        await tick();
+        const revision = () => registry.inspect(identity)?.revision ?? 0;
+        expect((await registry.execute(setSorting(revision(), [{ columnId: 'id', direction: 'asc' }]))).ok).toBe(false);
+        expect((await registry.execute(setSorting(revision(), [
+            { columnId: 'title', direction: 'asc' },
+            { columnId: 'published', direction: 'desc' },
+        ]))).ok).toBe(false);
+        expect((await registry.execute(setSorting(revision(), [{ columnId: 'title', direction: 'asc' }]))).ok).toBe(false);
+        expect(screen.getByTestId('sort').textContent).toBe('published:desc');
+    });
+});

package/dist/web/__tests__/surfaces.child.fixture.svelte

@@ -0,0 +1,69 @@
+<script lang="ts">
+import { useLinkSurface } from '../link-surface.svelte.js';
+import { useListSurface } from '../list-surface.svelte.js';
+import { useStepSurface } from '../step-surface.svelte.js';
+import { tryUseWebMcpUi } from '../webmcp-ui-context.js';
+
+let {
+  rows,
+  step = $bindable('town'),
+  navigate,
+  onContext,
+  create,
+}: {
+  rows: Array<{ id: string; title: string; status: string; token: string }>;
+  step?: string;
+  navigate: (href: string) => void;
+  onContext?: (enabled: boolean) => void;
+  create: () => void;
+} = $props();
+
+onContext?.(tryUseWebMcpUi() !== null);
+
+useListSurface(() => ({
+  surfaceId: 'articles-ui',
+  label: 'Articles',
+  description: 'Articles on this page',
+  columns: [
+    { id: 'id', label: 'ID', rowKey: true },
+    { id: 'title', label: 'Title', searchable: true },
+    { id: 'status', label: 'Status', status: true },
+  ],
+  rows,
+  maxRows: 2,
+}));
+
+useLinkSurface(() => ({
+  surfaceId: 'site-sections-ui',
+  label: 'Site sections',
+  description: 'Pages in this site',
+  links: [
+    { id: 'events', label: 'Events', href: '/s/events' },
+    { id: 'articles', label: 'Articles', href: '/s/articles' },
+  ],
+  navigate,
+  state: { active: 'articles' },
+}));
+
+useStepSurface(() => ({
+  surfaceId: 'new-site-steps',
+  label: 'New site',
+  description: 'Start a new town site',
+  steps: [
+    { id: 'town', label: 'Your town', complete: step !== 'town' },
+    { id: 'features', label: 'Features' },
+  ],
+  current: step,
+  next: () => {
+    step = 'features';
+  },
+  nextWrites: step === 'features',
+  showNext: () => document.getElementById('create')?.focus(),
+  back: () => {
+    step = 'town';
+  },
+}));
+</script>
+
+<p data-testid="step">{step}</p>
+<button id="create" type="button" onclick={create}>Create site</button>

package/dist/web/__tests__/surfaces.child.fixture.svelte.d.ts

@@ -0,0 +1,16 @@
+type $$ComponentProps = {
+    rows: Array<{
+        id: string;
+        title: string;
+        status: string;
+        token: string;
+    }>;
+    step?: string;
+    navigate: (href: string) => void;
+    onContext?: (enabled: boolean) => void;
+    create: () => void;
+};
+declare const Surfaces: import("svelte").Component<$$ComponentProps, {}, "step">;
+type Surfaces = ReturnType<typeof Surfaces>;
+export default Surfaces;
+//# sourceMappingURL=surfaces.child.fixture.svelte.d.ts.map

package/dist/web/__tests__/surfaces.child.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.child.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/surfaces.child.fixture.svelte.ts"],"names":[],"mappings":"AAQC,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAmEF,QAAA,MAAM,QAAQ,0DAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/web/__tests__/surfaces.fixture.svelte

@@ -0,0 +1,26 @@
+<script lang="ts">
+import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import Provider from '../../Provider.svelte';
+import Child from './surfaces.child.fixture.svelte';
+
+let {
+  dataSurfaceRegistry,
+  withProvider = true,
+  ...childProps
+}: {
+  dataSurfaceRegistry: DataSurfaceRegistry;
+  withProvider?: boolean;
+  rows: Array<{ id: string; title: string; status: string; token: string }>;
+  navigate: (href: string) => void;
+  onContext?: (enabled: boolean) => void;
+  create: () => void;
+} = $props();
+</script>
+
+{#if withProvider}
+  <Provider webmcp={{ ui: { dataSurfaceRegistry } }}>
+    <Child {...childProps} />
+  </Provider>
+{:else}
+  <Child {...childProps} />
+{/if}

package/dist/web/__tests__/surfaces.fixture.svelte.d.ts

@@ -0,0 +1,18 @@
+import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+type $$ComponentProps = {
+    dataSurfaceRegistry: DataSurfaceRegistry;
+    withProvider?: boolean;
+    rows: Array<{
+        id: string;
+        title: string;
+        status: string;
+        token: string;
+    }>;
+    navigate: (href: string) => void;
+    onContext?: (enabled: boolean) => void;
+    create: () => void;
+};
+declare const Surfaces: import("svelte").Component<$$ComponentProps, {}, "">;
+type Surfaces = ReturnType<typeof Surfaces>;
+export default Surfaces;
+//# sourceMappingURL=surfaces.fixture.svelte.d.ts.map

package/dist/web/__tests__/surfaces.fixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/surfaces.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAItE,KAAK,gBAAgB,GAAI;IACxB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAuBF,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/web/__tests__/surfaces.svelte.test.js

@@ -0,0 +1,140 @@
+import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
+import { render, screen } from '@testing-library/svelte';
+import { tick } from 'svelte';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import Fixture from './surfaces.fixture.svelte';
+const rows = [
+    {
+        id: 'a1',
+        title: 'Council approves budget',
+        status: 'published',
+        token: 's3cret',
+    },
+    { id: 'a2', title: 'Café opens downtown', status: 'draft', token: 's3cret' },
+    {
+        id: 'a3',
+        title: 'Council meeting moved',
+        status: 'review',
+        token: 's3cret',
+    },
+];
+let sequence = 0;
+function command(identity, controlId, expectedRevision, payload) {
+    sequence += 1;
+    return {
+        version: 1,
+        commandId: `cmd-${sequence}`,
+        identity,
+        expectedRevision,
+        controlId,
+        ...(payload === undefined ? {} : { payload: payload }),
+    };
+}
+afterEach(() => {
+    delete document.modelContext;
+});
+describe('surface hooks on the Provider registry', () => {
+    it('tryUseWebMcpUi is null without a Provider and the hooks register nothing', () => {
+        const registry = createDataSurfaceRegistry();
+        const onContext = vi.fn();
+        render(Fixture, {
+            props: {
+                dataSurfaceRegistry: registry,
+                withProvider: false,
+                rows,
+                navigate: vi.fn(),
+                onContext,
+                create: vi.fn(),
+            },
+        });
+        expect(onContext).toHaveBeenCalledWith(false);
+        expect(registry.list()).toEqual([]);
+    });
+    it('useListSurface publishes projected rows and finds rows by title across all rows', async () => {
+        const registry = createDataSurfaceRegistry();
+        const onContext = vi.fn();
+        const view = render(Fixture, {
+            props: {
+                dataSurfaceRegistry: registry,
+                rows,
+                navigate: vi.fn(),
+                onContext,
+                create: vi.fn(),
+            },
+        });
+        await tick();
+        expect(onContext).toHaveBeenCalledWith(true);
+        const identity = { surfaceId: 'articles-ui', kind: 'list' };
+        const before = registry.inspect(identity);
+        expect(before?.state.rows).toEqual([
+            { id: 'a1', title: 'Council approves budget', status: 'published' },
+            { id: 'a2', title: 'Café opens downtown', status: 'draft' },
+        ]);
+        expect(before?.state.rowsTruncated).toBe(true);
+        expect(JSON.stringify(before?.state)).not.toContain('s3cret');
+        expect(before?.descriptor.query.searchableColumnIds).toEqual(['title']);
+        const found = await registry.execute(command(identity, 'find', before?.revision ?? 0, { text: 'MEETING' }));
+        expect(found.ok).toBe(true);
+        const after = registry.inspect(identity);
+        expect(after?.state.rows).toEqual([
+            { id: 'a3', title: 'Council meeting moved', status: 'review' },
+        ]);
+        expect(after?.state.find).toEqual({ text: 'MEETING', matches: 1 });
+        const accent = await registry.execute(command(identity, 'find', after?.revision ?? 0, 'cafe'));
+        expect(accent.ok).toBe(true);
+        expect(registry.inspect(identity)?.state.rows).toEqual([
+            { id: 'a2', title: 'Café opens downtown', status: 'draft' },
+        ]);
+        const cleared = await registry.execute(command(identity, 'find', registry.inspect(identity)?.revision ?? 0, {
+            text: '',
+        }));
+        expect(cleared.ok).toBe(true);
+        expect(registry.inspect(identity)?.state.find).toBeUndefined();
+        // Table commands stay refused: the page's own controls own its state.
+        const refused = await registry.execute(command(identity, 'set-search', registry.inspect(identity)?.revision ?? 0, {
+            search: 'x',
+        }));
+        expect(refused.ok).toBe(false);
+        view.unmount();
+        expect(registry.list()).toEqual([]);
+    });
+    it('useLinkSurface navigates to a published link', async () => {
+        const registry = createDataSurfaceRegistry();
+        const navigate = vi.fn();
+        render(Fixture, {
+            props: { dataSurfaceRegistry: registry, rows, navigate, create: vi.fn() },
+        });
+        await tick();
+        const identity = { surfaceId: 'site-sections-ui', kind: 'list' };
+        const snapshot = registry.inspect(identity);
+        expect(snapshot?.state.active).toBe('articles');
+        const result = await registry.execute(command(identity, 'open', snapshot?.revision ?? 0, { target: 'events' }));
+        expect(result.ok).toBe(true);
+        expect(navigate).toHaveBeenCalledWith('/s/events');
+    });
+    it('useStepSurface moves a wizard forward and leaves the writing step to the person', async () => {
+        const registry = createDataSurfaceRegistry();
+        const create = vi.fn();
+        render(Fixture, {
+            props: { dataSurfaceRegistry: registry, rows, navigate: vi.fn(), create },
+        });
+        await tick();
+        const identity = { surfaceId: 'new-site-steps', kind: 'custom' };
+        const first = registry.inspect(identity);
+        expect(first?.state.current).toBe('town');
+        expect((await registry.execute(command(identity, 'next', first?.revision ?? 0)))
+            .ok).toBe(true);
+        await tick();
+        expect(screen.getByTestId('step')).toHaveTextContent('features');
+        const second = registry.inspect(identity);
+        expect(second?.state).toMatchObject({
+            current: 'features',
+            nextWrites: true,
+        });
+        expect((await registry.execute(command(identity, 'next', second?.revision ?? 0)))
+            .ok).toBe(true);
+        expect(create).not.toHaveBeenCalled();
+        expect(document.activeElement).toBe(screen.getByRole('button', { name: 'Create site' }));
+        expect(registry.inspect(identity)?.state.awaitingPerson).toBe(true);
+    });
+});

package/dist/web/__tests__/webmcp-ui.test.js

@@ -1,6 +1,7 @@
 import { createDataSurfaceRegistry, } from '@happyvertical/smrt-ui/data';
 import { createControlInteractionRegistry, } from '@happyvertical/smrt-ui/forms';
 import { registerWebMcpBespokeTool, WebMcpToolNameCollisionError, } from '@happyvertical/smrt-web';
+import { isWebMcpProposalTool } from '@happyvertical/smrt-web/webmcp-tool-names';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { registerWebMcpUiTools } from '../webmcp-ui.js';
 function modelContext() {
@@ -207,6 +208,10 @@ describe('registerWebMcpUiTools', () => {
             focus: () => {
                 throw new Error('never-serialize-this cannot be focused');
             },
+            // An agent's `focus` reveals instead of moving keyboard focus.
+            reveal: () => {
+                throw new Error('never-serialize-this cannot be revealed');
+            },
         });
         registerWebMcpUiTools({
             controlRegistry: controls,
@@ -702,4 +707,17 @@ describe('cross-path tool-name lock (#2613)', () => {
         expect(registered).toHaveLength(19);
         bespokeDisposer();
     });
+    it('brands every fixed UI tool as proposal-only for the in-page assistant', () => {
+        const browser = modelContext();
+        const dispose = registerWebMcpUiTools({
+            controlRegistry: createControlInteractionRegistry(),
+            dataSurfaceRegistry: createDataSurfaceRegistry(),
+            document: browser.document,
+        });
+        expect(browser.registered).toHaveLength(6);
+        for (const tool of browser.registered) {
+            expect(isWebMcpProposalTool(tool.execute)).toBe(true);
+        }
+        dispose();
+    });
 });

package/dist/web/index.d.ts

@@ -15,11 +15,14 @@
  * @packageDocumentation
  */
 export { type ActivityFeedHandle, type ActivityFeedMap, type ActivityFeedOptions, activityFeed, type ShellActivityInput, } from './activity-feed.svelte.js';
+export { type UseLinkSurfaceOptions, useLinkSurface, } from './link-surface.svelte.js';
 export { type ListDataSurfaceContext, type ListDataSurfaceContextPatch, type ListDataSurfaceControlResult, type ListDataSurfaceHandle, type MountListDataSurfaceOptions, mountListDataSurface, } from './list-data-surface.svelte.js';
+export { findListRows, type ListSurfaceColumn, type ListSurfaceOptions, listSurfaceDescriptor, projectListRows, useListSurface, } from './list-surface.svelte.js';
 export { type LiveCollection, type LiveCollectionMutation, type LiveCollectionOptions, type LiveCollectionStatus, liveCollection, } from './live-collection.svelte.js';
 export { type RemoteQueryBinding, remoteQuery, } from './remote-query.svelte.js';
+export { type UseStepSurfaceOptions, useStepSurface, } from './step-surface.svelte.js';
 export { type UpdateAvailableView, type UseUpdateAvailableOptions, useUpdateAvailable, } from './update-available.svelte.js';
 export type { WebMcpProviderConfig, WebMcpUiProviderConfig, } from './webmcp-provider.js';
 export { type RegisterWebMcpUiToolsOptions, registerWebMcpUiTools, } from './webmcp-ui.js';
-export { useWebMcpUi, type WebMcpUiContext, } from './webmcp-ui-context.js';
+export { tryUseWebMcpUi, useWebMcpUi, type WebMcpUiContext, } from './webmcp-ui-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,qBAAqB,EAC1B,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,wBAAwB,CAAC"}

package/dist/web/index.js

@@ -15,9 +15,12 @@
  * @packageDocumentation
  */
 export { activityFeed, } from './activity-feed.svelte.js';
+export { useLinkSurface, } from './link-surface.svelte.js';
 export { mountListDataSurface, } from './list-data-surface.svelte.js';
+export { findListRows, listSurfaceDescriptor, projectListRows, useListSurface, } from './list-surface.svelte.js';
 export { liveCollection, } from './live-collection.svelte.js';
 export { remoteQuery, } from './remote-query.svelte.js';
+export { useStepSurface, } from './step-surface.svelte.js';
 export { useUpdateAvailable, } from './update-available.svelte.js';
 export { registerWebMcpUiTools, } from './webmcp-ui.js';
-export { useWebMcpUi, } from './webmcp-ui-context.js';
+export { tryUseWebMcpUi, useWebMcpUi, } from './webmcp-ui-context.js';

package/dist/web/link-surface.svelte.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `useLinkSurface` — mount a navigation list (a menu, a tab row, a section
+ * list) on the nearest `<Provider webmcp>` data-surface registry for the
+ * calling component's lifetime, so an agent can move the person between
+ * pages. See `registerLinkSurface` in `@happyvertical/smrt-ui/data`.
+ *
+ * Re-mounts when the identity (surface id + kind + subject) changes and
+ * publishes link/state changes as new revisions. A no-op without a WebMCP
+ * Provider (nothing could dispatch to it). Call during component init.
+ */
+import { type DataSurfaceRegistry, type LinkSurfaceOptions } from '@happyvertical/smrt-ui/data';
+export type UseLinkSurfaceOptions = Omit<LinkSurfaceOptions, 'registry'>;
+export declare function useLinkSurface(getOptions: () => UseLinkSurfaceOptions | null, registry?: DataSurfaceRegistry): void;
+//# sourceMappingURL=link-surface.svelte.d.ts.map

package/dist/web/link-surface.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-surface.svelte.d.ts","sourceRoot":"","sources":["../../src/web/link-surface.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EAExB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAEzE,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,qBAAqB,GAAG,IAAI,EAC9C,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,IAAI,CAuCN"}

package/dist/web/link-surface.svelte.js

@@ -0,0 +1,49 @@
+/**
+ * `useLinkSurface` — mount a navigation list (a menu, a tab row, a section
+ * list) on the nearest `<Provider webmcp>` data-surface registry for the
+ * calling component's lifetime, so an agent can move the person between
+ * pages. See `registerLinkSurface` in `@happyvertical/smrt-ui/data`.
+ *
+ * Re-mounts when the identity (surface id + kind + subject) changes and
+ * publishes link/state changes as new revisions. A no-op without a WebMCP
+ * Provider (nothing could dispatch to it). Call during component init.
+ */
+import { registerLinkSurface, } from '@happyvertical/smrt-ui/data';
+import { onDestroy } from 'svelte';
+import { tryGetWebMcpUiContext } from './webmcp-ui-context.js';
+export function useLinkSurface(getOptions, registry) {
+    const uiContext = tryGetWebMcpUiContext();
+    let handle = null;
+    let mountedKey = null;
+    let mountedRegistry = null;
+    const teardown = () => {
+        handle?.destroy();
+        handle = null;
+        mountedKey = null;
+        mountedRegistry = null;
+    };
+    $effect(() => {
+        const options = getOptions();
+        const resolved = registry ??
+            (uiContext?.enabled ? uiContext.dataSurfaceRegistry : undefined);
+        if (!resolved || !options) {
+            teardown();
+            return;
+        }
+        const key = JSON.stringify([
+            options.surfaceId,
+            options.kind ?? 'list',
+            options.subject ?? null,
+            (options.controls ?? []).map((control) => control.id),
+        ]);
+        if (key !== mountedKey || resolved !== mountedRegistry) {
+            teardown();
+            handle = registerLinkSurface({ ...options, registry: resolved });
+            mountedKey = key;
+            mountedRegistry = resolved;
+            return;
+        }
+        handle?.update({ links: options.links, state: options.state });
+    });
+    onDestroy(teardown);
+}

package/dist/web/list-surface.svelte.d.ts

@@ -0,0 +1,80 @@
+/**
+ * `useListSurface` — mount a page's rendered list on the nearest
+ * `<Provider webmcp>` data-surface registry in one call.
+ *
+ * A thin convenience over {@link mountListDataSurface} that owns the whole
+ * lifecycle (descriptor, controller, identity-keyed re-mount, context
+ * updates, destroy) and adds what a bare mount does not:
+ *
+ * - the visible rows, projected to the declared columns and capped, are
+ *   published as `state.rows`, so an agent reading the surface sees what the
+ *   person sees even on a page with no server catalog surface;
+ * - a `find` control (when any column is `searchable`) looks rows up by text:
+ *   payload `{ text }` (or a bare string) keeps the rows whose searchable
+ *   columns contain it, case-insensitively, across ALL rows — not only the
+ *   published first page — and publishes them as `state.rows` with
+ *   `state.find = { text, matches }`. An empty text clears it. It narrows
+ *   only what the agent reads; the page's own list is unchanged.
+ *
+ * - sorting (when `sort` and `onSort` are given): the current order is
+ *   published as `state.sort` and in the table snapshot, `sortable` columns
+ *   are declared sortable, and a `set-sorting` control
+ *   (`{ sorting: [{ columnId, direction }] }`, one rule) calls `onSort` — the
+ *   same path the page's own column headers take, so a server-paginated
+ *   list re-queries in that order (see `list-sort` in
+ *   `@happyvertical/smrt-ui/data`).
+ *
+ * Otherwise a read-only mirror: no remote filter/page/selection commands are
+ * accepted (the page's own controls stay the source of truth); `refresh` is
+ * honoured when supplied. Only declared columns leave the page: never declare
+ * a secret (tokens, keys), and mark names/emails the person can see as
+ * `personal`. No-op without a WebMCP Provider. Call during component init.
+ */
+import { type DataSurfaceDescriptor, type DataSurfaceJsonValue, type DataSurfaceKind, type DataSurfaceRegistry, type DataSurfaceSubject, type ListSort } from '@happyvertical/smrt-ui/data';
+export interface ListSurfaceColumn {
+    id: string;
+    label: string;
+    description?: string;
+    /** The row identity column (exactly one; defaults to the first column). */
+    rowKey?: boolean;
+    /** A status column (drives status badges in generic renderers). */
+    status?: boolean;
+    /** Text an agent can look rows up by with the `find` control. */
+    searchable?: boolean;
+    /** `personal` for names/emails a person sees on the page; never declare secrets. */
+    sensitivity?: 'public' | 'personal';
+    /** The list can be ordered by this column (needs `sort` + `onSort` on the options). */
+    sortable?: boolean;
+}
+type JsonPrimitive = string | number | boolean | null;
+export interface ListSurfaceOptions {
+    surfaceId: string;
+    kind?: DataSurfaceKind;
+    subject?: DataSurfaceSubject;
+    label: string;
+    description: string;
+    columns: readonly ListSurfaceColumn[];
+    /** The rows as rendered (after the page's own filters), any shape. */
+    rows: readonly object[];
+    /** Extra JSON state, e.g. the active filter. */
+    context?: Record<string, DataSurfaceJsonValue>;
+    refresh?: () => boolean | Promise<boolean>;
+    /** Cap on published rows (default 50). */
+    maxRows?: number;
+    /** The list's current order, as the page shows it. */
+    sort?: ListSort | null;
+    /**
+     * Re-order the list (the page's header-click path). Return `false` to deny.
+     * Server-sorted lists navigate to the new `?sort=&dir=` URL here.
+     */
+    onSort?: (sort: ListSort) => boolean | void | Promise<boolean | void>;
+}
+/** Project rows to the declared columns only; everything else is dropped. */
+export declare function projectListRows(rows: readonly object[], columns: readonly ListSurfaceColumn[], maxRows?: number): Array<Record<string, JsonPrimitive>>;
+/** Rows whose searchable columns contain `text` (case- and accent-insensitive). */
+export declare function findListRows<T extends object>(rows: readonly T[], columns: readonly ListSurfaceColumn[], text: string): T[];
+/** The descriptor {@link useListSurface} mounts. */
+export declare function listSurfaceDescriptor(options: ListSurfaceOptions): DataSurfaceDescriptor;
+export declare function useListSurface(getOptions: () => ListSurfaceOptions | null, registry?: DataSurfaceRegistry): void;
+export {};
+//# sourceMappingURL=list-surface.svelte.d.ts.map

package/dist/web/list-surface.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-surface.svelte.d.ts","sourceRoot":"","sources":["../../src/web/list-surface.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAGvB,KAAK,QAAQ,EACd,MAAM,6BAA6B,CAAC;AAQrC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACpC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,sEAAsE;IACtE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB;;;OAGG;IAEH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACvE;AAsBD,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,OAAO,SAAmB,GACzB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAUtC;AAMD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,IAAI,EAAE,MAAM,GACX,CAAC,EAAE,CAeL;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,kBAAkB,GAC1B,qBAAqB,CAwFvB;AA4CD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,kBAAkB,GAAG,IAAI,EAC3C,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,IAAI,CA+GN"}