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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1560) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +376 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-DHum77eH.js +1272 -0
  5. package/dist/_chunks/actions-DHum77eH.js.map +1 -0
  6. package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
  7. package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
  8. package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
  9. package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
  10. package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
  11. package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
  12. package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
  13. package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
  14. package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
  15. package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
  16. package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
  17. package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
  18. package/dist/_chunks/chains-D-RRc7CM.js +266 -0
  19. package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
  20. package/dist/_chunks/chains-KblEfYzm.js +1 -0
  21. package/dist/_chunks/classify-_W0RWa5w.js +146 -0
  22. package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
  23. package/dist/_chunks/cli-check-B-JZkpBD.js +251 -0
  24. package/dist/_chunks/cli-check-B-JZkpBD.js.map +1 -0
  25. package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
  26. package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
  27. package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
  28. package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
  29. package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
  30. package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
  31. package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
  33. package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
  34. package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
  35. package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
  36. package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
  37. package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
  38. package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
  39. package/dist/_chunks/codec-registry-CPc6bjVl.js +20 -0
  40. package/dist/_chunks/codec-registry-CPc6bjVl.js.map +1 -0
  41. package/dist/_chunks/codegen-B9oWkWGf.js +429 -0
  42. package/dist/_chunks/codegen-B9oWkWGf.js.map +1 -0
  43. package/dist/_chunks/convention-lint-CrDKERHg.js +578 -0
  44. package/dist/_chunks/convention-lint-CrDKERHg.js.map +1 -0
  45. package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
  46. package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
  47. package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
  48. package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
  49. package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
  50. package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
  51. package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
  52. package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
  53. package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
  54. package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
  55. package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
  56. package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
  57. package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
  58. package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
  59. package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
  60. package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
  61. package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
  62. package/dist/_chunks/format-DuPOoXUP.js +13 -0
  63. package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
  64. package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
  65. package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
  66. package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
  67. package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
  68. package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
  69. package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
  70. package/dist/_chunks/href-validation-CEZy1V-k.js +210 -0
  71. package/dist/_chunks/href-validation-CEZy1V-k.js.map +1 -0
  72. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  73. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  74. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  75. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  76. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  77. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  78. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  79. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  80. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  81. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  82. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  83. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  84. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  85. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  86. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  87. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  88. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  89. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  90. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  91. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  92. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  93. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  94. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  95. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  96. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  97. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  98. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  99. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  100. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  101. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  102. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  103. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  104. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  105. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  106. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  107. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  108. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  109. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  110. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  111. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  112. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  113. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  114. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  115. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  116. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  117. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  118. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  119. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  120. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  121. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  122. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  123. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  124. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  125. package/dist/_chunks/state-B-EBjeER.js +49 -0
  126. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  127. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  128. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  129. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  130. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  131. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  132. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  133. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  134. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  135. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  136. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  137. package/dist/adapters/build-output-helper.d.ts +81 -0
  138. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  139. package/dist/adapters/canonicalize-module.d.ts +8 -0
  140. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  141. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  142. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  143. package/dist/adapters/cloudflare-dev.js +73 -0
  144. package/dist/adapters/cloudflare-dev.js.map +1 -0
  145. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  146. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  148. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  149. package/dist/adapters/cloudflare.d.ts +217 -24
  150. package/dist/adapters/cloudflare.d.ts.map +1 -1
  151. package/dist/adapters/cloudflare.js +1 -188
  152. package/dist/adapters/compress-module.d.ts +25 -4
  153. package/dist/adapters/compress-module.d.ts.map +1 -1
  154. package/dist/adapters/fs-identity.d.ts +63 -0
  155. package/dist/adapters/fs-identity.d.ts.map +1 -0
  156. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  157. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  158. package/dist/adapters/nitro-presets.d.ts +37 -0
  159. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  160. package/dist/adapters/nitro-preview.d.ts +65 -0
  161. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  162. package/dist/adapters/nitro.d.ts +69 -38
  163. package/dist/adapters/nitro.d.ts.map +1 -1
  164. package/dist/adapters/nitro.js +837 -347
  165. package/dist/adapters/nitro.js.map +1 -1
  166. package/dist/adapters/shared.d.ts +85 -0
  167. package/dist/adapters/shared.d.ts.map +1 -0
  168. package/dist/adapters/types.d.ts +124 -16
  169. package/dist/adapters/types.d.ts.map +1 -1
  170. package/dist/adapters/types.js +0 -0
  171. package/dist/analyze/chains.d.ts +124 -0
  172. package/dist/analyze/chains.d.ts.map +1 -0
  173. package/dist/analyze/classify.d.ts +153 -0
  174. package/dist/analyze/classify.d.ts.map +1 -0
  175. package/dist/analyze/crawl-entry.d.ts +17 -0
  176. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  177. package/dist/analyze/crawl-entry.js +312 -0
  178. package/dist/analyze/crawl-entry.js.map +1 -0
  179. package/dist/analyze/crawl.d.ts +134 -0
  180. package/dist/analyze/crawl.d.ts.map +1 -0
  181. package/dist/analyze/graph-cache.d.ts +104 -0
  182. package/dist/analyze/graph-cache.d.ts.map +1 -0
  183. package/dist/analyze/graph-command.d.ts +43 -0
  184. package/dist/analyze/graph-command.d.ts.map +1 -0
  185. package/dist/analyze/graph-command.js +386 -0
  186. package/dist/analyze/graph-command.js.map +1 -0
  187. package/dist/analyze/live-graph.d.ts +81 -0
  188. package/dist/analyze/live-graph.d.ts.map +1 -0
  189. package/dist/analyze/poison-rules.d.ts +72 -0
  190. package/dist/analyze/poison-rules.d.ts.map +1 -0
  191. package/dist/analyze/poison-scan.d.ts +48 -0
  192. package/dist/analyze/poison-scan.d.ts.map +1 -0
  193. package/dist/analyze/scan.d.ts +73 -0
  194. package/dist/analyze/scan.d.ts.map +1 -0
  195. package/dist/cache/cache-api.d.ts +48 -0
  196. package/dist/cache/cache-api.d.ts.map +1 -0
  197. package/dist/cache/fast-hash.d.ts +5 -0
  198. package/dist/cache/fast-hash.d.ts.map +1 -1
  199. package/dist/cache/guarded-read.d.ts +29 -0
  200. package/dist/cache/guarded-read.d.ts.map +1 -0
  201. package/dist/cache/handler-store.d.ts +45 -0
  202. package/dist/cache/handler-store.d.ts.map +1 -0
  203. package/dist/cache/index.d.ts +32 -9
  204. package/dist/cache/index.d.ts.map +1 -1
  205. package/dist/cache/index.js +4 -326
  206. package/dist/cache/invalidation-epoch.d.ts +50 -0
  207. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  208. package/dist/cache/json-lossy-check.d.ts +11 -0
  209. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  210. package/dist/cache/key-discipline.d.ts +61 -0
  211. package/dist/cache/key-discipline.d.ts.map +1 -0
  212. package/dist/cache/redis-handler.d.ts +140 -9
  213. package/dist/cache/redis-handler.d.ts.map +1 -1
  214. package/dist/cache/singleflight.d.ts +31 -2
  215. package/dist/cache/singleflight.d.ts.map +1 -1
  216. package/dist/cache/sizeof.d.ts +22 -0
  217. package/dist/cache/sizeof.d.ts.map +1 -0
  218. package/dist/cache/stable-stringify.d.ts +15 -0
  219. package/dist/cache/stable-stringify.d.ts.map +1 -1
  220. package/dist/cache/store.d.ts +53 -0
  221. package/dist/cache/store.d.ts.map +1 -0
  222. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  223. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  224. package/dist/cache/stores/cloudflare-kv.js +28 -0
  225. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  226. package/dist/cache/stores/memory.d.ts +42 -0
  227. package/dist/cache/stores/memory.d.ts.map +1 -0
  228. package/dist/cache/stores/memory.js +89 -0
  229. package/dist/cache/stores/memory.js.map +1 -0
  230. package/dist/cache/stores/redis.d.ts +69 -0
  231. package/dist/cache/stores/redis.d.ts.map +1 -0
  232. package/dist/cache/stores/redis.js +34 -0
  233. package/dist/cache/stores/redis.js.map +1 -0
  234. package/dist/cache/stores/vercel.d.ts +36 -0
  235. package/dist/cache/stores/vercel.d.ts.map +1 -0
  236. package/dist/cache/stores/vercel.js +32 -0
  237. package/dist/cache/stores/vercel.js.map +1 -0
  238. package/dist/cache/tag-aware-handler.d.ts +51 -0
  239. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  240. package/dist/cache/timber-cache.d.ts +25 -11
  241. package/dist/cache/timber-cache.d.ts.map +1 -1
  242. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  243. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  244. package/dist/cdn/cloudflare-purge.js +29 -0
  245. package/dist/cdn/cloudflare-purge.js.map +1 -0
  246. package/dist/cdn/fastly-purge.d.ts +25 -0
  247. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  248. package/dist/cdn/fastly-purge.js +32 -0
  249. package/dist/cdn/fastly-purge.js.map +1 -0
  250. package/dist/cdn/headers.d.ts +97 -0
  251. package/dist/cdn/headers.d.ts.map +1 -0
  252. package/dist/cdn/index.d.ts +5 -0
  253. package/dist/cdn/index.d.ts.map +1 -0
  254. package/dist/cdn/index.js +93 -0
  255. package/dist/cdn/index.js.map +1 -0
  256. package/dist/cdn/purge-store.d.ts +32 -0
  257. package/dist/cdn/purge-store.d.ts.map +1 -0
  258. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  259. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  260. package/dist/cdn/workers-cache-purge.js +33 -0
  261. package/dist/cdn/workers-cache-purge.js.map +1 -0
  262. package/dist/cli-check.d.ts +133 -0
  263. package/dist/cli-check.d.ts.map +1 -0
  264. package/dist/cli-context.d.ts +62 -0
  265. package/dist/cli-context.d.ts.map +1 -0
  266. package/dist/cli-dev-status.d.ts +75 -0
  267. package/dist/cli-dev-status.d.ts.map +1 -0
  268. package/dist/cli-init.d.ts +72 -0
  269. package/dist/cli-init.d.ts.map +1 -0
  270. package/dist/cli-schema-sync.d.ts +59 -0
  271. package/dist/cli-schema-sync.d.ts.map +1 -0
  272. package/dist/cli.d.ts +80 -16
  273. package/dist/cli.d.ts.map +1 -1
  274. package/dist/cli.js +210 -69
  275. package/dist/cli.js.map +1 -1
  276. package/dist/client/browser-dev.d.ts +42 -2
  277. package/dist/client/browser-dev.d.ts.map +1 -1
  278. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  279. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  280. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  281. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  282. package/dist/client/browser-entry/form-state.d.ts +22 -0
  283. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  284. package/dist/client/browser-entry/hmr.d.ts +27 -0
  285. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  286. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  287. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  288. package/dist/client/browser-entry/index.d.ts +32 -0
  289. package/dist/client/browser-entry/index.d.ts.map +1 -0
  290. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  291. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  292. package/dist/client/browser-entry/router-init.d.ts +41 -0
  293. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  294. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  295. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  296. package/dist/client/browser-entry/scroll.d.ts +28 -0
  297. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  298. package/dist/client/deny-last-resort.d.ts +29 -0
  299. package/dist/client/deny-last-resort.d.ts.map +1 -0
  300. package/dist/client/dev-pill/index.d.ts +32 -0
  301. package/dist/client/dev-pill/index.d.ts.map +1 -0
  302. package/dist/client/dev-pill/store.d.ts +105 -0
  303. package/dist/client/dev-pill/store.d.ts.map +1 -0
  304. package/dist/client/dev-pill/view.d.ts +9 -0
  305. package/dist/client/dev-pill/view.d.ts.map +1 -0
  306. package/dist/client/error-boundary.d.ts +58 -9
  307. package/dist/client/error-boundary.d.ts.map +1 -1
  308. package/dist/client/error-boundary.js +1 -126
  309. package/dist/client/error-reconstituter.d.ts +55 -0
  310. package/dist/client/error-reconstituter.d.ts.map +1 -0
  311. package/dist/client/form.d.ts +38 -99
  312. package/dist/client/form.d.ts.map +1 -1
  313. package/dist/client/global-context.d.ts +35 -0
  314. package/dist/client/global-context.d.ts.map +1 -0
  315. package/dist/client/history.d.ts +50 -9
  316. package/dist/client/history.d.ts.map +1 -1
  317. package/dist/client/index.d.ts +22 -33
  318. package/dist/client/index.d.ts.map +1 -1
  319. package/dist/client/index.js +416 -1241
  320. package/dist/client/index.js.map +1 -1
  321. package/dist/client/internal.d.ts +20 -0
  322. package/dist/client/internal.d.ts.map +1 -0
  323. package/dist/client/internal.js +785 -0
  324. package/dist/client/internal.js.map +1 -0
  325. package/dist/client/link.d.ts +85 -60
  326. package/dist/client/link.d.ts.map +1 -1
  327. package/dist/client/location-search.d.ts +12 -0
  328. package/dist/client/location-search.d.ts.map +1 -0
  329. package/dist/client/navigation-api.d.ts +95 -0
  330. package/dist/client/navigation-api.d.ts.map +1 -0
  331. package/dist/client/navigation-commit.d.ts +111 -0
  332. package/dist/client/navigation-commit.d.ts.map +1 -0
  333. package/dist/client/navigation-context.d.ts +75 -37
  334. package/dist/client/navigation-context.d.ts.map +1 -1
  335. package/dist/client/navigation-root.d.ts +106 -0
  336. package/dist/client/navigation-root.d.ts.map +1 -0
  337. package/dist/client/navigation-transition.d.ts +255 -0
  338. package/dist/client/navigation-transition.d.ts.map +1 -0
  339. package/dist/client/nuqs-adapter.d.ts +5 -2
  340. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  341. package/dist/client/params-context.d.ts +81 -0
  342. package/dist/client/params-context.d.ts.map +1 -0
  343. package/dist/client/react-root.d.ts +51 -0
  344. package/dist/client/react-root.d.ts.map +1 -0
  345. package/dist/client/router-effects.d.ts +203 -0
  346. package/dist/client/router-effects.d.ts.map +1 -0
  347. package/dist/client/router-lifecycle.d.ts +107 -0
  348. package/dist/client/router-lifecycle.d.ts.map +1 -0
  349. package/dist/client/router-pipeline.d.ts +81 -0
  350. package/dist/client/router-pipeline.d.ts.map +1 -0
  351. package/dist/client/router-ref.d.ts +2 -2
  352. package/dist/client/router-ref.d.ts.map +1 -1
  353. package/dist/client/router-skew.d.ts +21 -0
  354. package/dist/client/router-skew.d.ts.map +1 -0
  355. package/dist/client/router-types.d.ts +294 -0
  356. package/dist/client/router-types.d.ts.map +1 -0
  357. package/dist/client/router-url.d.ts +24 -0
  358. package/dist/client/router-url.d.ts.map +1 -0
  359. package/dist/client/router.d.ts +1 -97
  360. package/dist/client/router.d.ts.map +1 -1
  361. package/dist/client/rsc-fetch.d.ts +110 -28
  362. package/dist/client/rsc-fetch.d.ts.map +1 -1
  363. package/dist/client/segment-cache.d.ts +186 -25
  364. package/dist/client/segment-cache.d.ts.map +1 -1
  365. package/dist/client/segment-context.d.ts.map +1 -1
  366. package/dist/client/segment-outlet.d.ts +68 -0
  367. package/dist/client/segment-outlet.d.ts.map +1 -0
  368. package/dist/client/segment-update-context.d.ts +15 -0
  369. package/dist/client/segment-update-context.d.ts.map +1 -0
  370. package/dist/client/shallow-url.d.ts +10 -0
  371. package/dist/client/shallow-url.d.ts.map +1 -0
  372. package/dist/client/slot-content-cache-context.d.ts +35 -0
  373. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  374. package/dist/client/slot-context.d.ts +31 -0
  375. package/dist/client/slot-context.d.ts.map +1 -0
  376. package/dist/client/slot-outlet.d.ts +16 -0
  377. package/dist/client/slot-outlet.d.ts.map +1 -0
  378. package/dist/client/slot-provider.d.ts +25 -0
  379. package/dist/client/slot-provider.d.ts.map +1 -0
  380. package/dist/client/ssr-data.d.ts +26 -50
  381. package/dist/client/ssr-data.d.ts.map +1 -1
  382. package/dist/client/stale-client.d.ts +69 -0
  383. package/dist/client/stale-client.d.ts.map +1 -0
  384. package/dist/client/state.d.ts +21 -13
  385. package/dist/client/state.d.ts.map +1 -1
  386. package/dist/client/status-page-marker.d.ts +25 -0
  387. package/dist/client/status-page-marker.d.ts.map +1 -0
  388. package/dist/client/top-loader.d.ts +7 -6
  389. package/dist/client/top-loader.d.ts.map +1 -1
  390. package/dist/client/unload-guard.d.ts +5 -0
  391. package/dist/client/unload-guard.d.ts.map +1 -1
  392. package/dist/client/use-cookie.d.ts +25 -0
  393. package/dist/client/use-cookie.d.ts.map +1 -1
  394. package/dist/client/use-field-state.d.ts +42 -0
  395. package/dist/client/use-field-state.d.ts.map +1 -0
  396. package/dist/client/use-link-status.d.ts +5 -5
  397. package/dist/client/use-link-status.d.ts.map +1 -1
  398. package/dist/client/use-pathname.d.ts +13 -11
  399. package/dist/client/use-pathname.d.ts.map +1 -1
  400. package/dist/client/use-pending-navigation.d.ts +47 -0
  401. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  402. package/dist/client/use-query-states.d.ts +10 -4
  403. package/dist/client/use-query-states.d.ts.map +1 -1
  404. package/dist/client/use-router.d.ts +15 -8
  405. package/dist/client/use-router.d.ts.map +1 -1
  406. package/dist/client/use-search-params.d.ts +15 -8
  407. package/dist/client/use-search-params.d.ts.map +1 -1
  408. package/dist/client/use-segment-params.d.ts +55 -0
  409. package/dist/client/use-segment-params.d.ts.map +1 -0
  410. package/dist/codec.d.ts +69 -0
  411. package/dist/codec.d.ts.map +1 -0
  412. package/dist/codec.js +75 -0
  413. package/dist/codec.js.map +1 -0
  414. package/dist/config-types.d.ts +366 -0
  415. package/dist/config-types.d.ts.map +1 -0
  416. package/dist/config-validation.d.ts +68 -0
  417. package/dist/config-validation.d.ts.map +1 -0
  418. package/dist/cookies/define-cookie.d.ts +58 -25
  419. package/dist/cookies/define-cookie.d.ts.map +1 -1
  420. package/dist/cookies/index.d.ts +3 -2
  421. package/dist/cookies/index.d.ts.map +1 -1
  422. package/dist/cookies/index.js +230 -37
  423. package/dist/cookies/index.js.map +1 -1
  424. package/dist/cookies/json-cookie.d.ts +64 -0
  425. package/dist/cookies/json-cookie.d.ts.map +1 -0
  426. package/dist/cookies/validation.d.ts +34 -0
  427. package/dist/cookies/validation.d.ts.map +1 -0
  428. package/dist/dev-tools/404-page.d.ts +50 -0
  429. package/dist/dev-tools/404-page.d.ts.map +1 -0
  430. package/dist/dev-tools/await-span.d.ts +17 -0
  431. package/dist/dev-tools/await-span.d.ts.map +1 -0
  432. package/dist/dev-tools/browser-logs.d.ts +40 -0
  433. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  434. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  435. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  436. package/dist/dev-tools/error-page.d.ts +32 -0
  437. package/dist/dev-tools/error-page.d.ts.map +1 -0
  438. package/dist/dev-tools/holding-server.d.ts +46 -0
  439. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  440. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  441. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  442. package/dist/dev-tools/index.d.ts +31 -0
  443. package/dist/dev-tools/index.d.ts.map +1 -0
  444. package/dist/dev-tools/instrumentation.d.ts +74 -0
  445. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  446. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  447. package/dist/dev-tools/logger.d.ts.map +1 -0
  448. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  449. package/dist/dev-tools/logs.d.ts.map +1 -0
  450. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  451. package/dist/dev-tools/overlay.d.ts.map +1 -0
  452. package/dist/dev-tools/span-sink.d.ts +42 -0
  453. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  454. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  455. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  456. package/dist/dev-tools/terminal.d.ts +28 -0
  457. package/dist/dev-tools/terminal.d.ts.map +1 -0
  458. package/dist/fonts/ast-walk.d.ts +68 -0
  459. package/dist/fonts/ast-walk.d.ts.map +1 -0
  460. package/dist/fonts/ast.d.ts +112 -8
  461. package/dist/fonts/ast.d.ts.map +1 -1
  462. package/dist/fonts/bundle.d.ts +50 -0
  463. package/dist/fonts/bundle.d.ts.map +1 -0
  464. package/dist/fonts/css.d.ts +1 -1
  465. package/dist/fonts/dev-middleware.d.ts +22 -0
  466. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  467. package/dist/fonts/fallbacks.d.ts +0 -7
  468. package/dist/fonts/fallbacks.d.ts.map +1 -1
  469. package/dist/fonts/google.d.ts +5 -3
  470. package/dist/fonts/google.d.ts.map +1 -1
  471. package/dist/fonts/local.d.ts +5 -5
  472. package/dist/fonts/local.d.ts.map +1 -1
  473. package/dist/fonts/paths.d.ts +43 -0
  474. package/dist/fonts/paths.d.ts.map +1 -0
  475. package/dist/fonts/pipeline.d.ts +177 -0
  476. package/dist/fonts/pipeline.d.ts.map +1 -0
  477. package/dist/fonts/transform.d.ts +82 -0
  478. package/dist/fonts/transform.d.ts.map +1 -0
  479. package/dist/fonts/types.d.ts +47 -1
  480. package/dist/fonts/types.d.ts.map +1 -1
  481. package/dist/fonts/virtual-modules.d.ts +77 -0
  482. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  483. package/dist/index.d.ts +35 -181
  484. package/dist/index.d.ts.map +1 -1
  485. package/dist/index.js +9949 -14264
  486. package/dist/index.js.map +1 -1
  487. package/dist/params/codec-registry.d.ts +26 -0
  488. package/dist/params/codec-registry.d.ts.map +1 -0
  489. package/dist/params/define-schema.d.ts +81 -0
  490. package/dist/params/define-schema.d.ts.map +1 -0
  491. package/dist/params/index.d.ts +5 -0
  492. package/dist/params/index.d.ts.map +1 -0
  493. package/dist/params/index.js +33 -0
  494. package/dist/params/index.js.map +1 -0
  495. package/dist/params/resolve-schema.d.ts +34 -0
  496. package/dist/params/resolve-schema.d.ts.map +1 -0
  497. package/dist/plugin-context.d.ts +269 -0
  498. package/dist/plugin-context.d.ts.map +1 -0
  499. package/dist/plugins/build-manifest.d.ts +7 -3
  500. package/dist/plugins/build-manifest.d.ts.map +1 -1
  501. package/dist/plugins/build-report.d.ts +61 -11
  502. package/dist/plugins/build-report.d.ts.map +1 -1
  503. package/dist/plugins/cache.d.ts +64 -0
  504. package/dist/plugins/cache.d.ts.map +1 -0
  505. package/dist/plugins/callsite-ast.d.ts +117 -0
  506. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  507. package/dist/plugins/callsite-jsx.d.ts +35 -0
  508. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  509. package/dist/plugins/chunks.d.ts +11 -4
  510. package/dist/plugins/chunks.d.ts.map +1 -1
  511. package/dist/plugins/client-chunks.d.ts +40 -0
  512. package/dist/plugins/client-chunks.d.ts.map +1 -0
  513. package/dist/plugins/client-dep-entries.d.ts +80 -0
  514. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  515. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  516. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  517. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  518. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  519. package/dist/plugins/content.d.ts +1 -1
  520. package/dist/plugins/content.d.ts.map +1 -1
  521. package/dist/plugins/dev-await.d.ts +81 -0
  522. package/dist/plugins/dev-await.d.ts.map +1 -0
  523. package/dist/plugins/dev-discovery.d.ts +187 -0
  524. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  525. package/dist/plugins/dev-hostname.d.ts +152 -0
  526. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  527. package/dist/plugins/dev-server.d.ts +29 -2
  528. package/dist/plugins/dev-server.d.ts.map +1 -1
  529. package/dist/plugins/dev-store-clear.d.ts +83 -0
  530. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  531. package/dist/plugins/encryption-runtime.d.ts +13 -0
  532. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  533. package/dist/plugins/entries.d.ts +40 -4
  534. package/dist/plugins/entries.d.ts.map +1 -1
  535. package/dist/plugins/fonts.d.ts +35 -74
  536. package/dist/plugins/fonts.d.ts.map +1 -1
  537. package/dist/plugins/graph-endpoint.d.ts +114 -0
  538. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  539. package/dist/plugins/mdx.d.ts +18 -5
  540. package/dist/plugins/mdx.d.ts.map +1 -1
  541. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  542. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  543. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  544. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  545. package/dist/plugins/orphaned-modules.d.ts +57 -0
  546. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  547. package/dist/plugins/post-build.d.ts +110 -0
  548. package/dist/plugins/post-build.d.ts.map +1 -0
  549. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  550. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  551. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  552. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt.d.ts +98 -0
  554. package/dist/plugins/prebuilt.d.ts.map +1 -0
  555. package/dist/plugins/prerender-sugar.d.ts +39 -0
  556. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  557. package/dist/plugins/react-resolve.d.ts +49 -0
  558. package/dist/plugins/react-resolve.d.ts.map +1 -0
  559. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  560. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  561. package/dist/plugins/request-dep/index.d.ts +75 -0
  562. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/origin.d.ts +61 -0
  564. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  565. package/dist/plugins/routing.d.ts +2 -2
  566. package/dist/plugins/routing.d.ts.map +1 -1
  567. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  568. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  569. package/dist/plugins/server-bundle.d.ts +1 -1
  570. package/dist/plugins/server-bundle.d.ts.map +1 -1
  571. package/dist/plugins/shims.d.ts +29 -5
  572. package/dist/plugins/shims.d.ts.map +1 -1
  573. package/dist/plugins/static-build.d.ts +246 -26
  574. package/dist/plugins/static-build.d.ts.map +1 -1
  575. package/dist/routing/codegen-shared.d.ts +26 -0
  576. package/dist/routing/codegen-shared.d.ts.map +1 -0
  577. package/dist/routing/codegen-types.d.ts +61 -0
  578. package/dist/routing/codegen-types.d.ts.map +1 -0
  579. package/dist/routing/codegen-write.d.ts +42 -0
  580. package/dist/routing/codegen-write.d.ts.map +1 -0
  581. package/dist/routing/codegen.d.ts +8 -3
  582. package/dist/routing/codegen.d.ts.map +1 -1
  583. package/dist/routing/collision-probe.d.ts +104 -0
  584. package/dist/routing/collision-probe.d.ts.map +1 -0
  585. package/dist/routing/collision-spaces.d.ts +26 -0
  586. package/dist/routing/collision-spaces.d.ts.map +1 -0
  587. package/dist/routing/convention-lint.d.ts +55 -0
  588. package/dist/routing/convention-lint.d.ts.map +1 -0
  589. package/dist/routing/export-detect.d.ts +91 -0
  590. package/dist/routing/export-detect.d.ts.map +1 -0
  591. package/dist/routing/file-cache.d.ts +8 -0
  592. package/dist/routing/file-cache.d.ts.map +1 -0
  593. package/dist/routing/index.d.ts +13 -7
  594. package/dist/routing/index.d.ts.map +1 -1
  595. package/dist/routing/index.js +5 -2
  596. package/dist/routing/interception-overlap.d.ts +35 -0
  597. package/dist/routing/interception-overlap.d.ts.map +1 -0
  598. package/dist/routing/interception.d.ts +234 -10
  599. package/dist/routing/interception.d.ts.map +1 -1
  600. package/dist/routing/link-codegen.d.ts +105 -0
  601. package/dist/routing/link-codegen.d.ts.map +1 -0
  602. package/dist/routing/manifest-codegen.d.ts +26 -0
  603. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  604. package/dist/routing/scanner.d.ts +14 -10
  605. package/dist/routing/scanner.d.ts.map +1 -1
  606. package/dist/routing/schema-validation.d.ts +35 -0
  607. package/dist/routing/schema-validation.d.ts.map +1 -0
  608. package/dist/routing/segment-classify.d.ts +114 -0
  609. package/dist/routing/segment-classify.d.ts.map +1 -0
  610. package/dist/routing/segment-codegen.d.ts +38 -0
  611. package/dist/routing/segment-codegen.d.ts.map +1 -0
  612. package/dist/routing/segment-keys.d.ts +118 -0
  613. package/dist/routing/segment-keys.d.ts.map +1 -0
  614. package/dist/routing/slot-placement.d.ts +48 -0
  615. package/dist/routing/slot-placement.d.ts.map +1 -0
  616. package/dist/routing/types.d.ts +81 -26
  617. package/dist/routing/types.d.ts.map +1 -1
  618. package/dist/routing/walkers.d.ts +57 -0
  619. package/dist/routing/walkers.d.ts.map +1 -0
  620. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  621. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  622. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  623. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  624. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  625. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  626. package/dist/rsc-runtime/rsc.d.ts +3 -13
  627. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  628. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  629. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  630. package/dist/rsc-runtime/server-references.d.ts +19 -0
  631. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  632. package/dist/rsc-runtime/ssr.d.ts +7 -10
  633. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  634. package/dist/rsc-runtime/transforms.d.ts +13 -0
  635. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  636. package/dist/schema-bridge.d.ts +154 -0
  637. package/dist/schema-bridge.d.ts.map +1 -0
  638. package/dist/search-params/define.d.ts +262 -0
  639. package/dist/search-params/define.d.ts.map +1 -0
  640. package/dist/search-params/index.d.ts +3 -7
  641. package/dist/search-params/index.d.ts.map +1 -1
  642. package/dist/search-params/index.js +178 -362
  643. package/dist/search-params/index.js.map +1 -1
  644. package/dist/search-params/parse-total.d.ts +81 -0
  645. package/dist/search-params/parse-total.d.ts.map +1 -0
  646. package/dist/search-params/serialize-equal.d.ts +9 -0
  647. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  648. package/dist/search-params/wrappers.d.ts +76 -0
  649. package/dist/search-params/wrappers.d.ts.map +1 -0
  650. package/dist/server/abort-scope.d.ts +27 -0
  651. package/dist/server/abort-scope.d.ts.map +1 -0
  652. package/dist/server/access-gate.d.ts +110 -10
  653. package/dist/server/access-gate.d.ts.map +1 -1
  654. package/dist/server/action-client.d.ts +20 -133
  655. package/dist/server/action-client.d.ts.map +1 -1
  656. package/dist/server/action-encryption.d.ts +76 -0
  657. package/dist/server/action-encryption.d.ts.map +1 -0
  658. package/dist/server/action-handler.d.ts +60 -11
  659. package/dist/server/action-handler.d.ts.map +1 -1
  660. package/dist/server/action-schema.d.ts +126 -0
  661. package/dist/server/action-schema.d.ts.map +1 -0
  662. package/dist/server/action-types.d.ts +108 -0
  663. package/dist/server/action-types.d.ts.map +1 -0
  664. package/dist/server/actions.d.ts +78 -40
  665. package/dist/server/actions.d.ts.map +1 -1
  666. package/dist/server/als-registry.d.ts +189 -17
  667. package/dist/server/als-registry.d.ts.map +1 -1
  668. package/dist/server/body-limits.d.ts.map +1 -1
  669. package/dist/server/build-manifest.d.ts +25 -30
  670. package/dist/server/build-manifest.d.ts.map +1 -1
  671. package/dist/server/canonicalize.d.ts +53 -0
  672. package/dist/server/canonicalize.d.ts.map +1 -1
  673. package/dist/server/chain-url-parts.d.ts +82 -0
  674. package/dist/server/chain-url-parts.d.ts.map +1 -0
  675. package/dist/server/children-interception.d.ts +49 -0
  676. package/dist/server/children-interception.d.ts.map +1 -0
  677. package/dist/server/client-error-message.d.ts +12 -0
  678. package/dist/server/client-error-message.d.ts.map +1 -0
  679. package/dist/server/coalesce-tick.d.ts +40 -0
  680. package/dist/server/coalesce-tick.d.ts.map +1 -0
  681. package/dist/server/compress.d.ts +2 -0
  682. package/dist/server/compress.d.ts.map +1 -1
  683. package/dist/server/cookie-context.d.ts +156 -0
  684. package/dist/server/cookie-context.d.ts.map +1 -0
  685. package/dist/server/cookie-parsing.d.ts +65 -0
  686. package/dist/server/cookie-parsing.d.ts.map +1 -0
  687. package/dist/server/csp-nonce.d.ts +36 -0
  688. package/dist/server/csp-nonce.d.ts.map +1 -0
  689. package/dist/server/csrf.d.ts +58 -15
  690. package/dist/server/csrf.d.ts.map +1 -1
  691. package/dist/server/debug.d.ts +0 -1
  692. package/dist/server/debug.d.ts.map +1 -1
  693. package/dist/server/default-logger.d.ts +23 -0
  694. package/dist/server/default-logger.d.ts.map +1 -0
  695. package/dist/server/default-status-page.d.ts +45 -0
  696. package/dist/server/default-status-page.d.ts.map +1 -0
  697. package/dist/server/deny-boundary.d.ts +257 -0
  698. package/dist/server/deny-boundary.d.ts.map +1 -0
  699. package/dist/server/deny-renderer.d.ts +22 -15
  700. package/dist/server/deny-renderer.d.ts.map +1 -1
  701. package/dist/server/early-hints-sender.d.ts.map +1 -1
  702. package/dist/server/early-hints.d.ts +14 -12
  703. package/dist/server/early-hints.d.ts.map +1 -1
  704. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  705. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  706. package/dist/server/error-response-headers.d.ts +3 -0
  707. package/dist/server/error-response-headers.d.ts.map +1 -0
  708. package/dist/server/fallback-error.d.ts +19 -7
  709. package/dist/server/fallback-error.d.ts.map +1 -1
  710. package/dist/server/flight-injection-state.d.ts +66 -0
  711. package/dist/server/flight-injection-state.d.ts.map +1 -0
  712. package/dist/server/flight-injector-core.d.ts +125 -0
  713. package/dist/server/flight-injector-core.d.ts.map +1 -0
  714. package/dist/server/flight-scripts.d.ts +63 -0
  715. package/dist/server/flight-scripts.d.ts.map +1 -0
  716. package/dist/server/flight-source-node.d.ts +105 -0
  717. package/dist/server/flight-source-node.d.ts.map +1 -0
  718. package/dist/server/flight-source.d.ts +136 -0
  719. package/dist/server/flight-source.d.ts.map +1 -0
  720. package/dist/server/form-data.d.ts +59 -2
  721. package/dist/server/form-data.d.ts.map +1 -1
  722. package/dist/server/form-state-flight.d.ts +32 -0
  723. package/dist/server/form-state-flight.d.ts.map +1 -0
  724. package/dist/server/head-response.d.ts +35 -0
  725. package/dist/server/head-response.d.ts.map +1 -0
  726. package/dist/server/html-injector-core.d.ts +169 -0
  727. package/dist/server/html-injector-core.d.ts.map +1 -0
  728. package/dist/server/html-injectors.d.ts +77 -47
  729. package/dist/server/html-injectors.d.ts.map +1 -1
  730. package/dist/server/index.d.ts +16 -54
  731. package/dist/server/index.d.ts.map +1 -1
  732. package/dist/server/index.js +621 -3009
  733. package/dist/server/index.js.map +1 -1
  734. package/dist/server/instrumentation.d.ts +13 -5
  735. package/dist/server/instrumentation.d.ts.map +1 -1
  736. package/dist/server/interception-gates.d.ts +49 -0
  737. package/dist/server/interception-gates.d.ts.map +1 -0
  738. package/dist/server/internal.d.ts +48 -0
  739. package/dist/server/internal.d.ts.map +1 -0
  740. package/dist/server/internal.js +5094 -0
  741. package/dist/server/internal.js.map +1 -0
  742. package/dist/server/json-status-response.d.ts +34 -0
  743. package/dist/server/json-status-response.d.ts.map +1 -0
  744. package/dist/server/logger.d.ts +105 -7
  745. package/dist/server/logger.d.ts.map +1 -1
  746. package/dist/server/metadata-collector.d.ts +75 -0
  747. package/dist/server/metadata-collector.d.ts.map +1 -0
  748. package/dist/server/metadata-platform.d.ts +2 -2
  749. package/dist/server/metadata-render.d.ts +2 -2
  750. package/dist/server/metadata-render.d.ts.map +1 -1
  751. package/dist/server/metadata-route-links.d.ts +70 -0
  752. package/dist/server/metadata-route-links.d.ts.map +1 -0
  753. package/dist/server/metadata-routes.d.ts +47 -11
  754. package/dist/server/metadata-routes.d.ts.map +1 -1
  755. package/dist/server/metadata-social.d.ts +2 -2
  756. package/dist/server/metadata.d.ts +10 -2
  757. package/dist/server/metadata.d.ts.map +1 -1
  758. package/dist/server/middleware-runner.d.ts +20 -5
  759. package/dist/server/middleware-runner.d.ts.map +1 -1
  760. package/dist/server/node-body-response.d.ts +55 -0
  761. package/dist/server/node-body-response.d.ts.map +1 -0
  762. package/dist/server/node-response.d.ts +62 -0
  763. package/dist/server/node-response.d.ts.map +1 -0
  764. package/dist/server/node-stream-transforms.d.ts +108 -0
  765. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  766. package/dist/server/node-streams-platform.d.ts +21 -0
  767. package/dist/server/node-streams-platform.d.ts.map +1 -0
  768. package/dist/server/param-coercion.d.ts +91 -0
  769. package/dist/server/param-coercion.d.ts.map +1 -0
  770. package/dist/server/pipeline-helpers.d.ts +227 -0
  771. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  772. package/dist/server/pipeline-interception.d.ts +100 -9
  773. package/dist/server/pipeline-interception.d.ts.map +1 -1
  774. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  775. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  776. package/dist/server/pipeline-metadata.d.ts +18 -2
  777. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  778. package/dist/server/pipeline-outcome.d.ts +59 -0
  779. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  780. package/dist/server/pipeline-phases.d.ts +76 -0
  781. package/dist/server/pipeline-phases.d.ts.map +1 -0
  782. package/dist/server/pipeline.d.ts +190 -23
  783. package/dist/server/pipeline.d.ts.map +1 -1
  784. package/dist/server/port-resolution.d.ts +22 -0
  785. package/dist/server/port-resolution.d.ts.map +1 -0
  786. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  787. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  788. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  789. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  790. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  791. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  792. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  793. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  794. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  795. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  796. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  797. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  798. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  799. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  800. package/dist/server/prebuilt/overlay.d.ts +119 -0
  801. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  802. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  803. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  804. package/dist/server/prebuilt/slots.d.ts +105 -0
  805. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  806. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  807. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  808. package/dist/server/prebuilt-builder.d.ts +121 -0
  809. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  810. package/dist/server/prebuilt-runtime.d.ts +105 -0
  811. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  812. package/dist/server/primitives.d.ts +114 -90
  813. package/dist/server/primitives.d.ts.map +1 -1
  814. package/dist/server/publish-params.d.ts +33 -0
  815. package/dist/server/publish-params.d.ts.map +1 -0
  816. package/dist/server/react-cache-bridge.d.ts +59 -0
  817. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  818. package/dist/server/react-cache-scope.d.ts +49 -0
  819. package/dist/server/react-cache-scope.d.ts.map +1 -0
  820. package/dist/server/render-timeout.d.ts +66 -0
  821. package/dist/server/render-timeout.d.ts.map +1 -0
  822. package/dist/server/render-utils.d.ts +56 -0
  823. package/dist/server/render-utils.d.ts.map +1 -0
  824. package/dist/server/request-context.d.ts +167 -103
  825. package/dist/server/request-context.d.ts.map +1 -1
  826. package/dist/server/request-dep.d.ts +15 -0
  827. package/dist/server/request-dep.d.ts.map +1 -0
  828. package/dist/server/response-cache-policy.d.ts +3 -0
  829. package/dist/server/response-cache-policy.d.ts.map +1 -0
  830. package/dist/server/response-framing.d.ts +43 -0
  831. package/dist/server/response-framing.d.ts.map +1 -0
  832. package/dist/server/route-element-builder.d.ts +57 -30
  833. package/dist/server/route-element-builder.d.ts.map +1 -1
  834. package/dist/server/route-element-helpers.d.ts +12 -0
  835. package/dist/server/route-element-helpers.d.ts.map +1 -0
  836. package/dist/server/route-handler.d.ts +9 -3
  837. package/dist/server/route-handler.d.ts.map +1 -1
  838. package/dist/server/route-matcher.d.ts +75 -40
  839. package/dist/server/route-matcher.d.ts.map +1 -1
  840. package/dist/server/route-methods.d.ts +23 -0
  841. package/dist/server/route-methods.d.ts.map +1 -0
  842. package/dist/server/route-module-loader.d.ts +37 -0
  843. package/dist/server/route-module-loader.d.ts.map +1 -0
  844. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  845. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  846. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  847. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  848. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  849. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  850. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  851. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  852. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  853. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  854. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  855. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  856. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  857. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  858. package/dist/server/rsc-entry/index.d.ts +30 -6
  859. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  860. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  861. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  862. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  863. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  865. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  866. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  867. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  869. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  871. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  872. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  873. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  874. package/dist/server/rsc-error-envelope.d.ts +11 -0
  875. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  876. package/dist/server/safe-load.d.ts +39 -0
  877. package/dist/server/safe-load.d.ts.map +1 -0
  878. package/dist/server/schema-introspection.d.ts +68 -0
  879. package/dist/server/schema-introspection.d.ts.map +1 -0
  880. package/dist/server/sensitive-fields.d.ts +88 -0
  881. package/dist/server/sensitive-fields.d.ts.map +1 -0
  882. package/dist/server/signal-identity.d.ts +49 -0
  883. package/dist/server/signal-identity.d.ts.map +1 -0
  884. package/dist/server/sitemap-generator.d.ts +130 -0
  885. package/dist/server/sitemap-generator.d.ts.map +1 -0
  886. package/dist/server/sitemap-handler.d.ts +22 -0
  887. package/dist/server/sitemap-handler.d.ts.map +1 -0
  888. package/dist/server/skippable-prefix.d.ts +29 -0
  889. package/dist/server/skippable-prefix.d.ts.map +1 -0
  890. package/dist/server/slot-interception.d.ts +80 -0
  891. package/dist/server/slot-interception.d.ts.map +1 -0
  892. package/dist/server/slot-resolver.d.ts +138 -7
  893. package/dist/server/slot-resolver.d.ts.map +1 -1
  894. package/dist/server/slot-subtree-contain.d.ts +54 -0
  895. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  896. package/dist/server/ssr-bridge-types.d.ts +213 -0
  897. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  898. package/dist/server/ssr-entry.d.ts +15 -51
  899. package/dist/server/ssr-entry.d.ts.map +1 -1
  900. package/dist/server/ssr-form-state.d.ts +30 -0
  901. package/dist/server/ssr-form-state.d.ts.map +1 -0
  902. package/dist/server/ssr-render.d.ts +42 -12
  903. package/dist/server/ssr-render.d.ts.map +1 -1
  904. package/dist/server/ssr-wrappers.d.ts +92 -0
  905. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  906. package/dist/server/state-tree-diff.d.ts +44 -9
  907. package/dist/server/state-tree-diff.d.ts.map +1 -1
  908. package/dist/server/static-generator.d.ts +112 -0
  909. package/dist/server/static-generator.d.ts.map +1 -0
  910. package/dist/server/static-not-found.d.ts +52 -0
  911. package/dist/server/static-not-found.d.ts.map +1 -0
  912. package/dist/server/status-code-resolver.d.ts +26 -15
  913. package/dist/server/status-code-resolver.d.ts.map +1 -1
  914. package/dist/server/stream-utils.d.ts +93 -0
  915. package/dist/server/stream-utils.d.ts.map +1 -0
  916. package/dist/server/traced-access.d.ts +18 -0
  917. package/dist/server/traced-access.d.ts.map +1 -0
  918. package/dist/server/tracing.d.ts +72 -31
  919. package/dist/server/tracing.d.ts.map +1 -1
  920. package/dist/server/tree-match.d.ts +59 -0
  921. package/dist/server/tree-match.d.ts.map +1 -0
  922. package/dist/server/types.d.ts +90 -8
  923. package/dist/server/types.d.ts.map +1 -1
  924. package/dist/server/utils/element-type.d.ts +50 -0
  925. package/dist/server/utils/element-type.d.ts.map +1 -0
  926. package/dist/server/utils/escape-html.d.ts +14 -0
  927. package/dist/server/utils/escape-html.d.ts.map +1 -0
  928. package/dist/server/version-skew.d.ts +61 -0
  929. package/dist/server/version-skew.d.ts.map +1 -0
  930. package/dist/server/workers-cache-bridge.d.ts +26 -0
  931. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  932. package/dist/shared/als-slots.d.ts +42 -0
  933. package/dist/shared/als-slots.d.ts.map +1 -0
  934. package/dist/shared/base-path.d.ts +56 -0
  935. package/dist/shared/base-path.d.ts.map +1 -0
  936. package/dist/shared/csrf-reject.d.ts +16 -0
  937. package/dist/shared/csrf-reject.d.ts.map +1 -0
  938. package/dist/shared/dev-span.d.ts +99 -0
  939. package/dist/shared/dev-span.d.ts.map +1 -0
  940. package/dist/shared/error-digest.d.ts +28 -0
  941. package/dist/shared/error-digest.d.ts.map +1 -0
  942. package/dist/shared/flight-base64.d.ts +13 -0
  943. package/dist/shared/flight-base64.d.ts.map +1 -0
  944. package/dist/shared/flight-segment.d.ts +18 -0
  945. package/dist/shared/flight-segment.d.ts.map +1 -0
  946. package/dist/shared/form-state-flight.d.ts +32 -0
  947. package/dist/shared/form-state-flight.d.ts.map +1 -0
  948. package/dist/shared/href-validation.d.ts +49 -0
  949. package/dist/shared/href-validation.d.ts.map +1 -0
  950. package/dist/shared/merge-search-params.d.ts +22 -0
  951. package/dist/shared/merge-search-params.d.ts.map +1 -0
  952. package/dist/shared/param-value.d.ts +104 -0
  953. package/dist/shared/param-value.d.ts.map +1 -0
  954. package/dist/shared/payload-root.d.ts +110 -0
  955. package/dist/shared/payload-root.d.ts.map +1 -0
  956. package/dist/shared/redirect-type.d.ts +17 -0
  957. package/dist/shared/redirect-type.d.ts.map +1 -0
  958. package/dist/shared/rsc-cache-key.d.ts +163 -0
  959. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  960. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  961. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  962. package/dist/shared/rsc-manifest.d.ts +28 -0
  963. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  964. package/dist/shared/rsc-media-type.d.ts +52 -0
  965. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  966. package/dist/shared/rsc-payload-path.d.ts +48 -0
  967. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  968. package/dist/shared/segment-info.d.ts +66 -0
  969. package/dist/shared/segment-info.d.ts.map +1 -0
  970. package/dist/shared/slot-params.d.ts +52 -0
  971. package/dist/shared/slot-params.d.ts.map +1 -0
  972. package/dist/shared/static-platform-files.d.ts +71 -0
  973. package/dist/shared/static-platform-files.d.ts.map +1 -0
  974. package/dist/shared/status-reason-phrase.d.ts +26 -0
  975. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  976. package/dist/shims/font-google.d.ts +1 -1
  977. package/dist/shims/font-google.d.ts.map +1 -1
  978. package/dist/shims/font-google.js +41 -0
  979. package/dist/shims/font-google.js.map +1 -0
  980. package/dist/shims/font-local.d.ts +26 -0
  981. package/dist/shims/font-local.d.ts.map +1 -0
  982. package/dist/shims/font-local.js +19 -0
  983. package/dist/shims/font-local.js.map +1 -0
  984. package/dist/shims/headers.d.ts +60 -1
  985. package/dist/shims/headers.d.ts.map +1 -1
  986. package/dist/shims/image.d.ts +120 -120
  987. package/dist/shims/image.d.ts.map +1 -1
  988. package/dist/shims/navigation-client.d.ts +25 -12
  989. package/dist/shims/navigation-client.d.ts.map +1 -1
  990. package/dist/shims/navigation-rsc.d.ts +21 -0
  991. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  992. package/dist/shims/navigation.d.ts +10 -5
  993. package/dist/shims/navigation.d.ts.map +1 -1
  994. package/dist/utils/state-machine.d.ts +80 -0
  995. package/dist/utils/state-machine.d.ts.map +1 -0
  996. package/dist/utils/write-file-atomic.d.ts +17 -0
  997. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  998. package/docs/api/30-api-server.mdx +241 -0
  999. package/docs/api/31-api-client.mdx +225 -0
  1000. package/docs/api/32-api-cache.mdx +341 -0
  1001. package/docs/api/33-api-search-params.mdx +178 -0
  1002. package/docs/api/34-api-config.mdx +421 -0
  1003. package/docs/api/35-api-typescript.mdx +91 -0
  1004. package/docs/api/36-cli.mdx +272 -0
  1005. package/docs/learn/00-introduction.mdx +109 -0
  1006. package/docs/learn/01-quick-start.mdx +94 -0
  1007. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1008. package/docs/learn/03-fetching-data.mdx +227 -0
  1009. package/docs/learn/04-access-control.mdx +115 -0
  1010. package/docs/learn/05-the-flush-point.mdx +175 -0
  1011. package/docs/learn/06-typed-params.mdx +275 -0
  1012. package/docs/learn/07-typed-routes.mdx +108 -0
  1013. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1014. package/docs/learn/09-streaming.mdx +146 -0
  1015. package/docs/learn/10-caching.mdx +303 -0
  1016. package/docs/learn/11-middleware.mdx +166 -0
  1017. package/docs/learn/12-error-handling.mdx +192 -0
  1018. package/docs/learn/13-deploying.mdx +289 -0
  1019. package/llms.txt +55 -0
  1020. package/package.json +120 -29
  1021. package/src/adapters/build-output-helper.ts +375 -0
  1022. package/src/adapters/canonicalize-module.ts +29 -0
  1023. package/src/adapters/cloudflare-dev.ts +183 -0
  1024. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1025. package/src/adapters/cloudflare.ts +799 -151
  1026. package/src/adapters/compress-module.ts +110 -86
  1027. package/src/adapters/fs-identity.ts +155 -0
  1028. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1029. package/src/adapters/nitro-presets.ts +139 -0
  1030. package/src/adapters/nitro-preview.ts +565 -0
  1031. package/src/adapters/nitro.ts +349 -448
  1032. package/src/adapters/raw-imports.d.ts +5 -0
  1033. package/src/adapters/shared.ts +314 -0
  1034. package/src/adapters/types.ts +129 -17
  1035. package/src/adapters/wrangler.d.ts +7 -0
  1036. package/src/analyze/chains.ts +411 -0
  1037. package/src/analyze/classify.ts +259 -0
  1038. package/src/analyze/crawl-entry.ts +68 -0
  1039. package/src/analyze/crawl.ts +500 -0
  1040. package/src/analyze/graph-cache.ts +331 -0
  1041. package/src/analyze/graph-command.ts +654 -0
  1042. package/src/analyze/live-graph.ts +232 -0
  1043. package/src/analyze/poison-rules.ts +165 -0
  1044. package/src/analyze/poison-scan.ts +159 -0
  1045. package/src/analyze/scan.ts +149 -0
  1046. package/src/cache/cache-api.ts +113 -0
  1047. package/src/cache/fast-hash.ts +5 -0
  1048. package/src/cache/guarded-read.ts +44 -0
  1049. package/src/cache/handler-store.ts +113 -0
  1050. package/src/cache/index.ts +93 -20
  1051. package/src/cache/invalidation-epoch.ts +105 -0
  1052. package/src/cache/json-lossy-check.ts +69 -0
  1053. package/src/cache/key-discipline.ts +218 -0
  1054. package/src/cache/redis-handler.ts +193 -19
  1055. package/src/cache/singleflight.ts +85 -7
  1056. package/src/cache/sizeof.ts +35 -0
  1057. package/src/cache/stable-stringify.ts +118 -2
  1058. package/src/cache/store.ts +71 -0
  1059. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1060. package/src/cache/stores/memory.ts +125 -0
  1061. package/src/cache/stores/redis.ts +97 -0
  1062. package/src/cache/stores/vercel.ts +59 -0
  1063. package/src/cache/tag-aware-handler.ts +250 -0
  1064. package/src/cache/timber-cache.ts +218 -47
  1065. package/src/cdn/cloudflare-purge.ts +50 -0
  1066. package/src/cdn/fastly-purge.ts +63 -0
  1067. package/src/cdn/headers.ts +153 -0
  1068. package/src/cdn/index.ts +23 -0
  1069. package/src/cdn/purge-store.ts +62 -0
  1070. package/src/cdn/workers-cache-purge.ts +34 -0
  1071. package/src/cli-check.ts +417 -0
  1072. package/src/cli-context.ts +128 -0
  1073. package/src/cli-dev-status.ts +196 -0
  1074. package/src/cli-init.ts +278 -0
  1075. package/src/cli-schema-sync.ts +401 -0
  1076. package/src/cli.ts +308 -84
  1077. package/src/client/browser-dev.ts +192 -5
  1078. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1079. package/src/client/browser-entry/action-queue.ts +152 -0
  1080. package/src/client/browser-entry/form-state.ts +49 -0
  1081. package/src/client/browser-entry/hmr.ts +82 -0
  1082. package/src/client/browser-entry/hydrate.ts +152 -0
  1083. package/src/client/browser-entry/index.ts +153 -0
  1084. package/src/client/browser-entry/post-hydration.ts +99 -0
  1085. package/src/client/browser-entry/router-init.ts +391 -0
  1086. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1087. package/src/client/browser-entry/scroll.ts +50 -0
  1088. package/src/client/deny-last-resort.tsx +54 -0
  1089. package/src/client/dev-pill/index.ts +128 -0
  1090. package/src/client/dev-pill/store.ts +254 -0
  1091. package/src/client/dev-pill/view.ts +326 -0
  1092. package/src/client/error-boundary.tsx +296 -61
  1093. package/src/client/error-reconstituter.tsx +84 -0
  1094. package/src/client/form.tsx +61 -173
  1095. package/src/client/global-context.ts +59 -0
  1096. package/src/client/history.ts +74 -11
  1097. package/src/client/index.ts +91 -53
  1098. package/src/client/internal.ts +54 -0
  1099. package/src/client/link.tsx +464 -151
  1100. package/src/client/location-search.ts +15 -0
  1101. package/src/client/navigation-api.ts +254 -0
  1102. package/src/client/navigation-commit.ts +318 -0
  1103. package/src/client/navigation-context.ts +71 -142
  1104. package/src/client/navigation-root.tsx +237 -0
  1105. package/src/client/navigation-transition.ts +401 -0
  1106. package/src/client/nuqs-adapter.tsx +62 -32
  1107. package/src/client/params-context.ts +175 -0
  1108. package/src/client/react-root.ts +105 -0
  1109. package/src/client/router-effects.ts +349 -0
  1110. package/src/client/router-lifecycle.ts +394 -0
  1111. package/src/client/router-pipeline.ts +443 -0
  1112. package/src/client/router-ref.ts +3 -3
  1113. package/src/client/router-skew.ts +30 -0
  1114. package/src/client/router-types.ts +326 -0
  1115. package/src/client/router-url.ts +32 -0
  1116. package/src/client/router.ts +491 -421
  1117. package/src/client/rsc-fetch.ts +510 -109
  1118. package/src/client/segment-cache.ts +362 -41
  1119. package/src/client/segment-context.ts +7 -4
  1120. package/src/client/segment-outlet.tsx +96 -0
  1121. package/src/client/segment-update-context.ts +23 -0
  1122. package/src/client/shallow-url.ts +22 -0
  1123. package/src/client/slot-content-cache-context.ts +43 -0
  1124. package/src/client/slot-context.ts +39 -0
  1125. package/src/client/slot-outlet.tsx +22 -0
  1126. package/src/client/slot-provider.tsx +32 -0
  1127. package/src/client/ssr-data.ts +27 -67
  1128. package/src/client/stale-client.ts +191 -0
  1129. package/src/client/state.ts +31 -24
  1130. package/src/client/status-page-marker.tsx +32 -0
  1131. package/src/client/top-loader.tsx +13 -10
  1132. package/src/client/unload-guard.ts +35 -3
  1133. package/src/client/use-cookie.ts +93 -29
  1134. package/src/client/use-field-state.ts +144 -0
  1135. package/src/client/use-link-status.ts +7 -7
  1136. package/src/client/use-pathname.ts +22 -31
  1137. package/src/client/use-pending-navigation.ts +119 -0
  1138. package/src/client/use-query-states.ts +206 -36
  1139. package/src/client/use-router.ts +31 -9
  1140. package/src/client/use-search-params.ts +38 -49
  1141. package/src/client/use-segment-params.ts +69 -0
  1142. package/src/client/use-selected-layout-segment.ts +2 -2
  1143. package/src/codec.ts +149 -0
  1144. package/src/config-types.ts +366 -0
  1145. package/src/config-validation.ts +511 -0
  1146. package/src/cookies/define-cookie.ts +186 -53
  1147. package/src/cookies/index.ts +13 -2
  1148. package/src/cookies/json-cookie.ts +105 -0
  1149. package/src/cookies/validation.ts +192 -0
  1150. package/src/dev-tools/404-page.ts +286 -0
  1151. package/src/dev-tools/await-span.ts +69 -0
  1152. package/src/dev-tools/browser-logs.ts +55 -0
  1153. package/src/dev-tools/dev-page-shell.ts +278 -0
  1154. package/src/dev-tools/error-page.ts +331 -0
  1155. package/src/dev-tools/holding-server.ts +185 -0
  1156. package/src/dev-tools/hydration-overlay.ts +158 -0
  1157. package/src/dev-tools/index.ts +79 -0
  1158. package/src/dev-tools/instrumentation.ts +281 -0
  1159. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1160. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1161. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1162. package/src/dev-tools/span-sink.ts +132 -0
  1163. package/src/dev-tools/stack-classifier.ts +75 -0
  1164. package/src/dev-tools/terminal.ts +182 -0
  1165. package/src/fonts/ast-walk.ts +235 -0
  1166. package/src/fonts/ast.ts +479 -128
  1167. package/src/fonts/bundle.ts +138 -0
  1168. package/src/fonts/css.ts +1 -1
  1169. package/src/fonts/dev-middleware.ts +85 -0
  1170. package/src/fonts/fallbacks.ts +0 -23
  1171. package/src/fonts/google.ts +101 -19
  1172. package/src/fonts/local.ts +12 -11
  1173. package/src/fonts/paths.ts +58 -0
  1174. package/src/fonts/pipeline.ts +348 -0
  1175. package/src/fonts/transform.ts +311 -0
  1176. package/src/fonts/types.ts +52 -1
  1177. package/src/fonts/virtual-modules.ts +179 -0
  1178. package/src/index.ts +498 -380
  1179. package/src/params/codec-registry.ts +34 -0
  1180. package/src/params/define-schema.ts +115 -0
  1181. package/src/params/index.ts +17 -0
  1182. package/src/params/resolve-schema.ts +84 -0
  1183. package/src/plugin-context.ts +509 -0
  1184. package/src/plugins/build-manifest.ts +189 -36
  1185. package/src/plugins/build-report.ts +299 -87
  1186. package/src/plugins/cache.ts +243 -0
  1187. package/src/plugins/callsite-ast.ts +472 -0
  1188. package/src/plugins/callsite-jsx.ts +243 -0
  1189. package/src/plugins/chunks.ts +74 -5
  1190. package/src/plugins/client-chunks.ts +185 -0
  1191. package/src/plugins/client-dep-entries.ts +124 -0
  1192. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1193. package/src/plugins/cloudflare-wasm.ts +141 -0
  1194. package/src/plugins/content.ts +31 -2
  1195. package/src/plugins/dev-await.ts +415 -0
  1196. package/src/plugins/dev-discovery.ts +428 -0
  1197. package/src/plugins/dev-hostname.ts +322 -0
  1198. package/src/plugins/dev-server.ts +471 -100
  1199. package/src/plugins/dev-store-clear.ts +145 -0
  1200. package/src/plugins/encryption-runtime.ts +31 -0
  1201. package/src/plugins/entries.ts +158 -17
  1202. package/src/plugins/fonts.ts +260 -657
  1203. package/src/plugins/graph-endpoint.ts +544 -0
  1204. package/src/plugins/mdx.ts +108 -35
  1205. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1206. package/src/plugins/optimize-package-imports.ts +439 -0
  1207. package/src/plugins/orphaned-modules.ts +78 -0
  1208. package/src/plugins/post-build.ts +327 -0
  1209. package/src/plugins/prebuilt-capture.ts +213 -0
  1210. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1211. package/src/plugins/prebuilt.ts +679 -0
  1212. package/src/plugins/prerender-sugar.ts +348 -0
  1213. package/src/plugins/react-resolve.ts +149 -0
  1214. package/src/plugins/request-dep/analysis.ts +447 -0
  1215. package/src/plugins/request-dep/index.ts +376 -0
  1216. package/src/plugins/request-dep/origin.ts +310 -0
  1217. package/src/plugins/routing.ts +296 -278
  1218. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1219. package/src/plugins/server-bundle.ts +115 -15
  1220. package/src/plugins/shims.ts +257 -97
  1221. package/src/plugins/static-build.ts +681 -71
  1222. package/src/react-canary.d.ts +2 -0
  1223. package/src/routing/codegen-shared.ts +39 -0
  1224. package/src/routing/codegen-types.ts +62 -0
  1225. package/src/routing/codegen-write.ts +163 -0
  1226. package/src/routing/codegen.ts +349 -232
  1227. package/src/routing/collision-probe.ts +438 -0
  1228. package/src/routing/collision-spaces.ts +281 -0
  1229. package/src/routing/convention-lint.ts +649 -0
  1230. package/src/routing/export-detect.ts +536 -0
  1231. package/src/routing/file-cache.ts +23 -0
  1232. package/src/routing/index.ts +16 -7
  1233. package/src/routing/interception-overlap.ts +141 -0
  1234. package/src/routing/interception.ts +1044 -67
  1235. package/src/routing/link-codegen.ts +280 -0
  1236. package/src/routing/manifest-codegen.ts +232 -0
  1237. package/src/routing/scanner.ts +417 -223
  1238. package/src/routing/schema-validation.ts +155 -0
  1239. package/src/routing/segment-classify.ts +280 -0
  1240. package/src/routing/segment-codegen.ts +99 -0
  1241. package/src/routing/segment-keys.ts +186 -0
  1242. package/src/routing/slot-placement.ts +97 -0
  1243. package/src/routing/types.ts +82 -26
  1244. package/src/routing/walkers.ts +98 -0
  1245. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1246. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1247. package/src/rsc-runtime/render-flight.ts +26 -0
  1248. package/src/rsc-runtime/rsc.ts +35 -5
  1249. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1250. package/src/rsc-runtime/server-references.ts +135 -0
  1251. package/src/rsc-runtime/ssr.ts +23 -0
  1252. package/src/rsc-runtime/transforms.ts +13 -0
  1253. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1254. package/src/schema-bridge.ts +437 -0
  1255. package/src/search-params/define.ts +676 -0
  1256. package/src/search-params/index.ts +14 -20
  1257. package/src/search-params/parse-total.ts +91 -0
  1258. package/src/search-params/serialize-equal.ts +14 -0
  1259. package/src/search-params/wrappers.ts +150 -0
  1260. package/src/server/abort-scope.ts +49 -0
  1261. package/src/server/access-gate.tsx +208 -57
  1262. package/src/server/action-client.ts +175 -294
  1263. package/src/server/action-encryption.ts +144 -0
  1264. package/src/server/action-handler.ts +533 -150
  1265. package/src/server/action-schema.ts +203 -0
  1266. package/src/server/action-types.ts +145 -0
  1267. package/src/server/actions.ts +172 -85
  1268. package/src/server/als-registry.ts +245 -30
  1269. package/src/server/body-limits.ts +10 -2
  1270. package/src/server/build-manifest.ts +33 -57
  1271. package/src/server/canonicalize.ts +62 -3
  1272. package/src/server/chain-url-parts.ts +163 -0
  1273. package/src/server/children-interception.ts +116 -0
  1274. package/src/server/client-error-message.ts +18 -0
  1275. package/src/server/coalesce-tick.ts +75 -0
  1276. package/src/server/compress.ts +91 -19
  1277. package/src/server/cookie-context.ts +462 -0
  1278. package/src/server/cookie-parsing.ts +163 -0
  1279. package/src/server/csp-nonce.ts +58 -0
  1280. package/src/server/csrf.ts +238 -37
  1281. package/src/server/debug.ts +0 -1
  1282. package/src/server/default-logger.ts +100 -0
  1283. package/src/server/default-status-page.ts +88 -0
  1284. package/src/server/deny-boundary.ts +527 -0
  1285. package/src/server/deny-renderer.ts +210 -181
  1286. package/src/server/early-hints-sender.ts +4 -3
  1287. package/src/server/early-hints.ts +39 -29
  1288. package/src/server/error-boundary-wrapper.ts +160 -44
  1289. package/src/server/error-response-headers.ts +18 -0
  1290. package/src/server/fallback-error.ts +88 -104
  1291. package/src/server/flight-injection-state.ts +113 -0
  1292. package/src/server/flight-injector-core.ts +332 -0
  1293. package/src/server/flight-scripts.ts +92 -0
  1294. package/src/server/flight-source-node.ts +434 -0
  1295. package/src/server/flight-source.ts +289 -0
  1296. package/src/server/form-data.ts +191 -20
  1297. package/src/server/form-state-flight.ts +67 -0
  1298. package/src/server/head-response.ts +50 -0
  1299. package/src/server/html-injector-core.ts +320 -0
  1300. package/src/server/html-injectors.ts +241 -285
  1301. package/src/server/index.ts +42 -195
  1302. package/src/server/instrumentation.ts +42 -11
  1303. package/src/server/interception-gates.ts +94 -0
  1304. package/src/server/internal.ts +164 -0
  1305. package/src/server/json-status-response.ts +105 -0
  1306. package/src/server/logger.ts +163 -38
  1307. package/src/server/metadata-collector.ts +175 -0
  1308. package/src/server/metadata-platform.ts +2 -2
  1309. package/src/server/metadata-render.ts +30 -8
  1310. package/src/server/metadata-route-links.ts +200 -0
  1311. package/src/server/metadata-routes.ts +114 -24
  1312. package/src/server/metadata-social.ts +2 -2
  1313. package/src/server/metadata.ts +23 -2
  1314. package/src/server/middleware-runner.ts +32 -5
  1315. package/src/server/node-body-response.ts +236 -0
  1316. package/src/server/node-response.ts +93 -0
  1317. package/src/server/node-stream-transforms.ts +340 -0
  1318. package/src/server/node-streams-platform.ts +23 -0
  1319. package/src/server/param-coercion.ts +223 -0
  1320. package/src/server/pipeline-helpers.ts +554 -0
  1321. package/src/server/pipeline-interception.ts +301 -32
  1322. package/src/server/pipeline-metadata-route.ts +242 -0
  1323. package/src/server/pipeline-metadata.ts +30 -4
  1324. package/src/server/pipeline-outcome.ts +290 -0
  1325. package/src/server/pipeline-phases.ts +443 -0
  1326. package/src/server/pipeline.ts +474 -427
  1327. package/src/server/port-resolution.ts +43 -0
  1328. package/src/server/prebuilt/cache-key.ts +340 -0
  1329. package/src/server/prebuilt/capture-render.ts +122 -0
  1330. package/src/server/prebuilt/capture-routes.ts +104 -0
  1331. package/src/server/prebuilt/capture-state.ts +196 -0
  1332. package/src/server/prebuilt/dev-store.ts +252 -0
  1333. package/src/server/prebuilt/lifetime.ts +151 -0
  1334. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1335. package/src/server/prebuilt/overlay.ts +290 -0
  1336. package/src/server/prebuilt/payload-source.ts +221 -0
  1337. package/src/server/prebuilt/slots.ts +201 -0
  1338. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1339. package/src/server/prebuilt-builder.ts +515 -0
  1340. package/src/server/prebuilt-runtime.ts +830 -0
  1341. package/src/server/primitives.ts +167 -171
  1342. package/src/server/publish-params.ts +42 -0
  1343. package/src/server/react-cache-bridge.ts +124 -0
  1344. package/src/server/react-cache-scope.ts +104 -0
  1345. package/src/server/render-timeout.ts +123 -0
  1346. package/src/server/render-utils.ts +70 -0
  1347. package/src/server/request-context.ts +321 -323
  1348. package/src/server/request-dep.ts +37 -0
  1349. package/src/server/response-cache-policy.ts +45 -0
  1350. package/src/server/response-framing.ts +59 -0
  1351. package/src/server/route-element-builder.ts +539 -355
  1352. package/src/server/route-element-helpers.ts +37 -0
  1353. package/src/server/route-handler.ts +78 -48
  1354. package/src/server/route-matcher.ts +251 -265
  1355. package/src/server/route-methods.ts +37 -0
  1356. package/src/server/route-module-loader.ts +161 -0
  1357. package/src/server/rsc-cache-key-guard.ts +122 -0
  1358. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1359. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1360. package/src/server/rsc-entry/api-handler.ts +30 -93
  1361. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1362. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1363. package/src/server/rsc-entry/helpers.ts +90 -115
  1364. package/src/server/rsc-entry/index.ts +417 -350
  1365. package/src/server/rsc-entry/render-route.ts +248 -0
  1366. package/src/server/rsc-entry/render-signals.ts +108 -0
  1367. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1368. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1369. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1370. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1371. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1372. package/src/server/rsc-error-envelope.ts +18 -0
  1373. package/src/server/rsc-prop-warnings.ts +1 -1
  1374. package/src/server/safe-load.ts +53 -0
  1375. package/src/server/schema-introspection.ts +393 -0
  1376. package/src/server/sensitive-fields.ts +287 -0
  1377. package/src/server/server-only-guard-noop.js +3 -0
  1378. package/src/server/server-timing.ts +1 -1
  1379. package/src/server/signal-identity.ts +130 -0
  1380. package/src/server/sitemap-generator.ts +337 -0
  1381. package/src/server/sitemap-handler.ts +150 -0
  1382. package/src/server/skippable-prefix.ts +172 -0
  1383. package/src/server/slot-interception.ts +168 -0
  1384. package/src/server/slot-resolver.ts +747 -300
  1385. package/src/server/slot-subtree-contain.ts +273 -0
  1386. package/src/server/ssr-bridge-types.ts +217 -0
  1387. package/src/server/ssr-entry.ts +246 -109
  1388. package/src/server/ssr-form-state.ts +58 -0
  1389. package/src/server/ssr-render.ts +253 -113
  1390. package/src/server/ssr-wrappers.tsx +152 -0
  1391. package/src/server/state-tree-diff.ts +85 -30
  1392. package/src/server/static-generator.ts +680 -0
  1393. package/src/server/static-not-found.ts +134 -0
  1394. package/src/server/status-code-resolver.ts +107 -148
  1395. package/src/server/stream-utils.ts +398 -0
  1396. package/src/server/traced-access.ts +50 -0
  1397. package/src/server/tracing.ts +274 -128
  1398. package/src/server/tree-match.ts +494 -0
  1399. package/src/server/types.ts +97 -11
  1400. package/src/server/utils/element-type.ts +88 -0
  1401. package/src/server/utils/escape-html.ts +20 -0
  1402. package/src/server/version-skew.ts +104 -0
  1403. package/src/server/waituntil-bridge.ts +1 -1
  1404. package/src/server/workers-cache-bridge.ts +33 -0
  1405. package/src/shared/als-slots.ts +74 -0
  1406. package/src/shared/base-path.ts +80 -0
  1407. package/src/shared/csrf-reject.ts +15 -0
  1408. package/src/shared/dev-span.ts +188 -0
  1409. package/src/shared/error-digest.ts +46 -0
  1410. package/src/shared/flight-base64.ts +23 -0
  1411. package/src/shared/flight-segment.ts +35 -0
  1412. package/src/shared/form-state-flight.ts +59 -0
  1413. package/src/shared/href-validation.ts +159 -0
  1414. package/src/shared/merge-search-params.ts +55 -0
  1415. package/src/shared/param-value.ts +281 -0
  1416. package/src/shared/payload-root.ts +153 -0
  1417. package/src/shared/redirect-type.ts +17 -0
  1418. package/src/shared/rsc-cache-key.ts +269 -0
  1419. package/src/shared/rsc-error-envelope.ts +16 -0
  1420. package/src/shared/rsc-manifest.ts +29 -0
  1421. package/src/shared/rsc-media-type.ts +59 -0
  1422. package/src/shared/rsc-payload-path.ts +52 -0
  1423. package/src/shared/segment-info.ts +67 -0
  1424. package/src/shared/slot-params.ts +109 -0
  1425. package/src/shared/static-platform-files.ts +75 -0
  1426. package/src/shared/status-reason-phrase.ts +61 -0
  1427. package/src/shims/font-google.ts +1 -1
  1428. package/src/shims/font-local.ts +34 -0
  1429. package/src/shims/headers.ts +130 -1
  1430. package/src/shims/navigation-client.ts +36 -32
  1431. package/src/shims/navigation-rsc.ts +47 -0
  1432. package/src/shims/navigation.ts +10 -7
  1433. package/src/utils/state-machine.ts +111 -0
  1434. package/src/utils/write-file-atomic.ts +32 -0
  1435. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1436. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1437. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1438. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1439. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1440. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1441. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1442. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1443. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1444. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1445. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1446. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1447. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1448. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1449. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1450. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1451. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1452. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1453. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1454. package/dist/adapters/cloudflare.js.map +0 -1
  1455. package/dist/cache/index.js.map +0 -1
  1456. package/dist/cache/register-cached-function.d.ts +0 -17
  1457. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1458. package/dist/client/browser-entry.d.ts +0 -21
  1459. package/dist/client/browser-entry.d.ts.map +0 -1
  1460. package/dist/client/error-boundary.js.map +0 -1
  1461. package/dist/client/head.d.ts +0 -16
  1462. package/dist/client/head.d.ts.map +0 -1
  1463. package/dist/client/link-status-provider.d.ts +0 -11
  1464. package/dist/client/link-status-provider.d.ts.map +0 -1
  1465. package/dist/client/segment-merger.d.ts +0 -119
  1466. package/dist/client/segment-merger.d.ts.map +0 -1
  1467. package/dist/client/stale-reload.d.ts +0 -44
  1468. package/dist/client/stale-reload.d.ts.map +0 -1
  1469. package/dist/client/transition-root.d.ts +0 -74
  1470. package/dist/client/transition-root.d.ts.map +0 -1
  1471. package/dist/client/types.d.ts +0 -14
  1472. package/dist/client/types.d.ts.map +0 -1
  1473. package/dist/client/use-navigation-pending.d.ts +0 -26
  1474. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1475. package/dist/client/use-params.d.ts +0 -92
  1476. package/dist/client/use-params.d.ts.map +0 -1
  1477. package/dist/content/index.d.ts +0 -11
  1478. package/dist/content/index.d.ts.map +0 -1
  1479. package/dist/content/index.js +0 -2
  1480. package/dist/plugins/adapter-build.d.ts +0 -18
  1481. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1482. package/dist/plugins/cache-transform.d.ts +0 -36
  1483. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1484. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1485. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1486. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1487. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1488. package/dist/plugins/server-action-exports.d.ts +0 -26
  1489. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1490. package/dist/routing/status-file-lint.d.ts +0 -33
  1491. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1492. package/dist/search-params/analyze.d.ts +0 -54
  1493. package/dist/search-params/analyze.d.ts.map +0 -1
  1494. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1495. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1496. package/dist/search-params/codecs.d.ts +0 -53
  1497. package/dist/search-params/codecs.d.ts.map +0 -1
  1498. package/dist/search-params/create.d.ts +0 -106
  1499. package/dist/search-params/create.d.ts.map +0 -1
  1500. package/dist/search-params/registry.d.ts +0 -20
  1501. package/dist/search-params/registry.d.ts.map +0 -1
  1502. package/dist/server/asset-headers.d.ts +0 -42
  1503. package/dist/server/asset-headers.d.ts.map +0 -1
  1504. package/dist/server/client-module-map.d.ts +0 -47
  1505. package/dist/server/client-module-map.d.ts.map +0 -1
  1506. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1507. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1508. package/dist/server/dev-logger.d.ts.map +0 -1
  1509. package/dist/server/dev-span-processor.d.ts +0 -29
  1510. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1511. package/dist/server/dev-warnings.d.ts +0 -129
  1512. package/dist/server/dev-warnings.d.ts.map +0 -1
  1513. package/dist/server/flush.d.ts +0 -74
  1514. package/dist/server/flush.d.ts.map +0 -1
  1515. package/dist/server/form-flash.d.ts +0 -78
  1516. package/dist/server/form-flash.d.ts.map +0 -1
  1517. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1518. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1519. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1520. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1521. package/dist/server/prerender.d.ts +0 -77
  1522. package/dist/server/prerender.d.ts.map +0 -1
  1523. package/dist/server/tree-builder.d.ts +0 -126
  1524. package/dist/server/tree-builder.d.ts.map +0 -1
  1525. package/dist/utils/directive-parser.d.ts +0 -70
  1526. package/dist/utils/directive-parser.d.ts.map +0 -1
  1527. package/src/cache/register-cached-function.ts +0 -103
  1528. package/src/client/browser-entry.ts +0 -678
  1529. package/src/client/head.ts +0 -61
  1530. package/src/client/link-status-provider.tsx +0 -30
  1531. package/src/client/segment-merger.ts +0 -339
  1532. package/src/client/stale-reload.ts +0 -87
  1533. package/src/client/transition-root.tsx +0 -166
  1534. package/src/client/types.ts +0 -21
  1535. package/src/client/use-navigation-pending.ts +0 -38
  1536. package/src/client/use-params.ts +0 -141
  1537. package/src/content/index.ts +0 -13
  1538. package/src/plugins/adapter-build.ts +0 -118
  1539. package/src/plugins/cache-transform.ts +0 -199
  1540. package/src/plugins/dynamic-transform.ts +0 -161
  1541. package/src/plugins/server-action-exports.ts +0 -220
  1542. package/src/routing/status-file-lint.ts +0 -112
  1543. package/src/search-params/analyze.ts +0 -192
  1544. package/src/search-params/builtin-codecs.ts +0 -228
  1545. package/src/search-params/codecs.ts +0 -153
  1546. package/src/search-params/create.ts +0 -321
  1547. package/src/search-params/registry.ts +0 -31
  1548. package/src/server/asset-headers.ts +0 -81
  1549. package/src/server/client-module-map.ts +0 -58
  1550. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1551. package/src/server/dev-span-processor.ts +0 -78
  1552. package/src/server/dev-warnings.ts +0 -283
  1553. package/src/server/flush.ts +0 -182
  1554. package/src/server/form-flash.ts +0 -89
  1555. package/src/server/manifest-status-resolver.ts +0 -215
  1556. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1557. package/src/server/prerender.ts +0 -139
  1558. package/src/server/tree-builder.ts +0 -382
  1559. package/src/shims/server-only-noop.js +0 -6
  1560. package/src/utils/directive-parser.ts +0 -529
