@selvajs/ui 5.0.1 → 6.0.0-beta.1

package/dist/compute/useSolveSession.svelte.js

@@ -0,0 +1,79 @@
+// The Svelte binding for a Solve Session.
+//
+// The session itself lives in `@selvajs/solve/client` and is framework-free: it
+// exposes plain getters plus a `subscribe()` seam. That makes it usable headless, but a
+// plain getter read inside Svelte markup is NOT reactive — nothing tells the component to
+// re-run. This adapter closes that gap: it subscribes once, bumps a `$state` version
+// counter on every notification, and reads that counter inside each getter so any
+// component touching one re-runs when the session changes.
+//
+// The counter (rather than mirroring each field into its own `$state`) keeps this a pure
+// republish: no field list to keep in sync as the session grows, and no risk of a mirrored
+// copy drifting from the source of truth.
+import { createSolveSession } from '@selvajs/solve/client';
+/**
+ * Wraps a Solve Session so its state reads reactively inside Svelte components.
+ *
+ * Returns the same `SolveSession` surface — every method delegates untouched, and every
+ * getter additionally depends on the version counter. Callers use it exactly like the
+ * session it wraps.
+ *
+ * Must be called during component initialization (it uses `$effect` to manage the
+ * subscription, so teardown follows the owning component's lifecycle).
+ */
+export function useSolveSession(args) {
+    const session = createSolveSession(args);
+    // Bumped on every session notification. Reading it inside a getter is what registers
+    // the dependency; the value itself is never meaningful.
+    let version = $state(0);
+    $effect(() => {
+        // Re-read on mount and unsubscribe on teardown. The session outlives no component
+        // here — it is created alongside this adapter — so dropping the subscription is the
+        // whole cleanup.
+        return session.subscribe(() => {
+            version += 1;
+        });
+    });
+    /** Registers the reactive dependency, then returns the live value. */
+    function track(read) {
+        void version;
+        return read();
+    }
+    return {
+        get values() {
+            return track(() => session.values);
+        },
+        get error() {
+            return track(() => session.error);
+        },
+        get computeErrors() {
+            return track(() => session.computeErrors);
+        },
+        get computeWarnings() {
+            return track(() => session.computeWarnings);
+        },
+        get meshes() {
+            return track(() => session.meshes);
+        },
+        get lastResult() {
+            return track(() => session.lastResult);
+        },
+        get hasPendingChanges() {
+            return track(() => session.hasPendingChanges);
+        },
+        get hasNeverSolved() {
+            return track(() => session.hasNeverSolved);
+        },
+        get isSolving() {
+            return track(() => session.isSolving);
+        },
+        setValue: (id, value, forceSolve) => session.setValue(id, value, forceSolve),
+        solve: () => session.solve(),
+        loadValues: (incoming) => session.loadValues(incoming),
+        rebuild: (schema, scopeKey) => session.rebuild(schema, scopeKey),
+        report: (result) => session.report(result),
+        reportError: (message) => session.reportError(message),
+        subscribe: (listener) => session.subscribe(listener),
+        notify: () => session.notify()
+    };
+}

package/dist/external/storage.d.ts

@@ -1,15 +1 @@
-import type { UISchema } from '@selvajs/schemas';
-export interface ExternalValueRef {
-    scopeKey: string;
-    inputId: string;
-}
-export declare function writeExternalValue(args: ExternalValueRef & {
-    value: unknown;
-}): void;
-export declare function readExternalValue(ref: ExternalValueRef): unknown | undefined;
-export declare function clearExternalValue(ref: ExternalValueRef): void;
-export interface ExternalInput {
-    paramId: string;
-    displayName: string;
-}
-export declare function getExternalInputs(schema: UISchema): ExternalInput[];
+export { writeExternalValue, readExternalValue, clearExternalValue, getExternalInputs, type ExternalValueRef, type ExternalInput } from '@selvajs/solve/client';

package/dist/external/storage.js

