@vibesdotdev/applets 0.0.0-stage → 1.0.0-rc.2

package/dist/svelte/components/AppletComposition.svelte

@@ -0,0 +1,128 @@
+<!--
+  The subscriber's view of a composed applet: its slots, and what each one needs.
+
+  COMPOSABLE FIRST, app second. This is a component a host mounts, not a route —
+  so a subscriber surface, an owner page, and a preview can all show the same
+  thing without one of them becoming the definition of "the applet page".
+
+  It renders DECISIONS, not applets. `planAppletComposition` decides whether each
+  declared slot may mount, and this shows the answer: a mounted child, a consent
+  prompt naming that child's own requests, or a stated reason it is unavailable.
+  Rendering a hole for a slot the host could not resolve would make a subscriber
+  see a different applet than the one that was published.
+-->
+<script lang="ts">
+	import type {
+		AppletDefinitionManifest,
+		AppletSlotDecision,
+		ComponentReleaseRef
+	} from '@vibesdotdev/applets';
+	import type { Snippet } from 'svelte';
+
+	interface Props {
+		/**
+		 * Per-slot decisions from `planAppletComposition`.
+		 *
+		 * Defaulted, because a component that throws when mounted with no props is
+		 * a component nobody can photograph — and the first real screenshot of this
+		 * one was blank, which is exactly how that gets noticed.
+		 */
+		slots?: readonly AppletSlotDecision[];
+		/**
+		 * Render one mountable child. The host owns how an applet is mounted.
+		 * Optional so this composes in a preview that has no mounting machinery.
+		 */
+		child?: Snippet<
+			[{ slot: string; release: ComponentReleaseRef; manifest: AppletDefinitionManifest | null }]
+		>;
+		/** Invoked when a viewer asks to approve a child's own capabilities. */
+		/** Called with the SLOT being approved — the token every route names it by. */
+		onRequestConsent?: (slot: string) => void;
+	}
+
+	let { slots = [], child, onRequestConsent }: Props = $props();
+</script>
+
+<div class="applet-composition" data-testid="applet-composition">
+	{#if slots.length === 0}
+		<!-- An applet that composes nothing is ordinary. Saying so beats a blank
+		     region a reader has to interpret. -->
+		<p class="muted" data-testid="composition-empty">This applet composes no other applets.</p>
+	{/if}
+	{#each slots as decision (decision.slot)}
+		<section class="slot" data-slot={decision.slot} data-status={decision.status}>
+			{#if decision.status === 'mount'}
+				{#if child}
+					{@render child({
+						slot: decision.slot,
+						release: decision.release,
+						// `null` when the release was never published, so nothing declares
+						// its stores. A host must be able to tell rather than binding a
+						// surface to a document that does not exist.
+						manifest: decision.manifest
+					})}
+				{:else}
+					<div class="notice" data-testid="slot-mountable">
+						<p>Ready to mount: <code>{decision.slot}</code></p>
+					</div>
+				{/if}
+			{:else if decision.status === 'needs-consent'}
+				<div class="notice" data-testid="slot-needs-consent">
+					<p>
+						This part of the applet is a separate release and needs your approval before it can
+						run.
+					</p>
+					{#if decision.capabilities.length > 0}
+						<!-- The CHILD's requests. Showing the parent's would let a viewer
+						     approve one set of capabilities and receive another. -->
+						<ul>
+							{#each decision.capabilities as capability (capability)}
+								<li>{capability}</li>
+							{/each}
+						</ul>
+					{:else}
+						<p class="muted">It requests no capabilities.</p>
+					{/if}
+					{#if onRequestConsent}
+						<button type="button" onclick={() => onRequestConsent?.(decision.slot)}>
+							Review this part
+						</button>
+					{/if}
+				</div>
+			{:else}
+				<div class="notice" data-testid="slot-unavailable">
+					<p>
+						{decision.reason === 'unresolvable'
+							? 'This part could not be resolved, so it is not shown.'
+							: decision.reason === 'not-attempted'
+								? 'This applet composes more parts than are shown here.'
+								: 'This part refers to the applet itself and cannot be shown.'}
+					</p>
+				</div>
+			{/if}
+		</section>
+	{/each}
+</div>
+
+<style>
+	.applet-composition {
+		display: grid;
+		gap: 0.75rem;
+	}
+
+	.notice {
+		border: 1px solid color-mix(in srgb, currentColor 20%, transparent);
+		border-radius: 0.5rem;
+		padding: 0.75rem 1rem;
+		font-size: 0.875rem;
+	}
+
+	.muted {
+		opacity: 0.7;
+	}
+
+	ul {
+		margin: 0.5rem 0 0.75rem;
+		padding-left: 1.25rem;
+	}
+</style>

package/dist/svelte/components/AppletComposition.svelte.d.ts

@@ -0,0 +1,30 @@
+import type { AppletDefinitionManifest, AppletSlotDecision, ComponentReleaseRef } from '@vibesdotdev/applets';
+import type { Snippet } from 'svelte';
+interface Props {
+    /**
+     * Per-slot decisions from `planAppletComposition`.
+     *
+     * Defaulted, because a component that throws when mounted with no props is
+     * a component nobody can photograph — and the first real screenshot of this
+     * one was blank, which is exactly how that gets noticed.
+     */
+    slots?: readonly AppletSlotDecision[];
+    /**
+     * Render one mountable child. The host owns how an applet is mounted.
+     * Optional so this composes in a preview that has no mounting machinery.
+     */
+    child?: Snippet<[
+        {
+            slot: string;
+            release: ComponentReleaseRef;
+            manifest: AppletDefinitionManifest | null;
+        }
+    ]>;
+    /** Invoked when a viewer asks to approve a child's own capabilities. */
+    /** Called with the SLOT being approved — the token every route names it by. */
+    onRequestConsent?: (slot: string) => void;
+}
+declare const AppletComposition: import("svelte").Component<Props, {}, "">;
+type AppletComposition = ReturnType<typeof AppletComposition>;
+export default AppletComposition;
+//# sourceMappingURL=AppletComposition.svelte.d.ts.map

package/dist/svelte/components/AppletComposition.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppletComposition.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AppletComposition.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,sBAAsB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGrC,UAAU,KAAK;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CACd;QAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,mBAAmB,CAAC;YAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAAA;SAAE;KAAC,CAC3F,CAAC;IACF,wEAAwE;IACxE,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAyEF,QAAA,MAAM,iBAAiB,2CAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/svelte/components/AppletConsent.svelte

@@ -0,0 +1,143 @@
+<script lang="ts">
+	import type { ComponentReleaseRef, AppletCapabilityGrant } from '@vibesdotdev/applets';
+	import { reviewCapabilities, type CapabilityRequest } from '../lib/capability-review.js';
+
+	interface Props {
+		release: ComponentReleaseRef;
+		capabilities: string[];
+		capabilityReasons?: Record<string, string>;
+		onApprove: () => void;
+		onReject: () => void;
+	}
+
+	let { release, capabilities, capabilityReasons = {}, onApprove, onReject }: Props = $props();
+
+	const requestedCapabilities = $derived(
+		capabilities.map((tag) => ({
+			tag,
+			reason: capabilityReasons[tag]
+		}))
+	);
+
+	const grantedCapabilities = $derived(
+		capabilities.map((tag) => ({
+			tag,
+			reason: capabilityReasons[tag] ?? 'Approved by user'
+		}))
+	);
+
+	const review = $derived(reviewCapabilities(requestedCapabilities, grantedCapabilities));
+</script>
+
+<div class="applet-consent" data-testid="applet-consent">
+	<div class="consent-header">
+		<h2>Review applet capabilities</h2>
+		<p class="release-info">
+			Component: <code>{release.componentId}</code><br />
+			Version: <code>{release.version}</code><br />
+			Bundle: <code>{release.bundleHash.slice(0, 12)}...</code>
+		</p>
+	</div>
+
+	{#if capabilities.length === 0}
+		<p class="no-capabilities">This applet requests no capabilities.</p>
+	{:else}
+		<ul class="capability-list" data-testid="capability-list">
+			{#each capabilities as tag (tag)}
+				<li class="capability-item" data-capability={tag}>
+					<span class="capability-tag">{tag}</span>
+					{#if capabilityReasons[tag]}
+						<span class="capability-reason">{capabilityReasons[tag]}</span>
+					{/if}
+				</li>
+			{/each}
+		</ul>
+	{/if}
+
+	<div class="consent-actions">
+		<button class="reject" data-action="reject" onclick={onReject}>Reject</button>
+		<button class="approve" data-action="approve" onclick={onApprove}>Approve and run</button>
+	</div>
+</div>
+
+<style>
+	.applet-consent {
+		display: flex;
+		flex-direction: column;
+		gap: 1rem;
+		padding: 1.5rem;
+		border: 1px solid var(--applet-border, #e2e8f0);
+		border-radius: 0.5rem;
+		background: var(--applet-bg, #fff);
+		max-width: 32rem;
+	}
+
+	.consent-header h2 {
+		margin: 0 0 0.5rem;
+		font-size: 1.125rem;
+		font-weight: 600;
+	}
+
+	.release-info {
+		font-size: 0.875rem;
+		color: var(--applet-muted, #64748b);
+		line-height: 1.5;
+	}
+
+	.release-info code {
+		font-family: monospace;
+		font-size: 0.75rem;
+	}
+
+	.capability-list {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+		display: flex;
+		flex-direction: column;
+		gap: 0.5rem;
+	}
+
+	.capability-item {
+		display: flex;
+		flex-direction: column;
+		gap: 0.25rem;
+		padding: 0.5rem;
+		border: 1px solid var(--applet-border, #e2e8f0);
+		border-radius: 0.25rem;
+	}
+
+	.capability-tag {
+		font-weight: 500;
+		font-size: 0.875rem;
+	}
+
+	.capability-reason {
+		font-size: 0.75rem;
+		color: var(--applet-muted, #64748b);
+	}
+
+	.consent-actions {
+		display: flex;
+		gap: 0.5rem;
+		justify-content: flex-end;
+	}
+
+	.consent-actions button {
+		padding: 0.5rem 1rem;
+		border-radius: 0.25rem;
+		border: 1px solid var(--applet-border, #e2e8f0);
+		cursor: pointer;
+		font-size: 0.875rem;
+	}
+
+	.approve {
+		background: var(--applet-primary, #0f172a);
+		color: white;
+		border-color: var(--applet-primary, #0f172a);
+	}
+
+	.reject {
+		background: transparent;
+	}
+</style>

package/dist/svelte/components/AppletConsent.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { ComponentReleaseRef } from '@vibesdotdev/applets';
+interface Props {
+    release: ComponentReleaseRef;
+    capabilities: string[];
+    capabilityReasons?: Record<string, string>;
+    onApprove: () => void;
+    onReject: () => void;
+}
+declare const AppletConsent: import("svelte").Component<Props, {}, "">;
+type AppletConsent = ReturnType<typeof AppletConsent>;
+export default AppletConsent;
+//# sourceMappingURL=AppletConsent.svelte.d.ts.map

package/dist/svelte/components/AppletConsent.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppletConsent.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/AppletConsent.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,sBAAsB,CAAC;AAItF,UAAU,KAAK;IACd,OAAO,EAAE,mBAAmB,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACrB;AA4DF,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/svelte/components/LocalAppletView.svelte

@@ -0,0 +1,102 @@
+<script lang="ts">
+	import { untrack } from 'svelte';
+	import { settle, CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+	import { Button } from '@vibesdotdev/kit/components/ui/button';
+	import { Alert, AlertTitle, AlertDescription } from '@vibesdotdev/kit/components/ui/alert';
+	import { Spinner } from '@vibesdotdev/kit/components/ui/spinner';
+	import { ManifestForm } from '@vibesdotdev/kit/forms';
+	import * as Collapsible from '@vibesdotdev/kit/components/ui/collapsible';
+	import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte/state';
+	import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+	import { connectServedAppletSurface } from '../../cli/commands/served-applet-connection.js';
+	import type { AppletComponentLoader, AppletRoute, AppletViewDefinition } from '../../presentation.js';
+
+	interface Props {
+		definition: AppletViewDefinition;
+		loadComponent: AppletComponentLoader;
+		input: JsonObject;
+		route: AppletRoute;
+		onConfigure: (input: JsonObject) => void | Promise<void>;
+	}
+	let { definition, loadComponent, input, route, onConfigure }: Props = $props();
+	const runtimeStore = getRuntimeSvelteContext();
+	let attempt = $state(0);
+	let pending = $state.raw<Promise<{
+		Component: Awaited<ReturnType<AppletComponentLoader>>;
+		connection: Awaited<ReturnType<typeof connectServedAppletSurface>>;
+	}> | null>(null);
+	let connectionFailure = $state.raw<CapabilityError | null>(null);
+	const request = $derived({ id: definition.id, load: loadComponent, attempt });
+
+	$effect(() => {
+		const { id, load } = request;
+		let disposed = false;
+		let connection: Awaited<ReturnType<typeof connectServedAppletSurface>> | undefined;
+		connectionFailure = null;
+		pending = untrack(async () => {
+			const Component = await load();
+			const runtime = await runtimeStore.load();
+			if (disposed) throw new Error('Applet navigation was cancelled.');
+			connection = await connectServedAppletSurface({
+				projectId: id, origin: window.location.origin, lifecycle: runtime.lifecycle,
+				fetch: window.fetch.bind(window), pathPrefix: `/${encodeURIComponent(id)}`
+			});
+			if (disposed) {
+				await connection.close();
+				throw new Error('Applet navigation was cancelled.');
+			}
+			void connection.closed.then(() => {
+				if (!disposed) connectionFailure = new CapabilityError('The applet runtime connection closed.', 'UNAVAILABLE', {
+					reason: 'applet-host-connection-closed', retryable: true
+				});
+			});
+			return { Component, connection };
+		});
+		return () => {
+			disposed = true;
+			void settle(async () => connection?.close()).then(outcome => {
+				if (!outcome.ok) connectionFailure = CapabilityError.from(CaughtFailureSchema.parse(outcome.cause));
+			});
+		};
+	});
+</script>
+
+<section class="flex min-h-0 flex-1 flex-col bg-background text-foreground" aria-label={definition.title}>
+	{#if definition.shell === 'standard'}
+		<header class="flex flex-wrap items-center justify-between gap-3 border-b px-6 py-4">
+			<div class="min-w-0 space-y-1">
+				<Button href="/applets" variant="link" size="sm" class="h-auto p-0">All applets</Button>
+				<h1 class="text-lg font-semibold">{definition.title}</h1>
+				{#if definition.description}<p class="text-sm text-muted-foreground">{definition.description}</p>{/if}
+			</div>
+		</header>
+	{/if}
+	{#if definition.inputs}
+		<Collapsible.Root class="border-b px-6 py-3">
+			<Collapsible.Trigger class="text-sm font-medium underline-offset-4 hover:underline">Configure inputs</Collapsible.Trigger>
+			<Collapsible.Content class="pt-4">
+				<ManifestForm manifest={definition.inputs} initialValues={input} submitLabel="Apply inputs" cardLayout={false}
+					onSubmit={values => onConfigure(definition.inputs!.schema.parse(values))} />
+			</Collapsible.Content>
+		</Collapsible.Root>
+	{/if}
+	{#if connectionFailure}
+		<Alert variant="destructive" class="m-6 w-auto">
+			<AlertTitle>Runtime connection closed</AlertTitle>
+			<AlertDescription>{connectionFailure.message}</AlertDescription>
+			<Button variant="outline" class="mt-3" onclick={() => attempt++}>Reconnect</Button>
+		</Alert>
+	{:else if pending}
+		{#await pending}
+			<div role="status" class="flex min-h-48 items-center justify-center gap-3 text-sm text-muted-foreground"><Spinner class="size-4" />Opening {definition.title}…</div>
+		{:then opened}
+			<opened.Component vibes={opened.connection.surface} {input} {route} />
+		{:catch cause}
+			<Alert variant="destructive" class="m-6 w-auto">
+				<AlertTitle>Could not open {definition.title}</AlertTitle>
+				<AlertDescription>{CapabilityError.from(CaughtFailureSchema.parse(cause)).message}</AlertDescription>
+				<Button variant="outline" class="mt-3" onclick={() => attempt++}>Try again</Button>
+			</Alert>
+		{/await}
+	{/if}
+</section>

package/dist/svelte/components/LocalAppletView.svelte.d.ts

@@ -0,0 +1,13 @@
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+import type { AppletComponentLoader, AppletRoute, AppletViewDefinition } from '../../presentation.ts';
+interface Props {
+    definition: AppletViewDefinition;
+    loadComponent: AppletComponentLoader;
+    input: JsonObject;
+    route: AppletRoute;
+    onConfigure: (input: JsonObject) => void | Promise<void>;
+}
+declare const LocalAppletView: import("svelte").Component<Props, {}, "">;
+type LocalAppletView = ReturnType<typeof LocalAppletView>;
+export default LocalAppletView;
+//# sourceMappingURL=LocalAppletView.svelte.d.ts.map

package/dist/svelte/components/LocalAppletView.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalAppletView.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/LocalAppletView.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGrG,UAAU,KAAK;IACd,UAAU,EAAE,oBAAoB,CAAC;IACjC,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAkGF,QAAA,MAAM,eAAe,2CAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/svelte/components/RunnableTracker.svelte

@@ -0,0 +1,51 @@
+<script lang="ts">
+	import { untrack, type Snippet } from 'svelte';
+	import { CapabilityError, CaughtFailureSchema, settle } from '@vibesdotdev/kernel';
+	import { Alert, AlertTitle, AlertDescription } from '@vibesdotdev/kit/components/ui/alert';
+	import { RunFeedbackPanel, RunFeedbackInbox, RunLogThread } from '@vibesdotdev/tools/svelte/tool-widgets';
+	import { Spinner } from '@vibesdotdev/kit/components/ui/spinner';
+	import { RunsStore, RunsView } from '@vibesdotdev/runnable/svelte';
+	import type { RunnableReadQuery, RunnableSnapshot } from '@vibesdotdev/runnable';
+	import type { AppletRootSurface } from '../../applet-root-surface.js';
+	import { appletRunsSource } from '../runnable-source.js';
+
+	let { vibes, title, query = {}, projection = 'records', sections, overview, issues, origin }: {
+		vibes?: AppletRootSurface;
+		title?: string;
+		query?: RunnableReadQuery;
+		projection?: 'catalog' | 'records';
+		sections?: Snippet<[RunnableSnapshot, RunsStore | undefined]>;
+		overview?: Snippet<[RunsStore]>;
+		issues?: Snippet<[RunsStore, (id: string) => void, () => void]>;
+		origin?: string;
+	} = $props();
+	const store = $derived(vibes ? new RunsStore(appletRunsSource(vibes), query, projection) : null);
+	let connectionFailure = $state.raw<CapabilityError | null>(null);
+	async function observe(work: () => Promise<void>) {
+		const outcome = await settle(work);
+		if (!outcome.ok) connectionFailure = CapabilityError.from(CaughtFailureSchema.parse(outcome.cause));
+	}
+
+	$effect(() => {
+		const current = store;
+		if (!current) return;
+		untrack(() => { void observe(() => current.open()); });
+		return () => {
+			void observe(() => current.close());
+		};
+	});
+</script>
+
+{#if connectionFailure}<div class="bg-background p-4 text-foreground"><Alert variant="destructive"><AlertTitle>Subscription failed</AlertTitle><AlertDescription>{connectionFailure.message}</AlertDescription></Alert></div>{/if}
+{#snippet requests(snapshot: RunnableSnapshot, current: RunsStore | undefined)}
+	{#if current}<RunFeedbackPanel {snapshot} source={current.source} />{/if}
+{/snippet}
+{#snippet thread(snapshot: RunnableSnapshot, focusedIndex: number | null)}
+	<RunLogThread logs={snapshot.logs} {focusedIndex} />
+{/snippet}
+{#snippet trackerOverview(current: RunsStore)}
+	<RunFeedbackInbox runs={current.listRows.map(row => row.run)} loading={current.revision === null} source={current.source} onselect={id => { void observe(() => current.select(id)); }} />
+	{@render overview?.(current)}
+{/snippet}
+{#if store}<RunsView {store} {title} {sections} {issues} overview={trackerOverview} {origin} {requests} {thread} />
+{:else}<div role="status" class="flex min-h-48 items-center justify-center gap-3 bg-background p-6 text-sm text-muted-foreground"><Spinner class="size-4" />Waiting for the host runtime connection.</div>{/if}

package/dist/svelte/components/RunnableTracker.svelte.d.ts

@@ -0,0 +1,18 @@
+import { type Snippet } from 'svelte';
+import { RunsStore } from '@vibesdotdev/runnable/svelte';
+import type { RunnableReadQuery, RunnableSnapshot } from '@vibesdotdev/runnable';
+import type { AppletRootSurface } from '../../applet-root-surface.ts';
+type $$ComponentProps = {
+    vibes?: AppletRootSurface;
+    title?: string;
+    query?: RunnableReadQuery;
+    projection?: 'catalog' | 'records';
+    sections?: Snippet<[RunnableSnapshot, RunsStore | undefined]>;
+    overview?: Snippet<[RunsStore]>;
+    issues?: Snippet<[RunsStore, (id: string) => void, () => void]>;
+    origin?: string;
+};
+declare const RunnableTracker: import("svelte").Component<$$ComponentProps, {}, "">;
+type RunnableTracker = ReturnType<typeof RunnableTracker>;
+export default RunnableTracker;
+//# sourceMappingURL=RunnableTracker.svelte.d.ts.map

package/dist/svelte/components/RunnableTracker.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunnableTracker.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/RunnableTracker.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAK/C,OAAO,EAAE,SAAS,EAAY,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,KAAK,gBAAgB,GAAI;IACxB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA8CH,QAAA,MAAM,eAAe,sDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,11 @@
+export { default as AppletCanvas } from './components/AppletCanvas.svelte';
+export { default as AppletComposition } from './components/AppletComposition.svelte';
+export { default as AppletConsent } from './components/AppletConsent.svelte';
+export { default as RunnableTracker } from './components/RunnableTracker.svelte';
+export { default as AppletCatalog } from './components/AppletCatalog.svelte';
+export { default as LocalAppletView } from './components/LocalAppletView.svelte';
+export { createCanvasState, type CanvasStateStore } from './state.svelte.ts';
+export * from './lib/canvas-lifecycle.ts';
+export * from './lib/capability-review.ts';
+export * from './lib/message-protocol.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,10 @@
+export { default as AppletCanvas } from './components/AppletCanvas.svelte';
+export { default as AppletComposition } from './components/AppletComposition.svelte';
+export { default as AppletConsent } from './components/AppletConsent.svelte';
+export { default as RunnableTracker } from './components/RunnableTracker.svelte';
+export { default as AppletCatalog } from './components/AppletCatalog.svelte';
+export { default as LocalAppletView } from './components/LocalAppletView.svelte';
+export { createCanvasState } from "./state.svelte.js";
+export * from "./lib/canvas-lifecycle.js";
+export * from "./lib/capability-review.js";
+export * from "./lib/message-protocol.js";

package/dist/svelte/lib/canvas-lifecycle.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Applet canvas lifecycle — pure state machine, no Svelte reactivity.
+ *
+ * The canvas transitions through these states:
+ *
+ *   loading → ready → approved → mounted → (running | crashed | unresponsive)
+ *                ↑                                  ↓
+ *                ←←← revoked / expired / disposed ←←←
+ *
+ * CRITICAL INVARIANT: no bundle URL, modulepreload, or runner document
+ * may enter the DOM before the `approved` state. The `loading` and `ready`
+ * states carry ONLY inert release metadata (digest, version, capabilities).
+ */
+export type CanvasState = 'loading' | 'ready' | 'approved' | 'mounted' | 'running' | 'crashed' | 'unresponsive' | 'revoked' | 'expired' | 'disposed';
+export interface CanvasContext {
+    state: CanvasState;
+    /** True when consent has been granted by the user. */
+    consented: boolean;
+    /** True when the runner frame has been mounted into the DOM. */
+    runnerMounted: boolean;
+    /** Monotonic heartbeat counter — 0 means no heartbeat yet. */
+    heartbeatCount: number;
+    /** Last error message, set when state is `crashed`. */
+    error: string | null;
+}
+export declare function createCanvasContext(): CanvasContext;
+/** Transition to `ready` — metadata loaded, awaiting consent. */
+export declare function transitionToReady(ctx: CanvasContext): CanvasContext;
+/** Transition to `approved` — consent granted, may now mount the runner. */
+export declare function transitionToApproved(ctx: CanvasContext): CanvasContext;
+/** Transition to `mounted` — runner frame is in the DOM. */
+export declare function transitionToMounted(ctx: CanvasContext): CanvasContext;
+/** Transition to `running` — runner handshake completed. */
+export declare function transitionToRunning(ctx: CanvasContext): CanvasContext;
+/** Record a heartbeat from the runner. */
+export declare function recordHeartbeat(ctx: CanvasContext): CanvasContext;
+/** Transition to `crashed` — runner reported an error. */
+export declare function transitionToCrashed(ctx: CanvasContext, error: string): CanvasContext;
+/** Transition to `unresponsive` — heartbeat timeout. */
+export declare function transitionToUnresponsive(ctx: CanvasContext): CanvasContext;
+/** Transition to `revoked` — capabilities revoked by user. */
+export declare function transitionToRevoked(ctx: CanvasContext): CanvasContext;
+/** Transition to `expired` — launch lease expired. */
+export declare function transitionToExpired(ctx: CanvasContext): CanvasContext;
+/** Transition to `disposed` — runner destroyed, ports closed. */
+export declare function transitionToDisposed(ctx: CanvasContext): CanvasContext;
+/**
+ * Returns true if the current state permits mounting the runner.
+ * Only `approved` permits mounting — never `loading`, `ready`, `running`,
+ * `crashed`, etc.
+ */
+export declare function canMountRunner(ctx: CanvasContext): boolean;
+/**
+ * Returns true if the current state permits fetching the bundle bytes.
+ * Only `approved` (after consent) permits fetching — never `loading` or
+ * `ready`. This is the network assertion: zero bundle requests before
+ * consent.
+ */
+export declare function canFetchBundle(ctx: CanvasContext): boolean;
+/**
+ * Returns true if the current state is terminal (no further transitions).
+ */
+export declare function isTerminal(ctx: CanvasContext): boolean;
+/**
+ * Returns true if the current state is an error state.
+ */
+export declare function isErrorState(ctx: CanvasContext): boolean;
+//# sourceMappingURL=canvas-lifecycle.d.ts.map

package/dist/svelte/lib/canvas-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/svelte/lib/canvas-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,WAAW,GACpB,SAAS,GACT,OAAO,GACP,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,GACT,cAAc,GACd,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEd,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAGnE;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAGtE;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAGrE;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAGrE;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAEjE;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAEpF;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAE1E;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAErE;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAErE;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAExD"}