@pyreon/runtime-server 0.1.0

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":"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"}

package/lib/types/index2.d.ts

@@ -0,0 +1,37 @@
+import { VNode } from "@pyreon/core";
+
+//#region src/index.d.ts
+/**
+ * Wire up per-request store isolation.
+ * Call once at server startup, passing a `setStoreRegistryProvider` function.
+ *
+ * @example
+ * import { configureStoreIsolation } from "@pyreon/runtime-server"
+ * configureStoreIsolation(setStoreRegistryProvider)
+ */
+declare function configureStoreIsolation(setStoreRegistryProvider: (fn: () => Map<string, unknown>) => void): void;
+/** Render a VNode tree to an HTML string. Supports async component functions. */
+declare function renderToString(root: VNode | null): Promise<string>;
+/**
+ * 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.
+ */
+declare function runWithRequestContext<T>(fn: () => Promise<T>): Promise<T>;
+/**
+ * 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.
+ */
+declare function renderToStream(root: VNode | null): ReadableStream<string>;
+//#endregion
+export { configureStoreIsolation, renderToStream, renderToString, runWithRequestContext };
+//# sourceMappingURL=index2.d.ts.map

package/lib/types/index2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;;;;AAiFA;;iBA3BgB,uBAAA,CACd,wBAAA,GAA2B,EAAA,QAAU,GAAA;;iBAejB,cAAA,CAAe,IAAA,EAAM,KAAA,UAAe,OAAA;;;;;;iBAW1C,qBAAA,GAAA,CAAyB,EAAA,QAAU,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;;;;;;;AAiBxE;;;;;;;iBAAgB,cAAA,CAAe,IAAA,EAAM,KAAA,UAAe,cAAA"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pyreon/runtime-server",
+  "version": "0.1.0",
+  "description": "SSR/SSG renderer for Pyreon — streaming HTML + static generation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pyreon/pyreon.git",
+    "directory": "packages/runtime-server"
+  },
+  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/runtime-server#readme",
+  "bugs": {
+    "url": "https://github.com/pyreon/pyreon/issues"
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "main": "./lib/index.js",
+  "module": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "vl_rolldown_build",
+    "dev": "vl_rolldown_build-watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@pyreon/core": "workspace:*",
+    "@pyreon/reactivity": "workspace:*"
+  }
+}

package/src/index.ts

