@pyreon/runtime-server 0.1.0

package/lib/index.js

@@ -0,0 +1,318 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ForSymbol, Fragment, Suspense, runWithHooks, setContextStackProvider } from "@pyreon/core";
+
+//#region src/index.ts
+/**
+* @pyreon/runtime-server — SSR/SSG renderer for Pyreon.
+*
+* Walks a VNode tree and produces HTML strings.
+* Signal accessors (reactive getters `() => value`) are called synchronously
+* to snapshot their current value — no effects are set up on the server.
+*
+* Async components (`async function Component()`) are fully supported:
+* renderToString will await them before continuing the tree walk.
+*
+* API:
+*   renderToString(vnode)   → Promise<string>
+*   renderToStream(vnode)   → ReadableStream<string>
+*/
+const _streamCtxAls = new AsyncLocalStorage();
+const _contextAls = new AsyncLocalStorage();
+const _fallbackStack = [];
+setContextStackProvider(() => _contextAls.getStore() ?? _fallbackStack);
+const _storeAls = new AsyncLocalStorage();
+let _storeIsolationActive = false;
+/**
+* Wire up per-request store isolation.
+* Call once at server startup, passing a `setStoreRegistryProvider` function.
+*
+* @example
+* import { configureStoreIsolation } from "@pyreon/runtime-server"
+* configureStoreIsolation(setStoreRegistryProvider)
+*/
+function configureStoreIsolation(setStoreRegistryProvider) {
+	setStoreRegistryProvider(() => _storeAls.getStore() ?? /* @__PURE__ */ new Map());
+	_storeIsolationActive = true;
+}
+/** Wrap a function call in a fresh store registry (no-op if isolation not configured). */
+function withStoreContext(fn) {
+	if (!_storeIsolationActive) return fn();
+	return _storeAls.run(/* @__PURE__ */ new Map(), fn);
+}
+/** Render a VNode tree to an HTML string. Supports async component functions. */
+async function renderToString(root) {
+	if (root === null) return "";
+	return withStoreContext(() => _contextAls.run([], () => renderNode(root)));
+}
+/**
+* Run an async function with a fresh, isolated context stack and store registry.
+* Useful when you need to call Pyreon APIs (e.g. useHead, prefetchLoaderData)
+* outside of renderToString but still want per-request isolation.
+*/
+function runWithRequestContext(fn) {
+	return withStoreContext(() => _contextAls.run([], fn));
+}
+/**
+* Render a VNode tree to a Web-standard ReadableStream of HTML chunks.
+*
+* True progressive streaming: HTML is flushed to the client as soon as each
+* node is ready. Synchronous subtrees are enqueued immediately; async component
+* boundaries are awaited in-order and their output is enqueued as it resolves.
+*
+* Suspense boundaries are streamed out-of-order: the fallback is emitted
+* immediately, and the resolved children are sent as a `<template>` + inline
+* swap script once ready — without blocking the rest of the page.
+*
+* Each renderToStream call gets its own isolated ALS context stack.
+*/
+function renderToStream(root) {
+	return new ReadableStream({ start(controller) {
+		const enqueue = (chunk) => controller.enqueue(chunk);
+		let bid = 0;
+		const ctx = {
+			pending: [],
+			nextId: () => bid++,
+			mainEnqueue: enqueue
+		};
+		return withStoreContext(() => _contextAls.run([], () => _streamCtxAls.run(ctx, async () => {
+			await streamNode(root, enqueue);
+			while (ctx.pending.length > 0) await Promise.all(ctx.pending.splice(0));
+			controller.close();
+		}).catch((err) => controller.error(err))));
+	} });
+}
+async function streamVNode(vnode, enqueue) {
+	if (vnode.type === Fragment) {
+		for (const child of vnode.children) await streamNode(child, enqueue);
+		return;
+	}
+	if (vnode.type === ForSymbol) {
+		const { each, children } = vnode.props;
+		enqueue("<!--pyreon-for-->");
+		for (const item of each()) await streamNode(children(item), enqueue);
+		enqueue("<!--/pyreon-for-->");
+		return;
+	}
+	if (typeof vnode.type === "function") {
+		await streamComponentNode(vnode, enqueue);
+		return;
+	}
+	await streamElementNode(vnode, enqueue);
+}
+async function streamComponentNode(vnode, enqueue) {
+	if (vnode.type === Suspense) {
+		await streamSuspenseBoundary(vnode, enqueue);
+		return;
+	}
+	const { vnode: output } = runWithHooks(vnode.type, mergeChildrenIntoProps(vnode));
+	const resolved = output instanceof Promise ? await output : output;
+	if (resolved !== null) await streamNode(resolved, enqueue);
+}
+async function streamElementNode(vnode, enqueue) {
+	const tag = vnode.type;
+	let open = `<${tag}`;
+	for (const [key, value] of Object.entries(vnode.props)) {
+		const attr = renderProp(key, value);
+		if (attr) open += ` ${attr}`;
+	}
+	if (isVoidElement(tag)) {
+		enqueue(`${open} />`);
+		return;
+	}
+	enqueue(`${open}>`);
+	for (const child of vnode.children) await streamNode(child, enqueue);
+	enqueue(`</${tag}>`);
+}
+async function streamNode(node, enqueue) {
+	if (typeof node === "function") return streamNode(node(), enqueue);
+	if (node == null || node === false) return;
+	if (typeof node === "string") {
+		enqueue(escapeHtml(node));
+		return;
+	}
+	if (typeof node === "number" || typeof node === "boolean") {
+		enqueue(String(node));
+		return;
+	}
+	if (Array.isArray(node)) {
+		for (const child of node) await streamNode(child, enqueue);
+		return;
+	}
+	await streamVNode(node, enqueue);
+}
+const SUSPENSE_SWAP_FN = "<script>function __NS(s,t){var e=document.getElementById(s),l=document.getElementById(t);if(e&&l){e.replaceWith(l.content.cloneNode(!0));l.remove()}}<\/script>";
+/**
+* Stream a Suspense boundary: emit fallback immediately, then resolve children
+* asynchronously and emit them as a `<template>` + client-side swap.
+*
+* The actual children HTML is buffered until fully resolved, then emitted to the
+* main stream enqueue so it always arrives after the fallback placeholder.
+*/
+async function streamSuspenseBoundary(vnode, enqueue) {
+	const ctx = _streamCtxAls.getStore();
+	const { fallback, children } = vnode.props;
+	if (!ctx) {
+		const { vnode: output } = runWithHooks(Suspense, vnode.props);
+		if (output !== null) await streamNode(output, enqueue);
+		return;
+	}
+	const id = ctx.nextId();
+	const { mainEnqueue } = ctx;
+	if (id === 0) mainEnqueue(SUSPENSE_SWAP_FN);
+	mainEnqueue(`<div id="pyreon-s-${id}">`);
+	await streamNode(fallback ?? null, enqueue);
+	mainEnqueue("</div>");
+	const ctxStore = _contextAls.getStore() ?? [];
+	ctx.pending.push(_contextAls.run(ctxStore, async () => {
+		try {
+			const buf = [];
+			await streamNode(children ?? null, (s) => buf.push(s));
+			mainEnqueue(`<template id="pyreon-t-${id}">${buf.join("")}</template>`);
+			mainEnqueue(`<script>__NS("pyreon-s-${id}","pyreon-t-${id}")<\/script>`);
+		} catch (_err) {}
+	}));
+}
+async function renderNode(node) {
+	if (typeof node === "function") return renderNode(node());
+	if (node == null || node === false) return "";
+	if (typeof node === "string") return escapeHtml(node);
+	if (typeof node === "number" || typeof node === "boolean") return String(node);
+	if (Array.isArray(node)) return (await Promise.all(node.map((n) => renderNode(n)))).join("");
+	const vnode = node;
+	if (vnode.type === Fragment) return renderChildren(vnode.children);
+	if (vnode.type === ForSymbol) {
+		const { each, children } = vnode.props;
+		return `<!--pyreon-for-->${(await Promise.all(each().map((item) => renderNode(children(item))))).join("")}<!--/pyreon-for-->`;
+	}
+	if (typeof vnode.type === "function") return renderComponent(vnode);
+	return renderElement(vnode);
+}
+async function renderChildren(children) {
+	return (await Promise.all(children.map((c) => renderNode(c)))).join("");
+}
+async function renderComponent(vnode) {
+	const { vnode: output } = runWithHooks(vnode.type, mergeChildrenIntoProps(vnode));
+	if (output instanceof Promise) {
+		const resolved = await output;
+		if (resolved === null) return "";
+		return renderNode(resolved);
+	}
+	if (output === null) return "";
+	return renderNode(output);
+}
+async function renderElement(vnode) {
+	const tag = vnode.type;
+	let html = `<${tag}`;
+	for (const [key, value] of Object.entries(vnode.props)) {
+		const attr = renderProp(key, value);
+		if (attr) html += ` ${attr}`;
+	}
+	if (isVoidElement(tag)) {
+		html += " />";
+		return html;
+	}
+	html += ">";
+	for (const child of vnode.children) html += await renderNode(child);
+	html += `</${tag}>`;
+	return html;
+}
+const SSR_URL_ATTRS = new Set([
+	"href",
+	"src",
+	"action",
+	"formaction",
+	"poster",
+	"cite",
+	"data"
+]);
+const SSR_UNSAFE_URL_RE = /^\s*(?:javascript|data):/i;
+function renderPropSkipped(key) {
+	if (key === "key" || key === "ref" || key === "n-show") return true;
+	if (key.startsWith("n-")) return true;
+	if (/^on[A-Z]/.test(key)) return true;
+	return false;
+}
+function renderPropValue(key, value) {
+	if (value === null || value === void 0 || value === false) return null;
+	if (value === true) return escapeHtml(toAttrName(key));
+	if (key === "class") {
+		const cls = normalizeClass(value);
+		return cls ? `class="${escapeHtml(cls)}"` : null;
+	}
+	if (key === "style") {
+		const style = normalizeStyle(value);
+		return style ? `style="${escapeHtml(style)}"` : null;
+	}
+	return `${escapeHtml(toAttrName(key))}="${escapeHtml(String(value))}"`;
+}
+function renderProp(key, value) {
+	if (renderPropSkipped(key)) return null;
+	if (typeof value === "function") return renderProp(key, value());
+	if (SSR_URL_ATTRS.has(key) && typeof value === "string" && SSR_UNSAFE_URL_RE.test(value)) return null;
+	return renderPropValue(key, value);
+}
+const VOID_ELEMENTS = new Set([
+	"area",
+	"base",
+	"br",
+	"col",
+	"embed",
+	"hr",
+	"img",
+	"input",
+	"link",
+	"meta",
+	"param",
+	"source",
+	"track",
+	"wbr"
+]);
+function isVoidElement(tag) {
+	return VOID_ELEMENTS.has(tag.toLowerCase());
+}
+/** camelCase prop → kebab-case HTML attribute (e.g. className → class, htmlFor → for) */
+function toAttrName(key) {
+	if (key === "className") return "class";
+	if (key === "htmlFor") return "for";
+	return key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+function normalizeClass(value) {
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.filter(Boolean).join(" ");
+	if (typeof value === "object" && value !== null) return Object.entries(value).filter(([, v]) => v).map(([k]) => k).join(" ");
+	return "";
+}
+function normalizeStyle(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "object" && value !== null) return Object.entries(value).map(([k, v]) => `${toKebab(k)}: ${v}`).join("; ");
+	return "";
+}
+function toKebab(str) {
+	return str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+const ESCAPE_MAP = {
+	"&": "&amp;",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;",
+	"'": "&#39;"
+};
+function escapeHtml(str) {
+	return str.replace(/[&<>"']/g, (c) => ESCAPE_MAP[c] ?? c);
+}
+/**
+* Merge vnode.children into props.children for component rendering.
+* Matches the behavior of mount.ts and hydrate.ts so components can
+* access children passed via h(Comp, props, child1, child2).
+*/
+function mergeChildrenIntoProps(vnode) {
+	if (vnode.children.length > 0 && vnode.props.children === void 0) return {
+		...vnode.props,
+		children: vnode.children.length === 1 ? vnode.children[0] : vnode.children
+	};
+	return vnode.props;
+}
+
+//#endregion
+export { configureStoreIsolation, renderToStream, renderToString, runWithRequestContext };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @pyreon/runtime-server — SSR/SSG renderer for Pyreon.\n *\n * Walks a VNode tree and produces HTML strings.\n * Signal accessors (reactive getters `() => value`) are called synchronously\n * to snapshot their current value — no effects are set up on the server.\n *\n * Async components (`async function Component()`) are fully supported:\n * renderToString will await them before continuing the tree walk.\n *\n * API:\n *   renderToString(vnode)   → Promise<string>\n *   renderToStream(vnode)   → ReadableStream<string>\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\"\nimport type { ComponentFn, ForProps, VNode, VNodeChild } from \"@pyreon/core\"\nimport { ForSymbol, Fragment, runWithHooks, Suspense, setContextStackProvider } from \"@pyreon/core\"\n\n// ─── Streaming Suspense context ───────────────────────────────────────────────\n// Tracks in-flight async Suspense boundary resolutions within a single stream.\n\ninterface StreamCtx {\n  pending: Promise<void>[]\n  nextId: () => number\n  mainEnqueue: (s: string) => void\n}\n\nconst _streamCtxAls = new AsyncLocalStorage<StreamCtx>()\n\n// ─── Concurrent SSR context isolation ────────────────────────────────────────\n// Each renderToString call runs in its own ALS store (a fresh empty stack[]).\n// Concurrent requests never share context frames.\n\nconst _contextAls = new AsyncLocalStorage<Map<symbol, unknown>[]>()\nconst _fallbackStack: Map<symbol, unknown>[] = []\n\nsetContextStackProvider(() => _contextAls.getStore() ?? _fallbackStack)\n\n// ─── Store isolation (optional) ───────────────────────────────────────────────\n// A second ALS isolates store registries between concurrent requests.\n// Activated only when the user calls configureStoreIsolation().\n\nconst _storeAls = new AsyncLocalStorage<Map<string, unknown>>()\nlet _storeIsolationActive = false\n\n/**\n * Wire up per-request store isolation.\n * Call once at server startup, passing a `setStoreRegistryProvider` function.\n *\n * @example\n * import { configureStoreIsolation } from \"@pyreon/runtime-server\"\n * configureStoreIsolation(setStoreRegistryProvider)\n */\nexport function configureStoreIsolation(\n  setStoreRegistryProvider: (fn: () => Map<string, unknown>) => void,\n): void {\n  setStoreRegistryProvider(() => _storeAls.getStore() ?? new Map())\n  _storeIsolationActive = true\n}\n\n/** Wrap a function call in a fresh store registry (no-op if isolation not configured). */\nfunction withStoreContext<T>(fn: () => T): T {\n  if (!_storeIsolationActive) return fn()\n  return _storeAls.run(new Map(), fn)\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/** Render a VNode tree to an HTML string. Supports async component functions. */\nexport async function renderToString(root: VNode | null): Promise<string> {\n  if (root === null) return \"\"\n  // Each call gets a fresh isolated context stack and (optionally) store registry\n  return withStoreContext(() => _contextAls.run([], () => renderNode(root)))\n}\n\n/**\n * Run an async function with a fresh, isolated context stack and store registry.\n * Useful when you need to call Pyreon APIs (e.g. useHead, prefetchLoaderData)\n * outside of renderToString but still want per-request isolation.\n */\nexport function runWithRequestContext<T>(fn: () => Promise<T>): Promise<T> {\n  return withStoreContext(() => _contextAls.run([], fn))\n}\n\n/**\n * Render a VNode tree to a Web-standard ReadableStream of HTML chunks.\n *\n * True progressive streaming: HTML is flushed to the client as soon as each\n * node is ready. Synchronous subtrees are enqueued immediately; async component\n * boundaries are awaited in-order and their output is enqueued as it resolves.\n *\n * Suspense boundaries are streamed out-of-order: the fallback is emitted\n * immediately, and the resolved children are sent as a `<template>` + inline\n * swap script once ready — without blocking the rest of the page.\n *\n * Each renderToStream call gets its own isolated ALS context stack.\n */\nexport function renderToStream(root: VNode | null): ReadableStream<string> {\n  return new ReadableStream<string>({\n    start(controller) {\n      const enqueue = (chunk: string) => controller.enqueue(chunk)\n      let bid = 0\n      const ctx: StreamCtx = {\n        pending: [],\n        nextId: () => bid++,\n        mainEnqueue: enqueue,\n      }\n      return withStoreContext(() =>\n        _contextAls.run([], () =>\n          _streamCtxAls\n            .run(ctx, async () => {\n              await streamNode(root, enqueue)\n              // Drain all pending Suspense resolutions (may spawn nested ones)\n              while (ctx.pending.length > 0) {\n                await Promise.all(ctx.pending.splice(0))\n              }\n              controller.close()\n            })\n            .catch((err) => controller.error(err)),\n        ),\n      )\n    },\n  })\n}\n\n// ─── Streaming renderer ───────────────────────────────────────────────────────\n\nasync function streamVNode(vnode: VNode, enqueue: (s: string) => void): Promise<void> {\n  if (vnode.type === Fragment) {\n    for (const child of vnode.children) await streamNode(child, enqueue)\n    return\n  }\n\n  if (vnode.type === (ForSymbol as unknown as string)) {\n    const { each, children } = vnode.props as unknown as ForProps<unknown>\n    enqueue(\"<!--pyreon-for-->\")\n    for (const item of each()) await streamNode(children(item) as VNodeChild, enqueue)\n    enqueue(\"<!--/pyreon-for-->\")\n    return\n  }\n\n  if (typeof vnode.type === \"function\") {\n    await streamComponentNode(vnode, enqueue)\n    return\n  }\n\n  await streamElementNode(vnode, enqueue)\n}\n\nasync function streamComponentNode(vnode: VNode, enqueue: (s: string) => void): Promise<void> {\n  if (vnode.type === Suspense) {\n    await streamSuspenseBoundary(vnode, enqueue)\n    return\n  }\n  const { vnode: output } = runWithHooks(vnode.type as ComponentFn, mergeChildrenIntoProps(vnode))\n  const resolved = output instanceof Promise ? await output : output\n  if (resolved !== null) await streamNode(resolved, enqueue)\n}\n\nasync function streamElementNode(vnode: VNode, enqueue: (s: string) => void): Promise<void> {\n  const tag = vnode.type as string\n  let open = `<${tag}`\n  for (const [key, value] of Object.entries(vnode.props)) {\n    const attr = renderProp(key, value)\n    if (attr) open += ` ${attr}`\n  }\n  if (isVoidElement(tag)) {\n    enqueue(`${open} />`)\n    return\n  }\n  enqueue(`${open}>`)\n  for (const child of vnode.children) await streamNode(child, enqueue)\n  enqueue(`</${tag}>`)\n}\n\nasync function streamNode(\n  node: VNodeChild | null | (() => VNodeChild),\n  enqueue: (s: string) => void,\n): Promise<void> {\n  if (typeof node === \"function\") {\n    return streamNode((node as () => VNodeChild)(), enqueue)\n  }\n  if (node == null || node === false) return\n  if (typeof node === \"string\") {\n    enqueue(escapeHtml(node))\n    return\n  }\n  if (typeof node === \"number\" || typeof node === \"boolean\") {\n    enqueue(String(node))\n    return\n  }\n  if (Array.isArray(node)) {\n    for (const child of node) await streamNode(child, enqueue)\n    return\n  }\n\n  await streamVNode(node as VNode, enqueue)\n}\n\n// Inline swap helper emitted once per stream, before the first <template>\nconst SUSPENSE_SWAP_FN =\n  \"<script>function __NS(s,t){var e=document.getElementById(s),l=document.getElementById(t);\" +\n  \"if(e&&l){e.replaceWith(l.content.cloneNode(!0));l.remove()}}</script>\"\n\n/**\n * Stream a Suspense boundary: emit fallback immediately, then resolve children\n * asynchronously and emit them as a `<template>` + client-side swap.\n *\n * The actual children HTML is buffered until fully resolved, then emitted to the\n * main stream enqueue so it always arrives after the fallback placeholder.\n */\nasync function streamSuspenseBoundary(vnode: VNode, enqueue: (s: string) => void): Promise<void> {\n  const ctx = _streamCtxAls.getStore()\n  const { fallback, children } = vnode.props as { fallback: VNodeChild; children?: VNodeChild }\n\n  // No streaming context (e.g. called from renderToString) — render children inline\n  if (!ctx) {\n    const { vnode: output } = runWithHooks(Suspense as ComponentFn, vnode.props)\n    if (output !== null) await streamNode(output, enqueue)\n    return\n  }\n\n  const id = ctx.nextId()\n  const { mainEnqueue } = ctx\n\n  // Emit the swap helper function once (before first use)\n  if (id === 0) mainEnqueue(SUSPENSE_SWAP_FN)\n\n  // Stream the fallback synchronously (no await on children)\n  mainEnqueue(`<div id=\"pyreon-s-${id}\">`)\n  await streamNode(fallback ?? null, enqueue)\n  mainEnqueue(\"</div>\")\n\n  // Capture the context store for the async resolution so it inherits context\n  const ctxStore = _contextAls.getStore() ?? []\n\n  // Queue async resolution — runs in parallel, emits to main stream when done\n  // Errors are caught per-boundary so one failing Suspense doesn't abort the stream.\n  ctx.pending.push(\n    _contextAls.run(ctxStore, async () => {\n      try {\n        const buf: string[] = []\n        await streamNode(children ?? null, (s) => buf.push(s))\n        mainEnqueue(`<template id=\"pyreon-t-${id}\">${buf.join(\"\")}</template>`)\n        mainEnqueue(`<script>__NS(\"pyreon-s-${id}\",\"pyreon-t-${id}\")</script>`)\n      } catch (_err) {\n        // Fallback stays visible — no swap script emitted\n      }\n    }),\n  )\n}\n\n// ─── Core renderer ───────────────────────────────────────────────────────────\n\nasync function renderNode(node: VNodeChild | (() => VNodeChild)): Promise<string> {\n  // Reactive accessor — call it synchronously (snapshot)\n  if (typeof node === \"function\") {\n    return renderNode((node as () => VNodeChild)())\n  }\n\n  if (node == null || node === false) return \"\"\n\n  if (typeof node === \"string\") return escapeHtml(node)\n  if (typeof node === \"number\" || typeof node === \"boolean\") return String(node)\n\n  if (Array.isArray(node)) {\n    const parts = await Promise.all(node.map((n) => renderNode(n)))\n    return parts.join(\"\")\n  }\n\n  const vnode = node as VNode\n\n  if (vnode.type === Fragment) {\n    return renderChildren(vnode.children)\n  }\n\n  if (vnode.type === (ForSymbol as unknown as string)) {\n    const { each, children } = vnode.props as unknown as ForProps<unknown>\n    const parts = await Promise.all(each().map((item) => renderNode(children(item) as VNodeChild)))\n    // Hydration markers so the client can claim existing For-rendered children\n    return `<!--pyreon-for-->${parts.join(\"\")}<!--/pyreon-for-->`\n  }\n\n  if (typeof vnode.type === \"function\") {\n    return renderComponent(vnode as VNode & { type: ComponentFn })\n  }\n\n  return renderElement(vnode)\n}\n\nasync function renderChildren(children: VNodeChild[]): Promise<string> {\n  const parts = await Promise.all(children.map((c) => renderNode(c)))\n  return parts.join(\"\")\n}\n\nasync function renderComponent(vnode: VNode & { type: ComponentFn }): Promise<string> {\n  const { vnode: output } = runWithHooks(vnode.type, mergeChildrenIntoProps(vnode))\n\n  // Async component function (async function Component()) — await the promise\n  if (output instanceof Promise) {\n    const resolved = await output\n    if (resolved === null) return \"\"\n    return renderNode(resolved)\n  }\n\n  if (output === null) return \"\"\n  return renderNode(output)\n}\n\nasync function renderElement(vnode: VNode): Promise<string> {\n  const tag = vnode.type as string\n  let html = `<${tag}`\n\n  for (const [key, value] of Object.entries(vnode.props)) {\n    const attr = renderProp(key, value)\n    if (attr) html += ` ${attr}`\n  }\n\n  if (isVoidElement(tag)) {\n    html += \" />\"\n    return html\n  }\n\n  html += \">\"\n\n  for (const child of vnode.children) {\n    html += await renderNode(child)\n  }\n\n  html += `</${tag}>`\n  return html\n}\n\nconst SSR_URL_ATTRS = new Set([\"href\", \"src\", \"action\", \"formaction\", \"poster\", \"cite\", \"data\"])\nconst SSR_UNSAFE_URL_RE = /^\\s*(?:javascript|data):/i\n\nfunction renderPropSkipped(key: string): boolean {\n  if (key === \"key\" || key === \"ref\" || key === \"n-show\") return true\n  if (key.startsWith(\"n-\")) return true\n  if (/^on[A-Z]/.test(key)) return true\n  return false\n}\n\nfunction renderPropValue(key: string, value: unknown): string | null {\n  if (value === null || value === undefined || value === false) return null\n  if (value === true) return escapeHtml(toAttrName(key))\n\n  if (key === \"class\") {\n    const cls = normalizeClass(value)\n    return cls ? `class=\"${escapeHtml(cls)}\"` : null\n  }\n\n  if (key === \"style\") {\n    const style = normalizeStyle(value)\n    return style ? `style=\"${escapeHtml(style)}\"` : null\n  }\n\n  return `${escapeHtml(toAttrName(key))}=\"${escapeHtml(String(value))}\"`\n}\n\nfunction renderProp(key: string, value: unknown): string | null {\n  if (renderPropSkipped(key)) return null\n\n  if (typeof value === \"function\") {\n    return renderProp(key, (value as () => unknown)())\n  }\n\n  if (SSR_URL_ATTRS.has(key) && typeof value === \"string\" && SSR_UNSAFE_URL_RE.test(value)) {\n    return null\n  }\n\n  return renderPropValue(key, value)\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nconst VOID_ELEMENTS = new Set([\n  \"area\",\n  \"base\",\n  \"br\",\n  \"col\",\n  \"embed\",\n  \"hr\",\n  \"img\",\n  \"input\",\n  \"link\",\n  \"meta\",\n  \"param\",\n  \"source\",\n  \"track\",\n  \"wbr\",\n])\n\nfunction isVoidElement(tag: string): boolean {\n  return VOID_ELEMENTS.has(tag.toLowerCase())\n}\n\n/** camelCase prop → kebab-case HTML attribute (e.g. className → class, htmlFor → for) */\nfunction toAttrName(key: string): string {\n  if (key === \"className\") return \"class\"\n  if (key === \"htmlFor\") return \"for\"\n  return key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)\n}\n\nfunction normalizeClass(value: unknown): string {\n  if (typeof value === \"string\") return value\n  if (Array.isArray(value)) return value.filter(Boolean).join(\" \")\n  if (typeof value === \"object\" && value !== null) {\n    return Object.entries(value as Record<string, unknown>)\n      .filter(([, v]) => v)\n      .map(([k]) => k)\n      .join(\" \")\n  }\n  return \"\"\n}\n\nfunction normalizeStyle(value: unknown): string {\n  if (typeof value === \"string\") return value\n  if (typeof value === \"object\" && value !== null) {\n    return Object.entries(value as Record<string, unknown>)\n      .map(([k, v]) => `${toKebab(k)}: ${v}`)\n      .join(\"; \")\n  }\n  return \"\"\n}\n\nfunction toKebab(str: string): string {\n  return str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)\n}\n\nconst ESCAPE_MAP: Record<string, string> = {\n  \"&\": \"&amp;\",\n  \"<\": \"&lt;\",\n  \">\": \"&gt;\",\n  '\"': \"&quot;\",\n  \"'\": \"&#39;\",\n}\n\nfunction escapeHtml(str: string): string {\n  return str.replace(/[&<>\"']/g, (c) => ESCAPE_MAP[c] ?? c)\n}\n\n/**\n * Merge vnode.children into props.children for component rendering.\n * Matches the behavior of mount.ts and hydrate.ts so components can\n * access children passed via h(Comp, props, child1, child2).\n */\nfunction mergeChildrenIntoProps(vnode: VNode): Record<string, unknown> {\n  if (\n    vnode.children.length > 0 &&\n    (vnode.props as Record<string, unknown>).children === undefined\n  ) {\n    return {\n      ...vnode.props,\n      children: vnode.children.length === 1 ? vnode.children[0] : vnode.children,\n    }\n  }\n  return vnode.props as Record<string, unknown>\n}\n"],"mappings":"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"}

package/lib/types/index.d.ts

@@ -0,0 +1,298 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ForSymbol, Fragment, Suspense, runWithHooks, setContextStackProvider } from "@pyreon/core";
+
+//#region src/index.ts
+/**
+* @pyreon/runtime-server — SSR/SSG renderer for Pyreon.
+*
+* Walks a VNode tree and produces HTML strings.
+* Signal accessors (reactive getters `() => value`) are called synchronously
+* to snapshot their current value — no effects are set up on the server.
+*
+* Async components (`async function Component()`) are fully supported:
+* renderToString will await them before continuing the tree walk.
+*
+* API:
+*   renderToString(vnode)   → Promise<string>
+*   renderToStream(vnode)   → ReadableStream<string>
+*/
+
+/**
+* Wire up per-request store isolation.
+* Call once at server startup, passing a `setStoreRegistryProvider` function.
+*
+* @example
+* import { configureStoreIsolation } from "@pyreon/runtime-server"
+* configureStoreIsolation(setStoreRegistryProvider)
+*/
+function configureStoreIsolation(setStoreRegistryProvider) {
+  setStoreRegistryProvider(() => _storeAls.getStore() ?? /* @__PURE__ */new Map());
+  _storeIsolationActive = true;
+}
+/** Wrap a function call in a fresh store registry (no-op if isolation not configured). */
+function withStoreContext(fn) {
+  if (!_storeIsolationActive) return fn();
+  return _storeAls.run(/* @__PURE__ */new Map(), fn);
+}
+/** Render a VNode tree to an HTML string. Supports async component functions. */
+async function renderToString(root) {
+  if (root === null) return "";
+  return withStoreContext(() => _contextAls.run([], () => renderNode(root)));
+}
+/**
+* Run an async function with a fresh, isolated context stack and store registry.
+* Useful when you need to call Pyreon APIs (e.g. useHead, prefetchLoaderData)
+* outside of renderToString but still want per-request isolation.
+*/
+function runWithRequestContext(fn) {
+  return withStoreContext(() => _contextAls.run([], fn));
+}
+/**
+* Render a VNode tree to a Web-standard ReadableStream of HTML chunks.
+*
+* True progressive streaming: HTML is flushed to the client as soon as each
+* node is ready. Synchronous subtrees are enqueued immediately; async component
+* boundaries are awaited in-order and their output is enqueued as it resolves.
+*
+* Suspense boundaries are streamed out-of-order: the fallback is emitted
+* immediately, and the resolved children are sent as a `<template>` + inline
+* swap script once ready — without blocking the rest of the page.
+*
+* Each renderToStream call gets its own isolated ALS context stack.
+*/
+function renderToStream(root) {
+  return new ReadableStream({
+    start(controller) {
+      const enqueue = chunk => controller.enqueue(chunk);
+      let bid = 0;
+      const ctx = {
+        pending: [],
+        nextId: () => bid++,
+        mainEnqueue: enqueue
+      };
+      return withStoreContext(() => _contextAls.run([], () => _streamCtxAls.run(ctx, async () => {
+        await streamNode(root, enqueue);
+        while (ctx.pending.length > 0) await Promise.all(ctx.pending.splice(0));
+        controller.close();
+      }).catch(err => controller.error(err))));
+    }
+  });
+}
+async function streamVNode(vnode, enqueue) {
+  if (vnode.type === Fragment) {
+    for (const child of vnode.children) await streamNode(child, enqueue);
+    return;
+  }
+  if (vnode.type === ForSymbol) {
+    const {
+      each,
+      children
+    } = vnode.props;
+    enqueue("<!--pyreon-for-->");
+    for (const item of each()) await streamNode(children(item), enqueue);
+    enqueue("<!--/pyreon-for-->");
+    return;
+  }
+  if (typeof vnode.type === "function") {
+    await streamComponentNode(vnode, enqueue);
+    return;
+  }
+  await streamElementNode(vnode, enqueue);
+}
+async function streamComponentNode(vnode, enqueue) {
+  if (vnode.type === Suspense) {
+    await streamSuspenseBoundary(vnode, enqueue);
+    return;
+  }
+  const {
+    vnode: output
+  } = runWithHooks(vnode.type, mergeChildrenIntoProps(vnode));
+  const resolved = output instanceof Promise ? await output : output;
+  if (resolved !== null) await streamNode(resolved, enqueue);
+}
+async function streamElementNode(vnode, enqueue) {
+  const tag = vnode.type;
+  let open = `<${tag}`;
+  for (const [key, value] of Object.entries(vnode.props)) {
+    const attr = renderProp(key, value);
+    if (attr) open += ` ${attr}`;
+  }
+  if (isVoidElement(tag)) {
+    enqueue(`${open} />`);
+    return;
+  }
+  enqueue(`${open}>`);
+  for (const child of vnode.children) await streamNode(child, enqueue);
+  enqueue(`</${tag}>`);
+}
+async function streamNode(node, enqueue) {
+  if (typeof node === "function") return streamNode(node(), enqueue);
+  if (node == null || node === false) return;
+  if (typeof node === "string") {
+    enqueue(escapeHtml(node));
+    return;
+  }
+  if (typeof node === "number" || typeof node === "boolean") {
+    enqueue(String(node));
+    return;
+  }
+  if (Array.isArray(node)) {
+    for (const child of node) await streamNode(child, enqueue);
+    return;
+  }
+  await streamVNode(node, enqueue);
+}
+/**
+* Stream a Suspense boundary: emit fallback immediately, then resolve children
+* asynchronously and emit them as a `<template>` + client-side swap.
+*
+* The actual children HTML is buffered until fully resolved, then emitted to the
+* main stream enqueue so it always arrives after the fallback placeholder.
+*/
+async function streamSuspenseBoundary(vnode, enqueue) {
+  const ctx = _streamCtxAls.getStore();
+  const {
+    fallback,
+    children
+  } = vnode.props;
+  if (!ctx) {
+    const {
+      vnode: output
+    } = runWithHooks(Suspense, vnode.props);
+    if (output !== null) await streamNode(output, enqueue);
+    return;
+  }
+  const id = ctx.nextId();
+  const {
+    mainEnqueue
+  } = ctx;
+  if (id === 0) mainEnqueue(SUSPENSE_SWAP_FN);
+  mainEnqueue(`<div id="pyreon-s-${id}">`);
+  await streamNode(fallback ?? null, enqueue);
+  mainEnqueue("</div>");
+  const ctxStore = _contextAls.getStore() ?? [];
+  ctx.pending.push(_contextAls.run(ctxStore, async () => {
+    try {
+      const buf = [];
+      await streamNode(children ?? null, s => buf.push(s));
+      mainEnqueue(`<template id="pyreon-t-${id}">${buf.join("")}</template>`);
+      mainEnqueue(`<script>__NS("pyreon-s-${id}","pyreon-t-${id}")<\/script>`);
+    } catch (_err) {}
+  }));
+}
+async function renderNode(node) {
+  if (typeof node === "function") return renderNode(node());
+  if (node == null || node === false) return "";
+  if (typeof node === "string") return escapeHtml(node);
+  if (typeof node === "number" || typeof node === "boolean") return String(node);
+  if (Array.isArray(node)) return (await Promise.all(node.map(n => renderNode(n)))).join("");
+  const vnode = node;
+  if (vnode.type === Fragment) return renderChildren(vnode.children);
+  if (vnode.type === ForSymbol) {
+    const {
+      each,
+      children
+    } = vnode.props;
+    return `<!--pyreon-for-->${(await Promise.all(each().map(item => renderNode(children(item))))).join("")}<!--/pyreon-for-->`;
+  }
+  if (typeof vnode.type === "function") return renderComponent(vnode);
+  return renderElement(vnode);
+}
+async function renderChildren(children) {
+  return (await Promise.all(children.map(c => renderNode(c)))).join("");
+}
+async function renderComponent(vnode) {
+  const {
+    vnode: output
+  } = runWithHooks(vnode.type, mergeChildrenIntoProps(vnode));
+  if (output instanceof Promise) {
+    const resolved = await output;
+    if (resolved === null) return "";
+    return renderNode(resolved);
+  }
+  if (output === null) return "";
+  return renderNode(output);
+}
+async function renderElement(vnode) {
+  const tag = vnode.type;
+  let html = `<${tag}`;
+  for (const [key, value] of Object.entries(vnode.props)) {
+    const attr = renderProp(key, value);
+    if (attr) html += ` ${attr}`;
+  }
+  if (isVoidElement(tag)) {
+    html += " />";
+    return html;
+  }
+  html += ">";
+  for (const child of vnode.children) html += await renderNode(child);
+  html += `</${tag}>`;
+  return html;
+}
+function renderPropSkipped(key) {
+  if (key === "key" || key === "ref" || key === "n-show") return true;
+  if (key.startsWith("n-")) return true;
+  if (/^on[A-Z]/.test(key)) return true;
+  return false;
+}
+function renderPropValue(key, value) {
+  if (value === null || value === void 0 || value === false) return null;
+  if (value === true) return escapeHtml(toAttrName(key));
+  if (key === "class") {
+    const cls = normalizeClass(value);
+    return cls ? `class="${escapeHtml(cls)}"` : null;
+  }
+  if (key === "style") {
+    const style = normalizeStyle(value);
+    return style ? `style="${escapeHtml(style)}"` : null;
+  }
+  return `${escapeHtml(toAttrName(key))}="${escapeHtml(String(value))}"`;
+}
+function renderProp(key, value) {
+  if (renderPropSkipped(key)) return null;
+  if (typeof value === "function") return renderProp(key, value());
+  if (SSR_URL_ATTRS.has(key) && typeof value === "string" && SSR_UNSAFE_URL_RE.test(value)) return null;
+  return renderPropValue(key, value);
+}
+function isVoidElement(tag) {
+  return VOID_ELEMENTS.has(tag.toLowerCase());
+}
+/** camelCase prop → kebab-case HTML attribute (e.g. className → class, htmlFor → for) */
+function toAttrName(key) {
+  if (key === "className") return "class";
+  if (key === "htmlFor") return "for";
+  return key.replace(/[A-Z]/g, c => `-${c.toLowerCase()}`);
+}
+function normalizeClass(value) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) return value.filter(Boolean).join(" ");
+  if (typeof value === "object" && value !== null) return Object.entries(value).filter(([, v]) => v).map(([k]) => k).join(" ");
+  return "";
+}
+function normalizeStyle(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "object" && value !== null) return Object.entries(value).map(([k, v]) => `${toKebab(k)}: ${v}`).join("; ");
+  return "";
+}
+function toKebab(str) {
+  return str.replace(/[A-Z]/g, c => `-${c.toLowerCase()}`);
+}
+function escapeHtml(str) {
+  return str.replace(/[&<>"']/g, c => ESCAPE_MAP[c] ?? c);
+}
+/**
+* Merge vnode.children into props.children for component rendering.
+* Matches the behavior of mount.ts and hydrate.ts so components can
+* access children passed via h(Comp, props, child1, child2).
+*/
+function mergeChildrenIntoProps(vnode) {
+  if (vnode.children.length > 0 && vnode.props.children === void 0) return {
+    ...vnode.props,
+    children: vnode.children.length === 1 ? vnode.children[0] : vnode.children
+  };
+  return vnode.props;
+}
+
+//#endregion
+export { configureStoreIsolation, renderToStream, renderToString, runWithRequestContext };
+//# sourceMappingURL=index.d.ts.map