@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.230

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 (1560) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +376 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-DHum77eH.js +1272 -0
  5. package/dist/_chunks/actions-DHum77eH.js.map +1 -0
  6. package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
  7. package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
  8. package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
  9. package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
  10. package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
  11. package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
  12. package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
  13. package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
  14. package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
  15. package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
  16. package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
  17. package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
  18. package/dist/_chunks/chains-D-RRc7CM.js +266 -0
  19. package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
  20. package/dist/_chunks/chains-KblEfYzm.js +1 -0
  21. package/dist/_chunks/classify-_W0RWa5w.js +146 -0
  22. package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
  23. package/dist/_chunks/cli-check-B-JZkpBD.js +251 -0
  24. package/dist/_chunks/cli-check-B-JZkpBD.js.map +1 -0
  25. package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
  26. package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
  27. package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
  28. package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
  29. package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
  30. package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
  31. package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
  33. package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
  34. package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
  35. package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
  36. package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
  37. package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
  38. package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
  39. package/dist/_chunks/codec-registry-CPc6bjVl.js +20 -0
  40. package/dist/_chunks/codec-registry-CPc6bjVl.js.map +1 -0
  41. package/dist/_chunks/codegen-B9oWkWGf.js +429 -0
  42. package/dist/_chunks/codegen-B9oWkWGf.js.map +1 -0
  43. package/dist/_chunks/convention-lint-CrDKERHg.js +578 -0
  44. package/dist/_chunks/convention-lint-CrDKERHg.js.map +1 -0
  45. package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
  46. package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
  47. package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
  48. package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
  49. package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
  50. package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
  51. package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
  52. package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
  53. package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
  54. package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
  55. package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
  56. package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
  57. package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
  58. package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
  59. package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
  60. package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
  61. package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
  62. package/dist/_chunks/format-DuPOoXUP.js +13 -0
  63. package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
  64. package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
  65. package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
  66. package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
  67. package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
  68. package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
  69. package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
  70. package/dist/_chunks/href-validation-CEZy1V-k.js +210 -0
  71. package/dist/_chunks/href-validation-CEZy1V-k.js.map +1 -0
  72. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  73. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  74. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  75. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  76. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  77. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  78. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  79. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  80. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  81. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  82. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  83. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  84. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  85. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  86. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  87. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  88. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  89. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  90. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  91. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  92. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  93. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  94. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  95. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  96. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  97. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  98. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  99. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  100. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  101. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  102. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  103. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  104. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  105. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  106. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  107. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  108. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  109. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  110. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  111. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  112. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  113. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  114. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  115. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  116. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  117. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  118. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  119. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  120. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  121. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  122. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  123. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  124. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  125. package/dist/_chunks/state-B-EBjeER.js +49 -0
  126. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  127. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  128. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  129. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  130. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  131. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  132. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  133. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  134. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  135. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  136. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  137. package/dist/adapters/build-output-helper.d.ts +81 -0
  138. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  139. package/dist/adapters/canonicalize-module.d.ts +8 -0
  140. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  141. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  142. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  143. package/dist/adapters/cloudflare-dev.js +73 -0
  144. package/dist/adapters/cloudflare-dev.js.map +1 -0
  145. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  146. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  148. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  149. package/dist/adapters/cloudflare.d.ts +217 -24
  150. package/dist/adapters/cloudflare.d.ts.map +1 -1
  151. package/dist/adapters/cloudflare.js +1 -188
  152. package/dist/adapters/compress-module.d.ts +25 -4
  153. package/dist/adapters/compress-module.d.ts.map +1 -1
  154. package/dist/adapters/fs-identity.d.ts +63 -0
  155. package/dist/adapters/fs-identity.d.ts.map +1 -0
  156. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  157. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  158. package/dist/adapters/nitro-presets.d.ts +37 -0
  159. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  160. package/dist/adapters/nitro-preview.d.ts +65 -0
  161. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  162. package/dist/adapters/nitro.d.ts +69 -38
  163. package/dist/adapters/nitro.d.ts.map +1 -1
  164. package/dist/adapters/nitro.js +837 -347
  165. package/dist/adapters/nitro.js.map +1 -1
  166. package/dist/adapters/shared.d.ts +85 -0
  167. package/dist/adapters/shared.d.ts.map +1 -0
  168. package/dist/adapters/types.d.ts +124 -16
  169. package/dist/adapters/types.d.ts.map +1 -1
  170. package/dist/adapters/types.js +0 -0
  171. package/dist/analyze/chains.d.ts +124 -0
  172. package/dist/analyze/chains.d.ts.map +1 -0
  173. package/dist/analyze/classify.d.ts +153 -0
  174. package/dist/analyze/classify.d.ts.map +1 -0
  175. package/dist/analyze/crawl-entry.d.ts +17 -0
  176. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  177. package/dist/analyze/crawl-entry.js +312 -0
  178. package/dist/analyze/crawl-entry.js.map +1 -0
  179. package/dist/analyze/crawl.d.ts +134 -0
  180. package/dist/analyze/crawl.d.ts.map +1 -0
  181. package/dist/analyze/graph-cache.d.ts +104 -0
  182. package/dist/analyze/graph-cache.d.ts.map +1 -0
  183. package/dist/analyze/graph-command.d.ts +43 -0
  184. package/dist/analyze/graph-command.d.ts.map +1 -0
  185. package/dist/analyze/graph-command.js +386 -0
  186. package/dist/analyze/graph-command.js.map +1 -0
  187. package/dist/analyze/live-graph.d.ts +81 -0
  188. package/dist/analyze/live-graph.d.ts.map +1 -0
  189. package/dist/analyze/poison-rules.d.ts +72 -0
  190. package/dist/analyze/poison-rules.d.ts.map +1 -0
  191. package/dist/analyze/poison-scan.d.ts +48 -0
  192. package/dist/analyze/poison-scan.d.ts.map +1 -0
  193. package/dist/analyze/scan.d.ts +73 -0
  194. package/dist/analyze/scan.d.ts.map +1 -0
  195. package/dist/cache/cache-api.d.ts +48 -0
  196. package/dist/cache/cache-api.d.ts.map +1 -0
  197. package/dist/cache/fast-hash.d.ts +5 -0
  198. package/dist/cache/fast-hash.d.ts.map +1 -1
  199. package/dist/cache/guarded-read.d.ts +29 -0
  200. package/dist/cache/guarded-read.d.ts.map +1 -0
  201. package/dist/cache/handler-store.d.ts +45 -0
  202. package/dist/cache/handler-store.d.ts.map +1 -0
  203. package/dist/cache/index.d.ts +32 -9
  204. package/dist/cache/index.d.ts.map +1 -1
  205. package/dist/cache/index.js +4 -326
  206. package/dist/cache/invalidation-epoch.d.ts +50 -0
  207. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  208. package/dist/cache/json-lossy-check.d.ts +11 -0
  209. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  210. package/dist/cache/key-discipline.d.ts +61 -0
  211. package/dist/cache/key-discipline.d.ts.map +1 -0
  212. package/dist/cache/redis-handler.d.ts +140 -9
  213. package/dist/cache/redis-handler.d.ts.map +1 -1
  214. package/dist/cache/singleflight.d.ts +31 -2
  215. package/dist/cache/singleflight.d.ts.map +1 -1
  216. package/dist/cache/sizeof.d.ts +22 -0
  217. package/dist/cache/sizeof.d.ts.map +1 -0
  218. package/dist/cache/stable-stringify.d.ts +15 -0
  219. package/dist/cache/stable-stringify.d.ts.map +1 -1
  220. package/dist/cache/store.d.ts +53 -0
  221. package/dist/cache/store.d.ts.map +1 -0
  222. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  223. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  224. package/dist/cache/stores/cloudflare-kv.js +28 -0
  225. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  226. package/dist/cache/stores/memory.d.ts +42 -0
  227. package/dist/cache/stores/memory.d.ts.map +1 -0
  228. package/dist/cache/stores/memory.js +89 -0
  229. package/dist/cache/stores/memory.js.map +1 -0
  230. package/dist/cache/stores/redis.d.ts +69 -0
  231. package/dist/cache/stores/redis.d.ts.map +1 -0
  232. package/dist/cache/stores/redis.js +34 -0
  233. package/dist/cache/stores/redis.js.map +1 -0
  234. package/dist/cache/stores/vercel.d.ts +36 -0
  235. package/dist/cache/stores/vercel.d.ts.map +1 -0
  236. package/dist/cache/stores/vercel.js +32 -0
  237. package/dist/cache/stores/vercel.js.map +1 -0
  238. package/dist/cache/tag-aware-handler.d.ts +51 -0
  239. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  240. package/dist/cache/timber-cache.d.ts +25 -11
  241. package/dist/cache/timber-cache.d.ts.map +1 -1
  242. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  243. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  244. package/dist/cdn/cloudflare-purge.js +29 -0
  245. package/dist/cdn/cloudflare-purge.js.map +1 -0
  246. package/dist/cdn/fastly-purge.d.ts +25 -0
  247. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  248. package/dist/cdn/fastly-purge.js +32 -0
  249. package/dist/cdn/fastly-purge.js.map +1 -0
  250. package/dist/cdn/headers.d.ts +97 -0
  251. package/dist/cdn/headers.d.ts.map +1 -0
  252. package/dist/cdn/index.d.ts +5 -0
  253. package/dist/cdn/index.d.ts.map +1 -0
  254. package/dist/cdn/index.js +93 -0
  255. package/dist/cdn/index.js.map +1 -0
  256. package/dist/cdn/purge-store.d.ts +32 -0
  257. package/dist/cdn/purge-store.d.ts.map +1 -0
  258. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  259. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  260. package/dist/cdn/workers-cache-purge.js +33 -0
  261. package/dist/cdn/workers-cache-purge.js.map +1 -0
  262. package/dist/cli-check.d.ts +133 -0
  263. package/dist/cli-check.d.ts.map +1 -0
  264. package/dist/cli-context.d.ts +62 -0
  265. package/dist/cli-context.d.ts.map +1 -0
  266. package/dist/cli-dev-status.d.ts +75 -0
  267. package/dist/cli-dev-status.d.ts.map +1 -0
  268. package/dist/cli-init.d.ts +72 -0
  269. package/dist/cli-init.d.ts.map +1 -0
  270. package/dist/cli-schema-sync.d.ts +59 -0
  271. package/dist/cli-schema-sync.d.ts.map +1 -0
  272. package/dist/cli.d.ts +80 -16
  273. package/dist/cli.d.ts.map +1 -1
  274. package/dist/cli.js +210 -69
  275. package/dist/cli.js.map +1 -1
  276. package/dist/client/browser-dev.d.ts +42 -2
  277. package/dist/client/browser-dev.d.ts.map +1 -1
  278. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  279. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  280. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  281. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  282. package/dist/client/browser-entry/form-state.d.ts +22 -0
  283. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  284. package/dist/client/browser-entry/hmr.d.ts +27 -0
  285. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  286. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  287. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  288. package/dist/client/browser-entry/index.d.ts +32 -0
  289. package/dist/client/browser-entry/index.d.ts.map +1 -0
  290. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  291. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  292. package/dist/client/browser-entry/router-init.d.ts +41 -0
  293. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  294. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  295. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  296. package/dist/client/browser-entry/scroll.d.ts +28 -0
  297. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  298. package/dist/client/deny-last-resort.d.ts +29 -0
  299. package/dist/client/deny-last-resort.d.ts.map +1 -0
  300. package/dist/client/dev-pill/index.d.ts +32 -0
  301. package/dist/client/dev-pill/index.d.ts.map +1 -0
  302. package/dist/client/dev-pill/store.d.ts +105 -0
  303. package/dist/client/dev-pill/store.d.ts.map +1 -0
  304. package/dist/client/dev-pill/view.d.ts +9 -0
  305. package/dist/client/dev-pill/view.d.ts.map +1 -0
  306. package/dist/client/error-boundary.d.ts +58 -9
  307. package/dist/client/error-boundary.d.ts.map +1 -1
  308. package/dist/client/error-boundary.js +1 -126
  309. package/dist/client/error-reconstituter.d.ts +55 -0
  310. package/dist/client/error-reconstituter.d.ts.map +1 -0
  311. package/dist/client/form.d.ts +38 -99
  312. package/dist/client/form.d.ts.map +1 -1
  313. package/dist/client/global-context.d.ts +35 -0
  314. package/dist/client/global-context.d.ts.map +1 -0
  315. package/dist/client/history.d.ts +50 -9
  316. package/dist/client/history.d.ts.map +1 -1
  317. package/dist/client/index.d.ts +22 -33
  318. package/dist/client/index.d.ts.map +1 -1
  319. package/dist/client/index.js +416 -1241
  320. package/dist/client/index.js.map +1 -1
  321. package/dist/client/internal.d.ts +20 -0
  322. package/dist/client/internal.d.ts.map +1 -0
  323. package/dist/client/internal.js +785 -0
  324. package/dist/client/internal.js.map +1 -0
  325. package/dist/client/link.d.ts +85 -60
  326. package/dist/client/link.d.ts.map +1 -1
  327. package/dist/client/location-search.d.ts +12 -0
  328. package/dist/client/location-search.d.ts.map +1 -0
  329. package/dist/client/navigation-api.d.ts +95 -0
  330. package/dist/client/navigation-api.d.ts.map +1 -0
  331. package/dist/client/navigation-commit.d.ts +111 -0
  332. package/dist/client/navigation-commit.d.ts.map +1 -0
  333. package/dist/client/navigation-context.d.ts +75 -37
  334. package/dist/client/navigation-context.d.ts.map +1 -1
  335. package/dist/client/navigation-root.d.ts +106 -0
  336. package/dist/client/navigation-root.d.ts.map +1 -0
  337. package/dist/client/navigation-transition.d.ts +255 -0
  338. package/dist/client/navigation-transition.d.ts.map +1 -0
  339. package/dist/client/nuqs-adapter.d.ts +5 -2
  340. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  341. package/dist/client/params-context.d.ts +81 -0
  342. package/dist/client/params-context.d.ts.map +1 -0
  343. package/dist/client/react-root.d.ts +51 -0
  344. package/dist/client/react-root.d.ts.map +1 -0
  345. package/dist/client/router-effects.d.ts +203 -0
  346. package/dist/client/router-effects.d.ts.map +1 -0
  347. package/dist/client/router-lifecycle.d.ts +107 -0
  348. package/dist/client/router-lifecycle.d.ts.map +1 -0
  349. package/dist/client/router-pipeline.d.ts +81 -0
  350. package/dist/client/router-pipeline.d.ts.map +1 -0
  351. package/dist/client/router-ref.d.ts +2 -2
  352. package/dist/client/router-ref.d.ts.map +1 -1
  353. package/dist/client/router-skew.d.ts +21 -0
  354. package/dist/client/router-skew.d.ts.map +1 -0
  355. package/dist/client/router-types.d.ts +294 -0
  356. package/dist/client/router-types.d.ts.map +1 -0
  357. package/dist/client/router-url.d.ts +24 -0
  358. package/dist/client/router-url.d.ts.map +1 -0
  359. package/dist/client/router.d.ts +1 -97
  360. package/dist/client/router.d.ts.map +1 -1
  361. package/dist/client/rsc-fetch.d.ts +110 -28
  362. package/dist/client/rsc-fetch.d.ts.map +1 -1
  363. package/dist/client/segment-cache.d.ts +186 -25
  364. package/dist/client/segment-cache.d.ts.map +1 -1
  365. package/dist/client/segment-context.d.ts.map +1 -1
  366. package/dist/client/segment-outlet.d.ts +68 -0
  367. package/dist/client/segment-outlet.d.ts.map +1 -0
  368. package/dist/client/segment-update-context.d.ts +15 -0
  369. package/dist/client/segment-update-context.d.ts.map +1 -0
  370. package/dist/client/shallow-url.d.ts +10 -0
  371. package/dist/client/shallow-url.d.ts.map +1 -0
  372. package/dist/client/slot-content-cache-context.d.ts +35 -0
  373. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  374. package/dist/client/slot-context.d.ts +31 -0
  375. package/dist/client/slot-context.d.ts.map +1 -0
  376. package/dist/client/slot-outlet.d.ts +16 -0
  377. package/dist/client/slot-outlet.d.ts.map +1 -0
  378. package/dist/client/slot-provider.d.ts +25 -0
  379. package/dist/client/slot-provider.d.ts.map +1 -0
  380. package/dist/client/ssr-data.d.ts +26 -50
  381. package/dist/client/ssr-data.d.ts.map +1 -1
  382. package/dist/client/stale-client.d.ts +69 -0
  383. package/dist/client/stale-client.d.ts.map +1 -0
  384. package/dist/client/state.d.ts +21 -13
  385. package/dist/client/state.d.ts.map +1 -1
  386. package/dist/client/status-page-marker.d.ts +25 -0
  387. package/dist/client/status-page-marker.d.ts.map +1 -0
  388. package/dist/client/top-loader.d.ts +7 -6
  389. package/dist/client/top-loader.d.ts.map +1 -1
  390. package/dist/client/unload-guard.d.ts +5 -0
  391. package/dist/client/unload-guard.d.ts.map +1 -1
  392. package/dist/client/use-cookie.d.ts +25 -0
  393. package/dist/client/use-cookie.d.ts.map +1 -1
  394. package/dist/client/use-field-state.d.ts +42 -0
  395. package/dist/client/use-field-state.d.ts.map +1 -0
  396. package/dist/client/use-link-status.d.ts +5 -5
  397. package/dist/client/use-link-status.d.ts.map +1 -1
  398. package/dist/client/use-pathname.d.ts +13 -11
  399. package/dist/client/use-pathname.d.ts.map +1 -1
  400. package/dist/client/use-pending-navigation.d.ts +47 -0
  401. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  402. package/dist/client/use-query-states.d.ts +10 -4
  403. package/dist/client/use-query-states.d.ts.map +1 -1
  404. package/dist/client/use-router.d.ts +15 -8
  405. package/dist/client/use-router.d.ts.map +1 -1
  406. package/dist/client/use-search-params.d.ts +15 -8
  407. package/dist/client/use-search-params.d.ts.map +1 -1
  408. package/dist/client/use-segment-params.d.ts +55 -0
  409. package/dist/client/use-segment-params.d.ts.map +1 -0
  410. package/dist/codec.d.ts +69 -0
  411. package/dist/codec.d.ts.map +1 -0
  412. package/dist/codec.js +75 -0
  413. package/dist/codec.js.map +1 -0
  414. package/dist/config-types.d.ts +366 -0
  415. package/dist/config-types.d.ts.map +1 -0
  416. package/dist/config-validation.d.ts +68 -0
  417. package/dist/config-validation.d.ts.map +1 -0
  418. package/dist/cookies/define-cookie.d.ts +58 -25
  419. package/dist/cookies/define-cookie.d.ts.map +1 -1
  420. package/dist/cookies/index.d.ts +3 -2
  421. package/dist/cookies/index.d.ts.map +1 -1
  422. package/dist/cookies/index.js +230 -37
  423. package/dist/cookies/index.js.map +1 -1
  424. package/dist/cookies/json-cookie.d.ts +64 -0
  425. package/dist/cookies/json-cookie.d.ts.map +1 -0
  426. package/dist/cookies/validation.d.ts +34 -0
  427. package/dist/cookies/validation.d.ts.map +1 -0
  428. package/dist/dev-tools/404-page.d.ts +50 -0
  429. package/dist/dev-tools/404-page.d.ts.map +1 -0
  430. package/dist/dev-tools/await-span.d.ts +17 -0
  431. package/dist/dev-tools/await-span.d.ts.map +1 -0
  432. package/dist/dev-tools/browser-logs.d.ts +40 -0
  433. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  434. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  435. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  436. package/dist/dev-tools/error-page.d.ts +32 -0
  437. package/dist/dev-tools/error-page.d.ts.map +1 -0
  438. package/dist/dev-tools/holding-server.d.ts +46 -0
  439. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  440. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  441. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  442. package/dist/dev-tools/index.d.ts +31 -0
  443. package/dist/dev-tools/index.d.ts.map +1 -0
  444. package/dist/dev-tools/instrumentation.d.ts +74 -0
  445. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  446. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  447. package/dist/dev-tools/logger.d.ts.map +1 -0
  448. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  449. package/dist/dev-tools/logs.d.ts.map +1 -0
  450. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  451. package/dist/dev-tools/overlay.d.ts.map +1 -0
  452. package/dist/dev-tools/span-sink.d.ts +42 -0
  453. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  454. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  455. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  456. package/dist/dev-tools/terminal.d.ts +28 -0
  457. package/dist/dev-tools/terminal.d.ts.map +1 -0
  458. package/dist/fonts/ast-walk.d.ts +68 -0
  459. package/dist/fonts/ast-walk.d.ts.map +1 -0
  460. package/dist/fonts/ast.d.ts +112 -8
  461. package/dist/fonts/ast.d.ts.map +1 -1
  462. package/dist/fonts/bundle.d.ts +50 -0
  463. package/dist/fonts/bundle.d.ts.map +1 -0
  464. package/dist/fonts/css.d.ts +1 -1
  465. package/dist/fonts/dev-middleware.d.ts +22 -0
  466. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  467. package/dist/fonts/fallbacks.d.ts +0 -7
  468. package/dist/fonts/fallbacks.d.ts.map +1 -1
  469. package/dist/fonts/google.d.ts +5 -3
  470. package/dist/fonts/google.d.ts.map +1 -1
  471. package/dist/fonts/local.d.ts +5 -5
  472. package/dist/fonts/local.d.ts.map +1 -1
  473. package/dist/fonts/paths.d.ts +43 -0
  474. package/dist/fonts/paths.d.ts.map +1 -0
  475. package/dist/fonts/pipeline.d.ts +177 -0
  476. package/dist/fonts/pipeline.d.ts.map +1 -0
  477. package/dist/fonts/transform.d.ts +82 -0
  478. package/dist/fonts/transform.d.ts.map +1 -0
  479. package/dist/fonts/types.d.ts +47 -1
  480. package/dist/fonts/types.d.ts.map +1 -1
  481. package/dist/fonts/virtual-modules.d.ts +77 -0
  482. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  483. package/dist/index.d.ts +35 -181
  484. package/dist/index.d.ts.map +1 -1
  485. package/dist/index.js +9949 -14264
  486. package/dist/index.js.map +1 -1
  487. package/dist/params/codec-registry.d.ts +26 -0
  488. package/dist/params/codec-registry.d.ts.map +1 -0
  489. package/dist/params/define-schema.d.ts +81 -0
  490. package/dist/params/define-schema.d.ts.map +1 -0
  491. package/dist/params/index.d.ts +5 -0
  492. package/dist/params/index.d.ts.map +1 -0
  493. package/dist/params/index.js +33 -0
  494. package/dist/params/index.js.map +1 -0
  495. package/dist/params/resolve-schema.d.ts +34 -0
  496. package/dist/params/resolve-schema.d.ts.map +1 -0
  497. package/dist/plugin-context.d.ts +269 -0
  498. package/dist/plugin-context.d.ts.map +1 -0
  499. package/dist/plugins/build-manifest.d.ts +7 -3
  500. package/dist/plugins/build-manifest.d.ts.map +1 -1
  501. package/dist/plugins/build-report.d.ts +61 -11
  502. package/dist/plugins/build-report.d.ts.map +1 -1
  503. package/dist/plugins/cache.d.ts +64 -0
  504. package/dist/plugins/cache.d.ts.map +1 -0
  505. package/dist/plugins/callsite-ast.d.ts +117 -0
  506. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  507. package/dist/plugins/callsite-jsx.d.ts +35 -0
  508. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  509. package/dist/plugins/chunks.d.ts +11 -4
  510. package/dist/plugins/chunks.d.ts.map +1 -1
  511. package/dist/plugins/client-chunks.d.ts +40 -0
  512. package/dist/plugins/client-chunks.d.ts.map +1 -0
  513. package/dist/plugins/client-dep-entries.d.ts +80 -0
  514. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  515. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  516. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  517. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  518. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  519. package/dist/plugins/content.d.ts +1 -1
  520. package/dist/plugins/content.d.ts.map +1 -1
  521. package/dist/plugins/dev-await.d.ts +81 -0
  522. package/dist/plugins/dev-await.d.ts.map +1 -0
  523. package/dist/plugins/dev-discovery.d.ts +187 -0
  524. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  525. package/dist/plugins/dev-hostname.d.ts +152 -0
  526. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  527. package/dist/plugins/dev-server.d.ts +29 -2
  528. package/dist/plugins/dev-server.d.ts.map +1 -1
  529. package/dist/plugins/dev-store-clear.d.ts +83 -0
  530. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  531. package/dist/plugins/encryption-runtime.d.ts +13 -0
  532. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  533. package/dist/plugins/entries.d.ts +40 -4
  534. package/dist/plugins/entries.d.ts.map +1 -1
  535. package/dist/plugins/fonts.d.ts +35 -74
  536. package/dist/plugins/fonts.d.ts.map +1 -1
  537. package/dist/plugins/graph-endpoint.d.ts +114 -0
  538. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  539. package/dist/plugins/mdx.d.ts +18 -5
  540. package/dist/plugins/mdx.d.ts.map +1 -1
  541. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  542. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  543. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  544. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  545. package/dist/plugins/orphaned-modules.d.ts +57 -0
  546. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  547. package/dist/plugins/post-build.d.ts +110 -0
  548. package/dist/plugins/post-build.d.ts.map +1 -0
  549. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  550. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  551. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  552. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt.d.ts +98 -0
  554. package/dist/plugins/prebuilt.d.ts.map +1 -0
  555. package/dist/plugins/prerender-sugar.d.ts +39 -0
  556. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  557. package/dist/plugins/react-resolve.d.ts +49 -0
  558. package/dist/plugins/react-resolve.d.ts.map +1 -0
  559. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  560. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  561. package/dist/plugins/request-dep/index.d.ts +75 -0
  562. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/origin.d.ts +61 -0
  564. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  565. package/dist/plugins/routing.d.ts +2 -2
  566. package/dist/plugins/routing.d.ts.map +1 -1
  567. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  568. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  569. package/dist/plugins/server-bundle.d.ts +1 -1
  570. package/dist/plugins/server-bundle.d.ts.map +1 -1
  571. package/dist/plugins/shims.d.ts +29 -5
  572. package/dist/plugins/shims.d.ts.map +1 -1
  573. package/dist/plugins/static-build.d.ts +246 -26
  574. package/dist/plugins/static-build.d.ts.map +1 -1
  575. package/dist/routing/codegen-shared.d.ts +26 -0
  576. package/dist/routing/codegen-shared.d.ts.map +1 -0
  577. package/dist/routing/codegen-types.d.ts +61 -0
  578. package/dist/routing/codegen-types.d.ts.map +1 -0
  579. package/dist/routing/codegen-write.d.ts +42 -0
  580. package/dist/routing/codegen-write.d.ts.map +1 -0
  581. package/dist/routing/codegen.d.ts +8 -3
  582. package/dist/routing/codegen.d.ts.map +1 -1
  583. package/dist/routing/collision-probe.d.ts +104 -0
  584. package/dist/routing/collision-probe.d.ts.map +1 -0
  585. package/dist/routing/collision-spaces.d.ts +26 -0
  586. package/dist/routing/collision-spaces.d.ts.map +1 -0
  587. package/dist/routing/convention-lint.d.ts +55 -0
  588. package/dist/routing/convention-lint.d.ts.map +1 -0
  589. package/dist/routing/export-detect.d.ts +91 -0
  590. package/dist/routing/export-detect.d.ts.map +1 -0
  591. package/dist/routing/file-cache.d.ts +8 -0
  592. package/dist/routing/file-cache.d.ts.map +1 -0
  593. package/dist/routing/index.d.ts +13 -7
  594. package/dist/routing/index.d.ts.map +1 -1
  595. package/dist/routing/index.js +5 -2
  596. package/dist/routing/interception-overlap.d.ts +35 -0
  597. package/dist/routing/interception-overlap.d.ts.map +1 -0
  598. package/dist/routing/interception.d.ts +234 -10
  599. package/dist/routing/interception.d.ts.map +1 -1
  600. package/dist/routing/link-codegen.d.ts +105 -0
  601. package/dist/routing/link-codegen.d.ts.map +1 -0
  602. package/dist/routing/manifest-codegen.d.ts +26 -0
  603. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  604. package/dist/routing/scanner.d.ts +14 -10
  605. package/dist/routing/scanner.d.ts.map +1 -1
  606. package/dist/routing/schema-validation.d.ts +35 -0
  607. package/dist/routing/schema-validation.d.ts.map +1 -0
  608. package/dist/routing/segment-classify.d.ts +114 -0
  609. package/dist/routing/segment-classify.d.ts.map +1 -0
  610. package/dist/routing/segment-codegen.d.ts +38 -0
  611. package/dist/routing/segment-codegen.d.ts.map +1 -0
  612. package/dist/routing/segment-keys.d.ts +118 -0
  613. package/dist/routing/segment-keys.d.ts.map +1 -0
  614. package/dist/routing/slot-placement.d.ts +48 -0
  615. package/dist/routing/slot-placement.d.ts.map +1 -0
  616. package/dist/routing/types.d.ts +81 -26
  617. package/dist/routing/types.d.ts.map +1 -1
  618. package/dist/routing/walkers.d.ts +57 -0
  619. package/dist/routing/walkers.d.ts.map +1 -0
  620. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  621. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  622. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  623. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  624. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  625. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  626. package/dist/rsc-runtime/rsc.d.ts +3 -13
  627. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  628. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  629. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  630. package/dist/rsc-runtime/server-references.d.ts +19 -0
  631. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  632. package/dist/rsc-runtime/ssr.d.ts +7 -10
  633. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  634. package/dist/rsc-runtime/transforms.d.ts +13 -0
  635. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  636. package/dist/schema-bridge.d.ts +154 -0
  637. package/dist/schema-bridge.d.ts.map +1 -0
  638. package/dist/search-params/define.d.ts +262 -0
  639. package/dist/search-params/define.d.ts.map +1 -0
  640. package/dist/search-params/index.d.ts +3 -7
  641. package/dist/search-params/index.d.ts.map +1 -1
  642. package/dist/search-params/index.js +178 -362
  643. package/dist/search-params/index.js.map +1 -1
  644. package/dist/search-params/parse-total.d.ts +81 -0
  645. package/dist/search-params/parse-total.d.ts.map +1 -0
  646. package/dist/search-params/serialize-equal.d.ts +9 -0
  647. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  648. package/dist/search-params/wrappers.d.ts +76 -0
  649. package/dist/search-params/wrappers.d.ts.map +1 -0
  650. package/dist/server/abort-scope.d.ts +27 -0
  651. package/dist/server/abort-scope.d.ts.map +1 -0
  652. package/dist/server/access-gate.d.ts +110 -10
  653. package/dist/server/access-gate.d.ts.map +1 -1
  654. package/dist/server/action-client.d.ts +20 -133
  655. package/dist/server/action-client.d.ts.map +1 -1
  656. package/dist/server/action-encryption.d.ts +76 -0
  657. package/dist/server/action-encryption.d.ts.map +1 -0
  658. package/dist/server/action-handler.d.ts +60 -11
  659. package/dist/server/action-handler.d.ts.map +1 -1
  660. package/dist/server/action-schema.d.ts +126 -0
  661. package/dist/server/action-schema.d.ts.map +1 -0
  662. package/dist/server/action-types.d.ts +108 -0
  663. package/dist/server/action-types.d.ts.map +1 -0
  664. package/dist/server/actions.d.ts +78 -40
  665. package/dist/server/actions.d.ts.map +1 -1
  666. package/dist/server/als-registry.d.ts +189 -17
  667. package/dist/server/als-registry.d.ts.map +1 -1
  668. package/dist/server/body-limits.d.ts.map +1 -1
  669. package/dist/server/build-manifest.d.ts +25 -30
  670. package/dist/server/build-manifest.d.ts.map +1 -1
  671. package/dist/server/canonicalize.d.ts +53 -0
  672. package/dist/server/canonicalize.d.ts.map +1 -1
  673. package/dist/server/chain-url-parts.d.ts +82 -0
  674. package/dist/server/chain-url-parts.d.ts.map +1 -0
  675. package/dist/server/children-interception.d.ts +49 -0
  676. package/dist/server/children-interception.d.ts.map +1 -0
  677. package/dist/server/client-error-message.d.ts +12 -0
  678. package/dist/server/client-error-message.d.ts.map +1 -0
  679. package/dist/server/coalesce-tick.d.ts +40 -0
  680. package/dist/server/coalesce-tick.d.ts.map +1 -0
  681. package/dist/server/compress.d.ts +2 -0
  682. package/dist/server/compress.d.ts.map +1 -1
  683. package/dist/server/cookie-context.d.ts +156 -0
  684. package/dist/server/cookie-context.d.ts.map +1 -0
  685. package/dist/server/cookie-parsing.d.ts +65 -0
  686. package/dist/server/cookie-parsing.d.ts.map +1 -0
  687. package/dist/server/csp-nonce.d.ts +36 -0
  688. package/dist/server/csp-nonce.d.ts.map +1 -0
  689. package/dist/server/csrf.d.ts +58 -15
  690. package/dist/server/csrf.d.ts.map +1 -1
  691. package/dist/server/debug.d.ts +0 -1
  692. package/dist/server/debug.d.ts.map +1 -1
  693. package/dist/server/default-logger.d.ts +23 -0
  694. package/dist/server/default-logger.d.ts.map +1 -0
  695. package/dist/server/default-status-page.d.ts +45 -0
  696. package/dist/server/default-status-page.d.ts.map +1 -0
  697. package/dist/server/deny-boundary.d.ts +257 -0
  698. package/dist/server/deny-boundary.d.ts.map +1 -0
  699. package/dist/server/deny-renderer.d.ts +22 -15
  700. package/dist/server/deny-renderer.d.ts.map +1 -1
  701. package/dist/server/early-hints-sender.d.ts.map +1 -1
  702. package/dist/server/early-hints.d.ts +14 -12
  703. package/dist/server/early-hints.d.ts.map +1 -1
  704. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  705. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  706. package/dist/server/error-response-headers.d.ts +3 -0
  707. package/dist/server/error-response-headers.d.ts.map +1 -0
  708. package/dist/server/fallback-error.d.ts +19 -7
  709. package/dist/server/fallback-error.d.ts.map +1 -1
  710. package/dist/server/flight-injection-state.d.ts +66 -0
  711. package/dist/server/flight-injection-state.d.ts.map +1 -0
  712. package/dist/server/flight-injector-core.d.ts +125 -0
  713. package/dist/server/flight-injector-core.d.ts.map +1 -0
  714. package/dist/server/flight-scripts.d.ts +63 -0
  715. package/dist/server/flight-scripts.d.ts.map +1 -0
  716. package/dist/server/flight-source-node.d.ts +105 -0
  717. package/dist/server/flight-source-node.d.ts.map +1 -0
  718. package/dist/server/flight-source.d.ts +136 -0
  719. package/dist/server/flight-source.d.ts.map +1 -0
  720. package/dist/server/form-data.d.ts +59 -2
  721. package/dist/server/form-data.d.ts.map +1 -1
  722. package/dist/server/form-state-flight.d.ts +32 -0
  723. package/dist/server/form-state-flight.d.ts.map +1 -0
  724. package/dist/server/head-response.d.ts +35 -0
  725. package/dist/server/head-response.d.ts.map +1 -0
  726. package/dist/server/html-injector-core.d.ts +169 -0
  727. package/dist/server/html-injector-core.d.ts.map +1 -0
  728. package/dist/server/html-injectors.d.ts +77 -47
  729. package/dist/server/html-injectors.d.ts.map +1 -1
  730. package/dist/server/index.d.ts +16 -54
  731. package/dist/server/index.d.ts.map +1 -1
  732. package/dist/server/index.js +621 -3009
  733. package/dist/server/index.js.map +1 -1
  734. package/dist/server/instrumentation.d.ts +13 -5
  735. package/dist/server/instrumentation.d.ts.map +1 -1
  736. package/dist/server/interception-gates.d.ts +49 -0
  737. package/dist/server/interception-gates.d.ts.map +1 -0
  738. package/dist/server/internal.d.ts +48 -0
  739. package/dist/server/internal.d.ts.map +1 -0
  740. package/dist/server/internal.js +5094 -0
  741. package/dist/server/internal.js.map +1 -0
  742. package/dist/server/json-status-response.d.ts +34 -0
  743. package/dist/server/json-status-response.d.ts.map +1 -0
  744. package/dist/server/logger.d.ts +105 -7
  745. package/dist/server/logger.d.ts.map +1 -1
  746. package/dist/server/metadata-collector.d.ts +75 -0
  747. package/dist/server/metadata-collector.d.ts.map +1 -0
  748. package/dist/server/metadata-platform.d.ts +2 -2
  749. package/dist/server/metadata-render.d.ts +2 -2
  750. package/dist/server/metadata-render.d.ts.map +1 -1
  751. package/dist/server/metadata-route-links.d.ts +70 -0
  752. package/dist/server/metadata-route-links.d.ts.map +1 -0
  753. package/dist/server/metadata-routes.d.ts +47 -11
  754. package/dist/server/metadata-routes.d.ts.map +1 -1
  755. package/dist/server/metadata-social.d.ts +2 -2
  756. package/dist/server/metadata.d.ts +10 -2
  757. package/dist/server/metadata.d.ts.map +1 -1
  758. package/dist/server/middleware-runner.d.ts +20 -5
  759. package/dist/server/middleware-runner.d.ts.map +1 -1
  760. package/dist/server/node-body-response.d.ts +55 -0
  761. package/dist/server/node-body-response.d.ts.map +1 -0
  762. package/dist/server/node-response.d.ts +62 -0
  763. package/dist/server/node-response.d.ts.map +1 -0
  764. package/dist/server/node-stream-transforms.d.ts +108 -0
  765. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  766. package/dist/server/node-streams-platform.d.ts +21 -0
  767. package/dist/server/node-streams-platform.d.ts.map +1 -0
  768. package/dist/server/param-coercion.d.ts +91 -0
  769. package/dist/server/param-coercion.d.ts.map +1 -0
  770. package/dist/server/pipeline-helpers.d.ts +227 -0
  771. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  772. package/dist/server/pipeline-interception.d.ts +100 -9
  773. package/dist/server/pipeline-interception.d.ts.map +1 -1
  774. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  775. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  776. package/dist/server/pipeline-metadata.d.ts +18 -2
  777. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  778. package/dist/server/pipeline-outcome.d.ts +59 -0
  779. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  780. package/dist/server/pipeline-phases.d.ts +76 -0
  781. package/dist/server/pipeline-phases.d.ts.map +1 -0
  782. package/dist/server/pipeline.d.ts +190 -23
  783. package/dist/server/pipeline.d.ts.map +1 -1
  784. package/dist/server/port-resolution.d.ts +22 -0
  785. package/dist/server/port-resolution.d.ts.map +1 -0
  786. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  787. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  788. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  789. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  790. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  791. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  792. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  793. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  794. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  795. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  796. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  797. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  798. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  799. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  800. package/dist/server/prebuilt/overlay.d.ts +119 -0
  801. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  802. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  803. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  804. package/dist/server/prebuilt/slots.d.ts +105 -0
  805. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  806. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  807. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  808. package/dist/server/prebuilt-builder.d.ts +121 -0
  809. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  810. package/dist/server/prebuilt-runtime.d.ts +105 -0
  811. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  812. package/dist/server/primitives.d.ts +114 -90
  813. package/dist/server/primitives.d.ts.map +1 -1
  814. package/dist/server/publish-params.d.ts +33 -0
  815. package/dist/server/publish-params.d.ts.map +1 -0
  816. package/dist/server/react-cache-bridge.d.ts +59 -0
  817. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  818. package/dist/server/react-cache-scope.d.ts +49 -0
  819. package/dist/server/react-cache-scope.d.ts.map +1 -0
  820. package/dist/server/render-timeout.d.ts +66 -0
  821. package/dist/server/render-timeout.d.ts.map +1 -0
  822. package/dist/server/render-utils.d.ts +56 -0
  823. package/dist/server/render-utils.d.ts.map +1 -0
  824. package/dist/server/request-context.d.ts +167 -103
  825. package/dist/server/request-context.d.ts.map +1 -1
  826. package/dist/server/request-dep.d.ts +15 -0
  827. package/dist/server/request-dep.d.ts.map +1 -0
  828. package/dist/server/response-cache-policy.d.ts +3 -0
  829. package/dist/server/response-cache-policy.d.ts.map +1 -0
  830. package/dist/server/response-framing.d.ts +43 -0
  831. package/dist/server/response-framing.d.ts.map +1 -0
  832. package/dist/server/route-element-builder.d.ts +57 -30
  833. package/dist/server/route-element-builder.d.ts.map +1 -1
  834. package/dist/server/route-element-helpers.d.ts +12 -0
  835. package/dist/server/route-element-helpers.d.ts.map +1 -0
  836. package/dist/server/route-handler.d.ts +9 -3
  837. package/dist/server/route-handler.d.ts.map +1 -1
  838. package/dist/server/route-matcher.d.ts +75 -40
  839. package/dist/server/route-matcher.d.ts.map +1 -1
  840. package/dist/server/route-methods.d.ts +23 -0
  841. package/dist/server/route-methods.d.ts.map +1 -0
  842. package/dist/server/route-module-loader.d.ts +37 -0
  843. package/dist/server/route-module-loader.d.ts.map +1 -0
  844. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  845. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  846. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  847. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  848. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  849. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  850. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  851. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  852. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  853. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  854. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  855. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  856. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  857. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  858. package/dist/server/rsc-entry/index.d.ts +30 -6
  859. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  860. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  861. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  862. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  863. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  865. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  866. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  867. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  869. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  871. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  872. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  873. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  874. package/dist/server/rsc-error-envelope.d.ts +11 -0
  875. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  876. package/dist/server/safe-load.d.ts +39 -0
  877. package/dist/server/safe-load.d.ts.map +1 -0
  878. package/dist/server/schema-introspection.d.ts +68 -0
  879. package/dist/server/schema-introspection.d.ts.map +1 -0
  880. package/dist/server/sensitive-fields.d.ts +88 -0
  881. package/dist/server/sensitive-fields.d.ts.map +1 -0
  882. package/dist/server/signal-identity.d.ts +49 -0
  883. package/dist/server/signal-identity.d.ts.map +1 -0
  884. package/dist/server/sitemap-generator.d.ts +130 -0
  885. package/dist/server/sitemap-generator.d.ts.map +1 -0
  886. package/dist/server/sitemap-handler.d.ts +22 -0
  887. package/dist/server/sitemap-handler.d.ts.map +1 -0
  888. package/dist/server/skippable-prefix.d.ts +29 -0
  889. package/dist/server/skippable-prefix.d.ts.map +1 -0
  890. package/dist/server/slot-interception.d.ts +80 -0
  891. package/dist/server/slot-interception.d.ts.map +1 -0
  892. package/dist/server/slot-resolver.d.ts +138 -7
  893. package/dist/server/slot-resolver.d.ts.map +1 -1
  894. package/dist/server/slot-subtree-contain.d.ts +54 -0
  895. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  896. package/dist/server/ssr-bridge-types.d.ts +213 -0
  897. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  898. package/dist/server/ssr-entry.d.ts +15 -51
  899. package/dist/server/ssr-entry.d.ts.map +1 -1
  900. package/dist/server/ssr-form-state.d.ts +30 -0
  901. package/dist/server/ssr-form-state.d.ts.map +1 -0
  902. package/dist/server/ssr-render.d.ts +42 -12
  903. package/dist/server/ssr-render.d.ts.map +1 -1
  904. package/dist/server/ssr-wrappers.d.ts +92 -0
  905. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  906. package/dist/server/state-tree-diff.d.ts +44 -9
  907. package/dist/server/state-tree-diff.d.ts.map +1 -1
  908. package/dist/server/static-generator.d.ts +112 -0
  909. package/dist/server/static-generator.d.ts.map +1 -0
  910. package/dist/server/static-not-found.d.ts +52 -0
  911. package/dist/server/static-not-found.d.ts.map +1 -0
  912. package/dist/server/status-code-resolver.d.ts +26 -15
  913. package/dist/server/status-code-resolver.d.ts.map +1 -1
  914. package/dist/server/stream-utils.d.ts +93 -0
  915. package/dist/server/stream-utils.d.ts.map +1 -0
  916. package/dist/server/traced-access.d.ts +18 -0
  917. package/dist/server/traced-access.d.ts.map +1 -0
  918. package/dist/server/tracing.d.ts +72 -31
  919. package/dist/server/tracing.d.ts.map +1 -1
  920. package/dist/server/tree-match.d.ts +59 -0
  921. package/dist/server/tree-match.d.ts.map +1 -0
  922. package/dist/server/types.d.ts +90 -8
  923. package/dist/server/types.d.ts.map +1 -1
  924. package/dist/server/utils/element-type.d.ts +50 -0
  925. package/dist/server/utils/element-type.d.ts.map +1 -0
  926. package/dist/server/utils/escape-html.d.ts +14 -0
  927. package/dist/server/utils/escape-html.d.ts.map +1 -0
  928. package/dist/server/version-skew.d.ts +61 -0
  929. package/dist/server/version-skew.d.ts.map +1 -0
  930. package/dist/server/workers-cache-bridge.d.ts +26 -0
  931. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  932. package/dist/shared/als-slots.d.ts +42 -0
  933. package/dist/shared/als-slots.d.ts.map +1 -0
  934. package/dist/shared/base-path.d.ts +56 -0
  935. package/dist/shared/base-path.d.ts.map +1 -0
  936. package/dist/shared/csrf-reject.d.ts +16 -0
  937. package/dist/shared/csrf-reject.d.ts.map +1 -0
  938. package/dist/shared/dev-span.d.ts +99 -0
  939. package/dist/shared/dev-span.d.ts.map +1 -0
  940. package/dist/shared/error-digest.d.ts +28 -0
  941. package/dist/shared/error-digest.d.ts.map +1 -0
  942. package/dist/shared/flight-base64.d.ts +13 -0
  943. package/dist/shared/flight-base64.d.ts.map +1 -0
  944. package/dist/shared/flight-segment.d.ts +18 -0
  945. package/dist/shared/flight-segment.d.ts.map +1 -0
  946. package/dist/shared/form-state-flight.d.ts +32 -0
  947. package/dist/shared/form-state-flight.d.ts.map +1 -0
  948. package/dist/shared/href-validation.d.ts +49 -0
  949. package/dist/shared/href-validation.d.ts.map +1 -0
  950. package/dist/shared/merge-search-params.d.ts +22 -0
  951. package/dist/shared/merge-search-params.d.ts.map +1 -0
  952. package/dist/shared/param-value.d.ts +104 -0
  953. package/dist/shared/param-value.d.ts.map +1 -0
  954. package/dist/shared/payload-root.d.ts +110 -0
  955. package/dist/shared/payload-root.d.ts.map +1 -0
  956. package/dist/shared/redirect-type.d.ts +17 -0
  957. package/dist/shared/redirect-type.d.ts.map +1 -0
  958. package/dist/shared/rsc-cache-key.d.ts +163 -0
  959. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  960. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  961. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  962. package/dist/shared/rsc-manifest.d.ts +28 -0
  963. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  964. package/dist/shared/rsc-media-type.d.ts +52 -0
  965. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  966. package/dist/shared/rsc-payload-path.d.ts +48 -0
  967. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  968. package/dist/shared/segment-info.d.ts +66 -0
  969. package/dist/shared/segment-info.d.ts.map +1 -0
  970. package/dist/shared/slot-params.d.ts +52 -0
  971. package/dist/shared/slot-params.d.ts.map +1 -0
  972. package/dist/shared/static-platform-files.d.ts +71 -0
  973. package/dist/shared/static-platform-files.d.ts.map +1 -0
  974. package/dist/shared/status-reason-phrase.d.ts +26 -0
  975. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  976. package/dist/shims/font-google.d.ts +1 -1
  977. package/dist/shims/font-google.d.ts.map +1 -1
  978. package/dist/shims/font-google.js +41 -0
  979. package/dist/shims/font-google.js.map +1 -0
  980. package/dist/shims/font-local.d.ts +26 -0
  981. package/dist/shims/font-local.d.ts.map +1 -0
  982. package/dist/shims/font-local.js +19 -0
  983. package/dist/shims/font-local.js.map +1 -0
  984. package/dist/shims/headers.d.ts +60 -1
  985. package/dist/shims/headers.d.ts.map +1 -1
  986. package/dist/shims/image.d.ts +120 -120
  987. package/dist/shims/image.d.ts.map +1 -1
  988. package/dist/shims/navigation-client.d.ts +25 -12
  989. package/dist/shims/navigation-client.d.ts.map +1 -1
  990. package/dist/shims/navigation-rsc.d.ts +21 -0
  991. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  992. package/dist/shims/navigation.d.ts +10 -5
  993. package/dist/shims/navigation.d.ts.map +1 -1
  994. package/dist/utils/state-machine.d.ts +80 -0
  995. package/dist/utils/state-machine.d.ts.map +1 -0
  996. package/dist/utils/write-file-atomic.d.ts +17 -0
  997. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  998. package/docs/api/30-api-server.mdx +241 -0
  999. package/docs/api/31-api-client.mdx +225 -0
  1000. package/docs/api/32-api-cache.mdx +341 -0
  1001. package/docs/api/33-api-search-params.mdx +178 -0
  1002. package/docs/api/34-api-config.mdx +421 -0
  1003. package/docs/api/35-api-typescript.mdx +91 -0
  1004. package/docs/api/36-cli.mdx +272 -0
  1005. package/docs/learn/00-introduction.mdx +109 -0
  1006. package/docs/learn/01-quick-start.mdx +94 -0
  1007. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1008. package/docs/learn/03-fetching-data.mdx +227 -0
  1009. package/docs/learn/04-access-control.mdx +115 -0
  1010. package/docs/learn/05-the-flush-point.mdx +175 -0
  1011. package/docs/learn/06-typed-params.mdx +275 -0
  1012. package/docs/learn/07-typed-routes.mdx +108 -0
  1013. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1014. package/docs/learn/09-streaming.mdx +146 -0
  1015. package/docs/learn/10-caching.mdx +303 -0
  1016. package/docs/learn/11-middleware.mdx +166 -0
  1017. package/docs/learn/12-error-handling.mdx +192 -0
  1018. package/docs/learn/13-deploying.mdx +289 -0
  1019. package/llms.txt +55 -0
  1020. package/package.json +120 -29
  1021. package/src/adapters/build-output-helper.ts +375 -0
  1022. package/src/adapters/canonicalize-module.ts +29 -0
  1023. package/src/adapters/cloudflare-dev.ts +183 -0
  1024. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1025. package/src/adapters/cloudflare.ts +799 -151
  1026. package/src/adapters/compress-module.ts +110 -86
  1027. package/src/adapters/fs-identity.ts +155 -0
  1028. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1029. package/src/adapters/nitro-presets.ts +139 -0
  1030. package/src/adapters/nitro-preview.ts +565 -0
  1031. package/src/adapters/nitro.ts +349 -448
  1032. package/src/adapters/raw-imports.d.ts +5 -0
  1033. package/src/adapters/shared.ts +314 -0
  1034. package/src/adapters/types.ts +129 -17
  1035. package/src/adapters/wrangler.d.ts +7 -0
  1036. package/src/analyze/chains.ts +411 -0
  1037. package/src/analyze/classify.ts +259 -0
  1038. package/src/analyze/crawl-entry.ts +68 -0
  1039. package/src/analyze/crawl.ts +500 -0
  1040. package/src/analyze/graph-cache.ts +331 -0
  1041. package/src/analyze/graph-command.ts +654 -0
  1042. package/src/analyze/live-graph.ts +232 -0
  1043. package/src/analyze/poison-rules.ts +165 -0
  1044. package/src/analyze/poison-scan.ts +159 -0
  1045. package/src/analyze/scan.ts +149 -0
  1046. package/src/cache/cache-api.ts +113 -0
  1047. package/src/cache/fast-hash.ts +5 -0
  1048. package/src/cache/guarded-read.ts +44 -0
  1049. package/src/cache/handler-store.ts +113 -0
  1050. package/src/cache/index.ts +93 -20
  1051. package/src/cache/invalidation-epoch.ts +105 -0
  1052. package/src/cache/json-lossy-check.ts +69 -0
  1053. package/src/cache/key-discipline.ts +218 -0
  1054. package/src/cache/redis-handler.ts +193 -19
  1055. package/src/cache/singleflight.ts +85 -7
  1056. package/src/cache/sizeof.ts +35 -0
  1057. package/src/cache/stable-stringify.ts +118 -2
  1058. package/src/cache/store.ts +71 -0
  1059. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1060. package/src/cache/stores/memory.ts +125 -0
  1061. package/src/cache/stores/redis.ts +97 -0
  1062. package/src/cache/stores/vercel.ts +59 -0
  1063. package/src/cache/tag-aware-handler.ts +250 -0
  1064. package/src/cache/timber-cache.ts +218 -47
  1065. package/src/cdn/cloudflare-purge.ts +50 -0
  1066. package/src/cdn/fastly-purge.ts +63 -0
  1067. package/src/cdn/headers.ts +153 -0
  1068. package/src/cdn/index.ts +23 -0
  1069. package/src/cdn/purge-store.ts +62 -0
  1070. package/src/cdn/workers-cache-purge.ts +34 -0
  1071. package/src/cli-check.ts +417 -0
  1072. package/src/cli-context.ts +128 -0
  1073. package/src/cli-dev-status.ts +196 -0
  1074. package/src/cli-init.ts +278 -0
  1075. package/src/cli-schema-sync.ts +401 -0
  1076. package/src/cli.ts +308 -84
  1077. package/src/client/browser-dev.ts +192 -5
  1078. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1079. package/src/client/browser-entry/action-queue.ts +152 -0
  1080. package/src/client/browser-entry/form-state.ts +49 -0
  1081. package/src/client/browser-entry/hmr.ts +82 -0
  1082. package/src/client/browser-entry/hydrate.ts +152 -0
  1083. package/src/client/browser-entry/index.ts +153 -0
  1084. package/src/client/browser-entry/post-hydration.ts +99 -0
  1085. package/src/client/browser-entry/router-init.ts +391 -0
  1086. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1087. package/src/client/browser-entry/scroll.ts +50 -0
  1088. package/src/client/deny-last-resort.tsx +54 -0
  1089. package/src/client/dev-pill/index.ts +128 -0
  1090. package/src/client/dev-pill/store.ts +254 -0
  1091. package/src/client/dev-pill/view.ts +326 -0
  1092. package/src/client/error-boundary.tsx +296 -61
  1093. package/src/client/error-reconstituter.tsx +84 -0
  1094. package/src/client/form.tsx +61 -173
  1095. package/src/client/global-context.ts +59 -0
  1096. package/src/client/history.ts +74 -11
  1097. package/src/client/index.ts +91 -53
  1098. package/src/client/internal.ts +54 -0
  1099. package/src/client/link.tsx +464 -151
  1100. package/src/client/location-search.ts +15 -0
  1101. package/src/client/navigation-api.ts +254 -0
  1102. package/src/client/navigation-commit.ts +318 -0
  1103. package/src/client/navigation-context.ts +71 -142
  1104. package/src/client/navigation-root.tsx +237 -0
  1105. package/src/client/navigation-transition.ts +401 -0
  1106. package/src/client/nuqs-adapter.tsx +62 -32
  1107. package/src/client/params-context.ts +175 -0
  1108. package/src/client/react-root.ts +105 -0
  1109. package/src/client/router-effects.ts +349 -0
  1110. package/src/client/router-lifecycle.ts +394 -0
  1111. package/src/client/router-pipeline.ts +443 -0
  1112. package/src/client/router-ref.ts +3 -3
  1113. package/src/client/router-skew.ts +30 -0
  1114. package/src/client/router-types.ts +326 -0
  1115. package/src/client/router-url.ts +32 -0
  1116. package/src/client/router.ts +491 -421
  1117. package/src/client/rsc-fetch.ts +510 -109
  1118. package/src/client/segment-cache.ts +362 -41
  1119. package/src/client/segment-context.ts +7 -4
  1120. package/src/client/segment-outlet.tsx +96 -0
  1121. package/src/client/segment-update-context.ts +23 -0
  1122. package/src/client/shallow-url.ts +22 -0
  1123. package/src/client/slot-content-cache-context.ts +43 -0
  1124. package/src/client/slot-context.ts +39 -0
  1125. package/src/client/slot-outlet.tsx +22 -0
  1126. package/src/client/slot-provider.tsx +32 -0
  1127. package/src/client/ssr-data.ts +27 -67
  1128. package/src/client/stale-client.ts +191 -0
  1129. package/src/client/state.ts +31 -24
  1130. package/src/client/status-page-marker.tsx +32 -0
  1131. package/src/client/top-loader.tsx +13 -10
  1132. package/src/client/unload-guard.ts +35 -3
  1133. package/src/client/use-cookie.ts +93 -29
  1134. package/src/client/use-field-state.ts +144 -0
  1135. package/src/client/use-link-status.ts +7 -7
  1136. package/src/client/use-pathname.ts +22 -31
  1137. package/src/client/use-pending-navigation.ts +119 -0
  1138. package/src/client/use-query-states.ts +206 -36
  1139. package/src/client/use-router.ts +31 -9
  1140. package/src/client/use-search-params.ts +38 -49
  1141. package/src/client/use-segment-params.ts +69 -0
  1142. package/src/client/use-selected-layout-segment.ts +2 -2
  1143. package/src/codec.ts +149 -0
  1144. package/src/config-types.ts +366 -0
  1145. package/src/config-validation.ts +511 -0
  1146. package/src/cookies/define-cookie.ts +186 -53
  1147. package/src/cookies/index.ts +13 -2
  1148. package/src/cookies/json-cookie.ts +105 -0
  1149. package/src/cookies/validation.ts +192 -0
  1150. package/src/dev-tools/404-page.ts +286 -0
  1151. package/src/dev-tools/await-span.ts +69 -0
  1152. package/src/dev-tools/browser-logs.ts +55 -0
  1153. package/src/dev-tools/dev-page-shell.ts +278 -0
  1154. package/src/dev-tools/error-page.ts +331 -0
  1155. package/src/dev-tools/holding-server.ts +185 -0
  1156. package/src/dev-tools/hydration-overlay.ts +158 -0
  1157. package/src/dev-tools/index.ts +79 -0
  1158. package/src/dev-tools/instrumentation.ts +281 -0
  1159. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1160. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1161. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1162. package/src/dev-tools/span-sink.ts +132 -0
  1163. package/src/dev-tools/stack-classifier.ts +75 -0
  1164. package/src/dev-tools/terminal.ts +182 -0
  1165. package/src/fonts/ast-walk.ts +235 -0
  1166. package/src/fonts/ast.ts +479 -128
  1167. package/src/fonts/bundle.ts +138 -0
  1168. package/src/fonts/css.ts +1 -1
  1169. package/src/fonts/dev-middleware.ts +85 -0
  1170. package/src/fonts/fallbacks.ts +0 -23
  1171. package/src/fonts/google.ts +101 -19
  1172. package/src/fonts/local.ts +12 -11
  1173. package/src/fonts/paths.ts +58 -0
  1174. package/src/fonts/pipeline.ts +348 -0
  1175. package/src/fonts/transform.ts +311 -0
  1176. package/src/fonts/types.ts +52 -1
  1177. package/src/fonts/virtual-modules.ts +179 -0
  1178. package/src/index.ts +498 -380
  1179. package/src/params/codec-registry.ts +34 -0
  1180. package/src/params/define-schema.ts +115 -0
  1181. package/src/params/index.ts +17 -0
  1182. package/src/params/resolve-schema.ts +84 -0
  1183. package/src/plugin-context.ts +509 -0
  1184. package/src/plugins/build-manifest.ts +189 -36
  1185. package/src/plugins/build-report.ts +299 -87
  1186. package/src/plugins/cache.ts +243 -0
  1187. package/src/plugins/callsite-ast.ts +472 -0
  1188. package/src/plugins/callsite-jsx.ts +243 -0
  1189. package/src/plugins/chunks.ts +74 -5
  1190. package/src/plugins/client-chunks.ts +185 -0
  1191. package/src/plugins/client-dep-entries.ts +124 -0
  1192. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1193. package/src/plugins/cloudflare-wasm.ts +141 -0
  1194. package/src/plugins/content.ts +31 -2
  1195. package/src/plugins/dev-await.ts +415 -0
  1196. package/src/plugins/dev-discovery.ts +428 -0
  1197. package/src/plugins/dev-hostname.ts +322 -0
  1198. package/src/plugins/dev-server.ts +471 -100
  1199. package/src/plugins/dev-store-clear.ts +145 -0
  1200. package/src/plugins/encryption-runtime.ts +31 -0
  1201. package/src/plugins/entries.ts +158 -17
  1202. package/src/plugins/fonts.ts +260 -657
  1203. package/src/plugins/graph-endpoint.ts +544 -0
  1204. package/src/plugins/mdx.ts +108 -35
  1205. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1206. package/src/plugins/optimize-package-imports.ts +439 -0
  1207. package/src/plugins/orphaned-modules.ts +78 -0
  1208. package/src/plugins/post-build.ts +327 -0
  1209. package/src/plugins/prebuilt-capture.ts +213 -0
  1210. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1211. package/src/plugins/prebuilt.ts +679 -0
  1212. package/src/plugins/prerender-sugar.ts +348 -0
  1213. package/src/plugins/react-resolve.ts +149 -0
  1214. package/src/plugins/request-dep/analysis.ts +447 -0
  1215. package/src/plugins/request-dep/index.ts +376 -0
  1216. package/src/plugins/request-dep/origin.ts +310 -0
  1217. package/src/plugins/routing.ts +296 -278
  1218. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1219. package/src/plugins/server-bundle.ts +115 -15
  1220. package/src/plugins/shims.ts +257 -97
  1221. package/src/plugins/static-build.ts +681 -71
  1222. package/src/react-canary.d.ts +2 -0
  1223. package/src/routing/codegen-shared.ts +39 -0
  1224. package/src/routing/codegen-types.ts +62 -0
  1225. package/src/routing/codegen-write.ts +163 -0
  1226. package/src/routing/codegen.ts +349 -232
  1227. package/src/routing/collision-probe.ts +438 -0
  1228. package/src/routing/collision-spaces.ts +281 -0
  1229. package/src/routing/convention-lint.ts +649 -0
  1230. package/src/routing/export-detect.ts +536 -0
  1231. package/src/routing/file-cache.ts +23 -0
  1232. package/src/routing/index.ts +16 -7
  1233. package/src/routing/interception-overlap.ts +141 -0
  1234. package/src/routing/interception.ts +1044 -67
  1235. package/src/routing/link-codegen.ts +280 -0
  1236. package/src/routing/manifest-codegen.ts +232 -0
  1237. package/src/routing/scanner.ts +417 -223
  1238. package/src/routing/schema-validation.ts +155 -0
  1239. package/src/routing/segment-classify.ts +280 -0
  1240. package/src/routing/segment-codegen.ts +99 -0
  1241. package/src/routing/segment-keys.ts +186 -0
  1242. package/src/routing/slot-placement.ts +97 -0
  1243. package/src/routing/types.ts +82 -26
  1244. package/src/routing/walkers.ts +98 -0
  1245. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1246. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1247. package/src/rsc-runtime/render-flight.ts +26 -0
  1248. package/src/rsc-runtime/rsc.ts +35 -5
  1249. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1250. package/src/rsc-runtime/server-references.ts +135 -0
  1251. package/src/rsc-runtime/ssr.ts +23 -0
  1252. package/src/rsc-runtime/transforms.ts +13 -0
  1253. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1254. package/src/schema-bridge.ts +437 -0
  1255. package/src/search-params/define.ts +676 -0
  1256. package/src/search-params/index.ts +14 -20
  1257. package/src/search-params/parse-total.ts +91 -0
  1258. package/src/search-params/serialize-equal.ts +14 -0
  1259. package/src/search-params/wrappers.ts +150 -0
  1260. package/src/server/abort-scope.ts +49 -0
  1261. package/src/server/access-gate.tsx +208 -57
  1262. package/src/server/action-client.ts +175 -294
  1263. package/src/server/action-encryption.ts +144 -0
  1264. package/src/server/action-handler.ts +533 -150
  1265. package/src/server/action-schema.ts +203 -0
  1266. package/src/server/action-types.ts +145 -0
  1267. package/src/server/actions.ts +172 -85
  1268. package/src/server/als-registry.ts +245 -30
  1269. package/src/server/body-limits.ts +10 -2
  1270. package/src/server/build-manifest.ts +33 -57
  1271. package/src/server/canonicalize.ts +62 -3
  1272. package/src/server/chain-url-parts.ts +163 -0
  1273. package/src/server/children-interception.ts +116 -0
  1274. package/src/server/client-error-message.ts +18 -0
  1275. package/src/server/coalesce-tick.ts +75 -0
  1276. package/src/server/compress.ts +91 -19
  1277. package/src/server/cookie-context.ts +462 -0
  1278. package/src/server/cookie-parsing.ts +163 -0
  1279. package/src/server/csp-nonce.ts +58 -0
  1280. package/src/server/csrf.ts +238 -37
  1281. package/src/server/debug.ts +0 -1
  1282. package/src/server/default-logger.ts +100 -0
  1283. package/src/server/default-status-page.ts +88 -0
  1284. package/src/server/deny-boundary.ts +527 -0
  1285. package/src/server/deny-renderer.ts +210 -181
  1286. package/src/server/early-hints-sender.ts +4 -3
  1287. package/src/server/early-hints.ts +39 -29
  1288. package/src/server/error-boundary-wrapper.ts +160 -44
  1289. package/src/server/error-response-headers.ts +18 -0
  1290. package/src/server/fallback-error.ts +88 -104
  1291. package/src/server/flight-injection-state.ts +113 -0
  1292. package/src/server/flight-injector-core.ts +332 -0
  1293. package/src/server/flight-scripts.ts +92 -0
  1294. package/src/server/flight-source-node.ts +434 -0
  1295. package/src/server/flight-source.ts +289 -0
  1296. package/src/server/form-data.ts +191 -20
  1297. package/src/server/form-state-flight.ts +67 -0
  1298. package/src/server/head-response.ts +50 -0
  1299. package/src/server/html-injector-core.ts +320 -0
  1300. package/src/server/html-injectors.ts +241 -285
  1301. package/src/server/index.ts +42 -195
  1302. package/src/server/instrumentation.ts +42 -11
  1303. package/src/server/interception-gates.ts +94 -0
  1304. package/src/server/internal.ts +164 -0
  1305. package/src/server/json-status-response.ts +105 -0
  1306. package/src/server/logger.ts +163 -38
  1307. package/src/server/metadata-collector.ts +175 -0
  1308. package/src/server/metadata-platform.ts +2 -2
  1309. package/src/server/metadata-render.ts +30 -8
  1310. package/src/server/metadata-route-links.ts +200 -0
  1311. package/src/server/metadata-routes.ts +114 -24
  1312. package/src/server/metadata-social.ts +2 -2
  1313. package/src/server/metadata.ts +23 -2
  1314. package/src/server/middleware-runner.ts +32 -5
  1315. package/src/server/node-body-response.ts +236 -0
  1316. package/src/server/node-response.ts +93 -0
  1317. package/src/server/node-stream-transforms.ts +340 -0
  1318. package/src/server/node-streams-platform.ts +23 -0
  1319. package/src/server/param-coercion.ts +223 -0
  1320. package/src/server/pipeline-helpers.ts +554 -0
  1321. package/src/server/pipeline-interception.ts +301 -32
  1322. package/src/server/pipeline-metadata-route.ts +242 -0
  1323. package/src/server/pipeline-metadata.ts +30 -4
  1324. package/src/server/pipeline-outcome.ts +290 -0
  1325. package/src/server/pipeline-phases.ts +443 -0
  1326. package/src/server/pipeline.ts +474 -427
  1327. package/src/server/port-resolution.ts +43 -0
  1328. package/src/server/prebuilt/cache-key.ts +340 -0
  1329. package/src/server/prebuilt/capture-render.ts +122 -0
  1330. package/src/server/prebuilt/capture-routes.ts +104 -0
  1331. package/src/server/prebuilt/capture-state.ts +196 -0
  1332. package/src/server/prebuilt/dev-store.ts +252 -0
  1333. package/src/server/prebuilt/lifetime.ts +151 -0
  1334. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1335. package/src/server/prebuilt/overlay.ts +290 -0
  1336. package/src/server/prebuilt/payload-source.ts +221 -0
  1337. package/src/server/prebuilt/slots.ts +201 -0
  1338. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1339. package/src/server/prebuilt-builder.ts +515 -0
  1340. package/src/server/prebuilt-runtime.ts +830 -0
  1341. package/src/server/primitives.ts +167 -171
  1342. package/src/server/publish-params.ts +42 -0
  1343. package/src/server/react-cache-bridge.ts +124 -0
  1344. package/src/server/react-cache-scope.ts +104 -0
  1345. package/src/server/render-timeout.ts +123 -0
  1346. package/src/server/render-utils.ts +70 -0
  1347. package/src/server/request-context.ts +321 -323
  1348. package/src/server/request-dep.ts +37 -0
  1349. package/src/server/response-cache-policy.ts +45 -0
  1350. package/src/server/response-framing.ts +59 -0
  1351. package/src/server/route-element-builder.ts +539 -355
  1352. package/src/server/route-element-helpers.ts +37 -0
  1353. package/src/server/route-handler.ts +78 -48
  1354. package/src/server/route-matcher.ts +251 -265
  1355. package/src/server/route-methods.ts +37 -0
  1356. package/src/server/route-module-loader.ts +161 -0
  1357. package/src/server/rsc-cache-key-guard.ts +122 -0
  1358. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1359. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1360. package/src/server/rsc-entry/api-handler.ts +30 -93
  1361. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1362. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1363. package/src/server/rsc-entry/helpers.ts +90 -115
  1364. package/src/server/rsc-entry/index.ts +417 -350
  1365. package/src/server/rsc-entry/render-route.ts +248 -0
  1366. package/src/server/rsc-entry/render-signals.ts +108 -0
  1367. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1368. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1369. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1370. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1371. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1372. package/src/server/rsc-error-envelope.ts +18 -0
  1373. package/src/server/rsc-prop-warnings.ts +1 -1
  1374. package/src/server/safe-load.ts +53 -0
  1375. package/src/server/schema-introspection.ts +393 -0
  1376. package/src/server/sensitive-fields.ts +287 -0
  1377. package/src/server/server-only-guard-noop.js +3 -0
  1378. package/src/server/server-timing.ts +1 -1
  1379. package/src/server/signal-identity.ts +130 -0
  1380. package/src/server/sitemap-generator.ts +337 -0
  1381. package/src/server/sitemap-handler.ts +150 -0
  1382. package/src/server/skippable-prefix.ts +172 -0
  1383. package/src/server/slot-interception.ts +168 -0
  1384. package/src/server/slot-resolver.ts +747 -300
  1385. package/src/server/slot-subtree-contain.ts +273 -0
  1386. package/src/server/ssr-bridge-types.ts +217 -0
  1387. package/src/server/ssr-entry.ts +246 -109
  1388. package/src/server/ssr-form-state.ts +58 -0
  1389. package/src/server/ssr-render.ts +253 -113
  1390. package/src/server/ssr-wrappers.tsx +152 -0
  1391. package/src/server/state-tree-diff.ts +85 -30
  1392. package/src/server/static-generator.ts +680 -0
  1393. package/src/server/static-not-found.ts +134 -0
  1394. package/src/server/status-code-resolver.ts +107 -148
  1395. package/src/server/stream-utils.ts +398 -0
  1396. package/src/server/traced-access.ts +50 -0
  1397. package/src/server/tracing.ts +274 -128
  1398. package/src/server/tree-match.ts +494 -0
  1399. package/src/server/types.ts +97 -11
  1400. package/src/server/utils/element-type.ts +88 -0
  1401. package/src/server/utils/escape-html.ts +20 -0
  1402. package/src/server/version-skew.ts +104 -0
  1403. package/src/server/waituntil-bridge.ts +1 -1
  1404. package/src/server/workers-cache-bridge.ts +33 -0
  1405. package/src/shared/als-slots.ts +74 -0
  1406. package/src/shared/base-path.ts +80 -0
  1407. package/src/shared/csrf-reject.ts +15 -0
  1408. package/src/shared/dev-span.ts +188 -0
  1409. package/src/shared/error-digest.ts +46 -0
  1410. package/src/shared/flight-base64.ts +23 -0
  1411. package/src/shared/flight-segment.ts +35 -0
  1412. package/src/shared/form-state-flight.ts +59 -0
  1413. package/src/shared/href-validation.ts +159 -0
  1414. package/src/shared/merge-search-params.ts +55 -0
  1415. package/src/shared/param-value.ts +281 -0
  1416. package/src/shared/payload-root.ts +153 -0
  1417. package/src/shared/redirect-type.ts +17 -0
  1418. package/src/shared/rsc-cache-key.ts +269 -0
  1419. package/src/shared/rsc-error-envelope.ts +16 -0
  1420. package/src/shared/rsc-manifest.ts +29 -0
  1421. package/src/shared/rsc-media-type.ts +59 -0
  1422. package/src/shared/rsc-payload-path.ts +52 -0
  1423. package/src/shared/segment-info.ts +67 -0
  1424. package/src/shared/slot-params.ts +109 -0
  1425. package/src/shared/static-platform-files.ts +75 -0
  1426. package/src/shared/status-reason-phrase.ts +61 -0
  1427. package/src/shims/font-google.ts +1 -1
  1428. package/src/shims/font-local.ts +34 -0
  1429. package/src/shims/headers.ts +130 -1
  1430. package/src/shims/navigation-client.ts +36 -32
  1431. package/src/shims/navigation-rsc.ts +47 -0
  1432. package/src/shims/navigation.ts +10 -7
  1433. package/src/utils/state-machine.ts +111 -0
  1434. package/src/utils/write-file-atomic.ts +32 -0
  1435. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1436. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1437. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1438. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1439. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1440. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1441. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1442. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1443. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1444. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1445. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1446. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1447. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1448. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1449. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1450. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1451. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1452. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1453. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1454. package/dist/adapters/cloudflare.js.map +0 -1
  1455. package/dist/cache/index.js.map +0 -1
  1456. package/dist/cache/register-cached-function.d.ts +0 -17
  1457. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1458. package/dist/client/browser-entry.d.ts +0 -21
  1459. package/dist/client/browser-entry.d.ts.map +0 -1
  1460. package/dist/client/error-boundary.js.map +0 -1
  1461. package/dist/client/head.d.ts +0 -16
  1462. package/dist/client/head.d.ts.map +0 -1
  1463. package/dist/client/link-status-provider.d.ts +0 -11
  1464. package/dist/client/link-status-provider.d.ts.map +0 -1
  1465. package/dist/client/segment-merger.d.ts +0 -119
  1466. package/dist/client/segment-merger.d.ts.map +0 -1
  1467. package/dist/client/stale-reload.d.ts +0 -44
  1468. package/dist/client/stale-reload.d.ts.map +0 -1
  1469. package/dist/client/transition-root.d.ts +0 -74
  1470. package/dist/client/transition-root.d.ts.map +0 -1
  1471. package/dist/client/types.d.ts +0 -14
  1472. package/dist/client/types.d.ts.map +0 -1
  1473. package/dist/client/use-navigation-pending.d.ts +0 -26
  1474. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1475. package/dist/client/use-params.d.ts +0 -92
  1476. package/dist/client/use-params.d.ts.map +0 -1
  1477. package/dist/content/index.d.ts +0 -11
  1478. package/dist/content/index.d.ts.map +0 -1
  1479. package/dist/content/index.js +0 -2
  1480. package/dist/plugins/adapter-build.d.ts +0 -18
  1481. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1482. package/dist/plugins/cache-transform.d.ts +0 -36
  1483. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1484. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1485. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1486. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1487. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1488. package/dist/plugins/server-action-exports.d.ts +0 -26
  1489. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1490. package/dist/routing/status-file-lint.d.ts +0 -33
  1491. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1492. package/dist/search-params/analyze.d.ts +0 -54
  1493. package/dist/search-params/analyze.d.ts.map +0 -1
  1494. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1495. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1496. package/dist/search-params/codecs.d.ts +0 -53
  1497. package/dist/search-params/codecs.d.ts.map +0 -1
  1498. package/dist/search-params/create.d.ts +0 -106
  1499. package/dist/search-params/create.d.ts.map +0 -1
  1500. package/dist/search-params/registry.d.ts +0 -20
  1501. package/dist/search-params/registry.d.ts.map +0 -1
  1502. package/dist/server/asset-headers.d.ts +0 -42
  1503. package/dist/server/asset-headers.d.ts.map +0 -1
  1504. package/dist/server/client-module-map.d.ts +0 -47
  1505. package/dist/server/client-module-map.d.ts.map +0 -1
  1506. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1507. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1508. package/dist/server/dev-logger.d.ts.map +0 -1
  1509. package/dist/server/dev-span-processor.d.ts +0 -29
  1510. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1511. package/dist/server/dev-warnings.d.ts +0 -129
  1512. package/dist/server/dev-warnings.d.ts.map +0 -1
  1513. package/dist/server/flush.d.ts +0 -74
  1514. package/dist/server/flush.d.ts.map +0 -1
  1515. package/dist/server/form-flash.d.ts +0 -78
  1516. package/dist/server/form-flash.d.ts.map +0 -1
  1517. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1518. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1519. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1520. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1521. package/dist/server/prerender.d.ts +0 -77
  1522. package/dist/server/prerender.d.ts.map +0 -1
  1523. package/dist/server/tree-builder.d.ts +0 -126
  1524. package/dist/server/tree-builder.d.ts.map +0 -1
  1525. package/dist/utils/directive-parser.d.ts +0 -70
  1526. package/dist/utils/directive-parser.d.ts.map +0 -1
  1527. package/src/cache/register-cached-function.ts +0 -103
  1528. package/src/client/browser-entry.ts +0 -678
  1529. package/src/client/head.ts +0 -61
  1530. package/src/client/link-status-provider.tsx +0 -30
  1531. package/src/client/segment-merger.ts +0 -339
  1532. package/src/client/stale-reload.ts +0 -87
  1533. package/src/client/transition-root.tsx +0 -166
  1534. package/src/client/types.ts +0 -21
  1535. package/src/client/use-navigation-pending.ts +0 -38
  1536. package/src/client/use-params.ts +0 -141
  1537. package/src/content/index.ts +0 -13
  1538. package/src/plugins/adapter-build.ts +0 -118
  1539. package/src/plugins/cache-transform.ts +0 -199
  1540. package/src/plugins/dynamic-transform.ts +0 -161
  1541. package/src/plugins/server-action-exports.ts +0 -220
  1542. package/src/routing/status-file-lint.ts +0 -112
  1543. package/src/search-params/analyze.ts +0 -192
  1544. package/src/search-params/builtin-codecs.ts +0 -228
  1545. package/src/search-params/codecs.ts +0 -153
  1546. package/src/search-params/create.ts +0 -321
  1547. package/src/search-params/registry.ts +0 -31
  1548. package/src/server/asset-headers.ts +0 -81
  1549. package/src/server/client-module-map.ts +0 -58
  1550. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1551. package/src/server/dev-span-processor.ts +0 -78
  1552. package/src/server/dev-warnings.ts +0 -283
  1553. package/src/server/flush.ts +0 -182
  1554. package/src/server/form-flash.ts +0 -89
  1555. package/src/server/manifest-status-resolver.ts +0 -215
  1556. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1557. package/src/server/prerender.ts +0 -139
  1558. package/src/server/tree-builder.ts +0 -382
  1559. package/src/shims/server-only-noop.js +0 -6
  1560. package/src/utils/directive-parser.ts +0 -529
