npm - @voltro/web - Versions diffs - 0.9.0 → 0.10.0 - Mend

@voltro/web 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/CHANGELOG.md +310 -7
package/dist/index.d.ts +18 -5
package/dist/index.js +34 -34
package/dist/{mount-Gsn3ouYx.js → mount-CKsOnjiF.js} +3 -3
package/dist/mount.js +1 -1
package/dist/{routerState-DpUqogK8.js → routerState-cjTiUIum.js} +21 -11
package/dist/{serverContext-COzippNt.js → serverContext-BP0ywwLZ.js} +198 -193
package/dist/ssr.d.ts +61 -15
package/dist/ssr.js +9 -9
package/package.json +3 -3

package/dist/ssr.d.ts CHANGED Viewed

@@ -22,6 +22,11 @@ import { ReactNode } from 'react';
  *    and never hydrates the root, so nothing ever consumes the registry
  *    promises. Islands take their props from their own serialised payload, not
  *    from loader data, so there is no value in wiring them in.
+ *
+ * The one place `renderMode` is NOT the deciding input is the SSR layout shell
+ * (`layoutShell` above): a `renderMode:'spa'` page under an SSR layout chain is
+ * streamed per request by dev/serve — so a LAYOUT loader may defer there — and
+ * written to a file by the build, where it may not.
  */
 export declare const assertDeferralSupported: (target: DeferralTarget) => void;