@@ -1,54 +1,4 @@
-// Client-supplied input transit storage.
-//
-// When an input has source.kind === 'client', a producer route writes the produced
-// value here, and the solver route reads it back. Scoped per (scopeKey, inputId) so
-// values for one solver/input don't bleed into another. The scope key is whatever
-// uniquely identifies the solver context — sessionId in plugin-ui/preview,
-// definition guid in selva/library, etc.
-//
-// inputId is the Grasshopper parameter instance GUID (LayoutItem.paramId / SchemaInput.id).
-import { getInputItems } from '@selvajs/schemas';
-const STORAGE_PREFIX = 'external';
-function makeKey(scopeKey, inputId) {
-    return `${STORAGE_PREFIX}:${scopeKey}:${inputId}`;
-}
-export function writeExternalValue(args) {
-    const { scopeKey, inputId, value } = args;
-    if (!scopeKey || !inputId)
-        return;
-    if (typeof sessionStorage === 'undefined')
-        return;
-    sessionStorage.setItem(makeKey(scopeKey, inputId), JSON.stringify(value));
-}
-export function readExternalValue(ref) {
-    const { scopeKey, inputId } = ref;
-    if (!scopeKey || !inputId)
-        return undefined;
-    if (typeof sessionStorage === 'undefined')
-        return undefined;
-    const raw = sessionStorage.getItem(makeKey(scopeKey, inputId));
-    if (raw === null)
-        return undefined;
-    try {
-        return JSON.parse(raw);
-    }
-    catch {
-        return undefined;
-    }
-}
-export function clearExternalValue(ref) {
-    const { scopeKey, inputId } = ref;
-    if (!scopeKey || !inputId)
-        return;
-    if (typeof sessionStorage === 'undefined')
-        return;
-    sessionStorage.removeItem(makeKey(scopeKey, inputId));
-}
-export function getExternalInputs(schema) {
-    return getInputItems(schema)
-        .filter((item) => item.source?.kind === 'client')
-        .map((item) => ({
-        paramId: item.paramId,
-        displayName: item.displayName ?? item.paramId
-    }));
-}
+// Moved to `@selvajs/solve/client`, where the Solve Session that hydrates from it
+// now lives. Re-exported here to keep the published `@selvajs/ui/external` sub-path — and
+// the pre-step producer routes that import it — working unchanged.
+export { writeExternalValue, readExternalValue, clearExternalValue, getExternalInputs } from '@selvajs/solve/client';

package/dist/index.d.ts

@@ -9,13 +9,14 @@ export * from './schema/defaults';
 export * from './schema/dynamic-value-list';
 export * from './schema/traversal';
 export * from './compute/solving.svelte';
-export { createSolveSession, createRequestResponseDriver, type SolveSession, type SolveSessionArgs, type SolveDriver, type SolveReporter } from './compute/createSolveSession.svelte';
-export * from './external/storage';
+export { useSolveSession } from './compute/useSolveSession.svelte';
+export { createSolveSession, createRequestResponseDriver, type SolveSession, type SolveSessionArgs, type SolveDriver, type SolveReporter } from '@selvajs/solve/client';
+export { writeExternalValue, readExternalValue, clearExternalValue, getExternalInputs, type ExternalValueRef, type ExternalInput } from '@selvajs/solve/client';
 export * from './contexts/footerContext.svelte';
 export * from './contexts/clientSlotContext.svelte';
 export * from './composables/useFooterItem.svelte';
 export * from './utils';
 export { randomId } from './utils/randomId';
 export type { ActionButton } from './types/actionButton';
-export type { SolveFn, SolveResult } from './types/solveFn';
+export type { SolveFn, SolveResult } from '@selvajs/solve/shared';
 export { DEFAULT_PRESET_LABELS, type PresetLabels } from './types/presetLabels';

package/dist/index.js

@@ -15,12 +15,15 @@ export * from './schema/defaults';
 export * from './schema/dynamic-value-list';
 export * from './schema/traversal';
 export * from './compute/solving.svelte';
-// Solve Session seam (transport-agnostic value/lifecycle state machine + its driver
-// interface). Exported so transports outside this package — e.g. plugin-ui's WebSocket
+// Solve Session seam. The session itself now lives in `@selvajs/solve/client`
+// (framework-free); `useSolveSession` is this package's Svelte binding, which republishes
+// the session's subscribe() notifications as rune state so its getters read reactively in
+// markup. Re-exported so transports outside this package — e.g. plugin-ui's WebSocket
 // driver — can satisfy SolveDriver and drive a session. See CONTEXT.md.
-export { createSolveSession, createRequestResponseDriver } from './compute/createSolveSession.svelte';
+export { useSolveSession } from './compute/useSolveSession.svelte';
+export { createSolveSession, createRequestResponseDriver } from '@selvajs/solve/client';
 // External-input transit storage (used by routes that wire pre-step producers)
-export * from './external/storage';
+export { writeExternalValue, readExternalValue, clearExternalValue, getExternalInputs } from '@selvajs/solve/client';
 // Contexts & Composables
 export * from './contexts/footerContext.svelte';
 export * from './contexts/clientSlotContext.svelte';

package/dist/public.d.ts