@@ -16,33 +16,81 @@
16
16
  * See design/02-rendering-pipeline.md §"Parallel Slots"
17
17
  */
18
18
 
19
- import { TimberErrorBoundary } from '#/client/error-boundary.js';
20
- import SlotErrorFallback from '#/client/slot-error-fallback.js';
21
- import { SlotAccessGate } from './access-gate.js';
22
- import { wrapSegmentWithErrorBoundaries } from './error-boundary-wrapper.js';
23
- import type { InterceptionContext, RouteMatch } from './pipeline.js';
24
- import { DenySignal } from './primitives.js';
25
- import type { ManifestSegmentNode } from './route-matcher.js';
19
+ import { TimberErrorBoundary } from '../client/error-boundary.tsx';
20
+ import SlotErrorFallback from '../client/slot-error-fallback.tsx';
21
+ import { SlotAccessGate } from './access-gate.tsx';
22
+ import { wrapSegmentWithErrorBoundaries } from './error-boundary-wrapper.ts';
23
+ import { isClientReference } from './utils/element-type.ts';
24
+ import { containSlotSubtree } from './slot-subtree-contain.ts';
25
+ import { loadModule, type ManifestLoader } from './safe-load.ts';
26
+ import type { InterceptionContext, RouteMatch } from './pipeline.ts';
27
+ import { isDenySignal, isRedirectSignal } from './signal-identity.ts';
28
+ import { traceCall, withSpan } from './tracing.ts';
29
+ import { loadFallbackModule, reportRenderError } from './pipeline-helpers.ts';
30
+ import type { ManifestSegmentNode } from './route-matcher.ts';
31
+ import { setSlotParams, runWithSlotSegmentParams } from './request-context.ts';
32
+ import { coerceSlotParams } from './param-coercion.ts';
33
+ import type { CoercedParams } from '../shared/param-value.ts';
34
+ import { matchUrlParts } from './tree-match.ts';
35
+ import { extractUrlParts, consumedPartsThroughSegment } from './chain-url-parts.ts';
36
+ import { findInterceptingMatch } from './slot-interception.ts';
37
+ import { SegmentOutlet } from '../client/segment-outlet.tsx';
38
+ import { shouldSkipSlot, type ClientStateTree } from './state-tree-diff.ts';
39
+ import { computeSlotKey, computeSlotContentKey } from '../routing/segment-keys.ts';
40
+ import { isStaticRequestDependent } from './request-dep.ts';
26
41
 
