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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1484) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BDqn4Oxj.js +1243 -0
  5. package/dist/_chunks/actions-BDqn4Oxj.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-GE4AOe2H.js +1061 -0
  17. package/dist/_chunks/cache-api-GE4AOe2H.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-BiWNMBVU.js +1 -0
  44. package/dist/_chunks/dev-server-DIy-SY-J.js +2061 -0
  45. package/dist/_chunks/dev-server-DIy-SY-J.js.map +1 -0
  46. package/dist/_chunks/dev-store-BOa304m_.js +283 -0
  47. package/dist/_chunks/dev-store-BOa304m_.js.map +1 -0
  48. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  49. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  50. package/dist/_chunks/error-boundary-Bc8QPZuq.js +1107 -0
  51. package/dist/_chunks/error-boundary-Bc8QPZuq.js.map +1 -0
  52. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  53. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  54. package/dist/_chunks/flight-source-node-HptmGMT8.js +518 -0
  55. package/dist/_chunks/flight-source-node-HptmGMT8.js.map +1 -0
  56. package/dist/_chunks/format-BKclgVbk.js +14 -0
  57. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  58. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  59. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  60. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  61. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  62. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  63. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  64. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  65. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  66. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  67. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  68. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  69. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  70. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  71. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  72. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  73. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  74. package/dist/_chunks/node-response-rkQqcFGq.js +233 -0
  75. package/dist/_chunks/node-response-rkQqcFGq.js.map +1 -0
  76. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  77. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  78. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  79. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  80. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  81. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  82. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  83. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  84. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  85. package/dist/_chunks/purge-store-WZaxu-3m.js +14 -0
  86. package/dist/_chunks/purge-store-WZaxu-3m.js.map +1 -0
  87. package/dist/_chunks/render-timeout-joFhz4KH.js +37 -0
  88. package/dist/_chunks/render-timeout-joFhz4KH.js.map +1 -0
  89. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  90. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  91. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  92. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  93. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  94. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  95. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  96. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  97. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  98. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  99. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  100. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  101. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  102. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  103. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  104. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  105. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  106. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  107. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  108. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  109. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  110. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  111. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  112. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  113. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  114. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  115. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  116. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  117. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  118. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  119. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  120. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  121. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  122. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  123. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  124. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  125. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  126. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  127. package/dist/adapters/build-output-helper.d.ts +72 -0
  128. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  129. package/dist/adapters/canonicalize-module.d.ts +8 -0
  130. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  132. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  133. package/dist/adapters/cloudflare-dev.js +74 -0
  134. package/dist/adapters/cloudflare-dev.js.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  136. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  137. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  138. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  139. package/dist/adapters/cloudflare.d.ts +224 -24
  140. package/dist/adapters/cloudflare.d.ts.map +1 -1
  141. package/dist/adapters/cloudflare.js +1 -188
  142. package/dist/adapters/compress-module.d.ts +25 -4
  143. package/dist/adapters/compress-module.d.ts.map +1 -1
  144. package/dist/adapters/fs-identity.d.ts +63 -0
  145. package/dist/adapters/fs-identity.d.ts.map +1 -0
  146. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  147. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-presets.d.ts +31 -0
  149. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  150. package/dist/adapters/nitro-preview.d.ts +65 -0
  151. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  152. package/dist/adapters/nitro.d.ts +69 -38
  153. package/dist/adapters/nitro.d.ts.map +1 -1
  154. package/dist/adapters/nitro.js +793 -341
  155. package/dist/adapters/nitro.js.map +1 -1
  156. package/dist/adapters/shared.d.ts +67 -0
  157. package/dist/adapters/shared.d.ts.map +1 -0
  158. package/dist/adapters/types.d.ts +124 -16
  159. package/dist/adapters/types.d.ts.map +1 -1
  160. package/dist/adapters/types.js +0 -0
  161. package/dist/analyze/chains.d.ts +124 -0
  162. package/dist/analyze/chains.d.ts.map +1 -0
  163. package/dist/analyze/classify.d.ts +153 -0
  164. package/dist/analyze/classify.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.d.ts +17 -0
  166. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  167. package/dist/analyze/crawl-entry.js +314 -0
  168. package/dist/analyze/crawl-entry.js.map +1 -0
  169. package/dist/analyze/crawl.d.ts +134 -0
  170. package/dist/analyze/crawl.d.ts.map +1 -0
  171. package/dist/analyze/graph-cache.d.ts +104 -0
  172. package/dist/analyze/graph-cache.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.d.ts +43 -0
  174. package/dist/analyze/graph-command.d.ts.map +1 -0
  175. package/dist/analyze/graph-command.js +472 -0
  176. package/dist/analyze/graph-command.js.map +1 -0
  177. package/dist/analyze/live-graph.d.ts +81 -0
  178. package/dist/analyze/live-graph.d.ts.map +1 -0
  179. package/dist/analyze/poison-rules.d.ts +72 -0
  180. package/dist/analyze/poison-rules.d.ts.map +1 -0
  181. package/dist/analyze/poison-scan.d.ts +48 -0
  182. package/dist/analyze/poison-scan.d.ts.map +1 -0
  183. package/dist/analyze/scan.d.ts +73 -0
  184. package/dist/analyze/scan.d.ts.map +1 -0
  185. package/dist/cache/cache-api.d.ts +48 -0
  186. package/dist/cache/cache-api.d.ts.map +1 -0
  187. package/dist/cache/fast-hash.d.ts +5 -0
  188. package/dist/cache/fast-hash.d.ts.map +1 -1
  189. package/dist/cache/handler-store.d.ts +45 -0
  190. package/dist/cache/handler-store.d.ts.map +1 -0
  191. package/dist/cache/index.d.ts +32 -9
  192. package/dist/cache/index.d.ts.map +1 -1
  193. package/dist/cache/index.js +4 -326
  194. package/dist/cache/invalidation-epoch.d.ts +50 -0
  195. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  196. package/dist/cache/json-lossy-check.d.ts +11 -0
  197. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  198. package/dist/cache/redis-handler.d.ts +141 -9
  199. package/dist/cache/redis-handler.d.ts.map +1 -1
  200. package/dist/cache/singleflight.d.ts +21 -2
  201. package/dist/cache/singleflight.d.ts.map +1 -1
  202. package/dist/cache/sizeof.d.ts +22 -0
  203. package/dist/cache/sizeof.d.ts.map +1 -0
  204. package/dist/cache/stable-stringify.d.ts +9 -0
  205. package/dist/cache/stable-stringify.d.ts.map +1 -1
  206. package/dist/cache/store.d.ts +53 -0
  207. package/dist/cache/store.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  209. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  210. package/dist/cache/stores/cloudflare-kv.js +29 -0
  211. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  212. package/dist/cache/stores/memory.d.ts +42 -0
  213. package/dist/cache/stores/memory.d.ts.map +1 -0
  214. package/dist/cache/stores/memory.js +90 -0
  215. package/dist/cache/stores/memory.js.map +1 -0
  216. package/dist/cache/stores/redis.d.ts +69 -0
  217. package/dist/cache/stores/redis.d.ts.map +1 -0
  218. package/dist/cache/stores/redis.js +35 -0
  219. package/dist/cache/stores/redis.js.map +1 -0
  220. package/dist/cache/stores/vercel.d.ts +36 -0
  221. package/dist/cache/stores/vercel.d.ts.map +1 -0
  222. package/dist/cache/stores/vercel.js +33 -0
  223. package/dist/cache/stores/vercel.js.map +1 -0
  224. package/dist/cache/tag-aware-handler.d.ts +52 -0
  225. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  226. package/dist/cache/timber-cache.d.ts +21 -11
  227. package/dist/cache/timber-cache.d.ts.map +1 -1
  228. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  229. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  230. package/dist/cdn/cloudflare-purge.js +30 -0
  231. package/dist/cdn/cloudflare-purge.js.map +1 -0
  232. package/dist/cdn/fastly-purge.d.ts +25 -0
  233. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  234. package/dist/cdn/fastly-purge.js +33 -0
  235. package/dist/cdn/fastly-purge.js.map +1 -0
  236. package/dist/cdn/headers.d.ts +97 -0
  237. package/dist/cdn/headers.d.ts.map +1 -0
  238. package/dist/cdn/index.d.ts +5 -0
  239. package/dist/cdn/index.d.ts.map +1 -0
  240. package/dist/cdn/index.js +94 -0
  241. package/dist/cdn/index.js.map +1 -0
  242. package/dist/cdn/purge-store.d.ts +32 -0
  243. package/dist/cdn/purge-store.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  245. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  246. package/dist/cdn/workers-cache-purge.js +35 -0
  247. package/dist/cdn/workers-cache-purge.js.map +1 -0
  248. package/dist/cli-check.d.ts +133 -0
  249. package/dist/cli-check.d.ts.map +1 -0
  250. package/dist/cli-context.d.ts +54 -0
  251. package/dist/cli-context.d.ts.map +1 -0
  252. package/dist/cli-schema-sync.d.ts +59 -0
  253. package/dist/cli-schema-sync.d.ts.map +1 -0
  254. package/dist/cli.d.ts +88 -16
  255. package/dist/cli.d.ts.map +1 -1
  256. package/dist/cli.js +225 -63
  257. package/dist/cli.js.map +1 -1
  258. package/dist/client/browser-dev.d.ts +42 -2
  259. package/dist/client/browser-dev.d.ts.map +1 -1
  260. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  261. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  262. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  263. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  264. package/dist/client/browser-entry/form-state.d.ts +22 -0
  265. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hmr.d.ts +21 -0
  267. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  268. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  269. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  270. package/dist/client/browser-entry/index.d.ts +32 -0
  271. package/dist/client/browser-entry/index.d.ts.map +1 -0
  272. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  273. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  274. package/dist/client/browser-entry/router-init.d.ts +41 -0
  275. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  276. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  277. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  278. package/dist/client/browser-entry/scroll.d.ts +28 -0
  279. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  280. package/dist/client/deny-last-resort.d.ts +29 -0
  281. package/dist/client/deny-last-resort.d.ts.map +1 -0
  282. package/dist/client/error-boundary.d.ts +58 -9
  283. package/dist/client/error-boundary.d.ts.map +1 -1
  284. package/dist/client/error-boundary.js +1 -126
  285. package/dist/client/error-reconstituter.d.ts +55 -0
  286. package/dist/client/error-reconstituter.d.ts.map +1 -0
  287. package/dist/client/form.d.ts +38 -99
  288. package/dist/client/form.d.ts.map +1 -1
  289. package/dist/client/global-context.d.ts +15 -0
  290. package/dist/client/global-context.d.ts.map +1 -0
  291. package/dist/client/history.d.ts +50 -9
  292. package/dist/client/history.d.ts.map +1 -1
  293. package/dist/client/index.d.ts +21 -33
  294. package/dist/client/index.d.ts.map +1 -1
  295. package/dist/client/index.js +423 -1227
  296. package/dist/client/index.js.map +1 -1
  297. package/dist/client/internal.d.ts +20 -0
  298. package/dist/client/internal.d.ts.map +1 -0
  299. package/dist/client/internal.js +781 -0
  300. package/dist/client/internal.js.map +1 -0
  301. package/dist/client/link.d.ts +85 -60
  302. package/dist/client/link.d.ts.map +1 -1
  303. package/dist/client/location-search.d.ts +12 -0
  304. package/dist/client/location-search.d.ts.map +1 -0
  305. package/dist/client/navigation-api.d.ts +95 -0
  306. package/dist/client/navigation-api.d.ts.map +1 -0
  307. package/dist/client/navigation-commit.d.ts +111 -0
  308. package/dist/client/navigation-commit.d.ts.map +1 -0
  309. package/dist/client/navigation-context.d.ts +54 -36
  310. package/dist/client/navigation-context.d.ts.map +1 -1
  311. package/dist/client/navigation-root.d.ts +106 -0
  312. package/dist/client/navigation-root.d.ts.map +1 -0
  313. package/dist/client/navigation-transition.d.ts +255 -0
  314. package/dist/client/navigation-transition.d.ts.map +1 -0
  315. package/dist/client/nuqs-adapter.d.ts +1 -1
  316. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  317. package/dist/client/params-context.d.ts +81 -0
  318. package/dist/client/params-context.d.ts.map +1 -0
  319. package/dist/client/react-root.d.ts +51 -0
  320. package/dist/client/react-root.d.ts.map +1 -0
  321. package/dist/client/router-effects.d.ts +203 -0
  322. package/dist/client/router-effects.d.ts.map +1 -0
  323. package/dist/client/router-lifecycle.d.ts +104 -0
  324. package/dist/client/router-lifecycle.d.ts.map +1 -0
  325. package/dist/client/router-pipeline.d.ts +81 -0
  326. package/dist/client/router-pipeline.d.ts.map +1 -0
  327. package/dist/client/router-ref.d.ts +2 -2
  328. package/dist/client/router-ref.d.ts.map +1 -1
  329. package/dist/client/router-skew.d.ts +21 -0
  330. package/dist/client/router-skew.d.ts.map +1 -0
  331. package/dist/client/router-types.d.ts +294 -0
  332. package/dist/client/router-types.d.ts.map +1 -0
  333. package/dist/client/router-url.d.ts +24 -0
  334. package/dist/client/router-url.d.ts.map +1 -0
  335. package/dist/client/router.d.ts +1 -97
  336. package/dist/client/router.d.ts.map +1 -1
  337. package/dist/client/rsc-fetch.d.ts +110 -28
  338. package/dist/client/rsc-fetch.d.ts.map +1 -1
  339. package/dist/client/segment-cache.d.ts +186 -25
  340. package/dist/client/segment-cache.d.ts.map +1 -1
  341. package/dist/client/segment-context.d.ts.map +1 -1
  342. package/dist/client/segment-outlet.d.ts +68 -0
  343. package/dist/client/segment-outlet.d.ts.map +1 -0
  344. package/dist/client/segment-update-context.d.ts +15 -0
  345. package/dist/client/segment-update-context.d.ts.map +1 -0
  346. package/dist/client/shallow-url.d.ts +10 -0
  347. package/dist/client/shallow-url.d.ts.map +1 -0
  348. package/dist/client/slot-content-cache-context.d.ts +35 -0
  349. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  350. package/dist/client/slot-context.d.ts +31 -0
  351. package/dist/client/slot-context.d.ts.map +1 -0
  352. package/dist/client/slot-outlet.d.ts +16 -0
  353. package/dist/client/slot-outlet.d.ts.map +1 -0
  354. package/dist/client/slot-provider.d.ts +25 -0
  355. package/dist/client/slot-provider.d.ts.map +1 -0
  356. package/dist/client/ssr-data.d.ts +26 -50
  357. package/dist/client/ssr-data.d.ts.map +1 -1
  358. package/dist/client/stale-client.d.ts +69 -0
  359. package/dist/client/stale-client.d.ts.map +1 -0
  360. package/dist/client/state.d.ts +21 -13
  361. package/dist/client/state.d.ts.map +1 -1
  362. package/dist/client/status-page-marker.d.ts +25 -0
  363. package/dist/client/status-page-marker.d.ts.map +1 -0
  364. package/dist/client/top-loader.d.ts +7 -6
  365. package/dist/client/top-loader.d.ts.map +1 -1
  366. package/dist/client/unload-guard.d.ts +5 -0
  367. package/dist/client/unload-guard.d.ts.map +1 -1
  368. package/dist/client/use-cookie.d.ts +12 -0
  369. package/dist/client/use-cookie.d.ts.map +1 -1
  370. package/dist/client/use-field-state.d.ts +42 -0
  371. package/dist/client/use-field-state.d.ts.map +1 -0
  372. package/dist/client/use-link-status.d.ts +5 -5
  373. package/dist/client/use-link-status.d.ts.map +1 -1
  374. package/dist/client/use-pathname.d.ts +13 -11
  375. package/dist/client/use-pathname.d.ts.map +1 -1
  376. package/dist/client/use-pending-navigation.d.ts +23 -0
  377. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  378. package/dist/client/use-query-states.d.ts +10 -4
  379. package/dist/client/use-query-states.d.ts.map +1 -1
  380. package/dist/client/use-router.d.ts +15 -8
  381. package/dist/client/use-router.d.ts.map +1 -1
  382. package/dist/client/use-search-params.d.ts +15 -8
  383. package/dist/client/use-search-params.d.ts.map +1 -1
  384. package/dist/client/use-segment-params.d.ts +55 -0
  385. package/dist/client/use-segment-params.d.ts.map +1 -0
  386. package/dist/codec.d.ts +69 -0
  387. package/dist/codec.d.ts.map +1 -0
  388. package/dist/codec.js +76 -0
  389. package/dist/codec.js.map +1 -0
  390. package/dist/config-types.d.ts +321 -0
  391. package/dist/config-types.d.ts.map +1 -0
  392. package/dist/config-validation.d.ts +68 -0
  393. package/dist/config-validation.d.ts.map +1 -0
  394. package/dist/cookies/define-cookie.d.ts +58 -25
  395. package/dist/cookies/define-cookie.d.ts.map +1 -1
  396. package/dist/cookies/index.d.ts +3 -2
  397. package/dist/cookies/index.d.ts.map +1 -1
  398. package/dist/cookies/index.js +256 -36
  399. package/dist/cookies/index.js.map +1 -1
  400. package/dist/cookies/json-cookie.d.ts +64 -0
  401. package/dist/cookies/json-cookie.d.ts.map +1 -0
  402. package/dist/cookies/validation.d.ts +34 -0
  403. package/dist/cookies/validation.d.ts.map +1 -0
  404. package/dist/dev-tools/404-page.d.ts +50 -0
  405. package/dist/dev-tools/404-page.d.ts.map +1 -0
  406. package/dist/dev-tools/browser-logs.d.ts +40 -0
  407. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  408. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  409. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  410. package/dist/dev-tools/error-page.d.ts +32 -0
  411. package/dist/dev-tools/error-page.d.ts.map +1 -0
  412. package/dist/dev-tools/holding-server.d.ts +46 -0
  413. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  414. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  415. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  416. package/dist/dev-tools/index.d.ts +31 -0
  417. package/dist/dev-tools/index.d.ts.map +1 -0
  418. package/dist/dev-tools/instrumentation.d.ts +74 -0
  419. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  420. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  421. package/dist/dev-tools/logger.d.ts.map +1 -0
  422. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  423. package/dist/dev-tools/logs.d.ts.map +1 -0
  424. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  425. package/dist/dev-tools/overlay.d.ts.map +1 -0
  426. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  427. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  428. package/dist/dev-tools/terminal.d.ts +28 -0
  429. package/dist/dev-tools/terminal.d.ts.map +1 -0
  430. package/dist/fonts/ast-walk.d.ts +68 -0
  431. package/dist/fonts/ast-walk.d.ts.map +1 -0
  432. package/dist/fonts/ast.d.ts +112 -8
  433. package/dist/fonts/ast.d.ts.map +1 -1
  434. package/dist/fonts/bundle.d.ts +50 -0
  435. package/dist/fonts/bundle.d.ts.map +1 -0
  436. package/dist/fonts/css.d.ts +1 -1
  437. package/dist/fonts/dev-middleware.d.ts +22 -0
  438. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  439. package/dist/fonts/fallbacks.d.ts +0 -7
  440. package/dist/fonts/fallbacks.d.ts.map +1 -1
  441. package/dist/fonts/google.d.ts +5 -3
  442. package/dist/fonts/google.d.ts.map +1 -1
  443. package/dist/fonts/local.d.ts +5 -5
  444. package/dist/fonts/local.d.ts.map +1 -1
  445. package/dist/fonts/paths.d.ts +43 -0
  446. package/dist/fonts/paths.d.ts.map +1 -0
  447. package/dist/fonts/pipeline.d.ts +177 -0
  448. package/dist/fonts/pipeline.d.ts.map +1 -0
  449. package/dist/fonts/transform.d.ts +82 -0
  450. package/dist/fonts/transform.d.ts.map +1 -0
  451. package/dist/fonts/types.d.ts +47 -1
  452. package/dist/fonts/types.d.ts.map +1 -1
  453. package/dist/fonts/virtual-modules.d.ts +77 -0
  454. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  455. package/dist/index.d.ts +35 -181
  456. package/dist/index.d.ts.map +1 -1
  457. package/dist/index.js +8972 -14234
  458. package/dist/index.js.map +1 -1
  459. package/dist/params/codec-registry.d.ts +26 -0
  460. package/dist/params/codec-registry.d.ts.map +1 -0
  461. package/dist/params/define-schema.d.ts +81 -0
  462. package/dist/params/define-schema.d.ts.map +1 -0
  463. package/dist/params/index.d.ts +5 -0
  464. package/dist/params/index.d.ts.map +1 -0
  465. package/dist/params/index.js +34 -0
  466. package/dist/params/index.js.map +1 -0
  467. package/dist/params/resolve-schema.d.ts +34 -0
  468. package/dist/params/resolve-schema.d.ts.map +1 -0
  469. package/dist/plugin-context.d.ts +262 -0
  470. package/dist/plugin-context.d.ts.map +1 -0
  471. package/dist/plugins/build-manifest.d.ts +7 -3
  472. package/dist/plugins/build-manifest.d.ts.map +1 -1
  473. package/dist/plugins/build-report.d.ts +61 -11
  474. package/dist/plugins/build-report.d.ts.map +1 -1
  475. package/dist/plugins/cache.d.ts +64 -0
  476. package/dist/plugins/cache.d.ts.map +1 -0
  477. package/dist/plugins/callsite-ast.d.ts +117 -0
  478. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  479. package/dist/plugins/callsite-jsx.d.ts +35 -0
  480. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  481. package/dist/plugins/chunks.d.ts +11 -4
  482. package/dist/plugins/chunks.d.ts.map +1 -1
  483. package/dist/plugins/client-chunks.d.ts +40 -0
  484. package/dist/plugins/client-chunks.d.ts.map +1 -0
  485. package/dist/plugins/client-dep-entries.d.ts +80 -0
  486. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  487. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  488. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  489. package/dist/plugins/content.d.ts +1 -1
  490. package/dist/plugins/content.d.ts.map +1 -1
  491. package/dist/plugins/dev-discovery.d.ts +123 -0
  492. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  493. package/dist/plugins/dev-server.d.ts +24 -1
  494. package/dist/plugins/dev-server.d.ts.map +1 -1
  495. package/dist/plugins/encryption-runtime.d.ts +13 -0
  496. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  497. package/dist/plugins/entries.d.ts +40 -4
  498. package/dist/plugins/entries.d.ts.map +1 -1
  499. package/dist/plugins/fonts.d.ts +35 -74
  500. package/dist/plugins/fonts.d.ts.map +1 -1
  501. package/dist/plugins/graph-endpoint.d.ts +112 -0
  502. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  503. package/dist/plugins/mdx.d.ts +18 -5
  504. package/dist/plugins/mdx.d.ts.map +1 -1
  505. package/dist/plugins/orphaned-modules.d.ts +57 -0
  506. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  507. package/dist/plugins/post-build.d.ts +110 -0
  508. package/dist/plugins/post-build.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  510. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  511. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  512. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  513. package/dist/plugins/prebuilt.d.ts +98 -0
  514. package/dist/plugins/prebuilt.d.ts.map +1 -0
  515. package/dist/plugins/prerender-sugar.d.ts +39 -0
  516. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  517. package/dist/plugins/react-resolve.d.ts +49 -0
  518. package/dist/plugins/react-resolve.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  520. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  521. package/dist/plugins/request-dep/index.d.ts +75 -0
  522. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  523. package/dist/plugins/request-dep/origin.d.ts +61 -0
  524. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  525. package/dist/plugins/routing.d.ts +2 -2
  526. package/dist/plugins/routing.d.ts.map +1 -1
  527. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  528. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  529. package/dist/plugins/server-bundle.d.ts +1 -1
  530. package/dist/plugins/server-bundle.d.ts.map +1 -1
  531. package/dist/plugins/shims.d.ts +29 -5
  532. package/dist/plugins/shims.d.ts.map +1 -1
  533. package/dist/plugins/static-build.d.ts +246 -26
  534. package/dist/plugins/static-build.d.ts.map +1 -1
  535. package/dist/routing/codegen-shared.d.ts +26 -0
  536. package/dist/routing/codegen-shared.d.ts.map +1 -0
  537. package/dist/routing/codegen-types.d.ts +61 -0
  538. package/dist/routing/codegen-types.d.ts.map +1 -0
  539. package/dist/routing/codegen-write.d.ts +42 -0
  540. package/dist/routing/codegen-write.d.ts.map +1 -0
  541. package/dist/routing/codegen.d.ts +8 -3
  542. package/dist/routing/codegen.d.ts.map +1 -1
  543. package/dist/routing/collision-probe.d.ts +104 -0
  544. package/dist/routing/collision-probe.d.ts.map +1 -0
  545. package/dist/routing/collision-spaces.d.ts +26 -0
  546. package/dist/routing/collision-spaces.d.ts.map +1 -0
  547. package/dist/routing/convention-lint.d.ts +55 -0
  548. package/dist/routing/convention-lint.d.ts.map +1 -0
  549. package/dist/routing/export-detect.d.ts +91 -0
  550. package/dist/routing/export-detect.d.ts.map +1 -0
  551. package/dist/routing/file-cache.d.ts +8 -0
  552. package/dist/routing/file-cache.d.ts.map +1 -0
  553. package/dist/routing/index.d.ts +13 -7
  554. package/dist/routing/index.d.ts.map +1 -1
  555. package/dist/routing/index.js +5 -2
  556. package/dist/routing/interception-overlap.d.ts +35 -0
  557. package/dist/routing/interception-overlap.d.ts.map +1 -0
  558. package/dist/routing/interception.d.ts +234 -10
  559. package/dist/routing/interception.d.ts.map +1 -1
  560. package/dist/routing/link-codegen.d.ts +105 -0
  561. package/dist/routing/link-codegen.d.ts.map +1 -0
  562. package/dist/routing/manifest-codegen.d.ts +26 -0
  563. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  564. package/dist/routing/scanner.d.ts +14 -10
  565. package/dist/routing/scanner.d.ts.map +1 -1
  566. package/dist/routing/schema-validation.d.ts +35 -0
  567. package/dist/routing/schema-validation.d.ts.map +1 -0
  568. package/dist/routing/segment-classify.d.ts +114 -0
  569. package/dist/routing/segment-classify.d.ts.map +1 -0
  570. package/dist/routing/segment-codegen.d.ts +38 -0
  571. package/dist/routing/segment-codegen.d.ts.map +1 -0
  572. package/dist/routing/segment-keys.d.ts +118 -0
  573. package/dist/routing/segment-keys.d.ts.map +1 -0
  574. package/dist/routing/slot-placement.d.ts +48 -0
  575. package/dist/routing/slot-placement.d.ts.map +1 -0
  576. package/dist/routing/types.d.ts +81 -26
  577. package/dist/routing/types.d.ts.map +1 -1
  578. package/dist/routing/walkers.d.ts +57 -0
  579. package/dist/routing/walkers.d.ts.map +1 -0
  580. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  581. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  582. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  583. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  584. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  585. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  586. package/dist/rsc-runtime/rsc.d.ts +2 -13
  587. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  588. package/dist/rsc-runtime/ssr.d.ts +7 -10
  589. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  590. package/dist/rsc-runtime/transforms.d.ts +13 -0
  591. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  592. package/dist/schema-bridge.d.ts +145 -0
  593. package/dist/schema-bridge.d.ts.map +1 -0
  594. package/dist/search-params/define.d.ts +262 -0
  595. package/dist/search-params/define.d.ts.map +1 -0
  596. package/dist/search-params/index.d.ts +3 -7
  597. package/dist/search-params/index.d.ts.map +1 -1
  598. package/dist/search-params/index.js +179 -360
  599. package/dist/search-params/index.js.map +1 -1
  600. package/dist/search-params/parse-total.d.ts +81 -0
  601. package/dist/search-params/parse-total.d.ts.map +1 -0
  602. package/dist/search-params/serialize-equal.d.ts +9 -0
  603. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  604. package/dist/search-params/wrappers.d.ts +76 -0
  605. package/dist/search-params/wrappers.d.ts.map +1 -0
  606. package/dist/server/abort-scope.d.ts +27 -0
  607. package/dist/server/abort-scope.d.ts.map +1 -0
  608. package/dist/server/access-gate.d.ts +98 -10
  609. package/dist/server/access-gate.d.ts.map +1 -1
  610. package/dist/server/action-client.d.ts +20 -133
  611. package/dist/server/action-client.d.ts.map +1 -1
  612. package/dist/server/action-encryption.d.ts +76 -0
  613. package/dist/server/action-encryption.d.ts.map +1 -0
  614. package/dist/server/action-handler.d.ts +58 -11
  615. package/dist/server/action-handler.d.ts.map +1 -1
  616. package/dist/server/action-schema.d.ts +126 -0
  617. package/dist/server/action-schema.d.ts.map +1 -0
  618. package/dist/server/action-types.d.ts +108 -0
  619. package/dist/server/action-types.d.ts.map +1 -0
  620. package/dist/server/actions.d.ts +78 -40
  621. package/dist/server/actions.d.ts.map +1 -1
  622. package/dist/server/als-registry.d.ts +189 -17
  623. package/dist/server/als-registry.d.ts.map +1 -1
  624. package/dist/server/body-limits.d.ts.map +1 -1
  625. package/dist/server/build-manifest.d.ts +25 -30
  626. package/dist/server/build-manifest.d.ts.map +1 -1
  627. package/dist/server/canonicalize.d.ts +32 -0
  628. package/dist/server/canonicalize.d.ts.map +1 -1
  629. package/dist/server/chain-url-parts.d.ts +82 -0
  630. package/dist/server/chain-url-parts.d.ts.map +1 -0
  631. package/dist/server/children-interception.d.ts +49 -0
  632. package/dist/server/children-interception.d.ts.map +1 -0
  633. package/dist/server/client-error-message.d.ts +12 -0
  634. package/dist/server/client-error-message.d.ts.map +1 -0
  635. package/dist/server/coalesce-tick.d.ts +40 -0
  636. package/dist/server/coalesce-tick.d.ts.map +1 -0
  637. package/dist/server/compress.d.ts +2 -0
  638. package/dist/server/compress.d.ts.map +1 -1
  639. package/dist/server/cookie-context.d.ts +149 -0
  640. package/dist/server/cookie-context.d.ts.map +1 -0
  641. package/dist/server/cookie-parsing.d.ts +65 -0
  642. package/dist/server/cookie-parsing.d.ts.map +1 -0
  643. package/dist/server/csp-nonce.d.ts +36 -0
  644. package/dist/server/csp-nonce.d.ts.map +1 -0
  645. package/dist/server/csrf.d.ts +58 -15
  646. package/dist/server/csrf.d.ts.map +1 -1
  647. package/dist/server/debug.d.ts +0 -1
  648. package/dist/server/debug.d.ts.map +1 -1
  649. package/dist/server/default-logger.d.ts +23 -0
  650. package/dist/server/default-logger.d.ts.map +1 -0
  651. package/dist/server/default-status-page.d.ts +45 -0
  652. package/dist/server/default-status-page.d.ts.map +1 -0
  653. package/dist/server/deny-boundary.d.ts +257 -0
  654. package/dist/server/deny-boundary.d.ts.map +1 -0
  655. package/dist/server/deny-renderer.d.ts +22 -15
  656. package/dist/server/deny-renderer.d.ts.map +1 -1
  657. package/dist/server/early-hints-sender.d.ts.map +1 -1
  658. package/dist/server/early-hints.d.ts +14 -12
  659. package/dist/server/early-hints.d.ts.map +1 -1
  660. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  661. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  662. package/dist/server/error-response-headers.d.ts +3 -0
  663. package/dist/server/error-response-headers.d.ts.map +1 -0
  664. package/dist/server/fallback-error.d.ts +19 -7
  665. package/dist/server/fallback-error.d.ts.map +1 -1
  666. package/dist/server/flight-injection-state.d.ts +66 -0
  667. package/dist/server/flight-injection-state.d.ts.map +1 -0
  668. package/dist/server/flight-injector-core.d.ts +125 -0
  669. package/dist/server/flight-injector-core.d.ts.map +1 -0
  670. package/dist/server/flight-scripts.d.ts +63 -0
  671. package/dist/server/flight-scripts.d.ts.map +1 -0
  672. package/dist/server/flight-source-node.d.ts +105 -0
  673. package/dist/server/flight-source-node.d.ts.map +1 -0
  674. package/dist/server/flight-source.d.ts +136 -0
  675. package/dist/server/flight-source.d.ts.map +1 -0
  676. package/dist/server/form-data.d.ts +59 -2
  677. package/dist/server/form-data.d.ts.map +1 -1
  678. package/dist/server/form-state-flight.d.ts +32 -0
  679. package/dist/server/form-state-flight.d.ts.map +1 -0
  680. package/dist/server/head-response.d.ts +35 -0
  681. package/dist/server/head-response.d.ts.map +1 -0
  682. package/dist/server/html-injector-core.d.ts +169 -0
  683. package/dist/server/html-injector-core.d.ts.map +1 -0
  684. package/dist/server/html-injectors.d.ts +77 -47
  685. package/dist/server/html-injectors.d.ts.map +1 -1
  686. package/dist/server/index.d.ts +16 -54
  687. package/dist/server/index.d.ts.map +1 -1
  688. package/dist/server/index.js +638 -3021
  689. package/dist/server/index.js.map +1 -1
  690. package/dist/server/instrumentation.d.ts +13 -5
  691. package/dist/server/instrumentation.d.ts.map +1 -1
  692. package/dist/server/internal.d.ts +47 -0
  693. package/dist/server/internal.d.ts.map +1 -0
  694. package/dist/server/internal.js +4845 -0
  695. package/dist/server/internal.js.map +1 -0
  696. package/dist/server/json-status-response.d.ts +34 -0
  697. package/dist/server/json-status-response.d.ts.map +1 -0
  698. package/dist/server/logger.d.ts +79 -7
  699. package/dist/server/logger.d.ts.map +1 -1
  700. package/dist/server/metadata-collector.d.ts +75 -0
  701. package/dist/server/metadata-collector.d.ts.map +1 -0
  702. package/dist/server/metadata-platform.d.ts +2 -2
  703. package/dist/server/metadata-render.d.ts +2 -2
  704. package/dist/server/metadata-render.d.ts.map +1 -1
  705. package/dist/server/metadata-route-links.d.ts +70 -0
  706. package/dist/server/metadata-route-links.d.ts.map +1 -0
  707. package/dist/server/metadata-routes.d.ts +47 -11
  708. package/dist/server/metadata-routes.d.ts.map +1 -1
  709. package/dist/server/metadata-social.d.ts +2 -2
  710. package/dist/server/metadata.d.ts +10 -2
  711. package/dist/server/metadata.d.ts.map +1 -1
  712. package/dist/server/middleware-runner.d.ts +20 -5
  713. package/dist/server/middleware-runner.d.ts.map +1 -1
  714. package/dist/server/node-body-response.d.ts +55 -0
  715. package/dist/server/node-body-response.d.ts.map +1 -0
  716. package/dist/server/node-response.d.ts +62 -0
  717. package/dist/server/node-response.d.ts.map +1 -0
  718. package/dist/server/node-stream-transforms.d.ts +108 -0
  719. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  720. package/dist/server/node-streams-platform.d.ts +21 -0
  721. package/dist/server/node-streams-platform.d.ts.map +1 -0
  722. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  723. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  724. package/dist/server/param-coercion.d.ts +83 -0
  725. package/dist/server/param-coercion.d.ts.map +1 -0
  726. package/dist/server/pipeline-helpers.d.ts +224 -0
  727. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  728. package/dist/server/pipeline-interception.d.ts +70 -9
  729. package/dist/server/pipeline-interception.d.ts.map +1 -1
  730. package/dist/server/pipeline-metadata.d.ts +16 -1
  731. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  732. package/dist/server/pipeline-outcome.d.ts +59 -0
  733. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  734. package/dist/server/pipeline-phases.d.ts +70 -0
  735. package/dist/server/pipeline-phases.d.ts.map +1 -0
  736. package/dist/server/pipeline.d.ts +164 -23
  737. package/dist/server/pipeline.d.ts.map +1 -1
  738. package/dist/server/port-resolution.d.ts +22 -0
  739. package/dist/server/port-resolution.d.ts.map +1 -0
  740. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  741. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  742. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  743. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  744. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  745. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  746. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  747. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  748. package/dist/server/prebuilt/dev-store.d.ts +103 -0
  749. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  750. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  751. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  752. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  753. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  754. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  755. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  756. package/dist/server/prebuilt/overlay.d.ts +105 -0
  757. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  758. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  759. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  760. package/dist/server/prebuilt/slots.d.ts +105 -0
  761. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  762. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  763. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  764. package/dist/server/prebuilt-builder.d.ts +121 -0
  765. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  766. package/dist/server/prebuilt-runtime.d.ts +105 -0
  767. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  768. package/dist/server/primitives.d.ts +101 -90
  769. package/dist/server/primitives.d.ts.map +1 -1
  770. package/dist/server/publish-params.d.ts +33 -0
  771. package/dist/server/publish-params.d.ts.map +1 -0
  772. package/dist/server/react-cache-bridge.d.ts +59 -0
  773. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  774. package/dist/server/react-cache-scope.d.ts +49 -0
  775. package/dist/server/react-cache-scope.d.ts.map +1 -0
  776. package/dist/server/render-timeout.d.ts +66 -0
  777. package/dist/server/render-timeout.d.ts.map +1 -0
  778. package/dist/server/render-utils.d.ts +35 -0
  779. package/dist/server/render-utils.d.ts.map +1 -0
  780. package/dist/server/request-context.d.ts +153 -103
  781. package/dist/server/request-context.d.ts.map +1 -1
  782. package/dist/server/request-dep.d.ts +15 -0
  783. package/dist/server/request-dep.d.ts.map +1 -0
  784. package/dist/server/response-cache-policy.d.ts +3 -0
  785. package/dist/server/response-cache-policy.d.ts.map +1 -0
  786. package/dist/server/route-element-builder.d.ts +57 -30
  787. package/dist/server/route-element-builder.d.ts.map +1 -1
  788. package/dist/server/route-element-helpers.d.ts +12 -0
  789. package/dist/server/route-element-helpers.d.ts.map +1 -0
  790. package/dist/server/route-handler.d.ts +1 -1
  791. package/dist/server/route-handler.d.ts.map +1 -1
  792. package/dist/server/route-matcher.d.ts +62 -38
  793. package/dist/server/route-matcher.d.ts.map +1 -1
  794. package/dist/server/route-module-loader.d.ts +37 -0
  795. package/dist/server/route-module-loader.d.ts.map +1 -0
  796. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  797. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  798. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  799. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  800. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  801. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  802. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  803. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  804. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  805. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  807. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  808. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  809. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/index.d.ts +30 -6
  811. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  813. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  814. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  815. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  816. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  817. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  818. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  819. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  820. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  821. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  822. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  823. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  824. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  825. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  826. package/dist/server/rsc-error-envelope.d.ts +11 -0
  827. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  828. package/dist/server/safe-load.d.ts +39 -0
  829. package/dist/server/safe-load.d.ts.map +1 -0
  830. package/dist/server/schema-introspection.d.ts +68 -0
  831. package/dist/server/schema-introspection.d.ts.map +1 -0
  832. package/dist/server/sensitive-fields.d.ts +88 -0
  833. package/dist/server/sensitive-fields.d.ts.map +1 -0
  834. package/dist/server/signal-identity.d.ts +43 -0
  835. package/dist/server/signal-identity.d.ts.map +1 -0
  836. package/dist/server/sitemap-generator.d.ts +130 -0
  837. package/dist/server/sitemap-generator.d.ts.map +1 -0
  838. package/dist/server/sitemap-handler.d.ts +22 -0
  839. package/dist/server/sitemap-handler.d.ts.map +1 -0
  840. package/dist/server/skippable-prefix.d.ts +29 -0
  841. package/dist/server/skippable-prefix.d.ts.map +1 -0
  842. package/dist/server/slot-interception.d.ts +80 -0
  843. package/dist/server/slot-interception.d.ts.map +1 -0
  844. package/dist/server/slot-resolver.d.ts +138 -7
  845. package/dist/server/slot-resolver.d.ts.map +1 -1
  846. package/dist/server/slot-subtree-contain.d.ts +54 -0
  847. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  848. package/dist/server/ssr-bridge-types.d.ts +213 -0
  849. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  850. package/dist/server/ssr-entry.d.ts +15 -51
  851. package/dist/server/ssr-entry.d.ts.map +1 -1
  852. package/dist/server/ssr-form-state.d.ts +30 -0
  853. package/dist/server/ssr-form-state.d.ts.map +1 -0
  854. package/dist/server/ssr-render.d.ts +59 -32
  855. package/dist/server/ssr-render.d.ts.map +1 -1
  856. package/dist/server/ssr-wrappers.d.ts +93 -0
  857. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  858. package/dist/server/state-tree-diff.d.ts +44 -9
  859. package/dist/server/state-tree-diff.d.ts.map +1 -1
  860. package/dist/server/static-generator.d.ts +112 -0
  861. package/dist/server/static-generator.d.ts.map +1 -0
  862. package/dist/server/static-not-found.d.ts +52 -0
  863. package/dist/server/static-not-found.d.ts.map +1 -0
  864. package/dist/server/status-code-resolver.d.ts +26 -15
  865. package/dist/server/status-code-resolver.d.ts.map +1 -1
  866. package/dist/server/stream-utils.d.ts +93 -0
  867. package/dist/server/stream-utils.d.ts.map +1 -0
  868. package/dist/server/tracing.d.ts +57 -26
  869. package/dist/server/tracing.d.ts.map +1 -1
  870. package/dist/server/tree-match.d.ts +59 -0
  871. package/dist/server/tree-match.d.ts.map +1 -0
  872. package/dist/server/types.d.ts +89 -8
  873. package/dist/server/types.d.ts.map +1 -1
  874. package/dist/server/utils/element-type.d.ts +50 -0
  875. package/dist/server/utils/element-type.d.ts.map +1 -0
  876. package/dist/server/utils/escape-html.d.ts +14 -0
  877. package/dist/server/utils/escape-html.d.ts.map +1 -0
  878. package/dist/server/version-skew.d.ts +61 -0
  879. package/dist/server/version-skew.d.ts.map +1 -0
  880. package/dist/server/workers-cache-bridge.d.ts +26 -0
  881. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  882. package/dist/shared/als-slots.d.ts +42 -0
  883. package/dist/shared/als-slots.d.ts.map +1 -0
  884. package/dist/shared/base-path.d.ts +56 -0
  885. package/dist/shared/base-path.d.ts.map +1 -0
  886. package/dist/shared/csrf-reject.d.ts +16 -0
  887. package/dist/shared/csrf-reject.d.ts.map +1 -0
  888. package/dist/shared/error-digest.d.ts +28 -0
  889. package/dist/shared/error-digest.d.ts.map +1 -0
  890. package/dist/shared/flight-base64.d.ts +13 -0
  891. package/dist/shared/flight-base64.d.ts.map +1 -0
  892. package/dist/shared/flight-segment.d.ts +18 -0
  893. package/dist/shared/flight-segment.d.ts.map +1 -0
  894. package/dist/shared/form-state-flight.d.ts +32 -0
  895. package/dist/shared/form-state-flight.d.ts.map +1 -0
  896. package/dist/shared/href-validation.d.ts +49 -0
  897. package/dist/shared/href-validation.d.ts.map +1 -0
  898. package/dist/shared/merge-search-params.d.ts +22 -0
  899. package/dist/shared/merge-search-params.d.ts.map +1 -0
  900. package/dist/shared/param-value.d.ts +104 -0
  901. package/dist/shared/param-value.d.ts.map +1 -0
  902. package/dist/shared/payload-root.d.ts +110 -0
  903. package/dist/shared/payload-root.d.ts.map +1 -0
  904. package/dist/shared/redirect-type.d.ts +17 -0
  905. package/dist/shared/redirect-type.d.ts.map +1 -0
  906. package/dist/shared/rsc-cache-key.d.ts +163 -0
  907. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  908. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  909. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  910. package/dist/shared/rsc-manifest.d.ts +28 -0
  911. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  912. package/dist/shared/rsc-media-type.d.ts +52 -0
  913. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  914. package/dist/shared/rsc-payload-path.d.ts +48 -0
  915. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  916. package/dist/shared/segment-info.d.ts +66 -0
  917. package/dist/shared/segment-info.d.ts.map +1 -0
  918. package/dist/shared/slot-params.d.ts +52 -0
  919. package/dist/shared/slot-params.d.ts.map +1 -0
  920. package/dist/shared/static-platform-files.d.ts +71 -0
  921. package/dist/shared/static-platform-files.d.ts.map +1 -0
  922. package/dist/shared/status-reason-phrase.d.ts +26 -0
  923. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  924. package/dist/shims/font-google.d.ts +1 -1
  925. package/dist/shims/font-google.d.ts.map +1 -1
  926. package/dist/shims/font-google.js +42 -0
  927. package/dist/shims/font-google.js.map +1 -0
  928. package/dist/shims/font-local.d.ts +26 -0
  929. package/dist/shims/font-local.d.ts.map +1 -0
  930. package/dist/shims/font-local.js +20 -0
  931. package/dist/shims/font-local.js.map +1 -0
  932. package/dist/shims/headers.d.ts +53 -1
  933. package/dist/shims/headers.d.ts.map +1 -1
  934. package/dist/shims/image.d.ts +120 -120
  935. package/dist/shims/image.d.ts.map +1 -1
  936. package/dist/shims/navigation-client.d.ts +25 -12
  937. package/dist/shims/navigation-client.d.ts.map +1 -1
  938. package/dist/shims/navigation-rsc.d.ts +21 -0
  939. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  940. package/dist/shims/navigation.d.ts +10 -5
  941. package/dist/shims/navigation.d.ts.map +1 -1
  942. package/dist/utils/state-machine.d.ts +80 -0
  943. package/dist/utils/state-machine.d.ts.map +1 -0
  944. package/dist/utils/write-file-atomic.d.ts +17 -0
  945. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  946. package/docs/api/30-api-server.mdx +239 -0
  947. package/docs/api/31-api-client.mdx +199 -0
  948. package/docs/api/32-api-cache.mdx +341 -0
  949. package/docs/api/33-api-search-params.mdx +176 -0
  950. package/docs/api/34-api-config.mdx +359 -0
  951. package/docs/api/35-api-typescript.mdx +91 -0
  952. package/docs/api/36-cli.mdx +206 -0
  953. package/docs/learn/00-introduction.mdx +109 -0
  954. package/docs/learn/01-quick-start.mdx +94 -0
  955. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  956. package/docs/learn/03-fetching-data.mdx +227 -0
  957. package/docs/learn/04-access-control.mdx +115 -0
  958. package/docs/learn/05-the-flush-point.mdx +175 -0
  959. package/docs/learn/06-typed-params.mdx +275 -0
  960. package/docs/learn/07-typed-routes.mdx +108 -0
  961. package/docs/learn/08-forms-and-actions.mdx +260 -0
  962. package/docs/learn/09-streaming.mdx +140 -0
  963. package/docs/learn/10-caching.mdx +282 -0
  964. package/docs/learn/11-middleware.mdx +166 -0
  965. package/docs/learn/12-error-handling.mdx +192 -0
  966. package/docs/learn/13-deploying.mdx +289 -0
  967. package/llms.txt +55 -0
  968. package/package.json +120 -29
  969. package/src/adapters/build-output-helper.ts +353 -0
  970. package/src/adapters/canonicalize-module.ts +29 -0
  971. package/src/adapters/cloudflare-dev.ts +183 -0
  972. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  973. package/src/adapters/cloudflare.ts +809 -150
  974. package/src/adapters/compress-module.ts +110 -86
  975. package/src/adapters/fs-identity.ts +155 -0
  976. package/src/adapters/nitro-immutable-assets.ts +142 -0
  977. package/src/adapters/nitro-presets.ts +124 -0
  978. package/src/adapters/nitro-preview.ts +533 -0
  979. package/src/adapters/nitro.ts +331 -445
  980. package/src/adapters/raw-imports.d.ts +5 -0
  981. package/src/adapters/shared.ts +283 -0
  982. package/src/adapters/types.ts +129 -17
  983. package/src/adapters/wrangler.d.ts +7 -0
  984. package/src/analyze/chains.ts +411 -0
  985. package/src/analyze/classify.ts +259 -0
  986. package/src/analyze/crawl-entry.ts +68 -0
  987. package/src/analyze/crawl.ts +500 -0
  988. package/src/analyze/graph-cache.ts +331 -0
  989. package/src/analyze/graph-command.ts +762 -0
  990. package/src/analyze/live-graph.ts +232 -0
  991. package/src/analyze/poison-rules.ts +165 -0
  992. package/src/analyze/poison-scan.ts +159 -0
  993. package/src/analyze/scan.ts +149 -0
  994. package/src/cache/cache-api.ts +113 -0
  995. package/src/cache/fast-hash.ts +5 -0
  996. package/src/cache/handler-store.ts +113 -0
  997. package/src/cache/index.ts +115 -22
  998. package/src/cache/invalidation-epoch.ts +105 -0
  999. package/src/cache/json-lossy-check.ts +69 -0
  1000. package/src/cache/redis-handler.ts +198 -20
  1001. package/src/cache/singleflight.ts +72 -6
  1002. package/src/cache/sizeof.ts +35 -0
  1003. package/src/cache/stable-stringify.ts +65 -2
  1004. package/src/cache/store.ts +71 -0
  1005. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1006. package/src/cache/stores/memory.ts +125 -0
  1007. package/src/cache/stores/redis.ts +97 -0
  1008. package/src/cache/stores/vercel.ts +59 -0
  1009. package/src/cache/tag-aware-handler.ts +254 -0
  1010. package/src/cache/timber-cache.ts +169 -40
  1011. package/src/cdn/cloudflare-purge.ts +50 -0
  1012. package/src/cdn/fastly-purge.ts +63 -0
  1013. package/src/cdn/headers.ts +153 -0
  1014. package/src/cdn/index.ts +23 -0
  1015. package/src/cdn/purge-store.ts +62 -0
  1016. package/src/cdn/workers-cache-purge.ts +34 -0
  1017. package/src/cli-check.ts +417 -0
  1018. package/src/cli-context.ts +119 -0
  1019. package/src/cli-schema-sync.ts +401 -0
  1020. package/src/cli.ts +334 -80
  1021. package/src/client/browser-dev.ts +192 -5
  1022. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1023. package/src/client/browser-entry/action-queue.ts +152 -0
  1024. package/src/client/browser-entry/form-state.ts +49 -0
  1025. package/src/client/browser-entry/hmr.ts +70 -0
  1026. package/src/client/browser-entry/hydrate.ts +152 -0
  1027. package/src/client/browser-entry/index.ts +150 -0
  1028. package/src/client/browser-entry/post-hydration.ts +99 -0
  1029. package/src/client/browser-entry/router-init.ts +391 -0
  1030. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1031. package/src/client/browser-entry/scroll.ts +50 -0
  1032. package/src/client/deny-last-resort.tsx +54 -0
  1033. package/src/client/error-boundary.tsx +279 -61
  1034. package/src/client/error-reconstituter.tsx +84 -0
  1035. package/src/client/form.tsx +61 -173
  1036. package/src/client/global-context.ts +31 -0
  1037. package/src/client/history.ts +74 -11
  1038. package/src/client/index.ts +90 -53
  1039. package/src/client/internal.ts +54 -0
  1040. package/src/client/link.tsx +464 -151
  1041. package/src/client/location-search.ts +15 -0
  1042. package/src/client/navigation-api.ts +254 -0
  1043. package/src/client/navigation-commit.ts +318 -0
  1044. package/src/client/navigation-context.ts +67 -134
  1045. package/src/client/navigation-root.tsx +236 -0
  1046. package/src/client/navigation-transition.ts +401 -0
  1047. package/src/client/nuqs-adapter.tsx +21 -9
  1048. package/src/client/params-context.ts +187 -0
  1049. package/src/client/react-root.ts +105 -0
  1050. package/src/client/router-effects.ts +349 -0
  1051. package/src/client/router-lifecycle.ts +374 -0
  1052. package/src/client/router-pipeline.ts +443 -0
  1053. package/src/client/router-ref.ts +3 -3
  1054. package/src/client/router-skew.ts +30 -0
  1055. package/src/client/router-types.ts +326 -0
  1056. package/src/client/router-url.ts +32 -0
  1057. package/src/client/router.ts +491 -421
  1058. package/src/client/rsc-fetch.ts +510 -109
  1059. package/src/client/segment-cache.ts +362 -41
  1060. package/src/client/segment-context.ts +7 -4
  1061. package/src/client/segment-outlet.tsx +96 -0
  1062. package/src/client/segment-update-context.ts +23 -0
  1063. package/src/client/shallow-url.ts +22 -0
  1064. package/src/client/slot-content-cache-context.ts +43 -0
  1065. package/src/client/slot-context.ts +50 -0
  1066. package/src/client/slot-outlet.tsx +22 -0
  1067. package/src/client/slot-provider.tsx +32 -0
  1068. package/src/client/ssr-data.ts +27 -67
  1069. package/src/client/stale-client.ts +191 -0
  1070. package/src/client/state.ts +31 -24
  1071. package/src/client/status-page-marker.tsx +32 -0
  1072. package/src/client/top-loader.tsx +13 -10
  1073. package/src/client/unload-guard.ts +35 -3
  1074. package/src/client/use-cookie.ts +70 -18
  1075. package/src/client/use-field-state.ts +144 -0
  1076. package/src/client/use-link-status.ts +7 -7
  1077. package/src/client/use-pathname.ts +22 -31
  1078. package/src/client/use-pending-navigation.ts +40 -0
  1079. package/src/client/use-query-states.ts +206 -36
  1080. package/src/client/use-router.ts +31 -9
  1081. package/src/client/use-search-params.ts +38 -49
  1082. package/src/client/use-segment-params.ts +69 -0
  1083. package/src/client/use-selected-layout-segment.ts +2 -2
  1084. package/src/codec.ts +149 -0
  1085. package/src/config-types.ts +321 -0
  1086. package/src/config-validation.ts +464 -0
  1087. package/src/cookies/define-cookie.ts +222 -53
  1088. package/src/cookies/index.ts +13 -2
  1089. package/src/cookies/json-cookie.ts +105 -0
  1090. package/src/cookies/validation.ts +192 -0
  1091. package/src/dev-tools/404-page.ts +286 -0
  1092. package/src/dev-tools/browser-logs.ts +55 -0
  1093. package/src/dev-tools/dev-page-shell.ts +278 -0
  1094. package/src/dev-tools/error-page.ts +331 -0
  1095. package/src/dev-tools/holding-server.ts +185 -0
  1096. package/src/dev-tools/hydration-overlay.ts +158 -0
  1097. package/src/dev-tools/index.ts +79 -0
  1098. package/src/dev-tools/instrumentation.ts +261 -0
  1099. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1100. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +147 -25
  1101. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1102. package/src/dev-tools/stack-classifier.ts +75 -0
  1103. package/src/dev-tools/terminal.ts +182 -0
  1104. package/src/fonts/ast-walk.ts +235 -0
  1105. package/src/fonts/ast.ts +479 -128
  1106. package/src/fonts/bundle.ts +138 -0
  1107. package/src/fonts/css.ts +1 -1
  1108. package/src/fonts/dev-middleware.ts +85 -0
  1109. package/src/fonts/fallbacks.ts +0 -23
  1110. package/src/fonts/google.ts +101 -19
  1111. package/src/fonts/local.ts +12 -11
  1112. package/src/fonts/paths.ts +58 -0
  1113. package/src/fonts/pipeline.ts +348 -0
  1114. package/src/fonts/transform.ts +311 -0
  1115. package/src/fonts/types.ts +52 -1
  1116. package/src/fonts/virtual-modules.ts +179 -0
  1117. package/src/index.ts +492 -380
  1118. package/src/params/codec-registry.ts +34 -0
  1119. package/src/params/define-schema.ts +115 -0
  1120. package/src/params/index.ts +17 -0
  1121. package/src/params/resolve-schema.ts +84 -0
  1122. package/src/plugin-context.ts +502 -0
  1123. package/src/plugins/build-manifest.ts +189 -36
  1124. package/src/plugins/build-report.ts +299 -87
  1125. package/src/plugins/cache.ts +243 -0
  1126. package/src/plugins/callsite-ast.ts +472 -0
  1127. package/src/plugins/callsite-jsx.ts +243 -0
  1128. package/src/plugins/chunks.ts +74 -5
  1129. package/src/plugins/client-chunks.ts +185 -0
  1130. package/src/plugins/client-dep-entries.ts +124 -0
  1131. package/src/plugins/cloudflare-wasm.ts +141 -0
  1132. package/src/plugins/content.ts +31 -2
  1133. package/src/plugins/dev-discovery.ts +218 -0
  1134. package/src/plugins/dev-server.ts +376 -98
  1135. package/src/plugins/encryption-runtime.ts +31 -0
  1136. package/src/plugins/entries.ts +156 -17
  1137. package/src/plugins/fonts.ts +260 -657
  1138. package/src/plugins/graph-endpoint.ts +532 -0
  1139. package/src/plugins/mdx.ts +108 -35
  1140. package/src/plugins/orphaned-modules.ts +78 -0
  1141. package/src/plugins/post-build.ts +327 -0
  1142. package/src/plugins/prebuilt-capture.ts +213 -0
  1143. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1144. package/src/plugins/prebuilt.ts +670 -0
  1145. package/src/plugins/prerender-sugar.ts +348 -0
  1146. package/src/plugins/react-resolve.ts +149 -0
  1147. package/src/plugins/request-dep/analysis.ts +447 -0
  1148. package/src/plugins/request-dep/index.ts +376 -0
  1149. package/src/plugins/request-dep/origin.ts +310 -0
  1150. package/src/plugins/routing.ts +296 -278
  1151. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1152. package/src/plugins/server-bundle.ts +115 -15
  1153. package/src/plugins/shims.ts +257 -97
  1154. package/src/plugins/static-build.ts +681 -71
  1155. package/src/react-canary.d.ts +2 -0
  1156. package/src/routing/codegen-shared.ts +39 -0
  1157. package/src/routing/codegen-types.ts +62 -0
  1158. package/src/routing/codegen-write.ts +163 -0
  1159. package/src/routing/codegen.ts +349 -232
  1160. package/src/routing/collision-probe.ts +438 -0
  1161. package/src/routing/collision-spaces.ts +281 -0
  1162. package/src/routing/convention-lint.ts +651 -0
  1163. package/src/routing/export-detect.ts +536 -0
  1164. package/src/routing/file-cache.ts +23 -0
  1165. package/src/routing/index.ts +16 -7
  1166. package/src/routing/interception-overlap.ts +141 -0
  1167. package/src/routing/interception.ts +1044 -67
  1168. package/src/routing/link-codegen.ts +280 -0
  1169. package/src/routing/manifest-codegen.ts +232 -0
  1170. package/src/routing/scanner.ts +417 -223
  1171. package/src/routing/schema-validation.ts +155 -0
  1172. package/src/routing/segment-classify.ts +280 -0
  1173. package/src/routing/segment-codegen.ts +99 -0
  1174. package/src/routing/segment-keys.ts +186 -0
  1175. package/src/routing/slot-placement.ts +97 -0
  1176. package/src/routing/types.ts +82 -26
  1177. package/src/routing/walkers.ts +98 -0
  1178. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1179. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1180. package/src/rsc-runtime/render-flight.ts +26 -0
  1181. package/src/rsc-runtime/rsc.ts +27 -2
  1182. package/src/rsc-runtime/ssr.ts +23 -0
  1183. package/src/rsc-runtime/transforms.ts +13 -0
  1184. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1185. package/src/schema-bridge.ts +382 -0
  1186. package/src/search-params/define.ts +677 -0
  1187. package/src/search-params/index.ts +14 -20
  1188. package/src/search-params/parse-total.ts +91 -0
  1189. package/src/search-params/serialize-equal.ts +14 -0
  1190. package/src/search-params/wrappers.ts +150 -0
  1191. package/src/server/abort-scope.ts +49 -0
  1192. package/src/server/access-gate.tsx +195 -56
  1193. package/src/server/action-client.ts +175 -294
  1194. package/src/server/action-encryption.ts +144 -0
  1195. package/src/server/action-handler.ts +492 -150
  1196. package/src/server/action-schema.ts +203 -0
  1197. package/src/server/action-types.ts +145 -0
  1198. package/src/server/actions.ts +172 -85
  1199. package/src/server/als-registry.ts +245 -30
  1200. package/src/server/body-limits.ts +10 -2
  1201. package/src/server/build-manifest.ts +33 -57
  1202. package/src/server/canonicalize.ts +35 -3
  1203. package/src/server/chain-url-parts.ts +163 -0
  1204. package/src/server/children-interception.ts +116 -0
  1205. package/src/server/client-error-message.ts +18 -0
  1206. package/src/server/coalesce-tick.ts +75 -0
  1207. package/src/server/compress.ts +91 -19
  1208. package/src/server/cookie-context.ts +454 -0
  1209. package/src/server/cookie-parsing.ts +163 -0
  1210. package/src/server/csp-nonce.ts +58 -0
  1211. package/src/server/csrf.ts +228 -35
  1212. package/src/server/debug.ts +0 -1
  1213. package/src/server/default-logger.ts +100 -0
  1214. package/src/server/default-status-page.ts +88 -0
  1215. package/src/server/deny-boundary.ts +527 -0
  1216. package/src/server/deny-renderer.ts +210 -181
  1217. package/src/server/early-hints-sender.ts +4 -3
  1218. package/src/server/early-hints.ts +39 -29
  1219. package/src/server/error-boundary-wrapper.ts +160 -44
  1220. package/src/server/error-response-headers.ts +18 -0
  1221. package/src/server/fallback-error.ts +88 -104
  1222. package/src/server/flight-injection-state.ts +113 -0
  1223. package/src/server/flight-injector-core.ts +328 -0
  1224. package/src/server/flight-scripts.ts +92 -0
  1225. package/src/server/flight-source-node.ts +431 -0
  1226. package/src/server/flight-source.ts +288 -0
  1227. package/src/server/form-data.ts +191 -20
  1228. package/src/server/form-state-flight.ts +67 -0
  1229. package/src/server/head-response.ts +50 -0
  1230. package/src/server/html-injector-core.ts +320 -0
  1231. package/src/server/html-injectors.ts +241 -285
  1232. package/src/server/index.ts +37 -195
  1233. package/src/server/instrumentation.ts +42 -11
  1234. package/src/server/internal.ts +163 -0
  1235. package/src/server/json-status-response.ts +105 -0
  1236. package/src/server/logger.ts +131 -38
  1237. package/src/server/metadata-collector.ts +175 -0
  1238. package/src/server/metadata-platform.ts +2 -2
  1239. package/src/server/metadata-render.ts +30 -8
  1240. package/src/server/metadata-route-links.ts +200 -0
  1241. package/src/server/metadata-routes.ts +114 -24
  1242. package/src/server/metadata-social.ts +2 -2
  1243. package/src/server/metadata.ts +23 -2
  1244. package/src/server/middleware-runner.ts +32 -5
  1245. package/src/server/node-body-response.ts +236 -0
  1246. package/src/server/node-response.ts +93 -0
  1247. package/src/server/node-stream-transforms.ts +340 -0
  1248. package/src/server/node-streams-platform.ts +23 -0
  1249. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1250. package/src/server/param-coercion.ts +201 -0
  1251. package/src/server/pipeline-helpers.ts +550 -0
  1252. package/src/server/pipeline-interception.ts +241 -32
  1253. package/src/server/pipeline-metadata.ts +25 -1
  1254. package/src/server/pipeline-outcome.ts +290 -0
  1255. package/src/server/pipeline-phases.ts +503 -0
  1256. package/src/server/pipeline.ts +435 -427
  1257. package/src/server/port-resolution.ts +43 -0
  1258. package/src/server/prebuilt/cache-key.ts +340 -0
  1259. package/src/server/prebuilt/capture-render.ts +122 -0
  1260. package/src/server/prebuilt/capture-routes.ts +104 -0
  1261. package/src/server/prebuilt/capture-state.ts +196 -0
  1262. package/src/server/prebuilt/dev-store.ts +173 -0
  1263. package/src/server/prebuilt/key-discipline.ts +122 -0
  1264. package/src/server/prebuilt/lifetime.ts +151 -0
  1265. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1266. package/src/server/prebuilt/overlay.ts +262 -0
  1267. package/src/server/prebuilt/payload-source.ts +221 -0
  1268. package/src/server/prebuilt/slots.ts +201 -0
  1269. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1270. package/src/server/prebuilt-builder.ts +515 -0
  1271. package/src/server/prebuilt-runtime.ts +808 -0
  1272. package/src/server/primitives.ts +153 -171
  1273. package/src/server/publish-params.ts +42 -0
  1274. package/src/server/react-cache-bridge.ts +124 -0
  1275. package/src/server/react-cache-scope.ts +104 -0
  1276. package/src/server/render-timeout.ts +123 -0
  1277. package/src/server/render-utils.ts +45 -0
  1278. package/src/server/request-context.ts +298 -324
  1279. package/src/server/request-dep.ts +37 -0
  1280. package/src/server/response-cache-policy.ts +45 -0
  1281. package/src/server/route-element-builder.ts +526 -355
  1282. package/src/server/route-element-helpers.ts +37 -0
  1283. package/src/server/route-handler.ts +67 -27
  1284. package/src/server/route-matcher.ts +238 -267
  1285. package/src/server/route-module-loader.ts +161 -0
  1286. package/src/server/rsc-cache-key-guard.ts +122 -0
  1287. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1288. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1289. package/src/server/rsc-entry/api-handler.ts +49 -81
  1290. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1291. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1292. package/src/server/rsc-entry/helpers.ts +90 -115
  1293. package/src/server/rsc-entry/index.ts +405 -349
  1294. package/src/server/rsc-entry/render-route.ts +248 -0
  1295. package/src/server/rsc-entry/render-signals.ts +108 -0
  1296. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1297. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1298. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1299. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1300. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1301. package/src/server/rsc-error-envelope.ts +18 -0
  1302. package/src/server/rsc-prop-warnings.ts +1 -1
  1303. package/src/server/safe-load.ts +53 -0
  1304. package/src/server/schema-introspection.ts +393 -0
  1305. package/src/server/sensitive-fields.ts +287 -0
  1306. package/src/server/server-only-guard-noop.js +3 -0
  1307. package/src/server/server-timing.ts +1 -1
  1308. package/src/server/signal-identity.ts +112 -0
  1309. package/src/server/sitemap-generator.ts +337 -0
  1310. package/src/server/sitemap-handler.ts +150 -0
  1311. package/src/server/skippable-prefix.ts +172 -0
  1312. package/src/server/slot-interception.ts +168 -0
  1313. package/src/server/slot-resolver.ts +707 -300
  1314. package/src/server/slot-subtree-contain.ts +273 -0
  1315. package/src/server/ssr-bridge-types.ts +217 -0
  1316. package/src/server/ssr-entry.ts +248 -109
  1317. package/src/server/ssr-form-state.ts +58 -0
  1318. package/src/server/ssr-render.ts +332 -101
  1319. package/src/server/ssr-wrappers.tsx +162 -0
  1320. package/src/server/state-tree-diff.ts +85 -30
  1321. package/src/server/static-generator.ts +680 -0
  1322. package/src/server/static-not-found.ts +134 -0
  1323. package/src/server/status-code-resolver.ts +107 -148
  1324. package/src/server/stream-utils.ts +398 -0
  1325. package/src/server/tracing.ts +163 -68
  1326. package/src/server/tree-match.ts +494 -0
  1327. package/src/server/types.ts +96 -11
  1328. package/src/server/utils/element-type.ts +88 -0
  1329. package/src/server/utils/escape-html.ts +20 -0
  1330. package/src/server/version-skew.ts +104 -0
  1331. package/src/server/waituntil-bridge.ts +1 -1
  1332. package/src/server/workers-cache-bridge.ts +33 -0
  1333. package/src/shared/als-slots.ts +74 -0
  1334. package/src/shared/base-path.ts +80 -0
  1335. package/src/shared/csrf-reject.ts +15 -0
  1336. package/src/shared/error-digest.ts +46 -0
  1337. package/src/shared/flight-base64.ts +23 -0
  1338. package/src/shared/flight-segment.ts +35 -0
  1339. package/src/shared/form-state-flight.ts +59 -0
  1340. package/src/shared/href-validation.ts +159 -0
  1341. package/src/shared/merge-search-params.ts +55 -0
  1342. package/src/shared/param-value.ts +281 -0
  1343. package/src/shared/payload-root.ts +153 -0
  1344. package/src/shared/redirect-type.ts +17 -0
  1345. package/src/shared/rsc-cache-key.ts +269 -0
  1346. package/src/shared/rsc-error-envelope.ts +16 -0
  1347. package/src/shared/rsc-manifest.ts +29 -0
  1348. package/src/shared/rsc-media-type.ts +59 -0
  1349. package/src/shared/rsc-payload-path.ts +52 -0
  1350. package/src/shared/segment-info.ts +67 -0
  1351. package/src/shared/slot-params.ts +109 -0
  1352. package/src/shared/static-platform-files.ts +75 -0
  1353. package/src/shared/status-reason-phrase.ts +61 -0
  1354. package/src/shims/font-google.ts +1 -1
  1355. package/src/shims/font-local.ts +34 -0
  1356. package/src/shims/headers.ts +122 -1
  1357. package/src/shims/navigation-client.ts +36 -32
  1358. package/src/shims/navigation-rsc.ts +47 -0
  1359. package/src/shims/navigation.ts +10 -7
  1360. package/src/utils/state-machine.ts +111 -0
  1361. package/src/utils/write-file-atomic.ts +32 -0
  1362. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1363. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1364. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1365. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1366. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1367. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1368. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1369. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1370. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1371. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1372. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1373. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1374. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1375. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1376. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1377. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1378. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1379. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1380. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1381. package/dist/adapters/cloudflare.js.map +0 -1
  1382. package/dist/cache/index.js.map +0 -1
  1383. package/dist/cache/register-cached-function.d.ts +0 -17
  1384. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1385. package/dist/client/browser-entry.d.ts +0 -21
  1386. package/dist/client/browser-entry.d.ts.map +0 -1
  1387. package/dist/client/error-boundary.js.map +0 -1
  1388. package/dist/client/head.d.ts +0 -16
  1389. package/dist/client/head.d.ts.map +0 -1
  1390. package/dist/client/link-status-provider.d.ts +0 -11
  1391. package/dist/client/link-status-provider.d.ts.map +0 -1
  1392. package/dist/client/segment-merger.d.ts +0 -119
  1393. package/dist/client/segment-merger.d.ts.map +0 -1
  1394. package/dist/client/stale-reload.d.ts +0 -44
  1395. package/dist/client/stale-reload.d.ts.map +0 -1
  1396. package/dist/client/transition-root.d.ts +0 -74
  1397. package/dist/client/transition-root.d.ts.map +0 -1
  1398. package/dist/client/types.d.ts +0 -14
  1399. package/dist/client/types.d.ts.map +0 -1
  1400. package/dist/client/use-navigation-pending.d.ts +0 -26
  1401. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1402. package/dist/client/use-params.d.ts +0 -92
  1403. package/dist/client/use-params.d.ts.map +0 -1
  1404. package/dist/content/index.d.ts +0 -11
  1405. package/dist/content/index.d.ts.map +0 -1
  1406. package/dist/content/index.js +0 -2
  1407. package/dist/plugins/adapter-build.d.ts +0 -18
  1408. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1409. package/dist/plugins/cache-transform.d.ts +0 -36
  1410. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1411. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1412. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1413. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1414. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1415. package/dist/plugins/server-action-exports.d.ts +0 -26
  1416. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1417. package/dist/routing/status-file-lint.d.ts +0 -33
  1418. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1419. package/dist/search-params/analyze.d.ts +0 -54
  1420. package/dist/search-params/analyze.d.ts.map +0 -1
  1421. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1422. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1423. package/dist/search-params/codecs.d.ts +0 -53
  1424. package/dist/search-params/codecs.d.ts.map +0 -1
  1425. package/dist/search-params/create.d.ts +0 -106
  1426. package/dist/search-params/create.d.ts.map +0 -1
  1427. package/dist/search-params/registry.d.ts +0 -20
  1428. package/dist/search-params/registry.d.ts.map +0 -1
  1429. package/dist/server/asset-headers.d.ts +0 -42
  1430. package/dist/server/asset-headers.d.ts.map +0 -1
  1431. package/dist/server/client-module-map.d.ts +0 -47
  1432. package/dist/server/client-module-map.d.ts.map +0 -1
  1433. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1434. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1435. package/dist/server/dev-logger.d.ts.map +0 -1
  1436. package/dist/server/dev-span-processor.d.ts +0 -29
  1437. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1438. package/dist/server/dev-warnings.d.ts +0 -129
  1439. package/dist/server/dev-warnings.d.ts.map +0 -1
  1440. package/dist/server/flush.d.ts +0 -74
  1441. package/dist/server/flush.d.ts.map +0 -1
  1442. package/dist/server/form-flash.d.ts +0 -78
  1443. package/dist/server/form-flash.d.ts.map +0 -1
  1444. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1445. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1446. package/dist/server/prerender.d.ts +0 -77
  1447. package/dist/server/prerender.d.ts.map +0 -1
  1448. package/dist/server/tree-builder.d.ts +0 -126
  1449. package/dist/server/tree-builder.d.ts.map +0 -1
  1450. package/dist/utils/directive-parser.d.ts +0 -70
  1451. package/dist/utils/directive-parser.d.ts.map +0 -1
  1452. package/src/cache/register-cached-function.ts +0 -103
  1453. package/src/client/browser-entry.ts +0 -678
  1454. package/src/client/head.ts +0 -61
  1455. package/src/client/link-status-provider.tsx +0 -30
  1456. package/src/client/segment-merger.ts +0 -339
  1457. package/src/client/stale-reload.ts +0 -87
  1458. package/src/client/transition-root.tsx +0 -166
  1459. package/src/client/types.ts +0 -21
  1460. package/src/client/use-navigation-pending.ts +0 -38
  1461. package/src/client/use-params.ts +0 -141
  1462. package/src/content/index.ts +0 -13
  1463. package/src/plugins/adapter-build.ts +0 -118
  1464. package/src/plugins/cache-transform.ts +0 -199
  1465. package/src/plugins/dynamic-transform.ts +0 -161
  1466. package/src/plugins/server-action-exports.ts +0 -220
  1467. package/src/routing/status-file-lint.ts +0 -112
  1468. package/src/search-params/analyze.ts +0 -192
  1469. package/src/search-params/builtin-codecs.ts +0 -228
  1470. package/src/search-params/codecs.ts +0 -153
  1471. package/src/search-params/create.ts +0 -321
  1472. package/src/search-params/registry.ts +0 -31
  1473. package/src/server/asset-headers.ts +0 -81
  1474. package/src/server/client-module-map.ts +0 -58
  1475. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1476. package/src/server/dev-span-processor.ts +0 -78
  1477. package/src/server/dev-warnings.ts +0 -283
  1478. package/src/server/flush.ts +0 -182
  1479. package/src/server/form-flash.ts +0 -89
  1480. package/src/server/manifest-status-resolver.ts +0 -215
  1481. package/src/server/prerender.ts +0 -139
  1482. package/src/server/tree-builder.ts +0 -382
  1483. package/src/shims/server-only-noop.js +0 -6
  1484. package/src/utils/directive-parser.ts +0 -529
