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

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 (1575) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +389 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-CYjRMpZI.js +1273 -0
  5. package/dist/_chunks/actions-CYjRMpZI.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-BAKOSTkg.js +251 -0
  24. package/dist/_chunks/cli-check-BAKOSTkg.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-C8hOGmZo.js +13 -0
  40. package/dist/_chunks/codec-registry-C8hOGmZo.js.map +1 -0
  41. package/dist/_chunks/codegen-vaCyFyVN.js +479 -0
  42. package/dist/_chunks/codegen-vaCyFyVN.js.map +1 -0
  43. package/dist/_chunks/convention-lint-D54k6uUM.js +578 -0
  44. package/dist/_chunks/convention-lint-D54k6uUM.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-BtspoNc9.js +164 -0
  71. package/dist/_chunks/href-BtspoNc9.js.map +1 -0
  72. package/dist/_chunks/href-validation-DNg-zV7u.js +102 -0
  73. package/dist/_chunks/href-validation-DNg-zV7u.js.map +1 -0
  74. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  75. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  76. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  77. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  78. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  79. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  80. package/dist/_chunks/merge-search-params-7o_5yX0L.js +111 -0
  81. package/dist/_chunks/merge-search-params-7o_5yX0L.js.map +1 -0
  82. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  83. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  84. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  85. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  86. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  87. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  88. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  89. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  90. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  91. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  92. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  93. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  94. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  95. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  96. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  97. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  98. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  99. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  100. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  101. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  102. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  103. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  104. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  105. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  106. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  107. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  108. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  109. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  110. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  111. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  112. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  113. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  114. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  115. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  116. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  117. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  118. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  119. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  120. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  121. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  122. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  123. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  124. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  125. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  126. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  127. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  128. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  129. package/dist/_chunks/state-B-EBjeER.js +49 -0
  130. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  131. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  132. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  133. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  134. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  135. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  136. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  137. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  138. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  139. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  140. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  141. package/dist/adapters/build-output-helper.d.ts +81 -0
  142. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  143. package/dist/adapters/canonicalize-module.d.ts +8 -0
  144. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  145. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  146. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-dev.js +73 -0
  148. package/dist/adapters/cloudflare-dev.js.map +1 -0
  149. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  150. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  151. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  152. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  153. package/dist/adapters/cloudflare.d.ts +217 -24
  154. package/dist/adapters/cloudflare.d.ts.map +1 -1
  155. package/dist/adapters/cloudflare.js +1 -188
  156. package/dist/adapters/compress-module.d.ts +25 -4
  157. package/dist/adapters/compress-module.d.ts.map +1 -1
  158. package/dist/adapters/fs-identity.d.ts +63 -0
  159. package/dist/adapters/fs-identity.d.ts.map +1 -0
  160. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  161. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  162. package/dist/adapters/nitro-presets.d.ts +37 -0
  163. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  164. package/dist/adapters/nitro-preview.d.ts +65 -0
  165. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  166. package/dist/adapters/nitro.d.ts +69 -38
  167. package/dist/adapters/nitro.d.ts.map +1 -1
  168. package/dist/adapters/nitro.js +837 -347
  169. package/dist/adapters/nitro.js.map +1 -1
  170. package/dist/adapters/shared.d.ts +85 -0
  171. package/dist/adapters/shared.d.ts.map +1 -0
  172. package/dist/adapters/types.d.ts +124 -16
  173. package/dist/adapters/types.d.ts.map +1 -1
  174. package/dist/adapters/types.js +0 -0
  175. package/dist/analyze/chains.d.ts +124 -0
  176. package/dist/analyze/chains.d.ts.map +1 -0
  177. package/dist/analyze/classify.d.ts +153 -0
  178. package/dist/analyze/classify.d.ts.map +1 -0
  179. package/dist/analyze/crawl-entry.d.ts +17 -0
  180. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  181. package/dist/analyze/crawl-entry.js +312 -0
  182. package/dist/analyze/crawl-entry.js.map +1 -0
  183. package/dist/analyze/crawl.d.ts +134 -0
  184. package/dist/analyze/crawl.d.ts.map +1 -0
  185. package/dist/analyze/graph-cache.d.ts +104 -0
  186. package/dist/analyze/graph-cache.d.ts.map +1 -0
  187. package/dist/analyze/graph-command.d.ts +43 -0
  188. package/dist/analyze/graph-command.d.ts.map +1 -0
  189. package/dist/analyze/graph-command.js +386 -0
  190. package/dist/analyze/graph-command.js.map +1 -0
  191. package/dist/analyze/live-graph.d.ts +81 -0
  192. package/dist/analyze/live-graph.d.ts.map +1 -0
  193. package/dist/analyze/poison-rules.d.ts +72 -0
  194. package/dist/analyze/poison-rules.d.ts.map +1 -0
  195. package/dist/analyze/poison-scan.d.ts +48 -0
  196. package/dist/analyze/poison-scan.d.ts.map +1 -0
  197. package/dist/analyze/scan.d.ts +73 -0
  198. package/dist/analyze/scan.d.ts.map +1 -0
  199. package/dist/cache/cache-api.d.ts +48 -0
  200. package/dist/cache/cache-api.d.ts.map +1 -0
  201. package/dist/cache/fast-hash.d.ts +5 -0
  202. package/dist/cache/fast-hash.d.ts.map +1 -1
  203. package/dist/cache/guarded-read.d.ts +29 -0
  204. package/dist/cache/guarded-read.d.ts.map +1 -0
  205. package/dist/cache/handler-store.d.ts +45 -0
  206. package/dist/cache/handler-store.d.ts.map +1 -0
  207. package/dist/cache/index.d.ts +32 -9
  208. package/dist/cache/index.d.ts.map +1 -1
  209. package/dist/cache/index.js +4 -326
  210. package/dist/cache/invalidation-epoch.d.ts +50 -0
  211. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  212. package/dist/cache/json-lossy-check.d.ts +11 -0
  213. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  214. package/dist/cache/key-discipline.d.ts +61 -0
  215. package/dist/cache/key-discipline.d.ts.map +1 -0
  216. package/dist/cache/redis-handler.d.ts +140 -9
  217. package/dist/cache/redis-handler.d.ts.map +1 -1
  218. package/dist/cache/singleflight.d.ts +31 -2
  219. package/dist/cache/singleflight.d.ts.map +1 -1
  220. package/dist/cache/sizeof.d.ts +22 -0
  221. package/dist/cache/sizeof.d.ts.map +1 -0
  222. package/dist/cache/stable-stringify.d.ts +15 -0
  223. package/dist/cache/stable-stringify.d.ts.map +1 -1
  224. package/dist/cache/store.d.ts +53 -0
  225. package/dist/cache/store.d.ts.map +1 -0
  226. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  227. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  228. package/dist/cache/stores/cloudflare-kv.js +28 -0
  229. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  230. package/dist/cache/stores/memory.d.ts +42 -0
  231. package/dist/cache/stores/memory.d.ts.map +1 -0
  232. package/dist/cache/stores/memory.js +89 -0
  233. package/dist/cache/stores/memory.js.map +1 -0
  234. package/dist/cache/stores/redis.d.ts +69 -0
  235. package/dist/cache/stores/redis.d.ts.map +1 -0
  236. package/dist/cache/stores/redis.js +34 -0
  237. package/dist/cache/stores/redis.js.map +1 -0
  238. package/dist/cache/stores/vercel.d.ts +36 -0
  239. package/dist/cache/stores/vercel.d.ts.map +1 -0
  240. package/dist/cache/stores/vercel.js +32 -0
  241. package/dist/cache/stores/vercel.js.map +1 -0
  242. package/dist/cache/tag-aware-handler.d.ts +51 -0
  243. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  244. package/dist/cache/timber-cache.d.ts +25 -11
  245. package/dist/cache/timber-cache.d.ts.map +1 -1
  246. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  247. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  248. package/dist/cdn/cloudflare-purge.js +29 -0
  249. package/dist/cdn/cloudflare-purge.js.map +1 -0
  250. package/dist/cdn/fastly-purge.d.ts +25 -0
  251. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  252. package/dist/cdn/fastly-purge.js +32 -0
  253. package/dist/cdn/fastly-purge.js.map +1 -0
  254. package/dist/cdn/headers.d.ts +97 -0
  255. package/dist/cdn/headers.d.ts.map +1 -0
  256. package/dist/cdn/index.d.ts +5 -0
  257. package/dist/cdn/index.d.ts.map +1 -0
  258. package/dist/cdn/index.js +93 -0
  259. package/dist/cdn/index.js.map +1 -0
  260. package/dist/cdn/purge-store.d.ts +32 -0
  261. package/dist/cdn/purge-store.d.ts.map +1 -0
  262. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  263. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  264. package/dist/cdn/workers-cache-purge.js +33 -0
  265. package/dist/cdn/workers-cache-purge.js.map +1 -0
  266. package/dist/cli-check.d.ts +133 -0
  267. package/dist/cli-check.d.ts.map +1 -0
  268. package/dist/cli-context.d.ts +62 -0
  269. package/dist/cli-context.d.ts.map +1 -0
  270. package/dist/cli-dev-status.d.ts +75 -0
  271. package/dist/cli-dev-status.d.ts.map +1 -0
  272. package/dist/cli-init.d.ts +72 -0
  273. package/dist/cli-init.d.ts.map +1 -0
  274. package/dist/cli-schema-sync.d.ts +59 -0
  275. package/dist/cli-schema-sync.d.ts.map +1 -0
  276. package/dist/cli.d.ts +80 -16
  277. package/dist/cli.d.ts.map +1 -1
  278. package/dist/cli.js +210 -69
  279. package/dist/cli.js.map +1 -1
  280. package/dist/client/browser-dev.d.ts +42 -2
  281. package/dist/client/browser-dev.d.ts.map +1 -1
  282. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  283. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  284. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  285. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  286. package/dist/client/browser-entry/form-state.d.ts +22 -0
  287. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  288. package/dist/client/browser-entry/hmr.d.ts +27 -0
  289. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  290. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  291. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  292. package/dist/client/browser-entry/index.d.ts +32 -0
  293. package/dist/client/browser-entry/index.d.ts.map +1 -0
  294. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  295. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  296. package/dist/client/browser-entry/router-init.d.ts +41 -0
  297. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  298. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  299. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  300. package/dist/client/browser-entry/scroll.d.ts +28 -0
  301. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  302. package/dist/client/deny-last-resort.d.ts +29 -0
  303. package/dist/client/deny-last-resort.d.ts.map +1 -0
  304. package/dist/client/dev-pill/index.d.ts +32 -0
  305. package/dist/client/dev-pill/index.d.ts.map +1 -0
  306. package/dist/client/dev-pill/store.d.ts +105 -0
  307. package/dist/client/dev-pill/store.d.ts.map +1 -0
  308. package/dist/client/dev-pill/view.d.ts +9 -0
  309. package/dist/client/dev-pill/view.d.ts.map +1 -0
  310. package/dist/client/error-boundary.d.ts +58 -9
  311. package/dist/client/error-boundary.d.ts.map +1 -1
  312. package/dist/client/error-boundary.js +1 -126
  313. package/dist/client/error-reconstituter.d.ts +55 -0
  314. package/dist/client/error-reconstituter.d.ts.map +1 -0
  315. package/dist/client/form.d.ts +38 -99
  316. package/dist/client/form.d.ts.map +1 -1
  317. package/dist/client/global-context.d.ts +35 -0
  318. package/dist/client/global-context.d.ts.map +1 -0
  319. package/dist/client/history.d.ts +50 -9
  320. package/dist/client/history.d.ts.map +1 -1
  321. package/dist/client/index.d.ts +23 -33
  322. package/dist/client/index.d.ts.map +1 -1
  323. package/dist/client/index.js +330 -1273
  324. package/dist/client/index.js.map +1 -1
  325. package/dist/client/internal.d.ts +20 -0
  326. package/dist/client/internal.d.ts.map +1 -0
  327. package/dist/client/internal.js +785 -0
  328. package/dist/client/internal.js.map +1 -0
  329. package/dist/client/link.d.ts +75 -71
  330. package/dist/client/link.d.ts.map +1 -1
  331. package/dist/client/location-search.d.ts +12 -0
  332. package/dist/client/location-search.d.ts.map +1 -0
  333. package/dist/client/navigation-api.d.ts +95 -0
  334. package/dist/client/navigation-api.d.ts.map +1 -0
  335. package/dist/client/navigation-commit.d.ts +111 -0
  336. package/dist/client/navigation-commit.d.ts.map +1 -0
  337. package/dist/client/navigation-context.d.ts +75 -37
  338. package/dist/client/navigation-context.d.ts.map +1 -1
  339. package/dist/client/navigation-root.d.ts +106 -0
  340. package/dist/client/navigation-root.d.ts.map +1 -0
  341. package/dist/client/navigation-transition.d.ts +255 -0
  342. package/dist/client/navigation-transition.d.ts.map +1 -0
  343. package/dist/client/nuqs-adapter.d.ts +5 -2
  344. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  345. package/dist/client/params-context.d.ts +81 -0
  346. package/dist/client/params-context.d.ts.map +1 -0
  347. package/dist/client/react-root.d.ts +51 -0
  348. package/dist/client/react-root.d.ts.map +1 -0
  349. package/dist/client/router-effects.d.ts +203 -0
  350. package/dist/client/router-effects.d.ts.map +1 -0
  351. package/dist/client/router-lifecycle.d.ts +107 -0
  352. package/dist/client/router-lifecycle.d.ts.map +1 -0
  353. package/dist/client/router-pipeline.d.ts +81 -0
  354. package/dist/client/router-pipeline.d.ts.map +1 -0
  355. package/dist/client/router-ref.d.ts +2 -2
  356. package/dist/client/router-ref.d.ts.map +1 -1
  357. package/dist/client/router-skew.d.ts +21 -0
  358. package/dist/client/router-skew.d.ts.map +1 -0
  359. package/dist/client/router-types.d.ts +294 -0
  360. package/dist/client/router-types.d.ts.map +1 -0
  361. package/dist/client/router-url.d.ts +24 -0
  362. package/dist/client/router-url.d.ts.map +1 -0
  363. package/dist/client/router.d.ts +1 -97
  364. package/dist/client/router.d.ts.map +1 -1
  365. package/dist/client/rsc-fetch.d.ts +110 -28
  366. package/dist/client/rsc-fetch.d.ts.map +1 -1
  367. package/dist/client/segment-cache.d.ts +186 -25
  368. package/dist/client/segment-cache.d.ts.map +1 -1
  369. package/dist/client/segment-context.d.ts.map +1 -1
  370. package/dist/client/segment-outlet.d.ts +68 -0
  371. package/dist/client/segment-outlet.d.ts.map +1 -0
  372. package/dist/client/segment-update-context.d.ts +15 -0
  373. package/dist/client/segment-update-context.d.ts.map +1 -0
  374. package/dist/client/shallow-url.d.ts +10 -0
  375. package/dist/client/shallow-url.d.ts.map +1 -0
  376. package/dist/client/slot-content-cache-context.d.ts +35 -0
  377. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  378. package/dist/client/slot-context.d.ts +31 -0
  379. package/dist/client/slot-context.d.ts.map +1 -0
  380. package/dist/client/slot-outlet.d.ts +16 -0
  381. package/dist/client/slot-outlet.d.ts.map +1 -0
  382. package/dist/client/slot-provider.d.ts +25 -0
  383. package/dist/client/slot-provider.d.ts.map +1 -0
  384. package/dist/client/ssr-data.d.ts +26 -50
  385. package/dist/client/ssr-data.d.ts.map +1 -1
  386. package/dist/client/stale-client.d.ts +69 -0
  387. package/dist/client/stale-client.d.ts.map +1 -0
  388. package/dist/client/state.d.ts +21 -13
  389. package/dist/client/state.d.ts.map +1 -1
  390. package/dist/client/status-page-marker.d.ts +25 -0
  391. package/dist/client/status-page-marker.d.ts.map +1 -0
  392. package/dist/client/top-loader.d.ts +7 -6
  393. package/dist/client/top-loader.d.ts.map +1 -1
  394. package/dist/client/unload-guard.d.ts +5 -0
  395. package/dist/client/unload-guard.d.ts.map +1 -1
  396. package/dist/client/use-cookie.d.ts +25 -0
  397. package/dist/client/use-cookie.d.ts.map +1 -1
  398. package/dist/client/use-field-state.d.ts +42 -0
  399. package/dist/client/use-field-state.d.ts.map +1 -0
  400. package/dist/client/use-link-status.d.ts +5 -5
  401. package/dist/client/use-link-status.d.ts.map +1 -1
  402. package/dist/client/use-pathname.d.ts +13 -11
  403. package/dist/client/use-pathname.d.ts.map +1 -1
  404. package/dist/client/use-pending-navigation.d.ts +47 -0
  405. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  406. package/dist/client/use-query-states.d.ts +10 -4
  407. package/dist/client/use-query-states.d.ts.map +1 -1
  408. package/dist/client/use-router.d.ts +15 -8
  409. package/dist/client/use-router.d.ts.map +1 -1
  410. package/dist/client/use-search-params.d.ts +15 -8
  411. package/dist/client/use-search-params.d.ts.map +1 -1
  412. package/dist/client/use-segment-params.d.ts +55 -0
  413. package/dist/client/use-segment-params.d.ts.map +1 -0
  414. package/dist/codec.d.ts +69 -0
  415. package/dist/codec.d.ts.map +1 -0
  416. package/dist/codec.js +75 -0
  417. package/dist/codec.js.map +1 -0
  418. package/dist/config-types.d.ts +366 -0
  419. package/dist/config-types.d.ts.map +1 -0
  420. package/dist/config-validation.d.ts +68 -0
  421. package/dist/config-validation.d.ts.map +1 -0
  422. package/dist/cookies/define-cookie.d.ts +58 -25
  423. package/dist/cookies/define-cookie.d.ts.map +1 -1
  424. package/dist/cookies/index.d.ts +3 -2
  425. package/dist/cookies/index.d.ts.map +1 -1
  426. package/dist/cookies/index.js +230 -37
  427. package/dist/cookies/index.js.map +1 -1
  428. package/dist/cookies/json-cookie.d.ts +64 -0
  429. package/dist/cookies/json-cookie.d.ts.map +1 -0
  430. package/dist/cookies/validation.d.ts +34 -0
  431. package/dist/cookies/validation.d.ts.map +1 -0
  432. package/dist/dev-tools/404-page.d.ts +50 -0
  433. package/dist/dev-tools/404-page.d.ts.map +1 -0
  434. package/dist/dev-tools/await-span.d.ts +17 -0
  435. package/dist/dev-tools/await-span.d.ts.map +1 -0
  436. package/dist/dev-tools/browser-logs.d.ts +40 -0
  437. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  438. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  439. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  440. package/dist/dev-tools/error-page.d.ts +32 -0
  441. package/dist/dev-tools/error-page.d.ts.map +1 -0
  442. package/dist/dev-tools/holding-server.d.ts +46 -0
  443. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  444. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  445. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  446. package/dist/dev-tools/index.d.ts +31 -0
  447. package/dist/dev-tools/index.d.ts.map +1 -0
  448. package/dist/dev-tools/instrumentation.d.ts +74 -0
  449. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  450. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  451. package/dist/dev-tools/logger.d.ts.map +1 -0
  452. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  453. package/dist/dev-tools/logs.d.ts.map +1 -0
  454. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  455. package/dist/dev-tools/overlay.d.ts.map +1 -0
  456. package/dist/dev-tools/span-sink.d.ts +42 -0
  457. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  458. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  459. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  460. package/dist/dev-tools/terminal.d.ts +28 -0
  461. package/dist/dev-tools/terminal.d.ts.map +1 -0
  462. package/dist/fonts/ast-walk.d.ts +68 -0
  463. package/dist/fonts/ast-walk.d.ts.map +1 -0
  464. package/dist/fonts/ast.d.ts +112 -8
  465. package/dist/fonts/ast.d.ts.map +1 -1
  466. package/dist/fonts/bundle.d.ts +50 -0
  467. package/dist/fonts/bundle.d.ts.map +1 -0
  468. package/dist/fonts/css.d.ts +1 -1
  469. package/dist/fonts/dev-middleware.d.ts +22 -0
  470. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  471. package/dist/fonts/fallbacks.d.ts +0 -7
  472. package/dist/fonts/fallbacks.d.ts.map +1 -1
  473. package/dist/fonts/google.d.ts +5 -3
  474. package/dist/fonts/google.d.ts.map +1 -1
  475. package/dist/fonts/local.d.ts +5 -5
  476. package/dist/fonts/local.d.ts.map +1 -1
  477. package/dist/fonts/paths.d.ts +43 -0
  478. package/dist/fonts/paths.d.ts.map +1 -0
  479. package/dist/fonts/pipeline.d.ts +177 -0
  480. package/dist/fonts/pipeline.d.ts.map +1 -0
  481. package/dist/fonts/transform.d.ts +82 -0
  482. package/dist/fonts/transform.d.ts.map +1 -0
  483. package/dist/fonts/types.d.ts +47 -1
  484. package/dist/fonts/types.d.ts.map +1 -1
  485. package/dist/fonts/virtual-modules.d.ts +77 -0
  486. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  487. package/dist/index.d.ts +37 -181
  488. package/dist/index.d.ts.map +1 -1
  489. package/dist/index.js +9952 -14264
  490. package/dist/index.js.map +1 -1
  491. package/dist/params/codec-registry.d.ts +36 -0
  492. package/dist/params/codec-registry.d.ts.map +1 -0
  493. package/dist/params/define-schema.d.ts +81 -0
  494. package/dist/params/define-schema.d.ts.map +1 -0
  495. package/dist/params/index.d.ts +4 -0
  496. package/dist/params/index.d.ts.map +1 -0
  497. package/dist/params/index.js +32 -0
  498. package/dist/params/index.js.map +1 -0
  499. package/dist/params/resolve-schema.d.ts +34 -0
  500. package/dist/params/resolve-schema.d.ts.map +1 -0
  501. package/dist/plugin-context.d.ts +269 -0
  502. package/dist/plugin-context.d.ts.map +1 -0
  503. package/dist/plugins/build-manifest.d.ts +7 -3
  504. package/dist/plugins/build-manifest.d.ts.map +1 -1
  505. package/dist/plugins/build-report.d.ts +61 -11
  506. package/dist/plugins/build-report.d.ts.map +1 -1
  507. package/dist/plugins/cache.d.ts +64 -0
  508. package/dist/plugins/cache.d.ts.map +1 -0
  509. package/dist/plugins/callsite-ast.d.ts +117 -0
  510. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  511. package/dist/plugins/callsite-jsx.d.ts +35 -0
  512. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  513. package/dist/plugins/chunks.d.ts +11 -4
  514. package/dist/plugins/chunks.d.ts.map +1 -1
  515. package/dist/plugins/client-chunks.d.ts +40 -0
  516. package/dist/plugins/client-chunks.d.ts.map +1 -0
  517. package/dist/plugins/client-dep-entries.d.ts +80 -0
  518. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  519. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  520. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  521. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  522. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  523. package/dist/plugins/content.d.ts +1 -1
  524. package/dist/plugins/content.d.ts.map +1 -1
  525. package/dist/plugins/dev-await.d.ts +81 -0
  526. package/dist/plugins/dev-await.d.ts.map +1 -0
  527. package/dist/plugins/dev-discovery.d.ts +187 -0
  528. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  529. package/dist/plugins/dev-hostname.d.ts +152 -0
  530. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  531. package/dist/plugins/dev-server.d.ts +29 -2
  532. package/dist/plugins/dev-server.d.ts.map +1 -1
  533. package/dist/plugins/dev-store-clear.d.ts +83 -0
  534. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  535. package/dist/plugins/encryption-runtime.d.ts +13 -0
  536. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  537. package/dist/plugins/entries.d.ts +40 -4
  538. package/dist/plugins/entries.d.ts.map +1 -1
  539. package/dist/plugins/fonts.d.ts +35 -74
  540. package/dist/plugins/fonts.d.ts.map +1 -1
  541. package/dist/plugins/graph-endpoint.d.ts +114 -0
  542. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  543. package/dist/plugins/mdx.d.ts +18 -5
  544. package/dist/plugins/mdx.d.ts.map +1 -1
  545. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  546. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  547. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  548. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  549. package/dist/plugins/orphaned-modules.d.ts +57 -0
  550. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  551. package/dist/plugins/post-build.d.ts +110 -0
  552. package/dist/plugins/post-build.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  554. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  555. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  556. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  557. package/dist/plugins/prebuilt.d.ts +98 -0
  558. package/dist/plugins/prebuilt.d.ts.map +1 -0
  559. package/dist/plugins/prerender-sugar.d.ts +39 -0
  560. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  561. package/dist/plugins/react-resolve.d.ts +49 -0
  562. package/dist/plugins/react-resolve.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  564. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  565. package/dist/plugins/request-dep/index.d.ts +75 -0
  566. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  567. package/dist/plugins/request-dep/origin.d.ts +61 -0
  568. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  569. package/dist/plugins/routing.d.ts +2 -2
  570. package/dist/plugins/routing.d.ts.map +1 -1
  571. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  572. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  573. package/dist/plugins/server-bundle.d.ts +1 -1
  574. package/dist/plugins/server-bundle.d.ts.map +1 -1
  575. package/dist/plugins/shims.d.ts +29 -5
  576. package/dist/plugins/shims.d.ts.map +1 -1
  577. package/dist/plugins/static-build.d.ts +246 -26
  578. package/dist/plugins/static-build.d.ts.map +1 -1
  579. package/dist/routes/href.d.ts +124 -0
  580. package/dist/routes/href.d.ts.map +1 -0
  581. package/dist/routes/index.d.ts +4 -0
  582. package/dist/routes/index.d.ts.map +1 -0
  583. package/dist/routes/index.js +8 -0
  584. package/dist/routes/index.js.map +1 -0
  585. package/dist/routing/codegen-shared.d.ts +26 -0
  586. package/dist/routing/codegen-shared.d.ts.map +1 -0
  587. package/dist/routing/codegen-types.d.ts +61 -0
  588. package/dist/routing/codegen-types.d.ts.map +1 -0
  589. package/dist/routing/codegen-write.d.ts +42 -0
  590. package/dist/routing/codegen-write.d.ts.map +1 -0
  591. package/dist/routing/codegen.d.ts +8 -3
  592. package/dist/routing/codegen.d.ts.map +1 -1
  593. package/dist/routing/collision-probe.d.ts +104 -0
  594. package/dist/routing/collision-probe.d.ts.map +1 -0
  595. package/dist/routing/collision-spaces.d.ts +26 -0
  596. package/dist/routing/collision-spaces.d.ts.map +1 -0
  597. package/dist/routing/convention-lint.d.ts +55 -0
  598. package/dist/routing/convention-lint.d.ts.map +1 -0
  599. package/dist/routing/export-detect.d.ts +91 -0
  600. package/dist/routing/export-detect.d.ts.map +1 -0
  601. package/dist/routing/file-cache.d.ts +8 -0
  602. package/dist/routing/file-cache.d.ts.map +1 -0
  603. package/dist/routing/index.d.ts +13 -7
  604. package/dist/routing/index.d.ts.map +1 -1
  605. package/dist/routing/index.js +5 -2
  606. package/dist/routing/interception-overlap.d.ts +35 -0
  607. package/dist/routing/interception-overlap.d.ts.map +1 -0
  608. package/dist/routing/interception.d.ts +234 -10
  609. package/dist/routing/interception.d.ts.map +1 -1
  610. package/dist/routing/link-codegen.d.ts +136 -0
  611. package/dist/routing/link-codegen.d.ts.map +1 -0
  612. package/dist/routing/manifest-codegen.d.ts +26 -0
  613. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  614. package/dist/routing/scanner.d.ts +14 -10
  615. package/dist/routing/scanner.d.ts.map +1 -1
  616. package/dist/routing/schema-validation.d.ts +35 -0
  617. package/dist/routing/schema-validation.d.ts.map +1 -0
  618. package/dist/routing/segment-classify.d.ts +114 -0
  619. package/dist/routing/segment-classify.d.ts.map +1 -0
  620. package/dist/routing/segment-codegen.d.ts +38 -0
  621. package/dist/routing/segment-codegen.d.ts.map +1 -0
  622. package/dist/routing/segment-keys.d.ts +118 -0
  623. package/dist/routing/segment-keys.d.ts.map +1 -0
  624. package/dist/routing/slot-placement.d.ts +48 -0
  625. package/dist/routing/slot-placement.d.ts.map +1 -0
  626. package/dist/routing/types.d.ts +81 -26
  627. package/dist/routing/types.d.ts.map +1 -1
  628. package/dist/routing/walkers.d.ts +57 -0
  629. package/dist/routing/walkers.d.ts.map +1 -0
  630. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  631. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  632. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  633. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  634. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  635. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  636. package/dist/rsc-runtime/rsc.d.ts +3 -13
  637. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  638. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  639. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  640. package/dist/rsc-runtime/server-references.d.ts +19 -0
  641. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  642. package/dist/rsc-runtime/ssr.d.ts +7 -10
  643. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  644. package/dist/rsc-runtime/transforms.d.ts +13 -0
  645. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  646. package/dist/schema-bridge.d.ts +154 -0
  647. package/dist/schema-bridge.d.ts.map +1 -0
  648. package/dist/search-params/define.d.ts +262 -0
  649. package/dist/search-params/define.d.ts.map +1 -0
  650. package/dist/search-params/index.d.ts +3 -7
  651. package/dist/search-params/index.d.ts.map +1 -1
  652. package/dist/search-params/index.js +178 -362
  653. package/dist/search-params/index.js.map +1 -1
  654. package/dist/search-params/parse-total.d.ts +81 -0
  655. package/dist/search-params/parse-total.d.ts.map +1 -0
  656. package/dist/search-params/serialize-equal.d.ts +9 -0
  657. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  658. package/dist/search-params/wrappers.d.ts +76 -0
  659. package/dist/search-params/wrappers.d.ts.map +1 -0
  660. package/dist/server/abort-scope.d.ts +27 -0
  661. package/dist/server/abort-scope.d.ts.map +1 -0
  662. package/dist/server/access-gate.d.ts +110 -10
  663. package/dist/server/access-gate.d.ts.map +1 -1
  664. package/dist/server/action-client.d.ts +20 -133
  665. package/dist/server/action-client.d.ts.map +1 -1
  666. package/dist/server/action-encryption.d.ts +76 -0
  667. package/dist/server/action-encryption.d.ts.map +1 -0
  668. package/dist/server/action-handler.d.ts +60 -11
  669. package/dist/server/action-handler.d.ts.map +1 -1
  670. package/dist/server/action-schema.d.ts +126 -0
  671. package/dist/server/action-schema.d.ts.map +1 -0
  672. package/dist/server/action-types.d.ts +108 -0
  673. package/dist/server/action-types.d.ts.map +1 -0
  674. package/dist/server/actions.d.ts +78 -40
  675. package/dist/server/actions.d.ts.map +1 -1
  676. package/dist/server/als-registry.d.ts +189 -17
  677. package/dist/server/als-registry.d.ts.map +1 -1
  678. package/dist/server/body-limits.d.ts.map +1 -1
  679. package/dist/server/build-manifest.d.ts +25 -30
  680. package/dist/server/build-manifest.d.ts.map +1 -1
  681. package/dist/server/canonicalize.d.ts +53 -0
  682. package/dist/server/canonicalize.d.ts.map +1 -1
  683. package/dist/server/chain-url-parts.d.ts +82 -0
  684. package/dist/server/chain-url-parts.d.ts.map +1 -0
  685. package/dist/server/children-interception.d.ts +49 -0
  686. package/dist/server/children-interception.d.ts.map +1 -0
  687. package/dist/server/client-error-message.d.ts +12 -0
  688. package/dist/server/client-error-message.d.ts.map +1 -0
  689. package/dist/server/coalesce-tick.d.ts +40 -0
  690. package/dist/server/coalesce-tick.d.ts.map +1 -0
  691. package/dist/server/compress.d.ts +2 -0
  692. package/dist/server/compress.d.ts.map +1 -1
  693. package/dist/server/cookie-context.d.ts +156 -0
  694. package/dist/server/cookie-context.d.ts.map +1 -0
  695. package/dist/server/cookie-parsing.d.ts +65 -0
  696. package/dist/server/cookie-parsing.d.ts.map +1 -0
  697. package/dist/server/csp-nonce.d.ts +36 -0
  698. package/dist/server/csp-nonce.d.ts.map +1 -0
  699. package/dist/server/csrf.d.ts +58 -15
  700. package/dist/server/csrf.d.ts.map +1 -1
  701. package/dist/server/debug.d.ts +0 -1
  702. package/dist/server/debug.d.ts.map +1 -1
  703. package/dist/server/default-logger.d.ts +23 -0
  704. package/dist/server/default-logger.d.ts.map +1 -0
  705. package/dist/server/default-status-page.d.ts +45 -0
  706. package/dist/server/default-status-page.d.ts.map +1 -0
  707. package/dist/server/deny-boundary.d.ts +257 -0
  708. package/dist/server/deny-boundary.d.ts.map +1 -0
  709. package/dist/server/deny-renderer.d.ts +22 -15
  710. package/dist/server/deny-renderer.d.ts.map +1 -1
  711. package/dist/server/early-hints-sender.d.ts.map +1 -1
  712. package/dist/server/early-hints.d.ts +14 -12
  713. package/dist/server/early-hints.d.ts.map +1 -1
  714. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  715. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  716. package/dist/server/error-response-headers.d.ts +3 -0
  717. package/dist/server/error-response-headers.d.ts.map +1 -0
  718. package/dist/server/fallback-error.d.ts +19 -7
  719. package/dist/server/fallback-error.d.ts.map +1 -1
  720. package/dist/server/flight-injection-state.d.ts +66 -0
  721. package/dist/server/flight-injection-state.d.ts.map +1 -0
  722. package/dist/server/flight-injector-core.d.ts +125 -0
  723. package/dist/server/flight-injector-core.d.ts.map +1 -0
  724. package/dist/server/flight-scripts.d.ts +63 -0
  725. package/dist/server/flight-scripts.d.ts.map +1 -0
  726. package/dist/server/flight-source-node.d.ts +105 -0
  727. package/dist/server/flight-source-node.d.ts.map +1 -0
  728. package/dist/server/flight-source.d.ts +136 -0
  729. package/dist/server/flight-source.d.ts.map +1 -0
  730. package/dist/server/form-data.d.ts +59 -2
  731. package/dist/server/form-data.d.ts.map +1 -1
  732. package/dist/server/form-state-flight.d.ts +32 -0
  733. package/dist/server/form-state-flight.d.ts.map +1 -0
  734. package/dist/server/head-response.d.ts +35 -0
  735. package/dist/server/head-response.d.ts.map +1 -0
  736. package/dist/server/html-injector-core.d.ts +169 -0
  737. package/dist/server/html-injector-core.d.ts.map +1 -0
  738. package/dist/server/html-injectors.d.ts +77 -47
  739. package/dist/server/html-injectors.d.ts.map +1 -1
  740. package/dist/server/index.d.ts +16 -54
  741. package/dist/server/index.d.ts.map +1 -1
  742. package/dist/server/index.js +621 -3009
  743. package/dist/server/index.js.map +1 -1
  744. package/dist/server/instrumentation.d.ts +13 -5
  745. package/dist/server/instrumentation.d.ts.map +1 -1
  746. package/dist/server/interception-gates.d.ts +49 -0
  747. package/dist/server/interception-gates.d.ts.map +1 -0
  748. package/dist/server/internal.d.ts +48 -0
  749. package/dist/server/internal.d.ts.map +1 -0
  750. package/dist/server/internal.js +5092 -0
  751. package/dist/server/internal.js.map +1 -0
  752. package/dist/server/json-status-response.d.ts +34 -0
  753. package/dist/server/json-status-response.d.ts.map +1 -0
  754. package/dist/server/logger.d.ts +105 -7
  755. package/dist/server/logger.d.ts.map +1 -1
  756. package/dist/server/metadata-collector.d.ts +75 -0
  757. package/dist/server/metadata-collector.d.ts.map +1 -0
  758. package/dist/server/metadata-platform.d.ts +2 -2
  759. package/dist/server/metadata-render.d.ts +2 -2
  760. package/dist/server/metadata-render.d.ts.map +1 -1
  761. package/dist/server/metadata-route-links.d.ts +70 -0
  762. package/dist/server/metadata-route-links.d.ts.map +1 -0
  763. package/dist/server/metadata-routes.d.ts +47 -11
  764. package/dist/server/metadata-routes.d.ts.map +1 -1
  765. package/dist/server/metadata-social.d.ts +2 -2
  766. package/dist/server/metadata.d.ts +10 -2
  767. package/dist/server/metadata.d.ts.map +1 -1
  768. package/dist/server/middleware-runner.d.ts +20 -5
  769. package/dist/server/middleware-runner.d.ts.map +1 -1
  770. package/dist/server/node-body-response.d.ts +55 -0
  771. package/dist/server/node-body-response.d.ts.map +1 -0
  772. package/dist/server/node-response.d.ts +62 -0
  773. package/dist/server/node-response.d.ts.map +1 -0
  774. package/dist/server/node-stream-transforms.d.ts +108 -0
  775. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  776. package/dist/server/node-streams-platform.d.ts +21 -0
  777. package/dist/server/node-streams-platform.d.ts.map +1 -0
  778. package/dist/server/param-coercion.d.ts +84 -0
  779. package/dist/server/param-coercion.d.ts.map +1 -0
  780. package/dist/server/pipeline-helpers.d.ts +227 -0
  781. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  782. package/dist/server/pipeline-interception.d.ts +100 -9
  783. package/dist/server/pipeline-interception.d.ts.map +1 -1
  784. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  785. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  786. package/dist/server/pipeline-metadata.d.ts +18 -2
  787. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  788. package/dist/server/pipeline-outcome.d.ts +59 -0
  789. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  790. package/dist/server/pipeline-phases.d.ts +76 -0
  791. package/dist/server/pipeline-phases.d.ts.map +1 -0
  792. package/dist/server/pipeline.d.ts +190 -23
  793. package/dist/server/pipeline.d.ts.map +1 -1
  794. package/dist/server/port-resolution.d.ts +22 -0
  795. package/dist/server/port-resolution.d.ts.map +1 -0
  796. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  797. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  798. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  799. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  800. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  801. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  802. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  803. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  804. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  805. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  806. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  807. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  808. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  809. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  810. package/dist/server/prebuilt/overlay.d.ts +119 -0
  811. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  812. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  813. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  814. package/dist/server/prebuilt/slots.d.ts +105 -0
  815. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  816. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  817. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  818. package/dist/server/prebuilt-builder.d.ts +121 -0
  819. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  820. package/dist/server/prebuilt-runtime.d.ts +105 -0
  821. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  822. package/dist/server/primitives.d.ts +114 -90
  823. package/dist/server/primitives.d.ts.map +1 -1
  824. package/dist/server/publish-params.d.ts +33 -0
  825. package/dist/server/publish-params.d.ts.map +1 -0
  826. package/dist/server/react-cache-bridge.d.ts +59 -0
  827. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  828. package/dist/server/react-cache-scope.d.ts +49 -0
  829. package/dist/server/react-cache-scope.d.ts.map +1 -0
  830. package/dist/server/render-timeout.d.ts +66 -0
  831. package/dist/server/render-timeout.d.ts.map +1 -0
  832. package/dist/server/render-utils.d.ts +56 -0
  833. package/dist/server/render-utils.d.ts.map +1 -0
  834. package/dist/server/request-context.d.ts +167 -103
  835. package/dist/server/request-context.d.ts.map +1 -1
  836. package/dist/server/request-dep.d.ts +15 -0
  837. package/dist/server/request-dep.d.ts.map +1 -0
  838. package/dist/server/response-cache-policy.d.ts +3 -0
  839. package/dist/server/response-cache-policy.d.ts.map +1 -0
  840. package/dist/server/response-framing.d.ts +43 -0
  841. package/dist/server/response-framing.d.ts.map +1 -0
  842. package/dist/server/route-element-builder.d.ts +57 -30
  843. package/dist/server/route-element-builder.d.ts.map +1 -1
  844. package/dist/server/route-element-helpers.d.ts +12 -0
  845. package/dist/server/route-element-helpers.d.ts.map +1 -0
  846. package/dist/server/route-handler.d.ts +9 -3
  847. package/dist/server/route-handler.d.ts.map +1 -1
  848. package/dist/server/route-matcher.d.ts +75 -40
  849. package/dist/server/route-matcher.d.ts.map +1 -1
  850. package/dist/server/route-methods.d.ts +23 -0
  851. package/dist/server/route-methods.d.ts.map +1 -0
  852. package/dist/server/route-module-loader.d.ts +37 -0
  853. package/dist/server/route-module-loader.d.ts.map +1 -0
  854. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  855. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  856. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  857. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  858. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  859. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  860. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  861. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  862. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  863. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  865. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  866. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  867. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/index.d.ts +30 -6
  869. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  871. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  872. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  873. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  874. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  875. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  876. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  877. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  878. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  879. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  880. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  881. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  882. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  883. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  884. package/dist/server/rsc-error-envelope.d.ts +11 -0
  885. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  886. package/dist/server/safe-load.d.ts +39 -0
  887. package/dist/server/safe-load.d.ts.map +1 -0
  888. package/dist/server/schema-introspection.d.ts +68 -0
  889. package/dist/server/schema-introspection.d.ts.map +1 -0
  890. package/dist/server/sensitive-fields.d.ts +88 -0
  891. package/dist/server/sensitive-fields.d.ts.map +1 -0
  892. package/dist/server/signal-identity.d.ts +49 -0
  893. package/dist/server/signal-identity.d.ts.map +1 -0
  894. package/dist/server/sitemap-generator.d.ts +130 -0
  895. package/dist/server/sitemap-generator.d.ts.map +1 -0
  896. package/dist/server/sitemap-handler.d.ts +22 -0
  897. package/dist/server/sitemap-handler.d.ts.map +1 -0
  898. package/dist/server/skippable-prefix.d.ts +29 -0
  899. package/dist/server/skippable-prefix.d.ts.map +1 -0
  900. package/dist/server/slot-interception.d.ts +80 -0
  901. package/dist/server/slot-interception.d.ts.map +1 -0
  902. package/dist/server/slot-resolver.d.ts +138 -7
  903. package/dist/server/slot-resolver.d.ts.map +1 -1
  904. package/dist/server/slot-subtree-contain.d.ts +54 -0
  905. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  906. package/dist/server/ssr-bridge-types.d.ts +213 -0
  907. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  908. package/dist/server/ssr-entry.d.ts +15 -51
  909. package/dist/server/ssr-entry.d.ts.map +1 -1
  910. package/dist/server/ssr-form-state.d.ts +30 -0
  911. package/dist/server/ssr-form-state.d.ts.map +1 -0
  912. package/dist/server/ssr-render.d.ts +42 -12
  913. package/dist/server/ssr-render.d.ts.map +1 -1
  914. package/dist/server/ssr-wrappers.d.ts +92 -0
  915. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  916. package/dist/server/state-tree-diff.d.ts +44 -9
  917. package/dist/server/state-tree-diff.d.ts.map +1 -1
  918. package/dist/server/static-generator.d.ts +112 -0
  919. package/dist/server/static-generator.d.ts.map +1 -0
  920. package/dist/server/static-not-found.d.ts +52 -0
  921. package/dist/server/static-not-found.d.ts.map +1 -0
  922. package/dist/server/status-code-resolver.d.ts +26 -15
  923. package/dist/server/status-code-resolver.d.ts.map +1 -1
  924. package/dist/server/stream-utils.d.ts +93 -0
  925. package/dist/server/stream-utils.d.ts.map +1 -0
  926. package/dist/server/traced-access.d.ts +18 -0
  927. package/dist/server/traced-access.d.ts.map +1 -0
  928. package/dist/server/tracing.d.ts +72 -31
  929. package/dist/server/tracing.d.ts.map +1 -1
  930. package/dist/server/tree-match.d.ts +59 -0
  931. package/dist/server/tree-match.d.ts.map +1 -0
  932. package/dist/server/types.d.ts +90 -8
  933. package/dist/server/types.d.ts.map +1 -1
  934. package/dist/server/utils/element-type.d.ts +50 -0
  935. package/dist/server/utils/element-type.d.ts.map +1 -0
  936. package/dist/server/utils/escape-html.d.ts +14 -0
  937. package/dist/server/utils/escape-html.d.ts.map +1 -0
  938. package/dist/server/version-skew.d.ts +61 -0
  939. package/dist/server/version-skew.d.ts.map +1 -0
  940. package/dist/server/workers-cache-bridge.d.ts +26 -0
  941. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  942. package/dist/shared/als-slots.d.ts +42 -0
  943. package/dist/shared/als-slots.d.ts.map +1 -0
  944. package/dist/shared/base-path.d.ts +56 -0
  945. package/dist/shared/base-path.d.ts.map +1 -0
  946. package/dist/shared/csrf-reject.d.ts +16 -0
  947. package/dist/shared/csrf-reject.d.ts.map +1 -0
  948. package/dist/shared/dev-span.d.ts +99 -0
  949. package/dist/shared/dev-span.d.ts.map +1 -0
  950. package/dist/shared/error-digest.d.ts +28 -0
  951. package/dist/shared/error-digest.d.ts.map +1 -0
  952. package/dist/shared/flight-base64.d.ts +13 -0
  953. package/dist/shared/flight-base64.d.ts.map +1 -0
  954. package/dist/shared/flight-segment.d.ts +18 -0
  955. package/dist/shared/flight-segment.d.ts.map +1 -0
  956. package/dist/shared/form-state-flight.d.ts +32 -0
  957. package/dist/shared/form-state-flight.d.ts.map +1 -0
  958. package/dist/shared/href-validation.d.ts +49 -0
  959. package/dist/shared/href-validation.d.ts.map +1 -0
  960. package/dist/shared/href.d.ts +88 -0
  961. package/dist/shared/href.d.ts.map +1 -0
  962. package/dist/shared/merge-search-params.d.ts +22 -0
  963. package/dist/shared/merge-search-params.d.ts.map +1 -0
  964. package/dist/shared/param-value.d.ts +104 -0
  965. package/dist/shared/param-value.d.ts.map +1 -0
  966. package/dist/shared/payload-root.d.ts +110 -0
  967. package/dist/shared/payload-root.d.ts.map +1 -0
  968. package/dist/shared/redirect-type.d.ts +17 -0
  969. package/dist/shared/redirect-type.d.ts.map +1 -0
  970. package/dist/shared/rsc-cache-key.d.ts +163 -0
  971. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  972. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  973. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  974. package/dist/shared/rsc-manifest.d.ts +28 -0
  975. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  976. package/dist/shared/rsc-media-type.d.ts +52 -0
  977. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  978. package/dist/shared/rsc-payload-path.d.ts +48 -0
  979. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  980. package/dist/shared/segment-info.d.ts +66 -0
  981. package/dist/shared/segment-info.d.ts.map +1 -0
  982. package/dist/shared/slot-params.d.ts +52 -0
  983. package/dist/shared/slot-params.d.ts.map +1 -0
  984. package/dist/shared/static-platform-files.d.ts +71 -0
  985. package/dist/shared/static-platform-files.d.ts.map +1 -0
  986. package/dist/shared/status-reason-phrase.d.ts +26 -0
  987. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  988. package/dist/shims/font-google.d.ts +1 -1
  989. package/dist/shims/font-google.d.ts.map +1 -1
  990. package/dist/shims/font-google.js +41 -0
  991. package/dist/shims/font-google.js.map +1 -0
  992. package/dist/shims/font-local.d.ts +26 -0
  993. package/dist/shims/font-local.d.ts.map +1 -0
  994. package/dist/shims/font-local.js +19 -0
  995. package/dist/shims/font-local.js.map +1 -0
  996. package/dist/shims/headers.d.ts +60 -1
  997. package/dist/shims/headers.d.ts.map +1 -1
  998. package/dist/shims/image.d.ts +120 -120
  999. package/dist/shims/image.d.ts.map +1 -1
  1000. package/dist/shims/navigation-client.d.ts +25 -12
  1001. package/dist/shims/navigation-client.d.ts.map +1 -1
  1002. package/dist/shims/navigation-rsc.d.ts +21 -0
  1003. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  1004. package/dist/shims/navigation.d.ts +10 -5
  1005. package/dist/shims/navigation.d.ts.map +1 -1
  1006. package/dist/utils/state-machine.d.ts +80 -0
  1007. package/dist/utils/state-machine.d.ts.map +1 -0
  1008. package/dist/utils/write-file-atomic.d.ts +17 -0
  1009. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  1010. package/docs/api/30-api-server.mdx +241 -0
  1011. package/docs/api/31-api-client.mdx +225 -0
  1012. package/docs/api/32-api-cache.mdx +341 -0
  1013. package/docs/api/33-api-search-params.mdx +178 -0
  1014. package/docs/api/34-api-config.mdx +421 -0
  1015. package/docs/api/35-api-typescript.mdx +123 -0
  1016. package/docs/api/36-cli.mdx +272 -0
  1017. package/docs/learn/00-introduction.mdx +109 -0
  1018. package/docs/learn/01-quick-start.mdx +94 -0
  1019. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1020. package/docs/learn/03-fetching-data.mdx +227 -0
  1021. package/docs/learn/04-access-control.mdx +115 -0
  1022. package/docs/learn/05-the-flush-point.mdx +175 -0
  1023. package/docs/learn/06-typed-params.mdx +275 -0
  1024. package/docs/learn/07-typed-routes.mdx +173 -0
  1025. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1026. package/docs/learn/09-streaming.mdx +146 -0
  1027. package/docs/learn/10-caching.mdx +303 -0
  1028. package/docs/learn/11-middleware.mdx +166 -0
  1029. package/docs/learn/12-error-handling.mdx +192 -0
  1030. package/docs/learn/13-deploying.mdx +289 -0
  1031. package/llms.txt +55 -0
  1032. package/package.json +124 -29
  1033. package/src/adapters/build-output-helper.ts +375 -0
  1034. package/src/adapters/canonicalize-module.ts +29 -0
  1035. package/src/adapters/cloudflare-dev.ts +183 -0
  1036. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1037. package/src/adapters/cloudflare.ts +799 -151
  1038. package/src/adapters/compress-module.ts +110 -86
  1039. package/src/adapters/fs-identity.ts +155 -0
  1040. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1041. package/src/adapters/nitro-presets.ts +139 -0
  1042. package/src/adapters/nitro-preview.ts +565 -0
  1043. package/src/adapters/nitro.ts +349 -448
  1044. package/src/adapters/raw-imports.d.ts +5 -0
  1045. package/src/adapters/shared.ts +314 -0
  1046. package/src/adapters/types.ts +129 -17
  1047. package/src/adapters/wrangler.d.ts +7 -0
  1048. package/src/analyze/chains.ts +411 -0
  1049. package/src/analyze/classify.ts +259 -0
  1050. package/src/analyze/crawl-entry.ts +68 -0
  1051. package/src/analyze/crawl.ts +500 -0
  1052. package/src/analyze/graph-cache.ts +331 -0
  1053. package/src/analyze/graph-command.ts +654 -0
  1054. package/src/analyze/live-graph.ts +232 -0
  1055. package/src/analyze/poison-rules.ts +165 -0
  1056. package/src/analyze/poison-scan.ts +159 -0
  1057. package/src/analyze/scan.ts +149 -0
  1058. package/src/cache/cache-api.ts +113 -0
  1059. package/src/cache/fast-hash.ts +5 -0
  1060. package/src/cache/guarded-read.ts +44 -0
  1061. package/src/cache/handler-store.ts +113 -0
  1062. package/src/cache/index.ts +93 -20
  1063. package/src/cache/invalidation-epoch.ts +105 -0
  1064. package/src/cache/json-lossy-check.ts +69 -0
  1065. package/src/cache/key-discipline.ts +218 -0
  1066. package/src/cache/redis-handler.ts +193 -19
  1067. package/src/cache/singleflight.ts +85 -7
  1068. package/src/cache/sizeof.ts +35 -0
  1069. package/src/cache/stable-stringify.ts +118 -2
  1070. package/src/cache/store.ts +71 -0
  1071. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1072. package/src/cache/stores/memory.ts +125 -0
  1073. package/src/cache/stores/redis.ts +97 -0
  1074. package/src/cache/stores/vercel.ts +59 -0
  1075. package/src/cache/tag-aware-handler.ts +250 -0
  1076. package/src/cache/timber-cache.ts +218 -47
  1077. package/src/cdn/cloudflare-purge.ts +50 -0
  1078. package/src/cdn/fastly-purge.ts +63 -0
  1079. package/src/cdn/headers.ts +153 -0
  1080. package/src/cdn/index.ts +23 -0
  1081. package/src/cdn/purge-store.ts +62 -0
  1082. package/src/cdn/workers-cache-purge.ts +34 -0
  1083. package/src/cli-check.ts +417 -0
  1084. package/src/cli-context.ts +128 -0
  1085. package/src/cli-dev-status.ts +196 -0
  1086. package/src/cli-init.ts +278 -0
  1087. package/src/cli-schema-sync.ts +401 -0
  1088. package/src/cli.ts +308 -84
  1089. package/src/client/browser-dev.ts +192 -5
  1090. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1091. package/src/client/browser-entry/action-queue.ts +152 -0
  1092. package/src/client/browser-entry/form-state.ts +49 -0
  1093. package/src/client/browser-entry/hmr.ts +82 -0
  1094. package/src/client/browser-entry/hydrate.ts +152 -0
  1095. package/src/client/browser-entry/index.ts +153 -0
  1096. package/src/client/browser-entry/post-hydration.ts +99 -0
  1097. package/src/client/browser-entry/router-init.ts +391 -0
  1098. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1099. package/src/client/browser-entry/scroll.ts +50 -0
  1100. package/src/client/deny-last-resort.tsx +54 -0
  1101. package/src/client/dev-pill/index.ts +128 -0
  1102. package/src/client/dev-pill/store.ts +254 -0
  1103. package/src/client/dev-pill/view.ts +326 -0
  1104. package/src/client/error-boundary.tsx +296 -61
  1105. package/src/client/error-reconstituter.tsx +84 -0
  1106. package/src/client/form.tsx +61 -173
  1107. package/src/client/global-context.ts +59 -0
  1108. package/src/client/history.ts +74 -11
  1109. package/src/client/index.ts +93 -53
  1110. package/src/client/internal.ts +54 -0
  1111. package/src/client/link.tsx +284 -204
  1112. package/src/client/location-search.ts +15 -0
  1113. package/src/client/navigation-api.ts +254 -0
  1114. package/src/client/navigation-commit.ts +318 -0
  1115. package/src/client/navigation-context.ts +71 -142
  1116. package/src/client/navigation-root.tsx +237 -0
  1117. package/src/client/navigation-transition.ts +401 -0
  1118. package/src/client/nuqs-adapter.tsx +62 -32
  1119. package/src/client/params-context.ts +175 -0
  1120. package/src/client/react-root.ts +105 -0
  1121. package/src/client/router-effects.ts +349 -0
  1122. package/src/client/router-lifecycle.ts +394 -0
  1123. package/src/client/router-pipeline.ts +443 -0
  1124. package/src/client/router-ref.ts +3 -3
  1125. package/src/client/router-skew.ts +30 -0
  1126. package/src/client/router-types.ts +326 -0
  1127. package/src/client/router-url.ts +32 -0
  1128. package/src/client/router.ts +491 -421
  1129. package/src/client/rsc-fetch.ts +510 -109
  1130. package/src/client/segment-cache.ts +362 -41
  1131. package/src/client/segment-context.ts +7 -4
  1132. package/src/client/segment-outlet.tsx +96 -0
  1133. package/src/client/segment-update-context.ts +23 -0
  1134. package/src/client/shallow-url.ts +22 -0
  1135. package/src/client/slot-content-cache-context.ts +43 -0
  1136. package/src/client/slot-context.ts +39 -0
  1137. package/src/client/slot-outlet.tsx +22 -0
  1138. package/src/client/slot-provider.tsx +32 -0
  1139. package/src/client/ssr-data.ts +27 -67
  1140. package/src/client/stale-client.ts +191 -0
  1141. package/src/client/state.ts +31 -24
  1142. package/src/client/status-page-marker.tsx +32 -0
  1143. package/src/client/top-loader.tsx +13 -10
  1144. package/src/client/unload-guard.ts +35 -3
  1145. package/src/client/use-cookie.ts +93 -29
  1146. package/src/client/use-field-state.ts +144 -0
  1147. package/src/client/use-link-status.ts +7 -7
  1148. package/src/client/use-pathname.ts +22 -31
  1149. package/src/client/use-pending-navigation.ts +119 -0
  1150. package/src/client/use-query-states.ts +206 -36
  1151. package/src/client/use-router.ts +31 -9
  1152. package/src/client/use-search-params.ts +38 -49
  1153. package/src/client/use-segment-params.ts +69 -0
  1154. package/src/client/use-selected-layout-segment.ts +2 -2
  1155. package/src/codec.ts +149 -0
  1156. package/src/config-types.ts +366 -0
  1157. package/src/config-validation.ts +511 -0
  1158. package/src/cookies/define-cookie.ts +186 -53
  1159. package/src/cookies/index.ts +13 -2
  1160. package/src/cookies/json-cookie.ts +105 -0
  1161. package/src/cookies/validation.ts +192 -0
  1162. package/src/dev-tools/404-page.ts +286 -0
  1163. package/src/dev-tools/await-span.ts +69 -0
  1164. package/src/dev-tools/browser-logs.ts +55 -0
  1165. package/src/dev-tools/dev-page-shell.ts +278 -0
  1166. package/src/dev-tools/error-page.ts +331 -0
  1167. package/src/dev-tools/holding-server.ts +185 -0
  1168. package/src/dev-tools/hydration-overlay.ts +158 -0
  1169. package/src/dev-tools/index.ts +79 -0
  1170. package/src/dev-tools/instrumentation.ts +281 -0
  1171. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1172. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1173. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1174. package/src/dev-tools/span-sink.ts +132 -0
  1175. package/src/dev-tools/stack-classifier.ts +75 -0
  1176. package/src/dev-tools/terminal.ts +182 -0
  1177. package/src/fonts/ast-walk.ts +235 -0
  1178. package/src/fonts/ast.ts +479 -128
  1179. package/src/fonts/bundle.ts +138 -0
  1180. package/src/fonts/css.ts +1 -1
  1181. package/src/fonts/dev-middleware.ts +85 -0
  1182. package/src/fonts/fallbacks.ts +0 -23
  1183. package/src/fonts/google.ts +101 -19
  1184. package/src/fonts/local.ts +12 -11
  1185. package/src/fonts/paths.ts +58 -0
  1186. package/src/fonts/pipeline.ts +348 -0
  1187. package/src/fonts/transform.ts +311 -0
  1188. package/src/fonts/types.ts +52 -1
  1189. package/src/fonts/virtual-modules.ts +179 -0
  1190. package/src/index.ts +501 -380
  1191. package/src/params/codec-registry.ts +47 -0
  1192. package/src/params/define-schema.ts +115 -0
  1193. package/src/params/index.ts +16 -0
  1194. package/src/params/resolve-schema.ts +84 -0
  1195. package/src/plugin-context.ts +509 -0
  1196. package/src/plugins/build-manifest.ts +189 -36
  1197. package/src/plugins/build-report.ts +299 -87
  1198. package/src/plugins/cache.ts +243 -0
  1199. package/src/plugins/callsite-ast.ts +472 -0
  1200. package/src/plugins/callsite-jsx.ts +243 -0
  1201. package/src/plugins/chunks.ts +74 -5
  1202. package/src/plugins/client-chunks.ts +185 -0
  1203. package/src/plugins/client-dep-entries.ts +124 -0
  1204. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1205. package/src/plugins/cloudflare-wasm.ts +141 -0
  1206. package/src/plugins/content.ts +31 -2
  1207. package/src/plugins/dev-await.ts +415 -0
  1208. package/src/plugins/dev-discovery.ts +428 -0
  1209. package/src/plugins/dev-hostname.ts +322 -0
  1210. package/src/plugins/dev-server.ts +471 -100
  1211. package/src/plugins/dev-store-clear.ts +145 -0
  1212. package/src/plugins/encryption-runtime.ts +31 -0
  1213. package/src/plugins/entries.ts +158 -17
  1214. package/src/plugins/fonts.ts +260 -657
  1215. package/src/plugins/graph-endpoint.ts +544 -0
  1216. package/src/plugins/mdx.ts +108 -35
  1217. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1218. package/src/plugins/optimize-package-imports.ts +439 -0
  1219. package/src/plugins/orphaned-modules.ts +78 -0
  1220. package/src/plugins/post-build.ts +327 -0
  1221. package/src/plugins/prebuilt-capture.ts +213 -0
  1222. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1223. package/src/plugins/prebuilt.ts +679 -0
  1224. package/src/plugins/prerender-sugar.ts +348 -0
  1225. package/src/plugins/react-resolve.ts +149 -0
  1226. package/src/plugins/request-dep/analysis.ts +447 -0
  1227. package/src/plugins/request-dep/index.ts +376 -0
  1228. package/src/plugins/request-dep/origin.ts +310 -0
  1229. package/src/plugins/routing.ts +296 -278
  1230. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1231. package/src/plugins/server-bundle.ts +115 -15
  1232. package/src/plugins/shims.ts +267 -97
  1233. package/src/plugins/static-build.ts +681 -71
  1234. package/src/react-canary.d.ts +2 -0
  1235. package/src/routes/href.ts +171 -0
  1236. package/src/routes/index.ts +10 -0
  1237. package/src/routing/codegen-shared.ts +39 -0
  1238. package/src/routing/codegen-types.ts +62 -0
  1239. package/src/routing/codegen-write.ts +163 -0
  1240. package/src/routing/codegen.ts +356 -232
  1241. package/src/routing/collision-probe.ts +438 -0
  1242. package/src/routing/collision-spaces.ts +281 -0
  1243. package/src/routing/convention-lint.ts +649 -0
  1244. package/src/routing/export-detect.ts +536 -0
  1245. package/src/routing/file-cache.ts +23 -0
  1246. package/src/routing/index.ts +16 -7
  1247. package/src/routing/interception-overlap.ts +141 -0
  1248. package/src/routing/interception.ts +1044 -67
  1249. package/src/routing/link-codegen.ts +346 -0
  1250. package/src/routing/manifest-codegen.ts +232 -0
  1251. package/src/routing/scanner.ts +417 -223
  1252. package/src/routing/schema-validation.ts +155 -0
  1253. package/src/routing/segment-classify.ts +280 -0
  1254. package/src/routing/segment-codegen.ts +99 -0
  1255. package/src/routing/segment-keys.ts +186 -0
  1256. package/src/routing/slot-placement.ts +97 -0
  1257. package/src/routing/types.ts +82 -26
  1258. package/src/routing/walkers.ts +98 -0
  1259. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1260. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1261. package/src/rsc-runtime/render-flight.ts +26 -0
  1262. package/src/rsc-runtime/rsc.ts +35 -5
  1263. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1264. package/src/rsc-runtime/server-references.ts +135 -0
  1265. package/src/rsc-runtime/ssr.ts +23 -0
  1266. package/src/rsc-runtime/transforms.ts +13 -0
  1267. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1268. package/src/schema-bridge.ts +437 -0
  1269. package/src/search-params/define.ts +676 -0
  1270. package/src/search-params/index.ts +14 -20
  1271. package/src/search-params/parse-total.ts +91 -0
  1272. package/src/search-params/serialize-equal.ts +14 -0
  1273. package/src/search-params/wrappers.ts +150 -0
  1274. package/src/server/abort-scope.ts +49 -0
  1275. package/src/server/access-gate.tsx +208 -57
  1276. package/src/server/action-client.ts +175 -294
  1277. package/src/server/action-encryption.ts +144 -0
  1278. package/src/server/action-handler.ts +533 -150
  1279. package/src/server/action-schema.ts +203 -0
  1280. package/src/server/action-types.ts +145 -0
  1281. package/src/server/actions.ts +172 -85
  1282. package/src/server/als-registry.ts +245 -30
  1283. package/src/server/body-limits.ts +10 -2
  1284. package/src/server/build-manifest.ts +33 -57
  1285. package/src/server/canonicalize.ts +62 -3
  1286. package/src/server/chain-url-parts.ts +163 -0
  1287. package/src/server/children-interception.ts +116 -0
  1288. package/src/server/client-error-message.ts +18 -0
  1289. package/src/server/coalesce-tick.ts +75 -0
  1290. package/src/server/compress.ts +91 -19
  1291. package/src/server/cookie-context.ts +462 -0
  1292. package/src/server/cookie-parsing.ts +163 -0
  1293. package/src/server/csp-nonce.ts +58 -0
  1294. package/src/server/csrf.ts +238 -37
  1295. package/src/server/debug.ts +0 -1
  1296. package/src/server/default-logger.ts +100 -0
  1297. package/src/server/default-status-page.ts +88 -0
  1298. package/src/server/deny-boundary.ts +527 -0
  1299. package/src/server/deny-renderer.ts +210 -181
  1300. package/src/server/early-hints-sender.ts +4 -3
  1301. package/src/server/early-hints.ts +39 -29
  1302. package/src/server/error-boundary-wrapper.ts +160 -44
  1303. package/src/server/error-response-headers.ts +18 -0
  1304. package/src/server/fallback-error.ts +88 -104
  1305. package/src/server/flight-injection-state.ts +113 -0
  1306. package/src/server/flight-injector-core.ts +332 -0
  1307. package/src/server/flight-scripts.ts +92 -0
  1308. package/src/server/flight-source-node.ts +434 -0
  1309. package/src/server/flight-source.ts +289 -0
  1310. package/src/server/form-data.ts +191 -20
  1311. package/src/server/form-state-flight.ts +67 -0
  1312. package/src/server/head-response.ts +50 -0
  1313. package/src/server/html-injector-core.ts +320 -0
  1314. package/src/server/html-injectors.ts +241 -285
  1315. package/src/server/index.ts +42 -195
  1316. package/src/server/instrumentation.ts +42 -11
  1317. package/src/server/interception-gates.ts +94 -0
  1318. package/src/server/internal.ts +164 -0
  1319. package/src/server/json-status-response.ts +105 -0
  1320. package/src/server/logger.ts +163 -38
  1321. package/src/server/metadata-collector.ts +175 -0
  1322. package/src/server/metadata-platform.ts +2 -2
  1323. package/src/server/metadata-render.ts +30 -8
  1324. package/src/server/metadata-route-links.ts +200 -0
  1325. package/src/server/metadata-routes.ts +114 -24
  1326. package/src/server/metadata-social.ts +2 -2
  1327. package/src/server/metadata.ts +23 -2
  1328. package/src/server/middleware-runner.ts +32 -5
  1329. package/src/server/node-body-response.ts +236 -0
  1330. package/src/server/node-response.ts +93 -0
  1331. package/src/server/node-stream-transforms.ts +340 -0
  1332. package/src/server/node-streams-platform.ts +23 -0
  1333. package/src/server/param-coercion.ts +205 -0
  1334. package/src/server/pipeline-helpers.ts +554 -0
  1335. package/src/server/pipeline-interception.ts +301 -32
  1336. package/src/server/pipeline-metadata-route.ts +242 -0
  1337. package/src/server/pipeline-metadata.ts +30 -4
  1338. package/src/server/pipeline-outcome.ts +290 -0
  1339. package/src/server/pipeline-phases.ts +443 -0
  1340. package/src/server/pipeline.ts +474 -427
  1341. package/src/server/port-resolution.ts +43 -0
  1342. package/src/server/prebuilt/cache-key.ts +340 -0
  1343. package/src/server/prebuilt/capture-render.ts +122 -0
  1344. package/src/server/prebuilt/capture-routes.ts +104 -0
  1345. package/src/server/prebuilt/capture-state.ts +196 -0
  1346. package/src/server/prebuilt/dev-store.ts +252 -0
  1347. package/src/server/prebuilt/lifetime.ts +151 -0
  1348. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1349. package/src/server/prebuilt/overlay.ts +290 -0
  1350. package/src/server/prebuilt/payload-source.ts +221 -0
  1351. package/src/server/prebuilt/slots.ts +201 -0
  1352. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1353. package/src/server/prebuilt-builder.ts +515 -0
  1354. package/src/server/prebuilt-runtime.ts +830 -0
  1355. package/src/server/primitives.ts +167 -171
  1356. package/src/server/publish-params.ts +42 -0
  1357. package/src/server/react-cache-bridge.ts +124 -0
  1358. package/src/server/react-cache-scope.ts +104 -0
  1359. package/src/server/render-timeout.ts +123 -0
  1360. package/src/server/render-utils.ts +70 -0
  1361. package/src/server/request-context.ts +321 -323
  1362. package/src/server/request-dep.ts +37 -0
  1363. package/src/server/response-cache-policy.ts +45 -0
  1364. package/src/server/response-framing.ts +59 -0
  1365. package/src/server/route-element-builder.ts +539 -355
  1366. package/src/server/route-element-helpers.ts +37 -0
  1367. package/src/server/route-handler.ts +78 -48
  1368. package/src/server/route-matcher.ts +251 -265
  1369. package/src/server/route-methods.ts +37 -0
  1370. package/src/server/route-module-loader.ts +161 -0
  1371. package/src/server/rsc-cache-key-guard.ts +122 -0
  1372. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1373. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1374. package/src/server/rsc-entry/api-handler.ts +30 -93
  1375. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1376. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1377. package/src/server/rsc-entry/helpers.ts +90 -115
  1378. package/src/server/rsc-entry/index.ts +420 -350
  1379. package/src/server/rsc-entry/render-route.ts +248 -0
  1380. package/src/server/rsc-entry/render-signals.ts +108 -0
  1381. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1382. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1383. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1384. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1385. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1386. package/src/server/rsc-error-envelope.ts +18 -0
  1387. package/src/server/rsc-prop-warnings.ts +1 -1
  1388. package/src/server/safe-load.ts +53 -0
  1389. package/src/server/schema-introspection.ts +393 -0
  1390. package/src/server/sensitive-fields.ts +287 -0
  1391. package/src/server/server-only-guard-noop.js +3 -0
  1392. package/src/server/server-timing.ts +1 -1
  1393. package/src/server/signal-identity.ts +130 -0
  1394. package/src/server/sitemap-generator.ts +337 -0
  1395. package/src/server/sitemap-handler.ts +150 -0
  1396. package/src/server/skippable-prefix.ts +172 -0
  1397. package/src/server/slot-interception.ts +168 -0
  1398. package/src/server/slot-resolver.ts +747 -300
  1399. package/src/server/slot-subtree-contain.ts +273 -0
  1400. package/src/server/ssr-bridge-types.ts +217 -0
  1401. package/src/server/ssr-entry.ts +246 -109
  1402. package/src/server/ssr-form-state.ts +58 -0
  1403. package/src/server/ssr-render.ts +253 -113
  1404. package/src/server/ssr-wrappers.tsx +152 -0
  1405. package/src/server/state-tree-diff.ts +85 -30
  1406. package/src/server/static-generator.ts +680 -0
  1407. package/src/server/static-not-found.ts +134 -0
  1408. package/src/server/status-code-resolver.ts +107 -148
  1409. package/src/server/stream-utils.ts +398 -0
  1410. package/src/server/traced-access.ts +50 -0
  1411. package/src/server/tracing.ts +274 -128
  1412. package/src/server/tree-match.ts +494 -0
  1413. package/src/server/types.ts +97 -11
  1414. package/src/server/utils/element-type.ts +88 -0
  1415. package/src/server/utils/escape-html.ts +20 -0
  1416. package/src/server/version-skew.ts +104 -0
  1417. package/src/server/waituntil-bridge.ts +1 -1
  1418. package/src/server/workers-cache-bridge.ts +33 -0
  1419. package/src/shared/als-slots.ts +74 -0
  1420. package/src/shared/base-path.ts +80 -0
  1421. package/src/shared/csrf-reject.ts +15 -0
  1422. package/src/shared/dev-span.ts +188 -0
  1423. package/src/shared/error-digest.ts +46 -0
  1424. package/src/shared/flight-base64.ts +23 -0
  1425. package/src/shared/flight-segment.ts +35 -0
  1426. package/src/shared/form-state-flight.ts +59 -0
  1427. package/src/shared/href-validation.ts +159 -0
  1428. package/src/shared/href.ts +257 -0
  1429. package/src/shared/merge-search-params.ts +55 -0
  1430. package/src/shared/param-value.ts +281 -0
  1431. package/src/shared/payload-root.ts +153 -0
  1432. package/src/shared/redirect-type.ts +17 -0
  1433. package/src/shared/rsc-cache-key.ts +269 -0
  1434. package/src/shared/rsc-error-envelope.ts +16 -0
  1435. package/src/shared/rsc-manifest.ts +29 -0
  1436. package/src/shared/rsc-media-type.ts +59 -0
  1437. package/src/shared/rsc-payload-path.ts +52 -0
  1438. package/src/shared/segment-info.ts +67 -0
  1439. package/src/shared/slot-params.ts +109 -0
  1440. package/src/shared/static-platform-files.ts +75 -0
  1441. package/src/shared/status-reason-phrase.ts +61 -0
  1442. package/src/shims/font-google.ts +1 -1
  1443. package/src/shims/font-local.ts +34 -0
  1444. package/src/shims/headers.ts +130 -1
  1445. package/src/shims/navigation-client.ts +36 -32
  1446. package/src/shims/navigation-rsc.ts +47 -0
  1447. package/src/shims/navigation.ts +10 -7
  1448. package/src/utils/state-machine.ts +111 -0
  1449. package/src/utils/write-file-atomic.ts +32 -0
  1450. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1451. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1452. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1453. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1454. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1455. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1456. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1457. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1458. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1459. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1460. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1461. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1462. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1463. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1464. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1465. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1466. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1467. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1468. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1469. package/dist/adapters/cloudflare.js.map +0 -1
  1470. package/dist/cache/index.js.map +0 -1
  1471. package/dist/cache/register-cached-function.d.ts +0 -17
  1472. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1473. package/dist/client/browser-entry.d.ts +0 -21
  1474. package/dist/client/browser-entry.d.ts.map +0 -1
  1475. package/dist/client/error-boundary.js.map +0 -1
  1476. package/dist/client/head.d.ts +0 -16
  1477. package/dist/client/head.d.ts.map +0 -1
  1478. package/dist/client/link-status-provider.d.ts +0 -11
  1479. package/dist/client/link-status-provider.d.ts.map +0 -1
  1480. package/dist/client/segment-merger.d.ts +0 -119
  1481. package/dist/client/segment-merger.d.ts.map +0 -1
  1482. package/dist/client/stale-reload.d.ts +0 -44
  1483. package/dist/client/stale-reload.d.ts.map +0 -1
  1484. package/dist/client/transition-root.d.ts +0 -74
  1485. package/dist/client/transition-root.d.ts.map +0 -1
  1486. package/dist/client/types.d.ts +0 -14
  1487. package/dist/client/types.d.ts.map +0 -1
  1488. package/dist/client/use-navigation-pending.d.ts +0 -26
  1489. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1490. package/dist/client/use-params.d.ts +0 -92
  1491. package/dist/client/use-params.d.ts.map +0 -1
  1492. package/dist/content/index.d.ts +0 -11
  1493. package/dist/content/index.d.ts.map +0 -1
  1494. package/dist/content/index.js +0 -2
  1495. package/dist/plugins/adapter-build.d.ts +0 -18
  1496. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1497. package/dist/plugins/cache-transform.d.ts +0 -36
  1498. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1499. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1500. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1501. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1502. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1503. package/dist/plugins/server-action-exports.d.ts +0 -26
  1504. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1505. package/dist/routing/status-file-lint.d.ts +0 -33
  1506. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1507. package/dist/search-params/analyze.d.ts +0 -54
  1508. package/dist/search-params/analyze.d.ts.map +0 -1
  1509. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1510. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1511. package/dist/search-params/codecs.d.ts +0 -53
  1512. package/dist/search-params/codecs.d.ts.map +0 -1
  1513. package/dist/search-params/create.d.ts +0 -106
  1514. package/dist/search-params/create.d.ts.map +0 -1
  1515. package/dist/search-params/registry.d.ts +0 -20
  1516. package/dist/search-params/registry.d.ts.map +0 -1
  1517. package/dist/server/asset-headers.d.ts +0 -42
  1518. package/dist/server/asset-headers.d.ts.map +0 -1
  1519. package/dist/server/client-module-map.d.ts +0 -47
  1520. package/dist/server/client-module-map.d.ts.map +0 -1
  1521. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1522. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1523. package/dist/server/dev-logger.d.ts.map +0 -1
  1524. package/dist/server/dev-span-processor.d.ts +0 -29
  1525. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1526. package/dist/server/dev-warnings.d.ts +0 -129
  1527. package/dist/server/dev-warnings.d.ts.map +0 -1
  1528. package/dist/server/flush.d.ts +0 -74
  1529. package/dist/server/flush.d.ts.map +0 -1
  1530. package/dist/server/form-flash.d.ts +0 -78
  1531. package/dist/server/form-flash.d.ts.map +0 -1
  1532. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1533. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1534. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1535. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1536. package/dist/server/prerender.d.ts +0 -77
  1537. package/dist/server/prerender.d.ts.map +0 -1
  1538. package/dist/server/tree-builder.d.ts +0 -126
  1539. package/dist/server/tree-builder.d.ts.map +0 -1
  1540. package/dist/utils/directive-parser.d.ts +0 -70
  1541. package/dist/utils/directive-parser.d.ts.map +0 -1
  1542. package/src/cache/register-cached-function.ts +0 -103
  1543. package/src/client/browser-entry.ts +0 -678
  1544. package/src/client/head.ts +0 -61
  1545. package/src/client/link-status-provider.tsx +0 -30
  1546. package/src/client/segment-merger.ts +0 -339
  1547. package/src/client/stale-reload.ts +0 -87
  1548. package/src/client/transition-root.tsx +0 -166
  1549. package/src/client/types.ts +0 -21
  1550. package/src/client/use-navigation-pending.ts +0 -38
  1551. package/src/client/use-params.ts +0 -141
  1552. package/src/content/index.ts +0 -13
  1553. package/src/plugins/adapter-build.ts +0 -118
  1554. package/src/plugins/cache-transform.ts +0 -199
  1555. package/src/plugins/dynamic-transform.ts +0 -161
  1556. package/src/plugins/server-action-exports.ts +0 -220
  1557. package/src/routing/status-file-lint.ts +0 -112
  1558. package/src/search-params/analyze.ts +0 -192
  1559. package/src/search-params/builtin-codecs.ts +0 -228
  1560. package/src/search-params/codecs.ts +0 -153
  1561. package/src/search-params/create.ts +0 -321
  1562. package/src/search-params/registry.ts +0 -31
  1563. package/src/server/asset-headers.ts +0 -81
  1564. package/src/server/client-module-map.ts +0 -58
  1565. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1566. package/src/server/dev-span-processor.ts +0 -78
  1567. package/src/server/dev-warnings.ts +0 -283
  1568. package/src/server/flush.ts +0 -182
  1569. package/src/server/form-flash.ts +0 -89
  1570. package/src/server/manifest-status-resolver.ts +0 -215
  1571. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1572. package/src/server/prerender.ts +0 -139
  1573. package/src/server/tree-builder.ts +0 -382
  1574. package/src/shims/server-only-noop.js +0 -6
  1575. package/src/utils/directive-parser.ts +0 -529
