@timber-js/app 0.2.0-alpha.22 → 0.2.0-alpha.221

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 (1484) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BDqn4Oxj.js +1243 -0
  5. package/dist/_chunks/actions-BDqn4Oxj.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-GE4AOe2H.js +1061 -0
  17. package/dist/_chunks/cache-api-GE4AOe2H.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-BiWNMBVU.js +1 -0
  44. package/dist/_chunks/dev-server-DIy-SY-J.js +2061 -0
  45. package/dist/_chunks/dev-server-DIy-SY-J.js.map +1 -0
  46. package/dist/_chunks/dev-store-BOa304m_.js +283 -0
  47. package/dist/_chunks/dev-store-BOa304m_.js.map +1 -0
  48. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  49. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  50. package/dist/_chunks/error-boundary-Bc8QPZuq.js +1107 -0
  51. package/dist/_chunks/error-boundary-Bc8QPZuq.js.map +1 -0
  52. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  53. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  54. package/dist/_chunks/flight-source-node-HptmGMT8.js +518 -0
  55. package/dist/_chunks/flight-source-node-HptmGMT8.js.map +1 -0
  56. package/dist/_chunks/format-BKclgVbk.js +14 -0
  57. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  58. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  59. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  60. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  61. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  62. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  63. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  64. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  65. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  66. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  67. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  68. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  69. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  70. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  71. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  72. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  73. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  74. package/dist/_chunks/node-response-rkQqcFGq.js +233 -0
  75. package/dist/_chunks/node-response-rkQqcFGq.js.map +1 -0
  76. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  77. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  78. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  79. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  80. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  81. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  82. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  83. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  84. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  85. package/dist/_chunks/purge-store-WZaxu-3m.js +14 -0
  86. package/dist/_chunks/purge-store-WZaxu-3m.js.map +1 -0
  87. package/dist/_chunks/render-timeout-joFhz4KH.js +37 -0
  88. package/dist/_chunks/render-timeout-joFhz4KH.js.map +1 -0
  89. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  90. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  91. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  92. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  93. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  94. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  95. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  96. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  97. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  98. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  99. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  100. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  101. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  102. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  103. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  104. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  105. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  106. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  107. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  108. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  109. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  110. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  111. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  112. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  113. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  114. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  115. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  116. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  117. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  118. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  119. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  120. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  121. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  122. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  123. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  124. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  125. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  126. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  127. package/dist/adapters/build-output-helper.d.ts +72 -0
  128. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  129. package/dist/adapters/canonicalize-module.d.ts +8 -0
  130. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  132. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  133. package/dist/adapters/cloudflare-dev.js +74 -0
  134. package/dist/adapters/cloudflare-dev.js.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  136. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  137. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  138. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  139. package/dist/adapters/cloudflare.d.ts +224 -24
  140. package/dist/adapters/cloudflare.d.ts.map +1 -1
  141. package/dist/adapters/cloudflare.js +1 -188
  142. package/dist/adapters/compress-module.d.ts +25 -4
  143. package/dist/adapters/compress-module.d.ts.map +1 -1
  144. package/dist/adapters/fs-identity.d.ts +63 -0
  145. package/dist/adapters/fs-identity.d.ts.map +1 -0
  146. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  147. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-presets.d.ts +31 -0
  149. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  150. package/dist/adapters/nitro-preview.d.ts +65 -0
  151. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  152. package/dist/adapters/nitro.d.ts +69 -38
  153. package/dist/adapters/nitro.d.ts.map +1 -1
  154. package/dist/adapters/nitro.js +793 -341
  155. package/dist/adapters/nitro.js.map +1 -1
  156. package/dist/adapters/shared.d.ts +67 -0
  157. package/dist/adapters/shared.d.ts.map +1 -0
  158. package/dist/adapters/types.d.ts +124 -16
  159. package/dist/adapters/types.d.ts.map +1 -1
  160. package/dist/adapters/types.js +0 -0
  161. package/dist/analyze/chains.d.ts +124 -0
  162. package/dist/analyze/chains.d.ts.map +1 -0
  163. package/dist/analyze/classify.d.ts +153 -0
  164. package/dist/analyze/classify.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.d.ts +17 -0
  166. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  167. package/dist/analyze/crawl-entry.js +314 -0
  168. package/dist/analyze/crawl-entry.js.map +1 -0
  169. package/dist/analyze/crawl.d.ts +134 -0
  170. package/dist/analyze/crawl.d.ts.map +1 -0
  171. package/dist/analyze/graph-cache.d.ts +104 -0
  172. package/dist/analyze/graph-cache.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.d.ts +43 -0
  174. package/dist/analyze/graph-command.d.ts.map +1 -0
  175. package/dist/analyze/graph-command.js +472 -0
  176. package/dist/analyze/graph-command.js.map +1 -0
  177. package/dist/analyze/live-graph.d.ts +81 -0
  178. package/dist/analyze/live-graph.d.ts.map +1 -0
  179. package/dist/analyze/poison-rules.d.ts +72 -0
  180. package/dist/analyze/poison-rules.d.ts.map +1 -0
  181. package/dist/analyze/poison-scan.d.ts +48 -0
  182. package/dist/analyze/poison-scan.d.ts.map +1 -0
  183. package/dist/analyze/scan.d.ts +73 -0
  184. package/dist/analyze/scan.d.ts.map +1 -0
  185. package/dist/cache/cache-api.d.ts +48 -0
  186. package/dist/cache/cache-api.d.ts.map +1 -0
  187. package/dist/cache/fast-hash.d.ts +5 -0
  188. package/dist/cache/fast-hash.d.ts.map +1 -1
  189. package/dist/cache/handler-store.d.ts +45 -0
  190. package/dist/cache/handler-store.d.ts.map +1 -0
  191. package/dist/cache/index.d.ts +32 -9
  192. package/dist/cache/index.d.ts.map +1 -1
  193. package/dist/cache/index.js +4 -326
  194. package/dist/cache/invalidation-epoch.d.ts +50 -0
  195. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  196. package/dist/cache/json-lossy-check.d.ts +11 -0
  197. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  198. package/dist/cache/redis-handler.d.ts +141 -9
  199. package/dist/cache/redis-handler.d.ts.map +1 -1
  200. package/dist/cache/singleflight.d.ts +21 -2
  201. package/dist/cache/singleflight.d.ts.map +1 -1
  202. package/dist/cache/sizeof.d.ts +22 -0
  203. package/dist/cache/sizeof.d.ts.map +1 -0
  204. package/dist/cache/stable-stringify.d.ts +9 -0
  205. package/dist/cache/stable-stringify.d.ts.map +1 -1
  206. package/dist/cache/store.d.ts +53 -0
  207. package/dist/cache/store.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  209. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  210. package/dist/cache/stores/cloudflare-kv.js +29 -0
  211. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  212. package/dist/cache/stores/memory.d.ts +42 -0
  213. package/dist/cache/stores/memory.d.ts.map +1 -0
  214. package/dist/cache/stores/memory.js +90 -0
  215. package/dist/cache/stores/memory.js.map +1 -0
  216. package/dist/cache/stores/redis.d.ts +69 -0
  217. package/dist/cache/stores/redis.d.ts.map +1 -0
  218. package/dist/cache/stores/redis.js +35 -0
  219. package/dist/cache/stores/redis.js.map +1 -0
  220. package/dist/cache/stores/vercel.d.ts +36 -0
  221. package/dist/cache/stores/vercel.d.ts.map +1 -0
  222. package/dist/cache/stores/vercel.js +33 -0
  223. package/dist/cache/stores/vercel.js.map +1 -0
  224. package/dist/cache/tag-aware-handler.d.ts +52 -0
  225. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  226. package/dist/cache/timber-cache.d.ts +21 -11
  227. package/dist/cache/timber-cache.d.ts.map +1 -1
  228. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  229. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  230. package/dist/cdn/cloudflare-purge.js +30 -0
  231. package/dist/cdn/cloudflare-purge.js.map +1 -0
  232. package/dist/cdn/fastly-purge.d.ts +25 -0
  233. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  234. package/dist/cdn/fastly-purge.js +33 -0
  235. package/dist/cdn/fastly-purge.js.map +1 -0
  236. package/dist/cdn/headers.d.ts +97 -0
  237. package/dist/cdn/headers.d.ts.map +1 -0
  238. package/dist/cdn/index.d.ts +5 -0
  239. package/dist/cdn/index.d.ts.map +1 -0
  240. package/dist/cdn/index.js +94 -0
  241. package/dist/cdn/index.js.map +1 -0
  242. package/dist/cdn/purge-store.d.ts +32 -0
  243. package/dist/cdn/purge-store.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  245. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  246. package/dist/cdn/workers-cache-purge.js +35 -0
  247. package/dist/cdn/workers-cache-purge.js.map +1 -0
  248. package/dist/cli-check.d.ts +133 -0
  249. package/dist/cli-check.d.ts.map +1 -0
  250. package/dist/cli-context.d.ts +54 -0
  251. package/dist/cli-context.d.ts.map +1 -0
  252. package/dist/cli-schema-sync.d.ts +59 -0
  253. package/dist/cli-schema-sync.d.ts.map +1 -0
  254. package/dist/cli.d.ts +88 -16
  255. package/dist/cli.d.ts.map +1 -1
  256. package/dist/cli.js +225 -63
  257. package/dist/cli.js.map +1 -1
  258. package/dist/client/browser-dev.d.ts +42 -2
  259. package/dist/client/browser-dev.d.ts.map +1 -1
  260. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  261. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  262. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  263. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  264. package/dist/client/browser-entry/form-state.d.ts +22 -0
  265. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hmr.d.ts +21 -0
  267. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  268. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  269. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  270. package/dist/client/browser-entry/index.d.ts +32 -0
  271. package/dist/client/browser-entry/index.d.ts.map +1 -0
  272. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  273. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  274. package/dist/client/browser-entry/router-init.d.ts +41 -0
  275. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  276. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  277. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  278. package/dist/client/browser-entry/scroll.d.ts +28 -0
  279. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  280. package/dist/client/deny-last-resort.d.ts +29 -0
  281. package/dist/client/deny-last-resort.d.ts.map +1 -0
  282. package/dist/client/error-boundary.d.ts +58 -9
  283. package/dist/client/error-boundary.d.ts.map +1 -1
  284. package/dist/client/error-boundary.js +1 -126
  285. package/dist/client/error-reconstituter.d.ts +55 -0
  286. package/dist/client/error-reconstituter.d.ts.map +1 -0
  287. package/dist/client/form.d.ts +38 -99
  288. package/dist/client/form.d.ts.map +1 -1
  289. package/dist/client/global-context.d.ts +15 -0
  290. package/dist/client/global-context.d.ts.map +1 -0
  291. package/dist/client/history.d.ts +50 -9
  292. package/dist/client/history.d.ts.map +1 -1
  293. package/dist/client/index.d.ts +21 -33
  294. package/dist/client/index.d.ts.map +1 -1
  295. package/dist/client/index.js +423 -1227
  296. package/dist/client/index.js.map +1 -1
  297. package/dist/client/internal.d.ts +20 -0
  298. package/dist/client/internal.d.ts.map +1 -0
  299. package/dist/client/internal.js +781 -0
  300. package/dist/client/internal.js.map +1 -0
  301. package/dist/client/link.d.ts +85 -60
  302. package/dist/client/link.d.ts.map +1 -1
  303. package/dist/client/location-search.d.ts +12 -0
  304. package/dist/client/location-search.d.ts.map +1 -0
  305. package/dist/client/navigation-api.d.ts +95 -0
  306. package/dist/client/navigation-api.d.ts.map +1 -0
  307. package/dist/client/navigation-commit.d.ts +111 -0
  308. package/dist/client/navigation-commit.d.ts.map +1 -0
  309. package/dist/client/navigation-context.d.ts +54 -36
  310. package/dist/client/navigation-context.d.ts.map +1 -1
  311. package/dist/client/navigation-root.d.ts +106 -0
  312. package/dist/client/navigation-root.d.ts.map +1 -0
  313. package/dist/client/navigation-transition.d.ts +255 -0
  314. package/dist/client/navigation-transition.d.ts.map +1 -0
  315. package/dist/client/nuqs-adapter.d.ts +1 -1
  316. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  317. package/dist/client/params-context.d.ts +81 -0
  318. package/dist/client/params-context.d.ts.map +1 -0
  319. package/dist/client/react-root.d.ts +51 -0
  320. package/dist/client/react-root.d.ts.map +1 -0
  321. package/dist/client/router-effects.d.ts +203 -0
  322. package/dist/client/router-effects.d.ts.map +1 -0
  323. package/dist/client/router-lifecycle.d.ts +104 -0
  324. package/dist/client/router-lifecycle.d.ts.map +1 -0
  325. package/dist/client/router-pipeline.d.ts +81 -0
  326. package/dist/client/router-pipeline.d.ts.map +1 -0
  327. package/dist/client/router-ref.d.ts +2 -2
  328. package/dist/client/router-ref.d.ts.map +1 -1
  329. package/dist/client/router-skew.d.ts +21 -0
  330. package/dist/client/router-skew.d.ts.map +1 -0
  331. package/dist/client/router-types.d.ts +294 -0
  332. package/dist/client/router-types.d.ts.map +1 -0
  333. package/dist/client/router-url.d.ts +24 -0
  334. package/dist/client/router-url.d.ts.map +1 -0
  335. package/dist/client/router.d.ts +1 -97
  336. package/dist/client/router.d.ts.map +1 -1
  337. package/dist/client/rsc-fetch.d.ts +110 -28
  338. package/dist/client/rsc-fetch.d.ts.map +1 -1
  339. package/dist/client/segment-cache.d.ts +186 -25
  340. package/dist/client/segment-cache.d.ts.map +1 -1
  341. package/dist/client/segment-context.d.ts.map +1 -1
  342. package/dist/client/segment-outlet.d.ts +68 -0
  343. package/dist/client/segment-outlet.d.ts.map +1 -0
  344. package/dist/client/segment-update-context.d.ts +15 -0
  345. package/dist/client/segment-update-context.d.ts.map +1 -0
  346. package/dist/client/shallow-url.d.ts +10 -0
  347. package/dist/client/shallow-url.d.ts.map +1 -0
  348. package/dist/client/slot-content-cache-context.d.ts +35 -0
  349. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  350. package/dist/client/slot-context.d.ts +31 -0
  351. package/dist/client/slot-context.d.ts.map +1 -0
  352. package/dist/client/slot-outlet.d.ts +16 -0
  353. package/dist/client/slot-outlet.d.ts.map +1 -0
  354. package/dist/client/slot-provider.d.ts +25 -0
  355. package/dist/client/slot-provider.d.ts.map +1 -0
  356. package/dist/client/ssr-data.d.ts +26 -50
  357. package/dist/client/ssr-data.d.ts.map +1 -1
  358. package/dist/client/stale-client.d.ts +69 -0
  359. package/dist/client/stale-client.d.ts.map +1 -0
  360. package/dist/client/state.d.ts +21 -13
  361. package/dist/client/state.d.ts.map +1 -1
  362. package/dist/client/status-page-marker.d.ts +25 -0
  363. package/dist/client/status-page-marker.d.ts.map +1 -0
  364. package/dist/client/top-loader.d.ts +7 -6
  365. package/dist/client/top-loader.d.ts.map +1 -1
  366. package/dist/client/unload-guard.d.ts +5 -0
  367. package/dist/client/unload-guard.d.ts.map +1 -1
  368. package/dist/client/use-cookie.d.ts +12 -0
  369. package/dist/client/use-cookie.d.ts.map +1 -1
  370. package/dist/client/use-field-state.d.ts +42 -0
  371. package/dist/client/use-field-state.d.ts.map +1 -0
  372. package/dist/client/use-link-status.d.ts +5 -5
  373. package/dist/client/use-link-status.d.ts.map +1 -1
  374. package/dist/client/use-pathname.d.ts +13 -11
  375. package/dist/client/use-pathname.d.ts.map +1 -1
  376. package/dist/client/use-pending-navigation.d.ts +23 -0
  377. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  378. package/dist/client/use-query-states.d.ts +10 -4
  379. package/dist/client/use-query-states.d.ts.map +1 -1
  380. package/dist/client/use-router.d.ts +15 -8
  381. package/dist/client/use-router.d.ts.map +1 -1
  382. package/dist/client/use-search-params.d.ts +15 -8
  383. package/dist/client/use-search-params.d.ts.map +1 -1
  384. package/dist/client/use-segment-params.d.ts +55 -0
  385. package/dist/client/use-segment-params.d.ts.map +1 -0
  386. package/dist/codec.d.ts +69 -0
  387. package/dist/codec.d.ts.map +1 -0
  388. package/dist/codec.js +76 -0
  389. package/dist/codec.js.map +1 -0
  390. package/dist/config-types.d.ts +321 -0
  391. package/dist/config-types.d.ts.map +1 -0
  392. package/dist/config-validation.d.ts +68 -0
  393. package/dist/config-validation.d.ts.map +1 -0
  394. package/dist/cookies/define-cookie.d.ts +58 -25
  395. package/dist/cookies/define-cookie.d.ts.map +1 -1
  396. package/dist/cookies/index.d.ts +3 -2
  397. package/dist/cookies/index.d.ts.map +1 -1
  398. package/dist/cookies/index.js +256 -36
  399. package/dist/cookies/index.js.map +1 -1
  400. package/dist/cookies/json-cookie.d.ts +64 -0
  401. package/dist/cookies/json-cookie.d.ts.map +1 -0
  402. package/dist/cookies/validation.d.ts +34 -0
  403. package/dist/cookies/validation.d.ts.map +1 -0
  404. package/dist/dev-tools/404-page.d.ts +50 -0
  405. package/dist/dev-tools/404-page.d.ts.map +1 -0
  406. package/dist/dev-tools/browser-logs.d.ts +40 -0
  407. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  408. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  409. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  410. package/dist/dev-tools/error-page.d.ts +32 -0
  411. package/dist/dev-tools/error-page.d.ts.map +1 -0
  412. package/dist/dev-tools/holding-server.d.ts +46 -0
  413. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  414. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  415. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  416. package/dist/dev-tools/index.d.ts +31 -0
  417. package/dist/dev-tools/index.d.ts.map +1 -0
  418. package/dist/dev-tools/instrumentation.d.ts +74 -0
  419. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  420. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  421. package/dist/dev-tools/logger.d.ts.map +1 -0
  422. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  423. package/dist/dev-tools/logs.d.ts.map +1 -0
  424. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  425. package/dist/dev-tools/overlay.d.ts.map +1 -0
  426. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  427. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  428. package/dist/dev-tools/terminal.d.ts +28 -0
  429. package/dist/dev-tools/terminal.d.ts.map +1 -0
  430. package/dist/fonts/ast-walk.d.ts +68 -0
  431. package/dist/fonts/ast-walk.d.ts.map +1 -0
  432. package/dist/fonts/ast.d.ts +112 -8
  433. package/dist/fonts/ast.d.ts.map +1 -1
  434. package/dist/fonts/bundle.d.ts +50 -0
  435. package/dist/fonts/bundle.d.ts.map +1 -0
  436. package/dist/fonts/css.d.ts +1 -1
  437. package/dist/fonts/dev-middleware.d.ts +22 -0
  438. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  439. package/dist/fonts/fallbacks.d.ts +0 -7
  440. package/dist/fonts/fallbacks.d.ts.map +1 -1
  441. package/dist/fonts/google.d.ts +5 -3
  442. package/dist/fonts/google.d.ts.map +1 -1
  443. package/dist/fonts/local.d.ts +5 -5
  444. package/dist/fonts/local.d.ts.map +1 -1
  445. package/dist/fonts/paths.d.ts +43 -0
  446. package/dist/fonts/paths.d.ts.map +1 -0
  447. package/dist/fonts/pipeline.d.ts +177 -0
  448. package/dist/fonts/pipeline.d.ts.map +1 -0
  449. package/dist/fonts/transform.d.ts +82 -0
  450. package/dist/fonts/transform.d.ts.map +1 -0
  451. package/dist/fonts/types.d.ts +47 -1
  452. package/dist/fonts/types.d.ts.map +1 -1
  453. package/dist/fonts/virtual-modules.d.ts +77 -0
  454. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  455. package/dist/index.d.ts +35 -181
  456. package/dist/index.d.ts.map +1 -1
  457. package/dist/index.js +8972 -14234
  458. package/dist/index.js.map +1 -1
  459. package/dist/params/codec-registry.d.ts +26 -0
  460. package/dist/params/codec-registry.d.ts.map +1 -0
  461. package/dist/params/define-schema.d.ts +81 -0
  462. package/dist/params/define-schema.d.ts.map +1 -0
  463. package/dist/params/index.d.ts +5 -0
  464. package/dist/params/index.d.ts.map +1 -0
  465. package/dist/params/index.js +34 -0
  466. package/dist/params/index.js.map +1 -0
  467. package/dist/params/resolve-schema.d.ts +34 -0
  468. package/dist/params/resolve-schema.d.ts.map +1 -0
  469. package/dist/plugin-context.d.ts +262 -0
  470. package/dist/plugin-context.d.ts.map +1 -0
  471. package/dist/plugins/build-manifest.d.ts +7 -3
  472. package/dist/plugins/build-manifest.d.ts.map +1 -1
  473. package/dist/plugins/build-report.d.ts +61 -11
  474. package/dist/plugins/build-report.d.ts.map +1 -1
  475. package/dist/plugins/cache.d.ts +64 -0
  476. package/dist/plugins/cache.d.ts.map +1 -0
  477. package/dist/plugins/callsite-ast.d.ts +117 -0
  478. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  479. package/dist/plugins/callsite-jsx.d.ts +35 -0
  480. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  481. package/dist/plugins/chunks.d.ts +11 -4
  482. package/dist/plugins/chunks.d.ts.map +1 -1
  483. package/dist/plugins/client-chunks.d.ts +40 -0
  484. package/dist/plugins/client-chunks.d.ts.map +1 -0
  485. package/dist/plugins/client-dep-entries.d.ts +80 -0
  486. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  487. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  488. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  489. package/dist/plugins/content.d.ts +1 -1
  490. package/dist/plugins/content.d.ts.map +1 -1
  491. package/dist/plugins/dev-discovery.d.ts +123 -0
  492. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  493. package/dist/plugins/dev-server.d.ts +24 -1
  494. package/dist/plugins/dev-server.d.ts.map +1 -1
  495. package/dist/plugins/encryption-runtime.d.ts +13 -0
  496. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  497. package/dist/plugins/entries.d.ts +40 -4
  498. package/dist/plugins/entries.d.ts.map +1 -1
  499. package/dist/plugins/fonts.d.ts +35 -74
  500. package/dist/plugins/fonts.d.ts.map +1 -1
  501. package/dist/plugins/graph-endpoint.d.ts +112 -0
  502. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  503. package/dist/plugins/mdx.d.ts +18 -5
  504. package/dist/plugins/mdx.d.ts.map +1 -1
  505. package/dist/plugins/orphaned-modules.d.ts +57 -0
  506. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  507. package/dist/plugins/post-build.d.ts +110 -0
  508. package/dist/plugins/post-build.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  510. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  511. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  512. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  513. package/dist/plugins/prebuilt.d.ts +98 -0
  514. package/dist/plugins/prebuilt.d.ts.map +1 -0
  515. package/dist/plugins/prerender-sugar.d.ts +39 -0
  516. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  517. package/dist/plugins/react-resolve.d.ts +49 -0
  518. package/dist/plugins/react-resolve.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  520. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  521. package/dist/plugins/request-dep/index.d.ts +75 -0
  522. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  523. package/dist/plugins/request-dep/origin.d.ts +61 -0
  524. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  525. package/dist/plugins/routing.d.ts +2 -2
  526. package/dist/plugins/routing.d.ts.map +1 -1
  527. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  528. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  529. package/dist/plugins/server-bundle.d.ts +1 -1
  530. package/dist/plugins/server-bundle.d.ts.map +1 -1
  531. package/dist/plugins/shims.d.ts +29 -5
  532. package/dist/plugins/shims.d.ts.map +1 -1
  533. package/dist/plugins/static-build.d.ts +246 -26
  534. package/dist/plugins/static-build.d.ts.map +1 -1
  535. package/dist/routing/codegen-shared.d.ts +26 -0
  536. package/dist/routing/codegen-shared.d.ts.map +1 -0
  537. package/dist/routing/codegen-types.d.ts +61 -0
  538. package/dist/routing/codegen-types.d.ts.map +1 -0
  539. package/dist/routing/codegen-write.d.ts +42 -0
  540. package/dist/routing/codegen-write.d.ts.map +1 -0
  541. package/dist/routing/codegen.d.ts +8 -3
  542. package/dist/routing/codegen.d.ts.map +1 -1
  543. package/dist/routing/collision-probe.d.ts +104 -0
  544. package/dist/routing/collision-probe.d.ts.map +1 -0
  545. package/dist/routing/collision-spaces.d.ts +26 -0
  546. package/dist/routing/collision-spaces.d.ts.map +1 -0
  547. package/dist/routing/convention-lint.d.ts +55 -0
  548. package/dist/routing/convention-lint.d.ts.map +1 -0
  549. package/dist/routing/export-detect.d.ts +91 -0
  550. package/dist/routing/export-detect.d.ts.map +1 -0
  551. package/dist/routing/file-cache.d.ts +8 -0
  552. package/dist/routing/file-cache.d.ts.map +1 -0
  553. package/dist/routing/index.d.ts +13 -7
  554. package/dist/routing/index.d.ts.map +1 -1
  555. package/dist/routing/index.js +5 -2
  556. package/dist/routing/interception-overlap.d.ts +35 -0
  557. package/dist/routing/interception-overlap.d.ts.map +1 -0
  558. package/dist/routing/interception.d.ts +234 -10
  559. package/dist/routing/interception.d.ts.map +1 -1
  560. package/dist/routing/link-codegen.d.ts +105 -0
  561. package/dist/routing/link-codegen.d.ts.map +1 -0
  562. package/dist/routing/manifest-codegen.d.ts +26 -0
  563. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  564. package/dist/routing/scanner.d.ts +14 -10
  565. package/dist/routing/scanner.d.ts.map +1 -1
  566. package/dist/routing/schema-validation.d.ts +35 -0
  567. package/dist/routing/schema-validation.d.ts.map +1 -0
  568. package/dist/routing/segment-classify.d.ts +114 -0
  569. package/dist/routing/segment-classify.d.ts.map +1 -0
  570. package/dist/routing/segment-codegen.d.ts +38 -0
  571. package/dist/routing/segment-codegen.d.ts.map +1 -0
  572. package/dist/routing/segment-keys.d.ts +118 -0
  573. package/dist/routing/segment-keys.d.ts.map +1 -0
  574. package/dist/routing/slot-placement.d.ts +48 -0
  575. package/dist/routing/slot-placement.d.ts.map +1 -0
  576. package/dist/routing/types.d.ts +81 -26
  577. package/dist/routing/types.d.ts.map +1 -1
  578. package/dist/routing/walkers.d.ts +57 -0
  579. package/dist/routing/walkers.d.ts.map +1 -0
  580. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  581. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  582. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  583. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  584. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  585. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  586. package/dist/rsc-runtime/rsc.d.ts +2 -13
  587. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  588. package/dist/rsc-runtime/ssr.d.ts +7 -10
  589. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  590. package/dist/rsc-runtime/transforms.d.ts +13 -0
  591. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  592. package/dist/schema-bridge.d.ts +145 -0
  593. package/dist/schema-bridge.d.ts.map +1 -0
  594. package/dist/search-params/define.d.ts +262 -0
  595. package/dist/search-params/define.d.ts.map +1 -0
  596. package/dist/search-params/index.d.ts +3 -7
  597. package/dist/search-params/index.d.ts.map +1 -1
  598. package/dist/search-params/index.js +179 -360
  599. package/dist/search-params/index.js.map +1 -1
  600. package/dist/search-params/parse-total.d.ts +81 -0
  601. package/dist/search-params/parse-total.d.ts.map +1 -0
  602. package/dist/search-params/serialize-equal.d.ts +9 -0
  603. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  604. package/dist/search-params/wrappers.d.ts +76 -0
  605. package/dist/search-params/wrappers.d.ts.map +1 -0
  606. package/dist/server/abort-scope.d.ts +27 -0
  607. package/dist/server/abort-scope.d.ts.map +1 -0
  608. package/dist/server/access-gate.d.ts +98 -10
  609. package/dist/server/access-gate.d.ts.map +1 -1
  610. package/dist/server/action-client.d.ts +20 -133
  611. package/dist/server/action-client.d.ts.map +1 -1
  612. package/dist/server/action-encryption.d.ts +76 -0
  613. package/dist/server/action-encryption.d.ts.map +1 -0
  614. package/dist/server/action-handler.d.ts +58 -11
  615. package/dist/server/action-handler.d.ts.map +1 -1
  616. package/dist/server/action-schema.d.ts +126 -0
  617. package/dist/server/action-schema.d.ts.map +1 -0
  618. package/dist/server/action-types.d.ts +108 -0
  619. package/dist/server/action-types.d.ts.map +1 -0
  620. package/dist/server/actions.d.ts +78 -40
  621. package/dist/server/actions.d.ts.map +1 -1
  622. package/dist/server/als-registry.d.ts +189 -17
  623. package/dist/server/als-registry.d.ts.map +1 -1
  624. package/dist/server/body-limits.d.ts.map +1 -1
  625. package/dist/server/build-manifest.d.ts +25 -30
  626. package/dist/server/build-manifest.d.ts.map +1 -1
  627. package/dist/server/canonicalize.d.ts +32 -0
  628. package/dist/server/canonicalize.d.ts.map +1 -1
  629. package/dist/server/chain-url-parts.d.ts +82 -0
  630. package/dist/server/chain-url-parts.d.ts.map +1 -0
  631. package/dist/server/children-interception.d.ts +49 -0
  632. package/dist/server/children-interception.d.ts.map +1 -0
  633. package/dist/server/client-error-message.d.ts +12 -0
  634. package/dist/server/client-error-message.d.ts.map +1 -0
  635. package/dist/server/coalesce-tick.d.ts +40 -0
  636. package/dist/server/coalesce-tick.d.ts.map +1 -0
  637. package/dist/server/compress.d.ts +2 -0
  638. package/dist/server/compress.d.ts.map +1 -1
  639. package/dist/server/cookie-context.d.ts +149 -0
  640. package/dist/server/cookie-context.d.ts.map +1 -0
  641. package/dist/server/cookie-parsing.d.ts +65 -0
  642. package/dist/server/cookie-parsing.d.ts.map +1 -0
  643. package/dist/server/csp-nonce.d.ts +36 -0
  644. package/dist/server/csp-nonce.d.ts.map +1 -0
  645. package/dist/server/csrf.d.ts +58 -15
  646. package/dist/server/csrf.d.ts.map +1 -1
  647. package/dist/server/debug.d.ts +0 -1
  648. package/dist/server/debug.d.ts.map +1 -1
  649. package/dist/server/default-logger.d.ts +23 -0
  650. package/dist/server/default-logger.d.ts.map +1 -0
  651. package/dist/server/default-status-page.d.ts +45 -0
  652. package/dist/server/default-status-page.d.ts.map +1 -0
  653. package/dist/server/deny-boundary.d.ts +257 -0
  654. package/dist/server/deny-boundary.d.ts.map +1 -0
  655. package/dist/server/deny-renderer.d.ts +22 -15
  656. package/dist/server/deny-renderer.d.ts.map +1 -1
  657. package/dist/server/early-hints-sender.d.ts.map +1 -1
  658. package/dist/server/early-hints.d.ts +14 -12
  659. package/dist/server/early-hints.d.ts.map +1 -1
  660. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  661. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  662. package/dist/server/error-response-headers.d.ts +3 -0
  663. package/dist/server/error-response-headers.d.ts.map +1 -0
  664. package/dist/server/fallback-error.d.ts +19 -7
  665. package/dist/server/fallback-error.d.ts.map +1 -1
  666. package/dist/server/flight-injection-state.d.ts +66 -0
  667. package/dist/server/flight-injection-state.d.ts.map +1 -0
  668. package/dist/server/flight-injector-core.d.ts +125 -0
  669. package/dist/server/flight-injector-core.d.ts.map +1 -0
  670. package/dist/server/flight-scripts.d.ts +63 -0
  671. package/dist/server/flight-scripts.d.ts.map +1 -0
  672. package/dist/server/flight-source-node.d.ts +105 -0
  673. package/dist/server/flight-source-node.d.ts.map +1 -0
  674. package/dist/server/flight-source.d.ts +136 -0
  675. package/dist/server/flight-source.d.ts.map +1 -0
  676. package/dist/server/form-data.d.ts +59 -2
  677. package/dist/server/form-data.d.ts.map +1 -1
  678. package/dist/server/form-state-flight.d.ts +32 -0
  679. package/dist/server/form-state-flight.d.ts.map +1 -0
  680. package/dist/server/head-response.d.ts +35 -0
  681. package/dist/server/head-response.d.ts.map +1 -0
  682. package/dist/server/html-injector-core.d.ts +169 -0
  683. package/dist/server/html-injector-core.d.ts.map +1 -0
  684. package/dist/server/html-injectors.d.ts +77 -47
  685. package/dist/server/html-injectors.d.ts.map +1 -1
  686. package/dist/server/index.d.ts +16 -54
  687. package/dist/server/index.d.ts.map +1 -1
  688. package/dist/server/index.js +638 -3021
  689. package/dist/server/index.js.map +1 -1
  690. package/dist/server/instrumentation.d.ts +13 -5
  691. package/dist/server/instrumentation.d.ts.map +1 -1
  692. package/dist/server/internal.d.ts +47 -0
  693. package/dist/server/internal.d.ts.map +1 -0
  694. package/dist/server/internal.js +4845 -0
  695. package/dist/server/internal.js.map +1 -0
  696. package/dist/server/json-status-response.d.ts +34 -0
  697. package/dist/server/json-status-response.d.ts.map +1 -0
  698. package/dist/server/logger.d.ts +79 -7
  699. package/dist/server/logger.d.ts.map +1 -1
  700. package/dist/server/metadata-collector.d.ts +75 -0
  701. package/dist/server/metadata-collector.d.ts.map +1 -0
  702. package/dist/server/metadata-platform.d.ts +2 -2
  703. package/dist/server/metadata-render.d.ts +2 -2
  704. package/dist/server/metadata-render.d.ts.map +1 -1
  705. package/dist/server/metadata-route-links.d.ts +70 -0
  706. package/dist/server/metadata-route-links.d.ts.map +1 -0
  707. package/dist/server/metadata-routes.d.ts +47 -11
  708. package/dist/server/metadata-routes.d.ts.map +1 -1
  709. package/dist/server/metadata-social.d.ts +2 -2
  710. package/dist/server/metadata.d.ts +10 -2
  711. package/dist/server/metadata.d.ts.map +1 -1
  712. package/dist/server/middleware-runner.d.ts +20 -5
  713. package/dist/server/middleware-runner.d.ts.map +1 -1
  714. package/dist/server/node-body-response.d.ts +55 -0
  715. package/dist/server/node-body-response.d.ts.map +1 -0
  716. package/dist/server/node-response.d.ts +62 -0
  717. package/dist/server/node-response.d.ts.map +1 -0
  718. package/dist/server/node-stream-transforms.d.ts +108 -0
  719. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  720. package/dist/server/node-streams-platform.d.ts +21 -0
  721. package/dist/server/node-streams-platform.d.ts.map +1 -0
  722. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  723. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  724. package/dist/server/param-coercion.d.ts +83 -0
  725. package/dist/server/param-coercion.d.ts.map +1 -0
  726. package/dist/server/pipeline-helpers.d.ts +224 -0
  727. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  728. package/dist/server/pipeline-interception.d.ts +70 -9
  729. package/dist/server/pipeline-interception.d.ts.map +1 -1
  730. package/dist/server/pipeline-metadata.d.ts +16 -1
  731. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  732. package/dist/server/pipeline-outcome.d.ts +59 -0
  733. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  734. package/dist/server/pipeline-phases.d.ts +70 -0
  735. package/dist/server/pipeline-phases.d.ts.map +1 -0
  736. package/dist/server/pipeline.d.ts +164 -23
  737. package/dist/server/pipeline.d.ts.map +1 -1
  738. package/dist/server/port-resolution.d.ts +22 -0
  739. package/dist/server/port-resolution.d.ts.map +1 -0
  740. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  741. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  742. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  743. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  744. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  745. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  746. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  747. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  748. package/dist/server/prebuilt/dev-store.d.ts +103 -0
  749. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  750. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  751. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  752. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  753. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  754. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  755. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  756. package/dist/server/prebuilt/overlay.d.ts +105 -0
  757. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  758. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  759. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  760. package/dist/server/prebuilt/slots.d.ts +105 -0
  761. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  762. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  763. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  764. package/dist/server/prebuilt-builder.d.ts +121 -0
  765. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  766. package/dist/server/prebuilt-runtime.d.ts +105 -0
  767. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  768. package/dist/server/primitives.d.ts +101 -90
  769. package/dist/server/primitives.d.ts.map +1 -1
  770. package/dist/server/publish-params.d.ts +33 -0
  771. package/dist/server/publish-params.d.ts.map +1 -0
  772. package/dist/server/react-cache-bridge.d.ts +59 -0
  773. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  774. package/dist/server/react-cache-scope.d.ts +49 -0
  775. package/dist/server/react-cache-scope.d.ts.map +1 -0
  776. package/dist/server/render-timeout.d.ts +66 -0
  777. package/dist/server/render-timeout.d.ts.map +1 -0
  778. package/dist/server/render-utils.d.ts +35 -0
  779. package/dist/server/render-utils.d.ts.map +1 -0
  780. package/dist/server/request-context.d.ts +153 -103
  781. package/dist/server/request-context.d.ts.map +1 -1
  782. package/dist/server/request-dep.d.ts +15 -0
  783. package/dist/server/request-dep.d.ts.map +1 -0
  784. package/dist/server/response-cache-policy.d.ts +3 -0
  785. package/dist/server/response-cache-policy.d.ts.map +1 -0
  786. package/dist/server/route-element-builder.d.ts +57 -30
  787. package/dist/server/route-element-builder.d.ts.map +1 -1
  788. package/dist/server/route-element-helpers.d.ts +12 -0
  789. package/dist/server/route-element-helpers.d.ts.map +1 -0
  790. package/dist/server/route-handler.d.ts +1 -1
  791. package/dist/server/route-handler.d.ts.map +1 -1
  792. package/dist/server/route-matcher.d.ts +62 -38
  793. package/dist/server/route-matcher.d.ts.map +1 -1
  794. package/dist/server/route-module-loader.d.ts +37 -0
  795. package/dist/server/route-module-loader.d.ts.map +1 -0
  796. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  797. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  798. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  799. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  800. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  801. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  802. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  803. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  804. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  805. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  807. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  808. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  809. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/index.d.ts +30 -6
  811. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  813. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  814. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  815. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  816. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  817. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  818. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  819. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  820. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  821. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  822. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  823. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  824. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  825. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  826. package/dist/server/rsc-error-envelope.d.ts +11 -0
  827. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  828. package/dist/server/safe-load.d.ts +39 -0
  829. package/dist/server/safe-load.d.ts.map +1 -0
  830. package/dist/server/schema-introspection.d.ts +68 -0
  831. package/dist/server/schema-introspection.d.ts.map +1 -0
  832. package/dist/server/sensitive-fields.d.ts +88 -0
  833. package/dist/server/sensitive-fields.d.ts.map +1 -0
  834. package/dist/server/signal-identity.d.ts +43 -0
  835. package/dist/server/signal-identity.d.ts.map +1 -0
  836. package/dist/server/sitemap-generator.d.ts +130 -0
  837. package/dist/server/sitemap-generator.d.ts.map +1 -0
  838. package/dist/server/sitemap-handler.d.ts +22 -0
  839. package/dist/server/sitemap-handler.d.ts.map +1 -0
  840. package/dist/server/skippable-prefix.d.ts +29 -0
  841. package/dist/server/skippable-prefix.d.ts.map +1 -0
  842. package/dist/server/slot-interception.d.ts +80 -0
  843. package/dist/server/slot-interception.d.ts.map +1 -0
  844. package/dist/server/slot-resolver.d.ts +138 -7
  845. package/dist/server/slot-resolver.d.ts.map +1 -1
  846. package/dist/server/slot-subtree-contain.d.ts +54 -0
  847. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  848. package/dist/server/ssr-bridge-types.d.ts +213 -0
  849. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  850. package/dist/server/ssr-entry.d.ts +15 -51
  851. package/dist/server/ssr-entry.d.ts.map +1 -1
  852. package/dist/server/ssr-form-state.d.ts +30 -0
  853. package/dist/server/ssr-form-state.d.ts.map +1 -0
  854. package/dist/server/ssr-render.d.ts +59 -32
  855. package/dist/server/ssr-render.d.ts.map +1 -1
  856. package/dist/server/ssr-wrappers.d.ts +93 -0
  857. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  858. package/dist/server/state-tree-diff.d.ts +44 -9
  859. package/dist/server/state-tree-diff.d.ts.map +1 -1
  860. package/dist/server/static-generator.d.ts +112 -0
  861. package/dist/server/static-generator.d.ts.map +1 -0
  862. package/dist/server/static-not-found.d.ts +52 -0
  863. package/dist/server/static-not-found.d.ts.map +1 -0
  864. package/dist/server/status-code-resolver.d.ts +26 -15
  865. package/dist/server/status-code-resolver.d.ts.map +1 -1
  866. package/dist/server/stream-utils.d.ts +93 -0
  867. package/dist/server/stream-utils.d.ts.map +1 -0
  868. package/dist/server/tracing.d.ts +57 -26
  869. package/dist/server/tracing.d.ts.map +1 -1
  870. package/dist/server/tree-match.d.ts +59 -0
  871. package/dist/server/tree-match.d.ts.map +1 -0
  872. package/dist/server/types.d.ts +89 -8
  873. package/dist/server/types.d.ts.map +1 -1
  874. package/dist/server/utils/element-type.d.ts +50 -0
  875. package/dist/server/utils/element-type.d.ts.map +1 -0
  876. package/dist/server/utils/escape-html.d.ts +14 -0
  877. package/dist/server/utils/escape-html.d.ts.map +1 -0
  878. package/dist/server/version-skew.d.ts +61 -0
  879. package/dist/server/version-skew.d.ts.map +1 -0
  880. package/dist/server/workers-cache-bridge.d.ts +26 -0
  881. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  882. package/dist/shared/als-slots.d.ts +42 -0
  883. package/dist/shared/als-slots.d.ts.map +1 -0
  884. package/dist/shared/base-path.d.ts +56 -0
  885. package/dist/shared/base-path.d.ts.map +1 -0
  886. package/dist/shared/csrf-reject.d.ts +16 -0
  887. package/dist/shared/csrf-reject.d.ts.map +1 -0
  888. package/dist/shared/error-digest.d.ts +28 -0
  889. package/dist/shared/error-digest.d.ts.map +1 -0
  890. package/dist/shared/flight-base64.d.ts +13 -0
  891. package/dist/shared/flight-base64.d.ts.map +1 -0
  892. package/dist/shared/flight-segment.d.ts +18 -0
  893. package/dist/shared/flight-segment.d.ts.map +1 -0
  894. package/dist/shared/form-state-flight.d.ts +32 -0
  895. package/dist/shared/form-state-flight.d.ts.map +1 -0
  896. package/dist/shared/href-validation.d.ts +49 -0
  897. package/dist/shared/href-validation.d.ts.map +1 -0
  898. package/dist/shared/merge-search-params.d.ts +22 -0
  899. package/dist/shared/merge-search-params.d.ts.map +1 -0
  900. package/dist/shared/param-value.d.ts +104 -0
  901. package/dist/shared/param-value.d.ts.map +1 -0
  902. package/dist/shared/payload-root.d.ts +110 -0
  903. package/dist/shared/payload-root.d.ts.map +1 -0
  904. package/dist/shared/redirect-type.d.ts +17 -0
  905. package/dist/shared/redirect-type.d.ts.map +1 -0
  906. package/dist/shared/rsc-cache-key.d.ts +163 -0
  907. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  908. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  909. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  910. package/dist/shared/rsc-manifest.d.ts +28 -0
  911. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  912. package/dist/shared/rsc-media-type.d.ts +52 -0
  913. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  914. package/dist/shared/rsc-payload-path.d.ts +48 -0
  915. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  916. package/dist/shared/segment-info.d.ts +66 -0
  917. package/dist/shared/segment-info.d.ts.map +1 -0
  918. package/dist/shared/slot-params.d.ts +52 -0
  919. package/dist/shared/slot-params.d.ts.map +1 -0
  920. package/dist/shared/static-platform-files.d.ts +71 -0
  921. package/dist/shared/static-platform-files.d.ts.map +1 -0
  922. package/dist/shared/status-reason-phrase.d.ts +26 -0
  923. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  924. package/dist/shims/font-google.d.ts +1 -1
  925. package/dist/shims/font-google.d.ts.map +1 -1
  926. package/dist/shims/font-google.js +42 -0
  927. package/dist/shims/font-google.js.map +1 -0
  928. package/dist/shims/font-local.d.ts +26 -0
  929. package/dist/shims/font-local.d.ts.map +1 -0
  930. package/dist/shims/font-local.js +20 -0
  931. package/dist/shims/font-local.js.map +1 -0
  932. package/dist/shims/headers.d.ts +53 -1
  933. package/dist/shims/headers.d.ts.map +1 -1
  934. package/dist/shims/image.d.ts +120 -120
  935. package/dist/shims/image.d.ts.map +1 -1
  936. package/dist/shims/navigation-client.d.ts +25 -12
  937. package/dist/shims/navigation-client.d.ts.map +1 -1
  938. package/dist/shims/navigation-rsc.d.ts +21 -0
  939. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  940. package/dist/shims/navigation.d.ts +10 -5
  941. package/dist/shims/navigation.d.ts.map +1 -1
  942. package/dist/utils/state-machine.d.ts +80 -0
  943. package/dist/utils/state-machine.d.ts.map +1 -0
  944. package/dist/utils/write-file-atomic.d.ts +17 -0
  945. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  946. package/docs/api/30-api-server.mdx +239 -0
  947. package/docs/api/31-api-client.mdx +199 -0
  948. package/docs/api/32-api-cache.mdx +341 -0
  949. package/docs/api/33-api-search-params.mdx +176 -0
  950. package/docs/api/34-api-config.mdx +359 -0
  951. package/docs/api/35-api-typescript.mdx +91 -0
  952. package/docs/api/36-cli.mdx +206 -0
  953. package/docs/learn/00-introduction.mdx +109 -0
  954. package/docs/learn/01-quick-start.mdx +94 -0
  955. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  956. package/docs/learn/03-fetching-data.mdx +227 -0
  957. package/docs/learn/04-access-control.mdx +115 -0
  958. package/docs/learn/05-the-flush-point.mdx +175 -0
  959. package/docs/learn/06-typed-params.mdx +275 -0
  960. package/docs/learn/07-typed-routes.mdx +108 -0
  961. package/docs/learn/08-forms-and-actions.mdx +260 -0
  962. package/docs/learn/09-streaming.mdx +140 -0
  963. package/docs/learn/10-caching.mdx +282 -0
  964. package/docs/learn/11-middleware.mdx +166 -0
  965. package/docs/learn/12-error-handling.mdx +192 -0
  966. package/docs/learn/13-deploying.mdx +289 -0
  967. package/llms.txt +55 -0
  968. package/package.json +120 -29
  969. package/src/adapters/build-output-helper.ts +353 -0
  970. package/src/adapters/canonicalize-module.ts +29 -0
  971. package/src/adapters/cloudflare-dev.ts +183 -0
  972. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  973. package/src/adapters/cloudflare.ts +809 -150
  974. package/src/adapters/compress-module.ts +110 -86
  975. package/src/adapters/fs-identity.ts +155 -0
  976. package/src/adapters/nitro-immutable-assets.ts +142 -0
  977. package/src/adapters/nitro-presets.ts +124 -0
  978. package/src/adapters/nitro-preview.ts +533 -0
  979. package/src/adapters/nitro.ts +331 -445
  980. package/src/adapters/raw-imports.d.ts +5 -0
  981. package/src/adapters/shared.ts +283 -0
  982. package/src/adapters/types.ts +129 -17
  983. package/src/adapters/wrangler.d.ts +7 -0
  984. package/src/analyze/chains.ts +411 -0
  985. package/src/analyze/classify.ts +259 -0
  986. package/src/analyze/crawl-entry.ts +68 -0
  987. package/src/analyze/crawl.ts +500 -0
  988. package/src/analyze/graph-cache.ts +331 -0
  989. package/src/analyze/graph-command.ts +762 -0
  990. package/src/analyze/live-graph.ts +232 -0
  991. package/src/analyze/poison-rules.ts +165 -0
  992. package/src/analyze/poison-scan.ts +159 -0
  993. package/src/analyze/scan.ts +149 -0
  994. package/src/cache/cache-api.ts +113 -0
  995. package/src/cache/fast-hash.ts +5 -0
  996. package/src/cache/handler-store.ts +113 -0
  997. package/src/cache/index.ts +115 -22
  998. package/src/cache/invalidation-epoch.ts +105 -0
  999. package/src/cache/json-lossy-check.ts +69 -0
  1000. package/src/cache/redis-handler.ts +198 -20
  1001. package/src/cache/singleflight.ts +72 -6
  1002. package/src/cache/sizeof.ts +35 -0
  1003. package/src/cache/stable-stringify.ts +65 -2
  1004. package/src/cache/store.ts +71 -0
  1005. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1006. package/src/cache/stores/memory.ts +125 -0
  1007. package/src/cache/stores/redis.ts +97 -0
  1008. package/src/cache/stores/vercel.ts +59 -0
  1009. package/src/cache/tag-aware-handler.ts +254 -0
  1010. package/src/cache/timber-cache.ts +169 -40
  1011. package/src/cdn/cloudflare-purge.ts +50 -0
  1012. package/src/cdn/fastly-purge.ts +63 -0
  1013. package/src/cdn/headers.ts +153 -0
  1014. package/src/cdn/index.ts +23 -0
  1015. package/src/cdn/purge-store.ts +62 -0
  1016. package/src/cdn/workers-cache-purge.ts +34 -0
  1017. package/src/cli-check.ts +417 -0
  1018. package/src/cli-context.ts +119 -0
  1019. package/src/cli-schema-sync.ts +401 -0
  1020. package/src/cli.ts +334 -80
  1021. package/src/client/browser-dev.ts +192 -5
  1022. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1023. package/src/client/browser-entry/action-queue.ts +152 -0
  1024. package/src/client/browser-entry/form-state.ts +49 -0
  1025. package/src/client/browser-entry/hmr.ts +70 -0
  1026. package/src/client/browser-entry/hydrate.ts +152 -0
  1027. package/src/client/browser-entry/index.ts +150 -0
  1028. package/src/client/browser-entry/post-hydration.ts +99 -0
  1029. package/src/client/browser-entry/router-init.ts +391 -0
  1030. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1031. package/src/client/browser-entry/scroll.ts +50 -0
  1032. package/src/client/deny-last-resort.tsx +54 -0
  1033. package/src/client/error-boundary.tsx +279 -61
  1034. package/src/client/error-reconstituter.tsx +84 -0
  1035. package/src/client/form.tsx +61 -173
  1036. package/src/client/global-context.ts +31 -0
  1037. package/src/client/history.ts +74 -11
  1038. package/src/client/index.ts +90 -53
  1039. package/src/client/internal.ts +54 -0
  1040. package/src/client/link.tsx +464 -151
  1041. package/src/client/location-search.ts +15 -0
  1042. package/src/client/navigation-api.ts +254 -0
  1043. package/src/client/navigation-commit.ts +318 -0
  1044. package/src/client/navigation-context.ts +67 -134
  1045. package/src/client/navigation-root.tsx +236 -0
  1046. package/src/client/navigation-transition.ts +401 -0
  1047. package/src/client/nuqs-adapter.tsx +21 -9
  1048. package/src/client/params-context.ts +187 -0
  1049. package/src/client/react-root.ts +105 -0
  1050. package/src/client/router-effects.ts +349 -0
  1051. package/src/client/router-lifecycle.ts +374 -0
  1052. package/src/client/router-pipeline.ts +443 -0
  1053. package/src/client/router-ref.ts +3 -3
  1054. package/src/client/router-skew.ts +30 -0
  1055. package/src/client/router-types.ts +326 -0
  1056. package/src/client/router-url.ts +32 -0
  1057. package/src/client/router.ts +491 -421
  1058. package/src/client/rsc-fetch.ts +510 -109
  1059. package/src/client/segment-cache.ts +362 -41
  1060. package/src/client/segment-context.ts +7 -4
  1061. package/src/client/segment-outlet.tsx +96 -0
  1062. package/src/client/segment-update-context.ts +23 -0
  1063. package/src/client/shallow-url.ts +22 -0
  1064. package/src/client/slot-content-cache-context.ts +43 -0
  1065. package/src/client/slot-context.ts +50 -0
  1066. package/src/client/slot-outlet.tsx +22 -0
  1067. package/src/client/slot-provider.tsx +32 -0
  1068. package/src/client/ssr-data.ts +27 -67
  1069. package/src/client/stale-client.ts +191 -0
  1070. package/src/client/state.ts +31 -24
  1071. package/src/client/status-page-marker.tsx +32 -0
  1072. package/src/client/top-loader.tsx +13 -10
  1073. package/src/client/unload-guard.ts +35 -3
  1074. package/src/client/use-cookie.ts +70 -18
  1075. package/src/client/use-field-state.ts +144 -0
  1076. package/src/client/use-link-status.ts +7 -7
  1077. package/src/client/use-pathname.ts +22 -31
  1078. package/src/client/use-pending-navigation.ts +40 -0
  1079. package/src/client/use-query-states.ts +206 -36
  1080. package/src/client/use-router.ts +31 -9
  1081. package/src/client/use-search-params.ts +38 -49
  1082. package/src/client/use-segment-params.ts +69 -0
  1083. package/src/client/use-selected-layout-segment.ts +2 -2
  1084. package/src/codec.ts +149 -0
  1085. package/src/config-types.ts +321 -0
  1086. package/src/config-validation.ts +464 -0
  1087. package/src/cookies/define-cookie.ts +222 -53
  1088. package/src/cookies/index.ts +13 -2
  1089. package/src/cookies/json-cookie.ts +105 -0
  1090. package/src/cookies/validation.ts +192 -0
  1091. package/src/dev-tools/404-page.ts +286 -0
  1092. package/src/dev-tools/browser-logs.ts +55 -0
  1093. package/src/dev-tools/dev-page-shell.ts +278 -0
  1094. package/src/dev-tools/error-page.ts +331 -0
  1095. package/src/dev-tools/holding-server.ts +185 -0
  1096. package/src/dev-tools/hydration-overlay.ts +158 -0
  1097. package/src/dev-tools/index.ts +79 -0
  1098. package/src/dev-tools/instrumentation.ts +261 -0
  1099. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1100. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +147 -25
  1101. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1102. package/src/dev-tools/stack-classifier.ts +75 -0
  1103. package/src/dev-tools/terminal.ts +182 -0
  1104. package/src/fonts/ast-walk.ts +235 -0
  1105. package/src/fonts/ast.ts +479 -128
  1106. package/src/fonts/bundle.ts +138 -0
  1107. package/src/fonts/css.ts +1 -1
  1108. package/src/fonts/dev-middleware.ts +85 -0
  1109. package/src/fonts/fallbacks.ts +0 -23
  1110. package/src/fonts/google.ts +101 -19
  1111. package/src/fonts/local.ts +12 -11
  1112. package/src/fonts/paths.ts +58 -0
  1113. package/src/fonts/pipeline.ts +348 -0
  1114. package/src/fonts/transform.ts +311 -0
  1115. package/src/fonts/types.ts +52 -1
  1116. package/src/fonts/virtual-modules.ts +179 -0
  1117. package/src/index.ts +492 -380
  1118. package/src/params/codec-registry.ts +34 -0
  1119. package/src/params/define-schema.ts +115 -0
  1120. package/src/params/index.ts +17 -0
  1121. package/src/params/resolve-schema.ts +84 -0
  1122. package/src/plugin-context.ts +502 -0
  1123. package/src/plugins/build-manifest.ts +189 -36
  1124. package/src/plugins/build-report.ts +299 -87
  1125. package/src/plugins/cache.ts +243 -0
  1126. package/src/plugins/callsite-ast.ts +472 -0
  1127. package/src/plugins/callsite-jsx.ts +243 -0
  1128. package/src/plugins/chunks.ts +74 -5
  1129. package/src/plugins/client-chunks.ts +185 -0
  1130. package/src/plugins/client-dep-entries.ts +124 -0
  1131. package/src/plugins/cloudflare-wasm.ts +141 -0
  1132. package/src/plugins/content.ts +31 -2
  1133. package/src/plugins/dev-discovery.ts +218 -0
  1134. package/src/plugins/dev-server.ts +376 -98
  1135. package/src/plugins/encryption-runtime.ts +31 -0
  1136. package/src/plugins/entries.ts +156 -17
  1137. package/src/plugins/fonts.ts +260 -657
  1138. package/src/plugins/graph-endpoint.ts +532 -0
  1139. package/src/plugins/mdx.ts +108 -35
  1140. package/src/plugins/orphaned-modules.ts +78 -0
  1141. package/src/plugins/post-build.ts +327 -0
  1142. package/src/plugins/prebuilt-capture.ts +213 -0
  1143. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1144. package/src/plugins/prebuilt.ts +670 -0
  1145. package/src/plugins/prerender-sugar.ts +348 -0
  1146. package/src/plugins/react-resolve.ts +149 -0
  1147. package/src/plugins/request-dep/analysis.ts +447 -0
  1148. package/src/plugins/request-dep/index.ts +376 -0
  1149. package/src/plugins/request-dep/origin.ts +310 -0
  1150. package/src/plugins/routing.ts +296 -278
  1151. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1152. package/src/plugins/server-bundle.ts +115 -15
  1153. package/src/plugins/shims.ts +257 -97
  1154. package/src/plugins/static-build.ts +681 -71
  1155. package/src/react-canary.d.ts +2 -0
  1156. package/src/routing/codegen-shared.ts +39 -0
  1157. package/src/routing/codegen-types.ts +62 -0
  1158. package/src/routing/codegen-write.ts +163 -0
  1159. package/src/routing/codegen.ts +349 -232
  1160. package/src/routing/collision-probe.ts +438 -0
  1161. package/src/routing/collision-spaces.ts +281 -0
  1162. package/src/routing/convention-lint.ts +651 -0
  1163. package/src/routing/export-detect.ts +536 -0
  1164. package/src/routing/file-cache.ts +23 -0
  1165. package/src/routing/index.ts +16 -7
  1166. package/src/routing/interception-overlap.ts +141 -0
  1167. package/src/routing/interception.ts +1044 -67
  1168. package/src/routing/link-codegen.ts +280 -0
  1169. package/src/routing/manifest-codegen.ts +232 -0
  1170. package/src/routing/scanner.ts +417 -223
  1171. package/src/routing/schema-validation.ts +155 -0
  1172. package/src/routing/segment-classify.ts +280 -0
  1173. package/src/routing/segment-codegen.ts +99 -0
  1174. package/src/routing/segment-keys.ts +186 -0
  1175. package/src/routing/slot-placement.ts +97 -0
  1176. package/src/routing/types.ts +82 -26
  1177. package/src/routing/walkers.ts +98 -0
  1178. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1179. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1180. package/src/rsc-runtime/render-flight.ts +26 -0
  1181. package/src/rsc-runtime/rsc.ts +27 -2
  1182. package/src/rsc-runtime/ssr.ts +23 -0
  1183. package/src/rsc-runtime/transforms.ts +13 -0
  1184. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1185. package/src/schema-bridge.ts +382 -0
  1186. package/src/search-params/define.ts +677 -0
  1187. package/src/search-params/index.ts +14 -20
  1188. package/src/search-params/parse-total.ts +91 -0
  1189. package/src/search-params/serialize-equal.ts +14 -0
  1190. package/src/search-params/wrappers.ts +150 -0
  1191. package/src/server/abort-scope.ts +49 -0
  1192. package/src/server/access-gate.tsx +195 -56
  1193. package/src/server/action-client.ts +175 -294
  1194. package/src/server/action-encryption.ts +144 -0
  1195. package/src/server/action-handler.ts +492 -150
  1196. package/src/server/action-schema.ts +203 -0
  1197. package/src/server/action-types.ts +145 -0
  1198. package/src/server/actions.ts +172 -85
  1199. package/src/server/als-registry.ts +245 -30
  1200. package/src/server/body-limits.ts +10 -2
  1201. package/src/server/build-manifest.ts +33 -57
  1202. package/src/server/canonicalize.ts +35 -3
  1203. package/src/server/chain-url-parts.ts +163 -0
  1204. package/src/server/children-interception.ts +116 -0
  1205. package/src/server/client-error-message.ts +18 -0
  1206. package/src/server/coalesce-tick.ts +75 -0
  1207. package/src/server/compress.ts +91 -19
  1208. package/src/server/cookie-context.ts +454 -0
  1209. package/src/server/cookie-parsing.ts +163 -0
  1210. package/src/server/csp-nonce.ts +58 -0
  1211. package/src/server/csrf.ts +228 -35
  1212. package/src/server/debug.ts +0 -1
  1213. package/src/server/default-logger.ts +100 -0
  1214. package/src/server/default-status-page.ts +88 -0
  1215. package/src/server/deny-boundary.ts +527 -0
  1216. package/src/server/deny-renderer.ts +210 -181
  1217. package/src/server/early-hints-sender.ts +4 -3
  1218. package/src/server/early-hints.ts +39 -29
  1219. package/src/server/error-boundary-wrapper.ts +160 -44
  1220. package/src/server/error-response-headers.ts +18 -0
  1221. package/src/server/fallback-error.ts +88 -104
  1222. package/src/server/flight-injection-state.ts +113 -0
  1223. package/src/server/flight-injector-core.ts +328 -0
  1224. package/src/server/flight-scripts.ts +92 -0
  1225. package/src/server/flight-source-node.ts +431 -0
  1226. package/src/server/flight-source.ts +288 -0
  1227. package/src/server/form-data.ts +191 -20
  1228. package/src/server/form-state-flight.ts +67 -0
  1229. package/src/server/head-response.ts +50 -0
  1230. package/src/server/html-injector-core.ts +320 -0
  1231. package/src/server/html-injectors.ts +241 -285
  1232. package/src/server/index.ts +37 -195
  1233. package/src/server/instrumentation.ts +42 -11
  1234. package/src/server/internal.ts +163 -0
  1235. package/src/server/json-status-response.ts +105 -0
  1236. package/src/server/logger.ts +131 -38
  1237. package/src/server/metadata-collector.ts +175 -0
  1238. package/src/server/metadata-platform.ts +2 -2
  1239. package/src/server/metadata-render.ts +30 -8
  1240. package/src/server/metadata-route-links.ts +200 -0
  1241. package/src/server/metadata-routes.ts +114 -24
  1242. package/src/server/metadata-social.ts +2 -2
  1243. package/src/server/metadata.ts +23 -2
  1244. package/src/server/middleware-runner.ts +32 -5
  1245. package/src/server/node-body-response.ts +236 -0
  1246. package/src/server/node-response.ts +93 -0
  1247. package/src/server/node-stream-transforms.ts +340 -0
  1248. package/src/server/node-streams-platform.ts +23 -0
  1249. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1250. package/src/server/param-coercion.ts +201 -0
  1251. package/src/server/pipeline-helpers.ts +550 -0
  1252. package/src/server/pipeline-interception.ts +241 -32
  1253. package/src/server/pipeline-metadata.ts +25 -1
  1254. package/src/server/pipeline-outcome.ts +290 -0
  1255. package/src/server/pipeline-phases.ts +503 -0
  1256. package/src/server/pipeline.ts +435 -427
  1257. package/src/server/port-resolution.ts +43 -0
  1258. package/src/server/prebuilt/cache-key.ts +340 -0
  1259. package/src/server/prebuilt/capture-render.ts +122 -0
  1260. package/src/server/prebuilt/capture-routes.ts +104 -0
  1261. package/src/server/prebuilt/capture-state.ts +196 -0
  1262. package/src/server/prebuilt/dev-store.ts +173 -0
  1263. package/src/server/prebuilt/key-discipline.ts +122 -0
  1264. package/src/server/prebuilt/lifetime.ts +151 -0
  1265. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1266. package/src/server/prebuilt/overlay.ts +262 -0
  1267. package/src/server/prebuilt/payload-source.ts +221 -0
  1268. package/src/server/prebuilt/slots.ts +201 -0
  1269. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1270. package/src/server/prebuilt-builder.ts +515 -0
  1271. package/src/server/prebuilt-runtime.ts +808 -0
  1272. package/src/server/primitives.ts +153 -171
  1273. package/src/server/publish-params.ts +42 -0
  1274. package/src/server/react-cache-bridge.ts +124 -0
  1275. package/src/server/react-cache-scope.ts +104 -0
  1276. package/src/server/render-timeout.ts +123 -0
  1277. package/src/server/render-utils.ts +45 -0
  1278. package/src/server/request-context.ts +298 -324
  1279. package/src/server/request-dep.ts +37 -0
  1280. package/src/server/response-cache-policy.ts +45 -0
  1281. package/src/server/route-element-builder.ts +526 -355
  1282. package/src/server/route-element-helpers.ts +37 -0
  1283. package/src/server/route-handler.ts +67 -27
  1284. package/src/server/route-matcher.ts +238 -267
  1285. package/src/server/route-module-loader.ts +161 -0
  1286. package/src/server/rsc-cache-key-guard.ts +122 -0
  1287. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1288. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1289. package/src/server/rsc-entry/api-handler.ts +49 -81
  1290. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1291. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1292. package/src/server/rsc-entry/helpers.ts +90 -115
  1293. package/src/server/rsc-entry/index.ts +405 -349
  1294. package/src/server/rsc-entry/render-route.ts +248 -0
  1295. package/src/server/rsc-entry/render-signals.ts +108 -0
  1296. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1297. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1298. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1299. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1300. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1301. package/src/server/rsc-error-envelope.ts +18 -0
  1302. package/src/server/rsc-prop-warnings.ts +1 -1
  1303. package/src/server/safe-load.ts +53 -0
  1304. package/src/server/schema-introspection.ts +393 -0
  1305. package/src/server/sensitive-fields.ts +287 -0
  1306. package/src/server/server-only-guard-noop.js +3 -0
  1307. package/src/server/server-timing.ts +1 -1
  1308. package/src/server/signal-identity.ts +112 -0
  1309. package/src/server/sitemap-generator.ts +337 -0
  1310. package/src/server/sitemap-handler.ts +150 -0
  1311. package/src/server/skippable-prefix.ts +172 -0
  1312. package/src/server/slot-interception.ts +168 -0
  1313. package/src/server/slot-resolver.ts +707 -300
  1314. package/src/server/slot-subtree-contain.ts +273 -0
  1315. package/src/server/ssr-bridge-types.ts +217 -0
  1316. package/src/server/ssr-entry.ts +248 -109
  1317. package/src/server/ssr-form-state.ts +58 -0
  1318. package/src/server/ssr-render.ts +332 -101
  1319. package/src/server/ssr-wrappers.tsx +162 -0
  1320. package/src/server/state-tree-diff.ts +85 -30
  1321. package/src/server/static-generator.ts +680 -0
  1322. package/src/server/static-not-found.ts +134 -0
  1323. package/src/server/status-code-resolver.ts +107 -148
  1324. package/src/server/stream-utils.ts +398 -0
  1325. package/src/server/tracing.ts +163 -68
  1326. package/src/server/tree-match.ts +494 -0
  1327. package/src/server/types.ts +96 -11
  1328. package/src/server/utils/element-type.ts +88 -0
  1329. package/src/server/utils/escape-html.ts +20 -0
  1330. package/src/server/version-skew.ts +104 -0
  1331. package/src/server/waituntil-bridge.ts +1 -1
  1332. package/src/server/workers-cache-bridge.ts +33 -0
  1333. package/src/shared/als-slots.ts +74 -0
  1334. package/src/shared/base-path.ts +80 -0
  1335. package/src/shared/csrf-reject.ts +15 -0
  1336. package/src/shared/error-digest.ts +46 -0
  1337. package/src/shared/flight-base64.ts +23 -0
  1338. package/src/shared/flight-segment.ts +35 -0
  1339. package/src/shared/form-state-flight.ts +59 -0
  1340. package/src/shared/href-validation.ts +159 -0
  1341. package/src/shared/merge-search-params.ts +55 -0
  1342. package/src/shared/param-value.ts +281 -0
  1343. package/src/shared/payload-root.ts +153 -0
  1344. package/src/shared/redirect-type.ts +17 -0
  1345. package/src/shared/rsc-cache-key.ts +269 -0
  1346. package/src/shared/rsc-error-envelope.ts +16 -0
  1347. package/src/shared/rsc-manifest.ts +29 -0
  1348. package/src/shared/rsc-media-type.ts +59 -0
  1349. package/src/shared/rsc-payload-path.ts +52 -0
  1350. package/src/shared/segment-info.ts +67 -0
  1351. package/src/shared/slot-params.ts +109 -0
  1352. package/src/shared/static-platform-files.ts +75 -0
  1353. package/src/shared/status-reason-phrase.ts +61 -0
  1354. package/src/shims/font-google.ts +1 -1
  1355. package/src/shims/font-local.ts +34 -0
  1356. package/src/shims/headers.ts +122 -1
  1357. package/src/shims/navigation-client.ts +36 -32
  1358. package/src/shims/navigation-rsc.ts +47 -0
  1359. package/src/shims/navigation.ts +10 -7
  1360. package/src/utils/state-machine.ts +111 -0
  1361. package/src/utils/write-file-atomic.ts +32 -0
  1362. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1363. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1364. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1365. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1366. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1367. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1368. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1369. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1370. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1371. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1372. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1373. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1374. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1375. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1376. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1377. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1378. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1379. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1380. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1381. package/dist/adapters/cloudflare.js.map +0 -1
  1382. package/dist/cache/index.js.map +0 -1
  1383. package/dist/cache/register-cached-function.d.ts +0 -17
  1384. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1385. package/dist/client/browser-entry.d.ts +0 -21
  1386. package/dist/client/browser-entry.d.ts.map +0 -1
  1387. package/dist/client/error-boundary.js.map +0 -1
  1388. package/dist/client/head.d.ts +0 -16
  1389. package/dist/client/head.d.ts.map +0 -1
  1390. package/dist/client/link-status-provider.d.ts +0 -11
  1391. package/dist/client/link-status-provider.d.ts.map +0 -1
  1392. package/dist/client/segment-merger.d.ts +0 -119
  1393. package/dist/client/segment-merger.d.ts.map +0 -1
  1394. package/dist/client/stale-reload.d.ts +0 -44
  1395. package/dist/client/stale-reload.d.ts.map +0 -1
  1396. package/dist/client/transition-root.d.ts +0 -74
  1397. package/dist/client/transition-root.d.ts.map +0 -1
  1398. package/dist/client/types.d.ts +0 -14
  1399. package/dist/client/types.d.ts.map +0 -1
  1400. package/dist/client/use-navigation-pending.d.ts +0 -26
  1401. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1402. package/dist/client/use-params.d.ts +0 -92
  1403. package/dist/client/use-params.d.ts.map +0 -1
  1404. package/dist/content/index.d.ts +0 -11
  1405. package/dist/content/index.d.ts.map +0 -1
  1406. package/dist/content/index.js +0 -2
  1407. package/dist/plugins/adapter-build.d.ts +0 -18
  1408. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1409. package/dist/plugins/cache-transform.d.ts +0 -36
  1410. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1411. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1412. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1413. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1414. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1415. package/dist/plugins/server-action-exports.d.ts +0 -26
  1416. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1417. package/dist/routing/status-file-lint.d.ts +0 -33
  1418. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1419. package/dist/search-params/analyze.d.ts +0 -54
  1420. package/dist/search-params/analyze.d.ts.map +0 -1
  1421. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1422. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1423. package/dist/search-params/codecs.d.ts +0 -53
  1424. package/dist/search-params/codecs.d.ts.map +0 -1
  1425. package/dist/search-params/create.d.ts +0 -106
  1426. package/dist/search-params/create.d.ts.map +0 -1
  1427. package/dist/search-params/registry.d.ts +0 -20
  1428. package/dist/search-params/registry.d.ts.map +0 -1
  1429. package/dist/server/asset-headers.d.ts +0 -42
  1430. package/dist/server/asset-headers.d.ts.map +0 -1
  1431. package/dist/server/client-module-map.d.ts +0 -47
  1432. package/dist/server/client-module-map.d.ts.map +0 -1
  1433. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1434. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1435. package/dist/server/dev-logger.d.ts.map +0 -1
  1436. package/dist/server/dev-span-processor.d.ts +0 -29
  1437. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1438. package/dist/server/dev-warnings.d.ts +0 -129
  1439. package/dist/server/dev-warnings.d.ts.map +0 -1
  1440. package/dist/server/flush.d.ts +0 -74
  1441. package/dist/server/flush.d.ts.map +0 -1
  1442. package/dist/server/form-flash.d.ts +0 -78
  1443. package/dist/server/form-flash.d.ts.map +0 -1
  1444. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1445. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1446. package/dist/server/prerender.d.ts +0 -77
  1447. package/dist/server/prerender.d.ts.map +0 -1
  1448. package/dist/server/tree-builder.d.ts +0 -126
  1449. package/dist/server/tree-builder.d.ts.map +0 -1
  1450. package/dist/utils/directive-parser.d.ts +0 -70
  1451. package/dist/utils/directive-parser.d.ts.map +0 -1
  1452. package/src/cache/register-cached-function.ts +0 -103
  1453. package/src/client/browser-entry.ts +0 -678
  1454. package/src/client/head.ts +0 -61
  1455. package/src/client/link-status-provider.tsx +0 -30
  1456. package/src/client/segment-merger.ts +0 -339
  1457. package/src/client/stale-reload.ts +0 -87
  1458. package/src/client/transition-root.tsx +0 -166
  1459. package/src/client/types.ts +0 -21
  1460. package/src/client/use-navigation-pending.ts +0 -38
  1461. package/src/client/use-params.ts +0 -141
  1462. package/src/content/index.ts +0 -13
  1463. package/src/plugins/adapter-build.ts +0 -118
  1464. package/src/plugins/cache-transform.ts +0 -199
  1465. package/src/plugins/dynamic-transform.ts +0 -161
  1466. package/src/plugins/server-action-exports.ts +0 -220
  1467. package/src/routing/status-file-lint.ts +0 -112
  1468. package/src/search-params/analyze.ts +0 -192
  1469. package/src/search-params/builtin-codecs.ts +0 -228
  1470. package/src/search-params/codecs.ts +0 -153
  1471. package/src/search-params/create.ts +0 -321
  1472. package/src/search-params/registry.ts +0 -31
  1473. package/src/server/asset-headers.ts +0 -81
  1474. package/src/server/client-module-map.ts +0 -58
  1475. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1476. package/src/server/dev-span-processor.ts +0 -78
  1477. package/src/server/dev-warnings.ts +0 -283
  1478. package/src/server/flush.ts +0 -182
  1479. package/src/server/form-flash.ts +0 -89
  1480. package/src/server/manifest-status-resolver.ts +0 -215
  1481. package/src/server/prerender.ts +0 -139
  1482. package/src/server/tree-builder.ts +0 -382
  1483. package/src/shims/server-only-noop.js +0 -6
  1484. package/src/utils/directive-parser.ts +0 -529