@@ -0,0 +1,808 @@
1
+ /**
2
+ * Prebuilt component runtime — registration target for the timber-prebuilt
3
+ * transform (plugins/prebuilt.ts) and the request-time half of
4
+ * cache.component (TIM-1140).
5
+ *
6
+ * `cache.component(fn, opts)` call sites are rewritten at build time to
7
+ * `__prebuilt(stableId, fn, opts)`, in dev and production alike. It is
8
+ * exported via #server-internal — framework plumbing, never called by user
9
+ * code directly. In dev the build artifact is replaced by the in-memory dev
10
+ * store (prebuilt/dev-store.ts): a prerender entry is captured on its first
11
+ * request and served until a watched file changes (TIM-1588).
12
+ *
13
+ * Cache hits are served by FLIGHT REVIVAL: the cached `.flight` payload is
14
+ * decoded back into React elements inside the RSC environment with
15
+ * `createFromReadableStream` (the flight client running in the flight
16
+ * server — plugin-rsc wires the server-decode manifest so client
17
+ * references revive as re-serializable reference proxies). The revived
18
+ * element is returned from the wrapper and the outer render re-serializes
19
+ * it like any other subtree. This is the same mechanism as Next.js
20
+ * `"use cache"` (next/src/server/use-cache/use-cache-wrapper.ts).
21
+ *
22
+ * What a hit skips: all user work — data fetching, MDX compilation, the
23
+ * component function itself never runs. What it re-pays: React
24
+ * re-serializes the already-resolved tree (cost proportional to payload
25
+ * size, not to data latency). The alternative — splicing raw payload bytes
26
+ * into the outer stream — avoids re-serialization but requires byte-level
27
+ * coupling to the flight wire format (row framing, ID rebasing, marker
28
+ * detection); it was implemented and reviewed on PR #835 and deliberately
29
+ * replaced by revival. See design/44-render-at-build-time.md
30
+ * §Request-Time Injection.
31
+ *
32
+ * Misses render the original component live via the wrapper's own closure,
33
+ * inside the React pass — segment params from ALS, deny()/redirect()
34
+ * signals, Suspense, and error boundaries behave exactly as an unwrapped
35
+ * component. `fallbackOnMissingSegmentParams: false` throws instead.
36
+ */
37
+
38
+ import { createElement } from 'react';
39
+
40
+ import { requestContextAls, type RequestContextStore } from './als-registry.ts';
41
+ import type { CoercedParams } from '../shared/param-value.ts';
42
+ import { computeComponentCacheKey, resolveKeyParams } from './prebuilt/cache-key.ts';
43
+ import {
44
+ resolveSlotNames,
45
+ prepareSlotRender,
46
+ withoutChildrenOutlet,
47
+ wrapInSlotsProvider,
48
+ } from './prebuilt/slots.ts';
49
+ import {
50
+ createKeyDisciplineProxy,
51
+ emitKeyDisciplineWarning,
52
+ shouldCheckKeyDiscipline,
53
+ } from './prebuilt/key-discipline.ts';
54
+ import {
55
+ createCaptureScope,
56
+ isCaptureActive,
57
+ noteWrapperRender,
58
+ type NestedWrapperRender,
59
+ } from './prebuilt/capture-state.ts';
60
+ import { hasRuntimeLifetime, resolveTags, warnNestingClamps } from './prebuilt/lifetime.ts';
61
+ import {
62
+ hasPrebuiltPayloadSource,
63
+ isParamIndependent,
64
+ lookupArtifactSeed,
65
+ type Seed,
66
+ } from './prebuilt/payload-source.ts';
67
+ import { lookupOverlay, storeOverlayEntry, overlayKey } from './prebuilt/overlay.ts';
68
+ import {
69
+ clearDevPrebuiltStore,
70
+ discardDevEntry,
71
+ getDevSeed,
72
+ isDevPrebuiltCacheBypassed,
73
+ isDevPrebuiltStoreActive,
74
+ isHardReload,
75
+ setDevSeed,
76
+ } from './prebuilt/dev-store.ts';
77
+ import { renderEntry } from './prebuilt/capture-render.ts';
78
+ import { BuildTimeContextError } from './prebuilt/synthetic-store.ts';
79
+ import { getWaitUntil } from './waituntil-bridge.ts';
80
+ import { runBackgroundFlight } from './pipeline-helpers.ts';
81
+ import { runOutsideReactCacheScope } from './react-cache-scope.ts';
82
+ import { collectFlightBytes, type RenderFlight } from './flight-source.ts';
83
+ import { DEFAULT_RENDER_TIMEOUT_MS } from './render-timeout.ts';
84
+ import { createSingleflight } from '../cache/singleflight.ts';
85
+ import {
86
+ currentInvalidationEpoch,
87
+ wasInvalidatedSince,
88
+ lastInvalidationEpochFor,
89
+ } from '../cache/invalidation-epoch.ts';
90
+
91
+ /** Default timeout for component re-renders (overridden by renderTimeoutMs). */
92
+ const DEFAULT_COMPONENT_TIMEOUT_MS = DEFAULT_RENDER_TIMEOUT_MS;
93
+
94
+ /** Singleflight for component re-renders (inline and background). */
95
+ let componentSingleflight = createSingleflight({
96
+ timeoutMs: DEFAULT_COMPONENT_TIMEOUT_MS,
97
+ });
98
+ let componentTimeoutMs = DEFAULT_COMPONENT_TIMEOUT_MS;
99
+
100
+ /**
101
+ * Set the timeout for component re-render captures. Called at boot from
102
+ * the RSC entry with renderTimeoutMs from timber.config.ts.
103
+ */
104
+ export function setComponentRefreshTimeout(timeoutMs: number): void {
105
+ componentTimeoutMs = timeoutMs;
106
+ componentSingleflight = createSingleflight({ timeoutMs });
107
+ }
108
+
109
+ let warnedNoWaitUntil = false;
110
+
111
+ /**
112
+ * (outer, inner) pairs already warned about by request-time captures.
113
+ * Process-wide: re-renders of a hot component repeat, and the warning is
114
+ * about the code, not the request. Bounded by the number of wrapped
115
+ * components in the app.
116
+ */
117
+ const warnedNestingPairs = new Set<string>();
118
+
119
+ /**
120
+ * Options captured from the `cache.component(fn, opts)` call site.
121
+ *
122
+ * `prerender`/`ttl`/`tags` (design/45) are carried through untouched — the
123
+ * build phase (TIM-1119) and runtime overlay (design/45 phase 3) consume
124
+ * them.
125
+ */
126
+ export interface PrebuiltComponentOptions {
127
+ /** Populate the cache at build time via generateStaticSegmentParams. */
128
+ prerender?: boolean;
129
+ /** Runtime freshness window, seconds (design/45 runtime tier). */
130
+ ttl?: number;
131
+ /** Runtime invalidation tags (design/45 runtime tier). */
132
+ tags?: string[] | ((props: Record<string, unknown>) => string[]);
133
+ /** Serve stale while a background re-render refreshes (design/45 §SWR). */
134
+ staleWhileRevalidate?: boolean;
135
+ /**
136
+ * Slot props (TIM-1173): prop names whose values are live React
137
+ * elements composed into the cached shell at request time instead of
138
+ * participating in the cache. Each declared slot renders as a stable
139
+ * SlotOutlet client reference at capture time; the live value flows in
140
+ * through SlotContext per instance. Slot props are excluded from the
141
+ * cache key — only the remaining data props (+ segment params) hash.
142
+ * Runtime tier only: `prerender` is ignored (with a warning) because
143
+ * the build cannot enumerate children variants.
144
+ */
145
+ slots?: string[];
146
+ /**
147
+ * On a cache miss, render the component live (default: true). When false,
148
+ * a miss throws instead — for sites that must never render unknown params
149
+ * dynamically. See design/44 §fallbackOnMissingSegmentParams.
150
+ */
151
+ fallbackOnMissingSegmentParams?: boolean;
152
+ }
153
+
154
+ /** An async server component: props in, renderable out. */
155
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
156
+ type ServerComponent = (props: any) => unknown;
157
+
158
+ /**
159
+ * View of a ServerComponent that satisfies createElement's overloads.
160
+ * Server components legitimately return `unknown` from the framework's
161
+ * perspective (promises, elements, strings, …) — React renders whatever
162
+ * comes back; the narrowing exists only to cross createElement's
163
+ * ReactNode-typed signature.
164
+ */
165
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
166
+ type RenderableComponent = (props: any) => React.ReactNode;
167
+
168
+ export interface PrebuiltRegistration {
169
+ id: string;
170
+ component: ServerComponent;
171
+ options: PrebuiltComponentOptions;
172
+ }
173
+
174
+ /**
175
+ * Server-side component registry, keyed by stable component ID. Populated at
176
+ * module load time by `__prebuilt` calls; consumed by the post-build capture
177
+ * pass (TIM-1119). Not written in dev, where nothing walks it. Never serialized — component functions are not
178
+ * Flight-serializable.
179
+ */
180
+ const registry = new Map<string, PrebuiltRegistration>();
181
+
182
+ /** Dev: IDs registered so far, to detect a module re-evaluating (no functions held). */
183
+ const devRegisteredIds = new Set<string>();
184
+
185
+ /** Wrap payload bytes as a single-chunk ReadableStream for the decoder. */
186
+ function bytesToStream(bytes: Uint8Array): ReadableStream<Uint8Array> {
187
+ return new ReadableStream<Uint8Array>({
188
+ start(controller) {
189
+ controller.enqueue(bytes);
190
+ controller.close();
191
+ },
192
+ });
193
+ }
194
+
195
+ // ─── Slot components (TIM-1173) ──────────────────────────────────────────
196
+
197
+ /**
198
+ * Serve a slot component from the cache: split live slot values out of the
199
+ * props, look up / capture the shell (data props + a deterministic
200
+ * SlotOutlet placeholder per slot), and wrap the revived shell in a
201
+ * per-instance SlotsProvider that feeds the live values to the outlets.
202
+ *
203
+ * Null on any miss — the caller renders live with the original props.
204
+ */
205
+ async function tryReviveSlotShell(
206
+ registration: PrebuiltRegistration,
207
+ slots: readonly string[],
208
+ props: Record<string, unknown>
209
+ ): Promise<{ element: unknown } | null> {
210
+ const render = prepareSlotRender(props, slots);
211
+ if (render === null) return null; // top-level props unkeyable → live render
212
+ const { shellProps, dataProps, slotValues } = render;
213
+ const revived = await tryRevivePayload(registration, shellProps, dataProps);
214
+ if (revived === null) return null;
215
+ return { element: wrapInSlotsProvider(revived.element, slotValues) };
216
+ }
217
+
218
+ // ─── RSC function injection ─────────────────────────────────────────────
219
+ // The flight client/server is only resolvable in the RSC environment
220
+ // (react-server condition). The RSC entry wires these at boot via
221
+ // setRscFunctions(); tests inject mocks directly. Same pattern as
222
+ // setCacheHandler / setPrebuiltPayloadSource.
223
+
224
+ interface RscFunctions {
225
+ createFromReadableStream: (stream: ReadableStream<Uint8Array>) => Promise<unknown>;
226
+ renderFlight: RenderFlight;
227
+ }
228
+
229
+ let rscFns: RscFunctions | null = null;
230
+
231
+ /**
232
+ * Wire the RSC flight client/server functions. Called once at server
233
+ * startup from the RSC entry module.
234
+ */
235
+ export function setRscFunctions(fns: RscFunctions): void {
236
+ rscFns = fns;
237
+ }
238
+
239
+ function requireRscFunctions(): RscFunctions {
240
+ if (!rscFns) {
241
+ throw new Error('[timber] RSC functions not wired — setRscFunctions() must be called at boot');
242
+ }
243
+ return rscFns;
244
+ }
245
+
246
+ /**
247
+ * Revive flight payload bytes into a React element.
248
+ * Returns null on any failure (corrupt payload, missing decoder).
249
+ */
250
+ async function revivePayload(
251
+ id: string,
252
+ payload: Uint8Array,
253
+ outcome: string
254
+ ): Promise<{ element: unknown } | null> {
255
+ try {
256
+ const { createFromReadableStream } = requireRscFunctions();
257
+ const element: unknown = await createFromReadableStream(bytesToStream(payload));
258
+ return { element };
259
+ } catch (error) {
260
+ console.error(`[timber] failed to revive prebuilt payload for "${id}" — ${outcome}:`, error);
261
+ return null;
262
+ }
263
+ }
264
+
265
+ /** Ceiling on component re-render capture (design/13 A2). Uses configured renderTimeoutMs. */
266
+ function getCaptureTimeoutMs(): number {
267
+ return componentTimeoutMs;
268
+ }
269
+
270
+ /** A request-time capture: the payload and the wrappers baked into it. */
271
+ interface CapturedPayload {
272
+ bytes: Uint8Array;
273
+ nested: NestedWrapperRender[];
274
+ }
275
+
276
+ /**
277
+ * Render a component in isolation and capture its flight payload bytes.
278
+ * Used for inline re-renders (tombstone/miss) and SWR background re-renders.
279
+ *
280
+ * The stream read is timeout-guarded and the reader is cancelled on
281
+ * expiry (design/13 A2, A3).
282
+ */
283
+ async function captureComponentPayload(
284
+ id: string,
285
+ component: ServerComponent,
286
+ props: Record<string, unknown>,
287
+ options: PrebuiltComponentOptions
288
+ ): Promise<CapturedPayload> {
289
+ const { renderFlight } = requireRscFunctions();
290
+ const element = createElement(component as RenderableComponent, props);
291
+ // Render inside a capture scope so nested cache.component wrappers render
292
+ // live (bake flat into this entry) per design/45 §Nesting Semantics. The
293
+ // scope is this capture's async context only — concurrent requests
294
+ // rendering the same or other wrapped components never see it (TIM-1536).
295
+ const capture = createCaptureScope(id, options, props);
296
+ // The first error the capture render hit, kept so a failed capture
297
+ // reports the component's own error rather than a stand-in.
298
+ let renderError: { error: unknown } | undefined;
299
+
300
+ // Key-discipline diagnostic (design/45 §Enforcement): proxy the ALS
301
+ // store to detect request-context reads during the capture render.
302
+ // The proxy is transparent — it never blocks or throws; it only observes.
303
+ const store = requestContextAls.getStore();
304
+ const discipline = store && shouldCheckKeyDiscipline(id) ? createKeyDisciplineProxy(store) : null;
305
+
306
+ const doCapture = (): Promise<Uint8Array> =>
307
+ capture.run(async () => {
308
+ // Outside the request's React.cache scope: this payload is stored
309
+ // cross-request (and the capture is singleflight-coalesced across
310
+ // requests), so it must not bake in values memoized for the request
311
+ // that happened to trigger it. Flight gives the capture its own
312
+ // per-render cache instead (TIM-1529).
313
+ const source = runOutsideReactCacheScope(() =>
314
+ renderFlight(element, {
315
+ onError(error: unknown) {
316
+ renderError ??= { error };
317
+ return '';
318
+ },
319
+ })
320
+ );
321
+ const bytes = await collectFlightBytes(
322
+ source,
323
+ getCaptureTimeoutMs(),
324
+ '[timber] component re-render capture'
325
+ );
326
+ // Error rows are never cached. The component's own error is what
327
+ // failed, so it is what the caller logs and reports.
328
+ if (renderError) throw renderError.error;
329
+ return bytes;
330
+ });
331
+
332
+ const bytes = discipline
333
+ ? await requestContextAls.run(discipline.proxy, doCapture)
334
+ : await doCapture();
335
+
336
+ if (discipline && discipline.accessedApis.size > 0) {
337
+ emitKeyDisciplineWarning(id, discipline.accessedApis);
338
+ }
339
+
340
+ return { bytes, nested: capture.nestedRenders() };
341
+ }
342
+
343
+ /**
344
+ * Store a captured entry in the overlay, then say which embedded
345
+ * components it clamps (design/45 §Nesting Semantics, TIM-1545). The
346
+ * warning follows the store: a capture that is discarded (aborted,
347
+ * invalidated mid-render, failed store) holds no clamped copy, and must
348
+ * not spend the pair's one warning.
349
+ */
350
+ async function storeCapturedEntry(
351
+ id: string,
352
+ cacheKey: string,
353
+ captured: CapturedPayload,
354
+ options: PrebuiltComponentOptions,
355
+ tags: string[],
356
+ hasSeed: boolean
357
+ ): Promise<void> {
358
+ await storeOverlayEntry(id, cacheKey, captured.bytes, { ttl: options.ttl, tags, hasSeed });
359
+ warnNestingClamps({ id, options, tags }, captured.nested, warnedNestingPairs, (m) =>
360
+ console.warn(m)
361
+ );
362
+ }
363
+
364
+ /**
365
+ * Inline re-render: capture flight bytes, store in overlay, revive for
366
+ * the current request. Singleflight-coalesced by overlay key.
367
+ */
368
+ async function inlineRerender(
369
+ id: string,
370
+ component: ServerComponent,
371
+ props: Record<string, unknown>,
372
+ cacheKey: string,
373
+ options: PrebuiltComponentOptions,
374
+ hasSeed: boolean,
375
+ outcome: string
376
+ ): Promise<{ element: unknown } | null> {
377
+ const tags = resolveTags(options, props);
378
+ const oKey = overlayKey(id, cacheKey);
379
+ const sfKey = `prebuilt:${id}:${cacheKey}\0${lastInvalidationEpochFor(oKey, tags)}`;
380
+
381
+ try {
382
+ const payload = await componentSingleflight.do(sfKey, async (signal) => {
383
+ const startEpoch = currentInvalidationEpoch();
384
+ const captured = await captureComponentPayload(id, component, props, options);
385
+ // Skip the store if aborted (singleflight timeout) or if the
386
+ // key/tags were invalidated while rendering (TIM-1028 guard).
387
+ if (
388
+ !signal.aborted &&
389
+ hasRuntimeLifetime(options) &&
390
+ !wasInvalidatedSince(startEpoch, oKey, tags)
391
+ ) {
392
+ await storeCapturedEntry(id, cacheKey, captured, options, tags, hasSeed);
393
+ }
394
+ return captured.bytes;
395
+ });
396
+ return await revivePayload(id, payload, outcome);
397
+ } catch (error) {
398
+ console.error(`[timber] cache.component re-render failed for "${id}" — ${outcome}:`, error);
399
+ return null;
400
+ }
401
+ }
402
+
403
+ /**
404
+ * Snapshot the request context values needed for a background re-render.
405
+ * Creates a FRESH store with copied values — the original ALS store is
406
+ * not referenced after capture. The `Request` itself is shared, not
407
+ * copied: the re-render reports its failure against it.
408
+ */
409
+ function snapshotRequestContext(store: RequestContextStore): RequestContextStore {
410
+ return {
411
+ request: store.request,
412
+ headers: new Headers(store.headers),
413
+ originalHeaders: new Headers(store.originalHeaders),
414
+ cookieHeader: store.cookieHeader,
415
+ parsedCookies: store.parsedCookies ? new Map(store.parsedCookies) : undefined,
416
+ searchParams: new URLSearchParams(store.searchParams),
417
+ searchString: store.searchString,
418
+ segmentParams: store.segmentParams ? { ...store.segmentParams } : undefined,
419
+ cookieJar: new Map(),
420
+ flushed: false,
421
+ mutableContext: false,
422
+ };
423
+ }
424
+
425
+ /**
426
+ * Kick off a background re-render via waitUntil. The re-render runs inside
427
+ * a fresh ALS scope with snapshotted request context.
428
+ */
429
+ function backgroundRerender(
430
+ id: string,
431
+ component: ServerComponent,
432
+ props: Record<string, unknown>,
433
+ cacheKey: string,
434
+ options: PrebuiltComponentOptions,
435
+ hasSeed: boolean,
436
+ snapshot: RequestContextStore
437
+ ): void {
438
+ const waitUntil = getWaitUntil();
439
+ const tags = resolveTags(options, props);
440
+ const oKey = overlayKey(id, cacheKey);
441
+ const startEpoch = currentInvalidationEpoch();
442
+ const sfKey = `prebuilt-bg:${id}:${cacheKey}\0${lastInvalidationEpochFor(oKey, tags)}`;
443
+
444
+ const work = requestContextAls.run(snapshot, () =>
445
+ componentSingleflight
446
+ // The stale payload already answered the request, so nothing else sees
447
+ // a failure here: logged and reported once per flight. Inline re-render
448
+ // and revive failures are only logged: a live render answers instead.
449
+ .do(sfKey, (signal) =>
450
+ runBackgroundFlight(
451
+ signal,
452
+ async () => {
453
+ const captured = await captureComponentPayload(id, component, props, options);
454
+ if (!signal.aborted && !wasInvalidatedSince(startEpoch, oKey, tags)) {
455
+ await storeCapturedEntry(id, cacheKey, captured, options, tags, hasSeed);
456
+ }
457
+ },
458
+ (error) =>
459
+ console.error(
460
+ `[timber] cache.component background re-render failed for "${id}":`,
461
+ error
462
+ )
463
+ )
464
+ )
465
+ // runBackgroundFlight never rejects; only the singleflight timeout,
466
+ // which it already reported, can reject the flight.
467
+ .catch(() => {})
468
+ );
469
+
470
+ if (waitUntil) {
471
+ waitUntil(work);
472
+ } else if (!warnedNoWaitUntil) {
473
+ warnedNoWaitUntil = true;
474
+ console.warn(
475
+ '[timber] cache.component SWR background re-render has no waitUntil — ' +
476
+ 'the re-render may be killed when the handler returns on serverless platforms. ' +
477
+ 'Ensure the adapter wires runWithWaitUntil().'
478
+ );
479
+ }
480
+ }
481
+
482
+ /** Components already announced by the one-time dev log. */
483
+ const devLoggedIds = new Set<string>();
484
+
485
+ /**
486
+ * Dev: the seed for a prerender entry — the stored capture, or a new one
487
+ * rendered exactly as the build would render it (synthetic store, isolated
488
+ * render, nested wrappers baked flat) and stored until the next source
489
+ * change (prebuilt/dev-store.ts).
490
+ *
491
+ * Throws the BuildTimeContextError when the component read request
492
+ * context: `pnpm build` would fail on it, so dev fails too. Null on any
493
+ * other capture failure — the live render that follows reproduces the
494
+ * error, deny(), or redirect() with its normal semantics.
495
+ */
496
+ async function resolveDevSeed(
497
+ registration: PrebuiltRegistration,
498
+ props: Record<string, unknown>,
499
+ keyParams: CoercedParams,
500
+ cacheKey: string
501
+ ): Promise<Seed | null> {
502
+ const { id, options } = registration;
503
+ const stored = getDevSeed(id, cacheKey);
504
+ if (stored) return { payload: stored.bytes, capturedAt: stored.capturedAt };
505
+
506
+ const tags = resolveTags(options, props);
507
+ const oKey = overlayKey(id, cacheKey);
508
+ // The epoch scopes the flight: a request after a source change (which
509
+ // invalidates everything) never joins a capture of the old code.
510
+ const sfKey = `prebuilt-dev:${id}:${cacheKey}\0${lastInvalidationEpochFor(oKey, tags)}`;
511
+ try {
512
+ return await componentSingleflight.do(sfKey, async (signal) => {
513
+ const startEpoch = currentInvalidationEpoch();
514
+ const capturedAt = Date.now();
515
+ const { renderFlight } = requireRscFunctions();
516
+ // Outside the request's React.cache scope, like every stored capture
517
+ // (TIM-1529).
518
+ const outcome = await runOutsideReactCacheScope(() =>
519
+ renderEntry(registration, props, keyParams, getCaptureTimeoutMs(), false, renderFlight)
520
+ );
521
+ if (outcome.failure instanceof BuildTimeContextError) throw outcome.failure;
522
+ if (outcome.bytes === null) return null;
523
+ // Smoke-revive before storing, as the build does: bytes that cannot
524
+ // be decoded would fail every later request until the next save.
525
+ if ((await revivePayload(id, outcome.bytes, 'not storing the dev capture')) === null) {
526
+ return null;
527
+ }
528
+ // A save (or revalidateTag) while this rendered: the bytes may come
529
+ // from the old code, so this request gets them but the store does not.
530
+ if (!signal.aborted && !wasInvalidatedSince(startEpoch, oKey, tags)) {
531
+ setDevSeed(id, cacheKey, { bytes: outcome.bytes, tags, capturedAt });
532
+ warnNestingClamps({ id, options, tags }, outcome.nested, warnedNestingPairs, (m) =>
533
+ console.warn(m)
534
+ );
535
+ if (!devLoggedIds.has(id)) {
536
+ devLoggedIds.add(id);
537
+ console.log(
538
+ `[timber] cache.component "${id}": prerendered in dev — served from memory until ` +
539
+ `a file changes. A hard reload (Cache-Control: no-cache) renders it again.`
540
+ );
541
+ }
542
+ }
543
+ return { payload: outcome.bytes, capturedAt };
544
+ });
545
+ } catch (error) {
546
+ if (error instanceof BuildTimeContextError) throw error;
547
+ console.error(`[timber] cache.component dev capture failed for "${id}":`, error);
548
+ return null;
549
+ }
550
+ }
551
+
552
+ /**
553
+ * Try to serve this render from the prebuilt cache: overlay → seed →
554
+ * live render. Handles ISR (SWR, tombstones, re-renders) per design/45.
555
+ *
556
+ * Null on any miss — the caller renders live.
557
+ */
558
+ async function tryRevivePayload(
559
+ registration: PrebuiltRegistration,
560
+ props: Record<string, unknown>,
561
+ keyPropsOverride?: Record<string, unknown>
562
+ ): Promise<{ element: unknown } | null> {
563
+ // The wrapper's own registration: re-renders run the component through
564
+ // the wrapper's closure, never a registry lookup.
565
+ const { id, options, component } = registration;
566
+ const hasSource = hasPrebuiltPayloadSource();
567
+ const devStore = isDevPrebuiltStoreActive();
568
+ const hasRuntime = hasRuntimeLifetime(options);
569
+ if (!hasSource && !devStore && !hasRuntime) return null;
570
+
571
+ const store = requestContextAls.getStore();
572
+ if (!store) return null;
573
+ const paramIndep = options.prerender ? await isParamIndependent(id) : false;
574
+ const keyParams = paramIndep ? {} : resolveKeyParams(store);
575
+ if (keyParams === null) return null;
576
+
577
+ // Strip `children` from the cache key ONLY when it is the framework-
578
+ // injected children slot outlet (<SlotOutlet slot="children" />).
579
+ // Layout components receive this as children — a deterministic client
580
+ // reference that is the same on every request, so it should not vary
581
+ // the key. User-provided React element children are NOT stripped —
582
+ // they remain unkeyable so the component renders live, which is
583
+ // correct: the cache cannot distinguish <A> from <B>.
584
+ // See design/45-cache-lifetimes.md §Layout Propagation, TIM-1181.
585
+ // keyPropsOverride = slot component (TIM-1173): the wrapper already
586
+ // split out slot props; only data props participate in the key. The
587
+ // children outlet strip applies to EITHER source — a cached layout
588
+ // declaring only named slots (slots: ['modal']) still receives the
589
+ // framework-injected children outlet in its data props, and it must not
590
+ // unkey the render there any more than on the non-slot path (codex P2
591
+ // on PR #890).
592
+ const allProps = (props ?? {}) as Record<string, unknown>;
593
+ const cacheKey = computeComponentCacheKey(
594
+ withoutChildrenOutlet(keyPropsOverride ?? allProps),
595
+ keyParams
596
+ );
597
+ if (cacheKey === null) return null;
598
+
599
+ const outcome =
600
+ options.fallbackOnMissingSegmentParams === false
601
+ ? 'failing the render (fallbackOnMissingSegmentParams: false)'
602
+ : 'rendering dynamically';
603
+
604
+ // Dev only: a hard reload discards this entry first, so the lookups
605
+ // below miss and it renders again — a prerender entry under the
606
+ // synthetic store, exactly as on its first request (prebuilt/dev-store.ts
607
+ // `isHardReload`).
608
+ if (devStore && isHardReload(store.originalHeaders)) {
609
+ await discardDevEntry(id, cacheKey, overlayKey(id, cacheKey));
610
+ }
611
+
612
+ // ─── Step 1: Check overlay (CacheHandler) ─────────────────────────
613
+ if (hasRuntime) {
614
+ const overlayResult = await lookupOverlay(id, cacheKey);
615
+ if (overlayResult) {
616
+ const overlayHasSeed = overlayResult.record?.s ?? false;
617
+ if (overlayResult.kind === 'tombstone') {
618
+ return await inlineRerender(id, component, props, cacheKey, options, true, outcome);
619
+ }
620
+ if (overlayResult.kind === 'fresh' && overlayResult.payload) {
621
+ return await revivePayload(id, overlayResult.payload, outcome);
622
+ }
623
+ if (overlayResult.kind === 'stale' && overlayResult.payload) {
624
+ if (options.staleWhileRevalidate) {
625
+ backgroundRerender(
626
+ id,
627
+ component,
628
+ props,
629
+ cacheKey,
630
+ options,
631
+ overlayHasSeed,
632
+ snapshotRequestContext(store)
633
+ );
634
+ return await revivePayload(id, overlayResult.payload, outcome);
635
+ }
636
+ return await inlineRerender(
637
+ id,
638
+ component,
639
+ props,
640
+ cacheKey,
641
+ options,
642
+ overlayHasSeed,
643
+ outcome
644
+ );
645
+ }
646
+ }
647
+ }
648
+
649
+ // ─── Step 2: Check the seed (build artifact, or the dev store) ────
650
+ const seed = devStore
651
+ ? options.prerender
652
+ ? await resolveDevSeed(registration, props, keyParams, cacheKey)
653
+ : null
654
+ : hasSource
655
+ ? await lookupArtifactSeed(id, cacheKey, options.ttl !== undefined)
656
+ : null;
657
+ if (seed !== null) {
658
+ // Check seed freshness when the component has a TTL.
659
+ if (options.ttl !== undefined) {
660
+ const seedAge = (Date.now() - seed.capturedAt) / 1000;
661
+ if (seedAge > options.ttl) {
662
+ // Stale seed
663
+ if (options.staleWhileRevalidate) {
664
+ backgroundRerender(
665
+ id,
666
+ component,
667
+ props,
668
+ cacheKey,
669
+ options,
670
+ true,
671
+ snapshotRequestContext(store)
672
+ );
673
+ return await revivePayload(id, seed.payload, outcome);
674
+ }
675
+ return await inlineRerender(id, component, props, cacheKey, options, true, outcome);
676
+ }
677
+ }
678
+ // Fresh seed (or no TTL — immutable until redeploy)
679
+ return await revivePayload(id, seed.payload, outcome);
680
+ }
681
+
682
+ // Manifest miss
683
+ if (hasSource && options.prerender) {
684
+ console.warn(
685
+ `[timber] cache.component cache miss: "${id}" with params ${JSON.stringify(
686
+ store.segmentParams ?? {}
687
+ )} — ${outcome}`
688
+ );
689
+ }
690
+
691
+ // ─── Step 3: Full miss with runtime lifetime — inline re-render ───
692
+ // Skip when fallbackOnMissingSegmentParams is false — that option means
693
+ // "only prebuilt content", so an unenumerated miss must throw (the
694
+ // wrapper handles the throw after we return null).
695
+ if (hasRuntime && options.fallbackOnMissingSegmentParams !== false) {
696
+ return await inlineRerender(id, component, props, cacheKey, options, false, outcome);
697
+ }
698
+
699
+ return null;
700
+ }
701
+
702
+ /**
703
+ * Production wrapper injected by the timber-prebuilt transform. Registers
704
+ * the component under its stable ID and returns a wrapper component that
705
+ * either revives the cached payload (hit) or renders the original
706
+ * component live (miss).
707
+ */
708
+ export function __prebuilt<C extends ServerComponent>(
709
+ id: string,
710
+ component: C,
711
+ options: PrebuiltComponentOptions = {}
712
+ ): C {
713
+ // Slot resolution first, then option normalization in its terms
714
+ // (TIM-1173). ACTIVE slots are runtime-tier only — the build cannot
715
+ // enumerate slot content — so `prerender` is stripped (loudly); the
716
+ // capture pass reads the registry's normalized options, so stripping
717
+ // here also keeps the build from capturing slot components. DISABLED
718
+ // declarations (malformed shape, missing lifetime — warned inside
719
+ // resolveSlotNames) fall back wholesale to non-slot semantics: `slots`
720
+ // is stripped so no downstream consumer (resolveTags' slot filtering,
721
+ // the registry, the capture pass) ever sees the raw value, and every
722
+ // other option — including `prerender` — keeps its normal meaning
723
+ // (codex P2s on PR #890).
724
+ const resolution = resolveSlotNames(id, options);
725
+ const slots = resolution.kind === 'active' ? resolution.slots : null;
726
+ if (resolution.kind === 'active' && options.prerender) {
727
+ console.warn(
728
+ `[timber] cache.component "${id}": slots are runtime-tier only — ` +
729
+ `prerender is ignored (the build cannot enumerate slot content). ` +
730
+ `Use ttl/tags for the cache lifetime.`
731
+ );
732
+ options = { ...options, prerender: undefined };
733
+ }
734
+ if (resolution.kind === 'disabled') {
735
+ options = { ...options, slots: undefined };
736
+ }
737
+ const registration: PrebuiltRegistration = { id, component, options };
738
+ if (isDevPrebuiltStoreActive()) {
739
+ // Dev: a second registration of an ID means its module re-evaluated,
740
+ // so some code in this subtree changed. Clear rather than trust that
741
+ // the watcher event already did (it may land after this request
742
+ // rendered). Dev keeps only the ID: nothing walks the registry there,
743
+ // and an edited call site gets a new ID, so holding registrations
744
+ // would pin every superseded component and its module for the session.
745
+ if (devRegisteredIds.has(id)) clearDevPrebuiltStore();
746
+ devRegisteredIds.add(id);
747
+ } else {
748
+ registry.set(id, registration);
749
+ }
750
+
751
+ const wrapper = async (props: Parameters<C>[0]) => {
752
+ // Report this render to the enclosing capture, if any — cycle
753
+ // detection (throws) and nesting-clamp warnings (design/45 §Nesting
754
+ // Semantics). Outside a capture this is a single store lookup.
755
+ noteWrapperRender(id, options, props as Record<string, unknown>);
756
+ if (isCaptureActive()) {
757
+ // Nested wrapper inside a capture: render live so the subtree
758
+ // bakes flat into the enclosing entry (design/45 §Nesting).
759
+ // This deliberately bypasses fallbackOnMissingSegmentParams: false —
760
+ // that option means "never serve non-prebuilt content", and a
761
+ // capture render IS the cached content; throwing here would
762
+ // spuriously fail the outer entry (codex P2 on PR #836).
763
+ return createElement(component as RenderableComponent, props as Record<string, unknown>);
764
+ }
765
+ // Dev without HMR: nothing could invalidate a cached entry, so render
766
+ // live, as dev did before it cached (no fallbackOnMissingSegmentParams
767
+ // throw either: there is no build to have missed).
768
+ if (isDevPrebuiltCacheBypassed()) {
769
+ return createElement(component as RenderableComponent, props as Record<string, unknown>);
770
+ }
771
+
772
+ const revived = slots
773
+ ? await tryReviveSlotShell(registration, slots, props as Record<string, unknown>)
774
+ : await tryRevivePayload(registration, props as Record<string, unknown>);
775
+ if (revived !== null) {
776
+ return revived.element;
777
+ }
778
+ if (options.fallbackOnMissingSegmentParams === false) {
779
+ throw new Error(
780
+ `[timber] cache.component "${id}": no prebuilt payload for the current params and fallbackOnMissingSegmentParams is false`
781
+ );
782
+ }
783
+ // Return an ELEMENT — React invokes the component itself, with its
784
+ // render dispatcher active. Calling component(props) here would run
785
+ // it after this wrapper's await, outside a dispatcher frame, breaking
786
+ // sync server components that call use() (codex review on PR #835).
787
+ return createElement(component as RenderableComponent, props as Record<string, unknown>);
788
+ };
789
+ Object.defineProperty(wrapper, 'name', { value: `Prebuilt(${id})` });
790
+ // Double cast, deliberately: C's return type may be narrower than the
791
+ // wrapper's (a sync component wrapped by an async function, or a revived
792
+ // subtree in place of C's exact JSX type). Callers only ever *render*
793
+ // the result — React treats any component returning ReactNode-compatible
794
+ // values identically — so widening through `unknown` is safe here and a
795
+ // direct cast would be rejected by the compiler for exactly the
796
+ // difference we intend.
797
+ return wrapper as unknown as C;
798
+ }
799
+
800
+ /** Look up a registration by stable component ID. */
801
+ export function getPrebuiltRegistration(id: string): PrebuiltRegistration | undefined {
802
+ return registry.get(id);
803
+ }
804
+
805
+ /** All registrations, for the post-build capture pass (TIM-1119). */
806
+ export function getPrebuiltRegistry(): ReadonlyMap<string, PrebuiltRegistration> {
807
+ return registry;
808
+ }