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

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 (1470) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BwkmAYXq.js +1243 -0
  5. package/dist/_chunks/actions-BwkmAYXq.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-LA3sBpUS.js +1182 -0
  17. package/dist/_chunks/cache-api-LA3sBpUS.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-DkytOEG2.js +1 -0
  44. package/dist/_chunks/dev-server-DnODXuNM.js +2056 -0
  45. package/dist/_chunks/dev-server-DnODXuNM.js.map +1 -0
  46. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  47. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  48. package/dist/_chunks/error-boundary-xxxLtXt6.js +1057 -0
  49. package/dist/_chunks/error-boundary-xxxLtXt6.js.map +1 -0
  50. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  51. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  52. package/dist/_chunks/flight-source-node-0dE-t3kq.js +519 -0
  53. package/dist/_chunks/flight-source-node-0dE-t3kq.js.map +1 -0
  54. package/dist/_chunks/format-BKclgVbk.js +14 -0
  55. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  56. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  57. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  58. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  59. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  60. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  61. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  62. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  63. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  64. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  65. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  66. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  67. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  68. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  69. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  70. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  71. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  72. package/dist/_chunks/node-response-Dibufw_b.js +187 -0
  73. package/dist/_chunks/node-response-Dibufw_b.js.map +1 -0
  74. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  75. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  76. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  77. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  78. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  79. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  80. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  81. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  82. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  83. package/dist/_chunks/purge-store-Byr8XOjU.js +14 -0
  84. package/dist/_chunks/purge-store-Byr8XOjU.js.map +1 -0
  85. package/dist/_chunks/render-timeout-DOf_BBcO.js +46 -0
  86. package/dist/_chunks/render-timeout-DOf_BBcO.js.map +1 -0
  87. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  88. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  89. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  90. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  91. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  92. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  93. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  94. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  95. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  96. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  97. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  98. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  99. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  100. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  101. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  102. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  103. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  104. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  105. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  106. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  107. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  108. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  109. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  110. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  111. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  112. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  113. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  114. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  115. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  116. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  117. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  118. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  119. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  120. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  121. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  122. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  123. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  124. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  125. package/dist/adapters/build-output-helper.d.ts +72 -0
  126. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  127. package/dist/adapters/canonicalize-module.d.ts +8 -0
  128. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  129. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  130. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.js +74 -0
  132. package/dist/adapters/cloudflare-dev.js.map +1 -0
  133. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  134. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  136. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  137. package/dist/adapters/cloudflare.d.ts +224 -24
  138. package/dist/adapters/cloudflare.d.ts.map +1 -1
  139. package/dist/adapters/cloudflare.js +1 -188
  140. package/dist/adapters/compress-module.d.ts +25 -4
  141. package/dist/adapters/compress-module.d.ts.map +1 -1
  142. package/dist/adapters/fs-identity.d.ts +63 -0
  143. package/dist/adapters/fs-identity.d.ts.map +1 -0
  144. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  145. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  146. package/dist/adapters/nitro-presets.d.ts +31 -0
  147. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-preview.d.ts +65 -0
  149. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  150. package/dist/adapters/nitro.d.ts +69 -38
  151. package/dist/adapters/nitro.d.ts.map +1 -1
  152. package/dist/adapters/nitro.js +793 -341
  153. package/dist/adapters/nitro.js.map +1 -1
  154. package/dist/adapters/shared.d.ts +67 -0
  155. package/dist/adapters/shared.d.ts.map +1 -0
  156. package/dist/adapters/types.d.ts +124 -16
  157. package/dist/adapters/types.d.ts.map +1 -1
  158. package/dist/adapters/types.js +0 -0
  159. package/dist/analyze/chains.d.ts +124 -0
  160. package/dist/analyze/chains.d.ts.map +1 -0
  161. package/dist/analyze/classify.d.ts +153 -0
  162. package/dist/analyze/classify.d.ts.map +1 -0
  163. package/dist/analyze/crawl-entry.d.ts +17 -0
  164. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.js +314 -0
  166. package/dist/analyze/crawl-entry.js.map +1 -0
  167. package/dist/analyze/crawl.d.ts +134 -0
  168. package/dist/analyze/crawl.d.ts.map +1 -0
  169. package/dist/analyze/graph-cache.d.ts +104 -0
  170. package/dist/analyze/graph-cache.d.ts.map +1 -0
  171. package/dist/analyze/graph-command.d.ts +43 -0
  172. package/dist/analyze/graph-command.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.js +472 -0
  174. package/dist/analyze/graph-command.js.map +1 -0
  175. package/dist/analyze/live-graph.d.ts +81 -0
  176. package/dist/analyze/live-graph.d.ts.map +1 -0
  177. package/dist/analyze/poison-rules.d.ts +72 -0
  178. package/dist/analyze/poison-rules.d.ts.map +1 -0
  179. package/dist/analyze/poison-scan.d.ts +48 -0
  180. package/dist/analyze/poison-scan.d.ts.map +1 -0
  181. package/dist/analyze/scan.d.ts +73 -0
  182. package/dist/analyze/scan.d.ts.map +1 -0
  183. package/dist/cache/cache-api.d.ts +48 -0
  184. package/dist/cache/cache-api.d.ts.map +1 -0
  185. package/dist/cache/fast-hash.d.ts +5 -0
  186. package/dist/cache/fast-hash.d.ts.map +1 -1
  187. package/dist/cache/handler-store.d.ts +33 -0
  188. package/dist/cache/handler-store.d.ts.map +1 -0
  189. package/dist/cache/index.d.ts +32 -9
  190. package/dist/cache/index.d.ts.map +1 -1
  191. package/dist/cache/index.js +3 -326
  192. package/dist/cache/invalidation-epoch.d.ts +43 -0
  193. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  194. package/dist/cache/json-lossy-check.d.ts +11 -0
  195. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  196. package/dist/cache/redis-handler.d.ts +141 -9
  197. package/dist/cache/redis-handler.d.ts.map +1 -1
  198. package/dist/cache/singleflight.d.ts +21 -2
  199. package/dist/cache/singleflight.d.ts.map +1 -1
  200. package/dist/cache/sizeof.d.ts +22 -0
  201. package/dist/cache/sizeof.d.ts.map +1 -0
  202. package/dist/cache/stable-stringify.d.ts +9 -0
  203. package/dist/cache/stable-stringify.d.ts.map +1 -1
  204. package/dist/cache/store.d.ts +53 -0
  205. package/dist/cache/store.d.ts.map +1 -0
  206. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  207. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.js +29 -0
  209. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  210. package/dist/cache/stores/memory.d.ts +42 -0
  211. package/dist/cache/stores/memory.d.ts.map +1 -0
  212. package/dist/cache/stores/memory.js +90 -0
  213. package/dist/cache/stores/memory.js.map +1 -0
  214. package/dist/cache/stores/redis.d.ts +69 -0
  215. package/dist/cache/stores/redis.d.ts.map +1 -0
  216. package/dist/cache/stores/redis.js +35 -0
  217. package/dist/cache/stores/redis.js.map +1 -0
  218. package/dist/cache/stores/vercel.d.ts +36 -0
  219. package/dist/cache/stores/vercel.d.ts.map +1 -0
  220. package/dist/cache/stores/vercel.js +33 -0
  221. package/dist/cache/stores/vercel.js.map +1 -0
  222. package/dist/cache/tag-aware-handler.d.ts +52 -0
  223. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  224. package/dist/cache/timber-cache.d.ts +21 -11
  225. package/dist/cache/timber-cache.d.ts.map +1 -1
  226. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  227. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  228. package/dist/cdn/cloudflare-purge.js +30 -0
  229. package/dist/cdn/cloudflare-purge.js.map +1 -0
  230. package/dist/cdn/fastly-purge.d.ts +25 -0
  231. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  232. package/dist/cdn/fastly-purge.js +33 -0
  233. package/dist/cdn/fastly-purge.js.map +1 -0
  234. package/dist/cdn/headers.d.ts +97 -0
  235. package/dist/cdn/headers.d.ts.map +1 -0
  236. package/dist/cdn/index.d.ts +5 -0
  237. package/dist/cdn/index.d.ts.map +1 -0
  238. package/dist/cdn/index.js +94 -0
  239. package/dist/cdn/index.js.map +1 -0
  240. package/dist/cdn/purge-store.d.ts +23 -0
  241. package/dist/cdn/purge-store.d.ts.map +1 -0
  242. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  243. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.js +35 -0
  245. package/dist/cdn/workers-cache-purge.js.map +1 -0
  246. package/dist/cli-check.d.ts +133 -0
  247. package/dist/cli-check.d.ts.map +1 -0
  248. package/dist/cli-context.d.ts +54 -0
  249. package/dist/cli-context.d.ts.map +1 -0
  250. package/dist/cli-schema-sync.d.ts +59 -0
  251. package/dist/cli-schema-sync.d.ts.map +1 -0
  252. package/dist/cli.d.ts +88 -16
  253. package/dist/cli.d.ts.map +1 -1
  254. package/dist/cli.js +225 -63
  255. package/dist/cli.js.map +1 -1
  256. package/dist/client/browser-dev.d.ts +42 -2
  257. package/dist/client/browser-dev.d.ts.map +1 -1
  258. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  259. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  260. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  261. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  262. package/dist/client/browser-entry/form-state.d.ts +22 -0
  263. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  264. package/dist/client/browser-entry/hmr.d.ts +21 -0
  265. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  267. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  268. package/dist/client/browser-entry/index.d.ts +32 -0
  269. package/dist/client/browser-entry/index.d.ts.map +1 -0
  270. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  271. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  272. package/dist/client/browser-entry/router-init.d.ts +41 -0
  273. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  274. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  275. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  276. package/dist/client/browser-entry/scroll.d.ts +28 -0
  277. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  278. package/dist/client/deny-last-resort.d.ts +29 -0
  279. package/dist/client/deny-last-resort.d.ts.map +1 -0
  280. package/dist/client/error-boundary.d.ts +58 -9
  281. package/dist/client/error-boundary.d.ts.map +1 -1
  282. package/dist/client/error-boundary.js +1 -126
  283. package/dist/client/error-reconstituter.d.ts +55 -0
  284. package/dist/client/error-reconstituter.d.ts.map +1 -0
  285. package/dist/client/form.d.ts +38 -99
  286. package/dist/client/form.d.ts.map +1 -1
  287. package/dist/client/global-context.d.ts +15 -0
  288. package/dist/client/global-context.d.ts.map +1 -0
  289. package/dist/client/history.d.ts +50 -9
  290. package/dist/client/history.d.ts.map +1 -1
  291. package/dist/client/index.d.ts +21 -33
  292. package/dist/client/index.d.ts.map +1 -1
  293. package/dist/client/index.js +432 -1227
  294. package/dist/client/index.js.map +1 -1
  295. package/dist/client/internal.d.ts +20 -0
  296. package/dist/client/internal.d.ts.map +1 -0
  297. package/dist/client/internal.js +808 -0
  298. package/dist/client/internal.js.map +1 -0
  299. package/dist/client/link.d.ts +85 -60
  300. package/dist/client/link.d.ts.map +1 -1
  301. package/dist/client/location-search.d.ts +12 -0
  302. package/dist/client/location-search.d.ts.map +1 -0
  303. package/dist/client/navigation-api.d.ts +95 -0
  304. package/dist/client/navigation-api.d.ts.map +1 -0
  305. package/dist/client/navigation-commit.d.ts +111 -0
  306. package/dist/client/navigation-commit.d.ts.map +1 -0
  307. package/dist/client/navigation-context.d.ts +54 -36
  308. package/dist/client/navigation-context.d.ts.map +1 -1
  309. package/dist/client/navigation-root.d.ts +106 -0
  310. package/dist/client/navigation-root.d.ts.map +1 -0
  311. package/dist/client/navigation-transition.d.ts +201 -0
  312. package/dist/client/navigation-transition.d.ts.map +1 -0
  313. package/dist/client/nuqs-adapter.d.ts +1 -1
  314. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  315. package/dist/client/params-context.d.ts +81 -0
  316. package/dist/client/params-context.d.ts.map +1 -0
  317. package/dist/client/react-root.d.ts +51 -0
  318. package/dist/client/react-root.d.ts.map +1 -0
  319. package/dist/client/router-effects.d.ts +199 -0
  320. package/dist/client/router-effects.d.ts.map +1 -0
  321. package/dist/client/router-lifecycle.d.ts +104 -0
  322. package/dist/client/router-lifecycle.d.ts.map +1 -0
  323. package/dist/client/router-pipeline.d.ts +85 -0
  324. package/dist/client/router-pipeline.d.ts.map +1 -0
  325. package/dist/client/router-ref.d.ts +2 -2
  326. package/dist/client/router-ref.d.ts.map +1 -1
  327. package/dist/client/router-skew.d.ts +21 -0
  328. package/dist/client/router-skew.d.ts.map +1 -0
  329. package/dist/client/router-types.d.ts +314 -0
  330. package/dist/client/router-types.d.ts.map +1 -0
  331. package/dist/client/router-url.d.ts +24 -0
  332. package/dist/client/router-url.d.ts.map +1 -0
  333. package/dist/client/router.d.ts +1 -97
  334. package/dist/client/router.d.ts.map +1 -1
  335. package/dist/client/rsc-fetch.d.ts +110 -28
  336. package/dist/client/rsc-fetch.d.ts.map +1 -1
  337. package/dist/client/segment-cache.d.ts +186 -25
  338. package/dist/client/segment-cache.d.ts.map +1 -1
  339. package/dist/client/segment-context.d.ts.map +1 -1
  340. package/dist/client/segment-outlet.d.ts +68 -0
  341. package/dist/client/segment-outlet.d.ts.map +1 -0
  342. package/dist/client/segment-update-context.d.ts +15 -0
  343. package/dist/client/segment-update-context.d.ts.map +1 -0
  344. package/dist/client/shallow-url.d.ts +10 -0
  345. package/dist/client/shallow-url.d.ts.map +1 -0
  346. package/dist/client/slot-content-cache-context.d.ts +35 -0
  347. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  348. package/dist/client/slot-context.d.ts +31 -0
  349. package/dist/client/slot-context.d.ts.map +1 -0
  350. package/dist/client/slot-outlet.d.ts +16 -0
  351. package/dist/client/slot-outlet.d.ts.map +1 -0
  352. package/dist/client/slot-provider.d.ts +25 -0
  353. package/dist/client/slot-provider.d.ts.map +1 -0
  354. package/dist/client/ssr-data.d.ts +26 -50
  355. package/dist/client/ssr-data.d.ts.map +1 -1
  356. package/dist/client/stale-client.d.ts +69 -0
  357. package/dist/client/stale-client.d.ts.map +1 -0
  358. package/dist/client/state.d.ts +21 -13
  359. package/dist/client/state.d.ts.map +1 -1
  360. package/dist/client/status-page-marker.d.ts +25 -0
  361. package/dist/client/status-page-marker.d.ts.map +1 -0
  362. package/dist/client/top-loader.d.ts +7 -6
  363. package/dist/client/top-loader.d.ts.map +1 -1
  364. package/dist/client/unload-guard.d.ts +5 -0
  365. package/dist/client/unload-guard.d.ts.map +1 -1
  366. package/dist/client/use-cookie.d.ts +12 -0
  367. package/dist/client/use-cookie.d.ts.map +1 -1
  368. package/dist/client/use-field-state.d.ts +42 -0
  369. package/dist/client/use-field-state.d.ts.map +1 -0
  370. package/dist/client/use-link-status.d.ts +5 -5
  371. package/dist/client/use-link-status.d.ts.map +1 -1
  372. package/dist/client/use-pathname.d.ts +13 -11
  373. package/dist/client/use-pathname.d.ts.map +1 -1
  374. package/dist/client/use-pending-navigation.d.ts +23 -0
  375. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  376. package/dist/client/use-query-states.d.ts +10 -4
  377. package/dist/client/use-query-states.d.ts.map +1 -1
  378. package/dist/client/use-router.d.ts +15 -8
  379. package/dist/client/use-router.d.ts.map +1 -1
  380. package/dist/client/use-search-params.d.ts +15 -8
  381. package/dist/client/use-search-params.d.ts.map +1 -1
  382. package/dist/client/use-segment-params.d.ts +55 -0
  383. package/dist/client/use-segment-params.d.ts.map +1 -0
  384. package/dist/codec.d.ts +69 -0
  385. package/dist/codec.d.ts.map +1 -0
  386. package/dist/codec.js +76 -0
  387. package/dist/codec.js.map +1 -0
  388. package/dist/config-types.d.ts +321 -0
  389. package/dist/config-types.d.ts.map +1 -0
  390. package/dist/config-validation.d.ts +68 -0
  391. package/dist/config-validation.d.ts.map +1 -0
  392. package/dist/cookies/define-cookie.d.ts +58 -25
  393. package/dist/cookies/define-cookie.d.ts.map +1 -1
  394. package/dist/cookies/index.d.ts +3 -2
  395. package/dist/cookies/index.d.ts.map +1 -1
  396. package/dist/cookies/index.js +256 -36
  397. package/dist/cookies/index.js.map +1 -1
  398. package/dist/cookies/json-cookie.d.ts +64 -0
  399. package/dist/cookies/json-cookie.d.ts.map +1 -0
  400. package/dist/cookies/validation.d.ts +34 -0
  401. package/dist/cookies/validation.d.ts.map +1 -0
  402. package/dist/dev-tools/404-page.d.ts +50 -0
  403. package/dist/dev-tools/404-page.d.ts.map +1 -0
  404. package/dist/dev-tools/browser-logs.d.ts +40 -0
  405. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  406. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  407. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  408. package/dist/dev-tools/error-page.d.ts +32 -0
  409. package/dist/dev-tools/error-page.d.ts.map +1 -0
  410. package/dist/dev-tools/holding-server.d.ts +46 -0
  411. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  412. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  413. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  414. package/dist/dev-tools/index.d.ts +31 -0
  415. package/dist/dev-tools/index.d.ts.map +1 -0
  416. package/dist/dev-tools/instrumentation.d.ts +74 -0
  417. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  418. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  419. package/dist/dev-tools/logger.d.ts.map +1 -0
  420. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +17 -3
  421. package/dist/dev-tools/logs.d.ts.map +1 -0
  422. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  423. package/dist/dev-tools/overlay.d.ts.map +1 -0
  424. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  425. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  426. package/dist/dev-tools/terminal.d.ts +28 -0
  427. package/dist/dev-tools/terminal.d.ts.map +1 -0
  428. package/dist/fonts/ast-walk.d.ts +68 -0
  429. package/dist/fonts/ast-walk.d.ts.map +1 -0
  430. package/dist/fonts/ast.d.ts +112 -8
  431. package/dist/fonts/ast.d.ts.map +1 -1
  432. package/dist/fonts/bundle.d.ts +50 -0
  433. package/dist/fonts/bundle.d.ts.map +1 -0
  434. package/dist/fonts/css.d.ts +1 -1
  435. package/dist/fonts/dev-middleware.d.ts +22 -0
  436. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  437. package/dist/fonts/fallbacks.d.ts +0 -7
  438. package/dist/fonts/fallbacks.d.ts.map +1 -1
  439. package/dist/fonts/google.d.ts +5 -3
  440. package/dist/fonts/google.d.ts.map +1 -1
  441. package/dist/fonts/local.d.ts +5 -5
  442. package/dist/fonts/local.d.ts.map +1 -1
  443. package/dist/fonts/paths.d.ts +43 -0
  444. package/dist/fonts/paths.d.ts.map +1 -0
  445. package/dist/fonts/pipeline.d.ts +177 -0
  446. package/dist/fonts/pipeline.d.ts.map +1 -0
  447. package/dist/fonts/transform.d.ts +82 -0
  448. package/dist/fonts/transform.d.ts.map +1 -0
  449. package/dist/fonts/types.d.ts +47 -1
  450. package/dist/fonts/types.d.ts.map +1 -1
  451. package/dist/fonts/virtual-modules.d.ts +77 -0
  452. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  453. package/dist/index.d.ts +35 -181
  454. package/dist/index.d.ts.map +1 -1
  455. package/dist/index.js +8877 -14232
  456. package/dist/index.js.map +1 -1
  457. package/dist/params/codec-registry.d.ts +26 -0
  458. package/dist/params/codec-registry.d.ts.map +1 -0
  459. package/dist/params/define-schema.d.ts +81 -0
  460. package/dist/params/define-schema.d.ts.map +1 -0
  461. package/dist/params/index.d.ts +5 -0
  462. package/dist/params/index.d.ts.map +1 -0
  463. package/dist/params/index.js +34 -0
  464. package/dist/params/index.js.map +1 -0
  465. package/dist/params/resolve-schema.d.ts +34 -0
  466. package/dist/params/resolve-schema.d.ts.map +1 -0
  467. package/dist/plugin-context.d.ts +262 -0
  468. package/dist/plugin-context.d.ts.map +1 -0
  469. package/dist/plugins/build-manifest.d.ts +7 -3
  470. package/dist/plugins/build-manifest.d.ts.map +1 -1
  471. package/dist/plugins/build-report.d.ts +61 -11
  472. package/dist/plugins/build-report.d.ts.map +1 -1
  473. package/dist/plugins/cache.d.ts +64 -0
  474. package/dist/plugins/cache.d.ts.map +1 -0
  475. package/dist/plugins/callsite-ast.d.ts +117 -0
  476. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  477. package/dist/plugins/callsite-jsx.d.ts +35 -0
  478. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  479. package/dist/plugins/chunks.d.ts +11 -4
  480. package/dist/plugins/chunks.d.ts.map +1 -1
  481. package/dist/plugins/client-chunks.d.ts +40 -0
  482. package/dist/plugins/client-chunks.d.ts.map +1 -0
  483. package/dist/plugins/client-dep-entries.d.ts +80 -0
  484. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  485. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  486. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  487. package/dist/plugins/content.d.ts +1 -1
  488. package/dist/plugins/content.d.ts.map +1 -1
  489. package/dist/plugins/dev-discovery.d.ts +123 -0
  490. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  491. package/dist/plugins/dev-server.d.ts +24 -1
  492. package/dist/plugins/dev-server.d.ts.map +1 -1
  493. package/dist/plugins/encryption-runtime.d.ts +13 -0
  494. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  495. package/dist/plugins/entries.d.ts +35 -4
  496. package/dist/plugins/entries.d.ts.map +1 -1
  497. package/dist/plugins/fonts.d.ts +35 -74
  498. package/dist/plugins/fonts.d.ts.map +1 -1
  499. package/dist/plugins/graph-endpoint.d.ts +112 -0
  500. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  501. package/dist/plugins/mdx.d.ts +18 -5
  502. package/dist/plugins/mdx.d.ts.map +1 -1
  503. package/dist/plugins/post-build.d.ts +110 -0
  504. package/dist/plugins/post-build.d.ts.map +1 -0
  505. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  506. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  507. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  508. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt.d.ts +98 -0
  510. package/dist/plugins/prebuilt.d.ts.map +1 -0
  511. package/dist/plugins/prerender-sugar.d.ts +39 -0
  512. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  513. package/dist/plugins/react-resolve.d.ts +49 -0
  514. package/dist/plugins/react-resolve.d.ts.map +1 -0
  515. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  516. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  517. package/dist/plugins/request-dep/index.d.ts +75 -0
  518. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/origin.d.ts +61 -0
  520. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  521. package/dist/plugins/routing.d.ts +1 -1
  522. package/dist/plugins/routing.d.ts.map +1 -1
  523. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  524. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  525. package/dist/plugins/server-bundle.d.ts +1 -1
  526. package/dist/plugins/server-bundle.d.ts.map +1 -1
  527. package/dist/plugins/shims.d.ts +29 -5
  528. package/dist/plugins/shims.d.ts.map +1 -1
  529. package/dist/plugins/static-build.d.ts +246 -26
  530. package/dist/plugins/static-build.d.ts.map +1 -1
  531. package/dist/routing/codegen-shared.d.ts +26 -0
  532. package/dist/routing/codegen-shared.d.ts.map +1 -0
  533. package/dist/routing/codegen-types.d.ts +61 -0
  534. package/dist/routing/codegen-types.d.ts.map +1 -0
  535. package/dist/routing/codegen-write.d.ts +42 -0
  536. package/dist/routing/codegen-write.d.ts.map +1 -0
  537. package/dist/routing/codegen.d.ts +8 -3
  538. package/dist/routing/codegen.d.ts.map +1 -1
  539. package/dist/routing/collision-probe.d.ts +104 -0
  540. package/dist/routing/collision-probe.d.ts.map +1 -0
  541. package/dist/routing/collision-spaces.d.ts +26 -0
  542. package/dist/routing/collision-spaces.d.ts.map +1 -0
  543. package/dist/routing/convention-lint.d.ts +55 -0
  544. package/dist/routing/convention-lint.d.ts.map +1 -0
  545. package/dist/routing/export-detect.d.ts +91 -0
  546. package/dist/routing/export-detect.d.ts.map +1 -0
  547. package/dist/routing/file-cache.d.ts +8 -0
  548. package/dist/routing/file-cache.d.ts.map +1 -0
  549. package/dist/routing/index.d.ts +13 -7
  550. package/dist/routing/index.d.ts.map +1 -1
  551. package/dist/routing/index.js +5 -2
  552. package/dist/routing/interception-overlap.d.ts +35 -0
  553. package/dist/routing/interception-overlap.d.ts.map +1 -0
  554. package/dist/routing/interception.d.ts +234 -10
  555. package/dist/routing/interception.d.ts.map +1 -1
  556. package/dist/routing/link-codegen.d.ts +105 -0
  557. package/dist/routing/link-codegen.d.ts.map +1 -0
  558. package/dist/routing/manifest-codegen.d.ts +26 -0
  559. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  560. package/dist/routing/scanner.d.ts +14 -10
  561. package/dist/routing/scanner.d.ts.map +1 -1
  562. package/dist/routing/schema-validation.d.ts +35 -0
  563. package/dist/routing/schema-validation.d.ts.map +1 -0
  564. package/dist/routing/segment-classify.d.ts +114 -0
  565. package/dist/routing/segment-classify.d.ts.map +1 -0
  566. package/dist/routing/segment-codegen.d.ts +38 -0
  567. package/dist/routing/segment-codegen.d.ts.map +1 -0
  568. package/dist/routing/segment-keys.d.ts +118 -0
  569. package/dist/routing/segment-keys.d.ts.map +1 -0
  570. package/dist/routing/slot-placement.d.ts +48 -0
  571. package/dist/routing/slot-placement.d.ts.map +1 -0
  572. package/dist/routing/types.d.ts +81 -26
  573. package/dist/routing/types.d.ts.map +1 -1
  574. package/dist/routing/walkers.d.ts +57 -0
  575. package/dist/routing/walkers.d.ts.map +1 -0
  576. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  577. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  578. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  579. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  580. package/dist/rsc-runtime/rsc.d.ts +6 -2
  581. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  582. package/dist/rsc-runtime/ssr.d.ts +8 -0
  583. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  584. package/dist/rsc-runtime/transforms.d.ts +13 -0
  585. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  586. package/dist/schema-bridge.d.ts +145 -0
  587. package/dist/schema-bridge.d.ts.map +1 -0
  588. package/dist/search-params/define.d.ts +262 -0
  589. package/dist/search-params/define.d.ts.map +1 -0
  590. package/dist/search-params/index.d.ts +3 -7
  591. package/dist/search-params/index.d.ts.map +1 -1
  592. package/dist/search-params/index.js +179 -360
  593. package/dist/search-params/index.js.map +1 -1
  594. package/dist/search-params/parse-total.d.ts +81 -0
  595. package/dist/search-params/parse-total.d.ts.map +1 -0
  596. package/dist/search-params/serialize-equal.d.ts +9 -0
  597. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  598. package/dist/search-params/wrappers.d.ts +76 -0
  599. package/dist/search-params/wrappers.d.ts.map +1 -0
  600. package/dist/server/access-gate.d.ts +98 -10
  601. package/dist/server/access-gate.d.ts.map +1 -1
  602. package/dist/server/action-client.d.ts +20 -133
  603. package/dist/server/action-client.d.ts.map +1 -1
  604. package/dist/server/action-encryption.d.ts +76 -0
  605. package/dist/server/action-encryption.d.ts.map +1 -0
  606. package/dist/server/action-handler.d.ts +58 -11
  607. package/dist/server/action-handler.d.ts.map +1 -1
  608. package/dist/server/action-schema.d.ts +126 -0
  609. package/dist/server/action-schema.d.ts.map +1 -0
  610. package/dist/server/action-types.d.ts +108 -0
  611. package/dist/server/action-types.d.ts.map +1 -0
  612. package/dist/server/actions.d.ts +78 -40
  613. package/dist/server/actions.d.ts.map +1 -1
  614. package/dist/server/als-registry.d.ts +189 -17
  615. package/dist/server/als-registry.d.ts.map +1 -1
  616. package/dist/server/body-limits.d.ts.map +1 -1
  617. package/dist/server/build-manifest.d.ts +25 -30
  618. package/dist/server/build-manifest.d.ts.map +1 -1
  619. package/dist/server/canonicalize.d.ts +32 -0
  620. package/dist/server/canonicalize.d.ts.map +1 -1
  621. package/dist/server/chain-url-parts.d.ts +82 -0
  622. package/dist/server/chain-url-parts.d.ts.map +1 -0
  623. package/dist/server/children-interception.d.ts +49 -0
  624. package/dist/server/children-interception.d.ts.map +1 -0
  625. package/dist/server/client-error-message.d.ts +12 -0
  626. package/dist/server/client-error-message.d.ts.map +1 -0
  627. package/dist/server/coalesce-tick.d.ts +40 -0
  628. package/dist/server/coalesce-tick.d.ts.map +1 -0
  629. package/dist/server/compress.d.ts +2 -0
  630. package/dist/server/compress.d.ts.map +1 -1
  631. package/dist/server/cookie-context.d.ts +149 -0
  632. package/dist/server/cookie-context.d.ts.map +1 -0
  633. package/dist/server/cookie-parsing.d.ts +65 -0
  634. package/dist/server/cookie-parsing.d.ts.map +1 -0
  635. package/dist/server/csp-nonce.d.ts +36 -0
  636. package/dist/server/csp-nonce.d.ts.map +1 -0
  637. package/dist/server/csrf.d.ts +58 -15
  638. package/dist/server/csrf.d.ts.map +1 -1
  639. package/dist/server/debug.d.ts +0 -1
  640. package/dist/server/debug.d.ts.map +1 -1
  641. package/dist/server/default-logger.d.ts +23 -0
  642. package/dist/server/default-logger.d.ts.map +1 -0
  643. package/dist/server/default-status-page.d.ts +45 -0
  644. package/dist/server/default-status-page.d.ts.map +1 -0
  645. package/dist/server/deny-boundary.d.ts +257 -0
  646. package/dist/server/deny-boundary.d.ts.map +1 -0
  647. package/dist/server/deny-renderer.d.ts +22 -15
  648. package/dist/server/deny-renderer.d.ts.map +1 -1
  649. package/dist/server/early-hints-sender.d.ts.map +1 -1
  650. package/dist/server/early-hints.d.ts +14 -12
  651. package/dist/server/early-hints.d.ts.map +1 -1
  652. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  653. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  654. package/dist/server/error-response-headers.d.ts +3 -0
  655. package/dist/server/error-response-headers.d.ts.map +1 -0
  656. package/dist/server/fallback-error.d.ts +19 -7
  657. package/dist/server/fallback-error.d.ts.map +1 -1
  658. package/dist/server/flight-injection-state.d.ts +66 -0
  659. package/dist/server/flight-injection-state.d.ts.map +1 -0
  660. package/dist/server/flight-injector-core.d.ts +125 -0
  661. package/dist/server/flight-injector-core.d.ts.map +1 -0
  662. package/dist/server/flight-scripts.d.ts +63 -0
  663. package/dist/server/flight-scripts.d.ts.map +1 -0
  664. package/dist/server/flight-source-node.d.ts +105 -0
  665. package/dist/server/flight-source-node.d.ts.map +1 -0
  666. package/dist/server/flight-source.d.ts +136 -0
  667. package/dist/server/flight-source.d.ts.map +1 -0
  668. package/dist/server/form-data.d.ts +59 -2
  669. package/dist/server/form-data.d.ts.map +1 -1
  670. package/dist/server/form-state-flight.d.ts +32 -0
  671. package/dist/server/form-state-flight.d.ts.map +1 -0
  672. package/dist/server/head-response.d.ts +35 -0
  673. package/dist/server/head-response.d.ts.map +1 -0
  674. package/dist/server/html-injector-core.d.ts +169 -0
  675. package/dist/server/html-injector-core.d.ts.map +1 -0
  676. package/dist/server/html-injectors.d.ts +77 -47
  677. package/dist/server/html-injectors.d.ts.map +1 -1
  678. package/dist/server/index.d.ts +16 -54
  679. package/dist/server/index.d.ts.map +1 -1
  680. package/dist/server/index.js +638 -3021
  681. package/dist/server/index.js.map +1 -1
  682. package/dist/server/instrumentation.d.ts +11 -4
  683. package/dist/server/instrumentation.d.ts.map +1 -1
  684. package/dist/server/internal.d.ts +47 -0
  685. package/dist/server/internal.d.ts.map +1 -0
  686. package/dist/server/internal.js +4649 -0
  687. package/dist/server/internal.js.map +1 -0
  688. package/dist/server/json-status-response.d.ts +34 -0
  689. package/dist/server/json-status-response.d.ts.map +1 -0
  690. package/dist/server/logger.d.ts +79 -7
  691. package/dist/server/logger.d.ts.map +1 -1
  692. package/dist/server/metadata-collector.d.ts +75 -0
  693. package/dist/server/metadata-collector.d.ts.map +1 -0
  694. package/dist/server/metadata-platform.d.ts +2 -2
  695. package/dist/server/metadata-render.d.ts +2 -2
  696. package/dist/server/metadata-render.d.ts.map +1 -1
  697. package/dist/server/metadata-route-links.d.ts +70 -0
  698. package/dist/server/metadata-route-links.d.ts.map +1 -0
  699. package/dist/server/metadata-routes.d.ts +47 -11
  700. package/dist/server/metadata-routes.d.ts.map +1 -1
  701. package/dist/server/metadata-social.d.ts +2 -2
  702. package/dist/server/metadata.d.ts +10 -2
  703. package/dist/server/metadata.d.ts.map +1 -1
  704. package/dist/server/middleware-runner.d.ts +20 -5
  705. package/dist/server/middleware-runner.d.ts.map +1 -1
  706. package/dist/server/node-body-response.d.ts +55 -0
  707. package/dist/server/node-body-response.d.ts.map +1 -0
  708. package/dist/server/node-response.d.ts +62 -0
  709. package/dist/server/node-response.d.ts.map +1 -0
  710. package/dist/server/node-stream-transforms.d.ts +108 -0
  711. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  712. package/dist/server/node-streams-platform.d.ts +21 -0
  713. package/dist/server/node-streams-platform.d.ts.map +1 -0
  714. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  715. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  716. package/dist/server/param-coercion.d.ts +83 -0
  717. package/dist/server/param-coercion.d.ts.map +1 -0
  718. package/dist/server/pipeline-helpers.d.ts +224 -0
  719. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  720. package/dist/server/pipeline-interception.d.ts +70 -9
  721. package/dist/server/pipeline-interception.d.ts.map +1 -1
  722. package/dist/server/pipeline-metadata.d.ts +16 -1
  723. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  724. package/dist/server/pipeline-outcome.d.ts +59 -0
  725. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  726. package/dist/server/pipeline-phases.d.ts +70 -0
  727. package/dist/server/pipeline-phases.d.ts.map +1 -0
  728. package/dist/server/pipeline.d.ts +161 -23
  729. package/dist/server/pipeline.d.ts.map +1 -1
  730. package/dist/server/port-resolution.d.ts +22 -0
  731. package/dist/server/port-resolution.d.ts.map +1 -0
  732. package/dist/server/prebuilt/cache-key.d.ts +63 -0
  733. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  734. package/dist/server/prebuilt/capture-render.d.ts +25 -0
  735. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  736. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  737. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  738. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  739. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  740. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  741. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  742. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  743. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  744. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  745. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  746. package/dist/server/prebuilt/overlay.d.ts +100 -0
  747. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  748. package/dist/server/prebuilt/payload-source.d.ts +79 -0
  749. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  750. package/dist/server/prebuilt/slots.d.ts +106 -0
  751. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  752. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  753. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  754. package/dist/server/prebuilt-builder.d.ts +121 -0
  755. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  756. package/dist/server/prebuilt-runtime.d.ts +110 -0
  757. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  758. package/dist/server/primitives.d.ts +101 -90
  759. package/dist/server/primitives.d.ts.map +1 -1
  760. package/dist/server/publish-params.d.ts +33 -0
  761. package/dist/server/publish-params.d.ts.map +1 -0
  762. package/dist/server/react-cache-bridge.d.ts +59 -0
  763. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  764. package/dist/server/react-cache-scope.d.ts +49 -0
  765. package/dist/server/react-cache-scope.d.ts.map +1 -0
  766. package/dist/server/render-timeout.d.ts +66 -0
  767. package/dist/server/render-timeout.d.ts.map +1 -0
  768. package/dist/server/render-utils.d.ts +35 -0
  769. package/dist/server/render-utils.d.ts.map +1 -0
  770. package/dist/server/request-context.d.ts +153 -103
  771. package/dist/server/request-context.d.ts.map +1 -1
  772. package/dist/server/request-dep.d.ts +15 -0
  773. package/dist/server/request-dep.d.ts.map +1 -0
  774. package/dist/server/response-cache-policy.d.ts +3 -0
  775. package/dist/server/response-cache-policy.d.ts.map +1 -0
  776. package/dist/server/route-element-builder.d.ts +57 -30
  777. package/dist/server/route-element-builder.d.ts.map +1 -1
  778. package/dist/server/route-element-helpers.d.ts +12 -0
  779. package/dist/server/route-element-helpers.d.ts.map +1 -0
  780. package/dist/server/route-handler.d.ts +1 -1
  781. package/dist/server/route-handler.d.ts.map +1 -1
  782. package/dist/server/route-matcher.d.ts +62 -38
  783. package/dist/server/route-matcher.d.ts.map +1 -1
  784. package/dist/server/route-module-loader.d.ts +37 -0
  785. package/dist/server/route-module-loader.d.ts.map +1 -0
  786. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  787. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  788. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  789. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  790. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  791. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  792. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  793. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  794. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  795. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  796. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  797. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  798. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  799. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  800. package/dist/server/rsc-entry/index.d.ts +30 -6
  801. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  802. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  803. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  804. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  805. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  807. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  808. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  809. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  811. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  813. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  814. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  815. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  816. package/dist/server/rsc-error-envelope.d.ts +11 -0
  817. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  818. package/dist/server/safe-load.d.ts +39 -0
  819. package/dist/server/safe-load.d.ts.map +1 -0
  820. package/dist/server/schema-introspection.d.ts +68 -0
  821. package/dist/server/schema-introspection.d.ts.map +1 -0
  822. package/dist/server/sensitive-fields.d.ts +88 -0
  823. package/dist/server/sensitive-fields.d.ts.map +1 -0
  824. package/dist/server/signal-identity.d.ts +43 -0
  825. package/dist/server/signal-identity.d.ts.map +1 -0
  826. package/dist/server/sitemap-generator.d.ts +130 -0
  827. package/dist/server/sitemap-generator.d.ts.map +1 -0
  828. package/dist/server/sitemap-handler.d.ts +22 -0
  829. package/dist/server/sitemap-handler.d.ts.map +1 -0
  830. package/dist/server/skippable-prefix.d.ts +29 -0
  831. package/dist/server/skippable-prefix.d.ts.map +1 -0
  832. package/dist/server/slot-interception.d.ts +80 -0
  833. package/dist/server/slot-interception.d.ts.map +1 -0
  834. package/dist/server/slot-resolver.d.ts +138 -7
  835. package/dist/server/slot-resolver.d.ts.map +1 -1
  836. package/dist/server/slot-subtree-contain.d.ts +54 -0
  837. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  838. package/dist/server/ssr-bridge-types.d.ts +213 -0
  839. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  840. package/dist/server/ssr-entry.d.ts +15 -51
  841. package/dist/server/ssr-entry.d.ts.map +1 -1
  842. package/dist/server/ssr-form-state.d.ts +30 -0
  843. package/dist/server/ssr-form-state.d.ts.map +1 -0
  844. package/dist/server/ssr-render.d.ts +59 -32
  845. package/dist/server/ssr-render.d.ts.map +1 -1
  846. package/dist/server/ssr-wrappers.d.ts +93 -0
  847. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  848. package/dist/server/state-tree-diff.d.ts +44 -9
  849. package/dist/server/state-tree-diff.d.ts.map +1 -1
  850. package/dist/server/static-generator.d.ts +112 -0
  851. package/dist/server/static-generator.d.ts.map +1 -0
  852. package/dist/server/static-not-found.d.ts +52 -0
  853. package/dist/server/static-not-found.d.ts.map +1 -0
  854. package/dist/server/status-code-resolver.d.ts +26 -15
  855. package/dist/server/status-code-resolver.d.ts.map +1 -1
  856. package/dist/server/stream-utils.d.ts +93 -0
  857. package/dist/server/stream-utils.d.ts.map +1 -0
  858. package/dist/server/tracing.d.ts +57 -26
  859. package/dist/server/tracing.d.ts.map +1 -1
  860. package/dist/server/tree-match.d.ts +59 -0
  861. package/dist/server/tree-match.d.ts.map +1 -0
  862. package/dist/server/types.d.ts +89 -8
  863. package/dist/server/types.d.ts.map +1 -1
  864. package/dist/server/utils/element-type.d.ts +50 -0
  865. package/dist/server/utils/element-type.d.ts.map +1 -0
  866. package/dist/server/utils/escape-html.d.ts +14 -0
  867. package/dist/server/utils/escape-html.d.ts.map +1 -0
  868. package/dist/server/version-skew.d.ts +61 -0
  869. package/dist/server/version-skew.d.ts.map +1 -0
  870. package/dist/server/workers-cache-bridge.d.ts +26 -0
  871. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  872. package/dist/shared/als-slots.d.ts +42 -0
  873. package/dist/shared/als-slots.d.ts.map +1 -0
  874. package/dist/shared/base-path.d.ts +56 -0
  875. package/dist/shared/base-path.d.ts.map +1 -0
  876. package/dist/shared/csrf-reject.d.ts +16 -0
  877. package/dist/shared/csrf-reject.d.ts.map +1 -0
  878. package/dist/shared/error-digest.d.ts +28 -0
  879. package/dist/shared/error-digest.d.ts.map +1 -0
  880. package/dist/shared/flight-base64.d.ts +13 -0
  881. package/dist/shared/flight-base64.d.ts.map +1 -0
  882. package/dist/shared/flight-segment.d.ts +18 -0
  883. package/dist/shared/flight-segment.d.ts.map +1 -0
  884. package/dist/shared/form-state-flight.d.ts +32 -0
  885. package/dist/shared/form-state-flight.d.ts.map +1 -0
  886. package/dist/shared/href-validation.d.ts +49 -0
  887. package/dist/shared/href-validation.d.ts.map +1 -0
  888. package/dist/shared/merge-search-params.d.ts +22 -0
  889. package/dist/shared/merge-search-params.d.ts.map +1 -0
  890. package/dist/shared/param-value.d.ts +104 -0
  891. package/dist/shared/param-value.d.ts.map +1 -0
  892. package/dist/shared/payload-root.d.ts +110 -0
  893. package/dist/shared/payload-root.d.ts.map +1 -0
  894. package/dist/shared/redirect-type.d.ts +17 -0
  895. package/dist/shared/redirect-type.d.ts.map +1 -0
  896. package/dist/shared/rsc-cache-key.d.ts +163 -0
  897. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  898. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  899. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  900. package/dist/shared/rsc-manifest.d.ts +28 -0
  901. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  902. package/dist/shared/rsc-media-type.d.ts +52 -0
  903. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  904. package/dist/shared/rsc-payload-path.d.ts +48 -0
  905. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  906. package/dist/shared/segment-info.d.ts +66 -0
  907. package/dist/shared/segment-info.d.ts.map +1 -0
  908. package/dist/shared/slot-params.d.ts +52 -0
  909. package/dist/shared/slot-params.d.ts.map +1 -0
  910. package/dist/shared/static-platform-files.d.ts +71 -0
  911. package/dist/shared/static-platform-files.d.ts.map +1 -0
  912. package/dist/shared/status-reason-phrase.d.ts +26 -0
  913. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  914. package/dist/shims/font-google.d.ts +1 -1
  915. package/dist/shims/font-google.d.ts.map +1 -1
  916. package/dist/shims/font-google.js +42 -0
  917. package/dist/shims/font-google.js.map +1 -0
  918. package/dist/shims/font-local.d.ts +26 -0
  919. package/dist/shims/font-local.d.ts.map +1 -0
  920. package/dist/shims/font-local.js +20 -0
  921. package/dist/shims/font-local.js.map +1 -0
  922. package/dist/shims/headers.d.ts +53 -1
  923. package/dist/shims/headers.d.ts.map +1 -1
  924. package/dist/shims/image.d.ts +120 -120
  925. package/dist/shims/image.d.ts.map +1 -1
  926. package/dist/shims/navigation-client.d.ts +25 -12
  927. package/dist/shims/navigation-client.d.ts.map +1 -1
  928. package/dist/shims/navigation-rsc.d.ts +21 -0
  929. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  930. package/dist/shims/navigation.d.ts +10 -5
  931. package/dist/shims/navigation.d.ts.map +1 -1
  932. package/dist/utils/state-machine.d.ts +80 -0
  933. package/dist/utils/state-machine.d.ts.map +1 -0
  934. package/dist/utils/write-file-atomic.d.ts +17 -0
  935. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  936. package/docs/api/30-api-server.mdx +239 -0
  937. package/docs/api/31-api-client.mdx +199 -0
  938. package/docs/api/32-api-cache.mdx +339 -0
  939. package/docs/api/33-api-search-params.mdx +176 -0
  940. package/docs/api/34-api-config.mdx +359 -0
  941. package/docs/api/35-api-typescript.mdx +91 -0
  942. package/docs/api/36-cli.mdx +206 -0
  943. package/docs/learn/00-introduction.mdx +109 -0
  944. package/docs/learn/01-quick-start.mdx +94 -0
  945. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  946. package/docs/learn/03-fetching-data.mdx +227 -0
  947. package/docs/learn/04-access-control.mdx +115 -0
  948. package/docs/learn/05-the-flush-point.mdx +175 -0
  949. package/docs/learn/06-typed-params.mdx +275 -0
  950. package/docs/learn/07-typed-routes.mdx +108 -0
  951. package/docs/learn/08-forms-and-actions.mdx +260 -0
  952. package/docs/learn/09-streaming.mdx +140 -0
  953. package/docs/learn/10-caching.mdx +270 -0
  954. package/docs/learn/11-middleware.mdx +164 -0
  955. package/docs/learn/12-error-handling.mdx +192 -0
  956. package/docs/learn/13-deploying.mdx +289 -0
  957. package/llms.txt +55 -0
  958. package/package.json +120 -29
  959. package/src/adapters/build-output-helper.ts +353 -0
  960. package/src/adapters/canonicalize-module.ts +29 -0
  961. package/src/adapters/cloudflare-dev.ts +183 -0
  962. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  963. package/src/adapters/cloudflare.ts +809 -150
  964. package/src/adapters/compress-module.ts +110 -86
  965. package/src/adapters/fs-identity.ts +155 -0
  966. package/src/adapters/nitro-immutable-assets.ts +142 -0
  967. package/src/adapters/nitro-presets.ts +124 -0
  968. package/src/adapters/nitro-preview.ts +533 -0
  969. package/src/adapters/nitro.ts +331 -445
  970. package/src/adapters/raw-imports.d.ts +5 -0
  971. package/src/adapters/shared.ts +283 -0
  972. package/src/adapters/types.ts +129 -17
  973. package/src/adapters/wrangler.d.ts +7 -0
  974. package/src/analyze/chains.ts +411 -0
  975. package/src/analyze/classify.ts +259 -0
  976. package/src/analyze/crawl-entry.ts +68 -0
  977. package/src/analyze/crawl.ts +500 -0
  978. package/src/analyze/graph-cache.ts +331 -0
  979. package/src/analyze/graph-command.ts +762 -0
  980. package/src/analyze/live-graph.ts +232 -0
  981. package/src/analyze/poison-rules.ts +165 -0
  982. package/src/analyze/poison-scan.ts +159 -0
  983. package/src/analyze/scan.ts +149 -0
  984. package/src/cache/cache-api.ts +107 -0
  985. package/src/cache/fast-hash.ts +5 -0
  986. package/src/cache/handler-store.ts +76 -0
  987. package/src/cache/index.ts +115 -22
  988. package/src/cache/invalidation-epoch.ts +93 -0
  989. package/src/cache/json-lossy-check.ts +69 -0
  990. package/src/cache/redis-handler.ts +198 -20
  991. package/src/cache/singleflight.ts +72 -6
  992. package/src/cache/sizeof.ts +35 -0
  993. package/src/cache/stable-stringify.ts +65 -2
  994. package/src/cache/store.ts +71 -0
  995. package/src/cache/stores/cloudflare-kv.ts +52 -0
  996. package/src/cache/stores/memory.ts +125 -0
  997. package/src/cache/stores/redis.ts +97 -0
  998. package/src/cache/stores/vercel.ts +59 -0
  999. package/src/cache/tag-aware-handler.ts +254 -0
  1000. package/src/cache/timber-cache.ts +165 -40
  1001. package/src/cdn/cloudflare-purge.ts +50 -0
  1002. package/src/cdn/fastly-purge.ts +63 -0
  1003. package/src/cdn/headers.ts +153 -0
  1004. package/src/cdn/index.ts +23 -0
  1005. package/src/cdn/purge-store.ts +34 -0
  1006. package/src/cdn/workers-cache-purge.ts +34 -0
  1007. package/src/cli-check.ts +417 -0
  1008. package/src/cli-context.ts +119 -0
  1009. package/src/cli-schema-sync.ts +401 -0
  1010. package/src/cli.ts +334 -80
  1011. package/src/client/browser-dev.ts +192 -5
  1012. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1013. package/src/client/browser-entry/action-queue.ts +152 -0
  1014. package/src/client/browser-entry/form-state.ts +49 -0
  1015. package/src/client/browser-entry/hmr.ts +70 -0
  1016. package/src/client/browser-entry/hydrate.ts +152 -0
  1017. package/src/client/browser-entry/index.ts +150 -0
  1018. package/src/client/browser-entry/post-hydration.ts +99 -0
  1019. package/src/client/browser-entry/router-init.ts +393 -0
  1020. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1021. package/src/client/browser-entry/scroll.ts +50 -0
  1022. package/src/client/deny-last-resort.tsx +54 -0
  1023. package/src/client/error-boundary.tsx +279 -61
  1024. package/src/client/error-reconstituter.tsx +84 -0
  1025. package/src/client/form.tsx +61 -173
  1026. package/src/client/global-context.ts +31 -0
  1027. package/src/client/history.ts +74 -11
  1028. package/src/client/index.ts +90 -53
  1029. package/src/client/internal.ts +54 -0
  1030. package/src/client/link.tsx +468 -151
  1031. package/src/client/location-search.ts +15 -0
  1032. package/src/client/navigation-api.ts +254 -0
  1033. package/src/client/navigation-commit.ts +318 -0
  1034. package/src/client/navigation-context.ts +67 -134
  1035. package/src/client/navigation-root.tsx +236 -0
  1036. package/src/client/navigation-transition.ts +348 -0
  1037. package/src/client/nuqs-adapter.tsx +21 -9
  1038. package/src/client/params-context.ts +187 -0
  1039. package/src/client/react-root.ts +105 -0
  1040. package/src/client/router-effects.ts +324 -0
  1041. package/src/client/router-lifecycle.ts +374 -0
  1042. package/src/client/router-pipeline.ts +456 -0
  1043. package/src/client/router-ref.ts +3 -3
  1044. package/src/client/router-skew.ts +30 -0
  1045. package/src/client/router-types.ts +346 -0
  1046. package/src/client/router-url.ts +32 -0
  1047. package/src/client/router.ts +500 -424
  1048. package/src/client/rsc-fetch.ts +510 -109
  1049. package/src/client/segment-cache.ts +362 -41
  1050. package/src/client/segment-context.ts +7 -4
  1051. package/src/client/segment-outlet.tsx +96 -0
  1052. package/src/client/segment-update-context.ts +23 -0
  1053. package/src/client/shallow-url.ts +22 -0
  1054. package/src/client/slot-content-cache-context.ts +43 -0
  1055. package/src/client/slot-context.ts +50 -0
  1056. package/src/client/slot-outlet.tsx +22 -0
  1057. package/src/client/slot-provider.tsx +32 -0
  1058. package/src/client/ssr-data.ts +27 -67
  1059. package/src/client/stale-client.ts +191 -0
  1060. package/src/client/state.ts +31 -24
  1061. package/src/client/status-page-marker.tsx +32 -0
  1062. package/src/client/top-loader.tsx +13 -10
  1063. package/src/client/unload-guard.ts +35 -3
  1064. package/src/client/use-cookie.ts +70 -18
  1065. package/src/client/use-field-state.ts +144 -0
  1066. package/src/client/use-link-status.ts +7 -7
  1067. package/src/client/use-pathname.ts +22 -31
  1068. package/src/client/use-pending-navigation.ts +40 -0
  1069. package/src/client/use-query-states.ts +206 -36
  1070. package/src/client/use-router.ts +31 -9
  1071. package/src/client/use-search-params.ts +38 -49
  1072. package/src/client/use-segment-params.ts +69 -0
  1073. package/src/client/use-selected-layout-segment.ts +2 -2
  1074. package/src/codec.ts +149 -0
  1075. package/src/config-types.ts +321 -0
  1076. package/src/config-validation.ts +464 -0
  1077. package/src/cookies/define-cookie.ts +222 -53
  1078. package/src/cookies/index.ts +13 -2
  1079. package/src/cookies/json-cookie.ts +105 -0
  1080. package/src/cookies/validation.ts +192 -0
  1081. package/src/dev-tools/404-page.ts +286 -0
  1082. package/src/dev-tools/browser-logs.ts +55 -0
  1083. package/src/dev-tools/dev-page-shell.ts +278 -0
  1084. package/src/dev-tools/error-page.ts +331 -0
  1085. package/src/dev-tools/holding-server.ts +185 -0
  1086. package/src/dev-tools/hydration-overlay.ts +158 -0
  1087. package/src/dev-tools/index.ts +79 -0
  1088. package/src/dev-tools/instrumentation.ts +261 -0
  1089. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1090. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
  1091. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1092. package/src/dev-tools/stack-classifier.ts +75 -0
  1093. package/src/dev-tools/terminal.ts +182 -0
  1094. package/src/fonts/ast-walk.ts +235 -0
  1095. package/src/fonts/ast.ts +479 -128
  1096. package/src/fonts/bundle.ts +138 -0
  1097. package/src/fonts/css.ts +1 -1
  1098. package/src/fonts/dev-middleware.ts +85 -0
  1099. package/src/fonts/fallbacks.ts +0 -23
  1100. package/src/fonts/google.ts +101 -19
  1101. package/src/fonts/local.ts +12 -11
  1102. package/src/fonts/paths.ts +58 -0
  1103. package/src/fonts/pipeline.ts +348 -0
  1104. package/src/fonts/transform.ts +311 -0
  1105. package/src/fonts/types.ts +52 -1
  1106. package/src/fonts/virtual-modules.ts +179 -0
  1107. package/src/index.ts +492 -380
  1108. package/src/params/codec-registry.ts +34 -0
  1109. package/src/params/define-schema.ts +115 -0
  1110. package/src/params/index.ts +17 -0
  1111. package/src/params/resolve-schema.ts +84 -0
  1112. package/src/plugin-context.ts +502 -0
  1113. package/src/plugins/build-manifest.ts +189 -36
  1114. package/src/plugins/build-report.ts +299 -87
  1115. package/src/plugins/cache.ts +243 -0
  1116. package/src/plugins/callsite-ast.ts +472 -0
  1117. package/src/plugins/callsite-jsx.ts +243 -0
  1118. package/src/plugins/chunks.ts +74 -5
  1119. package/src/plugins/client-chunks.ts +185 -0
  1120. package/src/plugins/client-dep-entries.ts +124 -0
  1121. package/src/plugins/cloudflare-wasm.ts +141 -0
  1122. package/src/plugins/content.ts +31 -2
  1123. package/src/plugins/dev-discovery.ts +218 -0
  1124. package/src/plugins/dev-server.ts +360 -97
  1125. package/src/plugins/encryption-runtime.ts +31 -0
  1126. package/src/plugins/entries.ts +150 -17
  1127. package/src/plugins/fonts.ts +260 -657
  1128. package/src/plugins/graph-endpoint.ts +532 -0
  1129. package/src/plugins/mdx.ts +108 -35
  1130. package/src/plugins/post-build.ts +327 -0
  1131. package/src/plugins/prebuilt-capture.ts +213 -0
  1132. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1133. package/src/plugins/prebuilt.ts +670 -0
  1134. package/src/plugins/prerender-sugar.ts +316 -0
  1135. package/src/plugins/react-resolve.ts +149 -0
  1136. package/src/plugins/request-dep/analysis.ts +447 -0
  1137. package/src/plugins/request-dep/index.ts +376 -0
  1138. package/src/plugins/request-dep/origin.ts +310 -0
  1139. package/src/plugins/routing.ts +273 -277
  1140. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1141. package/src/plugins/server-bundle.ts +115 -15
  1142. package/src/plugins/shims.ts +257 -97
  1143. package/src/plugins/static-build.ts +681 -71
  1144. package/src/react-canary.d.ts +2 -0
  1145. package/src/routing/codegen-shared.ts +39 -0
  1146. package/src/routing/codegen-types.ts +62 -0
  1147. package/src/routing/codegen-write.ts +163 -0
  1148. package/src/routing/codegen.ts +349 -232
  1149. package/src/routing/collision-probe.ts +438 -0
  1150. package/src/routing/collision-spaces.ts +281 -0
  1151. package/src/routing/convention-lint.ts +651 -0
  1152. package/src/routing/export-detect.ts +536 -0
  1153. package/src/routing/file-cache.ts +23 -0
  1154. package/src/routing/index.ts +16 -7
  1155. package/src/routing/interception-overlap.ts +141 -0
  1156. package/src/routing/interception.ts +1044 -67
  1157. package/src/routing/link-codegen.ts +280 -0
  1158. package/src/routing/manifest-codegen.ts +232 -0
  1159. package/src/routing/scanner.ts +417 -223
  1160. package/src/routing/schema-validation.ts +155 -0
  1161. package/src/routing/segment-classify.ts +280 -0
  1162. package/src/routing/segment-codegen.ts +99 -0
  1163. package/src/routing/segment-keys.ts +186 -0
  1164. package/src/routing/slot-placement.ts +97 -0
  1165. package/src/routing/types.ts +82 -26
  1166. package/src/routing/walkers.ts +98 -0
  1167. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1168. package/src/rsc-runtime/render-flight.ts +26 -0
  1169. package/src/rsc-runtime/rsc.ts +17 -2
  1170. package/src/rsc-runtime/ssr.ts +13 -0
  1171. package/src/rsc-runtime/transforms.ts +13 -0
  1172. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1173. package/src/schema-bridge.ts +382 -0
  1174. package/src/search-params/define.ts +677 -0
  1175. package/src/search-params/index.ts +14 -20
  1176. package/src/search-params/parse-total.ts +91 -0
  1177. package/src/search-params/serialize-equal.ts +14 -0
  1178. package/src/search-params/wrappers.ts +150 -0
  1179. package/src/server/access-gate.tsx +195 -56
  1180. package/src/server/action-client.ts +175 -294
  1181. package/src/server/action-encryption.ts +144 -0
  1182. package/src/server/action-handler.ts +492 -150
  1183. package/src/server/action-schema.ts +203 -0
  1184. package/src/server/action-types.ts +145 -0
  1185. package/src/server/actions.ts +172 -85
  1186. package/src/server/als-registry.ts +245 -30
  1187. package/src/server/body-limits.ts +10 -2
  1188. package/src/server/build-manifest.ts +33 -57
  1189. package/src/server/canonicalize.ts +35 -3
  1190. package/src/server/chain-url-parts.ts +163 -0
  1191. package/src/server/children-interception.ts +116 -0
  1192. package/src/server/client-error-message.ts +18 -0
  1193. package/src/server/coalesce-tick.ts +75 -0
  1194. package/src/server/compress.ts +91 -19
  1195. package/src/server/cookie-context.ts +454 -0
  1196. package/src/server/cookie-parsing.ts +163 -0
  1197. package/src/server/csp-nonce.ts +58 -0
  1198. package/src/server/csrf.ts +228 -35
  1199. package/src/server/debug.ts +0 -1
  1200. package/src/server/default-logger.ts +100 -0
  1201. package/src/server/default-status-page.ts +88 -0
  1202. package/src/server/deny-boundary.ts +527 -0
  1203. package/src/server/deny-renderer.ts +210 -181
  1204. package/src/server/early-hints-sender.ts +4 -3
  1205. package/src/server/early-hints.ts +39 -29
  1206. package/src/server/error-boundary-wrapper.ts +160 -44
  1207. package/src/server/error-response-headers.ts +18 -0
  1208. package/src/server/fallback-error.ts +88 -104
  1209. package/src/server/flight-injection-state.ts +113 -0
  1210. package/src/server/flight-injector-core.ts +328 -0
  1211. package/src/server/flight-scripts.ts +92 -0
  1212. package/src/server/flight-source-node.ts +430 -0
  1213. package/src/server/flight-source.ts +288 -0
  1214. package/src/server/form-data.ts +191 -20
  1215. package/src/server/form-state-flight.ts +67 -0
  1216. package/src/server/head-response.ts +50 -0
  1217. package/src/server/html-injector-core.ts +320 -0
  1218. package/src/server/html-injectors.ts +241 -285
  1219. package/src/server/index.ts +37 -195
  1220. package/src/server/instrumentation.ts +11 -4
  1221. package/src/server/internal.ts +168 -0
  1222. package/src/server/json-status-response.ts +105 -0
  1223. package/src/server/logger.ts +131 -38
  1224. package/src/server/metadata-collector.ts +175 -0
  1225. package/src/server/metadata-platform.ts +2 -2
  1226. package/src/server/metadata-render.ts +30 -8
  1227. package/src/server/metadata-route-links.ts +200 -0
  1228. package/src/server/metadata-routes.ts +114 -24
  1229. package/src/server/metadata-social.ts +2 -2
  1230. package/src/server/metadata.ts +23 -2
  1231. package/src/server/middleware-runner.ts +32 -5
  1232. package/src/server/node-body-response.ts +236 -0
  1233. package/src/server/node-response.ts +93 -0
  1234. package/src/server/node-stream-transforms.ts +340 -0
  1235. package/src/server/node-streams-platform.ts +23 -0
  1236. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1237. package/src/server/param-coercion.ts +201 -0
  1238. package/src/server/pipeline-helpers.ts +548 -0
  1239. package/src/server/pipeline-interception.ts +241 -32
  1240. package/src/server/pipeline-metadata.ts +25 -1
  1241. package/src/server/pipeline-outcome.ts +290 -0
  1242. package/src/server/pipeline-phases.ts +503 -0
  1243. package/src/server/pipeline.ts +423 -426
  1244. package/src/server/port-resolution.ts +43 -0
  1245. package/src/server/prebuilt/cache-key.ts +299 -0
  1246. package/src/server/prebuilt/capture-render.ts +118 -0
  1247. package/src/server/prebuilt/capture-routes.ts +104 -0
  1248. package/src/server/prebuilt/capture-state.ts +196 -0
  1249. package/src/server/prebuilt/key-discipline.ts +122 -0
  1250. package/src/server/prebuilt/lifetime.ts +151 -0
  1251. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1252. package/src/server/prebuilt/overlay.ts +256 -0
  1253. package/src/server/prebuilt/payload-source.ts +202 -0
  1254. package/src/server/prebuilt/slots.ts +202 -0
  1255. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1256. package/src/server/prebuilt-builder.ts +514 -0
  1257. package/src/server/prebuilt-runtime.ts +810 -0
  1258. package/src/server/primitives.ts +153 -171
  1259. package/src/server/publish-params.ts +42 -0
  1260. package/src/server/react-cache-bridge.ts +124 -0
  1261. package/src/server/react-cache-scope.ts +104 -0
  1262. package/src/server/render-timeout.ts +128 -0
  1263. package/src/server/render-utils.ts +45 -0
  1264. package/src/server/request-context.ts +298 -324
  1265. package/src/server/request-dep.ts +37 -0
  1266. package/src/server/response-cache-policy.ts +45 -0
  1267. package/src/server/route-element-builder.ts +526 -355
  1268. package/src/server/route-element-helpers.ts +37 -0
  1269. package/src/server/route-handler.ts +67 -27
  1270. package/src/server/route-matcher.ts +238 -267
  1271. package/src/server/route-module-loader.ts +161 -0
  1272. package/src/server/rsc-cache-key-guard.ts +122 -0
  1273. package/src/server/rsc-entry/action-dispatcher.ts +144 -0
  1274. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1275. package/src/server/rsc-entry/api-handler.ts +49 -81
  1276. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1277. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1278. package/src/server/rsc-entry/helpers.ts +90 -115
  1279. package/src/server/rsc-entry/index.ts +372 -350
  1280. package/src/server/rsc-entry/render-route.ts +248 -0
  1281. package/src/server/rsc-entry/render-signals.ts +108 -0
  1282. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1283. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1284. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1285. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1286. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1287. package/src/server/rsc-error-envelope.ts +18 -0
  1288. package/src/server/rsc-prop-warnings.ts +1 -1
  1289. package/src/server/safe-load.ts +53 -0
  1290. package/src/server/schema-introspection.ts +393 -0
  1291. package/src/server/sensitive-fields.ts +287 -0
  1292. package/src/server/server-only-guard-noop.js +3 -0
  1293. package/src/server/server-timing.ts +1 -1
  1294. package/src/server/signal-identity.ts +112 -0
  1295. package/src/server/sitemap-generator.ts +337 -0
  1296. package/src/server/sitemap-handler.ts +150 -0
  1297. package/src/server/skippable-prefix.ts +172 -0
  1298. package/src/server/slot-interception.ts +168 -0
  1299. package/src/server/slot-resolver.ts +707 -300
  1300. package/src/server/slot-subtree-contain.ts +273 -0
  1301. package/src/server/ssr-bridge-types.ts +217 -0
  1302. package/src/server/ssr-entry.ts +248 -109
  1303. package/src/server/ssr-form-state.ts +58 -0
  1304. package/src/server/ssr-render.ts +334 -101
  1305. package/src/server/ssr-wrappers.tsx +162 -0
  1306. package/src/server/state-tree-diff.ts +85 -30
  1307. package/src/server/static-generator.ts +680 -0
  1308. package/src/server/static-not-found.ts +134 -0
  1309. package/src/server/status-code-resolver.ts +107 -148
  1310. package/src/server/stream-utils.ts +398 -0
  1311. package/src/server/tracing.ts +163 -68
  1312. package/src/server/tree-match.ts +494 -0
  1313. package/src/server/types.ts +96 -11
  1314. package/src/server/utils/element-type.ts +88 -0
  1315. package/src/server/utils/escape-html.ts +20 -0
  1316. package/src/server/version-skew.ts +104 -0
  1317. package/src/server/waituntil-bridge.ts +1 -1
  1318. package/src/server/workers-cache-bridge.ts +33 -0
  1319. package/src/shared/als-slots.ts +74 -0
  1320. package/src/shared/base-path.ts +80 -0
  1321. package/src/shared/csrf-reject.ts +15 -0
  1322. package/src/shared/error-digest.ts +46 -0
  1323. package/src/shared/flight-base64.ts +23 -0
  1324. package/src/shared/flight-segment.ts +35 -0
  1325. package/src/shared/form-state-flight.ts +59 -0
  1326. package/src/shared/href-validation.ts +159 -0
  1327. package/src/shared/merge-search-params.ts +55 -0
  1328. package/src/shared/param-value.ts +281 -0
  1329. package/src/shared/payload-root.ts +153 -0
  1330. package/src/shared/redirect-type.ts +17 -0
  1331. package/src/shared/rsc-cache-key.ts +269 -0
  1332. package/src/shared/rsc-error-envelope.ts +16 -0
  1333. package/src/shared/rsc-manifest.ts +29 -0
  1334. package/src/shared/rsc-media-type.ts +59 -0
  1335. package/src/shared/rsc-payload-path.ts +52 -0
  1336. package/src/shared/segment-info.ts +67 -0
  1337. package/src/shared/slot-params.ts +109 -0
  1338. package/src/shared/static-platform-files.ts +75 -0
  1339. package/src/shared/status-reason-phrase.ts +61 -0
  1340. package/src/shims/font-google.ts +1 -1
  1341. package/src/shims/font-local.ts +34 -0
  1342. package/src/shims/headers.ts +122 -1
  1343. package/src/shims/navigation-client.ts +36 -32
  1344. package/src/shims/navigation-rsc.ts +47 -0
  1345. package/src/shims/navigation.ts +10 -7
  1346. package/src/utils/state-machine.ts +111 -0
  1347. package/src/utils/write-file-atomic.ts +32 -0
  1348. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1349. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1350. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1351. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1352. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1353. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1354. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1355. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1356. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1357. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1358. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1359. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1360. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1361. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1362. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1363. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1364. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1365. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1366. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1367. package/dist/adapters/cloudflare.js.map +0 -1
  1368. package/dist/cache/index.js.map +0 -1
  1369. package/dist/cache/register-cached-function.d.ts +0 -17
  1370. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1371. package/dist/client/browser-entry.d.ts +0 -21
  1372. package/dist/client/browser-entry.d.ts.map +0 -1
  1373. package/dist/client/error-boundary.js.map +0 -1
  1374. package/dist/client/head.d.ts +0 -16
  1375. package/dist/client/head.d.ts.map +0 -1
  1376. package/dist/client/link-status-provider.d.ts +0 -11
  1377. package/dist/client/link-status-provider.d.ts.map +0 -1
  1378. package/dist/client/segment-merger.d.ts +0 -119
  1379. package/dist/client/segment-merger.d.ts.map +0 -1
  1380. package/dist/client/stale-reload.d.ts +0 -44
  1381. package/dist/client/stale-reload.d.ts.map +0 -1
  1382. package/dist/client/transition-root.d.ts +0 -74
  1383. package/dist/client/transition-root.d.ts.map +0 -1
  1384. package/dist/client/types.d.ts +0 -14
  1385. package/dist/client/types.d.ts.map +0 -1
  1386. package/dist/client/use-navigation-pending.d.ts +0 -26
  1387. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1388. package/dist/client/use-params.d.ts +0 -92
  1389. package/dist/client/use-params.d.ts.map +0 -1
  1390. package/dist/content/index.d.ts +0 -11
  1391. package/dist/content/index.d.ts.map +0 -1
  1392. package/dist/content/index.js +0 -2
  1393. package/dist/plugins/adapter-build.d.ts +0 -18
  1394. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1395. package/dist/plugins/cache-transform.d.ts +0 -36
  1396. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1397. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1398. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1399. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1400. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1401. package/dist/plugins/server-action-exports.d.ts +0 -26
  1402. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1403. package/dist/routing/status-file-lint.d.ts +0 -33
  1404. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1405. package/dist/search-params/analyze.d.ts +0 -54
  1406. package/dist/search-params/analyze.d.ts.map +0 -1
  1407. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1408. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1409. package/dist/search-params/codecs.d.ts +0 -53
  1410. package/dist/search-params/codecs.d.ts.map +0 -1
  1411. package/dist/search-params/create.d.ts +0 -106
  1412. package/dist/search-params/create.d.ts.map +0 -1
  1413. package/dist/search-params/registry.d.ts +0 -20
  1414. package/dist/search-params/registry.d.ts.map +0 -1
  1415. package/dist/server/asset-headers.d.ts +0 -42
  1416. package/dist/server/asset-headers.d.ts.map +0 -1
  1417. package/dist/server/client-module-map.d.ts +0 -47
  1418. package/dist/server/client-module-map.d.ts.map +0 -1
  1419. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1420. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1421. package/dist/server/dev-logger.d.ts.map +0 -1
  1422. package/dist/server/dev-span-processor.d.ts +0 -29
  1423. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1424. package/dist/server/dev-warnings.d.ts +0 -129
  1425. package/dist/server/dev-warnings.d.ts.map +0 -1
  1426. package/dist/server/flush.d.ts +0 -74
  1427. package/dist/server/flush.d.ts.map +0 -1
  1428. package/dist/server/form-flash.d.ts +0 -78
  1429. package/dist/server/form-flash.d.ts.map +0 -1
  1430. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1431. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1432. package/dist/server/prerender.d.ts +0 -77
  1433. package/dist/server/prerender.d.ts.map +0 -1
  1434. package/dist/server/tree-builder.d.ts +0 -126
  1435. package/dist/server/tree-builder.d.ts.map +0 -1
  1436. package/dist/utils/directive-parser.d.ts +0 -70
  1437. package/dist/utils/directive-parser.d.ts.map +0 -1
  1438. package/src/cache/register-cached-function.ts +0 -103
  1439. package/src/client/browser-entry.ts +0 -678
  1440. package/src/client/head.ts +0 -61
  1441. package/src/client/link-status-provider.tsx +0 -30
  1442. package/src/client/segment-merger.ts +0 -339
  1443. package/src/client/stale-reload.ts +0 -87
  1444. package/src/client/transition-root.tsx +0 -166
  1445. package/src/client/types.ts +0 -21
  1446. package/src/client/use-navigation-pending.ts +0 -38
  1447. package/src/client/use-params.ts +0 -141
  1448. package/src/content/index.ts +0 -13
  1449. package/src/plugins/adapter-build.ts +0 -118
  1450. package/src/plugins/cache-transform.ts +0 -199
  1451. package/src/plugins/dynamic-transform.ts +0 -161
  1452. package/src/plugins/server-action-exports.ts +0 -220
  1453. package/src/routing/status-file-lint.ts +0 -112
  1454. package/src/search-params/analyze.ts +0 -192
  1455. package/src/search-params/builtin-codecs.ts +0 -228
  1456. package/src/search-params/codecs.ts +0 -153
  1457. package/src/search-params/create.ts +0 -321
  1458. package/src/search-params/registry.ts +0 -31
  1459. package/src/server/asset-headers.ts +0 -81
  1460. package/src/server/client-module-map.ts +0 -58
  1461. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1462. package/src/server/dev-span-processor.ts +0 -78
  1463. package/src/server/dev-warnings.ts +0 -283
  1464. package/src/server/flush.ts +0 -182
  1465. package/src/server/form-flash.ts +0 -89
  1466. package/src/server/manifest-status-resolver.ts +0 -215
  1467. package/src/server/prerender.ts +0 -139
  1468. package/src/server/tree-builder.ts +0 -382
  1469. package/src/shims/server-only-noop.js +0 -6
  1470. package/src/utils/directive-parser.ts +0 -529
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Stale Client — knowing when this bundle has been superseded.
3
+ *
4
+ * Layer 1 of version skew handling (see design/33-version-skew.md) is
5
+ * proactive: the server compares `X-Timber-Deployment-Id` against the current
6
+ * build and answers a stale client with `X-Timber-Reload: 1`. That covers
7
+ * every RSC navigation and every server action — as long as there is a server
8
+ * in the request path.
9
+ *
10
+ * This module is the reactive half, plus the state both halves feed. It
11
+ * recognizes the two error shapes a stale client produces on its own:
12
+ *
13
+ * 1. **Stale client references** — React's Flight client throws
14
+ * "Could not find the module …" when an RSC payload names a client module
15
+ * ID that isn't in this bundle's manifest.
16
+ * 2. **Chunk load failures** — a content-hashed chunk that no longer exists on
17
+ * the CDN fails to `import()`. Every engine words this differently.
18
+ *
19
+ * It matters most for `output: 'static'`, where there is no server to send the
20
+ * reload header and this is the *only* skew detection that can run.
21
+ *
22
+ * **Nothing here reloads the page.** A stale client is recorded, not acted on;
23
+ * the router turns the next user-initiated navigation into a full document
24
+ * load. See design/33-version-skew.md §"Recovery on the next navigation" for
25
+ * why — a self-issued `location.reload()` cannot tell a recovery from a bounce
26
+ * between two live deployments, and mid-rollout it produces exactly that loop.
27
+ *
28
+ * See TIM-1260, TIM-1275.
29
+ */
30
+ /**
31
+ * True when the error is React's "client reference not in this manifest"
32
+ * failure — the payload was produced by a build this bundle doesn't match.
33
+ */
34
+ export declare function isStaleClientReference(error: unknown): boolean;
35
+ /**
36
+ * True when the error is a failed dynamic import or CSS preload — the
37
+ * content-hashed chunk this bundle asks for is gone from the CDN.
38
+ */
39
+ export declare function isChunkLoadError(error: unknown): boolean;
40
+ /** Whether this client has been superseded by a newer deployment. */
41
+ export declare function isClientStale(): boolean;
42
+ /**
43
+ * Record that the origin has told us this client is stale — the `X-Timber-Reload`
44
+ * header on an RSC or action response. Authoritative, so it is not gated on
45
+ * anything: a dev server never sends the header in the first place.
46
+ */
47
+ export declare function markClientStale(): void;
48
+ /**
49
+ * Record staleness if `error` is one of the shapes a superseded bundle
50
+ * produces. Returns whether it did, so a caller mid-navigation can decide to
51
+ * hard-navigate instead of surfacing the error.
52
+ *
53
+ * Inference, unlike {@link markClientStale}, so it is gated on being a
54
+ * production build. This is the single place that gate lives — call sites
55
+ * cannot see each other, and "remember to gate the next one too" is not a
56
+ * guarantee.
57
+ */
58
+ export declare function markStaleFromError(error: unknown): boolean;
59
+ /**
60
+ * Arm the module, and register the listeners that catch stale-client errors
61
+ * never passing through the router: a lazily imported client component, a
62
+ * preloaded stylesheet, anything that rejects outside a navigation.
63
+ *
64
+ * No-op when `deploymentId` is null — that is dev. Called from the browser
65
+ * entry before hydration, so it precedes any render or navigation that could
66
+ * throw.
67
+ */
68
+ export declare function initStaleClient(deploymentId: string | null): void;
69
+ //# sourceMappingURL=stale-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stale-client.d.ts","sourceRoot":"","sources":["../../src/client/stale-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AA4CH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIxD;AAuBD,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB1D;AAeD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAejE"}
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * ALL mutable module-level state that must have singleton semantics across
5
5
  * the client bundle lives here. Individual modules (router-ref.ts, ssr-data.ts,
6
- * use-params.ts, use-search-params.ts, unload-guard.ts) import from this file
6
+ * use-segment-params.ts, use-search-params.ts, unload-guard.ts) import from this file
7
7
  * and re-export thin wrapper functions.
