lit-ui-router-ssr 0.7.0 → 0.8.0

package/README.md

@@ -24,14 +24,14 @@ imports the pre-1.0 renderer or re-derives the incantation.
   on the page carries `defer-hydration` and renders nothing until the client's walk reaches it.
 - **The hydration signature.** A page rendered from a template opens on a JSON data block,
   `<script type="application/json" data-lit-ui-router-ssr>`, naming this package's version, the
-  state the router stood on, that state's url parameter values, and the resolved values the
-  `payload` hook supplies. A page `renderShell` returns as a string is written as-is, without one.
+  state the router stood on, that state's url parameter values, and the resolved values
+  `dehydrate` or the `payload` hook draws. A page `renderShell` returns as a string is written as-is, without one.
 - **The lit render inside the emit loop.** The loop itself — verdict to file name, redirect to
   rules line, the `_redirects` file, delegating states skipped, tally, warnings for paths that
   matched nothing — is
   `prerender` from `ui-router-server/prerender`, which takes any render. This package's `prerender`
   supplies the lit one and takes the same options, plus `router`, `renderShell`, `document`,
-  `root`, `elementRenderers`, `payload`, `responses` and `origin`. No SPA catch-all is ever written: one
+  `root`, `elementRenderers`, `dehydrate`, `payload`, `responses` and `origin`. No SPA catch-all is ever written: one
   turns every 404 into a 200.
 - **Response states after settle.** `responder` runs the handler bound to a response state's name
   with the resolves its transition landed with.
@@ -51,7 +51,8 @@ npm install lit-ui-router-ssr
 `lit-ui-router`, `ui-router-server`, `@lit-labs/ssr`, `@lit-labs/ssr-client`, `lit`, and
 `@uirouter/core` are peer dependencies. `@lit-labs/ssr` is the server half and `@lit-labs/ssr-client`
 the client half, so a bundle takes one or the other, never both. `@lit-labs/ssr-client` is optional:
-install it when you import `lit-ui-router-ssr/client`.
+install it when you import `lit-ui-router-ssr/client`. `lit-ui-router-ssr/vite` wraps
+`ui-router-server/vite`, so it takes `vite` through that package's optional peer.
 
 The `lit-ui-router` peer is `^1.19.0`: the server renders a view through the helper `<ui-view>`
 renders through, and the client hands a served class element to the view it wakes.
@@ -88,6 +89,14 @@ on. `dryRun: true` plans all of it and writes nothing.
 Files land through `node:fs`, imported lazily on first write; pass `write` to emit into memory or a
 virtual fs instead.
 