@@ -5,15 +5,39 @@
5
5
  * shim implementations. This enables Next.js-compatible libraries
6
6
  * (nuqs, next-intl, etc.) to work unmodified.
7
7
  *
8
- * NOTE: This plugin does NOT resolve @timber-js/app/* subpath imports.
9
- * Those are handled by Vite's native package.json `exports` resolution,
10
- * which maps them to dist/ files. This ensures a single module instance
11
- * for shared modules like request-context (ALS singleton).
8
+ * This plugin also remaps ALL @timber-js/app/* subpath imports to src/ in
9
+ * server environments (RSC + SSR). This is required because dist/ chunks
10
+ * are pre-built and miss Vite's RSC transforms (e.g. createContext from
11
+ * 'react' doesn't exist in RSC's React build). It also ensures a single
12
+ * module instance for shared mutable state. See SUBPATH_SRC_MAP and TIM-568.
12
13
  *
13
14
  * Design doc: 18-build-system.md §"Shim Map"
14
15
  */
15
16
  import type { Plugin } from 'vite';
16
- import type { PluginContext } from '#/index.js';
17
+ import type { PluginContext } from '../plugin-context.ts';
18
+ /**
19
+ * Map from @timber-js/app/<subpath> to relative src/ file paths.
20
+ *
21
+ * Used by the catch-all resolveId rule to remap subpath imports to src/
22
+ * in server environments. When adding a new subpath export to package.json,
23
+ * add it here too — tests/shims-drift.test.ts enumerates package.json
24
+ * exports and fails if an entry is missing. See TIM-568.
25
+ *
26
+ * Exported for the drift test.
27
+ */
28
+ export declare const SUBPATH_SRC_MAP: Record<string, string>;
29
+ /**
30
+ * Runtime value exports of @timber-js/app/server, stubbed in the client
31
+ * (browser) environment so a stray client-side import fails with a clear
32
+ * call-time error instead of a confusing bundler error.
33
+ *
34
+ * Must stay in sync with the actual runtime exports of server/index.ts —
35
+ * tests/shims-drift.test.ts compares this list against
36
+ * Object.keys(import('../server/index.ts')) and fails on drift.
37
+ * Type-only exports (DenyOptions, AccessContext, …) are erased at runtime
38
+ * and must NOT appear here.
39
+ */
40
+ export declare const SERVER_STUB_EXPORTS: readonly string[];
17
41
  /**
18
42
  * Create the timber-shims Vite plugin.
19
43
  *
@@ -1 +1 @@
1
- {"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/plugins/shims.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiDhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA4JvD"}
1
+ {"version":3,"file":"shims.d.ts","sourceRoot":"","sources":["../../src/plugins/shims.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsB1D;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuBlD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EA0BhD,CAAC;AA2CF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA6OvD"}
@@ -1,55 +1,275 @@
1
1
  /**
2
2
  * timber-static-build — Vite sub-plugin for static output mode.
3
3
  *
4
- * When `output: 'static'` is set in timber.config.ts, this plugin:
5
- * 1. Validates that no dynamic APIs (cookies(), headers()) are used
6
- * 2. When client JavaScript is disabled, rejects 'use client' and 'use server' directives
7
- * 3. Coordinates build-time rendering of all pages
4
+ * When `output: 'static'` is set in timber.config.ts:
5
+ * 1. The plugin validates that no dynamic APIs (getCookies(), getHeaders())
6
+ * are used
7
+ * 2. `runStaticGeneration`, the static generation step of the post-build
8
+ * phase (plugins/post-build.ts), renders all routes to static HTML + RSC
9
+ * flight files
8
10
  *
9
- * Design doc: design/15-future-prerendering.md
11
+ * Design doc: design/11-platform.md §"static output mode"
10
12
  */
