npm - @rangojs/router - Versions diffs - 0.0.0-experimental.f2d1a2f1 → 0.0.0-experimental.f4a8e8de - Mend

@rangojs/router 0.0.0-experimental.f2d1a2f1 → 0.0.0-experimental.f4a8e8de

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.

Files changed (1301) hide show

package/AGENTS.md +8 -4
package/README.md +318 -821
package/dist/bin/rango.js +925 -271
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 +23 -0
package/dist/types/browser/react/use-search-params.d.ts +19 -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 +616 -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 +503 -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 +57 -0
package/dist/types/client-urls/types.d.ts +132 -0
package/dist/types/client.d.ts +191 -0
package/dist/types/client.rsc.d.ts +41 -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 +18 -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 +24 -0
package/dist/types/outlet-provider.d.ts +14 -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 +67 -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 +81 -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 +393 -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 +28 -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 +406 -0
package/dist/types/rsc/shell-serve.d.ts +189 -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 +328 -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 +510 -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 +707 -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 +233 -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 +69 -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 +110 -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 +208 -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 +246 -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 +198 -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 +170 -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 +298 -0
package/dist/types/vite/plugins/cjs-to-esm.d.ts +6 -0
package/dist/types/vite/plugins/client-ref-dedup.d.ts +40 -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 +67 -0
package/dist/types.backup/__internal.d.ts +127 -0
package/dist/types.backup/bin/rango.d.ts +1 -0
package/dist/types.backup/browser/action-coordinator.d.ts +57 -0
package/dist/types.backup/browser/action-fence.d.ts +33 -0
package/dist/types.backup/browser/app-shell.d.ts +34 -0
package/dist/types.backup/browser/app-version.d.ts +6 -0
package/dist/types.backup/browser/connection-warmup.d.ts +31 -0
package/dist/types.backup/browser/cookie-name.d.ts +66 -0
package/dist/types.backup/browser/event-controller.d.ts +221 -0
package/dist/types.backup/browser/history-state.d.ts +26 -0
package/dist/types.backup/browser/index.d.ts +1 -0
package/dist/types.backup/browser/intercept-utils.d.ts +30 -0
package/dist/types.backup/browser/invalidate-client-cache.d.ts +17 -0
package/dist/types.backup/browser/link-interceptor.d.ts +43 -0
package/dist/types.backup/browser/logging.d.ts +33 -0
package/dist/types.backup/browser/merge-segment-loaders.d.ts +38 -0
package/dist/types.backup/browser/navigation-bridge.d.ts +27 -0
package/dist/types.backup/browser/navigation-client.d.ts +17 -0
package/dist/types.backup/browser/navigation-store-handle.d.ts +25 -0
package/dist/types.backup/browser/navigation-store.d.ts +95 -0
package/dist/types.backup/browser/navigation-transaction.d.ts +75 -0
package/dist/types.backup/browser/network-error-handler.d.ts +35 -0
package/dist/types.backup/browser/partial-update.d.ts +61 -0
package/dist/types.backup/browser/prefetch/cache.d.ts +183 -0
package/dist/types.backup/browser/prefetch/fetch.d.ts +52 -0
package/dist/types.backup/browser/prefetch/observer.d.ts +27 -0
package/dist/types.backup/browser/prefetch/policy.d.ts +13 -0
package/dist/types.backup/browser/prefetch/queue.d.ts +48 -0
package/dist/types.backup/browser/prefetch/resource-ready.d.ts +28 -0
package/dist/types.backup/browser/rango-state.d.ts +52 -0
package/dist/types.backup/browser/react/Link.d.ts +140 -0
package/dist/types.backup/browser/react/NavigationProvider.d.ts +88 -0
package/dist/types.backup/browser/react/ScrollRestoration.d.ts +78 -0
package/dist/types.backup/browser/react/context.d.ts +54 -0
package/dist/types.backup/browser/react/filter-segment-order.d.ts +35 -0
package/dist/types.backup/browser/react/index.d.ts +1 -0
package/dist/types.backup/browser/react/location-state-shared.d.ts +162 -0
package/dist/types.backup/browser/react/location-state.d.ts +29 -0
package/dist/types.backup/browser/react/mount-context.d.ts +23 -0
package/dist/types.backup/browser/react/nonce-context.d.ts +14 -0
package/dist/types.backup/browser/react/shallow-equal.d.ts +5 -0
package/dist/types.backup/browser/react/use-action.d.ts +61 -0
package/dist/types.backup/browser/react/use-handle.d.ts +21 -0
package/dist/types.backup/browser/react/use-href.d.ts +32 -0
package/dist/types.backup/browser/react/use-link-status.d.ts +36 -0
package/dist/types.backup/browser/react/use-mount.d.ts +24 -0
package/dist/types.backup/browser/react/use-navigation.d.ts +15 -0
package/dist/types.backup/browser/react/use-params.d.ts +21 -0
package/dist/types.backup/browser/react/use-pathname.d.ts +13 -0
package/dist/types.backup/browser/react/use-reverse.d.ts +40 -0
package/dist/types.backup/browser/react/use-router.d.ts +23 -0
package/dist/types.backup/browser/react/use-search-params.d.ts +19 -0
package/dist/types.backup/browser/react/use-segments.d.ts +29 -0
package/dist/types.backup/browser/response-adapter.d.ts +58 -0
package/dist/types.backup/browser/rsc-router.d.ts +141 -0
package/dist/types.backup/browser/scroll-restoration.d.ts +103 -0
package/dist/types.backup/browser/segment-reconciler.d.ts +74 -0
package/dist/types.backup/browser/segment-structure-assert.d.ts +16 -0
package/dist/types.backup/browser/server-action-bridge.d.ts +29 -0
package/dist/types.backup/browser/types.d.ts +530 -0
package/dist/types.backup/browser/validate-redirect-origin.d.ts +28 -0
package/dist/types.backup/build/collect-fallback-refs.d.ts +5 -0
package/dist/types.backup/build/generate-manifest.d.ts +100 -0
package/dist/types.backup/build/generate-route-types.d.ts +8 -0
package/dist/types.backup/build/index.d.ts +21 -0
package/dist/types.backup/build/prefix-tree-utils.d.ts +56 -0
package/dist/types.backup/build/route-trie.d.ts +89 -0
package/dist/types.backup/build/route-types/ast-helpers.d.ts +3 -0
package/dist/types.backup/build/route-types/ast-route-extraction.d.ts +13 -0
package/dist/types.backup/build/route-types/codegen.d.ts +16 -0
package/dist/types.backup/build/route-types/include-resolution.d.ts +74 -0
package/dist/types.backup/build/route-types/param-extraction.d.ts +13 -0
package/dist/types.backup/build/route-types/per-module-writer.d.ts +18 -0
package/dist/types.backup/build/route-types/router-processing.d.ts +82 -0
package/dist/types.backup/build/route-types/scan-filter.d.ts +17 -0
package/dist/types.backup/build/route-types/source-scan.d.ts +13 -0
package/dist/types.backup/build/runtime-discovery.d.ts +24 -0
package/dist/types.backup/cache/background-task.d.ts +21 -0
package/dist/types.backup/cache/cache-error.d.ts +71 -0
package/dist/types.backup/cache/cache-key-utils.d.ts +35 -0
package/dist/types.backup/cache/cache-policy.d.ts +59 -0
package/dist/types.backup/cache/cache-runtime.d.ts +51 -0
package/dist/types.backup/cache/cache-scope.d.ts +134 -0
package/dist/types.backup/cache/cache-tag.d.ts +79 -0
package/dist/types.backup/cache/cf/cf-base64.d.ts +4 -0
package/dist/types.backup/cache/cf/cf-cache-constants.d.ts +105 -0
package/dist/types.backup/cache/cf/cf-cache-store.d.ts +481 -0
package/dist/types.backup/cache/cf/cf-cache-types.d.ts +300 -0
package/dist/types.backup/cache/cf/cf-kv-utils.d.ts +22 -0
package/dist/types.backup/cache/cf/cf-tag-marker-memo.d.ts +15 -0
package/dist/types.backup/cache/cf/index.d.ts +3 -0
package/dist/types.backup/cache/document-cache.d.ts +69 -0
package/dist/types.backup/cache/handle-capture.d.ts +23 -0
package/dist/types.backup/cache/handle-snapshot.d.ts +39 -0
package/dist/types.backup/cache/index.d.ts +7 -0
package/dist/types.backup/cache/memory-segment-store.d.ts +163 -0
package/dist/types.backup/cache/profile-registry.d.ts +40 -0
package/dist/types.backup/cache/read-through-swr.d.ts +60 -0
package/dist/types.backup/cache/segment-codec.d.ts +78 -0
package/dist/types.backup/cache/shell-snapshot.d.ts +162 -0
package/dist/types.backup/cache/tag-invalidation.d.ts +74 -0
package/dist/types.backup/cache/taint.d.ts +71 -0
package/dist/types.backup/cache/types.d.ts +407 -0
package/dist/types.backup/cache/vercel/index.d.ts +1 -0
package/dist/types.backup/cache/vercel/vercel-cache-store.d.ts +267 -0
package/dist/types.backup/client.d.ts +184 -0
package/dist/types.backup/client.rsc.d.ts +39 -0
package/dist/types.backup/cloudflare/index.d.ts +7 -0
package/dist/types.backup/cloudflare/tracing.d.ts +53 -0
package/dist/types.backup/component-utils.d.ts +46 -0
package/dist/types.backup/components/DefaultDocument.d.ts +13 -0
package/dist/types.backup/context-var.d.ts +84 -0
package/dist/types.backup/debug.d.ts +57 -0
package/dist/types.backup/decode-loader-results.d.ts +5 -0
package/dist/types.backup/default-error-boundary.d.ts +10 -0
package/dist/types.backup/defer.d.ts +89 -0
package/dist/types.backup/deps/browser.d.ts +1 -0
package/dist/types.backup/deps/html-stream-client.d.ts +1 -0
package/dist/types.backup/deps/html-stream-server.d.ts +1 -0
package/dist/types.backup/deps/rsc.d.ts +1 -0
package/dist/types.backup/deps/ssr.d.ts +1 -0
package/dist/types.backup/encode-kv.d.ts +35 -0
package/dist/types.backup/errors.d.ts +226 -0
package/dist/types.backup/escape-script.d.ts +44 -0
package/dist/types.backup/handle.d.ts +93 -0
package/dist/types.backup/handles/MetaTags.d.ts +17 -0
package/dist/types.backup/handles/Scripts.d.ts +38 -0
package/dist/types.backup/handles/breadcrumbs.d.ts +43 -0
package/dist/types.backup/handles/deferred-resolution.d.ts +53 -0
package/dist/types.backup/handles/is-thenable.d.ts +12 -0
package/dist/types.backup/handles/meta.d.ts +43 -0
package/dist/types.backup/handles/script.d.ts +139 -0
package/dist/types.backup/host/cookie-handler.d.ts +8 -0
package/dist/types.backup/host/errors.d.ts +40 -0
package/dist/types.backup/host/index.d.ts +33 -0
package/dist/types.backup/host/pattern-matcher.d.ts +30 -0
package/dist/types.backup/host/router.d.ts +12 -0
package/dist/types.backup/host/testing.d.ts +41 -0
package/dist/types.backup/host/types.d.ts +148 -0
package/dist/types.backup/host/utils.d.ts +20 -0
package/dist/types.backup/href-client.d.ts +214 -0
package/dist/types.backup/index.d.ts +112 -0
package/dist/types.backup/index.rsc.d.ts +51 -0
package/dist/types.backup/internal-debug.d.ts +1 -0
package/dist/types.backup/loader-store.d.ts +193 -0
package/dist/types.backup/loader.d.ts +18 -0
package/dist/types.backup/loader.rsc.d.ts +18 -0
package/dist/types.backup/missing-id-error.d.ts +1 -0
package/dist/types.backup/outlet-context.d.ts +12 -0
package/dist/types.backup/outlet-provider.d.ts +12 -0
package/dist/types.backup/prerender/build-shell-capture.d.ts +104 -0
package/dist/types.backup/prerender/param-hash.d.ts +6 -0
package/dist/types.backup/prerender/shell-manifest-key.d.ts +18 -0
package/dist/types.backup/prerender/store.d.ts +62 -0
package/dist/types.backup/prerender.d.ts +292 -0
package/dist/types.backup/redirect-origin.d.ts +55 -0
package/dist/types.backup/regex-escape.d.ts +6 -0
package/dist/types.backup/render-error-thrower.d.ts +13 -0
package/dist/types.backup/response-utils.d.ts +35 -0
package/dist/types.backup/reverse.d.ts +206 -0
package/dist/types.backup/root-error-boundary.d.ts +32 -0
package/dist/types.backup/route-content-wrapper.d.ts +40 -0
package/dist/types.backup/route-definition/dsl-helpers.d.ts +130 -0
package/dist/types.backup/route-definition/helper-factories.d.ts +22 -0
package/dist/types.backup/route-definition/helpers-types.d.ts +392 -0
package/dist/types.backup/route-definition/index.d.ts +7 -0
package/dist/types.backup/route-definition/redirect.d.ts +48 -0
package/dist/types.backup/route-definition/resolve-handler-use.d.ts +19 -0
package/dist/types.backup/route-definition/use-item-types.d.ts +1 -0
package/dist/types.backup/route-definition.d.ts +1 -0
package/dist/types.backup/route-map-builder.d.ts +127 -0
package/dist/types.backup/route-name.d.ts +27 -0
package/dist/types.backup/route-types.d.ts +172 -0
package/dist/types.backup/router/basename.d.ts +10 -0
package/dist/types.backup/router/content-negotiation.d.ts +91 -0
package/dist/types.backup/router/debug-manifest.d.ts +7 -0
package/dist/types.backup/router/error-handling.d.ts +76 -0
package/dist/types.backup/router/find-match.d.ts +19 -0
package/dist/types.backup/router/handler-context.d.ts +41 -0
package/dist/types.backup/router/instrument.d.ts +161 -0
package/dist/types.backup/router/intercept-resolution.d.ts +79 -0
package/dist/types.backup/router/lazy-includes.d.ts +26 -0
package/dist/types.backup/router/loader-resolution.d.ts +63 -0
package/dist/types.backup/router/logging.d.ts +41 -0
package/dist/types.backup/router/manifest.d.ts +8 -0
package/dist/types.backup/router/match-api.d.ts +19 -0
package/dist/types.backup/router/match-context.d.ts +184 -0
package/dist/types.backup/router/match-handlers.d.ts +49 -0
package/dist/types.backup/router/match-middleware/background-revalidation.d.ts +113 -0
package/dist/types.backup/router/match-middleware/cache-lookup.d.ts +113 -0
package/dist/types.backup/router/match-middleware/cache-store.d.ts +112 -0
package/dist/types.backup/router/match-middleware/index.d.ts +80 -0
package/dist/types.backup/router/match-middleware/intercept-resolution.d.ts +116 -0
package/dist/types.backup/router/match-middleware/segment-resolution.d.ts +94 -0
package/dist/types.backup/router/match-pipelines.d.ts +103 -0
package/dist/types.backup/router/match-result.d.ts +114 -0
package/dist/types.backup/router/metrics.d.ts +6 -0
package/dist/types.backup/router/middleware-types.d.ts +74 -0
package/dist/types.backup/router/middleware.d.ts +116 -0
package/dist/types.backup/router/navigation-snapshot.d.ts +22 -0
package/dist/types.backup/router/params-util.d.ts +8 -0
package/dist/types.backup/router/parse-pattern.d.ts +38 -0
package/dist/types.backup/router/pattern-matching.d.ts +169 -0
package/dist/types.backup/router/prefetch-cache-ttl.d.ts +27 -0
package/dist/types.backup/router/prefetch-limits.d.ts +20 -0
package/dist/types.backup/router/prerender-match.d.ts +50 -0
package/dist/types.backup/router/preview-match.d.ts +22 -0
package/dist/types.backup/router/request-classification.d.ts +104 -0
package/dist/types.backup/router/revalidation.d.ts +57 -0
package/dist/types.backup/router/route-snapshot.d.ts +112 -0
package/dist/types.backup/router/router-context.d.ts +137 -0
package/dist/types.backup/router/router-interfaces.d.ts +432 -0
package/dist/types.backup/router/router-options.d.ts +738 -0
package/dist/types.backup/router/router-registry.d.ts +15 -0
package/dist/types.backup/router/segment-resolution/fresh.d.ts +55 -0
package/dist/types.backup/router/segment-resolution/helpers.d.ts +93 -0
package/dist/types.backup/router/segment-resolution/loader-cache.d.ts +33 -0
package/dist/types.backup/router/segment-resolution/loader-mask.d.ts +44 -0
package/dist/types.backup/router/segment-resolution/loader-snapshot.d.ts +90 -0
package/dist/types.backup/router/segment-resolution/mask-nested.d.ts +53 -0
package/dist/types.backup/router/segment-resolution/revalidation.d.ts +85 -0
package/dist/types.backup/router/segment-resolution/static-store.d.ts +17 -0
package/dist/types.backup/router/segment-resolution/streamed-handler-telemetry.d.ts +16 -0
package/dist/types.backup/router/segment-resolution/view-transition-default.d.ts +28 -0
package/dist/types.backup/router/segment-resolution.d.ts +3 -0
package/dist/types.backup/router/segment-wrappers.d.ts +53 -0
package/dist/types.backup/router/state-cookie-name.d.ts +1 -0
package/dist/types.backup/router/substitute-pattern-params.d.ts +23 -0
package/dist/types.backup/router/telemetry-otel.d.ts +113 -0
package/dist/types.backup/router/telemetry.d.ts +215 -0
package/dist/types.backup/router/timeout.d.ts +68 -0
package/dist/types.backup/router/tracing.d.ts +125 -0
package/dist/types.backup/router/trie-matching.d.ts +32 -0
package/dist/types.backup/router/types.d.ts +98 -0
package/dist/types.backup/router/url-params.d.ts +26 -0
package/dist/types.backup/router.d.ts +7 -0
package/dist/types.backup/rsc/capture-queue.d.ts +6 -0
package/dist/types.backup/rsc/full-payload.d.ts +22 -0
package/dist/types.backup/rsc/handler-context.d.ts +31 -0
package/dist/types.backup/rsc/handler.d.ts +9 -0
package/dist/types.backup/rsc/helpers.d.ts +213 -0
package/dist/types.backup/rsc/index.d.ts +17 -0
package/dist/types.backup/rsc/json-route-result.d.ts +20 -0
package/dist/types.backup/rsc/loader-fetch.d.ts +14 -0
package/dist/types.backup/rsc/manifest-init.d.ts +18 -0
package/dist/types.backup/rsc/nonce.d.ts +28 -0
package/dist/types.backup/rsc/origin-guard.d.ts +50 -0
package/dist/types.backup/rsc/progressive-enhancement.d.ts +19 -0
package/dist/types.backup/rsc/redirect-guard.d.ts +35 -0
package/dist/types.backup/rsc/response-cache-serve.d.ts +46 -0
package/dist/types.backup/rsc/response-error.d.ts +19 -0
package/dist/types.backup/rsc/response-route-handler.d.ts +29 -0
package/dist/types.backup/rsc/rsc-rendering.d.ts +23 -0
package/dist/types.backup/rsc/runtime-warnings.d.ts +22 -0
package/dist/types.backup/rsc/server-action.d.ts +68 -0
package/dist/types.backup/rsc/shell-build-manifest.d.ts +84 -0
package/dist/types.backup/rsc/shell-capture-constants.d.ts +27 -0
package/dist/types.backup/rsc/shell-capture.d.ts +374 -0
package/dist/types.backup/rsc/shell-serve.d.ts +136 -0
package/dist/types.backup/rsc/ssr-setup.d.ts +48 -0
package/dist/types.backup/rsc/transition-gate.d.ts +27 -0
package/dist/types.backup/rsc/types.d.ts +290 -0
package/dist/types.backup/runtime-env.d.ts +1 -0
package/dist/types.backup/search-params.d.ts +125 -0
package/dist/types.backup/segment-content-promise.d.ts +13 -0
package/dist/types.backup/segment-fragments.d.ts +56 -0
package/dist/types.backup/segment-loader-promise.d.ts +22 -0
package/dist/types.backup/segment-system.d.ts +84 -0
package/dist/types.backup/serialize.d.ts +164 -0
package/dist/types.backup/server/context.d.ts +494 -0
package/dist/types.backup/server/cookie-parse.d.ts +10 -0
package/dist/types.backup/server/cookie-store.d.ts +107 -0
package/dist/types.backup/server/fetchable-loader-store.d.ts +20 -0
package/dist/types.backup/server/handle-store.d.ts +100 -0
package/dist/types.backup/server/loader-registry.d.ts +32 -0
package/dist/types.backup/server/request-context.d.ts +596 -0
package/dist/types.backup/server/root-layout.d.ts +3 -0
package/dist/types.backup/server.d.ts +15 -0
package/dist/types.backup/ssr/index.d.ts +233 -0
package/dist/types.backup/ssr/inject-rsc-eager.d.ts +3 -0
package/dist/types.backup/ssr/preinit-client-references.d.ts +71 -0
package/dist/types.backup/ssr/ssr-root.d.ts +69 -0
package/dist/types.backup/static-handler.d.ts +57 -0
package/dist/types.backup/testing/cache-status.d.ts +63 -0
package/dist/types.backup/testing/collect-handle.d.ts +20 -0
package/dist/types.backup/testing/dispatch.d.ts +123 -0
package/dist/types.backup/testing/dom.entry.d.ts +15 -0
package/dist/types.backup/testing/e2e/fixture.d.ts +37 -0
package/dist/types.backup/testing/e2e/index.d.ts +30 -0
package/dist/types.backup/testing/e2e/matchers.d.ts +17 -0
package/dist/types.backup/testing/e2e/page-helpers.d.ts +62 -0
package/dist/types.backup/testing/e2e/parity.d.ts +111 -0
package/dist/types.backup/testing/e2e/server.d.ts +35 -0
package/dist/types.backup/testing/flight-matchers.d.ts +55 -0
package/dist/types.backup/testing/flight-normalize.d.ts +1 -0
package/dist/types.backup/testing/flight-tree.d.ts +192 -0
package/dist/types.backup/testing/flight.d.ts +115 -0
package/dist/types.backup/testing/flight.entry.d.ts +27 -0
package/dist/types.backup/testing/generated-routes.d.ts +66 -0
package/dist/types.backup/testing/index.d.ts +52 -0
package/dist/types.backup/testing/internal/context.d.ts +225 -0
package/dist/types.backup/testing/internal/flight-client-globals.d.ts +1 -0
package/dist/types.backup/testing/internal/seed-vars.d.ts +30 -0
package/dist/types.backup/testing/render-handler.d.ts +160 -0
package/dist/types.backup/testing/render-route.d.ts +246 -0
package/dist/types.backup/testing/run-loader.d.ts +186 -0
package/dist/types.backup/testing/run-middleware.d.ts +132 -0
package/dist/types.backup/testing/run-transition-when.d.ts +77 -0
package/dist/types.backup/testing/vitest-stubs/cloudflare-email.d.ts +6 -0
package/dist/types.backup/testing/vitest-stubs/cloudflare-workers.d.ts +13 -0
package/dist/types.backup/testing/vitest-stubs/plugin-rsc.d.ts +7 -0
package/dist/types.backup/testing/vitest-stubs/version.d.ts +1 -0
package/dist/types.backup/testing/vitest.d.ts +205 -0
package/dist/types.backup/theme/ThemeProvider.d.ts +13 -0
package/dist/types.backup/theme/ThemeScript.d.ts +45 -0
package/dist/types.backup/theme/constants.d.ts +39 -0
package/dist/types.backup/theme/index.d.ts +29 -0
package/dist/types.backup/theme/theme-context.d.ts +21 -0
package/dist/types.backup/theme/theme-script.d.ts +26 -0
package/dist/types.backup/theme/types.d.ts +162 -0
package/dist/types.backup/theme/use-theme.d.ts +8 -0
package/dist/types.backup/types/boundaries.d.ts +93 -0
package/dist/types.backup/types/cache-types.d.ts +191 -0
package/dist/types.backup/types/error-types.d.ts +114 -0
package/dist/types.backup/types/global-namespace.d.ts +90 -0
package/dist/types.backup/types/handler-context.d.ts +658 -0
package/dist/types.backup/types/index.d.ts +11 -0
package/dist/types.backup/types/loader-types.d.ts +182 -0
package/dist/types.backup/types/request-scope.d.ts +93 -0
package/dist/types.backup/types/route-config.d.ts +105 -0
package/dist/types.backup/types/route-entry.d.ts +95 -0
package/dist/types.backup/types/segments.d.ts +234 -0
package/dist/types.backup/types.d.ts +1 -0
package/dist/types.backup/urls/include-helper.d.ts +17 -0
package/dist/types.backup/urls/include-provider.d.ts +27 -0
package/dist/types.backup/urls/index.d.ts +6 -0
package/dist/types.backup/urls/path-helper-types.d.ts +197 -0
package/dist/types.backup/urls/path-helper.d.ts +12 -0
package/dist/types.backup/urls/pattern-types.d.ts +166 -0
package/dist/types.backup/urls/response-types.d.ts +67 -0
package/dist/types.backup/urls/type-extraction.d.ts +157 -0
package/dist/types.backup/urls/urls-function.d.ts +24 -0
package/dist/types.backup/urls.d.ts +1 -0
package/dist/types.backup/use-loader.d.ts +150 -0
package/dist/types.backup/vercel/index.d.ts +10 -0
package/dist/types.backup/vercel/tracing.d.ts +70 -0
package/dist/types.backup/vite/debug.d.ts +80 -0
package/dist/types.backup/vite/discovery/bundle-postprocess.d.ts +12 -0
package/dist/types.backup/vite/discovery/dev-prerender-cache.d.ts +65 -0
package/dist/types.backup/vite/discovery/discover-routers.d.ts +17 -0
package/dist/types.backup/vite/discovery/discovery-errors.d.ts +113 -0
package/dist/types.backup/vite/discovery/gate-state.d.ts +79 -0
package/dist/types.backup/vite/discovery/prerender-collection.d.ts +24 -0
package/dist/types.backup/vite/discovery/route-types-writer.d.ts +32 -0
package/dist/types.backup/vite/discovery/self-gen-tracking.d.ts +22 -0
package/dist/types.backup/vite/discovery/shell-prerender-phase.d.ts +40 -0
package/dist/types.backup/vite/discovery/state.d.ts +162 -0
package/dist/types.backup/vite/discovery/virtual-module-codegen.d.ts +15 -0
package/dist/types.backup/vite/index.d.ts +11 -0
package/dist/types.backup/vite/inject-client-debug.d.ts +56 -0
package/dist/types.backup/vite/plugin-types.d.ts +298 -0
package/dist/types.backup/vite/plugins/cjs-to-esm.d.ts +6 -0
package/dist/types.backup/vite/plugins/client-ref-dedup.d.ts +40 -0
package/dist/types.backup/vite/plugins/client-ref-hashing.d.ts +35 -0
package/dist/types.backup/vite/plugins/cloudflare-protocol-stub.d.ts +64 -0
package/dist/types.backup/vite/plugins/expose-action-id.d.ts +18 -0
package/dist/types.backup/vite/plugins/expose-id-utils.d.ts +37 -0
package/dist/types.backup/vite/plugins/expose-ids/export-analysis.d.ts +19 -0
package/dist/types.backup/vite/plugins/expose-ids/handler-transform.d.ts +10 -0
package/dist/types.backup/vite/plugins/expose-ids/loader-transform.d.ts +8 -0
package/dist/types.backup/vite/plugins/expose-ids/router-transform.d.ts +13 -0
package/dist/types.backup/vite/plugins/expose-ids/types.d.ts +29 -0
package/dist/types.backup/vite/plugins/expose-internal-ids.d.ts +6 -0
package/dist/types.backup/vite/plugins/performance-tracks.d.ts +25 -0
package/dist/types.backup/vite/plugins/refresh-cmd.d.ts +20 -0
package/dist/types.backup/vite/plugins/use-cache-transform.d.ts +20 -0
package/dist/types.backup/vite/plugins/vercel-output.d.ts +85 -0
package/dist/types.backup/vite/plugins/version-injector.d.ts +21 -0
package/dist/types.backup/vite/plugins/version-plugin.d.ts +19 -0
package/dist/types.backup/vite/plugins/virtual-entries.d.ts +36 -0
package/dist/types.backup/vite/plugins/virtual-stub-plugin.d.ts +7 -0
package/dist/types.backup/vite/rango.d.ts +29 -0
package/dist/types.backup/vite/router-discovery.d.ts +23 -0
package/dist/types.backup/vite/utils/ast-handler-extract.d.ts +64 -0
package/dist/types.backup/vite/utils/banner.d.ts +2 -0
package/dist/types.backup/vite/utils/bundle-analysis.d.ts +28 -0
package/dist/types.backup/vite/utils/client-chunks.d.ts +55 -0
package/dist/types.backup/vite/utils/directive-prologue.d.ts +16 -0
package/dist/types.backup/vite/utils/forward-user-plugins.d.ts +37 -0
package/dist/types.backup/vite/utils/manifest-utils.d.ts +7 -0
package/dist/types.backup/vite/utils/package-resolution.d.ts +6 -0
package/dist/types.backup/vite/utils/prerender-utils.d.ts +32 -0
package/dist/types.backup/vite/utils/shared-utils.d.ts +55 -0
package/dist/vite/index.js +9695 -3592
package/package.json +119 -39
package/skills/api-client/SKILL.md +211 -0
package/skills/breadcrumbs/SKILL.md +82 -5
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 +283 -0
package/skills/cloudflare/SKILL.md +151 -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 +844 -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 +12 -10
package/skills/hooks/SKILL.md +73 -699
package/skills/hooks/data.md +273 -0
package/skills/hooks/handle-and-actions.md +103 -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 +135 -0
package/skills/host-router/SKILL.md +129 -27
package/skills/i18n/SKILL.md +276 -0
package/skills/intercept/SKILL.md +75 -19
package/skills/layout/SKILL.md +40 -19
package/skills/links/SKILL.md +211 -17
package/skills/loader/SKILL.md +230 -25
package/skills/middleware/SKILL.md +58 -13
package/skills/migrate-nextjs/SKILL.md +267 -33
package/skills/migrate-nextjs/backend-host-swap.md +120 -0
package/skills/migrate-react-router/SKILL.md +59 -671
package/skills/migrate-react-router/component-migration.md +196 -0
package/skills/migrate-react-router/data-and-actions.md +225 -0
package/skills/migrate-react-router/route-mapping.md +271 -0
package/skills/mime-routes/SKILL.md +55 -18
package/skills/observability/SKILL.md +231 -0
package/skills/parallel/SKILL.md +50 -10
package/skills/ppr/SKILL.md +904 -0
package/skills/prerender/SKILL.md +130 -68
package/skills/rango/SKILL.md +321 -26
package/skills/react-compiler/SKILL.md +168 -0
package/skills/response-routes/SKILL.md +172 -52
package/skills/route/SKILL.md +123 -9
package/skills/router-setup/SKILL.md +53 -9
package/skills/scripts/SKILL.md +179 -0
package/skills/server-actions/SKILL.md +776 -0
package/skills/shell-manifest/SKILL.md +185 -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 +131 -0
package/skills/testing/loader.md +128 -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 +1 -1
package/skills/typesafety/SKILL.md +45 -628
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 +341 -0
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/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 +400 -168
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 +164 -69
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 +219 -163
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 +115 -75
package/src/browser/react/NavigationProvider.tsx +194 -143
package/src/browser/react/ScrollRestoration.tsx +10 -6
package/src/browser/react/context.ts +4 -0
package/src/browser/react/filter-segment-order.ts +66 -7
package/src/browser/react/index.ts +0 -48
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 +11 -11
package/src/browser/react/use-reverse.ts +106 -0
package/src/browser/react/use-router.ts +21 -6
package/src/browser/react/use-search-params.ts +0 -5
package/src/browser/react/use-segments.ts +11 -21
package/src/browser/response-adapter.ts +99 -8
package/src/browser/rsc-router.tsx +230 -42
package/src/browser/scroll-restoration.ts +37 -22
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 +132 -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 -280
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 +3028 -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 +323 -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 +161 -0
package/src/client-urls/client-urls.ts +665 -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 +563 -0
package/src/client-urls/types.ts +178 -0
package/src/client.rsc.tsx +48 -21
package/src/client.tsx +77 -67
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 +160 -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 +137 -22
package/src/index.rsc.ts +105 -12
package/src/index.ts +102 -14
package/src/internal-debug.ts +11 -10
package/src/loader-redirect.tsx +47 -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 +12 -0
package/src/outlet-provider.tsx +16 -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 +143 -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 +65 -40
package/src/root-error-boundary.tsx +1 -19
package/src/route-content-wrapper.tsx +112 -78
package/src/route-definition/dsl-helpers.ts +300 -313
package/src/route-definition/helper-factories.ts +28 -140
package/src/route-definition/helpers-types.ts +92 -62
package/src/route-definition/index.ts +1 -2
package/src/route-definition/redirect.ts +44 -11
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 +41 -57
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 +401 -85
package/src/router/logging.ts +0 -6
package/src/router/manifest.ts +74 -40
package/src/router/match-api.ts +91 -55
package/src/router/match-context.ts +0 -22
package/src/router/match-handlers.ts +268 -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 +76 -79
package/src/router/metrics.ts +17 -36
package/src/router/middleware-types.ts +20 -110
package/src/router/middleware.ts +275 -173
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 +134 -154
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 +146 -83
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 +163 -88
package/src/router/segment-resolution/helpers.ts +96 -18
package/src/router/segment-resolution/loader-cache.ts +187 -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 +316 -321
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 +75 -0
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 +170 -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 +562 -284
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 +10 -1
package/src/rsc/origin-guard.ts +39 -25
package/src/rsc/progressive-enhancement.ts +377 -84
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 +1624 -171
package/src/rsc/runtime-warnings.ts +23 -10
package/src/rsc/server-action.ts +420 -139
package/src/rsc/shell-build-manifest.ts +336 -0
package/src/rsc/shell-capture-constants.ts +45 -0
package/src/rsc/shell-capture.ts +2063 -0
package/src/rsc/shell-serve.ts +337 -0
package/src/rsc/ssr-setup.ts +111 -16
package/src/rsc/stream-idle.ts +137 -0
package/src/rsc/transition-gate.ts +86 -0
package/src/rsc/types.ts +91 -5
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 +441 -153
package/src/serialize.ts +243 -0
package/src/server/context.ts +416 -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 +805 -177
package/src/server.ts +7 -2
package/src/ssr/index.tsx +631 -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 +262 -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 +15 -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 +121 -30
package/src/types/index.ts +3 -10
package/src/types/loader-types.ts +38 -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 +147 -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 +76 -24
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 +355 -109
package/src/vercel/index.ts +11 -0
package/src/vercel/tracing.ts +89 -0
package/src/vite/debug.ts +102 -3
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 +178 -151
package/src/vite/discovery/discovery-errors.ts +255 -0
package/src/vite/discovery/gate-state.ts +171 -0
package/src/vite/discovery/prerender-collection.ts +125 -70
package/src/vite/discovery/route-types-writer.ts +40 -84
package/src/vite/discovery/self-gen-tracking.ts +27 -1
package/src/vite/discovery/shell-prerender-phase.ts +397 -0
package/src/vite/discovery/state.ts +104 -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 +243 -10
package/src/vite/plugins/cjs-to-esm.ts +16 -19
package/src/vite/plugins/client-ref-dedup.ts +16 -11
package/src/vite/plugins/client-ref-hashing.ts +28 -15
package/src/vite/plugins/cloudflare-protocol-stub.ts +1 -21
package/src/vite/plugins/expose-action-id.ts +50 -97
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 +118 -29
package/src/vite/plugins/expose-internal-ids.ts +551 -486
package/src/vite/plugins/performance-tracks.ts +25 -22
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 +73 -83
package/src/vite/plugins/vercel-output.ts +384 -0
package/src/vite/plugins/version-injector.ts +39 -29
package/src/vite/plugins/version-plugin.ts +45 -40
package/src/vite/plugins/virtual-entries.ts +193 -30
package/src/vite/rango.ts +240 -128
package/src/vite/router-discovery.ts +1518 -174
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 -49
package/src/vite/utils/shared-utils.ts +156 -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

