@fictjs/ssr 0.20.0 → 0.22.0

package/README.md

@@ -250,11 +250,17 @@ interface RenderToStringOptions {
   snapshotTarget?: 'container' | 'body' | 'head'
 
   // Runtime Configuration
-  exposeGlobals?: boolean // Default: true
+  exposeGlobals?: boolean // Default: false; opt-in compatibility mode
   manifest?: Record<string, string> | string
 }
 ```
 
+By default SSR does not write `window`, `document`, `Node`, or related DOM constructors to
+`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.
+
 ### renderToDocument
 
 ```typescript
@@ -306,6 +312,10 @@ The asset is published as `@fictjs/ssr/fict-stream-runtime.js`. Build tools that
 need to materialize it themselves can import `createStreamRuntimeCode` from
 `@fictjs/ssr/stream-runtime`.
 
+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`.
+
 ### renderToPipeableStream
 
 Node.js-style stream variant (compatible with `pipe()`).
@@ -324,10 +334,11 @@ await allReady
 ### renderToPartial
 
 Generate a complete shell HTML plus a deferred patch stream for Partial Prerendering workflows.
-This is an advanced API and currently considered **Preview** in v1.0.
+This is an advanced API and currently considered **Experimental Preview** in v1.0; do not treat the return shape as frozen.
+Import it from the explicit Preview entrypoint, not the supported package main export.
 
 ```typescript
-import { renderToPartial } from '@fictjs/ssr'
+import { renderToPartial } from '@fictjs/ssr/experimental'
 
 const { shell, stream, shellReady, allReady } = renderToPartial(() => <App />, {
   mode: 'shell',
@@ -469,7 +480,7 @@ Generated detailed `fict.manifest.json` during production build, mapping virtual
 
 ## Partial Prerendering
 
-`renderToPartial()` enables a PPR-style split:
+`renderToPartial()` is an **Experimental Preview** API that enables a PPR-style split:
 
 1. **Shell phase**: serve/cache `shell` as static-first HTML.
 2. **Deferred phase**: deliver `stream` patches for resolved Suspense boundaries.