@selvajs/ui 6.3.2 → 6.4.1

package/src/lib/components/compute/SolveMessages.svelte

@@ -0,0 +1,367 @@
+<script lang="ts">
+	// The one place a solve talks to the user.
+	//
+	// Only a Selva Message component interrupts: the author wrote that text for whoever is using
+	// the app. Grasshopper's own warnings are about the definition, not the result, and go to the
+	// footer log instead — interrupting for them trains people to dismiss the one that mattered.
+	//
+	// While the solve runs the panel is fed by live events (messages and progress) and offers
+	// Abort. When it ends the reported result replaces them outright — it lists the same messages,
+	// remarks included — so nothing is ever shown twice.
+	//
+	// Of those, only warnings and errors get buttons. A remark states something without asking
+	// anything, so it appears on its own after the solve and fades.
+
+	import { untrack } from 'svelte';
+	import { CircleAlert, TriangleAlert, Info, LoaderCircle } from '@lucide/svelte';
+	import type { SolveDiagnostic } from '@selvajs/solve/shared';
+	import type { LiveSolveState, SolvePhase } from '@selvajs/solve/client';
+	import { Button } from '$lib/components/primitives/button';
+
+	interface Props {
+		/** What the running (or most recent) solve has said over the live channel. */
+		live: LiveSolveState;
+		/** The session's phase: `solving`, `review` (result held), `blocked` or `idle`. */
+		phase: SolvePhase;
+		/** The last result's messages, with level, source and `isGate`. */
+		diagnostics?: SolveDiagnostic[];
+		onabort: () => void;
+		onconfirm: () => void;
+		ondiscard: () => void;
+		labels?: Labels;
+	}
+
+	interface Labels {
+		solving: string;
+		blockedTitle: string;
+		messagesTitle: string;
+		blockedDescription: string;
+		messagesDescription: string;
+		confirm: string;
+		discard: string;
+		abort: string;
+		dismiss: string;
+	}
+
+	const DEFAULT_LABELS: Labels = {
+		solving: 'Solving…',
+		blockedTitle: 'Solve stopped',
+		messagesTitle: 'Solve messages',
+		blockedDescription: 'The definition stopped this solve. No results were produced.',
+		messagesDescription: 'This solve reported the following. Continue to see the result.',
+		confirm: 'Continue',
+		discard: 'Discard',
+		abort: 'Abort',
+		dismiss: 'Dismiss'
+	};
+
+	let {
+		live,
+		phase: sessionPhase,
+		diagnostics = [],
+		onabort,
+		onconfirm,
+		ondiscard,
+		labels = DEFAULT_LABELS
+	}: Props = $props();
+
+	const REMARK_LINGER_MS = 6000;
+
+	const progress = $derived([...live.progress.values()]);
+
+	// A report only arrives when a step starts, so a bar that just shows `fraction` stands still
+	// through the step and then jumps. When the plugin knows how long the step took last time, the
+	// bar runs linearly to where the step will end, over that time. Steps are weighted by time, so
+	// linear gives one steady speed across the solve; any easing curve visibly speeds up and
+	// crawls within each step. A slower run waits at the step's end; a faster one snaps ahead.
+	let bars = $state.raw<Record<string, { width: number; ms: number }>>({});
+	// Any live event re-runs the effect below. Only a source with a new report may re-snap;
+	// the rest keep easing where they are.
+	let seen = new Map<string, unknown>();
+	let targets: Record<string, { width: number; ms: number }> = {};
+	$effect(() => {
+		const snapped: Record<string, { width: number; ms: number }> = {};
+		const eased: Record<string, { width: number; ms: number }> = {};
+		const current = untrack(() => bars);
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- bookkeeping for this effect; reactive reads here would re-trigger it
+		const nextSeen = new Map<string, unknown>();
+		for (const p of progress) {
+			if (p.fraction === undefined) continue;
+			const key = p.source ?? '';
+			nextSeen.set(key, p);
+			if (seen.get(key) === p && current[key]) {
+				snapped[key] = current[key];
+				// This run's cleanup cancelled the frame that would have started the ease.
+				if (targets[key] && current[key] !== targets[key]) eased[key] = targets[key];
+				continue;
+			}
+			snapped[key] = { width: p.fraction, ms: 150 };
+			if (p.nextFraction !== undefined && p.stepMs !== undefined) {
+				eased[key] = { width: p.nextFraction, ms: p.stepMs };
+			}
+		}
+		seen = nextSeen;
+		targets = eased;
+		bars = snapped;
+		if (Object.keys(eased).length === 0) return;
+		// Two frames: the snapped width must be painted before the eased one is set, or the
+		// browser folds both into one style change and there is nothing to transition from.
+		let frame = requestAnimationFrame(() => {
+			frame = requestAnimationFrame(() => (bars = { ...snapped, ...eased }));
+		});
+		return () => cancelAnimationFrame(frame);
+	});
+	// Grasshopper's own complaints stay in the footer log; this panel shows what the author wrote.
+	const authored = $derived(diagnostics.filter((d) => d.isGate));
+
+	// A remark states something without asking anything, so it never belongs next to
+	// Discard/Continue — the buttons would imply it is part of what the user is deciding. It gets
+	// the quiet treatment instead: shown alone after the solve, then faded.
+	const authoredGating = $derived(authored.filter((d) => d.level !== 'remark'));
+	const authoredRemarks = $derived(authored.filter((d) => d.level === 'remark'));
+
+	let dismissedFor = $state.raw<SolveDiagnostic[] | null>(null);
+
+	// The session's phase, except that a blocked solve the user dismissed reads as idle here.
+	type Phase = 'live' | 'review' | 'blocked' | 'idle';
+	const phase = $derived<Phase>(
+		sessionPhase === 'solving'
+			? 'live'
+			: sessionPhase === 'blocked' && dismissedFor === diagnostics
+				? 'idle'
+				: sessionPhase
+	);
+
+	// Remarks gate nothing, so after the solve they show briefly and fade.
+	//
+	// Keyed on the diagnostics array's identity, which every report renews, rather than on a
+	// solve id: only the live channel has one, and on the Compute path remarks arrive with the
+	// result. Once per array, so remarks that sat behind a review do not reappear after Continue.
+	let lingering = $state(false);
+	let lingeredFor: SolveDiagnostic[] | null = null;
+	$effect(() => {
+		if (phase === 'live') {
+			lingering = false;
+			return;
+		}
+		if (authoredRemarks.length === 0 || lingeredFor === diagnostics) return;
+		lingeredFor = diagnostics;
+		if (phase !== 'idle') return;
+		lingering = true;
+		const timer = setTimeout(() => (lingering = false), REMARK_LINGER_MS);
+		return () => clearTimeout(timer);
+	});
+
+	// A solve that finishes quickly never shows the live panel: flashing it for 50 ms reads as a
+	// glitch, not as progress. Once shown, it stays long enough to read and ends on a full bar
+	// ("finishing"), so a solve just past the reveal does not blink the panel away mid-bar. A
+	// result that needs an answer (review, blocked) replaces it at once instead.
+	const LIVE_REVEAL_MS = 300;
+	const LIVE_MIN_VISIBLE_MS = 400;
+	const FINISH_MS = 200;
+	let revealed = $state(false);
+	let finishing = $state(false);
+	let revealedAt = 0;
+	$effect(() => {
+		if (phase === 'live') {
+			finishing = false;
+			const timer = setTimeout(() => {
+				revealed = true;
+				revealedAt = performance.now();
+			}, LIVE_REVEAL_MS);
+			return () => clearTimeout(timer);
+		}
+		if (!untrack(() => revealed) || phase !== 'idle') {
+			revealed = false;
+			finishing = false;
+			return;
+		}
+		finishing = true;
+		const hold = Math.max(FINISH_MS, LIVE_MIN_VISIBLE_MS - (performance.now() - revealedAt));
+		const timer = setTimeout(() => {
+			revealed = false;
+			finishing = false;
+		}, hold);
+		return () => clearTimeout(timer);
+	});
+
+	// What the panel is showing, which lags the session while a finished solve's panel winds down.
+	const view = $derived<Phase>(finishing ? 'live' : phase);
+
+	// While solving, the live channel is all there is. Once the result lands it is authoritative
+	// — it carries remarks too — so the live list is dropped entirely and nothing is shown twice.
+	const rows = $derived<SolveDiagnostic[]>(
+		view === 'live' ? [...live.diagnostics] : view === 'idle' ? authoredRemarks : authoredGating
+	);
+
+	// Steps a few milliseconds long would swap the headline faster than it can be read. Each one
+	// stays up for at least this long; steps that end sooner are skipped in the label but still
+	// count in the bar. The label and its step count move together so they never disagree.
+	const HEADLINE_MIN_MS = 200;
+	let headline = $state.raw<(typeof progress)[number] | undefined>(undefined);
+	let headlineAt = 0;
+	$effect(() => {
+		const next = progress[0];
+		const shown = untrack(() => headline);
+		if (next?.label === shown?.label && next?.done === shown?.done) {
+			headline = next;
+			return;
+		}
+		const show = () => {
+			headline = next;
+			headlineAt = performance.now();
+		};
+		const wait = HEADLINE_MIN_MS - (performance.now() - headlineAt);
+		if (!shown || wait <= 0) {
+			show();
+			return;
+		}
+		const timer = setTimeout(show, wait);
+		return () => clearTimeout(timer);
+	});
+
+	const visible = $derived(
+		view === 'review' || view === 'blocked'
+			? true
+			: view === 'live'
+				? revealed && (rows.length > 0 || progress.length > 0)
+				: rows.length > 0 && lingering
+	);
+
+	function dismiss() {
+		dismissedFor = diagnostics;
+	}
+
+	// Escape resolves to the safe side — discard, keeping what is on screen — never to silently
+	// applying a result the user has not accepted.
+	function handleKeydown(e: KeyboardEvent) {
+		if (e.key !== 'Escape') return;
+		if (phase === 'review') ondiscard();
+		else if (phase === 'blocked') dismiss();
+	}
+</script>
+
+<svelte:window onkeydown={handleKeydown} />
+
+{#if visible}
+	<div
+		class="bottom-4 p-3 shadow-lg fixed left-1/2 z-50 w-[min(32rem,calc(100vw-2rem))] -translate-x-1/2 rounded-lg border bg-background {view ===
+		'blocked'
+			? 'border-destructive/50'
+			: ''}"
+		role={view === 'live' || view === 'idle' ? 'status' : 'alert'}
+		data-testid="solve-messages"
+		data-view={view}
+	>
+		{#if view === 'live'}
+			{@const head = headline ?? progress[0]}
+			<div>
+				<div>
+					<div class="gap-2 flex items-center">
+						<LoaderCircle class="h-4 w-4 animate-spin shrink-0 text-muted-foreground" />
+						<span class="min-w-0 text-sm flex-1 truncate">{head?.label ?? labels.solving}</span>
+						{#if head?.done !== undefined && head?.total !== undefined}
+							<span class="text-xs shrink-0 text-muted-foreground tabular-nums">
+								{head.done} / {head.total}
+							</span>
+						{/if}
+						<Button
+							variant="secondary"
+							size="sm"
+							class="-my-1 h-7 px-3 text-xs shrink-0"
+							disabled={finishing}
+							onclick={onabort}
+						>
+							{labels.abort}
+						</Button>
+					</div>
+					{#each progress as p, i (p.source ?? '')}
+						<div class="mt-2" data-testid="solve-progress">
+							<!-- The first bar's label is the headline above; further bars label themselves. -->
+							{#if i > 0}
+								<div class="mb-1 gap-2 text-xs flex justify-between text-muted-foreground">
+									<span class="truncate">{p.label ?? p.source ?? ''}</span>
+									{#if p.done !== undefined && p.total !== undefined}
+										<span class="shrink-0 tabular-nums">{p.done} / {p.total}</span>
+									{/if}
+								</div>
+							{/if}
+							<div
+								class="h-1 overflow-hidden rounded-full bg-muted"
+								role="progressbar"
+								aria-label={p.label ?? p.source ?? labels.solving}
+								aria-valuemin={0}
+								aria-valuemax={100}
+								aria-valuenow={p.fraction !== undefined ? Math.round(p.fraction * 100) : undefined}
+							>
+								{#if p.fraction !== undefined}
+									{@const bar = finishing
+										? { width: 1, ms: FINISH_MS }
+										: (bars[p.source ?? ''] ?? { width: p.fraction, ms: 150 })}
+									<div
+										class="h-full rounded-full bg-primary transition-[width] ease-linear"
+										style="width: {bar.width * 100}%; transition-duration: {bar.ms}ms"
+									></div>
+								{:else}
+									<div class="animate-pulse h-full w-1/3 rounded-full bg-primary/60"></div>
+								{/if}
+							</div>
+						</div>
+					{/each}
+				</div>
+			</div>
+		{:else if view === 'review' || view === 'blocked'}
+			<div class="mb-2">
+				<div class="gap-2 text-sm font-medium flex items-center">
+					{#if view === 'blocked'}
+						<CircleAlert class="h-4 w-4 shrink-0 text-destructive" />
+						{labels.blockedTitle}
+					{:else}
+						<TriangleAlert class="h-4 w-4 text-amber-500 shrink-0" />
+						{labels.messagesTitle}
+					{/if}
+				</div>
+				<p class="text-xs text-muted-foreground">
+					{view === 'blocked' ? labels.blockedDescription : labels.messagesDescription}
+				</p>
+			</div>
+		{/if}
+
+		{#if rows.length > 0}
+			<ul
+				class="max-h-40 space-y-2 text-sm overflow-y-auto {view === 'live'
+					? 'mt-3 pt-3 border-t'
+					: ''}"
+			>
+				{#each rows as row, i (i)}
+					<li class="gap-2 flex">
+						{#if row.level === 'error'}
+							<CircleAlert class="mt-0.5 h-4 w-4 shrink-0 text-destructive" />
+						{:else if row.level === 'warning'}
+							<TriangleAlert class="mt-0.5 h-4 w-4 text-amber-500 shrink-0" />
+						{:else}
+							<Info class="mt-0.5 h-4 w-4 shrink-0 text-muted-foreground" />
+						{/if}
+						<div class="min-w-0 flex-1">
+							<p class="wrap-anywhere">{row.message}</p>
+							{#if row.source}
+								<p class="text-xs text-muted-foreground">{row.source}</p>
+							{/if}
+						</div>
+					</li>
+				{/each}
+			</ul>
+		{/if}
+
+		{#if view === 'review' || view === 'blocked'}
+			<div class="mt-3 gap-2 flex justify-end">
+				{#if view === 'blocked'}
+					<Button variant="outline" size="sm" onclick={dismiss}>{labels.dismiss}</Button>
+				{:else}
+					<Button variant="outline" size="sm" onclick={ondiscard}>{labels.discard}</Button>
+					<Button size="sm" onclick={onconfirm}>{labels.confirm}</Button>
+				{/if}
+			</div>
+		{/if}
+	</div>
+{/if}

package/src/lib/components/layout/AppShell.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
+	import type { SolveDiagnostic } from '@selvajs/solve/shared';
 	import PageHeader from './PageHeader.svelte';
 	import PageFooter from './PageFooter.svelte';
 
@@ -32,6 +33,8 @@
 		showFooter?: boolean;
 		errors?: string[];
 		warnings?: string[];
+		/** Structured messages for the footer badge and message centre. */
+		diagnostics?: SolveDiagnostic[];
 		/** Fully overrides the footer copyright line. `{name}` and `{year}` are substituted. */
 		footerText?: string;
 		footerChildren?: Snippet;
@@ -59,6 +62,7 @@
 		showFooter = false,
 		errors = [],
 		warnings = [],
+		diagnostics,
 		footerText,
 		footerChildren,
 		class: className = '',
@@ -138,7 +142,7 @@
 
 	{#if showFooter}
 		<div class="bottom-0 sticky z-10 shrink-0">
-			<PageFooter {errors} {warnings} copyrightName={_copyright} {footerText}>
+			<PageFooter {errors} {warnings} {diagnostics} copyrightName={_copyright} {footerText}>
 				{#if footerChildren}
 					{@render footerChildren()}
 				{/if}

package/src/lib/components/layout/PageFooter.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import type { Snippet } from 'svelte';
-	import { CircleAlert, TriangleAlert } from '@lucide/svelte';
+	import { CircleAlert, TriangleAlert, Info } from '@lucide/svelte';
+	import type { SolveDiagnostic } from '@selvajs/solve/shared';
 	import { useFooter } from '$lib/contexts/footerContext.svelte';
 	import ComputeMessagesDialog from '../compute/ComputeMessagesDialog.svelte';
 	import FooterItemRenderer from './FooterItemRenderer.svelte';
@@ -8,6 +9,8 @@
 	interface Props {
 		errors?: string[];
 		warnings?: string[];
+		/** Structured messages, including remarks. Preferred over the two arrays above. */
+		diagnostics?: SolveDiagnostic[];
 		copyrightName?: string;
 		/** Fully overrides the copyright line. `{name}` and `{year}` are substituted. */
 		footerText?: string;
@@ -17,6 +20,7 @@
 	let {
 		errors = [],
 		warnings = [],
+		diagnostics,
 		copyrightName = 'Selva',
 		footerText,
 		children
@@ -47,8 +51,19 @@
 
 	let _currentYear = new Date().getFullYear();
 
-	const hasMessages = $derived(errors.length > 0 || warnings.length > 0);
-	const totalCount = $derived(errors.length + warnings.length);
+	// Counts come from `diagnostics` when the host supplies it, so remarks are included and the
+	// badge matches what the dialog lists.
+	const errorCount = $derived(
+		diagnostics ? diagnostics.filter((d) => d.level === 'error').length : errors.length
+	);
+	const warningCount = $derived(
+		diagnostics ? diagnostics.filter((d) => d.level === 'warning').length : warnings.length
+	);
+	const remarkCount = $derived(
+		diagnostics ? diagnostics.filter((d) => d.level === 'remark').length : 0
+	);
+	const totalCount = $derived(errorCount + warningCount + remarkCount);
+	const hasMessages = $derived(totalCount > 0);
 
 	const copyrightLine = $derived(
 		footerText
@@ -66,28 +81,33 @@
 		{/each}
 
 		{#if hasMessages}
-			<ComputeMessagesDialog {errors} {warnings}>
+			<ComputeMessagesDialog {errors} {warnings} {diagnostics}>
 				{#snippet trigger()}
 					<div
-						class="gap-1.5 px-2 py-1 rounded flex cursor-pointer items-center transition-colors hover:bg-muted {errors.length >
+						class="gap-1.5 px-2 py-1 rounded flex cursor-pointer items-center transition-colors hover:bg-muted {errorCount >
 						0
 							? 'text-destructive hover:bg-destructive/10'
-							: 'text-warning hover:bg-warning/10'}"
-						title={`${totalCount} ${totalCount === 1 ? 'issue' : 'issues'}`}
+							: warningCount > 0
+								? 'text-warning hover:bg-warning/10'
+								: 'hover:bg-muted'}"
+						title={`${totalCount} ${totalCount === 1 ? 'message' : 'messages'} from the last solve`}
 					>
-						{#if errors.length > 0}
+						{#if errorCount > 0}
 							<CircleAlert class="h-3.5 w-3.5" />
-							<span class="font-medium">{errors.length} Error{errors.length !== 1 ? 's' : ''}</span>
+							<span class="font-medium">{errorCount} Error{errorCount !== 1 ? 's' : ''}</span>
 						{/if}
 
-						{#if warnings.length > 0}
-							{#if errors.length > 0}
+						{#if warningCount > 0}
+							{#if errorCount > 0}
 								<span class="text-border">•</span>
 							{/if}
 							<TriangleAlert class="h-3.5 w-3.5" />
-							<span class="font-medium"
-								>{warnings.length} Warning{warnings.length !== 1 ? 's' : ''}</span
-							>
+							<span class="font-medium">{warningCount} Warning{warningCount !== 1 ? 's' : ''}</span>
+						{/if}
+
+						{#if errorCount === 0 && warningCount === 0}
+							<Info class="h-3.5 w-3.5" />
+							<span class="font-medium">{remarkCount} Note{remarkCount !== 1 ? 's' : ''}</span>
 						{/if}
 					</div>
 				{/snippet}

package/src/lib/compute/useSolveSession.svelte.ts

@@ -20,11 +20,16 @@ export function useSolveSession(args: SolveSessionArgs): SolveSession {
 	let version = $state(0);
 
 	$effect(() => {
-		// The session is created alongside this adapter and outlives no other component, so
-		// dropping the subscription is the whole cleanup.
-		return session.subscribe(() => {
+		const unsubscribe = session.subscribe(() => {
 			version += 1;
 		});
+		// The session dies with the owning component. Its event source may not (the cloud
+		// stream belongs to the tab), so the session must stop listening to it, not only we to
+		// the session.
+		return () => {
+			unsubscribe();
+			session.dispose();
+		};
 	});
 
 	/** Registers the reactive dependency, then returns the live value. */
@@ -46,6 +51,22 @@ export function useSolveSession(args: SolveSessionArgs): SolveSession {
 		get computeWarnings() {
 			return track(() => session.computeWarnings);
 		},
+		get diagnostics() {
+			return track(() => session.diagnostics);
+		},
+		get blocked() {
+			return track(() => session.blocked);
+		},
+		get awaitingAck() {
+			return track(() => session.awaitingAck);
+		},
+		get live() {
+			return track(() => session.live);
+		},
+		get phase() {
+			return track(() => session.phase);
+		},
+		abort: () => session.abort(),
 		get meshes() {
 			return track(() => session.meshes);
 		},
@@ -61,6 +82,8 @@ export function useSolveSession(args: SolveSessionArgs): SolveSession {
 		get isSolving() {
 			return track(() => session.isSolving);
 		},
+		acknowledge: () => session.acknowledge(),
+		discard: () => session.discard(),
 		setValue: (id, value, forceSolve) => session.setValue(id, value, forceSolve),
 		solve: () => session.solve(),
 		loadValues: (incoming) => session.loadValues(incoming),
@@ -68,6 +91,7 @@ export function useSolveSession(args: SolveSessionArgs): SolveSession {
 		report: (result) => session.report(result),
 		reportError: (message) => session.reportError(message),
 		subscribe: (listener) => session.subscribe(listener),
-		notify: () => session.notify()
+		notify: () => session.notify(),
+		dispose: () => session.dispose()
 	};
 }

package/src/lib/i18n/messages.ts

@@ -54,6 +54,15 @@ export interface ViewerMessages {
 
 	// App layout / compute shell
 	loadingSchema: string;
+	solveBlocked: string;
+	solveBlockedTitle: string;
+	solveMessagesTitle: string;
+	solveMessagesDescription: string;
+	solveMessagesConfirm: string;
+	solveMessagesDiscard: string;
+	solveMessagesAbort: string;
+	solveMessagesDismiss: string;
+	solveSolving: string;
 	parametersTab: string;
 	moreTab: string;
 	expandPanel: string;
@@ -113,6 +122,15 @@ const en: ViewerMessages = {
 	noMetadata: 'No metadata',
 
 	loadingSchema: 'Loading schema...',
+	solveBlocked: 'The definition stopped this solve. No results were produced.',
+	solveBlockedTitle: 'Solve stopped',
+	solveMessagesTitle: 'Solve messages',
+	solveMessagesDescription: 'This solve reported the following. Continue to see the result.',
+	solveMessagesConfirm: 'Continue',
+	solveMessagesDiscard: 'Discard',
+	solveMessagesAbort: 'Abort',
+	solveMessagesDismiss: 'Dismiss',
+	solveSolving: 'Solving…',
 	parametersTab: 'Parameters',
 	moreTab: 'More',
 	expandPanel: 'Expand panel',
@@ -170,6 +188,16 @@ const de: ViewerMessages = {
 	noMetadata: 'Keine Metadaten',
 
 	loadingSchema: 'Schema wird geladen...',
+	solveBlocked: 'Die Definition hat diese Berechnung gestoppt. Es wurden keine Ergebnisse erzeugt.',
+	solveBlockedTitle: 'Berechnung gestoppt',
+	solveMessagesTitle: 'Meldungen zur Berechnung',
+	solveMessagesDescription:
+		'Diese Berechnung hat Folgendes gemeldet. Weiter, um das Ergebnis zu sehen.',
+	solveMessagesConfirm: 'Weiter',
+	solveMessagesDiscard: 'Verwerfen',
+	solveMessagesAbort: 'Abbrechen',
+	solveMessagesDismiss: 'Schliessen',
+	solveSolving: 'Berechnung läuft…',
 	parametersTab: 'Parameter',
 	moreTab: 'Mehr',
 	expandPanel: 'Bereich aufklappen',

package/src/lib/index.ts

@@ -6,6 +6,7 @@ export * from './components/layout';
 
 export { default as AppLayout } from './components/compute/AppLayout.svelte';
 export { default as ComputeApp } from './components/compute/ComputeApp.svelte';
+export { default as SolveMessages } from './components/compute/SolveMessages.svelte';
 
 export { default as ErrorScreen } from './components/ErrorScreen.svelte';
 
@@ -30,7 +31,14 @@ export {
 	type SolveSession,
 	type SolveSessionArgs,
 	type SolveDriver,
-	type SolveReporter
+	type SolveReporter,
+	type LiveSolveState,
+	type SolvePhase,
+	// A push driver (plugin-ui's WebSocket) decodes the plugin's verdict with these.
+	EMPTY_LIVE_SOLVE,
+	decodeOutcome,
+	finalizeResult,
+	type SolveOutcome
 } from '@selvajs/solve/client';
 
 // Pre-step producer transit storage
@@ -52,5 +60,5 @@ export { randomId } from './utils/randomId';
 
 // UI-specific runtime types (not from schema)
 export type { ActionButton } from './types/actionButton';
-export type { SolveFn, SolveResult } from '@selvajs/solve/shared';
+export type { SolveFn, SolveResult, SolveDiagnostic } from '@selvajs/solve/shared';
 export { DEFAULT_PRESET_LABELS, type PresetLabels } from './types/presetLabels';

package/src/lib/public.ts

@@ -56,7 +56,9 @@ export {
 	type SolveSession,
 	type SolveSessionArgs,
 	type SolveDriver,
-	type SolveReporter
+	type SolveReporter,
+	type LiveSolveState,
+	type SolvePhase
 } from '@selvajs/solve/client';
 
 // Client-slot context: host apps render their own cell for client-sourced inputs,
@@ -80,5 +82,5 @@ export * from './schema/dynamic-value-list';
 
 // UI-facing runtime types (not from schema)
 export type { ActionButton } from './types/actionButton';
-export type { SolveFn, SolveResult } from '@selvajs/solve/shared';
+export type { SolveFn, SolveResult, SolveDiagnostic } from '@selvajs/solve/shared';
 export { DEFAULT_PRESET_LABELS, type PresetLabels } from './types/presetLabels';