docs: sync READMEs with the announce protocol

README.md

@@ -21,7 +21,18 @@ export default defineConfig({
 });
 ```
 
-`vite build` renders every page through the server build, follows links to find the rest, bakes each `prerendered()` server-function call into a JSON artifact, and leaves `dist/client` as the whole deployment — a Solid app with typed server-side data loading and no server.
+```tsx
+// src/App.tsx
+import { announceRoutes } from "@solidjs/prerender";
+import { Router } from "./router";
+
+export default function App() {
+  announceRoutes(Router); // the router tells the crawl its static pages; no-op for visitors
+  return <Router>{props => props.children}</Router>;
+}
+```
+
+`vite build` renders every page through the server build — the router's announced pages plus every link found along the way — bakes each `prerendered()` server-function call into a JSON artifact, and leaves `dist/client` as the whole deployment — a Solid app with typed server-side data loading and no server.
 
 See [`examples/ssg`](./examples/ssg) for a complete site.
 

packages/crawler/README.md

@@ -2,7 +2,7 @@
 
 Framework-agnostic build-time prerendering. Point it at anything fetch-shaped — `Request` in, `Response` out — and it crawls the site into static files: seed pages, link discovery, header hints, redirects, retries, throttling, and an integration seam for capturing build-time data alongside the pages. No browser, no subprocess, no framework knowledge.
 
-Ships as an engine (`prerender-crawler`), a Vite plugin built on it (`prerender-crawler/vite`), and a CLI for everything else.
+Ships as an engine (`prerender-crawler`), a Vite plugin built on it (`prerender-crawler/vite`), a CLI for everything else, and one tiny module for the app's own server (`prerender-crawler/announce`) so it can tell the crawl which pages it has.
 
 ## CLI
 
@@ -61,7 +61,7 @@ The plugin is build-only. It assumes two things about the app:
 1. `vite build` produces a client output directory (the `client` environment's `outDir`, default `dist/client`).
 2. Some environment's output includes a module exporting a request handler — `handleRequest`, `fetch`, or `default.fetch`. Default: `server.js` in the `ssr` environment's `outDir`; override with `serverEntry`.
 
-After the other environments build, it imports the server handler and crawls it in-process. Pages and integration-emitted files land in the client output. Which pages exist is the server's to say — see [Seeding from the router](#seeding-from-the-router).
+After the other environments build, it imports the server handler and crawls it in-process. Pages and integration-emitted files land in the client output. Which pages exist is the server's to say — see [Announcing pages](#announcing-pages).
 
 ### Options
 
@@ -98,7 +98,7 @@ const result = await runPrerender({
   mode: "static"
 });
 
-result.pages; // RenderedPage[]   — path, referrers, filename, emitted, html, redirect?
+result.pages; // RenderedPage[]   — path, referrers, filename, emitted, response, duration, html, redirect?
 result.redirects; // RedirectRecord[] — { from, to, status }, one per redirected path
 result.files; // EmittedFile[]    — what integrations emitted
 result.skipped; // SkippedPage[]    — failures left out (failOnError: false)
@@ -180,7 +180,7 @@ runPrerender({
 | `mode`                   | `"static"`                                      | See [Modes](#modes). Decides the `emitPages` default.                                                                                                                                   |
 | `pages`                  | `["/"]`                                         | Seeds: strings, `{ path, filename?, emit? }` entries, or a (async) function returning them. Duplicates collapse to one render.                                                          |
 | `crawlLinks`             | `true`                                          | Follow same-origin links in rendered HTML. The only way dynamic routes are discovered without explicit seeding.                                                                         |
-| `hintHeader`             | `"x-prerender"`                                 | Response header naming additional paths (comma-separated) — the route the data lives on announces the routes built from it.                                                             |
+| `hintHeader`             | `"x-prerender"`                                 | Response header naming additional paths (comma-separated). See [Announcing pages](#announcing-pages).                                                                                   |
 | `filter`                 |                                                 | `(path) => boolean`; drops a discovered path before it's fetched.                                                                                                                       |
 | `keepQuery`              | `false`                                         | Render query spellings as distinct pages. See [Query strings](#query-strings).                                                                                                          |
 | `concurrency`            | `8`                                             | Pages in flight at once.                                                                                                                                                                |
@@ -191,7 +191,7 @@ runPrerender({
 | `emitPages`              | `true` static / `false` hybrid                  | Whether rendered pages are written: a boolean, or a per-path predicate. Per-entry `emit` overrides. Unemitted pages still render fully — links are still followed, data still captured. |
 | `autoSubfolderIndex`     | `true`                                          | `/about` → `about/index.html` (true) or `about.html` (false).                                                                                                                           |
 | `origin`                 | `"http://localhost"`                            | Origin requests are minted under.                                                                                                                                                       |
-| `onRendered`             |                                                 | Observes every rendered page — the seam for sitemaps and post-processing.                                                                                                               |
+| `onRendered`             |                                                 | Observes every rendered page as it lands — for post-processing. Integrations see the same pages on `context.pages`.                                                                     |
 | `integrations`           | `[]`                                            | See below.                                                                                                                                                                              |
 
 ### Integrations

packages/solid/README.md

@@ -101,8 +101,9 @@ The client learns the posture from `import.meta.env.PRERENDER_MODE`, which the c
 
 ## Other exports
 
+- `solidRouterPages(router | routes, { base? })`, `tanstackRouterPages(router)` — the static-page enumerators behind `announceRoutes`, pure and isomorphic.
 - `staticCallKey(id, args)` / `staticArtifactPath(id, args)` — the artifact key derivation, for tooling that needs to locate an artifact.
-- Types: `PrerenderedFunction`, `ServerFunctionsIntegration`, `ServerFunctionsIntegrationOptions`, `CaptureSink` (server).
+- Types: `PrerenderedFunction`, `AnnounceableRouter`, `AnnounceRoutesOptions`, `SolidRouterLike`, `SolidRouteLike`, `TanStackRouterLike`, `ServerFunctionsIntegration`, `ServerFunctionsIntegrationOptions`, `CaptureSink` (server).
 
 ## License