27
42
  type CreateElementFn = (...args: unknown[]) => React.ReactElement;
28
43
 
44
+ // ─── Module Loading Helpers ─────────────────────────────────────────────────
45
+
46
+ /**
47
+ * Load a module and extract its default export as a component function.
48
+ * Returns undefined if no default export exists.
49
+ */
50
+ async function loadComponent(loader: {
51
+ load: () => Promise<unknown>;
52
+ filePath: string;
53
+ }): Promise<((...args: unknown[]) => unknown) | undefined> {
54
+ const mod = await loadModule(loader);
55
+ return mod.default as ((...args: unknown[]) => unknown) | undefined;
56
+ }
57
+
58
+ /**
59
+ * Load and render the default.tsx fallback for a slot node.
60
+ * Returns null if the slot has no default.tsx or it has no default export.
61
+ */
62
+ async function renderDefaultFallback(
63
+ slotNode: ManifestSegmentNode,
64
+ h: CreateElementFn
65
+ ): Promise<React.ReactElement | null> {
66
+ if (!slotNode.default) return null;
67
+ const DefaultComp = await loadComponent(slotNode.default);
68
+ if (!DefaultComp) return null;
69
+ return h(DefaultComp, {});
70
+ }
71
+
72
+ // ─── Slot Element Resolution ────────────────────────────────────────────────
73
+
29
74
  /**
30
75
  * Resolve the element for a parallel slot.
31
76
  *
32
77
  * Finds a matching page in the slot's sub-tree for the current route.
33
78
  * Falls back to default.tsx if no match, or null if no default.
34
79
  *
35
- * When a match is found, the element is wrapped with:
36
- * 1. Error boundaries from each segment in the slot's matched chain
37
- * 2. Layouts from each segment in the slot's matched chain
38
- * 3. SlotAccessGate if the slot root has access.ts
80
+ * When a match is found, the element is wrapped per segment in the slot's
81
+ * matched chain with (innermost → outermost):
82
+ * 1. Error boundaries
83
+ * 2. Layout
84
+ * 3. SlotAccessGate if the segment has access.ts (gate OUTSIDE the layout,
85
+ * so a denied layout never executes — see TIM-1074)
39
86
  */