@@ -2,26 +2,25 @@
2
2
  * Request pipeline — the central dispatch for all timber.js requests.
3
3
  *
4
4
  * Pipeline stages (in order):
5
- * proxy.ts → canonicalize → route match → 103 Early Hints → middleware.ts → render
5
+ * canonicalize → CSRF gate → proxy.ts → route match → 103 Early Hints → middleware.ts → render
6
6
  *
7
- * Each stage is a pure function or returns a Response to short-circuit.
8
- * Each request gets a trace ID, structured logging, and OTEL spans.
7
+ * The phase functions live in `pipeline-phases.ts` so each phase can be
8
+ * tested in isolation. The terminal `outcomeToResponse` translator and
9
+ * stateless helpers live in `pipeline-phases.ts` and `pipeline-helpers.ts`
10
+ * respectively. This file owns only the public type surface and the
11
+ * `createPipeline` entry point: trace ID setup, request-context ALS,
12
+ * Server-Timing wrapping, and the activeRequests counter.
9
13
  *
10
14
  * See design/07-routing.md §"Request Lifecycle", design/02-rendering-pipeline.md §"Request Flow",
11
15
  * and design/17-logging.md §"Production Logging"
12
16
  */
13
17
 
14
- import { canonicalize } from './canonicalize.js';
15
- import { runProxy, type ProxyExport } from './proxy.js';
16
- import { runMiddleware, type MiddlewareFn } from './middleware-runner.js';
17
- import { runWithTimingCollector, withTiming, getServerTimingHeader } from './server-timing.js';
18
- import {
19
- runWithRequestContext,
20
- applyRequestHeaderOverlay,
21
- setMutableCookieContext,
22
- getSetCookieHeaders,
23
- markResponseFlushed,
24
- } from './request-context.js';
18
+ import type { CoercedParams } from '../shared/param-value.ts';
19
+ import type { ProxyExport } from './proxy.ts';
20
+ import type { MiddlewareFn } from './middleware-runner.ts';
21
+ import { runWithTimingCollector, getServerTimingHeader } from './server-timing.ts';
22
+ import { wrapResponseWithStreamTiming } from './stream-utils.ts';
23
+ import { runWithRequestContext } from './request-context.ts';
25
24
  import {
26
25
  generateTraceId,
27
26
  runWithTraceId,
@@ -29,34 +28,52 @@ import {
29
28
  replaceTraceId,
30
29
  withSpan,
31
30
  setSpanAttribute,
32
- traceId,
33
- } from './tracing.js';
34
- import {
35
- logRequestReceived,
36
- logRequestCompleted,
37
- logSlowRequest,
38
- logProxyError,
39
- logMiddlewareError,
40
- logMiddlewareShortCircuit,
41
- logRenderError,
42
- } from './logger.js';
43
- import { callOnRequestError } from './instrumentation.js';
44
- import { RedirectSignal, DenySignal } from './primitives.js';
45
- import { serveStaticMetadataFile, serializeSitemap } from './pipeline-metadata.js';
46
- import { findInterceptionMatch } from './pipeline-interception.js';
47
- import type { MiddlewareContext } from './types.js';
48
- import type { SegmentNode } from '#/routing/types.js';
31
+ } from './tracing.ts';
32
+ import { logRequestReceived, logRequestCompleted, logSlowRequest } from './logger.ts';
33
+ import { DenySignal } from './primitives.ts';
34
+ import type { ManifestSegmentNode } from './route-matcher.ts';
35
+ import { canonicalRedirect, csrfGate, makeProxyResolver } from './pipeline-helpers.ts';
36
+ import type { CsrfConfig } from './csrf.ts';
37
+ import { handleRequest, runProxyPhase } from './pipeline-phases.ts';
38
+ import { outcomeToResponse } from './pipeline-outcome.ts';
39
+ import { canonicalize } from './canonicalize.ts';
40
+ import { enforceRscCacheKey, hardenRscPayloadResponse } from './rsc-cache-key-guard.ts';
41
+ import { stripHeadBody } from './head-response.ts';
42
+ import { RSC_KEY_HEADERS } from '../shared/rsc-cache-key.ts';
43
+ import { isDebug } from './debug.ts';
44
+ import type { ReactFormState } from 'react-dom/client';
45
+ import type { ActionErrorForRender } from './als-registry.ts';
46
+ import { nodeBodyOps } from './node-response.ts';
49
47
 
