@rangojs/router 0.0.0-experimental.d20dd405 → 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 +8 -4
- package/README.md +314 -882
- package/dist/bin/rango.js +927 -273
- package/dist/testing/vitest.js +82 -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/vite/index.js +10195 -4376
- package/package.json +119 -38
- package/skills/api-client/SKILL.md +211 -0
- package/skills/breadcrumbs/SKILL.md +114 -7
- package/skills/bundle-analysis/SKILL.md +159 -0
- package/skills/cache-guide/SKILL.md +232 -34
- package/skills/caching/SKILL.md +375 -19
- 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 +124 -4
- package/skills/css/SKILL.md +76 -0
- package/skills/debug-manifest/SKILL.md +5 -11
- package/skills/defer-hydration/SKILL.md +235 -0
- package/skills/deployment-caching/SKILL.md +176 -0
- package/skills/document-cache/SKILL.md +116 -58
- package/skills/fonts/SKILL.md +1 -1
- package/skills/handler-use/SKILL.md +10 -10
- package/skills/hooks/SKILL.md +73 -725
- 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 +129 -27
- package/skills/i18n/SKILL.md +1 -1
- package/skills/intercept/SKILL.md +50 -19
- package/skills/layout/SKILL.md +38 -19
- package/skills/links/SKILL.md +59 -11
- package/skills/loader/SKILL.md +324 -25
- package/skills/middleware/SKILL.md +56 -13
- package/skills/migrate-nextjs/SKILL.md +334 -42
- package/skills/migrate-nextjs/backend-host-swap.md +120 -0
- package/skills/migrate-react-router/SKILL.md +95 -675
- 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 +55 -18
- package/skills/observability/SKILL.md +231 -0
- package/skills/parallel/SKILL.md +63 -11
- package/skills/ppr/SKILL.md +918 -0
- package/skills/prerender/SKILL.md +137 -71
- package/skills/rango/SKILL.md +325 -28
- package/skills/react-compiler/SKILL.md +168 -0
- package/skills/response-routes/SKILL.md +172 -52
- package/skills/route/SKILL.md +102 -9
- package/skills/router-setup/SKILL.md +69 -11
- package/skills/scripts/SKILL.md +189 -0
- package/skills/server-actions/SKILL.md +81 -44
- package/skills/shell-manifest/SKILL.md +194 -0
- package/skills/streams-and-websockets/SKILL.md +1 -1
- package/skills/tailwind/SKILL.md +28 -4
- package/skills/testing/SKILL.md +131 -0
- package/skills/testing/bindings.md +103 -0
- package/skills/testing/cache-prerender.md +172 -0
- package/skills/testing/client-components.md +131 -0
- package/skills/testing/e2e-parity.md +125 -0
- package/skills/testing/flight.md +91 -0
- package/skills/testing/handles.md +153 -0
- package/skills/testing/loader.md +130 -0
- package/skills/testing/middleware.md +99 -0
- package/skills/testing/render-handler.md +122 -0
- package/skills/testing/response-routes.md +95 -0
- package/skills/testing/reverse-and-types.md +85 -0
- package/skills/testing/server-actions.md +107 -0
- package/skills/testing/server-tree.md +128 -0
- package/skills/testing/setup.md +123 -0
- package/skills/theme/SKILL.md +9 -6
- package/skills/typesafety/SKILL.md +45 -634
- 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 +121 -15
- package/skills/vercel/SKILL.md +149 -0
- package/skills/view-transitions/SKILL.md +133 -4
- package/src/__augment-tests__/augment.ts +81 -0
- package/src/__augment-tests__/augmented.check.ts +116 -0
- package/src/__internal.ts +0 -65
- package/src/bin/rango.ts +7 -3
- package/src/browser/action-coordinator.ts +53 -36
- package/src/browser/action-fence.ts +47 -0
- package/src/browser/app-shell.ts +14 -27
- package/src/browser/connection-warmup.ts +134 -0
- package/src/browser/cookie-name.ts +140 -0
- package/src/browser/dev-discovery.ts +66 -0
- package/src/browser/event-controller.ts +359 -167
- package/src/browser/history-state.ts +21 -0
- package/src/browser/index.ts +3 -3
- package/src/browser/invalidate-client-cache.ts +52 -0
- 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 +159 -129
- package/src/browser/navigation-client.ts +199 -96
- package/src/browser/navigation-store-handle.ts +38 -0
- package/src/browser/navigation-store.ts +165 -345
- package/src/browser/navigation-transaction.ts +9 -59
- package/src/browser/network-error-handler.ts +34 -7
- package/src/browser/notify-listeners.ts +22 -0
- package/src/browser/partial-update.ts +226 -161
- package/src/browser/prefetch/cache.ts +240 -97
- package/src/browser/prefetch/default-strategy.ts +74 -0
- package/src/browser/prefetch/fetch.ts +317 -51
- 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 +25 -7
- package/src/browser/prefetch/runtime.ts +6 -0
- package/src/browser/rango-state.ts +177 -114
- package/src/browser/react/Link.tsx +142 -79
- package/src/browser/react/NavigationProvider.tsx +202 -163
- package/src/browser/react/ScrollRestoration.tsx +10 -6
- package/src/browser/react/context.ts +4 -0
- package/src/browser/react/filter-segment-order.ts +17 -2
- package/src/browser/react/index.ts +0 -51
- package/src/browser/react/location-state-shared.ts +178 -8
- package/src/browser/react/location-state.ts +39 -14
- package/src/browser/react/use-action.ts +6 -15
- package/src/browser/react/use-handle.ts +17 -14
- package/src/browser/react/use-href.tsx +8 -1
- package/src/browser/react/use-link-status.ts +33 -8
- package/src/browser/react/use-navigation.ts +10 -5
- package/src/browser/react/use-params.ts +3 -6
- package/src/browser/react/use-reverse.ts +19 -12
- package/src/browser/react/use-router.ts +61 -17
- package/src/browser/react/use-search-params.ts +140 -22
- package/src/browser/react/use-segments.ts +0 -13
- package/src/browser/response-adapter.ts +99 -8
- package/src/browser/rsc-router.tsx +230 -42
- package/src/browser/scroll-restoration.ts +45 -33
- package/src/browser/segment-reconciler.ts +31 -21
- package/src/browser/segment-structure-assert.ts +2 -2
- package/src/browser/server-action-bridge.ts +262 -65
- package/src/browser/types.ts +126 -47
- package/src/browser/validate-redirect-origin.ts +43 -16
- package/src/build/collect-fallback-refs.ts +107 -0
- package/src/build/generate-manifest.ts +213 -184
- package/src/build/generate-route-types.ts +3 -1
- package/src/build/index.ts +11 -3
- package/src/build/merge-full-manifests.ts +161 -0
- package/src/build/prefix-tree-utils.ts +123 -0
- package/src/build/route-trie.ts +43 -281
- package/src/build/route-types/ast-route-extraction.ts +15 -8
- package/src/build/route-types/codegen.ts +16 -5
- package/src/build/route-types/include-resolution.ts +513 -64
- package/src/build/route-types/param-extraction.ts +6 -3
- package/src/build/route-types/per-module-writer.ts +33 -12
- package/src/build/route-types/router-processing.ts +312 -204
- package/src/build/route-types/scan-filter.ts +1 -1
- package/src/build/route-types/source-scan.ts +216 -0
- package/src/build/runtime-discovery.ts +32 -29
- package/src/cache/cache-error.ts +104 -0
- package/src/cache/cache-exec-scope.ts +47 -0
- package/src/cache/cache-key-utils.ts +73 -15
- package/src/cache/cache-policy.ts +108 -34
- package/src/cache/cache-runtime.ts +566 -121
- package/src/cache/cache-scope.ts +383 -105
- package/src/cache/cache-tag.ts +149 -0
- package/src/cache/cf/cf-base64.ts +33 -0
- package/src/cache/cf/cf-cache-constants.ts +134 -0
- package/src/cache/cf/cf-cache-store.ts +3084 -391
- package/src/cache/cf/cf-cache-types.ts +417 -0
- package/src/cache/cf/cf-kv-utils.ts +84 -0
- package/src/cache/cf/cf-tag-marker-memo.ts +108 -0
- package/src/cache/cf/cf-zone-purge.ts +101 -0
- package/src/cache/cf/index.ts +11 -16
- package/src/cache/document-cache.ts +184 -53
- package/src/cache/handle-snapshot.ts +92 -1
- package/src/cache/index.ts +32 -20
- package/src/cache/memory-segment-store.ts +286 -37
- package/src/cache/profile-registry.ts +46 -31
- package/src/cache/read-through-swr.ts +66 -16
- package/src/cache/search-params-filter.ts +118 -0
- package/src/cache/segment-codec.ts +80 -25
- package/src/cache/shell-snapshot.ts +516 -0
- package/src/cache/tag-invalidation.ts +230 -0
- package/src/cache/taint.ts +28 -9
- package/src/cache/types.ts +343 -100
- 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 +51 -22
- package/src/client.tsx +79 -68
- package/src/cloudflare/index.ts +11 -0
- package/src/cloudflare/tracing.ts +112 -0
- package/src/component-utils.ts +19 -0
- package/src/components/DefaultDocument.tsx +8 -2
- package/src/context-var.ts +18 -6
- package/src/decode-loader-results.ts +165 -0
- package/src/defer.ts +185 -0
- package/src/deps/ssr.ts +4 -2
- package/src/dev-discovery-protocol.ts +11 -0
- package/src/encode-kv.ts +49 -0
- package/src/errors.ts +44 -4
- package/src/escape-script.ts +52 -0
- package/src/handle.ts +67 -37
- package/src/handles/MetaTags.tsx +24 -53
- package/src/handles/Scripts.tsx +183 -0
- package/src/handles/breadcrumbs.ts +35 -8
- package/src/handles/deferred-resolution.ts +134 -0
- package/src/handles/is-thenable.ts +16 -0
- package/src/handles/meta.ts +14 -40
- package/src/handles/script.ts +244 -0
- package/src/host/cookie-handler.ts +9 -60
- package/src/host/errors.ts +13 -22
- package/src/host/index.ts +9 -2
- package/src/host/pattern-matcher.ts +23 -52
- package/src/host/router.ts +107 -99
- package/src/host/testing.ts +40 -27
- package/src/host/types.ts +37 -4
- package/src/host/utils.ts +1 -1
- package/src/href-client.ts +136 -24
- package/src/index.rsc.ts +105 -12
- package/src/index.ts +103 -14
- package/src/internal-debug.ts +11 -10
- package/src/loader-redirect.tsx +64 -0
- package/src/loader-store.ts +500 -0
- package/src/loader.rsc.ts +20 -13
- package/src/loader.ts +12 -11
- package/src/missing-id-error.ts +68 -0
- package/src/outlet-context.ts +20 -0
- package/src/outlet-provider.tsx +20 -6
- package/src/prerender/build-shell-capture.ts +453 -0
- package/src/prerender/param-hash.ts +16 -16
- package/src/prerender/shell-manifest-key.ts +20 -0
- package/src/prerender/store.ts +47 -38
- package/src/prerender.ts +81 -13
- package/src/redirect-origin.ts +172 -0
- package/src/regex-escape.ts +8 -0
- package/src/render-error-thrower.tsx +20 -0
- package/src/response-utils.ts +34 -0
- package/src/reverse.ts +16 -13
- package/src/root-error-boundary.tsx +1 -19
- package/src/route-content-wrapper.tsx +120 -78
- package/src/route-definition/dsl-helpers.ts +331 -315
- package/src/route-definition/helper-factories.ts +28 -140
- package/src/route-definition/helpers-types.ts +100 -61
- package/src/route-definition/index.ts +1 -2
- package/src/route-definition/redirect.ts +60 -28
- package/src/route-definition/resolve-handler-use.ts +6 -1
- package/src/route-definition/use-item-types.ts +29 -0
- package/src/route-map-builder.ts +102 -74
- package/src/route-types.ts +19 -46
- package/src/router/basename.ts +14 -0
- package/src/router/content-negotiation.ts +120 -30
- package/src/router/error-handling.ts +110 -29
- package/src/router/find-match.ts +129 -30
- package/src/router/handler-context.ts +37 -16
- package/src/router/instrument.ts +401 -0
- package/src/router/intercept-resolution.ts +98 -21
- package/src/router/lazy-includes.ts +82 -58
- package/src/router/loader-resolution.ts +426 -85
- package/src/router/logging.ts +0 -6
- package/src/router/manifest.ts +74 -40
- package/src/router/match-api.ts +90 -55
- package/src/router/match-context.ts +0 -22
- package/src/router/match-handlers.ts +267 -171
- package/src/router/match-middleware/background-revalidation.ts +40 -24
- package/src/router/match-middleware/cache-lookup.ts +316 -302
- package/src/router/match-middleware/cache-store.ts +134 -52
- package/src/router/match-middleware/intercept-resolution.ts +0 -22
- package/src/router/match-middleware/segment-resolution.ts +0 -22
- package/src/router/match-pipelines.ts +1 -42
- package/src/router/match-result.ts +72 -94
- package/src/router/metrics.ts +17 -36
- package/src/router/middleware-types.ts +15 -114
- package/src/router/middleware.ts +276 -193
- package/src/router/navigation-snapshot.ts +51 -60
- package/src/router/params-util.ts +23 -0
- package/src/router/parse-pattern.ts +115 -0
- package/src/router/pattern-matching.ts +99 -152
- package/src/router/prefetch-cache-ttl.ts +51 -0
- package/src/router/prefetch-default.ts +59 -0
- package/src/router/prefetch-limits.ts +37 -0
- package/src/router/prerender-match.ts +159 -69
- package/src/router/preview-match.ts +6 -2
- package/src/router/request-classification.ts +50 -69
- package/src/router/revalidation.ts +134 -85
- package/src/router/route-snapshot.ts +14 -3
- package/src/router/route-trie-builder.ts +334 -0
- package/src/router/router-context.ts +6 -29
- package/src/router/router-interfaces.ts +168 -38
- package/src/router/router-options.ts +235 -11
- package/src/router/router-registry.ts +2 -5
- package/src/router/segment-resolution/fresh.ts +211 -88
- package/src/router/segment-resolution/helpers.ts +96 -18
- package/src/router/segment-resolution/loader-cache.ts +208 -39
- 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 +277 -308
- package/src/router/segment-resolution/static-store.ts +55 -15
- package/src/router/segment-resolution/streamed-handler-telemetry.ts +52 -0
- package/src/router/segment-resolution/view-transition-default.ts +60 -0
- package/src/router/segment-resolution.ts +5 -1
- package/src/router/segment-wrappers.ts +6 -5
- package/src/router/state-cookie-name.ts +33 -0
- package/src/router/substitute-pattern-params.ts +54 -35
- package/src/router/telemetry-otel.ts +171 -200
- package/src/router/telemetry.ts +106 -20
- package/src/router/timeout.ts +53 -22
- package/src/router/tracing.ts +235 -0
- package/src/router/transition-when.ts +76 -0
- package/src/router/trie-matching.ts +171 -64
- package/src/router/types.ts +9 -63
- package/src/router/url-params.ts +13 -5
- package/src/router.ts +248 -77
- package/src/rsc/capture-queue.ts +218 -0
- package/src/rsc/full-payload.ts +77 -0
- package/src/rsc/handler-context.ts +4 -2
- package/src/rsc/handler.ts +566 -288
- package/src/rsc/helpers.ts +179 -9
- package/src/rsc/index.ts +2 -5
- package/src/rsc/json-route-result.ts +38 -0
- package/src/rsc/loader-fetch.ts +116 -40
- package/src/rsc/manifest-init.ts +55 -56
- package/src/rsc/nonce.ts +26 -1
- package/src/rsc/origin-guard.ts +39 -25
- package/src/rsc/progressive-enhancement.ts +376 -85
- package/src/rsc/redirect-guard.ts +102 -0
- package/src/rsc/render-pipeline.ts +611 -0
- package/src/rsc/response-cache-serve.ts +259 -0
- package/src/rsc/response-error.ts +79 -12
- package/src/rsc/response-route-handler.ts +73 -212
- package/src/rsc/routine-plan.ts +359 -0
- package/src/rsc/rsc-rendering.ts +1645 -172
- package/src/rsc/runtime-warnings.ts +23 -10
- package/src/rsc/server-action.ts +419 -140
- 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 +124 -16
- package/src/rsc/stream-idle.ts +137 -0
- package/src/rsc/transition-gate.ts +86 -0
- package/src/rsc/types.ts +119 -7
- package/src/runtime-env.ts +18 -0
- package/src/search-params.ts +35 -30
- package/src/segment-fragments.ts +165 -0
- package/src/segment-loader-promise.ts +49 -4
- package/src/segment-system.tsx +405 -146
- package/src/serialize.ts +243 -0
- package/src/server/context.ts +426 -55
- package/src/server/cookie-parse.ts +32 -0
- package/src/server/cookie-store.ts +162 -15
- package/src/server/handle-store.ts +190 -70
- package/src/server/loader-registry.ts +33 -42
- package/src/server/request-context.ts +818 -177
- package/src/server.ts +7 -2
- package/src/ssr/index.tsx +737 -187
- 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 +28 -15
- package/src/testing/cache-status.ts +162 -0
- package/src/testing/collect-handle.ts +46 -0
- package/src/testing/dispatch.ts +951 -0
- package/src/testing/dom.entry.ts +22 -0
- package/src/testing/e2e/fixture.ts +188 -0
- package/src/testing/e2e/index.ts +147 -0
- package/src/testing/e2e/matchers.ts +35 -0
- package/src/testing/e2e/page-helpers.ts +319 -0
- package/src/testing/e2e/parity.ts +400 -0
- package/src/testing/e2e/server.ts +195 -0
- package/src/testing/flight-matchers.ts +97 -0
- package/src/testing/flight-normalize.ts +11 -0
- package/src/testing/flight-runtime.d.ts +57 -0
- package/src/testing/flight-tree.ts +682 -0
- package/src/testing/flight.entry.ts +52 -0
- package/src/testing/flight.ts +257 -0
- package/src/testing/generated-routes.ts +199 -0
- package/src/testing/index.ts +121 -0
- package/src/testing/internal/context.ts +380 -0
- package/src/testing/internal/flight-client-globals.ts +30 -0
- package/src/testing/internal/seed-vars.ts +54 -0
- package/src/testing/render-handler.ts +371 -0
- package/src/testing/render-route.tsx +667 -0
- package/src/testing/run-loader.ts +423 -0
- package/src/testing/run-middleware.ts +219 -0
- package/src/testing/run-transition-when.ts +197 -0
- package/src/testing/shell-status.ts +206 -0
- package/src/testing/vitest-stubs/cloudflare-email.ts +9 -0
- package/src/testing/vitest-stubs/cloudflare-workers.ts +21 -0
- package/src/testing/vitest-stubs/plugin-rsc.ts +16 -0
- package/src/testing/vitest-stubs/version.ts +5 -0
- package/src/testing/vitest.ts +305 -0
- package/src/theme/ThemeProvider.tsx +56 -84
- package/src/theme/ThemeScript.tsx +7 -9
- package/src/theme/constants.ts +52 -13
- package/src/theme/index.ts +0 -7
- package/src/theme/theme-context.ts +1 -5
- package/src/theme/theme-script.ts +22 -21
- package/src/theme/use-theme.ts +0 -3
- package/src/types/boundaries.ts +19 -35
- package/src/types/cache-types.ts +13 -4
- package/src/types/error-types.ts +30 -90
- package/src/types/global-namespace.ts +54 -41
- package/src/types/handler-context.ts +111 -25
- package/src/types/index.ts +4 -10
- package/src/types/loader-types.ts +71 -7
- package/src/types/request-scope.ts +8 -22
- package/src/types/route-config.ts +20 -52
- package/src/types/route-entry.ts +3 -6
- package/src/types/segments.ts +138 -14
- package/src/urls/include-helper.ts +38 -64
- package/src/urls/include-provider.ts +71 -0
- package/src/urls/index.ts +2 -11
- package/src/urls/path-helper-types.ts +88 -25
- package/src/urls/path-helper.ts +30 -110
- package/src/urls/pattern-types.ts +101 -19
- package/src/urls/response-types.ts +20 -19
- package/src/urls/type-extraction.ts +98 -154
- package/src/urls/urls-function.ts +1 -19
- package/src/use-loader.tsx +379 -110
- package/src/vercel/index.ts +11 -0
- package/src/vercel/tracing.ts +89 -0
- package/src/vite/debug.ts +1 -0
- package/src/vite/discovery/bundle-postprocess.ts +18 -14
- 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 +152 -153
- package/src/vite/discovery/discovery-errors.ts +255 -0
- package/src/vite/discovery/prerender-collection.ts +77 -69
- package/src/vite/discovery/route-types-writer.ts +40 -84
- package/src/vite/discovery/shell-prerender-phase.ts +402 -0
- package/src/vite/discovery/state.ts +110 -6
- package/src/vite/discovery/virtual-module-codegen.ts +226 -87
- package/src/vite/encryption-key.ts +29 -0
- package/src/vite/index.ts +12 -0
- package/src/vite/inject-client-debug.ts +88 -0
- package/src/vite/plugin-types.ts +271 -10
- package/src/vite/plugins/cjs-to-esm.ts +11 -19
- package/src/vite/plugins/client-ref-dedup.ts +281 -30
- package/src/vite/plugins/client-ref-hashing.ts +12 -11
- package/src/vite/plugins/cloudflare-protocol-stub.ts +1 -21
- package/src/vite/plugins/expose-action-id.ts +51 -100
- package/src/vite/plugins/expose-id-utils.ts +88 -55
- package/src/vite/plugins/expose-ids/export-analysis.ts +101 -34
- package/src/vite/plugins/expose-ids/handler-transform.ts +11 -90
- package/src/vite/plugins/expose-ids/loader-transform.ts +14 -24
- package/src/vite/plugins/expose-ids/router-transform.ts +98 -26
- package/src/vite/plugins/expose-internal-ids.ts +103 -68
- package/src/vite/plugins/performance-tracks.ts +9 -16
- package/src/vite/plugins/refresh-cmd.ts +1 -1
- package/src/vite/plugins/server-ref-hashing.ts +74 -0
- package/src/vite/plugins/server-reference-pattern.ts +10 -0
- package/src/vite/plugins/use-cache-transform.ts +26 -49
- package/src/vite/plugins/vercel-output.ts +384 -0
- package/src/vite/plugins/version-injector.ts +24 -40
- package/src/vite/plugins/version-plugin.ts +45 -40
- package/src/vite/plugins/virtual-entries.ts +202 -30
- package/src/vite/rango.ts +241 -126
- package/src/vite/router-discovery.ts +1123 -143
- package/src/vite/utils/ast-handler-extract.ts +26 -35
- package/src/vite/utils/bundle-analysis.ts +10 -15
- package/src/vite/utils/client-chunks.ts +184 -0
- package/src/vite/utils/directive-prologue.ts +40 -0
- package/src/vite/utils/forward-user-plugins.ts +171 -0
- package/src/vite/utils/manifest-utils.ts +1 -59
- package/src/vite/utils/package-resolution.ts +2 -73
- package/src/vite/utils/prerender-utils.ts +96 -50
- package/src/vite/utils/shared-utils.ts +162 -43
- package/src/browser/action-response-classifier.ts +0 -99
- package/src/browser/react/use-client-cache.ts +0 -58
- package/src/browser/shallow.ts +0 -40
- package/src/handles/index.ts +0 -7
- package/src/network-error-thrower.tsx +0 -23
- package/src/router/middleware-cookies.ts +0 -55
|
@@ -5,8 +5,8 @@
|
|
|
5
5
|
*/
|
|
6
6
|
|
|
7
7
|
import type { ReactNode } from "react";
|
|
8
|
-
import { track } from "../server/context";
|
|
9
8
|
import type { EntryData } from "../server/context";
|
|
9
|
+
import { observePhase, PHASES } from "./instrument.js";
|
|
10
10
|
import { contextGet } from "../context-var.js";
|
|
11
11
|
import type {
|
|
12
12
|
ResolvedSegment,
|
|
@@ -18,13 +18,36 @@ import type {
|
|
|
18
18
|
ErrorBoundaryHandler,
|
|
19
19
|
ErrorBoundaryFallbackProps,
|
|
20
20
|
ErrorInfo,
|
|
21
|
+
NotFoundBoundaryHandler,
|
|
22
|
+
NotFoundBoundaryFallbackProps,
|
|
21
23
|
} from "../types";
|
|
22
|
-
import
|
|
24
|
+
import { createElement } from "react";
|
|
25
|
+
import { isDataNotFoundError } from "../errors.js";
|
|
26
|
+
import { isRedirectResponse } from "../response-utils.js";
|
|
27
|
+
import {
|
|
28
|
+
resolveSoftRedirectUrl,
|
|
29
|
+
getRedirectState,
|
|
30
|
+
isExternalRedirect,
|
|
31
|
+
} from "../redirect-origin.js";
|
|
32
|
+
import {
|
|
33
|
+
createNotFoundInfo,
|
|
34
|
+
renderNotFoundFallback,
|
|
35
|
+
resolveNotFoundFallback,
|
|
36
|
+
} from "./error-handling.js";
|
|
23
37
|
import { isHandle, collectHandleData, type Handle } from "../handle.js";
|
|
24
|
-
import {
|
|
38
|
+
import { withDefer } from "../defer.js";
|
|
39
|
+
import {
|
|
40
|
+
buildHandleSnapshot,
|
|
41
|
+
type HandleStore,
|
|
42
|
+
} from "../server/handle-store.js";
|
|
25
43
|
import { getFetchableLoader } from "../server/fetchable-loader-store.js";
|
|
26
44
|
import { _getRequestContext } from "../server/request-context.js";
|
|
27
|
-
import {
|
|
45
|
+
import {
|
|
46
|
+
isInsideLoaderScope,
|
|
47
|
+
runInsideLoaderBodyScope,
|
|
48
|
+
isInsidePushCallbackScope,
|
|
49
|
+
runInsidePushCallbackScope,
|
|
50
|
+
} from "../server/context.js";
|
|
28
51
|
import { debugLog } from "./logging.js";
|
|
29
52
|
|
|
30
53
|
/**
|
|
@@ -41,11 +64,66 @@ export type LoaderErrorCallback = (
|
|
|
41
64
|
},
|
|
42
65
|
) => void;
|
|
43
66
|
|
|
67
|
+
/**
|
|
68
|
+
* Loader-thrown authority signals (notFound()/redirect()) are detected by the
|
|
69
|
+
* shape a consumer can actually throw: DataNotFoundError via the shared
|
|
70
|
+
* cross-realm-safe isDataNotFoundError, redirect by 3xx Response.
|
|
71
|
+
*/
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Deliver one `ctx.use(Handle)(value)` push to the owning segment.
|
|
75
|
+
*
|
|
76
|
+
* Shared by the handler lane (setupLoaderAccess) and the loader-body lane
|
|
77
|
+
* (createLoaderExecutor) so a loader push attributes and scopes EXACTLY like a
|
|
78
|
+
* handler push — that parity is the contract `ctx.use` in a loader promises.
|
|
79
|
+
*
|
|
80
|
+
* A function value runs inside the push-callback scope so `ctx.use(loader)`
|
|
81
|
+
* calls it makes — including after its own awaits, for an async callback — are
|
|
82
|
+
* not registered as handler-to-loader deps and do not trip the deadlock guard.
|
|
83
|
+
* A pushed promise value is not tracked by handleStore.settled and does not
|
|
84
|
+
* block segment resolution, so it cannot form a rendered() deadlock. The ALS
|
|
85
|
+
* scope (not a plain boolean) is what survives the callback's awaits.
|
|
86
|
+
*/
|
|
87
|
+
function pushHandleValue(
|
|
88
|
+
store: HandleStore | undefined,
|
|
89
|
+
segmentId: string | undefined,
|
|
90
|
+
handleId: string,
|
|
91
|
+
dataOrFn: unknown | Promise<unknown> | (() => Promise<unknown>),
|
|
92
|
+
): void {
|
|
93
|
+
if (!store || !segmentId) return;
|
|
94
|
+
if (typeof dataOrFn === "function") {
|
|
95
|
+
store.push(
|
|
96
|
+
handleId,
|
|
97
|
+
segmentId,
|
|
98
|
+
runInsidePushCallbackScope(() => (dataOrFn as () => Promise<unknown>)()),
|
|
99
|
+
);
|
|
100
|
+
return;
|
|
101
|
+
}
|
|
102
|
+
store.push(handleId, segmentId, dataOrFn);
|
|
103
|
+
}
|
|
104
|
+
|
|
44
105
|
/**
|
|
45
106
|
* Wrap a loader promise with error handling for deferred client-side resolution.
|
|
46
107
|
* Catches errors and converts them to LoaderDataResult objects that include
|
|
47
108
|
* error info and pre-rendered fallback UI when an error boundary is available.
|
|
48
109
|
*
|
|
110
|
+
* Loader-thrown SIGNALS are routed before error handling — they are control
|
|
111
|
+
* flow, not failures (onError is not invoked for them):
|
|
112
|
+
* - notFound(): the not-found UI is resolved and rendered HERE, server-side
|
|
113
|
+
* (nearest notFoundBoundary → router notFound option → default), exactly
|
|
114
|
+
* like the consumption lane (segment-resolution/helpers.ts), and rides the
|
|
115
|
+
* envelope's `fallback` — the client swaps with zero extra fetches. The
|
|
116
|
+
* response status is opportunistically set to 404 via the request stub: if
|
|
117
|
+
* the rejection settles before the document Response is constructed the
|
|
118
|
+
* status is a real 404; after, the stub write is inert (streamed fix-up
|
|
119
|
+
* only). Nav-lane payloads are 200 either way — the client owns 404
|
|
120
|
+
* presentation there.
|
|
121
|
+
* - redirect() (thrown 3xx Response): the target is resolved through the
|
|
122
|
+
* soft-redirect same-origin rules NOW so unsafe targets never leave the
|
|
123
|
+
* server; the client navigates when the entry decodes. No document-lane
|
|
124
|
+
* 302 — pre-stream redirect authority belongs to middleware (doctrine);
|
|
125
|
+
* a loader redirect is always a client-side navigate.
|
|
126
|
+
*
|
|
49
127
|
* @param onError - Optional callback invoked when loader errors occur.
|
|
50
128
|
* This has a simplified signature for internal use - the caller (typically
|
|
51
129
|
* wrapLoaderPromise in router.ts) is responsible for bridging to the full
|
|
@@ -65,8 +143,18 @@ export function wrapLoaderWithErrorHandling<T>(
|
|
|
65
143
|
segmentType: ErrorInfo["segmentType"],
|
|
66
144
|
) => ErrorInfo,
|
|
67
145
|
onError?: LoaderErrorCallback,
|
|
146
|
+
notFoundDeps?: {
|
|
147
|
+
findNearestNotFoundBoundary: (
|
|
148
|
+
entry: EntryData | null,
|
|
149
|
+
) => ReactNode | NotFoundBoundaryHandler | null;
|
|
150
|
+
notFoundComponent?:
|
|
151
|
+
| ReactNode
|
|
152
|
+
| ((props: { pathname: string }) => ReactNode);
|
|
153
|
+
},
|
|
68
154
|
): Promise<LoaderDataResult<T>> {
|
|
69
|
-
// Extract
|
|
155
|
+
// Extract the trailing token from segmentId (format: "<shortCode>D<i>.<loaderId>").
|
|
156
|
+
// The token is the loader's $$id (hash#export in prod, pathfrag#export in dev),
|
|
157
|
+
// not a clean display name.
|
|
70
158
|
const loaderName = segmentId.split(".").pop() || "unknown";
|
|
71
159
|
|
|
72
160
|
return Promise.resolve(promise)
|
|
@@ -78,6 +166,92 @@ export function wrapLoaderWithErrorHandling<T>(
|
|
|
78
166
|
}),
|
|
79
167
|
)
|
|
80
168
|
.catch((error): LoaderDataResult<T> => {
|
|
169
|
+
if (isDataNotFoundError(error)) {
|
|
170
|
+
// Opportunistic document 404: the stub status is read once when the
|
|
171
|
+
// document Response is constructed (createResponseWithMergedHeaders);
|
|
172
|
+
// a pre-construction write becomes the real status, a later write is
|
|
173
|
+
// harmless. Same mechanism as the consumption lane's setResponseStatus.
|
|
174
|
+
_getRequestContext()?._setStatus(404);
|
|
175
|
+
|
|
176
|
+
const effective = resolveNotFoundFallback(
|
|
177
|
+
notFoundDeps?.findNearestNotFoundBoundary(entry),
|
|
178
|
+
notFoundDeps?.notFoundComponent,
|
|
179
|
+
pathname,
|
|
180
|
+
);
|
|
181
|
+
|
|
182
|
+
const notFoundInfo = createNotFoundInfo(
|
|
183
|
+
error as { message: string },
|
|
184
|
+
segmentId,
|
|
185
|
+
"loader",
|
|
186
|
+
pathname,
|
|
187
|
+
);
|
|
188
|
+
let renderedNotFound: ReactNode;
|
|
189
|
+
try {
|
|
190
|
+
renderedNotFound = renderNotFoundFallback(effective, notFoundInfo);
|
|
191
|
+
} catch {
|
|
192
|
+
// A throwing boundary must not collapse the envelope (the wrapped
|
|
193
|
+
// promise is contracted to never reject); degrade to the default.
|
|
194
|
+
// Deliberately NOT shared with the consumption lane
|
|
195
|
+
// (segment-resolution/helpers.ts), which lets a throwing boundary
|
|
196
|
+
// propagate to the error boundary — only this lane is contracted to
|
|
197
|
+
// never reject.
|
|
198
|
+
renderedNotFound = createElement("h1", null, "Not Found");
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
debugLog("loader", "loader threw notFound()", {
|
|
202
|
+
segmentId,
|
|
203
|
+
pathname,
|
|
204
|
+
});
|
|
205
|
+
|
|
206
|
+
return {
|
|
207
|
+
__loaderResult: true,
|
|
208
|
+
ok: false,
|
|
209
|
+
notFound: true,
|
|
210
|
+
error: createErrorInfo(error, segmentId, "loader"),
|
|
211
|
+
fallback: renderedNotFound ?? null,
|
|
212
|
+
};
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
if (error instanceof Response && isRedirectResponse(error)) {
|
|
216
|
+
const reqCtx = _getRequestContext();
|
|
217
|
+
const requestOrigin = reqCtx?.originalUrl?.origin ?? reqCtx?.url.origin;
|
|
218
|
+
const location = error.headers.get("Location")!;
|
|
219
|
+
// Same-origin policy applied server-side; the wire never carries an
|
|
220
|
+
// unresolved target. redirect(url, { external: true })'s WeakSet brand
|
|
221
|
+
// survives (the thrown Response IS the branded object).
|
|
222
|
+
const to = requestOrigin
|
|
223
|
+
? resolveSoftRedirectUrl(
|
|
224
|
+
location,
|
|
225
|
+
requestOrigin,
|
|
226
|
+
reqCtx?._basename,
|
|
227
|
+
isExternalRedirect(error),
|
|
228
|
+
)
|
|
229
|
+
: location;
|
|
230
|
+
|
|
231
|
+
debugLog("loader", "loader threw redirect()", {
|
|
232
|
+
segmentId,
|
|
233
|
+
to,
|
|
234
|
+
});
|
|
235
|
+
|
|
236
|
+
// redirect(url, { state }): the resolved state rides the thrown
|
|
237
|
+
// Response (attachRedirectState), NOT payload metadata — a streaming
|
|
238
|
+
// loader settles after the metadata flush, so the marker is the only
|
|
239
|
+
// carrier that reaches the client. LoaderRedirect navigates with it.
|
|
240
|
+
const redirectState = getRedirectState(error);
|
|
241
|
+
|
|
242
|
+
return {
|
|
243
|
+
__loaderResult: true,
|
|
244
|
+
ok: false,
|
|
245
|
+
redirect: { to, ...(redirectState && { state: redirectState }) },
|
|
246
|
+
error: createErrorInfo(
|
|
247
|
+
new Error(`Loader redirected to ${to}`),
|
|
248
|
+
segmentId,
|
|
249
|
+
"loader",
|
|
250
|
+
),
|
|
251
|
+
fallback: null,
|
|
252
|
+
};
|
|
253
|
+
}
|
|
254
|
+
|
|
81
255
|
// Find nearest error boundary
|
|
82
256
|
const fallback = findNearestErrorBoundary(entry);
|
|
83
257
|
|
|
@@ -102,16 +276,40 @@ export function wrapLoaderWithErrorHandling<T>(
|
|
|
102
276
|
};
|
|
103
277
|
}
|
|
104
278
|
|
|
105
|
-
// Render fallback on server
|
|
279
|
+
// Render fallback on server. The user ErrorBoundaryHandler may throw
|
|
280
|
+
// synchronously; if it does we must NOT let that rejection escape — the
|
|
281
|
+
// wrapped LoaderDataResult promise is contracted to never reject (see
|
|
282
|
+
// segment-resolution/fresh.ts `await Promise.all(...wrapped)`), and a
|
|
283
|
+
// rejection here would collapse the whole entry and discard healthy
|
|
284
|
+
// sibling loader data. On a fallback-render throw, fall back to the
|
|
285
|
+
// no-boundary result (fallback: null) so the client throws the ORIGINAL
|
|
286
|
+
// error, and the wrapped promise still resolves to a LoaderDataResult.
|
|
106
287
|
let renderedFallback: ReactNode;
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
288
|
+
try {
|
|
289
|
+
if (typeof fallback === "function") {
|
|
290
|
+
// ErrorBoundaryHandler - call with error info
|
|
291
|
+
const props: ErrorBoundaryFallbackProps = {
|
|
292
|
+
error: errorInfo,
|
|
293
|
+
};
|
|
294
|
+
renderedFallback = fallback(props);
|
|
295
|
+
} else {
|
|
296
|
+
renderedFallback = fallback;
|
|
297
|
+
}
|
|
298
|
+
} catch (fallbackError) {
|
|
299
|
+
debugLog("loader", "error boundary fallback render threw", {
|
|
300
|
+
segmentId,
|
|
301
|
+
message: errorInfo.message,
|
|
302
|
+
fallbackError:
|
|
303
|
+
fallbackError instanceof Error
|
|
304
|
+
? fallbackError.message
|
|
305
|
+
: String(fallbackError),
|
|
306
|
+
});
|
|
307
|
+
return {
|
|
308
|
+
__loaderResult: true,
|
|
309
|
+
ok: false,
|
|
110
310
|
error: errorInfo,
|
|
311
|
+
fallback: null,
|
|
111
312
|
};
|
|
112
|
-
renderedFallback = fallback(props);
|
|
113
|
-
} else {
|
|
114
|
-
renderedFallback = fallback;
|
|
115
313
|
}
|
|
116
314
|
|
|
117
315
|
debugLog("loader", "loader error wrapped with boundary fallback", {
|
|
@@ -179,12 +377,23 @@ function detectLoaderCycle(
|
|
|
179
377
|
function createLoaderExecutor<TEnv>(
|
|
180
378
|
ctx: HandlerContext<any, TEnv>,
|
|
181
379
|
loaderPromises: Map<string, Promise<any>>,
|
|
380
|
+
executorOptions?: {
|
|
381
|
+
/**
|
|
382
|
+
* Background proactive-caching mode: ctx.handle() pushes become no-ops
|
|
383
|
+
* (mirroring setupLoaderAccessSilent's handler-handle no-op) and loader
|
|
384
|
+
* bodies are NOT aux-tracked into the foreground handle store — a
|
|
385
|
+
* background run must neither duplicate handle data nor extend the live
|
|
386
|
+
* payload's handle-stream lifetime.
|
|
387
|
+
*/
|
|
388
|
+
silentHandles?: boolean;
|
|
389
|
+
},
|
|
182
390
|
): (
|
|
183
391
|
loader: LoaderDefinition<any, any>,
|
|
184
392
|
callerLoaderId: string | null,
|
|
185
393
|
) => Promise<any> {
|
|
186
394
|
// Capture RequestContext eagerly for cookie access (ALS protection on Cloudflare)
|
|
187
395
|
const reqCtxRef = _getRequestContext();
|
|
396
|
+
const silentHandles = executorOptions?.silentHandles === true;
|
|
188
397
|
|
|
189
398
|
// Dependency graph: loaderId -> set of loader IDs it directly depends on.
|
|
190
399
|
const dependsOn = new Map<string, Set<string>>();
|
|
@@ -250,6 +459,16 @@ function createLoaderExecutor<TEnv>(
|
|
|
250
459
|
// inside loader scope. This determines whether rendered() is allowed.
|
|
251
460
|
const isDslLoader = isInsideLoaderScope();
|
|
252
461
|
|
|
462
|
+
// Owning segment for ctx.handle() attribution, captured SYNCHRONOUSLY at
|
|
463
|
+
// kickoff: segment resolution sets _currentSegmentId while resolving the
|
|
464
|
+
// segment that declares this loader (fresh.ts), and the value moves on as
|
|
465
|
+
// resolution continues — by the time the async body pushes, it would be
|
|
466
|
+
// stale. Attributing to the owning route/layout segment gives handle
|
|
467
|
+
// pushes the same granularity handler pushes have (segmentOrder-correct
|
|
468
|
+
// for breadcrumb accumulation).
|
|
469
|
+
const owningSegmentId = (ctx as InternalHandlerContext<any, TEnv>)
|
|
470
|
+
._currentSegmentId;
|
|
471
|
+
|
|
253
472
|
let renderedResolved = false;
|
|
254
473
|
let renderedPromise: Promise<void> | null = null;
|
|
255
474
|
|
|
@@ -270,27 +489,61 @@ function createLoaderExecutor<TEnv>(
|
|
|
270
489
|
env: ctx.env,
|
|
271
490
|
waitUntil: ctx.waitUntil.bind(ctx),
|
|
272
491
|
executionContext: ctx.executionContext,
|
|
273
|
-
get: ((keyOrVar: any) =>
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
if (isHandle(
|
|
492
|
+
get: ((keyOrVar: any) => {
|
|
493
|
+
// Handle READ (moved from ctx.use(handle)): collected data, available
|
|
494
|
+
// after `await ctx.rendered()` — the rendered-barrier contract.
|
|
495
|
+
if (isHandle(keyOrVar)) {
|
|
277
496
|
if (!renderedResolved) {
|
|
278
497
|
throw new Error(
|
|
279
|
-
`ctx.
|
|
280
|
-
`Handle "${
|
|
498
|
+
`ctx.get(handle) in a loader requires "await ctx.rendered()" first. ` +
|
|
499
|
+
`Handle "${keyOrVar.$$id}" cannot be read until the render tree has settled.`,
|
|
281
500
|
);
|
|
282
501
|
}
|
|
283
502
|
const reqCtx = reqCtxRef ?? _getRequestContext();
|
|
284
503
|
if (!reqCtx) {
|
|
285
504
|
throw new Error(
|
|
286
|
-
`ctx.
|
|
505
|
+
`ctx.get(handle) failed: request context not available.`,
|
|
287
506
|
);
|
|
288
507
|
}
|
|
289
508
|
const segmentOrder = reqCtx._renderBarrierSegmentOrder ?? [];
|
|
509
|
+
// The complete snapshot is cached at barrier resolution for
|
|
510
|
+
// non-streaming trees, and by rendered() after handleStore.settled for
|
|
511
|
+
// streaming trees (where the eager snapshot would have been incomplete
|
|
512
|
+
// because loading() handlers were still in flight). Either way it is
|
|
513
|
+
// present by the time a loader reads a handle; the fresh build is only
|
|
514
|
+
// a defensive fallback.
|
|
290
515
|
const snapshot =
|
|
291
516
|
reqCtx._renderBarrierHandleSnapshot ??
|
|
292
517
|
buildHandleSnapshot(reqCtx._handleStore, segmentOrder);
|
|
293
|
-
return collectHandleData(
|
|
518
|
+
return collectHandleData(keyOrVar, snapshot, segmentOrder);
|
|
519
|
+
}
|
|
520
|
+
return contextGet(variables, keyOrVar);
|
|
521
|
+
}) as typeof ctx.get,
|
|
522
|
+
use: ((item: LoaderDefinition<any, any> | Handle<any, any>) => {
|
|
523
|
+
if (isHandle(item)) {
|
|
524
|
+
// Handle WRITE — handler parity: `ctx.use(Meta)({...})` pushes from
|
|
525
|
+
// the loader body exactly like a handler push. Reads moved to
|
|
526
|
+
// ctx.get(handle) (rendered()-gated). Pushes attribute to the OWNING
|
|
527
|
+
// segment and are legal for the whole body: the body is tracked on
|
|
528
|
+
// the handle store's auxiliary lane, so the store stays open past
|
|
529
|
+
// the handler barrier. Delivery follows the race: pushes that beat
|
|
530
|
+
// the handler barrier ride the SSR snapshot, later ones stream via
|
|
531
|
+
// metadata.handlesLate (document) or the still-open handles
|
|
532
|
+
// generator (nav/action lanes).
|
|
533
|
+
const handleDef = item;
|
|
534
|
+
if (silentHandles) {
|
|
535
|
+
return withDefer((_dataOrFn: unknown) => {});
|
|
536
|
+
}
|
|
537
|
+
const store =
|
|
538
|
+
reqCtxRef?._handleStore ?? _getRequestContext()?._handleStore;
|
|
539
|
+
const segmentId = owningSegmentId;
|
|
540
|
+
return withDefer(
|
|
541
|
+
(
|
|
542
|
+
dataOrFn: unknown | Promise<unknown> | (() => Promise<unknown>),
|
|
543
|
+
) => {
|
|
544
|
+
pushHandleValue(store, segmentId, handleDef.$$id, dataOrFn);
|
|
545
|
+
},
|
|
546
|
+
);
|
|
294
547
|
}
|
|
295
548
|
|
|
296
549
|
// Loader case
|
|
@@ -308,15 +561,7 @@ function createLoaderExecutor<TEnv>(
|
|
|
308
561
|
);
|
|
309
562
|
}
|
|
310
563
|
|
|
311
|
-
// Guard: reject streaming trees
|
|
312
564
|
const reqCtx = reqCtxRef ?? _getRequestContext();
|
|
313
|
-
if (reqCtx?._treeHasStreaming) {
|
|
314
|
-
throw new Error(
|
|
315
|
-
`ctx.rendered() is not supported when the matched route tree uses loading(). ` +
|
|
316
|
-
`Streaming handlers may not have settled when rendered() resolves. ` +
|
|
317
|
-
`Remove loading() from the route tree or restructure to avoid rendered().`,
|
|
318
|
-
);
|
|
319
|
-
}
|
|
320
565
|
|
|
321
566
|
if (renderedPromise) return renderedPromise;
|
|
322
567
|
|
|
@@ -326,8 +571,29 @@ function createLoaderExecutor<TEnv>(
|
|
|
326
571
|
);
|
|
327
572
|
}
|
|
328
573
|
|
|
574
|
+
// awaitBeforeFlush cycle: segment resolution awaits this loader
|
|
575
|
+
// (loader(Def, { ssr: false })), the barrier awaits segment
|
|
576
|
+
// resolution, and rendered() awaits the barrier — waiting here can
|
|
577
|
+
// never complete. Fail fast with the cause instead of hanging the
|
|
578
|
+
// document render. Only document renders populate the set (the flag is
|
|
579
|
+
// stamped per-isSSR), so the same loader may still use rendered() on
|
|
580
|
+
// navigation renders.
|
|
581
|
+
if (reqCtx._awaitBeforeFlushLoaderIds?.has(currentLoaderId)) {
|
|
582
|
+
throw new Error(
|
|
583
|
+
`Deadlock: loader "${currentLoaderId}" is registered with ` +
|
|
584
|
+
`ssr: false, so the document render awaits it before ` +
|
|
585
|
+
`the render barrier resolves — ctx.rendered() (and the ` +
|
|
586
|
+
`ctx.get(handle) read it gates) can never settle here. Drop ` +
|
|
587
|
+
`ssr: false on this loader or move the handle read to ` +
|
|
588
|
+
`a component.`,
|
|
589
|
+
);
|
|
590
|
+
}
|
|
591
|
+
|
|
329
592
|
// Bidirectional deadlock check: if a handler already started
|
|
330
|
-
// awaiting this loader, calling rendered() would deadlock.
|
|
593
|
+
// awaiting this loader, calling rendered() would deadlock. This is the
|
|
594
|
+
// real cycle guard (it holds for both streaming and non-streaming): the
|
|
595
|
+
// handler blocks segment resolution, which blocks the barrier, which
|
|
596
|
+
// blocks this loader.
|
|
331
597
|
if (reqCtx._handlerLoaderDeps?.has(currentLoaderId)) {
|
|
332
598
|
throw new Error(
|
|
333
599
|
`Deadlock: loader "${currentLoaderId}" called ctx.rendered() but a handler ` +
|
|
@@ -345,20 +611,100 @@ function createLoaderExecutor<TEnv>(
|
|
|
345
611
|
}
|
|
346
612
|
reqCtx._renderBarrierWaiters.add(currentLoaderId);
|
|
347
613
|
|
|
348
|
-
|
|
614
|
+
// Streaming trees (loading()): the barrier resolves once the segment
|
|
615
|
+
// tree is resolved, but loading() handlers stream behind Suspense and
|
|
616
|
+
// their handle pushes are still in flight then. Their async execution
|
|
617
|
+
// IS tracked in the handle store (trackHandler -> store.track), so after
|
|
618
|
+
// the barrier we seal (no further handlers register once the tree is
|
|
619
|
+
// resolved) and wait for settled — every tracked handler, streaming
|
|
620
|
+
// included, has finished pushing. The loader's own segment streams in
|
|
621
|
+
// after, so this does not block the shell; the deadlock guard above
|
|
622
|
+
// keeps a handler from depending on this loader.
|
|
623
|
+
const streaming = reqCtx._treeHasStreaming === true;
|
|
624
|
+
renderedPromise = reqCtx._renderBarrier.then(async () => {
|
|
625
|
+
if (streaming) {
|
|
626
|
+
reqCtx._handleStore.seal();
|
|
627
|
+
await reqCtx._handleStore.settled;
|
|
628
|
+
// The eager snapshot was intentionally left unbuilt for streaming
|
|
629
|
+
// (it would have been incomplete). Build the complete one once, now
|
|
630
|
+
// that the store has settled, so every ctx.use(handle) reads the
|
|
631
|
+
// cached snapshot instead of rebuilding it per call.
|
|
632
|
+
reqCtx._renderBarrierHandleSnapshot ??= buildHandleSnapshot(
|
|
633
|
+
reqCtx._handleStore,
|
|
634
|
+
reqCtx._renderBarrierSegmentOrder ?? [],
|
|
635
|
+
);
|
|
636
|
+
}
|
|
349
637
|
renderedResolved = true;
|
|
350
638
|
});
|
|
351
639
|
return renderedPromise;
|
|
352
640
|
},
|
|
353
641
|
};
|
|
354
642
|
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
643
|
+
// Meter this loader once via observePhase (loader:<id> perf metric +
|
|
644
|
+
// rango.loader span); loaderFn runs inside the span callback so its KV/D1/
|
|
645
|
+
// fetch spans nest under it. This is one of the observePhase loader funnels —
|
|
646
|
+
// see instrument.ts for the single-metering contract.
|
|
647
|
+
//
|
|
648
|
+
// Run the loader body inside loader scope so request-scoped reads
|
|
649
|
+
// (cookies()/headers() and non-cacheable ctx.get) are exempt from the
|
|
650
|
+
// cache-purity guards: loaders always run fresh, so their reads never leak
|
|
651
|
+
// into a cached segment. DSL loaders are already wrapped by fresh.ts; this
|
|
652
|
+
// also covers handler-invoked loaders (ctx.use(Loader) from a handler),
|
|
653
|
+
// which otherwise execute in the caller's cache scope and would wrongly
|
|
654
|
+
// throw. rendered() gating uses the captured isDslLoader (above), so this
|
|
655
|
+
// does not grant rendered() to handler-invoked loaders. Uses a body-only
|
|
656
|
+
// scope, so isInsideLoaderScope() / barrier / deadlock gating is unchanged.
|
|
657
|
+
//
|
|
658
|
+
// `handlerInvoked` (!isDslLoader) rides on the scope for the CONSUMPTION-
|
|
659
|
+
// LANE RULE: a handler-consumed loader's value is a BAKED copy in every
|
|
660
|
+
// shared artifact (cache(), "use cache", the PPR shell), so its identity
|
|
661
|
+
// reads are exempt from the shell-capture guard — same allowance the
|
|
662
|
+
// cache-purity guards give it. DSL segment loaders keep their lane
|
|
663
|
+
// machinery (live = masked at capture, bake = guarded). A DSL loader's
|
|
664
|
+
// nested deps inherit isDslLoader=false only when the CHAIN started in a
|
|
665
|
+
// handler; a chain started by the segment funnel stays DSL (the loader
|
|
666
|
+
// scope ALS survives the body's awaits).
|
|
667
|
+
// Shell fast path eligibility: a HANDLER-invoked loader executing during a
|
|
668
|
+
// capture is handler-layer dynamism — on a handler-free (replayed) HIT it
|
|
669
|
+
// would never re-run, freezing its consumption-lane value (#672's "fresh
|
|
670
|
+
// per serve" slot shape). Mark the capture; the entry declines the fast
|
|
671
|
+
// path and keeps the full tail. DSL loaders re-run on every HIT and never
|
|
672
|
+
// set this.
|
|
673
|
+
if (!isDslLoader) {
|
|
674
|
+
const captureCtx = _getRequestContext();
|
|
675
|
+
if (
|
|
676
|
+
captureCtx?._shellCaptureRun &&
|
|
677
|
+
captureCtx._shellCaptureHandleLiveness
|
|
678
|
+
) {
|
|
679
|
+
captureCtx._shellCaptureHandleLiveness.handlerInvokedLoader = true;
|
|
680
|
+
}
|
|
681
|
+
}
|
|
682
|
+
|
|
683
|
+
const promise = observePhase(PHASES.loader(loader.$$id), () =>
|
|
684
|
+
Promise.resolve(
|
|
685
|
+
runInsideLoaderBodyScope(
|
|
686
|
+
() => loaderFn(loaderCtx as LoaderContext<any, TEnv>),
|
|
687
|
+
loader.$$id,
|
|
688
|
+
!isDslLoader,
|
|
689
|
+
),
|
|
690
|
+
).finally(() => {
|
|
691
|
+
pendingLoaders.delete(loader.$$id);
|
|
692
|
+
}),
|
|
693
|
+
);
|
|
694
|
+
|
|
695
|
+
// Auxiliary-lane tracking: keeps the handle store open for this body's
|
|
696
|
+
// ctx.handle() pushes without joining `settled` (the handler barrier that
|
|
697
|
+
// gates SSR/hydration and rendered()-readers — joining it would block the
|
|
698
|
+
// document on the slowest loader and self-deadlock rendered() callers).
|
|
699
|
+
// DSL loaders only: handler-invoked loaders are awaited by their handler,
|
|
700
|
+
// so they complete inside the handler lane already. A nested DSL kickoff
|
|
701
|
+
// mid-body registers while its parent is still tracked, so the lane can
|
|
702
|
+
// never re-open after draining.
|
|
703
|
+
if (isDslLoader && !silentHandles) {
|
|
704
|
+
(reqCtxRef ?? _getRequestContext())?._handleStore?.trackAuxiliary(
|
|
705
|
+
promise,
|
|
706
|
+
);
|
|
707
|
+
}
|
|
362
708
|
|
|
363
709
|
loaderPromises.set(loader.$$id, promise);
|
|
364
710
|
return promise;
|
|
@@ -390,12 +736,6 @@ export function setupLoaderAccess<TEnv>(
|
|
|
390
736
|
|
|
391
737
|
const useLoader = createLoaderExecutor(ctx, loaderPromises);
|
|
392
738
|
|
|
393
|
-
// Track whether we're inside a handle push callback. Loaders started
|
|
394
|
-
// from push callbacks (e.g. push(async () => ctx.use(Loader))) do NOT
|
|
395
|
-
// block segment resolution, so they must not be registered as handler
|
|
396
|
-
// dependencies for deadlock detection.
|
|
397
|
-
let insideHandlePush = false;
|
|
398
|
-
|
|
399
739
|
ctx.use = ((item: LoaderDefinition<any, any> | Handle<any, any>) => {
|
|
400
740
|
if (isHandle(item)) {
|
|
401
741
|
const handle = item;
|
|
@@ -410,35 +750,23 @@ export function setupLoaderAccess<TEnv>(
|
|
|
410
750
|
);
|
|
411
751
|
}
|
|
412
752
|
|
|
413
|
-
return (
|
|
414
|
-
dataOrFn: unknown | Promise<unknown> | (() => Promise<unknown>)
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
if (typeof dataOrFn === "function") {
|
|
419
|
-
// Mark scope so ctx.use(loader) calls inside the callback
|
|
420
|
-
// are not registered as handler-to-loader deps.
|
|
421
|
-
insideHandlePush = true;
|
|
422
|
-
try {
|
|
423
|
-
const result = (dataOrFn as () => Promise<unknown>)();
|
|
424
|
-
store.push(handle.$$id, segmentId, result);
|
|
425
|
-
} finally {
|
|
426
|
-
insideHandlePush = false;
|
|
427
|
-
}
|
|
428
|
-
return;
|
|
429
|
-
}
|
|
430
|
-
|
|
431
|
-
store.push(handle.$$id, segmentId, dataOrFn);
|
|
432
|
-
};
|
|
753
|
+
return withDefer(
|
|
754
|
+
(dataOrFn: unknown | Promise<unknown> | (() => Promise<unknown>)) => {
|
|
755
|
+
pushHandleValue(store, segmentId, handle.$$id, dataOrFn);
|
|
756
|
+
},
|
|
757
|
+
);
|
|
433
758
|
}
|
|
434
759
|
|
|
435
760
|
// Deadlock guard and handler-to-loader dependency tracking.
|
|
436
761
|
// Skip when inside a DSL loader scope (resolveLoaderData also calls
|
|
437
762
|
// ctx.use() but that's DSL-to-DSL, not handler-to-loader) or when
|
|
438
763
|
// inside a handle push callback (push callbacks don't block segment
|
|
439
|
-
// resolution so they can't cause rendered() deadlocks).
|
|
764
|
+
// resolution so they can't cause rendered() deadlocks). The push-callback
|
|
765
|
+
// check is an ALS scope so it also exempts an ASYNC callback's continuation
|
|
766
|
+
// after its first await — relevant on streaming trees, where the guard
|
|
767
|
+
// state now stays live until handleStore.settled.
|
|
440
768
|
const loader = item as LoaderDefinition<any, any>;
|
|
441
|
-
if (!isInsideLoaderScope() && !
|
|
769
|
+
if (!isInsideLoaderScope() && !isInsidePushCallbackScope()) {
|
|
442
770
|
const reqCtx = reqCtxRef ?? _getRequestContext();
|
|
443
771
|
if (reqCtx) {
|
|
444
772
|
// Direction 1: handler awaits loader that already called rendered()
|
|
@@ -452,13 +780,18 @@ export function setupLoaderAccess<TEnv>(
|
|
|
452
780
|
`Move the data dependency to a loader-to-loader pattern instead.`,
|
|
453
781
|
);
|
|
454
782
|
}
|
|
455
|
-
// Direction 2: track dep so rendered() can detect the deadlock
|
|
456
|
-
//
|
|
457
|
-
//
|
|
458
|
-
//
|
|
459
|
-
//
|
|
460
|
-
//
|
|
461
|
-
|
|
783
|
+
// Direction 2: track dep so rendered() can detect the deadlock if the
|
|
784
|
+
// loader calls it later. Skip once the guard window is CLOSED — for a
|
|
785
|
+
// non-streaming tree that is when the barrier resolves (rendered()
|
|
786
|
+
// resolves immediately), and for a streaming tree it is when
|
|
787
|
+
// handleStore.settled completes (rendered() keeps waiting until then, so
|
|
788
|
+
// a loading() handler resuming after the barrier can still form a
|
|
789
|
+
// cycle). Using the explicit guard-closed flag rather than
|
|
790
|
+
// _renderBarrierSegmentOrder keeps tracking live across the streaming
|
|
791
|
+
// settle wait. (Handle push callbacks are already excluded above via
|
|
792
|
+
// isInsidePushCallbackScope(), so they cannot produce false positives
|
|
793
|
+
// here.)
|
|
794
|
+
if (!reqCtx._renderBarrierGuardClosed) {
|
|
462
795
|
if (!reqCtx._handlerLoaderDeps) reqCtx._handlerLoaderDeps = new Set();
|
|
463
796
|
reqCtx._handlerLoaderDeps.add(loader.$$id);
|
|
464
797
|
}
|
|
@@ -492,18 +825,21 @@ export function setupBuildUse<TEnv>(ctx: HandlerContext<any, TEnv>): void {
|
|
|
492
825
|
);
|
|
493
826
|
}
|
|
494
827
|
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
)
|
|
498
|
-
|
|
828
|
+
// Wrap with withDefer so ctx.use(Handle).defer(...) works on the build /
|
|
829
|
+
// prerender path, matching production setupLoaderAccess. Without it a
|
|
830
|
+
// prerender handler calling .defer() throws "defer is not a function".
|
|
831
|
+
return withDefer(
|
|
832
|
+
(dataOrFn: unknown | Promise<unknown> | (() => Promise<unknown>)) => {
|
|
833
|
+
if (!store) return;
|
|
499
834
|
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
835
|
+
const valueOrPromise =
|
|
836
|
+
typeof dataOrFn === "function"
|
|
837
|
+
? (dataOrFn as () => Promise<unknown>)()
|
|
838
|
+
: dataOrFn;
|
|
504
839
|
|
|
505
|
-
|
|
506
|
-
|
|
840
|
+
store.push(handle.$$id, segmentId, valueOrPromise);
|
|
841
|
+
},
|
|
842
|
+
);
|
|
507
843
|
}
|
|
508
844
|
|
|
509
845
|
// Loader case: not available during pre-rendering
|
|
@@ -527,12 +863,17 @@ export function setupLoaderAccessSilent<TEnv>(
|
|
|
527
863
|
ctx: HandlerContext<any, TEnv>,
|
|
528
864
|
loaderPromises: Map<string, Promise<any>>,
|
|
529
865
|
): void {
|
|
530
|
-
const useLoader = createLoaderExecutor(ctx, loaderPromises
|
|
866
|
+
const useLoader = createLoaderExecutor(ctx, loaderPromises, {
|
|
867
|
+
silentHandles: true,
|
|
868
|
+
});
|
|
531
869
|
|
|
532
870
|
ctx.use = ((item: LoaderDefinition<any, any> | Handle<any, any>) => {
|
|
533
871
|
if (isHandle(item)) {
|
|
534
|
-
// Silent mode - return a no-op so handle data is not pushed during caching
|
|
535
|
-
|
|
872
|
+
// Silent mode - return a no-op so handle data is not pushed during caching.
|
|
873
|
+
// Wrap with withDefer so ctx.use(Handle).defer(...) still resolves to a
|
|
874
|
+
// callable resolver (also a no-op here), matching production's push shape
|
|
875
|
+
// instead of throwing "defer is not a function".
|
|
876
|
+
return withDefer((_dataOrFn: unknown) => {});
|
|
536
877
|
}
|
|
537
878
|
|
|
538
879
|
return useLoader(item as LoaderDefinition<any, any>, null);
|