@timber-js/app 0.2.0-alpha.240 → 0.2.0-alpha.242

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 (408) hide show
  1. package/dist/_chunks/{actions-DIgnvDrG.js → actions-BkwgRwCl.js} +146 -12
  2. package/dist/_chunks/actions-BkwgRwCl.js.map +1 -0
  3. package/dist/_chunks/{als-registry-PPYstxK0.js → als-registry-C-iwbtvI.js} +4 -3
  4. package/dist/_chunks/{als-registry-PPYstxK0.js.map → als-registry-C-iwbtvI.js.map} +1 -1
  5. package/dist/_chunks/{als-slots-kbQrHTzm.js → als-slots-CVTF-AMz.js} +3 -3
  6. package/dist/_chunks/als-slots-CVTF-AMz.js.map +1 -0
  7. package/dist/_chunks/{cache-api-uWQwuxWb.js → cache-api-BGA7c5qJ.js} +5 -5
  8. package/dist/_chunks/{cache-api-uWQwuxWb.js.map → cache-api-BGA7c5qJ.js.map} +1 -1
  9. package/dist/_chunks/{chains-C7CExrUI.js → chains-Cuwwjv6T.js} +2 -2
  10. package/dist/_chunks/{chains-C7CExrUI.js.map → chains-Cuwwjv6T.js.map} +1 -1
  11. package/dist/_chunks/chains-LGjBHfSN.js +1 -0
  12. package/dist/_chunks/{classify-Cj9EeZoL.js → classify-Y8S9C0Na.js} +2 -2
  13. package/dist/_chunks/{classify-Cj9EeZoL.js.map → classify-Y8S9C0Na.js.map} +1 -1
  14. package/dist/_chunks/{cli-check-C3QOAru7.js → cli-check-KeE1QaIx.js} +7 -6
  15. package/dist/_chunks/cli-check-KeE1QaIx.js.map +1 -0
  16. package/dist/_chunks/{cli-schema-sync-DQUS_o3V.js → cli-schema-sync-DZEF31wd.js} +2 -2
  17. package/dist/_chunks/{cli-schema-sync-DQUS_o3V.js.map → cli-schema-sync-DZEF31wd.js.map} +1 -1
  18. package/dist/_chunks/{cli-schema-sync-BRxZz66D.js → cli-schema-sync-_y5O6MIg.js} +1 -1
  19. package/dist/_chunks/{client-dep-entries-ZETBdLgv.js → client-dep-entries-DpiwvoDi.js} +2 -2
  20. package/dist/_chunks/{client-dep-entries-ZETBdLgv.js.map → client-dep-entries-DpiwvoDi.js.map} +1 -1
  21. package/dist/_chunks/{cloudflare-Dk5Hqo-O.js → cloudflare-9dbhVOxS.js} +2 -2
  22. package/dist/_chunks/{cloudflare-Dk5Hqo-O.js.map → cloudflare-9dbhVOxS.js.map} +1 -1
  23. package/dist/_chunks/{convention-lint-BoVISNS6.js → convention-lint-0AEsPK2T.js} +378 -10
  24. package/dist/_chunks/convention-lint-0AEsPK2T.js.map +1 -0
  25. package/dist/_chunks/dev-server-CboXr8zX.js +1 -0
  26. package/dist/_chunks/{dev-server-C5R6jx8Q.js → dev-server-DYDr8KIc.js} +9 -3
  27. package/dist/_chunks/dev-server-DYDr8KIc.js.map +1 -0
  28. package/dist/_chunks/{dist-C1Rjlo6s.js → dist-GyaJm4GA.js} +18 -2
  29. package/dist/_chunks/dist-GyaJm4GA.js.map +1 -0
  30. package/dist/_chunks/{error-boundary-DB51f9ih.js → error-boundary-wuNvAJ4n.js} +11 -14
  31. package/dist/_chunks/error-boundary-wuNvAJ4n.js.map +1 -0
  32. package/dist/_chunks/{flight-source-node-D9cHBhjP.js → flight-source-node-KQsX_OhS.js} +4 -7
  33. package/dist/_chunks/flight-source-node-KQsX_OhS.js.map +1 -0
  34. package/dist/_chunks/{json-lossy-check-Y1GxqVX_.js → json-lossy-check-BVDALqMf.js} +2 -2
  35. package/dist/_chunks/{json-lossy-check-Y1GxqVX_.js.map → json-lossy-check-BVDALqMf.js.map} +1 -1
  36. package/dist/_chunks/key-headers-uIig1_mU.js +40 -0
  37. package/dist/_chunks/key-headers-uIig1_mU.js.map +1 -0
  38. package/dist/_chunks/{live-graph-BDQWvnMm.js → live-graph-VhzO7Ol9.js} +4 -4
  39. package/dist/_chunks/{live-graph-BDQWvnMm.js.map → live-graph-VhzO7Ol9.js.map} +1 -1
  40. package/dist/_chunks/{logger-DmRR9tmZ.js → logger-C4m8rfMy.js} +2 -2
  41. package/dist/_chunks/{logger-DmRR9tmZ.js.map → logger-C4m8rfMy.js.map} +1 -1
  42. package/dist/_chunks/metadata-routes-MXNjWOt5.js.map +1 -1
  43. package/dist/_chunks/{node-response-yp8zdyRp.js → node-response-8Vz29cGS.js} +2 -2
  44. package/dist/_chunks/{node-response-yp8zdyRp.js.map → node-response-8Vz29cGS.js.map} +1 -1
  45. package/dist/_chunks/{poison-scan-WQgUydF_.js → poison-scan-Dpl3ibG-.js} +2 -2
  46. package/dist/_chunks/{poison-scan-WQgUydF_.js.map → poison-scan-Dpl3ibG-.js.map} +1 -1
  47. package/dist/_chunks/{rsc-cache-key-D0cb0Gmc.js → rsc-cache-key-BGvUtMtN.js} +40 -4
  48. package/dist/_chunks/{rsc-cache-key-D0cb0Gmc.js.map → rsc-cache-key-BGvUtMtN.js.map} +1 -1
  49. package/dist/_chunks/{scanner-C9Lrf77z.js → scanner-CCEHN9Jg.js} +14 -81
  50. package/dist/_chunks/scanner-CCEHN9Jg.js.map +1 -0
  51. package/dist/_chunks/{sizeof-BISkSaU0.js → sizeof-CIF7fwSJ.js} +2 -2
  52. package/dist/_chunks/{sizeof-BISkSaU0.js.map → sizeof-CIF7fwSJ.js.map} +1 -1
  53. package/dist/_chunks/{walkers-Bxv4v7tX.js → walkers-BbotBhNG.js} +3 -3
  54. package/dist/_chunks/{walkers-Bxv4v7tX.js.map → walkers-BbotBhNG.js.map} +1 -1
  55. package/dist/adapters/cloudflare-dev.js +1 -1
  56. package/dist/adapters/cloudflare-kv-cache.js +2 -2
  57. package/dist/adapters/cloudflare.js +1 -1
  58. package/dist/analyze/crawl-entry.js +3 -3
  59. package/dist/analyze/graph-command.js +2 -2
  60. package/dist/cache/index.js +2 -2
  61. package/dist/cache/stores/memory.js +1 -1
  62. package/dist/cdn/workers-cache-purge.js +1 -1
  63. package/dist/cli-check.d.ts +3 -0
  64. package/dist/cli-check.d.ts.map +1 -1
  65. package/dist/cli.js +3 -3
  66. package/dist/client/browser-entry/router-init.d.ts +0 -1
  67. package/dist/client/browser-entry/router-init.d.ts.map +1 -1
  68. package/dist/client/error-boundary.js +1 -1
  69. package/dist/client/index.js +2 -2
  70. package/dist/client/index.js.map +1 -1
  71. package/dist/client/internal.js +4 -5
  72. package/dist/client/internal.js.map +1 -1
  73. package/dist/client/navigation-commit.d.ts +3 -5
  74. package/dist/client/navigation-commit.d.ts.map +1 -1
  75. package/dist/client/outlet-content-cache.d.ts +25 -30
  76. package/dist/client/outlet-content-cache.d.ts.map +1 -1
  77. package/dist/client/outlet-scope-context.d.ts +4 -4
  78. package/dist/client/outlet-scope-context.d.ts.map +1 -1
  79. package/dist/client/params-context.d.ts +1 -1
  80. package/dist/client/router-types.d.ts +3 -13
  81. package/dist/client/router-types.d.ts.map +1 -1
  82. package/dist/client/router.d.ts.map +1 -1
  83. package/dist/client/segment-cache.d.ts +2 -2
  84. package/dist/client/segment-outlet.d.ts +12 -13
  85. package/dist/client/segment-outlet.d.ts.map +1 -1
  86. package/dist/client/stale-segment.d.ts +2 -2
  87. package/dist/config-types.d.ts +22 -15
  88. package/dist/config-types.d.ts.map +1 -1
  89. package/dist/config-validation.d.ts.map +1 -1
  90. package/dist/cookies/define-cookie.d.ts.map +1 -1
  91. package/dist/cookies/index.js +5 -2
  92. package/dist/cookies/index.js.map +1 -1
  93. package/dist/index.d.ts +1 -0
  94. package/dist/index.d.ts.map +1 -1
  95. package/dist/index.js +109 -26
  96. package/dist/index.js.map +1 -1
  97. package/dist/native/rsc/cookies/define-cookie.js +6 -2
  98. package/dist/native/rsc/cookies/define-cookie.js.map +1 -1
  99. package/dist/native/rsc/manifest.json +12 -4
  100. package/dist/native/rsc/routing/segment-keys.js +11 -1
  101. package/dist/native/rsc/routing/segment-keys.js.map +1 -1
  102. package/dist/native/rsc/search-params/define.js +4 -1
  103. package/dist/native/rsc/search-params/define.js.map +1 -1
  104. package/dist/native/rsc/server/als-registry.js +2 -2
  105. package/dist/native/rsc/server/als-registry.js.map +1 -1
  106. package/dist/native/rsc/server/client-state-tree.js +13 -12
  107. package/dist/native/rsc/server/client-state-tree.js.map +1 -1
  108. package/dist/native/rsc/server/cookie-context.js +12 -0
  109. package/dist/native/rsc/server/cookie-context.js.map +1 -1
  110. package/dist/native/rsc/server/flight-source-node.js +2 -5
  111. package/dist/native/rsc/server/flight-source-node.js.map +1 -1
  112. package/dist/native/rsc/server/flight-source.js +8 -40
  113. package/dist/native/rsc/server/flight-source.js.map +1 -1
  114. package/dist/native/rsc/server/framework-stack-frames.js +18 -0
  115. package/dist/native/rsc/server/framework-stack-frames.js.map +1 -0
  116. package/dist/native/rsc/server/prebuilt-builder.js +15 -1
  117. package/dist/native/rsc/server/prebuilt-builder.js.map +1 -1
  118. package/dist/native/rsc/server/request-context.js +11 -5
  119. package/dist/native/rsc/server/request-context.js.map +1 -1
  120. package/dist/native/rsc/server/route-element-builder.js +29 -11
  121. package/dist/native/rsc/server/route-element-builder.js.map +1 -1
  122. package/dist/native/rsc/server/route-module-loader.js +14 -6
  123. package/dist/native/rsc/server/route-module-loader.js.map +1 -1
  124. package/dist/native/rsc/server/rsc-cache-key-guard.js +5 -1
  125. package/dist/native/rsc/server/rsc-cache-key-guard.js.map +1 -1
  126. package/dist/native/rsc/server/rsc-entry/render-route.js +10 -29
  127. package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
  128. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +7 -2
  129. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
  130. package/dist/native/rsc/server/rsc-entry/rsc-stream.js +2 -5
  131. package/dist/native/rsc/server/rsc-entry/rsc-stream.js.map +1 -1
  132. package/dist/native/rsc/server/segment-lifetime/document-outlet.js +24 -0
  133. package/dist/native/rsc/server/segment-lifetime/document-outlet.js.map +1 -0
  134. package/dist/native/rsc/server/segment-lifetime/key-digest.js +74 -0
  135. package/dist/native/rsc/server/segment-lifetime/key-digest.js.map +1 -0
  136. package/dist/native/rsc/server/segment-lifetime/outlet-gate.js +44 -0
  137. package/dist/native/rsc/server/segment-lifetime/outlet-gate.js.map +1 -0
  138. package/dist/native/rsc/server/segment-lifetime/read-rule.js +78 -0
  139. package/dist/native/rsc/server/segment-lifetime/read-rule.js.map +1 -0
  140. package/dist/native/rsc/server/segment-lifetime/read-scope.js +41 -0
  141. package/dist/native/rsc/server/segment-lifetime/read-scope.js.map +1 -0
  142. package/dist/native/rsc/server/segment-lifetime/segment-key.js +64 -0
  143. package/dist/native/rsc/server/segment-lifetime/segment-key.js.map +1 -0
  144. package/dist/native/rsc/server/segment-lifetime/slot-outlets.js +72 -0
  145. package/dist/native/rsc/server/segment-lifetime/slot-outlets.js.map +1 -0
  146. package/dist/native/rsc/server/slot-resolver.js +51 -27
  147. package/dist/native/rsc/server/slot-resolver.js.map +1 -1
  148. package/dist/native/rsc/server/slot-subtree-contain.js +17 -89
  149. package/dist/native/rsc/server/slot-subtree-contain.js.map +1 -1
  150. package/dist/native/rsc/server/subtree-walk.js +140 -0
  151. package/dist/native/rsc/server/subtree-walk.js.map +1 -0
  152. package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
  153. package/dist/native/rsc/shared/als-slots.js +2 -2
  154. package/dist/native/rsc/shared/als-slots.js.map +1 -1
  155. package/dist/native/rsc/shared/cookie-read-through.js +5 -0
  156. package/dist/native/rsc/shared/cookie-read-through.js.map +1 -0
  157. package/dist/native/rsc/shared/key-headers.js +20 -0
  158. package/dist/native/rsc/shared/key-headers.js.map +1 -0
  159. package/dist/native/rsc/shared/outlet-decision.js.map +1 -1
  160. package/dist/native/rsc/shared/route-options-export.js +8 -0
  161. package/dist/native/rsc/shared/route-options-export.js.map +1 -0
  162. package/dist/native/rsc/shared/rsc-cache-key.js +19 -3
  163. package/dist/native/rsc/shared/rsc-cache-key.js.map +1 -1
  164. package/dist/native/rsc/shims/headers.js +3 -4
  165. package/dist/native/rsc/shims/headers.js.map +1 -1
  166. package/dist/native/ssr/client/outlet-content-cache.js +12 -18
  167. package/dist/native/ssr/client/outlet-content-cache.js.map +1 -1
  168. package/dist/native/ssr/client/outlet-scope-context.js.map +1 -1
  169. package/dist/native/ssr/client/segment-outlet.js +6 -19
  170. package/dist/native/ssr/client/segment-outlet.js.map +1 -1
  171. package/dist/native/ssr/cookies/define-cookie.js +6 -2
  172. package/dist/native/ssr/cookies/define-cookie.js.map +1 -1
  173. package/dist/native/ssr/manifest.json +5 -1
  174. package/dist/native/ssr/search-params/define.js +4 -1
  175. package/dist/native/ssr/search-params/define.js.map +1 -1
  176. package/dist/native/ssr/server/als-registry.js +2 -2
  177. package/dist/native/ssr/server/als-registry.js.map +1 -1
  178. package/dist/native/ssr/server/client-state-tree.js +13 -12
  179. package/dist/native/ssr/server/client-state-tree.js.map +1 -1
  180. package/dist/native/ssr/server/cookie-context.js +12 -0
  181. package/dist/native/ssr/server/cookie-context.js.map +1 -1
  182. package/dist/native/ssr/server/flight-source-node.js +2 -5
  183. package/dist/native/ssr/server/flight-source-node.js.map +1 -1
  184. package/dist/native/ssr/server/flight-source.js +1 -1
  185. package/dist/native/ssr/server/flight-source.js.map +1 -1
  186. package/dist/native/ssr/server/framework-stack-frames.js +18 -0
  187. package/dist/native/ssr/server/framework-stack-frames.js.map +1 -0
  188. package/dist/native/ssr/server/request-context.js +11 -5
  189. package/dist/native/ssr/server/request-context.js.map +1 -1
  190. package/dist/native/ssr/server/rsc-cache-key-guard.js +5 -1
  191. package/dist/native/ssr/server/rsc-cache-key-guard.js.map +1 -1
  192. package/dist/native/ssr/server/segment-lifetime/key-digest.js +6 -0
  193. package/dist/native/ssr/server/segment-lifetime/key-digest.js.map +1 -0
  194. package/dist/native/ssr/server/segment-lifetime/read-rule.js +78 -0
  195. package/dist/native/ssr/server/segment-lifetime/read-rule.js.map +1 -0
  196. package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
  197. package/dist/native/ssr/shared/als-slots.js +2 -2
  198. package/dist/native/ssr/shared/als-slots.js.map +1 -1
  199. package/dist/native/ssr/shared/cookie-read-through.js +5 -0
  200. package/dist/native/ssr/shared/cookie-read-through.js.map +1 -0
  201. package/dist/native/ssr/shared/key-headers.js +13 -0
  202. package/dist/native/ssr/shared/key-headers.js.map +1 -0
  203. package/dist/native/ssr/shared/rsc-cache-key.js +19 -3
  204. package/dist/native/ssr/shared/rsc-cache-key.js.map +1 -1
  205. package/dist/native/ssr/shims/headers.js +3 -4
  206. package/dist/native/ssr/shims/headers.js.map +1 -1
  207. package/dist/plugins/callsite-jsx.d.ts +8 -1
  208. package/dist/plugins/callsite-jsx.d.ts.map +1 -1
  209. package/dist/plugins/entries.d.ts.map +1 -1
  210. package/dist/plugins/prerender-sugar.d.ts +9 -8
  211. package/dist/plugins/prerender-sugar.d.ts.map +1 -1
  212. package/dist/plugins/routing.d.ts.map +1 -1
  213. package/dist/routing/convention-lint.d.ts +11 -3
  214. package/dist/routing/convention-lint.d.ts.map +1 -1
  215. package/dist/routing/export-detect.d.ts +50 -23
  216. package/dist/routing/export-detect.d.ts.map +1 -1
  217. package/dist/routing/index.js +2 -2
  218. package/dist/routing/route-options-lint.d.ts +36 -0
  219. package/dist/routing/route-options-lint.d.ts.map +1 -0
  220. package/dist/routing/route-options.d.ts +55 -0
  221. package/dist/routing/route-options.d.ts.map +1 -0
  222. package/dist/routing/segment-keys.d.ts +38 -4
  223. package/dist/routing/segment-keys.d.ts.map +1 -1
  224. package/dist/search-params/index.js +5 -2
  225. package/dist/search-params/index.js.map +1 -1
  226. package/dist/server/als-registry.d.ts +22 -13
  227. package/dist/server/als-registry.d.ts.map +1 -1
  228. package/dist/server/client-state-tree.d.ts +11 -10
  229. package/dist/server/client-state-tree.d.ts.map +1 -1
  230. package/dist/server/cookie-context.d.ts +3 -0
  231. package/dist/server/cookie-context.d.ts.map +1 -1
  232. package/dist/server/flight-source-node.d.ts +1 -6
  233. package/dist/server/flight-source-node.d.ts.map +1 -1
  234. package/dist/server/flight-source.d.ts +4 -28
  235. package/dist/server/flight-source.d.ts.map +1 -1
  236. package/dist/server/framework-stack-frames.d.ts +20 -0
  237. package/dist/server/framework-stack-frames.d.ts.map +1 -0
  238. package/dist/server/index.d.ts +1 -0
  239. package/dist/server/index.d.ts.map +1 -1
  240. package/dist/server/index.js +2 -2
  241. package/dist/server/internal.js +102 -28
  242. package/dist/server/internal.js.map +1 -1
  243. package/dist/server/prebuilt/capture-routes.d.ts +1 -1
  244. package/dist/server/prebuilt-builder.d.ts.map +1 -1
  245. package/dist/server/request-context.d.ts +6 -1
  246. package/dist/server/request-context.d.ts.map +1 -1
  247. package/dist/server/route-element-builder.d.ts +2 -2
  248. package/dist/server/route-element-builder.d.ts.map +1 -1
  249. package/dist/server/route-module-loader.d.ts +10 -2
  250. package/dist/server/route-module-loader.d.ts.map +1 -1
  251. package/dist/server/rsc-cache-key-guard.d.ts +3 -1
  252. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -1
  253. package/dist/server/rsc-entry/helpers.d.ts +1 -1
  254. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  255. package/dist/server/rsc-entry/render-route.d.ts +10 -1
  256. package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
  257. package/dist/server/rsc-entry/revalidate-renderer.d.ts +12 -0
  258. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
  259. package/dist/server/rsc-entry/rsc-stream.d.ts +2 -11
  260. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  261. package/dist/server/segment-lifetime/document-outlet.d.ts +66 -0
  262. package/dist/server/segment-lifetime/document-outlet.d.ts.map +1 -0
  263. package/dist/server/segment-lifetime/key-digest.d.ts +46 -0
  264. package/dist/server/segment-lifetime/key-digest.d.ts.map +1 -0
  265. package/dist/server/segment-lifetime/outlet-gate.d.ts +58 -0
  266. package/dist/server/segment-lifetime/outlet-gate.d.ts.map +1 -0
  267. package/dist/server/segment-lifetime/read-rule.d.ts +53 -0
  268. package/dist/server/segment-lifetime/read-rule.d.ts.map +1 -0
  269. package/dist/server/segment-lifetime/read-scope.d.ts +40 -0
  270. package/dist/server/segment-lifetime/read-scope.d.ts.map +1 -0
  271. package/dist/server/segment-lifetime/segment-key.d.ts +63 -0
  272. package/dist/server/segment-lifetime/segment-key.d.ts.map +1 -0
  273. package/dist/server/segment-lifetime/slot-outlets.d.ts +81 -0
  274. package/dist/server/segment-lifetime/slot-outlets.d.ts.map +1 -0
  275. package/dist/server/slot-resolver.d.ts +10 -5
  276. package/dist/server/slot-resolver.d.ts.map +1 -1
  277. package/dist/server/slot-subtree-contain.d.ts +2 -6
  278. package/dist/server/slot-subtree-contain.d.ts.map +1 -1
  279. package/dist/server/subtree-walk.d.ts +56 -0
  280. package/dist/server/subtree-walk.d.ts.map +1 -0
  281. package/dist/server/types.d.ts +75 -0
  282. package/dist/server/types.d.ts.map +1 -1
  283. package/dist/server/vite-handoff-rsc.d.ts +1 -10
  284. package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
  285. package/dist/shared/als-slots.d.ts +12 -2
  286. package/dist/shared/als-slots.d.ts.map +1 -1
  287. package/dist/shared/cookie-read-through.d.ts +18 -0
  288. package/dist/shared/cookie-read-through.d.ts.map +1 -0
  289. package/dist/shared/key-headers.d.ts +13 -0
  290. package/dist/shared/key-headers.d.ts.map +1 -0
  291. package/dist/shared/outlet-decision.d.ts +16 -28
  292. package/dist/shared/outlet-decision.d.ts.map +1 -1
  293. package/dist/shared/payload-root.d.ts +1 -1
  294. package/dist/shared/route-options-export.d.ts +13 -0
  295. package/dist/shared/route-options-export.d.ts.map +1 -0
  296. package/dist/shared/rsc-cache-key.d.ts +22 -0
  297. package/dist/shared/rsc-cache-key.d.ts.map +1 -1
  298. package/dist/shared/segment-info.d.ts +7 -5
  299. package/dist/shared/segment-info.d.ts.map +1 -1
  300. package/dist/shims/headers.d.ts.map +1 -1
  301. package/docs/api/30-api-server.mdx +29 -0
  302. package/docs/api/32-api-cache.mdx +10 -4
  303. package/docs/api/34-api-config.mdx +5 -0
  304. package/docs/learn/09-streaming.mdx +6 -2
  305. package/docs/learn/10-caching.mdx +10 -4
  306. package/package.json +1 -1
  307. package/src/cli-check.ts +11 -3
  308. package/src/client/browser-entry/index.ts +0 -2
  309. package/src/client/browser-entry/router-init.ts +2 -4
  310. package/src/client/error-boundary.tsx +1 -1
  311. package/src/client/navigation-commit.ts +9 -14
  312. package/src/client/outlet-content-cache.ts +36 -42
  313. package/src/client/outlet-scope-context.ts +5 -5
  314. package/src/client/params-context.ts +1 -1
  315. package/src/client/router-types.ts +3 -14
  316. package/src/client/router.ts +1 -2
  317. package/src/client/rsc-fetch.ts +1 -1
  318. package/src/client/segment-cache.ts +2 -2
  319. package/src/client/segment-outlet.tsx +19 -45
  320. package/src/client/stale-segment.ts +2 -2
  321. package/src/config-types.ts +23 -15
  322. package/src/config-validation.ts +17 -1
  323. package/src/cookies/define-cookie.ts +5 -1
  324. package/src/index.ts +2 -1
  325. package/src/plugins/callsite-jsx.ts +104 -6
  326. package/src/plugins/entries.ts +3 -1
  327. package/src/plugins/prerender-sugar.ts +34 -18
  328. package/src/plugins/routing.ts +3 -1
  329. package/src/routing/convention-lint.ts +18 -7
  330. package/src/routing/export-detect.ts +14 -117
  331. package/src/routing/route-options-lint.ts +153 -0
  332. package/src/routing/route-options.ts +439 -0
  333. package/src/routing/scanner.ts +1 -1
  334. package/src/routing/segment-keys.ts +53 -4
  335. package/src/rsc-runtime/vendor-types.d.ts +5 -1
  336. package/src/search-params/define.ts +1 -1
  337. package/src/server/als-registry.ts +25 -17
  338. package/src/server/client-state-tree.ts +30 -27
  339. package/src/server/cookie-context.ts +17 -0
  340. package/src/server/flight-source-node.ts +1 -5
  341. package/src/server/flight-source.ts +8 -82
  342. package/src/server/framework-stack-frames.ts +41 -0
  343. package/src/server/index.ts +7 -0
  344. package/src/server/prebuilt/capture-routes.ts +1 -1
  345. package/src/server/prebuilt-builder.ts +30 -2
  346. package/src/server/request-context.ts +31 -6
  347. package/src/server/route-element-builder.ts +92 -18
  348. package/src/server/route-module-loader.ts +43 -10
  349. package/src/server/rsc-cache-key-guard.ts +17 -2
  350. package/src/server/rsc-entry/helpers.ts +1 -1
  351. package/src/server/rsc-entry/index.ts +16 -3
  352. package/src/server/rsc-entry/render-route.ts +22 -51
  353. package/src/server/rsc-entry/revalidate-renderer.ts +16 -2
  354. package/src/server/rsc-entry/rsc-stream.ts +3 -23
  355. package/src/server/segment-lifetime/document-outlet.ts +98 -0
  356. package/src/server/segment-lifetime/key-digest.ts +139 -0
  357. package/src/server/segment-lifetime/outlet-gate.ts +102 -0
  358. package/src/server/segment-lifetime/read-rule.ts +193 -0
  359. package/src/server/segment-lifetime/read-scope.ts +101 -0
  360. package/src/server/segment-lifetime/segment-key.ts +168 -0
  361. package/src/server/segment-lifetime/slot-outlets.ts +180 -0
  362. package/src/server/slot-resolver.ts +103 -60
  363. package/src/server/slot-subtree-contain.ts +35 -182
  364. package/src/server/subtree-walk.ts +316 -0
  365. package/src/server/types.ts +91 -0
  366. package/src/server/vite-handoff-rsc.ts +1 -12
  367. package/src/shared/als-slots.ts +19 -8
  368. package/src/shared/cookie-read-through.ts +18 -0
  369. package/src/shared/key-headers.ts +42 -0
  370. package/src/shared/outlet-decision.ts +16 -30
  371. package/src/shared/payload-root.ts +1 -1
  372. package/src/shared/route-options-export.ts +14 -0
  373. package/src/shared/rsc-cache-key.ts +41 -2
  374. package/src/shared/segment-info.ts +7 -5
  375. package/src/shims/headers.ts +5 -4
  376. package/dist/_chunks/actions-DIgnvDrG.js.map +0 -1
  377. package/dist/_chunks/als-slots-kbQrHTzm.js.map +0 -1
  378. package/dist/_chunks/chains-CSslTUdI.js +0 -1
  379. package/dist/_chunks/cli-check-C3QOAru7.js.map +0 -1
  380. package/dist/_chunks/convention-lint-BoVISNS6.js.map +0 -1
  381. package/dist/_chunks/dev-server-B8roKA3Q.js +0 -1
  382. package/dist/_chunks/dev-server-C5R6jx8Q.js.map +0 -1
  383. package/dist/_chunks/dist-C1Rjlo6s.js.map +0 -1
  384. package/dist/_chunks/error-boundary-DB51f9ih.js.map +0 -1
  385. package/dist/_chunks/flight-source-node-D9cHBhjP.js.map +0 -1
  386. package/dist/_chunks/scanner-C9Lrf77z.js.map +0 -1
  387. package/dist/native/rsc/server/segment-hash/capture.js +0 -107
  388. package/dist/native/rsc/server/segment-hash/capture.js.map +0 -1
  389. package/dist/native/rsc/server/segment-hash/outlet.js +0 -81
  390. package/dist/native/rsc/server/segment-hash/outlet.js.map +0 -1
  391. package/dist/native/rsc/server/segment-hash/stream-tap.js +0 -139
  392. package/dist/native/rsc/server/segment-hash/stream-tap.js.map +0 -1
  393. package/dist/native/rsc/server/segment-hash/value-hash.js +0 -171
  394. package/dist/native/rsc/server/segment-hash/value-hash.js.map +0 -1
  395. package/dist/native/ssr/server/segment-hash/value-hash.js +0 -162
  396. package/dist/native/ssr/server/segment-hash/value-hash.js.map +0 -1
  397. package/dist/server/segment-hash/capture.d.ts +0 -77
  398. package/dist/server/segment-hash/capture.d.ts.map +0 -1
  399. package/dist/server/segment-hash/outlet.d.ts +0 -65
  400. package/dist/server/segment-hash/outlet.d.ts.map +0 -1
  401. package/dist/server/segment-hash/stream-tap.d.ts +0 -49
  402. package/dist/server/segment-hash/stream-tap.d.ts.map +0 -1
  403. package/dist/server/segment-hash/value-hash.d.ts +0 -70
  404. package/dist/server/segment-hash/value-hash.d.ts.map +0 -1
  405. package/src/server/segment-hash/capture.ts +0 -232
  406. package/src/server/segment-hash/outlet.ts +0 -185
  407. package/src/server/segment-hash/stream-tap.ts +0 -244
  408. package/src/server/segment-hash/value-hash.ts +0 -338