8
8
  *
9
9
  * Why: In Vite dev, a module is instantiated separately if reached via different
@@ -18,25 +18,17 @@
18
18
  * See design/18-build-system.md §"Module Singleton Strategy" and
19
19
  * §"Singleton State Registry".
20
20
  */
21
- import type { RouterInstance } from './router.js';
22
- import type { SsrData } from './ssr-data.js';
21
+ import type { RouterInstance } from './router-types.ts';
22
+ import type { SsrData } from './ssr-data.ts';
23
23
  /** The global router singleton — set once during bootstrap. */
24
24
  export declare let globalRouter: RouterInstance | null;
25
25
  export declare function _setGlobalRouter(router: RouterInstance | null): void;
26
26
  /**
27
- * ALS-backed SSR data provider. When registered, getSsrData() reads from
28
- * this function (ALS store) instead of module-level currentSsrData.
27
+ * ALS-backed SSR data provider, registered by the SSR entry. getSsrData()
28
+ * reads through it; unset in the browser.
29
29
  */
30
30
  export declare let ssrDataProvider: (() => SsrData | undefined) | undefined;
31
31
  export declare function _setSsrDataProvider(provider: (() => SsrData | undefined) | undefined): void;
32
- /** Fallback SSR data for tests and environments without ALS. */
33
- export declare let currentSsrData: SsrData | undefined;
34
- export declare function _setCurrentSsrData(data: SsrData | undefined): void;
35
- /** Current route params snapshot — replaced (not mutated) on each navigation. */
36
- export declare let currentParams: Record<string, string | string[]>;
37
- export declare function _setCurrentParams(params: Record<string, string | string[]>): void;
38
- /** Listeners notified when currentParams changes. */
39
- export declare const paramsListeners: Set<() => void>;
40
32
  /** Cached search string — avoids reparsing when URL hasn't changed. */