+## After `vite build`
+
+`lit-ui-router-ssr/vite` prerenders the built app after `vite build`. Its `serverRouterPlugin` is
+`ui-router-server/vite`'s, with the DOM shim and `lit-ui-router-ssr/register` loaded before the
+prerender script, and its `definePrerender` calls this package's `prerender` with the options the
+script returns; [Prerender with Vite](https://lit-ui-router.dev/guides/prerender-with-vite) shows
+both files in full.
+
 ## Static hosts add a trailing slash
 
 A shell page lands at `<subpath>/index.html`. Cloudflare Pages, Netlify, and S3-style hosts serve
@@ -144,22 +153,17 @@ as `responses`, writing a 2xx body at the path its url spells or a 3xx as a rule
 
 ## Adopting the resolves on boot
 
-The `payload` option hands each rendered page's landed transition to a hook, which returns the
-resolve payload to write. `dehydrate` from `ui-router-server/ssr` draws one, and the hook decides what to do with the resolves it leaves out:
+The `dehydrate` option draws each rendered page's resolve payload: `prerender` calls `dehydrate`
+from `ui-router-server/ssr` on the page's landed transition with the options given, so
+`shouldDehydrate` and `transport` act exactly as they do there. Pass `{}` to draw every resolve:
 
 ```typescript
 import { prerender } from 'lit-ui-router-ssr';
-import { dehydrate } from 'ui-router-server/ssr';
 
 await prerender({
   // mounts, router, paths, renderShell, …
-  payload: (transition, { path }) => {
-    const { payload, unserializable } = dehydrate(transition);
-
-    for (const { state, token } of unserializable)
-      console.warn(`${path}: ${state}.${token} re-runs on the client`);
-
-    return payload;
+  dehydrate: {
+    shouldDehydrate: ({ token }) => token !== 'manifest',
   },
 });
 ```
@@ -169,15 +173,47 @@ The payload's `resolves` go into the page's hydration signature, beside `version
 the router starts: each resolve the page was drawn with adopts its value in place of running its
 function. Every other resolve runs as it would without one: a value `dehydrate` left out, a
 `NOWAIT` resolve, every resolve of a boot that lands on another state or other parameters, and
-every resolve of a page whose block carries no `resolves`. Without the hook no page carries
-resolves. What `dehydrate` draws, and which values it leaves out, is in
+every resolve of a page whose block carries no `resolves`. Without `dehydrate` or a `payload` hook
+no page carries resolves. What `dehydrate` draws, and which values it leaves out, is in
 [its documentation](https://lit-ui-router.dev/packages/server#handing-resolves-to-the-client).
 
 A value plain JSON can't carry, such as a `Date`, travels through a transporter. Pass the same
-`transport` to `dehydrate` in the hook and to `bootstrap()`: the signature keeps the payload's
-`transported` marks, and `bootstrap()` hands `transport` to `seed`. See
+`transport` in `dehydrate` and to `bootstrap()`: the signature keeps the payload's `transported`
+marks, and `bootstrap()` hands `transport` to `seed`. See
 [values beyond plain JSON](https://lit-ui-router.dev/packages/server#values-beyond-plain-json).
 
+The `payload` option takes the drawing over by hand: a hook handed each page's landed transition
+returns the payload to write, or `undefined` to write none. Pass one or the other; passing both
+throws.
+
+```typescript
+import { dehydrate } from 'ui-router-server/ssr';
+
+await prerender({
+  // mounts, router, paths, renderShell, …
+  payload: (transition, { path }) =>
+    path.startsWith('/drafts/')
+      ? undefined
+      : dehydrate(transition, { transport }).payload,
+});
+```
+
+Each rendered page's entry in `result.pages` reports its payload as `payload`: `bytes`, what the
+payload adds to the page's signature as written, and, when `dehydrate` drew it, `unserializable`,
+the resolves left out to re-run on the client. A hook returns the payload alone, so behind one the
+report carries `bytes` only. A page with no payload has no `payload` field.
+
+```typescript
+const { pages } = await prerender({ /* … */ dehydrate: {} });
+
+for (const { path, payload } of pages) {
+  if (!payload) continue;
+  console.log(`${path}: ${payload.bytes} bytes of resolves`);
+  for (const { state, token } of payload.unserializable ?? [])
+    console.warn(`${path}: ${state}.${token} re-runs on the client`);
+}
+```
+
 ## The routed view, drawn on the server
 
 `elementRenderers` defaults to `[UiViewRenderer, LightElementRenderer]` — not `@lit-labs/ssr`'s
@@ -362,23 +398,41 @@ await bootstrap(router, root, page(router));
 
 A `<ui-view>` another class already defined throws, naming both ways out.
 
-The build-time entry that calls `prerender()` imports `lit-ui-router-ssr/register` too, once the
-DOM shim has finished installing. The shim module awaits at its top level, so a static import beside
-it evaluates first: lit's Node build installs a registry of its own, the elements are defined there,
-and the shim then replaces `globalThis.customElements` with an empty one. Import the shim
-statically and everything that defines or reaches an element by dynamic import:
+The build-time entry that calls `prerender()` needs the DOM shim installed before anything defines
+an element. The shim module awaits at its top level, so a static import beside it evaluates first:
+lit's Node build installs a registry of its own, the elements are defined there, and the shim then
+replaces `globalThis.customElements` with an empty one. Load the shim and `lit-ui-router-ssr/register`
+before the entry starts. `serverRouterPlugin` from `lit-ui-router-ssr/vite` names both as preloads
+of its prerender worker, and its `definePrerender` calls `prerender()` with the options the entry
+returns:
 
 ```typescript
-import '@lit-labs/ssr/lib/install-global-dom-shim.js';
+// vite.config.ts
+import { createServerRouter } from 'ui-router-server';
+import { serverRouterPlugin } from 'lit-ui-router-ssr/vite';
+
+plugins: [
+  serverRouterPlugin(createServerRouter({ mounts }), {
+    prerender: './src/prerender.ts',
+  }),
+];
 
-await import('lit-ui-router-ssr/register');
-const { UIRouterLit } = await import('lit-ui-router/pure');
-const { prerender, settle } = await import('lit-ui-router-ssr');
-const { page } = await import('./views.js');
+// src/prerender.ts
+import { definePrerender } from 'lit-ui-router-ssr/vite';
+
+export default definePrerender((site) => ({
+  mounts,
+  router,
+  paths,
+  renderShell,
+  document,
+}));
 ```
 
-Preloading the shim with `node --import @lit-labs/ssr/lib/install-global-dom-shim.js` finishes it
-before the entry's graph starts, so static imports hold there too. `UiViewRenderer` draws the served
+The entry then uses plain static imports; see
+[Prerender with Vite](https://lit-ui-router.dev/guides/prerender-with-vite). An entry node runs
+directly gets the same order from `node --import @lit-labs/ssr/lib/install-global-dom-shim.js`.
+`UiViewRenderer` draws the served
 class, and a `<ui-view>` nothing defined on the server renders as an inert element with an empty
 part pair — no error, and every page's body missing. In development `prerender()` warns when the
 registry holds no `<ui-view>`.

package/dist/development/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","mappings":"AAMA,SAGE,iBAMK;AAEP,SAEE,cAEK;AAEP,SAAS,4BAA4B;AAErC,SAA8C,iBAAiB;AAQ/D,SAAS,sBAAsB","names":[],"ignoreList":[],"sources":["../../src/index.ts"]}
+{"version":3,"file":"index.js","mappings":"AAMA,SAIE,iBAOK;AAEP,SAEE,cAEK;AAEP,SAAS,4BAA4B;AAErC,SAA8C,iBAAiB;AAQ/D,SAAS,sBAAsB","names":[],"ignoreList":[],"sources":["../../src/index.ts"]}

package/dist/development/prerender.js

@@ -3,6 +3,7 @@ import { collectResultSync } from "@lit-labs/ssr/lib/render-result.js";
 import { provideRouter, withRouterSync } from "lit-ui-router/context";
 import { isString } from "@uirouter/core";
 import { prerender as prerenderSite } from "ui-router-server/prerender";
+import { dehydrate as dehydrateLanded } from "ui-router-server/ssr";
 import { devGate } from "#dev-gate";
 import { LightElementRenderer } from "./light-element-renderer.js";
 import { responder } from "./respond.js";
@@ -45,6 +46,8 @@ export const signatureBlock = (signature) => {
 	const json = JSON.stringify(signature).replaceAll("<", "\\u003c").replaceAll(">", "\\u003e");
 	return `<script type="application/json" ${signatureAttribute}>${json}<\/script>`;
 };
+const utf8Length = (text) => new TextEncoder().encode(text).length;
+const payloadBytes = (router, drawn) => utf8Length(signatureBlock(signatureOf(router, drawn))) - utf8Length(signatureBlock(signatureOf(router)));
 export const renderPage = (body, router, root, elementRenderers, drawn) => signatureBlock(signatureOf(router, drawn)) + withRouterSync(router, () => collectResultSync(render(body, {
 	eventTargetStack: rootedStack(root),
 	elementRenderers,
@@ -53,15 +56,32 @@ export const renderPage = (body, router, root, elementRenderers, drawn) => signa
 const warnUnregistered = () => {
 	if (!devGate()) return;
 	if (globalThis.customElements?.get("ui-view")) return;
-	console.warn("lit-ui-router-ssr: <ui-view> is not defined on the current customElements registry, so every <ui-view> on these pages renders empty. The DOM shim replaces the registry when it finishes installing: load lit-ui-router-ssr/register by dynamic import after the shim, or preload the shim with node --import.");
+	console.warn("lit-ui-router-ssr: <ui-view> is not defined on the current customElements registry, so every <ui-view> on these pages renders empty. The DOM shim replaces the registry when it finishes installing: prerender through serverRouterPlugin from lit-ui-router-ssr/vite, which preloads both, load lit-ui-router-ssr/register by dynamic import after the shim, or preload the shim with node --import.");
 };
 export async function prerender(options) {
-	const { router, renderShell, document, elementRenderers = [UiViewRenderer, LightElementRenderer], root = new EventTarget(), write = nodeWrite, payload, responses, origin = "http://lit-ui-router-ssr", ...site } = options;
+	const { router, renderShell, document, elementRenderers = [UiViewRenderer, LightElementRenderer], root = new EventTarget(), write = nodeWrite, dehydrate: dehydrateOptions, payload, responses, origin = "http://lit-ui-router-ssr", ...site } = options;
+	if (dehydrateOptions && payload) throw new Error("prerender: pass `dehydrate` or `payload`, not both; a `payload` hook calls `dehydrate()` itself");
 	warnUnregistered();
-	const payloadOf = (context) => {
-		if (!payload) return void 0;
+	const draw = (transition, context) => {
+		if (dehydrateOptions) return dehydrateLanded(transition, dehydrateOptions);
+		return { payload: payload?.(transition, context) };
+	};
+	const drawLanded = (context) => {
+		if (!dehydrateOptions && !payload) return {};
 		const landed = router.globals.successfulTransitions.peekTail();
-		return landed && payload(landed, context);
+		return landed ? draw(landed, context) : {};
+	};
+	const reports = new Map();
+	const renderTemplate = (body, context) => {
+		const { payload: drawn, unserializable } = drawLanded(context);
+		if (drawn) {
+			const bytes = payloadBytes(router, drawn);
+			reports.set(context.file, unserializable ? {
+				bytes,
+				unserializable
+			} : { bytes });
+		}
+		return renderPage(body, router, root, elementRenderers, drawn);
 	};
 	const renderLit = async (verdict, siteContext) => {
 		const context = {
@@ -69,7 +89,7 @@ export async function prerender(options) {
 			root
 		};
 		const body = await renderShell(verdict, context);
-		const markup = isString(body) ? body : renderPage(body, router, root, elementRenderers, payloadOf(context));
+		const markup = isString(body) ? body : renderTemplate(body, context);
 		return document ? document(markup, context) : markup;
 	};
 	const uninstall = provideRouter(root, router);
@@ -78,13 +98,22 @@ export async function prerender(options) {
 			if (responses === void 0) throw new Error(`prerender: '${path}' matched response state '${verdict.state}'; pass \`responses\` to answer it`);
 			return responder(router, responses)(verdict, new Request(new URL(path, origin)));
 		};
