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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1560) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +376 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-DHum77eH.js +1272 -0
  5. package/dist/_chunks/actions-DHum77eH.js.map +1 -0
  6. package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
  7. package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
  8. package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
  9. package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
  10. package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
  11. package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
  12. package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
  13. package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
  14. package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
  15. package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
  16. package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
  17. package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
  18. package/dist/_chunks/chains-D-RRc7CM.js +266 -0
  19. package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
  20. package/dist/_chunks/chains-KblEfYzm.js +1 -0
  21. package/dist/_chunks/classify-_W0RWa5w.js +146 -0
  22. package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
  23. package/dist/_chunks/cli-check-B-JZkpBD.js +251 -0
  24. package/dist/_chunks/cli-check-B-JZkpBD.js.map +1 -0
  25. package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
  26. package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
  27. package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
  28. package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
  29. package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
  30. package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
  31. package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
  33. package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
  34. package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
  35. package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
  36. package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
  37. package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
  38. package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
  39. package/dist/_chunks/codec-registry-CPc6bjVl.js +20 -0
  40. package/dist/_chunks/codec-registry-CPc6bjVl.js.map +1 -0
  41. package/dist/_chunks/codegen-B9oWkWGf.js +429 -0
  42. package/dist/_chunks/codegen-B9oWkWGf.js.map +1 -0
  43. package/dist/_chunks/convention-lint-CrDKERHg.js +578 -0
  44. package/dist/_chunks/convention-lint-CrDKERHg.js.map +1 -0
  45. package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
  46. package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
  47. package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
  48. package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
  49. package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
  50. package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
  51. package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
  52. package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
  53. package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
  54. package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
  55. package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
  56. package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
  57. package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
  58. package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
  59. package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
  60. package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
  61. package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
  62. package/dist/_chunks/format-DuPOoXUP.js +13 -0
  63. package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
  64. package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
  65. package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
  66. package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
  67. package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
  68. package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
  69. package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
  70. package/dist/_chunks/href-validation-CEZy1V-k.js +210 -0
  71. package/dist/_chunks/href-validation-CEZy1V-k.js.map +1 -0
  72. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  73. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  74. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  75. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  76. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  77. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  78. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  79. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  80. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  81. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  82. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  83. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  84. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  85. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  86. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  87. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  88. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  89. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  90. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  91. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  92. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  93. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  94. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  95. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  96. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  97. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  98. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  99. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  100. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  101. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  102. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  103. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  104. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  105. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  106. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  107. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  108. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  109. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  110. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  111. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  112. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  113. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  114. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  115. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  116. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  117. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  118. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  119. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  120. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  121. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  122. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  123. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  124. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  125. package/dist/_chunks/state-B-EBjeER.js +49 -0
  126. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  127. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  128. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  129. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  130. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  131. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  132. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  133. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  134. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  135. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  136. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  137. package/dist/adapters/build-output-helper.d.ts +81 -0
  138. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  139. package/dist/adapters/canonicalize-module.d.ts +8 -0
  140. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  141. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  142. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  143. package/dist/adapters/cloudflare-dev.js +73 -0
  144. package/dist/adapters/cloudflare-dev.js.map +1 -0
  145. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  146. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  148. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  149. package/dist/adapters/cloudflare.d.ts +217 -24
  150. package/dist/adapters/cloudflare.d.ts.map +1 -1
  151. package/dist/adapters/cloudflare.js +1 -188
  152. package/dist/adapters/compress-module.d.ts +25 -4
  153. package/dist/adapters/compress-module.d.ts.map +1 -1
  154. package/dist/adapters/fs-identity.d.ts +63 -0
  155. package/dist/adapters/fs-identity.d.ts.map +1 -0
  156. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  157. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  158. package/dist/adapters/nitro-presets.d.ts +37 -0
  159. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  160. package/dist/adapters/nitro-preview.d.ts +65 -0
  161. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  162. package/dist/adapters/nitro.d.ts +69 -38
  163. package/dist/adapters/nitro.d.ts.map +1 -1
  164. package/dist/adapters/nitro.js +837 -347
  165. package/dist/adapters/nitro.js.map +1 -1
  166. package/dist/adapters/shared.d.ts +85 -0
  167. package/dist/adapters/shared.d.ts.map +1 -0
  168. package/dist/adapters/types.d.ts +124 -16
  169. package/dist/adapters/types.d.ts.map +1 -1
  170. package/dist/adapters/types.js +0 -0
  171. package/dist/analyze/chains.d.ts +124 -0
  172. package/dist/analyze/chains.d.ts.map +1 -0
  173. package/dist/analyze/classify.d.ts +153 -0
  174. package/dist/analyze/classify.d.ts.map +1 -0
  175. package/dist/analyze/crawl-entry.d.ts +17 -0
  176. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  177. package/dist/analyze/crawl-entry.js +312 -0
  178. package/dist/analyze/crawl-entry.js.map +1 -0
  179. package/dist/analyze/crawl.d.ts +134 -0
  180. package/dist/analyze/crawl.d.ts.map +1 -0
  181. package/dist/analyze/graph-cache.d.ts +104 -0
  182. package/dist/analyze/graph-cache.d.ts.map +1 -0
  183. package/dist/analyze/graph-command.d.ts +43 -0
  184. package/dist/analyze/graph-command.d.ts.map +1 -0
  185. package/dist/analyze/graph-command.js +386 -0
  186. package/dist/analyze/graph-command.js.map +1 -0
  187. package/dist/analyze/live-graph.d.ts +81 -0
  188. package/dist/analyze/live-graph.d.ts.map +1 -0
  189. package/dist/analyze/poison-rules.d.ts +72 -0
  190. package/dist/analyze/poison-rules.d.ts.map +1 -0
  191. package/dist/analyze/poison-scan.d.ts +48 -0
  192. package/dist/analyze/poison-scan.d.ts.map +1 -0
  193. package/dist/analyze/scan.d.ts +73 -0
  194. package/dist/analyze/scan.d.ts.map +1 -0
  195. package/dist/cache/cache-api.d.ts +48 -0
  196. package/dist/cache/cache-api.d.ts.map +1 -0
  197. package/dist/cache/fast-hash.d.ts +5 -0
  198. package/dist/cache/fast-hash.d.ts.map +1 -1
  199. package/dist/cache/guarded-read.d.ts +29 -0
  200. package/dist/cache/guarded-read.d.ts.map +1 -0
  201. package/dist/cache/handler-store.d.ts +45 -0
  202. package/dist/cache/handler-store.d.ts.map +1 -0
  203. package/dist/cache/index.d.ts +32 -9
  204. package/dist/cache/index.d.ts.map +1 -1
  205. package/dist/cache/index.js +4 -326
  206. package/dist/cache/invalidation-epoch.d.ts +50 -0
  207. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  208. package/dist/cache/json-lossy-check.d.ts +11 -0
  209. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  210. package/dist/cache/key-discipline.d.ts +61 -0
  211. package/dist/cache/key-discipline.d.ts.map +1 -0
  212. package/dist/cache/redis-handler.d.ts +140 -9
  213. package/dist/cache/redis-handler.d.ts.map +1 -1
  214. package/dist/cache/singleflight.d.ts +31 -2
  215. package/dist/cache/singleflight.d.ts.map +1 -1
  216. package/dist/cache/sizeof.d.ts +22 -0
  217. package/dist/cache/sizeof.d.ts.map +1 -0
  218. package/dist/cache/stable-stringify.d.ts +15 -0
  219. package/dist/cache/stable-stringify.d.ts.map +1 -1
  220. package/dist/cache/store.d.ts +53 -0
  221. package/dist/cache/store.d.ts.map +1 -0
  222. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  223. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  224. package/dist/cache/stores/cloudflare-kv.js +28 -0
  225. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  226. package/dist/cache/stores/memory.d.ts +42 -0
  227. package/dist/cache/stores/memory.d.ts.map +1 -0
  228. package/dist/cache/stores/memory.js +89 -0
  229. package/dist/cache/stores/memory.js.map +1 -0
  230. package/dist/cache/stores/redis.d.ts +69 -0
  231. package/dist/cache/stores/redis.d.ts.map +1 -0
  232. package/dist/cache/stores/redis.js +34 -0
  233. package/dist/cache/stores/redis.js.map +1 -0
  234. package/dist/cache/stores/vercel.d.ts +36 -0
  235. package/dist/cache/stores/vercel.d.ts.map +1 -0
  236. package/dist/cache/stores/vercel.js +32 -0
  237. package/dist/cache/stores/vercel.js.map +1 -0
  238. package/dist/cache/tag-aware-handler.d.ts +51 -0
  239. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  240. package/dist/cache/timber-cache.d.ts +25 -11
  241. package/dist/cache/timber-cache.d.ts.map +1 -1
  242. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  243. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  244. package/dist/cdn/cloudflare-purge.js +29 -0
  245. package/dist/cdn/cloudflare-purge.js.map +1 -0
  246. package/dist/cdn/fastly-purge.d.ts +25 -0
  247. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  248. package/dist/cdn/fastly-purge.js +32 -0
  249. package/dist/cdn/fastly-purge.js.map +1 -0
  250. package/dist/cdn/headers.d.ts +97 -0
  251. package/dist/cdn/headers.d.ts.map +1 -0
  252. package/dist/cdn/index.d.ts +5 -0
  253. package/dist/cdn/index.d.ts.map +1 -0
  254. package/dist/cdn/index.js +93 -0
  255. package/dist/cdn/index.js.map +1 -0
  256. package/dist/cdn/purge-store.d.ts +32 -0
  257. package/dist/cdn/purge-store.d.ts.map +1 -0
  258. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  259. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  260. package/dist/cdn/workers-cache-purge.js +33 -0
  261. package/dist/cdn/workers-cache-purge.js.map +1 -0
  262. package/dist/cli-check.d.ts +133 -0
  263. package/dist/cli-check.d.ts.map +1 -0
  264. package/dist/cli-context.d.ts +62 -0
  265. package/dist/cli-context.d.ts.map +1 -0
  266. package/dist/cli-dev-status.d.ts +75 -0
  267. package/dist/cli-dev-status.d.ts.map +1 -0
  268. package/dist/cli-init.d.ts +72 -0
  269. package/dist/cli-init.d.ts.map +1 -0
  270. package/dist/cli-schema-sync.d.ts +59 -0
  271. package/dist/cli-schema-sync.d.ts.map +1 -0
  272. package/dist/cli.d.ts +80 -16
  273. package/dist/cli.d.ts.map +1 -1
  274. package/dist/cli.js +210 -69
  275. package/dist/cli.js.map +1 -1
  276. package/dist/client/browser-dev.d.ts +42 -2
  277. package/dist/client/browser-dev.d.ts.map +1 -1
  278. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  279. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  280. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  281. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  282. package/dist/client/browser-entry/form-state.d.ts +22 -0
  283. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  284. package/dist/client/browser-entry/hmr.d.ts +27 -0
  285. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  286. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  287. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  288. package/dist/client/browser-entry/index.d.ts +32 -0
  289. package/dist/client/browser-entry/index.d.ts.map +1 -0
  290. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  291. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  292. package/dist/client/browser-entry/router-init.d.ts +41 -0
  293. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  294. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  295. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  296. package/dist/client/browser-entry/scroll.d.ts +28 -0
  297. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  298. package/dist/client/deny-last-resort.d.ts +29 -0
  299. package/dist/client/deny-last-resort.d.ts.map +1 -0
  300. package/dist/client/dev-pill/index.d.ts +32 -0
  301. package/dist/client/dev-pill/index.d.ts.map +1 -0
  302. package/dist/client/dev-pill/store.d.ts +105 -0
  303. package/dist/client/dev-pill/store.d.ts.map +1 -0
  304. package/dist/client/dev-pill/view.d.ts +9 -0
  305. package/dist/client/dev-pill/view.d.ts.map +1 -0
  306. package/dist/client/error-boundary.d.ts +58 -9
  307. package/dist/client/error-boundary.d.ts.map +1 -1
  308. package/dist/client/error-boundary.js +1 -126
  309. package/dist/client/error-reconstituter.d.ts +55 -0
  310. package/dist/client/error-reconstituter.d.ts.map +1 -0
  311. package/dist/client/form.d.ts +38 -99
  312. package/dist/client/form.d.ts.map +1 -1
  313. package/dist/client/global-context.d.ts +35 -0
  314. package/dist/client/global-context.d.ts.map +1 -0
  315. package/dist/client/history.d.ts +50 -9
  316. package/dist/client/history.d.ts.map +1 -1
  317. package/dist/client/index.d.ts +22 -33
  318. package/dist/client/index.d.ts.map +1 -1
  319. package/dist/client/index.js +416 -1241
  320. package/dist/client/index.js.map +1 -1
  321. package/dist/client/internal.d.ts +20 -0
  322. package/dist/client/internal.d.ts.map +1 -0
  323. package/dist/client/internal.js +785 -0
  324. package/dist/client/internal.js.map +1 -0
  325. package/dist/client/link.d.ts +85 -60
  326. package/dist/client/link.d.ts.map +1 -1
  327. package/dist/client/location-search.d.ts +12 -0
  328. package/dist/client/location-search.d.ts.map +1 -0
  329. package/dist/client/navigation-api.d.ts +95 -0
  330. package/dist/client/navigation-api.d.ts.map +1 -0
  331. package/dist/client/navigation-commit.d.ts +111 -0
  332. package/dist/client/navigation-commit.d.ts.map +1 -0
  333. package/dist/client/navigation-context.d.ts +75 -37
  334. package/dist/client/navigation-context.d.ts.map +1 -1
  335. package/dist/client/navigation-root.d.ts +106 -0
  336. package/dist/client/navigation-root.d.ts.map +1 -0
  337. package/dist/client/navigation-transition.d.ts +255 -0
  338. package/dist/client/navigation-transition.d.ts.map +1 -0
  339. package/dist/client/nuqs-adapter.d.ts +5 -2
  340. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  341. package/dist/client/params-context.d.ts +81 -0
  342. package/dist/client/params-context.d.ts.map +1 -0
  343. package/dist/client/react-root.d.ts +51 -0
  344. package/dist/client/react-root.d.ts.map +1 -0
  345. package/dist/client/router-effects.d.ts +203 -0
  346. package/dist/client/router-effects.d.ts.map +1 -0
  347. package/dist/client/router-lifecycle.d.ts +107 -0
  348. package/dist/client/router-lifecycle.d.ts.map +1 -0
  349. package/dist/client/router-pipeline.d.ts +81 -0
  350. package/dist/client/router-pipeline.d.ts.map +1 -0
  351. package/dist/client/router-ref.d.ts +2 -2
  352. package/dist/client/router-ref.d.ts.map +1 -1
  353. package/dist/client/router-skew.d.ts +21 -0
  354. package/dist/client/router-skew.d.ts.map +1 -0
  355. package/dist/client/router-types.d.ts +294 -0
  356. package/dist/client/router-types.d.ts.map +1 -0
  357. package/dist/client/router-url.d.ts +24 -0
  358. package/dist/client/router-url.d.ts.map +1 -0
  359. package/dist/client/router.d.ts +1 -97
  360. package/dist/client/router.d.ts.map +1 -1
  361. package/dist/client/rsc-fetch.d.ts +110 -28
  362. package/dist/client/rsc-fetch.d.ts.map +1 -1
  363. package/dist/client/segment-cache.d.ts +186 -25
  364. package/dist/client/segment-cache.d.ts.map +1 -1
  365. package/dist/client/segment-context.d.ts.map +1 -1
  366. package/dist/client/segment-outlet.d.ts +68 -0
  367. package/dist/client/segment-outlet.d.ts.map +1 -0
  368. package/dist/client/segment-update-context.d.ts +15 -0
  369. package/dist/client/segment-update-context.d.ts.map +1 -0
  370. package/dist/client/shallow-url.d.ts +10 -0
  371. package/dist/client/shallow-url.d.ts.map +1 -0
  372. package/dist/client/slot-content-cache-context.d.ts +35 -0
  373. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  374. package/dist/client/slot-context.d.ts +31 -0
  375. package/dist/client/slot-context.d.ts.map +1 -0
  376. package/dist/client/slot-outlet.d.ts +16 -0
  377. package/dist/client/slot-outlet.d.ts.map +1 -0
  378. package/dist/client/slot-provider.d.ts +25 -0
  379. package/dist/client/slot-provider.d.ts.map +1 -0
  380. package/dist/client/ssr-data.d.ts +26 -50
  381. package/dist/client/ssr-data.d.ts.map +1 -1
  382. package/dist/client/stale-client.d.ts +69 -0
  383. package/dist/client/stale-client.d.ts.map +1 -0
  384. package/dist/client/state.d.ts +21 -13
  385. package/dist/client/state.d.ts.map +1 -1
  386. package/dist/client/status-page-marker.d.ts +25 -0
  387. package/dist/client/status-page-marker.d.ts.map +1 -0
  388. package/dist/client/top-loader.d.ts +7 -6
  389. package/dist/client/top-loader.d.ts.map +1 -1
  390. package/dist/client/unload-guard.d.ts +5 -0
  391. package/dist/client/unload-guard.d.ts.map +1 -1
  392. package/dist/client/use-cookie.d.ts +25 -0
  393. package/dist/client/use-cookie.d.ts.map +1 -1
  394. package/dist/client/use-field-state.d.ts +42 -0
  395. package/dist/client/use-field-state.d.ts.map +1 -0
  396. package/dist/client/use-link-status.d.ts +5 -5
  397. package/dist/client/use-link-status.d.ts.map +1 -1
  398. package/dist/client/use-pathname.d.ts +13 -11
  399. package/dist/client/use-pathname.d.ts.map +1 -1
  400. package/dist/client/use-pending-navigation.d.ts +47 -0
  401. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  402. package/dist/client/use-query-states.d.ts +10 -4
  403. package/dist/client/use-query-states.d.ts.map +1 -1
  404. package/dist/client/use-router.d.ts +15 -8
  405. package/dist/client/use-router.d.ts.map +1 -1
  406. package/dist/client/use-search-params.d.ts +15 -8
  407. package/dist/client/use-search-params.d.ts.map +1 -1
  408. package/dist/client/use-segment-params.d.ts +55 -0
  409. package/dist/client/use-segment-params.d.ts.map +1 -0
  410. package/dist/codec.d.ts +69 -0
  411. package/dist/codec.d.ts.map +1 -0
  412. package/dist/codec.js +75 -0
  413. package/dist/codec.js.map +1 -0
  414. package/dist/config-types.d.ts +366 -0
  415. package/dist/config-types.d.ts.map +1 -0
  416. package/dist/config-validation.d.ts +68 -0
  417. package/dist/config-validation.d.ts.map +1 -0
  418. package/dist/cookies/define-cookie.d.ts +58 -25
  419. package/dist/cookies/define-cookie.d.ts.map +1 -1
  420. package/dist/cookies/index.d.ts +3 -2
  421. package/dist/cookies/index.d.ts.map +1 -1
  422. package/dist/cookies/index.js +230 -37
  423. package/dist/cookies/index.js.map +1 -1
  424. package/dist/cookies/json-cookie.d.ts +64 -0
  425. package/dist/cookies/json-cookie.d.ts.map +1 -0
  426. package/dist/cookies/validation.d.ts +34 -0
  427. package/dist/cookies/validation.d.ts.map +1 -0
  428. package/dist/dev-tools/404-page.d.ts +50 -0
  429. package/dist/dev-tools/404-page.d.ts.map +1 -0
  430. package/dist/dev-tools/await-span.d.ts +17 -0
  431. package/dist/dev-tools/await-span.d.ts.map +1 -0
  432. package/dist/dev-tools/browser-logs.d.ts +40 -0
  433. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  434. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  435. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  436. package/dist/dev-tools/error-page.d.ts +32 -0
  437. package/dist/dev-tools/error-page.d.ts.map +1 -0
  438. package/dist/dev-tools/holding-server.d.ts +46 -0
  439. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  440. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  441. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  442. package/dist/dev-tools/index.d.ts +31 -0
  443. package/dist/dev-tools/index.d.ts.map +1 -0
  444. package/dist/dev-tools/instrumentation.d.ts +74 -0
  445. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  446. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  447. package/dist/dev-tools/logger.d.ts.map +1 -0
  448. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  449. package/dist/dev-tools/logs.d.ts.map +1 -0
  450. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  451. package/dist/dev-tools/overlay.d.ts.map +1 -0
  452. package/dist/dev-tools/span-sink.d.ts +42 -0
  453. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  454. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  455. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  456. package/dist/dev-tools/terminal.d.ts +28 -0
  457. package/dist/dev-tools/terminal.d.ts.map +1 -0
  458. package/dist/fonts/ast-walk.d.ts +68 -0
  459. package/dist/fonts/ast-walk.d.ts.map +1 -0
  460. package/dist/fonts/ast.d.ts +112 -8
  461. package/dist/fonts/ast.d.ts.map +1 -1
  462. package/dist/fonts/bundle.d.ts +50 -0
  463. package/dist/fonts/bundle.d.ts.map +1 -0
  464. package/dist/fonts/css.d.ts +1 -1
  465. package/dist/fonts/dev-middleware.d.ts +22 -0
  466. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  467. package/dist/fonts/fallbacks.d.ts +0 -7
  468. package/dist/fonts/fallbacks.d.ts.map +1 -1
  469. package/dist/fonts/google.d.ts +5 -3
  470. package/dist/fonts/google.d.ts.map +1 -1
  471. package/dist/fonts/local.d.ts +5 -5
  472. package/dist/fonts/local.d.ts.map +1 -1
  473. package/dist/fonts/paths.d.ts +43 -0
  474. package/dist/fonts/paths.d.ts.map +1 -0
  475. package/dist/fonts/pipeline.d.ts +177 -0
  476. package/dist/fonts/pipeline.d.ts.map +1 -0
  477. package/dist/fonts/transform.d.ts +82 -0
  478. package/dist/fonts/transform.d.ts.map +1 -0
  479. package/dist/fonts/types.d.ts +47 -1
  480. package/dist/fonts/types.d.ts.map +1 -1
  481. package/dist/fonts/virtual-modules.d.ts +77 -0
  482. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  483. package/dist/index.d.ts +35 -181
  484. package/dist/index.d.ts.map +1 -1
  485. package/dist/index.js +9949 -14264
  486. package/dist/index.js.map +1 -1
  487. package/dist/params/codec-registry.d.ts +26 -0
  488. package/dist/params/codec-registry.d.ts.map +1 -0
  489. package/dist/params/define-schema.d.ts +81 -0
  490. package/dist/params/define-schema.d.ts.map +1 -0
  491. package/dist/params/index.d.ts +5 -0
  492. package/dist/params/index.d.ts.map +1 -0
  493. package/dist/params/index.js +33 -0
  494. package/dist/params/index.js.map +1 -0
  495. package/dist/params/resolve-schema.d.ts +34 -0
  496. package/dist/params/resolve-schema.d.ts.map +1 -0
  497. package/dist/plugin-context.d.ts +269 -0
  498. package/dist/plugin-context.d.ts.map +1 -0
  499. package/dist/plugins/build-manifest.d.ts +7 -3
  500. package/dist/plugins/build-manifest.d.ts.map +1 -1
  501. package/dist/plugins/build-report.d.ts +61 -11
  502. package/dist/plugins/build-report.d.ts.map +1 -1
  503. package/dist/plugins/cache.d.ts +64 -0
  504. package/dist/plugins/cache.d.ts.map +1 -0
  505. package/dist/plugins/callsite-ast.d.ts +117 -0
  506. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  507. package/dist/plugins/callsite-jsx.d.ts +35 -0
  508. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  509. package/dist/plugins/chunks.d.ts +11 -4
  510. package/dist/plugins/chunks.d.ts.map +1 -1
  511. package/dist/plugins/client-chunks.d.ts +40 -0
  512. package/dist/plugins/client-chunks.d.ts.map +1 -0
  513. package/dist/plugins/client-dep-entries.d.ts +80 -0
  514. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  515. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  516. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  517. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  518. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  519. package/dist/plugins/content.d.ts +1 -1
  520. package/dist/plugins/content.d.ts.map +1 -1
  521. package/dist/plugins/dev-await.d.ts +81 -0
  522. package/dist/plugins/dev-await.d.ts.map +1 -0
  523. package/dist/plugins/dev-discovery.d.ts +187 -0
  524. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  525. package/dist/plugins/dev-hostname.d.ts +152 -0
  526. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  527. package/dist/plugins/dev-server.d.ts +29 -2
  528. package/dist/plugins/dev-server.d.ts.map +1 -1
  529. package/dist/plugins/dev-store-clear.d.ts +83 -0
  530. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  531. package/dist/plugins/encryption-runtime.d.ts +13 -0
  532. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  533. package/dist/plugins/entries.d.ts +40 -4
  534. package/dist/plugins/entries.d.ts.map +1 -1
  535. package/dist/plugins/fonts.d.ts +35 -74
  536. package/dist/plugins/fonts.d.ts.map +1 -1
  537. package/dist/plugins/graph-endpoint.d.ts +114 -0
  538. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  539. package/dist/plugins/mdx.d.ts +18 -5
  540. package/dist/plugins/mdx.d.ts.map +1 -1
  541. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  542. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  543. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  544. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  545. package/dist/plugins/orphaned-modules.d.ts +57 -0
  546. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  547. package/dist/plugins/post-build.d.ts +110 -0
  548. package/dist/plugins/post-build.d.ts.map +1 -0
  549. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  550. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  551. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  552. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt.d.ts +98 -0
  554. package/dist/plugins/prebuilt.d.ts.map +1 -0
  555. package/dist/plugins/prerender-sugar.d.ts +39 -0
  556. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  557. package/dist/plugins/react-resolve.d.ts +49 -0
  558. package/dist/plugins/react-resolve.d.ts.map +1 -0
  559. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  560. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  561. package/dist/plugins/request-dep/index.d.ts +75 -0
  562. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/origin.d.ts +61 -0
  564. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  565. package/dist/plugins/routing.d.ts +2 -2
  566. package/dist/plugins/routing.d.ts.map +1 -1
  567. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  568. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  569. package/dist/plugins/server-bundle.d.ts +1 -1
  570. package/dist/plugins/server-bundle.d.ts.map +1 -1
  571. package/dist/plugins/shims.d.ts +29 -5
  572. package/dist/plugins/shims.d.ts.map +1 -1
  573. package/dist/plugins/static-build.d.ts +246 -26
  574. package/dist/plugins/static-build.d.ts.map +1 -1
  575. package/dist/routing/codegen-shared.d.ts +26 -0
  576. package/dist/routing/codegen-shared.d.ts.map +1 -0
  577. package/dist/routing/codegen-types.d.ts +61 -0
  578. package/dist/routing/codegen-types.d.ts.map +1 -0
  579. package/dist/routing/codegen-write.d.ts +42 -0
  580. package/dist/routing/codegen-write.d.ts.map +1 -0
  581. package/dist/routing/codegen.d.ts +8 -3
  582. package/dist/routing/codegen.d.ts.map +1 -1
  583. package/dist/routing/collision-probe.d.ts +104 -0
  584. package/dist/routing/collision-probe.d.ts.map +1 -0
  585. package/dist/routing/collision-spaces.d.ts +26 -0
  586. package/dist/routing/collision-spaces.d.ts.map +1 -0
  587. package/dist/routing/convention-lint.d.ts +55 -0
  588. package/dist/routing/convention-lint.d.ts.map +1 -0
  589. package/dist/routing/export-detect.d.ts +91 -0
  590. package/dist/routing/export-detect.d.ts.map +1 -0
  591. package/dist/routing/file-cache.d.ts +8 -0
  592. package/dist/routing/file-cache.d.ts.map +1 -0
  593. package/dist/routing/index.d.ts +13 -7
  594. package/dist/routing/index.d.ts.map +1 -1
  595. package/dist/routing/index.js +5 -2
  596. package/dist/routing/interception-overlap.d.ts +35 -0
  597. package/dist/routing/interception-overlap.d.ts.map +1 -0
  598. package/dist/routing/interception.d.ts +234 -10
  599. package/dist/routing/interception.d.ts.map +1 -1
  600. package/dist/routing/link-codegen.d.ts +105 -0
  601. package/dist/routing/link-codegen.d.ts.map +1 -0
  602. package/dist/routing/manifest-codegen.d.ts +26 -0
  603. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  604. package/dist/routing/scanner.d.ts +14 -10
  605. package/dist/routing/scanner.d.ts.map +1 -1
  606. package/dist/routing/schema-validation.d.ts +35 -0
  607. package/dist/routing/schema-validation.d.ts.map +1 -0
  608. package/dist/routing/segment-classify.d.ts +114 -0
  609. package/dist/routing/segment-classify.d.ts.map +1 -0
  610. package/dist/routing/segment-codegen.d.ts +38 -0
  611. package/dist/routing/segment-codegen.d.ts.map +1 -0
  612. package/dist/routing/segment-keys.d.ts +118 -0
  613. package/dist/routing/segment-keys.d.ts.map +1 -0
  614. package/dist/routing/slot-placement.d.ts +48 -0
  615. package/dist/routing/slot-placement.d.ts.map +1 -0
  616. package/dist/routing/types.d.ts +81 -26
  617. package/dist/routing/types.d.ts.map +1 -1
  618. package/dist/routing/walkers.d.ts +57 -0
  619. package/dist/routing/walkers.d.ts.map +1 -0
  620. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  621. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  622. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  623. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  624. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  625. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  626. package/dist/rsc-runtime/rsc.d.ts +3 -13
  627. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  628. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  629. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  630. package/dist/rsc-runtime/server-references.d.ts +19 -0
  631. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  632. package/dist/rsc-runtime/ssr.d.ts +7 -10
  633. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  634. package/dist/rsc-runtime/transforms.d.ts +13 -0
  635. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  636. package/dist/schema-bridge.d.ts +154 -0
  637. package/dist/schema-bridge.d.ts.map +1 -0
  638. package/dist/search-params/define.d.ts +262 -0
  639. package/dist/search-params/define.d.ts.map +1 -0
  640. package/dist/search-params/index.d.ts +3 -7
  641. package/dist/search-params/index.d.ts.map +1 -1
  642. package/dist/search-params/index.js +178 -362
  643. package/dist/search-params/index.js.map +1 -1
  644. package/dist/search-params/parse-total.d.ts +81 -0
  645. package/dist/search-params/parse-total.d.ts.map +1 -0
  646. package/dist/search-params/serialize-equal.d.ts +9 -0
  647. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  648. package/dist/search-params/wrappers.d.ts +76 -0
  649. package/dist/search-params/wrappers.d.ts.map +1 -0
  650. package/dist/server/abort-scope.d.ts +27 -0
  651. package/dist/server/abort-scope.d.ts.map +1 -0
  652. package/dist/server/access-gate.d.ts +110 -10
  653. package/dist/server/access-gate.d.ts.map +1 -1
  654. package/dist/server/action-client.d.ts +20 -133
  655. package/dist/server/action-client.d.ts.map +1 -1
  656. package/dist/server/action-encryption.d.ts +76 -0
  657. package/dist/server/action-encryption.d.ts.map +1 -0
  658. package/dist/server/action-handler.d.ts +60 -11
  659. package/dist/server/action-handler.d.ts.map +1 -1
  660. package/dist/server/action-schema.d.ts +126 -0
  661. package/dist/server/action-schema.d.ts.map +1 -0
  662. package/dist/server/action-types.d.ts +108 -0
  663. package/dist/server/action-types.d.ts.map +1 -0
  664. package/dist/server/actions.d.ts +78 -40
  665. package/dist/server/actions.d.ts.map +1 -1
  666. package/dist/server/als-registry.d.ts +189 -17
  667. package/dist/server/als-registry.d.ts.map +1 -1
  668. package/dist/server/body-limits.d.ts.map +1 -1
  669. package/dist/server/build-manifest.d.ts +25 -30
  670. package/dist/server/build-manifest.d.ts.map +1 -1
  671. package/dist/server/canonicalize.d.ts +53 -0
  672. package/dist/server/canonicalize.d.ts.map +1 -1
  673. package/dist/server/chain-url-parts.d.ts +82 -0
  674. package/dist/server/chain-url-parts.d.ts.map +1 -0
  675. package/dist/server/children-interception.d.ts +49 -0
  676. package/dist/server/children-interception.d.ts.map +1 -0
  677. package/dist/server/client-error-message.d.ts +12 -0
  678. package/dist/server/client-error-message.d.ts.map +1 -0
  679. package/dist/server/coalesce-tick.d.ts +40 -0
  680. package/dist/server/coalesce-tick.d.ts.map +1 -0
  681. package/dist/server/compress.d.ts +2 -0
  682. package/dist/server/compress.d.ts.map +1 -1
  683. package/dist/server/cookie-context.d.ts +156 -0
  684. package/dist/server/cookie-context.d.ts.map +1 -0
  685. package/dist/server/cookie-parsing.d.ts +65 -0
  686. package/dist/server/cookie-parsing.d.ts.map +1 -0
  687. package/dist/server/csp-nonce.d.ts +36 -0
  688. package/dist/server/csp-nonce.d.ts.map +1 -0
  689. package/dist/server/csrf.d.ts +58 -15
  690. package/dist/server/csrf.d.ts.map +1 -1
  691. package/dist/server/debug.d.ts +0 -1
  692. package/dist/server/debug.d.ts.map +1 -1
  693. package/dist/server/default-logger.d.ts +23 -0
  694. package/dist/server/default-logger.d.ts.map +1 -0
  695. package/dist/server/default-status-page.d.ts +45 -0
  696. package/dist/server/default-status-page.d.ts.map +1 -0
  697. package/dist/server/deny-boundary.d.ts +257 -0
  698. package/dist/server/deny-boundary.d.ts.map +1 -0
  699. package/dist/server/deny-renderer.d.ts +22 -15
  700. package/dist/server/deny-renderer.d.ts.map +1 -1
  701. package/dist/server/early-hints-sender.d.ts.map +1 -1
  702. package/dist/server/early-hints.d.ts +14 -12
  703. package/dist/server/early-hints.d.ts.map +1 -1
  704. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  705. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  706. package/dist/server/error-response-headers.d.ts +3 -0
  707. package/dist/server/error-response-headers.d.ts.map +1 -0
  708. package/dist/server/fallback-error.d.ts +19 -7
  709. package/dist/server/fallback-error.d.ts.map +1 -1
  710. package/dist/server/flight-injection-state.d.ts +66 -0
  711. package/dist/server/flight-injection-state.d.ts.map +1 -0
  712. package/dist/server/flight-injector-core.d.ts +125 -0
  713. package/dist/server/flight-injector-core.d.ts.map +1 -0
  714. package/dist/server/flight-scripts.d.ts +63 -0
  715. package/dist/server/flight-scripts.d.ts.map +1 -0
  716. package/dist/server/flight-source-node.d.ts +105 -0
  717. package/dist/server/flight-source-node.d.ts.map +1 -0
  718. package/dist/server/flight-source.d.ts +136 -0
  719. package/dist/server/flight-source.d.ts.map +1 -0
  720. package/dist/server/form-data.d.ts +59 -2
  721. package/dist/server/form-data.d.ts.map +1 -1
  722. package/dist/server/form-state-flight.d.ts +32 -0
  723. package/dist/server/form-state-flight.d.ts.map +1 -0
  724. package/dist/server/head-response.d.ts +35 -0
  725. package/dist/server/head-response.d.ts.map +1 -0
  726. package/dist/server/html-injector-core.d.ts +169 -0
  727. package/dist/server/html-injector-core.d.ts.map +1 -0
  728. package/dist/server/html-injectors.d.ts +77 -47
  729. package/dist/server/html-injectors.d.ts.map +1 -1
  730. package/dist/server/index.d.ts +16 -54
  731. package/dist/server/index.d.ts.map +1 -1
  732. package/dist/server/index.js +621 -3009
  733. package/dist/server/index.js.map +1 -1
  734. package/dist/server/instrumentation.d.ts +13 -5
  735. package/dist/server/instrumentation.d.ts.map +1 -1
  736. package/dist/server/interception-gates.d.ts +49 -0
  737. package/dist/server/interception-gates.d.ts.map +1 -0
  738. package/dist/server/internal.d.ts +48 -0
  739. package/dist/server/internal.d.ts.map +1 -0
  740. package/dist/server/internal.js +5094 -0
  741. package/dist/server/internal.js.map +1 -0
  742. package/dist/server/json-status-response.d.ts +34 -0
  743. package/dist/server/json-status-response.d.ts.map +1 -0
  744. package/dist/server/logger.d.ts +105 -7
  745. package/dist/server/logger.d.ts.map +1 -1
  746. package/dist/server/metadata-collector.d.ts +75 -0
  747. package/dist/server/metadata-collector.d.ts.map +1 -0
  748. package/dist/server/metadata-platform.d.ts +2 -2
  749. package/dist/server/metadata-render.d.ts +2 -2
  750. package/dist/server/metadata-render.d.ts.map +1 -1
  751. package/dist/server/metadata-route-links.d.ts +70 -0
  752. package/dist/server/metadata-route-links.d.ts.map +1 -0
  753. package/dist/server/metadata-routes.d.ts +47 -11
  754. package/dist/server/metadata-routes.d.ts.map +1 -1
  755. package/dist/server/metadata-social.d.ts +2 -2
  756. package/dist/server/metadata.d.ts +10 -2
  757. package/dist/server/metadata.d.ts.map +1 -1
  758. package/dist/server/middleware-runner.d.ts +20 -5
  759. package/dist/server/middleware-runner.d.ts.map +1 -1
  760. package/dist/server/node-body-response.d.ts +55 -0
  761. package/dist/server/node-body-response.d.ts.map +1 -0
  762. package/dist/server/node-response.d.ts +62 -0
  763. package/dist/server/node-response.d.ts.map +1 -0
  764. package/dist/server/node-stream-transforms.d.ts +108 -0
  765. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  766. package/dist/server/node-streams-platform.d.ts +21 -0
  767. package/dist/server/node-streams-platform.d.ts.map +1 -0
  768. package/dist/server/param-coercion.d.ts +91 -0
  769. package/dist/server/param-coercion.d.ts.map +1 -0
  770. package/dist/server/pipeline-helpers.d.ts +227 -0
  771. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  772. package/dist/server/pipeline-interception.d.ts +100 -9
  773. package/dist/server/pipeline-interception.d.ts.map +1 -1
  774. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  775. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  776. package/dist/server/pipeline-metadata.d.ts +18 -2
  777. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  778. package/dist/server/pipeline-outcome.d.ts +59 -0
  779. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  780. package/dist/server/pipeline-phases.d.ts +76 -0
  781. package/dist/server/pipeline-phases.d.ts.map +1 -0
  782. package/dist/server/pipeline.d.ts +190 -23
  783. package/dist/server/pipeline.d.ts.map +1 -1
  784. package/dist/server/port-resolution.d.ts +22 -0
  785. package/dist/server/port-resolution.d.ts.map +1 -0
  786. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  787. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  788. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  789. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  790. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  791. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  792. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  793. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  794. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  795. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  796. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  797. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  798. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  799. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  800. package/dist/server/prebuilt/overlay.d.ts +119 -0
  801. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  802. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  803. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  804. package/dist/server/prebuilt/slots.d.ts +105 -0
  805. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  806. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  807. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  808. package/dist/server/prebuilt-builder.d.ts +121 -0
  809. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  810. package/dist/server/prebuilt-runtime.d.ts +105 -0
  811. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  812. package/dist/server/primitives.d.ts +114 -90
  813. package/dist/server/primitives.d.ts.map +1 -1
  814. package/dist/server/publish-params.d.ts +33 -0
  815. package/dist/server/publish-params.d.ts.map +1 -0
  816. package/dist/server/react-cache-bridge.d.ts +59 -0
  817. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  818. package/dist/server/react-cache-scope.d.ts +49 -0
  819. package/dist/server/react-cache-scope.d.ts.map +1 -0
  820. package/dist/server/render-timeout.d.ts +66 -0
  821. package/dist/server/render-timeout.d.ts.map +1 -0
  822. package/dist/server/render-utils.d.ts +56 -0
  823. package/dist/server/render-utils.d.ts.map +1 -0
  824. package/dist/server/request-context.d.ts +167 -103
  825. package/dist/server/request-context.d.ts.map +1 -1
  826. package/dist/server/request-dep.d.ts +15 -0
  827. package/dist/server/request-dep.d.ts.map +1 -0
  828. package/dist/server/response-cache-policy.d.ts +3 -0
  829. package/dist/server/response-cache-policy.d.ts.map +1 -0
  830. package/dist/server/response-framing.d.ts +43 -0
  831. package/dist/server/response-framing.d.ts.map +1 -0
  832. package/dist/server/route-element-builder.d.ts +57 -30
  833. package/dist/server/route-element-builder.d.ts.map +1 -1
  834. package/dist/server/route-element-helpers.d.ts +12 -0
  835. package/dist/server/route-element-helpers.d.ts.map +1 -0
  836. package/dist/server/route-handler.d.ts +9 -3
  837. package/dist/server/route-handler.d.ts.map +1 -1
  838. package/dist/server/route-matcher.d.ts +75 -40
  839. package/dist/server/route-matcher.d.ts.map +1 -1
  840. package/dist/server/route-methods.d.ts +23 -0
  841. package/dist/server/route-methods.d.ts.map +1 -0
  842. package/dist/server/route-module-loader.d.ts +37 -0
  843. package/dist/server/route-module-loader.d.ts.map +1 -0
  844. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  845. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  846. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  847. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  848. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  849. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  850. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  851. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  852. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  853. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  854. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  855. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  856. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  857. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  858. package/dist/server/rsc-entry/index.d.ts +30 -6
  859. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  860. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  861. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  862. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  863. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  865. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  866. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  867. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  869. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  871. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  872. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  873. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  874. package/dist/server/rsc-error-envelope.d.ts +11 -0
  875. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  876. package/dist/server/safe-load.d.ts +39 -0
  877. package/dist/server/safe-load.d.ts.map +1 -0
  878. package/dist/server/schema-introspection.d.ts +68 -0
  879. package/dist/server/schema-introspection.d.ts.map +1 -0
  880. package/dist/server/sensitive-fields.d.ts +88 -0
  881. package/dist/server/sensitive-fields.d.ts.map +1 -0
  882. package/dist/server/signal-identity.d.ts +49 -0
  883. package/dist/server/signal-identity.d.ts.map +1 -0
  884. package/dist/server/sitemap-generator.d.ts +130 -0
  885. package/dist/server/sitemap-generator.d.ts.map +1 -0
  886. package/dist/server/sitemap-handler.d.ts +22 -0
  887. package/dist/server/sitemap-handler.d.ts.map +1 -0
  888. package/dist/server/skippable-prefix.d.ts +29 -0
  889. package/dist/server/skippable-prefix.d.ts.map +1 -0
  890. package/dist/server/slot-interception.d.ts +80 -0
  891. package/dist/server/slot-interception.d.ts.map +1 -0
  892. package/dist/server/slot-resolver.d.ts +138 -7
  893. package/dist/server/slot-resolver.d.ts.map +1 -1
  894. package/dist/server/slot-subtree-contain.d.ts +54 -0
  895. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  896. package/dist/server/ssr-bridge-types.d.ts +213 -0
  897. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  898. package/dist/server/ssr-entry.d.ts +15 -51
  899. package/dist/server/ssr-entry.d.ts.map +1 -1
  900. package/dist/server/ssr-form-state.d.ts +30 -0
  901. package/dist/server/ssr-form-state.d.ts.map +1 -0
  902. package/dist/server/ssr-render.d.ts +42 -12
  903. package/dist/server/ssr-render.d.ts.map +1 -1
  904. package/dist/server/ssr-wrappers.d.ts +92 -0
  905. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  906. package/dist/server/state-tree-diff.d.ts +44 -9
  907. package/dist/server/state-tree-diff.d.ts.map +1 -1
  908. package/dist/server/static-generator.d.ts +112 -0
  909. package/dist/server/static-generator.d.ts.map +1 -0
  910. package/dist/server/static-not-found.d.ts +52 -0
  911. package/dist/server/static-not-found.d.ts.map +1 -0
  912. package/dist/server/status-code-resolver.d.ts +26 -15
  913. package/dist/server/status-code-resolver.d.ts.map +1 -1
  914. package/dist/server/stream-utils.d.ts +93 -0
  915. package/dist/server/stream-utils.d.ts.map +1 -0
  916. package/dist/server/traced-access.d.ts +18 -0
  917. package/dist/server/traced-access.d.ts.map +1 -0
  918. package/dist/server/tracing.d.ts +72 -31
  919. package/dist/server/tracing.d.ts.map +1 -1
  920. package/dist/server/tree-match.d.ts +59 -0
  921. package/dist/server/tree-match.d.ts.map +1 -0
  922. package/dist/server/types.d.ts +90 -8
  923. package/dist/server/types.d.ts.map +1 -1
  924. package/dist/server/utils/element-type.d.ts +50 -0
  925. package/dist/server/utils/element-type.d.ts.map +1 -0
  926. package/dist/server/utils/escape-html.d.ts +14 -0
  927. package/dist/server/utils/escape-html.d.ts.map +1 -0
  928. package/dist/server/version-skew.d.ts +61 -0
  929. package/dist/server/version-skew.d.ts.map +1 -0
  930. package/dist/server/workers-cache-bridge.d.ts +26 -0
  931. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  932. package/dist/shared/als-slots.d.ts +42 -0
  933. package/dist/shared/als-slots.d.ts.map +1 -0
  934. package/dist/shared/base-path.d.ts +56 -0
  935. package/dist/shared/base-path.d.ts.map +1 -0
  936. package/dist/shared/csrf-reject.d.ts +16 -0
  937. package/dist/shared/csrf-reject.d.ts.map +1 -0
  938. package/dist/shared/dev-span.d.ts +99 -0
  939. package/dist/shared/dev-span.d.ts.map +1 -0
  940. package/dist/shared/error-digest.d.ts +28 -0
  941. package/dist/shared/error-digest.d.ts.map +1 -0
  942. package/dist/shared/flight-base64.d.ts +13 -0
  943. package/dist/shared/flight-base64.d.ts.map +1 -0
  944. package/dist/shared/flight-segment.d.ts +18 -0
  945. package/dist/shared/flight-segment.d.ts.map +1 -0
  946. package/dist/shared/form-state-flight.d.ts +32 -0
  947. package/dist/shared/form-state-flight.d.ts.map +1 -0
  948. package/dist/shared/href-validation.d.ts +49 -0
  949. package/dist/shared/href-validation.d.ts.map +1 -0
  950. package/dist/shared/merge-search-params.d.ts +22 -0
  951. package/dist/shared/merge-search-params.d.ts.map +1 -0
  952. package/dist/shared/param-value.d.ts +104 -0
  953. package/dist/shared/param-value.d.ts.map +1 -0
  954. package/dist/shared/payload-root.d.ts +110 -0
  955. package/dist/shared/payload-root.d.ts.map +1 -0
  956. package/dist/shared/redirect-type.d.ts +17 -0
  957. package/dist/shared/redirect-type.d.ts.map +1 -0
  958. package/dist/shared/rsc-cache-key.d.ts +163 -0
  959. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  960. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  961. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  962. package/dist/shared/rsc-manifest.d.ts +28 -0
  963. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  964. package/dist/shared/rsc-media-type.d.ts +52 -0
  965. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  966. package/dist/shared/rsc-payload-path.d.ts +48 -0
  967. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  968. package/dist/shared/segment-info.d.ts +66 -0
  969. package/dist/shared/segment-info.d.ts.map +1 -0
  970. package/dist/shared/slot-params.d.ts +52 -0
  971. package/dist/shared/slot-params.d.ts.map +1 -0
  972. package/dist/shared/static-platform-files.d.ts +71 -0
  973. package/dist/shared/static-platform-files.d.ts.map +1 -0
  974. package/dist/shared/status-reason-phrase.d.ts +26 -0
  975. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  976. package/dist/shims/font-google.d.ts +1 -1
  977. package/dist/shims/font-google.d.ts.map +1 -1
  978. package/dist/shims/font-google.js +41 -0
  979. package/dist/shims/font-google.js.map +1 -0
  980. package/dist/shims/font-local.d.ts +26 -0
  981. package/dist/shims/font-local.d.ts.map +1 -0
  982. package/dist/shims/font-local.js +19 -0
  983. package/dist/shims/font-local.js.map +1 -0
  984. package/dist/shims/headers.d.ts +60 -1
  985. package/dist/shims/headers.d.ts.map +1 -1
  986. package/dist/shims/image.d.ts +120 -120
  987. package/dist/shims/image.d.ts.map +1 -1
  988. package/dist/shims/navigation-client.d.ts +25 -12
  989. package/dist/shims/navigation-client.d.ts.map +1 -1
  990. package/dist/shims/navigation-rsc.d.ts +21 -0
  991. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  992. package/dist/shims/navigation.d.ts +10 -5
  993. package/dist/shims/navigation.d.ts.map +1 -1
  994. package/dist/utils/state-machine.d.ts +80 -0
  995. package/dist/utils/state-machine.d.ts.map +1 -0
  996. package/dist/utils/write-file-atomic.d.ts +17 -0
  997. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  998. package/docs/api/30-api-server.mdx +241 -0
  999. package/docs/api/31-api-client.mdx +225 -0
  1000. package/docs/api/32-api-cache.mdx +341 -0
  1001. package/docs/api/33-api-search-params.mdx +178 -0
  1002. package/docs/api/34-api-config.mdx +421 -0
  1003. package/docs/api/35-api-typescript.mdx +91 -0
  1004. package/docs/api/36-cli.mdx +272 -0
  1005. package/docs/learn/00-introduction.mdx +109 -0
  1006. package/docs/learn/01-quick-start.mdx +94 -0
  1007. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1008. package/docs/learn/03-fetching-data.mdx +227 -0
  1009. package/docs/learn/04-access-control.mdx +115 -0
  1010. package/docs/learn/05-the-flush-point.mdx +175 -0
  1011. package/docs/learn/06-typed-params.mdx +275 -0
  1012. package/docs/learn/07-typed-routes.mdx +108 -0
  1013. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1014. package/docs/learn/09-streaming.mdx +146 -0
  1015. package/docs/learn/10-caching.mdx +303 -0
  1016. package/docs/learn/11-middleware.mdx +166 -0
  1017. package/docs/learn/12-error-handling.mdx +192 -0
  1018. package/docs/learn/13-deploying.mdx +289 -0
  1019. package/llms.txt +55 -0
  1020. package/package.json +120 -29
  1021. package/src/adapters/build-output-helper.ts +375 -0
  1022. package/src/adapters/canonicalize-module.ts +29 -0
  1023. package/src/adapters/cloudflare-dev.ts +183 -0
  1024. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1025. package/src/adapters/cloudflare.ts +799 -151
  1026. package/src/adapters/compress-module.ts +110 -86
  1027. package/src/adapters/fs-identity.ts +155 -0
  1028. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1029. package/src/adapters/nitro-presets.ts +139 -0
  1030. package/src/adapters/nitro-preview.ts +565 -0
  1031. package/src/adapters/nitro.ts +349 -448
  1032. package/src/adapters/raw-imports.d.ts +5 -0
  1033. package/src/adapters/shared.ts +314 -0
  1034. package/src/adapters/types.ts +129 -17
  1035. package/src/adapters/wrangler.d.ts +7 -0
  1036. package/src/analyze/chains.ts +411 -0
  1037. package/src/analyze/classify.ts +259 -0
  1038. package/src/analyze/crawl-entry.ts +68 -0
  1039. package/src/analyze/crawl.ts +500 -0
  1040. package/src/analyze/graph-cache.ts +331 -0
  1041. package/src/analyze/graph-command.ts +654 -0
  1042. package/src/analyze/live-graph.ts +232 -0
  1043. package/src/analyze/poison-rules.ts +165 -0
  1044. package/src/analyze/poison-scan.ts +159 -0
  1045. package/src/analyze/scan.ts +149 -0
  1046. package/src/cache/cache-api.ts +113 -0
  1047. package/src/cache/fast-hash.ts +5 -0
  1048. package/src/cache/guarded-read.ts +44 -0
  1049. package/src/cache/handler-store.ts +113 -0
  1050. package/src/cache/index.ts +93 -20
  1051. package/src/cache/invalidation-epoch.ts +105 -0
  1052. package/src/cache/json-lossy-check.ts +69 -0
  1053. package/src/cache/key-discipline.ts +218 -0
  1054. package/src/cache/redis-handler.ts +193 -19
  1055. package/src/cache/singleflight.ts +85 -7
  1056. package/src/cache/sizeof.ts +35 -0
  1057. package/src/cache/stable-stringify.ts +118 -2
  1058. package/src/cache/store.ts +71 -0
  1059. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1060. package/src/cache/stores/memory.ts +125 -0
  1061. package/src/cache/stores/redis.ts +97 -0
  1062. package/src/cache/stores/vercel.ts +59 -0
  1063. package/src/cache/tag-aware-handler.ts +250 -0
  1064. package/src/cache/timber-cache.ts +218 -47
  1065. package/src/cdn/cloudflare-purge.ts +50 -0
  1066. package/src/cdn/fastly-purge.ts +63 -0
  1067. package/src/cdn/headers.ts +153 -0
  1068. package/src/cdn/index.ts +23 -0
  1069. package/src/cdn/purge-store.ts +62 -0
  1070. package/src/cdn/workers-cache-purge.ts +34 -0
  1071. package/src/cli-check.ts +417 -0
  1072. package/src/cli-context.ts +128 -0
  1073. package/src/cli-dev-status.ts +196 -0
  1074. package/src/cli-init.ts +278 -0
  1075. package/src/cli-schema-sync.ts +401 -0
  1076. package/src/cli.ts +308 -84
  1077. package/src/client/browser-dev.ts +192 -5
  1078. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1079. package/src/client/browser-entry/action-queue.ts +152 -0
  1080. package/src/client/browser-entry/form-state.ts +49 -0
  1081. package/src/client/browser-entry/hmr.ts +82 -0
  1082. package/src/client/browser-entry/hydrate.ts +152 -0
  1083. package/src/client/browser-entry/index.ts +153 -0
  1084. package/src/client/browser-entry/post-hydration.ts +99 -0
  1085. package/src/client/browser-entry/router-init.ts +391 -0
  1086. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1087. package/src/client/browser-entry/scroll.ts +50 -0
  1088. package/src/client/deny-last-resort.tsx +54 -0
  1089. package/src/client/dev-pill/index.ts +128 -0
  1090. package/src/client/dev-pill/store.ts +254 -0
  1091. package/src/client/dev-pill/view.ts +326 -0
  1092. package/src/client/error-boundary.tsx +296 -61
  1093. package/src/client/error-reconstituter.tsx +84 -0
  1094. package/src/client/form.tsx +61 -173
  1095. package/src/client/global-context.ts +59 -0
  1096. package/src/client/history.ts +74 -11
  1097. package/src/client/index.ts +91 -53
  1098. package/src/client/internal.ts +54 -0
  1099. package/src/client/link.tsx +464 -151
  1100. package/src/client/location-search.ts +15 -0
  1101. package/src/client/navigation-api.ts +254 -0
  1102. package/src/client/navigation-commit.ts +318 -0
  1103. package/src/client/navigation-context.ts +71 -142
  1104. package/src/client/navigation-root.tsx +237 -0
  1105. package/src/client/navigation-transition.ts +401 -0
  1106. package/src/client/nuqs-adapter.tsx +62 -32
  1107. package/src/client/params-context.ts +175 -0
  1108. package/src/client/react-root.ts +105 -0
  1109. package/src/client/router-effects.ts +349 -0
  1110. package/src/client/router-lifecycle.ts +394 -0
  1111. package/src/client/router-pipeline.ts +443 -0
  1112. package/src/client/router-ref.ts +3 -3
  1113. package/src/client/router-skew.ts +30 -0
  1114. package/src/client/router-types.ts +326 -0
  1115. package/src/client/router-url.ts +32 -0
  1116. package/src/client/router.ts +491 -421
  1117. package/src/client/rsc-fetch.ts +510 -109
  1118. package/src/client/segment-cache.ts +362 -41
  1119. package/src/client/segment-context.ts +7 -4
  1120. package/src/client/segment-outlet.tsx +96 -0
  1121. package/src/client/segment-update-context.ts +23 -0
  1122. package/src/client/shallow-url.ts +22 -0
  1123. package/src/client/slot-content-cache-context.ts +43 -0
  1124. package/src/client/slot-context.ts +39 -0
  1125. package/src/client/slot-outlet.tsx +22 -0
  1126. package/src/client/slot-provider.tsx +32 -0
  1127. package/src/client/ssr-data.ts +27 -67
  1128. package/src/client/stale-client.ts +191 -0
  1129. package/src/client/state.ts +31 -24
  1130. package/src/client/status-page-marker.tsx +32 -0
  1131. package/src/client/top-loader.tsx +13 -10
  1132. package/src/client/unload-guard.ts +35 -3
  1133. package/src/client/use-cookie.ts +93 -29
  1134. package/src/client/use-field-state.ts +144 -0
  1135. package/src/client/use-link-status.ts +7 -7
  1136. package/src/client/use-pathname.ts +22 -31
  1137. package/src/client/use-pending-navigation.ts +119 -0
  1138. package/src/client/use-query-states.ts +206 -36
  1139. package/src/client/use-router.ts +31 -9
  1140. package/src/client/use-search-params.ts +38 -49
  1141. package/src/client/use-segment-params.ts +69 -0
  1142. package/src/client/use-selected-layout-segment.ts +2 -2
  1143. package/src/codec.ts +149 -0
  1144. package/src/config-types.ts +366 -0
  1145. package/src/config-validation.ts +511 -0
  1146. package/src/cookies/define-cookie.ts +186 -53
  1147. package/src/cookies/index.ts +13 -2
  1148. package/src/cookies/json-cookie.ts +105 -0
  1149. package/src/cookies/validation.ts +192 -0
  1150. package/src/dev-tools/404-page.ts +286 -0
  1151. package/src/dev-tools/await-span.ts +69 -0
  1152. package/src/dev-tools/browser-logs.ts +55 -0
  1153. package/src/dev-tools/dev-page-shell.ts +278 -0
  1154. package/src/dev-tools/error-page.ts +331 -0
  1155. package/src/dev-tools/holding-server.ts +185 -0
  1156. package/src/dev-tools/hydration-overlay.ts +158 -0
  1157. package/src/dev-tools/index.ts +79 -0
  1158. package/src/dev-tools/instrumentation.ts +281 -0
  1159. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1160. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1161. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1162. package/src/dev-tools/span-sink.ts +132 -0
  1163. package/src/dev-tools/stack-classifier.ts +75 -0
  1164. package/src/dev-tools/terminal.ts +182 -0
  1165. package/src/fonts/ast-walk.ts +235 -0
  1166. package/src/fonts/ast.ts +479 -128
  1167. package/src/fonts/bundle.ts +138 -0
  1168. package/src/fonts/css.ts +1 -1
  1169. package/src/fonts/dev-middleware.ts +85 -0
  1170. package/src/fonts/fallbacks.ts +0 -23
  1171. package/src/fonts/google.ts +101 -19
  1172. package/src/fonts/local.ts +12 -11
  1173. package/src/fonts/paths.ts +58 -0
  1174. package/src/fonts/pipeline.ts +348 -0
  1175. package/src/fonts/transform.ts +311 -0
  1176. package/src/fonts/types.ts +52 -1
  1177. package/src/fonts/virtual-modules.ts +179 -0
  1178. package/src/index.ts +498 -380
  1179. package/src/params/codec-registry.ts +34 -0
  1180. package/src/params/define-schema.ts +115 -0
  1181. package/src/params/index.ts +17 -0
  1182. package/src/params/resolve-schema.ts +84 -0
  1183. package/src/plugin-context.ts +509 -0
  1184. package/src/plugins/build-manifest.ts +189 -36
  1185. package/src/plugins/build-report.ts +299 -87
  1186. package/src/plugins/cache.ts +243 -0
  1187. package/src/plugins/callsite-ast.ts +472 -0
  1188. package/src/plugins/callsite-jsx.ts +243 -0
  1189. package/src/plugins/chunks.ts +74 -5
  1190. package/src/plugins/client-chunks.ts +185 -0
  1191. package/src/plugins/client-dep-entries.ts +124 -0
  1192. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1193. package/src/plugins/cloudflare-wasm.ts +141 -0
  1194. package/src/plugins/content.ts +31 -2
  1195. package/src/plugins/dev-await.ts +415 -0
  1196. package/src/plugins/dev-discovery.ts +428 -0
  1197. package/src/plugins/dev-hostname.ts +322 -0
  1198. package/src/plugins/dev-server.ts +471 -100
  1199. package/src/plugins/dev-store-clear.ts +145 -0
  1200. package/src/plugins/encryption-runtime.ts +31 -0
  1201. package/src/plugins/entries.ts +158 -17
  1202. package/src/plugins/fonts.ts +260 -657
  1203. package/src/plugins/graph-endpoint.ts +544 -0
  1204. package/src/plugins/mdx.ts +108 -35
  1205. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1206. package/src/plugins/optimize-package-imports.ts +439 -0
  1207. package/src/plugins/orphaned-modules.ts +78 -0
  1208. package/src/plugins/post-build.ts +327 -0
  1209. package/src/plugins/prebuilt-capture.ts +213 -0
  1210. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1211. package/src/plugins/prebuilt.ts +679 -0
  1212. package/src/plugins/prerender-sugar.ts +348 -0
  1213. package/src/plugins/react-resolve.ts +149 -0
  1214. package/src/plugins/request-dep/analysis.ts +447 -0
  1215. package/src/plugins/request-dep/index.ts +376 -0
  1216. package/src/plugins/request-dep/origin.ts +310 -0
  1217. package/src/plugins/routing.ts +296 -278
  1218. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1219. package/src/plugins/server-bundle.ts +115 -15
  1220. package/src/plugins/shims.ts +257 -97
  1221. package/src/plugins/static-build.ts +681 -71
  1222. package/src/react-canary.d.ts +2 -0
  1223. package/src/routing/codegen-shared.ts +39 -0
  1224. package/src/routing/codegen-types.ts +62 -0
  1225. package/src/routing/codegen-write.ts +163 -0
  1226. package/src/routing/codegen.ts +349 -232
  1227. package/src/routing/collision-probe.ts +438 -0
  1228. package/src/routing/collision-spaces.ts +281 -0
  1229. package/src/routing/convention-lint.ts +649 -0
  1230. package/src/routing/export-detect.ts +536 -0
  1231. package/src/routing/file-cache.ts +23 -0
  1232. package/src/routing/index.ts +16 -7
  1233. package/src/routing/interception-overlap.ts +141 -0
  1234. package/src/routing/interception.ts +1044 -67
  1235. package/src/routing/link-codegen.ts +280 -0
  1236. package/src/routing/manifest-codegen.ts +232 -0
  1237. package/src/routing/scanner.ts +417 -223
  1238. package/src/routing/schema-validation.ts +155 -0
  1239. package/src/routing/segment-classify.ts +280 -0
  1240. package/src/routing/segment-codegen.ts +99 -0
  1241. package/src/routing/segment-keys.ts +186 -0
  1242. package/src/routing/slot-placement.ts +97 -0
  1243. package/src/routing/types.ts +82 -26
  1244. package/src/routing/walkers.ts +98 -0
  1245. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1246. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1247. package/src/rsc-runtime/render-flight.ts +26 -0
  1248. package/src/rsc-runtime/rsc.ts +35 -5
  1249. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1250. package/src/rsc-runtime/server-references.ts +135 -0
  1251. package/src/rsc-runtime/ssr.ts +23 -0
  1252. package/src/rsc-runtime/transforms.ts +13 -0
  1253. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1254. package/src/schema-bridge.ts +437 -0
  1255. package/src/search-params/define.ts +676 -0
  1256. package/src/search-params/index.ts +14 -20
  1257. package/src/search-params/parse-total.ts +91 -0
  1258. package/src/search-params/serialize-equal.ts +14 -0
  1259. package/src/search-params/wrappers.ts +150 -0
  1260. package/src/server/abort-scope.ts +49 -0
  1261. package/src/server/access-gate.tsx +208 -57
  1262. package/src/server/action-client.ts +175 -294
  1263. package/src/server/action-encryption.ts +144 -0
  1264. package/src/server/action-handler.ts +533 -150
  1265. package/src/server/action-schema.ts +203 -0
  1266. package/src/server/action-types.ts +145 -0
  1267. package/src/server/actions.ts +172 -85
  1268. package/src/server/als-registry.ts +245 -30
  1269. package/src/server/body-limits.ts +10 -2
  1270. package/src/server/build-manifest.ts +33 -57
  1271. package/src/server/canonicalize.ts +62 -3
  1272. package/src/server/chain-url-parts.ts +163 -0
  1273. package/src/server/children-interception.ts +116 -0
  1274. package/src/server/client-error-message.ts +18 -0
  1275. package/src/server/coalesce-tick.ts +75 -0
  1276. package/src/server/compress.ts +91 -19
  1277. package/src/server/cookie-context.ts +462 -0
  1278. package/src/server/cookie-parsing.ts +163 -0
  1279. package/src/server/csp-nonce.ts +58 -0
  1280. package/src/server/csrf.ts +238 -37
  1281. package/src/server/debug.ts +0 -1
  1282. package/src/server/default-logger.ts +100 -0
  1283. package/src/server/default-status-page.ts +88 -0
  1284. package/src/server/deny-boundary.ts +527 -0
  1285. package/src/server/deny-renderer.ts +210 -181
  1286. package/src/server/early-hints-sender.ts +4 -3
  1287. package/src/server/early-hints.ts +39 -29
  1288. package/src/server/error-boundary-wrapper.ts +160 -44
  1289. package/src/server/error-response-headers.ts +18 -0
  1290. package/src/server/fallback-error.ts +88 -104
  1291. package/src/server/flight-injection-state.ts +113 -0
  1292. package/src/server/flight-injector-core.ts +332 -0
  1293. package/src/server/flight-scripts.ts +92 -0
  1294. package/src/server/flight-source-node.ts +434 -0
  1295. package/src/server/flight-source.ts +289 -0
  1296. package/src/server/form-data.ts +191 -20
  1297. package/src/server/form-state-flight.ts +67 -0
  1298. package/src/server/head-response.ts +50 -0
  1299. package/src/server/html-injector-core.ts +320 -0
  1300. package/src/server/html-injectors.ts +241 -285
  1301. package/src/server/index.ts +42 -195
  1302. package/src/server/instrumentation.ts +42 -11
  1303. package/src/server/interception-gates.ts +94 -0
  1304. package/src/server/internal.ts +164 -0
  1305. package/src/server/json-status-response.ts +105 -0
  1306. package/src/server/logger.ts +163 -38
  1307. package/src/server/metadata-collector.ts +175 -0
  1308. package/src/server/metadata-platform.ts +2 -2
  1309. package/src/server/metadata-render.ts +30 -8
  1310. package/src/server/metadata-route-links.ts +200 -0
  1311. package/src/server/metadata-routes.ts +114 -24
  1312. package/src/server/metadata-social.ts +2 -2
  1313. package/src/server/metadata.ts +23 -2
  1314. package/src/server/middleware-runner.ts +32 -5
  1315. package/src/server/node-body-response.ts +236 -0
  1316. package/src/server/node-response.ts +93 -0
  1317. package/src/server/node-stream-transforms.ts +340 -0
  1318. package/src/server/node-streams-platform.ts +23 -0
  1319. package/src/server/param-coercion.ts +223 -0
  1320. package/src/server/pipeline-helpers.ts +554 -0
  1321. package/src/server/pipeline-interception.ts +301 -32
  1322. package/src/server/pipeline-metadata-route.ts +242 -0
  1323. package/src/server/pipeline-metadata.ts +30 -4
  1324. package/src/server/pipeline-outcome.ts +290 -0
  1325. package/src/server/pipeline-phases.ts +443 -0
  1326. package/src/server/pipeline.ts +474 -427
  1327. package/src/server/port-resolution.ts +43 -0
  1328. package/src/server/prebuilt/cache-key.ts +340 -0
  1329. package/src/server/prebuilt/capture-render.ts +122 -0
  1330. package/src/server/prebuilt/capture-routes.ts +104 -0
  1331. package/src/server/prebuilt/capture-state.ts +196 -0
  1332. package/src/server/prebuilt/dev-store.ts +252 -0
  1333. package/src/server/prebuilt/lifetime.ts +151 -0
  1334. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1335. package/src/server/prebuilt/overlay.ts +290 -0
  1336. package/src/server/prebuilt/payload-source.ts +221 -0
  1337. package/src/server/prebuilt/slots.ts +201 -0
  1338. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1339. package/src/server/prebuilt-builder.ts +515 -0
  1340. package/src/server/prebuilt-runtime.ts +830 -0
  1341. package/src/server/primitives.ts +167 -171
  1342. package/src/server/publish-params.ts +42 -0
  1343. package/src/server/react-cache-bridge.ts +124 -0
  1344. package/src/server/react-cache-scope.ts +104 -0
  1345. package/src/server/render-timeout.ts +123 -0
  1346. package/src/server/render-utils.ts +70 -0
  1347. package/src/server/request-context.ts +321 -323
  1348. package/src/server/request-dep.ts +37 -0
  1349. package/src/server/response-cache-policy.ts +45 -0
  1350. package/src/server/response-framing.ts +59 -0
  1351. package/src/server/route-element-builder.ts +539 -355
  1352. package/src/server/route-element-helpers.ts +37 -0
  1353. package/src/server/route-handler.ts +78 -48
  1354. package/src/server/route-matcher.ts +251 -265
  1355. package/src/server/route-methods.ts +37 -0
  1356. package/src/server/route-module-loader.ts +161 -0
  1357. package/src/server/rsc-cache-key-guard.ts +122 -0
  1358. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1359. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1360. package/src/server/rsc-entry/api-handler.ts +30 -93
  1361. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1362. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1363. package/src/server/rsc-entry/helpers.ts +90 -115
  1364. package/src/server/rsc-entry/index.ts +417 -350
  1365. package/src/server/rsc-entry/render-route.ts +248 -0
  1366. package/src/server/rsc-entry/render-signals.ts +108 -0
  1367. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1368. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1369. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1370. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1371. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1372. package/src/server/rsc-error-envelope.ts +18 -0
  1373. package/src/server/rsc-prop-warnings.ts +1 -1
  1374. package/src/server/safe-load.ts +53 -0
  1375. package/src/server/schema-introspection.ts +393 -0
  1376. package/src/server/sensitive-fields.ts +287 -0
  1377. package/src/server/server-only-guard-noop.js +3 -0
  1378. package/src/server/server-timing.ts +1 -1
  1379. package/src/server/signal-identity.ts +130 -0
  1380. package/src/server/sitemap-generator.ts +337 -0
  1381. package/src/server/sitemap-handler.ts +150 -0
  1382. package/src/server/skippable-prefix.ts +172 -0
  1383. package/src/server/slot-interception.ts +168 -0
  1384. package/src/server/slot-resolver.ts +747 -300
  1385. package/src/server/slot-subtree-contain.ts +273 -0
  1386. package/src/server/ssr-bridge-types.ts +217 -0
  1387. package/src/server/ssr-entry.ts +246 -109
  1388. package/src/server/ssr-form-state.ts +58 -0
  1389. package/src/server/ssr-render.ts +253 -113
  1390. package/src/server/ssr-wrappers.tsx +152 -0
  1391. package/src/server/state-tree-diff.ts +85 -30
  1392. package/src/server/static-generator.ts +680 -0
  1393. package/src/server/static-not-found.ts +134 -0
  1394. package/src/server/status-code-resolver.ts +107 -148
  1395. package/src/server/stream-utils.ts +398 -0
  1396. package/src/server/traced-access.ts +50 -0
  1397. package/src/server/tracing.ts +274 -128
  1398. package/src/server/tree-match.ts +494 -0
  1399. package/src/server/types.ts +97 -11
  1400. package/src/server/utils/element-type.ts +88 -0
  1401. package/src/server/utils/escape-html.ts +20 -0
  1402. package/src/server/version-skew.ts +104 -0
  1403. package/src/server/waituntil-bridge.ts +1 -1
  1404. package/src/server/workers-cache-bridge.ts +33 -0
  1405. package/src/shared/als-slots.ts +74 -0
  1406. package/src/shared/base-path.ts +80 -0
  1407. package/src/shared/csrf-reject.ts +15 -0
  1408. package/src/shared/dev-span.ts +188 -0
  1409. package/src/shared/error-digest.ts +46 -0
  1410. package/src/shared/flight-base64.ts +23 -0
  1411. package/src/shared/flight-segment.ts +35 -0
  1412. package/src/shared/form-state-flight.ts +59 -0
  1413. package/src/shared/href-validation.ts +159 -0
  1414. package/src/shared/merge-search-params.ts +55 -0
  1415. package/src/shared/param-value.ts +281 -0
  1416. package/src/shared/payload-root.ts +153 -0
  1417. package/src/shared/redirect-type.ts +17 -0
  1418. package/src/shared/rsc-cache-key.ts +269 -0
  1419. package/src/shared/rsc-error-envelope.ts +16 -0
  1420. package/src/shared/rsc-manifest.ts +29 -0
  1421. package/src/shared/rsc-media-type.ts +59 -0
  1422. package/src/shared/rsc-payload-path.ts +52 -0
  1423. package/src/shared/segment-info.ts +67 -0
  1424. package/src/shared/slot-params.ts +109 -0
  1425. package/src/shared/static-platform-files.ts +75 -0
  1426. package/src/shared/status-reason-phrase.ts +61 -0
  1427. package/src/shims/font-google.ts +1 -1
  1428. package/src/shims/font-local.ts +34 -0
  1429. package/src/shims/headers.ts +130 -1
  1430. package/src/shims/navigation-client.ts +36 -32
  1431. package/src/shims/navigation-rsc.ts +47 -0
  1432. package/src/shims/navigation.ts +10 -7
  1433. package/src/utils/state-machine.ts +111 -0
  1434. package/src/utils/write-file-atomic.ts +32 -0
  1435. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1436. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1437. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1438. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1439. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1440. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1441. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1442. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1443. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1444. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1445. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1446. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1447. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1448. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1449. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1450. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1451. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1452. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1453. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1454. package/dist/adapters/cloudflare.js.map +0 -1
  1455. package/dist/cache/index.js.map +0 -1
  1456. package/dist/cache/register-cached-function.d.ts +0 -17
  1457. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1458. package/dist/client/browser-entry.d.ts +0 -21
  1459. package/dist/client/browser-entry.d.ts.map +0 -1
  1460. package/dist/client/error-boundary.js.map +0 -1
  1461. package/dist/client/head.d.ts +0 -16
  1462. package/dist/client/head.d.ts.map +0 -1
  1463. package/dist/client/link-status-provider.d.ts +0 -11
  1464. package/dist/client/link-status-provider.d.ts.map +0 -1
  1465. package/dist/client/segment-merger.d.ts +0 -119
  1466. package/dist/client/segment-merger.d.ts.map +0 -1
  1467. package/dist/client/stale-reload.d.ts +0 -44
  1468. package/dist/client/stale-reload.d.ts.map +0 -1
  1469. package/dist/client/transition-root.d.ts +0 -74
  1470. package/dist/client/transition-root.d.ts.map +0 -1
  1471. package/dist/client/types.d.ts +0 -14
  1472. package/dist/client/types.d.ts.map +0 -1
  1473. package/dist/client/use-navigation-pending.d.ts +0 -26
  1474. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1475. package/dist/client/use-params.d.ts +0 -92
  1476. package/dist/client/use-params.d.ts.map +0 -1
  1477. package/dist/content/index.d.ts +0 -11
  1478. package/dist/content/index.d.ts.map +0 -1
  1479. package/dist/content/index.js +0 -2
  1480. package/dist/plugins/adapter-build.d.ts +0 -18
  1481. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1482. package/dist/plugins/cache-transform.d.ts +0 -36
  1483. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1484. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1485. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1486. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1487. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1488. package/dist/plugins/server-action-exports.d.ts +0 -26
  1489. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1490. package/dist/routing/status-file-lint.d.ts +0 -33
  1491. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1492. package/dist/search-params/analyze.d.ts +0 -54
  1493. package/dist/search-params/analyze.d.ts.map +0 -1
  1494. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1495. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1496. package/dist/search-params/codecs.d.ts +0 -53
  1497. package/dist/search-params/codecs.d.ts.map +0 -1
  1498. package/dist/search-params/create.d.ts +0 -106
  1499. package/dist/search-params/create.d.ts.map +0 -1
  1500. package/dist/search-params/registry.d.ts +0 -20
  1501. package/dist/search-params/registry.d.ts.map +0 -1
  1502. package/dist/server/asset-headers.d.ts +0 -42
  1503. package/dist/server/asset-headers.d.ts.map +0 -1
  1504. package/dist/server/client-module-map.d.ts +0 -47
  1505. package/dist/server/client-module-map.d.ts.map +0 -1
  1506. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1507. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1508. package/dist/server/dev-logger.d.ts.map +0 -1
  1509. package/dist/server/dev-span-processor.d.ts +0 -29
  1510. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1511. package/dist/server/dev-warnings.d.ts +0 -129
  1512. package/dist/server/dev-warnings.d.ts.map +0 -1
  1513. package/dist/server/flush.d.ts +0 -74
  1514. package/dist/server/flush.d.ts.map +0 -1
  1515. package/dist/server/form-flash.d.ts +0 -78
  1516. package/dist/server/form-flash.d.ts.map +0 -1
  1517. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1518. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1519. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1520. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1521. package/dist/server/prerender.d.ts +0 -77
  1522. package/dist/server/prerender.d.ts.map +0 -1
  1523. package/dist/server/tree-builder.d.ts +0 -126
  1524. package/dist/server/tree-builder.d.ts.map +0 -1
  1525. package/dist/utils/directive-parser.d.ts +0 -70
  1526. package/dist/utils/directive-parser.d.ts.map +0 -1
  1527. package/src/cache/register-cached-function.ts +0 -103
  1528. package/src/client/browser-entry.ts +0 -678
  1529. package/src/client/head.ts +0 -61
  1530. package/src/client/link-status-provider.tsx +0 -30
  1531. package/src/client/segment-merger.ts +0 -339
  1532. package/src/client/stale-reload.ts +0 -87
  1533. package/src/client/transition-root.tsx +0 -166
  1534. package/src/client/types.ts +0 -21
  1535. package/src/client/use-navigation-pending.ts +0 -38
  1536. package/src/client/use-params.ts +0 -141
  1537. package/src/content/index.ts +0 -13
  1538. package/src/plugins/adapter-build.ts +0 -118
  1539. package/src/plugins/cache-transform.ts +0 -199
  1540. package/src/plugins/dynamic-transform.ts +0 -161
  1541. package/src/plugins/server-action-exports.ts +0 -220
  1542. package/src/routing/status-file-lint.ts +0 -112
  1543. package/src/search-params/analyze.ts +0 -192
  1544. package/src/search-params/builtin-codecs.ts +0 -228
  1545. package/src/search-params/codecs.ts +0 -153
  1546. package/src/search-params/create.ts +0 -321
  1547. package/src/search-params/registry.ts +0 -31
  1548. package/src/server/asset-headers.ts +0 -81
  1549. package/src/server/client-module-map.ts +0 -58
  1550. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1551. package/src/server/dev-span-processor.ts +0 -78
  1552. package/src/server/dev-warnings.ts +0 -283
  1553. package/src/server/flush.ts +0 -182
  1554. package/src/server/form-flash.ts +0 -89
  1555. package/src/server/manifest-status-resolver.ts +0 -215
  1556. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1557. package/src/server/prerender.ts +0 -139
  1558. package/src/server/tree-builder.ts +0 -382
  1559. package/src/shims/server-only-noop.js +0 -6
  1560. package/src/utils/directive-parser.ts +0 -529
