@torpor/view 1.0.3 → 1.1.0

package/dist/dev.d.cts

@@ -1,4 +1,4 @@
-import { i as ProxySignal, n as Region, r as Computed, t as Effect } from "./Effect-COl3aRJV.cjs";
+import { i as ProxySignal, n as Region, r as Computed, t as Effect } from "./Effect-Dewn7MLc.cjs";
 //#region src/types/ProxyData.d.ts
 interface ProxyData {
   target: Record<PropertyKey, any>;

package/dist/dev.d.mts

@@ -1,4 +1,4 @@
-import { i as ProxySignal, n as Region, r as Computed, t as Effect } from "./Effect-BTKurOpr.mjs";
+import { i as ProxySignal, n as Region, r as Computed, t as Effect } from "./Effect-DazmAdyC.mjs";
 //#region src/types/ProxyData.d.ts
 interface ProxyData {
   target: Record<PropertyKey, any>;

package/dist/index.cjs

@@ -24,7 +24,8 @@ const context = globalThis[CONTEXT_SYMBOL] ??= {
 	mountEffects: [],
 	stashedEvents: [],
 	stashedAnimations: [],
-	hydrationNode: null
+	hydrationNode: null,
+	serverValues: null
 };
 //#endregion
 //#region src/render/addAnimation.ts
@@ -1547,7 +1548,7 @@ function trackProxySignal(data, key) {
 * suspend up the cache chain by tainting the active reader, and notifies the
 * nearest `@await` boundary.
 *
-* Return value (stale-while-revalidate, ASYNC.md §6.2): on a refresh suspend
+* Return value (ASYNC.md → "Stale-while-revalidate"): on a refresh suspend
 * (the computed has resolved before) returns the previously resolved value
 * held in `staleValue`, so readers keep displaying the old content instead of
 * a placeholder — an `@await` boundary thus keeps its content mounted
@@ -2257,10 +2258,23 @@ function runList(region, parent, anchor, buildItems, create, update, noWatch) {
 //#endregion
 //#region src/render/runAwait.ts
 /**
+* Comment prefix marking the embedded `source: "server"` values that the
+* server writes after a resolved boundary's anchor (`<!--t-await:[...]-->`,
+* see ASYNC.md → "Server rendering").
+*/
+const SERVER_VALUES_PREFIX = "t-await:";
+/**
 * Renders an `@await` boundary. On the first run, content is rendered
 * speculatively; if any read inside suspends (`didSuspend`), the boundary
 * discards the partial render and shows the `with` branch instead.
 *
+* Hydration of a server-resolved boundary (ASYNC.md → "Server rendering"): when the server
+* shipped resolved content, its values ride in a payload comment after the
+* anchor. The boundary renders the content branch *with* hydration enabled
+* and `$async` seeds its computeds from the payload, so the server's HTML is
+* adopted directly — no speculative render, no `with`-branch dance, no
+* fallback flash.
+*
 * Fine-grained updates: on subsequent runs the boundary only decides whether
 * to SWITCH branches. It does so from its `pending` set — the suspended
 * computeds recorded by `suspendRead` — dropping entries that resolved and
@@ -2270,7 +2284,7 @@ function runList(region, parent, anchor, buildItems, create, update, noWatch) {
 * non-suspend dependency changes inside content are left to the child
 * effects that read them — the boundary isn't re-run by them at all.
 *
-* Stale-while-revalidate (ASYNC.md §6.2): once content has been produced
+* Stale-while-revalidate (ASYNC.md): once content has been produced
 * (`hasContent`), a subsequent suspend during a refresh does NOT switch to
 * the `with` branch — the boundary keeps the stale content mounted. `$async`
 * retains the previous resolved value (`Computed.staleValue`) and
@@ -2292,6 +2306,18 @@ function runAwait(region, anchor, renderContent, renderWith, name) {
 	let first = true;
 	let hasContent = false;
 	let theEffect = null;
+	let serverValues = null;
+	if (context.hydrationNode !== null && anchor !== null) {
+		const next = anchor.nextSibling;
+		if (next !== null && isCommentNode(next) && next.data.startsWith(SERVER_VALUES_PREFIX)) {
+			try {
+				serverValues = JSON.parse(next.data.substring(8));
+			} catch {
+				serverValues = null;
+			}
+			next.remove();
+		}
+	}
 	const gen = region.generation = (region.generation ?? 0) + 1;
 	$run(function runAwait() {
 		if (region.generation !== gen) return;
@@ -2312,9 +2338,15 @@ function runAwait(region, anchor, renderContent, renderWith, name) {
 			context.awaitBoundary = boundary;
 			boundary.suspended = false;
 			const savedHydration = context.hydrationNode;
-			if (savedHydration !== null) context.hydrationNode = null;
+			const savedServerValues = context.serverValues;
+			if (serverValues !== null && savedHydration !== null) context.serverValues = {
+				values: serverValues,
+				index: 0
+			};
+			else if (savedHydration !== null) context.hydrationNode = null;
 			renderBranch(0, renderContent);
-			if (savedHydration !== null) context.hydrationNode = savedHydration;
+			context.hydrationNode = savedHydration;
+			context.serverValues = savedServerValues;
 			context.awaitBoundary = oldBoundary;
 			if (boundary.suspended && renderWith !== null) renderBranch(1, renderWith);
 			else if (!boundary.suspended) hasContent = true;
@@ -2518,10 +2550,20 @@ function $batch(fn) {
 * over the computed object), so they fire on both the initial run and every
 * recalculation — `runComputed` and `checkComputed` are unchanged.
 *
+* Hydration seeding (ASYNC.md → "Server rendering"): while hydrating the content branch of
+* a boundary whose server HTML embedded resolved `source: "server"` values,
+* `context.serverValues` is set, and this read consumes the value at the
+* current position instead of suspending. The thunk still runs — once, in
+* the background — so the getter's dependencies are tracked and later
+* dependency changes re-fetch; the embedded value wins the generation race,
+* so there's no re-fetch wait and no fallback flash.
+*
 * @param fn A thunk returning the Promise to await. Signal reads inside `fn`
 *   are tracked, so the fetch re-runs when dependencies change.
+* @param _options Accepted so the same getter source compiles into client and
+*   server builds (`source: "server"` fetches during SSR); ignored here.
 */
-function $async(fn) {
+function $async(fn, _options) {
 	if (context.registerComputed === null) throw new Error("$async must be used in a getter");
 	const computed = {
 		type: 1,
@@ -2574,6 +2616,16 @@ function $async(fn) {
 	};
 	context.registerComputed(computed);
 	runComputed(computed);
+	const serverValues = context.serverValues;
+	if (serverValues !== null && serverValues.index < serverValues.values.length) {
+		computed.generation++;
+		computed.didSuspend = false;
+		computed.didError = false;
+		computed.hasResolved = true;
+		computed.lastErrored = false;
+		computed.value = serverValues.values[serverValues.index++];
+		computed.staleValue = computed.value;
+	}
 	return computed.value;
 }
 //#endregion
@@ -2703,7 +2755,7 @@ function $onmount(fn) {
 * subscription but don't propagate taint or notify a `@await` boundary.
 * This lets `$pending` return a plain boolean without itself suspending.
 *
-* Quiet-on-refresh semantics (ASYNC.md §7.4): a suspend is *quiet* — and
+* Quiet-on-refresh semantics (ASYNC.md → "Loud vs quiet"): a suspend is *quiet* — and
 * therefore `$pending` returns `false` for it — when the computed has resolved
 * before and the re-fetch was a *silent* `$refresh(fn, { silent: true })` (a
 * bare refresh with no tracked dependency change, used for background
@@ -2730,7 +2782,7 @@ function $pending(fn) {
 //#region src/watch/$refresh.ts
 /**
 * Re-fetches the `$async` getters read inside `fn` without changing a
-* dependency. A companion to `$pending` (ASYNC.md §6.2): pull-to-refresh,
+* dependency. A companion to `$pending` (ASYNC.md): pull-to-refresh,
 * refresh buttons, refetch-on-focus, polling, retry-after-error.
 *
 * `fn` is run in a tracking context that collects every `$async` computed it

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { n as SlotRender, t as Component } from "./Component-0MH0zd-m.cjs";
 import { t as Cleanup } from "./Cleanup-D0wvGW5d.cjs";
-import { n as Region, t as Effect } from "./Effect-COl3aRJV.cjs";
-import { a as buildStyles, c as ClassValue, i as StreamSource, n as fromServer, o as StyleValue, r as fromElement, s as buildClasses, t as fromWebSocket } from "./fromWebSocket-DeB35Q4w.cjs";
+import { n as Region, t as Effect } from "./Effect-Dewn7MLc.cjs";
+import { a as StreamSource, c as buildClasses, i as fromElement, l as ClassValue, n as fromWebSocket, o as buildStyles, r as fromServer, s as StyleValue, t as AsyncOptions } from "./AsyncOptions-BtMe2PAd.cjs";
 //#region src/types/Animation.d.ts
 interface Animation {
   keyframes: Keyframe[] | PropertyIndexedKeyframes;
@@ -345,6 +345,13 @@ declare function runList(region: Region, parent: ParentNode, anchor: Node | null
  * speculatively; if any read inside suspends (`didSuspend`), the boundary
  * discards the partial render and shows the `with` branch instead.
  *
+ * Hydration of a server-resolved boundary (ASYNC.md → "Server rendering"): when the server
+ * shipped resolved content, its values ride in a payload comment after the
+ * anchor. The boundary renders the content branch *with* hydration enabled
+ * and `$async` seeds its computeds from the payload, so the server's HTML is
+ * adopted directly — no speculative render, no `with`-branch dance, no
+ * fallback flash.
+ *
  * Fine-grained updates: on subsequent runs the boundary only decides whether
  * to SWITCH branches. It does so from its `pending` set — the suspended
  * computeds recorded by `suspendRead` — dropping entries that resolved and
@@ -354,7 +361,7 @@ declare function runList(region: Region, parent: ParentNode, anchor: Node | null
  * non-suspend dependency changes inside content are left to the child
  * effects that read them — the boundary isn't re-run by them at all.
  *
- * Stale-while-revalidate (ASYNC.md §6.2): once content has been produced
+ * Stale-while-revalidate (ASYNC.md): once content has been produced
  * (`hasContent`), a subsequent suspend during a refresh does NOT switch to
  * the `with` branch — the boundary keeps the stale content mounted. `$async`
  * retains the previous resolved value (`Computed.staleValue`) and
@@ -478,10 +485,20 @@ declare function $batch<T>(fn: () => T): T;
  * over the computed object), so they fire on both the initial run and every
  * recalculation — `runComputed` and `checkComputed` are unchanged.
  *
+ * Hydration seeding (ASYNC.md → "Server rendering"): while hydrating the content branch of
+ * a boundary whose server HTML embedded resolved `source: "server"` values,
+ * `context.serverValues` is set, and this read consumes the value at the
+ * current position instead of suspending. The thunk still runs — once, in
+ * the background — so the getter's dependencies are tracked and later
+ * dependency changes re-fetch; the embedded value wins the generation race,
+ * so there's no re-fetch wait and no fallback flash.
+ *
  * @param fn A thunk returning the Promise to await. Signal reads inside `fn`
  *   are tracked, so the fetch re-runs when dependencies change.
+ * @param _options Accepted so the same getter source compiles into client and
+ *   server builds (`source: "server"` fetches during SSR); ignored here.
  */
-declare function $async<T>(fn: () => Promise<T>): T;
+declare function $async<T>(fn: () => Promise<T>, _options?: AsyncOptions): T;
 //#endregion
 //#region src/watch/$bind.d.ts
 /**
@@ -573,7 +590,7 @@ declare function $peek<T>(fn: () => T): T;
  * subscription but don't propagate taint or notify a `@await` boundary.
  * This lets `$pending` return a plain boolean without itself suspending.
  *
- * Quiet-on-refresh semantics (ASYNC.md §7.4): a suspend is *quiet* — and
+ * Quiet-on-refresh semantics (ASYNC.md → "Loud vs quiet"): a suspend is *quiet* — and
  * therefore `$pending` returns `false` for it — when the computed has resolved
  * before and the re-fetch was a *silent* `$refresh(fn, { silent: true })` (a
  * bare refresh with no tracked dependency change, used for background
@@ -603,7 +620,7 @@ interface RefreshOptions {
 }
 /**
  * Re-fetches the `$async` getters read inside `fn` without changing a
- * dependency. A companion to `$pending` (ASYNC.md §6.2): pull-to-refresh,
+ * dependency. A companion to `$pending` (ASYNC.md): pull-to-refresh,
  * refresh buttons, refetch-on-focus, polling, retry-after-error.
  *
  * `fn` is run in a tracking context that collects every `$async` computed it

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/Animation.ts","../src/render/addAnimation.ts","../src/render/addEvent.ts","../src/render/addElement.ts","../src/render/addFragment.ts","../src/render/applyProps.ts","../src/render/clearLayoutSlot.ts","../src/render/fillLayoutSlot.ts","../src/render/formatText.ts","../src/render/firstInsideNode.ts","../src/render/getFragment.ts","../src/render/getElementFragment.ts","../src/render/hydrate.ts","../src/render/mount.ts","../src/render/unmount.ts","../src/types/ListItemSpec.ts","../src/types/ListItem.ts","../src/render/newListItem.ts","../src/render/newRegion.ts","../src/render/nodeAnchor.ts","../src/render/nodeChild.ts","../src/render/nodeNext.ts","../src/render/nodeRootElement.ts","../src/render/nodeRoot.ts","../src/render/nodeSkip.ts","../src/render/popRegion.ts","../src/render/pushRegion.ts","../src/render/rerunRegionEffects.ts","../src/render/restoreHydration.ts","../src/render/runControl.ts","../src/render/runControlBranch.ts","../src/render/runList.ts","../src/render/runAwait.ts","../src/render/runTry.ts","../src/render/saveHydration.ts","../src/render/headElement.ts","../src/render/setAttribute.ts","../src/render/setDynamicElement.ts","../src/types/Bindable.ts","../src/watch/$batch.ts","../src/watch/$async.ts","../src/watch/$bind.ts","../src/watch/$cache.ts","../src/watch/$onmount.ts","../src/watch/$peek.ts","../src/watch/$pending.ts","../src/watch/$refresh.ts","../src/watch/$run.ts","../src/watch/$stream.ts","../src/watch/$unwrap.ts","../src/types/WatchOptions.ts","../src/watch/$watch.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/Animation.ts","../src/render/addAnimation.ts","../src/render/addEvent.ts","../src/render/addElement.ts","../src/render/addFragment.ts","../src/render/applyProps.ts","../src/render/clearLayoutSlot.ts","../src/render/fillLayoutSlot.ts","../src/render/formatText.ts","../src/render/firstInsideNode.ts","../src/render/getFragment.ts","../src/render/getElementFragment.ts","../src/render/hydrate.ts","../src/render/mount.ts","../src/render/unmount.ts","../src/types/ListItemSpec.ts","../src/types/ListItem.ts","../src/render/newListItem.ts","../src/render/newRegion.ts","../src/render/nodeAnchor.ts","../src/render/nodeChild.ts","../src/render/nodeNext.ts","../src/render/nodeRootElement.ts","../src/render/nodeRoot.ts","../src/render/nodeSkip.ts","../src/render/popRegion.ts","../src/render/pushRegion.ts","../src/render/rerunRegionEffects.ts","../src/render/restoreHydration.ts","../src/render/runControl.ts","../src/render/runControlBranch.ts","../src/render/runList.ts","../src/render/runAwait.ts","../src/render/runTry.ts","../src/render/saveHydration.ts","../src/render/headElement.ts","../src/render/setAttribute.ts","../src/render/setDynamicElement.ts","../src/types/Bindable.ts","../src/watch/$batch.ts","../src/watch/$async.ts","../src/watch/$bind.ts","../src/watch/$cache.ts","../src/watch/$onmount.ts","../src/watch/$peek.ts","../src/watch/$pending.ts","../src/watch/$refresh.ts","../src/watch/$run.ts","../src/watch/$stream.ts","../src/watch/$unwrap.ts","../src/types/WatchOptions.ts","../src/watch/$watch.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { n as SlotRender, t as Component } from "./Component-0MH0zd-m.mjs";
 import { t as Cleanup } from "./Cleanup-D0wvGW5d.mjs";
-import { n as Region, t as Effect } from "./Effect-BTKurOpr.mjs";
-import { a as buildStyles, c as ClassValue, i as StreamSource, n as fromServer, o as StyleValue, r as fromElement, s as buildClasses, t as fromWebSocket } from "./fromWebSocket-B52kN3-W.mjs";
+import { n as Region, t as Effect } from "./Effect-DazmAdyC.mjs";
+import { a as StreamSource, c as buildClasses, i as fromElement, l as ClassValue, n as fromWebSocket, o as buildStyles, r as fromServer, s as StyleValue, t as AsyncOptions } from "./AsyncOptions-ClS1_ERX.mjs";
 //#region src/types/Animation.d.ts
 interface Animation {
   keyframes: Keyframe[] | PropertyIndexedKeyframes;
@@ -345,6 +345,13 @@ declare function runList(region: Region, parent: ParentNode, anchor: Node | null
  * speculatively; if any read inside suspends (`didSuspend`), the boundary
  * discards the partial render and shows the `with` branch instead.
  *
+ * Hydration of a server-resolved boundary (ASYNC.md → "Server rendering"): when the server
+ * shipped resolved content, its values ride in a payload comment after the
+ * anchor. The boundary renders the content branch *with* hydration enabled
+ * and `$async` seeds its computeds from the payload, so the server's HTML is
+ * adopted directly — no speculative render, no `with`-branch dance, no
+ * fallback flash.
+ *
  * Fine-grained updates: on subsequent runs the boundary only decides whether
  * to SWITCH branches. It does so from its `pending` set — the suspended
  * computeds recorded by `suspendRead` — dropping entries that resolved and
@@ -354,7 +361,7 @@ declare function runList(region: Region, parent: ParentNode, anchor: Node | null
  * non-suspend dependency changes inside content are left to the child
  * effects that read them — the boundary isn't re-run by them at all.
  *
- * Stale-while-revalidate (ASYNC.md §6.2): once content has been produced
+ * Stale-while-revalidate (ASYNC.md): once content has been produced
  * (`hasContent`), a subsequent suspend during a refresh does NOT switch to
  * the `with` branch — the boundary keeps the stale content mounted. `$async`
  * retains the previous resolved value (`Computed.staleValue`) and
@@ -478,10 +485,20 @@ declare function $batch<T>(fn: () => T): T;
  * over the computed object), so they fire on both the initial run and every
  * recalculation — `runComputed` and `checkComputed` are unchanged.
  *
+ * Hydration seeding (ASYNC.md → "Server rendering"): while hydrating the content branch of
+ * a boundary whose server HTML embedded resolved `source: "server"` values,
+ * `context.serverValues` is set, and this read consumes the value at the
+ * current position instead of suspending. The thunk still runs — once, in
+ * the background — so the getter's dependencies are tracked and later
+ * dependency changes re-fetch; the embedded value wins the generation race,
+ * so there's no re-fetch wait and no fallback flash.
+ *
  * @param fn A thunk returning the Promise to await. Signal reads inside `fn`
  *   are tracked, so the fetch re-runs when dependencies change.
+ * @param _options Accepted so the same getter source compiles into client and
+ *   server builds (`source: "server"` fetches during SSR); ignored here.
  */
-declare function $async<T>(fn: () => Promise<T>): T;
+declare function $async<T>(fn: () => Promise<T>, _options?: AsyncOptions): T;
 //#endregion
 //#region src/watch/$bind.d.ts
 /**
@@ -573,7 +590,7 @@ declare function $peek<T>(fn: () => T): T;
  * subscription but don't propagate taint or notify a `@await` boundary.
  * This lets `$pending` return a plain boolean without itself suspending.
  *
- * Quiet-on-refresh semantics (ASYNC.md §7.4): a suspend is *quiet* — and
+ * Quiet-on-refresh semantics (ASYNC.md → "Loud vs quiet"): a suspend is *quiet* — and
  * therefore `$pending` returns `false` for it — when the computed has resolved
  * before and the re-fetch was a *silent* `$refresh(fn, { silent: true })` (a
  * bare refresh with no tracked dependency change, used for background
@@ -603,7 +620,7 @@ interface RefreshOptions {
 }
 /**
  * Re-fetches the `$async` getters read inside `fn` without changing a
- * dependency. A companion to `$pending` (ASYNC.md §6.2): pull-to-refresh,
+ * dependency. A companion to `$pending` (ASYNC.md): pull-to-refresh,
  * refresh buttons, refetch-on-focus, polling, retry-after-error.
  *
  * `fn` is run in a tracking context that collects every `$async` computed it

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/Animation.ts","../src/render/addAnimation.ts","../src/render/addEvent.ts","../src/render/addElement.ts","../src/render/addFragment.ts","../src/render/applyProps.ts","../src/render/clearLayoutSlot.ts","../src/render/fillLayoutSlot.ts","../src/render/formatText.ts","../src/render/firstInsideNode.ts","../src/render/getFragment.ts","../src/render/getElementFragment.ts","../src/render/hydrate.ts","../src/render/mount.ts","../src/render/unmount.ts","../src/types/ListItemSpec.ts","../src/types/ListItem.ts","../src/render/newListItem.ts","../src/render/newRegion.ts","../src/render/nodeAnchor.ts","../src/render/nodeChild.ts","../src/render/nodeNext.ts","../src/render/nodeRootElement.ts","../src/render/nodeRoot.ts","../src/render/nodeSkip.ts","../src/render/popRegion.ts","../src/render/pushRegion.ts","../src/render/rerunRegionEffects.ts","../src/render/restoreHydration.ts","../src/render/runControl.ts","../src/render/runControlBranch.ts","../src/render/runList.ts","../src/render/runAwait.ts","../src/render/runTry.ts","../src/render/saveHydration.ts","../src/render/headElement.ts","../src/render/setAttribute.ts","../src/render/setDynamicElement.ts","../src/types/Bindable.ts","../src/watch/$batch.ts","../src/watch/$async.ts","../src/watch/$bind.ts","../src/watch/$cache.ts","../src/watch/$onmount.ts","../src/watch/$peek.ts","../src/watch/$pending.ts","../src/watch/$refresh.ts","../src/watch/$run.ts","../src/watch/$stream.ts","../src/watch/$unwrap.ts","../src/types/WatchOptions.ts","../src/watch/$watch.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/Animation.ts","../src/render/addAnimation.ts","../src/render/addEvent.ts","../src/render/addElement.ts","../src/render/addFragment.ts","../src/render/applyProps.ts","../src/render/clearLayoutSlot.ts","../src/render/fillLayoutSlot.ts","../src/render/formatText.ts","../src/render/firstInsideNode.ts","../src/render/getFragment.ts","../src/render/getElementFragment.ts","../src/render/hydrate.ts","../src/render/mount.ts","../src/render/unmount.ts","../src/types/ListItemSpec.ts","../src/types/ListItem.ts","../src/render/newListItem.ts","../src/render/newRegion.ts","../src/render/nodeAnchor.ts","../src/render/nodeChild.ts","../src/render/nodeNext.ts","../src/render/nodeRootElement.ts","../src/render/nodeRoot.ts","../src/render/nodeSkip.ts","../src/render/popRegion.ts","../src/render/pushRegion.ts","../src/render/rerunRegionEffects.ts","../src/render/restoreHydration.ts","../src/render/runControl.ts","../src/render/runControlBranch.ts","../src/render/runList.ts","../src/render/runAwait.ts","../src/render/runTry.ts","../src/render/saveHydration.ts","../src/render/headElement.ts","../src/render/setAttribute.ts","../src/render/setDynamicElement.ts","../src/types/Bindable.ts","../src/watch/$batch.ts","../src/watch/$async.ts","../src/watch/$bind.ts","../src/watch/$cache.ts","../src/watch/$onmount.ts","../src/watch/$peek.ts","../src/watch/$pending.ts","../src/watch/$refresh.ts","../src/watch/$run.ts","../src/watch/$stream.ts","../src/watch/$unwrap.ts","../src/types/WatchOptions.ts","../src/watch/$watch.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -23,7 +23,8 @@ const context = globalThis[CONTEXT_SYMBOL] ??= {
 	mountEffects: [],
 	stashedEvents: [],
 	stashedAnimations: [],
-	hydrationNode: null
+	hydrationNode: null,
+	serverValues: null
 };
 //#endregion
 //#region src/render/addAnimation.ts
@@ -1546,7 +1547,7 @@ function trackProxySignal(data, key) {
 * suspend up the cache chain by tainting the active reader, and notifies the
 * nearest `@await` boundary.
 *
-* Return value (stale-while-revalidate, ASYNC.md §6.2): on a refresh suspend
+* Return value (ASYNC.md → "Stale-while-revalidate"): on a refresh suspend
 * (the computed has resolved before) returns the previously resolved value
 * held in `staleValue`, so readers keep displaying the old content instead of
 * a placeholder — an `@await` boundary thus keeps its content mounted
@@ -2256,10 +2257,23 @@ function runList(region, parent, anchor, buildItems, create, update, noWatch) {
 //#endregion
 //#region src/render/runAwait.ts
 /**
+* Comment prefix marking the embedded `source: "server"` values that the
+* server writes after a resolved boundary's anchor (`<!--t-await:[...]-->`,
+* see ASYNC.md → "Server rendering").
+*/
+const SERVER_VALUES_PREFIX = "t-await:";
+/**
 * Renders an `@await` boundary. On the first run, content is rendered
 * speculatively; if any read inside suspends (`didSuspend`), the boundary
 * discards the partial render and shows the `with` branch instead.
 *
+* Hydration of a server-resolved boundary (ASYNC.md → "Server rendering"): when the server
+* shipped resolved content, its values ride in a payload comment after the
+* anchor. The boundary renders the content branch *with* hydration enabled
+* and `$async` seeds its computeds from the payload, so the server's HTML is
+* adopted directly — no speculative render, no `with`-branch dance, no
+* fallback flash.
+*
 * Fine-grained updates: on subsequent runs the boundary only decides whether
 * to SWITCH branches. It does so from its `pending` set — the suspended
 * computeds recorded by `suspendRead` — dropping entries that resolved and
@@ -2269,7 +2283,7 @@ function runList(region, parent, anchor, buildItems, create, update, noWatch) {
 * non-suspend dependency changes inside content are left to the child
 * effects that read them — the boundary isn't re-run by them at all.
 *
-* Stale-while-revalidate (ASYNC.md §6.2): once content has been produced
+* Stale-while-revalidate (ASYNC.md): once content has been produced
 * (`hasContent`), a subsequent suspend during a refresh does NOT switch to
 * the `with` branch — the boundary keeps the stale content mounted. `$async`
 * retains the previous resolved value (`Computed.staleValue`) and
@@ -2291,6 +2305,18 @@ function runAwait(region, anchor, renderContent, renderWith, name) {
 	let first = true;
 	let hasContent = false;
 	let theEffect = null;
+	let serverValues = null;
+	if (context.hydrationNode !== null && anchor !== null) {
+		const next = anchor.nextSibling;
+		if (next !== null && isCommentNode(next) && next.data.startsWith(SERVER_VALUES_PREFIX)) {
+			try {
+				serverValues = JSON.parse(next.data.substring(8));
+			} catch {
+				serverValues = null;
+			}
+			next.remove();
+		}
+	}
 	const gen = region.generation = (region.generation ?? 0) + 1;
 	$run(function runAwait() {
 		if (region.generation !== gen) return;
@@ -2311,9 +2337,15 @@ function runAwait(region, anchor, renderContent, renderWith, name) {
 			context.awaitBoundary = boundary;
 			boundary.suspended = false;
 			const savedHydration = context.hydrationNode;
-			if (savedHydration !== null) context.hydrationNode = null;
+			const savedServerValues = context.serverValues;
+			if (serverValues !== null && savedHydration !== null) context.serverValues = {
+				values: serverValues,
+				index: 0
+			};
+			else if (savedHydration !== null) context.hydrationNode = null;
 			renderBranch(0, renderContent);
-			if (savedHydration !== null) context.hydrationNode = savedHydration;
+			context.hydrationNode = savedHydration;
+			context.serverValues = savedServerValues;
 			context.awaitBoundary = oldBoundary;
 			if (boundary.suspended && renderWith !== null) renderBranch(1, renderWith);
 			else if (!boundary.suspended) hasContent = true;
@@ -2517,10 +2549,20 @@ function $batch(fn) {
 * over the computed object), so they fire on both the initial run and every
 * recalculation — `runComputed` and `checkComputed` are unchanged.
 *
+* Hydration seeding (ASYNC.md → "Server rendering"): while hydrating the content branch of
+* a boundary whose server HTML embedded resolved `source: "server"` values,
+* `context.serverValues` is set, and this read consumes the value at the
+* current position instead of suspending. The thunk still runs — once, in
+* the background — so the getter's dependencies are tracked and later
+* dependency changes re-fetch; the embedded value wins the generation race,
+* so there's no re-fetch wait and no fallback flash.
+*
 * @param fn A thunk returning the Promise to await. Signal reads inside `fn`
 *   are tracked, so the fetch re-runs when dependencies change.
+* @param _options Accepted so the same getter source compiles into client and
+*   server builds (`source: "server"` fetches during SSR); ignored here.
 */
-function $async(fn) {
+function $async(fn, _options) {
 	if (context.registerComputed === null) throw new Error("$async must be used in a getter");
 	const computed = {
 		type: 1,
@@ -2573,6 +2615,16 @@ function $async(fn) {
 	};
 	context.registerComputed(computed);
 	runComputed(computed);
+	const serverValues = context.serverValues;
+	if (serverValues !== null && serverValues.index < serverValues.values.length) {
+		computed.generation++;
+		computed.didSuspend = false;
+		computed.didError = false;
+		computed.hasResolved = true;
+		computed.lastErrored = false;
+		computed.value = serverValues.values[serverValues.index++];
+		computed.staleValue = computed.value;
+	}
 	return computed.value;
 }
 //#endregion
@@ -2702,7 +2754,7 @@ function $onmount(fn) {
 * subscription but don't propagate taint or notify a `@await` boundary.
 * This lets `$pending` return a plain boolean without itself suspending.
 *
-* Quiet-on-refresh semantics (ASYNC.md §7.4): a suspend is *quiet* — and
+* Quiet-on-refresh semantics (ASYNC.md → "Loud vs quiet"): a suspend is *quiet* — and
 * therefore `$pending` returns `false` for it — when the computed has resolved
 * before and the re-fetch was a *silent* `$refresh(fn, { silent: true })` (a
 * bare refresh with no tracked dependency change, used for background
@@ -2729,7 +2781,7 @@ function $pending(fn) {
 //#region src/watch/$refresh.ts
 /**
 * Re-fetches the `$async` getters read inside `fn` without changing a
-* dependency. A companion to `$pending` (ASYNC.md §6.2): pull-to-refresh,
+* dependency. A companion to `$pending` (ASYNC.md): pull-to-refresh,
 * refresh buttons, refetch-on-focus, polling, retry-after-error.
 *
 * `fn` is run in a tracking context that collects every `$async` computed it