@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.230
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 +376 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-DHum77eH.js +1272 -0
- package/dist/_chunks/actions-DHum77eH.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-B-JZkpBD.js +251 -0
- package/dist/_chunks/cli-check-B-JZkpBD.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-CPc6bjVl.js +20 -0
- package/dist/_chunks/codec-registry-CPc6bjVl.js.map +1 -0
- package/dist/_chunks/codegen-B9oWkWGf.js +429 -0
- package/dist/_chunks/codegen-B9oWkWGf.js.map +1 -0
- package/dist/_chunks/convention-lint-CrDKERHg.js +578 -0
- package/dist/_chunks/convention-lint-CrDKERHg.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-validation-CEZy1V-k.js +210 -0
- package/dist/_chunks/href-validation-CEZy1V-k.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/{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 +22 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +416 -1241
- 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 +85 -60
- 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 +35 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9949 -14264
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +26 -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 +5 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +33 -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/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 +105 -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 +5094 -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 +91 -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/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 +91 -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 +108 -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 +120 -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 +91 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +464 -151
- 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 +498 -380
- package/src/params/codec-registry.ts +34 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +17 -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 +257 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -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 +349 -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 +280 -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 +223 -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 +417 -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/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
|
@@ -8,20 +8,72 @@
|
|
|
8
8
|
*
|
|
9
9
|
* See design/07-routing.md §"Intercepting Routes"
|
|
10
10
|
*/
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
sourcePathname: string;
|
|
15
|
-
}
|
|
11
|
+
import type { InterceptionRewrite } from '../routing/interception.ts';
|
|
12
|
+
import type { InterceptionContext, PipelineConfig, RouteMatch } from './pipeline.ts';
|
|
13
|
+
import type { MiddlewareFn } from './middleware-runner.ts';
|
|
16
14
|
/**
|
|
17
15
|
* Check if an intercepting route applies for this soft navigation.
|
|
18
16
|
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
17
|
+
* Two conditions must hold:
|
|
18
|
+
*
|
|
19
|
+
* 1. The **target** pathname matches the rewrite's intercepted pattern.
|
|
20
|
+
* 2. The **source** route — the page the user is navigating FROM, per the
|
|
21
|
+
* validated X-Timber-URL header — renders the segment that owns the slot
|
|
22
|
+
* holding the intercepting page (`interceptingScope`). Only then does that
|
|
23
|
+
* slot exist in the rendered tree, so only then can the intercepting page
|
|
24
|
+
* render.
|
|
25
|
+
*
|
|
26
|
+
* Condition 2 replaced a URL-prefix check (TIM-1279). A prefix cannot
|
|
27
|
+
* distinguish a route-group-scoped interception from a genuinely root-level
|
|
28
|
+
* one — route groups are invisible in `urlPath`, so both collapse to "/" and
|
|
29
|
+
* the guard degenerates to always-true. Tree paths carry group identity.
|
|
30
|
+
* The scope check also subsumes the old segment-boundary rule: a source route
|
|
31
|
+
* under /feed-private has no "/feed" in its chain.
|
|
32
|
+
*
|
|
33
|
+
* A third condition lives with the caller, which owns route matching, and it
|
|
34
|
+
* applies to the `'slot'` shape only: the route produced by re-matching
|
|
35
|
+
* `interceptingPrefix` must pass through the scope too. Conditions 1–2 are
|
|
36
|
+
* about the route the user is leaving; the slot has to exist in the tree that
|
|
37
|
+
* actually renders. The `'children'` shape resolves its owner from the scope
|
|
38
|
+
* directly rather than from a pathname, so it satisfies that by construction.
|
|
39
|
+
*
|
|
40
|
+
* `resolveSourceScopes` is a thunk so its inputs are only resolved when some
|
|
41
|
+
* rewrite's pattern actually matches the target — the common case is no match
|
|
42
|
+
* at all. It returns the two client-supplied answers to "what is on screen?"
|
|
43
|
+
* as **separate sets, most authoritative first**: the tree paths the client
|
|
44
|
+
* says it has mounted, then those of the route the departing URL matches. It
|
|
45
|
+
* returns null only when neither yields anything, which is not a soft
|
|
46
|
+
* navigation this can reason about.
|
|
21
47
|
*
|
|
22
|
-
*
|
|
48
|
+
* They are two sets rather than one union because ranking needs a chain
|
|
49
|
+
* (TIM-1318). Each channel describes a single rendered chain, so within one the
|
|
50
|
+
* scopes are strictly nested and the deepest is the innermost owner. Unioned
|
|
51
|
+
* they are not: once a modal is open the address bar holds the *intercepted*
|
|
52
|
+
* URL, so the second channel describes the canonical branch — possibly an
|
|
53
|
+
* exclusive route group the client never mounted — and a deeper scope from
|
|
54
|
+
* there would outrank the owner actually on screen. Trying the mounted channel
|
|
55
|
+
* to exhaustion first keeps the fallback the union was there to provide while
|
|
56
|
+
* ranking only within one chain.
|
|
57
|
+
*
|
|
58
|
+
* Returns the winning build-time rewrite, or null. Only build-time values ever
|
|
59
|
+
* reach the renderer: the client-supplied header selects a rewrite but never
|
|
60
|
+
* becomes a rendered route or pathname.
|
|
61
|
+
*
|
|
62
|
+
* The **first** matching rewrite wins, and the caller does not fall back to the
|
|
63
|
+
* next one when the winner fails to resolve. That is deliberate and pre-dates
|
|
64
|
+
* the two shapes: a rewrite that matched the target and the scope described the
|
|
65
|
+
* author's intent, and quietly rendering some other author's interception
|
|
66
|
+
* instead would be harder to explain than rendering the canonical route.
|
|
67
|
+
*
|
|
68
|
+
* "First" is meaningful because the list arrives **deepest scope first** —
|
|
69
|
+
* `collectInterceptionRewrites` sorts it at build time, so the deepest owner a
|
|
70
|
+
* single chain passes through wins and nothing here has to score (TIM-1318).
|
|
71
|
+
* Tree-walk order used to decide it, which meant renaming a route group flipped
|
|
72
|
+
* which modal opened. The precondition is a property of the manifest this reads
|
|
73
|
+
* rather than something it can re-derive, so it is asserted at its source:
|
|
74
|
+
* `tests/interception.test.ts` §"rewrite order is decided by scope depth".
|
|
23
75
|
*/
|
|
24
|
-
export declare function findInterceptionMatch(targetPathname: string,
|
|
76
|
+
export declare function findInterceptionMatch(targetPathname: string, resolveSourceScopes: () => ReadonlySet<string>[] | null, rewrites: InterceptionRewrite[]): InterceptionRewrite | null;
|
|
25
77
|
/**
|
|
26
78
|
* Check if a pathname matches a URL pattern with dynamic segments.
|
|
27
79
|
*
|
|
@@ -29,4 +81,43 @@ export declare function findInterceptionMatch(targetPathname: string, sourceUrl:
|
|
|
29
81
|
* Static segments must match exactly.
|
|
30
82
|
*/
|
|
31
83
|
export declare function pathnameMatchesPattern(pathname: string, pattern: string): boolean;
|
|
84
|
+
/**
|
|
85
|
+
* Which route renders a request, and — when an interception replaced it —
|
|
86
|
+
* which route authorizes it.
|
|
87
|
+
*/
|
|
88
|
+
export interface ResolvedRoute {
|
|
89
|
+
/** The route that renders: the canonical match unless a rewrite applied. */
|
|
90
|
+
match: RouteMatch | null;
|
|
91
|
+
/** Set for the modal shape only; see the `'children'` branch below. */
|
|
92
|
+
interception?: InterceptionContext;
|
|
93
|
+
/**
|
|
94
|
+
* The URL's own route, set whenever an interception replaced it — in
|
|
95
|
+
* either shape. Its middleware and access chain authorize the response:
|
|
96
|
+
* the rendered chain is a different route, and nothing on it was written
|
|
97
|
+
* to protect this URL (TIM-1607).
|
|
98
|
+
*/
|
|
99
|
+
canonical?: RouteMatch;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* Resolve which route renders a soft navigation that an intercepting route
|
|
103
|
+
* may claim. Returns the canonical match unchanged when no rewrite applies.
|
|
104
|
+
*
|
|
105
|
+
* Runs during route setup, so anything it throws is a `'setup'` outcome.
|
|
106
|
+
*/
|
|
107
|
+
export declare function resolveInterceptedRoute(config: PipelineConfig, req: Request, canonicalPathname: string, canonicalMatch: RouteMatch | null): ResolvedRoute;
|
|
108
|
+
/**
|
|
109
|
+
* The middleware an intercepted navigation runs: the URL's chain, then each
|
|
110
|
+
* middleware.ts only the rendered chain has. Shared ancestors are the same
|
|
111
|
+
* manifest nodes on both chains, so each file runs once, and each chain keeps
|
|
112
|
+
* its own root-to-leaf order (TIM-1607).
|
|
113
|
+
*/
|
|
114
|
+
export declare function interceptedMiddlewareChain(canonical: RouteMatch, rendered: RouteMatch): MiddlewareFn[];
|
|
115
|
+
/**
|
|
116
|
+
* Run `fn` with a route's own params as what `getSegmentParams()` returns.
|
|
117
|
+
*
|
|
118
|
+
* An intercepted request publishes the rendered route's params. The URL's
|
|
119
|
+
* middleware and access.ts were written for the URL's route, and run under
|
|
120
|
+
* this so they read its params (TIM-1607).
|
|
121
|
+
*/
|
|
122
|
+
export declare function runWithRouteParams<T>(route: RouteMatch, fn: () => T): T;
|
|
32
123
|
//# sourceMappingURL=pipeline-interception.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pipeline-interception.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-interception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;
|
|
1
|
+
{"version":3,"file":"pipeline-interception.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-interception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAKtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EACvD,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,mBAAmB,GAAG,IAAI,CAyB5B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAsCjF;AAID;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,UAAU,GAAG,IAAI,GAChC,aAAa,CAwGf;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,UAAU,GACnB,YAAY,EAAE,CAMhB;AAsBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvE"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Stage 1b of the request pipeline: serving a matched metadata route
|
|
3
|
+
* (sitemap, robots, manifest, favicon, icon, apple-icon, opengraph-image).
|
|
4
|
+
*
|
|
5
|
+
* A metadata route runs the per-segment stages a page at its segment runs,
|
|
6
|
+
* in the same order: param coercion through `app/schema.ts`, then the
|
|
7
|
+
* `middleware.ts` chain, then the `access.ts` chain — then the file or
|
|
8
|
+
* handler. Files owned by the root segment are the one exception: they are
|
|
9
|
+
* the app's public crawler surface (`/robots.txt`, `/sitemap.xml`, the app
|
|
10
|
+
* icons), so no gate runs for them, not even a root `access.ts` that gates
|
|
11
|
+
* every page. A file anywhere below the root, a route group included, sits
|
|
12
|
+
* in its segments' authorization scope like any page there (TIM-1609).
|
|
13
|
+
*
|
|
14
|
+
* Signals answer with a bare status, never a deny page: a metadata route is
|
|
15
|
+
* an image, a sitemap or a text file, not a document.
|
|
16
|
+
*
|
|
17
|
+
* See design/16-metadata.md §"Pipeline Integration",
|
|
18
|
+
* design/13-security.md threat 11b.
|
|
19
|
+
*/
|
|
20
|
+
import { type MetadataRouteMatch } from './route-matcher.ts';
|
|
21
|
+
import type { PipelineConfig } from './pipeline.ts';
|
|
22
|
+
/** Answer a request whose canonical pathname matched a metadata route. */
|
|
23
|
+
export declare function serveMetadataRoute(config: PipelineConfig, req: Request, method: string, path: string, pathname: string, metaMatch: MetadataRouteMatch): Promise<Response>;
|
|
24
|
+
//# sourceMappingURL=pipeline-metadata-route.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pipeline-metadata-route.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-metadata-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAuBH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,eAAe,CAAC;AAGhE,0EAA0E;AAC1E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA8EnB"}
|
|
@@ -6,16 +6,26 @@
|
|
|
6
6
|
*
|
|
7
7
|
* See design/16-metadata.md §"Metadata Routes"
|
|
8
8
|
*/
|
|
9
|
+
/**
|
|
10
|
+
* Cache-Control the framework sets on metadata route responses it produces:
|
|
11
|
+
* static files, serialized handler results (sitemap, robots, manifest) and
|
|
12
|
+
* the auto-generated sitemap. A Response a handler returns is sent with its
|
|
13
|
+
* own headers only — the framework adds no default to it.
|
|
14
|
+
*
|
|
15
|
+
* See design/16-metadata.md §"Caching" (under "Metadata Routes")
|
|
16
|
+
*/
|
|
17
|
+
export declare const METADATA_CACHE_CONTROL = "public, max-age=14400, must-revalidate";
|
|
9
18
|
/**
|
|
10
19
|
* Serve a static metadata file by reading it from disk.
|
|
11
20
|
*
|
|
12
21
|
* Static metadata route files (.xml, .txt, .json, .png, .ico, .svg, etc.)
|
|
13
22
|
* are served as-is with the appropriate Content-Type header.
|
|
14
|
-
* Text files include charset=utf-8; binary files do not.
|
|
23
|
+
* Text files include charset=utf-8; binary files do not. `cacheControl` is
|
|
24
|
+
* omitted for a file behind gates, whose answer depends on who asked.
|
|
15
25
|
*
|
|
16
26
|
* See design/16-metadata.md §"Metadata Routes"
|
|
17
27
|
*/
|
|
18
|
-
export declare function serveStaticMetadataFile(metaMatch: import('./route-matcher.
|
|
28
|
+
export declare function serveStaticMetadataFile(metaMatch: import('./route-matcher.ts').MetadataRouteMatch, cacheControl: string | undefined): Promise<Response>;
|
|
19
29
|
/**
|
|
20
30
|
* Serialize a sitemap array to XML.
|
|
21
31
|
* Follows the sitemap.org protocol: https://www.sitemaps.org/protocol.html
|
|
@@ -26,6 +36,12 @@ export declare function serializeSitemap(entries: Array<{
|
|
|
26
36
|
changeFrequency?: string;
|
|
27
37
|
priority?: number;
|
|
28
38
|
}>): string;
|
|
39
|
+
/**
|
|
40
|
+
* Serialize a sitemap index (list of sub-sitemap URLs) to XML.
|
|
41
|
+
* Used for pagination when the total URL count exceeds 50,000.
|
|
42
|
+
* Follows the sitemap.org protocol: https://www.sitemaps.org/protocol.html
|
|
43
|
+
*/
|
|
44
|
+
export declare function serializeSitemapIndex(sitemapUrls: string[]): string;
|
|
29
45
|
/** Escape special XML characters. */
|
|
30
46
|
export declare function escapeXml(str: string): string;
|
|
31
47
|
//# sourceMappingURL=pipeline-metadata.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pipeline-metadata.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;
|
|
1
|
+
{"version":3,"file":"pipeline-metadata.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,2CAA2C,CAAC;AAc/E;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,OAAO,oBAAoB,EAAE,kBAAkB,EAC1D,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,QAAQ,CAAC,CAanB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,GACD,MAAM,CAoBR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAMnE;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7C"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pipeline outcome translator — converts a `PhaseOutcome` (the value
|
|
3
|
+
* each phase function returns) into a final `Response`.
|
|
4
|
+
*
|
|
5
|
+
* Lifted out of `pipeline-phases.ts` (TIM-853) so the per-phase try /
|
|
6
|
+
* catch logic and the terminal Response-building logic each live in
|
|
7
|
+
* their own file. The phases produce values; this module is the single
|
|
8
|
+
* source of truth for how those values become wire responses.
|
|
9
|
+
*
|
|
10
|
+
* See design/07-routing.md §"Request Lifecycle".
|
|
11
|
+
*/
|
|
12
|
+
import { RedirectSignal, DenySignal } from './primitives.ts';
|
|
13
|
+
import type { PipelineConfig, RouteMatch } from './pipeline.ts';
|
|
14
|
+
/**
|
|
15
|
+
* The pipeline phase an outcome came from.
|
|
16
|
+
*
|
|
17
|
+
* `'setup'` is route setup between `proxy.ts` and `middleware.ts`: route
|
|
18
|
+
* matching, interception, and segment-param coercion. It has its own name
|
|
19
|
+
* rather than borrowing `'middleware'` because both the cookie-jar guard
|
|
20
|
+
* and `onRequestError` key on the phase (TIM-1537).
|
|
21
|
+
*/
|
|
22
|
+
export type PhaseName = 'proxy' | 'setup' | 'middleware' | 'render';
|
|
23
|
+
export type PhaseOutcome = {
|
|
24
|
+
kind: 'response';
|
|
25
|
+
phase: PhaseName;
|
|
26
|
+
response: Response;
|
|
27
|
+
} | {
|
|
28
|
+
kind: 'redirect';
|
|
29
|
+
phase: PhaseName;
|
|
30
|
+
signal: RedirectSignal;
|
|
31
|
+
} | {
|
|
32
|
+
kind: 'deny';
|
|
33
|
+
phase: PhaseName;
|
|
34
|
+
signal: DenySignal;
|
|
35
|
+
} | {
|
|
36
|
+
kind: 'error';
|
|
37
|
+
phase: PhaseName;
|
|
38
|
+
error: unknown;
|
|
39
|
+
};
|
|
40
|
+
/** The outcome for a value a phase threw: a signal, or an error. */
|
|
41
|
+
export declare function thrownOutcome(phase: PhaseName, thrown: unknown): PhaseOutcome;
|
|
42
|
+
export interface OutcomeContext {
|
|
43
|
+
req: Request;
|
|
44
|
+
method: string;
|
|
45
|
+
path: string;
|
|
46
|
+
responseHeaders?: Headers;
|
|
47
|
+
match?: RouteMatch;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Terminal outcome handler — converts a `PhaseOutcome` into a final
|
|
51
|
+
* `Response`, applying cookies, building redirects, rendering deny pages
|
|
52
|
+
* and fallback error pages, and firing instrumentation hooks.
|
|
53
|
+
*
|
|
54
|
+
* This is the single source of truth for how phase outputs become wire
|
|
55
|
+
* responses; the per-phase try/catch blocks now produce values, not
|
|
56
|
+
* Responses, so the conversion logic lives in exactly one place.
|
|
57
|
+
*/
|
|
58
|
+
export declare function outcomeToResponse(config: PipelineConfig, outcome: PhaseOutcome, ctx: OutcomeContext): Promise<Response>;
|
|
59
|
+
//# sourceMappingURL=pipeline-outcome.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pipeline-outcome.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAO7D,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAkFhE;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEpE,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAExD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,YAAY,CAI7E;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAID;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,QAAQ,CAAC,CA6HnB"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pipeline phase functions — module-level free functions that take their
|
|
3
|
+
* dependencies as explicit parameters. Each phase returns a `PhaseOutcome`
|
|
4
|
+
* (a discriminated union over response / redirect / deny / error) defined
|
|
5
|
+
* in `pipeline-outcome.ts`. The terminal `outcomeToResponse` (also in
|
|
6
|
+
* `pipeline-outcome.ts`) translates outcomes into Responses.
|
|
7
|
+
*
|
|
8
|
+
* Lifted out of `createPipeline` so each phase can be unit-tested in
|
|
9
|
+
* isolation. The lift is mechanical — these functions used to be closures
|
|
10
|
+
* over `config`; they now take `config` as an explicit parameter.
|
|
11
|
+
*
|
|
12
|
+
* See design/07-routing.md §"Request Lifecycle", design/02-rendering-pipeline.md §"Request Flow".
|
|
13
|
+
*/
|
|
14
|
+
import { type ProxyResolver } from './pipeline-helpers.ts';
|
|
15
|
+
import { type PhaseOutcome } from './pipeline-outcome.ts';
|
|
16
|
+
import type { InterceptionContext, PipelineConfig, RouteMatch } from './pipeline.ts';
|
|
17
|
+
interface RenderContext {
|
|
18
|
+
canonicalPathname: string;
|
|
19
|
+
interception?: InterceptionContext;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Run the proxy.ts phase. Calls user proxy code with a `next()` continuation.
|
|
23
|
+
*
|
|
24
|
+
* When `next` is provided, it replaces the default `handleRequest` as the
|
|
25
|
+
* continuation — this lets the pipeline inject action dispatch between proxy
|
|
26
|
+
* and route matching (TIM-1213). The proxy resolver was picked at pipeline
|
|
27
|
+
* construction time so the hot path sees no per-request branching on the
|
|
28
|
+
* `ProxyConfig` discriminant.
|
|
29
|
+
*/
|
|
30
|
+
export declare function runProxyPhase(config: PipelineConfig, getProxy: ProxyResolver, req: Request, method: string, path: string, next?: () => Promise<Response>): Promise<PhaseOutcome>;
|
|
31
|
+
/**
|
|
32
|
+
* Run the middleware chain phase. If the chain short-circuits with a Response,
|
|
33
|
+
* returns it as a 'response' outcome, and a thrown signal or error as its
|
|
34
|
+
* outcome. Otherwise applies the request header overlay and returns null: the
|
|
35
|
+
* request continues to the render phase.
|
|
36
|
+
*
|
|
37
|
+
* The chain is the URL's. On an intercepted navigation that is
|
|
38
|
+
* `match.canonical`'s, not the rendered route's: the URL's middleware
|
|
39
|
+
* followed by any only the rendered chain has, run with the URL's params
|
|
40
|
+
* (TIM-1607).
|
|
41
|
+
*/
|
|
42
|
+
export declare function runMiddlewarePhase(config: PipelineConfig, req: Request, match: RouteMatch, responseHeaders: Headers): Promise<PhaseOutcome | null>;
|
|
43
|
+
/**
|
|
44
|
+
* Run the render phase. Wraps the configured renderer in a span and a
|
|
45
|
+
* timing scope, and translates thrown signals into outcome variants.
|
|
46
|
+
*
|
|
47
|
+
* The render phase owns `responseHeaders` from here on, so it is the one
|
|
48
|
+
* place the cookie jar is applied to that bag (design/29-cookies.md
|
|
49
|
+
* §"Applied Exactly Once"). Doing it here rather than in the middleware
|
|
50
|
+
* phase means every render-phase outcome — a 200, or a deny / redirect /
|
|
51
|
+
* error thrown from render — carries the jar whether or not a middleware
|
|
52
|
+
* chain ran, and `outcomeToResponse` can skip render-phase outcomes
|
|
53
|
+
* unconditionally (TIM-1491). Application precedes `config.render` so
|
|
54
|
+
* middleware cookie writes are visible to route-handler header merging,
|
|
55
|
+
* while handler `Set-Cookie` values still come after them and take
|
|
56
|
+
* precedence.
|
|
57
|
+
*/
|
|
58
|
+
export declare function runRenderPhase(config: PipelineConfig, req: Request, match: RouteMatch, responseHeaders: Headers, { canonicalPathname, interception }: RenderContext): Promise<PhaseOutcome>;
|
|
59
|
+
/**
|
|
60
|
+
* Process a single request from canonicalization through phase dispatch.
|
|
61
|
+
*
|
|
62
|
+
* Stages: canonicalize → metadata routes → auto-sitemap → version skew →
|
|
63
|
+
* route match → interception → early hints → param coercion → middleware →
|
|
64
|
+
* render → outcome translation. Pre-routing short-circuits return Responses
|
|
65
|
+
* directly; post-match dispatch goes through `outcomeToResponse`.
|
|
66
|
+
*
|
|
67
|
+
* Used both as the top-level entry (when no proxy.ts is configured) and as
|
|
68
|
+
* the `next()` continuation passed to `runProxy()`.
|
|
69
|
+
*
|
|
70
|
+
* @param pathIsCanonical When true, `path` has already been canonicalized by
|
|
71
|
+
* `createPipeline` — skip re-canonicalization to prevent double-decode.
|
|
72
|
+
* When false (default), runs canonicalize as a safety net for direct callers.
|
|
73
|
+
*/
|
|
74
|
+
export declare function handleRequest(config: PipelineConfig, req: Request, method: string, path: string, pathIsCanonical?: boolean): Promise<Response>;
|
|
75
|
+
export {};
|
|
76
|
+
//# sourceMappingURL=pipeline-phases.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pipeline-phases.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwBH,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMrF,UAAU,aAAa;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAID;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAC7B,OAAO,CAAC,YAAY,CAAC,CAavB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,GACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAuD9B;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,EAAE,iBAAiB,EAAE,YAAY,EAAE,EAAE,aAAa,GACjD,OAAO,CAAC,YAAY,CAAC,CAYvB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,QAAQ,CAAC,CAsNnB"}
|
|
@@ -2,48 +2,118 @@
|
|
|
2
2
|
* Request pipeline — the central dispatch for all timber.js requests.
|
|
3
3
|
*
|
|
4
4
|
* Pipeline stages (in order):
|
|
5
|
-
* proxy.ts →
|
|
5
|
+
* canonicalize → CSRF gate → proxy.ts → route match → 103 Early Hints → middleware.ts → render
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
7
|
+
* The phase functions live in `pipeline-phases.ts` so each phase can be
|
|
8
|
+
* tested in isolation. The terminal `outcomeToResponse` translator and
|
|
9
|
+
* stateless helpers live in `pipeline-phases.ts` and `pipeline-helpers.ts`
|
|
10
|
+
* respectively. This file owns only the public type surface and the
|
|
11
|
+
* `createPipeline` entry point: trace ID setup, request-context ALS,
|
|
12
|
+
* Server-Timing wrapping, and the activeRequests counter.
|
|
9
13
|
*
|
|
10
14
|
* See design/07-routing.md §"Request Lifecycle", design/02-rendering-pipeline.md §"Request Flow",
|
|
11
15
|
* and design/17-logging.md §"Production Logging"
|
|
12
16
|
*/
|
|
13
|
-
import {
|
|
14
|
-
import {
|
|
15
|
-
import type {
|
|
16
|
-
|
|
17
|
+
import type { CoercedParams } from '../shared/param-value.ts';
|
|
18
|
+
import type { ProxyExport } from './proxy.ts';
|
|
19
|
+
import type { MiddlewareFn } from './middleware-runner.ts';
|
|
20
|
+
import { DenySignal } from './primitives.ts';
|
|
21
|
+
import type { ManifestSegmentNode } from './route-matcher.ts';
|
|
22
|
+
import type { CsrfConfig } from './csrf.ts';
|
|
23
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
24
|
+
import type { ActionErrorForRender } from './als-registry.ts';
|
|
25
|
+
/**
|
|
26
|
+
* Result of matching a canonical pathname against the route tree.
|
|
27
|
+
*
|
|
28
|
+
* `segments` is the runtime (`ManifestFile`-specialized) shape — the same
|
|
29
|
+
* nodes carried in the virtual route manifest. TIM-863 unified this: the
|
|
30
|
+
* matcher produces `ManifestSegmentNode[]` directly and every consumer
|
|
31
|
+
* (render, slots, params coercion, early hints, deny fallback) sees the
|
|
32
|
+
* same structural type with no `as unknown as` laundering.
|
|
33
|
+
*/
|
|
17
34
|
export interface RouteMatch {
|
|
18
35
|
/** The matched segment chain from root to leaf. */
|
|
19
|
-
segments:
|
|
20
|
-
/**
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
36
|
+
segments: ManifestSegmentNode[];
|
|
37
|
+
/**
|
|
38
|
+
* Segment params as the page sees them. The matcher sets them to the raw
|
|
39
|
+
* values; whoever runs `coerceSegmentParams()` replaces them with its
|
|
40
|
+
* result, whose values may be non-string (TIM-1347).
|
|
41
|
+
*/
|
|
42
|
+
segmentParams: CoercedParams;
|
|
43
|
+
/**
|
|
44
|
+
* Segment params as the URL carried them (catch-all segments produce
|
|
45
|
+
* string[]). Set by the matcher, which owns them, and never replaced.
|
|
46
|
+
* Slot resolution and URL-part reconstruction read these: coerced values
|
|
47
|
+
* need not round-trip to the URL (`"007"` → `7`).
|
|
48
|
+
*/
|
|
49
|
+
rawSegmentParams: Record<string, string | string[]>;
|
|
50
|
+
/** Middleware chain from the segment tree, ordered root-to-leaf. */
|
|
51
|
+
middlewareChain: MiddlewareFn[];
|
|
52
|
+
/**
|
|
53
|
+
* The URL's own route, with coerced params, when this match renders an
|
|
54
|
+
* interception of it (either shape). Set by the pipeline only.
|
|
55
|
+
*
|
|
56
|
+
* The rendered chain is a different route, and nothing on it was written
|
|
57
|
+
* to protect this URL. So the URL's `middleware.ts` chain runs before
|
|
58
|
+
* render, and its `access.ts` files render as gates in this tree — those
|
|
59
|
+
* of segments the two chains do not share, placed around the deepest
|
|
60
|
+
* shared segment's layout (TIM-1607, design/07-routing.md §"Intercepting
|
|
61
|
+
* Routes"). A match with `canonical` set never nests another.
|
|
62
|
+
*/
|
|
63
|
+
canonical?: RouteMatch;
|
|
24
64
|
}
|
|
25
65
|
/** Function that matches a canonical pathname to a route. */
|
|
26
66
|
export type RouteMatcher = (pathname: string) => RouteMatch | null;
|
|
27
67
|
/** Function that matches a canonical pathname to a metadata route. */
|
|
28
|
-
export type MetadataRouteMatcher = (pathname: string) => import('./route-matcher.
|
|
68
|
+
export type MetadataRouteMatcher = (pathname: string) => import('./route-matcher.ts').MetadataRouteMatch | null;
|
|
29
69
|
/** Context for intercepting route resolution (modal pattern). */
|
|
30
70
|
export interface InterceptionContext {
|
|
31
71
|
/** The URL the user is navigating TO (the intercepted route). */
|
|
32
72
|
targetPathname: string;
|
|
33
73
|
}
|
|
34
74
|
/** Function that renders a matched route into a Response. */
|
|
35
|
-
export type RouteRenderer = (req: Request, match: RouteMatch, responseHeaders: Headers,
|
|
75
|
+
export type RouteRenderer = (req: Request, match: RouteMatch, responseHeaders: Headers, interception?: InterceptionContext) => Response | Promise<Response>;
|
|
36
76
|
/** Function that sends 103 Early Hints for a matched route. */
|
|
37
77
|
export type EarlyHintsEmitter = (match: RouteMatch, req: Request, responseHeaders: Headers) => void | Promise<void>;
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
78
|
+
/**
|
|
79
|
+
* Proxy source — a tagged union so the choice between "already-resolved
|
|
80
|
+
* export" and "lazy HMR-friendly loader" is encoded in the type, not
|
|
81
|
+
* inferred per-request.
|
|
82
|
+
*
|
|
83
|
+
* - `static` — the proxy export is already resolved (production, tests).
|
|
84
|
+
* - `lazy` — a loader is called per-request for HMR freshness (dev).
|
|
85
|
+
*
|
|
86
|
+
* `PipelineConfig.proxy` also accepts a bare `ProxyExport` (a function or
|
|
87
|
+
* function array) as shorthand for the static variant — convenient for tests
|
|
88
|
+
* that construct a `createPipeline` config inline. Omit the field entirely
|
|
89
|
+
* when the app has no `proxy.ts`.
|
|
90
|
+
*
|
|
91
|
+
* See design/07-routing.md §"proxy.ts — Global Middleware".
|
|
92
|
+
*/
|
|
93
|
+
export type ProxyConfig = {
|
|
94
|
+
kind: 'static';
|
|
95
|
+
export: ProxyExport;
|
|
96
|
+
} | {
|
|
97
|
+
kind: 'lazy';
|
|
98
|
+
loader: () => Promise<{
|
|
43
99
|
default: ProxyExport;
|
|
44
100
|
}>;
|
|
101
|
+
};
|
|
102
|
+
export interface PipelineConfig {
|
|
103
|
+
/**
|
|
104
|
+
* proxy.ts source. Undefined if the app has no proxy.ts. Accepts either a
|
|
105
|
+
* tagged `ProxyConfig` (canonical) or a bare `ProxyExport` as sugar for the
|
|
106
|
+
* static variant.
|
|
107
|
+
*/
|
|
108
|
+
proxy?: ProxyConfig | ProxyExport;
|
|
45
109
|
/** Route matcher — resolves a canonical pathname to a RouteMatch. */
|
|
46
110
|
matchRoute: RouteMatcher;
|
|
111
|
+
/**
|
|
112
|
+
* CSRF configuration (`allowedOrigins`, the `csrf: false` switch). The
|
|
113
|
+
* gate is on when this is omitted — protection is never opt-in. See
|
|
114
|
+
* design/08-forms-and-actions.md §"CSRF Protection".
|
|
115
|
+
*/
|
|
116
|
+
csrf?: CsrfConfig;
|
|
47
117
|
/** Metadata route matcher — resolves metadata route pathnames (sitemap.xml, robots.txt, etc.) */
|
|
48
118
|
matchMetadataRoute?: MetadataRouteMatcher;
|
|
49
119
|
/** Renderer — produces the final Response for a matched route. */
|
|
@@ -56,12 +126,29 @@ export interface PipelineConfig {
|
|
|
56
126
|
stripTrailingSlash?: boolean;
|
|
57
127
|
/** Slow request threshold in ms. Requests exceeding this emit a warning. 0 to disable. Default: 3000. */
|
|
58
128
|
slowRequestMs?: number;
|
|
129
|
+
/**
|
|
130
|
+
* The resolved `renderTimeoutMs`: the deadline for reading a dynamic
|
|
131
|
+
* metadata route's Response body before it is answered. Defaults to
|
|
132
|
+
* `DEFAULT_RENDER_TIMEOUT_MS` for direct callers.
|
|
133
|
+
*/
|
|
134
|
+
renderTimeoutMs?: number;
|
|
59
135
|
/**
|
|
60
136
|
* Interception rewrites — conditional routes for the modal pattern.
|
|
61
137
|
* Generated at build time from intercepting route directories.
|
|
62
138
|
* See design/07-routing.md §"Intercepting Routes"
|
|
63
139
|
*/
|
|
64
|
-
interceptionRewrites?: import('
|
|
140
|
+
interceptionRewrites?: import('../routing/interception.ts').InterceptionRewrite[];
|
|
141
|
+
/**
|
|
142
|
+
* Resolver for children-path interceptions — the sibling layout swap.
|
|
143
|
+
*
|
|
144
|
+
* Separate from `matchRoute` because it addresses the owner directory by
|
|
145
|
+
* tree path rather than by pathname, which needs the manifest tree itself.
|
|
146
|
+
* Omitting it disables the `'children'` interception shape and leaves the
|
|
147
|
+
* canonical route rendering, which is the fail-safe outcome.
|
|
148
|
+
*
|
|
149
|
+
* See design/07-routing.md §"Intercepting Routes"
|
|
150
|
+
*/
|
|
151
|
+
matchInterceptedRoute?: import('./children-interception.ts').InterceptedRouteMatcher;
|
|
65
152
|
/**
|
|
66
153
|
* Control Server-Timing header output.
|
|
67
154
|
*
|
|
@@ -72,6 +159,22 @@ export interface PipelineConfig {
|
|
|
72
159
|
* Default: `'total'`.
|
|
73
160
|
*/
|
|
74
161
|
serverTiming?: 'detailed' | 'total' | false;
|
|
162
|
+
/**
|
|
163
|
+
* Add a `timber-trace;desc="<traceId>"` Server-Timing entry to every
|
|
164
|
+
* response, whatever `serverTiming` is, so the dev request pill can match
|
|
165
|
+
* the page and its fetches to their spans. Set by the dev RSC entry only:
|
|
166
|
+
* it must never be on in a production build, `TIMBER_DEBUG` included.
|
|
167
|
+
* See design/50-dev-request-pill.md §"Correlation".
|
|
168
|
+
*/
|
|
169
|
+
devTraceTiming?: boolean;
|
|
170
|
+
/**
|
|
171
|
+
* Auto-generated sitemap handler. When provided, the pipeline intercepts
|
|
172
|
+
* `/sitemap.xml` and `/sitemap/N.xml` requests and delegates to this
|
|
173
|
+
* function. Returns a Response or null (pass-through to regular routing).
|
|
174
|
+
*
|
|
175
|
+
* See design/16-metadata.md §"Auto-generated Sitemap"
|
|
176
|
+
*/
|
|
177
|
+
autoSitemapHandler?: (pathname: string) => Promise<Response | null>;
|
|
75
178
|
/**
|
|
76
179
|
* Dev pipeline error callback — called when a pipeline phase (proxy,
|
|
77
180
|
* middleware, render) catches an unhandled error. Used to wire the error
|
|
@@ -91,13 +194,77 @@ export interface PipelineConfig {
|
|
|
91
194
|
* If this function throws, the pipeline falls back to a bare
|
|
92
195
|
* `new Response(null, { status: 500 })`.
|
|
93
196
|
*/
|
|
94
|
-
renderFallbackError?: (error: unknown, req: Request, responseHeaders: Headers
|
|
197
|
+
renderFallbackError?: (error: unknown, req: Request, responseHeaders: Headers,
|
|
198
|
+
/**
|
|
199
|
+
* The matched route, when the error came after matching. A route.ts
|
|
200
|
+
* match is answered in the API route's JSON format, never a page
|
|
201
|
+
* (design/10-error-handling.md §"JSON Error Pages").
|
|
202
|
+
*/
|
|
203
|
+
match?: RouteMatch) => Response | Promise<Response>;
|
|
204
|
+
/**
|
|
205
|
+
* Fallback deny page renderer — called when a DenySignal escapes from
|
|
206
|
+
* middleware or the render phase. Renders the appropriate status-code
|
|
207
|
+
* page (403.tsx, 404.tsx, etc.) instead of returning a bare empty response.
|
|
208
|
+
*
|
|
209
|
+
* If this function throws, the pipeline falls back to a bare
|
|
210
|
+
* `new Response(null, { status: denyStatus })`.
|
|
211
|
+
*/
|
|
212
|
+
renderDenyFallback?: (deny: DenySignal, req: Request, responseHeaders: Headers,
|
|
213
|
+
/**
|
|
214
|
+
* The matched route, if available. Provided by both the middleware-stage
|
|
215
|
+
* and render-stage catch blocks (matching runs before middleware). When
|
|
216
|
+
* present, the renderer should resolve the deny status file against the
|
|
217
|
+
* matched chain so colocated `403.tsx`/`4xx.tsx`/`401.json` files are
|
|
218
|
+
* picked up. Falls back to the root-only chain when omitted (e.g. for
|
|
219
|
+
* deny()s thrown before route matching could complete). See TIM-822.
|
|
220
|
+
*/
|
|
221
|
+
match?: RouteMatch) => Response | Promise<Response>;
|
|
222
|
+
/**
|
|
223
|
+
* Server action dispatch — called after proxy.ts runs for POST requests
|
|
224
|
+
* that look like server actions. Returns a Response if the request was
|
|
225
|
+
* handled as an action, or null to fall through to normal routing.
|
|
226
|
+
*
|
|
227
|
+
* `canonicalPath` is the already-decoded canonical pathname — the same
|
|
228
|
+
* value that `handleRequest` and `matchRoute` use. Do NOT re-derive it
|
|
229
|
+
* from `req.url` (which re-encodes).
|
|
230
|
+
*
|
|
231
|
+
* The `reenter` parameter renders the page for a no-JS action that did
|
|
232
|
+
* not redirect. It enters the pipeline after proxy.ts: the synthetic GET
|
|
233
|
+
* is an internal render of the POST's answer, not a second wire request,
|
|
234
|
+
* so it keeps the POST's trace ID and is neither proxied nor logged again
|
|
235
|
+
* (TIM-1445). Route matching, middleware.ts and access.ts run as for any
|
|
236
|
+
* page render. It runs in its own request context: the GET, with the
|
|
237
|
+
* reentry's `cookies` as its parsed cookies and its `formState` or
|
|
238
|
+
* `actionError` for the render (`runWithRequestContext`'s options).
|
|
239
|
+
*
|
|
240
|
+
* Moved into the pipeline (TIM-1213) so proxy.ts runs on action POSTs,
|
|
241
|
+
* matching the design doc contract: "proxy.ts runs on every request,
|
|
242
|
+
* no exclusions." It runs once per wire request; the outer pass wraps
|
|
243
|
+
* the rerendered response.
|
|
244
|
+
*/
|
|
245
|
+
dispatchAction?: (req: Request, canonicalPath: string, reenter: (req: Request, reentry: PipelineReentry) => Promise<Response>) => Promise<Response | null>;
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* What the no-JS action rerender hands the pipeline when it re-enters it:
|
|
249
|
+
* the action's post-mutation cookies and, when its form used
|
|
250
|
+
* `useActionState`, the form state React decoded from the submission — or,
|
|
251
|
+
* when the action threw, the error to render in place of the page.
|
|
252
|
+
*/
|
|
253
|
+
export interface PipelineReentry {
|
|
254
|
+
cookies: Map<string, string>;
|
|
255
|
+
formState?: ReactFormState;
|
|
256
|
+
/** The error a no-JS action threw, rendered where the page would be. */
|
|
257
|
+
actionError?: ActionErrorForRender;
|
|
95
258
|
}
|
|
96
259
|
/**
|
|
97
260
|
* Create the request handler from a pipeline configuration.
|
|
98
261
|
*
|
|
99
|
-
* Returns a function that processes an incoming Request through all pipeline
|
|
100
|
-
* and produces a Response. This is the top-level entry point for the
|
|
262
|
+
* Returns a function that processes an incoming Request through all pipeline
|
|
263
|
+
* stages and produces a Response. This is the top-level entry point for the
|
|
264
|
+
* server. The body is intentionally small — phase logic lives in
|
|
265
|
+
* `pipeline-phases.ts`. This function only owns the per-request setup that
|
|
266
|
+
* has to wrap the entire dispatch: trace ID, request context ALS, span
|
|
267
|
+
* scope, Server-Timing header emission, and the active-request counter.
|
|
101
268
|
*/
|
|
102
269
|
export declare function createPipeline(config: PipelineConfig): (req: Request) => Promise<Response>;
|
|
103
270
|
//# sourceMappingURL=pipeline.d.ts.map
|