@timber-js/app 0.2.0-alpha.22 → 0.2.0-alpha.220
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +8 -0
- package/agent-skill.md +351 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-BwkmAYXq.js +1243 -0
- package/dist/_chunks/actions-BwkmAYXq.js.map +1 -0
- package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
- package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
- package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
- package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
- package/dist/_chunks/base-path-DaQrzbez.js +80 -0
- package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
- package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
- package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
- package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
- package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
- package/dist/_chunks/cache-api-LA3sBpUS.js +1182 -0
- package/dist/_chunks/cache-api-LA3sBpUS.js.map +1 -0
- package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
- package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
- package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
- package/dist/_chunks/chains-e_Buf9vg.js +267 -0
- package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
- package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
- package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
- package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
- package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
- package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
- package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
- package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
- package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
- package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
- package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
- package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
- package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
- package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
- package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
- package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
- package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
- package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
- package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
- package/dist/_chunks/dev-server-DkytOEG2.js +1 -0
- package/dist/_chunks/dev-server-DnODXuNM.js +2056 -0
- package/dist/_chunks/dev-server-DnODXuNM.js.map +1 -0
- package/dist/_chunks/dist-DtrJyBbw.js +386 -0
- package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
- package/dist/_chunks/error-boundary-xxxLtXt6.js +1057 -0
- package/dist/_chunks/error-boundary-xxxLtXt6.js.map +1 -0
- package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
- package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
- package/dist/_chunks/flight-source-node-0dE-t3kq.js +519 -0
- package/dist/_chunks/flight-source-node-0dE-t3kq.js.map +1 -0
- package/dist/_chunks/format-BKclgVbk.js +14 -0
- package/dist/_chunks/format-BKclgVbk.js.map +1 -0
- package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
- package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
- package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
- package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
- package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
- package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
- package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
- package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
- package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
- package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
- package/dist/_chunks/logger-CbLdcy-W.js +662 -0
- package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
- package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
- package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
- package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
- package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
- package/dist/_chunks/node-response-Dibufw_b.js +187 -0
- package/dist/_chunks/node-response-Dibufw_b.js.map +1 -0
- package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
- package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
- package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
- package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
- package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
- package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
- package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
- package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
- package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
- package/dist/_chunks/purge-store-Byr8XOjU.js +14 -0
- package/dist/_chunks/purge-store-Byr8XOjU.js.map +1 -0
- package/dist/_chunks/render-timeout-DOf_BBcO.js +46 -0
- package/dist/_chunks/render-timeout-DOf_BBcO.js.map +1 -0
- package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
- package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
- package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
- package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
- package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
- package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
- package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
- package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
- package/dist/_chunks/scan-BoP17W3w.js +140 -0
- package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
- package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
- package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
- package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
- package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
- package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
- package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
- package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
- package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
- package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
- package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
- package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
- package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
- package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
- package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
- package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
- package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
- package/dist/_chunks/state-BhNGPsdi.js +50 -0
- package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
- package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
- package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
- package/dist/_chunks/tree-match-6yihorhk.js +169 -0
- package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
- package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
- package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
- package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
- package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
- package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
- package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
- package/dist/adapters/build-output-helper.d.ts +72 -0
- package/dist/adapters/build-output-helper.d.ts.map +1 -0
- package/dist/adapters/canonicalize-module.d.ts +8 -0
- package/dist/adapters/canonicalize-module.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.d.ts +109 -0
- package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.js +74 -0
- package/dist/adapters/cloudflare-dev.js.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.js +123 -0
- package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
- package/dist/adapters/cloudflare.d.ts +224 -24
- package/dist/adapters/cloudflare.d.ts.map +1 -1
- package/dist/adapters/cloudflare.js +1 -188
- package/dist/adapters/compress-module.d.ts +25 -4
- package/dist/adapters/compress-module.d.ts.map +1 -1
- package/dist/adapters/fs-identity.d.ts +63 -0
- package/dist/adapters/fs-identity.d.ts.map +1 -0
- package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
- package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
- package/dist/adapters/nitro-presets.d.ts +31 -0
- package/dist/adapters/nitro-presets.d.ts.map +1 -0
- package/dist/adapters/nitro-preview.d.ts +65 -0
- package/dist/adapters/nitro-preview.d.ts.map +1 -0
- package/dist/adapters/nitro.d.ts +69 -38
- package/dist/adapters/nitro.d.ts.map +1 -1
- package/dist/adapters/nitro.js +793 -341
- package/dist/adapters/nitro.js.map +1 -1
- package/dist/adapters/shared.d.ts +67 -0
- package/dist/adapters/shared.d.ts.map +1 -0
- package/dist/adapters/types.d.ts +124 -16
- package/dist/adapters/types.d.ts.map +1 -1
- package/dist/adapters/types.js +0 -0
- package/dist/analyze/chains.d.ts +124 -0
- package/dist/analyze/chains.d.ts.map +1 -0
- package/dist/analyze/classify.d.ts +153 -0
- package/dist/analyze/classify.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.d.ts +17 -0
- package/dist/analyze/crawl-entry.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.js +314 -0
- package/dist/analyze/crawl-entry.js.map +1 -0
- package/dist/analyze/crawl.d.ts +134 -0
- package/dist/analyze/crawl.d.ts.map +1 -0
- package/dist/analyze/graph-cache.d.ts +104 -0
- package/dist/analyze/graph-cache.d.ts.map +1 -0
- package/dist/analyze/graph-command.d.ts +43 -0
- package/dist/analyze/graph-command.d.ts.map +1 -0
- package/dist/analyze/graph-command.js +472 -0
- package/dist/analyze/graph-command.js.map +1 -0
- package/dist/analyze/live-graph.d.ts +81 -0
- package/dist/analyze/live-graph.d.ts.map +1 -0
- package/dist/analyze/poison-rules.d.ts +72 -0
- package/dist/analyze/poison-rules.d.ts.map +1 -0
- package/dist/analyze/poison-scan.d.ts +48 -0
- package/dist/analyze/poison-scan.d.ts.map +1 -0
- package/dist/analyze/scan.d.ts +73 -0
- package/dist/analyze/scan.d.ts.map +1 -0
- package/dist/cache/cache-api.d.ts +48 -0
- package/dist/cache/cache-api.d.ts.map +1 -0
- package/dist/cache/fast-hash.d.ts +5 -0
- package/dist/cache/fast-hash.d.ts.map +1 -1
- package/dist/cache/handler-store.d.ts +33 -0
- package/dist/cache/handler-store.d.ts.map +1 -0
- package/dist/cache/index.d.ts +32 -9
- package/dist/cache/index.d.ts.map +1 -1
- package/dist/cache/index.js +3 -326
- package/dist/cache/invalidation-epoch.d.ts +43 -0
- package/dist/cache/invalidation-epoch.d.ts.map +1 -0
- package/dist/cache/json-lossy-check.d.ts +11 -0
- package/dist/cache/json-lossy-check.d.ts.map +1 -0
- package/dist/cache/redis-handler.d.ts +141 -9
- package/dist/cache/redis-handler.d.ts.map +1 -1
- package/dist/cache/singleflight.d.ts +21 -2
- package/dist/cache/singleflight.d.ts.map +1 -1
- package/dist/cache/sizeof.d.ts +22 -0
- package/dist/cache/sizeof.d.ts.map +1 -0
- package/dist/cache/stable-stringify.d.ts +9 -0
- package/dist/cache/stable-stringify.d.ts.map +1 -1
- package/dist/cache/store.d.ts +53 -0
- package/dist/cache/store.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
- package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.js +29 -0
- package/dist/cache/stores/cloudflare-kv.js.map +1 -0
- package/dist/cache/stores/memory.d.ts +42 -0
- package/dist/cache/stores/memory.d.ts.map +1 -0
- package/dist/cache/stores/memory.js +90 -0
- package/dist/cache/stores/memory.js.map +1 -0
- package/dist/cache/stores/redis.d.ts +69 -0
- package/dist/cache/stores/redis.d.ts.map +1 -0
- package/dist/cache/stores/redis.js +35 -0
- package/dist/cache/stores/redis.js.map +1 -0
- package/dist/cache/stores/vercel.d.ts +36 -0
- package/dist/cache/stores/vercel.d.ts.map +1 -0
- package/dist/cache/stores/vercel.js +33 -0
- package/dist/cache/stores/vercel.js.map +1 -0
- package/dist/cache/tag-aware-handler.d.ts +52 -0
- package/dist/cache/tag-aware-handler.d.ts.map +1 -0
- package/dist/cache/timber-cache.d.ts +21 -11
- package/dist/cache/timber-cache.d.ts.map +1 -1
- package/dist/cdn/cloudflare-purge.d.ts +23 -0
- package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
- package/dist/cdn/cloudflare-purge.js +30 -0
- package/dist/cdn/cloudflare-purge.js.map +1 -0
- package/dist/cdn/fastly-purge.d.ts +25 -0
- package/dist/cdn/fastly-purge.d.ts.map +1 -0
- package/dist/cdn/fastly-purge.js +33 -0
- package/dist/cdn/fastly-purge.js.map +1 -0
- package/dist/cdn/headers.d.ts +97 -0
- package/dist/cdn/headers.d.ts.map +1 -0
- package/dist/cdn/index.d.ts +5 -0
- package/dist/cdn/index.d.ts.map +1 -0
- package/dist/cdn/index.js +94 -0
- package/dist/cdn/index.js.map +1 -0
- package/dist/cdn/purge-store.d.ts +23 -0
- package/dist/cdn/purge-store.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.d.ts +20 -0
- package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.js +35 -0
- package/dist/cdn/workers-cache-purge.js.map +1 -0
- package/dist/cli-check.d.ts +133 -0
- package/dist/cli-check.d.ts.map +1 -0
- package/dist/cli-context.d.ts +54 -0
- package/dist/cli-context.d.ts.map +1 -0
- package/dist/cli-schema-sync.d.ts +59 -0
- package/dist/cli-schema-sync.d.ts.map +1 -0
- package/dist/cli.d.ts +88 -16
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +225 -63
- package/dist/cli.js.map +1 -1
- package/dist/client/browser-dev.d.ts +42 -2
- package/dist/client/browser-dev.d.ts.map +1 -1
- package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
- package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
- package/dist/client/browser-entry/action-queue.d.ts +64 -0
- package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
- package/dist/client/browser-entry/form-state.d.ts +22 -0
- package/dist/client/browser-entry/form-state.d.ts.map +1 -0
- package/dist/client/browser-entry/hmr.d.ts +21 -0
- package/dist/client/browser-entry/hmr.d.ts.map +1 -0
- package/dist/client/browser-entry/hydrate.d.ts +61 -0
- package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
- package/dist/client/browser-entry/index.d.ts +32 -0
- package/dist/client/browser-entry/index.d.ts.map +1 -0
- package/dist/client/browser-entry/post-hydration.d.ts +26 -0
- package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
- package/dist/client/browser-entry/router-init.d.ts +41 -0
- package/dist/client/browser-entry/router-init.d.ts.map +1 -0
- package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
- package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
- package/dist/client/browser-entry/scroll.d.ts +28 -0
- package/dist/client/browser-entry/scroll.d.ts.map +1 -0
- package/dist/client/deny-last-resort.d.ts +29 -0
- package/dist/client/deny-last-resort.d.ts.map +1 -0
- package/dist/client/error-boundary.d.ts +58 -9
- package/dist/client/error-boundary.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -126
- package/dist/client/error-reconstituter.d.ts +55 -0
- package/dist/client/error-reconstituter.d.ts.map +1 -0
- package/dist/client/form.d.ts +38 -99
- package/dist/client/form.d.ts.map +1 -1
- package/dist/client/global-context.d.ts +15 -0
- package/dist/client/global-context.d.ts.map +1 -0
- package/dist/client/history.d.ts +50 -9
- package/dist/client/history.d.ts.map +1 -1
- package/dist/client/index.d.ts +21 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +432 -1227
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.d.ts +20 -0
- package/dist/client/internal.d.ts.map +1 -0
- package/dist/client/internal.js +808 -0
- package/dist/client/internal.js.map +1 -0
- package/dist/client/link.d.ts +85 -60
- package/dist/client/link.d.ts.map +1 -1
- package/dist/client/location-search.d.ts +12 -0
- package/dist/client/location-search.d.ts.map +1 -0
- package/dist/client/navigation-api.d.ts +95 -0
- package/dist/client/navigation-api.d.ts.map +1 -0
- package/dist/client/navigation-commit.d.ts +111 -0
- package/dist/client/navigation-commit.d.ts.map +1 -0
- package/dist/client/navigation-context.d.ts +54 -36
- package/dist/client/navigation-context.d.ts.map +1 -1
- package/dist/client/navigation-root.d.ts +106 -0
- package/dist/client/navigation-root.d.ts.map +1 -0
- package/dist/client/navigation-transition.d.ts +201 -0
- package/dist/client/navigation-transition.d.ts.map +1 -0
- package/dist/client/nuqs-adapter.d.ts +1 -1
- package/dist/client/nuqs-adapter.d.ts.map +1 -1
- package/dist/client/params-context.d.ts +81 -0
- package/dist/client/params-context.d.ts.map +1 -0
- package/dist/client/react-root.d.ts +51 -0
- package/dist/client/react-root.d.ts.map +1 -0
- package/dist/client/router-effects.d.ts +199 -0
- package/dist/client/router-effects.d.ts.map +1 -0
- package/dist/client/router-lifecycle.d.ts +104 -0
- package/dist/client/router-lifecycle.d.ts.map +1 -0
- package/dist/client/router-pipeline.d.ts +85 -0
- package/dist/client/router-pipeline.d.ts.map +1 -0
- package/dist/client/router-ref.d.ts +2 -2
- package/dist/client/router-ref.d.ts.map +1 -1
- package/dist/client/router-skew.d.ts +21 -0
- package/dist/client/router-skew.d.ts.map +1 -0
- package/dist/client/router-types.d.ts +314 -0
- package/dist/client/router-types.d.ts.map +1 -0
- package/dist/client/router-url.d.ts +24 -0
- package/dist/client/router-url.d.ts.map +1 -0
- package/dist/client/router.d.ts +1 -97
- package/dist/client/router.d.ts.map +1 -1
- package/dist/client/rsc-fetch.d.ts +110 -28
- package/dist/client/rsc-fetch.d.ts.map +1 -1
- package/dist/client/segment-cache.d.ts +186 -25
- package/dist/client/segment-cache.d.ts.map +1 -1
- package/dist/client/segment-context.d.ts.map +1 -1
- package/dist/client/segment-outlet.d.ts +68 -0
- package/dist/client/segment-outlet.d.ts.map +1 -0
- package/dist/client/segment-update-context.d.ts +15 -0
- package/dist/client/segment-update-context.d.ts.map +1 -0
- package/dist/client/shallow-url.d.ts +10 -0
- package/dist/client/shallow-url.d.ts.map +1 -0
- package/dist/client/slot-content-cache-context.d.ts +35 -0
- package/dist/client/slot-content-cache-context.d.ts.map +1 -0
- package/dist/client/slot-context.d.ts +31 -0
- package/dist/client/slot-context.d.ts.map +1 -0
- package/dist/client/slot-outlet.d.ts +16 -0
- package/dist/client/slot-outlet.d.ts.map +1 -0
- package/dist/client/slot-provider.d.ts +25 -0
- package/dist/client/slot-provider.d.ts.map +1 -0
- package/dist/client/ssr-data.d.ts +26 -50
- package/dist/client/ssr-data.d.ts.map +1 -1
- package/dist/client/stale-client.d.ts +69 -0
- package/dist/client/stale-client.d.ts.map +1 -0
- package/dist/client/state.d.ts +21 -13
- package/dist/client/state.d.ts.map +1 -1
- package/dist/client/status-page-marker.d.ts +25 -0
- package/dist/client/status-page-marker.d.ts.map +1 -0
- package/dist/client/top-loader.d.ts +7 -6
- package/dist/client/top-loader.d.ts.map +1 -1
- package/dist/client/unload-guard.d.ts +5 -0
- package/dist/client/unload-guard.d.ts.map +1 -1
- package/dist/client/use-cookie.d.ts +12 -0
- package/dist/client/use-cookie.d.ts.map +1 -1
- package/dist/client/use-field-state.d.ts +42 -0
- package/dist/client/use-field-state.d.ts.map +1 -0
- package/dist/client/use-link-status.d.ts +5 -5
- package/dist/client/use-link-status.d.ts.map +1 -1
- package/dist/client/use-pathname.d.ts +13 -11
- package/dist/client/use-pathname.d.ts.map +1 -1
- package/dist/client/use-pending-navigation.d.ts +23 -0
- package/dist/client/use-pending-navigation.d.ts.map +1 -0
- package/dist/client/use-query-states.d.ts +10 -4
- package/dist/client/use-query-states.d.ts.map +1 -1
- package/dist/client/use-router.d.ts +15 -8
- package/dist/client/use-router.d.ts.map +1 -1
- package/dist/client/use-search-params.d.ts +15 -8
- package/dist/client/use-search-params.d.ts.map +1 -1
- package/dist/client/use-segment-params.d.ts +55 -0
- package/dist/client/use-segment-params.d.ts.map +1 -0
- package/dist/codec.d.ts +69 -0
- package/dist/codec.d.ts.map +1 -0
- package/dist/codec.js +76 -0
- package/dist/codec.js.map +1 -0
- package/dist/config-types.d.ts +321 -0
- package/dist/config-types.d.ts.map +1 -0
- package/dist/config-validation.d.ts +68 -0
- package/dist/config-validation.d.ts.map +1 -0
- package/dist/cookies/define-cookie.d.ts +58 -25
- package/dist/cookies/define-cookie.d.ts.map +1 -1
- package/dist/cookies/index.d.ts +3 -2
- package/dist/cookies/index.d.ts.map +1 -1
- package/dist/cookies/index.js +256 -36
- package/dist/cookies/index.js.map +1 -1
- package/dist/cookies/json-cookie.d.ts +64 -0
- package/dist/cookies/json-cookie.d.ts.map +1 -0
- package/dist/cookies/validation.d.ts +34 -0
- package/dist/cookies/validation.d.ts.map +1 -0
- package/dist/dev-tools/404-page.d.ts +50 -0
- package/dist/dev-tools/404-page.d.ts.map +1 -0
- package/dist/dev-tools/browser-logs.d.ts +40 -0
- package/dist/dev-tools/browser-logs.d.ts.map +1 -0
- package/dist/dev-tools/dev-page-shell.d.ts +95 -0
- package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
- package/dist/dev-tools/error-page.d.ts +32 -0
- package/dist/dev-tools/error-page.d.ts.map +1 -0
- package/dist/dev-tools/holding-server.d.ts +46 -0
- package/dist/dev-tools/holding-server.d.ts.map +1 -0
- package/dist/dev-tools/hydration-overlay.d.ts +11 -0
- package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
- package/dist/dev-tools/index.d.ts +31 -0
- package/dist/dev-tools/index.d.ts.map +1 -0
- package/dist/dev-tools/instrumentation.d.ts +74 -0
- package/dist/dev-tools/instrumentation.d.ts.map +1 -0
- package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
- package/dist/dev-tools/logger.d.ts.map +1 -0
- package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +17 -3
- package/dist/dev-tools/logs.d.ts.map +1 -0
- package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
- package/dist/dev-tools/overlay.d.ts.map +1 -0
- package/dist/dev-tools/stack-classifier.d.ts +34 -0
- package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
- package/dist/dev-tools/terminal.d.ts +28 -0
- package/dist/dev-tools/terminal.d.ts.map +1 -0
- package/dist/fonts/ast-walk.d.ts +68 -0
- package/dist/fonts/ast-walk.d.ts.map +1 -0
- package/dist/fonts/ast.d.ts +112 -8
- package/dist/fonts/ast.d.ts.map +1 -1
- package/dist/fonts/bundle.d.ts +50 -0
- package/dist/fonts/bundle.d.ts.map +1 -0
- package/dist/fonts/css.d.ts +1 -1
- package/dist/fonts/dev-middleware.d.ts +22 -0
- package/dist/fonts/dev-middleware.d.ts.map +1 -0
- package/dist/fonts/fallbacks.d.ts +0 -7
- package/dist/fonts/fallbacks.d.ts.map +1 -1
- package/dist/fonts/google.d.ts +5 -3
- package/dist/fonts/google.d.ts.map +1 -1
- package/dist/fonts/local.d.ts +5 -5
- package/dist/fonts/local.d.ts.map +1 -1
- package/dist/fonts/paths.d.ts +43 -0
- package/dist/fonts/paths.d.ts.map +1 -0
- package/dist/fonts/pipeline.d.ts +177 -0
- package/dist/fonts/pipeline.d.ts.map +1 -0
- package/dist/fonts/transform.d.ts +82 -0
- package/dist/fonts/transform.d.ts.map +1 -0
- package/dist/fonts/types.d.ts +47 -1
- package/dist/fonts/types.d.ts.map +1 -1
- package/dist/fonts/virtual-modules.d.ts +77 -0
- package/dist/fonts/virtual-modules.d.ts.map +1 -0
- package/dist/index.d.ts +35 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8877 -14232
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +26 -0
- package/dist/params/codec-registry.d.ts.map +1 -0
- package/dist/params/define-schema.d.ts +81 -0
- package/dist/params/define-schema.d.ts.map +1 -0
- package/dist/params/index.d.ts +5 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +34 -0
- package/dist/params/index.js.map +1 -0
- package/dist/params/resolve-schema.d.ts +34 -0
- package/dist/params/resolve-schema.d.ts.map +1 -0
- package/dist/plugin-context.d.ts +262 -0
- package/dist/plugin-context.d.ts.map +1 -0
- package/dist/plugins/build-manifest.d.ts +7 -3
- package/dist/plugins/build-manifest.d.ts.map +1 -1
- package/dist/plugins/build-report.d.ts +61 -11
- package/dist/plugins/build-report.d.ts.map +1 -1
- package/dist/plugins/cache.d.ts +64 -0
- package/dist/plugins/cache.d.ts.map +1 -0
- package/dist/plugins/callsite-ast.d.ts +117 -0
- package/dist/plugins/callsite-ast.d.ts.map +1 -0
- package/dist/plugins/callsite-jsx.d.ts +35 -0
- package/dist/plugins/callsite-jsx.d.ts.map +1 -0
- package/dist/plugins/chunks.d.ts +11 -4
- package/dist/plugins/chunks.d.ts.map +1 -1
- package/dist/plugins/client-chunks.d.ts +40 -0
- package/dist/plugins/client-chunks.d.ts.map +1 -0
- package/dist/plugins/client-dep-entries.d.ts +80 -0
- package/dist/plugins/client-dep-entries.d.ts.map +1 -0
- package/dist/plugins/cloudflare-wasm.d.ts +21 -0
- package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
- package/dist/plugins/content.d.ts +1 -1
- package/dist/plugins/content.d.ts.map +1 -1
- package/dist/plugins/dev-discovery.d.ts +123 -0
- package/dist/plugins/dev-discovery.d.ts.map +1 -0
- package/dist/plugins/dev-server.d.ts +24 -1
- package/dist/plugins/dev-server.d.ts.map +1 -1
- package/dist/plugins/encryption-runtime.d.ts +13 -0
- package/dist/plugins/encryption-runtime.d.ts.map +1 -0
- package/dist/plugins/entries.d.ts +35 -4
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/plugins/fonts.d.ts +35 -74
- package/dist/plugins/fonts.d.ts.map +1 -1
- package/dist/plugins/graph-endpoint.d.ts +112 -0
- package/dist/plugins/graph-endpoint.d.ts.map +1 -0
- package/dist/plugins/mdx.d.ts +18 -5
- package/dist/plugins/mdx.d.ts.map +1 -1
- package/dist/plugins/post-build.d.ts +110 -0
- package/dist/plugins/post-build.d.ts.map +1 -0
- package/dist/plugins/prebuilt-capture.d.ts +67 -0
- package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
- package/dist/plugins/prebuilt.d.ts +98 -0
- package/dist/plugins/prebuilt.d.ts.map +1 -0
- package/dist/plugins/prerender-sugar.d.ts +39 -0
- package/dist/plugins/prerender-sugar.d.ts.map +1 -0
- package/dist/plugins/react-resolve.d.ts +49 -0
- package/dist/plugins/react-resolve.d.ts.map +1 -0
- package/dist/plugins/request-dep/analysis.d.ts +106 -0
- package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
- package/dist/plugins/request-dep/index.d.ts +75 -0
- package/dist/plugins/request-dep/index.d.ts.map +1 -0
- package/dist/plugins/request-dep/origin.d.ts +61 -0
- package/dist/plugins/request-dep/origin.d.ts.map +1 -0
- package/dist/plugins/routing.d.ts +1 -1
- package/dist/plugins/routing.d.ts.map +1 -1
- package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
- package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
- package/dist/plugins/server-bundle.d.ts +1 -1
- package/dist/plugins/server-bundle.d.ts.map +1 -1
- package/dist/plugins/shims.d.ts +29 -5
- package/dist/plugins/shims.d.ts.map +1 -1
- package/dist/plugins/static-build.d.ts +246 -26
- package/dist/plugins/static-build.d.ts.map +1 -1
- package/dist/routing/codegen-shared.d.ts +26 -0
- package/dist/routing/codegen-shared.d.ts.map +1 -0
- package/dist/routing/codegen-types.d.ts +61 -0
- package/dist/routing/codegen-types.d.ts.map +1 -0
- package/dist/routing/codegen-write.d.ts +42 -0
- package/dist/routing/codegen-write.d.ts.map +1 -0
- package/dist/routing/codegen.d.ts +8 -3
- package/dist/routing/codegen.d.ts.map +1 -1
- package/dist/routing/collision-probe.d.ts +104 -0
- package/dist/routing/collision-probe.d.ts.map +1 -0
- package/dist/routing/collision-spaces.d.ts +26 -0
- package/dist/routing/collision-spaces.d.ts.map +1 -0
- package/dist/routing/convention-lint.d.ts +55 -0
- package/dist/routing/convention-lint.d.ts.map +1 -0
- package/dist/routing/export-detect.d.ts +91 -0
- package/dist/routing/export-detect.d.ts.map +1 -0
- package/dist/routing/file-cache.d.ts +8 -0
- package/dist/routing/file-cache.d.ts.map +1 -0
- package/dist/routing/index.d.ts +13 -7
- package/dist/routing/index.d.ts.map +1 -1
- package/dist/routing/index.js +5 -2
- package/dist/routing/interception-overlap.d.ts +35 -0
- package/dist/routing/interception-overlap.d.ts.map +1 -0
- package/dist/routing/interception.d.ts +234 -10
- package/dist/routing/interception.d.ts.map +1 -1
- package/dist/routing/link-codegen.d.ts +105 -0
- package/dist/routing/link-codegen.d.ts.map +1 -0
- package/dist/routing/manifest-codegen.d.ts +26 -0
- package/dist/routing/manifest-codegen.d.ts.map +1 -0
- package/dist/routing/scanner.d.ts +14 -10
- package/dist/routing/scanner.d.ts.map +1 -1
- package/dist/routing/schema-validation.d.ts +35 -0
- package/dist/routing/schema-validation.d.ts.map +1 -0
- package/dist/routing/segment-classify.d.ts +114 -0
- package/dist/routing/segment-classify.d.ts.map +1 -0
- package/dist/routing/segment-codegen.d.ts +38 -0
- package/dist/routing/segment-codegen.d.ts.map +1 -0
- package/dist/routing/segment-keys.d.ts +118 -0
- package/dist/routing/segment-keys.d.ts.map +1 -0
- package/dist/routing/slot-placement.d.ts +48 -0
- package/dist/routing/slot-placement.d.ts.map +1 -0
- package/dist/routing/types.d.ts +81 -26
- package/dist/routing/types.d.ts.map +1 -1
- package/dist/routing/walkers.d.ts +57 -0
- package/dist/routing/walkers.d.ts.map +1 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
- package/dist/rsc-runtime/render-flight.d.ts +14 -0
- package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
- package/dist/rsc-runtime/rsc.d.ts +6 -2
- package/dist/rsc-runtime/rsc.d.ts.map +1 -1
- package/dist/rsc-runtime/ssr.d.ts +8 -0
- package/dist/rsc-runtime/ssr.d.ts.map +1 -1
- package/dist/rsc-runtime/transforms.d.ts +13 -0
- package/dist/rsc-runtime/transforms.d.ts.map +1 -0
- package/dist/schema-bridge.d.ts +145 -0
- package/dist/schema-bridge.d.ts.map +1 -0
- package/dist/search-params/define.d.ts +262 -0
- package/dist/search-params/define.d.ts.map +1 -0
- package/dist/search-params/index.d.ts +3 -7
- package/dist/search-params/index.d.ts.map +1 -1
- package/dist/search-params/index.js +179 -360
- package/dist/search-params/index.js.map +1 -1
- package/dist/search-params/parse-total.d.ts +81 -0
- package/dist/search-params/parse-total.d.ts.map +1 -0
- package/dist/search-params/serialize-equal.d.ts +9 -0
- package/dist/search-params/serialize-equal.d.ts.map +1 -0
- package/dist/search-params/wrappers.d.ts +76 -0
- package/dist/search-params/wrappers.d.ts.map +1 -0
- package/dist/server/access-gate.d.ts +98 -10
- package/dist/server/access-gate.d.ts.map +1 -1
- package/dist/server/action-client.d.ts +20 -133
- package/dist/server/action-client.d.ts.map +1 -1
- package/dist/server/action-encryption.d.ts +76 -0
- package/dist/server/action-encryption.d.ts.map +1 -0
- package/dist/server/action-handler.d.ts +58 -11
- package/dist/server/action-handler.d.ts.map +1 -1
- package/dist/server/action-schema.d.ts +126 -0
- package/dist/server/action-schema.d.ts.map +1 -0
- package/dist/server/action-types.d.ts +108 -0
- package/dist/server/action-types.d.ts.map +1 -0
- package/dist/server/actions.d.ts +78 -40
- package/dist/server/actions.d.ts.map +1 -1
- package/dist/server/als-registry.d.ts +189 -17
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/body-limits.d.ts.map +1 -1
- package/dist/server/build-manifest.d.ts +25 -30
- package/dist/server/build-manifest.d.ts.map +1 -1
- package/dist/server/canonicalize.d.ts +32 -0
- package/dist/server/canonicalize.d.ts.map +1 -1
- package/dist/server/chain-url-parts.d.ts +82 -0
- package/dist/server/chain-url-parts.d.ts.map +1 -0
- package/dist/server/children-interception.d.ts +49 -0
- package/dist/server/children-interception.d.ts.map +1 -0
- package/dist/server/client-error-message.d.ts +12 -0
- package/dist/server/client-error-message.d.ts.map +1 -0
- package/dist/server/coalesce-tick.d.ts +40 -0
- package/dist/server/coalesce-tick.d.ts.map +1 -0
- package/dist/server/compress.d.ts +2 -0
- package/dist/server/compress.d.ts.map +1 -1
- package/dist/server/cookie-context.d.ts +149 -0
- package/dist/server/cookie-context.d.ts.map +1 -0
- package/dist/server/cookie-parsing.d.ts +65 -0
- package/dist/server/cookie-parsing.d.ts.map +1 -0
- package/dist/server/csp-nonce.d.ts +36 -0
- package/dist/server/csp-nonce.d.ts.map +1 -0
- package/dist/server/csrf.d.ts +58 -15
- package/dist/server/csrf.d.ts.map +1 -1
- package/dist/server/debug.d.ts +0 -1
- package/dist/server/debug.d.ts.map +1 -1
- package/dist/server/default-logger.d.ts +23 -0
- package/dist/server/default-logger.d.ts.map +1 -0
- package/dist/server/default-status-page.d.ts +45 -0
- package/dist/server/default-status-page.d.ts.map +1 -0
- package/dist/server/deny-boundary.d.ts +257 -0
- package/dist/server/deny-boundary.d.ts.map +1 -0
- package/dist/server/deny-renderer.d.ts +22 -15
- package/dist/server/deny-renderer.d.ts.map +1 -1
- package/dist/server/early-hints-sender.d.ts.map +1 -1
- package/dist/server/early-hints.d.ts +14 -12
- package/dist/server/early-hints.d.ts.map +1 -1
- package/dist/server/error-boundary-wrapper.d.ts +102 -10
- package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
- package/dist/server/error-response-headers.d.ts +3 -0
- package/dist/server/error-response-headers.d.ts.map +1 -0
- package/dist/server/fallback-error.d.ts +19 -7
- package/dist/server/fallback-error.d.ts.map +1 -1
- package/dist/server/flight-injection-state.d.ts +66 -0
- package/dist/server/flight-injection-state.d.ts.map +1 -0
- package/dist/server/flight-injector-core.d.ts +125 -0
- package/dist/server/flight-injector-core.d.ts.map +1 -0
- package/dist/server/flight-scripts.d.ts +63 -0
- package/dist/server/flight-scripts.d.ts.map +1 -0
- package/dist/server/flight-source-node.d.ts +105 -0
- package/dist/server/flight-source-node.d.ts.map +1 -0
- package/dist/server/flight-source.d.ts +136 -0
- package/dist/server/flight-source.d.ts.map +1 -0
- package/dist/server/form-data.d.ts +59 -2
- package/dist/server/form-data.d.ts.map +1 -1
- package/dist/server/form-state-flight.d.ts +32 -0
- package/dist/server/form-state-flight.d.ts.map +1 -0
- package/dist/server/head-response.d.ts +35 -0
- package/dist/server/head-response.d.ts.map +1 -0
- package/dist/server/html-injector-core.d.ts +169 -0
- package/dist/server/html-injector-core.d.ts.map +1 -0
- package/dist/server/html-injectors.d.ts +77 -47
- package/dist/server/html-injectors.d.ts.map +1 -1
- package/dist/server/index.d.ts +16 -54
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +638 -3021
- package/dist/server/index.js.map +1 -1
- package/dist/server/instrumentation.d.ts +11 -4
- package/dist/server/instrumentation.d.ts.map +1 -1
- package/dist/server/internal.d.ts +47 -0
- package/dist/server/internal.d.ts.map +1 -0
- package/dist/server/internal.js +4649 -0
- package/dist/server/internal.js.map +1 -0
- package/dist/server/json-status-response.d.ts +34 -0
- package/dist/server/json-status-response.d.ts.map +1 -0
- package/dist/server/logger.d.ts +79 -7
- package/dist/server/logger.d.ts.map +1 -1
- package/dist/server/metadata-collector.d.ts +75 -0
- package/dist/server/metadata-collector.d.ts.map +1 -0
- package/dist/server/metadata-platform.d.ts +2 -2
- package/dist/server/metadata-render.d.ts +2 -2
- package/dist/server/metadata-render.d.ts.map +1 -1
- package/dist/server/metadata-route-links.d.ts +70 -0
- package/dist/server/metadata-route-links.d.ts.map +1 -0
- package/dist/server/metadata-routes.d.ts +47 -11
- package/dist/server/metadata-routes.d.ts.map +1 -1
- package/dist/server/metadata-social.d.ts +2 -2
- package/dist/server/metadata.d.ts +10 -2
- package/dist/server/metadata.d.ts.map +1 -1
- package/dist/server/middleware-runner.d.ts +20 -5
- package/dist/server/middleware-runner.d.ts.map +1 -1
- package/dist/server/node-body-response.d.ts +55 -0
- package/dist/server/node-body-response.d.ts.map +1 -0
- package/dist/server/node-response.d.ts +62 -0
- package/dist/server/node-response.d.ts.map +1 -0
- package/dist/server/node-stream-transforms.d.ts +108 -0
- package/dist/server/node-stream-transforms.d.ts.map +1 -0
- package/dist/server/node-streams-platform.d.ts +21 -0
- package/dist/server/node-streams-platform.d.ts.map +1 -0
- package/dist/server/nuqs-ssr-provider.d.ts +7 -3
- package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
- package/dist/server/param-coercion.d.ts +83 -0
- package/dist/server/param-coercion.d.ts.map +1 -0
- package/dist/server/pipeline-helpers.d.ts +224 -0
- package/dist/server/pipeline-helpers.d.ts.map +1 -0
- package/dist/server/pipeline-interception.d.ts +70 -9
- package/dist/server/pipeline-interception.d.ts.map +1 -1
- package/dist/server/pipeline-metadata.d.ts +16 -1
- package/dist/server/pipeline-metadata.d.ts.map +1 -1
- package/dist/server/pipeline-outcome.d.ts +59 -0
- package/dist/server/pipeline-outcome.d.ts.map +1 -0
- package/dist/server/pipeline-phases.d.ts +70 -0
- package/dist/server/pipeline-phases.d.ts.map +1 -0
- package/dist/server/pipeline.d.ts +161 -23
- package/dist/server/pipeline.d.ts.map +1 -1
- package/dist/server/port-resolution.d.ts +22 -0
- package/dist/server/port-resolution.d.ts.map +1 -0
- package/dist/server/prebuilt/cache-key.d.ts +63 -0
- package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-render.d.ts +25 -0
- package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-routes.d.ts +37 -0
- package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-state.d.ts +101 -0
- package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
- package/dist/server/prebuilt/key-discipline.d.ts +52 -0
- package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
- package/dist/server/prebuilt/lifetime.d.ts +38 -0
- package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
- package/dist/server/prebuilt/overlay.d.ts +100 -0
- package/dist/server/prebuilt/overlay.d.ts.map +1 -0
- package/dist/server/prebuilt/payload-source.d.ts +79 -0
- package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
- package/dist/server/prebuilt/slots.d.ts +106 -0
- package/dist/server/prebuilt/slots.d.ts.map +1 -0
- package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
- package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
- package/dist/server/prebuilt-builder.d.ts +121 -0
- package/dist/server/prebuilt-builder.d.ts.map +1 -0
- package/dist/server/prebuilt-runtime.d.ts +110 -0
- package/dist/server/prebuilt-runtime.d.ts.map +1 -0
- package/dist/server/primitives.d.ts +101 -90
- package/dist/server/primitives.d.ts.map +1 -1
- package/dist/server/publish-params.d.ts +33 -0
- package/dist/server/publish-params.d.ts.map +1 -0
- package/dist/server/react-cache-bridge.d.ts +59 -0
- package/dist/server/react-cache-bridge.d.ts.map +1 -0
- package/dist/server/react-cache-scope.d.ts +49 -0
- package/dist/server/react-cache-scope.d.ts.map +1 -0
- package/dist/server/render-timeout.d.ts +66 -0
- package/dist/server/render-timeout.d.ts.map +1 -0
- package/dist/server/render-utils.d.ts +35 -0
- package/dist/server/render-utils.d.ts.map +1 -0
- package/dist/server/request-context.d.ts +153 -103
- package/dist/server/request-context.d.ts.map +1 -1
- package/dist/server/request-dep.d.ts +15 -0
- package/dist/server/request-dep.d.ts.map +1 -0
- package/dist/server/response-cache-policy.d.ts +3 -0
- package/dist/server/response-cache-policy.d.ts.map +1 -0
- package/dist/server/route-element-builder.d.ts +57 -30
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/route-element-helpers.d.ts +12 -0
- package/dist/server/route-element-helpers.d.ts.map +1 -0
- package/dist/server/route-handler.d.ts +1 -1
- package/dist/server/route-handler.d.ts.map +1 -1
- package/dist/server/route-matcher.d.ts +62 -38
- package/dist/server/route-matcher.d.ts.map +1 -1
- package/dist/server/route-module-loader.d.ts +37 -0
- package/dist/server/route-module-loader.d.ts.map +1 -0
- package/dist/server/rsc-cache-key-guard.d.ts +78 -0
- package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
- package/dist/server/rsc-entry/api-handler.d.ts +19 -3
- package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
- package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
- package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
- package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
- package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
- package/dist/server/rsc-entry/helpers.d.ts +14 -59
- package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
- package/dist/server/rsc-entry/index.d.ts +30 -6
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts +55 -0
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
- package/dist/server/rsc-entry/render-signals.d.ts +65 -0
- package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
- package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
- package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
- package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
- package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
- package/dist/server/rsc-error-envelope.d.ts +11 -0
- package/dist/server/rsc-error-envelope.d.ts.map +1 -0
- package/dist/server/safe-load.d.ts +39 -0
- package/dist/server/safe-load.d.ts.map +1 -0
- package/dist/server/schema-introspection.d.ts +68 -0
- package/dist/server/schema-introspection.d.ts.map +1 -0
- package/dist/server/sensitive-fields.d.ts +88 -0
- package/dist/server/sensitive-fields.d.ts.map +1 -0
- package/dist/server/signal-identity.d.ts +43 -0
- package/dist/server/signal-identity.d.ts.map +1 -0
- package/dist/server/sitemap-generator.d.ts +130 -0
- package/dist/server/sitemap-generator.d.ts.map +1 -0
- package/dist/server/sitemap-handler.d.ts +22 -0
- package/dist/server/sitemap-handler.d.ts.map +1 -0
- package/dist/server/skippable-prefix.d.ts +29 -0
- package/dist/server/skippable-prefix.d.ts.map +1 -0
- package/dist/server/slot-interception.d.ts +80 -0
- package/dist/server/slot-interception.d.ts.map +1 -0
- package/dist/server/slot-resolver.d.ts +138 -7
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/slot-subtree-contain.d.ts +54 -0
- package/dist/server/slot-subtree-contain.d.ts.map +1 -0
- package/dist/server/ssr-bridge-types.d.ts +213 -0
- package/dist/server/ssr-bridge-types.d.ts.map +1 -0
- package/dist/server/ssr-entry.d.ts +15 -51
- package/dist/server/ssr-entry.d.ts.map +1 -1
- package/dist/server/ssr-form-state.d.ts +30 -0
- package/dist/server/ssr-form-state.d.ts.map +1 -0
- package/dist/server/ssr-render.d.ts +59 -32
- package/dist/server/ssr-render.d.ts.map +1 -1
- package/dist/server/ssr-wrappers.d.ts +93 -0
- package/dist/server/ssr-wrappers.d.ts.map +1 -0
- package/dist/server/state-tree-diff.d.ts +44 -9
- package/dist/server/state-tree-diff.d.ts.map +1 -1
- package/dist/server/static-generator.d.ts +112 -0
- package/dist/server/static-generator.d.ts.map +1 -0
- package/dist/server/static-not-found.d.ts +52 -0
- package/dist/server/static-not-found.d.ts.map +1 -0
- package/dist/server/status-code-resolver.d.ts +26 -15
- package/dist/server/status-code-resolver.d.ts.map +1 -1
- package/dist/server/stream-utils.d.ts +93 -0
- package/dist/server/stream-utils.d.ts.map +1 -0
- package/dist/server/tracing.d.ts +57 -26
- package/dist/server/tracing.d.ts.map +1 -1
- package/dist/server/tree-match.d.ts +59 -0
- package/dist/server/tree-match.d.ts.map +1 -0
- package/dist/server/types.d.ts +89 -8
- package/dist/server/types.d.ts.map +1 -1
- package/dist/server/utils/element-type.d.ts +50 -0
- package/dist/server/utils/element-type.d.ts.map +1 -0
- package/dist/server/utils/escape-html.d.ts +14 -0
- package/dist/server/utils/escape-html.d.ts.map +1 -0
- package/dist/server/version-skew.d.ts +61 -0
- package/dist/server/version-skew.d.ts.map +1 -0
- package/dist/server/workers-cache-bridge.d.ts +26 -0
- package/dist/server/workers-cache-bridge.d.ts.map +1 -0
- package/dist/shared/als-slots.d.ts +42 -0
- package/dist/shared/als-slots.d.ts.map +1 -0
- package/dist/shared/base-path.d.ts +56 -0
- package/dist/shared/base-path.d.ts.map +1 -0
- package/dist/shared/csrf-reject.d.ts +16 -0
- package/dist/shared/csrf-reject.d.ts.map +1 -0
- package/dist/shared/error-digest.d.ts +28 -0
- package/dist/shared/error-digest.d.ts.map +1 -0
- package/dist/shared/flight-base64.d.ts +13 -0
- package/dist/shared/flight-base64.d.ts.map +1 -0
- package/dist/shared/flight-segment.d.ts +18 -0
- package/dist/shared/flight-segment.d.ts.map +1 -0
- package/dist/shared/form-state-flight.d.ts +32 -0
- package/dist/shared/form-state-flight.d.ts.map +1 -0
- package/dist/shared/href-validation.d.ts +49 -0
- package/dist/shared/href-validation.d.ts.map +1 -0
- package/dist/shared/merge-search-params.d.ts +22 -0
- package/dist/shared/merge-search-params.d.ts.map +1 -0
- package/dist/shared/param-value.d.ts +104 -0
- package/dist/shared/param-value.d.ts.map +1 -0
- package/dist/shared/payload-root.d.ts +110 -0
- package/dist/shared/payload-root.d.ts.map +1 -0
- package/dist/shared/redirect-type.d.ts +17 -0
- package/dist/shared/redirect-type.d.ts.map +1 -0
- package/dist/shared/rsc-cache-key.d.ts +163 -0
- package/dist/shared/rsc-cache-key.d.ts.map +1 -0
- package/dist/shared/rsc-error-envelope.d.ts +16 -0
- package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
- package/dist/shared/rsc-manifest.d.ts +28 -0
- package/dist/shared/rsc-manifest.d.ts.map +1 -0
- package/dist/shared/rsc-media-type.d.ts +52 -0
- package/dist/shared/rsc-media-type.d.ts.map +1 -0
- package/dist/shared/rsc-payload-path.d.ts +48 -0
- package/dist/shared/rsc-payload-path.d.ts.map +1 -0
- package/dist/shared/segment-info.d.ts +66 -0
- package/dist/shared/segment-info.d.ts.map +1 -0
- package/dist/shared/slot-params.d.ts +52 -0
- package/dist/shared/slot-params.d.ts.map +1 -0
- package/dist/shared/static-platform-files.d.ts +71 -0
- package/dist/shared/static-platform-files.d.ts.map +1 -0
- package/dist/shared/status-reason-phrase.d.ts +26 -0
- package/dist/shared/status-reason-phrase.d.ts.map +1 -0
- package/dist/shims/font-google.d.ts +1 -1
- package/dist/shims/font-google.d.ts.map +1 -1
- package/dist/shims/font-google.js +42 -0
- package/dist/shims/font-google.js.map +1 -0
- package/dist/shims/font-local.d.ts +26 -0
- package/dist/shims/font-local.d.ts.map +1 -0
- package/dist/shims/font-local.js +20 -0
- package/dist/shims/font-local.js.map +1 -0
- package/dist/shims/headers.d.ts +53 -1
- package/dist/shims/headers.d.ts.map +1 -1
- package/dist/shims/image.d.ts +120 -120
- package/dist/shims/image.d.ts.map +1 -1
- package/dist/shims/navigation-client.d.ts +25 -12
- package/dist/shims/navigation-client.d.ts.map +1 -1
- package/dist/shims/navigation-rsc.d.ts +21 -0
- package/dist/shims/navigation-rsc.d.ts.map +1 -0
- package/dist/shims/navigation.d.ts +10 -5
- package/dist/shims/navigation.d.ts.map +1 -1
- package/dist/utils/state-machine.d.ts +80 -0
- package/dist/utils/state-machine.d.ts.map +1 -0
- package/dist/utils/write-file-atomic.d.ts +17 -0
- package/dist/utils/write-file-atomic.d.ts.map +1 -0
- package/docs/api/30-api-server.mdx +239 -0
- package/docs/api/31-api-client.mdx +199 -0
- package/docs/api/32-api-cache.mdx +339 -0
- package/docs/api/33-api-search-params.mdx +176 -0
- package/docs/api/34-api-config.mdx +359 -0
- package/docs/api/35-api-typescript.mdx +91 -0
- package/docs/api/36-cli.mdx +206 -0
- package/docs/learn/00-introduction.mdx +109 -0
- package/docs/learn/01-quick-start.mdx +94 -0
- package/docs/learn/02-pages-and-layouts.mdx +147 -0
- package/docs/learn/03-fetching-data.mdx +227 -0
- package/docs/learn/04-access-control.mdx +115 -0
- package/docs/learn/05-the-flush-point.mdx +175 -0
- package/docs/learn/06-typed-params.mdx +275 -0
- package/docs/learn/07-typed-routes.mdx +108 -0
- package/docs/learn/08-forms-and-actions.mdx +260 -0
- package/docs/learn/09-streaming.mdx +140 -0
- package/docs/learn/10-caching.mdx +270 -0
- package/docs/learn/11-middleware.mdx +164 -0
- package/docs/learn/12-error-handling.mdx +192 -0
- package/docs/learn/13-deploying.mdx +289 -0
- package/llms.txt +55 -0
- package/package.json +120 -29
- package/src/adapters/build-output-helper.ts +353 -0
- package/src/adapters/canonicalize-module.ts +29 -0
- package/src/adapters/cloudflare-dev.ts +183 -0
- package/src/adapters/cloudflare-kv-cache.ts +207 -0
- package/src/adapters/cloudflare.ts +809 -150
- package/src/adapters/compress-module.ts +110 -86
- package/src/adapters/fs-identity.ts +155 -0
- package/src/adapters/nitro-immutable-assets.ts +142 -0
- package/src/adapters/nitro-presets.ts +124 -0
- package/src/adapters/nitro-preview.ts +533 -0
- package/src/adapters/nitro.ts +331 -445
- package/src/adapters/raw-imports.d.ts +5 -0
- package/src/adapters/shared.ts +283 -0
- package/src/adapters/types.ts +129 -17
- package/src/adapters/wrangler.d.ts +7 -0
- package/src/analyze/chains.ts +411 -0
- package/src/analyze/classify.ts +259 -0
- package/src/analyze/crawl-entry.ts +68 -0
- package/src/analyze/crawl.ts +500 -0
- package/src/analyze/graph-cache.ts +331 -0
- package/src/analyze/graph-command.ts +762 -0
- package/src/analyze/live-graph.ts +232 -0
- package/src/analyze/poison-rules.ts +165 -0
- package/src/analyze/poison-scan.ts +159 -0
- package/src/analyze/scan.ts +149 -0
- package/src/cache/cache-api.ts +107 -0
- package/src/cache/fast-hash.ts +5 -0
- package/src/cache/handler-store.ts +76 -0
- package/src/cache/index.ts +115 -22
- package/src/cache/invalidation-epoch.ts +93 -0
- package/src/cache/json-lossy-check.ts +69 -0
- package/src/cache/redis-handler.ts +198 -20
- package/src/cache/singleflight.ts +72 -6
- package/src/cache/sizeof.ts +35 -0
- package/src/cache/stable-stringify.ts +65 -2
- package/src/cache/store.ts +71 -0
- package/src/cache/stores/cloudflare-kv.ts +52 -0
- package/src/cache/stores/memory.ts +125 -0
- package/src/cache/stores/redis.ts +97 -0
- package/src/cache/stores/vercel.ts +59 -0
- package/src/cache/tag-aware-handler.ts +254 -0
- package/src/cache/timber-cache.ts +165 -40
- package/src/cdn/cloudflare-purge.ts +50 -0
- package/src/cdn/fastly-purge.ts +63 -0
- package/src/cdn/headers.ts +153 -0
- package/src/cdn/index.ts +23 -0
- package/src/cdn/purge-store.ts +34 -0
- package/src/cdn/workers-cache-purge.ts +34 -0
- package/src/cli-check.ts +417 -0
- package/src/cli-context.ts +119 -0
- package/src/cli-schema-sync.ts +401 -0
- package/src/cli.ts +334 -80
- package/src/client/browser-dev.ts +192 -5
- package/src/client/browser-entry/action-dispatch.ts +317 -0
- package/src/client/browser-entry/action-queue.ts +152 -0
- package/src/client/browser-entry/form-state.ts +49 -0
- package/src/client/browser-entry/hmr.ts +70 -0
- package/src/client/browser-entry/hydrate.ts +152 -0
- package/src/client/browser-entry/index.ts +150 -0
- package/src/client/browser-entry/post-hydration.ts +99 -0
- package/src/client/browser-entry/router-init.ts +393 -0
- package/src/client/browser-entry/rsc-stream.ts +145 -0
- package/src/client/browser-entry/scroll.ts +50 -0
- package/src/client/deny-last-resort.tsx +54 -0
- package/src/client/error-boundary.tsx +279 -61
- package/src/client/error-reconstituter.tsx +84 -0
- package/src/client/form.tsx +61 -173
- package/src/client/global-context.ts +31 -0
- package/src/client/history.ts +74 -11
- package/src/client/index.ts +90 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +468 -151
- package/src/client/location-search.ts +15 -0
- package/src/client/navigation-api.ts +254 -0
- package/src/client/navigation-commit.ts +318 -0
- package/src/client/navigation-context.ts +67 -134
- package/src/client/navigation-root.tsx +236 -0
- package/src/client/navigation-transition.ts +348 -0
- package/src/client/nuqs-adapter.tsx +21 -9
- package/src/client/params-context.ts +187 -0
- package/src/client/react-root.ts +105 -0
- package/src/client/router-effects.ts +324 -0
- package/src/client/router-lifecycle.ts +374 -0
- package/src/client/router-pipeline.ts +456 -0
- package/src/client/router-ref.ts +3 -3
- package/src/client/router-skew.ts +30 -0
- package/src/client/router-types.ts +346 -0
- package/src/client/router-url.ts +32 -0
- package/src/client/router.ts +500 -424
- package/src/client/rsc-fetch.ts +510 -109
- package/src/client/segment-cache.ts +362 -41
- package/src/client/segment-context.ts +7 -4
- package/src/client/segment-outlet.tsx +96 -0
- package/src/client/segment-update-context.ts +23 -0
- package/src/client/shallow-url.ts +22 -0
- package/src/client/slot-content-cache-context.ts +43 -0
- package/src/client/slot-context.ts +50 -0
- package/src/client/slot-outlet.tsx +22 -0
- package/src/client/slot-provider.tsx +32 -0
- package/src/client/ssr-data.ts +27 -67
- package/src/client/stale-client.ts +191 -0
- package/src/client/state.ts +31 -24
- package/src/client/status-page-marker.tsx +32 -0
- package/src/client/top-loader.tsx +13 -10
- package/src/client/unload-guard.ts +35 -3
- package/src/client/use-cookie.ts +70 -18
- package/src/client/use-field-state.ts +144 -0
- package/src/client/use-link-status.ts +7 -7
- package/src/client/use-pathname.ts +22 -31
- package/src/client/use-pending-navigation.ts +40 -0
- package/src/client/use-query-states.ts +206 -36
- package/src/client/use-router.ts +31 -9
- package/src/client/use-search-params.ts +38 -49
- package/src/client/use-segment-params.ts +69 -0
- package/src/client/use-selected-layout-segment.ts +2 -2
- package/src/codec.ts +149 -0
- package/src/config-types.ts +321 -0
- package/src/config-validation.ts +464 -0
- package/src/cookies/define-cookie.ts +222 -53
- package/src/cookies/index.ts +13 -2
- package/src/cookies/json-cookie.ts +105 -0
- package/src/cookies/validation.ts +192 -0
- package/src/dev-tools/404-page.ts +286 -0
- package/src/dev-tools/browser-logs.ts +55 -0
- package/src/dev-tools/dev-page-shell.ts +278 -0
- package/src/dev-tools/error-page.ts +331 -0
- package/src/dev-tools/holding-server.ts +185 -0
- package/src/dev-tools/hydration-overlay.ts +158 -0
- package/src/dev-tools/index.ts +79 -0
- package/src/dev-tools/instrumentation.ts +261 -0
- package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
- package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
- package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
- package/src/dev-tools/stack-classifier.ts +75 -0
- package/src/dev-tools/terminal.ts +182 -0
- package/src/fonts/ast-walk.ts +235 -0
- package/src/fonts/ast.ts +479 -128
- package/src/fonts/bundle.ts +138 -0
- package/src/fonts/css.ts +1 -1
- package/src/fonts/dev-middleware.ts +85 -0
- package/src/fonts/fallbacks.ts +0 -23
- package/src/fonts/google.ts +101 -19
- package/src/fonts/local.ts +12 -11
- package/src/fonts/paths.ts +58 -0
- package/src/fonts/pipeline.ts +348 -0
- package/src/fonts/transform.ts +311 -0
- package/src/fonts/types.ts +52 -1
- package/src/fonts/virtual-modules.ts +179 -0
- package/src/index.ts +492 -380
- package/src/params/codec-registry.ts +34 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +17 -0
- package/src/params/resolve-schema.ts +84 -0
- package/src/plugin-context.ts +502 -0
- package/src/plugins/build-manifest.ts +189 -36
- package/src/plugins/build-report.ts +299 -87
- package/src/plugins/cache.ts +243 -0
- package/src/plugins/callsite-ast.ts +472 -0
- package/src/plugins/callsite-jsx.ts +243 -0
- package/src/plugins/chunks.ts +74 -5
- package/src/plugins/client-chunks.ts +185 -0
- package/src/plugins/client-dep-entries.ts +124 -0
- package/src/plugins/cloudflare-wasm.ts +141 -0
- package/src/plugins/content.ts +31 -2
- package/src/plugins/dev-discovery.ts +218 -0
- package/src/plugins/dev-server.ts +360 -97
- package/src/plugins/encryption-runtime.ts +31 -0
- package/src/plugins/entries.ts +150 -17
- package/src/plugins/fonts.ts +260 -657
- package/src/plugins/graph-endpoint.ts +532 -0
- package/src/plugins/mdx.ts +108 -35
- package/src/plugins/post-build.ts +327 -0
- package/src/plugins/prebuilt-capture.ts +213 -0
- package/src/plugins/prebuilt-options-analysis.ts +175 -0
- package/src/plugins/prebuilt.ts +670 -0
- package/src/plugins/prerender-sugar.ts +316 -0
- package/src/plugins/react-resolve.ts +149 -0
- package/src/plugins/request-dep/analysis.ts +447 -0
- package/src/plugins/request-dep/index.ts +376 -0
- package/src/plugins/request-dep/origin.ts +310 -0
- package/src/plugins/routing.ts +273 -277
- package/src/plugins/rsc-assets-manifest.ts +251 -0
- package/src/plugins/server-bundle.ts +115 -15
- package/src/plugins/shims.ts +257 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -0
- package/src/routing/codegen-shared.ts +39 -0
- package/src/routing/codegen-types.ts +62 -0
- package/src/routing/codegen-write.ts +163 -0
- package/src/routing/codegen.ts +349 -232
- package/src/routing/collision-probe.ts +438 -0
- package/src/routing/collision-spaces.ts +281 -0
- package/src/routing/convention-lint.ts +651 -0
- package/src/routing/export-detect.ts +536 -0
- package/src/routing/file-cache.ts +23 -0
- package/src/routing/index.ts +16 -7
- package/src/routing/interception-overlap.ts +141 -0
- package/src/routing/interception.ts +1044 -67
- package/src/routing/link-codegen.ts +280 -0
- package/src/routing/manifest-codegen.ts +232 -0
- package/src/routing/scanner.ts +417 -223
- package/src/routing/schema-validation.ts +155 -0
- package/src/routing/segment-classify.ts +280 -0
- package/src/routing/segment-codegen.ts +99 -0
- package/src/routing/segment-keys.ts +186 -0
- package/src/routing/slot-placement.ts +97 -0
- package/src/routing/types.ts +82 -26
- package/src/routing/walkers.ts +98 -0
- package/src/rsc-runtime/encryption-runtime.ts +78 -0
- package/src/rsc-runtime/render-flight.ts +26 -0
- package/src/rsc-runtime/rsc.ts +17 -2
- package/src/rsc-runtime/ssr.ts +13 -0
- package/src/rsc-runtime/transforms.ts +13 -0
- package/src/rsc-runtime/vendor-types.d.ts +70 -0
- package/src/schema-bridge.ts +382 -0
- package/src/search-params/define.ts +677 -0
- package/src/search-params/index.ts +14 -20
- package/src/search-params/parse-total.ts +91 -0
- package/src/search-params/serialize-equal.ts +14 -0
- package/src/search-params/wrappers.ts +150 -0
- package/src/server/access-gate.tsx +195 -56
- package/src/server/action-client.ts +175 -294
- package/src/server/action-encryption.ts +144 -0
- package/src/server/action-handler.ts +492 -150
- package/src/server/action-schema.ts +203 -0
- package/src/server/action-types.ts +145 -0
- package/src/server/actions.ts +172 -85
- package/src/server/als-registry.ts +245 -30
- package/src/server/body-limits.ts +10 -2
- package/src/server/build-manifest.ts +33 -57
- package/src/server/canonicalize.ts +35 -3
- package/src/server/chain-url-parts.ts +163 -0
- package/src/server/children-interception.ts +116 -0
- package/src/server/client-error-message.ts +18 -0
- package/src/server/coalesce-tick.ts +75 -0
- package/src/server/compress.ts +91 -19
- package/src/server/cookie-context.ts +454 -0
- package/src/server/cookie-parsing.ts +163 -0
- package/src/server/csp-nonce.ts +58 -0
- package/src/server/csrf.ts +228 -35
- package/src/server/debug.ts +0 -1
- package/src/server/default-logger.ts +100 -0
- package/src/server/default-status-page.ts +88 -0
- package/src/server/deny-boundary.ts +527 -0
- package/src/server/deny-renderer.ts +210 -181
- package/src/server/early-hints-sender.ts +4 -3
- package/src/server/early-hints.ts +39 -29
- package/src/server/error-boundary-wrapper.ts +160 -44
- package/src/server/error-response-headers.ts +18 -0
- package/src/server/fallback-error.ts +88 -104
- package/src/server/flight-injection-state.ts +113 -0
- package/src/server/flight-injector-core.ts +328 -0
- package/src/server/flight-scripts.ts +92 -0
- package/src/server/flight-source-node.ts +430 -0
- package/src/server/flight-source.ts +288 -0
- package/src/server/form-data.ts +191 -20
- package/src/server/form-state-flight.ts +67 -0
- package/src/server/head-response.ts +50 -0
- package/src/server/html-injector-core.ts +320 -0
- package/src/server/html-injectors.ts +241 -285
- package/src/server/index.ts +37 -195
- package/src/server/instrumentation.ts +11 -4
- package/src/server/internal.ts +168 -0
- package/src/server/json-status-response.ts +105 -0
- package/src/server/logger.ts +131 -38
- package/src/server/metadata-collector.ts +175 -0
- package/src/server/metadata-platform.ts +2 -2
- package/src/server/metadata-render.ts +30 -8
- package/src/server/metadata-route-links.ts +200 -0
- package/src/server/metadata-routes.ts +114 -24
- package/src/server/metadata-social.ts +2 -2
- package/src/server/metadata.ts +23 -2
- package/src/server/middleware-runner.ts +32 -5
- package/src/server/node-body-response.ts +236 -0
- package/src/server/node-response.ts +93 -0
- package/src/server/node-stream-transforms.ts +340 -0
- package/src/server/node-streams-platform.ts +23 -0
- package/src/server/nuqs-ssr-provider.tsx +8 -7
- package/src/server/param-coercion.ts +201 -0
- package/src/server/pipeline-helpers.ts +548 -0
- package/src/server/pipeline-interception.ts +241 -32
- package/src/server/pipeline-metadata.ts +25 -1
- package/src/server/pipeline-outcome.ts +290 -0
- package/src/server/pipeline-phases.ts +503 -0
- package/src/server/pipeline.ts +423 -426
- package/src/server/port-resolution.ts +43 -0
- package/src/server/prebuilt/cache-key.ts +299 -0
- package/src/server/prebuilt/capture-render.ts +118 -0
- package/src/server/prebuilt/capture-routes.ts +104 -0
- package/src/server/prebuilt/capture-state.ts +196 -0
- package/src/server/prebuilt/key-discipline.ts +122 -0
- package/src/server/prebuilt/lifetime.ts +151 -0
- package/src/server/prebuilt/manifest-tag-index.ts +46 -0
- package/src/server/prebuilt/overlay.ts +256 -0
- package/src/server/prebuilt/payload-source.ts +202 -0
- package/src/server/prebuilt/slots.ts +202 -0
- package/src/server/prebuilt/synthetic-store.ts +125 -0
- package/src/server/prebuilt-builder.ts +514 -0
- package/src/server/prebuilt-runtime.ts +810 -0
- package/src/server/primitives.ts +153 -171
- package/src/server/publish-params.ts +42 -0
- package/src/server/react-cache-bridge.ts +124 -0
- package/src/server/react-cache-scope.ts +104 -0
- package/src/server/render-timeout.ts +128 -0
- package/src/server/render-utils.ts +45 -0
- package/src/server/request-context.ts +298 -324
- package/src/server/request-dep.ts +37 -0
- package/src/server/response-cache-policy.ts +45 -0
- package/src/server/route-element-builder.ts +526 -355
- package/src/server/route-element-helpers.ts +37 -0
- package/src/server/route-handler.ts +67 -27
- package/src/server/route-matcher.ts +238 -267
- package/src/server/route-module-loader.ts +161 -0
- package/src/server/rsc-cache-key-guard.ts +122 -0
- package/src/server/rsc-entry/action-dispatcher.ts +144 -0
- package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
- package/src/server/rsc-entry/api-handler.ts +49 -81
- package/src/server/rsc-entry/deny-fallback.ts +151 -0
- package/src/server/rsc-entry/error-renderer.ts +306 -113
- package/src/server/rsc-entry/helpers.ts +90 -115
- package/src/server/rsc-entry/index.ts +372 -350
- package/src/server/rsc-entry/render-route.ts +248 -0
- package/src/server/rsc-entry/render-signals.ts +108 -0
- package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
- package/src/server/rsc-entry/rsc-payload.ts +212 -113
- package/src/server/rsc-entry/rsc-stream.ts +137 -135
- package/src/server/rsc-entry/ssr-bridge.ts +43 -8
- package/src/server/rsc-entry/ssr-renderer.ts +311 -140
- package/src/server/rsc-error-envelope.ts +18 -0
- package/src/server/rsc-prop-warnings.ts +1 -1
- package/src/server/safe-load.ts +53 -0
- package/src/server/schema-introspection.ts +393 -0
- package/src/server/sensitive-fields.ts +287 -0
- package/src/server/server-only-guard-noop.js +3 -0
- package/src/server/server-timing.ts +1 -1
- package/src/server/signal-identity.ts +112 -0
- package/src/server/sitemap-generator.ts +337 -0
- package/src/server/sitemap-handler.ts +150 -0
- package/src/server/skippable-prefix.ts +172 -0
- package/src/server/slot-interception.ts +168 -0
- package/src/server/slot-resolver.ts +707 -300
- package/src/server/slot-subtree-contain.ts +273 -0
- package/src/server/ssr-bridge-types.ts +217 -0
- package/src/server/ssr-entry.ts +248 -109
- package/src/server/ssr-form-state.ts +58 -0
- package/src/server/ssr-render.ts +334 -101
- package/src/server/ssr-wrappers.tsx +162 -0
- package/src/server/state-tree-diff.ts +85 -30
- package/src/server/static-generator.ts +680 -0
- package/src/server/static-not-found.ts +134 -0
- package/src/server/status-code-resolver.ts +107 -148
- package/src/server/stream-utils.ts +398 -0
- package/src/server/tracing.ts +163 -68
- package/src/server/tree-match.ts +494 -0
- package/src/server/types.ts +96 -11
- package/src/server/utils/element-type.ts +88 -0
- package/src/server/utils/escape-html.ts +20 -0
- package/src/server/version-skew.ts +104 -0
- package/src/server/waituntil-bridge.ts +1 -1
- package/src/server/workers-cache-bridge.ts +33 -0
- package/src/shared/als-slots.ts +74 -0
- package/src/shared/base-path.ts +80 -0
- package/src/shared/csrf-reject.ts +15 -0
- package/src/shared/error-digest.ts +46 -0
- package/src/shared/flight-base64.ts +23 -0
- package/src/shared/flight-segment.ts +35 -0
- package/src/shared/form-state-flight.ts +59 -0
- package/src/shared/href-validation.ts +159 -0
- package/src/shared/merge-search-params.ts +55 -0
- package/src/shared/param-value.ts +281 -0
- package/src/shared/payload-root.ts +153 -0
- package/src/shared/redirect-type.ts +17 -0
- package/src/shared/rsc-cache-key.ts +269 -0
- package/src/shared/rsc-error-envelope.ts +16 -0
- package/src/shared/rsc-manifest.ts +29 -0
- package/src/shared/rsc-media-type.ts +59 -0
- package/src/shared/rsc-payload-path.ts +52 -0
- package/src/shared/segment-info.ts +67 -0
- package/src/shared/slot-params.ts +109 -0
- package/src/shared/static-platform-files.ts +75 -0
- package/src/shared/status-reason-phrase.ts +61 -0
- package/src/shims/font-google.ts +1 -1
- package/src/shims/font-local.ts +34 -0
- package/src/shims/headers.ts +122 -1
- package/src/shims/navigation-client.ts +36 -32
- package/src/shims/navigation-rsc.ts +47 -0
- package/src/shims/navigation.ts +10 -7
- package/src/utils/state-machine.ts +111 -0
- package/src/utils/write-file-atomic.ts +32 -0
- package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
- package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
- package/dist/_chunks/debug-B3Gypr3D.js +0 -108
- package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
- package/dist/_chunks/format-RyoGQL74.js +0 -164
- package/dist/_chunks/format-RyoGQL74.js.map +0 -1
- package/dist/_chunks/interception-BOoWmLUA.js +0 -676
- package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
- package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
- package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
- package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
- package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
- package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
- package/dist/_chunks/tracing-CemImE6h.js +0 -187
- package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
- package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
- package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
- package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
- package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
- package/dist/adapters/cloudflare.js.map +0 -1
- package/dist/cache/index.js.map +0 -1
- package/dist/cache/register-cached-function.d.ts +0 -17
- package/dist/cache/register-cached-function.d.ts.map +0 -1
- package/dist/client/browser-entry.d.ts +0 -21
- package/dist/client/browser-entry.d.ts.map +0 -1
- package/dist/client/error-boundary.js.map +0 -1
- package/dist/client/head.d.ts +0 -16
- package/dist/client/head.d.ts.map +0 -1
- package/dist/client/link-status-provider.d.ts +0 -11
- package/dist/client/link-status-provider.d.ts.map +0 -1
- package/dist/client/segment-merger.d.ts +0 -119
- package/dist/client/segment-merger.d.ts.map +0 -1
- package/dist/client/stale-reload.d.ts +0 -44
- package/dist/client/stale-reload.d.ts.map +0 -1
- package/dist/client/transition-root.d.ts +0 -74
- package/dist/client/transition-root.d.ts.map +0 -1
- package/dist/client/types.d.ts +0 -14
- package/dist/client/types.d.ts.map +0 -1
- package/dist/client/use-navigation-pending.d.ts +0 -26
- package/dist/client/use-navigation-pending.d.ts.map +0 -1
- package/dist/client/use-params.d.ts +0 -92
- package/dist/client/use-params.d.ts.map +0 -1
- package/dist/content/index.d.ts +0 -11
- package/dist/content/index.d.ts.map +0 -1
- package/dist/content/index.js +0 -2
- package/dist/plugins/adapter-build.d.ts +0 -18
- package/dist/plugins/adapter-build.d.ts.map +0 -1
- package/dist/plugins/cache-transform.d.ts +0 -36
- package/dist/plugins/cache-transform.d.ts.map +0 -1
- package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
- package/dist/plugins/dev-logs.d.ts.map +0 -1
- package/dist/plugins/dynamic-transform.d.ts +0 -72
- package/dist/plugins/dynamic-transform.d.ts.map +0 -1
- package/dist/plugins/server-action-exports.d.ts +0 -26
- package/dist/plugins/server-action-exports.d.ts.map +0 -1
- package/dist/routing/status-file-lint.d.ts +0 -33
- package/dist/routing/status-file-lint.d.ts.map +0 -1
- package/dist/search-params/analyze.d.ts +0 -54
- package/dist/search-params/analyze.d.ts.map +0 -1
- package/dist/search-params/builtin-codecs.d.ts +0 -105
- package/dist/search-params/builtin-codecs.d.ts.map +0 -1
- package/dist/search-params/codecs.d.ts +0 -53
- package/dist/search-params/codecs.d.ts.map +0 -1
- package/dist/search-params/create.d.ts +0 -106
- package/dist/search-params/create.d.ts.map +0 -1
- package/dist/search-params/registry.d.ts +0 -20
- package/dist/search-params/registry.d.ts.map +0 -1
- package/dist/server/asset-headers.d.ts +0 -42
- package/dist/server/asset-headers.d.ts.map +0 -1
- package/dist/server/client-module-map.d.ts +0 -47
- package/dist/server/client-module-map.d.ts.map +0 -1
- package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
- package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
- package/dist/server/dev-logger.d.ts.map +0 -1
- package/dist/server/dev-span-processor.d.ts +0 -29
- package/dist/server/dev-span-processor.d.ts.map +0 -1
- package/dist/server/dev-warnings.d.ts +0 -129
- package/dist/server/dev-warnings.d.ts.map +0 -1
- package/dist/server/flush.d.ts +0 -74
- package/dist/server/flush.d.ts.map +0 -1
- package/dist/server/form-flash.d.ts +0 -78
- package/dist/server/form-flash.d.ts.map +0 -1
- package/dist/server/manifest-status-resolver.d.ts +0 -58
- package/dist/server/manifest-status-resolver.d.ts.map +0 -1
- package/dist/server/prerender.d.ts +0 -77
- package/dist/server/prerender.d.ts.map +0 -1
- package/dist/server/tree-builder.d.ts +0 -126
- package/dist/server/tree-builder.d.ts.map +0 -1
- package/dist/utils/directive-parser.d.ts +0 -70
- package/dist/utils/directive-parser.d.ts.map +0 -1
- package/src/cache/register-cached-function.ts +0 -103
- package/src/client/browser-entry.ts +0 -678
- package/src/client/head.ts +0 -61
- package/src/client/link-status-provider.tsx +0 -30
- package/src/client/segment-merger.ts +0 -339
- package/src/client/stale-reload.ts +0 -87
- package/src/client/transition-root.tsx +0 -166
- package/src/client/types.ts +0 -21
- package/src/client/use-navigation-pending.ts +0 -38
- package/src/client/use-params.ts +0 -141
- package/src/content/index.ts +0 -13
- package/src/plugins/adapter-build.ts +0 -118
- package/src/plugins/cache-transform.ts +0 -199
- package/src/plugins/dynamic-transform.ts +0 -161
- package/src/plugins/server-action-exports.ts +0 -220
- package/src/routing/status-file-lint.ts +0 -112
- package/src/search-params/analyze.ts +0 -192
- package/src/search-params/builtin-codecs.ts +0 -228
- package/src/search-params/codecs.ts +0 -153
- package/src/search-params/create.ts +0 -321
- package/src/search-params/registry.ts +0 -31
- package/src/server/asset-headers.ts +0 -81
- package/src/server/client-module-map.ts +0 -58
- package/src/server/dev-fetch-instrumentation.ts +0 -96
- package/src/server/dev-span-processor.ts +0 -78
- package/src/server/dev-warnings.ts +0 -283
- package/src/server/flush.ts +0 -182
- package/src/server/form-flash.ts +0 -89
- package/src/server/manifest-status-resolver.ts +0 -215
- package/src/server/prerender.ts +0 -139
- package/src/server/tree-builder.ts +0 -382
- package/src/shims/server-only-noop.js +0 -6
- package/src/utils/directive-parser.ts +0 -529
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared state machine types and transitions for RSC Flight injection.
|
|
3
|
+
*
|
|
4
|
+
* Both html-injectors.ts (Web Streams) and node-stream-transforms.ts
|
|
5
|
+
* (Node.js streams) implement identical state transitions — only the
|
|
6
|
+
* I/O primitives differ. This module defines the discriminated union
|
|
7
|
+
* states and the transition map once.
|
|
8
|
+
*
|
|
9
|
+
* Valid state flow:
|
|
10
|
+
* init → streaming → flushing → done
|
|
11
|
+
* (any) → error
|
|
12
|
+
*
|
|
13
|
+
* Suffix stripping (</body></html>) is handled by a separate
|
|
14
|
+
* createMoveSuffixStream / createNodeMoveSuffixTransform upstream
|
|
15
|
+
* in the pipeline (TIM-530). The flight injector only interleaves
|
|
16
|
+
* RSC scripts between HTML chunks — no suffix tracking needed.
|
|
17
|
+
*
|
|
18
|
+
* Design doc: 02-rendering-pipeline.md
|
|
19
|
+
*/
|
|
20
|
+
import type { TransitionMap } from '../utils/state-machine.ts';
|
|
21
|
+
/** Waiting for first HTML chunk. Pull loop not started. */
|
|
22
|
+
export interface InitState {
|
|
23
|
+
phase: 'init';
|
|
24
|
+
}
|
|
25
|
+
/** HTML chunks flowing, pull loop running. */
|
|
26
|
+
export interface StreamingState {
|
|
27
|
+
phase: 'streaming';
|
|
28
|
+
}
|
|
29
|
+
/** HTML stream done (flush fired). Draining remaining RSC chunks. */
|
|
30
|
+
export interface FlushingState {
|
|
31
|
+
phase: 'flushing';
|
|
32
|
+
}
|
|
33
|
+
/** All streams consumed. Terminal state. */
|
|
34
|
+
export interface DoneState {
|
|
35
|
+
phase: 'done';
|
|
36
|
+
}
|
|
37
|
+
/** Pull loop failed. Terminal state with captured error. */
|
|
38
|
+
export interface ErrorState {
|
|
39
|
+
phase: 'error';
|
|
40
|
+
error: unknown;
|
|
41
|
+
}
|
|
42
|
+
export type FlightInjectionState = InitState | StreamingState | FlushingState | DoneState | ErrorState;
|
|
43
|
+
/** First HTML chunk arrived — start the pull loop. */
|
|
44
|
+
export interface FirstChunkEvent {
|
|
45
|
+
type: 'FIRST_CHUNK';
|
|
46
|
+
}
|
|
47
|
+
/** HTML stream finished (flush/end). */
|
|
48
|
+
export interface HtmlDoneEvent {
|
|
49
|
+
type: 'HTML_DONE';
|
|
50
|
+
}
|
|
51
|
+
/** RSC pull loop completed (all chunks read or stream closed). */
|
|
52
|
+
export interface PullDoneEvent {
|
|
53
|
+
type: 'PULL_DONE';
|
|
54
|
+
}
|
|
55
|
+
/** RSC pull loop encountered an error. */
|
|
56
|
+
export interface PullErrorEvent {
|
|
57
|
+
type: 'PULL_ERROR';
|
|
58
|
+
error: unknown;
|
|
59
|
+
}
|
|
60
|
+
export type FlightInjectionEvent = FirstChunkEvent | HtmlDoneEvent | PullDoneEvent | PullErrorEvent;
|
|
61
|
+
export declare const flightInjectionTransitions: TransitionMap<FlightInjectionState, FlightInjectionEvent>;
|
|
62
|
+
/** Whether the HTML stream has finished (flush/end fired). */
|
|
63
|
+
export declare function isHtmlDone(state: FlightInjectionState): boolean;
|
|
64
|
+
/** Whether the RSC pull loop has completed. */
|
|
65
|
+
export declare function isPullDone(state: FlightInjectionState): boolean;
|
|
66
|
+
//# sourceMappingURL=flight-injection-state.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flight-injection-state.d.ts","sourceRoot":"","sources":["../../src/server/flight-injection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,cAAc,GACd,aAAa,GACb,SAAS,GACT,UAAU,CAAC;AAIf,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;AAIpG,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,oBAAoB,EAAE,oBAAoB,CAgB9F,CAAC;AAIJ,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAE/D;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAE/D"}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flight injector core — the pull loop that turns the inline Flight source
|
|
3
|
+
* into `<script>` tags interleaved with the HTML stream.
|
|
4
|
+
*
|
|
5
|
+
* Shape-agnostic like the rest of `html-injector-core.ts`: the Web wrapper
|
|
6
|
+
* (`html-injectors.ts`) and the Node wrapper (`node-stream-transforms.ts`)
|
|
7
|
+
* compose this class, and it reads either kind of Flight source through
|
|
8
|
+
* `openFlightReader` (`flight-source.ts`), so the inline branch is a Node
|
|
9
|
+
* stream end to end on Node and a Web stream on Workers.
|
|
10
|
+
*
|
|
11
|
+
* Design docs: 02-rendering-pipeline.md §"Stream Tee",
|
|
12
|
+
* §"Scripts at Chunk Boundaries Only", §"Streaming Constraints"
|
|
13
|
+
*/
|
|
14
|
+
import { type Machine } from '../utils/state-machine.ts';
|
|
15
|
+
import { type FlightInjectionState, type FlightInjectionEvent } from './flight-injection-state.ts';
|
|
16
|
+
import { type FlightChunk, type FlightSource } from './flight-source.ts';
|
|
17
|
+
/**
|
|
18
|
+
* Turns Flight chunks into inline script tags, in order.
|
|
19
|
+
*
|
|
20
|
+
* - Adjacent text in one batch of chunks becomes one `[1, text]` script, so
|
|
21
|
+
* the many small chunks Node's Flight writer produces (a header chunk and a
|
|
22
|
+
* string per long row) cost one script, not one each.
|
|
23
|
+
* - A string chunk (Node only) is already text: it is JSON-escaped straight
|
|
24
|
+
* into the tuple, with no decode.
|
|
25
|
+
* - A run of byte chunks is decoded as a whole, holding back an incomplete
|
|
26
|
+
* trailing character for the next chunk. A run that is not valid UTF-8 —
|
|
27
|
+
* the binary row of a typed array or ArrayBuffer — is sent as a
|
|
28
|
+
* `[3, base64]` tuple instead of failing the response. The browser
|
|
29
|
+
* (`client/browser-entry/rsc-stream.ts`) enqueues both tuples' bytes in
|
|
30
|
+
* order, so it rebuilds the exact byte stream either way.
|
|
31
|
+
*/
|
|
32
|
+
export declare class FlightInlineEncoder {
|
|
33
|
+
private readonly nonce?;
|
|
34
|
+
private readonly decoder;
|
|
35
|
+
/** Bytes held back because they end in an incomplete UTF-8 sequence. */
|
|
36
|
+
private carry;
|
|
37
|
+
constructor(nonce?: string | undefined);
|
|
38
|
+
/** The scripts for a batch of chunks, in order. */
|
|
39
|
+
push(chunks: readonly FlightChunk[]): string[];
|
|
40
|
+
/** The scripts for bytes still held back at the end of the stream. */
|
|
41
|
+
end(): string[];
|
|
42
|
+
private takeCarry;
|
|
43
|
+
/** The bytes as text, or `null` if they are not valid UTF-8. */
|
|
44
|
+
private decode;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Both wrappers (Web `TransformStream` and Node `Transform`) implement the
|
|
48
|
+
* exact same protocol around the inline Flight source:
|
|
49
|
+
*
|
|
50
|
+
* 1. On the first HTML chunk, send `FIRST_CHUNK` and start the pull loop.
|
|
51
|
+
* 2. The pull loop reads the source (timeout-guarded), turns each chunk
|
|
52
|
+
* into `<script>` tags via {@link FlightInlineEncoder}, and pushes them
|
|
53
|
+
* onto a pending queue. Between reads, it yields with a single-shot
|
|
54
|
+
* `setImmediate` so HTML chunks get event-loop priority — and after
|
|
55
|
+
* yielding, it drains the queue (via the wrapper's `onYieldDrain`)
|
|
56
|
+
* so flight data reaches the client at shell-flush time.
|
|
57
|
+
* 3. After every emitted HTML chunk, the wrapper drains the queue.
|
|
58
|
+
* 4. On `flush()` the wrapper sends `HTML_DONE` and awaits `pullPromise`.
|
|
59
|
+
* No polling — just `.then()`.
|
|
60
|
+
*
|
|
61
|
+
* The wrappers only differ in:
|
|
62
|
+
* - How they push bytes (controller.enqueue vs transform.push).
|
|
63
|
+
* - How they signal a terminal error (controller.error vs transform.destroy).
|
|
64
|
+
*
|
|
65
|
+
* **No polling.** See design/02-rendering-pipeline.md §"No Polling".
|
|
66
|
+
* **Always timeout-guarded reads.** Per design/02 §"Streaming Constraints".
|
|
67
|
+
*/
|
|
68
|
+
export interface FlightInjectorOptions {
|
|
69
|
+
/**
|
|
70
|
+
* Timeout in milliseconds for individual Flight reads. If one read does
|
|
71
|
+
* not resolve within this duration, the read is aborted and the stream
|
|
72
|
+
* errors with a `RenderTimeoutError`. Default: 30000 (30s). `0`
|
|
73
|
+
* ("disabled") still enforces a 120s ceiling so a stalled RSC stream can
|
|
74
|
+
* never hang the connection forever.
|
|
75
|
+
*/
|
|
76
|
+
renderTimeoutMs?: number;
|
|
77
|
+
/** Signal that fires when an unhandled RSC error is detected. */
|
|
78
|
+
errorSignal?: AbortSignal;
|
|
79
|
+
/** Request CSP nonce, stamped on every emitted `<script>` (TIM-1414). */
|
|
80
|
+
nonce?: string;
|
|
81
|
+
}
|
|
82
|
+
export declare class FlightInjectorCore {
|
|
83
|
+
readonly machine: Machine<FlightInjectionState, FlightInjectionEvent>;
|
|
84
|
+
/** Script chunks waiting to be drained between HTML chunks. */
|
|
85
|
+
readonly pending: Uint8Array[];
|
|
86
|
+
private readonly reader;
|
|
87
|
+
private readonly timeoutMs;
|
|
88
|
+
private readonly errorSignal?;
|
|
89
|
+
private readonly encoder;
|
|
90
|
+
private pullPromise;
|
|
91
|
+
private _aborted;
|
|
92
|
+
constructor(source: FlightSource, options?: FlightInjectorOptions);
|
|
93
|
+
/** Tell the machine the first HTML chunk has arrived. Idempotent-ish: caller checks. */
|
|
94
|
+
notifyFirstChunk(): void;
|
|
95
|
+
/** Tell the machine HTML output is finished — pull loop will stop yielding. */
|
|
96
|
+
notifyHtmlDone(): void;
|
|
97
|
+
get isInit(): boolean;
|
|
98
|
+
get isPullDone(): boolean;
|
|
99
|
+
get hasPullPromise(): boolean;
|
|
100
|
+
/**
|
|
101
|
+
* Get (or start) the pull-loop promise. The wrapper calls this from
|
|
102
|
+
* `flush()` and chains `.then()` onto it — never `await` without an
|
|
103
|
+
* existing finish callback (we don't want to block transform()).
|
|
104
|
+
*
|
|
105
|
+
* `onYieldDrain` is invoked between Flight reads while HTML is still
|
|
106
|
+
* streaming. It must drain the pending queue into the output stream.
|
|
107
|
+
*/
|
|
108
|
+
ensurePullLoop(onYieldDrain: () => void): Promise<void>;
|
|
109
|
+
/**
|
|
110
|
+
* Get the current terminal error if the machine is in the error phase,
|
|
111
|
+
* else `null`. Wrappers use this after a drain to decide whether to
|
|
112
|
+
* `controller.error()` / `transform.destroy()`.
|
|
113
|
+
*/
|
|
114
|
+
get terminalError(): unknown;
|
|
115
|
+
/**
|
|
116
|
+
* Abort the pull loop and release the Flight source. Called by stream
|
|
117
|
+
* wrappers when the HTML pipeline is torn down (Node `destroy()`,
|
|
118
|
+
* Web `cancel()`). Safe to call multiple times.
|
|
119
|
+
*/
|
|
120
|
+
abort(reason?: unknown): void;
|
|
121
|
+
get isAborted(): boolean;
|
|
122
|
+
private enqueue;
|
|
123
|
+
private runPullLoop;
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=flight-injector-core.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flight-injector-core.d.ts","sourceRoot":"","sources":["../../src/server/flight-injector-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AA+B5B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;IAOlB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8D;IACtF,wEAAwE;IACxE,OAAO,CAAC,KAAK,CAA2B;IAExC,YAA6B,KAAK,CAAC,EAAE,MAAM,YAAA,EAAI;IAE/C,mDAAmD;IACnD,IAAI,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,EAAE,CA2B7C;IAED,sEAAsE;IACtE,GAAG,IAAI,MAAM,EAAE,CASd;IAED,OAAO,CAAC,SAAS;IAMjB,gEAAgE;IAChE,OAAO,CAAC,MAAM;CAOf;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IACtE,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAM;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,qBAA0B,EASpE;IAED,wFAAwF;IACxF,gBAAgB,IAAI,IAAI,CAEvB;IAED,+EAA+E;IAC/E,cAAc,IAAI,IAAI,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtD;IAED;;;;OAIG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAQ5B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,CAAC,OAAO;YAID,WAAW;CAuD1B"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared Flight data script generation.
|
|
3
|
+
*
|
|
4
|
+
* Both html-injectors.ts (Web Streams / dev) and node-stream-transforms.ts
|
|
5
|
+
* (Node streams / production) use this module to generate inline `<script>`
|
|
6
|
+
* tags for RSC Flight data injection.
|
|
7
|
+
*
|
|
8
|
+
* The init script goes in `<head>` as part of the HTML shell (guaranteed
|
|
9
|
+
* to execute before any streaming chunk scripts). Push scripts are emitted
|
|
10
|
+
* as RSC chunks arrive during streaming.
|
|
11
|
+
*
|
|
12
|
+
* Every generator takes the request's CSP nonce (from `getCspNonce()`)
|
|
13
|
+
* so the tags run under a nonce-based `script-src` (TIM-1414).
|
|
14
|
+
*
|
|
15
|
+
* See design/02-rendering-pipeline.md, LOCAL-415
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* Escape a JSON string for safe embedding inside an HTML `<script>` tag.
|
|
19
|
+
*
|
|
20
|
+
* Prevents XSS via `</script>` injection and handles Unicode line/paragraph
|
|
21
|
+
* separators that are valid JSON but invalid in JS string literals (pre-ES2019).
|
|
22
|
+
*/
|
|
23
|
+
export declare function htmlEscapeJsonString(str: string): string;
|
|
24
|
+
/**
|
|
25
|
+
* Generate the init script that creates the Flight data array.
|
|
26
|
+
*
|
|
27
|
+
* This MUST be included in `<head>` (via headHtml) so it executes before
|
|
28
|
+
* any streaming chunk scripts arrive in `<body>`. The array is created
|
|
29
|
+
* unconditionally — no `||[]` guard needed in push scripts.
|
|
30
|
+
*
|
|
31
|
+
* Also emits the bootstrap signal [0] which tells the client that
|
|
32
|
+
* Flight data is active for this page.
|
|
33
|
+
*/
|
|
34
|
+
export declare function flightInitScript(nonce?: string): string;
|
|
35
|
+
/**
|
|
36
|
+
* Generate a push script for a Flight data chunk.
|
|
37
|
+
*
|
|
38
|
+
* Normally the init script runs first (it's in `<head>`), so
|
|
39
|
+
* `self.__timber_f` already exists. However, shell-less status pages
|
|
40
|
+
* (e.g. standalone error pages) may have no `<head>` tag, so the init script
|
|
41
|
+
* never runs. The `||[]` guard ensures the array is created on first
|
|
42
|
+
* push if needed, preventing a TypeError. See TIM-559.
|
|
43
|
+
*/
|
|
44
|
+
export declare function flightChunkScript(data: string, nonce?: string): string;
|
|
45
|
+
/**
|
|
46
|
+
* Generate a push script for Flight bytes that are not valid UTF-8 — the
|
|
47
|
+
* binary row of a typed array or ArrayBuffer, which a `[1, text]` tuple
|
|
48
|
+
* cannot carry. Sent as base64 in a `[3, base64]` tuple; the browser
|
|
49
|
+
* decodes it back to the same bytes (client/browser-entry/rsc-stream.ts).
|
|
50
|
+
* Base64 has no character that can end the script element or the string,
|
|
51
|
+
* the same argument {@link formStateScript} makes.
|
|
52
|
+
*/
|
|
53
|
+
export declare function flightBinaryChunkScript(bytes: Uint8Array, nonce?: string): string;
|
|
54
|
+
/**
|
|
55
|
+
* Generate the script that embeds a no-JS action's form state for
|
|
56
|
+
* hydration: its Flight bytes (server/form-state-flight.ts), as base64. Only
|
|
57
|
+
* a page answering a no-JS action has one. Base64 carries Flight's binary
|
|
58
|
+
* rows, which a text chunk would corrupt, and has no character that can end
|
|
59
|
+
* the script element or the string. See design/08-forms-and-actions.md
|
|
60
|
+
* §"No-JS Result Round-Trip".
|
|
61
|
+
*/
|
|
62
|
+
export declare function formStateScript(bytes: Uint8Array, nonce?: string): string;
|
|
63
|
+
//# sourceMappingURL=flight-scripts.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flight-scripts.d.ts","sourceRoot":"","sources":["../../src/server/flight-scripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMxD;AAOD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzE"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Node halves of the Flight source helpers in `flight-source.ts`.
|
|
3
|
+
*
|
|
4
|
+
* Only loaded on Node (`flight-source.ts` imports it behind
|
|
5
|
+
* `nodeStreamsPlatform`), so Workers never evaluate it.
|
|
6
|
+
*
|
|
7
|
+
* A Node Flight source is an object-mode `Readable` whose chunks are exactly
|
|
8
|
+
* what React's `renderToPipeableStream` wrote: `Uint8Array` views for short
|
|
9
|
+
* rows, and JS strings for long rows (≥ ~1365 chars) and text row bodies.
|
|
10
|
+
* The Node Flight client (`createFromNodeStream`) requires every string chunk
|
|
11
|
+
* in its original shape — it throws "String chunks need to be passed in their
|
|
12
|
+
* original shape" if one is split or merged — so nothing here splits or
|
|
13
|
+
* concatenates a chunk on its way to a consumer.
|
|
14
|
+
*
|
|
15
|
+
* Design doc: 02-rendering-pipeline.md §"RSC → SSR → Client Hydration",
|
|
16
|
+
* §"Stream Tee"
|
|
17
|
+
*/
|
|
18
|
+
import { Readable } from 'node:stream';
|
|
19
|
+
declare global {
|
|
20
|
+
interface String {
|
|
21
|
+
toWellFormed(): string;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
/** A chunk of a Node Flight source. */
|
|
25
|
+
export type NodeFlightChunk = string | Uint8Array;
|
|
26
|
+
/** The part of React's `PipeableStream` a Flight render hands us. */
|
|
27
|
+
export interface PipeableFlight {
|
|
28
|
+
pipe<T extends NodeJS.WritableStream>(destination: T): T;
|
|
29
|
+
abort(reason?: unknown): void;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Release a Node Flight source: destroy it with `reason`, which aborts the
|
|
33
|
+
* render behind it. Cancellation reasons in the pipeline are `unknown` (a Web
|
|
34
|
+
* `cancel(reason)` takes anything); `destroy` takes an `Error`. Never throws
|
|
35
|
+
* and never leaves an unhandled `'error'` event, whoever is listening.
|
|
36
|
+
*/
|
|
37
|
+
export declare function destroyNodeFlight(stream: Readable, reason: unknown): void;
|
|
38
|
+
/** When a Node Flight render is aborted, besides its consumer cancelling. */
|
|
39
|
+
export interface NodeFlightAbort {
|
|
40
|
+
/** The request's signal (client disconnect). */
|
|
41
|
+
signal?: AbortSignal;
|
|
42
|
+
/** Abort with a `RenderTimeoutError` after this long, if still rendering. */
|
|
43
|
+
timeoutMs?: number;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Pipe a Flight render into an object-mode Node source.
|
|
47
|
+
*
|
|
48
|
+
* - Strings pass through `toWellFormed()`, as Next does
|
|
49
|
+
* (`renderToNodeFlightStream`): SSR decodes the raw string while the inline
|
|
50
|
+
* copy round-trips through JSON + `TextEncoder`, which turns a lone
|
|
51
|
+
* surrogate into U+FFFD, so without it SSR and hydration see different
|
|
52
|
+
* text. Length in UTF-16 units is unchanged, so a text row's length header
|
|
53
|
+
* still holds.
|
|
54
|
+
* - `renderToPipeableStream` takes no `signal`. `abort()` is called when the
|
|
55
|
+
* request signal fires, when `timeoutMs` passes (design/02 §"Always Wire
|
|
56
|
+
* abort() to Both Request Signal AND Timeout"), and when the source is
|
|
57
|
+
* destroyed (a consumer cancelling), with the destroy reason — the reason a
|
|
58
|
+
* Web `cancel(reason)` hands Flight. The listener and the timer are
|
|
59
|
+
* released when the source closes.
|
|
60
|
+
*/
|
|
61
|
+
export declare function pipeFlightToNode(flight: PipeableFlight, { signal, timeoutMs }: NodeFlightAbort): Readable;
|
|
62
|
+
/**
|
|
63
|
+
* Tee a Node Flight source into two object-mode branches, with the contract
|
|
64
|
+
* of `teeWithErrorPropagation` (`stream-utils.ts`):
|
|
65
|
+
*
|
|
66
|
+
* - Each branch has its own queue, so the lagging branch buffers without
|
|
67
|
+
* bound until the divergence guard (`maxBufferBytes`, default 5MB, counted
|
|
68
|
+
* in UTF-8 bytes) cancels both. Nothing couples the branches' backpressure:
|
|
69
|
+
* the inline branch is not read until Fizz emits its first HTML chunk, and
|
|
70
|
+
* Fizz needs SSR to consume Flight first, so a `pipe()` into two
|
|
71
|
+
* PassThroughs would deadlock once the inline one filled.
|
|
72
|
+
* - The source is read at the pace of the faster branch (paused only while
|
|
73
|
+
* neither branch wants data), like a Web `tee()`.
|
|
74
|
+
* - An error on the source, or a branch destroyed before it ended, destroys
|
|
75
|
+
* the other branch with an error and destroys the source — which aborts the
|
|
76
|
+
* render — so neither consumer hangs and both are released.
|
|
77
|
+
*/
|
|
78
|
+
export declare function teeNodeFlight(source: Readable, maxBufferBytes?: number): [Readable, Readable];
|
|
79
|
+
/**
|
|
80
|
+
* A Node Flight source as a `Response` (`NodeBodyResponse`): its body stays a
|
|
81
|
+
* Node stream all the way to the adapter, which pipes it to the socket
|
|
82
|
+
* (LOCAL-1475). Nothing in the Flight path converts it to a Web stream.
|
|
83
|
+
*
|
|
84
|
+
* Every chunk that arrives in one tick goes out as one buffer, with string
|
|
85
|
+
* chunks encoded straight into it. React writes a flush synchronously, and
|
|
86
|
+
* its Node build passes each long row as its own string: a heavy payload
|
|
87
|
+
* arrives as ~4x the chunks of the Web build's 4KB views, and the socket pays
|
|
88
|
+
* per write. The body pauses the source while the client is slow (a payload
|
|
89
|
+
* never piles up in memory), destroying it early destroys the source (which
|
|
90
|
+
* aborts the render), and an error or early close on the source ends it.
|
|
91
|
+
* Wired by hand rather than with `pipeline()`, which allocates an
|
|
92
|
+
* AbortController and an error on every finish.
|
|
93
|
+
*/
|
|
94
|
+
export declare function nodeFlightResponse(source: Readable, init: ResponseInit): Response;
|
|
95
|
+
/**
|
|
96
|
+
* Settles once a chunk (or the end) can be read from `source`, without
|
|
97
|
+
* consuming it: the chunk stays in the source for whatever reads it next.
|
|
98
|
+
* Rejects if the source errors first.
|
|
99
|
+
*
|
|
100
|
+
* The `'readable'` listener is removed on settle; Node restores the stream's
|
|
101
|
+
* flowing state on the next tick, so a consumer attached afterwards (a pipe,
|
|
102
|
+
* a `'data'` listener) still starts it.
|
|
103
|
+
*/
|
|
104
|
+
export declare function whenNodeFlightReadable(source: Readable): Promise<void>;
|
|
105
|
+
//# sourceMappingURL=flight-source-node.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flight-source-node.d.ts","sourceRoot":"","sources":["../../src/server/flight-source-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAC;AAQlD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,IAAI,MAAM,CAAC;KACxB;CACF;AAED,uCAAuC;AACvC,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,CAAC;AAElD,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IACzD,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAWD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CASzE;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe,GACrC,QAAQ,CA2BV;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,QAAQ,EAChB,cAAc,GAAE,MAAiC,GAChD,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAiItB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAEjF;AA2GD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBtE"}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flight sources — the one shape a Flight render takes on each platform.
|
|
3
|
+
*
|
|
4
|
+
* Every Flight render in the RSC environment goes through `renderFlight()`
|
|
5
|
+
* (`rsc-runtime/rsc.ts`, built by {@link createRenderFlight} here). On Node
|
|
6
|
+
* (`nodeStreamsPlatform`) it renders with `renderToPipeableStream` into an
|
|
7
|
+
* object-mode Node `Readable`; on Workers (and any runtime without native
|
|
8
|
+
* Node streams) with `renderToReadableStream`.
|
|
9
|
+
* A consumer on a given platform therefore only ever sees that platform's
|
|
10
|
+
* kind. The union exists so shared code typechecks for both; nothing adapts
|
|
11
|
+
* one kind into the other; a Node source becomes a Node-body response
|
|
12
|
+
* ({@link flightResponse}) that the adapter pipes to the socket.
|
|
13
|
+
*
|
|
14
|
+
* Consumers never switch on kind themselves — they use the helpers below:
|
|
15
|
+
* a timeout-guardable reader, cancel, tee, whole-payload collection, the
|
|
16
|
+
* response body, and the first-chunk wait.
|
|
17
|
+
*
|
|
18
|
+
* The Node halves live in `flight-source-node.ts`, loaded only on Node so
|
|
19
|
+
* Workers never evaluate them.
|
|
20
|
+
*
|
|
21
|
+
* Design doc: 02-rendering-pipeline.md §"RSC → SSR → Client Hydration"
|
|
22
|
+
*/
|
|
23
|
+
import type { Readable } from 'node:stream';
|
|
24
|
+
import { type ChunkReader, type TeeOptions } from './stream-utils.ts';
|
|
25
|
+
/** A Flight render's output, as its platform streams it. */
|
|
26
|
+
export type FlightSource = {
|
|
27
|
+
kind: 'node';
|
|
28
|
+
stream: Readable;
|
|
29
|
+
} | {
|
|
30
|
+
kind: 'web';
|
|
31
|
+
stream: ReadableStream<Uint8Array>;
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* One chunk of a Flight source. A Web source yields bytes only; a Node
|
|
35
|
+
* source yields bytes for short rows and JS strings for long rows, which
|
|
36
|
+
* must reach the Node Flight client unsplit and unmerged.
|
|
37
|
+
*/
|
|
38
|
+
export type FlightChunk = string | Uint8Array;
|
|
39
|
+
/** Options every Flight render takes. */
|
|
40
|
+
export interface FlightRenderOptions {
|
|
41
|
+
/**
|
|
42
|
+
* Flight's error callback. Its return value is the digest written into the
|
|
43
|
+
* error row.
|
|
44
|
+
*/
|
|
45
|
+
onError?: (error: unknown) => string | void;
|
|
46
|
+
/** Aborts the render (client disconnect). */
|
|
47
|
+
signal?: AbortSignal;
|
|
48
|
+
/**
|
|
49
|
+
* Aborts the render with a `RenderTimeoutError` after this long, if it is
|
|
50
|
+
* still running. Defaults to the configured `renderTimeoutMs`
|
|
51
|
+
* ({@link setFlightRenderTimeout}), so no render can stream forever. Node only, where the source's close clears the timer:
|
|
52
|
+
* Workers keep the stock `renderToReadableStream` call, whose end is not
|
|
53
|
+
* observable without wrapping its stream, and bound a request's wall time
|
|
54
|
+
* themselves.
|
|
55
|
+
*/
|
|
56
|
+
timeoutMs?: number;
|
|
57
|
+
}
|
|
58
|
+
export declare function setFlightRenderTimeout(timeoutMs: number | undefined): void;
|
|
59
|
+
/** Render a model to a Flight source. */
|
|
60
|
+
export type RenderFlight = (model: unknown, options?: FlightRenderOptions) => FlightSource;
|
|
61
|
+
/** plugin-rsc's `renderToReadableStream`, with the options timber passes. */
|
|
62
|
+
export type WebFlightRenderer = (model: unknown, options?: {
|
|
63
|
+
onError?: (error: unknown) => string | void;
|
|
64
|
+
signal?: AbortSignal;
|
|
65
|
+
}) => ReadableStream<Uint8Array>;
|
|
66
|
+
/** plugin-rsc's `renderToPipeableStream` (`rsc.node`), with the options timber passes. */
|
|
67
|
+
export type NodeFlightRenderer = (model: unknown, options?: {
|
|
68
|
+
onError?: (error: unknown) => string | void;
|
|
69
|
+
}) => import('./flight-source-node.ts').PipeableFlight;
|
|
70
|
+
/**
|
|
71
|
+
* Build `renderFlight()` from the platform's renderers. The Node renderer is
|
|
72
|
+
* used whenever it was loaded (on Node it always is — see `rsc-runtime/rsc.ts`);
|
|
73
|
+
* otherwise every render is a Web stream.
|
|
74
|
+
*
|
|
75
|
+
* On Node only one Flight server build may ever render in a process: React
|
|
76
|
+
* throws "Currently React only supports one RSC renderer at a time" when a
|
|
77
|
+
* second build's render starts. That is the second reason every render goes
|
|
78
|
+
* through here.
|
|
79
|
+
*/
|
|
80
|
+
export declare function createRenderFlight(web: WebFlightRenderer, node: NodeFlightRenderer | null): RenderFlight;
|
|
81
|
+
/** A pull reader over a Flight source, of either kind. */
|
|
82
|
+
export interface FlightReader extends ChunkReader<FlightChunk> {
|
|
83
|
+
/**
|
|
84
|
+
* Every chunk the source already holds, taken without waiting — for
|
|
85
|
+
* coalescing them into one inline script. Always empty for a Web source,
|
|
86
|
+
* which has no synchronous read.
|
|
87
|
+
*/
|
|
88
|
+
takeBuffered(): FlightChunk[];
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* A pull reader over either kind. `read()` is unguarded: every caller races
|
|
92
|
+
* it against a timeout (design/02 §"Always Timeout-Guard Stream Reads").
|
|
93
|
+
* `cancel()` releases the source, which aborts the render.
|
|
94
|
+
*/
|
|
95
|
+
export declare function openFlightReader(source: FlightSource): FlightReader;
|
|
96
|
+
/** Release a source nothing will read, aborting the render behind it. */
|
|
97
|
+
export declare function cancelFlightSource(source: FlightSource, reason?: unknown): void;
|
|
98
|
+
/** A chunk as bytes. */
|
|
99
|
+
export declare function flightChunkBytes(chunk: FlightChunk): Uint8Array;
|
|
100
|
+
/**
|
|
101
|
+
* Read a whole Flight source into bytes under one overall deadline, cancelling
|
|
102
|
+
* it on every exit (`drainWithDeadline`). For renders whose payload is stored
|
|
103
|
+
* rather than streamed: the no-JS form state and both prebuilt captures.
|
|
104
|
+
*/
|
|
105
|
+
export declare function collectFlightBytes(source: FlightSource, timeoutMs: number, label: string): Promise<Uint8Array<ArrayBuffer>>;
|
|
106
|
+
/**
|
|
107
|
+
* Tee a source for SSR and the inline payload, each branch its source's kind.
|
|
108
|
+
* Both implementations share one contract: unbounded lag up to the
|
|
109
|
+
* divergence guard, and an error or cancel on either branch reaches the
|
|
110
|
+
* other and the render (design/02 §"Stream Tee").
|
|
111
|
+
*/
|
|
112
|
+
export declare function teeFlightSource(source: FlightSource, options?: TeeOptions): [FlightSource, FlightSource];
|
|
113
|
+
/**
|
|
114
|
+
* A source as a `Response`. A Web source is the body as is; a Node source
|
|
115
|
+
* stays a Node stream to the socket (`NodeBodyResponse`, node-response.ts), so
|
|
116
|
+
* a payload is never converted Node → Web → Node.
|
|
117
|
+
*/
|
|
118
|
+
export declare function flightResponse(source: FlightSource, init: ResponseInit): Response;
|
|
119
|
+
/** A source whose first chunk can be awaited without losing it. */
|
|
120
|
+
export interface FlightPeek {
|
|
121
|
+
/**
|
|
122
|
+
* Settles when the first chunk (or the end) is available. Rejects if the
|
|
123
|
+
* source errors first. Unguarded, like every read: callers race it.
|
|
124
|
+
*/
|
|
125
|
+
ready: Promise<void>;
|
|
126
|
+
/** The source, first chunk included — what to send or cancel afterwards. */
|
|
127
|
+
source: FlightSource;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Wait for a source's first chunk without consuming it, so the payload path
|
|
131
|
+
* can decide on a response before committing to the stream. A Node source
|
|
132
|
+
* waits for `'readable'` and keeps its chunk; a Web source reads the chunk
|
|
133
|
+
* and replays it at the head of a wrapping stream.
|
|
134
|
+
*/
|
|
135
|
+
export declare function peekFlight(source: FlightSource): FlightPeek;
|
|
136
|
+
//# sourceMappingURL=flight-source.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flight-source.d.ts","sourceRoot":"","sources":["../../src/server/flight-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAE3B,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAc9C,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE1E;AAED,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,YAAY,CAAC;AAE3F,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC5E,cAAc,CAAC,UAAU,CAAC,CAAC;AAEhC,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;CAAE,KACtD,OAAO,yBAAyB,EAAE,cAAc,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAC9B,YAAY,CAed;AAID,0DAA0D;AAC1D,MAAM,WAAW,YAAa,SAAQ,WAAW,CAAC,WAAW,CAAC;IAC5D;;;;OAIG;IACH,YAAY,IAAI,WAAW,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA8BnE;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAM/E;AAED,wBAAwB;AACxB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAE/D;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAGlC;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,CAAC,YAAY,EAAE,YAAY,CAAC,CAa9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAGjF;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,4EAA4E;IAC5E,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAmB3D"}
|
|
@@ -15,16 +15,31 @@
|
|
|
15
15
|
* Handles:
|
|
16
16
|
* - **Duplicate keys → arrays**: `tags=js&tags=ts` → `{ tags: ["js", "ts"] }`
|
|
17
17
|
* - **Nested dot-paths**: `user.name=Alice` → `{ user: { name: "Alice" } }`
|
|
18
|
-
* - **
|
|
18
|
+
* - **Indexed lists → arrays**: `rows.0.name=A&rows.1.name=B` →
|
|
19
|
+
* `{ rows: [{ name: "A" }, { name: "B" }] }`, when the indexes are exactly
|
|
20
|
+
* `0..n-1`. A list with a gap stays an object keyed by index.
|
|
21
|
+
* - **Empty strings stay `""`**: a blank text input is `""`, so
|
|
22
|
+
* `z.string().min(1, 'Required')` reports its own message. Use
|
|
23
|
+
* `coerce.text` to make a blank optional field `undefined`
|
|
19
24
|
* - **Empty Files → undefined**: File inputs with no selection become `undefined`
|
|
20
25
|
* - **Strips `$ACTION_*` fields**: React's internal hidden fields are excluded
|
|
26
|
+
* - **Drops `__proto__` paths and names deeper than 32 segments**
|
|
27
|
+
*
|
|
28
|
+
* A field's shape follows its count: a name sent once is a scalar, several
|
|
29
|
+
* times an array, never at all absent. A `createActionClient` action with a
|
|
30
|
+
* schema then gives every field the schema declares as a list one shape
|
|
31
|
+
* (`normalizeListFields` in `schema-introspection.ts`). A raw call, and a raw
|
|
32
|
+
* `'use server'` action that calls this itself, keep the count-dependent
|
|
33
|
+
* shape.
|
|
21
34
|
*/
|
|
22
35
|
export declare function parseFormData(formData: FormData): Record<string, unknown>;
|
|
23
36
|
/**
|
|
24
37
|
* Schema-agnostic coercion primitives for common FormData patterns.
|
|
25
38
|
*
|
|
26
39
|
* These are plain transform functions — they compose with any schema library's
|
|
27
|
-
* `transform`/`preprocess` pipeline
|
|
40
|
+
* `transform`/`preprocess` pipeline. In Zod, use `z.preprocess`: it runs on an
|
|
41
|
+
* absent key (an unchecked checkbox), where `z.unknown().transform()` fails
|
|
42
|
+
* with "expected nonoptional" before the transform runs.
|
|
28
43
|
*
|
|
29
44
|
* ```ts
|
|
30
45
|
* // Zod
|
|
@@ -34,6 +49,19 @@ export declare function parseFormData(formData: FormData): Record<string, unknow
|
|
|
34
49
|
* ```
|
|
35
50
|
*/
|
|
36
51
|
export declare const coerce: {
|
|
52
|
+
/**
|
|
53
|
+
* Coerce an empty string to undefined for optional text fields.
|
|
54
|
+
* Use with `.optional()` schemas where an empty input means "not provided".
|
|
55
|
+
*
|
|
56
|
+
* ```ts
|
|
57
|
+
* // Zod — preprocess, not `z.unknown().transform(…)`: Zod 4 rejects an
|
|
58
|
+
* // absent key before a transform runs ("expected nonoptional")
|
|
59
|
+
* z.preprocess(coerce.text, z.string().optional())
|
|
60
|
+
* // Valibot
|
|
61
|
+
* v.pipe(v.unknown(), v.transform(coerce.text), v.optional(v.string()))
|
|
62
|
+
* ```
|
|
63
|
+
*/
|
|
64
|
+
text(value: unknown): string | undefined;
|
|
37
65
|
/**
|
|
38
66
|
* Coerce a string to a number.
|
|
39
67
|
* - `"42"` → `42`
|
|
@@ -56,5 +84,34 @@ export declare const coerce: {
|
|
|
56
84
|
* - Invalid JSON → `undefined` (schema validation will catch this)
|
|
57
85
|
*/
|
|
58
86
|
json(value: unknown): unknown;
|
|
87
|
+
/**
|
|
88
|
+
* Coerce a date string to a Date object.
|
|
89
|
+
* Handles `<input type="date">` (`"2024-01-15"`), `<input type="datetime-local">`
|
|
90
|
+
* (`"2024-01-15T10:30"`), and full ISO 8601 strings.
|
|
91
|
+
* - Valid date string → `Date`
|
|
92
|
+
* - `""` / `undefined` / `null` → `undefined`
|
|
93
|
+
* - Invalid date strings → `undefined` (schema validation will catch this)
|
|
94
|
+
* - Impossible dates that `new Date()` silently normalizes (e.g. Feb 31) → `undefined`
|
|
95
|
+
*/
|
|
96
|
+
date(value: unknown): Date | undefined;
|
|
97
|
+
/**
|
|
98
|
+
* Create a File coercion function with optional size and mime type validation.
|
|
99
|
+
* Returns the File if valid, `undefined` otherwise.
|
|
100
|
+
*
|
|
101
|
+
* ```ts
|
|
102
|
+
* // Basic — just checks it's a real File
|
|
103
|
+
* z.preprocess(coerce.file(), z.instanceof(File))
|
|
104
|
+
*
|
|
105
|
+
* // With constraints
|
|
106
|
+
* z.preprocess(
|
|
107
|
+
* coerce.file({ maxSize: 5 * 1024 * 1024, accept: ['image/png', 'image/jpeg'] }),
|
|
108
|
+
* z.instanceof(File)
|
|
109
|
+
* )
|
|
110
|
+
* ```
|
|
111
|
+
*/
|
|
112
|
+
file(options?: {
|
|
113
|
+
maxSize?: number;
|
|
114
|
+
accept?: string[];
|
|
115
|
+
}): (value: unknown) => File | undefined;
|
|
59
116
|
};
|
|
60
117
|
//# sourceMappingURL=form-data.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"form-data.d.ts","sourceRoot":"","sources":["../../src/server/form-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH
|
|
1
|
+
{"version":3,"file":"form-data.d.ts","sourceRoot":"","sources":["../../src/server/form-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzE;AAgID;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM;IACjB;;;;;;;;;;;OAWG;IACH,IAAI,QAAQ,OAAO,GAAG,MAAM,GAAG,SAAS;IAMxC;;;;;;OAMG;IACH,MAAM,QAAQ,OAAO,GAAG,MAAM,GAAG,SAAS;IAS1C;;;;;OAKG;IACH,QAAQ,QAAQ,OAAO,GAAG,OAAO;IAOjC;;;;;OAKG;IACH,IAAI,QAAQ,OAAO,GAAG,OAAO;IAU7B;;;;;;;;OAQG;IACH,IAAI,QAAQ,OAAO,GAAG,IAAI,GAAG,SAAS;IAgCtC;;;;;;;;;;;;;;OAcG;IACH,IAAI,WAAW;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,SAAS;CAmB9F,CAAC"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The no-JS action form state a page render hands React (TIM-1570), encoded
|
|
3
|
+
* with Flight (TIM-1572).
|
|
4
|
+
*
|
|
5
|
+
* Fizz renders the `useActionState` hook that submitted with the action's
|
|
6
|
+
* result, and the browser must hydrate with the same value, or the hook
|
|
7
|
+
* resets. Both get it from the Flight bytes encoded here: SSR decodes them
|
|
8
|
+
* for Fizz (`NavContext.formState`) and, once they decode, embeds them for
|
|
9
|
+
* `hydrateRoot` (server/ssr-form-state.ts; decoded by
|
|
10
|
+
* client/browser-entry/form-state.ts). Flight is what carries a
|
|
11
|
+
* `useActionState` result with JS, so a result has the same types with and
|
|
12
|
+
* without JS. See shared/form-state-flight.ts for the decode.
|
|
13
|
+
*
|
|
14
|
+
* A state Flight cannot encode must not turn the page into a 500 after the
|
|
15
|
+
* action's mutation committed, so it is dropped from both renders: the page
|
|
16
|
+
* renders with no result, as for a form without `useActionState`. That is a
|
|
17
|
+
* value Flight cannot serialize (a plain function, a class instance), which
|
|
18
|
+
* fails the action with JS too, or a nested promise that rejects or does not
|
|
19
|
+
* settle in time, which with JS reaches the hook as that rejected or pending
|
|
20
|
+
* promise. The no-JS page cannot carry a pending promise, and does not embed
|
|
21
|
+
* an error row.
|
|
22
|
+
*
|
|
23
|
+
* See design/08-forms-and-actions.md §"No-JS Result Round-Trip".
|
|
24
|
+
*/
|
|
25
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
26
|
+
/**
|
|
27
|
+
* Serialize the form state with Flight, or return `null` when it cannot be,
|
|
28
|
+
* with a warning. The whole payload is read under one `timeoutMs` deadline,
|
|
29
|
+
* and the render stops when `signal` (the request's) aborts.
|
|
30
|
+
*/
|
|
31
|
+
export declare function encodeFormState(formState: ReactFormState, timeoutMs: number, signal?: AbortSignal): Promise<Uint8Array | null>;
|
|
32
|
+
//# sourceMappingURL=form-state-flight.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"form-state-flight.d.ts","sourceRoot":"","sources":["../../src/server/form-state-flight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA2B5B"}
|