@@ -5,12 +5,13 @@ export type { Locale, ViewerMessages } from './i18n/messages';
 export { VIEWER_MESSAGES, DEFAULT_LOCALE, messagesFor } from './i18n/messages';
 export { setLocaleContext, getLocaleContext, type LocaleContext } from './i18n/localeContext.svelte';
 export { default as ErrorScreen } from './components/ErrorScreen.svelte';
-export { createSolveSession, createRequestResponseDriver, type SolveSession, type SolveSessionArgs, type SolveDriver, type SolveReporter } from './compute/createSolveSession.svelte';
+export { useSolveSession } from './compute/useSolveSession.svelte';
+export { createSolveSession, createRequestResponseDriver, type SolveSession, type SolveSessionArgs, type SolveDriver, type SolveReporter } from '@selvajs/solve/client';
 export type { ClientSlotArgs, ClientSlot } from './contexts/clientSlotContext.svelte';
-export * from './external/storage';
+export { writeExternalValue, readExternalValue, clearExternalValue, getExternalInputs, type ExternalValueRef, type ExternalInput } from '@selvajs/solve/client';
 export * from './schema/defaults';
 export * from './schema/traversal';
 export * from './schema/dynamic-value-list';
 export type { ActionButton } from './types/actionButton';
-export type { SolveFn, SolveResult } from './types/solveFn';
+export type { SolveFn, SolveResult } from '@selvajs/solve/shared';
 export { DEFAULT_PRESET_LABELS, type PresetLabels } from './types/presetLabels';

package/dist/public.js

@@ -8,7 +8,8 @@
 // Scope: the compute-app SDK — everything an external host app needs to embed a
 // Grasshopper-driven app (ComputeApp), drive solves, and wire pre-step
 // producers. Verified against real external host apps: they import
-// ComputeApp + its types, the solve seam, and external/storage. Nothing else.
+// ComputeApp + its types, the solve seam, and the external-input storage
+// helpers. Nothing else.
 //
 // Deliberately NOT public: design-system primitives (Button, Card, Dialog, …),
 // page-chrome layout (AppShell, SideNav, …), toast/Toaster, ThemeSwitcher,
@@ -30,11 +31,14 @@ export { setLocaleContext, getLocaleContext } from './i18n/localeContext.svelte'
 // Full-screen states a host app renders
 export { default as ErrorScreen } from './components/ErrorScreen.svelte';
 // Solve Session seam (transport-agnostic value/lifecycle state machine + its
-// driver interface). Exported so transports outside this package can satisfy
-// SolveDriver and drive a session. See CONTEXT.md.
-export { createSolveSession, createRequestResponseDriver } from './compute/createSolveSession.svelte';
+// driver interface). The session lives in `@selvajs/solve/client` and is
+// framework-free; `useSolveSession` is the Svelte binding that makes its getters
+// read reactively inside components. A host embedding <ComputeApp> needs neither —
+// both are re-exported for hosts driving a session themselves. See CONTEXT.md.
+export { useSolveSession } from './compute/useSolveSession.svelte';
+export { createSolveSession, createRequestResponseDriver } from '@selvajs/solve/client';
 // Pre-step producer transit storage (host apps wire producers via these).
-export * from './external/storage';
+export { writeExternalValue, readExternalValue, clearExternalValue, getExternalInputs } from '@selvajs/solve/client';
 // Schema utilities a ComputeApp host reasonably needs to read/shape values.
 export * from './schema/defaults';
 export * from './schema/traversal';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selvajs/ui",
-  "version": "5.0.1",
+  "version": "6.0.0-beta.1",
   "description": "Shared UI components and utilities for Selva applications",
   "license": "MIT",
   "author": "VektorNode",
@@ -60,8 +60,10 @@
     "svelte": "^5",
     "tailwind-variants": "^3.3.0",
     "three": "^0.185.1",
+    "@selvajs/compute": "^4.0.0-beta.1",
     "@selvajs/schemas": "^4.7.0",
