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

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 (1484) 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-BDqn4Oxj.js +1243 -0
  5. package/dist/_chunks/actions-BDqn4Oxj.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-GE4AOe2H.js +1061 -0
  17. package/dist/_chunks/cache-api-GE4AOe2H.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-BiWNMBVU.js +1 -0
  44. package/dist/_chunks/dev-server-DIy-SY-J.js +2061 -0
  45. package/dist/_chunks/dev-server-DIy-SY-J.js.map +1 -0
  46. package/dist/_chunks/dev-store-BOa304m_.js +283 -0
  47. package/dist/_chunks/dev-store-BOa304m_.js.map +1 -0
  48. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  49. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  50. package/dist/_chunks/error-boundary-Bc8QPZuq.js +1107 -0
  51. package/dist/_chunks/error-boundary-Bc8QPZuq.js.map +1 -0
  52. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  53. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  54. package/dist/_chunks/flight-source-node-HptmGMT8.js +518 -0
  55. package/dist/_chunks/flight-source-node-HptmGMT8.js.map +1 -0
  56. package/dist/_chunks/format-BKclgVbk.js +14 -0
  57. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  58. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  59. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  60. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  61. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  62. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  63. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  64. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  65. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  66. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  67. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  68. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  69. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  70. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  71. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  72. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  73. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  74. package/dist/_chunks/node-response-rkQqcFGq.js +233 -0
  75. package/dist/_chunks/node-response-rkQqcFGq.js.map +1 -0
  76. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  77. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  78. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  79. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  80. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  81. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  82. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  83. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  84. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  85. package/dist/_chunks/purge-store-WZaxu-3m.js +14 -0
  86. package/dist/_chunks/purge-store-WZaxu-3m.js.map +1 -0
  87. package/dist/_chunks/render-timeout-joFhz4KH.js +37 -0
  88. package/dist/_chunks/render-timeout-joFhz4KH.js.map +1 -0
  89. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  90. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  91. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  92. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  93. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  94. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  95. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  96. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  97. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  98. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  99. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  100. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  101. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  102. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  103. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  104. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  105. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  106. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  107. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  108. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  109. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  110. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  111. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  112. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  113. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  114. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  115. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  116. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  117. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  118. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  119. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  120. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  121. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  122. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  123. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  124. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  125. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  126. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  127. package/dist/adapters/build-output-helper.d.ts +72 -0
  128. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  129. package/dist/adapters/canonicalize-module.d.ts +8 -0
  130. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  132. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  133. package/dist/adapters/cloudflare-dev.js +74 -0
  134. package/dist/adapters/cloudflare-dev.js.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  136. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  137. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  138. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  139. package/dist/adapters/cloudflare.d.ts +224 -24
  140. package/dist/adapters/cloudflare.d.ts.map +1 -1
  141. package/dist/adapters/cloudflare.js +1 -188
  142. package/dist/adapters/compress-module.d.ts +25 -4
  143. package/dist/adapters/compress-module.d.ts.map +1 -1
  144. package/dist/adapters/fs-identity.d.ts +63 -0
  145. package/dist/adapters/fs-identity.d.ts.map +1 -0
  146. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  147. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-presets.d.ts +31 -0
  149. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  150. package/dist/adapters/nitro-preview.d.ts +65 -0
  151. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  152. package/dist/adapters/nitro.d.ts +69 -38
  153. package/dist/adapters/nitro.d.ts.map +1 -1
  154. package/dist/adapters/nitro.js +793 -341
  155. package/dist/adapters/nitro.js.map +1 -1
  156. package/dist/adapters/shared.d.ts +67 -0
  157. package/dist/adapters/shared.d.ts.map +1 -0
  158. package/dist/adapters/types.d.ts +124 -16
  159. package/dist/adapters/types.d.ts.map +1 -1
  160. package/dist/adapters/types.js +0 -0
  161. package/dist/analyze/chains.d.ts +124 -0
  162. package/dist/analyze/chains.d.ts.map +1 -0
  163. package/dist/analyze/classify.d.ts +153 -0
  164. package/dist/analyze/classify.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.d.ts +17 -0
  166. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  167. package/dist/analyze/crawl-entry.js +314 -0
  168. package/dist/analyze/crawl-entry.js.map +1 -0
  169. package/dist/analyze/crawl.d.ts +134 -0
  170. package/dist/analyze/crawl.d.ts.map +1 -0
  171. package/dist/analyze/graph-cache.d.ts +104 -0
  172. package/dist/analyze/graph-cache.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.d.ts +43 -0
  174. package/dist/analyze/graph-command.d.ts.map +1 -0
  175. package/dist/analyze/graph-command.js +472 -0
  176. package/dist/analyze/graph-command.js.map +1 -0
  177. package/dist/analyze/live-graph.d.ts +81 -0
  178. package/dist/analyze/live-graph.d.ts.map +1 -0
  179. package/dist/analyze/poison-rules.d.ts +72 -0
  180. package/dist/analyze/poison-rules.d.ts.map +1 -0
  181. package/dist/analyze/poison-scan.d.ts +48 -0
  182. package/dist/analyze/poison-scan.d.ts.map +1 -0
  183. package/dist/analyze/scan.d.ts +73 -0
  184. package/dist/analyze/scan.d.ts.map +1 -0
  185. package/dist/cache/cache-api.d.ts +48 -0
  186. package/dist/cache/cache-api.d.ts.map +1 -0
  187. package/dist/cache/fast-hash.d.ts +5 -0
  188. package/dist/cache/fast-hash.d.ts.map +1 -1
  189. package/dist/cache/handler-store.d.ts +45 -0
  190. package/dist/cache/handler-store.d.ts.map +1 -0
  191. package/dist/cache/index.d.ts +32 -9
  192. package/dist/cache/index.d.ts.map +1 -1
  193. package/dist/cache/index.js +4 -326
  194. package/dist/cache/invalidation-epoch.d.ts +50 -0
  195. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  196. package/dist/cache/json-lossy-check.d.ts +11 -0
  197. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  198. package/dist/cache/redis-handler.d.ts +141 -9
  199. package/dist/cache/redis-handler.d.ts.map +1 -1
  200. package/dist/cache/singleflight.d.ts +21 -2
  201. package/dist/cache/singleflight.d.ts.map +1 -1
  202. package/dist/cache/sizeof.d.ts +22 -0
  203. package/dist/cache/sizeof.d.ts.map +1 -0
  204. package/dist/cache/stable-stringify.d.ts +9 -0
  205. package/dist/cache/stable-stringify.d.ts.map +1 -1
  206. package/dist/cache/store.d.ts +53 -0
  207. package/dist/cache/store.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  209. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  210. package/dist/cache/stores/cloudflare-kv.js +29 -0
  211. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  212. package/dist/cache/stores/memory.d.ts +42 -0
  213. package/dist/cache/stores/memory.d.ts.map +1 -0
  214. package/dist/cache/stores/memory.js +90 -0
  215. package/dist/cache/stores/memory.js.map +1 -0
  216. package/dist/cache/stores/redis.d.ts +69 -0
  217. package/dist/cache/stores/redis.d.ts.map +1 -0
  218. package/dist/cache/stores/redis.js +35 -0
  219. package/dist/cache/stores/redis.js.map +1 -0
  220. package/dist/cache/stores/vercel.d.ts +36 -0
  221. package/dist/cache/stores/vercel.d.ts.map +1 -0
  222. package/dist/cache/stores/vercel.js +33 -0
  223. package/dist/cache/stores/vercel.js.map +1 -0
  224. package/dist/cache/tag-aware-handler.d.ts +52 -0
  225. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  226. package/dist/cache/timber-cache.d.ts +21 -11
  227. package/dist/cache/timber-cache.d.ts.map +1 -1
  228. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  229. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  230. package/dist/cdn/cloudflare-purge.js +30 -0
  231. package/dist/cdn/cloudflare-purge.js.map +1 -0
  232. package/dist/cdn/fastly-purge.d.ts +25 -0
  233. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  234. package/dist/cdn/fastly-purge.js +33 -0
  235. package/dist/cdn/fastly-purge.js.map +1 -0
  236. package/dist/cdn/headers.d.ts +97 -0
  237. package/dist/cdn/headers.d.ts.map +1 -0
  238. package/dist/cdn/index.d.ts +5 -0
  239. package/dist/cdn/index.d.ts.map +1 -0
  240. package/dist/cdn/index.js +94 -0
  241. package/dist/cdn/index.js.map +1 -0
  242. package/dist/cdn/purge-store.d.ts +32 -0
  243. package/dist/cdn/purge-store.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  245. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  246. package/dist/cdn/workers-cache-purge.js +35 -0
  247. package/dist/cdn/workers-cache-purge.js.map +1 -0
  248. package/dist/cli-check.d.ts +133 -0
  249. package/dist/cli-check.d.ts.map +1 -0
  250. package/dist/cli-context.d.ts +54 -0
  251. package/dist/cli-context.d.ts.map +1 -0
  252. package/dist/cli-schema-sync.d.ts +59 -0
  253. package/dist/cli-schema-sync.d.ts.map +1 -0
  254. package/dist/cli.d.ts +88 -16
  255. package/dist/cli.d.ts.map +1 -1
  256. package/dist/cli.js +225 -63
  257. package/dist/cli.js.map +1 -1
  258. package/dist/client/browser-dev.d.ts +42 -2
  259. package/dist/client/browser-dev.d.ts.map +1 -1
  260. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  261. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  262. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  263. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  264. package/dist/client/browser-entry/form-state.d.ts +22 -0
  265. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hmr.d.ts +21 -0
  267. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  268. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  269. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  270. package/dist/client/browser-entry/index.d.ts +32 -0
  271. package/dist/client/browser-entry/index.d.ts.map +1 -0
  272. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  273. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  274. package/dist/client/browser-entry/router-init.d.ts +41 -0
  275. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  276. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  277. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  278. package/dist/client/browser-entry/scroll.d.ts +28 -0
  279. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  280. package/dist/client/deny-last-resort.d.ts +29 -0
  281. package/dist/client/deny-last-resort.d.ts.map +1 -0
  282. package/dist/client/error-boundary.d.ts +58 -9
  283. package/dist/client/error-boundary.d.ts.map +1 -1
  284. package/dist/client/error-boundary.js +1 -126
  285. package/dist/client/error-reconstituter.d.ts +55 -0
  286. package/dist/client/error-reconstituter.d.ts.map +1 -0
  287. package/dist/client/form.d.ts +38 -99
  288. package/dist/client/form.d.ts.map +1 -1
  289. package/dist/client/global-context.d.ts +15 -0
  290. package/dist/client/global-context.d.ts.map +1 -0
  291. package/dist/client/history.d.ts +50 -9
  292. package/dist/client/history.d.ts.map +1 -1
  293. package/dist/client/index.d.ts +21 -33
  294. package/dist/client/index.d.ts.map +1 -1
  295. package/dist/client/index.js +423 -1227
  296. package/dist/client/index.js.map +1 -1
  297. package/dist/client/internal.d.ts +20 -0
  298. package/dist/client/internal.d.ts.map +1 -0
  299. package/dist/client/internal.js +781 -0
  300. package/dist/client/internal.js.map +1 -0
  301. package/dist/client/link.d.ts +85 -60
  302. package/dist/client/link.d.ts.map +1 -1
  303. package/dist/client/location-search.d.ts +12 -0
  304. package/dist/client/location-search.d.ts.map +1 -0
  305. package/dist/client/navigation-api.d.ts +95 -0
  306. package/dist/client/navigation-api.d.ts.map +1 -0
  307. package/dist/client/navigation-commit.d.ts +111 -0
  308. package/dist/client/navigation-commit.d.ts.map +1 -0
  309. package/dist/client/navigation-context.d.ts +54 -36
  310. package/dist/client/navigation-context.d.ts.map +1 -1
  311. package/dist/client/navigation-root.d.ts +106 -0
  312. package/dist/client/navigation-root.d.ts.map +1 -0
  313. package/dist/client/navigation-transition.d.ts +255 -0
  314. package/dist/client/navigation-transition.d.ts.map +1 -0
  315. package/dist/client/nuqs-adapter.d.ts +1 -1
  316. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  317. package/dist/client/params-context.d.ts +81 -0
  318. package/dist/client/params-context.d.ts.map +1 -0
  319. package/dist/client/react-root.d.ts +51 -0
  320. package/dist/client/react-root.d.ts.map +1 -0
  321. package/dist/client/router-effects.d.ts +203 -0
  322. package/dist/client/router-effects.d.ts.map +1 -0
  323. package/dist/client/router-lifecycle.d.ts +104 -0
  324. package/dist/client/router-lifecycle.d.ts.map +1 -0
  325. package/dist/client/router-pipeline.d.ts +81 -0
  326. package/dist/client/router-pipeline.d.ts.map +1 -0
  327. package/dist/client/router-ref.d.ts +2 -2
  328. package/dist/client/router-ref.d.ts.map +1 -1
  329. package/dist/client/router-skew.d.ts +21 -0
  330. package/dist/client/router-skew.d.ts.map +1 -0
  331. package/dist/client/router-types.d.ts +294 -0
  332. package/dist/client/router-types.d.ts.map +1 -0
  333. package/dist/client/router-url.d.ts +24 -0
  334. package/dist/client/router-url.d.ts.map +1 -0
  335. package/dist/client/router.d.ts +1 -97
  336. package/dist/client/router.d.ts.map +1 -1
  337. package/dist/client/rsc-fetch.d.ts +110 -28
  338. package/dist/client/rsc-fetch.d.ts.map +1 -1
  339. package/dist/client/segment-cache.d.ts +186 -25
  340. package/dist/client/segment-cache.d.ts.map +1 -1
  341. package/dist/client/segment-context.d.ts.map +1 -1
  342. package/dist/client/segment-outlet.d.ts +68 -0
  343. package/dist/client/segment-outlet.d.ts.map +1 -0
  344. package/dist/client/segment-update-context.d.ts +15 -0
  345. package/dist/client/segment-update-context.d.ts.map +1 -0
  346. package/dist/client/shallow-url.d.ts +10 -0
  347. package/dist/client/shallow-url.d.ts.map +1 -0
  348. package/dist/client/slot-content-cache-context.d.ts +35 -0
  349. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  350. package/dist/client/slot-context.d.ts +31 -0
  351. package/dist/client/slot-context.d.ts.map +1 -0
  352. package/dist/client/slot-outlet.d.ts +16 -0
  353. package/dist/client/slot-outlet.d.ts.map +1 -0
  354. package/dist/client/slot-provider.d.ts +25 -0
  355. package/dist/client/slot-provider.d.ts.map +1 -0
  356. package/dist/client/ssr-data.d.ts +26 -50
  357. package/dist/client/ssr-data.d.ts.map +1 -1
  358. package/dist/client/stale-client.d.ts +69 -0
  359. package/dist/client/stale-client.d.ts.map +1 -0
  360. package/dist/client/state.d.ts +21 -13
  361. package/dist/client/state.d.ts.map +1 -1
  362. package/dist/client/status-page-marker.d.ts +25 -0
  363. package/dist/client/status-page-marker.d.ts.map +1 -0
  364. package/dist/client/top-loader.d.ts +7 -6
  365. package/dist/client/top-loader.d.ts.map +1 -1
  366. package/dist/client/unload-guard.d.ts +5 -0
  367. package/dist/client/unload-guard.d.ts.map +1 -1
  368. package/dist/client/use-cookie.d.ts +12 -0
  369. package/dist/client/use-cookie.d.ts.map +1 -1
  370. package/dist/client/use-field-state.d.ts +42 -0
  371. package/dist/client/use-field-state.d.ts.map +1 -0
  372. package/dist/client/use-link-status.d.ts +5 -5
  373. package/dist/client/use-link-status.d.ts.map +1 -1
  374. package/dist/client/use-pathname.d.ts +13 -11
  375. package/dist/client/use-pathname.d.ts.map +1 -1
  376. package/dist/client/use-pending-navigation.d.ts +23 -0
  377. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  378. package/dist/client/use-query-states.d.ts +10 -4
  379. package/dist/client/use-query-states.d.ts.map +1 -1
  380. package/dist/client/use-router.d.ts +15 -8
  381. package/dist/client/use-router.d.ts.map +1 -1
  382. package/dist/client/use-search-params.d.ts +15 -8
  383. package/dist/client/use-search-params.d.ts.map +1 -1
  384. package/dist/client/use-segment-params.d.ts +55 -0
  385. package/dist/client/use-segment-params.d.ts.map +1 -0
  386. package/dist/codec.d.ts +69 -0
  387. package/dist/codec.d.ts.map +1 -0
  388. package/dist/codec.js +76 -0
  389. package/dist/codec.js.map +1 -0
  390. package/dist/config-types.d.ts +321 -0
  391. package/dist/config-types.d.ts.map +1 -0
  392. package/dist/config-validation.d.ts +68 -0
  393. package/dist/config-validation.d.ts.map +1 -0
  394. package/dist/cookies/define-cookie.d.ts +58 -25
  395. package/dist/cookies/define-cookie.d.ts.map +1 -1
  396. package/dist/cookies/index.d.ts +3 -2
  397. package/dist/cookies/index.d.ts.map +1 -1
  398. package/dist/cookies/index.js +256 -36
  399. package/dist/cookies/index.js.map +1 -1
  400. package/dist/cookies/json-cookie.d.ts +64 -0
  401. package/dist/cookies/json-cookie.d.ts.map +1 -0
  402. package/dist/cookies/validation.d.ts +34 -0
  403. package/dist/cookies/validation.d.ts.map +1 -0
  404. package/dist/dev-tools/404-page.d.ts +50 -0
  405. package/dist/dev-tools/404-page.d.ts.map +1 -0
  406. package/dist/dev-tools/browser-logs.d.ts +40 -0
  407. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  408. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  409. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  410. package/dist/dev-tools/error-page.d.ts +32 -0
  411. package/dist/dev-tools/error-page.d.ts.map +1 -0
  412. package/dist/dev-tools/holding-server.d.ts +46 -0
  413. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  414. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  415. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  416. package/dist/dev-tools/index.d.ts +31 -0
  417. package/dist/dev-tools/index.d.ts.map +1 -0
  418. package/dist/dev-tools/instrumentation.d.ts +74 -0
  419. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  420. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  421. package/dist/dev-tools/logger.d.ts.map +1 -0
  422. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  423. package/dist/dev-tools/logs.d.ts.map +1 -0
  424. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  425. package/dist/dev-tools/overlay.d.ts.map +1 -0
  426. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  427. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  428. package/dist/dev-tools/terminal.d.ts +28 -0
  429. package/dist/dev-tools/terminal.d.ts.map +1 -0
  430. package/dist/fonts/ast-walk.d.ts +68 -0
  431. package/dist/fonts/ast-walk.d.ts.map +1 -0
  432. package/dist/fonts/ast.d.ts +112 -8
  433. package/dist/fonts/ast.d.ts.map +1 -1
  434. package/dist/fonts/bundle.d.ts +50 -0
  435. package/dist/fonts/bundle.d.ts.map +1 -0
  436. package/dist/fonts/css.d.ts +1 -1
  437. package/dist/fonts/dev-middleware.d.ts +22 -0
  438. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  439. package/dist/fonts/fallbacks.d.ts +0 -7
  440. package/dist/fonts/fallbacks.d.ts.map +1 -1
  441. package/dist/fonts/google.d.ts +5 -3
  442. package/dist/fonts/google.d.ts.map +1 -1
  443. package/dist/fonts/local.d.ts +5 -5
  444. package/dist/fonts/local.d.ts.map +1 -1
  445. package/dist/fonts/paths.d.ts +43 -0
  446. package/dist/fonts/paths.d.ts.map +1 -0
  447. package/dist/fonts/pipeline.d.ts +177 -0
  448. package/dist/fonts/pipeline.d.ts.map +1 -0
  449. package/dist/fonts/transform.d.ts +82 -0
  450. package/dist/fonts/transform.d.ts.map +1 -0
  451. package/dist/fonts/types.d.ts +47 -1
  452. package/dist/fonts/types.d.ts.map +1 -1
  453. package/dist/fonts/virtual-modules.d.ts +77 -0
  454. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  455. package/dist/index.d.ts +35 -181
  456. package/dist/index.d.ts.map +1 -1
  457. package/dist/index.js +8972 -14234
  458. package/dist/index.js.map +1 -1
  459. package/dist/params/codec-registry.d.ts +26 -0
  460. package/dist/params/codec-registry.d.ts.map +1 -0
  461. package/dist/params/define-schema.d.ts +81 -0
  462. package/dist/params/define-schema.d.ts.map +1 -0
  463. package/dist/params/index.d.ts +5 -0
  464. package/dist/params/index.d.ts.map +1 -0
  465. package/dist/params/index.js +34 -0
  466. package/dist/params/index.js.map +1 -0
  467. package/dist/params/resolve-schema.d.ts +34 -0
  468. package/dist/params/resolve-schema.d.ts.map +1 -0
  469. package/dist/plugin-context.d.ts +262 -0
  470. package/dist/plugin-context.d.ts.map +1 -0
  471. package/dist/plugins/build-manifest.d.ts +7 -3
  472. package/dist/plugins/build-manifest.d.ts.map +1 -1
  473. package/dist/plugins/build-report.d.ts +61 -11
  474. package/dist/plugins/build-report.d.ts.map +1 -1
  475. package/dist/plugins/cache.d.ts +64 -0
  476. package/dist/plugins/cache.d.ts.map +1 -0
  477. package/dist/plugins/callsite-ast.d.ts +117 -0
  478. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  479. package/dist/plugins/callsite-jsx.d.ts +35 -0
  480. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  481. package/dist/plugins/chunks.d.ts +11 -4
  482. package/dist/plugins/chunks.d.ts.map +1 -1
  483. package/dist/plugins/client-chunks.d.ts +40 -0
  484. package/dist/plugins/client-chunks.d.ts.map +1 -0
  485. package/dist/plugins/client-dep-entries.d.ts +80 -0
  486. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  487. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  488. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  489. package/dist/plugins/content.d.ts +1 -1
  490. package/dist/plugins/content.d.ts.map +1 -1
  491. package/dist/plugins/dev-discovery.d.ts +123 -0
  492. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  493. package/dist/plugins/dev-server.d.ts +24 -1
  494. package/dist/plugins/dev-server.d.ts.map +1 -1
  495. package/dist/plugins/encryption-runtime.d.ts +13 -0
  496. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  497. package/dist/plugins/entries.d.ts +40 -4
  498. package/dist/plugins/entries.d.ts.map +1 -1
  499. package/dist/plugins/fonts.d.ts +35 -74
  500. package/dist/plugins/fonts.d.ts.map +1 -1
  501. package/dist/plugins/graph-endpoint.d.ts +112 -0
  502. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  503. package/dist/plugins/mdx.d.ts +18 -5
  504. package/dist/plugins/mdx.d.ts.map +1 -1
  505. package/dist/plugins/orphaned-modules.d.ts +57 -0
  506. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  507. package/dist/plugins/post-build.d.ts +110 -0
  508. package/dist/plugins/post-build.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  510. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  511. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  512. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  513. package/dist/plugins/prebuilt.d.ts +98 -0
  514. package/dist/plugins/prebuilt.d.ts.map +1 -0
  515. package/dist/plugins/prerender-sugar.d.ts +39 -0
  516. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  517. package/dist/plugins/react-resolve.d.ts +49 -0
  518. package/dist/plugins/react-resolve.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  520. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  521. package/dist/plugins/request-dep/index.d.ts +75 -0
  522. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  523. package/dist/plugins/request-dep/origin.d.ts +61 -0
  524. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  525. package/dist/plugins/routing.d.ts +2 -2
  526. package/dist/plugins/routing.d.ts.map +1 -1
  527. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  528. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  529. package/dist/plugins/server-bundle.d.ts +1 -1
  530. package/dist/plugins/server-bundle.d.ts.map +1 -1
  531. package/dist/plugins/shims.d.ts +29 -5
  532. package/dist/plugins/shims.d.ts.map +1 -1
  533. package/dist/plugins/static-build.d.ts +246 -26
  534. package/dist/plugins/static-build.d.ts.map +1 -1
  535. package/dist/routing/codegen-shared.d.ts +26 -0
  536. package/dist/routing/codegen-shared.d.ts.map +1 -0
  537. package/dist/routing/codegen-types.d.ts +61 -0
  538. package/dist/routing/codegen-types.d.ts.map +1 -0
  539. package/dist/routing/codegen-write.d.ts +42 -0
  540. package/dist/routing/codegen-write.d.ts.map +1 -0
  541. package/dist/routing/codegen.d.ts +8 -3
  542. package/dist/routing/codegen.d.ts.map +1 -1
  543. package/dist/routing/collision-probe.d.ts +104 -0
  544. package/dist/routing/collision-probe.d.ts.map +1 -0
  545. package/dist/routing/collision-spaces.d.ts +26 -0
  546. package/dist/routing/collision-spaces.d.ts.map +1 -0
  547. package/dist/routing/convention-lint.d.ts +55 -0
  548. package/dist/routing/convention-lint.d.ts.map +1 -0
  549. package/dist/routing/export-detect.d.ts +91 -0
  550. package/dist/routing/export-detect.d.ts.map +1 -0
  551. package/dist/routing/file-cache.d.ts +8 -0
  552. package/dist/routing/file-cache.d.ts.map +1 -0
  553. package/dist/routing/index.d.ts +13 -7
  554. package/dist/routing/index.d.ts.map +1 -1
  555. package/dist/routing/index.js +5 -2
  556. package/dist/routing/interception-overlap.d.ts +35 -0
  557. package/dist/routing/interception-overlap.d.ts.map +1 -0
  558. package/dist/routing/interception.d.ts +234 -10
  559. package/dist/routing/interception.d.ts.map +1 -1
  560. package/dist/routing/link-codegen.d.ts +105 -0
  561. package/dist/routing/link-codegen.d.ts.map +1 -0
  562. package/dist/routing/manifest-codegen.d.ts +26 -0
  563. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  564. package/dist/routing/scanner.d.ts +14 -10
  565. package/dist/routing/scanner.d.ts.map +1 -1
  566. package/dist/routing/schema-validation.d.ts +35 -0
  567. package/dist/routing/schema-validation.d.ts.map +1 -0
  568. package/dist/routing/segment-classify.d.ts +114 -0
  569. package/dist/routing/segment-classify.d.ts.map +1 -0
  570. package/dist/routing/segment-codegen.d.ts +38 -0
  571. package/dist/routing/segment-codegen.d.ts.map +1 -0
  572. package/dist/routing/segment-keys.d.ts +118 -0
  573. package/dist/routing/segment-keys.d.ts.map +1 -0
  574. package/dist/routing/slot-placement.d.ts +48 -0
  575. package/dist/routing/slot-placement.d.ts.map +1 -0
  576. package/dist/routing/types.d.ts +81 -26
  577. package/dist/routing/types.d.ts.map +1 -1
  578. package/dist/routing/walkers.d.ts +57 -0
  579. package/dist/routing/walkers.d.ts.map +1 -0
  580. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  581. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  582. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  583. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  584. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  585. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  586. package/dist/rsc-runtime/rsc.d.ts +2 -13
  587. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  588. package/dist/rsc-runtime/ssr.d.ts +7 -10
  589. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  590. package/dist/rsc-runtime/transforms.d.ts +13 -0
  591. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  592. package/dist/schema-bridge.d.ts +145 -0
  593. package/dist/schema-bridge.d.ts.map +1 -0
  594. package/dist/search-params/define.d.ts +262 -0
  595. package/dist/search-params/define.d.ts.map +1 -0
  596. package/dist/search-params/index.d.ts +3 -7
  597. package/dist/search-params/index.d.ts.map +1 -1
  598. package/dist/search-params/index.js +179 -360
  599. package/dist/search-params/index.js.map +1 -1
  600. package/dist/search-params/parse-total.d.ts +81 -0
  601. package/dist/search-params/parse-total.d.ts.map +1 -0
  602. package/dist/search-params/serialize-equal.d.ts +9 -0
  603. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  604. package/dist/search-params/wrappers.d.ts +76 -0
  605. package/dist/search-params/wrappers.d.ts.map +1 -0
  606. package/dist/server/abort-scope.d.ts +27 -0
  607. package/dist/server/abort-scope.d.ts.map +1 -0
  608. package/dist/server/access-gate.d.ts +98 -10
  609. package/dist/server/access-gate.d.ts.map +1 -1
  610. package/dist/server/action-client.d.ts +20 -133
  611. package/dist/server/action-client.d.ts.map +1 -1
  612. package/dist/server/action-encryption.d.ts +76 -0
  613. package/dist/server/action-encryption.d.ts.map +1 -0
  614. package/dist/server/action-handler.d.ts +58 -11
  615. package/dist/server/action-handler.d.ts.map +1 -1
  616. package/dist/server/action-schema.d.ts +126 -0
  617. package/dist/server/action-schema.d.ts.map +1 -0
  618. package/dist/server/action-types.d.ts +108 -0
  619. package/dist/server/action-types.d.ts.map +1 -0
  620. package/dist/server/actions.d.ts +78 -40
  621. package/dist/server/actions.d.ts.map +1 -1
  622. package/dist/server/als-registry.d.ts +189 -17
  623. package/dist/server/als-registry.d.ts.map +1 -1
  624. package/dist/server/body-limits.d.ts.map +1 -1
  625. package/dist/server/build-manifest.d.ts +25 -30
  626. package/dist/server/build-manifest.d.ts.map +1 -1
  627. package/dist/server/canonicalize.d.ts +32 -0
  628. package/dist/server/canonicalize.d.ts.map +1 -1
  629. package/dist/server/chain-url-parts.d.ts +82 -0
  630. package/dist/server/chain-url-parts.d.ts.map +1 -0
  631. package/dist/server/children-interception.d.ts +49 -0
  632. package/dist/server/children-interception.d.ts.map +1 -0
  633. package/dist/server/client-error-message.d.ts +12 -0
  634. package/dist/server/client-error-message.d.ts.map +1 -0
  635. package/dist/server/coalesce-tick.d.ts +40 -0
  636. package/dist/server/coalesce-tick.d.ts.map +1 -0
  637. package/dist/server/compress.d.ts +2 -0
  638. package/dist/server/compress.d.ts.map +1 -1
  639. package/dist/server/cookie-context.d.ts +149 -0
  640. package/dist/server/cookie-context.d.ts.map +1 -0
  641. package/dist/server/cookie-parsing.d.ts +65 -0
  642. package/dist/server/cookie-parsing.d.ts.map +1 -0
  643. package/dist/server/csp-nonce.d.ts +36 -0
  644. package/dist/server/csp-nonce.d.ts.map +1 -0
  645. package/dist/server/csrf.d.ts +58 -15
  646. package/dist/server/csrf.d.ts.map +1 -1
  647. package/dist/server/debug.d.ts +0 -1
  648. package/dist/server/debug.d.ts.map +1 -1
  649. package/dist/server/default-logger.d.ts +23 -0
  650. package/dist/server/default-logger.d.ts.map +1 -0
  651. package/dist/server/default-status-page.d.ts +45 -0
  652. package/dist/server/default-status-page.d.ts.map +1 -0
  653. package/dist/server/deny-boundary.d.ts +257 -0
  654. package/dist/server/deny-boundary.d.ts.map +1 -0
  655. package/dist/server/deny-renderer.d.ts +22 -15
  656. package/dist/server/deny-renderer.d.ts.map +1 -1
  657. package/dist/server/early-hints-sender.d.ts.map +1 -1
  658. package/dist/server/early-hints.d.ts +14 -12
  659. package/dist/server/early-hints.d.ts.map +1 -1
  660. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  661. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  662. package/dist/server/error-response-headers.d.ts +3 -0
  663. package/dist/server/error-response-headers.d.ts.map +1 -0
  664. package/dist/server/fallback-error.d.ts +19 -7
  665. package/dist/server/fallback-error.d.ts.map +1 -1
  666. package/dist/server/flight-injection-state.d.ts +66 -0
  667. package/dist/server/flight-injection-state.d.ts.map +1 -0
  668. package/dist/server/flight-injector-core.d.ts +125 -0
  669. package/dist/server/flight-injector-core.d.ts.map +1 -0
  670. package/dist/server/flight-scripts.d.ts +63 -0
  671. package/dist/server/flight-scripts.d.ts.map +1 -0
  672. package/dist/server/flight-source-node.d.ts +105 -0
  673. package/dist/server/flight-source-node.d.ts.map +1 -0
  674. package/dist/server/flight-source.d.ts +136 -0
  675. package/dist/server/flight-source.d.ts.map +1 -0
  676. package/dist/server/form-data.d.ts +59 -2
  677. package/dist/server/form-data.d.ts.map +1 -1
  678. package/dist/server/form-state-flight.d.ts +32 -0
  679. package/dist/server/form-state-flight.d.ts.map +1 -0
  680. package/dist/server/head-response.d.ts +35 -0
  681. package/dist/server/head-response.d.ts.map +1 -0
  682. package/dist/server/html-injector-core.d.ts +169 -0
  683. package/dist/server/html-injector-core.d.ts.map +1 -0
  684. package/dist/server/html-injectors.d.ts +77 -47
  685. package/dist/server/html-injectors.d.ts.map +1 -1
  686. package/dist/server/index.d.ts +16 -54
  687. package/dist/server/index.d.ts.map +1 -1
  688. package/dist/server/index.js +638 -3021
  689. package/dist/server/index.js.map +1 -1
  690. package/dist/server/instrumentation.d.ts +13 -5
  691. package/dist/server/instrumentation.d.ts.map +1 -1
  692. package/dist/server/internal.d.ts +47 -0
  693. package/dist/server/internal.d.ts.map +1 -0
  694. package/dist/server/internal.js +4845 -0
  695. package/dist/server/internal.js.map +1 -0
  696. package/dist/server/json-status-response.d.ts +34 -0
  697. package/dist/server/json-status-response.d.ts.map +1 -0
  698. package/dist/server/logger.d.ts +79 -7
  699. package/dist/server/logger.d.ts.map +1 -1
  700. package/dist/server/metadata-collector.d.ts +75 -0
  701. package/dist/server/metadata-collector.d.ts.map +1 -0
  702. package/dist/server/metadata-platform.d.ts +2 -2
  703. package/dist/server/metadata-render.d.ts +2 -2
  704. package/dist/server/metadata-render.d.ts.map +1 -1
  705. package/dist/server/metadata-route-links.d.ts +70 -0
  706. package/dist/server/metadata-route-links.d.ts.map +1 -0
  707. package/dist/server/metadata-routes.d.ts +47 -11
  708. package/dist/server/metadata-routes.d.ts.map +1 -1
  709. package/dist/server/metadata-social.d.ts +2 -2
  710. package/dist/server/metadata.d.ts +10 -2
  711. package/dist/server/metadata.d.ts.map +1 -1
  712. package/dist/server/middleware-runner.d.ts +20 -5
  713. package/dist/server/middleware-runner.d.ts.map +1 -1
  714. package/dist/server/node-body-response.d.ts +55 -0
  715. package/dist/server/node-body-response.d.ts.map +1 -0
  716. package/dist/server/node-response.d.ts +62 -0
  717. package/dist/server/node-response.d.ts.map +1 -0
  718. package/dist/server/node-stream-transforms.d.ts +108 -0
  719. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  720. package/dist/server/node-streams-platform.d.ts +21 -0
  721. package/dist/server/node-streams-platform.d.ts.map +1 -0
  722. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  723. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  724. package/dist/server/param-coercion.d.ts +83 -0
  725. package/dist/server/param-coercion.d.ts.map +1 -0
  726. package/dist/server/pipeline-helpers.d.ts +224 -0
  727. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  728. package/dist/server/pipeline-interception.d.ts +70 -9
  729. package/dist/server/pipeline-interception.d.ts.map +1 -1
  730. package/dist/server/pipeline-metadata.d.ts +16 -1
  731. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  732. package/dist/server/pipeline-outcome.d.ts +59 -0
  733. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  734. package/dist/server/pipeline-phases.d.ts +70 -0
  735. package/dist/server/pipeline-phases.d.ts.map +1 -0
  736. package/dist/server/pipeline.d.ts +164 -23
  737. package/dist/server/pipeline.d.ts.map +1 -1
  738. package/dist/server/port-resolution.d.ts +22 -0
  739. package/dist/server/port-resolution.d.ts.map +1 -0
  740. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  741. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  742. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  743. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  744. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  745. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  746. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  747. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  748. package/dist/server/prebuilt/dev-store.d.ts +103 -0
  749. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  750. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  751. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  752. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  753. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  754. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  755. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  756. package/dist/server/prebuilt/overlay.d.ts +105 -0
  757. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  758. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  759. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  760. package/dist/server/prebuilt/slots.d.ts +105 -0
  761. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  762. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  763. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  764. package/dist/server/prebuilt-builder.d.ts +121 -0
  765. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  766. package/dist/server/prebuilt-runtime.d.ts +105 -0
  767. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  768. package/dist/server/primitives.d.ts +101 -90
  769. package/dist/server/primitives.d.ts.map +1 -1
  770. package/dist/server/publish-params.d.ts +33 -0
  771. package/dist/server/publish-params.d.ts.map +1 -0
  772. package/dist/server/react-cache-bridge.d.ts +59 -0
  773. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  774. package/dist/server/react-cache-scope.d.ts +49 -0
  775. package/dist/server/react-cache-scope.d.ts.map +1 -0
  776. package/dist/server/render-timeout.d.ts +66 -0
  777. package/dist/server/render-timeout.d.ts.map +1 -0
  778. package/dist/server/render-utils.d.ts +35 -0
  779. package/dist/server/render-utils.d.ts.map +1 -0
  780. package/dist/server/request-context.d.ts +153 -103
  781. package/dist/server/request-context.d.ts.map +1 -1
  782. package/dist/server/request-dep.d.ts +15 -0
  783. package/dist/server/request-dep.d.ts.map +1 -0
  784. package/dist/server/response-cache-policy.d.ts +3 -0
  785. package/dist/server/response-cache-policy.d.ts.map +1 -0
  786. package/dist/server/route-element-builder.d.ts +57 -30
  787. package/dist/server/route-element-builder.d.ts.map +1 -1
  788. package/dist/server/route-element-helpers.d.ts +12 -0
  789. package/dist/server/route-element-helpers.d.ts.map +1 -0
  790. package/dist/server/route-handler.d.ts +1 -1
  791. package/dist/server/route-handler.d.ts.map +1 -1
  792. package/dist/server/route-matcher.d.ts +62 -38
  793. package/dist/server/route-matcher.d.ts.map +1 -1
  794. package/dist/server/route-module-loader.d.ts +37 -0
  795. package/dist/server/route-module-loader.d.ts.map +1 -0
  796. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  797. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  798. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  799. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  800. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  801. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  802. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  803. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  804. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  805. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  807. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  808. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  809. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/index.d.ts +30 -6
  811. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  813. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  814. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  815. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  816. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  817. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  818. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  819. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  820. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  821. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  822. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  823. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  824. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  825. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  826. package/dist/server/rsc-error-envelope.d.ts +11 -0
  827. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  828. package/dist/server/safe-load.d.ts +39 -0
  829. package/dist/server/safe-load.d.ts.map +1 -0
  830. package/dist/server/schema-introspection.d.ts +68 -0
  831. package/dist/server/schema-introspection.d.ts.map +1 -0
  832. package/dist/server/sensitive-fields.d.ts +88 -0
  833. package/dist/server/sensitive-fields.d.ts.map +1 -0
  834. package/dist/server/signal-identity.d.ts +43 -0
  835. package/dist/server/signal-identity.d.ts.map +1 -0
  836. package/dist/server/sitemap-generator.d.ts +130 -0
  837. package/dist/server/sitemap-generator.d.ts.map +1 -0
  838. package/dist/server/sitemap-handler.d.ts +22 -0
  839. package/dist/server/sitemap-handler.d.ts.map +1 -0
  840. package/dist/server/skippable-prefix.d.ts +29 -0
  841. package/dist/server/skippable-prefix.d.ts.map +1 -0
  842. package/dist/server/slot-interception.d.ts +80 -0
  843. package/dist/server/slot-interception.d.ts.map +1 -0
  844. package/dist/server/slot-resolver.d.ts +138 -7
  845. package/dist/server/slot-resolver.d.ts.map +1 -1
  846. package/dist/server/slot-subtree-contain.d.ts +54 -0
  847. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  848. package/dist/server/ssr-bridge-types.d.ts +213 -0
  849. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  850. package/dist/server/ssr-entry.d.ts +15 -51
  851. package/dist/server/ssr-entry.d.ts.map +1 -1
  852. package/dist/server/ssr-form-state.d.ts +30 -0
  853. package/dist/server/ssr-form-state.d.ts.map +1 -0
  854. package/dist/server/ssr-render.d.ts +59 -32
  855. package/dist/server/ssr-render.d.ts.map +1 -1
  856. package/dist/server/ssr-wrappers.d.ts +93 -0
  857. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  858. package/dist/server/state-tree-diff.d.ts +44 -9
  859. package/dist/server/state-tree-diff.d.ts.map +1 -1
  860. package/dist/server/static-generator.d.ts +112 -0
  861. package/dist/server/static-generator.d.ts.map +1 -0
  862. package/dist/server/static-not-found.d.ts +52 -0
  863. package/dist/server/static-not-found.d.ts.map +1 -0
  864. package/dist/server/status-code-resolver.d.ts +26 -15
  865. package/dist/server/status-code-resolver.d.ts.map +1 -1
  866. package/dist/server/stream-utils.d.ts +93 -0
  867. package/dist/server/stream-utils.d.ts.map +1 -0
  868. package/dist/server/tracing.d.ts +57 -26
  869. package/dist/server/tracing.d.ts.map +1 -1
  870. package/dist/server/tree-match.d.ts +59 -0
  871. package/dist/server/tree-match.d.ts.map +1 -0
  872. package/dist/server/types.d.ts +89 -8
  873. package/dist/server/types.d.ts.map +1 -1
  874. package/dist/server/utils/element-type.d.ts +50 -0
  875. package/dist/server/utils/element-type.d.ts.map +1 -0
  876. package/dist/server/utils/escape-html.d.ts +14 -0
  877. package/dist/server/utils/escape-html.d.ts.map +1 -0
  878. package/dist/server/version-skew.d.ts +61 -0
  879. package/dist/server/version-skew.d.ts.map +1 -0
  880. package/dist/server/workers-cache-bridge.d.ts +26 -0
  881. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  882. package/dist/shared/als-slots.d.ts +42 -0
  883. package/dist/shared/als-slots.d.ts.map +1 -0
  884. package/dist/shared/base-path.d.ts +56 -0
  885. package/dist/shared/base-path.d.ts.map +1 -0
  886. package/dist/shared/csrf-reject.d.ts +16 -0
  887. package/dist/shared/csrf-reject.d.ts.map +1 -0
  888. package/dist/shared/error-digest.d.ts +28 -0
  889. package/dist/shared/error-digest.d.ts.map +1 -0
  890. package/dist/shared/flight-base64.d.ts +13 -0
  891. package/dist/shared/flight-base64.d.ts.map +1 -0
  892. package/dist/shared/flight-segment.d.ts +18 -0
  893. package/dist/shared/flight-segment.d.ts.map +1 -0
  894. package/dist/shared/form-state-flight.d.ts +32 -0
  895. package/dist/shared/form-state-flight.d.ts.map +1 -0
  896. package/dist/shared/href-validation.d.ts +49 -0
  897. package/dist/shared/href-validation.d.ts.map +1 -0
  898. package/dist/shared/merge-search-params.d.ts +22 -0
  899. package/dist/shared/merge-search-params.d.ts.map +1 -0
  900. package/dist/shared/param-value.d.ts +104 -0
  901. package/dist/shared/param-value.d.ts.map +1 -0
  902. package/dist/shared/payload-root.d.ts +110 -0
  903. package/dist/shared/payload-root.d.ts.map +1 -0
  904. package/dist/shared/redirect-type.d.ts +17 -0
  905. package/dist/shared/redirect-type.d.ts.map +1 -0
  906. package/dist/shared/rsc-cache-key.d.ts +163 -0
  907. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  908. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  909. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  910. package/dist/shared/rsc-manifest.d.ts +28 -0
  911. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  912. package/dist/shared/rsc-media-type.d.ts +52 -0
  913. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  914. package/dist/shared/rsc-payload-path.d.ts +48 -0
  915. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  916. package/dist/shared/segment-info.d.ts +66 -0
  917. package/dist/shared/segment-info.d.ts.map +1 -0
  918. package/dist/shared/slot-params.d.ts +52 -0
  919. package/dist/shared/slot-params.d.ts.map +1 -0
  920. package/dist/shared/static-platform-files.d.ts +71 -0
  921. package/dist/shared/static-platform-files.d.ts.map +1 -0
  922. package/dist/shared/status-reason-phrase.d.ts +26 -0
  923. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  924. package/dist/shims/font-google.d.ts +1 -1
  925. package/dist/shims/font-google.d.ts.map +1 -1
  926. package/dist/shims/font-google.js +42 -0
  927. package/dist/shims/font-google.js.map +1 -0
  928. package/dist/shims/font-local.d.ts +26 -0
  929. package/dist/shims/font-local.d.ts.map +1 -0
  930. package/dist/shims/font-local.js +20 -0
  931. package/dist/shims/font-local.js.map +1 -0
  932. package/dist/shims/headers.d.ts +53 -1
  933. package/dist/shims/headers.d.ts.map +1 -1
  934. package/dist/shims/image.d.ts +120 -120
  935. package/dist/shims/image.d.ts.map +1 -1
  936. package/dist/shims/navigation-client.d.ts +25 -12
  937. package/dist/shims/navigation-client.d.ts.map +1 -1
  938. package/dist/shims/navigation-rsc.d.ts +21 -0
  939. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  940. package/dist/shims/navigation.d.ts +10 -5
  941. package/dist/shims/navigation.d.ts.map +1 -1
  942. package/dist/utils/state-machine.d.ts +80 -0
  943. package/dist/utils/state-machine.d.ts.map +1 -0
  944. package/dist/utils/write-file-atomic.d.ts +17 -0
  945. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  946. package/docs/api/30-api-server.mdx +239 -0
  947. package/docs/api/31-api-client.mdx +199 -0
  948. package/docs/api/32-api-cache.mdx +341 -0
  949. package/docs/api/33-api-search-params.mdx +176 -0
  950. package/docs/api/34-api-config.mdx +359 -0
  951. package/docs/api/35-api-typescript.mdx +91 -0
  952. package/docs/api/36-cli.mdx +206 -0
  953. package/docs/learn/00-introduction.mdx +109 -0
  954. package/docs/learn/01-quick-start.mdx +94 -0
  955. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  956. package/docs/learn/03-fetching-data.mdx +227 -0
  957. package/docs/learn/04-access-control.mdx +115 -0
  958. package/docs/learn/05-the-flush-point.mdx +175 -0
  959. package/docs/learn/06-typed-params.mdx +275 -0
  960. package/docs/learn/07-typed-routes.mdx +108 -0
  961. package/docs/learn/08-forms-and-actions.mdx +260 -0
  962. package/docs/learn/09-streaming.mdx +140 -0
  963. package/docs/learn/10-caching.mdx +282 -0
  964. package/docs/learn/11-middleware.mdx +166 -0
  965. package/docs/learn/12-error-handling.mdx +192 -0
  966. package/docs/learn/13-deploying.mdx +289 -0
  967. package/llms.txt +55 -0
  968. package/package.json +120 -29
  969. package/src/adapters/build-output-helper.ts +353 -0
  970. package/src/adapters/canonicalize-module.ts +29 -0
  971. package/src/adapters/cloudflare-dev.ts +183 -0
  972. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  973. package/src/adapters/cloudflare.ts +809 -150
  974. package/src/adapters/compress-module.ts +110 -86
  975. package/src/adapters/fs-identity.ts +155 -0
  976. package/src/adapters/nitro-immutable-assets.ts +142 -0
  977. package/src/adapters/nitro-presets.ts +124 -0
  978. package/src/adapters/nitro-preview.ts +533 -0
  979. package/src/adapters/nitro.ts +331 -445
  980. package/src/adapters/raw-imports.d.ts +5 -0
  981. package/src/adapters/shared.ts +283 -0
  982. package/src/adapters/types.ts +129 -17
  983. package/src/adapters/wrangler.d.ts +7 -0
  984. package/src/analyze/chains.ts +411 -0
  985. package/src/analyze/classify.ts +259 -0
  986. package/src/analyze/crawl-entry.ts +68 -0
  987. package/src/analyze/crawl.ts +500 -0
  988. package/src/analyze/graph-cache.ts +331 -0
  989. package/src/analyze/graph-command.ts +762 -0
  990. package/src/analyze/live-graph.ts +232 -0
  991. package/src/analyze/poison-rules.ts +165 -0
  992. package/src/analyze/poison-scan.ts +159 -0
  993. package/src/analyze/scan.ts +149 -0
  994. package/src/cache/cache-api.ts +113 -0
  995. package/src/cache/fast-hash.ts +5 -0
  996. package/src/cache/handler-store.ts +113 -0
  997. package/src/cache/index.ts +115 -22
  998. package/src/cache/invalidation-epoch.ts +105 -0
  999. package/src/cache/json-lossy-check.ts +69 -0
  1000. package/src/cache/redis-handler.ts +198 -20
  1001. package/src/cache/singleflight.ts +72 -6
  1002. package/src/cache/sizeof.ts +35 -0
  1003. package/src/cache/stable-stringify.ts +65 -2
  1004. package/src/cache/store.ts +71 -0
  1005. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1006. package/src/cache/stores/memory.ts +125 -0
  1007. package/src/cache/stores/redis.ts +97 -0
  1008. package/src/cache/stores/vercel.ts +59 -0
  1009. package/src/cache/tag-aware-handler.ts +254 -0
  1010. package/src/cache/timber-cache.ts +169 -40
  1011. package/src/cdn/cloudflare-purge.ts +50 -0
  1012. package/src/cdn/fastly-purge.ts +63 -0
  1013. package/src/cdn/headers.ts +153 -0
  1014. package/src/cdn/index.ts +23 -0
  1015. package/src/cdn/purge-store.ts +62 -0
  1016. package/src/cdn/workers-cache-purge.ts +34 -0
  1017. package/src/cli-check.ts +417 -0
  1018. package/src/cli-context.ts +119 -0
  1019. package/src/cli-schema-sync.ts +401 -0
  1020. package/src/cli.ts +334 -80
  1021. package/src/client/browser-dev.ts +192 -5
  1022. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1023. package/src/client/browser-entry/action-queue.ts +152 -0
  1024. package/src/client/browser-entry/form-state.ts +49 -0
  1025. package/src/client/browser-entry/hmr.ts +70 -0
  1026. package/src/client/browser-entry/hydrate.ts +152 -0
  1027. package/src/client/browser-entry/index.ts +150 -0
  1028. package/src/client/browser-entry/post-hydration.ts +99 -0
  1029. package/src/client/browser-entry/router-init.ts +391 -0
  1030. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1031. package/src/client/browser-entry/scroll.ts +50 -0
  1032. package/src/client/deny-last-resort.tsx +54 -0
  1033. package/src/client/error-boundary.tsx +279 -61
  1034. package/src/client/error-reconstituter.tsx +84 -0
  1035. package/src/client/form.tsx +61 -173
  1036. package/src/client/global-context.ts +31 -0
  1037. package/src/client/history.ts +74 -11
  1038. package/src/client/index.ts +90 -53
  1039. package/src/client/internal.ts +54 -0
  1040. package/src/client/link.tsx +464 -151
  1041. package/src/client/location-search.ts +15 -0
  1042. package/src/client/navigation-api.ts +254 -0
  1043. package/src/client/navigation-commit.ts +318 -0
  1044. package/src/client/navigation-context.ts +67 -134
  1045. package/src/client/navigation-root.tsx +236 -0
  1046. package/src/client/navigation-transition.ts +401 -0
  1047. package/src/client/nuqs-adapter.tsx +21 -9
  1048. package/src/client/params-context.ts +187 -0
  1049. package/src/client/react-root.ts +105 -0
  1050. package/src/client/router-effects.ts +349 -0
  1051. package/src/client/router-lifecycle.ts +374 -0
  1052. package/src/client/router-pipeline.ts +443 -0
  1053. package/src/client/router-ref.ts +3 -3
  1054. package/src/client/router-skew.ts +30 -0
  1055. package/src/client/router-types.ts +326 -0
  1056. package/src/client/router-url.ts +32 -0
  1057. package/src/client/router.ts +491 -421
  1058. package/src/client/rsc-fetch.ts +510 -109
  1059. package/src/client/segment-cache.ts +362 -41
  1060. package/src/client/segment-context.ts +7 -4
  1061. package/src/client/segment-outlet.tsx +96 -0
  1062. package/src/client/segment-update-context.ts +23 -0
  1063. package/src/client/shallow-url.ts +22 -0
  1064. package/src/client/slot-content-cache-context.ts +43 -0
  1065. package/src/client/slot-context.ts +50 -0
  1066. package/src/client/slot-outlet.tsx +22 -0
  1067. package/src/client/slot-provider.tsx +32 -0
  1068. package/src/client/ssr-data.ts +27 -67
  1069. package/src/client/stale-client.ts +191 -0
  1070. package/src/client/state.ts +31 -24
  1071. package/src/client/status-page-marker.tsx +32 -0
  1072. package/src/client/top-loader.tsx +13 -10
  1073. package/src/client/unload-guard.ts +35 -3
  1074. package/src/client/use-cookie.ts +70 -18
  1075. package/src/client/use-field-state.ts +144 -0
  1076. package/src/client/use-link-status.ts +7 -7
  1077. package/src/client/use-pathname.ts +22 -31
  1078. package/src/client/use-pending-navigation.ts +40 -0
  1079. package/src/client/use-query-states.ts +206 -36
  1080. package/src/client/use-router.ts +31 -9
  1081. package/src/client/use-search-params.ts +38 -49
  1082. package/src/client/use-segment-params.ts +69 -0
  1083. package/src/client/use-selected-layout-segment.ts +2 -2
  1084. package/src/codec.ts +149 -0
  1085. package/src/config-types.ts +321 -0
  1086. package/src/config-validation.ts +464 -0
  1087. package/src/cookies/define-cookie.ts +222 -53
  1088. package/src/cookies/index.ts +13 -2
  1089. package/src/cookies/json-cookie.ts +105 -0
  1090. package/src/cookies/validation.ts +192 -0
  1091. package/src/dev-tools/404-page.ts +286 -0
  1092. package/src/dev-tools/browser-logs.ts +55 -0
  1093. package/src/dev-tools/dev-page-shell.ts +278 -0
  1094. package/src/dev-tools/error-page.ts +331 -0
  1095. package/src/dev-tools/holding-server.ts +185 -0
  1096. package/src/dev-tools/hydration-overlay.ts +158 -0
  1097. package/src/dev-tools/index.ts +79 -0
  1098. package/src/dev-tools/instrumentation.ts +261 -0
  1099. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1100. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +147 -25
  1101. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1102. package/src/dev-tools/stack-classifier.ts +75 -0
  1103. package/src/dev-tools/terminal.ts +182 -0
  1104. package/src/fonts/ast-walk.ts +235 -0
  1105. package/src/fonts/ast.ts +479 -128
  1106. package/src/fonts/bundle.ts +138 -0
  1107. package/src/fonts/css.ts +1 -1
  1108. package/src/fonts/dev-middleware.ts +85 -0
  1109. package/src/fonts/fallbacks.ts +0 -23
  1110. package/src/fonts/google.ts +101 -19
  1111. package/src/fonts/local.ts +12 -11
  1112. package/src/fonts/paths.ts +58 -0
  1113. package/src/fonts/pipeline.ts +348 -0
  1114. package/src/fonts/transform.ts +311 -0
  1115. package/src/fonts/types.ts +52 -1
  1116. package/src/fonts/virtual-modules.ts +179 -0
  1117. package/src/index.ts +492 -380
  1118. package/src/params/codec-registry.ts +34 -0
  1119. package/src/params/define-schema.ts +115 -0
  1120. package/src/params/index.ts +17 -0
  1121. package/src/params/resolve-schema.ts +84 -0
  1122. package/src/plugin-context.ts +502 -0
  1123. package/src/plugins/build-manifest.ts +189 -36
  1124. package/src/plugins/build-report.ts +299 -87
  1125. package/src/plugins/cache.ts +243 -0
  1126. package/src/plugins/callsite-ast.ts +472 -0
  1127. package/src/plugins/callsite-jsx.ts +243 -0
  1128. package/src/plugins/chunks.ts +74 -5
  1129. package/src/plugins/client-chunks.ts +185 -0
  1130. package/src/plugins/client-dep-entries.ts +124 -0
  1131. package/src/plugins/cloudflare-wasm.ts +141 -0
  1132. package/src/plugins/content.ts +31 -2
  1133. package/src/plugins/dev-discovery.ts +218 -0
  1134. package/src/plugins/dev-server.ts +376 -98
  1135. package/src/plugins/encryption-runtime.ts +31 -0
  1136. package/src/plugins/entries.ts +156 -17
  1137. package/src/plugins/fonts.ts +260 -657
  1138. package/src/plugins/graph-endpoint.ts +532 -0
  1139. package/src/plugins/mdx.ts +108 -35
  1140. package/src/plugins/orphaned-modules.ts +78 -0
  1141. package/src/plugins/post-build.ts +327 -0
  1142. package/src/plugins/prebuilt-capture.ts +213 -0
  1143. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1144. package/src/plugins/prebuilt.ts +670 -0
  1145. package/src/plugins/prerender-sugar.ts +348 -0
  1146. package/src/plugins/react-resolve.ts +149 -0
  1147. package/src/plugins/request-dep/analysis.ts +447 -0
  1148. package/src/plugins/request-dep/index.ts +376 -0
  1149. package/src/plugins/request-dep/origin.ts +310 -0
  1150. package/src/plugins/routing.ts +296 -278
  1151. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1152. package/src/plugins/server-bundle.ts +115 -15
  1153. package/src/plugins/shims.ts +257 -97
  1154. package/src/plugins/static-build.ts +681 -71
  1155. package/src/react-canary.d.ts +2 -0
  1156. package/src/routing/codegen-shared.ts +39 -0
  1157. package/src/routing/codegen-types.ts +62 -0
  1158. package/src/routing/codegen-write.ts +163 -0
  1159. package/src/routing/codegen.ts +349 -232
  1160. package/src/routing/collision-probe.ts +438 -0
  1161. package/src/routing/collision-spaces.ts +281 -0
  1162. package/src/routing/convention-lint.ts +651 -0
  1163. package/src/routing/export-detect.ts +536 -0
  1164. package/src/routing/file-cache.ts +23 -0
  1165. package/src/routing/index.ts +16 -7
  1166. package/src/routing/interception-overlap.ts +141 -0
  1167. package/src/routing/interception.ts +1044 -67
  1168. package/src/routing/link-codegen.ts +280 -0
  1169. package/src/routing/manifest-codegen.ts +232 -0
  1170. package/src/routing/scanner.ts +417 -223
  1171. package/src/routing/schema-validation.ts +155 -0
  1172. package/src/routing/segment-classify.ts +280 -0
  1173. package/src/routing/segment-codegen.ts +99 -0
  1174. package/src/routing/segment-keys.ts +186 -0
  1175. package/src/routing/slot-placement.ts +97 -0
  1176. package/src/routing/types.ts +82 -26
  1177. package/src/routing/walkers.ts +98 -0
  1178. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1179. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1180. package/src/rsc-runtime/render-flight.ts +26 -0
  1181. package/src/rsc-runtime/rsc.ts +27 -2
  1182. package/src/rsc-runtime/ssr.ts +23 -0
  1183. package/src/rsc-runtime/transforms.ts +13 -0
  1184. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1185. package/src/schema-bridge.ts +382 -0
  1186. package/src/search-params/define.ts +677 -0
  1187. package/src/search-params/index.ts +14 -20
  1188. package/src/search-params/parse-total.ts +91 -0
  1189. package/src/search-params/serialize-equal.ts +14 -0
  1190. package/src/search-params/wrappers.ts +150 -0
  1191. package/src/server/abort-scope.ts +49 -0
  1192. package/src/server/access-gate.tsx +195 -56
  1193. package/src/server/action-client.ts +175 -294
  1194. package/src/server/action-encryption.ts +144 -0
  1195. package/src/server/action-handler.ts +492 -150
  1196. package/src/server/action-schema.ts +203 -0
  1197. package/src/server/action-types.ts +145 -0
  1198. package/src/server/actions.ts +172 -85
  1199. package/src/server/als-registry.ts +245 -30
  1200. package/src/server/body-limits.ts +10 -2
  1201. package/src/server/build-manifest.ts +33 -57
  1202. package/src/server/canonicalize.ts +35 -3
  1203. package/src/server/chain-url-parts.ts +163 -0
  1204. package/src/server/children-interception.ts +116 -0
  1205. package/src/server/client-error-message.ts +18 -0
  1206. package/src/server/coalesce-tick.ts +75 -0
  1207. package/src/server/compress.ts +91 -19
  1208. package/src/server/cookie-context.ts +454 -0
  1209. package/src/server/cookie-parsing.ts +163 -0
  1210. package/src/server/csp-nonce.ts +58 -0
  1211. package/src/server/csrf.ts +228 -35
  1212. package/src/server/debug.ts +0 -1
  1213. package/src/server/default-logger.ts +100 -0
  1214. package/src/server/default-status-page.ts +88 -0
  1215. package/src/server/deny-boundary.ts +527 -0
  1216. package/src/server/deny-renderer.ts +210 -181
  1217. package/src/server/early-hints-sender.ts +4 -3
  1218. package/src/server/early-hints.ts +39 -29
  1219. package/src/server/error-boundary-wrapper.ts +160 -44
  1220. package/src/server/error-response-headers.ts +18 -0
  1221. package/src/server/fallback-error.ts +88 -104
  1222. package/src/server/flight-injection-state.ts +113 -0
  1223. package/src/server/flight-injector-core.ts +328 -0
  1224. package/src/server/flight-scripts.ts +92 -0
  1225. package/src/server/flight-source-node.ts +431 -0
  1226. package/src/server/flight-source.ts +288 -0
  1227. package/src/server/form-data.ts +191 -20
  1228. package/src/server/form-state-flight.ts +67 -0
  1229. package/src/server/head-response.ts +50 -0
  1230. package/src/server/html-injector-core.ts +320 -0
  1231. package/src/server/html-injectors.ts +241 -285
  1232. package/src/server/index.ts +37 -195
  1233. package/src/server/instrumentation.ts +42 -11
  1234. package/src/server/internal.ts +163 -0
  1235. package/src/server/json-status-response.ts +105 -0
  1236. package/src/server/logger.ts +131 -38
  1237. package/src/server/metadata-collector.ts +175 -0
  1238. package/src/server/metadata-platform.ts +2 -2
  1239. package/src/server/metadata-render.ts +30 -8
  1240. package/src/server/metadata-route-links.ts +200 -0
  1241. package/src/server/metadata-routes.ts +114 -24
  1242. package/src/server/metadata-social.ts +2 -2
  1243. package/src/server/metadata.ts +23 -2
  1244. package/src/server/middleware-runner.ts +32 -5
  1245. package/src/server/node-body-response.ts +236 -0
  1246. package/src/server/node-response.ts +93 -0
  1247. package/src/server/node-stream-transforms.ts +340 -0
  1248. package/src/server/node-streams-platform.ts +23 -0
  1249. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1250. package/src/server/param-coercion.ts +201 -0
  1251. package/src/server/pipeline-helpers.ts +550 -0
  1252. package/src/server/pipeline-interception.ts +241 -32
  1253. package/src/server/pipeline-metadata.ts +25 -1
  1254. package/src/server/pipeline-outcome.ts +290 -0
  1255. package/src/server/pipeline-phases.ts +503 -0
  1256. package/src/server/pipeline.ts +435 -427
  1257. package/src/server/port-resolution.ts +43 -0
  1258. package/src/server/prebuilt/cache-key.ts +340 -0
  1259. package/src/server/prebuilt/capture-render.ts +122 -0
  1260. package/src/server/prebuilt/capture-routes.ts +104 -0
  1261. package/src/server/prebuilt/capture-state.ts +196 -0
  1262. package/src/server/prebuilt/dev-store.ts +173 -0
  1263. package/src/server/prebuilt/key-discipline.ts +122 -0
  1264. package/src/server/prebuilt/lifetime.ts +151 -0
  1265. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1266. package/src/server/prebuilt/overlay.ts +262 -0
  1267. package/src/server/prebuilt/payload-source.ts +221 -0
  1268. package/src/server/prebuilt/slots.ts +201 -0
  1269. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1270. package/src/server/prebuilt-builder.ts +515 -0
  1271. package/src/server/prebuilt-runtime.ts +808 -0
  1272. package/src/server/primitives.ts +153 -171
  1273. package/src/server/publish-params.ts +42 -0
  1274. package/src/server/react-cache-bridge.ts +124 -0
  1275. package/src/server/react-cache-scope.ts +104 -0
  1276. package/src/server/render-timeout.ts +123 -0
  1277. package/src/server/render-utils.ts +45 -0
  1278. package/src/server/request-context.ts +298 -324
  1279. package/src/server/request-dep.ts +37 -0
  1280. package/src/server/response-cache-policy.ts +45 -0
  1281. package/src/server/route-element-builder.ts +526 -355
  1282. package/src/server/route-element-helpers.ts +37 -0
  1283. package/src/server/route-handler.ts +67 -27
  1284. package/src/server/route-matcher.ts +238 -267
  1285. package/src/server/route-module-loader.ts +161 -0
  1286. package/src/server/rsc-cache-key-guard.ts +122 -0
  1287. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1288. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1289. package/src/server/rsc-entry/api-handler.ts +49 -81
  1290. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1291. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1292. package/src/server/rsc-entry/helpers.ts +90 -115
  1293. package/src/server/rsc-entry/index.ts +405 -349
  1294. package/src/server/rsc-entry/render-route.ts +248 -0
  1295. package/src/server/rsc-entry/render-signals.ts +108 -0
  1296. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1297. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1298. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1299. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1300. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1301. package/src/server/rsc-error-envelope.ts +18 -0
  1302. package/src/server/rsc-prop-warnings.ts +1 -1
  1303. package/src/server/safe-load.ts +53 -0
  1304. package/src/server/schema-introspection.ts +393 -0
  1305. package/src/server/sensitive-fields.ts +287 -0
  1306. package/src/server/server-only-guard-noop.js +3 -0
  1307. package/src/server/server-timing.ts +1 -1
  1308. package/src/server/signal-identity.ts +112 -0
  1309. package/src/server/sitemap-generator.ts +337 -0
  1310. package/src/server/sitemap-handler.ts +150 -0
  1311. package/src/server/skippable-prefix.ts +172 -0
  1312. package/src/server/slot-interception.ts +168 -0
  1313. package/src/server/slot-resolver.ts +707 -300
  1314. package/src/server/slot-subtree-contain.ts +273 -0
  1315. package/src/server/ssr-bridge-types.ts +217 -0
  1316. package/src/server/ssr-entry.ts +248 -109
  1317. package/src/server/ssr-form-state.ts +58 -0
  1318. package/src/server/ssr-render.ts +332 -101
  1319. package/src/server/ssr-wrappers.tsx +162 -0
  1320. package/src/server/state-tree-diff.ts +85 -30
  1321. package/src/server/static-generator.ts +680 -0
  1322. package/src/server/static-not-found.ts +134 -0
  1323. package/src/server/status-code-resolver.ts +107 -148
  1324. package/src/server/stream-utils.ts +398 -0
  1325. package/src/server/tracing.ts +163 -68
  1326. package/src/server/tree-match.ts +494 -0
  1327. package/src/server/types.ts +96 -11
  1328. package/src/server/utils/element-type.ts +88 -0
  1329. package/src/server/utils/escape-html.ts +20 -0
  1330. package/src/server/version-skew.ts +104 -0
  1331. package/src/server/waituntil-bridge.ts +1 -1
  1332. package/src/server/workers-cache-bridge.ts +33 -0
  1333. package/src/shared/als-slots.ts +74 -0
  1334. package/src/shared/base-path.ts +80 -0
  1335. package/src/shared/csrf-reject.ts +15 -0
  1336. package/src/shared/error-digest.ts +46 -0
  1337. package/src/shared/flight-base64.ts +23 -0
  1338. package/src/shared/flight-segment.ts +35 -0
  1339. package/src/shared/form-state-flight.ts +59 -0
  1340. package/src/shared/href-validation.ts +159 -0
  1341. package/src/shared/merge-search-params.ts +55 -0
  1342. package/src/shared/param-value.ts +281 -0
  1343. package/src/shared/payload-root.ts +153 -0
  1344. package/src/shared/redirect-type.ts +17 -0
  1345. package/src/shared/rsc-cache-key.ts +269 -0
  1346. package/src/shared/rsc-error-envelope.ts +16 -0
  1347. package/src/shared/rsc-manifest.ts +29 -0
  1348. package/src/shared/rsc-media-type.ts +59 -0
  1349. package/src/shared/rsc-payload-path.ts +52 -0
  1350. package/src/shared/segment-info.ts +67 -0
  1351. package/src/shared/slot-params.ts +109 -0
  1352. package/src/shared/static-platform-files.ts +75 -0
  1353. package/src/shared/status-reason-phrase.ts +61 -0
  1354. package/src/shims/font-google.ts +1 -1
  1355. package/src/shims/font-local.ts +34 -0
  1356. package/src/shims/headers.ts +122 -1
  1357. package/src/shims/navigation-client.ts +36 -32
  1358. package/src/shims/navigation-rsc.ts +47 -0
  1359. package/src/shims/navigation.ts +10 -7
  1360. package/src/utils/state-machine.ts +111 -0
  1361. package/src/utils/write-file-atomic.ts +32 -0
  1362. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1363. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1364. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1365. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1366. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1367. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1368. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1369. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1370. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1371. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1372. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1373. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1374. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1375. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1376. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1377. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1378. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1379. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1380. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1381. package/dist/adapters/cloudflare.js.map +0 -1
  1382. package/dist/cache/index.js.map +0 -1
  1383. package/dist/cache/register-cached-function.d.ts +0 -17
  1384. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1385. package/dist/client/browser-entry.d.ts +0 -21
  1386. package/dist/client/browser-entry.d.ts.map +0 -1
  1387. package/dist/client/error-boundary.js.map +0 -1
  1388. package/dist/client/head.d.ts +0 -16
  1389. package/dist/client/head.d.ts.map +0 -1
  1390. package/dist/client/link-status-provider.d.ts +0 -11
  1391. package/dist/client/link-status-provider.d.ts.map +0 -1
  1392. package/dist/client/segment-merger.d.ts +0 -119
  1393. package/dist/client/segment-merger.d.ts.map +0 -1
  1394. package/dist/client/stale-reload.d.ts +0 -44
  1395. package/dist/client/stale-reload.d.ts.map +0 -1
  1396. package/dist/client/transition-root.d.ts +0 -74
  1397. package/dist/client/transition-root.d.ts.map +0 -1
  1398. package/dist/client/types.d.ts +0 -14
  1399. package/dist/client/types.d.ts.map +0 -1
  1400. package/dist/client/use-navigation-pending.d.ts +0 -26
  1401. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1402. package/dist/client/use-params.d.ts +0 -92
  1403. package/dist/client/use-params.d.ts.map +0 -1
  1404. package/dist/content/index.d.ts +0 -11
  1405. package/dist/content/index.d.ts.map +0 -1
  1406. package/dist/content/index.js +0 -2
  1407. package/dist/plugins/adapter-build.d.ts +0 -18
  1408. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1409. package/dist/plugins/cache-transform.d.ts +0 -36
  1410. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1411. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1412. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1413. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1414. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1415. package/dist/plugins/server-action-exports.d.ts +0 -26
  1416. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1417. package/dist/routing/status-file-lint.d.ts +0 -33
  1418. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1419. package/dist/search-params/analyze.d.ts +0 -54
  1420. package/dist/search-params/analyze.d.ts.map +0 -1
  1421. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1422. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1423. package/dist/search-params/codecs.d.ts +0 -53
  1424. package/dist/search-params/codecs.d.ts.map +0 -1
  1425. package/dist/search-params/create.d.ts +0 -106
  1426. package/dist/search-params/create.d.ts.map +0 -1
  1427. package/dist/search-params/registry.d.ts +0 -20
  1428. package/dist/search-params/registry.d.ts.map +0 -1
  1429. package/dist/server/asset-headers.d.ts +0 -42
  1430. package/dist/server/asset-headers.d.ts.map +0 -1
  1431. package/dist/server/client-module-map.d.ts +0 -47
  1432. package/dist/server/client-module-map.d.ts.map +0 -1
  1433. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1434. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1435. package/dist/server/dev-logger.d.ts.map +0 -1
  1436. package/dist/server/dev-span-processor.d.ts +0 -29
  1437. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1438. package/dist/server/dev-warnings.d.ts +0 -129
  1439. package/dist/server/dev-warnings.d.ts.map +0 -1
  1440. package/dist/server/flush.d.ts +0 -74
  1441. package/dist/server/flush.d.ts.map +0 -1
  1442. package/dist/server/form-flash.d.ts +0 -78
  1443. package/dist/server/form-flash.d.ts.map +0 -1
  1444. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1445. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1446. package/dist/server/prerender.d.ts +0 -77
  1447. package/dist/server/prerender.d.ts.map +0 -1
  1448. package/dist/server/tree-builder.d.ts +0 -126
  1449. package/dist/server/tree-builder.d.ts.map +0 -1
  1450. package/dist/utils/directive-parser.d.ts +0 -70
  1451. package/dist/utils/directive-parser.d.ts.map +0 -1
  1452. package/src/cache/register-cached-function.ts +0 -103
  1453. package/src/client/browser-entry.ts +0 -678
  1454. package/src/client/head.ts +0 -61
  1455. package/src/client/link-status-provider.tsx +0 -30
  1456. package/src/client/segment-merger.ts +0 -339
  1457. package/src/client/stale-reload.ts +0 -87
  1458. package/src/client/transition-root.tsx +0 -166
  1459. package/src/client/types.ts +0 -21
  1460. package/src/client/use-navigation-pending.ts +0 -38
  1461. package/src/client/use-params.ts +0 -141
  1462. package/src/content/index.ts +0 -13
  1463. package/src/plugins/adapter-build.ts +0 -118
  1464. package/src/plugins/cache-transform.ts +0 -199
  1465. package/src/plugins/dynamic-transform.ts +0 -161
  1466. package/src/plugins/server-action-exports.ts +0 -220
  1467. package/src/routing/status-file-lint.ts +0 -112
  1468. package/src/search-params/analyze.ts +0 -192
  1469. package/src/search-params/builtin-codecs.ts +0 -228
  1470. package/src/search-params/codecs.ts +0 -153
  1471. package/src/search-params/create.ts +0 -321
  1472. package/src/search-params/registry.ts +0 -31
  1473. package/src/server/asset-headers.ts +0 -81
  1474. package/src/server/client-module-map.ts +0 -58
  1475. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1476. package/src/server/dev-span-processor.ts +0 -78
  1477. package/src/server/dev-warnings.ts +0 -283
  1478. package/src/server/flush.ts +0 -182
  1479. package/src/server/form-flash.ts +0 -89
  1480. package/src/server/manifest-status-resolver.ts +0 -215
  1481. package/src/server/prerender.ts +0 -139
  1482. package/src/server/tree-builder.ts +0 -382
  1483. package/src/shims/server-only-noop.js +0 -6
  1484. package/src/utils/directive-parser.ts +0 -529
