@rsc-kit/mcp 0.29.2 → 0.29.4

package/guides/routing.md

@@ -300,16 +300,23 @@ They behave differently on the server, for a reason. A **pathname** is fixed for
 a stored page, so `usePathname` just answers with the url being rendered.
 
 A **query string** is not — the same route is asked for with `?q=shoes` and
-`?q=hats` — so there is no honest answer at build time, and `useSearchParams`
-throws rather than pretending it is empty. The dev server does the same, on
-purpose: a page has one shape, and a boundary missing in dev is the one the
-build will refuse. Under a `<Suspense>` you wrote, nothing is said. With
-nothing closer than a `loading.tsx`, dev prints one line and shows it at the
-bottom of the page: the whole segment is that fallback until the query
-arrives, and a boundary around the component that reads keeps the rest
-painted.
+`?q=hats` — so what `useSearchParams` does on the server depends on whether
+the HTML can be stored:
 
-Wrap it, and the throw becomes the fallback:
+- **Rendered for a request** — a page rendered per visitor, or the hole of a
+  stored shell filled per request — it answers with that request's query. The
+  component renders on the server like any other, with no flash, and a form
+  that keeps its state in the url (a folder picker on `?root=`) arrives
+  filled in.
+- **Rendered at build**, for a page or shell that is stored, there is no honest
+  answer, and it throws rather than pretending the query is empty.
+
+The dev server renders every page per request, so in development it always
+answers. A read in the stored part of a page still shows its fallback first in
+a build, and the build says so: under a `<Suspense>` you wrote, nothing is
+said; with nothing closer than a `loading.tsx`, one line naming the component.
+
+Where the page is stored, wrap it, and the throw becomes the fallback:
 
 ```tsx title="src/app/search/page.tsx"
 export default function SearchPage() {
@@ -364,7 +371,9 @@ the case where a server component reads the query and should render again with
 the new one: with no router to call, it falls back to a full page load.
 
 This adapter hands that case to the router, so the page's payload is refetched
-in place and every bit of client state survives. It also tells our own
+in place and every bit of client state survives. On a page rendered per request, a
+`useQueryState` renders on the server with the visitor's query, as
+`useSearchParams` does - nuqs reads through it. It also tells our own
 `useSearchParams` about a shallow change — that hook listens for a navigation
 event rather than watching history, so an adapter that only writes the url
 would leave the rest of the page reading the old query.

package/guides/static-generation.md

@@ -318,6 +318,16 @@ left out, which is how you move an app towards being exportable.
 A route that only redirects is written as a meta refresh, which is the one
 redirect every static host performs without being configured.
 
+Everything a server would have answered as a file comes along: the browser
+bundle, your `public/` folder, the icons and share image beside the root
+layout, the web manifest and the service worker. So do stored `route.ts`
+answers - `robots.txt`, `sitemap.xml`, a JSON feed - written as the files they
+are. A static host types a file by its extension, so only an answer at a url
+with one can keep its content type: `/api/health` would be served without its
+`application/json`, and the build lists it as left out rather than exporting
+it wrong. Give such a route an extension (`/api/health.json`), or serve it
+from a host that runs.
+
 ## Customising the document
 
 There is no separate shell template. The root `layout.tsx` renders the whole

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsc-kit/mcp",
-  "version": "0.29.2",
+  "version": "0.29.4",
   "description": "An MCP server over what an rsc-kit build decided: the routes, why each one is static or not, and what it costs the browser.",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "create-rsc-kit": "^0.29.2",
+    "create-rsc-kit": "^0.29.4",
     "zod": "^3.25"
   },
   "devDependencies": {