@getforma/core 0.1.0

package/dist/ssr/index.d.ts

@@ -0,0 +1,154 @@
+interface VNode {
+    tag: string;
+    props: Record<string, unknown> | null;
+    children: unknown[];
+}
+/**
+ * Server-side hyperscript — creates a virtual node instead of a DOM element.
+ */
+declare function sh(tag: string, props?: Record<string, unknown> | null, ...children: unknown[]): VNode;
+/**
+ * Render a FormaJS virtual tree to an HTML string.
+ *
+ * Uses an array buffer internally to avoid O(n^2) string concatenation
+ * for large trees, then joins once at the end.
+ *
+ * Usage:
+ * ```ts
+ * import { renderToString, sh } from '@getforma/core/ssr';
+ *
+ * const html = renderToString(
+ *   sh('div', { class: 'app' },
+ *     sh('h1', null, 'Hello SSR!'),
+ *     sh('p', null, () => count()),  // signal getters resolved synchronously
+ *   )
+ * );
+ * ```
+ */
+declare function renderToString(node: unknown): string;
+/**
+ * Render a FormaJS virtual tree to an HTML string with hydration markers.
+ *
+ * Like `renderToString`, but injects comment markers and `data-forma-h`
+ * attributes so the client-side `hydrate()` function can adopt existing
+ * DOM nodes without re-creating them.
+ *
+ * Marker types:
+ * - `data-forma-h="N"` — element boundary (attribute on the element)
+ * - `<!--forma-t:N-->` / `<!--/forma-t:N-->` — reactive text boundary
+ * - `<!--forma-l:N-->` / `<!--/forma-l:N-->` — list boundary
+ *
+ * Usage:
+ * ```ts
+ * import { renderToStringWithHydration, sh } from '@getforma/core/ssr';
+ *
+ * const html = renderToStringWithHydration(
+ *   sh('div', { class: 'app' },
+ *     sh('h1', null, 'Hello SSR!'),
+ *     sh('p', null, () => count()),
+ *   )
+ * );
+ * ```
+ */
+declare function renderToStringWithHydration(node: unknown): string;
+
+/**
+ * SSR-only signal: just a value holder, no reactivity needed on server.
+ */
+declare function ssrSignal<T>(initial: T): [get: () => T, set: (v: T) => void];
+declare function ssrComputed<T>(fn: () => T): () => T;
+
+/**
+ * FormaJS SSR - Streaming Renderer
+ *
+ * Implements true chunked HTML streaming with out-of-order Suspense resolution.
+ *
+ * How it works:
+ * 1. Yields shell HTML immediately (opening tags, head, static content)
+ * 2. When a Suspense boundary is encountered:
+ *    - Yields the fallback HTML with a placeholder: <div id="forma-s:N" style="display:contents">
+ *    - Continues rendering siblings without blocking
+ *    - When the async resource resolves, yields a swap script
+ * 3. Suspense boundaries resolve independently in any order (out-of-order streaming)
+ */
+/**
+ * A Suspense boundary VNode has a special shape:
+ * { tag: 'forma-suspense', props: { fallback: VNode }, children: [asyncChildren] }
+ *
+ * Or it can be created via:
+ * shSuspense(fallbackVNode, () => asyncContent)
+ */
+interface SuspenseVNode {
+    tag: 'forma-suspense';
+    props: {
+        fallback: unknown;
+    };
+    children: [() => Promise<unknown>];
+}
+/**
+ * Create a server-side Suspense VNode for streaming SSR.
+ */
+declare function shSuspense(fallback: unknown, asyncChildren: () => Promise<unknown>): SuspenseVNode;
+interface StreamOptions {
+    /** Script to bootstrap the client-side app (e.g. <script src="/app.js"></script>) */
+    bootstrapScript?: string;
+    /** Whether to inject the $FORMA_SWAP client script (default: true) */
+    injectSwapScript?: boolean;
+}
+/**
+ * Render a FormaJS virtual tree to a stream of HTML chunks.
+ *
+ * Yields HTML progressively:
+ * - Static content is yielded immediately
+ * - Suspense boundaries yield their fallback, then resolve later
+ * - Resolved Suspense boundaries yield swap scripts
+ *
+ * Usage:
+ * ```ts
+ * import { renderToStream, shSuspense, sh } from '@getforma/core/ssr';
+ *
+ * const stream = renderToStream(
+ *   sh('html', null,
+ *     sh('body', null,
+ *       sh('h1', null, 'Hello'),
+ *       shSuspense(
+ *         sh('div', null, 'Loading...'),
+ *         async () => {
+ *           const data = await fetchData();
+ *           return sh('div', null, data.name);
+ *         },
+ *       ),
+ *     ),
+ *   ),
+ * );
+ *
+ * for await (const chunk of stream) {
+ *   response.write(chunk);
+ * }
+ * ```
+ */
+declare function renderToStreamNew(node: unknown, options?: StreamOptions): AsyncGenerator<string>;
+
+/**
+ * FormaJS SSR - Client Swap Script
+ *
+ * Tiny inline script injected into the HTML stream that handles
+ * out-of-order Suspense boundary resolution.
+ *
+ * When the server resolves a Suspense boundary, it sends:
+ *   <script>$FORMA_SWAP("forma-s:0","<resolved html>")</script>
+ *
+ * This script replaces the fallback placeholder with the resolved content.
+ */
+/**
+ * Returns the client-side swap script as a string, ready to be injected
+ * into the HTML stream (typically right after <body> or before first Suspense).
+ */
+declare function getSwapScript(): string;
+/**
+ * Returns a script tag that swaps a specific Suspense boundary's content.
+ * Called when an async resource resolves during streaming.
+ */
+declare function getSwapTag(id: string, html: string): string;
+
+export { type StreamOptions, type SuspenseVNode, type VNode, getSwapScript, getSwapTag, renderToStreamNew as renderToStream, renderToString, renderToStringWithHydration, sh, shSuspense, ssrComputed, ssrSignal };