@@ -1,21 +1,28 @@
1
1
  "use client";
2
- import { a as _setCurrentParams, c as cachedSearchParams, i as _setCachedSearch, l as currentParams, n as getSsrData, o as _setGlobalRouter, r as setSsrData, s as cachedSearch, t as clearSsrData, u as globalRouter } from "../_chunks/ssr-data-MjmprTmO.js";
3
- import { n as useQueryStates, t as bindUseQueryStates } from "../_chunks/use-query-states-D5KaffOK.js";
4
- import { t as useCookie } from "../_chunks/use-cookie-DX-l1_5E.js";
5
- import { TimberErrorBoundary } from "./error-boundary.js";
6
- import React, { cloneElement, createContext, createElement, isValidElement, useActionState as useActionState$1, useContext, useMemo, useSyncExternalStore, useTransition } from "react";
2
+ import { n as classifyUrlSegment } from "../_chunks/segment-classify-Ho8jXWeC.js";
3
+ import { c as stripRscCacheKey } from "../_chunks/rsc-cache-key-D0cb0Gmc.js";
4
+ import { a as mergePreservedSearchParams, i as validateNavigationHref, n as isInternalHref, o as resolveSegmentParams } from "../_chunks/href-validation-CEZy1V-k.js";
5
+ import "../_chunks/param-value-DqlGfF57.js";
6
+ import { t as createGlobalContext } from "../_chunks/global-context-CFSSysdJ.js";
7
+ import { i as useNavigationContext, n as usePendingNavigation, o as getRouterOrNull } from "../_chunks/navigation-root-CoGHIMiE.js";
8
+ import { t as getSsrData } from "../_chunks/ssr-data-9hPtcNOr.js";
9
+ import { t as getLinkCodec } from "../_chunks/codec-registry-CPc6bjVl.js";
10
+ import { n as useSegmentContext } from "../_chunks/segment-context-GAyTjjtS.js";
11
+ import { n as useQueryStates } from "../_chunks/use-query-states-pkDV-jSg.js";
12
+ import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useRef, useState } from "react";
13
+ import { flushSync } from "react-dom";
7
14
  import { jsx } from "react/jsx-runtime";
