@torpor/view 1.0.2 → 1.1.0

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/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

@@ -1,5 +1,5 @@
 import { t as devContext } from "./devContext-ZNsPyOgB.mjs";
-import { a as buildStyles, c as proxyDataSymbol, i as formatText, n as fromServer, o as buildClasses, r as fromElement, s as $unwrap, t as fromWebSocket } from "./fromWebSocket-Dxc_uwm1.mjs";
+import { a as buildStyles, c as proxyDataSymbol, i as formatText, n as fromServer, o as buildClasses, r as fromElement, s as $unwrap, t as fromWebSocket } from "./fromWebSocket-CFGoMkV2.mjs";
 //#region src/render/context.ts
 const CONTEXT_SYMBOL = Symbol.for("torp.Context");
 const context = globalThis[CONTEXT_SYMBOL] ??= {
@@ -23,7 +23,8 @@ const context = globalThis[CONTEXT_SYMBOL] ??= {
 	mountEffects: [],
 	stashedEvents: [],
 	stashedAnimations: [],
-	hydrationNode: null
+	hydrationNode: null,
+	serverValues: null
 };
 //#endregion
 //#region src/render/addAnimation.ts
@@ -150,9 +151,11 @@ function checkComputed(computed) {
 */
 function checkSources(target) {
 	let haveComputed = false;
-	for (let sourceSub = target.firstSource; sourceSub !== null; sourceSub = sourceSub.nextSource) if (sourceSub.recalc) if (sourceSub.source.type === 0) return true;
-	else if (sourceSub.source.recalc) haveComputed = true;
-	else return true;
+	for (let sourceSub = target.firstSource; sourceSub !== null; sourceSub = sourceSub.nextSource) if (sourceSub.recalc) {
+		if (sourceSub.source.type === 0) return true;
+		else if (sourceSub.source.recalc) haveComputed = true;
+		else return true;
+	}
 	if (haveComputed) {
 		for (let sourceSub = target.firstSource; sourceSub !== null; sourceSub = sourceSub.nextSource) if (sourceSub.recalc && sourceSub.source.type === 1 && sourceSub.source.recalc) {
 			const oldActiveTarget = context.activeTarget;
@@ -728,13 +731,15 @@ function addFragment(fragment, parent, before, endNode, startNode) {
 //#region src/render/applyProps.ts
 function applyProps(el, props, propNamesUsed) {
 	if (props !== void 0) {
-		for (let [name, value] of Object.entries(props)) if (!propNamesUsed.includes(name)) if (name.startsWith("on")) {
-			const eventName = name.substring(2);
-			if (isDelegatedEventType(eventName)) attachDelegatedEvent(el, eventName, value);
-			else el.addEventListener(eventName, value);
-		} else $run(function setAttribute() {
-			el.setAttribute(name, value);
-		});
+		for (let [name, value] of Object.entries(props)) if (!propNamesUsed.includes(name)) {
+			if (name.startsWith("on")) {
+				const eventName = name.substring(2);
+				if (isDelegatedEventType(eventName)) attachDelegatedEvent(el, eventName, value);
+				else el.addEventListener(eventName, value);
+			} else $run(function setAttribute() {
+				el.setAttribute(name, value);
+			});
+		}
 	}
 }
 //#endregion
@@ -930,16 +935,18 @@ function firstInsideNode(anchor) {
 //#endregion
 //#region src/render/getFragment.ts
 function getFragment(document, array, index, html, ns) {
-	if (array[index] === void 0) if (ns === true) {
-		const template = document.createElementNS("http://www.w3.org/2000/svg", "template");
-		template.innerHTML = html;
-		const fragment = new DocumentFragment();
-		fragment.append(...template.childNodes);
-		array[index] = fragment;
-	} else {
-		const template = document.createElement("template");
-		template.innerHTML = html;
-		array[index] = template.content;
+	if (array[index] === void 0) {
+		if (ns === true) {
+			const template = document.createElementNS("http://www.w3.org/2000/svg", "template");
+			template.innerHTML = html;
+			const fragment = new DocumentFragment();
+			fragment.append(...template.childNodes);
+			array[index] = fragment;
+		} else {
+			const template = document.createElement("template");
+			template.innerHTML = html;
+			array[index] = template.content;
+		}
 	}
 	return array[index].cloneNode(true);
 }
@@ -970,14 +977,16 @@ function getFragment(document, array, index, html, ns) {
 *   `firstElementChild` is then an SVG element).
 */
 function getElementFragment(document, array, index, html, ns) {
-	if (array[index] === void 0) if (ns === true) {
-		const template = document.createElementNS("http://www.w3.org/2000/svg", "template");
-		template.innerHTML = html;
-		array[index] = template.firstElementChild;
-	} else {
-		const template = document.createElement("template");
-		template.innerHTML = html;
-		array[index] = template.content.firstElementChild;
+	if (array[index] === void 0) {
+		if (ns === true) {
+			const template = document.createElementNS("http://www.w3.org/2000/svg", "template");
+			template.innerHTML = html;
+			array[index] = template.firstElementChild;
+		} else {
+			const template = document.createElement("template");
+			template.innerHTML = html;
+			array[index] = template.content.firstElementChild;
+		}
 	}
 	return array[index].cloneNode(true);
 }
@@ -1538,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
@@ -2248,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
@@ -2261,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
@@ -2283,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;
@@ -2303,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;
@@ -2320,10 +2360,12 @@ function runAwait(region, anchor, renderContent, renderWith, name) {
 			const targetIndex = suspended ? 1 : 0;
 			if (targetIndex !== index) {
 				if (targetIndex === 0) attemptContent();
-				else if (!hasContent) if (renderWith !== null) renderBranch(1, renderWith);
-				else {
-					runControlBranch(region, index, 1);
-					index = 1;
+				else if (!hasContent) {
+					if (renderWith !== null) renderBranch(1, renderWith);
+					else {
+						runControlBranch(region, index, 1);
+						index = 1;
+					}
 				}
 			}
 		}
@@ -2445,6 +2487,23 @@ function runTry(region, anchor, renderTry, renderCatch, name) {
 	}, name);
 }
 //#endregion
+//#region src/render/headElement.ts
+/**
+* Gets an element from the document head matching the selector, creating and
+* appending a new one if there isn't a match. Used by the code generated for
+* a @head block, so that elements which were server rendered (or rendered by
+* a previously visited page) are adopted rather than duplicated.
+*/
+function headElement(tagName, selector) {
+	if (selector) {
+		const existing = document.head.querySelector(selector);
+		if (existing) return existing;
+	}
+	const element = document.createElement(tagName);
+	document.head.appendChild(element);
+	return element;
+}
+//#endregion
 //#region src/render/setAttribute.ts
 function setAttribute(el, name, value) {
 	if (value === false || value === void 0 || value === null) el.removeAttribute(name);
@@ -2490,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,
@@ -2546,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
@@ -2675,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
@@ -2702,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
@@ -2841,6 +2920,6 @@ function $stream(source, handler, options) {
 	});
 }
 //#endregion
-export { $async, $batch, $bind, $cache, $onmount, $peek, $pending, $refresh, $run, $stream, $unwrap, $watch, clearLayoutSlot, fillLayoutSlot, fromElement, fromServer, fromWebSocket, hydrate, mount, addElement as t_add_element, addFragment as t_add_fragment, nodeAnchor as t_anchor, addAnimation as t_animate, applyProps as t_apply_props, setAttribute as t_attribute, nodeChild as t_child, buildClasses as t_class, setDynamicElement as t_dynamic, addEvent as t_event, firstInsideNode as t_first_inside, formatText as t_fmt, getFragment as t_fragment, getElementFragment as t_fragment_el, newListItem as t_list_item, nodeNext as t_next, popRegion as t_pop_region, pushRegion as t_push_region, newRegion as t_region, rerunRegionEffects as t_rerun_region_effects, restoreHydration as t_restore_hydration, nodeRoot as t_root, nodeRootElement as t_root_el, runAwait as t_run_await, runControlBranch as t_run_branch, runControl as t_run_control, runList as t_run_list, runTry as t_run_try, saveHydration as t_save_hydration, nodeSkip as t_skip, buildStyles as t_style, unmount };
+export { $async, $batch, $bind, $cache, $onmount, $peek, $pending, $refresh, $run, $stream, $unwrap, $watch, clearLayoutSlot, fillLayoutSlot, fromElement, fromServer, fromWebSocket, hydrate, mount, addElement as t_add_element, addFragment as t_add_fragment, nodeAnchor as t_anchor, addAnimation as t_animate, applyProps as t_apply_props, setAttribute as t_attribute, nodeChild as t_child, buildClasses as t_class, setDynamicElement as t_dynamic, addEvent as t_event, firstInsideNode as t_first_inside, formatText as t_fmt, getFragment as t_fragment, getElementFragment as t_fragment_el, headElement as t_head_element, newListItem as t_list_item, nodeNext as t_next, popRegion as t_pop_region, pushRegion as t_push_region, newRegion as t_region, rerunRegionEffects as t_rerun_region_effects, restoreHydration as t_restore_hydration, nodeRoot as t_root, nodeRootElement as t_root_el, runAwait as t_run_await, runControlBranch as t_run_branch, runControl as t_run_control, runList as t_run_list, runTry as t_run_try, saveHydration as t_save_hydration, nodeSkip as t_skip, buildStyles as t_style, unmount };
 
 //# sourceMappingURL=index.mjs.map