+		const result = await prerenderSite({
+			...site,
+			render: renderLit,
+			respond,
+			write
+		});
+		const pages = result.pages.map((page) => {
+			const report = reports.get(page.file);
+			return report ? {
+				...page,
+				payload: report
+			} : page;
+		});
 		return {
-			...await prerenderSite({
-				...site,
-				render: renderLit,
-				respond,
-				write
-			}),
+			...result,
+			pages,
 			root
 		};
 	} finally {

package/dist/development/prerender.js.map

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

package/dist/development/signature.js

@@ -1,7 +1,7 @@
 import { DefType } from "@uirouter/core";
 export const signatureAttribute = "data-lit-ui-router-ssr";
 export const signatureSelector = `script[type="application/json"][${signatureAttribute}]`;
-export const packageVersion = "0.7.0";
+export const packageVersion = "0.8.0";
 export const urlParamsOf = (state, params) => Object.fromEntries(state.parameters().flatMap((param) => param.location === DefType.CONFIG ? [] : [[param.id, param.type.encode(params[param.id])]]));
 export const routeOf = ({ $current, params }) => [$current.name, urlParamsOf($current, params)];
 //# sourceMappingURL=signature.js.map

package/dist/development/vite-preload.js

@@ -0,0 +1,7 @@
+export const DOM_SHIM = ["@lit-labs/ssr/lib/install-global-dom-shim.js"];
+export const litPreload = (shim, preload) => [...new Set([
+	...shim,
+	"lit-ui-router-ssr/register",
+	...preload
+])];
+//# sourceMappingURL=vite-preload.js.map

package/dist/development/vite-preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-preload.js","mappings":"AACA,OAAO,MAAM,WAA8B,CACzC,8CACF;AASA,OAAO,MAAM,cACX,MACA,YACa,CACb,GAAG,IAAI,IAAI;CAAC,GAAG;CAAM;CAA8B,GAAG;AAAO,CAAC,CAChE","names":[],"ignoreList":[],"sources":["../../src/vite-preload.ts"]}

package/dist/development/vite.js

@@ -0,0 +1,27 @@
+import { serverRouterPlugin as siteRouterPlugin } from "ui-router-server/vite";
+import { DOM_SHIM, litPreload } from "./vite-preload.js";
+const loadPrerender = async () => (await import("./prerender.js")).prerender;
+export function definePrerender(script) {
+	return async (build) => {
+		const [options, prerender] = await Promise.all([script(build), loadPrerender()]);
+		const { root: _root, ...result } = await prerender({
+			...build,
+			...options
+		});
+		return result;
+	};
+}
+export function serverRouterPlugin(router, options = {}) {
+	const { shim = DOM_SHIM, ...siteOptions } = options;
+	const { prerender } = siteOptions;
+	if (prerender === void 0) return siteRouterPlugin(router, siteOptions);
+	const { entry, preload = [] } = typeof prerender === "string" ? { entry: prerender } : prerender;
+	return siteRouterPlugin(router, {
+		...siteOptions,
+		prerender: {
+			entry,
+			preload: litPreload(shim, preload)
+		}
+	});
+}
+//# sourceMappingURL=vite.js.map

package/dist/development/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","mappings":"AAcA,SAAS,sBAAsB,wBAAwB;AAUvD,SAAS,UAAU,kBAAkB;AA6CrC,MAAM,gBAAgB,aAAa,MAAM,OAAO,kBAAiB,CAAE;AAyBnE,OAAO,SAAS,gBAAgB,QAAyC;CACvE,OAAO,OAAO,UAAU;EACtB,MAAM,CAAC,SAAS,aAAa,MAAM,QAAQ,IAAI,CAC7C,OAAO,KAAK,GACZ,cAAc,CAChB,CAAC;EAGD,MAAM,EAAE,MAAM,OAAO,GAAG,WAAW,MAAM,UAAU;GACjD,GAAG;GACH,GAAG;EACL,CAAC;EAED,OAAO;CACT;AACF;AA+BA,OAAO,SAAS,mBACd,QACA,UAAqC,CAAC,GAClB;CACpB,MAAM,EAAE,OAAO,UAAU,GAAG,gBAAgB;CAC5C,MAAM,EAAE,cAAc;CAEtB,IAAI,cAAc,QAAW,OAAO,iBAAiB,QAAQ,WAAW;CAExE,MAAM,EAAE,OAAO,UAAU,CAAC,MAExB,OAAO,cAAc,WAAW,EAAE,OAAO,UAAU,IAAI;CAEzD,OAAO,iBAAiB,QAAQ;EAC9B,GAAG;EACH,WAAW;GAAE;GAAO,SAAS,WAAW,MAAM,OAAO;EAAE;CACzD,CAAC;AACH","names":[],"ignoreList":[],"sources":["../../src/vite.ts"]}

package/dist/index.d.ts

@@ -4,7 +4,7 @@
 *
 * @module
 */
-export { type EmittedPage, type FileWriter, prerender, type PrerenderOptions, type PrerenderResult, type PrerenderTally, type RedirectLine, type RenderContext } from "./prerender.js";
+export { type EmittedPage, type FileWriter, type PagePayload, prerender, type PrerenderedPage, type PrerenderOptions, type PrerenderResult, type PrerenderTally, type RedirectLine, type RenderContext } from "./prerender.js";
 export { type ResolvePayload, settle, type SettleOptions } from "ui-router-server/ssr";
 export { LightElementRenderer } from "./light-element-renderer.js";
 export { type BoundResponses, type Responder, responder } from "./respond.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","mappings":";;;;;;AAMA,cACO,kBACA,YACL,gBACK,uBACA,sBACA,qBACA,mBACA,qBACA;AAEP,cACO,gBACL,aACK,qBACA;AAEP,SAAS,4BAA4B;AAErC,cAAc,qBAAqB,WAAW,iBAAiB;AAE/D,cACE,iBACA,iBACA,wBACK;AAEP,SAAS,sBAAsB","names":[],"ignoreList":[],"sources":["../src/index.ts"]}
+{"version":3,"file":"index.d.ts","mappings":";;;;;;AAMA,cACO,kBACA,iBACA,aACL,gBACK,sBACA,uBACA,sBACA,qBACA,mBACA,qBACA;AAEP,cACO,gBACL,aACK,qBACA;AAEP,SAAS,4BAA4B;AAErC,cAAc,qBAAqB,WAAW,iBAAiB;AAE/D,cACE,iBACA,iBACA,wBACK;AAEP,SAAS,sBAAsB","names":[],"ignoreList":[],"sources":["../src/index.ts"]}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","mappings":"AAMA,SAGE,iBAMK;AAEP,SAEE,cAEK;AAEP,SAAS,4BAA4B;AAErC,SAA8C,iBAAiB;AAQ/D,SAAS,sBAAsB","names":[],"ignoreList":[],"sources":["../src/index.ts"]}
+{"version":3,"file":"index.js","mappings":"AAMA,SAIE,iBAOK;AAEP,SAEE,cAEK;AAEP,SAAS,4BAA4B;AAErC,SAA8C,iBAAiB;AAQ/D,SAAS,sBAAsB","names":[],"ignoreList":[],"sources":["../src/index.ts"]}

package/dist/prerender.d.ts

@@ -3,8 +3,8 @@ import type { TemplateResult } from "lit";
 import type { Transition } from "@uirouter/core";
 import type { UIRouterLit } from "lit-ui-router";
 import type { Verdict } from "ui-router-server";
-import type { FileWriter, PrerenderOptions as SitePrerenderOptions, PrerenderResult as SitePrerenderResult, RenderContext as SiteRenderContext } from "ui-router-server/prerender";
-import type { ResolvePayload } from "ui-router-server/ssr";
+import type { EmittedPage, FileWriter, PrerenderOptions as SitePrerenderOptions, PrerenderResult as SitePrerenderResult, RenderContext as SiteRenderContext } from "ui-router-server/prerender";
+import type { DehydrateOptions, DehydrateResult, ResolvePayload } from "ui-router-server/ssr";
 import type { BoundResponses } from "./respond.js";
 export type { EmittedPage, FileWriter, PrerenderTally, RedirectLine } from "ui-router-server/prerender";
 type ShellVerdict = Extract<Verdict, {
@@ -79,32 +79,78 @@ export interface PrerenderOptions extends Omit<SitePrerenderOptions, "render" |
 	/** Writes a file. Defaults to `node:fs`, imported lazily on first write. */
 	write?: FileWriter;
 	/**
-	* Draws the resolve payload for a rendered page, handed the transition the
+	* Draws each rendered page's resolve payload with `dehydrate` from
+	* `ui-router-server/ssr`, called with these options on the transition the
 	* router last landed, once `renderShell` has returned a template. The
 	* payload's `resolves` go into the page's hydration signature, beside the
 	* state and parameters the router stands on, and the client adopts them on
-	* boot in place of running those resolve functions. Return `undefined` to
-	* write none. Without this hook no page carries resolves.
+	* boot in place of running those resolve functions. Pass `{}` to draw every
+	* resolve `dehydrate` draws by default. Without this option or
+	* {@link PrerenderOptions.payload | `payload`}, no page carries resolves.
 	*
-	* `dehydrate` from `ui-router-server/ssr` draws the payload; its
-	* documentation says which values it leaves out. The payload's
+	* `dehydrate`'s documentation says which values it leaves out and how
+	* `shouldDehydrate` and `transport` act. The payload's
 	* `transported` marks go into the signature too, so a value a transporter
 	* carried is rebuilt when `bootstrap()` gets the same `transport`.
 	*
 	* @example
 	* ```ts
-	* payload: (transition, { path }) => {
-	*   const { payload, unserializable } = dehydrate(transition);
-	*   for (const { state, token } of unserializable)
-	*     console.warn(`${path}: ${state}.${token} re-runs on the client`);
-	*   return payload;
+	* dehydrate: {
+	*   shouldDehydrate: ({ token }) => token !== 'manifest',
+	*   transport,
 	* },
 	* ```
 	*/
+	dehydrate?: DehydrateOptions;
+	/**
+	* Draws the resolve payload for a rendered page by hand, in place of
+	* {@link PrerenderOptions.dehydrate | `dehydrate`}: handed the transition the
+	* router last landed, once `renderShell` has returned a template, it returns
+	* the payload the page's signature carries, or `undefined` to write none.
+	* Passing both this and `dehydrate` throws.
+	*
+	* @example
+	* Shape the payload `dehydrate` draws before it is written:
+	* ```ts
+	* import { dehydrate } from 'ui-router-server/ssr';
+	*
+	* payload: (transition, { path }) =>
+	*   path.startsWith('/drafts/')
+	*     ? undefined
+	*     : dehydrate(transition, { transport }).payload,
+	* ```
+	*/
 	payload?: (transition: Transition, context: RenderContext) => ResolvePayload | undefined;
 }
