@fictjs/ssr 0.27.0 → 0.28.0

package/README.md

@@ -1,6 +1,13 @@
 # @fictjs/ssr
 
-Fict's Server-Side Rendering (SSR) package, providing high-performance server-side rendering and client-side resumability capabilities.
+Fict's Satellite Server-Side Rendering (SSR) package, providing supported
+string and streaming rendering plus opt-in client resumability.
+
+> **Preview** — resumability, snapshot schema v2, and partial prerendering have no
+> semver guarantee and are excluded from Core 1.0. They require
+> `includeSnapshot: true`, compiler `resumable: true`, and the
+> `fict/experimental/loader` entrypoint. Basic string and streaming SSR does not
+> enable them by default.
 
 ## Table of Contents
 
@@ -20,7 +27,9 @@ Fict's Server-Side Rendering (SSR) package, providing high-performance server-si
 
 ## Overview
 
-Fict SSR adopts a **Resumability** architecture, which is fundamentally different from traditional Hydration:
+Supported SSR produces HTML without a resumability snapshot by default. The
+optional **Preview Resumability** architecture is fundamentally different from
+traditional hydration:
 
 | Feature                   | Traditional Hydration             | Fict Resumability                 |
 | ------------------------- | --------------------------------- | --------------------------------- |
@@ -29,7 +38,7 @@ Fict SSR adopts a **Resumability** architecture, which is fundamentally differen
 | Handler Loading           | All preloaded                     | Lazy loaded on demand             |
 | State Restoration         | Re-calculated                     | Restored from serialized snapshot |
 
-### How it Works
+### How Preview Resumability Works
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
@@ -79,7 +88,7 @@ import { renderToString } from '@fictjs/ssr'
 import { App } from './App'
 
 const html = renderToString(() => <App />, {
-  includeSnapshot: true,  // Include state snapshot (default true)
+  includeSnapshot: true, // Explicit Preview snapshot opt-in (default false)
   containerId: 'app',
   manifest: './dist/client/fict.manifest.json',
 })
