@timber-js/app 0.2.0-alpha.22 → 0.2.0-alpha.220
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 +351 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-BwkmAYXq.js +1243 -0
- package/dist/_chunks/actions-BwkmAYXq.js.map +1 -0
- package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
- package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
- package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
- package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
- package/dist/_chunks/base-path-DaQrzbez.js +80 -0
- package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
- package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
- package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
- package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
- package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
- package/dist/_chunks/cache-api-LA3sBpUS.js +1182 -0
- package/dist/_chunks/cache-api-LA3sBpUS.js.map +1 -0
- package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
- package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
- package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
- package/dist/_chunks/chains-e_Buf9vg.js +267 -0
- package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
- package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
- package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
- package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
- package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
- package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
- package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
- package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
- package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
- package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
- package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
- package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
- package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
- package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
- package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
- package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
- package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
- package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
- package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
- package/dist/_chunks/dev-server-DkytOEG2.js +1 -0
- package/dist/_chunks/dev-server-DnODXuNM.js +2056 -0
- package/dist/_chunks/dev-server-DnODXuNM.js.map +1 -0
- package/dist/_chunks/dist-DtrJyBbw.js +386 -0
- package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
- package/dist/_chunks/error-boundary-xxxLtXt6.js +1057 -0
- package/dist/_chunks/error-boundary-xxxLtXt6.js.map +1 -0
- package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
- package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
- package/dist/_chunks/flight-source-node-0dE-t3kq.js +519 -0
- package/dist/_chunks/flight-source-node-0dE-t3kq.js.map +1 -0
- package/dist/_chunks/format-BKclgVbk.js +14 -0
- package/dist/_chunks/format-BKclgVbk.js.map +1 -0
- package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
- package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
- package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
- package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
- package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
- package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
- package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
- package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
- package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
- package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
- package/dist/_chunks/logger-CbLdcy-W.js +662 -0
- package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
- package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
- package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
- package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
- package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
- package/dist/_chunks/node-response-Dibufw_b.js +187 -0
- package/dist/_chunks/node-response-Dibufw_b.js.map +1 -0
- package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
- package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
- package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
- package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
- package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
- package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
- package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
- package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
- package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
- package/dist/_chunks/purge-store-Byr8XOjU.js +14 -0
- package/dist/_chunks/purge-store-Byr8XOjU.js.map +1 -0
- package/dist/_chunks/render-timeout-DOf_BBcO.js +46 -0
- package/dist/_chunks/render-timeout-DOf_BBcO.js.map +1 -0
- package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
- package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
- package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
- package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
- package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
- package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
- package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
- package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
- package/dist/_chunks/scan-BoP17W3w.js +140 -0
- package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
- package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
- package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
- package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
- package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
- package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
- package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
- package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
- package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
- package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
- package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
- package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
- package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
- package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
- package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
- package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
- package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
- package/dist/_chunks/state-BhNGPsdi.js +50 -0
- package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
- package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
- package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
- package/dist/_chunks/tree-match-6yihorhk.js +169 -0
- package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
- package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
- package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
- package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
- package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
- package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
- package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
- package/dist/adapters/build-output-helper.d.ts +72 -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 +74 -0
- package/dist/adapters/cloudflare-dev.js.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.js +123 -0
- package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
- package/dist/adapters/cloudflare.d.ts +224 -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 +31 -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 +793 -341
- package/dist/adapters/nitro.js.map +1 -1
- package/dist/adapters/shared.d.ts +67 -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 +314 -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 +472 -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/handler-store.d.ts +33 -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 +3 -326
- package/dist/cache/invalidation-epoch.d.ts +43 -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/redis-handler.d.ts +141 -9
- package/dist/cache/redis-handler.d.ts.map +1 -1
- package/dist/cache/singleflight.d.ts +21 -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 +9 -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 +29 -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 +90 -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 +35 -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 +33 -0
- package/dist/cache/stores/vercel.js.map +1 -0
- package/dist/cache/tag-aware-handler.d.ts +52 -0
- package/dist/cache/tag-aware-handler.d.ts.map +1 -0
- package/dist/cache/timber-cache.d.ts +21 -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 +30 -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 +33 -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 +94 -0
- package/dist/cdn/index.js.map +1 -0
- package/dist/cdn/purge-store.d.ts +23 -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 +35 -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 +54 -0
- package/dist/cli-context.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 +88 -16
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +225 -63
- 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 +21 -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/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 +15 -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 +21 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +432 -1227
- 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 +808 -0
- package/dist/client/internal.js.map +1 -0
- package/dist/client/link.d.ts +85 -60
- package/dist/client/link.d.ts.map +1 -1
- package/dist/client/location-search.d.ts +12 -0
- package/dist/client/location-search.d.ts.map +1 -0
- package/dist/client/navigation-api.d.ts +95 -0
- package/dist/client/navigation-api.d.ts.map +1 -0
- package/dist/client/navigation-commit.d.ts +111 -0
- package/dist/client/navigation-commit.d.ts.map +1 -0
- package/dist/client/navigation-context.d.ts +54 -36
- 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 +201 -0
- package/dist/client/navigation-transition.d.ts.map +1 -0
- package/dist/client/nuqs-adapter.d.ts +1 -1
- 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 +199 -0
- package/dist/client/router-effects.d.ts.map +1 -0
- package/dist/client/router-lifecycle.d.ts +104 -0
- package/dist/client/router-lifecycle.d.ts.map +1 -0
- package/dist/client/router-pipeline.d.ts +85 -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 +314 -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 +12 -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 +23 -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 +76 -0
- package/dist/codec.js.map +1 -0
- package/dist/config-types.d.ts +321 -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 +256 -36
- 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/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} +17 -3
- 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/stack-classifier.d.ts +34 -0
- package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
- package/dist/dev-tools/terminal.d.ts +28 -0
- package/dist/dev-tools/terminal.d.ts.map +1 -0
- package/dist/fonts/ast-walk.d.ts +68 -0
- package/dist/fonts/ast-walk.d.ts.map +1 -0
- package/dist/fonts/ast.d.ts +112 -8
- package/dist/fonts/ast.d.ts.map +1 -1
- package/dist/fonts/bundle.d.ts +50 -0
- package/dist/fonts/bundle.d.ts.map +1 -0
- package/dist/fonts/css.d.ts +1 -1
- package/dist/fonts/dev-middleware.d.ts +22 -0
- package/dist/fonts/dev-middleware.d.ts.map +1 -0
- package/dist/fonts/fallbacks.d.ts +0 -7
- package/dist/fonts/fallbacks.d.ts.map +1 -1
- package/dist/fonts/google.d.ts +5 -3
- package/dist/fonts/google.d.ts.map +1 -1
- package/dist/fonts/local.d.ts +5 -5
- package/dist/fonts/local.d.ts.map +1 -1
- package/dist/fonts/paths.d.ts +43 -0
- package/dist/fonts/paths.d.ts.map +1 -0
- package/dist/fonts/pipeline.d.ts +177 -0
- package/dist/fonts/pipeline.d.ts.map +1 -0
- package/dist/fonts/transform.d.ts +82 -0
- package/dist/fonts/transform.d.ts.map +1 -0
- package/dist/fonts/types.d.ts +47 -1
- package/dist/fonts/types.d.ts.map +1 -1
- package/dist/fonts/virtual-modules.d.ts +77 -0
- package/dist/fonts/virtual-modules.d.ts.map +1 -0
- package/dist/index.d.ts +35 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8877 -14232
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +26 -0
- package/dist/params/codec-registry.d.ts.map +1 -0
- package/dist/params/define-schema.d.ts +81 -0
- package/dist/params/define-schema.d.ts.map +1 -0
- package/dist/params/index.d.ts +5 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +34 -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 +262 -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/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-discovery.d.ts +123 -0
- package/dist/plugins/dev-discovery.d.ts.map +1 -0
- package/dist/plugins/dev-server.d.ts +24 -1
- package/dist/plugins/dev-server.d.ts.map +1 -1
- 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 +35 -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 +112 -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/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 +1 -1
- package/dist/plugins/routing.d.ts.map +1 -1
- package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
- package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
- package/dist/plugins/server-bundle.d.ts +1 -1
- package/dist/plugins/server-bundle.d.ts.map +1 -1
- package/dist/plugins/shims.d.ts +29 -5
- package/dist/plugins/shims.d.ts.map +1 -1
- package/dist/plugins/static-build.d.ts +246 -26
- package/dist/plugins/static-build.d.ts.map +1 -1
- package/dist/routing/codegen-shared.d.ts +26 -0
- package/dist/routing/codegen-shared.d.ts.map +1 -0
- package/dist/routing/codegen-types.d.ts +61 -0
- package/dist/routing/codegen-types.d.ts.map +1 -0
- package/dist/routing/codegen-write.d.ts +42 -0
- package/dist/routing/codegen-write.d.ts.map +1 -0
- package/dist/routing/codegen.d.ts +8 -3
- package/dist/routing/codegen.d.ts.map +1 -1
- package/dist/routing/collision-probe.d.ts +104 -0
- package/dist/routing/collision-probe.d.ts.map +1 -0
- package/dist/routing/collision-spaces.d.ts +26 -0
- package/dist/routing/collision-spaces.d.ts.map +1 -0
- package/dist/routing/convention-lint.d.ts +55 -0
- package/dist/routing/convention-lint.d.ts.map +1 -0
- package/dist/routing/export-detect.d.ts +91 -0
- package/dist/routing/export-detect.d.ts.map +1 -0
- package/dist/routing/file-cache.d.ts +8 -0
- package/dist/routing/file-cache.d.ts.map +1 -0
- package/dist/routing/index.d.ts +13 -7
- package/dist/routing/index.d.ts.map +1 -1
- package/dist/routing/index.js +5 -2
- package/dist/routing/interception-overlap.d.ts +35 -0
- package/dist/routing/interception-overlap.d.ts.map +1 -0
- package/dist/routing/interception.d.ts +234 -10
- package/dist/routing/interception.d.ts.map +1 -1
- package/dist/routing/link-codegen.d.ts +105 -0
- package/dist/routing/link-codegen.d.ts.map +1 -0
- package/dist/routing/manifest-codegen.d.ts +26 -0
- package/dist/routing/manifest-codegen.d.ts.map +1 -0
- package/dist/routing/scanner.d.ts +14 -10
- package/dist/routing/scanner.d.ts.map +1 -1
- package/dist/routing/schema-validation.d.ts +35 -0
- package/dist/routing/schema-validation.d.ts.map +1 -0
- package/dist/routing/segment-classify.d.ts +114 -0
- package/dist/routing/segment-classify.d.ts.map +1 -0
- package/dist/routing/segment-codegen.d.ts +38 -0
- package/dist/routing/segment-codegen.d.ts.map +1 -0
- package/dist/routing/segment-keys.d.ts +118 -0
- package/dist/routing/segment-keys.d.ts.map +1 -0
- package/dist/routing/slot-placement.d.ts +48 -0
- package/dist/routing/slot-placement.d.ts.map +1 -0
- package/dist/routing/types.d.ts +81 -26
- package/dist/routing/types.d.ts.map +1 -1
- package/dist/routing/walkers.d.ts +57 -0
- package/dist/routing/walkers.d.ts.map +1 -0
- package/dist/rsc-runtime/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 +6 -2
- package/dist/rsc-runtime/rsc.d.ts.map +1 -1
- package/dist/rsc-runtime/ssr.d.ts +8 -0
- 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 +145 -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 +179 -360
- 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/access-gate.d.ts +98 -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 +58 -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 +32 -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 +149 -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 +638 -3021
- package/dist/server/index.js.map +1 -1
- package/dist/server/instrumentation.d.ts +11 -4
- package/dist/server/instrumentation.d.ts.map +1 -1
- package/dist/server/internal.d.ts +47 -0
- package/dist/server/internal.d.ts.map +1 -0
- package/dist/server/internal.js +4649 -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 +79 -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/nuqs-ssr-provider.d.ts +7 -3
- package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
- package/dist/server/param-coercion.d.ts +83 -0
- package/dist/server/param-coercion.d.ts.map +1 -0
- package/dist/server/pipeline-helpers.d.ts +224 -0
- package/dist/server/pipeline-helpers.d.ts.map +1 -0
- package/dist/server/pipeline-interception.d.ts +70 -9
- package/dist/server/pipeline-interception.d.ts.map +1 -1
- package/dist/server/pipeline-metadata.d.ts +16 -1
- 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 +70 -0
- package/dist/server/pipeline-phases.d.ts.map +1 -0
- package/dist/server/pipeline.d.ts +161 -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 +63 -0
- package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-render.d.ts +25 -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/key-discipline.d.ts +52 -0
- package/dist/server/prebuilt/key-discipline.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 +100 -0
- package/dist/server/prebuilt/overlay.d.ts.map +1 -0
- package/dist/server/prebuilt/payload-source.d.ts +79 -0
- package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
- package/dist/server/prebuilt/slots.d.ts +106 -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 +110 -0
- package/dist/server/prebuilt-runtime.d.ts.map +1 -0
- package/dist/server/primitives.d.ts +101 -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 +35 -0
- package/dist/server/render-utils.d.ts.map +1 -0
- package/dist/server/request-context.d.ts +153 -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/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 +1 -1
- package/dist/server/route-handler.d.ts.map +1 -1
- package/dist/server/route-matcher.d.ts +62 -38
- package/dist/server/route-matcher.d.ts.map +1 -1
- 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 +43 -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 +59 -32
- package/dist/server/ssr-render.d.ts.map +1 -1
- package/dist/server/ssr-wrappers.d.ts +93 -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/tracing.d.ts +57 -26
- 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 +89 -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/error-digest.d.ts +28 -0
- package/dist/shared/error-digest.d.ts.map +1 -0
- package/dist/shared/flight-base64.d.ts +13 -0
- package/dist/shared/flight-base64.d.ts.map +1 -0
- package/dist/shared/flight-segment.d.ts +18 -0
- package/dist/shared/flight-segment.d.ts.map +1 -0
- package/dist/shared/form-state-flight.d.ts +32 -0
- package/dist/shared/form-state-flight.d.ts.map +1 -0
- package/dist/shared/href-validation.d.ts +49 -0
- package/dist/shared/href-validation.d.ts.map +1 -0
- package/dist/shared/merge-search-params.d.ts +22 -0
- package/dist/shared/merge-search-params.d.ts.map +1 -0
- package/dist/shared/param-value.d.ts +104 -0
- package/dist/shared/param-value.d.ts.map +1 -0
- package/dist/shared/payload-root.d.ts +110 -0
- package/dist/shared/payload-root.d.ts.map +1 -0
- package/dist/shared/redirect-type.d.ts +17 -0
- package/dist/shared/redirect-type.d.ts.map +1 -0
- package/dist/shared/rsc-cache-key.d.ts +163 -0
- package/dist/shared/rsc-cache-key.d.ts.map +1 -0
- package/dist/shared/rsc-error-envelope.d.ts +16 -0
- package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
- package/dist/shared/rsc-manifest.d.ts +28 -0
- package/dist/shared/rsc-manifest.d.ts.map +1 -0
- package/dist/shared/rsc-media-type.d.ts +52 -0
- package/dist/shared/rsc-media-type.d.ts.map +1 -0
- package/dist/shared/rsc-payload-path.d.ts +48 -0
- package/dist/shared/rsc-payload-path.d.ts.map +1 -0
- package/dist/shared/segment-info.d.ts +66 -0
- package/dist/shared/segment-info.d.ts.map +1 -0
- package/dist/shared/slot-params.d.ts +52 -0
- package/dist/shared/slot-params.d.ts.map +1 -0
- package/dist/shared/static-platform-files.d.ts +71 -0
- package/dist/shared/static-platform-files.d.ts.map +1 -0
- package/dist/shared/status-reason-phrase.d.ts +26 -0
- package/dist/shared/status-reason-phrase.d.ts.map +1 -0
- package/dist/shims/font-google.d.ts +1 -1
- package/dist/shims/font-google.d.ts.map +1 -1
- package/dist/shims/font-google.js +42 -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 +20 -0
- package/dist/shims/font-local.js.map +1 -0
- package/dist/shims/headers.d.ts +53 -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 +239 -0
- package/docs/api/31-api-client.mdx +199 -0
- package/docs/api/32-api-cache.mdx +339 -0
- package/docs/api/33-api-search-params.mdx +176 -0
- package/docs/api/34-api-config.mdx +359 -0
- package/docs/api/35-api-typescript.mdx +91 -0
- package/docs/api/36-cli.mdx +206 -0
- package/docs/learn/00-introduction.mdx +109 -0
- package/docs/learn/01-quick-start.mdx +94 -0
- package/docs/learn/02-pages-and-layouts.mdx +147 -0
- package/docs/learn/03-fetching-data.mdx +227 -0
- package/docs/learn/04-access-control.mdx +115 -0
- package/docs/learn/05-the-flush-point.mdx +175 -0
- package/docs/learn/06-typed-params.mdx +275 -0
- package/docs/learn/07-typed-routes.mdx +108 -0
- package/docs/learn/08-forms-and-actions.mdx +260 -0
- package/docs/learn/09-streaming.mdx +140 -0
- package/docs/learn/10-caching.mdx +270 -0
- package/docs/learn/11-middleware.mdx +164 -0
- package/docs/learn/12-error-handling.mdx +192 -0
- package/docs/learn/13-deploying.mdx +289 -0
- package/llms.txt +55 -0
- package/package.json +120 -29
- package/src/adapters/build-output-helper.ts +353 -0
- package/src/adapters/canonicalize-module.ts +29 -0
- package/src/adapters/cloudflare-dev.ts +183 -0
- package/src/adapters/cloudflare-kv-cache.ts +207 -0
- package/src/adapters/cloudflare.ts +809 -150
- 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 +124 -0
- package/src/adapters/nitro-preview.ts +533 -0
- package/src/adapters/nitro.ts +331 -445
- package/src/adapters/raw-imports.d.ts +5 -0
- package/src/adapters/shared.ts +283 -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 +762 -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 +107 -0
- package/src/cache/fast-hash.ts +5 -0
- package/src/cache/handler-store.ts +76 -0
- package/src/cache/index.ts +115 -22
- package/src/cache/invalidation-epoch.ts +93 -0
- package/src/cache/json-lossy-check.ts +69 -0
- package/src/cache/redis-handler.ts +198 -20
- package/src/cache/singleflight.ts +72 -6
- package/src/cache/sizeof.ts +35 -0
- package/src/cache/stable-stringify.ts +65 -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 +254 -0
- package/src/cache/timber-cache.ts +165 -40
- 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 +34 -0
- package/src/cdn/workers-cache-purge.ts +34 -0
- package/src/cli-check.ts +417 -0
- package/src/cli-context.ts +119 -0
- package/src/cli-schema-sync.ts +401 -0
- package/src/cli.ts +334 -80
- 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 +70 -0
- package/src/client/browser-entry/hydrate.ts +152 -0
- package/src/client/browser-entry/index.ts +150 -0
- package/src/client/browser-entry/post-hydration.ts +99 -0
- package/src/client/browser-entry/router-init.ts +393 -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/error-boundary.tsx +279 -61
- package/src/client/error-reconstituter.tsx +84 -0
- package/src/client/form.tsx +61 -173
- package/src/client/global-context.ts +31 -0
- package/src/client/history.ts +74 -11
- package/src/client/index.ts +90 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +468 -151
- package/src/client/location-search.ts +15 -0
- package/src/client/navigation-api.ts +254 -0
- package/src/client/navigation-commit.ts +318 -0
- package/src/client/navigation-context.ts +67 -134
- package/src/client/navigation-root.tsx +236 -0
- package/src/client/navigation-transition.ts +348 -0
- package/src/client/nuqs-adapter.tsx +21 -9
- package/src/client/params-context.ts +187 -0
- package/src/client/react-root.ts +105 -0
- package/src/client/router-effects.ts +324 -0
- package/src/client/router-lifecycle.ts +374 -0
- package/src/client/router-pipeline.ts +456 -0
- package/src/client/router-ref.ts +3 -3
- package/src/client/router-skew.ts +30 -0
- package/src/client/router-types.ts +346 -0
- package/src/client/router-url.ts +32 -0
- package/src/client/router.ts +500 -424
- 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 +50 -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 +70 -18
- 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 +40 -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 +321 -0
- package/src/config-validation.ts +464 -0
- package/src/cookies/define-cookie.ts +222 -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/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 +261 -0
- package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
- package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
- package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
- 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 +492 -380
- package/src/params/codec-registry.ts +34 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +17 -0
- package/src/params/resolve-schema.ts +84 -0
- package/src/plugin-context.ts +502 -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/cloudflare-wasm.ts +141 -0
- package/src/plugins/content.ts +31 -2
- package/src/plugins/dev-discovery.ts +218 -0
- package/src/plugins/dev-server.ts +360 -97
- package/src/plugins/encryption-runtime.ts +31 -0
- package/src/plugins/entries.ts +150 -17
- package/src/plugins/fonts.ts +260 -657
- package/src/plugins/graph-endpoint.ts +532 -0
- package/src/plugins/mdx.ts +108 -35
- 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 +670 -0
- package/src/plugins/prerender-sugar.ts +316 -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 +273 -277
- package/src/plugins/rsc-assets-manifest.ts +251 -0
- package/src/plugins/server-bundle.ts +115 -15
- package/src/plugins/shims.ts +257 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -0
- package/src/routing/codegen-shared.ts +39 -0
- package/src/routing/codegen-types.ts +62 -0
- package/src/routing/codegen-write.ts +163 -0
- package/src/routing/codegen.ts +349 -232
- package/src/routing/collision-probe.ts +438 -0
- package/src/routing/collision-spaces.ts +281 -0
- package/src/routing/convention-lint.ts +651 -0
- package/src/routing/export-detect.ts +536 -0
- package/src/routing/file-cache.ts +23 -0
- package/src/routing/index.ts +16 -7
- package/src/routing/interception-overlap.ts +141 -0
- package/src/routing/interception.ts +1044 -67
- package/src/routing/link-codegen.ts +280 -0
- package/src/routing/manifest-codegen.ts +232 -0
- package/src/routing/scanner.ts +417 -223
- package/src/routing/schema-validation.ts +155 -0
- package/src/routing/segment-classify.ts +280 -0
- package/src/routing/segment-codegen.ts +99 -0
- package/src/routing/segment-keys.ts +186 -0
- package/src/routing/slot-placement.ts +97 -0
- package/src/routing/types.ts +82 -26
- package/src/routing/walkers.ts +98 -0
- package/src/rsc-runtime/encryption-runtime.ts +78 -0
- package/src/rsc-runtime/render-flight.ts +26 -0
- package/src/rsc-runtime/rsc.ts +17 -2
- package/src/rsc-runtime/ssr.ts +13 -0
- package/src/rsc-runtime/transforms.ts +13 -0
- package/src/rsc-runtime/vendor-types.d.ts +70 -0
- package/src/schema-bridge.ts +382 -0
- package/src/search-params/define.ts +677 -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/access-gate.tsx +195 -56
- package/src/server/action-client.ts +175 -294
- package/src/server/action-encryption.ts +144 -0
- package/src/server/action-handler.ts +492 -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 +35 -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 +454 -0
- package/src/server/cookie-parsing.ts +163 -0
- package/src/server/csp-nonce.ts +58 -0
- package/src/server/csrf.ts +228 -35
- 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 +328 -0
- package/src/server/flight-scripts.ts +92 -0
- package/src/server/flight-source-node.ts +430 -0
- package/src/server/flight-source.ts +288 -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 +37 -195
- package/src/server/instrumentation.ts +11 -4
- package/src/server/internal.ts +168 -0
- package/src/server/json-status-response.ts +105 -0
- package/src/server/logger.ts +131 -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/nuqs-ssr-provider.tsx +8 -7
- package/src/server/param-coercion.ts +201 -0
- package/src/server/pipeline-helpers.ts +548 -0
- package/src/server/pipeline-interception.ts +241 -32
- package/src/server/pipeline-metadata.ts +25 -1
- package/src/server/pipeline-outcome.ts +290 -0
- package/src/server/pipeline-phases.ts +503 -0
- package/src/server/pipeline.ts +423 -426
- package/src/server/port-resolution.ts +43 -0
- package/src/server/prebuilt/cache-key.ts +299 -0
- package/src/server/prebuilt/capture-render.ts +118 -0
- package/src/server/prebuilt/capture-routes.ts +104 -0
- package/src/server/prebuilt/capture-state.ts +196 -0
- package/src/server/prebuilt/key-discipline.ts +122 -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 +256 -0
- package/src/server/prebuilt/payload-source.ts +202 -0
- package/src/server/prebuilt/slots.ts +202 -0
- package/src/server/prebuilt/synthetic-store.ts +125 -0
- package/src/server/prebuilt-builder.ts +514 -0
- package/src/server/prebuilt-runtime.ts +810 -0
- package/src/server/primitives.ts +153 -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 +128 -0
- package/src/server/render-utils.ts +45 -0
- package/src/server/request-context.ts +298 -324
- package/src/server/request-dep.ts +37 -0
- package/src/server/response-cache-policy.ts +45 -0
- package/src/server/route-element-builder.ts +526 -355
- package/src/server/route-element-helpers.ts +37 -0
- package/src/server/route-handler.ts +67 -27
- package/src/server/route-matcher.ts +238 -267
- 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 +144 -0
- package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
- package/src/server/rsc-entry/api-handler.ts +49 -81
- 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 +372 -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 +137 -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 +112 -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 +707 -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 +248 -109
- package/src/server/ssr-form-state.ts +58 -0
- package/src/server/ssr-render.ts +334 -101
- package/src/server/ssr-wrappers.tsx +162 -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/tracing.ts +163 -68
- package/src/server/tree-match.ts +494 -0
- package/src/server/types.ts +96 -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/error-digest.ts +46 -0
- package/src/shared/flight-base64.ts +23 -0
- package/src/shared/flight-segment.ts +35 -0
- package/src/shared/form-state-flight.ts +59 -0
- package/src/shared/href-validation.ts +159 -0
- package/src/shared/merge-search-params.ts +55 -0
- package/src/shared/param-value.ts +281 -0
- package/src/shared/payload-root.ts +153 -0
- package/src/shared/redirect-type.ts +17 -0
- package/src/shared/rsc-cache-key.ts +269 -0
- package/src/shared/rsc-error-envelope.ts +16 -0
- package/src/shared/rsc-manifest.ts +29 -0
- package/src/shared/rsc-media-type.ts +59 -0
- package/src/shared/rsc-payload-path.ts +52 -0
- package/src/shared/segment-info.ts +67 -0
- package/src/shared/slot-params.ts +109 -0
- package/src/shared/static-platform-files.ts +75 -0
- package/src/shared/status-reason-phrase.ts +61 -0
- package/src/shims/font-google.ts +1 -1
- package/src/shims/font-local.ts +34 -0
- package/src/shims/headers.ts +122 -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/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/prerender.ts +0 -139
- package/src/server/tree-builder.ts +0 -382
- package/src/shims/server-only-noop.js +0 -6
- package/src/utils/directive-parser.ts +0 -529
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Sequential Action Queue — serialises server action dispatch.
|
|
3
|
+
*
|
|
4
|
+
* One action at a time. The next action's POST starts only after the
|
|
5
|
+
* previous one has settled AND its result has been applied (revalidation
|
|
6
|
+
* rendered or refresh awaited). Navigations do not enter the queue —
|
|
7
|
+
* they preempt via the NavigationEpoch. Queries (TIM-1415) bypass it
|
|
8
|
+
* entirely.
|
|
9
|
+
*
|
|
10
|
+
* See design/08-forms-and-actions.md §"Client-Side Form Mechanics"
|
|
11
|
+
* and design/19-client-navigation.md §State Update Invariants (TIM-1475).
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
export interface ActionQueueDeps {
|
|
15
|
+
refreshWhenIdle: () => void;
|
|
16
|
+
/**
|
|
17
|
+
* Called once when an action's holds exceed `holdTimeoutMs`. The chain
|
|
18
|
+
* releases regardless; this is the recovery hook. It must not wait on
|
|
19
|
+
* the same thing the hold is stuck on — in dispatch the hold IS the
|
|
20
|
+
* router's own refresh/commit, so a deferred `refreshWhenIdle` would
|
|
21
|
+
* park forever. Dispatch forces a fresh `router.refresh()` instead,
|
|
22
|
+
* which supersedes the stuck owner (TIM-1485).
|
|
23
|
+
*/
|
|
24
|
+
recoverStalledHold: () => void;
|
|
25
|
+
/**
|
|
26
|
+
* Maximum time (ms) the queue stays blocked on held promises after an
|
|
27
|
+
* action's result has been returned. A hung hold (e.g. a refresh commit
|
|
28
|
+
* awaiting a stalled flight stream) would otherwise brick the chain for
|
|
29
|
+
* the life of the page. `0` disables the guard. Default: 30s.
|
|
30
|
+
*/
|
|
31
|
+
holdTimeoutMs?: number;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export const DEFAULT_HOLD_TIMEOUT_MS = 30_000;
|
|
35
|
+
|
|
36
|
+
const noop = (): void => {};
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Resolve when every hold settles, or when `timeoutMs` elapses — whichever
|
|
40
|
+
* comes first. Never rejects. `onTimeout` runs only if the timer wins.
|
|
41
|
+
* Same race-against-timer shape as `cache/singleflight.ts` (TIM-518),
|
|
42
|
+
* minus the AbortSignal: holds are fire-and-forget side effects with no
|
|
43
|
+
* cancellation contract.
|
|
44
|
+
*/
|
|
45
|
+
function awaitHolds(
|
|
46
|
+
holds: Promise<unknown>[],
|
|
47
|
+
timeoutMs: number,
|
|
48
|
+
onTimeout: () => void
|
|
49
|
+
): Promise<void> {
|
|
50
|
+
const all = Promise.all(holds).then(noop);
|
|
51
|
+
if (holds.length === 0 || timeoutMs <= 0) return all;
|
|
52
|
+
return new Promise<void>((resolve) => {
|
|
53
|
+
const timer = setTimeout(() => {
|
|
54
|
+
onTimeout();
|
|
55
|
+
resolve();
|
|
56
|
+
}, timeoutMs);
|
|
57
|
+
void all.then(() => {
|
|
58
|
+
clearTimeout(timer);
|
|
59
|
+
resolve();
|
|
60
|
+
});
|
|
61
|
+
});
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Passed into `work` so it can return a result to React immediately
|
|
66
|
+
* while keeping the queue blocked on a side effect (e.g. a refresh
|
|
67
|
+
* that must commit before the next action captures its epoch).
|
|
68
|
+
*/
|
|
69
|
+
export interface ActionQueueRun {
|
|
70
|
+
hold: (p: Promise<unknown>) => void;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export interface ActionQueue {
|
|
74
|
+
/**
|
|
75
|
+
* Enqueue `work` to run after all preceding actions have settled.
|
|
76
|
+
* Returns `work`'s own promise so the caller (React) gets the action
|
|
77
|
+
* result or rejection. If the preceding action rejected, `work` still
|
|
78
|
+
* runs — errors do not break the chain.
|
|
79
|
+
*
|
|
80
|
+
* `work` receives a `hold` handle: calling `hold(promise)` keeps the
|
|
81
|
+
* queue blocked until that promise settles, independent of `work`'s
|
|
82
|
+
* return value. Use it for "return the result NOW, await the refresh
|
|
83
|
+
* commit for sequencing."
|
|
84
|
+
*/
|
|
85
|
+
run: <T>(work: (q: ActionQueueRun) => Promise<T>) => Promise<T>;
|
|
86
|
+
/**
|
|
87
|
+
* Mark that a discarded action would have revalidated. When the queue
|
|
88
|
+
* drains, one refresh fires via `deps.refreshWhenIdle`. If the queue is
|
|
89
|
+
* already idle — a hold settling after its timeout released the chain —
|
|
90
|
+
* the refresh fires immediately rather than waiting for a future
|
|
91
|
+
* action's drain (TIM-1485).
|
|
92
|
+
*/
|
|
93
|
+
markNeedsRefresh: () => void;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export function createActionQueue(deps: ActionQueueDeps): ActionQueue {
|
|
97
|
+
let tail: Promise<void> = Promise.resolve();
|
|
98
|
+
let needsRefresh = false;
|
|
99
|
+
let idle = true;
|
|
100
|
+
const holdTimeoutMs = deps.holdTimeoutMs ?? DEFAULT_HOLD_TIMEOUT_MS;
|
|
101
|
+
|
|
102
|
+
function drain(): void {
|
|
103
|
+
if (!needsRefresh) return;
|
|
104
|
+
needsRefresh = false;
|
|
105
|
+
deps.refreshWhenIdle();
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
// The caller's promise is untouched: React already has the action
|
|
109
|
+
// result. Recovery is delegated — the queue cannot know what the hold
|
|
110
|
+
// is stuck on, and a deferred drain refresh would wait on exactly that.
|
|
111
|
+
function onHoldTimeout(): void {
|
|
112
|
+
if (process.env.NODE_ENV === 'development') {
|
|
113
|
+
console.warn(`[timber] action queue: hold exceeded ${holdTimeoutMs}ms — releasing chain`);
|
|
114
|
+
}
|
|
115
|
+
deps.recoverStalledHold();
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
function run<T>(work: (q: ActionQueueRun) => Promise<T>): Promise<T> {
|
|
119
|
+
const holds: Promise<unknown>[] = [];
|
|
120
|
+
const hold = (p: Promise<unknown>): void => {
|
|
121
|
+
holds.push(p.then(noop, noop));
|
|
122
|
+
};
|
|
123
|
+
// `p` is the caller-visible promise — it resolves/rejects with work's
|
|
124
|
+
// result (React sees this). `settled` is the chain link: work settled
|
|
125
|
+
// AND every held promise settled (or the hold timeout fired). It never
|
|
126
|
+
// rejects, so the chain never breaks and the next action always runs.
|
|
127
|
+
const p = tail.then(
|
|
128
|
+
() => work({ hold }),
|
|
129
|
+
() => work({ hold })
|
|
130
|
+
);
|
|
131
|
+
const settled = p.then(noop, noop).then(() => awaitHolds(holds, holdTimeoutMs, onHoldTimeout));
|
|
132
|
+
tail = settled;
|
|
133
|
+
idle = false;
|
|
134
|
+
// Drain when the queue empties: tail identity means nobody enqueued
|
|
135
|
+
// behind this action between its start and its settlement.
|
|
136
|
+
void settled.then(() => {
|
|
137
|
+
if (tail !== settled) return;
|
|
138
|
+
idle = true;
|
|
139
|
+
drain();
|
|
140
|
+
});
|
|
141
|
+
return p;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
function markNeedsRefresh(): void {
|
|
145
|
+
needsRefresh = true;
|
|
146
|
+
// Nothing is queued to drain this — act now rather than strand the
|
|
147
|
+
// flag until an unrelated future action fires it.
|
|
148
|
+
if (idle) drain();
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
return { run, markNeedsRefresh };
|
|
152
|
+
}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The form state a page answering a no-JS action embeds for hydration
|
|
3
|
+
* (`self.__timber_form_state`, server/form-state-flight.ts).
|
|
4
|
+
*
|
|
5
|
+
* `hydrateRoot` needs the value Fizz rendered with, or the `useActionState`
|
|
6
|
+
* hook that submitted hydrates back to its initial state. The embed is the
|
|
7
|
+
* form state's Flight bytes, the same bytes SSR decoded for Fizz, so the
|
|
8
|
+
* browser decodes them with its own Flight client before it hydrates. Only
|
|
9
|
+
* this page waits for that; a page without the embed hydrates at once
|
|
10
|
+
* (TIM-1297: hydration does not wait for the payload root).
|
|
11
|
+
*
|
|
12
|
+
* See design/08-forms-and-actions.md §"No-JS Result Round-Trip".
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
16
|
+
import { createFromReadableStream } from '../../rsc-runtime/browser.ts';
|
|
17
|
+
import { decodeFormState } from '../../shared/form-state-flight.ts';
|
|
18
|
+
import { flightBytesFromBase64 } from '../../shared/flight-base64.ts';
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* Every byte is already in the document, so decoding takes microtasks. The
|
|
22
|
+
* bound only keeps a Flight client bug from holding hydration forever.
|
|
23
|
+
*/
|
|
24
|
+
const DECODE_TIMEOUT_MS = 5_000;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Take the embedded form state, and remove it. `null` when the page has
|
|
28
|
+
* none, which is every page but one answering a no-JS action. Otherwise a
|
|
29
|
+
* promise of the decoded state, or of `null` if it could not be decoded: the
|
|
30
|
+
* page then hydrates as though it had none, which resets that one hook.
|
|
31
|
+
*/
|
|
32
|
+
export function takeEmbeddedFormState(): Promise<ReactFormState | null> | null {
|
|
33
|
+
const embedded: unknown = Reflect.get(self, '__timber_form_state');
|
|
34
|
+
Reflect.deleteProperty(self, '__timber_form_state');
|
|
35
|
+
if (typeof embedded !== 'string') return null;
|
|
36
|
+
// Inside the chain, so malformed base64 falls back like a failed decode.
|
|
37
|
+
return Promise.resolve(embedded)
|
|
38
|
+
.then((text) =>
|
|
39
|
+
decodeFormState(
|
|
40
|
+
flightBytesFromBase64(text),
|
|
41
|
+
(stream) => createFromReadableStream(stream),
|
|
42
|
+
DECODE_TIMEOUT_MS
|
|
43
|
+
)
|
|
44
|
+
)
|
|
45
|
+
.catch((error: unknown) => {
|
|
46
|
+
console.warn('[timber] the form state of a no-JS action did not decode:', error);
|
|
47
|
+
return null;
|
|
48
|
+
});
|
|
49
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* HMR & Dev Tooling — dev-only wiring for hot module replacement.
|
|
3
|
+
*
|
|
4
|
+
* Handles:
|
|
5
|
+
* - RSC module invalidation (rsc:update → router.refresh())
|
|
6
|
+
* - Dev warnings forwarded from server via WebSocket
|
|
7
|
+
* - Server console log replay in browser
|
|
8
|
+
* - Client error forwarding to Vite error overlay
|
|
9
|
+
*
|
|
10
|
+
* See design/21-dev-server.md §"HMR Wiring"
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
import type { RouterInstance } from '#client-internal';
|
|
14
|
+
import {
|
|
15
|
+
setupServerLogReplay,
|
|
16
|
+
setupClientErrorForwarding,
|
|
17
|
+
showCompilingOverlay,
|
|
18
|
+
hideCompilingOverlay,
|
|
19
|
+
} from '../browser-dev.ts';
|
|
20
|
+
|
|
21
|
+
type HotApi = {
|
|
22
|
+
on(event: string, cb: (...args: unknown[]) => void): void;
|
|
23
|
+
send(event: string, data: unknown): void;
|
|
24
|
+
};
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Set up HMR and dev tool integration.
|
|
28
|
+
*
|
|
29
|
+
* Reads `import.meta.hot` to register dev-only event listeners.
|
|
30
|
+
* In production builds, `import.meta.hot` is undefined and this
|
|
31
|
+
* function is a no-op.
|
|
32
|
+
*/
|
|
33
|
+
export function setupHmr(router: RouterInstance): void {
|
|
34
|
+
// Vite injects import.meta.hot in dev mode. Cast to access it without
|
|
35
|
+
// requiring vite/client types in the package tsconfig.
|
|
36
|
+
const hot = (import.meta as unknown as { hot?: HotApi }).hot;
|
|
37
|
+
if (!hot) return;
|
|
38
|
+
|
|
39
|
+
// ─── Compiling overlay: Vite client HMR updates ──────────────
|
|
40
|
+
// vite:beforeUpdate fires when Vite begins applying client-side
|
|
41
|
+
// module updates (React Fast Refresh, CSS hot update, etc.).
|
|
42
|
+
// vite:afterUpdate fires once all updates are applied.
|
|
43
|
+
hot.on('vite:beforeUpdate', () => {
|
|
44
|
+
showCompilingOverlay();
|
|
45
|
+
});
|
|
46
|
+
hot.on('vite:afterUpdate', () => {
|
|
47
|
+
hideCompilingOverlay();
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
// ─── RSC module invalidation ─────────────────────────────────
|
|
51
|
+
// rsc:update fires when a server component is edited.
|
|
52
|
+
// Show the compiling overlay while the RSC refresh is in flight.
|
|
53
|
+
hot.on('rsc:update', () => {
|
|
54
|
+
showCompilingOverlay();
|
|
55
|
+
void router.refresh().finally(() => {
|
|
56
|
+
hideCompilingOverlay();
|
|
57
|
+
});
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
// Listen for server console logs forwarded via WebSocket.
|
|
61
|
+
// Replays them in the browser console with a [SERVER] prefix
|
|
62
|
+
// so developers can see server output without switching to the terminal.
|
|
63
|
+
// See plugins/dev-logs.ts.
|
|
64
|
+
setupServerLogReplay(hot);
|
|
65
|
+
|
|
66
|
+
// Forward uncaught client errors to the server for the dev overlay.
|
|
67
|
+
// The server source-maps the stack and sends it back via Vite's
|
|
68
|
+
// error overlay protocol. See dev-server.ts §client error listener.
|
|
69
|
+
setupClientErrorForwarding(hot);
|
|
70
|
+
}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Hydration — making the server-rendered page current and hydrating the
|
|
3
|
+
* React root with it.
|
|
4
|
+
*
|
|
5
|
+
* Handles two paths:
|
|
6
|
+
* 1. RSC payload available: hydrate the router's React root with the payload
|
|
7
|
+
* 2. No RSC payload: nothing to hydrate — the root is created by the first
|
|
8
|
+
* render (client/react-root.ts) — but the page is still made current
|
|
9
|
+
*
|
|
10
|
+
* Either way the page becomes current through `RouterInstance.hydrate`, the
|
|
11
|
+
* same prepare-and-commit every navigation uses, committed before the tree
|
|
12
|
+
* is handed to React. The one ordering left is that the router exists
|
|
13
|
+
* before `hydrateRoot()`, so `useRouter()` works during render. Pathname
|
|
14
|
+
* and search reach the tree as props of its NavigationProvider, from the
|
|
15
|
+
* router's prepared navState — there is no store to seed first (TIM-1541).
|
|
16
|
+
*
|
|
17
|
+
* Params are not part of this sequence either. They arrive on the payload root and
|
|
18
|
+
* are published by `PayloadRoot` at the top of the tree, so
|
|
19
|
+
* `useSegmentParams()` is correct during hydration without anything having to
|
|
20
|
+
* run before it (TIM-1294, TIM-1297).
|
|
21
|
+
*
|
|
22
|
+
* See design/19-client-navigation.md §"NavigationContext"
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
26
|
+
import { isPageUnloading } from '../unload-guard.ts';
|
|
27
|
+
import type { ReactRootHost } from '../react-root.ts';
|
|
28
|
+
import { readPublishedParams } from '../../shared/payload-root.ts';
|
|
29
|
+
import type { SegmentInfo } from '../../shared/segment-info.ts';
|
|
30
|
+
|
|
31
|
+
import type { RscStreamResult } from './rsc-stream.ts';
|
|
32
|
+
import type { RouterInitResult } from './router-init.ts';
|
|
33
|
+
|
|
34
|
+
let showHydrationError: ((error: unknown) => void) | null = null;
|
|
35
|
+
let isHydrationError: ((error: unknown) => boolean) | null = null;
|
|
36
|
+
let pendingHydrationErrors: unknown[] = [];
|
|
37
|
+
|
|
38
|
+
// React 19 emits attribute-only hydration mismatches via console.error
|
|
39
|
+
// with format substitution: console.error(fmt, link, diff). We must
|
|
40
|
+
// intercept before hydrateRoot() to catch errors during initial hydration.
|
|
41
|
+
const ATTR_MISMATCH_RE =
|
|
42
|
+
/A tree hydrated but some attributes of the server rendered HTML didn't match/;
|
|
43
|
+
if (process.env.NODE_ENV !== 'production') {
|
|
44
|
+
const origConsoleError = console.error;
|
|
45
|
+
console.error = (...args: unknown[]) => {
|
|
46
|
+
origConsoleError.apply(console, args);
|
|
47
|
+
if (typeof args[0] === 'string' && ATTR_MISMATCH_RE.test(args[0])) {
|
|
48
|
+
const message = args
|
|
49
|
+
.slice(1)
|
|
50
|
+
.reduce<string>((s, arg) => s.replace('%s', String(arg)), args[0] as string);
|
|
51
|
+
queueOrShowHydrationError(new Error(message));
|
|
52
|
+
}
|
|
53
|
+
};
|
|
54
|
+
import('../../dev-tools/hydration-overlay.ts').then((m) => {
|
|
55
|
+
showHydrationError = m.showHydrationError;
|
|
56
|
+
isHydrationError = m.isHydrationError;
|
|
57
|
+
for (const err of pendingHydrationErrors) {
|
|
58
|
+
if (m.isHydrationError(err)) m.showHydrationError(err);
|
|
59
|
+
}
|
|
60
|
+
pendingHydrationErrors = [];
|
|
61
|
+
});
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function queueOrShowHydrationError(error: unknown): void {
|
|
65
|
+
if (showHydrationError && isHydrationError) {
|
|
66
|
+
if (isHydrationError(error)) showHydrationError(error);
|
|
67
|
+
} else {
|
|
68
|
+
pendingHydrationErrors.push(error);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
interface HydrateOptions {
|
|
73
|
+
/** RSC stream result (null if no inlined payload) */
|
|
74
|
+
rscResult: RscStreamResult | null;
|
|
75
|
+
/** The router's React root — the one every navigation renders through. */
|
|
76
|
+
reactRoot: ReactRootHost;
|
|
77
|
+
/** Makes the page current and builds its tree — see `RouterInitResult.hydrate`. */
|
|
78
|
+
hydrate: RouterInitResult['hydrate'];
|
|
79
|
+
/**
|
|
80
|
+
* The decoded form state of the no-JS action this page answers, or `null`
|
|
81
|
+
* (./form-state.ts). `hydrateRoot` needs the value Fizz rendered with, or
|
|
82
|
+
* the `useActionState` hook that submitted hydrates back to its initial
|
|
83
|
+
* state. See design/08-forms-and-actions.md §"No-JS Result Round-Trip".
|
|
84
|
+
*/
|
|
85
|
+
formState: ReactFormState | null;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Take the segment metadata the server embedded in the document
|
|
90
|
+
* (`self.__timber_segments`), and remove it. It describes the chain the
|
|
91
|
+
* server rendered, so the first client navigation can send a state tree.
|
|
92
|
+
* See design/19-client-navigation.md §"X-Timber-State-Tree Header".
|
|
93
|
+
*/
|
|
94
|
+
function takeEmbeddedSegmentInfo(): SegmentInfo[] | null {
|
|
95
|
+
const embedded: unknown = Reflect.get(self, '__timber_segments');
|
|
96
|
+
Reflect.deleteProperty(self, '__timber_segments');
|
|
97
|
+
return Array.isArray(embedded) ? embedded : null;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/**
|
|
101
|
+
* Make the server-rendered page current, and hydrate the React tree with it
|
|
102
|
+
* when an RSC payload is available.
|
|
103
|
+
*
|
|
104
|
+
* Wraps the payload with the router's chain (NavigationProvider,
|
|
105
|
+
* TimberNuqsAdapter, the slot content cache, ...) and hydrates the router's
|
|
106
|
+
* React root with it, on the document.
|
|
107
|
+
*
|
|
108
|
+
* When no RSC payload is available (JS-only client) the page is committed
|
|
109
|
+
* at once and there is nothing to hydrate: the root must not be created at
|
|
110
|
+
* bootstrap —
|
|
111
|
+
* `createRoot(document).render()` would take React ownership of the entire
|
|
112
|
+
* document and blank the SSR HTML — so the router's first render, i.e. the
|
|
113
|
+
* first navigation or revalidation, creates it with the tree it renders
|
|
114
|
+
* (`createReactRoot`, TIM-600 / TIM-580).
|
|
115
|
+
*/
|
|
116
|
+
export function hydrateApp({ rscResult, reactRoot, hydrate, formState }: HydrateOptions): void {
|
|
117
|
+
// The chain is the router's own `renderTree`, not a copy: an element type
|
|
118
|
+
// that is present here and absent on the first navigation (or the
|
|
119
|
+
// reverse) changes the type at that position, and React remounts
|
|
120
|
+
// everything below it — losing the layout state partial navigation exists
|
|
121
|
+
// to preserve. Sharing the function makes that impossible by construction.
|
|
122
|
+
//
|
|
123
|
+
// `rscResult.params` is the payload's params promise, not a resolved
|
|
124
|
+
// record: the inlined Flight stream is still arriving and hydration cannot
|
|
125
|
+
// wait for it. PayloadRoot suspends on it exactly where React was going to
|
|
126
|
+
// suspend on `element` (TIM-1297).
|
|
127
|
+
const page = {
|
|
128
|
+
payload: rscResult?.element ?? null,
|
|
129
|
+
params: rscResult?.params ?? readPublishedParams(undefined),
|
|
130
|
+
segmentInfo: takeEmbeddedSegmentInfo(),
|
|
131
|
+
};
|
|
132
|
+
//
|
|
133
|
+
// `hydrate` comes from the router's own init, so the router exists by
|
|
134
|
+
// construction when the tree it builds renders.
|
|
135
|
+
hydrate(page, (element) =>
|
|
136
|
+
reactRoot.hydrate(element, {
|
|
137
|
+
formState,
|
|
138
|
+
// Suppress recoverable hydration errors from deny/error signals
|
|
139
|
+
// inside Suspense boundaries. The server already handled these
|
|
140
|
+
// (wrapStreamWithErrorHandling closes the stream cleanly after
|
|
141
|
+
// the shell is flushed). React replays the error during hydration
|
|
142
|
+
// but the server HTML is already correct — no recovery needed.
|
|
143
|
+
onRecoverableError(error: unknown) {
|
|
144
|
+
if (isPageUnloading()) return;
|
|
145
|
+
if (process.env.NODE_ENV === 'development') {
|
|
146
|
+
queueOrShowHydrationError(error);
|
|
147
|
+
console.debug('[timber] Hydration recoverable error:', error);
|
|
148
|
+
}
|
|
149
|
+
},
|
|
150
|
+
})
|
|
151
|
+
);
|
|
152
|
+
}
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Browser Entry — Client-side hydration and navigation bootstrap.
|
|
3
|
+
*
|
|
4
|
+
* This is the thin orchestrator that coordinates the bootstrap sequence.
|
|
5
|
+
* Each responsibility is extracted into a focused module:
|
|
6
|
+
*
|
|
7
|
+
* action-dispatch.ts — server action callServer callback
|
|
8
|
+
* rsc-stream.ts — __timber_f chunk handling + ReadableStream
|
|
9
|
+
* router-init.ts — createRouter + Navigation API setup
|
|
10
|
+
* hydrate.ts — makes the server page current + hydrates the root
|
|
11
|
+
* post-hydration.ts — popstate, scroll
|
|
12
|
+
* hmr.ts — dev-only HMR + error forwarding
|
|
13
|
+
* scroll.ts — getScrollY helper
|
|
14
|
+
*
|
|
15
|
+
* Bootstrap call order contract:
|
|
16
|
+
*
|
|
17
|
+
* 1. setupServerActions() — register callServer (independent)
|
|
18
|
+
* takeEmbeddedFormState() — only on a page answering a no-JS action:
|
|
19
|
+
* decode its form state, and run 2–7 after
|
|
20
|
+
* 2. createRscPayloadStream() — decode inlined RSC payload
|
|
21
|
+
* 3. createReactRoot() + — the root host the router renders through,
|
|
22
|
+
* createTimberRouter() then the router + Navigation API
|
|
23
|
+
* 4. hydrateApp() — make the page current through the router,
|
|
24
|
+
* hydrate the root (no root without a payload)
|
|
25
|
+
* 5. setupPostHydration() — popstate, scroll
|
|
26
|
+
* 6. setupHmr() — dev-only HMR wiring
|
|
27
|
+
* 7. timber-ready signal — E2E readiness: React has committed the page
|
|
28
|
+
*
|
|
29
|
+
* Design docs: 18-build-system.md §"Entry Files", 19-client-navigation.md
|
|
30
|
+
*/
|
|
31
|
+
|
|
32
|
+
// @ts-expect-error — virtual module provided by timber-entries plugin
|
|
33
|
+
import config from 'virtual:timber-config';
|
|
34
|
+
// TIM-932: Populate the codec registry so Link's interpolateParams can
|
|
35
|
+
// use codec.serialize() for URL construction. Side-effect-only import.
|
|
36
|
+
// @ts-expect-error — virtual module provided by timber-routing plugin
|
|
37
|
+
import schemaCodecs from 'virtual:timber-schema';
|
|
38
|
+
import { setLinkCodecs } from '../../params/codec-registry.ts';
|
|
39
|
+
setLinkCodecs(schemaCodecs);
|
|
40
|
+
|
|
41
|
+
import { setClientDeploymentId, setStaticMode, setBasePath } from '../rsc-fetch.ts';
|
|
42
|
+
import { initStaleClient } from '../stale-client.ts';
|
|
43
|
+
|
|
44
|
+
import { setupServerActions } from './action-dispatch.ts';
|
|
45
|
+
import { createRscPayloadStream } from './rsc-stream.ts';
|
|
46
|
+
import { takeEmbeddedFormState } from './form-state.ts';
|
|
47
|
+
import { createTimberRouter } from './router-init.ts';
|
|
48
|
+
import { createReactRoot } from '../react-root.ts';
|
|
49
|
+
import type { TopLoaderConfig } from '../top-loader.tsx';
|
|
50
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
51
|
+
import { hydrateApp } from './hydrate.ts';
|
|
52
|
+
import { setupPostHydration } from './post-hydration.ts';
|
|
53
|
+
import { setupHmr } from './hmr.ts';
|
|
54
|
+
|
|
55
|
+
// ─── 1. Server Action Dispatch (independent) ────────────────────
|
|
56
|
+
|
|
57
|
+
setupServerActions();
|
|
58
|
+
|
|
59
|
+
// ─── 2–6. Bootstrap ─────────────────────────────────────────────
|
|
60
|
+
|
|
61
|
+
function bootstrap(runtimeConfig: typeof config, formState: ReactFormState | null): void {
|
|
62
|
+
// Initialize deployment ID for version skew detection (TIM-446).
|
|
63
|
+
// In dev mode this is null — skew checks are skipped.
|
|
64
|
+
const deploymentId = (runtimeConfig as Record<string, unknown>).deploymentId as string | null;
|
|
65
|
+
if (deploymentId) {
|
|
66
|
+
setClientDeploymentId(deploymentId);
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// Reactive skew recovery for failures that never reach the router —
|
|
70
|
+
// lazily imported client components, preloaded stylesheets. No-ops when
|
|
71
|
+
// there is no deployment ID, i.e. in dev (TIM-1260).
|
|
72
|
+
initStaleClient(deploymentId);
|
|
73
|
+
|
|
74
|
+
// Deployment base path (Vite's resolved `base`). Must be set before any
|
|
75
|
+
// RSC fetch — under a non-root base the payloads live below the prefix
|
|
76
|
+
// like every other emitted file (TIM-1261).
|
|
77
|
+
setBasePath((runtimeConfig as Record<string, unknown>).base as string | undefined);
|
|
78
|
+
|
|
79
|
+
// Static mode: fetch _rsc/*.rsc files instead of route URLs with
|
|
80
|
+
// Accept headers. Static hosts ignore Accept headers (TIM-1243).
|
|
81
|
+
// Only for built output — the .rsc files exist only after static
|
|
82
|
+
// generation, and `timber dev` renders route URLs on request like
|
|
83
|
+
// server mode, so dev keeps the Accept-header fetch path.
|
|
84
|
+
if (
|
|
85
|
+
(runtimeConfig as Record<string, unknown>).output === 'static' &&
|
|
86
|
+
!(runtimeConfig as Record<string, unknown>).dev
|
|
87
|
+
) {
|
|
88
|
+
setStaticMode(true);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// Step 2: Decode inlined RSC payload (may be null for JS-only clients)
|
|
92
|
+
const rscResult = createRscPayloadStream();
|
|
93
|
+
|
|
94
|
+
// Step 3: Create the React root host and the router that renders through
|
|
95
|
+
// it. The root itself is created lazily — by hydration below, or by the
|
|
96
|
+
// first navigation when there is no payload to hydrate (TIM-600).
|
|
97
|
+
const reactRoot = createReactRoot({
|
|
98
|
+
container: document,
|
|
99
|
+
topLoaderConfig: (runtimeConfig as { topLoader?: TopLoaderConfig }).topLoader,
|
|
100
|
+
// With a payload, the page is ready when React commits it — hydration
|
|
101
|
+
// is concurrent and finishes after this bootstrap returns.
|
|
102
|
+
onFirstCommit: rscResult ? signalReady : undefined,
|
|
103
|
+
});
|
|
104
|
+
const { router, navApiController, hydrate } = createTimberRouter({
|
|
105
|
+
render: reactRoot.render,
|
|
106
|
+
clientSegmentCache:
|
|
107
|
+
((runtimeConfig as Record<string, unknown>).clientSegmentCache as boolean) ?? false,
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
// Step 4: Make the page current and hydrate (no root without a payload)
|
|
111
|
+
hydrateApp({ rscResult, reactRoot, hydrate, formState });
|
|
112
|
+
|
|
113
|
+
// Step 5: Post-hydration wiring
|
|
114
|
+
setupPostHydration({ router, navApiController });
|
|
115
|
+
|
|
116
|
+
// Step 6: HMR (dev-only, no-op in production)
|
|
117
|
+
setupHmr(router);
|
|
118
|
+
|
|
119
|
+
// Step 7: Without a payload there is nothing to hydrate: the page is the
|
|
120
|
+
// server's HTML until the first navigation, and is ready now.
|
|
121
|
+
if (!rscResult) signalReady();
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
// ─── 7. Ready Signal ────────────────────────────────────────────
|
|
125
|
+
|
|
126
|
+
// Signal that React has committed the page (hydration, or the client render
|
|
127
|
+
// that replaced it), so the router and every component are live. Used by E2E
|
|
128
|
+
// tests to wait before interacting: signalling when the bootstrap returned
|
|
129
|
+
// instead let a test click a link mid-hydration, start a navigation, and
|
|
130
|
+
// hit a hydration mismatch on the top loader (TIM-1585).
|
|
131
|
+
// We append a <meta name="timber-ready"> tag rather than setting a
|
|
132
|
+
// data attribute on <html>. Since React owns the entire document
|
|
133
|
+
// via hydrateRoot(document, ...), mutating <html> attributes causes
|
|
134
|
+
// hydration mismatch warnings. Dynamically-added <meta> tags don't
|
|
135
|
+
// conflict because React doesn't reconcile them.
|
|
136
|
+
function signalReady(): void {
|
|
137
|
+
const readyMeta = document.createElement('meta');
|
|
138
|
+
readyMeta.name = 'timber-ready';
|
|
139
|
+
document.head.appendChild(readyMeta);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// A page answering a no-JS action must hydrate with the form state Fizz
|
|
143
|
+
// rendered, which is decoded first (design/08 §"No-JS Result Round-Trip").
|
|
144
|
+
// Every other page bootstraps synchronously, as it always has.
|
|
145
|
+
const embeddedFormState = takeEmbeddedFormState();
|
|
146
|
+
if (embeddedFormState) {
|
|
147
|
+
void embeddedFormState.then((formState) => bootstrap(config, formState));
|
|
148
|
+
} else {
|
|
149
|
+
bootstrap(config, null);
|
|
150
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Post-Hydration Wiring — popstate and scroll.
|
|
3
|
+
*
|
|
4
|
+
* Sets up everything that needs to happen after the React root exists:
|
|
5
|
+
* - Initializes scroll state for the initial entry
|
|
6
|
+
* - Registers popstate handler for back/forward navigation
|
|
7
|
+
* - Sets up debounced scroll position saving
|
|
8
|
+
*
|
|
9
|
+
* The initial page's history entry and segment cache are not written here:
|
|
10
|
+
* they are the router's, and hydration makes the page current through
|
|
11
|
+
* `RouterInstance.hydrate` like any other commit (TIM-1541).
|
|
12
|
+
*
|
|
13
|
+
* See design/19-client-navigation.md §"History Stack"
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import type { RouterInstance } from '#client-internal';
|
|
17
|
+
import type { NavigationApiController } from '../navigation-api.ts';
|
|
18
|
+
import { getScrollY } from './scroll.ts';
|
|
19
|
+
import { locationSearch } from '../location-search.ts';
|
|
20
|
+
|
|
21
|
+
interface PostHydrationOptions {
|
|
22
|
+
router: RouterInstance;
|
|
23
|
+
navApiController: NavigationApiController | null;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Wire up post-hydration event handlers and state.
|
|
28
|
+
*/
|
|
29
|
+
export function setupPostHydration({ router, navApiController }: PostHydrationOptions): void {
|
|
30
|
+
// Leave scrollRestoration = 'auto' so the browser natively restores
|
|
31
|
+
// scroll on reload, tab restore, and back-from-external-page — cases
|
|
32
|
+
// JS cannot reliably cover because 'manual' persists on the session
|
|
33
|
+
// history entry across reloads. For client navigations the router's
|
|
34
|
+
// restoreScrollAfterPaint() re-applies the saved position after React
|
|
35
|
+
// commits, writing last and winning over the browser's auto-restore.
|
|
36
|
+
// Explicitly set 'auto' to heal entries from previously-deployed builds
|
|
37
|
+
// that set 'manual'.
|
|
38
|
+
window.history.scrollRestoration = 'auto';
|
|
39
|
+
|
|
40
|
+
// Initialize scroll state for the initial entry. On reload the browser's
|
|
41
|
+
// native restoration may land before or after this runs; the debounced
|
|
42
|
+
// scroll listener below updates the entry state to the true position.
|
|
43
|
+
const initialScrollY = getScrollY();
|
|
44
|
+
if (navApiController) {
|
|
45
|
+
navApiController.saveScrollPosition(initialScrollY);
|
|
46
|
+
} else {
|
|
47
|
+
window.history.replaceState({ timber: true, scrollY: initialScrollY }, '');
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
// Register popstate handler for back/forward navigation.
|
|
51
|
+
// When Navigation API is active, the navigate event covers traversals —
|
|
52
|
+
// popstate is a no-op. When unavailable, popstate handles back/forward.
|
|
53
|
+
//
|
|
54
|
+
// Use pathname+search (not full href) to match the URL format used by
|
|
55
|
+
// navigate() — Link hrefs are relative paths like "/scroll-test/page-a".
|
|
56
|
+
// Read scrollY from history.state — the browser maintains per-entry state
|
|
57
|
+
// so duplicate URLs in history each have their own scroll position.
|
|
58
|
+
window.addEventListener('popstate', () => {
|
|
59
|
+
// Navigation API handles traversals via the navigate event.
|
|
60
|
+
if (navApiController) return;
|
|
61
|
+
|
|
62
|
+
const state = window.history.state;
|
|
63
|
+
const scrollY = state && typeof state.scrollY === 'number' ? state.scrollY : 0;
|
|
64
|
+
// `popstate` does not say which way the user went, and timber writes no
|
|
65
|
+
// index into `history.state` to work it out: any `pushState` the app
|
|
66
|
+
// makes itself (nuqs, a shallow update) can overwrite it. So the render is
|
|
67
|
+
// tagged `navigation-traverse`. The Navigation API path (navigation-api.ts)
|
|
68
|
+
// is the one that knows back from forward (TIM-1471).
|
|
69
|
+
void router.handlePopState(
|
|
70
|
+
window.location.pathname + locationSearch(),
|
|
71
|
+
scrollY,
|
|
72
|
+
undefined,
|
|
73
|
+
'navigation-traverse'
|
|
74
|
+
);
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
// Keep scroll position up to date as the user scrolls.
|
|
78
|
+
// This ensures that when the user presses back/forward, the departing
|
|
79
|
+
// page's scroll position is already saved in its history entry.
|
|
80
|
+
// When Navigation API is available, uses per-entry state via
|
|
81
|
+
// navigation.updateCurrentEntry(). Otherwise falls back to history.state.
|
|
82
|
+
// Debounced to avoid excessive state updates during smooth scrolling.
|
|
83
|
+
let scrollTimer: ReturnType<typeof setTimeout>;
|
|
84
|
+
function saveScrollPosition(): void {
|
|
85
|
+
clearTimeout(scrollTimer);
|
|
86
|
+
scrollTimer = setTimeout(() => {
|
|
87
|
+
const y = getScrollY();
|
|
88
|
+
if (navApiController) {
|
|
89
|
+
navApiController.saveScrollPosition(y);
|
|
90
|
+
} else {
|
|
91
|
+
const state = window.history.state;
|
|
92
|
+
if (state && typeof state === 'object') {
|
|
93
|
+
window.history.replaceState({ ...state, scrollY: y }, '');
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
}, 100);
|
|
97
|
+
}
|
|
98
|
+
window.addEventListener('scroll', saveScrollPosition, { passive: true });
|
|
99
|
+
}
|