11
13
  import type { Plugin } from 'vite';
12
- import type { PluginContext } from '#/index.js';
14
+ import type { PluginContext } from '../plugin-context.ts';
15
+ import type { DirectoryArtifact } from '../adapters/types.ts';
16
+ import type { StaticPageEntry, StaticRedirectEntry } from '../server/static-generator.ts';
17
+ import type { RscManifest } from '../shared/rsc-manifest.ts';
18
+ import { type FsIdentity } from '../adapters/fs-identity.ts';
19
+ /**
20
+ * A single entry in the RSC manifest injected into static HTML.
21
+ * Maps an unhashed `/_rsc/*.rsc` path to its hashed URL, with
22
+ * optional route params inlined to avoid a sidecar fetch.
23
+ */
24
+ export type { RscManifestEntry, RscManifest } from '../shared/rsc-manifest.ts';
13
25
  export interface StaticValidationError {
14
- type: 'dynamic-api' | 'nojs-directive';
26
+ type: 'dynamic-api';
15
27
  file: string;
16
28
  message: string;
17
29
  line?: number;
18
30
  }
19
- export interface StaticOptions {
20
- clientJavascriptDisabled: boolean;
21
- }
22
31
  /**
23
- * Detect usage of dynamic per-request APIs (cookies(), headers())
32
+ * Detect usage of dynamic per-request APIs (getCookies(), getHeaders())
24
33
  * that cannot work at build time in static mode.
25
34
  *
26
35
  * Returns an array of validation errors.
27
36
  */
