@timber-js/app 0.2.0-alpha.240 → 0.2.0-alpha.242
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/dist/_chunks/{actions-DIgnvDrG.js → actions-BkwgRwCl.js} +146 -12
- package/dist/_chunks/actions-BkwgRwCl.js.map +1 -0
- package/dist/_chunks/{als-registry-PPYstxK0.js → als-registry-C-iwbtvI.js} +4 -3
- package/dist/_chunks/{als-registry-PPYstxK0.js.map → als-registry-C-iwbtvI.js.map} +1 -1
- package/dist/_chunks/{als-slots-kbQrHTzm.js → als-slots-CVTF-AMz.js} +3 -3
- package/dist/_chunks/als-slots-CVTF-AMz.js.map +1 -0
- package/dist/_chunks/{cache-api-uWQwuxWb.js → cache-api-BGA7c5qJ.js} +5 -5
- package/dist/_chunks/{cache-api-uWQwuxWb.js.map → cache-api-BGA7c5qJ.js.map} +1 -1
- package/dist/_chunks/{chains-C7CExrUI.js → chains-Cuwwjv6T.js} +2 -2
- package/dist/_chunks/{chains-C7CExrUI.js.map → chains-Cuwwjv6T.js.map} +1 -1
- package/dist/_chunks/chains-LGjBHfSN.js +1 -0
- package/dist/_chunks/{classify-Cj9EeZoL.js → classify-Y8S9C0Na.js} +2 -2
- package/dist/_chunks/{classify-Cj9EeZoL.js.map → classify-Y8S9C0Na.js.map} +1 -1
- package/dist/_chunks/{cli-check-C3QOAru7.js → cli-check-KeE1QaIx.js} +7 -6
- package/dist/_chunks/cli-check-KeE1QaIx.js.map +1 -0
- package/dist/_chunks/{cli-schema-sync-DQUS_o3V.js → cli-schema-sync-DZEF31wd.js} +2 -2
- package/dist/_chunks/{cli-schema-sync-DQUS_o3V.js.map → cli-schema-sync-DZEF31wd.js.map} +1 -1
- package/dist/_chunks/{cli-schema-sync-BRxZz66D.js → cli-schema-sync-_y5O6MIg.js} +1 -1
- package/dist/_chunks/{client-dep-entries-ZETBdLgv.js → client-dep-entries-DpiwvoDi.js} +2 -2
- package/dist/_chunks/{client-dep-entries-ZETBdLgv.js.map → client-dep-entries-DpiwvoDi.js.map} +1 -1
- package/dist/_chunks/{cloudflare-Dk5Hqo-O.js → cloudflare-9dbhVOxS.js} +2 -2
- package/dist/_chunks/{cloudflare-Dk5Hqo-O.js.map → cloudflare-9dbhVOxS.js.map} +1 -1
- package/dist/_chunks/{convention-lint-BoVISNS6.js → convention-lint-0AEsPK2T.js} +378 -10
- package/dist/_chunks/convention-lint-0AEsPK2T.js.map +1 -0
- package/dist/_chunks/dev-server-CboXr8zX.js +1 -0
- package/dist/_chunks/{dev-server-C5R6jx8Q.js → dev-server-DYDr8KIc.js} +9 -3
- package/dist/_chunks/dev-server-DYDr8KIc.js.map +1 -0
- package/dist/_chunks/{dist-C1Rjlo6s.js → dist-GyaJm4GA.js} +18 -2
- package/dist/_chunks/dist-GyaJm4GA.js.map +1 -0
- package/dist/_chunks/{error-boundary-DB51f9ih.js → error-boundary-wuNvAJ4n.js} +11 -14
- package/dist/_chunks/error-boundary-wuNvAJ4n.js.map +1 -0
- package/dist/_chunks/{flight-source-node-D9cHBhjP.js → flight-source-node-KQsX_OhS.js} +4 -7
- package/dist/_chunks/flight-source-node-KQsX_OhS.js.map +1 -0
- package/dist/_chunks/{json-lossy-check-Y1GxqVX_.js → json-lossy-check-BVDALqMf.js} +2 -2
- package/dist/_chunks/{json-lossy-check-Y1GxqVX_.js.map → json-lossy-check-BVDALqMf.js.map} +1 -1
- package/dist/_chunks/key-headers-uIig1_mU.js +40 -0
- package/dist/_chunks/key-headers-uIig1_mU.js.map +1 -0
- package/dist/_chunks/{live-graph-BDQWvnMm.js → live-graph-VhzO7Ol9.js} +4 -4
- package/dist/_chunks/{live-graph-BDQWvnMm.js.map → live-graph-VhzO7Ol9.js.map} +1 -1
- package/dist/_chunks/{logger-DmRR9tmZ.js → logger-C4m8rfMy.js} +2 -2
- package/dist/_chunks/{logger-DmRR9tmZ.js.map → logger-C4m8rfMy.js.map} +1 -1
- package/dist/_chunks/metadata-routes-MXNjWOt5.js.map +1 -1
- package/dist/_chunks/{node-response-yp8zdyRp.js → node-response-8Vz29cGS.js} +2 -2
- package/dist/_chunks/{node-response-yp8zdyRp.js.map → node-response-8Vz29cGS.js.map} +1 -1
- package/dist/_chunks/{poison-scan-WQgUydF_.js → poison-scan-Dpl3ibG-.js} +2 -2
- package/dist/_chunks/{poison-scan-WQgUydF_.js.map → poison-scan-Dpl3ibG-.js.map} +1 -1
- package/dist/_chunks/{rsc-cache-key-D0cb0Gmc.js → rsc-cache-key-BGvUtMtN.js} +40 -4
- package/dist/_chunks/{rsc-cache-key-D0cb0Gmc.js.map → rsc-cache-key-BGvUtMtN.js.map} +1 -1
- package/dist/_chunks/{scanner-C9Lrf77z.js → scanner-CCEHN9Jg.js} +14 -81
- package/dist/_chunks/scanner-CCEHN9Jg.js.map +1 -0
- package/dist/_chunks/{sizeof-BISkSaU0.js → sizeof-CIF7fwSJ.js} +2 -2
- package/dist/_chunks/{sizeof-BISkSaU0.js.map → sizeof-CIF7fwSJ.js.map} +1 -1
- package/dist/_chunks/{walkers-Bxv4v7tX.js → walkers-BbotBhNG.js} +3 -3
- package/dist/_chunks/{walkers-Bxv4v7tX.js.map → walkers-BbotBhNG.js.map} +1 -1
- package/dist/adapters/cloudflare-dev.js +1 -1
- package/dist/adapters/cloudflare-kv-cache.js +2 -2
- package/dist/adapters/cloudflare.js +1 -1
- package/dist/analyze/crawl-entry.js +3 -3
- package/dist/analyze/graph-command.js +2 -2
- package/dist/cache/index.js +2 -2
- package/dist/cache/stores/memory.js +1 -1
- package/dist/cdn/workers-cache-purge.js +1 -1
- package/dist/cli-check.d.ts +3 -0
- package/dist/cli-check.d.ts.map +1 -1
- package/dist/cli.js +3 -3
- package/dist/client/browser-entry/router-init.d.ts +0 -1
- package/dist/client/browser-entry/router-init.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -1
- package/dist/client/index.js +2 -2
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.js +4 -5
- package/dist/client/internal.js.map +1 -1
- package/dist/client/navigation-commit.d.ts +3 -5
- package/dist/client/navigation-commit.d.ts.map +1 -1
- package/dist/client/outlet-content-cache.d.ts +25 -30
- package/dist/client/outlet-content-cache.d.ts.map +1 -1
- package/dist/client/outlet-scope-context.d.ts +4 -4
- package/dist/client/outlet-scope-context.d.ts.map +1 -1
- package/dist/client/params-context.d.ts +1 -1
- package/dist/client/router-types.d.ts +3 -13
- package/dist/client/router-types.d.ts.map +1 -1
- package/dist/client/router.d.ts.map +1 -1
- package/dist/client/segment-cache.d.ts +2 -2
- package/dist/client/segment-outlet.d.ts +12 -13
- package/dist/client/segment-outlet.d.ts.map +1 -1
- package/dist/client/stale-segment.d.ts +2 -2
- package/dist/config-types.d.ts +22 -15
- package/dist/config-types.d.ts.map +1 -1
- package/dist/config-validation.d.ts.map +1 -1
- package/dist/cookies/define-cookie.d.ts.map +1 -1
- package/dist/cookies/index.js +5 -2
- package/dist/cookies/index.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +109 -26
- package/dist/index.js.map +1 -1
- package/dist/native/rsc/cookies/define-cookie.js +6 -2
- package/dist/native/rsc/cookies/define-cookie.js.map +1 -1
- package/dist/native/rsc/manifest.json +12 -4
- package/dist/native/rsc/routing/segment-keys.js +11 -1
- package/dist/native/rsc/routing/segment-keys.js.map +1 -1
- package/dist/native/rsc/search-params/define.js +4 -1
- package/dist/native/rsc/search-params/define.js.map +1 -1
- package/dist/native/rsc/server/als-registry.js +2 -2
- package/dist/native/rsc/server/als-registry.js.map +1 -1
- package/dist/native/rsc/server/client-state-tree.js +13 -12
- package/dist/native/rsc/server/client-state-tree.js.map +1 -1
- package/dist/native/rsc/server/cookie-context.js +12 -0
- package/dist/native/rsc/server/cookie-context.js.map +1 -1
- package/dist/native/rsc/server/flight-source-node.js +2 -5
- package/dist/native/rsc/server/flight-source-node.js.map +1 -1
- package/dist/native/rsc/server/flight-source.js +8 -40
- package/dist/native/rsc/server/flight-source.js.map +1 -1
- package/dist/native/rsc/server/framework-stack-frames.js +18 -0
- package/dist/native/rsc/server/framework-stack-frames.js.map +1 -0
- package/dist/native/rsc/server/prebuilt-builder.js +15 -1
- package/dist/native/rsc/server/prebuilt-builder.js.map +1 -1
- package/dist/native/rsc/server/request-context.js +11 -5
- package/dist/native/rsc/server/request-context.js.map +1 -1
- package/dist/native/rsc/server/route-element-builder.js +29 -11
- package/dist/native/rsc/server/route-element-builder.js.map +1 -1
- package/dist/native/rsc/server/route-module-loader.js +14 -6
- package/dist/native/rsc/server/route-module-loader.js.map +1 -1
- package/dist/native/rsc/server/rsc-cache-key-guard.js +5 -1
- package/dist/native/rsc/server/rsc-cache-key-guard.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/render-route.js +10 -29
- package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +7 -2
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/rsc-stream.js +2 -5
- package/dist/native/rsc/server/rsc-entry/rsc-stream.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/document-outlet.js +24 -0
- package/dist/native/rsc/server/segment-lifetime/document-outlet.js.map +1 -0
- package/dist/native/rsc/server/segment-lifetime/key-digest.js +74 -0
- package/dist/native/rsc/server/segment-lifetime/key-digest.js.map +1 -0
- package/dist/native/rsc/server/segment-lifetime/outlet-gate.js +44 -0
- package/dist/native/rsc/server/segment-lifetime/outlet-gate.js.map +1 -0
- package/dist/native/rsc/server/segment-lifetime/read-rule.js +78 -0
- package/dist/native/rsc/server/segment-lifetime/read-rule.js.map +1 -0
- package/dist/native/rsc/server/segment-lifetime/read-scope.js +41 -0
- package/dist/native/rsc/server/segment-lifetime/read-scope.js.map +1 -0
- package/dist/native/rsc/server/segment-lifetime/segment-key.js +64 -0
- package/dist/native/rsc/server/segment-lifetime/segment-key.js.map +1 -0
- package/dist/native/rsc/server/segment-lifetime/slot-outlets.js +72 -0
- package/dist/native/rsc/server/segment-lifetime/slot-outlets.js.map +1 -0
- package/dist/native/rsc/server/slot-resolver.js +51 -27
- package/dist/native/rsc/server/slot-resolver.js.map +1 -1
- package/dist/native/rsc/server/slot-subtree-contain.js +17 -89
- package/dist/native/rsc/server/slot-subtree-contain.js.map +1 -1
- package/dist/native/rsc/server/subtree-walk.js +140 -0
- package/dist/native/rsc/server/subtree-walk.js.map +1 -0
- package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
- package/dist/native/rsc/shared/als-slots.js +2 -2
- package/dist/native/rsc/shared/als-slots.js.map +1 -1
- package/dist/native/rsc/shared/cookie-read-through.js +5 -0
- package/dist/native/rsc/shared/cookie-read-through.js.map +1 -0
- package/dist/native/rsc/shared/key-headers.js +20 -0
- package/dist/native/rsc/shared/key-headers.js.map +1 -0
- package/dist/native/rsc/shared/outlet-decision.js.map +1 -1
- package/dist/native/rsc/shared/route-options-export.js +8 -0
- package/dist/native/rsc/shared/route-options-export.js.map +1 -0
- package/dist/native/rsc/shared/rsc-cache-key.js +19 -3
- package/dist/native/rsc/shared/rsc-cache-key.js.map +1 -1
- package/dist/native/rsc/shims/headers.js +3 -4
- package/dist/native/rsc/shims/headers.js.map +1 -1
- package/dist/native/ssr/client/outlet-content-cache.js +12 -18
- package/dist/native/ssr/client/outlet-content-cache.js.map +1 -1
- package/dist/native/ssr/client/outlet-scope-context.js.map +1 -1
- package/dist/native/ssr/client/segment-outlet.js +6 -19
- package/dist/native/ssr/client/segment-outlet.js.map +1 -1
- package/dist/native/ssr/cookies/define-cookie.js +6 -2
- package/dist/native/ssr/cookies/define-cookie.js.map +1 -1
- package/dist/native/ssr/manifest.json +5 -1
- package/dist/native/ssr/search-params/define.js +4 -1
- package/dist/native/ssr/search-params/define.js.map +1 -1
- package/dist/native/ssr/server/als-registry.js +2 -2
- package/dist/native/ssr/server/als-registry.js.map +1 -1
- package/dist/native/ssr/server/client-state-tree.js +13 -12
- package/dist/native/ssr/server/client-state-tree.js.map +1 -1
- package/dist/native/ssr/server/cookie-context.js +12 -0
- package/dist/native/ssr/server/cookie-context.js.map +1 -1
- package/dist/native/ssr/server/flight-source-node.js +2 -5
- package/dist/native/ssr/server/flight-source-node.js.map +1 -1
- package/dist/native/ssr/server/flight-source.js +1 -1
- package/dist/native/ssr/server/flight-source.js.map +1 -1
- package/dist/native/ssr/server/framework-stack-frames.js +18 -0
- package/dist/native/ssr/server/framework-stack-frames.js.map +1 -0
- package/dist/native/ssr/server/request-context.js +11 -5
- package/dist/native/ssr/server/request-context.js.map +1 -1
- package/dist/native/ssr/server/rsc-cache-key-guard.js +5 -1
- package/dist/native/ssr/server/rsc-cache-key-guard.js.map +1 -1
- package/dist/native/ssr/server/segment-lifetime/key-digest.js +6 -0
- package/dist/native/ssr/server/segment-lifetime/key-digest.js.map +1 -0
- package/dist/native/ssr/server/segment-lifetime/read-rule.js +78 -0
- package/dist/native/ssr/server/segment-lifetime/read-rule.js.map +1 -0
- package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
- package/dist/native/ssr/shared/als-slots.js +2 -2
- package/dist/native/ssr/shared/als-slots.js.map +1 -1
- package/dist/native/ssr/shared/cookie-read-through.js +5 -0
- package/dist/native/ssr/shared/cookie-read-through.js.map +1 -0
- package/dist/native/ssr/shared/key-headers.js +13 -0
- package/dist/native/ssr/shared/key-headers.js.map +1 -0
- package/dist/native/ssr/shared/rsc-cache-key.js +19 -3
- package/dist/native/ssr/shared/rsc-cache-key.js.map +1 -1
- package/dist/native/ssr/shims/headers.js +3 -4
- package/dist/native/ssr/shims/headers.js.map +1 -1
- package/dist/plugins/callsite-jsx.d.ts +8 -1
- package/dist/plugins/callsite-jsx.d.ts.map +1 -1
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/plugins/prerender-sugar.d.ts +9 -8
- package/dist/plugins/prerender-sugar.d.ts.map +1 -1
- package/dist/plugins/routing.d.ts.map +1 -1
- package/dist/routing/convention-lint.d.ts +11 -3
- package/dist/routing/convention-lint.d.ts.map +1 -1
- package/dist/routing/export-detect.d.ts +50 -23
- package/dist/routing/export-detect.d.ts.map +1 -1
- package/dist/routing/index.js +2 -2
- package/dist/routing/route-options-lint.d.ts +36 -0
- package/dist/routing/route-options-lint.d.ts.map +1 -0
- package/dist/routing/route-options.d.ts +55 -0
- package/dist/routing/route-options.d.ts.map +1 -0
- package/dist/routing/segment-keys.d.ts +38 -4
- package/dist/routing/segment-keys.d.ts.map +1 -1
- package/dist/search-params/index.js +5 -2
- package/dist/search-params/index.js.map +1 -1
- package/dist/server/als-registry.d.ts +22 -13
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/client-state-tree.d.ts +11 -10
- package/dist/server/client-state-tree.d.ts.map +1 -1
- package/dist/server/cookie-context.d.ts +3 -0
- package/dist/server/cookie-context.d.ts.map +1 -1
- package/dist/server/flight-source-node.d.ts +1 -6
- package/dist/server/flight-source-node.d.ts.map +1 -1
- package/dist/server/flight-source.d.ts +4 -28
- package/dist/server/flight-source.d.ts.map +1 -1
- package/dist/server/framework-stack-frames.d.ts +20 -0
- package/dist/server/framework-stack-frames.d.ts.map +1 -0
- package/dist/server/index.d.ts +1 -0
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +2 -2
- package/dist/server/internal.js +102 -28
- package/dist/server/internal.js.map +1 -1
- package/dist/server/prebuilt/capture-routes.d.ts +1 -1
- package/dist/server/prebuilt-builder.d.ts.map +1 -1
- package/dist/server/request-context.d.ts +6 -1
- package/dist/server/request-context.d.ts.map +1 -1
- package/dist/server/route-element-builder.d.ts +2 -2
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/route-module-loader.d.ts +10 -2
- package/dist/server/route-module-loader.d.ts.map +1 -1
- package/dist/server/rsc-cache-key-guard.d.ts +3 -1
- package/dist/server/rsc-cache-key-guard.d.ts.map +1 -1
- package/dist/server/rsc-entry/helpers.d.ts +1 -1
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts +10 -1
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
- package/dist/server/rsc-entry/revalidate-renderer.d.ts +12 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts +2 -11
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/segment-lifetime/document-outlet.d.ts +66 -0
- package/dist/server/segment-lifetime/document-outlet.d.ts.map +1 -0
- package/dist/server/segment-lifetime/key-digest.d.ts +46 -0
- package/dist/server/segment-lifetime/key-digest.d.ts.map +1 -0
- package/dist/server/segment-lifetime/outlet-gate.d.ts +58 -0
- package/dist/server/segment-lifetime/outlet-gate.d.ts.map +1 -0
- package/dist/server/segment-lifetime/read-rule.d.ts +53 -0
- package/dist/server/segment-lifetime/read-rule.d.ts.map +1 -0
- package/dist/server/segment-lifetime/read-scope.d.ts +40 -0
- package/dist/server/segment-lifetime/read-scope.d.ts.map +1 -0
- package/dist/server/segment-lifetime/segment-key.d.ts +63 -0
- package/dist/server/segment-lifetime/segment-key.d.ts.map +1 -0
- package/dist/server/segment-lifetime/slot-outlets.d.ts +81 -0
- package/dist/server/segment-lifetime/slot-outlets.d.ts.map +1 -0
- package/dist/server/slot-resolver.d.ts +10 -5
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/slot-subtree-contain.d.ts +2 -6
- package/dist/server/slot-subtree-contain.d.ts.map +1 -1
- package/dist/server/subtree-walk.d.ts +56 -0
- package/dist/server/subtree-walk.d.ts.map +1 -0
- package/dist/server/types.d.ts +75 -0
- package/dist/server/types.d.ts.map +1 -1
- package/dist/server/vite-handoff-rsc.d.ts +1 -10
- package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
- package/dist/shared/als-slots.d.ts +12 -2
- package/dist/shared/als-slots.d.ts.map +1 -1
- package/dist/shared/cookie-read-through.d.ts +18 -0
- package/dist/shared/cookie-read-through.d.ts.map +1 -0
- package/dist/shared/key-headers.d.ts +13 -0
- package/dist/shared/key-headers.d.ts.map +1 -0
- package/dist/shared/outlet-decision.d.ts +16 -28
- package/dist/shared/outlet-decision.d.ts.map +1 -1
- package/dist/shared/payload-root.d.ts +1 -1
- package/dist/shared/route-options-export.d.ts +13 -0
- package/dist/shared/route-options-export.d.ts.map +1 -0
- package/dist/shared/rsc-cache-key.d.ts +22 -0
- package/dist/shared/rsc-cache-key.d.ts.map +1 -1
- package/dist/shared/segment-info.d.ts +7 -5
- package/dist/shared/segment-info.d.ts.map +1 -1
- package/dist/shims/headers.d.ts.map +1 -1
- package/docs/api/30-api-server.mdx +29 -0
- package/docs/api/32-api-cache.mdx +10 -4
- package/docs/api/34-api-config.mdx +5 -0
- package/docs/learn/09-streaming.mdx +6 -2
- package/docs/learn/10-caching.mdx +10 -4
- package/package.json +1 -1
- package/src/cli-check.ts +11 -3
- package/src/client/browser-entry/index.ts +0 -2
- package/src/client/browser-entry/router-init.ts +2 -4
- package/src/client/error-boundary.tsx +1 -1
- package/src/client/navigation-commit.ts +9 -14
- package/src/client/outlet-content-cache.ts +36 -42
- package/src/client/outlet-scope-context.ts +5 -5
- package/src/client/params-context.ts +1 -1
- package/src/client/router-types.ts +3 -14
- package/src/client/router.ts +1 -2
- package/src/client/rsc-fetch.ts +1 -1
- package/src/client/segment-cache.ts +2 -2
- package/src/client/segment-outlet.tsx +19 -45
- package/src/client/stale-segment.ts +2 -2
- package/src/config-types.ts +23 -15
- package/src/config-validation.ts +17 -1
- package/src/cookies/define-cookie.ts +5 -1
- package/src/index.ts +2 -1
- package/src/plugins/callsite-jsx.ts +104 -6
- package/src/plugins/entries.ts +3 -1
- package/src/plugins/prerender-sugar.ts +34 -18
- package/src/plugins/routing.ts +3 -1
- package/src/routing/convention-lint.ts +18 -7
- package/src/routing/export-detect.ts +14 -117
- package/src/routing/route-options-lint.ts +153 -0
- package/src/routing/route-options.ts +439 -0
- package/src/routing/scanner.ts +1 -1
- package/src/routing/segment-keys.ts +53 -4
- package/src/rsc-runtime/vendor-types.d.ts +5 -1
- package/src/search-params/define.ts +1 -1
- package/src/server/als-registry.ts +25 -17
- package/src/server/client-state-tree.ts +30 -27
- package/src/server/cookie-context.ts +17 -0
- package/src/server/flight-source-node.ts +1 -5
- package/src/server/flight-source.ts +8 -82
- package/src/server/framework-stack-frames.ts +41 -0
- package/src/server/index.ts +7 -0
- package/src/server/prebuilt/capture-routes.ts +1 -1
- package/src/server/prebuilt-builder.ts +30 -2
- package/src/server/request-context.ts +31 -6
- package/src/server/route-element-builder.ts +92 -18
- package/src/server/route-module-loader.ts +43 -10
- package/src/server/rsc-cache-key-guard.ts +17 -2
- package/src/server/rsc-entry/helpers.ts +1 -1
- package/src/server/rsc-entry/index.ts +16 -3
- package/src/server/rsc-entry/render-route.ts +22 -51
- package/src/server/rsc-entry/revalidate-renderer.ts +16 -2
- package/src/server/rsc-entry/rsc-stream.ts +3 -23
- package/src/server/segment-lifetime/document-outlet.ts +98 -0
- package/src/server/segment-lifetime/key-digest.ts +139 -0
- package/src/server/segment-lifetime/outlet-gate.ts +102 -0
- package/src/server/segment-lifetime/read-rule.ts +193 -0
- package/src/server/segment-lifetime/read-scope.ts +101 -0
- package/src/server/segment-lifetime/segment-key.ts +168 -0
- package/src/server/segment-lifetime/slot-outlets.ts +180 -0
- package/src/server/slot-resolver.ts +103 -60
- package/src/server/slot-subtree-contain.ts +35 -182
- package/src/server/subtree-walk.ts +316 -0
- package/src/server/types.ts +91 -0
- package/src/server/vite-handoff-rsc.ts +1 -12
- package/src/shared/als-slots.ts +19 -8
- package/src/shared/cookie-read-through.ts +18 -0
- package/src/shared/key-headers.ts +42 -0
- package/src/shared/outlet-decision.ts +16 -30
- package/src/shared/payload-root.ts +1 -1
- package/src/shared/route-options-export.ts +14 -0
- package/src/shared/rsc-cache-key.ts +41 -2
- package/src/shared/segment-info.ts +7 -5
- package/src/shims/headers.ts +5 -4
- package/dist/_chunks/actions-DIgnvDrG.js.map +0 -1
- package/dist/_chunks/als-slots-kbQrHTzm.js.map +0 -1
- package/dist/_chunks/chains-CSslTUdI.js +0 -1
- package/dist/_chunks/cli-check-C3QOAru7.js.map +0 -1
- package/dist/_chunks/convention-lint-BoVISNS6.js.map +0 -1
- package/dist/_chunks/dev-server-B8roKA3Q.js +0 -1
- package/dist/_chunks/dev-server-C5R6jx8Q.js.map +0 -1
- package/dist/_chunks/dist-C1Rjlo6s.js.map +0 -1
- package/dist/_chunks/error-boundary-DB51f9ih.js.map +0 -1
- package/dist/_chunks/flight-source-node-D9cHBhjP.js.map +0 -1
- package/dist/_chunks/scanner-C9Lrf77z.js.map +0 -1
- package/dist/native/rsc/server/segment-hash/capture.js +0 -107
- package/dist/native/rsc/server/segment-hash/capture.js.map +0 -1
- package/dist/native/rsc/server/segment-hash/outlet.js +0 -81
- package/dist/native/rsc/server/segment-hash/outlet.js.map +0 -1
- package/dist/native/rsc/server/segment-hash/stream-tap.js +0 -139
- package/dist/native/rsc/server/segment-hash/stream-tap.js.map +0 -1
- package/dist/native/rsc/server/segment-hash/value-hash.js +0 -171
- package/dist/native/rsc/server/segment-hash/value-hash.js.map +0 -1
- package/dist/native/ssr/server/segment-hash/value-hash.js +0 -162
- package/dist/native/ssr/server/segment-hash/value-hash.js.map +0 -1
- package/dist/server/segment-hash/capture.d.ts +0 -77
- package/dist/server/segment-hash/capture.d.ts.map +0 -1
- package/dist/server/segment-hash/outlet.d.ts +0 -65
- package/dist/server/segment-hash/outlet.d.ts.map +0 -1
- package/dist/server/segment-hash/stream-tap.d.ts +0 -49
- package/dist/server/segment-hash/stream-tap.d.ts.map +0 -1
- package/dist/server/segment-hash/value-hash.d.ts +0 -70
- package/dist/server/segment-hash/value-hash.d.ts.map +0 -1
- package/src/server/segment-hash/capture.ts +0 -232
- package/src/server/segment-hash/outlet.ts +0 -185
- package/src/server/segment-hash/stream-tap.ts +0 -244
- package/src/server/segment-hash/value-hash.ts +0 -338
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"segment-key.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/segment-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAInG,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/D,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,UAAU,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1C,UAAU,EAAE,eAAe,GAC1B,eAAe,CAEjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,gBAAgB,EACtB,eAAe,EAAE,eAAe,GAC/B,gBAAgB,GAAG,SAAS,CAW9B;AAkBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,aAAa,GACpB,MAAM,CAuBR"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Outlets for `'document'` segments inside a parallel slot.
|
|
3
|
+
*
|
|
4
|
+
* A slot is one outlet (`<owner>/@<slot>`); the layouts and page on its
|
|
5
|
+
* matched chain render inside it with no outlets of their own. A `'document'`
|
|
6
|
+
* segment needs one, so it can be skipped while the rest of the slot is
|
|
7
|
+
* decided independently (design/53-segment-lifetime.md §"Slots"):
|
|
8
|
+
*
|
|
9
|
+
* - a `'document'` **page** gets `pageOutletKey(<tree path>)`;
|
|
10
|
+
* - a `'document'` **layout** gets `layoutOutletKey(<tree path>)`, and
|
|
11
|
+
* what it receives as `children` becomes that key's `children` outlet —
|
|
12
|
+
* the same split as a main-chain layout, so skipping the layout's chrome
|
|
13
|
+
* never freezes what renders under it.
|
|
14
|
+
*
|
|
15
|
+
* A segment's identity is its tree path, which includes the `@slot`
|
|
16
|
+
* directory, so two slots never share an entry, and a slot rendering its
|
|
17
|
+
* `default.tsx` (which takes no options) has no `'document'` outlet at all.
|
|
18
|
+
*
|
|
19
|
+
* The outlets are created whether or not the render can issue digests, so a
|
|
20
|
+
* route's element structure is the same on every request.
|
|
21
|
+
*/
|
|
22
|
+
import type { ReactElement } from 'react';
|
|
23
|
+
import type { CoercedParams } from '../../shared/param-value.ts';
|
|
24
|
+
import type { ManifestSegmentNode } from '../route-matcher.ts';
|
|
25
|
+
import { type OutletSpec, type SegmentRender } from './outlet-gate.ts';
|
|
26
|
+
import { type DocumentLifetime } from './segment-key.ts';
|
|
27
|
+
import type { ServerComponent } from '../subtree-walk.ts';
|
|
28
|
+
/** Everything a slot's `'document'` outlets need from the slot being resolved. */
|
|
29
|
+
export interface SlotDocumentContext {
|
|
30
|
+
render: SegmentRender;
|
|
31
|
+
/** The slot's matched chain, slot root first. */
|
|
32
|
+
chain: readonly ManifestSegmentNode[];
|
|
33
|
+
/** The tree path of the segment that owns the slot. */
|
|
34
|
+
parentTreePath: string;
|
|
35
|
+
/** Param names on the path above the slot, outermost first. */
|
|
36
|
+
ownerParams: readonly string[];
|
|
37
|
+
/** The main-chain segments from the root down to the slot's owner. */
|
|
38
|
+
ownerChain: readonly ManifestSegmentNode[];
|
|
39
|
+
/**
|
|
40
|
+
* The main route's coerced params with the slot's own over them. Read only
|
|
41
|
+
* when a 'document' segment is decided.
|
|
42
|
+
*/
|
|
43
|
+
params: () => CoercedParams;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Builds a slot's `'document'` outlets from the leaf outward, and reports the
|
|
47
|
+
* outermost of them: the slot's own outlet holds those directly, and a skip
|
|
48
|
+
* of it must carry their decisions.
|
|
49
|
+
*/
|
|
50
|
+
export declare class SlotDocumentOutlets {
|
|
51
|
+
private readonly ctx;
|
|
52
|
+
private unclaimed;
|
|
53
|
+
constructor(ctx: SlotDocumentContext);
|
|
54
|
+
/** The outlets built so far that no outlet built so far contains. */
|
|
55
|
+
outermost(): OutletSpec[];
|
|
56
|
+
/**
|
|
57
|
+
* A slot segment's lifetime: its own declaration, else the app's
|
|
58
|
+
* `defaultLayoutLifetime` for a layout (`defaultLayoutLifetimeAt`) and
|
|
59
|
+
* `'request'` for a page.
|
|
60
|
+
*/
|
|
61
|
+
lifetimeOf(node: ManifestSegmentNode, mod: Record<string, unknown>, kind: 'page' | 'layout'): DocumentLifetime | undefined;
|
|
62
|
+
/** Wrap a `'document'` slot page in its own outlet. */
|
|
63
|
+
page(node: ManifestSegmentNode, lifetime: DocumentLifetime, element: ReactElement): Promise<ReactElement>;
|
|
64
|
+
/**
|
|
65
|
+
* Wrap a `'document'` slot layout: its `children` in one outlet and the
|
|
66
|
+
* layout built around that outlet in another.
|
|
67
|
+
*/
|
|
68
|
+
layout(node: ManifestSegmentNode, lifetime: DocumentLifetime, children: ReactElement, buildLayout: (children: ReactElement) => ReactElement): Promise<ReactElement>;
|
|
69
|
+
/**
|
|
70
|
+
* A 'document' slot segment's component, run in its read scope
|
|
71
|
+
* (`read-scope.ts`): a read outside its key throws.
|
|
72
|
+
*/
|
|
73
|
+
scoped(node: ManifestSegmentNode, kind: 'page' | 'layout', lifetime: DocumentLifetime, component: ServerComponent): ServerComponent;
|
|
74
|
+
private decision;
|
|
75
|
+
/** Every param on the node's path: the owner's, then the slot chain's down to it. */
|
|
76
|
+
private pathParams;
|
|
77
|
+
/** The node's full tree path: the owner's, then each chain directory down to it. */
|
|
78
|
+
private treePath;
|
|
79
|
+
private depth;
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=slot-outlets.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"slot-outlets.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/slot-outlets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,iDAAiD;IACjD,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,sEAAsE;IACtE,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC3C;;;OAGG;IACH,MAAM,EAAE,MAAM,aAAa,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,SAAS,CAAoB;IAErC,YAA6B,GAAG,EAAE,mBAAmB,EAAI;IAEzD,qEAAqE;IACrE,SAAS,IAAI,UAAU,EAAE,CAExB;IAED;;;;OAIG;IACH,UAAU,CACR,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GACtB,gBAAgB,GAAG,SAAS,CAK9B;IAED,uDAAuD;IACjD,IAAI,CACR,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,CAAC,CAUvB;IAED;;;OAGG;IACG,MAAM,CACV,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,GACpD,OAAO,CAAC,YAAY,CAAC,CAevB;IAED;;;OAGG;IACH,MAAM,CACJ,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,EACvB,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,eAAe,GACzB,eAAe,CAIjB;IAED,OAAO,CAAC,QAAQ;IAUhB,qFAAqF;IACrF,OAAO,CAAC,UAAU;IAOlB,oFAAoF;IACpF,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,KAAK;CAKd"}
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
*/
|
|
18
18
|
import type { InterceptionContext, RouteMatch } from './pipeline.ts';
|
|
19
19
|
import type { ManifestSegmentNode } from './route-matcher.ts';
|
|
20
|
-
import { type OutletSpec, type
|
|
20
|
+
import { type OutletSpec, type SegmentRender } from './segment-lifetime/outlet-gate.ts';
|
|
21
21
|
type CreateElementFn = (...args: unknown[]) => React.ReactElement;
|
|
22
22
|
/**
|
|
23
23
|
* Resolve the element for a parallel slot.
|
|
@@ -32,7 +32,12 @@ type CreateElementFn = (...args: unknown[]) => React.ReactElement;
|
|
|
32
32
|
* 3. SlotAccessGate if the segment has access.ts (gate OUTSIDE the layout,
|
|
33
33
|
* so a denied layout never executes — see TIM-1074)
|
|
34
34
|
*/
|
|
35
|
-
export declare function resolveSlotElement(slotNode: ManifestSegmentNode, match: RouteMatch, h: CreateElementFn, req: Request, interception?: InterceptionContext, parentTreePath?: string): Promise<
|
|
35
|
+
export declare function resolveSlotElement(slotNode: ManifestSegmentNode, match: RouteMatch, h: CreateElementFn, req: Request, interception?: InterceptionContext, parentTreePath?: string, render?: SegmentRender): Promise<ResolvedSlotElement>;
|
|
36
|
+
/** A slot's content, and the outlets inside it that its own outlet holds directly. */
|
|
37
|
+
export interface ResolvedSlotElement {
|
|
38
|
+
element: React.ReactElement | null;
|
|
39
|
+
outlets: OutletSpec[];
|
|
40
|
+
}
|
|
36
41
|
/** Result of matching a slot's sub-tree against the current route. */
|
|
37
42
|
export interface SlotMatchResult {
|
|
38
43
|
/** The page file at the matched leaf. */
|
|
@@ -81,7 +86,7 @@ interface ResolveSlotPropsArgs {
|
|
|
81
86
|
parentTreePath: string;
|
|
82
87
|
/** The request being rendered. */
|
|
83
88
|
req: Request;
|
|
84
|
-
render:
|
|
89
|
+
render: SegmentRender;
|
|
85
90
|
}
|
|
86
91
|
/** A layout's slot props, and the outlet of each slot. */
|
|
87
92
|
export interface ResolvedSlots {
|
|
@@ -92,8 +97,8 @@ export interface ResolvedSlots {
|
|
|
92
97
|
* Resolve all parallel route slots for a layout, each in its own outlet.
|
|
93
98
|
*
|
|
94
99
|
* Every slot is resolved and every slot's access chain runs, on every render.
|
|
95
|
-
*
|
|
96
|
-
*
|
|
100
|
+
* A slot is skipped only through the 'document' segments on its chain
|
|
101
|
+
* (design/53-segment-lifetime.md §"Slots").
|
|
97
102
|
*/
|
|
98
103
|
export declare function resolveSlotProps({ segment, segmentId, match, h, interception, parentTreePath, req, render, }: ResolveSlotPropsArgs): Promise<ResolvedSlots>;
|
|
99
104
|
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"slot-resolver.d.ts","sourceRoot":"","sources":["../../src/server/slot-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAQ9D,OAAO,
|
|
1
|
+
{"version":3,"file":"slot-resolver.d.ts","sourceRoot":"","sources":["../../src/server/slot-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAQ9D,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAC;AAO3C,KAAK,eAAe,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,CAAC,YAAY,CAAC;AAgClE;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,eAAe,EAClB,GAAG,EAAE,OAAO,EACZ,YAAY,CAAC,EAAE,mBAAmB,EAClC,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,GAAE,aAAgC,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAgM9B;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAwMD,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,+EAA+E;IAC/E,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,wGAAwG;IACxG,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,MAAM,CAQR;AA6BD,UAAU,oBAAoB;IAC5B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,CAAC,EAAE,eAAe,CAAC;IACnB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,OAAO,EACP,SAAS,EACT,KAAK,EACL,CAAC,EACD,YAAY,EACZ,cAAc,EACd,GAAG,EACH,MAAM,GACP,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwB/C"}
|
|
@@ -27,12 +27,8 @@
|
|
|
27
27
|
* still takes the slot's catch-all boundary. A thrown thenable — `use()` on a
|
|
28
28
|
* pending promise — passes through untouched so Flight can suspend the task.
|
|
29
29
|
*
|
|
30
|
-
*
|
|
31
|
-
* `
|
|
32
|
-
* (runs `_init`, then renders what it resolved to). A server component behind
|
|
33
|
-
* any of those is invoked all the same, so its deny would escape too. The walk
|
|
34
|
-
* therefore resolves an element type the way Flight would — down to the
|
|
35
|
-
* function Flight would call — and wraps that.
|
|
30
|
+
* The walk itself — memo, forwardRef and lazy unwrapping, promises, props —
|
|
31
|
+
* is `subtree-walk.ts`, shared with a 'document' segment's read scope.
|
|
36
32
|
*
|
|
37
33
|
* See design/02-rendering-pipeline.md §"Slot Access Failure = Graceful
|
|
38
34
|
* Degradation", TIM-1450.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"slot-subtree-contain.d.ts","sourceRoot":"","sources":["../../src/server/slot-subtree-contain.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"slot-subtree-contain.d.ts","sourceRoot":"","sources":["../../src/server/slot-subtree-contain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAuEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,SAAS,EACnB,MAAM,CAAC,EAAE,SAAS,GACjB,SAAS,CAEX"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Rewrite the server components in a tree a server component returned.
|
|
3
|
+
*
|
|
4
|
+
* A server component's own call runs where timber calls it, but every server
|
|
5
|
+
* component in the tree it *returns* runs later, as its own Flight task, in
|
|
6
|
+
* Flight's context rather than the caller's: a `try` around the call does not
|
|
7
|
+
* see their throws, and an AsyncLocalStorage scope around it does not reach
|
|
8
|
+
* them. The only way to give them the caller's handling is to rewrite the
|
|
9
|
+
* tree before Flight renders it: each server-component element is replaced by
|
|
10
|
+
* one a rule builds, which calls the original and rewrites its output the
|
|
11
|
+
* same way, so the handling follows the tree however deep it renders.
|
|
12
|
+
*
|
|
13
|
+
* Two rules use it: slot deny containment (`slot-subtree-contain.ts`) and
|
|
14
|
+
* the read scope of a 'document' segment (`segment-lifetime/read-scope.ts`).
|
|
15
|
+
*
|
|
16
|
+
* Flight's `renderElement` does not only invoke plain functions: it unwraps
|
|
17
|
+
* `memo` (renders `.type`), `forwardRef` (calls `.render`), and `lazy` (runs
|
|
18
|
+
* `_init`, then renders what it resolved to). A server component behind any of
|
|
19
|
+
* those is invoked all the same, so the walk resolves an element type the way
|
|
20
|
+
* Flight would — down to the function Flight would call.
|
|
21
|
+
*/
|
|
22
|
+
import { type ReactElement, type ReactNode } from 'react';
|
|
23
|
+
export type ServerComponent = (props: Record<string, unknown>) => unknown;
|
|
24
|
+
interface Thenable<T> {
|
|
25
|
+
then(onFulfilled: (value: T) => unknown, onRejected?: (reason: unknown) => unknown): unknown;
|
|
26
|
+
}
|
|
27
|
+
/** What one walk carries: the fallback to substitute, and the one subtree it must not enter. */
|
|
28
|
+
export declare function isThenable(value: unknown): value is Thenable<unknown>;
|
|
29
|
+
/** How one use of the walk treats what it finds. */
|
|
30
|
+
export interface SubtreeRule {
|
|
31
|
+
/**
|
|
32
|
+
* The element to render in place of a server-component element, or
|
|
33
|
+
* undefined to keep the element and rewrite its props (a rule's own wrapper
|
|
34
|
+
* returns undefined, so a rewritten tree is not wrapped twice).
|
|
35
|
+
*/
|
|
36
|
+
wrap(component: ServerComponent, props: Record<string, unknown>, key: string | null): ReactElement | undefined;
|
|
37
|
+
/** A node to leave untouched, and not descend into. */
|
|
38
|
+
isOpaque(node: unknown): boolean;
|
|
39
|
+
/** Handles a rejection of a promise rendered as a child; rethrows by default. */
|
|
40
|
+
onRejected?: (reason: unknown) => unknown;
|
|
41
|
+
/**
|
|
42
|
+
* Runs work the walk defers past the component's return — advancing an
|
|
43
|
+
* async iterable it returned — in the rule's context. Default: as is.
|
|
44
|
+
*/
|
|
45
|
+
runIn?: <T>(fn: () => T) => T;
|
|
46
|
+
}
|
|
47
|
+
/** Rewrite every server component in `tree` by `rule`. */
|
|
48
|
+
export declare function rewriteSubtree(tree: unknown, rule: SubtreeRule): unknown;
|
|
49
|
+
/**
|
|
50
|
+
* Call a server component and rewrite what it returns by `rule` — what a
|
|
51
|
+
* rule's wrapper component does. A synchronous throw leaves synchronously, so
|
|
52
|
+
* a `use()` that suspends is retried by Flight.
|
|
53
|
+
*/
|
|
54
|
+
export declare function callAndRewrite(component: ServerComponent, props: Record<string, unknown>, rule: SubtreeRule): ReactNode | Promise<ReactNode>;
|
|
55
|
+
export {};
|
|
56
|
+
//# sourceMappingURL=subtree-walk.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subtree-walk.d.ts","sourceRoot":"","sources":["../../src/server/subtree-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAmC,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAS3F,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAE1E,UAAU,QAAQ,CAAC,CAAC;IAClB,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC;CAC9F;AAED,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,CAMrE;AAiFD,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CACF,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,YAAY,GAAG,SAAS,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,iFAAiF;IACjF,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;CAC/B;AAmJD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAExE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,WAAW,GAChB,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAQhC"}
|
package/dist/server/types.d.ts
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import type { CoercedParams } from '../shared/param-value.ts';
|
|
2
2
|
import type { EarlyHint } from './early-hints.ts';
|
|
3
|
+
import type { SearchParamsDefinition } from '../search-params/define.ts';
|
|
4
|
+
import type { ServerOnlyCookieDefinition } from '../cookies/define-cookie.ts';
|
|
3
5
|
/**
|
|
4
6
|
* A value that is safe to pass through `JSON.stringify` without data loss.
|
|
5
7
|
*
|
|
@@ -62,6 +64,79 @@ export interface RouteContext {
|
|
|
62
64
|
}
|
|
63
65
|
export interface AccessContext {
|
|
64
66
|
}
|
|
67
|
+
/**
|
|
68
|
+
* Prerender a page at build time. `true` is pure build time; an object adds a
|
|
69
|
+
* runtime lifetime (ISR) and implies `prerender: true`. Desugars to wrapping
|
|
70
|
+
* the page's default export in `cache.component(Page, { prerender: true, … })`.
|
|
71
|
+
* See design/45-cache-lifetimes.md §"Route-Level Static".
|
|
72
|
+
*/
|
|
73
|
+
export type RoutePrerender = boolean | {
|
|
74
|
+
ttl?: number;
|
|
75
|
+
tags?: readonly string[];
|
|
76
|
+
};
|
|
77
|
+
/**
|
|
78
|
+
* How long a segment's output lives. `'request'` (the default, unless the app
|
|
79
|
+
* sets `defaultLayoutLifetime` for its layouts) renders on every request. `'document'` renders on the document request and whenever its key
|
|
80
|
+
* changes or `router.refresh()` runs, and is skipped without rendering on
|
|
81
|
+
* every other client navigation. See design/53-segment-lifetime.md.
|
|
82
|
+
*/
|
|
83
|
+
export type SegmentLifetime = 'request' | 'document';
|
|
84
|
+
/**
|
|
85
|
+
* The request inputs a `'document'` segment depends on — and the only ones it
|
|
86
|
+
* may read. Params, search params and cookies are compared after parsing,
|
|
87
|
+
* through each definition's codec; headers as `Headers.get` returns them. See design/53-segment-lifetime.md §"Segment keys".
|
|
88
|
+
*/
|
|
89
|
+
export interface SegmentKey {
|
|
90
|
+
/**
|
|
91
|
+
* Param names on the segment's path. Default: every param on the path.
|
|
92
|
+
* A name that is not on the path fails the build.
|
|
93
|
+
*/
|
|
94
|
+
segmentParams?: readonly string[];
|
|
95
|
+
/** A search-params definition, often a `.pick()`. Default: none. */
|
|
96
|
+
searchParams?: SearchParamsDefinition<Record<string, unknown>>;
|
|
97
|
+
/** Cookie definitions (`defineCookie`). Default: none. */
|
|
98
|
+
cookies?: readonly ServerOnlyCookieDefinition<unknown>[];
|
|
99
|
+
/**
|
|
100
|
+
* Request header names, matched case-insensitively; values compared as
|
|
101
|
+
* `Headers.get` returns them (trimmed, repeats joined). Default: none. `cookie` (use `cookies`) and credential headers
|
|
102
|
+
* (`authorization`, `proxy-authorization`, `x-api-key`) fail the build.
|
|
103
|
+
*/
|
|
104
|
+
headers?: readonly string[];
|
|
105
|
+
}
|
|
106
|
+
/** Options for a `page.tsx`: `export const pageOptions = { … } satisfies PageOptions`. */
|
|
107
|
+
export interface PageOptions {
|
|
108
|
+
/** See `SegmentLifetime`. Default `'request'`. */
|
|
109
|
+
lifetime?: SegmentLifetime;
|
|
110
|
+
/** What a `'document'` page depends on. Only with `lifetime: 'document'`. */
|
|
111
|
+
key?: SegmentKey;
|
|
112
|
+
/** Overrides any ancestor layout's `prerender`. `false` opts out. */
|
|
113
|
+
prerender?: RoutePrerender;
|
|
114
|
+
/**
|
|
115
|
+
* Hold the SSR stream up to this many milliseconds so fast Suspense
|
|
116
|
+
* boundaries resolve inline. The route uses the maximum across its layouts
|
|
117
|
+
* and page. See design/05-streaming.md §"deferSuspenseFor".
|
|
118
|
+
*/
|
|
119
|
+
deferSuspenseFor?: number;
|
|
120
|
+
}
|
|
121
|
+
/** Options for a `layout.tsx`: `export const layoutOptions = { … } satisfies LayoutOptions`. */
|
|
122
|
+
export interface LayoutOptions {
|
|
123
|
+
/** See `SegmentLifetime`. Default: the app's `defaultLayoutLifetime` (`'request'` unless set). */
|
|
124
|
+
lifetime?: SegmentLifetime;
|
|
125
|
+
/**
|
|
126
|
+
* What a `'document'` layout depends on. Only on a `'document'` layout: one
|
|
127
|
+
* that declares `lifetime: 'document'`, or declares no lifetime under a
|
|
128
|
+
* `'document'` `defaultLayoutLifetime`.
|
|
129
|
+
*/
|
|
130
|
+
key?: SegmentKey;
|
|
131
|
+
/**
|
|
132
|
+
* Propagates to descendant pages that do not declare their own
|
|
133
|
+
* (most-specific wins). The layout itself is never cached: it renders with
|
|
134
|
+
* its real children. See design/45-cache-lifetimes.md §"Layout Propagation".
|
|
135
|
+
*/
|
|
136
|
+
prerender?: RoutePrerender;
|
|
137
|
+
/** See `PageOptions.deferSuspenseFor`. */
|
|
138
|
+
deferSuspenseFor?: number;
|
|
139
|
+
}
|
|
65
140
|
export interface Metadata {
|
|
66
141
|
title?: string | {
|
|
67
142
|
default?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -36,22 +36,13 @@ import type { DenyLastResort } from '../client/deny-last-resort.tsx';
|
|
|
36
36
|
* decoder; the runtime only ever passes a stream and inspects the result, and
|
|
37
37
|
* the narrower type is what a test double can satisfy.
|
|
38
38
|
*/
|
|
39
|
-
/**
|
|
40
|
-
* The decode half of Flight's temporary references: each `$T<id>` in the
|
|
41
|
-
* stream is replaced by `get('$' + id)`. React's client reads only `get`.
|
|
42
|
-
*/
|
|
43
|
-
export interface TemporaryReferenceLookup {
|
|
44
|
-
get(key: string): unknown;
|
|
45
|
-
}
|
|
46
39
|
export interface RscFlightRuntime {
|
|
47
40
|
renderFlight: typeof FlightAdapter.renderFlight;
|
|
48
41
|
loadServerAction: typeof FlightAdapter.loadServerAction;
|
|
49
42
|
decodeReply: typeof FlightAdapter.decodeReply;
|
|
50
43
|
decodeAction: typeof FlightAdapter.decodeAction;
|
|
51
44
|
decodeFormState: typeof FlightAdapter.decodeFormState;
|
|
52
|
-
createFromReadableStream: (stream: ReadableStream<Uint8Array
|
|
53
|
-
temporaryReferences?: TemporaryReferenceLookup;
|
|
54
|
-
}) => Promise<unknown>;
|
|
45
|
+
createFromReadableStream: (stream: ReadableStream<Uint8Array>) => Promise<unknown>;
|
|
55
46
|
}
|
|
56
47
|
/**
|
|
57
48
|
* timber's own `'use client'` components that server code renders. In the RSC
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vite-handoff-rsc.d.ts","sourceRoot":"","sources":["../../src/server/vite-handoff-rsc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,aAAa,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,iBAAiB,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE;;;;;GAKG;AACH
|
|
1
|
+
{"version":3,"file":"vite-handoff-rsc.d.ts","sourceRoot":"","sources":["../../src/server/vite-handoff-rsc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,aAAa,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,iBAAiB,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,aAAa,CAAC,YAAY,CAAC;IAChD,gBAAgB,EAAE,OAAO,aAAa,CAAC,gBAAgB,CAAC;IACxD,WAAW,EAAE,OAAO,aAAa,CAAC,WAAW,CAAC;IAC9C,YAAY,EAAE,OAAO,aAAa,CAAC,YAAY,CAAC;IAChD,eAAe,EAAE,OAAO,aAAa,CAAC,eAAe,CAAC;IACtD,wBAAwB,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,cAAc,EAAE,OAAO,cAAc,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClC,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,gBAAgB,EAAE,mBAAmB,CAAC;CACvC;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,IAAI,CAUjF;AAsBD,kDAAkD;AAClD,wBAAgB,gBAAgB,IAAI,mBAAmB,CAEtD;AAMD,eAAO,MAAM,YAAY,EAAE,gBAAgB,CAAC,cAAc,CACvB,CAAC;AACpC,eAAO,MAAM,gBAAgB,EAAE,gBAAgB,CAAC,kBAAkB,CAC3B,CAAC;AACxC,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,aAAa,CACtB,CAAC;AACnC,eAAO,MAAM,YAAY,EAAE,gBAAgB,CAAC,cAAc,CACvB,CAAC;AACpC,eAAO,MAAM,eAAe,EAAE,gBAAgB,CAAC,iBAAiB,CAC1B,CAAC;AACvC,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,CAAC,0BAA0B,CACnC,CAAC;AAChD,eAAO,MAAM,OAAO,EAAE,OAAO,OAA+C,CAAC"}
|
|
@@ -31,10 +31,20 @@
|
|
|
31
31
|
* design/41-global-params.md.
|
|
32
32
|
*/
|
|
33
33
|
import type { CoercedParams } from './param-value.ts';
|
|
34
|
+
/**
|
|
35
|
+
* What a search-params definition reads: its fields, each with its codec and
|
|
36
|
+
* URL key. A 'document' segment's read rule checks it against the key's
|
|
37
|
+
* definition (design/53): the same field name under another codec or alias
|
|
38
|
+
* is another input.
|
|
39
|
+
*/
|
|
40
|
+
export interface SearchParamsReader {
|
|
41
|
+
codecs: Readonly<Record<string, unknown>>;
|
|
42
|
+
urlKeys: Readonly<Record<string, string>>;
|
|
43
|
+
}
|
|
34
44
|
/** @internal Called from `server/request-context.ts` at module init. */
|
|
35
|
-
export declare const _setGetSearchParamsFn: (fn: () => URLSearchParams) => void;
|
|
45
|
+
export declare const _setGetSearchParamsFn: (fn: (reader?: SearchParamsReader | undefined) => URLSearchParams) => void;
|
|
36
46
|
/** @internal Read by `search-params/define.ts` inside `.get()`. */
|
|
37
|
-
export declare const getSearchParamsFromAls: () => URLSearchParams;
|
|
47
|
+
export declare const getSearchParamsFromAls: (reader?: SearchParamsReader | undefined) => URLSearchParams;
|
|
38
48
|
/** @internal Called from `server/request-context.ts` at module init. */
|
|
39
49
|
export declare const _setGetSegmentParamsFn: (fn: () => CoercedParams) => void;
|
|
40
50
|
/** @internal Read by `segment-params/define.ts` inside `.get()`. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"als-slots.d.ts","sourceRoot":"","sources":["../../src/shared/als-slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"als-slots.d.ts","sourceRoot":"","sources":["../../src/shared/als-slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAsBtD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAYD,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,wEAxCJ,IAwC2B,CAAC;AAC1D,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,8DAAuB,CAAC;AAE3D,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,+BA7CL,IA6C6B,CAAC;AAC5D,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,qBAAwB,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* How a typed cookie definition reads its raw value on the server: through
|
|
3
|
+
* the cookie jar, naming the codec it parses with.
|
|
4
|
+
*
|
|
5
|
+
* A `'document'` segment's key holds a cookie's *parsed* value
|
|
6
|
+
* (design/53-segment-lifetime.md §"Segment keys"), so the read rule allows a
|
|
7
|
+
* keyed cookie only when it is read through the key's own definition. A raw
|
|
8
|
+
* read sees differences the codec hides: `theme=purple` and `theme=light` key
|
|
9
|
+
* the same, but a raw read shows them apart, so it would freeze. The jar's
|
|
10
|
+
* public `get()` is that raw read; `defineCookie().get()` uses this method.
|
|
11
|
+
*
|
|
12
|
+
* A symbol, so it is not part of the jar's public surface. Isomorphic: no
|
|
13
|
+
* server or client imports (cookies/define-cookie.ts runs in both).
|
|
14
|
+
*/
|
|
15
|
+
export declare const COOKIE_READ_THROUGH: unique symbol;
|
|
16
|
+
/** Read a cookie's raw value for a definition that parses it with `codec`. */
|
|
17
|
+
export type CookieReadThrough = (name: string, codec: unknown) => string | undefined;
|
|
18
|
+
//# sourceMappingURL=cookie-read-through.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cookie-read-through.d.ts","sourceRoot":"","sources":["../../src/shared/cookie-read-through.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,eAA2C,CAAC;AAE5E,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Which request headers a `'document'` segment's key may name
|
|
3
|
+
* (design/53-segment-lifetime.md §"Segment keys"). One rule for the build
|
|
4
|
+
* (`routing/route-options.ts`), which reports it from source, and for the
|
|
5
|
+
* runtime (`server/segment-lifetime/segment-key.ts`), which refuses it too —
|
|
6
|
+
* the build cannot read every file kind (MDX pages are not linted), and a
|
|
7
|
+
* credential must not become keyable by skipping the lint.
|
|
8
|
+
*/
|
|
9
|
+
/** Why a key may not name `name`, or undefined when it may. */
|
|
10
|
+
export declare function headerKeyProblem(name: string): string | undefined;
|
|
11
|
+
/** Whether a key may never name `name` (case-insensitive): a cookie or credential header. */
|
|
12
|
+
export declare function isUnkeyableHeader(name: string): boolean;
|
|
13
|
+
//# sourceMappingURL=key-headers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"key-headers.d.ts","sourceRoot":"","sources":["../../src/shared/key-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}
|
|
@@ -1,48 +1,36 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* What the server decided for one `SegmentOutlet` — the wire contract
|
|
3
|
-
* between the outlet gate (server/segment-
|
|
4
|
-
* outlet (client/segment-outlet.tsx).
|
|
3
|
+
* between the outlet gate (server/segment-lifetime/outlet-gate.ts) and the
|
|
4
|
+
* client outlet (client/segment-outlet.tsx).
|
|
5
5
|
*
|
|
6
6
|
* A segment is either sent or skipped:
|
|
7
7
|
*
|
|
8
|
-
* - **Live** — `children` is the segment's content. `
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
* the
|
|
13
|
-
*
|
|
14
|
-
* server just produced identical output. `outlets` carries the decisions
|
|
8
|
+
* - **Live** — `children` is the segment's content. A `'document'` segment
|
|
9
|
+
* (design/53-segment-lifetime.md) also carries `digest`: the key digest it
|
|
10
|
+
* rendered under.
|
|
11
|
+
* - **Skip** — only a `'document'` segment: the client holds content rendered
|
|
12
|
+
* under this `digest` and the request's key values still match it, so the
|
|
13
|
+
* server did not render the segment at all. `outlets` carries the decisions
|
|
15
14
|
* for the segments nested directly inside it, because the client renders
|
|
16
15
|
* its cached copy of this segment and that copy still holds the old ones.
|
|
17
16
|
*
|
|
18
|
-
*
|
|
19
|
-
* render the segment once before deciding, and as a plain value otherwise.
|
|
20
|
-
*
|
|
21
|
-
* See design/52-segment-hash-dedupe.md §"Wire format".
|
|
17
|
+
* See design/53-segment-lifetime.md §"Skipping".
|
|
22
18
|
*/
|
|
23
19
|
import type { ReactNode } from 'react';
|
|
24
|
-
export type OutletDecision = LiveDecision |
|
|
20
|
+
export type OutletDecision = LiveDecision | DocumentSkip;
|
|
25
21
|
export interface LiveDecision {
|
|
26
22
|
skip?: undefined;
|
|
27
|
-
|
|
23
|
+
/** The key digest of a `'document'` segment's content. */
|
|
24
|
+
digest?: string;
|
|
28
25
|
children: ReactNode;
|
|
29
26
|
}
|
|
30
|
-
|
|
27
|
+
/** A `'document'` segment whose key is unchanged: never rendered. */
|
|
28
|
+
export interface DocumentSkip {
|
|
31
29
|
skip: true;
|
|
32
|
-
|
|
30
|
+
digest: string;
|
|
33
31
|
/** The decisions of the segments nested directly inside, by segment path. */
|
|
34
|
-
outlets: Record<string,
|
|
35
|
-
}
|
|
36
|
-
/**
|
|
37
|
-
* What a nested outlet carries inside a segment-hash capture, in place of a
|
|
38
|
-
* decision: an opaque marker Flight writes as a temporary reference and the
|
|
39
|
-
* capture's decoder replaces with the real decision. Never reaches a client.
|
|
40
|
-
*/
|
|
41
|
-
export interface CaptureHole {
|
|
42
|
-
readonly captureHole: true;
|
|
32
|
+
outlets: Record<string, OutletDecision>;
|
|
43
33
|
}
|
|
44
|
-
/** A decision as an outlet receives it. */
|
|
45
|
-
export type OutletDecisionValue = OutletDecision | PromiseLike<OutletDecision>;
|
|
46
34
|
/** The `segmentPath` of the metadata outlet — one per payload. */
|
|
47
35
|
export declare const METADATA_OUTLET_PATH = "#metadata";
|
|
48
36
|
//# sourceMappingURL=outlet-decision.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"outlet-decision.d.ts","sourceRoot":"","sources":["../../src/shared/outlet-decision.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"outlet-decision.d.ts","sourceRoot":"","sources":["../../src/shared/outlet-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,YAAY,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,cAAc,CAAC"}
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
*
|
|
12
12
|
* 1. **A provider inside the payload cannot reach a skipped segment.** A
|
|
13
13
|
* segment the server skipped renders the content the client cached for it
|
|
14
|
-
* (design/
|
|
14
|
+
* (design/53-segment-lifetime.md), and that copy carries whatever was
|
|
15
15
|
* inside it when it was committed — never the incoming route's provider.
|
|
16
16
|
* Params belong to the *navigation*, so the provider has to be owned by the
|
|
17
17
|
* client, above the payload root, and there must be exactly one.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The export a layout or page declares its options under (design/53
|
|
3
|
+
* §"Route-module options"). One table for both readers: the build-time source
|
|
4
|
+
* reader (`routing/route-options.ts`) and the runtime module loader
|
|
5
|
+
* (`server/route-module-loader.ts`), which cannot import the source reader
|
|
6
|
+
* because it pulls in `node:fs` and Vite's parser.
|
|
7
|
+
*/
|
|
8
|
+
export type RouteOptionsKind = 'layout' | 'page';
|
|
9
|
+
export declare const ROUTE_OPTIONS_EXPORT: {
|
|
10
|
+
readonly layout: 'layoutOptions';
|
|
11
|
+
readonly page: 'pageOptions';
|
|
12
|
+
};
|
|
13
|
+
//# sourceMappingURL=route-options-export.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"route-options-export.d.ts","sourceRoot":"","sources":["../../src/shared/route-options-export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,eAAO,MAAM,oBAAoB;qBACvB,eAAe;mBACjB,aAAa;CACgC,CAAC"}
|
|
@@ -147,6 +147,28 @@ export type HeaderLookup = (name: string) => string | null | undefined;
|
|
|
147
147
|
* caching story to protect in the first place.
|
|
148
148
|
*/
|
|
149
149
|
export declare function rscCacheKey(lookup: HeaderLookup): Promise<string | null>;
|
|
150
|
+
/**
|
|
151
|
+
* The part of an `X-Timber-State-Tree` value that enters the key: everything
|
|
152
|
+
* but `documents`.
|
|
153
|
+
*
|
|
154
|
+
* `documents` carries the key digests of `'document'` segments, and a digest
|
|
155
|
+
* is derived from cookie values (design/53-segment-lifetime.md §"The key
|
|
156
|
+
* digest"). It is keyed and per render, so nothing can be read from it — but
|
|
157
|
+
* a URL is logged by proxies, CDNs and analytics, and a value derived from a
|
|
158
|
+
* cookie does not belong in one. The response still varies on it, so a
|
|
159
|
+
* request that carries `documents` is made unstorable by shared caches
|
|
160
|
+
* instead (`server/rsc-cache-key-guard.ts`).
|
|
161
|
+
*
|
|
162
|
+
* A value that is not a JSON object enters the key unchanged: it is not a
|
|
163
|
+
* state tree a client sent, and dropping it would let two different headers
|
|
164
|
+
* share a key.
|
|
165
|
+
*/
|
|
166
|
+
export declare function stateTreeKeyValue(value: string): string;
|
|
167
|
+
/**
|
|
168
|
+
* Whether an `X-Timber-State-Tree` value carries `'document'` key digests —
|
|
169
|
+
* a request whose response varies on an input `rscCacheKey` leaves out.
|
|
170
|
+
*/
|
|
171
|
+
export declare function stateTreeHasDocuments(value: string | null): boolean;
|
|
150
172
|
/**
|
|
151
173
|
* An unverifiable stand-in key, for the one case where the digest cannot be
|
|
152
174
|
* computed: `crypto.subtle` is absent in non-secure browsing contexts.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rsc-cache-key.d.ts","sourceRoot":"","sources":["../../src/shared/rsc-cache-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgCH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,YAC1B,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,wBAAwB,CAChB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAoBpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,eAAe,CAAC;IACxB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,gBAAgB,CAG3D;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"rsc-cache-key.d.ts","sourceRoot":"","sources":["../../src/shared/rsc-cache-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgCH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,YAC1B,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,wBAAwB,CAChB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIzD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,SAAS,CAAC;AAoBpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,eAAe,CAAC;IACxB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,gBAAgB,CAG3D;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkB9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAM1E"}
|