@@ -1,13 +1,17 @@
1
- import { i as registerSearchParams, n as useQueryStates, r as getSearchParams } from "../_chunks/use-query-states-D5KaffOK.js";
2
- //#region src/search-params/create.ts
1
+ import { r as getSearchParamsFromAls } from "../_chunks/als-slots-kbQrHTzm.js";
2
+ import { i as isStandardSchema, n as fromSchema, r as isCodec } from "../_chunks/schema-bridge-DyRs3cqy.js";
3
+ import { i as parseTotal, n as useQueryStates, r as serializedEqual } from "../_chunks/use-query-states-pkDV-jSg.js";
4
+ // src/search-params/define.ts
3
5
  /**
4
- * createSearchParams — factory for SearchParamsDefinition<T>.
6
+ * defineSearchParams — factory for SearchParamsDefinition<T>.
5
7
  *
6
8
  * Creates a typed, composable definition for a route's search parameters.
7
- * Supports codec protocol, URL key aliasing, default-omission serialization,
8
- * and composition via .extend() / .pick().
9
+ * Accepts both SearchParamCodec values and Standard Schema objects (Zod,
10
+ * Valibot, ArkType) with auto-detection. Supports URL key aliasing via
11
+ * withUrlKey(), default-omission serialization, and composition via
12
+ * .extend() / .pick().
9
13
  *
10
- * Design doc: design/09-typescript.md §"Typed searchParams — search-params.ts"
14
+ * Design doc: design/23-search-params.md §"defineSearchParams — The Factory"
11
15
  */
