@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,149 @@
1
+ /**
2
+ * scan — project source-file disk scan shared by the crawl and the
3
+ * graph cache.
4
+ *
5
+ * One walker, one rule set: the crawl uses it to find files no graph
6
+ * reached (the provisional/pending set) and to bound graph membership,
7
+ * and the mtime-keyed graph cache fingerprints exactly the same file
8
+ * set — the three can never disagree about what "the project" is (a
9
+ * file the crawl classifies but the fingerprint ignores would make the
10
+ * cache silently stale).
11
+ *
12
+ * Skip rules are deliberately shallow: timber's router excludes only
13
+ * `_`-prefixed directories, so `app/.well-known/page.tsx` and
14
+ * `app/dist/page.tsx` are REAL routes — a rule that skipped `dist` or
15
+ * dot-directories at any depth would hide legitimate route files from
16
+ * the scan while the module graph still reached them (codex review,
17
+ * PR #1056). Therefore:
18
+ *
19
+ * - `node_modules` is skipped at ANY depth (never project source, and
20
+ * graph membership excludes it identically)
21
+ * - dot-prefixed and build-output directories (`dist`, `coverage`, …)
22
+ * are skipped only as the FIRST path segment under the root — that
23
+ * is where `.git`, `.timber`, `.wrangler`, and real build outputs
24
+ * live; deeper occurrences are walked
25
+ *
26
+ * Deliberately vite-free: the cache-hit path of `timber graph` reads
27
+ * this module without booting (or even importing) Vite.
28
+ *
29
+ * Design docs: 47-module-environment-tooling.md §2, §Cold-path policy.
30
+ */
31
+
32
+ import { readdir } from 'node:fs/promises';
33
+ import { join } from 'node:path';
34
+
35
+ /**
36
+ * Slash-normalize a Windows path — Vite's `normalizePath` for the
37
+ * vite-free callers (the graph cache-hit path must not import Vite).
38
+ * Same platform guard as Vite's: posix paths pass through untouched,
39
+ * so a filename containing a literal backslash is never corrupted.
40
+ */
41
+ export const normalizeSlashes: (path: string) => string =
42
+ process.platform === 'win32' ? (path) => path.replace(/\\/g, '/') : (path) => path;
43
+
44
+ /** A scan failure the caller records instead of swallowing. */
45
+ export interface ScanFailure {
46
+ dir: string;
47
+ message: string;
48
+ }
49
+
50
+ /**
51
+ * Directories never scanned when they are the first path segment under
52
+ * the root. `node_modules` is additionally skipped at any depth.
53
+ */
54
+ export const SCAN_IGNORED_DIRS = new Set(['node_modules', 'dist', 'test-results', 'coverage']);
55
+
56
+ /**
57
+ * Single source of truth for builtin source extensions. Includes mdx —
58
+ * timber supports page.mdx via pageExtensions, so an unreferenced MDX
59
+ * page must not vanish from --all output.
60
+ */
61
+ const BUILTIN_EXTENSIONS = ['ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs', 'mts', 'cts', 'mdx'] as const;
62
+
63
+ /** Regex form of BUILTIN_EXTENSIONS for file-basename matching. */
64
+ export const SOURCE_EXTENSIONS = new RegExp(`\\.(?:${BUILTIN_EXTENSIONS.join('|')})$`);
65
+
66
+ /** Set form for O(1) membership checks. */
67
+ const BUILTIN_EXTENSION_SET = new Set<string>(BUILTIN_EXTENSIONS);
68
+
69
+ /**
70
+ * Build a regex that matches SOURCE_EXTENSIONS plus any extra
71
+ * extensions from the user's pageExtensions config. Returns the
72
+ * builtin regex unchanged when nothing new is added.
73
+ */
74
+ export function buildSourceExtensions(pageExtensions?: readonly string[]): RegExp {
75
+ if (!pageExtensions) return SOURCE_EXTENSIONS;
76
+ const extras = pageExtensions.filter((ext) => !BUILTIN_EXTENSION_SET.has(ext));
77
+ if (extras.length === 0) return SOURCE_EXTENSIONS;
78
+ const escaped = extras.map((ext) => ext.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
79
+ return new RegExp(`\\.(?:${BUILTIN_EXTENSIONS.join('|')}|${escaped.join('|')})$`);
80
+ }
81
+
82
+ /** Whether a directory SEGMENT is skipped at the given depth (0 = root child). */
83
+ function isSkippedDirSegment(segment: string, depth: number): boolean {
84
+ if (segment === 'node_modules') return true;
85
+ if (depth === 0 && (segment.startsWith('.') || SCAN_IGNORED_DIRS.has(segment))) return true;
86
+ return false;
87
+ }
88
+
89
+ /** Whether a file basename is admitted as project source. */
90
+ function isSourceBasename(base: string, depth: number, extensions?: RegExp): boolean {
91
+ if (depth === 0 && base.startsWith('.')) return false;
92
+ if (!(extensions ?? SOURCE_EXTENSIONS).test(base)) return false;
93
+ // Declaration files are types-only — they never run in any environment.
94
+ if (/\.d\.[mc]?ts$/.test(base)) return false;
95
+ return true;
96
+ }
97
+
98
+ /**
99
+ * Whether an absolute, slash-normalized path is one the scanner WOULD
100
+ * admit — the same segment rules the walker applies, so a
101
+ * directly-addressed path (`package.json`, `<root>/dist/generated.js`,
102
+ * `types.d.ts`, a nested node_modules file) is answered exactly the
103
+ * way the scan-based sweep would answer it: by exclusion. Existence
104
+ * and is-a-file checks remain the caller's (this is pure path logic).
105
+ */
106
+ export function isScannableSourceFile(file: string, root: string, extensions?: RegExp): boolean {
107
+ if (!file.startsWith(root + '/')) return false;
108
+ const segments = file.slice(root.length + 1).split('/');
109
+ const base = segments[segments.length - 1];
110
+ for (let depth = 0; depth < segments.length - 1; depth++) {
111
+ if (isSkippedDirSegment(segments[depth], depth)) return false;
112
+ }
113
+ return isSourceBasename(base, segments.length - 1, extensions);
114
+ }
115
+
116
+ /**
117
+ * Recursively list project source files on disk.
118
+ *
119
+ * Unreadable directories are reported through `onFailure`, not thrown
120
+ * and not swallowed — this walker exists to keep files from silently
121
+ * vanishing, so a directory it cannot see must be visible too.
122
+ */
123
+ export async function scanProjectSourceFiles(
124
+ dir: string,
125
+ out: string[],
126
+ onFailure: (failure: ScanFailure) => void,
127
+ depth = 0,
128
+ extensions?: RegExp
129
+ ): Promise<void> {
130
+ let entries;
131
+ try {
132
+ entries = await readdir(dir, { withFileTypes: true });
133
+ } catch (error) {
134
+ onFailure({
135
+ dir,
136
+ message: `directory scan failed: ${error instanceof Error ? error.message : String(error)}`,
137
+ });
138
+ return;
139
+ }
140
+ for (const entry of entries) {
141
+ const full = join(dir, entry.name);
142
+ if (entry.isDirectory()) {
143
+ if (isSkippedDirSegment(entry.name, depth)) continue;
144
+ await scanProjectSourceFiles(full, out, onFailure, depth + 1, extensions);
145
+ } else if (entry.isFile() && isSourceBasename(entry.name, depth, extensions)) {
146
+ out.push(full);
147
+ }
148
+ }
149
+ }
@@ -0,0 +1,113 @@
1
+ import type { CacheOptions } from './index.ts';
2
+ import type { PrebuiltComponentOptions } from '../server/prebuilt-runtime.ts';
3
+ import { createCache } from './timber-cache.ts';
4
+ import { getCacheHandler } from './handler-store.ts';
5
+ import { recordInvalidation } from './invalidation-epoch.ts';
6
+ import { writeTombstonesForTag } from '../server/prebuilt/overlay.ts';
7
+ import { devDataCacheKey, invalidateDevSeedsByTag } from '../server/prebuilt/dev-store.ts';
8
+ import { getCdnPurgeHandler } from '../cdn/purge-store.ts';
9
+
10
+ const componentFallbackWarned = new WeakSet<object>();
11
+
12
+ /**
13
+ * Cache namespace — `cache.data`, `cache.component`, `cache.invalidate`.
14
+ *
15
+ * ```ts
16
+ * import { cache } from '@timber-js/app/cache';
17
+ *
18
+ * const getUser = cache.data(
19
+ * async (id: string) => db.users.findUnique({ where: { id } }),
20
+ * { ttl: 60, tags: (id) => [`user:${id}`] }
21
+ * );
22
+ * ```
23
+ */
24
+ export const cache = {
25
+ /**
26
+ * Wrap an async function with cross-request caching.
27
+ *
28
+ * The configured cache handler (defaults to MemoryCacheHandler, overridable
29
+ * via timber.config.ts) is re-resolved on every call, so module-scope
30
+ * wrappers created before `setCacheHandler()` still pick up the configured
31
+ * handler (TIM-1029).
32
+ */
33
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
34
+ data<Fn extends (...args: any[]) => Promise<any>>(
35
+ fn: Fn,
36
+ opts: CacheOptions<Fn>,
37
+ stableId?: string
38
+ ): Fn {
39
+ return createCache(fn, opts, getCacheHandler, stableId);
40
+ },
41
+
42
+ /**
43
+ * Invalidate cache entries by tag or key.
44
+ *
45
+ * ```ts
46
+ * cache.invalidate({ tag: 'products' });
47
+ * cache.invalidate({ key: 'user:abc' });
48
+ * ```
49
+ */
50
+ async invalidate(opts: { key?: string; tag?: string }): Promise<void> {
51
+ // Record before the handler delete so a cached fn in flight skips its
52
+ // post-resolve set instead of resurrecting the invalidated value (TIM-1028).
53
+ recordInvalidation(opts);
54
+ await getCacheHandler().invalidate(
55
+ opts.key === undefined ? opts : { ...opts, key: devDataCacheKey(opts.key) }
56
+ );
57
+ // Write tombstones for build-seed entries carrying the tag (design/45
58
+ // §ISR mechanics). Runs AFTER handler.invalidate so the tombstone
59
+ // overwrites the cleared overlay slot. This covers ALL invalidation
60
+ // paths — actions, webhooks, route handlers — not just executeAction.
61
+ if (opts.tag) {
62
+ await writeTombstonesForTag(opts.tag);
63
+ // Dev has no build seeds to tombstone — its seeds live in the dev
64
+ // store, so drop them instead (no-op outside dev, TIM-1588).
65
+ invalidateDevSeedsByTag(opts.tag);
66
+ }
67
+ // Trigger CDN purge if a handler is configured (design/25 §Layer 2).
68
+ // Purge is best-effort: a CDN API failure or timeout must not block
69
+ // cache invalidation. 10s ceiling prevents a hung CDN API from stalling
70
+ // the entire revalidateTag/action flow.
71
+ if (opts.tag) {
72
+ const purgeHandler = getCdnPurgeHandler();
73
+ if (purgeHandler) {
74
+ try {
75
+ await Promise.race([
76
+ purgeHandler.purgeTags([opts.tag]),
77
+ new Promise<void>((_, reject) =>
78
+ setTimeout(() => reject(new Error('CDN purge timed out (10s)')), 10_000)
79
+ ),
80
+ ]);
81
+ } catch (err) {
82
+ console.error('[timber] CDN purge failed for tag:', err);
83
+ }
84
+ }
85
+ }
86
+ },
87
+
88
+ /**
89
+ * Runtime fallback for `cache.component(...)` callsites the timber-prebuilt
90
+ * transform does not rewrite — nested/computed/argument-position forms (see
91
+ * plugins/prebuilt.ts). Only module-scope `const X = cache.component(...)`
92
+ * declarations are transformed and eligible for prebuilding; everything else
93
+ * lands here, warns once per component, and renders dynamically. Same
94
+ * safety-net pattern as the data cache's runtime fnId fallback (TIM-1054):
95
+ * an untraceable callsite degrades in performance, never in correctness.
96
+ */
97
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
98
+ component<C extends (props: any) => unknown>(
99
+ componentFn: C,
100
+ _options?: PrebuiltComponentOptions
101
+ ): C {
102
+ if (!componentFallbackWarned.has(componentFn)) {
103
+ componentFallbackWarned.add(componentFn);
104
+ const name = componentFn.name || 'anonymous component';
105
+ console.warn(
106
+ `[timber] cache.component: "${name}" was not transformed at build time — ` +
107
+ `rendering dynamically. Only module-scope declarations ` +
108
+ `(const X = cache.component(...)) are prebuilt.`
109
+ );
110
+ }
111
+ return componentFn;
112
+ },
113
+ };
@@ -9,6 +9,11 @@
9
9
  * Uses BigInt for 64-bit arithmetic — supported in all modern runtimes
10
10
  * including Cloudflare Workers. No node:crypto dependency.
11
11
  *
12
+ * Server-side only. The `_rsc` payload cache key deliberately does NOT use
13
+ * this — the origin compares that value, which makes it a check rather than
14
+ * a cache key, and FNV is solvable for a chosen digest. See
15
+ * `shared/rsc-cache-key.ts`.
16
+ *
12
17
  * See TIM-370.
13
18
  */
14
19
 
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Module-level cache handler singleton.
3
+ *
4
+ * Lazily initialized to MemoryCacheHandler on first access. The framework
5
+ * replaces this at boot from timber.config.ts via setCacheHandler().
6
+ *
7
+ * This module avoids importing from ./index to prevent circular dependencies.
8
+ */
9
+
10
+ // Inline the interface to avoid circular import with index.ts
11
+ interface CacheHandlerLike {
12
+ get(key: string): Promise<{ value: unknown; stale: boolean } | null>;
13
+ set(key: string, value: unknown, opts: { ttl: number; tags: string[] }): Promise<void>;
14
+ invalidate(opts: { key?: string; tag?: string }): Promise<void>;
15
+ }
16
+
17
+ let handler: CacheHandlerLike | null = null;
18
+
19
+ let explicitlyConfigured = false;
20
+
21
+ /** Whether `handler` came from timber.cache.ts (applyConfiguredCacheHandler). */
22
+ let fromCacheConfig = false;
23
+
24
+ /** The handler last installed by a direct setCacheHandler() call, if any. */
25
+ let directHandler: CacheHandlerLike | null = null;
26
+
27
+ /** Replace the active cache handler. */
28
+ export function setCacheHandler(h: CacheHandlerLike): void {
29
+ handler = h;
30
+ explicitlyConfigured = true;
31
+ fromCacheConfig = false;
32
+ directHandler = h;
33
+ }
34
+
35
+ /**
36
+ * Apply the handler timber.cache.ts exports, or `null` when it exports none.
37
+ * Called on every run of the RSC entry. In dev the entry re-runs after an
38
+ * edit while this module keeps its state (design/21 §HMR Wiring), so a
39
+ * handler removed from timber.cache.ts must be dropped here, not kept
40
+ * serving. A handler installed by a direct setCacheHandler() call (from
41
+ * register(), say) is left in place when the file exports none, and comes
42
+ * back when a configured handler that replaced it is removed.
43
+ */
44
+ export function applyConfiguredCacheHandler(h: CacheHandlerLike | null): void {
45
+ if (h) {
46
+ handler = h;
47
+ explicitlyConfigured = true;
48
+ fromCacheConfig = true;
49
+ } else if (fromCacheConfig) {
50
+ handler = directHandler;
51
+ explicitlyConfigured = directHandler !== null;
52
+ fromCacheConfig = false;
53
+ }
54
+ }
55
+
56
+ /** @internal — reset for tests only. */
57
+ export function _resetCacheHandler(): void {
58
+ handler = null;
59
+ explicitlyConfigured = false;
60
+ fromCacheConfig = false;
61
+ directHandler = null;
62
+ }
63
+
64
+ /** Whether the handler was explicitly configured (vs the default in-memory fallback). */
65
+ export function isCacheHandlerConfigured(): boolean {
66
+ return explicitlyConfigured;
67
+ }
68
+
69
+ /**
70
+ * Get the active cache handler. Creates a default MemoryCacheHandler on
71
+ * first access if none has been set via setCacheHandler().
72
+ */
73
+ export function getCacheHandler(): CacheHandlerLike {
74
+ if (!handler) {
75
+ // Inline a minimal LRU cache to avoid circular dep with index.ts.
76
+ // In production, the framework always calls setCacheHandler() at boot.
77
+ handler = createDefaultHandler();
78
+ }
79
+ return handler;
80
+ }
81
+
82
+ function createDefaultHandler(): CacheHandlerLike {
83
+ const store = new Map<string, { value: unknown; expiresAt: number; tags: string[] }>();
84
+ const maxEntries = 1000;
85
+
86
+ return {
87
+ async get(key) {
88
+ const entry = store.get(key);
89
+ if (!entry) return null;
90
+ store.delete(key);
91
+ store.set(key, entry);
92
+ const stale = Date.now() > entry.expiresAt;
93
+ return { value: entry.value, stale };
94
+ },
95
+ async set(key, value, opts) {
96
+ if (store.has(key)) store.delete(key);
97
+ while (store.size >= maxEntries) {
98
+ const oldest = store.keys().next().value;
99
+ if (oldest !== undefined) store.delete(oldest);
100
+ else break;
101
+ }
102
+ store.set(key, { value, expiresAt: Date.now() + opts.ttl * 1000, tags: opts.tags });
103
+ },
104
+ async invalidate(opts) {
105
+ if (opts.key) store.delete(opts.key);
106
+ if (opts.tag) {
107
+ for (const [key, entry] of store) {
108
+ if (entry.tags.includes(opts.tag)) store.delete(key);
109
+ }
110
+ }
111
+ },
112
+ };
113
+ }
@@ -1,8 +1,14 @@
1
1
  // @timber-js/app/cache — Caching primitives
2
2
 
3
+ import { estimateByteSize } from './sizeof.ts';
4
+
3
5
  export interface CacheHandler {
4
6
  get(key: string): Promise<{ value: unknown; stale: boolean } | null>;
5
- set(key: string, value: unknown, opts: { ttl: number; tags: string[] }): Promise<void>;
7
+ set(
8
+ key: string,
9
+ value: unknown,
10
+ opts: { ttl: number; tags: string[]; generation?: number }
11
+ ): Promise<void>;
6
12
  invalidate(opts: { key?: string; tag?: string }): Promise<void>;
7
13
  }
8
14
 
@@ -12,19 +18,43 @@ export interface CacheOptions<Fn extends (...args: any[]) => any> {
12
18
  key?: (...args: Parameters<Fn>) => string;
13
19
  staleWhileRevalidate?: boolean;
14
20
  tags?: string[] | ((...args: Parameters<Fn>) => string[]);
21
+ /** Timeout (ms) for singleflight-coalesced calls. Prevents hung fn() from
22
+ * permanently blocking all future callers for the same cache key. See TIM-518. */
23
+ timeoutMs?: number;
15
24
  }
16
25
 
17
26
  export interface MemoryCacheHandlerOptions {
18
27
  /** Maximum number of entries. Oldest accessed entries are evicted first. Default: 1000. */
28
+ maxEntries?: number;
29
+ /**
30
+ * @deprecated Use `maxEntries` instead. Will be removed in a future release.
31
+ * Alias for `maxEntries` — maximum number of entries (not bytes).
32
+ */
19
33
  maxSize?: number;
34
+ /** Maximum total byte budget for all cached values. Oldest entries are evicted when exceeded. Default: no limit. */
35
+ maxBytes?: number;
36
+ /** Maximum byte size for a single cache entry. Entries exceeding this are silently dropped. Default: no limit. */
37
+ maxEntryBytes?: number;
20
38
  }
21
39
 
22
40
  export class MemoryCacheHandler implements CacheHandler {
23
- private store = new Map<string, { value: unknown; expiresAt: number; tags: string[] }>();
24
- private maxSize: number;
41
+ private store = new Map<
42
+ string,
43
+ { value: unknown; expiresAt: number; tags: string[]; byteSize: number }
44
+ >();
45
+ private generations = new Map<string, number>();
46
+ private maxEntries: number;
47
+ private maxBytes: number | undefined;
48
+ private maxEntryBytes: number | undefined;
49
+ private currentBytes = 0;
50
+ private readonly _trackBytes: boolean;
25
51
 
26
52
  constructor(opts?: MemoryCacheHandlerOptions) {
27
- this.maxSize = opts?.maxSize ?? 1000;
53
+ // maxEntries takes precedence over deprecated maxSize
54
+ this.maxEntries = opts?.maxEntries ?? opts?.maxSize ?? 1000;
55
+ this.maxBytes = opts?.maxBytes;
56
+ this.maxEntryBytes = opts?.maxEntryBytes;
57
+ this._trackBytes = this.maxBytes !== undefined || this.maxEntryBytes !== undefined;
28
58
  }
29
59
 
30
60
  async get(key: string) {
@@ -39,37 +69,76 @@ export class MemoryCacheHandler implements CacheHandler {
39
69
  return { value: entry.value, stale };
40
70
  }
41
71
 
42
- async set(key: string, value: unknown, opts: { ttl: number; tags: string[] }) {
43
- // If key already exists, delete first to refresh insertion order
72
+ async set(
73
+ key: string,
74
+ value: unknown,
75
+ opts: { ttl: number; tags: string[]; generation?: number }
76
+ ) {
77
+ // CAS guard: skip write if a newer generation has already been written
78
+ if (opts.generation !== undefined) {
79
+ const current = this.generations.get(key) ?? 0;
80
+ if (opts.generation < current) return;
81
+ }
82
+
83
+ const byteSize = this._trackBytes ? estimateByteSize(value) : 0;
84
+
85
+ // Reject entries exceeding per-entry byte limit
86
+ if (this.maxEntryBytes !== undefined && byteSize > this.maxEntryBytes) {
87
+ return;
88
+ }
89
+
90
+ // If key already exists, delete first to refresh insertion order and reclaim bytes
44
91
  if (this.store.has(key)) {
92
+ const existing = this.store.get(key)!;
93
+ this.currentBytes -= existing.byteSize;
45
94
  this.store.delete(key);
46
95
  }
47
96
 
48
- // Evict oldest entries (front of Map) if at capacity
49
- while (this.store.size >= this.maxSize) {
50
- const oldest = this.store.keys().next().value;
51
- if (oldest !== undefined) {
52
- this.store.delete(oldest);
53
- } else {
54
- break;
97
+ // Evict oldest entries (front of Map) if at entry count capacity
98
+ while (this.store.size >= this.maxEntries) {
99
+ this.evictOldest();
100
+ }
101
+
102
+ // Evict oldest entries if byte budget would be exceeded
103
+ if (this.maxBytes !== undefined) {
104
+ while (this.currentBytes + byteSize > this.maxBytes && this.store.size > 0) {
105
+ this.evictOldest();
106
+ }
107
+ // If the single entry exceeds the total byte budget, don't store it
108
+ if (this.currentBytes + byteSize > this.maxBytes) {
109
+ return;
55
110
  }
56
111
  }
57
112
 
113
+ // Record generation only after all admission checks pass
114
+ if (opts.generation !== undefined) {
115
+ this.generations.set(key, opts.generation);
116
+ }
117
+
58
118
  this.store.set(key, {
59
119
  value,
60
120
  expiresAt: Date.now() + opts.ttl * 1000,
61
121
  tags: opts.tags,
122
+ byteSize,
62
123
  });
124
+ this.currentBytes += byteSize;
63
125
  }
64
126
 
65
127
  async invalidate(opts: { key?: string; tag?: string }) {
66
128
  if (opts.key) {
67
- this.store.delete(opts.key);
129
+ const entry = this.store.get(opts.key);
130
+ if (entry) {
131
+ this.currentBytes -= entry.byteSize;
132
+ this.store.delete(opts.key);
133
+ }
134
+ this.generations.delete(opts.key);
68
135
  }
69
136
  if (opts.tag) {
70
137
  for (const [key, entry] of this.store) {
71
138
  if (entry.tags.includes(opts.tag)) {
139
+ this.currentBytes -= entry.byteSize;
72
140
  this.store.delete(key);
141
+ this.generations.delete(key);
73
142
  }
74
143
  }
75
144
  }
@@ -79,13 +148,37 @@ export class MemoryCacheHandler implements CacheHandler {
79
148
  get size(): number {
80
149
  return this.store.size;
81
150
  }
151
+
152
+ /** Estimated total byte size of all cached values. Only tracked when maxBytes or maxEntryBytes is configured; returns 0 otherwise. */
153
+ get bytes(): number {
154
+ return this.currentBytes;
155
+ }
156
+
157
+ /** Evict the oldest entry (front of Map). */
158
+ private evictOldest(): void {
159
+ const oldest = this.store.keys().next().value;
160
+ if (oldest !== undefined) {
161
+ const entry = this.store.get(oldest)!;
162
+ this.currentBytes -= entry.byteSize;
163
+ this.store.delete(oldest);
164
+ this.generations.delete(oldest);
165
+ }
166
+ }
82
167
  }
83
168
 
84
- export { RedisCacheHandler } from './redis-handler';
85
- export type { RedisClient } from './redis-handler';
86
- export { createCache } from './timber-cache';
87
- export { registerCachedFunction } from './register-cached-function';
88
- export type { RegisterCachedFunctionOptions } from './register-cached-function';
89
- export { stableStringify } from './stable-stringify';
90
- export { createSingleflight } from './singleflight';
91
- export type { Singleflight } from './singleflight';
169
+ export { RedisCacheHandler } from './redis-handler.ts';
170
+ export type { RedisClient, RedisWriteOp } from './redis-handler.ts';
171
+ export { cache } from './cache-api.ts';
172
+ export { setCacheHandler, getCacheHandler } from './handler-store.ts';
173
+ export { setDefaultSingleflightTimeout } from './timber-cache.ts';
174
+ // NOTE: registerCachedFunction (runtime for 'use cache' directive) removed.
175
+ // Future feature pending design doc. See design/06-caching.md.
176
+ export { estimateByteSize } from './sizeof.ts';
177
+
178
+ // --- Cache Store layering (design/46) ---
179
+ export { TagAwareCacheHandler } from './tag-aware-handler.ts';
180
+ export type { CacheStore } from './store.ts';
181
+ // stableStringify, createSingleflight, and SingleflightTimeoutError are
182
+ // internal utilities used by the cache implementation. They are not
183
+ // re-exported here — import directly from the source files if needed
184
+ // within the package. See TIM-720.
@@ -0,0 +1,105 @@
1
+ /**
2
+ * Per-process invalidation epoch tracking for timber.cache (TIM-1028).
3
+ *
4
+ * handler.set for a cache miss runs after `fn()` resolves. An explicit
5
+ * `cache.invalidate({ tag })` / `revalidateTag` that lands while fn is in
6
+ * flight would otherwise be silently undone — the just-invalidated value
7
+ * re-stored as fresh for the full TTL, resurrecting pre-mutation data.
8
+ *
9
+ * Every invalidation bumps a monotonic epoch and records it against the
10
+ * invalidated key/tag. Before storing a result, the cache wrapper checks
11
+ * whether its key or any of its tags were invalidated after fn started and
12
+ * skips the write if so. Skipping is always safe: the only cost is one
13
+ * extra cache miss on the next call.
14
+ *
15
+ * Scope: per-process, like the singleflight map. An invalidation issued by
16
+ * another instance against a shared handler (Redis/KV) during fn flight is
17
+ * not observable here — closing that window fully would require store-level
18
+ * versioning, which no CacheHandler backend offers.
19
+ */
20
+
21
+ let epoch = 0;
22
+
23
+ /**
24
+ * Last-invalidated epoch per `key:<k>` / `tag:<t>` entry. Insertion order is
25
+ * epoch order (entries are re-inserted on update), so the oldest entry is
26
+ * always first — pruning evicts lowest epochs.
27
+ */
28
+ const lastInvalidated = new Map<string, number>();
29
+
30
+ /**
31
+ * Bound on tracked entries so high-cardinality tag invalidation (e.g.
32
+ * per-user tags) cannot grow this map without limit.
33
+ */
34
+ const MAX_TRACKED_ENTRIES = 10_000;
35
+
36
+ /**
37
+ * Every execution that started at or before this epoch counts as
38
+ * invalidated. Raised by eviction (history was truncated, so we can no
39
+ * longer prove an execution wasn't invalidated) and by
40
+ * `recordInvalidationOfAll()`.
41
+ */
42
+ let invalidatedEpochFloor = 0;
43
+
44
+ /** The current epoch. Capture before running fn(), pass to wasInvalidatedSince. */
45
+ export function currentInvalidationEpoch(): number {
46
+ return epoch;
47
+ }
48
+
49
+ /**
50
+ * Record an invalidation. Call BEFORE handler.invalidate() so an execution
51
+ * whose set-check races the invalidation errs toward skipping the write.
52
+ */
53
+ export function recordInvalidation(opts: { key?: string; tag?: string }): void {
54
+ epoch++;
55
+ if (opts.key) track(`key:${opts.key}`);
56
+ if (opts.tag) track(`tag:${opts.tag}`);
57
+ }
58
+
59
+ /**
60
+ * Record an invalidation of every key and tag at once. The dev server
61
+ * calls this on a source change (server/prebuilt/dev-store.ts): any cached
62
+ * render in flight may have loaded the pre-change code, so none of them may
63
+ * store, and a caller arriving after the change must not join their flight.
64
+ */
65
+ export function recordInvalidationOfAll(): void {
66
+ epoch++;
67
+ invalidatedEpochFloor = epoch;
68
+ }
69
+
70
+ function track(entry: string): void {
71
+ lastInvalidated.delete(entry);
72
+ lastInvalidated.set(entry, epoch);
73
+ while (lastInvalidated.size > MAX_TRACKED_ENTRIES) {
74
+ const oldest = lastInvalidated.entries().next().value;
75
+ if (oldest === undefined) break;
76
+ invalidatedEpochFloor = Math.max(invalidatedEpochFloor, oldest[1]);
77
+ lastInvalidated.delete(oldest[0]);
78
+ }
79
+ }
80
+
81
+ /**
82
+ * Whether the key or any tag was invalidated after `startEpoch` (the epoch
83
+ * captured when fn started executing).
84
+ */
85
+ export function wasInvalidatedSince(startEpoch: number, key: string, tags: string[]): boolean {
86
+ return lastInvalidationEpochFor(key, tags) > startEpoch;
87
+ }
88
+
89
+ /**
90
+ * The highest epoch at which the key or any of the tags was invalidated
91
+ * (0 if never). Used to scope the singleflight key: callers arriving after
92
+ * an invalidation must not coalesce onto a flight that started before it —
93
+ * they would receive the pre-invalidation result the invalidation was
94
+ * issued to discard.
95
+ */
96
+ export function lastInvalidationEpochFor(key: string, tags: string[]): number {
97
+ let last = invalidatedEpochFloor;
98
+ const keyEpoch = lastInvalidated.get(`key:${key}`);
99
+ if (keyEpoch !== undefined && keyEpoch > last) last = keyEpoch;
100
+ for (const tag of tags) {
101
+ const tagEpoch = lastInvalidated.get(`tag:${tag}`);
102
+ if (tagEpoch !== undefined && tagEpoch > last) last = tagEpoch;
103
+ }
104
+ return last;
105
+ }