8
- //#region src/client/use-link-status.ts
15
+ // src/client/use-link-status.ts
9
16
  /**
10
17
  * React context provided by <Link>. Holds the pending status
11
18
  * for that specific link's navigation.
12
19
  */
13
- var LinkStatusContext = createContext({ pending: false });
20
+ var LinkStatusContext = createContext({ isPending: false });
14
21
  /**
15
- * Returns `{ pending: true }` while the nearest parent `<Link>` component's
22
+ * Returns `{ isPending: true }` while the nearest parent `<Link>` component's
16
23
  * navigation is in flight. Must be used inside a `<Link>` component's children.
17
24
  *
18
- * Unlike `useNavigationPending()` which is global, this hook is scoped to
25
+ * Unlike `usePendingNavigation()` which is global, this hook is scoped to
19
26
  * the nearest parent `<Link>` — only the link the user clicked shows pending.
20
27
  *
21
28
  * ```tsx
@@ -23,8 +30,8 @@ var LinkStatusContext = createContext({ pending: false });
23
30
  * import { Link, useLinkStatus } from '@timber-js/app/client'
24
31
  *
25
32
  * function Hint() {
26
- * const { pending } = useLinkStatus()
27
- * return <span className={pending ? 'opacity-50' : ''} />
33
+ * const { isPending } = useLinkStatus()
34
+ * return <span className={isPending ? 'opacity-50' : ''} />
28
35
  * }
29
36
  *
30
37
  * export function NavLink({ href, children }) {
@@ -39,248 +46,155 @@ var LinkStatusContext = createContext({ pending: false });
39
46
  function useLinkStatus() {
40
47
  return useContext(LinkStatusContext);
41
48
  }
42
- //#endregion
43
- //#region src/client/navigation-context.ts
49
+ // src/client/location-search.ts
44
50
  /**
45
- * NavigationContext — React context for navigation state.
51
+ * The app-visible search string from the address bar.
46
52
  *
47
- * Holds the current route params and pathname, updated atomically
48
- * with the RSC tree on each navigation. This replaces the previous
49
- * useSyncExternalStore approach for useParams() and usePathname(),
50
- * which suffered from a timing gap: the new tree could commit before
51
- * the external store re-renders fired, causing a frame where both
52
- * old and new active states were visible simultaneously.
53
- *
54
- * By wrapping the RSC payload element in NavigationProvider inside
55
- * renderRoot(), the context value and the element tree are passed to
56
- * reactRoot.render() in the same call — atomic by construction.
57
- * All consumers (useParams, usePathname) see the new values in the
58
- * same render pass as the new tree.
59
- *
60
- * During SSR, no NavigationProvider is mounted. Hooks fall back to
61
- * the ALS-backed getSsrData() for per-request isolation.
62
- *
63
- * IMPORTANT: createContext and useContext are NOT available in the RSC
64
- * environment (React Server Components use a stripped-down React).
65
- * The context is lazily initialized on first access, and all functions
66
- * that depend on these APIs are safe to call from any environment —
67
- * they return null or no-op when the APIs aren't available.
68
- *
69
- * SINGLETON GUARANTEE: All shared mutable state uses globalThis via
70
- * Symbol.for keys. The RSC client bundler can duplicate this module
71
- * across chunks (browser-entry graph + client-reference graph). With
72
- * ESM output, each chunk gets its own module scope — module-level
73
- * variables would create separate singleton instances per chunk.
74
- * globalThis guarantees a single instance regardless of duplication.
75
- *
76
- * This workaround will be removed when Rolldown ships `format: 'app'`
77
- * (module registry format that deduplicates like webpack/Turbopack).
78
- * See design/27-chunking-strategy.md.
79
- *
80
- * See design/19-client-navigation.md §"NavigationContext"
81
- */
82
- /**
83
- * The context is created lazily to avoid calling createContext at module
84
- * level. In the RSC environment, React.createContext doesn't exist —
85
- * calling it at import time would crash the server.
86
- *
87
- * Context instances are stored on globalThis (NOT in module-level
88
- * variables) because the ESM bundler can duplicate this module across
89
- * chunks. Module-level variables would create separate instances per
90
- * chunk — the provider in TransitionRoot (index chunk) would use
91
- * context A while the consumer in LinkStatusProvider (shared chunk)
92
- * reads from context B. globalThis guarantees a single instance.
93
- *
94
- * See design/27-chunking-strategy.md §"Singleton Safety"
53
+ * Mirrors what `appVisibleSearch()` does on the server: strips key-shaped
54
+ * `_rsc` values so the client and server agree on search state regardless
55
+ * of whether the document URL itself carries a payload cache key (a user
56
+ * pasting/sharing an RSC payload URL). Non-key-shaped `_rsc` values — an
57
+ * application legitimately owning that name — survive, using the same
58
+ * `isRscCacheKeyShape` predicate the server uses.
95
59
  */