package/src/theme/constants.ts CHANGED Viewed

@@ -2,11 +2,8 @@
  * Default values for theme configuration
  */
-import type { ResolvedThemeConfig, ThemeConfig } from "./types.js";
+import type { ResolvedThemeConfig, Theme, ThemeConfig } from "./types.js";
-/**
- * Default theme configuration values
- */
 export const THEME_DEFAULTS = {
   defaultTheme: "system",
   themes: ["light", "dark"],
@@ -16,9 +13,6 @@ export const THEME_DEFAULTS = {
   enableColorScheme: true,
 } as const;
-/**
- * Cookie configuration for theme persistence
- */
 export const THEME_COOKIE: {
   readonly maxAge: number;
   readonly path: string;
@@ -30,31 +24,76 @@ export const THEME_COOKIE: {
 };
 /**
- * Resolve theme config by applying defaults.
- * Accepts `true` to enable with all defaults, or a config object.
+ * Single owner of the setTheme validity rule, shared by the client
+ * (ThemeProvider) and server (ctx.setTheme) guards so they cannot drift.
+ *
+ * A theme is valid when it is one of the configured concrete themes, OR
+ * "system" but only while system detection is enabled. Rejecting "system" when
+ * `enableSystem` is false is load-bearing: applyThemeToDocument would otherwise
+ * leave "system" unresolved and write a bogus class="system" / colorScheme
+ * ="system" on <html> (the same bogus value resolveThemeConfig coerces away for
+ * the default).
+ */
+export function isValidTheme(
+  theme: string,
+  config: Pick<ResolvedThemeConfig, "themes" | "enableSystem">,
+): boolean {
+  if (theme === "system") return config.enableSystem;
+  return config.themes.includes(theme);
+}
+/**
+ * Emit the shared "[Theme] Invalid theme value" warning. One owner of the
+ * message string so the client and server guards stay byte-identical.
+ *
+ * The valid-values list mirrors isValidTheme: "system" is only listed when
+ * enableSystem is true, otherwise the message would advertise a value the guard
+ * itself rejects.
  */
+export function warnInvalidTheme(
+  theme: string,
+  config: Pick<ResolvedThemeConfig, "themes" | "enableSystem">,
+): void {
+  const validValues = config.enableSystem
+    ? ["system", ...config.themes]
+    : config.themes;
+  console.warn(
+    `[Theme] Invalid theme value: "${theme}". Valid values: ${validValues.join(", ")}`,
+  );
+}
 export function resolveThemeConfig(
   config: ThemeConfig | true,
 ): ResolvedThemeConfig {
-  // Handle `theme: true` shorthand
   if (config === true) {
     config = {};
   }
   const themes = config.themes ?? [...THEME_DEFAULTS.themes];
-  // Build value mapping - default to identity mapping
   const value: Record<string, string> = {};
   for (const theme of themes) {
     value[theme] = config.value?.[theme] ?? theme;
   }
+  const enableSystem = config.enableSystem ?? THEME_DEFAULTS.enableSystem;
+  // When system detection is disabled, "system" is not a valid resolved theme.
+  // Coerce both the unset default and an explicit defaultTheme:"system" to the
+  // first concrete theme, so the FOUC script / ThemeProvider never apply a bogus
+  // class="system" / colorScheme="system" on <html>.
+  const requestedDefault = config.defaultTheme ?? THEME_DEFAULTS.defaultTheme;
+  const defaultTheme =
+    !enableSystem && requestedDefault === "system"
+      ? (themes[0] as Theme)
+      : requestedDefault;
   return {
-    defaultTheme: config.defaultTheme ?? THEME_DEFAULTS.defaultTheme,
+    defaultTheme,
     themes,
     attribute: config.attribute ?? THEME_DEFAULTS.attribute,
     storageKey: config.storageKey ?? THEME_DEFAULTS.storageKey,
-    enableSystem: config.enableSystem ?? THEME_DEFAULTS.enableSystem,
+    enableSystem,
     enableColorScheme:
       config.enableColorScheme ?? THEME_DEFAULTS.enableColorScheme,
     value,

package/src/theme/index.ts CHANGED Viewed

@@ -23,16 +23,10 @@
  * ```
  */
-// Main hook for accessing theme
 export { useTheme } from "./use-theme.js";
-// Provider (typically auto-included via NavigationProvider when theme is enabled)
 export { ThemeProvider } from "./ThemeProvider.js";
-// Script component for FOUC prevention (use in document head)
 export { ThemeScript, type ThemeScriptProps } from "./ThemeScript.js";
-// Types
 export type {
   Theme,
   ResolvedTheme,
@@ -44,5 +38,4 @@ export type {
   ThemeContextValue,
 } from "./types.js";
-// Constants
 export { THEME_DEFAULTS, THEME_COOKIE } from "./constants.js";

package/src/theme/theme-context.ts CHANGED Viewed

@@ -19,17 +19,13 @@ import type { ThemeContextValue } from "./types.js";
 export const ThemeContext: Context<ThemeContextValue | null> =
   createContext<ThemeContextValue | null>(null);
-/**
- * Get theme context (internal use)
- * Returns null if theme is not enabled
- */
 export function useThemeContext(): ThemeContextValue | null {
   return useContext(ThemeContext);
 }
 /**
  * Get theme context, throwing if not available
- * Use this in useTheme hook
+ * Used by useTheme hook
  */
 export function requireThemeContext(): ThemeContextValue {
   const ctx = useContext(ThemeContext);

package/src/theme/theme-script.ts CHANGED Viewed

@@ -11,6 +11,7 @@
  */
 import type { ResolvedThemeConfig } from "./types.js";
+import { escapeJsonForScript } from "../escape-script.js";
 /**
  * Generate the inline script for theme initialization
@@ -22,20 +23,17 @@ import type { ResolvedThemeConfig } from "./types.js";
  * - Handle all edge cases (no localStorage, no cookie, etc.)
  */
 export function generateThemeScript(config: ResolvedThemeConfig): string {
-  // Build the script as a string, then minify
   const script = `
 (function() {
-  var storageKey = ${JSON.stringify(config.storageKey)};
-  var defaultTheme = ${JSON.stringify(config.defaultTheme)};
-  var attribute = ${JSON.stringify(config.attribute)};
+  var storageKey = ${escapeJsonForScript(JSON.stringify(config.storageKey))};
+  var defaultTheme = ${escapeJsonForScript(JSON.stringify(config.defaultTheme))};
+  var attribute = ${escapeJsonForScript(JSON.stringify(config.attribute))};
   var enableSystem = ${config.enableSystem};
   var enableColorScheme = ${config.enableColorScheme};
-  var valueMap = ${JSON.stringify(config.value)};
-  var themes = ${JSON.stringify(config.themes)};
+  var valueMap = ${escapeJsonForScript(JSON.stringify(config.value))};
+  var themes = ${escapeJsonForScript(JSON.stringify(config.themes))};
-  // Read theme from cookie or localStorage
   function getStoredTheme() {
-    // Try cookie first (for SSR consistency)
     var cookies = document.cookie.split(';');
     for (var i = 0; i < cookies.length; i++) {
       var cookie = cookies[i].trim();
@@ -44,7 +42,6 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
         catch (e) { return cookie.substring(storageKey.length + 1); }
       }
     }
-    // Fall back to localStorage
     try {
       return localStorage.getItem(storageKey);
     } catch (e) {
@@ -52,7 +49,6 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
     }
   }
-  // Get system preference
   function getSystemTheme() {
     if (typeof window !== 'undefined' && window.matchMedia) {
       return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
@@ -60,7 +56,6 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
     return 'light';
   }
-  // Resolve "system" to actual theme
   function resolveTheme(theme) {
     if (theme === 'system' && enableSystem) {
       return getSystemTheme();
@@ -68,15 +63,12 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
     return theme;
   }
-  // Apply theme to HTML element
   function applyTheme(theme) {
     var resolved = resolveTheme(theme);
     var value = valueMap[resolved] || resolved;
     var el = document.documentElement;
-    // Apply attribute
     if (attribute === 'class') {
-      // Remove all theme classes, then add current
       for (var i = 0; i < themes.length; i++) {
         var v = valueMap[themes[i]] || themes[i];
         el.classList.remove(v);
@@ -86,23 +78,32 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
       el.setAttribute(attribute, value);
     }
-    // Set color-scheme for native dark mode support
     if (enableColorScheme) {
       el.style.colorScheme = resolved;
     }
   }
-  // Get stored theme or use default
   var stored = getStoredTheme();
-  var theme = stored && (stored === 'system' || themes.indexOf(stored) !== -1)
+  // A stored value is valid when it is a configured theme, OR "system" but only
+  // while system detection is enabled. A stored "system" with enableSystem=false
+  // (an old cookie/localStorage, or a value pushed cross-tab) must fall back to
+  // defaultTheme — otherwise resolveTheme returns "system" unresolved and
+  // applyTheme writes a bogus class="system" / colorScheme="system" on <html>.
+  // Same rule as isValidTheme (constants.ts), inlined since this is a string.
+  var systemAllowed = stored === 'system' && enableSystem;
+  var theme = stored && (systemAllowed || themes.indexOf(stored) !== -1)
     ? stored
     : defaultTheme;
-  // Apply immediately
   applyTheme(theme);
-  // Listen for system preference changes (for "system" theme)
-  if (enableSystem && typeof window !== 'undefined' && window.matchMedia) {
+  // Idempotency guard: MetaTags auto-injects this script when theme is enabled,
+  // and ThemeScript is also a public component for the same job. If a consumer
+  // renders both, the IIFE runs twice; without this guard the second run would
+  // register a SECOND, never-removed matchMedia('change') listener (a leak).
+  // The flag is keyed by storageKey so independent theme configs don't collide.
+  var flagKey = '__rangoThemeListener_' + storageKey;
+  if (enableSystem && typeof window !== 'undefined' && window.matchMedia && !window[flagKey]) {
     try {
       window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', function() {
         var current = getStoredTheme() || defaultTheme;
@@ -110,6 +111,7 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
           applyTheme('system');
         }
       });
+      window[flagKey] = true;
     } catch (e) {
       // Older browsers may not support addEventListener on MediaQueryList
     }
@@ -117,7 +119,6 @@ export function generateThemeScript(config: ResolvedThemeConfig): string {
 })();
 `;
-  // Minify by removing comments, extra whitespace, and newlines
   return minifyScript(script);
 }

package/src/theme/use-theme.ts CHANGED Viewed

@@ -27,9 +27,6 @@ import type { UseThemeReturn } from "./types.js";
  *
  * Must be used within a ThemeProvider (which is automatically included
  * in NavigationProvider when theme is enabled in router config).
- *
- * @returns Theme state and methods
- * @throws Error if used outside ThemeProvider
  */
 export function useTheme(): UseThemeReturn {
   const ctx = requireThemeContext();

package/src/types/boundaries.ts CHANGED Viewed

@@ -1,22 +1,12 @@
 import type { ReactNode } from "react";
-/**
- * Error information passed to error boundary fallback components
- */
 export interface ErrorInfo {
-  /** Error message (always available) */
   message: string;
-  /** Error name/type (e.g., "RouteNotFoundError", "MiddlewareError") */
   name: string;
-  /** Optional error code for programmatic handling */
   code?: string;
-  /** Stack trace (only in development) */
   stack?: string;
-  /** Original error cause if available */
   cause?: unknown;
-  /** Segment ID where the error occurred */
   segmentId: string;
-  /** Segment type where the error occurred */
   segmentType:
     | "layout"
     | "route"
@@ -46,13 +36,9 @@ export interface ErrorInfo {
  * ```
  */
 export interface ErrorBoundaryFallbackProps {
-  /** Error information */
   error: ErrorInfo;
 }
-/**
- * Error boundary handler - receives error info and returns fallback UI
- */
 export type ErrorBoundaryHandler = (
   props: ErrorBoundaryFallbackProps,
 ) => ReactNode;
@@ -77,17 +63,10 @@ export type ErrorBoundaryHandler = (
  * ```
  */
 export interface ClientErrorBoundaryFallbackProps {
-  /** Error information */
   error: ErrorInfo;
-  /** Function to reset error state and retry rendering */
   reset: () => void;
 }
-/**
- * Wrapped loader data result for deferred resolution with error handling.
- * When loaders are deferred to client-side resolution, errors need to be
- * wrapped so the client can handle them appropriately.
- */
 export type LoaderDataResult<T = unknown> =
   | { __loaderResult: true; ok: true; data: T }
   | {
@@ -95,11 +74,23 @@ export type LoaderDataResult<T = unknown> =
       ok: false;
       error: ErrorInfo;
       fallback: ReactNode | null;
+      /**
+       * Loader threw notFound() (DataNotFoundError). `fallback` carries the
+       * SERVER-RENDERED not-found UI (nearest notFoundBoundary → router
+       * notFound option → default), so the client swaps to 404 presentation
+       * with zero extra round trips. Routed by decodeLoaderEntry via
+       * LOADER_NOT_FOUND_FALLBACK, not the error-fallback marker.
+       */
+      notFound?: true;
+      /**
+       * Loader threw redirect(...) (a 3xx Response). `to` is resolved through
+       * the soft-redirect same-origin rules BEFORE leaving the server
+       * (resolveSoftRedirectUrl), so unsafe targets never reach the wire. The
+       * client navigates (replace) when the entry decodes.
+       */
+      redirect?: { to: string };
     };
-/**
- * Type guard to check if a value is a wrapped loader result
- */
 export function isLoaderDataResult(value: unknown): value is LoaderDataResult {
   return (
     typeof value === "object" &&
@@ -109,15 +100,9 @@ export function isLoaderDataResult(value: unknown): value is LoaderDataResult {
   );
 }
-/**
- * Not found information passed to notFound boundary fallback components
- */
 export interface NotFoundInfo {
-  /** Not found message */
   message: string;
-  /** Segment ID where notFound was thrown */
   segmentId: string;
-  /** Segment type where notFound was thrown */
   segmentType:
     | "layout"
     | "route"
@@ -125,7 +110,6 @@ export interface NotFoundInfo {
     | "loader"
     | "middleware"
     | "cache";
-  /** The pathname that triggered the not found */
   pathname?: string;
 }
@@ -146,13 +130,9 @@ export interface NotFoundInfo {
  * ```
  */
 export interface NotFoundBoundaryFallbackProps {
-  /** Not found information */
   notFound: NotFoundInfo;
 }
-/**
- * NotFound boundary handler - receives not found info and returns fallback UI
- */
 export type NotFoundBoundaryHandler = (
   props: NotFoundBoundaryFallbackProps,
 ) => ReactNode;

package/src/types/cache-types.ts CHANGED Viewed

@@ -78,6 +78,14 @@ export interface CacheOptions<TEnv = unknown> {
    * - Loader-specific caching strategies
    * - Hot data in fast cache, cold data in larger/slower cache
    *
+   * Tag invalidation caveat: a per-boundary store becomes reachable by
+   * `updateTag()` / `revalidateTag()` once this boundary is resolved in the
+   * current process. If the store is *durable* (shared across processes) and the
+   * very first request to a fresh worker is an `updateTag`/`revalidateTag` for a
+   * tag held only in this store - before this boundary is matched - that
+   * invalidation can miss it. For data you invalidate by tag, prefer the
+   * app-level store (always reachable), or ensure the boundary is warmed.
+   *
    * @example
    * ```typescript
    * const kvStore = new CloudflareKVStore(env.CACHE_KV);
@@ -145,10 +153,11 @@ export interface CacheOptions<TEnv = unknown> {
    * Tags for cache invalidation.
    * Can be a static array or a function that returns tags.
    *
-   * Note: Tags are passed through to the store but built-in stores
-   * (MemorySegmentCacheStore, CFCacheStore) do not yet index or
-   * invalidate by tag. Effective tag-based invalidation requires a
-   * custom store implementation with secondary indices.
+   * The built-in `MemorySegmentCacheStore` and `CFCacheStore` index by tag.
+   * Invalidate on demand with `updateTag(...tags)` (awaitable, read-your-own-writes;
+   * for server actions) or `revalidateTag(...tags)` (background hard-purge, not
+   * awaited; for route handlers / webhooks). For `CFCacheStore`, distributed
+   * invalidation requires a `kv` namespace (markers live in that same namespace).
    *
    * @example
    * ```typescript

package/src/types/error-types.ts CHANGED Viewed

@@ -14,19 +14,19 @@
  * - "unknown": Fallback for unclassified errors (not currently invoked)
  */
 export type ErrorPhase =
-  | "routing" // During route matching
-  | "manifest" // During manifest loading (reserved, not currently invoked)
-  | "middleware" // During middleware execution (errors propagate to handler phase)
-  | "loader" // During loader execution
-  | "handler" // During route/layout handler execution
-  | "rendering" // During RSC/SSR rendering (SSR handler uses separate callback)
-  | "action" // During server action execution
-  | "revalidation" // During revalidation evaluation
-  | "cache" // During "use cache" background operations (stale revalidation, async cache writes)
-  | "prerender" // During build-time pre-rendering (Vite closeBundle)
-  | "static" // During build-time static handler rendering (Vite closeBundle)
-  | "origin" // During cross-origin request validation (CSRF protection)
-  | "unknown"; // Fallback for unclassified errors
+  | "routing"
+  | "manifest"
+  | "middleware"
+  | "loader"
+  | "handler"
+  | "rendering"
+  | "action"
+  | "revalidation"
+  | "cache"
+  | "prerender"
+  | "static"
+  | "origin"
+  | "unknown";
 /**
  * Comprehensive context passed to onError callback
@@ -59,103 +59,43 @@ export type ErrorPhase =
  * ```
  */
 export interface OnErrorContext<TEnv = any> {
-  /**
-   * The error that occurred
-   */
   error: Error;
-  /**
-   * Phase where the error occurred
-   */
   phase: ErrorPhase;
-  /**
-   * The original request
-   */
   request: Request;
-  /**
-   * Parsed URL from the request
-   */
   url: URL;
-  /**
-   * Request pathname
-   */
   pathname: string;
-  /**
-   * HTTP method
-   */
   method: string;
-  /**
-   * Matched route key (if available)
-   * e.g., "shop.products.detail"
-   */
+  /** Matched route key (if available) e.g., "shop.products.detail" */
   routeKey?: string;
-  /**
-   * Route params (if available)
-   * e.g., { slug: "headphones" }
-   */
+  /** Route params (if available) e.g., { slug: "headphones" } */
   params?: Record<string, string>;
-  /**
-   * Segment ID where error occurred (if available)
-   * e.g., "M1L0" for a layout, "M1R0" for a route
-   */
+  /** Segment ID where error occurred (if available) e.g., "M1L0" for a layout, "M1R0" for a route */
   segmentId?: string;
-  /**
-   * Segment type where error occurred (if available)
-   */
+  /** Segment type where error occurred (if available) */
   segmentType?: "layout" | "route" | "parallel" | "loader" | "middleware";
-  /**
-   * Loader name (if error occurred in a loader)
-   */
+  /** Loader name (if error occurred in a loader) */
   loaderName?: string;
-  /**
-   * Middleware name/id (if error occurred in middleware)
-   */
+  /** Middleware name/id (if error occurred in middleware) */
   middlewareId?: string;
-  /**
-   * Action ID (if error occurred during server action)
-   * e.g., "src/actions.ts#addToCart"
-   */
+  /** Action ID (if error occurred during server action) e.g., "src/actions.ts#addToCart" */
   actionId?: string;
-  /**
-   * Environment/bindings (platform context)
-   */
+  /** Environment/bindings (platform context) */
   env?: TEnv;
-  /**
-   * Duration from request start to error (milliseconds)
-   */
+  /** Duration from request start to error (milliseconds) */
   duration?: number;
-  /**
-   * Whether this is a partial/navigation request
-   */
+  /** Whether this is a partial/navigation request */
   isPartial?: boolean;
-  /**
-   * Whether an error boundary caught the error
-   * If true, the error was handled and a fallback UI was rendered
-   */
+  /** Whether an error boundary caught the error */
   handledByBoundary?: boolean;
-  /**
-   * Stack trace (if available)
-   */
+  /** Stack trace (if available) */
   stack?: string;
   /**
-   * Additional metadata specific to the error phase
+   * Additional metadata specific to the error phase. For the `cache` phase,
+   * `metadata.category` is a `CacheErrorCategory` (exported from
+   * `@rangojs/router/cache`) identifying the failure kind, e.g. `cache-read`
+   * (transient outage, degraded to a miss) vs `cache-corrupt` (faulty entry
+   * self-healed) vs `cache-invalidate` (a failed background revalidateTag).
    */
   metadata?: Record<string, unknown>;
 }