@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 @@
1
+ {"version":3,"file":"framework-stack-frames.js","names":[],"sources":["../../../../src/server/framework-stack-frames.ts"],"mappings":";AAoBA,SAAS,cAAc,WAA8C;CACnE,IAAI,CAAC,WAAW,OAAO;CACvB,MAAM,OAAO,gBAAgB,SAAS;CACtC,MAAM,KAAK,KAAK,IAAI,KAAK,YAAY,OAAO,GAAG,KAAK,YAAY,QAAQ,CAAC;CACzE,OAAO,KAAK,IAAI,KAAK,MAAM,GAAG,KAAK,CAAC,IAAI;AAC1C;AAEA,SAAS,gBAAgB,KAAqB;CAC5C,OAAO,IAAI,WAAW,SAAS,IAAI,UAAU,IAAI,MAAM,CAAgB,CAAC,IAAI;AAC9E;AAEA,IAAM,iBAAiB,cAAc,YAAY,GAAG;AAMpD,SAAgB,gBAAgB,KAAsB;CACpD,IAAI,QAAQ,MAAM,IAAI,WAAW,OAAO,KAAK,IAAI,SAAS,cAAc,GAAG,OAAO;CAClF,OAAO,mBAAmB,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC,WAAW,cAAc;AACnF"}
@@ -4,18 +4,22 @@ import { appVisibleSearch } from "../shared/rsc-cache-key.js";
4
4
  import { resolveSegmentParams } from "../shared/slot-params.js";
5
5
  import { isDebug } from "./debug.js";
6
6
  import { runWithReactCacheScope } from "./react-cache-scope.js";
7
+ import { assertSearchParamsRead, assertUnscopedRead, currentReadScope, keyedHeaders, scopedParams } from "./segment-lifetime/read-rule.js";
7
8
  // src/server/request-context.ts
8
9
  function getHeaders() {
9
10
  const store = requestContextAls.getStore();
10
11
  if (!store) throw new Error("[timber] getHeaders() called outside of a request context. It can only be used in middleware, access checks, server components, and server actions.");
11
- return store.headers;
12
+ const scope = currentReadScope();
13
+ return scope ? keyedHeaders(store.headers, scope) : store.headers;
12
14
  }
13
15
  function getHeader(name) {
14
16
  return getHeaders().get(name) ?? void 0;
15
17
  }
