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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1470) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BwkmAYXq.js +1243 -0
  5. package/dist/_chunks/actions-BwkmAYXq.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-LA3sBpUS.js +1182 -0
  17. package/dist/_chunks/cache-api-LA3sBpUS.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-DkytOEG2.js +1 -0
  44. package/dist/_chunks/dev-server-DnODXuNM.js +2056 -0
  45. package/dist/_chunks/dev-server-DnODXuNM.js.map +1 -0
  46. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  47. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  48. package/dist/_chunks/error-boundary-xxxLtXt6.js +1057 -0
  49. package/dist/_chunks/error-boundary-xxxLtXt6.js.map +1 -0
  50. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  51. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  52. package/dist/_chunks/flight-source-node-0dE-t3kq.js +519 -0
  53. package/dist/_chunks/flight-source-node-0dE-t3kq.js.map +1 -0
  54. package/dist/_chunks/format-BKclgVbk.js +14 -0
  55. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  56. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  57. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  58. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  59. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  60. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  61. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  62. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  63. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  64. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  65. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  66. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  67. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  68. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  69. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  70. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  71. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  72. package/dist/_chunks/node-response-Dibufw_b.js +187 -0
  73. package/dist/_chunks/node-response-Dibufw_b.js.map +1 -0
  74. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  75. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  76. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  77. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  78. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  79. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  80. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  81. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  82. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  83. package/dist/_chunks/purge-store-Byr8XOjU.js +14 -0
  84. package/dist/_chunks/purge-store-Byr8XOjU.js.map +1 -0
  85. package/dist/_chunks/render-timeout-DOf_BBcO.js +46 -0
  86. package/dist/_chunks/render-timeout-DOf_BBcO.js.map +1 -0
  87. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  88. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  89. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  90. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  91. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  92. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  93. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  94. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  95. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  96. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  97. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  98. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  99. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  100. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  101. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  102. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  103. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  104. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  105. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  106. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  107. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  108. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  109. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  110. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  111. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  112. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  113. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  114. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  115. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  116. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  117. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  118. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  119. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  120. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  121. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  122. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  123. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  124. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  125. package/dist/adapters/build-output-helper.d.ts +72 -0
  126. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  127. package/dist/adapters/canonicalize-module.d.ts +8 -0
  128. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  129. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  130. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.js +74 -0
  132. package/dist/adapters/cloudflare-dev.js.map +1 -0
  133. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  134. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  136. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  137. package/dist/adapters/cloudflare.d.ts +224 -24
  138. package/dist/adapters/cloudflare.d.ts.map +1 -1
  139. package/dist/adapters/cloudflare.js +1 -188
  140. package/dist/adapters/compress-module.d.ts +25 -4
  141. package/dist/adapters/compress-module.d.ts.map +1 -1
  142. package/dist/adapters/fs-identity.d.ts +63 -0
  143. package/dist/adapters/fs-identity.d.ts.map +1 -0
  144. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  145. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  146. package/dist/adapters/nitro-presets.d.ts +31 -0
  147. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-preview.d.ts +65 -0
  149. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  150. package/dist/adapters/nitro.d.ts +69 -38
  151. package/dist/adapters/nitro.d.ts.map +1 -1
  152. package/dist/adapters/nitro.js +793 -341
  153. package/dist/adapters/nitro.js.map +1 -1
  154. package/dist/adapters/shared.d.ts +67 -0
  155. package/dist/adapters/shared.d.ts.map +1 -0
  156. package/dist/adapters/types.d.ts +124 -16
  157. package/dist/adapters/types.d.ts.map +1 -1
  158. package/dist/adapters/types.js +0 -0
  159. package/dist/analyze/chains.d.ts +124 -0
  160. package/dist/analyze/chains.d.ts.map +1 -0
  161. package/dist/analyze/classify.d.ts +153 -0
  162. package/dist/analyze/classify.d.ts.map +1 -0
  163. package/dist/analyze/crawl-entry.d.ts +17 -0
  164. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.js +314 -0
  166. package/dist/analyze/crawl-entry.js.map +1 -0
  167. package/dist/analyze/crawl.d.ts +134 -0
  168. package/dist/analyze/crawl.d.ts.map +1 -0
  169. package/dist/analyze/graph-cache.d.ts +104 -0
  170. package/dist/analyze/graph-cache.d.ts.map +1 -0
  171. package/dist/analyze/graph-command.d.ts +43 -0
  172. package/dist/analyze/graph-command.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.js +472 -0
  174. package/dist/analyze/graph-command.js.map +1 -0
  175. package/dist/analyze/live-graph.d.ts +81 -0
  176. package/dist/analyze/live-graph.d.ts.map +1 -0
  177. package/dist/analyze/poison-rules.d.ts +72 -0
  178. package/dist/analyze/poison-rules.d.ts.map +1 -0
  179. package/dist/analyze/poison-scan.d.ts +48 -0
  180. package/dist/analyze/poison-scan.d.ts.map +1 -0
  181. package/dist/analyze/scan.d.ts +73 -0
  182. package/dist/analyze/scan.d.ts.map +1 -0
  183. package/dist/cache/cache-api.d.ts +48 -0
  184. package/dist/cache/cache-api.d.ts.map +1 -0
  185. package/dist/cache/fast-hash.d.ts +5 -0
  186. package/dist/cache/fast-hash.d.ts.map +1 -1
  187. package/dist/cache/handler-store.d.ts +33 -0
  188. package/dist/cache/handler-store.d.ts.map +1 -0
  189. package/dist/cache/index.d.ts +32 -9
  190. package/dist/cache/index.d.ts.map +1 -1
  191. package/dist/cache/index.js +3 -326
  192. package/dist/cache/invalidation-epoch.d.ts +43 -0
  193. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  194. package/dist/cache/json-lossy-check.d.ts +11 -0
  195. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  196. package/dist/cache/redis-handler.d.ts +141 -9
  197. package/dist/cache/redis-handler.d.ts.map +1 -1
  198. package/dist/cache/singleflight.d.ts +21 -2
  199. package/dist/cache/singleflight.d.ts.map +1 -1
  200. package/dist/cache/sizeof.d.ts +22 -0
  201. package/dist/cache/sizeof.d.ts.map +1 -0
  202. package/dist/cache/stable-stringify.d.ts +9 -0
  203. package/dist/cache/stable-stringify.d.ts.map +1 -1
  204. package/dist/cache/store.d.ts +53 -0
  205. package/dist/cache/store.d.ts.map +1 -0
  206. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  207. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.js +29 -0
  209. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  210. package/dist/cache/stores/memory.d.ts +42 -0
  211. package/dist/cache/stores/memory.d.ts.map +1 -0
  212. package/dist/cache/stores/memory.js +90 -0
  213. package/dist/cache/stores/memory.js.map +1 -0
  214. package/dist/cache/stores/redis.d.ts +69 -0
  215. package/dist/cache/stores/redis.d.ts.map +1 -0
  216. package/dist/cache/stores/redis.js +35 -0
  217. package/dist/cache/stores/redis.js.map +1 -0
  218. package/dist/cache/stores/vercel.d.ts +36 -0
  219. package/dist/cache/stores/vercel.d.ts.map +1 -0
  220. package/dist/cache/stores/vercel.js +33 -0
  221. package/dist/cache/stores/vercel.js.map +1 -0
  222. package/dist/cache/tag-aware-handler.d.ts +52 -0
  223. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  224. package/dist/cache/timber-cache.d.ts +21 -11
  225. package/dist/cache/timber-cache.d.ts.map +1 -1
  226. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  227. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  228. package/dist/cdn/cloudflare-purge.js +30 -0
  229. package/dist/cdn/cloudflare-purge.js.map +1 -0
  230. package/dist/cdn/fastly-purge.d.ts +25 -0
  231. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  232. package/dist/cdn/fastly-purge.js +33 -0
  233. package/dist/cdn/fastly-purge.js.map +1 -0
  234. package/dist/cdn/headers.d.ts +97 -0
  235. package/dist/cdn/headers.d.ts.map +1 -0
  236. package/dist/cdn/index.d.ts +5 -0
  237. package/dist/cdn/index.d.ts.map +1 -0
  238. package/dist/cdn/index.js +94 -0
  239. package/dist/cdn/index.js.map +1 -0
  240. package/dist/cdn/purge-store.d.ts +23 -0
  241. package/dist/cdn/purge-store.d.ts.map +1 -0
  242. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  243. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.js +35 -0
  245. package/dist/cdn/workers-cache-purge.js.map +1 -0
  246. package/dist/cli-check.d.ts +133 -0
  247. package/dist/cli-check.d.ts.map +1 -0
  248. package/dist/cli-context.d.ts +54 -0
  249. package/dist/cli-context.d.ts.map +1 -0
  250. package/dist/cli-schema-sync.d.ts +59 -0
  251. package/dist/cli-schema-sync.d.ts.map +1 -0
  252. package/dist/cli.d.ts +88 -16
  253. package/dist/cli.d.ts.map +1 -1
  254. package/dist/cli.js +225 -63
  255. package/dist/cli.js.map +1 -1
  256. package/dist/client/browser-dev.d.ts +42 -2
  257. package/dist/client/browser-dev.d.ts.map +1 -1
  258. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  259. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  260. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  261. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  262. package/dist/client/browser-entry/form-state.d.ts +22 -0
  263. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  264. package/dist/client/browser-entry/hmr.d.ts +21 -0
  265. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  267. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  268. package/dist/client/browser-entry/index.d.ts +32 -0
  269. package/dist/client/browser-entry/index.d.ts.map +1 -0
  270. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  271. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  272. package/dist/client/browser-entry/router-init.d.ts +41 -0
  273. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  274. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  275. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  276. package/dist/client/browser-entry/scroll.d.ts +28 -0
  277. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  278. package/dist/client/deny-last-resort.d.ts +29 -0
  279. package/dist/client/deny-last-resort.d.ts.map +1 -0
  280. package/dist/client/error-boundary.d.ts +58 -9
  281. package/dist/client/error-boundary.d.ts.map +1 -1
  282. package/dist/client/error-boundary.js +1 -126
  283. package/dist/client/error-reconstituter.d.ts +55 -0
  284. package/dist/client/error-reconstituter.d.ts.map +1 -0
  285. package/dist/client/form.d.ts +38 -99
  286. package/dist/client/form.d.ts.map +1 -1
  287. package/dist/client/global-context.d.ts +15 -0
  288. package/dist/client/global-context.d.ts.map +1 -0
  289. package/dist/client/history.d.ts +50 -9
  290. package/dist/client/history.d.ts.map +1 -1
  291. package/dist/client/index.d.ts +21 -33
  292. package/dist/client/index.d.ts.map +1 -1
  293. package/dist/client/index.js +432 -1227
  294. package/dist/client/index.js.map +1 -1
  295. package/dist/client/internal.d.ts +20 -0
  296. package/dist/client/internal.d.ts.map +1 -0
  297. package/dist/client/internal.js +808 -0
  298. package/dist/client/internal.js.map +1 -0
  299. package/dist/client/link.d.ts +85 -60
  300. package/dist/client/link.d.ts.map +1 -1
  301. package/dist/client/location-search.d.ts +12 -0
  302. package/dist/client/location-search.d.ts.map +1 -0
  303. package/dist/client/navigation-api.d.ts +95 -0
  304. package/dist/client/navigation-api.d.ts.map +1 -0
  305. package/dist/client/navigation-commit.d.ts +111 -0
  306. package/dist/client/navigation-commit.d.ts.map +1 -0
  307. package/dist/client/navigation-context.d.ts +54 -36
  308. package/dist/client/navigation-context.d.ts.map +1 -1
  309. package/dist/client/navigation-root.d.ts +106 -0
  310. package/dist/client/navigation-root.d.ts.map +1 -0
  311. package/dist/client/navigation-transition.d.ts +201 -0
  312. package/dist/client/navigation-transition.d.ts.map +1 -0
  313. package/dist/client/nuqs-adapter.d.ts +1 -1
  314. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  315. package/dist/client/params-context.d.ts +81 -0
  316. package/dist/client/params-context.d.ts.map +1 -0
  317. package/dist/client/react-root.d.ts +51 -0
  318. package/dist/client/react-root.d.ts.map +1 -0
  319. package/dist/client/router-effects.d.ts +199 -0
  320. package/dist/client/router-effects.d.ts.map +1 -0
  321. package/dist/client/router-lifecycle.d.ts +104 -0
  322. package/dist/client/router-lifecycle.d.ts.map +1 -0
  323. package/dist/client/router-pipeline.d.ts +85 -0
  324. package/dist/client/router-pipeline.d.ts.map +1 -0
  325. package/dist/client/router-ref.d.ts +2 -2
  326. package/dist/client/router-ref.d.ts.map +1 -1
  327. package/dist/client/router-skew.d.ts +21 -0
  328. package/dist/client/router-skew.d.ts.map +1 -0
  329. package/dist/client/router-types.d.ts +314 -0
  330. package/dist/client/router-types.d.ts.map +1 -0
  331. package/dist/client/router-url.d.ts +24 -0
  332. package/dist/client/router-url.d.ts.map +1 -0
  333. package/dist/client/router.d.ts +1 -97
  334. package/dist/client/router.d.ts.map +1 -1
  335. package/dist/client/rsc-fetch.d.ts +110 -28
  336. package/dist/client/rsc-fetch.d.ts.map +1 -1
  337. package/dist/client/segment-cache.d.ts +186 -25
  338. package/dist/client/segment-cache.d.ts.map +1 -1
  339. package/dist/client/segment-context.d.ts.map +1 -1
  340. package/dist/client/segment-outlet.d.ts +68 -0
  341. package/dist/client/segment-outlet.d.ts.map +1 -0
  342. package/dist/client/segment-update-context.d.ts +15 -0
  343. package/dist/client/segment-update-context.d.ts.map +1 -0
  344. package/dist/client/shallow-url.d.ts +10 -0
  345. package/dist/client/shallow-url.d.ts.map +1 -0
  346. package/dist/client/slot-content-cache-context.d.ts +35 -0
  347. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  348. package/dist/client/slot-context.d.ts +31 -0
  349. package/dist/client/slot-context.d.ts.map +1 -0
  350. package/dist/client/slot-outlet.d.ts +16 -0
  351. package/dist/client/slot-outlet.d.ts.map +1 -0
  352. package/dist/client/slot-provider.d.ts +25 -0
  353. package/dist/client/slot-provider.d.ts.map +1 -0
  354. package/dist/client/ssr-data.d.ts +26 -50
  355. package/dist/client/ssr-data.d.ts.map +1 -1
  356. package/dist/client/stale-client.d.ts +69 -0
  357. package/dist/client/stale-client.d.ts.map +1 -0
  358. package/dist/client/state.d.ts +21 -13
  359. package/dist/client/state.d.ts.map +1 -1
  360. package/dist/client/status-page-marker.d.ts +25 -0
  361. package/dist/client/status-page-marker.d.ts.map +1 -0
  362. package/dist/client/top-loader.d.ts +7 -6
  363. package/dist/client/top-loader.d.ts.map +1 -1
  364. package/dist/client/unload-guard.d.ts +5 -0
  365. package/dist/client/unload-guard.d.ts.map +1 -1
  366. package/dist/client/use-cookie.d.ts +12 -0
  367. package/dist/client/use-cookie.d.ts.map +1 -1
  368. package/dist/client/use-field-state.d.ts +42 -0
  369. package/dist/client/use-field-state.d.ts.map +1 -0
  370. package/dist/client/use-link-status.d.ts +5 -5
  371. package/dist/client/use-link-status.d.ts.map +1 -1
  372. package/dist/client/use-pathname.d.ts +13 -11
  373. package/dist/client/use-pathname.d.ts.map +1 -1
  374. package/dist/client/use-pending-navigation.d.ts +23 -0
  375. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  376. package/dist/client/use-query-states.d.ts +10 -4
  377. package/dist/client/use-query-states.d.ts.map +1 -1
  378. package/dist/client/use-router.d.ts +15 -8
  379. package/dist/client/use-router.d.ts.map +1 -1
  380. package/dist/client/use-search-params.d.ts +15 -8
  381. package/dist/client/use-search-params.d.ts.map +1 -1
  382. package/dist/client/use-segment-params.d.ts +55 -0
  383. package/dist/client/use-segment-params.d.ts.map +1 -0
  384. package/dist/codec.d.ts +69 -0
  385. package/dist/codec.d.ts.map +1 -0
  386. package/dist/codec.js +76 -0
  387. package/dist/codec.js.map +1 -0
  388. package/dist/config-types.d.ts +321 -0
  389. package/dist/config-types.d.ts.map +1 -0
  390. package/dist/config-validation.d.ts +68 -0
  391. package/dist/config-validation.d.ts.map +1 -0
  392. package/dist/cookies/define-cookie.d.ts +58 -25
  393. package/dist/cookies/define-cookie.d.ts.map +1 -1
  394. package/dist/cookies/index.d.ts +3 -2
  395. package/dist/cookies/index.d.ts.map +1 -1
  396. package/dist/cookies/index.js +256 -36
  397. package/dist/cookies/index.js.map +1 -1
  398. package/dist/cookies/json-cookie.d.ts +64 -0
  399. package/dist/cookies/json-cookie.d.ts.map +1 -0
  400. package/dist/cookies/validation.d.ts +34 -0
  401. package/dist/cookies/validation.d.ts.map +1 -0
  402. package/dist/dev-tools/404-page.d.ts +50 -0
  403. package/dist/dev-tools/404-page.d.ts.map +1 -0
  404. package/dist/dev-tools/browser-logs.d.ts +40 -0
  405. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  406. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  407. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  408. package/dist/dev-tools/error-page.d.ts +32 -0
  409. package/dist/dev-tools/error-page.d.ts.map +1 -0
  410. package/dist/dev-tools/holding-server.d.ts +46 -0
  411. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  412. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  413. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  414. package/dist/dev-tools/index.d.ts +31 -0
  415. package/dist/dev-tools/index.d.ts.map +1 -0
  416. package/dist/dev-tools/instrumentation.d.ts +74 -0
  417. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  418. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  419. package/dist/dev-tools/logger.d.ts.map +1 -0
  420. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +17 -3
  421. package/dist/dev-tools/logs.d.ts.map +1 -0
  422. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  423. package/dist/dev-tools/overlay.d.ts.map +1 -0
  424. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  425. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  426. package/dist/dev-tools/terminal.d.ts +28 -0
  427. package/dist/dev-tools/terminal.d.ts.map +1 -0
  428. package/dist/fonts/ast-walk.d.ts +68 -0
  429. package/dist/fonts/ast-walk.d.ts.map +1 -0
  430. package/dist/fonts/ast.d.ts +112 -8
  431. package/dist/fonts/ast.d.ts.map +1 -1
  432. package/dist/fonts/bundle.d.ts +50 -0
  433. package/dist/fonts/bundle.d.ts.map +1 -0
  434. package/dist/fonts/css.d.ts +1 -1
  435. package/dist/fonts/dev-middleware.d.ts +22 -0
  436. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  437. package/dist/fonts/fallbacks.d.ts +0 -7
  438. package/dist/fonts/fallbacks.d.ts.map +1 -1
  439. package/dist/fonts/google.d.ts +5 -3
  440. package/dist/fonts/google.d.ts.map +1 -1
  441. package/dist/fonts/local.d.ts +5 -5
  442. package/dist/fonts/local.d.ts.map +1 -1
  443. package/dist/fonts/paths.d.ts +43 -0
  444. package/dist/fonts/paths.d.ts.map +1 -0
  445. package/dist/fonts/pipeline.d.ts +177 -0
  446. package/dist/fonts/pipeline.d.ts.map +1 -0
  447. package/dist/fonts/transform.d.ts +82 -0
  448. package/dist/fonts/transform.d.ts.map +1 -0
  449. package/dist/fonts/types.d.ts +47 -1
  450. package/dist/fonts/types.d.ts.map +1 -1
  451. package/dist/fonts/virtual-modules.d.ts +77 -0
  452. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  453. package/dist/index.d.ts +35 -181
  454. package/dist/index.d.ts.map +1 -1
  455. package/dist/index.js +8877 -14232
  456. package/dist/index.js.map +1 -1
  457. package/dist/params/codec-registry.d.ts +26 -0
  458. package/dist/params/codec-registry.d.ts.map +1 -0
  459. package/dist/params/define-schema.d.ts +81 -0
  460. package/dist/params/define-schema.d.ts.map +1 -0
  461. package/dist/params/index.d.ts +5 -0
  462. package/dist/params/index.d.ts.map +1 -0
  463. package/dist/params/index.js +34 -0
  464. package/dist/params/index.js.map +1 -0
  465. package/dist/params/resolve-schema.d.ts +34 -0
  466. package/dist/params/resolve-schema.d.ts.map +1 -0
  467. package/dist/plugin-context.d.ts +262 -0
  468. package/dist/plugin-context.d.ts.map +1 -0
  469. package/dist/plugins/build-manifest.d.ts +7 -3
  470. package/dist/plugins/build-manifest.d.ts.map +1 -1
  471. package/dist/plugins/build-report.d.ts +61 -11
  472. package/dist/plugins/build-report.d.ts.map +1 -1
  473. package/dist/plugins/cache.d.ts +64 -0
  474. package/dist/plugins/cache.d.ts.map +1 -0
  475. package/dist/plugins/callsite-ast.d.ts +117 -0
  476. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  477. package/dist/plugins/callsite-jsx.d.ts +35 -0
  478. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  479. package/dist/plugins/chunks.d.ts +11 -4
  480. package/dist/plugins/chunks.d.ts.map +1 -1
  481. package/dist/plugins/client-chunks.d.ts +40 -0
  482. package/dist/plugins/client-chunks.d.ts.map +1 -0
  483. package/dist/plugins/client-dep-entries.d.ts +80 -0
  484. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  485. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  486. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  487. package/dist/plugins/content.d.ts +1 -1
  488. package/dist/plugins/content.d.ts.map +1 -1
  489. package/dist/plugins/dev-discovery.d.ts +123 -0
  490. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  491. package/dist/plugins/dev-server.d.ts +24 -1
  492. package/dist/plugins/dev-server.d.ts.map +1 -1
  493. package/dist/plugins/encryption-runtime.d.ts +13 -0
  494. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  495. package/dist/plugins/entries.d.ts +35 -4
  496. package/dist/plugins/entries.d.ts.map +1 -1
  497. package/dist/plugins/fonts.d.ts +35 -74
  498. package/dist/plugins/fonts.d.ts.map +1 -1
  499. package/dist/plugins/graph-endpoint.d.ts +112 -0
  500. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  501. package/dist/plugins/mdx.d.ts +18 -5
  502. package/dist/plugins/mdx.d.ts.map +1 -1
  503. package/dist/plugins/post-build.d.ts +110 -0
  504. package/dist/plugins/post-build.d.ts.map +1 -0
  505. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  506. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  507. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  508. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt.d.ts +98 -0
  510. package/dist/plugins/prebuilt.d.ts.map +1 -0
  511. package/dist/plugins/prerender-sugar.d.ts +39 -0
  512. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  513. package/dist/plugins/react-resolve.d.ts +49 -0
  514. package/dist/plugins/react-resolve.d.ts.map +1 -0
  515. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  516. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  517. package/dist/plugins/request-dep/index.d.ts +75 -0
  518. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/origin.d.ts +61 -0
  520. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  521. package/dist/plugins/routing.d.ts +1 -1
  522. package/dist/plugins/routing.d.ts.map +1 -1
  523. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  524. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  525. package/dist/plugins/server-bundle.d.ts +1 -1
  526. package/dist/plugins/server-bundle.d.ts.map +1 -1
  527. package/dist/plugins/shims.d.ts +29 -5
  528. package/dist/plugins/shims.d.ts.map +1 -1
  529. package/dist/plugins/static-build.d.ts +246 -26
  530. package/dist/plugins/static-build.d.ts.map +1 -1
  531. package/dist/routing/codegen-shared.d.ts +26 -0
  532. package/dist/routing/codegen-shared.d.ts.map +1 -0
  533. package/dist/routing/codegen-types.d.ts +61 -0
  534. package/dist/routing/codegen-types.d.ts.map +1 -0
  535. package/dist/routing/codegen-write.d.ts +42 -0
  536. package/dist/routing/codegen-write.d.ts.map +1 -0
  537. package/dist/routing/codegen.d.ts +8 -3
  538. package/dist/routing/codegen.d.ts.map +1 -1
  539. package/dist/routing/collision-probe.d.ts +104 -0
  540. package/dist/routing/collision-probe.d.ts.map +1 -0
  541. package/dist/routing/collision-spaces.d.ts +26 -0
  542. package/dist/routing/collision-spaces.d.ts.map +1 -0
  543. package/dist/routing/convention-lint.d.ts +55 -0
  544. package/dist/routing/convention-lint.d.ts.map +1 -0
  545. package/dist/routing/export-detect.d.ts +91 -0
  546. package/dist/routing/export-detect.d.ts.map +1 -0
  547. package/dist/routing/file-cache.d.ts +8 -0
  548. package/dist/routing/file-cache.d.ts.map +1 -0
  549. package/dist/routing/index.d.ts +13 -7
  550. package/dist/routing/index.d.ts.map +1 -1
  551. package/dist/routing/index.js +5 -2
  552. package/dist/routing/interception-overlap.d.ts +35 -0
  553. package/dist/routing/interception-overlap.d.ts.map +1 -0
  554. package/dist/routing/interception.d.ts +234 -10
  555. package/dist/routing/interception.d.ts.map +1 -1
  556. package/dist/routing/link-codegen.d.ts +105 -0
  557. package/dist/routing/link-codegen.d.ts.map +1 -0
  558. package/dist/routing/manifest-codegen.d.ts +26 -0
  559. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  560. package/dist/routing/scanner.d.ts +14 -10
  561. package/dist/routing/scanner.d.ts.map +1 -1
  562. package/dist/routing/schema-validation.d.ts +35 -0
  563. package/dist/routing/schema-validation.d.ts.map +1 -0
  564. package/dist/routing/segment-classify.d.ts +114 -0
  565. package/dist/routing/segment-classify.d.ts.map +1 -0
  566. package/dist/routing/segment-codegen.d.ts +38 -0
  567. package/dist/routing/segment-codegen.d.ts.map +1 -0
  568. package/dist/routing/segment-keys.d.ts +118 -0
  569. package/dist/routing/segment-keys.d.ts.map +1 -0
  570. package/dist/routing/slot-placement.d.ts +48 -0
  571. package/dist/routing/slot-placement.d.ts.map +1 -0
  572. package/dist/routing/types.d.ts +81 -26
  573. package/dist/routing/types.d.ts.map +1 -1
  574. package/dist/routing/walkers.d.ts +57 -0
  575. package/dist/routing/walkers.d.ts.map +1 -0
  576. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  577. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  578. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  579. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  580. package/dist/rsc-runtime/rsc.d.ts +6 -2
  581. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  582. package/dist/rsc-runtime/ssr.d.ts +8 -0
  583. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  584. package/dist/rsc-runtime/transforms.d.ts +13 -0
  585. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  586. package/dist/schema-bridge.d.ts +145 -0
  587. package/dist/schema-bridge.d.ts.map +1 -0
  588. package/dist/search-params/define.d.ts +262 -0
  589. package/dist/search-params/define.d.ts.map +1 -0
  590. package/dist/search-params/index.d.ts +3 -7
  591. package/dist/search-params/index.d.ts.map +1 -1
  592. package/dist/search-params/index.js +179 -360
  593. package/dist/search-params/index.js.map +1 -1
  594. package/dist/search-params/parse-total.d.ts +81 -0
  595. package/dist/search-params/parse-total.d.ts.map +1 -0
  596. package/dist/search-params/serialize-equal.d.ts +9 -0
  597. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  598. package/dist/search-params/wrappers.d.ts +76 -0
  599. package/dist/search-params/wrappers.d.ts.map +1 -0
  600. package/dist/server/access-gate.d.ts +98 -10
  601. package/dist/server/access-gate.d.ts.map +1 -1
  602. package/dist/server/action-client.d.ts +20 -133
  603. package/dist/server/action-client.d.ts.map +1 -1
  604. package/dist/server/action-encryption.d.ts +76 -0
  605. package/dist/server/action-encryption.d.ts.map +1 -0
  606. package/dist/server/action-handler.d.ts +58 -11
  607. package/dist/server/action-handler.d.ts.map +1 -1
  608. package/dist/server/action-schema.d.ts +126 -0
  609. package/dist/server/action-schema.d.ts.map +1 -0
  610. package/dist/server/action-types.d.ts +108 -0
  611. package/dist/server/action-types.d.ts.map +1 -0
  612. package/dist/server/actions.d.ts +78 -40
  613. package/dist/server/actions.d.ts.map +1 -1
  614. package/dist/server/als-registry.d.ts +189 -17
  615. package/dist/server/als-registry.d.ts.map +1 -1
  616. package/dist/server/body-limits.d.ts.map +1 -1
  617. package/dist/server/build-manifest.d.ts +25 -30
  618. package/dist/server/build-manifest.d.ts.map +1 -1
  619. package/dist/server/canonicalize.d.ts +32 -0
  620. package/dist/server/canonicalize.d.ts.map +1 -1
  621. package/dist/server/chain-url-parts.d.ts +82 -0
  622. package/dist/server/chain-url-parts.d.ts.map +1 -0
  623. package/dist/server/children-interception.d.ts +49 -0
  624. package/dist/server/children-interception.d.ts.map +1 -0
  625. package/dist/server/client-error-message.d.ts +12 -0
  626. package/dist/server/client-error-message.d.ts.map +1 -0
  627. package/dist/server/coalesce-tick.d.ts +40 -0
  628. package/dist/server/coalesce-tick.d.ts.map +1 -0
  629. package/dist/server/compress.d.ts +2 -0
  630. package/dist/server/compress.d.ts.map +1 -1
  631. package/dist/server/cookie-context.d.ts +149 -0
  632. package/dist/server/cookie-context.d.ts.map +1 -0
  633. package/dist/server/cookie-parsing.d.ts +65 -0
  634. package/dist/server/cookie-parsing.d.ts.map +1 -0
  635. package/dist/server/csp-nonce.d.ts +36 -0
  636. package/dist/server/csp-nonce.d.ts.map +1 -0
  637. package/dist/server/csrf.d.ts +58 -15
  638. package/dist/server/csrf.d.ts.map +1 -1
  639. package/dist/server/debug.d.ts +0 -1
  640. package/dist/server/debug.d.ts.map +1 -1
  641. package/dist/server/default-logger.d.ts +23 -0
  642. package/dist/server/default-logger.d.ts.map +1 -0
  643. package/dist/server/default-status-page.d.ts +45 -0
  644. package/dist/server/default-status-page.d.ts.map +1 -0
  645. package/dist/server/deny-boundary.d.ts +257 -0
  646. package/dist/server/deny-boundary.d.ts.map +1 -0
  647. package/dist/server/deny-renderer.d.ts +22 -15
  648. package/dist/server/deny-renderer.d.ts.map +1 -1
  649. package/dist/server/early-hints-sender.d.ts.map +1 -1
  650. package/dist/server/early-hints.d.ts +14 -12
  651. package/dist/server/early-hints.d.ts.map +1 -1
  652. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  653. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  654. package/dist/server/error-response-headers.d.ts +3 -0
  655. package/dist/server/error-response-headers.d.ts.map +1 -0
  656. package/dist/server/fallback-error.d.ts +19 -7
  657. package/dist/server/fallback-error.d.ts.map +1 -1
  658. package/dist/server/flight-injection-state.d.ts +66 -0
  659. package/dist/server/flight-injection-state.d.ts.map +1 -0
  660. package/dist/server/flight-injector-core.d.ts +125 -0
  661. package/dist/server/flight-injector-core.d.ts.map +1 -0
  662. package/dist/server/flight-scripts.d.ts +63 -0
  663. package/dist/server/flight-scripts.d.ts.map +1 -0
  664. package/dist/server/flight-source-node.d.ts +105 -0
  665. package/dist/server/flight-source-node.d.ts.map +1 -0
  666. package/dist/server/flight-source.d.ts +136 -0
  667. package/dist/server/flight-source.d.ts.map +1 -0
  668. package/dist/server/form-data.d.ts +59 -2
  669. package/dist/server/form-data.d.ts.map +1 -1
  670. package/dist/server/form-state-flight.d.ts +32 -0
  671. package/dist/server/form-state-flight.d.ts.map +1 -0
  672. package/dist/server/head-response.d.ts +35 -0
  673. package/dist/server/head-response.d.ts.map +1 -0
  674. package/dist/server/html-injector-core.d.ts +169 -0
  675. package/dist/server/html-injector-core.d.ts.map +1 -0
  676. package/dist/server/html-injectors.d.ts +77 -47
  677. package/dist/server/html-injectors.d.ts.map +1 -1
  678. package/dist/server/index.d.ts +16 -54
  679. package/dist/server/index.d.ts.map +1 -1
  680. package/dist/server/index.js +638 -3021
  681. package/dist/server/index.js.map +1 -1
  682. package/dist/server/instrumentation.d.ts +11 -4
  683. package/dist/server/instrumentation.d.ts.map +1 -1
  684. package/dist/server/internal.d.ts +47 -0
  685. package/dist/server/internal.d.ts.map +1 -0
  686. package/dist/server/internal.js +4649 -0
  687. package/dist/server/internal.js.map +1 -0
  688. package/dist/server/json-status-response.d.ts +34 -0
  689. package/dist/server/json-status-response.d.ts.map +1 -0
  690. package/dist/server/logger.d.ts +79 -7
  691. package/dist/server/logger.d.ts.map +1 -1
  692. package/dist/server/metadata-collector.d.ts +75 -0
  693. package/dist/server/metadata-collector.d.ts.map +1 -0
  694. package/dist/server/metadata-platform.d.ts +2 -2
  695. package/dist/server/metadata-render.d.ts +2 -2
  696. package/dist/server/metadata-render.d.ts.map +1 -1
  697. package/dist/server/metadata-route-links.d.ts +70 -0
  698. package/dist/server/metadata-route-links.d.ts.map +1 -0
  699. package/dist/server/metadata-routes.d.ts +47 -11
  700. package/dist/server/metadata-routes.d.ts.map +1 -1
  701. package/dist/server/metadata-social.d.ts +2 -2
  702. package/dist/server/metadata.d.ts +10 -2
  703. package/dist/server/metadata.d.ts.map +1 -1
  704. package/dist/server/middleware-runner.d.ts +20 -5
  705. package/dist/server/middleware-runner.d.ts.map +1 -1
  706. package/dist/server/node-body-response.d.ts +55 -0
  707. package/dist/server/node-body-response.d.ts.map +1 -0
  708. package/dist/server/node-response.d.ts +62 -0
  709. package/dist/server/node-response.d.ts.map +1 -0
  710. package/dist/server/node-stream-transforms.d.ts +108 -0
  711. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  712. package/dist/server/node-streams-platform.d.ts +21 -0
  713. package/dist/server/node-streams-platform.d.ts.map +1 -0
  714. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  715. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  716. package/dist/server/param-coercion.d.ts +83 -0
  717. package/dist/server/param-coercion.d.ts.map +1 -0
  718. package/dist/server/pipeline-helpers.d.ts +224 -0
  719. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  720. package/dist/server/pipeline-interception.d.ts +70 -9
  721. package/dist/server/pipeline-interception.d.ts.map +1 -1
  722. package/dist/server/pipeline-metadata.d.ts +16 -1
  723. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  724. package/dist/server/pipeline-outcome.d.ts +59 -0
  725. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  726. package/dist/server/pipeline-phases.d.ts +70 -0
  727. package/dist/server/pipeline-phases.d.ts.map +1 -0
  728. package/dist/server/pipeline.d.ts +161 -23
  729. package/dist/server/pipeline.d.ts.map +1 -1
  730. package/dist/server/port-resolution.d.ts +22 -0
  731. package/dist/server/port-resolution.d.ts.map +1 -0
  732. package/dist/server/prebuilt/cache-key.d.ts +63 -0
  733. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  734. package/dist/server/prebuilt/capture-render.d.ts +25 -0
  735. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  736. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  737. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  738. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  739. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  740. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  741. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  742. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  743. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  744. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  745. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  746. package/dist/server/prebuilt/overlay.d.ts +100 -0
  747. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  748. package/dist/server/prebuilt/payload-source.d.ts +79 -0
  749. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  750. package/dist/server/prebuilt/slots.d.ts +106 -0
  751. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  752. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  753. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  754. package/dist/server/prebuilt-builder.d.ts +121 -0
  755. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  756. package/dist/server/prebuilt-runtime.d.ts +110 -0
  757. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  758. package/dist/server/primitives.d.ts +101 -90
  759. package/dist/server/primitives.d.ts.map +1 -1
  760. package/dist/server/publish-params.d.ts +33 -0
  761. package/dist/server/publish-params.d.ts.map +1 -0
  762. package/dist/server/react-cache-bridge.d.ts +59 -0
  763. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  764. package/dist/server/react-cache-scope.d.ts +49 -0
  765. package/dist/server/react-cache-scope.d.ts.map +1 -0
  766. package/dist/server/render-timeout.d.ts +66 -0
  767. package/dist/server/render-timeout.d.ts.map +1 -0
  768. package/dist/server/render-utils.d.ts +35 -0
  769. package/dist/server/render-utils.d.ts.map +1 -0
  770. package/dist/server/request-context.d.ts +153 -103
  771. package/dist/server/request-context.d.ts.map +1 -1
  772. package/dist/server/request-dep.d.ts +15 -0
  773. package/dist/server/request-dep.d.ts.map +1 -0
  774. package/dist/server/response-cache-policy.d.ts +3 -0
  775. package/dist/server/response-cache-policy.d.ts.map +1 -0
  776. package/dist/server/route-element-builder.d.ts +57 -30
  777. package/dist/server/route-element-builder.d.ts.map +1 -1
  778. package/dist/server/route-element-helpers.d.ts +12 -0
  779. package/dist/server/route-element-helpers.d.ts.map +1 -0
  780. package/dist/server/route-handler.d.ts +1 -1
  781. package/dist/server/route-handler.d.ts.map +1 -1
  782. package/dist/server/route-matcher.d.ts +62 -38
  783. package/dist/server/route-matcher.d.ts.map +1 -1
  784. package/dist/server/route-module-loader.d.ts +37 -0
  785. package/dist/server/route-module-loader.d.ts.map +1 -0
  786. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  787. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  788. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  789. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  790. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  791. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  792. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  793. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  794. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  795. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  796. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  797. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  798. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  799. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  800. package/dist/server/rsc-entry/index.d.ts +30 -6
  801. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  802. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  803. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  804. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  805. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  807. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  808. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  809. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  811. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  813. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  814. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  815. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  816. package/dist/server/rsc-error-envelope.d.ts +11 -0
  817. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  818. package/dist/server/safe-load.d.ts +39 -0
  819. package/dist/server/safe-load.d.ts.map +1 -0
  820. package/dist/server/schema-introspection.d.ts +68 -0
  821. package/dist/server/schema-introspection.d.ts.map +1 -0
  822. package/dist/server/sensitive-fields.d.ts +88 -0
  823. package/dist/server/sensitive-fields.d.ts.map +1 -0
  824. package/dist/server/signal-identity.d.ts +43 -0
  825. package/dist/server/signal-identity.d.ts.map +1 -0
  826. package/dist/server/sitemap-generator.d.ts +130 -0
  827. package/dist/server/sitemap-generator.d.ts.map +1 -0
  828. package/dist/server/sitemap-handler.d.ts +22 -0
  829. package/dist/server/sitemap-handler.d.ts.map +1 -0
  830. package/dist/server/skippable-prefix.d.ts +29 -0
  831. package/dist/server/skippable-prefix.d.ts.map +1 -0
  832. package/dist/server/slot-interception.d.ts +80 -0
  833. package/dist/server/slot-interception.d.ts.map +1 -0
  834. package/dist/server/slot-resolver.d.ts +138 -7
  835. package/dist/server/slot-resolver.d.ts.map +1 -1
  836. package/dist/server/slot-subtree-contain.d.ts +54 -0
  837. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  838. package/dist/server/ssr-bridge-types.d.ts +213 -0
  839. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  840. package/dist/server/ssr-entry.d.ts +15 -51
  841. package/dist/server/ssr-entry.d.ts.map +1 -1
  842. package/dist/server/ssr-form-state.d.ts +30 -0
  843. package/dist/server/ssr-form-state.d.ts.map +1 -0
  844. package/dist/server/ssr-render.d.ts +59 -32
  845. package/dist/server/ssr-render.d.ts.map +1 -1
  846. package/dist/server/ssr-wrappers.d.ts +93 -0
  847. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  848. package/dist/server/state-tree-diff.d.ts +44 -9
  849. package/dist/server/state-tree-diff.d.ts.map +1 -1
  850. package/dist/server/static-generator.d.ts +112 -0
  851. package/dist/server/static-generator.d.ts.map +1 -0
  852. package/dist/server/static-not-found.d.ts +52 -0
  853. package/dist/server/static-not-found.d.ts.map +1 -0
  854. package/dist/server/status-code-resolver.d.ts +26 -15
  855. package/dist/server/status-code-resolver.d.ts.map +1 -1
  856. package/dist/server/stream-utils.d.ts +93 -0
  857. package/dist/server/stream-utils.d.ts.map +1 -0
  858. package/dist/server/tracing.d.ts +57 -26
  859. package/dist/server/tracing.d.ts.map +1 -1
  860. package/dist/server/tree-match.d.ts +59 -0
  861. package/dist/server/tree-match.d.ts.map +1 -0
  862. package/dist/server/types.d.ts +89 -8
  863. package/dist/server/types.d.ts.map +1 -1
  864. package/dist/server/utils/element-type.d.ts +50 -0
  865. package/dist/server/utils/element-type.d.ts.map +1 -0
  866. package/dist/server/utils/escape-html.d.ts +14 -0
  867. package/dist/server/utils/escape-html.d.ts.map +1 -0
  868. package/dist/server/version-skew.d.ts +61 -0
  869. package/dist/server/version-skew.d.ts.map +1 -0
  870. package/dist/server/workers-cache-bridge.d.ts +26 -0
  871. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  872. package/dist/shared/als-slots.d.ts +42 -0
  873. package/dist/shared/als-slots.d.ts.map +1 -0
  874. package/dist/shared/base-path.d.ts +56 -0
  875. package/dist/shared/base-path.d.ts.map +1 -0
  876. package/dist/shared/csrf-reject.d.ts +16 -0
  877. package/dist/shared/csrf-reject.d.ts.map +1 -0
  878. package/dist/shared/error-digest.d.ts +28 -0
  879. package/dist/shared/error-digest.d.ts.map +1 -0
  880. package/dist/shared/flight-base64.d.ts +13 -0
  881. package/dist/shared/flight-base64.d.ts.map +1 -0
  882. package/dist/shared/flight-segment.d.ts +18 -0
  883. package/dist/shared/flight-segment.d.ts.map +1 -0
  884. package/dist/shared/form-state-flight.d.ts +32 -0
  885. package/dist/shared/form-state-flight.d.ts.map +1 -0
  886. package/dist/shared/href-validation.d.ts +49 -0
  887. package/dist/shared/href-validation.d.ts.map +1 -0
  888. package/dist/shared/merge-search-params.d.ts +22 -0
  889. package/dist/shared/merge-search-params.d.ts.map +1 -0
  890. package/dist/shared/param-value.d.ts +104 -0
  891. package/dist/shared/param-value.d.ts.map +1 -0
  892. package/dist/shared/payload-root.d.ts +110 -0
  893. package/dist/shared/payload-root.d.ts.map +1 -0
  894. package/dist/shared/redirect-type.d.ts +17 -0
  895. package/dist/shared/redirect-type.d.ts.map +1 -0
  896. package/dist/shared/rsc-cache-key.d.ts +163 -0
  897. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  898. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  899. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  900. package/dist/shared/rsc-manifest.d.ts +28 -0
  901. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  902. package/dist/shared/rsc-media-type.d.ts +52 -0
  903. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  904. package/dist/shared/rsc-payload-path.d.ts +48 -0
  905. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  906. package/dist/shared/segment-info.d.ts +66 -0
  907. package/dist/shared/segment-info.d.ts.map +1 -0
  908. package/dist/shared/slot-params.d.ts +52 -0
  909. package/dist/shared/slot-params.d.ts.map +1 -0
  910. package/dist/shared/static-platform-files.d.ts +71 -0
  911. package/dist/shared/static-platform-files.d.ts.map +1 -0
  912. package/dist/shared/status-reason-phrase.d.ts +26 -0
  913. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  914. package/dist/shims/font-google.d.ts +1 -1
  915. package/dist/shims/font-google.d.ts.map +1 -1
  916. package/dist/shims/font-google.js +42 -0
  917. package/dist/shims/font-google.js.map +1 -0
  918. package/dist/shims/font-local.d.ts +26 -0
  919. package/dist/shims/font-local.d.ts.map +1 -0
  920. package/dist/shims/font-local.js +20 -0
  921. package/dist/shims/font-local.js.map +1 -0
  922. package/dist/shims/headers.d.ts +53 -1
  923. package/dist/shims/headers.d.ts.map +1 -1
  924. package/dist/shims/image.d.ts +120 -120
  925. package/dist/shims/image.d.ts.map +1 -1
  926. package/dist/shims/navigation-client.d.ts +25 -12
  927. package/dist/shims/navigation-client.d.ts.map +1 -1
  928. package/dist/shims/navigation-rsc.d.ts +21 -0
  929. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  930. package/dist/shims/navigation.d.ts +10 -5
  931. package/dist/shims/navigation.d.ts.map +1 -1
  932. package/dist/utils/state-machine.d.ts +80 -0
  933. package/dist/utils/state-machine.d.ts.map +1 -0
  934. package/dist/utils/write-file-atomic.d.ts +17 -0
  935. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  936. package/docs/api/30-api-server.mdx +239 -0
  937. package/docs/api/31-api-client.mdx +199 -0
  938. package/docs/api/32-api-cache.mdx +339 -0
  939. package/docs/api/33-api-search-params.mdx +176 -0
  940. package/docs/api/34-api-config.mdx +359 -0
  941. package/docs/api/35-api-typescript.mdx +91 -0
  942. package/docs/api/36-cli.mdx +206 -0
  943. package/docs/learn/00-introduction.mdx +109 -0
  944. package/docs/learn/01-quick-start.mdx +94 -0
  945. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  946. package/docs/learn/03-fetching-data.mdx +227 -0
  947. package/docs/learn/04-access-control.mdx +115 -0
  948. package/docs/learn/05-the-flush-point.mdx +175 -0
  949. package/docs/learn/06-typed-params.mdx +275 -0
  950. package/docs/learn/07-typed-routes.mdx +108 -0
  951. package/docs/learn/08-forms-and-actions.mdx +260 -0
  952. package/docs/learn/09-streaming.mdx +140 -0
  953. package/docs/learn/10-caching.mdx +270 -0
  954. package/docs/learn/11-middleware.mdx +164 -0
  955. package/docs/learn/12-error-handling.mdx +192 -0
  956. package/docs/learn/13-deploying.mdx +289 -0
  957. package/llms.txt +55 -0
  958. package/package.json +120 -29
  959. package/src/adapters/build-output-helper.ts +353 -0
  960. package/src/adapters/canonicalize-module.ts +29 -0
  961. package/src/adapters/cloudflare-dev.ts +183 -0
  962. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  963. package/src/adapters/cloudflare.ts +809 -150
  964. package/src/adapters/compress-module.ts +110 -86
  965. package/src/adapters/fs-identity.ts +155 -0
  966. package/src/adapters/nitro-immutable-assets.ts +142 -0
  967. package/src/adapters/nitro-presets.ts +124 -0
  968. package/src/adapters/nitro-preview.ts +533 -0
  969. package/src/adapters/nitro.ts +331 -445
  970. package/src/adapters/raw-imports.d.ts +5 -0
  971. package/src/adapters/shared.ts +283 -0
  972. package/src/adapters/types.ts +129 -17
  973. package/src/adapters/wrangler.d.ts +7 -0
  974. package/src/analyze/chains.ts +411 -0
  975. package/src/analyze/classify.ts +259 -0
  976. package/src/analyze/crawl-entry.ts +68 -0
  977. package/src/analyze/crawl.ts +500 -0
  978. package/src/analyze/graph-cache.ts +331 -0
  979. package/src/analyze/graph-command.ts +762 -0
  980. package/src/analyze/live-graph.ts +232 -0
  981. package/src/analyze/poison-rules.ts +165 -0
  982. package/src/analyze/poison-scan.ts +159 -0
  983. package/src/analyze/scan.ts +149 -0
  984. package/src/cache/cache-api.ts +107 -0
  985. package/src/cache/fast-hash.ts +5 -0
  986. package/src/cache/handler-store.ts +76 -0
  987. package/src/cache/index.ts +115 -22
  988. package/src/cache/invalidation-epoch.ts +93 -0
  989. package/src/cache/json-lossy-check.ts +69 -0
  990. package/src/cache/redis-handler.ts +198 -20
  991. package/src/cache/singleflight.ts +72 -6
  992. package/src/cache/sizeof.ts +35 -0
  993. package/src/cache/stable-stringify.ts +65 -2
  994. package/src/cache/store.ts +71 -0
  995. package/src/cache/stores/cloudflare-kv.ts +52 -0
  996. package/src/cache/stores/memory.ts +125 -0
  997. package/src/cache/stores/redis.ts +97 -0
  998. package/src/cache/stores/vercel.ts +59 -0
  999. package/src/cache/tag-aware-handler.ts +254 -0
  1000. package/src/cache/timber-cache.ts +165 -40
  1001. package/src/cdn/cloudflare-purge.ts +50 -0
  1002. package/src/cdn/fastly-purge.ts +63 -0
  1003. package/src/cdn/headers.ts +153 -0
  1004. package/src/cdn/index.ts +23 -0
  1005. package/src/cdn/purge-store.ts +34 -0
  1006. package/src/cdn/workers-cache-purge.ts +34 -0
  1007. package/src/cli-check.ts +417 -0
  1008. package/src/cli-context.ts +119 -0
  1009. package/src/cli-schema-sync.ts +401 -0
  1010. package/src/cli.ts +334 -80
  1011. package/src/client/browser-dev.ts +192 -5
  1012. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1013. package/src/client/browser-entry/action-queue.ts +152 -0
  1014. package/src/client/browser-entry/form-state.ts +49 -0
  1015. package/src/client/browser-entry/hmr.ts +70 -0
  1016. package/src/client/browser-entry/hydrate.ts +152 -0
  1017. package/src/client/browser-entry/index.ts +150 -0
  1018. package/src/client/browser-entry/post-hydration.ts +99 -0
  1019. package/src/client/browser-entry/router-init.ts +393 -0
  1020. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1021. package/src/client/browser-entry/scroll.ts +50 -0
  1022. package/src/client/deny-last-resort.tsx +54 -0
  1023. package/src/client/error-boundary.tsx +279 -61
  1024. package/src/client/error-reconstituter.tsx +84 -0
  1025. package/src/client/form.tsx +61 -173
  1026. package/src/client/global-context.ts +31 -0
  1027. package/src/client/history.ts +74 -11
  1028. package/src/client/index.ts +90 -53
  1029. package/src/client/internal.ts +54 -0
  1030. package/src/client/link.tsx +468 -151
  1031. package/src/client/location-search.ts +15 -0
  1032. package/src/client/navigation-api.ts +254 -0
  1033. package/src/client/navigation-commit.ts +318 -0
  1034. package/src/client/navigation-context.ts +67 -134
  1035. package/src/client/navigation-root.tsx +236 -0
  1036. package/src/client/navigation-transition.ts +348 -0
  1037. package/src/client/nuqs-adapter.tsx +21 -9
  1038. package/src/client/params-context.ts +187 -0
  1039. package/src/client/react-root.ts +105 -0
  1040. package/src/client/router-effects.ts +324 -0
  1041. package/src/client/router-lifecycle.ts +374 -0
  1042. package/src/client/router-pipeline.ts +456 -0
  1043. package/src/client/router-ref.ts +3 -3
  1044. package/src/client/router-skew.ts +30 -0
  1045. package/src/client/router-types.ts +346 -0
  1046. package/src/client/router-url.ts +32 -0
  1047. package/src/client/router.ts +500 -424
  1048. package/src/client/rsc-fetch.ts +510 -109
  1049. package/src/client/segment-cache.ts +362 -41
  1050. package/src/client/segment-context.ts +7 -4
  1051. package/src/client/segment-outlet.tsx +96 -0
  1052. package/src/client/segment-update-context.ts +23 -0
  1053. package/src/client/shallow-url.ts +22 -0
  1054. package/src/client/slot-content-cache-context.ts +43 -0
  1055. package/src/client/slot-context.ts +50 -0
  1056. package/src/client/slot-outlet.tsx +22 -0
  1057. package/src/client/slot-provider.tsx +32 -0
  1058. package/src/client/ssr-data.ts +27 -67
  1059. package/src/client/stale-client.ts +191 -0
  1060. package/src/client/state.ts +31 -24
  1061. package/src/client/status-page-marker.tsx +32 -0
  1062. package/src/client/top-loader.tsx +13 -10
  1063. package/src/client/unload-guard.ts +35 -3
  1064. package/src/client/use-cookie.ts +70 -18
  1065. package/src/client/use-field-state.ts +144 -0
  1066. package/src/client/use-link-status.ts +7 -7
  1067. package/src/client/use-pathname.ts +22 -31
  1068. package/src/client/use-pending-navigation.ts +40 -0
  1069. package/src/client/use-query-states.ts +206 -36
  1070. package/src/client/use-router.ts +31 -9
  1071. package/src/client/use-search-params.ts +38 -49
  1072. package/src/client/use-segment-params.ts +69 -0
  1073. package/src/client/use-selected-layout-segment.ts +2 -2
  1074. package/src/codec.ts +149 -0
  1075. package/src/config-types.ts +321 -0
  1076. package/src/config-validation.ts +464 -0
  1077. package/src/cookies/define-cookie.ts +222 -53
  1078. package/src/cookies/index.ts +13 -2
  1079. package/src/cookies/json-cookie.ts +105 -0
  1080. package/src/cookies/validation.ts +192 -0
  1081. package/src/dev-tools/404-page.ts +286 -0
  1082. package/src/dev-tools/browser-logs.ts +55 -0
  1083. package/src/dev-tools/dev-page-shell.ts +278 -0
  1084. package/src/dev-tools/error-page.ts +331 -0
  1085. package/src/dev-tools/holding-server.ts +185 -0
  1086. package/src/dev-tools/hydration-overlay.ts +158 -0
  1087. package/src/dev-tools/index.ts +79 -0
  1088. package/src/dev-tools/instrumentation.ts +261 -0
  1089. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1090. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
  1091. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1092. package/src/dev-tools/stack-classifier.ts +75 -0
  1093. package/src/dev-tools/terminal.ts +182 -0
  1094. package/src/fonts/ast-walk.ts +235 -0
  1095. package/src/fonts/ast.ts +479 -128
  1096. package/src/fonts/bundle.ts +138 -0
  1097. package/src/fonts/css.ts +1 -1
  1098. package/src/fonts/dev-middleware.ts +85 -0
  1099. package/src/fonts/fallbacks.ts +0 -23
  1100. package/src/fonts/google.ts +101 -19
  1101. package/src/fonts/local.ts +12 -11
  1102. package/src/fonts/paths.ts +58 -0
  1103. package/src/fonts/pipeline.ts +348 -0
  1104. package/src/fonts/transform.ts +311 -0
  1105. package/src/fonts/types.ts +52 -1
  1106. package/src/fonts/virtual-modules.ts +179 -0
  1107. package/src/index.ts +492 -380
  1108. package/src/params/codec-registry.ts +34 -0
  1109. package/src/params/define-schema.ts +115 -0
  1110. package/src/params/index.ts +17 -0
  1111. package/src/params/resolve-schema.ts +84 -0
  1112. package/src/plugin-context.ts +502 -0
  1113. package/src/plugins/build-manifest.ts +189 -36
  1114. package/src/plugins/build-report.ts +299 -87
  1115. package/src/plugins/cache.ts +243 -0
  1116. package/src/plugins/callsite-ast.ts +472 -0
  1117. package/src/plugins/callsite-jsx.ts +243 -0
  1118. package/src/plugins/chunks.ts +74 -5
  1119. package/src/plugins/client-chunks.ts +185 -0
  1120. package/src/plugins/client-dep-entries.ts +124 -0
  1121. package/src/plugins/cloudflare-wasm.ts +141 -0
  1122. package/src/plugins/content.ts +31 -2
  1123. package/src/plugins/dev-discovery.ts +218 -0
  1124. package/src/plugins/dev-server.ts +360 -97
  1125. package/src/plugins/encryption-runtime.ts +31 -0
  1126. package/src/plugins/entries.ts +150 -17
  1127. package/src/plugins/fonts.ts +260 -657
  1128. package/src/plugins/graph-endpoint.ts +532 -0
  1129. package/src/plugins/mdx.ts +108 -35
  1130. package/src/plugins/post-build.ts +327 -0
  1131. package/src/plugins/prebuilt-capture.ts +213 -0
  1132. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1133. package/src/plugins/prebuilt.ts +670 -0
  1134. package/src/plugins/prerender-sugar.ts +316 -0
  1135. package/src/plugins/react-resolve.ts +149 -0
  1136. package/src/plugins/request-dep/analysis.ts +447 -0
  1137. package/src/plugins/request-dep/index.ts +376 -0
  1138. package/src/plugins/request-dep/origin.ts +310 -0
  1139. package/src/plugins/routing.ts +273 -277
  1140. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1141. package/src/plugins/server-bundle.ts +115 -15
  1142. package/src/plugins/shims.ts +257 -97
  1143. package/src/plugins/static-build.ts +681 -71
  1144. package/src/react-canary.d.ts +2 -0
  1145. package/src/routing/codegen-shared.ts +39 -0
  1146. package/src/routing/codegen-types.ts +62 -0
  1147. package/src/routing/codegen-write.ts +163 -0
  1148. package/src/routing/codegen.ts +349 -232
  1149. package/src/routing/collision-probe.ts +438 -0
  1150. package/src/routing/collision-spaces.ts +281 -0
  1151. package/src/routing/convention-lint.ts +651 -0
  1152. package/src/routing/export-detect.ts +536 -0
  1153. package/src/routing/file-cache.ts +23 -0
  1154. package/src/routing/index.ts +16 -7
  1155. package/src/routing/interception-overlap.ts +141 -0
  1156. package/src/routing/interception.ts +1044 -67
  1157. package/src/routing/link-codegen.ts +280 -0
  1158. package/src/routing/manifest-codegen.ts +232 -0
  1159. package/src/routing/scanner.ts +417 -223
  1160. package/src/routing/schema-validation.ts +155 -0
  1161. package/src/routing/segment-classify.ts +280 -0
  1162. package/src/routing/segment-codegen.ts +99 -0
  1163. package/src/routing/segment-keys.ts +186 -0
  1164. package/src/routing/slot-placement.ts +97 -0
  1165. package/src/routing/types.ts +82 -26
  1166. package/src/routing/walkers.ts +98 -0
  1167. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1168. package/src/rsc-runtime/render-flight.ts +26 -0
  1169. package/src/rsc-runtime/rsc.ts +17 -2
  1170. package/src/rsc-runtime/ssr.ts +13 -0
  1171. package/src/rsc-runtime/transforms.ts +13 -0
  1172. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1173. package/src/schema-bridge.ts +382 -0
  1174. package/src/search-params/define.ts +677 -0
  1175. package/src/search-params/index.ts +14 -20
  1176. package/src/search-params/parse-total.ts +91 -0
  1177. package/src/search-params/serialize-equal.ts +14 -0
  1178. package/src/search-params/wrappers.ts +150 -0
  1179. package/src/server/access-gate.tsx +195 -56
  1180. package/src/server/action-client.ts +175 -294
  1181. package/src/server/action-encryption.ts +144 -0
  1182. package/src/server/action-handler.ts +492 -150
  1183. package/src/server/action-schema.ts +203 -0
  1184. package/src/server/action-types.ts +145 -0
  1185. package/src/server/actions.ts +172 -85
  1186. package/src/server/als-registry.ts +245 -30
  1187. package/src/server/body-limits.ts +10 -2
  1188. package/src/server/build-manifest.ts +33 -57
  1189. package/src/server/canonicalize.ts +35 -3
  1190. package/src/server/chain-url-parts.ts +163 -0
  1191. package/src/server/children-interception.ts +116 -0
  1192. package/src/server/client-error-message.ts +18 -0
  1193. package/src/server/coalesce-tick.ts +75 -0
  1194. package/src/server/compress.ts +91 -19
  1195. package/src/server/cookie-context.ts +454 -0
  1196. package/src/server/cookie-parsing.ts +163 -0
  1197. package/src/server/csp-nonce.ts +58 -0
  1198. package/src/server/csrf.ts +228 -35
  1199. package/src/server/debug.ts +0 -1
  1200. package/src/server/default-logger.ts +100 -0
  1201. package/src/server/default-status-page.ts +88 -0
  1202. package/src/server/deny-boundary.ts +527 -0
  1203. package/src/server/deny-renderer.ts +210 -181
  1204. package/src/server/early-hints-sender.ts +4 -3
  1205. package/src/server/early-hints.ts +39 -29
  1206. package/src/server/error-boundary-wrapper.ts +160 -44
  1207. package/src/server/error-response-headers.ts +18 -0
  1208. package/src/server/fallback-error.ts +88 -104
  1209. package/src/server/flight-injection-state.ts +113 -0
  1210. package/src/server/flight-injector-core.ts +328 -0
  1211. package/src/server/flight-scripts.ts +92 -0
  1212. package/src/server/flight-source-node.ts +430 -0
  1213. package/src/server/flight-source.ts +288 -0
  1214. package/src/server/form-data.ts +191 -20
  1215. package/src/server/form-state-flight.ts +67 -0
  1216. package/src/server/head-response.ts +50 -0
  1217. package/src/server/html-injector-core.ts +320 -0
  1218. package/src/server/html-injectors.ts +241 -285
  1219. package/src/server/index.ts +37 -195
  1220. package/src/server/instrumentation.ts +11 -4
  1221. package/src/server/internal.ts +168 -0
  1222. package/src/server/json-status-response.ts +105 -0
  1223. package/src/server/logger.ts +131 -38
  1224. package/src/server/metadata-collector.ts +175 -0
  1225. package/src/server/metadata-platform.ts +2 -2
  1226. package/src/server/metadata-render.ts +30 -8
  1227. package/src/server/metadata-route-links.ts +200 -0
  1228. package/src/server/metadata-routes.ts +114 -24
  1229. package/src/server/metadata-social.ts +2 -2
  1230. package/src/server/metadata.ts +23 -2
  1231. package/src/server/middleware-runner.ts +32 -5
  1232. package/src/server/node-body-response.ts +236 -0
  1233. package/src/server/node-response.ts +93 -0
  1234. package/src/server/node-stream-transforms.ts +340 -0
  1235. package/src/server/node-streams-platform.ts +23 -0
  1236. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1237. package/src/server/param-coercion.ts +201 -0
  1238. package/src/server/pipeline-helpers.ts +548 -0
  1239. package/src/server/pipeline-interception.ts +241 -32
  1240. package/src/server/pipeline-metadata.ts +25 -1
  1241. package/src/server/pipeline-outcome.ts +290 -0
  1242. package/src/server/pipeline-phases.ts +503 -0
  1243. package/src/server/pipeline.ts +423 -426
  1244. package/src/server/port-resolution.ts +43 -0
  1245. package/src/server/prebuilt/cache-key.ts +299 -0
  1246. package/src/server/prebuilt/capture-render.ts +118 -0
  1247. package/src/server/prebuilt/capture-routes.ts +104 -0
  1248. package/src/server/prebuilt/capture-state.ts +196 -0
  1249. package/src/server/prebuilt/key-discipline.ts +122 -0
  1250. package/src/server/prebuilt/lifetime.ts +151 -0
  1251. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1252. package/src/server/prebuilt/overlay.ts +256 -0
  1253. package/src/server/prebuilt/payload-source.ts +202 -0
  1254. package/src/server/prebuilt/slots.ts +202 -0
  1255. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1256. package/src/server/prebuilt-builder.ts +514 -0
  1257. package/src/server/prebuilt-runtime.ts +810 -0
  1258. package/src/server/primitives.ts +153 -171
  1259. package/src/server/publish-params.ts +42 -0
  1260. package/src/server/react-cache-bridge.ts +124 -0
  1261. package/src/server/react-cache-scope.ts +104 -0
  1262. package/src/server/render-timeout.ts +128 -0
  1263. package/src/server/render-utils.ts +45 -0
  1264. package/src/server/request-context.ts +298 -324
  1265. package/src/server/request-dep.ts +37 -0
  1266. package/src/server/response-cache-policy.ts +45 -0
  1267. package/src/server/route-element-builder.ts +526 -355
  1268. package/src/server/route-element-helpers.ts +37 -0
  1269. package/src/server/route-handler.ts +67 -27
  1270. package/src/server/route-matcher.ts +238 -267
  1271. package/src/server/route-module-loader.ts +161 -0
  1272. package/src/server/rsc-cache-key-guard.ts +122 -0
  1273. package/src/server/rsc-entry/action-dispatcher.ts +144 -0
  1274. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1275. package/src/server/rsc-entry/api-handler.ts +49 -81
  1276. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1277. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1278. package/src/server/rsc-entry/helpers.ts +90 -115
  1279. package/src/server/rsc-entry/index.ts +372 -350
  1280. package/src/server/rsc-entry/render-route.ts +248 -0
  1281. package/src/server/rsc-entry/render-signals.ts +108 -0
  1282. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1283. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1284. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1285. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1286. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1287. package/src/server/rsc-error-envelope.ts +18 -0
  1288. package/src/server/rsc-prop-warnings.ts +1 -1
  1289. package/src/server/safe-load.ts +53 -0
  1290. package/src/server/schema-introspection.ts +393 -0
  1291. package/src/server/sensitive-fields.ts +287 -0
  1292. package/src/server/server-only-guard-noop.js +3 -0
  1293. package/src/server/server-timing.ts +1 -1
  1294. package/src/server/signal-identity.ts +112 -0
  1295. package/src/server/sitemap-generator.ts +337 -0
  1296. package/src/server/sitemap-handler.ts +150 -0
  1297. package/src/server/skippable-prefix.ts +172 -0
  1298. package/src/server/slot-interception.ts +168 -0
  1299. package/src/server/slot-resolver.ts +707 -300
  1300. package/src/server/slot-subtree-contain.ts +273 -0
  1301. package/src/server/ssr-bridge-types.ts +217 -0
  1302. package/src/server/ssr-entry.ts +248 -109
  1303. package/src/server/ssr-form-state.ts +58 -0
  1304. package/src/server/ssr-render.ts +334 -101
  1305. package/src/server/ssr-wrappers.tsx +162 -0
  1306. package/src/server/state-tree-diff.ts +85 -30
  1307. package/src/server/static-generator.ts +680 -0
  1308. package/src/server/static-not-found.ts +134 -0
  1309. package/src/server/status-code-resolver.ts +107 -148
  1310. package/src/server/stream-utils.ts +398 -0
  1311. package/src/server/tracing.ts +163 -68
  1312. package/src/server/tree-match.ts +494 -0
  1313. package/src/server/types.ts +96 -11
  1314. package/src/server/utils/element-type.ts +88 -0
  1315. package/src/server/utils/escape-html.ts +20 -0
  1316. package/src/server/version-skew.ts +104 -0
  1317. package/src/server/waituntil-bridge.ts +1 -1
  1318. package/src/server/workers-cache-bridge.ts +33 -0
  1319. package/src/shared/als-slots.ts +74 -0
  1320. package/src/shared/base-path.ts +80 -0
  1321. package/src/shared/csrf-reject.ts +15 -0
  1322. package/src/shared/error-digest.ts +46 -0
  1323. package/src/shared/flight-base64.ts +23 -0
  1324. package/src/shared/flight-segment.ts +35 -0
  1325. package/src/shared/form-state-flight.ts +59 -0
  1326. package/src/shared/href-validation.ts +159 -0
  1327. package/src/shared/merge-search-params.ts +55 -0
  1328. package/src/shared/param-value.ts +281 -0
  1329. package/src/shared/payload-root.ts +153 -0
  1330. package/src/shared/redirect-type.ts +17 -0
  1331. package/src/shared/rsc-cache-key.ts +269 -0
  1332. package/src/shared/rsc-error-envelope.ts +16 -0
  1333. package/src/shared/rsc-manifest.ts +29 -0
  1334. package/src/shared/rsc-media-type.ts +59 -0
  1335. package/src/shared/rsc-payload-path.ts +52 -0
  1336. package/src/shared/segment-info.ts +67 -0
  1337. package/src/shared/slot-params.ts +109 -0
  1338. package/src/shared/static-platform-files.ts +75 -0
  1339. package/src/shared/status-reason-phrase.ts +61 -0
  1340. package/src/shims/font-google.ts +1 -1
  1341. package/src/shims/font-local.ts +34 -0
  1342. package/src/shims/headers.ts +122 -1
  1343. package/src/shims/navigation-client.ts +36 -32
  1344. package/src/shims/navigation-rsc.ts +47 -0
  1345. package/src/shims/navigation.ts +10 -7
  1346. package/src/utils/state-machine.ts +111 -0
  1347. package/src/utils/write-file-atomic.ts +32 -0
  1348. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1349. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1350. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1351. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1352. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1353. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1354. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1355. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1356. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1357. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1358. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1359. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1360. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1361. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1362. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1363. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1364. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1365. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1366. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1367. package/dist/adapters/cloudflare.js.map +0 -1
  1368. package/dist/cache/index.js.map +0 -1
  1369. package/dist/cache/register-cached-function.d.ts +0 -17
  1370. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1371. package/dist/client/browser-entry.d.ts +0 -21
  1372. package/dist/client/browser-entry.d.ts.map +0 -1
  1373. package/dist/client/error-boundary.js.map +0 -1
  1374. package/dist/client/head.d.ts +0 -16
  1375. package/dist/client/head.d.ts.map +0 -1
  1376. package/dist/client/link-status-provider.d.ts +0 -11
  1377. package/dist/client/link-status-provider.d.ts.map +0 -1
  1378. package/dist/client/segment-merger.d.ts +0 -119
  1379. package/dist/client/segment-merger.d.ts.map +0 -1
  1380. package/dist/client/stale-reload.d.ts +0 -44
  1381. package/dist/client/stale-reload.d.ts.map +0 -1
  1382. package/dist/client/transition-root.d.ts +0 -74
  1383. package/dist/client/transition-root.d.ts.map +0 -1
  1384. package/dist/client/types.d.ts +0 -14
  1385. package/dist/client/types.d.ts.map +0 -1
  1386. package/dist/client/use-navigation-pending.d.ts +0 -26
  1387. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1388. package/dist/client/use-params.d.ts +0 -92
  1389. package/dist/client/use-params.d.ts.map +0 -1
  1390. package/dist/content/index.d.ts +0 -11
  1391. package/dist/content/index.d.ts.map +0 -1
  1392. package/dist/content/index.js +0 -2
  1393. package/dist/plugins/adapter-build.d.ts +0 -18
  1394. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1395. package/dist/plugins/cache-transform.d.ts +0 -36
  1396. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1397. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1398. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1399. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1400. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1401. package/dist/plugins/server-action-exports.d.ts +0 -26
  1402. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1403. package/dist/routing/status-file-lint.d.ts +0 -33
  1404. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1405. package/dist/search-params/analyze.d.ts +0 -54
  1406. package/dist/search-params/analyze.d.ts.map +0 -1
  1407. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1408. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1409. package/dist/search-params/codecs.d.ts +0 -53
  1410. package/dist/search-params/codecs.d.ts.map +0 -1
  1411. package/dist/search-params/create.d.ts +0 -106
  1412. package/dist/search-params/create.d.ts.map +0 -1
  1413. package/dist/search-params/registry.d.ts +0 -20
  1414. package/dist/search-params/registry.d.ts.map +0 -1
  1415. package/dist/server/asset-headers.d.ts +0 -42
  1416. package/dist/server/asset-headers.d.ts.map +0 -1
  1417. package/dist/server/client-module-map.d.ts +0 -47
  1418. package/dist/server/client-module-map.d.ts.map +0 -1
  1419. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1420. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1421. package/dist/server/dev-logger.d.ts.map +0 -1
  1422. package/dist/server/dev-span-processor.d.ts +0 -29
  1423. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1424. package/dist/server/dev-warnings.d.ts +0 -129
  1425. package/dist/server/dev-warnings.d.ts.map +0 -1
  1426. package/dist/server/flush.d.ts +0 -74
  1427. package/dist/server/flush.d.ts.map +0 -1
  1428. package/dist/server/form-flash.d.ts +0 -78
  1429. package/dist/server/form-flash.d.ts.map +0 -1
  1430. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1431. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1432. package/dist/server/prerender.d.ts +0 -77
  1433. package/dist/server/prerender.d.ts.map +0 -1
  1434. package/dist/server/tree-builder.d.ts +0 -126
  1435. package/dist/server/tree-builder.d.ts.map +0 -1
  1436. package/dist/utils/directive-parser.d.ts +0 -70
  1437. package/dist/utils/directive-parser.d.ts.map +0 -1
  1438. package/src/cache/register-cached-function.ts +0 -103
  1439. package/src/client/browser-entry.ts +0 -678
  1440. package/src/client/head.ts +0 -61
  1441. package/src/client/link-status-provider.tsx +0 -30
  1442. package/src/client/segment-merger.ts +0 -339
  1443. package/src/client/stale-reload.ts +0 -87
  1444. package/src/client/transition-root.tsx +0 -166
  1445. package/src/client/types.ts +0 -21
  1446. package/src/client/use-navigation-pending.ts +0 -38
  1447. package/src/client/use-params.ts +0 -141
  1448. package/src/content/index.ts +0 -13
  1449. package/src/plugins/adapter-build.ts +0 -118
  1450. package/src/plugins/cache-transform.ts +0 -199
  1451. package/src/plugins/dynamic-transform.ts +0 -161
  1452. package/src/plugins/server-action-exports.ts +0 -220
  1453. package/src/routing/status-file-lint.ts +0 -112
  1454. package/src/search-params/analyze.ts +0 -192
  1455. package/src/search-params/builtin-codecs.ts +0 -228
  1456. package/src/search-params/codecs.ts +0 -153
  1457. package/src/search-params/create.ts +0 -321
  1458. package/src/search-params/registry.ts +0 -31
  1459. package/src/server/asset-headers.ts +0 -81
  1460. package/src/server/client-module-map.ts +0 -58
  1461. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1462. package/src/server/dev-span-processor.ts +0 -78
  1463. package/src/server/dev-warnings.ts +0 -283
  1464. package/src/server/flush.ts +0 -182
  1465. package/src/server/form-flash.ts +0 -89
  1466. package/src/server/manifest-status-resolver.ts +0 -215
  1467. package/src/server/prerender.ts +0 -139
  1468. package/src/server/tree-builder.ts +0 -382
  1469. package/src/shims/server-only-noop.js +0 -6
  1470. package/src/utils/directive-parser.ts +0 -529
