@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.231
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.
- package/LICENSE +8 -0
- package/agent-skill.md +389 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-CYjRMpZI.js +1273 -0
- package/dist/_chunks/actions-CYjRMpZI.js.map +1 -0
- package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
- package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
- package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
- package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
- package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
- package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
- package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
- package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
- package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
- package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
- package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
- package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
- package/dist/_chunks/chains-D-RRc7CM.js +266 -0
- package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
- package/dist/_chunks/chains-KblEfYzm.js +1 -0
- package/dist/_chunks/classify-_W0RWa5w.js +146 -0
- package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
- package/dist/_chunks/cli-check-BAKOSTkg.js +251 -0
- package/dist/_chunks/cli-check-BAKOSTkg.js.map +1 -0
- package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
- package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
- package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
- package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
- package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
- package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
- package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
- package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
- package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
- package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
- package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
- package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
- package/dist/_chunks/codec-registry-C8hOGmZo.js +13 -0
- package/dist/_chunks/codec-registry-C8hOGmZo.js.map +1 -0
- package/dist/_chunks/codegen-vaCyFyVN.js +479 -0
- package/dist/_chunks/codegen-vaCyFyVN.js.map +1 -0
- package/dist/_chunks/convention-lint-D54k6uUM.js +578 -0
- package/dist/_chunks/convention-lint-D54k6uUM.js.map +1 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
- package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
- package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
- package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
- package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
- package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
- package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
- package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
- package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
- package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
- package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
- package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
- package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
- package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
- package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
- package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
- package/dist/_chunks/format-DuPOoXUP.js +13 -0
- package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
- package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
- package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
- package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
- package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
- package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
- package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
- package/dist/_chunks/href-BtspoNc9.js +164 -0
- package/dist/_chunks/href-BtspoNc9.js.map +1 -0
- package/dist/_chunks/href-validation-DNg-zV7u.js +102 -0
- package/dist/_chunks/href-validation-DNg-zV7u.js.map +1 -0
- package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
- package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
- package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
- package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
- package/dist/_chunks/logger-YtMSKfft.js +755 -0
- package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
- package/dist/_chunks/merge-search-params-7o_5yX0L.js +111 -0
- package/dist/_chunks/merge-search-params-7o_5yX0L.js.map +1 -0
- package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
- package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
- package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
- package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
- package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
- package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
- package/dist/_chunks/param-value-DqlGfF57.js +65 -0
- package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
- package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
- package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
- package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
- package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
- package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
- package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
- package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
- package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
- package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
- package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
- package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
- package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
- package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
- package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
- package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
- package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
- package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
- package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
- package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
- package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
- package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
- package/dist/_chunks/scan-CyizcBiX.js +139 -0
- package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
- package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
- package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
- package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
- package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
- package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
- package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
- package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
- package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
- package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
- package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
- package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
- package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
- package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
- package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
- package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
- package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
- package/dist/_chunks/state-B-EBjeER.js +49 -0
- package/dist/_chunks/state-B-EBjeER.js.map +1 -0
- package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
- package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
- package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
- package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
- package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
- package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
- package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
- package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
- package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
- package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
- package/dist/adapters/build-output-helper.d.ts +81 -0
- package/dist/adapters/build-output-helper.d.ts.map +1 -0
- package/dist/adapters/canonicalize-module.d.ts +8 -0
- package/dist/adapters/canonicalize-module.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.d.ts +109 -0
- package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.js +73 -0
- package/dist/adapters/cloudflare-dev.js.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.js +122 -0
- package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
- package/dist/adapters/cloudflare.d.ts +217 -24
- package/dist/adapters/cloudflare.d.ts.map +1 -1
- package/dist/adapters/cloudflare.js +1 -188
- package/dist/adapters/compress-module.d.ts +25 -4
- package/dist/adapters/compress-module.d.ts.map +1 -1
- package/dist/adapters/fs-identity.d.ts +63 -0
- package/dist/adapters/fs-identity.d.ts.map +1 -0
- package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
- package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
- package/dist/adapters/nitro-presets.d.ts +37 -0
- package/dist/adapters/nitro-presets.d.ts.map +1 -0
- package/dist/adapters/nitro-preview.d.ts +65 -0
- package/dist/adapters/nitro-preview.d.ts.map +1 -0
- package/dist/adapters/nitro.d.ts +69 -38
- package/dist/adapters/nitro.d.ts.map +1 -1
- package/dist/adapters/nitro.js +837 -347
- package/dist/adapters/nitro.js.map +1 -1
- package/dist/adapters/shared.d.ts +85 -0
- package/dist/adapters/shared.d.ts.map +1 -0
- package/dist/adapters/types.d.ts +124 -16
- package/dist/adapters/types.d.ts.map +1 -1
- package/dist/adapters/types.js +0 -0
- package/dist/analyze/chains.d.ts +124 -0
- package/dist/analyze/chains.d.ts.map +1 -0
- package/dist/analyze/classify.d.ts +153 -0
- package/dist/analyze/classify.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.d.ts +17 -0
- package/dist/analyze/crawl-entry.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.js +312 -0
- package/dist/analyze/crawl-entry.js.map +1 -0
- package/dist/analyze/crawl.d.ts +134 -0
- package/dist/analyze/crawl.d.ts.map +1 -0
- package/dist/analyze/graph-cache.d.ts +104 -0
- package/dist/analyze/graph-cache.d.ts.map +1 -0
- package/dist/analyze/graph-command.d.ts +43 -0
- package/dist/analyze/graph-command.d.ts.map +1 -0
- package/dist/analyze/graph-command.js +386 -0
- package/dist/analyze/graph-command.js.map +1 -0
- package/dist/analyze/live-graph.d.ts +81 -0
- package/dist/analyze/live-graph.d.ts.map +1 -0
- package/dist/analyze/poison-rules.d.ts +72 -0
- package/dist/analyze/poison-rules.d.ts.map +1 -0
- package/dist/analyze/poison-scan.d.ts +48 -0
- package/dist/analyze/poison-scan.d.ts.map +1 -0
- package/dist/analyze/scan.d.ts +73 -0
- package/dist/analyze/scan.d.ts.map +1 -0
- package/dist/cache/cache-api.d.ts +48 -0
- package/dist/cache/cache-api.d.ts.map +1 -0
- package/dist/cache/fast-hash.d.ts +5 -0
- package/dist/cache/fast-hash.d.ts.map +1 -1
- package/dist/cache/guarded-read.d.ts +29 -0
- package/dist/cache/guarded-read.d.ts.map +1 -0
- package/dist/cache/handler-store.d.ts +45 -0
- package/dist/cache/handler-store.d.ts.map +1 -0
- package/dist/cache/index.d.ts +32 -9
- package/dist/cache/index.d.ts.map +1 -1
- package/dist/cache/index.js +4 -326
- package/dist/cache/invalidation-epoch.d.ts +50 -0
- package/dist/cache/invalidation-epoch.d.ts.map +1 -0
- package/dist/cache/json-lossy-check.d.ts +11 -0
- package/dist/cache/json-lossy-check.d.ts.map +1 -0
- package/dist/cache/key-discipline.d.ts +61 -0
- package/dist/cache/key-discipline.d.ts.map +1 -0
- package/dist/cache/redis-handler.d.ts +140 -9
- package/dist/cache/redis-handler.d.ts.map +1 -1
- package/dist/cache/singleflight.d.ts +31 -2
- package/dist/cache/singleflight.d.ts.map +1 -1
- package/dist/cache/sizeof.d.ts +22 -0
- package/dist/cache/sizeof.d.ts.map +1 -0
- package/dist/cache/stable-stringify.d.ts +15 -0
- package/dist/cache/stable-stringify.d.ts.map +1 -1
- package/dist/cache/store.d.ts +53 -0
- package/dist/cache/store.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
- package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.js +28 -0
- package/dist/cache/stores/cloudflare-kv.js.map +1 -0
- package/dist/cache/stores/memory.d.ts +42 -0
- package/dist/cache/stores/memory.d.ts.map +1 -0
- package/dist/cache/stores/memory.js +89 -0
- package/dist/cache/stores/memory.js.map +1 -0
- package/dist/cache/stores/redis.d.ts +69 -0
- package/dist/cache/stores/redis.d.ts.map +1 -0
- package/dist/cache/stores/redis.js +34 -0
- package/dist/cache/stores/redis.js.map +1 -0
- package/dist/cache/stores/vercel.d.ts +36 -0
- package/dist/cache/stores/vercel.d.ts.map +1 -0
- package/dist/cache/stores/vercel.js +32 -0
- package/dist/cache/stores/vercel.js.map +1 -0
- package/dist/cache/tag-aware-handler.d.ts +51 -0
- package/dist/cache/tag-aware-handler.d.ts.map +1 -0
- package/dist/cache/timber-cache.d.ts +25 -11
- package/dist/cache/timber-cache.d.ts.map +1 -1
- package/dist/cdn/cloudflare-purge.d.ts +23 -0
- package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
- package/dist/cdn/cloudflare-purge.js +29 -0
- package/dist/cdn/cloudflare-purge.js.map +1 -0
- package/dist/cdn/fastly-purge.d.ts +25 -0
- package/dist/cdn/fastly-purge.d.ts.map +1 -0
- package/dist/cdn/fastly-purge.js +32 -0
- package/dist/cdn/fastly-purge.js.map +1 -0
- package/dist/cdn/headers.d.ts +97 -0
- package/dist/cdn/headers.d.ts.map +1 -0
- package/dist/cdn/index.d.ts +5 -0
- package/dist/cdn/index.d.ts.map +1 -0
- package/dist/cdn/index.js +93 -0
- package/dist/cdn/index.js.map +1 -0
- package/dist/cdn/purge-store.d.ts +32 -0
- package/dist/cdn/purge-store.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.d.ts +20 -0
- package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.js +33 -0
- package/dist/cdn/workers-cache-purge.js.map +1 -0
- package/dist/cli-check.d.ts +133 -0
- package/dist/cli-check.d.ts.map +1 -0
- package/dist/cli-context.d.ts +62 -0
- package/dist/cli-context.d.ts.map +1 -0
- package/dist/cli-dev-status.d.ts +75 -0
- package/dist/cli-dev-status.d.ts.map +1 -0
- package/dist/cli-init.d.ts +72 -0
- package/dist/cli-init.d.ts.map +1 -0
- package/dist/cli-schema-sync.d.ts +59 -0
- package/dist/cli-schema-sync.d.ts.map +1 -0
- package/dist/cli.d.ts +80 -16
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +210 -69
- package/dist/cli.js.map +1 -1
- package/dist/client/browser-dev.d.ts +42 -2
- package/dist/client/browser-dev.d.ts.map +1 -1
- package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
- package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
- package/dist/client/browser-entry/action-queue.d.ts +64 -0
- package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
- package/dist/client/browser-entry/form-state.d.ts +22 -0
- package/dist/client/browser-entry/form-state.d.ts.map +1 -0
- package/dist/client/browser-entry/hmr.d.ts +27 -0
- package/dist/client/browser-entry/hmr.d.ts.map +1 -0
- package/dist/client/browser-entry/hydrate.d.ts +61 -0
- package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
- package/dist/client/browser-entry/index.d.ts +32 -0
- package/dist/client/browser-entry/index.d.ts.map +1 -0
- package/dist/client/browser-entry/post-hydration.d.ts +26 -0
- package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
- package/dist/client/browser-entry/router-init.d.ts +41 -0
- package/dist/client/browser-entry/router-init.d.ts.map +1 -0
- package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
- package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
- package/dist/client/browser-entry/scroll.d.ts +28 -0
- package/dist/client/browser-entry/scroll.d.ts.map +1 -0
- package/dist/client/deny-last-resort.d.ts +29 -0
- package/dist/client/deny-last-resort.d.ts.map +1 -0
- package/dist/client/dev-pill/index.d.ts +32 -0
- package/dist/client/dev-pill/index.d.ts.map +1 -0
- package/dist/client/dev-pill/store.d.ts +105 -0
- package/dist/client/dev-pill/store.d.ts.map +1 -0
- package/dist/client/dev-pill/view.d.ts +9 -0
- package/dist/client/dev-pill/view.d.ts.map +1 -0
- package/dist/client/error-boundary.d.ts +58 -9
- package/dist/client/error-boundary.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -126
- package/dist/client/error-reconstituter.d.ts +55 -0
- package/dist/client/error-reconstituter.d.ts.map +1 -0
- package/dist/client/form.d.ts +38 -99
- package/dist/client/form.d.ts.map +1 -1
- package/dist/client/global-context.d.ts +35 -0
- package/dist/client/global-context.d.ts.map +1 -0
- package/dist/client/history.d.ts +50 -9
- package/dist/client/history.d.ts.map +1 -1
- package/dist/client/index.d.ts +23 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +330 -1273
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.d.ts +20 -0
- package/dist/client/internal.d.ts.map +1 -0
- package/dist/client/internal.js +785 -0
- package/dist/client/internal.js.map +1 -0
- package/dist/client/link.d.ts +75 -71
- package/dist/client/link.d.ts.map +1 -1
- package/dist/client/location-search.d.ts +12 -0
- package/dist/client/location-search.d.ts.map +1 -0
- package/dist/client/navigation-api.d.ts +95 -0
- package/dist/client/navigation-api.d.ts.map +1 -0
- package/dist/client/navigation-commit.d.ts +111 -0
- package/dist/client/navigation-commit.d.ts.map +1 -0
- package/dist/client/navigation-context.d.ts +75 -37
- package/dist/client/navigation-context.d.ts.map +1 -1
- package/dist/client/navigation-root.d.ts +106 -0
- package/dist/client/navigation-root.d.ts.map +1 -0
- package/dist/client/navigation-transition.d.ts +255 -0
- package/dist/client/navigation-transition.d.ts.map +1 -0
- package/dist/client/nuqs-adapter.d.ts +5 -2
- package/dist/client/nuqs-adapter.d.ts.map +1 -1
- package/dist/client/params-context.d.ts +81 -0
- package/dist/client/params-context.d.ts.map +1 -0
- package/dist/client/react-root.d.ts +51 -0
- package/dist/client/react-root.d.ts.map +1 -0
- package/dist/client/router-effects.d.ts +203 -0
- package/dist/client/router-effects.d.ts.map +1 -0
- package/dist/client/router-lifecycle.d.ts +107 -0
- package/dist/client/router-lifecycle.d.ts.map +1 -0
- package/dist/client/router-pipeline.d.ts +81 -0
- package/dist/client/router-pipeline.d.ts.map +1 -0
- package/dist/client/router-ref.d.ts +2 -2
- package/dist/client/router-ref.d.ts.map +1 -1
- package/dist/client/router-skew.d.ts +21 -0
- package/dist/client/router-skew.d.ts.map +1 -0
- package/dist/client/router-types.d.ts +294 -0
- package/dist/client/router-types.d.ts.map +1 -0
- package/dist/client/router-url.d.ts +24 -0
- package/dist/client/router-url.d.ts.map +1 -0
- package/dist/client/router.d.ts +1 -97
- package/dist/client/router.d.ts.map +1 -1
- package/dist/client/rsc-fetch.d.ts +110 -28
- package/dist/client/rsc-fetch.d.ts.map +1 -1
- package/dist/client/segment-cache.d.ts +186 -25
- package/dist/client/segment-cache.d.ts.map +1 -1
- package/dist/client/segment-context.d.ts.map +1 -1
- package/dist/client/segment-outlet.d.ts +68 -0
- package/dist/client/segment-outlet.d.ts.map +1 -0
- package/dist/client/segment-update-context.d.ts +15 -0
- package/dist/client/segment-update-context.d.ts.map +1 -0
- package/dist/client/shallow-url.d.ts +10 -0
- package/dist/client/shallow-url.d.ts.map +1 -0
- package/dist/client/slot-content-cache-context.d.ts +35 -0
- package/dist/client/slot-content-cache-context.d.ts.map +1 -0
- package/dist/client/slot-context.d.ts +31 -0
- package/dist/client/slot-context.d.ts.map +1 -0
- package/dist/client/slot-outlet.d.ts +16 -0
- package/dist/client/slot-outlet.d.ts.map +1 -0
- package/dist/client/slot-provider.d.ts +25 -0
- package/dist/client/slot-provider.d.ts.map +1 -0
- package/dist/client/ssr-data.d.ts +26 -50
- package/dist/client/ssr-data.d.ts.map +1 -1
- package/dist/client/stale-client.d.ts +69 -0
- package/dist/client/stale-client.d.ts.map +1 -0
- package/dist/client/state.d.ts +21 -13
- package/dist/client/state.d.ts.map +1 -1
- package/dist/client/status-page-marker.d.ts +25 -0
- package/dist/client/status-page-marker.d.ts.map +1 -0
- package/dist/client/top-loader.d.ts +7 -6
- package/dist/client/top-loader.d.ts.map +1 -1
- package/dist/client/unload-guard.d.ts +5 -0
- package/dist/client/unload-guard.d.ts.map +1 -1
- package/dist/client/use-cookie.d.ts +25 -0
- package/dist/client/use-cookie.d.ts.map +1 -1
- package/dist/client/use-field-state.d.ts +42 -0
- package/dist/client/use-field-state.d.ts.map +1 -0
- package/dist/client/use-link-status.d.ts +5 -5
- package/dist/client/use-link-status.d.ts.map +1 -1
- package/dist/client/use-pathname.d.ts +13 -11
- package/dist/client/use-pathname.d.ts.map +1 -1
- package/dist/client/use-pending-navigation.d.ts +47 -0
- package/dist/client/use-pending-navigation.d.ts.map +1 -0
- package/dist/client/use-query-states.d.ts +10 -4
- package/dist/client/use-query-states.d.ts.map +1 -1
- package/dist/client/use-router.d.ts +15 -8
- package/dist/client/use-router.d.ts.map +1 -1
- package/dist/client/use-search-params.d.ts +15 -8
- package/dist/client/use-search-params.d.ts.map +1 -1
- package/dist/client/use-segment-params.d.ts +55 -0
- package/dist/client/use-segment-params.d.ts.map +1 -0
- package/dist/codec.d.ts +69 -0
- package/dist/codec.d.ts.map +1 -0
- package/dist/codec.js +75 -0
- package/dist/codec.js.map +1 -0
- package/dist/config-types.d.ts +366 -0
- package/dist/config-types.d.ts.map +1 -0
- package/dist/config-validation.d.ts +68 -0
- package/dist/config-validation.d.ts.map +1 -0
- package/dist/cookies/define-cookie.d.ts +58 -25
- package/dist/cookies/define-cookie.d.ts.map +1 -1
- package/dist/cookies/index.d.ts +3 -2
- package/dist/cookies/index.d.ts.map +1 -1
- package/dist/cookies/index.js +230 -37
- package/dist/cookies/index.js.map +1 -1
- package/dist/cookies/json-cookie.d.ts +64 -0
- package/dist/cookies/json-cookie.d.ts.map +1 -0
- package/dist/cookies/validation.d.ts +34 -0
- package/dist/cookies/validation.d.ts.map +1 -0
- package/dist/dev-tools/404-page.d.ts +50 -0
- package/dist/dev-tools/404-page.d.ts.map +1 -0
- package/dist/dev-tools/await-span.d.ts +17 -0
- package/dist/dev-tools/await-span.d.ts.map +1 -0
- package/dist/dev-tools/browser-logs.d.ts +40 -0
- package/dist/dev-tools/browser-logs.d.ts.map +1 -0
- package/dist/dev-tools/dev-page-shell.d.ts +95 -0
- package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
- package/dist/dev-tools/error-page.d.ts +32 -0
- package/dist/dev-tools/error-page.d.ts.map +1 -0
- package/dist/dev-tools/holding-server.d.ts +46 -0
- package/dist/dev-tools/holding-server.d.ts.map +1 -0
- package/dist/dev-tools/hydration-overlay.d.ts +11 -0
- package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
- package/dist/dev-tools/index.d.ts +31 -0
- package/dist/dev-tools/index.d.ts.map +1 -0
- package/dist/dev-tools/instrumentation.d.ts +74 -0
- package/dist/dev-tools/instrumentation.d.ts.map +1 -0
- package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
- package/dist/dev-tools/logger.d.ts.map +1 -0
- package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
- package/dist/dev-tools/logs.d.ts.map +1 -0
- package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
- package/dist/dev-tools/overlay.d.ts.map +1 -0
- package/dist/dev-tools/span-sink.d.ts +42 -0
- package/dist/dev-tools/span-sink.d.ts.map +1 -0
- package/dist/dev-tools/stack-classifier.d.ts +34 -0
- package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
- package/dist/dev-tools/terminal.d.ts +28 -0
- package/dist/dev-tools/terminal.d.ts.map +1 -0
- package/dist/fonts/ast-walk.d.ts +68 -0
- package/dist/fonts/ast-walk.d.ts.map +1 -0
- package/dist/fonts/ast.d.ts +112 -8
- package/dist/fonts/ast.d.ts.map +1 -1
- package/dist/fonts/bundle.d.ts +50 -0
- package/dist/fonts/bundle.d.ts.map +1 -0
- package/dist/fonts/css.d.ts +1 -1
- package/dist/fonts/dev-middleware.d.ts +22 -0
- package/dist/fonts/dev-middleware.d.ts.map +1 -0
- package/dist/fonts/fallbacks.d.ts +0 -7
- package/dist/fonts/fallbacks.d.ts.map +1 -1
- package/dist/fonts/google.d.ts +5 -3
- package/dist/fonts/google.d.ts.map +1 -1
- package/dist/fonts/local.d.ts +5 -5
- package/dist/fonts/local.d.ts.map +1 -1
- package/dist/fonts/paths.d.ts +43 -0
- package/dist/fonts/paths.d.ts.map +1 -0
- package/dist/fonts/pipeline.d.ts +177 -0
- package/dist/fonts/pipeline.d.ts.map +1 -0
- package/dist/fonts/transform.d.ts +82 -0
- package/dist/fonts/transform.d.ts.map +1 -0
- package/dist/fonts/types.d.ts +47 -1
- package/dist/fonts/types.d.ts.map +1 -1
- package/dist/fonts/virtual-modules.d.ts +77 -0
- package/dist/fonts/virtual-modules.d.ts.map +1 -0
- package/dist/index.d.ts +37 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9952 -14264
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +36 -0
- package/dist/params/codec-registry.d.ts.map +1 -0
- package/dist/params/define-schema.d.ts +81 -0
- package/dist/params/define-schema.d.ts.map +1 -0
- package/dist/params/index.d.ts +4 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +32 -0
- package/dist/params/index.js.map +1 -0
- package/dist/params/resolve-schema.d.ts +34 -0
- package/dist/params/resolve-schema.d.ts.map +1 -0
- package/dist/plugin-context.d.ts +269 -0
- package/dist/plugin-context.d.ts.map +1 -0
- package/dist/plugins/build-manifest.d.ts +7 -3
- package/dist/plugins/build-manifest.d.ts.map +1 -1
- package/dist/plugins/build-report.d.ts +61 -11
- package/dist/plugins/build-report.d.ts.map +1 -1
- package/dist/plugins/cache.d.ts +64 -0
- package/dist/plugins/cache.d.ts.map +1 -0
- package/dist/plugins/callsite-ast.d.ts +117 -0
- package/dist/plugins/callsite-ast.d.ts.map +1 -0
- package/dist/plugins/callsite-jsx.d.ts +35 -0
- package/dist/plugins/callsite-jsx.d.ts.map +1 -0
- package/dist/plugins/chunks.d.ts +11 -4
- package/dist/plugins/chunks.d.ts.map +1 -1
- package/dist/plugins/client-chunks.d.ts +40 -0
- package/dist/plugins/client-chunks.d.ts.map +1 -0
- package/dist/plugins/client-dep-entries.d.ts +80 -0
- package/dist/plugins/client-dep-entries.d.ts.map +1 -0
- package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
- package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
- package/dist/plugins/cloudflare-wasm.d.ts +21 -0
- package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
- package/dist/plugins/content.d.ts +1 -1
- package/dist/plugins/content.d.ts.map +1 -1
- package/dist/plugins/dev-await.d.ts +81 -0
- package/dist/plugins/dev-await.d.ts.map +1 -0
- package/dist/plugins/dev-discovery.d.ts +187 -0
- package/dist/plugins/dev-discovery.d.ts.map +1 -0
- package/dist/plugins/dev-hostname.d.ts +152 -0
- package/dist/plugins/dev-hostname.d.ts.map +1 -0
- package/dist/plugins/dev-server.d.ts +29 -2
- package/dist/plugins/dev-server.d.ts.map +1 -1
- package/dist/plugins/dev-store-clear.d.ts +83 -0
- package/dist/plugins/dev-store-clear.d.ts.map +1 -0
- package/dist/plugins/encryption-runtime.d.ts +13 -0
- package/dist/plugins/encryption-runtime.d.ts.map +1 -0
- package/dist/plugins/entries.d.ts +40 -4
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/plugins/fonts.d.ts +35 -74
- package/dist/plugins/fonts.d.ts.map +1 -1
- package/dist/plugins/graph-endpoint.d.ts +114 -0
- package/dist/plugins/graph-endpoint.d.ts.map +1 -0
- package/dist/plugins/mdx.d.ts +18 -5
- package/dist/plugins/mdx.d.ts.map +1 -1
- package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
- package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
- package/dist/plugins/optimize-package-imports.d.ts +124 -0
- package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
- package/dist/plugins/orphaned-modules.d.ts +57 -0
- package/dist/plugins/orphaned-modules.d.ts.map +1 -0
- package/dist/plugins/post-build.d.ts +110 -0
- package/dist/plugins/post-build.d.ts.map +1 -0
- package/dist/plugins/prebuilt-capture.d.ts +67 -0
- package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
- package/dist/plugins/prebuilt.d.ts +98 -0
- package/dist/plugins/prebuilt.d.ts.map +1 -0
- package/dist/plugins/prerender-sugar.d.ts +39 -0
- package/dist/plugins/prerender-sugar.d.ts.map +1 -0
- package/dist/plugins/react-resolve.d.ts +49 -0
- package/dist/plugins/react-resolve.d.ts.map +1 -0
- package/dist/plugins/request-dep/analysis.d.ts +106 -0
- package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
- package/dist/plugins/request-dep/index.d.ts +75 -0
- package/dist/plugins/request-dep/index.d.ts.map +1 -0
- package/dist/plugins/request-dep/origin.d.ts +61 -0
- package/dist/plugins/request-dep/origin.d.ts.map +1 -0
- package/dist/plugins/routing.d.ts +2 -2
- package/dist/plugins/routing.d.ts.map +1 -1
- package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
- package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
- package/dist/plugins/server-bundle.d.ts +1 -1
- package/dist/plugins/server-bundle.d.ts.map +1 -1
- package/dist/plugins/shims.d.ts +29 -5
- package/dist/plugins/shims.d.ts.map +1 -1
- package/dist/plugins/static-build.d.ts +246 -26
- package/dist/plugins/static-build.d.ts.map +1 -1
- package/dist/routes/href.d.ts +124 -0
- package/dist/routes/href.d.ts.map +1 -0
- package/dist/routes/index.d.ts +4 -0
- package/dist/routes/index.d.ts.map +1 -0
- package/dist/routes/index.js +8 -0
- package/dist/routes/index.js.map +1 -0
- package/dist/routing/codegen-shared.d.ts +26 -0
- package/dist/routing/codegen-shared.d.ts.map +1 -0
- package/dist/routing/codegen-types.d.ts +61 -0
- package/dist/routing/codegen-types.d.ts.map +1 -0
- package/dist/routing/codegen-write.d.ts +42 -0
- package/dist/routing/codegen-write.d.ts.map +1 -0
- package/dist/routing/codegen.d.ts +8 -3
- package/dist/routing/codegen.d.ts.map +1 -1
- package/dist/routing/collision-probe.d.ts +104 -0
- package/dist/routing/collision-probe.d.ts.map +1 -0
- package/dist/routing/collision-spaces.d.ts +26 -0
- package/dist/routing/collision-spaces.d.ts.map +1 -0
- package/dist/routing/convention-lint.d.ts +55 -0
- package/dist/routing/convention-lint.d.ts.map +1 -0
- package/dist/routing/export-detect.d.ts +91 -0
- package/dist/routing/export-detect.d.ts.map +1 -0
- package/dist/routing/file-cache.d.ts +8 -0
- package/dist/routing/file-cache.d.ts.map +1 -0
- package/dist/routing/index.d.ts +13 -7
- package/dist/routing/index.d.ts.map +1 -1
- package/dist/routing/index.js +5 -2
- package/dist/routing/interception-overlap.d.ts +35 -0
- package/dist/routing/interception-overlap.d.ts.map +1 -0
- package/dist/routing/interception.d.ts +234 -10
- package/dist/routing/interception.d.ts.map +1 -1
- package/dist/routing/link-codegen.d.ts +136 -0
- package/dist/routing/link-codegen.d.ts.map +1 -0
- package/dist/routing/manifest-codegen.d.ts +26 -0
- package/dist/routing/manifest-codegen.d.ts.map +1 -0
- package/dist/routing/scanner.d.ts +14 -10
- package/dist/routing/scanner.d.ts.map +1 -1
- package/dist/routing/schema-validation.d.ts +35 -0
- package/dist/routing/schema-validation.d.ts.map +1 -0
- package/dist/routing/segment-classify.d.ts +114 -0
- package/dist/routing/segment-classify.d.ts.map +1 -0
- package/dist/routing/segment-codegen.d.ts +38 -0
- package/dist/routing/segment-codegen.d.ts.map +1 -0
- package/dist/routing/segment-keys.d.ts +118 -0
- package/dist/routing/segment-keys.d.ts.map +1 -0
- package/dist/routing/slot-placement.d.ts +48 -0
- package/dist/routing/slot-placement.d.ts.map +1 -0
- package/dist/routing/types.d.ts +81 -26
- package/dist/routing/types.d.ts.map +1 -1
- package/dist/routing/walkers.d.ts +57 -0
- package/dist/routing/walkers.d.ts.map +1 -0
- package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
- package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
- package/dist/rsc-runtime/render-flight.d.ts +14 -0
- package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
- package/dist/rsc-runtime/rsc.d.ts +3 -13
- package/dist/rsc-runtime/rsc.d.ts.map +1 -1
- package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
- package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
- package/dist/rsc-runtime/server-references.d.ts +19 -0
- package/dist/rsc-runtime/server-references.d.ts.map +1 -0
- package/dist/rsc-runtime/ssr.d.ts +7 -10
- package/dist/rsc-runtime/ssr.d.ts.map +1 -1
- package/dist/rsc-runtime/transforms.d.ts +13 -0
- package/dist/rsc-runtime/transforms.d.ts.map +1 -0
- package/dist/schema-bridge.d.ts +154 -0
- package/dist/schema-bridge.d.ts.map +1 -0
- package/dist/search-params/define.d.ts +262 -0
- package/dist/search-params/define.d.ts.map +1 -0
- package/dist/search-params/index.d.ts +3 -7
- package/dist/search-params/index.d.ts.map +1 -1
- package/dist/search-params/index.js +178 -362
- package/dist/search-params/index.js.map +1 -1
- package/dist/search-params/parse-total.d.ts +81 -0
- package/dist/search-params/parse-total.d.ts.map +1 -0
- package/dist/search-params/serialize-equal.d.ts +9 -0
- package/dist/search-params/serialize-equal.d.ts.map +1 -0
- package/dist/search-params/wrappers.d.ts +76 -0
- package/dist/search-params/wrappers.d.ts.map +1 -0
- package/dist/server/abort-scope.d.ts +27 -0
- package/dist/server/abort-scope.d.ts.map +1 -0
- package/dist/server/access-gate.d.ts +110 -10
- package/dist/server/access-gate.d.ts.map +1 -1
- package/dist/server/action-client.d.ts +20 -133
- package/dist/server/action-client.d.ts.map +1 -1
- package/dist/server/action-encryption.d.ts +76 -0
- package/dist/server/action-encryption.d.ts.map +1 -0
- package/dist/server/action-handler.d.ts +60 -11
- package/dist/server/action-handler.d.ts.map +1 -1
- package/dist/server/action-schema.d.ts +126 -0
- package/dist/server/action-schema.d.ts.map +1 -0
- package/dist/server/action-types.d.ts +108 -0
- package/dist/server/action-types.d.ts.map +1 -0
- package/dist/server/actions.d.ts +78 -40
- package/dist/server/actions.d.ts.map +1 -1
- package/dist/server/als-registry.d.ts +189 -17
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/body-limits.d.ts.map +1 -1
- package/dist/server/build-manifest.d.ts +25 -30
- package/dist/server/build-manifest.d.ts.map +1 -1
- package/dist/server/canonicalize.d.ts +53 -0
- package/dist/server/canonicalize.d.ts.map +1 -1
- package/dist/server/chain-url-parts.d.ts +82 -0
- package/dist/server/chain-url-parts.d.ts.map +1 -0
- package/dist/server/children-interception.d.ts +49 -0
- package/dist/server/children-interception.d.ts.map +1 -0
- package/dist/server/client-error-message.d.ts +12 -0
- package/dist/server/client-error-message.d.ts.map +1 -0
- package/dist/server/coalesce-tick.d.ts +40 -0
- package/dist/server/coalesce-tick.d.ts.map +1 -0
- package/dist/server/compress.d.ts +2 -0
- package/dist/server/compress.d.ts.map +1 -1
- package/dist/server/cookie-context.d.ts +156 -0
- package/dist/server/cookie-context.d.ts.map +1 -0
- package/dist/server/cookie-parsing.d.ts +65 -0
- package/dist/server/cookie-parsing.d.ts.map +1 -0
- package/dist/server/csp-nonce.d.ts +36 -0
- package/dist/server/csp-nonce.d.ts.map +1 -0
- package/dist/server/csrf.d.ts +58 -15
- package/dist/server/csrf.d.ts.map +1 -1
- package/dist/server/debug.d.ts +0 -1
- package/dist/server/debug.d.ts.map +1 -1
- package/dist/server/default-logger.d.ts +23 -0
- package/dist/server/default-logger.d.ts.map +1 -0
- package/dist/server/default-status-page.d.ts +45 -0
- package/dist/server/default-status-page.d.ts.map +1 -0
- package/dist/server/deny-boundary.d.ts +257 -0
- package/dist/server/deny-boundary.d.ts.map +1 -0
- package/dist/server/deny-renderer.d.ts +22 -15
- package/dist/server/deny-renderer.d.ts.map +1 -1
- package/dist/server/early-hints-sender.d.ts.map +1 -1
- package/dist/server/early-hints.d.ts +14 -12
- package/dist/server/early-hints.d.ts.map +1 -1
- package/dist/server/error-boundary-wrapper.d.ts +102 -10
- package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
- package/dist/server/error-response-headers.d.ts +3 -0
- package/dist/server/error-response-headers.d.ts.map +1 -0
- package/dist/server/fallback-error.d.ts +19 -7
- package/dist/server/fallback-error.d.ts.map +1 -1
- package/dist/server/flight-injection-state.d.ts +66 -0
- package/dist/server/flight-injection-state.d.ts.map +1 -0
- package/dist/server/flight-injector-core.d.ts +125 -0
- package/dist/server/flight-injector-core.d.ts.map +1 -0
- package/dist/server/flight-scripts.d.ts +63 -0
- package/dist/server/flight-scripts.d.ts.map +1 -0
- package/dist/server/flight-source-node.d.ts +105 -0
- package/dist/server/flight-source-node.d.ts.map +1 -0
- package/dist/server/flight-source.d.ts +136 -0
- package/dist/server/flight-source.d.ts.map +1 -0
- package/dist/server/form-data.d.ts +59 -2
- package/dist/server/form-data.d.ts.map +1 -1
- package/dist/server/form-state-flight.d.ts +32 -0
- package/dist/server/form-state-flight.d.ts.map +1 -0
- package/dist/server/head-response.d.ts +35 -0
- package/dist/server/head-response.d.ts.map +1 -0
- package/dist/server/html-injector-core.d.ts +169 -0
- package/dist/server/html-injector-core.d.ts.map +1 -0
- package/dist/server/html-injectors.d.ts +77 -47
- package/dist/server/html-injectors.d.ts.map +1 -1
- package/dist/server/index.d.ts +16 -54
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +621 -3009
- package/dist/server/index.js.map +1 -1
- package/dist/server/instrumentation.d.ts +13 -5
- package/dist/server/instrumentation.d.ts.map +1 -1
- package/dist/server/interception-gates.d.ts +49 -0
- package/dist/server/interception-gates.d.ts.map +1 -0
- package/dist/server/internal.d.ts +48 -0
- package/dist/server/internal.d.ts.map +1 -0
- package/dist/server/internal.js +5092 -0
- package/dist/server/internal.js.map +1 -0
- package/dist/server/json-status-response.d.ts +34 -0
- package/dist/server/json-status-response.d.ts.map +1 -0
- package/dist/server/logger.d.ts +105 -7
- package/dist/server/logger.d.ts.map +1 -1
- package/dist/server/metadata-collector.d.ts +75 -0
- package/dist/server/metadata-collector.d.ts.map +1 -0
- package/dist/server/metadata-platform.d.ts +2 -2
- package/dist/server/metadata-render.d.ts +2 -2
- package/dist/server/metadata-render.d.ts.map +1 -1
- package/dist/server/metadata-route-links.d.ts +70 -0
- package/dist/server/metadata-route-links.d.ts.map +1 -0
- package/dist/server/metadata-routes.d.ts +47 -11
- package/dist/server/metadata-routes.d.ts.map +1 -1
- package/dist/server/metadata-social.d.ts +2 -2
- package/dist/server/metadata.d.ts +10 -2
- package/dist/server/metadata.d.ts.map +1 -1
- package/dist/server/middleware-runner.d.ts +20 -5
- package/dist/server/middleware-runner.d.ts.map +1 -1
- package/dist/server/node-body-response.d.ts +55 -0
- package/dist/server/node-body-response.d.ts.map +1 -0
- package/dist/server/node-response.d.ts +62 -0
- package/dist/server/node-response.d.ts.map +1 -0
- package/dist/server/node-stream-transforms.d.ts +108 -0
- package/dist/server/node-stream-transforms.d.ts.map +1 -0
- package/dist/server/node-streams-platform.d.ts +21 -0
- package/dist/server/node-streams-platform.d.ts.map +1 -0
- package/dist/server/param-coercion.d.ts +84 -0
- package/dist/server/param-coercion.d.ts.map +1 -0
- package/dist/server/pipeline-helpers.d.ts +227 -0
- package/dist/server/pipeline-helpers.d.ts.map +1 -0
- package/dist/server/pipeline-interception.d.ts +100 -9
- package/dist/server/pipeline-interception.d.ts.map +1 -1
- package/dist/server/pipeline-metadata-route.d.ts +24 -0
- package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
- package/dist/server/pipeline-metadata.d.ts +18 -2
- package/dist/server/pipeline-metadata.d.ts.map +1 -1
- package/dist/server/pipeline-outcome.d.ts +59 -0
- package/dist/server/pipeline-outcome.d.ts.map +1 -0
- package/dist/server/pipeline-phases.d.ts +76 -0
- package/dist/server/pipeline-phases.d.ts.map +1 -0
- package/dist/server/pipeline.d.ts +190 -23
- package/dist/server/pipeline.d.ts.map +1 -1
- package/dist/server/port-resolution.d.ts +22 -0
- package/dist/server/port-resolution.d.ts.map +1 -0
- package/dist/server/prebuilt/cache-key.d.ts +89 -0
- package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-render.d.ts +30 -0
- package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-routes.d.ts +37 -0
- package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-state.d.ts +101 -0
- package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
- package/dist/server/prebuilt/dev-store.d.ts +149 -0
- package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
- package/dist/server/prebuilt/lifetime.d.ts +38 -0
- package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
- package/dist/server/prebuilt/overlay.d.ts +119 -0
- package/dist/server/prebuilt/overlay.d.ts.map +1 -0
- package/dist/server/prebuilt/payload-source.d.ts +87 -0
- package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
- package/dist/server/prebuilt/slots.d.ts +105 -0
- package/dist/server/prebuilt/slots.d.ts.map +1 -0
- package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
- package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
- package/dist/server/prebuilt-builder.d.ts +121 -0
- package/dist/server/prebuilt-builder.d.ts.map +1 -0
- package/dist/server/prebuilt-runtime.d.ts +105 -0
- package/dist/server/prebuilt-runtime.d.ts.map +1 -0
- package/dist/server/primitives.d.ts +114 -90
- package/dist/server/primitives.d.ts.map +1 -1
- package/dist/server/publish-params.d.ts +33 -0
- package/dist/server/publish-params.d.ts.map +1 -0
- package/dist/server/react-cache-bridge.d.ts +59 -0
- package/dist/server/react-cache-bridge.d.ts.map +1 -0
- package/dist/server/react-cache-scope.d.ts +49 -0
- package/dist/server/react-cache-scope.d.ts.map +1 -0
- package/dist/server/render-timeout.d.ts +66 -0
- package/dist/server/render-timeout.d.ts.map +1 -0
- package/dist/server/render-utils.d.ts +56 -0
- package/dist/server/render-utils.d.ts.map +1 -0
- package/dist/server/request-context.d.ts +167 -103
- package/dist/server/request-context.d.ts.map +1 -1
- package/dist/server/request-dep.d.ts +15 -0
- package/dist/server/request-dep.d.ts.map +1 -0
- package/dist/server/response-cache-policy.d.ts +3 -0
- package/dist/server/response-cache-policy.d.ts.map +1 -0
- package/dist/server/response-framing.d.ts +43 -0
- package/dist/server/response-framing.d.ts.map +1 -0
- package/dist/server/route-element-builder.d.ts +57 -30
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/route-element-helpers.d.ts +12 -0
- package/dist/server/route-element-helpers.d.ts.map +1 -0
- package/dist/server/route-handler.d.ts +9 -3
- package/dist/server/route-handler.d.ts.map +1 -1
- package/dist/server/route-matcher.d.ts +75 -40
- package/dist/server/route-matcher.d.ts.map +1 -1
- package/dist/server/route-methods.d.ts +23 -0
- package/dist/server/route-methods.d.ts.map +1 -0
- package/dist/server/route-module-loader.d.ts +37 -0
- package/dist/server/route-module-loader.d.ts.map +1 -0
- package/dist/server/rsc-cache-key-guard.d.ts +78 -0
- package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
- package/dist/server/rsc-entry/api-handler.d.ts +19 -3
- package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
- package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
- package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
- package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
- package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
- package/dist/server/rsc-entry/helpers.d.ts +14 -59
- package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
- package/dist/server/rsc-entry/index.d.ts +30 -6
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts +55 -0
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
- package/dist/server/rsc-entry/render-signals.d.ts +65 -0
- package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
- package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
- package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
- package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
- package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
- package/dist/server/rsc-error-envelope.d.ts +11 -0
- package/dist/server/rsc-error-envelope.d.ts.map +1 -0
- package/dist/server/safe-load.d.ts +39 -0
- package/dist/server/safe-load.d.ts.map +1 -0
- package/dist/server/schema-introspection.d.ts +68 -0
- package/dist/server/schema-introspection.d.ts.map +1 -0
- package/dist/server/sensitive-fields.d.ts +88 -0
- package/dist/server/sensitive-fields.d.ts.map +1 -0
- package/dist/server/signal-identity.d.ts +49 -0
- package/dist/server/signal-identity.d.ts.map +1 -0
- package/dist/server/sitemap-generator.d.ts +130 -0
- package/dist/server/sitemap-generator.d.ts.map +1 -0
- package/dist/server/sitemap-handler.d.ts +22 -0
- package/dist/server/sitemap-handler.d.ts.map +1 -0
- package/dist/server/skippable-prefix.d.ts +29 -0
- package/dist/server/skippable-prefix.d.ts.map +1 -0
- package/dist/server/slot-interception.d.ts +80 -0
- package/dist/server/slot-interception.d.ts.map +1 -0
- package/dist/server/slot-resolver.d.ts +138 -7
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/slot-subtree-contain.d.ts +54 -0
- package/dist/server/slot-subtree-contain.d.ts.map +1 -0
- package/dist/server/ssr-bridge-types.d.ts +213 -0
- package/dist/server/ssr-bridge-types.d.ts.map +1 -0
- package/dist/server/ssr-entry.d.ts +15 -51
- package/dist/server/ssr-entry.d.ts.map +1 -1
- package/dist/server/ssr-form-state.d.ts +30 -0
- package/dist/server/ssr-form-state.d.ts.map +1 -0
- package/dist/server/ssr-render.d.ts +42 -12
- package/dist/server/ssr-render.d.ts.map +1 -1
- package/dist/server/ssr-wrappers.d.ts +92 -0
- package/dist/server/ssr-wrappers.d.ts.map +1 -0
- package/dist/server/state-tree-diff.d.ts +44 -9
- package/dist/server/state-tree-diff.d.ts.map +1 -1
- package/dist/server/static-generator.d.ts +112 -0
- package/dist/server/static-generator.d.ts.map +1 -0
- package/dist/server/static-not-found.d.ts +52 -0
- package/dist/server/static-not-found.d.ts.map +1 -0
- package/dist/server/status-code-resolver.d.ts +26 -15
- package/dist/server/status-code-resolver.d.ts.map +1 -1
- package/dist/server/stream-utils.d.ts +93 -0
- package/dist/server/stream-utils.d.ts.map +1 -0
- package/dist/server/traced-access.d.ts +18 -0
- package/dist/server/traced-access.d.ts.map +1 -0
- package/dist/server/tracing.d.ts +72 -31
- package/dist/server/tracing.d.ts.map +1 -1
- package/dist/server/tree-match.d.ts +59 -0
- package/dist/server/tree-match.d.ts.map +1 -0
- package/dist/server/types.d.ts +90 -8
- package/dist/server/types.d.ts.map +1 -1
- package/dist/server/utils/element-type.d.ts +50 -0
- package/dist/server/utils/element-type.d.ts.map +1 -0
- package/dist/server/utils/escape-html.d.ts +14 -0
- package/dist/server/utils/escape-html.d.ts.map +1 -0
- package/dist/server/version-skew.d.ts +61 -0
- package/dist/server/version-skew.d.ts.map +1 -0
- package/dist/server/workers-cache-bridge.d.ts +26 -0
- package/dist/server/workers-cache-bridge.d.ts.map +1 -0
- package/dist/shared/als-slots.d.ts +42 -0
- package/dist/shared/als-slots.d.ts.map +1 -0
- package/dist/shared/base-path.d.ts +56 -0
- package/dist/shared/base-path.d.ts.map +1 -0
- package/dist/shared/csrf-reject.d.ts +16 -0
- package/dist/shared/csrf-reject.d.ts.map +1 -0
- package/dist/shared/dev-span.d.ts +99 -0
- package/dist/shared/dev-span.d.ts.map +1 -0
- package/dist/shared/error-digest.d.ts +28 -0
- package/dist/shared/error-digest.d.ts.map +1 -0
- package/dist/shared/flight-base64.d.ts +13 -0
- package/dist/shared/flight-base64.d.ts.map +1 -0
- package/dist/shared/flight-segment.d.ts +18 -0
- package/dist/shared/flight-segment.d.ts.map +1 -0
- package/dist/shared/form-state-flight.d.ts +32 -0
- package/dist/shared/form-state-flight.d.ts.map +1 -0
- package/dist/shared/href-validation.d.ts +49 -0
- package/dist/shared/href-validation.d.ts.map +1 -0
- package/dist/shared/href.d.ts +88 -0
- package/dist/shared/href.d.ts.map +1 -0
- package/dist/shared/merge-search-params.d.ts +22 -0
- package/dist/shared/merge-search-params.d.ts.map +1 -0
- package/dist/shared/param-value.d.ts +104 -0
- package/dist/shared/param-value.d.ts.map +1 -0
- package/dist/shared/payload-root.d.ts +110 -0
- package/dist/shared/payload-root.d.ts.map +1 -0
- package/dist/shared/redirect-type.d.ts +17 -0
- package/dist/shared/redirect-type.d.ts.map +1 -0
- package/dist/shared/rsc-cache-key.d.ts +163 -0
- package/dist/shared/rsc-cache-key.d.ts.map +1 -0
- package/dist/shared/rsc-error-envelope.d.ts +16 -0
- package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
- package/dist/shared/rsc-manifest.d.ts +28 -0
- package/dist/shared/rsc-manifest.d.ts.map +1 -0
- package/dist/shared/rsc-media-type.d.ts +52 -0
- package/dist/shared/rsc-media-type.d.ts.map +1 -0
- package/dist/shared/rsc-payload-path.d.ts +48 -0
- package/dist/shared/rsc-payload-path.d.ts.map +1 -0
- package/dist/shared/segment-info.d.ts +66 -0
- package/dist/shared/segment-info.d.ts.map +1 -0
- package/dist/shared/slot-params.d.ts +52 -0
- package/dist/shared/slot-params.d.ts.map +1 -0
- package/dist/shared/static-platform-files.d.ts +71 -0
- package/dist/shared/static-platform-files.d.ts.map +1 -0
- package/dist/shared/status-reason-phrase.d.ts +26 -0
- package/dist/shared/status-reason-phrase.d.ts.map +1 -0
- package/dist/shims/font-google.d.ts +1 -1
- package/dist/shims/font-google.d.ts.map +1 -1
- package/dist/shims/font-google.js +41 -0
- package/dist/shims/font-google.js.map +1 -0
- package/dist/shims/font-local.d.ts +26 -0
- package/dist/shims/font-local.d.ts.map +1 -0
- package/dist/shims/font-local.js +19 -0
- package/dist/shims/font-local.js.map +1 -0
- package/dist/shims/headers.d.ts +60 -1
- package/dist/shims/headers.d.ts.map +1 -1
- package/dist/shims/image.d.ts +120 -120
- package/dist/shims/image.d.ts.map +1 -1
- package/dist/shims/navigation-client.d.ts +25 -12
- package/dist/shims/navigation-client.d.ts.map +1 -1
- package/dist/shims/navigation-rsc.d.ts +21 -0
- package/dist/shims/navigation-rsc.d.ts.map +1 -0
- package/dist/shims/navigation.d.ts +10 -5
- package/dist/shims/navigation.d.ts.map +1 -1
- package/dist/utils/state-machine.d.ts +80 -0
- package/dist/utils/state-machine.d.ts.map +1 -0
- package/dist/utils/write-file-atomic.d.ts +17 -0
- package/dist/utils/write-file-atomic.d.ts.map +1 -0
- package/docs/api/30-api-server.mdx +241 -0
- package/docs/api/31-api-client.mdx +225 -0
- package/docs/api/32-api-cache.mdx +341 -0
- package/docs/api/33-api-search-params.mdx +178 -0
- package/docs/api/34-api-config.mdx +421 -0
- package/docs/api/35-api-typescript.mdx +123 -0
- package/docs/api/36-cli.mdx +272 -0
- package/docs/learn/00-introduction.mdx +109 -0
- package/docs/learn/01-quick-start.mdx +94 -0
- package/docs/learn/02-pages-and-layouts.mdx +147 -0
- package/docs/learn/03-fetching-data.mdx +227 -0
- package/docs/learn/04-access-control.mdx +115 -0
- package/docs/learn/05-the-flush-point.mdx +175 -0
- package/docs/learn/06-typed-params.mdx +275 -0
- package/docs/learn/07-typed-routes.mdx +173 -0
- package/docs/learn/08-forms-and-actions.mdx +260 -0
- package/docs/learn/09-streaming.mdx +146 -0
- package/docs/learn/10-caching.mdx +303 -0
- package/docs/learn/11-middleware.mdx +166 -0
- package/docs/learn/12-error-handling.mdx +192 -0
- package/docs/learn/13-deploying.mdx +289 -0
- package/llms.txt +55 -0
- package/package.json +124 -29
- package/src/adapters/build-output-helper.ts +375 -0
- package/src/adapters/canonicalize-module.ts +29 -0
- package/src/adapters/cloudflare-dev.ts +183 -0
- package/src/adapters/cloudflare-kv-cache.ts +203 -0
- package/src/adapters/cloudflare.ts +799 -151
- package/src/adapters/compress-module.ts +110 -86
- package/src/adapters/fs-identity.ts +155 -0
- package/src/adapters/nitro-immutable-assets.ts +142 -0
- package/src/adapters/nitro-presets.ts +139 -0
- package/src/adapters/nitro-preview.ts +565 -0
- package/src/adapters/nitro.ts +349 -448
- package/src/adapters/raw-imports.d.ts +5 -0
- package/src/adapters/shared.ts +314 -0
- package/src/adapters/types.ts +129 -17
- package/src/adapters/wrangler.d.ts +7 -0
- package/src/analyze/chains.ts +411 -0
- package/src/analyze/classify.ts +259 -0
- package/src/analyze/crawl-entry.ts +68 -0
- package/src/analyze/crawl.ts +500 -0
- package/src/analyze/graph-cache.ts +331 -0
- package/src/analyze/graph-command.ts +654 -0
- package/src/analyze/live-graph.ts +232 -0
- package/src/analyze/poison-rules.ts +165 -0
- package/src/analyze/poison-scan.ts +159 -0
- package/src/analyze/scan.ts +149 -0
- package/src/cache/cache-api.ts +113 -0
- package/src/cache/fast-hash.ts +5 -0
- package/src/cache/guarded-read.ts +44 -0
- package/src/cache/handler-store.ts +113 -0
- package/src/cache/index.ts +93 -20
- package/src/cache/invalidation-epoch.ts +105 -0
- package/src/cache/json-lossy-check.ts +69 -0
- package/src/cache/key-discipline.ts +218 -0
- package/src/cache/redis-handler.ts +193 -19
- package/src/cache/singleflight.ts +85 -7
- package/src/cache/sizeof.ts +35 -0
- package/src/cache/stable-stringify.ts +118 -2
- package/src/cache/store.ts +71 -0
- package/src/cache/stores/cloudflare-kv.ts +52 -0
- package/src/cache/stores/memory.ts +125 -0
- package/src/cache/stores/redis.ts +97 -0
- package/src/cache/stores/vercel.ts +59 -0
- package/src/cache/tag-aware-handler.ts +250 -0
- package/src/cache/timber-cache.ts +218 -47
- package/src/cdn/cloudflare-purge.ts +50 -0
- package/src/cdn/fastly-purge.ts +63 -0
- package/src/cdn/headers.ts +153 -0
- package/src/cdn/index.ts +23 -0
- package/src/cdn/purge-store.ts +62 -0
- package/src/cdn/workers-cache-purge.ts +34 -0
- package/src/cli-check.ts +417 -0
- package/src/cli-context.ts +128 -0
- package/src/cli-dev-status.ts +196 -0
- package/src/cli-init.ts +278 -0
- package/src/cli-schema-sync.ts +401 -0
- package/src/cli.ts +308 -84
- package/src/client/browser-dev.ts +192 -5
- package/src/client/browser-entry/action-dispatch.ts +317 -0
- package/src/client/browser-entry/action-queue.ts +152 -0
- package/src/client/browser-entry/form-state.ts +49 -0
- package/src/client/browser-entry/hmr.ts +82 -0
- package/src/client/browser-entry/hydrate.ts +152 -0
- package/src/client/browser-entry/index.ts +153 -0
- package/src/client/browser-entry/post-hydration.ts +99 -0
- package/src/client/browser-entry/router-init.ts +391 -0
- package/src/client/browser-entry/rsc-stream.ts +145 -0
- package/src/client/browser-entry/scroll.ts +50 -0
- package/src/client/deny-last-resort.tsx +54 -0
- package/src/client/dev-pill/index.ts +128 -0
- package/src/client/dev-pill/store.ts +254 -0
- package/src/client/dev-pill/view.ts +326 -0
- package/src/client/error-boundary.tsx +296 -61
- package/src/client/error-reconstituter.tsx +84 -0
- package/src/client/form.tsx +61 -173
- package/src/client/global-context.ts +59 -0
- package/src/client/history.ts +74 -11
- package/src/client/index.ts +93 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +284 -204
- package/src/client/location-search.ts +15 -0
- package/src/client/navigation-api.ts +254 -0
- package/src/client/navigation-commit.ts +318 -0
- package/src/client/navigation-context.ts +71 -142
- package/src/client/navigation-root.tsx +237 -0
- package/src/client/navigation-transition.ts +401 -0
- package/src/client/nuqs-adapter.tsx +62 -32
- package/src/client/params-context.ts +175 -0
- package/src/client/react-root.ts +105 -0
- package/src/client/router-effects.ts +349 -0
- package/src/client/router-lifecycle.ts +394 -0
- package/src/client/router-pipeline.ts +443 -0
- package/src/client/router-ref.ts +3 -3
- package/src/client/router-skew.ts +30 -0
- package/src/client/router-types.ts +326 -0
- package/src/client/router-url.ts +32 -0
- package/src/client/router.ts +491 -421
- package/src/client/rsc-fetch.ts +510 -109
- package/src/client/segment-cache.ts +362 -41
- package/src/client/segment-context.ts +7 -4
- package/src/client/segment-outlet.tsx +96 -0
- package/src/client/segment-update-context.ts +23 -0
- package/src/client/shallow-url.ts +22 -0
- package/src/client/slot-content-cache-context.ts +43 -0
- package/src/client/slot-context.ts +39 -0
- package/src/client/slot-outlet.tsx +22 -0
- package/src/client/slot-provider.tsx +32 -0
- package/src/client/ssr-data.ts +27 -67
- package/src/client/stale-client.ts +191 -0
- package/src/client/state.ts +31 -24
- package/src/client/status-page-marker.tsx +32 -0
- package/src/client/top-loader.tsx +13 -10
- package/src/client/unload-guard.ts +35 -3
- package/src/client/use-cookie.ts +93 -29
- package/src/client/use-field-state.ts +144 -0
- package/src/client/use-link-status.ts +7 -7
- package/src/client/use-pathname.ts +22 -31
- package/src/client/use-pending-navigation.ts +119 -0
- package/src/client/use-query-states.ts +206 -36
- package/src/client/use-router.ts +31 -9
- package/src/client/use-search-params.ts +38 -49
- package/src/client/use-segment-params.ts +69 -0
- package/src/client/use-selected-layout-segment.ts +2 -2
- package/src/codec.ts +149 -0
- package/src/config-types.ts +366 -0
- package/src/config-validation.ts +511 -0
- package/src/cookies/define-cookie.ts +186 -53
- package/src/cookies/index.ts +13 -2
- package/src/cookies/json-cookie.ts +105 -0
- package/src/cookies/validation.ts +192 -0
- package/src/dev-tools/404-page.ts +286 -0
- package/src/dev-tools/await-span.ts +69 -0
- package/src/dev-tools/browser-logs.ts +55 -0
- package/src/dev-tools/dev-page-shell.ts +278 -0
- package/src/dev-tools/error-page.ts +331 -0
- package/src/dev-tools/holding-server.ts +185 -0
- package/src/dev-tools/hydration-overlay.ts +158 -0
- package/src/dev-tools/index.ts +79 -0
- package/src/dev-tools/instrumentation.ts +281 -0
- package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
- package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
- package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
- package/src/dev-tools/span-sink.ts +132 -0
- package/src/dev-tools/stack-classifier.ts +75 -0
- package/src/dev-tools/terminal.ts +182 -0
- package/src/fonts/ast-walk.ts +235 -0
- package/src/fonts/ast.ts +479 -128
- package/src/fonts/bundle.ts +138 -0
- package/src/fonts/css.ts +1 -1
- package/src/fonts/dev-middleware.ts +85 -0
- package/src/fonts/fallbacks.ts +0 -23
- package/src/fonts/google.ts +101 -19
- package/src/fonts/local.ts +12 -11
- package/src/fonts/paths.ts +58 -0
- package/src/fonts/pipeline.ts +348 -0
- package/src/fonts/transform.ts +311 -0
- package/src/fonts/types.ts +52 -1
- package/src/fonts/virtual-modules.ts +179 -0
- package/src/index.ts +501 -380
- package/src/params/codec-registry.ts +47 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +16 -0
- package/src/params/resolve-schema.ts +84 -0
- package/src/plugin-context.ts +509 -0
- package/src/plugins/build-manifest.ts +189 -36
- package/src/plugins/build-report.ts +299 -87
- package/src/plugins/cache.ts +243 -0
- package/src/plugins/callsite-ast.ts +472 -0
- package/src/plugins/callsite-jsx.ts +243 -0
- package/src/plugins/chunks.ts +74 -5
- package/src/plugins/client-chunks.ts +185 -0
- package/src/plugins/client-dep-entries.ts +124 -0
- package/src/plugins/client-in-server-package-deps.ts +139 -0
- package/src/plugins/cloudflare-wasm.ts +141 -0
- package/src/plugins/content.ts +31 -2
- package/src/plugins/dev-await.ts +415 -0
- package/src/plugins/dev-discovery.ts +428 -0
- package/src/plugins/dev-hostname.ts +322 -0
- package/src/plugins/dev-server.ts +471 -100
- package/src/plugins/dev-store-clear.ts +145 -0
- package/src/plugins/encryption-runtime.ts +31 -0
- package/src/plugins/entries.ts +158 -17
- package/src/plugins/fonts.ts +260 -657
- package/src/plugins/graph-endpoint.ts +544 -0
- package/src/plugins/mdx.ts +108 -35
- package/src/plugins/optimize-package-imports-defaults.ts +88 -0
- package/src/plugins/optimize-package-imports.ts +439 -0
- package/src/plugins/orphaned-modules.ts +78 -0
- package/src/plugins/post-build.ts +327 -0
- package/src/plugins/prebuilt-capture.ts +213 -0
- package/src/plugins/prebuilt-options-analysis.ts +175 -0
- package/src/plugins/prebuilt.ts +679 -0
- package/src/plugins/prerender-sugar.ts +348 -0
- package/src/plugins/react-resolve.ts +149 -0
- package/src/plugins/request-dep/analysis.ts +447 -0
- package/src/plugins/request-dep/index.ts +376 -0
- package/src/plugins/request-dep/origin.ts +310 -0
- package/src/plugins/routing.ts +296 -278
- package/src/plugins/rsc-assets-manifest.ts +251 -0
- package/src/plugins/server-bundle.ts +115 -15
- package/src/plugins/shims.ts +267 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -0
- package/src/routes/href.ts +171 -0
- package/src/routes/index.ts +10 -0
- package/src/routing/codegen-shared.ts +39 -0
- package/src/routing/codegen-types.ts +62 -0
- package/src/routing/codegen-write.ts +163 -0
- package/src/routing/codegen.ts +356 -232
- package/src/routing/collision-probe.ts +438 -0
- package/src/routing/collision-spaces.ts +281 -0
- package/src/routing/convention-lint.ts +649 -0
- package/src/routing/export-detect.ts +536 -0
- package/src/routing/file-cache.ts +23 -0
- package/src/routing/index.ts +16 -7
- package/src/routing/interception-overlap.ts +141 -0
- package/src/routing/interception.ts +1044 -67
- package/src/routing/link-codegen.ts +346 -0
- package/src/routing/manifest-codegen.ts +232 -0
- package/src/routing/scanner.ts +417 -223
- package/src/routing/schema-validation.ts +155 -0
- package/src/routing/segment-classify.ts +280 -0
- package/src/routing/segment-codegen.ts +99 -0
- package/src/routing/segment-keys.ts +186 -0
- package/src/routing/slot-placement.ts +97 -0
- package/src/routing/types.ts +82 -26
- package/src/routing/walkers.ts +98 -0
- package/src/rsc-runtime/dev-reference-cache.ts +115 -0
- package/src/rsc-runtime/encryption-runtime.ts +78 -0
- package/src/rsc-runtime/render-flight.ts +26 -0
- package/src/rsc-runtime/rsc.ts +35 -5
- package/src/rsc-runtime/server-reference-load-error.ts +16 -0
- package/src/rsc-runtime/server-references.ts +135 -0
- package/src/rsc-runtime/ssr.ts +23 -0
- package/src/rsc-runtime/transforms.ts +13 -0
- package/src/rsc-runtime/vendor-types.d.ts +87 -0
- package/src/schema-bridge.ts +437 -0
- package/src/search-params/define.ts +676 -0
- package/src/search-params/index.ts +14 -20
- package/src/search-params/parse-total.ts +91 -0
- package/src/search-params/serialize-equal.ts +14 -0
- package/src/search-params/wrappers.ts +150 -0
- package/src/server/abort-scope.ts +49 -0
- package/src/server/access-gate.tsx +208 -57
- package/src/server/action-client.ts +175 -294
- package/src/server/action-encryption.ts +144 -0
- package/src/server/action-handler.ts +533 -150
- package/src/server/action-schema.ts +203 -0
- package/src/server/action-types.ts +145 -0
- package/src/server/actions.ts +172 -85
- package/src/server/als-registry.ts +245 -30
- package/src/server/body-limits.ts +10 -2
- package/src/server/build-manifest.ts +33 -57
- package/src/server/canonicalize.ts +62 -3
- package/src/server/chain-url-parts.ts +163 -0
- package/src/server/children-interception.ts +116 -0
- package/src/server/client-error-message.ts +18 -0
- package/src/server/coalesce-tick.ts +75 -0
- package/src/server/compress.ts +91 -19
- package/src/server/cookie-context.ts +462 -0
- package/src/server/cookie-parsing.ts +163 -0
- package/src/server/csp-nonce.ts +58 -0
- package/src/server/csrf.ts +238 -37
- package/src/server/debug.ts +0 -1
- package/src/server/default-logger.ts +100 -0
- package/src/server/default-status-page.ts +88 -0
- package/src/server/deny-boundary.ts +527 -0
- package/src/server/deny-renderer.ts +210 -181
- package/src/server/early-hints-sender.ts +4 -3
- package/src/server/early-hints.ts +39 -29
- package/src/server/error-boundary-wrapper.ts +160 -44
- package/src/server/error-response-headers.ts +18 -0
- package/src/server/fallback-error.ts +88 -104
- package/src/server/flight-injection-state.ts +113 -0
- package/src/server/flight-injector-core.ts +332 -0
- package/src/server/flight-scripts.ts +92 -0
- package/src/server/flight-source-node.ts +434 -0
- package/src/server/flight-source.ts +289 -0
- package/src/server/form-data.ts +191 -20
- package/src/server/form-state-flight.ts +67 -0
- package/src/server/head-response.ts +50 -0
- package/src/server/html-injector-core.ts +320 -0
- package/src/server/html-injectors.ts +241 -285
- package/src/server/index.ts +42 -195
- package/src/server/instrumentation.ts +42 -11
- package/src/server/interception-gates.ts +94 -0
- package/src/server/internal.ts +164 -0
- package/src/server/json-status-response.ts +105 -0
- package/src/server/logger.ts +163 -38
- package/src/server/metadata-collector.ts +175 -0
- package/src/server/metadata-platform.ts +2 -2
- package/src/server/metadata-render.ts +30 -8
- package/src/server/metadata-route-links.ts +200 -0
- package/src/server/metadata-routes.ts +114 -24
- package/src/server/metadata-social.ts +2 -2
- package/src/server/metadata.ts +23 -2
- package/src/server/middleware-runner.ts +32 -5
- package/src/server/node-body-response.ts +236 -0
- package/src/server/node-response.ts +93 -0
- package/src/server/node-stream-transforms.ts +340 -0
- package/src/server/node-streams-platform.ts +23 -0
- package/src/server/param-coercion.ts +205 -0
- package/src/server/pipeline-helpers.ts +554 -0
- package/src/server/pipeline-interception.ts +301 -32
- package/src/server/pipeline-metadata-route.ts +242 -0
- package/src/server/pipeline-metadata.ts +30 -4
- package/src/server/pipeline-outcome.ts +290 -0
- package/src/server/pipeline-phases.ts +443 -0
- package/src/server/pipeline.ts +474 -427
- package/src/server/port-resolution.ts +43 -0
- package/src/server/prebuilt/cache-key.ts +340 -0
- package/src/server/prebuilt/capture-render.ts +122 -0
- package/src/server/prebuilt/capture-routes.ts +104 -0
- package/src/server/prebuilt/capture-state.ts +196 -0
- package/src/server/prebuilt/dev-store.ts +252 -0
- package/src/server/prebuilt/lifetime.ts +151 -0
- package/src/server/prebuilt/manifest-tag-index.ts +46 -0
- package/src/server/prebuilt/overlay.ts +290 -0
- package/src/server/prebuilt/payload-source.ts +221 -0
- package/src/server/prebuilt/slots.ts +201 -0
- package/src/server/prebuilt/synthetic-store.ts +125 -0
- package/src/server/prebuilt-builder.ts +515 -0
- package/src/server/prebuilt-runtime.ts +830 -0
- package/src/server/primitives.ts +167 -171
- package/src/server/publish-params.ts +42 -0
- package/src/server/react-cache-bridge.ts +124 -0
- package/src/server/react-cache-scope.ts +104 -0
- package/src/server/render-timeout.ts +123 -0
- package/src/server/render-utils.ts +70 -0
- package/src/server/request-context.ts +321 -323
- package/src/server/request-dep.ts +37 -0
- package/src/server/response-cache-policy.ts +45 -0
- package/src/server/response-framing.ts +59 -0
- package/src/server/route-element-builder.ts +539 -355
- package/src/server/route-element-helpers.ts +37 -0
- package/src/server/route-handler.ts +78 -48
- package/src/server/route-matcher.ts +251 -265
- package/src/server/route-methods.ts +37 -0
- package/src/server/route-module-loader.ts +161 -0
- package/src/server/rsc-cache-key-guard.ts +122 -0
- package/src/server/rsc-entry/action-dispatcher.ts +146 -0
- package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
- package/src/server/rsc-entry/api-handler.ts +30 -93
- package/src/server/rsc-entry/deny-fallback.ts +151 -0
- package/src/server/rsc-entry/error-renderer.ts +306 -113
- package/src/server/rsc-entry/helpers.ts +90 -115
- package/src/server/rsc-entry/index.ts +420 -350
- package/src/server/rsc-entry/render-route.ts +248 -0
- package/src/server/rsc-entry/render-signals.ts +108 -0
- package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
- package/src/server/rsc-entry/rsc-payload.ts +212 -113
- package/src/server/rsc-entry/rsc-stream.ts +143 -135
- package/src/server/rsc-entry/ssr-bridge.ts +43 -8
- package/src/server/rsc-entry/ssr-renderer.ts +311 -140
- package/src/server/rsc-error-envelope.ts +18 -0
- package/src/server/rsc-prop-warnings.ts +1 -1
- package/src/server/safe-load.ts +53 -0
- package/src/server/schema-introspection.ts +393 -0
- package/src/server/sensitive-fields.ts +287 -0
- package/src/server/server-only-guard-noop.js +3 -0
- package/src/server/server-timing.ts +1 -1
- package/src/server/signal-identity.ts +130 -0
- package/src/server/sitemap-generator.ts +337 -0
- package/src/server/sitemap-handler.ts +150 -0
- package/src/server/skippable-prefix.ts +172 -0
- package/src/server/slot-interception.ts +168 -0
- package/src/server/slot-resolver.ts +747 -300
- package/src/server/slot-subtree-contain.ts +273 -0
- package/src/server/ssr-bridge-types.ts +217 -0
- package/src/server/ssr-entry.ts +246 -109
- package/src/server/ssr-form-state.ts +58 -0
- package/src/server/ssr-render.ts +253 -113
- package/src/server/ssr-wrappers.tsx +152 -0
- package/src/server/state-tree-diff.ts +85 -30
- package/src/server/static-generator.ts +680 -0
- package/src/server/static-not-found.ts +134 -0
- package/src/server/status-code-resolver.ts +107 -148
- package/src/server/stream-utils.ts +398 -0
- package/src/server/traced-access.ts +50 -0
- package/src/server/tracing.ts +274 -128
- package/src/server/tree-match.ts +494 -0
- package/src/server/types.ts +97 -11
- package/src/server/utils/element-type.ts +88 -0
- package/src/server/utils/escape-html.ts +20 -0
- package/src/server/version-skew.ts +104 -0
- package/src/server/waituntil-bridge.ts +1 -1
- package/src/server/workers-cache-bridge.ts +33 -0
- package/src/shared/als-slots.ts +74 -0
- package/src/shared/base-path.ts +80 -0
- package/src/shared/csrf-reject.ts +15 -0
- package/src/shared/dev-span.ts +188 -0
- package/src/shared/error-digest.ts +46 -0
- package/src/shared/flight-base64.ts +23 -0
- package/src/shared/flight-segment.ts +35 -0
- package/src/shared/form-state-flight.ts +59 -0
- package/src/shared/href-validation.ts +159 -0
- package/src/shared/href.ts +257 -0
- package/src/shared/merge-search-params.ts +55 -0
- package/src/shared/param-value.ts +281 -0
- package/src/shared/payload-root.ts +153 -0
- package/src/shared/redirect-type.ts +17 -0
- package/src/shared/rsc-cache-key.ts +269 -0
- package/src/shared/rsc-error-envelope.ts +16 -0
- package/src/shared/rsc-manifest.ts +29 -0
- package/src/shared/rsc-media-type.ts +59 -0
- package/src/shared/rsc-payload-path.ts +52 -0
- package/src/shared/segment-info.ts +67 -0
- package/src/shared/slot-params.ts +109 -0
- package/src/shared/static-platform-files.ts +75 -0
- package/src/shared/status-reason-phrase.ts +61 -0
- package/src/shims/font-google.ts +1 -1
- package/src/shims/font-local.ts +34 -0
- package/src/shims/headers.ts +130 -1
- package/src/shims/navigation-client.ts +36 -32
- package/src/shims/navigation-rsc.ts +47 -0
- package/src/shims/navigation.ts +10 -7
- package/src/utils/state-machine.ts +111 -0
- package/src/utils/write-file-atomic.ts +32 -0
- package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
- package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
- package/dist/_chunks/debug-B3Gypr3D.js +0 -108
- package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
- package/dist/_chunks/format-RyoGQL74.js +0 -164
- package/dist/_chunks/format-RyoGQL74.js.map +0 -1
- package/dist/_chunks/interception-BOoWmLUA.js +0 -676
- package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
- package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
- package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
- package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
- package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
- package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
- package/dist/_chunks/tracing-CemImE6h.js +0 -187
- package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
- package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
- package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
- package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
- package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
- package/dist/adapters/cloudflare.js.map +0 -1
- package/dist/cache/index.js.map +0 -1
- package/dist/cache/register-cached-function.d.ts +0 -17
- package/dist/cache/register-cached-function.d.ts.map +0 -1
- package/dist/client/browser-entry.d.ts +0 -21
- package/dist/client/browser-entry.d.ts.map +0 -1
- package/dist/client/error-boundary.js.map +0 -1
- package/dist/client/head.d.ts +0 -16
- package/dist/client/head.d.ts.map +0 -1
- package/dist/client/link-status-provider.d.ts +0 -11
- package/dist/client/link-status-provider.d.ts.map +0 -1
- package/dist/client/segment-merger.d.ts +0 -119
- package/dist/client/segment-merger.d.ts.map +0 -1
- package/dist/client/stale-reload.d.ts +0 -44
- package/dist/client/stale-reload.d.ts.map +0 -1
- package/dist/client/transition-root.d.ts +0 -74
- package/dist/client/transition-root.d.ts.map +0 -1
- package/dist/client/types.d.ts +0 -14
- package/dist/client/types.d.ts.map +0 -1
- package/dist/client/use-navigation-pending.d.ts +0 -26
- package/dist/client/use-navigation-pending.d.ts.map +0 -1
- package/dist/client/use-params.d.ts +0 -92
- package/dist/client/use-params.d.ts.map +0 -1
- package/dist/content/index.d.ts +0 -11
- package/dist/content/index.d.ts.map +0 -1
- package/dist/content/index.js +0 -2
- package/dist/plugins/adapter-build.d.ts +0 -18
- package/dist/plugins/adapter-build.d.ts.map +0 -1
- package/dist/plugins/cache-transform.d.ts +0 -36
- package/dist/plugins/cache-transform.d.ts.map +0 -1
- package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
- package/dist/plugins/dev-logs.d.ts.map +0 -1
- package/dist/plugins/dynamic-transform.d.ts +0 -72
- package/dist/plugins/dynamic-transform.d.ts.map +0 -1
- package/dist/plugins/server-action-exports.d.ts +0 -26
- package/dist/plugins/server-action-exports.d.ts.map +0 -1
- package/dist/routing/status-file-lint.d.ts +0 -33
- package/dist/routing/status-file-lint.d.ts.map +0 -1
- package/dist/search-params/analyze.d.ts +0 -54
- package/dist/search-params/analyze.d.ts.map +0 -1
- package/dist/search-params/builtin-codecs.d.ts +0 -105
- package/dist/search-params/builtin-codecs.d.ts.map +0 -1
- package/dist/search-params/codecs.d.ts +0 -53
- package/dist/search-params/codecs.d.ts.map +0 -1
- package/dist/search-params/create.d.ts +0 -106
- package/dist/search-params/create.d.ts.map +0 -1
- package/dist/search-params/registry.d.ts +0 -20
- package/dist/search-params/registry.d.ts.map +0 -1
- package/dist/server/asset-headers.d.ts +0 -42
- package/dist/server/asset-headers.d.ts.map +0 -1
- package/dist/server/client-module-map.d.ts +0 -47
- package/dist/server/client-module-map.d.ts.map +0 -1
- package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
- package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
- package/dist/server/dev-logger.d.ts.map +0 -1
- package/dist/server/dev-span-processor.d.ts +0 -29
- package/dist/server/dev-span-processor.d.ts.map +0 -1
- package/dist/server/dev-warnings.d.ts +0 -129
- package/dist/server/dev-warnings.d.ts.map +0 -1
- package/dist/server/flush.d.ts +0 -74
- package/dist/server/flush.d.ts.map +0 -1
- package/dist/server/form-flash.d.ts +0 -78
- package/dist/server/form-flash.d.ts.map +0 -1
- package/dist/server/manifest-status-resolver.d.ts +0 -58
- package/dist/server/manifest-status-resolver.d.ts.map +0 -1
- package/dist/server/nuqs-ssr-provider.d.ts +0 -28
- package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
- package/dist/server/prerender.d.ts +0 -77
- package/dist/server/prerender.d.ts.map +0 -1
- package/dist/server/tree-builder.d.ts +0 -126
- package/dist/server/tree-builder.d.ts.map +0 -1
- package/dist/utils/directive-parser.d.ts +0 -70
- package/dist/utils/directive-parser.d.ts.map +0 -1
- package/src/cache/register-cached-function.ts +0 -103
- package/src/client/browser-entry.ts +0 -678
- package/src/client/head.ts +0 -61
- package/src/client/link-status-provider.tsx +0 -30
- package/src/client/segment-merger.ts +0 -339
- package/src/client/stale-reload.ts +0 -87
- package/src/client/transition-root.tsx +0 -166
- package/src/client/types.ts +0 -21
- package/src/client/use-navigation-pending.ts +0 -38
- package/src/client/use-params.ts +0 -141
- package/src/content/index.ts +0 -13
- package/src/plugins/adapter-build.ts +0 -118
- package/src/plugins/cache-transform.ts +0 -199
- package/src/plugins/dynamic-transform.ts +0 -161
- package/src/plugins/server-action-exports.ts +0 -220
- package/src/routing/status-file-lint.ts +0 -112
- package/src/search-params/analyze.ts +0 -192
- package/src/search-params/builtin-codecs.ts +0 -228
- package/src/search-params/codecs.ts +0 -153
- package/src/search-params/create.ts +0 -321
- package/src/search-params/registry.ts +0 -31
- package/src/server/asset-headers.ts +0 -81
- package/src/server/client-module-map.ts +0 -58
- package/src/server/dev-fetch-instrumentation.ts +0 -96
- package/src/server/dev-span-processor.ts +0 -78
- package/src/server/dev-warnings.ts +0 -283
- package/src/server/flush.ts +0 -182
- package/src/server/form-flash.ts +0 -89
- package/src/server/manifest-status-resolver.ts +0 -215
- package/src/server/nuqs-ssr-provider.tsx +0 -63
- package/src/server/prerender.ts +0 -139
- package/src/server/tree-builder.ts +0 -382
- package/src/shims/server-only-noop.js +0 -6
- package/src/utils/directive-parser.ts +0 -529
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CDN header helpers — pure functions that build Cache-Control,
|
|
3
|
+
* CDN-Cache-Control, Surrogate-Control, and Surrogate-Key header values.
|
|
4
|
+
*
|
|
5
|
+
* These are developer-elected utilities for wiring CDN caching in
|
|
6
|
+
* proxy.ts / middleware.ts. The framework never sets these automatically.
|
|
7
|
+
* See design/25-production-deployments.md §Layer 2.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
export interface CacheControlOptions {
|
|
11
|
+
/** Mark the response as publicly cacheable (CDN, shared caches). */
|
|
12
|
+
public?: boolean;
|
|
13
|
+
/** Mark the response as private (browser cache only, not CDN). */
|
|
14
|
+
private?: boolean;
|
|
15
|
+
/** Max freshness in seconds for the browser/client. */
|
|
16
|
+
maxAge?: number;
|
|
17
|
+
/** Max freshness in seconds for shared caches (CDN, proxy). Overrides maxAge for CDNs. */
|
|
18
|
+
sMaxAge?: number;
|
|
19
|
+
/** Serve stale while revalidating in the background (seconds). */
|
|
20
|
+
staleWhileRevalidate?: number;
|
|
21
|
+
/** Serve stale on upstream error (seconds). */
|
|
22
|
+
staleIfError?: number;
|
|
23
|
+
/** Response must not be stored by any cache. */
|
|
24
|
+
noStore?: boolean;
|
|
25
|
+
/** Caches must revalidate before using a stored response. */
|
|
26
|
+
noCache?: boolean;
|
|
27
|
+
/** Caches must revalidate once stale — no serving stale without checking origin. */
|
|
28
|
+
mustRevalidate?: boolean;
|
|
29
|
+
/** Response will not change — allows aggressive caching. Pair with hashed URLs. */
|
|
30
|
+
immutable?: boolean;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Build a `Cache-Control` header value.
|
|
35
|
+
*
|
|
36
|
+
* ```ts
|
|
37
|
+
* ctx.headers.set('Cache-Control', cacheControl({
|
|
38
|
+
* public: true,
|
|
39
|
+
* maxAge: 300,
|
|
40
|
+
* staleWhileRevalidate: 60,
|
|
41
|
+
* }));
|
|
42
|
+
* ```
|
|
43
|
+
*/
|
|
44
|
+
export function cacheControl(opts: CacheControlOptions): string {
|
|
45
|
+
if (opts.public && opts.private) {
|
|
46
|
+
throw new Error('cacheControl: public and private are mutually exclusive');
|
|
47
|
+
}
|
|
48
|
+
if (opts.noStore && opts.maxAge !== undefined) {
|
|
49
|
+
throw new Error('cacheControl: noStore makes maxAge meaningless — remove one');
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
const parts: string[] = [];
|
|
53
|
+
|
|
54
|
+
parts.push(opts.public ? 'public' : 'private');
|
|
55
|
+
|
|
56
|
+
if (opts.noStore) parts.push('no-store');
|
|
57
|
+
if (opts.noCache) parts.push('no-cache');
|
|
58
|
+
if (opts.maxAge !== undefined) parts.push(`max-age=${opts.maxAge}`);
|
|
59
|
+
if (opts.sMaxAge !== undefined) parts.push(`s-maxage=${opts.sMaxAge}`);
|
|
60
|
+
if (opts.staleWhileRevalidate !== undefined)
|
|
61
|
+
parts.push(`stale-while-revalidate=${opts.staleWhileRevalidate}`);
|
|
62
|
+
if (opts.staleIfError !== undefined) parts.push(`stale-if-error=${opts.staleIfError}`);
|
|
63
|
+
if (opts.mustRevalidate) parts.push('must-revalidate');
|
|
64
|
+
if (opts.immutable) parts.push('immutable');
|
|
65
|
+
|
|
66
|
+
return parts.join(', ');
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export interface SurrogateControlOptions {
|
|
70
|
+
/** Max freshness in seconds for the surrogate (CDN). */
|
|
71
|
+
maxAge?: number;
|
|
72
|
+
/** Do not store in surrogate cache. */
|
|
73
|
+
noStore?: boolean;
|
|
74
|
+
/** Serve stale while revalidating (seconds). */
|
|
75
|
+
staleWhileRevalidate?: number;
|
|
76
|
+
/** Serve stale on error (seconds). */
|
|
77
|
+
staleIfError?: number;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Build a `Surrogate-Control` header value (Fastly, Akamai, Varnish).
|
|
82
|
+
*
|
|
83
|
+
* ```ts
|
|
84
|
+
* ctx.headers.set('Surrogate-Control', surrogateControl({ maxAge: 3600 }));
|
|
85
|
+
* ```
|
|
86
|
+
*/
|
|
87
|
+
export function surrogateControl(opts: SurrogateControlOptions): string {
|
|
88
|
+
const parts: string[] = [];
|
|
89
|
+
if (opts.noStore) parts.push('no-store');
|
|
90
|
+
if (opts.maxAge !== undefined) parts.push(`max-age=${opts.maxAge}`);
|
|
91
|
+
if (opts.staleWhileRevalidate !== undefined)
|
|
92
|
+
parts.push(`stale-while-revalidate=${opts.staleWhileRevalidate}`);
|
|
93
|
+
if (opts.staleIfError !== undefined) parts.push(`stale-if-error=${opts.staleIfError}`);
|
|
94
|
+
return parts.join(', ');
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* Build a `CDN-Cache-Control` header value (Cloudflare).
|
|
99
|
+
* Same directive syntax as Surrogate-Control but recognized by Cloudflare.
|
|
100
|
+
*
|
|
101
|
+
* ```ts
|
|
102
|
+
* ctx.headers.set('CDN-Cache-Control', cdnCacheControl({ maxAge: 3600 }));
|
|
103
|
+
* ```
|
|
104
|
+
*/
|
|
105
|
+
export function cdnCacheControl(opts: SurrogateControlOptions): string {
|
|
106
|
+
return surrogateControl(opts);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* Build a `Surrogate-Key` header value — space-separated tags for CDN
|
|
111
|
+
* tag-based purging (Fastly, Cloudflare Enterprise, Akamai).
|
|
112
|
+
*
|
|
113
|
+
* Tags are deduplicated. Tags must not contain spaces or double quotes
|
|
114
|
+
* (these are separators/delimiters in the header format).
|
|
115
|
+
*
|
|
116
|
+
* ```ts
|
|
117
|
+
* ctx.headers.set('Surrogate-Key', surrogateKey(['products', `product:${id}`]));
|
|
118
|
+
* ```
|
|
119
|
+
*/
|
|
120
|
+
export function surrogateKey(tags: string[]): string {
|
|
121
|
+
for (const tag of tags) {
|
|
122
|
+
if (tag.includes(' ') || tag.includes('"')) {
|
|
123
|
+
throw new Error(`surrogateKey: tag "${tag}" must not contain spaces or double quotes`);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
return [...new Set(tags)].join(' ');
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* Build a `Cache-Tag` header value — comma-separated tags for Cloudflare
|
|
131
|
+
* Workers Cache tag-based purging. Available on ALL Cloudflare plans.
|
|
132
|
+
*
|
|
133
|
+
* Tags are deduplicated. Tags must not contain commas (the delimiter).
|
|
134
|
+
* Maximum tag length is 1024 characters per Cloudflare's limits.
|
|
135
|
+
*
|
|
136
|
+
* Use this instead of `surrogateKey()` when using Cloudflare Workers Cache
|
|
137
|
+
* (ctx.cache.purge). Workers Cache reads `Cache-Tag`, not `Surrogate-Key`.
|
|
138
|
+
*
|
|
139
|
+
* ```ts
|
|
140
|
+
* ctx.headers.set('Cache-Tag', cacheTag(['products', `product:${id}`]));
|
|
141
|
+
* ```
|
|
142
|
+
*/
|
|
143
|
+
export function cacheTag(tags: string[]): string {
|
|
144
|
+
for (const tag of tags) {
|
|
145
|
+
if (tag.includes(',')) {
|
|
146
|
+
throw new Error(`cacheTag: tag "${tag}" must not contain commas`);
|
|
147
|
+
}
|
|
148
|
+
if (tag.length > 1024) {
|
|
149
|
+
throw new Error(`cacheTag: tag "${tag}" exceeds 1024-character limit`);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
return [...new Set(tags)].join(',');
|
|
153
|
+
}
|
package/src/cdn/index.ts
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
// @timber-js/app/cdn — CDN integration helpers
|
|
2
|
+
//
|
|
3
|
+
// Header utilities and purge handler for CDN caching. Developer-elected,
|
|
4
|
+
// never automatic. See design/25-production-deployments.md §Layer 2.
|
|
5
|
+
|
|
6
|
+
export {
|
|
7
|
+
cacheControl,
|
|
8
|
+
surrogateKey,
|
|
9
|
+
surrogateControl,
|
|
10
|
+
cdnCacheControl,
|
|
11
|
+
cacheTag,
|
|
12
|
+
} from './headers.ts';
|
|
13
|
+
export type { CacheControlOptions, SurrogateControlOptions } from './headers.ts';
|
|
14
|
+
|
|
15
|
+
export { setCdnPurgeHandler, getCdnPurgeHandler } from './purge-store.ts';
|
|
16
|
+
export type { CdnPurgeHandler } from './purge-store.ts';
|
|
17
|
+
|
|
18
|
+
// Platform-specific purge handlers are at their own entry points:
|
|
19
|
+
// @timber-js/app/cdn/cloudflare → CloudflarePurge (REST API, Enterprise)
|
|
20
|
+
// @timber-js/app/cdn/cloudflare-workers → WorkersCachePurge (ctx.cache, all plans)
|
|
21
|
+
// @timber-js/app/cdn/fastly → FastlyPurge
|
|
22
|
+
// Same pattern as @timber-js/app/cache/stores/* — keeps platform
|
|
23
|
+
// dependencies out of the main CDN import.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CDN purge handler singleton — same pattern as cache/handler-store.ts.
|
|
3
|
+
*
|
|
4
|
+
* Set via timber.config.ts or setCdnPurgeHandler() at boot. When set,
|
|
5
|
+
* cache.invalidate({ tag }) also triggers CDN purge for the invalidated
|
|
6
|
+
* tags, so revalidateTag() composes with CDN caching out of the box.
|
|
7
|
+
*
|
|
8
|
+
* See design/25-production-deployments.md §Layer 2.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
export interface CdnPurgeHandler {
|
|
12
|
+
/**
|
|
13
|
+
* Purge the given cache tags from the CDN.
|
|
14
|
+
* Called by cache.invalidate when a tag is invalidated.
|
|
15
|
+
*/
|
|
16
|
+
purgeTags(tags: string[]): Promise<void>;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
let handler: CdnPurgeHandler | undefined;
|
|
20
|
+
|
|
21
|
+
/** Whether `handler` came from boot wiring (applyConfiguredCdnPurgeHandler). */
|
|
22
|
+
let fromBoot = false;
|
|
23
|
+
|
|
24
|
+
/** The handler last installed by a direct setCdnPurgeHandler() call, if any. */
|
|
25
|
+
let directHandler: CdnPurgeHandler | undefined;
|
|
26
|
+
|
|
27
|
+
/** Install a CDN purge handler. */
|
|
28
|
+
export function setCdnPurgeHandler(h: CdnPurgeHandler): void {
|
|
29
|
+
handler = h;
|
|
30
|
+
fromBoot = false;
|
|
31
|
+
directHandler = h;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Apply the purge handler boot resolves (timber.cache.ts's `cdnPurge`, or
|
|
36
|
+
* the Workers default), or `undefined` when there is none. Called on every
|
|
37
|
+
* run of the RSC entry; like applyConfiguredCacheHandler, it drops a handler
|
|
38
|
+
* a dev edit removed, and leaves one installed by a direct
|
|
39
|
+
* setCdnPurgeHandler() call in place (restoring it when a boot handler that
|
|
40
|
+
* replaced it is removed).
|
|
41
|
+
*/
|
|
42
|
+
export function applyConfiguredCdnPurgeHandler(h: CdnPurgeHandler | undefined): void {
|
|
43
|
+
if (h) {
|
|
44
|
+
handler = h;
|
|
45
|
+
fromBoot = true;
|
|
46
|
+
} else if (fromBoot) {
|
|
47
|
+
handler = directHandler;
|
|
48
|
+
fromBoot = false;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** Get the current CDN purge handler, if configured. */
|
|
53
|
+
export function getCdnPurgeHandler(): CdnPurgeHandler | undefined {
|
|
54
|
+
return handler;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** @internal — reset for tests only. */
|
|
58
|
+
export function _resetCdnPurgeHandler(): void {
|
|
59
|
+
handler = undefined;
|
|
60
|
+
fromBoot = false;
|
|
61
|
+
directHandler = undefined;
|
|
62
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cloudflare Workers Cache purge handler — purges by cache tag via
|
|
3
|
+
* ctx.cache.purge() on the ExecutionContext.
|
|
4
|
+
*
|
|
5
|
+
* Available on ALL Cloudflare plans (no Enterprise requirement).
|
|
6
|
+
* No API token needed — uses the Workers runtime's built-in cache API.
|
|
7
|
+
*
|
|
8
|
+
* ctx.cache.purge() operates on the same underlying Cloudflare CDN cache
|
|
9
|
+
* as caches.default — entries stored via cache.put() with matching
|
|
10
|
+
* Cache-Tag headers are purged (TIM-1172). See design/25 §TIM-1172.
|
|
11
|
+
*
|
|
12
|
+
* Auto-wired by the Cloudflare adapter when no user-configured CDN
|
|
13
|
+
* purge handler is set. Uses the Workers Cache ALS bridge to access
|
|
14
|
+
* ctx.cache from within the request context.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import type { CdnPurgeHandler } from './purge-store.ts';
|
|
18
|
+
import { getWorkersCachePurgeCtx } from '../server/workers-cache-bridge.ts';
|
|
19
|
+
|
|
20
|
+
export class WorkersCachePurge implements CdnPurgeHandler {
|
|
21
|
+
async purgeTags(tags: string[]): Promise<void> {
|
|
22
|
+
if (tags.length === 0) return;
|
|
23
|
+
|
|
24
|
+
const ctx = getWorkersCachePurgeCtx();
|
|
25
|
+
if (!ctx) {
|
|
26
|
+
throw new Error(
|
|
27
|
+
'WorkersCachePurge: no Workers Cache context available. ' +
|
|
28
|
+
'This handler can only be used within a Cloudflare Workers request context.'
|
|
29
|
+
);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
await ctx.purge({ tags });
|
|
33
|
+
}
|
|
34
|
+
}
|
package/src/cli-check.ts
ADDED
|
@@ -0,0 +1,417 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `timber check` — the implementation behind the CLI command.
|
|
3
|
+
*
|
|
4
|
+
* Two passes, in order:
|
|
5
|
+
*
|
|
6
|
+
* 1. **Routes.** Resolve the project through Vite — so root, `appDir`, and
|
|
7
|
+
* `pageExtensions` are the ones `timber build` uses, including config
|
|
8
|
+
* passed inline to `timber()` — then scan, run the convention linter, and
|
|
9
|
+
* write the route codegen (`.timber/timber-routes.d.ts`,
|
|
10
|
+
* `.timber/segment-types.d.ts`, `timber-env.d.ts`).
|
|
11
|
+
*
|
|
12
|
+
* Codegen runs *before* the type pass on purpose: those
|
|
13
|
+
* files are what give `<Link href>`, `useSegmentParams()` and
|
|
14
|
+
* `MiddlewareContext` their per-route types (design/09-typescript.md
|
|
15
|
+
* §"Typed Routes"), and they are build artifacts — a fresh clone that has
|
|
16
|
+
* never run `timber dev` or `timber build` does not have them, so a type
|
|
17
|
+
* pass on its own would report errors about correct code. A clone whose
|
|
18
|
+
* routes changed since the last build has the same problem with stale ones.
|
|
19
|
+
* 2. **Types.** `tsgo --noEmit` over the project.
|
|
20
|
+
*
|
|
21
|
+
* tsgo is spawned as `node <@typescript/native-preview>/lib/tsgo.js`, never as
|
|
22
|
+
* a bare `tsgo` off PATH — the package is an *optional peer dependency*, so
|
|
23
|
+
* there is no reason for its shim to be on a user's PATH, and the shim is a
|
|
24
|
+
* `.cmd` on Windows which cannot be spawned without a shell. `shell: true`
|
|
25
|
+
* would then concatenate the argv into an unescaped command string, so a
|
|
26
|
+
* project path containing a space would break on exactly the platform the
|
|
27
|
+
* shell was there to support. This mirrors `scripts/build-types.js`, whose
|
|
28
|
+
* header comment is the specification for the pattern.
|
|
29
|
+
*
|
|
30
|
+
* Design docs: 11-platform.md §CLI, 09-typescript.md, 28-npm-packaging.md
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
import { createRequire } from 'node:module';
|
|
34
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
35
|
+
import { dirname, join, resolve } from 'node:path';
|
|
36
|
+
import { scanRoutes } from './routing/scanner.ts';
|
|
37
|
+
import { lintConventions, formatConventionWarnings } from './routing/convention-lint.ts';
|
|
38
|
+
import { writeRouteCodegen, CODEGEN_OUTPUT, ENV_DTS_FILENAME } from './routing/codegen-write.ts';
|
|
39
|
+
import { resolveTimberContext, type ResolveViteConfig } from './cli-context.ts';
|
|
40
|
+
|
|
41
|
+
/** The npm package that provides tsgo. Named in the missing-tool message. */
|
|
42
|
+
const TSGO_PACKAGE = '@typescript/native-preview';
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* The two generated declaration paths, relative to the project root, as they
|
|
46
|
+
* appear in a resolved tsconfig file list. Derived from the writer's own
|
|
47
|
+
* constants — a rename there cannot leave this check hunting for a file nothing
|
|
48
|
+
* writes.
|
|
49
|
+
*/
|
|
50
|
+
const GENERATED_TYPE_PATHS = [ENV_DTS_FILENAME, CODEGEN_OUTPUT];
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Run the compiler to completion.
|
|
54
|
+
*
|
|
55
|
+
* Resolves with its exit status (`null` when a signal killed it) and rejects
|
|
56
|
+
* only when the process could not be started — the two outcomes `runTypeCheck`
|
|
57
|
+
* has to keep apart. The seam is this narrow on purpose: a test double is a
|
|
58
|
+
* plain async function, with no `ChildProcess` shape to imitate.
|
|
59
|
+
*/
|
|
60
|
+
export type RunTsgo = (command: string, args: string[], cwd: string) => Promise<number | null>;
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Run the compiler and capture its stdout — used for `--showConfig`, whose
|
|
64
|
+
* output is data we read rather than diagnostics the user reads.
|
|
65
|
+
*/
|
|
66
|
+
export type ReadTsgoConfig = (command: string, args: string[], cwd: string) => Promise<string>;
|
|
67
|
+
|
|
68
|
+
/** @internal Dependency injection for testing. */
|
|
69
|
+
export interface CheckDeps {
|
|
70
|
+
/**
|
|
71
|
+
* Resolve tsgo's own JS entry point. Throws when the package is not
|
|
72
|
+
* installed — the caller turns that into an install instruction.
|
|
73
|
+
*/
|
|
74
|
+
resolveTsgoEntry?: () => string;
|
|
75
|
+
runTsgo?: RunTsgo;
|
|
76
|
+
readTsgoConfig?: ReadTsgoConfig;
|
|
77
|
+
resolveViteConfig?: ResolveViteConfig;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
export interface CheckOptions {
|
|
81
|
+
/** Project root, for resolving tsgo. Defaults to `process.cwd()`. */
|
|
82
|
+
root?: string;
|
|
83
|
+
/**
|
|
84
|
+
* Path to a **tsconfig**, forwarded to tsgo as `--project` and sourced from
|
|
85
|
+
* the CLI's own `--project`. The route pass takes no part in it: it resolves
|
|
86
|
+
* the app's configuration through Vite, as `timber build` does.
|
|
87
|
+
*/
|
|
88
|
+
config?: string;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Locate `@typescript/native-preview`'s JS entry.
|
|
93
|
+
*
|
|
94
|
+
* Resolution is attempted from this package first (it is declared an optional
|
|
95
|
+
* peer dependency, so a package manager links it here when the user installs
|
|
96
|
+
* it) and then from the project root (covering a hoisted install, or a user who
|
|
97
|
+
* added it without the peer link). Throws if neither finds it.
|
|
98
|
+
*/
|
|
99
|
+
export function resolveTsgoEntry(
|
|
100
|
+
root: string,
|
|
101
|
+
resolveFrom: (from: string, specifier: string) => string = (from, specifier) =>
|
|
102
|
+
createRequire(from).resolve(specifier)
|
|
103
|
+
): string {
|
|
104
|
+
// `createRequire` takes a filename or a file URL; a plain absolute path is
|
|
105
|
+
// the portable spelling for the project root (a `file://` prefix on a Windows
|
|
106
|
+
// path is not a valid URL). Same form as `checkPeerDependencies`.
|
|
107
|
+
const candidates = [import.meta.url, join(root, 'package.json')];
|
|
108
|
+
let lastError: unknown;
|
|
109
|
+
|
|
110
|
+
for (const from of candidates) {
|
|
111
|
+
try {
|
|
112
|
+
// The package exports no subpath for its entry, so resolve the manifest
|
|
113
|
+
// and walk to the module its `bin/tsgo` shim imports.
|
|
114
|
+
const manifest = resolveFrom(from, `${TSGO_PACKAGE}/package.json`);
|
|
115
|
+
return join(dirname(manifest), 'lib', 'tsgo.js');
|
|
116
|
+
} catch (err) {
|
|
117
|
+
lastError = err;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
throw new Error(
|
|
122
|
+
`[timber] Cannot find ${TSGO_PACKAGE}, which \`timber check\` uses to type-check.\n\n` +
|
|
123
|
+
` Install it as a dev dependency:\n\n` +
|
|
124
|
+
` pnpm add -D ${TSGO_PACKAGE}\n\n` +
|
|
125
|
+
` (resolution failed: ${lastError instanceof Error ? lastError.message : String(lastError)})`
|
|
126
|
+
);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** What the route pass needs from the command line. */
|
|
130
|
+
export interface RouteOptions {
|
|
131
|
+
/**
|
|
132
|
+
* Path to a **Vite** config file, from `--config`. Undefined means Vite's own
|
|
133
|
+
* discovery, the same as `timber dev`/`build` without the flag. A project
|
|
134
|
+
* that builds with a custom Vite config has to be checkable with it too, or
|
|
135
|
+
* `check` resolves a different app than `build` does (TIM-1332, round 4).
|
|
136
|
+
*/
|
|
137
|
+
viteConfigFile?: string;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** Everything the route scan needs, as the build itself resolves it. */
|
|
141
|
+
export interface RouteInputs {
|
|
142
|
+
root: string;
|
|
143
|
+
appDir: string;
|
|
144
|
+
pageExtensions: string[] | undefined;
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Resolve root, appDir and pageExtensions the way `timber build` resolves them
|
|
149
|
+
* — through Vite, never by re-reading `timber.config.ts` (see `cli-context.ts`).
|
|
150
|
+
* Inline `timber({ pageExtensions: [...] })` is the case that bites: a scan
|
|
151
|
+
* that re-read the file would silently use default page extensions and write a
|
|
152
|
+
* route map missing the app's pages. `examples/next-playground-migration` is
|
|
153
|
+
* exactly this shape.
|
|
154
|
+
*/
|
|
155
|
+
export async function resolveRouteInputs(
|
|
156
|
+
options: RouteOptions = {},
|
|
157
|
+
deps: CheckDeps = {}
|
|
158
|
+
): Promise<RouteInputs> {
|
|
159
|
+
const ctx = await resolveTimberContext('check', options.viteConfigFile, deps.resolveViteConfig);
|
|
160
|
+
return { root: ctx.root, appDir: ctx.appDir, pageExtensions: ctx.config.pageExtensions };
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* Resolve the app directory, scan it, fail on proven-fatal route
|
|
165
|
+
* misconfigurations, print warnings, and write the route codegen the type pass
|
|
166
|
+
* depends on.
|
|
167
|
+
*
|
|
168
|
+
* Error-level lint findings throw rather than print, matching what
|
|
169
|
+
* `plugins/routing.ts` does at build time: the tree is not fit to publish, so
|
|
170
|
+
* it must not reach codegen either. Warnings are printed and do not fail the
|
|
171
|
+
* command — same severity contract as dev and build, so `timber check` cannot
|
|
172
|
+
* disagree with them about what a valid app is.
|
|
173
|
+
*/
|
|
174
|
+
export async function checkRoutes(
|
|
175
|
+
options: RouteOptions = {},
|
|
176
|
+
deps: CheckDeps = {}
|
|
177
|
+
): Promise<RouteInputs> {
|
|
178
|
+
const inputs = await resolveRouteInputs(options, deps);
|
|
179
|
+
const { root, appDir, pageExtensions } = inputs;
|
|
180
|
+
|
|
181
|
+
const tree = scanRoutes(appDir, { pageExtensions });
|
|
182
|
+
|
|
183
|
+
const warnings = lintConventions(tree, appDir);
|
|
184
|
+
const fatal = warnings.filter((w) => w.level === 'error');
|
|
185
|
+
if (fatal.length > 0) {
|
|
186
|
+
throw new Error(formatConventionWarnings(fatal, { color: false }));
|
|
187
|
+
}
|
|
188
|
+
if (warnings.length > 0) {
|
|
189
|
+
process.stderr.write(`${formatConventionWarnings(warnings)}\n`);
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
// Awaited, unlike the dev/build path: the type pass reads these files, so a
|
|
193
|
+
// failed write would be reported as type errors in the user's own code.
|
|
194
|
+
// Reported as a codegen failure rather than surfaced as a bare `EROFS`/
|
|
195
|
+
// `EACCES` from somewhere unnamed — the raw error says which path could not
|
|
196
|
+
// be written but not which pass wanted it.
|
|
197
|
+
try {
|
|
198
|
+
await writeRouteCodegen(tree, appDir, root);
|
|
199
|
+
} catch (err) {
|
|
200
|
+
throw new Error(
|
|
201
|
+
`[timber] Failed to write the generated route types, which the type check reads: ` +
|
|
202
|
+
`${err instanceof Error ? err.message : String(err)}`
|
|
203
|
+
);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
verifyCodegenImports(root);
|
|
207
|
+
|
|
208
|
+
// Returned so the type pass runs against the same root these files landed in.
|
|
209
|
+
return inputs;
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Verify that the import specifiers in the generated route types resolve on the
|
|
214
|
+
* filesystem. A `.d.ts` whose import fails does NOT produce a TypeScript error —
|
|
215
|
+
* every type that depends on it silently becomes `any`. The generated file
|
|
216
|
+
* contains type-level `_AssertSchemaNotAny` / `_AssertCodecTypeNotAny` guards
|
|
217
|
+
* that catch this at typecheck time, but a diagnostic here fires earlier and
|
|
218
|
+
* names the exact import that is broken rather than leaving the user to decode
|
|
219
|
+
* a constraint error.
|
|
220
|
+
*/
|
|
221
|
+
export function verifyCodegenImports(root: string): void {
|
|
222
|
+
const dtsPath = join(root, CODEGEN_OUTPUT);
|
|
223
|
+
let content: string;
|
|
224
|
+
try {
|
|
225
|
+
content = readFileSync(dtsPath, 'utf-8');
|
|
226
|
+
} catch {
|
|
227
|
+
return;
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
const dtsDir = dirname(dtsPath);
|
|
231
|
+
|
|
232
|
+
// Check relative imports (default imports only — the generated codegen uses
|
|
233
|
+
// `import type schema from '...'` for relative paths). Named imports from
|
|
234
|
+
// relative paths are not emitted today; if codegen adds them, extend this.
|
|
235
|
+
const RELATIVE_IMPORT_RE = /^import\s+type\s+\w+\s+from\s+'(\.\.?\/[^']+)'/gm;
|
|
236
|
+
const EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '/index.ts', '/index.tsx'];
|
|
237
|
+
let match;
|
|
238
|
+
while ((match = RELATIVE_IMPORT_RE.exec(content)) !== null) {
|
|
239
|
+
const specifier = match[1];
|
|
240
|
+
const base = join(dtsDir, specifier);
|
|
241
|
+
const resolves = existsSync(base) || EXTENSIONS.some((ext) => existsSync(base + ext));
|
|
242
|
+
if (!resolves) {
|
|
243
|
+
process.stderr.write(
|
|
244
|
+
`[timber] WARNING: the generated ${CODEGEN_OUTPUT} imports '${specifier}',\n` +
|
|
245
|
+
` but no file resolves at ${base}{${EXTENSIONS.join(',')}}.\n` +
|
|
246
|
+
` Every type that depends on this import will silently become \`any\`.\n\n` +
|
|
247
|
+
` Check that your app/ directory is where timber expects it.\n\n`
|
|
248
|
+
);
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
// Bare-specifier imports (`@timber-js/app/params`) are NOT checked here.
|
|
253
|
+
// They are all dependencies of @timber-js/app itself — if timber is installed,
|
|
254
|
+
// they resolve. And createRequire uses CJS resolution which cannot follow
|
|
255
|
+
// ESM-only subpath exports, producing false warnings (TIM-1348 review).
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/**
|
|
259
|
+
* The production `RunTsgo`: spawn the compiler with its stdio inherited, so its
|
|
260
|
+
* diagnostics stream to the terminal as they are produced (and are not capped
|
|
261
|
+
* by a buffer, as `execFile` output would be).
|
|
262
|
+
*/
|
|
263
|
+
const spawnTsgo: RunTsgo = async (command, args, cwd) => {
|
|
264
|
+
const { spawn } = await import('node:child_process');
|
|
265
|
+
return new Promise<number | null>((resolve, reject) => {
|
|
266
|
+
// No `shell: true`: Node would concatenate the argv into an unescaped
|
|
267
|
+
// command string, so a project path containing a space would break.
|
|
268
|
+
const child = spawn(command, args, { stdio: 'inherit', cwd });
|
|
269
|
+
child.on('error', reject);
|
|
270
|
+
child.on('close', (code) => resolve(code));
|
|
271
|
+
});
|
|
272
|
+
};
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* The production `ReadTsgoConfig`: `--showConfig`, with stdout captured.
|
|
276
|
+
*
|
|
277
|
+
* `maxBuffer` is raised well past `execFile`'s 1 MB default because the output
|
|
278
|
+
* is one line per file in the program — a large app can exceed that, and
|
|
279
|
+
* overflowing it would make this advisory go quiet on exactly the projects
|
|
280
|
+
* where a misconfigured `include` costs the most. A size-dependent silence is
|
|
281
|
+
* indistinguishable from "everything is fine".
|
|
282
|
+
*/
|
|
283
|
+
const execTsgoConfig: ReadTsgoConfig = async (command, args, cwd) => {
|
|
284
|
+
const { execFile } = await import('node:child_process');
|
|
285
|
+
return new Promise<string>((resolve, reject) => {
|
|
286
|
+
execFile(command, args, { cwd, maxBuffer: 64 * 1024 * 1024 }, (err, stdout) =>
|
|
287
|
+
err ? reject(err) : resolve(stdout)
|
|
288
|
+
);
|
|
289
|
+
});
|
|
290
|
+
};
|
|
291
|
+
|
|
292
|
+
/**
|
|
293
|
+
* Warn when the generated route declarations will not reach the type checker.
|
|
294
|
+
*
|
|
295
|
+
* Writing `.timber/timber-routes.d.ts` and `timber-env.d.ts` is only half the
|
|
296
|
+
* job: TypeScript loads them only if the project's `include`/`files` actually
|
|
297
|
+
* pull `timber-env.d.ts` in (it is what `/// <reference>`s the route map). A
|
|
298
|
+
* tsconfig with an explicit `include` that lists only source directories —
|
|
299
|
+
* `["app", "*.config.ts"]`, which is what `create-timber-app` shipped before
|
|
300
|
+
* TIM-1332 — silently omits it, and every `<Link href>` then type-checks
|
|
301
|
+
* against the empty placeholder instead of the generated route union. The
|
|
302
|
+
* check would pass while answering the wrong question.
|
|
303
|
+
*
|
|
304
|
+
* The resolved file list comes from `tsgo --showConfig` rather than from our
|
|
305
|
+
* own reading of the tsconfig: `include`, `exclude`, `files`, and `extends`
|
|
306
|
+
* compose in ways that are the compiler's to decide, and a second
|
|
307
|
+
* implementation of them would be a duplicate that drifts. `--showConfig` only
|
|
308
|
+
* resolves globs, so it costs no type checking.
|
|
309
|
+
*
|
|
310
|
+
* This warns rather than fails. An app that never uses typed routes is
|
|
311
|
+
* correct without those declarations, and a hard error would refuse it — the
|
|
312
|
+
* one outcome a check must not produce for a working project. When the answer
|
|
313
|
+
* cannot be determined (tsgo errored, output was not the expected JSON), the
|
|
314
|
+
* warning is skipped: an advisory that fires on an unknown is noise.
|
|
315
|
+
*/
|
|
316
|
+
async function warnIfRouteTypesUnreachable(
|
|
317
|
+
tsgoEntry: string,
|
|
318
|
+
configArgs: string[],
|
|
319
|
+
cwd: string,
|
|
320
|
+
readConfig: ReadTsgoConfig
|
|
321
|
+
): Promise<void> {
|
|
322
|
+
let files: unknown;
|
|
323
|
+
try {
|
|
324
|
+
const raw = await readConfig(process.execPath, [tsgoEntry, '--showConfig', ...configArgs], cwd);
|
|
325
|
+
files = (JSON.parse(raw) as { files?: unknown }).files;
|
|
326
|
+
} catch {
|
|
327
|
+
return;
|
|
328
|
+
}
|
|
329
|
+
if (!Array.isArray(files)) return;
|
|
330
|
+
|
|
331
|
+
// Suffix match, not path resolution: `--showConfig` prints paths relative to
|
|
332
|
+
// whichever tsconfig the compiler *found*, which for a bare `timber check`
|
|
333
|
+
// is a directory we never learn. Over-matching only suppresses an advisory.
|
|
334
|
+
//
|
|
335
|
+
// The bare form is matched as well as the `/`-prefixed one. tsgo emits
|
|
336
|
+
// `./timber-env.d.ts` today, but a leading `./` is cosmetic and an emitter
|
|
337
|
+
// that dropped it would turn this into a warning printed at every correctly
|
|
338
|
+
// configured project — the failure direction that trains people to ignore it.
|
|
339
|
+
const reaches = files.some((file) => {
|
|
340
|
+
if (typeof file !== 'string') return false;
|
|
341
|
+
const normalized = file.replace(/\\/g, '/');
|
|
342
|
+
return GENERATED_TYPE_PATHS.some(
|
|
343
|
+
(path) => normalized === path || normalized.endsWith(`/${path}`)
|
|
344
|
+
);
|
|
345
|
+
});
|
|
346
|
+
if (reaches) return;
|
|
347
|
+
|
|
348
|
+
process.stderr.write(
|
|
349
|
+
`[timber] The generated route types are not part of this TypeScript project, so\n` +
|
|
350
|
+
` \`<Link href>\` and \`useSegmentParams()\` are being checked against empty\n` +
|
|
351
|
+
` placeholders. Your tsconfig's "include" does not pull in timber-env.d.ts.\n\n` +
|
|
352
|
+
` To fix: add it to "include":\n\n` +
|
|
353
|
+
` "include": ["app", "*.config.ts", "timber-env.d.ts"]\n\n`
|
|
354
|
+
);
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
/**
|
|
358
|
+
* Run `tsgo --noEmit`, streaming its output.
|
|
359
|
+
*
|
|
360
|
+
* Rejects with the real numeric exit status on type errors. A failure to *start*
|
|
361
|
+
* the compiler is reported separately — the historical bug this replaces
|
|
362
|
+
* surfaced ENOENT as "Type check failed with exit code undefined", which read
|
|
363
|
+
* as a type error and sent users looking at their own code.
|
|
364
|
+
*/
|
|
365
|
+
export async function runTypeCheck(
|
|
366
|
+
options: CheckOptions = {},
|
|
367
|
+
deps: CheckDeps = {}
|
|
368
|
+
): Promise<void> {
|
|
369
|
+
// The *resolved* root, handed over by the route pass — not `process.cwd()`.
|
|
370
|
+
// The two differ whenever `--config` names a Vite config elsewhere, and the
|
|
371
|
+
// route pass wrote `.timber/*` and `timber-env.d.ts` under the resolved one.
|
|
372
|
+
// Running tsgo from cwd would then discover a different tsconfig entirely and
|
|
373
|
+
// type-check a different project than the one just validated (TIM-1332, round
|
|
374
|
+
// 5) — routes checked for the app, types checked for the monorepo around it.
|
|
375
|
+
const root = options.root ?? process.cwd();
|
|
376
|
+
const tsgoEntry = (deps.resolveTsgoEntry ?? (() => resolveTsgoEntry(root)))();
|
|
377
|
+
const runTsgo = deps.runTsgo ?? spawnTsgo;
|
|
378
|
+
|
|
379
|
+
// An explicit `--project` is a path the user typed at their own prompt, so it
|
|
380
|
+
// is resolved against *their* cwd before the compiler is moved to the project
|
|
381
|
+
// root. Without `--project`, tsgo discovers `tsconfig.json` from `root`,
|
|
382
|
+
// which is where the declarations it needs were just written.
|
|
383
|
+
const configArgs = options.config ? ['--project', resolve(process.cwd(), options.config)] : [];
|
|
384
|
+
|
|
385
|
+
// Before checking: say so if the declarations the route pass just wrote will
|
|
386
|
+
// not be part of the program. Otherwise the check passes while `<Link href>`
|
|
387
|
+
// is measured against a placeholder. Same root and same argv as the check
|
|
388
|
+
// itself, or it would inspect a different program than the one tsgo reads.
|
|
389
|
+
await warnIfRouteTypesUnreachable(
|
|
390
|
+
tsgoEntry,
|
|
391
|
+
configArgs,
|
|
392
|
+
root,
|
|
393
|
+
deps.readTsgoConfig ?? execTsgoConfig
|
|
394
|
+
);
|
|
395
|
+
|
|
396
|
+
let code: number | null;
|
|
397
|
+
try {
|
|
398
|
+
code = await runTsgo(process.execPath, [tsgoEntry, '--noEmit', ...configArgs], root);
|
|
399
|
+
} catch (err) {
|
|
400
|
+
// Could not start the compiler at all. Kept distinct from a nonzero exit:
|
|
401
|
+
// the version this replaced reported ENOENT as "Type check failed with
|
|
402
|
+
// exit code undefined", which reads as a verdict on the user's types.
|
|
403
|
+
throw new Error(
|
|
404
|
+
`[timber] Failed to start the type checker: ${err instanceof Error ? err.message : String(err)}`
|
|
405
|
+
);
|
|
406
|
+
}
|
|
407
|
+
|
|
408
|
+
if (code === 0) return;
|
|
409
|
+
|
|
410
|
+
// A null code means a signal killed the process rather than it exiting.
|
|
411
|
+
// Say so instead of printing "exit code null".
|
|
412
|
+
throw new Error(
|
|
413
|
+
code === null
|
|
414
|
+
? 'Type check terminated before it finished'
|
|
415
|
+
: `Type check failed with exit code ${code}`
|
|
416
|
+
);
|
|
417
|
+
}
|