96
- var NAV_CTX_KEY = Symbol.for("__timber_nav_ctx");
97
- var PENDING_CTX_KEY = Symbol.for("__timber_pending_nav_ctx");
98
- function getOrCreateContext() {
99
- const existing = globalThis[NAV_CTX_KEY];
100
- if (existing !== void 0) return existing;
101
- if (typeof React.createContext === "function") {
102
- const ctx = React.createContext(null);
103
- globalThis[NAV_CTX_KEY] = ctx;
104
- return ctx;
105
- }
60
+ function locationSearch() {
61
+ return stripRscCacheKey(window.location.search);
106
62
  }
63
+ // src/client/link.tsx
64
+ var LINK_PENDING = { isPending: true };
65
+ var LINK_IDLE = { isPending: false };
107
66
  /**
108
- * Read the navigation context. Returns null during SSR (no provider)
109
- * or in the RSC environment (no context available).
110
- * Internal — used by useParams() and usePathname().
67
+ * Read the current URL's search string without requiring a React hook.
68
+ * On the client, reads window.location.search. During SSR, reads the raw
69
+ * query string from the request context (getSsrData) — the same `''` or
70
+ * `?…` shape, preserving repeated keys (`?tag=a&tag=b`) so the
71
+ * server-rendered href matches what the hydrated client rebuilds from the
72
+ * address bar (TIM-1428). Returns empty string if unavailable.
111
73
  */
112
- function useNavigationContext() {
113
- const ctx = getOrCreateContext();
114
- if (!ctx) return null;
115
- if (typeof React.useContext !== "function") return null;
116
- return React.useContext(ctx);
74
+ function getCurrentSearch() {
75
+ if (typeof window !== "undefined") return locationSearch();
76
+ return getSsrData()?.search ?? "";
77
+ }
78
+ /** Native in-page scrolling needs neither an RSC navigation nor a prefetch. */
79
+ function isNativeFragmentLink(anchor) {
80
+ const href = anchor.href;
81
+ const hashIndex = href.indexOf("#");
82
+ return hashIndex !== -1 && href.slice(0, hashIndex) === window.location.href.split("#", 1)[0];
117
83
  }
118
84
  /**
119
- * Wraps children with NavigationContext.Provider.
85
+ * Interpolate dynamic segments in a route pattern with actual values.
86
+ * e.g. interpolateParams("/products/[id]", { id: "123" }) → "/products/123"
120
87
  *
121
- * Used in browser-entry.ts renderRoot to wrap the RSC payload element
122
- * so that navigation state updates atomically with the tree render.
88
+ * Supports:
89
+ * - [param] → single segment
90
+ * - [...param] → catch-all (joined with /)
91
+ * - [[...param]] → optional catch-all (omitted if undefined/empty)
123
92
  */
124
- function NavigationProvider({ value, children }) {
125
- const ctx = getOrCreateContext();
126
- if (!ctx) return children;
127
- return createElement(ctx.Provider, { value }, children);
128
- }
129
93
  /**
130
- * Navigation state communicated between the router and renderRoot.
131
- *
132
- * The router calls setNavigationState() before renderRoot(). The
133
- * renderRoot callback reads via getNavigationState() to create the
134
- * NavigationProvider with the correct params/pathname.
135
- *
136
- * This is NOT used by hooks directly — hooks read from React context.
137
- *
138
- * Stored on globalThis (like the context instances above) because the
139
- * router lives in one chunk while renderRoot lives in another. Module-
140
- * level variables would be separate per chunk.
94
+ * Parse a route pattern's path portion into classified segments.
95
+ * Exported for testing. Uses the shared character-based classifier.
141
96
  */
142
- var NAV_STATE_KEY = Symbol.for("__timber_nav_state");
143
- function _getNavStateStore() {
144
- const g = globalThis;
145
- if (!g[NAV_STATE_KEY]) g[NAV_STATE_KEY] = { current: {
146
- params: {},
147
- pathname: "/"
148
- } };
149
- return g[NAV_STATE_KEY];
150
- }
151
- function setNavigationState(state) {
152
- _getNavStateStore().current = state;
153
- }
154
- function getNavigationState() {
155
- return _getNavStateStore().current;
97
+ function parseSegments(pattern) {
98
+ return pattern.split("/").filter(Boolean).map(classifyUrlSegment);
156
99
  }
157
100
  /**
158
- * Separate context for the in-flight navigation URL. Provided by
159
- * TransitionRoot (urgent useState), consumed by LinkStatusProvider
160
- * and useNavigationPending.
101
+ * Resolve a single classified segment into its string representation.
102
+ * Returns null for optional catch-all with no value (filtered out before join).
161
103
  *
162
- * Uses globalThis via Symbol.for for the same reason as NavigationContext
163
- * above — the bundler may duplicate this module across chunks, and module-
164
- * level variables would create separate context instances.
104
+ * When schema codecs are registered (via virtual:timber-schema), uses
105
+ * codec.serialize() for URL construction instead of plain String().
165
106
  */
166
- function getOrCreatePendingContext() {
167
- const existing = globalThis[PENDING_CTX_KEY];
168
- if (existing !== void 0) return existing;
169
- if (typeof React.createContext === "function") {
170
- const ctx = React.createContext(null);
171
- globalThis[PENDING_CTX_KEY] = ctx;
172
- return ctx;
107
+ function resolveSegment(seg, params, pattern) {
108
+ switch (seg.kind) {
109
+ case "static": return seg.value;
110
+ case "optional-catch-all": {
111
+ const value = params[seg.name];
112
+ if (value === void 0 || Array.isArray(value) && value.length === 0) return null;
113
+ const codec = getLinkCodec(`[[...${seg.name}]]`);
114
+ if (codec) {
115
+ const serialized = codec.serialize(value);
116
+ if (!serialized) return null;
117
+ return serialized.split("/").map(encodeURIComponent).join("/");
118
+ }
119
+ return (Array.isArray(value) ? value : [value]).map(encodeURIComponent).join("/");
120
+ }
121
+ case "catch-all": {
122
+ const value = params[seg.name];
123
+ if (value === void 0) throw new Error(`<Link> missing required catch-all param "${seg.name}" for pattern "${pattern}".`);
124
+ const codec = getLinkCodec(`[...${seg.name}]`);
125
+ if (codec) {
126
+ const serialized = codec.serialize(value);
127
+ if (!serialized) throw new Error(`<Link> catch-all param "${seg.name}" codec returned null for pattern "${pattern}".`);
128
+ return serialized.split("/").map(encodeURIComponent).join("/");
129
+ }
130
+ const segments = Array.isArray(value) ? value : [value];
131
+ if (segments.length === 0) throw new Error(`<Link> catch-all param "${seg.name}" must have at least one segment for pattern "${pattern}".`);
132
+ return segments.map(encodeURIComponent).join("/");
133
+ }
134
+ case "dynamic": {
135
+ const value = params[seg.name];
136
+ if (value === void 0) throw new Error(`<Link> missing required param "${seg.name}" for pattern "${pattern}".`);
137
+ if (Array.isArray(value)) throw new Error(`<Link> param "${seg.name}" expected a string but received an array for pattern "${pattern}".`);
138
+ const codec = getLinkCodec(`[${seg.name}]`);
139
+ const str = codec ? codec.serialize(value) ?? String(value) : String(value);
140
+ const encoded = encodeURIComponent(str);
141
+ const prefix = seg.prefix ?? "";
142
+ const suffix = seg.suffix ?? "";
143
+ return prefix + encoded + suffix;
144
+ }
173
145
  }
174
146
  }
175
147
  /**
176
- * Read the pending navigation URL from context.
177
- * Returns null during SSR (no provider) or in the RSC environment.
178
- */
179
- function usePendingNavigationUrl() {
180
- const ctx = getOrCreatePendingContext();
181
- if (!ctx) return null;
182
- if (typeof React.useContext !== "function") return null;
183
- return React.useContext(ctx);
184
- }
185
- //#endregion
186
- //#region src/client/link-status-provider.tsx
187
- var NOT_PENDING = { pending: false };
188
- var IS_PENDING = { pending: true };
189
- /**
190
- * Client component that reads the pending URL from PendingNavigationContext
191
- * and provides a scoped LinkStatusContext to children. Renders no extra DOM —
192
- * just a context provider around children.
148
+ * Split a URL pattern into the path portion and any trailing ?query/#hash suffix.
149
+ * Uses URL parsing for correctness rather than manual index arithmetic.
193
150
  */
194
- function LinkStatusProvider({ href, children }) {
195
- const status = usePendingNavigationUrl() === href ? IS_PENDING : NOT_PENDING;
196
- return /* @__PURE__ */ jsx(LinkStatusContext.Provider, {
197
- value: status,
198
- children
199
- });
151
+ function splitPatternSuffix(pattern) {
152
+ if (!pattern.includes("?") && !pattern.includes("#")) return [pattern, ""];
153
+ const url = new URL(pattern, "http://x");
154
+ const suffix = url.search + url.hash;
155
+ return [pattern.slice(0, pattern.length - suffix.length), suffix];
200
156
  }
201
- //#endregion
202
- //#region src/client/router-ref.ts
203
- /**
204
- * Set the global router instance. Called once during bootstrap.
205
- */
206
- function setGlobalRouter(router) {
207
- _setGlobalRouter(router);
208
- }
209
- /**
210
- * Get the global router instance. Throws if called before bootstrap.
211
- * Used by client-side hooks (useNavigationPending, etc.)
212
- */
213
- function getRouter() {
214
- if (!globalRouter) throw new Error("[timber] Router not initialized. getRouter() was called before bootstrap().");
215
- return globalRouter;
157
+ function interpolateParams(pattern, params) {
158
+ const [pathPart, suffix] = splitPatternSuffix(pattern);
159
+ return ("/" + parseSegments(pathPart).map((seg) => resolveSegment(seg, params, pattern)).filter((s) => s !== null).join("/") || "/") + suffix;
216
160
  }
217
161
  /**
218
- * Get the global router instance or null if not yet initialized.
219
- * Used by useRouter() methods to avoid silent failures — callers
220
- * can log a meaningful warning instead of silently no-oping.
162
+ * Resolve the final href string from Link props.
163
+ *
164
+ * Handles:
165
+ * - params interpolation into route patterns
166
+ * - searchParams serialization (see the two shapes documented above)
167
+ * - Validation that searchParams and inline query strings are exclusive
221
168
  */
222
- function getRouterOrNull() {
223
- return globalRouter;
224
- }
225
- //#endregion
226
- //#region src/client/link.tsx
227
169
  /**
228
- * Reject dangerous URL schemes that could execute script.
229
- * Security: design/13-security.md § Link scheme injection (test #9)
170
+ * Tolerate a leading '?'. `buildSearchParams()` never emits one, but callers
171
+ * hand-rolling a query string reasonably might, and silently producing
172
+ * `?%3Fa=b` for it would be a worse failure than accepting both.
230
173
  */
231
- var DANGEROUS_SCHEMES = /^\s*(javascript|data|vbscript):/i;
232
- function validateLinkHref(href) {
233
- if (DANGEROUS_SCHEMES.test(href)) throw new Error(`<Link> received a dangerous href: "${href}". javascript:, data:, and vbscript: URLs are not allowed.`);
234
- }
235
- /** Returns true if the href is an internal path (not an external URL) */
236
- function isInternalHref(href) {
237
- if (href.startsWith("/") || href.startsWith("#") || href.startsWith("?")) return true;
238
- if (/^[a-z][a-z0-9+.-]*:/i.test(href)) return false;
239
- return true;
174
+ function stripLeadingQuestionMark(qs) {
175
+ return qs.startsWith("?") ? qs.slice(1) : qs;
240
176
  }
241
177
  /**
242
- * Interpolate dynamic segments in a route pattern with actual values.
243
- * e.g. interpolateParams("/products/[id]", { id: "123" }) → "/products/123"
178
+ * Escape-hatch serialization for a plain object: String()-coerce every
179
+ * value, append arrays as repeated keys, skip null/undefined.
244
180
  *
245
- * Supports:
246
- * - [param] → single segment
247
- * - [...param] → catch-all (joined with /)
248
- * - [[...param]] → optional catch-all (omitted if undefined/empty)
181
+ * Deliberately codec-free and alias-free — see the shape docs above.
249
182
  */
250
- function interpolateParams(pattern, params) {
251
- return pattern.replace(/\[\[\.\.\.(\w+)\]\]|\[\.\.\.(\w+)\]|\[(\w+)\]/g, (_match, optionalCatchAll, catchAll, single) => {
252
- if (optionalCatchAll) {
253
- const value = params[optionalCatchAll];
254
- if (value === void 0 || Array.isArray(value) && value.length === 0) return "";
255
- return (Array.isArray(value) ? value : [value]).map(encodeURIComponent).join("/");
256
- }
257
- if (catchAll) {
258
- const value = params[catchAll];
259
- if (value === void 0) throw new Error(`<Link> missing required catch-all param "${catchAll}" for pattern "${pattern}".`);
260
- const segments = Array.isArray(value) ? value : [value];
261
- if (segments.length === 0) throw new Error(`<Link> catch-all param "${catchAll}" must have at least one segment for pattern "${pattern}".`);
262
- return segments.map(encodeURIComponent).join("/");
263
- }
264
- const value = params[single];
265
- if (value === void 0) throw new Error(`<Link> missing required param "${single}" for pattern "${pattern}".`);
266
- if (Array.isArray(value)) throw new Error(`<Link> param "${single}" expected a string but received an array for pattern "${pattern}".`);
267
- return encodeURIComponent(String(value));
268
- }).replace(/\/+$/, "") || "/";
183
+ function coerceToQueryString(values) {
184
+ const usp = new URLSearchParams();
185
+ for (const [key, val] of Object.entries(values)) {
186
+ if (val === void 0 || val === null) continue;
187
+ if (Array.isArray(val)) for (const item of val) usp.append(key, String(item));
188
+ else usp.set(key, String(val));
189
+ }
190
+ return usp.toString();
269
191
  }
270
- /**
271
- * Resolve the final href string from Link props.
272
- *
273
- * Handles:
274
- * - params interpolation into route patterns
275
- * - searchParams serialization via SearchParamsDefinition
276
- * - Validation that searchParams and inline query strings are exclusive
277
- */
278
192
  function resolveHref(href, params, searchParams) {
279
193
  let resolvedPath = href;
280
194
  if (params) resolvedPath = interpolateParams(href, params);
281
195
  if (searchParams) {
282
196
  if (resolvedPath.includes("?")) throw new Error("<Link> received both a searchParams prop and a query string in href. These are mutually exclusive — use one or the other.");
283
- const qs = searchParams.definition.serialize(searchParams.values);
197
+ const qs = typeof searchParams === "string" ? stripLeadingQuestionMark(searchParams) : coerceToQueryString(searchParams);
284
198
  if (qs) resolvedPath = `${resolvedPath}?${qs}`;
285
199
  }
286
200
  return resolvedPath;
@@ -291,7 +205,7 @@ function resolveHref(href, params, searchParams) {
291
205
  */
292
206
  function buildLinkProps(props) {
293
207
  const resolvedHref = resolveHref(props.href, props.params, props.searchParams);
294
- validateLinkHref(resolvedHref);
208
+ validateNavigationHref(resolvedHref);
295
209
  return { href: resolvedHref };
296
210
  }
297
211
  /**
@@ -323,20 +237,32 @@ function shouldInterceptClick(event, resolvedHref) {
323
237
  * navigation via the router. No global event delegation — each Link owns
324
238
  * its own click handling.
325
239
  *
326
- * Supports typed routes via codegen overloads. At runtime:
327
- * - `params` prop interpolates dynamic segments in the href pattern
240
+ * Supports typed routes via the Routes interface (populated by codegen).
241
+ * At runtime:
242
+ * - `segmentParams` prop interpolates dynamic segments in the href pattern
328
243
  * - `searchParams` prop serializes query parameters via a SearchParamsDefinition
244
+ *
245
+ * Typed via the LinkFunction callable interface. The base call signature
246
+ * forbids segmentParams; per-route signatures are added by codegen via
247
+ * interface merging. See TIM-624.
329
248
  */
330
- function Link({ href, prefetch, scroll, params, searchParams, onNavigate, onClick: userOnClick, onMouseEnter: userOnMouseEnter, children, ...rest }) {
331
- const { href: resolvedHref } = buildLinkProps({
249
+ var Link = function LinkImpl(props) {
250
+ const { href, prefetch, scroll, replace, segmentParams, searchParams, preserveSearchParams, onNavigate, transitionTypes, onClick: userOnClick, onMouseEnter: userOnMouseEnter, children, ...rest } = props;
251
+ const { href: baseHref } = buildLinkProps({
332
252
  href,
333
- params,
253
+ params: segmentParams,
334
254
  searchParams
335
255
  });
336
- const internal = isInternalHref(resolvedHref);
256
+ const [isPending, setIsPending] = useState(false);
257
+ const clickSeq = useRef(0);
258
+ const linkStatus = isPending ? LINK_PENDING : LINK_IDLE;
259
+ const internal = isInternalHref(baseHref);
260
+ const resolvedHref = preserveSearchParams && internal ? mergePreservedSearchParams(baseHref, getCurrentSearch(), preserveSearchParams) : baseHref;
261
+ const resolveEventUrl = () => new URL(preserveSearchParams ? mergePreservedSearchParams(baseHref, getCurrentSearch(), preserveSearchParams) : resolvedHref, window.location.href);
337
262
  const handleClick = internal ? (event) => {
338
263
  userOnClick?.(event);
339
264
  if (!shouldInterceptClick(event, resolvedHref)) return;
265
+ if (isNativeFragmentLink(event.currentTarget)) return;
340
266
  if (onNavigate) {
341
267
  let prevented = false;
342
268
  onNavigate({ preventDefault: () => {
@@ -349,829 +275,47 @@ function Link({ href, prefetch, scroll, params, searchParams, onNavigate, onClic
349
275
  }
350
276
  const router = getRouterOrNull();
351
277
  if (!router) return;
278
+ const resolved = resolveEventUrl();
279
+ if (isNativeFragmentLink(event.currentTarget)) return;
352
280
  event.preventDefault();
353
281
  const shouldScroll = scroll !== false;
354
- router.navigate(resolvedHref, { scroll: shouldScroll });
282
+ const absoluteHref = resolved.pathname + stripRscCacheKey(resolved.search) + resolved.hash;
283
+ const seq = ++clickSeq.current;
284
+ const clear = () => {
285
+ if (clickSeq.current === seq) flushSync(() => setIsPending(false));
286
+ };
287
+ setIsPending(true);
288
+ const navigation = router.navigate(absoluteHref, {
289
+ scroll: shouldScroll,
290
+ replace,
291
+ transitionTypes
292
+ });
293
+ Promise.all([navigation, navigation.committed]).then(clear, (error) => {
294
+ clear();
295
+ throw error;
296
+ });
355
297
  } : userOnClick;
356
298
  const handleMouseEnter = internal && prefetch ? (event) => {
357
299
  userOnMouseEnter?.(event);
358
300
  const router = getRouterOrNull();
359
- if (router) router.prefetch(resolvedHref);
301
+ if (router) {
302
+ if (isNativeFragmentLink(event.currentTarget)) return;
303
+ const resolved = resolveEventUrl();
304
+ router.prefetch(resolved.pathname + stripRscCacheKey(resolved.search));
305
+ }
360
306
  } : userOnMouseEnter;
361
307
  return /* @__PURE__ */ jsx("a", {
362
308
  ...rest,
363
309
  href: resolvedHref,
364
310
  onClick: handleClick,
365
311
  onMouseEnter: handleMouseEnter,
366
- children: /* @__PURE__ */ jsx(LinkStatusProvider, {
367
- href: resolvedHref,
312
+ children: /* @__PURE__ */ jsx(LinkStatusContext.Provider, {
313
+ value: linkStatus,
368
314
  children
369
315
  })
370
316
  });
371
- }
372
- //#endregion
373
- //#region src/client/segment-cache.ts
374
- /**
375
- * Maintains the client-side segment tree representing currently mounted
376
- * layouts and pages. Used for navigation reconciliation — the router diffs
377
- * new routes against this tree to determine which segments to re-fetch.
378
- */
379
- var SegmentCache = class {
380
- root;
381
- get(segment) {
382
- if (segment === "/" || segment === this.root?.segment) return this.root;
383
- }
384
- set(segment, node) {
385
- if (segment === "/" || !this.root) this.root = node;
386
- }
387
- clear() {
388
- this.root = void 0;
389
- }
390
- /**
391
- * Serialize the mounted segment tree for the X-Timber-State-Tree header.
392
- * Only includes sync segments — async segments are excluded because the
393
- * server must always re-render them (they may depend on request context).
394
- *
395
- * When mergeableFilter is provided, only segments whose paths are in the
396
- * set are included. This ensures the server only skips segments that the
397
- * client can actually merge (i.e., segments whose cached element tree
398
- * contains an inner SegmentProvider the merger can splice into).
399
- *
400
- * This is a performance optimization only, NOT a security boundary.
401
- * The server always runs all access.ts files regardless of the state tree.
402
- */
403
- serializeStateTree(mergeableFilter) {
404
- const segments = [];
405
- if (this.root) collectSyncSegments(this.root, segments, mergeableFilter);
406
- return { segments };
407
- }
408
- };
409
- /** Recursively collect sync segment paths from the tree */
410
- function collectSyncSegments(node, out, mergeableFilter) {
411
- if (!node.isAsync && (!mergeableFilter || mergeableFilter.has(node.segment))) out.push(node.segment);
412
- for (const child of node.children.values()) collectSyncSegments(child, out, mergeableFilter);
413
- }
414
- /**
415
- * Build a SegmentNode tree from flat segment metadata.
416
- *
417
- * Takes an ordered list of segment descriptors (root → leaf) from the
418
- * server's X-Timber-Segments header and constructs the hierarchical
419
- * tree structure that SegmentCache expects.
420
- *
421
- * Each segment is nested as a child of the previous one, forming a
422
- * linear chain from root to leaf. The leaf segment (page) is excluded
423
- * from the tree — pages are never cached across navigations.
424
- */
425
- function buildSegmentTree(segments) {
426
- if (segments.length === 0) return void 0;
427
- const layouts = segments.length > 1 ? segments.slice(0, -1) : segments;
428
- let root;
429
- let parent;
430
- for (const info of layouts) {
431
- const node = {
432
- segment: info.path,
433
- payload: null,
434
- isAsync: info.isAsync,
435
- children: /* @__PURE__ */ new Map()
436
- };
437
- if (!root) root = node;
438
- if (parent) parent.children.set(info.path, node);
439
- parent = node;
440
- }
441
- return root;
442
- }
443
- /**
444
- * Short-lived cache for hover-triggered prefetches. Entries expire after
445
- * 30 seconds. When a link is clicked, the prefetched payload is consumed
446
- * (moved to the history stack) and removed from this cache.
447
- *
448
- * timber.js does NOT prefetch on viewport intersection — only explicit
449
- * hover on <Link prefetch> triggers a prefetch.
450
- */
451
- var PrefetchCache = class PrefetchCache {
452
- static TTL_MS = 3e4;
453
- entries = /* @__PURE__ */ new Map();
454
- set(url, result) {
455
- this.entries.set(url, {
456
- result,
457
- expiresAt: Date.now() + PrefetchCache.TTL_MS
458
- });
459
- }
460
- get(url) {
461
- const entry = this.entries.get(url);
462
- if (!entry) return void 0;
463
- if (Date.now() >= entry.expiresAt) {
464
- this.entries.delete(url);
465
- return;
466
- }
467
- return entry.result;
468
- }
469
- /** Get and remove the entry (used when navigation consumes a prefetch) */
470
- consume(url) {
471
- const result = this.get(url);
472
- if (result !== void 0) this.entries.delete(url);
473
- return result;
474
- }
475
- };
476
- //#endregion
477
- //#region src/client/history.ts
478
- /**
479
- * Session-lived history stack keyed by URL. Enables instant back/forward
480
- * navigation without a server roundtrip.
481
- *
482
- * On forward navigation, the new page's payload is pushed onto the stack.
483
- * On popstate, the cached payload is replayed instantly.
484
- *
485
- * Scroll positions are stored in history.state (browser History API),
486
- * not in this stack — see design/19-client-navigation.md §Scroll Restoration.
487
- *
488
- * Entries persist for the session duration (no expiry) and are cleared
489
- * when the tab is closed — matching browser back-button behavior.
490
- */
491
- var HistoryStack = class {
492
- entries = /* @__PURE__ */ new Map();
493
- push(url, entry) {
494
- this.entries.set(url, entry);
495
- }
496
- get(url) {
497
- return this.entries.get(url);
498
- }
499
- has(url) {
500
- return this.entries.has(url);
501
- }
502
317
  };
503
- //#endregion
504
- //#region src/client/use-params.ts
505
- /**
506
- * Set the current route params in the module-level store.
507
- *
508
- * Called by the router on each navigation. This updates the fallback
509
- * snapshot used by tests and by the hook when called outside a React
510
- * component (no NavigationContext available).
511
- *
512
- * On the client, the primary reactivity path is NavigationContext —
513
- * the router calls setNavigationState() then renderRoot() which wraps
514
- * the element in NavigationProvider. setCurrentParams is still called
515
- * for the module-level fallback.
516
- *
517
- * During SSR, params are also available via getSsrData().params
518
- * (ALS-backed).
519
- */
520
- function setCurrentParams(params) {
521
- _setCurrentParams(params);
522
- }
523
- function useParams(_route) {
524
- try {
525
- const navContext = useNavigationContext();
526
- if (navContext !== null) return navContext.params;
527
- } catch {}
528
- return getSsrData()?.params ?? currentParams;
529
- }
530
- //#endregion
531
- //#region src/client/segment-merger.ts
532
- /**
533
- * Segment Merger — client-side tree merging for partial RSC payloads.
534
- *
535
- * When the server skips rendering sync layouts (because the client already
536
- * has them cached), the RSC payload is missing outer segment wrappers.
537
- * This module reconstructs the full element tree by splicing the partial
538
- * payload into cached segment subtrees.
539
- *
540
- * The approach:
541
- * 1. After each full RSC payload render, walk the decoded element tree
542
- * and cache each segment's subtree (identified by SegmentProvider boundaries)
543
- * 2. When a partial payload arrives, wrap it with cached segment elements
544
- * using React.cloneElement to preserve component identity
545
- *
546
- * React.cloneElement preserves the element's `type` — React sees the same
547
- * component at the same tree position and reconciles (preserving state)
548
- * rather than remounting. This is how layout state survives navigations.
549
- *
550
- * Design docs: 19-client-navigation.md §"Navigation Reconciliation"
551
- * Security: access.ts runs on the server regardless of skipping — this
552
- * is a performance optimization only. See 13-security.md.
553
- */
554
- /**
555
- * Cache of React element subtrees per segment path.
556
- * Updated after each navigation with the full decoded RSC element tree.
557
- */
558
- var SegmentElementCache = class {
559
- entries = /* @__PURE__ */ new Map();
560
- get(segmentPath) {
561
- return this.entries.get(segmentPath);
562
- }
563
- set(segmentPath, entry) {
564
- this.entries.set(segmentPath, entry);
565
- }
566
- has(segmentPath) {
567
- return this.entries.has(segmentPath);
568
- }
569
- clear() {
570
- this.entries.clear();
571
- }
572
- get size() {
573
- return this.entries.size;
574
- }
575
- /**
576
- * Get the set of segment paths that are safe for the server to skip.
577
- * Only segments with an inner SegmentProvider (hasMergeableChild) are
578
- * included — the merger can only replace inner SegmentProviders, not
579
- * pages embedded in layout output. Used to filter the state tree.
580
- *
581
- * Returns an empty set if the element cache is empty (no elements
582
- * cached yet). This is the safe default — an empty set means no
583
- * segments pass the filter, so the state tree is empty and the server
584
- * does a full render. The element cache is populated lazily after the
585
- * first SPA navigation (RSC-decoded elements from hydration are
586
- * thenables that can't be walked until React resolves them).
587
- */
588
- getMergeablePaths() {
589
- const paths = /* @__PURE__ */ new Set();
590
- for (const [, entry] of this.entries) if (entry.hasMergeableChild) paths.add(entry.segmentPath);
591
- return paths;
592
- }
593
- };
594
- /**
595
- * Check if a React element is a SegmentProvider by looking for the
596
- * `segments` prop (an array of path segments). This is the only
597
- * component that receives this prop shape.
598
- */
599
- function isSegmentProvider(element) {
600
- if (!isValidElement(element)) return false;
601
- const props = element.props;
602
- return Array.isArray(props.segments);
603
- }
604
- /**
605
- * Extract the segment path from a SegmentProvider element.
606
- *
607
- * Uses the `segmentId` prop if available (set by the server for route groups
608
- * to distinguish siblings that share the same urlPath). Falls back to
609
- * reconstructing from the `segments` array prop.
610
- */
611
- function getSegmentPath(element) {
612
- const props = element.props;
613
- if (props.segmentId) return props.segmentId;
614
- const filtered = props.segments.filter(Boolean);
615
- return filtered.length === 0 ? "/" : "/" + filtered.join("/");
616
- }
617
- /**
618
- * Walk a React element tree and extract all SegmentProvider boundaries.
619
- * Returns an ordered list of segment entries from outermost to innermost.
620
- *
621
- * This only finds SegmentProviders along the main children path — it does
622
- * not descend into parallel routes/slots (those are separate subtrees).
623
- */
624
- function extractSegments(element) {
625
- const segments = [];
626
- walkForSegments(element, segments);
627
- for (let i = 0; i < segments.length; i++) segments[i].hasMergeableChild = i < segments.length - 1;
628
- return segments;
629
- }
630
- function walkForSegments(node, out) {
631
- if (!isValidElement(node)) return;
632
- const el = node;
633
- const props = el.props;
634
- if (isSegmentProvider(node)) {
635
- out.push({
636
- segmentPath: getSegmentPath(el),
637
- element: el,
638
- hasMergeableChild: false
639
- });
640
- walkChildren(props.children, out);
641
- return;
642
- }
643
- walkChildren(props.children, out);
644
- }
645
- function walkChildren(children, out) {
646
- if (children == null) return;
647
- if (Array.isArray(children)) for (const child of children) walkForSegments(child, out);
648
- else walkForSegments(children, out);
649
- }
650
- /**
651
- * Cache all segment subtrees from a fully-rendered RSC element tree.
652
- * Call this after every full RSC payload render (navigate, refresh, hydration).
653
- */
654
- function cacheSegmentElements(element, cache) {
655
- const segments = extractSegments(element);
656
- for (const entry of segments) cache.set(entry.segmentPath, entry);
657
- }
658
- function findSegmentProviderPath(node, targetPath) {
659
- const children = node.props.children;
660
- if (children == null) return null;
661
- if (Array.isArray(children)) for (let i = 0; i < children.length; i++) {
662
- const child = children[i];
663
- if (!isValidElement(child)) continue;
664
- if (isSegmentProvider(child)) {
665
- if (!targetPath || getSegmentPath(child) === targetPath) return [{
666
- element: node,
667
- childIndex: i
668
- }];
669
- }
670
- const deeper = findSegmentProviderPath(child, targetPath);
671
- if (deeper) return [{
672
- element: node,
673
- childIndex: i
674
- }, ...deeper];
675
- }
676
- else if (isValidElement(children)) {
677
- if (isSegmentProvider(children)) {
678
- if (!targetPath || getSegmentPath(children) === targetPath) return [{
679
- element: node,
680
- childIndex: -1
681
- }];
682
- }
683
- const deeper = findSegmentProviderPath(children, targetPath);
684
- if (deeper) return [{
685
- element: node,
686
- childIndex: -1
687
- }, ...deeper];
688
- }
689
- return null;
690
- }
691
- /**
692
- * Replace a nested SegmentProvider within a cached element tree with
693
- * new content. Uses cloneElement along the path to produce a new tree
694
- * with preserved component identity at every level except the replaced node.
695
- *
696
- * @param cachedElement The cached SegmentProvider element for this segment
697
- * @param newInnerContent The new React element to splice in at the inner segment position
698
- * @param innerSegmentPath The path of the inner segment to replace (optional — replaces first found)
699
- * @returns New element tree with the inner segment replaced
700
- */
701
- function replaceInnerSegment(cachedElement, newInnerContent, innerSegmentPath) {
702
- const path = findSegmentProviderPath(cachedElement, innerSegmentPath);
703
- if (!path || path.length === 0) return cachedElement;
704
- let replacement = newInnerContent;
705
- for (let i = path.length - 1; i >= 0; i--) {
706
- const { element, childIndex } = path[i];
707
- if (childIndex === -1) replacement = cloneElement(element, {}, replacement);
708
- else {
709
- const newChildren = [...element.props.children];
710
- newChildren[childIndex] = replacement;
711
- replacement = cloneElement(element, {}, ...newChildren);
712
- }
713
- }
714
- return replacement;
715
- }
716
- /**
717
- * Merge a partial RSC payload with cached segment elements.
718
- *
719
- * When the server skips segments, the partial payload starts from the
720
- * first non-skipped segment. This function wraps it with cached elements
721
- * for the skipped segments, producing a full tree that React can
722
- * reconcile with the mounted tree (preserving layout state).
723
- *
724
- * @param partialPayload The RSC payload element (may be partial)
725
- * @param skippedSegments Ordered list of segment paths that were skipped (outermost first)
726
- * @param cache The segment element cache
727
- * @returns The merged full element tree, or the partial payload if merging isn't possible
728
- */
729
- function mergeSegmentTree(partialPayload, skippedSegments, cache) {
730
- if (!isValidElement(partialPayload)) return partialPayload;
731
- if (skippedSegments.length === 0) return partialPayload;
732
- let result = partialPayload;
733
- for (let i = skippedSegments.length - 1; i >= 0; i--) {
734
- const segmentPath = skippedSegments[i];
735
- const cached = cache.get(segmentPath);
736
- if (!cached) return partialPayload;
737
- result = replaceInnerSegment(cached.element, result);
738
- }
739
- return result;
740
- }
741
- //#endregion
742
- //#region src/client/rsc-fetch.ts
743
- var RSC_CONTENT_TYPE = "text/x-component";
744
- /**
745
- * Generate a short random cache-busting ID (5 chars, a-z0-9).
746
- * Matches the format Next.js uses for _rsc params.
747
- */
748
- function generateCacheBustId() {
749
- const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
750
- let id = "";
751
- for (let i = 0; i < 5; i++) id += chars[Math.random() * 36 | 0];
752
- return id;
753
- }
754
- /**
755
- * Append a `_rsc=<id>` query parameter to the URL.
756
- * Follows Next.js's pattern — prevents CDN/browser from serving cached HTML
757
- * for RSC navigation requests and signals that this is an RSC fetch.
758
- */
759
- function appendRscParam(url) {
760
- return `${url}${url.includes("?") ? "&" : "?"}_rsc=${generateCacheBustId()}`;
761
- }
762
- function buildRscHeaders(stateTree, currentUrl) {
763
- const headers = { Accept: RSC_CONTENT_TYPE };
764
- if (stateTree) headers["X-Timber-State-Tree"] = JSON.stringify(stateTree);
765
- if (currentUrl) headers["X-Timber-URL"] = currentUrl;
766
- return headers;
767
- }
768
- /**
769
- * Extract head elements from the X-Timber-Head response header.
770
- * Returns null if the header is missing or malformed.
771
- */
772
- function extractHeadElements(response) {
773
- const header = response.headers.get("X-Timber-Head");
774
- if (!header) return null;
775
- try {
776
- return JSON.parse(decodeURIComponent(header));
777
- } catch {
778
- return null;
779
- }
780
- }
781
- /**
782
- * Extract segment metadata from the X-Timber-Segments response header.
783
- * Returns null if the header is missing or malformed.
784
- *
785
- * Format: JSON array of {path, isAsync} objects describing the rendered
786
- * segment chain from root to leaf. Used to populate the client-side
787
- * segment cache for state tree diffing on subsequent navigations.
788
- */
789
- function extractSegmentInfo(response) {
790
- const header = response.headers.get("X-Timber-Segments");
791
- if (!header) return null;
792
- try {
793
- return JSON.parse(header);
794
- } catch {
795
- return null;
796
- }
797
- }
798
- /**
799
- * Extract skipped segment paths from the X-Timber-Skipped-Segments header.
800
- * Returns null if the header is missing or malformed.
801
- *
802
- * When the server skips sync layouts the client already has cached,
803
- * it sends this header listing the skipped segment paths (outermost first).
804
- * The client uses this to merge the partial payload with cached segments.
805
- */
806
- function extractSkippedSegments(response) {
807
- const header = response.headers.get("X-Timber-Skipped-Segments");
808
- if (!header) return null;
809
- try {
810
- const parsed = JSON.parse(header);
811
- return Array.isArray(parsed) ? parsed : null;
812
- } catch {
813
- return null;
814
- }
815
- }
816
- /**
817
- * Extract route params from the X-Timber-Params response header.
818
- * Returns null if the header is missing or malformed.
819
- *
820
- * Used to populate useParams() after client-side navigation.
821
- */
822
- function extractParams(response) {
823
- const header = response.headers.get("X-Timber-Params");
824
- if (!header) return null;
825
- try {
826
- return JSON.parse(header);
827
- } catch {
828
- return null;
829
- }
830
- }
831
- /**
832
- * Thrown when an RSC payload response contains X-Timber-Redirect header.
833
- * Caught in navigate() to trigger a soft router navigation to the redirect target.
834
- */
835
- var RedirectError = class extends Error {
836
- redirectUrl;
837
- constructor(url) {
838
- super(`Server redirect to ${url}`);
839
- this.redirectUrl = url;
840
- }
841
- };
842
- /**
843
- * Fetch an RSC payload from the server. If a decodeRsc function is provided,
844
- * the response is decoded into a React element tree via createFromFetch.
845
- * Otherwise, the raw response text is returned (test mode).
846
- *
847
- * Also extracts head elements from the X-Timber-Head response header
848
- * so the client can update document.title and <meta> tags after navigation.
849
- */
850
- async function fetchRscPayload(url, deps, stateTree, currentUrl) {
851
- const rscUrl = appendRscParam(url);
852
- const headers = buildRscHeaders(stateTree, currentUrl);
853
- if (deps.decodeRsc) {
854
- const fetchPromise = deps.fetch(rscUrl, {
855
- headers,
856
- redirect: "manual"
857
- });
858
- let headElements = null;
859
- let segmentInfo = null;
860
- let params = null;
861
- let skippedSegments = null;
862
- const wrappedPromise = fetchPromise.then((response) => {
863
- const redirectLocation = response.headers.get("X-Timber-Redirect") || (response.status >= 300 && response.status < 400 ? response.headers.get("Location") : null);
864
- if (redirectLocation) throw new RedirectError(redirectLocation);
865
- headElements = extractHeadElements(response);
866
- segmentInfo = extractSegmentInfo(response);
867
- params = extractParams(response);
868
- skippedSegments = extractSkippedSegments(response);
869
- return response;
870
- });
871
- await wrappedPromise;
872
- return {
873
- payload: await deps.decodeRsc(wrappedPromise),
874
- headElements,
875
- segmentInfo,
876
- params,
877
- skippedSegments
878
- };
879
- }
880
- const response = await deps.fetch(rscUrl, {
881
- headers,
882
- redirect: "manual"
883
- });
884
- if (response.status >= 300 && response.status < 400) {
885
- const location = response.headers.get("Location");
886
- if (location) throw new RedirectError(location);
887
- }
888
- return {
889
- payload: await response.text(),
890
- headElements: extractHeadElements(response),
891
- segmentInfo: extractSegmentInfo(response),
892
- params: extractParams(response),
893
- skippedSegments: extractSkippedSegments(response)
894
- };
895
- }
896
- //#endregion
897
- //#region src/client/router.ts
898
- /**
899
- * Check if an error is an abort error (connection closed / fetch aborted).
900
- * Browsers throw DOMException with name 'AbortError' when a fetch is aborted.
901
- */
902
- function isAbortError(error) {
903
- if (error instanceof DOMException && error.name === "AbortError") return true;
904
- if (error instanceof Error && error.name === "AbortError") return true;
905
- return false;
906
- }
907
- /**
908
- * Create a router instance. In production, called once at app hydration
909
- * with real browser APIs. In tests, called with mock dependencies.
910
- */
911
- function createRouter(deps) {
912
- const segmentCache = new SegmentCache();
913
- const prefetchCache = new PrefetchCache();
914
- const historyStack = new HistoryStack();
915
- const segmentElementCache = new SegmentElementCache();
916
- let pending = false;
917
- let pendingUrl = null;
918
- const pendingListeners = /* @__PURE__ */ new Set();
919
- function setPending(value, url) {
920
- const newPendingUrl = value && url ? url : null;
921
- if (pending === value && pendingUrl === newPendingUrl) return;
922
- pending = value;
923
- pendingUrl = newPendingUrl;
924
- for (const listener of pendingListeners) listener(value);
925
- }
926
- /** Update the segment cache from server-provided segment metadata. */
927
- function updateSegmentCache(segmentInfo) {
928
- if (!segmentInfo || segmentInfo.length === 0) return;
929
- const tree = buildSegmentTree(segmentInfo);
930
- if (tree) segmentCache.set("/", tree);
931
- }
932
- /** Render a decoded RSC payload into the DOM if a renderer is available. */
933
- function renderPayload(payload) {
934
- if (deps.renderRoot) deps.renderRoot(payload);
935
- }
936
- /**
937
- * Merge a partial RSC payload with cached segment elements if segments
938
- * were skipped, then cache segments from the (merged) payload.
939
- * Returns the merged payload ready for rendering.
940
- */
941
- function mergeAndCachePayload(payload, skippedSegments) {
942
- let merged = payload;
943
- if (skippedSegments && skippedSegments.length > 0) merged = mergeSegmentTree(payload, skippedSegments, segmentElementCache);
944
- cacheSegmentElements(merged, segmentElementCache);
945
- return merged;
946
- }
947
- /**
948
- * Update navigation state (params + pathname) for the next render.
949
- *
950
- * Sets both the module-level fallback (for tests and SSR) and the
951
- * navigation context state (read by renderRoot to wrap the element
952
- * in NavigationProvider). The context update is atomic with the tree
953
- * render — both are passed to reactRoot.render() in the same call.
954
- */
955
- function updateNavigationState(params, url) {
956
- const resolvedParams = params ?? {};
957
- setCurrentParams(resolvedParams);
958
- setNavigationState({
959
- params: resolvedParams,
960
- pathname: url.startsWith("http") ? new URL(url).pathname : url.split("?")[0] || "/"
961
- });
962
- }
963
- /**
964
- * Render a payload via navigateTransition (production) or renderRoot (tests).
965
- * The perform callback should fetch data, update state, and return the payload.
966
- * In production, the entire callback runs inside a React transition with
967
- * useOptimistic for the pending URL. In tests, the payload is rendered directly.
968
- */
969
- async function renderViaTransition(url, perform) {
970
- if (deps.navigateTransition) {
971
- let headElements = null;
972
- await deps.navigateTransition(url, async (wrapPayload) => {
973
- const result = await perform();
974
- headElements = result.headElements;
975
- const merged = mergeAndCachePayload(result.payload, result.skippedSegments);
976
- historyStack.push(url, {
977
- payload: merged,
978
- headElements: result.headElements,
979
- params: result.params
980
- });
981
- return wrapPayload(merged);
982
- });
983
- return headElements;
984
- }
985
- const result = await perform();
986
- const merged = mergeAndCachePayload(result.payload, result.skippedSegments);
987
- historyStack.push(url, {
988
- payload: merged,
989
- headElements: result.headElements,
990
- params: result.params
991
- });
992
- renderPayload(merged);
993
- return result.headElements;
994
- }
995
- /** Apply head elements (title, meta tags) to the DOM if available. */
996
- function applyHead(elements) {
997
- if (elements && deps.applyHead) deps.applyHead(elements);
998
- }
999
- /** Run a callback after the next paint (after React commit). */
1000
- function afterPaint(callback) {
1001
- if (deps.afterPaint) deps.afterPaint(callback);
1002
- else callback();
1003
- }
1004
- /**
1005
- * Core navigation logic shared between the transition and fallback paths.
1006
- * Fetches the RSC payload, updates all state, and returns the result.
1007
- */
1008
- async function performNavigationFetch(url, options) {
1009
- const prefetched = prefetchCache.consume(url);
1010
- let result = prefetched ? {
1011
- payload: prefetched.payload,
1012
- headElements: prefetched.headElements,
1013
- segmentInfo: prefetched.segmentInfo ?? null,
1014
- params: prefetched.params ?? null,
1015
- skippedSegments: prefetched.skippedSegments ?? null
1016
- } : void 0;
1017
- if (result === void 0) {
1018
- const stateTree = segmentCache.serializeStateTree(segmentElementCache.getMergeablePaths());
1019
- const rawCurrentUrl = deps.getCurrentUrl();
1020
- result = await fetchRscPayload(url, deps, stateTree, rawCurrentUrl.startsWith("http") ? new URL(rawCurrentUrl).pathname : new URL(rawCurrentUrl, "http://localhost").pathname);
1021
- }
1022
- if (options.replace) deps.replaceState({
1023
- timber: true,
1024
- scrollY: 0
1025
- }, "", url);
1026
- else deps.pushState({
1027
- timber: true,
1028
- scrollY: 0
1029
- }, "", url);
1030
- updateSegmentCache(result.segmentInfo);
1031
- updateNavigationState(result.params, url);
1032
- return result;
1033
- }
1034
- async function navigate(url, options = {}) {
1035
- const scroll = options.scroll !== false;
1036
- const replace = options.replace === true;
1037
- const currentScrollY = deps.getScrollY();
1038
- deps.replaceState({
1039
- timber: true,
1040
- scrollY: currentScrollY
1041
- }, "", deps.getCurrentUrl());
1042
- setPending(true, url);
1043
- try {
1044
- applyHead(await renderViaTransition(url, () => performNavigationFetch(url, { replace })));
1045
- window.dispatchEvent(new Event("timber:navigation-end"));
1046
- afterPaint(() => {
1047
- if (scroll) deps.scrollTo(0, 0);
1048
- else deps.scrollTo(0, currentScrollY);
1049
- window.dispatchEvent(new Event("timber:scroll-restored"));
1050
- });
1051
- } catch (error) {
1052
- if (error instanceof RedirectError) {
1053
- setPending(false);
1054
- await navigate(error.redirectUrl, { replace: true });
1055
- return;
1056
- }
1057
- if (isAbortError(error)) return;
1058
- throw error;
1059
- } finally {
1060
- setPending(false);
1061
- }
1062
- }
1063
- async function refresh() {
1064
- const currentUrl = deps.getCurrentUrl();
1065
- setPending(true, currentUrl);
1066
- try {
1067
- applyHead(await renderViaTransition(currentUrl, async () => {
1068
- const result = await fetchRscPayload(currentUrl, deps);
1069
- updateSegmentCache(result.segmentInfo);
1070
- updateNavigationState(result.params, currentUrl);
1071
- return result;
1072
- }));
1073
- } finally {
1074
- setPending(false);
1075
- }
1076
- }
1077
- async function handlePopState(url, scrollY = 0) {
1078
- const entry = historyStack.get(url);
1079
- if (entry && entry.payload !== null) {
1080
- updateNavigationState(entry.params, url);
1081
- renderPayload(entry.payload);
1082
- applyHead(entry.headElements);
1083
- afterPaint(() => {
1084
- deps.scrollTo(0, scrollY);
1085
- window.dispatchEvent(new Event("timber:scroll-restored"));
1086
- });
1087
- } else {
1088
- setPending(true, url);
1089
- try {
1090
- applyHead(await renderViaTransition(url, async () => {
1091
- const result = await fetchRscPayload(url, deps, segmentCache.serializeStateTree(segmentElementCache.getMergeablePaths()));
1092
- updateSegmentCache(result.segmentInfo);
1093
- updateNavigationState(result.params, url);
1094
- return result;
1095
- }));
1096
- afterPaint(() => {
1097
- deps.scrollTo(0, scrollY);
1098
- window.dispatchEvent(new Event("timber:scroll-restored"));
1099
- });
1100
- } finally {
1101
- setPending(false);
1102
- }
1103
- }
1104
- }
1105
- /**
1106
- * Prefetch an RSC payload for a URL and store it in the prefetch cache.
1107
- * Called on hover of <Link prefetch> elements.
1108
- */
1109
- function prefetch(url) {
1110
- if (prefetchCache.get(url) !== void 0) return;
1111
- if (historyStack.has(url)) return;
1112
- fetchRscPayload(url, deps, segmentCache.serializeStateTree(segmentElementCache.getMergeablePaths())).then((result) => {
1113
- prefetchCache.set(url, result);
1114
- }, () => {});
1115
- }
1116
- return {
1117
- navigate,
1118
- refresh,
1119
- handlePopState,
1120
- isPending: () => pending,
1121
- getPendingUrl: () => pendingUrl,
1122
- onPendingChange(listener) {
1123
- pendingListeners.add(listener);
1124
- return () => pendingListeners.delete(listener);
1125
- },
1126
- prefetch,
1127
- applyRevalidation(element, headElements) {
1128
- const currentUrl = deps.getCurrentUrl();
1129
- const merged = mergeAndCachePayload(element, null);
1130
- historyStack.push(currentUrl, {
1131
- payload: merged,
1132
- headElements
1133
- });
1134
- renderPayload(merged);
1135
- applyHead(headElements);
1136
- },
1137
- initSegmentCache: (segments) => updateSegmentCache(segments),
1138
- cacheElementTree: (element) => cacheSegmentElements(element, segmentElementCache),
1139
- segmentCache,
1140
- prefetchCache,
1141
- historyStack
1142
- };
1143
- }
1144
- //#endregion
1145
- //#region src/client/use-navigation-pending.ts
1146
- /**
1147
- * Returns true while an RSC navigation is in flight.
1148
- *
1149
- * The pending state is true from the moment the RSC fetch starts until
1150
- * React reconciliation completes. This includes the fetch itself,
1151
- * RSC stream parsing, and React tree reconciliation.
1152
- *
1153
- * It does NOT include Suspense streaming after the shell — only the
1154
- * initial shell reconciliation.
1155
- *
1156
- * ```tsx
1157
- * 'use client'
1158
- * import { useNavigationPending } from '@timber-js/app/client'
1159
- *
1160
- * export function NavBar() {
1161
- * const isPending = useNavigationPending()
1162
- * return (
1163
- * <nav className={isPending ? 'opacity-50' : ''}>
1164
- * <Link href="/dashboard">Dashboard</Link>
1165
- * </nav>
1166
- * )
1167
- * }
1168
- * ```
1169
- */
1170
- function useNavigationPending() {
1171
- return usePendingNavigationUrl() !== null;
1172
- }
1173
- //#endregion
1174
- //#region src/client/use-router.ts
318
+ // src/client/use-router.ts
1175
319
  /**
1176
320
  * useRouter() — client-side hook for programmatic navigation.
1177
321
  *
@@ -1188,13 +332,13 @@ function useNavigationPending() {
1188
332
  * In timber, navigation calls reactRoot.render() which is a root-level
1189
333
  * render — startTransition has no effect on root renders.
1190
334
  *
1191
- * Navigation state (params, pathname) is delivered atomically via
335
+ * Navigation state (pathname, search) is delivered atomically via
1192
336
  * NavigationContext embedded in the element tree passed to
1193
337
  * reactRoot.render(). See design/19-client-navigation.md §"NavigationContext".
1194
338
  *
1195
339
  * For loading UI during navigation, use:
1196
340
  * - useLinkStatus() — per-link pending indicator (inside <Link>)
1197
- * - useNavigationPending() — global navigation pending state
341
+ * - usePendingNavigation() — global navigation pending state
1198
342
  */
1199
343
  /**
1200
344
  * Get a router instance for programmatic navigation.
@@ -1216,14 +360,19 @@ function useNavigationPending() {
1216
360
  function useRouter() {
1217
361
  return {
1218
362
  push(href, options) {
363
+ validateNavigationHref(href);
1219
364
  const router = getRouterOrNull();
1220
365
  if (!router) {
1221
366
  if (process.env.NODE_ENV === "development") console.error("[timber] useRouter().push() called but router is not initialized. This is a bug — please report it.");
1222
367
  return;
1223
368
  }
1224
- router.navigate(href, { scroll: options?.scroll });
369
+ router.navigate(href, {
370
+ scroll: options?.scroll,
371
+ transitionTypes: options?.transitionTypes
372
+ });
1225
373
  },
1226
374
  replace(href, options) {
375
+ validateNavigationHref(href);
1227
376
  const router = getRouterOrNull();
1228
377
  if (!router) {
1229
378
  if (process.env.NODE_ENV === "development") console.error("[timber] useRouter().replace() called but router is not initialized.");
@@ -1231,7 +380,8 @@ function useRouter() {
1231
380
  }
1232
381
  router.navigate(href, {
1233
382
  scroll: options?.scroll,
1234
- replace: true
383
+ replace: true,
384
+ transitionTypes: options?.transitionTypes
1235
385
  });
1236
386
  },
1237
387
  refresh() {
@@ -1255,136 +405,72 @@ function useRouter() {
1255
405
  }
1256
406
  };
1257
407
  }
1258
- //#endregion
1259
- //#region src/client/use-pathname.ts
408
+ // src/client/use-pathname.ts
1260
409
  /**
1261
410
  * usePathname() — client-side hook for reading the current pathname.
1262
411
  *
1263
412
  * Returns the pathname portion of the current URL (e.g. '/dashboard/settings').
1264
413
  * Updates when client-side navigation changes the URL.
1265
414
  *
1266
- * On the client, reads from NavigationContext which is updated atomically
1267
- * with the RSC tree render. This replaces the previous useSyncExternalStore
1268
- * approach which only subscribed to popstate events — meaning usePathname()
1269
- * did NOT re-render on forward navigation (pushState). The context approach
1270
- * fixes this: pathname updates in the same render pass as the new tree.
415
+ * One unconditional read of NavigationContext, on every side (TIM-1425):
1271
416
  *
1272
- * During SSR, reads the request pathname from the SSR ALS context
1273
- * (populated by ssr-entry.ts) instead of window.location.
417
+ * - In the browser, the provider wraps the RSC payload in the router's `renderTree`, so
418
+ * the pathname updates in the same render pass as the new tree.
419
+ * - During SSR, the wrapper chain mounts the same provider with the request's
420
+ * pathname (TIM-1424), so this is the identical code path — no ALS read,
421
+ * no fallback tiers.
422
+ * - In the RSC environment, this module is never evaluated — the shims plugin
423
+ * resolves next/navigation to navigation-rsc.ts, which has a throwing stub
424
+ * (TIM-1420).
425
+ * - Called outside a component entirely, React itself throws its
426
+ * invalid-hook-call error — loud, not guessed-at from window.location.
1274
427
  *
1275
428
  * Compatible with Next.js's `usePathname()` from `next/navigation`.
1276
429
  */
1277
430
  /**
1278
431
  * Read the current URL pathname.
1279
432
  *
1280
- * On the client, reads from NavigationContext (provided by
1281
- * NavigationProvider in renderRoot). During SSR, reads from the
1282
- * ALS-backed SSR data context. Falls back to window.location.pathname
1283
- * when called outside a React component (e.g., in tests).
433
+ * Throws when no NavigationProvider is above the caller (a component rendered
434
+ * outside the timber app — in tests, render inside the timber providers).
1284
435
  */
1285
436
  function usePathname() {
1286
- try {
1287
- const navContext = useNavigationContext();
1288
- if (navContext !== null) return navContext.pathname;
1289
- } catch {}
1290
- const ssrData = getSsrData();
1291
- if (ssrData) return ssrData.pathname ?? "/";
1292
- if (typeof window !== "undefined") return window.location.pathname;
1293
- return "/";
437
+ const nav = useNavigationContext();
438
+ if (nav === null) throw new Error("[timber] usePathname() was called outside the timber app tree (no NavigationProvider found). In tests, render the component inside the timber providers.");
439
+ return nav.pathname;
1294
440
  }
1295
- //#endregion
1296
- //#region src/client/use-search-params.ts
441
+ // src/client/navigation-api.ts
1297
442
  /**
1298
- * useSearchParams() — client-side hook for reading URL search params.
1299
- *
1300
- * Returns a read-only URLSearchParams instance reflecting the current
1301
- * URL's query string. Updates when client-side navigation changes the URL.
1302
- *
1303
- * This is a thin wrapper over window.location.search, provided for
1304
- * Next.js API compatibility (libraries like nuqs import useSearchParams
1305
- * from next/navigation).
1306
- *
1307
- * Unlike Next.js's ReadonlyURLSearchParams, this returns a standard
1308
- * URLSearchParams. Mutation methods (set, delete, append) work on the
1309
- * local copy but do NOT affect the URL — use the router or nuqs for that.
1310
- *
1311
- * During SSR, reads the request search params from the SSR ALS context
1312
- * (populated by ssr-entry.ts) instead of window.location.
1313
- *
1314
- * All mutable state is delegated to client/state.ts for singleton guarantees.
1315
- * See design/18-build-system.md §"Singleton State Registry"
443
+ * Returns true if the Navigation API is available in the current environment.
444
+ * Feature-detected at runtime — no polyfill.
1316
445
  */
1317
- function getSearch() {
1318
- if (typeof window !== "undefined") return window.location.search;
1319
- const data = getSsrData();
1320
- if (!data) return "";
1321
- const str = new URLSearchParams(data.searchParams).toString();
1322
- return str ? `?${str}` : "";
1323
- }
1324
- function getServerSearch() {
1325
- const data = getSsrData();
1326
- if (!data) return "";
1327
- const str = new URLSearchParams(data.searchParams).toString();
1328
- return str ? `?${str}` : "";
1329
- }
1330
- function subscribe(callback) {
1331
- window.addEventListener("popstate", callback);
1332
- return () => window.removeEventListener("popstate", callback);
1333
- }
1334
- function getSearchParams() {
1335
- const search = getSearch();
1336
- if (search !== cachedSearch) {
1337
- const params = new URLSearchParams(search);
1338
- _setCachedSearch(search, params);
1339
- return params;
1340
- }
1341
- return cachedSearchParams;
1342
- }
1343
- function getServerSearchParams() {
1344
- const data = getSsrData();
1345
- return data ? new URLSearchParams(data.searchParams) : new URLSearchParams();
446
+ function hasNavigationApi() {
447
+ return typeof window !== "undefined" && "navigation" in window && window.navigation != null;
1346
448
  }
1347
449
  /**
1348
- * Read the current URL search params.
1349
- *
1350
- * Compatible with Next.js's `useSearchParams()` from `next/navigation`.
450
+ * Get the Navigation API instance. Returns null if unavailable.
1351
451
  */
1352
- function useSearchParams() {
1353
- useSyncExternalStore(subscribe, getSearch, getServerSearch);
1354
- return typeof window !== "undefined" ? getSearchParams() : getServerSearchParams();
452
+ function getNavigationApi() {
453
+ if (!hasNavigationApi()) return null;
454
+ return window.navigation;
1355
455
  }
1356
- //#endregion
1357
- //#region src/client/segment-context.ts
456
+ // src/client/shallow-url.ts
1358
457
  /**
1359
- * Segment Context — provides layout segment position for useSelectedLayoutSegment hooks.
1360
- *
1361
- * Each layout in the segment tree is wrapped with a SegmentProvider that stores
1362
- * the URL segments from root to the current layout level. The hooks read this
1363
- * context to determine which child segments are active below the calling layout.
458
+ * Shallow URL replacement — update the browser URL bar without triggering
459
+ * RSC navigation, TopLoader, or any server round-trip.
1364
460
  *
1365
- * The context value is intentionally minimal: just the segment path array and
1366
- * parallel route keys. No internal cache details are exposed.
1367
- *
1368
- * Design docs: design/19-client-navigation.md, design/14-ecosystem.md
461
+ * Uses the Navigation API's `info: { shallow: true }` when available (Chrome),
462
+ * which the navigate event handler intercepts with a no-op handler. Falls back
463
+ * to raw `history.replaceState` (Safari/Firefox — no navigate event fired).
1369
464
  */
1370
- var SegmentContext = createContext(null);
1371
- /** Read the segment context. Returns null if no provider is above this component. */
1372
- function useSegmentContext() {
1373
- return useContext(SegmentContext);
1374
- }
1375
- /**
1376
- * Wraps each layout to provide segment position context.
1377
- * Injected by rsc-entry.ts during element tree construction.
1378
- */
1379
- function SegmentProvider({ segments, segmentId: _segmentId, parallelRouteKeys, children }) {
1380
- const value = useMemo(() => ({
1381
- segments,
1382
- parallelRouteKeys
1383
- }), [segments.join("/"), parallelRouteKeys.join(",")]);
1384
- return createElement(SegmentContext.Provider, { value }, children);
465
+ function replaceUrl(url) {
466
+ const nav = getNavigationApi();
467
+ if (nav) nav.navigate(url, {
468
+ history: "replace",
469
+ info: { shallow: true }
470
+ });
471
+ else history.replaceState(history.state, "", url);
1385
472
  }
1386
- //#endregion
1387
- //#region src/client/use-selected-layout-segment.ts
473
+ // src/client/use-selected-layout-segment.ts
1388
474
  /**
1389
475
  * useSelectedLayoutSegment / useSelectedLayoutSegments — client-side hooks
1390
476
  * for reading the active segment(s) below the current layout.
@@ -1471,124 +557,213 @@ function useSelectedLayoutSegments(parallelRouteKey) {
1471
557
  const pathname = usePathname();
1472
558
  return getSelectedSegments(context?.segments ?? null, pathname);
1473
559
  }
1474
- //#endregion
1475
- //#region src/client/form.tsx
1476
- /**
1477
- * Client-side form utilities for server actions.
1478
- *
1479
- * Exports a typed `useActionState` that understands the action builder's result shape.
1480
- * Result is typed to:
1481
- * { data: T } | { validationErrors: Record<string, string[]> } | { serverError: { code, data? } } | null
1482
- *
1483
- * The action builder emits a function that satisfies both the direct call signature
1484
- * and React's `(prevState, formData) => Promise<State>` contract.
1485
- *
1486
- * See design/08-forms-and-actions.md §"Client-Side Form Mechanics"
1487
- */
560
+ // src/client/form.tsx
561
+ var EMPTY = Object.freeze({
562
+ field: () => null,
563
+ form: Object.freeze([]),
564
+ server: null,
565
+ hasErrors: false
566
+ });
1488
567
  /**
1489
- * Typed wrapper around React 19's `useActionState` that understands
1490
- * the timber action builder's result shape.
1491
- *
1492
- * @param action - A server action created with createActionClient or a raw 'use server' function.
1493
- * @param initialState - Initial state, typically `null`. Pass `getFormFlash()` for no-JS
1494
- * progressive enhancement — the flash seeds the initial state so the form has a
1495
- * single source of truth for both with-JS and no-JS paths.
1496
- * @param permalink - Optional permalink for progressive enhancement (no-JS fallback URL).
568
+ * Read the errors out of an action result — the state `useActionState`
569
+ * returns. `_root` validation errors are form-level; every other key is a
570
+ * field. Field names are typed from the action's schema input, so a
571
+ * misspelled path is a type error.
1497
572
  *
1498
573
  * @example
1499
574
  * ```tsx
1500
- * 'use client'
1501
- * import { useActionState } from '@timber-js/app/client'
1502
- * import { createTodo } from './actions'
1503
- *
1504
- * export function NewTodoForm({ flash }) {
1505
- * const [result, action, isPending] = useActionState(createTodo, flash)
1506
- * return (
1507
- * <form action={action}>
1508
- * <input name="title" />
1509
- * {result?.validationErrors?.title && <p>{result.validationErrors.title}</p>}
1510
- * <button disabled={isPending}>Add</button>
1511
- * </form>
1512
- * )
1513
- * }
575
+ * const [result, action, isPending] = useActionState(createTodo, null)
576
+ * const errors = readFormErrors(result)
577
+ * errors.field('title') // first message for the field, or null
1514
578
  * ```
1515
579
  */
1516
- function useActionState(action, initialState, permalink) {
1517
- return useActionState$1(action, initialState, permalink);
580
+ function readFormErrors(result) {
581
+ if (!result) return EMPTY;
582
+ const validationErrors = result.validationErrors ?? {};
583
+ const server = result.serverError ?? null;
584
+ const form = validationErrors._root ?? [];
585
+ const hasErrors = server !== null || Object.values(validationErrors).some((messages) => messages?.length);
586
+ if (!hasErrors) return EMPTY;
587
+ return {
588
+ field(name) {
589
+ return validationErrors[name]?.[0] ?? null;
590
+ },
591
+ form,
592
+ server,
593
+ hasErrors
594
+ };
1518
595
  }
596
+ // src/client/use-field-state.ts
1519
597
  /**
1520
- * Hook for calling a server action imperatively (not via a form).
1521
- * Returns [execute, isPending] where execute accepts the input directly.
598
+ * useFieldState — state for a form field that needs JavaScript (a combobox, a
599
+ * chip list, a row list), made to behave like a native uncontrolled input.
1522
600
  *
1523
- * @example
1524
- * ```tsx
1525
- * const [deleteTodo, isPending] = useFormAction(deleteTodoAction)
1526
- * <button onClick={() => deleteTodo({ id: todo.id })} disabled={isPending}>
1527
- * Delete
1528
- * </button>
1529
- * ```
601
+ * React resets a form after its action settles, so a native field with a
602
+ * `defaultValue` lands on whatever default the page now renders: the action's
603
+ * `submittedValues`, or fresh page data after a redirect. State held in
604
+ * `useState` misses that reset and keeps showing the pre-submit edit. This
605
+ * hook shows `defaultValue` until the user edits, and drops the edit when the
606
+ * form resets, so it lands where the native fields do.
607
+ *
608
+ * See design/08-forms-and-actions.md §"The Form Model".
1530
609
  */
1531
- function useFormAction(action) {
1532
- const [isPending, startTransition] = useTransition();
1533
- const execute = (input) => {
1534
- return new Promise((resolve) => {
1535
- startTransition(async () => {
1536
- resolve(await action(input));
1537
- });
1538
- });
1539
- };
1540
- return [execute, isPending];
1541
- }
1542
610
  /**
1543
- * Extract per-field and form-level errors from an ActionResult.
611
+ * State for a field that follows its form's reset.
1544
612
  *
1545
- * Pure function (no internal hooks) — follows React naming convention
1546
- * since it's used in render. Accepts the result from `useActionState`
1547
- * or flash data from `getFormFlash()`.
613
+ * Returns `[value, setValue, ref]`. Attach `ref` to any element inside the
614
+ * `<form>`, or to the `<form>` itself (the hook subscribes to
615
+ * `closest('form')`, which includes the element), and render the value into
616
+ * the form data yourself (usually hidden inputs). With the ref on the form,
617
+ * the hook can live above it and hold the whole draft as one object, for a
618
+ * live preview beside the form. `value` is `defaultValue` until `setValue` is called, and is
619
+ * `defaultValue` again after the form resets, unless the form cancels its
620
+ * `reset` event. An edit dispatches a bubbling `change` event from the `ref`
621
+ * element after it commits, so a native `change` listener on the form sees it
622
+ * as it sees a native input's (React's synthetic `onChange` reports only
623
+ * inputs, selects and textareas). A reset and a new default fire none, as
624
+ * they fire none for a native input.
1548
625
  *
1549
626
  * @example
1550
627
  * ```tsx
1551
- * const [result, action, isPending] = useActionState(createTodo, null)
1552
- * const errors = useFormErrors(result)
1553
- *
1554
- * return (
1555
- * <form action={action}>
1556
- * <input name="title" />
1557
- * {errors.getFieldError('title') && <p>{errors.getFieldError('title')}</p>}
1558
- * {errors.formErrors.map(e => <p key={e}>{e}</p>)}
1559
- * </form>
1560
- * )
628
+ * // draft: the form's defaults, read from result?.submittedValues ?? pageData
629
+ * const [tags, setTags, ref] = useFieldState(draft.tags);
630
+ * <div ref={ref}>
631
+ * {tags.map((tag) => <input key={tag} type="hidden" name="tags" value={tag} />)}
632
+ * <TagPicker value={tags} onChange={setTags} />
633
+ * </div>
1561
634
  * ```
1562
635
  */
1563
- function useFormErrors(result) {
1564
- const empty = {
1565
- fieldErrors: {},
1566
- formErrors: [],
1567
- serverError: null,
1568
- hasErrors: false,
1569
- getFieldError: () => null
1570
- };
1571
- if (!result) return empty;
1572
- const validationErrors = result.validationErrors;
1573
- const serverError = result.serverError;
1574
- if (!validationErrors && !serverError) return empty;
1575
- const fieldErrors = {};
1576
- const formErrors = [];
1577
- if (validationErrors) for (const [key, messages] of Object.entries(validationErrors)) if (key === "_root") formErrors.push(...messages);
1578
- else fieldErrors[key] = messages;
1579
- const hasErrors = Object.keys(fieldErrors).length > 0 || formErrors.length > 0 || serverError != null;
1580
- return {
1581
- fieldErrors,
1582
- formErrors,
1583
- serverError: serverError ?? null,
1584
- hasErrors,
1585
- getFieldError(field) {
1586
- const errs = fieldErrors[field];
1587
- return errs && errs.length > 0 ? errs[0] : null;
1588
- }
1589
- };
1590
- }
1591
- //#endregion
1592
- export { HistoryStack, Link, LinkStatusContext, NavigationProvider, PrefetchCache, SegmentCache, SegmentProvider, TimberErrorBoundary, bindUseQueryStates, buildLinkProps, clearSsrData, createRouter, getNavigationState, getRouter, getSsrData, interpolateParams, resolveHref, setCurrentParams, setGlobalRouter, setNavigationState, setSsrData, useActionState, useCookie, useFormAction, useFormErrors, useLinkStatus, useNavigationPending, useParams, usePathname, useQueryStates, useRouter, useSearchParams, useSegmentContext, useSelectedLayoutSegment, useSelectedLayoutSegments, validateLinkHref };
636
+ function useFieldState(defaultValue) {
637
+ const [edit, setEdit] = useState(null);
638
+ const value = edit ? edit.value : defaultValue;
639
+ const defaultRef = useRef(defaultValue);
640
+ useLayoutEffect(() => {
641
+ defaultRef.current = defaultValue;
642
+ });
643
+ const pendingResets = useRef([]);
644
+ const takeResets = useCallback(() => {
645
+ const over = pendingResets.current.filter((e) => e.eventPhase === Event.NONE);
646
+ if (over.length === 0) return false;
647
+ pendingResets.current = pendingResets.current.filter((e) => !over.includes(e));
648
+ return over.some((e) => !e.defaultPrevented);
649
+ }, []);
650
+ const setValue = useCallback((next) => {
651
+ const wasReset = takeResets();
652
+ setEdit((latest) => {
653
+ const current = wasReset ? null : latest;
654
+ const base = current ? current.value : defaultRef.current;
655
+ const value = next instanceof Function ? next(base) : next;
656
+ return Object.is(value, base) ? current : { value };
657
+ });
658
+ }, [takeResets]);
659
+ const element = useRef(null);
660
+ const ref = useCallback((el) => {
661
+ element.current = el;
662
+ const form = el?.closest("form");
663
+ if (!form) return;
664
+ const onReset = (event) => {
665
+ pendingResets.current.push(event);
666
+ const apply = () => {
667
+ if (takeResets()) setEdit(null);
668
+ };
669
+ queueMicrotask(() => {
670
+ if (event.eventPhase === Event.NONE) apply();
671
+ else setTimeout(apply, 0);
672
+ });
673
+ };
674
+ form.addEventListener("reset", onReset);
675
+ return () => {
676
+ element.current = null;
677
+ pendingResets.current = [];
678
+ form.removeEventListener("reset", onReset);
679
+ };
680
+ }, [takeResets]);
681
+ useEffect(() => {
682
+ if (edit) element.current?.dispatchEvent(new Event("change", { bubbles: true }));
683
+ }, [edit]);
684
+ return [
685
+ value,
686
+ setValue,
687
+ ref
688
+ ];
689
+ }
690
+ // src/client/params-context.ts
691
+ /**
692
+ * Segment params context — the one channel params use to reach the browser.
693
+ *
694
+ * Params ride the RSC payload's root row as a sibling of the tree
695
+ * (`{ tree, params, slotParams }`), rather than in four side channels that
696
+ * raced to seed them: a response header, an inline script, and two build-time
697
+ * manifest fields all previously carried the same record, each with its own
698
+ * `JSON.stringify` (TIM-1294).
699
+ *
700
+ * Riding the payload is what makes them *typed*. `defineSchema` takes any
701
+ * `Codec<T>`, so a coerced param is whatever the codec returned — a `Date`, a
702
+ * `bigint` — and `JSON.stringify` either flattened it to a string or threw
703
+ * mid-response. React Flight carries those values natively, so the client
704
+ * reads the value the server produced instead of a lossy copy of it. See
705
+ * design/41-global-params.md §"Transport".
706
+ *
707
+ * **The client owns the provider.** There is exactly one `ParamsProvider` in
708
+ * the browser's tree, rendered by `PayloadRoot` above the point where a
709
+ * partial navigation splices the new payload into the retained tree. It has to
710
+ * be there and it has to be alone: a provider *inside* the payload lands below
711
+ * the retained region, whose own root is the departing route's provider, so
712
+ * every reader in a skipped layout resolves to the departing record and no
713
+ * amount of wrapping above it helps (TIM-1297).
714
+ *
715
+ * Ordering still holds without a bootstrap contract, for the same reason it
716
+ * did when the provider was in the tree: a provider renders before its own
717
+ * descendants by construction, so `useSegmentParams()` is correct during
718
+ * hydration without anything having to run before `hydrateRoot()`.
719
+ */
720
+ /**
721
+ * SINGLETON GUARANTEE: globalThis + `Symbol.for`, the same pattern as
722
+ * `NavigationContext` and `SegmentUpdateContext`.
723
+ *
724
+ * The RSC client bundler can duplicate a module across chunks, and with ESM
725
+ * output each chunk gets its own module scope — so a bare `createContext` at
726
+ * module level yields one context per chunk. This module is now reached from
727
+ * *both* graphs: `PayloadRoot` is imported by the browser entry, while
728
+ * `useParamsContext()` arrives through the client-reference graph with the
729
+ * app's own components. A duplicate would put the provider on instance A and
730
+ * every reader on instance B, so `useContext` returns `null` and every
731
+ * `useSegmentParams()` call throws the outside-the-timber-app-tree error
732
+ * even though the provider is mounted (the module-snapshot fallback it once
733
+ * silently landed on was deleted in TIM-1425).
734
+ *
735
+ * This module was the one client context without the guard — harmless while
736
+ * the provider travelled inside the payload, in the same graph as its readers,
737
+ * and load-bearing the moment the client started rendering it (TIM-1297).
738
+ *
739
+ * The React APIs are reached through the namespace rather than named imports,
740
+ * for the same reason `segment-update-context.ts` and `navigation-context.ts`
741
+ * do it: React's `react-server` export provides neither `createContext` nor
742
+ * `useContext`, and a *named* ESM import of a missing export fails at module
743
+ * instantiation — before any feature check could run. This module is reachable
744
+ * from every entry a Server Component imports, so the named form crashed
745
+ * those entries outright (codex, PR #992; originally reproduced against
746
+ * `@timber-js/app/segment-params`, an entry point since deleted by TIM-1342 —
747
+ * the hazard is unchanged for the entries that remain).
748
+ *
749
+ * See design/19-client-navigation.md §"Singleton Guarantee via globalThis"
750
+ */
751
+ var ParamsContext = createGlobalContext(Symbol.for("__timber_params_ctx"), null);
752
+ /**
753
+ * Read the params provided by the tree. Returns null only when no provider
754
+ * is above the caller — a component rendered outside a timber route. During
755
+ * SSR the wrapper chain mounts `PayloadRoot` too (TIM-1424), so both sides
756
+ * resolve through this context.
757
+ */
758
+ function useParamsContext() {
759
+ return React.useContext(ParamsContext);
760
+ }
761
+ // src/client/use-segment-params.ts
762
+ function useSegmentParams(segmentPath) {
763
+ const paramsContext = useParamsContext();
764
+ if (paramsContext === null) throw new Error("[timber] useSegmentParams() was called outside the timber app tree (no params provider found). In tests, render the component inside the timber providers.");
765
+ return resolveSegmentParams(paramsContext.params, paramsContext.slotParams, segmentPath);
766
+ }
767
+ export { Link, LinkStatusContext, buildLinkProps, interpolateParams, mergePreservedSearchParams, readFormErrors, replaceUrl, resolveHref, useFieldState, useLinkStatus, usePathname, usePendingNavigation, useQueryStates, useRouter, useSegmentParams, useSelectedLayoutSegment, useSelectedLayoutSegments, validateNavigationHref as validateLinkHref };
1593
768
 
1594
769
  //# sourceMappingURL=index.js.map