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/skills/catalog.json ADDED Viewed

@@ -0,0 +1,283 @@
+{
+  "$schema-note": "Generated by tools/generate-skills-catalog.mjs — do not edit by hand.",
+  "package": "@rangojs/router",
+  "entry": "rango",
+  "skills": [
+    {
+      "name": "api-client",
+      "description": "Build a typed client for consuming your own response-route JSON APIs (no codegen). Use when calling your own JSON endpoints from another service or script, or you want typed fetch calls without a codegen step.",
+      "argumentHint": "",
+      "path": "skills/api-client/SKILL.md"
+    },
+    {
+      "name": "breadcrumbs",
+      "description": "Built-in Breadcrumbs handle for accumulating breadcrumb navigation across route segments. Use when building a breadcrumb trail for nested routes, or asking how to show the current navigation path in a layout.",
+      "argumentHint": "[setup]",
+      "path": "skills/breadcrumbs/SKILL.md"
+    },
+    {
+      "name": "bundle-analysis",
+      "description": "Audit a Rango app's production bundle for server-side code leaking into the client, dev/prod React duplication, oversized chunks, and inefficient client-reference grouping. Use when investigating bundle size growth, before a production deploy, or when the client/SSR/RSC output suddenly balloons.",
+      "argumentHint": "<app-dir>",
+      "path": "skills/bundle-analysis/SKILL.md"
+    },
+    {
+      "name": "cache-guide",
+      "description": "When to use cache() DSL vs \"use cache\" directive — key differences and decision guide. Use when unsure which caching mechanism fits a given problem, comparing route/segment caching, function-level caching, and document-level caching, or asking \"which cache API should I use\".",
+      "argumentHint": "",
+      "path": "skills/cache-guide/SKILL.md"
+    },
+    {
+      "name": "caching",
+      "description": "Configure route/segment-subtree caching with memory, Cloudflare KV, or Vercel cache stores in @rangojs/router. Use when responses should be cached or revalidated, data is stale or not updating after code changes, or you are wiring up a cache store.",
+      "argumentHint": "[setup]",
+      "path": "skills/caching/SKILL.md"
+    },
+    {
+      "name": "cloudflare",
+      "description": "Deploy and operate @rangojs/router on Cloudflare Workers with the Cloudflare Vite plugin, typed D1/KV bindings, local migrations, secrets, streaming, preview parity, and built-worker deployment. Use when creating a Cloudflare Rango app, moving a Rango app to Workers, wiring D1 or KV, debugging dev/preview differences, or preparing a Worker deployment.",
+      "argumentHint": "",
+      "path": "skills/cloudflare/SKILL.md"
+    },
+    {
+      "name": "comparison",
+      "description": "Compare Rango with Next.js App Router, TanStack Start, and Waku. Use when evaluating React frameworks, explaining why Rango, writing positioning or adoption guidance, answering migration questions, or checking claims about Rango's routing, loaders, caching, rendering, prefetching, safety, testing, observability, and production behavior.",
+      "argumentHint": "",
+      "path": "skills/comparison/SKILL.md"
+    },
+    {
+      "name": "composability",
+      "description": "Reusable composition patterns with globally importable route helpers in @rangojs/router. Use when sharing loaders, middleware, or handler logic across multiple route files, or avoiding copy-pasting the same route setup everywhere.",
+      "argumentHint": "pattern-name",
+      "path": "skills/composability/SKILL.md"
+    },
+    {
+      "name": "css",
+      "description": "Import and apply CSS in a Rango app. Render document/app stylesheets in the Document `<head>` with Vite's `?url` import plus a `precedence`-managed `<link rel=\"stylesheet\">` (React 19 resource model — deduped, ordered, loaded before paint). Use when wiring global/app CSS or a Document `<head>` stylesheet, or when deciding between `?url` + `<link>` and side-effect imports. Cross-app (host-router) navigation is a full document load, so each app's document CSS is always re-established by its own load.",
+      "argumentHint": "",
+      "path": "skills/css/SKILL.md"
+    },
+    {
+      "name": "debug-manifest",
+      "description": "Debug and inspect route manifest structure. Use when routes aren't matching as expected, you need to see the generated route tree, or a path resolves to the wrong handler.",
+      "argumentHint": "",
+      "path": "skills/debug-manifest/SKILL.md"
+    },
+    {
+      "name": "defer-hydration",
+      "description": "Keep the full body HTML in a PPR shell's first paint while moving a heavy subtree's hydration off the initial main-thread task — a gated Suspense boundary with the content as its own fallback, released on first idle. Use when a shell HIT paints fast but one long hydration task blocks the main thread, TTI/INP is poor despite instant paint, or a plain Suspense boundary left an empty hole in the frozen prelude.",
+      "argumentHint": "",
+      "path": "skills/defer-hydration/SKILL.md"
+    },
+    {
+      "name": "deployment-caching",
+      "description": "Choose the deployment cache boundary for a Rango app: in-function segment/prerender/PPR caches, store-backed whole-response caching, or an external CDN cache. Use when comparing Cloudflare, Vercel, and Node deployments; deciding whether Cache-Control can reduce origin work; or reasoning about middleware, live loaders, PPR, and CDN behavior.",
+      "argumentHint": "[cloudflare|vercel|node]",
+      "path": "skills/deployment-caching/SKILL.md"
+    },
+    {
+      "name": "document-cache",
+      "description": "Cache complete HTTP responses in Rango's configured app store with createDocumentCacheMiddleware, using Cache-Control s-maxage as policy. Use when reusing a whole HTML/RSC response, comparing the store-backed middleware with a platform CDN cache, or deciding whether full-response caching is safe.",
+      "argumentHint": "[setup]",
+      "path": "skills/document-cache/SKILL.md"
+    },
+    {
+      "name": "fonts",
+      "description": "Load and configure web fonts with preload hints for optimal performance. Use when adding a custom font to a Rango app, fonts flash or swap on load (FOUT/FOIT), or you want font preload for performance.",
+      "argumentHint": "[provider]",
+      "path": "skills/fonts/SKILL.md"
+    },
+    {
+      "name": "handler-use",
+      "description": "Attach default loaders, middleware, parallels, and other use items directly to handlers via handler.use, and compose them with explicit use() at mount sites. Use when a handler needs its own default middleware/loader without repeating use() at every mount site, or deciding between handler-level defaults and per-route use().",
+      "argumentHint": "[handler]",
+      "path": "skills/handler-use/SKILL.md"
+    },
+    {
+      "name": "hooks",
+      "description": "Client-side React hooks for navigation, loaders, and state in @rangojs/router. Use when a client component needs the current URL, params, search params, navigation state, or loader data — e.g. \"how do I read the route param in a component\".",
+      "argumentHint": "[hook-name]",
+      "path": "skills/hooks/SKILL.md"
+    },
+    {
+      "name": "host-router",
+      "description": "Multi-app host routing with domain/subdomain patterns. Use when running multiple apps behind one domain or across subdomains, or routing requests to different apps based on hostname.",
+      "argumentHint": "",
+      "path": "skills/host-router/SKILL.md"
+    },
+    {
+      "name": "i18n",
+      "description": "Locale-aware routing with `include(\"/:locale?\", ...)`, locale resolution chains, and react-intl integration. Use when building a multi-language app, routes need a locale segment, or wiring up react-intl translations.",
+      "argumentHint": "[topic]",
+      "path": "skills/i18n/SKILL.md"
+    },
+    {
+      "name": "intercept",
+      "description": "Define intercept routes for modals, slide-overs, and soft navigation patterns in @rangojs/router. Use when opening a route as a modal/overlay on top of the current page while keeping the URL shareable, or asking \"how do I show this page in a modal\".",
+      "argumentHint": "[@slot-name] [route-to-intercept]",
+      "path": "skills/intercept/SKILL.md"
+    },
+    {
+      "name": "layout",
+      "description": "Define layout routes that wrap child routes in @rangojs/router. Use when sharing a persistent UI shell (nav, sidebar) across nested routes, or asking how to wrap child pages with a common layout.",
+      "argumentHint": "[component]",
+      "path": "skills/layout/SKILL.md"
+    },
+    {
+      "name": "links",
+      "description": "URL generation with ctx.reverse (server default), href (client), useHref (mounted), useMount, useReverse, and scopedReverse. Use when generating a link to a route by name instead of hardcoding a path, or a link breaks after routes move or get mounted elsewhere.",
+      "argumentHint": "[ctx.reverse|href|useHref|useMount|useReverse|scopedReverse]",
+      "path": "skills/links/SKILL.md"
+    },
+    {
+      "name": "loader",
+      "description": "Define data loaders for fetching data in routes with createLoader. Use when pages need per-request data that stays fresh, data should stream while the page renders, or client components need reactive server data.",
+      "argumentHint": "[loader]",
+      "path": "skills/loader/SKILL.md"
+    },
+    {
+      "name": "middleware",
+      "description": "Define middleware for authentication, logging, and request processing in @rangojs/router. Use when gating routes behind auth checks, logging requests, or running shared logic before a handler runs.",
+      "argumentHint": "[middleware-name]",
+      "path": "skills/middleware/SKILL.md"
+    },
+    {
+      "name": "migrate-nextjs",
+      "description": "Migrate a Next.js App Router project to @rangojs/router. Use when the user asks to \"migrate from Next.js\", \"convert Next.js to Rango\", \"replace Next.js\", or has a Next.js app they want to port.",
+      "argumentHint": "[path-to-nextjs-app]",
+      "path": "skills/migrate-nextjs/SKILL.md"
+    },
+    {
+      "name": "migrate-react-router",
+      "description": "Migrate a React Router v7/v6 project to @rangojs/router. Use when the user asks to \"migrate from React Router\", \"convert React Router to Rango\", \"replace React Router\", \"move from Remix to Rango\", or has a React Router / Remix app they want to port.",
+      "argumentHint": "path-to-react-router-app",
+      "path": "skills/migrate-react-router/SKILL.md"
+    },
+    {
+      "name": "mime-routes",
+      "description": "Content negotiation — serve different response types (RSC, JSON, text, XML) from the same URL based on Accept header. Use when the same URL needs to return JSON for API clients and HTML/RSC for browsers, or branching a handler on the Accept header.",
+      "argumentHint": "[negotiate|vary|accept]",
+      "path": "skills/mime-routes/SKILL.md"
+    },
+    {
+      "name": "observability",
+      "description": "Debug Rango request performance with debugPerformance, Server-Timing, structured telemetry, and tracing. Use when a request feels slow and you need to see where time is spent, or wiring up tracing/telemetry for production requests.",
+      "argumentHint": "",
+      "path": "skills/observability/SKILL.md"
+    },
+    {
+      "name": "parallel",
+      "description": "Define parallel routes for multi-column layouts, sidebars, and modal slots in @rangojs/router. Use when a layout needs multiple independently-loading regions (e.g. a sidebar and main panel), or rendering more than one route segment at the same URL.",
+      "argumentHint": "[@slot-name]",
+      "path": "skills/parallel/SKILL.md"
+    },
+    {
+      "name": "ppr",
+      "description": "PPR shell caching — opt a page route in with the `ppr` path option; the router serves the cached HTML shell instantly and resumes the live holes. Use when a page should render instantly from a cached shell while specific parts stay live, or asking about partial prerendering in Rango.",
+      "argumentHint": "[setup]",
+      "path": "skills/ppr/SKILL.md"
+    },
+    {
+      "name": "prerender",
+      "description": "Pre-render route segments at build time with Prerender and Passthrough live fallback. Use when a page's content is mostly static and shouldn't render on every request, speeding up cold responses, or deciding which routes to prerender vs render live.",
+      "argumentHint": "[passthrough]",
+      "path": "skills/prerender/SKILL.md"
+    },
+    {
+      "name": "rango",
+      "description": "Overview of @rangojs/router and available skills. Use when unsure which skill to reach for, starting a new task in a Rango app, or asking \"what can this router do\".",
+      "argumentHint": "",
+      "path": "skills/rango/SKILL.md"
+    },
+    {
+      "name": "react-compiler",
+      "description": "Enable the React Compiler in a Rango app the @vitejs/plugin-rsc way — a separate @rolldown/plugin-babel running reactCompilerPreset(), ordered after react() and before the plugin that supplies @vitejs/plugin-rsc. Use when a consumer wants to turn React Compiler on, hits the dead plugin-react v6 `react({ babel })` path, or is unsure why server components aren't being compiled.",
+      "argumentHint": "",
+      "path": "skills/react-compiler/SKILL.md"
+    },
+    {
+      "name": "response-routes",
+      "description": "Response routes (path.json, path.text, etc.) for non-RSC endpoints with typed responses. Use when building a JSON/text API endpoint alongside your pages, or asking how to return raw JSON instead of RSC from a route.",
+      "argumentHint": "[json|text|html|xml|md|image|stream]",
+      "path": "skills/response-routes/SKILL.md"
+    },
+    {
+      "name": "route",
+      "description": "Define routes with path() in @rangojs/router. Use when creating a new page or route, or asking how to define a URL path and its handler.",
+      "argumentHint": "[pattern]",
+      "path": "skills/route/SKILL.md"
+    },
+    {
+      "name": "router-setup",
+      "description": "Create and configure the RSC router with createRouter. Use when bootstrapping a new Rango app, or configuring top-level router options like base path, cache store, or environment.",
+      "argumentHint": "[option]",
+      "path": "skills/router-setup/SKILL.md"
+    },
+    {
+      "name": "scripts",
+      "description": "Inject third-party scripts (GTM, analytics, widgets) into the document head/body via the Script handle. Use when adding Google Tag Manager, an analytics snippet, or a third-party widget script to the page.",
+      "argumentHint": "[vendor]",
+      "path": "skills/scripts/SKILL.md"
+    },
+    {
+      "name": "server-actions",
+      "description": "Define and call server actions (`\"use server\"`) — forms, useActionState, useOptimistic, validation, error handling, redirects, revalidation. Use when handling a form submission on the server, calling a server function from a client component, or needing optimistic UI after a mutation.",
+      "argumentHint": "[action]",
+      "path": "skills/server-actions/SKILL.md"
+    },
+    {
+      "name": "shell-manifest",
+      "description": "Shell manifest pattern — replayed handles as cache metadata that live loaders read, e.g. a prerendered product list with batched live prices. Use when a cached/prerendered shell needs to feed IDs or metadata to a live loader for freshly-fetched data.",
+      "argumentHint": "",
+      "path": "skills/shell-manifest/SKILL.md"
+    },
+    {
+      "name": "streams-and-websockets",
+      "description": "Long-lived Response handlers — Server-Sent Events (SSE) via path.stream and WebSocket upgrades via path.any on Cloudflare Workers, including middleware interaction and runtime caveats. Use when streaming live updates to the browser, or opening a WebSocket connection from a route on Cloudflare Workers.",
+      "argumentHint": "[sse | websocket | agents]",
+      "path": "skills/streams-and-websockets/SKILL.md"
+    },
+    {
+      "name": "tailwind",
+      "description": "Set up Tailwind CSS v4 with the Document component and CSS imports. Use when adding Tailwind CSS to a Rango app, or Tailwind classes aren't being applied or generated.",
+      "argumentHint": "[setup]",
+      "path": "skills/tailwind/SKILL.md"
+    },
+    {
+      "name": "testing",
+      "description": "Test @rangojs/router apps — unit (loaders/middleware/reverse/components), integration (dispatch/Flight), and e2e (dev+prod parity, progressive enhancement). Use when writing a unit test for a loader or middleware, or asking how to test a route end-to-end in dev and production.",
+      "argumentHint": "[layer]",
+      "path": "skills/testing/SKILL.md"
+    },
+    {
+      "name": "theme",
+      "description": "Opt-in theme system with FOUC prevention for light/dark mode. Use when adding a light/dark mode toggle, or the page flashes the wrong theme on load (FOUC).",
+      "argumentHint": "[setup]",
+      "path": "skills/theme/SKILL.md"
+    },
+    {
+      "name": "typesafety",
+      "description": "Set up type-safe routes, params, and environment types in @rangojs/router. Use when route or search params aren't typed, TypeScript can't infer a loader's return type, or wiring up typed environment bindings.",
+      "argumentHint": "[setup]",
+      "path": "skills/typesafety/SKILL.md"
+    },
+    {
+      "name": "use-cache",
+      "description": "Function-level caching with the \"use cache\" directive for RSC data functions and components in @rangojs/router. Use when a single function or component should memoize its own output, not a whole route/segment subtree or HTTP response.",
+      "argumentHint": "[profile-name]",
+      "path": "skills/use-cache/SKILL.md"
+    },
+    {
+      "name": "vercel",
+      "description": "Deploy a Rango app to Vercel Functions (Build Output API v3). Use when deploying a Rango app to Vercel, or asking how the router works with Vercel Functions and the Build Output API.",
+      "argumentHint": "",
+      "path": "skills/vercel/SKILL.md"
+    },
+    {
+      "name": "view-transitions",
+      "description": "Configure React View Transitions on layouts, routes, and parallel slots in @rangojs/router. Use when navigation should animate smoothly between pages, or wiring up React View Transitions on a route or layout.",
+      "argumentHint": "[layout|route|parallel|intercept]",
+      "path": "skills/view-transitions/SKILL.md"
+    }
+  ]
+}

