npm - @rangojs/router - Versions diffs - 0.0.0-experimental.ce770c9a → 0.0.0-experimental.d5d3070a - Mend

@rangojs/router 0.0.0-experimental.ce770c9a → 0.0.0-experimental.d5d3070a

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 (1202) hide show

package/AGENTS.md +8 -0
package/README.md +245 -49
package/dist/bin/rango.js +433 -131
package/dist/testing/vitest.js +82 -0
package/dist/vite/index.js +3376 -1102
package/dist/vite/plugins/cloudflare-protocol-loader-hook.mjs +76 -0
package/package.json +66 -12
package/skills/api-client/SKILL.md +211 -0
package/skills/breadcrumbs/SKILL.md +64 -2
package/skills/bundle-analysis/SKILL.md +159 -0
package/skills/cache-guide/SKILL.md +247 -23
package/skills/caching/SKILL.md +281 -11
package/skills/composability/SKILL.md +27 -2
package/skills/css/SKILL.md +76 -0
package/skills/debug-manifest/SKILL.md +4 -2
package/skills/document-cache/SKILL.md +78 -55
package/skills/handler-use/SKILL.md +364 -0
package/skills/hooks/SKILL.md +250 -30
package/skills/host-router/SKILL.md +83 -23
package/skills/i18n/SKILL.md +276 -0
package/skills/intercept/SKILL.md +50 -6
package/skills/layout/SKILL.md +35 -9
package/skills/links/SKILL.md +249 -17
package/skills/loader/SKILL.md +279 -53
package/skills/middleware/SKILL.md +52 -13
package/skills/migrate-nextjs/SKILL.md +584 -0
package/skills/migrate-react-router/SKILL.md +771 -0
package/skills/mime-routes/SKILL.md +28 -1
package/skills/observability/SKILL.md +172 -0
package/skills/parallel/SKILL.md +144 -7
package/skills/prerender/SKILL.md +153 -109
package/skills/rango/SKILL.md +251 -22
package/skills/react-compiler/SKILL.md +168 -0
package/skills/response-routes/SKILL.md +123 -48
package/skills/route/SKILL.md +101 -5
package/skills/router-setup/SKILL.md +116 -8
package/skills/scripts/SKILL.md +179 -0
package/skills/server-actions/SKILL.md +775 -0
package/skills/streams-and-websockets/SKILL.md +283 -0
package/skills/tailwind/SKILL.md +27 -3
package/skills/testing/SKILL.md +129 -0
package/skills/testing/bindings.md +103 -0
package/skills/testing/cache-prerender.md +127 -0
package/skills/testing/client-components.md +124 -0
package/skills/testing/e2e-parity.md +125 -0
package/skills/testing/flight.md +91 -0
package/skills/testing/handles.md +129 -0
package/skills/testing/loader.md +128 -0
package/skills/testing/middleware.md +99 -0
package/skills/testing/render-handler.md +121 -0
package/skills/testing/response-routes.md +95 -0
package/skills/testing/reverse-and-types.md +84 -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/typesafety/SKILL.md +332 -29
package/skills/use-cache/SKILL.md +46 -14
package/skills/view-transitions/SKILL.md +294 -0
package/src/__augment-tests__/augment.ts +81 -0
package/src/__augment-tests__/augmented.check.ts +116 -0
package/src/__internal.ts +1 -66
package/src/browser/action-coordinator.ts +53 -36
package/src/browser/action-fence.ts +47 -0
package/src/browser/app-shell.ts +39 -0
package/src/browser/app-version.ts +14 -0
package/src/browser/connection-warmup.ts +134 -0
package/src/browser/cookie-name.ts +140 -0
package/src/browser/event-controller.ts +192 -150
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/navigation-bridge.ts +108 -21
package/src/browser/navigation-client.ts +187 -86
package/src/browser/navigation-store-handle.ts +38 -0
package/src/browser/navigation-store.ts +76 -67
package/src/browser/navigation-transaction.ts +9 -59
package/src/browser/network-error-handler.ts +34 -7
package/src/browser/partial-update.ts +150 -107
package/src/browser/prefetch/cache.ts +205 -62
package/src/browser/prefetch/fetch.ts +329 -39
package/src/browser/prefetch/queue.ts +95 -29
package/src/browser/prefetch/resource-ready.ts +77 -0
package/src/browser/rango-state.ts +158 -76
package/src/browser/react/Link.tsx +102 -15
package/src/browser/react/NavigationProvider.tsx +193 -120
package/src/browser/react/ScrollRestoration.tsx +10 -6
package/src/browser/react/context.ts +7 -2
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 +23 -69
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 +32 -7
package/src/browser/react/use-params.ts +20 -10
package/src/browser/react/use-reverse.ts +106 -0
package/src/browser/react/use-router.ts +46 -11
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 +80 -5
package/src/browser/rsc-router.tsx +114 -24
package/src/browser/scroll-restoration.ts +37 -22
package/src/browser/segment-reconciler.ts +36 -14
package/src/browser/segment-structure-assert.ts +2 -2
package/src/browser/server-action-bridge.ts +222 -61
package/src/browser/types.ts +82 -11
package/src/browser/validate-redirect-origin.ts +43 -16
package/src/build/collect-fallback-refs.ts +107 -0
package/src/build/generate-manifest.ts +65 -40
package/src/build/generate-route-types.ts +5 -1
package/src/build/index.ts +8 -2
package/src/build/prefix-tree-utils.ts +123 -0
package/src/build/route-trie.ts +165 -36
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 +125 -24
package/src/build/route-types/param-extraction.ts +6 -3
package/src/build/route-types/per-module-writer.ts +22 -6
package/src/build/route-types/router-processing.ts +260 -94
package/src/build/route-types/scan-filter.ts +9 -2
package/src/build/route-types/source-scan.ts +216 -0
package/src/build/runtime-discovery.ts +9 -20
package/src/cache/cache-error.ts +104 -0
package/src/cache/cache-key-utils.ts +29 -13
package/src/cache/cache-policy.ts +108 -34
package/src/cache/cache-runtime.ts +214 -48
package/src/cache/cache-scope.ts +234 -87
package/src/cache/cache-tag.ts +103 -0
package/src/cache/cf/cf-base64.ts +33 -0
package/src/cache/cf/cf-cache-constants.ts +127 -0
package/src/cache/cf/cf-cache-store.ts +1989 -378
package/src/cache/cf/cf-cache-types.ts +349 -0
package/src/cache/cf/cf-kv-utils.ts +46 -0
package/src/cache/cf/cf-tag-marker-memo.ts +105 -0
package/src/cache/cf/index.ts +6 -16
package/src/cache/document-cache.ts +72 -20
package/src/cache/handle-snapshot.ts +70 -0
package/src/cache/index.ts +10 -20
package/src/cache/memory-segment-store.ts +136 -37
package/src/cache/profile-registry.ts +31 -31
package/src/cache/read-through-swr.ts +41 -11
package/src/cache/segment-codec.ts +9 -17
package/src/cache/tag-invalidation.ts +230 -0
package/src/cache/taint.ts +55 -0
package/src/cache/types.ts +37 -100
package/src/client.rsc.tsx +44 -21
package/src/client.tsx +119 -290
package/src/cloudflare/index.ts +11 -0
package/src/cloudflare/tracing.ts +109 -0
package/src/component-utils.ts +19 -0
package/src/components/DefaultDocument.tsx +8 -2
package/src/context-var.ts +84 -2
package/src/decode-loader-results.ts +52 -0
package/src/defer.ts +196 -0
package/src/deps/ssr.ts +0 -1
package/src/encode-kv.ts +49 -0
package/src/errors.ts +30 -4
package/src/escape-script.ts +52 -0
package/src/handle.ts +70 -22
package/src/handles/MetaTags.tsx +62 -19
package/src/handles/Scripts.tsx +183 -0
package/src/handles/breadcrumbs.ts +37 -8
package/src/handles/is-thenable.ts +19 -0
package/src/handles/meta.ts +51 -40
package/src/handles/script.ts +244 -0
package/src/host/cookie-handler.ts +9 -60
package/src/host/errors.ts +0 -24
package/src/host/index.ts +8 -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 +93 -12
package/src/index.ts +133 -15
package/src/internal-debug.ts +11 -10
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 +1 -1
package/src/outlet-provider.tsx +1 -5
package/src/prerender/param-hash.ts +16 -16
package/src/prerender/store.ts +37 -41
package/src/prerender.ts +198 -82
package/src/redirect-origin.ts +100 -0
package/src/regex-escape.ts +8 -0
package/src/render-error-thrower.tsx +20 -0
package/src/response-utils.ts +62 -0
package/src/reverse.ts +65 -15
package/src/root-error-boundary.tsx +1 -19
package/src/route-content-wrapper.tsx +7 -72
package/src/route-definition/dsl-helpers.ts +445 -277
package/src/route-definition/helper-factories.ts +29 -139
package/src/route-definition/helpers-types.ts +113 -37
package/src/route-definition/index.ts +3 -0
package/src/route-definition/redirect.ts +51 -10
package/src/route-definition/resolve-handler-use.ts +161 -0
package/src/route-definition/use-item-types.ts +32 -0
package/src/route-map-builder.ts +0 -16
package/src/route-types.ts +37 -41
package/src/router/basename.ts +14 -0
package/src/router/content-negotiation.ts +164 -17
package/src/router/error-handling.ts +45 -18
package/src/router/find-match.ts +44 -23
package/src/router/handler-context.ts +83 -39
package/src/router/instrument.ts +350 -0
package/src/router/intercept-resolution.ts +48 -24
package/src/router/lazy-includes.ts +15 -52
package/src/router/loader-resolution.ts +274 -56
package/src/router/logging.ts +0 -6
package/src/router/manifest.ts +40 -42
package/src/router/match-api.ts +120 -204
package/src/router/match-context.ts +0 -22
package/src/router/match-handlers.ts +58 -58
package/src/router/match-middleware/background-revalidation.ts +15 -5
package/src/router/match-middleware/cache-lookup.ts +202 -268
package/src/router/match-middleware/cache-store.ts +42 -28
package/src/router/match-middleware/intercept-resolution.ts +0 -22
package/src/router/match-middleware/segment-resolution.ts +45 -14
package/src/router/match-pipelines.ts +1 -42
package/src/router/match-result.ts +93 -39
package/src/router/metrics.ts +0 -34
package/src/router/middleware-types.ts +13 -142
package/src/router/middleware.ts +268 -171
package/src/router/navigation-snapshot.ts +131 -0
package/src/router/params-util.ts +23 -0
package/src/router/pattern-matching.ts +132 -90
package/src/router/prefetch-cache-ttl.ts +51 -0
package/src/router/prerender-match.ts +195 -56
package/src/router/preview-match.ts +32 -102
package/src/router/request-classification.ts +276 -0
package/src/router/revalidation.ts +123 -73
package/src/router/route-snapshot.ts +244 -0
package/src/router/router-context.ts +3 -27
package/src/router/router-interfaces.ts +115 -35
package/src/router/router-options.ts +172 -15
package/src/router/router-registry.ts +2 -5
package/src/router/segment-resolution/fresh.ts +190 -99
package/src/router/segment-resolution/helpers.ts +115 -30
package/src/router/segment-resolution/loader-cache.ts +62 -37
package/src/router/segment-resolution/revalidation.ts +386 -341
package/src/router/segment-resolution/static-store.ts +19 -5
package/src/router/segment-resolution/streamed-handler-telemetry.ts +52 -0
package/src/router/segment-resolution/view-transition-default.ts +36 -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 +56 -0
package/src/router/telemetry-otel.ts +161 -199
package/src/router/telemetry.ts +96 -19
package/src/router/timeout.ts +0 -20
package/src/router/tracing.ts +206 -0
package/src/router/trie-matching.ts +163 -59
package/src/router/types.ts +10 -63
package/src/router/url-params.ts +44 -0
package/src/router.ts +158 -54
package/src/rsc/handler-context.ts +3 -2
package/src/rsc/handler.ts +658 -511
package/src/rsc/helpers.ts +168 -46
package/src/rsc/index.ts +2 -5
package/src/rsc/json-route-result.ts +38 -0
package/src/rsc/loader-fetch.ts +127 -31
package/src/rsc/manifest-init.ts +33 -42
package/src/rsc/origin-guard.ts +39 -25
package/src/rsc/progressive-enhancement.ts +77 -11
package/src/rsc/redirect-guard.ts +99 -0
package/src/rsc/response-cache-serve.ts +238 -0
package/src/rsc/response-error.ts +79 -12
package/src/rsc/response-route-handler.ts +99 -189
package/src/rsc/rsc-rendering.ts +105 -72
package/src/rsc/runtime-warnings.ts +23 -10
package/src/rsc/server-action.ts +263 -112
package/src/rsc/ssr-setup.ts +18 -2
package/src/rsc/types.ts +32 -6
package/src/runtime-env.ts +18 -0
package/src/search-params.ts +35 -30
package/src/segment-content-promise.ts +67 -0
package/src/segment-loader-promise.ts +149 -0
package/src/segment-system.tsx +218 -202
package/src/serialize.ts +243 -0
package/src/server/context.ts +222 -51
package/src/server/cookie-parse.ts +32 -0
package/src/server/cookie-store.ts +80 -5
package/src/server/handle-store.ts +40 -38
package/src/server/loader-registry.ts +26 -46
package/src/server/request-context.ts +390 -170
package/src/ssr/index.tsx +24 -16
package/src/static-handler.ts +27 -18
package/src/testing/cache-status.ts +162 -0
package/src/testing/collect-handle.ts +40 -0
package/src/testing/dispatch.ts +701 -0
package/src/testing/dom.entry.ts +22 -0
package/src/testing/e2e/fixture.ts +188 -0
package/src/testing/e2e/index.ts +128 -0
package/src/testing/e2e/matchers.ts +35 -0
package/src/testing/e2e/page-helpers.ts +272 -0
package/src/testing/e2e/parity.ts +387 -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 +183 -0
package/src/testing/index.ts +99 -0
package/src/testing/internal/context.ts +371 -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 +343 -0
package/src/testing/render-route.tsx +581 -0
package/src/testing/run-loader.ts +385 -0
package/src/testing/run-middleware.ts +205 -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 +20 -58
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 +0 -35
package/src/types/cache-types.ts +17 -8
package/src/types/error-types.ts +30 -90
package/src/types/global-namespace.ts +54 -41
package/src/types/handler-context.ts +233 -81
package/src/types/index.ts +1 -10
package/src/types/loader-types.ts +44 -15
package/src/types/request-scope.ts +112 -0
package/src/types/route-config.ts +6 -50
package/src/types/route-entry.ts +12 -7
package/src/types/segments.ts +36 -15
package/src/urls/include-helper.ts +33 -70
package/src/urls/index.ts +1 -11
package/src/urls/path-helper-types.ts +58 -11
package/src/urls/path-helper.ts +57 -111
package/src/urls/pattern-types.ts +48 -19
package/src/urls/response-types.ts +25 -22
package/src/urls/type-extraction.ts +58 -139
package/src/urls/urls-function.ts +1 -18
package/src/use-loader.tsx +346 -89
package/src/vite/debug.ts +185 -0
package/src/vite/discovery/bundle-postprocess.ts +36 -38
package/src/vite/discovery/discover-routers.ts +130 -85
package/src/vite/discovery/discovery-errors.ts +194 -0
package/src/vite/discovery/gate-state.ts +171 -0
package/src/vite/discovery/prerender-collection.ts +214 -132
package/src/vite/discovery/route-types-writer.ts +40 -84
package/src/vite/discovery/self-gen-tracking.ts +27 -1
package/src/vite/discovery/state.ts +57 -4
package/src/vite/discovery/virtual-module-codegen.ts +14 -34
package/src/vite/index.ts +6 -0
package/src/vite/inject-client-debug.ts +36 -0
package/src/vite/plugin-types.ts +178 -5
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-loader-hook.d.mts +23 -0
package/src/vite/plugins/cloudflare-protocol-loader-hook.mjs +76 -0
package/src/vite/plugins/cloudflare-protocol-stub.ts +194 -0
package/src/vite/plugins/expose-action-id.ts +48 -95
package/src/vite/plugins/expose-id-utils.ts +96 -51
package/src/vite/plugins/expose-ids/export-analysis.ts +101 -34
package/src/vite/plugins/expose-ids/handler-transform.ts +15 -64
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 +553 -317
package/src/vite/plugins/performance-tracks.ts +89 -0
package/src/vite/plugins/refresh-cmd.ts +89 -27
package/src/vite/plugins/use-cache-transform.ts +73 -83
package/src/vite/plugins/version-injector.ts +21 -25
package/src/vite/plugins/version-plugin.ts +37 -40
package/src/vite/plugins/virtual-entries.ts +13 -18
package/src/vite/rango.ts +119 -111
package/src/vite/router-discovery.ts +941 -142
package/src/vite/utils/ast-handler-extract.ts +26 -35
package/src/vite/utils/banner.ts +1 -1
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 +4 -59
package/src/vite/utils/package-resolution.ts +20 -52
package/src/vite/utils/prerender-utils.ts +81 -34
package/src/vite/utils/shared-utils.ts +92 -42
package/dist/__internal.d.ts +0 -83
package/dist/__internal.d.ts.map +0 -1
package/dist/__internal.js +0 -19
package/dist/__internal.js.map +0 -1
package/dist/__mocks__/version.d.ts +0 -7
package/dist/__mocks__/version.d.ts.map +0 -1
package/dist/__mocks__/version.js +0 -7
package/dist/__mocks__/version.js.map +0 -1
package/dist/__tests__/client-href.test.d.ts +0 -2
package/dist/__tests__/client-href.test.d.ts.map +0 -1
package/dist/__tests__/client-href.test.js +0 -74
package/dist/__tests__/client-href.test.js.map +0 -1
package/dist/__tests__/component-utils.test.d.ts +0 -2
package/dist/__tests__/component-utils.test.d.ts.map +0 -1
package/dist/__tests__/component-utils.test.js +0 -51
package/dist/__tests__/component-utils.test.js.map +0 -1
package/dist/__tests__/event-controller.test.d.ts +0 -2
package/dist/__tests__/event-controller.test.d.ts.map +0 -1
package/dist/__tests__/event-controller.test.js +0 -538
package/dist/__tests__/event-controller.test.js.map +0 -1
package/dist/__tests__/helpers/route-tree.d.ts +0 -118
package/dist/__tests__/helpers/route-tree.d.ts.map +0 -1
package/dist/__tests__/helpers/route-tree.js +0 -374
package/dist/__tests__/helpers/route-tree.js.map +0 -1
package/dist/__tests__/match-result.test.d.ts +0 -2
package/dist/__tests__/match-result.test.d.ts.map +0 -1
package/dist/__tests__/match-result.test.js +0 -154
package/dist/__tests__/match-result.test.js.map +0 -1
package/dist/__tests__/navigation-store.test.d.ts +0 -2
package/dist/__tests__/navigation-store.test.d.ts.map +0 -1
package/dist/__tests__/navigation-store.test.js +0 -440
package/dist/__tests__/navigation-store.test.js.map +0 -1
package/dist/__tests__/partial-update.test.d.ts +0 -2
package/dist/__tests__/partial-update.test.d.ts.map +0 -1
package/dist/__tests__/partial-update.test.js +0 -1009
package/dist/__tests__/partial-update.test.js.map +0 -1
package/dist/__tests__/reverse-types.test.d.ts +0 -8
package/dist/__tests__/reverse-types.test.d.ts.map +0 -1
package/dist/__tests__/reverse-types.test.js +0 -656
package/dist/__tests__/reverse-types.test.js.map +0 -1
package/dist/__tests__/route-definition.test.d.ts +0 -2
package/dist/__tests__/route-definition.test.d.ts.map +0 -1
package/dist/__tests__/route-definition.test.js +0 -55
package/dist/__tests__/route-definition.test.js.map +0 -1
package/dist/__tests__/router-helpers.test.d.ts +0 -2
package/dist/__tests__/router-helpers.test.d.ts.map +0 -1
package/dist/__tests__/router-helpers.test.js +0 -377
package/dist/__tests__/router-helpers.test.js.map +0 -1
package/dist/__tests__/router-integration-2.test.d.ts +0 -2
package/dist/__tests__/router-integration-2.test.d.ts.map +0 -1
package/dist/__tests__/router-integration-2.test.js +0 -426
package/dist/__tests__/router-integration-2.test.js.map +0 -1
package/dist/__tests__/router-integration.test.d.ts +0 -2
package/dist/__tests__/router-integration.test.d.ts.map +0 -1
package/dist/__tests__/router-integration.test.js +0 -1051
package/dist/__tests__/router-integration.test.js.map +0 -1
package/dist/__tests__/search-params.test.d.ts +0 -5
package/dist/__tests__/search-params.test.d.ts.map +0 -1
package/dist/__tests__/search-params.test.js +0 -306
package/dist/__tests__/search-params.test.js.map +0 -1
package/dist/__tests__/segment-system.test.d.ts +0 -2
package/dist/__tests__/segment-system.test.d.ts.map +0 -1
package/dist/__tests__/segment-system.test.js +0 -627
package/dist/__tests__/segment-system.test.js.map +0 -1
package/dist/__tests__/static-handler-types.test.d.ts +0 -8
package/dist/__tests__/static-handler-types.test.d.ts.map +0 -1
package/dist/__tests__/static-handler-types.test.js +0 -63
package/dist/__tests__/static-handler-types.test.js.map +0 -1
package/dist/__tests__/urls.test.d.ts +0 -2
package/dist/__tests__/urls.test.d.ts.map +0 -1
package/dist/__tests__/urls.test.js +0 -421
package/dist/__tests__/urls.test.js.map +0 -1
package/dist/__tests__/use-mount.test.d.ts +0 -2
package/dist/__tests__/use-mount.test.d.ts.map +0 -1
package/dist/__tests__/use-mount.test.js +0 -35
package/dist/__tests__/use-mount.test.js.map +0 -1
package/dist/bin/rango.d.ts +0 -2
package/dist/bin/rango.d.ts.map +0 -1
package/dist/bin/rango.js.map +0 -1
package/dist/browser/event-controller.d.ts +0 -191
package/dist/browser/event-controller.d.ts.map +0 -1
package/dist/browser/event-controller.js +0 -559
package/dist/browser/event-controller.js.map +0 -1
package/dist/browser/index.d.ts +0 -2
package/dist/browser/index.d.ts.map +0 -1
package/dist/browser/index.js +0 -14
package/dist/browser/index.js.map +0 -1
package/dist/browser/link-interceptor.d.ts +0 -38
package/dist/browser/link-interceptor.d.ts.map +0 -1
package/dist/browser/link-interceptor.js +0 -99
package/dist/browser/link-interceptor.js.map +0 -1
package/dist/browser/logging.d.ts +0 -10
package/dist/browser/logging.d.ts.map +0 -1
package/dist/browser/logging.js +0 -29
package/dist/browser/logging.js.map +0 -1
package/dist/browser/lru-cache.d.ts +0 -17
package/dist/browser/lru-cache.d.ts.map +0 -1
package/dist/browser/lru-cache.js +0 -50
package/dist/browser/lru-cache.js.map +0 -1
package/dist/browser/merge-segment-loaders.d.ts +0 -39
package/dist/browser/merge-segment-loaders.d.ts.map +0 -1
package/dist/browser/merge-segment-loaders.js +0 -102
package/dist/browser/merge-segment-loaders.js.map +0 -1
package/dist/browser/navigation-bridge.d.ts +0 -102
package/dist/browser/navigation-bridge.d.ts.map +0 -1
package/dist/browser/navigation-bridge.js +0 -708
package/dist/browser/navigation-bridge.js.map +0 -1
package/dist/browser/navigation-client.d.ts +0 -25
package/dist/browser/navigation-client.d.ts.map +0 -1
package/dist/browser/navigation-client.js +0 -157
package/dist/browser/navigation-client.js.map +0 -1
package/dist/browser/navigation-store.d.ts +0 -101
package/dist/browser/navigation-store.d.ts.map +0 -1
package/dist/browser/navigation-store.js +0 -625
package/dist/browser/navigation-store.js.map +0 -1
package/dist/browser/partial-update.d.ts +0 -75
package/dist/browser/partial-update.d.ts.map +0 -1
package/dist/browser/partial-update.js +0 -426
package/dist/browser/partial-update.js.map +0 -1
package/dist/browser/react/Link.d.ts +0 -86
package/dist/browser/react/Link.d.ts.map +0 -1
package/dist/browser/react/Link.js +0 -128
package/dist/browser/react/Link.js.map +0 -1
package/dist/browser/react/NavigationProvider.d.ts +0 -63
package/dist/browser/react/NavigationProvider.d.ts.map +0 -1
package/dist/browser/react/NavigationProvider.js +0 -216
package/dist/browser/react/NavigationProvider.js.map +0 -1
package/dist/browser/react/ScrollRestoration.d.ts +0 -75
package/dist/browser/react/ScrollRestoration.d.ts.map +0 -1
package/dist/browser/react/ScrollRestoration.js +0 -57
package/dist/browser/react/ScrollRestoration.js.map +0 -1
package/dist/browser/react/context.d.ts +0 -46
package/dist/browser/react/context.d.ts.map +0 -1
package/dist/browser/react/context.js +0 -10
package/dist/browser/react/context.js.map +0 -1
package/dist/browser/react/index.d.ts +0 -11
package/dist/browser/react/index.d.ts.map +0 -1
package/dist/browser/react/index.js +0 -22
package/dist/browser/react/index.js.map +0 -1
package/dist/browser/react/location-state-shared.d.ts +0 -63
package/dist/browser/react/location-state-shared.d.ts.map +0 -1
package/dist/browser/react/location-state-shared.js +0 -81
package/dist/browser/react/location-state-shared.js.map +0 -1
package/dist/browser/react/location-state.d.ts +0 -23
package/dist/browser/react/location-state.d.ts.map +0 -1
package/dist/browser/react/location-state.js +0 -29
package/dist/browser/react/location-state.js.map +0 -1
package/dist/browser/react/mount-context.d.ts +0 -24
package/dist/browser/react/mount-context.d.ts.map +0 -1
package/dist/browser/react/mount-context.js +0 -24
package/dist/browser/react/mount-context.js.map +0 -1
package/dist/browser/react/use-action.d.ts +0 -64
package/dist/browser/react/use-action.d.ts.map +0 -1
package/dist/browser/react/use-action.js +0 -134
package/dist/browser/react/use-action.js.map +0 -1
package/dist/browser/react/use-client-cache.d.ts +0 -41
package/dist/browser/react/use-client-cache.d.ts.map +0 -1
package/dist/browser/react/use-client-cache.js +0 -39
package/dist/browser/react/use-client-cache.js.map +0 -1
package/dist/browser/react/use-handle.d.ts +0 -31
package/dist/browser/react/use-handle.d.ts.map +0 -1
package/dist/browser/react/use-handle.js +0 -144
package/dist/browser/react/use-handle.js.map +0 -1
package/dist/browser/react/use-href.d.ts +0 -33
package/dist/browser/react/use-href.d.ts.map +0 -1
package/dist/browser/react/use-href.js +0 -39
package/dist/browser/react/use-href.js.map +0 -1
package/dist/browser/react/use-link-status.d.ts +0 -37
package/dist/browser/react/use-link-status.d.ts.map +0 -1
package/dist/browser/react/use-link-status.js +0 -99
package/dist/browser/react/use-link-status.js.map +0 -1
package/dist/browser/react/use-mount.d.ts +0 -25
package/dist/browser/react/use-mount.d.ts.map +0 -1
package/dist/browser/react/use-mount.js +0 -30
package/dist/browser/react/use-mount.js.map +0 -1
package/dist/browser/react/use-navigation.d.ts +0 -27
package/dist/browser/react/use-navigation.d.ts.map +0 -1
package/dist/browser/react/use-navigation.js +0 -87
package/dist/browser/react/use-navigation.js.map +0 -1
package/dist/browser/react/use-segments.d.ts +0 -38
package/dist/browser/react/use-segments.d.ts.map +0 -1
package/dist/browser/react/use-segments.js +0 -130
package/dist/browser/react/use-segments.js.map +0 -1
package/dist/browser/request-controller.d.ts +0 -26
package/dist/browser/request-controller.d.ts.map +0 -1
package/dist/browser/request-controller.js +0 -147
package/dist/browser/request-controller.js.map +0 -1
package/dist/browser/rsc-router.d.ts +0 -129
package/dist/browser/rsc-router.d.ts.map +0 -1
package/dist/browser/rsc-router.js +0 -195
package/dist/browser/rsc-router.js.map +0 -1
package/dist/browser/scroll-restoration.d.ts +0 -93
package/dist/browser/scroll-restoration.d.ts.map +0 -1
package/dist/browser/scroll-restoration.js +0 -321
package/dist/browser/scroll-restoration.js.map +0 -1
package/dist/browser/segment-structure-assert.d.ts +0 -17
package/dist/browser/segment-structure-assert.d.ts.map +0 -1
package/dist/browser/segment-structure-assert.js +0 -59
package/dist/browser/segment-structure-assert.js.map +0 -1
package/dist/browser/server-action-bridge.d.ts +0 -26
package/dist/browser/server-action-bridge.d.ts.map +0 -1
package/dist/browser/server-action-bridge.js +0 -668
package/dist/browser/server-action-bridge.js.map +0 -1
package/dist/browser/shallow.d.ts +0 -12
package/dist/browser/shallow.d.ts.map +0 -1
package/dist/browser/shallow.js +0 -34
package/dist/browser/shallow.js.map +0 -1
package/dist/browser/types.d.ts +0 -369
package/dist/browser/types.d.ts.map +0 -1
package/dist/browser/types.js +0 -2
package/dist/browser/types.js.map +0 -1
package/dist/build/__tests__/generate-cli.test.d.ts +0 -2
package/dist/build/__tests__/generate-cli.test.d.ts.map +0 -1
package/dist/build/__tests__/generate-cli.test.js +0 -237
package/dist/build/__tests__/generate-cli.test.js.map +0 -1
package/dist/build/__tests__/generate-manifest.test.d.ts +0 -2
package/dist/build/__tests__/generate-manifest.test.d.ts.map +0 -1
package/dist/build/__tests__/generate-manifest.test.js +0 -119
package/dist/build/__tests__/generate-manifest.test.js.map +0 -1
package/dist/build/__tests__/generate-route-types.test.d.ts +0 -2
package/dist/build/__tests__/generate-route-types.test.d.ts.map +0 -1
package/dist/build/__tests__/generate-route-types.test.js +0 -620
package/dist/build/__tests__/generate-route-types.test.js.map +0 -1
package/dist/build/__tests__/per-router-manifest.test.d.ts +0 -2
package/dist/build/__tests__/per-router-manifest.test.d.ts.map +0 -1
package/dist/build/__tests__/per-router-manifest.test.js +0 -308
package/dist/build/__tests__/per-router-manifest.test.js.map +0 -1
package/dist/build/generate-manifest.d.ts +0 -81
package/dist/build/generate-manifest.d.ts.map +0 -1
package/dist/build/generate-manifest.js +0 -276
package/dist/build/generate-manifest.js.map +0 -1
package/dist/build/generate-route-types.d.ts +0 -115
package/dist/build/generate-route-types.d.ts.map +0 -1
package/dist/build/generate-route-types.js +0 -740
package/dist/build/generate-route-types.js.map +0 -1
package/dist/build/index.d.ts +0 -21
package/dist/build/index.d.ts.map +0 -1
package/dist/build/index.js +0 -21
package/dist/build/index.js.map +0 -1
package/dist/build/route-trie.d.ts +0 -71
package/dist/build/route-trie.d.ts.map +0 -1
package/dist/build/route-trie.js +0 -175
package/dist/build/route-trie.js.map +0 -1
package/dist/cache/__tests__/cache-scope.test.d.ts +0 -2
package/dist/cache/__tests__/cache-scope.test.d.ts.map +0 -1
package/dist/cache/__tests__/cache-scope.test.js +0 -208
package/dist/cache/__tests__/cache-scope.test.js.map +0 -1
package/dist/cache/__tests__/document-cache.test.d.ts +0 -2
package/dist/cache/__tests__/document-cache.test.d.ts.map +0 -1
package/dist/cache/__tests__/document-cache.test.js +0 -345
package/dist/cache/__tests__/document-cache.test.js.map +0 -1
package/dist/cache/__tests__/memory-segment-store.test.d.ts +0 -2
package/dist/cache/__tests__/memory-segment-store.test.d.ts.map +0 -1
package/dist/cache/__tests__/memory-segment-store.test.js +0 -425
package/dist/cache/__tests__/memory-segment-store.test.js.map +0 -1
package/dist/cache/__tests__/memory-store.test.d.ts +0 -2
package/dist/cache/__tests__/memory-store.test.d.ts.map +0 -1
package/dist/cache/__tests__/memory-store.test.js +0 -367
package/dist/cache/__tests__/memory-store.test.js.map +0 -1
package/dist/cache/cache-scope.d.ts +0 -102
package/dist/cache/cache-scope.d.ts.map +0 -1
package/dist/cache/cache-scope.js +0 -440
package/dist/cache/cache-scope.js.map +0 -1
package/dist/cache/cf/__tests__/cf-cache-store.test.d.ts +0 -2
package/dist/cache/cf/__tests__/cf-cache-store.test.d.ts.map +0 -1
package/dist/cache/cf/__tests__/cf-cache-store.test.js +0 -330
package/dist/cache/cf/__tests__/cf-cache-store.test.js.map +0 -1
package/dist/cache/cf/cf-cache-store.d.ts +0 -165
package/dist/cache/cf/cf-cache-store.d.ts.map +0 -1
package/dist/cache/cf/cf-cache-store.js +0 -242
package/dist/cache/cf/cf-cache-store.js.map +0 -1
package/dist/cache/cf/index.d.ts +0 -14
package/dist/cache/cf/index.d.ts.map +0 -1
package/dist/cache/cf/index.js +0 -17
package/dist/cache/cf/index.js.map +0 -1
package/dist/cache/document-cache.d.ts +0 -64
package/dist/cache/document-cache.d.ts.map +0 -1
package/dist/cache/document-cache.js +0 -228
package/dist/cache/document-cache.js.map +0 -1
package/dist/cache/index.d.ts +0 -19
package/dist/cache/index.d.ts.map +0 -1
package/dist/cache/index.js +0 -21
package/dist/cache/index.js.map +0 -1
package/dist/cache/memory-segment-store.d.ts +0 -110
package/dist/cache/memory-segment-store.d.ts.map +0 -1
package/dist/cache/memory-segment-store.js +0 -117
package/dist/cache/memory-segment-store.js.map +0 -1
package/dist/cache/memory-store.d.ts +0 -41
package/dist/cache/memory-store.d.ts.map +0 -1
package/dist/cache/memory-store.js +0 -191
package/dist/cache/memory-store.js.map +0 -1
package/dist/cache/types.d.ts +0 -317
package/dist/cache/types.d.ts.map +0 -1
package/dist/cache/types.js +0 -12
package/dist/cache/types.js.map +0 -1
package/dist/client.d.ts +0 -248
package/dist/client.d.ts.map +0 -1
package/dist/client.js +0 -367
package/dist/client.js.map +0 -1
package/dist/client.rsc.d.ts +0 -26
package/dist/client.rsc.d.ts.map +0 -1
package/dist/client.rsc.js +0 -46
package/dist/client.rsc.js.map +0 -1
package/dist/component-utils.d.ts +0 -36
package/dist/component-utils.d.ts.map +0 -1
package/dist/component-utils.js +0 -61
package/dist/component-utils.js.map +0 -1
package/dist/components/DefaultDocument.d.ts +0 -13
package/dist/components/DefaultDocument.d.ts.map +0 -1
package/dist/components/DefaultDocument.js +0 -15
package/dist/components/DefaultDocument.js.map +0 -1
package/dist/debug.d.ts +0 -58
package/dist/debug.d.ts.map +0 -1
package/dist/debug.js +0 -157
package/dist/debug.js.map +0 -1
package/dist/default-error-boundary.d.ts +0 -11
package/dist/default-error-boundary.d.ts.map +0 -1
package/dist/default-error-boundary.js +0 -45
package/dist/default-error-boundary.js.map +0 -1
package/dist/deps/browser.d.ts +0 -2
package/dist/deps/browser.d.ts.map +0 -1
package/dist/deps/browser.js +0 -3
package/dist/deps/browser.js.map +0 -1
package/dist/deps/html-stream-client.d.ts +0 -2
package/dist/deps/html-stream-client.d.ts.map +0 -1
package/dist/deps/html-stream-client.js +0 -3
package/dist/deps/html-stream-client.js.map +0 -1
package/dist/deps/html-stream-server.d.ts +0 -2
package/dist/deps/html-stream-server.d.ts.map +0 -1
package/dist/deps/html-stream-server.js +0 -3
package/dist/deps/html-stream-server.js.map +0 -1
package/dist/deps/rsc.d.ts +0 -2
package/dist/deps/rsc.d.ts.map +0 -1
package/dist/deps/rsc.js +0 -4
package/dist/deps/rsc.js.map +0 -1
package/dist/deps/ssr.d.ts +0 -2
package/dist/deps/ssr.d.ts.map +0 -1
package/dist/deps/ssr.js +0 -3
package/dist/deps/ssr.js.map +0 -1
package/dist/errors.d.ts +0 -174
package/dist/errors.d.ts.map +0 -1
package/dist/errors.js +0 -241
package/dist/errors.js.map +0 -1
package/dist/handle.d.ts +0 -78
package/dist/handle.d.ts.map +0 -1
package/dist/handle.js +0 -82
package/dist/handle.js.map +0 -1
package/dist/handles/MetaTags.d.ts +0 -14
package/dist/handles/MetaTags.d.ts.map +0 -1
package/dist/handles/MetaTags.js +0 -136
package/dist/handles/MetaTags.js.map +0 -1
package/dist/handles/index.d.ts +0 -6
package/dist/handles/index.d.ts.map +0 -1
package/dist/handles/index.js +0 -6
package/dist/handles/index.js.map +0 -1
package/dist/handles/meta.d.ts +0 -39
package/dist/handles/meta.d.ts.map +0 -1
package/dist/handles/meta.js +0 -202
package/dist/handles/meta.js.map +0 -1
package/dist/host/__tests__/errors.test.d.ts +0 -2
package/dist/host/__tests__/errors.test.d.ts.map +0 -1
package/dist/host/__tests__/errors.test.js +0 -76
package/dist/host/__tests__/errors.test.js.map +0 -1
package/dist/host/__tests__/pattern-comprehensive.test.d.ts +0 -2
package/dist/host/__tests__/pattern-comprehensive.test.d.ts.map +0 -1
package/dist/host/__tests__/pattern-comprehensive.test.js +0 -732
package/dist/host/__tests__/pattern-comprehensive.test.js.map +0 -1
package/dist/host/__tests__/pattern-matcher.test.d.ts +0 -2
package/dist/host/__tests__/pattern-matcher.test.d.ts.map +0 -1
package/dist/host/__tests__/pattern-matcher.test.js +0 -251
package/dist/host/__tests__/pattern-matcher.test.js.map +0 -1
package/dist/host/__tests__/router.test.d.ts +0 -2
package/dist/host/__tests__/router.test.d.ts.map +0 -1
package/dist/host/__tests__/router.test.js +0 -241
package/dist/host/__tests__/router.test.js.map +0 -1
package/dist/host/__tests__/testing.test.d.ts +0 -2
package/dist/host/__tests__/testing.test.d.ts.map +0 -1
package/dist/host/__tests__/testing.test.js +0 -64
package/dist/host/__tests__/testing.test.js.map +0 -1
package/dist/host/__tests__/utils.test.d.ts +0 -2
package/dist/host/__tests__/utils.test.d.ts.map +0 -1
package/dist/host/__tests__/utils.test.js +0 -29
package/dist/host/__tests__/utils.test.js.map +0 -1
package/dist/host/cookie-handler.d.ts +0 -34
package/dist/host/cookie-handler.d.ts.map +0 -1
package/dist/host/cookie-handler.js +0 -124
package/dist/host/cookie-handler.js.map +0 -1
package/dist/host/errors.d.ts +0 -56
package/dist/host/errors.d.ts.map +0 -1
package/dist/host/errors.js +0 -79
package/dist/host/errors.js.map +0 -1
package/dist/host/index.d.ts +0 -29
package/dist/host/index.d.ts.map +0 -1
package/dist/host/index.js +0 -32
package/dist/host/index.js.map +0 -1
package/dist/host/pattern-matcher.d.ts +0 -36
package/dist/host/pattern-matcher.d.ts.map +0 -1
package/dist/host/pattern-matcher.js +0 -172
package/dist/host/pattern-matcher.js.map +0 -1
package/dist/host/router.d.ts +0 -26
package/dist/host/router.d.ts.map +0 -1
package/dist/host/router.js +0 -218
package/dist/host/router.js.map +0 -1
package/dist/host/testing.d.ts +0 -36
package/dist/host/testing.d.ts.map +0 -1
package/dist/host/testing.js +0 -55
package/dist/host/testing.js.map +0 -1
package/dist/host/types.d.ts +0 -115
package/dist/host/types.d.ts.map +0 -1
package/dist/host/types.js +0 -7
package/dist/host/types.js.map +0 -1
package/dist/host/utils.d.ts +0 -21
package/dist/host/utils.d.ts.map +0 -1
package/dist/host/utils.js +0 -23
package/dist/host/utils.js.map +0 -1
package/dist/href-client.d.ts +0 -131
package/dist/href-client.d.ts.map +0 -1
package/dist/href-client.js +0 -64
package/dist/href-client.js.map +0 -1
package/dist/href-context.d.ts +0 -29
package/dist/href-context.d.ts.map +0 -1
package/dist/href-context.js +0 -21
package/dist/href-context.js.map +0 -1
package/dist/index.d.ts +0 -73
package/dist/index.d.ts.map +0 -1
package/dist/index.js +0 -91
package/dist/index.js.map +0 -1
package/dist/index.rsc.d.ts +0 -32
package/dist/index.rsc.d.ts.map +0 -1
package/dist/index.rsc.js +0 -40
package/dist/index.rsc.js.map +0 -1
package/dist/internal-debug.d.ts +0 -2
package/dist/internal-debug.d.ts.map +0 -1
package/dist/internal-debug.js +0 -5
package/dist/internal-debug.js.map +0 -1
package/dist/loader.d.ts +0 -14
package/dist/loader.d.ts.map +0 -1
package/dist/loader.js +0 -20
package/dist/loader.js.map +0 -1
package/dist/loader.rsc.d.ts +0 -19
package/dist/loader.rsc.d.ts.map +0 -1
package/dist/loader.rsc.js +0 -99
package/dist/loader.rsc.js.map +0 -1
package/dist/network-error-thrower.d.ts +0 -17
package/dist/network-error-thrower.d.ts.map +0 -1
package/dist/network-error-thrower.js +0 -14
package/dist/network-error-thrower.js.map +0 -1
package/dist/outlet-context.d.ts +0 -13
package/dist/outlet-context.d.ts.map +0 -1
package/dist/outlet-context.js +0 -3
package/dist/outlet-context.js.map +0 -1
package/dist/prerender/__tests__/param-hash.test.d.ts +0 -2
package/dist/prerender/__tests__/param-hash.test.d.ts.map +0 -1
package/dist/prerender/__tests__/param-hash.test.js +0 -148
package/dist/prerender/__tests__/param-hash.test.js.map +0 -1
package/dist/prerender/param-hash.d.ts +0 -16
package/dist/prerender/param-hash.d.ts.map +0 -1
package/dist/prerender/param-hash.js +0 -36
package/dist/prerender/param-hash.js.map +0 -1
package/dist/prerender/store.d.ts +0 -38
package/dist/prerender/store.d.ts.map +0 -1
package/dist/prerender/store.js +0 -61
package/dist/prerender/store.js.map +0 -1
package/dist/prerender.d.ts +0 -66
package/dist/prerender.d.ts.map +0 -1
package/dist/prerender.js +0 -57
package/dist/prerender.js.map +0 -1
package/dist/reverse.d.ts +0 -196
package/dist/reverse.d.ts.map +0 -1
package/dist/reverse.js +0 -78
package/dist/reverse.js.map +0 -1
package/dist/root-error-boundary.d.ts +0 -33
package/dist/root-error-boundary.d.ts.map +0 -1
package/dist/root-error-boundary.js +0 -165
package/dist/root-error-boundary.js.map +0 -1
package/dist/route-content-wrapper.d.ts +0 -46
package/dist/route-content-wrapper.d.ts.map +0 -1
package/dist/route-content-wrapper.js +0 -77
package/dist/route-content-wrapper.js.map +0 -1
package/dist/route-definition.d.ts +0 -421
package/dist/route-definition.d.ts.map +0 -1
package/dist/route-definition.js +0 -868
package/dist/route-definition.js.map +0 -1
package/dist/route-map-builder.d.ts +0 -155
package/dist/route-map-builder.d.ts.map +0 -1
package/dist/route-map-builder.js +0 -237
package/dist/route-map-builder.js.map +0 -1
package/dist/route-types.d.ts +0 -165
package/dist/route-types.d.ts.map +0 -1
package/dist/route-types.js +0 -7
package/dist/route-types.js.map +0 -1
package/dist/router/__tests__/handler-context.test.d.ts +0 -2
package/dist/router/__tests__/handler-context.test.d.ts.map +0 -1
package/dist/router/__tests__/handler-context.test.js +0 -65
package/dist/router/__tests__/handler-context.test.js.map +0 -1
package/dist/router/__tests__/loader-cycle-detection.test.d.ts +0 -2
package/dist/router/__tests__/loader-cycle-detection.test.d.ts.map +0 -1
package/dist/router/__tests__/loader-cycle-detection.test.js +0 -221
package/dist/router/__tests__/loader-cycle-detection.test.js.map +0 -1
package/dist/router/__tests__/match-context.test.d.ts +0 -2
package/dist/router/__tests__/match-context.test.d.ts.map +0 -1
package/dist/router/__tests__/match-context.test.js +0 -92
package/dist/router/__tests__/match-context.test.js.map +0 -1
package/dist/router/__tests__/match-pipelines.test.d.ts +0 -2
package/dist/router/__tests__/match-pipelines.test.d.ts.map +0 -1
package/dist/router/__tests__/match-pipelines.test.js +0 -417
package/dist/router/__tests__/match-pipelines.test.js.map +0 -1
package/dist/router/__tests__/match-result.test.d.ts +0 -2
package/dist/router/__tests__/match-result.test.d.ts.map +0 -1
package/dist/router/__tests__/match-result.test.js +0 -457
package/dist/router/__tests__/match-result.test.js.map +0 -1
package/dist/router/__tests__/on-error.test.d.ts +0 -2
package/dist/router/__tests__/on-error.test.d.ts.map +0 -1
package/dist/router/__tests__/on-error.test.js +0 -678
package/dist/router/__tests__/on-error.test.js.map +0 -1
package/dist/router/__tests__/pattern-matching.test.d.ts +0 -2
package/dist/router/__tests__/pattern-matching.test.d.ts.map +0 -1
package/dist/router/__tests__/pattern-matching.test.js +0 -629
package/dist/router/__tests__/pattern-matching.test.js.map +0 -1
package/dist/router/__tests__/segment-resolution-parallel-loading.test.d.ts +0 -2
package/dist/router/__tests__/segment-resolution-parallel-loading.test.d.ts.map +0 -1
package/dist/router/__tests__/segment-resolution-parallel-loading.test.js +0 -155
package/dist/router/__tests__/segment-resolution-parallel-loading.test.js.map +0 -1
package/dist/router/error-handling.d.ts +0 -77
package/dist/router/error-handling.d.ts.map +0 -1
package/dist/router/error-handling.js +0 -202
package/dist/router/error-handling.js.map +0 -1
package/dist/router/handler-context.d.ts +0 -20
package/dist/router/handler-context.d.ts.map +0 -1
package/dist/router/handler-context.js +0 -198
package/dist/router/handler-context.js.map +0 -1
package/dist/router/intercept-resolution.d.ts +0 -66
package/dist/router/intercept-resolution.d.ts.map +0 -1
package/dist/router/intercept-resolution.js +0 -246
package/dist/router/intercept-resolution.js.map +0 -1
package/dist/router/loader-resolution.d.ts +0 -64
package/dist/router/loader-resolution.d.ts.map +0 -1
package/dist/router/loader-resolution.js +0 -284
package/dist/router/loader-resolution.js.map +0 -1
package/dist/router/logging.d.ts +0 -15
package/dist/router/logging.d.ts.map +0 -1
package/dist/router/logging.js +0 -99
package/dist/router/logging.js.map +0 -1
package/dist/router/manifest.d.ts +0 -22
package/dist/router/manifest.d.ts.map +0 -1
package/dist/router/manifest.js +0 -181
package/dist/router/manifest.js.map +0 -1
package/dist/router/match-api.d.ts +0 -35
package/dist/router/match-api.d.ts.map +0 -1
package/dist/router/match-api.js +0 -406
package/dist/router/match-api.js.map +0 -1
package/dist/router/match-context.d.ts +0 -206
package/dist/router/match-context.d.ts.map +0 -1
package/dist/router/match-context.js +0 -17
package/dist/router/match-context.js.map +0 -1
package/dist/router/match-middleware/background-revalidation.d.ts +0 -127
package/dist/router/match-middleware/background-revalidation.d.ts.map +0 -1
package/dist/router/match-middleware/background-revalidation.js +0 -75
package/dist/router/match-middleware/background-revalidation.js.map +0 -1
package/dist/router/match-middleware/cache-lookup.d.ts +0 -112
package/dist/router/match-middleware/cache-lookup.d.ts.map +0 -1
package/dist/router/match-middleware/cache-lookup.js +0 -257
package/dist/router/match-middleware/cache-lookup.js.map +0 -1
package/dist/router/match-middleware/cache-store.d.ts +0 -113
package/dist/router/match-middleware/cache-store.d.ts.map +0 -1
package/dist/router/match-middleware/cache-store.js +0 -108
package/dist/router/match-middleware/cache-store.js.map +0 -1
package/dist/router/match-middleware/index.d.ts +0 -81
package/dist/router/match-middleware/index.d.ts.map +0 -1
package/dist/router/match-middleware/index.js +0 -80
package/dist/router/match-middleware/index.js.map +0 -1
package/dist/router/match-middleware/intercept-resolution.d.ts +0 -117
package/dist/router/match-middleware/intercept-resolution.d.ts.map +0 -1
package/dist/router/match-middleware/intercept-resolution.js +0 -134
package/dist/router/match-middleware/intercept-resolution.js.map +0 -1
package/dist/router/match-middleware/segment-resolution.d.ts +0 -99
package/dist/router/match-middleware/segment-resolution.d.ts.map +0 -1
package/dist/router/match-middleware/segment-resolution.js +0 -53
package/dist/router/match-middleware/segment-resolution.js.map +0 -1
package/dist/router/match-pipelines.d.ts +0 -147
package/dist/router/match-pipelines.d.ts.map +0 -1
package/dist/router/match-pipelines.js +0 -82
package/dist/router/match-pipelines.js.map +0 -1
package/dist/router/match-result.d.ts +0 -126
package/dist/router/match-result.d.ts.map +0 -1
package/dist/router/match-result.js +0 -93
package/dist/router/match-result.js.map +0 -1
package/dist/router/metrics.d.ts +0 -20
package/dist/router/metrics.d.ts.map +0 -1
package/dist/router/metrics.js +0 -47
package/dist/router/metrics.js.map +0 -1
package/dist/router/middleware.d.ts +0 -249
package/dist/router/middleware.d.ts.map +0 -1
package/dist/router/middleware.js +0 -434
package/dist/router/middleware.js.map +0 -1
package/dist/router/middleware.test.d.ts +0 -2
package/dist/router/middleware.test.d.ts.map +0 -1
package/dist/router/middleware.test.js +0 -816
package/dist/router/middleware.test.js.map +0 -1
package/dist/router/pattern-matching.d.ts +0 -149
package/dist/router/pattern-matching.d.ts.map +0 -1
package/dist/router/pattern-matching.js +0 -349
package/dist/router/pattern-matching.js.map +0 -1
package/dist/router/revalidation.d.ts +0 -44
package/dist/router/revalidation.d.ts.map +0 -1
package/dist/router/revalidation.js +0 -147
package/dist/router/revalidation.js.map +0 -1
package/dist/router/router-context.d.ts +0 -135
package/dist/router/router-context.d.ts.map +0 -1
package/dist/router/router-context.js +0 -36
package/dist/router/router-context.js.map +0 -1
package/dist/router/segment-resolution.d.ts +0 -127
package/dist/router/segment-resolution.d.ts.map +0 -1
package/dist/router/segment-resolution.js +0 -919
package/dist/router/segment-resolution.js.map +0 -1
package/dist/router/trie-matching.d.ts +0 -40
package/dist/router/trie-matching.d.ts.map +0 -1
package/dist/router/trie-matching.js +0 -127
package/dist/router/trie-matching.js.map +0 -1
package/dist/router/types.d.ts +0 -136
package/dist/router/types.d.ts.map +0 -1
package/dist/router/types.js +0 -7
package/dist/router/types.js.map +0 -1
package/dist/router.d.ts +0 -753
package/dist/router.d.ts.map +0 -1
package/dist/router.gen.d.ts +0 -6
package/dist/router.gen.d.ts.map +0 -1
package/dist/router.gen.js +0 -6
package/dist/router.gen.js.map +0 -1
package/dist/router.js +0 -1304
package/dist/router.js.map +0 -1
package/dist/rsc/__tests__/helpers.test.d.ts +0 -2
package/dist/rsc/__tests__/helpers.test.d.ts.map +0 -1
package/dist/rsc/__tests__/helpers.test.js +0 -140
package/dist/rsc/__tests__/helpers.test.js.map +0 -1
package/dist/rsc/handler.d.ts +0 -45
package/dist/rsc/handler.d.ts.map +0 -1
package/dist/rsc/handler.js +0 -1172
package/dist/rsc/handler.js.map +0 -1
package/dist/rsc/helpers.d.ts +0 -16
package/dist/rsc/helpers.d.ts.map +0 -1
package/dist/rsc/helpers.js +0 -55
package/dist/rsc/helpers.js.map +0 -1
package/dist/rsc/index.d.ts +0 -22
package/dist/rsc/index.d.ts.map +0 -1
package/dist/rsc/index.js +0 -23
package/dist/rsc/index.js.map +0 -1
package/dist/rsc/nonce.d.ts +0 -9
package/dist/rsc/nonce.d.ts.map +0 -1
package/dist/rsc/nonce.js +0 -18
package/dist/rsc/nonce.js.map +0 -1
package/dist/rsc/types.d.ts +0 -206
package/dist/rsc/types.d.ts.map +0 -1
package/dist/rsc/types.js +0 -8
package/dist/rsc/types.js.map +0 -1
package/dist/search-params.d.ts +0 -103
package/dist/search-params.d.ts.map +0 -1
package/dist/search-params.js +0 -74
package/dist/search-params.js.map +0 -1
package/dist/segment-system.d.ts +0 -75
package/dist/segment-system.d.ts.map +0 -1
package/dist/segment-system.js +0 -336
package/dist/segment-system.js.map +0 -1
package/dist/server/context.d.ts +0 -245
package/dist/server/context.d.ts.map +0 -1
package/dist/server/context.js +0 -197
package/dist/server/context.js.map +0 -1
package/dist/server/fetchable-loader-store.d.ts +0 -18
package/dist/server/fetchable-loader-store.d.ts.map +0 -1
package/dist/server/fetchable-loader-store.js +0 -18
package/dist/server/fetchable-loader-store.js.map +0 -1
package/dist/server/handle-store.d.ts +0 -85
package/dist/server/handle-store.d.ts.map +0 -1
package/dist/server/handle-store.js +0 -142
package/dist/server/handle-store.js.map +0 -1
package/dist/server/loader-registry.d.ts +0 -55
package/dist/server/loader-registry.d.ts.map +0 -1
package/dist/server/loader-registry.js +0 -132
package/dist/server/loader-registry.js.map +0 -1
package/dist/server/request-context.d.ts +0 -226
package/dist/server/request-context.d.ts.map +0 -1
package/dist/server/request-context.js +0 -290
package/dist/server/request-context.js.map +0 -1
package/dist/server/root-layout.d.ts +0 -4
package/dist/server/root-layout.d.ts.map +0 -1
package/dist/server/root-layout.js +0 -5
package/dist/server/root-layout.js.map +0 -1
package/dist/server.d.ts +0 -15
package/dist/server.d.ts.map +0 -1
package/dist/server.js +0 -20
package/dist/server.js.map +0 -1
package/dist/ssr/__tests__/ssr-handler.test.d.ts +0 -2
package/dist/ssr/__tests__/ssr-handler.test.d.ts.map +0 -1
package/dist/ssr/__tests__/ssr-handler.test.js +0 -132
package/dist/ssr/__tests__/ssr-handler.test.js.map +0 -1
package/dist/ssr/index.d.ts +0 -98
package/dist/ssr/index.d.ts.map +0 -1
package/dist/ssr/index.js +0 -158
package/dist/ssr/index.js.map +0 -1
package/dist/static-handler.d.ts +0 -50
package/dist/static-handler.d.ts.map +0 -1
package/dist/static-handler.gen.d.ts +0 -5
package/dist/static-handler.gen.d.ts.map +0 -1
package/dist/static-handler.gen.js +0 -5
package/dist/static-handler.gen.js.map +0 -1
package/dist/static-handler.js +0 -29
package/dist/static-handler.js.map +0 -1
package/dist/theme/ThemeProvider.d.ts +0 -20
package/dist/theme/ThemeProvider.d.ts.map +0 -1
package/dist/theme/ThemeProvider.js +0 -240
package/dist/theme/ThemeProvider.js.map +0 -1
package/dist/theme/ThemeScript.d.ts +0 -48
package/dist/theme/ThemeScript.d.ts.map +0 -1
package/dist/theme/ThemeScript.js +0 -13
package/dist/theme/ThemeScript.js.map +0 -1
package/dist/theme/__tests__/theme.test.d.ts +0 -2
package/dist/theme/__tests__/theme.test.d.ts.map +0 -1
package/dist/theme/__tests__/theme.test.js +0 -103
package/dist/theme/__tests__/theme.test.js.map +0 -1
package/dist/theme/constants.d.ts +0 -29
package/dist/theme/constants.d.ts.map +0 -1
package/dist/theme/constants.js +0 -48
package/dist/theme/constants.js.map +0 -1
package/dist/theme/index.d.ts +0 -31
package/dist/theme/index.d.ts.map +0 -1
package/dist/theme/index.js +0 -36
package/dist/theme/index.js.map +0 -1
package/dist/theme/theme-context.d.ts +0 -40
package/dist/theme/theme-context.d.ts.map +0 -1
package/dist/theme/theme-context.js +0 -60
package/dist/theme/theme-context.js.map +0 -1
package/dist/theme/theme-script.d.ts +0 -27
package/dist/theme/theme-script.d.ts.map +0 -1
package/dist/theme/theme-script.js +0 -147
package/dist/theme/theme-script.js.map +0 -1
package/dist/theme/types.d.ts +0 -163
package/dist/theme/types.d.ts.map +0 -1
package/dist/theme/types.js +0 -11
package/dist/theme/types.js.map +0 -1
package/dist/theme/use-theme.d.ts +0 -12
package/dist/theme/use-theme.d.ts.map +0 -1
package/dist/theme/use-theme.js +0 -40
package/dist/theme/use-theme.js.map +0 -1
package/dist/types.d.ts +0 -1479
package/dist/types.d.ts.map +0 -1
package/dist/types.js +0 -10
package/dist/types.js.map +0 -1
package/dist/urls.d.ts +0 -441
package/dist/urls.d.ts.map +0 -1
package/dist/urls.gen.d.ts +0 -8
package/dist/urls.gen.d.ts.map +0 -1
package/dist/urls.gen.js +0 -8
package/dist/urls.gen.js.map +0 -1
package/dist/urls.js +0 -443
package/dist/urls.js.map +0 -1
package/dist/use-loader.d.ts +0 -127
package/dist/use-loader.d.ts.map +0 -1
package/dist/use-loader.js +0 -237
package/dist/use-loader.js.map +0 -1
package/dist/vite/__tests__/ast-handler-extract.test.d.ts +0 -2
package/dist/vite/__tests__/ast-handler-extract.test.d.ts.map +0 -1
package/dist/vite/__tests__/ast-handler-extract.test.js +0 -294
package/dist/vite/__tests__/ast-handler-extract.test.js.map +0 -1
package/dist/vite/__tests__/expose-id-utils.test.d.ts +0 -2
package/dist/vite/__tests__/expose-id-utils.test.d.ts.map +0 -1
package/dist/vite/__tests__/expose-id-utils.test.js +0 -224
package/dist/vite/__tests__/expose-id-utils.test.js.map +0 -1
package/dist/vite/__tests__/expose-internal-ids.test.d.ts +0 -2
package/dist/vite/__tests__/expose-internal-ids.test.d.ts.map +0 -1
package/dist/vite/__tests__/expose-internal-ids.test.js +0 -647
package/dist/vite/__tests__/expose-internal-ids.test.js.map +0 -1
package/dist/vite/__tests__/expose-router-id.test.d.ts +0 -2
package/dist/vite/__tests__/expose-router-id.test.d.ts.map +0 -1
package/dist/vite/__tests__/expose-router-id.test.js +0 -39
package/dist/vite/__tests__/expose-router-id.test.js.map +0 -1
package/dist/vite/ast-handler-extract.d.ts +0 -49
package/dist/vite/ast-handler-extract.d.ts.map +0 -1
package/dist/vite/ast-handler-extract.js +0 -249
package/dist/vite/ast-handler-extract.js.map +0 -1
package/dist/vite/expose-action-id.d.ts +0 -19
package/dist/vite/expose-action-id.d.ts.map +0 -1
package/dist/vite/expose-action-id.js +0 -250
package/dist/vite/expose-action-id.js.map +0 -1
package/dist/vite/expose-id-utils.d.ts +0 -69
package/dist/vite/expose-id-utils.d.ts.map +0 -1
package/dist/vite/expose-id-utils.js +0 -289
package/dist/vite/expose-id-utils.js.map +0 -1
package/dist/vite/expose-internal-ids.d.ts +0 -22
package/dist/vite/expose-internal-ids.d.ts.map +0 -1
package/dist/vite/expose-internal-ids.js +0 -886
package/dist/vite/expose-internal-ids.js.map +0 -1
package/dist/vite/index.d.ts +0 -149
package/dist/vite/index.d.ts.map +0 -1
package/dist/vite/index.js.map +0 -1
package/dist/vite/index.named-routes.gen.ts +0 -103
package/dist/vite/package-resolution.d.ts +0 -43
package/dist/vite/package-resolution.d.ts.map +0 -1
package/dist/vite/package-resolution.js +0 -112
package/dist/vite/package-resolution.js.map +0 -1
package/dist/vite/virtual-entries.d.ts +0 -25
package/dist/vite/virtual-entries.d.ts.map +0 -1
package/dist/vite/virtual-entries.js +0 -110
package/dist/vite/virtual-entries.js.map +0 -1
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/composability/SKILL.md CHANGED Viewed