16
- function getSearchParams() {
18
+ function getSearchParams(reader) {
17
19
  const store = requestContextAls.getStore();
18
20
  if (!store) throw new Error("[timber] getSearchParams() called outside of a request context. It can only be used in middleware, access checks, server components, and server actions.");
21
+ if (reader) assertSearchParamsRead(reader);
22
+ else assertUnscopedRead("the raw search params");
19
23
  return store.searchParams;
20
24
  }
21
25
  _setGetSearchParamsFn(getSearchParams);
@@ -25,14 +29,14 @@ function getSegmentParams(segmentPath) {
25
29
  if (!store) throw new Error("[timber] getSegmentParams() called outside of a request context. It can only be used in middleware, access checks, server components, and server actions.");
26
30
  if (!store.segmentParams) throw new Error("[timber] getSegmentParams() called before route matching completed. Segment params are not available until after the route is matched.");
27
31
  const slotResolved = resolveSegmentParams(store.segmentParams, store.slotParams, segmentPath);
28
- if (slotResolved !== store.segmentParams) return slotResolved;
32
+ if (slotResolved !== store.segmentParams) return scopedParams(slotResolved);
29
33
  if (segmentPath && isDebug() && store.matchedSegmentPath) {
30
34
  const expected = extractDynamicSegments(segmentPath);
31
35
  const actual = extractDynamicSegments(store.matchedSegmentPath);
32
36
  const missing = expected.filter((s) => !actual.includes(s));
33
37
  if (missing.length > 0) console.warn(`[timber] getSegmentParams('${segmentPath}') called but current segment is '${store.matchedSegmentPath}'\n Missing params: ${missing.join(", ")}\n These will be undefined at runtime despite the type annotation.`);
34
38
  }
35
- return store.segmentParams;
39
+ return scopedParams(store.segmentParams);
36
40
  }
37
41
  function setSegmentParams(params) {
38
42
  const store = requestContextAls.getStore();
@@ -62,7 +66,9 @@ function extractDynamicSegments(route) {
62
66
  return segments;
63
67
  }
64
68
  function getRequestSearchString() {
65
- return requestContextAls.getStore()?.searchString ?? "";
69
+ const store = requestContextAls.getStore();
70
+ if (store) assertUnscopedRead("the raw search params");
71
+ return store?.searchString ?? "";
66
72
  }
67
73
  function runWithRequestContext(req, fn, { reactCacheScope, cookies, formState, actionError } = {}) {
68
74
  const originalCopy = new Headers(req.headers);
@@ -1 +1 @@
1
- {"version":3,"file":"request-context.js","names":[],"sources":["../../../../src/server/request-context.ts"],"mappings":"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"}
1
+ {"version":3,"file":"request-context.js","names":[],"sources":["../../../../src/server/request-context.ts"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { RSC_KEY_PARAM, isRscCacheKeyShape, rscCacheKey } from "../shared/rsc-cache-key.js";
1
+ import { RSC_KEY_PARAM, isRscCacheKeyShape, rscCacheKey, stateTreeHasDocuments } from "../shared/rsc-cache-key.js";
2
2
  import { isRscContentType } from "../shared/rsc-media-type.js";
3
3
  import { preventResponseCaching } from "./response-cache-policy.js";
4
4
  // src/server/rsc-cache-key-guard.ts
@@ -21,6 +21,10 @@ function hardenRscPayloadResponse(response) {
21
21
  response.headers.set("X-Content-Type-Options", "nosniff");
22
22
  }
23
23
  async function enforceRscCacheKey(req, response) {
24
+ if (stateTreeHasDocuments(req.headers.get("X-Timber-State-Tree"))) {
25
+ preventResponseCaching(response.headers);
26
+ return;
27
+ }
24
28
  if (await hasValidRscCacheKey(req)) return;
25
29
  preventResponseCaching(response.headers);
26
30
  }
@@ -1 +1 @@
1
- {"version":3,"file":"rsc-cache-key-guard.js","names":[],"sources":["../../../../src/server/rsc-cache-key-guard.ts"],"mappings":";;;;AA2CA,eAAsB,oBAAoB,KAAgC;CASxE,IAAI,CAAC,IAAI,IAAI,SAAS,GAAG,GAAG,OAAO;CACnC,IAAI;CACJ,IAAI;EACF,SAAS,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,aAAa,OAAO,aAAa;CAC7D,QAAQ;EAEN,OAAO;CACT;CAKA,MAAM,SAAS,OAAO,OAAO,kBAAkB;CAC/C,IAAI,OAAO,WAAW,GAAG,OAAO;CAChC,MAAM,WAAW,MAAM,aAAa,SAAS,IAAI,QAAQ,IAAI,IAAI,CAAC;CAIlE,IAAI,aAAa,MAAM,OAAO;CAI9B,OAAO,OAAO,OAAO,UAAU,UAAU,QAAQ;AACnD;AAiBA,SAAgB,yBAAyB,UAA0B;CACjE,IAAI,CAAC,iBAAiB,SAAS,QAAQ,IAAI,cAAc,CAAC,GAAG;CAC7D,SAAS,QAAQ,IAAI,0BAA0B,SAAS;AAC1D;AAuBA,eAAsB,mBAAmB,KAAc,UAAmC;CACxF,IAAI,MAAM,oBAAoB,GAAG,GAAG;CACpC,uBAAuB,SAAS,OAAO;AACzC"}
1
+ {"version":3,"file":"rsc-cache-key-guard.js","names":[],"sources":["../../../../src/server/rsc-cache-key-guard.ts"],"mappings":";;;;AAgDA,eAAsB,oBAAoB,KAAgC;CASxE,IAAI,CAAC,IAAI,IAAI,SAAS,GAAG,GAAG,OAAO;CACnC,IAAI;CACJ,IAAI;EACF,SAAS,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,aAAa,OAAO,aAAa;CAC7D,QAAQ;EAEN,OAAO;CACT;CAKA,MAAM,SAAS,OAAO,OAAO,kBAAkB;CAC/C,IAAI,OAAO,WAAW,GAAG,OAAO;CAChC,MAAM,WAAW,MAAM,aAAa,SAAS,IAAI,QAAQ,IAAI,IAAI,CAAC;CAIlE,IAAI,aAAa,MAAM,OAAO;CAI9B,OAAO,OAAO,OAAO,UAAU,UAAU,QAAQ;AACnD;AAiBA,SAAgB,yBAAyB,UAA0B;CACjE,IAAI,CAAC,iBAAiB,SAAS,QAAQ,IAAI,cAAc,CAAC,GAAG;CAC7D,SAAS,QAAQ,IAAI,0BAA0B,SAAS;AAC1D;AAyBA,eAAsB,mBAAmB,KAAc,UAAmC;CAKxF,IAAI,sBAAsB,IAAI,QAAQ,IAAI,qBAAqB,CAAC,GAAG;EACjE,uBAAuB,SAAS,OAAO;EACvC;CACF;CACA,IAAI,MAAM,oBAAoB,GAAG,GAAG;CACpC,uBAAuB,SAAS,OAAO;AACzC"}
@@ -0,0 +1,6 @@
1
+ // src/server/segment-lifetime/key-digest.ts
2
+ var PART_LENGTH = 22;
3
+ var KEY_DIGEST_SHAPE = new RegExp(`^[A-Za-z0-9_-]{${PART_LENGTH}}\\.[A-Za-z0-9_-]{${PART_LENGTH}}$`);
4
+ export { KEY_DIGEST_SHAPE };
5
+
6
+ //# sourceMappingURL=key-digest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"key-digest.js","names":[],"sources":["../../../../../src/server/segment-lifetime/key-digest.ts"],"mappings":";AAgCA,IAAM,cAAc;AAIpB,IAAa,mBAAmB,IAAI,OAClC,kBAAkB,YAAY,oBAAoB,YAAY,GAChE"}
@@ -0,0 +1,78 @@
1
+ import { documentReadScopeAls } from "../als-registry.js";
2
+ import { isUnkeyableHeader } from "../../shared/key-headers.js";
3
+ // src/server/segment-lifetime/read-rule.ts
4
+ function currentReadScope() {
5
+ return documentReadScopeAls.getStore();
6
+ }
7
+ function readOutsideKey(scope, what, part, fixOverride) {
8
+ const fix = fixOverride ?? (part ? `Add it to key.${part}, or declare lifetime: 'request'.` : "A 'document' segment cannot depend on it; declare lifetime: 'request'.");
9
+ return new Error(`[timber] ${scope.segmentPath} is lifetime: 'document' (declared, or from defaultLayoutLifetime) and read ${what}, which is not in its key. ${fix} The segment is skipped without rendering while its key is unchanged, so the read would freeze at its first value. See design/53-segment-lifetime.md §"What a 'document' segment may read".`);
10
+ }
11
+ function keyedHeaders(headers, scope) {
12
+ const keyed = (name) => {
13
+ if (scope.headers.has(name.toLowerCase())) return name;
14
+ const what = `the header "${name}"`;
15
+ if (name.toLowerCase() === "cookie") throw readOutsideKey(scope, what, "cookies", "Read cookies through a cookie definition in key.cookies.");
16
+ if (isUnkeyableHeader(name)) throw readOutsideKey(scope, what, void 0, "A key may not name a credential; declare lifetime: 'request'.");
17
+ throw readOutsideKey(scope, what, "headers");
18
+ };
19
+ const all = () => {
20
+ throw readOutsideKey(scope, "every request header", void 0, "Read each header you need with getHeaders().get(name) and add it to key.headers, or declare lifetime: 'request'.");
21
+ };
22
+ return {
23
+ get: (name) => headers.get(keyed(name)),
24
+ has: (name) => headers.has(keyed(name)),
25
+ entries: all,
26
+ keys: all,
27
+ values: all,
28
+ forEach: all,
29
+ [Symbol.iterator]: all
30
+ };
31
+ }
32
+ function assertUnscopedRead(what) {
33
+ const scope = currentReadScope();
34
+ if (scope) throw readOutsideKey(scope, what);
35
+ }
36
+ function assertSearchParamsRead(reader) {
37
+ const scope = currentReadScope();
38
+ if (!scope) return;
39
+ const outside = Object.keys(reader.codecs).filter((field) => {
40
+ const keyed = scope.searchParams.get(field);
41
+ return !keyed || keyed.codec !== reader.codecs[field] || keyed.urlKey !== (reader.urlKeys[field] ?? field);
42
+ });
43
+ if (outside.length > 0) throw readOutsideKey(scope, `the search params ${outside.join(", ")}`, "searchParams");
44
+ }
45
+ function assertCookieRead(name, codec) {
46
+ const scope = currentReadScope();
47
+ if (!scope) return;
48
+ if (!scope.cookies.has(name)) throw readOutsideKey(scope, `the cookie "${name}"`, "cookies");
49
+ if (codec === void 0 || scope.cookies.get(name) !== codec) throw readOutsideKey(scope, `the raw value of the cookie "${name}" (read it through the definition in its key)`, "cookies");
50
+ }
51
+ var OBJECT_PROBES = new Set([
52
+ "then",
53
+ "toJSON",
54
+ "$$typeof",
55
+ "constructor",
56
+ "valueOf",
57
+ "toString",
58
+ "__proto__"
59
+ ]);
60
+ function scopedParams(params) {
61
+ const scope = currentReadScope();
62
+ if (!scope) return params;
63
+ const refused = (name) => typeof name === "string" && !scope.params.has(name) && !OBJECT_PROBES.has(name);
64
+ const allowed = (name) => !refused(name);
65
+ const target = Object.assign(Object.create(Object.getPrototypeOf(params)), params);
66
+ return new Proxy(target, {
67
+ get(target, name, receiver) {
68
+ if (refused(name)) throw readOutsideKey(scope, `the segment param "${String(name)}"`, "segmentParams");
69
+ return Reflect.get(target, name, receiver);
70
+ },
71
+ has: (target, name) => allowed(name) && Reflect.has(target, name),
72
+ ownKeys: (target) => Reflect.ownKeys(target).filter(allowed),
73
+ getOwnPropertyDescriptor: (target, name) => allowed(name) ? Reflect.getOwnPropertyDescriptor(target, name) : void 0
74
+ });
75
+ }
76
+ export { assertCookieRead, assertSearchParamsRead, assertUnscopedRead, currentReadScope, keyedHeaders, readOutsideKey, scopedParams };
77
+
78
+ //# sourceMappingURL=read-rule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-rule.js","names":[],"sources":["../../../../../src/server/segment-lifetime/read-rule.ts"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"vite-handoff-rsc.js","names":[],"sources":["../../../../src/server/vite-handoff-rsc.ts"],"mappings":";AAoFA,IAAI,WAAoC,CAAC;AAmBzC,SAAS,YAAY,MAAqB;CACxC,OAAO,IAAI,MACT,+BAA+B,KAAK,0IAGtC;AACF;AAEA,SAAS,KAAqC,KAA2B;CACvE,MAAM,QAAQ,SAAS;CACvB,IAAI,UAAU,QAAW,MAAM,YAAY,GAAG;CAC9C,OAAO;AACT;AAEA,SAAS,SAA2C,MAA8B;CAChF,MAAM,KAAK,SAAS,SAAS;CAC7B,IAAI,OAAO,QAAW,MAAM,YAAY,UAAU,MAAM;CACxD,OAAO;AACT;AAGA,SAAgB,mBAAwC;CACtD,OAAO,KAAK,kBAAkB;AAChC;AAMA,IAAa,gBAAkD,GAAG,SAChE,SAAS,cAAc,CAAC,CAAC,GAAG,IAAI;AASlC,IAAa,4BAA0E,GAAG,SACxF,SAAS,0BAA0B,CAAC,CAAC,GAAG,IAAI"}
1
+ {"version":3,"file":"vite-handoff-rsc.js","names":[],"sources":["../../../../src/server/vite-handoff-rsc.ts"],"mappings":";AAyEA,IAAI,WAAoC,CAAC;AAmBzC,SAAS,YAAY,MAAqB;CACxC,OAAO,IAAI,MACT,+BAA+B,KAAK,0IAGtC;AACF;AAEA,SAAS,KAAqC,KAA2B;CACvE,MAAM,QAAQ,SAAS;CACvB,IAAI,UAAU,QAAW,MAAM,YAAY,GAAG;CAC9C,OAAO;AACT;AAEA,SAAS,SAA2C,MAA8B;CAChF,MAAM,KAAK,SAAS,SAAS;CAC7B,IAAI,OAAO,QAAW,MAAM,YAAY,UAAU,MAAM;CACxD,OAAO;AACT;AAGA,SAAgB,mBAAwC;CACtD,OAAO,KAAK,kBAAkB;AAChC;AAMA,IAAa,gBAAkD,GAAG,SAChE,SAAS,cAAc,CAAC,CAAC,GAAG,IAAI;AASlC,IAAa,4BAA0E,GAAG,SACxF,SAAS,0BAA0B,CAAC,CAAC,GAAG,IAAI"}
@@ -5,9 +5,9 @@ function createAlsSlot(message) {
5
5
  set(next) {
6
6
  fn = next;
7
7
  },
8
- get() {
8
+ get(...args) {
9
9
  if (!fn) throw new Error(message);
10
- return fn();
10
+ return fn(...args);
11
11
  }
12
12
  };
13
13
  }
@@ -1 +1 @@
1
- {"version":3,"file":"als-slots.js","names":[],"sources":["../../../../src/shared/als-slots.ts"],"mappings":";AA0CA,SAAS,cAAiB,SAA6B;CACrD,IAAI;CACJ,OAAO;EACL,IAAI,MAAM;GACR,KAAK;EACP;EACA,MAAM;GACJ,IAAI,CAAC,IAAI,MAAM,IAAI,MAAM,OAAO;GAChC,OAAO,GAAG;EACZ;CACF;AACF;AAEA,IAAM,mBAAmB,cACvB,+GAEF;AAEA,IAAM,oBAAoB,cACxB,mHAEF;AAGA,IAAa,wBAAwB,iBAAiB;AAEtD,IAAa,yBAAyB,iBAAiB;AAGvD,IAAa,yBAAyB,kBAAkB;AAEjB,kBAAkB"}
1
+ {"version":3,"file":"als-slots.js","names":[],"sources":["../../../../src/shared/als-slots.ts"],"mappings":";AA0CA,SAAS,cAA2C,SAAgC;CAClF,IAAI;CACJ,OAAO;EACL,IAAI,MAAM;GACR,KAAK;EACP;EACA,IAAI,GAAG,MAAM;GACX,IAAI,CAAC,IAAI,MAAM,IAAI,MAAM,OAAO;GAChC,OAAO,GAAG,GAAG,IAAI;EACnB;CACF;AACF;AAaA,IAAM,mBAAmB,cACvB,+GAEF;AAEA,IAAM,oBAAoB,cACxB,mHAEF;AAGA,IAAa,wBAAwB,iBAAiB;AAEtD,IAAa,yBAAyB,iBAAiB;AAGvD,IAAa,yBAAyB,kBAAkB;AAEjB,kBAAkB"}
@@ -0,0 +1,5 @@
1
+ // src/shared/cookie-read-through.ts
2
+ var COOKIE_READ_THROUGH = Symbol.for("timber.cookie-read-through");
3
+ export { COOKIE_READ_THROUGH };
4
+
5
+ //# sourceMappingURL=cookie-read-through.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie-read-through.js","names":[],"sources":["../../../../src/shared/cookie-read-through.ts"],"mappings":";AAcA,IAAa,sBAAsB,OAAO,IAAI,4BAA4B"}
@@ -0,0 +1,13 @@
1
+ var CREDENTIAL = "It carries a credential, and a key must not hold secret values.";
2
+ var UNKEYABLE_HEADERS = new Map([
3
+ ["cookie", "Key on cookie definitions with key.cookies instead."],
4
+ ["authorization", CREDENTIAL],
5
+ ["proxy-authorization", CREDENTIAL],
6
+ ["x-api-key", CREDENTIAL]
7
+ ]);
8
+ function isUnkeyableHeader(name) {
9
+ return UNKEYABLE_HEADERS.has(name.toLowerCase());
10
+ }
11
+ export { isUnkeyableHeader };
12
+
13
+ //# sourceMappingURL=key-headers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"key-headers.js","names":[],"sources":["../../../../src/shared/key-headers.ts"],"mappings":"AAiBA,IAAM,aAAa;AAMnB,IAAM,oBAAiD,IAAI,IAAI;CAC7D,CAAC,UAAU,qDAAqD;CAChE,CAAC,iBAAiB,UAAU;CAC5B,CAAC,uBAAuB,UAAU;CAClC,CAAC,aAAa,UAAU;AAC1B,CAAC;AAWD,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,kBAAkB,IAAI,KAAK,YAAY,CAAC;AACjD"}
@@ -42,8 +42,9 @@ async function rscCacheKey(lookup) {
42
42
  if (!subtle) return null;
43
43
  let canonical = "";
44
44
  for (const name of RSC_KEY_HEADERS) {
45
- const value = lookup(name);
46
- if (value == null) continue;
45
+ const raw = lookup(name);
46
+ if (raw == null) continue;
47
+ const value = name === "X-Timber-State-Tree" ? stateTreeKeyValue(raw) : raw;
47
48
  canonical += `${name.toLowerCase()}:${value.length}:${value}`;
48
49
  }
49
50
  const digest = await subtle.digest("SHA-256", new TextEncoder().encode(canonical));
@@ -51,6 +52,21 @@ async function rscCacheKey(lookup) {
51
52
  for (const byte of new Uint8Array(digest, 0, KEY_HEX_LENGTH / 2)) hex += byte.toString(16).padStart(2, "0");
52
53
  return KEY_PREFIX + hex;
53
54
  }
55
+ function stateTreeKeyValue(value) {
56
+ let parsed;
57
+ try {
58
+ parsed = JSON.parse(value);
59
+ } catch {
60
+ return value;
61
+ }
62
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return value;
63
+ if (!("documents" in parsed)) return value;
64
+ const { documents: _documents, ...rest } = parsed;
65
+ return JSON.stringify(rest);
66
+ }
67
+ function stateTreeHasDocuments(value) {
68
+ return value !== null && stateTreeKeyValue(value) !== value;
69
+ }
54
70
  function randomRscCacheKey() {
55
71
  const bytes = new Uint8Array(KEY_HEX_LENGTH / 2);
56
72
  globalThis.crypto.getRandomValues(bytes);
@@ -61,6 +77,6 @@ function recordLookup(headers) {
61
77
  for (const name of Object.keys(headers)) lowered[name.toLowerCase()] = headers[name];
62
78
  return (name) => lowered[name.toLowerCase()];
63
79
  }
64
- export { RSC_KEY_HEADERS, RSC_KEY_PARAM, appVisibleSearch, isRscCacheKeyShape, randomRscCacheKey, recordLookup, rscCacheKey, stripRscCacheKey };
80
+ export { RSC_KEY_HEADERS, RSC_KEY_PARAM, appVisibleSearch, isRscCacheKeyShape, randomRscCacheKey, recordLookup, rscCacheKey, stateTreeHasDocuments, stateTreeKeyValue, stripRscCacheKey };
65
81
 
66
82
  //# sourceMappingURL=rsc-cache-key.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"rsc-cache-key.js","names":[],"sources":["../../../../src/shared/rsc-cache-key.ts"],"mappings":";AAuBA,IAAM,iBAAiB;AAqBvB,IAAM,aAAa;AAqBnB,IAAa,kBAAkB;CAC7B;CACA;CACA;CACA;AACF;AAmBA,SAAgB,mBAAmB,OAAwB;CACzD,IAAI,CAAC,MAAM,WAAW,UAAU,GAAG,OAAO;CAC1C,MAAM,SAAS,MAAM,MAAM,CAAiB;CAC5C,OAAO,OAAO,WAAW,kBAAkB,cAAc,KAAK,MAAM;AACtE;AAUA,IAAa,gBAAgB;AAY7B,SAAS,WAAW,KAAqB;CACvC,IAAI;EACF,OAAO,mBAAmB,IAAI,QAAQ,OAAO,GAAG,CAAC;CACnD,QAAQ;EACN,OAAO;CACT;AACF;AAwBA,SAAgB,iBAAiB,QAAwB;CACvD,MAAM,QAAQ,OAAO,WAAW,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI;CACzD,IAAI,UAAU,IAAI,OAAO;CAMzB,MAAM,SALO,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,SAAS;EAC7C,MAAM,KAAK,KAAK,QAAQ,GAAG;EAC3B,IAAI,WAAW,OAAO,KAAK,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC,MAAA,QAAqB,OAAO;EAC/E,OAAO,CAAC,mBAAmB,OAAO,KAAK,KAAK,WAAW,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC;CAC5E,CACe,CAAA,CAAK,KAAK,GAAG;CAC5B,OAAO,WAAW,KAAK,KAAK,IAAI;AAClC;AA4BA,SAAgB,iBAAiB,KAA4B;CAC3D,MAAM,SAAS,iBAAiB,IAAI,MAAM;CAC1C,OAAO;EAAE,QAAQ,IAAI,gBAAgB,MAAM;EAAG;CAAO;AACvD;AAwCA,eAAsB,YAAY,QAA8C;CAC9E,MAAM,SAAS,WAAW,QAAQ;CAClC,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,YAAY;CAChB,KAAK,MAAM,QAAQ,iBAAiB;EAClC,MAAM,QAAQ,OAAO,IAAI;EACzB,IAAI,SAAS,MAAM;EAGnB,aAAa,GAAG,KAAK,YAAY,EAAE,GAAG,MAAM,OAAO,GAAG;CACxD;CACA,MAAM,SAAS,MAAM,OAAO,OAAO,WAAW,IAAI,YAAY,CAAC,CAAC,OAAO,SAAS,CAAC;CACjF,IAAI,MAAM;CACV,KAAK,MAAM,QAAQ,IAAI,WAAW,QAAQ,GAAG,iBAAiB,CAAC,GAC7D,OAAO,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG;CAE1C,OAAO,aAAa;AACtB;AAYA,SAAgB,oBAA4B;CAC1C,MAAM,QAAQ,IAAI,WAAW,iBAAiB,CAAC;CAC/C,WAAW,OAAO,gBAAgB,KAAK;CACvC,OAAO,aAAa,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;AACpF;AAGA,SAAgB,aAAa,SAA+C;CAC1E,MAAM,UAAkC,CAAC;CACzC,KAAK,MAAM,QAAQ,OAAO,KAAK,OAAO,GACpC,QAAQ,KAAK,YAAY,KAAK,QAAQ;CAExC,QAAQ,SAAS,QAAQ,KAAK,YAAY;AAC5C"}
1
+ {"version":3,"file":"rsc-cache-key.js","names":[],"sources":["../../../../src/shared/rsc-cache-key.ts"],"mappings":"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"}
@@ -26,10 +26,9 @@ function cookies() {
26
26
  return toCookie(typeof nameOrCookie === "string" ? nameOrCookie : nameOrCookie.name);
27
27
  },
28
28
  getAll(nameOrCookie) {
29
- const all = jar.getAll();
30
- if (nameOrCookie === void 0) return all;
31
- const name = typeof nameOrCookie === "string" ? nameOrCookie : nameOrCookie.name;
32
- return all.filter((cookie) => cookie.name === name);
29
+ if (nameOrCookie === void 0) return jar.getAll();
30
+ const cookie = toCookie(typeof nameOrCookie === "string" ? nameOrCookie : nameOrCookie.name);
31
+ return cookie ? [cookie] : [];
33
32
  },
34
33
  has(name) {
35
34
  return jar.has(name);
@@ -1 +1 @@
1
- {"version":3,"file":"headers.js","names":[],"sources":["../../../../src/shims/headers.ts"],"mappings":";;;;;AAoEA,SAAS,iBAAiB,SAA2D;CACnF,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,EAAE,SAAS,GAAG,SAAS;CAC7B,IAAI,OAAO,YAAY,UAAU,OAAO;EAAE,GAAG;EAAM,SAAS,IAAI,KAAK,OAAO;CAAE;CAC9E,OAAO;AACT;AASA,SAAgB,UAA8B;CAC5C,MAAM,MAAM,aAAa;CAEzB,MAAM,YAAY,SAA4C;EAC5D,MAAM,QAAQ,IAAI,IAAI,IAAI;EAC1B,OAAO,UAAU,SAAY,SAAY;GAAE;GAAM;EAAM;CACzD;CAEA,OAAO;EACL,IAAI,cAAiE;GACnE,OAAO,SAAS,OAAO,iBAAiB,WAAW,eAAe,aAAa,IAAI;EACrF;EACA,OAAO,cAAwD;GAC7D,MAAM,MAAM,IAAI,OAAO;GACvB,IAAI,iBAAiB,QAAW,OAAO;GACvC,MAAM,OAAO,OAAO,iBAAiB,WAAW,eAAe,aAAa;GAC5E,OAAO,IAAI,QAAQ,WAAW,OAAO,SAAS,IAAI;EACpD;EACA,IAAI,MAAuB;GACzB,OAAO,IAAI,IAAI,IAAI;EACrB;EACA,IAAI,OAAe;GACjB,OAAO,IAAI;EACb;EACA,IACE,cACA,OACA,SACM;GACN,IAAI,OAAO,iBAAiB,UAC1B,IAAI,IAAI,cAAc,OAAiB,iBAAiB,OAAO,CAAC;QAC3D;IACL,MAAM,EAAE,MAAM,OAAO,aAAa,GAAG,kBAAkB;IACvD,IAAI,IAAI,MAAM,aAAa,iBAAiB,aAAa,CAAC;GAC5D;EACF;EACA,OAAO,cAA6C;GAClD,IAAI,OAAO,iBAAiB,UAC1B,IAAI,OAAO,YAAY;QAClB;IAEL,MAAM,EAAE,MAAM,QAAQ,SAAS,GAAG,YAAY;IAE9C,IAAI,OAAO,MAAM,OAAO;GAC1B;EACF;EACA,EAAE,OAAO,YAAuD;GAC9D,KAAK,MAAM,UAAU,IAAI,OAAO,GAC9B,MAAM,CAAC,OAAO,MAAM,MAAM;EAE9B;EACA,WAAmB;GACjB,OAAO,IAAI,SAAS;EACtB;CACF;AACF"}
1
+ {"version":3,"file":"headers.js","names":[],"sources":["../../../../src/shims/headers.ts"],"mappings":";;;;;AAoEA,SAAS,iBAAiB,SAA2D;CACnF,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,EAAE,SAAS,GAAG,SAAS;CAC7B,IAAI,OAAO,YAAY,UAAU,OAAO;EAAE,GAAG;EAAM,SAAS,IAAI,KAAK,OAAO;CAAE;CAC9E,OAAO;AACT;AASA,SAAgB,UAA8B;CAC5C,MAAM,MAAM,aAAa;CAEzB,MAAM,YAAY,SAA4C;EAC5D,MAAM,QAAQ,IAAI,IAAI,IAAI;EAC1B,OAAO,UAAU,SAAY,SAAY;GAAE;GAAM;EAAM;CACzD;CAEA,OAAO;EACL,IAAI,cAAiE;GACnE,OAAO,SAAS,OAAO,iBAAiB,WAAW,eAAe,aAAa,IAAI;EACrF;EACA,OAAO,cAAwD;GAC7D,IAAI,iBAAiB,QAAW,OAAO,IAAI,OAAO;GAGlD,MAAM,SAAS,SAAS,OAAO,iBAAiB,WAAW,eAAe,aAAa,IAAI;GAC3F,OAAO,SAAS,CAAC,MAAM,IAAI,CAAC;EAC9B;EACA,IAAI,MAAuB;GACzB,OAAO,IAAI,IAAI,IAAI;EACrB;EACA,IAAI,OAAe;GACjB,OAAO,IAAI;EACb;EACA,IACE,cACA,OACA,SACM;GACN,IAAI,OAAO,iBAAiB,UAC1B,IAAI,IAAI,cAAc,OAAiB,iBAAiB,OAAO,CAAC;QAC3D;IACL,MAAM,EAAE,MAAM,OAAO,aAAa,GAAG,kBAAkB;IACvD,IAAI,IAAI,MAAM,aAAa,iBAAiB,aAAa,CAAC;GAC5D;EACF;EACA,OAAO,cAA6C;GAClD,IAAI,OAAO,iBAAiB,UAC1B,IAAI,OAAO,YAAY;QAClB;IAEL,MAAM,EAAE,MAAM,QAAQ,SAAS,GAAG,YAAY;IAE9C,IAAI,OAAO,MAAM,OAAO;GAC1B;EACF;EACA,EAAE,OAAO,YAAuD;GAC9D,KAAK,MAAM,UAAU,IAAI,OAAO,GAC9B,MAAM,CAAC,OAAO,MAAM,MAAM;EAE9B;EACA,WAAmB;GACjB,OAAO,IAAI,SAAS;EACtB;CACF;AACF"}
@@ -22,9 +22,16 @@ export type JsonValue = string | number | boolean | null | JsonValue[] | {
22
22
  */
23
23
  export declare function extractStaticJsxProps(attributes: PositionedNode[]): Record<string, JsonValue> | null;
24
24
  /**
25
- * Walk an AST tree and collect JSX usages of the given binding names,
25
+ * Walk an AST tree and collect element usages of the given binding names,
26
26
  * returning the static props for each usage. Returns a map of
27
27
  * bindingName → array of static prop objects (or null for dynamic props).
28
+ *
29
+ * Usages are found in both forms an element can take in the code being
30
+ * scanned: JSX syntax (`<Embed url="…" />`, what the transform hook sees in
31
+ * a .tsx module) and compiled automatic-runtime calls
32
+ * (`_jsx(Embed, { url: "…" })`). The second is what MDX compiles to, and
33
+ * what `generateBundle`'s module info holds for every importer — Vite has
34
+ * already compiled the JSX away by then.
28
35
  */
29
36
  export declare function collectJsxUsages(program: ProgramNode, bindingNames: Set<string>): Map<string, Array<Record<string, JsonValue> | null>>;
30
37
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"callsite-jsx.d.ts","sourceRoot":"","sources":["../../src/plugins/callsite-jsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAkB,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAsBrF,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AA2EjC;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,cAAc,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CA+BlC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CA0CtD;AAkBD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC/B,IAAI,CASN"}
1
+ {"version":3,"file":"callsite-jsx.d.ts","sourceRoot":"","sources":["../../src/plugins/callsite-jsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAKV,cAAc,EACd,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAsB3B,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AA2EjC;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,cAAc,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CA+BlC;AA4DD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAoEtD;AAkBD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC/B,IAAI,CASN"}
@@ -1 +1 @@
1
- {"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../src/plugins/entries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1D,eAAO,MAAM,OAAO,QAEe,CAAC;AAiBpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAuC,CAAC;AAqInE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAqBxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA+B3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiFxD"}
1
+ {"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../src/plugins/entries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAInC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAS1D,eAAO,MAAM,OAAO,QAEe,CAAC;AAiBpC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAuC,CAAC;AAuInE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAqBxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA+B3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiFxD"}
@@ -1,14 +1,15 @@
1
1
  /**
2
- * timber-prerender-sugar — Vite plugin that desugars `export const prerender`
3
- * on page and layout files into `cache.component(...)` wrappers.
2
+ * timber-prerender-sugar — Vite plugin that desugars `prerender` in a page's
3
+ * `pageOptions` (or an ancestor layout's `layoutOptions`) into a
4
+ * `cache.component(...)` wrapper around the page.
4
5
  *
5
6
  * Design doc: design/45-cache-lifetimes.md §"Route-Level Static" and
6
- * §"Layout Propagation".
7
+ * §"Layout Propagation"; design/53-segment-lifetime.md §"Route-module options".
7
8
  *
8
- * `export const prerender = true` on a page is pure sugar: it desugars to
9
+ * `pageOptions = { prerender: true }` on a page is pure sugar: it desugars to
9
10
  * wrapping the page's default export in `timber.cache.component(Component,
10
11
  * { prerender: true })`. Layout propagation cascades a layout's
11
- * `export const prerender` to descendant pages via most-specific-wins:
12
+ * `layoutOptions.prerender` to descendant pages via most-specific-wins:
12
13
  * walk the segment tree from leaf to root, first explicit value wins.
13
14
  *
14
15
  * Layout declarations are propagation policy only. Layouts receive the real
@@ -22,18 +23,18 @@
22
23
  import type { Plugin } from 'vite';
23
24
  import type { PluginContext } from '../plugin-context.ts';
24
25
  import type { SegmentNode } from '../routing/types.ts';
25
- import { type PrerenderExportValue } from '../routing/export-detect.ts';
26
+ import type { RoutePrerender } from '../server/types.ts';
26
27
  /**
27
28
  * Walk the segment tree and resolve the effective prerender value for
28
29
  * every page. Returns a map from page file path to resolved value.
29
30
  *
30
- * **Pages:** walk from leaf toward root; first explicit `export const prerender`
31
+ * **Pages:** walk from leaf toward root; first explicit `prerender` option
31
32
  * wins (page > nearest layout > ... > root layout). If none, dynamic.
32
33
  *
33
34
  * **Layouts:** declarations propagate to descendant pages but layouts are not
34
35
  * included in the result. Their real React-element `children` preserve secure
35
36
  * containment and deliberately make child-independent layout caching invalid.
36
37
  */
37
- export declare function resolvePagePrerender(root: SegmentNode): Map<string, PrerenderExportValue>;
38
+ export declare function resolvePagePrerender(root: SegmentNode): Map<string, RoutePrerender>;
38
39
  export declare function timberPrerenderSugar(ctx: PluginContext): Plugin;
39
40
  //# sourceMappingURL=prerender-sugar.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"prerender-sugar.d.ts","sourceRoot":"","sources":["../../src/plugins/prerender-sugar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAY5F;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CA2BzF;AAuFD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAwL/D"}
1
+ {"version":3,"file":"prerender-sugar.d.ts","sourceRoot":"","sources":["../../src/plugins/prerender-sugar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAazD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CA2BnF;AAoGD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAyL/D"}
@@ -1 +1 @@
1
- {"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/plugins/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,KAAK,MAAM,EAAsB,MAAM,MAAM,CAAC;AAYjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsD1D,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4SxD"}
1
+ {"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/plugins/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,KAAK,MAAM,EAAsB,MAAM,MAAM,CAAC;AAYjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsD1D,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA8SxD"}
@@ -9,14 +9,18 @@
9
9
  * empty pages, confusing React errors).
10
10
  *
11
11
  * A check emits `level: 'error'` only when the misconfiguration is *proven*
12
- * (never inferred from an absence the analysis cannot see through) and fatal
13
- * to rendering. `plugins/routing.ts` turns those into a thrown build error,
12
+ * (never inferred from an absence the analysis cannot see through) and either
13
+ * fatal to rendering or a declaration that provably does nothing — a CSRF
14
+ * exemption the gate never reads, a route option the build cannot read, a
15
+ * middleware.ts in a slot. The developer believes the declaration is in
16
+ * effect, so silence would ship the wrong behavior. `plugins/routing.ts` turns those into a thrown build error,
14
17
  * so a false positive there refuses a working app — see
15
18
  * `classifyClientBoundaryFile` for how that bar is met.
16
19
  *
17
20
  * Design doc: 07-routing.md, 10-error-handling.md
18
21
  */
19
22
  import type { RouteTree } from './types.ts';
23
+ import type { SegmentLifetime } from '../server/types.ts';
20
24
  export interface ConventionWarning {
21
25
  /** Warning ID for deduplication and filtering. */
22
26
  id: string;
@@ -32,7 +36,11 @@ export interface ConventionWarning {
32
36
  *
33
37
  * Returns an array of warnings. Empty array means everything looks good.
34
38
  */
35
- export declare function lintConventions(tree: RouteTree, appDir: string): ConventionWarning[];
39
+ export declare function lintConventions(tree: RouteTree, appDir: string,
40
+ /** The config the checks depend on, as the build resolved it. */
41
+ config: {
42
+ defaultLayoutLifetime: SegmentLifetime | undefined;
43
+ }): ConventionWarning[];
36
44
  /**
37
45
  * Check if the app/ directory exists. Called before scanning.
38
46
  * Returns a warning if missing, or null if the directory exists.
@@ -1 +1 @@
1
- {"version":3,"file":"convention-lint.d.ts","sourceRoot":"","sources":["../../src/routing/convention-lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAa,SAAS,EAAe,MAAM,YAAY,CAAC;AAcpE,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAyCpF;AA2dD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAe1E;AAUD,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkCR"}
1
+ {"version":3,"file":"convention-lint.d.ts","sourceRoot":"","sources":["../../src/routing/convention-lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAa,SAAS,EAAe,MAAM,YAAY,CAAC;AAapE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM;AACd,iEAAiE;AACjE,MAAM,EAAE;IAAE,qBAAqB,EAAE,eAAe,GAAG,SAAS,CAAA;CAAE,GAC7D,iBAAiB,EAAE,CA6CrB;AAudD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAe1E;AAUD,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkCR"}
@@ -5,6 +5,46 @@
5
5
  * default exports, replacing the regex-based approach that was fragile
6
6
  * with TypeScript syntax (type exports, `as` aliases, comments, etc.).
7
7
  */
8
+ interface AstNode {
9
+ type: string;
10
+ exportKind?: string;
11
+ declaration?: AstNode;
12
+ specifiers?: Array<{
13
+ exported?: {
14
+ name: string;
15
+ };
16
+ local?: {
17
+ name: string;
18
+ };
19
+ exportKind?: string;
20
+ }>;
21
+ id?: {
22
+ name: string;
23
+ };
24
+ declarations?: Array<{
25
+ id?: {
26
+ name: string;
27
+ };
28
+ init?: AstNode;
29
+ }>;
30
+ /** Set on re-exports: `export { X } from './y'`. Absent on local exports. */
31
+ source?: {
32
+ value?: string;
33
+ } | null;
34
+ /** Set on runtime-transparent wrappers: `X as T`, `X satisfies T`, `(X)`, `X!`. */
35
+ expression?: AstNode;
36
+ /** Set on `Identifier` nodes. */
37
+ name?: string;
38
+ }
39
+ interface ProgramNode {
40
+ body: AstNode[];
41
+ }
42
+ /**
43
+ * Parse a module. `lang` defaults to `tsx`; pass `ts` for `.ts` files, where
44
+ * an angle-bracket cast or a generic arrow (`<T>(x: T) => x`) is valid
45
+ * TypeScript but a TSX parse error.
46
+ */
47
+ export declare function tryParse(source: string, lang?: 'ts' | 'tsx'): ProgramNode | null;
8
48
  /**
9
49
  * Check if a file exports a specific named export.
10
50
  * Returns false if the file doesn't exist or can't be parsed.
@@ -20,6 +60,11 @@ export declare function fileHasAnyExport(filePath: string, exportNames: readonly
20
60
  * Returns false if the file doesn't exist or can't be parsed.
21
61
  */
22
62
  export declare function fileHasDefaultExport(filePath: string): boolean;
63
+ /**
64
+ * Expression wrappers that erase at runtime and so cannot change where a value
65
+ * was constructed: `X as T`, `X satisfies T`, `<T>X`, `X!`, `X<T>`, `(X)`.
66
+ */
67
+ export declare const TRANSPARENT_WRAPPERS: ReadonlySet<string>;
23
68
  /**
24
69
  * Whether the default export is *provably* a value constructed by this module:
25
70
  * `export default function/class/() => {}`, or a name bound to a function or
@@ -41,29 +86,6 @@ export declare function fileDefaultExportIsLocalValue(filePath: string): boolean
41
86
  * Returns false if the file doesn't exist or can't be parsed.
42
87
  */
43
88
  export declare function fileHasStarExport(filePath: string): boolean;
44
- /**
45
- * Parsed value of `export const prerender` from a route file.
46
- *
47
- * - `true` / `false` — literal boolean
48
- * - `{ ttl?, tags? }` — ISR options object (prerender: true is implied)
49
- * - `undefined` — no `export const prerender` found
50
- *
51
- * See design/45-cache-lifetimes.md §"Route-Level Static".
52
- */
53
- export type PrerenderExportValue = boolean | {
54
- ttl?: number;
55
- tags?: string[];
56
- };
57
- /**
58
- * Extract the value of `export const prerender` from a file.
59
- * Returns undefined if the file doesn't export `prerender` or can't be parsed.
60
- *
61
- * Supports:
62
- * export const prerender = true;
63
- * export const prerender = false;
64
- * export const prerender = { ttl: 3600, tags: ['docs'] };
65
- */
66
- export declare function getPrerenderExport(filePath: string): PrerenderExportValue | undefined;
67
89
  /**
68
90
  * How a file declares the per-route CSRF exemption.
69
91
  *
@@ -83,9 +105,14 @@ export declare function getPrerenderExport(filePath: string): PrerenderExportVal
83
105
  */
84
106
  export type CsrfExport = 'absent' | 'exempt' | 'invalid';
85
107
  export declare function getCsrfExport(filePath: string): CsrfExport;
108
+ /** Whether a destructuring pattern binds `name` anywhere inside it. */
109
+ export declare function patternBinds(node: unknown, name: string): boolean;
86
110
  /**
87
111
  * Check if a file starts with a specific directive (e.g. "use client").
88
112
  * Directives are string literal expression statements at the top of the file.
89
113
  */
90
114
  export declare function fileHasDirective(filePath: string, directive: string): boolean;
115
+ /** Route files the AST checks can read; `.mdx` and `.json` are skipped. */
116
+ export declare function isScriptExtension(ext: string): boolean;
117
+ export {};
91
118
  //# sourceMappingURL=export-detect.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"export-detect.d.ts","sourceRoot":"","sources":["../../src/routing/export-detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4HH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAU3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAc9F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU9D;AAoED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiCvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU3D;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA8C/E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CA+CrF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAsC1D;AA+BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgB7E"}
1
+ {"version":3,"file":"export-detect.d.ts","sourceRoot":"","sources":["../../src/routing/export-detect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,EAAE,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChE,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnC,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,KAAa,GAAG,WAAW,GAAG,IAAI,CAMvF;AAyFD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAU3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAc9F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU9D;AAWD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAOnD,CAAC;AA8CH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiCvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAsC1D;AAQD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgB7E;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtD"}
@@ -1,6 +1,6 @@
1
- import { n as scanRoutes } from "../_chunks/scanner-C9Lrf77z.js";
1
+ import { n as scanRoutes } from "../_chunks/scanner-CCEHN9Jg.js";
2
2
  import { t as generateRouteMap } from "../_chunks/codegen-vaCyFyVN.js";
3
3
  import { a as INTERCEPTION_MARKERS, i as DEFAULT_PAGE_EXTENSIONS, n as classifyUrlSegment, t as classifySegment } from "../_chunks/segment-classify-Ho8jXWeC.js";
4
4
  import { t as collectInterceptionRewrites } from "../_chunks/interception-CtNt9jPt.js";
5
- import { n as collectDynamicSegmentsFromTree, r as validateSchemaAgainstRoutes, t as collectLeafRoutes } from "../_chunks/walkers-Bxv4v7tX.js";
5
+ import { n as collectDynamicSegmentsFromTree, r as validateSchemaAgainstRoutes, t as collectLeafRoutes } from "../_chunks/walkers-BbotBhNG.js";
6
6
  export { DEFAULT_PAGE_EXTENSIONS, INTERCEPTION_MARKERS, classifySegment, classifyUrlSegment, collectDynamicSegmentsFromTree, collectInterceptionRewrites, collectLeafRoutes, generateRouteMap, scanRoutes, validateSchemaAgainstRoutes };