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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1470) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BwkmAYXq.js +1243 -0
  5. package/dist/_chunks/actions-BwkmAYXq.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-LA3sBpUS.js +1182 -0
  17. package/dist/_chunks/cache-api-LA3sBpUS.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-DkytOEG2.js +1 -0
  44. package/dist/_chunks/dev-server-DnODXuNM.js +2056 -0
  45. package/dist/_chunks/dev-server-DnODXuNM.js.map +1 -0
  46. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  47. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  48. package/dist/_chunks/error-boundary-xxxLtXt6.js +1057 -0
  49. package/dist/_chunks/error-boundary-xxxLtXt6.js.map +1 -0
  50. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  51. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  52. package/dist/_chunks/flight-source-node-0dE-t3kq.js +519 -0
  53. package/dist/_chunks/flight-source-node-0dE-t3kq.js.map +1 -0
  54. package/dist/_chunks/format-BKclgVbk.js +14 -0
  55. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  56. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  57. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  58. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  59. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  60. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  61. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  62. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  63. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  64. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  65. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  66. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  67. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  68. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  69. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  70. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  71. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  72. package/dist/_chunks/node-response-Dibufw_b.js +187 -0
  73. package/dist/_chunks/node-response-Dibufw_b.js.map +1 -0
  74. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  75. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  76. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  77. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  78. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  79. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  80. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  81. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  82. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  83. package/dist/_chunks/purge-store-Byr8XOjU.js +14 -0
  84. package/dist/_chunks/purge-store-Byr8XOjU.js.map +1 -0
  85. package/dist/_chunks/render-timeout-DOf_BBcO.js +46 -0
  86. package/dist/_chunks/render-timeout-DOf_BBcO.js.map +1 -0
  87. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  88. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  89. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  90. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  91. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  92. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  93. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  94. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  95. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  96. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  97. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  98. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  99. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  100. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  101. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  102. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  103. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  104. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  105. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  106. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  107. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  108. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  109. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  110. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  111. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  112. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  113. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  114. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  115. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  116. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  117. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  118. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  119. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  120. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  121. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  122. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  123. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  124. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  125. package/dist/adapters/build-output-helper.d.ts +72 -0
  126. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  127. package/dist/adapters/canonicalize-module.d.ts +8 -0
  128. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  129. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  130. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.js +74 -0
  132. package/dist/adapters/cloudflare-dev.js.map +1 -0
  133. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  134. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  136. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  137. package/dist/adapters/cloudflare.d.ts +224 -24
  138. package/dist/adapters/cloudflare.d.ts.map +1 -1
  139. package/dist/adapters/cloudflare.js +1 -188
  140. package/dist/adapters/compress-module.d.ts +25 -4
  141. package/dist/adapters/compress-module.d.ts.map +1 -1
  142. package/dist/adapters/fs-identity.d.ts +63 -0
  143. package/dist/adapters/fs-identity.d.ts.map +1 -0
  144. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  145. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  146. package/dist/adapters/nitro-presets.d.ts +31 -0
  147. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-preview.d.ts +65 -0
  149. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  150. package/dist/adapters/nitro.d.ts +69 -38
  151. package/dist/adapters/nitro.d.ts.map +1 -1
  152. package/dist/adapters/nitro.js +793 -341
  153. package/dist/adapters/nitro.js.map +1 -1
  154. package/dist/adapters/shared.d.ts +67 -0
  155. package/dist/adapters/shared.d.ts.map +1 -0
  156. package/dist/adapters/types.d.ts +124 -16
  157. package/dist/adapters/types.d.ts.map +1 -1
  158. package/dist/adapters/types.js +0 -0
  159. package/dist/analyze/chains.d.ts +124 -0
  160. package/dist/analyze/chains.d.ts.map +1 -0
  161. package/dist/analyze/classify.d.ts +153 -0
  162. package/dist/analyze/classify.d.ts.map +1 -0
  163. package/dist/analyze/crawl-entry.d.ts +17 -0
  164. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.js +314 -0
  166. package/dist/analyze/crawl-entry.js.map +1 -0
  167. package/dist/analyze/crawl.d.ts +134 -0
  168. package/dist/analyze/crawl.d.ts.map +1 -0
  169. package/dist/analyze/graph-cache.d.ts +104 -0
  170. package/dist/analyze/graph-cache.d.ts.map +1 -0
  171. package/dist/analyze/graph-command.d.ts +43 -0
  172. package/dist/analyze/graph-command.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.js +472 -0
  174. package/dist/analyze/graph-command.js.map +1 -0
  175. package/dist/analyze/live-graph.d.ts +81 -0
  176. package/dist/analyze/live-graph.d.ts.map +1 -0
  177. package/dist/analyze/poison-rules.d.ts +72 -0
  178. package/dist/analyze/poison-rules.d.ts.map +1 -0
  179. package/dist/analyze/poison-scan.d.ts +48 -0
  180. package/dist/analyze/poison-scan.d.ts.map +1 -0
  181. package/dist/analyze/scan.d.ts +73 -0
  182. package/dist/analyze/scan.d.ts.map +1 -0
  183. package/dist/cache/cache-api.d.ts +48 -0
  184. package/dist/cache/cache-api.d.ts.map +1 -0
  185. package/dist/cache/fast-hash.d.ts +5 -0
  186. package/dist/cache/fast-hash.d.ts.map +1 -1
  187. package/dist/cache/handler-store.d.ts +33 -0
  188. package/dist/cache/handler-store.d.ts.map +1 -0
  189. package/dist/cache/index.d.ts +32 -9
  190. package/dist/cache/index.d.ts.map +1 -1
  191. package/dist/cache/index.js +3 -326
  192. package/dist/cache/invalidation-epoch.d.ts +43 -0
  193. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  194. package/dist/cache/json-lossy-check.d.ts +11 -0
  195. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  196. package/dist/cache/redis-handler.d.ts +141 -9
  197. package/dist/cache/redis-handler.d.ts.map +1 -1
  198. package/dist/cache/singleflight.d.ts +21 -2
  199. package/dist/cache/singleflight.d.ts.map +1 -1
  200. package/dist/cache/sizeof.d.ts +22 -0
  201. package/dist/cache/sizeof.d.ts.map +1 -0
  202. package/dist/cache/stable-stringify.d.ts +9 -0
  203. package/dist/cache/stable-stringify.d.ts.map +1 -1
  204. package/dist/cache/store.d.ts +53 -0
  205. package/dist/cache/store.d.ts.map +1 -0
  206. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  207. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.js +29 -0
  209. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  210. package/dist/cache/stores/memory.d.ts +42 -0
  211. package/dist/cache/stores/memory.d.ts.map +1 -0
  212. package/dist/cache/stores/memory.js +90 -0
  213. package/dist/cache/stores/memory.js.map +1 -0
  214. package/dist/cache/stores/redis.d.ts +69 -0
  215. package/dist/cache/stores/redis.d.ts.map +1 -0
  216. package/dist/cache/stores/redis.js +35 -0
  217. package/dist/cache/stores/redis.js.map +1 -0
  218. package/dist/cache/stores/vercel.d.ts +36 -0
  219. package/dist/cache/stores/vercel.d.ts.map +1 -0
  220. package/dist/cache/stores/vercel.js +33 -0
  221. package/dist/cache/stores/vercel.js.map +1 -0
  222. package/dist/cache/tag-aware-handler.d.ts +52 -0
  223. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  224. package/dist/cache/timber-cache.d.ts +21 -11
  225. package/dist/cache/timber-cache.d.ts.map +1 -1
  226. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  227. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  228. package/dist/cdn/cloudflare-purge.js +30 -0
  229. package/dist/cdn/cloudflare-purge.js.map +1 -0
  230. package/dist/cdn/fastly-purge.d.ts +25 -0
  231. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  232. package/dist/cdn/fastly-purge.js +33 -0
  233. package/dist/cdn/fastly-purge.js.map +1 -0
  234. package/dist/cdn/headers.d.ts +97 -0
  235. package/dist/cdn/headers.d.ts.map +1 -0
  236. package/dist/cdn/index.d.ts +5 -0
  237. package/dist/cdn/index.d.ts.map +1 -0
  238. package/dist/cdn/index.js +94 -0
  239. package/dist/cdn/index.js.map +1 -0
  240. package/dist/cdn/purge-store.d.ts +23 -0
  241. package/dist/cdn/purge-store.d.ts.map +1 -0
  242. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  243. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.js +35 -0
  245. package/dist/cdn/workers-cache-purge.js.map +1 -0
  246. package/dist/cli-check.d.ts +133 -0
  247. package/dist/cli-check.d.ts.map +1 -0
  248. package/dist/cli-context.d.ts +54 -0
  249. package/dist/cli-context.d.ts.map +1 -0
  250. package/dist/cli-schema-sync.d.ts +59 -0
  251. package/dist/cli-schema-sync.d.ts.map +1 -0
  252. package/dist/cli.d.ts +88 -16
  253. package/dist/cli.d.ts.map +1 -1
  254. package/dist/cli.js +225 -63
  255. package/dist/cli.js.map +1 -1
  256. package/dist/client/browser-dev.d.ts +42 -2
  257. package/dist/client/browser-dev.d.ts.map +1 -1
  258. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  259. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  260. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  261. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  262. package/dist/client/browser-entry/form-state.d.ts +22 -0
  263. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  264. package/dist/client/browser-entry/hmr.d.ts +21 -0
  265. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  267. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  268. package/dist/client/browser-entry/index.d.ts +32 -0
  269. package/dist/client/browser-entry/index.d.ts.map +1 -0
  270. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  271. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  272. package/dist/client/browser-entry/router-init.d.ts +41 -0
  273. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  274. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  275. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  276. package/dist/client/browser-entry/scroll.d.ts +28 -0
  277. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  278. package/dist/client/deny-last-resort.d.ts +29 -0
  279. package/dist/client/deny-last-resort.d.ts.map +1 -0
  280. package/dist/client/error-boundary.d.ts +58 -9
  281. package/dist/client/error-boundary.d.ts.map +1 -1
  282. package/dist/client/error-boundary.js +1 -126
  283. package/dist/client/error-reconstituter.d.ts +55 -0
  284. package/dist/client/error-reconstituter.d.ts.map +1 -0
  285. package/dist/client/form.d.ts +38 -99
  286. package/dist/client/form.d.ts.map +1 -1
  287. package/dist/client/global-context.d.ts +15 -0
  288. package/dist/client/global-context.d.ts.map +1 -0
  289. package/dist/client/history.d.ts +50 -9
  290. package/dist/client/history.d.ts.map +1 -1
  291. package/dist/client/index.d.ts +21 -33
  292. package/dist/client/index.d.ts.map +1 -1
  293. package/dist/client/index.js +432 -1227
  294. package/dist/client/index.js.map +1 -1
  295. package/dist/client/internal.d.ts +20 -0
  296. package/dist/client/internal.d.ts.map +1 -0
  297. package/dist/client/internal.js +808 -0
  298. package/dist/client/internal.js.map +1 -0
  299. package/dist/client/link.d.ts +85 -60
  300. package/dist/client/link.d.ts.map +1 -1
  301. package/dist/client/location-search.d.ts +12 -0
  302. package/dist/client/location-search.d.ts.map +1 -0
  303. package/dist/client/navigation-api.d.ts +95 -0
  304. package/dist/client/navigation-api.d.ts.map +1 -0
  305. package/dist/client/navigation-commit.d.ts +111 -0
  306. package/dist/client/navigation-commit.d.ts.map +1 -0
  307. package/dist/client/navigation-context.d.ts +54 -36
  308. package/dist/client/navigation-context.d.ts.map +1 -1
  309. package/dist/client/navigation-root.d.ts +106 -0
  310. package/dist/client/navigation-root.d.ts.map +1 -0
  311. package/dist/client/navigation-transition.d.ts +201 -0
  312. package/dist/client/navigation-transition.d.ts.map +1 -0
  313. package/dist/client/nuqs-adapter.d.ts +1 -1
  314. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  315. package/dist/client/params-context.d.ts +81 -0
  316. package/dist/client/params-context.d.ts.map +1 -0
  317. package/dist/client/react-root.d.ts +51 -0
  318. package/dist/client/react-root.d.ts.map +1 -0
  319. package/dist/client/router-effects.d.ts +199 -0
  320. package/dist/client/router-effects.d.ts.map +1 -0
  321. package/dist/client/router-lifecycle.d.ts +104 -0
  322. package/dist/client/router-lifecycle.d.ts.map +1 -0
  323. package/dist/client/router-pipeline.d.ts +85 -0
  324. package/dist/client/router-pipeline.d.ts.map +1 -0
  325. package/dist/client/router-ref.d.ts +2 -2
  326. package/dist/client/router-ref.d.ts.map +1 -1
  327. package/dist/client/router-skew.d.ts +21 -0
  328. package/dist/client/router-skew.d.ts.map +1 -0
  329. package/dist/client/router-types.d.ts +314 -0
  330. package/dist/client/router-types.d.ts.map +1 -0
  331. package/dist/client/router-url.d.ts +24 -0
  332. package/dist/client/router-url.d.ts.map +1 -0
  333. package/dist/client/router.d.ts +1 -97
  334. package/dist/client/router.d.ts.map +1 -1
  335. package/dist/client/rsc-fetch.d.ts +110 -28
  336. package/dist/client/rsc-fetch.d.ts.map +1 -1
  337. package/dist/client/segment-cache.d.ts +186 -25
  338. package/dist/client/segment-cache.d.ts.map +1 -1
  339. package/dist/client/segment-context.d.ts.map +1 -1
  340. package/dist/client/segment-outlet.d.ts +68 -0
  341. package/dist/client/segment-outlet.d.ts.map +1 -0
  342. package/dist/client/segment-update-context.d.ts +15 -0
  343. package/dist/client/segment-update-context.d.ts.map +1 -0
  344. package/dist/client/shallow-url.d.ts +10 -0
  345. package/dist/client/shallow-url.d.ts.map +1 -0
  346. package/dist/client/slot-content-cache-context.d.ts +35 -0
  347. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  348. package/dist/client/slot-context.d.ts +31 -0
  349. package/dist/client/slot-context.d.ts.map +1 -0
  350. package/dist/client/slot-outlet.d.ts +16 -0
  351. package/dist/client/slot-outlet.d.ts.map +1 -0
  352. package/dist/client/slot-provider.d.ts +25 -0
  353. package/dist/client/slot-provider.d.ts.map +1 -0
  354. package/dist/client/ssr-data.d.ts +26 -50
  355. package/dist/client/ssr-data.d.ts.map +1 -1
  356. package/dist/client/stale-client.d.ts +69 -0
  357. package/dist/client/stale-client.d.ts.map +1 -0
  358. package/dist/client/state.d.ts +21 -13
  359. package/dist/client/state.d.ts.map +1 -1
  360. package/dist/client/status-page-marker.d.ts +25 -0
  361. package/dist/client/status-page-marker.d.ts.map +1 -0
  362. package/dist/client/top-loader.d.ts +7 -6
  363. package/dist/client/top-loader.d.ts.map +1 -1
  364. package/dist/client/unload-guard.d.ts +5 -0
  365. package/dist/client/unload-guard.d.ts.map +1 -1
  366. package/dist/client/use-cookie.d.ts +12 -0
  367. package/dist/client/use-cookie.d.ts.map +1 -1
  368. package/dist/client/use-field-state.d.ts +42 -0
  369. package/dist/client/use-field-state.d.ts.map +1 -0
  370. package/dist/client/use-link-status.d.ts +5 -5
  371. package/dist/client/use-link-status.d.ts.map +1 -1
  372. package/dist/client/use-pathname.d.ts +13 -11
  373. package/dist/client/use-pathname.d.ts.map +1 -1
  374. package/dist/client/use-pending-navigation.d.ts +23 -0
  375. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  376. package/dist/client/use-query-states.d.ts +10 -4
  377. package/dist/client/use-query-states.d.ts.map +1 -1
  378. package/dist/client/use-router.d.ts +15 -8
  379. package/dist/client/use-router.d.ts.map +1 -1
  380. package/dist/client/use-search-params.d.ts +15 -8
  381. package/dist/client/use-search-params.d.ts.map +1 -1
  382. package/dist/client/use-segment-params.d.ts +55 -0
  383. package/dist/client/use-segment-params.d.ts.map +1 -0
  384. package/dist/codec.d.ts +69 -0
  385. package/dist/codec.d.ts.map +1 -0
  386. package/dist/codec.js +76 -0
  387. package/dist/codec.js.map +1 -0
  388. package/dist/config-types.d.ts +321 -0
  389. package/dist/config-types.d.ts.map +1 -0
  390. package/dist/config-validation.d.ts +68 -0
  391. package/dist/config-validation.d.ts.map +1 -0
  392. package/dist/cookies/define-cookie.d.ts +58 -25
  393. package/dist/cookies/define-cookie.d.ts.map +1 -1
  394. package/dist/cookies/index.d.ts +3 -2
  395. package/dist/cookies/index.d.ts.map +1 -1
  396. package/dist/cookies/index.js +256 -36
  397. package/dist/cookies/index.js.map +1 -1
  398. package/dist/cookies/json-cookie.d.ts +64 -0
  399. package/dist/cookies/json-cookie.d.ts.map +1 -0
  400. package/dist/cookies/validation.d.ts +34 -0
  401. package/dist/cookies/validation.d.ts.map +1 -0
  402. package/dist/dev-tools/404-page.d.ts +50 -0
  403. package/dist/dev-tools/404-page.d.ts.map +1 -0
  404. package/dist/dev-tools/browser-logs.d.ts +40 -0
  405. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  406. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  407. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  408. package/dist/dev-tools/error-page.d.ts +32 -0
  409. package/dist/dev-tools/error-page.d.ts.map +1 -0
  410. package/dist/dev-tools/holding-server.d.ts +46 -0
  411. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  412. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  413. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  414. package/dist/dev-tools/index.d.ts +31 -0
  415. package/dist/dev-tools/index.d.ts.map +1 -0
  416. package/dist/dev-tools/instrumentation.d.ts +74 -0
  417. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  418. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  419. package/dist/dev-tools/logger.d.ts.map +1 -0
  420. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +17 -3
  421. package/dist/dev-tools/logs.d.ts.map +1 -0
  422. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  423. package/dist/dev-tools/overlay.d.ts.map +1 -0
  424. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  425. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  426. package/dist/dev-tools/terminal.d.ts +28 -0
  427. package/dist/dev-tools/terminal.d.ts.map +1 -0
  428. package/dist/fonts/ast-walk.d.ts +68 -0
  429. package/dist/fonts/ast-walk.d.ts.map +1 -0
  430. package/dist/fonts/ast.d.ts +112 -8
  431. package/dist/fonts/ast.d.ts.map +1 -1
  432. package/dist/fonts/bundle.d.ts +50 -0
  433. package/dist/fonts/bundle.d.ts.map +1 -0
  434. package/dist/fonts/css.d.ts +1 -1
  435. package/dist/fonts/dev-middleware.d.ts +22 -0
  436. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  437. package/dist/fonts/fallbacks.d.ts +0 -7
  438. package/dist/fonts/fallbacks.d.ts.map +1 -1
  439. package/dist/fonts/google.d.ts +5 -3
  440. package/dist/fonts/google.d.ts.map +1 -1
  441. package/dist/fonts/local.d.ts +5 -5
  442. package/dist/fonts/local.d.ts.map +1 -1
  443. package/dist/fonts/paths.d.ts +43 -0
  444. package/dist/fonts/paths.d.ts.map +1 -0
  445. package/dist/fonts/pipeline.d.ts +177 -0
  446. package/dist/fonts/pipeline.d.ts.map +1 -0
  447. package/dist/fonts/transform.d.ts +82 -0
  448. package/dist/fonts/transform.d.ts.map +1 -0
  449. package/dist/fonts/types.d.ts +47 -1
  450. package/dist/fonts/types.d.ts.map +1 -1
  451. package/dist/fonts/virtual-modules.d.ts +77 -0
  452. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  453. package/dist/index.d.ts +35 -181
  454. package/dist/index.d.ts.map +1 -1
  455. package/dist/index.js +8877 -14232
  456. package/dist/index.js.map +1 -1
  457. package/dist/params/codec-registry.d.ts +26 -0
  458. package/dist/params/codec-registry.d.ts.map +1 -0
  459. package/dist/params/define-schema.d.ts +81 -0
  460. package/dist/params/define-schema.d.ts.map +1 -0
  461. package/dist/params/index.d.ts +5 -0
  462. package/dist/params/index.d.ts.map +1 -0
  463. package/dist/params/index.js +34 -0
  464. package/dist/params/index.js.map +1 -0
  465. package/dist/params/resolve-schema.d.ts +34 -0
  466. package/dist/params/resolve-schema.d.ts.map +1 -0
  467. package/dist/plugin-context.d.ts +262 -0
  468. package/dist/plugin-context.d.ts.map +1 -0
  469. package/dist/plugins/build-manifest.d.ts +7 -3
  470. package/dist/plugins/build-manifest.d.ts.map +1 -1
  471. package/dist/plugins/build-report.d.ts +61 -11
  472. package/dist/plugins/build-report.d.ts.map +1 -1
  473. package/dist/plugins/cache.d.ts +64 -0
  474. package/dist/plugins/cache.d.ts.map +1 -0
  475. package/dist/plugins/callsite-ast.d.ts +117 -0
  476. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  477. package/dist/plugins/callsite-jsx.d.ts +35 -0
  478. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  479. package/dist/plugins/chunks.d.ts +11 -4
  480. package/dist/plugins/chunks.d.ts.map +1 -1
  481. package/dist/plugins/client-chunks.d.ts +40 -0
  482. package/dist/plugins/client-chunks.d.ts.map +1 -0
  483. package/dist/plugins/client-dep-entries.d.ts +80 -0
  484. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  485. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  486. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  487. package/dist/plugins/content.d.ts +1 -1
  488. package/dist/plugins/content.d.ts.map +1 -1
  489. package/dist/plugins/dev-discovery.d.ts +123 -0
  490. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  491. package/dist/plugins/dev-server.d.ts +24 -1
  492. package/dist/plugins/dev-server.d.ts.map +1 -1
  493. package/dist/plugins/encryption-runtime.d.ts +13 -0
  494. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  495. package/dist/plugins/entries.d.ts +35 -4
  496. package/dist/plugins/entries.d.ts.map +1 -1
  497. package/dist/plugins/fonts.d.ts +35 -74
  498. package/dist/plugins/fonts.d.ts.map +1 -1
  499. package/dist/plugins/graph-endpoint.d.ts +112 -0
  500. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  501. package/dist/plugins/mdx.d.ts +18 -5
  502. package/dist/plugins/mdx.d.ts.map +1 -1
  503. package/dist/plugins/post-build.d.ts +110 -0
  504. package/dist/plugins/post-build.d.ts.map +1 -0
  505. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  506. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  507. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  508. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt.d.ts +98 -0
  510. package/dist/plugins/prebuilt.d.ts.map +1 -0
  511. package/dist/plugins/prerender-sugar.d.ts +39 -0
  512. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  513. package/dist/plugins/react-resolve.d.ts +49 -0
  514. package/dist/plugins/react-resolve.d.ts.map +1 -0
  515. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  516. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  517. package/dist/plugins/request-dep/index.d.ts +75 -0
  518. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/origin.d.ts +61 -0
  520. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  521. package/dist/plugins/routing.d.ts +1 -1
  522. package/dist/plugins/routing.d.ts.map +1 -1
  523. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  524. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  525. package/dist/plugins/server-bundle.d.ts +1 -1
  526. package/dist/plugins/server-bundle.d.ts.map +1 -1
  527. package/dist/plugins/shims.d.ts +29 -5
  528. package/dist/plugins/shims.d.ts.map +1 -1
  529. package/dist/plugins/static-build.d.ts +246 -26
  530. package/dist/plugins/static-build.d.ts.map +1 -1
  531. package/dist/routing/codegen-shared.d.ts +26 -0
  532. package/dist/routing/codegen-shared.d.ts.map +1 -0
  533. package/dist/routing/codegen-types.d.ts +61 -0
  534. package/dist/routing/codegen-types.d.ts.map +1 -0
  535. package/dist/routing/codegen-write.d.ts +42 -0
  536. package/dist/routing/codegen-write.d.ts.map +1 -0
  537. package/dist/routing/codegen.d.ts +8 -3
  538. package/dist/routing/codegen.d.ts.map +1 -1
  539. package/dist/routing/collision-probe.d.ts +104 -0
  540. package/dist/routing/collision-probe.d.ts.map +1 -0
  541. package/dist/routing/collision-spaces.d.ts +26 -0
  542. package/dist/routing/collision-spaces.d.ts.map +1 -0
  543. package/dist/routing/convention-lint.d.ts +55 -0
  544. package/dist/routing/convention-lint.d.ts.map +1 -0
  545. package/dist/routing/export-detect.d.ts +91 -0
  546. package/dist/routing/export-detect.d.ts.map +1 -0
  547. package/dist/routing/file-cache.d.ts +8 -0
  548. package/dist/routing/file-cache.d.ts.map +1 -0
  549. package/dist/routing/index.d.ts +13 -7
  550. package/dist/routing/index.d.ts.map +1 -1
  551. package/dist/routing/index.js +5 -2
  552. package/dist/routing/interception-overlap.d.ts +35 -0
  553. package/dist/routing/interception-overlap.d.ts.map +1 -0
  554. package/dist/routing/interception.d.ts +234 -10
  555. package/dist/routing/interception.d.ts.map +1 -1
  556. package/dist/routing/link-codegen.d.ts +105 -0
  557. package/dist/routing/link-codegen.d.ts.map +1 -0
  558. package/dist/routing/manifest-codegen.d.ts +26 -0
  559. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  560. package/dist/routing/scanner.d.ts +14 -10
  561. package/dist/routing/scanner.d.ts.map +1 -1
  562. package/dist/routing/schema-validation.d.ts +35 -0
  563. package/dist/routing/schema-validation.d.ts.map +1 -0
  564. package/dist/routing/segment-classify.d.ts +114 -0
  565. package/dist/routing/segment-classify.d.ts.map +1 -0
  566. package/dist/routing/segment-codegen.d.ts +38 -0
  567. package/dist/routing/segment-codegen.d.ts.map +1 -0
  568. package/dist/routing/segment-keys.d.ts +118 -0
  569. package/dist/routing/segment-keys.d.ts.map +1 -0
  570. package/dist/routing/slot-placement.d.ts +48 -0
  571. package/dist/routing/slot-placement.d.ts.map +1 -0
  572. package/dist/routing/types.d.ts +81 -26
  573. package/dist/routing/types.d.ts.map +1 -1
  574. package/dist/routing/walkers.d.ts +57 -0
  575. package/dist/routing/walkers.d.ts.map +1 -0
  576. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  577. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  578. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  579. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  580. package/dist/rsc-runtime/rsc.d.ts +6 -2
  581. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  582. package/dist/rsc-runtime/ssr.d.ts +8 -0
  583. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  584. package/dist/rsc-runtime/transforms.d.ts +13 -0
  585. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  586. package/dist/schema-bridge.d.ts +145 -0
  587. package/dist/schema-bridge.d.ts.map +1 -0
  588. package/dist/search-params/define.d.ts +262 -0
  589. package/dist/search-params/define.d.ts.map +1 -0
  590. package/dist/search-params/index.d.ts +3 -7
  591. package/dist/search-params/index.d.ts.map +1 -1
  592. package/dist/search-params/index.js +179 -360
  593. package/dist/search-params/index.js.map +1 -1
  594. package/dist/search-params/parse-total.d.ts +81 -0
  595. package/dist/search-params/parse-total.d.ts.map +1 -0
  596. package/dist/search-params/serialize-equal.d.ts +9 -0
  597. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  598. package/dist/search-params/wrappers.d.ts +76 -0
  599. package/dist/search-params/wrappers.d.ts.map +1 -0
  600. package/dist/server/access-gate.d.ts +98 -10
  601. package/dist/server/access-gate.d.ts.map +1 -1
  602. package/dist/server/action-client.d.ts +20 -133
  603. package/dist/server/action-client.d.ts.map +1 -1
  604. package/dist/server/action-encryption.d.ts +76 -0
  605. package/dist/server/action-encryption.d.ts.map +1 -0
  606. package/dist/server/action-handler.d.ts +58 -11
  607. package/dist/server/action-handler.d.ts.map +1 -1
  608. package/dist/server/action-schema.d.ts +126 -0
  609. package/dist/server/action-schema.d.ts.map +1 -0
  610. package/dist/server/action-types.d.ts +108 -0
  611. package/dist/server/action-types.d.ts.map +1 -0
  612. package/dist/server/actions.d.ts +78 -40
  613. package/dist/server/actions.d.ts.map +1 -1
  614. package/dist/server/als-registry.d.ts +189 -17
  615. package/dist/server/als-registry.d.ts.map +1 -1
  616. package/dist/server/body-limits.d.ts.map +1 -1
  617. package/dist/server/build-manifest.d.ts +25 -30
  618. package/dist/server/build-manifest.d.ts.map +1 -1
  619. package/dist/server/canonicalize.d.ts +32 -0
  620. package/dist/server/canonicalize.d.ts.map +1 -1
  621. package/dist/server/chain-url-parts.d.ts +82 -0
  622. package/dist/server/chain-url-parts.d.ts.map +1 -0
  623. package/dist/server/children-interception.d.ts +49 -0
  624. package/dist/server/children-interception.d.ts.map +1 -0
  625. package/dist/server/client-error-message.d.ts +12 -0
  626. package/dist/server/client-error-message.d.ts.map +1 -0
  627. package/dist/server/coalesce-tick.d.ts +40 -0
  628. package/dist/server/coalesce-tick.d.ts.map +1 -0
  629. package/dist/server/compress.d.ts +2 -0
  630. package/dist/server/compress.d.ts.map +1 -1
  631. package/dist/server/cookie-context.d.ts +149 -0
  632. package/dist/server/cookie-context.d.ts.map +1 -0
  633. package/dist/server/cookie-parsing.d.ts +65 -0
  634. package/dist/server/cookie-parsing.d.ts.map +1 -0
  635. package/dist/server/csp-nonce.d.ts +36 -0
  636. package/dist/server/csp-nonce.d.ts.map +1 -0
  637. package/dist/server/csrf.d.ts +58 -15
  638. package/dist/server/csrf.d.ts.map +1 -1
  639. package/dist/server/debug.d.ts +0 -1
  640. package/dist/server/debug.d.ts.map +1 -1
  641. package/dist/server/default-logger.d.ts +23 -0
  642. package/dist/server/default-logger.d.ts.map +1 -0
  643. package/dist/server/default-status-page.d.ts +45 -0
  644. package/dist/server/default-status-page.d.ts.map +1 -0
  645. package/dist/server/deny-boundary.d.ts +257 -0
  646. package/dist/server/deny-boundary.d.ts.map +1 -0
  647. package/dist/server/deny-renderer.d.ts +22 -15
  648. package/dist/server/deny-renderer.d.ts.map +1 -1
  649. package/dist/server/early-hints-sender.d.ts.map +1 -1
  650. package/dist/server/early-hints.d.ts +14 -12
  651. package/dist/server/early-hints.d.ts.map +1 -1
  652. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  653. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  654. package/dist/server/error-response-headers.d.ts +3 -0
  655. package/dist/server/error-response-headers.d.ts.map +1 -0
  656. package/dist/server/fallback-error.d.ts +19 -7
  657. package/dist/server/fallback-error.d.ts.map +1 -1
  658. package/dist/server/flight-injection-state.d.ts +66 -0
  659. package/dist/server/flight-injection-state.d.ts.map +1 -0
  660. package/dist/server/flight-injector-core.d.ts +125 -0
  661. package/dist/server/flight-injector-core.d.ts.map +1 -0
  662. package/dist/server/flight-scripts.d.ts +63 -0
  663. package/dist/server/flight-scripts.d.ts.map +1 -0
  664. package/dist/server/flight-source-node.d.ts +105 -0
  665. package/dist/server/flight-source-node.d.ts.map +1 -0
  666. package/dist/server/flight-source.d.ts +136 -0
  667. package/dist/server/flight-source.d.ts.map +1 -0
  668. package/dist/server/form-data.d.ts +59 -2
  669. package/dist/server/form-data.d.ts.map +1 -1
  670. package/dist/server/form-state-flight.d.ts +32 -0
  671. package/dist/server/form-state-flight.d.ts.map +1 -0
  672. package/dist/server/head-response.d.ts +35 -0
  673. package/dist/server/head-response.d.ts.map +1 -0
  674. package/dist/server/html-injector-core.d.ts +169 -0
  675. package/dist/server/html-injector-core.d.ts.map +1 -0
  676. package/dist/server/html-injectors.d.ts +77 -47
  677. package/dist/server/html-injectors.d.ts.map +1 -1
  678. package/dist/server/index.d.ts +16 -54
  679. package/dist/server/index.d.ts.map +1 -1
  680. package/dist/server/index.js +638 -3021
  681. package/dist/server/index.js.map +1 -1
  682. package/dist/server/instrumentation.d.ts +11 -4
  683. package/dist/server/instrumentation.d.ts.map +1 -1
  684. package/dist/server/internal.d.ts +47 -0
  685. package/dist/server/internal.d.ts.map +1 -0
  686. package/dist/server/internal.js +4649 -0
  687. package/dist/server/internal.js.map +1 -0
  688. package/dist/server/json-status-response.d.ts +34 -0
  689. package/dist/server/json-status-response.d.ts.map +1 -0
  690. package/dist/server/logger.d.ts +79 -7
  691. package/dist/server/logger.d.ts.map +1 -1
  692. package/dist/server/metadata-collector.d.ts +75 -0
  693. package/dist/server/metadata-collector.d.ts.map +1 -0
  694. package/dist/server/metadata-platform.d.ts +2 -2
  695. package/dist/server/metadata-render.d.ts +2 -2
  696. package/dist/server/metadata-render.d.ts.map +1 -1
  697. package/dist/server/metadata-route-links.d.ts +70 -0
  698. package/dist/server/metadata-route-links.d.ts.map +1 -0
  699. package/dist/server/metadata-routes.d.ts +47 -11
  700. package/dist/server/metadata-routes.d.ts.map +1 -1
  701. package/dist/server/metadata-social.d.ts +2 -2
  702. package/dist/server/metadata.d.ts +10 -2
  703. package/dist/server/metadata.d.ts.map +1 -1
  704. package/dist/server/middleware-runner.d.ts +20 -5
  705. package/dist/server/middleware-runner.d.ts.map +1 -1
  706. package/dist/server/node-body-response.d.ts +55 -0
  707. package/dist/server/node-body-response.d.ts.map +1 -0
  708. package/dist/server/node-response.d.ts +62 -0
  709. package/dist/server/node-response.d.ts.map +1 -0
  710. package/dist/server/node-stream-transforms.d.ts +108 -0
  711. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  712. package/dist/server/node-streams-platform.d.ts +21 -0
  713. package/dist/server/node-streams-platform.d.ts.map +1 -0
  714. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  715. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  716. package/dist/server/param-coercion.d.ts +83 -0
  717. package/dist/server/param-coercion.d.ts.map +1 -0
  718. package/dist/server/pipeline-helpers.d.ts +224 -0
  719. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  720. package/dist/server/pipeline-interception.d.ts +70 -9
  721. package/dist/server/pipeline-interception.d.ts.map +1 -1
  722. package/dist/server/pipeline-metadata.d.ts +16 -1
  723. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  724. package/dist/server/pipeline-outcome.d.ts +59 -0
  725. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  726. package/dist/server/pipeline-phases.d.ts +70 -0
  727. package/dist/server/pipeline-phases.d.ts.map +1 -0
  728. package/dist/server/pipeline.d.ts +161 -23
  729. package/dist/server/pipeline.d.ts.map +1 -1
  730. package/dist/server/port-resolution.d.ts +22 -0
  731. package/dist/server/port-resolution.d.ts.map +1 -0
  732. package/dist/server/prebuilt/cache-key.d.ts +63 -0
  733. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  734. package/dist/server/prebuilt/capture-render.d.ts +25 -0
  735. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  736. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  737. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  738. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  739. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  740. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  741. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  742. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  743. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  744. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  745. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  746. package/dist/server/prebuilt/overlay.d.ts +100 -0
  747. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  748. package/dist/server/prebuilt/payload-source.d.ts +79 -0
  749. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  750. package/dist/server/prebuilt/slots.d.ts +106 -0
  751. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  752. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  753. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  754. package/dist/server/prebuilt-builder.d.ts +121 -0
  755. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  756. package/dist/server/prebuilt-runtime.d.ts +110 -0
  757. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  758. package/dist/server/primitives.d.ts +101 -90
  759. package/dist/server/primitives.d.ts.map +1 -1
  760. package/dist/server/publish-params.d.ts +33 -0
  761. package/dist/server/publish-params.d.ts.map +1 -0
  762. package/dist/server/react-cache-bridge.d.ts +59 -0
  763. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  764. package/dist/server/react-cache-scope.d.ts +49 -0
  765. package/dist/server/react-cache-scope.d.ts.map +1 -0
  766. package/dist/server/render-timeout.d.ts +66 -0
  767. package/dist/server/render-timeout.d.ts.map +1 -0
  768. package/dist/server/render-utils.d.ts +35 -0
  769. package/dist/server/render-utils.d.ts.map +1 -0
  770. package/dist/server/request-context.d.ts +153 -103
  771. package/dist/server/request-context.d.ts.map +1 -1
  772. package/dist/server/request-dep.d.ts +15 -0
  773. package/dist/server/request-dep.d.ts.map +1 -0
  774. package/dist/server/response-cache-policy.d.ts +3 -0
  775. package/dist/server/response-cache-policy.d.ts.map +1 -0
  776. package/dist/server/route-element-builder.d.ts +57 -30
  777. package/dist/server/route-element-builder.d.ts.map +1 -1
  778. package/dist/server/route-element-helpers.d.ts +12 -0
  779. package/dist/server/route-element-helpers.d.ts.map +1 -0
  780. package/dist/server/route-handler.d.ts +1 -1
  781. package/dist/server/route-handler.d.ts.map +1 -1
  782. package/dist/server/route-matcher.d.ts +62 -38
  783. package/dist/server/route-matcher.d.ts.map +1 -1
  784. package/dist/server/route-module-loader.d.ts +37 -0
  785. package/dist/server/route-module-loader.d.ts.map +1 -0
  786. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  787. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  788. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  789. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  790. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  791. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  792. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  793. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  794. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  795. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  796. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  797. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  798. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  799. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  800. package/dist/server/rsc-entry/index.d.ts +30 -6
  801. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  802. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  803. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  804. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  805. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  807. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  808. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  809. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  811. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  813. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  814. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  815. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  816. package/dist/server/rsc-error-envelope.d.ts +11 -0
  817. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  818. package/dist/server/safe-load.d.ts +39 -0
  819. package/dist/server/safe-load.d.ts.map +1 -0
  820. package/dist/server/schema-introspection.d.ts +68 -0
  821. package/dist/server/schema-introspection.d.ts.map +1 -0
  822. package/dist/server/sensitive-fields.d.ts +88 -0
  823. package/dist/server/sensitive-fields.d.ts.map +1 -0
  824. package/dist/server/signal-identity.d.ts +43 -0
  825. package/dist/server/signal-identity.d.ts.map +1 -0
  826. package/dist/server/sitemap-generator.d.ts +130 -0
  827. package/dist/server/sitemap-generator.d.ts.map +1 -0
  828. package/dist/server/sitemap-handler.d.ts +22 -0
  829. package/dist/server/sitemap-handler.d.ts.map +1 -0
  830. package/dist/server/skippable-prefix.d.ts +29 -0
  831. package/dist/server/skippable-prefix.d.ts.map +1 -0
  832. package/dist/server/slot-interception.d.ts +80 -0
  833. package/dist/server/slot-interception.d.ts.map +1 -0
  834. package/dist/server/slot-resolver.d.ts +138 -7
  835. package/dist/server/slot-resolver.d.ts.map +1 -1
  836. package/dist/server/slot-subtree-contain.d.ts +54 -0
  837. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  838. package/dist/server/ssr-bridge-types.d.ts +213 -0
  839. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  840. package/dist/server/ssr-entry.d.ts +15 -51
  841. package/dist/server/ssr-entry.d.ts.map +1 -1
  842. package/dist/server/ssr-form-state.d.ts +30 -0
  843. package/dist/server/ssr-form-state.d.ts.map +1 -0
  844. package/dist/server/ssr-render.d.ts +59 -32
  845. package/dist/server/ssr-render.d.ts.map +1 -1
  846. package/dist/server/ssr-wrappers.d.ts +93 -0
  847. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  848. package/dist/server/state-tree-diff.d.ts +44 -9
  849. package/dist/server/state-tree-diff.d.ts.map +1 -1
  850. package/dist/server/static-generator.d.ts +112 -0
  851. package/dist/server/static-generator.d.ts.map +1 -0
  852. package/dist/server/static-not-found.d.ts +52 -0
  853. package/dist/server/static-not-found.d.ts.map +1 -0
  854. package/dist/server/status-code-resolver.d.ts +26 -15
  855. package/dist/server/status-code-resolver.d.ts.map +1 -1
  856. package/dist/server/stream-utils.d.ts +93 -0
  857. package/dist/server/stream-utils.d.ts.map +1 -0
  858. package/dist/server/tracing.d.ts +57 -26
  859. package/dist/server/tracing.d.ts.map +1 -1
  860. package/dist/server/tree-match.d.ts +59 -0
  861. package/dist/server/tree-match.d.ts.map +1 -0
  862. package/dist/server/types.d.ts +89 -8
  863. package/dist/server/types.d.ts.map +1 -1
  864. package/dist/server/utils/element-type.d.ts +50 -0
  865. package/dist/server/utils/element-type.d.ts.map +1 -0
  866. package/dist/server/utils/escape-html.d.ts +14 -0
  867. package/dist/server/utils/escape-html.d.ts.map +1 -0
  868. package/dist/server/version-skew.d.ts +61 -0
  869. package/dist/server/version-skew.d.ts.map +1 -0
  870. package/dist/server/workers-cache-bridge.d.ts +26 -0
  871. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  872. package/dist/shared/als-slots.d.ts +42 -0
  873. package/dist/shared/als-slots.d.ts.map +1 -0
  874. package/dist/shared/base-path.d.ts +56 -0
  875. package/dist/shared/base-path.d.ts.map +1 -0
  876. package/dist/shared/csrf-reject.d.ts +16 -0
  877. package/dist/shared/csrf-reject.d.ts.map +1 -0
  878. package/dist/shared/error-digest.d.ts +28 -0
  879. package/dist/shared/error-digest.d.ts.map +1 -0
  880. package/dist/shared/flight-base64.d.ts +13 -0
  881. package/dist/shared/flight-base64.d.ts.map +1 -0
  882. package/dist/shared/flight-segment.d.ts +18 -0
  883. package/dist/shared/flight-segment.d.ts.map +1 -0
  884. package/dist/shared/form-state-flight.d.ts +32 -0
  885. package/dist/shared/form-state-flight.d.ts.map +1 -0
  886. package/dist/shared/href-validation.d.ts +49 -0
  887. package/dist/shared/href-validation.d.ts.map +1 -0
  888. package/dist/shared/merge-search-params.d.ts +22 -0
  889. package/dist/shared/merge-search-params.d.ts.map +1 -0
  890. package/dist/shared/param-value.d.ts +104 -0
  891. package/dist/shared/param-value.d.ts.map +1 -0
  892. package/dist/shared/payload-root.d.ts +110 -0
  893. package/dist/shared/payload-root.d.ts.map +1 -0
  894. package/dist/shared/redirect-type.d.ts +17 -0
  895. package/dist/shared/redirect-type.d.ts.map +1 -0
  896. package/dist/shared/rsc-cache-key.d.ts +163 -0
  897. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  898. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  899. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  900. package/dist/shared/rsc-manifest.d.ts +28 -0
  901. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  902. package/dist/shared/rsc-media-type.d.ts +52 -0
  903. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  904. package/dist/shared/rsc-payload-path.d.ts +48 -0
  905. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  906. package/dist/shared/segment-info.d.ts +66 -0
  907. package/dist/shared/segment-info.d.ts.map +1 -0
  908. package/dist/shared/slot-params.d.ts +52 -0
  909. package/dist/shared/slot-params.d.ts.map +1 -0
  910. package/dist/shared/static-platform-files.d.ts +71 -0
  911. package/dist/shared/static-platform-files.d.ts.map +1 -0
  912. package/dist/shared/status-reason-phrase.d.ts +26 -0
  913. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  914. package/dist/shims/font-google.d.ts +1 -1
  915. package/dist/shims/font-google.d.ts.map +1 -1
  916. package/dist/shims/font-google.js +42 -0
  917. package/dist/shims/font-google.js.map +1 -0
  918. package/dist/shims/font-local.d.ts +26 -0
  919. package/dist/shims/font-local.d.ts.map +1 -0
  920. package/dist/shims/font-local.js +20 -0
  921. package/dist/shims/font-local.js.map +1 -0
  922. package/dist/shims/headers.d.ts +53 -1
  923. package/dist/shims/headers.d.ts.map +1 -1
  924. package/dist/shims/image.d.ts +120 -120
  925. package/dist/shims/image.d.ts.map +1 -1
  926. package/dist/shims/navigation-client.d.ts +25 -12
  927. package/dist/shims/navigation-client.d.ts.map +1 -1
  928. package/dist/shims/navigation-rsc.d.ts +21 -0
  929. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  930. package/dist/shims/navigation.d.ts +10 -5
  931. package/dist/shims/navigation.d.ts.map +1 -1
  932. package/dist/utils/state-machine.d.ts +80 -0
  933. package/dist/utils/state-machine.d.ts.map +1 -0
  934. package/dist/utils/write-file-atomic.d.ts +17 -0
  935. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  936. package/docs/api/30-api-server.mdx +239 -0
  937. package/docs/api/31-api-client.mdx +199 -0
  938. package/docs/api/32-api-cache.mdx +339 -0
  939. package/docs/api/33-api-search-params.mdx +176 -0
  940. package/docs/api/34-api-config.mdx +359 -0
  941. package/docs/api/35-api-typescript.mdx +91 -0
  942. package/docs/api/36-cli.mdx +206 -0
  943. package/docs/learn/00-introduction.mdx +109 -0
  944. package/docs/learn/01-quick-start.mdx +94 -0
  945. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  946. package/docs/learn/03-fetching-data.mdx +227 -0
  947. package/docs/learn/04-access-control.mdx +115 -0
  948. package/docs/learn/05-the-flush-point.mdx +175 -0
  949. package/docs/learn/06-typed-params.mdx +275 -0
  950. package/docs/learn/07-typed-routes.mdx +108 -0
  951. package/docs/learn/08-forms-and-actions.mdx +260 -0
  952. package/docs/learn/09-streaming.mdx +140 -0
  953. package/docs/learn/10-caching.mdx +270 -0
  954. package/docs/learn/11-middleware.mdx +164 -0
  955. package/docs/learn/12-error-handling.mdx +192 -0
  956. package/docs/learn/13-deploying.mdx +289 -0
  957. package/llms.txt +55 -0
  958. package/package.json +120 -29
  959. package/src/adapters/build-output-helper.ts +353 -0
  960. package/src/adapters/canonicalize-module.ts +29 -0
  961. package/src/adapters/cloudflare-dev.ts +183 -0
  962. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  963. package/src/adapters/cloudflare.ts +809 -150
  964. package/src/adapters/compress-module.ts +110 -86
  965. package/src/adapters/fs-identity.ts +155 -0
  966. package/src/adapters/nitro-immutable-assets.ts +142 -0
  967. package/src/adapters/nitro-presets.ts +124 -0
  968. package/src/adapters/nitro-preview.ts +533 -0
  969. package/src/adapters/nitro.ts +331 -445
  970. package/src/adapters/raw-imports.d.ts +5 -0
  971. package/src/adapters/shared.ts +283 -0
  972. package/src/adapters/types.ts +129 -17
  973. package/src/adapters/wrangler.d.ts +7 -0
  974. package/src/analyze/chains.ts +411 -0
  975. package/src/analyze/classify.ts +259 -0
  976. package/src/analyze/crawl-entry.ts +68 -0
  977. package/src/analyze/crawl.ts +500 -0
  978. package/src/analyze/graph-cache.ts +331 -0
  979. package/src/analyze/graph-command.ts +762 -0
  980. package/src/analyze/live-graph.ts +232 -0
  981. package/src/analyze/poison-rules.ts +165 -0
  982. package/src/analyze/poison-scan.ts +159 -0
  983. package/src/analyze/scan.ts +149 -0
  984. package/src/cache/cache-api.ts +107 -0
  985. package/src/cache/fast-hash.ts +5 -0
  986. package/src/cache/handler-store.ts +76 -0
  987. package/src/cache/index.ts +115 -22
  988. package/src/cache/invalidation-epoch.ts +93 -0
  989. package/src/cache/json-lossy-check.ts +69 -0
  990. package/src/cache/redis-handler.ts +198 -20
  991. package/src/cache/singleflight.ts +72 -6
  992. package/src/cache/sizeof.ts +35 -0
  993. package/src/cache/stable-stringify.ts +65 -2
  994. package/src/cache/store.ts +71 -0
  995. package/src/cache/stores/cloudflare-kv.ts +52 -0
  996. package/src/cache/stores/memory.ts +125 -0
  997. package/src/cache/stores/redis.ts +97 -0
  998. package/src/cache/stores/vercel.ts +59 -0
  999. package/src/cache/tag-aware-handler.ts +254 -0
  1000. package/src/cache/timber-cache.ts +165 -40
  1001. package/src/cdn/cloudflare-purge.ts +50 -0
  1002. package/src/cdn/fastly-purge.ts +63 -0
  1003. package/src/cdn/headers.ts +153 -0
  1004. package/src/cdn/index.ts +23 -0
  1005. package/src/cdn/purge-store.ts +34 -0
  1006. package/src/cdn/workers-cache-purge.ts +34 -0
  1007. package/src/cli-check.ts +417 -0
  1008. package/src/cli-context.ts +119 -0
  1009. package/src/cli-schema-sync.ts +401 -0
  1010. package/src/cli.ts +334 -80
  1011. package/src/client/browser-dev.ts +192 -5
  1012. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1013. package/src/client/browser-entry/action-queue.ts +152 -0
  1014. package/src/client/browser-entry/form-state.ts +49 -0
  1015. package/src/client/browser-entry/hmr.ts +70 -0
  1016. package/src/client/browser-entry/hydrate.ts +152 -0
  1017. package/src/client/browser-entry/index.ts +150 -0
  1018. package/src/client/browser-entry/post-hydration.ts +99 -0
  1019. package/src/client/browser-entry/router-init.ts +393 -0
  1020. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1021. package/src/client/browser-entry/scroll.ts +50 -0
  1022. package/src/client/deny-last-resort.tsx +54 -0
  1023. package/src/client/error-boundary.tsx +279 -61
  1024. package/src/client/error-reconstituter.tsx +84 -0
  1025. package/src/client/form.tsx +61 -173
  1026. package/src/client/global-context.ts +31 -0
  1027. package/src/client/history.ts +74 -11
  1028. package/src/client/index.ts +90 -53
  1029. package/src/client/internal.ts +54 -0
  1030. package/src/client/link.tsx +468 -151
  1031. package/src/client/location-search.ts +15 -0
  1032. package/src/client/navigation-api.ts +254 -0
  1033. package/src/client/navigation-commit.ts +318 -0
  1034. package/src/client/navigation-context.ts +67 -134
  1035. package/src/client/navigation-root.tsx +236 -0
  1036. package/src/client/navigation-transition.ts +348 -0
  1037. package/src/client/nuqs-adapter.tsx +21 -9
  1038. package/src/client/params-context.ts +187 -0
  1039. package/src/client/react-root.ts +105 -0
  1040. package/src/client/router-effects.ts +324 -0
  1041. package/src/client/router-lifecycle.ts +374 -0
  1042. package/src/client/router-pipeline.ts +456 -0
  1043. package/src/client/router-ref.ts +3 -3
  1044. package/src/client/router-skew.ts +30 -0
  1045. package/src/client/router-types.ts +346 -0
  1046. package/src/client/router-url.ts +32 -0
  1047. package/src/client/router.ts +500 -424
  1048. package/src/client/rsc-fetch.ts +510 -109
  1049. package/src/client/segment-cache.ts +362 -41
  1050. package/src/client/segment-context.ts +7 -4
  1051. package/src/client/segment-outlet.tsx +96 -0
  1052. package/src/client/segment-update-context.ts +23 -0
  1053. package/src/client/shallow-url.ts +22 -0
  1054. package/src/client/slot-content-cache-context.ts +43 -0
  1055. package/src/client/slot-context.ts +50 -0
  1056. package/src/client/slot-outlet.tsx +22 -0
  1057. package/src/client/slot-provider.tsx +32 -0
  1058. package/src/client/ssr-data.ts +27 -67
  1059. package/src/client/stale-client.ts +191 -0
  1060. package/src/client/state.ts +31 -24
  1061. package/src/client/status-page-marker.tsx +32 -0
  1062. package/src/client/top-loader.tsx +13 -10
  1063. package/src/client/unload-guard.ts +35 -3
  1064. package/src/client/use-cookie.ts +70 -18
  1065. package/src/client/use-field-state.ts +144 -0
  1066. package/src/client/use-link-status.ts +7 -7
  1067. package/src/client/use-pathname.ts +22 -31
  1068. package/src/client/use-pending-navigation.ts +40 -0
  1069. package/src/client/use-query-states.ts +206 -36
  1070. package/src/client/use-router.ts +31 -9
  1071. package/src/client/use-search-params.ts +38 -49
  1072. package/src/client/use-segment-params.ts +69 -0
  1073. package/src/client/use-selected-layout-segment.ts +2 -2
  1074. package/src/codec.ts +149 -0
  1075. package/src/config-types.ts +321 -0
  1076. package/src/config-validation.ts +464 -0
  1077. package/src/cookies/define-cookie.ts +222 -53
  1078. package/src/cookies/index.ts +13 -2
  1079. package/src/cookies/json-cookie.ts +105 -0
  1080. package/src/cookies/validation.ts +192 -0
  1081. package/src/dev-tools/404-page.ts +286 -0
  1082. package/src/dev-tools/browser-logs.ts +55 -0
  1083. package/src/dev-tools/dev-page-shell.ts +278 -0
  1084. package/src/dev-tools/error-page.ts +331 -0
  1085. package/src/dev-tools/holding-server.ts +185 -0
  1086. package/src/dev-tools/hydration-overlay.ts +158 -0
  1087. package/src/dev-tools/index.ts +79 -0
  1088. package/src/dev-tools/instrumentation.ts +261 -0
  1089. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1090. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
  1091. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1092. package/src/dev-tools/stack-classifier.ts +75 -0
  1093. package/src/dev-tools/terminal.ts +182 -0
  1094. package/src/fonts/ast-walk.ts +235 -0
  1095. package/src/fonts/ast.ts +479 -128
  1096. package/src/fonts/bundle.ts +138 -0
  1097. package/src/fonts/css.ts +1 -1
  1098. package/src/fonts/dev-middleware.ts +85 -0
  1099. package/src/fonts/fallbacks.ts +0 -23
  1100. package/src/fonts/google.ts +101 -19
  1101. package/src/fonts/local.ts +12 -11
  1102. package/src/fonts/paths.ts +58 -0
  1103. package/src/fonts/pipeline.ts +348 -0
  1104. package/src/fonts/transform.ts +311 -0
  1105. package/src/fonts/types.ts +52 -1
  1106. package/src/fonts/virtual-modules.ts +179 -0
  1107. package/src/index.ts +492 -380
  1108. package/src/params/codec-registry.ts +34 -0
  1109. package/src/params/define-schema.ts +115 -0
  1110. package/src/params/index.ts +17 -0
  1111. package/src/params/resolve-schema.ts +84 -0
  1112. package/src/plugin-context.ts +502 -0
  1113. package/src/plugins/build-manifest.ts +189 -36
  1114. package/src/plugins/build-report.ts +299 -87
  1115. package/src/plugins/cache.ts +243 -0
  1116. package/src/plugins/callsite-ast.ts +472 -0
  1117. package/src/plugins/callsite-jsx.ts +243 -0
  1118. package/src/plugins/chunks.ts +74 -5
  1119. package/src/plugins/client-chunks.ts +185 -0
  1120. package/src/plugins/client-dep-entries.ts +124 -0
  1121. package/src/plugins/cloudflare-wasm.ts +141 -0
  1122. package/src/plugins/content.ts +31 -2
  1123. package/src/plugins/dev-discovery.ts +218 -0
  1124. package/src/plugins/dev-server.ts +360 -97
  1125. package/src/plugins/encryption-runtime.ts +31 -0
  1126. package/src/plugins/entries.ts +150 -17
  1127. package/src/plugins/fonts.ts +260 -657
  1128. package/src/plugins/graph-endpoint.ts +532 -0
  1129. package/src/plugins/mdx.ts +108 -35
  1130. package/src/plugins/post-build.ts +327 -0
  1131. package/src/plugins/prebuilt-capture.ts +213 -0
  1132. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1133. package/src/plugins/prebuilt.ts +670 -0
  1134. package/src/plugins/prerender-sugar.ts +316 -0
  1135. package/src/plugins/react-resolve.ts +149 -0
  1136. package/src/plugins/request-dep/analysis.ts +447 -0
  1137. package/src/plugins/request-dep/index.ts +376 -0
  1138. package/src/plugins/request-dep/origin.ts +310 -0
  1139. package/src/plugins/routing.ts +273 -277
  1140. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1141. package/src/plugins/server-bundle.ts +115 -15
  1142. package/src/plugins/shims.ts +257 -97
  1143. package/src/plugins/static-build.ts +681 -71
  1144. package/src/react-canary.d.ts +2 -0
  1145. package/src/routing/codegen-shared.ts +39 -0
  1146. package/src/routing/codegen-types.ts +62 -0
  1147. package/src/routing/codegen-write.ts +163 -0
  1148. package/src/routing/codegen.ts +349 -232
  1149. package/src/routing/collision-probe.ts +438 -0
  1150. package/src/routing/collision-spaces.ts +281 -0
  1151. package/src/routing/convention-lint.ts +651 -0
  1152. package/src/routing/export-detect.ts +536 -0
  1153. package/src/routing/file-cache.ts +23 -0
  1154. package/src/routing/index.ts +16 -7
  1155. package/src/routing/interception-overlap.ts +141 -0
  1156. package/src/routing/interception.ts +1044 -67
  1157. package/src/routing/link-codegen.ts +280 -0
  1158. package/src/routing/manifest-codegen.ts +232 -0
  1159. package/src/routing/scanner.ts +417 -223
  1160. package/src/routing/schema-validation.ts +155 -0
  1161. package/src/routing/segment-classify.ts +280 -0
  1162. package/src/routing/segment-codegen.ts +99 -0
  1163. package/src/routing/segment-keys.ts +186 -0
  1164. package/src/routing/slot-placement.ts +97 -0
  1165. package/src/routing/types.ts +82 -26
  1166. package/src/routing/walkers.ts +98 -0
  1167. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1168. package/src/rsc-runtime/render-flight.ts +26 -0
  1169. package/src/rsc-runtime/rsc.ts +17 -2
  1170. package/src/rsc-runtime/ssr.ts +13 -0
  1171. package/src/rsc-runtime/transforms.ts +13 -0
  1172. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1173. package/src/schema-bridge.ts +382 -0
  1174. package/src/search-params/define.ts +677 -0
  1175. package/src/search-params/index.ts +14 -20
  1176. package/src/search-params/parse-total.ts +91 -0
  1177. package/src/search-params/serialize-equal.ts +14 -0
  1178. package/src/search-params/wrappers.ts +150 -0
  1179. package/src/server/access-gate.tsx +195 -56
  1180. package/src/server/action-client.ts +175 -294
  1181. package/src/server/action-encryption.ts +144 -0
  1182. package/src/server/action-handler.ts +492 -150
  1183. package/src/server/action-schema.ts +203 -0
  1184. package/src/server/action-types.ts +145 -0
  1185. package/src/server/actions.ts +172 -85
  1186. package/src/server/als-registry.ts +245 -30
  1187. package/src/server/body-limits.ts +10 -2
  1188. package/src/server/build-manifest.ts +33 -57
  1189. package/src/server/canonicalize.ts +35 -3
  1190. package/src/server/chain-url-parts.ts +163 -0
  1191. package/src/server/children-interception.ts +116 -0
  1192. package/src/server/client-error-message.ts +18 -0
  1193. package/src/server/coalesce-tick.ts +75 -0
  1194. package/src/server/compress.ts +91 -19
  1195. package/src/server/cookie-context.ts +454 -0
  1196. package/src/server/cookie-parsing.ts +163 -0
  1197. package/src/server/csp-nonce.ts +58 -0
  1198. package/src/server/csrf.ts +228 -35
  1199. package/src/server/debug.ts +0 -1
  1200. package/src/server/default-logger.ts +100 -0
  1201. package/src/server/default-status-page.ts +88 -0
  1202. package/src/server/deny-boundary.ts +527 -0
  1203. package/src/server/deny-renderer.ts +210 -181
  1204. package/src/server/early-hints-sender.ts +4 -3
  1205. package/src/server/early-hints.ts +39 -29
  1206. package/src/server/error-boundary-wrapper.ts +160 -44
  1207. package/src/server/error-response-headers.ts +18 -0
  1208. package/src/server/fallback-error.ts +88 -104
  1209. package/src/server/flight-injection-state.ts +113 -0
  1210. package/src/server/flight-injector-core.ts +328 -0
  1211. package/src/server/flight-scripts.ts +92 -0
  1212. package/src/server/flight-source-node.ts +430 -0
  1213. package/src/server/flight-source.ts +288 -0
  1214. package/src/server/form-data.ts +191 -20
  1215. package/src/server/form-state-flight.ts +67 -0
  1216. package/src/server/head-response.ts +50 -0
  1217. package/src/server/html-injector-core.ts +320 -0
  1218. package/src/server/html-injectors.ts +241 -285
  1219. package/src/server/index.ts +37 -195
  1220. package/src/server/instrumentation.ts +11 -4
  1221. package/src/server/internal.ts +168 -0
  1222. package/src/server/json-status-response.ts +105 -0
  1223. package/src/server/logger.ts +131 -38
  1224. package/src/server/metadata-collector.ts +175 -0
  1225. package/src/server/metadata-platform.ts +2 -2
  1226. package/src/server/metadata-render.ts +30 -8
  1227. package/src/server/metadata-route-links.ts +200 -0
  1228. package/src/server/metadata-routes.ts +114 -24
  1229. package/src/server/metadata-social.ts +2 -2
  1230. package/src/server/metadata.ts +23 -2
  1231. package/src/server/middleware-runner.ts +32 -5
  1232. package/src/server/node-body-response.ts +236 -0
  1233. package/src/server/node-response.ts +93 -0
  1234. package/src/server/node-stream-transforms.ts +340 -0
  1235. package/src/server/node-streams-platform.ts +23 -0
  1236. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1237. package/src/server/param-coercion.ts +201 -0
  1238. package/src/server/pipeline-helpers.ts +548 -0
  1239. package/src/server/pipeline-interception.ts +241 -32
  1240. package/src/server/pipeline-metadata.ts +25 -1
  1241. package/src/server/pipeline-outcome.ts +290 -0
  1242. package/src/server/pipeline-phases.ts +503 -0
  1243. package/src/server/pipeline.ts +423 -426
  1244. package/src/server/port-resolution.ts +43 -0
  1245. package/src/server/prebuilt/cache-key.ts +299 -0
  1246. package/src/server/prebuilt/capture-render.ts +118 -0
  1247. package/src/server/prebuilt/capture-routes.ts +104 -0
  1248. package/src/server/prebuilt/capture-state.ts +196 -0
  1249. package/src/server/prebuilt/key-discipline.ts +122 -0
  1250. package/src/server/prebuilt/lifetime.ts +151 -0
  1251. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1252. package/src/server/prebuilt/overlay.ts +256 -0
  1253. package/src/server/prebuilt/payload-source.ts +202 -0
  1254. package/src/server/prebuilt/slots.ts +202 -0
  1255. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1256. package/src/server/prebuilt-builder.ts +514 -0
  1257. package/src/server/prebuilt-runtime.ts +810 -0
  1258. package/src/server/primitives.ts +153 -171
  1259. package/src/server/publish-params.ts +42 -0
  1260. package/src/server/react-cache-bridge.ts +124 -0
  1261. package/src/server/react-cache-scope.ts +104 -0
  1262. package/src/server/render-timeout.ts +128 -0
  1263. package/src/server/render-utils.ts +45 -0
  1264. package/src/server/request-context.ts +298 -324
  1265. package/src/server/request-dep.ts +37 -0
  1266. package/src/server/response-cache-policy.ts +45 -0
  1267. package/src/server/route-element-builder.ts +526 -355
  1268. package/src/server/route-element-helpers.ts +37 -0
  1269. package/src/server/route-handler.ts +67 -27
  1270. package/src/server/route-matcher.ts +238 -267
  1271. package/src/server/route-module-loader.ts +161 -0
  1272. package/src/server/rsc-cache-key-guard.ts +122 -0
  1273. package/src/server/rsc-entry/action-dispatcher.ts +144 -0
  1274. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1275. package/src/server/rsc-entry/api-handler.ts +49 -81
  1276. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1277. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1278. package/src/server/rsc-entry/helpers.ts +90 -115
  1279. package/src/server/rsc-entry/index.ts +372 -350
  1280. package/src/server/rsc-entry/render-route.ts +248 -0
  1281. package/src/server/rsc-entry/render-signals.ts +108 -0
  1282. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1283. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1284. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1285. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1286. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1287. package/src/server/rsc-error-envelope.ts +18 -0
  1288. package/src/server/rsc-prop-warnings.ts +1 -1
  1289. package/src/server/safe-load.ts +53 -0
  1290. package/src/server/schema-introspection.ts +393 -0
  1291. package/src/server/sensitive-fields.ts +287 -0
  1292. package/src/server/server-only-guard-noop.js +3 -0
  1293. package/src/server/server-timing.ts +1 -1
  1294. package/src/server/signal-identity.ts +112 -0
  1295. package/src/server/sitemap-generator.ts +337 -0
  1296. package/src/server/sitemap-handler.ts +150 -0
  1297. package/src/server/skippable-prefix.ts +172 -0
  1298. package/src/server/slot-interception.ts +168 -0
  1299. package/src/server/slot-resolver.ts +707 -300
  1300. package/src/server/slot-subtree-contain.ts +273 -0
  1301. package/src/server/ssr-bridge-types.ts +217 -0
  1302. package/src/server/ssr-entry.ts +248 -109
  1303. package/src/server/ssr-form-state.ts +58 -0
  1304. package/src/server/ssr-render.ts +334 -101
  1305. package/src/server/ssr-wrappers.tsx +162 -0
  1306. package/src/server/state-tree-diff.ts +85 -30
  1307. package/src/server/static-generator.ts +680 -0
  1308. package/src/server/static-not-found.ts +134 -0
  1309. package/src/server/status-code-resolver.ts +107 -148
  1310. package/src/server/stream-utils.ts +398 -0
  1311. package/src/server/tracing.ts +163 -68
  1312. package/src/server/tree-match.ts +494 -0
  1313. package/src/server/types.ts +96 -11
  1314. package/src/server/utils/element-type.ts +88 -0
  1315. package/src/server/utils/escape-html.ts +20 -0
  1316. package/src/server/version-skew.ts +104 -0
  1317. package/src/server/waituntil-bridge.ts +1 -1
  1318. package/src/server/workers-cache-bridge.ts +33 -0
  1319. package/src/shared/als-slots.ts +74 -0
  1320. package/src/shared/base-path.ts +80 -0
  1321. package/src/shared/csrf-reject.ts +15 -0
  1322. package/src/shared/error-digest.ts +46 -0
  1323. package/src/shared/flight-base64.ts +23 -0
  1324. package/src/shared/flight-segment.ts +35 -0
  1325. package/src/shared/form-state-flight.ts +59 -0
  1326. package/src/shared/href-validation.ts +159 -0
  1327. package/src/shared/merge-search-params.ts +55 -0
  1328. package/src/shared/param-value.ts +281 -0
  1329. package/src/shared/payload-root.ts +153 -0
  1330. package/src/shared/redirect-type.ts +17 -0
  1331. package/src/shared/rsc-cache-key.ts +269 -0
  1332. package/src/shared/rsc-error-envelope.ts +16 -0
  1333. package/src/shared/rsc-manifest.ts +29 -0
  1334. package/src/shared/rsc-media-type.ts +59 -0
  1335. package/src/shared/rsc-payload-path.ts +52 -0
  1336. package/src/shared/segment-info.ts +67 -0
  1337. package/src/shared/slot-params.ts +109 -0
  1338. package/src/shared/static-platform-files.ts +75 -0
  1339. package/src/shared/status-reason-phrase.ts +61 -0
  1340. package/src/shims/font-google.ts +1 -1
  1341. package/src/shims/font-local.ts +34 -0
  1342. package/src/shims/headers.ts +122 -1
  1343. package/src/shims/navigation-client.ts +36 -32
  1344. package/src/shims/navigation-rsc.ts +47 -0
  1345. package/src/shims/navigation.ts +10 -7
  1346. package/src/utils/state-machine.ts +111 -0
  1347. package/src/utils/write-file-atomic.ts +32 -0
  1348. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1349. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1350. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1351. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1352. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1353. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1354. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1355. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1356. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1357. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1358. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1359. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1360. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1361. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1362. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1363. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1364. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1365. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1366. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1367. package/dist/adapters/cloudflare.js.map +0 -1
  1368. package/dist/cache/index.js.map +0 -1
  1369. package/dist/cache/register-cached-function.d.ts +0 -17
  1370. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1371. package/dist/client/browser-entry.d.ts +0 -21
  1372. package/dist/client/browser-entry.d.ts.map +0 -1
  1373. package/dist/client/error-boundary.js.map +0 -1
  1374. package/dist/client/head.d.ts +0 -16
  1375. package/dist/client/head.d.ts.map +0 -1
  1376. package/dist/client/link-status-provider.d.ts +0 -11
  1377. package/dist/client/link-status-provider.d.ts.map +0 -1
  1378. package/dist/client/segment-merger.d.ts +0 -119
  1379. package/dist/client/segment-merger.d.ts.map +0 -1
  1380. package/dist/client/stale-reload.d.ts +0 -44
  1381. package/dist/client/stale-reload.d.ts.map +0 -1
  1382. package/dist/client/transition-root.d.ts +0 -74
  1383. package/dist/client/transition-root.d.ts.map +0 -1
  1384. package/dist/client/types.d.ts +0 -14
  1385. package/dist/client/types.d.ts.map +0 -1
  1386. package/dist/client/use-navigation-pending.d.ts +0 -26
  1387. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1388. package/dist/client/use-params.d.ts +0 -92
  1389. package/dist/client/use-params.d.ts.map +0 -1
  1390. package/dist/content/index.d.ts +0 -11
  1391. package/dist/content/index.d.ts.map +0 -1
  1392. package/dist/content/index.js +0 -2
  1393. package/dist/plugins/adapter-build.d.ts +0 -18
  1394. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1395. package/dist/plugins/cache-transform.d.ts +0 -36
  1396. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1397. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1398. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1399. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1400. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1401. package/dist/plugins/server-action-exports.d.ts +0 -26
  1402. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1403. package/dist/routing/status-file-lint.d.ts +0 -33
  1404. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1405. package/dist/search-params/analyze.d.ts +0 -54
  1406. package/dist/search-params/analyze.d.ts.map +0 -1
  1407. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1408. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1409. package/dist/search-params/codecs.d.ts +0 -53
  1410. package/dist/search-params/codecs.d.ts.map +0 -1
  1411. package/dist/search-params/create.d.ts +0 -106
  1412. package/dist/search-params/create.d.ts.map +0 -1
  1413. package/dist/search-params/registry.d.ts +0 -20
  1414. package/dist/search-params/registry.d.ts.map +0 -1
  1415. package/dist/server/asset-headers.d.ts +0 -42
  1416. package/dist/server/asset-headers.d.ts.map +0 -1
  1417. package/dist/server/client-module-map.d.ts +0 -47
  1418. package/dist/server/client-module-map.d.ts.map +0 -1
  1419. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1420. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1421. package/dist/server/dev-logger.d.ts.map +0 -1
  1422. package/dist/server/dev-span-processor.d.ts +0 -29
  1423. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1424. package/dist/server/dev-warnings.d.ts +0 -129
  1425. package/dist/server/dev-warnings.d.ts.map +0 -1
  1426. package/dist/server/flush.d.ts +0 -74
  1427. package/dist/server/flush.d.ts.map +0 -1
  1428. package/dist/server/form-flash.d.ts +0 -78
  1429. package/dist/server/form-flash.d.ts.map +0 -1
  1430. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1431. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1432. package/dist/server/prerender.d.ts +0 -77
  1433. package/dist/server/prerender.d.ts.map +0 -1
  1434. package/dist/server/tree-builder.d.ts +0 -126
  1435. package/dist/server/tree-builder.d.ts.map +0 -1
  1436. package/dist/utils/directive-parser.d.ts +0 -70
  1437. package/dist/utils/directive-parser.d.ts.map +0 -1
  1438. package/src/cache/register-cached-function.ts +0 -103
  1439. package/src/client/browser-entry.ts +0 -678
  1440. package/src/client/head.ts +0 -61
  1441. package/src/client/link-status-provider.tsx +0 -30
  1442. package/src/client/segment-merger.ts +0 -339
  1443. package/src/client/stale-reload.ts +0 -87
  1444. package/src/client/transition-root.tsx +0 -166
  1445. package/src/client/types.ts +0 -21
  1446. package/src/client/use-navigation-pending.ts +0 -38
  1447. package/src/client/use-params.ts +0 -141
  1448. package/src/content/index.ts +0 -13
  1449. package/src/plugins/adapter-build.ts +0 -118
  1450. package/src/plugins/cache-transform.ts +0 -199
  1451. package/src/plugins/dynamic-transform.ts +0 -161
  1452. package/src/plugins/server-action-exports.ts +0 -220
  1453. package/src/routing/status-file-lint.ts +0 -112
  1454. package/src/search-params/analyze.ts +0 -192
  1455. package/src/search-params/builtin-codecs.ts +0 -228
  1456. package/src/search-params/codecs.ts +0 -153
  1457. package/src/search-params/create.ts +0 -321
  1458. package/src/search-params/registry.ts +0 -31
  1459. package/src/server/asset-headers.ts +0 -81
  1460. package/src/server/client-module-map.ts +0 -58
  1461. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1462. package/src/server/dev-span-processor.ts +0 -78
  1463. package/src/server/dev-warnings.ts +0 -283
  1464. package/src/server/flush.ts +0 -182
  1465. package/src/server/form-flash.ts +0 -89
  1466. package/src/server/manifest-status-resolver.ts +0 -215
  1467. package/src/server/prerender.ts +0 -139
  1468. package/src/server/tree-builder.ts +0 -382
  1469. package/src/shims/server-only-noop.js +0 -6
  1470. package/src/utils/directive-parser.ts +0 -529
