@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,439 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Route-module options: `export const layoutOptions = { … }` in a layout and
|
|
3
|
+
* `export const pageOptions = { … }` in a page, read from source.
|
|
4
|
+
*
|
|
5
|
+
* Design doc: design/53-segment-lifetime.md §"Route-module options".
|
|
6
|
+
*
|
|
7
|
+
* `prerender` is read here at build time, before any route module loads:
|
|
8
|
+
* `plugins/prerender-sugar.ts` decides from it which pages to wrap in
|
|
9
|
+
* `cache.component(...)`. Every other option is validated here and read at
|
|
10
|
+
* runtime from the loaded module (`deferSuspenseFor`, in
|
|
11
|
+
* `server/route-module-loader.ts`; `lifetime` and `key`, in
|
|
12
|
+
* `server/segment-lifetime/segment-key.ts`). A key's `searchParams` and
|
|
13
|
+
* `cookies` name definitions, so they are the one place a non-literal value is
|
|
14
|
+
* accepted; `segmentParams` is checked against the segment's path by
|
|
15
|
+
* `routing/route-options-lint.ts`. The whole object follows one rule so that
|
|
16
|
+
* every key is checkable: this reader accepts one spelling —
|
|
17
|
+
* `export const xOptions = { … }` of literal values, optionally behind
|
|
18
|
+
* `satisfies` / `as` — and reports the others it can see as problems.
|
|
19
|
+
* `routing/convention-lint.ts` turns problems into build errors:
|
|
20
|
+
*
|
|
21
|
+
* - a spread, a computed key, a getter or method, or a non-literal value
|
|
22
|
+
* - an unknown key (a misspelled `prerendr`)
|
|
23
|
+
* - `pageOptions` in a layout or `layoutOptions` in a page
|
|
24
|
+
* - options in a `'use client'` file, whose exports the server never sees
|
|
25
|
+
* - the removed floating exports, `export const prerender` and
|
|
26
|
+
* `export const deferSuspenseFor`
|
|
27
|
+
* - `let`, a destructured binding, a specifier or a named re-export
|
|
28
|
+
* (`export { pageOptions } from`, `export * as pageOptions from`)
|
|
29
|
+
*
|
|
30
|
+
* What it cannot see is not reported: `export * from` is not followed, a
|
|
31
|
+
* file that does not parse reads as having no options (the compiler reports
|
|
32
|
+
* it), and MDX pages are not read at all, so `prerender` in an MDX page does
|
|
33
|
+
* nothing and its `deferSuspenseFor` is unvalidated.
|
|
34
|
+
*/
|
|
35
|
+
|
|
36
|
+
import { headerKeyProblem } from '../shared/key-headers.ts';
|
|
37
|
+
import { existsSync } from 'node:fs';
|
|
38
|
+
import type {
|
|
39
|
+
LayoutOptions,
|
|
40
|
+
PageOptions,
|
|
41
|
+
RoutePrerender,
|
|
42
|
+
SegmentKey,
|
|
43
|
+
SegmentLifetime,
|
|
44
|
+
} from '../server/types.ts';
|
|
45
|
+
import { patternBinds, TRANSPARENT_WRAPPERS, tryParse } from './export-detect.ts';
|
|
46
|
+
import { readFileCached } from './file-cache.ts';
|
|
47
|
+
import { ROUTE_OPTIONS_EXPORT, type RouteOptionsKind } from '../shared/route-options-export.ts';
|
|
48
|
+
|
|
49
|
+
const OPTIONS_TYPE = { layout: 'LayoutOptions', page: 'PageOptions' } as const;
|
|
50
|
+
|
|
51
|
+
/** Floating exports the options objects replaced (design/53). */
|
|
52
|
+
const REMOVED_EXPORTS = ['prerender', 'deferSuspenseFor'] as const;
|
|
53
|
+
|
|
54
|
+
export interface RouteOptionsRead {
|
|
55
|
+
/**
|
|
56
|
+
* The declared options. Undefined when the file declares none or when any
|
|
57
|
+
* problem was found — a half-read object is never acted on.
|
|
58
|
+
*/
|
|
59
|
+
options: LayoutOptions | PageOptions | undefined;
|
|
60
|
+
/** One line per problem, each naming what to write instead. */
|
|
61
|
+
problems: string[];
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// ─── AST access ────────────────────────────────────────────────────────────
|
|
65
|
+
|
|
66
|
+
/** An ESTree node as oxc's `parseAst` produces it, read field by field. */
|
|
67
|
+
type Node = { readonly type: string; readonly [field: string]: unknown };
|
|
68
|
+
|
|
69
|
+
function isNode(value: unknown): value is Node {
|
|
70
|
+
return (
|
|
71
|
+
typeof value === 'object' && value !== null && 'type' in value && typeof value.type === 'string'
|
|
72
|
+
);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function child(node: Node, field: string): Node | undefined {
|
|
76
|
+
const value = node[field];
|
|
77
|
+
return isNode(value) ? value : undefined;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function list(node: Node, field: string): unknown[] {
|
|
81
|
+
const value = node[field];
|
|
82
|
+
return Array.isArray(value) ? value : [];
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Strip `satisfies T`, `as T`, `(x)` and friends, which compile away. */
|
|
86
|
+
function unwrap(node: Node): Node {
|
|
87
|
+
let current = node;
|
|
88
|
+
while (TRANSPARENT_WRAPPERS.has(current.type)) {
|
|
89
|
+
const inner = child(current, 'expression');
|
|
90
|
+
if (!inner) break;
|
|
91
|
+
current = inner;
|
|
92
|
+
}
|
|
93
|
+
return current;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** An identifier's name or a string literal's value (`export { x as "y" }`). */
|
|
97
|
+
function nameOf(node: Node | undefined): string | undefined {
|
|
98
|
+
if (!node) return undefined;
|
|
99
|
+
if (typeof node.value === 'string') return node.value;
|
|
100
|
+
return typeof node.name === 'string' ? node.name : undefined;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** A literal's value; a template literal with no `${}` counts as a string. */
|
|
104
|
+
function literal(node: Node): unknown {
|
|
105
|
+
const n = unwrap(node);
|
|
106
|
+
if (n.type === 'Literal') return n.value;
|
|
107
|
+
if (n.type !== 'TemplateLiteral' || list(n, 'expressions').length > 0) return undefined;
|
|
108
|
+
const [quasi] = list(n, 'quasis');
|
|
109
|
+
// A TemplateElement's `value` is `{ raw, cooked }`, not a node.
|
|
110
|
+
const parts = isNode(quasi) ? quasi.value : undefined;
|
|
111
|
+
const value =
|
|
112
|
+
typeof parts === 'object' && parts !== null && 'cooked' in parts ? parts.cooked : undefined;
|
|
113
|
+
return typeof value === 'string' ? value : undefined;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** `key: undefined` — the same as leaving the key out, as the types allow. */
|
|
117
|
+
function isUndefined(node: Node): boolean {
|
|
118
|
+
const n = unwrap(node);
|
|
119
|
+
return n.type === 'Identifier' && n.name === 'undefined';
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
// ─── Value readers, one per option ────────────────────────────────────────
|
|
123
|
+
|
|
124
|
+
type Read<T> = { value: T } | { problem: string };
|
|
125
|
+
|
|
126
|
+
/** A numeric literal is never negative (`-1` is a unary expression), so finite is enough. */
|
|
127
|
+
function readNonNegativeNumber(node: Node, label: string): Read<number> {
|
|
128
|
+
const value = literal(node);
|
|
129
|
+
if (typeof value === 'number' && Number.isFinite(value)) return { value };
|
|
130
|
+
return { problem: `${label} must be a non-negative number literal.` };
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function readPrerender(node: Node): Read<RoutePrerender> {
|
|
134
|
+
const value = literal(node);
|
|
135
|
+
if (typeof value === 'boolean') return { value };
|
|
136
|
+
const n = unwrap(node);
|
|
137
|
+
if (n.type !== 'ObjectExpression') {
|
|
138
|
+
return {
|
|
139
|
+
problem: 'prerender must be `true`, `false`, or an object literal `{ ttl?, tags? }`.',
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
const result: { ttl?: number; tags?: string[] } = {};
|
|
143
|
+
for (const entry of readProperties(n, 'prerender')) {
|
|
144
|
+
if ('problem' in entry) return entry;
|
|
145
|
+
if (entry.key === 'ttl') {
|
|
146
|
+
const ttl = readNonNegativeNumber(entry.value, 'prerender.ttl');
|
|
147
|
+
if ('problem' in ttl) return ttl;
|
|
148
|
+
result.ttl = ttl.value;
|
|
149
|
+
} else if (entry.key === 'tags') {
|
|
150
|
+
const tags = readStringArray(entry.value);
|
|
151
|
+
if (!tags) return { problem: 'prerender.tags must be an array of string literals.' };
|
|
152
|
+
result.tags = tags;
|
|
153
|
+
} else {
|
|
154
|
+
return { problem: `Unknown key "${entry.key}" in prerender. Allowed: ttl, tags.` };
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
return { value: result };
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
function readStringArray(node: Node): string[] | undefined {
|
|
161
|
+
const n = unwrap(node);
|
|
162
|
+
if (n.type !== 'ArrayExpression') return undefined;
|
|
163
|
+
const result: string[] = [];
|
|
164
|
+
for (const element of list(n, 'elements')) {
|
|
165
|
+
const value = isNode(element) ? literal(element) : undefined;
|
|
166
|
+
if (typeof value !== 'string') return undefined;
|
|
167
|
+
result.push(value);
|
|
168
|
+
}
|
|
169
|
+
return result;
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* One reader per option key. Typed against the public option types, so an
|
|
174
|
+
* option added to `PageOptions` / `LayoutOptions` without a reader here (or a
|
|
175
|
+
* reader without the option) fails typecheck — the two lists cannot drift.
|
|
176
|
+
*/
|
|
177
|
+
type Readers<T> = {
|
|
178
|
+
[K in keyof Required<T>]: (
|
|
179
|
+
node: Node
|
|
180
|
+
) => Read<NonNullable<T[K]> extends SegmentKey ? BuildTimeKey : NonNullable<T[K]>>;
|
|
181
|
+
};
|
|
182
|
+
|
|
183
|
+
const deferSuspenseFor = (node: Node) => readNonNegativeNumber(node, 'deferSuspenseFor');
|
|
184
|
+
|
|
185
|
+
const LIFETIMES: readonly SegmentLifetime[] = ['request', 'document'];
|
|
186
|
+
|
|
187
|
+
function readLifetime(node: Node): Read<SegmentLifetime> {
|
|
188
|
+
const value = literal(node);
|
|
189
|
+
const lifetime = LIFETIMES.find((l) => l === value);
|
|
190
|
+
if (lifetime) return { value: lifetime };
|
|
191
|
+
return { problem: "lifetime must be 'request' or 'document'." };
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* What the build can read of a segment key: the param and header names. `searchParams`
|
|
196
|
+
* and `cookies` name definitions — code the build cannot evaluate — so only
|
|
197
|
+
* their shape is checked here; their values take effect from the loaded
|
|
198
|
+
* module (`server/segment-lifetime/`). The route-options lint checks the
|
|
199
|
+
* param names against the segment's path.
|
|
200
|
+
*/
|
|
201
|
+
type BuildTimeKey = Pick<SegmentKey, 'segmentParams' | 'headers'>;
|
|
202
|
+
|
|
203
|
+
function readHeaderNames(node: Node): Read<string[]> {
|
|
204
|
+
const names = readStringArray(node);
|
|
205
|
+
if (!names) return { problem: 'key.headers must be an array of header-name string literals.' };
|
|
206
|
+
for (const name of names) {
|
|
207
|
+
const problem = headerKeyProblem(name);
|
|
208
|
+
if (problem) return { problem };
|
|
209
|
+
}
|
|
210
|
+
return { value: names };
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
/** A value written in place, which cannot be a definition imported or declared elsewhere. */
|
|
214
|
+
function isInlineValue(node: Node): boolean {
|
|
215
|
+
const type = unwrap(node).type;
|
|
216
|
+
return (
|
|
217
|
+
literal(node) !== undefined ||
|
|
218
|
+
type === 'ObjectExpression' ||
|
|
219
|
+
type === 'ArrayExpression' ||
|
|
220
|
+
type === 'Literal' ||
|
|
221
|
+
type === 'TemplateLiteral'
|
|
222
|
+
);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
function readKey(node: Node): Read<BuildTimeKey> {
|
|
226
|
+
const n = unwrap(node);
|
|
227
|
+
if (n.type !== 'ObjectExpression') {
|
|
228
|
+
return {
|
|
229
|
+
problem:
|
|
230
|
+
'key must be an object literal `{ segmentParams?, searchParams?, cookies?, headers? }`.',
|
|
231
|
+
};
|
|
232
|
+
}
|
|
233
|
+
const result: BuildTimeKey = {};
|
|
234
|
+
for (const entry of readProperties(n, 'key')) {
|
|
235
|
+
if ('problem' in entry) return entry;
|
|
236
|
+
if (entry.key === 'segmentParams') {
|
|
237
|
+
const names = readStringArray(entry.value);
|
|
238
|
+
if (!names) return { problem: 'key.segmentParams must be an array of string literals.' };
|
|
239
|
+
result.segmentParams = names;
|
|
240
|
+
} else if (entry.key === 'searchParams') {
|
|
241
|
+
if (isInlineValue(entry.value)) {
|
|
242
|
+
return {
|
|
243
|
+
problem:
|
|
244
|
+
'key.searchParams must name a search-params definition (`defineSearchParams`, or a `.pick()` of one).',
|
|
245
|
+
};
|
|
246
|
+
}
|
|
247
|
+
} else if (entry.key === 'cookies') {
|
|
248
|
+
const array = unwrap(entry.value);
|
|
249
|
+
const elements = list(array, 'elements');
|
|
250
|
+
const definitions = elements.every(
|
|
251
|
+
(e) => isNode(e) && e.type !== 'SpreadElement' && !isInlineValue(e)
|
|
252
|
+
);
|
|
253
|
+
if (array.type !== 'ArrayExpression' || !definitions) {
|
|
254
|
+
return {
|
|
255
|
+
problem: 'key.cookies must be an array literal of cookie definitions (`defineCookie`).',
|
|
256
|
+
};
|
|
257
|
+
}
|
|
258
|
+
} else if (entry.key === 'headers') {
|
|
259
|
+
const headers = readHeaderNames(entry.value);
|
|
260
|
+
if ('problem' in headers) return headers;
|
|
261
|
+
result.headers = headers.value;
|
|
262
|
+
} else {
|
|
263
|
+
return {
|
|
264
|
+
problem: `Unknown key "${entry.key}" in key. Allowed: segmentParams, searchParams, cookies, headers.`,
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
return { value: result };
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
const READERS = {
|
|
272
|
+
layout: {
|
|
273
|
+
lifetime: readLifetime,
|
|
274
|
+
key: readKey,
|
|
275
|
+
prerender: readPrerender,
|
|
276
|
+
deferSuspenseFor,
|
|
277
|
+
} satisfies Readers<LayoutOptions>,
|
|
278
|
+
page: {
|
|
279
|
+
lifetime: readLifetime,
|
|
280
|
+
key: readKey,
|
|
281
|
+
prerender: readPrerender,
|
|
282
|
+
deferSuspenseFor,
|
|
283
|
+
} satisfies Readers<PageOptions>,
|
|
284
|
+
};
|
|
285
|
+
|
|
286
|
+
// ─── Object literal ───────────────────────────────────────────────────────
|
|
287
|
+
|
|
288
|
+
type Entry = { key: string; value: Node } | { problem: string };
|
|
289
|
+
|
|
290
|
+
/**
|
|
291
|
+
* The `key: value` entries of an object literal, or a problem per entry that
|
|
292
|
+
* has none. `key: undefined` entries are dropped: they mean "not set".
|
|
293
|
+
*/
|
|
294
|
+
function readProperties(object: Node, label: string): Entry[] {
|
|
295
|
+
return list(object, 'properties').flatMap((prop): Entry[] => {
|
|
296
|
+
if (!isNode(prop) || prop.type === 'SpreadElement') {
|
|
297
|
+
return [{ problem: `${label} cannot use a spread; write every key in the literal.` }];
|
|
298
|
+
}
|
|
299
|
+
if (prop.computed === true) {
|
|
300
|
+
return [{ problem: `${label} cannot use a computed key; write the key name.` }];
|
|
301
|
+
}
|
|
302
|
+
const value = child(prop, 'value');
|
|
303
|
+
const key = nameOf(child(prop, 'key'));
|
|
304
|
+
if (prop.kind !== 'init' || prop.method === true || !value || key === undefined) {
|
|
305
|
+
return [{ problem: `${label} entries must be plain \`key: value\` pairs.` }];
|
|
306
|
+
}
|
|
307
|
+
return isUndefined(value) ? [] : [{ key, value }];
|
|
308
|
+
});
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
function readOptionsObject(init: Node, kind: RouteOptionsKind, problems: string[]) {
|
|
312
|
+
const name = ROUTE_OPTIONS_EXPORT[kind];
|
|
313
|
+
const object = unwrap(init);
|
|
314
|
+
if (object.type !== 'ObjectExpression') {
|
|
315
|
+
problems.push(`${name} must be an object literal: \`export const ${name} = { … }\`.`);
|
|
316
|
+
return undefined;
|
|
317
|
+
}
|
|
318
|
+
const readers: Record<string, (node: Node) => Read<unknown>> = READERS[kind];
|
|
319
|
+
const options: Record<string, unknown> = {};
|
|
320
|
+
for (const entry of readProperties(object, name)) {
|
|
321
|
+
if ('problem' in entry) {
|
|
322
|
+
problems.push(entry.problem);
|
|
323
|
+
continue;
|
|
324
|
+
}
|
|
325
|
+
const reader = Object.hasOwn(readers, entry.key) ? readers[entry.key] : undefined;
|
|
326
|
+
if (!reader) {
|
|
327
|
+
problems.push(
|
|
328
|
+
`Unknown key "${entry.key}" in ${name}. Allowed: ${Object.keys(readers).join(', ')}.`
|
|
329
|
+
);
|
|
330
|
+
continue;
|
|
331
|
+
}
|
|
332
|
+
const read = reader(entry.value);
|
|
333
|
+
if ('problem' in read) problems.push(read.problem);
|
|
334
|
+
else options[entry.key] = read.value;
|
|
335
|
+
}
|
|
336
|
+
return options;
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
// ─── File ─────────────────────────────────────────────────────────────────
|
|
340
|
+
|
|
341
|
+
const NONE: RouteOptionsRead = Object.freeze({ options: undefined, problems: [] });
|
|
342
|
+
|
|
343
|
+
/** Every name the reader reacts to; a file containing none of them is not parsed. */
|
|
344
|
+
const MENTIONS = /Options|prerender|deferSuspenseFor/;
|
|
345
|
+
|
|
346
|
+
/**
|
|
347
|
+
* Read a layout's `layoutOptions` or a page's `pageOptions` from source.
|
|
348
|
+
*
|
|
349
|
+
* A missing or unparseable file reads as no options and no problems: the
|
|
350
|
+
* compiler reports syntax errors, and guessing at a half-written file would
|
|
351
|
+
* misreport it. `.ts` files are parsed as TypeScript, not TSX, so an
|
|
352
|
+
* angle-bracket cast does not hide a file from this check.
|
|
353
|
+
*/
|
|
354
|
+
export function readRouteOptions(filePath: string, kind: RouteOptionsKind): RouteOptionsRead {
|
|
355
|
+
if (!existsSync(filePath)) return NONE;
|
|
356
|
+
const source = readFileCached(filePath);
|
|
357
|
+
// Runs on every page and layout on each rescan; most declare nothing.
|
|
358
|
+
if (!MENTIONS.test(source)) return NONE;
|
|
359
|
+
const program = tryParse(source, /\.[mc]?ts$/.test(filePath) ? 'ts' : 'tsx');
|
|
360
|
+
if (!program) return NONE;
|
|
361
|
+
|
|
362
|
+
const own = ROUTE_OPTIONS_EXPORT[kind];
|
|
363
|
+
const otherKind: RouteOptionsKind = kind === 'page' ? 'layout' : 'page';
|
|
364
|
+
const other = ROUTE_OPTIONS_EXPORT[otherKind];
|
|
365
|
+
const problems: string[] = [];
|
|
366
|
+
let init: Node | undefined;
|
|
367
|
+
|
|
368
|
+
/** An export of a watched name in a form the build cannot read. */
|
|
369
|
+
const report = (name: string | undefined) => {
|
|
370
|
+
if (name === own) {
|
|
371
|
+
problems.push(
|
|
372
|
+
`${own} must be declared in this file as \`export const ${own} = { … } satisfies ${OPTIONS_TYPE[kind]}\`. ` +
|
|
373
|
+
'`let`, destructuring, `export { … }` and re-exports cannot be read at build time.'
|
|
374
|
+
);
|
|
375
|
+
} else if (name === other) {
|
|
376
|
+
problems.push(
|
|
377
|
+
`${other} configures a ${otherKind}; this file is a ${kind}. Use \`export const ${own}\`.`
|
|
378
|
+
);
|
|
379
|
+
} else if (name && (REMOVED_EXPORTS as readonly string[]).includes(name)) {
|
|
380
|
+
problems.push(
|
|
381
|
+
`\`export const ${name}\` was removed. Move it into the options object: ` +
|
|
382
|
+
`\`export const ${own} = { ${name}: … } satisfies ${OPTIONS_TYPE[kind]}\`.`
|
|
383
|
+
);
|
|
384
|
+
}
|
|
385
|
+
};
|
|
386
|
+
const watched = [own, other, ...REMOVED_EXPORTS];
|
|
387
|
+
|
|
388
|
+
for (const stmt of program.body) {
|
|
389
|
+
if (!isNode(stmt) || stmt.exportKind === 'type') continue;
|
|
390
|
+
// `export * as pageOptions from` names an export; bare `export * from` does not.
|
|
391
|
+
if (stmt.type === 'ExportAllDeclaration') report(nameOf(child(stmt, 'exported')));
|
|
392
|
+
if (stmt.type !== 'ExportNamedDeclaration') continue;
|
|
393
|
+
for (const spec of list(stmt, 'specifiers')) {
|
|
394
|
+
if (isNode(spec) && spec.exportKind !== 'type') report(nameOf(child(spec, 'exported')));
|
|
395
|
+
}
|
|
396
|
+
const decl = child(stmt, 'declaration');
|
|
397
|
+
if (!decl) continue;
|
|
398
|
+
if (decl.type !== 'VariableDeclaration') {
|
|
399
|
+
report(nameOf(child(decl, 'id'))); // function or class
|
|
400
|
+
continue;
|
|
401
|
+
}
|
|
402
|
+
for (const declarator of list(decl, 'declarations')) {
|
|
403
|
+
if (!isNode(declarator)) continue;
|
|
404
|
+
const id = child(declarator, 'id');
|
|
405
|
+
const value = child(declarator, 'init');
|
|
406
|
+
if (id?.type !== 'Identifier') {
|
|
407
|
+
for (const name of watched) if (patternBinds(id, name)) report(name);
|
|
408
|
+
} else if (id.name === own && decl.kind === 'const' && value) {
|
|
409
|
+
init = value;
|
|
410
|
+
} else {
|
|
411
|
+
report(nameOf(id));
|
|
412
|
+
}
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
|
|
416
|
+
if (init && isClientModule(program.body)) {
|
|
417
|
+
problems.push(
|
|
418
|
+
`A 'use client' ${kind} cannot declare ${own}: the server sees a client reference, ` +
|
|
419
|
+
`not the object. Move ${own} to a server ${kind} that renders the client component.`
|
|
420
|
+
);
|
|
421
|
+
}
|
|
422
|
+
const options = init ? readOptionsObject(init, kind, problems) : undefined;
|
|
423
|
+
return { options: problems.length === 0 ? options : undefined, problems };
|
|
424
|
+
}
|
|
425
|
+
|
|
426
|
+
/** Whether the module starts with a 'use client' directive. */
|
|
427
|
+
function isClientModule(body: readonly unknown[]): boolean {
|
|
428
|
+
for (const stmt of body) {
|
|
429
|
+
if (
|
|
430
|
+
!isNode(stmt) ||
|
|
431
|
+
stmt.type !== 'ExpressionStatement' ||
|
|
432
|
+
typeof stmt.directive !== 'string'
|
|
433
|
+
) {
|
|
434
|
+
return false;
|
|
435
|
+
}
|
|
436
|
+
if (stmt.directive === 'use client') return true;
|
|
437
|
+
}
|
|
438
|
+
return false;
|
|
439
|
+
}
|
package/src/routing/scanner.ts
CHANGED
|
@@ -369,7 +369,7 @@ function scanChildren(dirPath: string, parentNode: SegmentNode, extSet: Set<stri
|
|
|
369
369
|
// `@children` is the implicit slot a layout's `children` prop fills, and
|
|
370
370
|
// the key of the outlet that carries it (`childrenOutletKey`). A slot
|
|
371
371
|
// directory by that name would claim the same outlet and be rendered in
|
|
372
|
-
// place of the children
|
|
372
|
+
// place of the children.
|
|
373
373
|
if (entry === '@children') {
|
|
374
374
|
throw new Error(
|
|
375
375
|
`Build error: "@children" is reserved and cannot be a slot directory.\n` +
|
|
@@ -150,11 +150,60 @@ export function computeSlotKey(parentSegmentId: string, slotName: string): strin
|
|
|
150
150
|
* The outlet key of a layout's `children`. A layout's own outlet covers its
|
|
151
151
|
* chrome; everything it receives as `children` — this segment's boundaries
|
|
152
152
|
* and metadata collectors, the next segment's access gate, the page — is a
|
|
153
|
-
* separate outlet, so
|
|
154
|
-
*
|
|
155
|
-
*
|
|
156
|
-
* See design/52-segment-hash-dedupe.md §"The unit is the segment's own output".
|
|
153
|
+
* separate outlet, so a skipped 'document' layout never freezes what is under
|
|
154
|
+
* it. Keyed as the implicit `children` slot; the route scanner rejects an
|
|
155
|
+
* `@children` directory. See design/53-segment-lifetime.md §"Skipping".
|
|
157
156
|
*/
|
|
158
157
|
export function childrenOutletKey(segmentId: string): string {
|
|
159
158
|
return computeSlotKey(segmentId, '@children');
|
|
160
159
|
}
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* The outlet keys of `'document'` segments (design/53-segment-lifetime.md
|
|
163
|
+
* §"Skipping"), by the segment's **tree path** — its directory path, route
|
|
164
|
+
* groups and `@slot` directories included. A `'document'` skip is
|
|
165
|
+
* identity-addressed (the client renders what it holds at this key, under a
|
|
166
|
+
* digest bound to it), so the key must name one segment. Segment ids
|
|
167
|
+
* (`computeSegmentKeys`) do not: `(landing)/feed` and `(browse)/feed` both
|
|
168
|
+
* key as `/feed`, which a content-addressed hash skip survives and a digest
|
|
169
|
+
* skip would not.
|
|
170
|
+
*
|
|
171
|
+
* `#` starts a URL fragment, so no routable segment is named with it — the
|
|
172
|
+
* same reason the metadata outlet is `#metadata`. A `'document'` layout's
|
|
173
|
+
* `children` outlet is `childrenOutletKey` of its layout key in a slot; on the
|
|
174
|
+
* main chain it keeps `childrenOutletKey(segmentId)`.
|
|
175
|
+
*/
|
|
176
|
+
export function pageOutletKey(treePath: string): string {
|
|
177
|
+
return `${treePath === '/' ? '' : treePath}/#page`;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** See `pageOutletKey`. */
|
|
181
|
+
export function layoutOutletKey(treePath: string): string {
|
|
182
|
+
return `${treePath === '/' ? '' : treePath}/#layout`;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* The full tree path of a slot's matched chain (or a prefix of it) — the key
|
|
187
|
+
* the ALS slot params map, the generated `getSegmentParams` overloads and a
|
|
188
|
+
* slot's `'document'` outlets all use.
|
|
189
|
+
*
|
|
190
|
+
* Built from the parent's tree path plus each chain node's directory name,
|
|
191
|
+
* so an intercepting node contributes its marker
|
|
192
|
+
* (`/gallery/@modal/(.)photo/[id]`) and a route group contributes its
|
|
193
|
+
* parentheses.
|
|
194
|
+
*
|
|
195
|
+
* One definition for the render path, the eager access path and the outlet
|
|
196
|
+
* keys: they key the same things, and a divergence would silently strand one
|
|
197
|
+
* of them.
|
|
198
|
+
*/
|
|
199
|
+
export function slotChainTreePath(
|
|
200
|
+
chain: ReadonlyArray<{ segmentName?: string }>,
|
|
201
|
+
parentTreePath: string
|
|
202
|
+
): string {
|
|
203
|
+
const slotSuffix = chain
|
|
204
|
+
.map((s) => s.segmentName)
|
|
205
|
+
.filter(Boolean)
|
|
206
|
+
.join('/');
|
|
207
|
+
const prefix = parentTreePath === '/' ? '' : parentTreePath;
|
|
208
|
+
return `${prefix}/${slotSuffix}`;
|
|
209
|
+
}
|
|
@@ -24,6 +24,7 @@ declare module '@vitejs/plugin-rsc/vendor/react-server-dom/server.node' {
|
|
|
24
24
|
onError?: (error: unknown) => string | void;
|
|
25
25
|
identifierPrefix?: string;
|
|
26
26
|
temporaryReferences?: unknown;
|
|
27
|
+
filterStackFrame?: (url: string, functionName: string) => boolean;
|
|
27
28
|
debugChannel?: import('node:stream').Readable | import('node:stream').Writable;
|
|
28
29
|
}
|
|
29
30
|
): { pipe<T extends NodeJS.WritableStream>(destination: T): T; abort(reason?: unknown): void };
|
|
@@ -52,6 +53,9 @@ declare module '@vitejs/plugin-rsc/vendor/react-server-dom/server.edge' {
|
|
|
52
53
|
signal?: AbortSignal;
|
|
53
54
|
onError?: (error: unknown) => string | void;
|
|
54
55
|
onPostpone?: (reason: string) => void;
|
|
56
|
+
temporaryReferences?: unknown;
|
|
57
|
+
identifierPrefix?: string;
|
|
58
|
+
filterStackFrame?: (url: string, functionName: string) => boolean;
|
|
55
59
|
}
|
|
56
60
|
): ReadableStream<Uint8Array>;
|
|
57
61
|
|
|
@@ -71,7 +75,7 @@ declare module '@vitejs/plugin-rsc/vendor/react-server-dom/server.edge' {
|
|
|
71
75
|
exportName: string | null
|
|
72
76
|
): T;
|
|
73
77
|
|
|
74
|
-
// Tests render real client references
|
|
78
|
+
// Tests render real client references the way the
|
|
75
79
|
// use-client transform registers them.
|
|
76
80
|
export function registerClientReference<T>(
|
|
77
81
|
proxyImplementation: T,
|
|
@@ -676,7 +676,7 @@ function buildDefinition<T extends Record<string, unknown>>(
|
|
|
676
676
|
'Use searchParams.useQueryStates() on the client.'
|
|
677
677
|
);
|
|
678
678
|
}
|
|
679
|
-
const raw = getSearchParamsFromAls();
|
|
679
|
+
const raw = getSearchParamsFromAls({ codecs: codecMap, urlKeys });
|
|
680
680
|
return parseSync(raw);
|
|
681
681
|
}
|
|
682
682
|
|
|
@@ -340,25 +340,33 @@ export const prebuiltCaptureAls = getOrCreateAls<PrebuiltCaptureStore>(
|
|
|
340
340
|
Symbol.for('timber:prebuilt-capture-als')
|
|
341
341
|
);
|
|
342
342
|
|
|
343
|
-
// ───
|
|
344
|
-
// Used by: segment-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
*/
|
|
353
|
-
|
|
343
|
+
// ─── 'document' segment read scope ────────────────────────────────────────
|
|
344
|
+
// Used by: segment-lifetime/read-scope.ts (set), request-context.ts and
|
|
345
|
+
// cookie-context.ts (checked by every request-input accessor).
|
|
346
|
+
// Design doc: design/53-segment-lifetime.md §"What a 'document' segment may read"
|
|
347
|
+
|
|
348
|
+
/** The request inputs a `'document'` segment's render may read: its key. */
|
|
349
|
+
export interface DocumentReadScope {
|
|
350
|
+
/** The segment's outlet path, for error messages. */
|
|
351
|
+
segmentPath: string;
|
|
352
|
+
/** Segment param names in the key. */
|
|
353
|
+
params: ReadonlySet<string>;
|
|
354
|
+
/**
|
|
355
|
+
* The fields of the key's search-params definition, each with the codec and
|
|
356
|
+
* URL key it is read through — a field of another definition matches only
|
|
357
|
+
* when both are the same.
|
|
358
|
+
*/
|
|
359
|
+
searchParams: ReadonlyMap<string, { codec: unknown; urlKey: string }>;
|
|
354
360
|
/**
|
|
355
|
-
*
|
|
356
|
-
*
|
|
361
|
+
* The key's cookies, by name, with the codec of the definition the key
|
|
362
|
+
* holds: a keyed cookie may be read only through that definition.
|
|
357
363
|
*/
|
|
358
|
-
|
|
364
|
+
cookies: ReadonlyMap<string, unknown>;
|
|
365
|
+
/** The key's header names, lowercased. */
|
|
366
|
+
headers: ReadonlySet<string>;
|
|
359
367
|
}
|
|
360
368
|
|
|
361
|
-
/** @internal —
|
|
362
|
-
export const
|
|
363
|
-
Symbol.for('timber:
|
|
369
|
+
/** @internal — run and read via segment-lifetime/read-scope.ts */
|
|
370
|
+
export const documentReadScopeAls = getOrCreateAls<DocumentReadScope>(
|
|
371
|
+
Symbol.for('timber:document-read-scope-als')
|
|
364
372
|
);
|