@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,649 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Convention linter — validates common misconfigurations in the route tree.
|
|
3
|
+
*
|
|
4
|
+
* Runs at scan time (build and dev startup). Each check produces a warning
|
|
5
|
+
* with the file path, what's wrong, and what to do about it.
|
|
6
|
+
*
|
|
7
|
+
* Most checks are warnings — they don't block the build. The goal is to catch
|
|
8
|
+
* issues that would otherwise produce cryptic runtime behavior (silent 404s,
|
|
9
|
+
* empty pages, confusing React errors).
|
|
10
|
+
*
|
|
11
|
+
* A check emits `level: 'error'` only when the misconfiguration is *proven*
|
|
12
|
+
* (never inferred from an absence the analysis cannot see through) and fatal
|
|
13
|
+
* to rendering. `plugins/routing.ts` turns those into a thrown build error,
|
|
14
|
+
* so a false positive there refuses a working app — see
|
|
15
|
+
* `classifyClientBoundaryFile` for how that bar is met.
|
|
16
|
+
*
|
|
17
|
+
* Design doc: 07-routing.md, 10-error-handling.md
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
import { existsSync } from 'node:fs';
|
|
21
|
+
import type { RouteFile, RouteTree, SegmentNode } from './types.ts';
|
|
22
|
+
import { swallow } from '../server/logger.ts';
|
|
23
|
+
import { HTTP_METHODS } from '../server/route-methods.ts';
|
|
24
|
+
import {
|
|
25
|
+
fileDefaultExportIsLocalValue,
|
|
26
|
+
fileHasAnyExport,
|
|
27
|
+
fileHasDefaultExport,
|
|
28
|
+
fileHasDirective,
|
|
29
|
+
fileHasStarExport,
|
|
30
|
+
getCsrfExport,
|
|
31
|
+
} from './export-detect.ts';
|
|
32
|
+
|
|
33
|
+
// ─── Types ──────────────────────────────────────────────────────────────────
|
|
34
|
+
|
|
35
|
+
export interface ConventionWarning {
|
|
36
|
+
/** Warning ID for deduplication and filtering. */
|
|
37
|
+
id: string;
|
|
38
|
+
/** Human-readable single-line summary. */
|
|
39
|
+
summary: string;
|
|
40
|
+
/** Multi-line details with file path and fix suggestion. */
|
|
41
|
+
details: string;
|
|
42
|
+
/** Severity: 'warn' for potential issues, 'error' for definite misconfigurations. */
|
|
43
|
+
level: 'warn' | 'error';
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// ─── Lint Rules ─────────────────────────────────────────────────────────────
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Run all convention lint checks on a route tree.
|
|
50
|
+
*
|
|
51
|
+
* Returns an array of warnings. Empty array means everything looks good.
|
|
52
|
+
*/
|
|
53
|
+
export function lintConventions(tree: RouteTree, appDir: string): ConventionWarning[] {
|
|
54
|
+
const warnings: ConventionWarning[] = [];
|
|
55
|
+
|
|
56
|
+
// Check 1: app/ directory exists (caller should check before scanning,
|
|
57
|
+
// but we validate the root has at least one routable file)
|
|
58
|
+
checkEmptyApp(tree.root, appDir, warnings);
|
|
59
|
+
|
|
60
|
+
// Check 2: route.ts without recognized HTTP method exports
|
|
61
|
+
checkRouteExports(tree.root, warnings);
|
|
62
|
+
|
|
63
|
+
// Check 3: Segments with layout but no page/route anywhere in subtree
|
|
64
|
+
// (not a misconfiguration per se — layouts without pages are valid for
|
|
65
|
+
// route groups. Skip this check.)
|
|
66
|
+
|
|
67
|
+
// Check 4: Root segment has no layout.tsx (no HTML shell)
|
|
68
|
+
checkRootLayout(tree.root, warnings);
|
|
69
|
+
|
|
70
|
+
// Check 5: page.tsx / layout.tsx without default export
|
|
71
|
+
checkDefaultExports(tree.root, warnings);
|
|
72
|
+
|
|
73
|
+
// Check 6: Client layouts cannot suppress server children before Flight
|
|
74
|
+
// serializes them. They remain valid UI boundaries, but not authorization
|
|
75
|
+
// or data-hiding boundaries.
|
|
76
|
+
checkClientLayouts(tree.root, warnings);
|
|
77
|
+
|
|
78
|
+
// Check 7: error.tsx / 404.tsx / 4xx.tsx / … without 'use client' directive
|
|
79
|
+
checkClientBoundaryFiles(tree.root, warnings);
|
|
80
|
+
if (tree.globalError) {
|
|
81
|
+
checkFileUseClientDirective(tree.globalError, 'global-error', warnings);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
// Check 8: middleware.ts inside a parallel slot subtree (silently dead)
|
|
85
|
+
checkSlotMiddleware(tree.root, warnings);
|
|
86
|
+
|
|
87
|
+
// Check 9: `export const csrf` anywhere but route.ts, or in a form the
|
|
88
|
+
// scanner cannot read (TIM-1543)
|
|
89
|
+
checkCsrfExports(tree.root, warnings);
|
|
90
|
+
if (tree.proxy) checkCsrfExport(tree.proxy, 'proxy.ts', warnings);
|
|
91
|
+
if (tree.globalError) checkCsrfExport(tree.globalError, 'global-error', warnings);
|
|
92
|
+
|
|
93
|
+
return warnings;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
function checkClientLayouts(node: SegmentNode, warnings: ConventionWarning[]): void {
|
|
97
|
+
if (node.layout && isScriptExtension(node.layout.extension)) {
|
|
98
|
+
try {
|
|
99
|
+
const isClient = fileHasDirective(node.layout.filePath, 'use client');
|
|
100
|
+
const isProvablyServer = fileDefaultExportIsLocalValue(node.layout.filePath);
|
|
101
|
+
if (isClient || !isProvablyServer) {
|
|
102
|
+
const certainty = isClient
|
|
103
|
+
? `This layout is a client component.`
|
|
104
|
+
: `Timber cannot prove this layout is a server component because its default export comes from another module or an opaque expression.`;
|
|
105
|
+
warnings.push({
|
|
106
|
+
id: `CLIENT_LAYOUT_NOT_AUTH_BOUNDARY:${node.layout.filePath}`,
|
|
107
|
+
summary: isClient
|
|
108
|
+
? `Client layout cannot securely suppress server children: ${node.layout.filePath}`
|
|
109
|
+
: `Layout may resolve to a client component and cannot be trusted as an auth boundary: ${node.layout.filePath}`,
|
|
110
|
+
details:
|
|
111
|
+
` File: ${node.layout.filePath}\n\n` +
|
|
112
|
+
` ${certainty}\n` +
|
|
113
|
+
` React Flight resolves server content passed to a client layout before the layout runs in the browser.\n` +
|
|
114
|
+
` Conditionally omitting children here does not prevent descendant server components from executing or being serialized.\n\n` +
|
|
115
|
+
` To fix: Put authorization in access.ts or a provably server layout with a locally defined default component, and keep client components inside that boundary.\n`,
|
|
116
|
+
level: 'warn',
|
|
117
|
+
});
|
|
118
|
+
}
|
|
119
|
+
} catch (err) {
|
|
120
|
+
swallow(err, `convention-lint: unreadable layout file ${node.layout.filePath}`);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
for (const child of node.children) checkClientLayouts(child, warnings);
|
|
124
|
+
for (const slot of Object.values(node.slots)) checkClientLayouts(slot, warnings);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
// ─── Check: CSRF Exemption Export ──────────────────────────────────────────
|
|
128
|
+
|
|
129
|
+
/** Single-file segment conventions other than route.ts. */
|
|
130
|
+
const NON_ROUTE_FILE_KEYS = [
|
|
131
|
+
'page',
|
|
132
|
+
'layout',
|
|
133
|
+
'middleware',
|
|
134
|
+
'access',
|
|
135
|
+
'error',
|
|
136
|
+
'default',
|
|
137
|
+
'denied',
|
|
138
|
+
] as const satisfies readonly (keyof SegmentNode)[];
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* Fail the build on a `csrf` export the CSRF gate would not honor.
|
|
142
|
+
*
|
|
143
|
+
* Both findings are proven from source, and both are fatal in the sense
|
|
144
|
+
* the error level requires: the developer wrote an exemption that silently
|
|
145
|
+
* does nothing, so a legitimate cross-site POST they meant to accept gets
|
|
146
|
+
* a 403 in production, or they believe a page or action is exempt when
|
|
147
|
+
* the gate still protects it. The exemption exists only on route.ts —
|
|
148
|
+
* server actions always get the check (design/08 §"Per-route exemption").
|
|
149
|
+
* A `'use server'` module cannot export it at all: plugin-rsc rejects every
|
|
150
|
+
* non-async-function export there.
|
|
151
|
+
*/
|
|
152
|
+
function checkCsrfExports(node: SegmentNode, warnings: ConventionWarning[]): void {
|
|
153
|
+
if (node.route) checkCsrfExport(node.route, 'route.ts', warnings);
|
|
154
|
+
for (const key of NON_ROUTE_FILE_KEYS) {
|
|
155
|
+
const file = node[key];
|
|
156
|
+
if (file) checkCsrfExport(file, key, warnings);
|
|
157
|
+
}
|
|
158
|
+
// Status files and metadata routes (sitemap.ts, opengraph-image.tsx, …).
|
|
159
|
+
// JSON status files are skipped by the script-extension check.
|
|
160
|
+
for (const [name, file] of Object.entries(node.statusFiles ?? {})) {
|
|
161
|
+
checkCsrfExport(file, name, warnings);
|
|
162
|
+
}
|
|
163
|
+
for (const [name, file] of Object.entries(node.metadataRoutes ?? {})) {
|
|
164
|
+
checkCsrfExport(file, name, warnings);
|
|
165
|
+
}
|
|
166
|
+
for (const child of node.children) checkCsrfExports(child, warnings);
|
|
167
|
+
for (const slot of Object.values(node.slots)) checkCsrfExports(slot, warnings);
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
function checkCsrfExport(file: RouteFile, convention: string, warnings: ConventionWarning[]): void {
|
|
171
|
+
if (!isScriptExtension(file.extension)) return;
|
|
172
|
+
const found = getCsrfExport(file.filePath);
|
|
173
|
+
if (found === 'absent') return;
|
|
174
|
+
const isRoute = convention === 'route.ts';
|
|
175
|
+
if (isRoute && found === 'exempt') return;
|
|
176
|
+
warnings.push({
|
|
177
|
+
id: `CSRF_EXPORT_INVALID:${file.filePath}`,
|
|
178
|
+
summary: isRoute
|
|
179
|
+
? `route.ts csrf export must be exactly \`export const csrf = false\`: ${file.filePath}`
|
|
180
|
+
: `\`csrf\` can only be exported from route.ts, not ${convention}: ${file.filePath}`,
|
|
181
|
+
details:
|
|
182
|
+
` File: ${file.filePath}\n\n` +
|
|
183
|
+
(isRoute
|
|
184
|
+
? ' The CSRF gate reads this export from source before any module loads, so only\n' +
|
|
185
|
+
' the literal form counts. Other values, `let`, and re-exports are not read.\n\n' +
|
|
186
|
+
' To fix: write `export const csrf = false;` in this file, or remove the export.\n'
|
|
187
|
+
: ' The per-route CSRF exemption applies only to route.ts handlers. Pages, layouts\n' +
|
|
188
|
+
' and server actions always get the CSRF check.\n\n' +
|
|
189
|
+
' To fix: remove the export. To accept a cross-site POST, handle it in a route.ts\n' +
|
|
190
|
+
' that exports `const csrf = false`.\n'),
|
|
191
|
+
level: 'error',
|
|
192
|
+
});
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
// ─── Check: Empty App ───────────────────────────────────────────────────────
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* Warn when the app/ directory has no routable files at all.
|
|
199
|
+
*
|
|
200
|
+
* This catches the "I created app/ but didn't add any pages" case where
|
|
201
|
+
* every request silently 404s with no guidance.
|
|
202
|
+
*/
|
|
203
|
+
function checkEmptyApp(root: SegmentNode, appDir: string, warnings: ConventionWarning[]): void {
|
|
204
|
+
if (hasAnyRoutable(root)) return;
|
|
205
|
+
|
|
206
|
+
warnings.push({
|
|
207
|
+
id: 'EMPTY_APP',
|
|
208
|
+
summary: 'No pages or route handlers found in app/',
|
|
209
|
+
details:
|
|
210
|
+
` Directory: ${appDir}\n\n` +
|
|
211
|
+
' Your app/ directory has no page.tsx or route.ts files.\n' +
|
|
212
|
+
' Every request will return 404.\n\n' +
|
|
213
|
+
' To fix: Create app/page.tsx with a default export:\n\n' +
|
|
214
|
+
' export default function Home() {\n return <h1>Hello</h1>;\n }\n',
|
|
215
|
+
level: 'warn',
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* Check if a segment tree has any routable files (page or route) anywhere.
|
|
221
|
+
*/
|
|
222
|
+
function hasAnyRoutable(node: SegmentNode): boolean {
|
|
223
|
+
if (node.page || node.route) return true;
|
|
224
|
+
for (const child of node.children) {
|
|
225
|
+
if (hasAnyRoutable(child)) return true;
|
|
226
|
+
}
|
|
227
|
+
for (const slot of Object.values(node.slots)) {
|
|
228
|
+
if (hasAnyRoutable(slot)) return true;
|
|
229
|
+
}
|
|
230
|
+
return false;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Check if a segment tree has any page files (not just route handlers).
|
|
235
|
+
* Used by checkRootLayout to avoid false positives for API-only apps (TIM-794).
|
|
236
|
+
* API-only apps (just route.ts handlers) don't need a root layout.
|
|
237
|
+
*/
|
|
238
|
+
function hasAnyPage(node: SegmentNode): boolean {
|
|
239
|
+
if (node.page) return true;
|
|
240
|
+
for (const child of node.children) {
|
|
241
|
+
if (hasAnyPage(child)) return true;
|
|
242
|
+
}
|
|
243
|
+
for (const slot of Object.values(node.slots)) {
|
|
244
|
+
if (hasAnyPage(slot)) return true;
|
|
245
|
+
}
|
|
246
|
+
return false;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
// ─── Check: Route Exports ───────────────────────────────────────────────────
|
|
250
|
+
|
|
251
|
+
/**
|
|
252
|
+
* Warn when a route.ts file doesn't appear to export any recognized HTTP methods.
|
|
253
|
+
*
|
|
254
|
+
* Uses AST-based detection via parseAst for precise matching.
|
|
255
|
+
* Falls back silently when the file can't be parsed (syntax errors produce
|
|
256
|
+
* no spurious warning — the TS compiler will catch those).
|
|
257
|
+
*/
|
|
258
|
+
function checkRouteExports(node: SegmentNode, warnings: ConventionWarning[]): void {
|
|
259
|
+
if (node.route) {
|
|
260
|
+
const filePath = node.route.filePath;
|
|
261
|
+
try {
|
|
262
|
+
const methods = fileHasAnyExport(filePath, HTTP_METHODS);
|
|
263
|
+
if (methods.size === 0 && !fileHasStarExport(filePath)) {
|
|
264
|
+
const hasDefault = fileHasDefaultExport(filePath);
|
|
265
|
+
const hint = hasDefault
|
|
266
|
+
? ' It looks like you have a default export. route.ts uses named exports\n' +
|
|
267
|
+
' for HTTP methods (GET, POST, etc.), not a default export.\n'
|
|
268
|
+
: '';
|
|
269
|
+
|
|
270
|
+
warnings.push({
|
|
271
|
+
id: 'ROUTE_NO_METHODS',
|
|
272
|
+
summary: `route.ts has no HTTP method exports: ${filePath}`,
|
|
273
|
+
details:
|
|
274
|
+
` File: ${filePath}\n\n` +
|
|
275
|
+
' route.ts files must export named HTTP method handlers.\n' +
|
|
276
|
+
' Without them, the route matches but returns 405 Method Not Allowed.\n\n' +
|
|
277
|
+
hint +
|
|
278
|
+
' Example:\n\n' +
|
|
279
|
+
' export function GET(ctx: RouteContext) {\n' +
|
|
280
|
+
" return Response.json({ hello: 'world' });\n" +
|
|
281
|
+
' }\n',
|
|
282
|
+
level: 'warn',
|
|
283
|
+
});
|
|
284
|
+
}
|
|
285
|
+
} catch (err) {
|
|
286
|
+
swallow(err, `convention-lint: unreadable route.ts ${filePath}`);
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
// Recurse
|
|
291
|
+
for (const child of node.children) {
|
|
292
|
+
checkRouteExports(child, warnings);
|
|
293
|
+
}
|
|
294
|
+
for (const slot of Object.values(node.slots)) {
|
|
295
|
+
checkRouteExports(slot, warnings);
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
// ─── Check: Root Layout ─────────────────────────────────────────────────────
|
|
300
|
+
|
|
301
|
+
/**
|
|
302
|
+
* Warn when the root segment has no layout.tsx.
|
|
303
|
+
*
|
|
304
|
+
* Without a root layout, there's no HTML shell (<html>, <body>).
|
|
305
|
+
* The page will render but may have hydration issues or no proper document structure.
|
|
306
|
+
*/
|
|
307
|
+
function checkRootLayout(root: SegmentNode, warnings: ConventionWarning[]): void {
|
|
308
|
+
if (root.layout) return;
|
|
309
|
+
|
|
310
|
+
// Only warn if there are pages — API-only apps (just route.ts handlers)
|
|
311
|
+
// don't need a root layout (TIM-794).
|
|
312
|
+
if (!hasAnyPage(root)) return;
|
|
313
|
+
|
|
314
|
+
warnings.push({
|
|
315
|
+
id: 'NO_ROOT_LAYOUT',
|
|
316
|
+
summary: 'No root layout.tsx found',
|
|
317
|
+
details:
|
|
318
|
+
' Your app has pages but no root layout.\n' +
|
|
319
|
+
' Without app/layout.tsx, pages have no <html> or <body> wrapper.\n\n' +
|
|
320
|
+
' To fix: Create app/layout.tsx:\n\n' +
|
|
321
|
+
' export default function RootLayout({ children }: { children: React.ReactNode }) {\n' +
|
|
322
|
+
' return (\n' +
|
|
323
|
+
' <html lang="en">\n' +
|
|
324
|
+
' <body>{children}</body>\n' +
|
|
325
|
+
' </html>\n' +
|
|
326
|
+
' );\n' +
|
|
327
|
+
' }\n',
|
|
328
|
+
level: 'warn',
|
|
329
|
+
});
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
// ─── Check: Default Exports ───────────────────────────────────────────
|
|
333
|
+
|
|
334
|
+
/**
|
|
335
|
+
* Warn when page.tsx or layout.tsx files don't have a default export.
|
|
336
|
+
*
|
|
337
|
+
* Without a default export:
|
|
338
|
+
* - page.tsx: the page renders nothing (empty content)
|
|
339
|
+
* - layout.tsx: the layout module loads but has no component to render
|
|
340
|
+
*
|
|
341
|
+
* Uses AST-based detection via parseAst for precise matching. Falls back
|
|
342
|
+
* silently when the file can't be parsed (no spurious warning on syntax errors).
|
|
343
|
+
*/
|
|
344
|
+
function checkDefaultExports(node: SegmentNode, warnings: ConventionWarning[]): void {
|
|
345
|
+
// Check page files (tsx/ts/jsx/js only — not mdx, which is default-exported by the mdx compiler)
|
|
346
|
+
if (node.page && isScriptExtension(node.page.extension)) {
|
|
347
|
+
checkFileDefaultExport(node.page.filePath, 'page', warnings);
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
// Check layout files
|
|
351
|
+
if (node.layout && isScriptExtension(node.layout.extension)) {
|
|
352
|
+
checkFileDefaultExport(node.layout.filePath, 'layout', warnings);
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
// Recurse
|
|
356
|
+
for (const child of node.children) {
|
|
357
|
+
checkDefaultExports(child, warnings);
|
|
358
|
+
}
|
|
359
|
+
for (const slot of Object.values(node.slots)) {
|
|
360
|
+
checkDefaultExports(slot, warnings);
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
function isScriptExtension(ext: string): boolean {
|
|
365
|
+
return ext === 'tsx' || ext === 'ts' || ext === 'jsx' || ext === 'js';
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
function checkFileDefaultExport(
|
|
369
|
+
filePath: string,
|
|
370
|
+
fileType: string,
|
|
371
|
+
warnings: ConventionWarning[]
|
|
372
|
+
): void {
|
|
373
|
+
try {
|
|
374
|
+
if (!fileHasDefaultExport(filePath)) {
|
|
375
|
+
warnings.push({
|
|
376
|
+
id: `NO_DEFAULT_EXPORT:${filePath}`,
|
|
377
|
+
summary: `${fileType}.tsx has no default export: ${filePath}`,
|
|
378
|
+
details:
|
|
379
|
+
` File: ${filePath}\n\n` +
|
|
380
|
+
` ${fileType}.tsx files must export a default React component.\n` +
|
|
381
|
+
` Without a default export, the ${fileType === 'page' ? 'page renders nothing' : 'layout has no component to wrap children'}.\n\n` +
|
|
382
|
+
` To fix: Add a default export:\n\n` +
|
|
383
|
+
` export default function My${fileType === 'page' ? 'Page' : 'Layout'}(${fileType === 'layout' ? '{ children }' : ''}) {\n` +
|
|
384
|
+
` return ${fileType === 'layout' ? '<div>{children}</div>' : '<h1>Hello</h1>'};\n` +
|
|
385
|
+
` }\n`,
|
|
386
|
+
level: 'warn',
|
|
387
|
+
});
|
|
388
|
+
}
|
|
389
|
+
} catch (err) {
|
|
390
|
+
swallow(err, `convention-lint: unreadable ${fileType} file ${filePath}`);
|
|
391
|
+
}
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
// ─── Check: Client Boundary Directive ───────────────────────────────────────
|
|
395
|
+
|
|
396
|
+
/**
|
|
397
|
+
* Check every file the renderer hands to `TimberErrorBoundary` as a component
|
|
398
|
+
* prop: `error.tsx`, `global-error.tsx`, and the status-code family
|
|
399
|
+
* (`404.tsx`, `4xx.tsx`, `503.tsx`, …).
|
|
400
|
+
*
|
|
401
|
+
* `TimberErrorBoundary` is a client component, so a server component passed as
|
|
402
|
+
* `fallbackComponent` is a function crossing the RSC → client boundary. React
|
|
403
|
+
* Flight refuses to serialize it, and because the boundary wraps the segment's
|
|
404
|
+
* *children*, the failure hits every page under that segment — not just the
|
|
405
|
+
* error path. The raw message ("Functions cannot be passed directly to Client
|
|
406
|
+
* Components") names neither the file nor the fix (TIM-1329).
|
|
407
|
+
*
|
|
408
|
+
* `.json` status files never reach React at all, and are not in `statusFiles`.
|
|
409
|
+
*/
|
|
410
|
+
function checkClientBoundaryFiles(node: SegmentNode, warnings: ConventionWarning[]): void {
|
|
411
|
+
if (node.error) {
|
|
412
|
+
checkFileUseClientDirective(node.error, 'error', warnings);
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
for (const [key, file] of Object.entries(node.statusFiles ?? {})) {
|
|
416
|
+
checkFileUseClientDirective(file, key, warnings);
|
|
417
|
+
}
|
|
418
|
+
|
|
419
|
+
for (const child of node.children) {
|
|
420
|
+
checkClientBoundaryFiles(child, warnings);
|
|
421
|
+
}
|
|
422
|
+
for (const slot of Object.values(node.slots)) {
|
|
423
|
+
checkClientBoundaryFiles(slot, warnings);
|
|
424
|
+
}
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
/**
|
|
428
|
+
* `'client'` — carries the directive.
|
|
429
|
+
* `'server'` — proven server component: no directive, and the default export is
|
|
430
|
+
* a function or class built by this very module, so no other file's directive
|
|
431
|
+
* can be governing it.
|
|
432
|
+
* `'unknown'` — no directive, but the exported value may come from elsewhere
|
|
433
|
+
* (`export { default } from './client-thing'`), or the file could not be
|
|
434
|
+
* read or parsed. Never escalated to a build error.
|
|
435
|
+
*/
|
|
436
|
+
type ClientBoundaryVerdict = 'client' | 'server' | 'unknown';
|
|
437
|
+
|
|
438
|
+
function classifyClientBoundaryFile(filePath: string): ClientBoundaryVerdict {
|
|
439
|
+
if (fileHasDirective(filePath, 'use client')) return 'client';
|
|
440
|
+
if (fileDefaultExportIsLocalValue(filePath)) return 'server';
|
|
441
|
+
return 'unknown';
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
/** Example component name for the fix snippet, keyed by convention name. */
|
|
445
|
+
function exampleComponentName(convention: string): string {
|
|
446
|
+
if (convention === 'global-error') return 'GlobalError';
|
|
447
|
+
if (convention === 'error') return 'ErrorBoundary';
|
|
448
|
+
if (convention === '404') return 'NotFound';
|
|
449
|
+
return 'StatusPage';
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
/**
|
|
453
|
+
* @param file the route file (its extension decides whether the check applies)
|
|
454
|
+
* @param convention the convention name — `error`, `global-error`, `404`, `4xx`, …
|
|
455
|
+
*/
|
|
456
|
+
function checkFileUseClientDirective(
|
|
457
|
+
file: RouteFile,
|
|
458
|
+
convention: string,
|
|
459
|
+
warnings: ConventionWarning[]
|
|
460
|
+
): void {
|
|
461
|
+
// Only script extensions need the 'use client' check — .json status files
|
|
462
|
+
// never reach React at all, and are not in `statusFiles`.
|
|
463
|
+
if (!isScriptExtension(file.extension)) return;
|
|
464
|
+
|
|
465
|
+
const filePath = file.filePath;
|
|
466
|
+
const label = `${convention}.${file.extension}`;
|
|
467
|
+
let verdict: ClientBoundaryVerdict;
|
|
468
|
+
try {
|
|
469
|
+
verdict = classifyClientBoundaryFile(filePath);
|
|
470
|
+
} catch (err) {
|
|
471
|
+
swallow(err, `convention-lint: unreadable ${label} file ${filePath}`);
|
|
472
|
+
return;
|
|
473
|
+
}
|
|
474
|
+
if (verdict === 'client') return;
|
|
475
|
+
|
|
476
|
+
const isError = verdict === 'server';
|
|
477
|
+
const name = exampleComponentName(convention);
|
|
478
|
+
const props =
|
|
479
|
+
convention === 'error' || convention === 'global-error' ? '{ error, reset }' : '{ status }';
|
|
480
|
+
|
|
481
|
+
warnings.push({
|
|
482
|
+
id: `NEEDS_USE_CLIENT:${filePath}`,
|
|
483
|
+
summary: isError
|
|
484
|
+
? `${label} is a server component and must be a client component: ${filePath}`
|
|
485
|
+
: `${label} may be missing 'use client': ${filePath}`,
|
|
486
|
+
details:
|
|
487
|
+
` File: ${filePath}\n\n` +
|
|
488
|
+
` ${label} is handed to timber's error boundary — a client\n` +
|
|
489
|
+
' component — as a prop. A server component cannot cross that boundary:\n' +
|
|
490
|
+
' React fails with "Functions cannot be passed directly to Client\n' +
|
|
491
|
+
' Components", and every page under this segment fails to render.\n\n' +
|
|
492
|
+
(isError
|
|
493
|
+
? " To fix: Add 'use client' as the first line of the file:\n\n" +
|
|
494
|
+
" 'use client';\n\n" +
|
|
495
|
+
` export default function ${name}(${props}) {\n` +
|
|
496
|
+
' return <h1>…</h1>;\n' +
|
|
497
|
+
' }\n'
|
|
498
|
+
: // The default export comes from somewhere this analysis cannot follow
|
|
499
|
+
// — a re-export, an imported binding, a wrapper call. It may well
|
|
500
|
+
// already be a client component, so say what was checked rather than
|
|
501
|
+
// assert a break.
|
|
502
|
+
" This file has no 'use client' directive, and its default export\n" +
|
|
503
|
+
' comes from elsewhere, so timber cannot tell which it is. If the\n' +
|
|
504
|
+
" module it re-exports starts with 'use client', nothing is wrong\n" +
|
|
505
|
+
' and you can ignore this. Otherwise add the directive there.\n'),
|
|
506
|
+
level: isError ? 'error' : 'warn',
|
|
507
|
+
});
|
|
508
|
+
}
|
|
509
|
+
|
|
510
|
+
// ─── Check: Slot Middleware ─────────────────────────────────────────────────
|
|
511
|
+
|
|
512
|
+
/**
|
|
513
|
+
* Error when middleware.ts appears inside a parallel slot subtree.
|
|
514
|
+
*
|
|
515
|
+
* Middleware is collected from the main matched segment chain only
|
|
516
|
+
* (route-matcher.ts `collectMiddlewareChain`). The slot resolver never
|
|
517
|
+
* walks `middleware` on its matched chain, so a middleware.ts under any
|
|
518
|
+
* `@slot/` directory silently never executes. `access.ts` in slot chains
|
|
519
|
+
* DOES run (via SlotAccessGate), making the asymmetry invisible unless
|
|
520
|
+
* you know to look.
|
|
521
|
+
*
|
|
522
|
+
* This is a build error rather than a warning: the file provably cannot
|
|
523
|
+
* run and its presence misleads the author into thinking the slot is
|
|
524
|
+
* middleware-protected.
|
|
525
|
+
*
|
|
526
|
+
* See design/07-routing.md §"Parallel Routes"
|
|
527
|
+
*/
|
|
528
|
+
function checkSlotMiddleware(node: SegmentNode, warnings: ConventionWarning[]): void {
|
|
529
|
+
for (const [slotName, slotRoot] of Object.entries(node.slots)) {
|
|
530
|
+
collectSlotMiddleware(slotRoot, slotName, warnings);
|
|
531
|
+
}
|
|
532
|
+
for (const child of node.children) {
|
|
533
|
+
checkSlotMiddleware(child, warnings);
|
|
534
|
+
}
|
|
535
|
+
}
|
|
536
|
+
|
|
537
|
+
/**
|
|
538
|
+
* Walk a slot subtree and report every middleware.ts found.
|
|
539
|
+
*/
|
|
540
|
+
function collectSlotMiddleware(
|
|
541
|
+
node: SegmentNode,
|
|
542
|
+
slotName: string,
|
|
543
|
+
warnings: ConventionWarning[]
|
|
544
|
+
): void {
|
|
545
|
+
if (node.middleware) {
|
|
546
|
+
warnings.push({
|
|
547
|
+
id: `SLOT_MIDDLEWARE:${node.middleware.filePath}`,
|
|
548
|
+
summary: `middleware.ts inside slot @${slotName} never executes: ${node.middleware.filePath}`,
|
|
549
|
+
details:
|
|
550
|
+
` File: ${node.middleware.filePath}\n\n` +
|
|
551
|
+
` Middleware is collected from the main route chain only.\n` +
|
|
552
|
+
` The slot resolver does not run middleware — this file is silently dead.\n` +
|
|
553
|
+
` (access.ts in slots does run via SlotAccessGate; middleware.ts does not.)\n\n` +
|
|
554
|
+
` To fix: Move the middleware logic into access.ts for slot-scoped auth,\n` +
|
|
555
|
+
` or into a middleware.ts on the main route chain outside the slot.\n`,
|
|
556
|
+
level: 'error',
|
|
557
|
+
});
|
|
558
|
+
}
|
|
559
|
+
for (const child of node.children) {
|
|
560
|
+
collectSlotMiddleware(child, slotName, warnings);
|
|
561
|
+
}
|
|
562
|
+
for (const [nestedSlotName, nestedSlot] of Object.entries(node.slots)) {
|
|
563
|
+
collectSlotMiddleware(nestedSlot, nestedSlotName, warnings);
|
|
564
|
+
}
|
|
565
|
+
}
|
|
566
|
+
|
|
567
|
+
// ─── Check: App Directory Exists ────────────────────────────────────────────
|
|
568
|
+
|
|
569
|
+
/**
|
|
570
|
+
* Check if the app/ directory exists. Called before scanning.
|
|
571
|
+
* Returns a warning if missing, or null if the directory exists.
|
|
572
|
+
*/
|
|
573
|
+
export function checkAppDirExists(appDir: string): ConventionWarning | null {
|
|
574
|
+
if (existsSync(appDir)) return null;
|
|
575
|
+
|
|
576
|
+
return {
|
|
577
|
+
id: 'NO_APP_DIR',
|
|
578
|
+
summary: 'No app/ directory found',
|
|
579
|
+
details:
|
|
580
|
+
` Expected: ${appDir}\n\n` +
|
|
581
|
+
' timber.js requires an app/ directory for file-system routing.\n' +
|
|
582
|
+
' Every request will return 404 until you create it.\n\n' +
|
|
583
|
+
' To fix: Create the app/ directory with a page:\n\n' +
|
|
584
|
+
' mkdir -p app\n' +
|
|
585
|
+
' # Create app/layout.tsx and app/page.tsx\n',
|
|
586
|
+
level: 'error',
|
|
587
|
+
};
|
|
588
|
+
}
|
|
589
|
+
|
|
590
|
+
// ─── Formatting ─────────────────────────────────────────────────────────────
|
|
591
|
+
|
|
592
|
+
import type { InspectColor } from 'node:util';
|
|
593
|
+
import { styleText } from 'node:util';
|
|
594
|
+
|
|
595
|
+
type Format = InspectColor | readonly InspectColor[];
|
|
596
|
+
const noValidate = { validateStream: false } as const;
|
|
597
|
+
|
|
598
|
+
export interface FormatOptions {
|
|
599
|
+
/**
|
|
600
|
+
* Emit ANSI escapes. Off when the text becomes an `Error` message —
|
|
601
|
+
* whoever prints it decides its formatting, and colored escapes inside
|
|
602
|
+
* an exception leak into logs and stack traces.
|
|
603
|
+
*/
|
|
604
|
+
color?: boolean;
|
|
605
|
+
}
|
|
606
|
+
|
|
607
|
+
/**
|
|
608
|
+
* Format warnings for terminal output.
|
|
609
|
+
*
|
|
610
|
+
* Groups by severity, uses colors, and includes fix suggestions.
|
|
611
|
+
*/
|
|
612
|
+
export function formatConventionWarnings(
|
|
613
|
+
warnings: ConventionWarning[],
|
|
614
|
+
options: FormatOptions = {}
|
|
615
|
+
): string {
|
|
616
|
+
const { color = true } = options;
|
|
617
|
+
const style = (fmt: Format, text: string) => (color ? styleText(fmt, text, noValidate) : text);
|
|
618
|
+
if (warnings.length === 0) return '';
|
|
619
|
+
|
|
620
|
+
const errors = warnings.filter((w) => w.level === 'error');
|
|
621
|
+
const warns = warnings.filter((w) => w.level === 'warn');
|
|
622
|
+
|
|
623
|
+
const lines: string[] = [];
|
|
624
|
+
|
|
625
|
+
if (errors.length > 0) {
|
|
626
|
+
lines.push(
|
|
627
|
+
`${style(['red', 'bold'], '[timber]')} ${style('red', `${errors.length} configuration error${errors.length !== 1 ? 's' : ''}:`)}`
|
|
628
|
+
);
|
|
629
|
+
for (const e of errors) {
|
|
630
|
+
lines.push('');
|
|
631
|
+
lines.push(` ${style('red', '✗')} ${e.summary}`);
|
|
632
|
+
lines.push(style('dim', e.details));
|
|
633
|
+
}
|
|
634
|
+
}
|
|
635
|
+
|
|
636
|
+
if (warns.length > 0) {
|
|
637
|
+
if (errors.length > 0) lines.push('');
|
|
638
|
+
lines.push(
|
|
639
|
+
`${style(['yellow', 'bold'], '[timber]')} ${style('yellow', `${warns.length} configuration warning${warns.length !== 1 ? 's' : ''}:`)}`
|
|
640
|
+
);
|
|
641
|
+
for (const w of warns) {
|
|
642
|
+
lines.push('');
|
|
643
|
+
lines.push(` ${style('yellow', '⚠')} ${w.summary}`);
|
|
644
|
+
lines.push(style('dim', w.details));
|
|
645
|
+
}
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
return lines.join('\n');
|
|
649
|
+
}
|