@@ -0,0 +1,2056 @@
1
+ import { n as RENDER_TIMEOUT_CEILING_MS, t as DEFAULT_RENDER_TIMEOUT_MS } from "./render-timeout-DOf_BBcO.js";
2
+ import { l as registerDevDiscovery } from "./graph-cache-CYiUS2aS.js";
3
+ import { n as isScannableSourceFile, t as buildSourceExtensions } from "./scan-BoP17W3w.js";
4
+ import { t as RSC_CONTENT_TYPE } from "./rsc-media-type-DDc7duTD.js";
5
+ import { o as isMetadataRouteServePath } from "./metadata-routes-B3XJNyIH.js";
6
+ import { i as canonicalize } from "./canonicalize-BAWkWiKK.js";
7
+ import { t as matchUrlParts } from "./tree-match-6yihorhk.js";
8
+ import { normalizePath } from "vite";
9
+ import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
10
+ import { createRequire } from "node:module";
11
+ import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
12
+ import "node:http";
13
+ import { Readable, pipeline } from "node:stream";
14
+ import { pipeline as pipeline$1 } from "node:stream/promises";
15
+ import "node:https";
16
+ import "node:http2";
17
+ import { pathToFileURL } from "node:url";
18
+ import { styleText } from "node:util";
19
+ import { realpath, stat } from "node:fs/promises";
20
+ import { isIP } from "node:net";
21
+ import { constants, createGzip } from "node:zlib";
22
+ //#region ../../node_modules/.pnpm/srvx@1.0.5/node_modules/srvx/dist/adapters/node.mjs
23
+ function sendNodeResponse(nodeRes, webRes) {
24
+ try {
25
+ return _sendNodeResponse(nodeRes, webRes, false) || Promise.resolve();
26
+ } catch (error) {
27
+ return Promise.reject(error);
28
+ }
29
+ }
30
+ function _sendNodeResponse(nodeRes, webRes, detached) {
31
+ if (!webRes) {
32
+ nodeRes.statusCode = 500;
33
+ return endNodeResponse(nodeRes, detached);
34
+ }
35
+ if (webRes._toNodeResponse) {
36
+ const res = webRes._toNodeResponse();
37
+ if (res.body) {
38
+ if (res.body instanceof ReadableStream) {
39
+ writeHead(nodeRes, res.status, res.statusText, res.headers);
40
+ return streamBody(res.body, nodeRes);
41
+ } else if (typeof res.body?.pipe === "function") return pipeBody(res.body, nodeRes, res.status, res.statusText, res.headers);
42
+ writeHead(nodeRes, res.status, res.statusText, res.headers);
43
+ nodeRes.write(res.body);
44
+ } else writeHead(nodeRes, res.status, res.statusText, res.headers);
45
+ return endNodeResponse(nodeRes, detached);
46
+ }
47
+ const rawHeaders = [];
48
+ for (const [key, value] of webRes.headers) rawHeaders.push(key, value);
49
+ writeHead(nodeRes, webRes.status, webRes.statusText, rawHeaders);
50
+ return webRes.body ? streamBody(webRes.body, nodeRes) : endNodeResponse(nodeRes, detached);
51
+ }
52
+ function writeHead(nodeRes, status, statusText, rawHeaders) {
53
+ if (!nodeRes.headersSent) {
54
+ if (nodeRes.req?.httpVersion === "2.0") nodeRes.writeHead(status, rawHeaders);
55
+ else nodeRes.writeHead(status, safeStatusText(statusText), rawHeaders);
56
+ }
57
+ }
58
+ var INVALID_REASON_PHRASE_RE = /[^\t\u0020-\u007E\u0080-\u00FF]/g;
59
+ function safeStatusText(statusText) {
60
+ return typeof statusText === "string" && statusText ? statusText.replace(INVALID_REASON_PHRASE_RE, "") : statusText;
61
+ }
62
+ function endNodeResponse(nodeRes, detached) {
63
+ if (detached) {
64
+ nodeRes.end();
65
+ return;
66
+ }
67
+ return new Promise((resolve) => nodeRes.end(resolve));
68
+ }
69
+ function pipeBody(stream, nodeRes, status, statusText, headers) {
70
+ if (nodeRes.destroyed) {
71
+ stream.destroy?.();
72
+ return;
73
+ }
74
+ if (nodeRes.req?.method === "HEAD") {
75
+ if (typeof stream.destroy === "function") stream.destroy();
76
+ else stream.abort?.();
77
+ writeHead(nodeRes, status, statusText, headers);
78
+ return endNodeResponse(nodeRes);
79
+ }
80
+ if (typeof stream.on !== "function" || typeof stream.destroy !== "function") {
81
+ writeHead(nodeRes, status, statusText, headers);
82
+ stream.pipe(nodeRes);
83
+ return new Promise((resolve) => nodeRes.on("close", resolve));
84
+ }
85
+ if (stream.destroyed) {
86
+ writeHead(nodeRes, 500, "Internal Server Error", []);
87
+ return endNodeResponse(nodeRes);
88
+ }
89
+ return new Promise((resolve) => {
90
+ function cleanup() {
91
+ stream.off("error", onEarlyError);
92
+ stream.off("readable", onReadable);
93
+ nodeRes.off("close", onResClose);
94
+ }
95
+ function onEarlyError() {
96
+ cleanup();
97
+ stream.destroy();
98
+ writeHead(nodeRes, 500, "Internal Server Error", []);
99
+ endNodeResponse(nodeRes).then(resolve);
100
+ }
101
+ function onReadable() {
102
+ cleanup();
103
+ if (nodeRes.destroyed) {
104
+ stream.destroy();
105
+ return resolve();
106
+ }
107
+ writeHead(nodeRes, status, statusText, headers);
108
+ pipeline$1(stream, nodeRes).catch(() => {}).then(() => resolve());
109
+ }
110
+ function onResClose() {
111
+ cleanup();
112
+ stream.destroy();
113
+ resolve();
114
+ }
115
+ stream.once("error", onEarlyError);
116
+ stream.once("readable", onReadable);
117
+ nodeRes.once("close", onResClose);
118
+ });
119
+ }
120
+ function streamBody(stream, nodeRes) {
121
+ if (nodeRes.destroyed) {
122
+ stream.cancel().catch(() => {});
123
+ return;
124
+ }
125
+ if (nodeRes.req?.method === "HEAD") {
126
+ stream.cancel().catch(() => {});
127
+ return endNodeResponse(nodeRes);
128
+ }
129
+ const reader = stream.getReader();
130
+ function streamCancel(error) {
131
+ reader.cancel(error).catch(() => {});
132
+ if (error) nodeRes.destroy(error);
133
+ }
134
+ function streamHandle({ done, value }) {
135
+ try {
136
+ if (done) nodeRes.end();
137
+ else if (nodeRes.write(value)) reader.read().then(streamHandle, streamCancel);
138
+ else nodeRes.once("drain", () => reader.read().then(streamHandle, streamCancel));
139
+ } catch (error) {
140
+ streamCancel(error instanceof Error ? error : void 0);
141
+ }
142
+ }
143
+ nodeRes.on("close", streamCancel);
144
+ nodeRes.on("error", streamCancel);
145
+ reader.read().then(streamHandle, streamCancel);
146
+ return reader.closed.catch(streamCancel).finally(() => {
147
+ nodeRes.off("close", streamCancel);
148
+ nodeRes.off("error", streamCancel);
149
+ });
150
+ }
151
+ //#endregion
152
+ //#region src/dev-tools/stack-classifier.ts
153
+ /** Parse file/line/col from a stack frame line. */
154
+ function parseFrame(frameLine) {
155
+ const parenMatch = /\(([^)]+):(\d+):(\d+)\)/.exec(frameLine);
156
+ if (parenMatch) return {
157
+ file: parenMatch[1],
158
+ line: Number(parenMatch[2]),
159
+ col: Number(parenMatch[3])
160
+ };
161
+ const bareMatch = /at (\/[^:]+):(\d+):(\d+)/.exec(frameLine);
162
+ if (bareMatch) return {
163
+ file: bareMatch[1],
164
+ line: Number(bareMatch[2]),
165
+ col: Number(bareMatch[3])
166
+ };
167
+ return {};
168
+ }
169
+ /**
170
+ * Classify a single stack frame line by origin.
171
+ *
172
+ * - 'app': user application code (in project root, not node_modules)
173
+ * - 'framework': timber-app internal code
174
+ * - 'internal': node_modules, Node.js internals
175
+ */
176
+ function classifyFrame(frameLine, projectRoot) {
177
+ const trimmed = frameLine.trim();
178
+ if (trimmed.includes("packages/timber-app/")) return "framework";
179
+ if (trimmed.includes("node_modules/")) return "internal";
180
+ if (trimmed.startsWith("at node:") || trimmed.includes("(node:")) return "internal";
181
+ if (trimmed.includes(projectRoot)) return "app";
182
+ return "internal";
183
+ }
184
+ /**
185
+ * Classify all frames in a full stack trace string.
186
+ *
187
+ * Parses the stack, skips the first line (error message), filters to
188
+ * lines starting with "at ", and returns classified frames with optional
189
+ * file/line/col metadata.
190
+ */
191
+ function classifyStack(stack, projectRoot) {
192
+ return stack.split("\n").slice(1).filter((line) => line.trim().startsWith("at ")).map((raw) => {
193
+ const type = classifyFrame(raw, projectRoot);
194
+ const { file, line, col } = parseFrame(raw);
195
+ return {
196
+ raw,
197
+ type,
198
+ file,
199
+ line,
200
+ col
201
+ };
202
+ });
203
+ }
204
+ //#endregion
205
+ //#region src/dev-tools/terminal.ts
206
+ /**
207
+ * Terminal error formatting — boxed, color-coded error output for dev mode.
208
+ *
209
+ * Produces a visually scannable error block with:
210
+ * - Unicode box-drawing border around the error
211
+ * - Phase badge and error message
212
+ * - First app frame highlighted as the primary action item
213
+ * - OSC 8 clickable file:line links (VSCode terminal, iTerm2, etc.)
214
+ * - Internal/framework frames collapsed with a count
215
+ * - Component stack (for React render errors)
216
+ *
217
+ * Dev-only: this module is only imported by dev-error-overlay.ts.
218
+ *
219
+ * Design doc: 21-dev-server.md §"Error Overlay"
220
+ */
221
+ var noValidate = { validateStream: false };
222
+ var style = (fmt, text) => styleText(fmt, text, noValidate);
223
+ /**
224
+ * Wrap text in an OSC 8 hyperlink escape sequence.
225
+ *
226
+ * Terminals that support OSC 8 (VSCode, iTerm2, Windows Terminal, etc.)
227
+ * render this as a clickable link. Others ignore the escape sequences
228
+ * and show the text normally.
229
+ *
230
+ * Format: \x1b]8;;URL\x07TEXT\x1b]8;;\x07
231
+ */
232
+ function hyperlink(text, url) {
233
+ return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
234
+ }
235
+ /**
236
+ * Format a file:line:col reference as a clickable terminal link.
237
+ *
238
+ * Uses file:// URLs so terminals open the file in the configured editor.
239
+ * The link text is styled with cyan + underline for visibility.
240
+ */
241
+ function fileLink(filePath, line, col) {
242
+ const display = line ? `${filePath}:${line}${col ? `:${col}` : ""}` : filePath;
243
+ const base = pathToFileURL(filePath).href;
244
+ return style(["cyan", "underline"], hyperlink(display, line ? `${base}:${line}${col ? `:${col}` : ""}` : base));
245
+ }
246
+ var BOX = {
247
+ topLeft: "╭",
248
+ topRight: "╮",
249
+ bottomLeft: "╰",
250
+ bottomRight: "╯",
251
+ horizontal: "─",
252
+ vertical: "│"
253
+ };
254
+ /**
255
+ * Wrap lines of text in a Unicode box with a colored left border.
256
+ *
257
+ * @param lines - Content lines (no ANSI length calculation — keeps it simple)
258
+ * @param width - Box width (characters). Lines longer than this are not truncated.
259
+ */
260
+ function box(lines, borderFormat, width = 80) {
261
+ const bar = BOX.horizontal.repeat(width - 2);
262
+ const output = [];
263
+ output.push(style(borderFormat, `${BOX.topLeft}${bar}${BOX.topRight}`));
264
+ for (const line of lines) output.push(`${style(borderFormat, BOX.vertical)} ${line}`);
265
+ output.push(style(borderFormat, `${BOX.bottomLeft}${bar}${BOX.bottomRight}`));
266
+ return output.join("\n");
267
+ }
268
+ /**
269
+ * Format an error for terminal output with a boxed layout.
270
+ *
271
+ * The output is designed to be scannable at a glance:
272
+ * 1. Red box with phase badge and error message
273
+ * 2. First app frame as a clickable link (the primary action item)
274
+ * 3. App frames listed normally
275
+ * 4. Internal/framework frames collapsed with count
276
+ * 5. Component stack (if present)
277
+ */
278
+ function formatTerminalError$1(error, phase, projectRoot) {
279
+ const sections = [];
280
+ const componentStack = extractComponentStack(error);
281
+ const loc = parseFirstAppFrame(error.stack ?? "", projectRoot);
282
+ const frames = error.stack ? classifyStack(error.stack, projectRoot) : [];
283
+ const appFrames = frames.filter((f) => f.type === "app");
284
+ const internalCount = frames.filter((f) => f.type !== "app").length;
285
+ const boxLines = [];
286
+ boxLines.push(style(["red", "bold"], `${PHASE_LABELS$1[phase]} Error`));
287
+ boxLines.push("");
288
+ for (const msgLine of error.message.split("\n")) boxLines.push(style("red", msgLine));
289
+ if (loc) {
290
+ boxLines.push("");
291
+ const relPath = loc.file.startsWith(projectRoot) ? loc.file.slice(projectRoot.length + 1) : loc.file;
292
+ boxLines.push(`${style("bold", "→")} ${fileLink(loc.file, loc.line, loc.column)} ${style("dim", `(${relPath})`)}`);
293
+ }
294
+ sections.push(box(boxLines, "red"));
295
+ if (componentStack) {
296
+ sections.push("");
297
+ sections.push(` ${style("bold", "Component Stack:")}`);
298
+ for (const csLine of componentStack.trim().split("\n")) sections.push(` ${style("dim", csLine.trim())}`);
299
+ }
300
+ if (appFrames.length > 0) {
301
+ sections.push("");
302
+ sections.push(` ${style("bold", "Application Frames:")}`);
303
+ for (let i = 0; i < appFrames.length; i++) {
304
+ const f = appFrames[i];
305
+ if (f.file && f.line) {
306
+ const prefix = i === 0 ? style("bold", "▸") : " ";
307
+ sections.push(` ${prefix} ${fileLink(f.file, f.line, f.col)} ${style("dim", extractFnName(f.raw))}`);
308
+ } else sections.push(` ${f.raw}`);
309
+ }
310
+ }
311
+ if (internalCount > 0) sections.push(` ${style("dim", `… ${internalCount} internal frame${internalCount !== 1 ? "s" : ""} hidden`)}`);
312
+ sections.push("");
313
+ return sections.join("\n");
314
+ }
315
+ /** Extract the function name from a stack frame line like " at fnName (/path:1:2)". */
316
+ function extractFnName(frameLine) {
317
+ const match = /at\s+(\S+)\s+\(/.exec(frameLine.trim());
318
+ return match ? match[1] : "";
319
+ }
320
+ //#endregion
321
+ //#region src/dev-tools/overlay.ts
322
+ /** Labels for terminal output. */
323
+ var PHASE_LABELS$1 = {
324
+ "module-transform": "Module Transform",
325
+ "proxy": "Proxy",
326
+ "middleware": "Middleware",
327
+ "access": "Access Check",
328
+ "render": "RSC Render",
329
+ "handler": "Route Handler"
330
+ };
331
+ /**
332
+ * Extract the React component stack from an error, if present.
333
+ * React attaches this as `componentStack` during renderToReadableStream errors.
334
+ */
335
+ function extractComponentStack(error) {
336
+ if (error && typeof error === "object" && "componentStack" in error && typeof error.componentStack === "string") return error.componentStack;
337
+ return null;
338
+ }
339
+ /**
340
+ * Parse the first application frame from a stack trace.
341
+ * Returns file/line/column for the overlay's `loc` field.
342
+ */
343
+ function parseFirstAppFrame(stack, projectRoot) {
344
+ const lines = stack.split("\n");
345
+ const parenRegex = /\(([^)]+):(\d+):(\d+)\)/;
346
+ const bareRegex = /at (\/[^:]+):(\d+):(\d+)/;
347
+ for (const line of lines) {
348
+ if (classifyFrame(line, projectRoot) !== "app") continue;
349
+ const match = parenRegex.exec(line) ?? bareRegex.exec(line);
350
+ if (!match) continue;
351
+ const [, file, lineNum, col] = match;
352
+ if (file && lineNum && col) return {
353
+ file,
354
+ line: parseInt(lineNum, 10),
355
+ column: parseInt(col, 10)
356
+ };
357
+ }
358
+ return null;
359
+ }
360
+ /**
361
+ * Classify the error phase by inspecting the error's stack trace.
362
+ * Falls back to 'render' if no specific phase can be determined.
363
+ */
364
+ function classifyErrorPhase(error, projectRoot) {
365
+ const stack = error.stack ?? "";
366
+ if (extractComponentStack(error)) return "render";
367
+ const appRoot = projectRoot.replace(/\/$/, "");
368
+ if (stack.includes(`${appRoot}/app/`) || stack.includes("/app/")) {
369
+ if (stack.includes("/middleware.ts") || stack.includes("/middleware.js")) return "middleware";
370
+ if (stack.includes("/access.ts") || stack.includes("/access.js")) return "access";
371
+ if (stack.includes("/route.ts") || stack.includes("/route.js")) return "handler";
372
+ }
373
+ return "render";
374
+ }
375
+ var formatTerminalError = formatTerminalError$1;
376
+ /**
377
+ * Send an error to Vite's browser overlay and log it to stderr.
378
+ *
379
+ * Reads `error` and never writes it: the pipeline may render the same object
380
+ * on the fallback error page after reporting it here.
381
+ *
382
+ * The dev server remains running — errors are handled, not fatal.
383
+ */
384
+ function sendErrorToOverlay(server, error, phase, projectRoot) {
385
+ const formatted = formatTerminalError(error, phase, projectRoot);
386
+ process.stderr.write(`${formatted}\n`);
387
+ const loc = parseFirstAppFrame(error.stack ?? "", projectRoot);
388
+ const componentStack = extractComponentStack(error);
389
+ let message = error.message;
390
+ if (componentStack) message = `${error.message}\n\nComponent Stack:\n${componentStack.trim()}`;
391
+ try {
392
+ server.hot.send({
393
+ type: "error",
394
+ err: {
395
+ message,
396
+ stack: error.stack ?? "",
397
+ id: loc?.file,
398
+ plugin: `timber (${PHASE_LABELS$1[phase]})`,
399
+ loc: loc ? {
400
+ file: loc.file,
401
+ line: loc.line,
402
+ column: loc.column
403
+ } : void 0
404
+ }
405
+ });
406
+ } catch (e) {
407
+ console.debug("[timber] overlay error send failed:", e instanceof Error ? e.message : e);
408
+ }
409
+ }
410
+ //#endregion
411
+ //#region src/server/utils/escape-html.ts
412
+ /**
413
+ * Shared HTML escaping utility.
414
+ *
415
+ * Used by both dev-only paths (error pages, 404 page) and production
416
+ * paths (deny-renderer, RSC helpers). Lives in server/utils/ because
417
+ * it's not dev-only.
418
+ */
419
+ /**
420
+ * Escape a string for safe embedding in HTML content or attributes.
421
+ *
422
+ * Replaces `&`, `<`, `>`, and `"` with their HTML entity equivalents.
423
+ */
424
+ function escapeHtml(str) {
425
+ return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
426
+ }
427
+ //#endregion
428
+ //#region src/dev-tools/dev-page-shell.ts
429
+ /**
430
+ * Shared scaffold for dev-mode HTML pages (dev error page, dev 404 page).
431
+ *
432
+ * Both pages are self-contained HTML documents served when the normal
433
+ * render pipeline can't produce a page. They share:
434
+ * - The document scaffold (head, container, footer)
435
+ * - Base CSS (layout, light/dark variables, common components)
436
+ * - The HMR auto-reload script that watches Vite's WebSocket and reloads
437
+ * when the developer fixes the error / adds the missing route
438
+ *
439
+ * Dev-only: this module is only imported by dev-mode code paths. It is
440
+ * never included in production builds.
441
+ *
442
+ * Design doc: 21-dev-server.md §"Error Overlay", §"Dev 404 Page"
443
+ */
444
+ /**
445
+ * Extract HMR connection options from a Vite resolved config.
446
+ * Used by the dev server to pass HMR config to the dev page generators
447
+ * so the auto-reload WebSocket connects to the correct endpoint.
448
+ */
449
+ function extractHmrOptions(config) {
450
+ const hmr = config.server?.hmr;
451
+ if (hmr === false) return void 0;
452
+ const hmrOpts = typeof hmr === "object" ? hmr : {};
453
+ const opts = {
454
+ protocol: hmrOpts.protocol,
455
+ host: hmrOpts.host,
456
+ port: hmrOpts.clientPort || hmrOpts.port,
457
+ path: hmrOpts.path,
458
+ token: config.webSocketToken
459
+ };
460
+ if (!opts.protocol && !opts.host && !opts.port && !opts.path && !opts.token) return;
461
+ return opts;
462
+ }
463
+ /**
464
+ * Build the inline auto-reload script for dev pages.
465
+ *
466
+ * The page is static HTML, not a Vite-managed module, so the normal HMR
467
+ * update flow can't reach it. Instead we connect to Vite's HMR WebSocket
468
+ * directly and reload on any update event.
469
+ *
470
+ * URL construction mirrors Vite's own client.mjs: explicitly configured
471
+ * values win, and the browser's location fills any gaps at runtime. This
472
+ * matters because Vite 8 requires a `?token=` on browser WS upgrades in
473
+ * every config — a config with only a token still needs the host and port
474
+ * from `location` (TIM-1067).
475
+ */
476
+ function buildReloadScript(hmrOptions) {
477
+ return ` (function() {
478
+ try {
479
+ var o = ${JSON.stringify(hmrOptions ?? {}).replace(/</g, "\\u003c")};
480
+ var protocol = o.protocol || (location.protocol === 'https:' ? 'wss' : 'ws');
481
+ var host = o.host || location.hostname;
482
+ var port = o.port || location.port;
483
+ var url = protocol + '://' + host + (port ? ':' + port : '') + (o.path || '')
484
+ + (o.token ? '?token=' + encodeURIComponent(o.token) : '');
485
+ var ws = new WebSocket(url, 'vite-hmr');
486
+ ws.addEventListener('message', function(e) {
487
+ try {
488
+ var data = JSON.parse(e.data);
489
+ if (data.type === 'full-reload' || data.type === 'update') {
490
+ location.reload();
491
+ }
492
+ } catch (ex) {}
493
+ });
494
+ } catch (ex) {}
495
+ })();`;
496
+ }
497
+ /**
498
+ * Render a self-contained dev page: scaffold + shared CSS + footer +
499
+ * HMR auto-reload script.
500
+ */
501
+ function renderDevPageShell(opts) {
502
+ return `<!DOCTYPE html>
503
+ <html lang="en">
504
+ <head>
505
+ <meta charset="utf-8">
506
+ <meta name="viewport" content="width=device-width, initial-scale=1">
507
+ <title>${escapeHtml(opts.title)}</title>
508
+ <style>${SHARED_CSS}${opts.extraCss ?? ""}</style>
509
+ </head>
510
+ <body>
511
+ <div class="container">
512
+ ${opts.bodyHtml}
513
+
514
+ <footer class="footer">
515
+ <span class="timber-logo">🪵 timber.js</span>
516
+ <span class="footer-hint">${opts.footerHint}</span>
517
+ </footer>
518
+ </div>
519
+
520
+ <script>
521
+ ${opts.extraScript ?? ""}
522
+ // Auto-reload when Vite HMR signals an update (file fixed, route added).
523
+ ${buildReloadScript(opts.hmrOptions)}
524
+ <\/script>
525
+ </body>
526
+ </html>`;
527
+ }
528
+ /**
529
+ * Base CSS shared by all dev pages. Pages override the --badge-* variables
530
+ * (and add their own component styles) via `extraCss`.
531
+ */
532
+ var SHARED_CSS = `
533
+ :root {
534
+ --bg: #fff;
535
+ --fg: #1a1a1a;
536
+ --fg-dim: #6b7280;
537
+ --border: #e5e7eb;
538
+ --source-bg: #fafafa;
539
+ --link: #2563eb;
540
+ --code-bg: #f3f4f6;
541
+ --btn-bg: #f3f4f6;
542
+ --btn-fg: #374151;
543
+ --btn-border: #d1d5db;
544
+ --code-font: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
545
+ }
546
+
547
+ @media (prefers-color-scheme: dark) {
548
+ :root {
549
+ --bg: #0a0a0a;
550
+ --fg: #f5f5f5;
551
+ --fg-dim: #9ca3af;
552
+ --border: #27272a;
553
+ --source-bg: #18181b;
554
+ --link: #60a5fa;
555
+ --code-bg: #27272a;
556
+ --btn-bg: #27272a;
557
+ --btn-fg: #e5e7eb;
558
+ --btn-border: #3f3f46;
559
+ }
560
+ }
561
+
562
+ * { margin: 0; padding: 0; box-sizing: border-box; }
563
+
564
+ body {
565
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
566
+ background: var(--bg);
567
+ color: var(--fg);
568
+ line-height: 1.6;
569
+ padding: 2rem;
570
+ }
571
+
572
+ .container { max-width: 56rem; margin: 0 auto; }
573
+ .header { margin-bottom: 1.5rem; }
574
+
575
+ .badge {
576
+ display: inline-block;
577
+ font-size: 0.75rem;
578
+ font-weight: 600;
579
+ text-transform: uppercase;
580
+ letter-spacing: 0.05em;
581
+ padding: 0.25rem 0.625rem;
582
+ border-radius: 0.375rem;
583
+ background: var(--badge-bg);
584
+ color: var(--badge-fg);
585
+ border: 1px solid var(--badge-border);
586
+ margin-bottom: 0.75rem;
587
+ }
588
+
589
+ .message {
590
+ font-size: 1.375rem;
591
+ font-weight: 600;
592
+ line-height: 1.3;
593
+ word-break: break-word;
594
+ }
595
+
596
+ .hint {
597
+ margin-top: 0.5rem;
598
+ color: var(--fg-dim);
599
+ font-size: 0.875rem;
600
+ }
601
+
602
+ .section {
603
+ margin-bottom: 1rem;
604
+ border: 1px solid var(--border);
605
+ border-radius: 0.5rem;
606
+ overflow: hidden;
607
+ }
608
+
609
+ .section-header {
610
+ font-size: 0.75rem;
611
+ font-weight: 600;
612
+ text-transform: uppercase;
613
+ letter-spacing: 0.05em;
614
+ padding: 0.5rem 0.75rem;
615
+ background: var(--source-bg);
616
+ border-bottom: 1px solid var(--border);
617
+ color: var(--fg-dim);
618
+ }
619
+
620
+ .footer {
621
+ display: flex;
622
+ align-items: center;
623
+ gap: 0.75rem;
624
+ padding-top: 1rem;
625
+ border-top: 1px solid var(--border);
626
+ font-size: 0.75rem;
627
+ color: var(--fg-dim);
628
+ }
629
+
630
+ .timber-logo { font-weight: 600; white-space: nowrap; }
631
+ `;
632
+ //#endregion
633
+ //#region src/dev-tools/error-page.ts
634
+ /**
635
+ * Dev error page — self-contained HTML error page for dev server 500s.
636
+ *
637
+ * Generates a styled, self-contained HTML page when the RSC pipeline fails
638
+ * and the Vite error overlay can't fire (e.g., first page load before HMR
639
+ * WebSocket connects, RSC entry module crash, early pipeline errors).
640
+ *
641
+ * This is NOT a replacement for Vite's error overlay — it's the fallback
642
+ * for when the overlay's transport (WebSocket) isn't available yet.
643
+ *
644
+ * Dev-only: this module is only imported by dev-server.ts (apply: 'serve')
645
+ * and via dynamic import from fallback-error.ts in dev mode. It is never
646
+ * included in production builds.
647
+ *
648
+ * Design doc: 21-dev-server.md §"Error Overlay"
649
+ */
650
+ var PHASE_LABELS = {
651
+ "module-transform": "Module Transform",
652
+ "proxy": "Proxy",
653
+ "middleware": "Middleware",
654
+ "access": "Access Check",
655
+ "render": "RSC Render",
656
+ "handler": "Route Handler"
657
+ };
658
+ var PHASE_HINTS = {
659
+ "module-transform": "This error occurred while Vite was transforming a module. Check for syntax errors or missing imports.",
660
+ "proxy": "This error occurred in proxy.ts. Check your proxy configuration.",
661
+ "middleware": "This error occurred in a middleware.ts file. Check the middleware function for unhandled exceptions.",
662
+ "access": "This error occurred in an access.ts file. Check your access control logic.",
663
+ "render": "This error occurred while rendering a server component. Check the component for runtime errors.",
664
+ "handler": "This error occurred in a route handler (route.ts). Check the handler function."
665
+ };
666
+ /**
667
+ * Try to read a few lines of source code around the error location.
668
+ * Returns null if the file can't be read (e.g., virtual modules).
669
+ *
670
+ * Uses a top-level `node:fs` import — this module is dev-server-only and
671
+ * Node-only. A bare `require()` here would throw in the ESM build and the
672
+ * code frame would silently never render (TIM-1067, B48).
673
+ */
674
+ function readSourceContext(filePath, line, contextLines = 3) {
675
+ try {
676
+ const allLines = readFileSync(filePath, "utf-8").split("\n");
677
+ const start = Math.max(0, line - 1 - contextLines);
678
+ const end = Math.min(allLines.length, line + contextLines);
679
+ return {
680
+ startLine: start + 1,
681
+ lines: allLines.slice(start, end).map((text, i) => ({
682
+ num: start + 1 + i,
683
+ text,
684
+ highlight: start + 1 + i === line
685
+ }))
686
+ };
687
+ } catch (e) {
688
+ console.debug("[timber] source context extraction failed:", e instanceof Error ? e.message : e);
689
+ return null;
690
+ }
691
+ }
692
+ var esc = escapeHtml;
693
+ /**
694
+ * Escape a JSON string for safe embedding in an HTML `<script>` block.
695
+ *
696
+ * `JSON.stringify` does not escape `<\/script>`, so error text containing
697
+ * that sequence breaks out of the script block — an XSS vector.
698
+ * We replace all `<` with the equivalent unicode escape, which is valid in
699
+ * JSON strings and prevents the HTML parser from seeing a closing
700
+ * `<\/script>` tag.
701
+ *
702
+ * Security: TIM-788
703
+ */
704
+ function escJsonForScript(json) {
705
+ return json.replace(/</g, "\\u003c");
706
+ }
707
+ /**
708
+ * Generate a self-contained HTML error page for dev server 500 responses.
709
+ *
710
+ * The page includes:
711
+ * - Error message and phase label
712
+ * - Source code context around the first app frame (if readable)
713
+ * - Component stack (for React render errors)
714
+ * - Classified stack trace (app frames highlighted, internals collapsed)
715
+ * - Copy button for the full error
716
+ * - Dark/light mode via prefers-color-scheme
717
+ * - Auto-reconnect script that watches for Vite HMR and reloads
718
+ */
719
+ function generateDevErrorPage(error, phase, projectRoot, hmrOptions) {
720
+ const message = error.message || "Unknown error";
721
+ const phaseLabel = PHASE_LABELS[phase];
722
+ const phaseHint = PHASE_HINTS[phase];
723
+ const componentStack = extractComponentStack(error);
724
+ const loc = parseFirstAppFrame(error.stack ?? "", projectRoot);
725
+ const frames = error.stack ? classifyStack(error.stack, projectRoot) : [];
726
+ const appFrames = frames.filter((f) => f.type === "app");
727
+ const internalFrameCount = frames.filter((f) => f.type !== "app").length;
728
+ let sourceContext = null;
729
+ if (loc) sourceContext = readSourceContext(loc.file, loc.line);
730
+ const relPath = loc?.file.startsWith(projectRoot) ? loc.file.slice(projectRoot.length + 1) : loc?.file;
731
+ const bodyHtml = `<header class="header">
732
+ <div class="badge">${esc(phaseLabel)} Error</div>
733
+ <h1 class="message">${esc(message)}</h1>
734
+ ${phaseHint ? `<p class="hint">${esc(phaseHint)}</p>` : ""}
735
+ </header>
736
+
737
+ ${relPath ? `<div class="location">${esc(relPath)}${loc ? `:${loc.line}:${loc.column}` : ""}</div>` : ""}
738
+
739
+ ${sourceContext ? `<div class="source-context">
740
+ <div class="section-header">Source</div>
741
+ <pre class="source-code"><code>${sourceContext.lines.map((l) => `<span class="source-line${l.highlight ? " source-line-highlight" : ""}"><span class="line-num">${l.num}</span>${esc(l.text)}</span>`).join("\n")}</code></pre>
742
+ </div>` : ""}
743
+
744
+ ${componentStack ? `<div class="section">
745
+ <div class="section-header">Component Stack</div>
746
+ <pre class="component-stack">${esc(componentStack.trim())}</pre>
747
+ </div>` : ""}
748
+
749
+ ${appFrames.length > 0 ? `<div class="section">
750
+ <div class="section-header">Application Frames</div>
751
+ <pre class="stack">${appFrames.map((f) => esc(f.raw)).join("\n")}</pre>
752
+ </div>` : ""}
753
+
754
+ ${internalFrameCount > 0 ? `<details class="section internal-frames">
755
+ <summary class="section-header clickable">${internalFrameCount} internal frame${internalFrameCount !== 1 ? "s" : ""}</summary>
756
+ <pre class="stack dimmed">${frames.filter((f) => f.type !== "app").map((f) => esc(f.raw)).join("\n")}</pre>
757
+ </details>` : ""}
758
+
759
+ <div class="actions">
760
+ <button class="btn" onclick="copyError()">Copy Error</button>
761
+ </div>`;
762
+ const copyScript = ` function copyError() {
763
+ var text = ${escJsonForScript(JSON.stringify(`${phaseLabel} Error: ${message}\n\n` + (relPath ? `File: ${relPath}${loc ? `:${loc.line}:${loc.column}` : ""}\n\n` : "") + (componentStack ? `Component Stack:\n${componentStack.trim()}\n\n` : "") + `Stack Trace:\n${error.stack ?? ""}`))};
764
+ navigator.clipboard.writeText(text).then(function() {
765
+ var btn = document.querySelector('.btn');
766
+ if (btn) { btn.textContent = 'Copied!'; setTimeout(function() { btn.textContent = 'Copy Error'; }, 1500); }
767
+ });
768
+ }
769
+ `;
770
+ return renderDevPageShell({
771
+ title: `Error — ${phaseLabel} | timber.js`,
772
+ extraCss: ERROR_CSS,
773
+ bodyHtml,
774
+ footerHint: "Fix the error and save — the page will reload automatically via HMR.",
775
+ extraScript: copyScript,
776
+ hmrOptions
777
+ });
778
+ }
779
+ var ERROR_CSS = `
780
+ :root {
781
+ --badge-bg: #fef2f2;
782
+ --badge-fg: #991b1b;
783
+ --badge-border: #fecaca;
784
+ --highlight-bg: #fef2f2;
785
+ --highlight-border: #ef4444;
786
+ --line-num: #9ca3af;
787
+ }
788
+
789
+ @media (prefers-color-scheme: dark) {
790
+ :root {
791
+ --badge-bg: #450a0a;
792
+ --badge-fg: #fca5a5;
793
+ --badge-border: #7f1d1d;
794
+ --highlight-bg: #450a0a;
795
+ --highlight-border: #dc2626;
796
+ --line-num: #6b7280;
797
+ }
798
+ }
799
+
800
+ .location {
801
+ font-family: var(--code-font);
802
+ font-size: 0.8125rem;
803
+ color: var(--link);
804
+ margin-bottom: 1rem;
805
+ padding: 0.5rem 0.75rem;
806
+ background: var(--source-bg);
807
+ border-radius: 0.375rem;
808
+ border: 1px solid var(--border);
809
+ }
810
+
811
+ .source-context {
812
+ margin-bottom: 1rem;
813
+ border: 1px solid var(--border);
814
+ border-radius: 0.5rem;
815
+ overflow: hidden;
816
+ }
817
+
818
+ .source-code {
819
+ overflow-x: auto;
820
+ font-family: var(--code-font);
821
+ font-size: 0.8125rem;
822
+ line-height: 1.7;
823
+ padding: 0;
824
+ margin: 0;
825
+ }
826
+
827
+ .source-code code {
828
+ display: block;
829
+ }
830
+
831
+ .source-line {
832
+ display: block;
833
+ padding: 0 0.75rem;
834
+ border-left: 3px solid transparent;
835
+ }
836
+
837
+ .source-line-highlight {
838
+ background: var(--highlight-bg);
839
+ border-left-color: var(--highlight-border);
840
+ }
841
+
842
+ .line-num {
843
+ display: inline-block;
844
+ width: 3rem;
845
+ text-align: right;
846
+ margin-right: 1rem;
847
+ color: var(--line-num);
848
+ user-select: none;
849
+ }
850
+
851
+ .clickable { cursor: pointer; }
852
+ .clickable:hover { background: var(--btn-bg); }
853
+
854
+ .component-stack, .stack {
855
+ font-family: var(--code-font);
856
+ font-size: 0.8125rem;
857
+ line-height: 1.7;
858
+ padding: 0.75rem;
859
+ overflow-x: auto;
860
+ white-space: pre;
861
+ margin: 0;
862
+ }
863
+
864
+ .dimmed { color: var(--fg-dim); }
865
+
866
+ .actions {
867
+ margin: 1.5rem 0;
868
+ }
869
+
870
+ .btn {
871
+ font-family: inherit;
872
+ font-size: 0.8125rem;
873
+ font-weight: 500;
874
+ padding: 0.5rem 1rem;
875
+ border-radius: 0.375rem;
876
+ border: 1px solid var(--btn-border);
877
+ background: var(--btn-bg);
878
+ color: var(--btn-fg);
879
+ cursor: pointer;
880
+ transition: background 0.15s;
881
+ }
882
+
883
+ .btn:hover { opacity: 0.85; }
884
+ `;
885
+ //#endregion
886
+ //#region src/config-validation.ts
887
+ /**
888
+ * Config validation — validates timber.config.ts at startup.
889
+ *
890
+ * Runs in the plugin's configResolved hook (once, at startup/build).
891
+ * Each check produces a clear error message with the invalid value,
892
+ * what's expected, and how to fix it.
893
+ *
894
+ * Design doc: 18-build-system.md
895
+ */
896
+ var knownKeys = new Set(Object.keys({
897
+ output: true,
898
+ debug: true,
899
+ clientJavascript: true,
900
+ adapter: true,
901
+ allowedOrigins: true,
902
+ csrf: true,
903
+ limits: true,
904
+ forms: true,
905
+ pageExtensions: true,
906
+ slowRequestMs: true,
907
+ renderTimeoutMs: true,
908
+ devBrowserLogs: true,
909
+ dev: true,
910
+ serverTiming: true,
911
+ appDir: true,
912
+ mdx: true,
913
+ actionEncryption: true,
914
+ reactCompiler: true,
915
+ sitemap: true,
916
+ buildDir: true,
917
+ cache: true,
918
+ clientSegmentCache: true,
919
+ topLoader: true,
920
+ budget: true
921
+ }));
922
+ /**
923
+ * Validate a TimberUserConfig object.
924
+ *
925
+ * Returns an array of errors. Empty array means the config is valid.
926
+ * Does not throw — the caller decides how to surface errors.
927
+ */
928
+ function validateConfig(config) {
929
+ const errors = [];
930
+ if (config.output !== void 0 && config.output !== "server" && config.output !== "static") errors.push({
931
+ field: "output",
932
+ message: `Invalid output mode: "${String(config.output)}". Must be "server" or "static".`,
933
+ value: config.output,
934
+ suggestion: "Use output: \"server\" (default) or output: \"static\" for static site generation."
935
+ });
936
+ if (config.pageExtensions !== void 0) {
937
+ if (!Array.isArray(config.pageExtensions)) errors.push({
938
+ field: "pageExtensions",
939
+ message: "pageExtensions must be an array of strings.",
940
+ value: config.pageExtensions,
941
+ suggestion: "Example: pageExtensions: [\"tsx\", \"ts\", \"jsx\", \"js\", \"mdx\"]"
942
+ });
943
+ else for (const ext of config.pageExtensions) {
944
+ if (typeof ext !== "string") {
945
+ errors.push({
946
+ field: "pageExtensions",
947
+ message: `pageExtensions contains a non-string value: ${JSON.stringify(ext)}`,
948
+ value: ext
949
+ });
950
+ break;
951
+ }
952
+ if (ext.startsWith(".")) {
953
+ errors.push({
954
+ field: "pageExtensions",
955
+ message: `pageExtensions should not include the leading dot: "${ext}"`,
956
+ value: ext,
957
+ suggestion: `Use "${ext.slice(1)}" instead of "${ext}".`
958
+ });
959
+ break;
960
+ }
961
+ }
962
+ }
963
+ if (config.allowedOrigins !== void 0) {
964
+ if (!Array.isArray(config.allowedOrigins)) errors.push({
965
+ field: "allowedOrigins",
966
+ message: "allowedOrigins must be an array of origin strings.",
967
+ value: config.allowedOrigins,
968
+ fatal: true,
969
+ suggestion: "Example: allowedOrigins: [\"https://app.example.com\"]"
970
+ });
971
+ else for (const entry of config.allowedOrigins) {
972
+ const error = allowedOriginError(entry);
973
+ if (error) errors.push(error);
974
+ }
975
+ }
976
+ if (config.slowRequestMs !== void 0) {
977
+ if (typeof config.slowRequestMs !== "number" || config.slowRequestMs < 0) errors.push({
978
+ field: "slowRequestMs",
979
+ message: `slowRequestMs must be a non-negative number (got ${JSON.stringify(config.slowRequestMs)}).`,
980
+ value: config.slowRequestMs,
981
+ suggestion: "Use slowRequestMs: 3000 (default) or slowRequestMs: 0 to disable."
982
+ });
983
+ }
984
+ if (config.renderTimeoutMs !== void 0) {
985
+ if (typeof config.renderTimeoutMs !== "number" || config.renderTimeoutMs < 0) errors.push({
986
+ field: "renderTimeoutMs",
987
+ message: `renderTimeoutMs must be a non-negative number (got ${JSON.stringify(config.renderTimeoutMs)}).`,
988
+ value: config.renderTimeoutMs,
989
+ suggestion: `Use renderTimeoutMs: ${DEFAULT_RENDER_TIMEOUT_MS} (default). Setting 0 uses a ${RENDER_TIMEOUT_CEILING_MS / 1e3}s safety ceiling.`
990
+ });
991
+ }
992
+ if (config.serverTiming !== void 0) {
993
+ if (config.serverTiming !== "detailed" && config.serverTiming !== "total" && config.serverTiming !== false) errors.push({
994
+ field: "serverTiming",
995
+ message: `Invalid serverTiming value: ${JSON.stringify(config.serverTiming)}.`,
996
+ value: config.serverTiming,
997
+ suggestion: "Use \"detailed\", \"total\", or false."
998
+ });
999
+ }
1000
+ if (config.devBrowserLogs !== void 0) {
1001
+ const valid = [
1002
+ "error",
1003
+ "warn",
1004
+ "info",
1005
+ "none"
1006
+ ];
1007
+ if (!valid.includes(config.devBrowserLogs)) errors.push({
1008
+ field: "devBrowserLogs",
1009
+ message: `Invalid devBrowserLogs value: ${JSON.stringify(config.devBrowserLogs)}.`,
1010
+ value: config.devBrowserLogs,
1011
+ suggestion: `Use one of: ${valid.map((v) => `"${v}"`).join(", ")}.`
1012
+ });
1013
+ }
1014
+ if (config.sitemap != null && typeof config.sitemap === "object") {
1015
+ if (config.sitemap.enabled && !config.sitemap.baseUrl) errors.push({
1016
+ field: "sitemap.baseUrl",
1017
+ message: "sitemap.baseUrl is required when sitemap is enabled.",
1018
+ suggestion: "Add sitemap: { enabled: true, baseUrl: \"https://example.com\" }."
1019
+ });
1020
+ if (config.sitemap.defaultPriority !== void 0 && (config.sitemap.defaultPriority < 0 || config.sitemap.defaultPriority > 1)) errors.push({
1021
+ field: "sitemap.defaultPriority",
1022
+ message: `sitemap.defaultPriority must be between 0.0 and 1.0 (got ${config.sitemap.defaultPriority}).`,
1023
+ value: config.sitemap.defaultPriority
1024
+ });
1025
+ }
1026
+ if (config.budget != null && typeof config.budget === "object") {
1027
+ if (config.budget.firstLoadJs !== void 0 && (typeof config.budget.firstLoadJs !== "number" || config.budget.firstLoadJs <= 0)) errors.push({
1028
+ field: "budget.firstLoadJs",
1029
+ message: `budget.firstLoadJs must be a positive number in bytes (got ${JSON.stringify(config.budget.firstLoadJs)}).`,
1030
+ value: config.budget.firstLoadJs,
1031
+ suggestion: "Example: budget: { firstLoadJs: 150_000 } for a ~150 kB limit."
1032
+ });
1033
+ }
1034
+ if (config.cache != null && typeof config.cache === "object") {
1035
+ if (config.cache.strictKeyDiscipline !== void 0 && typeof config.cache.strictKeyDiscipline !== "boolean") errors.push({
1036
+ field: "cache.strictKeyDiscipline",
1037
+ message: `cache.strictKeyDiscipline must be a boolean (got ${JSON.stringify(config.cache.strictKeyDiscipline)}).`,
1038
+ value: config.cache.strictKeyDiscipline,
1039
+ suggestion: "Use cache: { strictKeyDiscipline: true } to promote key-discipline warnings to errors."
1040
+ });
1041
+ }
1042
+ const MOVED_TO_CACHE_FILE = /* @__PURE__ */ new Set(["cacheHandler", "cdnPurge"]);
1043
+ for (const key of Object.keys(config)) if (!knownKeys.has(key)) errors.push({
1044
+ field: key,
1045
+ message: `Unknown config option: "${key}".`,
1046
+ suggestion: MOVED_TO_CACHE_FILE.has(key) ? `"${key}" has moved to timber.cache.ts. Export cacheHandler as default, cdnPurge as a named export.` : `Check for typos. Known options: ${[...knownKeys].sort().join(", ")}.`
1047
+ });
1048
+ return errors;
1049
+ }
1050
+ /**
1051
+ * Why one `allowedOrigins` entry can never match, or null when it can.
1052
+ *
1053
+ * The CSRF check compares entries to the request's `Origin` header by
1054
+ * exact string, and browsers send only the canonical form — scheme, host,
1055
+ * and non-default port, lowercased, no path. So an entry that is not its
1056
+ * own `new URL(x).origin` (`https://example.com/`, `https://Example.com`,
1057
+ * `example.com`) silently matches nothing. `"null"` is refused outright:
1058
+ * it is the `Origin` of every opaque context at once.
1059
+ */
1060
+ function allowedOriginError(entry) {
1061
+ const field = "allowedOrigins";
1062
+ const fatal = true;
1063
+ if (typeof entry !== "string") return {
1064
+ field,
1065
+ message: `allowedOrigins contains a non-string value: ${JSON.stringify(entry)}.`,
1066
+ value: entry,
1067
+ fatal
1068
+ };
1069
+ if (entry === "null") return {
1070
+ field,
1071
+ message: "allowedOrigins cannot contain \"null\". Browsers send Origin: null from every opaque context — sandboxed iframes (an attacker's <iframe sandbox> included), POSTs redirected across origins, and file: pages — so allowing it allows all of them.",
1072
+ value: entry,
1073
+ suggestion: "To accept a cross-site POST on one endpoint, handle it in a route.ts that exports `const csrf = false` instead.",
1074
+ fatal
1075
+ };
1076
+ if (entry.includes("*")) return {
1077
+ field,
1078
+ message: `allowedOrigins entry ${JSON.stringify(entry)} uses a wildcard. Matching is exact; wildcards are not supported.`,
1079
+ value: entry,
1080
+ suggestion: "List each origin, e.g. [\"https://app.example.com\", \"https://admin.example.com\"].",
1081
+ fatal
1082
+ };
1083
+ const canonical = canonicalOrigin(entry) ?? canonicalOrigin(`https://${entry}`);
1084
+ if (canonical === entry) return null;
1085
+ return {
1086
+ field,
1087
+ message: `allowedOrigins entry ${JSON.stringify(entry)} is not a canonical origin, so it can never match a request's Origin header.`,
1088
+ value: entry,
1089
+ suggestion: canonical ? `Did you mean "${canonical}"? An origin is scheme://host[:port] — lowercase, no path or trailing slash.` : "An origin is scheme://host[:port], e.g. \"https://app.example.com\".",
1090
+ fatal
1091
+ };
1092
+ }
1093
+ /** `new URL(x).origin` for an http(s) URL, or null. Opaque origins are not origins here. */
1094
+ function canonicalOrigin(value) {
1095
+ try {
1096
+ const url = new URL(value);
1097
+ return url.protocol === "http:" || url.protocol === "https:" ? url.origin : null;
1098
+ } catch {
1099
+ return null;
1100
+ }
1101
+ }
1102
+ var RED = "\x1B[31m";
1103
+ var BOLD = "\x1B[1m";
1104
+ var DIM = "\x1B[2m";
1105
+ var RESET = "\x1B[0m";
1106
+ /**
1107
+ * Format config errors for terminal output. Pass `color: false` for text
1108
+ * that goes into a thrown `Error` — escapes there reach CI logs and the
1109
+ * Vite overlay as raw bytes.
1110
+ */
1111
+ function formatConfigErrors(errors, { color = true } = {}) {
1112
+ if (errors.length === 0) return "";
1113
+ const [red, bold, dim, reset] = color ? [
1114
+ RED,
1115
+ BOLD,
1116
+ DIM,
1117
+ RESET
1118
+ ] : [
1119
+ "",
1120
+ "",
1121
+ "",
1122
+ ""
1123
+ ];
1124
+ const lines = [];
1125
+ lines.push(`${red}${bold}[timber]${reset} ${red}${errors.length} config error${errors.length !== 1 ? "s" : ""} in timber.config.ts:${reset}`);
1126
+ for (const err of errors) {
1127
+ lines.push("");
1128
+ lines.push(` ${red}✗${reset} ${bold}${err.field}${reset}: ${err.message}`);
1129
+ if (err.suggestion) lines.push(` ${dim}${err.suggestion}${reset}`);
1130
+ }
1131
+ return lines.join("\n");
1132
+ }
1133
+ /**
1134
+ * Surface config errors at startup: non-fatal ones are written to stderr
1135
+ * (Vite may still work partially, and the message guides the fix); fatal
1136
+ * ones then stop startup with a thrown error. Non-fatal errors are written
1137
+ * first so a fatal one does not hide them.
1138
+ */
1139
+ function reportConfigErrors(errors, write = (text) => process.stderr.write(text)) {
1140
+ const warnings = errors.filter((e) => !e.fatal);
1141
+ if (warnings.length > 0) write(`${formatConfigErrors(warnings)}\n\n`);
1142
+ const fatal = errors.filter((e) => e.fatal);
1143
+ if (fatal.length > 0) throw new Error(formatConfigErrors(fatal, { color: false }));
1144
+ }
1145
+ var VIRTUAL_MODULE_NAMES = {
1146
+ "virtual:timber-rsc-entry": "RSC entry (server component handler)",
1147
+ "virtual:timber-ssr-entry": "SSR entry (HTML renderer)",
1148
+ "virtual:timber-browser-entry": "Browser entry (client hydration)",
1149
+ "virtual:timber-config": "Runtime config (timber.config.ts)",
1150
+ "virtual:timber-route-manifest": "Route manifest (app/ file tree)",
1151
+ "virtual:timber-instrumentation": "Instrumentation (instrumentation.ts)",
1152
+ "virtual:timber-cache-handler": "Cache handler (timber.cache.ts)",
1153
+ "virtual:timber-build-manifest": "Build manifest (asset mapping)"
1154
+ };
1155
+ /**
1156
+ * Add timber-specific context to an error message that references virtual modules.
1157
+ *
1158
+ * If the error message contains a `virtual:timber-*` ID, appends a
1159
+ * human-readable explanation. Does not replace the original message.
1160
+ */
1161
+ function addVirtualModuleContext(errorMessage) {
1162
+ for (const [id, name] of Object.entries(VIRTUAL_MODULE_NAMES)) if (errorMessage.includes(id)) return `${errorMessage}\n\n [timber] This error references "${id}" — timber's ${name}.\n This is an internal module. The issue is likely in your app code or timber configuration.`;
1163
+ return errorMessage;
1164
+ }
1165
+ /**
1166
+ * Required (non-optional) peer dependencies that must be installed.
1167
+ */
1168
+ var REQUIRED_PEERS = [
1169
+ "react",
1170
+ "react-dom",
1171
+ "@vitejs/plugin-react",
1172
+ "@vitejs/plugin-rsc"
1173
+ ];
1174
+ /**
1175
+ * Check that required peer dependencies are installed.
1176
+ *
1177
+ * Uses require.resolve with a try/catch — no fs scanning.
1178
+ * Returns only the missing packages.
1179
+ */
1180
+ function checkPeerDependencies(projectRoot) {
1181
+ const results = [];
1182
+ const userRequire = createRequire(`${projectRoot}/package.json`);
1183
+ for (const name of REQUIRED_PEERS) try {
1184
+ userRequire.resolve(name);
1185
+ results.push({
1186
+ name,
1187
+ status: "ok"
1188
+ });
1189
+ } catch {
1190
+ results.push({
1191
+ name,
1192
+ status: "missing"
1193
+ });
1194
+ }
1195
+ return results;
1196
+ }
1197
+ /**
1198
+ * Format missing peer dependencies as an actionable warning.
1199
+ */
1200
+ function formatMissingPeers(results) {
1201
+ const missing = results.filter((r) => r.status === "missing");
1202
+ if (missing.length === 0) return "";
1203
+ const names = missing.map((r) => r.name);
1204
+ const lines = [];
1205
+ lines.push(`${RED}${BOLD}[timber]${RESET} ${RED}Missing required dependencies:${RESET}`);
1206
+ lines.push("");
1207
+ for (const name of names) lines.push(` ${RED}✗${RESET} ${name}`);
1208
+ lines.push("");
1209
+ lines.push(` ${DIM}Install with:${RESET}`);
1210
+ lines.push(` ${BOLD}pnpm add ${names.join(" ")}${RESET}`);
1211
+ return lines.join("\n");
1212
+ }
1213
+ /** HMR custom event name for graph-affecting file changes. */
1214
+ var GRAPH_UPDATE_EVENT = "timber:graph-update";
1215
+ /**
1216
+ * Host-header allowlist check, ported branch-for-branch from Vite's
1217
+ * host-validation middleware (`isHostAllowedWithoutCache`) so this
1218
+ * endpoint's reachability matches the rest of the dev server:
1219
+ *
1220
+ * - `allowedHosts: true` allows everything
1221
+ * - a MISSING Host header is allowed (Vite parity — HTTP/1.0 probes)
1222
+ * - any IP-literal host is allowed (`vite --host` LAN access sends
1223
+ * `Host: 192.168.x.x:port`; rejecting it would 403 this endpoint
1224
+ * while every other dev route works)
1225
+ * - `localhost` and `*.localhost` are always allowed
1226
+ * - allowedHosts entries: exact match, or `.suffix` subdomain entries
1227
+ */
1228
+ function isAllowedGraphHost(hostHeader, allowedHosts) {
1229
+ if (allowedHosts === true) return true;
1230
+ if (hostHeader === void 0) return true;
1231
+ let host = hostHeader;
1232
+ const bracket = host.match(/^\[([^\]]+)\](?::\d+)?$/);
1233
+ if (bracket) return isIP(bracket[1]) === 6;
1234
+ const colon = host.lastIndexOf(":");
1235
+ if (colon !== -1) host = host.slice(0, colon);
1236
+ host = host.toLowerCase();
1237
+ if (isIP(host) !== 0) return true;
1238
+ if (host === "localhost" || host.endsWith(".localhost")) return true;
1239
+ for (const entry of allowedHosts ?? []) {
1240
+ const allowed = entry.toLowerCase();
1241
+ if (allowed.startsWith(".")) {
1242
+ if (host === allowed.slice(1) || host.endsWith(allowed)) return true;
1243
+ } else if (host === allowed) return true;
1244
+ }
1245
+ return false;
1246
+ }
1247
+ /**
1248
+ * Non-http(s) origins admitted without a host check: Vite's own
1249
+ * `file:` / `*-extension:` set (its host-validation regex), plus
1250
+ * `vscode-webview:` — VS Code webviews fetch with that Origin, and the
1251
+ * extension is this endpoint's primary consumer. Vite itself never
1252
+ * origin-checks plain HTTP GETs (only WebSocket upgrades), so this
1253
+ * layer is strictly additional; the additions keep it from rejecting
1254
+ * consumers Vite would serve.
1255
+ *
1256
+ * NOT admitted: `Origin: null`. Browsers serialize file:// pages'
1257
+ * opaque origin as the literal string `null` — but so do sandboxed
1258
+ * iframes and data: documents, exactly the untrusted embedders the
1259
+ * check exists to stop, and the header offers nothing to tell them
1260
+ * apart. file:// pages therefore cannot use this endpoint from a
1261
+ * browser; the `file:` scheme entry covers non-browser clients that
1262
+ * send a real scheme-form Origin (Vite admits the same set).
1263
+ */
1264
+ var TRUSTED_ORIGIN_SCHEMES = /^(?:file|vscode-webview|.+-extension):/i;
1265
+ /** Origin check: absent is fine (CLI probe); present must pass the host allowlist. */
1266
+ function isAllowedGraphOrigin(originHeader, allowedHosts) {
1267
+ if (originHeader === void 0) return true;
1268
+ if (TRUSTED_ORIGIN_SCHEMES.test(originHeader)) return true;
1269
+ let originUrl;
1270
+ try {
1271
+ originUrl = new URL(originHeader);
1272
+ } catch {
1273
+ return false;
1274
+ }
1275
+ if (originUrl.host === "") return false;
1276
+ const bareHost = originUrl.hostname.replace(/^\[|\]$/g, "");
1277
+ if (isIP(bareHost) !== 0) {
1278
+ if (bareHost === "127.0.0.1" || bareHost === "::1") return true;
1279
+ if (allowedHosts === true) return true;
1280
+ return (allowedHosts ?? []).some((entry) => entry.toLowerCase() === bareHost);
1281
+ }
1282
+ return isAllowedGraphHost(originUrl.host, allowedHosts);
1283
+ }
1284
+ function sendJson(res, status, body) {
1285
+ res.statusCode = status;
1286
+ res.setHeader("content-type", "application/json; charset=utf-8");
1287
+ res.end(JSON.stringify(body));
1288
+ }
1289
+ /**
1290
+ * Echo an ADMITTED origin back as CORS headers. A webview fetch from
1291
+ * `vscode-webview://…` passes the origin check but the browser rejects
1292
+ * the response body without `Access-Control-Allow-Origin` — the exact
1293
+ * transport design/47 specifies for the extension. Only the validated
1294
+ * origin is echoed (never `*`), with `Vary: Origin` for any cache in
1295
+ * between; unadmitted origins were already 403'd and get nothing.
1296
+ */
1297
+ function reflectCors(res, origin) {
1298
+ if (!origin) return;
1299
+ res.setHeader("Access-Control-Allow-Origin", origin);
1300
+ res.setHeader("Vary", "Origin");
1301
+ }
1302
+ /**
1303
+ * Create the Connect middleware handling GET /__timber/graph.
1304
+ *
1305
+ * Query surface: `?file=<path>` (absolute or project-root-relative) or
1306
+ * `?all=1`. Anything else is a 400 — fail loudly, like the CLI.
1307
+ */
1308
+ function createGraphEndpointMiddleware(server, ctx) {
1309
+ const sourceExtensions = buildSourceExtensions(ctx.config.pageExtensions);
1310
+ return async (req, res, next) => {
1311
+ const rawUrl = req.url;
1312
+ if (!rawUrl || !rawUrl.startsWith("/__timber/")) {
1313
+ next();
1314
+ return;
1315
+ }
1316
+ const url = new URL(rawUrl, "http://placeholder.invalid");
1317
+ if (url.pathname !== "/__timber/graph") {
1318
+ sendJson(res, 404, { error: `unknown /__timber/ endpoint: ${url.pathname}` });
1319
+ return;
1320
+ }
1321
+ if (req.method !== "GET") {
1322
+ res.setHeader("Allow", "GET");
1323
+ sendJson(res, 405, { error: "GET only" });
1324
+ return;
1325
+ }
1326
+ const origin = req.headers.origin;
1327
+ const allowedHosts = server.config.server.allowedHosts;
1328
+ if (!server.config.server.https && !isAllowedGraphHost(req.headers.host, allowedHosts)) {
1329
+ sendJson(res, 403, { error: "host not allowed" });
1330
+ return;
1331
+ }
1332
+ if (!isAllowedGraphOrigin(origin, allowedHosts)) {
1333
+ sendJson(res, 403, { error: "origin not allowed" });
1334
+ return;
1335
+ }
1336
+ reflectCors(res, origin);
1337
+ try {
1338
+ const { classifyLiveFile, classifyLiveProject } = await import("./live-graph-tSWrv8eH.js");
1339
+ const preserveSymlinks = server.config.resolve.preserveSymlinks;
1340
+ const root = normalizePath(preserveSymlinks ? ctx.root : await realpath(ctx.root));
1341
+ const appDir = normalizePath(preserveSymlinks ? ctx.appDir : await realpath(ctx.appDir).catch(() => join(root, relative(ctx.root, ctx.appDir))));
1342
+ const liveCtx = {
1343
+ rsc: server.environments.rsc.moduleGraph,
1344
+ ssr: server.environments.ssr.moduleGraph,
1345
+ client: server.environments.client.moduleGraph,
1346
+ root,
1347
+ appDir,
1348
+ pageExtensions: ctx.config.pageExtensions
1349
+ };
1350
+ const allParam = url.searchParams.get("all");
1351
+ if (allParam !== null && allParam !== "1") {
1352
+ sendJson(res, 400, { error: `unsupported all value: ${allParam} (use ?all=1)` });
1353
+ return;
1354
+ }
1355
+ if (allParam === "1") {
1356
+ sendJson(res, 200, {
1357
+ version: 1,
1358
+ source: "dev-server",
1359
+ cached: false,
1360
+ ...await classifyLiveProject(liveCtx)
1361
+ });
1362
+ return;
1363
+ }
1364
+ const fileParam = url.searchParams.get("file");
1365
+ if (!fileParam) {
1366
+ sendJson(res, 400, { error: "missing ?file=<path> (or ?all=1)" });
1367
+ return;
1368
+ }
1369
+ const absolute = normalizePath(isAbsolute(fileParam) ? resolve(fileParam) : resolve(root, fileParam));
1370
+ let target;
1371
+ try {
1372
+ const physical = normalizePath(await realpath(absolute));
1373
+ const rootPhysical = preserveSymlinks ? normalizePath(await realpath(root)) : root;
1374
+ if (physical !== rootPhysical && !physical.startsWith(rootPhysical + "/") && !physical.startsWith(rootPhysical + "\\")) {
1375
+ sendJson(res, 404, { error: `not a project file under ${root}` });
1376
+ return;
1377
+ }
1378
+ if (preserveSymlinks) {
1379
+ if (physical !== rootPhysical + absolute.slice(root.length)) {
1380
+ sendJson(res, 404, { error: `not a project source file: ${absolute}` });
1381
+ return;
1382
+ }
1383
+ }
1384
+ target = normalizePath(preserveSymlinks ? absolute : physical);
1385
+ } catch {
1386
+ sendJson(res, 404, { error: `file not found: ${absolute}` });
1387
+ return;
1388
+ }
1389
+ if (target !== root && !target.startsWith(root + "/") && !target.startsWith(root + "\\")) {
1390
+ sendJson(res, 404, { error: `not a project file under ${root}` });
1391
+ return;
1392
+ }
1393
+ if (!(await stat(target).catch(() => null))?.isFile() || !isScannableSourceFile(normalizePath(target), normalizePath(root), sourceExtensions)) {
1394
+ sendJson(res, 404, { error: `not a project source file: ${target}` });
1395
+ return;
1396
+ }
1397
+ const errors = [];
1398
+ const module = await classifyLiveFile(target, liveCtx, void 0, errors);
1399
+ sendJson(res, 200, {
1400
+ version: 1,
1401
+ source: "dev-server",
1402
+ cached: false,
1403
+ target: {
1404
+ input: fileParam,
1405
+ resolved: target
1406
+ },
1407
+ kind: module.kind,
1408
+ pending: module.pending,
1409
+ subtreeUnknown: module.subtreeUnknown,
1410
+ envs: module.envs,
1411
+ boundary: module.boundary,
1412
+ chains: module.chains,
1413
+ poisonings: module.poisonings,
1414
+ errors
1415
+ });
1416
+ } catch (error) {
1417
+ sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
1418
+ }
1419
+ };
1420
+ }
1421
+ /**
1422
+ * Build the push channel: `timber:graph-update` custom HMR events per
1423
+ * project-source change. Consumers (the VS Code extension) re-query
1424
+ * and debounce on their side; the channel just emits. Non-source noise
1425
+ * (build output, dotdirs) is filtered by the same extension set the
1426
+ * scanners use.
1427
+ *
1428
+ * Two phases per edit, because one is not enough (codex review, PR
1429
+ * #1057): the `invalidated` event fires from the plugin's `hotUpdate`
1430
+ * hook — after Vite clears the module's transform result, but its
1431
+ * importer EDGES are only rebuilt when the module is next transformed.
1432
+ * The `transformed` event fires for exactly the files with a pending
1433
+ * invalidation, and only once the node's `transformResult` is set
1434
+ * again — the plugin transform hook itself runs BEFORE Vite's trailing
1435
+ * `vite:import-analysis` (which rebuilds the edges), so the hook only
1436
+ * marks the file "settling" and a short bounded timer confirms
1437
+ * completion via `isTransformed` before emitting. (A module nothing
1438
+ * re-requests never re-transforms — its `transformed` event waits for
1439
+ * the next render, which is also when the graph has new information.)
1440
+ */
1441
+ function makeGraphUpdateChannel(ctx, send, isTransformed, canonicalize = (file) => file) {
1442
+ /** Files invalidated but not yet re-transformed, per environment. */
1443
+ const pending = /* @__PURE__ */ new Set();
1444
+ const key = (file, environment) => `${environment}\0${file}`;
1445
+ const root = normalizePath(canonicalize(ctx.root));
1446
+ const extensions = buildSourceExtensions(ctx.config.pageExtensions);
1447
+ const emitTransformed = (file, environment, structural) => {
1448
+ send({
1449
+ type: "custom",
1450
+ event: GRAPH_UPDATE_EVENT,
1451
+ data: structural ? {
1452
+ file,
1453
+ event: "update",
1454
+ environment,
1455
+ phase: "transformed",
1456
+ structural: true
1457
+ } : {
1458
+ file,
1459
+ event: "update",
1460
+ environment,
1461
+ phase: "transformed"
1462
+ }
1463
+ });
1464
+ };
1465
+ /**
1466
+ * Confirm the transform request finished (transformResult set again)
1467
+ * before emitting phase `transformed`. If confirmation never arrives
1468
+ * within the bounded schedule below, the pending key is RE-ARMED
1469
+ * rather than emitted — a `transformed` event over a still-stale
1470
+ * graph would be a false all-clear with no corrective event.
1471
+ */
1472
+ /**
1473
+ * Delays between confirmation re-checks: dense while a normal
1474
+ * transform request finishes, then exponential backoff for slow
1475
+ * import-analysis passes (large graphs, cold dep optimizer) — a
1476
+ * completed slow transform is CACHED, so no later transform hook may
1477
+ * ever fire for it and the tail checks are the only chance to emit.
1478
+ * Total window ≈ 16 s, then give up (bounded — the async-safety
1479
+ * rules ban open-ended polling) and re-arm the pending key.
1480
+ */
1481
+ const CONFIRM_DELAYS_MS = [
1482
+ ...Array.from({ length: 25 }, () => 20),
1483
+ 500,
1484
+ 1e3,
1485
+ 2e3,
1486
+ 4e3,
1487
+ 8e3
1488
+ ];
1489
+ const confirmAndEmit = (file, environment, attempt = 0, structural = false) => {
1490
+ if (!isTransformed || isTransformed(file, environment)) {
1491
+ emitTransformed(file, environment, structural);
1492
+ return;
1493
+ }
1494
+ if (attempt >= CONFIRM_DELAYS_MS.length) {
1495
+ if (!structural) pending.add(key(file, environment));
1496
+ return;
1497
+ }
1498
+ setTimeout(() => confirmAndEmit(file, environment, attempt + 1, structural), CONFIRM_DELAYS_MS[attempt]);
1499
+ };
1500
+ return {
1501
+ onHotUpdate(update) {
1502
+ const file = normalizePath(canonicalize(update.file));
1503
+ if (!isScannableSourceFile(file, root, extensions)) return;
1504
+ if (update.type === "delete") pending.delete(key(file, update.environment));
1505
+ else pending.add(key(file, update.environment));
1506
+ send({
1507
+ type: "custom",
1508
+ event: GRAPH_UPDATE_EVENT,
1509
+ data: {
1510
+ file,
1511
+ event: update.type,
1512
+ environment: update.environment,
1513
+ phase: "invalidated"
1514
+ }
1515
+ });
1516
+ },
1517
+ onTransform(id, environment) {
1518
+ const file = normalizePath(id.split("?")[0]);
1519
+ if (file.includes("virtual:timber-route-manifest")) {
1520
+ confirmAndEmit(file, environment, 25, true);
1521
+ return;
1522
+ }
1523
+ const pendingKey = key(file, environment);
1524
+ if (!pending.has(pendingKey)) return;
1525
+ pending.delete(pendingKey);
1526
+ confirmAndEmit(file, environment);
1527
+ }
1528
+ };
1529
+ }
1530
+ //#endregion
1531
+ //#region src/server/compress.ts
1532
+ /**
1533
+ * MIME types that benefit from compression.
1534
+ * text/* is handled via prefix matching; these are the specific
1535
+ * application/* and image/* types that are compressible.
1536
+ */
1537
+ var COMPRESSIBLE_TYPES = /* @__PURE__ */ new Set([
1538
+ "text/html",
1539
+ "text/css",
1540
+ "text/plain",
1541
+ "text/xml",
1542
+ "text/javascript",
1543
+ RSC_CONTENT_TYPE,
1544
+ "application/json",
1545
+ "application/javascript",
1546
+ "application/xml",
1547
+ "application/xhtml+xml",
1548
+ "application/rss+xml",
1549
+ "application/atom+xml",
1550
+ "image/svg+xml"
1551
+ ]);
1552
+ /**
1553
+ * Status codes that should never be compressed (no body or special semantics).
1554
+ */
1555
+ var NO_COMPRESS_STATUSES = /* @__PURE__ */ new Set([204, 304]);
1556
+ /**
1557
+ * Parse Accept-Encoding and return the best supported encoding.
1558
+ * Returns 'gzip' if the client accepts it, null otherwise.
1559
+ *
1560
+ * Brotli (br) is intentionally not handled at the application level.
1561
+ * At the streaming-friendly quality levels (0–4), brotli's compression
1562
+ * ratio advantage over gzip is marginal, and node:zlib's brotli transform
1563
+ * buffers output internally — turning smooth streaming responses into
1564
+ * large infrequent bursts. Brotli's real wins come from offline/static
1565
+ * compression at higher quality levels (5–11), which CDNs and reverse
1566
+ * proxies (Cloudflare, nginx, Caddy) apply on cached responses.
1567
+ *
1568
+ * See design/25-production-deployments.md.
1569
+ */
1570
+ function negotiateEncoding(acceptEncoding) {
1571
+ if (!acceptEncoding) return null;
1572
+ const parts = acceptEncoding.split(",");
1573
+ for (const part of parts) {
1574
+ const [token, ...params] = part.split(";");
1575
+ if (token.trim().toLowerCase() !== "gzip") continue;
1576
+ let qValue = 1;
1577
+ for (const param of params) {
1578
+ const trimmed = param.trim().toLowerCase();
1579
+ if (trimmed.startsWith("q=")) {
1580
+ qValue = parseFloat(trimmed.slice(2));
1581
+ if (Number.isNaN(qValue)) qValue = 1;
1582
+ break;
1583
+ }
1584
+ }
1585
+ if (qValue > 0) return "gzip";
1586
+ }
1587
+ return null;
1588
+ }
1589
+ /**
1590
+ * Determine if a response should be compressed.
1591
+ *
1592
+ * Returns false for:
1593
+ * - Responses without a body (204, 304, null body)
1594
+ * - Already-encoded responses (Content-Encoding set)
1595
+ * - Non-compressible content types (images, binary)
1596
+ * - SSE streams (text/event-stream — must not be buffered)
1597
+ */
1598
+ function shouldCompress(response) {
1599
+ const nodeBody = nodeBodyThrough(response);
1600
+ if (nodeBody ? !nodeBody.hasBody : !response.body) return false;
1601
+ if (NO_COMPRESS_STATUSES.has(response.status)) return false;
1602
+ if (response.headers.has("Content-Encoding")) return false;
1603
+ const contentType = response.headers.get("Content-Type");
1604
+ if (!contentType) return false;
1605
+ const mimeType = contentType.split(";")[0].trim().toLowerCase();
1606
+ if (mimeType === "text/event-stream") return false;
1607
+ return COMPRESSIBLE_TYPES.has(mimeType);
1608
+ }
1609
+ /**
1610
+ * Compress a Web Response if the client supports it and the content is compressible.
1611
+ *
1612
+ * Returns the original response unchanged if compression is not applicable.
1613
+ * Returns a new Response with the compressed body, Content-Encoding, and Vary headers.
1614
+ *
1615
+ * The body is piped through a compression stream — no buffering of the full response.
1616
+ * This preserves streaming behavior for HTML shell + deferred Suspense chunks.
1617
+ */
1618
+ function compressResponse(request, response) {
1619
+ if (!shouldCompress(response)) return response;
1620
+ const encoding = negotiateEncoding(request.headers.get("Accept-Encoding") ?? "");
1621
+ if (!encoding) return response;
1622
+ const headers = new Headers(response.headers);
1623
+ headers.set("Content-Encoding", encoding);
1624
+ headers.delete("Content-Length");
1625
+ const existingVary = headers.get("Vary");
1626
+ if (existingVary) {
1627
+ if (!existingVary.toLowerCase().includes("accept-encoding")) headers.set("Vary", `${existingVary}, Accept-Encoding`);
1628
+ } else headers.set("Vary", "Accept-Encoding");
1629
+ const init = {
1630
+ status: response.status,
1631
+ statusText: response.statusText,
1632
+ headers
1633
+ };
1634
+ const nodeBody = nodeBodyThrough(response);
1635
+ if (nodeBody) return nodeBody.through(createSyncFlushGzip(), init);
1636
+ return new Response(compressWithGzip(response.body), init);
1637
+ }
1638
+ /** Registry key of the Node-body brand; must equal `NODE_BODY` in node-response.ts. */
1639
+ var NODE_BODY_KEY = "timber.response.nodeBody";
1640
+ function isNodeBodyThrough(value) {
1641
+ return typeof value === "object" && value !== null && "through" in value && typeof value.through === "function" && "hasBody" in value && typeof value.hasBody === "boolean";
1642
+ }
1643
+ function nodeBodyThrough(response) {
1644
+ const ops = Reflect.get(response, Symbol.for(NODE_BODY_KEY));
1645
+ return isNodeBodyThrough(ops) ? ops : null;
1646
+ }
1647
+ /** gzip that flushes every chunk as it arrives. */
1648
+ function createSyncFlushGzip() {
1649
+ return createGzip({ flush: constants.Z_SYNC_FLUSH });
1650
+ }
1651
+ /**
1652
+ * Compress a ReadableStream with gzip, flushing each chunk immediately.
1653
+ *
1654
+ * Uses node:zlib's createGzip with Z_SYNC_FLUSH to ensure each HTML chunk
1655
+ * (shell, Suspense resolution, RSC payload) is delivered to the browser
1656
+ * as soon as it's available — preserving streaming semantics.
1657
+ */
1658
+ function compressWithGzip(body) {
1659
+ const gzip = createSyncFlushGzip();
1660
+ const nodeInput = Readable.fromWeb(body);
1661
+ pipeline(nodeInput, gzip, () => {});
1662
+ return Readable.toWeb(gzip);
1663
+ }
1664
+ //#endregion
1665
+ //#region src/plugins/dev-server.ts
1666
+ var RSC_ENTRY_ID = "virtual:timber-rsc-entry";
1667
+ /**
1668
+ * Exit code used to signal the CLI supervisor that the dev server needs
1669
+ * a full process restart (e.g. timber.config.ts changed). The supervisor
1670
+ * in cli.ts respawns the worker on this code. 75 = EX_TEMPFAIL (sysexits).
1671
+ * See TIM-1444.
1672
+ */
1673
+ var RESTART_EXIT_CODE = 75;
1674
+ /**
1675
+ * Config file names that trigger a full dev server restart when changed.
1676
+ * See 21-dev-server.md §HMR Wiring — config is loaded once at startup.
1677
+ */
1678
+ var CONFIG_FILE_NAMES = [
1679
+ "timber.config.ts",
1680
+ "timber.config.js",
1681
+ "timber.config.mjs"
1682
+ ];
1683
+ /**
1684
+ * URL prefixes that are Vite-internal and should never be intercepted.
1685
+ * These are passed through to Vite's built-in middleware.
1686
+ */
1687
+ var VITE_INTERNAL_PREFIXES = [
1688
+ "/@",
1689
+ "/__vite",
1690
+ "/node_modules/"
1691
+ ];
1692
+ /**
1693
+ * File extensions that indicate static asset requests.
1694
+ * These are passed through to Vite's static file serving.
1695
+ */
1696
+ var ASSET_EXTENSIONS = /\.(?:js|ts|tsx|jsx|css|map|json|svg|png|jpg|jpeg|gif|webp|avif|ico|woff|woff2|ttf|eot|mp4|webm|ogg|mp3|wav)(?:\?.*)?$/;
1697
+ /**
1698
+ * Create the timber-dev-server Vite plugin.
1699
+ *
1700
+ * Hook: configureServer (returns post-hook to register after Vite's middleware)
1701
+ */
1702
+ function timberDevServer(ctx) {
1703
+ let graphChannel = null;
1704
+ return {
1705
+ name: "timber-dev-server",
1706
+ apply: "serve",
1707
+ /**
1708
+ * Push channel for the graph endpoint, phase 1: `invalidated`, one
1709
+ * per (file, environment). Emitted from hotUpdate — which runs
1710
+ * AFTER Vite invalidates the environment module graphs — never
1711
+ * from a raw watcher listener, which would race consumers into
1712
+ * querying pre-invalidation memberships (design/47 §"Dev-server
1713
+ * endpoint").
1714
+ */
1715
+ hotUpdate({ file, type }) {
1716
+ graphChannel?.onHotUpdate({
1717
+ file,
1718
+ type,
1719
+ environment: this.environment.name
1720
+ });
1721
+ },
1722
+ /**
1723
+ * Push channel phase 2: `transformed`, when a pending-invalidated
1724
+ * module's import edges are actually rebuilt. A Set lookup for
1725
+ * everything without a pending invalidation — free on the hot
1726
+ * path. Returning nothing leaves the code untouched.
1727
+ */
1728
+ transform(_code, id) {
1729
+ graphChannel?.onTransform(id, this.environment.name);
1730
+ },
1731
+ /**
1732
+ * Register the dev server middleware and config file watcher.
1733
+ *
1734
+ * Registers as a pre-hook (no return value) so our middleware runs
1735
+ * before Vite's built-in SPA fallback / historyApiFallback. This
1736
+ * ensures we see the original URL (e.g. /blog) rather than a
1737
+ * rewritten /index.html. Vite-internal and asset requests are
1738
+ * filtered out explicitly and passed through to Vite.
1739
+ */
1740
+ async configureServer(server) {
1741
+ const configPaths = CONFIG_FILE_NAMES.map((name) => join(ctx.root, name));
1742
+ server.watcher.add(configPaths);
1743
+ const configPathSet = new Set(configPaths);
1744
+ const hasSupervisor = Boolean(process.env.__TIMBER_DEV_WORKER);
1745
+ const onConfigChange = (filePath) => {
1746
+ if (!configPathSet.has(filePath)) return;
1747
+ if (hasSupervisor) {
1748
+ console.log(`\n[timber] ${basename(filePath)} changed — restarting dev server...\n`);
1749
+ process.exit(75);
1750
+ } else {
1751
+ console.log(`\n[timber] ${basename(filePath)} changed — restarting dev server...\n[timber] Run \`timber dev\` instead of \`vite dev\` for guaranteed fresh config on restart.\n`);
1752
+ server.restart();
1753
+ }
1754
+ };
1755
+ server.watcher.on("change", onConfigChange);
1756
+ server.watcher.on("add", onConfigChange);
1757
+ server.watcher.on("unlink", onConfigChange);
1758
+ listenForClientErrors(server, ctx.root);
1759
+ server.middlewares.use(createGraphEndpointMiddleware(server, ctx));
1760
+ graphChannel = makeGraphUpdateChannel(ctx, (payload) => server.hot.send(payload), (file, environment) => {
1761
+ const graph = server.environments[environment]?.moduleGraph;
1762
+ if (!graph) return false;
1763
+ const nodes = graph.getModulesByFile(file);
1764
+ if (nodes) {
1765
+ for (const node of nodes) if (node.transformResult != null) return true;
1766
+ return false;
1767
+ }
1768
+ return graph.getModuleById(file)?.transformResult != null;
1769
+ }, (file) => {
1770
+ if (server.config?.resolve?.preserveSymlinks || file.includes("virtual:")) return file;
1771
+ try {
1772
+ return realpathSync(file);
1773
+ } catch {
1774
+ try {
1775
+ return join(realpathSync(dirname(file)), basename(file));
1776
+ } catch {
1777
+ return file;
1778
+ }
1779
+ }
1780
+ });
1781
+ server.middlewares.use(createTimberMiddleware(server, ctx));
1782
+ registerDevDiscovery(server.httpServer, ctx.root, server.config);
1783
+ if (ctx.holdingServer) {
1784
+ await ctx.holdingServer.close().catch(() => {});
1785
+ ctx.holdingServer = null;
1786
+ }
1787
+ ctx.timer.end("dev-server-setup");
1788
+ const summary = ctx.timer.formatSummary();
1789
+ if (summary) console.log(summary);
1790
+ }
1791
+ };
1792
+ }
1793
+ /**
1794
+ * Create the Connect middleware that routes requests through the timber pipeline.
1795
+ *
1796
+ * For route requests (HTML pages, API endpoints), the middleware:
1797
+ * 1. Loads the RSC entry via ssrLoadModule
1798
+ * 2. Converts the Node request to a Web Request
1799
+ * 3. Passes it through the RSC handler (which runs the full pipeline)
1800
+ * 4. Converts the Web Response back to a Node response
1801
+ *
1802
+ * For non-route requests (assets, Vite internals, HMR), the middleware
1803
+ * calls next() to let Vite handle them.
1804
+ */
1805
+ function createTimberMiddleware(server, ctx) {
1806
+ const projectRoot = ctx.root;
1807
+ const hmrOptions = extractHmrOptions(server.config);
1808
+ return async (req, res, next) => {
1809
+ const url = req.url;
1810
+ if (!url) {
1811
+ next();
1812
+ return;
1813
+ }
1814
+ if (isViteInternal(url)) {
1815
+ next();
1816
+ return;
1817
+ }
1818
+ if (isPublicFile(server, url)) {
1819
+ next();
1820
+ return;
1821
+ }
1822
+ if (isAssetRequest(url) && !isMetadataRouteServePath(url) && !isRouteOwnedAsset(ctx.routeTree, server, url)) {
1823
+ next();
1824
+ return;
1825
+ }
1826
+ let handler;
1827
+ try {
1828
+ const rscEnv = server.environments.rsc;
1829
+ if (!rscEnv?.runner?.import) throw new Error("[timber] RSC environment is not runnable");
1830
+ const rscModule = await rscEnv.runner.import(RSC_ENTRY_ID);
1831
+ handler = rscModule.default;
1832
+ const setDevHooks = rscModule.setDevHooks;
1833
+ setDevHooks?.({
1834
+ onPipelineError: (error) => {
1835
+ sendErrorToOverlay(server, error, classifyErrorPhase(error, projectRoot), projectRoot);
1836
+ },
1837
+ hmrOptions
1838
+ });
1839
+ } catch (error) {
1840
+ if (error instanceof Error) {
1841
+ addTimberContext(error);
1842
+ sendErrorToOverlay(server, error, "module-transform", projectRoot);
1843
+ }
1844
+ respond500(res, error, "module-transform", projectRoot, hmrOptions);
1845
+ return;
1846
+ }
1847
+ if (typeof handler !== "function") {
1848
+ console.error("[timber] RSC entry module does not export a default function");
1849
+ next();
1850
+ return;
1851
+ }
1852
+ try {
1853
+ const webRequest = toWebRequest(req);
1854
+ const wrapper = server[Symbol.for("timber:dev-request-wrapper")];
1855
+ const finalResponse = compressResponse(webRequest, wrapper ? await wrapper(() => handler(webRequest)) : await handler(webRequest));
1856
+ res.writeHead(finalResponse.status, [...finalResponse.headers].flat());
1857
+ res.flushHeaders();
1858
+ await sendNodeResponse(res, finalResponse);
1859
+ } catch (error) {
1860
+ if (error instanceof Error) {
1861
+ const phase = classifyErrorPhase(error, projectRoot);
1862
+ sendErrorToOverlay(server, error, phase, projectRoot);
1863
+ respond500(res, error, phase, projectRoot, hmrOptions);
1864
+ } else {
1865
+ process.stderr.write(`\x1b[31m[timber] Dev server error:\x1b[0m ${String(error)}\n`);
1866
+ respond500(res, error, "render", projectRoot, hmrOptions);
1867
+ }
1868
+ }
1869
+ };
1870
+ }
1871
+ /**
1872
+ * Send a 500 response without crashing the dev server.
1873
+ *
1874
+ * In dev mode, renders a styled HTML error page with source context,
1875
+ * classified stack trace, and auto-reload on HMR. Falls back to
1876
+ * text/plain if the HTML generator fails (must never crash).
1877
+ */
1878
+ function respond500(res, error, phase, projectRoot, hmrOptions) {
1879
+ if (res.headersSent) return;
1880
+ if (error instanceof Error) try {
1881
+ const html = generateDevErrorPage(error, phase, projectRoot, hmrOptions);
1882
+ res.statusCode = 500;
1883
+ res.setHeader("content-type", "text/html; charset=utf-8");
1884
+ res.end(html);
1885
+ return;
1886
+ } catch (e) {
1887
+ console.debug("[timber] dev error page generation failed, falling back to text/plain:", e instanceof Error ? e.message : e);
1888
+ }
1889
+ res.statusCode = 500;
1890
+ res.setHeader("content-type", "text/plain");
1891
+ res.end(`[timber] Internal server error\n\n${error instanceof Error ? error.stack ?? error.message : String(error)}`);
1892
+ }
1893
+ /**
1894
+ * Add timber-specific context to an error's message if it references
1895
+ * internal virtual modules (virtual:timber-*). Mutates the error in place.
1896
+ */
1897
+ function addTimberContext(error) {
1898
+ const enriched = addVirtualModuleContext(error.message);
1899
+ if (enriched !== error.message) error.message = enriched;
1900
+ }
1901
+ /**
1902
+ * Convert a Node IncomingMessage to a Web Request.
1903
+ *
1904
+ * Constructs the full URL from the Host header and request URL,
1905
+ * and forwards the method, headers, and body.
1906
+ *
1907
+ * The scheme comes from the socket's TLS state — with `server.https` the
1908
+ * browser sends `Origin: https://host`, and a hardcoded `http://` would
1909
+ * fail CSRF origin comparison on every POST. X-Forwarded-Proto is NOT
1910
+ * consulted: dev connections are direct, so the header would be
1911
+ * attacker-controlled. (TIM-1067, B32)
1912
+ *
1913
+ * Exported for tests.
1914
+ */
1915
+ function toWebRequest(nodeReq) {
1916
+ const protocol = nodeReq.socket?.encrypted ? "https" : "http";
1917
+ const host = nodeReq.headers.host ?? nodeReq.headers[":authority"] ?? "localhost";
1918
+ const url = `${protocol}://${host}${nodeReq.url}`;
1919
+ const headers = new Headers();
1920
+ for (const [key, value] of Object.entries(nodeReq.headers)) {
1921
+ if (value === void 0) continue;
1922
+ if (key.startsWith(":")) continue;
1923
+ if (Array.isArray(value)) for (const v of value) headers.append(key, v);
1924
+ else headers.set(key, value);
1925
+ }
1926
+ if (!headers.has("host")) headers.set("host", host);
1927
+ const method = nodeReq.method ?? "GET";
1928
+ const hasBody = method !== "GET" && method !== "HEAD";
1929
+ return new Request(url, {
1930
+ method,
1931
+ headers,
1932
+ body: hasBody ? nodeReadableToWebStream(nodeReq) : void 0,
1933
+ duplex: hasBody ? "half" : void 0
1934
+ });
1935
+ }
1936
+ /**
1937
+ * Convert a Node Readable stream to a Web ReadableStream.
1938
+ */
1939
+ function nodeReadableToWebStream(nodeStream) {
1940
+ return new ReadableStream({ start(controller) {
1941
+ nodeStream.on("data", (chunk) => {
1942
+ controller.enqueue(new Uint8Array(chunk));
1943
+ });
1944
+ nodeStream.on("end", () => {
1945
+ controller.close();
1946
+ });
1947
+ nodeStream.on("error", (err) => {
1948
+ controller.error(err);
1949
+ });
1950
+ } });
1951
+ }
1952
+ /**
1953
+ * Check if a URL is a Vite-internal request that should be passed through.
1954
+ */
1955
+ function isViteInternal(url) {
1956
+ return VITE_INTERNAL_PREFIXES.some((prefix) => url.startsWith(prefix));
1957
+ }
1958
+ /**
1959
+ * Check if a URL looks like a static asset request.
1960
+ */
1961
+ function isAssetRequest(url) {
1962
+ return ASSET_EXTENSIONS.test(url);
1963
+ }
1964
+ /**
1965
+ * Check if a URL maps to a real file in the project's public/ directory.
1966
+ * Vite serves public/ files as static assets — if a file exists there it
1967
+ * must be passed through to Vite regardless of extension.
1968
+ */
1969
+ function isPublicFile(server, url) {
1970
+ const { publicDir } = server.config;
1971
+ if (!publicDir) return false;
1972
+ const pathname = url.split("?")[0];
1973
+ const relativePath = pathname.startsWith("/") ? pathname.slice(1) : pathname;
1974
+ if (!relativePath) return false;
1975
+ const fullPath = join(publicDir, relativePath);
1976
+ try {
1977
+ return statSync(fullPath).isFile();
1978
+ } catch {
1979
+ return false;
1980
+ }
1981
+ }
1982
+ /**
1983
+ * Check whether an asset-extension URL belongs to a scanned route rather
1984
+ * than a static file.
1985
+ *
1986
+ * Route handlers may live at paths ending in asset-like extensions
1987
+ * (app/feed.json/route.ts → /feed.json), which the asset bypass would
1988
+ * otherwise hand to Vite — 404ing in dev while working in production.
1989
+ * Uses the same canonicalization and tree walker as the runtime matcher
1990
+ * so dev classification agrees with what the pipeline would match.
1991
+ *
1992
+ * A file that actually exists on disk wins over the route match: the
1993
+ * production server serves public/ statics before the RSC handler (see
1994
+ * adapters/nitro.ts), and Vite serves root-relative source files (e.g.
1995
+ * /app/global.css) in dev. Without this, a broad catch-all route like
1996
+ * app/[...slug] would shadow every static asset. Joining the canonical
1997
+ * pathname is traversal-safe — canonicalize() resolves `..` segments and
1998
+ * rejects root escapes and encoded separators.
1999
+ *
2000
+ * Reads ctx.routeTree per request — the routing plugin rescans it on
2001
+ * file add/unlink/change, so newly created routes are picked up live.
2002
+ */
2003
+ function isRouteOwnedAsset(routeTree, server, url) {
2004
+ if (!routeTree) return false;
2005
+ const rawPathname = url.split("?")[0];
2006
+ const result = canonicalize(rawPathname);
2007
+ if (!result.ok) return false;
2008
+ const parts = result.pathname === "/" ? [] : result.pathname.slice(1).split("/");
2009
+ if (matchUrlParts(routeTree.root, parts) === null) return false;
2010
+ const relativePath = result.pathname.slice(1);
2011
+ const { publicDir, root } = server.config;
2012
+ if (publicDir && existsSync(join(publicDir, relativePath))) return false;
2013
+ if (existsSync(join(root, relativePath))) return false;
2014
+ return true;
2015
+ }
2016
+ /**
2017
+ * Listen for client-side errors forwarded from the browser via HMR.
2018
+ *
2019
+ * The browser entry catches uncaught errors and unhandled rejections,
2020
+ * then sends them as 'timber:client-error' custom events. We parse
2021
+ * the first app frame for the overlay's loc field and forward the
2022
+ * error to Vite's overlay protocol.
2023
+ */
2024
+ function listenForClientErrors(server, projectRoot) {
2025
+ server.hot.on("timber:client-error", (data) => {
2026
+ const loc = parseFirstAppFrame(data.stack, projectRoot);
2027
+ let message = data.message;
2028
+ if (data.componentStack) message = `${data.message}\n\nComponent Stack:\n${data.componentStack.trim()}`;
2029
+ const RED = "\x1B[31m";
2030
+ const BOLD = "\x1B[1m";
2031
+ const RESET = "\x1B[0m";
2032
+ process.stderr.write(`${RED}${BOLD}[timber] Client Error${RESET}\n${RED}${data.message}${RESET}\n\n`);
2033
+ try {
2034
+ server.hot.send({
2035
+ type: "error",
2036
+ err: {
2037
+ message,
2038
+ stack: data.stack,
2039
+ id: loc?.file,
2040
+ plugin: "timber (Client)",
2041
+ loc: loc ? {
2042
+ file: loc.file,
2043
+ line: loc.line,
2044
+ column: loc.column
2045
+ } : void 0
2046
+ }
2047
+ });
2048
+ } catch (e) {
2049
+ console.debug("[timber] overlay send failed:", e instanceof Error ? e.message : e);
2050
+ }
2051
+ });
2052
+ }
2053
+ //#endregion
2054
+ export { formatMissingPeers as a, checkPeerDependencies as i, timberDevServer as n, reportConfigErrors as o, toWebRequest as r, validateConfig as s, RESTART_EXIT_CODE as t };
2055
+
2056
+ //# sourceMappingURL=dev-server-DnODXuNM.js.map