28
37
  export declare function detectDynamicApis(code: string, fileId: string): StaticValidationError[];
29
38
  /**
30
- * Detect 'use client' and 'use server' directives using AST-based parsing.
31
- * When client JavaScript is disabled, both are hard build errors — no React
32
- * runtime or server actions are allowed in the output.
39
+ * Generate a `_redirects` file from collected redirect entries.
40
+ * Uses the Cloudflare Pages / Netlify format: `/from /to statusCode`
41
+ *
42
+ * Both sides are base-prefixed (TIM-1274). `from` is matched by the host
43
+ * against the request path and `to` is served to the browser as a `Location`,
44
+ * so both are deployed-URL space while `StaticRedirectEntry` carries route
45
+ * space — under `base: '/repo/'`, a rule `/old /new 301` would match nothing
46
+ * and, if it did, would send the browser off the deployment.
33
47
  *
34
- * When client JavaScript is enabled, these are allowed (client components
35
- * hydrate, server actions get extracted to API endpoints).
48
+ * An off-origin `to` is left alone: `redirectExternal()` produces an absolute
49
+ * URL, and a protocol-relative one addresses another host too. Neither is a
50
+ * path on this deployment, so neither takes the prefix.
51
+ *
52
+ * @param base Normalized deployment base (see `shared/base-path.ts`).
53
+ * @internal Exported for testing.
36
54
  */
