@happyvertical/smrt-svelte 0.53.1 → 0.53.2

package/dist/web/__tests__/view-intent.fixture.svelte.d.ts

@@ -1,15 +0,0 @@
-import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
-import type { ControlInteractionRegistry } from '@happyvertical/smrt-ui/forms';
-import type { ViewIntent } from '@happyvertical/smrt-web';
-import type { UseViewIntentOptions, ViewIntentIdentity } from '../view-intent.svelte.js';
-type $$ComponentProps = {
-    intent: ViewIntent;
-    identity: ViewIntentIdentity;
-    controlRegistry?: ControlInteractionRegistry;
-    dataSurfaceRegistry?: DataSurfaceRegistry;
-    effects?: UseViewIntentOptions['effects'];
-};
-declare const ViewIntent: import("svelte").Component<$$ComponentProps, {}, "">;
-type ViewIntent = ReturnType<typeof ViewIntent>;
-export default ViewIntent;
-//# sourceMappingURL=view-intent.fixture.svelte.d.ts.map

package/dist/web/__tests__/view-intent.fixture.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"view-intent.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/view-intent.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAGjC,KAAK,gBAAgB,GAAI;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,eAAe,CAAC,EAAE,0BAA0B,CAAC;IAC7C,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;CAC3C,CAAC;AA4BF,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/web/__tests__/view-intent.intents.d.ts

@@ -1,14 +0,0 @@
-/**
- * A worked example of the `Foo.intents.ts` sidecar convention (#2588).
- *
- * Every declaration below is a module-scope `defineIntent({ ... })` call with
- * a single object literal — no spreads, no conditionals, no computed values —
- * in a `.ts` module, which is exactly the form #2591's scanner matches
- * without evaluating this file.
- */
-export declare const revealNotesIntent: import("@happyvertical/smrt-web").ViewIntent;
-export declare const stageNotesIntent: import("@happyvertical/smrt-web").ViewIntent;
-/** No `capability` at all — classifies fail-closed as destructive. */
-export declare const clearNotesIntent: import("@happyvertical/smrt-web").ViewIntent;
-export declare const nextPageIntent: import("@happyvertical/smrt-web").ViewIntent;
-//# sourceMappingURL=view-intent.intents.d.ts.map

package/dist/web/__tests__/view-intent.intents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"view-intent.intents.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/view-intent.intents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,iBAAiB,8CAK5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,8CAU3B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,8CAI3B,CAAC;AAEH,eAAO,MAAM,cAAc,8CAKzB,CAAC"}

package/dist/web/__tests__/view-intent.intents.js

@@ -1,38 +0,0 @@
-/**
- * A worked example of the `Foo.intents.ts` sidecar convention (#2588).
- *
- * Every declaration below is a module-scope `defineIntent({ ... })` call with
- * a single object literal — no spreads, no conditionals, no computed values —
- * in a `.ts` module, which is exactly the form #2591's scanner matches
- * without evaluating this file.
- */
-import { defineIntent } from '@happyvertical/smrt-web/intents';
-export const revealNotesIntent = defineIntent({
-    id: 'fixture.reveal_notes',
-    description: 'Scroll the notes field into view',
-    capability: { effect: 'read', idempotent: true, openWorld: false },
-    target: { registry: 'control', action: 'reveal' },
-});
-export const stageNotesIntent = defineIntent({
-    id: 'fixture.stage_notes',
-    description: 'Propose a value for the notes field',
-    capability: { effect: 'write', idempotent: true, openWorld: false },
-    inputSchema: {
-        type: 'object',
-        properties: { value: { type: 'string' } },
-        required: ['value'],
-    },
-    target: { registry: 'control', action: 'stage' },
-});
-/** No `capability` at all — classifies fail-closed as destructive. */
-export const clearNotesIntent = defineIntent({
-    id: 'fixture.clear_notes',
-    description: 'Clear the notes field',
-    target: { registry: 'control', action: 'clear' },
-});
-export const nextPageIntent = defineIntent({
-    id: 'fixture.next_page',
-    description: 'Advance the orders table by one page',
-    capability: { effect: 'read', idempotent: false, openWorld: false },
-    target: { registry: 'dataSurface', controlId: 'next-page', kind: 'table' },
-});