package/src/index.ts CHANGED
@@ -1,371 +1,410 @@
1
+ /**
2
+ * @timber-js/app — Root entry point (public API).
3
+ *
4
+ * User-facing exports: timber(), defineConfig(), TimberUserConfig, Routes.
5
+ *
6
+ * Internal helpers (PluginContext, resolveAppDir, loadTimberConfigFile,
7
+ * warnConfigConflicts, resolveClientJavascript) live in plugin-context.ts
8
+ * and are NOT re-exported here. Sub-plugins import them via relative paths.
9
+ *
10
+ * Design doc: 18-build-system.md §"Plugin Architecture"
11
+ */
12
+
1
13
  import type { Plugin, PluginOption } from 'vite';
2
- import { existsSync } from 'node:fs';
3
- import { join } from 'node:path';
4
- import { pathToFileURL } from 'node:url';
14
+ import type { ReactCompilerOptions } from '@vitejs/plugin-react';
15
+ import { createLogger } from 'vite';
16
+ import { join, relative, resolve } from 'node:path';
5
17
  import { createRequire } from 'node:module';
6
18
  import react from '@vitejs/plugin-react';
7
- import { cacheTransformPlugin } from './plugins/cache-transform';
8
- import { timberContent } from './plugins/content';
9
- import { timberDevServer } from './plugins/dev-server';
10
- import { timberEntries } from './plugins/entries';
11
- import { timberMdx } from './plugins/mdx';
12
- import { timberRouting } from './plugins/routing';
13
- import { timberShims } from './plugins/shims';
14
- import { timberFonts } from './plugins/fonts';
15
- import { timberStaticBuild } from './plugins/static-build';
16
- import { timberDynamicTransform } from './plugins/dynamic-transform';
17
- import { timberServerActionExports } from './plugins/server-action-exports';
18
- import { timberBuildManifest } from './plugins/build-manifest';
19
- import { timberDevLogs } from './plugins/dev-logs';
20
- import { timberReactProd } from './plugins/react-prod';
21
- import { timberChunks } from './plugins/chunks';
22
- import { timberServerBundle } from './plugins/server-bundle';
23
- import { timberAdapterBuild } from './plugins/adapter-build';
24
- import { timberBuildReport } from './plugins/build-report';
25
- import type { RouteTree } from './routing/types';
26
- import type { BuildManifest } from './server/build-manifest';
27
- import type { StartupTimer } from './utils/startup-timer';
28
- import { createStartupTimer, createNoopTimer } from './utils/startup-timer';
29
-
30
- /** Configuration for client-side JavaScript output. */
31
- export interface ClientJavascriptConfig {
32
- /** When true, no client JS bundles are emitted or referenced in HTML. */
33
- disabled: boolean;
34
- /**
35
- * When `disabled` is true, still inject the Vite HMR client in dev mode
36
- * so hot reloading works during development. Default: true.
37
- */
38
- enableHMRInDev?: boolean;
39
- }
19
+ import { timberContent } from './plugins/content.ts';
20
+ import { timberDevServer } from './plugins/dev-server.ts';
21
+ import { timberEntries, BROWSER_ENTRY_FILE } from './plugins/entries.ts';
22
+ import { timberMdx } from './plugins/mdx.ts';
23
+ import { timberRouting } from './plugins/routing.ts';
24
+ import { timberShims } from './plugins/shims.ts';
25
+ import { timberFonts } from './plugins/fonts.ts';
26
+ import { timberStaticBuild } from './plugins/static-build.ts';
27
+ import { timberBuildManifest } from './plugins/build-manifest.ts';
28
+ import { timberDevLogs, originalConsole, wrapLoggerWithOriginalConsole } from './dev-tools/logs.ts';
29
+ import { resolveForwardConsole } from './dev-tools/browser-logs.ts';
30
+ import { timberReactProd } from './plugins/react-prod.ts';
31
+ import { timberReactResolve } from './plugins/react-resolve.ts';
32
+ import { timberChunks } from './plugins/chunks.ts';
33
+ import { clientChunkGroup } from './plugins/client-chunks.ts';
34
+ import { timberServerBundle } from './plugins/server-bundle.ts';
35
+ import { timberEncryptionRuntime } from './plugins/encryption-runtime.ts';
36
+ import { timberCacheTransform } from './plugins/cache.ts';
37
+ import { timberRequestDep } from './plugins/request-dep/index.ts';
38
+ import { timberPrebuilt } from './plugins/prebuilt.ts';
39
+ import { timberPrerenderSugar } from './plugins/prerender-sugar.ts';
40
+ import { timberCloudflareWasm } from './plugins/cloudflare-wasm.ts';
41
+ import { timberPostBuild } from './plugins/post-build.ts';
42
+ import { timberBuildReport } from './plugins/build-report.ts';
43
+ import { createNoopTimer } from './utils/startup-timer.ts';
44
+ import {
45
+ validateConfig,
46
+ reportConfigErrors,
47
+ checkPeerDependencies,
48
+ formatMissingPeers,
49
+ } from './config-validation.ts';
50
+ import {
51
+ resolveEncryptionKeyExpression,
52
+ shouldEnableEncryption,
53
+ } from './server/action-encryption.ts';
54
+ import { createHoldingServer } from './dev-tools/holding-server.ts';
55
+ import { resolveStartPort } from './server/port-resolution.ts';
56
+ import type { TimberUserConfig } from './config-types.ts';
57
+ import type { PluginContext, TimberPluginApi } from './plugin-context.ts';
58
+ import {
59
+ createPluginContext,
60
+ loadTimberConfigFile,
61
+ mergeFileConfig,
62
+ resolveAppDir,
63
+ resolveClientJavascript,
64
+ resolveBuildDir,
65
+ } from './plugin-context.ts';
40
66
 
