@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
package/src/server/ssr-render.ts
CHANGED
|
@@ -5,14 +5,58 @@
|
|
|
5
5
|
* independently of the Vite RSC plugin runtime (which provides
|
|
6
6
|
* createFromReadableStream for decoding RSC streams).
|
|
7
7
|
*
|
|
8
|
+
* Uses a platform-adaptive rendering strategy:
|
|
9
|
+
* - **Node.js / Bun**: `renderToPipeableStream` — React pipes HTML chunks
|
|
10
|
+
* through Node.js native streams (C++ implementation). Each chunk flows
|
|
11
|
+
* through libuv buffers with zero Promise overhead.
|
|
12
|
+
* - **Cloudflare Workers / Edge**: `renderToReadableStream` — React outputs
|
|
13
|
+
* to Web Streams which are V8-native C++ built-ins on these platforms.
|
|
14
|
+
*
|
|
15
|
+
* The detection is automatic at runtime. Both paths produce a Web
|
|
16
|
+
* `ReadableStream<Uint8Array>` so downstream transforms (injectHead,
|
|
17
|
+
* injectRscPayload, compression) work identically regardless of platform.
|
|
18
|
+
*
|
|
8
19
|
* Design docs: 02-rendering-pipeline.md §"Single-Pass Rendering",
|
|
9
20
|
* 18-build-system.md §"Entry Files"
|
|
10
21
|
*/
|
|
11
22
|
|
|
12
23
|
import type { ReactNode } from 'react';
|
|
13
24
|
import { renderToReadableStream } from 'react-dom/server';
|
|
25
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
26
|
+
|
|
27
|
+
import { createRenderTimeout, RenderTimeoutError } from './render-timeout.ts';
|
|
28
|
+
import { logRenderError, logStreamingError } from './logger.ts';
|
|
29
|
+
import { nodeStreamsPlatform } from './node-streams-platform.ts';
|
|
30
|
+
import { isAbortError, noindexScript } from './render-utils.ts';
|
|
14
31
|
|
|
15
|
-
|
|
32
|
+
/**
|
|
33
|
+
* React's production error sanitization message. When NODE_ENV=production,
|
|
34
|
+
* React replaces all error messages with this string in renderToReadableStream
|
|
35
|
+
* and renderToPipeableStream. The original error was already logged by the
|
|
36
|
+
* RSC onError handler — logging the sanitized version in SSR is duplicate noise.
|
|
37
|
+
*/
|
|
38
|
+
const REACT_PROD_ERROR_PREFIX = 'An error occurred in the Server Components render';
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Returns true if this error was thrown in the RSC render and relayed by
|
|
42
|
+
* Flight, which means the RSC onError handler (rsc-stream.ts) already logged
|
|
43
|
+
* it with the full original message. Logging it again in SSR is a duplicate.
|
|
44
|
+
*
|
|
45
|
+
* In production React replaces a relayed error's message with a fixed
|
|
46
|
+
* sanitized one. In development it keeps the message, stamps the revived
|
|
47
|
+
* Error with the `environmentName` it was thrown in, and copies the digest
|
|
48
|
+
* our onError returned (`resolveErrorDev` and the `E` row in the Flight
|
|
49
|
+
* client). Both are needed: an Error passed as a *value* (a prop, `$Z`) is
|
|
50
|
+
* stamped with `environmentName` too but has no digest, and nothing logged
|
|
51
|
+
* it. When a client component throws one during SSR, it is logged here once,
|
|
52
|
+
* like any other error SSR throws itself (TIM-1537).
|
|
53
|
+
*/
|
|
54
|
+
function isFlightRelayedError(error: unknown): boolean {
|
|
55
|
+
if (!(error instanceof Error)) return false;
|
|
56
|
+
if (error.message.startsWith(REACT_PROD_ERROR_PREFIX)) return true;
|
|
57
|
+
const digest: unknown = Reflect.get(error, 'digest');
|
|
58
|
+
return 'environmentName' in error && typeof digest === 'string' && digest !== '';
|
|
59
|
+
}
|
|
16
60
|
|
|
17
61
|
/**
|
|
18
62
|
* Inline script that injects <meta name="robots" content="noindex"> into <head>.
|
|
@@ -25,96 +69,316 @@ import { formatSsrError } from './error-formatter.js';
|
|
|
25
69
|
*
|
|
26
70
|
* See design/05-streaming.md §"deny() inside Suspense"
|
|
27
71
|
*/
|
|
28
|
-
|
|
29
|
-
|
|
72
|
+
|
|
73
|
+
// ─── Platform Detection ──────────────────────────────────────────────────────
|
|
74
|
+
//
|
|
75
|
+
// Native Node streams or Web Streams, decided once by the platform probe every
|
|
76
|
+
// stream-kind decision shares (node-streams-platform.ts) — so SSR's pipeline
|
|
77
|
+
// always matches the kind of Flight source the RSC side renders. On Node the
|
|
78
|
+
// Node entries must load: a failure is a build bug and throws here, at module
|
|
79
|
+
// load, instead of silently falling back to a pipeline that rejects every
|
|
80
|
+
// Node Flight source.
|
|
81
|
+
//
|
|
82
|
+
// The SSR bundle resolves react-dom/server to the edge/browser export (which
|
|
83
|
+
// lacks renderToPipeableStream), so the Node entry is imported explicitly.
|
|
84
|
+
|
|
85
|
+
let _PassThrough: typeof import('node:stream').PassThrough | null = null;
|
|
86
|
+
let _renderToPipeableStream: typeof import('react-dom/server').renderToPipeableStream | null = null;
|
|
87
|
+
|
|
88
|
+
if (nodeStreamsPlatform) {
|
|
89
|
+
const [nodeStream, reactDomServer] = await Promise.all([
|
|
90
|
+
import('node:stream'),
|
|
91
|
+
import('react-dom/server.node'),
|
|
92
|
+
]);
|
|
93
|
+
_PassThrough = nodeStream.PassThrough;
|
|
94
|
+
_renderToPipeableStream = reactDomServer.renderToPipeableStream;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/** Options shared by both SSR render paths (Node streams and Web Streams). */
|
|
98
|
+
export interface SsrStreamOptions {
|
|
99
|
+
bootstrapScriptContent?: string;
|
|
100
|
+
/** Request CSP nonce — stamped by Fizz on the bootstrap and runtime scripts. */
|
|
101
|
+
nonce?: string;
|
|
102
|
+
/** A no-JS action's form state, for the `useActionState` hook that submitted. */
|
|
103
|
+
formState?: ReactFormState;
|
|
104
|
+
deferSuspenseFor?: number;
|
|
105
|
+
signal?: AbortSignal;
|
|
106
|
+
renderTimeoutMs?: number;
|
|
107
|
+
/** Request info threaded into render-error logs (method/path). */
|
|
108
|
+
requestInfo?: { method: string; path: string };
|
|
109
|
+
/**
|
|
110
|
+
* Fired synchronously when the render function is about to resolve
|
|
111
|
+
* (i.e. at hold-end / shell-ready). `resolved` reports whether Fizz's
|
|
112
|
+
* allReady had already settled by that moment. The SSR entry returns it
|
|
113
|
+
* as `SsrRenderResult.fizzAllReadyResolved` so the RSC renderer can
|
|
114
|
+
* decide whether signal promotion can be short-circuited.
|
|
115
|
+
*/
|
|
116
|
+
onFizzAllReadyResolved?: (resolved: boolean) => void;
|
|
117
|
+
}
|
|
30
118
|
|
|
31
119
|
/**
|
|
32
120
|
* Render a React element tree to a ReadableStream of HTML.
|
|
33
121
|
*
|
|
34
|
-
*
|
|
122
|
+
* Automatically selects the optimal rendering path for the platform:
|
|
123
|
+
* - Node.js/Bun: `renderToPipeableStream` → Node.js native streams (a `NodeBodyResponse`)
|
|
124
|
+
* - CF Workers/Edge: `renderToReadableStream` → native Web Streams
|
|
125
|
+
*
|
|
35
126
|
* The returned stream begins yielding after onShellReady — everything
|
|
36
127
|
* outside <Suspense> boundaries is in the shell.
|
|
37
128
|
*
|
|
38
|
-
* With progressive streaming, the RSC stream is piped directly to SSR
|
|
39
|
-
* without buffering. If deny() was called outside a Suspense boundary,
|
|
40
|
-
* the RSC stream encodes an error in the shell — renderToReadableStream
|
|
41
|
-
* rejects, and the RSC entry catches this to render a deny page with
|
|
42
|
-
* the correct HTTP status code. If deny() was inside Suspense, the shell
|
|
43
|
-
* succeeds (200 committed) and the error streams as an error boundary.
|
|
44
|
-
*
|
|
45
129
|
* @param element - The React element tree decoded from the RSC stream
|
|
46
130
|
* @param options - Optional configuration
|
|
47
|
-
* @param options.bootstrapScriptContent - Inline JS injected by React as a
|
|
48
|
-
* non-deferred `<script>` in the shell HTML. Executes immediately during
|
|
49
|
-
* parsing — even while Suspense boundaries are still streaming. Used to
|
|
50
|
-
* kick off module loading via dynamic `import()` so hydration can start
|
|
51
|
-
* before the HTML stream closes.
|
|
52
131
|
* @returns A ReadableStream of HTML bytes with hydration markers
|
|
53
132
|
*/
|
|
54
133
|
export async function renderSsrStream(
|
|
55
134
|
element: ReactNode,
|
|
56
|
-
options?:
|
|
135
|
+
options?: SsrStreamOptions
|
|
57
136
|
): Promise<ReadableStream<Uint8Array>> {
|
|
137
|
+
return renderViaReadableStream(element, options);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** Whether the current platform uses native Node.js streams for SSR. */
|
|
141
|
+
export const useNodeStreams = nodeStreamsPlatform;
|
|
142
|
+
|
|
143
|
+
// ─── Node.js Path: renderToPipeableStream ────────────────────────────────────
|
|
144
|
+
//
|
|
145
|
+
// Uses React's Node.js-native API. HTML chunks flow through C++ stream
|
|
146
|
+
// buffers with zero Promise allocations per chunk. Returns a Node.js
|
|
147
|
+
// Readable — the caller (ssr-entry.ts) pipes through Node.js Transform
|
|
148
|
+
// streams for injectHead/injectRscPayload and sends the result as a
|
|
149
|
+
// NodeBodyResponse, which the adapter pipes to the socket.
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Render via renderToPipeableStream, returning a Node.js Readable.
|
|
153
|
+
*
|
|
154
|
+
* The entire HTML rendering + post-processing pipeline stays in native
|
|
155
|
+
* Node.js streams, to the socket (node-body-response.ts).
|
|
156
|
+
*/
|
|
157
|
+
export async function renderSsrNodeStream(
|
|
158
|
+
element: ReactNode,
|
|
159
|
+
options?: SsrStreamOptions
|
|
160
|
+
): Promise<import('node:stream').Readable> {
|
|
58
161
|
const signal = options?.signal;
|
|
59
|
-
const
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
162
|
+
const deferMs = options?.deferSuspenseFor;
|
|
163
|
+
const timeoutMs = options?.renderTimeoutMs;
|
|
164
|
+
const requestInfo = options?.requestInfo;
|
|
165
|
+
const onFizzAllReadyResolved = options?.onFizzAllReadyResolved;
|
|
166
|
+
|
|
167
|
+
return new Promise<import('node:stream').Readable>((resolve, reject) => {
|
|
168
|
+
const passthrough = new _PassThrough!();
|
|
169
|
+
|
|
170
|
+
let allReadyResolve: (() => void) | null = null;
|
|
171
|
+
let allReadyReject: ((reason?: unknown) => void) | null = null;
|
|
172
|
+
let allReadyFired = false;
|
|
173
|
+
const allReady = new Promise<void>((resolve, reject) => {
|
|
174
|
+
allReadyResolve = resolve;
|
|
175
|
+
allReadyReject = reject;
|
|
176
|
+
});
|
|
177
|
+
allReady.catch(() => {});
|
|
178
|
+
|
|
179
|
+
const { pipe, abort } = _renderToPipeableStream!(element, {
|
|
180
|
+
bootstrapScriptContent: options?.bootstrapScriptContent || undefined,
|
|
181
|
+
nonce: options?.nonce,
|
|
182
|
+
formState: options?.formState,
|
|
183
|
+
|
|
184
|
+
onShellReady() {
|
|
185
|
+
if (deferMs && deferMs > 0) {
|
|
186
|
+
Promise.race([allReady, new Promise<void>((r) => setTimeout(r, deferMs))]).then(() => {
|
|
187
|
+
onFizzAllReadyResolved?.(allReadyFired);
|
|
188
|
+
pipe(passthrough);
|
|
189
|
+
resolve(passthrough);
|
|
190
|
+
});
|
|
191
|
+
} else {
|
|
192
|
+
// No hold — but give Fizz one task before the first pull. Its early
|
|
193
|
+
// work is scheduled as microtasks, and piping inside onShellReady
|
|
194
|
+
// flushes at once: anything that settles a few microtasks later (a
|
|
195
|
+
// Suspense boundary over cached data, streamed metadata) goes out
|
|
196
|
+
// as a fallback plus a reveal script instead of inline HTML — and
|
|
197
|
+
// the Web path, which flushes when the stream is pulled, inlines
|
|
198
|
+
// it. Next.js waits the same task (vercel/next.js#86311, #94347).
|
|
199
|
+
// When everything settles in that task, allReady has fired and the
|
|
200
|
+
// RSC entry skips its signal-promotion retry loop.
|
|
201
|
+
setImmediate(() => {
|
|
202
|
+
onFizzAllReadyResolved?.(allReadyFired);
|
|
203
|
+
pipe(passthrough);
|
|
204
|
+
resolve(passthrough);
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
},
|
|
208
|
+
|
|
209
|
+
onAllReady() {
|
|
210
|
+
allReadyFired = true;
|
|
211
|
+
allReadyResolve?.();
|
|
212
|
+
},
|
|
213
|
+
|
|
214
|
+
onShellError(error: unknown) {
|
|
215
|
+
// Reject allReady so the render timeout is cancelled.
|
|
216
|
+
// Without this, a pre-shell failure leaves the timer
|
|
217
|
+
// running for the full timeout window.
|
|
218
|
+
allReadyReject?.(error);
|
|
219
|
+
reject(error);
|
|
220
|
+
},
|
|
221
|
+
|
|
222
|
+
onError(error: unknown) {
|
|
223
|
+
if (isAbortError(error) || signal?.aborted) return;
|
|
224
|
+
// Skip errors Flight relayed — the original was already logged by
|
|
225
|
+
// the RSC onError with full details.
|
|
226
|
+
if (isFlightRelayedError(error)) return;
|
|
227
|
+
logRenderError({
|
|
228
|
+
method: requestInfo?.method ?? '',
|
|
229
|
+
path: requestInfo?.path ?? '',
|
|
230
|
+
error,
|
|
231
|
+
});
|
|
232
|
+
},
|
|
233
|
+
});
|
|
234
|
+
|
|
235
|
+
// Wire abort to both request signal AND render timeout.
|
|
236
|
+
// If the client stays connected but a downstream fetch hangs,
|
|
237
|
+
// the timeout ensures abort() is eventually called.
|
|
238
|
+
if (signal) {
|
|
239
|
+
if (signal.aborted) {
|
|
240
|
+
abort();
|
|
241
|
+
} else {
|
|
242
|
+
signal.addEventListener('abort', () => abort(), { once: true });
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
if (timeoutMs && timeoutMs > 0) {
|
|
247
|
+
const renderTimeout = createRenderTimeout(timeoutMs, signal);
|
|
248
|
+
renderTimeout.signal.addEventListener(
|
|
249
|
+
'abort',
|
|
250
|
+
() => {
|
|
251
|
+
logRenderError({
|
|
252
|
+
method: requestInfo?.method ?? '',
|
|
253
|
+
path: requestInfo?.path ?? '',
|
|
254
|
+
error: new Error(
|
|
255
|
+
`SSR render timed out after ${timeoutMs}ms — aborting. ` +
|
|
256
|
+
'A Suspense component or downstream fetch may be hanging.'
|
|
257
|
+
),
|
|
258
|
+
});
|
|
259
|
+
abort(renderTimeout.signal.reason);
|
|
260
|
+
},
|
|
261
|
+
{ once: true }
|
|
262
|
+
);
|
|
263
|
+
// Cancel the timeout when the render completes OR on pre-shell
|
|
264
|
+
// failure. Without the catch branch, onShellError → reject()
|
|
265
|
+
// would leave the timer running for the full timeout window.
|
|
266
|
+
allReady.then(
|
|
267
|
+
() => renderTimeout.cancel(),
|
|
268
|
+
() => renderTimeout.cancel()
|
|
269
|
+
);
|
|
270
|
+
}
|
|
68
271
|
});
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
// ─── Web Streams Path: renderToReadableStream ────────────────────────────────
|
|
275
|
+
//
|
|
276
|
+
// Uses React's Web Streams API. On Cloudflare Workers, ReadableStream is a
|
|
277
|
+
// V8-native C++ built-in, making this the fastest path for that platform.
|
|
278
|
+
// On Node.js, Web Streams are a JS reimplementation — slower, but this path
|
|
279
|
+
// is only used as a fallback when Node.js native streams aren't available.
|
|
280
|
+
|
|
281
|
+
async function renderViaReadableStream(
|
|
282
|
+
element: ReactNode,
|
|
283
|
+
options?: SsrStreamOptions
|
|
284
|
+
): Promise<ReadableStream<Uint8Array>> {
|
|
285
|
+
const signal = options?.signal;
|
|
286
|
+
const timeoutMs = options?.renderTimeoutMs;
|
|
287
|
+
const requestInfo = options?.requestInfo;
|
|
288
|
+
const onFizzAllReadyResolved = options?.onFizzAllReadyResolved;
|
|
289
|
+
|
|
290
|
+
// If a render timeout is configured, create a combined signal that
|
|
291
|
+
// fires on either request abort OR timeout — whichever comes first.
|
|
292
|
+
let renderTimeout: import('./render-timeout.ts').RenderTimeout | null = null;
|
|
293
|
+
let effectiveSignal = signal;
|
|
294
|
+
if (timeoutMs && timeoutMs > 0) {
|
|
295
|
+
renderTimeout = createRenderTimeout(timeoutMs, signal);
|
|
296
|
+
effectiveSignal = renderTimeout.signal;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
let stream: Awaited<ReturnType<typeof renderToReadableStream>>;
|
|
300
|
+
try {
|
|
301
|
+
stream = await renderToReadableStream(element, {
|
|
302
|
+
bootstrapScriptContent: options?.bootstrapScriptContent || undefined,
|
|
303
|
+
nonce: options?.nonce,
|
|
304
|
+
formState: options?.formState,
|
|
305
|
+
signal: effectiveSignal,
|
|
306
|
+
onError(error: unknown) {
|
|
307
|
+
if (isAbortError(error) || effectiveSignal?.aborted) return;
|
|
308
|
+
if (error instanceof RenderTimeoutError) {
|
|
309
|
+
logRenderError({
|
|
310
|
+
method: requestInfo?.method ?? '',
|
|
311
|
+
path: requestInfo?.path ?? '',
|
|
312
|
+
error: new Error(
|
|
313
|
+
`SSR render timed out after ${timeoutMs}ms — aborting. ` +
|
|
314
|
+
'A Suspense component or downstream fetch may be hanging.'
|
|
315
|
+
),
|
|
316
|
+
});
|
|
317
|
+
return;
|
|
318
|
+
}
|
|
319
|
+
// Skip errors Flight relayed — the original was already logged by
|
|
320
|
+
// the RSC onError with full details.
|
|
321
|
+
if (isFlightRelayedError(error)) return;
|
|
322
|
+
logRenderError({
|
|
323
|
+
method: requestInfo?.method ?? '',
|
|
324
|
+
path: requestInfo?.path ?? '',
|
|
325
|
+
error,
|
|
326
|
+
});
|
|
327
|
+
},
|
|
328
|
+
});
|
|
329
|
+
} catch (error) {
|
|
330
|
+
// Pre-shell failure (e.g. RSC stream error). Cancel the render
|
|
331
|
+
// timeout so it doesn't leak a timer + abort callback for the
|
|
332
|
+
// full timeout window. Under repeated pre-shell failures this
|
|
333
|
+
// would accumulate unnecessary timers.
|
|
334
|
+
renderTimeout?.cancel();
|
|
335
|
+
throw error;
|
|
336
|
+
}
|
|
69
337
|
|
|
70
338
|
// Prevent unhandled promise rejection from streaming-phase errors.
|
|
71
|
-
// React DOM Server exposes `allReady` — a promise that resolves when
|
|
72
|
-
// ALL content (including Suspense boundaries) has been rendered. If a
|
|
73
|
-
// streaming-phase error occurs (e.g. React boundary flush failure),
|
|
74
|
-
// `allReady` rejects independently of the stream. Without this catch,
|
|
75
|
-
// the rejection becomes an unhandled promise rejection that crashes
|
|
76
|
-
// the Node.js process.
|
|
77
339
|
stream.allReady.catch(() => {});
|
|
78
340
|
|
|
341
|
+
// Cancel the render timeout once allReady resolves (render completed).
|
|
342
|
+
if (renderTimeout) {
|
|
343
|
+
stream.allReady.then(() => renderTimeout!.cancel()).catch(() => renderTimeout!.cancel());
|
|
344
|
+
}
|
|
345
|
+
|
|
79
346
|
// deferSuspenseFor hold: delay the first read so React can resolve
|
|
80
347
|
// fast-completing Suspense boundaries before we read the shell HTML.
|
|
81
|
-
// renderToReadableStream generates HTML lazily on pull — if we wait
|
|
82
|
-
// before reading, React resolves pending boundaries and inlines their
|
|
83
|
-
// content instead of serializing fallbacks. Race allReady against
|
|
84
|
-
// deferSuspenseFor so we don't wait longer than necessary.
|
|
85
348
|
// See design/05-streaming.md §"deferSuspenseFor"
|
|
349
|
+
//
|
|
350
|
+
// While we're holding, also track whether `stream.allReady` settled
|
|
351
|
+
// before the timer. That boolean is the Option-1 signal-promotion
|
|
352
|
+
// short-circuit key — see SsrRenderResult.fizzAllReadyResolved and
|
|
353
|
+
// design/spike-signal-promotion-protocol.md.
|
|
354
|
+
let fizzAllReadyResolved = false;
|
|
355
|
+
const allReadyTap = stream.allReady.then(
|
|
356
|
+
() => {
|
|
357
|
+
fizzAllReadyResolved = true;
|
|
358
|
+
},
|
|
359
|
+
() => {
|
|
360
|
+
// allReady rejections are already swallowed above; keep false.
|
|
361
|
+
}
|
|
362
|
+
);
|
|
86
363
|
const deferMs = options?.deferSuspenseFor;
|
|
87
364
|
if (deferMs && deferMs > 0) {
|
|
88
|
-
await Promise.race([
|
|
89
|
-
stream.allReady,
|
|
90
|
-
new Promise<void>((resolve) => setTimeout(resolve, deferMs)),
|
|
91
|
-
]);
|
|
365
|
+
await Promise.race([allReadyTap, new Promise<void>((resolve) => setTimeout(resolve, deferMs))]);
|
|
92
366
|
}
|
|
367
|
+
onFizzAllReadyResolved?.(fizzAllReadyResolved);
|
|
93
368
|
|
|
94
|
-
|
|
95
|
-
// The stream is ready to read — the shell (everything outside
|
|
96
|
-
// Suspense boundaries) is available. Suspense content streams
|
|
97
|
-
// into the open connection as it resolves.
|
|
98
|
-
//
|
|
99
|
-
// Wrap the stream in an error-resilient transform. With progressive
|
|
100
|
-
// streaming, errors inside Suspense boundaries (e.g. deny() or throws
|
|
101
|
-
// in async components) cause React's stream to error during the flush
|
|
102
|
-
// phase. The onError callback logs the error, but the stream error
|
|
103
|
-
// would become an unhandled promise rejection and crash the process.
|
|
104
|
-
// The transform catches these post-shell streaming errors and closes
|
|
105
|
-
// the stream cleanly — the shell (with correct status code) has
|
|
106
|
-
// already been sent.
|
|
107
|
-
return wrapStreamWithErrorHandling(stream, signal);
|
|
369
|
+
return wrapStreamWithErrorHandling(stream, signal, options?.nonce);
|
|
108
370
|
}
|
|
109
371
|
|
|
372
|
+
// ─── Shared Utilities ────────────────────────────────────────────────────────
|
|
373
|
+
|
|
110
374
|
/**
|
|
111
375
|
* Wrap an HTML stream with error handling for the streaming phase.
|
|
112
376
|
*
|
|
113
377
|
* During progressive RSC→SSR streaming, errors in Suspense boundaries
|
|
114
378
|
* (e.g. deny() inside Suspense, throws in async components) cause
|
|
115
|
-
* React DOM's
|
|
116
|
-
*
|
|
117
|
-
*
|
|
379
|
+
* React DOM's stream to error after the shell has been flushed. Without
|
|
380
|
+
* this wrapper, the stream error becomes an unhandled promise rejection
|
|
381
|
+
* that crashes the process.
|
|
118
382
|
*
|
|
119
383
|
* The wrapper catches streaming-phase errors, logs them, and closes
|
|
120
384
|
* the output stream cleanly. The shell (headers, status code, content
|
|
@@ -123,7 +387,8 @@ export async function renderSsrStream(
|
|
|
123
387
|
/** @internal Exported for testing only. */
|
|
124
388
|
export function wrapStreamWithErrorHandling(
|
|
125
389
|
stream: ReadableStream<Uint8Array>,
|
|
126
|
-
signal?: AbortSignal
|
|
390
|
+
signal?: AbortSignal,
|
|
391
|
+
nonce?: string
|
|
127
392
|
): ReadableStream<Uint8Array> {
|
|
128
393
|
const reader = stream.getReader();
|
|
129
394
|
const encoder = new TextEncoder();
|
|
@@ -138,19 +403,12 @@ export function wrapStreamWithErrorHandling(
|
|
|
138
403
|
}
|
|
139
404
|
controller.enqueue(value);
|
|
140
405
|
} catch (error) {
|
|
141
|
-
// Connection abort (user refreshed or navigated away) — close
|
|
142
|
-
// silently without logging. This is not an application error.
|
|
143
406
|
if (isAbortError(error) || signal?.aborted) {
|
|
144
407
|
controller.close();
|
|
145
408
|
return;
|
|
146
409
|
}
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
// The shell has already been sent with status 200. Inject a
|
|
150
|
-
// noindex meta tag so search engines don't index this error page,
|
|
151
|
-
// then close cleanly. See design/05-streaming.md.
|
|
152
|
-
console.error('[timber] SSR streaming error (post-shell):', formatSsrError(error));
|
|
153
|
-
controller.enqueue(encoder.encode(NOINDEX_SCRIPT));
|
|
410
|
+
logStreamingError({ error });
|
|
411
|
+
controller.enqueue(encoder.encode(noindexScript(nonce)));
|
|
154
412
|
controller.close();
|
|
155
413
|
}
|
|
156
414
|
},
|
|
@@ -161,40 +419,15 @@ export function wrapStreamWithErrorHandling(
|
|
|
161
419
|
}
|
|
162
420
|
|
|
163
421
|
/**
|
|
164
|
-
*
|
|
165
|
-
*
|
|
166
|
-
*
|
|
167
|
-
* the
|
|
168
|
-
* is not an application error — suppress it from error boundaries and logs.
|
|
169
|
-
*/
|
|
170
|
-
function isAbortError(error: unknown): boolean {
|
|
171
|
-
if (error instanceof DOMException && error.name === 'AbortError') return true;
|
|
172
|
-
if (error instanceof Error && error.name === 'AbortError') return true;
|
|
173
|
-
return false;
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
/**
|
|
177
|
-
* Build a Response from the SSR HTML stream with the correct
|
|
178
|
-
* status code and headers from the navigation context.
|
|
179
|
-
*
|
|
180
|
-
* Sets content-type to text/html if not already set by middleware.
|
|
181
|
-
*
|
|
182
|
-
* @param htmlStream - The HTML stream from renderSsrStream
|
|
183
|
-
* @param statusCode - The committed HTTP status code from RSC
|
|
184
|
-
* @param responseHeaders - Response headers from middleware/proxy
|
|
185
|
-
* @returns A Response ready to send to the client
|
|
422
|
+
* Status and headers for an SSR document: the pipeline's headers, copied (SSR
|
|
423
|
+
* never writes through `NavContext.responseHeaders`), with an HTML content
|
|
424
|
+
* type unless the app set one. The Node pipeline sends its body as a
|
|
425
|
+
* `NodeBodyResponse`; the Web pipeline as a `Response`.
|
|
186
426
|
*/
|
|
187
|
-
export function
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
): Response {
|
|
192
|
-
if (!responseHeaders.has('content-type')) {
|
|
193
|
-
responseHeaders.set('content-type', 'text/html; charset=utf-8');
|
|
427
|
+
export function ssrResponseInit(statusCode: number, responseHeaders: Headers): ResponseInit {
|
|
428
|
+
const headers = new Headers(responseHeaders);
|
|
429
|
+
if (!headers.has('content-type')) {
|
|
430
|
+
headers.set('content-type', 'text/html; charset=utf-8');
|
|
194
431
|
}
|
|
195
|
-
|
|
196
|
-
return new Response(htmlStream, {
|
|
197
|
-
status: statusCode,
|
|
198
|
-
headers: responseHeaders,
|
|
199
|
-
});
|
|
432
|
+
return { status: statusCode, headers };
|
|
200
433
|
}
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SSR wrapper chain — the same components the client hydration tree renders.
|
|
3
|
+
*
|
|
4
|
+
* During hydration, React's useId() generates deterministic IDs based on
|
|
5
|
+
* the component's position in the fiber tree. If the SSR tree has fewer
|
|
6
|
+
* wrapper components than the client hydration tree, every useId() call
|
|
7
|
+
* produces different IDs — causing hydration mismatches in libraries like
|
|
8
|
+
* Radix UI that rely on useId() internally.
|
|
9
|
+
*
|
|
10
|
+
* The client tree (`renderTree` in browser-entry/router-init.ts, used by
|
|
11
|
+
* hydrate.ts too) wraps the RSC element with:
|
|
12
|
+
* NavigationRoot → Fragment(TopLoader, ...) →
|
|
13
|
+
* TimberNuqsAdapter → NuqsAdapterProvider →
|
|
14
|
+
* SlotContentCacheContext.Provider → SegmentUpdateContext.Provider →
|
|
15
|
+
* NavigationProvider → PayloadRoot → ParamsProvider → element
|
|
16
|
+
*
|
|
17
|
+
* The SSR tree renders the REAL NavigationProvider and PayloadRoot rather
|
|
18
|
+
* than no-op mirrors (TIM-1424). Two consequences:
|
|
19
|
+
*
|
|
20
|
+
* 1. `usePathname()` / `useSearchParams()` resolve from NavigationContext
|
|
21
|
+
* during SSR — the same code path as the browser — with the request's
|
|
22
|
+
* pathname and raw search string. The raw string preserves repeated
|
|
23
|
+
* query keys (`?tag=a&tag=b`) and, since TIM-1428, is the only
|
|
24
|
+
* representation of search state here — it feeds the nuqs SSR adapter
|
|
25
|
+
* too, so no collapsed record exists to drift from it.
|
|
26
|
+
* 2. `useSegmentParams()` resolves from ParamsContext, published by
|
|
27
|
+
* PayloadRoot from the same payload root row the browser will read —
|
|
28
|
+
* one derivation on both sides instead of two that must agree.
|
|
29
|
+
*
|
|
30
|
+
* Per-request isolation is by construction: the provider values are part
|
|
31
|
+
* of this request's element tree, so concurrent requests cannot observe
|
|
32
|
+
* each other's values — stronger than the ALS path, which remains for
|
|
33
|
+
* `useCookie()`.
|
|
34
|
+
*
|
|
35
|
+
* **What actually shifts a useId is a fork, not depth.** `useId` derives from
|
|
36
|
+
* React's tree context, which only changes where a fiber has more than one
|
|
37
|
+
* child — here, `Fragment(TopLoader, element)`. A single-child wrapper, plain
|
|
38
|
+
* component or context provider, leaves every id below it unchanged; that is
|
|
39
|
+
* verified by tests/ssr-wrapper-parity.test.ts, not assumed. So the
|
|
40
|
+
* client-only `SegmentUpdateContext.Provider` and
|
|
41
|
+
* `SlotContentCacheContext.Provider` (single child each) have no mirror
|
|
42
|
+
* here and need none. Mirror a new wrapper only if it branches.
|
|
43
|
+
*
|
|
44
|
+
* Related issues: facebook/react#24669, radix-ui/primitives#3700
|
|
45
|
+
* See design/02-rendering-pipeline.md §"RSC → SSR → Client Hydration"
|
|
46
|
+
*/
|
|
47
|
+
|
|
48
|
+
import { createElement, Fragment, type ReactNode } from 'react';
|
|
49
|
+
import { withNuqsSsrAdapter } from './nuqs-ssr-provider.tsx';
|
|
50
|
+
import { NavigationProvider } from '../client/navigation-context.ts';
|
|
51
|
+
import { PayloadRoot } from '../client/params-context.ts';
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* SSR equivalent of NavigationRoot.
|
|
55
|
+
*
|
|
56
|
+
* On the client, the router renders NavigationRoot via `root.render` in a transition,
|
|
57
|
+
* rendering `Fragment(TopLoader, element)` — or the element alone when the top
|
|
58
|
+
* loader is disabled.
|
|
59
|
+
*
|
|
60
|
+
* The Fragment is the part that matters: it forks, so it advances React's tree
|
|
61
|
+
* context. Both sides must agree on whether it is there, which is why
|
|
62
|
+
* `hasTopLoader` is threaded in from the same config the client reads.
|
|
63
|
+
*/
|
|
64
|
+
function SsrNavigationRoot({
|
|
65
|
+
children,
|
|
66
|
+
hasTopLoader,
|
|
67
|
+
}: {
|
|
68
|
+
children?: ReactNode;
|
|
69
|
+
hasTopLoader: boolean;
|
|
70
|
+
}): ReactNode {
|
|
71
|
+
if (hasTopLoader) {
|
|
72
|
+
return createElement(Fragment, null, createElement(SsrTopLoader, null), children);
|
|
73
|
+
}
|
|
74
|
+
return children as ReactNode;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* SSR equivalent of TopLoader.
|
|
79
|
+
* Exists as a fiber node to match the client tree depth; renders nothing.
|
|
80
|
+
*/
|
|
81
|
+
function SsrTopLoader(): ReactNode {
|
|
82
|
+
return null;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* SSR equivalent of TimberNuqsAdapter component boundary.
|
|
87
|
+
* The actual NuqsAdapterProvider (from createAdapterProvider) is added
|
|
88
|
+
* inside this wrapper via withNuqsSsrAdapter, matching the client's
|
|
89
|
+
* TimberNuqsAdapter → NuqsAdapterProvider nesting.
|
|
90
|
+
*/
|
|
91
|
+
function SsrNuqsWrapper({ search, children }: { search: string; children?: ReactNode }): ReactNode {
|
|
92
|
+
// withNuqsSsrAdapter creates a NuqsAdapterProvider (from createAdapterProvider),
|
|
93
|
+
// which is the same component factory used by TimberNuqsAdapter on the client.
|
|
94
|
+
// Both produce the same internal component boundary depth.
|
|
95
|
+
return withNuqsSsrAdapter(search, children);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** Per-request inputs for the SSR wrapper chain. */
|
|
99
|
+
export interface SsrWrapOptions {
|
|
100
|
+
/** Request pathname for NavigationProvider. */
|
|
101
|
+
pathname: string;
|
|
102
|
+
/**
|
|
103
|
+
* Raw app-visible query string (`''` or `?…`) for NavigationProvider AND
|
|
104
|
+
* the nuqs SSR adapter — one representation, preserving repeated keys
|
|
105
|
+
* (`?tag=a&tag=b`) on both consumers (TIM-1428).
|
|
106
|
+
*/
|
|
107
|
+
search: string;
|
|
108
|
+
/**
|
|
109
|
+
* The payload's params, or a thenable of them, for PayloadRoot — the
|
|
110
|
+
* `params` half of `splitPayloadRoot(root)`. Same source the browser
|
|
111
|
+
* hands to the same component during hydration.
|
|
112
|
+
*/
|
|
113
|
+
paramsSource: unknown;
|
|
114
|
+
/** Whether the top loader is enabled (must match client config). */
|
|
115
|
+
hasTopLoader: boolean;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Wrap the SSR element tree with the same component boundaries as the
|
|
120
|
+
* client hydration tree — real providers, not mirrors — so hooks resolve
|
|
121
|
+
* identically on both sides and useId() matches.
|
|
122
|
+
*
|
|
123
|
+
* Client tree (browser-entry/hydrate.ts):
|
|
124
|
+
* NavigationRoot
|
|
125
|
+
* → Fragment(TopLoader, element)
|
|
126
|
+
* → TimberNuqsAdapter
|
|
127
|
+
* → NuqsAdapterProvider (from createAdapterProvider)
|
|
128
|
+
* → SlotContentCacheContext.Provider (client-only, single child)
|
|
129
|
+
* → SegmentUpdateContext.Provider (client-only, single child)
|
|
130
|
+
* → NavigationProvider
|
|
131
|
+
* → PayloadRoot → ParamsProvider
|
|
132
|
+
* → [RSC element]
|
|
133
|
+
*
|
|
134
|
+
* SSR tree (this function):
|
|
135
|
+
* SsrNavigationRoot
|
|
136
|
+
* → Fragment(SsrTopLoader, element)
|
|
137
|
+
* → SsrNuqsWrapper
|
|
138
|
+
* → NuqsAdapterProvider (from withNuqsSsrAdapter → createAdapterProvider)
|
|
139
|
+
* → NavigationProvider (real — same component)
|
|
140
|
+
* → PayloadRoot → ParamsProvider (real — same components)
|
|
141
|
+
* → [RSC element]
|
|
142
|
+
*/
|
|
143
|
+
export function wrapSsrElement(element: ReactNode, opts: SsrWrapOptions): ReactNode {
|
|
144
|
+
// Build inside-out to match the client's createElement chain in
|
|
145
|
+
// browser-entry/router-init.ts renderTree(), which hydration builds with too.
|
|
146
|
+
|
|
147
|
+
// 1. Innermost: PayloadRoot publishes the payload's params over the tree.
|
|
148
|
+
const withParams = createElement(PayloadRoot, { source: opts.paramsSource }, element);
|
|
149
|
+
|
|
150
|
+
// 2. NavigationProvider with the request's address-bar state.
|
|
151
|
+
const withNav = createElement(
|
|
152
|
+
NavigationProvider,
|
|
153
|
+
{ value: { pathname: opts.pathname, search: opts.search } },
|
|
154
|
+
withParams
|
|
155
|
+
);
|
|
156
|
+
|
|
157
|
+
// 3. TimberNuqsAdapter equivalent (wraps withNuqsSsrAdapter for the actual nuqs provider)
|
|
158
|
+
const withNuqs = createElement(SsrNuqsWrapper, { search: opts.search }, withNav);
|
|
159
|
+
|
|
160
|
+
// 4. Outermost: NavigationRoot equivalent (the TopLoader fork)
|
|
161
|
+
return createElement(SsrNavigationRoot, { hasTopLoader: opts.hasTopLoader }, withNuqs);
|
|
162
|
+
}
|