+/** What a page's hydration signature carries of its resolve payload. */
+export interface PagePayload {
+	/**
+	* The bytes the payload adds to the page's signature as written: its
+	* `resolves` and `transported` members, escaped as the block spells them.
+	*/
+	bytes: number;
+	/**
+	* The resolves {@link PrerenderOptions.dehydrate | `dehydrate`} left out of
+	* the payload because their value is not plain JSON data and no transporter
+	* carries it, each to re-run on the client. Present only when `dehydrate`
+	* drew the payload: a {@link PrerenderOptions.payload | `payload`} hook
+	* returns the payload alone.
+	*/
+	unserializable?: DehydrateResult["unserializable"];
+}
+/** A page {@link prerender} emitted. */
+export interface PrerenderedPage extends EmittedPage {
+	/**
+	* What the page's signature carries of its resolve payload. Absent on a page
+	* that carries none: one drawn with no payload, one `renderShell` returned
+	* as a string, and a response state's body.
+	*/
+	payload?: PagePayload;
+}
 /** What {@link prerender} did. */
-export interface PrerenderResult extends SitePrerenderResult {
+export interface PrerenderResult extends Omit<SitePrerenderResult, "pages"> {
+	/** Every page emitted or planned, in enumeration order. */
+	pages: PrerenderedPage[];
 	/** The root event target, created or passed through. */
 	root: EventTarget;
 }
@@ -150,9 +196,12 @@ export declare const renderPage: (body: TemplateResult, router: UIRouterLit, roo
 * A rendered page opens on its hydration signature: a JSON data block,
 * `<script type="application/json" data-lit-ui-router-ssr>`, naming this
 * package's version and the state and parameter values the router stood on,
-* which `hydrateRoot()` reads before it touches the document. A
-* {@link PrerenderOptions.payload | `payload`} hook adds the resolved values
-* the page was drawn with, which `bootstrap()` adopts. A `renderShell`
+* which `hydrateRoot()` reads before it touches the document.
+* {@link PrerenderOptions.dehydrate | `dehydrate`}, or a
+* {@link PrerenderOptions.payload | `payload`} hook, adds the resolved values
+* the page was drawn with, which `bootstrap()` adopts; the page's entry in
+* the result's `pages` reports the bytes they add and, from `dehydrate`, the
+* resolves left to re-run on the client. A `renderShell`
 * that returns a string is written as-is, with no signature, so the client
 * renders it cold.
 *
@@ -166,6 +215,7 @@ export declare const renderPage: (body: TemplateResult, router: UIRouterLit, roo
 * @returns what was emitted, planned or written
 * @throws an `Error` when neither `mounts` nor `resolver` is supplied
 * @throws an `Error` when the 404 document needs a default probe and only a `resolver` is supplied
+* @throws an `Error` when both `dehydrate` and `payload` are supplied
 *
 * @example
 * ```ts

package/dist/prerender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerender.d.ts","mappings":"AAEA,cAAc,kBAAkB;AAEhC,cAAc,sBAAsB;AACpC,cAAc,kBAAkB;AAChC,cAAc,mBAAmB;AAGjC,cAAc,eAAe;AAE7B,cACE,YACA,oBAAoB,sBACpB,mBAAmB,qBACnB,iBAAiB,yBACZ;AACP,cAAc,sBAAsB;AAKpC,cAAc,sBAAsB;AAIpC,cACE,aACA,YACA,gBACA,oBACK;KAEF,eAAe,QAAQ,SAAS;CAAE,MAAM;AAAQ;;AAgCrD,iBAAiB,sBAAsB,kBAAkB;;CAEvD,MAAM;AACR;;;;;AAMA,iBAAiB,yBAAyB,KACxC,sBACA,WAAW,YAAY,SACvB;;;;;;CAMA,QAAQ;;;;;;;CAOR,cACE,SAAS,cACT,SAAS,kBACN,0BAA0B,QAAQ;;;;;;CAMvC,YAAY,cAAc,SAAS,2BAA2B;;;;;;;;CAQ9D,OAAO;;;;;;;;;;;CAWP,mBAAmB,WAAW;;;;;;;;;;CAU9B,YAAY;;;;;;;;CAQZ;;CAEA,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,WACE,YAAY,YACZ,SAAS,kBACN;AACP;;AAGA,iBAAiB,wBAAwB,oBAAoB;;CAE3D,MAAM;AACR;;UAcU,iBAAiB;UAChB;UACA;UACA,QAAQ,SAAS;UACjB,WAAW,eAAe;UAC1B,cAAc,eAAe;AACxC;;KAGK,gBAAgB,KAAK,gBAAgB,aAAa;;AAGvD,OAAO,cAAM,cACX,QAAQ,aACR,QAAQ,kBACP;;;;;;AAkBH,OAAO,cAAM,iBAAkB,WAAW;;;;;;;AAc1C,OAAO,cAAM,aACX,MAAM,gBACN,QAAQ,aACR,MAAM,aACN,kBAAkB,WAAW,qBAC7B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2EV,OAAO,iBAAe,UACpB,SAAS,mBACR,QAAQ","names":[],"ignoreList":[],"sources":["../src/prerender.ts"]}
+{"version":3,"file":"prerender.d.ts","mappings":"AAEA,cAAc,kBAAkB;AAEhC,cAAc,sBAAsB;AACpC,cAAc,kBAAkB;AAChC,cAAc,mBAAmB;AAGjC,cAAc,eAAe;AAE7B,cACE,aACA,YACA,oBAAoB,sBACpB,mBAAmB,qBACnB,iBAAiB,yBACZ;AAEP,cACE,kBACA,iBACA,sBACK;AAKP,cAAc,sBAAsB;AAIpC,cACE,aACA,YACA,gBACA,oBACK;KAEF,eAAe,QAAQ,SAAS;CAAE,MAAM;AAAQ;;AAgCrD,iBAAiB,sBAAsB,kBAAkB;;CAEvD,MAAM;AACR;;;;;AAMA,iBAAiB,yBAAyB,KACxC,sBACA,WAAW,YAAY,SACvB;;;;;;CAMA,QAAQ;;;;;;;CAOR,cACE,SAAS,cACT,SAAS,kBACN,0BAA0B,QAAQ;;;;;;CAMvC,YAAY,cAAc,SAAS,2BAA2B;;;;;;;;CAQ9D,OAAO;;;;;;;;;;;CAWP,mBAAmB,WAAW;;;;;;;;;;CAU9B,YAAY;;;;;;;;CAQZ;;CAEA,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,YAAY;;;;;;;;;;;;;;;;;;;CAmBZ,WACE,YAAY,YACZ,SAAS,kBACN;AACP;;AAGA,iBAAiB,YAAY;;;;;CAK3B;;;;;;;;CAQA,iBAAiB,gBAAgB;AACnC;;AAGA,iBAAiB,wBAAwB,YAAY;;;;;;CAMnD,UAAU;AACZ;;AAGA,iBAAiB,wBAAwB,KAAK,qBAAqB,SAAS;;CAE1E,OAAO;;CAEP,MAAM;AACR;;UAcU,iBAAiB;UAChB;UACA;UACA,QAAQ,SAAS;UACjB,WAAW,eAAe;UAC1B,cAAc,eAAe;AACxC;;KAGK,gBAAgB,KAAK,gBAAgB,aAAa;;AAGvD,OAAO,cAAM,cACX,QAAQ,aACR,QAAQ,kBACP;;;;;;AAkBH,OAAO,cAAM,iBAAkB,WAAW;;;;;;;AAsB1C,OAAO,cAAM,aACX,MAAM,gBACN,QAAQ,aACR,MAAM,aACN,kBAAkB,WAAW,qBAC7B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EV,OAAO,iBAAe,UACpB,SAAS,mBACR,QAAQ","names":[],"ignoreList":[],"sources":["../src/prerender.ts"]}

package/dist/prerender.js

@@ -3,6 +3,7 @@ import { collectResultSync } from "@lit-labs/ssr/lib/render-result.js";
 import { provideRouter, withRouterSync } from "lit-ui-router/context";
 import { isString } from "@uirouter/core";
 import { prerender as prerenderSite } from "ui-router-server/prerender";
+import { dehydrate as dehydrateLanded } from "ui-router-server/ssr";
 import "#dev-gate";
 import { LightElementRenderer } from "./light-element-renderer.js";
 import { responder } from "./respond.js";
@@ -45,17 +46,36 @@ export const signatureBlock = (signature) => {
 	const json = JSON.stringify(signature).replaceAll("<", "\\u003c").replaceAll(">", "\\u003e");
 	return `<script type="application/json" ${signatureAttribute}>${json}<\/script>`;
 };
+const utf8Length = (text) => new TextEncoder().encode(text).length;
+const payloadBytes = (router, drawn) => utf8Length(signatureBlock(signatureOf(router, drawn))) - utf8Length(signatureBlock(signatureOf(router)));
 export const renderPage = (body, router, root, elementRenderers, drawn) => signatureBlock(signatureOf(router, drawn)) + withRouterSync(router, () => collectResultSync(render(body, {
 	eventTargetStack: rootedStack(root),
 	elementRenderers,
 	deferHydration: true
 })));
 export async function prerender(options) {
-	const { router, renderShell, document, elementRenderers = [UiViewRenderer, LightElementRenderer], root = new EventTarget(), write = nodeWrite, payload, responses, origin = "http://lit-ui-router-ssr", ...site } = options;
-	const payloadOf = (context) => {
-		if (!payload) return void 0;
+	const { router, renderShell, document, elementRenderers = [UiViewRenderer, LightElementRenderer], root = new EventTarget(), write = nodeWrite, dehydrate: dehydrateOptions, payload, responses, origin = "http://lit-ui-router-ssr", ...site } = options;
+	if (dehydrateOptions && payload) throw new Error("prerender: pass `dehydrate` or `payload`, not both; a `payload` hook calls `dehydrate()` itself");
+	const draw = (transition, context) => {
+		if (dehydrateOptions) return dehydrateLanded(transition, dehydrateOptions);
+		return { payload: payload?.(transition, context) };
+	};
+	const drawLanded = (context) => {
+		if (!dehydrateOptions && !payload) return {};
 		const landed = router.globals.successfulTransitions.peekTail();
-		return landed && payload(landed, context);
+		return landed ? draw(landed, context) : {};
+	};
+	const reports = new Map();
+	const renderTemplate = (body, context) => {
+		const { payload: drawn, unserializable } = drawLanded(context);
+		if (drawn) {
+			const bytes = payloadBytes(router, drawn);
+			reports.set(context.file, unserializable ? {
+				bytes,
+				unserializable
+			} : { bytes });
+		}
+		return renderPage(body, router, root, elementRenderers, drawn);
 	};
 	const renderLit = async (verdict, siteContext) => {
 		const context = {
@@ -63,7 +83,7 @@ export async function prerender(options) {
 			root
 		};
 		const body = await renderShell(verdict, context);
-		const markup = isString(body) ? body : renderPage(body, router, root, elementRenderers, payloadOf(context));
+		const markup = isString(body) ? body : renderTemplate(body, context);
 		return document ? document(markup, context) : markup;
 	};
 	const uninstall = provideRouter(root, router);
@@ -72,13 +92,22 @@ export async function prerender(options) {
 			if (responses === void 0) throw new Error(`prerender: '${path}' matched response state '${verdict.state}'; pass \`responses\` to answer it`);
 			return responder(router, responses)(verdict, new Request(new URL(path, origin)));
 		};
+		const result = await prerenderSite({
+			...site,
+			render: renderLit,
+			respond,
+			write
+		});
+		const pages = result.pages.map((page) => {
+			const report = reports.get(page.file);
+			return report ? {
+				...page,
+				payload: report
+			} : page;
+		});
 		return {
-			...await prerenderSite({
-				...site,
-				render: renderLit,
-				respond,
-				write
-			}),
+			...result,
+			pages,
 			root
 		};
 	} finally {

package/dist/prerender.js.map

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

package/dist/signature.js

@@ -1,7 +1,7 @@
 import { DefType } from "@uirouter/core";
 export const signatureAttribute = "data-lit-ui-router-ssr";
 export const signatureSelector = `script[type="application/json"][${signatureAttribute}]`;
-export const packageVersion = "0.7.0";
+export const packageVersion = "0.8.0";
 export const urlParamsOf = (state, params) => Object.fromEntries(state.parameters().flatMap((param) => param.location === DefType.CONFIG ? [] : [[param.id, param.type.encode(params[param.id])]]));
 export const routeOf = ({ $current, params }) => [$current.name, urlParamsOf($current, params)];
 //# sourceMappingURL=signature.js.map

package/dist/vite-preload.d.ts

@@ -0,0 +1,11 @@
+/** `@lit-labs/ssr`'s DOM shim: the default for `serverRouterPlugin`'s `shim`. @internal */
+export declare const DOM_SHIM: readonly string[];
+/**
+* The worker's preloads for a Lit app: the shim modules, then
+* `lit-ui-router-ssr/register` in the registry they installed, then the app's
+* own, each once, at its first position.
+*
+* @internal
+*/
+export declare const litPreload: (shim: readonly string[], preload: readonly string[]) => string[];
+//# sourceMappingURL=vite-preload.d.ts.map

package/dist/vite-preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-preload.d.ts","mappings":";AACA,OAAO,cAAM;;;;;;;;AAWb,OAAO,cAAM,aACX,yBACA","names":[],"ignoreList":[],"sources":["../src/vite-preload.ts"]}

package/dist/vite-preload.js

@@ -0,0 +1,7 @@
+export const DOM_SHIM = ["@lit-labs/ssr/lib/install-global-dom-shim.js"];
+export const litPreload = (shim, preload) => [...new Set([
+	...shim,
+	"lit-ui-router-ssr/register",
+	...preload
+])];
+//# sourceMappingURL=vite-preload.js.map

package/dist/vite-preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-preload.js","mappings":"AACA,OAAO,MAAM,WAA8B,CACzC,8CACF;AASA,OAAO,MAAM,cACX,MACA,YACa,CACb,GAAG,IAAI,IAAI;CAAC,GAAG;CAAM;CAA8B,GAAG;AAAO,CAAC,CAChE","names":[],"ignoreList":[],"sources":["../src/vite-preload.ts"]}

package/dist/vite.d.ts

@@ -0,0 +1,86 @@
+import type { PrerenderBuild, PrerenderEntry, ServerRouterPlugin, ServerRouterPluginOptions as SiteRouterPluginOptions } from "ui-router-server/vite";
+import type { ServerRouter } from "ui-router-server";
+import type { PrerenderOptions } from "./prerender.js";
+export type { PrerenderBuild, PrerenderEntry, ServerRouterPlugin } from "ui-router-server/vite";
+/**
+* `ui-router-server/vite`'s plugin options, plus the DOM the prerender
+* worker installs for Lit.
+*/
+export interface ServerRouterPluginOptions extends SiteRouterPluginOptions {
+	/**
+	* Modules that install a DOM in the prerender worker, loaded in order
+	* before `lit-ui-router-ssr/register` and any `preload`. Defaults to
+	* `@lit-labs/ssr`'s DOM shim. List another DOM's setup to use it
+	* instead, or pass `[]` to install none: Lit's Node build still renders,
+	* but app code that reads `document` or `window` fails.
+	*/
+	shim?: readonly string[];
+}
+/**
+* What a prerender script's callback returns: this package's
+* {@link PrerenderOptions}, less what the build supplies. `outDir` and
+* `write` come from the build, so a script may still pass either to
+* override it.
+*/
+export type PrerenderScriptOptions = Omit<PrerenderOptions, "outDir" | "write"> & Partial<Pick<PrerenderOptions, "outDir" | "write">>;
+/**
+* The callback {@link definePrerender} takes: handed the build's values,
+* such as `shellHtml` for a `document` hook, it returns the prerender
+* options.
+*/
+export type PrerenderScript = (build: PrerenderBuild) => PrerenderScriptOptions | Promise<PrerenderScriptOptions>;
+/**
+* Turns a callback that returns this package's prerender options into a
+* prerender script's default export. The export spreads the build's values
+* (`outDir`, `shellHtml`, `write`) under the options and calls this
+* package's `prerender()`, so the script never calls it itself.
+*
+* @param script - returns the prerender options; handed the build's values
+* @returns the default export for the prerender script
+*
+* @example
+* ```ts
+* export default definePrerender((site) => ({
+*   mounts,
+*   router,
+*   paths: ['/', '/about'],
+*   renderShell: async (_verdict, { path }) => {
+*     await settle(router, path);
+*     return page(router);
+*   },
+*   document: (body) => site.shellHtml.replace('<!--app-->', body),
+* }));
+* ```
+*/
+export declare function definePrerender(script: PrerenderScript): PrerenderEntry;
+/**
+* `ui-router-server/vite`'s `serverRouterPlugin`, set up for a Lit app: with
+* {@link ServerRouterPluginOptions.prerender | prerender}, the worker loads
+* the {@link ServerRouterPluginOptions.shim | shim}, then
+* `lit-ui-router-ssr/register`, then any `preload` passed here, each once,
+* before the prerender script, so the script imports everything statically. Its default export
+* comes from this module's {@link definePrerender}.
+*
+* `vite dev` and `vite preview` behave as under `ui-router-server/vite`.
+*
+* @param router - the server router the middleware and the build step read
+* @param options - the Connect adapter's options, plus the build step
+* @returns a plugin to spread into `plugins: [...]`
+* @throws from the build step when the script has no default export
+* function, the built `index.html` is missing, or a listed path matches no
+* route
+*
+* @example
+* ```ts
+* import { createServerRouter } from 'ui-router-server';
+* import { serverRouterPlugin } from 'lit-ui-router-ssr/vite';
+*
+* plugins: [
+*   serverRouterPlugin(createServerRouter({ mounts }), {
+*     prerender: './src/prerender.ts',
+*   }),
+* ],
+* ```
+*/
+export declare function serverRouterPlugin(router: ServerRouter, options?: ServerRouterPluginOptions): ServerRouterPlugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","mappings":"AAeA,cACE,gBACA,gBACA,oBACA,6BAA6B,+BACxB;AACP,cAAc,oBAAoB;AAElC,cAAc,wBAAwB;AAGtC,cACE,gBACA,gBACA,0BACK;;;;;AAMP,iBAAiB,kCAAkC,wBAAwB;;;;;;;;CAQzE;AACF;;;;;;;AAQA,YAAY,yBAAyB,KACnC,kBACA,WAAW,WAEX,QAAQ,KAAK,kBAAkB,WAAW;;;;;;AAO5C,YAAY,mBACV,OAAO,mBACJ,yBAAyB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;AA4BtC,OAAO,iBAAS,gBAAgB,QAAQ,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8C1D,OAAO,iBAAS,mBACd,QAAQ,cACR,UAAS,4BACR","names":[],"ignoreList":[],"sources":["../src/vite.ts"]}

package/dist/vite.js

@@ -0,0 +1,27 @@
+import { serverRouterPlugin as siteRouterPlugin } from "ui-router-server/vite";
+import { DOM_SHIM, litPreload } from "./vite-preload.js";
+const loadPrerender = async () => (await import("./prerender.js")).prerender;
+export function definePrerender(script) {
+	return async (build) => {
+		const [options, prerender] = await Promise.all([script(build), loadPrerender()]);
+		const { root: _root, ...result } = await prerender({
+			...build,
+			...options
+		});
+		return result;
+	};
+}
+export function serverRouterPlugin(router, options = {}) {
+	const { shim = DOM_SHIM, ...siteOptions } = options;
+	const { prerender } = siteOptions;
+	if (prerender === void 0) return siteRouterPlugin(router, siteOptions);
+	const { entry, preload = [] } = typeof prerender === "string" ? { entry: prerender } : prerender;
+	return siteRouterPlugin(router, {
+		...siteOptions,
+		prerender: {
+			entry,
+			preload: litPreload(shim, preload)
+		}
+	});
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","mappings":"AAcA,SAAS,sBAAsB,wBAAwB;AAUvD,SAAS,UAAU,kBAAkB;AA6CrC,MAAM,gBAAgB,aAAa,MAAM,OAAO,kBAAiB,CAAE;AAyBnE,OAAO,SAAS,gBAAgB,QAAyC;CACvE,OAAO,OAAO,UAAU;EACtB,MAAM,CAAC,SAAS,aAAa,MAAM,QAAQ,IAAI,CAC7C,OAAO,KAAK,GACZ,cAAc,CAChB,CAAC;EAGD,MAAM,EAAE,MAAM,OAAO,GAAG,WAAW,MAAM,UAAU;GACjD,GAAG;GACH,GAAG;EACL,CAAC;EAED,OAAO;CACT;AACF;AA+BA,OAAO,SAAS,mBACd,QACA,UAAqC,CAAC,GAClB;CACpB,MAAM,EAAE,OAAO,UAAU,GAAG,gBAAgB;CAC5C,MAAM,EAAE,cAAc;CAEtB,IAAI,cAAc,QAAW,OAAO,iBAAiB,QAAQ,WAAW;CAExE,MAAM,EAAE,OAAO,UAAU,CAAC,MAExB,OAAO,cAAc,WAAW,EAAE,OAAO,UAAU,IAAI;CAEzD,OAAO,iBAAiB,QAAQ;EAC9B,GAAG;EACH,WAAW;GAAE;GAAO,SAAS,WAAW,MAAM,OAAO;EAAE;CACzD,CAAC;AACH","names":[],"ignoreList":[],"sources":["../src/vite.ts"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lit-ui-router-ssr",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Static prerendering for lit-ui-router: mount verdicts in, an emitted site out",
   "homepage": "https://lit-ui-router.dev/packages/ssr",
   "bugs": {
@@ -69,6 +69,14 @@
       "deno": "./dist/testing.js",
       "node": "./dist/development/testing.js",
       "default": "./dist/testing.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "development": "./dist/development/vite.js",
+      "production": "./dist/vite.js",
+      "deno": "./dist/vite.js",
+      "node": "./dist/development/vite.js",
+      "default": "./dist/vite.js"
     }
   },
   "dependencies": {
@@ -80,7 +88,7 @@
     "@uirouter/core": "^6.0.8",
     "lit": "^3.1.2",
     "lit-ui-router": "^1.19.0",
-    "ui-router-server": "^0.7.0"
+    "ui-router-server": "^0.8.0"
   },
   "peerDependenciesMeta": {
     "@lit-labs/ssr-client": {
@@ -130,6 +138,19 @@
         "node:fs",
         "node:path"
       ]
+    },
+    "./vite": {
+      "free": [
+        "@lit-labs/ssr",
+        "@lit-labs/ssr-client",
+        "@uirouter/core",
+        "lit",
+        "lit-ui-router",
+        "hono",
+        "vite",
+        "node:fs",
+        "node:path"
+      ]
     }
   }
 }