@@ -31,6 +36,23 @@ export declare interface DeferralTarget {
     readonly page: string;
     readonly renderMode: string;
     readonly interactive: string;
+    /**
+     * Set ONLY on the SSR-layout-shell path — a `renderMode:'spa'` page under an
+     * SSR layout chain, where the server renders the LAYOUTS around an empty page
+     * slot and runs only the layout loaders. `renderMode` is `'spa'` there, so
+     * without this the shell would be rejected by the rule below; the thing that
+     * actually decides whether it can stream is HOW the shell is delivered:
+     *
+     *  - `'stream'` — a per-request response (`voltro dev` / `voltro serve`). It
+     *    goes out through `renderPageToStream`, so a LAYOUT loader may `defer()`:
+     *    the chain + empty slot flush immediately and the deferred value streams
+     *    in behind its `<Await>` boundary, exactly as on an `ssr` page.
+     *  - `'artefact'` — the build-time prerender, which writes an HTML FILE. A
+     *    file has no "after", so `defer()` is refused there by name.
+     *
+     * Absent for every full-page render, where `renderMode` alone decides.
+     */
+    readonly layoutShell?: 'stream' | 'artefact' | undefined;
 }
 /** Brand key on the object `defer()` returns. A single explicit container
@@ -64,6 +86,13 @@ declare interface ErrorBoundaryProps {
  * re-run it on hydration (the flash this whole payload exists to remove).
  */
 export declare interface InlinedRouterState {
+    /** The pathname the server rendered THIS document for.
+     *
+     *  Present so the client can tell "the server rendered my route" from "a
+     *  static host handed me some other route's document as its SPA fallback".
+     *  Without it the two are indistinguishable — the payload parses either way,
+     *  and `mount()` would adopt markup for a route it is not on. */
+    readonly path?: string;
     /** The page (leaf) loader's result — exactly the value the server render
      *  provided to the page's `LoaderDataContext`. */
     readonly page?: unknown;
@@ -250,20 +279,6 @@ export declare interface PreparedLoaderData {
     readonly deferredIds: Readonly<Record<string, string>> | undefined;
 }
-/**
- * The `<script>` every streaming SSR emitter puts in `<head>`, before the
- * shell. Must precede any settle script — which is automatic, since settle
- * scripts ride in the body.
- */
-export declare const renderDeferredRegistryScript: () => string;
-/**
- * Helper for the build pipeline: stringify the resolved meta into a
- * `<head>`-ready HTML fragment. Returns an empty string when no meta
- * is set so the caller can blindly inject the result.
- */
-export declare const renderMetaToHtml: (meta: PageMeta | null) => string;
 /**
  * How a page's HTML is produced.
  *
@@ -286,8 +301,33 @@ export declare const renderMetaToHtml: (meta: PageMeta | null) => string;
  *               tenant-scoped first paint.
  *   - 'isr'  — Like 'ssr' on the first request, then cached and
  *               revalidated in the background on a TTL.
+ *
+ * The value set is single-sourced from {@link RENDER_MODES} so the type and
+ * every runtime check derive from ONE literal list. There are no aliases — an
+ * unrecognised value is rejected at codegen/discovery time by the CLI, not
+ * silently passed through.
+ */
+declare const RENDER_MODES: readonly ["static", "spa", "ssr", "isr"];
+/**
+ * The `<script>` every streaming SSR emitter puts in `<head>`, before the
+ * shell. Must precede any settle script — which is automatic, since settle
+ * scripts ride in the body.
+ */
+export declare const renderDeferredRegistryScript: () => string;
+/**
+ * Helper for the build pipeline: stringify the resolved meta into a
+ * `<head>`-ready HTML fragment. Returns an empty string when no meta
+ * is set so the caller can blindly inject the result.
+ */
+export declare const renderMetaToHtml: (meta: PageMeta | null) => string;
+/**
+ * A page's render mode — one of {@link RENDER_MODES}, from which this type is
+ * derived. Closed set: an unrecognised value is rejected at codegen time.
  */
-declare type RenderMode = 'static' | 'spa' | 'ssr' | 'isr';
+declare type RenderMode = (typeof RENDER_MODES)[number];
 export declare interface RenderPageOptions {
     /** Descriptor produced by codegen (`pageRoute(...)`). */
@@ -421,6 +461,12 @@ export declare const renderRouterStateScript: (input: RouterStateInput) => strin
 export declare const ROUTER_STATE_SCRIPT_ID = "__voltro_state__";
 export declare interface RouterStateInput {
+    /** The pathname this render is FOR. Every emitter has it — it is the same
+     *  value handed to the renderer as `pathname` — and passing it is required
+     *  rather than optional on purpose: a payload without it cannot be matched
+     *  against the document it lands in, which is the whole point of carrying
+     *  it (see {@link parseRouterState}). */
+    readonly path: string;
     /** Page loader result passed to `renderPageToHtml` / `renderPageToStream`. */
     readonly loaderData: unknown;
     /** Layout loader results, keyed by chain index — the same object passed to

package/dist/ssr.js CHANGED Viewed

@@ -1,21 +1,21 @@
-import { _ as e, a as t, g as n, m as r, n as i, p as a, s as o, t as s } from "./routerState-DpUqogK8.js";
-import { C as c, c as l, p as u, r as d, t as f, u as p } from "./serverContext-COzippNt.js";
+import { _ as e, a as t, g as n, m as r, n as i, p as a, s as o, t as s } from "./routerState-cjTiUIum.js";
+import { c, m as l, r as u, t as d, u as f, w as p } from "./serverContext-BP0ywwLZ.js";
 import { createElement as m } from "react";
 import { renderToPipeableStream as h, renderToString as g } from "react-dom/server";
 //#region src/ssr.tsx
 var _ = (e, t, n, r) => {
-	let i = m(l.Provider, { value: n }, m(e));
+	let i = m(c.Provider, { value: n }, m(e));
 	if (!t) return i;
 	for (let e = t.length - 1; e >= 0; e--) {
 		let n = t[e];
 		if (n.Layout) {
 			let t = n.Layout;
-			i = m(l.Provider, { value: r(e) }, m(t, { children: i }));
+			i = m(c.Provider, { value: r(e) }, m(t, { children: i }));
 		}
 	}
 	return i;
 }, v = (e) => {
-	let { descriptor: t, params: n, pathname: r, loaderData: i, segmentLoaderData: a, requestContext: o, outerWrap: s, locale: l, pageSlot: d } = e, h = c(t.meta, n, i, l), g = {
+	let { descriptor: t, params: n, pathname: r, loaderData: i, segmentLoaderData: a, requestContext: o, outerWrap: s, locale: c, pageSlot: u } = e, h = p(t.meta, n, i, c), g = {
 		pathname: r,
 		search: "",
 		params: n,
@@ -26,10 +26,10 @@ var _ = (e, t, n, r) => {
 		prefetch: () => {},
 		registerBlocker: () => () => {},
 		blocked: null
-	}, v = d ? p : t.Component;
+	}, v = u ? f : t.Component;
 	if (!v) throw Error(`SSR received a descriptor with no Component for "${r}". Lazy page routes are a client-only optimization and must not be used on the server.`);
-	let y = m(u.Provider, { value: g }, _(v, t.chain, d ? void 0 : i, (e) => a?.[e]));
-	return o && (y = m(f.Provider, { value: o }, y)), s && (y = s(y)), {
+	let y = m(l.Provider, { value: g }, _(v, t.chain, u ? void 0 : i, (e) => a?.[e]));
+	return o && (y = m(d.Provider, { value: o }, y)), s && (y = s(y)), {
 		tree: y,
 		meta: h
 	};
@@ -74,4 +74,4 @@ var _ = (e, t, n, r) => {
 	return t.join("\n    ");
 }, S = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), C = (e) => e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 //#endregion
-export { s as ROUTER_STATE_SCRIPT_ID, o as assertDeferralSupported, i as encodeRouterState, a as isDeferredLoaderResult, d as parseCookieHeader, r as prepareDeferredLoaderData, n as renderDeferredRegistryScript, x as renderMetaToHtml, y as renderPageToHtml, b as renderPageToStream, t as renderRouterStateScript, e as serialiseStateForInlining };
+export { s as ROUTER_STATE_SCRIPT_ID, o as assertDeferralSupported, i as encodeRouterState, a as isDeferredLoaderResult, u as parseCookieHeader, r as prepareDeferredLoaderData, n as renderDeferredRegistryScript, x as renderMetaToHtml, y as renderPageToHtml, b as renderPageToStream, t as renderRouterStateScript, e as serialiseStateForInlining };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/web",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "The Voltro web framework — file-based routing, render modes (SSR / SSG / islands), the page-export contract, data hooks, and the browser mount.",
   "keywords": [
     "voltro",
@@ -52,8 +52,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/client": "0.9.0",
-    "@voltro/ui": "0.9.0"
+    "@voltro/client": "0.10.0",
+    "@voltro/ui": "0.10.0"
   },
   "peerDependencies": {
     "@effect/platform": "^0.96.2",