package/dist/web/__tests__/view-intent.svelte.test.js

@@ -1,244 +0,0 @@
-/**
- * The Svelte binding for declarative view intents (#2588).
- *
- * The contract, registry, and compilation are covered in
- * `@happyvertical/smrt-web` (`src/intents.test.ts`). What is proven HERE is
- * the binding: that a declared intent reaches WebMCP through the shared
- * `useWebMcpTool` lifecycle and the Provider's exposure policy, and that
- * executing it moves only mounted registry state.
- */
-import { createDataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
-import { createControlInteractionRegistry } from '@happyvertical/smrt-ui/forms';
-import { WebMcpToolNameCollisionError, webMcpToolNameOwner, } from '@happyvertical/smrt-web';
-import { render } from '@testing-library/svelte';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-const registerBespokeSpy = vi.hoisted(() => vi.fn());
-vi.mock('@happyvertical/smrt-web', async (importOriginal) => {
-    const actual = await importOriginal();
-    registerBespokeSpy.mockImplementation(actual.registerWebMcpBespokeTool);
-    return { ...actual, registerWebMcpBespokeTool: registerBespokeSpy };
-});
-import Fixture from './view-intent.fixture.svelte';
-import { clearNotesIntent, nextPageIntent, revealNotesIntent, stageNotesIntent, } from './view-intent.intents.js';
-import ProviderFixture from './view-intent-provider.fixture.svelte';
-function installModelContext() {
-    const registered = [];
-    document.modelContext = {
-        async registerTool(tool, options) {
-            registered.push({ ...tool, signal: options?.signal });
-        },
-    };
-    return registered;
-}
-/**
- * A Provider that enables the UI adapter also registers the six fixed
- * `smrt_ui_*` tools into the same array, so every Provider-mounted assertion
- * selects by NAME rather than by index or length — the pattern
- * `webmcp-composed.integration.svelte.test.ts` already established.
- */
-function toolNamed(registered, name) {
-    return registered.find((tool) => tool.name === name);
-}
-function mountedControlRegistry() {
-    const registry = createControlInteractionRegistry();
-    let value = 'before';
-    registry.register({
-        identity: { formId: 'order-form', controlId: 'notes' },
-        metadata: { kind: 'text', label: 'Notes', readable: true, writable: true },
-        getValue: () => value,
-        setValue: (next) => {
-            value = String(next);
-        },
-    });
-    return registry;
-}
-afterEach(() => {
-    document.modelContext = undefined;
-    registerBespokeSpy.mockClear();
-    vi.restoreAllMocks();
-});
-describe('useViewIntent', () => {
-    it('registers a declared intent on mount and deregisters on unmount', async () => {
-        const registered = installModelContext();
-        const view = render(Fixture, {
-            props: {
-                intent: revealNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-                controlRegistry: mountedControlRegistry(),
-            },
-        });
-        await vi.waitFor(() => expect(registered).toHaveLength(1));
-        expect(registered[0].name).toBe('fixture_reveal_notes');
-        expect(registered[0].annotations).toMatchObject({
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-            untrustedContentHint: true,
-        });
-        expect(registered[0].signal?.aborted).toBe(false);
-        view.unmount();
-        expect(registered[0].signal?.aborted).toBe(true);
-    });
-    it('routes through registerWebMcpBespokeTool, never document.modelContext directly', async () => {
-        installModelContext();
-        render(Fixture, {
-            props: {
-                intent: revealNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-                controlRegistry: mountedControlRegistry(),
-            },
-        });
-        await vi.waitFor(() => expect(registerBespokeSpy).toHaveBeenCalledTimes(1));
-        expect(registerBespokeSpy.mock.calls[0][0]).toMatchObject({
-            name: 'fixture_reveal_notes',
-        });
-    });
-    it('resolves the mounted registries from the nearest Provider', async () => {
-        const registered = installModelContext();
-        const registry = mountedControlRegistry();
-        render(ProviderFixture, {
-            props: {
-                intent: revealNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-                providerRegistry: registry,
-            },
-        });
-        await vi.waitFor(() => expect(toolNamed(registered, 'fixture_reveal_notes')).toBeDefined());
-    });
-    it("applies the Provider's effects policy to an intent", async () => {
-        const registered = installModelContext();
-        // `clearNotesIntent` declares no capability, so it classifies
-        // fail-closed as destructive and a read-only Provider excludes it.
-        render(ProviderFixture, {
-            props: {
-                intent: clearNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-                providerRegistry: mountedControlRegistry(),
-                effects: ['read'],
-            },
-        });
-        await vi.waitFor(() => expect(registerBespokeSpy).toHaveBeenCalledTimes(1));
-        // `owner: 'intent'` rides along on every intent registration so the
-        // tool-name lock blames the intent, not a bespoke tool (#2613).
-        expect(registerBespokeSpy.mock.calls[0][1]).toEqual({
-            effects: ['read'],
-            owner: 'intent',
-        });
-        // The six fixed `smrt_ui_*` tools register alongside it; only the intent
-        // must be absent.
-        expect(toolNamed(registered, 'fixture_clear_notes')).toBeUndefined();
-    });
-    it('executes by dispatching one agent-sourced registry command', async () => {
-        const registered = installModelContext();
-        const registry = mountedControlRegistry();
-        const executeSpy = vi.spyOn(registry, 'execute');
-        const fetchSpy = vi.spyOn(globalThis, 'fetch');
-        render(ProviderFixture, {
-            props: {
-                intent: stageNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-                providerRegistry: registry,
-                effects: ['read', 'write'],
-            },
-        });
-        await vi.waitFor(() => expect(toolNamed(registered, 'fixture_stage_notes')).toBeDefined());
-        const tool = toolNamed(registered, 'fixture_stage_notes');
-        if (!tool)
-            throw new Error('intent tool was not registered');
-        await tool.execute({ value: 'after' });
-        expect(fetchSpy).not.toHaveBeenCalled();
-        const staged = executeSpy.mock.calls.find(([command]) => command.action === 'stage');
-        if (!staged)
-            throw new Error('intent did not dispatch a stage command');
-        expect(staged[0]).toEqual({
-            action: 'stage',
-            identity: { formId: 'order-form', controlId: 'notes' },
-            value: 'after',
-        });
-        // Agent-staged values stay proposals: the command is dispatched as
-        // `source: 'agent'`, so StagedControlReview and the local-gesture
-        // requirement apply unchanged.
-        expect(staged[1]).toEqual({ source: 'agent' });
-    });
-    it('binds a data-surface intent to a mounted surface identity', async () => {
-        const registered = installModelContext();
-        const registry = createDataSurfaceRegistry();
-        const executeSpy = vi.spyOn(registry, 'execute');
-        render(Fixture, {
-            props: {
-                intent: nextPageIntent,
-                identity: { surfaceId: 'orders-table', kind: 'table' },
-                dataSurfaceRegistry: registry,
-            },
-        });
-        await vi.waitFor(() => expect(registered).toHaveLength(1));
-        expect(registered[0].name).toBe('fixture_next_page');
-        // Nothing is mounted under that identity, so the intent reports
-        // not_found rather than inventing a command.
-        expect(JSON.parse(String(await registered[0].execute({})))).toEqual({
-            ok: false,
-            reason: 'not_found',
-        });
-        expect(executeSpy).not.toHaveBeenCalled();
-    });
-    it('is a no-op with no Provider and no explicit registry', async () => {
-        const registered = installModelContext();
-        render(Fixture, {
-            props: {
-                intent: revealNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-            },
-        });
-        await new Promise((resolve) => setTimeout(resolve, 10));
-        expect(registered).toHaveLength(0);
-        expect(registerBespokeSpy).not.toHaveBeenCalled();
-    });
-    it('reserves its tool name as `intent`, not `bespoke` (#2613)', async () => {
-        // This binding is the only shipped intent path — it reuses
-        // `useWebMcpTool` rather than calling `registerViewIntent`, because the
-        // WebMCP lifecycle must not be duplicated. A collision against a mounted
-        // intent must still blame the INTENT, or an author goes looking for a
-        // `useWebMcpTool` call that does not exist.
-        const registered = installModelContext();
-        const view = render(Fixture, {
-            props: {
-                intent: revealNotesIntent,
-                identity: { formId: 'order-form', controlId: 'notes' },
-                controlRegistry: mountedControlRegistry(),
-            },
-        });
-        await vi.waitFor(() => expect(registered).toHaveLength(1));
-        expect(registered[0].name).toBe('fixture_reveal_notes');
-        expect(webMcpToolNameOwner('fixture_reveal_notes')).toBe('intent');
-        let thrown;
-        try {
-            // What a generated model tool named `fixture_reveal_notes` would hit.
-            const { registerWebMcpBespokeTool } = await import('@happyvertical/smrt-web');
-            registerWebMcpBespokeTool({
-                name: 'fixture_reveal_notes',
-                description: 'x',
-                inputSchema: { type: 'object' },
-                annotations: { readOnlyHint: true },
-                execute: () => 'ok',
-            });
-        }
-        catch (error) {
-            thrown = error;
-        }
-        expect(thrown).toBeInstanceOf(WebMcpToolNameCollisionError);
-        expect(thrown.owner).toBe('intent');
-        view.unmount();
-        expect(webMcpToolNameOwner('fixture_reveal_notes')).toBeUndefined();
-    });
-    it('rejects an identity that does not match the declared target registry', () => {
-        installModelContext();
-        expect(() => render(Fixture, {
-            props: {
-                intent: revealNotesIntent,
-                identity: { surfaceId: 'orders-table', kind: 'table' },
-                controlRegistry: mountedControlRegistry(),
-            },
-        })).toThrow(/needs a \{ formId, controlId \} identity/);
-    });
-});

package/dist/web/__tests__/webmcp-composed.child.fixture.svelte

@@ -1,73 +0,0 @@
-<script lang="ts">
-import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
-import {
-  type DataSurfaceDescriptor,
-  DataTable,
-} from '@happyvertical/smrt-ui/data';
-import Form from '../../components/forms/Form.svelte';
-import TextInput from '../../components/forms/TextInput.svelte';
-import { useWebMcpTool } from '../webmcp.svelte.js';
-
-let { dataSurfaceRegistry }: { dataSurfaceRegistry: DataSurfaceRegistry } =
-  $props();
-
-useWebMcpTool(() => ({
-  name: 'fixture_component_preview',
-  description:
-    'Preview the composed fixture without changing application state.',
-  inputSchema: { type: 'object', properties: {} },
-  annotations: { readOnlyHint: true, openWorldHint: false },
-  execute: () => JSON.stringify({ ok: true, source: 'bespoke-component' }),
-}));
-
-// No `annotations`: fail-closed classifies this destructive (#2586), so it
-// must be excluded under the Provider's default read-only exposure policy
-// and must never reach document.modelContext.registerTool.
-useWebMcpTool(() => ({
-  name: 'fixture_component_unannotated',
-  description: 'A bespoke tool with no declared effect.',
-  inputSchema: { type: 'object', properties: {} },
-  execute: () =>
-    JSON.stringify({ ok: true, source: 'bespoke-component-unannotated' }),
-}));
-
-const tableDescriptor: DataSurfaceDescriptor = {
-  version: 1,
-  identity: { surfaceId: 'fixture-items', kind: 'table' },
-  schemaVersion: 1,
-  label: 'Fixture items',
-  rowKey: 'id',
-  columns: [
-    { id: 'id', label: 'ID', capabilities: ['read', 'project'] },
-    {
-      id: 'name',
-      label: 'Name',
-      capabilities: ['read', 'search', 'filter', 'sort', 'project'],
-    },
-  ],
-  query: { modes: ['rows', 'count'], projectableColumnIds: ['id', 'name'] },
-  controls: ['set-search', 'toggle-sorting'].map((id) => ({ id, label: id })),
-  actions: [],
-  limits: { maxQueryRows: 50, maxQueryBytes: 10_000, maxSelectionSize: 10 },
-};
-
-const rows = [
-  { id: 'item-1', name: 'First' },
-  { id: 'item-2', name: 'Second' },
-];
-const columns = [
-  { id: 'id', label: 'ID', accessor: 'id' },
-  { id: 'name', label: 'Name', accessor: 'name', sortable: true },
-];
-</script>
-
-<Form formId="fixture-form">
-  <TextInput name="title" label="Title" />
-</Form>
-<DataTable
-  data={rows}
-  {columns}
-  rowKey="id"
-  sortable={true}
-  dataSurface={{ registry: dataSurfaceRegistry, descriptor: tableDescriptor }}
-/>

package/dist/web/__tests__/webmcp-composed.child.fixture.svelte.d.ts

@@ -1,8 +0,0 @@
-import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
-type $$ComponentProps = {
-    dataSurfaceRegistry: DataSurfaceRegistry;
-};
-declare const WebmcpComposed: import("svelte").Component<$$ComponentProps, {}, "">;
-type WebmcpComposed = ReturnType<typeof WebmcpComposed>;
-export default WebmcpComposed;
-//# sourceMappingURL=webmcp-composed.child.fixture.svelte.d.ts.map

package/dist/web/__tests__/webmcp-composed.child.fixture.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webmcp-composed.child.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/webmcp-composed.child.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAStE,KAAK,gBAAgB,GAAI;IAAE,mBAAmB,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAoEvE,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/web/__tests__/webmcp-composed.fixture.svelte

@@ -1,52 +0,0 @@
-<script lang="ts">
-import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
-import type {
-  RegisterWebMcpToolsOptions,
-  WebMcpToolDefinition,
-} from '@happyvertical/smrt-web';
-import Provider from '../../Provider.svelte';
-import type { WebMcpProviderConfig } from '../webmcp-provider.js';
-import Child from './webmcp-composed.child.fixture.svelte';
-
-let {
-  dataSurfaceRegistry,
-  generatedDefinitions = [],
-  fetchFn,
-  showChild = true,
-}: {
-  dataSurfaceRegistry: DataSurfaceRegistry;
-  generatedDefinitions?: readonly WebMcpToolDefinition[];
-  fetchFn?: RegisterWebMcpToolsOptions['fetchFn'];
-  showChild?: boolean;
-} = $props();
-
-let cachedDefinitions: readonly WebMcpToolDefinition[] | undefined;
-let cachedFetchFn: RegisterWebMcpToolsOptions['fetchFn'] | undefined;
-let cachedRegistry: DataSurfaceRegistry | undefined;
-let cachedWebmcp: WebMcpProviderConfig | undefined;
-const webmcp = $derived.by(() => {
-  if (
-    cachedWebmcp &&
-    cachedDefinitions === generatedDefinitions &&
-    cachedFetchFn === fetchFn &&
-    cachedRegistry === dataSurfaceRegistry
-  ) {
-    return cachedWebmcp;
-  }
-  cachedDefinitions = generatedDefinitions;
-  cachedFetchFn = fetchFn;
-  cachedRegistry = dataSurfaceRegistry;
-  cachedWebmcp = {
-    definitions: generatedDefinitions,
-    ...(fetchFn ? { fetchFn } : {}),
-    ui: { dataSurfaceRegistry },
-  };
-  return cachedWebmcp;
-});
-</script>
-
-<Provider {webmcp}>
-  {#if showChild}
-    <Child {dataSurfaceRegistry} />
-  {/if}
-</Provider>

package/dist/web/__tests__/webmcp-composed.fixture.svelte.d.ts

@@ -1,12 +0,0 @@
-import type { DataSurfaceRegistry } from '@happyvertical/smrt-ui/data';
-import type { RegisterWebMcpToolsOptions, WebMcpToolDefinition } from '@happyvertical/smrt-web';
-type $$ComponentProps = {
-    dataSurfaceRegistry: DataSurfaceRegistry;
-    generatedDefinitions?: readonly WebMcpToolDefinition[];
-    fetchFn?: RegisterWebMcpToolsOptions['fetchFn'];
-    showChild?: boolean;
-};
-declare const WebmcpComposed: import("svelte").Component<$$ComponentProps, {}, "">;
-type WebmcpComposed = ReturnType<typeof WebmcpComposed>;
-export default WebmcpComposed;
-//# sourceMappingURL=webmcp-composed.fixture.svelte.d.ts.map

package/dist/web/__tests__/webmcp-composed.fixture.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webmcp-composed.fixture.svelte.d.ts","sourceRoot":"","sources":["../../../src/web/__tests__/webmcp-composed.fixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EACV,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAKhC,KAAK,gBAAgB,GAAI;IACxB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,oBAAoB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvD,OAAO,CAAC,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAgDF,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}