@@ -90,7 +99,7 @@ const html = renderToString(() => <App />, {
 ```typescript
 // entry-client.tsx
 import { render } from 'fict'
-import { installResumableLoader } from 'fict/loader'
+import { installResumableLoader } from 'fict/experimental/loader'
 import { App } from './App'
 
 // Load manifest (production)
@@ -285,7 +294,7 @@ interface RenderToStringOptions {
   doctype?: string | null
 
   // Resumability Configuration
-  includeSnapshot?: boolean // Default: true
+  includeSnapshot?: boolean // Preview opt-in; default: false
   snapshotScriptId?: string // Default: '__FICT_SNAPSHOT__'
   snapshotTarget?: 'container' | 'body' | 'head'
 
@@ -299,7 +308,11 @@ By default SSR does not write `window`, `document`, `Node`, or related DOM const
 `globalThis`. This keeps concurrent renders from racing over process-global DOM state. Components
 should use Fict's render-provided document/ownerDocument paths; set `exposeGlobals: true` only for
 legacy code that still reads DOM globals during server render. That compatibility mode is restored
-on `dispose()`, but it is not concurrency-safe while overlapping renders are active.
+on `dispose()`. Default renders may overlap each other, but a compatibility render is exclusive
+with every other SSR render so no request can observe another request's process-global DOM. On a
+non-extensible hardened global object, ordinary render-local SSR remains available without a
+process marker; compatibility mode remains unavailable because it cannot acquire its exclusive
+lease or install DOM globals.
 
 ### renderToStringAsync
 
@@ -367,6 +380,11 @@ Trusted Types deployments should use this external observer runtime. The patch
 runtime moves `<template>` content with DOM APIs (`content` + `insertBefore`) and
 does not call `innerHTML`, `insertAdjacentHTML`, `eval`, or `Function`.
 
+When Preview snapshots are enabled on a nonce-free strict-CSP route, keep
+`snapshotTarget` at `container` or `body`. Incremental `head` snapshots require a
+small executable mover; external runtime mode rejects that combination unless
+`scriptNonce` is non-empty.
+
 Each shell stream receives an automatic unique namespace for its Suspense patch
 identifiers. When independently cached fragments or streams from multiple
 services can be composed into one document, pass a stable

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fictjs/ssr",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Fict server-side rendering",
   "publishConfig": {
     "access": "public",
@@ -46,11 +46,11 @@
   ],
   "dependencies": {
     "linkedom": "^0.18.12",
-    "@fictjs/runtime": "0.27.0"
+    "@fictjs/runtime": "0.28.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.3",
-    "fict": "0.27.0"
+    "fict": "0.28.0"
   },
   "keywords": [
     "fict",

package/dist/experimental.cjs

@@ -1,3 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_render_core = require("./render-core-D_EheVwh.cjs");
-exports.renderToPartial = require_render_core.renderToPartial;

package/dist/experimental.d.cts

@@ -1,2 +0,0 @@
-import { l as renderToPartial, t as PartialPrerenderResult } from "./render-core-KCiJV_SK.cjs";
-export { type PartialPrerenderResult, renderToPartial };

package/dist/experimental.d.ts

@@ -1,2 +0,0 @@
-import { l as renderToPartial, t as PartialPrerenderResult } from "./render-core-KCiJV_SK.js";
-export { type PartialPrerenderResult, renderToPartial };

package/dist/experimental.js

@@ -1,2 +0,0 @@
-import { r as renderToPartial } from "./render-core-D0nOT_Pe.js";
-export { renderToPartial };

package/dist/experimental.node.cjs

@@ -1,5 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_render_core = require("./render-core-D_EheVwh.cjs");
-require("./node-session-carrier-CTo-1Awq.cjs");
-require("./experimental.cjs");
-exports.renderToPartial = require_render_core.renderToPartial;

package/dist/experimental.node.d.cts

@@ -1,2 +0,0 @@
-import { l as renderToPartial, t as PartialPrerenderResult } from "./render-core-KCiJV_SK.cjs";
-export { type PartialPrerenderResult, renderToPartial };

package/dist/experimental.node.d.ts

@@ -1,2 +0,0 @@
-import { l as renderToPartial, t as PartialPrerenderResult } from "./render-core-KCiJV_SK.js";
-export { type PartialPrerenderResult, renderToPartial };

package/dist/experimental.node.js

@@ -1,4 +0,0 @@
-import { r as renderToPartial } from "./render-core-D0nOT_Pe.js";
-import "./node-session-carrier-ClqRbdoQ.js";
-import "./experimental.js";
-export { renderToPartial };

package/dist/fict-stream-runtime.js

@@ -1 +0,0 @@
-(function(){var runtime=window.__FICT_STREAM;function walk(root,visit){var stack=[root];while(stack.length){var node=stack.pop();if(visit(node)===false)return false;var container=node.nodeType===1&&node.localName==="template"&&node.content?node.content:node;for(var child=container.lastChild;child;child=child.previousSibling)stack.push(child);}return true;}if(!runtime||typeof runtime.apply!=="function"){var cache=new Map();function findTemplate(id){var tpl=null;walk(document,function(n){if(n.nodeType===1&&n.localName==="template"&&n.content&&n.getAttribute("data-fict-suspense")===id){tpl=n;return false;}});return tpl;}function find(id){var hit=cache.get(id);if(hit)return hit;var startMarker="fict:suspense-start:"+id,endMarker="fict:suspense-end:"+id;walk(document,function(n){if(n.nodeType!==8||n.data!==startMarker)return;var end=n.nextSibling;while(end&&(end.nodeType!==8||end.data!==endMarker))end=end.nextSibling;if(end){hit={start:n,end:end};return false;}});if(hit)cache.set(id,hit);return hit;}function apply(id){if(typeof id!=="string"||!id)return;var tpl=findTemplate(id);if(!tpl)return;var b=find(id);if(!b)return;var parent=b.start.parentNode;if(!parent||b.end.parentNode!==parent)return;var cursor=b.start.nextSibling;while(cursor&&cursor!==b.end)cursor=cursor.nextSibling;if(cursor!==b.end)return;var content=tpl.content;var ns=tpl.getAttribute("data-fict-patch-namespace");if(ns){var tag=ns==="svg"?"svg":ns==="mathml"?"math":null;var wrapper=content.firstElementChild;if(!tag||!wrapper||wrapper.localName!==tag)return;var fragment=document.createDocumentFragment();while(wrapper.firstChild)fragment.appendChild(wrapper.firstChild);content=fragment;}var node=b.start.nextSibling;while(node&&node!==b.end){var next=node.nextSibling;node.parentNode&&node.parentNode.removeChild(node);node=next;}parent.insertBefore(content,b.end);tpl.parentNode&&tpl.parentNode.removeChild(tpl);}runtime={apply:apply};window.__FICT_STREAM=runtime;}if(runtime.observerInstalled)return;runtime.observerInstalled=true;function scan(root){var ids=[];walk(root,function(n){if(n.nodeType===1&&n.localName==="template"&&n.content&&n.hasAttribute("data-fict-suspense")){var id=n.getAttribute("data-fict-suspense");if(id)ids.push(id);}});for(var i=0;i<ids.length;i++)runtime.apply(ids[i]);}if(typeof MutationObserver==="function"){new MutationObserver(function(muts){for(var i=0;i<muts.length;i++){for(var j=0;j<muts[i].addedNodes.length;j++){var n=muts[i].addedNodes[j];if(n.nodeType===1)scan(n);}}}).observe(document.documentElement||document,{childList:true,subtree:true});}if(document.readyState==="loading"){document.addEventListener("DOMContentLoaded",function(){scan(document);},{once:true});}else{scan(document);}})();

package/dist/index.cjs

@@ -1,8 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_render_core = require("./render-core-D_EheVwh.cjs");
-exports.createSSRDocument = require_render_core.createSSRDocument;
-exports.renderToDocument = require_render_core.renderToDocument;
-exports.renderToPipeableStream = require_render_core.renderToPipeableStream;
-exports.renderToStream = require_render_core.renderToStream;
-exports.renderToString = require_render_core.renderToString;
-exports.renderToStringAsync = require_render_core.renderToStringAsync;

package/dist/index.d.cts

@@ -1,2 +0,0 @@
-import { a as RenderToStringOptions, c as renderToDocument, d as renderToStream, f as renderToString, i as RenderToStreamOptions, n as PipeableStream, o as SSRDom, p as renderToStringAsync, r as RenderToDocumentResult, s as createSSRDocument, u as renderToPipeableStream } from "./render-core-KCiJV_SK.cjs";
-export { type PipeableStream, type RenderToDocumentResult, type RenderToStreamOptions, type RenderToStringOptions, type SSRDom, createSSRDocument, renderToDocument, renderToPipeableStream, renderToStream, renderToString, renderToStringAsync };

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-import { a as RenderToStringOptions, c as renderToDocument, d as renderToStream, f as renderToString, i as RenderToStreamOptions, n as PipeableStream, o as SSRDom, p as renderToStringAsync, r as RenderToDocumentResult, s as createSSRDocument, u as renderToPipeableStream } from "./render-core-KCiJV_SK.js";
-export { type PipeableStream, type RenderToDocumentResult, type RenderToStreamOptions, type RenderToStringOptions, type SSRDom, createSSRDocument, renderToDocument, renderToPipeableStream, renderToStream, renderToString, renderToStringAsync };

package/dist/index.js

@@ -1,2 +0,0 @@
-import { a as renderToStream, i as renderToPipeableStream, n as renderToDocument, o as renderToString, s as renderToStringAsync, t as createSSRDocument } from "./render-core-D0nOT_Pe.js";
-export { createSSRDocument, renderToDocument, renderToPipeableStream, renderToStream, renderToString, renderToStringAsync };

package/dist/index.node.cjs

@@ -1,10 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_render_core = require("./render-core-D_EheVwh.cjs");
-require("./index.cjs");
-require("./node-session-carrier-CTo-1Awq.cjs");
-exports.createSSRDocument = require_render_core.createSSRDocument;
-exports.renderToDocument = require_render_core.renderToDocument;
-exports.renderToPipeableStream = require_render_core.renderToPipeableStream;
-exports.renderToStream = require_render_core.renderToStream;
-exports.renderToString = require_render_core.renderToString;
-exports.renderToStringAsync = require_render_core.renderToStringAsync;

package/dist/index.node.d.cts

@@ -1,2 +0,0 @@
-import { a as RenderToStringOptions, c as renderToDocument, d as renderToStream, f as renderToString, i as RenderToStreamOptions, n as PipeableStream, o as SSRDom, p as renderToStringAsync, r as RenderToDocumentResult, s as createSSRDocument, u as renderToPipeableStream } from "./render-core-KCiJV_SK.cjs";
-export { type PipeableStream, type RenderToDocumentResult, type RenderToStreamOptions, type RenderToStringOptions, type SSRDom, createSSRDocument, renderToDocument, renderToPipeableStream, renderToStream, renderToString, renderToStringAsync };

package/dist/index.node.d.ts

@@ -1,2 +0,0 @@
-import { a as RenderToStringOptions, c as renderToDocument, d as renderToStream, f as renderToString, i as RenderToStreamOptions, n as PipeableStream, o as SSRDom, p as renderToStringAsync, r as RenderToDocumentResult, s as createSSRDocument, u as renderToPipeableStream } from "./render-core-KCiJV_SK.js";
-export { type PipeableStream, type RenderToDocumentResult, type RenderToStreamOptions, type RenderToStringOptions, type SSRDom, createSSRDocument, renderToDocument, renderToPipeableStream, renderToStream, renderToString, renderToStringAsync };

package/dist/index.node.js

@@ -1,4 +0,0 @@
-import { a as renderToStream, i as renderToPipeableStream, n as renderToDocument, o as renderToString, s as renderToStringAsync, t as createSSRDocument } from "./render-core-D0nOT_Pe.js";
-import "./index.js";
-import "./node-session-carrier-ClqRbdoQ.js";
-export { createSSRDocument, renderToDocument, renderToPipeableStream, renderToStream, renderToString, renderToStringAsync };

package/dist/node-session-carrier-CTo-1Awq.cjs

@@ -1,8 +0,0 @@
-let _fictjs_runtime_internal = require("@fictjs/runtime/internal");
-//#region src/node-session-carrier.ts
-const sessionStorage = new (require("node:async_hooks")).AsyncLocalStorage();
-(0, _fictjs_runtime_internal.__fictInstallSSRSessionCarrier)({
-	getStore: () => sessionStorage.getStore(),
-	run: (session, fn) => sessionStorage.run(session, fn)
-});
-//#endregion

package/dist/node-session-carrier-ClqRbdoQ.js

@@ -1,12 +0,0 @@
-import { __fictInstallSSRSessionCarrier } from "@fictjs/runtime/internal";
-import { AsyncLocalStorage } from "node:async_hooks";
-//#region src/node-session-carrier.ts
-const sessionStorage = new AsyncLocalStorage();
-__fictInstallSSRSessionCarrier({
-	getStore: () => sessionStorage.getStore(),
-	run: (session, fn) => sessionStorage.run(session, fn)
-});
-//#endregion
-export {};
-
-//# sourceMappingURL=node-session-carrier-ClqRbdoQ.js.map

package/dist/node-session-carrier-ClqRbdoQ.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-session-carrier-ClqRbdoQ.js","names":[],"sources":["../src/node-session-carrier.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { __fictInstallSSRSessionCarrier, type FictSSRSession } from '@fictjs/runtime/internal'\n\nconst sessionStorage = new AsyncLocalStorage<FictSSRSession>()\n\n__fictInstallSSRSessionCarrier({\n  getStore: () => sessionStorage.getStore(),\n  run: (session, fn) => sessionStorage.run(session, fn),\n})\n"],"mappings":";;;AAIA,MAAM,iBAAiB,IAAI,kBAAkC;AAE7D,+BAA+B;CAC7B,gBAAgB,eAAe,SAAS;CACxC,MAAM,SAAS,OAAO,eAAe,IAAI,SAAS,EAAE;AACtD,CAAC"}