37
- export declare function detectDirectives(code: string, fileId: string, options: StaticOptions): StaticValidationError[];
55
+ export declare function generateRedirectsFile(redirects: StaticRedirectEntry[], base: string): string;
38
56
  /**
39
- * Run all static mode validations on a source file.
57
+ * Determine the output file path for a static page entry.
58
+ *
59
+ * Pages: /about → about/index.html, / → index.html
60
+ * RSC: /about → _rsc/about/index.rsc, / → _rsc/index.rsc
61
+ * API: /feed.xml → feed.xml, /api/data → api/data
40
62
  *
41
- * Combines:
42
- * - Dynamic API detection (cookies, headers) — always in static mode
43
- * - Directive detection ('use client', 'use server') — only when client JS is disabled
63
+ * The RSC shape mirrors the HTML shape for the reason the HTML shape has it:
64
+ * a route gets a directory and the artifact is the `index` inside it, so the
65
+ * mapping is injective. See `shared/rsc-payload-path.ts` (TIM-1266).
44
66
  */
45
- export declare function validateStaticMode(code: string, fileId: string, options: StaticOptions): StaticValidationError[];
67
+ export declare function staticOutputPath(entry: StaticPageEntry): string;
46
68
  /**
47
- * Create the timber-static-build Vite plugin.
69
+ * Records which entry claimed each output path and reports second claims.
70
+ *
71
+ * Two entries landing on one path is not a rendering failure — both render
72
+ * fine — so nothing downstream notices. The file is written twice, the second
73
+ * write wins, and the deployment serves one route's bytes at another route's
74
+ * URL with the same content type and the same shape (TIM-1266).
75
+ *
76
+ * The naming rules are injective by construction (a route path is a directory
77
+ * and the artifact is the `index` inside it), so a collision here means either
78
+ * two entries were enumerated for one URL or a route reached a path the
79
+ * framework reserves for itself (`404.html`). Both are build errors: there is
80
+ * no correct file to write.
81
+ *
82
+ * Two entries can also be unwritable together without claiming the same
83
+ * string: one wants a file where the other wants a directory (`about` from an
84
+ * API route, `about/index.html` from a page). The filesystem does refuse that
85
+ * one — `EISDIR` on the rename, `ENOTDIR` on the mkdir, depending on which
86
+ * lands second — but an errno names a path, and in the rename case the path
87
+ * it names is the write's temp file. Reported here instead, so the message says which
88
+ * two routes.
89
+ *
90
+ * Collisions are **collected, not thrown**. `onEntry` runs inside the
91
+ * generator, whose RSC branch treats a throw as "this payload is unavailable,
92
+ * SPA navigation falls back to a full load" and swallows it — which for a
93
+ * collision is the wrong end state, since the two payloads are still
94
+ * ambiguous. The caller raises them once generation is done.
95
+ *
96
+ * @internal Exported for testing.
97
+ */
98
+ export declare class StaticOutputPaths {
99
+ private readonly claimed;
100
+ /** Every ancestor directory of a claimed path, mapped to its claimant. */
101
+ private readonly directories;
102
+ private readonly collisions;
103
+ /**
104
+ * @param identity How the output filesystem decides two paths name one
105
+ * file, from `detectFsIdentity`. The guard predicts whether two writes
106
+ * land on one file, which is a property of the filesystem — so it is
107
+ * asked, not assumed. Folding unconditionally would reject `/Foo` beside
108
+ * `/foo` on Linux, where both are perfectly servable files.
109
+ */
110
+ private readonly identity;
111
+ constructor(identity?: FsIdentity);
112
+ /** The identity under which the filesystem will compare this path. */
113
+ private key;
114
+ /**
115
+ * Claim `relPath` for `entry`. Returns false when the path cannot be
116
+ * written alongside an earlier claim, in which case the caller must not
117
+ * write the file — the losing entry is recorded and the build fails at
118
+ * the end.
119
+ */
120
+ claim(relPath: string, entry: StaticPageEntry): boolean;
121
+ /** Throw if any two entries could not both be written. */
122
+ assertNoCollisions(): void;
123
+ }
124
+ /**
125
+ * Writes generated entries into the static output directory, one file per
126
+ * entry, refusing any write that would land on a path another entry holds.
127
+ *
128
+ * @internal Exported for testing.
129
+ */
130
+ export declare class StaticSiteWriter {
131
+ /** Content-Type per URL path for extensionless API routes (TIM-1241). */
132
+ readonly contentTypes: Record<string, string>;
133
+ private readonly paths;
134
+ private readonly staticDir;
135
+ constructor(staticDir: string, identity?: FsIdentity);
136
+ write(entry: StaticPageEntry): Promise<void>;
137
+ /** Throw if any two entries could not both be written. */
138
+ assertNoCollisions(): void;
139
+ }
140
+ /**
141
+ * Remove artifacts a generation pass produces only *conditionally*, so none
142
+ * of them can survive from an earlier build into this one.
143
+ *
144
+ * Pages are not in this set: every page is rewritten each pass, and a page
145
+ * whose route was deleted is a different problem (a stale file nothing links
146
+ * to) from the one here.
147
+ *
148
+ * - `_rsc/` because the files are content-hashed. Left in place, a previous
149
+ * build's already-hashed payload gets hashed again and accumulates.
150
+ * - `_redirects` because it is written only when this pass found redirects.
151
+ * A build whose redirects were removed would otherwise ship the previous
152
+ * build's rules — and would break the merge exemption in
153
+ * `shared/static-platform-files.ts`, which lets the pre-rendered copy
154
+ * overwrite `public/_redirects` on the grounds that it *contains* it. That
155
+ * holds only for a file the current pass produced (TIM-1266).
156
+ *
157
+ * @internal Exported for testing.
158
+ */
159
+ export declare function cleanConditionalArtifacts(staticDir: string): Promise<void>;
160
+ /**
161
+ * Run `fn` with `MessageChannel` instrumented, then stop every channel opened
162
+ * while it ran from holding the process open.
163
+ *
164
+ * Static generation is the only build pass that renders **HTML** in the build
165
+ * process: it imports the built app bundle and drives the full SSR pipeline
166
+ * through it. React's scheduler opens a `MessageChannel` at module scope in
167
+ * that bundle (`scheduler`'s DOM build) and never closes it, and a ref'd
168
+ * `MessagePort` keeps Node's event loop alive on its own — so `timber build`
169
+ * finished the site, printed its summary, and then hung forever. Server-mode
170
+ * builds are unaffected because nothing there renders through react-dom.
171
+ *
172
+ * `unref()` is the whole fix: it leaves the port working and only drops the
173
+ * "keep the process alive" property. It is applied **after** `fn` resolves, so
174
+ * a render in flight can never be cut short by the process exiting under it —
175
+ * an unref'd port would let Node exit while the scheduler still had a
176
+ * continuation queued, which is a silently truncated page rather than a hang.
177
+ *
178
+ * Nothing renders after this pass. If that ever changes, the release has to
179
+ * move to the end of whatever renders last.
180
+ *
181
+ * @internal Exported for testing.
182
+ */
183
+ export declare function withSchedulerPortsReleased<T>(fn: () => Promise<T>): Promise<T>;
184
+ /** The pre-rendered site a static generation pass wrote. */
185
+ export interface StaticSite {
186
+ pages: DirectoryArtifact;
187
+ /** Content-Type per URL path for extensionless API outputs (TIM-1241). */
188
+ contentTypes: Record<string, string>;
189
+ /** `[RSC_PAYLOAD_DIR]` when payloads were written and content-hashed, else none. */
190
+ immutableDirs: string[];
191
+ }
192
+ /**
193
+ * Load the built RSC entry and run the static generation pass — the static
194
+ * generation step of the post-build phase (plugins/post-build.ts).
195
+ *
196
+ * The build manifest it renders with is already final: the phase merged the
197
+ * RSC assets manifest into it and published it before this step. Unlike
198
+ * prebuilt capture, this needs the FULL pipeline handler, so
199
+ * __TIMBER_CAPTURE_MODE__ must be false.
200
+ *
201
+ * Returns the site only once it is complete, so an adapter is never handed a
202
+ * directory a failed pass left half-written — a failure throws instead.
203
+ */
204
+ export declare function runStaticGeneration(ctx: PluginContext, rscDir: string): Promise<StaticSite>;
205
+ /**
206
+ * Warn when Vite's `base` is document-relative (`'./'`) in static mode.
207
+ *
208
+ * Payload URLs are addressed from the deployment root plus the base prefix.
209
+ * A relative base gives no prefix to compute (see shared/base-path.ts), so
210
+ * `/_rsc/about.rsc` is requested at the domain root — correct only when the
211
+ * site is served from there. The build still succeeds: relative bases work
212
+ * fine for assets, and for a root-served site nothing is wrong. The warning
213
+ * exists so a sub-path deployment does not silently degrade to a hard
214
+ * navigation on every link.
215
+ *
216
+ * Skipped when client JS is disabled — there is no SPA navigation and no
217
+ * payload fetch to mis-address.
218
+ *
219
+ * @internal Exported for testing.
220
+ */
221
+ export declare function warnUnusableBase(ctx: PluginContext): void;
222
+ /**
223
+ * Compute a short content hash for immutable caching.
224
+ * Uses 8 chars of base64url-encoded SHA-256, matching Vite's asset hash style.
225
+ */
226
+ export declare function contentHash(data: Buffer | Uint8Array): string;
227
+ /**
228
+ * Hash all RSC flight payloads in `_rsc/`, rename them with content
229
+ * hashes, and build a manifest with optional inlined route params.
48
230
  *
49
- * Only active when output: 'static' is configured.
231
+ * Before: `_rsc/index.rsc`, `_rsc/about.rsc`
232
+ * After: `_rsc/index-B7YxEKdN.rsc`, `_rsc/about-C8ZzFLfO.rsc`
233
+ *
234
+ * The manifest maps the original `_rsc/` URL to an entry object:
235
+ * `{"/_rsc/index.rsc":{"url":"/_rsc/index-B7YxEKdN.rsc"}, ...}`
236
+ *
237
+ * Keys and URLs are **route-space**: root-relative, never carrying Vite's
238
+ * `base`. The client applies the base once, at fetch time
239
+ * (`client/rsc-fetch.ts` → `toStaticRscUrl`), so the generated site stays
240
+ * relocatable and the base has exactly one expression at runtime rather
241
+ * than two that must agree. See TIM-1261.
242
+ *
243
+ * Route params (from `routeParams`) are inlined into the manifest
244
+ * entry, eliminating the need for .params.json sidecar files. TIM-1255.
245
+ *
246
+ * Injected into HTML as:
247
+ * `<script>window.__TIMBER_RSC_MANIFEST__={...}</script>`
248
+ *
249
+ * @internal Exported for testing.
250
+ */
251
+ export declare function hashRscPayloads(staticDir: string): Promise<RscManifest>;
252
+ /**
253
+ * Inject the RSC manifest into all HTML files as a `<script>` tag
254
+ * before `</head>`. This lets the client resolve hashed RSC URLs
255
+ * without an extra network request.
256
+ *
257
+ * @internal Exported for testing.
258
+ */
259
+ export declare function injectRscManifestIntoHtml(staticDir: string, manifest: RscManifest): Promise<void>;
260
+ /**
261
+ * Read a user-authored `_redirects` file from the project's `public/`
262
+ * directory. Returns `null` if no file exists.
263
+ *
264
+ * @internal Exported for testing.
265
+ */
266
+ export declare function readUserRedirects(root: string): Promise<string | null>;
267
+ /**
268
+ * Create the timber-static-build Vite plugin.
50
269
  *
51
- * Hooks:
52
- * - transform: Validates source files for static mode violations
270
+ * Only active when output: 'static' is configured. Validates source files
271
+ * for static mode violations; rendering the site is `runStaticGeneration`,
272
+ * which the post-build phase calls.
53
273
  */