40
87
  export async function resolveSlotElement(
41
88
  slotNode: ManifestSegmentNode,
42
89
  match: RouteMatch,
43
- paramsPromise: Promise<Record<string, string | string[]>>,
44
90
  h: CreateElementFn,
45
- interception?: InterceptionContext
91
+ req: Request,
92
+ interception?: InterceptionContext,
93
+ parentTreePath?: string
46
94
  ): Promise<React.ReactElement | null> {
47
95
  // When interception is active, try to match intercepting children in this
48
96
  // slot against the target pathname. If an intercepting child matches, render
@@ -54,133 +102,130 @@ export async function resolveSlotElement(
54
102
  : findSlotMatch(slotNode, match);
55
103
 
56
104
  if (slotMatch) {
57
- const mod = (await slotMatch.page.load()) as Record<string, unknown>;
58
- if (mod.default) {
59
- const SlotPage = mod.default as (...args: unknown[]) => unknown;
105
+ // Coerce the slot's own chain params through the global schema codecs
106
+ // (same as the main route) and expose them two ways:
107
+ //
108
+ // - keyed, in the ALS slot map, so `getSegmentParams(slotPath)` resolves
109
+ // from anywhere in the request;
110
+ // - scoped, around every component this resolver invokes from the slot's
111
+ // matched chain, so a no-arg `getSegmentParams()` inside the slot
112
+ // returns the slot's params instead of the main route's. An
113
+ // intercepting page has no other way to see its own params: the
114
+ // pipeline re-matched the SOURCE pathname, so the main params describe
115
+ // the page rendering *behind* the modal (TIM-1283).
116
+ //
117
+ // Both derive from the same coerced record, so the keyed overload and the
118
+ // no-arg call inside the slot can never disagree.
119
+ const coerced = coerceSlotParams(slotMatch.chain, slotMatch.slotParams);
120
+ const fullSlotPath = computeSlotSegmentPath(slotMatch.chain, parentTreePath);
121
+
122
+ if (fullSlotPath && Object.keys(coerced).length > 0) {
123
+ setSlotParams(fullSlotPath, coerced);
124
+ }
125
+ const scope = <T>(fn: () => T): T => runWithSlotSegmentParams(fullSlotPath, coerced, fn);
60
126
 
127
+ const SlotPage = await loadComponent(slotMatch.page);
128
+ if (SlotPage) {
61
129
  // Load default.tsx fallback for notFound() handling in the slot page.
62
130
  // When a slot page calls notFound() or deny(), it should gracefully
63
131
  // degrade to default.tsx or null — not crash the page. This matches
64
132
  // Next.js behavior. See design/02-rendering-pipeline.md
65
133
  // §"Slot Access Failure = Graceful Degradation"
66
- let denyFallback: React.ReactElement | null = null;
67
- if (slotNode.default) {
68
- const defaultMod = (await slotNode.default.load()) as Record<string, unknown>;
69
- const DefaultComp = defaultMod.default as ((...args: unknown[]) => unknown) | undefined;
70
- if (DefaultComp) {
71
- denyFallback = h(DefaultComp, { params: paramsPromise, searchParams: {} });
72
- }
73
- }
74
-
75
- // Wrap the slot page to catch DenySignal (from notFound() or deny())
76
- // at the component level. This prevents the signal from reaching the
77
- // RSC onError callback and being tracked as a page-level denial, which
78
- // would cause the pipeline to replace the entire successful SSR response
79
- // with a deny page. Instead, the slot gracefully degrades.
80
- const denyFallbackCapture = denyFallback;
81
- const SafeSlotPage = async (props: Record<string, unknown>) => {
82
- try {
83
- return await (SlotPage as (props: Record<string, unknown>) => unknown)(props);
84
- } catch (error) {
85
- if (error instanceof DenySignal) {
86
- return denyFallbackCapture;
87
- }
88
- throw error;
89
- }
90
- };
91
-
92
- let element: React.ReactElement = h(SafeSlotPage, {
93
- params: paramsPromise,
94
- searchParams: {},
95
- });
96
-
97
- // Wrap with error boundaries and layouts from intermediate slot segments
98
- // (everything between slot root and leaf). Process innermost-first, same
99
- // order as route-element-builder.ts handles main segments. The slot root
100
- // (index 0) is handled separately after the access gate below.
101
- for (let i = slotMatch.chain.length - 1; i > 0; i--) {
102
- const seg = slotMatch.chain[i];
103
-
104
- // Error boundaries from this segment
105
- element = await wrapSegmentWithErrorBoundaries(seg, element, h);
106
-
107
- // Layout from this segment
108
- if (seg.layout) {
109
- const layoutMod = (await seg.layout.load()) as Record<string, unknown>;
110
- if (layoutMod.default) {
111
- const Layout = layoutMod.default as (...args: unknown[]) => unknown;
112
- element = h(Layout, {
113
- params: paramsPromise,
114
- searchParams: {},
115
- children: element,
116
- });
117
- }
118
- }
119
- }
120
-
121
- // Wrap in SlotAccessGate if slot root has access.ts.
122
- // On denial: denied.tsx → default.tsx → null (graceful degradation).
123
- // See design/04-authorization.md §"Slot-Level Auth".
124
- if (slotNode.access) {
125
- const accessMod = (await slotNode.access.load()) as Record<string, unknown>;
126
- const accessFn = accessMod.default as
127
- | ((ctx: { params: Record<string, string | string[]>; searchParams: unknown }) => unknown)
128
- | undefined;
129
- if (accessFn) {
130
- // Load denied.tsx fallback
131
- let deniedFallback: React.ReactElement | null = null;
132
- if (slotNode.denied) {
133
- const deniedMod = (await slotNode.denied.load()) as Record<string, unknown>;
134
- const DeniedComponent = deniedMod.default as
135
- | ((...args: unknown[]) => unknown)
136
- | undefined;
137
- if (DeniedComponent) {
138
- deniedFallback = h(DeniedComponent, {});
134
+ const denyFallback = await renderDefaultFallback(slotNode, h);
135
+
136
+ // Build the slot page element.
137
+ // Client references ('use client' pages) must NOT be called as functions —
138
+ // they are proxy objects that throw when invoked. For client references,
139
+ // use createElement directly. Error catching is unnecessary because client
140
+ // references are serialized as references in the RSC Flight stream — they
141
+ // don't execute on the server. See TIM-627.
142
+ //
143
+ // For server components, wrap in SafeSlotPage to catch ALL errors at the
144
+ // component level. This prevents errors from leaving unresolved Flight
145
+ // rows in the RSC stream — see TIM-524 for details.
146
+ //
147
+ // The catch below covers the page function. The tree it RETURNS is
148
+ // contained separately (`containSlotSubtree`): a server component
149
+ // nested in that tree runs as its own Flight task, outside this
150
+ // try/catch, and a deny there would otherwise reach Flight's global
151
+ // onError as a page-level 4xx. See slot-subtree-contain.ts, TIM-1450.
152
+ let element: React.ReactElement;
153
+ if (isClientReference(SlotPage)) {
154
+ element = h(SlotPage, {});
155
+ } else {
156
+ // Same `timber.page` span as a main-route page, tagged with the slot
157
+ // so a slow `@slot` page is attributed to itself in a trace rather
158
+ // than hiding inside its parent layout's span.
159
+ const leaf = slotMatch.chain[slotMatch.chain.length - 1];
160
+ const spanAttributes = slotSpanAttributes('timber.route', leaf, slotNode);
161
+ const SafeSlotPage = async (props: Record<string, unknown>) => {
162
+ try {
163
+ const rendered = await withSpan('timber.page', spanAttributes, () =>
164
+ scope(() => (SlotPage as (props: Record<string, unknown>) => unknown)(props))
165
+ );
166
+ return containSlotSubtree(rendered as React.ReactNode, denyFallback);
167
+ } catch (error) {
168
+ // RedirectSignal must propagate — the pipeline handles redirects
169
+ // at the top level. Swallowing it here would silently return
170
+ // fallback content instead of redirecting. See TIM-554.
171
+ if (isRedirectSignal(error)) {
172
+ throw error;
139
173
  }
140
- }
141
-
142
- // Load default.tsx fallback
143
- let defaultFallback: React.ReactElement | null = null;
144
- if (slotNode.default) {
145
- const defaultMod = (await slotNode.default.load()) as Record<string, unknown>;
146
- const DefaultComp = defaultMod.default as ((...args: unknown[]) => unknown) | undefined;
147
- if (DefaultComp) {
148
- defaultFallback = h(DefaultComp, { params: paramsPromise, searchParams: {} });
174
+ if (isDenySignal(error)) {
175
+ return denyFallback;
149
176
  }
177
+ // Report the error but don't re-throw — returning fallback ensures
178
+ // the Flight row is resolved and the page hydrates correctly.
179
+ // Nothing downstream sees it, so this is its one report.
180
+ reportRenderError(error, req, { segments: match.segments });
181
+ return denyFallback;
150
182
  }
151
-
152
- const params = await paramsPromise;
153
- element = h(SlotAccessGate, {
154
- accessFn,
155
- params,
156
- searchParams: {},
157
- deniedFallback,
158
- defaultFallback,
159
- children: element,
160
- });
161
- }
183
+ };
184
+ element = h(SafeSlotPage, {});
162
185
  }
163
186
 
164
- // Wrap with slot root's layout (outermost, outside access gate)
165
- if (slotNode.layout) {
166
- const layoutMod = (await slotNode.layout.load()) as Record<string, unknown>;
167
- if (layoutMod.default) {
168
- const Layout = layoutMod.default as (...args: unknown[]) => unknown;
169
- element = h(Layout, {
170
- params: paramsPromise,
171
- searchParams: {},
172
- children: element,
173
- });
174
- }
175
- }
176
-
177
- // Wrap with slot root's error boundaries (outermost)
178
- element = await wrapSegmentWithErrorBoundaries(slotNode, element, h);
187
+ // Wrap with error boundaries, layouts, and access gates from
188
+ // intermediate slot segments (everything between slot root and leaf).
189
+ // Process innermost-first, same order as route-element-builder.ts
190
+ // handles main segments. The slot root (index 0) is handled below.
191
+ element = await wrapWithIntermediateSegments(
192
+ slotMatch.chain,
193
+ slotNode,
194
+ element,
195
+ h,
196
+ req,
197
+ scope,
198
+ denyFallback
199
+ );
200
+
201
+ // Wrap with slot root's layout — INSIDE the access gate, so the layout
202
+ // server component never executes when access.ts denies. See TIM-1074.
203
+ element = await wrapWithLayout(slotNode, slotNode, element, h, scope, denyFallback);
204
+
205
+ // Wrap in SlotAccessGate if slot root has access.ts. The gate is
206
+ // OUTSIDE the layout, matching the segment model in
207
+ // route-element-builder.ts: a denied layout must not render, or it
208
+ // would fetch/serialize protected data into the RSC Flight stream.
209
+ // On denial: denied.tsx → default.tsx → null (graceful degradation),
210
+ // rendered WITHOUT the denied slot's own layout.
211
+ // See design/04-authorization.md §"Slot-Level Auth".
212
+ element = await wrapWithAccessGate(slotNode, element, h, scope);
213
+
214
+ // Wrap with slot root's error boundaries (outermost). Slot identity on
215
+ // every one of them, not only the catch-all below: a slot's own
216
+ // status page must not set the document status or empty the main
217
+ // route's segment cache.
218
+ element = await wrapSegmentWithErrorBoundaries(slotNode, element, {
219
+ loadModule: (file: ManifestLoader) => loadFallbackModule(file, req, match.segments),
220
+ createElement: h,
221
+ errorBoundaryComponent: TimberErrorBoundary,
222
+ isSlotBoundary: true,
223
+ });
179
224
 
180
225
  // Catch-all error boundary: ensures slot errors NEVER propagate to the
181
226
  // parent layout. Without this, a slot without error.tsx that throws
182
227
  // causes SSR's renderToReadableStream to reject, triggering renderDenyPage
183
- // which re-executes all layout server components (including headers() calls
228
+ // which re-executes all layout server components (including getHeaders() calls
184
229
  // that fail in the SSR environment). The null fallback means the slot
185
230
  // degrades to nothing — consistent with the slot access denial behavior.
186
231
  // See design/02-rendering-pipeline.md §"Slot Access Failure = Graceful Degradation"
@@ -194,25 +239,232 @@ export async function resolveSlotElement(
194
239
  }
195
240
  }
196
241
 
197
- // No matching page — render default.tsx fallback
198
- if (slotNode.default) {
199
- const mod = (await slotNode.default.load()) as Record<string, unknown>;
200
- if (mod.default) {
201
- const DefaultComponent = mod.default as (...args: unknown[]) => unknown;
202
- return h(DefaultComponent, { params: paramsPromise, searchParams: {} });
203
- }
242
+ // No matching page — render default.tsx fallback.
243
+ // Per design/02-rendering-pipeline.md: "No access check for default.tsx."
244
+ // Access verdicts from the eager evaluation are not applied here.
245
+ // Pass taintKey so accessor calls inside default.tsx are scoped to this
246
+ return renderDefaultFallback(slotNode, h);
247
+ }
248
+
249
+ /**
250
+ * The full tree path of a slot's matched chain — the key both the ALS slot
251
+ * params map and the generated `getSegmentParams` overloads use.
252
+ *
253
+ * Built from the parent's tree path plus each chain node's directory name,
254
+ * so an intercepting node contributes its marker
255
+ * (`/gallery/@modal/(.)photo/[id]`) and a route group contributes its
256
+ * parentheses. Returns undefined when the caller has no parent tree path,
257
+ * which is how the resolver's test callers and any path-less entry point opt
258
+ * out of keyed lookups.
259
+ *
260
+ * One definition for both the render path and the eager access path: they
261
+ * key the same map, and a divergence would silently strand one of them.
262
+ */
263
+ function computeSlotSegmentPath(
264
+ chain: ManifestSegmentNode[],
265
+ parentTreePath: string | undefined
266
+ ): string | undefined {
267
+ if (!parentTreePath) return undefined;
268
+ const slotSuffix = chain
269
+ .map((s) => s.segmentName)
270
+ .filter(Boolean)
271
+ .join('/');
272
+ const prefix = parentTreePath === '/' ? '' : parentTreePath;
273
+ return `${prefix}/${slotSuffix}`;
274
+ }
275
+
276
+ // ─── Element Wrapping Helpers ───────────────────────────────────────────────
277
+
278
+ /**
279
+ * Wrap an element with error boundaries, access gates, and layouts from
280
+ * intermediate slot segments (indices 1..n, skipping the slot root at index 0).
281
+ * Processes innermost-first to match route-element-builder.ts ordering.
282
+ *
283
+ * Access gates are enforced for every intermediate segment that has access.ts,
284
+ * not just the slot root. Without this, nested slot children (e.g.,
285
+ * @admin/reports/access.ts) and intercepting route children with access.ts
286
+ * would bypass authorization. See TIM-999.
287
+ *
288
+ * Wrap order per segment (innermost → outermost): error boundaries → layout
289
+ * → access gate. The gate must be OUTSIDE the layout so a denying access.ts
290
+ * prevents the layout server component from executing — otherwise the layout
291
+ * would fetch/serialize protected data into the RSC Flight stream. Matches
292
+ * route-element-builder.ts. See TIM-1074.
293
+ */
294
+ async function wrapWithIntermediateSegments(
295
+ chain: ManifestSegmentNode[],
296
+ slotNode: ManifestSegmentNode,
297
+ element: React.ReactElement,
298
+ h: CreateElementFn,
299
+ req: Request,
300
+ scope?: SlotParamScope,
301
+ denyFallback?: React.ReactNode
302
+ ): Promise<React.ReactElement> {
303
+ for (let i = chain.length - 1; i > 0; i--) {
304
+ const seg = chain[i];
305
+ element = await wrapSegmentWithErrorBoundaries(seg, element, {
306
+ loadModule: (file: ManifestLoader) => loadFallbackModule(file, req),
307
+ createElement: h,
308
+ errorBoundaryComponent: TimberErrorBoundary,
309
+ isSlotBoundary: true,
310
+ });
311
+ element = await wrapWithLayout(seg, slotNode, element, h, scope, denyFallback);
312
+ element = await wrapWithAccessGate(seg, element, h, scope);
313
+ }
314
+ return element;
315
+ }
316
+
317
+ /**
318
+ * Runs a function with the slot's own segment params in scope.
319
+ *
320
+ * Applied to every component this module invokes from a slot's matched chain
321
+ * — page, layouts, access functions — so all of them agree on what a no-arg
322
+ * `getSegmentParams()` means inside a slot. A partial application would be
323
+ * worse than none: a layout and the page under it would disagree about the
324
+ * params of the same render.
325
+ */
326
+ type SlotParamScope = <T>(fn: () => T) => T;
327
+
328
+ /**
329
+ * Invokes a slot layout inside that slot's param scope.
330
+ *
331
+ * Declared at module scope, and given the layout and the scope as props,
332
+ * so its component identity is the same on every render. A closure created
333
+ * per render would be a new component type each time, and React would
334
+ * unmount and remount the whole layout subtree — including client
335
+ * components' state — on every navigation that re-renders the slot.
336
+ *
337
+ * Server component: the function-valued props are called here on the server
338
+ * and never reach the Flight stream, the same way `SlotAccessGate` takes
339
+ * `accessFn`.
340
+ *
341
+ * The layout's own chrome is part of the slot's subtree, so the tree it
342
+ * returns is contained like the page's: a server component the layout
343
+ * renders beside `children` that denies becomes the slot fallback in place,
344
+ * not a page-level 4xx. `children` is the element the resolver built for the
345
+ * level below, already contained there, and is passed to the walk as the one
346
+ * subtree to leave alone. See slot-subtree-contain.ts.
347
+ */
348
+ function ScopedSlotLayout(props: {
349
+ layout: (props: Record<string, unknown>) => unknown;
350
+ scope: SlotParamScope;
351
+ denyFallback: React.ReactNode;
352
+ spanAttributes: Record<string, string>;
353
+ children: React.ReactElement;
354
+ }): unknown {
355
+ // `traceCall`, not `withSpan`: the layout runs in this frame, under React's
356
+ // render dispatcher, and a synchronous throw leaves synchronously — so a
357
+ // sync layout's `use()` can suspend and be retried by Flight. A promise an
358
+ // async layout returns goes to the walk, which turns a rejected deny into
359
+ // the slot's fallback; a synchronous deny gets the same answer here.
360
+ let rendered: unknown;
361
+ try {
362
+ rendered = traceCall('timber.layout', props.spanAttributes, () =>
363
+ props.scope(() => props.layout({ children: props.children }))
364
+ );
365
+ } catch (error) {
366
+ if (isDenySignal(error)) return props.denyFallback;
367
+ throw error;
368
+ }
369
+ return containSlotSubtree(rendered as React.ReactNode, props.denyFallback, props.children);
370
+ }
371
+
372
+ /**
373
+ * Span attributes for a component in a slot's matched chain: the segment's
374
+ * URL pattern under `routeKey` (`timber.route` for a page, `timber.segment`
375
+ * for a layout — the keys the main route's spans use) and the slot's
376
+ * directory name under `timber.slot`. A slot is transparent to the URL, so
377
+ * without `timber.slot` a slot page and the main page at the same pattern
378
+ * would be indistinguishable in a trace.
379
+ */
380
+ function slotSpanAttributes(
381
+ routeKey: 'timber.route' | 'timber.segment',
382
+ node: ManifestSegmentNode,
383
+ slotNode: ManifestSegmentNode
384
+ ): Record<string, string> {
385
+ return { [routeKey]: node.urlPath || '/', 'timber.slot': slotNode.segmentName };
386
+ }
387
+
388
+ /**
389
+ * Wrap an element with a segment's layout component, if present.
390
+ *
391
+ * A server-component layout is invoked through the slot param scope, so it
392
+ * sees the slot's params rather than the main route's — a layout and the
393
+ * page beneath it must not disagree about the params of one render. A
394
+ * client-reference layout is passed through untouched: it never executes on
395
+ * the server, and its params arrive over the client channel
396
+ * (`useSegmentParams`).
397
+ */
398
+ async function wrapWithLayout(
399
+ node: ManifestSegmentNode,
400
+ slotNode: ManifestSegmentNode,
401
+ element: React.ReactElement,
402
+ h: CreateElementFn,
403
+ scope?: SlotParamScope,
404
+ denyFallback: React.ReactNode = null
405
+ ): Promise<React.ReactElement> {
406
+ if (!node.layout) return element;
407
+ const Layout = await loadComponent(node.layout);
408
+ if (!Layout) return element;
409
+ if (!scope || isClientReference(Layout)) return h(Layout, { children: element });
410
+
411
+ return h(ScopedSlotLayout, {
412
+ layout: Layout as (props: Record<string, unknown>) => unknown,
413
+ scope,
414
+ denyFallback,
415
+ spanAttributes: slotSpanAttributes('timber.segment', node, slotNode),
416
+ children: element,
417
+ });
418
+ }
419
+
420
+ /**
421
+ * Wrap an element with a SlotAccessGate if the node has access.ts.
422
+ * On denial: denied.tsx → default.tsx → null (graceful degradation).
423
+ */
424
+ async function wrapWithAccessGate(
425
+ slotNode: ManifestSegmentNode,
426
+ element: React.ReactElement,
427
+ h: CreateElementFn,
428
+ scope?: SlotParamScope
429
+ ): Promise<React.ReactElement> {
430
+ if (!slotNode.access) return element;
431
+
432
+ const loaded = await loadComponent(slotNode.access);
433
+ if (!loaded) return element;
434
+
435
+ // The gate calls this during render, so the scope has to travel with the
436
+ // function rather than wrap the call site.
437
+ const accessFn = scope ? () => scope(() => loaded()) : loaded;
438
+
439
+ let DeniedComponent: ((...args: unknown[]) => unknown) | null = null;
440
+ if (slotNode.denied) {
441
+ DeniedComponent = (await loadComponent(slotNode.denied)) ?? null;
204
442
  }
205
443
 
206
- // No page and no default — slot renders nothing
207
- return null;
444
+ const slotName = slotNode.segmentName?.replace(/^@/, '') ?? '';
445
+
446
+ const defaultFallback = await renderDefaultFallback(slotNode, h);
447
+
448
+ return h(SlotAccessGate, {
449
+ accessFn,
450
+ DeniedComponent,
451
+ slotName,
452
+ createElement: h,
453
+ defaultFallback,
454
+ children: element,
455
+ });
208
456
  }
209
457
 
458
+ // ─── Slot Matching ──────────────────────────────────────────────────────────
459
+
210
460
  /** Result of matching a slot's sub-tree against the current route. */
211
- interface SlotMatchResult {
461
+ export interface SlotMatchResult {
212
462
  /** The page file at the matched leaf. */
213
463
  page: NonNullable<ManifestSegmentNode['page']>;
214
464
  /** The full chain of slot nodes traversed (slot root → … → leaf with page). */
215
465
  chain: ManifestSegmentNode[];
466
+ /** Params collected from the slot's segment chain (pre-coercion, may differ from main route params). */
467
+ slotParams: Record<string, string | string[]>;
216
468
  }
217
469
 
218
470
  /**
@@ -230,205 +482,400 @@ interface SlotMatchResult {
230
482
  * We compare the matched route's segment chain against the slot's children
231
483
  * to find the deepest matching page.
232
484
  */
233
- function findSlotMatch(slotNode: ManifestSegmentNode, match: RouteMatch): SlotMatchResult | null {
234
- const segments = match.segments as unknown as ManifestSegmentNode[];
235
-
236
- // Find the parent segment that owns this slot by comparing urlPaths.
237
- // The slot's urlPath matches its parent's urlPath (slots don't add URL depth).
238
- // Search BACKWARDS to find the deepest (last) matching segment. Multiple
239
- // segments can share the same urlPath when route groups are involved (e.g.,
240
- // Root urlPath='/' and (browse) urlPath='/'). The slot's parent is always
241
- // the deepest one — searching forward would incorrectly pick the root,
242
- // making remainingSegments too long and breaking slot matching.
243
- const slotUrlPath = slotNode.urlPath;
244
- let parentIndex = -1;
485
+ /**
486
+ * The index in the matched chain of the segment that owns this slot.
487
+ *
488
+ * **By identity**, because `urlPath` cannot answer it. Slots add no URL depth,
489
+ * so the owner shares the slot's `urlPath` — but so does every route group
490
+ * above it (`/` for both the root and `(browse)`), and since TIM-1280 so does
491
+ * an intercepting node on the children path, which sits *below* the owner.
492
+ * Picking the deepest urlPath match — the rule before this — therefore chose
493
+ * the intercepting node for a tree like `(browse)/@sidebar/` +
494
+ * `(browse)/(.)item/[id]/`, slicing one segment too many off the chain and
495
+ * handing `@sidebar` a shorter URL than it matches against. It would render
496
+ * its `default.tsx` where a page exists.
497
+ *
498
+ * The index must also agree with `slotUrlParts`, which slices the destination
499
+ * pathname at the same point and already used `indexOf(owner)`. Two derivations
500
+ * of one index is how they came apart; this is the shared one.
501
+ *
502
+ */
503
+ export function findSlotOwnerIndex(
504
+ slotNode: ManifestSegmentNode,
505
+ segments: ManifestSegmentNode[]
506
+ ): number {
245
507
  for (let i = segments.length - 1; i >= 0; i--) {
246
- if (segments[i].urlPath === slotUrlPath) {
247
- parentIndex = i;
248
- break;
508
+ for (const candidate of Object.values(segments[i].slots ?? {})) {
509
+ if (candidate === slotNode) return i;
249
510
  }
250
511
  }
251
512
 
513
+ return -1;
514
+ }
515
+
516
+ function findSlotMatch(slotNode: ManifestSegmentNode, match: RouteMatch): SlotMatchResult | null {
517
+ const segments = match.segments;
518
+
519
+ const parentIndex = findSlotOwnerIndex(slotNode, segments);
520
+
252
521
  // The remaining segments after the parent are what we need to match
253
522
  // against the slot's children.
254
523
  const remainingSegments = parentIndex >= 0 ? segments.slice(parentIndex + 1) : [];
255
524
 
256
- // If no remaining segments, the slot's own page matches
257
- if (remainingSegments.length === 0) {
258
- if (slotNode.page) {
259
- return { page: slotNode.page, chain: [slotNode] };
260
- }
261
- // Check for optional-catch-all child — [[...slug]] matches zero segments
262
- for (const child of slotNode.children ?? []) {
263
- if (child.segmentType === 'optional-catch-all' && child.page) {
264
- return { page: child.page, chain: [slotNode, child] };
265
- }
266
- }
267
- return null;
268
- }
525
+ // Extract raw URL parts from the remaining main-route segments.
526
+ // Raw (pre-coercion) params: actual URL strings, not codec-transformed values.
527
+ const urlParts = extractUrlParts(remainingSegments, match.rawSegmentParams);
269
528
 
270
- // Walk the slot's children to match remaining URL segments.
271
- // Track the chain so we can apply error boundaries and layouts.
272
- const chain: ManifestSegmentNode[] = [slotNode];
273
- let currentNode = slotNode;
274
- for (const seg of remainingSegments) {
275
- const childName = seg.segmentName;
276
- const directChildren = currentNode.children ?? [];
277
-
278
- let found: ManifestSegmentNode | null = null;
279
- for (const child of directChildren) {
280
- // Exact static match
281
- if (child.segmentType === 'static' && child.segmentName === childName) {
282
- found = child;
283
- break;
284
- }
285
- }
529
+ // Match URL parts against the slot's segment tree using the shared walker.
530
+ // Handles zero parts (slot's own page), catch-all, optional-catch-all,
531
+ // groups, backtracking, and correct priority ordering.
532
+ const result = matchUrlParts(slotNode, urlParts);
533
+ if (!result) return null;
286
534
 
287
- // Try dynamic segments if no static match
288
- if (!found) {
289
- for (const child of directChildren) {
290
- if (child.segmentType === 'dynamic') {
291
- found = child;
292
- break;
293
- }
294
- }
295
- }
535
+ const leaf = result.chain[result.chain.length - 1];
536
+ if (!leaf.page) return null;
296
537
 
297
- // Try catch-all segments — these consume ALL remaining URL segments,
298
- // so we break out of the outer loop immediately.
299
- if (!found) {
300
- for (const child of directChildren) {
301
- if (child.segmentType === 'catch-all' || child.segmentType === 'optional-catch-all') {
302
- found = child;
303
- break;
304
- }
305
- }
306
- if (found) {
307
- chain.push(found);
308
- currentNode = found;
309
- break;
310
- }
538
+ return { page: leaf.page, chain: result.chain, slotParams: result.params };
539
+ }
540
+
541
+ // ─── Slot Caching ──────────────────────────────────────────────────────────
542
+
543
+ export interface SlotSkipEntry {
544
+ slotKey: string;
545
+ parentSegmentId: string;
546
+ /**
547
+ * Whether the slot's components called request accessors (getHeaders,
548
+ * getSearchParams, cookies) during their last render. Replaces the
549
+ * unreliable AsyncFunction heuristic — taint-tracked via ALS.
550
+ */
551
+ isRequestDependent: boolean;
552
+ /** Whether the slot's access.ts denied on this render. */
553
+ denied: boolean;
554
+ /** Whether the slot was skipped (content not rendered, client keeps cached). */
555
+ skipped?: boolean;
556
+ /**
557
+ * Content key encoding owner parts + slot name + entry file + slot params.
558
+ * Sent to the client via X-Timber-Segments; the client advertises it back
559
+ * so the server can decide skips by key membership (TIM-1370).
560
+ */
561
+ contentKey: string;
562
+ }
563
+
564
+ /**
565
+ * The destination URL parts a segment's slots match against.
566
+ *
567
+ * A slot walks its own sub-tree starting where its owning segment stopped
568
+ * consuming the URL, so the parts are sliced at the length its ancestors
569
+ * consumed. Shared by `resolveSlotProps` and `publishSlotSegmentParams` — both
570
+ * have to slice identically or the two would disagree about which page a slot
571
+ * matched, and only one of them would be right.
572
+ *
573
+ * @internal
574
+ */
575
+ export function slotUrlParts(
576
+ segment: ManifestSegmentNode,
577
+ match: RouteMatch,
578
+ url: string
579
+ ): string[] {
580
+ const pathname = new URL(url, 'http://localhost').pathname;
581
+ // Slice through the owning segment inclusive, to match findSlotMatch, which
582
+ // walks the chain from parentIndex + 1. `consumedUrlParts` drops the root
583
+ // (it consumes no URL part) and honors the interception anchor, so a slot on
584
+ // a retained owner above a climbing marker is not handed parts the target
585
+ // does not contain.
586
+ const sliceAt = consumedPartsThroughSegment(segment, match).length;
587
+ const all = pathname === '/' ? [] : pathname.slice(1).split('/');
588
+ return all.slice(sliceAt);
589
+ }
590
+
591
+ /**
592
+ * Seed per-slot segment params for a segment whose layout is being SKIPPED.
593
+ *
594
+ * `resolveSlotProps` seeds these as part of resolving slot props, but a skipped
595
+ * layout never gets there — `route-element-builder` continues past it. Its
596
+ * slots are still mounted on the client, though, so leaving them out of the
597
+ * published map made `useSegmentParams(slotPath)` fall back to the main route's
598
+ * record after any navigation that skipped their parent (TIM-1285).
599
+ *
600
+ * Only the params are seeded. Nothing renders, no access chain runs — a skipped
601
+ * layout's slots are unchanged by definition, which is what made it skippable.
602
+ *
603
+ * @internal
604
+ */
605
+ export function publishSlotSegmentParams(
606
+ segment: ManifestSegmentNode,
607
+ match: RouteMatch,
608
+ destinationUrl: string,
609
+ parentTreePath: string | undefined
610
+ ): void {
611
+ const slotEntries = Object.entries(segment.slots ?? {});
612
+ if (slotEntries.length === 0) return;
613
+ const destinationParts = slotUrlParts(segment, match, destinationUrl);
614
+
615
+ for (const [, slotNode] of slotEntries) {
616
+ const destMatch = matchUrlParts(slotNode as ManifestSegmentNode, destinationParts);
617
+ if (!destMatch) continue;
618
+ const coerced = coerceSlotParams(destMatch.chain, destMatch.params);
619
+ const fullSlotPath = computeSlotSegmentPath(destMatch.chain, parentTreePath);
620
+ if (fullSlotPath && Object.keys(coerced).length > 0) {
621
+ setSlotParams(fullSlotPath, coerced);
311
622
  }
623
+ }
624
+ }
312
625
 
313
- // Try group children (transparent)
314
- if (!found) {
315
- for (const child of directChildren) {
316
- if (child.segmentType === 'group') {
317
- for (const groupChild of child.children ?? []) {
318
- if (groupChild.segmentName === childName) {
319
- found = groupChild;
626
+ /**
627
+ * Emit slot metadata for a layout whose rendering was SKIPPED.
628
+ *
629
+ * Skipped layouts never reach `resolveSlotProps`, but the client rebuilds
630
+ * its segment tree from each navigation's X-Timber-Segments response. If
631
+ * skipped slots are absent, the client loses their contentKeys and can't
632
+ * advertise them on the next navigation — breaking key-based slot skipping.
633
+ *
634
+ * This computes contentKey and isRequestDependent for each slot without
635
+ * rendering anything, using the same derivation as `resolveSlotProps`.
636
+ */
637
+ export function emitSlotInfoForSkippedLayout(
638
+ segment: ManifestSegmentNode,
639
+ segmentId: string,
640
+ match: RouteMatch,
641
+ destinationUrl: string,
642
+ slotSkipInfo: SlotSkipEntry[]
643
+ ): void {
644
+ const slotEntries = Object.entries(segment.slots ?? {});
645
+ if (slotEntries.length === 0) return;
646
+
647
+ const destinationParts = slotUrlParts(segment, match, destinationUrl);
648
+ const ownerParts = consumedPartsThroughSegment(segment, match);
649
+
650
+ for (const [slotName, slotNode] of slotEntries) {
651
+ const slotManifest = slotNode as ManifestSegmentNode;
652
+ const slotKey = computeSlotKey(segmentId, `@${slotName}`);
653
+ const destMatch = matchUrlParts(slotManifest, destinationParts);
654
+
655
+ const destLeaf = destMatch?.chain[destMatch.chain.length - 1];
656
+ const entryFile = destLeaf?.page?.filePath ?? null;
657
+ const contentKey = computeSlotContentKey(
658
+ slotKey,
659
+ ownerParts,
660
+ entryFile,
661
+ destMatch?.params ?? {}
662
+ );
663
+
664
+ const hasAccessInChain =
665
+ !!slotManifest.access || (destMatch?.chain.some((seg) => seg.access) ?? false);
666
+
667
+ let slotRequestDep = hasAccessInChain;
668
+ if (!slotRequestDep) {
669
+ const hasRenderedPage = destMatch && destLeaf?.page;
670
+ if (hasRenderedPage) {
671
+ if (
672
+ slotManifest.layout?.filePath &&
673
+ isStaticRequestDependent(slotManifest.layout.filePath)
674
+ ) {
675
+ slotRequestDep = true;
676
+ }
677
+ if (!slotRequestDep) {
678
+ for (const seg of destMatch.chain) {
679
+ if (seg.layout?.filePath && isStaticRequestDependent(seg.layout.filePath)) {
680
+ slotRequestDep = true;
320
681
  break;
321
682
  }
322
683
  }
323
- if (found) break;
684
+ }
685
+ if (!slotRequestDep && destLeaf?.page?.filePath) {
686
+ slotRequestDep = isStaticRequestDependent(destLeaf.page.filePath);
687
+ }
688
+ } else {
689
+ const defaultFile = slotManifest.default?.filePath;
690
+ if (!defaultFile) {
691
+ slotRequestDep = true;
692
+ } else {
693
+ slotRequestDep = isStaticRequestDependent(defaultFile);
324
694
  }
325
695
  }
326
696
  }
327
697
 
328
- if (!found) {
329
- // No matching child in slot tree — slot doesn't match this URL
330
- return null;
331
- }
332
- chain.push(found);
333
- currentNode = found;
698
+ slotSkipInfo.push({
699
+ slotKey,
700
+ parentSegmentId: segmentId,
701
+ isRequestDependent: slotRequestDep,
702
+ denied: false,
703
+ contentKey,
704
+ });
334
705
  }
706
+ }
335
707
 
336
- if (currentNode.page) {
337
- return { page: currentNode.page, chain };
338
- }
339
- return null;
708
+ interface ResolveSlotPropsArgs {
709
+ segment: ManifestSegmentNode;
710
+ segmentId: string;
711
+ match: RouteMatch;
712
+ h: CreateElementFn;
713
+ interception?: InterceptionContext;
714
+ parentTreePath: string;
715
+ /** The request being rendered. Its URL is the slot-matching destination. */
716
+ req: Request;
717
+ clientStateTree: ClientStateTree | null;
718
+ slotSkipInfo: SlotSkipEntry[];
340
719
  }
341
720
 
342
721
  /**
343
- * Find a matching intercepting route in a slot's children for the target pathname.
344
- *
345
- * When interception is active, the pipeline has already re-matched the source URL.
346
- * Here we check the slot's intercepting children (e.g. `(.)photo/[id]`) against
347
- * the target pathname to find which intercepting page to render.
722
+ * Resolve all parallel route slots for a layout, wrapping each in a
723
+ * SegmentOutlet for client-side caching. Slots whose content key matches
724
+ * one the client advertised are rendered with `skip=true` so the client
725
+ * keeps its cached content.
348
726
  *
349
- * The interceptedSegmentName tells us the first URL segment to look for in the
350
- * target pathname. We then walk the intercepting child's sub-tree to match
351
- * remaining segments.
727
+ * The skip decision is key-based (TIM-1370): the server computes a content
728
+ * key per slot from the owning segment's URL parts, the slot name, the
729
+ * matched entry file, and the slot's own params. The client advertises
730
+ * the keys it has cached; the server checks membership. This replaces
731
+ * the previous approach of reconstructing the client's state from a
732
+ * departing URL.
352
733
  */
353
- function findInterceptingMatch(
354
- slotNode: ManifestSegmentNode,
355
- targetPathname: string
356
- ): SlotMatchResult | null {
357
- const targetParts = targetPathname === '/' ? [] : targetPathname.slice(1).split('/');
358
-
359
- for (const child of slotNode.children) {
360
- if (child.segmentType !== 'intercepting' || !child.interceptedSegmentName) continue;
361
-
362
- const segName = child.interceptedSegmentName;
363
-
364
- // Find where the intercepted segment name appears in the target parts.
365
- // Search from the end since intercepted routes match the URL tail.
366
- let matchIdx = -1;
367
- for (let i = targetParts.length - 1; i >= 0; i--) {
368
- if (targetParts[i] === segName) {
369
- matchIdx = i;
370
- break;
371
- }
372
- }
373
- if (matchIdx < 0) continue;
374
-
375
- // Walk the intercepting child's sub-tree to match remaining target parts
376
- const remaining = targetParts.slice(matchIdx + 1);
377
- const chain: ManifestSegmentNode[] = [slotNode, child];
378
-
379
- if (remaining.length === 0) {
380
- if (child.page) {
381
- return { page: child.page, chain };
382
- }
383
- continue;
384
- }
385
-
386
- let currentNode = child;
387
- let matched = true;
388
- for (const part of remaining) {
389
- const children = currentNode.children ?? [];
390
- let found: ManifestSegmentNode | null = null;
391
-
392
- // Static match
393
- for (const c of children) {
394
- if (c.segmentType === 'static' && c.segmentName === part) {
395
- found = c;
396
- break;
734
+ export async function resolveSlotProps({
735
+ segment,
736
+ segmentId,
737
+ match,
738
+ h,
739
+ interception,
740
+ parentTreePath,
741
+ req,
742
+ clientStateTree,
743
+ slotSkipInfo,
744
+ }: ResolveSlotPropsArgs): Promise<Record<string, unknown>> {
745
+ const slotProps: Record<string, unknown> = {};
746
+ const slotEntries = Object.entries(segment.slots ?? {});
747
+ if (slotEntries.length === 0) return slotProps;
748
+
749
+ const destinationParts = slotUrlParts(segment, match, req.url);
750
+ const clientSlotKeys = clientStateTree?.slots ?? null;
751
+
752
+ // Owner URL parts — the URL values consumed through this segment.
753
+ // These are part of the content key because the slot's page may read
754
+ // parent params (e.g., via getSegmentParams).
755
+ const ownerParts = consumedPartsThroughSegment(segment, match);
756
+
757
+ for (const [slotName, slotNode] of slotEntries) {
758
+ const slotManifest = slotNode as ManifestSegmentNode;
759
+ const slotKey = computeSlotKey(segmentId, `@${slotName}`);
760
+
761
+ // Match the slot's sub-tree against the destination URL parts.
762
+ const destMatch = matchUrlParts(slotManifest, destinationParts);
763
+
764
+ // Compute the content key for this slot at the destination URL.
765
+ const destLeaf = destMatch?.chain[destMatch.chain.length - 1];
766
+ const entryFile = destLeaf?.page?.filePath ?? null;
767
+ const contentKey = computeSlotContentKey(
768
+ slotKey,
769
+ ownerParts,
770
+ entryFile,
771
+ destMatch?.params ?? {}
772
+ );
773
+
774
+ // Auth-bearing slots are inherently request-dependent — their content
775
+ // changes based on user state. Skipping them would require eager
776
+ // evaluation of access.ts outside React.cache scope, causing double
777
+ // execution (TIM-1364). Instead, exclude them from skip candidates
778
+ // entirely and let SlotAccessGate handle access during render.
779
+ // The client filters these out via isRequestDependent, so their keys
780
+ // are never advertised — but checking here is defense-in-depth.
781
+ const hasAccessInChain =
782
+ !!slotManifest.access || (destMatch?.chain.some((seg) => seg.access) ?? false);
783
+ const hasInterceptingChildren = slotManifest.children.some(
784
+ (c) => c.segmentType === 'intercepting'
785
+ );
786
+ const canSkip =
787
+ !interception &&
788
+ !hasInterceptingChildren &&
789
+ !hasAccessInChain &&
790
+ shouldSkipSlot(contentKey, clientSlotKeys);
791
+
792
+ if (canSkip) {
793
+ // No access.ts in this slot's chain (excluded above), so no gate needed.
794
+ slotProps[slotName] = h(SegmentOutlet, {
795
+ segmentPath: slotKey,
796
+ skip: true,
797
+ children: null,
798
+ });
799
+ slotSkipInfo.push({
800
+ slotKey,
801
+ parentSegmentId: segmentId,
802
+ isRequestDependent: false,
803
+ denied: false,
804
+ skipped: true,
805
+ contentKey,
806
+ });
807
+ } else {
808
+ const resolvedElement = await resolveSlotElement(
809
+ slotManifest,
810
+ match,
811
+ h,
812
+ req,
813
+ interception,
814
+ parentTreePath
815
+ );
816
+ slotProps[slotName] = h(SegmentOutlet, {
817
+ segmentPath: slotKey,
818
+ children: resolvedElement,
819
+ });
820
+ // Static analysis: check if any file in the slot's RENDERED tree
821
+ // is request-dependent. Only check layouts when destMatch exists —
822
+ // unmatched slots render default.tsx directly without layouts.
823
+ // Slots with access.ts are inherently request-dependent — their
824
+ // content varies with user state (TIM-1364).
825
+ let slotRequestDep = hasAccessInChain;
826
+ const hasRenderedPage = destMatch && destLeaf?.page;
827
+ if (slotRequestDep) {
828
+ // Already marked — skip static analysis
829
+ } else if (interception) {
830
+ // `destMatch` walks the slot's ordinary children against the
831
+ // destination URL; the interception resolver renders an intercepting
832
+ // child instead, which that walk never sees. So the files analyzed
833
+ // below are not the files that rendered — and `false` here tells the
834
+ // client the slot is reusable. Stay conservative: a needlessly
835
+ // request-dependent slot is a wasted refetch, a wrongly static one is
836
+ // a stale modal.
837
+ slotRequestDep = true;
838
+ } else if (hasRenderedPage) {
839
+ // Check slot root layout (rendered by wrapWithLayout)
840
+ if (
841
+ slotManifest.layout?.filePath &&
842
+ isStaticRequestDependent(slotManifest.layout.filePath)
843
+ ) {
844
+ slotRequestDep = true;
397
845
  }
398
- }
399
-
400
- // Dynamic match
401
- if (!found) {
402
- for (const c of children) {
403
- if (c.segmentType === 'dynamic') {
404
- found = c;
405
- break;
846
+ // Check intermediate slot layouts
847
+ if (!slotRequestDep) {
848
+ for (const seg of destMatch.chain) {
849
+ if (seg.layout?.filePath && isStaticRequestDependent(seg.layout.filePath)) {
850
+ slotRequestDep = true;
851
+ break;
852
+ }
406
853
  }
407
854
  }
408
- }
409
-
410
- // Catch-all match
411
- if (!found) {
412
- for (const c of children) {
413
- if (c.segmentType === 'catch-all' || c.segmentType === 'optional-catch-all') {
414
- found = c;
415
- break;
855
+ // Check leaf page
856
+ if (!slotRequestDep) {
857
+ if (destLeaf?.page?.filePath && isStaticRequestDependent(destLeaf.page.filePath)) {
858
+ slotRequestDep = true;
416
859
  }
417
860
  }
861
+ } else {
862
+ // No match — only default.tsx is rendered (no layouts)
863
+ const defaultFile = slotManifest.default?.filePath;
864
+ if (!defaultFile) {
865
+ slotRequestDep = true; // No entry file → conservative
866
+ } else {
867
+ slotRequestDep = isStaticRequestDependent(defaultFile);
868
+ }
418
869
  }
419
-
420
- if (!found) {
421
- matched = false;
422
- break;
423
- }
424
- chain.push(found);
425
- currentNode = found;
426
- }
427
-
428
- if (matched && currentNode.page) {
429
- return { page: currentNode.page, chain };
870
+ slotSkipInfo.push({
871
+ slotKey,
872
+ parentSegmentId: segmentId,
873
+ isRequestDependent: slotRequestDep,
874
+ denied: false,
875
+ contentKey,
876
+ });
430
877
  }
431
878
  }
432
879
 
433
- return null;
880
+ return slotProps;
434
881
  }