41
- /** Fully resolved client JavaScript configuration (no optionals). */
42
- export interface ResolvedClientJavascript {
43
- disabled: boolean;
44
- enableHMRInDev: boolean;
45
- }
67
+ // ── Public API ────────────────────────────────────────────────────────────
46
68
 
47
- export interface TimberUserConfig {
48
- output?: 'server' | 'static';
49
- /**
50
- * Enable timber debug logging in production builds.
51
- *
52
- * When `true`, timber's own diagnostics (dev warnings, verbose logging)
53
- * are active even in production mode. React stays in production mode —
54
- * only timber's logs are affected.
55
- *
56
- * Can also be enabled at runtime via the `TIMBER_DEBUG` environment variable.
57
- *
58
- * Default: `false`.
59
- */
60
- debug?: boolean;
61
- /**
62
- * Control client-side JavaScript output.
63
- *
64
- * Boolean shorthand:
65
- * `clientJavascript: false` disables all client JS (equivalent to `{ disabled: true }`).
66
- * `clientJavascript: true` enables client JS (the default).
67
- *
68
- * Object form:
69
- * `clientJavascript: { disabled: true, enableHMRInDev: true }` disables client JS
70
- * in production but preserves Vite HMR in dev mode.
71
- *
72
- * When `disabled` is true, `enableHMRInDev` defaults to `true`.
73
- * Server-side JS still runs — this only affects what is sent to the browser.
74
- */
75
- clientJavascript?: boolean | ClientJavascriptConfig;
76
- adapter?: unknown;
77
- cacheHandler?: unknown;
78
- allowedOrigins?: string[];
79
- csrf?: boolean;
80
- limits?: {
81
- actionBodySize?: string;
82
- uploadBodySize?: string;
83
- maxFields?: number;
84
- };
85
- pageExtensions?: string[];
86
- /**
87
- * Slow request threshold in milliseconds. Requests exceeding this emit
88
- * a warning via the logger. Set to 0 to disable. Default: 3000.
89
- *
90
- * See design/17-logging.md §"slowRequestMs".
91
- */
92
- slowRequestMs?: number;
93
- /** Dev-mode options. These have no effect in production builds. */
94
- dev?: {
95
- /** Threshold in ms to highlight slow phases in dev logging output. Default: 200. */
96
- slowPhaseMs?: number;
97
- };
98
- /**
99
- * Cookie signing configuration. See design/29-cookies.md §"Signed Cookies".
100
- *
101
- * Provide `secret` for a single key, or `secrets` (array) for key rotation.
102
- * When `secrets` is used, index 0 is the signing key; all are tried for verification.
103
- */
104
- cookies?: {
105
- /** Single signing secret. Shorthand for `secrets: [secret]`. */
106
- secret?: string;
107
- /** Array of signing secrets for key rotation. Index 0 signs; all verify. */
108
- secrets?: string[];
109
- };
110
- /**
111
- * Control Server-Timing header output.
112
- *
113
- * - `'detailed'` — per-phase breakdown (proxy, middleware, render). Useful
114
- * for APM / network monitoring. Exposes phase names to clients.
115
- * - `'total'` — single `total;dur=N` entry. Safe to expose, gives
116
- * browser DevTools useful timing without internal details.
117
- * - `false` — no Server-Timing header at all.
118
- *
119
- * Default: `'detailed'` in dev, `'total'` in production.
120
- *
121
- * This is separate from `debug` / `TIMBER_DEBUG` — it's an intentional
122
- * decision to expose timing data to clients, not a side effect of debug
123
- * logging.
124
- */
125
- serverTiming?: 'detailed' | 'total' | false;
126
- /**
127
- * Override the app directory location. By default, timber auto-detects
128
- * `app/` at the project root, falling back to `src/app/`.
129
- *
130
- * Set this to a relative path from the project root (e.g. `'src/app'`)
131
- * to use a custom location.
132
- */
133
- appDir?: string;
134
- /** MDX compilation options passed to @mdx-js/rollup. See design/20-content-collections.md. */
135
- mdx?: {
136
- remarkPlugins?: unknown[];
137
- rehypePlugins?: unknown[];
138
- recmaPlugins?: unknown[];
139
- remarkRehypeOptions?: Record<string, unknown>;
140
- };
141
- /**
142
- * Built-in top-loader progress bar for client navigations.
143
- * Shows an animated bar at the top of the viewport during RSC navigations.
144
- * Enabled by default — set `enabled: false` to opt out.
145
- *
146
- * Users who want a fully custom progress indicator should disable this
147
- * and use `useNavigationPending()` directly.
148
- *
149
- * See LOCAL-336 for design decisions.
150
- */
151
- topLoader?: {
152
- /** Whether the top-loader is enabled. Default: true. */
153
- enabled?: boolean;
154
- /** Bar color. Default: '#2299DD'. */
155
- color?: string;
156
- /** Bar height in pixels. Default: 3. */
157
- height?: number;
158
- /** Show subtle glow/shadow effect. Default: true. */
159
- shadow?: boolean;
160
- /** Delay in ms before showing the bar (avoids flash on fast navs). Default: 0. */
161
- delay?: number;
162
- /** CSS z-index. Default: 1600. */
163
- zIndex?: number;
164
- };
165
- }
69
+ export type { TimberUserConfig } from './config-types.ts';
70
+
71
+ // Metadata route handler types — re-exported so user-authored metadata
72
+ // route files (sitemap.ts, robots.ts, manifest.ts, icon.tsx, etc.) can
73
+ // import them from the package root without reaching into ./server.
74
+ // The canonical location for these types is '@timber-js/app/server'; this
75
+ // root re-export is a convenience for typed metadata route handlers.
76
+ // See design/16-metadata.md §"Metadata Routes".
77
+ export type { Metadata, MetadataRoute, MetadataHandler, MetadataResult } from './server/types.ts';
166
78
 