@@ -5,141 +5,46 @@
5
5
  // compression, graceful shutdown, static file serving, and platform quirks.
6
6
  // See design/11-platform.md and design/25-production-deployments.md.
7
7
 
8
- import { writeFile, readFile, mkdir, cp } from 'node:fs/promises';
9
- import { execFile } from 'node:child_process';
10
- import { join, relative } from 'node:path';
11
- import type { TimberPlatformAdapter, TimberConfig } from './types';
12
- import { generateCompressModule } from './compress-module.js';
13
- // Inlined from server/asset-headers.ts — adapters are loaded by Node at
14
- // Vite startup time, before Vite's module resolver is available, so cross-
15
- // directory .ts imports don't resolve.
16
- const IMMUTABLE_CACHE = 'public, max-age=31536000, immutable';
17
- const STATIC_CACHE = 'public, max-age=3600, must-revalidate';
18
-
19
- function generateHeadersFile(): string {
20
- return `# Auto-generated by @timber-js/app — static asset cache headers.
21
- # See design/25-production-deployments.md §"CDN / Edge Cache"
22
-
23
- /assets/*
24
- Cache-Control: ${IMMUTABLE_CACHE}
25
-
26
- /*
27
- Cache-Control: ${STATIC_CACHE}
28
- `;
29
- }
8
+ import { existsSync } from 'node:fs';
9
+ import { cp, glob, readFile, writeFile } from 'node:fs/promises';
10
+ import { basename, dirname, join, relative, sep } from 'node:path';
11
+ import type { NitroConfig } from 'nitro/types';
12
+ import {
13
+ buildStaticDirectoryOutput,
14
+ runSharedBuildSteps,
15
+ writeHeadersFile,
16
+ } from './build-output-helper.ts';
17
+ import { generateCompressModule } from './compress-module.ts';
18
+ import { generateCanonicalizeModule } from './canonicalize-module.ts';
19
+ import { immutableAssetsEntryGuard, prepareImmutableAssets } from './nitro-immutable-assets.ts';
20
+ import { LOCALLY_PREVIEWABLE, PRESET_CONFIGS, type NitroPreset } from './nitro-presets.ts';
21
+ import {
22
+ generatePreviewScript,
23
+ generateSendResponseModule,
24
+ spawnNitroPreview,
25
+ } from './nitro-preview.ts';
26
+ import { adapterBase } from './shared.ts';
27
+ import type {
28
+ BuildArtifacts,
29
+ PreviewTarget,
30
+ TimberConfig,
31
+ TimberPlatformAdapter,
32
+ } from './types.ts';
33
+
34
+ // NitroPreset is part of the public adapter API (NitroAdapterOptions.preset),
35
+ // so it stays importable from this module.
36
+ export type { NitroPreset } from './nitro-presets.ts';
30
37
 
