@timber-js/app 0.2.0-alpha.241 → 0.2.0-alpha.243
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-BCYVyoFl.js → actions-DoTj0Jd3.js} +78 -32
- package/dist/_chunks/actions-DoTj0Jd3.js.map +1 -0
- package/dist/_chunks/{als-registry-fabsRnPY.js → als-registry-C-iwbtvI.js} +1 -2
- package/dist/_chunks/{als-registry-fabsRnPY.js.map → als-registry-C-iwbtvI.js.map} +1 -1
- package/dist/_chunks/{cache-api-n5FL4wFs.js → cache-api-D3HmgsFh.js} +5 -5
- package/dist/_chunks/{cache-api-n5FL4wFs.js.map → cache-api-D3HmgsFh.js.map} +1 -1
- package/dist/_chunks/{chains-IswOWMnq.js → chains-BpvDwp08.js} +2 -2
- package/dist/_chunks/{chains-IswOWMnq.js.map → chains-BpvDwp08.js.map} +1 -1
- package/dist/_chunks/chains-CjlZZ5ad.js +1 -0
- package/dist/_chunks/{classify-B08RCF6s.js → classify-Bbb_lKjH.js} +2 -2
- package/dist/_chunks/{classify-B08RCF6s.js.map → classify-Bbb_lKjH.js.map} +1 -1
- package/dist/_chunks/{cli-check-tpFb6pBU.js → cli-check-DlQBSKIN.js} +3 -3
- package/dist/_chunks/{cli-check-tpFb6pBU.js.map → cli-check-DlQBSKIN.js.map} +1 -1
- package/dist/_chunks/{cli-schema-sync-DRNJutey.js → cli-schema-sync-CWkGFlYu.js} +2 -2
- package/dist/_chunks/{cli-schema-sync-DRNJutey.js.map → cli-schema-sync-CWkGFlYu.js.map} +1 -1
- package/dist/_chunks/{cli-schema-sync-C0pXBtzG.js → cli-schema-sync-Dyvdkv_I.js} +1 -1
- package/dist/_chunks/{client-dep-entries-Dw5Dvatr.js → client-dep-entries-Dka67elj.js} +2 -2
- package/dist/_chunks/{client-dep-entries-Dw5Dvatr.js.map → client-dep-entries-Dka67elj.js.map} +1 -1
- package/dist/_chunks/{convention-lint-BfC_dAhZ.js → convention-lint-CGGcseNn.js} +19 -5
- package/dist/_chunks/convention-lint-CGGcseNn.js.map +1 -0
- package/dist/_chunks/dev-server-DrjLscqT.js +1 -0
- package/dist/_chunks/{dev-server-3R6Bl9_R.js → dev-server-LO4McfQi.js} +3 -4
- package/dist/_chunks/dev-server-LO4McfQi.js.map +1 -0
- package/dist/_chunks/{error-boundary-Dfhxigko.js → error-boundary-wuNvAJ4n.js} +8 -15
- package/dist/_chunks/error-boundary-wuNvAJ4n.js.map +1 -0
- package/dist/_chunks/{flight-source-node-QOpWZATb.js → flight-source-node-BeF00Wo_.js} +4 -7
- package/dist/_chunks/flight-source-node-BeF00Wo_.js.map +1 -0
- package/dist/_chunks/{interception-CtNt9jPt.js → interception-D1dCGNmQ.js} +6 -6
- package/dist/_chunks/{interception-CtNt9jPt.js.map → interception-D1dCGNmQ.js.map} +1 -1
- package/dist/_chunks/{json-lossy-check-5KFcC1yt.js → json-lossy-check-DpXneTBm.js} +2 -2
- package/dist/_chunks/{json-lossy-check-5KFcC1yt.js.map → json-lossy-check-DpXneTBm.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-D1dfVqoT.js → live-graph-DXhz6A_X.js} +4 -4
- package/dist/_chunks/{live-graph-D1dfVqoT.js.map → live-graph-DXhz6A_X.js.map} +1 -1
- package/dist/_chunks/{logger-BvGxPd1e.js → logger-D1sWX2I0.js} +18 -3
- package/dist/_chunks/logger-D1sWX2I0.js.map +1 -0
- package/dist/_chunks/metadata-routes-MXNjWOt5.js.map +1 -1
- package/dist/_chunks/{node-response-D5cfiyWP.js → node-response-Cp62CtH1.js} +2 -2
- package/dist/_chunks/{node-response-D5cfiyWP.js.map → node-response-Cp62CtH1.js.map} +1 -1
- package/dist/_chunks/{poison-scan-CX02ilxN.js → poison-scan-DdkJoHvP.js} +2 -2
- package/dist/_chunks/{poison-scan-CX02ilxN.js.map → poison-scan-DdkJoHvP.js.map} +1 -1
- package/dist/_chunks/{scanner-DneYxQoY.js → scanner-B6V2RqqF.js} +20 -3
- package/dist/_chunks/scanner-B6V2RqqF.js.map +1 -0
- package/dist/_chunks/{sizeof-BtQ3ErLf.js → sizeof-BKA6qOZq.js} +2 -2
- package/dist/_chunks/{sizeof-BtQ3ErLf.js.map → sizeof-BKA6qOZq.js.map} +1 -1
- package/dist/_chunks/{walkers-C9R2A4jN.js → walkers-BAZoAlfI.js} +3 -3
- package/dist/_chunks/{walkers-C9R2A4jN.js.map → walkers-BAZoAlfI.js.map} +1 -1
- package/dist/adapters/cloudflare-kv-cache.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.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/document-withdrawal.d.ts +2 -0
- package/dist/client/document-withdrawal.d.ts.map +1 -0
- package/dist/client/error-boundary.js +1 -1
- package/dist/client/index.js +1 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.js +3 -5
- package/dist/client/internal.js.map +1 -1
- package/dist/client/navigation-commit.d.ts +0 -7
- package/dist/client/navigation-commit.d.ts.map +1 -1
- package/dist/client/outlet-content-cache.d.ts +28 -42
- package/dist/client/outlet-content-cache.d.ts.map +1 -1
- package/dist/client/outlet-scope-context.d.ts +9 -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 -15
- 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 +2 -18
- package/dist/config-types.d.ts.map +1 -1
- package/dist/config-validation.d.ts.map +1 -1
- package/dist/index.js +7 -8
- package/dist/index.js.map +1 -1
- package/dist/native/rsc/manifest.json +3 -4
- package/dist/native/rsc/routing/segment-keys.js.map +1 -1
- package/dist/native/rsc/server/als-registry.js +1 -2
- package/dist/native/rsc/server/als-registry.js.map +1 -1
- package/dist/native/rsc/server/client-state-tree.js +1 -5
- package/dist/native/rsc/server/client-state-tree.js.map +1 -1
- package/dist/native/rsc/server/cookie-context.js +7 -7
- package/dist/native/rsc/server/cookie-context.js.map +1 -1
- package/dist/native/rsc/server/deny-boundary.js +2 -1
- package/dist/native/rsc/server/deny-boundary.js.map +1 -1
- package/dist/native/rsc/server/dev-overlay-report.js +13 -0
- package/dist/native/rsc/server/dev-overlay-report.js.map +1 -0
- 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 +6 -41
- package/dist/native/rsc/server/flight-source.js.map +1 -1
- package/dist/native/rsc/server/framework-stack-frames.js.map +1 -1
- package/dist/native/rsc/server/logger.js +6 -1
- package/dist/native/rsc/server/logger.js.map +1 -1
- package/dist/native/rsc/server/pipeline-interception.js +4 -1
- package/dist/native/rsc/server/pipeline-interception.js.map +1 -1
- package/dist/native/rsc/server/pipeline.js.map +1 -1
- package/dist/native/rsc/server/request-context.js +6 -6
- package/dist/native/rsc/server/request-context.js.map +1 -1
- package/dist/native/rsc/server/route-element-builder.js +5 -5
- package/dist/native/rsc/server/route-element-builder.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/render-route.js +4 -30
- package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +0 -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/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 +45 -12
- package/dist/native/rsc/server/segment-lifetime/read-rule.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/read-scope.js +50 -8
- package/dist/native/rsc/server/segment-lifetime/read-scope.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/segment-key.js +17 -3
- package/dist/native/rsc/server/segment-lifetime/segment-key.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/slot-outlets.js +4 -4
- package/dist/native/rsc/server/segment-lifetime/slot-outlets.js.map +1 -1
- package/dist/native/rsc/server/slot-resolver.js +8 -7
- package/dist/native/rsc/server/slot-resolver.js.map +1 -1
- package/dist/native/rsc/server/slot-subtree-contain.js +2 -1
- package/dist/native/rsc/server/slot-subtree-contain.js.map +1 -1
- package/dist/native/rsc/server/subtree-walk.js +14 -5
- package/dist/native/rsc/server/subtree-walk.js.map +1 -1
- package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
- 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/ssr/client/document-withdrawal.js +17 -0
- package/dist/native/ssr/client/document-withdrawal.js.map +1 -0
- package/dist/native/ssr/client/outlet-content-cache.js +10 -25
- 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 +17 -21
- package/dist/native/ssr/client/segment-outlet.js.map +1 -1
- package/dist/native/ssr/manifest.json +6 -1
- package/dist/native/ssr/server/als-registry.js +0 -1
- package/dist/native/ssr/server/als-registry.js.map +1 -1
- package/dist/native/ssr/server/client-state-tree.js +1 -5
- package/dist/native/ssr/server/client-state-tree.js.map +1 -1
- package/dist/native/ssr/server/cookie-context.js +7 -7
- package/dist/native/ssr/server/cookie-context.js.map +1 -1
- package/dist/native/ssr/server/deny-boundary.js +2 -1
- package/dist/native/ssr/server/deny-boundary.js.map +1 -1
- package/dist/native/ssr/server/dev-overlay-report.js +6 -0
- package/dist/native/ssr/server/dev-overlay-report.js.map +1 -0
- 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 +0 -1
- package/dist/native/ssr/server/flight-source.js.map +1 -1
- package/dist/native/ssr/server/framework-stack-frames.js.map +1 -1
- package/dist/native/ssr/server/logger.js +6 -1
- package/dist/native/ssr/server/logger.js.map +1 -1
- package/dist/native/ssr/server/pipeline-interception.js +4 -1
- package/dist/native/ssr/server/pipeline-interception.js.map +1 -1
- package/dist/native/ssr/server/pipeline.js.map +1 -1
- package/dist/native/ssr/server/request-context.js +6 -6
- package/dist/native/ssr/server/request-context.js.map +1 -1
- package/dist/native/ssr/server/segment-lifetime/outlet-gate.js +11 -0
- package/dist/native/ssr/server/segment-lifetime/outlet-gate.js.map +1 -0
- package/dist/native/ssr/server/segment-lifetime/read-rule.js +45 -12
- package/dist/native/ssr/server/segment-lifetime/read-rule.js.map +1 -1
- package/dist/native/ssr/server/segment-lifetime/read-scope.js +16 -0
- package/dist/native/ssr/server/segment-lifetime/read-scope.js.map +1 -0
- package/dist/native/ssr/server/subtree-walk.js +149 -0
- package/dist/native/ssr/server/subtree-walk.js.map +1 -0
- package/dist/native/ssr/server/utils/element-type.js +21 -9
- package/dist/native/ssr/server/utils/element-type.js.map +1 -1
- package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
- package/dist/native/ssr/shared/key-headers.js +13 -0
- package/dist/native/ssr/shared/key-headers.js.map +1 -0
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/routing/index.js +3 -3
- package/dist/routing/route-options.d.ts.map +1 -1
- package/dist/routing/segment-keys.d.ts +3 -4
- package/dist/routing/segment-keys.d.ts.map +1 -1
- package/dist/routing/slot-placement.d.ts +23 -4
- package/dist/routing/slot-placement.d.ts.map +1 -1
- package/dist/server/als-registry.d.ts +20 -16
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/client-state-tree.d.ts +5 -11
- package/dist/server/client-state-tree.d.ts.map +1 -1
- package/dist/server/deny-boundary.d.ts.map +1 -1
- package/dist/server/dev-overlay-report.d.ts +13 -0
- package/dist/server/dev-overlay-report.d.ts.map +1 -0
- 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 +0 -27
- package/dist/server/flight-source.d.ts.map +1 -1
- package/dist/server/framework-stack-frames.d.ts +1 -4
- package/dist/server/framework-stack-frames.d.ts.map +1 -1
- package/dist/server/index.js +2 -2
- package/dist/server/internal.js +105 -26
- package/dist/server/internal.js.map +1 -1
- package/dist/server/logger.d.ts +10 -0
- package/dist/server/logger.d.ts.map +1 -1
- package/dist/server/pipeline-interception.d.ts.map +1 -1
- package/dist/server/pipeline.d.ts +13 -1
- package/dist/server/pipeline.d.ts.map +1 -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/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 +0 -1
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
- 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/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 +19 -13
- package/dist/server/segment-lifetime/read-rule.d.ts.map +1 -1
- package/dist/server/segment-lifetime/read-scope.d.ts +48 -6
- package/dist/server/segment-lifetime/read-scope.d.ts.map +1 -1
- package/dist/server/segment-lifetime/segment-key.d.ts +3 -0
- package/dist/server/segment-lifetime/segment-key.d.ts.map +1 -1
- package/dist/server/segment-lifetime/slot-outlets.d.ts +3 -3
- package/dist/server/segment-lifetime/slot-outlets.d.ts.map +1 -1
- package/dist/server/slot-resolver.d.ts +5 -5
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/slot-subtree-contain.d.ts.map +1 -1
- package/dist/server/subtree-walk.d.ts +17 -3
- package/dist/server/subtree-walk.d.ts.map +1 -1
- package/dist/server/types.d.ts +8 -2
- package/dist/server/types.d.ts.map +1 -1
- package/dist/server/vite-handoff-rsc.d.ts +3 -10
- package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
- 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 +13 -44
- package/dist/shared/outlet-decision.d.ts.map +1 -1
- package/dist/shared/payload-root.d.ts +1 -1
- package/dist/shared/segment-info.d.ts +3 -7
- package/dist/shared/segment-info.d.ts.map +1 -1
- package/docs/api/30-api-server.mdx +1 -1
- package/docs/api/34-api-config.mdx +1 -1
- package/package.json +1 -1
- package/src/client/browser-entry/index.ts +0 -2
- package/src/client/browser-entry/router-init.ts +2 -4
- package/src/client/document-withdrawal.tsx +41 -0
- package/src/client/error-boundary.tsx +1 -1
- package/src/client/navigation-commit.ts +4 -18
- package/src/client/outlet-content-cache.ts +38 -60
- package/src/client/outlet-scope-context.ts +10 -5
- package/src/client/params-context.ts +1 -1
- package/src/client/router-types.ts +3 -14
- package/src/client/router.ts +0 -2
- package/src/client/rsc-fetch.ts +1 -1
- package/src/client/segment-cache.ts +2 -2
- package/src/client/segment-outlet.tsx +28 -54
- package/src/client/stale-segment.ts +2 -2
- package/src/config-types.ts +2 -18
- package/src/config-validation.ts +0 -1
- package/src/plugins/entries.ts +0 -1
- package/src/routing/interception.ts +5 -5
- package/src/routing/route-options.ts +20 -4
- package/src/routing/scanner.ts +1 -1
- package/src/routing/segment-keys.ts +3 -4
- package/src/routing/slot-placement.ts +41 -4
- package/src/rsc-runtime/vendor-types.d.ts +1 -1
- package/src/server/als-registry.ts +16 -23
- package/src/server/client-state-tree.ts +7 -18
- package/src/server/cookie-context.ts +7 -7
- package/src/server/deny-boundary.ts +4 -1
- package/src/server/dev-overlay-report.ts +22 -0
- package/src/server/flight-source-node.ts +1 -5
- package/src/server/flight-source.ts +1 -81
- package/src/server/framework-stack-frames.ts +1 -4
- package/src/server/logger.ts +13 -0
- package/src/server/pipeline-interception.ts +11 -2
- package/src/server/pipeline.ts +13 -1
- package/src/server/request-context.ts +12 -11
- package/src/server/route-element-builder.ts +15 -16
- package/src/server/rsc-entry/helpers.ts +1 -1
- package/src/server/rsc-entry/index.ts +7 -3
- package/src/server/rsc-entry/render-route.ts +7 -54
- package/src/server/rsc-entry/revalidate-renderer.ts +0 -2
- package/src/server/rsc-entry/rsc-stream.ts +3 -23
- package/src/server/segment-lifetime/outlet-gate.ts +102 -0
- package/src/server/segment-lifetime/read-rule.ts +110 -22
- package/src/server/segment-lifetime/read-scope.ts +131 -15
- package/src/server/segment-lifetime/segment-key.ts +31 -3
- package/src/server/segment-lifetime/slot-outlets.ts +6 -6
- package/src/server/slot-resolver.ts +30 -18
- package/src/server/slot-subtree-contain.ts +2 -1
- package/src/server/subtree-walk.ts +34 -9
- package/src/server/types.ts +8 -2
- package/src/server/vite-handoff-rsc.ts +3 -12
- package/src/shared/key-headers.ts +42 -0
- package/src/shared/outlet-decision.ts +13 -48
- package/src/shared/payload-root.ts +1 -1
- package/src/shared/segment-info.ts +3 -7
- package/dist/_chunks/actions-BCYVyoFl.js.map +0 -1
- package/dist/_chunks/chains-DPZAMMav.js +0 -1
- package/dist/_chunks/convention-lint-BfC_dAhZ.js.map +0 -1
- package/dist/_chunks/dev-server-3DNTXQV-.js +0 -1
- package/dist/_chunks/dev-server-3R6Bl9_R.js.map +0 -1
- package/dist/_chunks/error-boundary-Dfhxigko.js.map +0 -1
- package/dist/_chunks/flight-source-node-QOpWZATb.js.map +0 -1
- package/dist/_chunks/logger-BvGxPd1e.js.map +0 -1
- package/dist/_chunks/scanner-DneYxQoY.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 -101
- 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 -93
- 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 -229
- package/src/server/segment-hash/stream-tap.ts +0 -244
- package/src/server/segment-hash/value-hash.ts +0 -338
package/dist/server/types.d.ts
CHANGED
|
@@ -83,8 +83,8 @@ export type RoutePrerender = boolean | {
|
|
|
83
83
|
export type SegmentLifetime = 'request' | 'document';
|
|
84
84
|
/**
|
|
85
85
|
* The request inputs a `'document'` segment depends on — and the only ones it
|
|
86
|
-
* may read.
|
|
87
|
-
* codec. See design/53-segment-lifetime.md §"Segment keys".
|
|
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
88
|
*/
|
|
89
89
|
export interface SegmentKey {
|
|
90
90
|
/**
|
|
@@ -96,6 +96,12 @@ export interface SegmentKey {
|
|
|
96
96
|
searchParams?: SearchParamsDefinition<Record<string, unknown>>;
|
|
97
97
|
/** Cookie definitions (`defineCookie`). Default: none. */
|
|
98
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[];
|
|
99
105
|
}
|
|
100
106
|
/** Options for a `page.tsx`: `export const pageOptions = { … } satisfies PageOptions`. */
|
|
101
107
|
export interface PageOptions {
|
|
@@ -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;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,gBAAgB,EAAE,GAClB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,wEAAwE;IACxE,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IACzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,aAAa;CAAG;AAgBjC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAElF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,0DAA0D;IAC1D,OAAO,CAAC,EAAE,SAAS,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -30,28 +30,20 @@ import type { StatusPageMarker } from '../client/status-page-marker.tsx';
|
|
|
30
30
|
import type { SlotOutlet } from '../client/slot-outlet.tsx';
|
|
31
31
|
import type { SlotsProvider } from '../client/slot-provider.tsx';
|
|
32
32
|
import type { DenyLastResort } from '../client/deny-last-resort.tsx';
|
|
33
|
+
import type { DocumentWithdrawal } from '../client/document-withdrawal.tsx';
|
|
33
34
|
/**
|
|
34
35
|
* plugin-rsc's Flight runtime, as `rsc-runtime/rsc.ts` adapts it, typed as
|
|
35
36
|
* the runtime calls it. `createFromReadableStream` is plugin-rsc's generic
|
|
36
37
|
* decoder; the runtime only ever passes a stream and inspects the result, and
|
|
37
38
|
* the narrower type is what a test double can satisfy.
|
|
38
39
|
*/
|
|
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
40
|
export interface RscFlightRuntime {
|
|
47
41
|
renderFlight: typeof FlightAdapter.renderFlight;
|
|
48
42
|
loadServerAction: typeof FlightAdapter.loadServerAction;
|
|
49
43
|
decodeReply: typeof FlightAdapter.decodeReply;
|
|
50
44
|
decodeAction: typeof FlightAdapter.decodeAction;
|
|
51
45
|
decodeFormState: typeof FlightAdapter.decodeFormState;
|
|
52
|
-
createFromReadableStream: (stream: ReadableStream<Uint8Array
|
|
53
|
-
temporaryReferences?: TemporaryReferenceLookup;
|
|
54
|
-
}) => Promise<unknown>;
|
|
46
|
+
createFromReadableStream: (stream: ReadableStream<Uint8Array>) => Promise<unknown>;
|
|
55
47
|
}
|
|
56
48
|
/**
|
|
57
49
|
* timber's own `'use client'` components that server code renders. In the RSC
|
|
@@ -68,6 +60,7 @@ export interface RscClientComponents {
|
|
|
68
60
|
SlotOutlet: typeof SlotOutlet;
|
|
69
61
|
SlotsProvider: typeof SlotsProvider;
|
|
70
62
|
DenyLastResort: typeof DenyLastResort;
|
|
63
|
+
DocumentWithdrawal: typeof DocumentWithdrawal;
|
|
71
64
|
}
|
|
72
65
|
export interface RscViteHandoff {
|
|
73
66
|
/** Partial so a test provides only the functions it exercises. */
|
|
@@ -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;
|
|
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;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E;;;;;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;IACtC,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;CAC/C;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"}
|
|
@@ -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,67 +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
|
-
*
|
|
15
|
-
*
|
|
16
|
-
* - **Skip** — the client already holds content with this `hash`, and the
|
|
17
|
-
* server just produced identical output; or, for a `'document'` segment,
|
|
18
|
-
* the client holds content rendered under this `digest` and the request's
|
|
19
|
-
* key values still match it, so the server did not render the segment at
|
|
20
|
-
* all. `outlets` carries the decisions for the segments nested directly
|
|
21
|
-
* inside it, because the client renders its cached copy of this segment
|
|
22
|
-
* and that copy still holds the old ones.
|
|
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
|
|
14
|
+
* for the segments nested directly inside it, because the client renders
|
|
15
|
+
* its cached copy of this segment and that copy still holds the old ones.
|
|
23
16
|
*
|
|
24
|
-
*
|
|
25
|
-
* render the segment once before deciding, and as a plain value otherwise.
|
|
26
|
-
*
|
|
27
|
-
* See design/52-segment-hash-dedupe.md §"Wire format".
|
|
17
|
+
* See design/53-segment-lifetime.md §"Skipping".
|
|
28
18
|
*/
|
|
29
19
|
import type { ReactNode } from 'react';
|
|
30
|
-
export type OutletDecision = LiveDecision |
|
|
20
|
+
export type OutletDecision = LiveDecision | DocumentSkip;
|
|
31
21
|
export interface LiveDecision {
|
|
32
22
|
skip?: undefined;
|
|
33
|
-
hash?: PromiseLike<string | null>;
|
|
34
23
|
/** The key digest of a `'document'` segment's content. */
|
|
35
24
|
digest?: string;
|
|
36
25
|
children: ReactNode;
|
|
37
26
|
}
|
|
38
|
-
export type SkipDecision = HashSkip | DocumentSkip;
|
|
39
|
-
/** A segment the server rendered and found identical to what the client holds. */
|
|
40
|
-
export interface HashSkip {
|
|
41
|
-
skip: true;
|
|
42
|
-
hash: string;
|
|
43
|
-
digest?: undefined;
|
|
44
|
-
/** The decisions of the segments nested directly inside, by segment path. */
|
|
45
|
-
outlets: Record<string, OutletDecisionValue>;
|
|
46
|
-
}
|
|
47
27
|
/** A `'document'` segment whose key is unchanged: never rendered. */
|
|
48
28
|
export interface DocumentSkip {
|
|
49
29
|
skip: true;
|
|
50
|
-
hash?: undefined;
|
|
51
30
|
digest: string;
|
|
52
31
|
/** The decisions of the segments nested directly inside, by segment path. */
|
|
53
|
-
outlets: Record<string,
|
|
54
|
-
}
|
|
55
|
-
/**
|
|
56
|
-
* What a nested outlet carries inside a segment-hash capture, in place of a
|
|
57
|
-
* decision: an opaque marker Flight writes as a temporary reference and the
|
|
58
|
-
* capture's decoder replaces with the real decision. Never reaches a client.
|
|
59
|
-
*/
|
|
60
|
-
export interface CaptureHole {
|
|
61
|
-
readonly captureHole: true;
|
|
32
|
+
outlets: Record<string, OutletDecision>;
|
|
62
33
|
}
|
|
63
|
-
/** A decision as an outlet receives it. */
|
|
64
|
-
export type OutletDecisionValue = OutletDecision | PromiseLike<OutletDecision>;
|
|
65
34
|
/** The `segmentPath` of the metadata outlet — one per payload. */
|
|
66
35
|
export declare const METADATA_OUTLET_PATH = "#metadata";
|
|
67
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.
|
|
@@ -33,10 +33,8 @@ export interface SegmentInfo {
|
|
|
33
33
|
/**
|
|
34
34
|
* The client's `X-Timber-State-Tree` request header.
|
|
35
35
|
*
|
|
36
|
-
* `
|
|
37
|
-
*
|
|
38
|
-
* `clientSegmentCache` (design/52-segment-hash-dedupe.md). `treePaths` is
|
|
39
|
-
* not caching: it describes the *shape* of the tree currently on screen, so
|
|
36
|
+
* `documents` are the key digests of the `'document'` segments the client
|
|
37
|
+
* holds. `treePaths` is not caching: it describes the *shape* of the tree currently on screen, so
|
|
40
38
|
* the server can answer "does the rendered route pass through the segment
|
|
41
39
|
* that owns this intercepting slot?" without re-deriving it from the address
|
|
42
40
|
* bar, which stops being the source route the moment a modal is open
|
|
@@ -45,11 +43,9 @@ export interface SegmentInfo {
|
|
|
45
43
|
* Neither is a security input. Every `access.ts` runs regardless.
|
|
46
44
|
*/
|
|
47
45
|
export interface StateTree {
|
|
48
|
-
hashes?: Record<string, string>;
|
|
49
46
|
/**
|
|
50
47
|
* The key digests of the `'document'` segments the client holds, by outlet
|
|
51
|
-
* path (design/53-segment-lifetime.md).
|
|
52
|
-
* not; left out of the `_rsc` cache key.
|
|
48
|
+
* path (design/53-segment-lifetime.md). Left out of the `_rsc` cache key.
|
|
53
49
|
*/
|
|
54
50
|
documents?: Record<string, string>;
|
|
55
51
|
treePaths?: string[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"segment-info.d.ts","sourceRoot":"","sources":["../../src/shared/segment-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED
|
|
1
|
+
{"version":3,"file":"segment-info.d.ts","sourceRoot":"","sources":["../../src/shared/segment-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}
|
|
@@ -217,7 +217,7 @@ export const pageOptions = {
|
|
|
217
217
|
| Option | Applies to | Meaning |
|
|
218
218
|
| ------------------ | ------------ | ----------------------------------------------------------------------------------------------------------- |
|
|
219
219
|
| `lifetime` | layout, page | `'request'` (default) or `'document'`: render once per loaded document and skip on client navigations until `key` changes ([Document lifetime](/docs/client-navigation#document-lifetime)). Slots included. |
|
|
220
|
-
| `key` | layout, page | What a `'document'` segment depends on: `segmentParams` (names on its path; default all of them), `searchParams` (a definition), `cookies` (definitions). |
|
|
220
|
+
| `key` | layout, page | What a `'document'` segment depends on: `segmentParams` (names on its path; default all of them), `searchParams` (a definition), `cookies` (definitions), `headers` (header names). |
|
|
221
221
|
| `prerender` | layout, page | Render at build time ([route-level sugar](/docs/api-cache#route-level-sugar)). Layouts cascade it to pages, slot pages included. |
|
|
222
222
|
| `deferSuspenseFor` | layout, page | Hold the SSR stream up to N ms ([`deferSuspenseFor`](/docs/streaming#defersuspensefor)). Main route only, not parallel slots. |
|
|
223
223
|
|
|
@@ -213,7 +213,7 @@ Render timeout in milliseconds. If an SSR render or RSC stream read does not com
|
|
|
213
213
|
|
|
214
214
|
### `defaultLayoutLifetime`
|
|
215
215
|
|
|
216
|
-
The lifetime of every layout that does not declare one, slot layouts included. `'request'` (the default) or `'document'`. Pages are unaffected, and a layout's own `layoutOptions.lifetime` wins. Under `'document'`, a layout that reads a request input outside its key
|
|
216
|
+
The lifetime of every layout that does not declare one, slot layouts included. `'request'` (the default) or `'document'`. Pages are unaffected, and a layout's own `layoutOptions.lifetime` wins. Under `'document'`, a layout that reads a request input outside its key is reported (the dev overlay, or a warning in production) and renders as `'request'`, one that shows data that changes during a visit keeps its load-time value, and one that hides its children in its body no longer keeps them out of the payload. Layouts in and below an intercepting directory stay `'request'`. See [Making layouts `'document'` by default](/docs/client-navigation#making-layouts-document-by-default).
|
|
217
217
|
|
|
218
218
|
### `devBrowserLogs`
|
|
219
219
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@timber-js/app",
|
|
3
|
-
"version": "0.2.0-alpha.
|
|
3
|
+
"version": "0.2.0-alpha.243",
|
|
4
4
|
"description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cloudflare-workers",
|
|
@@ -103,8 +103,6 @@ function bootstrap(runtimeConfig: typeof config, formState: ReactFormState | nul
|
|
|
103
103
|
});
|
|
104
104
|
const { router, navApiController, hydrate } = createTimberRouter({
|
|
105
105
|
render: reactRoot.render,
|
|
106
|
-
clientSegmentCache:
|
|
107
|
-
((runtimeConfig as Record<string, unknown>).clientSegmentCache as boolean) ?? false,
|
|
108
106
|
});
|
|
109
107
|
|
|
110
108
|
// Step 4: Make the page current and hydrate (no root without a payload)
|
|
@@ -36,7 +36,6 @@ export interface RouterInitOptions {
|
|
|
36
36
|
* around `root.render`, and the `publish` it takes runs on React's commit.
|
|
37
37
|
*/
|
|
38
38
|
render: NavigationRender;
|
|
39
|
-
clientSegmentCache?: boolean;
|
|
40
39
|
}
|
|
41
40
|
|
|
42
41
|
export interface RouterInitResult {
|
|
@@ -82,12 +81,12 @@ export function createTimberRouter(options: RouterInitOptions): RouterInitResult
|
|
|
82
81
|
*/
|
|
83
82
|
let displayed: { tree: unknown; params: ParamsSource; navState: NavigationState } | null = null;
|
|
84
83
|
|
|
85
|
-
// The
|
|
84
|
+
// The 'document' content the client has committed, by segment path and digest.
|
|
86
85
|
// Owned here so there is exactly one per router (never a module or
|
|
87
86
|
// globalThis singleton — SegmentOutlet also executes during SSR, where a
|
|
88
87
|
// process-wide record would be shared across requests). Read by
|
|
89
88
|
// SegmentOutlet in render, written by it at commit only, and read by the
|
|
90
|
-
// router for the
|
|
89
|
+
// router for the digests it advertises. See client/outlet-content-cache.ts.
|
|
91
90
|
const outletContentCache = new OutletContentCache();
|
|
92
91
|
|
|
93
92
|
/**
|
|
@@ -237,7 +236,6 @@ export function createTimberRouter(options: RouterInitOptions): RouterInitResult
|
|
|
237
236
|
};
|
|
238
237
|
|
|
239
238
|
const deps: RouterDeps = {
|
|
240
|
-
clientSegmentCache: options?.clientSegmentCache ?? false,
|
|
241
239
|
outletContentCache,
|
|
242
240
|
fetch: (url, init) => window.fetch(url, init),
|
|
243
241
|
pushState: (data, unused, url) => {
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
'use client';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* DocumentWithdrawal — a `'document'` segment's content telling the client
|
|
5
|
+
* not to keep it.
|
|
6
|
+
*
|
|
7
|
+
* A `'document'` segment that reads a request input outside its key is not
|
|
8
|
+
* failed: the read is reported, it returns its real value, and the server
|
|
9
|
+
* appends this marker to the segment's content
|
|
10
|
+
* (`server/segment-lifetime/read-scope.ts`). The outlet's key digest was sent
|
|
11
|
+
* before the segment rendered, so the content has to withdraw itself.
|
|
12
|
+
*
|
|
13
|
+
* It carries no outlet path: it withdraws the nearest `SegmentOutlet` above it
|
|
14
|
+
* (`OutletScopeContext`), which is the outlet whose committed content holds it.
|
|
15
|
+
* For a marker the segment's own call placed, that is the segment's outlet.
|
|
16
|
+
* For one a catcher placed beside its fallback (a deny page, a slot's
|
|
17
|
+
* `default.tsx`), it is wherever that fallback landed — after a hoisted deny,
|
|
18
|
+
* an ancestor's outlet.
|
|
19
|
+
*
|
|
20
|
+
* On commit the marker withdraws that outlet from the router's outlet content
|
|
21
|
+
* cache: the entry is dropped and no later content is recorded for it, so
|
|
22
|
+
* the client never advertises a digest for it and every navigation renders
|
|
23
|
+
* it live — the segment is `'request'` for the rest of the document.
|
|
24
|
+
* A layout effect, and layout effects run child before parent: in the commit
|
|
25
|
+
* that brings the outlet's content, this runs before the outlet records it.
|
|
26
|
+
*
|
|
27
|
+
* Renders nothing. See design/53-segment-lifetime.md §"Reads outside the key".
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
import { useContext, useLayoutEffect } from 'react';
|
|
31
|
+
import { OutletContentCacheContext } from './outlet-content-cache.ts';
|
|
32
|
+
import { OutletScopeContext } from './outlet-scope-context.ts';
|
|
33
|
+
|
|
34
|
+
export function DocumentWithdrawal(): null {
|
|
35
|
+
const cache = useContext(OutletContentCacheContext);
|
|
36
|
+
const { segmentPath } = useContext(OutletScopeContext);
|
|
37
|
+
useLayoutEffect(() => {
|
|
38
|
+
if (segmentPath !== undefined) cache?.withdraw(segmentPath);
|
|
39
|
+
}, [cache, segmentPath]);
|
|
40
|
+
return null;
|
|
41
|
+
}
|
|
@@ -154,7 +154,7 @@ let _pendingRedirectLocation: string | null = null;
|
|
|
154
154
|
* Resets a boundary showing an error once a new navigation reaches it.
|
|
155
155
|
*
|
|
156
156
|
* Live content resets the boundary through new `children`. Content a skip
|
|
157
|
-
* reuses (design/
|
|
157
|
+
* reuses (design/53) is the same element tree as before — the boundary sees
|
|
158
158
|
* the same `children` and would keep showing the old error, never mounting
|
|
159
159
|
* the nested outlet that holds the new decision. What a skip does change is
|
|
160
160
|
* the outlet scope: a new one for every decision. A scope other than the one
|
|
@@ -141,13 +141,6 @@ export function deriveNavigationState(url: string): NavigationState {
|
|
|
141
141
|
export function createNavigationCommitter(deps: {
|
|
142
142
|
segmentCache: SegmentCache;
|
|
143
143
|
historyStack: HistoryStack;
|
|
144
|
-
/** Read at call time — the router's `clientSegmentCache` opt-in. */
|
|
145
|
-
clientSegmentCache: () => boolean | undefined;
|
|
146
|
-
/**
|
|
147
|
-
* The segment hashes the client holds content for, by outlet path
|
|
148
|
-
* (`OutletContentCache.hashes()`). Empty outside a browser router.
|
|
149
|
-
*/
|
|
150
|
-
outletHashes: () => Record<string, string>;
|
|
151
144
|
/**
|
|
152
145
|
* The key digests of the `'document'` segments the client holds content
|
|
153
146
|
* for (`OutletContentCache.documents()`). Empty outside a browser router.
|
|
@@ -169,12 +162,9 @@ export function createNavigationCommitter(deps: {
|
|
|
169
162
|
/**
|
|
170
163
|
* The X-Timber-State-Tree to send with the next RSC request.
|
|
171
164
|
*
|
|
172
|
-
* Two different things travel on one header. `
|
|
173
|
-
*
|
|
174
|
-
*
|
|
175
|
-
* the key digests of 'document' segments (design/53), sent whenever the
|
|
176
|
-
* client holds one.
|
|
177
|
-
* `treePaths` is how the server learns which route is actually mounted,
|
|
165
|
+
* Two different things travel on one header. `documents` are the key
|
|
166
|
+
* digests of 'document' segments (design/53), sent whenever the client
|
|
167
|
+
* holds one. `treePaths` is how the server learns which route is actually mounted,
|
|
178
168
|
* which stops being derivable from the address bar as soon as a modal is
|
|
179
169
|
* open — so it crosses regardless (TIM-1282). Undefined when there is
|
|
180
170
|
* nothing to say, so a no-op header never enters the `_rsc` cache key.
|
|
@@ -187,13 +177,9 @@ export function createNavigationCommitter(deps: {
|
|
|
187
177
|
const tree: StateTree = {};
|
|
188
178
|
const treePaths = segmentCache.treePaths();
|
|
189
179
|
if (treePaths.length > 0) tree.treePaths = treePaths;
|
|
190
|
-
if (deps.clientSegmentCache()) {
|
|
191
|
-
const hashes = deps.outletHashes();
|
|
192
|
-
if (Object.keys(hashes).length > 0) tree.hashes = hashes;
|
|
193
|
-
}
|
|
194
180
|
const documents = deps.outletDocuments();
|
|
195
181
|
if (Object.keys(documents).length > 0) tree.documents = documents;
|
|
196
|
-
return tree.treePaths || tree.
|
|
182
|
+
return tree.treePaths || tree.documents ? tree : undefined;
|
|
197
183
|
},
|
|
198
184
|
|
|
199
185
|
/**
|
|
@@ -1,16 +1,14 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The router-owned record of
|
|
3
|
-
* segment path and the
|
|
4
|
-
*
|
|
5
|
-
* rendered under.
|
|
2
|
+
* The router-owned record of `'document'` segment content the client has
|
|
3
|
+
* *committed* (design/53-segment-lifetime.md), by segment path and the key
|
|
4
|
+
* digest it rendered under.
|
|
6
5
|
*
|
|
7
|
-
* A skipped outlet renders the content it holds under the skip's
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* copy (design/52 §"The client checks before reusing").
|
|
6
|
+
* A skipped outlet renders the content it holds under the skip's digest, so
|
|
7
|
+
* an outlet looks up `(path, digest)`, never "whatever was last at this
|
|
8
|
+
* path". A stored payload replayed later, or a prefetch consumed after the
|
|
9
|
+
* tree moved on, therefore either finds exactly the content the server
|
|
10
|
+
* matched or finds nothing — never a newer or older copy. Only `'document'`
|
|
11
|
+
* content is recorded: nothing else is ever skipped.
|
|
14
12
|
*
|
|
15
13
|
* Ownership and write discipline (TIM-1423):
|
|
16
14
|
*
|
|
@@ -21,10 +19,6 @@
|
|
|
21
19
|
* - **Written only at commit.** `SegmentOutlet` records from a layout effect,
|
|
22
20
|
* never during render, so a render React discards — a superseded
|
|
23
21
|
* transition, a Suspense retry — records nothing.
|
|
24
|
-
* - **A hash attaches to its own entry.** The hash arrives after the content
|
|
25
|
-
* (it is computed from the rows that carried it), so the effect records the
|
|
26
|
-
* content first and attaches the hash to that entry when it resolves. An
|
|
27
|
-
* entry without a hash is never advertised.
|
|
28
22
|
* - **`null` outside a router.** SSR renders no provider; the server never
|
|
29
23
|
* sends a skip to a document request, and layout effects do not run there.
|
|
30
24
|
*
|
|
@@ -38,9 +32,8 @@ import { createGlobalContext } from './global-context.ts';
|
|
|
38
32
|
|
|
39
33
|
interface Entry {
|
|
40
34
|
content: ReactNode;
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
digest: string | null;
|
|
35
|
+
/** The key digest the content rendered under. */
|
|
36
|
+
digest: string;
|
|
44
37
|
}
|
|
45
38
|
|
|
46
39
|
/**
|
|
@@ -52,23 +45,30 @@ const ENTRIES_PER_PATH = 3;
|
|
|
52
45
|
|
|
53
46
|
/**
|
|
54
47
|
* Paths kept, least recently committed evicted first. Bounds the memory the
|
|
55
|
-
* cache pins (each entry holds a rendered subtree) and the `
|
|
56
|
-
* router sends on every navigation, which must stay well inside a
|
|
57
|
-
* header limits — the server ignores a map of more than 512 entries.
|
|
48
|
+
* cache pins (each entry holds a rendered subtree) and the `documents` map
|
|
49
|
+
* the router sends on every navigation, which must stay well inside a
|
|
50
|
+
* server's header limits — the server ignores a map of more than 512 entries.
|
|
58
51
|
*/
|
|
59
52
|
const MAX_PATHS = 64;
|
|
60
53
|
|
|
61
54
|
export class OutletContentCache {
|
|
62
55
|
private readonly byPath = new Map<string, Entry[]>();
|
|
56
|
+
/**
|
|
57
|
+
* Outlets whose content withdrew itself (`DocumentWithdrawal`): a
|
|
58
|
+
* `'document'` segment that read outside its key. Never
|
|
59
|
+
* recorded again in this document, so it renders live on every navigation.
|
|
60
|
+
*/
|
|
61
|
+
private readonly withdrawn = new Set<string>();
|
|
63
62
|
|
|
64
63
|
/**
|
|
65
|
-
* Record content an outlet committed
|
|
66
|
-
*
|
|
64
|
+
* Record content an outlet committed. Only a `'document'` segment's
|
|
65
|
+
* content, which carries the key digest it rendered under, is kept, and
|
|
66
|
+
* not a withdrawn one's.
|
|
67
67
|
*/
|
|
68
|
-
record(segmentPath: string, content: ReactNode, digest
|
|
68
|
+
record(segmentPath: string, content: ReactNode, digest: string | undefined): void {
|
|
69
|
+
if (digest === undefined || this.withdrawn.has(segmentPath)) return;
|
|
69
70
|
const entries = this.byPath.get(segmentPath) ?? [];
|
|
70
|
-
|
|
71
|
-
entries.unshift(entry);
|
|
71
|
+
entries.unshift({ content, digest });
|
|
72
72
|
if (entries.length > ENTRIES_PER_PATH) entries.length = ENTRIES_PER_PATH;
|
|
73
73
|
// Re-inserted, so the Map's order is least recently committed first.
|
|
74
74
|
this.byPath.delete(segmentPath);
|
|
@@ -77,54 +77,32 @@ export class OutletContentCache {
|
|
|
77
77
|
if (this.byPath.size <= MAX_PATHS) break;
|
|
78
78
|
this.byPath.delete(path);
|
|
79
79
|
}
|
|
80
|
-
return entry;
|
|
81
|
-
}
|
|
82
|
-
|
|
83
|
-
/** Attach the server's hash for a recorded entry, if it is still held. */
|
|
84
|
-
attachHash(segmentPath: string, entry: Entry, hash: string): void {
|
|
85
|
-
const entries = this.byPath.get(segmentPath);
|
|
86
|
-
if (!entries?.includes(entry)) return;
|
|
87
|
-
// An identical earlier version is now redundant — keep the newest.
|
|
88
|
-
const duplicate = entries.findIndex((e) => e !== entry && e.hash === hash);
|
|
89
|
-
if (duplicate !== -1) entries.splice(duplicate, 1);
|
|
90
|
-
entry.hash = hash;
|
|
91
80
|
}
|
|
92
81
|
|
|
93
|
-
/**
|
|
94
|
-
|
|
95
|
-
|
|
82
|
+
/**
|
|
83
|
+
* Stop holding `segmentPath` for the rest of the document: drop what is
|
|
84
|
+
* held and record nothing later (design/53 §"Reads outside the key").
|
|
85
|
+
*/
|
|
86
|
+
withdraw(segmentPath: string): void {
|
|
87
|
+
this.withdrawn.add(segmentPath);
|
|
88
|
+
this.byPath.delete(segmentPath);
|
|
96
89
|
}
|
|
97
90
|
|
|
98
|
-
/** The
|
|
99
|
-
|
|
91
|
+
/** The content committed under `digest` at `segmentPath`, if held. */
|
|
92
|
+
lookup(segmentPath: string, digest: string): { content: ReactNode } | undefined {
|
|
100
93
|
return this.byPath.get(segmentPath)?.find((e) => e.digest === digest);
|
|
101
94
|
}
|
|
102
95
|
|
|
103
|
-
/**
|
|
104
|
-
* What to advertise in `X-Timber-State-Tree`: per path, the hash of the
|
|
105
|
-
* most recently committed content — only when it is known. A path whose
|
|
106
|
-
* latest content has no hash yet advertises nothing, which means a resend.
|
|
107
|
-
*/
|
|
108
|
-
hashes(): Record<string, string> {
|
|
109
|
-
const out: Record<string, string> = {};
|
|
110
|
-
for (const [path, entries] of this.byPath) {
|
|
111
|
-
const latest = entries[0];
|
|
112
|
-
if (latest?.hash) out[path] = latest.hash;
|
|
113
|
-
}
|
|
114
|
-
return out;
|
|
115
|
-
}
|
|
116
|
-
|
|
117
96
|
/**
|
|
118
97
|
* What to advertise as `documents` in `X-Timber-State-Tree`: per path, the
|
|
119
|
-
* key digest of the most recently committed content
|
|
120
|
-
*
|
|
121
|
-
* the `clientSegmentCache` opt-in — and kept out of the `_rsc` key.
|
|
98
|
+
* key digest of the most recently committed content. Kept out of the
|
|
99
|
+
* `_rsc` key.
|
|
122
100
|
*/
|
|
123
101
|
documents(): Record<string, string> {
|
|
124
102
|
const out: Record<string, string> = {};
|
|
125
103
|
for (const [path, entries] of this.byPath) {
|
|
126
104
|
const latest = entries[0];
|
|
127
|
-
if (latest
|
|
105
|
+
if (latest) out[path] = latest.digest;
|
|
128
106
|
}
|
|
129
107
|
return out;
|
|
130
108
|
}
|