12
16
  /**
13
17
  * Convert URLSearchParams or a plain record to a normalized record
@@ -15,7 +19,7 @@ import { i as registerSearchParams, n as useQueryStates, r as getSearchParams }
15
19
  */
16
20
  function normalizeRaw(raw) {
17
21
  if (raw instanceof URLSearchParams) {
18
- const result = {};
22
+ const result = Object.create(null);
19
23
  for (const key of new Set(raw.keys())) {
20
24
  const values = raw.getAll(key);
21
25
  result[key] = values.length === 1 ? values[0] : values;
@@ -28,31 +32,80 @@ function normalizeRaw(raw) {
28
32
  * Compute the serialized default value for a codec. Used for
29
33
  * default-omission: when serialize(value) === serialize(parse(undefined)),
30
34
  * the field is omitted from the URL.
35
+ *
36
+ * Goes through `parseTotal` for the same reason request-time parsing does:
37
+ * a nuqs parser's own `parse` throws on absent input, and this is the
38
+ * absent case by construction.
39
+ *
40
+ * **A codec with no value for an absent param has no default to omit**,
41
+ * and `null` is returned rather than `serialize(null)`. Serializing it
42
+ * makes the "no value" case collide with a real one: `parseAsInteger`
43
+ * serializes `null` as the string `'null'`, so `buildSearchParams({ q:
44
+ * 'null' })` would silently drop a legitimate value (before TIM-1350 the
45
+ * absent parse was `undefined` and the swallowed input was the string
46
+ * `'undefined'` — same defect, a less likely input). Nothing is lost:
47
+ * `buildSearchParams` already skips a field whose `serialize` returns
48
+ * `null`, so a codec that encodes "no value" as an omission behaves
49
+ * identically, and one that encodes it as a real query value now writes
50
+ * it instead of dropping it.
51
+ *
52
+ * Codecs are documented to return a default rather than throw, but a
53
+ * hand-written codec that throws on absent input must not turn definition
54
+ * into a crash — treat its default as null (nothing to omit). `serialize`
55
+ * is inside the try for the same reason.
56
+ *
57
+ * Typed `SearchParamCodec<unknown>` rather than generic on purpose: the
58
+ * absent-input value is whatever the codec's total entry point returns,
59
+ * which for a nuqs parser is `T | null` while its `serialize` declares
60
+ * `T`. Widening to `unknown` states that honestly instead of casting.
31
61
  */
32
62
  function getDefaultSerialized(codec) {
33
- return codec.serialize(codec.parse(void 0));
63
+ try {
64
+ const absent = parseTotal(codec, void 0);
65
+ return absent === null || absent === void 0 ? null : codec.serialize(absent);
66
+ } catch {
67
+ return null;
68
+ }
34
69
  }
35
70
  /**
36
- * Create a SearchParamsDefinition from a codec map and optional URL key aliases.
37
- *
38
- * ```ts
39
- * import { createSearchParams, fromSchema } from '@timber-js/app/search-params'
40
- * import { z } from 'zod/v4'
71
+ * Resolve a field value to a SearchParamCodec. Auto-detects Standard Schema
72
+ * objects and wraps them with fromSchema. Reads .urlKey from codecs.
41
73
  *
42
- * export default createSearchParams({
43
- * page: fromSchema(z.coerce.number().int().min(1).default(1)),
44
- * q: { parse: (v) => v ?? null, serialize: (v) => v },
45
- * }, {
46
- * urlKeys: { q: 'search' },
47
- * })
48
- * ```
74
+ * The returned codec is typed as `SearchParamCodec<unknown>` because the
75
+ * codec map uses that type. Both `fromSchema` results and nuqs parsers may
76
+ * serialize to `string | string[] | null`; `buildSearchParams` handles the
77
+ * union.
49
78
  */
50
- function createSearchParams(codecs, options) {
79
+ function resolveField(fieldName, value) {
80
+ if (isCodec(value)) return {
81
+ codec: value,
82
+ urlKey: value.urlKey
83
+ };
84
+ if (isStandardSchema(value)) return { codec: fromSchema(value) };
85
+ throw new Error(`[timber] defineSearchParams: field '${fieldName}' is not a valid codec or Standard Schema. Expected an object with { parse, serialize } methods, or a Standard Schema object (Zod, Valibot, ArkType).`);
86
+ }
87
+ function defineSearchParams(codecsOrSchema) {
88
+ if (isStandardSchema(codecsOrSchema) && hasShape(codecsOrSchema)) {
89
+ const fieldCodecs = {};
90
+ for (const [key, fieldSchema] of Object.entries(codecsOrSchema.shape)) if (isStandardSchema(fieldSchema)) fieldCodecs[key] = fieldSchema;
91
+ else throw new Error(`[timber] defineSearchParams: field '${key}' in schema.shape is not a Standard Schema. All shape properties must be Standard Schema objects (Zod, Valibot, ArkType).`);
92
+ return defineSearchParamsFromMap(fieldCodecs);
93
+ }
94
+ return defineSearchParamsFromMap(codecsOrSchema);
95
+ }
96
+ /** Check if a schema has a .shape property with object-type values. */
97
+ function hasShape(schema) {
98
+ return typeof schema === "object" && schema !== null && "shape" in schema && typeof schema.shape === "object" && schema.shape !== null;
99
+ }
100
+ function defineSearchParamsFromMap(codecs) {
101
+ const resolvedCodecs = {};
51
102
  const urlKeys = {};
52
- if (options?.urlKeys) {
53
- for (const [k, v] of Object.entries(options.urlKeys)) if (v !== void 0) urlKeys[k] = v;
103
+ for (const [key, value] of Object.entries(codecs)) {
104
+ const resolved = resolveField(key, value);
105
+ resolvedCodecs[key] = resolved.codec;
106
+ if (resolved.urlKey) urlKeys[key] = resolved.urlKey;
54
107
  }
55
- return buildDefinition(codecs, urlKeys);
108
+ return buildDefinition(resolvedCodecs, urlKeys);
56
109
  }
57
110
  /**
58
111
  * Internal: build a SearchParamsDefinition from a typed codec map and url keys.
@@ -63,56 +116,64 @@ function buildDefinition(codecMap, urlKeys) {
63
116
  function getUrlKey(prop) {
64
117
  return urlKeys[prop] ?? prop;
65
118
  }
66
- function parse(raw) {
119
+ function parseSync(raw) {
67
120
  const normalized = normalizeRaw(raw);
68
121
  const result = {};
69
122
  for (const prop of Object.keys(codecMap)) {
70
123
  const rawValue = normalized[getUrlKey(prop)];
71
- result[prop] = codecMap[prop].parse(rawValue);
124
+ result[prop] = parseTotal(codecMap[prop], rawValue);
72
125
  }
73
126
  return result;
74
127
  }
75
- function serialize(values) {
128
+ function parse(raw) {
129
+ if (raw instanceof Promise) return raw.then(parseSync);
130
+ return parseSync(raw);
131
+ }
132
+ function buildSearchParams(values) {
76
133
  const parts = [];
77
134
  for (const prop of Object.keys(codecMap)) {
78
135
  if (!(prop in values)) continue;
79
- const serialized = codecMap[prop].serialize(values[prop]);
80
- if (serialized === defaultSerialized[prop]) continue;
136
+ const codec = codecMap[prop];
137
+ let serialized;
138
+ try {
139
+ serialized = codec.serialize(values[prop]);
140
+ } catch (error) {
141
+ if (error instanceof TypeError) continue;
142
+ throw error;
143
+ }
81
144
  if (serialized === null) continue;
82
- parts.push(`${encodeURIComponent(getUrlKey(prop))}=${encodeURIComponent(serialized)}`);
145
+ if (serializedEqual(serialized, defaultSerialized[prop])) continue;
146
+ const urlKey = encodeURIComponent(getUrlKey(prop));
147
+ if (Array.isArray(serialized)) for (const entry of serialized) parts.push(`${urlKey}=${encodeURIComponent(entry)}`);
148
+ else parts.push(`${urlKey}=${encodeURIComponent(serialized)}`);
83
149
  }
84
150
  return parts.join("&");
85
151
  }
86
152
  function href(pathname, values) {
87
- const qs = serialize(values);
153
+ const qs = buildSearchParams(values);
88
154
  return qs ? `${pathname}?${qs}` : pathname;
89
155
  }
90
- function toSearchParams(values) {
91
- const usp = new URLSearchParams();
92
- for (const prop of Object.keys(codecMap)) {
93
- if (!(prop in values)) continue;
94
- const serialized = codecMap[prop].serialize(values[prop]);
95
- if (serialized === defaultSerialized[prop]) continue;
96
- if (serialized === null) continue;
97
- usp.set(getUrlKey(prop), serialized);
156
+ function extend(newCodecs) {
157
+ const resolvedNewCodecs = {};
158
+ const newUrlKeys = {};
159
+ for (const [key, value] of Object.entries(newCodecs)) {
160
+ const resolved = resolveField(key, value);
161
+ resolvedNewCodecs[key] = resolved.codec;
162
+ if (resolved.urlKey) newUrlKeys[key] = resolved.urlKey;
98
163
  }
99
- return usp;
100
- }
101
- function extend(newCodecs, extendOptions) {
102
- const combinedCodecs = {
164
+ return buildDefinition({
103
165
  ...codecMap,
104
- ...newCodecs
105
- };
106
- const combinedUrlKeys = { ...urlKeys };
107
- if (extendOptions?.urlKeys) {
108
- for (const [k, v] of Object.entries(extendOptions.urlKeys)) if (v !== void 0) combinedUrlKeys[k] = v;
109
- }
110
- return buildDefinition(combinedCodecs, combinedUrlKeys);
166
+ ...resolvedNewCodecs
167
+ }, {
168
+ ...urlKeys,
169
+ ...newUrlKeys
170
+ });
111
171
  }
112
172
  function pick(...keys) {
113
173
  const pickedCodecs = {};
114
174
  const pickedUrlKeys = {};
115
175
  for (const key of keys) {
176
+ if (!(key in codecMap)) throw new Error(`[timber] pick('${key}'): unknown key. Available keys: ${Object.keys(codecMap).map((k) => `'${k}'`).join(", ")}.`);
116
177
  pickedCodecs[key] = codecMap[key];
117
178
  if (key in urlKeys) pickedUrlKeys[key] = urlKeys[key];
118
179
  }
@@ -121,354 +182,109 @@ function buildDefinition(codecMap, urlKeys) {
121
182
  function useQueryStates$1(options) {
122
183
  return useQueryStates(codecMap, options, Object.freeze({ ...urlKeys }));
123
184
  }
185
+ function get() {
186
+ if (typeof window !== "undefined") throw new Error("[timber] searchParams.get() is server-only. Use searchParams.useQueryStates() on the client.");
187
+ return parseSync(getSearchParamsFromAls());
188
+ }
124
189
  return {
125
190
  parse,
191
+ get,
126
192
  useQueryStates: useQueryStates$1,
127
193
  extend,
128
194
  pick,
129
- serialize,
130
195
  href,
131
- toSearchParams,
196
+ buildSearchParams,
132
197
  codecs: codecMap,
133
198
  urlKeys: Object.freeze({ ...urlKeys })
134
199
  };
135
200
  }
136
- //#endregion
137
- //#region src/search-params/codecs.ts
138
- /**
139
- * Zod v4's ~standard.validate() signature includes Promise in the return union
140
- * to satisfy the Standard Schema spec, but in practice Zod always validates
141
- * synchronously for the schema types we use. We assert the result is sync and
142
- * throw if it isn't — search params parsing must be synchronous.
143
- */
144
- function validateSync(schema, value) {
145
- const result = schema["~standard"].validate(value);
146
- if (result instanceof Promise) throw new Error("[timber] fromSchema: schema returned a Promise — only sync schemas are supported for search params.");
147
- return result;
148
- }
149
- /**
150
- * Bridge a Standard Schema-compatible schema (Zod, Valibot, ArkType) to a
151
- * SearchParamCodec.
152
- *
153
- * Parse: coerces the raw URL string through the schema. On validation failure,
154
- * parses `undefined` to get the schema's default value (the schema should have
155
- * a `.default()` call). If that also fails, returns `undefined`.
156
- *
157
- * Serialize: uses `String()` for primitives, `null` for null/undefined.
158
- *
159
- * ```ts
160
- * import { fromSchema } from '@timber-js/app/search-params'
161
- * import { z } from 'zod/v4'
162
- *
163
- * const pageCodec = fromSchema(z.coerce.number().int().min(1).default(1))
164
- * ```
165
- */
166
- function fromSchema(schema) {
167
- return {
168
- parse(value) {
169
- const result = validateSync(schema, Array.isArray(value) ? value[value.length - 1] : value);
170
- if (!result.issues) return result.value;
171
- const defaultResult = validateSync(schema, void 0);
172
- if (!defaultResult.issues) return defaultResult.value;
173
- },
174
- serialize(value) {
175
- if (value === null || value === void 0) return null;
176
- return String(value);
177
- }
178
- };
179
- }
180
- /**
181
- * Bridge a Standard Schema for array values. Handles both single strings
182
- * and repeated query keys (`?tag=a&tag=b`).
183
- *
184
- * ```ts
185
- * import { fromArraySchema } from '@timber-js/app/search-params'
186
- * import { z } from 'zod/v4'
187
- *
188
- * const tagsCodec = fromArraySchema(z.array(z.string()).default([]))
189
- * ```
190
- */
191
- function fromArraySchema(schema) {
192
- return {
193
- parse(value) {
194
- let input = value;
195
- if (typeof value === "string") input = [value];
196
- else if (value === void 0) input = void 0;
197
- const result = validateSync(schema, input);
198
- if (!result.issues) return result.value;
199
- const defaultResult = validateSync(schema, void 0);
200
- if (!defaultResult.issues) return defaultResult.value;
201
- },
202
- serialize(value) {
203
- if (value === null || value === void 0) return null;
204
- if (Array.isArray(value)) return value.length === 0 ? null : value.join(",");
205
- return String(value);
206
- }
207
- };
208
- }
209
- //#endregion
210
- //#region src/search-params/builtin-codecs.ts
211
- /**
212
- * Normalize array inputs to a single string (last value wins, matching
213
- * URLSearchParams.get() semantics). Returns undefined if absent or empty.
214
- */
215
- function normalizeInput(value) {
216
- if (Array.isArray(value)) return value.length > 0 ? value[value.length - 1] : void 0;
217
- return value;
218
- }
219
- /**
220
- * String codec. Returns the raw string value, or null if absent.
221
- *
222
- * ```ts
223
- * import { parseAsString } from '@timber-js/app/search-params'
224
- *
225
- * const def = createSearchParams({ q: parseAsString })
226
- * // ?q=shoes → { q: 'shoes' }
227
- * // (absent) → { q: null }
228
- * ```
229
- */
230
- var parseAsString = {
231
- parse(value) {
232
- const v = normalizeInput(value);
233
- return v !== void 0 ? v : null;
234
- },
235
- serialize(value) {
236
- return value;
237
- }
238
- };
201
+ // src/search-params/wrappers.ts
239
202
  /**
240
- * Integer codec. Parses a base-10 integer, or returns null if absent or
241
- * not a valid integer. Rejects floats, NaN, Infinity, and non-numeric strings.
203
+ * Wrap a nullable codec with a default value. The output type becomes
204
+ * non-nullable, and the wrapper is TOTAL over `string | string[] |
205
+ * undefined` even when the inner codec is not.
242
206
  *
243
- * ```ts
244
- * import { parseAsInteger, withDefault } from '@timber-js/app/search-params'
207
+ * The default is substituted for `null` — the documented "no value"
208
+ * answer — and for `undefined`, which is what an implicitly-optional
209
+ * Standard Schema field and a bare `parseAsString` produce for an absent
210
+ * param. Substituting only for `null` left a field typed non-nullable
211
+ * `string` holding `undefined` (TIM-1350).
245
212
  *
246
- * const def = createSearchParams({ page: withDefault(parseAsInteger, 1) })
247
- * // ?page=2 → { page: 2 }
248
- * // ?page=abc → { page: 1 }
249
- * // (absent) → { page: 1 }
250
- * ```
251
- */
252
- var parseAsInteger = {
253
- parse(value) {
254
- const v = normalizeInput(value);
255
- if (v === void 0 || v === "") return null;
256
- const n = Number(v);
257
- if (!Number.isFinite(n) || !Number.isInteger(n)) return null;
258
- return n;
259
- },
260
- serialize(value) {
261
- return value === null ? null : String(value);
262
- }
263
- };
264
- /**
265
- * Float codec. Parses a finite number, or returns null if absent or invalid.
266
- * Rejects NaN and Infinity.
213
+ * The inner codec is invoked through `parseTotal`, so a nuqs parser gets
214
+ * its own normalization (absent → null, repeated → first value, inner
215
+ * throw → null) before either check applies. That is what makes
216
+ * `withDefault(parseAsBoolean, false)` total; the wrapper itself does NOT
217
+ * catch. A throw from a codec is a deliberate signal — `fromSchema` throws
218
+ * on an async schema, and an app codec may `redirect()` or `notFound()` on
219
+ * a value it refuses — and swallowing it would convert a loud failure into
220
+ * a permanently-default field. design/09 §"The SearchParamCodec Protocol":
221
+ * a codec that throws bubbles as a render-phase error, by design.
267
222
  *
268
- * ```ts
269
- * import { parseAsFloat, withDefault } from '@timber-js/app/search-params'
270
- *
271
- * const def = createSearchParams({ price: withDefault(parseAsFloat, 0) })
272
- * ```
273
- */
274
- var parseAsFloat = {
275
- parse(value) {
276
- const v = normalizeInput(value);
277
- if (v === void 0 || v === "") return null;
278
- const n = Number(v);
279
- if (!Number.isFinite(n)) return null;
280
- return n;
281
- },
282
- serialize(value) {
283
- return value === null ? null : String(value);
284
- }
285
- };
286
- /**
287
- * Boolean codec. Accepts "true"/"1" as true, "false"/"0" as false.
288
- * Returns null for absent or unrecognized values.
223
+ * Works with any codec — nuqs parsers, custom codecs, fromSchema results.
289
224
  *
290
225
  * ```ts
291
- * import { parseAsBoolean, withDefault } from '@timber-js/app/search-params'
292
- *
293
- * const def = createSearchParams({ debug: withDefault(parseAsBoolean, false) })
294
- * // ?debug=true → { debug: true }
295
- * // ?debug=0 → { debug: false }
296
- * ```
297
- */
298
- var parseAsBoolean = {
299
- parse(value) {
300
- const v = normalizeInput(value);
301
- if (v === void 0) return null;
302
- if (v === "true" || v === "1") return true;
303
- if (v === "false" || v === "0") return false;
304
- return null;
305
- },
306
- serialize(value) {
307
- return value === null ? null : String(value);
308
- }
309
- };
310
- /**
311
- * String enum codec. Accepts only values in the provided list.
312
- * Returns null for absent or invalid values.
313
- *
314
- * ```ts
315
- * import { parseAsStringEnum, withDefault } from '@timber-js/app/search-params'
316
- *
317
- * const sortCodec = withDefault(
318
- * parseAsStringEnum(['price', 'name', 'date']),
319
- * 'date'
320
- * )
321
- * ```
322
- */
323
- function parseAsStringEnum(values) {
324
- const allowed = new Set(values);
325
- return {
326
- parse(value) {
327
- const v = normalizeInput(value);
328
- if (v === void 0) return null;
329
- return allowed.has(v) ? v : null;
330
- },
331
- serialize(value) {
332
- return value;
333
- }
334
- };
335
- }
336
- /**
337
- * String literal codec. Functionally identical to parseAsStringEnum but
338
- * accepts `as const` tuples for narrower type inference.
339
- *
340
- * ```ts
341
- * import { parseAsStringLiteral } from '@timber-js/app/search-params'
342
- *
343
- * const sizes = ['sm', 'md', 'lg', 'xl'] as const
344
- * const codec = parseAsStringLiteral(sizes)
345
- * // Type: SearchParamCodec<'sm' | 'md' | 'lg' | 'xl' | null>
346
- * ```
347
- */
348
- function parseAsStringLiteral(values) {
349
- return parseAsStringEnum(values);
350
- }
351
- /**
352
- * Wrap a nullable codec with a default value. When the inner codec returns
353
- * null, the default is used instead. The output type becomes non-nullable.
354
- *
355
- * ```ts
356
- * import { parseAsInteger, withDefault } from '@timber-js/app/search-params'
226
+ * import { parseAsInteger } from 'nuqs/server'
227
+ * import { withDefault } from '@timber-js/app/search-params'
357
228
  *
358
229
  * const page = withDefault(parseAsInteger, 1)
359
230
  * // page.parse(undefined) → 1 (not null)
360
231
  * // page.parse('5') → 5
361
232
  * ```
233
+ *
234
+ * The signature strips BOTH nullish constituents from the result, not just
235
+ * `null`, because the runtime substitutes for both. An implicitly-optional
236
+ * schema field is a `SearchParamCodec<string | undefined>`, and wrapping it
237
+ * used to yield `SearchParamCodec<string | undefined>` — a field the
238
+ * wrapper guarantees is always present, still typed as maybe-absent.
362
239
  */
363
240
  function withDefault(codec, defaultValue) {
364
- return {
241
+ const wrapped = {
365
242
  parse(value) {
366
- const result = codec.parse(value);
367
- return result === null ? defaultValue : result;
243
+ const result = parseTotal(codec, value);
244
+ return result === null || result === void 0 ? defaultValue : result;
368
245
  },
369
246
  serialize(value) {
370
247
  return codec.serialize(value);
371
248
  }
372
249
  };
250
+ if (codec.urlKey !== void 0) wrapped.urlKey = codec.urlKey;
251
+ return wrapped;
373
252
  }
374
- //#endregion
375
- //#region src/search-params/analyze.ts
376
253
  /**
377
- * Patterns that indicate a valid default export:
254
+ * Attach a URL key alias to a codec. The alias determines what query
255
+ * parameter key is used in the URL, while the TypeScript property name
256
+ * stays descriptive.
378
257
  *
379
- * 1. `export default createSearchParams(...)`
380
- * 2. `export default someVar.extend(...)`
381
- * 3. `export default someVar.pick(...)`
382
- * 4. `export default someVar.extend(...).extend(...)` (chained)
383
- * 5. `export default someVar.extend(...).pick(...)` (chained)
384
- * 6. `export default createSearchParams(...).extend(...)`
258
+ * Aliases travel with codecs through object spread composition — when
259
+ * you spread a bundle containing aliased codecs into defineSearchParams,
260
+ * the aliases come along automatically.
385
261
  *
386
- * Invalid patterns:
387
- * - `export default someFunction(...)` (arbitrary factory)
388
- * - `export default condition ? a : b` (runtime conditional)
389
- * - `export default variable` (opaque reference without call)
390
- */
391
- /**
392
- * Analyze a search-params.ts file source for static analyzability.
393
- *
394
- * @param source - The file content as a string
395
- * @param filePath - Absolute path to the file (for diagnostics)
396
- */
397
- function analyzeSearchParams(source, filePath) {
398
- const defaultExport = extractDefaultExport(stripComments(source));
399
- if (!defaultExport) return {
400
- valid: false,
401
- error: {
402
- filePath,
403
- expression: "(no default export found)",
404
- suggestion: "search-params.ts must have a default export. Use: export default createSearchParams({ ... })"
405
- }
406
- };
407
- if (isValidExpression(defaultExport.trim())) return { valid: true };
408
- return {
409
- valid: false,
410
- error: {
411
- filePath,
412
- expression: defaultExport.trim(),
413
- suggestion: "The default export must be a createSearchParams() call, or a chain of .extend() / .pick() calls on a SearchParamsDefinition. Arbitrary factory functions and runtime conditionals are not supported."
414
- }
415
- };
416
- }
417
- /** Strip single-line and multi-line comments from source. */
418
- function stripComments(source) {
419
- let result = source.replace(/\/\*[\s\S]*?\*\//g, "");
420
- result = result.replace(/\/\/.*$/gm, "");
421
- return result;
422
- }
423
- /**
424
- * Extract the expression from `export default <expr>`.
262
+ * ```ts
263
+ * import { parseAsString } from 'nuqs/server'
264
+ * import { withUrlKey } from '@timber-js/app/search-params'
425
265
  *
426
- * Handles both:
427
- * export default createSearchParams(...)
428
- * export default expr\n (terminated by newline or semicolon before next statement)
429
- */
430
- function extractDefaultExport(source) {
431
- const match = source.match(/export\s+default\s+([\s\S]+?)(?:;|\n(?=export|import|const|let|var|function|class|type|interface|declare))/);
432
- if (match) return match[1];
433
- const fallback = source.match(/export\s+default\s+([\s\S]+)$/);
434
- if (fallback) return fallback[1].replace(/;\s*$/, "");
435
- }
436
- /**
437
- * Check if an expression is a valid statically-analyzable pattern.
266
+ * export const searchable = {
267
+ * q: withUrlKey(parseAsString, 'search'),
268
+ * // ?search=shoes → { q: 'shoes' }
269
+ * }
270
+ * ```
438
271
  *
439
- * Valid patterns:
440
- * - Starts with `createSearchParams(`
441
- * - Contains `.extend(` or `.pick(` chains (possibly starting with createSearchParams or a variable)
442
- * - A variable identifier followed by chaining
443
- */
444
- function isValidExpression(expr) {
445
- const normalized = expr.replace(/\s+/g, " ").trim();
446
- if (normalized.startsWith("createSearchParams(")) return true;
447
- if (/\.(extend|pick)\s*\(/.test(normalized)) {
448
- if (/\?/.test(normalized) && /:/.test(normalized)) return false;
449
- if (/^\s*(function|=>|\()/.test(normalized)) return false;
450
- return true;
451
- }
452
- return false;
453
- }
454
- /**
455
- * Format an AnalyzeError into a human-readable build error message.
272
+ * Composes with withDefault:
273
+ * ```ts
274
+ * import { parseAsInteger } from 'nuqs/server'
275
+ * withUrlKey(withDefault(parseAsInteger, 1), 'p')
276
+ * ```
456
277
  */
457
- function formatAnalyzeError(error) {
458
- return [
459
- `[timber] Non-analyzable search-params.ts`,
460
- ``,
461
- ` File: ${error.filePath}`,
462
- ` Expression: ${error.expression}`,
463
- ``,
464
- ` ${error.suggestion}`,
465
- ``,
466
- ` The framework must be able to statically extract the type from your`,
467
- ` search-params.ts at build time. Dynamic values, conditionals, and`,
468
- ` arbitrary factory functions prevent this analysis.`
469
- ].join("\n");
278
+ function withUrlKey(codecOrSchema, urlKey) {
279
+ const codec = isCodec(codecOrSchema) ? codecOrSchema : isStandardSchema(codecOrSchema) ? fromSchema(codecOrSchema) : codecOrSchema;
280
+ const wrapped = {
281
+ parse: codec.parse.bind(codec),
282
+ serialize: codec.serialize.bind(codec),
283
+ urlKey
284
+ };
285
+ if (typeof codec.parseServerSide === "function") wrapped.parseServerSide = codec.parseServerSide.bind(codec);
286
+ return wrapped;
470
287
  }
471
- //#endregion
472
- export { analyzeSearchParams, createSearchParams, formatAnalyzeError, fromArraySchema, fromSchema, getSearchParams, parseAsBoolean, parseAsFloat, parseAsInteger, parseAsString, parseAsStringEnum, parseAsStringLiteral, registerSearchParams, withDefault };
288
+ export { defineSearchParams, withDefault, withUrlKey };
473
289
 
474
290
  //# sourceMappingURL=index.js.map