54
274
  export declare function timberStaticBuild(ctx: PluginContext): Plugin;
55
275
  //# sourceMappingURL=static-build.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"static-build.d.ts","sourceRoot":"","sources":["../../src/plugins/static-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAiBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA2BvF;AAMD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,qBAAqB,EAAE,CA8BzB;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,qBAAqB,EAAE,CAOzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA0C5D"}
1
+ {"version":3,"file":"static-build.d.ts","sourceRoot":"","sources":["../../src/plugins/static-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAGV,eAAe,EACf,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,2BAA2B,CAAC;AAI/E,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,4BAA4B,CAAC;AAMpC;;;;GAIG;AAGH,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,CA2BvF;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5F;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAuB/D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAE3C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IAEtC,YAAY,QAAQ,GAAE,UAA8B,EAEnD;IAED,sEAAsE;IACtE,OAAO,CAAC,GAAG;IAIX;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAqCtD;IAED,0DAA0D;IAC1D,kBAAkB,IAAI,IAAI,CAOzB;CACF;AASD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,UAA8B,EAGtE;IAEK,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CjD;IAED,0DAA0D;IAC1D,kBAAkB,IAAI,IAAI,CAEzB;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAmBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBpF;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,oFAAoF;IACpF,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwHjG;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAUzD;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAE7D;AAwBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAuB7E;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU5E;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA2C5D"}
@@ -0,0 +1,124 @@
1
+ /**
2
+ * `href()` — the typed URL builder over the generated `Routes` map.
3
+ *
4
+ * Every internal URL string — `router.push`, `redirect()`, an href passed
5
+ * as a prop, metadata — goes through this one function, so a renamed route
6
+ * directory breaks the build instead of silently breaking a link, and every
7
+ * segment value serializes through its app/schema.ts codec.
8
+ *
9
+ * Isomorphic by construction: no `'use client'`, no React, no ALS. The same
10
+ * call works in a server component, a client component, middleware, an
11
+ * action, or a plain module.
12
+ *
13
+ * Design doc: design/09-typescript.md §"Building URLs — href()".
14
+ */
15
+ import type { Routes } from '../index.ts';
16
+ import { type SearchParamsArg } from '../shared/href.ts';
17
+ /** A URL pattern known to the generated route map (groups stripped). */
18
+ export type RoutePattern = keyof Routes;
19
+ /**
20
+ * Every URL `pattern` resolves to, as a template-literal type:
21
+ * `RouteHref<'/products/[id]'>` is `` `/products/${string}` ``.
22
+ *
23
+ * Use it to require a route-shaped string in a prop
24
+ * (`rowHref: RouteHref<'/artists/[artistSlug]'>`). It is a shape check, not
25
+ * a brand: a hand-built `` `/artists/${slug}` `` satisfies it too, which is
26
+ * how `<Link>` already treats literal hrefs. So does any route nested under
27
+ * it (`/artists/${string}` matches `/artists/a/songs/b`).
28
+ *
29
+ * Read from `Routes[P]['href']`, which codegen emits from the same function
30
+ * that builds `<Link>`'s resolved-template variants. Falls back to `string`
31
+ * only for a route map generated before that member existed.
32
+ */
33
+ export type RouteHref<P extends keyof Routes> = Routes[P] extends {
34
+ href: infer H extends string;
35
+ } ? H : string;
36
+ /**
37
+ * `RouteHref<P>` with a query. The bare form stays in the union because an
38
+ * empty query (`buildSearchParams({})` → `''`) appends nothing — not a bare
39
+ * `?`.
40
+ */
41
+ export type RouteHrefWithSearch<P extends keyof Routes> = RouteHref<P> | `${RouteHref<P>}?${string}`;
42
+ type SegmentParamsOf<P extends keyof Routes> = Routes[P] extends {
43
+ segmentParams: infer S;
44
+ } ? S : never;
45
+ /**
46
+ * The params the PATTERN lets a caller omit: only an optional catch-all,
47
+ * which is always the last segment (`/docs/[[...path]]`). Read from the
48
+ * pattern's syntax, not from the param types — a schema codec may return
49
+ * `T | undefined` for a required `[id]`, and the runtime still throws for
50
+ * a missing `[id]` before any codec runs.
51
+ */
52
+ type OmittableKeys<P extends keyof Routes, T> = {
53
+ [K in keyof T]: P extends `${string}[[...${K & string}]]` ? K : never;
54
+ }[keyof T];
55
+ /**
56
+ * Codegen types an optional catch-all as a required key whose value may be
57
+ * `undefined` (`path: string[] | undefined`). Omittable keys become optional;
58
+ * every other key is required and cannot be `undefined` (the runtime throws
59
+ * on it, whatever the codec's type says).
60
+ */
61
+ type ParamsShape<P extends keyof Routes, T> = {
62
+ [K in keyof T as K extends OmittableKeys<P, T> ? never : K]: Exclude<T[K], undefined>;
63
+ } & {
64
+ [K in keyof T as K extends OmittableKeys<P, T> ? K : never]?: T[K];
65
+ };
66
+ /** Flatten an intersection so diagnostics print one object type. */
67
+ type Flatten<T> = {
68
+ [K in keyof T]: T[K];
69
+ };
70
+ /**
71
+ * The segment params `href(pattern, …)` takes. `Record<string, never>` for a
72
+ * route with none, so `href('/venues', { x: 1 })` is an error rather than a
73
+ * silent no-op (`{}` would accept any object).
74
+ */
75
+ export type HrefParams<P extends keyof Routes> = [keyof SegmentParamsOf<P>] extends [never] ? Record<string, never> : Flatten<ParamsShape<P, SegmentParamsOf<P>>>;
76
+ /** True when `T` is a union of more than one member. */
77
+ type IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never;
78
+ /** True when no member of `P` has a required segment param. */
79
+ type EveryParamOptional<P extends keyof Routes> = (P extends unknown ? ({} extends HrefParams<P> ? true : false) : never) extends true ? true : false;
80
+ /**
81
+ * The arguments after `pattern`. Segment params are required unless every
82
+ * param is optional (none, or only an optional catch-all); the query is
83
+ * always optional.
84
+ *
85
+ * A UNION pattern (`'/products/[id]' | '/venues'`) has no single params
86
+ * shape: `keyof` a union of param objects is `never`, which would read as
87
+ * "no params" and let `href(pattern)` compile, then throw for the dynamic
88
+ * member. So a union takes no segment params at all, and only when none of
89
+ * its members requires one; otherwise the call needs an argument of type
90
+ * `never`, which nothing satisfies. Narrow the pattern before calling.
91
+ *
92
+ * The exception is `P` = all of `keyof Routes`: that is what TS infers when
93
+ * the pattern is NOT a known route, and the arity error would hide the
94
+ * useful one ("'/nope' is not assignable to keyof Routes"). That case takes
95
+ * the permissive shape so the pattern error is the one reported.
96
+ */
97
+ export type HrefArgs<P extends keyof Routes, S extends SearchParamsArg | undefined = SearchParamsArg | undefined> = true extends IsUnion<P> ? EveryParamOptional<P> extends true ? [segmentParams?: undefined, searchParams?: S] : [keyof Routes] extends [P] ? [segmentParams?: undefined, searchParams?: S] : [narrow_the_pattern_union_to_one_route: never] : {} extends HrefParams<P> ? [segmentParams?: HrefParams<P>, searchParams?: S] : [segmentParams: HrefParams<P>, searchParams?: S];
98
+ /**
99
+ * Build the URL for a route pattern.
100
+ *
101
+ * ```ts
102
+ * href('/venues') // '/venues'
103
+ * href('/products/[id]', { id }) // `/products/${string}`
104
+ * href('/docs/[[...path]]') // '/docs'
105
+ * href('/artists/[artistSlug]', { artistSlug }, artistParams.buildSearchParams({ sort }))
106
+ * ```
107
+ *
108
+ * - **Segment params** are typed from `Routes[pattern]['segmentParams']` —
109
+ * the app/schema.ts codec types when a schema exists — and serialized
110
+ * through those codecs, then percent-encoded per segment.
111
+ * - **Search params** (third argument) take the string
112
+ * `definition.buildSearchParams()` returns (codecs, `withUrlKey` aliases,
113
+ * default omission) or a plain record as the uncodec'd escape hatch. An
114
+ * empty query appends nothing.
115
+ * - The result is validated like every navigation sink: a value that would
116
+ * produce a protocol-relative URL (`/[...slug]` with `['', 'evil.com']` →
117
+ * `//evil.com`) throws instead of returning an open redirect.
118
+ *
119
+ * `href(ROUTE, …)` works with the `ROUTE` constant from a route's generated
120
+ * `./$segment` module whenever that directory is a page or route handler.
121
+ */
122
+ export declare function href<P extends keyof Routes, S extends SearchParamsArg | undefined = undefined>(pattern: P, ...args: HrefArgs<P, S>): S extends SearchParamsArg ? RouteHrefWithSearch<P> : RouteHref<P>;
123
+ export {};
124
+ //# sourceMappingURL=href.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"href.d.ts","sourceRoot":"","sources":["../../src/routes/href.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAErF,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC;AAExC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS;IAChE,IAAI,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC;CAC9B,GACG,CAAC,GACD,MAAM,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,MAAM,IAClD,SAAS,CAAC,CAAC,CAAC,GACZ,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;AAEhC,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS;IAAE,aAAa,EAAE,MAAM,CAAC,CAAA;CAAE,GACvF,CAAC,GACD,KAAK,CAAC;AAEV;;;;;;GAMG;AACH,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,CAAC,IAAI;KAC7C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,QAAQ,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK;CACtE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;;;GAKG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,CAAC,IAAI;KAC3C,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CACtF,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CACnE,CAAC;AAEF,oEAAoE;AACpE,KAAK,OAAO,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE3C;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,MAAM,IAAI,CAAC,MAAM,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACvF,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACrB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhD,wDAAwD;AACxD,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;AAEtF,+DAA+D;AAC/D,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,IAAI,CAChD,CAAC,SAAS,OAAO,GAAG,CAAC,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,CACtE,SAAS,IAAI,GACV,IAAI,GACJ,KAAK,CAAC;AAEV;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,QAAQ,CAClB,CAAC,SAAS,MAAM,MAAM,EACtB,CAAC,SAAS,eAAe,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,IAEnE,IAAI,SAAS,OAAO,CAAC,CAAC,CAAC,GACnB,kBAAkB,CAAC,CAAC,CAAC,SAAS,IAAI,GAChC,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,GAC7C,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GACxB,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,GAC7C,CAAC,qCAAqC,EAAE,KAAK,CAAC,GAClD,EAAE,SAAS,UAAU,CAAC,CAAC,CAAC,GACtB,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,GACjD,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;AAQzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,CAAC,SAAS,eAAe,GAAG,SAAS,GAAG,SAAS,EAC5F,OAAO,EAAE,CAAC,EACV,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACtB,CAAC,SAAS,eAAe,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ export { href } from './href.ts';
2
+ export type { HrefArgs, HrefParams, RouteHref, RouteHrefWithSearch, RoutePattern } from './href.ts';
3
+ export type { SearchParamsArg } from '../shared/href.ts';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routes/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACpG,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
@@ -0,0 +1,8 @@
1
+ import { t as buildHref } from "../_chunks/href-BtspoNc9.js";
2
+ // src/routes/href.ts
3
+ function href(pattern, segmentParams, searchParams) {
4
+ return buildHref(pattern, segmentParams, searchParams);
5
+ }
6
+ export { href };
7
+
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../src/routes/href.ts"],"sourcesContent":["/**\n * `href()` — the typed URL builder over the generated `Routes` map.\n *\n * Every internal URL string — `router.push`, `redirect()`, an href passed\n * as a prop, metadata — goes through this one function, so a renamed route\n * directory breaks the build instead of silently breaking a link, and every\n * segment value serializes through its app/schema.ts codec.\n *\n * Isomorphic by construction: no `'use client'`, no React, no ALS. The same\n * call works in a server component, a client component, middleware, an\n * action, or a plain module.\n *\n * Design doc: design/09-typescript.md §\"Building URLs — href()\".\n */\n\nimport type { Routes } from '../index.ts';\nimport { buildHref, type ParamValue, type SearchParamsArg } from '../shared/href.ts';\n\n/** A URL pattern known to the generated route map (groups stripped). */\nexport type RoutePattern = keyof Routes;\n\n/**\n * Every URL `pattern` resolves to, as a template-literal type:\n * `RouteHref<'/products/[id]'>` is `` `/products/${string}` ``.\n *\n * Use it to require a route-shaped string in a prop\n * (`rowHref: RouteHref<'/artists/[artistSlug]'>`). It is a shape check, not\n * a brand: a hand-built `` `/artists/${slug}` `` satisfies it too, which is\n * how `<Link>` already treats literal hrefs. So does any route nested under\n * it (`/artists/${string}` matches `/artists/a/songs/b`).\n *\n * Read from `Routes[P]['href']`, which codegen emits from the same function\n * that builds `<Link>`'s resolved-template variants. Falls back to `string`\n * only for a route map generated before that member existed.\n */\nexport type RouteHref<P extends keyof Routes> = Routes[P] extends {\n href: infer H extends string;\n}\n ? H\n : string;\n\n/**\n * `RouteHref<P>` with a query. The bare form stays in the union because an\n * empty query (`buildSearchParams({})` → `''`) appends nothing — not a bare\n * `?`.\n */\nexport type RouteHrefWithSearch<P extends keyof Routes> =\n | RouteHref<P>\n | `${RouteHref<P>}?${string}`;\n\ntype SegmentParamsOf<P extends keyof Routes> = Routes[P] extends { segmentParams: infer S }\n ? S\n : never;\n\n/**\n * The params the PATTERN lets a caller omit: only an optional catch-all,\n * which is always the last segment (`/docs/[[...path]]`). Read from the\n * pattern's syntax, not from the param types — a schema codec may return\n * `T | undefined` for a required `[id]`, and the runtime still throws for\n * a missing `[id]` before any codec runs.\n */\ntype OmittableKeys<P extends keyof Routes, T> = {\n [K in keyof T]: P extends `${string}[[...${K & string}]]` ? K : never;\n}[keyof T];\n\n/**\n * Codegen types an optional catch-all as a required key whose value may be\n * `undefined` (`path: string[] | undefined`). Omittable keys become optional;\n * every other key is required and cannot be `undefined` (the runtime throws\n * on it, whatever the codec's type says).\n */\ntype ParamsShape<P extends keyof Routes, T> = {\n [K in keyof T as K extends OmittableKeys<P, T> ? never : K]: Exclude<T[K], undefined>;\n} & {\n [K in keyof T as K extends OmittableKeys<P, T> ? K : never]?: T[K];\n};\n\n/** Flatten an intersection so diagnostics print one object type. */\ntype Flatten<T> = { [K in keyof T]: T[K] };\n\n/**\n * The segment params `href(pattern, …)` takes. `Record<string, never>` for a\n * route with none, so `href('/venues', { x: 1 })` is an error rather than a\n * silent no-op (`{}` would accept any object).\n */\nexport type HrefParams<P extends keyof Routes> = [keyof SegmentParamsOf<P>] extends [never]\n ? Record<string, never>\n : Flatten<ParamsShape<P, SegmentParamsOf<P>>>;\n\n/** True when `T` is a union of more than one member. */\ntype IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never;\n\n/** True when no member of `P` has a required segment param. */\ntype EveryParamOptional<P extends keyof Routes> = (\n P extends unknown ? ({} extends HrefParams<P> ? true : false) : never\n) extends true\n ? true\n : false;\n\n/**\n * The arguments after `pattern`. Segment params are required unless every\n * param is optional (none, or only an optional catch-all); the query is\n * always optional.\n *\n * A UNION pattern (`'/products/[id]' | '/venues'`) has no single params\n * shape: `keyof` a union of param objects is `never`, which would read as\n * \"no params\" and let `href(pattern)` compile, then throw for the dynamic\n * member. So a union takes no segment params at all, and only when none of\n * its members requires one; otherwise the call needs an argument of type\n * `never`, which nothing satisfies. Narrow the pattern before calling.\n *\n * The exception is `P` = all of `keyof Routes`: that is what TS infers when\n * the pattern is NOT a known route, and the arity error would hide the\n * useful one (\"'/nope' is not assignable to keyof Routes\"). That case takes\n * the permissive shape so the pattern error is the one reported.\n */\nexport type HrefArgs<\n P extends keyof Routes,\n S extends SearchParamsArg | undefined = SearchParamsArg | undefined,\n> =\n true extends IsUnion<P>\n ? EveryParamOptional<P> extends true\n ? [segmentParams?: undefined, searchParams?: S]\n : [keyof Routes] extends [P]\n ? [segmentParams?: undefined, searchParams?: S]\n : [narrow_the_pattern_union_to_one_route: never]\n : {} extends HrefParams<P>\n ? [segmentParams?: HrefParams<P>, searchParams?: S]\n : [segmentParams: HrefParams<P>, searchParams?: S];\n\n// One signature, not an overload per query shape: with two, a call missing\n// its segment params was reported against whichever overload TS tried last\n// (\"Expected 3 arguments\"). `S` is inferred from the query argument alone,\n// so segment params are still checked against `HrefParams<P>` directly and\n// keep excess-property errors; a maybe-undefined query distributes to the\n// union of both return shapes.\n/**\n * Build the URL for a route pattern.\n *\n * ```ts\n * href('/venues') // '/venues'\n * href('/products/[id]', { id }) // `/products/${string}`\n * href('/docs/[[...path]]') // '/docs'\n * href('/artists/[artistSlug]', { artistSlug }, artistParams.buildSearchParams({ sort }))\n * ```\n *\n * - **Segment params** are typed from `Routes[pattern]['segmentParams']` —\n * the app/schema.ts codec types when a schema exists — and serialized\n * through those codecs, then percent-encoded per segment.\n * - **Search params** (third argument) take the string\n * `definition.buildSearchParams()` returns (codecs, `withUrlKey` aliases,\n * default omission) or a plain record as the uncodec'd escape hatch. An\n * empty query appends nothing.\n * - The result is validated like every navigation sink: a value that would\n * produce a protocol-relative URL (`/[...slug]` with `['', 'evil.com']` →\n * `//evil.com`) throws instead of returning an open redirect.\n *\n * `href(ROUTE, …)` works with the `ROUTE` constant from a route's generated\n * `./$segment` module whenever that directory is a page or route handler.\n */\nexport function href<P extends keyof Routes, S extends SearchParamsArg | undefined = undefined>(\n pattern: P,\n ...args: HrefArgs<P, S>\n): S extends SearchParamsArg ? RouteHrefWithSearch<P> : RouteHref<P>;\nexport function href(\n pattern: string,\n segmentParams?: Record<string, ParamValue>,\n searchParams?: SearchParamsArg\n): string {\n return buildHref(pattern, segmentParams, searchParams);\n}\n"],"mappings":";;AAoKA,SAAgB,KACd,SACA,eACA,cACQ;CACR,OAAO,UAAU,SAAS,eAAe,YAAY;AACvD"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Shared codegen helpers — import-path computation and codec chain type
3
+ * builders.
4
+ *
5
+ * Extracted from `codegen.ts` so `link-codegen.ts` can use the same
6
+ * helpers without a cyclic import.
7
+ */
8
+ import type { ParamEntry } from './codegen-types.ts';
9
+ /**
10
+ * Compute a relative import specifier for a codec/page file, stripping
11
+ * the .ts/.tsx extension and resolving against the codegen output dir.
12
+ */
13
+ export declare function codecImportPath(codecFilePath: string, importBase: string | undefined): string;
14
+ /**
15
+ * Build a TypeScript type expression for a single param using the global
16
+ * schema's InferCodecType. Falls back to the param's base type when
17
+ * schema doesn't declare this param (schemas are opt-in per key).
18
+ *
19
+ * Uses `infer` to extract the codec value rather than direct indexing
20
+ * because TypeScript doesn't narrow index validity inside a conditional
21
+ * type's true branch — `typeof schema.segmentParams[K]` produces TS2538
22
+ * even when the condition proves K is a valid key. In .d.ts files that
23
+ * error is suppressed and the type silently becomes `any`.
24
+ */
25
+ export declare function buildSchemaParamType(p: ParamEntry, fallback?: string): string;
26
+ //# sourceMappingURL=codegen-shared.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codegen-shared.d.ts","sourceRoot":"","sources":["../../src/routing/codegen-shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7E"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Shared types for route codegen modules.
3
+ *
4
+ * Lives in its own file so `link-codegen.ts` and `codegen.ts` can import
5
+ * the same `RouteEntry` / `ParamEntry` shapes without a cyclic
6
+ * dependency between the two.
7
+ */
8
+ /** A single route entry extracted from the segment tree. */
9
+ export interface RouteEntry {
10
+ /** URL path pattern (e.g. "/products/[id]") */
11
+ urlPath: string;
12
+ /** Full tree path including groups and slots (e.g. "/(browse)/[artistSlug]/@shows/[year]").
13
+ * Uniquely identifies a segment — unlike urlPath which strips groups/slots. */
14
+ segmentPath: string;
15
+ /** Accumulated params from all ancestor dynamic segments */
16
+ params: ParamEntry[];
17
+ /** Whether this is an API route (route.ts) vs page route */
18
+ isApiRoute: boolean;
19
+ /**
20
+ * Whether a request can reach this segment — it has a `page` or `route`.
21
+ *
22
+ * False for a segment that only hosts a layout/middleware/access above the
23
+ * leaf. Those still need typed `getSegmentParams(SEGMENT_PATH)` overloads
24
+ * (they have a `$segment` module), but must NOT appear in urlPath-keyed
25
+ * emissions — the `Routes` interface and `<Link>` — because their urlPath
26
+ * is not an addressable route. See TIM-1342.
27
+ */
28
+ isRoutable: boolean;
29
+ /** Whether this entry lives inside a parallel slot (@name). Slot entries
30
+ * share their parent's urlPath — urlPath-keyed emissions dedupe them,
31
+ * preferring the non-slot entry. segmentPath-keyed emissions keep all. */
32
+ isSlotRoute?: boolean;
33
+ /**
34
+ * Whether this entry lives inside an intercepting subtree.
35
+ *
36
+ * Such an entry has **no URL of its own**. Interception adds no URL depth,
37
+ * so the scanner's `urlPath` for the subtree is the owner's path with the
38
+ * descendants' names appended — `(browse)/(...)[artistSlug]/[year]` computes
39
+ * `/[year]`, which is not the route it renders at (that is
40
+ * `/[artistSlug]/[year]`) and is not reachable by any request. It is also
41
+ * soft-navigation-only.
42
+ *
43
+ * So these entries are dropped from every urlPath-keyed emission (`Routes`,
44
+ * `useQueryStates`, typed `<Link>`) rather than deduped against the
45
+ * canonical route: dedupe only helps where the paths happen to collide, and
46
+ * a non-colliding computed path would be published as a real route.
47
+ * segmentPath-keyed emissions keep them, so the intercepting page's own
48
+ * params stay typed.
49
+ */
50
+ isInterceptingRoute?: boolean;
51
+ /** Whether a global schema (app/schema.ts) exists for this app */
52
+ hasSchema?: boolean;
53
+ }
54
+ export interface ParamEntry {
55
+ name: string;
56
+ /** Bracket-wrapped segment name as it appears in the filesystem and schema.
57
+ * e.g. '[id]', '[...slug]', '[[...slug]]' */
58
+ bracketName: string;
59
+ type: 'string' | 'string[]' | 'string[] | undefined';
60
+ }
61
+ //# sourceMappingURL=codegen-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codegen-types.d.ts","sourceRoot":"","sources":["../../src/routing/codegen-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB;oFACgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;+EAE2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;kDAC8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,sBAAsB,CAAC;CACtD"}