@@ -0,0 +1,460 @@
+/**
+ * @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>
+ */
+
+import { AsyncLocalStorage } from "node:async_hooks"
+import type { ComponentFn, ForProps, VNode, VNodeChild } from "@pyreon/core"
+import { ForSymbol, Fragment, runWithHooks, Suspense, setContextStackProvider } from "@pyreon/core"
+
+// ─── Streaming Suspense context ───────────────────────────────────────────────
+// Tracks in-flight async Suspense boundary resolutions within a single stream.
+
+interface StreamCtx {
+  pending: Promise<void>[]
+  nextId: () => number
+  mainEnqueue: (s: string) => void
+}
+
+const _streamCtxAls = new AsyncLocalStorage<StreamCtx>()
+
+// ─── Concurrent SSR context isolation ────────────────────────────────────────
+// Each renderToString call runs in its own ALS store (a fresh empty stack[]).
+// Concurrent requests never share context frames.
+
+const _contextAls = new AsyncLocalStorage<Map<symbol, unknown>[]>()
+const _fallbackStack: Map<symbol, unknown>[] = []
+
+setContextStackProvider(() => _contextAls.getStore() ?? _fallbackStack)
+
+// ─── Store isolation (optional) ───────────────────────────────────────────────
+// A second ALS isolates store registries between concurrent requests.
+// Activated only when the user calls configureStoreIsolation().
+
+const _storeAls = new AsyncLocalStorage<Map<string, unknown>>()
+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)
+ */
+export function configureStoreIsolation(
+  setStoreRegistryProvider: (fn: () => Map<string, unknown>) => void,
+): void {
+  setStoreRegistryProvider(() => _storeAls.getStore() ?? new Map())
+  _storeIsolationActive = true
+}
+
+/** Wrap a function call in a fresh store registry (no-op if isolation not configured). */
+function withStoreContext<T>(fn: () => T): T {
+  if (!_storeIsolationActive) return fn()
+  return _storeAls.run(new Map(), fn)
+}
+
+// ─── Public API ───────────────────────────────────────────────────────────────
+
+/** Render a VNode tree to an HTML string. Supports async component functions. */
+export async function renderToString(root: VNode | null): Promise<string> {
+  if (root === null) return ""
+  // Each call gets a fresh isolated context stack and (optionally) store registry
+  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.
+ */
+export function runWithRequestContext<T>(fn: () => Promise<T>): Promise<T> {
+  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.
+ */
+export function renderToStream(root: VNode | null): ReadableStream<string> {
+  return new ReadableStream<string>({
+    start(controller) {
+      const enqueue = (chunk: string) => controller.enqueue(chunk)
+      let bid = 0
+      const ctx: StreamCtx = {
+        pending: [],
+        nextId: () => bid++,
+        mainEnqueue: enqueue,
+      }
+      return withStoreContext(() =>
+        _contextAls.run([], () =>
+          _streamCtxAls
+            .run(ctx, async () => {
+              await streamNode(root, enqueue)
+              // Drain all pending Suspense resolutions (may spawn nested ones)
+              while (ctx.pending.length > 0) {
+                await Promise.all(ctx.pending.splice(0))
+              }
+              controller.close()
+            })
+            .catch((err) => controller.error(err)),
+        ),
+      )
+    },
+  })
+}
+
+// ─── Streaming renderer ───────────────────────────────────────────────────────
+
+async function streamVNode(vnode: VNode, enqueue: (s: string) => void): Promise<void> {
+  if (vnode.type === Fragment) {
+    for (const child of vnode.children) await streamNode(child, enqueue)
+    return
+  }
+
+  if (vnode.type === (ForSymbol as unknown as string)) {
+    const { each, children } = vnode.props as unknown as ForProps<unknown>
+    enqueue("<!--pyreon-for-->")
+    for (const item of each()) await streamNode(children(item) as VNodeChild, enqueue)
+    enqueue("<!--/pyreon-for-->")
+    return
+  }
+
+  if (typeof vnode.type === "function") {
+    await streamComponentNode(vnode, enqueue)
+    return
+  }
+
+  await streamElementNode(vnode, enqueue)
+}
+
+async function streamComponentNode(vnode: VNode, enqueue: (s: string) => void): Promise<void> {
+  if (vnode.type === Suspense) {
+    await streamSuspenseBoundary(vnode, enqueue)
+    return
+  }
+  const { vnode: output } = runWithHooks(vnode.type as ComponentFn, mergeChildrenIntoProps(vnode))
+  const resolved = output instanceof Promise ? await output : output
+  if (resolved !== null) await streamNode(resolved, enqueue)
+}
+
+async function streamElementNode(vnode: VNode, enqueue: (s: string) => void): Promise<void> {
+  const tag = vnode.type as string
+  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: VNodeChild | null | (() => VNodeChild),
+  enqueue: (s: string) => void,
+): Promise<void> {
+  if (typeof node === "function") {
+    return streamNode((node as () => VNodeChild)(), 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 as VNode, enqueue)
+}
+
+// Inline swap helper emitted once per stream, before the first <template>
+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: VNode, enqueue: (s: string) => void): Promise<void> {
+  const ctx = _streamCtxAls.getStore()
+  const { fallback, children } = vnode.props as { fallback: VNodeChild; children?: VNodeChild }
+
+  // No streaming context (e.g. called from renderToString) — render children inline
+  if (!ctx) {
+    const { vnode: output } = runWithHooks(Suspense as ComponentFn, vnode.props)
+    if (output !== null) await streamNode(output, enqueue)
+    return
+  }
+
+  const id = ctx.nextId()
+  const { mainEnqueue } = ctx
+
+  // Emit the swap helper function once (before first use)
+  if (id === 0) mainEnqueue(SUSPENSE_SWAP_FN)
+
+  // Stream the fallback synchronously (no await on children)
+  mainEnqueue(`<div id="pyreon-s-${id}">`)
+  await streamNode(fallback ?? null, enqueue)
+  mainEnqueue("</div>")
+
+  // Capture the context store for the async resolution so it inherits context
+  const ctxStore = _contextAls.getStore() ?? []
+
+  // Queue async resolution — runs in parallel, emits to main stream when done
+  // Errors are caught per-boundary so one failing Suspense doesn't abort the stream.
+  ctx.pending.push(
+    _contextAls.run(ctxStore, async () => {
+      try {
+        const buf: string[] = []
+        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) {
+        // Fallback stays visible — no swap script emitted
+      }
+    }),
+  )
+}
+
+// ─── Core renderer ───────────────────────────────────────────────────────────
+
+async function renderNode(node: VNodeChild | (() => VNodeChild)): Promise<string> {
+  // Reactive accessor — call it synchronously (snapshot)
+  if (typeof node === "function") {
+    return renderNode((node as () => VNodeChild)())
+  }
+
+  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)) {
+    const parts = await Promise.all(node.map((n) => renderNode(n)))
+    return parts.join("")
+  }
+
+  const vnode = node as VNode
+
+  if (vnode.type === Fragment) {
+    return renderChildren(vnode.children)
+  }
+
+  if (vnode.type === (ForSymbol as unknown as string)) {
+    const { each, children } = vnode.props as unknown as ForProps<unknown>
+    const parts = await Promise.all(each().map((item) => renderNode(children(item) as VNodeChild)))
+    // Hydration markers so the client can claim existing For-rendered children
+    return `<!--pyreon-for-->${parts.join("")}<!--/pyreon-for-->`
+  }
+
+  if (typeof vnode.type === "function") {
+    return renderComponent(vnode as VNode & { type: ComponentFn })
+  }
+
+  return renderElement(vnode)
+}
+
+async function renderChildren(children: VNodeChild[]): Promise<string> {
+  const parts = await Promise.all(children.map((c) => renderNode(c)))
+  return parts.join("")
+}
+
+async function renderComponent(vnode: VNode & { type: ComponentFn }): Promise<string> {
+  const { vnode: output } = runWithHooks(vnode.type, mergeChildrenIntoProps(vnode))
+
+  // Async component function (async function Component()) — await the promise
+  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: VNode): Promise<string> {
+  const tag = vnode.type as string
+  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: string): boolean {
+  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: string, value: unknown): string | null {
+  if (value === null || value === undefined || 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: string, value: unknown): string | null {
+  if (renderPropSkipped(key)) return null
+
+  if (typeof value === "function") {
+    return renderProp(key, (value as () => unknown)())
+  }
+
+  if (SSR_URL_ATTRS.has(key) && typeof value === "string" && SSR_UNSAFE_URL_RE.test(value)) {
+    return null
+  }
+
+  return renderPropValue(key, value)
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+const VOID_ELEMENTS = new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr",
+])
+
+function isVoidElement(tag: string): boolean {
+  return VOID_ELEMENTS.has(tag.toLowerCase())
+}
+
+/** camelCase prop → kebab-case HTML attribute (e.g. className → class, htmlFor → for) */
+function toAttrName(key: string): string {
+  if (key === "className") return "class"
+  if (key === "htmlFor") return "for"
+  return key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)
+}
+
+function normalizeClass(value: unknown): string {
+  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 as Record<string, unknown>)
+      .filter(([, v]) => v)
+      .map(([k]) => k)
+      .join(" ")
+  }
+  return ""
+}
+
+function normalizeStyle(value: unknown): string {
+  if (typeof value === "string") return value
+  if (typeof value === "object" && value !== null) {
+    return Object.entries(value as Record<string, unknown>)
+      .map(([k, v]) => `${toKebab(k)}: ${v}`)
+      .join("; ")
+  }
+  return ""
+}
+
+function toKebab(str: string): string {
+  return str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)
+}
+
+const ESCAPE_MAP: Record<string, string> = {
+  "&": "&amp;",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;",
+}
+
+function escapeHtml(str: string): string {
+  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: VNode): Record<string, unknown> {
+  if (
+    vnode.children.length > 0 &&
+    (vnode.props as Record<string, unknown>).children === undefined
+  ) {
+    return {
+      ...vnode.props,
+      children: vnode.children.length === 1 ? vnode.children[0] : vnode.children,
+    }
+  }
+  return vnode.props as Record<string, unknown>
+}