167
79
  /**
168
- * Resolve `clientJavascript` into a fully resolved config.
80
+ * Route map interface — augmented by the generated timber-routes.d.ts.
81
+ *
82
+ * Each key is a route path pattern. Values have:
83
+ * segmentParams: shape of URL segment params (e.g. { id: string })
84
+ *
85
+ * There is no `searchParams` member: since TIM-1343 the framework does not
86
+ * scan for search-param definitions, so it has nothing to type them with. A
87
+ * definition carries its own type to call sites through an ordinary import.
88
+ *
89
+ * This interface is empty by default and populated via codegen.
90
+ * See design/09-typescript.md §"Typed Routes".
169
91
  */
170
- export function resolveClientJavascript(config: TimberUserConfig): ResolvedClientJavascript {
171
- if (config.clientJavascript !== undefined) {
172
- if (typeof config.clientJavascript === 'boolean') {
173
- // `clientJavascript: false` → disabled
174
- // `clientJavascript: true` → enabled (default)
175
- return {
176
- disabled: !config.clientJavascript,
177
- enableHMRInDev: !config.clientJavascript, // default true when disabled
178
- };
179
- }
180
- // Object form
181
- return {
182
- disabled: config.clientJavascript.disabled,
183
- enableHMRInDev: config.clientJavascript.enableHMRInDev ?? config.clientJavascript.disabled,
184
- };
185
- }
186
-
187
- // Default: client JS enabled
188
- return { disabled: false, enableHMRInDev: false };
189
- }
92
+ // eslint-disable-next-line @typescript-eslint/no-empty-object-type, typescript/no-empty-interface
93
+ export interface Routes {}
190
94
 