package/src/index.ts

@@ -7,7 +7,9 @@
 export {
   type EmittedPage,
   type FileWriter,
+  type PagePayload,
   prerender,
+  type PrerenderedPage,
   type PrerenderOptions,
   type PrerenderResult,
   type PrerenderTally,

package/src/prerender.ts

@@ -10,12 +10,18 @@ import { isString } from '@uirouter/core';
 import type { Verdict } from 'ui-router-server';
 import { prerender as prerenderSite } from 'ui-router-server/prerender';
 import type {
+  EmittedPage,
   FileWriter,
   PrerenderOptions as SitePrerenderOptions,
   PrerenderResult as SitePrerenderResult,
   RenderContext as SiteRenderContext,
 } from 'ui-router-server/prerender';
-import type { ResolvePayload } from 'ui-router-server/ssr';
+import { dehydrate as dehydrateLanded } from 'ui-router-server/ssr';
+import type {
+  DehydrateOptions,
+  DehydrateResult,
+  ResolvePayload,
+} from 'ui-router-server/ssr';
 import { devGate } from '#dev-gate';
 
 import { LightElementRenderer } from './light-element-renderer.js';
@@ -138,36 +144,84 @@ export interface PrerenderOptions extends Omit<
   /** Writes a file. Defaults to `node:fs`, imported lazily on first write. */
   write?: FileWriter;
   /**
-   * Draws the resolve payload for a rendered page, handed the transition the
+   * Draws each rendered page's resolve payload with `dehydrate` from
+   * `ui-router-server/ssr`, called with these options on the transition the
    * router last landed, once `renderShell` has returned a template. The
    * payload's `resolves` go into the page's hydration signature, beside the
    * state and parameters the router stands on, and the client adopts them on
-   * boot in place of running those resolve functions. Return `undefined` to
-   * write none. Without this hook no page carries resolves.
+   * boot in place of running those resolve functions. Pass `{}` to draw every
+   * resolve `dehydrate` draws by default. Without this option or
+   * {@link PrerenderOptions.payload | `payload`}, no page carries resolves.
    *
-   * `dehydrate` from `ui-router-server/ssr` draws the payload; its
-   * documentation says which values it leaves out. The payload's
+   * `dehydrate`'s documentation says which values it leaves out and how
+   * `shouldDehydrate` and `transport` act. The payload's
    * `transported` marks go into the signature too, so a value a transporter
    * carried is rebuilt when `bootstrap()` gets the same `transport`.
    *
    * @example
    * ```ts
-   * payload: (transition, { path }) => {
-   *   const { payload, unserializable } = dehydrate(transition);
-   *   for (const { state, token } of unserializable)
-   *     console.warn(`${path}: ${state}.${token} re-runs on the client`);
-   *   return payload;
+   * dehydrate: {
+   *   shouldDehydrate: ({ token }) => token !== 'manifest',
+   *   transport,
    * },
    * ```
    */
+  dehydrate?: DehydrateOptions;
+  /**
+   * Draws the resolve payload for a rendered page by hand, in place of
+   * {@link PrerenderOptions.dehydrate | `dehydrate`}: handed the transition the
+   * router last landed, once `renderShell` has returned a template, it returns
+   * the payload the page's signature carries, or `undefined` to write none.
+   * Passing both this and `dehydrate` throws.
+   *
+   * @example
+   * Shape the payload `dehydrate` draws before it is written:
+   * ```ts
+   * import { dehydrate } from 'ui-router-server/ssr';
+   *
+   * payload: (transition, { path }) =>
+   *   path.startsWith('/drafts/')
+   *     ? undefined
+   *     : dehydrate(transition, { transport }).payload,
+   * ```
+   */
   payload?: (
     transition: Transition,
     context: RenderContext,
   ) => ResolvePayload | undefined;
 }
 
