@rangojs/router 0.0.0-experimental.d5d3070a → 0.0.0-experimental.d68257e5
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/AGENTS.md +6 -10
- package/README.md +306 -917
- package/dist/__internal.d.ts +83 -0
- package/dist/__internal.d.ts.map +1 -0
- package/dist/__internal.js +19 -0
- package/dist/__internal.js.map +1 -0
- package/dist/__mocks__/version.d.ts +7 -0
- package/dist/__mocks__/version.d.ts.map +1 -0
- package/dist/__mocks__/version.js +7 -0
- package/dist/__mocks__/version.js.map +1 -0
- package/dist/__tests__/client-href.test.d.ts +2 -0
- package/dist/__tests__/client-href.test.d.ts.map +1 -0
- package/dist/__tests__/client-href.test.js +74 -0
- package/dist/__tests__/client-href.test.js.map +1 -0
- package/dist/__tests__/component-utils.test.d.ts +2 -0
- package/dist/__tests__/component-utils.test.d.ts.map +1 -0
- package/dist/__tests__/component-utils.test.js +51 -0
- package/dist/__tests__/component-utils.test.js.map +1 -0
- package/dist/__tests__/event-controller.test.d.ts +2 -0
- package/dist/__tests__/event-controller.test.d.ts.map +1 -0
- package/dist/__tests__/event-controller.test.js +538 -0
- package/dist/__tests__/event-controller.test.js.map +1 -0
- package/dist/__tests__/helpers/route-tree.d.ts +118 -0
- package/dist/__tests__/helpers/route-tree.d.ts.map +1 -0
- package/dist/__tests__/helpers/route-tree.js +374 -0
- package/dist/__tests__/helpers/route-tree.js.map +1 -0
- package/dist/__tests__/match-result.test.d.ts +2 -0
- package/dist/__tests__/match-result.test.d.ts.map +1 -0
- package/dist/__tests__/match-result.test.js +154 -0
- package/dist/__tests__/match-result.test.js.map +1 -0
- package/dist/__tests__/navigation-store.test.d.ts +2 -0
- package/dist/__tests__/navigation-store.test.d.ts.map +1 -0
- package/dist/__tests__/navigation-store.test.js +440 -0
- package/dist/__tests__/navigation-store.test.js.map +1 -0
- package/dist/__tests__/partial-update.test.d.ts +2 -0
- package/dist/__tests__/partial-update.test.d.ts.map +1 -0
- package/dist/__tests__/partial-update.test.js +1009 -0
- package/dist/__tests__/partial-update.test.js.map +1 -0
- package/dist/__tests__/reverse-types.test.d.ts +8 -0
- package/dist/__tests__/reverse-types.test.d.ts.map +1 -0
- package/dist/__tests__/reverse-types.test.js +656 -0
- package/dist/__tests__/reverse-types.test.js.map +1 -0
- package/dist/__tests__/route-definition.test.d.ts +2 -0
- package/dist/__tests__/route-definition.test.d.ts.map +1 -0
- package/dist/__tests__/route-definition.test.js +55 -0
- package/dist/__tests__/route-definition.test.js.map +1 -0
- package/dist/__tests__/router-helpers.test.d.ts +2 -0
- package/dist/__tests__/router-helpers.test.d.ts.map +1 -0
- package/dist/__tests__/router-helpers.test.js +377 -0
- package/dist/__tests__/router-helpers.test.js.map +1 -0
- package/dist/__tests__/router-integration-2.test.d.ts +2 -0
- package/dist/__tests__/router-integration-2.test.d.ts.map +1 -0
- package/dist/__tests__/router-integration-2.test.js +426 -0
- package/dist/__tests__/router-integration-2.test.js.map +1 -0
- package/dist/__tests__/router-integration.test.d.ts +2 -0
- package/dist/__tests__/router-integration.test.d.ts.map +1 -0
- package/dist/__tests__/router-integration.test.js +1051 -0
- package/dist/__tests__/router-integration.test.js.map +1 -0
- package/dist/__tests__/search-params.test.d.ts +5 -0
- package/dist/__tests__/search-params.test.d.ts.map +1 -0
- package/dist/__tests__/search-params.test.js +306 -0
- package/dist/__tests__/search-params.test.js.map +1 -0
- package/dist/__tests__/segment-system.test.d.ts +2 -0
- package/dist/__tests__/segment-system.test.d.ts.map +1 -0
- package/dist/__tests__/segment-system.test.js +627 -0
- package/dist/__tests__/segment-system.test.js.map +1 -0
- package/dist/__tests__/static-handler-types.test.d.ts +8 -0
- package/dist/__tests__/static-handler-types.test.d.ts.map +1 -0
- package/dist/__tests__/static-handler-types.test.js +63 -0
- package/dist/__tests__/static-handler-types.test.js.map +1 -0
- package/dist/__tests__/urls.test.d.ts +2 -0
- package/dist/__tests__/urls.test.d.ts.map +1 -0
- package/dist/__tests__/urls.test.js +421 -0
- package/dist/__tests__/urls.test.js.map +1 -0
- package/dist/__tests__/use-mount.test.d.ts +2 -0
- package/dist/__tests__/use-mount.test.d.ts.map +1 -0
- package/dist/__tests__/use-mount.test.js +35 -0
- package/dist/__tests__/use-mount.test.js.map +1 -0
- package/dist/bin/rango.d.ts +2 -0
- package/dist/bin/rango.d.ts.map +1 -0
- package/dist/bin/rango.js +625 -190
- package/dist/bin/rango.js.map +1 -0
- package/dist/browser/event-controller.d.ts +191 -0
- package/dist/browser/event-controller.d.ts.map +1 -0
- package/dist/browser/event-controller.js +559 -0
- package/dist/browser/event-controller.js.map +1 -0
- package/dist/browser/index.d.ts +2 -0
- package/dist/browser/index.d.ts.map +1 -0
- package/dist/browser/index.js +14 -0
- package/dist/browser/index.js.map +1 -0
- package/dist/browser/link-interceptor.d.ts +38 -0
- package/dist/browser/link-interceptor.d.ts.map +1 -0
- package/dist/browser/link-interceptor.js +99 -0
- package/dist/browser/link-interceptor.js.map +1 -0
- package/dist/browser/logging.d.ts +10 -0
- package/dist/browser/logging.d.ts.map +1 -0
- package/dist/browser/logging.js +29 -0
- package/dist/browser/logging.js.map +1 -0
- package/dist/browser/lru-cache.d.ts +17 -0
- package/dist/browser/lru-cache.d.ts.map +1 -0
- package/dist/browser/lru-cache.js +50 -0
- package/dist/browser/lru-cache.js.map +1 -0
- package/dist/browser/merge-segment-loaders.d.ts +39 -0
- package/dist/browser/merge-segment-loaders.d.ts.map +1 -0
- package/dist/browser/merge-segment-loaders.js +102 -0
- package/dist/browser/merge-segment-loaders.js.map +1 -0
- package/dist/browser/navigation-bridge.d.ts +102 -0
- package/dist/browser/navigation-bridge.d.ts.map +1 -0
- package/dist/browser/navigation-bridge.js +708 -0
- package/dist/browser/navigation-bridge.js.map +1 -0
- package/dist/browser/navigation-client.d.ts +25 -0
- package/dist/browser/navigation-client.d.ts.map +1 -0
- package/dist/browser/navigation-client.js +157 -0
- package/dist/browser/navigation-client.js.map +1 -0
- package/dist/browser/navigation-store.d.ts +101 -0
- package/dist/browser/navigation-store.d.ts.map +1 -0
- package/dist/browser/navigation-store.js +625 -0
- package/dist/browser/navigation-store.js.map +1 -0
- package/dist/browser/partial-update.d.ts +75 -0
- package/dist/browser/partial-update.d.ts.map +1 -0
- package/dist/browser/partial-update.js +426 -0
- package/dist/browser/partial-update.js.map +1 -0
- package/dist/browser/react/Link.d.ts +86 -0
- package/dist/browser/react/Link.d.ts.map +1 -0
- package/dist/browser/react/Link.js +128 -0
- package/dist/browser/react/Link.js.map +1 -0
- package/dist/browser/react/NavigationProvider.d.ts +63 -0
- package/dist/browser/react/NavigationProvider.d.ts.map +1 -0
- package/dist/browser/react/NavigationProvider.js +216 -0
- package/dist/browser/react/NavigationProvider.js.map +1 -0
- package/dist/browser/react/ScrollRestoration.d.ts +75 -0
- package/dist/browser/react/ScrollRestoration.d.ts.map +1 -0
- package/dist/browser/react/ScrollRestoration.js +57 -0
- package/dist/browser/react/ScrollRestoration.js.map +1 -0
- package/dist/browser/react/context.d.ts +46 -0
- package/dist/browser/react/context.d.ts.map +1 -0
- package/dist/browser/react/context.js +10 -0
- package/dist/browser/react/context.js.map +1 -0
- package/dist/browser/react/index.d.ts +11 -0
- package/dist/browser/react/index.d.ts.map +1 -0
- package/dist/browser/react/index.js +22 -0
- package/dist/browser/react/index.js.map +1 -0
- package/dist/browser/react/location-state-shared.d.ts +63 -0
- package/dist/browser/react/location-state-shared.d.ts.map +1 -0
- package/dist/browser/react/location-state-shared.js +81 -0
- package/dist/browser/react/location-state-shared.js.map +1 -0
- package/dist/browser/react/location-state.d.ts +23 -0
- package/dist/browser/react/location-state.d.ts.map +1 -0
- package/dist/browser/react/location-state.js +29 -0
- package/dist/browser/react/location-state.js.map +1 -0
- package/dist/browser/react/mount-context.d.ts +24 -0
- package/dist/browser/react/mount-context.d.ts.map +1 -0
- package/dist/browser/react/mount-context.js +24 -0
- package/dist/browser/react/mount-context.js.map +1 -0
- package/dist/browser/react/use-action.d.ts +64 -0
- package/dist/browser/react/use-action.d.ts.map +1 -0
- package/dist/browser/react/use-action.js +134 -0
- package/dist/browser/react/use-action.js.map +1 -0
- package/dist/browser/react/use-client-cache.d.ts +41 -0
- package/dist/browser/react/use-client-cache.d.ts.map +1 -0
- package/dist/browser/react/use-client-cache.js +39 -0
- package/dist/browser/react/use-client-cache.js.map +1 -0
- package/dist/browser/react/use-handle.d.ts +31 -0
- package/dist/browser/react/use-handle.d.ts.map +1 -0
- package/dist/browser/react/use-handle.js +144 -0
- package/dist/browser/react/use-handle.js.map +1 -0
- package/dist/browser/react/use-href.d.ts +33 -0
- package/dist/browser/react/use-href.d.ts.map +1 -0
- package/dist/browser/react/use-href.js +39 -0
- package/dist/browser/react/use-href.js.map +1 -0
- package/dist/browser/react/use-link-status.d.ts +37 -0
- package/dist/browser/react/use-link-status.d.ts.map +1 -0
- package/dist/browser/react/use-link-status.js +99 -0
- package/dist/browser/react/use-link-status.js.map +1 -0
- package/dist/browser/react/use-mount.d.ts +25 -0
- package/dist/browser/react/use-mount.d.ts.map +1 -0
- package/dist/browser/react/use-mount.js +30 -0
- package/dist/browser/react/use-mount.js.map +1 -0
- package/dist/browser/react/use-navigation.d.ts +27 -0
- package/dist/browser/react/use-navigation.d.ts.map +1 -0
- package/dist/browser/react/use-navigation.js +87 -0
- package/dist/browser/react/use-navigation.js.map +1 -0
- package/dist/browser/react/use-segments.d.ts +38 -0
- package/dist/browser/react/use-segments.d.ts.map +1 -0
- package/dist/browser/react/use-segments.js +130 -0
- package/dist/browser/react/use-segments.js.map +1 -0
- package/dist/browser/request-controller.d.ts +26 -0
- package/dist/browser/request-controller.d.ts.map +1 -0
- package/dist/browser/request-controller.js +147 -0
- package/dist/browser/request-controller.js.map +1 -0
- package/dist/browser/rsc-router.d.ts +129 -0
- package/dist/browser/rsc-router.d.ts.map +1 -0
- package/dist/browser/rsc-router.js +195 -0
- package/dist/browser/rsc-router.js.map +1 -0
- package/dist/browser/scroll-restoration.d.ts +93 -0
- package/dist/browser/scroll-restoration.d.ts.map +1 -0
- package/dist/browser/scroll-restoration.js +321 -0
- package/dist/browser/scroll-restoration.js.map +1 -0
- package/dist/browser/segment-structure-assert.d.ts +17 -0
- package/dist/browser/segment-structure-assert.d.ts.map +1 -0
- package/dist/browser/segment-structure-assert.js +59 -0
- package/dist/browser/segment-structure-assert.js.map +1 -0
- package/dist/browser/server-action-bridge.d.ts +26 -0
- package/dist/browser/server-action-bridge.d.ts.map +1 -0
- package/dist/browser/server-action-bridge.js +668 -0
- package/dist/browser/server-action-bridge.js.map +1 -0
- package/dist/browser/shallow.d.ts +12 -0
- package/dist/browser/shallow.d.ts.map +1 -0
- package/dist/browser/shallow.js +34 -0
- package/dist/browser/shallow.js.map +1 -0
- package/dist/browser/types.d.ts +369 -0
- package/dist/browser/types.d.ts.map +1 -0
- package/dist/browser/types.js +2 -0
- package/dist/browser/types.js.map +1 -0
- package/dist/build/__tests__/generate-cli.test.d.ts +2 -0
- package/dist/build/__tests__/generate-cli.test.d.ts.map +1 -0
- package/dist/build/__tests__/generate-cli.test.js +237 -0
- package/dist/build/__tests__/generate-cli.test.js.map +1 -0
- package/dist/build/__tests__/generate-manifest.test.d.ts +2 -0
- package/dist/build/__tests__/generate-manifest.test.d.ts.map +1 -0
- package/dist/build/__tests__/generate-manifest.test.js +119 -0
- package/dist/build/__tests__/generate-manifest.test.js.map +1 -0
- package/dist/build/__tests__/generate-route-types.test.d.ts +2 -0
- package/dist/build/__tests__/generate-route-types.test.d.ts.map +1 -0
- package/dist/build/__tests__/generate-route-types.test.js +620 -0
- package/dist/build/__tests__/generate-route-types.test.js.map +1 -0
- package/dist/build/__tests__/per-router-manifest.test.d.ts +2 -0
- package/dist/build/__tests__/per-router-manifest.test.d.ts.map +1 -0
- package/dist/build/__tests__/per-router-manifest.test.js +308 -0
- package/dist/build/__tests__/per-router-manifest.test.js.map +1 -0
- package/dist/build/generate-manifest.d.ts +81 -0
- package/dist/build/generate-manifest.d.ts.map +1 -0
- package/dist/build/generate-manifest.js +276 -0
- package/dist/build/generate-manifest.js.map +1 -0
- package/dist/build/generate-route-types.d.ts +115 -0
- package/dist/build/generate-route-types.d.ts.map +1 -0
- package/dist/build/generate-route-types.js +740 -0
- package/dist/build/generate-route-types.js.map +1 -0
- package/dist/build/index.d.ts +21 -0
- package/dist/build/index.d.ts.map +1 -0
- package/dist/build/index.js +21 -0
- package/dist/build/index.js.map +1 -0
- package/dist/build/route-trie.d.ts +71 -0
- package/dist/build/route-trie.d.ts.map +1 -0
- package/dist/build/route-trie.js +175 -0
- package/dist/build/route-trie.js.map +1 -0
- package/dist/cache/__tests__/cache-scope.test.d.ts +2 -0
- package/dist/cache/__tests__/cache-scope.test.d.ts.map +1 -0
- package/dist/cache/__tests__/cache-scope.test.js +208 -0
- package/dist/cache/__tests__/cache-scope.test.js.map +1 -0
- package/dist/cache/__tests__/document-cache.test.d.ts +2 -0
- package/dist/cache/__tests__/document-cache.test.d.ts.map +1 -0
- package/dist/cache/__tests__/document-cache.test.js +345 -0
- package/dist/cache/__tests__/document-cache.test.js.map +1 -0
- package/dist/cache/__tests__/memory-segment-store.test.d.ts +2 -0
- package/dist/cache/__tests__/memory-segment-store.test.d.ts.map +1 -0
- package/dist/cache/__tests__/memory-segment-store.test.js +425 -0
- package/dist/cache/__tests__/memory-segment-store.test.js.map +1 -0
- package/dist/cache/__tests__/memory-store.test.d.ts +2 -0
- package/dist/cache/__tests__/memory-store.test.d.ts.map +1 -0
- package/dist/cache/__tests__/memory-store.test.js +367 -0
- package/dist/cache/__tests__/memory-store.test.js.map +1 -0
- package/dist/cache/cache-scope.d.ts +102 -0
- package/dist/cache/cache-scope.d.ts.map +1 -0
- package/dist/cache/cache-scope.js +440 -0
- package/dist/cache/cache-scope.js.map +1 -0
- package/dist/cache/cf/__tests__/cf-cache-store.test.d.ts +2 -0
- package/dist/cache/cf/__tests__/cf-cache-store.test.d.ts.map +1 -0
- package/dist/cache/cf/__tests__/cf-cache-store.test.js +330 -0
- package/dist/cache/cf/__tests__/cf-cache-store.test.js.map +1 -0
- package/dist/cache/cf/cf-cache-store.d.ts +165 -0
- package/dist/cache/cf/cf-cache-store.d.ts.map +1 -0
- package/dist/cache/cf/cf-cache-store.js +242 -0
- package/dist/cache/cf/cf-cache-store.js.map +1 -0
- package/dist/cache/cf/index.d.ts +14 -0
- package/dist/cache/cf/index.d.ts.map +1 -0
- package/dist/cache/cf/index.js +17 -0
- package/dist/cache/cf/index.js.map +1 -0
- package/dist/cache/document-cache.d.ts +64 -0
- package/dist/cache/document-cache.d.ts.map +1 -0
- package/dist/cache/document-cache.js +228 -0
- package/dist/cache/document-cache.js.map +1 -0
- package/dist/cache/index.d.ts +19 -0
- package/dist/cache/index.d.ts.map +1 -0
- package/dist/cache/index.js +21 -0
- package/dist/cache/index.js.map +1 -0
- package/dist/cache/memory-segment-store.d.ts +110 -0
- package/dist/cache/memory-segment-store.d.ts.map +1 -0
- package/dist/cache/memory-segment-store.js +117 -0
- package/dist/cache/memory-segment-store.js.map +1 -0
- package/dist/cache/memory-store.d.ts +41 -0
- package/dist/cache/memory-store.d.ts.map +1 -0
- package/dist/cache/memory-store.js +191 -0
- package/dist/cache/memory-store.js.map +1 -0
- package/dist/cache/types.d.ts +317 -0
- package/dist/cache/types.d.ts.map +1 -0
- package/dist/cache/types.js +12 -0
- package/dist/cache/types.js.map +1 -0
- package/dist/client.d.ts +248 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +367 -0
- package/dist/client.js.map +1 -0
- package/dist/client.rsc.d.ts +26 -0
- package/dist/client.rsc.d.ts.map +1 -0
- package/dist/client.rsc.js +46 -0
- package/dist/client.rsc.js.map +1 -0
- package/dist/component-utils.d.ts +36 -0
- package/dist/component-utils.d.ts.map +1 -0
- package/dist/component-utils.js +61 -0
- package/dist/component-utils.js.map +1 -0
- package/dist/components/DefaultDocument.d.ts +13 -0
- package/dist/components/DefaultDocument.d.ts.map +1 -0
- package/dist/components/DefaultDocument.js +15 -0
- package/dist/components/DefaultDocument.js.map +1 -0
- package/dist/debug.d.ts +58 -0
- package/dist/debug.d.ts.map +1 -0
- package/dist/debug.js +157 -0
- package/dist/debug.js.map +1 -0
- package/dist/default-error-boundary.d.ts +11 -0
- package/dist/default-error-boundary.d.ts.map +1 -0
- package/dist/default-error-boundary.js +45 -0
- package/dist/default-error-boundary.js.map +1 -0
- package/dist/deps/browser.d.ts +2 -0
- package/dist/deps/browser.d.ts.map +1 -0
- package/dist/deps/browser.js +3 -0
- package/dist/deps/browser.js.map +1 -0
- package/dist/deps/html-stream-client.d.ts +2 -0
- package/dist/deps/html-stream-client.d.ts.map +1 -0
- package/dist/deps/html-stream-client.js +3 -0
- package/dist/deps/html-stream-client.js.map +1 -0
- package/dist/deps/html-stream-server.d.ts +2 -0
- package/dist/deps/html-stream-server.d.ts.map +1 -0
- package/dist/deps/html-stream-server.js +3 -0
- package/dist/deps/html-stream-server.js.map +1 -0
- package/dist/deps/rsc.d.ts +2 -0
- package/dist/deps/rsc.d.ts.map +1 -0
- package/dist/deps/rsc.js +4 -0
- package/dist/deps/rsc.js.map +1 -0
- package/dist/deps/ssr.d.ts +2 -0
- package/dist/deps/ssr.d.ts.map +1 -0
- package/dist/deps/ssr.js +3 -0
- package/dist/deps/ssr.js.map +1 -0
- package/dist/errors.d.ts +174 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +241 -0
- package/dist/errors.js.map +1 -0
- package/dist/handle.d.ts +78 -0
- package/dist/handle.d.ts.map +1 -0
- package/dist/handle.js +82 -0
- package/dist/handle.js.map +1 -0
- package/dist/handles/MetaTags.d.ts +14 -0
- package/dist/handles/MetaTags.d.ts.map +1 -0
- package/dist/handles/MetaTags.js +136 -0
- package/dist/handles/MetaTags.js.map +1 -0
- package/dist/handles/index.d.ts +6 -0
- package/dist/handles/index.d.ts.map +1 -0
- package/dist/handles/index.js +6 -0
- package/dist/handles/index.js.map +1 -0
- package/dist/handles/meta.d.ts +39 -0
- package/dist/handles/meta.d.ts.map +1 -0
- package/dist/handles/meta.js +202 -0
- package/dist/handles/meta.js.map +1 -0
- package/dist/host/__tests__/errors.test.d.ts +2 -0
- package/dist/host/__tests__/errors.test.d.ts.map +1 -0
- package/dist/host/__tests__/errors.test.js +76 -0
- package/dist/host/__tests__/errors.test.js.map +1 -0
- package/dist/host/__tests__/pattern-comprehensive.test.d.ts +2 -0
- package/dist/host/__tests__/pattern-comprehensive.test.d.ts.map +1 -0
- package/dist/host/__tests__/pattern-comprehensive.test.js +732 -0
- package/dist/host/__tests__/pattern-comprehensive.test.js.map +1 -0
- package/dist/host/__tests__/pattern-matcher.test.d.ts +2 -0
- package/dist/host/__tests__/pattern-matcher.test.d.ts.map +1 -0
- package/dist/host/__tests__/pattern-matcher.test.js +251 -0
- package/dist/host/__tests__/pattern-matcher.test.js.map +1 -0
- package/dist/host/__tests__/router.test.d.ts +2 -0
- package/dist/host/__tests__/router.test.d.ts.map +1 -0
- package/dist/host/__tests__/router.test.js +241 -0
- package/dist/host/__tests__/router.test.js.map +1 -0
- package/dist/host/__tests__/testing.test.d.ts +2 -0
- package/dist/host/__tests__/testing.test.d.ts.map +1 -0
- package/dist/host/__tests__/testing.test.js +64 -0
- package/dist/host/__tests__/testing.test.js.map +1 -0
- package/dist/host/__tests__/utils.test.d.ts +2 -0
- package/dist/host/__tests__/utils.test.d.ts.map +1 -0
- package/dist/host/__tests__/utils.test.js +29 -0
- package/dist/host/__tests__/utils.test.js.map +1 -0
- package/dist/host/cookie-handler.d.ts +34 -0
- package/dist/host/cookie-handler.d.ts.map +1 -0
- package/dist/host/cookie-handler.js +124 -0
- package/dist/host/cookie-handler.js.map +1 -0
- package/dist/host/errors.d.ts +56 -0
- package/dist/host/errors.d.ts.map +1 -0
- package/dist/host/errors.js +79 -0
- package/dist/host/errors.js.map +1 -0
- package/dist/host/index.d.ts +29 -0
- package/dist/host/index.d.ts.map +1 -0
- package/dist/host/index.js +32 -0
- package/dist/host/index.js.map +1 -0
- package/dist/host/pattern-matcher.d.ts +36 -0
- package/dist/host/pattern-matcher.d.ts.map +1 -0
- package/dist/host/pattern-matcher.js +172 -0
- package/dist/host/pattern-matcher.js.map +1 -0
- package/dist/host/router.d.ts +26 -0
- package/dist/host/router.d.ts.map +1 -0
- package/dist/host/router.js +218 -0
- package/dist/host/router.js.map +1 -0
- package/dist/host/testing.d.ts +36 -0
- package/dist/host/testing.d.ts.map +1 -0
- package/dist/host/testing.js +55 -0
- package/dist/host/testing.js.map +1 -0
- package/dist/host/types.d.ts +115 -0
- package/dist/host/types.d.ts.map +1 -0
- package/dist/host/types.js +7 -0
- package/dist/host/types.js.map +1 -0
- package/dist/host/utils.d.ts +21 -0
- package/dist/host/utils.d.ts.map +1 -0
- package/dist/host/utils.js +23 -0
- package/dist/host/utils.js.map +1 -0
- package/dist/href-client.d.ts +131 -0
- package/dist/href-client.d.ts.map +1 -0
- package/dist/href-client.js +64 -0
- package/dist/href-client.js.map +1 -0
- package/dist/href-context.d.ts +29 -0
- package/dist/href-context.d.ts.map +1 -0
- package/dist/href-context.js +21 -0
- package/dist/href-context.js.map +1 -0
- package/dist/index.d.ts +73 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +91 -0
- package/dist/index.js.map +1 -0
- package/dist/index.rsc.d.ts +32 -0
- package/dist/index.rsc.d.ts.map +1 -0
- package/dist/index.rsc.js +40 -0
- package/dist/index.rsc.js.map +1 -0
- package/dist/internal-debug.d.ts +2 -0
- package/dist/internal-debug.d.ts.map +1 -0
- package/dist/internal-debug.js +5 -0
- package/dist/internal-debug.js.map +1 -0
- package/dist/loader.d.ts +14 -0
- package/dist/loader.d.ts.map +1 -0
- package/dist/loader.js +20 -0
- package/dist/loader.js.map +1 -0
- package/dist/loader.rsc.d.ts +19 -0
- package/dist/loader.rsc.d.ts.map +1 -0
- package/dist/loader.rsc.js +99 -0
- package/dist/loader.rsc.js.map +1 -0
- package/dist/network-error-thrower.d.ts +17 -0
- package/dist/network-error-thrower.d.ts.map +1 -0
- package/dist/network-error-thrower.js +14 -0
- package/dist/network-error-thrower.js.map +1 -0
- package/dist/outlet-context.d.ts +13 -0
- package/dist/outlet-context.d.ts.map +1 -0
- package/dist/outlet-context.js +3 -0
- package/dist/outlet-context.js.map +1 -0
- package/dist/prerender/__tests__/param-hash.test.d.ts +2 -0
- package/dist/prerender/__tests__/param-hash.test.d.ts.map +1 -0
- package/dist/prerender/__tests__/param-hash.test.js +148 -0
- package/dist/prerender/__tests__/param-hash.test.js.map +1 -0
- package/dist/prerender/param-hash.d.ts +16 -0
- package/dist/prerender/param-hash.d.ts.map +1 -0
- package/dist/prerender/param-hash.js +36 -0
- package/dist/prerender/param-hash.js.map +1 -0
- package/dist/prerender/store.d.ts +38 -0
- package/dist/prerender/store.d.ts.map +1 -0
- package/dist/prerender/store.js +61 -0
- package/dist/prerender/store.js.map +1 -0
- package/dist/prerender.d.ts +66 -0
- package/dist/prerender.d.ts.map +1 -0
- package/dist/prerender.js +57 -0
- package/dist/prerender.js.map +1 -0
- package/dist/reverse.d.ts +196 -0
- package/dist/reverse.d.ts.map +1 -0
- package/dist/reverse.js +78 -0
- package/dist/reverse.js.map +1 -0
- package/dist/root-error-boundary.d.ts +33 -0
- package/dist/root-error-boundary.d.ts.map +1 -0
- package/dist/root-error-boundary.js +165 -0
- package/dist/root-error-boundary.js.map +1 -0
- package/dist/route-content-wrapper.d.ts +46 -0
- package/dist/route-content-wrapper.d.ts.map +1 -0
- package/dist/route-content-wrapper.js +77 -0
- package/dist/route-content-wrapper.js.map +1 -0
- package/dist/route-definition.d.ts +421 -0
- package/dist/route-definition.d.ts.map +1 -0
- package/dist/route-definition.js +868 -0
- package/dist/route-definition.js.map +1 -0
- package/dist/route-map-builder.d.ts +155 -0
- package/dist/route-map-builder.d.ts.map +1 -0
- package/dist/route-map-builder.js +237 -0
- package/dist/route-map-builder.js.map +1 -0
- package/dist/route-types.d.ts +165 -0
- package/dist/route-types.d.ts.map +1 -0
- package/dist/route-types.js +7 -0
- package/dist/route-types.js.map +1 -0
- package/dist/router/__tests__/handler-context.test.d.ts +2 -0
- package/dist/router/__tests__/handler-context.test.d.ts.map +1 -0
- package/dist/router/__tests__/handler-context.test.js +65 -0
- package/dist/router/__tests__/handler-context.test.js.map +1 -0
- package/dist/router/__tests__/loader-cycle-detection.test.d.ts +2 -0
- package/dist/router/__tests__/loader-cycle-detection.test.d.ts.map +1 -0
- package/dist/router/__tests__/loader-cycle-detection.test.js +221 -0
- package/dist/router/__tests__/loader-cycle-detection.test.js.map +1 -0
- package/dist/router/__tests__/match-context.test.d.ts +2 -0
- package/dist/router/__tests__/match-context.test.d.ts.map +1 -0
- package/dist/router/__tests__/match-context.test.js +92 -0
- package/dist/router/__tests__/match-context.test.js.map +1 -0
- package/dist/router/__tests__/match-pipelines.test.d.ts +2 -0
- package/dist/router/__tests__/match-pipelines.test.d.ts.map +1 -0
- package/dist/router/__tests__/match-pipelines.test.js +417 -0
- package/dist/router/__tests__/match-pipelines.test.js.map +1 -0
- package/dist/router/__tests__/match-result.test.d.ts +2 -0
- package/dist/router/__tests__/match-result.test.d.ts.map +1 -0
- package/dist/router/__tests__/match-result.test.js +457 -0
- package/dist/router/__tests__/match-result.test.js.map +1 -0
- package/dist/router/__tests__/on-error.test.d.ts +2 -0
- package/dist/router/__tests__/on-error.test.d.ts.map +1 -0
- package/dist/router/__tests__/on-error.test.js +678 -0
- package/dist/router/__tests__/on-error.test.js.map +1 -0
- package/dist/router/__tests__/pattern-matching.test.d.ts +2 -0
- package/dist/router/__tests__/pattern-matching.test.d.ts.map +1 -0
- package/dist/router/__tests__/pattern-matching.test.js +629 -0
- package/dist/router/__tests__/pattern-matching.test.js.map +1 -0
- package/dist/router/__tests__/segment-resolution-parallel-loading.test.d.ts +2 -0
- package/dist/router/__tests__/segment-resolution-parallel-loading.test.d.ts.map +1 -0
- package/dist/router/__tests__/segment-resolution-parallel-loading.test.js +155 -0
- package/dist/router/__tests__/segment-resolution-parallel-loading.test.js.map +1 -0
- package/dist/router/error-handling.d.ts +77 -0
- package/dist/router/error-handling.d.ts.map +1 -0
- package/dist/router/error-handling.js +202 -0
- package/dist/router/error-handling.js.map +1 -0
- package/dist/router/handler-context.d.ts +20 -0
- package/dist/router/handler-context.d.ts.map +1 -0
- package/dist/router/handler-context.js +198 -0
- package/dist/router/handler-context.js.map +1 -0
- package/dist/router/intercept-resolution.d.ts +66 -0
- package/dist/router/intercept-resolution.d.ts.map +1 -0
- package/dist/router/intercept-resolution.js +246 -0
- package/dist/router/intercept-resolution.js.map +1 -0
- package/dist/router/loader-resolution.d.ts +64 -0
- package/dist/router/loader-resolution.d.ts.map +1 -0
- package/dist/router/loader-resolution.js +284 -0
- package/dist/router/loader-resolution.js.map +1 -0
- package/dist/router/logging.d.ts +15 -0
- package/dist/router/logging.d.ts.map +1 -0
- package/dist/router/logging.js +99 -0
- package/dist/router/logging.js.map +1 -0
- package/dist/router/manifest.d.ts +22 -0
- package/dist/router/manifest.d.ts.map +1 -0
- package/dist/router/manifest.js +181 -0
- package/dist/router/manifest.js.map +1 -0
- package/dist/router/match-api.d.ts +35 -0
- package/dist/router/match-api.d.ts.map +1 -0
- package/dist/router/match-api.js +406 -0
- package/dist/router/match-api.js.map +1 -0
- package/dist/router/match-context.d.ts +206 -0
- package/dist/router/match-context.d.ts.map +1 -0
- package/dist/router/match-context.js +17 -0
- package/dist/router/match-context.js.map +1 -0
- package/dist/router/match-middleware/background-revalidation.d.ts +127 -0
- package/dist/router/match-middleware/background-revalidation.d.ts.map +1 -0
- package/dist/router/match-middleware/background-revalidation.js +75 -0
- package/dist/router/match-middleware/background-revalidation.js.map +1 -0
- package/dist/router/match-middleware/cache-lookup.d.ts +112 -0
- package/dist/router/match-middleware/cache-lookup.d.ts.map +1 -0
- package/dist/router/match-middleware/cache-lookup.js +257 -0
- package/dist/router/match-middleware/cache-lookup.js.map +1 -0
- package/dist/router/match-middleware/cache-store.d.ts +113 -0
- package/dist/router/match-middleware/cache-store.d.ts.map +1 -0
- package/dist/router/match-middleware/cache-store.js +108 -0
- package/dist/router/match-middleware/cache-store.js.map +1 -0
- package/dist/router/match-middleware/index.d.ts +81 -0
- package/dist/router/match-middleware/index.d.ts.map +1 -0
- package/dist/router/match-middleware/index.js +80 -0
- package/dist/router/match-middleware/index.js.map +1 -0
- package/dist/router/match-middleware/intercept-resolution.d.ts +117 -0
- package/dist/router/match-middleware/intercept-resolution.d.ts.map +1 -0
- package/dist/router/match-middleware/intercept-resolution.js +134 -0
- package/dist/router/match-middleware/intercept-resolution.js.map +1 -0
- package/dist/router/match-middleware/segment-resolution.d.ts +99 -0
- package/dist/router/match-middleware/segment-resolution.d.ts.map +1 -0
- package/dist/router/match-middleware/segment-resolution.js +53 -0
- package/dist/router/match-middleware/segment-resolution.js.map +1 -0
- package/dist/router/match-pipelines.d.ts +147 -0
- package/dist/router/match-pipelines.d.ts.map +1 -0
- package/dist/router/match-pipelines.js +82 -0
- package/dist/router/match-pipelines.js.map +1 -0
- package/dist/router/match-result.d.ts +126 -0
- package/dist/router/match-result.d.ts.map +1 -0
- package/dist/router/match-result.js +93 -0
- package/dist/router/match-result.js.map +1 -0
- package/dist/router/metrics.d.ts +20 -0
- package/dist/router/metrics.d.ts.map +1 -0
- package/dist/router/metrics.js +47 -0
- package/dist/router/metrics.js.map +1 -0
- package/dist/router/middleware.d.ts +249 -0
- package/dist/router/middleware.d.ts.map +1 -0
- package/dist/router/middleware.js +434 -0
- package/dist/router/middleware.js.map +1 -0
- package/dist/router/middleware.test.d.ts +2 -0
- package/dist/router/middleware.test.d.ts.map +1 -0
- package/dist/router/middleware.test.js +816 -0
- package/dist/router/middleware.test.js.map +1 -0
- package/dist/router/pattern-matching.d.ts +149 -0
- package/dist/router/pattern-matching.d.ts.map +1 -0
- package/dist/router/pattern-matching.js +349 -0
- package/dist/router/pattern-matching.js.map +1 -0
- package/dist/router/revalidation.d.ts +44 -0
- package/dist/router/revalidation.d.ts.map +1 -0
- package/dist/router/revalidation.js +147 -0
- package/dist/router/revalidation.js.map +1 -0
- package/dist/router/router-context.d.ts +135 -0
- package/dist/router/router-context.d.ts.map +1 -0
- package/dist/router/router-context.js +36 -0
- package/dist/router/router-context.js.map +1 -0
- package/dist/router/segment-resolution.d.ts +127 -0
- package/dist/router/segment-resolution.d.ts.map +1 -0
- package/dist/router/segment-resolution.js +919 -0
- package/dist/router/segment-resolution.js.map +1 -0
- package/dist/router/trie-matching.d.ts +40 -0
- package/dist/router/trie-matching.d.ts.map +1 -0
- package/dist/router/trie-matching.js +127 -0
- package/dist/router/trie-matching.js.map +1 -0
- package/dist/router/types.d.ts +136 -0
- package/dist/router/types.d.ts.map +1 -0
- package/dist/router/types.js +7 -0
- package/dist/router/types.js.map +1 -0
- package/dist/router.d.ts +753 -0
- package/dist/router.d.ts.map +1 -0
- package/dist/router.gen.d.ts +6 -0
- package/dist/router.gen.d.ts.map +1 -0
- package/dist/router.gen.js +6 -0
- package/dist/router.gen.js.map +1 -0
- package/dist/router.js +1304 -0
- package/dist/router.js.map +1 -0
- package/dist/rsc/__tests__/helpers.test.d.ts +2 -0
- package/dist/rsc/__tests__/helpers.test.d.ts.map +1 -0
- package/dist/rsc/__tests__/helpers.test.js +140 -0
- package/dist/rsc/__tests__/helpers.test.js.map +1 -0
- package/dist/rsc/handler.d.ts +45 -0
- package/dist/rsc/handler.d.ts.map +1 -0
- package/dist/rsc/handler.js +1172 -0
- package/dist/rsc/handler.js.map +1 -0
- package/dist/rsc/helpers.d.ts +16 -0
- package/dist/rsc/helpers.d.ts.map +1 -0
- package/dist/rsc/helpers.js +55 -0
- package/dist/rsc/helpers.js.map +1 -0
- package/dist/rsc/index.d.ts +22 -0
- package/dist/rsc/index.d.ts.map +1 -0
- package/dist/rsc/index.js +23 -0
- package/dist/rsc/index.js.map +1 -0
- package/dist/rsc/nonce.d.ts +9 -0
- package/dist/rsc/nonce.d.ts.map +1 -0
- package/dist/rsc/nonce.js +18 -0
- package/dist/rsc/nonce.js.map +1 -0
- package/dist/rsc/types.d.ts +206 -0
- package/dist/rsc/types.d.ts.map +1 -0
- package/dist/rsc/types.js +8 -0
- package/dist/rsc/types.js.map +1 -0
- package/dist/search-params.d.ts +103 -0
- package/dist/search-params.d.ts.map +1 -0
- package/dist/search-params.js +74 -0
- package/dist/search-params.js.map +1 -0
- package/dist/segment-system.d.ts +75 -0
- package/dist/segment-system.d.ts.map +1 -0
- package/dist/segment-system.js +336 -0
- package/dist/segment-system.js.map +1 -0
- package/dist/server/context.d.ts +245 -0
- package/dist/server/context.d.ts.map +1 -0
- package/dist/server/context.js +197 -0
- package/dist/server/context.js.map +1 -0
- package/dist/server/fetchable-loader-store.d.ts +18 -0
- package/dist/server/fetchable-loader-store.d.ts.map +1 -0
- package/dist/server/fetchable-loader-store.js +18 -0
- package/dist/server/fetchable-loader-store.js.map +1 -0
- package/dist/server/handle-store.d.ts +85 -0
- package/dist/server/handle-store.d.ts.map +1 -0
- package/dist/server/handle-store.js +142 -0
- package/dist/server/handle-store.js.map +1 -0
- package/dist/server/loader-registry.d.ts +55 -0
- package/dist/server/loader-registry.d.ts.map +1 -0
- package/dist/server/loader-registry.js +132 -0
- package/dist/server/loader-registry.js.map +1 -0
- package/dist/server/request-context.d.ts +226 -0
- package/dist/server/request-context.d.ts.map +1 -0
- package/dist/server/request-context.js +290 -0
- package/dist/server/request-context.js.map +1 -0
- package/dist/server/root-layout.d.ts +4 -0
- package/dist/server/root-layout.d.ts.map +1 -0
- package/dist/server/root-layout.js +5 -0
- package/dist/server/root-layout.js.map +1 -0
- package/dist/server.d.ts +15 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +20 -0
- package/dist/server.js.map +1 -0
- package/dist/ssr/__tests__/ssr-handler.test.d.ts +2 -0
- package/dist/ssr/__tests__/ssr-handler.test.d.ts.map +1 -0
- package/dist/ssr/__tests__/ssr-handler.test.js +132 -0
- package/dist/ssr/__tests__/ssr-handler.test.js.map +1 -0
- package/dist/ssr/index.d.ts +98 -0
- package/dist/ssr/index.d.ts.map +1 -0
- package/dist/ssr/index.js +158 -0
- package/dist/ssr/index.js.map +1 -0
- package/dist/static-handler.d.ts +50 -0
- package/dist/static-handler.d.ts.map +1 -0
- package/dist/static-handler.gen.d.ts +5 -0
- package/dist/static-handler.gen.d.ts.map +1 -0
- package/dist/static-handler.gen.js +5 -0
- package/dist/static-handler.gen.js.map +1 -0
- package/dist/static-handler.js +29 -0
- package/dist/static-handler.js.map +1 -0
- package/dist/theme/ThemeProvider.d.ts +20 -0
- package/dist/theme/ThemeProvider.d.ts.map +1 -0
- package/dist/theme/ThemeProvider.js +240 -0
- package/dist/theme/ThemeProvider.js.map +1 -0
- package/dist/theme/ThemeScript.d.ts +48 -0
- package/dist/theme/ThemeScript.d.ts.map +1 -0
- package/dist/theme/ThemeScript.js +13 -0
- package/dist/theme/ThemeScript.js.map +1 -0
- package/dist/theme/__tests__/theme.test.d.ts +2 -0
- package/dist/theme/__tests__/theme.test.d.ts.map +1 -0
- package/dist/theme/__tests__/theme.test.js +103 -0
- package/dist/theme/__tests__/theme.test.js.map +1 -0
- package/dist/theme/constants.d.ts +29 -0
- package/dist/theme/constants.d.ts.map +1 -0
- package/dist/theme/constants.js +48 -0
- package/dist/theme/constants.js.map +1 -0
- package/dist/theme/index.d.ts +31 -0
- package/dist/theme/index.d.ts.map +1 -0
- package/dist/theme/index.js +36 -0
- package/dist/theme/index.js.map +1 -0
- package/dist/theme/theme-context.d.ts +40 -0
- package/dist/theme/theme-context.d.ts.map +1 -0
- package/dist/theme/theme-context.js +60 -0
- package/dist/theme/theme-context.js.map +1 -0
- package/dist/theme/theme-script.d.ts +27 -0
- package/dist/theme/theme-script.d.ts.map +1 -0
- package/dist/theme/theme-script.js +147 -0
- package/dist/theme/theme-script.js.map +1 -0
- package/dist/theme/types.d.ts +163 -0
- package/dist/theme/types.d.ts.map +1 -0
- package/dist/theme/types.js +11 -0
- package/dist/theme/types.js.map +1 -0
- package/dist/theme/use-theme.d.ts +12 -0
- package/dist/theme/use-theme.d.ts.map +1 -0
- package/dist/theme/use-theme.js +40 -0
- package/dist/theme/use-theme.js.map +1 -0
- package/dist/types/__internal.d.ts +127 -0
- package/dist/types/bin/rango.d.ts +1 -0
- package/dist/types/browser/action-coordinator.d.ts +57 -0
- package/dist/types/browser/action-fence.d.ts +33 -0
- package/dist/types/browser/app-shell.d.ts +34 -0
- package/dist/types/browser/app-version.d.ts +6 -0
- package/dist/types/browser/connection-warmup.d.ts +31 -0
- package/dist/types/browser/cookie-name.d.ts +66 -0
- package/dist/types/browser/dev-discovery.d.ts +11 -0
- package/dist/types/browser/event-controller.d.ts +231 -0
- package/dist/types/browser/history-state.d.ts +26 -0
- package/dist/types/browser/index.d.ts +1 -0
- package/dist/types/browser/intercept-utils.d.ts +30 -0
- package/dist/types/browser/invalidate-client-cache.d.ts +17 -0
- package/dist/types/browser/link-interceptor.d.ts +53 -0
- package/dist/types/browser/logging.d.ts +33 -0
- package/dist/types/browser/merge-segment-loaders.d.ts +38 -0
- package/dist/types/browser/navigation-bridge.d.ts +39 -0
- package/dist/types/browser/navigation-client.d.ts +17 -0
- package/dist/types/browser/navigation-store-handle.d.ts +25 -0
- package/dist/types/browser/navigation-store.d.ts +85 -0
- package/dist/types/browser/navigation-transaction.d.ts +75 -0
- package/dist/types/browser/network-error-handler.d.ts +35 -0
- package/dist/types/browser/notify-listeners.d.ts +2 -0
- package/dist/types/browser/partial-update.d.ts +61 -0
- package/dist/types/browser/prefetch/cache.d.ts +224 -0
- package/dist/types/browser/prefetch/default-strategy.d.ts +31 -0
- package/dist/types/browser/prefetch/fetch.d.ts +52 -0
- package/dist/types/browser/prefetch/invalidation.d.ts +6 -0
- package/dist/types/browser/prefetch/loader.d.ts +12 -0
- package/dist/types/browser/prefetch/observer.d.ts +24 -0
- package/dist/types/browser/prefetch/policy.d.ts +13 -0
- package/dist/types/browser/prefetch/queue.d.ts +48 -0
- package/dist/types/browser/prefetch/resource-ready.d.ts +28 -0
- package/dist/types/browser/prefetch/runtime.d.ts +2 -0
- package/dist/types/browser/rango-state.d.ts +56 -0
- package/dist/types/browser/react/Link.d.ts +132 -0
- package/dist/types/browser/react/NavigationProvider.d.ts +88 -0
- package/dist/types/browser/react/ScrollRestoration.d.ts +78 -0
- package/dist/types/browser/react/context.d.ts +57 -0
- package/dist/types/browser/react/filter-segment-order.d.ts +35 -0
- package/dist/types/browser/react/index.d.ts +1 -0
- package/dist/types/browser/react/location-state-shared.d.ts +162 -0
- package/dist/types/browser/react/location-state.d.ts +29 -0
- package/dist/types/browser/react/mount-context.d.ts +23 -0
- package/dist/types/browser/react/nonce-context.d.ts +14 -0
- package/dist/types/browser/react/shallow-equal.d.ts +5 -0
- package/dist/types/browser/react/use-action.d.ts +61 -0
- package/dist/types/browser/react/use-handle.d.ts +21 -0
- package/dist/types/browser/react/use-href.d.ts +32 -0
- package/dist/types/browser/react/use-link-status.d.ts +36 -0
- package/dist/types/browser/react/use-mount.d.ts +24 -0
- package/dist/types/browser/react/use-navigation.d.ts +15 -0
- package/dist/types/browser/react/use-params.d.ts +21 -0
- package/dist/types/browser/react/use-pathname.d.ts +13 -0
- package/dist/types/browser/react/use-reverse.d.ts +40 -0
- package/dist/types/browser/react/use-router.d.ts +30 -0
- package/dist/types/browser/react/use-search-params.d.ts +66 -0
- package/dist/types/browser/react/use-segments.d.ts +29 -0
- package/dist/types/browser/response-adapter.d.ts +58 -0
- package/dist/types/browser/rsc-router.d.ts +146 -0
- package/dist/types/browser/scroll-restoration.d.ts +103 -0
- package/dist/types/browser/segment-reconciler.d.ts +74 -0
- package/dist/types/browser/segment-structure-assert.d.ts +16 -0
- package/dist/types/browser/server-action-bridge.d.ts +29 -0
- package/dist/types/browser/types.d.ts +546 -0
- package/dist/types/browser/validate-redirect-origin.d.ts +28 -0
- package/dist/types/build/collect-fallback-refs.d.ts +5 -0
- package/dist/types/build/generate-manifest.d.ts +106 -0
- package/dist/types/build/generate-route-types.d.ts +8 -0
- package/dist/types/build/index.d.ts +21 -0
- package/dist/types/build/merge-full-manifests.d.ts +3 -0
- package/dist/types/build/prefix-tree-utils.d.ts +56 -0
- package/dist/types/build/route-trie.d.ts +20 -0
- package/dist/types/build/route-types/ast-helpers.d.ts +3 -0
- package/dist/types/build/route-types/ast-route-extraction.d.ts +13 -0
- package/dist/types/build/route-types/codegen.d.ts +16 -0
- package/dist/types/build/route-types/include-resolution.d.ts +74 -0
- package/dist/types/build/route-types/param-extraction.d.ts +13 -0
- package/dist/types/build/route-types/per-module-writer.d.ts +20 -0
- package/dist/types/build/route-types/router-processing.d.ts +81 -0
- package/dist/types/build/route-types/scan-filter.d.ts +17 -0
- package/dist/types/build/route-types/source-scan.d.ts +13 -0
- package/dist/types/build/runtime-discovery.d.ts +24 -0
- package/dist/types/cache/background-task.d.ts +21 -0
- package/dist/types/cache/cache-error.d.ts +71 -0
- package/dist/types/cache/cache-exec-scope.d.ts +31 -0
- package/dist/types/cache/cache-key-utils.d.ts +43 -0
- package/dist/types/cache/cache-policy.d.ts +59 -0
- package/dist/types/cache/cache-runtime.d.ts +51 -0
- package/dist/types/cache/cache-scope.d.ts +215 -0
- package/dist/types/cache/cache-tag.d.ts +79 -0
- package/dist/types/cache/cf/cf-base64.d.ts +4 -0
- package/dist/types/cache/cf/cf-cache-constants.d.ts +112 -0
- package/dist/types/cache/cf/cf-cache-store.d.ts +630 -0
- package/dist/types/cache/cf/cf-cache-types.d.ts +365 -0
- package/dist/types/cache/cf/cf-kv-utils.d.ts +43 -0
- package/dist/types/cache/cf/cf-tag-marker-memo.d.ts +15 -0
- package/dist/types/cache/cf/cf-zone-purge.d.ts +31 -0
- package/dist/types/cache/cf/index.d.ts +4 -0
- package/dist/types/cache/document-cache.d.ts +71 -0
- package/dist/types/cache/handle-capture.d.ts +23 -0
- package/dist/types/cache/handle-snapshot.d.ts +39 -0
- package/dist/types/cache/index.d.ts +9 -0
- package/dist/types/cache/memory-segment-store.d.ts +163 -0
- package/dist/types/cache/profile-registry.d.ts +40 -0
- package/dist/types/cache/read-through-swr.d.ts +61 -0
- package/dist/types/cache/search-params-filter.d.ts +64 -0
- package/dist/types/cache/segment-codec.d.ts +78 -0
- package/dist/types/cache/shell-snapshot.d.ts +186 -0
- package/dist/types/cache/tag-invalidation.d.ts +74 -0
- package/dist/types/cache/taint.d.ts +77 -0
- package/dist/types/cache/types.d.ts +522 -0
- package/dist/types/cache/vercel/index.d.ts +1 -0
- package/dist/types/cache/vercel/vercel-cache-store.d.ts +268 -0
- package/dist/types/client-urls/client-root.d.ts +38 -0
- package/dist/types/client-urls/client-urls.d.ts +5 -0
- package/dist/types/client-urls/navigation.d.ts +38 -0
- package/dist/types/client-urls/revalidation-protocol.d.ts +25 -0
- package/dist/types/client-urls/server-projection.d.ts +71 -0
- package/dist/types/client-urls/types.d.ts +148 -0
- package/dist/types/client.d.ts +192 -0
- package/dist/types/client.rsc.d.ts +42 -0
- package/dist/types/cloudflare/index.d.ts +7 -0
- package/dist/types/cloudflare/tracing.d.ts +57 -0
- package/dist/types/component-utils.d.ts +46 -0
- package/dist/types/components/DefaultDocument.d.ts +13 -0
- package/dist/types/context-var.d.ts +84 -0
- package/dist/types/debug.d.ts +57 -0
- package/dist/types/decode-loader-results.d.ts +42 -0
- package/dist/types/default-error-boundary.d.ts +10 -0
- package/dist/types/defer.d.ts +89 -0
- package/dist/types/deps/browser.d.ts +1 -0
- package/dist/types/deps/html-stream-client.d.ts +1 -0
- package/dist/types/deps/html-stream-server.d.ts +1 -0
- package/dist/types/deps/rsc.d.ts +1 -0
- package/dist/types/deps/ssr.d.ts +1 -0
- package/dist/types/dev-discovery-protocol.d.ts +5 -0
- package/dist/types/encode-kv.d.ts +35 -0
- package/dist/types/errors.d.ts +227 -0
- package/dist/types/escape-script.d.ts +44 -0
- package/dist/types/handle.d.ts +93 -0
- package/dist/types/handles/MetaTags.d.ts +17 -0
- package/dist/types/handles/Scripts.d.ts +38 -0
- package/dist/types/handles/breadcrumbs.d.ts +43 -0
- package/dist/types/handles/deferred-resolution.d.ts +53 -0
- package/dist/types/handles/is-thenable.d.ts +10 -0
- package/dist/types/handles/meta.d.ts +43 -0
- package/dist/types/handles/script.d.ts +139 -0
- package/dist/types/host/cookie-handler.d.ts +8 -0
- package/dist/types/host/errors.d.ts +40 -0
- package/dist/types/host/index.d.ts +33 -0
- package/dist/types/host/pattern-matcher.d.ts +30 -0
- package/dist/types/host/router.d.ts +12 -0
- package/dist/types/host/testing.d.ts +41 -0
- package/dist/types/host/types.d.ts +148 -0
- package/dist/types/host/utils.d.ts +20 -0
- package/dist/types/href-client.d.ts +214 -0
- package/dist/types/index.d.ts +113 -0
- package/dist/types/index.rsc.d.ts +52 -0
- package/dist/types/internal-debug.d.ts +1 -0
- package/dist/types/loader-redirect.d.ts +27 -0
- package/dist/types/loader-store.d.ts +193 -0
- package/dist/types/loader.d.ts +18 -0
- package/dist/types/loader.rsc.d.ts +18 -0
- package/dist/types/missing-id-error.d.ts +1 -0
- package/dist/types/outlet-context.d.ts +32 -0
- package/dist/types/outlet-provider.d.ts +15 -0
- package/dist/types/prerender/build-shell-capture.d.ts +104 -0
- package/dist/types/prerender/param-hash.d.ts +6 -0
- package/dist/types/prerender/shell-manifest-key.d.ts +18 -0
- package/dist/types/prerender/store.d.ts +63 -0
- package/dist/types/prerender.d.ts +292 -0
- package/dist/types/redirect-origin.d.ts +71 -0
- package/dist/types/regex-escape.d.ts +6 -0
- package/dist/types/render-error-thrower.d.ts +13 -0
- package/dist/types/response-utils.d.ts +35 -0
- package/dist/types/reverse.d.ts +206 -0
- package/dist/types/root-error-boundary.d.ts +32 -0
- package/dist/types/route-content-wrapper.d.ts +84 -0
- package/dist/types/route-definition/dsl-helpers.d.ts +130 -0
- package/dist/types/route-definition/helper-factories.d.ts +22 -0
- package/dist/types/route-definition/helpers-types.d.ts +405 -0
- package/dist/types/route-definition/index.d.ts +7 -0
- package/dist/types/route-definition/redirect.d.ts +48 -0
- package/dist/types/route-definition/resolve-handler-use.d.ts +19 -0
- package/dist/types/route-definition/use-item-types.d.ts +1 -0
- package/dist/types/route-definition.d.ts +1 -0
- package/dist/types/route-map-builder.d.ts +102 -0
- package/dist/types/route-name.d.ts +27 -0
- package/dist/types/route-types.d.ts +172 -0
- package/dist/types/router/basename.d.ts +10 -0
- package/dist/types/router/content-negotiation.d.ts +91 -0
- package/dist/types/router/debug-manifest.d.ts +7 -0
- package/dist/types/router/error-handling.d.ts +110 -0
- package/dist/types/router/find-match.d.ts +19 -0
- package/dist/types/router/handler-context.d.ts +41 -0
- package/dist/types/router/instrument.d.ts +191 -0
- package/dist/types/router/intercept-resolution.d.ts +91 -0
- package/dist/types/router/lazy-includes.d.ts +26 -0
- package/dist/types/router/loader-resolution.d.ts +85 -0
- package/dist/types/router/logging.d.ts +41 -0
- package/dist/types/router/manifest.d.ts +8 -0
- package/dist/types/router/match-api.d.ts +19 -0
- package/dist/types/router/match-context.d.ts +184 -0
- package/dist/types/router/match-handlers.d.ts +48 -0
- package/dist/types/router/match-middleware/background-revalidation.d.ts +113 -0
- package/dist/types/router/match-middleware/cache-lookup.d.ts +126 -0
- package/dist/types/router/match-middleware/cache-store.d.ts +112 -0
- package/dist/types/router/match-middleware/index.d.ts +80 -0
- package/dist/types/router/match-middleware/intercept-resolution.d.ts +116 -0
- package/dist/types/router/match-middleware/segment-resolution.d.ts +94 -0
- package/dist/types/router/match-pipelines.d.ts +103 -0
- package/dist/types/router/match-result.d.ts +114 -0
- package/dist/types/router/metrics.d.ts +6 -0
- package/dist/types/router/middleware-types.d.ts +74 -0
- package/dist/types/router/middleware.d.ts +116 -0
- package/dist/types/router/navigation-snapshot.d.ts +51 -0
- package/dist/types/router/params-util.d.ts +8 -0
- package/dist/types/router/parse-pattern.d.ts +38 -0
- package/dist/types/router/pattern-matching.d.ts +169 -0
- package/dist/types/router/prefetch-cache-ttl.d.ts +27 -0
- package/dist/types/router/prefetch-default.d.ts +28 -0
- package/dist/types/router/prefetch-limits.d.ts +20 -0
- package/dist/types/router/prerender-match.d.ts +53 -0
- package/dist/types/router/preview-match.d.ts +22 -0
- package/dist/types/router/request-classification.d.ts +104 -0
- package/dist/types/router/revalidation.d.ts +64 -0
- package/dist/types/router/route-snapshot.d.ts +112 -0
- package/dist/types/router/route-trie-builder.d.ts +77 -0
- package/dist/types/router/router-context.d.ts +137 -0
- package/dist/types/router/router-interfaces.d.ts +461 -0
- package/dist/types/router/router-options.d.ts +792 -0
- package/dist/types/router/router-registry.d.ts +15 -0
- package/dist/types/router/segment-resolution/fresh.d.ts +55 -0
- package/dist/types/router/segment-resolution/helpers.d.ts +93 -0
- package/dist/types/router/segment-resolution/loader-cache.d.ts +33 -0
- package/dist/types/router/segment-resolution/loader-mask.d.ts +44 -0
- package/dist/types/router/segment-resolution/loader-snapshot.d.ts +90 -0
- package/dist/types/router/segment-resolution/mask-nested.d.ts +53 -0
- package/dist/types/router/segment-resolution/revalidation.d.ts +85 -0
- package/dist/types/router/segment-resolution/static-store.d.ts +17 -0
- package/dist/types/router/segment-resolution/streamed-handler-telemetry.d.ts +16 -0
- package/dist/types/router/segment-resolution/view-transition-default.d.ts +27 -0
- package/dist/types/router/segment-resolution.d.ts +3 -0
- package/dist/types/router/segment-wrappers.d.ts +53 -0
- package/dist/types/router/state-cookie-name.d.ts +1 -0
- package/dist/types/router/substitute-pattern-params.d.ts +23 -0
- package/dist/types/router/telemetry-otel.d.ts +113 -0
- package/dist/types/router/telemetry.d.ts +216 -0
- package/dist/types/router/timeout.d.ts +107 -0
- package/dist/types/router/tracing.d.ts +139 -0
- package/dist/types/router/transition-when.d.ts +13 -0
- package/dist/types/router/trie-matching.d.ts +32 -0
- package/dist/types/router/types.d.ts +98 -0
- package/dist/types/router/url-params.d.ts +26 -0
- package/dist/types/router.d.ts +7 -0
- package/dist/types/rsc/capture-queue.d.ts +49 -0
- package/dist/types/rsc/full-payload.d.ts +22 -0
- package/dist/types/rsc/handler-context.d.ts +32 -0
- package/dist/types/rsc/handler.d.ts +9 -0
- package/dist/types/rsc/helpers.d.ts +127 -0
- package/dist/types/rsc/index.d.ts +17 -0
- package/dist/types/rsc/json-route-result.d.ts +20 -0
- package/dist/types/rsc/loader-fetch.d.ts +14 -0
- package/dist/types/rsc/manifest-init.d.ts +18 -0
- package/dist/types/rsc/nonce.d.ts +38 -0
- package/dist/types/rsc/origin-guard.d.ts +50 -0
- package/dist/types/rsc/progressive-enhancement.d.ts +19 -0
- package/dist/types/rsc/redirect-guard.d.ts +37 -0
- package/dist/types/rsc/render-pipeline.d.ts +148 -0
- package/dist/types/rsc/response-cache-serve.d.ts +46 -0
- package/dist/types/rsc/response-error.d.ts +19 -0
- package/dist/types/rsc/response-route-handler.d.ts +29 -0
- package/dist/types/rsc/routine-plan.d.ts +124 -0
- package/dist/types/rsc/rsc-rendering.d.ts +18 -0
- package/dist/types/rsc/runtime-warnings.d.ts +22 -0
- package/dist/types/rsc/server-action.d.ts +68 -0
- package/dist/types/rsc/shell-build-manifest.d.ts +90 -0
- package/dist/types/rsc/shell-capture-constants.d.ts +44 -0
- package/dist/types/rsc/shell-capture.d.ts +425 -0
- package/dist/types/rsc/shell-serve.d.ts +200 -0
- package/dist/types/rsc/ssr-setup.d.ts +73 -0
- package/dist/types/rsc/stream-idle.d.ts +60 -0
- package/dist/types/rsc/transition-gate.d.ts +23 -0
- package/dist/types/rsc/types.d.ts +353 -0
- package/dist/types/runtime-env.d.ts +1 -0
- package/dist/types/search-params.d.ts +125 -0
- package/dist/types/segment-content-promise.d.ts +13 -0
- package/dist/types/segment-fragments.d.ts +79 -0
- package/dist/types/segment-loader-promise.d.ts +22 -0
- package/dist/types/segment-system.d.ts +86 -0
- package/dist/types/serialize.d.ts +164 -0
- package/dist/types/server/context.d.ts +520 -0
- package/dist/types/server/cookie-parse.d.ts +10 -0
- package/dist/types/server/cookie-store.d.ts +107 -0
- package/dist/types/server/fetchable-loader-store.d.ts +20 -0
- package/dist/types/server/handle-store.d.ts +131 -0
- package/dist/types/server/loader-registry.d.ts +32 -0
- package/dist/types/server/request-context.d.ts +717 -0
- package/dist/types/server/root-layout.d.ts +3 -0
- package/dist/types/server.d.ts +16 -0
- package/dist/types/ssr/index.d.ts +289 -0
- package/dist/types/ssr/inject-rsc-eager.d.ts +3 -0
- package/dist/types/ssr/preinit-client-references.d.ts +71 -0
- package/dist/types/ssr/ssr-root.d.ts +100 -0
- package/dist/types/ssr-suspension-warning.d.ts +19 -0
- package/dist/types/static-handler.d.ts +71 -0
- package/dist/types/testing/cache-status.d.ts +63 -0
- package/dist/types/testing/collect-handle.d.ts +20 -0
- package/dist/types/testing/dispatch.d.ts +127 -0
- package/dist/types/testing/dom.entry.d.ts +15 -0
- package/dist/types/testing/e2e/fixture.d.ts +37 -0
- package/dist/types/testing/e2e/index.d.ts +31 -0
- package/dist/types/testing/e2e/matchers.d.ts +17 -0
- package/dist/types/testing/e2e/page-helpers.d.ts +86 -0
- package/dist/types/testing/e2e/parity.d.ts +111 -0
- package/dist/types/testing/e2e/server.d.ts +35 -0
- package/dist/types/testing/flight-matchers.d.ts +55 -0
- package/dist/types/testing/flight-normalize.d.ts +1 -0
- package/dist/types/testing/flight-tree.d.ts +192 -0
- package/dist/types/testing/flight.d.ts +115 -0
- package/dist/types/testing/flight.entry.d.ts +27 -0
- package/dist/types/testing/generated-routes.d.ts +66 -0
- package/dist/types/testing/index.d.ts +54 -0
- package/dist/types/testing/internal/context.d.ts +225 -0
- package/dist/types/testing/internal/flight-client-globals.d.ts +1 -0
- package/dist/types/testing/internal/seed-vars.d.ts +30 -0
- package/dist/types/testing/render-handler.d.ts +160 -0
- package/dist/types/testing/render-route.d.ts +265 -0
- package/dist/types/testing/run-loader.d.ts +195 -0
- package/dist/types/testing/run-middleware.d.ts +132 -0
- package/dist/types/testing/run-transition-when.d.ts +78 -0
- package/dist/types/testing/shell-status.d.ts +81 -0
- package/dist/types/testing/vitest-stubs/cloudflare-email.d.ts +6 -0
- package/dist/types/testing/vitest-stubs/cloudflare-workers.d.ts +13 -0
- package/dist/types/testing/vitest-stubs/plugin-rsc.d.ts +7 -0
- package/dist/types/testing/vitest-stubs/version.d.ts +1 -0
- package/dist/types/testing/vitest.d.ts +205 -0
- package/dist/types/theme/ThemeProvider.d.ts +13 -0
- package/dist/types/theme/ThemeScript.d.ts +45 -0
- package/dist/types/theme/constants.d.ts +39 -0
- package/dist/types/theme/index.d.ts +29 -0
- package/dist/types/theme/theme-context.d.ts +21 -0
- package/dist/types/theme/theme-script.d.ts +26 -0
- package/dist/types/theme/types.d.ts +162 -0
- package/dist/types/theme/use-theme.d.ts +8 -0
- package/dist/types/types/boundaries.d.ts +115 -0
- package/dist/types/types/cache-types.d.ts +191 -0
- package/dist/types/types/error-types.d.ts +114 -0
- package/dist/types/types/global-namespace.d.ts +90 -0
- package/dist/types/types/handler-context.d.ts +658 -0
- package/dist/types/types/index.d.ts +11 -0
- package/dist/types/types/loader-types.d.ts +240 -0
- package/dist/types/types/request-scope.d.ts +93 -0
- package/dist/types/types/route-config.d.ts +105 -0
- package/dist/types/types/route-entry.d.ts +98 -0
- package/dist/types/types/segments.d.ts +254 -0
- package/dist/types/types.d.ts +1 -0
- package/dist/types/urls/include-helper.d.ts +17 -0
- package/dist/types/urls/include-provider.d.ts +27 -0
- package/dist/types/urls/index.d.ts +6 -0
- package/dist/types/urls/path-helper-types.d.ts +207 -0
- package/dist/types/urls/path-helper.d.ts +12 -0
- package/dist/types/urls/pattern-types.d.ts +166 -0
- package/dist/types/urls/response-types.d.ts +67 -0
- package/dist/types/urls/type-extraction.d.ts +157 -0
- package/dist/types/urls/urls-function.d.ts +24 -0
- package/dist/types/urls.d.ts +1 -0
- package/dist/types/use-loader.d.ts +150 -0
- package/dist/types/vercel/index.d.ts +10 -0
- package/dist/types/vercel/tracing.d.ts +71 -0
- package/dist/types/vite/debug.d.ts +80 -0
- package/dist/types/vite/discovery/bundle-postprocess.d.ts +12 -0
- package/dist/types/vite/discovery/client-urls-projection.d.ts +53 -0
- package/dist/types/vite/discovery/dev-prerender-cache.d.ts +65 -0
- package/dist/types/vite/discovery/discover-routers.d.ts +17 -0
- package/dist/types/vite/discovery/discovery-errors.d.ts +113 -0
- package/dist/types/vite/discovery/gate-state.d.ts +79 -0
- package/dist/types/vite/discovery/prerender-collection.d.ts +24 -0
- package/dist/types/vite/discovery/route-types-writer.d.ts +32 -0
- package/dist/types/vite/discovery/self-gen-tracking.d.ts +22 -0
- package/dist/types/vite/discovery/shell-prerender-phase.d.ts +40 -0
- package/dist/types/vite/discovery/state.d.ts +176 -0
- package/dist/types/vite/discovery/virtual-module-codegen.d.ts +15 -0
- package/dist/types/vite/encryption-key.d.ts +2 -0
- package/dist/types/vite/index.d.ts +11 -0
- package/dist/types/vite/inject-client-debug.d.ts +56 -0
- package/dist/types/vite/plugin-types.d.ts +325 -0
- package/dist/types/vite/plugins/cjs-to-esm.d.ts +6 -0
- package/dist/types/vite/plugins/client-ref-dedup.d.ts +29 -0
- package/dist/types/vite/plugins/client-ref-hashing.d.ts +35 -0
- package/dist/types/vite/plugins/cloudflare-protocol-stub.d.ts +64 -0
- package/dist/types/vite/plugins/expose-action-id.d.ts +18 -0
- package/dist/types/vite/plugins/expose-id-utils.d.ts +37 -0
- package/dist/types/vite/plugins/expose-ids/export-analysis.d.ts +19 -0
- package/dist/types/vite/plugins/expose-ids/handler-transform.d.ts +10 -0
- package/dist/types/vite/plugins/expose-ids/loader-transform.d.ts +8 -0
- package/dist/types/vite/plugins/expose-ids/router-transform.d.ts +13 -0
- package/dist/types/vite/plugins/expose-ids/types.d.ts +29 -0
- package/dist/types/vite/plugins/expose-internal-ids.d.ts +16 -0
- package/dist/types/vite/plugins/performance-tracks.d.ts +25 -0
- package/dist/types/vite/plugins/refresh-cmd.d.ts +20 -0
- package/dist/types/vite/plugins/server-ref-hashing.d.ts +24 -0
- package/dist/types/vite/plugins/server-reference-pattern.d.ts +1 -0
- package/dist/types/vite/plugins/use-cache-transform.d.ts +20 -0
- package/dist/types/vite/plugins/vercel-output.d.ts +85 -0
- package/dist/types/vite/plugins/version-injector.d.ts +21 -0
- package/dist/types/vite/plugins/version-plugin.d.ts +19 -0
- package/dist/types/vite/plugins/virtual-entries.d.ts +36 -0
- package/dist/types/vite/plugins/virtual-stub-plugin.d.ts +7 -0
- package/dist/types/vite/rango.d.ts +29 -0
- package/dist/types/vite/router-discovery.d.ts +23 -0
- package/dist/types/vite/utils/ast-handler-extract.d.ts +64 -0
- package/dist/types/vite/utils/banner.d.ts +2 -0
- package/dist/types/vite/utils/bundle-analysis.d.ts +28 -0
- package/dist/types/vite/utils/client-chunks.d.ts +55 -0
- package/dist/types/vite/utils/directive-prologue.d.ts +16 -0
- package/dist/types/vite/utils/forward-user-plugins.d.ts +37 -0
- package/dist/types/vite/utils/manifest-utils.d.ts +7 -0
- package/dist/types/vite/utils/package-resolution.d.ts +6 -0
- package/dist/types/vite/utils/prerender-utils.d.ts +32 -0
- package/dist/types/vite/utils/shared-utils.d.ts +68 -0
- package/dist/types.d.ts +1479 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +10 -0
- package/dist/types.js.map +1 -0
- package/dist/urls.d.ts +441 -0
- package/dist/urls.d.ts.map +1 -0
- package/dist/urls.gen.d.ts +8 -0
- package/dist/urls.gen.d.ts.map +1 -0
- package/dist/urls.gen.js +8 -0
- package/dist/urls.gen.js.map +1 -0
- package/dist/urls.js +443 -0
- package/dist/urls.js.map +1 -0
- package/dist/use-loader.d.ts +127 -0
- package/dist/use-loader.d.ts.map +1 -0
- package/dist/use-loader.js +237 -0
- package/dist/use-loader.js.map +1 -0
- package/dist/vite/__tests__/ast-handler-extract.test.d.ts +2 -0
- package/dist/vite/__tests__/ast-handler-extract.test.d.ts.map +1 -0
- package/dist/vite/__tests__/ast-handler-extract.test.js +294 -0
- package/dist/vite/__tests__/ast-handler-extract.test.js.map +1 -0
- package/dist/vite/__tests__/expose-id-utils.test.d.ts +2 -0
- package/dist/vite/__tests__/expose-id-utils.test.d.ts.map +1 -0
- package/dist/vite/__tests__/expose-id-utils.test.js +224 -0
- package/dist/vite/__tests__/expose-id-utils.test.js.map +1 -0
- package/dist/vite/__tests__/expose-internal-ids.test.d.ts +2 -0
- package/dist/vite/__tests__/expose-internal-ids.test.d.ts.map +1 -0
- package/dist/vite/__tests__/expose-internal-ids.test.js +647 -0
- package/dist/vite/__tests__/expose-internal-ids.test.js.map +1 -0
- package/dist/vite/__tests__/expose-router-id.test.d.ts +2 -0
- package/dist/vite/__tests__/expose-router-id.test.d.ts.map +1 -0
- package/dist/vite/__tests__/expose-router-id.test.js +39 -0
- package/dist/vite/__tests__/expose-router-id.test.js.map +1 -0
- package/dist/vite/ast-handler-extract.d.ts +49 -0
- package/dist/vite/ast-handler-extract.d.ts.map +1 -0
- package/dist/vite/ast-handler-extract.js +249 -0
- package/dist/vite/ast-handler-extract.js.map +1 -0
- package/dist/vite/expose-action-id.d.ts +19 -0
- package/dist/vite/expose-action-id.d.ts.map +1 -0
- package/dist/vite/expose-action-id.js +250 -0
- package/dist/vite/expose-action-id.js.map +1 -0
- package/dist/vite/expose-id-utils.d.ts +69 -0
- package/dist/vite/expose-id-utils.d.ts.map +1 -0
- package/dist/vite/expose-id-utils.js +289 -0
- package/dist/vite/expose-id-utils.js.map +1 -0
- package/dist/vite/expose-internal-ids.d.ts +22 -0
- package/dist/vite/expose-internal-ids.d.ts.map +1 -0
- package/dist/vite/expose-internal-ids.js +886 -0
- package/dist/vite/expose-internal-ids.js.map +1 -0
- package/dist/vite/index.d.ts +149 -0
- package/dist/vite/index.d.ts.map +1 -0
- package/dist/vite/index.js +7541 -2649
- package/dist/vite/index.js.bak +5448 -0
- package/dist/vite/index.js.map +1 -0
- package/dist/vite/index.named-routes.gen.ts +103 -0
- package/dist/vite/package-resolution.d.ts +43 -0
- package/dist/vite/package-resolution.d.ts.map +1 -0
- package/dist/vite/package-resolution.js +112 -0
- package/dist/vite/package-resolution.js.map +1 -0
- package/dist/vite/virtual-entries.d.ts +25 -0
- package/dist/vite/virtual-entries.d.ts.map +1 -0
- package/dist/vite/virtual-entries.js +110 -0
- package/dist/vite/virtual-entries.js.map +1 -0
- package/package.json +73 -44
- package/skills/api-client/SKILL.md +1 -1
- package/skills/breadcrumbs/SKILL.md +66 -19
- package/skills/cache-guide/SKILL.md +11 -5
- package/skills/caching/SKILL.md +100 -6
- package/skills/catalog.json +289 -0
- package/skills/client-urls/SKILL.md +339 -0
- package/skills/cloudflare/SKILL.md +153 -0
- package/skills/cloudflare/agents/openai.yaml +4 -0
- package/skills/cloudflare/references/d1-and-local-dev.md +131 -0
- package/skills/cloudflare/references/streaming-and-deploy.md +107 -0
- package/skills/cloudflare/references/webhooks-and-crypto.md +147 -0
- package/skills/comparison/SKILL.md +50 -0
- package/skills/comparison/agents/openai.yaml +4 -0
- package/skills/comparison/references/framework-comparison.md +858 -0
- package/skills/composability/SKILL.md +97 -2
- package/skills/debug-manifest/SKILL.md +3 -11
- package/skills/defer-hydration/SKILL.md +235 -0
- package/skills/deployment-caching/SKILL.md +176 -0
- package/skills/document-cache/SKILL.md +38 -3
- package/skills/fonts/SKILL.md +1 -1
- package/skills/handler-use/SKILL.md +8 -8
- package/skills/hooks/SKILL.md +55 -893
- package/skills/hooks/data.md +282 -0
- package/skills/hooks/handle-and-actions.md +110 -0
- package/skills/hooks/navigation.md +110 -0
- package/skills/hooks/outlets.md +62 -0
- package/skills/hooks/state.md +228 -0
- package/skills/hooks/urls.md +172 -0
- package/skills/host-router/SKILL.md +46 -4
- package/skills/i18n/SKILL.md +1 -1
- package/skills/intercept/SKILL.md +46 -14
- package/skills/layout/SKILL.md +27 -10
- package/skills/links/SKILL.md +37 -1
- package/skills/loader/SKILL.md +170 -20
- package/skills/middleware/SKILL.md +40 -3
- package/skills/migrate-nextjs/SKILL.md +298 -28
- package/skills/migrate-nextjs/backend-host-swap.md +120 -0
- package/skills/migrate-react-router/SKILL.md +95 -677
- package/skills/migrate-react-router/component-migration.md +201 -0
- package/skills/migrate-react-router/data-and-actions.md +236 -0
- package/skills/migrate-react-router/route-mapping.md +284 -0
- package/skills/mime-routes/SKILL.md +29 -19
- package/skills/observability/SKILL.md +65 -6
- package/skills/parallel/SKILL.md +55 -5
- package/skills/ppr/SKILL.md +918 -0
- package/skills/prerender/SKILL.md +93 -29
- package/skills/rango/SKILL.md +105 -33
- package/skills/react-compiler/SKILL.md +3 -3
- package/skills/response-routes/SKILL.md +60 -7
- package/skills/route/SKILL.md +82 -6
- package/skills/router-setup/SKILL.md +40 -5
- package/skills/scripts/SKILL.md +17 -7
- package/skills/server-actions/SKILL.md +3 -2
- package/skills/shell-manifest/SKILL.md +194 -0
- package/skills/streams-and-websockets/SKILL.md +1 -1
- package/skills/tailwind/SKILL.md +1 -1
- package/skills/testing/SKILL.md +5 -3
- package/skills/testing/cache-prerender.md +47 -2
- package/skills/testing/client-components.md +21 -14
- package/skills/testing/handles.md +34 -10
- package/skills/testing/loader.md +51 -49
- package/skills/testing/middleware.md +1 -1
- package/skills/testing/render-handler.md +15 -14
- package/skills/testing/response-routes.md +2 -2
- package/skills/testing/reverse-and-types.md +8 -7
- package/skills/theme/SKILL.md +9 -6
- package/skills/typesafety/SKILL.md +45 -919
- package/skills/typesafety/env-and-bindings.md +254 -0
- package/skills/typesafety/generated-files-and-cli.md +342 -0
- package/skills/typesafety/params-and-search.md +153 -0
- package/skills/typesafety/route-types.md +213 -0
- package/skills/use-cache/SKILL.md +77 -3
- package/skills/vercel/SKILL.md +149 -0
- package/skills/view-transitions/SKILL.md +48 -1
- package/src/bin/rango.ts +7 -3
- package/src/browser/dev-discovery.ts +66 -0
- package/src/browser/event-controller.ts +221 -31
- package/src/browser/link-interceptor.ts +469 -20
- package/src/browser/logging.ts +28 -0
- package/src/browser/merge-segment-loaders.ts +6 -4
- package/src/browser/navigation-bridge.ts +100 -11
- package/src/browser/navigation-client.ts +105 -28
- package/src/browser/navigation-store.ts +141 -271
- package/src/browser/notify-listeners.ts +22 -0
- package/src/browser/partial-update.ts +124 -23
- package/src/browser/prefetch/cache.ts +141 -33
- package/src/browser/prefetch/default-strategy.ts +74 -0
- package/src/browser/prefetch/fetch.ts +137 -23
- package/src/browser/prefetch/invalidation.ts +30 -0
- package/src/browser/prefetch/loader.ts +111 -0
- package/src/browser/prefetch/observer.ts +50 -22
- package/src/browser/prefetch/queue.ts +19 -4
- package/src/browser/prefetch/runtime.ts +6 -0
- package/src/browser/rango-state.ts +21 -0
- package/src/browser/react/Link.tsx +142 -102
- package/src/browser/react/NavigationProvider.tsx +104 -78
- package/src/browser/react/context.ts +4 -0
- package/src/browser/react/use-router.ts +41 -12
- package/src/browser/react/use-search-params.ts +140 -17
- package/src/browser/response-adapter.ts +24 -8
- package/src/browser/rsc-router.tsx +165 -16
- package/src/browser/scroll-restoration.ts +7 -5
- package/src/browser/segment-reconciler.ts +31 -21
- package/src/browser/server-action-bridge.ts +48 -10
- package/src/browser/types.ts +75 -26
- package/src/build/generate-manifest.ts +165 -161
- package/src/build/generate-route-types.ts +1 -0
- package/src/build/index.ts +3 -1
- package/src/build/merge-full-manifests.ts +161 -0
- package/src/build/route-trie.ts +13 -353
- package/src/build/route-types/include-resolution.ts +404 -49
- package/src/build/route-types/per-module-writer.ts +11 -6
- package/src/build/route-types/router-processing.ts +261 -180
- package/src/build/runtime-discovery.ts +23 -9
- package/src/cache/cache-exec-scope.ts +47 -0
- package/src/cache/cache-key-utils.ts +46 -4
- package/src/cache/cache-runtime.ts +393 -110
- package/src/cache/cache-scope.ts +206 -34
- package/src/cache/cache-tag.ts +60 -14
- package/src/cache/cf/cf-cache-constants.ts +8 -1
- package/src/cache/cf/cf-cache-store.ts +1198 -118
- package/src/cache/cf/cf-cache-types.ts +69 -1
- package/src/cache/cf/cf-kv-utils.ts +38 -0
- package/src/cache/cf/cf-tag-marker-memo.ts +5 -2
- package/src/cache/cf/cf-zone-purge.ts +101 -0
- package/src/cache/cf/index.ts +5 -0
- package/src/cache/document-cache.ts +120 -41
- package/src/cache/handle-snapshot.ts +22 -1
- package/src/cache/index.ts +22 -0
- package/src/cache/memory-segment-store.ts +153 -3
- package/src/cache/profile-registry.ts +15 -0
- package/src/cache/read-through-swr.ts +25 -5
- package/src/cache/search-params-filter.ts +118 -0
- package/src/cache/segment-codec.ts +72 -9
- package/src/cache/shell-snapshot.ts +516 -0
- package/src/cache/taint.ts +28 -9
- package/src/cache/types.ts +308 -2
- package/src/cache/vercel/index.ts +11 -0
- package/src/cache/vercel/vercel-cache-store.ts +1264 -0
- package/src/client-urls/client-root.tsx +168 -0
- package/src/client-urls/client-urls.ts +779 -0
- package/src/client-urls/navigation.ts +237 -0
- package/src/client-urls/revalidation-protocol.ts +56 -0
- package/src/client-urls/server-projection.ts +670 -0
- package/src/client-urls/types.ts +202 -0
- package/src/client.rsc.tsx +12 -3
- package/src/client.tsx +49 -9
- package/src/cloudflare/tracing.ts +23 -20
- package/src/decode-loader-results.ts +113 -0
- package/src/defer.ts +11 -22
- package/src/deps/ssr.ts +4 -1
- package/src/dev-discovery-protocol.ts +11 -0
- package/src/errors.ts +14 -0
- package/src/handle.ts +37 -15
- package/src/handles/MetaTags.tsx +16 -88
- package/src/handles/breadcrumbs.ts +12 -14
- package/src/handles/deferred-resolution.ts +134 -0
- package/src/handles/is-thenable.ts +5 -8
- package/src/handles/meta.ts +7 -44
- package/src/host/errors.ts +15 -0
- package/src/host/index.ts +1 -0
- package/src/index.rsc.ts +19 -2
- package/src/index.ts +27 -13
- package/src/loader-redirect.tsx +64 -0
- package/src/outlet-context.ts +20 -0
- package/src/outlet-provider.tsx +19 -1
- package/src/prerender/build-shell-capture.ts +453 -0
- package/src/prerender/shell-manifest-key.ts +20 -0
- package/src/prerender/store.ts +15 -1
- package/src/prerender.ts +20 -7
- package/src/redirect-origin.ts +77 -5
- package/src/route-content-wrapper.tsx +115 -8
- package/src/route-definition/dsl-helpers.ts +60 -37
- package/src/route-definition/helper-factories.ts +0 -2
- package/src/route-definition/helpers-types.ts +62 -46
- package/src/route-definition/index.ts +1 -2
- package/src/route-definition/redirect.ts +17 -18
- package/src/route-definition/resolve-handler-use.ts +0 -1
- package/src/route-definition/use-item-types.ts +3 -6
- package/src/route-map-builder.ts +102 -58
- package/src/route-types.ts +0 -5
- package/src/router/content-negotiation.ts +47 -5
- package/src/router/error-handling.ts +65 -11
- package/src/router/find-match.ts +86 -8
- package/src/router/handler-context.ts +31 -15
- package/src/router/instrument.ts +70 -19
- package/src/router/intercept-resolution.ts +59 -1
- package/src/router/lazy-includes.ts +73 -12
- package/src/router/loader-resolution.ts +291 -30
- package/src/router/manifest.ts +56 -11
- package/src/router/match-api.ts +90 -35
- package/src/router/match-handlers.ts +238 -141
- package/src/router/match-middleware/background-revalidation.ts +40 -23
- package/src/router/match-middleware/cache-lookup.ts +182 -42
- package/src/router/match-middleware/cache-store.ts +109 -24
- package/src/router/match-result.ts +41 -14
- package/src/router/metrics.ts +17 -2
- package/src/router/middleware-types.ts +17 -0
- package/src/router/middleware.ts +68 -38
- package/src/router/navigation-snapshot.ts +53 -11
- package/src/router/parse-pattern.ts +115 -0
- package/src/router/pattern-matching.ts +53 -64
- package/src/router/prefetch-default.ts +59 -0
- package/src/router/prefetch-limits.ts +37 -0
- package/src/router/prerender-match.ts +58 -7
- package/src/router/preview-match.ts +3 -1
- package/src/router/request-classification.ts +23 -8
- package/src/router/revalidation.ts +24 -11
- package/src/router/route-snapshot.ts +14 -2
- package/src/router/route-trie-builder.ts +334 -0
- package/src/router/router-context.ts +3 -1
- package/src/router/router-interfaces.ts +86 -4
- package/src/router/router-options.ts +102 -9
- package/src/router/segment-resolution/fresh.ts +127 -5
- package/src/router/segment-resolution/helpers.ts +10 -12
- package/src/router/segment-resolution/loader-cache.ts +146 -2
- package/src/router/segment-resolution/loader-mask.ts +60 -0
- package/src/router/segment-resolution/loader-snapshot.ts +259 -0
- package/src/router/segment-resolution/mask-nested.ts +99 -0
- package/src/router/segment-resolution/revalidation.ts +50 -2
- package/src/router/segment-resolution/static-store.ts +36 -10
- package/src/router/segment-resolution/view-transition-default.ts +39 -15
- package/src/router/substitute-pattern-params.ts +54 -35
- package/src/router/telemetry-otel.ts +21 -12
- package/src/router/telemetry.ts +10 -1
- package/src/router/timeout.ts +53 -2
- package/src/router/tracing.ts +50 -21
- package/src/router/transition-when.ts +76 -0
- package/src/router/trie-matching.ts +22 -14
- package/src/router/url-params.ts +13 -0
- package/src/router.ts +138 -23
- package/src/rsc/capture-queue.ts +218 -0
- package/src/rsc/full-payload.ts +77 -0
- package/src/rsc/handler-context.ts +1 -0
- package/src/rsc/handler.ts +417 -182
- package/src/rsc/helpers.ts +80 -4
- package/src/rsc/loader-fetch.ts +4 -4
- package/src/rsc/manifest-init.ts +28 -16
- package/src/rsc/nonce.ts +26 -1
- package/src/rsc/progressive-enhancement.ts +329 -88
- package/src/rsc/redirect-guard.ts +5 -2
- package/src/rsc/render-pipeline.ts +611 -0
- package/src/rsc/response-cache-serve.ts +39 -18
- package/src/rsc/response-route-handler.ts +9 -45
- package/src/rsc/routine-plan.ts +359 -0
- package/src/rsc/rsc-rendering.ts +1610 -151
- package/src/rsc/server-action.ts +227 -87
- package/src/rsc/shell-build-manifest.ts +343 -0
- package/src/rsc/shell-capture-constants.ts +45 -0
- package/src/rsc/shell-capture.ts +2135 -0
- package/src/rsc/shell-serve.ts +350 -0
- package/src/rsc/ssr-setup.ts +115 -23
- package/src/rsc/stream-idle.ts +137 -0
- package/src/rsc/transition-gate.ts +86 -0
- package/src/rsc/types.ts +102 -2
- package/src/segment-fragments.ts +165 -0
- package/src/segment-loader-promise.ts +18 -0
- package/src/segment-system.tsx +263 -19
- package/src/server/context.ts +289 -17
- package/src/server/cookie-store.ts +92 -20
- package/src/server/handle-store.ts +185 -48
- package/src/server/loader-registry.ts +13 -1
- package/src/server/request-context.ts +608 -59
- package/src/server.ts +7 -2
- package/src/ssr/index.tsx +732 -183
- package/src/ssr/inject-rsc-eager.ts +167 -0
- package/src/ssr/preinit-client-references.ts +106 -0
- package/src/ssr/ssr-root.tsx +332 -0
- package/src/ssr-suspension-warning.ts +67 -0
- package/src/static-handler.ts +18 -2
- package/src/testing/collect-handle.ts +14 -8
- package/src/testing/dispatch.ts +355 -105
- package/src/testing/dom.entry.ts +1 -1
- package/src/testing/e2e/index.ts +19 -0
- package/src/testing/e2e/page-helpers.ts +47 -0
- package/src/testing/e2e/parity.ts +13 -0
- package/src/testing/generated-routes.ts +27 -11
- package/src/testing/index.ts +23 -1
- package/src/testing/internal/context.ts +9 -0
- package/src/testing/render-handler.ts +29 -1
- package/src/testing/render-route.tsx +121 -35
- package/src/testing/run-loader.ts +51 -13
- package/src/testing/run-middleware.ts +14 -0
- package/src/testing/run-transition-when.ts +197 -0
- package/src/testing/shell-status.ts +206 -0
- package/src/theme/ThemeProvider.tsx +36 -26
- package/src/types/boundaries.ts +19 -0
- package/src/types/handler-context.ts +14 -3
- package/src/types/index.ts +3 -0
- package/src/types/loader-types.ts +66 -5
- package/src/types/route-config.ts +19 -7
- package/src/types/route-entry.ts +3 -0
- package/src/types/segments.ts +120 -0
- package/src/urls/include-helper.ts +29 -8
- package/src/urls/include-provider.ts +71 -0
- package/src/urls/index.ts +1 -0
- package/src/urls/path-helper-types.ts +69 -20
- package/src/urls/path-helper.ts +13 -4
- package/src/urls/pattern-types.ts +65 -0
- package/src/urls/type-extraction.ts +43 -18
- package/src/urls/urls-function.ts +0 -1
- package/src/use-loader.tsx +91 -7
- package/src/vercel/index.ts +11 -0
- package/src/vercel/tracing.ts +89 -0
- package/src/vite/discovery/bundle-postprocess.ts +10 -7
- package/src/vite/discovery/client-urls-projection.ts +322 -0
- package/src/vite/discovery/dev-prerender-cache.ts +117 -0
- package/src/vite/discovery/discover-routers.ts +81 -95
- package/src/vite/discovery/discovery-errors.ts +61 -0
- package/src/vite/discovery/prerender-collection.ts +29 -2
- package/src/vite/discovery/shell-prerender-phase.ts +402 -0
- package/src/vite/discovery/state.ts +66 -6
- package/src/vite/discovery/virtual-module-codegen.ts +221 -62
- package/src/vite/encryption-key.ts +29 -0
- package/src/vite/index.ts +10 -0
- package/src/vite/inject-client-debug.ts +64 -12
- package/src/vite/plugin-types.ts +145 -2
- package/src/vite/plugins/client-ref-dedup.ts +281 -19
- package/src/vite/plugins/expose-action-id.ts +47 -25
- package/src/vite/plugins/expose-internal-ids.ts +46 -0
- package/src/vite/plugins/server-ref-hashing.ts +74 -0
- package/src/vite/plugins/server-reference-pattern.ts +10 -0
- package/src/vite/plugins/vercel-output.ts +384 -0
- package/src/vite/plugins/version-injector.ts +22 -8
- package/src/vite/plugins/version-plugin.ts +8 -0
- package/src/vite/plugins/virtual-entries.ts +193 -16
- package/src/vite/rango.ts +182 -23
- package/src/vite/router-discovery.ts +912 -85
- package/src/vite/utils/manifest-utils.ts +1 -4
- package/src/vite/utils/package-resolution.ts +1 -0
- package/src/vite/utils/prerender-utils.ts +42 -10
- package/src/vite/utils/shared-utils.ts +74 -4
package/src/server/context.ts
CHANGED
|
@@ -27,6 +27,7 @@ export interface PerformanceMetric {
|
|
|
27
27
|
duration: number; // milliseconds
|
|
28
28
|
startTime: number; // relative to request start
|
|
29
29
|
depth?: number; // nesting level for hierarchical display (0 = top-level)
|
|
30
|
+
desc?: string; // free-form outcome detail, emitted as Server-Timing desc="..."
|
|
30
31
|
}
|
|
31
32
|
|
|
32
33
|
/**
|
|
@@ -105,6 +106,16 @@ export type LoaderEntry = {
|
|
|
105
106
|
revalidate: ShouldRevalidateFn<any, any>[];
|
|
106
107
|
/** Cache config for this specific loader (loaders are NOT cached by default) */
|
|
107
108
|
cache?: EntryCacheConfig;
|
|
109
|
+
/**
|
|
110
|
+
* Document renders await this loader before segment resolution returns
|
|
111
|
+
* (loader(Def, { ssr: false })), so its data, handle pushes, and
|
|
112
|
+
* thrown notFound()/redirect() deterministically precede first flush.
|
|
113
|
+
* Resolved at DSL-evaluation time from ctx.isSSR — entries are cached
|
|
114
|
+
* per-isSSR (router/manifest.ts cache key), so the flag is already
|
|
115
|
+
* request-mode-correct when resolveLoaders (fresh.ts) reads it and never
|
|
116
|
+
* appears on navigation-lane entries.
|
|
117
|
+
*/
|
|
118
|
+
awaitBeforeFlush?: true;
|
|
108
119
|
};
|
|
109
120
|
|
|
110
121
|
/**
|
|
@@ -150,6 +161,19 @@ export type InterceptWhenFn<TEnv = any> = (
|
|
|
150
161
|
ctx: InterceptSelectorContext<TEnv>,
|
|
151
162
|
) => boolean;
|
|
152
163
|
|
|
164
|
+
/**
|
|
165
|
+
* Config object passed to intercept() (its 4th argument). `when` gates whether
|
|
166
|
+
* the intercept activates on a soft navigation — a single match-time selector or
|
|
167
|
+
* an array of them (ALL must return true; omit to always activate). This is the
|
|
168
|
+
* intercept counterpart to transition({ when }); both express conditional
|
|
169
|
+
* behavior as a config field rather than a separate DSL helper.
|
|
170
|
+
*
|
|
171
|
+
* @internal This type is an implementation detail and may change without notice.
|
|
172
|
+
*/
|
|
173
|
+
export interface InterceptConfig<TEnv = any> {
|
|
174
|
+
when?: InterceptWhenFn<TEnv> | InterceptWhenFn<TEnv>[];
|
|
175
|
+
}
|
|
176
|
+
|
|
153
177
|
/**
|
|
154
178
|
* Intercept entry stored in EntryData
|
|
155
179
|
* Contains the slot name, route to intercept, and handler
|
|
@@ -220,6 +244,13 @@ export type EntryData =
|
|
|
220
244
|
staticHandlerId?: string;
|
|
221
245
|
/** Response type for non-RSC routes (json, text, image, any) */
|
|
222
246
|
responseType?: string;
|
|
247
|
+
/**
|
|
248
|
+
* PPR (partial pre-rendering) opt-in from the path() `ppr` option. A
|
|
249
|
+
* document-level property of the page route: `true` uses the default
|
|
250
|
+
* shell policy, an object carries ttl/swr/tags. Read by the integrated
|
|
251
|
+
* PPR serve path (rsc/shell-serve.ts resolvePprConfig).
|
|
252
|
+
*/
|
|
253
|
+
ppr?: boolean | import("../urls/pattern-types.js").PartialPrerenderProps;
|
|
223
254
|
} & EntryPropCommon &
|
|
224
255
|
EntryPropDatas &
|
|
225
256
|
EntryPropSegments &
|
|
@@ -256,6 +287,17 @@ export interface TrackedInclude {
|
|
|
256
287
|
lazy: boolean;
|
|
257
288
|
}
|
|
258
289
|
|
|
290
|
+
/**
|
|
291
|
+
* Cached response-header write scope (issue #713). `kind` selects the error
|
|
292
|
+
* wording; `routeKey` names the route in the error.
|
|
293
|
+
*
|
|
294
|
+
* @internal This type is an implementation detail and may change without notice.
|
|
295
|
+
*/
|
|
296
|
+
export type CachedHeaderScope = {
|
|
297
|
+
kind: "cache" | "ppr";
|
|
298
|
+
routeKey?: string;
|
|
299
|
+
};
|
|
300
|
+
|
|
259
301
|
/**
|
|
260
302
|
* Context stored in AsyncLocalStorage
|
|
261
303
|
*/
|
|
@@ -266,6 +308,10 @@ interface HelperContext {
|
|
|
266
308
|
counters: Record<string, number>;
|
|
267
309
|
forRoute?: string;
|
|
268
310
|
mountIndex?: number;
|
|
311
|
+
/** Owning router id, when known (threaded by generateManifestFull). Scopes
|
|
312
|
+
* the search-schema/root-scope registries so same-named routes in
|
|
313
|
+
* different routers don't clobber each other (route-map-builder.ts). */
|
|
314
|
+
routerId?: string;
|
|
269
315
|
metrics?: MetricsStore;
|
|
270
316
|
/** True when rendering for SSR (document requests) */
|
|
271
317
|
isSSR?: boolean;
|
|
@@ -296,6 +342,13 @@ interface HelperContext {
|
|
|
296
342
|
/** True when resolving handlers inside a cache() DSL boundary.
|
|
297
343
|
* Read by ctx.get() to guard non-cacheable variable reads. */
|
|
298
344
|
insideCacheScope?: boolean;
|
|
345
|
+
/**
|
|
346
|
+
* RULE (issue #713): in any cached scenario ONLY MIDDLEWARE writes response
|
|
347
|
+
* headers. Latched by the segment funnels, consulted by
|
|
348
|
+
* assertCachedHeaderWriteAllowed(); full doctrine in
|
|
349
|
+
* docs/design/ppr-shell-resume.md "The header doctrine".
|
|
350
|
+
*/
|
|
351
|
+
cachedHeaderScope?: CachedHeaderScope;
|
|
299
352
|
/**
|
|
300
353
|
* Include scope string applied to direct-descendant shortCodes.
|
|
301
354
|
*
|
|
@@ -452,6 +505,7 @@ export const getContext = (): {
|
|
|
452
505
|
counters: store.counters,
|
|
453
506
|
forRoute: store.forRoute,
|
|
454
507
|
mountIndex: store.mountIndex,
|
|
508
|
+
routerId: store.routerId,
|
|
455
509
|
metrics: store.metrics,
|
|
456
510
|
isSSR: store.isSSR,
|
|
457
511
|
patterns: store.patterns,
|
|
@@ -463,6 +517,9 @@ export const getContext = (): {
|
|
|
463
517
|
trackedIncludes: store.trackedIncludes,
|
|
464
518
|
cacheProfiles: store.cacheProfiles,
|
|
465
519
|
includeScope: store.includeScope,
|
|
520
|
+
// cachedHeaderScope (and insideCacheScope) deliberately NOT copied —
|
|
521
|
+
// the header guard's middleware exemption depends on the latch dying
|
|
522
|
+
// with the funnel scope (see assertCachedHeaderWriteAllowed).
|
|
466
523
|
},
|
|
467
524
|
callback,
|
|
468
525
|
);
|
|
@@ -491,6 +548,7 @@ export const getContext = (): {
|
|
|
491
548
|
counters,
|
|
492
549
|
forRoute: store?.forRoute,
|
|
493
550
|
mountIndex: store?.mountIndex,
|
|
551
|
+
routerId: store?.routerId,
|
|
494
552
|
metrics: store?.metrics,
|
|
495
553
|
isSSR: store?.isSSR,
|
|
496
554
|
patterns,
|
|
@@ -624,6 +682,28 @@ export function getRootScoped(): boolean {
|
|
|
624
682
|
return store?.rootScoped ?? true;
|
|
625
683
|
}
|
|
626
684
|
|
|
685
|
+
/**
|
|
686
|
+
* Stamp build-time scope identity onto a Static() definition at mount time.
|
|
687
|
+
* The bake collector (prerender-collection.ts) renders defs OUTSIDE any
|
|
688
|
+
* evaluation scope and used to iterate the registry first-non-null, so these
|
|
689
|
+
* are the ONLY reliable carriers of the def's owning router, root-scope, and
|
|
690
|
+
* full route name — a name-keyed registry lookup at bake time reproduces the
|
|
691
|
+
* cross-router collision #757/#762 fixed (and the collector's historical
|
|
692
|
+
* `$$routePrefix` argument is a name PREFIX, which the root-scope registry
|
|
693
|
+
* never contains, silently degrading to the dot-heuristic).
|
|
694
|
+
* A definition mounted more than once is stamped each time; the last mount wins.
|
|
695
|
+
*/
|
|
696
|
+
export function stampStaticDefScope(
|
|
697
|
+
handler: unknown,
|
|
698
|
+
routeName?: string,
|
|
699
|
+
): void {
|
|
700
|
+
const store = RangoContext.getStore();
|
|
701
|
+
const def = handler as Record<string, unknown>;
|
|
702
|
+
if (routeName !== undefined) def.$$routeName = routeName;
|
|
703
|
+
def.$$rootScoped = getRootScoped();
|
|
704
|
+
if (store?.routerId !== undefined) def.$$routerId = store.routerId;
|
|
705
|
+
}
|
|
706
|
+
|
|
627
707
|
// Export HelperContext type for use in other modules
|
|
628
708
|
export type { HelperContext };
|
|
629
709
|
|
|
@@ -750,14 +830,23 @@ const loaderScopeALS: AsyncLocalStorage<{ active: true }> = ((
|
|
|
750
830
|
|
|
751
831
|
// Purity-only scope: marks that a loader FUNCTION BODY is executing, regardless
|
|
752
832
|
// of how the loader was invoked (DSL via runInsideLoaderScope, or handler-
|
|
753
|
-
// invoked via ctx.use). Consulted
|
|
754
|
-
// request-scoped reads
|
|
755
|
-
//
|
|
756
|
-
//
|
|
833
|
+
// invoked via ctx.use). Consulted by isInsideCacheScope() to exempt
|
|
834
|
+
// request-scoped reads, by getCurrentLoaderBodyId() for guard-warning
|
|
835
|
+
// attribution, and by isInsideHandlerInvokedLoaderBody() for the
|
|
836
|
+
// consumption-lane rule (the shell-capture guard exemption). It deliberately
|
|
837
|
+
// does NOT affect isInsideLoaderScope(), so rendered()/barrier/deadlock
|
|
838
|
+
// gating (which must distinguish DSL from handler-invoked loaders) is
|
|
839
|
+
// unchanged.
|
|
757
840
|
const LOADER_BODY_SCOPE_KEY = Symbol.for("rangojs-router:loader-body-scope");
|
|
758
|
-
const loaderBodyScopeALS: AsyncLocalStorage<{
|
|
759
|
-
|
|
760
|
-
|
|
841
|
+
const loaderBodyScopeALS: AsyncLocalStorage<{
|
|
842
|
+
active: true;
|
|
843
|
+
loaderId?: string;
|
|
844
|
+
handlerInvoked?: boolean;
|
|
845
|
+
}> = ((globalThis as any)[LOADER_BODY_SCOPE_KEY] ??= new AsyncLocalStorage<{
|
|
846
|
+
active: true;
|
|
847
|
+
loaderId?: string;
|
|
848
|
+
handlerInvoked?: boolean;
|
|
849
|
+
}>());
|
|
761
850
|
|
|
762
851
|
/**
|
|
763
852
|
* Check if the current execution is inside a cache() DSL boundary.
|
|
@@ -766,14 +855,15 @@ const loaderBodyScopeALS: AsyncLocalStorage<{ active: true }> = ((
|
|
|
766
855
|
*/
|
|
767
856
|
export function isInsideCacheScope(): boolean {
|
|
768
857
|
if (RangoContext.getStore()?.insideCacheScope !== true) return false;
|
|
769
|
-
//
|
|
770
|
-
//
|
|
771
|
-
//
|
|
772
|
-
|
|
773
|
-
//
|
|
774
|
-
//
|
|
775
|
-
//
|
|
776
|
-
|
|
858
|
+
// Request-scoped READS are exempt in any loader body — DSL loaders re-run on
|
|
859
|
+
// every request (including cache() HITs via resolveLoadersOnly), and a
|
|
860
|
+
// handler-invoked loader body, though skipped with its handler on a HIT,
|
|
861
|
+
// yields a BAKED shared copy in the cached artifact — an accepted
|
|
862
|
+
// consumption-lane tradeoff (#672/#674). This is deliberately BROADER than
|
|
863
|
+
// the WRITE guard (assertCachedHeaderWriteAllowed narrows the cache()
|
|
864
|
+
// exemption to DSL scope, #725): a read bakes-and-accepts, a Set-Cookie/header
|
|
865
|
+
// write drops-and-throws because it has no baked-copy semantics on a HIT.
|
|
866
|
+
if (isInsideAnyLoaderScope()) return false;
|
|
777
867
|
return true;
|
|
778
868
|
}
|
|
779
869
|
|
|
@@ -786,6 +876,159 @@ export function isInsideLoaderScope(): boolean {
|
|
|
786
876
|
return loaderScopeALS.getStore()?.active === true;
|
|
787
877
|
}
|
|
788
878
|
|
|
879
|
+
/**
|
|
880
|
+
* Latch the cached header-write scope for the current request. First latch
|
|
881
|
+
* wins: a ppr route latched at the funnel top is not downgraded by a nested
|
|
882
|
+
* cache() entry (the document-scoped wording is the more useful one).
|
|
883
|
+
* Takes scalars so the already-latched path allocates nothing.
|
|
884
|
+
*/
|
|
885
|
+
export function latchCachedHeaderScope(
|
|
886
|
+
kind: CachedHeaderScope["kind"],
|
|
887
|
+
routeKey?: string,
|
|
888
|
+
): void {
|
|
889
|
+
const store = RangoContext.getStore();
|
|
890
|
+
if (store && !store.cachedHeaderScope) {
|
|
891
|
+
store.cachedHeaderScope = { kind, routeKey };
|
|
892
|
+
}
|
|
893
|
+
}
|
|
894
|
+
|
|
895
|
+
/** True inside ANY loader execution — DSL loader scope or a loader body
|
|
896
|
+
* (however invoked). The "loaders always re-run fresh" exemptions key off
|
|
897
|
+
* this. */
|
|
898
|
+
function isInsideAnyLoaderScope(): boolean {
|
|
899
|
+
return (
|
|
900
|
+
loaderScopeALS.getStore()?.active === true ||
|
|
901
|
+
loaderBodyScopeALS.getStore()?.active === true
|
|
902
|
+
);
|
|
903
|
+
}
|
|
904
|
+
|
|
905
|
+
/**
|
|
906
|
+
* The one ppr opt-in predicate: a page route entry that DECLARED `ppr`
|
|
907
|
+
* (`false` and undefined mean plain axis 1). Shared by the serve path
|
|
908
|
+
* (rsc/shell-serve.ts resolvePprConfig) and the header-write latch below so
|
|
909
|
+
* the two layers can never drift on what counts as a ppr route.
|
|
910
|
+
*/
|
|
911
|
+
export function isPprEntry(entry: EntryData): entry is EntryData & {
|
|
912
|
+
type: "route";
|
|
913
|
+
ppr: true | import("../urls/pattern-types.js").PartialPrerenderProps;
|
|
914
|
+
} {
|
|
915
|
+
return (
|
|
916
|
+
entry.type === "route" && entry.ppr !== undefined && entry.ppr !== false
|
|
917
|
+
);
|
|
918
|
+
}
|
|
919
|
+
|
|
920
|
+
/**
|
|
921
|
+
* Latch the ppr header-write scope when the entry chain about to resolve is a
|
|
922
|
+
* `ppr` page route's. Called at the TOP of every segment funnel — unlike
|
|
923
|
+
* cache() (positional: ancestors before the boundary stay writable), ppr is
|
|
924
|
+
* document-scoped: the root layout down to the page bakes into the shared
|
|
925
|
+
* shell, so the whole funnel is cached territory.
|
|
926
|
+
*
|
|
927
|
+
* Checks the LEAF entry only: `entries` is the traverseBack chain
|
|
928
|
+
* [root, ..., manifestEntry], and the serve path reads `ppr` off the same
|
|
929
|
+
* leaf (rsc-rendering.ts: resolvePprConfig(manifestEntry)) — guard and serve
|
|
930
|
+
* share the predicate (isPprEntry) AND the input, so they cannot drift.
|
|
931
|
+
*/
|
|
932
|
+
export function latchPprHeaderScopeForEntries(
|
|
933
|
+
entries: EntryData[],
|
|
934
|
+
routeKey?: string,
|
|
935
|
+
): void {
|
|
936
|
+
const store = RangoContext.getStore();
|
|
937
|
+
if (!store || store.cachedHeaderScope) return;
|
|
938
|
+
const leaf = entries[entries.length - 1];
|
|
939
|
+
if (leaf !== undefined && isPprEntry(leaf)) {
|
|
940
|
+
store.cachedHeaderScope = { kind: "ppr", routeKey };
|
|
941
|
+
}
|
|
942
|
+
}
|
|
943
|
+
|
|
944
|
+
/**
|
|
945
|
+
* Clear the ppr header-write latch for the remainder of this render (issue
|
|
946
|
+
* #735). Called by ctx.dynamic(): a dynamic() render opts off the SHELL axis
|
|
947
|
+
* (rsc-rendering.ts skips both the HIT commit and the MISS capture on
|
|
948
|
+
* `_dynamic`), so it is ALWAYS live — every request re-runs the handler and its
|
|
949
|
+
* header write lands identically each time. The guard's reason to forbid it
|
|
950
|
+
* (MISS/HIT divergence) evaporates, so the write is re-permitted.
|
|
951
|
+
*
|
|
952
|
+
* ONLY the ppr (shell) axis is dropped — dynamic() does NOT opt off the CACHE
|
|
953
|
+
* axis. Two cases:
|
|
954
|
+
* - Pure ppr funnel (no cache() boundary): clear the latch → writes re-permit.
|
|
955
|
+
* - ppr route nested under a cache() boundary: fresh.ts latches "ppr" at the
|
|
956
|
+
* funnel top (first-wins), which MASKS the positional cache() latch, but the
|
|
957
|
+
* handler still runs inside the cache scope (`insideCacheScope`). A cache()
|
|
958
|
+
* HIT skips that handler, so the write is still non-deterministic — UNMASK to
|
|
959
|
+
* "cache" instead of clearing, so the guard keeps throwing (accurate cache()
|
|
960
|
+
* wording). This is why the check keys off `insideCacheScope`, not just kind.
|
|
961
|
+
*
|
|
962
|
+
* A subsequent cache() entered AFTER dynamic() on a pure-ppr funnel re-latches
|
|
963
|
+
* "cache" via latchCachedHeaderScope's `!store.cachedHeaderScope` guard (the
|
|
964
|
+
* field is undefined again once cleared). No-op when there is no funnel store or
|
|
965
|
+
* no ppr latch (dynamic() from middleware runs outside the funnel Store.run
|
|
966
|
+
* scope, so nothing is latched — the middleware exemption is unchanged).
|
|
967
|
+
*/
|
|
968
|
+
export function clearPprHeaderScope(): void {
|
|
969
|
+
const store = RangoContext.getStore();
|
|
970
|
+
if (store?.cachedHeaderScope?.kind !== "ppr") return;
|
|
971
|
+
store.cachedHeaderScope = store.insideCacheScope
|
|
972
|
+
? { kind: "cache", routeKey: store.cachedHeaderScope.routeKey }
|
|
973
|
+
: undefined;
|
|
974
|
+
}
|
|
975
|
+
|
|
976
|
+
/**
|
|
977
|
+
* RULE (issue #713): in any cached scenario ONLY MIDDLEWARE writes response
|
|
978
|
+
* headers — handler and loader writes throw while a scope is latched; the one
|
|
979
|
+
* exemption is DSL (registered) loaders under plain cache(). A handler-invoked
|
|
980
|
+
* loader body (ctx.use from a handler, never registered with loader()) is
|
|
981
|
+
* skipped with its handler on a HIT and throws like a handler write (#725).
|
|
982
|
+
* A ctx.dynamic() render clears the ppr latch (clearPprHeaderScope, #735) so
|
|
983
|
+
* its always-live handler header writes are re-permitted. Full layer rules and
|
|
984
|
+
* rationale: docs/design/ppr-shell-resume.md "The header doctrine".
|
|
985
|
+
*/
|
|
986
|
+
export function assertCachedHeaderWriteAllowed(
|
|
987
|
+
surface: string,
|
|
988
|
+
surfaceProp?: string | symbol,
|
|
989
|
+
): void {
|
|
990
|
+
const scope = RangoContext.getStore()?.cachedHeaderScope;
|
|
991
|
+
if (!scope) return;
|
|
992
|
+
// Exempt DSL loaders (loaderScopeALS) ONLY. A registered loader re-runs on
|
|
993
|
+
// every cache HIT (fresh.ts runInsideLoaderScope -> cache-lookup.ts
|
|
994
|
+
// resolveLoadersOnly), so its header/cookie writes merge into every response
|
|
995
|
+
// with no MISS/HIT divergence. A handler-invoked loader body has
|
|
996
|
+
// loaderBodyScopeALS active but loaderScopeALS unset (loader-resolution.ts
|
|
997
|
+
// derives isDslLoader from isInsideLoaderScope()); on a HIT the handler is
|
|
998
|
+
// skipped so that loader never re-runs and its write would land only on the
|
|
999
|
+
// MISS — throw it. isInsideLoaderScope() (not isInsideAnyLoaderScope) is the
|
|
1000
|
+
// discriminator; the DSL scope ALS survives nested ctx.use bodies, so a
|
|
1001
|
+
// handler-invoked loader nested under a DSL loader stays exempt (its DSL
|
|
1002
|
+
// parent re-invokes it on every HIT). This is the exempt fast path, so the
|
|
1003
|
+
// broad predicate for the error label is deferred to the throw path below.
|
|
1004
|
+
if (scope.kind === "cache" && isInsideLoaderScope()) return;
|
|
1005
|
+
// Everything below runs only on the throw path — `surfaceProp` exists so
|
|
1006
|
+
// callers pass constants and the success path allocates nothing (the full
|
|
1007
|
+
// surface, e.g. "ctx.headers.set()", is assembled here). isInsideAnyLoaderScope
|
|
1008
|
+
// (broad) labels a now-throwing handler-invoked loader body "loader".
|
|
1009
|
+
const fullSurface =
|
|
1010
|
+
surfaceProp === undefined ? surface : `${surface}.${String(surfaceProp)}()`;
|
|
1011
|
+
const layer = isInsideAnyLoaderScope() ? "loader" : "handler";
|
|
1012
|
+
const route = scope.routeKey ? ` (route "${scope.routeKey}")` : "";
|
|
1013
|
+
const where =
|
|
1014
|
+
scope.kind === "ppr"
|
|
1015
|
+
? `on a ppr route${route} — the document shell is cached and replayed`
|
|
1016
|
+
: `inside a cache() boundary${route}`;
|
|
1017
|
+
// ppr loader writes fail by physics (headers flush before loaders settle);
|
|
1018
|
+
// every other throw — a handler, or a handler-invoked loader under cache() —
|
|
1019
|
+
// fails because the handler is skipped on a HIT, so key the reason on the
|
|
1020
|
+
// scope kind, not the layer.
|
|
1021
|
+
const why =
|
|
1022
|
+
scope.kind === "ppr" && layer === "loader"
|
|
1023
|
+
? "The response headers flush with the shell before loaders settle, so this write is dropped on cache hits."
|
|
1024
|
+
: "On a cache hit the handler is skipped, so this write would silently vanish.";
|
|
1025
|
+
throw new Error(
|
|
1026
|
+
`${fullSurface} cannot be called from a ${layer} ${where}. ${why} ` +
|
|
1027
|
+
"Set response headers in route middleware instead — middleware runs " +
|
|
1028
|
+
"on every request, including cache hits.",
|
|
1029
|
+
);
|
|
1030
|
+
}
|
|
1031
|
+
|
|
789
1032
|
/**
|
|
790
1033
|
* Run `fn` inside a loader scope. While active, cache-scope guards
|
|
791
1034
|
* are bypassed because loaders are always fresh (never cached) and
|
|
@@ -802,8 +1045,37 @@ export function runInsideLoaderScope<T>(fn: () => T): T {
|
|
|
802
1045
|
* and handler-invoked via ctx.use) so request-scoped reads inside a loader
|
|
803
1046
|
* never trip the cache-scope guards — loaders always run fresh.
|
|
804
1047
|
*/
|
|
805
|
-
export function runInsideLoaderBodyScope<T>(
|
|
806
|
-
|
|
1048
|
+
export function runInsideLoaderBodyScope<T>(
|
|
1049
|
+
fn: () => T,
|
|
1050
|
+
loaderId?: string,
|
|
1051
|
+
handlerInvoked?: boolean,
|
|
1052
|
+
): T {
|
|
1053
|
+
return loaderBodyScopeALS.run({ active: true, loaderId, handlerInvoked }, fn);
|
|
1054
|
+
}
|
|
1055
|
+
|
|
1056
|
+
/**
|
|
1057
|
+
* The $$id of the loader whose body is currently executing, or undefined
|
|
1058
|
+
* outside any loader body. Used by the shell-capture identity guard
|
|
1059
|
+
* (cookie-store.ts) so its refusal warning can name the loader that read
|
|
1060
|
+
* cookies()/headers() instead of blaming a lane it cannot see — the old
|
|
1061
|
+
* hardcoded "bake-lane loader" text misled a live-lane debugging session
|
|
1062
|
+
* (issue #672, secondary).
|
|
1063
|
+
*/
|
|
1064
|
+
export function getCurrentLoaderBodyId(): string | undefined {
|
|
1065
|
+
return loaderBodyScopeALS.getStore()?.loaderId;
|
|
1066
|
+
}
|
|
1067
|
+
|
|
1068
|
+
/**
|
|
1069
|
+
* True while a HANDLER-invoked loader body (`await ctx.use(Loader)` from a
|
|
1070
|
+
* handler, not the DSL segment funnel) is executing. The consumption-lane
|
|
1071
|
+
* rule keys off this: handler consumption yields a BAKED copy in every shared
|
|
1072
|
+
* artifact — cache(), "use cache", and the PPR shell — so the shell-capture
|
|
1073
|
+
* identity guard (cookie-store.ts) permits cookies()/headers() here, exactly
|
|
1074
|
+
* like the cache-purity guards do. DSL segment loaders (live lane masked at
|
|
1075
|
+
* capture, bake lane guarded) never set the flag.
|
|
1076
|
+
*/
|
|
1077
|
+
export function isInsideHandlerInvokedLoaderBody(): boolean {
|
|
1078
|
+
return loaderBodyScopeALS.getStore()?.handlerInvoked === true;
|
|
807
1079
|
}
|
|
808
1080
|
|
|
809
1081
|
// Scope for handle PUSH CALLBACKS (push(() => ...), including async ones).
|
|
@@ -9,8 +9,12 @@
|
|
|
9
9
|
|
|
10
10
|
import type { CookieOptions } from "../router/middleware-types.js";
|
|
11
11
|
import { getRequestContext, _getRequestContext } from "./request-context.js";
|
|
12
|
-
import {
|
|
13
|
-
|
|
12
|
+
import {
|
|
13
|
+
isInsideCacheScope,
|
|
14
|
+
getCurrentLoaderBodyId,
|
|
15
|
+
isInsideHandlerInvokedLoaderBody,
|
|
16
|
+
} from "./context.js";
|
|
17
|
+
import { isInsideCacheExecScope } from "../cache/cache-exec-scope.js";
|
|
14
18
|
|
|
15
19
|
/**
|
|
16
20
|
* A single cookie entry returned by get() and getAll().
|
|
@@ -61,7 +65,8 @@ export interface CookieStore {
|
|
|
61
65
|
*/
|
|
62
66
|
export function cookies(): CookieStore {
|
|
63
67
|
const ctx = getRequestContext();
|
|
64
|
-
assertNotInsideCacheContext(
|
|
68
|
+
assertNotInsideCacheContext("cookies");
|
|
69
|
+
assertNotInsideShellCapture(ctx, "cookies");
|
|
65
70
|
return createCookieStore(ctx);
|
|
66
71
|
}
|
|
67
72
|
|
|
@@ -86,9 +91,10 @@ type HeadersIterator<T> = IterableIterator<T>;
|
|
|
86
91
|
|
|
87
92
|
/**
|
|
88
93
|
* Throw if called inside a cache boundary — either a "use cache" function
|
|
89
|
-
* (`
|
|
90
|
-
*
|
|
91
|
-
*
|
|
94
|
+
* (`isInsideCacheExecScope()` — the AsyncLocalStorage scope the cache runtime
|
|
95
|
+
* enters around the cached body) or a `cache()` DSL boundary
|
|
96
|
+
* (`isInsideCacheScope()` — the render-store flag set while resolving a
|
|
97
|
+
* `type: "cache"` route entry).
|
|
92
98
|
*
|
|
93
99
|
* Reading request-scoped data (cookies, headers) inside a cached scope
|
|
94
100
|
* produces per-request values that are NOT reflected in the cache key, so
|
|
@@ -98,18 +104,17 @@ type HeadersIterator<T> = IterableIterator<T>;
|
|
|
98
104
|
* here is baked into the shell exactly like a `"use cache"` return value is
|
|
99
105
|
* baked into its cache entry.
|
|
100
106
|
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
104
|
-
*
|
|
107
|
+
* Both checks are scoped so loaders stay exempt — loaders are the dynamic
|
|
108
|
+
* "holes" of a cached document and always run fresh. `isInsideCacheScope()`
|
|
109
|
+
* returns false inside loaders by construction; `isInsideCacheExecScope()`
|
|
110
|
+
* follows the cached body's own async chain, so a loader running in PARALLEL
|
|
111
|
+
* with a slow "use cache" fetch on the same request reads cookies() freely.
|
|
112
|
+
* (Scar: the previous INSIDE_CACHE_EXEC stamp on the shared RequestContext
|
|
113
|
+
* made exactly that parallel read throw for the cached fetch's whole
|
|
114
|
+
* execution window — see cache-exec-scope.ts.)
|
|
105
115
|
*/
|
|
106
|
-
function assertNotInsideCacheContext(
|
|
107
|
-
if (
|
|
108
|
-
ctx !== null &&
|
|
109
|
-
ctx !== undefined &&
|
|
110
|
-
typeof ctx === "object" &&
|
|
111
|
-
(INSIDE_CACHE_EXEC as symbol) in (ctx as Record<symbol, unknown>)
|
|
112
|
-
) {
|
|
116
|
+
function assertNotInsideCacheContext(fnName: string): void {
|
|
117
|
+
if (isInsideCacheExecScope()) {
|
|
113
118
|
throw new Error(
|
|
114
119
|
`${fnName}() cannot be called inside a "use cache" function. ` +
|
|
115
120
|
`Request-scoped data (cookies, headers) varies per request but is not ` +
|
|
@@ -132,6 +137,72 @@ function assertNotInsideCacheContext(ctx: unknown, fnName: string): void {
|
|
|
132
137
|
}
|
|
133
138
|
}
|
|
134
139
|
|
|
140
|
+
/**
|
|
141
|
+
* Throw if called during the ACTIVE background shell-capture render
|
|
142
|
+
* (`_shellCaptureRun` true on the derived request context built by
|
|
143
|
+
* shell-capture.ts). The captured shell prelude is shared across every user
|
|
144
|
+
* hitting the URL, so a request-scoped read here would bake one user's
|
|
145
|
+
* cookies/headers into markup served to others — same hazard as the cache
|
|
146
|
+
* scopes above, at the document tier. DSL segment loaders need no exemption:
|
|
147
|
+
* the live lane is masked (never executed) during capture, and the bake lane
|
|
148
|
+
* is exactly what this guard exists for.
|
|
149
|
+
*
|
|
150
|
+
* HANDLER-INVOKED loader bodies (`await ctx.use(Loader)` from a handler) are
|
|
151
|
+
* EXEMPT — the consumption-lane rule: handler consumption yields a BAKED
|
|
152
|
+
* shared copy in every artifact tier, and the cache-purity guards above
|
|
153
|
+
* already permit identity reads there (cache()/"use cache" bake the same
|
|
154
|
+
* reads today). Guarding only the PPR tier made the same code legal under
|
|
155
|
+
* cache() but capture-refusing under ppr (issue #672 / #674). The trade is
|
|
156
|
+
* documented: an identity read in a handler-consumed loader bakes the CAPTURE
|
|
157
|
+
* request's value into the shared shell; client-side consumption (useLoader)
|
|
158
|
+
* is the live lane.
|
|
159
|
+
*
|
|
160
|
+
* Keys off `_shellCaptureRun`, NOT the `_shellCapture` descriptor: the descriptor
|
|
161
|
+
* is also present during the FOREGROUND render (it means "a capture is wanted"),
|
|
162
|
+
* and the foreground must read cookies/headers normally to serve the real user.
|
|
163
|
+
* Only the derived capture context sets `_shellCaptureRun`.
|
|
164
|
+
*
|
|
165
|
+
* Applies only to the READ surfaces (cookies(), headers()) whose values
|
|
166
|
+
* become markup. Response directives (invalidateClientCache(),
|
|
167
|
+
* keepClientCache()) stay callable: during capture they are header effects on
|
|
168
|
+
* a discarded response, and on the live HIT path the full pipeline runs so their
|
|
169
|
+
* headers flow to the client normally.
|
|
170
|
+
*
|
|
171
|
+
* The throw makes such a route PPR-ineligible by construction: the capture
|
|
172
|
+
* render errors, nothing is stored, and every request keeps getting the
|
|
173
|
+
* normal axis-1 render.
|
|
174
|
+
*/
|
|
175
|
+
function assertNotInsideShellCapture(ctx: unknown, fnName: string): void {
|
|
176
|
+
if (
|
|
177
|
+
ctx !== null &&
|
|
178
|
+
typeof ctx === "object" &&
|
|
179
|
+
(ctx as { _shellCaptureRun?: unknown })._shellCaptureRun === true
|
|
180
|
+
) {
|
|
181
|
+
if (isInsideHandlerInvokedLoaderBody()) return;
|
|
182
|
+
// Flag the capture context BEFORE throwing: inside an executing bake-lane
|
|
183
|
+
// loader this throw is swallowed by wrapLoaderPromise into per-loader error
|
|
184
|
+
// UI, which would bake silently into the shared shell. The capture checks
|
|
185
|
+
// the flag after the render and refuses (shell-capture.ts). Also record
|
|
186
|
+
// WHICH loader body (if any) made the read, so the refusal warning can
|
|
187
|
+
// name the real source instead of hardcoding a lane — the read may come
|
|
188
|
+
// from a bake-lane loader OR from handler/render code (issue #672).
|
|
189
|
+
(ctx as { _shellCaptureGuardTripped?: string })._shellCaptureGuardTripped =
|
|
190
|
+
fnName;
|
|
191
|
+
(
|
|
192
|
+
ctx as { _shellCaptureGuardTrippedLoaderId?: string }
|
|
193
|
+
)._shellCaptureGuardTrippedLoaderId = getCurrentLoaderBodyId();
|
|
194
|
+
throw new Error(
|
|
195
|
+
`${fnName}() cannot be called while capturing a shared shell ` +
|
|
196
|
+
`(shell-cache middleware). The captured shell is served to every user ` +
|
|
197
|
+
`of this URL, so request-scoped data read here would leak one user's ` +
|
|
198
|
+
`${fnName === "cookies" ? "cookies" : "headers"} to others. Read it ` +
|
|
199
|
+
`inside a loader instead — loaders are never captured and always run ` +
|
|
200
|
+
`fresh per request:\n\n` +
|
|
201
|
+
` loader("user", () => getUser(cookies().get("session")?.value));`,
|
|
202
|
+
);
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
|
|
135
206
|
const HEADERS_MUTATION_METHODS = new Set(["set", "append", "delete"]);
|
|
136
207
|
|
|
137
208
|
/**
|
|
@@ -151,7 +222,8 @@ const HEADERS_MUTATION_METHODS = new Set(["set", "append", "delete"]);
|
|
|
151
222
|
*/
|
|
152
223
|
export function headers(): ReadonlyHeaders {
|
|
153
224
|
const ctx = getRequestContext();
|
|
154
|
-
assertNotInsideCacheContext(
|
|
225
|
+
assertNotInsideCacheContext("headers");
|
|
226
|
+
assertNotInsideShellCapture(ctx, "headers");
|
|
155
227
|
return new Proxy(ctx.request.headers, {
|
|
156
228
|
get(target, prop, receiver) {
|
|
157
229
|
if (typeof prop === "string" && HEADERS_MUTATION_METHODS.has(prop)) {
|
|
@@ -190,7 +262,7 @@ export function invalidateClientCache(): void {
|
|
|
190
262
|
}
|
|
191
263
|
return;
|
|
192
264
|
}
|
|
193
|
-
assertNotInsideCacheContext(
|
|
265
|
+
assertNotInsideCacheContext("invalidateClientCache");
|
|
194
266
|
ctx._rotateStateCookie();
|
|
195
267
|
}
|
|
196
268
|
|
|
@@ -215,7 +287,7 @@ export function keepClientCache(): void {
|
|
|
215
287
|
}
|
|
216
288
|
return;
|
|
217
289
|
}
|
|
218
|
-
assertNotInsideCacheContext(
|
|
290
|
+
assertNotInsideCacheContext("keepClientCache");
|
|
219
291
|
ctx._setKeepCacheDirective();
|
|
220
292
|
}
|
|
221
293
|
|