package/skills/cloudflare/SKILL.md ADDED Viewed

@@ -0,0 +1,151 @@
+---
+name: cloudflare
+description: Deploy and operate @rangojs/router on Cloudflare Workers with the Cloudflare Vite plugin, typed D1/KV bindings, local migrations, secrets, streaming, preview parity, and built-worker deployment. Use when creating a Cloudflare Rango app, moving a Rango app to Workers, wiring D1 or KV, debugging dev/preview differences, or preparing a Worker deployment.
+---
+# Cloudflare Workers deployment
+Use the Cloudflare Vite plugin as the runtime bridge. It runs the real Worker
+entry in workerd during `vite dev` and `vite preview`, supplies bindings, and
+emits the deployable Worker configuration during `vite build`.
+## Install and configure
+```bash
+pnpm add @rangojs/router react react-dom
+pnpm add -D vite @vitejs/plugin-react @cloudflare/vite-plugin \
+  @cloudflare/workers-types wrangler typescript
+```
+Keep plugin order stable: React first, then Rango, then Cloudflare.
+```typescript
+// vite.config.ts
+import { cloudflare } from "@cloudflare/vite-plugin";
+import react from "@vitejs/plugin-react";
+import { rango } from "@rangojs/router/vite";
+import { defineConfig } from "vite";
+export default defineConfig({
+  plugins: [
+    react(),
+    rango({ preset: "cloudflare", buildEnv: "auto" }),
+    cloudflare({
+      configPath: "./wrangler.json",
+      viteEnvironment: { name: "rsc", childEnvironments: ["ssr"] },
+    }),
+  ],
+});
+```
+`buildEnv: "auto"` exposes build-safe bindings to static/prerender collection.
+Omit it when build rendering must not access bindings.
+```json
+{
+  "name": "my-rango-app",
+  "compatibility_date": "2025-10-01",
+  "compatibility_flags": ["nodejs_compat", "nodejs_als"],
+  "main": "./src/worker.rsc.tsx",
+  "assets": { "directory": "./dist/client" }
+}
+```
+## Type bindings once
+```typescript
+// src/env.ts
+/// <reference types="@cloudflare/workers-types" />
+export interface AppBindings {
+  DB: D1Database;
+  CACHE_KV: KVNamespace;
+}
+declare global {
+  namespace Rango {
+    interface Env extends AppBindings {}
+  }
+}
+```
+Rango's runtime entries stay as TypeScript source for Vite to bundle, while its
+package `types` conditions point to emitted declarations. A Workers-only app
+does not need `@types/node` just to type-check Rango:
+```json
+{
+  "compilerOptions": {
+    "types": ["@cloudflare/workers-types", "vite/client"]
+  }
+}
+```
+## Preserve the response stream
+```typescript
+// src/worker.rsc.tsx
+/// <reference types="@cloudflare/workers-types" />
+import { router } from "./router.js";
+import type { AppBindings } from "./env.js";
+export default {
+  fetch(request, env, ctx) {
+    return router.fetch(request, { env, ctx });
+  },
+} satisfies ExportedHandler<AppBindings>;
+```
+Do not call `response.text()` or `response.arrayBuffer()` on the Rango response
+in a custom Worker entry. That drains RSC/SSR streaming. Rewrap
+`new Response(response.body, response)` when only headers must change.
+## Choose the next reference
+- D1/KV setup, local migrations, `.dev.vars`, and parity tests: read
+  [references/d1-and-local-dev.md](references/d1-and-local-dev.md).
+- Streaming diagnostics, preview behavior, CORS, and deploy output: read
+  [references/streaming-and-deploy.md](references/streaming-and-deploy.md).
+- Raw-body webhooks, WebCrypto, and Stripe-on-Workers notes: read
+  [references/webhooks-and-crypto.md](references/webhooks-and-crypto.md).
+## Cache on Workers
+Use the Cache API as L1 and KV as optional cross-colo L2:
+```typescript
+import { CFCacheStore } from "@rangojs/router/cache";
+export const router = createRouter<AppBindings>({
+  document: Document,
+  urls: urlpatterns,
+  cache: (env, ctx) => ({
+    store: new CFCacheStore({
+      ctx,
+      kv: env.CACHE_KV,
+      defaults: { ttl: 60, swr: 300 },
+    }),
+  }),
+});
+```
+PPR shells use Cache API as the per-colo L1 and KV as the durable cross-colo
+L2; a KV hit promotes the coupled shell envelope back into L1. KV remains
+required for this family. `CFCacheStore` without `kv` can still cache
+segment/response entries in Cache API, but its shell family is inert.
+## Commands
+```jsonc
+{
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "deploy": "wrangler deploy -c dist/rsc/wrangler.json",
+  },
+}
+```
+Use `vite dev` and `vite preview` for local RSC work. Reserve Wrangler for
+resource provisioning, migrations, secrets, and deployment.