@@ -0,0 +1,439 @@
1
+ /**
2
+ * Route-module options: `export const layoutOptions = { … }` in a layout and
3
+ * `export const pageOptions = { … }` in a page, read from source.
4
+ *
5
+ * Design doc: design/53-segment-lifetime.md §"Route-module options".
6
+ *
7
+ * `prerender` is read here at build time, before any route module loads:
8
+ * `plugins/prerender-sugar.ts` decides from it which pages to wrap in
9
+ * `cache.component(...)`. Every other option is validated here and read at
10
+ * runtime from the loaded module (`deferSuspenseFor`, in
11
+ * `server/route-module-loader.ts`; `lifetime` and `key`, in
12
+ * `server/segment-lifetime/segment-key.ts`). A key's `searchParams` and
13
+ * `cookies` name definitions, so they are the one place a non-literal value is
14
+ * accepted; `segmentParams` is checked against the segment's path by
15
+ * `routing/route-options-lint.ts`. The whole object follows one rule so that
16
+ * every key is checkable: this reader accepts one spelling —
17
+ * `export const xOptions = { … }` of literal values, optionally behind
18
+ * `satisfies` / `as` — and reports the others it can see as problems.
19
+ * `routing/convention-lint.ts` turns problems into build errors:
20
+ *
21
+ * - a spread, a computed key, a getter or method, or a non-literal value
22
+ * - an unknown key (a misspelled `prerendr`)
23
+ * - `pageOptions` in a layout or `layoutOptions` in a page
24
+ * - options in a `'use client'` file, whose exports the server never sees
25
+ * - the removed floating exports, `export const prerender` and
26
+ * `export const deferSuspenseFor`
27
+ * - `let`, a destructured binding, a specifier or a named re-export
28
+ * (`export { pageOptions } from`, `export * as pageOptions from`)
29
+ *
30
+ * What it cannot see is not reported: `export * from` is not followed, a
31
+ * file that does not parse reads as having no options (the compiler reports
32
+ * it), and MDX pages are not read at all, so `prerender` in an MDX page does
33
+ * nothing and its `deferSuspenseFor` is unvalidated.
34
+ */
35
+
36
+ import { headerKeyProblem } from '../shared/key-headers.ts';
37
+ import { existsSync } from 'node:fs';
38
+ import type {
39
+ LayoutOptions,
40
+ PageOptions,
41
+ RoutePrerender,
42
+ SegmentKey,
43
+ SegmentLifetime,
44
+ } from '../server/types.ts';
45
+ import { patternBinds, TRANSPARENT_WRAPPERS, tryParse } from './export-detect.ts';
46
+ import { readFileCached } from './file-cache.ts';
47
+ import { ROUTE_OPTIONS_EXPORT, type RouteOptionsKind } from '../shared/route-options-export.ts';
48
+
49
+ const OPTIONS_TYPE = { layout: 'LayoutOptions', page: 'PageOptions' } as const;
50
+
51
+ /** Floating exports the options objects replaced (design/53). */
52
+ const REMOVED_EXPORTS = ['prerender', 'deferSuspenseFor'] as const;
53
+
54
+ export interface RouteOptionsRead {
55
+ /**
56
+ * The declared options. Undefined when the file declares none or when any
57
+ * problem was found — a half-read object is never acted on.
58
+ */
59
+ options: LayoutOptions | PageOptions | undefined;
60
+ /** One line per problem, each naming what to write instead. */
61
+ problems: string[];
62
+ }
63
+
64
+ // ─── AST access ────────────────────────────────────────────────────────────
65
+
66
+ /** An ESTree node as oxc's `parseAst` produces it, read field by field. */
67
+ type Node = { readonly type: string; readonly [field: string]: unknown };
68
+
69
+ function isNode(value: unknown): value is Node {
70
+ return (
71
+ typeof value === 'object' && value !== null && 'type' in value && typeof value.type === 'string'
72
+ );
73
+ }
74
+
75
+ function child(node: Node, field: string): Node | undefined {
76
+ const value = node[field];
77
+ return isNode(value) ? value : undefined;
78
+ }
79
+
80
+ function list(node: Node, field: string): unknown[] {
81
+ const value = node[field];
82
+ return Array.isArray(value) ? value : [];
83
+ }
84
+
85
+ /** Strip `satisfies T`, `as T`, `(x)` and friends, which compile away. */
86
+ function unwrap(node: Node): Node {
87
+ let current = node;
88
+ while (TRANSPARENT_WRAPPERS.has(current.type)) {
89
+ const inner = child(current, 'expression');
90
+ if (!inner) break;
91
+ current = inner;
92
+ }
93
+ return current;
94
+ }
95
+
96
+ /** An identifier's name or a string literal's value (`export { x as "y" }`). */
97
+ function nameOf(node: Node | undefined): string | undefined {
98
+ if (!node) return undefined;
99
+ if (typeof node.value === 'string') return node.value;
100
+ return typeof node.name === 'string' ? node.name : undefined;
101
+ }
102
+
103
+ /** A literal's value; a template literal with no `${}` counts as a string. */
104
+ function literal(node: Node): unknown {
105
+ const n = unwrap(node);
106
+ if (n.type === 'Literal') return n.value;
107
+ if (n.type !== 'TemplateLiteral' || list(n, 'expressions').length > 0) return undefined;
108
+ const [quasi] = list(n, 'quasis');
109
+ // A TemplateElement's `value` is `{ raw, cooked }`, not a node.
110
+ const parts = isNode(quasi) ? quasi.value : undefined;
111
+ const value =
112
+ typeof parts === 'object' && parts !== null && 'cooked' in parts ? parts.cooked : undefined;
113
+ return typeof value === 'string' ? value : undefined;
114
+ }
115
+
116
+ /** `key: undefined` — the same as leaving the key out, as the types allow. */
117
+ function isUndefined(node: Node): boolean {
118
+ const n = unwrap(node);
119
+ return n.type === 'Identifier' && n.name === 'undefined';
120
+ }
121
+
122
+ // ─── Value readers, one per option ────────────────────────────────────────
123
+
124
+ type Read<T> = { value: T } | { problem: string };
125
+
126
+ /** A numeric literal is never negative (`-1` is a unary expression), so finite is enough. */
127
+ function readNonNegativeNumber(node: Node, label: string): Read<number> {
128
+ const value = literal(node);
129
+ if (typeof value === 'number' && Number.isFinite(value)) return { value };
130
+ return { problem: `${label} must be a non-negative number literal.` };
131
+ }
132
+
133
+ function readPrerender(node: Node): Read<RoutePrerender> {
134
+ const value = literal(node);
135
+ if (typeof value === 'boolean') return { value };
136
+ const n = unwrap(node);
137
+ if (n.type !== 'ObjectExpression') {
138
+ return {
139
+ problem: 'prerender must be `true`, `false`, or an object literal `{ ttl?, tags? }`.',
140
+ };
141
+ }
142
+ const result: { ttl?: number; tags?: string[] } = {};
143
+ for (const entry of readProperties(n, 'prerender')) {
144
+ if ('problem' in entry) return entry;
145
+ if (entry.key === 'ttl') {
146
+ const ttl = readNonNegativeNumber(entry.value, 'prerender.ttl');
147
+ if ('problem' in ttl) return ttl;
148
+ result.ttl = ttl.value;
149
+ } else if (entry.key === 'tags') {
150
+ const tags = readStringArray(entry.value);
151
+ if (!tags) return { problem: 'prerender.tags must be an array of string literals.' };
152
+ result.tags = tags;
153
+ } else {
154
+ return { problem: `Unknown key "${entry.key}" in prerender. Allowed: ttl, tags.` };
155
+ }
156
+ }
157
+ return { value: result };
158
+ }
159
+
160
+ function readStringArray(node: Node): string[] | undefined {
161
+ const n = unwrap(node);
162
+ if (n.type !== 'ArrayExpression') return undefined;
163
+ const result: string[] = [];
164
+ for (const element of list(n, 'elements')) {
165
+ const value = isNode(element) ? literal(element) : undefined;
166
+ if (typeof value !== 'string') return undefined;
167
+ result.push(value);
168
+ }
169
+ return result;
170
+ }
171
+
172
+ /**
173
+ * One reader per option key. Typed against the public option types, so an
174
+ * option added to `PageOptions` / `LayoutOptions` without a reader here (or a
175
+ * reader without the option) fails typecheck — the two lists cannot drift.
176
+ */
177
+ type Readers<T> = {
178
+ [K in keyof Required<T>]: (
179
+ node: Node
180
+ ) => Read<NonNullable<T[K]> extends SegmentKey ? BuildTimeKey : NonNullable<T[K]>>;
181
+ };
182
+
183
+ const deferSuspenseFor = (node: Node) => readNonNegativeNumber(node, 'deferSuspenseFor');
184
+
185
+ const LIFETIMES: readonly SegmentLifetime[] = ['request', 'document'];
186
+
187
+ function readLifetime(node: Node): Read<SegmentLifetime> {
188
+ const value = literal(node);
189
+ const lifetime = LIFETIMES.find((l) => l === value);
190
+ if (lifetime) return { value: lifetime };
191
+ return { problem: "lifetime must be 'request' or 'document'." };
192
+ }
193
+
194
+ /**
195
+ * What the build can read of a segment key: the param and header names. `searchParams`
196
+ * and `cookies` name definitions — code the build cannot evaluate — so only
197
+ * their shape is checked here; their values take effect from the loaded
198
+ * module (`server/segment-lifetime/`). The route-options lint checks the
199
+ * param names against the segment's path.
200
+ */
201
+ type BuildTimeKey = Pick<SegmentKey, 'segmentParams' | 'headers'>;
202
+
203
+ function readHeaderNames(node: Node): Read<string[]> {
204
+ const names = readStringArray(node);
205
+ if (!names) return { problem: 'key.headers must be an array of header-name string literals.' };
206
+ for (const name of names) {
207
+ const problem = headerKeyProblem(name);
208
+ if (problem) return { problem };
209
+ }
210
+ return { value: names };
211
+ }
212
+
213
+ /** A value written in place, which cannot be a definition imported or declared elsewhere. */
214
+ function isInlineValue(node: Node): boolean {
215
+ const type = unwrap(node).type;
216
+ return (
217
+ literal(node) !== undefined ||
218
+ type === 'ObjectExpression' ||
219
+ type === 'ArrayExpression' ||
220
+ type === 'Literal' ||
221
+ type === 'TemplateLiteral'
222
+ );
223
+ }
224
+
225
+ function readKey(node: Node): Read<BuildTimeKey> {
226
+ const n = unwrap(node);
227
+ if (n.type !== 'ObjectExpression') {
228
+ return {
229
+ problem:
230
+ 'key must be an object literal `{ segmentParams?, searchParams?, cookies?, headers? }`.',
231
+ };
232
+ }
233
+ const result: BuildTimeKey = {};
234
+ for (const entry of readProperties(n, 'key')) {
235
+ if ('problem' in entry) return entry;
236
+ if (entry.key === 'segmentParams') {
237
+ const names = readStringArray(entry.value);
238
+ if (!names) return { problem: 'key.segmentParams must be an array of string literals.' };
239
+ result.segmentParams = names;
240
+ } else if (entry.key === 'searchParams') {
241
+ if (isInlineValue(entry.value)) {
242
+ return {
243
+ problem:
244
+ 'key.searchParams must name a search-params definition (`defineSearchParams`, or a `.pick()` of one).',
245
+ };
246
+ }
247
+ } else if (entry.key === 'cookies') {
248
+ const array = unwrap(entry.value);
249
+ const elements = list(array, 'elements');
250
+ const definitions = elements.every(
251
+ (e) => isNode(e) && e.type !== 'SpreadElement' && !isInlineValue(e)
252
+ );
253
+ if (array.type !== 'ArrayExpression' || !definitions) {
254
+ return {
255
+ problem: 'key.cookies must be an array literal of cookie definitions (`defineCookie`).',
256
+ };
257
+ }
258
+ } else if (entry.key === 'headers') {
259
+ const headers = readHeaderNames(entry.value);
260
+ if ('problem' in headers) return headers;
261
+ result.headers = headers.value;
262
+ } else {
263
+ return {
264
+ problem: `Unknown key "${entry.key}" in key. Allowed: segmentParams, searchParams, cookies, headers.`,
265
+ };
266
+ }
267
+ }
268
+ return { value: result };
269
+ }
270
+
271
+ const READERS = {
272
+ layout: {
273
+ lifetime: readLifetime,
274
+ key: readKey,
275
+ prerender: readPrerender,
276
+ deferSuspenseFor,
277
+ } satisfies Readers<LayoutOptions>,
278
+ page: {
279
+ lifetime: readLifetime,
280
+ key: readKey,
281
+ prerender: readPrerender,
282
+ deferSuspenseFor,
283
+ } satisfies Readers<PageOptions>,
284
+ };
285
+
286
+ // ─── Object literal ───────────────────────────────────────────────────────
287
+
288
+ type Entry = { key: string; value: Node } | { problem: string };
289
+
290
+ /**
291
+ * The `key: value` entries of an object literal, or a problem per entry that
292
+ * has none. `key: undefined` entries are dropped: they mean "not set".
293
+ */
294
+ function readProperties(object: Node, label: string): Entry[] {
295
+ return list(object, 'properties').flatMap((prop): Entry[] => {
296
+ if (!isNode(prop) || prop.type === 'SpreadElement') {
297
+ return [{ problem: `${label} cannot use a spread; write every key in the literal.` }];
298
+ }
299
+ if (prop.computed === true) {
300
+ return [{ problem: `${label} cannot use a computed key; write the key name.` }];
301
+ }
302
+ const value = child(prop, 'value');
303
+ const key = nameOf(child(prop, 'key'));
304
+ if (prop.kind !== 'init' || prop.method === true || !value || key === undefined) {
305
+ return [{ problem: `${label} entries must be plain \`key: value\` pairs.` }];
306
+ }
307
+ return isUndefined(value) ? [] : [{ key, value }];
308
+ });
309
+ }
310
+
311
+ function readOptionsObject(init: Node, kind: RouteOptionsKind, problems: string[]) {
312
+ const name = ROUTE_OPTIONS_EXPORT[kind];
313
+ const object = unwrap(init);
314
+ if (object.type !== 'ObjectExpression') {
315
+ problems.push(`${name} must be an object literal: \`export const ${name} = { … }\`.`);
316
+ return undefined;
317
+ }
318
+ const readers: Record<string, (node: Node) => Read<unknown>> = READERS[kind];
319
+ const options: Record<string, unknown> = {};
320
+ for (const entry of readProperties(object, name)) {
321
+ if ('problem' in entry) {
322
+ problems.push(entry.problem);
323
+ continue;
324
+ }
325
+ const reader = Object.hasOwn(readers, entry.key) ? readers[entry.key] : undefined;
326
+ if (!reader) {
327
+ problems.push(
328
+ `Unknown key "${entry.key}" in ${name}. Allowed: ${Object.keys(readers).join(', ')}.`
329
+ );
330
+ continue;
331
+ }
332
+ const read = reader(entry.value);
333
+ if ('problem' in read) problems.push(read.problem);
334
+ else options[entry.key] = read.value;
335
+ }
336
+ return options;
337
+ }
338
+
339
+ // ─── File ─────────────────────────────────────────────────────────────────
340
+
341
+ const NONE: RouteOptionsRead = Object.freeze({ options: undefined, problems: [] });
342
+
343
+ /** Every name the reader reacts to; a file containing none of them is not parsed. */
344
+ const MENTIONS = /Options|prerender|deferSuspenseFor/;
345
+
346
+ /**
347
+ * Read a layout's `layoutOptions` or a page's `pageOptions` from source.
348
+ *
349
+ * A missing or unparseable file reads as no options and no problems: the
350
+ * compiler reports syntax errors, and guessing at a half-written file would
351
+ * misreport it. `.ts` files are parsed as TypeScript, not TSX, so an
352
+ * angle-bracket cast does not hide a file from this check.
353
+ */
354
+ export function readRouteOptions(filePath: string, kind: RouteOptionsKind): RouteOptionsRead {
355
+ if (!existsSync(filePath)) return NONE;
356
+ const source = readFileCached(filePath);
357
+ // Runs on every page and layout on each rescan; most declare nothing.
358
+ if (!MENTIONS.test(source)) return NONE;
359
+ const program = tryParse(source, /\.[mc]?ts$/.test(filePath) ? 'ts' : 'tsx');
360
+ if (!program) return NONE;
361
+
362
+ const own = ROUTE_OPTIONS_EXPORT[kind];
363
+ const otherKind: RouteOptionsKind = kind === 'page' ? 'layout' : 'page';
364
+ const other = ROUTE_OPTIONS_EXPORT[otherKind];
365
+ const problems: string[] = [];
366
+ let init: Node | undefined;
367
+
368
+ /** An export of a watched name in a form the build cannot read. */
369
+ const report = (name: string | undefined) => {
370
+ if (name === own) {
371
+ problems.push(
372
+ `${own} must be declared in this file as \`export const ${own} = { … } satisfies ${OPTIONS_TYPE[kind]}\`. ` +
373
+ '`let`, destructuring, `export { … }` and re-exports cannot be read at build time.'
374
+ );
375
+ } else if (name === other) {
376
+ problems.push(
377
+ `${other} configures a ${otherKind}; this file is a ${kind}. Use \`export const ${own}\`.`
378
+ );
379
+ } else if (name && (REMOVED_EXPORTS as readonly string[]).includes(name)) {
380
+ problems.push(
381
+ `\`export const ${name}\` was removed. Move it into the options object: ` +
382
+ `\`export const ${own} = { ${name}: … } satisfies ${OPTIONS_TYPE[kind]}\`.`
383
+ );
384
+ }
385
+ };
386
+ const watched = [own, other, ...REMOVED_EXPORTS];
387
+
388
+ for (const stmt of program.body) {
389
+ if (!isNode(stmt) || stmt.exportKind === 'type') continue;
390
+ // `export * as pageOptions from` names an export; bare `export * from` does not.
391
+ if (stmt.type === 'ExportAllDeclaration') report(nameOf(child(stmt, 'exported')));
392
+ if (stmt.type !== 'ExportNamedDeclaration') continue;
393
+ for (const spec of list(stmt, 'specifiers')) {
394
+ if (isNode(spec) && spec.exportKind !== 'type') report(nameOf(child(spec, 'exported')));
395
+ }
396
+ const decl = child(stmt, 'declaration');
397
+ if (!decl) continue;
398
+ if (decl.type !== 'VariableDeclaration') {
399
+ report(nameOf(child(decl, 'id'))); // function or class
400
+ continue;
401
+ }
402
+ for (const declarator of list(decl, 'declarations')) {
403
+ if (!isNode(declarator)) continue;
404
+ const id = child(declarator, 'id');
405
+ const value = child(declarator, 'init');
406
+ if (id?.type !== 'Identifier') {
407
+ for (const name of watched) if (patternBinds(id, name)) report(name);
408
+ } else if (id.name === own && decl.kind === 'const' && value) {
409
+ init = value;
410
+ } else {
411
+ report(nameOf(id));
412
+ }
413
+ }
414
+ }
415
+
416
+ if (init && isClientModule(program.body)) {
417
+ problems.push(
418
+ `A 'use client' ${kind} cannot declare ${own}: the server sees a client reference, ` +
419
+ `not the object. Move ${own} to a server ${kind} that renders the client component.`
420
+ );
421
+ }
422
+ const options = init ? readOptionsObject(init, kind, problems) : undefined;
423
+ return { options: problems.length === 0 ? options : undefined, problems };
424
+ }
425
+
426
+ /** Whether the module starts with a 'use client' directive. */
427
+ function isClientModule(body: readonly unknown[]): boolean {
428
+ for (const stmt of body) {
429
+ if (
430
+ !isNode(stmt) ||
431
+ stmt.type !== 'ExpressionStatement' ||
432
+ typeof stmt.directive !== 'string'
433
+ ) {
434
+ return false;
435
+ }
436
+ if (stmt.directive === 'use client') return true;
437
+ }
438
+ return false;
439
+ }
@@ -369,7 +369,7 @@ function scanChildren(dirPath: string, parentNode: SegmentNode, extSet: Set<stri
369
369
  // `@children` is the implicit slot a layout's `children` prop fills, and
370
370
  // the key of the outlet that carries it (`childrenOutletKey`). A slot
371
371
  // directory by that name would claim the same outlet and be rendered in
372
- // place of the children (design/52-segment-hash-dedupe.md).
372
+ // place of the children.
373
373
  if (entry === '@children') {
374
374
  throw new Error(
375
375
  `Build error: "@children" is reserved and cannot be a slot directory.\n` +
@@ -150,11 +150,60 @@ export function computeSlotKey(parentSegmentId: string, slotName: string): strin
150
150
  * The outlet key of a layout's `children`. A layout's own outlet covers its
151
151
  * chrome; everything it receives as `children` — this segment's boundaries
152
152
  * and metadata collectors, the next segment's access gate, the page — is a
153
- * separate outlet, so an unchanged layout
154
- * dedupes while what is under it changes. Keyed as the implicit `children`
155
- * slot; the route scanner rejects an `@children` directory.
156
- * See design/52-segment-hash-dedupe.md §"The unit is the segment's own output".
153
+ * separate outlet, so a skipped 'document' layout never freezes what is under
154
+ * it. Keyed as the implicit `children` slot; the route scanner rejects an
155
+ * `@children` directory. See design/53-segment-lifetime.md §"Skipping".
157
156
  */
158
157
  export function childrenOutletKey(segmentId: string): string {
159
158
  return computeSlotKey(segmentId, '@children');
160
159
  }
160
+
161
+ /**
162
+ * The outlet keys of `'document'` segments (design/53-segment-lifetime.md
163
+ * §"Skipping"), by the segment's **tree path** — its directory path, route
164
+ * groups and `@slot` directories included. A `'document'` skip is
165
+ * identity-addressed (the client renders what it holds at this key, under a
166
+ * digest bound to it), so the key must name one segment. Segment ids
167
+ * (`computeSegmentKeys`) do not: `(landing)/feed` and `(browse)/feed` both
168
+ * key as `/feed`, which a content-addressed hash skip survives and a digest
169
+ * skip would not.
170
+ *
171
+ * `#` starts a URL fragment, so no routable segment is named with it — the
172
+ * same reason the metadata outlet is `#metadata`. A `'document'` layout's
173
+ * `children` outlet is `childrenOutletKey` of its layout key in a slot; on the
174
+ * main chain it keeps `childrenOutletKey(segmentId)`.
175
+ */
176
+ export function pageOutletKey(treePath: string): string {
177
+ return `${treePath === '/' ? '' : treePath}/#page`;
178
+ }
179
+
180
+ /** See `pageOutletKey`. */
181
+ export function layoutOutletKey(treePath: string): string {
182
+ return `${treePath === '/' ? '' : treePath}/#layout`;
183
+ }
184
+
185
+ /**
186
+ * The full tree path of a slot's matched chain (or a prefix of it) — the key
187
+ * the ALS slot params map, the generated `getSegmentParams` overloads and a
188
+ * slot's `'document'` outlets all use.
189
+ *
190
+ * Built from the parent's tree path plus each chain node's directory name,
191
+ * so an intercepting node contributes its marker
192
+ * (`/gallery/@modal/(.)photo/[id]`) and a route group contributes its
193
+ * parentheses.
194
+ *
195
+ * One definition for the render path, the eager access path and the outlet
196
+ * keys: they key the same things, and a divergence would silently strand one
197
+ * of them.
198
+ */
199
+ export function slotChainTreePath(
200
+ chain: ReadonlyArray<{ segmentName?: string }>,
201
+ parentTreePath: string
202
+ ): string {
203
+ const slotSuffix = chain
204
+ .map((s) => s.segmentName)
205
+ .filter(Boolean)
206
+ .join('/');
207
+ const prefix = parentTreePath === '/' ? '' : parentTreePath;
208
+ return `${prefix}/${slotSuffix}`;
209
+ }
@@ -24,6 +24,7 @@ declare module '@vitejs/plugin-rsc/vendor/react-server-dom/server.node' {
24
24
  onError?: (error: unknown) => string | void;
25
25
  identifierPrefix?: string;
26
26
  temporaryReferences?: unknown;
27
+ filterStackFrame?: (url: string, functionName: string) => boolean;
27
28
  debugChannel?: import('node:stream').Readable | import('node:stream').Writable;
28
29
  }
29
30
  ): { pipe<T extends NodeJS.WritableStream>(destination: T): T; abort(reason?: unknown): void };
@@ -52,6 +53,9 @@ declare module '@vitejs/plugin-rsc/vendor/react-server-dom/server.edge' {
52
53
  signal?: AbortSignal;
53
54
  onError?: (error: unknown) => string | void;
54
55
  onPostpone?: (reason: string) => void;
56
+ temporaryReferences?: unknown;
57
+ identifierPrefix?: string;
58
+ filterStackFrame?: (url: string, functionName: string) => boolean;
55
59
  }
56
60
  ): ReadableStream<Uint8Array>;
57
61
 
@@ -71,7 +75,7 @@ declare module '@vitejs/plugin-rsc/vendor/react-server-dom/server.edge' {
71
75
  exportName: string | null
72
76
  ): T;
73
77
 
74
- // Tests render real client references (segment-hash tests) the way the
78
+ // Tests render real client references the way the
75
79
  // use-client transform registers them.
76
80
  export function registerClientReference<T>(
77
81
  proxyImplementation: T,
@@ -676,7 +676,7 @@ function buildDefinition<T extends Record<string, unknown>>(
676
676
  'Use searchParams.useQueryStates() on the client.'
677
677
  );
678
678
  }
679
- const raw = getSearchParamsFromAls();
679
+ const raw = getSearchParamsFromAls({ codecs: codecMap, urlKeys });
680
680
  return parseSync(raw);
681
681
  }