41
33
  export declare let cachedSearch: string;
42
34
  export declare let cachedSearchParams: URLSearchParams;
@@ -44,4 +36,20 @@ export declare function _setCachedSearch(search: string, params: URLSearchParams
44
36
  /** Whether the page is currently being unloaded. */
45
37
  export declare let unloading: boolean;
46
38
  export declare function _setUnloading(value: boolean): void;
39
+ /**
40
+ * Whether a status page for the main route has rendered since the last
41
+ * navigation was prepared. Raised by `StatusPageMarker`, consumed by the
42
+ * navigation's commit. See navigation-commit.ts §"What a status page
43
+ * teaches the cache".
44
+ */
45
+ export declare let statusPageRendered: boolean;
46
+ export declare function _setStatusPageRendered(value: boolean): void;
47
+ /**
48
+ * What a status page report does beyond raising the flag: registered by the
49
+ * router's committer so the report can clear the segment cache at once, for
50
+ * the commits no navigation consumes (a row arriving inside Suspense after
51
+ * its navigation published, a status document being hydrated).
52
+ */
53
+ export declare let onStatusPageRendered: (() => void) | undefined;
54
+ export declare function _setOnStatusPageRendered(handler: (() => void) | undefined): void;
47
55
  //# sourceMappingURL=state.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/client/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,+DAA+D;AAC/D,eAAO,IAAI,YAAY,EAAE,cAAc,GAAG,IAAW,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEpE;AAID;;;GAGG;AACH,eAAO,IAAI,eAAe,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE3F;AAED,gEAAgE;AAChE,eAAO,IAAI,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;AAE/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAElE;AAID,iFAAiF;AACjF,eAAO,IAAI,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAM,CAAC;AAEjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,IAAI,CAEjF;AAED,qDAAqD;AACrD,eAAO,MAAM,eAAe,YAAiB,IAAI,CAAG,CAAC;AAIrD,uEAAuE;AACvE,eAAO,IAAI,YAAY,QAAK,CAAC;AAC7B,eAAO,IAAI,kBAAkB,iBAAwB,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAG9E;AAID,oDAAoD;AACpD,eAAO,IAAI,SAAS,SAAQ,CAAC;AAE7B,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElD"}
1
+ {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/client/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,+DAA+D;AAC/D,eAAO,IAAI,YAAY,EAAE,cAAc,GAAG,IAAW,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEpE;AAID;;;GAGG;AACH,eAAO,IAAI,eAAe,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE3F;AAID,uEAAuE;AACvE,eAAO,IAAI,YAAY,QAAK,CAAC;AAC7B,eAAO,IAAI,kBAAkB,iBAAwB,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAG9E;AAID,oDAAoD;AACpD,eAAO,IAAI,SAAS,SAAQ,CAAC;AAE7B,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElD;AAID;;;;;GAKG;AACH,eAAO,IAAI,kBAAkB,SAAQ,CAAC;AAEtC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED;;;;;GAKG;AACH,eAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;AAE1D,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAEhF"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * The one way a status page tells the router it is on screen.
3
+ *
4
+ * A status page replaces a subtree, and the segment cache must not learn a
5
+ * chain that never mounted (see `navigation-commit.ts` §"What a status page
6
+ * teaches the cache"). Status pages are produced in three places — an
7
+ * in-tree catch site rendering the page it owns, the server's fallback
8
+ * renderers, and a client boundary rendering its fallback for a Flight row —
9
+ * and every one of them wraps the page in this marker, so the report does
10
+ * not depend on which producer it was. In particular the in-tree case, the
11
+ * common `access.ts` deny, never involves a client boundary at all.
12
+ *
13
+ * A layout effect, on every commit that renders the marker rather than on
14
+ * mount only: React reuses the fiber when one status page is replaced by
15
+ * another at the same position, and the second one must report too. Layout
16
+ * effects run child-before-parent, so the report lands before the ancestor
17
+ * `NavigationRoot` publishes the same commit, and never for a render React
18
+ * discards. Idempotent, so StrictMode's double invocation and a status page
19
+ * re-rendering on its own state are harmless. See TIM-1495.
20
+ */
21
+ import { type ReactNode } from 'react';
22
+ export declare function StatusPageMarker({ children }: {
23
+ children: ReactNode;
24
+ }): ReactNode;
25
+ //# sourceMappingURL=status-page-marker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status-page-marker.d.ts","sourceRoot":"","sources":["../../src/client/status-page-marker.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAKjF"}
@@ -3,11 +3,11 @@
3
3
  *
4
4
  * Shows an animated progress bar at the top of the viewport while an RSC
5
5
  * navigation is in flight. Injected automatically by the framework into
6
- * TransitionRoot — users never render this component directly.
6
+ * NavigationRoot — users never render this component directly.
7
7
  *
8
8
  * Configuration is via timber.config.ts `topLoader` key. Enabled by default.
9
9
  * Users who want a fully custom progress indicator disable the built-in one
10
- * (`topLoader: { enabled: false }`) and use `useNavigationPending()` directly.
10
+ * (`topLoader: { enabled: false }`) and use `usePendingNavigation()` directly.
11
11
  *
12
12
  * Animation approach: pure CSS @keyframes. The bar crawls from 0% to ~90%
13
13
  * width over ~30s using ease-out timing. When navigation completes, the bar
@@ -21,7 +21,7 @@
21
21
  * stays invisible during the delay period. If navigation finishes before the
22
22
  * delay, the bar was never visible so the finish transition is also invisible.
23
23
  *
24
- * See design/19-client-navigation.md §"useNavigationPending()"
24
+ * See design/19-client-navigation.md §"usePendingNavigation()"
25
25
  * See LOCAL-336 for design decisions.
26
26
  */
27
27
  export interface TopLoaderConfig {
@@ -31,7 +31,7 @@ export interface TopLoaderConfig {
31
31
  color?: string;
32
32
  /** Bar height in pixels. Default: 3. */
33
33
  height?: number;
34
- /** Show subtle glow/shadow effect. Default: true. */
34
+ /** Show subtle glow/shadow effect. Default: false. */
35
35
  shadow?: boolean;
36
36
  /** Delay in ms before showing the bar. Default: 0. */
37
37
  delay?: number;
@@ -39,9 +39,10 @@ export interface TopLoaderConfig {
39
39
  zIndex?: number;
40
40
  }
41
41
  /**
42
- * Internal top-loader component. Injected by TransitionRoot.
42
+ * Internal top-loader component. Injected by NavigationRoot.
43
43
  *
44
- * Reads pending navigation state from PendingNavigationContext.
44
+ * Reads pending navigation state from the router's external store, via
45
+ * usePendingNavigation() — the one pending representation (TIM-1307).
45
46
  * Phase transitions are derived synchronously during render:
46
47
  *
47
48
  * hidden → crawling: when isPending becomes true
@@ -1 +1 @@
1
- {"version":3,"file":"top-loader.d.ts","sourceRoot":"","sources":["../../src/client/top-loader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA2F7F"}
1
+ {"version":3,"file":"top-loader.d.ts","sourceRoot":"","sources":["../../src/client/top-loader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CA6F7F"}
@@ -8,6 +8,11 @@
8
8
  * unloaded so error boundaries and error handlers can suppress abort-related
9
9
  * errors during the unload window.
10
10
  *
11
+ * This is the single owner of "is this document going away". Anything that
12
+ * needs the answer imports `isPageUnloading()` — an unload flag maintained a
13
+ * second time somewhere else is a flag that will drift out of agreement with
14
+ * this one (TIM-1260).
15
+ *
11
16
  * Mutable state is delegated to client/state.ts for singleton guarantees.
12
17
  * See design/18-build-system.md §"Singleton State Registry"
13
18
  *
@@ -1 +1 @@
1
- {"version":3,"file":"unload-guard.d.ts","sourceRoot":"","sources":["../../src/client/unload-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
1
+ {"version":3,"file":"unload-guard.d.ts","sourceRoot":"","sources":["../../src/client/unload-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA2CH;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}
@@ -22,6 +22,18 @@ export interface ClientCookieOptions {
22
22
  secure?: boolean;
23
23
  }
24
24
  export type CookieSetter = (value: string, options?: ClientCookieOptions) => void;
25
+ /** Parse a cookie name from document.cookie. */
26
+ export declare function getCookieValue(name: string): string | undefined;
27
+ /** Serialize options into a cookie string suffix. */
28
+ export declare function serializeOptions(options?: ClientCookieOptions): string;
29
+ /**
30
+ * Notify useCookie subscribers that a cookie value changed.
31
+ * Called by defineCookie's imperative client .set()/.delete() methods
32
+ * so mounted useCookie() consumers re-render.
33
+ *
34
+ * @internal — framework use only
35
+ */
36
+ export declare function notifyCookieChange(name: string): void;
25
37
  /**
26
38
  * Reactive hook for reading/writing a client-side cookie.
27
39
  *
@@ -1 +1 @@
1
- {"version":3,"file":"use-cookie.d.ts","sourceRoot":"","sources":["../../src/client/use-cookie.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;AA0ClF;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,mBAAmB,GACnC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC,CAmChF"}
1
+ {"version":3,"file":"use-cookie.d.ts","sourceRoot":"","sources":["../../src/client/use-cookie.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;AASlF,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/D;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAkBtE;AAUD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,mBAAmB,GACnC,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC,CA8DhF"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * useFieldState — state for a form field that needs JavaScript (a combobox, a
3
+ * chip list, a row list), made to behave like a native uncontrolled input.
4
+ *
5
+ * React resets a form after its action settles, so a native field with a
6
+ * `defaultValue` lands on whatever default the page now renders: the action's
7
+ * `submittedValues`, or fresh page data after a redirect. State held in
8
+ * `useState` misses that reset and keeps showing the pre-submit edit. This
9
+ * hook shows `defaultValue` until the user edits, and drops the edit when the
10
+ * form resets, so it lands where the native fields do.
11
+ *
12
+ * See design/08-forms-and-actions.md §"The Form Model".
13
+ */
14
+ import { type Dispatch, type RefCallback, type SetStateAction } from 'react';
15
+ /**
16
+ * State for a field that follows its form's reset.
17
+ *
18
+ * Returns `[value, setValue, ref]`. Attach `ref` to any element inside the
19
+ * `<form>`, or to the `<form>` itself (the hook subscribes to
20
+ * `closest('form')`, which includes the element), and render the value into
21
+ * the form data yourself (usually hidden inputs). With the ref on the form,
22
+ * the hook can live above it and hold the whole draft as one object, for a
23
+ * live preview beside the form. `value` is `defaultValue` until `setValue` is called, and is
24
+ * `defaultValue` again after the form resets, unless the form cancels its
25
+ * `reset` event. An edit dispatches a bubbling `change` event from the `ref`
26
+ * element after it commits, so a native `change` listener on the form sees it
27
+ * as it sees a native input's (React's synthetic `onChange` reports only
28
+ * inputs, selects and textareas). A reset and a new default fire none, as
29
+ * they fire none for a native input.
30
+ *
31
+ * @example
32
+ * ```tsx
33
+ * // draft: the form's defaults, read from result?.submittedValues ?? pageData
34
+ * const [tags, setTags, ref] = useFieldState(draft.tags);
35
+ * <div ref={ref}>
36
+ * {tags.map((tag) => <input key={tag} type="hidden" name="tags" value={tag} />)}
37
+ * <TagPicker value={tags} onChange={setTags} />
38
+ * </div>
39
+ * ```
40
+ */
41
+ export declare function useFieldState<T>(defaultValue: T): [value: T, setValue: Dispatch<SetStateAction<T>>, ref: RefCallback<HTMLElement>];
42
+ //# sourceMappingURL=use-field-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-field-state.d.ts","sourceRoot":"","sources":["../../src/client/use-field-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,YAAY,EAAE,CAAC,GACd,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC,CA0FlF"}
@@ -1,5 +1,5 @@
1
1
  export interface LinkStatus {
2
- pending: boolean;
2
+ isPending: boolean;
3
3
  }
4
4
  /**
5
5
  * React context provided by <Link>. Holds the pending status
@@ -7,10 +7,10 @@ export interface LinkStatus {
7
7
  */
8
8
  export declare const LinkStatusContext: import("react").Context<LinkStatus>;
9
9
  /**
10
- * Returns `{ pending: true }` while the nearest parent `<Link>` component's
10
+ * Returns `{ isPending: true }` while the nearest parent `<Link>` component's
11
11
  * navigation is in flight. Must be used inside a `<Link>` component's children.
12
12
  *
13
- * Unlike `useNavigationPending()` which is global, this hook is scoped to
13
+ * Unlike `usePendingNavigation()` which is global, this hook is scoped to
14
14
  * the nearest parent `<Link>` — only the link the user clicked shows pending.
15
15
  *
16
16
  * ```tsx
@@ -18,8 +18,8 @@ export declare const LinkStatusContext: import("react").Context<LinkStatus>;
18
18
  * import { Link, useLinkStatus } from '@timber-js/app/client'
19
19
  *
20
20
  * function Hint() {
21
- * const { pending } = useLinkStatus()
22
- * return <span className={pending ? 'opacity-50' : ''} />
21
+ * const { isPending } = useLinkStatus()
22
+ * return <span className={isPending ? 'opacity-50' : ''} />
23
23
  * }
24
24
  *
25
25
  * export function NavLink({ href, children }) {
@@ -1 +1 @@
1
- {"version":3,"file":"use-link-status.d.ts","sourceRoot":"","sources":["../../src/client/use-link-status.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qCAAgD,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C"}
1
+ {"version":3,"file":"use-link-status.d.ts","sourceRoot":"","sources":["../../src/client/use-link-status.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qCAAkD,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAE1C"}
@@ -4,24 +4,26 @@
4
4
  * Returns the pathname portion of the current URL (e.g. '/dashboard/settings').
5
5
  * Updates when client-side navigation changes the URL.
6
6
  *
7
- * On the client, reads from NavigationContext which is updated atomically
8
- * with the RSC tree render. This replaces the previous useSyncExternalStore
9
- * approach which only subscribed to popstate events — meaning usePathname()
10
- * did NOT re-render on forward navigation (pushState). The context approach
11
- * fixes this: pathname updates in the same render pass as the new tree.
7
+ * One unconditional read of NavigationContext, on every side (TIM-1425):
12
8
  *
13
- * During SSR, reads the request pathname from the SSR ALS context
14
- * (populated by ssr-entry.ts) instead of window.location.
9
+ * - In the browser, the provider wraps the RSC payload in the router's `renderTree`, so
10
+ * the pathname updates in the same render pass as the new tree.
11
+ * - During SSR, the wrapper chain mounts the same provider with the request's
12
+ * pathname (TIM-1424), so this is the identical code path — no ALS read,
13
+ * no fallback tiers.
14
+ * - In the RSC environment, this module is never evaluated — the shims plugin
15
+ * resolves next/navigation to navigation-rsc.ts, which has a throwing stub
16
+ * (TIM-1420).
17
+ * - Called outside a component entirely, React itself throws its
18
+ * invalid-hook-call error — loud, not guessed-at from window.location.
15
19
  *
16
20
  * Compatible with Next.js's `usePathname()` from `next/navigation`.
17
21
  */
18
22
  /**
19
23
  * Read the current URL pathname.
20
24
  *
21
- * On the client, reads from NavigationContext (provided by
22
- * NavigationProvider in renderRoot). During SSR, reads from the
23
- * ALS-backed SSR data context. Falls back to window.location.pathname
24
- * when called outside a React component (e.g., in tests).
25
+ * Throws when no NavigationProvider is above the caller (a component rendered
26
+ * outside the timber app — in tests, render inside the timber providers).
25
27
  */
26
28
  export declare function usePathname(): string;
27
29
  //# sourceMappingURL=use-pathname.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"use-pathname.d.ts","sourceRoot":"","sources":["../../src/client/use-pathname.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAoBpC"}
1
+ {"version":3,"file":"use-pathname.d.ts","sourceRoot":"","sources":["../../src/client/use-pathname.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAUpC"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Returns true while an RSC navigation is in flight.
3
+ *
4
+ * Reads from the router's external pending store via useSyncExternalStore.
5
+ * Only components that call this hook re-render when pending state
6
+ * changes — no full-tree re-render.
7
+ *
8
+ * ```tsx
9
+ * 'use client'
10
+ * import { usePendingNavigation } from '@timber-js/app/client'
11
+ *
12
+ * export function NavBar() {
13
+ * const isPending = usePendingNavigation()
14
+ * return (
15
+ * <nav className={isPending ? 'opacity-50' : ''}>
16
+ * <Link href="/dashboard">Dashboard</Link>
17
+ * </nav>
18
+ * )
19
+ * }
20
+ * ```
21
+ */
22
+ export declare function usePendingNavigation(): boolean;
23
+ //# sourceMappingURL=use-pending-navigation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-pending-navigation.d.ts","sourceRoot":"","sources":["../../src/client/use-pending-navigation.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}
@@ -7,7 +7,7 @@
7
7
  *
8
8
  * Design doc: design/23-search-params.md §"Codec Bridge"
9
9
  */
10
- import type { SearchParamCodec, SearchParamsDefinition, SetParams, QueryStatesOptions } from '#/search-params/create.js';
10
+ import type { SearchParamCodec, SearchParamsDefinition, SetParams, QueryStatesOptions } from '../search-params/define.ts';
11
11
  /**
12
12
  * Read and write typed search params from/to the URL.
13
13
  *
@@ -16,7 +16,7 @@ import type { SearchParamCodec, SearchParamsDefinition, SetParams, QueryStatesOp
16
16
  *
17
17
  * Usage:
18
18
  * ```ts
19
- * // Via a SearchParamsDefinition
19
+ * // Via a SearchParamsDefinition imported from the route's params.ts
20
20
  * const [params, setParams] = definition.useQueryStates()
21
21
  *
22
22
  * // Standalone with inline codecs
@@ -24,10 +24,16 @@ import type { SearchParamCodec, SearchParamsDefinition, SetParams, QueryStatesOp
24
24
  * page: fromSchema(z.coerce.number().int().min(1).default(1)),
25
25
  * })
26
26
  * ```
27
+ *
28
+ * There is deliberately no route-string form (`useQueryStates('/products')`).
29
+ * Importing the definition from `params.ts` is the documented way to reach
30
+ * another route's codecs — it needs no runtime registry lookup and so has no
31
+ * "not registered yet" failure mode. See design/23-search-params.md
32
+ * §"Client Access".
27
33
  */
28
- export declare function useQueryStates<T extends Record<string, unknown>>(codecsOrRoute: {
34
+ export declare function useQueryStates<T extends Record<string, unknown>>(codecs: {
29
35
  [K in keyof T]: SearchParamCodec<T[K]>;
30
- } | string, _options?: QueryStatesOptions, urlKeys?: Readonly<Record<string, string>>): [T, SetParams<T>];
36
+ }, _options?: QueryStatesOptions, urlKeys?: Readonly<Record<string, string>>): [T, SetParams<T>];
31
37
  /**
32
38
  * Create a useQueryStates binding for a SearchParamsDefinition.
33
39
  * This is used internally by SearchParamsDefinition.useQueryStates().
@@ -1 +1 @@
1
- {"version":3,"file":"use-query-states.d.ts","sourceRoot":"","sources":["../../src/client/use-query-states.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAoCnC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,aAAa,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,MAAM,EAClE,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAyDnB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACpC,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAIrD"}
1
+ {"version":3,"file":"use-query-states.d.ts","sourceRoot":"","sources":["../../src/client/use-query-states.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,EACT,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAkKpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,EAAE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,EAClD,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACzC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CA+FnB;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACpC,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAIrD"}
@@ -14,23 +14,30 @@
14
14
  * In timber, navigation calls reactRoot.render() which is a root-level
15
15
  * render — startTransition has no effect on root renders.
16
16
  *
17
- * Navigation state (params, pathname) is delivered atomically via
17
+ * Navigation state (pathname, search) is delivered atomically via
18
18
  * NavigationContext embedded in the element tree passed to
19
19
  * reactRoot.render(). See design/19-client-navigation.md §"NavigationContext".
20
20
  *
21
21
  * For loading UI during navigation, use:
22
22
  * - useLinkStatus() — per-link pending indicator (inside <Link>)
23
- * - useNavigationPending() — global navigation pending state
23
+ * - usePendingNavigation() — global navigation pending state
24
24
  */
25
+ /** Options for `push` and `replace`. */
26
+ export interface NavigateOptions {
27
+ /** Set to false to keep the scroll position instead of scrolling to top. */
28
+ scroll?: boolean;
29
+ /**
30
+ * View transition types to add to this navigation, beside the router's own
31
+ * `navigation-forward`. See `NavigationOptions.transitionTypes` — they must
32
+ * go here rather than in a `startTransition` around the call.
33
+ */
34
+ transitionTypes?: readonly string[];
35
+ }
25
36
  export interface AppRouterInstance {
26
37
  /** Navigate to a URL, pushing a new history entry */
27
- push(href: string, options?: {
28
- scroll?: boolean;
29
- }): void;
38
+ push(href: string, options?: NavigateOptions): void;
30
39
  /** Navigate to a URL, replacing the current history entry */
31
- replace(href: string, options?: {
32
- scroll?: boolean;
33
- }): void;
40
+ replace(href: string, options?: NavigateOptions): void;
34
41
  /** Refresh the current page (re-fetch RSC payload) */
35
42
  refresh(): void;
36
43
  /** Navigate back in history */
@@ -1 +1 @@
1
- {"version":3,"file":"use-router.d.ts","sourceRoot":"","sources":["../../src/client/use-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CA8C7C"}
1
+ {"version":3,"file":"use-router.d.ts","sourceRoot":"","sources":["../../src/client/use-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpD,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACvD,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;IAChB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,kCAAkC;IAClC,OAAO,IAAI,IAAI,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAuD7C"}
@@ -4,23 +4,30 @@
4
4
  * Returns a read-only URLSearchParams instance reflecting the current
5
5
  * URL's query string. Updates when client-side navigation changes the URL.
6
6
  *
7
- * This is a thin wrapper over window.location.search, provided for
8
- * Next.js API compatibility (libraries like nuqs import useSearchParams
9
- * from next/navigation).
7
+ * One unconditional read of NavigationContext, on every side (TIM-1425):
8
+ *
9
+ * - In the browser, the provider is updated atomically with the RSC tree
10
+ * during full navigations, AND by syncShallowSearch() for shallow URL
11
+ * updates (nuqs shallow: true, replaceUrl, or any external
12
+ * pushState/replaceState that changes the query string). See router-init.ts.
13
+ * - During SSR, the wrapper chain mounts the same provider carrying the
14
+ * request's RAW query string (TIM-1424), so repeated keys
15
+ * (`?tag=a&tag=b`) survive — the collapsed record the ALS context holds
16
+ * cannot represent them.
17
+ * - In the RSC environment, this module is never evaluated — the shims plugin
18
+ * resolves next/navigation to navigation-rsc.ts (TIM-1420).
10
19
  *
11
20
  * Unlike Next.js's ReadonlyURLSearchParams, this returns a standard
12
21
  * URLSearchParams. Mutation methods (set, delete, append) work on the
13
22
  * local copy but do NOT affect the URL — use the router or nuqs for that.
14
23
  *
15
- * During SSR, reads the request search params from the SSR ALS context
16
- * (populated by ssr-entry.ts) instead of window.location.
17
- *
18
- * All mutable state is delegated to client/state.ts for singleton guarantees.
19
- * See design/18-build-system.md §"Singleton State Registry"
24
+ * Compatible with Next.js's `useSearchParams()` from `next/navigation`.
20
25
  */
21
26
  /**
22
27
  * Read the current URL search params.
23
28
  *
29
+ * Throws when no NavigationProvider is above the caller.
30
+ *
24
31
  * Compatible with Next.js's `useSearchParams()` from `next/navigation`.
25
32
  */
26
33
  export declare function useSearchParams(): URLSearchParams;
@@ -1 +1 @@
1
- {"version":3,"file":"use-search-params.d.ts","sourceRoot":"","sources":["../../src/client/use-search-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA+CH;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAMjD"}
1
+ {"version":3,"file":"use-search-params.d.ts","sourceRoot":"","sources":["../../src/client/use-search-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAeH;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAoBjD"}
@@ -0,0 +1,55 @@
1
+ /**
2
+ * useParams() — client-side hook for accessing route params.
3
+ *
4
+ * Returns the dynamic route parameters for the current URL.
5
+ * When called with a route pattern argument, TypeScript narrows
6
+ * the return type to the exact params shape for that route.
7
+ *
8
+ * Two layers of type narrowing work together:
9
+ * 1. The generic overload here uses the Routes interface directly —
10
+ * `useParams<R>()` returns `Routes[R]['segmentParams']`.
11
+ * 2. Build-time codegen generates per-route string-literal overloads
12
+ * in the .d.ts file for IDE autocomplete (see routing/codegen.ts).
13
+ *
14
+ * When the Routes interface is empty (no codegen yet), the generic
15
+ * overload has `keyof Routes = never`, so only the fallback matches.
16
+ *
17
+ * One unconditional read of ParamsContext, on every side (TIM-1425):
18
+ *
19
+ * - In the browser, `PayloadRoot` publishes the payload's params above the
20
+ * merge point on every render path. Params update atomically with the RSC
21
+ * tree — no timing gap (TIM-1294, TIM-1297).
22
+ * - During SSR, the wrapper chain mounts the same `PayloadRoot`, fed the
23
+ * `params` half of `splitPayloadRoot(root)` — the identical derivation
24
+ * the browser performs at hydration (TIM-1424).
25
+ * - In the RSC environment, this module is never evaluated — the shims plugin
26
+ * resolves next/navigation to navigation-rsc.ts (TIM-1420).
27
+ * - Called outside a component entirely, React itself throws its
28
+ * invalid-hook-call error.
29
+ *
30
+ * The module-level subscribe/notify machinery and the `currentParams`
31
+ * snapshot that used to back a fourth fallback tier are gone (TIM-1425):
32
+ * the provider is unconditional on every render path, so nothing read them.
33
+ *
34
+ * Design doc: design/09-typescript.md §"Typed Routes"
35
+ */
36
+ import type { CoercedParams } from '../shared/param-value.ts';
37
+ import type { Routes } from '../index.ts';
38
+ /**
39
+ * Read the current route's dynamic params.
40
+ *
41
+ * The optional `_route` argument exists only for TypeScript narrowing —
42
+ * it does not affect the runtime return value.
43
+ *
44
+ * Throws when no `PayloadRoot` is above the caller (a component rendered
45
+ * outside the timber app — in tests, render inside the timber providers).
46
+ *
47
+ * @overload Typed — when a known segment path is passed, returns the
48
+ * exact params shape from the generated Routes interface.
49
+ * @overload Fallback — returns the generic params record.
50
+ */
51
+ export declare function useSegmentParams<R extends keyof Routes>(segmentPath: R): Routes[R] extends {
52
+ segmentParams: infer P;
53
+ } ? P : CoercedParams;
54
+ export declare function useSegmentParams(segmentPath?: string): CoercedParams;
55
+ //# sourceMappingURL=use-segment-params.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-segment-params.d.ts","sourceRoot":"","sources":["../../src/client/use-segment-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,MAAM,EACrD,WAAW,EAAE,CAAC,GACb,MAAM,CAAC,CAAC,CAAC,SAAS;IAAE,aAAa,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,aAAa,CAAC;AACpE,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC"}