package/skills/cloudflare/agents/openai.yaml ADDED Viewed

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Cloudflare deployment"
+  short_description: "Deploy Rango on Cloudflare Workers with D1 and KV"
+  default_prompt: "Use $cloudflare to configure and deploy a Rango app on Cloudflare Workers with typed bindings."

package/skills/cloudflare/references/d1-and-local-dev.md ADDED Viewed

@@ -0,0 +1,131 @@
+# D1, KV, and local parity
+## Contents
+- [Provision bindings](#provision-bindings)
+- [Apply D1 migrations](#apply-d1-migrations)
+- [Use bindings](#use-bindings)
+- [Load local secrets](#load-local-secrets)
+- [Test dev and production-shaped preview](#test-dev-and-production-shaped-preview)
+## Provision bindings
+Create real resource IDs before the first deploy:
+```bash
+pnpm exec wrangler d1 create my-app
+pnpm exec wrangler kv namespace create CACHE_KV
+```
+Copy the returned IDs into `wrangler.json`:
+```json
+{
+  "d1_databases": [
+    {
+      "binding": "DB",
+      "database_name": "my-app",
+      "database_id": "<d1-id>",
+      "migrations_dir": "migrations"
+    }
+  ],
+  "kv_namespaces": [{ "binding": "CACHE_KV", "id": "<kv-id>" }]
+}
+```
+Do not deploy placeholder IDs. Keep binding names identical in `wrangler.json`
+and `AppBindings`; `ctx.env.DB` is the configured binding, not a global.
+## Apply D1 migrations
+```bash
+# Generate SQL with your migration tool first, then:
+pnpm exec wrangler d1 migrations apply my-app --local
+pnpm exec wrangler d1 migrations apply my-app --remote
+```
+The Cloudflare Vite plugin and `wrangler d1 ... --local` use the same local
+Miniflare persistence for the project. A migration applied through the CLI is
+therefore visible to both `vite dev` and `vite preview`; treat the internal
+`.wrangler/state` layout as an implementation detail.
+Add a real handler probe while setting up the binding, then remove it after the
+first production-shaped test:
+```typescript
+path.json("/__db-check", async (ctx) => {
+  const row = await ctx.env.DB.prepare(
+    "SELECT COUNT(*) AS n FROM users",
+  ).first<{
+    n: number;
+  }>();
+  return { ok: true, users: row?.n ?? 0 };
+});
+```
+## Use bindings
+Handlers, loaders, and middleware all receive the same typed bindings:
+```typescript
+export const UserLoader = createLoader(async (ctx) =>
+  ctx.env.DB.prepare("SELECT * FROM users WHERE id = ?")
+    .bind(ctx.params.id)
+    .first(),
+);
+export const requireSession: Middleware = async (ctx, next) => {
+  const token = cookies().get("session")?.value;
+  const session = token
+    ? await ctx.env.DB.prepare("SELECT * FROM sessions WHERE token = ?")
+        .bind(token)
+        .first()
+    : null;
+  if (!session) return redirect("/login");
+  return next();
+};
+```
+D1 has no Postgres RLS. Moving from an RLS-backed database requires an
+authorization-aware data-access layer that checks actor/tenant membership as
+part of every query. Do not translate SQL tables while silently dropping RLS.
+## Load local secrets
+Keep `.dev.vars` out of git and commit `.dev.vars.example` with names only:
+```dotenv
+SESSION_SECRET=
+STRIPE_WEBHOOK_SECRET=
+```
+Loading differs by command:
+| Command        | Source                                                      |
+| -------------- | ----------------------------------------------------------- |
+| `vite dev`     | live project `.dev.vars`                                    |
+| `vite preview` | `dist/<environment>/.dev.vars` copied during the last build |
+| `wrangler dev` | project `.dev.vars`                                         |
+Rebuild after changing `.dev.vars` before testing preview. Use
+`wrangler secret put NAME` for production secrets; `.dev.vars` is local only.
+Keep behavior-forcing e2e flags separate from a developer's default local
+profile. A copied `.dev.vars.example` that enables every production gate makes
+the documented "easy local dev" mode false.
+## Test dev and production-shaped preview
+Run the same behavior suite twice:
+1. `vite dev` against the source/module-runner path.
+2. `vite build`, then `vite preview` against the bundled Worker in workerd.
+Seed external-provider state offline where possible. For example, sign a test
+webhook with a fixed local webhook secret and assert the real D1 effect instead
+of provisioning a live payment account.
+When Playwright manages the servers, run dev and preview sequentially if they
+share the build directory or local D1 state. Set `inspectorPort: false` in the
+Cloudflare plugin for automated runs that do not use the debugger, or assign
+explicit distinct ports.