50
48
  // ─── Route Match Result ────────────────────────────────────────────────────
51
49
 
52
- /** Result of matching a canonical pathname against the route tree. */
50
+ /**
51
+ * Result of matching a canonical pathname against the route tree.
52
+ *
53
+ * `segments` is the runtime (`ManifestFile`-specialized) shape — the same
54
+ * nodes carried in the virtual route manifest. TIM-863 unified this: the
55
+ * matcher produces `ManifestSegmentNode[]` directly and every consumer
56
+ * (render, slots, params coercion, early hints, deny fallback) sees the
57
+ * same structural type with no `as unknown as` laundering.
58
+ */
53
59
  export interface RouteMatch {
54
60
  /** The matched segment chain from root to leaf. */
55
- segments: SegmentNode[];
56
- /** Extracted route params (catch-all segments produce string[]). */
57
- params: Record<string, string | string[]>;
58
- /** The leaf segment's middleware.ts export, if any. */
59
- middleware?: MiddlewareFn;
61
+ segments: ManifestSegmentNode[];
62
+ /**
63
+ * Segment params as the page sees them. The matcher sets them to the raw
64
+ * values; whoever runs `coerceSegmentParams()` replaces them with its
65
+ * result, whose values may be non-string (TIM-1347).
66
+ */
67
+ segmentParams: CoercedParams;
68
+ /**
69
+ * Segment params as the URL carried them (catch-all segments produce
70
+ * string[]). Set by the matcher, which owns them, and never replaced.
71
+ * Slot resolution and URL-part reconstruction read these: coerced values
72
+ * need not round-trip to the URL (`"007"` → `7`).
73
+ */
74
+ rawSegmentParams: Record<string, string | string[]>;
75
+ /** Middleware chain from the segment tree, ordered root-to-leaf. */
76
+ middlewareChain: MiddlewareFn[];
60
77
  }