191
95
  /**
192
- * Shared context object passed to all sub-plugins via closure.
96
+ * Type-safe helper for timber.config.ts files.
97
+ *
98
+ * A pass-through identity function that provides autocomplete and
99
+ * type checking for timber configuration. No runtime validation —
100
+ * purely a DX convenience (same pattern as Vite's defineConfig).
101
+ *
102
+ * @example
103
+ * ```ts
104
+ * // timber.config.ts
105
+ * import { defineConfig } from '@timber-js/app';
193
106
  *
194
- * Sub-plugins communicate through this context — not through Vite's
195
- * plugin API or global state.
196
- * See design/18-build-system.md §"Shared Plugin Context".
107
+ * export default defineConfig({
108
+ * output: 'server',
109
+ * pageExtensions: ['tsx', 'ts', 'mdx'],
110
+ * });
111
+ * ```
197
112
  */
198
- export interface PluginContext {
199
- config: TimberUserConfig;
200
- /** Resolved client JavaScript configuration */
201
- clientJavascript: ResolvedClientJavascript;
202
- /** The scanned route tree (populated by timber-routing, consumed by timber-entries) */
203
- routeTree: RouteTree | null;
204
- /** Absolute path to the app/ directory */
205
- appDir: string;
206
- /** Absolute path to the project root */
207
- root: string;
208
- /** Whether the dev server is running (set by timber-root-sync in configResolved) */
209
- dev: boolean;
210
- /** CSS build manifest (populated by adapter after client build, null in dev) */
211
- buildManifest: BuildManifest | null;
212
- /** Startup timer for profiling cold start phases (active in dev, no-op in prod) */
213
- timer: StartupTimer;
113
+ export function defineConfig(config: TimberUserConfig): TimberUserConfig {
114
+ return config;
214
115
  }
215
116
 
117
+ // ── Private helpers ───────────────────────────────────────────────────────
118
+
216
119
  /**
217
- * Resolve the app directory. Checks (in order):
218
- * 1. Explicit `configAppDir` from timber.config.ts
219
- * 2. `<root>/app`
220
- * 3. `<root>/src/app`
120
+ * Build the options object for @vitejs/plugin-rsc.
221
121
  *
222
- * Throws if none exist.
122
+ * Uses a getter for `enableActionEncryption` so the RSC plugin reads
123
+ * the value lazily — after ctx.dev is set in configResolved. This lets
124
+ * `actionEncryption.disableInDev` work correctly even though the RSC
125
+ * plugin is created before Vite resolves the command.
223
126
  */
224
- export function resolveAppDir(root: string, configAppDir?: string): string {
225
- if (configAppDir) {
226
- const explicit = join(root, configAppDir);
227
- if (!existsSync(explicit)) {
228
- throw new Error(`[timber] Configured appDir "${configAppDir}" does not exist at ${explicit}`);
229
- }
230
- return explicit;
231
- }
127
+ function createRscOptions(
128
+ ctx: PluginContext,
129
+ encryptionKeyExpr: string | undefined
130
+ ): Record<string, unknown> {
131
+ const options: Record<string, unknown> = {
132
+ serverHandler: false,
133
+ customClientEntry: true,
134
+ entries: {
135
+ rsc: 'virtual:timber-rsc-entry',
136
+ ssr: 'virtual:timber-ssr-entry',
137
+ client: 'virtual:timber-browser-entry',
138
+ },
139
+ // Group client references by layout boundary to balance route-scoped code
140
+ // splitting with HTTP request count. A constant group name ('client-refs')
141
+ // would collapse all routes into one chunk — any page downloads every
142
+ // client component. Per-serverChunk grouping creates many sub-500B files.
143
+ // Layout-boundary grouping is the middle ground: components under the same
144
+ // layout segment share a chunk. See design/27-chunking-strategy.md, TIM-440, TIM-499.
145
+ clientChunks: (meta: { id: string; normalizedId: string; serverChunk: string }) =>
146
+ clientChunkGroup(meta, ctx.appDir, ctx.root, ctx.sharedModuleFacades),
147
+ };
232
148
 
233
- const rootApp = join(root, 'app');
234
- if (existsSync(rootApp)) return rootApp;
149
+ // Bound args encryption — AES-256-GCM authenticated encryption for
150
+ // closure variables in 'use server' functions. Always on in production,
151
+ // configurable in dev. See design/08-forms-and-actions.md §"Bound Args Encryption".
152
+ //
153
+ // Uses a getter so the RSC plugin reads the value lazily in its transform
154
+ // hooks, after ctx.dev is set in configResolved. This lets disableInDev
155
+ // work correctly — ctx.dev is false at construction time but true during
156
+ // dev server transforms.
157
+ Object.defineProperty(options, 'enableActionEncryption', {
158
+ get() {
159
+ return shouldEnableEncryption(ctx.dev, ctx.config.actionEncryption);
160
+ },
161
+ enumerable: true,
162
+ });
235
163
 
236
- const srcApp = join(root, 'src', 'app');
237
- if (existsSync(srcApp)) return srcApp;
164
+ // When TIMBER_ACTIONS_ENCRYPTION_KEY is set, pass it as a runtime expression
165
+ // so the RSC plugin uses it instead of auto-generating a per-build key.
166
+ if (encryptionKeyExpr) {
167
+ options.defineEncryptionKey = encryptionKeyExpr;
168
+ }
238
169
 
239
- throw new Error(
240
- `[timber] Could not find app directory. Expected "app/" or "src/app/" in ${root}. ` +
241
- `You can set appDir in timber.config.ts to specify a custom location.`
242
- );
170
+ return options;
243
171
  }
244
172
 
245
- function createPluginContext(config?: TimberUserConfig, root?: string): PluginContext {
246
- const projectRoot = root ?? process.cwd();
247
- const resolvedConfig: TimberUserConfig = { output: 'server', ...config };
248
- // Timer starts as active — swapped to noop in configResolved for production builds
249
- return {
250
- config: resolvedConfig,
251
- clientJavascript: resolveClientJavascript(resolvedConfig),
252
- routeTree: null,
253
- appDir: join(projectRoot, 'app'),
254
- root: projectRoot,
255
- dev: false,
256
- buildManifest: null,
257
- timer: createStartupTimer(),
258
- };
259
- }
173
+ // NOTE: 'use cache' directive transform removed — future feature pending design doc.
174
+ // The timber.cache() API (createCache) remains available for explicit caching.
175
+ // See design/06-caching.md.
260
176
 
261
- /**
262
- * Load timber.config.ts (or .js, .mjs) from the project root.
263
- * Returns the config object or null if no config file is found.
264
- */
265
- async function loadTimberConfigFile(root: string): Promise<TimberUserConfig | null> {
266
- const configNames = ['timber.config.ts', 'timber.config.js', 'timber.config.mjs'];
267
-
268
- for (const name of configNames) {
269
- const configPath = join(root, name);
270
- if (existsSync(configPath)) {
271
- const mod = await import(pathToFileURL(configPath).href);
272
- return (mod.default ?? mod) as TimberUserConfig;
273
- }
274
- }
275
- return null;
276
- }
177
+ // ── Main plugin factory ──────────────────────────────────────────────────
277
178
 
278
179
  /**
279
- * Detect config keys set in both inline (vite.config.ts) and file (timber.config.ts)
280
- * and warn the user. The `output` key is excluded because it defaults to 'server'
281
- * in createPluginContext and would always appear as an inline key.
180
+ * Create the timber Vite plugin array.
181
+ *
182
+ * Loads timber.config.ts and all dependencies synchronously before
183
+ * constructing the plugin array. This ensures ALL plugins — including
184
+ * the RSC plugin and React Compiler — see the fully merged config
185
+ * (inline + file-based). No async, no deferred config, no stale reads.
282
186
  *
283
- * Returns the list of conflicting key names (for testing).
187
+ * Requires Node >= 22.12 for synchronous require() of ESM modules
188
+ * (@vitejs/plugin-rsc is ESM-only).
189
+ *
190
+ * Previous versions used async loading and deferred config merging,
191
+ * causing file-based config for reactCompiler, actionEncryption, and
192
+ * output mode to be silently ignored. See TIM-451.
284
193
  */
285
- export function warnConfigConflicts(
286
- inline: TimberUserConfig,
287
- fileConfig: TimberUserConfig
288
- ): string[] {
289
- const conflicts: string[] = [];
290
- for (const key of Object.keys(fileConfig) as (keyof TimberUserConfig)[]) {
291
- if (key === 'output') continue;
292
- if (key in inline && inline[key] !== undefined) {
293
- conflicts.push(key);
294
- }
295
- }
296
- if (conflicts.length > 0) {
297
- console.warn(
298
- `[timber] Config conflict: ${conflicts.map((k) => `"${k}"`).join(', ')} set in both ` +
299
- `vite.config.ts (inline) and timber.config.ts. ` +
300
- `Move all config to timber.config.ts to avoid confusion. ` +
301
- `The inline value from vite.config.ts will be used.`
302
- );
303
- }
304
- return conflicts;
305
- }
306
-
307
194
  /**
308
- * Merge file-based config into ctx.config. Inline config (already in ctx.config)
309
- * takes precedence — file config only fills in missing fields.
195
+ * Wrap plugin-react's `vite:react-compiler` configResolved so it always
196
+ * sees `isProduction: true` during builds. The compiler plugin uses
197
+ * `!config.isProduction` to decide whether to emit jsxDEV calls, but
198
+ * Vite derives isProduction from process.env.NODE_ENV — which may be
199
+ * "development" in the shell. Rather than mutating the env, we pass a
200
+ * prototype-based view with the single property overridden.
310
201
  */
311
- function mergeFileConfig(ctx: PluginContext, fileConfig: TimberUserConfig): void {
312
- const inline = ctx.config;
313
-
314
- // Warn if the same key is set in both places
315
- warnConfigConflicts(inline, fileConfig);
316
-
317
- // For each top-level key, use inline value if present, otherwise file value
318
- ctx.config = {
319
- ...fileConfig,
320
- ...inline,
321
- // Deep merge for nested objects where both exist
322
- ...(fileConfig.limits && inline.limits
323
- ? { limits: { ...fileConfig.limits, ...inline.limits } }
324
- : {}),
325
- ...(fileConfig.dev && inline.dev ? { dev: { ...fileConfig.dev, ...inline.dev } } : {}),
326
- ...(fileConfig.mdx && inline.mdx ? { mdx: { ...fileConfig.mdx, ...inline.mdx } } : {}),
327
- };
328
- }
329
-
330
- function timberCache(_ctx: PluginContext): Plugin {
331
- return cacheTransformPlugin();
202
+ function patchReactCompilerForProdJsx(plugins: PluginOption[]): PluginOption[] {
203
+ for (const p of plugins) {
204
+ if (p && typeof p === 'object' && 'name' in p && p.name === 'vite:react-compiler') {
205
+ const orig = (p as Plugin).configResolved;
206
+ if (typeof orig === 'function') {
207
+ (p as Plugin).configResolved = function (config) {
208
+ const view =
209
+ config.command === 'build' && !config.isProduction
210
+ ? Object.create(config, { isProduction: { value: true } })
211
+ : config;
212
+ return orig.call(this, view);
213
+ };
214
+ }
215
+ }
216
+ }
217
+ return plugins;
332
218
  }
333
219
 
334
220
  export function timber(config?: TimberUserConfig): PluginOption[] {
335
221
  const ctx = createPluginContext(config);
336
- // Sync ctx.root and ctx.appDir with Vite's resolved root, which may
337
- // differ from process.cwd() when --config points to a subdirectory.
338
- // Also loads timber.config.ts and merges it into ctx.config (inline config wins).
222
+
223
+ // Resolve dependencies from the consumer's project (process.cwd()),
224
+ // not from timber's own node_modules. This is critical for pnpm link:
225
+ // when linked, timber's node_modules has a separate vite instance, and
226
+ // the RSC plugin must use the same vite instance as the dev server.
227
+ const consumerRequire = createRequire(join(process.cwd(), 'package.json'));
228
+
229
+ // ── Step 1: Load @vitejs/plugin-rsc ─────────────────────────────────
230
+ // Synchronous require() works for ESM modules on Node 22.12+.
231
+ ctx.timer.start('rsc-plugin-import');
232
+ const rscMod = consumerRequire('@vitejs/plugin-rsc');
233
+ const vitePluginRsc = rscMod.default ?? rscMod;
234
+ ctx.timer.end('rsc-plugin-import');
235
+
236
+ // ── Step 2: Compute config-dependent options ────────────────────────
237
+ // encryptionKeyExpr is env-based and doesn't depend on file config.
238
+ const encryptionKeyExpr = resolveEncryptionKeyExpression();
239
+
240
+ // ── Step 3: Pre-load file config for plugin resolution ──────────────
241
+ // Load timber.config.ts eagerly from process.cwd() so we can resolve
242
+ // plugins (like React Compiler) and add them to the top-level array.
243
+ // Vite's config() hook return type is Omit<UserConfig, 'plugins'> —
244
+ // plugins returned from config() are silently ignored. See TIM-632.
245
+ //
246
+ // The config() hook still loads from the correct Vite root (which may
247
+ // differ from cwd in monorepo setups — see TIM-498), but only for
248
+ // non-plugin config merging.
249
+ const earlyFileConfig = loadTimberConfigFile(process.cwd());
250
+
251
+ // ── Step 4: Build rootSync plugin ───────────────────────────────────
252
+
253
+ // rootSync loads timber.config.ts from Vite's resolved root and merges
254
+ // it into ctx.config. Plugin resolution is handled eagerly above — the
255
+ // config() hook must NOT return a `plugins` field (Vite ignores it).
339
256
  const rootSync: Plugin = {
340
257
  name: 'timber-root-sync',
341
- async config(userConfig, { command }) {
342
- // Load timber.config.ts early — before configResolved/buildStart — so
343
- // all plugins (including timber-mdx) see the merged config in their
344
- // buildStart hooks. The config hook runs once and supports async.
345
- const root = userConfig.root ?? process.cwd();
258
+
259
+ // The plugin context, published for out-of-band callers that need the
260
+ // *resolved* configuration rather than a second reading of the files it
261
+ // came from. `timber check` is the one today: it runs Vite's
262
+ // `resolveConfig()` and reads root, appDir, and pageExtensions from here,
263
+ // so it scans exactly the tree `timber build` builds — including config
264
+ // passed inline as `timber({ ... })`, which lives only in this closure and
265
+ // is invisible to anything that re-reads `timber.config.ts`. See
266
+ // `cli-check.ts` and design/11-platform.md §`timber check`.
267
+ //
268
+ // Valid from `configResolved` onward; `appDir` and `root` are unset before
269
+ // that, which is why the reader runs a full `resolveConfig()` rather than
270
+ // just loading the config file.
271
+ api: { getContext: () => ctx } satisfies TimberPluginApi,
272
+
273
+ async config(userConfig, { command, isPreview }) {
274
+ // `vite preview` serves Vite's build.outDir as static files, and timber
275
+ // sets that to the whole build directory (below): the rsc/ and ssr/
276
+ // server bundles, with no root index.html in either output mode. Refuse
277
+ // it rather than expose the server code. `timber preview` resolves the
278
+ // project under `build`, so it never lands here. TIM-1565, design/25.
279
+ if (isPreview) {
280
+ throw new Error(
281
+ '[timber] `vite preview` cannot serve a timber build: it would serve the build ' +
282
+ 'directory, server bundles included, as static files. Run `timber preview`, ' +
283
+ "which runs your adapter's preview()."
284
+ );
285
+ }
286
+
287
+ // ── Load timber.config.ts from the correct root ───────────────
288
+ // Vite's `config` hook fires before `configResolved`. The user's
289
+ // `root` option (if set) tells us where the project lives.
290
+ // `resolve()` mirrors Vite's own root resolution logic.
291
+ const viteRoot = resolve(userConfig.root ?? process.cwd());
346
292
  ctx.timer.start('config-load');
347
- const fileConfig = await loadTimberConfigFile(root);
293
+ const fileConfig = loadTimberConfigFile(viteRoot);
348
294
  if (fileConfig) {
349
- mergeFileConfig(ctx, fileConfig);
295
+ ctx.config = mergeFileConfig(ctx.config, fileConfig);
350
296
  ctx.clientJavascript = resolveClientJavascript(ctx.config);
351
297
  }
298
+ // Apply defaults AFTER merge so file-based config isn't overridden
299
+ // by defaults that were baked into the inline config object.
300
+ ctx.config.output ??= 'server';
352
301
  ctx.timer.end('config-load');
353
302
 
354
- // Force production JSX transform for builds.
303
+ // ── Resolve build output directory ─────────────────────────
304
+ // Priority: timber.config.ts `buildDir` > Vite `build.outDir` > .timber/dist
305
+ // Set Vite's build.outDir so the RSC plugin and all environment
306
+ // builds write to the correct location. ctx.buildDir is read back
307
+ // from Vite in configResolved, so there is one answer to where the
308
+ // build went.
309
+ const resolvedRoot = resolve(userConfig.root ?? process.cwd());
310
+ const buildDir = resolveBuildDir(resolvedRoot, ctx.config.buildDir, userConfig.build?.outDir);
311
+
312
+ // Warn if the Vite root differs from cwd and the re-loaded config
313
+ // has reactCompiler but the early cwd-based load missed it. In this
314
+ // edge case the user must move reactCompiler to inline config.
315
+ if (viteRoot !== process.cwd()) {
316
+ const hasCompilerInReloaded = !config?.reactCompiler && ctx.config.reactCompiler;
317
+ const hadCompilerInEarly = !config?.reactCompiler && earlyFileConfig?.reactCompiler;
318
+ if (hasCompilerInReloaded && !hadCompilerInEarly) {
319
+ console.warn(
320
+ '[timber] reactCompiler is set in timber.config.ts but could not be ' +
321
+ 'registered because the config file is in a non-cwd root directory. ' +
322
+ 'Move reactCompiler to the inline timber() config in vite.config.ts, or ' +
323
+ 'run vite from the project root directory.'
324
+ );
325
+ }
326
+ }
327
+
328
+ // Force production JSX for builds.
355
329
  //
356
- // Vite determines dev vs prod JSX via `isProduction`, which checks
357
- // `process.env.NODE_ENV === 'production'`. If the shell has
358
- // NODE_ENV=development (common in dev toolchains), `vite build`
359
- // respects that and emits jsxDEV calls with fileName/lineNumber
360
- // args. This causes runtime crashes because the production React
361
- // jsx-runtime doesn't export jsxDEV, and also leaks file paths
362
- // into production bundles (security concern).
330
+ // Vite derives `config.isProduction` from `process.env.NODE_ENV`.
331
+ // If the shell has NODE_ENV=development, isProduction stays false
332
+ // and Vite's built-in OXC transform emits jsxDEV calls (the
333
+ // production jsx-runtime doesn't export jsxDEV). The oxc.jsx
334
+ // override below fixes Vite's native path; plugin-react's compiler
335
+ // plugin is handled by patchReactCompilerForProdJsx above.
336
+ // ── Resolve dev port (TIM-842) ───────────────────────────────
337
+ // Default port is 3000. Vite handles conflicts and honors server.strictPort.
338
+ // We start the holding server on the requested port when available.
363
339
  //
364
- // We explicitly set `oxc.jsx.development: false` for builds so
365
- // the client bundle always uses jsx/jsxs from react/jsx-runtime,
366
- // regardless of the ambient NODE_ENV value.
340
+ // See design/21-dev-server.md §"Default Port and Auto-Bump".
341
+ let resolvedDevPort: number | null = null;
342
+ // Middleware-mode embeddings (the analyze crawl, custom servers)
343
+ // never bind a port, and the dev-server plugin's listen() handoff
344
+ // that closes the holding server never runs — starting it would
345
+ // occupy the default port for the embedding's lifetime.
346
+ const isMiddlewareMode = Boolean(userConfig.server?.middlewareMode);
347
+ // Resolve the host Vite will bind so the holding server probes the
348
+ // same address. Vite defaults to 'localhost' when server.host is
349
+ // unset; binding wildcard (no host) would mask conflicts on
350
+ // localhost due to SO_REUSEADDR address-family differences. TIM-1419.
351
+ const resolvedHost =
352
+ typeof userConfig.server?.host === 'string'
353
+ ? userConfig.server.host
354
+ : userConfig.server?.host === true
355
+ ? undefined
356
+ : 'localhost';
357
+ if (command === 'serve' && !isMiddlewareMode) {
358
+ // Vite owns port selection and remembers its bound port on restart.
359
+ // Never forward a probed/bumped port: replacement config runs while
360
+ // the old listener still owns the port. The holding page is optional.
361
+ resolvedDevPort = resolveStartPort({
362
+ configPort: userConfig.server?.port,
363
+ envPort: process.env.PORT,
364
+ });
365
+ if (resolvedDevPort !== 0) {
366
+ ctx.holdingServer = createHoldingServer();
367
+ await ctx.holdingServer.listen(resolvedDevPort, resolvedHost).catch(() => {
368
+ ctx.holdingServer = null;
369
+ });
370
+ }
371
+ }
372
+
373
+ // Derive relative buildOutDir from the absolute buildDir (set above)
374
+ // so Vite's config receives a root-relative path.
375
+ const buildOutDir = relative(resolvedRoot, buildDir);
376
+
377
+ // Set per-environment build.outDir so Vite's RSC plugin writes
378
+ // each environment to the correct subdirectory under our buildDir.
379
+ // Without this, the RSC plugin defaults to dist/<envName> instead
380
+ // of <buildOutDir>/<envName>.
381
+ const envOutDirs: Record<string, { build: { outDir: string } }> = {};
382
+ for (const envName of ['rsc', 'ssr', 'client']) {
383
+ envOutDirs[envName] = { build: { outDir: join(buildOutDir, envName) } };
384
+ }
385
+
386
+ // Exclude @timber-js/app packages from the dep optimizer.
387
+ // The shims plugin intercepts @timber-js/app/* imports per-environment
388
+ // (e.g. replacing @timber-js/app/server with a stub in the client env).
389
+ // The dep optimizer runs before per-environment resolution, so it would
390
+ // pre-bundle @timber-js/app/cookies with the real server code inlined,
391
+ // pulling AsyncLocalStorage into the browser bundle.
392
+ const timberOptimizeDepsExclude = [
393
+ '@timber-js/app',
394
+ '@timber-js/app/server',
395
+ '@timber-js/app/client',
396
+ '@timber-js/app/cookies',
397
+ '@timber-js/app/cache',
398
+ '@timber-js/app/search-params',
399
+ '@timber-js/app/params',
400
+ '@timber-js/app/codec',
401
+ ];
402
+
367
403
  if (command === 'build') {
368
404
  return {
405
+ build: { outDir: buildOutDir },
406
+ environments: envOutDirs,
407
+ optimizeDeps: { exclude: timberOptimizeDepsExclude },
369
408
  oxc: {
370
409
  jsx: {
371
410
  development: false,
@@ -373,11 +412,96 @@ export function timber(config?: TimberUserConfig): PluginOption[] {
373
412
  },
374
413
  };
375
414
  }
415
+
416
+ // Dev mode: set outDir so dev-time references are consistent, and
417
+ // surface the resolved port to Vite.
418
+ //
419
+ // Dev auto-bumps unless the user sets server.strictPort.
420
+ // Always forward the requested port so Vite can recognize unchanged
421
+ // config and reuse its actual bound port across restarts (TIM-1456).
422
+ const serverConfig: {
423
+ port?: number;
424
+ strictPort?: boolean;
425
+ forwardConsole?: boolean | { unhandledErrors?: boolean; logLevels?: string[] };
426
+ } = {};
427
+ if (resolvedDevPort != null) {
428
+ serverConfig.port = resolvedDevPort;
429
+ serverConfig.strictPort = userConfig.server?.strictPort ?? false;
430
+ }
431
+
432
+ // Enable Vite 8's built-in browser→terminal console forwarding.
433
+ // Vite defaults this OFF for non-agent dev; timber enables it based
434
+ // on the devBrowserLogs config (default: 'warn'). See TIM-1152.
435
+ serverConfig.forwardConsole = resolveForwardConsole(ctx.config.devBrowserLogs);
436
+
437
+ // Provide a customLogger whose output routes through the pre-patched
438
+ // console methods so Vite's forwardConsole output never re-enters our
439
+ // server→browser patch. If the user supplied their own customLogger,
440
+ // wrap it so its console calls also bypass patching.
441
+ const customLogger = userConfig.customLogger
442
+ ? wrapLoggerWithOriginalConsole(userConfig.customLogger)
443
+ : createLogger(userConfig.logLevel ?? 'info', {
444
+ allowClearScreen: userConfig.clearScreen ?? true,
445
+ console: originalConsole as Console,
446
+ });
447
+
448
+ // Seed the client optimizer's startup crawl with every 'use client'
449
+ // file so client-only packages are pre-bundled before the first
450
+ // request, not discovered mid-load (which full-reloads the page).
451
+ // Vite concatenates these with any entries the user sets. The scan
452
+ // plugin keeps that crawl out of 'use server' modules, whose imports
453
+ // the browser never loads; Vite's mergeConfig concatenates it with any
454
+ // user or plugin-rsc rolldownOptions.plugins rather than replacing them. Its per-file
455
+ // cost lands inside Vite's own scan, not in client-deps-scan.
456
+ // See design/21-dev-server.md §"Client Dependency Pre-Bundling".
457
+ ctx.timer.start('client-deps-scan');
458
+ // Loaded lazily: directive detection pulls in @vitejs/plugin-rsc's
459
+ // transforms, which builds never need.
460
+ const { clientOptimizeDepsEntries, skipUseServerScanPlugin } =
461
+ await import('./plugins/client-dep-entries.ts');
462
+ const entries = await clientOptimizeDepsEntries(resolvedRoot, BROWSER_ENTRY_FILE, buildDir);
463
+ ctx.timer.end('client-deps-scan');
464
+
465
+ return {
466
+ build: { outDir: buildOutDir },
467
+ environments: {
468
+ ...envOutDirs,
469
+ client: {
470
+ ...envOutDirs.client,
471
+ optimizeDeps: {
472
+ entries,
473
+ rolldownOptions: { plugins: [skipUseServerScanPlugin()] },
474
+ },
475
+ },
476
+ },
477
+ optimizeDeps: { exclude: timberOptimizeDepsExclude },
478
+ customLogger,
479
+ server: serverConfig,
480
+ };
376
481
  },
377
482
  configResolved(resolved) {
378
483
  ctx.root = resolved.root;
379
484
  ctx.appDir = resolveAppDir(resolved.root, ctx.config.appDir);
380
485
  ctx.dev = resolved.command === 'serve';
486
+ // Vite's resolved base — the deployment path prefix. Captured once
487
+ // here so every sub-plugin that emits a URL (assets, fonts, RSC
488
+ // payloads) reads the same value. See TIM-1261.
489
+ ctx.base = resolved.base;
490
+
491
+ // timber.config.* files are NOT registered as configFileDependencies.
492
+ // Vite's in-process restart cannot bust Node's require cache for ESM
493
+ // modules loaded via require(), so the restarted server would serve
494
+ // stale config. Instead, timber-dev-server watches these files and
495
+ // calls process.exit(RESTART_EXIT_CODE) so the CLI supervisor
496
+ // respawns a fresh process. See TIM-1444.
497
+ // The watcher.add() call in dev-server.ts ensures the files are
498
+ // watched even if created after server start.
499
+
500
+ // The build directory is what Vite resolved build.outDir to — the
501
+ // config hook's value after every other plugin and the user config had
502
+ // their say. Vite keeps outDir as-is (may be relative), so resolve
503
+ // against root.
504
+ ctx.buildDir = resolve(resolved.root, resolved.build.outDir);
381
505
  // In production builds, swap to a no-op timer to avoid overhead
382
506
  if (!ctx.dev) {
383
507
  ctx.timer = createNoopTimer();
@@ -385,19 +509,33 @@ export function timber(config?: TimberUserConfig): PluginOption[] {
385
509
  // Start the overall dev server setup timer — ends in timber-dev-server
386
510
  ctx.timer.start('dev-server-setup');
387
511
  }
512
+
513
+ // Validate config and check peer dependencies at startup. Most errors
514
+ // are logged and don't block startup; fatal ones (a security setting
515
+ // that would not mean what it says) stop it. See reportConfigErrors.
516
+ reportConfigErrors(validateConfig(ctx.config));
517
+
518
+ const peerResults = checkPeerDependencies(ctx.root);
519
+ const peerWarning = formatMissingPeers(peerResults);
520
+ if (peerWarning) {
521
+ process.stderr.write(`${peerWarning}\n\n`);
522
+ }
388
523
  },
389
524
  };
525
+
526
+ // ── Step 5: Resolve React Compiler config ───────────────────────────
527
+ // Inline config takes precedence. File config (from the early cwd-based
528
+ // load) is used when inline config doesn't set reactCompiler.
529
+ // Default: true — oxc-transform-react is a direct dependency.
530
+ const effectiveReactCompiler = config?.reactCompiler ?? earlyFileConfig?.reactCompiler ?? true;
531
+
532
+ // ── Step 6: Assemble plugin array ─────────────────────────────────────
390
533
  // @vitejs/plugin-rsc handles:
391
534
  // - RSC/SSR/client environment setup
392
535
  // - "use client" directive → client reference proxy transformation
393
536
  // - "use server" directive → server reference transformation
394
537
  // - Client reference tracking and module map generation
395
538
  //
396
- // Loaded via dynamic import() because @vitejs/plugin-rsc is ESM-only.
397
- // Vite's config loader uses esbuild to transpile to CJS, which breaks
398
- // static imports of ESM-only packages. The dynamic import() is preserved
399
- // by esbuild and runs natively in ESM at runtime.
400
- //
401
539
  // serverHandler: false — timber has its own dev server (timber-dev-server)
402
540
  // entries — tells the RSC plugin about timber's virtual entry modules so
403
541
  // it correctly wires up the browser entry (needed for React Fast Refresh
@@ -410,75 +548,49 @@ export function timber(config?: TimberUserConfig): PluginOption[] {
410
548
  // We do NOT set customBuildApp — the RSC plugin's orchestration is correct
411
549
  // and handles bundle ordering, asset manifest generation, and environment
412
550
  // imports manifest. See @vitejs/plugin-rsc's buildApp implementation.
413
- // Resolve @vitejs/plugin-rsc from the consumer's project (process.cwd()),
414
- // not from timber's own node_modules. This is critical for pnpm link:
415
- // when linked, timber's node_modules has a separate vite instance, and
416
- // the RSC plugin must use the same vite instance as the dev server.
417
- const consumerRequire = createRequire(join(process.cwd(), 'package.json'));
418
- const rscPluginPath = consumerRequire.resolve('@vitejs/plugin-rsc');
419
- ctx.timer.start('rsc-plugin-import');
420
- const rscPluginsPromise = import(pathToFileURL(rscPluginPath).href).then(
421
- ({ default: vitePluginRsc }) => {
422
- ctx.timer.end('rsc-plugin-import');
423
- return vitePluginRsc({
424
- serverHandler: false,
425
- customClientEntry: true,
426
- entries: {
427
- rsc: 'virtual:timber-rsc-entry',
428
- ssr: 'virtual:timber-ssr-entry',
429
- client: 'virtual:timber-browser-entry',
430
- },
431
- // Group all client reference wrappers into a single chunk instead of
432
- // creating one tiny file per "use client" module. Without this, each
433
- // server chunk's client references become a separate entry point,
434
- // producing many sub-500B wrapper files (e.g., 30-byte re-exports).
435
- // A single group eliminates 10+ unnecessary HTTP requests.
436
- // See design/27-chunking-strategy.md and TIM-440.
437
- clientChunks: () => 'client-refs',
438
- });
439
- }
440
- );
441
-
551
+ //
552
+ // Everything after it runs in timber-post-build, in the order that plugin
553
+ // states. The plugins that own a post-build step expose it as their `api`
554
+ // and are handed to it here, so no step's order depends on where a plugin
555
+ // sits in this array. See design/18-build-system.md §"Post-Build Phase".
556
+ const fonts = timberFonts(ctx);
557
+ const prebuilt = timberPrebuilt(ctx);
558
+ const buildReport = timberBuildReport(ctx);
442
559
  return [
443
560
  rootSync,
561
+ timberReactResolve(),
444
562
  timberReactProd(),
445
563
  // @vitejs/plugin-react provides React Fast Refresh (state-preserving HMR)
446
564
  // for client components via Babel transform. Placed before @vitejs/plugin-rsc
447
565
  // following Vinext's convention — the RSC plugin's virtual browser entry
448
566
  // coordinates with plugin-react via __vite_plugin_react_preamble_installed__.
449
- react(),
450
- timberServerActionExports(),
451
- rscPluginsPromise,
567
+ ...patchReactCompilerForProdJsx(
568
+ react({
569
+ compiler: (effectiveReactCompiler || false) as boolean | ReactCompilerOptions,
570
+ })
571
+ ),
572
+ vitePluginRsc(createRscOptions(ctx, encryptionKeyExpr)),
573
+ timberEncryptionRuntime(), // plugin-rsc's bound-args encryption → renderFlight
452
574
  timberShims(ctx),
453
575
  timberRouting(ctx),
454
576
  timberEntries(ctx),
455
577
  timberBuildManifest(ctx),
456
- timberCache(ctx),
457
- timberStaticBuild(ctx),
458
- timberDynamicTransform(ctx),
459
- timberFonts(ctx),
578
+ fonts,
460
579
  timberMdx(ctx),
580
+ timberRequestDep(ctx),
581
+ timberCacheTransform(ctx),
582
+ timberPrerenderSugar(ctx), // export const prerender → cache.component() desugaring
583
+ prebuilt, // cache.component() → __prebuilt() callsite rewrite
584
+ timberStaticBuild(ctx), // Static mode: validate dynamic API usage
461
585
  timberContent(ctx),
462
586
  timberServerBundle(), // Bundle all deps in server environments for prod
463
- timberChunks(),
464
- timberBuildReport(ctx), // Post-build: route table with bundle sizes
465
- timberAdapterBuild(ctx), // Post-build: invoke adapter.buildOutput()
587
+ timberCloudflareWasm(ctx), // Externalize WASM for Cloudflare Workers
588
+ timberChunks(ctx),
589
+ buildReport, // Route table with bundle sizes, printed by timber-post-build
590
+ timberPostBuild(ctx, { fonts: fonts.api, prebuilt: prebuilt.api, report: buildReport.api }),
466
591
  timberDevLogs(ctx), // Dev-only: forward server console.* to browser console
467
592
  timberDevServer(ctx), // Must be last — configureServer post-hook runs after all watchers
468
593
  ];
469
594
  }
470
595
 
471
- /**
472
- * Route map interface — augmented by the generated timber-routes.d.ts.
473
- *
474
- * Each key is a route path pattern. Values have:
475
- * params: shape of URL params (e.g. { id: string })
476
- * searchParams: parsed type from search-params.ts, or {} if none
477
- *
478
- * This interface is empty by default and populated via codegen.
479
- * See design/09-typescript.md §"Typed Routes".
480
- */
481
- // eslint-disable-next-line @typescript-eslint/no-empty-object-type
482
- export interface Routes {}
483
-
484
596
  export default timber;