31
- // ─── Presets ─────────────────────────────────────────────────────────────────
38
+ // ─── Options ─────────────────────────────────────────────────────────────────
32
39
 
33
40
  /**
34
- * Supported Nitro deployment presets.
41
+ * Static deploy target for `output: 'static'` mode.
35
42
  *
36
- * Each preset maps to a Nitro deployment target. The adapter generates
37
- * the appropriate configuration and entry point for the selected platform.
43
+ * Controls platform-specific files written alongside the static output:
44
+ * - `'github-pages'` — writes `.nojekyll` to skip Jekyll processing
45
+ * - `'generic'` — no extra files (default)
38
46
  */
39
- export type NitroPreset =
40
- | 'vercel'
41
- | 'vercel-edge'
42
- | 'netlify'
43
- | 'netlify-edge'
44
- | 'aws-lambda'
45
- | 'deno-deploy'
46
- | 'azure-functions'
47
- | 'node-server'
48
- | 'bun';
49
-
50
- /** Preset-specific Nitro configuration. */
51
- interface PresetConfig {
52
- /** Nitro preset name passed to the Nitro build. */
53
- nitroPreset: string;
54
- /** Output directory name within the build dir. */
55
- outputDir: string;
56
- /** Whether the runtime supports waitUntil. */
57
- supportsWaitUntil: boolean;
58
- /** Whether the runtime supports application-level 103 Early Hints. */
59
- supportsEarlyHints: boolean;
60
- /** Value for TIMBER_RUNTIME env var. See design/25-production-deployments.md. */
61
- runtimeName: string;
62
- /** Additional nitro.config fields for this preset. */
63
- extraConfig?: Record<string, unknown>;
64
- }
65
-
66
- const PRESET_CONFIGS: Record<NitroPreset, PresetConfig> = {
67
- 'vercel': {
68
- nitroPreset: 'vercel',
69
- outputDir: '.vercel/output',
70
- supportsWaitUntil: true,
71
- supportsEarlyHints: false,
72
- runtimeName: 'vercel',
73
- extraConfig: { vercel: { functions: { maxDuration: 30 } } },
74
- },
75
- 'vercel-edge': {
76
- nitroPreset: 'vercel-edge',
77
- outputDir: '.vercel/output',
78
- supportsWaitUntil: true,
79
- supportsEarlyHints: false,
80
- runtimeName: 'vercel-edge',
81
- },
82
- 'netlify': {
83
- nitroPreset: 'netlify',
84
- outputDir: '.netlify/functions-internal',
85
- supportsWaitUntil: false,
86
- supportsEarlyHints: false,
87
- runtimeName: 'netlify',
88
- },
89
- 'netlify-edge': {
90
- nitroPreset: 'netlify-edge',
91
- outputDir: '.netlify/edge-functions',
92
- supportsWaitUntil: true,
93
- supportsEarlyHints: false,
94
- runtimeName: 'netlify-edge',
95
- },
96
- 'aws-lambda': {
97
- nitroPreset: 'aws-lambda',
98
- outputDir: '.output',
99
- supportsWaitUntil: false,
100
- supportsEarlyHints: false,
101
- runtimeName: 'aws-lambda',
102
- },
103
- 'deno-deploy': {
104
- nitroPreset: 'deno-deploy',
105
- outputDir: '.output',
106
- supportsWaitUntil: true,
107
- supportsEarlyHints: false,
108
- runtimeName: 'deno-deploy',
109
- },
110
- 'azure-functions': {
111
- nitroPreset: 'azure-functions',
112
- outputDir: '.output',
113
- supportsWaitUntil: false,
114
- supportsEarlyHints: false,
115
- runtimeName: 'azure-functions',
116
- },
117
- 'node-server': {
118
- nitroPreset: 'node-server',
119
- outputDir: '.output',
120
- supportsWaitUntil: true,
121
- // Disabled by default: most node-server deployments sit behind a
122
- // reverse proxy (nginx, caddy, traefik) that doesn't support 103
123
- // Early Hints over HTTP/1.1. Sending 103 causes nginx to intermittently
124
- // treat the response as an error and retry after proxy_connect_timeout
125
- // (~5s stalls on ~23% of requests). Link headers on the 200 response
126
- // are the safe fallback — Cloudflare and other CDNs convert them to
127
- // 103 automatically at the edge (over HTTP/2+ to the browser).
128
- supportsEarlyHints: false,
129
- runtimeName: 'node-server',
130
- },
131
- 'bun': {
132
- nitroPreset: 'bun',
133
- outputDir: '.output',
134
- supportsWaitUntil: true,
135
- // Disabled for same reason as node-server — reverse proxies choke on 103.
136
- // Link headers on the 200 response are converted to 103 by CDNs.
137
- supportsEarlyHints: false,
138
- runtimeName: 'bun',
139
- },
140
- };
141
-
142
- // ─── Options ─────────────────────────────────────────────────────────────────
47
+ export type StaticTarget = 'github-pages' | 'generic';
143
48
 