61
78
 
62
79
  /** Function that matches a canonical pathname to a route. */
@@ -65,7 +82,7 @@ export type RouteMatcher = (pathname: string) => RouteMatch | null;
65
82
  /** Function that matches a canonical pathname to a metadata route. */
66
83
  export type MetadataRouteMatcher = (
67
84
  pathname: string
68
- ) => import('./route-matcher.js').MetadataRouteMatch | null;
85
+ ) => import('./route-matcher.ts').MetadataRouteMatch | null;
69
86
 
70
87
  /** Context for intercepting route resolution (modal pattern). */
71
88
  export interface InterceptionContext {
@@ -78,7 +95,6 @@ export type RouteRenderer = (
78
95
  req: Request,
79
96
  match: RouteMatch,
80
97
  responseHeaders: Headers,
81
- requestHeaderOverlay: Headers,
82
98
  interception?: InterceptionContext
83
99
  ) => Response | Promise<Response>;
84
100
 
@@ -91,13 +107,40 @@ export type EarlyHintsEmitter = (
91
107
 
92
108
  // ─── Pipeline Configuration ────────────────────────────────────────────────
93
109
 
110
+ /**
111
+ * Proxy source — a tagged union so the choice between "already-resolved
112
+ * export" and "lazy HMR-friendly loader" is encoded in the type, not
113
+ * inferred per-request.
114
+ *
115
+ * - `static` — the proxy export is already resolved (production, tests).
116
+ * - `lazy` — a loader is called per-request for HMR freshness (dev).
117
+ *
118
+ * `PipelineConfig.proxy` also accepts a bare `ProxyExport` (a function or
119
+ * function array) as shorthand for the static variant — convenient for tests
120
+ * that construct a `createPipeline` config inline. Omit the field entirely
121
+ * when the app has no `proxy.ts`.
122
+ *
123
+ * See design/07-routing.md §"proxy.ts — Global Middleware".
124
+ */
125
+ export type ProxyConfig =
126
+ | { kind: 'static'; export: ProxyExport }
127
+ | { kind: 'lazy'; loader: () => Promise<{ default: ProxyExport }> };
128
+
94
129
  export interface PipelineConfig {
95
- /** The proxy.ts default export (function or array). Undefined if no proxy.ts. */
96
- proxy?: ProxyExport;
97
- /** Lazy loader for proxy.ts — called per-request so HMR updates take effect. */
98
- proxyLoader?: () => Promise<{ default: ProxyExport }>;
130
+ /**
131
+ * proxy.ts source. Undefined if the app has no proxy.ts. Accepts either a
132
+ * tagged `ProxyConfig` (canonical) or a bare `ProxyExport` as sugar for the
133
+ * static variant.
134
+ */
135
+ proxy?: ProxyConfig | ProxyExport;
99
136
  /** Route matcher — resolves a canonical pathname to a RouteMatch. */
100
137
  matchRoute: RouteMatcher;
138
+ /**
139
+ * CSRF configuration (`allowedOrigins`, the `csrf: false` switch). The
140
+ * gate is on when this is omitted — protection is never opt-in. See
141
+ * design/08-forms-and-actions.md §"CSRF Protection".
142
+ */
143
+ csrf?: CsrfConfig;
101
144
  /** Metadata route matcher — resolves metadata route pathnames (sitemap.xml, robots.txt, etc.) */
102
145
  matchMetadataRoute?: MetadataRouteMatcher;
103
146
  /** Renderer — produces the final Response for a matched route. */
@@ -115,7 +158,18 @@ export interface PipelineConfig {
115
158
  * Generated at build time from intercepting route directories.
116
159
  * See design/07-routing.md §"Intercepting Routes"
117
160
  */
118
- interceptionRewrites?: import('#/routing/interception.js').InterceptionRewrite[];
161
+ interceptionRewrites?: import('../routing/interception.ts').InterceptionRewrite[];
162
+ /**
163
+ * Resolver for children-path interceptions — the sibling layout swap.
164
+ *
165
+ * Separate from `matchRoute` because it addresses the owner directory by
166
+ * tree path rather than by pathname, which needs the manifest tree itself.
167
+ * Omitting it disables the `'children'` interception shape and leaves the
168
+ * canonical route rendering, which is the fail-safe outcome.
169
+ *
170
+ * See design/07-routing.md §"Intercepting Routes"
171
+ */
172
+ matchInterceptedRoute?: import('./children-interception.ts').InterceptedRouteMatcher;
119
173
  /**
120
174
  * Control Server-Timing header output.
121
175
  *
@@ -126,6 +180,14 @@ export interface PipelineConfig {
126
180
  * Default: `'total'`.
127
181
  */
128
182
  serverTiming?: 'detailed' | 'total' | false;
183
+ /**
184
+ * Auto-generated sitemap handler. When provided, the pipeline intercepts
185
+ * `/sitemap.xml` and `/sitemap/N.xml` requests and delegates to this
186
+ * function. Returns a Response or null (pass-through to regular routing).
187
+ *
188
+ * See design/16-metadata.md §"Auto-generated Sitemap"
189
+ */
190
+ autoSitemapHandler?: (pathname: string) => Promise<Response | null>;
129
191
  /**
130
192
  * Dev pipeline error callback — called when a pipeline phase (proxy,
131
193
  * middleware, render) catches an unhandled error. Used to wire the error
@@ -134,6 +196,7 @@ export interface PipelineConfig {
134
196
  * Undefined in production — zero overhead.
135
197
  */
136
198
  onPipelineError?: (error: Error, phase: string) => void;
199
+
137
200
  /**
138
201
  * Fallback error renderer — called when a catastrophic error escapes the
139
202
  * render phase. Produces an HTML Response instead of a bare empty 500.
@@ -148,8 +211,78 @@ export interface PipelineConfig {
148
211
  renderFallbackError?: (
149
212
  error: unknown,
150
213
  req: Request,
151
- responseHeaders: Headers
214
+ responseHeaders: Headers,
215
+ /**
216
+ * The matched route, when the error came after matching. A route.ts
217
+ * match is answered in the API route's JSON format, never a page
218
+ * (design/10-error-handling.md §"JSON Error Pages").
219
+ */
220
+ match?: RouteMatch
221
+ ) => Response | Promise<Response>;
222
+ /**
223
+ * Fallback deny page renderer — called when a DenySignal escapes from
224
+ * middleware or the render phase. Renders the appropriate status-code
225
+ * page (403.tsx, 404.tsx, etc.) instead of returning a bare empty response.
226
+ *
227
+ * If this function throws, the pipeline falls back to a bare
228
+ * `new Response(null, { status: denyStatus })`.
229
+ */
230
+ renderDenyFallback?: (
231
+ deny: DenySignal,
232
+ req: Request,
233
+ responseHeaders: Headers,
234
+ /**
235
+ * The matched route, if available. Provided by both the middleware-stage
236
+ * and render-stage catch blocks (matching runs before middleware). When
237
+ * present, the renderer should resolve the deny status file against the
238
+ * matched chain so colocated `403.tsx`/`4xx.tsx`/`401.json` files are
239
+ * picked up. Falls back to the root-only chain when omitted (e.g. for
240
+ * deny()s thrown before route matching could complete). See TIM-822.
241
+ */
242
+ match?: RouteMatch
152
243
  ) => Response | Promise<Response>;
244
+
245
+ /**
246
+ * Server action dispatch — called after proxy.ts runs for POST requests
247
+ * that look like server actions. Returns a Response if the request was
248
+ * handled as an action, or null to fall through to normal routing.
249
+ *
250
+ * `canonicalPath` is the already-decoded canonical pathname — the same
251
+ * value that `handleRequest` and `matchRoute` use. Do NOT re-derive it
252
+ * from `req.url` (which re-encodes).
253
+ *
254
+ * The `reenter` parameter renders the page for a no-JS action that did
255
+ * not redirect. It enters the pipeline after proxy.ts: the synthetic GET
256
+ * is an internal render of the POST's answer, not a second wire request,
257
+ * so it keeps the POST's trace ID and is neither proxied nor logged again
258
+ * (TIM-1445). Route matching, middleware.ts and access.ts run as for any
259
+ * page render. It runs in its own request context: the GET, with the
260
+ * reentry's `cookies` as its parsed cookies and its `formState` or
261
+ * `actionError` for the render (`runWithRequestContext`'s options).
262
+ *
263
+ * Moved into the pipeline (TIM-1213) so proxy.ts runs on action POSTs,
264
+ * matching the design doc contract: "proxy.ts runs on every request,
265
+ * no exclusions." It runs once per wire request; the outer pass wraps
266
+ * the rerendered response.
267
+ */
268
+ dispatchAction?: (
269
+ req: Request,
270
+ canonicalPath: string,
271
+ reenter: (req: Request, reentry: PipelineReentry) => Promise<Response>
272
+ ) => Promise<Response | null>;
273
+ }
274
+
275
+ /**
276
+ * What the no-JS action rerender hands the pipeline when it re-enters it:
277
+ * the action's post-mutation cookies and, when its form used
278
+ * `useActionState`, the form state React decoded from the submission — or,
279
+ * when the action threw, the error to render in place of the page.
280
+ */
281
+ export interface PipelineReentry {
282
+ cookies: Map<string, string>;
283
+ formState?: ReactFormState;
284
+ /** The error a no-JS action threw, rendered where the page would be. */
285
+ actionError?: ActionErrorForRender;
153
286
  }
154
287
 
155
288
  // ─── Pipeline ──────────────────────────────────────────────────────────────
@@ -157,20 +290,21 @@ export interface PipelineConfig {
157
290
  /**
158
291
  * Create the request handler from a pipeline configuration.
159
292
  *
160
- * Returns a function that processes an incoming Request through all pipeline stages
161
- * and produces a Response. This is the top-level entry point for the server.
293
+ * Returns a function that processes an incoming Request through all pipeline
294
+ * stages and produces a Response. This is the top-level entry point for the
295
+ * server. The body is intentionally small — phase logic lives in
296
+ * `pipeline-phases.ts`. This function only owns the per-request setup that
297
+ * has to wrap the entire dispatch: trace ID, request context ALS, span
298
+ * scope, Server-Timing header emission, and the active-request counter.
162
299
  */
163
300
  export function createPipeline(config: PipelineConfig): (req: Request) => Promise<Response> {
164
- const {
165
- proxy,
166
- matchRoute,
167
- render,
168
- earlyHints,
169
- stripTrailingSlash = true,
170
- slowRequestMs = 3000,
171
- serverTiming = 'total',
172
- onPipelineError,
173
- } = config;
301
+ // Resolve the proxy source once. The request hot path calls this closure
302
+ // directly with no discriminant check — the branch is taken here during
303
+ // setup. For the lazy variant, `loader()` still runs per-request so HMR
304
+ // continues to re-import the user's proxy.ts.
305
+ const proxyResolver = makeProxyResolver(config.proxy);
306
+ const slowRequestMs = config.slowRequestMs ?? 3000;
307
+ const serverTiming = config.serverTiming ?? 'total';
174
308
 
175
309
  // Concurrent request counter — tracks how many requests are in-flight.
176
310
  // Logged with each request for diagnosing resource contention.
@@ -181,7 +315,6 @@ export function createPipeline(config: PipelineConfig): (req: Request) => Promis
181
315
  const method = req.method;
182
316
  const path = url.pathname;
183
317
  const startTime = performance.now();
184
- activeRequests++;
185
318
 
186
319
  // Establish per-request trace ID scope (design/17-logging.md §"trace_id is Always Set").
187
320
  // This runs before runWithRequestContext so traceId() is available from the
@@ -189,65 +322,261 @@ export function createPipeline(config: PipelineConfig): (req: Request) => Promis
189
322
  const traceIdValue = generateTraceId();
190
323
 
191
324
  return runWithTraceId(traceIdValue, async () => {
192
- // Establish request context ALS scope so headers() and cookies() work
193
- // throughout the entire request lifecycle (proxy, middleware, render).
194
- return runWithRequestContext(req, async () => {
325
+ // Runs in the request context ALS scope, so getHeaders() and getCookies()
326
+ // work throughout the entire request lifecycle (proxy, middleware, render).
327
+ const inRequestContext = async () => {
195
328
  // In dev mode, wrap with timing collector for Server-Timing header.
196
329
  // The collector uses ALS so timing entries are per-request.
197
330
  const runRequest = async () => {
198
331
  logRequestReceived({ method, path });
199
332
 
200
- const response = await withSpan(
201
- 'http.server.request',
202
- { 'http.request.method': method, 'url.path': path },
203
- async () => {
204
- // If OTEL is active, the root span now exists — replace the UUID
205
- // fallback with the real OTEL trace ID for log–trace correlation.
206
- const otelIds = await getOtelTraceId();
207
- if (otelIds) {
208
- replaceTraceId(otelIds.traceId, otelIds.spanId);
209
- }
333
+ // Incremented and decremented in one scope, the decrement in
334
+ // `finally`: a rejection that escaped the span used to skip it and
335
+ // leave the request counted as in flight for the life of the
336
+ // process (TIM-1537).
337
+ activeRequests++;
338
+ let concurrency = activeRequests;
339
+ let response: Response;
340
+ try {
341
+ response = await withSpan(
342
+ 'http.server.request',
343
+ { 'http.request.method': method, 'url.path': path },
344
+ async () => {
345
+ // If OTEL is active, the root span now exists — replace the UUID
346
+ // fallback with the real OTEL trace ID for log–trace correlation.
347
+ const otelTraceId = await getOtelTraceId();
348
+ if (otelTraceId) {
349
+ replaceTraceId(otelTraceId);
350
+ }
210
351
 
211
- let result: Response;
212
- if (proxy || config.proxyLoader) {
213
- result = await runProxyPhase(req, method, path);
214
- } else {
215
- result = await handleRequest(req, method, path);
216
- }
352
+ // Stage 0: Canonicalize URL at the outer boundary — before
353
+ // proxy.ts sees the request. Every layer (proxy, middleware,
354
+ // access, render) must see the same canonical path.
355
+ // See design/07-routing.md §"URL Canonicalization & Security".
356
+ const stripTrailingSlash = config.stripTrailingSlash ?? true;
357
+ const canonResult = canonicalize(url.pathname, stripTrailingSlash);
358
+ if (!canonResult.ok) {
359
+ if (isDebug()) {
360
+ console.warn(
361
+ `[timber] URL canonicalization rejected ${method} ${url.pathname} — responding with ${canonResult.status}\n` +
362
+ ` This usually means the URL contains encoded separators (%2f, %5c),\n` +
363
+ ` null bytes (%00), path traversal (..), or malformed percent-encoding.`
364
+ );
365
+ }
366
+ // Early returns set the span status themselves: the shared
367
+ // assignment below never runs for them, and a span with
368
+ // none reads as 200 in DevSpanProcessor.
369
+ await setSpanAttribute('http.response.status_code', canonResult.status);
370
+ return new Response(null, { status: canonResult.status });
371
+ }
372
+ const canonicalPath = canonResult.pathname;
373
+
374
+ // Construct a Request with the canonical URL so proxy.ts sees
375
+ // the same path that route matching will use. This prevents
376
+ // auth bypass via /admin/, /%61dmin, etc.
377
+ let canonicalReq = req;
378
+ if (url.pathname !== canonicalPath) {
379
+ const canonicalUrl = new URL(req.url);
380
+ canonicalUrl.pathname = canonicalPath;
381
+ canonicalReq = new Request(canonicalUrl.toString(), req);
382
+ }
217
383
 
218
- // Set response status on the root span before it ends —
219
- // DevSpanProcessor reads this for tree/summary output.
220
- await setSpanAttribute('http.response.status_code', result.status);
221
-
222
- // Append Server-Timing header based on configured mode.
223
- // Response.redirect() creates immutable headers, so we must
224
- // ensure mutability before writing Server-Timing.
225
- if (serverTiming === 'detailed') {
226
- // Detailed: per-phase breakdown (proxy, middleware, render).
227
- const timingHeader = getServerTimingHeader();
228
- if (timingHeader) {
229
- result = ensureMutableResponse(result);
230
- result.headers.set('Server-Timing', timingHeader);
384
+ // Stage 0b: CSRF gate — every unsafe-method request, before
385
+ // proxy.ts or any other user code, and before action
386
+ // dispatch, so route.ts handlers are covered too (LOCAL-773).
387
+ const csrfRejection = csrfGate(
388
+ canonicalReq,
389
+ canonicalPath,
390
+ config.csrf ?? {},
391
+ config.matchRoute
392
+ );
393
+ if (csrfRejection) {
394
+ await setSpanAttribute('http.response.status_code', csrfRejection.status);
395
+ return csrfRejection;
396
+ }
397
+
398
+ // Build the inner handler — runs after proxy, before route
399
+ // matching. Checks for server action POSTs and dispatches them
400
+ // without entering the route match → middleware → render chain.
401
+ // Falls through to handleRequest for normal route handling.
402
+ // TIM-1213: action dispatch is now INSIDE the pipeline so
403
+ // proxy.ts runs on every request, including action POSTs.
404
+ const innerHandler = async (): Promise<Response> => {
405
+ // A safe request for a non-canonical URL (`/x/`, `/a//b`) is
406
+ // redirected to the canonical one instead of served, so the
407
+ // client hydrates with the pathname the server renders with
408
+ // (TIM-1571). Inside proxy.ts's next(), so proxy.ts still runs
409
+ // on every request and its headers (CORS) reach the redirect.
410
+ const redirect = canonicalRedirect(
411
+ req,
412
+ canonicalPath,
413
+ stripTrailingSlash,
414
+ config.matchRoute
415
+ );
416
+ if (redirect) return redirect;
417
+ if (config.dispatchAction) {
418
+ // A no-JS action's answer re-enters here, inside this
419
+ // request's proxy.ts, trace and log scope, which ran once
420
+ // for the wire POST (TIM-1445). Only the request context
421
+ // is new. It renders the POST's canonical path: the
422
+ // answer is always the page the form posted to.
423
+ const reenter = (rerenderReq: Request, reentry: PipelineReentry) =>
424
+ runWithRequestContext(
425
+ rerenderReq,
426
+ () =>
427
+ handleRequest(
428
+ config,
429
+ rerenderReq,
430
+ rerenderReq.method,
431
+ canonicalPath,
432
+ true
433
+ ),
434
+ reentry
435
+ );
436
+ const actionResult = await config.dispatchAction(
437
+ canonicalReq,
438
+ canonicalPath,
439
+ reenter
440
+ );
441
+ if (actionResult) return actionResult;
442
+ }
443
+ return handleRequest(config, canonicalReq, method, canonicalPath, true);
444
+ };
445
+
446
+ let result: Response;
447
+ if (proxyResolver) {
448
+ const outcome = await runProxyPhase(
449
+ config,
450
+ proxyResolver,
451
+ canonicalReq,
452
+ method,
453
+ canonicalPath,
454
+ innerHandler
455
+ );
456
+ result = await outcomeToResponse(config, outcome, {
457
+ req: canonicalReq,
458
+ method,
459
+ path: canonicalPath,
460
+ });
461
+ } else {
462
+ result = await innerHandler();
463
+ }
464
+
465
+ // Set response status on the root span before it ends —
466
+ // DevSpanProcessor reads this for tree/summary output.
467
+ await setSpanAttribute('http.response.status_code', result.status);
468
+
469
+ // Vary on exactly the headers the `_rsc` cache key hashes.
470
+ //
471
+ // Those two mechanisms answer the same question — which request
472
+ // headers change this response — so they are the same list, not
473
+ // two lists that happen to agree. A separate hand-written list
474
+ // here drifted from `RSC_KEY_HEADERS` the moment the key set
475
+ // grew, and the drift is invisible: `Vary` is the *fallback*
476
+ // layer, used only when a cache omits the query from its key,
477
+ // which is precisely when nobody is watching (TIM-1268).
478
+ //
479
+ // Why any of it: without `Vary: Accept` a shared cache may serve
480
+ // an RSC Flight payload to a browser expecting HTML, or the
481
+ // reverse (GHSA-wfc6-r584-vfw7, design/13-security.md). The
482
+ // `_rsc` param puts that distinction in the URL, so correctness
483
+ // no longer *depends* on `Vary` — which is opt-in configuration
484
+ // on Cloudflare and CloudFront. `Vary` covers the requests that
485
+ // arrive without the param: a stripped query, a hand-rolled
486
+ // client.
487
+ //
488
+ // It costs no hit rate. Document requests send no `X-Timber-*`
489
+ // header at all, so they collapse to a single cache key; payload
490
+ // requests are already fragmented by these same values via the
491
+ // URL.
492
+ const varyTokens = [...RSC_KEY_HEADERS];
493
+ const existingVary = result.headers.get('Vary');
494
+ const existingTokens = existingVary
495
+ ? existingVary
496
+ .toLowerCase()
497
+ .split(',')
498
+ .map((t) => t.trim())
499
+ : [];
500
+ const newTokens = varyTokens.filter(
501
+ (t) => !existingTokens.includes(t.toLowerCase())
502
+ );
503
+ if (newTokens.length > 0) {
504
+ result.headers.set(
505
+ 'Vary',
506
+ existingVary ? `${existingVary}, ${newTokens.join(', ')}` : newTokens.join(', ')
507
+ );
508
+ }
509
+
510
+ // A request may only claim an `_rsc` cache key that matches its
511
+ // own headers. The key is predictable by design, so without this
512
+ // a caller could render its own variant under another client's
513
+ // key and have a shared cache store it there (TIM-1268).
514
+ await enforceRscCacheKey(canonicalReq, result);
515
+
516
+ // Flight payloads must never be sniffable into a renderable
517
+ // type — applied at this single exit so every producer is
518
+ // covered, not just the success path (TIM-1268).
519
+ hardenRscPayloadResponse(result);
520
+
521
+ // A HEAD response carries the headers its GET would produce and
522
+ // no content (RFC 9110 §9.3.2). Applied at this single exit so
523
+ // every response shape is covered — page render, API route,
524
+ // metadata route, deny page, error page, proxy short-circuit —
525
+ // rather than per-renderer, where it was missing for page
526
+ // renders entirely (TIM-1324). The render still runs: the
527
+ // headers have to be the ones a GET would have sent.
528
+ result = stripHeadBody(result, method);
529
+
530
+ // Append Server-Timing header based on configured mode.
531
+ // Header mutability is guaranteed by the producer-side clone
532
+ // in `outcomeToResponse` and the metadata-route / auto-sitemap
533
+ // user-handler clones in `handleRequest`, so we can write
534
+ // directly without a runtime probe. See TIM-866.
535
+ if (serverTiming === 'detailed') {
536
+ // Detailed: per-phase breakdown (proxy, middleware, render).
537
+ const timingHeader = getServerTimingHeader();
538
+ if (timingHeader) {
539
+ result.headers.set('Server-Timing', timingHeader);
540
+ }
541
+ } else if (serverTiming === 'total') {
542
+ // Total only: single `total;dur=N` — no phase names.
543
+ // Prevents information disclosure while giving browser
544
+ // DevTools useful timing data.
545
+ const totalMs = Math.round(performance.now() - startTime);
546
+ result.headers.set('Server-Timing', `total;dur=${totalMs}`);
547
+ }
548
+ // serverTiming === false: no header at all
549
+
550
+ // Wrap the response body with stream-lifecycle timing when
551
+ // detailed mode is on. Logs firstChunk/lastChunk/maxGap/close
552
+ // on stream close — measures the post-flush stream tail that
553
+ // the Server-Timing header can't capture (TIM-1106).
554
+ if (serverTiming === 'detailed') {
555
+ // A Node body is timed as a Node stream; reading `.body`
556
+ // would convert it to a Web one.
557
+ const nodeBody = nodeBodyOps(result);
558
+ if (nodeBody) {
559
+ result = nodeBody.timed(startTime);
560
+ } else if (result.body) {
561
+ result = new Response(wrapResponseWithStreamTiming(result.body, startTime), {
562
+ status: result.status,
563
+ statusText: result.statusText,
564
+ headers: result.headers,
565
+ });
566
+ }
231
567
  }
232
- } else if (serverTiming === 'total') {
233
- // Total only: single `total;dur=N` — no phase names.
234
- // Prevents information disclosure while giving browser
235
- // DevTools useful timing data.
236
- const totalMs = Math.round(performance.now() - startTime);
237
- result = ensureMutableResponse(result);
238
- result.headers.set('Server-Timing', `total;dur=${totalMs}`);
239
- }
240
- // serverTiming === false: no header at all
241
568
 
242
- return result;
243
- }
244
- );
569
+ return result;
570
+ }
571
+ );
572
+ } finally {
573
+ concurrency = activeRequests;
574
+ activeRequests--;
575
+ }
245
576
 
246
577
  // Post-span: structured production logging
247
578
  const durationMs = Math.round(performance.now() - startTime);
248
579
  const status = response.status;
249
- const concurrency = activeRequests;
250
- activeRequests--;
251
580
  logRequestCompleted({ method, path, status, durationMs, concurrency });
252
581
 
253
582
  if (slowRequestMs > 0 && durationMs > slowRequestMs) {
@@ -258,329 +587,8 @@ export function createPipeline(config: PipelineConfig): (req: Request) => Promis
258
587
  };
259
588
 
260
589
  return serverTiming === 'detailed' ? runWithTimingCollector(runRequest) : runRequest();
261
- });
262
- });
263
- };
264
-
265
- async function runProxyPhase(req: Request, method: string, path: string): Promise<Response> {
266
- try {
267
- // Resolve the proxy export. When a proxyLoader is provided (lazy import),
268
- // it is called per-request so HMR updates in dev take effect immediately.
269
- let proxyExport: ProxyExport;
270
- if (config.proxyLoader) {
271
- const mod = await config.proxyLoader();
272
- proxyExport = mod.default;
273
- } else {
274
- proxyExport = config.proxy!;
275
- }
276
- const proxyFn = () => runProxy(proxyExport, req, () => handleRequest(req, method, path));
277
- return await withSpan('timber.proxy', {}, () =>
278
- serverTiming === 'detailed' ? withTiming('proxy', 'proxy.ts', proxyFn) : proxyFn()
279
- );
280
- } catch (error) {
281
- // Uncaught proxy.ts error → bare HTTP 500
282
- logProxyError({ error });
283
- await fireOnRequestError(error, req, 'proxy');
284
- if (onPipelineError && error instanceof Error) onPipelineError(error, 'proxy');
285
- return new Response(null, { status: 500 });
286
- }
287
- }
288
-
289
- async function handleRequest(req: Request, method: string, path: string): Promise<Response> {
290
- // Stage 1: URL canonicalization
291
- const url = new URL(req.url);
292
- const result = canonicalize(url.pathname, stripTrailingSlash);
293
- if (!result.ok) {
294
- return new Response(null, { status: result.status });
295
- }
296
- const canonicalPathname = result.pathname;
297
-
298
- // Stage 1b: Metadata route matching — runs before regular route matching.
299
- // Metadata routes skip middleware.ts and access.ts (public endpoints for crawlers).
300
- // See design/16-metadata.md §"Pipeline Integration"
301
- if (config.matchMetadataRoute) {
302
- const metaMatch = config.matchMetadataRoute(canonicalPathname);
303
- if (metaMatch) {
304
- try {
305
- // Static metadata files (.xml, .txt, .png, .ico, etc.) are served
306
- // directly from disk. Dynamic metadata routes (.ts, .tsx) export a
307
- // handler function that generates the response.
308
- if (metaMatch.isStatic) {
309
- return await serveStaticMetadataFile(metaMatch);
310
- }
311
-
312
- const mod = (await metaMatch.file.load()) as { default?: Function };
313
- if (typeof mod.default !== 'function') {
314
- return new Response('Metadata route must export a default function', { status: 500 });
315
- }
316
- const handlerResult = await mod.default();
317
- // If the handler returns a Response, use it directly
318
- if (handlerResult instanceof Response) {
319
- return handlerResult;
320
- }
321
- // Otherwise, serialize based on content type
322
- const contentType = metaMatch.contentType;
323
- let body: string;
324
- if (typeof handlerResult === 'string') {
325
- body = handlerResult;
326
- } else if (contentType === 'application/xml') {
327
- body = serializeSitemap(handlerResult);
328
- } else if (contentType === 'application/manifest+json') {
329
- body = JSON.stringify(handlerResult, null, 2);
330
- } else {
331
- body = typeof handlerResult === 'string' ? handlerResult : String(handlerResult);
332
- }
333
- return new Response(body, {
334
- status: 200,
335
- headers: { 'Content-Type': `${contentType}; charset=utf-8` },
336
- });
337
- } catch (error) {
338
- logRenderError({ method, path, error });
339
- if (onPipelineError && error instanceof Error) onPipelineError(error, 'metadata-route');
340
- return new Response(null, { status: 500 });
341
- }
342
- }
343
- }
344
-
345
- // Stage 2: Route matching
346
- let match = matchRoute(canonicalPathname);
347
- let interception: InterceptionContext | undefined;
348
-
349
- // Stage 2a: Intercepting route resolution (modal pattern).
350
- // On soft navigation, check if an intercepting route should render instead.
351
- // The client sends X-Timber-URL with the current pathname (where they're
352
- // navigating FROM). If a rewrite matches, re-route to the source URL so
353
- // the source layout renders with the intercepted content in the slot.
354
- const sourceUrl = req.headers.get('X-Timber-URL');
355
- if (sourceUrl && config.interceptionRewrites?.length) {
356
- const intercepted = findInterceptionMatch(
357
- canonicalPathname,
358
- sourceUrl,
359
- config.interceptionRewrites
360
- );
361
- if (intercepted) {
362
- const sourceMatch = matchRoute(intercepted.sourcePathname);
363
- if (sourceMatch) {
364
- match = sourceMatch;
365
- interception = { targetPathname: canonicalPathname };
366
- }
367
- }
368
- }
369
-
370
- if (!match) {
371
- // No route matched — render 404.tsx in root layout if available,
372
- // otherwise fall back to a bare 404 Response.
373
- if (config.renderNoMatch) {
374
- const responseHeaders = new Headers();
375
- return config.renderNoMatch(req, responseHeaders);
376
- }
377
- return new Response(null, { status: 404 });
378
- }
379
-
380
- // Response and request header containers — created before early hints so
381
- // the emitter can append Link headers (e.g. for Cloudflare CDN → 103).
382
- const responseHeaders = new Headers();
383
- const requestHeaderOverlay = new Headers();
384
-
385
- // Set Cache-Control for dynamic HTML responses. Without this header,
386
- // CDNs (particularly Cloudflare) may attempt to buffer/process the
387
- // response differently, causing intermittent multi-second delays.
388
- // This matches Next.js's default behavior.
389
- responseHeaders.set('Cache-Control', 'private, no-cache, no-store, max-age=0, must-revalidate');
390
-
391
- // Stage 2b: 103 Early Hints (before middleware, after match)
392
- // Fires before middleware so the browser can begin fetching critical
393
- // assets while middleware runs. Non-fatal — a failing emitter never
394
- // blocks the request.
395
- if (earlyHints) {
396
- try {
397
- await earlyHints(match, req, responseHeaders);
398
- } catch {
399
- // Early hints failure is non-fatal
400
- }
401
- }
402
-
403
- // Stage 3: Leaf middleware.ts (only the leaf route's middleware runs)
404
- if (match.middleware) {
405
- const ctx: MiddlewareContext = {
406
- req,
407
- requestHeaders: requestHeaderOverlay,
408
- headers: responseHeaders,
409
- params: match.params,
410
- searchParams: new URL(req.url).searchParams,
411
- earlyHints: (hints) => {
412
- for (const hint of hints) {
413
- let value = `<${hint.href}>; rel=${hint.rel}`;
414
- if (hint.as !== undefined) value += `; as=${hint.as}`;
415
- if (hint.crossOrigin !== undefined) value += `; crossorigin=${hint.crossOrigin}`;
416
- if (hint.fetchPriority !== undefined) value += `; fetchpriority=${hint.fetchPriority}`;
417
- responseHeaders.append('Link', value);
418
- }
419
- },
420
590
  };
421
-
422
- try {
423
- // Enable cookie mutation during middleware (design/29-cookies.md §"Context Tracking")
424
- setMutableCookieContext(true);
425
- const middlewareFn = () => runMiddleware(match.middleware!, ctx);
426
- const middlewareResponse = await withSpan('timber.middleware', {}, () =>
427
- serverTiming === 'detailed'
428
- ? withTiming('mw', 'middleware.ts', middlewareFn)
429
- : middlewareFn()
430
- );
431
- setMutableCookieContext(false);
432
- if (middlewareResponse) {
433
- // Apply cookie jar to short-circuit response.
434
- // Response.redirect() creates immutable headers, so ensure
435
- // mutability before appending Set-Cookie entries.
436
- const finalResponse = ensureMutableResponse(middlewareResponse);
437
- applyCookieJar(finalResponse.headers);
438
- logMiddlewareShortCircuit({ method, path, status: finalResponse.status });
439
- return finalResponse;
440
- }
441
- // Middleware succeeded without short-circuiting — apply any
442
- // injected request headers so headers() returns them downstream.
443
- applyRequestHeaderOverlay(requestHeaderOverlay);
444
- } catch (error) {
445
- setMutableCookieContext(false);
446
- // RedirectSignal from middleware → HTTP redirect (not an error).
447
- // For RSC payload requests (client navigation), return 204 + X-Timber-Redirect
448
- // so the client router can perform a soft SPA redirect. A raw 302 would be
449
- // turned into an opaque redirect by fetch({redirect:'manual'}), crashing
450
- // createFromFetch. See design/19-client-navigation.md.
451
- if (error instanceof RedirectSignal) {
452
- applyCookieJar(responseHeaders);
453
- const isRsc = (req.headers.get('Accept') ?? '').includes('text/x-component');
454
- if (isRsc) {
455
- responseHeaders.set('X-Timber-Redirect', error.location);
456
- return new Response(null, { status: 204, headers: responseHeaders });
457
- }
458
- responseHeaders.set('Location', error.location);
459
- return new Response(null, { status: error.status, headers: responseHeaders });
460
- }
461
- // DenySignal from middleware → HTTP deny status
462
- if (error instanceof DenySignal) {
463
- return new Response(null, { status: error.status });
464
- }
465
- // Middleware throw → HTTP 500 (middleware runs before rendering,
466
- // no error boundary to catch it)
467
- logMiddlewareError({ method, path, error });
468
- await fireOnRequestError(error, req, 'handler');
469
- if (onPipelineError && error instanceof Error) onPipelineError(error, 'middleware');
470
- return new Response(null, { status: 500 });
471
- }
472
- }
473
-
474
- // Apply cookie jar to response headers before render commits them.
475
- // Middleware may have set cookies; they need to be on responseHeaders
476
- // before flushResponse creates the Response object.
477
- applyCookieJar(responseHeaders);
478
-
479
- // Stage 4: Render (access gates + element tree + renderToReadableStream)
480
- try {
481
- const renderFn = () =>
482
- render(req, match, responseHeaders, requestHeaderOverlay, interception);
483
- const response = await withSpan('timber.render', { 'http.route': canonicalPathname }, () =>
484
- serverTiming === 'detailed'
485
- ? withTiming('render', 'RSC + SSR render', renderFn)
486
- : renderFn()
487
- );
488
- markResponseFlushed();
489
- return response;
490
- } catch (error) {
491
- // DenySignal leaked from render (e.g. notFound() in metadata()).
492
- // Return the deny status code instead of 500.
493
- if (error instanceof DenySignal) {
494
- return new Response(null, { status: error.status });
495
- }
496
- // RedirectSignal leaked from render — honour the redirect.
497
- // For RSC payload requests, return 204 + X-Timber-Redirect so the
498
- // client router can perform a soft SPA redirect (same as middleware path).
499
- if (error instanceof RedirectSignal) {
500
- const isRsc = (req.headers.get('Accept') ?? '').includes('text/x-component');
501
- if (isRsc) {
502
- responseHeaders.set('X-Timber-Redirect', error.location);
503
- return new Response(null, { status: 204, headers: responseHeaders });
504
- }
505
- responseHeaders.set('Location', error.location);
506
- return new Response(null, { status: error.status, headers: responseHeaders });
507
- }
508
- logRenderError({ method, path, error });
509
- await fireOnRequestError(error, req, 'render');
510
- if (onPipelineError && error instanceof Error) onPipelineError(error, 'render');
511
- // Try fallback error page before bare 500
512
- if (config.renderFallbackError) {
513
- try {
514
- return await config.renderFallbackError(error, req, responseHeaders);
515
- } catch {
516
- // Fallback rendering itself failed — fall through to bare 500
517
- }
518
- }
519
- return new Response(null, { status: 500 });
520
- }
521
- }
522
- }
523
-
524
- /**
525
- * Fire the user's onRequestError hook with request context.
526
- * Extracts request info from the Request object and calls the instrumentation hook.
527
- */
528
- async function fireOnRequestError(
529
- error: unknown,
530
- req: Request,
531
- phase: 'proxy' | 'handler' | 'render' | 'action' | 'route'
532
- ): Promise<void> {
533
- const url = new URL(req.url);
534
- const headersObj: Record<string, string> = {};
535
- req.headers.forEach((v, k) => {
536
- headersObj[k] = v;
537
- });
538
-
539
- await callOnRequestError(
540
- error,
541
- { method: req.method, path: url.pathname, headers: headersObj },
542
- { phase, routePath: url.pathname, routeType: 'page', traceId: traceId() }
543
- );
544
- }
545
-
546
- // ─── Cookie Helpers ──────────────────────────────────────────────────────
547
-
548
- /**
549
- * Apply all Set-Cookie headers from the cookie jar to a Headers object.
550
- * Each cookie gets its own Set-Cookie header per RFC 6265 §4.1.
551
- */
552
- function applyCookieJar(headers: Headers): void {
553
- for (const value of getSetCookieHeaders()) {
554
- headers.append('Set-Cookie', value);
555
- }
556
- }
557
-
558
- // ─── Immutable Response Helpers ──────────────────────────────────────────
559
-
560
- /**
561
- * Ensure a Response has mutable headers so the pipeline can safely append
562
- * Set-Cookie and Server-Timing entries.
563
- *
564
- * `Response.redirect()` and some platform-level responses return objects
565
- * with immutable headers. Calling `.set()` or `.append()` on them throws
566
- * `TypeError: immutable`. This helper detects the immutable case by
567
- * attempting a no-op write and, on failure, clones into a fresh Response
568
- * with mutable headers.
569
- */
570
- function ensureMutableResponse(response: Response): Response {
571
- try {
572
- // Probe mutability with a benign operation that we immediately undo.
573
- // We pick a header name that is extremely unlikely to collide with
574
- // anything meaningful and delete it right away.
575
- response.headers.set('X-Timber-Probe', '1');
576
- response.headers.delete('X-Timber-Probe');
577
- return response;
578
- } catch {
579
- // Headers are immutable — rebuild with mutable headers.
580
- return new Response(response.body, {
581
- status: response.status,
582
- statusText: response.statusText,
583
- headers: new Headers(response.headers),
591
+ return runWithRequestContext(req, inRequestContext);
584
592
  });
585
- }
593
+ };
586
594
  }