682
682
 
@@ -340,25 +340,33 @@ export const prebuiltCaptureAls = getOrCreateAls<PrebuiltCaptureStore>(
340
340
  Symbol.for('timber:prebuilt-capture-als')
341
341
  );
342
342
 
343
- // ─── Segment Hash Capture ─────────────────────────────────────────────────
344
- // Used by: segment-hash/capture.ts, segment-hash/outlet.ts
345
-
346
- /**
347
- * One in-flight segment-hash capture render (design/52 §"Capture"). The
348
- * outlet gate renders a nested segment as a bare hole there — its content
349
- * belongs to its own hash.
350
- *
351
- * @internal — import via segment-hash/capture.ts
352
- */
353
- export interface SegmentCaptureStore {
343
+ // ─── 'document' segment read scope ────────────────────────────────────────
344
+ // Used by: segment-lifetime/read-scope.ts (set), request-context.ts and
345
+ // cookie-context.ts (checked by every request-input accessor).
346
+ // Design doc: design/53-segment-lifetime.md §"What a 'document' segment may read"
347
+
348
+ /** The request inputs a `'document'` segment's render may read: its key. */
349
+ export interface DocumentReadScope {
350
+ /** The segment's outlet path, for error messages. */
351
+ segmentPath: string;
352
+ /** Segment param names in the key. */
353
+ params: ReadonlySet<string>;
354
+ /**
355
+ * The fields of the key's search-params definition, each with the codec and
356
+ * URL key it is read through — a field of another definition matches only
357
+ * when both are the same.
358
+ */
359
+ searchParams: ReadonlyMap<string, { codec: unknown; urlKey: string }>;
354
360
  /**
355
- * A nested outlet rendered here, as a hole: the opaque marker it carries in
356
- * place of its decision (a Flight temporary reference).
361
+ * The key's cookies, by name, with the codec of the definition the key
362
+ * holds: a keyed cookie may be read only through that definition.
357
363
  */
358
- hole(segmentPath: string): import('../shared/outlet-decision.ts').CaptureHole;
364
+ cookies: ReadonlyMap<string, unknown>;
365
+ /** The key's header names, lowercased. */
366
+ headers: ReadonlySet<string>;
359
367
  }
360
368
 
361
- /** @internal — import via segment-hash/capture.ts */
362
- export const segmentCaptureAls = getOrCreateAls<SegmentCaptureStore>(
363
- Symbol.for('timber:segment-capture-als')
369
+ /** @internal — run and read via segment-lifetime/read-scope.ts */
370
+ export const documentReadScopeAls = getOrCreateAls<DocumentReadScope>(
371
+ Symbol.for('timber:document-read-scope-als')
364
372
  );