@selvajs/ui 4.4.0 → 4.6.0

package/dist/components/compute/AppLayout.svelte

@@ -25,7 +25,7 @@
 		oncalculate?: () => void;
 		values: Record<string, unknown>;
 		onValueChange: (id: string, val: SupportedTypes) => void | Promise<void>;
-		onLoadValues?: () => void | Promise<void>;
+		onLoadValues?: (values: Record<string, unknown>) => void | Promise<void>;
 		panelActions?: ActionButton[];
 		showSaveButton?: boolean;
 		showLoadButton?: boolean;
@@ -99,7 +99,7 @@
 
 	async function handleLoadValues(loadedValues: Record<string, unknown>) {
 		Object.assign(values, loadedValues);
-		await onLoadValues?.();
+		await onLoadValues?.(loadedValues);
 	}
 
 	let _touchStartY = 0;
@@ -125,7 +125,7 @@
 )}
 	<div class="panel-content-wrapper">
 		{#if schema.layout.type === 'tabbed'}
-			<TabLayout {schema} bind:values {onValueChange} {panelFilter} {requestedTabId} />
+			<TabLayout {schema} {values} {onValueChange} {panelFilter} {requestedTabId} />
 		{/if}
 		{#if showParameterStateManager || (!isMobile && showCalculateButton && schema.instanceSolve === false)}
 			<div class="panel-footer px-3">

package/dist/components/compute/AppLayout.svelte.d.ts

@@ -13,7 +13,7 @@ interface Props {
     oncalculate?: () => void;
     values: Record<string, unknown>;
     onValueChange: (id: string, val: SupportedTypes) => void | Promise<void>;
-    onLoadValues?: () => void | Promise<void>;
+    onLoadValues?: (values: Record<string, unknown>) => void | Promise<void>;
     panelActions?: ActionButton[];
     showSaveButton?: boolean;
     showLoadButton?: boolean;

package/dist/components/preview/InputControl.svelte

@@ -1,9 +1,16 @@
 <script lang="ts">
-	import type { InputLayoutItem, FileInputWidgetConfig, SupportedTypes } from '@selvajs/schemas';
+	import type {
+		InputLayoutItem,
+		FileInputWidgetConfig,
+		DynamicValueListWidgetConfig,
+		DropdownWidgetConfig,
+		SupportedTypes
+	} from '@selvajs/schemas';
 	import {
 		isNumberWidget,
 		isTextWidget,
 		isDropdownWidget,
+		isDynamicValueListWidget,
 		isCheckboxWidget,
 		isFileWidget,
 		isColorWidget
@@ -28,6 +35,8 @@
 		displayName?: string;
 		onChange: (paramId: string, value: SupportedTypes) => void;
 		disabled?: boolean;
+		/** Runtime-computed options for a dynamic value list input (name -> value). */
+		dynamicOptions?: Record<string, string>;
 	}
 
 	let {
@@ -35,7 +44,8 @@
 		value = $bindable(undefined),
 		displayName,
 		onChange,
-		disabled = false
+		disabled = false,
+		dynamicOptions
 	}: Props = $props();
 
 	const inputId = $derived(`input-${item.paramId}`);
@@ -68,6 +78,50 @@
 
 	const showRangeInLabel = $derived(isNumberWidget(item) && numberRangeHint !== null);
 
+	// Dynamic value list: computed options (from the last solve) take precedence over the
+	// author's seed list. Empty until the first solve produces options, unless a default is set.
+	const dynamicListConfig = $derived(
+		isDynamicValueListWidget(item)
+			? (item.config as DynamicValueListWidgetConfig | undefined)
+			: undefined
+	);
+	const dynamicListOptions = $derived<Record<string, string>>(
+		dynamicOptions && Object.keys(dynamicOptions).length > 0
+			? dynamicOptions
+			: (Object.fromEntries(
+					Object.entries(dynamicListConfig?.defaultOptions ?? {}).filter(
+						(entry): entry is [string, string] => entry[1] !== undefined
+					)
+				) as Record<string, string>)
+	);
+	const dynamicListHasOptions = $derived(Object.keys(dynamicListOptions).length > 0);
+	// As a dropdown config so DropdownInput/ChecklistInput can consume it unchanged.
+	const dynamicListAsDropdownConfig = $derived<DropdownWidgetConfig>({
+		options: dynamicListOptions,
+		displayAs: dynamicListConfig?.displayAs ?? 'dropdown'
+	});
+	const hideDynamicListWhenEmpty = $derived(
+		isDynamicValueListWidget(item) &&
+			!dynamicListHasOptions &&
+			(dynamicListConfig?.emptyBehavior ?? 'hide') === 'hide'
+	);
+
+	// When a dynamic value list recomputes, a previously-selected value may no longer be an
+	// available option. Prune the stale selection so the control shows a valid option (or empty)
+	// instead of rendering the orphaned raw value as its own label.
+	$effect(() => {
+		if (!isDynamicValueListWidget(item) || !dynamicListHasOptions) return;
+		const validValues = new Set(Object.values(dynamicListOptions));
+		// Route through onChange (not commit) — value is a one-way prop here, so writing it
+		// directly from an effect trips Svelte's binding-ownership check.
+		if (Array.isArray(value)) {
+			const pruned = value.filter((v) => typeof v === 'string' && validValues.has(v));
+			if (pruned.length !== value.length) onChange(item.paramId, pruned);
+		} else if (typeof value === 'string' && value && !validValues.has(value)) {
+			onChange(item.paramId, '');
+		}
+	});
+
 	function commit(newValue: SupportedTypes) {
 		value = newValue;
 		onChange(item.paramId, newValue);
@@ -83,7 +137,7 @@
 			value
 		})}
 	{/if}
-{:else}
+{:else if !hideDynamicListWhenEmpty}
 	<Field.Field>
 		<Field.Label for={inputId} class="gap-2 flex items-center">
 			{label}
@@ -152,6 +206,31 @@
 					{disabled}
 				/>
 			{/if}
+		{:else if isDynamicValueListWidget(item)}
+			{#if dynamicListHasOptions}
+				{#if dynamicListAsDropdownConfig.displayAs === 'checklist'}
+					<ChecklistInput
+						{inputId}
+						value={Array.isArray(value)
+							? (value as string[])
+							: typeof value === 'string' && value
+								? [value]
+								: []}
+						config={dynamicListAsDropdownConfig}
+						onChange={commit}
+						{disabled}
+					/>
+				{:else}
+					<DropdownInput
+						value={typeof value === 'string' ? value : ''}
+						config={dynamicListAsDropdownConfig}
+						onChange={commit}
+						{disabled}
+					/>
+				{/if}
+			{:else}
+				<p class="text-sm text-muted-foreground">No options available yet.</p>
+			{/if}
 		{:else if isFileWidget(item)}
 			{@const config = item.config as FileInputWidgetConfig}
 			<FileInput

package/dist/components/preview/InputControl.svelte.d.ts

@@ -5,6 +5,8 @@ interface Props {
     displayName?: string;
     onChange: (paramId: string, value: SupportedTypes) => void;
     disabled?: boolean;
+    /** Runtime-computed options for a dynamic value list input (name -> value). */
+    dynamicOptions?: Record<string, string>;
 }
 declare const InputControl: import("svelte").Component<Props, {}, "value">;
 type InputControl = ReturnType<typeof InputControl>;

package/dist/components/preview/OutputDisplay.svelte

@@ -288,49 +288,52 @@
 	{/if}
 {/snippet}
 
-<div class="gap-2 flex flex-col">
-	{@render fieldHeader()}
+<!-- Dynamic value list outputs are routing sinks (their options feed an input), not displayed. -->
+{#if item.widgetType !== 'dynamicValueList'}
+	<div class="gap-2 flex flex-col">
+		{@render fieldHeader()}
 
-	{#if item.widgetType === 'chart'}
-		<ChartOutput
-			{item}
-			value={typeof value === 'string' ? value : value != null ? JSON.stringify(value) : ''}
-		/>
-	{:else if item.widgetType === 'image'}
-		<ImageOutput {item} {value} />
-	{:else if item.widgetType === 'file'}
-		{@render fileDisplay()}
-	{:else if item.widgetType === 'number'}
-		<div class="{boxClass} flex items-center bg-muted/50 wrap-break-word">
-			{#if hasValue}
-				<span class="font-bold text-primary">{formattedValue}</span>
-			{:else}
-				{@render placeholder()}
-			{/if}
-		</div>
-	{:else if item.widgetType === 'text'}
-		<div class="group relative">
-			{#if isObjectValue}
-				<pre
-					class="{boxClass} overflow-wrap-anywhere max-h-96 overflow-auto bg-muted/10 text-foreground">{formattedValue}</pre>
-			{:else}
-				<div
-					class="{boxClass} overflow-wrap-anywhere bg-muted/10 wrap-break-word whitespace-pre-wrap text-foreground"
-				>
-					{#if hasValue}{value}{:else}{@render placeholder()}{/if}
-				</div>
-			{/if}
-			{#if hasValue}
-				<Button
-					onclick={copyToClipboard}
-					class="right-2 top-2 absolute transition-opacity {copied
-						? 'opacity-100'
-						: 'opacity-0 group-hover:opacity-100'}"
-					size="sm"
-				>
-					{copied ? 'Copied!' : 'Copy'}
-				</Button>
-			{/if}
-		</div>
-	{/if}
-</div>
+		{#if item.widgetType === 'chart'}
+			<ChartOutput
+				{item}
+				value={typeof value === 'string' ? value : value != null ? JSON.stringify(value) : ''}
+			/>
+		{:else if item.widgetType === 'image'}
+			<ImageOutput {item} {value} />
+		{:else if item.widgetType === 'file'}
+			{@render fileDisplay()}
+		{:else if item.widgetType === 'number'}
+			<div class="{boxClass} flex items-center bg-muted/50 wrap-break-word">
+				{#if hasValue}
+					<span class="font-bold text-primary">{formattedValue}</span>
+				{:else}
+					{@render placeholder()}
+				{/if}
+			</div>
+		{:else if item.widgetType === 'text'}
+			<div class="group relative">
+				{#if isObjectValue}
+					<pre
+						class="{boxClass} overflow-wrap-anywhere max-h-96 overflow-auto bg-muted/10 text-foreground">{formattedValue}</pre>
+				{:else}
+					<div
+						class="{boxClass} overflow-wrap-anywhere bg-muted/10 wrap-break-word whitespace-pre-wrap text-foreground"
+					>
+						{#if hasValue}{value}{:else}{@render placeholder()}{/if}
+					</div>
+				{/if}
+				{#if hasValue}
+					<Button
+						onclick={copyToClipboard}
+						class="right-2 top-2 absolute transition-opacity {copied
+							? 'opacity-100'
+							: 'opacity-0 group-hover:opacity-100'}"
+						size="sm"
+					>
+						{copied ? 'Copied!' : 'Copy'}
+					</Button>
+				{/if}
+			</div>
+		{/if}
+	</div>
+{/if}

package/dist/components/preview/TabContent.svelte

@@ -23,10 +23,20 @@
 		onValueChange: (paramId: string, value: SupportedTypes) => void;
 		inputs: SchemaInput[];
 		outputs: DiscoveredOutput[];
+		/** Computed value list options keyed by the target dynamic-value-list input id. */
+		dynamicOptions?: Record<string, Record<string, string>>;
 	}
 
-	let { tab, values, collapsedGroups, onToggleGroup, onValueChange, inputs, outputs }: Props =
-		$props();
+	let {
+		tab,
+		values,
+		collapsedGroups,
+		onToggleGroup,
+		onValueChange,
+		inputs,
+		outputs,
+		dynamicOptions = {}
+	}: Props = $props();
 
 	function getInputById(paramId: string): SchemaInput | undefined {
 		return inputs.find((i) => i.id === paramId);
@@ -49,6 +59,7 @@
 			displayName={layoutItem.displayName}
 			onChange={onValueChange}
 			disabled={visibility.disabled}
+			dynamicOptions={dynamicOptions[input.id]}
 		/>
 	{/if}
 {/snippet}

package/dist/components/preview/TabContent.svelte.d.ts

@@ -7,6 +7,8 @@ interface Props {
     onValueChange: (paramId: string, value: SupportedTypes) => void;
     inputs: SchemaInput[];
     outputs: DiscoveredOutput[];
+    /** Computed value list options keyed by the target dynamic-value-list input id. */
+    dynamicOptions?: Record<string, Record<string, string>>;
 }
 declare const TabContent: import("svelte").Component<Props, {}, "">;
 type TabContent = ReturnType<typeof TabContent>;

package/dist/components/preview/TabLayout.svelte

@@ -5,6 +5,7 @@
 	import TabBar from './TabBar.svelte';
 	import TabContent from './TabContent.svelte';
 	import { buildVisibilityMap, itemKey } from '../../schema/visibility-rules';
+	import { buildDynamicValueListOptions } from '../../schema/dynamic-value-list';
 
 	interface Props {
 		schema: UISchema;
@@ -16,13 +17,7 @@
 		requestedTabId?: string | null;
 	}
 
-	let {
-		schema,
-		values = $bindable(),
-		onValueChange,
-		panelFilter,
-		requestedTabId = null
-	}: Props = $props();
+	let { schema, values, onValueChange, panelFilter, requestedTabId = null }: Props = $props();
 
 	let activeTabId = $state('');
 	let collapsedGroups = $state<Record<string, boolean>>({});
@@ -38,6 +33,9 @@
 
 	const showTabBar = $derived(visibleTabs.length > 1);
 
+	// Computed value list options keyed by the target input id, derived from solved outputs.
+	const dynamicOptions = $derived(buildDynamicValueListOptions(schema, values));
+
 	// Tab selection
 	$effect(() => {
 		if (requestedTabId && visibleTabs.some((t) => t.id === requestedTabId)) {
@@ -104,6 +102,7 @@
 				{onValueChange}
 				inputs={schema.inputs}
 				outputs={schema.outputs}
+				{dynamicOptions}
 			/>
 		{/each}
 	</Tabs.Root>

package/dist/components/preview/TabLayout.svelte.d.ts

@@ -8,6 +8,6 @@ interface Props {
     /** Externally request a specific tab to be active (e.g. from collapsed strip click) */
     requestedTabId?: string | null;
 }
-declare const TabLayout: import("svelte").Component<Props, {}, "values">;
+declare const TabLayout: import("svelte").Component<Props, {}, "">;
 type TabLayout = ReturnType<typeof TabLayout>;
 export default TabLayout;

package/dist/components/preview/inputs/ChecklistInput.svelte

@@ -28,7 +28,7 @@
 </script>
 
 <div class="divide-y divide-border/60 overflow-hidden rounded-md border border-input">
-	{#each Object.entries(options) as [name, expr] (expr ?? name)}
+	{#each Object.entries(options) as [name, expr] (name)}
 		{@const optionValue = expr ?? name}
 		{@const optionId = `${inputId}-${optionValue}`}
 		{@const isSelected = selected.has(optionValue)}

package/dist/components/preview/inputs/DropdownInput.svelte

@@ -33,7 +33,7 @@
 		{currentLabel || 'Select an option...'}
 	</Select.Trigger>
 	<Select.Content>
-		{#each Object.entries(options) as [name, expr] (expr ?? name)}
+		{#each Object.entries(options) as [name, expr] (name)}
 			<Select.Item value={expr ?? name} label={name} />
 		{/each}
 	</Select.Content>

package/dist/components/preview/inputs/FileInput.svelte

@@ -201,6 +201,17 @@
 			return;
 		}
 
+		// Guard the upload size client-side. The file is base64-embedded into the
+		// compute request body, so an oversize file would otherwise be rejected
+		// server-side with an opaque 413 (see COMPUTE_REQUEST_MAX_BYTES). The URL
+		// import path has the same check; keep the two in sync.
+		if (file.size > APP_DEFAULTS.FILE_UPLOAD.MAX_SIZE_BYTES) {
+			alert(
+				`File too large: ${(file.size / 1024 / 1024).toFixed(2)}MB (max ${APP_DEFAULTS.FILE_UPLOAD.MAX_SIZE_MB}MB).`
+			);
+			return;
+		}
+
 		uploadedFileName = file.name;
 
 		const reader = new FileReader();

package/dist/index.d.ts

@@ -6,8 +6,10 @@ export * from './components/primitives';
 export { default as StateDisplay } from './components/primitives/StateDisplay.svelte';
 export { default as Viewer } from './components/viewer/Viewer.svelte';
 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 * from './contexts/footerContext.svelte';
 export * from './contexts/clientSlotContext.svelte';
@@ -15,5 +17,5 @@ export * from './composables/useFooterItem.svelte';
 export * from './utils';
 export { randomId } from './utils/randomId';
 export type { ActionButton } from './types/actionButton';
-export type { SolveFn } from './types/solveFn';
+export type { SolveFn, SolveResult } from './types/solveFn';
 export { DEFAULT_PRESET_LABELS, type PresetLabels } from './types/presetLabels';

package/dist/index.js

@@ -12,8 +12,13 @@ export { default as StateDisplay } from './components/primitives/StateDisplay.sv
 export { default as Viewer } from './components/viewer/Viewer.svelte';
 // Utilities
 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
+// driver — can satisfy SolveDriver and drive a session. See CONTEXT.md.
+export { createSolveSession, createRequestResponseDriver } from './compute/createSolveSession.svelte';
 // External-input transit storage (used by routes that wire pre-step producers)
 export * from './external/storage';
 // Contexts & Composables

package/dist/schema/dynamic-value-list.d.ts

@@ -0,0 +1,17 @@
+import type { UISchema } from '@selvajs/schemas';
+/**
+ * The runtime payload a dynamic value list output produces, keyed by the output's id in `values`.
+ * Routed back into the dynamic value list input identified by `targetInputId`.
+ */
+export interface DynamicValueListPayload {
+    targetInputId?: string | null;
+    options?: Record<string, string>;
+}
+/**
+ * Build a map of `inputId -> computed options` from the solved output values.
+ *
+ * Reads each dynamicValueList source's `{ targetInputId, options }` payload from `values` and routes
+ * the options to the targeted input. The payload's own `targetInputId` wins; the schema-side
+ * `targetInputId` is the fallback when the payload omits it.
+ */
+export declare function buildDynamicValueListOptions(schema: UISchema, values: Record<string, unknown>): Record<string, Record<string, string>>;

package/dist/schema/dynamic-value-list.js

@@ -0,0 +1,76 @@
+import { getLayoutItems } from '@selvajs/schemas';
+function isDynamicValueListPayload(value) {
+    return (typeof value === 'object' && value !== null && ('targetInputId' in value || 'options' in value));
+}
+/**
+ * Normalize a raw output value into a payload object.
+ *
+ * The local/WebSocket path delivers a real object; the Rhino.Compute path delivers the
+ * component's JSON output as a string (possibly double-encoded by the compute layer), so try
+ * to parse strings before giving up.
+ */
+function coercePayload(value) {
+    if (isDynamicValueListPayload(value))
+        return value;
+    let candidate = value;
+    // Unwrap up to two layers of JSON string encoding (compute may quote the string output).
+    for (let i = 0; i < 2 && typeof candidate === 'string'; i++) {
+        try {
+            candidate = JSON.parse(candidate);
+        }
+        catch {
+            return null;
+        }
+        if (isDynamicValueListPayload(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Every dynamicValueList output reference in the schema.
+ *
+ * Canonical location is `schema.outputs[]` — the plugin's SchemaSynchronizer enforces that every
+ * dynamicValueList layout item is mirrored there (see CanonicalizeDynamicValueListOutputs). We ALSO
+ * scan the layout purely as back-compat defense for schemas persisted by an older plugin that lacked
+ * that invariant; for current schemas the layout pass finds nothing new.
+ * Deduped by id, outputs[] winning so the canonical record's targetInputId takes precedence.
+ */
+function collectDynamicValueListSources(schema) {
+    const byId = new Map();
+    for (const item of getLayoutItems(schema)) {
+        if (item.type !== 'output' || item.widgetType !== 'dynamicValueList')
+            continue;
+        const dvl = item;
+        if (typeof dvl.paramId !== 'string')
+            continue;
+        byId.set(dvl.paramId, { id: dvl.paramId, targetInputId: dvl.config?.targetInputId });
+    }
+    for (const output of schema.outputs ?? []) {
+        if (output.type !== 'dynamicValueList')
+            continue;
+        byId.set(output.id, { id: output.id, targetInputId: output.targetInputId });
+    }
+    return [...byId.values()];
+}
+/**
+ * Build a map of `inputId -> computed options` from the solved output values.
+ *
+ * Reads each dynamicValueList source's `{ targetInputId, options }` payload from `values` and routes
+ * the options to the targeted input. The payload's own `targetInputId` wins; the schema-side
+ * `targetInputId` is the fallback when the payload omits it.
+ */
+export function buildDynamicValueListOptions(schema, values) {
+    const result = {};
+    for (const source of collectDynamicValueListSources(schema)) {
+        const payload = coercePayload(values[source.id]);
+        if (!payload)
+            continue;
+        const targetInputId = payload.targetInputId ?? source.targetInputId;
+        if (!targetInputId)
+            continue;
+        if (payload.options && typeof payload.options === 'object') {
+            result[targetInputId] = payload.options;
+        }
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selvajs/ui",
-  "version": "4.4.0",
+  "version": "4.6.0",
   "description": "Shared UI components and utilities for Selva applications",
   "license": "MIT",
   "publishConfig": {
@@ -39,7 +39,7 @@
     "svelte": "^5",
     "tailwind-variants": "^3.2.2",
     "three": "^0.184.0",
-    "@selvajs/schemas": "^4.4.0"
+    "@selvajs/schemas": "^4.5.0"
   },
   "peerDependenciesMeta": {
     "three": {
@@ -63,15 +63,16 @@
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@types/three": "^0.184.0",
     "bits-ui": "^2.18.0",
+    "rimraf": "^6.0.1",
     "svelte": "5.55.5",
     "tailwind-variants": "^3.2.2",
     "vitest": "^3.2.4",
-    "@selvajs/schemas": "4.4.0",
-    "@selvajs/config": "0.0.0"
+    "@selvajs/config": "0.0.0",
+    "@selvajs/schemas": "4.5.0"
   },
   "scripts": {
     "dev": "vite dev",
-    "build": "rm -rf dist && pnpm prepack",
+    "build": "rimraf dist && pnpm prepack",
     "build:fast": "svelte-kit sync && svelte-package",
     "build:watch": "svelte-kit sync && svelte-package --watch",
     "preview": "vite preview",

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

@@ -25,7 +25,7 @@
 		oncalculate?: () => void;
 		values: Record<string, unknown>;
 		onValueChange: (id: string, val: SupportedTypes) => void | Promise<void>;
-		onLoadValues?: () => void | Promise<void>;
+		onLoadValues?: (values: Record<string, unknown>) => void | Promise<void>;
 		panelActions?: ActionButton[];
 		showSaveButton?: boolean;
 		showLoadButton?: boolean;
@@ -99,7 +99,7 @@
 
 	async function handleLoadValues(loadedValues: Record<string, unknown>) {
 		Object.assign(values, loadedValues);
-		await onLoadValues?.();
+		await onLoadValues?.(loadedValues);
 	}
 
 	let _touchStartY = 0;
@@ -125,7 +125,7 @@
 )}
 	<div class="panel-content-wrapper">
 		{#if schema.layout.type === 'tabbed'}
-			<TabLayout {schema} bind:values {onValueChange} {panelFilter} {requestedTabId} />
+			<TabLayout {schema} {values} {onValueChange} {panelFilter} {requestedTabId} />
 		{/if}
 		{#if showParameterStateManager || (!isMobile && showCalculateButton && schema.instanceSolve === false)}
 			<div class="panel-footer px-3">

package/src/lib/components/preview/InputControl.svelte

@@ -1,9 +1,16 @@
 <script lang="ts">
-	import type { InputLayoutItem, FileInputWidgetConfig, SupportedTypes } from '@selvajs/schemas';
+	import type {
+		InputLayoutItem,
+		FileInputWidgetConfig,
+		DynamicValueListWidgetConfig,
+		DropdownWidgetConfig,
+		SupportedTypes
+	} from '@selvajs/schemas';
 	import {
 		isNumberWidget,
 		isTextWidget,
 		isDropdownWidget,
+		isDynamicValueListWidget,
 		isCheckboxWidget,
 		isFileWidget,
 		isColorWidget
@@ -28,6 +35,8 @@
 		displayName?: string;
 		onChange: (paramId: string, value: SupportedTypes) => void;
 		disabled?: boolean;
+		/** Runtime-computed options for a dynamic value list input (name -> value). */
+		dynamicOptions?: Record<string, string>;
 	}
 
 	let {
@@ -35,7 +44,8 @@
 		value = $bindable(undefined),
 		displayName,
 		onChange,
-		disabled = false
+		disabled = false,
+		dynamicOptions
 	}: Props = $props();
 
 	const inputId = $derived(`input-${item.paramId}`);
@@ -68,6 +78,50 @@
 
 	const showRangeInLabel = $derived(isNumberWidget(item) && numberRangeHint !== null);
 
+	// Dynamic value list: computed options (from the last solve) take precedence over the
+	// author's seed list. Empty until the first solve produces options, unless a default is set.
+	const dynamicListConfig = $derived(
+		isDynamicValueListWidget(item)
+			? (item.config as DynamicValueListWidgetConfig | undefined)
+			: undefined
+	);
+	const dynamicListOptions = $derived<Record<string, string>>(
+		dynamicOptions && Object.keys(dynamicOptions).length > 0
+			? dynamicOptions
+			: (Object.fromEntries(
+					Object.entries(dynamicListConfig?.defaultOptions ?? {}).filter(
+						(entry): entry is [string, string] => entry[1] !== undefined
+					)
+				) as Record<string, string>)
+	);
+	const dynamicListHasOptions = $derived(Object.keys(dynamicListOptions).length > 0);
+	// As a dropdown config so DropdownInput/ChecklistInput can consume it unchanged.
+	const dynamicListAsDropdownConfig = $derived<DropdownWidgetConfig>({
+		options: dynamicListOptions,
+		displayAs: dynamicListConfig?.displayAs ?? 'dropdown'
+	});
+	const hideDynamicListWhenEmpty = $derived(
+		isDynamicValueListWidget(item) &&
+			!dynamicListHasOptions &&
+			(dynamicListConfig?.emptyBehavior ?? 'hide') === 'hide'
+	);
+
+	// When a dynamic value list recomputes, a previously-selected value may no longer be an
+	// available option. Prune the stale selection so the control shows a valid option (or empty)
+	// instead of rendering the orphaned raw value as its own label.
+	$effect(() => {
+		if (!isDynamicValueListWidget(item) || !dynamicListHasOptions) return;
+		const validValues = new Set(Object.values(dynamicListOptions));
+		// Route through onChange (not commit) — value is a one-way prop here, so writing it
+		// directly from an effect trips Svelte's binding-ownership check.
+		if (Array.isArray(value)) {
+			const pruned = value.filter((v) => typeof v === 'string' && validValues.has(v));
+			if (pruned.length !== value.length) onChange(item.paramId, pruned);
+		} else if (typeof value === 'string' && value && !validValues.has(value)) {
+			onChange(item.paramId, '');
+		}
+	});
+
 	function commit(newValue: SupportedTypes) {
 		value = newValue;
 		onChange(item.paramId, newValue);
@@ -83,7 +137,7 @@
 			value
 		})}
 	{/if}
-{:else}
+{:else if !hideDynamicListWhenEmpty}
 	<Field.Field>
 		<Field.Label for={inputId} class="gap-2 flex items-center">
 			{label}
@@ -152,6 +206,31 @@
 					{disabled}
 				/>
 			{/if}
+		{:else if isDynamicValueListWidget(item)}
+			{#if dynamicListHasOptions}
+				{#if dynamicListAsDropdownConfig.displayAs === 'checklist'}
+					<ChecklistInput
+						{inputId}
+						value={Array.isArray(value)
+							? (value as string[])
+							: typeof value === 'string' && value
+								? [value]
+								: []}
+						config={dynamicListAsDropdownConfig}
+						onChange={commit}
+						{disabled}
+					/>
+				{:else}
+					<DropdownInput
+						value={typeof value === 'string' ? value : ''}
+						config={dynamicListAsDropdownConfig}
+						onChange={commit}
+						{disabled}
+					/>
+				{/if}
+			{:else}
+				<p class="text-sm text-muted-foreground">No options available yet.</p>
+			{/if}
 		{:else if isFileWidget(item)}
 			{@const config = item.config as FileInputWidgetConfig}
 			<FileInput

package/src/lib/components/preview/OutputDisplay.svelte

@@ -288,49 +288,52 @@
 	{/if}
 {/snippet}
 
-<div class="gap-2 flex flex-col">
-	{@render fieldHeader()}
+<!-- Dynamic value list outputs are routing sinks (their options feed an input), not displayed. -->
+{#if item.widgetType !== 'dynamicValueList'}
+	<div class="gap-2 flex flex-col">
+		{@render fieldHeader()}
 
-	{#if item.widgetType === 'chart'}
-		<ChartOutput
-			{item}
-			value={typeof value === 'string' ? value : value != null ? JSON.stringify(value) : ''}
-		/>
-	{:else if item.widgetType === 'image'}
-		<ImageOutput {item} {value} />
-	{:else if item.widgetType === 'file'}
-		{@render fileDisplay()}
-	{:else if item.widgetType === 'number'}
-		<div class="{boxClass} flex items-center bg-muted/50 wrap-break-word">
-			{#if hasValue}
-				<span class="font-bold text-primary">{formattedValue}</span>
-			{:else}
-				{@render placeholder()}
-			{/if}
-		</div>
-	{:else if item.widgetType === 'text'}
-		<div class="group relative">
-			{#if isObjectValue}
-				<pre
-					class="{boxClass} overflow-wrap-anywhere max-h-96 overflow-auto bg-muted/10 text-foreground">{formattedValue}</pre>
-			{:else}
-				<div
-					class="{boxClass} overflow-wrap-anywhere bg-muted/10 wrap-break-word whitespace-pre-wrap text-foreground"
-				>
-					{#if hasValue}{value}{:else}{@render placeholder()}{/if}
-				</div>
-			{/if}
-			{#if hasValue}
-				<Button
-					onclick={copyToClipboard}
-					class="right-2 top-2 absolute transition-opacity {copied
-						? 'opacity-100'
-						: 'opacity-0 group-hover:opacity-100'}"
-					size="sm"
-				>
-					{copied ? 'Copied!' : 'Copy'}
-				</Button>
-			{/if}
-		</div>
-	{/if}
-</div>
+		{#if item.widgetType === 'chart'}
+			<ChartOutput
+				{item}
+				value={typeof value === 'string' ? value : value != null ? JSON.stringify(value) : ''}
+			/>
+		{:else if item.widgetType === 'image'}
+			<ImageOutput {item} {value} />
+		{:else if item.widgetType === 'file'}
+			{@render fileDisplay()}
+		{:else if item.widgetType === 'number'}
+			<div class="{boxClass} flex items-center bg-muted/50 wrap-break-word">
+				{#if hasValue}
+					<span class="font-bold text-primary">{formattedValue}</span>
+				{:else}
+					{@render placeholder()}
+				{/if}
+			</div>
+		{:else if item.widgetType === 'text'}
+			<div class="group relative">
+				{#if isObjectValue}
+					<pre
+						class="{boxClass} overflow-wrap-anywhere max-h-96 overflow-auto bg-muted/10 text-foreground">{formattedValue}</pre>
+				{:else}
+					<div
+						class="{boxClass} overflow-wrap-anywhere bg-muted/10 wrap-break-word whitespace-pre-wrap text-foreground"
+					>
+						{#if hasValue}{value}{:else}{@render placeholder()}{/if}
+					</div>
+				{/if}
+				{#if hasValue}
+					<Button
+						onclick={copyToClipboard}
+						class="right-2 top-2 absolute transition-opacity {copied
+							? 'opacity-100'
+							: 'opacity-0 group-hover:opacity-100'}"
+						size="sm"
+					>
+						{copied ? 'Copied!' : 'Copy'}
+					</Button>
+				{/if}
+			</div>
+		{/if}
+	</div>
+{/if}

package/src/lib/components/preview/TabContent.svelte

@@ -23,10 +23,20 @@
 		onValueChange: (paramId: string, value: SupportedTypes) => void;
 		inputs: SchemaInput[];
 		outputs: DiscoveredOutput[];
+		/** Computed value list options keyed by the target dynamic-value-list input id. */
+		dynamicOptions?: Record<string, Record<string, string>>;
 	}
 
-	let { tab, values, collapsedGroups, onToggleGroup, onValueChange, inputs, outputs }: Props =
-		$props();
+	let {
+		tab,
+		values,
+		collapsedGroups,
+		onToggleGroup,
+		onValueChange,
+		inputs,
+		outputs,
+		dynamicOptions = {}
+	}: Props = $props();
 
 	function getInputById(paramId: string): SchemaInput | undefined {
 		return inputs.find((i) => i.id === paramId);
@@ -49,6 +59,7 @@
 			displayName={layoutItem.displayName}
 			onChange={onValueChange}
 			disabled={visibility.disabled}
+			dynamicOptions={dynamicOptions[input.id]}
 		/>
 	{/if}
 {/snippet}

package/src/lib/components/preview/TabLayout.svelte

@@ -5,6 +5,7 @@
 	import TabBar from './TabBar.svelte';
 	import TabContent from './TabContent.svelte';
 	import { buildVisibilityMap, itemKey } from '$lib/schema/visibility-rules';
+	import { buildDynamicValueListOptions } from '$lib/schema/dynamic-value-list';
 
 	interface Props {
 		schema: UISchema;
@@ -16,13 +17,7 @@
 		requestedTabId?: string | null;
 	}
 
-	let {
-		schema,
-		values = $bindable(),
-		onValueChange,
-		panelFilter,
-		requestedTabId = null
-	}: Props = $props();
+	let { schema, values, onValueChange, panelFilter, requestedTabId = null }: Props = $props();
 
 	let activeTabId = $state('');
 	let collapsedGroups = $state<Record<string, boolean>>({});
@@ -38,6 +33,9 @@
 
 	const showTabBar = $derived(visibleTabs.length > 1);
 
+	// Computed value list options keyed by the target input id, derived from solved outputs.
+	const dynamicOptions = $derived(buildDynamicValueListOptions(schema, values));
+
 	// Tab selection
 	$effect(() => {
 		if (requestedTabId && visibleTabs.some((t) => t.id === requestedTabId)) {
@@ -104,6 +102,7 @@
 				{onValueChange}
 				inputs={schema.inputs}
 				outputs={schema.outputs}
+				{dynamicOptions}
 			/>
 		{/each}
 	</Tabs.Root>

package/src/lib/components/preview/inputs/ChecklistInput.svelte

@@ -28,7 +28,7 @@
 </script>
 
 <div class="divide-y divide-border/60 overflow-hidden rounded-md border border-input">
-	{#each Object.entries(options) as [name, expr] (expr ?? name)}
+	{#each Object.entries(options) as [name, expr] (name)}
 		{@const optionValue = expr ?? name}
 		{@const optionId = `${inputId}-${optionValue}`}
 		{@const isSelected = selected.has(optionValue)}

package/src/lib/components/preview/inputs/DropdownInput.svelte

@@ -33,7 +33,7 @@
 		{currentLabel || 'Select an option...'}
 	</Select.Trigger>
 	<Select.Content>
-		{#each Object.entries(options) as [name, expr] (expr ?? name)}
+		{#each Object.entries(options) as [name, expr] (name)}
 			<Select.Item value={expr ?? name} label={name} />
 		{/each}
 	</Select.Content>

package/src/lib/components/preview/inputs/FileInput.svelte

@@ -201,6 +201,17 @@
 			return;
 		}
 
+		// Guard the upload size client-side. The file is base64-embedded into the
+		// compute request body, so an oversize file would otherwise be rejected
+		// server-side with an opaque 413 (see COMPUTE_REQUEST_MAX_BYTES). The URL
+		// import path has the same check; keep the two in sync.
+		if (file.size > APP_DEFAULTS.FILE_UPLOAD.MAX_SIZE_BYTES) {
+			alert(
+				`File too large: ${(file.size / 1024 / 1024).toFixed(2)}MB (max ${APP_DEFAULTS.FILE_UPLOAD.MAX_SIZE_MB}MB).`
+			);
+			return;
+		}
+
 		uploadedFileName = file.name;
 
 		const reader = new FileReader();

package/src/lib/index.ts

@@ -17,9 +17,22 @@ export { default as Viewer } from './components/viewer/Viewer.svelte';
 
 // Utilities
 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
+// driver — can satisfy SolveDriver and drive a session. See CONTEXT.md.
+export {
+	createSolveSession,
+	createRequestResponseDriver,
+	type SolveSession,
+	type SolveSessionArgs,
+	type SolveDriver,
+	type SolveReporter
+} from './compute/createSolveSession.svelte';
+
 // External-input transit storage (used by routes that wire pre-step producers)
 export * from './external/storage';
 
@@ -34,5 +47,5 @@ export { randomId } from './utils/randomId';
 
 // UI-specific runtime types (not from schema)
 export type { ActionButton } from './types/actionButton';
-export type { SolveFn } from './types/solveFn';
+export type { SolveFn, SolveResult } from './types/solveFn';
 export { DEFAULT_PRESET_LABELS, type PresetLabels } from './types/presetLabels';

package/src/lib/schema/dynamic-value-list.test.ts

@@ -0,0 +1,133 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import type { UISchema } from '@selvajs/schemas';
+import { buildDynamicValueListOptions } from './dynamic-value-list';
+
+// The collector keys `values` by the ContextBake GUID. A dynamicValueList output can live in
+// schema.outputs[] OR only in the layout (a routing sink). These pin that BOTH are honoured —
+// the layout-only case is the bug where the C# collector sent the payload but the UI threw it away.
+
+const BAKE = 'bake-guid';
+const TARGET = 'target-input-guid';
+
+function schemaWith(opts: { outputs?: UISchema['outputs']; layoutItems?: unknown[] }): UISchema {
+	return {
+		outputs: opts.outputs ?? [],
+		layout: {
+			type: 'tabbed',
+			tabs: [
+				{ id: 't1', groups: [{ id: 'g1', label: 'g1', order: 0, items: opts.layoutItems ?? [] }] }
+			]
+		}
+	} as unknown as UISchema;
+}
+
+const layoutItem = (paramId: string, targetInputId: string) =>
+	({
+		id: 'li1',
+		type: 'output',
+		widgetType: 'dynamicValueList',
+		paramId,
+		config: { targetInputId }
+	}) as unknown;
+
+const payload = (targetInputId: string | null, options: Record<string, string>) => ({
+	targetInputId,
+	options
+});
+
+describe('buildDynamicValueListOptions', () => {
+	it('routes options from a schema.outputs[] source', () => {
+		const schema = schemaWith({
+			outputs: [{ id: BAKE, type: 'dynamicValueList', targetInputId: TARGET }] as never
+		});
+
+		const result = buildDynamicValueListOptions(schema, {
+			[BAKE]: payload(TARGET, { A: '1', B: '2' })
+		});
+
+		expect(result[TARGET]).toEqual({ A: '1', B: '2' });
+	});
+
+	it('routes options from a LAYOUT-only source (the dropped-data bug)', () => {
+		const schema = schemaWith({ layoutItems: [layoutItem(BAKE, TARGET)] });
+
+		const result = buildDynamicValueListOptions(schema, {
+			[BAKE]: payload(TARGET, { Sphere: '0', Box: '1' })
+		});
+
+		expect(result[TARGET]).toEqual({ Sphere: '0', Box: '1' });
+	});
+
+	it("prefers the payload's targetInputId over the schema fallback", () => {
+		const schema = schemaWith({ layoutItems: [layoutItem(BAKE, 'stale-target')] });
+
+		const result = buildDynamicValueListOptions(schema, {
+			[BAKE]: payload('live-target', { A: '1' })
+		});
+
+		expect(result['live-target']).toEqual({ A: '1' });
+		expect(result['stale-target']).toBeUndefined();
+	});
+
+	it('falls back to the schema targetInputId when the payload omits it', () => {
+		const schema = schemaWith({ layoutItems: [layoutItem(BAKE, TARGET)] });
+
+		const result = buildDynamicValueListOptions(schema, {
+			[BAKE]: payload(null, { A: '1' })
+		});
+
+		expect(result[TARGET]).toEqual({ A: '1' });
+	});
+
+	it('parses a JSON-string payload (Rhino.Compute path)', () => {
+		const schema = schemaWith({ layoutItems: [layoutItem(BAKE, TARGET)] });
+
+		const result = buildDynamicValueListOptions(schema, {
+			[BAKE]: JSON.stringify(payload(TARGET, { A: '1' }))
+		});
+
+		expect(result[TARGET]).toEqual({ A: '1' });
+	});
+
+	it('dedupes outputs[] over layout for the same id', () => {
+		const schema = schemaWith({
+			outputs: [{ id: BAKE, type: 'dynamicValueList', targetInputId: 'from-outputs' }] as never,
+			layoutItems: [layoutItem(BAKE, 'from-layout')]
+		});
+
+		// Payload omits targetInputId -> the outputs[] fallback wins (it's set last in the dedupe map).
+		const result = buildDynamicValueListOptions(schema, {
+			[BAKE]: payload(null, { A: '1' })
+		});
+
+		expect(result['from-outputs']).toEqual({ A: '1' });
+		expect(result['from-layout']).toBeUndefined();
+	});
+
+	it('ignores values with no matching source', () => {
+		const schema = schemaWith({ layoutItems: [layoutItem(BAKE, TARGET)] });
+
+		const result = buildDynamicValueListOptions(schema, {
+			'unrelated-id': payload(TARGET, { A: '1' })
+		});
+
+		expect(Object.keys(result)).toHaveLength(0);
+	});
+
+	// The SAME json file the C# DynamicValueListPayload test loads. If C# and TS stop agreeing on
+	// this shape, one side's CI goes red — that's the cross-stack drift guard.
+	it('routes the shared cross-stack golden fixture', () => {
+		const fixturePath = fileURLToPath(
+			new URL('../../../../schemas/fixtures/dynamic-value-list-payload.json', import.meta.url)
+		);
+		const fixture = JSON.parse(readFileSync(fixturePath, 'utf-8'));
+		const schema = schemaWith({ layoutItems: [layoutItem(BAKE, fixture.targetInputId)] });
+
+		const result = buildDynamicValueListOptions(schema, { [BAKE]: fixture });
+
+		expect(result[fixture.targetInputId]).toEqual(fixture.options);
+		expect(result[fixture.targetInputId]).toEqual({ Sphere: '0', Box: '1', Cone: '2' });
+	});
+});

package/src/lib/schema/dynamic-value-list.ts

@@ -0,0 +1,102 @@
+import type { UISchema, OutputDynamicValueListLayoutItem } from '@selvajs/schemas';
+import { getLayoutItems } from '@selvajs/schemas';
+
+/**
+ * The runtime payload a dynamic value list output produces, keyed by the output's id in `values`.
+ * Routed back into the dynamic value list input identified by `targetInputId`.
+ */
+export interface DynamicValueListPayload {
+	targetInputId?: string | null;
+	options?: Record<string, string>;
+}
+
+function isDynamicValueListPayload(value: unknown): value is DynamicValueListPayload {
+	return (
+		typeof value === 'object' && value !== null && ('targetInputId' in value || 'options' in value)
+	);
+}
+
+/**
+ * Normalize a raw output value into a payload object.
+ *
+ * The local/WebSocket path delivers a real object; the Rhino.Compute path delivers the
+ * component's JSON output as a string (possibly double-encoded by the compute layer), so try
+ * to parse strings before giving up.
+ */
+function coercePayload(value: unknown): DynamicValueListPayload | null {
+	if (isDynamicValueListPayload(value)) return value;
+
+	let candidate = value;
+	// Unwrap up to two layers of JSON string encoding (compute may quote the string output).
+	for (let i = 0; i < 2 && typeof candidate === 'string'; i++) {
+		try {
+			candidate = JSON.parse(candidate);
+		} catch {
+			return null;
+		}
+		if (isDynamicValueListPayload(candidate)) return candidate;
+	}
+
+	return null;
+}
+
+/** One DynVL routing source: the id keying `values`, plus the schema-side target fallback. */
+interface DynamicValueListSource {
+	id: string;
+	targetInputId?: string | null;
+}
+
+/**
+ * Every dynamicValueList output reference in the schema.
+ *
+ * Canonical location is `schema.outputs[]` — the plugin's SchemaSynchronizer enforces that every
+ * dynamicValueList layout item is mirrored there (see CanonicalizeDynamicValueListOutputs). We ALSO
+ * scan the layout purely as back-compat defense for schemas persisted by an older plugin that lacked
+ * that invariant; for current schemas the layout pass finds nothing new.
+ * Deduped by id, outputs[] winning so the canonical record's targetInputId takes precedence.
+ */
+function collectDynamicValueListSources(schema: UISchema): DynamicValueListSource[] {
+	const byId = new Map<string, DynamicValueListSource>();
+
+	for (const item of getLayoutItems(schema)) {
+		if (item.type !== 'output' || item.widgetType !== 'dynamicValueList') continue;
+		const dvl = item as OutputDynamicValueListLayoutItem;
+		if (typeof dvl.paramId !== 'string') continue;
+		byId.set(dvl.paramId, { id: dvl.paramId, targetInputId: dvl.config?.targetInputId });
+	}
+
+	for (const output of schema.outputs ?? []) {
+		if (output.type !== 'dynamicValueList') continue;
+		byId.set(output.id, { id: output.id, targetInputId: output.targetInputId });
+	}
+
+	return [...byId.values()];
+}
+
+/**
+ * Build a map of `inputId -> computed options` from the solved output values.
+ *
+ * Reads each dynamicValueList source's `{ targetInputId, options }` payload from `values` and routes
+ * the options to the targeted input. The payload's own `targetInputId` wins; the schema-side
+ * `targetInputId` is the fallback when the payload omits it.
+ */
+export function buildDynamicValueListOptions(
+	schema: UISchema,
+	values: Record<string, unknown>
+): Record<string, Record<string, string>> {
+	const result: Record<string, Record<string, string>> = {};
+
+	for (const source of collectDynamicValueListSources(schema)) {
+		const payload = coercePayload(values[source.id]);
+		if (!payload) continue;
+
+		const targetInputId = payload.targetInputId ?? source.targetInputId;
+		if (!targetInputId) continue;
+
+		if (payload.options && typeof payload.options === 'object') {
+			result[targetInputId] = payload.options;
+		}
+	}
+
+	return result;
+}