@@ -55,7 +55,9 @@ import { cache, revalidate, loading, errorBoundary, middleware } from "@rangojs/
 // Shared caching configuration
 const withCaching = () => [
   cache({ ttl: 600_000 }),
-  revalidate(({ actionId }) => !!actionId),
+  // Defer on navigation (|| undefined) so each route keeps its own param/search
+  // revalidation default; only force a re-run when an action ran.
+  revalidate(({ actionId }) => (actionId ? true : undefined)),
 ];
 // Shared loading and error handling
@@ -71,6 +73,29 @@ const withAuth = () => [
 ];
 ```
+> **Factories compose logic, not just values.** A `revalidate()` predicate in a
+> shared factory applies its logic to _every_ route that composes it, so a
+> footgun here is amplified across the app. Two rules:
+>
+> 1. Use `|| undefined` (defer), not `?? false` (hard short-circuit), in shared
+>    predicates — a hard `false` ends the chain and overrides each consuming
+>    route's own default, and a downstream revalidator never runs. See `/loader`
+>    → "`|| undefined` (defer) vs `?? false` (hard)".
+> 2. Match actions with `ctx.isAction(Action)`, not an inline
+>    `actionId.includes("…")` buried in a factory: it resolves the action from an
+>    imported reference, so a rename is a compile error in one place instead of
+>    silent drift across every consumer.
+>
+> Remember the axis: a factory's `revalidate()` controls client-update
+> selection, while its `cache()` controls stored-value freshness. They are
+> independent even when bundled in the same factory (`/cache-guide` → "Two axes").
+> **Keep factories small and intention-named.** The anti-pattern that kills
+> readability is over-bundling — a `withDefaults()` that secretly adds five
+> things — and factory-of-factories nesting (leaning on `.flat(3)`). Surprising
+> config stays inline; extract only the boring, repeated parts; compose by
+> _naming concerns_ (`withAuth()`, `withCaching()`), not by hiding them.
 ## Using Factories in Routes
 Place factory calls inside `path()` or `layout()` use callbacks. The returned arrays are flattened automatically (up to 3 levels):
@@ -107,7 +132,7 @@ import { authMiddleware } from "./middleware/auth";
 export const withPublicDefaults = () => [
   cache({ ttl: 300 }),
-  revalidate(({ actionId }) => !!actionId),
+  revalidate(({ actionId }) => (actionId ? true : undefined)),
 ];
 export const withProtectedDefaults = () => [

package/skills/css/SKILL.md ADDED Viewed

@@ -0,0 +1,76 @@
+---
+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.
+argument-hint:
+---
+# CSS imports
+Document/app CSS in Rango lives in the Document `<head>`, loaded with Vite's
+`?url` import and a `precedence`-managed `<link rel="stylesheet">`. This page is
+the why and the one cross-app caveat; `/tailwind` is the concrete setup, `/theme`
+is dark mode, `/fonts` is fonts.
+## The pattern
+```tsx
+// document.tsx
+"use client";
+import type { ReactNode } from "react";
+import { MetaTags } from "@rangojs/router/client";
+import styles from "./index.css?url";
+export function Document({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <head>
+        <link rel="preload" href={styles} as="style" precedence="default" />
+        <link rel="stylesheet" href={styles} precedence="default" />
+        <MetaTags />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+- **`?url`** returns the processed file's hashed URL instead of injecting it as a
+  side effect, giving a stable asset path that works in dev and production.
+- **`precedence`** opts the `<link rel="stylesheet">` into React 19's managed
+  stylesheet model: React de-duplicates it by `href`, orders it by precedence
+  (any string value — it only decides cascade order relative to other managed
+  sheets), and loads it **before paint**, so there is no flash of unstyled
+  content. This is the recommended way to render a stylesheet link.
+## Cross-app (host-router) navigation
+You do **not** need to coordinate CSS across apps mounted under one host router.
+A client-side navigation that crosses an app boundary is a **full document load**
+(the server returns `X-RSC-Reload` on an app switch — see `/host-router`), so the
+target app's entire document — its stylesheets, theme, meta — is re-established
+by the target app's own load. Each app owns its document; how one app renders a
+stylesheet has no effect on another.
+(This replaced an earlier soft cross-app swap. Under it, a stylesheet shared
+across apps by `href` — classically every app's `@import "tailwindcss"` compiling
+to one hashed asset — could be silently dropped by React's by-`href` resource
+dedup when the apps disagreed on `precedence` (one unmanaged, one managed). The
+full reload removes that footgun entirely, which is the main reason cross-app
+navigation is a hard boundary.)
+## Side-effect imports vs `?url`
+A bare `import "./index.css"` (no `?url`, no `<link>`) also produces _managed_ CSS
+— `@vitejs/plugin-rsc` collects it via `import.meta.viteRsc.loadCss` and injects
+it with a precedence. It is fine for **component-local** CSS that loads with its
+client chunk. For **document-level** CSS, prefer the `?url` + `<link precedence>`
+form above: a side-effect import is not guaranteed to be in the initial streamed
+`<head>` (an SSR-streaming caveat), whereas the explicit `<link>` is.
+## Related
+- `/tailwind` — Tailwind v4 setup using this pattern.
+- `/host-router` — multi-app routing; why cross-app navigation is a full reload.
+- `/theme` — dark mode / theme attribute.
+- `/fonts` — self-hosted fonts via `@fontsource`.

package/skills/debug-manifest/SKILL.md CHANGED Viewed

@@ -13,10 +13,10 @@ Inspect the route manifest to verify parent relationships, shortCodes, and route
 In development, visit:
 ```
-http://localhost:PORT/__debug_manifest
+http://localhost:PORT/?__debug_manifest
 ```
-Returns formatted JSON with all routes and layouts.
+Returns formatted JSON. The HTTP endpoint shape is `{ routerId, routeManifest, routeAncestry, routeTrie, precomputedEntries }` (see below for the programmatic API shape).
 ## Programmatic Access
@@ -32,6 +32,8 @@ if (process.env.NODE_ENV !== "production") {
 ## Manifest Structure
+The programmatic `router.debugManifest()` call returns `{ routes, layouts, totalRoutes, totalLayouts }`:
 ```json
 {
   "routes": {

package/skills/document-cache/SKILL.md CHANGED Viewed

@@ -10,73 +10,82 @@ Caches complete HTTP responses (HTML/RSC) at the edge based on Cache-Control hea
 ## Setup
-Configure document cache in router:
+Document caching is a middleware. Add `createDocumentCacheMiddleware()` to the
+router with `.use()`. The cache store it reads from is the app-level store you
+configure on `createRouter({ cache })` (available on the request context as
+`requestCtx._cacheStore`), not a store passed to the middleware.
 ```typescript
 import { createRouter } from "@rangojs/router";
-import { CFCacheStore } from "@rangojs/router/cache";
+import {
+  createDocumentCacheMiddleware,
+  CFCacheStore,
+} from "@rangojs/router/cache";
 import { urlpatterns } from "./urls";
 const router = createRouter<AppBindings>({
   document: Document,
   urls: urlpatterns,
-  documentCache: (_env, ctx) => ({
-    store: new CFCacheStore({ ctx: ctx! }),
+  // App-level cache store. The document cache middleware uses this store's
+  // getResponse/putResponse methods.
+  cache: (_env, ctx) => ({ store: new CFCacheStore({ ctx: ctx! }) }),
+});
+router.use(
+  createDocumentCacheMiddleware({
     skipPaths: ["/api", "/admin"],
     debug: process.env.NODE_ENV === "development",
   }),
-});
+);
 export default router;
 ```
-## Route Opt-In with cache()
+## Route Opt-In with Cache-Control
-Routes opt-in to document caching using the `cache()` DSL with `documentCache` option:
+Routes opt-in to document caching by setting a `Cache-Control` response header
+with `s-maxage`. The middleware caches responses whose `Cache-Control` includes
+`s-maxage`; `stale-while-revalidate` enables background revalidation (SWR).
 ```typescript
-import { urls } from "@rangojs/router";
-export const urlpatterns = urls(({ path, cache }) => [
-  // Cache full page for 5 min, serve stale for 1 hour
-  cache({ documentCache: { sMaxAge: 300, swr: 3600 } }, () => [
-    path("/blog", BlogIndex, { name: "blog" }),
-  ]),
-  // Long cache for individual posts
-  cache({ documentCache: { sMaxAge: 3600, swr: 86400 } }, () => [
-    path("/blog/:slug", BlogPost, { name: "blogPost" }),
-  ]),
-  // No cache for dashboard (no documentCache option)
-  path("/dashboard", Dashboard, { name: "dashboard" }),
-]);
+// Cache full page for 5 min, serve stale for 1 hour
+function BlogIndexHandler(ctx) {
+  ctx.headers.set("Cache-Control", "s-maxage=300, stale-while-revalidate=3600");
+  return <BlogIndex />;
+}
+// Long cache for individual posts
+function BlogPostHandler(ctx) {
+  ctx.headers.set("Cache-Control", "s-maxage=3600, stale-while-revalidate=86400");
+  return <BlogPost />;
+}
+// Dashboard sets no Cache-Control header, so it is never document-cached.
 ```
 ## Document Cache Options
-```typescript
-createRouter({
-  // ...
-  documentCache: (_env, ctx) => ({
-    // Cache store (required)
-    store: new CFCacheStore({ ctx: ctx! }),
+`createDocumentCacheMiddleware(options?)` accepts:
-    // Skip specific paths
-    skipPaths: ["/api", "/admin"],
+```typescript
+createDocumentCacheMiddleware({
+  // Skip specific paths (matched by pathname prefix)
+  skipPaths: ["/api", "/admin"],
-    // Custom cache key
-    keyGenerator: (url) => url.pathname,
+  // Custom cache key generator
+  keyGenerator: (url) => url.pathname,
-    // Conditional caching
-    isEnabled: (ctx) => !ctx.request.headers.has("x-preview"),
+  // Conditional caching, evaluated per request
+  isEnabled: (ctx) => !ctx.request.headers.has("x-preview"),
-    // Debug logging
-    debug: true,
-  }),
+  // Debug logging (HIT, MISS, STALE, REVALIDATED)
+  debug: true,
 });
 ```
+The cache store is not a middleware option — it comes from the app-level
+`createRouter({ cache })` store.
 ## How It Works
 ```
@@ -89,7 +98,7 @@ Request → Check Cache
     ↓             ↓
   Fresh?      Run handler
     │             │
-   Yes → Return   Has documentCache?
+   Yes → Return   Has s-maxage?
     │             │
    No (stale)    Yes → Cache + Return
     │             │
@@ -120,13 +129,14 @@ Segment hash ensures different cached responses for navigations from different s
 - Full HTML responses (document requests)
 - RSC payloads (client navigation)
-- Only 200 OK responses with documentCache enabled
+- Only 200 OK responses whose `Cache-Control` includes `s-maxage`
 ## What's NOT Cached
 - Server actions (`_rsc_action`)
 - Loader requests (`_rsc_loader`)
-- Routes without `documentCache` option
+- Non-GET requests
+- Responses without an `s-maxage` `Cache-Control` directive
 - Non-200 responses
 ## Complete Example
@@ -134,40 +144,53 @@ Segment hash ensures different cached responses for navigations from different s
 ```typescript
 // router.tsx
 import { createRouter } from "@rangojs/router";
-import { CFCacheStore } from "@rangojs/router/cache";
+import { createDocumentCacheMiddleware, CFCacheStore } from "@rangojs/router/cache";
 import { urlpatterns } from "./urls";
 const router = createRouter<AppBindings>({
   document: Document,
   urls: urlpatterns,
-  documentCache: (_env, ctx) => ({
-    store: new CFCacheStore({ ctx: ctx! }),
+  cache: (_env, ctx) => ({ store: new CFCacheStore({ ctx: ctx! }) }),
+});
+router.use(
+  createDocumentCacheMiddleware({
     skipPaths: ["/api"],
     debug: process.env.NODE_ENV === "development",
   }),
-});
+);
 export default router;
 // urls.tsx
 import { urls } from "@rangojs/router";
-export const urlpatterns = urls(({ path, layout, cache, loader }) => [
-  // Blog with document caching
-  cache({ documentCache: { sMaxAge: 300, swr: 3600 } }, () => [
-    layout(<BlogLayout />, () => [
-      path("/blog", BlogIndex, { name: "blog" }),
-      path("/blog/:slug", BlogPost, { name: "blogPost" }, () => [
-        loader(BlogPostLoader),
-      ]),
+export const urlpatterns = urls(({ path, layout, loader }) => [
+  // Blog pages opt into document caching via Cache-Control headers set in
+  // their handlers (see BlogIndex / BlogPost below).
+  layout(<BlogLayout />, () => [
+    path("/blog", BlogIndex, { name: "blog" }),
+    path("/blog/:slug", BlogPost, { name: "blogPost" }, () => [
+      loader(BlogPostLoader),
     ]),
   ]),
-  // Dashboard - no document cache (dynamic content)
+  // Dashboard sets no Cache-Control header, so it is never document-cached.
   layout(<DashboardLayout />, () => [
     path("/dashboard", Dashboard, { name: "dashboard" }),
   ]),
 ]);
+// Blog handlers set s-maxage to opt into the document cache.
+function BlogIndex(ctx) {
+  ctx.headers.set("Cache-Control", "s-maxage=300, stale-while-revalidate=3600");
+  return <BlogIndexPage />;
+}
+function BlogPost(ctx) {
+  ctx.headers.set("Cache-Control", "s-maxage=300, stale-while-revalidate=3600");
+  return <BlogPostPage />;
+}
 ```
 ## Document Cache vs Segment Cache
@@ -175,7 +198,7 @@ export const urlpatterns = urls(({ path, layout, cache, loader }) => [
 | Feature      | Document Cache             | Segment Cache         |
 | ------------ | -------------------------- | --------------------- |
 | Granularity  | Full response              | Individual segments   |
-| Opt-in       | `documentCache` in cache() | `cache({ ttl, swr })` |
+| Opt-in       | `Cache-Control` `s-maxage` | `cache({ ttl, swr })` |
 | Use case     | Static pages               | Dynamic compositions  |
 | Key includes | URL + segment hash         | Route params          |