+/** What a page's hydration signature carries of its resolve payload. */
+export interface PagePayload {
+  /**
+   * The bytes the payload adds to the page's signature as written: its
+   * `resolves` and `transported` members, escaped as the block spells them.
+   */
+  bytes: number;
+  /**
+   * The resolves {@link PrerenderOptions.dehydrate | `dehydrate`} left out of
+   * the payload because their value is not plain JSON data and no transporter
+   * carries it, each to re-run on the client. Present only when `dehydrate`
+   * drew the payload: a {@link PrerenderOptions.payload | `payload`} hook
+   * returns the payload alone.
+   */
+  unserializable?: DehydrateResult['unserializable'];
+}
+
+/** A page {@link prerender} emitted. */
+export interface PrerenderedPage extends EmittedPage {
+  /**
+   * What the page's signature carries of its resolve payload. Absent on a page
+   * that carries none: one drawn with no payload, one `renderShell` returned
+   * as a string, and a response state's body.
+   */
+  payload?: PagePayload;
+}
+
 /** What {@link prerender} did. */
-export interface PrerenderResult extends SitePrerenderResult {
+export interface PrerenderResult extends Omit<SitePrerenderResult, 'pages'> {
+  /** Every page emitted or planned, in enumeration order. */
+  pages: PrerenderedPage[];
   /** The root event target, created or passed through. */
   root: EventTarget;
 }
@@ -225,6 +279,14 @@ export const signatureBlock = (signature: WrittenSignature): string => {
   return `<script type="application/json" ${signatureAttribute}>${json}</script>`;
 };
 
+const utf8Length = (text: string): number =>
+  new TextEncoder().encode(text).length;
+
+/** The bytes `drawn` adds to the signature of the page `router` stands on. */
+const payloadBytes = (router: UIRouterLit, drawn: DrawnResolves): number =>
+  utf8Length(signatureBlock(signatureOf(router, drawn))) -
+  utf8Length(signatureBlock(signatureOf(router)));
+
 /**
  * Renders one page: the signature first, then the render, so the client reads
  * the one before it hydrates the other.
@@ -258,7 +320,7 @@ const warnUnregistered = (): void => {
   if (globalThis.customElements?.get('ui-view')) return;
   console.warn(
     'lit-ui-router-ssr: <ui-view> is not defined on the current customElements registry, so every <ui-view> on these pages renders empty. ' +
-      'The DOM shim replaces the registry when it finishes installing: load lit-ui-router-ssr/register by dynamic import after the shim, or preload the shim with node --import.',
+      'The DOM shim replaces the registry when it finishes installing: prerender through serverRouterPlugin from lit-ui-router-ssr/vite, which preloads both, load lit-ui-router-ssr/register by dynamic import after the shim, or preload the shim with node --import.',
   );
 };
 
@@ -279,9 +341,12 @@ const warnUnregistered = (): void => {
  * A rendered page opens on its hydration signature: a JSON data block,
  * `<script type="application/json" data-lit-ui-router-ssr>`, naming this
  * package's version and the state and parameter values the router stood on,
- * which `hydrateRoot()` reads before it touches the document. A
- * {@link PrerenderOptions.payload | `payload`} hook adds the resolved values
- * the page was drawn with, which `bootstrap()` adopts. A `renderShell`
+ * which `hydrateRoot()` reads before it touches the document.
+ * {@link PrerenderOptions.dehydrate | `dehydrate`}, or a
+ * {@link PrerenderOptions.payload | `payload`} hook, adds the resolved values
+ * the page was drawn with, which `bootstrap()` adopts; the page's entry in
+ * the result's `pages` reports the bytes they add and, from `dehydrate`, the
+ * resolves left to re-run on the client. A `renderShell`
  * that returns a string is written as-is, with no signature, so the client
  * renders it cold.
  *
@@ -295,6 +360,7 @@ const warnUnregistered = (): void => {
  * @returns what was emitted, planned or written
  * @throws an `Error` when neither `mounts` nor `resolver` is supplied
  * @throws an `Error` when the 404 document needs a default probe and only a `resolver` is supplied
+ * @throws an `Error` when both `dehydrate` and `payload` are supplied
  *
  * @example
  * ```ts
@@ -321,23 +387,58 @@ export async function prerender(
     elementRenderers = [UiViewRenderer, LightElementRenderer],
     root = new EventTarget(),
     write = nodeWrite,
+    dehydrate: dehydrateOptions,
     payload,
     responses,
     origin = 'http://lit-ui-router-ssr',
     ...site
   } = options;
 
+  if (dehydrateOptions && payload)
+    throw new Error(
+      'prerender: pass `dehydrate` or `payload`, not both; a `payload` hook calls `dehydrate()` itself',
+    );
+
   warnUnregistered();
 
-  const payloadOf = (context: RenderContext): ResolvePayload | undefined => {
-    if (!payload) return undefined;
+  const draw = (
+    transition: Transition,
+    context: RenderContext,
+  ): Partial<DehydrateResult> => {
+    if (dehydrateOptions) return dehydrateLanded(transition, dehydrateOptions);
+
+    return { payload: payload?.(transition, context) };
+  };
+
+  const drawLanded = (context: RenderContext): Partial<DehydrateResult> => {
+    if (!dehydrateOptions && !payload) return {};
 
     // SAFETY: `peekTail()` is typed `Transition` and returns `undefined` on an empty queue.
     const landed = router.globals.successfulTransitions.peekTail() as
       | Transition
       | undefined;
 
-    return landed && payload(landed, context);
+    return landed ? draw(landed, context) : {};
+  };
+
+  const reports = new Map<string, PagePayload>();
+
+  const renderTemplate = (
+    body: TemplateResult,
+    context: RenderContext,
+  ): string => {
+    const { payload: drawn, unserializable } = drawLanded(context);
+
+    if (drawn) {
+      const bytes = payloadBytes(router, drawn);
+
+      reports.set(
+        context.file,
+        unserializable ? { bytes, unserializable } : { bytes },
+      );
+    }
+
+    return renderPage(body, router, root, elementRenderers, drawn);
   };
 
   const renderLit = async (
@@ -347,9 +448,7 @@ export async function prerender(
     const context: RenderContext = { ...siteContext, root };
     const body = await renderShell(verdict, context);
 
-    const markup = isString(body)
-      ? body
-      : renderPage(body, router, root, elementRenderers, payloadOf(context));
+    const markup = isString(body) ? body : renderTemplate(body, context);
 
     return document ? document(markup, context) : markup;
   };
@@ -379,7 +478,13 @@ export async function prerender(
       write,
     });
 
-    return { ...result, root };
+    const pages = result.pages.map((page): PrerenderedPage => {
+      const report = reports.get(page.file);
+
+      return report ? { ...page, payload: report } : page;
+    });
+
+    return { ...result, pages, root };
   } finally {
     uninstall();
   }

package/src/vite-preload.ts

@@ -0,0 +1,18 @@
+/** `@lit-labs/ssr`'s DOM shim: the default for `serverRouterPlugin`'s `shim`. @internal */
+export const DOM_SHIM: readonly string[] = [
+  '@lit-labs/ssr/lib/install-global-dom-shim.js',
+];
+
+/**
+ * The worker's preloads for a Lit app: the shim modules, then
+ * `lit-ui-router-ssr/register` in the registry they installed, then the app's
+ * own, each once, at its first position.
+ *
+ * @internal
+ */
+export const litPreload = (
+  shim: readonly string[],
+  preload: readonly string[],
+): string[] => [
+  ...new Set([...shim, 'lit-ui-router-ssr/register', ...preload]),
+];

package/src/vite.ts

@@ -0,0 +1,158 @@
+/**
+ * The Vite plugin for a Lit app: `ui-router-server/vite`'s
+ * `serverRouterPlugin`, with the prerender worker set up for Lit. It names
+ * a DOM shim (`@lit-labs/ssr`'s by default) and `lit-ui-router-ssr/register` as preloads, so
+ * the prerender script imports the app, the router and this package
+ * statically, and `definePrerender` calls this package's `prerender()` with
+ * the options the script returns.
+ *
+ * Nothing here imports Lit, `@lit-labs/ssr` or Vite, so `vite.config.ts`
+ * loads it without defining an element or installing a global in Vite's
+ * process.
+ *
+ * @module
+ */
+import { serverRouterPlugin as siteRouterPlugin } from 'ui-router-server/vite';
+import type {
+  PrerenderBuild,
+  PrerenderEntry,
+  ServerRouterPlugin,
+  ServerRouterPluginOptions as SiteRouterPluginOptions,
+} from 'ui-router-server/vite';
+import type { ServerRouter } from 'ui-router-server';
+
+import type { PrerenderOptions } from './prerender.js';
+import { DOM_SHIM, litPreload } from './vite-preload.js';
+
+export type {
+  PrerenderBuild,
+  PrerenderEntry,
+  ServerRouterPlugin,
+} from 'ui-router-server/vite';
+
+/**
+ * `ui-router-server/vite`'s plugin options, plus the DOM the prerender
+ * worker installs for Lit.
+ */
+export interface ServerRouterPluginOptions extends SiteRouterPluginOptions {
+  /**
+   * Modules that install a DOM in the prerender worker, loaded in order
+   * before `lit-ui-router-ssr/register` and any `preload`. Defaults to
+   * `@lit-labs/ssr`'s DOM shim. List another DOM's setup to use it
+   * instead, or pass `[]` to install none: Lit's Node build still renders,
+   * but app code that reads `document` or `window` fails.
+   */
+  shim?: readonly string[];
+}
+
+/**
+ * What a prerender script's callback returns: this package's
+ * {@link PrerenderOptions}, less what the build supplies. `outDir` and
+ * `write` come from the build, so a script may still pass either to
+ * override it.
+ */
+export type PrerenderScriptOptions = Omit<
+  PrerenderOptions,
+  'outDir' | 'write'
+> &
+  Partial<Pick<PrerenderOptions, 'outDir' | 'write'>>;
+
+/**
+ * The callback {@link definePrerender} takes: handed the build's values,
+ * such as `shellHtml` for a `document` hook, it returns the prerender
+ * options.
+ */
+export type PrerenderScript = (
+  build: PrerenderBuild,
+) => PrerenderScriptOptions | Promise<PrerenderScriptOptions>;
+
+// Loaded on call, inside the worker: the plugin's process never evaluates lit.
+const loadPrerender = async () => (await import('./prerender.js')).prerender;
+
+/**
+ * Turns a callback that returns this package's prerender options into a
+ * prerender script's default export. The export spreads the build's values
+ * (`outDir`, `shellHtml`, `write`) under the options and calls this
+ * package's `prerender()`, so the script never calls it itself.
+ *
+ * @param script - returns the prerender options; handed the build's values
+ * @returns the default export for the prerender script
+ *
+ * @example
+ * ```ts
+ * export default definePrerender((site) => ({
+ *   mounts,
+ *   router,
+ *   paths: ['/', '/about'],
+ *   renderShell: async (_verdict, { path }) => {
+ *     await settle(router, path);
+ *     return page(router);
+ *   },
+ *   document: (body) => site.shellHtml.replace('<!--app-->', body),
+ * }));
+ * ```
+ */
+export function definePrerender(script: PrerenderScript): PrerenderEntry {
+  return async (build) => {
+    const [options, prerender] = await Promise.all([
+      script(build),
+      loadPrerender(),
+    ]);
+
+    // `root` is an event target, which the worker can't post back.
+    const { root: _root, ...result } = await prerender({
+      ...build,
+      ...options,
+    });
+
+    return result;
+  };
+}
+
+/**
+ * `ui-router-server/vite`'s `serverRouterPlugin`, set up for a Lit app: with
+ * {@link ServerRouterPluginOptions.prerender | prerender}, the worker loads
+ * the {@link ServerRouterPluginOptions.shim | shim}, then
+ * `lit-ui-router-ssr/register`, then any `preload` passed here, each once,
+ * before the prerender script, so the script imports everything statically. Its default export
+ * comes from this module's {@link definePrerender}.
+ *
+ * `vite dev` and `vite preview` behave as under `ui-router-server/vite`.
+ *
+ * @param router - the server router the middleware and the build step read
+ * @param options - the Connect adapter's options, plus the build step
+ * @returns a plugin to spread into `plugins: [...]`
+ * @throws from the build step when the script has no default export
+ * function, the built `index.html` is missing, or a listed path matches no
+ * route
+ *
+ * @example
+ * ```ts
+ * import { createServerRouter } from 'ui-router-server';
+ * import { serverRouterPlugin } from 'lit-ui-router-ssr/vite';
+ *
+ * plugins: [
+ *   serverRouterPlugin(createServerRouter({ mounts }), {
+ *     prerender: './src/prerender.ts',
+ *   }),
+ * ],
+ * ```
+ */
+export function serverRouterPlugin(
+  router: ServerRouter,
+  options: ServerRouterPluginOptions = {},
+): ServerRouterPlugin {
+  const { shim = DOM_SHIM, ...siteOptions } = options;
+  const { prerender } = siteOptions;
+
+  if (prerender === undefined) return siteRouterPlugin(router, siteOptions);
+
+  const { entry, preload = [] } =
+    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- the option's own union: a string is shorthand for `{ entry }`
+    typeof prerender === 'string' ? { entry: prerender } : prerender;
+
+  return siteRouterPlugin(router, {
+    ...siteOptions,
+    prerender: { entry, preload: litPreload(shim, preload) },
+  });
+}