@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.231
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +8 -0
- package/agent-skill.md +389 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-CYjRMpZI.js +1273 -0
- package/dist/_chunks/actions-CYjRMpZI.js.map +1 -0
- package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
- package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
- package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
- package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
- package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
- package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
- package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
- package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
- package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
- package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
- package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
- package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
- package/dist/_chunks/chains-D-RRc7CM.js +266 -0
- package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
- package/dist/_chunks/chains-KblEfYzm.js +1 -0
- package/dist/_chunks/classify-_W0RWa5w.js +146 -0
- package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
- package/dist/_chunks/cli-check-BAKOSTkg.js +251 -0
- package/dist/_chunks/cli-check-BAKOSTkg.js.map +1 -0
- package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
- package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
- package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
- package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
- package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
- package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
- package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
- package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
- package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
- package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
- package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
- package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
- package/dist/_chunks/codec-registry-C8hOGmZo.js +13 -0
- package/dist/_chunks/codec-registry-C8hOGmZo.js.map +1 -0
- package/dist/_chunks/codegen-vaCyFyVN.js +479 -0
- package/dist/_chunks/codegen-vaCyFyVN.js.map +1 -0
- package/dist/_chunks/convention-lint-D54k6uUM.js +578 -0
- package/dist/_chunks/convention-lint-D54k6uUM.js.map +1 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
- package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
- package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
- package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
- package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
- package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
- package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
- package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
- package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
- package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
- package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
- package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
- package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
- package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
- package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
- package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
- package/dist/_chunks/format-DuPOoXUP.js +13 -0
- package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
- package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
- package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
- package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
- package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
- package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
- package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
- package/dist/_chunks/href-BtspoNc9.js +164 -0
- package/dist/_chunks/href-BtspoNc9.js.map +1 -0
- package/dist/_chunks/href-validation-DNg-zV7u.js +102 -0
- package/dist/_chunks/href-validation-DNg-zV7u.js.map +1 -0
- package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
- package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
- package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
- package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
- package/dist/_chunks/logger-YtMSKfft.js +755 -0
- package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
- package/dist/_chunks/merge-search-params-7o_5yX0L.js +111 -0
- package/dist/_chunks/merge-search-params-7o_5yX0L.js.map +1 -0
- package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
- package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
- package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
- package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
- package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
- package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
- package/dist/_chunks/param-value-DqlGfF57.js +65 -0
- package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
- package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
- package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
- package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
- package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
- package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
- package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
- package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
- package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
- package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
- package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
- package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
- package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
- package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
- package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
- package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
- package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
- package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
- package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
- package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
- package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
- package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
- package/dist/_chunks/scan-CyizcBiX.js +139 -0
- package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
- package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
- package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
- package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
- package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
- package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
- package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
- package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
- package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
- package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
- package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
- package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
- package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
- package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
- package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
- package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
- package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
- package/dist/_chunks/state-B-EBjeER.js +49 -0
- package/dist/_chunks/state-B-EBjeER.js.map +1 -0
- package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
- package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
- package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
- package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
- package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
- package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
- package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
- package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
- package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
- package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
- package/dist/adapters/build-output-helper.d.ts +81 -0
- package/dist/adapters/build-output-helper.d.ts.map +1 -0
- package/dist/adapters/canonicalize-module.d.ts +8 -0
- package/dist/adapters/canonicalize-module.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.d.ts +109 -0
- package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.js +73 -0
- package/dist/adapters/cloudflare-dev.js.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.js +122 -0
- package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
- package/dist/adapters/cloudflare.d.ts +217 -24
- package/dist/adapters/cloudflare.d.ts.map +1 -1
- package/dist/adapters/cloudflare.js +1 -188
- package/dist/adapters/compress-module.d.ts +25 -4
- package/dist/adapters/compress-module.d.ts.map +1 -1
- package/dist/adapters/fs-identity.d.ts +63 -0
- package/dist/adapters/fs-identity.d.ts.map +1 -0
- package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
- package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
- package/dist/adapters/nitro-presets.d.ts +37 -0
- package/dist/adapters/nitro-presets.d.ts.map +1 -0
- package/dist/adapters/nitro-preview.d.ts +65 -0
- package/dist/adapters/nitro-preview.d.ts.map +1 -0
- package/dist/adapters/nitro.d.ts +69 -38
- package/dist/adapters/nitro.d.ts.map +1 -1
- package/dist/adapters/nitro.js +837 -347
- package/dist/adapters/nitro.js.map +1 -1
- package/dist/adapters/shared.d.ts +85 -0
- package/dist/adapters/shared.d.ts.map +1 -0
- package/dist/adapters/types.d.ts +124 -16
- package/dist/adapters/types.d.ts.map +1 -1
- package/dist/adapters/types.js +0 -0
- package/dist/analyze/chains.d.ts +124 -0
- package/dist/analyze/chains.d.ts.map +1 -0
- package/dist/analyze/classify.d.ts +153 -0
- package/dist/analyze/classify.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.d.ts +17 -0
- package/dist/analyze/crawl-entry.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.js +312 -0
- package/dist/analyze/crawl-entry.js.map +1 -0
- package/dist/analyze/crawl.d.ts +134 -0
- package/dist/analyze/crawl.d.ts.map +1 -0
- package/dist/analyze/graph-cache.d.ts +104 -0
- package/dist/analyze/graph-cache.d.ts.map +1 -0
- package/dist/analyze/graph-command.d.ts +43 -0
- package/dist/analyze/graph-command.d.ts.map +1 -0
- package/dist/analyze/graph-command.js +386 -0
- package/dist/analyze/graph-command.js.map +1 -0
- package/dist/analyze/live-graph.d.ts +81 -0
- package/dist/analyze/live-graph.d.ts.map +1 -0
- package/dist/analyze/poison-rules.d.ts +72 -0
- package/dist/analyze/poison-rules.d.ts.map +1 -0
- package/dist/analyze/poison-scan.d.ts +48 -0
- package/dist/analyze/poison-scan.d.ts.map +1 -0
- package/dist/analyze/scan.d.ts +73 -0
- package/dist/analyze/scan.d.ts.map +1 -0
- package/dist/cache/cache-api.d.ts +48 -0
- package/dist/cache/cache-api.d.ts.map +1 -0
- package/dist/cache/fast-hash.d.ts +5 -0
- package/dist/cache/fast-hash.d.ts.map +1 -1
- package/dist/cache/guarded-read.d.ts +29 -0
- package/dist/cache/guarded-read.d.ts.map +1 -0
- package/dist/cache/handler-store.d.ts +45 -0
- package/dist/cache/handler-store.d.ts.map +1 -0
- package/dist/cache/index.d.ts +32 -9
- package/dist/cache/index.d.ts.map +1 -1
- package/dist/cache/index.js +4 -326
- package/dist/cache/invalidation-epoch.d.ts +50 -0
- package/dist/cache/invalidation-epoch.d.ts.map +1 -0
- package/dist/cache/json-lossy-check.d.ts +11 -0
- package/dist/cache/json-lossy-check.d.ts.map +1 -0
- package/dist/cache/key-discipline.d.ts +61 -0
- package/dist/cache/key-discipline.d.ts.map +1 -0
- package/dist/cache/redis-handler.d.ts +140 -9
- package/dist/cache/redis-handler.d.ts.map +1 -1
- package/dist/cache/singleflight.d.ts +31 -2
- package/dist/cache/singleflight.d.ts.map +1 -1
- package/dist/cache/sizeof.d.ts +22 -0
- package/dist/cache/sizeof.d.ts.map +1 -0
- package/dist/cache/stable-stringify.d.ts +15 -0
- package/dist/cache/stable-stringify.d.ts.map +1 -1
- package/dist/cache/store.d.ts +53 -0
- package/dist/cache/store.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
- package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.js +28 -0
- package/dist/cache/stores/cloudflare-kv.js.map +1 -0
- package/dist/cache/stores/memory.d.ts +42 -0
- package/dist/cache/stores/memory.d.ts.map +1 -0
- package/dist/cache/stores/memory.js +89 -0
- package/dist/cache/stores/memory.js.map +1 -0
- package/dist/cache/stores/redis.d.ts +69 -0
- package/dist/cache/stores/redis.d.ts.map +1 -0
- package/dist/cache/stores/redis.js +34 -0
- package/dist/cache/stores/redis.js.map +1 -0
- package/dist/cache/stores/vercel.d.ts +36 -0
- package/dist/cache/stores/vercel.d.ts.map +1 -0
- package/dist/cache/stores/vercel.js +32 -0
- package/dist/cache/stores/vercel.js.map +1 -0
- package/dist/cache/tag-aware-handler.d.ts +51 -0
- package/dist/cache/tag-aware-handler.d.ts.map +1 -0
- package/dist/cache/timber-cache.d.ts +25 -11
- package/dist/cache/timber-cache.d.ts.map +1 -1
- package/dist/cdn/cloudflare-purge.d.ts +23 -0
- package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
- package/dist/cdn/cloudflare-purge.js +29 -0
- package/dist/cdn/cloudflare-purge.js.map +1 -0
- package/dist/cdn/fastly-purge.d.ts +25 -0
- package/dist/cdn/fastly-purge.d.ts.map +1 -0
- package/dist/cdn/fastly-purge.js +32 -0
- package/dist/cdn/fastly-purge.js.map +1 -0
- package/dist/cdn/headers.d.ts +97 -0
- package/dist/cdn/headers.d.ts.map +1 -0
- package/dist/cdn/index.d.ts +5 -0
- package/dist/cdn/index.d.ts.map +1 -0
- package/dist/cdn/index.js +93 -0
- package/dist/cdn/index.js.map +1 -0
- package/dist/cdn/purge-store.d.ts +32 -0
- package/dist/cdn/purge-store.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.d.ts +20 -0
- package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.js +33 -0
- package/dist/cdn/workers-cache-purge.js.map +1 -0
- package/dist/cli-check.d.ts +133 -0
- package/dist/cli-check.d.ts.map +1 -0
- package/dist/cli-context.d.ts +62 -0
- package/dist/cli-context.d.ts.map +1 -0
- package/dist/cli-dev-status.d.ts +75 -0
- package/dist/cli-dev-status.d.ts.map +1 -0
- package/dist/cli-init.d.ts +72 -0
- package/dist/cli-init.d.ts.map +1 -0
- package/dist/cli-schema-sync.d.ts +59 -0
- package/dist/cli-schema-sync.d.ts.map +1 -0
- package/dist/cli.d.ts +80 -16
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +210 -69
- package/dist/cli.js.map +1 -1
- package/dist/client/browser-dev.d.ts +42 -2
- package/dist/client/browser-dev.d.ts.map +1 -1
- package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
- package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
- package/dist/client/browser-entry/action-queue.d.ts +64 -0
- package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
- package/dist/client/browser-entry/form-state.d.ts +22 -0
- package/dist/client/browser-entry/form-state.d.ts.map +1 -0
- package/dist/client/browser-entry/hmr.d.ts +27 -0
- package/dist/client/browser-entry/hmr.d.ts.map +1 -0
- package/dist/client/browser-entry/hydrate.d.ts +61 -0
- package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
- package/dist/client/browser-entry/index.d.ts +32 -0
- package/dist/client/browser-entry/index.d.ts.map +1 -0
- package/dist/client/browser-entry/post-hydration.d.ts +26 -0
- package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
- package/dist/client/browser-entry/router-init.d.ts +41 -0
- package/dist/client/browser-entry/router-init.d.ts.map +1 -0
- package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
- package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
- package/dist/client/browser-entry/scroll.d.ts +28 -0
- package/dist/client/browser-entry/scroll.d.ts.map +1 -0
- package/dist/client/deny-last-resort.d.ts +29 -0
- package/dist/client/deny-last-resort.d.ts.map +1 -0
- package/dist/client/dev-pill/index.d.ts +32 -0
- package/dist/client/dev-pill/index.d.ts.map +1 -0
- package/dist/client/dev-pill/store.d.ts +105 -0
- package/dist/client/dev-pill/store.d.ts.map +1 -0
- package/dist/client/dev-pill/view.d.ts +9 -0
- package/dist/client/dev-pill/view.d.ts.map +1 -0
- package/dist/client/error-boundary.d.ts +58 -9
- package/dist/client/error-boundary.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -126
- package/dist/client/error-reconstituter.d.ts +55 -0
- package/dist/client/error-reconstituter.d.ts.map +1 -0
- package/dist/client/form.d.ts +38 -99
- package/dist/client/form.d.ts.map +1 -1
- package/dist/client/global-context.d.ts +35 -0
- package/dist/client/global-context.d.ts.map +1 -0
- package/dist/client/history.d.ts +50 -9
- package/dist/client/history.d.ts.map +1 -1
- package/dist/client/index.d.ts +23 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +330 -1273
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.d.ts +20 -0
- package/dist/client/internal.d.ts.map +1 -0
- package/dist/client/internal.js +785 -0
- package/dist/client/internal.js.map +1 -0
- package/dist/client/link.d.ts +75 -71
- package/dist/client/link.d.ts.map +1 -1
- package/dist/client/location-search.d.ts +12 -0
- package/dist/client/location-search.d.ts.map +1 -0
- package/dist/client/navigation-api.d.ts +95 -0
- package/dist/client/navigation-api.d.ts.map +1 -0
- package/dist/client/navigation-commit.d.ts +111 -0
- package/dist/client/navigation-commit.d.ts.map +1 -0
- package/dist/client/navigation-context.d.ts +75 -37
- package/dist/client/navigation-context.d.ts.map +1 -1
- package/dist/client/navigation-root.d.ts +106 -0
- package/dist/client/navigation-root.d.ts.map +1 -0
- package/dist/client/navigation-transition.d.ts +255 -0
- package/dist/client/navigation-transition.d.ts.map +1 -0
- package/dist/client/nuqs-adapter.d.ts +5 -2
- package/dist/client/nuqs-adapter.d.ts.map +1 -1
- package/dist/client/params-context.d.ts +81 -0
- package/dist/client/params-context.d.ts.map +1 -0
- package/dist/client/react-root.d.ts +51 -0
- package/dist/client/react-root.d.ts.map +1 -0
- package/dist/client/router-effects.d.ts +203 -0
- package/dist/client/router-effects.d.ts.map +1 -0
- package/dist/client/router-lifecycle.d.ts +107 -0
- package/dist/client/router-lifecycle.d.ts.map +1 -0
- package/dist/client/router-pipeline.d.ts +81 -0
- package/dist/client/router-pipeline.d.ts.map +1 -0
- package/dist/client/router-ref.d.ts +2 -2
- package/dist/client/router-ref.d.ts.map +1 -1
- package/dist/client/router-skew.d.ts +21 -0
- package/dist/client/router-skew.d.ts.map +1 -0
- package/dist/client/router-types.d.ts +294 -0
- package/dist/client/router-types.d.ts.map +1 -0
- package/dist/client/router-url.d.ts +24 -0
- package/dist/client/router-url.d.ts.map +1 -0
- package/dist/client/router.d.ts +1 -97
- package/dist/client/router.d.ts.map +1 -1
- package/dist/client/rsc-fetch.d.ts +110 -28
- package/dist/client/rsc-fetch.d.ts.map +1 -1
- package/dist/client/segment-cache.d.ts +186 -25
- package/dist/client/segment-cache.d.ts.map +1 -1
- package/dist/client/segment-context.d.ts.map +1 -1
- package/dist/client/segment-outlet.d.ts +68 -0
- package/dist/client/segment-outlet.d.ts.map +1 -0
- package/dist/client/segment-update-context.d.ts +15 -0
- package/dist/client/segment-update-context.d.ts.map +1 -0
- package/dist/client/shallow-url.d.ts +10 -0
- package/dist/client/shallow-url.d.ts.map +1 -0
- package/dist/client/slot-content-cache-context.d.ts +35 -0
- package/dist/client/slot-content-cache-context.d.ts.map +1 -0
- package/dist/client/slot-context.d.ts +31 -0
- package/dist/client/slot-context.d.ts.map +1 -0
- package/dist/client/slot-outlet.d.ts +16 -0
- package/dist/client/slot-outlet.d.ts.map +1 -0
- package/dist/client/slot-provider.d.ts +25 -0
- package/dist/client/slot-provider.d.ts.map +1 -0
- package/dist/client/ssr-data.d.ts +26 -50
- package/dist/client/ssr-data.d.ts.map +1 -1
- package/dist/client/stale-client.d.ts +69 -0
- package/dist/client/stale-client.d.ts.map +1 -0
- package/dist/client/state.d.ts +21 -13
- package/dist/client/state.d.ts.map +1 -1
- package/dist/client/status-page-marker.d.ts +25 -0
- package/dist/client/status-page-marker.d.ts.map +1 -0
- package/dist/client/top-loader.d.ts +7 -6
- package/dist/client/top-loader.d.ts.map +1 -1
- package/dist/client/unload-guard.d.ts +5 -0
- package/dist/client/unload-guard.d.ts.map +1 -1
- package/dist/client/use-cookie.d.ts +25 -0
- package/dist/client/use-cookie.d.ts.map +1 -1
- package/dist/client/use-field-state.d.ts +42 -0
- package/dist/client/use-field-state.d.ts.map +1 -0
- package/dist/client/use-link-status.d.ts +5 -5
- package/dist/client/use-link-status.d.ts.map +1 -1
- package/dist/client/use-pathname.d.ts +13 -11
- package/dist/client/use-pathname.d.ts.map +1 -1
- package/dist/client/use-pending-navigation.d.ts +47 -0
- package/dist/client/use-pending-navigation.d.ts.map +1 -0
- package/dist/client/use-query-states.d.ts +10 -4
- package/dist/client/use-query-states.d.ts.map +1 -1
- package/dist/client/use-router.d.ts +15 -8
- package/dist/client/use-router.d.ts.map +1 -1
- package/dist/client/use-search-params.d.ts +15 -8
- package/dist/client/use-search-params.d.ts.map +1 -1
- package/dist/client/use-segment-params.d.ts +55 -0
- package/dist/client/use-segment-params.d.ts.map +1 -0
- package/dist/codec.d.ts +69 -0
- package/dist/codec.d.ts.map +1 -0
- package/dist/codec.js +75 -0
- package/dist/codec.js.map +1 -0
- package/dist/config-types.d.ts +366 -0
- package/dist/config-types.d.ts.map +1 -0
- package/dist/config-validation.d.ts +68 -0
- package/dist/config-validation.d.ts.map +1 -0
- package/dist/cookies/define-cookie.d.ts +58 -25
- package/dist/cookies/define-cookie.d.ts.map +1 -1
- package/dist/cookies/index.d.ts +3 -2
- package/dist/cookies/index.d.ts.map +1 -1
- package/dist/cookies/index.js +230 -37
- package/dist/cookies/index.js.map +1 -1
- package/dist/cookies/json-cookie.d.ts +64 -0
- package/dist/cookies/json-cookie.d.ts.map +1 -0
- package/dist/cookies/validation.d.ts +34 -0
- package/dist/cookies/validation.d.ts.map +1 -0
- package/dist/dev-tools/404-page.d.ts +50 -0
- package/dist/dev-tools/404-page.d.ts.map +1 -0
- package/dist/dev-tools/await-span.d.ts +17 -0
- package/dist/dev-tools/await-span.d.ts.map +1 -0
- package/dist/dev-tools/browser-logs.d.ts +40 -0
- package/dist/dev-tools/browser-logs.d.ts.map +1 -0
- package/dist/dev-tools/dev-page-shell.d.ts +95 -0
- package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
- package/dist/dev-tools/error-page.d.ts +32 -0
- package/dist/dev-tools/error-page.d.ts.map +1 -0
- package/dist/dev-tools/holding-server.d.ts +46 -0
- package/dist/dev-tools/holding-server.d.ts.map +1 -0
- package/dist/dev-tools/hydration-overlay.d.ts +11 -0
- package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
- package/dist/dev-tools/index.d.ts +31 -0
- package/dist/dev-tools/index.d.ts.map +1 -0
- package/dist/dev-tools/instrumentation.d.ts +74 -0
- package/dist/dev-tools/instrumentation.d.ts.map +1 -0
- package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
- package/dist/dev-tools/logger.d.ts.map +1 -0
- package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
- package/dist/dev-tools/logs.d.ts.map +1 -0
- package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
- package/dist/dev-tools/overlay.d.ts.map +1 -0
- package/dist/dev-tools/span-sink.d.ts +42 -0
- package/dist/dev-tools/span-sink.d.ts.map +1 -0
- package/dist/dev-tools/stack-classifier.d.ts +34 -0
- package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
- package/dist/dev-tools/terminal.d.ts +28 -0
- package/dist/dev-tools/terminal.d.ts.map +1 -0
- package/dist/fonts/ast-walk.d.ts +68 -0
- package/dist/fonts/ast-walk.d.ts.map +1 -0
- package/dist/fonts/ast.d.ts +112 -8
- package/dist/fonts/ast.d.ts.map +1 -1
- package/dist/fonts/bundle.d.ts +50 -0
- package/dist/fonts/bundle.d.ts.map +1 -0
- package/dist/fonts/css.d.ts +1 -1
- package/dist/fonts/dev-middleware.d.ts +22 -0
- package/dist/fonts/dev-middleware.d.ts.map +1 -0
- package/dist/fonts/fallbacks.d.ts +0 -7
- package/dist/fonts/fallbacks.d.ts.map +1 -1
- package/dist/fonts/google.d.ts +5 -3
- package/dist/fonts/google.d.ts.map +1 -1
- package/dist/fonts/local.d.ts +5 -5
- package/dist/fonts/local.d.ts.map +1 -1
- package/dist/fonts/paths.d.ts +43 -0
- package/dist/fonts/paths.d.ts.map +1 -0
- package/dist/fonts/pipeline.d.ts +177 -0
- package/dist/fonts/pipeline.d.ts.map +1 -0
- package/dist/fonts/transform.d.ts +82 -0
- package/dist/fonts/transform.d.ts.map +1 -0
- package/dist/fonts/types.d.ts +47 -1
- package/dist/fonts/types.d.ts.map +1 -1
- package/dist/fonts/virtual-modules.d.ts +77 -0
- package/dist/fonts/virtual-modules.d.ts.map +1 -0
- package/dist/index.d.ts +37 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9952 -14264
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +36 -0
- package/dist/params/codec-registry.d.ts.map +1 -0
- package/dist/params/define-schema.d.ts +81 -0
- package/dist/params/define-schema.d.ts.map +1 -0
- package/dist/params/index.d.ts +4 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +32 -0
- package/dist/params/index.js.map +1 -0
- package/dist/params/resolve-schema.d.ts +34 -0
- package/dist/params/resolve-schema.d.ts.map +1 -0
- package/dist/plugin-context.d.ts +269 -0
- package/dist/plugin-context.d.ts.map +1 -0
- package/dist/plugins/build-manifest.d.ts +7 -3
- package/dist/plugins/build-manifest.d.ts.map +1 -1
- package/dist/plugins/build-report.d.ts +61 -11
- package/dist/plugins/build-report.d.ts.map +1 -1
- package/dist/plugins/cache.d.ts +64 -0
- package/dist/plugins/cache.d.ts.map +1 -0
- package/dist/plugins/callsite-ast.d.ts +117 -0
- package/dist/plugins/callsite-ast.d.ts.map +1 -0
- package/dist/plugins/callsite-jsx.d.ts +35 -0
- package/dist/plugins/callsite-jsx.d.ts.map +1 -0
- package/dist/plugins/chunks.d.ts +11 -4
- package/dist/plugins/chunks.d.ts.map +1 -1
- package/dist/plugins/client-chunks.d.ts +40 -0
- package/dist/plugins/client-chunks.d.ts.map +1 -0
- package/dist/plugins/client-dep-entries.d.ts +80 -0
- package/dist/plugins/client-dep-entries.d.ts.map +1 -0
- package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
- package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
- package/dist/plugins/cloudflare-wasm.d.ts +21 -0
- package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
- package/dist/plugins/content.d.ts +1 -1
- package/dist/plugins/content.d.ts.map +1 -1
- package/dist/plugins/dev-await.d.ts +81 -0
- package/dist/plugins/dev-await.d.ts.map +1 -0
- package/dist/plugins/dev-discovery.d.ts +187 -0
- package/dist/plugins/dev-discovery.d.ts.map +1 -0
- package/dist/plugins/dev-hostname.d.ts +152 -0
- package/dist/plugins/dev-hostname.d.ts.map +1 -0
- package/dist/plugins/dev-server.d.ts +29 -2
- package/dist/plugins/dev-server.d.ts.map +1 -1
- package/dist/plugins/dev-store-clear.d.ts +83 -0
- package/dist/plugins/dev-store-clear.d.ts.map +1 -0
- package/dist/plugins/encryption-runtime.d.ts +13 -0
- package/dist/plugins/encryption-runtime.d.ts.map +1 -0
- package/dist/plugins/entries.d.ts +40 -4
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/plugins/fonts.d.ts +35 -74
- package/dist/plugins/fonts.d.ts.map +1 -1
- package/dist/plugins/graph-endpoint.d.ts +114 -0
- package/dist/plugins/graph-endpoint.d.ts.map +1 -0
- package/dist/plugins/mdx.d.ts +18 -5
- package/dist/plugins/mdx.d.ts.map +1 -1
- package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
- package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
- package/dist/plugins/optimize-package-imports.d.ts +124 -0
- package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
- package/dist/plugins/orphaned-modules.d.ts +57 -0
- package/dist/plugins/orphaned-modules.d.ts.map +1 -0
- package/dist/plugins/post-build.d.ts +110 -0
- package/dist/plugins/post-build.d.ts.map +1 -0
- package/dist/plugins/prebuilt-capture.d.ts +67 -0
- package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
- package/dist/plugins/prebuilt.d.ts +98 -0
- package/dist/plugins/prebuilt.d.ts.map +1 -0
- package/dist/plugins/prerender-sugar.d.ts +39 -0
- package/dist/plugins/prerender-sugar.d.ts.map +1 -0
- package/dist/plugins/react-resolve.d.ts +49 -0
- package/dist/plugins/react-resolve.d.ts.map +1 -0
- package/dist/plugins/request-dep/analysis.d.ts +106 -0
- package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
- package/dist/plugins/request-dep/index.d.ts +75 -0
- package/dist/plugins/request-dep/index.d.ts.map +1 -0
- package/dist/plugins/request-dep/origin.d.ts +61 -0
- package/dist/plugins/request-dep/origin.d.ts.map +1 -0
- package/dist/plugins/routing.d.ts +2 -2
- package/dist/plugins/routing.d.ts.map +1 -1
- package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
- package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
- package/dist/plugins/server-bundle.d.ts +1 -1
- package/dist/plugins/server-bundle.d.ts.map +1 -1
- package/dist/plugins/shims.d.ts +29 -5
- package/dist/plugins/shims.d.ts.map +1 -1
- package/dist/plugins/static-build.d.ts +246 -26
- package/dist/plugins/static-build.d.ts.map +1 -1
- package/dist/routes/href.d.ts +124 -0
- package/dist/routes/href.d.ts.map +1 -0
- package/dist/routes/index.d.ts +4 -0
- package/dist/routes/index.d.ts.map +1 -0
- package/dist/routes/index.js +8 -0
- package/dist/routes/index.js.map +1 -0
- package/dist/routing/codegen-shared.d.ts +26 -0
- package/dist/routing/codegen-shared.d.ts.map +1 -0
- package/dist/routing/codegen-types.d.ts +61 -0
- package/dist/routing/codegen-types.d.ts.map +1 -0
- package/dist/routing/codegen-write.d.ts +42 -0
- package/dist/routing/codegen-write.d.ts.map +1 -0
- package/dist/routing/codegen.d.ts +8 -3
- package/dist/routing/codegen.d.ts.map +1 -1
- package/dist/routing/collision-probe.d.ts +104 -0
- package/dist/routing/collision-probe.d.ts.map +1 -0
- package/dist/routing/collision-spaces.d.ts +26 -0
- package/dist/routing/collision-spaces.d.ts.map +1 -0
- package/dist/routing/convention-lint.d.ts +55 -0
- package/dist/routing/convention-lint.d.ts.map +1 -0
- package/dist/routing/export-detect.d.ts +91 -0
- package/dist/routing/export-detect.d.ts.map +1 -0
- package/dist/routing/file-cache.d.ts +8 -0
- package/dist/routing/file-cache.d.ts.map +1 -0
- package/dist/routing/index.d.ts +13 -7
- package/dist/routing/index.d.ts.map +1 -1
- package/dist/routing/index.js +5 -2
- package/dist/routing/interception-overlap.d.ts +35 -0
- package/dist/routing/interception-overlap.d.ts.map +1 -0
- package/dist/routing/interception.d.ts +234 -10
- package/dist/routing/interception.d.ts.map +1 -1
- package/dist/routing/link-codegen.d.ts +136 -0
- package/dist/routing/link-codegen.d.ts.map +1 -0
- package/dist/routing/manifest-codegen.d.ts +26 -0
- package/dist/routing/manifest-codegen.d.ts.map +1 -0
- package/dist/routing/scanner.d.ts +14 -10
- package/dist/routing/scanner.d.ts.map +1 -1
- package/dist/routing/schema-validation.d.ts +35 -0
- package/dist/routing/schema-validation.d.ts.map +1 -0
- package/dist/routing/segment-classify.d.ts +114 -0
- package/dist/routing/segment-classify.d.ts.map +1 -0
- package/dist/routing/segment-codegen.d.ts +38 -0
- package/dist/routing/segment-codegen.d.ts.map +1 -0
- package/dist/routing/segment-keys.d.ts +118 -0
- package/dist/routing/segment-keys.d.ts.map +1 -0
- package/dist/routing/slot-placement.d.ts +48 -0
- package/dist/routing/slot-placement.d.ts.map +1 -0
- package/dist/routing/types.d.ts +81 -26
- package/dist/routing/types.d.ts.map +1 -1
- package/dist/routing/walkers.d.ts +57 -0
- package/dist/routing/walkers.d.ts.map +1 -0
- package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
- package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
- package/dist/rsc-runtime/render-flight.d.ts +14 -0
- package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
- package/dist/rsc-runtime/rsc.d.ts +3 -13
- package/dist/rsc-runtime/rsc.d.ts.map +1 -1
- package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
- package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
- package/dist/rsc-runtime/server-references.d.ts +19 -0
- package/dist/rsc-runtime/server-references.d.ts.map +1 -0
- package/dist/rsc-runtime/ssr.d.ts +7 -10
- package/dist/rsc-runtime/ssr.d.ts.map +1 -1
- package/dist/rsc-runtime/transforms.d.ts +13 -0
- package/dist/rsc-runtime/transforms.d.ts.map +1 -0
- package/dist/schema-bridge.d.ts +154 -0
- package/dist/schema-bridge.d.ts.map +1 -0
- package/dist/search-params/define.d.ts +262 -0
- package/dist/search-params/define.d.ts.map +1 -0
- package/dist/search-params/index.d.ts +3 -7
- package/dist/search-params/index.d.ts.map +1 -1
- package/dist/search-params/index.js +178 -362
- package/dist/search-params/index.js.map +1 -1
- package/dist/search-params/parse-total.d.ts +81 -0
- package/dist/search-params/parse-total.d.ts.map +1 -0
- package/dist/search-params/serialize-equal.d.ts +9 -0
- package/dist/search-params/serialize-equal.d.ts.map +1 -0
- package/dist/search-params/wrappers.d.ts +76 -0
- package/dist/search-params/wrappers.d.ts.map +1 -0
- package/dist/server/abort-scope.d.ts +27 -0
- package/dist/server/abort-scope.d.ts.map +1 -0
- package/dist/server/access-gate.d.ts +110 -10
- package/dist/server/access-gate.d.ts.map +1 -1
- package/dist/server/action-client.d.ts +20 -133
- package/dist/server/action-client.d.ts.map +1 -1
- package/dist/server/action-encryption.d.ts +76 -0
- package/dist/server/action-encryption.d.ts.map +1 -0
- package/dist/server/action-handler.d.ts +60 -11
- package/dist/server/action-handler.d.ts.map +1 -1
- package/dist/server/action-schema.d.ts +126 -0
- package/dist/server/action-schema.d.ts.map +1 -0
- package/dist/server/action-types.d.ts +108 -0
- package/dist/server/action-types.d.ts.map +1 -0
- package/dist/server/actions.d.ts +78 -40
- package/dist/server/actions.d.ts.map +1 -1
- package/dist/server/als-registry.d.ts +189 -17
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/body-limits.d.ts.map +1 -1
- package/dist/server/build-manifest.d.ts +25 -30
- package/dist/server/build-manifest.d.ts.map +1 -1
- package/dist/server/canonicalize.d.ts +53 -0
- package/dist/server/canonicalize.d.ts.map +1 -1
- package/dist/server/chain-url-parts.d.ts +82 -0
- package/dist/server/chain-url-parts.d.ts.map +1 -0
- package/dist/server/children-interception.d.ts +49 -0
- package/dist/server/children-interception.d.ts.map +1 -0
- package/dist/server/client-error-message.d.ts +12 -0
- package/dist/server/client-error-message.d.ts.map +1 -0
- package/dist/server/coalesce-tick.d.ts +40 -0
- package/dist/server/coalesce-tick.d.ts.map +1 -0
- package/dist/server/compress.d.ts +2 -0
- package/dist/server/compress.d.ts.map +1 -1
- package/dist/server/cookie-context.d.ts +156 -0
- package/dist/server/cookie-context.d.ts.map +1 -0
- package/dist/server/cookie-parsing.d.ts +65 -0
- package/dist/server/cookie-parsing.d.ts.map +1 -0
- package/dist/server/csp-nonce.d.ts +36 -0
- package/dist/server/csp-nonce.d.ts.map +1 -0
- package/dist/server/csrf.d.ts +58 -15
- package/dist/server/csrf.d.ts.map +1 -1
- package/dist/server/debug.d.ts +0 -1
- package/dist/server/debug.d.ts.map +1 -1
- package/dist/server/default-logger.d.ts +23 -0
- package/dist/server/default-logger.d.ts.map +1 -0
- package/dist/server/default-status-page.d.ts +45 -0
- package/dist/server/default-status-page.d.ts.map +1 -0
- package/dist/server/deny-boundary.d.ts +257 -0
- package/dist/server/deny-boundary.d.ts.map +1 -0
- package/dist/server/deny-renderer.d.ts +22 -15
- package/dist/server/deny-renderer.d.ts.map +1 -1
- package/dist/server/early-hints-sender.d.ts.map +1 -1
- package/dist/server/early-hints.d.ts +14 -12
- package/dist/server/early-hints.d.ts.map +1 -1
- package/dist/server/error-boundary-wrapper.d.ts +102 -10
- package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
- package/dist/server/error-response-headers.d.ts +3 -0
- package/dist/server/error-response-headers.d.ts.map +1 -0
- package/dist/server/fallback-error.d.ts +19 -7
- package/dist/server/fallback-error.d.ts.map +1 -1
- package/dist/server/flight-injection-state.d.ts +66 -0
- package/dist/server/flight-injection-state.d.ts.map +1 -0
- package/dist/server/flight-injector-core.d.ts +125 -0
- package/dist/server/flight-injector-core.d.ts.map +1 -0
- package/dist/server/flight-scripts.d.ts +63 -0
- package/dist/server/flight-scripts.d.ts.map +1 -0
- package/dist/server/flight-source-node.d.ts +105 -0
- package/dist/server/flight-source-node.d.ts.map +1 -0
- package/dist/server/flight-source.d.ts +136 -0
- package/dist/server/flight-source.d.ts.map +1 -0
- package/dist/server/form-data.d.ts +59 -2
- package/dist/server/form-data.d.ts.map +1 -1
- package/dist/server/form-state-flight.d.ts +32 -0
- package/dist/server/form-state-flight.d.ts.map +1 -0
- package/dist/server/head-response.d.ts +35 -0
- package/dist/server/head-response.d.ts.map +1 -0
- package/dist/server/html-injector-core.d.ts +169 -0
- package/dist/server/html-injector-core.d.ts.map +1 -0
- package/dist/server/html-injectors.d.ts +77 -47
- package/dist/server/html-injectors.d.ts.map +1 -1
- package/dist/server/index.d.ts +16 -54
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +621 -3009
- package/dist/server/index.js.map +1 -1
- package/dist/server/instrumentation.d.ts +13 -5
- package/dist/server/instrumentation.d.ts.map +1 -1
- package/dist/server/interception-gates.d.ts +49 -0
- package/dist/server/interception-gates.d.ts.map +1 -0
- package/dist/server/internal.d.ts +48 -0
- package/dist/server/internal.d.ts.map +1 -0
- package/dist/server/internal.js +5092 -0
- package/dist/server/internal.js.map +1 -0
- package/dist/server/json-status-response.d.ts +34 -0
- package/dist/server/json-status-response.d.ts.map +1 -0
- package/dist/server/logger.d.ts +105 -7
- package/dist/server/logger.d.ts.map +1 -1
- package/dist/server/metadata-collector.d.ts +75 -0
- package/dist/server/metadata-collector.d.ts.map +1 -0
- package/dist/server/metadata-platform.d.ts +2 -2
- package/dist/server/metadata-render.d.ts +2 -2
- package/dist/server/metadata-render.d.ts.map +1 -1
- package/dist/server/metadata-route-links.d.ts +70 -0
- package/dist/server/metadata-route-links.d.ts.map +1 -0
- package/dist/server/metadata-routes.d.ts +47 -11
- package/dist/server/metadata-routes.d.ts.map +1 -1
- package/dist/server/metadata-social.d.ts +2 -2
- package/dist/server/metadata.d.ts +10 -2
- package/dist/server/metadata.d.ts.map +1 -1
- package/dist/server/middleware-runner.d.ts +20 -5
- package/dist/server/middleware-runner.d.ts.map +1 -1
- package/dist/server/node-body-response.d.ts +55 -0
- package/dist/server/node-body-response.d.ts.map +1 -0
- package/dist/server/node-response.d.ts +62 -0
- package/dist/server/node-response.d.ts.map +1 -0
- package/dist/server/node-stream-transforms.d.ts +108 -0
- package/dist/server/node-stream-transforms.d.ts.map +1 -0
- package/dist/server/node-streams-platform.d.ts +21 -0
- package/dist/server/node-streams-platform.d.ts.map +1 -0
- package/dist/server/param-coercion.d.ts +84 -0
- package/dist/server/param-coercion.d.ts.map +1 -0
- package/dist/server/pipeline-helpers.d.ts +227 -0
- package/dist/server/pipeline-helpers.d.ts.map +1 -0
- package/dist/server/pipeline-interception.d.ts +100 -9
- package/dist/server/pipeline-interception.d.ts.map +1 -1
- package/dist/server/pipeline-metadata-route.d.ts +24 -0
- package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
- package/dist/server/pipeline-metadata.d.ts +18 -2
- package/dist/server/pipeline-metadata.d.ts.map +1 -1
- package/dist/server/pipeline-outcome.d.ts +59 -0
- package/dist/server/pipeline-outcome.d.ts.map +1 -0
- package/dist/server/pipeline-phases.d.ts +76 -0
- package/dist/server/pipeline-phases.d.ts.map +1 -0
- package/dist/server/pipeline.d.ts +190 -23
- package/dist/server/pipeline.d.ts.map +1 -1
- package/dist/server/port-resolution.d.ts +22 -0
- package/dist/server/port-resolution.d.ts.map +1 -0
- package/dist/server/prebuilt/cache-key.d.ts +89 -0
- package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-render.d.ts +30 -0
- package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-routes.d.ts +37 -0
- package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-state.d.ts +101 -0
- package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
- package/dist/server/prebuilt/dev-store.d.ts +149 -0
- package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
- package/dist/server/prebuilt/lifetime.d.ts +38 -0
- package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
- package/dist/server/prebuilt/overlay.d.ts +119 -0
- package/dist/server/prebuilt/overlay.d.ts.map +1 -0
- package/dist/server/prebuilt/payload-source.d.ts +87 -0
- package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
- package/dist/server/prebuilt/slots.d.ts +105 -0
- package/dist/server/prebuilt/slots.d.ts.map +1 -0
- package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
- package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
- package/dist/server/prebuilt-builder.d.ts +121 -0
- package/dist/server/prebuilt-builder.d.ts.map +1 -0
- package/dist/server/prebuilt-runtime.d.ts +105 -0
- package/dist/server/prebuilt-runtime.d.ts.map +1 -0
- package/dist/server/primitives.d.ts +114 -90
- package/dist/server/primitives.d.ts.map +1 -1
- package/dist/server/publish-params.d.ts +33 -0
- package/dist/server/publish-params.d.ts.map +1 -0
- package/dist/server/react-cache-bridge.d.ts +59 -0
- package/dist/server/react-cache-bridge.d.ts.map +1 -0
- package/dist/server/react-cache-scope.d.ts +49 -0
- package/dist/server/react-cache-scope.d.ts.map +1 -0
- package/dist/server/render-timeout.d.ts +66 -0
- package/dist/server/render-timeout.d.ts.map +1 -0
- package/dist/server/render-utils.d.ts +56 -0
- package/dist/server/render-utils.d.ts.map +1 -0
- package/dist/server/request-context.d.ts +167 -103
- package/dist/server/request-context.d.ts.map +1 -1
- package/dist/server/request-dep.d.ts +15 -0
- package/dist/server/request-dep.d.ts.map +1 -0
- package/dist/server/response-cache-policy.d.ts +3 -0
- package/dist/server/response-cache-policy.d.ts.map +1 -0
- package/dist/server/response-framing.d.ts +43 -0
- package/dist/server/response-framing.d.ts.map +1 -0
- package/dist/server/route-element-builder.d.ts +57 -30
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/route-element-helpers.d.ts +12 -0
- package/dist/server/route-element-helpers.d.ts.map +1 -0
- package/dist/server/route-handler.d.ts +9 -3
- package/dist/server/route-handler.d.ts.map +1 -1
- package/dist/server/route-matcher.d.ts +75 -40
- package/dist/server/route-matcher.d.ts.map +1 -1
- package/dist/server/route-methods.d.ts +23 -0
- package/dist/server/route-methods.d.ts.map +1 -0
- package/dist/server/route-module-loader.d.ts +37 -0
- package/dist/server/route-module-loader.d.ts.map +1 -0
- package/dist/server/rsc-cache-key-guard.d.ts +78 -0
- package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
- package/dist/server/rsc-entry/api-handler.d.ts +19 -3
- package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
- package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
- package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
- package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
- package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
- package/dist/server/rsc-entry/helpers.d.ts +14 -59
- package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
- package/dist/server/rsc-entry/index.d.ts +30 -6
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts +55 -0
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
- package/dist/server/rsc-entry/render-signals.d.ts +65 -0
- package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
- package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
- package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
- package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
- package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
- package/dist/server/rsc-error-envelope.d.ts +11 -0
- package/dist/server/rsc-error-envelope.d.ts.map +1 -0
- package/dist/server/safe-load.d.ts +39 -0
- package/dist/server/safe-load.d.ts.map +1 -0
- package/dist/server/schema-introspection.d.ts +68 -0
- package/dist/server/schema-introspection.d.ts.map +1 -0
- package/dist/server/sensitive-fields.d.ts +88 -0
- package/dist/server/sensitive-fields.d.ts.map +1 -0
- package/dist/server/signal-identity.d.ts +49 -0
- package/dist/server/signal-identity.d.ts.map +1 -0
- package/dist/server/sitemap-generator.d.ts +130 -0
- package/dist/server/sitemap-generator.d.ts.map +1 -0
- package/dist/server/sitemap-handler.d.ts +22 -0
- package/dist/server/sitemap-handler.d.ts.map +1 -0
- package/dist/server/skippable-prefix.d.ts +29 -0
- package/dist/server/skippable-prefix.d.ts.map +1 -0
- package/dist/server/slot-interception.d.ts +80 -0
- package/dist/server/slot-interception.d.ts.map +1 -0
- package/dist/server/slot-resolver.d.ts +138 -7
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/slot-subtree-contain.d.ts +54 -0
- package/dist/server/slot-subtree-contain.d.ts.map +1 -0
- package/dist/server/ssr-bridge-types.d.ts +213 -0
- package/dist/server/ssr-bridge-types.d.ts.map +1 -0
- package/dist/server/ssr-entry.d.ts +15 -51
- package/dist/server/ssr-entry.d.ts.map +1 -1
- package/dist/server/ssr-form-state.d.ts +30 -0
- package/dist/server/ssr-form-state.d.ts.map +1 -0
- package/dist/server/ssr-render.d.ts +42 -12
- package/dist/server/ssr-render.d.ts.map +1 -1
- package/dist/server/ssr-wrappers.d.ts +92 -0
- package/dist/server/ssr-wrappers.d.ts.map +1 -0
- package/dist/server/state-tree-diff.d.ts +44 -9
- package/dist/server/state-tree-diff.d.ts.map +1 -1
- package/dist/server/static-generator.d.ts +112 -0
- package/dist/server/static-generator.d.ts.map +1 -0
- package/dist/server/static-not-found.d.ts +52 -0
- package/dist/server/static-not-found.d.ts.map +1 -0
- package/dist/server/status-code-resolver.d.ts +26 -15
- package/dist/server/status-code-resolver.d.ts.map +1 -1
- package/dist/server/stream-utils.d.ts +93 -0
- package/dist/server/stream-utils.d.ts.map +1 -0
- package/dist/server/traced-access.d.ts +18 -0
- package/dist/server/traced-access.d.ts.map +1 -0
- package/dist/server/tracing.d.ts +72 -31
- package/dist/server/tracing.d.ts.map +1 -1
- package/dist/server/tree-match.d.ts +59 -0
- package/dist/server/tree-match.d.ts.map +1 -0
- package/dist/server/types.d.ts +90 -8
- package/dist/server/types.d.ts.map +1 -1
- package/dist/server/utils/element-type.d.ts +50 -0
- package/dist/server/utils/element-type.d.ts.map +1 -0
- package/dist/server/utils/escape-html.d.ts +14 -0
- package/dist/server/utils/escape-html.d.ts.map +1 -0
- package/dist/server/version-skew.d.ts +61 -0
- package/dist/server/version-skew.d.ts.map +1 -0
- package/dist/server/workers-cache-bridge.d.ts +26 -0
- package/dist/server/workers-cache-bridge.d.ts.map +1 -0
- package/dist/shared/als-slots.d.ts +42 -0
- package/dist/shared/als-slots.d.ts.map +1 -0
- package/dist/shared/base-path.d.ts +56 -0
- package/dist/shared/base-path.d.ts.map +1 -0
- package/dist/shared/csrf-reject.d.ts +16 -0
- package/dist/shared/csrf-reject.d.ts.map +1 -0
- package/dist/shared/dev-span.d.ts +99 -0
- package/dist/shared/dev-span.d.ts.map +1 -0
- package/dist/shared/error-digest.d.ts +28 -0
- package/dist/shared/error-digest.d.ts.map +1 -0
- package/dist/shared/flight-base64.d.ts +13 -0
- package/dist/shared/flight-base64.d.ts.map +1 -0
- package/dist/shared/flight-segment.d.ts +18 -0
- package/dist/shared/flight-segment.d.ts.map +1 -0
- package/dist/shared/form-state-flight.d.ts +32 -0
- package/dist/shared/form-state-flight.d.ts.map +1 -0
- package/dist/shared/href-validation.d.ts +49 -0
- package/dist/shared/href-validation.d.ts.map +1 -0
- package/dist/shared/href.d.ts +88 -0
- package/dist/shared/href.d.ts.map +1 -0
- package/dist/shared/merge-search-params.d.ts +22 -0
- package/dist/shared/merge-search-params.d.ts.map +1 -0
- package/dist/shared/param-value.d.ts +104 -0
- package/dist/shared/param-value.d.ts.map +1 -0
- package/dist/shared/payload-root.d.ts +110 -0
- package/dist/shared/payload-root.d.ts.map +1 -0
- package/dist/shared/redirect-type.d.ts +17 -0
- package/dist/shared/redirect-type.d.ts.map +1 -0
- package/dist/shared/rsc-cache-key.d.ts +163 -0
- package/dist/shared/rsc-cache-key.d.ts.map +1 -0
- package/dist/shared/rsc-error-envelope.d.ts +16 -0
- package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
- package/dist/shared/rsc-manifest.d.ts +28 -0
- package/dist/shared/rsc-manifest.d.ts.map +1 -0
- package/dist/shared/rsc-media-type.d.ts +52 -0
- package/dist/shared/rsc-media-type.d.ts.map +1 -0
- package/dist/shared/rsc-payload-path.d.ts +48 -0
- package/dist/shared/rsc-payload-path.d.ts.map +1 -0
- package/dist/shared/segment-info.d.ts +66 -0
- package/dist/shared/segment-info.d.ts.map +1 -0
- package/dist/shared/slot-params.d.ts +52 -0
- package/dist/shared/slot-params.d.ts.map +1 -0
- package/dist/shared/static-platform-files.d.ts +71 -0
- package/dist/shared/static-platform-files.d.ts.map +1 -0
- package/dist/shared/status-reason-phrase.d.ts +26 -0
- package/dist/shared/status-reason-phrase.d.ts.map +1 -0
- package/dist/shims/font-google.d.ts +1 -1
- package/dist/shims/font-google.d.ts.map +1 -1
- package/dist/shims/font-google.js +41 -0
- package/dist/shims/font-google.js.map +1 -0
- package/dist/shims/font-local.d.ts +26 -0
- package/dist/shims/font-local.d.ts.map +1 -0
- package/dist/shims/font-local.js +19 -0
- package/dist/shims/font-local.js.map +1 -0
- package/dist/shims/headers.d.ts +60 -1
- package/dist/shims/headers.d.ts.map +1 -1
- package/dist/shims/image.d.ts +120 -120
- package/dist/shims/image.d.ts.map +1 -1
- package/dist/shims/navigation-client.d.ts +25 -12
- package/dist/shims/navigation-client.d.ts.map +1 -1
- package/dist/shims/navigation-rsc.d.ts +21 -0
- package/dist/shims/navigation-rsc.d.ts.map +1 -0
- package/dist/shims/navigation.d.ts +10 -5
- package/dist/shims/navigation.d.ts.map +1 -1
- package/dist/utils/state-machine.d.ts +80 -0
- package/dist/utils/state-machine.d.ts.map +1 -0
- package/dist/utils/write-file-atomic.d.ts +17 -0
- package/dist/utils/write-file-atomic.d.ts.map +1 -0
- package/docs/api/30-api-server.mdx +241 -0
- package/docs/api/31-api-client.mdx +225 -0
- package/docs/api/32-api-cache.mdx +341 -0
- package/docs/api/33-api-search-params.mdx +178 -0
- package/docs/api/34-api-config.mdx +421 -0
- package/docs/api/35-api-typescript.mdx +123 -0
- package/docs/api/36-cli.mdx +272 -0
- package/docs/learn/00-introduction.mdx +109 -0
- package/docs/learn/01-quick-start.mdx +94 -0
- package/docs/learn/02-pages-and-layouts.mdx +147 -0
- package/docs/learn/03-fetching-data.mdx +227 -0
- package/docs/learn/04-access-control.mdx +115 -0
- package/docs/learn/05-the-flush-point.mdx +175 -0
- package/docs/learn/06-typed-params.mdx +275 -0
- package/docs/learn/07-typed-routes.mdx +173 -0
- package/docs/learn/08-forms-and-actions.mdx +260 -0
- package/docs/learn/09-streaming.mdx +146 -0
- package/docs/learn/10-caching.mdx +303 -0
- package/docs/learn/11-middleware.mdx +166 -0
- package/docs/learn/12-error-handling.mdx +192 -0
- package/docs/learn/13-deploying.mdx +289 -0
- package/llms.txt +55 -0
- package/package.json +124 -29
- package/src/adapters/build-output-helper.ts +375 -0
- package/src/adapters/canonicalize-module.ts +29 -0
- package/src/adapters/cloudflare-dev.ts +183 -0
- package/src/adapters/cloudflare-kv-cache.ts +203 -0
- package/src/adapters/cloudflare.ts +799 -151
- package/src/adapters/compress-module.ts +110 -86
- package/src/adapters/fs-identity.ts +155 -0
- package/src/adapters/nitro-immutable-assets.ts +142 -0
- package/src/adapters/nitro-presets.ts +139 -0
- package/src/adapters/nitro-preview.ts +565 -0
- package/src/adapters/nitro.ts +349 -448
- package/src/adapters/raw-imports.d.ts +5 -0
- package/src/adapters/shared.ts +314 -0
- package/src/adapters/types.ts +129 -17
- package/src/adapters/wrangler.d.ts +7 -0
- package/src/analyze/chains.ts +411 -0
- package/src/analyze/classify.ts +259 -0
- package/src/analyze/crawl-entry.ts +68 -0
- package/src/analyze/crawl.ts +500 -0
- package/src/analyze/graph-cache.ts +331 -0
- package/src/analyze/graph-command.ts +654 -0
- package/src/analyze/live-graph.ts +232 -0
- package/src/analyze/poison-rules.ts +165 -0
- package/src/analyze/poison-scan.ts +159 -0
- package/src/analyze/scan.ts +149 -0
- package/src/cache/cache-api.ts +113 -0
- package/src/cache/fast-hash.ts +5 -0
- package/src/cache/guarded-read.ts +44 -0
- package/src/cache/handler-store.ts +113 -0
- package/src/cache/index.ts +93 -20
- package/src/cache/invalidation-epoch.ts +105 -0
- package/src/cache/json-lossy-check.ts +69 -0
- package/src/cache/key-discipline.ts +218 -0
- package/src/cache/redis-handler.ts +193 -19
- package/src/cache/singleflight.ts +85 -7
- package/src/cache/sizeof.ts +35 -0
- package/src/cache/stable-stringify.ts +118 -2
- package/src/cache/store.ts +71 -0
- package/src/cache/stores/cloudflare-kv.ts +52 -0
- package/src/cache/stores/memory.ts +125 -0
- package/src/cache/stores/redis.ts +97 -0
- package/src/cache/stores/vercel.ts +59 -0
- package/src/cache/tag-aware-handler.ts +250 -0
- package/src/cache/timber-cache.ts +218 -47
- package/src/cdn/cloudflare-purge.ts +50 -0
- package/src/cdn/fastly-purge.ts +63 -0
- package/src/cdn/headers.ts +153 -0
- package/src/cdn/index.ts +23 -0
- package/src/cdn/purge-store.ts +62 -0
- package/src/cdn/workers-cache-purge.ts +34 -0
- package/src/cli-check.ts +417 -0
- package/src/cli-context.ts +128 -0
- package/src/cli-dev-status.ts +196 -0
- package/src/cli-init.ts +278 -0
- package/src/cli-schema-sync.ts +401 -0
- package/src/cli.ts +308 -84
- package/src/client/browser-dev.ts +192 -5
- package/src/client/browser-entry/action-dispatch.ts +317 -0
- package/src/client/browser-entry/action-queue.ts +152 -0
- package/src/client/browser-entry/form-state.ts +49 -0
- package/src/client/browser-entry/hmr.ts +82 -0
- package/src/client/browser-entry/hydrate.ts +152 -0
- package/src/client/browser-entry/index.ts +153 -0
- package/src/client/browser-entry/post-hydration.ts +99 -0
- package/src/client/browser-entry/router-init.ts +391 -0
- package/src/client/browser-entry/rsc-stream.ts +145 -0
- package/src/client/browser-entry/scroll.ts +50 -0
- package/src/client/deny-last-resort.tsx +54 -0
- package/src/client/dev-pill/index.ts +128 -0
- package/src/client/dev-pill/store.ts +254 -0
- package/src/client/dev-pill/view.ts +326 -0
- package/src/client/error-boundary.tsx +296 -61
- package/src/client/error-reconstituter.tsx +84 -0
- package/src/client/form.tsx +61 -173
- package/src/client/global-context.ts +59 -0
- package/src/client/history.ts +74 -11
- package/src/client/index.ts +93 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +284 -204
- package/src/client/location-search.ts +15 -0
- package/src/client/navigation-api.ts +254 -0
- package/src/client/navigation-commit.ts +318 -0
- package/src/client/navigation-context.ts +71 -142
- package/src/client/navigation-root.tsx +237 -0
- package/src/client/navigation-transition.ts +401 -0
- package/src/client/nuqs-adapter.tsx +62 -32
- package/src/client/params-context.ts +175 -0
- package/src/client/react-root.ts +105 -0
- package/src/client/router-effects.ts +349 -0
- package/src/client/router-lifecycle.ts +394 -0
- package/src/client/router-pipeline.ts +443 -0
- package/src/client/router-ref.ts +3 -3
- package/src/client/router-skew.ts +30 -0
- package/src/client/router-types.ts +326 -0
- package/src/client/router-url.ts +32 -0
- package/src/client/router.ts +491 -421
- package/src/client/rsc-fetch.ts +510 -109
- package/src/client/segment-cache.ts +362 -41
- package/src/client/segment-context.ts +7 -4
- package/src/client/segment-outlet.tsx +96 -0
- package/src/client/segment-update-context.ts +23 -0
- package/src/client/shallow-url.ts +22 -0
- package/src/client/slot-content-cache-context.ts +43 -0
- package/src/client/slot-context.ts +39 -0
- package/src/client/slot-outlet.tsx +22 -0
- package/src/client/slot-provider.tsx +32 -0
- package/src/client/ssr-data.ts +27 -67
- package/src/client/stale-client.ts +191 -0
- package/src/client/state.ts +31 -24
- package/src/client/status-page-marker.tsx +32 -0
- package/src/client/top-loader.tsx +13 -10
- package/src/client/unload-guard.ts +35 -3
- package/src/client/use-cookie.ts +93 -29
- package/src/client/use-field-state.ts +144 -0
- package/src/client/use-link-status.ts +7 -7
- package/src/client/use-pathname.ts +22 -31
- package/src/client/use-pending-navigation.ts +119 -0
- package/src/client/use-query-states.ts +206 -36
- package/src/client/use-router.ts +31 -9
- package/src/client/use-search-params.ts +38 -49
- package/src/client/use-segment-params.ts +69 -0
- package/src/client/use-selected-layout-segment.ts +2 -2
- package/src/codec.ts +149 -0
- package/src/config-types.ts +366 -0
- package/src/config-validation.ts +511 -0
- package/src/cookies/define-cookie.ts +186 -53
- package/src/cookies/index.ts +13 -2
- package/src/cookies/json-cookie.ts +105 -0
- package/src/cookies/validation.ts +192 -0
- package/src/dev-tools/404-page.ts +286 -0
- package/src/dev-tools/await-span.ts +69 -0
- package/src/dev-tools/browser-logs.ts +55 -0
- package/src/dev-tools/dev-page-shell.ts +278 -0
- package/src/dev-tools/error-page.ts +331 -0
- package/src/dev-tools/holding-server.ts +185 -0
- package/src/dev-tools/hydration-overlay.ts +158 -0
- package/src/dev-tools/index.ts +79 -0
- package/src/dev-tools/instrumentation.ts +281 -0
- package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
- package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
- package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
- package/src/dev-tools/span-sink.ts +132 -0
- package/src/dev-tools/stack-classifier.ts +75 -0
- package/src/dev-tools/terminal.ts +182 -0
- package/src/fonts/ast-walk.ts +235 -0
- package/src/fonts/ast.ts +479 -128
- package/src/fonts/bundle.ts +138 -0
- package/src/fonts/css.ts +1 -1
- package/src/fonts/dev-middleware.ts +85 -0
- package/src/fonts/fallbacks.ts +0 -23
- package/src/fonts/google.ts +101 -19
- package/src/fonts/local.ts +12 -11
- package/src/fonts/paths.ts +58 -0
- package/src/fonts/pipeline.ts +348 -0
- package/src/fonts/transform.ts +311 -0
- package/src/fonts/types.ts +52 -1
- package/src/fonts/virtual-modules.ts +179 -0
- package/src/index.ts +501 -380
- package/src/params/codec-registry.ts +47 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +16 -0
- package/src/params/resolve-schema.ts +84 -0
- package/src/plugin-context.ts +509 -0
- package/src/plugins/build-manifest.ts +189 -36
- package/src/plugins/build-report.ts +299 -87
- package/src/plugins/cache.ts +243 -0
- package/src/plugins/callsite-ast.ts +472 -0
- package/src/plugins/callsite-jsx.ts +243 -0
- package/src/plugins/chunks.ts +74 -5
- package/src/plugins/client-chunks.ts +185 -0
- package/src/plugins/client-dep-entries.ts +124 -0
- package/src/plugins/client-in-server-package-deps.ts +139 -0
- package/src/plugins/cloudflare-wasm.ts +141 -0
- package/src/plugins/content.ts +31 -2
- package/src/plugins/dev-await.ts +415 -0
- package/src/plugins/dev-discovery.ts +428 -0
- package/src/plugins/dev-hostname.ts +322 -0
- package/src/plugins/dev-server.ts +471 -100
- package/src/plugins/dev-store-clear.ts +145 -0
- package/src/plugins/encryption-runtime.ts +31 -0
- package/src/plugins/entries.ts +158 -17
- package/src/plugins/fonts.ts +260 -657
- package/src/plugins/graph-endpoint.ts +544 -0
- package/src/plugins/mdx.ts +108 -35
- package/src/plugins/optimize-package-imports-defaults.ts +88 -0
- package/src/plugins/optimize-package-imports.ts +439 -0
- package/src/plugins/orphaned-modules.ts +78 -0
- package/src/plugins/post-build.ts +327 -0
- package/src/plugins/prebuilt-capture.ts +213 -0
- package/src/plugins/prebuilt-options-analysis.ts +175 -0
- package/src/plugins/prebuilt.ts +679 -0
- package/src/plugins/prerender-sugar.ts +348 -0
- package/src/plugins/react-resolve.ts +149 -0
- package/src/plugins/request-dep/analysis.ts +447 -0
- package/src/plugins/request-dep/index.ts +376 -0
- package/src/plugins/request-dep/origin.ts +310 -0
- package/src/plugins/routing.ts +296 -278
- package/src/plugins/rsc-assets-manifest.ts +251 -0
- package/src/plugins/server-bundle.ts +115 -15
- package/src/plugins/shims.ts +267 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -0
- package/src/routes/href.ts +171 -0
- package/src/routes/index.ts +10 -0
- package/src/routing/codegen-shared.ts +39 -0
- package/src/routing/codegen-types.ts +62 -0
- package/src/routing/codegen-write.ts +163 -0
- package/src/routing/codegen.ts +356 -232
- package/src/routing/collision-probe.ts +438 -0
- package/src/routing/collision-spaces.ts +281 -0
- package/src/routing/convention-lint.ts +649 -0
- package/src/routing/export-detect.ts +536 -0
- package/src/routing/file-cache.ts +23 -0
- package/src/routing/index.ts +16 -7
- package/src/routing/interception-overlap.ts +141 -0
- package/src/routing/interception.ts +1044 -67
- package/src/routing/link-codegen.ts +346 -0
- package/src/routing/manifest-codegen.ts +232 -0
- package/src/routing/scanner.ts +417 -223
- package/src/routing/schema-validation.ts +155 -0
- package/src/routing/segment-classify.ts +280 -0
- package/src/routing/segment-codegen.ts +99 -0
- package/src/routing/segment-keys.ts +186 -0
- package/src/routing/slot-placement.ts +97 -0
- package/src/routing/types.ts +82 -26
- package/src/routing/walkers.ts +98 -0
- package/src/rsc-runtime/dev-reference-cache.ts +115 -0
- package/src/rsc-runtime/encryption-runtime.ts +78 -0
- package/src/rsc-runtime/render-flight.ts +26 -0
- package/src/rsc-runtime/rsc.ts +35 -5
- package/src/rsc-runtime/server-reference-load-error.ts +16 -0
- package/src/rsc-runtime/server-references.ts +135 -0
- package/src/rsc-runtime/ssr.ts +23 -0
- package/src/rsc-runtime/transforms.ts +13 -0
- package/src/rsc-runtime/vendor-types.d.ts +87 -0
- package/src/schema-bridge.ts +437 -0
- package/src/search-params/define.ts +676 -0
- package/src/search-params/index.ts +14 -20
- package/src/search-params/parse-total.ts +91 -0
- package/src/search-params/serialize-equal.ts +14 -0
- package/src/search-params/wrappers.ts +150 -0
- package/src/server/abort-scope.ts +49 -0
- package/src/server/access-gate.tsx +208 -57
- package/src/server/action-client.ts +175 -294
- package/src/server/action-encryption.ts +144 -0
- package/src/server/action-handler.ts +533 -150
- package/src/server/action-schema.ts +203 -0
- package/src/server/action-types.ts +145 -0
- package/src/server/actions.ts +172 -85
- package/src/server/als-registry.ts +245 -30
- package/src/server/body-limits.ts +10 -2
- package/src/server/build-manifest.ts +33 -57
- package/src/server/canonicalize.ts +62 -3
- package/src/server/chain-url-parts.ts +163 -0
- package/src/server/children-interception.ts +116 -0
- package/src/server/client-error-message.ts +18 -0
- package/src/server/coalesce-tick.ts +75 -0
- package/src/server/compress.ts +91 -19
- package/src/server/cookie-context.ts +462 -0
- package/src/server/cookie-parsing.ts +163 -0
- package/src/server/csp-nonce.ts +58 -0
- package/src/server/csrf.ts +238 -37
- package/src/server/debug.ts +0 -1
- package/src/server/default-logger.ts +100 -0
- package/src/server/default-status-page.ts +88 -0
- package/src/server/deny-boundary.ts +527 -0
- package/src/server/deny-renderer.ts +210 -181
- package/src/server/early-hints-sender.ts +4 -3
- package/src/server/early-hints.ts +39 -29
- package/src/server/error-boundary-wrapper.ts +160 -44
- package/src/server/error-response-headers.ts +18 -0
- package/src/server/fallback-error.ts +88 -104
- package/src/server/flight-injection-state.ts +113 -0
- package/src/server/flight-injector-core.ts +332 -0
- package/src/server/flight-scripts.ts +92 -0
- package/src/server/flight-source-node.ts +434 -0
- package/src/server/flight-source.ts +289 -0
- package/src/server/form-data.ts +191 -20
- package/src/server/form-state-flight.ts +67 -0
- package/src/server/head-response.ts +50 -0
- package/src/server/html-injector-core.ts +320 -0
- package/src/server/html-injectors.ts +241 -285
- package/src/server/index.ts +42 -195
- package/src/server/instrumentation.ts +42 -11
- package/src/server/interception-gates.ts +94 -0
- package/src/server/internal.ts +164 -0
- package/src/server/json-status-response.ts +105 -0
- package/src/server/logger.ts +163 -38
- package/src/server/metadata-collector.ts +175 -0
- package/src/server/metadata-platform.ts +2 -2
- package/src/server/metadata-render.ts +30 -8
- package/src/server/metadata-route-links.ts +200 -0
- package/src/server/metadata-routes.ts +114 -24
- package/src/server/metadata-social.ts +2 -2
- package/src/server/metadata.ts +23 -2
- package/src/server/middleware-runner.ts +32 -5
- package/src/server/node-body-response.ts +236 -0
- package/src/server/node-response.ts +93 -0
- package/src/server/node-stream-transforms.ts +340 -0
- package/src/server/node-streams-platform.ts +23 -0
- package/src/server/param-coercion.ts +205 -0
- package/src/server/pipeline-helpers.ts +554 -0
- package/src/server/pipeline-interception.ts +301 -32
- package/src/server/pipeline-metadata-route.ts +242 -0
- package/src/server/pipeline-metadata.ts +30 -4
- package/src/server/pipeline-outcome.ts +290 -0
- package/src/server/pipeline-phases.ts +443 -0
- package/src/server/pipeline.ts +474 -427
- package/src/server/port-resolution.ts +43 -0
- package/src/server/prebuilt/cache-key.ts +340 -0
- package/src/server/prebuilt/capture-render.ts +122 -0
- package/src/server/prebuilt/capture-routes.ts +104 -0
- package/src/server/prebuilt/capture-state.ts +196 -0
- package/src/server/prebuilt/dev-store.ts +252 -0
- package/src/server/prebuilt/lifetime.ts +151 -0
- package/src/server/prebuilt/manifest-tag-index.ts +46 -0
- package/src/server/prebuilt/overlay.ts +290 -0
- package/src/server/prebuilt/payload-source.ts +221 -0
- package/src/server/prebuilt/slots.ts +201 -0
- package/src/server/prebuilt/synthetic-store.ts +125 -0
- package/src/server/prebuilt-builder.ts +515 -0
- package/src/server/prebuilt-runtime.ts +830 -0
- package/src/server/primitives.ts +167 -171
- package/src/server/publish-params.ts +42 -0
- package/src/server/react-cache-bridge.ts +124 -0
- package/src/server/react-cache-scope.ts +104 -0
- package/src/server/render-timeout.ts +123 -0
- package/src/server/render-utils.ts +70 -0
- package/src/server/request-context.ts +321 -323
- package/src/server/request-dep.ts +37 -0
- package/src/server/response-cache-policy.ts +45 -0
- package/src/server/response-framing.ts +59 -0
- package/src/server/route-element-builder.ts +539 -355
- package/src/server/route-element-helpers.ts +37 -0
- package/src/server/route-handler.ts +78 -48
- package/src/server/route-matcher.ts +251 -265
- package/src/server/route-methods.ts +37 -0
- package/src/server/route-module-loader.ts +161 -0
- package/src/server/rsc-cache-key-guard.ts +122 -0
- package/src/server/rsc-entry/action-dispatcher.ts +146 -0
- package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
- package/src/server/rsc-entry/api-handler.ts +30 -93
- package/src/server/rsc-entry/deny-fallback.ts +151 -0
- package/src/server/rsc-entry/error-renderer.ts +306 -113
- package/src/server/rsc-entry/helpers.ts +90 -115
- package/src/server/rsc-entry/index.ts +420 -350
- package/src/server/rsc-entry/render-route.ts +248 -0
- package/src/server/rsc-entry/render-signals.ts +108 -0
- package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
- package/src/server/rsc-entry/rsc-payload.ts +212 -113
- package/src/server/rsc-entry/rsc-stream.ts +143 -135
- package/src/server/rsc-entry/ssr-bridge.ts +43 -8
- package/src/server/rsc-entry/ssr-renderer.ts +311 -140
- package/src/server/rsc-error-envelope.ts +18 -0
- package/src/server/rsc-prop-warnings.ts +1 -1
- package/src/server/safe-load.ts +53 -0
- package/src/server/schema-introspection.ts +393 -0
- package/src/server/sensitive-fields.ts +287 -0
- package/src/server/server-only-guard-noop.js +3 -0
- package/src/server/server-timing.ts +1 -1
- package/src/server/signal-identity.ts +130 -0
- package/src/server/sitemap-generator.ts +337 -0
- package/src/server/sitemap-handler.ts +150 -0
- package/src/server/skippable-prefix.ts +172 -0
- package/src/server/slot-interception.ts +168 -0
- package/src/server/slot-resolver.ts +747 -300
- package/src/server/slot-subtree-contain.ts +273 -0
- package/src/server/ssr-bridge-types.ts +217 -0
- package/src/server/ssr-entry.ts +246 -109
- package/src/server/ssr-form-state.ts +58 -0
- package/src/server/ssr-render.ts +253 -113
- package/src/server/ssr-wrappers.tsx +152 -0
- package/src/server/state-tree-diff.ts +85 -30
- package/src/server/static-generator.ts +680 -0
- package/src/server/static-not-found.ts +134 -0
- package/src/server/status-code-resolver.ts +107 -148
- package/src/server/stream-utils.ts +398 -0
- package/src/server/traced-access.ts +50 -0
- package/src/server/tracing.ts +274 -128
- package/src/server/tree-match.ts +494 -0
- package/src/server/types.ts +97 -11
- package/src/server/utils/element-type.ts +88 -0
- package/src/server/utils/escape-html.ts +20 -0
- package/src/server/version-skew.ts +104 -0
- package/src/server/waituntil-bridge.ts +1 -1
- package/src/server/workers-cache-bridge.ts +33 -0
- package/src/shared/als-slots.ts +74 -0
- package/src/shared/base-path.ts +80 -0
- package/src/shared/csrf-reject.ts +15 -0
- package/src/shared/dev-span.ts +188 -0
- package/src/shared/error-digest.ts +46 -0
- package/src/shared/flight-base64.ts +23 -0
- package/src/shared/flight-segment.ts +35 -0
- package/src/shared/form-state-flight.ts +59 -0
- package/src/shared/href-validation.ts +159 -0
- package/src/shared/href.ts +257 -0
- package/src/shared/merge-search-params.ts +55 -0
- package/src/shared/param-value.ts +281 -0
- package/src/shared/payload-root.ts +153 -0
- package/src/shared/redirect-type.ts +17 -0
- package/src/shared/rsc-cache-key.ts +269 -0
- package/src/shared/rsc-error-envelope.ts +16 -0
- package/src/shared/rsc-manifest.ts +29 -0
- package/src/shared/rsc-media-type.ts +59 -0
- package/src/shared/rsc-payload-path.ts +52 -0
- package/src/shared/segment-info.ts +67 -0
- package/src/shared/slot-params.ts +109 -0
- package/src/shared/static-platform-files.ts +75 -0
- package/src/shared/status-reason-phrase.ts +61 -0
- package/src/shims/font-google.ts +1 -1
- package/src/shims/font-local.ts +34 -0
- package/src/shims/headers.ts +130 -1
- package/src/shims/navigation-client.ts +36 -32
- package/src/shims/navigation-rsc.ts +47 -0
- package/src/shims/navigation.ts +10 -7
- package/src/utils/state-machine.ts +111 -0
- package/src/utils/write-file-atomic.ts +32 -0
- package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
- package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
- package/dist/_chunks/debug-B3Gypr3D.js +0 -108
- package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
- package/dist/_chunks/format-RyoGQL74.js +0 -164
- package/dist/_chunks/format-RyoGQL74.js.map +0 -1
- package/dist/_chunks/interception-BOoWmLUA.js +0 -676
- package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
- package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
- package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
- package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
- package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
- package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
- package/dist/_chunks/tracing-CemImE6h.js +0 -187
- package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
- package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
- package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
- package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
- package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
- package/dist/adapters/cloudflare.js.map +0 -1
- package/dist/cache/index.js.map +0 -1
- package/dist/cache/register-cached-function.d.ts +0 -17
- package/dist/cache/register-cached-function.d.ts.map +0 -1
- package/dist/client/browser-entry.d.ts +0 -21
- package/dist/client/browser-entry.d.ts.map +0 -1
- package/dist/client/error-boundary.js.map +0 -1
- package/dist/client/head.d.ts +0 -16
- package/dist/client/head.d.ts.map +0 -1
- package/dist/client/link-status-provider.d.ts +0 -11
- package/dist/client/link-status-provider.d.ts.map +0 -1
- package/dist/client/segment-merger.d.ts +0 -119
- package/dist/client/segment-merger.d.ts.map +0 -1
- package/dist/client/stale-reload.d.ts +0 -44
- package/dist/client/stale-reload.d.ts.map +0 -1
- package/dist/client/transition-root.d.ts +0 -74
- package/dist/client/transition-root.d.ts.map +0 -1
- package/dist/client/types.d.ts +0 -14
- package/dist/client/types.d.ts.map +0 -1
- package/dist/client/use-navigation-pending.d.ts +0 -26
- package/dist/client/use-navigation-pending.d.ts.map +0 -1
- package/dist/client/use-params.d.ts +0 -92
- package/dist/client/use-params.d.ts.map +0 -1
- package/dist/content/index.d.ts +0 -11
- package/dist/content/index.d.ts.map +0 -1
- package/dist/content/index.js +0 -2
- package/dist/plugins/adapter-build.d.ts +0 -18
- package/dist/plugins/adapter-build.d.ts.map +0 -1
- package/dist/plugins/cache-transform.d.ts +0 -36
- package/dist/plugins/cache-transform.d.ts.map +0 -1
- package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
- package/dist/plugins/dev-logs.d.ts.map +0 -1
- package/dist/plugins/dynamic-transform.d.ts +0 -72
- package/dist/plugins/dynamic-transform.d.ts.map +0 -1
- package/dist/plugins/server-action-exports.d.ts +0 -26
- package/dist/plugins/server-action-exports.d.ts.map +0 -1
- package/dist/routing/status-file-lint.d.ts +0 -33
- package/dist/routing/status-file-lint.d.ts.map +0 -1
- package/dist/search-params/analyze.d.ts +0 -54
- package/dist/search-params/analyze.d.ts.map +0 -1
- package/dist/search-params/builtin-codecs.d.ts +0 -105
- package/dist/search-params/builtin-codecs.d.ts.map +0 -1
- package/dist/search-params/codecs.d.ts +0 -53
- package/dist/search-params/codecs.d.ts.map +0 -1
- package/dist/search-params/create.d.ts +0 -106
- package/dist/search-params/create.d.ts.map +0 -1
- package/dist/search-params/registry.d.ts +0 -20
- package/dist/search-params/registry.d.ts.map +0 -1
- package/dist/server/asset-headers.d.ts +0 -42
- package/dist/server/asset-headers.d.ts.map +0 -1
- package/dist/server/client-module-map.d.ts +0 -47
- package/dist/server/client-module-map.d.ts.map +0 -1
- package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
- package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
- package/dist/server/dev-logger.d.ts.map +0 -1
- package/dist/server/dev-span-processor.d.ts +0 -29
- package/dist/server/dev-span-processor.d.ts.map +0 -1
- package/dist/server/dev-warnings.d.ts +0 -129
- package/dist/server/dev-warnings.d.ts.map +0 -1
- package/dist/server/flush.d.ts +0 -74
- package/dist/server/flush.d.ts.map +0 -1
- package/dist/server/form-flash.d.ts +0 -78
- package/dist/server/form-flash.d.ts.map +0 -1
- package/dist/server/manifest-status-resolver.d.ts +0 -58
- package/dist/server/manifest-status-resolver.d.ts.map +0 -1
- package/dist/server/nuqs-ssr-provider.d.ts +0 -28
- package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
- package/dist/server/prerender.d.ts +0 -77
- package/dist/server/prerender.d.ts.map +0 -1
- package/dist/server/tree-builder.d.ts +0 -126
- package/dist/server/tree-builder.d.ts.map +0 -1
- package/dist/utils/directive-parser.d.ts +0 -70
- package/dist/utils/directive-parser.d.ts.map +0 -1
- package/src/cache/register-cached-function.ts +0 -103
- package/src/client/browser-entry.ts +0 -678
- package/src/client/head.ts +0 -61
- package/src/client/link-status-provider.tsx +0 -30
- package/src/client/segment-merger.ts +0 -339
- package/src/client/stale-reload.ts +0 -87
- package/src/client/transition-root.tsx +0 -166
- package/src/client/types.ts +0 -21
- package/src/client/use-navigation-pending.ts +0 -38
- package/src/client/use-params.ts +0 -141
- package/src/content/index.ts +0 -13
- package/src/plugins/adapter-build.ts +0 -118
- package/src/plugins/cache-transform.ts +0 -199
- package/src/plugins/dynamic-transform.ts +0 -161
- package/src/plugins/server-action-exports.ts +0 -220
- package/src/routing/status-file-lint.ts +0 -112
- package/src/search-params/analyze.ts +0 -192
- package/src/search-params/builtin-codecs.ts +0 -228
- package/src/search-params/codecs.ts +0 -153
- package/src/search-params/create.ts +0 -321
- package/src/search-params/registry.ts +0 -31
- package/src/server/asset-headers.ts +0 -81
- package/src/server/client-module-map.ts +0 -58
- package/src/server/dev-fetch-instrumentation.ts +0 -96
- package/src/server/dev-span-processor.ts +0 -78
- package/src/server/dev-warnings.ts +0 -283
- package/src/server/flush.ts +0 -182
- package/src/server/form-flash.ts +0 -89
- package/src/server/manifest-status-resolver.ts +0 -215
- package/src/server/nuqs-ssr-provider.tsx +0 -63
- package/src/server/prerender.ts +0 -139
- package/src/server/tree-builder.ts +0 -382
- package/src/shims/server-only-noop.js +0 -6
- package/src/utils/directive-parser.ts +0 -529
package/dist/client/index.js
CHANGED
|
@@ -1,21 +1,28 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import {
|
|
3
|
-
import { n as
|
|
4
|
-
import {
|
|
5
|
-
import
|
|
6
|
-
import
|
|
2
|
+
import { c as stripRscCacheKey } from "../_chunks/rsc-cache-key-D0cb0Gmc.js";
|
|
3
|
+
import { n as resolveSegmentParams, t as mergePreservedSearchParams } from "../_chunks/merge-search-params-7o_5yX0L.js";
|
|
4
|
+
import { i as validateNavigationHref, n as isInternalHref } from "../_chunks/href-validation-DNg-zV7u.js";
|
|
5
|
+
import "../_chunks/param-value-DqlGfF57.js";
|
|
6
|
+
import { t as createGlobalContext } from "../_chunks/global-context-CFSSysdJ.js";
|
|
7
|
+
import { n as interpolateParams, r as resolveHref } from "../_chunks/href-BtspoNc9.js";
|
|
8
|
+
import { i as useNavigationContext, n as usePendingNavigation, o as getRouterOrNull } from "../_chunks/navigation-root-CoGHIMiE.js";
|
|
9
|
+
import { t as getSsrData } from "../_chunks/ssr-data-9hPtcNOr.js";
|
|
10
|
+
import { n as useSegmentContext } from "../_chunks/segment-context-GAyTjjtS.js";
|
|
11
|
+
import { n as useQueryStates } from "../_chunks/use-query-states-pkDV-jSg.js";
|
|
12
|
+
import React, { createContext, useCallback, useContext, useEffect, useLayoutEffect, useRef, useState } from "react";
|
|
13
|
+
import { flushSync } from "react-dom";
|
|
7
14
|
import { jsx } from "react/jsx-runtime";
|
|
8
|
-
|
|
15
|
+
// src/client/use-link-status.ts
|
|
9
16
|
/**
|
|
10
17
|
* React context provided by <Link>. Holds the pending status
|
|
11
18
|
* for that specific link's navigation.
|
|
12
19
|
*/
|
|
13
|
-
var LinkStatusContext = createContext({
|
|
20
|
+
var LinkStatusContext = createContext({ isPending: false });
|
|
14
21
|
/**
|
|
15
|
-
* Returns `{
|
|
22
|
+
* Returns `{ isPending: true }` while the nearest parent `<Link>` component's
|
|
16
23
|
* navigation is in flight. Must be used inside a `<Link>` component's children.
|
|
17
24
|
*
|
|
18
|
-
* Unlike `
|
|
25
|
+
* Unlike `usePendingNavigation()` which is global, this hook is scoped to
|
|
19
26
|
* the nearest parent `<Link>` — only the link the user clicked shows pending.
|
|
20
27
|
*
|
|
21
28
|
* ```tsx
|
|
@@ -23,8 +30,8 @@ var LinkStatusContext = createContext({ pending: false });
|
|
|
23
30
|
* import { Link, useLinkStatus } from '@timber-js/app/client'
|
|
24
31
|
*
|
|
25
32
|
* function Hint() {
|
|
26
|
-
* const {
|
|
27
|
-
* return <span className={
|
|
33
|
+
* const { isPending } = useLinkStatus()
|
|
34
|
+
* return <span className={isPending ? 'opacity-50' : ''} />
|
|
28
35
|
* }
|
|
29
36
|
*
|
|
30
37
|
* export function NavLink({ href, children }) {
|
|
@@ -39,251 +46,40 @@ var LinkStatusContext = createContext({ pending: false });
|
|
|
39
46
|
function useLinkStatus() {
|
|
40
47
|
return useContext(LinkStatusContext);
|
|
41
48
|
}
|
|
42
|
-
|
|
43
|
-
//#region src/client/navigation-context.ts
|
|
49
|
+
// src/client/location-search.ts
|
|
44
50
|
/**
|
|
45
|
-
*
|
|
51
|
+
* The app-visible search string from the address bar.
|
|
46
52
|
*
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
* By wrapping the RSC payload element in NavigationProvider inside
|
|
55
|
-
* renderRoot(), the context value and the element tree are passed to
|
|
56
|
-
* reactRoot.render() in the same call — atomic by construction.
|
|
57
|
-
* All consumers (useParams, usePathname) see the new values in the
|
|
58
|
-
* same render pass as the new tree.
|
|
59
|
-
*
|
|
60
|
-
* During SSR, no NavigationProvider is mounted. Hooks fall back to
|
|
61
|
-
* the ALS-backed getSsrData() for per-request isolation.
|
|
62
|
-
*
|
|
63
|
-
* IMPORTANT: createContext and useContext are NOT available in the RSC
|
|
64
|
-
* environment (React Server Components use a stripped-down React).
|
|
65
|
-
* The context is lazily initialized on first access, and all functions
|
|
66
|
-
* that depend on these APIs are safe to call from any environment —
|
|
67
|
-
* they return null or no-op when the APIs aren't available.
|
|
68
|
-
*
|
|
69
|
-
* SINGLETON GUARANTEE: All shared mutable state uses globalThis via
|
|
70
|
-
* Symbol.for keys. The RSC client bundler can duplicate this module
|
|
71
|
-
* across chunks (browser-entry graph + client-reference graph). With
|
|
72
|
-
* ESM output, each chunk gets its own module scope — module-level
|
|
73
|
-
* variables would create separate singleton instances per chunk.
|
|
74
|
-
* globalThis guarantees a single instance regardless of duplication.
|
|
75
|
-
*
|
|
76
|
-
* This workaround will be removed when Rolldown ships `format: 'app'`
|
|
77
|
-
* (module registry format that deduplicates like webpack/Turbopack).
|
|
78
|
-
* See design/27-chunking-strategy.md.
|
|
79
|
-
*
|
|
80
|
-
* See design/19-client-navigation.md §"NavigationContext"
|
|
53
|
+
* Mirrors what `appVisibleSearch()` does on the server: strips key-shaped
|
|
54
|
+
* `_rsc` values so the client and server agree on search state regardless
|
|
55
|
+
* of whether the document URL itself carries a payload cache key (a user
|
|
56
|
+
* pasting/sharing an RSC payload URL). Non-key-shaped `_rsc` values — an
|
|
57
|
+
* application legitimately owning that name — survive, using the same
|
|
58
|
+
* `isRscCacheKeyShape` predicate the server uses.
|
|
81
59
|
*/
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
* level. In the RSC environment, React.createContext doesn't exist —
|
|
85
|
-
* calling it at import time would crash the server.
|
|
86
|
-
*
|
|
87
|
-
* Context instances are stored on globalThis (NOT in module-level
|
|
88
|
-
* variables) because the ESM bundler can duplicate this module across
|
|
89
|
-
* chunks. Module-level variables would create separate instances per
|
|
90
|
-
* chunk — the provider in TransitionRoot (index chunk) would use
|
|
91
|
-
* context A while the consumer in LinkStatusProvider (shared chunk)
|
|
92
|
-
* reads from context B. globalThis guarantees a single instance.
|
|
93
|
-
*
|
|
94
|
-
* See design/27-chunking-strategy.md §"Singleton Safety"
|
|
95
|
-
*/
|
|
96
|
-
var NAV_CTX_KEY = Symbol.for("__timber_nav_ctx");
|
|
97
|
-
var PENDING_CTX_KEY = Symbol.for("__timber_pending_nav_ctx");
|
|
98
|
-
function getOrCreateContext() {
|
|
99
|
-
const existing = globalThis[NAV_CTX_KEY];
|
|
100
|
-
if (existing !== void 0) return existing;
|
|
101
|
-
if (typeof React.createContext === "function") {
|
|
102
|
-
const ctx = React.createContext(null);
|
|
103
|
-
globalThis[NAV_CTX_KEY] = ctx;
|
|
104
|
-
return ctx;
|
|
105
|
-
}
|
|
60
|
+
function locationSearch() {
|
|
61
|
+
return stripRscCacheKey(window.location.search);
|
|
106
62
|
}
|
|
63
|
+
// src/client/link.tsx
|
|
64
|
+
var LINK_PENDING = { isPending: true };
|
|
65
|
+
var LINK_IDLE = { isPending: false };
|
|
107
66
|
/**
|
|
108
|
-
* Read the
|
|
109
|
-
*
|
|
110
|
-
*
|
|
67
|
+
* Read the current URL's search string without requiring a React hook.
|
|
68
|
+
* On the client, reads window.location.search. During SSR, reads the raw
|
|
69
|
+
* query string from the request context (getSsrData) — the same `''` or
|
|
70
|
+
* `?…` shape, preserving repeated keys (`?tag=a&tag=b`) so the
|
|
71
|
+
* server-rendered href matches what the hydrated client rebuilds from the
|
|
72
|
+
* address bar (TIM-1428). Returns empty string if unavailable.
|
|
111
73
|
*/
|
|
112
|
-
function
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
if (typeof React.useContext !== "function") return null;
|
|
116
|
-
return React.useContext(ctx);
|
|
74
|
+
function getCurrentSearch() {
|
|
75
|
+
if (typeof window !== "undefined") return locationSearch();
|
|
76
|
+
return getSsrData()?.search ?? "";
|
|
117
77
|
}
|
|
118
|
-
/**
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
*/
|
|
124
|
-
function NavigationProvider({ value, children }) {
|
|
125
|
-
const ctx = getOrCreateContext();
|
|
126
|
-
if (!ctx) return children;
|
|
127
|
-
return createElement(ctx.Provider, { value }, children);
|
|
128
|
-
}
|
|
129
|
-
/**
|
|
130
|
-
* Navigation state communicated between the router and renderRoot.
|
|
131
|
-
*
|
|
132
|
-
* The router calls setNavigationState() before renderRoot(). The
|
|
133
|
-
* renderRoot callback reads via getNavigationState() to create the
|
|
134
|
-
* NavigationProvider with the correct params/pathname.
|
|
135
|
-
*
|
|
136
|
-
* This is NOT used by hooks directly — hooks read from React context.
|
|
137
|
-
*
|
|
138
|
-
* Stored on globalThis (like the context instances above) because the
|
|
139
|
-
* router lives in one chunk while renderRoot lives in another. Module-
|
|
140
|
-
* level variables would be separate per chunk.
|
|
141
|
-
*/
|
|
142
|
-
var NAV_STATE_KEY = Symbol.for("__timber_nav_state");
|
|
143
|
-
function _getNavStateStore() {
|
|
144
|
-
const g = globalThis;
|
|
145
|
-
if (!g[NAV_STATE_KEY]) g[NAV_STATE_KEY] = { current: {
|
|
146
|
-
params: {},
|
|
147
|
-
pathname: "/"
|
|
148
|
-
} };
|
|
149
|
-
return g[NAV_STATE_KEY];
|
|
150
|
-
}
|
|
151
|
-
function setNavigationState(state) {
|
|
152
|
-
_getNavStateStore().current = state;
|
|
153
|
-
}
|
|
154
|
-
function getNavigationState() {
|
|
155
|
-
return _getNavStateStore().current;
|
|
156
|
-
}
|
|
157
|
-
/**
|
|
158
|
-
* Separate context for the in-flight navigation URL. Provided by
|
|
159
|
-
* TransitionRoot (urgent useState), consumed by LinkStatusProvider
|
|
160
|
-
* and useNavigationPending.
|
|
161
|
-
*
|
|
162
|
-
* Uses globalThis via Symbol.for for the same reason as NavigationContext
|
|
163
|
-
* above — the bundler may duplicate this module across chunks, and module-
|
|
164
|
-
* level variables would create separate context instances.
|
|
165
|
-
*/
|
|
166
|
-
function getOrCreatePendingContext() {
|
|
167
|
-
const existing = globalThis[PENDING_CTX_KEY];
|
|
168
|
-
if (existing !== void 0) return existing;
|
|
169
|
-
if (typeof React.createContext === "function") {
|
|
170
|
-
const ctx = React.createContext(null);
|
|
171
|
-
globalThis[PENDING_CTX_KEY] = ctx;
|
|
172
|
-
return ctx;
|
|
173
|
-
}
|
|
174
|
-
}
|
|
175
|
-
/**
|
|
176
|
-
* Read the pending navigation URL from context.
|
|
177
|
-
* Returns null during SSR (no provider) or in the RSC environment.
|
|
178
|
-
*/
|
|
179
|
-
function usePendingNavigationUrl() {
|
|
180
|
-
const ctx = getOrCreatePendingContext();
|
|
181
|
-
if (!ctx) return null;
|
|
182
|
-
if (typeof React.useContext !== "function") return null;
|
|
183
|
-
return React.useContext(ctx);
|
|
184
|
-
}
|
|
185
|
-
//#endregion
|
|
186
|
-
//#region src/client/link-status-provider.tsx
|
|
187
|
-
var NOT_PENDING = { pending: false };
|
|
188
|
-
var IS_PENDING = { pending: true };
|
|
189
|
-
/**
|
|
190
|
-
* Client component that reads the pending URL from PendingNavigationContext
|
|
191
|
-
* and provides a scoped LinkStatusContext to children. Renders no extra DOM —
|
|
192
|
-
* just a context provider around children.
|
|
193
|
-
*/
|
|
194
|
-
function LinkStatusProvider({ href, children }) {
|
|
195
|
-
const status = usePendingNavigationUrl() === href ? IS_PENDING : NOT_PENDING;
|
|
196
|
-
return /* @__PURE__ */ jsx(LinkStatusContext.Provider, {
|
|
197
|
-
value: status,
|
|
198
|
-
children
|
|
199
|
-
});
|
|
200
|
-
}
|
|
201
|
-
//#endregion
|
|
202
|
-
//#region src/client/router-ref.ts
|
|
203
|
-
/**
|
|
204
|
-
* Set the global router instance. Called once during bootstrap.
|
|
205
|
-
*/
|
|
206
|
-
function setGlobalRouter(router) {
|
|
207
|
-
_setGlobalRouter(router);
|
|
208
|
-
}
|
|
209
|
-
/**
|
|
210
|
-
* Get the global router instance. Throws if called before bootstrap.
|
|
211
|
-
* Used by client-side hooks (useNavigationPending, etc.)
|
|
212
|
-
*/
|
|
213
|
-
function getRouter() {
|
|
214
|
-
if (!globalRouter) throw new Error("[timber] Router not initialized. getRouter() was called before bootstrap().");
|
|
215
|
-
return globalRouter;
|
|
216
|
-
}
|
|
217
|
-
/**
|
|
218
|
-
* Get the global router instance or null if not yet initialized.
|
|
219
|
-
* Used by useRouter() methods to avoid silent failures — callers
|
|
220
|
-
* can log a meaningful warning instead of silently no-oping.
|
|
221
|
-
*/
|
|
222
|
-
function getRouterOrNull() {
|
|
223
|
-
return globalRouter;
|
|
224
|
-
}
|
|
225
|
-
//#endregion
|
|
226
|
-
//#region src/client/link.tsx
|
|
227
|
-
/**
|
|
228
|
-
* Reject dangerous URL schemes that could execute script.
|
|
229
|
-
* Security: design/13-security.md § Link scheme injection (test #9)
|
|
230
|
-
*/
|
|
231
|
-
var DANGEROUS_SCHEMES = /^\s*(javascript|data|vbscript):/i;
|
|
232
|
-
function validateLinkHref(href) {
|
|
233
|
-
if (DANGEROUS_SCHEMES.test(href)) throw new Error(`<Link> received a dangerous href: "${href}". javascript:, data:, and vbscript: URLs are not allowed.`);
|
|
234
|
-
}
|
|
235
|
-
/** Returns true if the href is an internal path (not an external URL) */
|
|
236
|
-
function isInternalHref(href) {
|
|
237
|
-
if (href.startsWith("/") || href.startsWith("#") || href.startsWith("?")) return true;
|
|
238
|
-
if (/^[a-z][a-z0-9+.-]*:/i.test(href)) return false;
|
|
239
|
-
return true;
|
|
240
|
-
}
|
|
241
|
-
/**
|
|
242
|
-
* Interpolate dynamic segments in a route pattern with actual values.
|
|
243
|
-
* e.g. interpolateParams("/products/[id]", { id: "123" }) → "/products/123"
|
|
244
|
-
*
|
|
245
|
-
* Supports:
|
|
246
|
-
* - [param] → single segment
|
|
247
|
-
* - [...param] → catch-all (joined with /)
|
|
248
|
-
* - [[...param]] → optional catch-all (omitted if undefined/empty)
|
|
249
|
-
*/
|
|
250
|
-
function interpolateParams(pattern, params) {
|
|
251
|
-
return pattern.replace(/\[\[\.\.\.(\w+)\]\]|\[\.\.\.(\w+)\]|\[(\w+)\]/g, (_match, optionalCatchAll, catchAll, single) => {
|
|
252
|
-
if (optionalCatchAll) {
|
|
253
|
-
const value = params[optionalCatchAll];
|
|
254
|
-
if (value === void 0 || Array.isArray(value) && value.length === 0) return "";
|
|
255
|
-
return (Array.isArray(value) ? value : [value]).map(encodeURIComponent).join("/");
|
|
256
|
-
}
|
|
257
|
-
if (catchAll) {
|
|
258
|
-
const value = params[catchAll];
|
|
259
|
-
if (value === void 0) throw new Error(`<Link> missing required catch-all param "${catchAll}" for pattern "${pattern}".`);
|
|
260
|
-
const segments = Array.isArray(value) ? value : [value];
|
|
261
|
-
if (segments.length === 0) throw new Error(`<Link> catch-all param "${catchAll}" must have at least one segment for pattern "${pattern}".`);
|
|
262
|
-
return segments.map(encodeURIComponent).join("/");
|
|
263
|
-
}
|
|
264
|
-
const value = params[single];
|
|
265
|
-
if (value === void 0) throw new Error(`<Link> missing required param "${single}" for pattern "${pattern}".`);
|
|
266
|
-
if (Array.isArray(value)) throw new Error(`<Link> param "${single}" expected a string but received an array for pattern "${pattern}".`);
|
|
267
|
-
return encodeURIComponent(String(value));
|
|
268
|
-
}).replace(/\/+$/, "") || "/";
|
|
269
|
-
}
|
|
270
|
-
/**
|
|
271
|
-
* Resolve the final href string from Link props.
|
|
272
|
-
*
|
|
273
|
-
* Handles:
|
|
274
|
-
* - params interpolation into route patterns
|
|
275
|
-
* - searchParams serialization via SearchParamsDefinition
|
|
276
|
-
* - Validation that searchParams and inline query strings are exclusive
|
|
277
|
-
*/
|
|
278
|
-
function resolveHref(href, params, searchParams) {
|
|
279
|
-
let resolvedPath = href;
|
|
280
|
-
if (params) resolvedPath = interpolateParams(href, params);
|
|
281
|
-
if (searchParams) {
|
|
282
|
-
if (resolvedPath.includes("?")) throw new Error("<Link> received both a searchParams prop and a query string in href. These are mutually exclusive — use one or the other.");
|
|
283
|
-
const qs = searchParams.definition.serialize(searchParams.values);
|
|
284
|
-
if (qs) resolvedPath = `${resolvedPath}?${qs}`;
|
|
285
|
-
}
|
|
286
|
-
return resolvedPath;
|
|
78
|
+
/** Native in-page scrolling needs neither an RSC navigation nor a prefetch. */
|
|
79
|
+
function isNativeFragmentLink(anchor) {
|
|
80
|
+
const href = anchor.href;
|
|
81
|
+
const hashIndex = href.indexOf("#");
|
|
82
|
+
return hashIndex !== -1 && href.slice(0, hashIndex) === window.location.href.split("#", 1)[0];
|
|
287
83
|
}
|
|
288
84
|
/**
|
|
289
85
|
* Build the HTML attributes for a Link. Separated from the component
|
|
@@ -291,7 +87,7 @@ function resolveHref(href, params, searchParams) {
|
|
|
291
87
|
*/
|
|
292
88
|
function buildLinkProps(props) {
|
|
293
89
|
const resolvedHref = resolveHref(props.href, props.params, props.searchParams);
|
|
294
|
-
|
|
90
|
+
validateNavigationHref(resolvedHref);
|
|
295
91
|
return { href: resolvedHref };
|
|
296
92
|
}
|
|
297
93
|
/**
|
|
@@ -323,20 +119,32 @@ function shouldInterceptClick(event, resolvedHref) {
|
|
|
323
119
|
* navigation via the router. No global event delegation — each Link owns
|
|
324
120
|
* its own click handling.
|
|
325
121
|
*
|
|
326
|
-
* Supports typed routes via
|
|
327
|
-
*
|
|
122
|
+
* Supports typed routes via the Routes interface (populated by codegen).
|
|
123
|
+
* At runtime:
|
|
124
|
+
* - `segmentParams` prop interpolates dynamic segments in the href pattern
|
|
328
125
|
* - `searchParams` prop serializes query parameters via a SearchParamsDefinition
|
|
126
|
+
*
|
|
127
|
+
* Typed via the LinkFunction callable interface. The base call signature
|
|
128
|
+
* forbids segmentParams; per-route signatures are added by codegen via
|
|
129
|
+
* interface merging. See TIM-624.
|
|
329
130
|
*/
|
|
330
|
-
|
|
331
|
-
const { href:
|
|
131
|
+
var Link = function LinkImpl(props) {
|
|
132
|
+
const { href, prefetch, scroll, replace, segmentParams, searchParams, preserveSearchParams, onNavigate, transitionTypes, onClick: userOnClick, onMouseEnter: userOnMouseEnter, children, ...rest } = props;
|
|
133
|
+
const { href: baseHref } = buildLinkProps({
|
|
332
134
|
href,
|
|
333
|
-
params,
|
|
135
|
+
params: segmentParams,
|
|
334
136
|
searchParams
|
|
335
137
|
});
|
|
336
|
-
const
|
|
138
|
+
const [isPending, setIsPending] = useState(false);
|
|
139
|
+
const clickSeq = useRef(0);
|
|
140
|
+
const linkStatus = isPending ? LINK_PENDING : LINK_IDLE;
|
|
141
|
+
const internal = isInternalHref(baseHref);
|
|
142
|
+
const resolvedHref = preserveSearchParams && internal ? mergePreservedSearchParams(baseHref, getCurrentSearch(), preserveSearchParams) : baseHref;
|
|
143
|
+
const resolveEventUrl = () => new URL(preserveSearchParams ? mergePreservedSearchParams(baseHref, getCurrentSearch(), preserveSearchParams) : resolvedHref, window.location.href);
|
|
337
144
|
const handleClick = internal ? (event) => {
|
|
338
145
|
userOnClick?.(event);
|
|
339
146
|
if (!shouldInterceptClick(event, resolvedHref)) return;
|
|
147
|
+
if (isNativeFragmentLink(event.currentTarget)) return;
|
|
340
148
|
if (onNavigate) {
|
|
341
149
|
let prevented = false;
|
|
342
150
|
onNavigate({ preventDefault: () => {
|
|
@@ -349,829 +157,47 @@ function Link({ href, prefetch, scroll, params, searchParams, onNavigate, onClic
|
|
|
349
157
|
}
|
|
350
158
|
const router = getRouterOrNull();
|
|
351
159
|
if (!router) return;
|
|
160
|
+
const resolved = resolveEventUrl();
|
|
161
|
+
if (isNativeFragmentLink(event.currentTarget)) return;
|
|
352
162
|
event.preventDefault();
|
|
353
163
|
const shouldScroll = scroll !== false;
|
|
354
|
-
|
|
164
|
+
const absoluteHref = resolved.pathname + stripRscCacheKey(resolved.search) + resolved.hash;
|
|
165
|
+
const seq = ++clickSeq.current;
|
|
166
|
+
const clear = () => {
|
|
167
|
+
if (clickSeq.current === seq) flushSync(() => setIsPending(false));
|
|
168
|
+
};
|
|
169
|
+
setIsPending(true);
|
|
170
|
+
const navigation = router.navigate(absoluteHref, {
|
|
171
|
+
scroll: shouldScroll,
|
|
172
|
+
replace,
|
|
173
|
+
transitionTypes
|
|
174
|
+
});
|
|
175
|
+
Promise.all([navigation, navigation.committed]).then(clear, (error) => {
|
|
176
|
+
clear();
|
|
177
|
+
throw error;
|
|
178
|
+
});
|
|
355
179
|
} : userOnClick;
|
|
356
180
|
const handleMouseEnter = internal && prefetch ? (event) => {
|
|
357
181
|
userOnMouseEnter?.(event);
|
|
358
182
|
const router = getRouterOrNull();
|
|
359
|
-
if (router)
|
|
183
|
+
if (router) {
|
|
184
|
+
if (isNativeFragmentLink(event.currentTarget)) return;
|
|
185
|
+
const resolved = resolveEventUrl();
|
|
186
|
+
router.prefetch(resolved.pathname + stripRscCacheKey(resolved.search));
|
|
187
|
+
}
|
|
360
188
|
} : userOnMouseEnter;
|
|
361
189
|
return /* @__PURE__ */ jsx("a", {
|
|
362
190
|
...rest,
|
|
363
191
|
href: resolvedHref,
|
|
364
192
|
onClick: handleClick,
|
|
365
193
|
onMouseEnter: handleMouseEnter,
|
|
366
|
-
children: /* @__PURE__ */ jsx(
|
|
367
|
-
|
|
194
|
+
children: /* @__PURE__ */ jsx(LinkStatusContext.Provider, {
|
|
195
|
+
value: linkStatus,
|
|
368
196
|
children
|
|
369
197
|
})
|
|
370
198
|
});
|
|
371
|
-
}
|
|
372
|
-
//#endregion
|
|
373
|
-
//#region src/client/segment-cache.ts
|
|
374
|
-
/**
|
|
375
|
-
* Maintains the client-side segment tree representing currently mounted
|
|
376
|
-
* layouts and pages. Used for navigation reconciliation — the router diffs
|
|
377
|
-
* new routes against this tree to determine which segments to re-fetch.
|
|
378
|
-
*/
|
|
379
|
-
var SegmentCache = class {
|
|
380
|
-
root;
|
|
381
|
-
get(segment) {
|
|
382
|
-
if (segment === "/" || segment === this.root?.segment) return this.root;
|
|
383
|
-
}
|
|
384
|
-
set(segment, node) {
|
|
385
|
-
if (segment === "/" || !this.root) this.root = node;
|
|
386
|
-
}
|
|
387
|
-
clear() {
|
|
388
|
-
this.root = void 0;
|
|
389
|
-
}
|
|
390
|
-
/**
|
|
391
|
-
* Serialize the mounted segment tree for the X-Timber-State-Tree header.
|
|
392
|
-
* Only includes sync segments — async segments are excluded because the
|
|
393
|
-
* server must always re-render them (they may depend on request context).
|
|
394
|
-
*
|
|
395
|
-
* When mergeableFilter is provided, only segments whose paths are in the
|
|
396
|
-
* set are included. This ensures the server only skips segments that the
|
|
397
|
-
* client can actually merge (i.e., segments whose cached element tree
|
|
398
|
-
* contains an inner SegmentProvider the merger can splice into).
|
|
399
|
-
*
|
|
400
|
-
* This is a performance optimization only, NOT a security boundary.
|
|
401
|
-
* The server always runs all access.ts files regardless of the state tree.
|
|
402
|
-
*/
|
|
403
|
-
serializeStateTree(mergeableFilter) {
|
|
404
|
-
const segments = [];
|
|
405
|
-
if (this.root) collectSyncSegments(this.root, segments, mergeableFilter);
|
|
406
|
-
return { segments };
|
|
407
|
-
}
|
|
408
|
-
};
|
|
409
|
-
/** Recursively collect sync segment paths from the tree */
|
|
410
|
-
function collectSyncSegments(node, out, mergeableFilter) {
|
|
411
|
-
if (!node.isAsync && (!mergeableFilter || mergeableFilter.has(node.segment))) out.push(node.segment);
|
|
412
|
-
for (const child of node.children.values()) collectSyncSegments(child, out, mergeableFilter);
|
|
413
|
-
}
|
|
414
|
-
/**
|
|
415
|
-
* Build a SegmentNode tree from flat segment metadata.
|
|
416
|
-
*
|
|
417
|
-
* Takes an ordered list of segment descriptors (root → leaf) from the
|
|
418
|
-
* server's X-Timber-Segments header and constructs the hierarchical
|
|
419
|
-
* tree structure that SegmentCache expects.
|
|
420
|
-
*
|
|
421
|
-
* Each segment is nested as a child of the previous one, forming a
|
|
422
|
-
* linear chain from root to leaf. The leaf segment (page) is excluded
|
|
423
|
-
* from the tree — pages are never cached across navigations.
|
|
424
|
-
*/
|
|
425
|
-
function buildSegmentTree(segments) {
|
|
426
|
-
if (segments.length === 0) return void 0;
|
|
427
|
-
const layouts = segments.length > 1 ? segments.slice(0, -1) : segments;
|
|
428
|
-
let root;
|
|
429
|
-
let parent;
|
|
430
|
-
for (const info of layouts) {
|
|
431
|
-
const node = {
|
|
432
|
-
segment: info.path,
|
|
433
|
-
payload: null,
|
|
434
|
-
isAsync: info.isAsync,
|
|
435
|
-
children: /* @__PURE__ */ new Map()
|
|
436
|
-
};
|
|
437
|
-
if (!root) root = node;
|
|
438
|
-
if (parent) parent.children.set(info.path, node);
|
|
439
|
-
parent = node;
|
|
440
|
-
}
|
|
441
|
-
return root;
|
|
442
|
-
}
|
|
443
|
-
/**
|
|
444
|
-
* Short-lived cache for hover-triggered prefetches. Entries expire after
|
|
445
|
-
* 30 seconds. When a link is clicked, the prefetched payload is consumed
|
|
446
|
-
* (moved to the history stack) and removed from this cache.
|
|
447
|
-
*
|
|
448
|
-
* timber.js does NOT prefetch on viewport intersection — only explicit
|
|
449
|
-
* hover on <Link prefetch> triggers a prefetch.
|
|
450
|
-
*/
|
|
451
|
-
var PrefetchCache = class PrefetchCache {
|
|
452
|
-
static TTL_MS = 3e4;
|
|
453
|
-
entries = /* @__PURE__ */ new Map();
|
|
454
|
-
set(url, result) {
|
|
455
|
-
this.entries.set(url, {
|
|
456
|
-
result,
|
|
457
|
-
expiresAt: Date.now() + PrefetchCache.TTL_MS
|
|
458
|
-
});
|
|
459
|
-
}
|
|
460
|
-
get(url) {
|
|
461
|
-
const entry = this.entries.get(url);
|
|
462
|
-
if (!entry) return void 0;
|
|
463
|
-
if (Date.now() >= entry.expiresAt) {
|
|
464
|
-
this.entries.delete(url);
|
|
465
|
-
return;
|
|
466
|
-
}
|
|
467
|
-
return entry.result;
|
|
468
|
-
}
|
|
469
|
-
/** Get and remove the entry (used when navigation consumes a prefetch) */
|
|
470
|
-
consume(url) {
|
|
471
|
-
const result = this.get(url);
|
|
472
|
-
if (result !== void 0) this.entries.delete(url);
|
|
473
|
-
return result;
|
|
474
|
-
}
|
|
475
|
-
};
|
|
476
|
-
//#endregion
|
|
477
|
-
//#region src/client/history.ts
|
|
478
|
-
/**
|
|
479
|
-
* Session-lived history stack keyed by URL. Enables instant back/forward
|
|
480
|
-
* navigation without a server roundtrip.
|
|
481
|
-
*
|
|
482
|
-
* On forward navigation, the new page's payload is pushed onto the stack.
|
|
483
|
-
* On popstate, the cached payload is replayed instantly.
|
|
484
|
-
*
|
|
485
|
-
* Scroll positions are stored in history.state (browser History API),
|
|
486
|
-
* not in this stack — see design/19-client-navigation.md §Scroll Restoration.
|
|
487
|
-
*
|
|
488
|
-
* Entries persist for the session duration (no expiry) and are cleared
|
|
489
|
-
* when the tab is closed — matching browser back-button behavior.
|
|
490
|
-
*/
|
|
491
|
-
var HistoryStack = class {
|
|
492
|
-
entries = /* @__PURE__ */ new Map();
|
|
493
|
-
push(url, entry) {
|
|
494
|
-
this.entries.set(url, entry);
|
|
495
|
-
}
|
|
496
|
-
get(url) {
|
|
497
|
-
return this.entries.get(url);
|
|
498
|
-
}
|
|
499
|
-
has(url) {
|
|
500
|
-
return this.entries.has(url);
|
|
501
|
-
}
|
|
502
|
-
};
|
|
503
|
-
//#endregion
|
|
504
|
-
//#region src/client/use-params.ts
|
|
505
|
-
/**
|
|
506
|
-
* Set the current route params in the module-level store.
|
|
507
|
-
*
|
|
508
|
-
* Called by the router on each navigation. This updates the fallback
|
|
509
|
-
* snapshot used by tests and by the hook when called outside a React
|
|
510
|
-
* component (no NavigationContext available).
|
|
511
|
-
*
|
|
512
|
-
* On the client, the primary reactivity path is NavigationContext —
|
|
513
|
-
* the router calls setNavigationState() then renderRoot() which wraps
|
|
514
|
-
* the element in NavigationProvider. setCurrentParams is still called
|
|
515
|
-
* for the module-level fallback.
|
|
516
|
-
*
|
|
517
|
-
* During SSR, params are also available via getSsrData().params
|
|
518
|
-
* (ALS-backed).
|
|
519
|
-
*/
|
|
520
|
-
function setCurrentParams(params) {
|
|
521
|
-
_setCurrentParams(params);
|
|
522
|
-
}
|
|
523
|
-
function useParams(_route) {
|
|
524
|
-
try {
|
|
525
|
-
const navContext = useNavigationContext();
|
|
526
|
-
if (navContext !== null) return navContext.params;
|
|
527
|
-
} catch {}
|
|
528
|
-
return getSsrData()?.params ?? currentParams;
|
|
529
|
-
}
|
|
530
|
-
//#endregion
|
|
531
|
-
//#region src/client/segment-merger.ts
|
|
532
|
-
/**
|
|
533
|
-
* Segment Merger — client-side tree merging for partial RSC payloads.
|
|
534
|
-
*
|
|
535
|
-
* When the server skips rendering sync layouts (because the client already
|
|
536
|
-
* has them cached), the RSC payload is missing outer segment wrappers.
|
|
537
|
-
* This module reconstructs the full element tree by splicing the partial
|
|
538
|
-
* payload into cached segment subtrees.
|
|
539
|
-
*
|
|
540
|
-
* The approach:
|
|
541
|
-
* 1. After each full RSC payload render, walk the decoded element tree
|
|
542
|
-
* and cache each segment's subtree (identified by SegmentProvider boundaries)
|
|
543
|
-
* 2. When a partial payload arrives, wrap it with cached segment elements
|
|
544
|
-
* using React.cloneElement to preserve component identity
|
|
545
|
-
*
|
|
546
|
-
* React.cloneElement preserves the element's `type` — React sees the same
|
|
547
|
-
* component at the same tree position and reconciles (preserving state)
|
|
548
|
-
* rather than remounting. This is how layout state survives navigations.
|
|
549
|
-
*
|
|
550
|
-
* Design docs: 19-client-navigation.md §"Navigation Reconciliation"
|
|
551
|
-
* Security: access.ts runs on the server regardless of skipping — this
|
|
552
|
-
* is a performance optimization only. See 13-security.md.
|
|
553
|
-
*/
|
|
554
|
-
/**
|
|
555
|
-
* Cache of React element subtrees per segment path.
|
|
556
|
-
* Updated after each navigation with the full decoded RSC element tree.
|
|
557
|
-
*/
|
|
558
|
-
var SegmentElementCache = class {
|
|
559
|
-
entries = /* @__PURE__ */ new Map();
|
|
560
|
-
get(segmentPath) {
|
|
561
|
-
return this.entries.get(segmentPath);
|
|
562
|
-
}
|
|
563
|
-
set(segmentPath, entry) {
|
|
564
|
-
this.entries.set(segmentPath, entry);
|
|
565
|
-
}
|
|
566
|
-
has(segmentPath) {
|
|
567
|
-
return this.entries.has(segmentPath);
|
|
568
|
-
}
|
|
569
|
-
clear() {
|
|
570
|
-
this.entries.clear();
|
|
571
|
-
}
|
|
572
|
-
get size() {
|
|
573
|
-
return this.entries.size;
|
|
574
|
-
}
|
|
575
|
-
/**
|
|
576
|
-
* Get the set of segment paths that are safe for the server to skip.
|
|
577
|
-
* Only segments with an inner SegmentProvider (hasMergeableChild) are
|
|
578
|
-
* included — the merger can only replace inner SegmentProviders, not
|
|
579
|
-
* pages embedded in layout output. Used to filter the state tree.
|
|
580
|
-
*
|
|
581
|
-
* Returns an empty set if the element cache is empty (no elements
|
|
582
|
-
* cached yet). This is the safe default — an empty set means no
|
|
583
|
-
* segments pass the filter, so the state tree is empty and the server
|
|
584
|
-
* does a full render. The element cache is populated lazily after the
|
|
585
|
-
* first SPA navigation (RSC-decoded elements from hydration are
|
|
586
|
-
* thenables that can't be walked until React resolves them).
|
|
587
|
-
*/
|
|
588
|
-
getMergeablePaths() {
|
|
589
|
-
const paths = /* @__PURE__ */ new Set();
|
|
590
|
-
for (const [, entry] of this.entries) if (entry.hasMergeableChild) paths.add(entry.segmentPath);
|
|
591
|
-
return paths;
|
|
592
|
-
}
|
|
593
|
-
};
|
|
594
|
-
/**
|
|
595
|
-
* Check if a React element is a SegmentProvider by looking for the
|
|
596
|
-
* `segments` prop (an array of path segments). This is the only
|
|
597
|
-
* component that receives this prop shape.
|
|
598
|
-
*/
|
|
599
|
-
function isSegmentProvider(element) {
|
|
600
|
-
if (!isValidElement(element)) return false;
|
|
601
|
-
const props = element.props;
|
|
602
|
-
return Array.isArray(props.segments);
|
|
603
|
-
}
|
|
604
|
-
/**
|
|
605
|
-
* Extract the segment path from a SegmentProvider element.
|
|
606
|
-
*
|
|
607
|
-
* Uses the `segmentId` prop if available (set by the server for route groups
|
|
608
|
-
* to distinguish siblings that share the same urlPath). Falls back to
|
|
609
|
-
* reconstructing from the `segments` array prop.
|
|
610
|
-
*/
|
|
611
|
-
function getSegmentPath(element) {
|
|
612
|
-
const props = element.props;
|
|
613
|
-
if (props.segmentId) return props.segmentId;
|
|
614
|
-
const filtered = props.segments.filter(Boolean);
|
|
615
|
-
return filtered.length === 0 ? "/" : "/" + filtered.join("/");
|
|
616
|
-
}
|
|
617
|
-
/**
|
|
618
|
-
* Walk a React element tree and extract all SegmentProvider boundaries.
|
|
619
|
-
* Returns an ordered list of segment entries from outermost to innermost.
|
|
620
|
-
*
|
|
621
|
-
* This only finds SegmentProviders along the main children path — it does
|
|
622
|
-
* not descend into parallel routes/slots (those are separate subtrees).
|
|
623
|
-
*/
|
|
624
|
-
function extractSegments(element) {
|
|
625
|
-
const segments = [];
|
|
626
|
-
walkForSegments(element, segments);
|
|
627
|
-
for (let i = 0; i < segments.length; i++) segments[i].hasMergeableChild = i < segments.length - 1;
|
|
628
|
-
return segments;
|
|
629
|
-
}
|
|
630
|
-
function walkForSegments(node, out) {
|
|
631
|
-
if (!isValidElement(node)) return;
|
|
632
|
-
const el = node;
|
|
633
|
-
const props = el.props;
|
|
634
|
-
if (isSegmentProvider(node)) {
|
|
635
|
-
out.push({
|
|
636
|
-
segmentPath: getSegmentPath(el),
|
|
637
|
-
element: el,
|
|
638
|
-
hasMergeableChild: false
|
|
639
|
-
});
|
|
640
|
-
walkChildren(props.children, out);
|
|
641
|
-
return;
|
|
642
|
-
}
|
|
643
|
-
walkChildren(props.children, out);
|
|
644
|
-
}
|
|
645
|
-
function walkChildren(children, out) {
|
|
646
|
-
if (children == null) return;
|
|
647
|
-
if (Array.isArray(children)) for (const child of children) walkForSegments(child, out);
|
|
648
|
-
else walkForSegments(children, out);
|
|
649
|
-
}
|
|
650
|
-
/**
|
|
651
|
-
* Cache all segment subtrees from a fully-rendered RSC element tree.
|
|
652
|
-
* Call this after every full RSC payload render (navigate, refresh, hydration).
|
|
653
|
-
*/
|
|
654
|
-
function cacheSegmentElements(element, cache) {
|
|
655
|
-
const segments = extractSegments(element);
|
|
656
|
-
for (const entry of segments) cache.set(entry.segmentPath, entry);
|
|
657
|
-
}
|
|
658
|
-
function findSegmentProviderPath(node, targetPath) {
|
|
659
|
-
const children = node.props.children;
|
|
660
|
-
if (children == null) return null;
|
|
661
|
-
if (Array.isArray(children)) for (let i = 0; i < children.length; i++) {
|
|
662
|
-
const child = children[i];
|
|
663
|
-
if (!isValidElement(child)) continue;
|
|
664
|
-
if (isSegmentProvider(child)) {
|
|
665
|
-
if (!targetPath || getSegmentPath(child) === targetPath) return [{
|
|
666
|
-
element: node,
|
|
667
|
-
childIndex: i
|
|
668
|
-
}];
|
|
669
|
-
}
|
|
670
|
-
const deeper = findSegmentProviderPath(child, targetPath);
|
|
671
|
-
if (deeper) return [{
|
|
672
|
-
element: node,
|
|
673
|
-
childIndex: i
|
|
674
|
-
}, ...deeper];
|
|
675
|
-
}
|
|
676
|
-
else if (isValidElement(children)) {
|
|
677
|
-
if (isSegmentProvider(children)) {
|
|
678
|
-
if (!targetPath || getSegmentPath(children) === targetPath) return [{
|
|
679
|
-
element: node,
|
|
680
|
-
childIndex: -1
|
|
681
|
-
}];
|
|
682
|
-
}
|
|
683
|
-
const deeper = findSegmentProviderPath(children, targetPath);
|
|
684
|
-
if (deeper) return [{
|
|
685
|
-
element: node,
|
|
686
|
-
childIndex: -1
|
|
687
|
-
}, ...deeper];
|
|
688
|
-
}
|
|
689
|
-
return null;
|
|
690
|
-
}
|
|
691
|
-
/**
|
|
692
|
-
* Replace a nested SegmentProvider within a cached element tree with
|
|
693
|
-
* new content. Uses cloneElement along the path to produce a new tree
|
|
694
|
-
* with preserved component identity at every level except the replaced node.
|
|
695
|
-
*
|
|
696
|
-
* @param cachedElement The cached SegmentProvider element for this segment
|
|
697
|
-
* @param newInnerContent The new React element to splice in at the inner segment position
|
|
698
|
-
* @param innerSegmentPath The path of the inner segment to replace (optional — replaces first found)
|
|
699
|
-
* @returns New element tree with the inner segment replaced
|
|
700
|
-
*/
|
|
701
|
-
function replaceInnerSegment(cachedElement, newInnerContent, innerSegmentPath) {
|
|
702
|
-
const path = findSegmentProviderPath(cachedElement, innerSegmentPath);
|
|
703
|
-
if (!path || path.length === 0) return cachedElement;
|
|
704
|
-
let replacement = newInnerContent;
|
|
705
|
-
for (let i = path.length - 1; i >= 0; i--) {
|
|
706
|
-
const { element, childIndex } = path[i];
|
|
707
|
-
if (childIndex === -1) replacement = cloneElement(element, {}, replacement);
|
|
708
|
-
else {
|
|
709
|
-
const newChildren = [...element.props.children];
|
|
710
|
-
newChildren[childIndex] = replacement;
|
|
711
|
-
replacement = cloneElement(element, {}, ...newChildren);
|
|
712
|
-
}
|
|
713
|
-
}
|
|
714
|
-
return replacement;
|
|
715
|
-
}
|
|
716
|
-
/**
|
|
717
|
-
* Merge a partial RSC payload with cached segment elements.
|
|
718
|
-
*
|
|
719
|
-
* When the server skips segments, the partial payload starts from the
|
|
720
|
-
* first non-skipped segment. This function wraps it with cached elements
|
|
721
|
-
* for the skipped segments, producing a full tree that React can
|
|
722
|
-
* reconcile with the mounted tree (preserving layout state).
|
|
723
|
-
*
|
|
724
|
-
* @param partialPayload The RSC payload element (may be partial)
|
|
725
|
-
* @param skippedSegments Ordered list of segment paths that were skipped (outermost first)
|
|
726
|
-
* @param cache The segment element cache
|
|
727
|
-
* @returns The merged full element tree, or the partial payload if merging isn't possible
|
|
728
|
-
*/
|
|
729
|
-
function mergeSegmentTree(partialPayload, skippedSegments, cache) {
|
|
730
|
-
if (!isValidElement(partialPayload)) return partialPayload;
|
|
731
|
-
if (skippedSegments.length === 0) return partialPayload;
|
|
732
|
-
let result = partialPayload;
|
|
733
|
-
for (let i = skippedSegments.length - 1; i >= 0; i--) {
|
|
734
|
-
const segmentPath = skippedSegments[i];
|
|
735
|
-
const cached = cache.get(segmentPath);
|
|
736
|
-
if (!cached) return partialPayload;
|
|
737
|
-
result = replaceInnerSegment(cached.element, result);
|
|
738
|
-
}
|
|
739
|
-
return result;
|
|
740
|
-
}
|
|
741
|
-
//#endregion
|
|
742
|
-
//#region src/client/rsc-fetch.ts
|
|
743
|
-
var RSC_CONTENT_TYPE = "text/x-component";
|
|
744
|
-
/**
|
|
745
|
-
* Generate a short random cache-busting ID (5 chars, a-z0-9).
|
|
746
|
-
* Matches the format Next.js uses for _rsc params.
|
|
747
|
-
*/
|
|
748
|
-
function generateCacheBustId() {
|
|
749
|
-
const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
|
|
750
|
-
let id = "";
|
|
751
|
-
for (let i = 0; i < 5; i++) id += chars[Math.random() * 36 | 0];
|
|
752
|
-
return id;
|
|
753
|
-
}
|
|
754
|
-
/**
|
|
755
|
-
* Append a `_rsc=<id>` query parameter to the URL.
|
|
756
|
-
* Follows Next.js's pattern — prevents CDN/browser from serving cached HTML
|
|
757
|
-
* for RSC navigation requests and signals that this is an RSC fetch.
|
|
758
|
-
*/
|
|
759
|
-
function appendRscParam(url) {
|
|
760
|
-
return `${url}${url.includes("?") ? "&" : "?"}_rsc=${generateCacheBustId()}`;
|
|
761
|
-
}
|
|
762
|
-
function buildRscHeaders(stateTree, currentUrl) {
|
|
763
|
-
const headers = { Accept: RSC_CONTENT_TYPE };
|
|
764
|
-
if (stateTree) headers["X-Timber-State-Tree"] = JSON.stringify(stateTree);
|
|
765
|
-
if (currentUrl) headers["X-Timber-URL"] = currentUrl;
|
|
766
|
-
return headers;
|
|
767
|
-
}
|
|
768
|
-
/**
|
|
769
|
-
* Extract head elements from the X-Timber-Head response header.
|
|
770
|
-
* Returns null if the header is missing or malformed.
|
|
771
|
-
*/
|
|
772
|
-
function extractHeadElements(response) {
|
|
773
|
-
const header = response.headers.get("X-Timber-Head");
|
|
774
|
-
if (!header) return null;
|
|
775
|
-
try {
|
|
776
|
-
return JSON.parse(decodeURIComponent(header));
|
|
777
|
-
} catch {
|
|
778
|
-
return null;
|
|
779
|
-
}
|
|
780
|
-
}
|
|
781
|
-
/**
|
|
782
|
-
* Extract segment metadata from the X-Timber-Segments response header.
|
|
783
|
-
* Returns null if the header is missing or malformed.
|
|
784
|
-
*
|
|
785
|
-
* Format: JSON array of {path, isAsync} objects describing the rendered
|
|
786
|
-
* segment chain from root to leaf. Used to populate the client-side
|
|
787
|
-
* segment cache for state tree diffing on subsequent navigations.
|
|
788
|
-
*/
|
|
789
|
-
function extractSegmentInfo(response) {
|
|
790
|
-
const header = response.headers.get("X-Timber-Segments");
|
|
791
|
-
if (!header) return null;
|
|
792
|
-
try {
|
|
793
|
-
return JSON.parse(header);
|
|
794
|
-
} catch {
|
|
795
|
-
return null;
|
|
796
|
-
}
|
|
797
|
-
}
|
|
798
|
-
/**
|
|
799
|
-
* Extract skipped segment paths from the X-Timber-Skipped-Segments header.
|
|
800
|
-
* Returns null if the header is missing or malformed.
|
|
801
|
-
*
|
|
802
|
-
* When the server skips sync layouts the client already has cached,
|
|
803
|
-
* it sends this header listing the skipped segment paths (outermost first).
|
|
804
|
-
* The client uses this to merge the partial payload with cached segments.
|
|
805
|
-
*/
|
|
806
|
-
function extractSkippedSegments(response) {
|
|
807
|
-
const header = response.headers.get("X-Timber-Skipped-Segments");
|
|
808
|
-
if (!header) return null;
|
|
809
|
-
try {
|
|
810
|
-
const parsed = JSON.parse(header);
|
|
811
|
-
return Array.isArray(parsed) ? parsed : null;
|
|
812
|
-
} catch {
|
|
813
|
-
return null;
|
|
814
|
-
}
|
|
815
|
-
}
|
|
816
|
-
/**
|
|
817
|
-
* Extract route params from the X-Timber-Params response header.
|
|
818
|
-
* Returns null if the header is missing or malformed.
|
|
819
|
-
*
|
|
820
|
-
* Used to populate useParams() after client-side navigation.
|
|
821
|
-
*/
|
|
822
|
-
function extractParams(response) {
|
|
823
|
-
const header = response.headers.get("X-Timber-Params");
|
|
824
|
-
if (!header) return null;
|
|
825
|
-
try {
|
|
826
|
-
return JSON.parse(header);
|
|
827
|
-
} catch {
|
|
828
|
-
return null;
|
|
829
|
-
}
|
|
830
|
-
}
|
|
831
|
-
/**
|
|
832
|
-
* Thrown when an RSC payload response contains X-Timber-Redirect header.
|
|
833
|
-
* Caught in navigate() to trigger a soft router navigation to the redirect target.
|
|
834
|
-
*/
|
|
835
|
-
var RedirectError = class extends Error {
|
|
836
|
-
redirectUrl;
|
|
837
|
-
constructor(url) {
|
|
838
|
-
super(`Server redirect to ${url}`);
|
|
839
|
-
this.redirectUrl = url;
|
|
840
|
-
}
|
|
841
199
|
};
|
|
842
|
-
|
|
843
|
-
* Fetch an RSC payload from the server. If a decodeRsc function is provided,
|
|
844
|
-
* the response is decoded into a React element tree via createFromFetch.
|
|
845
|
-
* Otherwise, the raw response text is returned (test mode).
|
|
846
|
-
*
|
|
847
|
-
* Also extracts head elements from the X-Timber-Head response header
|
|
848
|
-
* so the client can update document.title and <meta> tags after navigation.
|
|
849
|
-
*/
|
|
850
|
-
async function fetchRscPayload(url, deps, stateTree, currentUrl) {
|
|
851
|
-
const rscUrl = appendRscParam(url);
|
|
852
|
-
const headers = buildRscHeaders(stateTree, currentUrl);
|
|
853
|
-
if (deps.decodeRsc) {
|
|
854
|
-
const fetchPromise = deps.fetch(rscUrl, {
|
|
855
|
-
headers,
|
|
856
|
-
redirect: "manual"
|
|
857
|
-
});
|
|
858
|
-
let headElements = null;
|
|
859
|
-
let segmentInfo = null;
|
|
860
|
-
let params = null;
|
|
861
|
-
let skippedSegments = null;
|
|
862
|
-
const wrappedPromise = fetchPromise.then((response) => {
|
|
863
|
-
const redirectLocation = response.headers.get("X-Timber-Redirect") || (response.status >= 300 && response.status < 400 ? response.headers.get("Location") : null);
|
|
864
|
-
if (redirectLocation) throw new RedirectError(redirectLocation);
|
|
865
|
-
headElements = extractHeadElements(response);
|
|
866
|
-
segmentInfo = extractSegmentInfo(response);
|
|
867
|
-
params = extractParams(response);
|
|
868
|
-
skippedSegments = extractSkippedSegments(response);
|
|
869
|
-
return response;
|
|
870
|
-
});
|
|
871
|
-
await wrappedPromise;
|
|
872
|
-
return {
|
|
873
|
-
payload: await deps.decodeRsc(wrappedPromise),
|
|
874
|
-
headElements,
|
|
875
|
-
segmentInfo,
|
|
876
|
-
params,
|
|
877
|
-
skippedSegments
|
|
878
|
-
};
|
|
879
|
-
}
|
|
880
|
-
const response = await deps.fetch(rscUrl, {
|
|
881
|
-
headers,
|
|
882
|
-
redirect: "manual"
|
|
883
|
-
});
|
|
884
|
-
if (response.status >= 300 && response.status < 400) {
|
|
885
|
-
const location = response.headers.get("Location");
|
|
886
|
-
if (location) throw new RedirectError(location);
|
|
887
|
-
}
|
|
888
|
-
return {
|
|
889
|
-
payload: await response.text(),
|
|
890
|
-
headElements: extractHeadElements(response),
|
|
891
|
-
segmentInfo: extractSegmentInfo(response),
|
|
892
|
-
params: extractParams(response),
|
|
893
|
-
skippedSegments: extractSkippedSegments(response)
|
|
894
|
-
};
|
|
895
|
-
}
|
|
896
|
-
//#endregion
|
|
897
|
-
//#region src/client/router.ts
|
|
898
|
-
/**
|
|
899
|
-
* Check if an error is an abort error (connection closed / fetch aborted).
|
|
900
|
-
* Browsers throw DOMException with name 'AbortError' when a fetch is aborted.
|
|
901
|
-
*/
|
|
902
|
-
function isAbortError(error) {
|
|
903
|
-
if (error instanceof DOMException && error.name === "AbortError") return true;
|
|
904
|
-
if (error instanceof Error && error.name === "AbortError") return true;
|
|
905
|
-
return false;
|
|
906
|
-
}
|
|
907
|
-
/**
|
|
908
|
-
* Create a router instance. In production, called once at app hydration
|
|
909
|
-
* with real browser APIs. In tests, called with mock dependencies.
|
|
910
|
-
*/
|
|
911
|
-
function createRouter(deps) {
|
|
912
|
-
const segmentCache = new SegmentCache();
|
|
913
|
-
const prefetchCache = new PrefetchCache();
|
|
914
|
-
const historyStack = new HistoryStack();
|
|
915
|
-
const segmentElementCache = new SegmentElementCache();
|
|
916
|
-
let pending = false;
|
|
917
|
-
let pendingUrl = null;
|
|
918
|
-
const pendingListeners = /* @__PURE__ */ new Set();
|
|
919
|
-
function setPending(value, url) {
|
|
920
|
-
const newPendingUrl = value && url ? url : null;
|
|
921
|
-
if (pending === value && pendingUrl === newPendingUrl) return;
|
|
922
|
-
pending = value;
|
|
923
|
-
pendingUrl = newPendingUrl;
|
|
924
|
-
for (const listener of pendingListeners) listener(value);
|
|
925
|
-
}
|
|
926
|
-
/** Update the segment cache from server-provided segment metadata. */
|
|
927
|
-
function updateSegmentCache(segmentInfo) {
|
|
928
|
-
if (!segmentInfo || segmentInfo.length === 0) return;
|
|
929
|
-
const tree = buildSegmentTree(segmentInfo);
|
|
930
|
-
if (tree) segmentCache.set("/", tree);
|
|
931
|
-
}
|
|
932
|
-
/** Render a decoded RSC payload into the DOM if a renderer is available. */
|
|
933
|
-
function renderPayload(payload) {
|
|
934
|
-
if (deps.renderRoot) deps.renderRoot(payload);
|
|
935
|
-
}
|
|
936
|
-
/**
|
|
937
|
-
* Merge a partial RSC payload with cached segment elements if segments
|
|
938
|
-
* were skipped, then cache segments from the (merged) payload.
|
|
939
|
-
* Returns the merged payload ready for rendering.
|
|
940
|
-
*/
|
|
941
|
-
function mergeAndCachePayload(payload, skippedSegments) {
|
|
942
|
-
let merged = payload;
|
|
943
|
-
if (skippedSegments && skippedSegments.length > 0) merged = mergeSegmentTree(payload, skippedSegments, segmentElementCache);
|
|
944
|
-
cacheSegmentElements(merged, segmentElementCache);
|
|
945
|
-
return merged;
|
|
946
|
-
}
|
|
947
|
-
/**
|
|
948
|
-
* Update navigation state (params + pathname) for the next render.
|
|
949
|
-
*
|
|
950
|
-
* Sets both the module-level fallback (for tests and SSR) and the
|
|
951
|
-
* navigation context state (read by renderRoot to wrap the element
|
|
952
|
-
* in NavigationProvider). The context update is atomic with the tree
|
|
953
|
-
* render — both are passed to reactRoot.render() in the same call.
|
|
954
|
-
*/
|
|
955
|
-
function updateNavigationState(params, url) {
|
|
956
|
-
const resolvedParams = params ?? {};
|
|
957
|
-
setCurrentParams(resolvedParams);
|
|
958
|
-
setNavigationState({
|
|
959
|
-
params: resolvedParams,
|
|
960
|
-
pathname: url.startsWith("http") ? new URL(url).pathname : url.split("?")[0] || "/"
|
|
961
|
-
});
|
|
962
|
-
}
|
|
963
|
-
/**
|
|
964
|
-
* Render a payload via navigateTransition (production) or renderRoot (tests).
|
|
965
|
-
* The perform callback should fetch data, update state, and return the payload.
|
|
966
|
-
* In production, the entire callback runs inside a React transition with
|
|
967
|
-
* useOptimistic for the pending URL. In tests, the payload is rendered directly.
|
|
968
|
-
*/
|
|
969
|
-
async function renderViaTransition(url, perform) {
|
|
970
|
-
if (deps.navigateTransition) {
|
|
971
|
-
let headElements = null;
|
|
972
|
-
await deps.navigateTransition(url, async (wrapPayload) => {
|
|
973
|
-
const result = await perform();
|
|
974
|
-
headElements = result.headElements;
|
|
975
|
-
const merged = mergeAndCachePayload(result.payload, result.skippedSegments);
|
|
976
|
-
historyStack.push(url, {
|
|
977
|
-
payload: merged,
|
|
978
|
-
headElements: result.headElements,
|
|
979
|
-
params: result.params
|
|
980
|
-
});
|
|
981
|
-
return wrapPayload(merged);
|
|
982
|
-
});
|
|
983
|
-
return headElements;
|
|
984
|
-
}
|
|
985
|
-
const result = await perform();
|
|
986
|
-
const merged = mergeAndCachePayload(result.payload, result.skippedSegments);
|
|
987
|
-
historyStack.push(url, {
|
|
988
|
-
payload: merged,
|
|
989
|
-
headElements: result.headElements,
|
|
990
|
-
params: result.params
|
|
991
|
-
});
|
|
992
|
-
renderPayload(merged);
|
|
993
|
-
return result.headElements;
|
|
994
|
-
}
|
|
995
|
-
/** Apply head elements (title, meta tags) to the DOM if available. */
|
|
996
|
-
function applyHead(elements) {
|
|
997
|
-
if (elements && deps.applyHead) deps.applyHead(elements);
|
|
998
|
-
}
|
|
999
|
-
/** Run a callback after the next paint (after React commit). */
|
|
1000
|
-
function afterPaint(callback) {
|
|
1001
|
-
if (deps.afterPaint) deps.afterPaint(callback);
|
|
1002
|
-
else callback();
|
|
1003
|
-
}
|
|
1004
|
-
/**
|
|
1005
|
-
* Core navigation logic shared between the transition and fallback paths.
|
|
1006
|
-
* Fetches the RSC payload, updates all state, and returns the result.
|
|
1007
|
-
*/
|
|
1008
|
-
async function performNavigationFetch(url, options) {
|
|
1009
|
-
const prefetched = prefetchCache.consume(url);
|
|
1010
|
-
let result = prefetched ? {
|
|
1011
|
-
payload: prefetched.payload,
|
|
1012
|
-
headElements: prefetched.headElements,
|
|
1013
|
-
segmentInfo: prefetched.segmentInfo ?? null,
|
|
1014
|
-
params: prefetched.params ?? null,
|
|
1015
|
-
skippedSegments: prefetched.skippedSegments ?? null
|
|
1016
|
-
} : void 0;
|
|
1017
|
-
if (result === void 0) {
|
|
1018
|
-
const stateTree = segmentCache.serializeStateTree(segmentElementCache.getMergeablePaths());
|
|
1019
|
-
const rawCurrentUrl = deps.getCurrentUrl();
|
|
1020
|
-
result = await fetchRscPayload(url, deps, stateTree, rawCurrentUrl.startsWith("http") ? new URL(rawCurrentUrl).pathname : new URL(rawCurrentUrl, "http://localhost").pathname);
|
|
1021
|
-
}
|
|
1022
|
-
if (options.replace) deps.replaceState({
|
|
1023
|
-
timber: true,
|
|
1024
|
-
scrollY: 0
|
|
1025
|
-
}, "", url);
|
|
1026
|
-
else deps.pushState({
|
|
1027
|
-
timber: true,
|
|
1028
|
-
scrollY: 0
|
|
1029
|
-
}, "", url);
|
|
1030
|
-
updateSegmentCache(result.segmentInfo);
|
|
1031
|
-
updateNavigationState(result.params, url);
|
|
1032
|
-
return result;
|
|
1033
|
-
}
|
|
1034
|
-
async function navigate(url, options = {}) {
|
|
1035
|
-
const scroll = options.scroll !== false;
|
|
1036
|
-
const replace = options.replace === true;
|
|
1037
|
-
const currentScrollY = deps.getScrollY();
|
|
1038
|
-
deps.replaceState({
|
|
1039
|
-
timber: true,
|
|
1040
|
-
scrollY: currentScrollY
|
|
1041
|
-
}, "", deps.getCurrentUrl());
|
|
1042
|
-
setPending(true, url);
|
|
1043
|
-
try {
|
|
1044
|
-
applyHead(await renderViaTransition(url, () => performNavigationFetch(url, { replace })));
|
|
1045
|
-
window.dispatchEvent(new Event("timber:navigation-end"));
|
|
1046
|
-
afterPaint(() => {
|
|
1047
|
-
if (scroll) deps.scrollTo(0, 0);
|
|
1048
|
-
else deps.scrollTo(0, currentScrollY);
|
|
1049
|
-
window.dispatchEvent(new Event("timber:scroll-restored"));
|
|
1050
|
-
});
|
|
1051
|
-
} catch (error) {
|
|
1052
|
-
if (error instanceof RedirectError) {
|
|
1053
|
-
setPending(false);
|
|
1054
|
-
await navigate(error.redirectUrl, { replace: true });
|
|
1055
|
-
return;
|
|
1056
|
-
}
|
|
1057
|
-
if (isAbortError(error)) return;
|
|
1058
|
-
throw error;
|
|
1059
|
-
} finally {
|
|
1060
|
-
setPending(false);
|
|
1061
|
-
}
|
|
1062
|
-
}
|
|
1063
|
-
async function refresh() {
|
|
1064
|
-
const currentUrl = deps.getCurrentUrl();
|
|
1065
|
-
setPending(true, currentUrl);
|
|
1066
|
-
try {
|
|
1067
|
-
applyHead(await renderViaTransition(currentUrl, async () => {
|
|
1068
|
-
const result = await fetchRscPayload(currentUrl, deps);
|
|
1069
|
-
updateSegmentCache(result.segmentInfo);
|
|
1070
|
-
updateNavigationState(result.params, currentUrl);
|
|
1071
|
-
return result;
|
|
1072
|
-
}));
|
|
1073
|
-
} finally {
|
|
1074
|
-
setPending(false);
|
|
1075
|
-
}
|
|
1076
|
-
}
|
|
1077
|
-
async function handlePopState(url, scrollY = 0) {
|
|
1078
|
-
const entry = historyStack.get(url);
|
|
1079
|
-
if (entry && entry.payload !== null) {
|
|
1080
|
-
updateNavigationState(entry.params, url);
|
|
1081
|
-
renderPayload(entry.payload);
|
|
1082
|
-
applyHead(entry.headElements);
|
|
1083
|
-
afterPaint(() => {
|
|
1084
|
-
deps.scrollTo(0, scrollY);
|
|
1085
|
-
window.dispatchEvent(new Event("timber:scroll-restored"));
|
|
1086
|
-
});
|
|
1087
|
-
} else {
|
|
1088
|
-
setPending(true, url);
|
|
1089
|
-
try {
|
|
1090
|
-
applyHead(await renderViaTransition(url, async () => {
|
|
1091
|
-
const result = await fetchRscPayload(url, deps, segmentCache.serializeStateTree(segmentElementCache.getMergeablePaths()));
|
|
1092
|
-
updateSegmentCache(result.segmentInfo);
|
|
1093
|
-
updateNavigationState(result.params, url);
|
|
1094
|
-
return result;
|
|
1095
|
-
}));
|
|
1096
|
-
afterPaint(() => {
|
|
1097
|
-
deps.scrollTo(0, scrollY);
|
|
1098
|
-
window.dispatchEvent(new Event("timber:scroll-restored"));
|
|
1099
|
-
});
|
|
1100
|
-
} finally {
|
|
1101
|
-
setPending(false);
|
|
1102
|
-
}
|
|
1103
|
-
}
|
|
1104
|
-
}
|
|
1105
|
-
/**
|
|
1106
|
-
* Prefetch an RSC payload for a URL and store it in the prefetch cache.
|
|
1107
|
-
* Called on hover of <Link prefetch> elements.
|
|
1108
|
-
*/
|
|
1109
|
-
function prefetch(url) {
|
|
1110
|
-
if (prefetchCache.get(url) !== void 0) return;
|
|
1111
|
-
if (historyStack.has(url)) return;
|
|
1112
|
-
fetchRscPayload(url, deps, segmentCache.serializeStateTree(segmentElementCache.getMergeablePaths())).then((result) => {
|
|
1113
|
-
prefetchCache.set(url, result);
|
|
1114
|
-
}, () => {});
|
|
1115
|
-
}
|
|
1116
|
-
return {
|
|
1117
|
-
navigate,
|
|
1118
|
-
refresh,
|
|
1119
|
-
handlePopState,
|
|
1120
|
-
isPending: () => pending,
|
|
1121
|
-
getPendingUrl: () => pendingUrl,
|
|
1122
|
-
onPendingChange(listener) {
|
|
1123
|
-
pendingListeners.add(listener);
|
|
1124
|
-
return () => pendingListeners.delete(listener);
|
|
1125
|
-
},
|
|
1126
|
-
prefetch,
|
|
1127
|
-
applyRevalidation(element, headElements) {
|
|
1128
|
-
const currentUrl = deps.getCurrentUrl();
|
|
1129
|
-
const merged = mergeAndCachePayload(element, null);
|
|
1130
|
-
historyStack.push(currentUrl, {
|
|
1131
|
-
payload: merged,
|
|
1132
|
-
headElements
|
|
1133
|
-
});
|
|
1134
|
-
renderPayload(merged);
|
|
1135
|
-
applyHead(headElements);
|
|
1136
|
-
},
|
|
1137
|
-
initSegmentCache: (segments) => updateSegmentCache(segments),
|
|
1138
|
-
cacheElementTree: (element) => cacheSegmentElements(element, segmentElementCache),
|
|
1139
|
-
segmentCache,
|
|
1140
|
-
prefetchCache,
|
|
1141
|
-
historyStack
|
|
1142
|
-
};
|
|
1143
|
-
}
|
|
1144
|
-
//#endregion
|
|
1145
|
-
//#region src/client/use-navigation-pending.ts
|
|
1146
|
-
/**
|
|
1147
|
-
* Returns true while an RSC navigation is in flight.
|
|
1148
|
-
*
|
|
1149
|
-
* The pending state is true from the moment the RSC fetch starts until
|
|
1150
|
-
* React reconciliation completes. This includes the fetch itself,
|
|
1151
|
-
* RSC stream parsing, and React tree reconciliation.
|
|
1152
|
-
*
|
|
1153
|
-
* It does NOT include Suspense streaming after the shell — only the
|
|
1154
|
-
* initial shell reconciliation.
|
|
1155
|
-
*
|
|
1156
|
-
* ```tsx
|
|
1157
|
-
* 'use client'
|
|
1158
|
-
* import { useNavigationPending } from '@timber-js/app/client'
|
|
1159
|
-
*
|
|
1160
|
-
* export function NavBar() {
|
|
1161
|
-
* const isPending = useNavigationPending()
|
|
1162
|
-
* return (
|
|
1163
|
-
* <nav className={isPending ? 'opacity-50' : ''}>
|
|
1164
|
-
* <Link href="/dashboard">Dashboard</Link>
|
|
1165
|
-
* </nav>
|
|
1166
|
-
* )
|
|
1167
|
-
* }
|
|
1168
|
-
* ```
|
|
1169
|
-
*/
|
|
1170
|
-
function useNavigationPending() {
|
|
1171
|
-
return usePendingNavigationUrl() !== null;
|
|
1172
|
-
}
|
|
1173
|
-
//#endregion
|
|
1174
|
-
//#region src/client/use-router.ts
|
|
200
|
+
// src/client/use-router.ts
|
|
1175
201
|
/**
|
|
1176
202
|
* useRouter() — client-side hook for programmatic navigation.
|
|
1177
203
|
*
|
|
@@ -1188,13 +214,13 @@ function useNavigationPending() {
|
|
|
1188
214
|
* In timber, navigation calls reactRoot.render() which is a root-level
|
|
1189
215
|
* render — startTransition has no effect on root renders.
|
|
1190
216
|
*
|
|
1191
|
-
* Navigation state (
|
|
217
|
+
* Navigation state (pathname, search) is delivered atomically via
|
|
1192
218
|
* NavigationContext embedded in the element tree passed to
|
|
1193
219
|
* reactRoot.render(). See design/19-client-navigation.md §"NavigationContext".
|
|
1194
220
|
*
|
|
1195
221
|
* For loading UI during navigation, use:
|
|
1196
222
|
* - useLinkStatus() — per-link pending indicator (inside <Link>)
|
|
1197
|
-
* -
|
|
223
|
+
* - usePendingNavigation() — global navigation pending state
|
|
1198
224
|
*/
|
|
1199
225
|
/**
|
|
1200
226
|
* Get a router instance for programmatic navigation.
|
|
@@ -1216,14 +242,19 @@ function useNavigationPending() {
|
|
|
1216
242
|
function useRouter() {
|
|
1217
243
|
return {
|
|
1218
244
|
push(href, options) {
|
|
245
|
+
validateNavigationHref(href);
|
|
1219
246
|
const router = getRouterOrNull();
|
|
1220
247
|
if (!router) {
|
|
1221
248
|
if (process.env.NODE_ENV === "development") console.error("[timber] useRouter().push() called but router is not initialized. This is a bug — please report it.");
|
|
1222
249
|
return;
|
|
1223
250
|
}
|
|
1224
|
-
router.navigate(href, {
|
|
251
|
+
router.navigate(href, {
|
|
252
|
+
scroll: options?.scroll,
|
|
253
|
+
transitionTypes: options?.transitionTypes
|
|
254
|
+
});
|
|
1225
255
|
},
|
|
1226
256
|
replace(href, options) {
|
|
257
|
+
validateNavigationHref(href);
|
|
1227
258
|
const router = getRouterOrNull();
|
|
1228
259
|
if (!router) {
|
|
1229
260
|
if (process.env.NODE_ENV === "development") console.error("[timber] useRouter().replace() called but router is not initialized.");
|
|
@@ -1231,7 +262,8 @@ function useRouter() {
|
|
|
1231
262
|
}
|
|
1232
263
|
router.navigate(href, {
|
|
1233
264
|
scroll: options?.scroll,
|
|
1234
|
-
replace: true
|
|
265
|
+
replace: true,
|
|
266
|
+
transitionTypes: options?.transitionTypes
|
|
1235
267
|
});
|
|
1236
268
|
},
|
|
1237
269
|
refresh() {
|
|
@@ -1255,136 +287,72 @@ function useRouter() {
|
|
|
1255
287
|
}
|
|
1256
288
|
};
|
|
1257
289
|
}
|
|
1258
|
-
|
|
1259
|
-
//#region src/client/use-pathname.ts
|
|
290
|
+
// src/client/use-pathname.ts
|
|
1260
291
|
/**
|
|
1261
292
|
* usePathname() — client-side hook for reading the current pathname.
|
|
1262
293
|
*
|
|
1263
294
|
* Returns the pathname portion of the current URL (e.g. '/dashboard/settings').
|
|
1264
295
|
* Updates when client-side navigation changes the URL.
|
|
1265
296
|
*
|
|
1266
|
-
*
|
|
1267
|
-
* with the RSC tree render. This replaces the previous useSyncExternalStore
|
|
1268
|
-
* approach which only subscribed to popstate events — meaning usePathname()
|
|
1269
|
-
* did NOT re-render on forward navigation (pushState). The context approach
|
|
1270
|
-
* fixes this: pathname updates in the same render pass as the new tree.
|
|
297
|
+
* One unconditional read of NavigationContext, on every side (TIM-1425):
|
|
1271
298
|
*
|
|
1272
|
-
*
|
|
1273
|
-
*
|
|
299
|
+
* - In the browser, the provider wraps the RSC payload in the router's `renderTree`, so
|
|
300
|
+
* the pathname updates in the same render pass as the new tree.
|
|
301
|
+
* - During SSR, the wrapper chain mounts the same provider with the request's
|
|
302
|
+
* pathname (TIM-1424), so this is the identical code path — no ALS read,
|
|
303
|
+
* no fallback tiers.
|
|
304
|
+
* - In the RSC environment, this module is never evaluated — the shims plugin
|
|
305
|
+
* resolves next/navigation to navigation-rsc.ts, which has a throwing stub
|
|
306
|
+
* (TIM-1420).
|
|
307
|
+
* - Called outside a component entirely, React itself throws its
|
|
308
|
+
* invalid-hook-call error — loud, not guessed-at from window.location.
|
|
1274
309
|
*
|
|
1275
310
|
* Compatible with Next.js's `usePathname()` from `next/navigation`.
|
|
1276
311
|
*/
|
|
1277
312
|
/**
|
|
1278
313
|
* Read the current URL pathname.
|
|
1279
314
|
*
|
|
1280
|
-
*
|
|
1281
|
-
*
|
|
1282
|
-
* ALS-backed SSR data context. Falls back to window.location.pathname
|
|
1283
|
-
* when called outside a React component (e.g., in tests).
|
|
315
|
+
* Throws when no NavigationProvider is above the caller (a component rendered
|
|
316
|
+
* outside the timber app — in tests, render inside the timber providers).
|
|
1284
317
|
*/
|
|
1285
318
|
function usePathname() {
|
|
1286
|
-
|
|
1287
|
-
|
|
1288
|
-
|
|
1289
|
-
} catch {}
|
|
1290
|
-
const ssrData = getSsrData();
|
|
1291
|
-
if (ssrData) return ssrData.pathname ?? "/";
|
|
1292
|
-
if (typeof window !== "undefined") return window.location.pathname;
|
|
1293
|
-
return "/";
|
|
319
|
+
const nav = useNavigationContext();
|
|
320
|
+
if (nav === null) throw new Error("[timber] usePathname() was called outside the timber app tree (no NavigationProvider found). In tests, render the component inside the timber providers.");
|
|
321
|
+
return nav.pathname;
|
|
1294
322
|
}
|
|
1295
|
-
|
|
1296
|
-
//#region src/client/use-search-params.ts
|
|
323
|
+
// src/client/navigation-api.ts
|
|
1297
324
|
/**
|
|
1298
|
-
*
|
|
1299
|
-
*
|
|
1300
|
-
* Returns a read-only URLSearchParams instance reflecting the current
|
|
1301
|
-
* URL's query string. Updates when client-side navigation changes the URL.
|
|
1302
|
-
*
|
|
1303
|
-
* This is a thin wrapper over window.location.search, provided for
|
|
1304
|
-
* Next.js API compatibility (libraries like nuqs import useSearchParams
|
|
1305
|
-
* from next/navigation).
|
|
1306
|
-
*
|
|
1307
|
-
* Unlike Next.js's ReadonlyURLSearchParams, this returns a standard
|
|
1308
|
-
* URLSearchParams. Mutation methods (set, delete, append) work on the
|
|
1309
|
-
* local copy but do NOT affect the URL — use the router or nuqs for that.
|
|
1310
|
-
*
|
|
1311
|
-
* During SSR, reads the request search params from the SSR ALS context
|
|
1312
|
-
* (populated by ssr-entry.ts) instead of window.location.
|
|
1313
|
-
*
|
|
1314
|
-
* All mutable state is delegated to client/state.ts for singleton guarantees.
|
|
1315
|
-
* See design/18-build-system.md §"Singleton State Registry"
|
|
325
|
+
* Returns true if the Navigation API is available in the current environment.
|
|
326
|
+
* Feature-detected at runtime — no polyfill.
|
|
1316
327
|
*/
|
|
1317
|
-
function
|
|
1318
|
-
|
|
1319
|
-
const data = getSsrData();
|
|
1320
|
-
if (!data) return "";
|
|
1321
|
-
const str = new URLSearchParams(data.searchParams).toString();
|
|
1322
|
-
return str ? `?${str}` : "";
|
|
1323
|
-
}
|
|
1324
|
-
function getServerSearch() {
|
|
1325
|
-
const data = getSsrData();
|
|
1326
|
-
if (!data) return "";
|
|
1327
|
-
const str = new URLSearchParams(data.searchParams).toString();
|
|
1328
|
-
return str ? `?${str}` : "";
|
|
1329
|
-
}
|
|
1330
|
-
function subscribe(callback) {
|
|
1331
|
-
window.addEventListener("popstate", callback);
|
|
1332
|
-
return () => window.removeEventListener("popstate", callback);
|
|
1333
|
-
}
|
|
1334
|
-
function getSearchParams() {
|
|
1335
|
-
const search = getSearch();
|
|
1336
|
-
if (search !== cachedSearch) {
|
|
1337
|
-
const params = new URLSearchParams(search);
|
|
1338
|
-
_setCachedSearch(search, params);
|
|
1339
|
-
return params;
|
|
1340
|
-
}
|
|
1341
|
-
return cachedSearchParams;
|
|
1342
|
-
}
|
|
1343
|
-
function getServerSearchParams() {
|
|
1344
|
-
const data = getSsrData();
|
|
1345
|
-
return data ? new URLSearchParams(data.searchParams) : new URLSearchParams();
|
|
328
|
+
function hasNavigationApi() {
|
|
329
|
+
return typeof window !== "undefined" && "navigation" in window && window.navigation != null;
|
|
1346
330
|
}
|
|
1347
331
|
/**
|
|
1348
|
-
*
|
|
1349
|
-
*
|
|
1350
|
-
* Compatible with Next.js's `useSearchParams()` from `next/navigation`.
|
|
332
|
+
* Get the Navigation API instance. Returns null if unavailable.
|
|
1351
333
|
*/
|
|
1352
|
-
function
|
|
1353
|
-
|
|
1354
|
-
return
|
|
334
|
+
function getNavigationApi() {
|
|
335
|
+
if (!hasNavigationApi()) return null;
|
|
336
|
+
return window.navigation;
|
|
1355
337
|
}
|
|
1356
|
-
|
|
1357
|
-
//#region src/client/segment-context.ts
|
|
338
|
+
// src/client/shallow-url.ts
|
|
1358
339
|
/**
|
|
1359
|
-
*
|
|
1360
|
-
*
|
|
1361
|
-
* Each layout in the segment tree is wrapped with a SegmentProvider that stores
|
|
1362
|
-
* the URL segments from root to the current layout level. The hooks read this
|
|
1363
|
-
* context to determine which child segments are active below the calling layout.
|
|
1364
|
-
*
|
|
1365
|
-
* The context value is intentionally minimal: just the segment path array and
|
|
1366
|
-
* parallel route keys. No internal cache details are exposed.
|
|
340
|
+
* Shallow URL replacement — update the browser URL bar without triggering
|
|
341
|
+
* RSC navigation, TopLoader, or any server round-trip.
|
|
1367
342
|
*
|
|
1368
|
-
*
|
|
1369
|
-
|
|
1370
|
-
|
|
1371
|
-
/** Read the segment context. Returns null if no provider is above this component. */
|
|
1372
|
-
function useSegmentContext() {
|
|
1373
|
-
return useContext(SegmentContext);
|
|
1374
|
-
}
|
|
1375
|
-
/**
|
|
1376
|
-
* Wraps each layout to provide segment position context.
|
|
1377
|
-
* Injected by rsc-entry.ts during element tree construction.
|
|
343
|
+
* Uses the Navigation API's `info: { shallow: true }` when available (Chrome),
|
|
344
|
+
* which the navigate event handler intercepts with a no-op handler. Falls back
|
|
345
|
+
* to raw `history.replaceState` (Safari/Firefox — no navigate event fired).
|
|
1378
346
|
*/
|
|
1379
|
-
function
|
|
1380
|
-
const
|
|
1381
|
-
|
|
1382
|
-
|
|
1383
|
-
|
|
1384
|
-
|
|
347
|
+
function replaceUrl(url) {
|
|
348
|
+
const nav = getNavigationApi();
|
|
349
|
+
if (nav) nav.navigate(url, {
|
|
350
|
+
history: "replace",
|
|
351
|
+
info: { shallow: true }
|
|
352
|
+
});
|
|
353
|
+
else history.replaceState(history.state, "", url);
|
|
1385
354
|
}
|
|
1386
|
-
|
|
1387
|
-
//#region src/client/use-selected-layout-segment.ts
|
|
355
|
+
// src/client/use-selected-layout-segment.ts
|
|
1388
356
|
/**
|
|
1389
357
|
* useSelectedLayoutSegment / useSelectedLayoutSegments — client-side hooks
|
|
1390
358
|
* for reading the active segment(s) below the current layout.
|
|
@@ -1471,124 +439,213 @@ function useSelectedLayoutSegments(parallelRouteKey) {
|
|
|
1471
439
|
const pathname = usePathname();
|
|
1472
440
|
return getSelectedSegments(context?.segments ?? null, pathname);
|
|
1473
441
|
}
|
|
1474
|
-
|
|
1475
|
-
|
|
1476
|
-
|
|
1477
|
-
|
|
1478
|
-
|
|
1479
|
-
|
|
1480
|
-
|
|
1481
|
-
* { data: T } | { validationErrors: Record<string, string[]> } | { serverError: { code, data? } } | null
|
|
1482
|
-
*
|
|
1483
|
-
* The action builder emits a function that satisfies both the direct call signature
|
|
1484
|
-
* and React's `(prevState, formData) => Promise<State>` contract.
|
|
1485
|
-
*
|
|
1486
|
-
* See design/08-forms-and-actions.md §"Client-Side Form Mechanics"
|
|
1487
|
-
*/
|
|
442
|
+
// src/client/form.tsx
|
|
443
|
+
var EMPTY = Object.freeze({
|
|
444
|
+
field: () => null,
|
|
445
|
+
form: Object.freeze([]),
|
|
446
|
+
server: null,
|
|
447
|
+
hasErrors: false
|
|
448
|
+
});
|
|
1488
449
|
/**
|
|
1489
|
-
*
|
|
1490
|
-
*
|
|
1491
|
-
*
|
|
1492
|
-
*
|
|
1493
|
-
* @param initialState - Initial state, typically `null`. Pass `getFormFlash()` for no-JS
|
|
1494
|
-
* progressive enhancement — the flash seeds the initial state so the form has a
|
|
1495
|
-
* single source of truth for both with-JS and no-JS paths.
|
|
1496
|
-
* @param permalink - Optional permalink for progressive enhancement (no-JS fallback URL).
|
|
450
|
+
* Read the errors out of an action result — the state `useActionState`
|
|
451
|
+
* returns. `_root` validation errors are form-level; every other key is a
|
|
452
|
+
* field. Field names are typed from the action's schema input, so a
|
|
453
|
+
* misspelled path is a type error.
|
|
1497
454
|
*
|
|
1498
455
|
* @example
|
|
1499
456
|
* ```tsx
|
|
1500
|
-
*
|
|
1501
|
-
*
|
|
1502
|
-
*
|
|
1503
|
-
*
|
|
1504
|
-
* export function NewTodoForm({ flash }) {
|
|
1505
|
-
* const [result, action, isPending] = useActionState(createTodo, flash)
|
|
1506
|
-
* return (
|
|
1507
|
-
* <form action={action}>
|
|
1508
|
-
* <input name="title" />
|
|
1509
|
-
* {result?.validationErrors?.title && <p>{result.validationErrors.title}</p>}
|
|
1510
|
-
* <button disabled={isPending}>Add</button>
|
|
1511
|
-
* </form>
|
|
1512
|
-
* )
|
|
1513
|
-
* }
|
|
457
|
+
* const [result, action, isPending] = useActionState(createTodo, null)
|
|
458
|
+
* const errors = readFormErrors(result)
|
|
459
|
+
* errors.field('title') // first message for the field, or null
|
|
1514
460
|
* ```
|
|
1515
461
|
*/
|
|
1516
|
-
function
|
|
1517
|
-
|
|
462
|
+
function readFormErrors(result) {
|
|
463
|
+
if (!result) return EMPTY;
|
|
464
|
+
const validationErrors = result.validationErrors ?? {};
|
|
465
|
+
const server = result.serverError ?? null;
|
|
466
|
+
const form = validationErrors._root ?? [];
|
|
467
|
+
const hasErrors = server !== null || Object.values(validationErrors).some((messages) => messages?.length);
|
|
468
|
+
if (!hasErrors) return EMPTY;
|
|
469
|
+
return {
|
|
470
|
+
field(name) {
|
|
471
|
+
return validationErrors[name]?.[0] ?? null;
|
|
472
|
+
},
|
|
473
|
+
form,
|
|
474
|
+
server,
|
|
475
|
+
hasErrors
|
|
476
|
+
};
|
|
1518
477
|
}
|
|
478
|
+
// src/client/use-field-state.ts
|
|
1519
479
|
/**
|
|
1520
|
-
*
|
|
1521
|
-
*
|
|
480
|
+
* useFieldState — state for a form field that needs JavaScript (a combobox, a
|
|
481
|
+
* chip list, a row list), made to behave like a native uncontrolled input.
|
|
1522
482
|
*
|
|
1523
|
-
*
|
|
1524
|
-
*
|
|
1525
|
-
*
|
|
1526
|
-
*
|
|
1527
|
-
*
|
|
1528
|
-
*
|
|
1529
|
-
*
|
|
483
|
+
* React resets a form after its action settles, so a native field with a
|
|
484
|
+
* `defaultValue` lands on whatever default the page now renders: the action's
|
|
485
|
+
* `submittedValues`, or fresh page data after a redirect. State held in
|
|
486
|
+
* `useState` misses that reset and keeps showing the pre-submit edit. This
|
|
487
|
+
* hook shows `defaultValue` until the user edits, and drops the edit when the
|
|
488
|
+
* form resets, so it lands where the native fields do.
|
|
489
|
+
*
|
|
490
|
+
* See design/08-forms-and-actions.md §"The Form Model".
|
|
1530
491
|
*/
|
|
1531
|
-
function useFormAction(action) {
|
|
1532
|
-
const [isPending, startTransition] = useTransition();
|
|
1533
|
-
const execute = (input) => {
|
|
1534
|
-
return new Promise((resolve) => {
|
|
1535
|
-
startTransition(async () => {
|
|
1536
|
-
resolve(await action(input));
|
|
1537
|
-
});
|
|
1538
|
-
});
|
|
1539
|
-
};
|
|
1540
|
-
return [execute, isPending];
|
|
1541
|
-
}
|
|
1542
492
|
/**
|
|
1543
|
-
*
|
|
493
|
+
* State for a field that follows its form's reset.
|
|
1544
494
|
*
|
|
1545
|
-
*
|
|
1546
|
-
*
|
|
1547
|
-
*
|
|
495
|
+
* Returns `[value, setValue, ref]`. Attach `ref` to any element inside the
|
|
496
|
+
* `<form>`, or to the `<form>` itself (the hook subscribes to
|
|
497
|
+
* `closest('form')`, which includes the element), and render the value into
|
|
498
|
+
* the form data yourself (usually hidden inputs). With the ref on the form,
|
|
499
|
+
* the hook can live above it and hold the whole draft as one object, for a
|
|
500
|
+
* live preview beside the form. `value` is `defaultValue` until `setValue` is called, and is
|
|
501
|
+
* `defaultValue` again after the form resets, unless the form cancels its
|
|
502
|
+
* `reset` event. An edit dispatches a bubbling `change` event from the `ref`
|
|
503
|
+
* element after it commits, so a native `change` listener on the form sees it
|
|
504
|
+
* as it sees a native input's (React's synthetic `onChange` reports only
|
|
505
|
+
* inputs, selects and textareas). A reset and a new default fire none, as
|
|
506
|
+
* they fire none for a native input.
|
|
1548
507
|
*
|
|
1549
508
|
* @example
|
|
1550
509
|
* ```tsx
|
|
1551
|
-
*
|
|
1552
|
-
* const
|
|
1553
|
-
*
|
|
1554
|
-
*
|
|
1555
|
-
* <
|
|
1556
|
-
*
|
|
1557
|
-
* {errors.getFieldError('title') && <p>{errors.getFieldError('title')}</p>}
|
|
1558
|
-
* {errors.formErrors.map(e => <p key={e}>{e}</p>)}
|
|
1559
|
-
* </form>
|
|
1560
|
-
* )
|
|
510
|
+
* // draft: the form's defaults, read from result?.submittedValues ?? pageData
|
|
511
|
+
* const [tags, setTags, ref] = useFieldState(draft.tags);
|
|
512
|
+
* <div ref={ref}>
|
|
513
|
+
* {tags.map((tag) => <input key={tag} type="hidden" name="tags" value={tag} />)}
|
|
514
|
+
* <TagPicker value={tags} onChange={setTags} />
|
|
515
|
+
* </div>
|
|
1561
516
|
* ```
|
|
1562
517
|
*/
|
|
1563
|
-
function
|
|
1564
|
-
const
|
|
1565
|
-
|
|
1566
|
-
|
|
1567
|
-
|
|
1568
|
-
|
|
1569
|
-
|
|
1570
|
-
|
|
1571
|
-
|
|
1572
|
-
|
|
1573
|
-
|
|
1574
|
-
|
|
1575
|
-
|
|
1576
|
-
|
|
1577
|
-
|
|
1578
|
-
|
|
1579
|
-
|
|
1580
|
-
|
|
1581
|
-
|
|
1582
|
-
|
|
1583
|
-
|
|
1584
|
-
|
|
1585
|
-
|
|
1586
|
-
|
|
1587
|
-
|
|
1588
|
-
|
|
1589
|
-
|
|
1590
|
-
|
|
1591
|
-
|
|
1592
|
-
|
|
518
|
+
function useFieldState(defaultValue) {
|
|
519
|
+
const [edit, setEdit] = useState(null);
|
|
520
|
+
const value = edit ? edit.value : defaultValue;
|
|
521
|
+
const defaultRef = useRef(defaultValue);
|
|
522
|
+
useLayoutEffect(() => {
|
|
523
|
+
defaultRef.current = defaultValue;
|
|
524
|
+
});
|
|
525
|
+
const pendingResets = useRef([]);
|
|
526
|
+
const takeResets = useCallback(() => {
|
|
527
|
+
const over = pendingResets.current.filter((e) => e.eventPhase === Event.NONE);
|
|
528
|
+
if (over.length === 0) return false;
|
|
529
|
+
pendingResets.current = pendingResets.current.filter((e) => !over.includes(e));
|
|
530
|
+
return over.some((e) => !e.defaultPrevented);
|
|
531
|
+
}, []);
|
|
532
|
+
const setValue = useCallback((next) => {
|
|
533
|
+
const wasReset = takeResets();
|
|
534
|
+
setEdit((latest) => {
|
|
535
|
+
const current = wasReset ? null : latest;
|
|
536
|
+
const base = current ? current.value : defaultRef.current;
|
|
537
|
+
const value = next instanceof Function ? next(base) : next;
|
|
538
|
+
return Object.is(value, base) ? current : { value };
|
|
539
|
+
});
|
|
540
|
+
}, [takeResets]);
|
|
541
|
+
const element = useRef(null);
|
|
542
|
+
const ref = useCallback((el) => {
|
|
543
|
+
element.current = el;
|
|
544
|
+
const form = el?.closest("form");
|
|
545
|
+
if (!form) return;
|
|
546
|
+
const onReset = (event) => {
|
|
547
|
+
pendingResets.current.push(event);
|
|
548
|
+
const apply = () => {
|
|
549
|
+
if (takeResets()) setEdit(null);
|
|
550
|
+
};
|
|
551
|
+
queueMicrotask(() => {
|
|
552
|
+
if (event.eventPhase === Event.NONE) apply();
|
|
553
|
+
else setTimeout(apply, 0);
|
|
554
|
+
});
|
|
555
|
+
};
|
|
556
|
+
form.addEventListener("reset", onReset);
|
|
557
|
+
return () => {
|
|
558
|
+
element.current = null;
|
|
559
|
+
pendingResets.current = [];
|
|
560
|
+
form.removeEventListener("reset", onReset);
|
|
561
|
+
};
|
|
562
|
+
}, [takeResets]);
|
|
563
|
+
useEffect(() => {
|
|
564
|
+
if (edit) element.current?.dispatchEvent(new Event("change", { bubbles: true }));
|
|
565
|
+
}, [edit]);
|
|
566
|
+
return [
|
|
567
|
+
value,
|
|
568
|
+
setValue,
|
|
569
|
+
ref
|
|
570
|
+
];
|
|
571
|
+
}
|
|
572
|
+
// src/client/params-context.ts
|
|
573
|
+
/**
|
|
574
|
+
* Segment params context — the one channel params use to reach the browser.
|
|
575
|
+
*
|
|
576
|
+
* Params ride the RSC payload's root row as a sibling of the tree
|
|
577
|
+
* (`{ tree, params, slotParams }`), rather than in four side channels that
|
|
578
|
+
* raced to seed them: a response header, an inline script, and two build-time
|
|
579
|
+
* manifest fields all previously carried the same record, each with its own
|
|
580
|
+
* `JSON.stringify` (TIM-1294).
|
|
581
|
+
*
|
|
582
|
+
* Riding the payload is what makes them *typed*. `defineSchema` takes any
|
|
583
|
+
* `Codec<T>`, so a coerced param is whatever the codec returned — a `Date`, a
|
|
584
|
+
* `bigint` — and `JSON.stringify` either flattened it to a string or threw
|
|
585
|
+
* mid-response. React Flight carries those values natively, so the client
|
|
586
|
+
* reads the value the server produced instead of a lossy copy of it. See
|
|
587
|
+
* design/41-global-params.md §"Transport".
|
|
588
|
+
*
|
|
589
|
+
* **The client owns the provider.** There is exactly one `ParamsProvider` in
|
|
590
|
+
* the browser's tree, rendered by `PayloadRoot` above the point where a
|
|
591
|
+
* partial navigation splices the new payload into the retained tree. It has to
|
|
592
|
+
* be there and it has to be alone: a provider *inside* the payload lands below
|
|
593
|
+
* the retained region, whose own root is the departing route's provider, so
|
|
594
|
+
* every reader in a skipped layout resolves to the departing record and no
|
|
595
|
+
* amount of wrapping above it helps (TIM-1297).
|
|
596
|
+
*
|
|
597
|
+
* Ordering still holds without a bootstrap contract, for the same reason it
|
|
598
|
+
* did when the provider was in the tree: a provider renders before its own
|
|
599
|
+
* descendants by construction, so `useSegmentParams()` is correct during
|
|
600
|
+
* hydration without anything having to run before `hydrateRoot()`.
|
|
601
|
+
*/
|
|
602
|
+
/**
|
|
603
|
+
* SINGLETON GUARANTEE: globalThis + `Symbol.for`, the same pattern as
|
|
604
|
+
* `NavigationContext` and `SegmentUpdateContext`.
|
|
605
|
+
*
|
|
606
|
+
* The RSC client bundler can duplicate a module across chunks, and with ESM
|
|
607
|
+
* output each chunk gets its own module scope — so a bare `createContext` at
|
|
608
|
+
* module level yields one context per chunk. This module is now reached from
|
|
609
|
+
* *both* graphs: `PayloadRoot` is imported by the browser entry, while
|
|
610
|
+
* `useParamsContext()` arrives through the client-reference graph with the
|
|
611
|
+
* app's own components. A duplicate would put the provider on instance A and
|
|
612
|
+
* every reader on instance B, so `useContext` returns `null` and every
|
|
613
|
+
* `useSegmentParams()` call throws the outside-the-timber-app-tree error
|
|
614
|
+
* even though the provider is mounted (the module-snapshot fallback it once
|
|
615
|
+
* silently landed on was deleted in TIM-1425).
|
|
616
|
+
*
|
|
617
|
+
* This module was the one client context without the guard — harmless while
|
|
618
|
+
* the provider travelled inside the payload, in the same graph as its readers,
|
|
619
|
+
* and load-bearing the moment the client started rendering it (TIM-1297).
|
|
620
|
+
*
|
|
621
|
+
* The React APIs are reached through the namespace rather than named imports,
|
|
622
|
+
* for the same reason `segment-update-context.ts` and `navigation-context.ts`
|
|
623
|
+
* do it: React's `react-server` export provides neither `createContext` nor
|
|
624
|
+
* `useContext`, and a *named* ESM import of a missing export fails at module
|
|
625
|
+
* instantiation — before any feature check could run. This module is reachable
|
|
626
|
+
* from every entry a Server Component imports, so the named form crashed
|
|
627
|
+
* those entries outright (codex, PR #992; originally reproduced against
|
|
628
|
+
* `@timber-js/app/segment-params`, an entry point since deleted by TIM-1342 —
|
|
629
|
+
* the hazard is unchanged for the entries that remain).
|
|
630
|
+
*
|
|
631
|
+
* See design/19-client-navigation.md §"Singleton Guarantee via globalThis"
|
|
632
|
+
*/
|
|
633
|
+
var ParamsContext = createGlobalContext(Symbol.for("__timber_params_ctx"), null);
|
|
634
|
+
/**
|
|
635
|
+
* Read the params provided by the tree. Returns null only when no provider
|
|
636
|
+
* is above the caller — a component rendered outside a timber route. During
|
|
637
|
+
* SSR the wrapper chain mounts `PayloadRoot` too (TIM-1424), so both sides
|
|
638
|
+
* resolve through this context.
|
|
639
|
+
*/
|
|
640
|
+
function useParamsContext() {
|
|
641
|
+
return React.useContext(ParamsContext);
|
|
642
|
+
}
|
|
643
|
+
// src/client/use-segment-params.ts
|
|
644
|
+
function useSegmentParams(segmentPath) {
|
|
645
|
+
const paramsContext = useParamsContext();
|
|
646
|
+
if (paramsContext === null) throw new Error("[timber] useSegmentParams() was called outside the timber app tree (no params provider found). In tests, render the component inside the timber providers.");
|
|
647
|
+
return resolveSegmentParams(paramsContext.params, paramsContext.slotParams, segmentPath);
|
|
648
|
+
}
|
|
649
|
+
export { Link, LinkStatusContext, buildLinkProps, interpolateParams, mergePreservedSearchParams, readFormErrors, replaceUrl, resolveHref, useFieldState, useLinkStatus, usePathname, usePendingNavigation, useQueryStates, useRouter, useSegmentParams, useSelectedLayoutSegment, useSelectedLayoutSegments, validateNavigationHref as validateLinkHref };
|
|
1593
650
|
|
|
1594
651
|
//# sourceMappingURL=index.js.map
|