@rsc-kit/mcp 0.20.11 → 0.20.13

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 (2) hide show
  1. package/guides/ppr.md +23 -0
  2. package/package.json +1 -1
package/guides/ppr.md CHANGED
@@ -51,6 +51,29 @@ the page's title and description into the head when it serves the shell for
51
51
  a url it does know; the client sets the title again after hydration. Static
52
52
  `metadata` on the page and the layouts is in the shell as always.
53
53
 
54
+ ## A shell and the server that finishes it are one build
55
+
56
+ A replay matches a slot by component **name**, so anything that renames a
57
+ component between the build and the server breaks every slot below it.
58
+
59
+
60
+ A postponed state names the components React has to find when it replays, and
61
+ a name is whatever that build's minifier assigned. Resumed against a different
62
+ bundle, the same component answers to something else:
63
+
64
+ ```text
65
+ Expected the resume to render <J> in this slot but instead it rendered <J2>.
66
+ ```
67
+
68
+ Two names for one component is the fingerprint of two builds. Every shell is
69
+ stamped with the build that froze it, and a host that finds a shell from
70
+ another build serves it but renders the page whole instead of resuming it,
71
+ with a line in the log saying so.
72
+
73
+ How they drift apart in practice: a Docker layer, a CI cache or a volume that
74
+ keeps a previous prerender output while the server bundle is rebuilt. Build
75
+ both together, or clear the output directory between builds.
76
+
54
77
  ## A shell for a pattern is one shape
55
78
 
56
79
  A route with params that listed no urls is frozen **once**, for the pattern —
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rsc-kit/mcp",
3
- "version": "0.20.11",
3
+ "version": "0.20.13",
4
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.",
5
5
  "type": "module",
6
6
  "license": "MIT",