@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
@@ -33,9 +33,14 @@ interface ProgramNode {
33
33
  body: AstNode[];
34
34
  }
35
35
 
36
- function tryParse(source: string): ProgramNode | null {
36
+ /**
37
+ * Parse a module. `lang` defaults to `tsx`; pass `ts` for `.ts` files, where
38
+ * an angle-bracket cast or a generic arrow (`<T>(x: T) => x`) is valid
39
+ * TypeScript but a TSX parse error.
40
+ */
41
+ export function tryParse(source: string, lang: 'ts' | 'tsx' = 'tsx'): ProgramNode | null {
37
42
  try {
38
- return parseAst(source, { lang: 'tsx' }) as unknown as ProgramNode;
43
+ return parseAst(source, { lang }) as unknown as ProgramNode;
39
44
  } catch {
40
45
  return null;
41
46
  }
@@ -193,7 +198,7 @@ const FUNCTION_LIKE = new Set([
193
198
  * Expression wrappers that erase at runtime and so cannot change where a value
194
199
  * was constructed: `X as T`, `X satisfies T`, `<T>X`, `X!`, `X<T>`, `(X)`.
195
200
  */
196
- const TRANSPARENT_WRAPPERS = new Set([
201
+ export const TRANSPARENT_WRAPPERS: ReadonlySet<string> = new Set([
197
202
  'TSAsExpression',
198
203
  'TSSatisfiesExpression',
199
204
  'TSTypeAssertion',
@@ -312,119 +317,6 @@ export function fileHasStarExport(filePath: string): boolean {
312
317
  }
313
318
  }
314
319
 
315
- /**
316
- * Parsed value of `export const prerender` from a route file.
317
- *
318
- * - `true` / `false` — literal boolean
319
- * - `{ ttl?, tags? }` — ISR options object (prerender: true is implied)
320
- * - `undefined` — no `export const prerender` found
321
- *
322
- * See design/45-cache-lifetimes.md §"Route-Level Static".
323
- */
324
- export type PrerenderExportValue = boolean | { ttl?: number; tags?: string[] };
325
-
326
- function extractLiteralValue(node: AstNode): unknown {
327
- if (!node) return undefined;
328
- const n = node as any;
329
- if (n.type === 'Literal') return n.value;
330
- if (n.type === 'UnaryExpression' && n.operator === '-' && n.argument?.type === 'Literal') {
331
- return -(n.argument.value as number);
332
- }
333
- if (n.type === 'ArrayExpression') {
334
- const elements = n.elements as AstNode[] | undefined;
335
- if (!elements) return undefined;
336
- const result: unknown[] = [];
337
- for (const el of elements) {
338
- const v = extractLiteralValue(el);
339
- if (v === undefined) return undefined;
340
- result.push(v);
341
- }
342
- return result;
343
- }
344
- return undefined;
345
- }
346
-
347
- function extractObjectLiteral(node: AstNode): Record<string, unknown> | undefined {
348
- if ((node as any).type !== 'ObjectExpression') return undefined;
349
- const props = (node as any).properties as AstNode[] | undefined;
350
- if (!props) return undefined;
351
- const result: Record<string, unknown> = {};
352
- for (const prop of props) {
353
- const p = prop as any;
354
- if (p.type === 'SpreadElement') return undefined;
355
- if (p.type !== 'Property' || p.computed) return undefined;
356
- const key =
357
- p.key?.type === 'Identifier'
358
- ? p.key.name
359
- : p.key?.type === 'Literal'
360
- ? String(p.key.value)
361
- : undefined;
362
- if (!key) return undefined;
363
- const value = extractLiteralValue(p.value);
364
- if (value === undefined) return undefined;
365
- result[key] = value;
366
- }
367
- return result;
368
- }
369
-
370
- /**
371
- * Extract the value of `export const prerender` from a file.
372
- * Returns undefined if the file doesn't export `prerender` or can't be parsed.
373
- *
374
- * Supports:
375
- * export const prerender = true;
376
- * export const prerender = false;
377
- * export const prerender = { ttl: 3600, tags: ['docs'] };
378
- */
379
- export function getPrerenderExport(filePath: string): PrerenderExportValue | undefined {
380
- if (!existsSync(filePath)) return undefined;
381
- try {
382
- const source = readFileCached(filePath);
383
- const program = tryParse(source);
384
- if (!program) return undefined;
385
-
386
- for (const stmt of program.body) {
387
- if (stmt.type !== 'ExportNamedDeclaration') continue;
388
- if (stmt.exportKind === 'type') continue;
389
- if (!stmt.declaration) continue;
390
- const decl = stmt.declaration;
391
- if (decl.type !== 'VariableDeclaration') continue;
392
- const declarations = decl.declarations as
393
- | Array<{
394
- id?: { name?: string };
395
- init?: AstNode;
396
- }>
397
- | undefined;
398
- if (!declarations) continue;
399
- for (const d of declarations) {
400
- if (d.id?.name !== 'prerender' || !d.init) continue;
401
- const init = d.init as any;
402
- if (init.type === 'Literal' && typeof init.value === 'boolean') {
403
- return init.value;
404
- }
405
- if (init.type === 'ObjectExpression') {
406
- const obj = extractObjectLiteral(init);
407
- if (!obj) return undefined;
408
- const result: { ttl?: number; tags?: string[] } = {};
409
- if ('ttl' in obj && typeof obj.ttl === 'number') result.ttl = obj.ttl;
410
- if (
411
- 'tags' in obj &&
412
- Array.isArray(obj.tags) &&
413
- obj.tags.every((t: unknown) => typeof t === 'string')
414
- ) {
415
- result.tags = obj.tags as string[];
416
- }
417
- return result;
418
- }
419
- return undefined;
420
- }
421
- }
422
- return undefined;
423
- } catch {
424
- return undefined;
425
- }
426
- }
427
-
428
320
  /**
429
321
  * How a file declares the per-route CSRF exemption.
430
322
  *
@@ -491,7 +383,7 @@ function specifierName(node: { name?: string; value?: unknown } | undefined): st
491
383
  }
492
384
 
493
385
  /** Whether a destructuring pattern binds `name` anywhere inside it. */
494
- function patternBinds(node: unknown, name: string): boolean {
386
+ export function patternBinds(node: unknown, name: string): boolean {
495
387
  if (!node || typeof node !== 'object') return false;
496
388
  const n = node as Record<string, unknown>;
497
389
  switch (n.type) {
@@ -534,3 +426,8 @@ export function fileHasDirective(filePath: string, directive: string): boolean {
534
426
  return false;
535
427
  }
536
428
  }
429
+
430
+ /** Route files the AST checks can read; `.mdx` and `.json` are skipped. */
431
+ export function isScriptExtension(ext: string): boolean {
432
+ return ext === 'tsx' || ext === 'ts' || ext === 'jsx' || ext === 'js';
433
+ }
@@ -0,0 +1,153 @@
1
+ /**
2
+ * Convention-lint check for route-module options (design/53 §"Route-module
3
+ * options"): `layoutOptions` / `pageOptions` the build cannot read, and
4
+ * options declared where nothing reads them. Called from
5
+ * `lintConventions` in `convention-lint.ts`.
6
+ */
7
+
8
+ import type { ConventionWarning } from './convention-lint.ts';
9
+ import { fileHasAnyExport, isScriptExtension } from './export-detect.ts';
10
+ import { readRouteOptions } from './route-options.ts';
11
+ import type { RouteFile, SegmentNode } from './types.ts';
12
+ import type { LayoutOptions, PageOptions, SegmentLifetime } from '../server/types.ts';
13
+ import { ROUTE_OPTIONS_EXPORT, type RouteOptionsKind } from '../shared/route-options-export.ts';
14
+
15
+ /**
16
+ * Fail the build on a `layoutOptions` / `pageOptions` the build cannot read.
17
+ *
18
+ * Proven from source and fatal in the sense the error level requires: the
19
+ * developer declared an option that would otherwise silently do nothing — a
20
+ * misspelled key, a value the build cannot read, an options object in the
21
+ * wrong file kind, or a floating `export const prerender` that no longer
22
+ * prerenders. See `routing/route-options.ts` for what is accepted.
23
+ */
24
+ export function checkRouteOptions(
25
+ node: SegmentNode,
26
+ warnings: ConventionWarning[],
27
+ position: RoutePosition,
28
+ /** The app's `defaultLayoutLifetime` (design/53 §"App-wide default"). */
29
+ defaultLayoutLifetime: SegmentLifetime,
30
+ /** The params named on the path above this segment. */
31
+ ancestorParams: readonly string[] = []
32
+ ): void {
33
+ const here: RoutePosition = node.segmentType === 'intercepting' ? 'intercepting' : position;
34
+ const pathParams = node.paramName ? [...ancestorParams, node.paramName] : ancestorParams;
35
+ const files: Array<[RouteOptionsKind, RouteFile | undefined]> = [
36
+ ['layout', node.layout],
37
+ ['page', node.page],
38
+ ];
39
+ for (const [kind, file] of files) {
40
+ if (!file || !isScriptExtension(file.extension)) continue;
41
+ const { options, problems } = readRouteOptions(file.filePath, kind);
42
+ problems.push(
43
+ ...inertOptions(options, here),
44
+ ...paramsOffPath(options, pathParams),
45
+ ...keyWithoutDocument(options, kind === 'layout' ? defaultLayoutLifetime : 'request')
46
+ );
47
+ if (problems.length === 0) continue;
48
+ warnings.push({
49
+ id: `ROUTE_OPTIONS_INVALID:${file.filePath}`,
50
+ summary: `${kind}.${file.extension} has invalid ${ROUTE_OPTIONS_EXPORT[kind]}: ${file.filePath}`,
51
+ details:
52
+ ` File: ${file.filePath}\n\n` +
53
+ problems.map((problem) => ` - ${problem}\n`).join('') +
54
+ '\n Options are read from source at build time, so they must be one object\n' +
55
+ ' literal of literal values.\n',
56
+ level: 'error',
57
+ });
58
+ }
59
+ if (node.default && isScriptExtension(node.default.extension)) {
60
+ const declared = fileHasAnyExport(node.default.filePath, OPTION_EXPORT_NAMES);
61
+ if (declared.size > 0) {
62
+ warnings.push({
63
+ id: `ROUTE_OPTIONS_INVALID:${node.default.filePath}`,
64
+ summary: `default.${node.default.extension} takes no route options: ${node.default.filePath}`,
65
+ details:
66
+ ` File: ${node.default.filePath}\n\n` +
67
+ ` default.tsx exports ${[...declared].join(', ')}, which nothing reads.\n` +
68
+ ' To fix: remove the export; declare options on the slot page or layout.\n',
69
+ level: 'error',
70
+ });
71
+ }
72
+ }
73
+ for (const child of node.children) {
74
+ checkRouteOptions(child, warnings, here, defaultLayoutLifetime, pathParams);
75
+ }
76
+ for (const slot of Object.values(node.slots)) {
77
+ const slotPosition = here === 'intercepting' ? here : 'slot';
78
+ checkRouteOptions(slot, warnings, slotPosition, defaultLayoutLifetime, pathParams);
79
+ }
80
+ }
81
+
82
+ /**
83
+ * A `key` applies only to a `'document'` segment; on any other it would
84
+ * silently do nothing. A layout that declares no lifetime takes the app's
85
+ * `defaultLayoutLifetime`, so under a `'document'` default it may declare a
86
+ * key alone. A page always defaults to `'request'`.
87
+ */
88
+ function keyWithoutDocument(
89
+ options: LayoutOptions | PageOptions | undefined,
90
+ defaultLifetime: SegmentLifetime
91
+ ): string[] {
92
+ if (options?.key === undefined || (options.lifetime ?? defaultLifetime) === 'document') return [];
93
+ return [
94
+ "key applies only to lifetime: 'document'. Declare `lifetime: 'document'` or remove key.",
95
+ ];
96
+ }
97
+
98
+ /**
99
+ * A key's `segmentParams` must name params on the segment's path — the
100
+ * segment's own and every ancestor's, slots included. Anything else could
101
+ * never change, so the key would silently ignore what the author meant
102
+ * (design/53 §"Segment keys").
103
+ */
104
+ function paramsOffPath(
105
+ options: LayoutOptions | PageOptions | undefined,
106
+ pathParams: readonly string[]
107
+ ): string[] {
108
+ const declared = options?.key?.segmentParams ?? [];
109
+ return declared
110
+ .filter((name) => !pathParams.includes(name))
111
+ .map(
112
+ (name) =>
113
+ `key.segmentParams names "${name}", which is not a param on this segment's path. ` +
114
+ (pathParams.length > 0
115
+ ? `Params on the path: ${pathParams.join(', ')}.`
116
+ : 'This path has no params.')
117
+ );
118
+ }
119
+
120
+ /**
121
+ * Where a segment sits decides which options take effect there.
122
+ * - `main`: the matched route chain. Every option applies.
123
+ * - `slot`: a parallel slot. `prerender` applies to slot pages (the sugar
124
+ * walks slots); `deferSuspenseFor` does not — the hold is read from the
125
+ * main chain's modules only (`server/route-module-loader.ts`).
126
+ * - `intercepting`: an intercepting route and everything under it. It renders
127
+ * only on a soft navigation, through the slot resolver, and the sugar skips
128
+ * it, so no option applies.
129
+ */
130
+ type RoutePosition = 'main' | 'slot' | 'intercepting';
131
+
132
+ const OPTION_EXPORT_NAMES = [
133
+ ...Object.values(ROUTE_OPTIONS_EXPORT),
134
+ 'prerender',
135
+ 'deferSuspenseFor',
136
+ ] as const;
137
+
138
+ function inertOptions(
139
+ options: LayoutOptions | PageOptions | undefined,
140
+ position: RoutePosition
141
+ ): string[] {
142
+ if (!options || position === 'main') return [];
143
+ const inert = Object.keys(options).filter(
144
+ (key) => position === 'intercepting' || key === 'deferSuspenseFor'
145
+ );
146
+ return inert.map((key) =>
147
+ position === 'intercepting'
148
+ ? `${key} has no effect on an intercepting route: it renders only on a soft navigation, ` +
149
+ 'through the slot that intercepts it. Declare it on the route being intercepted.'
150
+ : `${key} has no effect in a parallel slot: the hold is read from the main route's ` +
151
+ 'layouts and page. Declare it there.'
152
+ );
153
+ }