-    "@selvajs/compute": "^3.1.1"
+    "@selvajs/solve": "^1.0.0-beta.5",
+    "@selvajs/visualization": "^1.0.0-beta.0"
   },
   "peerDependenciesMeta": {
     "three": {
@@ -89,9 +91,12 @@
     "rimraf": "^6.0.1",
     "svelte": "5.56.8",
     "tailwind-variants": "^3.3.0",
-    "vitest": "^3.2.7",
+    "vitest": "^4.1.10",
     "@selvajs/config": "0.0.3",
-    "@selvajs/schemas": "4.7.0"
+    "@selvajs/schemas": "4.7.0",
+    "@selvajs/visualization": "1.0.0-beta.0",
+    "@selvajs/solve": "1.0.0-beta.5",
+    "@selvajs/compute": "4.0.0-beta.1"
   },
   "scripts": {
     "predev": "node ../../scripts/sync-shared-assets.js",

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

@@ -3,13 +3,13 @@
 	import { page } from '$app/state';
 	import type { UISchema, ParameterPreset } from '@selvajs/schemas';
 	import type { ActionButton } from '../../types/actionButton';
-	import type { SolveFn } from '../../types/solveFn';
+	import type { SolveFn } from '@selvajs/solve/shared';
 	import type { PresetLabels } from '../../types/presetLabels';
 	import { createSolvingIndicator } from '../../compute/solving.svelte';
-	import {
-		createSolveSession,
-		createRequestResponseDriver
-	} from '../../compute/createSolveSession.svelte';
+	import { createRequestResponseDriver } from '@selvajs/solve/client';
+	import type { RetainedSolveResult } from '@selvajs/solve/client';
+	import { meshPolicy } from '@selvajs/visualization/parse';
+	import { useSolveSession } from '../../compute/useSolveSession.svelte';
 	import { useFooterItem } from '../../composables/useFooterItem.svelte';
 	import { hexToOklch } from '../../utils/color';
 	import AppShell from '../layout/AppShell.svelte';
@@ -44,13 +44,25 @@
 		copyrightName?: string;
 		/** Fully overrides the footer copyright line. `{name}` and `{year}` are substituted. */
 		footerText?: string;
-		/** Per-solve abort timeout (ms). Falls back to createComputeThrottle's default. */
-		solveTimeoutMs?: number;
+		/**
+		 * How long one solve may take before the client aborts it (ms). Required: pass
+		 * the same value the server enforces (`COMPUTE_SOLVE_DEADLINE_MS`), so the client
+		 * doesn't abort a solve that would have finished.
+		 */
+		solveDeadlineMs: number;
 		footerComponent?: any;
 		footerComponentProps?: () => Record<string, unknown>;
 		footerItemId?: string;
 		footerItemPriority?: number;
-		onReady?: (api: { loadValues: (values: Record<string, unknown>) => void }) => void;
+		onReady?: (api: {
+			loadValues: (values: Record<string, unknown>) => void;
+			/**
+			 * The last result reported to the session — the one the viewer is showing, carrying
+			 * `source`/`values` even when a memo hit served it. Null before the first solve.
+			 * A getter, not a snapshot: `onReady` fires once.
+			 */
+			getLastResult: () => RetainedSolveResult | null;
+		}) => void;
 		headerRight?: Snippet;
 		// Replaces the built-in header; takes precedence over `headerRight`.
 		header?: Snippet;
@@ -84,7 +96,7 @@
 		presetLabels,
 		copyrightName,
 		footerText,
-		solveTimeoutMs,
+		solveDeadlineMs,
 		footerComponent,
 		footerComponentProps,
 		footerItemId = 'footer-item',
@@ -115,10 +127,19 @@
 	// reads the reporter lazily so it can capture the session it's wired into.
 	// svelte-ignore state_referenced_locally
 	const driver = createRequestResponseDriver(onSolve, () => session, {
-		timeout: solveTimeoutMs
+		solveDeadlineMs,
+		// The driver's result memo caches whole solve results, meshes included — and the viewer
+		// disposes what it renders on the next scene update. `@selvajs/solve` keeps meshes opaque,
+		// so the three.js clone/dispose rules are injected from the renderer that owns them
+		// (audit C1). Without this a memo hit serves an already-disposed mesh.
+		meshPolicy,
+		// `session.isSolving` forwards to the driver, which the session can't observe on its
+		// own — republish so the spinner and disabled states track it. Deferred into a
+		// callback, so it reads `session` after initialization rather than during it.
+		onChange: () => session.notify()
 	});
 	// svelte-ignore state_referenced_locally
-	const session = createSolveSession({
+	const session = useSolveSession({
 		schema,
 		scopeKey: externalScopeKey || definitionKey || schema?.id || '',
 		driver
@@ -129,7 +150,10 @@
 	const solvingIndicator = createSolvingIndicator(() => session.isSolving);
 
 	$effect(() => {
-		onReady?.({ loadValues: (incoming) => session.loadValues(incoming) });
+		onReady?.({
+			loadValues: (incoming) => session.loadValues(incoming),
+			getLastResult: () => session.lastResult
+		});
 	});
 
 	let previousDefinitionKey = $state('');

package/src/lib/components/primitives/textarea/textarea.svelte

@@ -19,5 +19,4 @@
 		className
 	)}
 	bind:value
-	{...restProps}
-></textarea>
+	{...restProps}></textarea>