package/dist/ssr/index.js

@@ -0,0 +1,371 @@
+// src/ssr/render.ts
+var VOID_ELEMENTS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+var PROP_TO_ATTR = {
+  className: "class",
+  htmlFor: "for",
+  tabIndex: "tabindex"
+};
+function escapeHtml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#x27;");
+}
+function escapeAttr(str) {
+  return str.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+function sh(tag, props, ...children) {
+  return { tag, props: props ?? null, children };
+}
+function renderToString(node) {
+  const parts = [];
+  renderToBuffer(node, parts);
+  return parts.join("");
+}
+function renderToBuffer(node, parts) {
+  if (node == null || node === true || node === false) return;
+  if (typeof node === "string") {
+    parts.push(escapeHtml(node));
+    return;
+  }
+  if (typeof node === "number") {
+    parts.push(String(node));
+    return;
+  }
+  if (typeof node === "function") {
+    renderToBuffer(node(), parts);
+    return;
+  }
+  if (Array.isArray(node)) {
+    for (const child of node) renderToBuffer(child, parts);
+    return;
+  }
+  if (isVNode(node)) {
+    const { tag, props, children } = node;
+    parts.push("<", tag);
+    if (props) {
+      for (const [key, value] of Object.entries(props)) {
+        if (key.startsWith("on") || key === "ref" || key === "dangerouslySetInnerHTML") continue;
+        const attrName = PROP_TO_ATTR[key] ?? key;
+        const resolved = typeof value === "function" ? value() : value;
+        if (resolved === true) {
+          parts.push(" ", attrName);
+        } else if (resolved !== false && resolved != null) {
+          parts.push(" ", attrName, '="', escapeAttr(String(resolved)), '"');
+        }
+      }
+    }
+    if (VOID_ELEMENTS.has(tag)) {
+      parts.push(" />");
+      return;
+    }
+    parts.push(">");
+    if (props?.["dangerouslySetInnerHTML"]) {
+      parts.push(props["dangerouslySetInnerHTML"].__html);
+    } else {
+      for (const child of children) {
+        renderToBuffer(child, parts);
+      }
+    }
+    parts.push("</", tag, ">");
+    return;
+  }
+  parts.push(escapeHtml(String(node)));
+}
+function isVNode(v) {
+  return v != null && typeof v === "object" && "tag" in v && "children" in v;
+}
+var hydrationId = 0;
+function renderToStringWithHydration(node) {
+  hydrationId = 0;
+  const parts = [];
+  renderToBufferHydrated(node, parts);
+  return parts.join("");
+}
+function renderToBufferHydrated(node, parts) {
+  if (node == null || node === true || node === false) return;
+  if (typeof node === "string") {
+    parts.push(escapeHtml(node));
+    return;
+  }
+  if (typeof node === "number") {
+    parts.push(String(node));
+    return;
+  }
+  if (typeof node === "function") {
+    const id = hydrationId++;
+    parts.push(`<!--forma-t:${id}-->`);
+    renderToBufferHydrated(node(), parts);
+    parts.push(`<!--/forma-t:${id}-->`);
+    return;
+  }
+  if (Array.isArray(node)) {
+    const id = hydrationId++;
+    parts.push(`<!--forma-l:${id}-->`);
+    for (const child of node) renderToBufferHydrated(child, parts);
+    parts.push(`<!--/forma-l:${id}-->`);
+    return;
+  }
+  if (isVNode(node)) {
+    const id = hydrationId++;
+    const { tag, props, children } = node;
+    parts.push("<", tag, ` data-forma-h="${id}"`);
+    if (props) {
+      for (const [key, value] of Object.entries(props)) {
+        if (key.startsWith("on") || key === "ref" || key === "dangerouslySetInnerHTML") continue;
+        const attrName = PROP_TO_ATTR[key] ?? key;
+        const resolved = typeof value === "function" ? value() : value;
+        if (resolved === true) {
+          parts.push(" ", attrName);
+        } else if (resolved !== false && resolved != null) {
+          parts.push(" ", attrName, '="', escapeAttr(String(resolved)), '"');
+        }
+      }
+    }
+    if (VOID_ELEMENTS.has(tag)) {
+      parts.push(" />");
+      return;
+    }
+    parts.push(">");
+    if (props?.["dangerouslySetInnerHTML"]) {
+      parts.push(props["dangerouslySetInnerHTML"].__html);
+    } else {
+      for (const child of children) {
+        renderToBufferHydrated(child, parts);
+      }
+    }
+    parts.push("</", tag, ">");
+    return;
+  }
+  parts.push(escapeHtml(String(node)));
+}
+
+// src/ssr/ssr-reactive.ts
+function ssrSignal(initial) {
+  let value = initial;
+  return [() => value, (v) => {
+    value = v;
+  }];
+}
+function ssrComputed(fn) {
+  return fn;
+}
+
+// src/ssr/client-script.ts
+function getSwapScript() {
+  return `<script>
+function $FORMA_SWAP(id,html){
+  var el=document.getElementById(id);
+  if(el){
+    var tpl=document.createElement('template');
+    tpl.innerHTML=html;
+    el.replaceWith(tpl.content);
+  }
+}
+</script>`;
+}
+function getSwapTag(id, html) {
+  const escaped = html.replace(/<\/script>/gi, "<\\/script>");
+  return `<script>$FORMA_SWAP("${id}","${escaped.replace(/"/g, '\\"').replace(/\n/g, "\\n")}")</script>`;
+}
+
+// src/ssr/stream.ts
+function isVNode2(v) {
+  return v != null && typeof v === "object" && "tag" in v && "children" in v;
+}
+function escapeHtml2(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#x27;");
+}
+function escapeAttr2(str) {
+  return str.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+var VOID_ELEMENTS2 = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+var PROP_TO_ATTR2 = {
+  className: "class",
+  htmlFor: "for",
+  tabIndex: "tabindex"
+};
+var suspenseCounter = 0;
+var pendingBoundaries = [];
+function renderSync(node, parts) {
+  if (node == null || node === true || node === false) return;
+  if (typeof node === "string") {
+    parts.push(escapeHtml2(node));
+    return;
+  }
+  if (typeof node === "number") {
+    parts.push(String(node));
+    return;
+  }
+  if (typeof node === "function") {
+    renderSync(node(), parts);
+    return;
+  }
+  if (Array.isArray(node)) {
+    for (const child of node) renderSync(child, parts);
+    return;
+  }
+  if (isVNode2(node)) {
+    const { tag, props, children } = node;
+    parts.push("<", tag);
+    if (props) {
+      for (const [key, value] of Object.entries(props)) {
+        if (key.startsWith("on") || key === "ref" || key === "dangerouslySetInnerHTML") continue;
+        const attrName = PROP_TO_ATTR2[key] ?? key;
+        const resolved = typeof value === "function" ? value() : value;
+        if (resolved === true) {
+          parts.push(" ", attrName);
+        } else if (resolved !== false && resolved != null) {
+          parts.push(" ", attrName, '="', escapeAttr2(String(resolved)), '"');
+        }
+      }
+    }
+    if (VOID_ELEMENTS2.has(tag)) {
+      parts.push(" />");
+      return;
+    }
+    parts.push(">");
+    if (props?.["dangerouslySetInnerHTML"]) {
+      parts.push(props["dangerouslySetInnerHTML"].__html);
+    } else {
+      for (const child of children) renderSync(child, parts);
+    }
+    parts.push("</", tag, ">");
+    return;
+  }
+  parts.push(escapeHtml2(String(node)));
+}
+function isSuspenseVNode(v) {
+  return isVNode2(v) && v.tag === "forma-suspense";
+}
+function shSuspense(fallback, asyncChildren) {
+  return {
+    tag: "forma-suspense",
+    props: { fallback },
+    children: [asyncChildren]
+  };
+}
+async function* renderToStreamNew(node, options) {
+  suspenseCounter = 0;
+  pendingBoundaries = [];
+  const injectSwap = options?.injectSwapScript !== false;
+  if (injectSwap) {
+    yield getSwapScript();
+  }
+  const mainParts = [];
+  renderStreamNode(node, mainParts);
+  yield mainParts.join("");
+  if (options?.bootstrapScript) {
+    yield options.bootstrapScript;
+  }
+  while (pendingBoundaries.length > 0) {
+    const pending = [...pendingBoundaries];
+    pendingBoundaries = [];
+    const results = await Promise.allSettled(
+      pending.map(async (boundary) => {
+        const html = await boundary.promise;
+        return { id: boundary.id, html };
+      })
+    );
+    for (const result of results) {
+      if (result.status === "fulfilled") {
+        yield getSwapTag(result.value.id, result.value.html);
+      }
+    }
+  }
+}
+function renderStreamNode(node, parts) {
+  if (node == null || node === true || node === false) return;
+  if (typeof node === "string") {
+    parts.push(escapeHtml2(node));
+    return;
+  }
+  if (typeof node === "number") {
+    parts.push(String(node));
+    return;
+  }
+  if (typeof node === "function") {
+    renderStreamNode(node(), parts);
+    return;
+  }
+  if (Array.isArray(node)) {
+    for (const child of node) renderStreamNode(child, parts);
+    return;
+  }
+  if (isSuspenseVNode(node)) {
+    const id = `forma-s:${suspenseCounter++}`;
+    const fallback = node.props.fallback;
+    const asyncFn = node.children[0];
+    parts.push(`<div id="${id}" style="display:contents">`);
+    renderSync(fallback, parts);
+    parts.push("</div>");
+    const promise = asyncFn().then((resolved) => {
+      const resolvedParts = [];
+      renderSync(resolved, resolvedParts);
+      return resolvedParts.join("");
+    });
+    pendingBoundaries.push({ id, promise });
+    return;
+  }
+  if (isVNode2(node)) {
+    const { tag, props, children } = node;
+    parts.push("<", tag);
+    if (props) {
+      for (const [key, value] of Object.entries(props)) {
+        if (key === "fallback") continue;
+        if (key.startsWith("on") || key === "ref" || key === "dangerouslySetInnerHTML") continue;
+        const attrName = PROP_TO_ATTR2[key] ?? key;
+        const resolved = typeof value === "function" ? value() : value;
+        if (resolved === true) {
+          parts.push(" ", attrName);
+        } else if (resolved !== false && resolved != null) {
+          parts.push(" ", attrName, '="', escapeAttr2(String(resolved)), '"');
+        }
+      }
+    }
+    if (VOID_ELEMENTS2.has(tag)) {
+      parts.push(" />");
+      return;
+    }
+    parts.push(">");
+    if (props?.["dangerouslySetInnerHTML"]) {
+      parts.push(props["dangerouslySetInnerHTML"].__html);
+    } else {
+      for (const child of children) renderStreamNode(child, parts);
+    }
+    parts.push("</", tag, ">");
+    return;
+  }
+  parts.push(escapeHtml2(String(node)));
+}
+
+export { getSwapScript, getSwapTag, renderToStreamNew as renderToStream, renderToString, renderToStringWithHydration, sh, shSuspense, ssrComputed, ssrSignal };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ssr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ssr/render.ts","../../src/ssr/ssr-reactive.ts","../../src/ssr/client-script.ts","../../src/ssr/stream.ts"],"names":["isVNode","escapeHtml","escapeAttr","VOID_ELEMENTS","PROP_TO_ATTR"],"mappings":"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","file":"index.js","sourcesContent":["import { ssrSignal } from './ssr-reactive.js';\n\n// Void elements that don't have closing tags\nconst VOID_ELEMENTS = new Set([\n  'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',\n  'link', 'meta', 'param', 'source', 'track', 'wbr',\n]);\n\n// Map of prop names to HTML attribute names\nconst PROP_TO_ATTR: Record<string, string> = {\n  className: 'class',\n  htmlFor: 'for',\n  tabIndex: 'tabindex',\n};\n\n// Escape HTML entities\nfunction escapeHtml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#x27;');\n}\n\n// Escape attribute values\nfunction escapeAttr(str: string): string {\n  return str.replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n}\n\nexport interface VNode {\n  tag: string;\n  props: Record<string, unknown> | null;\n  children: unknown[];\n}\n\n/**\n * Server-side hyperscript — creates a virtual node instead of a DOM element.\n */\nexport function sh(tag: string, props?: Record<string, unknown> | null, ...children: unknown[]): VNode {\n  return { tag, props: props ?? null, children };\n}\n\n/**\n * Render a FormaJS virtual tree to an HTML string.\n *\n * Uses an array buffer internally to avoid O(n^2) string concatenation\n * for large trees, then joins once at the end.\n *\n * Usage:\n * ```ts\n * import { renderToString, sh } from '@getforma/core/ssr';\n *\n * const html = renderToString(\n *   sh('div', { class: 'app' },\n *     sh('h1', null, 'Hello SSR!'),\n *     sh('p', null, () => count()),  // signal getters resolved synchronously\n *   )\n * );\n * ```\n */\nexport function renderToString(node: unknown): string {\n  const parts: string[] = [];\n  renderToBuffer(node, parts);\n  return parts.join('');\n}\n\n/**\n * Internal: recursively render into a string array buffer.\n * Avoids O(n^2) string concatenation for large trees.\n */\nfunction renderToBuffer(node: unknown, parts: string[]): void {\n  // null/undefined/boolean → empty\n  if (node == null || node === true || node === false) return;\n\n  // String → escaped text\n  if (typeof node === 'string') { parts.push(escapeHtml(node)); return; }\n\n  // Number → stringified\n  if (typeof node === 'number') { parts.push(String(node)); return; }\n\n  // Function (signal getter) → resolve and render\n  if (typeof node === 'function') { renderToBuffer(node(), parts); return; }\n\n  // Array → render each\n  if (Array.isArray(node)) {\n    for (const child of node) renderToBuffer(child, parts);\n    return;\n  }\n\n  // VNode\n  if (isVNode(node)) {\n    const { tag, props, children } = node;\n    parts.push('<', tag);\n\n    // Render props as attributes\n    if (props) {\n      for (const [key, value] of Object.entries(props)) {\n        // Skip event handlers, refs, and internal props\n        if (key.startsWith('on') || key === 'ref' || key === 'dangerouslySetInnerHTML') continue;\n\n        const attrName = PROP_TO_ATTR[key] ?? key;\n\n        // Resolve reactive values\n        const resolved = typeof value === 'function' ? value() : value;\n\n        if (resolved === true) {\n          parts.push(' ', attrName);\n        } else if (resolved !== false && resolved != null) {\n          parts.push(' ', attrName, '=\"', escapeAttr(String(resolved)), '\"');\n        }\n      }\n    }\n\n    // Void elements\n    if (VOID_ELEMENTS.has(tag)) { parts.push(' />'); return; }\n\n    parts.push('>');\n\n    // dangerouslySetInnerHTML\n    if (props?.['dangerouslySetInnerHTML']) {\n      parts.push((props['dangerouslySetInnerHTML'] as { __html: string }).__html);\n    } else {\n      // Render children\n      for (const child of children) {\n        renderToBuffer(child, parts);\n      }\n    }\n\n    parts.push('</', tag, '>');\n    return;\n  }\n\n  // Fallback: stringify\n  parts.push(escapeHtml(String(node)));\n}\n\nfunction isVNode(v: unknown): v is VNode {\n  return v != null && typeof v === 'object' && 'tag' in v && 'children' in v;\n}\n\n// ---------------------------------------------------------------------------\n// Hydration-aware rendering\n// ---------------------------------------------------------------------------\n\nexport interface RenderOptions {\n  /** Enable hydration markers in output. */\n  hydrate?: boolean;\n}\n\nlet hydrationId = 0;\n\n/**\n * Render a FormaJS virtual tree to an HTML string with hydration markers.\n *\n * Like `renderToString`, but injects comment markers and `data-forma-h`\n * attributes so the client-side `hydrate()` function can adopt existing\n * DOM nodes without re-creating them.\n *\n * Marker types:\n * - `data-forma-h=\"N\"` — element boundary (attribute on the element)\n * - `<!--forma-t:N-->` / `<!--/forma-t:N-->` — reactive text boundary\n * - `<!--forma-l:N-->` / `<!--/forma-l:N-->` — list boundary\n *\n * Usage:\n * ```ts\n * import { renderToStringWithHydration, sh } from '@getforma/core/ssr';\n *\n * const html = renderToStringWithHydration(\n *   sh('div', { class: 'app' },\n *     sh('h1', null, 'Hello SSR!'),\n *     sh('p', null, () => count()),\n *   )\n * );\n * ```\n */\nexport function renderToStringWithHydration(node: unknown): string {\n  hydrationId = 0; // reset counter per render\n  const parts: string[] = [];\n  renderToBufferHydrated(node, parts);\n  return parts.join('');\n}\n\n/**\n * Internal: recursively render into a string array buffer with hydration markers.\n */\nfunction renderToBufferHydrated(node: unknown, parts: string[]): void {\n  // null/undefined/boolean → empty\n  if (node == null || node === true || node === false) return;\n\n  // String → escaped text\n  if (typeof node === 'string') { parts.push(escapeHtml(node)); return; }\n\n  // Number → stringified\n  if (typeof node === 'number') { parts.push(String(node)); return; }\n\n  // Function (signal getter / reactive text) → wrap with text markers\n  if (typeof node === 'function') {\n    const id = hydrationId++;\n    parts.push(`<!--forma-t:${id}-->`);\n    renderToBufferHydrated(node(), parts);\n    parts.push(`<!--/forma-t:${id}-->`);\n    return;\n  }\n\n  // Array → wrap with list markers\n  if (Array.isArray(node)) {\n    const id = hydrationId++;\n    parts.push(`<!--forma-l:${id}-->`);\n    for (const child of node) renderToBufferHydrated(child, parts);\n    parts.push(`<!--/forma-l:${id}-->`);\n    return;\n  }\n\n  // VNode\n  if (isVNode(node)) {\n    const id = hydrationId++;\n    const { tag, props, children } = node;\n\n    // Add hydration data-attribute to element\n    parts.push('<', tag, ` data-forma-h=\"${id}\"`);\n\n    // Render props as attributes\n    if (props) {\n      for (const [key, value] of Object.entries(props)) {\n        // Skip event handlers, refs, and internal props\n        if (key.startsWith('on') || key === 'ref' || key === 'dangerouslySetInnerHTML') continue;\n\n        const attrName = PROP_TO_ATTR[key] ?? key;\n\n        // Resolve reactive values\n        const resolved = typeof value === 'function' ? value() : value;\n\n        if (resolved === true) {\n          parts.push(' ', attrName);\n        } else if (resolved !== false && resolved != null) {\n          parts.push(' ', attrName, '=\"', escapeAttr(String(resolved)), '\"');\n        }\n      }\n    }\n\n    // Void elements\n    if (VOID_ELEMENTS.has(tag)) { parts.push(' />'); return; }\n\n    parts.push('>');\n\n    // dangerouslySetInnerHTML\n    if (props?.['dangerouslySetInnerHTML']) {\n      parts.push((props['dangerouslySetInnerHTML'] as { __html: string }).__html);\n    } else {\n      // Render children\n      for (const child of children) {\n        renderToBufferHydrated(child, parts);\n      }\n    }\n\n    parts.push('</', tag, '>');\n    return;\n  }\n\n  // Fallback: stringify\n  parts.push(escapeHtml(String(node)));\n}\n\n","/**\n * SSR-only signal: just a value holder, no reactivity needed on server.\n */\nexport function ssrSignal<T>(initial: T): [get: () => T, set: (v: T) => void] {\n  let value = initial;\n  return [() => value, (v) => { value = v; }];\n}\n\nexport function ssrComputed<T>(fn: () => T): () => T {\n  return fn; // On server, just call the function directly\n}\n","/**\n * FormaJS SSR - Client Swap Script\n *\n * Tiny inline script injected into the HTML stream that handles\n * out-of-order Suspense boundary resolution.\n *\n * When the server resolves a Suspense boundary, it sends:\n *   <script>$FORMA_SWAP(\"forma-s:0\",\"<resolved html>\")</script>\n *\n * This script replaces the fallback placeholder with the resolved content.\n */\n\n/**\n * Returns the client-side swap script as a string, ready to be injected\n * into the HTML stream (typically right after <body> or before first Suspense).\n */\nexport function getSwapScript(): string {\n  return `<script>\nfunction $FORMA_SWAP(id,html){\n  var el=document.getElementById(id);\n  if(el){\n    var tpl=document.createElement('template');\n    tpl.innerHTML=html;\n    el.replaceWith(tpl.content);\n  }\n}\n</script>`;\n}\n\n/**\n * Returns a script tag that swaps a specific Suspense boundary's content.\n * Called when an async resource resolves during streaming.\n */\nexport function getSwapTag(id: string, html: string): string {\n  // Escape </script> in the HTML to prevent breaking out of the script tag\n  const escaped = html.replace(/<\\/script>/gi, '<\\\\/script>');\n  return `<script>$FORMA_SWAP(\"${id}\",\"${escaped.replace(/\"/g, '\\\\\"').replace(/\\n/g, '\\\\n')}\")</script>`;\n}\n","/**\n * FormaJS SSR - Streaming Renderer\n *\n * Implements true chunked HTML streaming with out-of-order Suspense resolution.\n *\n * How it works:\n * 1. Yields shell HTML immediately (opening tags, head, static content)\n * 2. When a Suspense boundary is encountered:\n *    - Yields the fallback HTML with a placeholder: <div id=\"forma-s:N\" style=\"display:contents\">\n *    - Continues rendering siblings without blocking\n *    - When the async resource resolves, yields a swap script\n * 3. Suspense boundaries resolve independently in any order (out-of-order streaming)\n */\n\nimport { getSwapScript, getSwapTag } from './client-script.js';\n\n// Re-use render helpers from render.ts\n// We need the VNode type and rendering logic\ninterface VNode {\n  tag: string;\n  props: Record<string, unknown> | null;\n  children: unknown[];\n}\n\nfunction isVNode(v: unknown): v is VNode {\n  return v != null && typeof v === 'object' && 'tag' in v && 'children' in v;\n}\n\n// Escape functions\nfunction escapeHtml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#x27;');\n}\n\nfunction escapeAttr(str: string): string {\n  return str.replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n}\n\nconst VOID_ELEMENTS = new Set([\n  'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',\n  'link', 'meta', 'param', 'source', 'track', 'wbr',\n]);\n\nconst PROP_TO_ATTR: Record<string, string> = {\n  className: 'class',\n  htmlFor: 'for',\n  tabIndex: 'tabindex',\n};\n\n// ---------------------------------------------------------------------------\n// Suspense boundary tracking\n// ---------------------------------------------------------------------------\n\ninterface PendingBoundary {\n  id: string;\n  promise: Promise<string>;\n}\n\nlet suspenseCounter = 0;\nlet pendingBoundaries: PendingBoundary[] = [];\n\n// ---------------------------------------------------------------------------\n// Synchronous render to buffer (for non-async content)\n// ---------------------------------------------------------------------------\n\nfunction renderSync(node: unknown, parts: string[]): void {\n  if (node == null || node === true || node === false) return;\n  if (typeof node === 'string') { parts.push(escapeHtml(node)); return; }\n  if (typeof node === 'number') { parts.push(String(node)); return; }\n  if (typeof node === 'function') { renderSync(node(), parts); return; }\n  if (Array.isArray(node)) {\n    for (const child of node) renderSync(child, parts);\n    return;\n  }\n  if (isVNode(node)) {\n    const { tag, props, children } = node;\n    parts.push('<', tag);\n    if (props) {\n      for (const [key, value] of Object.entries(props)) {\n        if (key.startsWith('on') || key === 'ref' || key === 'dangerouslySetInnerHTML') continue;\n        const attrName = PROP_TO_ATTR[key] ?? key;\n        const resolved = typeof value === 'function' ? value() : value;\n        if (resolved === true) {\n          parts.push(' ', attrName);\n        } else if (resolved !== false && resolved != null) {\n          parts.push(' ', attrName, '=\"', escapeAttr(String(resolved)), '\"');\n        }\n      }\n    }\n    if (VOID_ELEMENTS.has(tag)) { parts.push(' />'); return; }\n    parts.push('>');\n    if (props?.['dangerouslySetInnerHTML']) {\n      parts.push((props['dangerouslySetInnerHTML'] as { __html: string }).__html);\n    } else {\n      for (const child of children) renderSync(child, parts);\n    }\n    parts.push('</', tag, '>');\n    return;\n  }\n  parts.push(escapeHtml(String(node)));\n}\n\n// ---------------------------------------------------------------------------\n// Suspense VNode detection\n// ---------------------------------------------------------------------------\n\n/**\n * A Suspense boundary VNode has a special shape:\n * { tag: 'forma-suspense', props: { fallback: VNode }, children: [asyncChildren] }\n *\n * Or it can be created via:\n * shSuspense(fallbackVNode, () => asyncContent)\n */\nexport interface SuspenseVNode {\n  tag: 'forma-suspense';\n  props: { fallback: unknown };\n  children: [() => Promise<unknown>];\n}\n\nfunction isSuspenseVNode(v: unknown): v is SuspenseVNode {\n  return isVNode(v) && v.tag === 'forma-suspense';\n}\n\n/**\n * Create a server-side Suspense VNode for streaming SSR.\n */\nexport function shSuspense(fallback: unknown, asyncChildren: () => Promise<unknown>): SuspenseVNode {\n  return {\n    tag: 'forma-suspense',\n    props: { fallback },\n    children: [asyncChildren],\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Streaming renderer\n// ---------------------------------------------------------------------------\n\nexport interface StreamOptions {\n  /** Script to bootstrap the client-side app (e.g. <script src=\"/app.js\"></script>) */\n  bootstrapScript?: string;\n  /** Whether to inject the $FORMA_SWAP client script (default: true) */\n  injectSwapScript?: boolean;\n}\n\n/**\n * Render a FormaJS virtual tree to a stream of HTML chunks.\n *\n * Yields HTML progressively:\n * - Static content is yielded immediately\n * - Suspense boundaries yield their fallback, then resolve later\n * - Resolved Suspense boundaries yield swap scripts\n *\n * Usage:\n * ```ts\n * import { renderToStream, shSuspense, sh } from '@getforma/core/ssr';\n *\n * const stream = renderToStream(\n *   sh('html', null,\n *     sh('body', null,\n *       sh('h1', null, 'Hello'),\n *       shSuspense(\n *         sh('div', null, 'Loading...'),\n *         async () => {\n *           const data = await fetchData();\n *           return sh('div', null, data.name);\n *         },\n *       ),\n *     ),\n *   ),\n * );\n *\n * for await (const chunk of stream) {\n *   response.write(chunk);\n * }\n * ```\n */\nexport async function* renderToStreamNew(\n  node: unknown,\n  options?: StreamOptions,\n): AsyncGenerator<string> {\n  // Reset state\n  suspenseCounter = 0;\n  pendingBoundaries = [];\n\n  const injectSwap = options?.injectSwapScript !== false;\n\n  // Inject the swap script first (if there could be Suspense boundaries)\n  if (injectSwap) {\n    yield getSwapScript();\n  }\n\n  // Render the main tree synchronously, collecting Suspense boundaries\n  const mainParts: string[] = [];\n  renderStreamNode(node, mainParts);\n  yield mainParts.join('');\n\n  // Yield bootstrap script if provided\n  if (options?.bootstrapScript) {\n    yield options.bootstrapScript;\n  }\n\n  // Wait for and yield all pending Suspense boundaries\n  // Each resolves independently (out-of-order)\n  while (pendingBoundaries.length > 0) {\n    const pending = [...pendingBoundaries];\n    pendingBoundaries = [];\n\n    // Race all pending boundaries — yield each as it resolves\n    const results = await Promise.allSettled(\n      pending.map(async (boundary) => {\n        const html = await boundary.promise;\n        return { id: boundary.id, html };\n      }),\n    );\n\n    for (const result of results) {\n      if (result.status === 'fulfilled') {\n        yield getSwapTag(result.value.id, result.value.html);\n      }\n      // On rejection, the fallback stays visible (no swap)\n    }\n  }\n}\n\n/**\n * Render a node synchronously. If a Suspense boundary is encountered,\n * render the fallback inline and queue the async resolution.\n */\nfunction renderStreamNode(node: unknown, parts: string[]): void {\n  if (node == null || node === true || node === false) return;\n  if (typeof node === 'string') { parts.push(escapeHtml(node)); return; }\n  if (typeof node === 'number') { parts.push(String(node)); return; }\n  if (typeof node === 'function') { renderStreamNode(node(), parts); return; }\n  if (Array.isArray(node)) {\n    for (const child of node) renderStreamNode(child, parts);\n    return;\n  }\n\n  // Suspense boundary: render fallback, queue async resolution\n  if (isSuspenseVNode(node)) {\n    const id = `forma-s:${suspenseCounter++}`;\n    const fallback = node.props.fallback;\n    const asyncFn = node.children[0]!;\n\n    // Render fallback inside a replaceable container\n    parts.push(`<div id=\"${id}\" style=\"display:contents\">`);\n    renderSync(fallback, parts);\n    parts.push('</div>');\n\n    // Queue the async resolution\n    const promise = asyncFn().then((resolved: unknown) => {\n      const resolvedParts: string[] = [];\n      renderSync(resolved, resolvedParts);\n      return resolvedParts.join('');\n    });\n    pendingBoundaries.push({ id, promise });\n    return;\n  }\n\n  // Regular VNode\n  if (isVNode(node)) {\n    const { tag, props, children } = node;\n    parts.push('<', tag);\n    if (props) {\n      for (const [key, value] of Object.entries(props)) {\n        if (key === 'fallback') continue; // skip internal suspense props\n        if (key.startsWith('on') || key === 'ref' || key === 'dangerouslySetInnerHTML') continue;\n        const attrName = PROP_TO_ATTR[key] ?? key;\n        const resolved = typeof value === 'function' ? value() : value;\n        if (resolved === true) {\n          parts.push(' ', attrName);\n        } else if (resolved !== false && resolved != null) {\n          parts.push(' ', attrName, '=\"', escapeAttr(String(resolved)), '\"');\n        }\n      }\n    }\n    if (VOID_ELEMENTS.has(tag)) { parts.push(' />'); return; }\n    parts.push('>');\n    if (props?.['dangerouslySetInnerHTML']) {\n      parts.push((props['dangerouslySetInnerHTML'] as { __html: string }).__html);\n    } else {\n      for (const child of children) renderStreamNode(child, parts);\n    }\n    parts.push('</', tag, '>');\n    return;\n  }\n\n  parts.push(escapeHtml(String(node)));\n}\n"]}

package/dist/tc39-compat.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var chunkFPSLC62A_cjs = require('./chunk-FPSLC62A.cjs');
+
+// src/reactive/tc39-compat.ts
+var State = class {
+  _get;
+  _set;
+  constructor(initialValue, options) {
+    const [getter, setter] = chunkFPSLC62A_cjs.createSignal(initialValue);
+    this._get = getter;
+    if (options?.equals) {
+      const eq = options.equals;
+      this._set = (v) => {
+        const next = typeof v === "function" ? v(getter()) : v;
+        if (!eq(getter(), next)) setter(() => next);
+      };
+    } else {
+      this._set = setter;
+    }
+    if (options?.name) {
+      Object.defineProperty(getter, "name", { value: options.name });
+    }
+  }
+  get() {
+    return this._get();
+  }
+  set(value) {
+    this._set(value);
+  }
+};
+var Computed = class {
+  _get;
+  constructor(fn) {
+    this._get = chunkFPSLC62A_cjs.createComputed(fn);
+  }
+  get() {
+    return this._get();
+  }
+};
+
+exports.Computed = Computed;
+exports.State = State;
+//# sourceMappingURL=tc39-compat.cjs.map
+//# sourceMappingURL=tc39-compat.cjs.map

package/dist/tc39-compat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reactive/tc39-compat.ts"],"names":["createSignal","createComputed"],"mappings":";;;;;AAyBO,IAAM,QAAN,MAAe;AAAA,EACZ,IAAA;AAAA,EACA,IAAA;AAAA,EAER,WAAA,CAAY,cAAiB,OAAA,EAA4B;AACvD,IAAA,MAAM,CAAC,MAAA,EAAQ,MAAM,CAAA,GAAIA,+BAAa,YAAY,CAAA;AAClD,IAAA,IAAA,CAAK,IAAA,GAAO,MAAA;AAGZ,IAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,MAAA,MAAM,KAAK,OAAA,CAAQ,MAAA;AACnB,MAAA,IAAA,CAAK,IAAA,GAAO,CAAC,CAAA,KAA4B;AACvC,QAAA,MAAM,OAAO,OAAO,CAAA,KAAM,aAAc,CAAA,CAAqB,MAAA,EAAQ,CAAA,GAAI,CAAA;AACzE,QAAA,IAAI,CAAC,GAAG,MAAA,EAAO,EAAG,IAAI,CAAA,EAAG,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,MAC5C,CAAA;AAAA,IACF,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,IAAA,GAAO,MAAA;AAAA,IACd;AAEA,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,MAAA,CAAO,eAAe,MAAA,EAAQ,MAAA,EAAQ,EAAE,KAAA,EAAO,OAAA,CAAQ,MAAM,CAAA;AAAA,IAC/D;AAAA,EACF;AAAA,EAEA,GAAA,GAAS;AACP,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB;AAAA,EAEA,IAAI,KAAA,EAAgB;AAClB,IAAA,IAAA,CAAK,KAAK,KAAK,CAAA;AAAA,EACjB;AACF;AAcO,IAAM,WAAN,MAAkB;AAAA,EACf,IAAA;AAAA,EAER,YAAY,EAAA,EAAa;AACvB,IAAA,IAAA,CAAK,IAAA,GAAOC,iCAAe,EAAE,CAAA;AAAA,EAC/B;AAAA,EAEA,GAAA,GAAS;AACP,IAAA,OAAO,KAAK,IAAA,EAAK;AAAA,EACnB;AACF","file":"tc39-compat.cjs","sourcesContent":["/**\n * Forma Reactive - TC39 Signals Compatibility Layer\n *\n * Optional class-based API matching the TC39 Signals proposal (Stage 1).\n * Not included in main bundle — import from '@getforma/core/tc39' subpath.\n *\n * When the TC39 proposal advances, these classes can be replaced with\n * native Signal.State and Signal.Computed.\n *\n * @see https://github.com/tc39/proposal-signals\n */\n\nimport { createSignal, type SignalOptions } from './signal.js';\nimport { createComputed } from './computed.js';\n\n/**\n * TC39-compatible reactive state container.\n * Equivalent to `Signal.State` in the TC39 proposal.\n *\n * ```ts\n * const count = new State(0);\n * console.log(count.get()); // 0\n * count.set(1);\n * ```\n */\nexport class State<T> {\n  private _get: () => T;\n  private _set: (v: T | ((prev: T) => T)) => void;\n\n  constructor(initialValue: T, options?: SignalOptions<T>) {\n    const [getter, setter] = createSignal(initialValue);\n    this._get = getter;\n\n    // Handle custom equality in the TC39 compat layer (not in createSignal hot path)\n    if (options?.equals) {\n      const eq = options.equals;\n      this._set = (v: T | ((prev: T) => T)) => {\n        const next = typeof v === 'function' ? (v as (prev: T) => T)(getter()) : v;\n        if (!eq(getter(), next)) setter(() => next);\n      };\n    } else {\n      this._set = setter;\n    }\n\n    if (options?.name) {\n      Object.defineProperty(getter, 'name', { value: options.name });\n    }\n  }\n\n  get(): T {\n    return this._get();\n  }\n\n  set(value: T): void {\n    this._set(value);\n  }\n}\n\n/**\n * TC39-compatible computed value.\n * Equivalent to `Signal.Computed` in the TC39 proposal.\n *\n * ```ts\n * const count = new State(0);\n * const doubled = new Computed(() => count.get() * 2);\n * console.log(doubled.get()); // 0\n * count.set(5);\n * console.log(doubled.get()); // 10\n * ```\n */\nexport class Computed<T> {\n  private _get: () => T;\n\n  constructor(fn: () => T) {\n    this._get = createComputed(fn);\n  }\n\n  get(): T {\n    return this._get();\n  }\n}\n"]}