144
49
  /** Options for the Nitro adapter. */
145
50
  export interface NitroAdapterOptions {
@@ -166,11 +71,18 @@ export interface NitroAdapterOptions {
166
71
  */
167
72
  compress?: boolean;
168
73
 
74
+ /**
75
+ * Static deploy target for `output: 'static'` mode. Controls
76
+ * platform-specific files (e.g. `.nojekyll` for GitHub Pages).
77
+ * @default 'generic'
78
+ */
79
+ staticTarget?: StaticTarget;
80
+
169
81
  /**
170
82
  * Additional Nitro configuration to merge into the generated config.
171
83
  * Overrides default values for the selected preset.
172
84
  */
173
- nitroConfig?: Record<string, unknown>;
85
+ nitroConfig?: NitroConfig;
174
86
  }
175
87
 
176
88
  // ─── Adapter ─────────────────────────────────────────────────────────────────
@@ -194,105 +106,189 @@ export interface NitroAdapterOptions {
194
106
  export function nitro(options: NitroAdapterOptions = {}): TimberPlatformAdapter {
195
107
  const preset = options.preset ?? 'node-server';
196
108
  const compress = options.compress ?? true;
197
- const presetConfig = PRESET_CONFIGS[preset];
198
- const pendingPromises: Promise<unknown>[] = [];
199
-
200
109
  return {
201
110
  name: `nitro-${preset}`,
202
111
 
203
- async buildOutput(config: TimberConfig, buildDir: string) {
204
- const outDir = join(buildDir, 'nitro');
205
- await mkdir(outDir, { recursive: true });
206
-
207
- // Copy client assets to public directory.
208
- // When client JavaScript is disabled, skip .js files — only CSS,
209
- // fonts, images, and other static assets are needed.
210
- const clientDir = join(buildDir, 'client');
211
- const publicDir = join(outDir, 'public');
212
- await mkdir(publicDir, { recursive: true });
213
- await cp(clientDir, publicDir, {
214
- recursive: true,
215
- filter: config.clientJavascriptDisabled ? (src: string) => !src.endsWith('.js') : undefined,
216
- }).catch(() => {
217
- // Client dir may not exist when client JavaScript is disabled
218
- });
219
-
220
- // Write _headers file for platforms that support it (Netlify, etc.).
221
- // See design/25-production-deployments.md §"CDN / Edge Cache"
222
- await writeFile(join(publicDir, '_headers'), generateHeadersFile());
112
+ async buildOutput(config: TimberConfig, artifacts: BuildArtifacts) {
113
+ const outDir = join(artifacts.outputDir, 'nitro');
114
+
115
+ // ── Static mode: plain directory output ────────────────────────
116
+ // No Nitro server — just pre-rendered HTML + client assets.
117
+ if (artifacts.output === 'static') {
118
+ await buildStaticDirectoryOutput(config, artifacts, outDir, 'public');
119
+ const publicDir = join(outDir, 'public');
120
+
121
+ // Write _headers for cache control + extensionless Content-Type.
122
+ // Netlify supports the _headers convention just like Cloudflare.
123
+ await writeHeadersFile(publicDir, config, artifacts);
124
+
125
+ // Local preview serves the site as the build recorded it.
126
+ await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());
127
+ await writeFile(
128
+ join(outDir, PREVIEW_SCRIPT),
129
+ generatePreviewScript({
130
+ output: 'static',
131
+ immutableDirs: artifacts.immutableDirs,
132
+ base: adapterBase(config),
133
+ contentTypes: artifacts.contentTypes,
134
+ })
135
+ );
136
+
137
+ // Platform-specific files for static deploy targets.
138
+ const target = options.staticTarget ?? 'generic';
139
+ if (target === 'github-pages') {
140
+ // Deploy-from-a-branch runs Jekyll, which drops `_`-prefixed paths —
141
+ // every `_rsc/` payload. Written unconditionally: GitHub reads only
142
+ // that the file exists, never its contents.
143
+ await writeFile(join(publicDir, '.nojekyll'), '');
144
+ // GitHub Pages doesn't support _redirects files. Warn if any
145
+ // redirects were generated — those routes will 404 on GH Pages.
146
+ try {
147
+ const redirects = await readFile(join(publicDir, '_redirects'), 'utf-8');
148
+ if (redirects.trim().length > 0) {
149
+ console.warn(
150
+ `[timber] Warning: GitHub Pages does not support _redirects files. ` +
151
+ `Redirect rules from middleware/proxy will not work on this platform.`
152
+ );
153
+ }
154
+ } catch {
155
+ // No _redirects file — nothing to warn about
156
+ }
157
+ }
223
158
 
224
- // Write the build manifest init module (if manifest data was produced).
225
- if (config.manifestInit) {
226
- await writeFile(join(outDir, '_timber-manifest-init.js'), config.manifestInit);
159
+ return;
227
160
  }
228
161
 
229
- // Write the compression helper module for runtime use.
162
+ // Steps 1–5: shared across all adapters (mkdir, copy client/rsc/ssr,
163
+ // write _headers, write manifest-init).
164
+ await runSharedBuildSteps({
165
+ config,
166
+ artifacts,
167
+ outDir,
168
+ publicDirName: 'public',
169
+ });
170
+
171
+ // Write runtime helper modules used by the preview server.
230
172
  // See design/25-production-deployments.md — self-hosted deployments
231
173
  // need application-level compression (Cloudflare handles it at the edge).
232
- await writeFile(join(outDir, '_compress.mjs'), generateCompressModule());
233
-
234
- // Copy rsc/ssr build output into the nitro dir so imports stay local
235
- // during the Nitro bundling step (avoids broken relative paths in output).
236
- await cp(join(buildDir, 'rsc'), join(outDir, 'rsc'), { recursive: true });
237
- await cp(join(buildDir, 'ssr'), join(outDir, 'ssr'), { recursive: true }).catch(() => {});
174
+ await writeFile(join(outDir, '_compress.mjs'), await generateCompressModule());
175
+
176
+ // Web→Node response bridge with backpressure. See TIM-1154.
177
+ await writeFile(join(outDir, '_send-response.mjs'), generateSendResponseModule());
178
+
179
+ // Standalone preview server for presets with a local runtime. It loads
180
+ // the build's own RSC bundle — not the copy under nitro/rsc/ — because
181
+ // the handler reads prebuilt payloads from ../prebuilt beside its
182
+ // bundle, and the build's prebuilt/ is cleaned every build while
183
+ // nitro/prebuilt/ is not: a build that captured nothing would otherwise
184
+ // preview an earlier build's payloads.
185
+ if (LOCALLY_PREVIEWABLE.has(preset)) {
186
+ await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());
187
+ await writeFile(
188
+ join(outDir, PREVIEW_SCRIPT),
189
+ generatePreviewScript({
190
+ output: 'server',
191
+ runtimeName: PRESET_CONFIGS[preset].runtimeName,
192
+ rscEntry: importSpecifier(outDir, join(artifacts.rsc.path, 'index.js')),
193
+ hasManifestInit: !!artifacts.manifestInit,
194
+ immutableDirs: artifacts.immutableDirs,
195
+ base: adapterBase(config),
196
+ })
197
+ );
198
+ }
238
199
 
239
200
  // Prepend the manifest assignment directly into the RSC entry so
240
201
  // globalThis.__TIMBER_BUILD_MANIFEST__ is set before any module reads it.
241
202
  // This must be top-level code, not an import, because rollup tree-shakes
242
203
  // side-effect-only globalThis assignments from imported modules.
243
- if (config.manifestInit) {
204
+ if (artifacts.manifestInit) {
244
205
  const rscEntry = join(outDir, 'rsc', 'index.js');
245
206
  const rscContent = await readFile(rscEntry, 'utf-8');
246
- await writeFile(rscEntry, `${config.manifestInit}\n${rscContent}`);
207
+ await writeFile(rscEntry, `${artifacts.manifestInit}\n${rscContent}`);
247
208
  }
248
209
 
249
210
  // Generate the Nitro entry point (imports from ./rsc/ within nitro dir)
250
- const entry = generateNitroEntry(buildDir, outDir, preset, compress);
211
+ const entry = generateNitroEntry(preset, compress, artifacts.immutableDirs);
251
212
  await writeFile(join(outDir, 'entry.ts'), entry);
252
213
 
253
214
  // Run the Nitro build to produce a production-ready server bundle.
254
215
  // The output goes to dist/nitro/.output/server/index.mjs (for node-server preset).
255
216
  // Config is passed programmatically — no nitro.config.ts file needed.
256
- await runNitroBuild(outDir, preset, options.nitroConfig);
217
+ const { serverDir } = await runNitroBuild(
218
+ outDir,
219
+ preset,
220
+ artifacts.immutableDirs,
221
+ options.nitroConfig
222
+ );
223
+
224
+ // Copy prebuilt flight payloads into the Nitro output. The RSC entry
225
+ // resolves `../prebuilt/` relative to its bundled chunk
226
+ // (<serverDir>/_chunks/), so prebuilt/ must live at
227
+ // <serverDir>/prebuilt/. serverDir is the resolved path from Nitro
228
+ // (honors user overrides via nitroConfig.output.serverDir).
229
+ if (artifacts.prebuilt) {
230
+ const prebuiltSrc = artifacts.prebuilt.path;
231
+ await cp(prebuiltSrc, join(serverDir, 'prebuilt'), { recursive: true });
232
+
233
+ // Vercel with functionRules clones __server.func to per-route .func
234
+ // directories during the Nitro build. Copy prebuilt into those clones
235
+ // so requests routed to them also resolve ../prebuilt correctly.
236
+ if (preset === 'vercel' || preset === 'vercel-edge') {
237
+ const functionsDir = dirname(serverDir);
238
+ const baseFuncName = basename(serverDir);
239
+ await copyPrebuiltToVercelFuncClones(functionsDir, prebuiltSrc, baseFuncName);
240
+ }
241
+ }
257
242
  },
258
243
 
259
- // Only presets that produce a locally-runnable server get preview().
260
- // Serverless presets (vercel, netlify, aws-lambda, etc.) have no
261
- // local runtime — Vite's built-in preview is the fallback.
262
- preview: LOCALLY_PREVIEWABLE.has(preset)
263
- ? async (_config: TimberConfig, buildDir: string) => {
264
- // Generate a standalone preview server that uses Node's built-in
265
- // HTTP server. The Nitro entry.ts can't be run directly because
266
- // it imports h3 (a Nitro dependency not available at runtime).
267
- const previewScript = generatePreviewScript(buildDir, preset);
268
- const scriptPath = join(buildDir, 'nitro', '_preview-server.mjs');
269
- await writeFile(scriptPath, previewScript);
270
-
271
- const command = preset === 'bun' ? 'bun' : 'node';
272
- await spawnNitroPreview(command, [scriptPath], join(buildDir, 'nitro'));
273
- }
274
- : undefined,
275
-
276
- waitUntil: presetConfig.supportsWaitUntil
277
- ? (promise: Promise<unknown>) => {
278
- const tracked = promise.catch((err) => {
279
- console.error('[timber] waitUntil promise rejected:', err);
280
- });
281
- pendingPromises.push(tracked);
282
- }
283
- : undefined,
244
+ // buildOutput wrote the preview server for this build: a static file
245
+ // server for a static build, and for a server build on a preset with a
246
+ // local runtime (node-server, bun), one that routes to the RSC handler.
247
+ // Serverless presets (vercel, netlify, aws-lambda, etc.) have no local
248
+ // runtime, so a server build on one has nothing to preview.
249
+ async preview(_config: TimberConfig, { output, outputDir }: PreviewTarget) {
250
+ if (output === 'server' && !LOCALLY_PREVIEWABLE.has(preset)) {
251
+ throw new Error(
252
+ `[timber] The nitro '${preset}' preset has no local runtime, so \`timber preview\` ` +
253
+ `cannot run its server build. Preview with a node-server build, or with the ` +
254
+ `platform's own tooling.`
255
+ );
256
+ }
257
+ const nitroDir = join(outputDir, 'nitro');
258
+ const script = join(nitroDir, PREVIEW_SCRIPT);
259
+ if (!existsSync(script)) {
260
+ throw new Error(
261
+ `[timber] No preview server at ${script}. Run \`timber build\` before \`timber preview\`.`
262
+ );
263
+ }
264
+ // Only a bun server build needs Bun. The static file server uses Node
265
+ // built-ins, so it runs on the Node already running timber, as does a
266
+ // node-server build — no PATH lookup for either.
267
+ const command = output === 'server' && preset === 'bun' ? 'bun' : process.execPath;
268
+ await spawnNitroPreview(command, [script], nitroDir);
269
+ },
284
270
  };
285
271
  }
286
272
 
273
+ /** The preview server buildOutput writes into the Nitro output directory. */
274
+ const PREVIEW_SCRIPT = '_preview-server.mjs';
275
+
276
+ /** The request-path canonicalizer the preview server imports beside it. */
277
+ const CANONICALIZE_MODULE = '_canonicalize.mjs';
278
+
279
+ /** A relative ESM import specifier for `file`, as imported from a module in `fromDir`. */
280
+ function importSpecifier(fromDir: string, file: string): string {
281
+ const path = relative(fromDir, file).split(sep).join('/');
282
+ return path.startsWith('../') ? path : './' + path;
283
+ }
284
+
287
285
  // ─── Entry Generation ────────────────────────────────────────────────────────
288
286
 
289
287
  /** @internal Exported for testing. */
290
288
  export function generateNitroEntry(
291
- buildDir: string,
292
- outDir: string,
293
289
  preset: NitroPreset,
294
290
  compress = true,
295
- hasManifestInit = false
291
+ immutableDirs: readonly string[] = []
296
292
  ): string {
297
293
  // The RSC entry is the main request handler — it exports the fetch handler as default.
298
294
  // rsc/ is copied into the nitro dir so the import is local.
@@ -349,22 +345,18 @@ export function generateNitroEntry(
349
345
  handlerCall = ` const webResponse = await handler(webRequest)`;
350
346
  }
351
347
 
352
- // Build manifest init must be imported before the handler so that
353
- // globalThis.__TIMBER_BUILD_MANIFEST__ is set when the virtual module evaluates.
354
- // ESM guarantees imports are evaluated in order.
355
- const manifestImport = hasManifestInit ? "import './_timber-manifest-init.js'\n" : '';
356
-
357
348
  // Import runWithWaitUntil only when the preset supports it.
358
349
  const waitUntilImport = supportsWaitUntil ? ', runWithWaitUntil' : '';
359
350
 
360
351
  const compressImport = compress ? "import { compressResponse } from './_compress.mjs'\n" : '';
361
352
  const compressCall = compress ? 'compressResponse(webRequest, webResponse)' : 'webResponse';
353
+ const immutableAssets = immutableAssetsEntryGuard(immutableDirs);
362
354
 
363
355
  return `// Generated by @timber-js/app/adapters/nitro
364
356
  // Do not edit — this file is regenerated on each build.
365
357
 
366
- ${manifestImport}import handler, { runWithEarlyHintsSender${waitUntilImport} } from '${serverEntryRelative}'
367
- ${compressImport}
358
+ import handler, { runWithEarlyHintsSender${waitUntilImport} } from '${serverEntryRelative}'
359
+ ${compressImport}${immutableAssets.imports}
368
360
  // Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
369
361
  // See design/25-production-deployments.md §"TIMBER_RUNTIME".
370
362
  process.env.TIMBER_RUNTIME = '${runtimeName}'
@@ -375,7 +367,7 @@ process.env.TIMBER_RUNTIME = '${runtimeName}'
375
367
  // Nitro bundles h3 into its internal _libs/ directory but doesn't make
376
368
  // it available as a bare specifier in the output's node_modules.
377
369
  export default async function timberHandler(event) {
378
- // h3 v2: event.req is the Web Request
370
+ ${immutableAssets.guard} // h3 v2: event.req is the Web Request
379
371
  const webRequest = event.req
380
372
  ${handlerCall}
381
373
  return ${compressCall}
@@ -383,241 +375,93 @@ ${handlerCall}
383
375
  `;
384
376
  }
385
377
 
386
- /** @internal Exported for testing. */
387
- export function generateNitroConfig(
388
- preset: NitroPreset,
389
- userConfig?: Record<string, unknown>
390
- ): string {
391
- const presetConfig = PRESET_CONFIGS[preset];
378
+ // ─── Build Hint Filtering ────────────────────────────────────────────────────
392
379
 
393
- const config: Record<string, unknown> = {
394
- preset: presetConfig.nitroPreset,
395
- entry: './entry.ts',
396
- output: { dir: presetConfig.outputDir },
397
- // Static asset cache headers — hashed assets are immutable, others get 1h.
398
- // See design/25-production-deployments.md §"CDN / Edge Cache"
399
- routeRules: {
400
- '/assets/**': { headers: { 'Cache-Control': IMMUTABLE_CACHE } },
401
- },
402
- ...presetConfig.extraConfig,
403
- ...userConfig,
404
- };
405
-
406
- const configJson = JSON.stringify(config, null, 2);
407
-
408
- return `// Generated by @timber-js/app/adapters/nitro
409
- // Do not edit — this file is regenerated on each build.
410
-
411
- import { defineNitroConfig } from 'nitro/config'
380
+ /**
381
+ * Prefixes of nitro build-output lines that give wrong advice for timber
382
+ * builds. Every nitro bundler path emits these hints via `logger.success` —
383
+ * the rollup path hardcodes `npx nitro preview`; rolldown and vite default
384
+ * to it. That command resolves `.output/nitro.json` relative to cwd, but
385
+ * timber's nitro build lives at `.timber/dist/nitro/.output`, so the
386
+ * suggested command can never work from the project root.
387
+ * Prefix matching degrades gracefully: if upstream rewords the line
388
+ * entirely, it passes through rather than being silently eaten.
389
+ */
390
+ const NITRO_PREVIEW_HINT_PREFIX = 'You can preview this build using';
391
+ const NITRO_DEPLOY_HINT_PREFIX = 'You can deploy this build using';
392
+ const SUPPRESSED_NITRO_HINT_PREFIXES = [NITRO_PREVIEW_HINT_PREFIX, NITRO_DEPLOY_HINT_PREFIX];
412
393
 
413
- export default defineNitroConfig(${configJson})
414
- `;
394
+ /** @internal Exported for testing. */
395
+ export function isSuppressedNitroHint(
396
+ message: unknown,
397
+ prefixes: readonly string[] = SUPPRESSED_NITRO_HINT_PREFIXES
398
+ ): boolean {
399
+ return typeof message === 'string' && prefixes.some((prefix) => message.startsWith(prefix));
415
400
  }
416
401
 
417
- // ─── Preview ─────────────────────────────────────────────────────────────────
418
-
419
- /** Presets that produce a locally-runnable server entry. */
420
- const LOCALLY_PREVIEWABLE = new Set<NitroPreset>(['node-server', 'bun']);
421
-
422
402
  /**
423
- * Generate a standalone preview server script that uses Node's built-in
424
- * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports
425
- * h3 which isn't available outside a Nitro build. For local preview we
426
- * just need to serve static files and route requests to the RSC handler.
403
+ * Nitro's rolldown and vite builders render `framework.previewCommand` /
404
+ * `framework.deployCommand` into these hints. A user who explicitly set one
405
+ * via `nitroConfig` has provided valid guidance — only suppress the hints
406
+ * whose command is still nitro's broken default.
427
407
  *
428
408
  * @internal Exported for testing.
429
409
  */
430
- export function generatePreviewScript(buildDir: string, preset: NitroPreset): string {
431
- const rscEntryRelative = relative(join(buildDir, 'nitro'), join(buildDir, 'rsc', 'index.js'));
432
- const rscEntry = rscEntryRelative.startsWith('.') ? rscEntryRelative : './' + rscEntryRelative;
433
- const publicDir = './public';
434
- const manifestInitPath = './_timber-manifest-init.js';
435
- const runtimeName = PRESET_CONFIGS[preset].runtimeName;
436
-
437
- return `// Generated by @timber-js/app — standalone preview server.
438
- // Uses Node's built-in HTTP server to serve static assets and route
439
- // dynamic requests through the RSC handler. No Nitro/h3 dependency.
440
-
441
- import { createServer } from 'node:http';
442
- import { readFile, stat } from 'node:fs/promises';
443
- import { join, extname } from 'node:path';
444
- import { fileURLToPath } from 'node:url';
445
- import { existsSync } from 'node:fs';
446
-
447
- // Set runtime before importing the handler.
448
- process.env.TIMBER_RUNTIME = '${runtimeName}';
449
-
450
- // Load the build manifest if it exists.
451
- const __dirname = fileURLToPath(new URL('.', import.meta.url));
452
- const manifestPath = join(__dirname, '${manifestInitPath}');
453
- if (existsSync(manifestPath)) {
454
- await import('${manifestInitPath}');
410
+ export function selectSuppressedHintPrefixes(framework?: {
411
+ previewCommand?: string;
412
+ deployCommand?: string;
413
+ }): string[] {
414
+ return [
415
+ ...(framework?.previewCommand ? [] : [NITRO_PREVIEW_HINT_PREFIX]),
416
+ ...(framework?.deployCommand ? [] : [NITRO_DEPLOY_HINT_PREFIX]),
417
+ ];
455
418
  }
456
419
 
457
- // Import the RSC handler (default export is the fetch-like handler).
458
- const { default: handler, runWithEarlyHintsSender } = await import('${rscEntry}');
459
-
460
- // Import compression helper for self-hosted response compression.
461
- const { compressResponse } = await import('./_compress.mjs');
462
-
463
- const MIME_TYPES = {
464
- '.html': 'text/html',
465
- '.js': 'application/javascript',
466
- '.mjs': 'application/javascript',
467
- '.css': 'text/css',
468
- '.json': 'application/json',
469
- '.png': 'image/png',
470
- '.jpg': 'image/jpeg',
471
- '.jpeg': 'image/jpeg',
472
- '.gif': 'image/gif',
473
- '.svg': 'image/svg+xml',
474
- '.ico': 'image/x-icon',
475
- '.woff': 'font/woff',
476
- '.woff2': 'font/woff2',
477
- '.ttf': 'font/ttf',
478
- '.otf': 'font/otf',
479
- '.webp': 'image/webp',
480
- '.avif': 'image/avif',
481
- '.webm': 'video/webm',
482
- '.mp4': 'video/mp4',
483
- '.txt': 'text/plain',
484
- '.xml': 'application/xml',
485
- '.wasm': 'application/wasm',
486
- };
487
-
488
- const publicDir = join(__dirname, '${publicDir}');
489
- const port = parseInt(process.env.PORT || '3000', 10);
490
- const host = process.env.HOST || process.env.HOSTNAME || 'localhost';
491
-
492
- const server = createServer(async (req, res) => {
493
- const url = new URL(req.url || '/', \`http://\${host}:\${port}\`);
494
-
495
- // Try serving static files from the public directory first.
496
- const filePath = join(publicDir, url.pathname);
497
- // Prevent path traversal.
498
- if (filePath.startsWith(publicDir)) {
499
- try {
500
- const fileStat = await stat(filePath);
501
- if (fileStat.isFile()) {
502
- const ext = extname(filePath);
503
- const contentType = MIME_TYPES[ext] || 'application/octet-stream';
504
- const body = await readFile(filePath);
505
- // Hashed assets get immutable cache, others get short cache.
506
- const cacheControl = url.pathname.startsWith('/assets/')
507
- ? 'public, max-age=31536000, immutable'
508
- : 'public, max-age=3600, must-revalidate';
509
- res.writeHead(200, {
510
- 'Content-Type': contentType,
511
- 'Content-Length': body.length,
512
- 'Cache-Control': cacheControl,
513
- });
514
- res.end(body);
515
- return;
516
- }
517
- } catch {
518
- // File not found — fall through to the RSC handler.
519
- }
520
- }
521
-
522
- // Convert Node request to Web Request.
523
- const headers = new Headers();
524
- for (const [key, value] of Object.entries(req.headers)) {
525
- if (value) {
526
- if (Array.isArray(value)) {
527
- for (const v of value) headers.append(key, v);
528
- } else {
529
- headers.set(key, value);
530
- }
531
- }
532
- }
533
-
534
- let body = undefined;
535
- if (req.method !== 'GET' && req.method !== 'HEAD') {
536
- body = await new Promise((resolve) => {
537
- const chunks = [];
538
- req.on('data', (chunk) => chunks.push(chunk));
539
- req.on('end', () => resolve(Buffer.concat(chunks)));
540
- });
541
- }
542
-
543
- const webRequest = new Request(url.href, {
544
- method: req.method,
545
- headers,
546
- body,
547
- duplex: body ? 'half' : undefined,
548
- });
549
-
550
- try {
551
- // Support 103 Early Hints when available.
552
- const earlyHintsSender = (typeof res.writeEarlyHints === 'function')
553
- ? (links) => { try { res.writeEarlyHints({ link: links }); } catch {} }
554
- : undefined;
555
-
556
- const rawResponse = earlyHintsSender && runWithEarlyHintsSender
557
- ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))
558
- : await handler(webRequest);
559
-
560
- // Compress the response for self-hosted deployments.
561
- const webResponse = compressResponse(webRequest, rawResponse);
562
-
563
- // Write the response back to the Node response.
564
- res.writeHead(webResponse.status, Object.fromEntries(webResponse.headers.entries()));
565
-
566
- if (webResponse.body) {
567
- const reader = webResponse.body.getReader();
568
- const pump = async () => {
569
- while (true) {
570
- const { done, value } = await reader.read();
571
- if (done) { res.end(); return; }
572
- res.write(value);
573
- }
574
- };
575
- await pump();
576
- } else {
577
- res.end();
578
- }
579
- } catch (err) {
580
- console.error('[timber preview] Request error:', err);
581
- if (!res.headersSent) {
582
- res.writeHead(500, { 'Content-Type': 'text/plain' });
583
- }
584
- res.end('Internal Server Error');
585
- }
586
- });
587
-
588
- server.listen(port, host, () => {
589
- console.log();
590
- console.log(' ⚡ timber preview server running at:');
591
- console.log();
592
- console.log(\` ➜ http://\${host}:\${port}\`);
593
- console.log();
594
- });
595
- `;
420
+ /** Minimal structural view of the nitro (consola) logger the wrap needs. */
421
+ interface NitroBuildLogger {
422
+ success: (message: unknown, ...args: unknown[]) => void;
596
423
  }
597
424
 
598
- /** Command descriptor for Nitro preview — testable without spawning. */
599
- export interface NitroPreviewCommand {
600
- command: string;
601
- args: string[];
602
- cwd: string;
425
+ /**
426
+ * Wrap a nitro logger's `success` so hardcoded preview/deploy hints are
427
+ * dropped for this programmatic build only. Returns the original
428
+ * (unfiltered) success fn so timber can print its own hint — which shares
429
+ * the suppressed prefix on purpose, replacing nitro's wording.
430
+ *
431
+ * @internal Exported for testing.
432
+ */
433
+ export function wrapNitroLoggerForBuild(
434
+ logger: NitroBuildLogger,
435
+ prefixes: readonly string[] = SUPPRESSED_NITRO_HINT_PREFIXES
436
+ ): NitroBuildLogger['success'] {
437
+ const originalSuccess = logger.success.bind(logger);
438
+ const wrapped = (message: unknown, ...args: unknown[]) => {
439
+ if (isSuppressedNitroHint(message, prefixes)) return;
440
+ originalSuccess(message, ...args);
441
+ };
442
+ // Preserve consola LogFn properties (e.g. `.raw`) on the replacement.
443
+ logger.success = Object.assign(wrapped, logger.success);
444
+ return originalSuccess;
603
445
  }
604
446
 
605
- /** @internal Exported for testing. */
606
- export function generateNitroPreviewCommand(
607
- buildDir: string,
608
- preset: NitroPreset
609
- ): NitroPreviewCommand | null {
610
- if (!LOCALLY_PREVIEWABLE.has(preset)) return null;
611
-
612
- const nitroDir = join(buildDir, 'nitro');
613
- const entryPath = join(nitroDir, 'entry.ts');
447
+ /**
448
+ * Timber's own post-build hint. Locally-runnable presets are previewed via
449
+ * `timber preview`, which invokes this adapter's `preview()` to run the
450
+ * generated `_preview-server.mjs`. Serverless presets get no hint — their
451
+ * output lives under `.timber/dist/nitro/`, so any cwd-relative deploy
452
+ * command would be as wrong as the nitro hint this replaces.
453
+ *
454
+ * @internal Exported for testing.
455
+ */
456
+ export function getPostBuildHint(preset: NitroPreset): string | null {
457
+ return LOCALLY_PREVIEWABLE.has(preset)
458
+ ? 'You can preview this build using `timber preview`'
459
+ : null;
460
+ }
614
461
 
615
- const command = preset === 'bun' ? 'bun' : 'node';
616
- return {
617
- command,
618
- args: [entryPath],
619
- cwd: nitroDir,
620
- };
462
+ interface NitroBuildResult {
463
+ /** Resolved output.serverDir — where the server bundle + _chunks/ live. */
464
+ serverDir: string;
621
465
  }
622
466
 
623
467
  /**
@@ -625,13 +469,17 @@ export function generateNitroPreviewCommand(
625
469
  * Uses dynamic import so nitro is only loaded at build time.
626
470
  * Externalizes the timber RSC/SSR output — those files are pre-built
627
471
  * by timber and have internal references that nitro's bundler can't follow.
472
+ *
473
+ * @internal Exported for testing.
628
474
  */
629
- async function runNitroBuild(
475
+ export async function runNitroBuild(
630
476
  nitroDir: string,
631
477
  preset: NitroPreset,
632
- userConfig?: Record<string, unknown>
633
- ): Promise<void> {
478
+ immutableDirs: readonly string[],
479
+ userConfig?: NitroConfig
480
+ ): Promise<NitroBuildResult> {
634
481
  const presetConfig = PRESET_CONFIGS[preset];
482
+ const immutableAssets = await prepareImmutableAssets(nitroDir, immutableDirs);
635
483
  const {
636
484
  createNitro,
637
485
  build: nitroBuild,
@@ -647,9 +495,6 @@ async function runNitroBuild(
647
495
  // Using `entry` directly would bypass the Nitro server runtime.
648
496
  renderer: { handler: join(nitroDir, 'entry.ts') },
649
497
  output: { dir: join(nitroDir, presetConfig.outputDir) },
650
- routeRules: {
651
- '/assets/**': { headers: { 'Cache-Control': IMMUTABLE_CACHE } },
652
- },
653
498
  // Don't bundle the timber RSC/SSR build output — it has its own
654
499
  // internal file references that nitro's bundler can't follow.
655
500
  // Mark them as external so rollup leaves the imports as-is.
@@ -658,32 +503,73 @@ async function runNitroBuild(
658
503
  },
659
504
  ...presetConfig.extraConfig,
660
505
  ...userConfig,
506
+ // The content-hashed directories the build recorded: immutable on a hit,
507
+ // a no-store 404 on a miss. Not route rules, which cannot tell the two
508
+ // apart (TIM-1578) — see nitro-immutable-assets.ts. Set after the user's
509
+ // config, which may add public-asset directories and plugins but not drop
510
+ // these: without them a handler could answer 200 under a hashed directory
511
+ // and be marked immutable.
512
+ publicAssets: [...immutableAssets.publicAssets, ...(userConfig?.publicAssets ?? [])],
513
+ plugins: [...immutableAssets.plugins, ...(userConfig?.plugins ?? [])],
661
514
  });
662
515
 
516
+ // Drop nitro's `npx nitro preview` / `npx nitro deploy` hints —
517
+ // they can never work from the project root (see TIM-1375). Hints whose
518
+ // command the user explicitly configured via framework.previewCommand /
519
+ // deployCommand pass through untouched — except on the rollup builder,
520
+ // which ignores framework commands and unconditionally prints the broken
521
+ // defaults (nitro/dist/_build/rollup.mjs), so user commands are treated
522
+ // as absent there: defaults stay suppressed, timber's hint still prints.
523
+ // logSuccess is the unfiltered fn used below to print timber's hint.
524
+ const framework = nitro.options.builder === 'rollup' ? undefined : nitro.options.framework;
525
+ const logSuccess = wrapNitroLoggerForBuild(nitro.logger, selectSuppressedHintPrefixes(framework));
526
+
527
+ // Read the resolved serverDir AFTER config merging — userConfig may
528
+ // override output.dir or output.serverDir. Nitro appends a trailing
529
+ // slash during resolution; strip it for join() compatibility.
530
+ const raw = nitro.options.output.serverDir;
531
+ const serverDir = raw.endsWith('/') ? raw.slice(0, -1) : raw;
532
+
663
533
  await prepare(nitro);
664
534
  await copyPublicAssets(nitro);
665
535
  await nitroBuild(nitro);
666
536
  await nitro.close();
667
- }
668
537
 
669
- /** Spawn a Nitro preview process and pipe stdio. */
670
- function spawnNitroPreview(command: string, args: string[], cwd: string): Promise<void> {
671
- return new Promise<void>((resolve, reject) => {
672
- const child = execFile(command, args, { cwd }, (err) => {
673
- if (err) reject(err);
674
- else resolve();
675
- });
676
- child.stdout?.pipe(process.stdout);
677
- child.stderr?.pipe(process.stderr);
678
- });
679
- }
538
+ // A user-configured previewCommand already printed via nitro's own hint —
539
+ // don't print a second, conflicting one.
540
+ const hint = framework?.previewCommand ? null : getPostBuildHint(preset);
541
+ if (hint) logSuccess(hint);
680
542
 
543
+ return { serverDir };
544
+ }
681
545
  // ─── Helpers ─────────────────────────────────────────────────────────────────
682
546
 
683
547
  /**
684
- * Get the preset configuration for a given preset name.
548
+ * Copy prebuilt payloads into cloned Vercel function directories.
549
+ *
550
+ * When users configure `vercel.functionRules`, Nitro's compiled hook clones
551
+ * the base __server.func to per-route .func directories. These clones are
552
+ * created during `runNitroBuild()` — before our post-build prebuilt copy.
553
+ * Each clone resolves `../prebuilt` independently, so they each need a copy.
554
+ *
685
555
  * @internal Exported for testing.
686
556
  */
687
- export function getPresetConfig(preset: NitroPreset): PresetConfig {
688
- return PRESET_CONFIGS[preset];
557
+ export async function copyPrebuiltToVercelFuncClones(
558
+ functionsDir: string,
559
+ prebuiltSrc: string,
560
+ baseFuncName: string
561
+ ): Promise<void> {
562
+ const funcDirs: string[] = [];
563
+ try {
564
+ for await (const match of glob('**/*.func', { cwd: functionsDir })) {
565
+ if (!match.endsWith(baseFuncName)) {
566
+ funcDirs.push(join(functionsDir, match));
567
+ }
568
+ }
569
+ } catch {
570
+ return;
571
+ }
572
+ await Promise.all(
573
+ funcDirs.map((dir) => cp(prebuiltSrc, join(dir, 'prebuilt'), { recursive: true }))
574
+ );
689
575
  }