npm - @rangojs/router - Versions diffs - 0.0.0-experimental.7a20d911 → 0.0.0-experimental.7cf4e116 - Mend

@rangojs/router 0.0.0-experimental.7a20d911 → 0.0.0-experimental.7cf4e116

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

package/AGENTS.md +8 -0
package/README.md +169 -31
package/dist/bin/rango.js +312 -93
package/dist/testing/vitest.js +82 -0
package/dist/vite/index.js +2974 -1019
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 +224 -32
package/skills/caching/SKILL.md +279 -17
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 +247 -17
package/skills/loader/SKILL.md +225 -9
package/skills/middleware/SKILL.md +50 -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 +77 -7
package/skills/prerender/SKILL.md +45 -43
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 +70 -5
package/skills/router-setup/SKILL.md +29 -6
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 +322 -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 +0 -65
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/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 +92 -18
package/src/browser/navigation-client.ts +146 -69
package/src/browser/navigation-store-handle.ts +38 -0
package/src/browser/navigation-store.ts +33 -59
package/src/browser/navigation-transaction.ts +9 -59
package/src/browser/network-error-handler.ts +34 -7
package/src/browser/partial-update.ts +131 -121
package/src/browser/prefetch/cache.ts +205 -62
package/src/browser/prefetch/fetch.ts +321 -37
package/src/browser/prefetch/queue.ts +42 -8
package/src/browser/rango-state.ts +158 -76
package/src/browser/react/Link.tsx +60 -9
package/src/browser/react/NavigationProvider.tsx +162 -118
package/src/browser/react/ScrollRestoration.tsx +10 -6
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 +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 +25 -3
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 +91 -24
package/src/browser/scroll-restoration.ts +30 -17
package/src/browser/segment-reconciler.ts +36 -14
package/src/browser/segment-structure-assert.ts +2 -2
package/src/browser/server-action-bridge.ts +214 -55
package/src/browser/types.ts +57 -8
package/src/browser/validate-redirect-origin.ts +43 -16
package/src/build/collect-fallback-refs.ts +107 -0
package/src/build/generate-manifest.ts +60 -35
package/src/build/generate-route-types.ts +2 -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 +117 -23
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 +55 -28
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 +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 +199 -37
package/src/cache/cache-scope.ts +188 -82
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/types.ts +37 -100
package/src/client.rsc.tsx +44 -21
package/src/client.tsx +118 -235
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 +18 -6
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 +31 -23
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 +90 -11
package/src/index.ts +129 -19
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 +32 -37
package/src/prerender.ts +61 -6
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 -36
package/src/root-error-boundary.tsx +1 -19
package/src/route-content-wrapper.tsx +7 -72
package/src/route-definition/dsl-helpers.ts +418 -273
package/src/route-definition/helper-factories.ts +29 -139
package/src/route-definition/helpers-types.ts +103 -31
package/src/route-definition/redirect.ts +44 -11
package/src/route-definition/resolve-handler-use.ts +12 -0
package/src/route-definition/use-item-types.ts +32 -0
package/src/route-map-builder.ts +0 -16
package/src/route-types.ts +26 -41
package/src/router/basename.ts +14 -0
package/src/router/content-negotiation.ts +73 -25
package/src/router/error-handling.ts +45 -18
package/src/router/find-match.ts +44 -23
package/src/router/handler-context.ts +27 -39
package/src/router/instrument.ts +350 -0
package/src/router/intercept-resolution.ts +39 -20
package/src/router/lazy-includes.ts +15 -52
package/src/router/loader-resolution.ts +198 -92
package/src/router/logging.ts +0 -6
package/src/router/manifest.ts +40 -42
package/src/router/match-api.ts +4 -23
package/src/router/match-context.ts +0 -22
package/src/router/match-handlers.ts +58 -58
package/src/router/match-middleware/background-revalidation.ts +6 -7
package/src/router/match-middleware/cache-lookup.ts +164 -285
package/src/router/match-middleware/cache-store.ts +31 -34
package/src/router/match-middleware/intercept-resolution.ts +0 -22
package/src/router/match-middleware/segment-resolution.ts +1 -23
package/src/router/match-pipelines.ts +1 -42
package/src/router/match-result.ts +87 -39
package/src/router/metrics.ts +0 -34
package/src/router/middleware-types.ts +7 -134
package/src/router/middleware.ts +266 -166
package/src/router/navigation-snapshot.ts +0 -51
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 +104 -65
package/src/router/preview-match.ts +3 -1
package/src/router/request-classification.ts +28 -62
package/src/router/revalidation.ts +123 -73
package/src/router/route-snapshot.ts +0 -1
package/src/router/router-context.ts +3 -28
package/src/router/router-interfaces.ts +83 -35
package/src/router/router-options.ts +136 -5
package/src/router/router-registry.ts +2 -5
package/src/router/segment-resolution/fresh.ts +98 -84
package/src/router/segment-resolution/helpers.ts +86 -6
package/src/router/segment-resolution/loader-cache.ts +62 -37
package/src/router/segment-resolution/revalidation.ts +274 -319
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 +9 -63
package/src/router/url-params.ts +44 -0
package/src/router.ts +110 -55
package/src/rsc/handler-context.ts +3 -2
package/src/rsc/handler.ts +279 -224
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 +28 -41
package/src/rsc/origin-guard.ts +39 -25
package/src/rsc/progressive-enhancement.ts +73 -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 +104 -76
package/src/rsc/runtime-warnings.ts +23 -10
package/src/rsc/server-action.ts +262 -113
package/src/rsc/ssr-setup.ts +16 -0
package/src/rsc/types.ts +24 -5
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 +175 -53
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 +21 -42
package/src/server/request-context.ts +258 -170
package/src/ssr/index.tsx +21 -16
package/src/static-handler.ts +10 -13
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 +13 -4
package/src/types/error-types.ts +30 -90
package/src/types/global-namespace.ts +54 -41
package/src/types/handler-context.ts +109 -61
package/src/types/index.ts +1 -10
package/src/types/loader-types.ts +11 -9
package/src/types/request-scope.ts +112 -0
package/src/types/route-config.ts +6 -50
package/src/types/route-entry.ts +11 -6
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 +49 -9
package/src/urls/path-helper.ts +17 -106
package/src/urls/pattern-types.ts +36 -19
package/src/urls/response-types.ts +22 -29
package/src/urls/type-extraction.ts +58 -139
package/src/urls/urls-function.ts +1 -18
package/src/use-loader.tsx +295 -107
package/src/vite/debug.ts +185 -0
package/src/vite/discovery/bundle-postprocess.ts +8 -7
package/src/vite/discovery/discover-routers.ts +126 -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 +211 -142
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 +44 -0
package/src/vite/discovery/virtual-module-codegen.ts +14 -34
package/src/vite/index.ts +2 -0
package/src/vite/inject-client-debug.ts +36 -0
package/src/vite/plugin-types.ts +126 -8
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 +26 -25
package/src/vite/plugins/refresh-cmd.ts +1 -1
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 +109 -118
package/src/vite/router-discovery.ts +777 -119
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 +67 -38
package/src/vite/utils/shared-utils.ts +90 -41
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.bak +0 -5448
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/migrate-nextjs/SKILL.md ADDED Viewed

@@ -0,0 +1,584 @@
+---
+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.
+argument-hint: [path-to-nextjs-app]
+---
+# Migrate from Next.js App Router to @rangojs/router
+## Why Rango
+Common reasons to migrate:
+- **Server components by default** — keep data fetching on the server without
+  framework-specific file conventions.
+  See: `/router-setup`, `/route`
+- **Django-style route definition** — `urls()`, `path()`, and `layout()` make
+  the route tree explicit instead of spreading routing across many special files.
+  See: `/route`, `/layout`
+- **Named routes** — reverse URLs by route name instead of hard-coding path
+  strings throughout the app.
+  See: `/links`, `/typesafety`
+- **Clear execution model** — request scope, render scope, segment boundaries,
+  and shared `ctx` behavior are explicit in the routing model.
+  See: `/middleware`, `/loader`
+- **Live data layer** — `createLoader()` and `loader()` keep data fresh
+  independently of cached UI. A route can serve cached segments while loaders
+  still resolve live on every request.
+  See: `/loader`, `/caching`, `/cache-guide`
+- **Explicit caching model** — `cache()` DSL, `revalidate()`, `use cache`, and
+  custom cache stores make caching and revalidation behavior visible in code.
+  See: `/caching`, `/cache-guide`, `/use-cache`
+- **Build-time rendering** — `Static()` and `Prerender()` provide explicit
+  build-time rendering instead of mixing rendering and caching behind conventions.
+  See: `/prerender`
+- **Composable route tree** — layouts, includes, middleware, parallels, and
+  intercepts compose directly in the route definition.
+  See: `/composability`, `/parallel`, `/intercept`
+- **Multi-router flexibility** — support multiple routers, domain routing, and
+  worker/edge-style deployment patterns.
+  See: `/host-router`
+## Migration Strategy
+Work route-by-route, bottom-up. Start with leaf pages, then layouts, then middleware. Verify each route works before moving to the next.
+## 1. Project Setup
+Replace Next.js tooling with Vite + Rango:
+```bash
+npm remove next @next/env
+npm install @rangojs/router @vitejs/plugin-react
+npm install -D vite
+```
+```typescript
+// vite.config.ts
+import { defineConfig } from "vite";
+import { rango } from "@rangojs/router/vite";
+export default defineConfig({
+  plugins: [rango()],
+});
+```
+```typescript
+// src/router.tsx
+import { createRouter } from "@rangojs/router";
+import { Document } from "./document";
+import { urlpatterns } from "./urls";
+export default createRouter({
+  document: Document,
+}).routes(urlpatterns);
+```
+The Document component replaces `app/layout.tsx`'s `<html>` wrapper. See `/router-setup` for full config options.
+## 2. Route Mapping
+### File-based → URL pattern DSL
+| Next.js file path               | Rango equivalent                                           |
+| ------------------------------- | ---------------------------------------------------------- |
+| `app/page.tsx`                  | `path("/", HomePage, { name: "home" })`                    |
+| `app/about/page.tsx`            | `path("/about", AboutPage, { name: "about" })`             |
+| `app/blog/[slug]/page.tsx`      | `path("/blog/:slug", BlogPost, { name: "blogPost" })`      |
+| `app/shop/[...path]/page.tsx`   | `path("/shop/:path+", CatchAll, { name: "shopCatchAll" })` |
+| `app/docs/[[...slug]]/page.tsx` | `path("/docs/:slug*", Docs, { name: "docs" })`             |
+### Layouts
+```typescript
+// Next.js: app/dashboard/layout.tsx
+export default function DashboardLayout({ children }) {
+  return <div className="dashboard">{children}</div>;
+}
+// Rango:
+import { Outlet } from "@rangojs/router/client";
+function DashboardLayout() {
+  return (
+    <div className="dashboard">
+      <Outlet />
+    </div>
+  );
+}
+// In urls.tsx:
+layout(<DashboardLayout />, () => [
+  path("/dashboard", DashboardIndex, { name: "dashboard" }),
+  path("/dashboard/settings", Settings, { name: "settings" }),
+])
+```
+Key difference: Rango layouts use `<Outlet />` instead of `{children}`. Layouts are server components by default.
+### Dynamic layouts (with data)
+```typescript
+// Next.js: app/dashboard/layout.tsx
+export default async function DashboardLayout({ children }) {
+  const user = await getUser();
+  return <Shell user={user}>{children}</Shell>;
+}
+// Rango: handler function layout
+layout(async (ctx) => {
+  const user = ctx.get("user");
+  return (
+    <Shell user={user}>
+      <Outlet />
+    </Shell>
+  );
+}, () => [
+  path("/dashboard", DashboardIndex, { name: "dashboard" }),
+])
+```
+### Route groups
+Next.js `app/(marketing)/page.tsx` route groups have no URL segment. In Rango, just organize with `include()`:
+```typescript
+// src/urls/marketing.tsx
+export const marketingPatterns = urls(({ path }) => [
+  path("/", LandingPage, { name: "landing" }),
+  path("/pricing", PricingPage, { name: "pricing" }),
+]);
+// src/urls.tsx
+include("/", marketingPatterns, { name: "marketing" }),
+```
+### Parallel routes
+In Next.js, `@sidebar` and `@main` are both named slots. In Rango, the main content
+renders through `<Outlet />` (the path handler), and only extra slots use `parallel()` +
+`<ParallelOutlet />`:
+```typescript
+// Next.js: app/layout.tsx renders {sidebar} and {children}
+//          app/@sidebar/page.tsx provides the sidebar slot
+//          app/page.tsx provides the main content
+// Rango: main content is the path handler, sidebar is a parallel slot
+layout(
+  () => (
+    <div className="dashboard">
+      <ParallelOutlet name="@sidebar" />
+      <Outlet />
+    </div>
+  ),
+  () => [
+    parallel({
+      "@sidebar": <Sidebar />,
+    }),
+    path("/dashboard", DashboardPage, { name: "dashboard" }),
+  ],
+)
+```
+Only add `parallel()` slots for content that renders alongside the main route.
+The main content always goes through `<Outlet />` via the `path()` handler.
+### Intercepting routes
+```typescript
+// Next.js: app/(.)product/[id]/page.tsx
+// (convention: (.) means same level, (..) parent level)
+// Rango: explicit intercept in layout
+layout(<ShopLayout />, () => [
+  path("/product/:id", ProductPage, { name: "product" }),
+  intercept("@modal", ".product", <ProductModal />, () => [
+    when(({ from }) => from.pathname.startsWith("/shop")),
+  ]),
+])
+```
+## 3. Data Fetching
+### Server component data fetching
+Inline `fetch()` or direct DB calls in server components work as-is — no migration needed:
+```typescript
+// Next.js:
+async function ProductPage({ params }) {
+  const product = await fetch(`/api/products/${params.slug}`).then(r => r.json());
+  return <div>{product.name}</div>;
+}
+// Rango: same pattern, params come from ctx
+const ProductPage: Handler<"product"> = async (ctx) => {
+  const product = await fetch(`/api/products/${ctx.params.slug}`).then(r => r.json());
+  return <div>{product.name}</div>;
+};
+```
+### When to use createLoader
+Loaders are Rango's live data layer. Use them when you need:
+- **Client-side data refresh** — `useLoader()` in client components for reactive data
+- **Per-loader caching** — opt in with `loader(MyLoader, () => [cache({ ttl: 60 })])`; loaders stay live by default
+- **Revalidation control** — `revalidate()` targets specific segments and loaders after actions
+- **Loading skeletons** — `loading()` shows a Suspense fallback while loaders resolve
+```typescript
+import { createLoader } from "@rangojs/router";
+export const ProductLoader = createLoader(async (ctx) => {
+  return await db.getProduct(ctx.params.slug);
+});
+// In urls:
+path("/product/:slug", ProductPage, { name: "product" }, () => [
+  loader(ProductLoader),
+  loading(<ProductSkeleton />),
+])
+```
+If the existing fetch pattern works and you don't need these features, leave it as-is. See `/loader` for full API.
+### generateStaticParams → Prerender + Passthrough
+Plain `Prerender` only serves the listed params — unlisted params get no live
+fallback in production (the handler is evicted). If the Next.js route serves
+params outside the generated set at runtime, wrap with `Passthrough()`:
+```typescript
+// Next.js:
+export async function generateStaticParams() {
+  return [{ slug: "a" }, { slug: "b" }];
+}
+// Rango (build-only, no live fallback for unlisted params):
+import { Prerender } from "@rangojs/router";
+export const ProductDef = Prerender<{ slug: string }>(
+  async () => [{ slug: "a" }, { slug: "b" }],
+  async (ctx) => {
+    const product = await getProduct(ctx.params.slug);
+    return <ProductPage product={product} />;
+  },
+);
+// Rango (with live fallback — matches Next.js dynamicParams behavior):
+import { Prerender, Passthrough } from "@rangojs/router";
+const ProductDef = Prerender<{ slug: string }>(
+  async () => [{ slug: "a" }, { slug: "b" }],
+  async (ctx) => {
+    const product = await getProduct(ctx.params.slug);
+    if (!product) return ctx.passthrough();
+    return <ProductPage product={product} />;
+  },
+);
+export const Product = Passthrough(ProductDef, async (ctx) => {
+  const product = await getProduct(ctx.params.slug);
+  return <ProductPage product={product} />;
+});
+```
+Use `Passthrough()` whenever the Next.js route has `dynamicParams: true` (the
+default) or serves an open-ended param space. See `/prerender` for full API.
+### Revalidation: two distinct axes
+Next.js conflates two things under "revalidation." Rango separates them — and
+tag-based cache invalidation now maps directly.
+**1. Cache invalidation (bust cached values) — direct equivalent.** Tag entries
+with `cache({ tags })` or, inside a `"use cache"` function, runtime
+`cacheTag(...tags)`. Then invalidate by tag:
+```typescript
+// Next.js                    Rango
+// revalidateTag("products")  →  await updateTag("products")  // in a server action: awaitable,
+//                                                            // read-your-own-writes (next render is fresh)
+//                            or  revalidateTag("products")    // in a route handler / webhook:
+//                                                            // background, non-blocking (hard-purge)
+```
+`updateTag` is awaitable and immediate; `revalidateTag` is fire-and-forget. Both
+hard-purge (the next read re-renders fresh); the only difference is awaitability —
+despite the Next.js name, `revalidateTag` here is NOT stale-while-revalidate.
+Built-in stores (`MemorySegmentCacheStore`, `CFCacheStore`) index by tag. Next's
+`revalidatePath` has no path-based equivalent — tag the relevant entries instead.
+**2. Partial-render selection (which segments re-run after an action).** This is
+NOT cache invalidation — it is `revalidate()`, controlling which segments
+(layouts, paths, loaders, parallels) recompute during partial action
+re-rendering:
+```typescript
+import { updateBlog } from "./actions/blog";
+// Re-run this layout when a blog action fires
+layout(BlogLayout, () => [
+  revalidate((ctx) => ctx.isAction(updateBlog) || undefined),
+  path("/blog/:slug", BlogPost, { name: "blogPost" }),
+]);
+// Re-run sidebar parallel when params change
+parallel({ "@sidebar": BlogSidebar }, () => [
+  revalidate(
+    ({ currentParams, nextParams }) => currentParams.slug !== nextParams.slug,
+  ),
+]);
+```
+**Server-side caching** — `cache()` DSL, loader-level `cache()`, and `"use cache"`
+control what gets cached and for how long. This is separate from `revalidate()`:
+```typescript
+cache({ ttl: 60, swr: 300 }, () => [
+  path("/blog/:slug", BlogPost, { name: "blogPost" }),
+]);
+```
+The two axes compose: `updateTag()` / `revalidateTag()` bust cached values;
+`revalidate()` selects which segments re-render and stream to the client after an
+action.
+When migrating:
+- `revalidateTag(tag)` → `await updateTag(tag)` (in a server action) or
+  `revalidateTag(tag)` (in a route handler / webhook). Effectively 1:1.
+- `revalidatePath(path)` → no path-based equivalent; tag the entries on that
+  route (`cache({ tags })` / `cacheTag(...)`) and invalidate by tag.
+- To also force specific segments to re-render after the action (independent of
+  cache busting), attach a `revalidate()` rule at those segment boundaries.
+## 4. Middleware
+Next.js `middleware.ts` wraps the entire request — including server actions.
+The direct equivalent is `router.use()`, not the DSL `middleware()`:
+```typescript
+// Next.js: middleware.ts (file-convention, wraps all requests)
+import { NextResponse } from "next/server";
+export function middleware(request) {
+  if (!request.cookies.get("session")) {
+    return NextResponse.redirect(new URL("/login", request.url));
+  }
+}
+export const config = { matcher: ["/dashboard/:path*"] };
+// Rango: split into initialisation (global) + guard (scoped)
+import { redirect, cookies } from "@rangojs/router";
+import type { Middleware } from "@rangojs/router";
+// Runs on every request — resolves the session for all routes
+const authInit: Middleware = async (ctx, next) => {
+  const session = cookies().get("session")?.value;
+  if (session) {
+    const user = await verifySession(session);
+    ctx.set("user", user);
+  }
+  await next();
+};
+// Scoped guard — redirects unauthenticated users
+const requireAuth: Middleware = async (ctx, next) => {
+  if (!ctx.get("user")) {
+    return redirect("/login");
+  }
+  await next();
+};
+const router = createRouter({})
+  .use(authInit) // all routes — sets ctx user
+  .use("/dashboard/*", requireAuth) // dashboard only — redirects
+  .routes(urlpatterns);
+```
+**Rango has two middleware levels with different scopes:**
+|                    | `router.use()`                       | `middleware()` in DSL           |
+| ------------------ | ------------------------------------ | ------------------------------- |
+| Wraps              | Entire request (actions + rendering) | Rendering only                  |
+| Use for            | Auth guards, logging, CORS           | Context shaping, render headers |
+| Next.js equivalent | `middleware.ts`                      | No direct equivalent            |
+Use `router.use()` for auth guards — it wraps the full request including actions.
+DSL `middleware()` can also guard rendering (e.g. redirect unauthenticated users
+away from a page), but it does not protect actions on that route. For full auth
+coverage, prefer `router.use()`. See `/middleware`.
+## 5. Loading & Error States
+```typescript
+// Next.js: app/dashboard/loading.tsx
+export default function Loading() { return <Skeleton />; }
+// Rango:
+path("/dashboard", DashboardPage, { name: "dashboard" }, () => [
+  loading(<Skeleton />),
+])
+```
+```typescript
+// Next.js: app/dashboard/error.tsx wraps all routes under /dashboard
+"use client";
+export default function Error({ error, reset }) { ... }
+// Rango: errorBoundary wrapping a group of routes
+layout(<DashboardLayout />, () => [
+  errorBoundary(({ error, reset }) => (
+    <div>
+      <h2>Something went wrong</h2>
+      <button onClick={reset}>Try again</button>
+    </div>
+  )),
+  path("/dashboard", DashboardIndex, { name: "dashboard" }),
+  path("/dashboard/settings", Settings, { name: "settings" }),
+])
+```
+```typescript
+// Next.js: app/not-found.tsx
+export default function NotFound() { ... }
+// Rango (app-level — no route match, or notFound() without a boundary):
+createRouter({
+  notFound: ({ pathname }) => <NotFoundPage pathname={pathname} />,
+})
+// Rango (route-level — notFoundBoundary wrapping a group of routes):
+layout(<ShopLayout />, () => [
+  notFoundBoundary(({ notFound: info }) => (
+    <div>
+      <h2>Not Found</h2>
+      <p>{info.message}</p>
+    </div>
+  )),
+  path("/product/:slug", ProductPage, { name: "product" }),
+  path("/product/:slug/reviews", ReviewsPage, { name: "reviews" }),
+])
+```
+Both `errorBoundary()` and `notFoundBoundary()` catch errors from all
+children in their scope — handlers, loaders, and nested segments.
+## 6. Navigation
+| Next.js                         | Rango                                             |
+| ------------------------------- | ------------------------------------------------- |
+| `import Link from "next/link"`  | `import { Link } from "@rangojs/router/client"`   |
+| `<Link href="/about">`          | `<Link to="/about">`                              |
+| `useRouter().push("/about")`    | `useRouter().push("/about")`                      |
+| `useRouter().replace("/about")` | `useRouter().replace("/about")`                   |
+| `usePathname()`                 | `usePathname()` from `@rangojs/router/client`     |
+| `useSearchParams()`             | `useSearchParams()` from `@rangojs/router/client` |
+| `redirect("/login")` (server)   | `redirect("/login")` from `@rangojs/router`       |
+## 7. Server Actions
+Server actions work the same way — `"use server"` directive, `useActionState`, form actions. No migration needed for action logic.
+Key difference: in Rango, route middleware does NOT wrap action execution. Actions only see global middleware context. Use `getRequestContext()` in actions to access `ctx.set()`/`ctx.get()`.
+Next.js's `revalidateTag()` maps directly: tag entries via `cache({ tags })` / `cacheTag(...)`, then invalidate. **In a server action use `await updateTag(tag)`** — it is read-your-own-writes, so the action's own re-render sees fresh data; `revalidateTag(tag)` is a background (non-blocking) hard-purge and is NOT read-your-own-writes, so reserve it for route handlers / webhooks (calling it from an action can leave that action's re-render stale). `revalidatePath()` has no path-based equivalent — tag the route's entries instead. Separately, to force specific matched segments (path/layout/parallel/intercept) and their loaders to re-render after an action, attach a `revalidate(({ actionId }) => ...)` rule to that segment or loader registration. See `/server-actions` for the full pattern (validation, error handling, file uploads), `/caching` for tag invalidation, and `/loader` for revalidation rule semantics.
+## 8. Metadata / Head
+Rango uses the `Meta` handle + `<MetaTags />` client component:
+```typescript
+// Next.js: export const metadata = { title: "Home" }
+// Next.js: export function generateMetadata({ params }) { ... }
+// Rango: Meta handle in handlers (server), MetaTags in document <head> (client)
+import { Meta } from "@rangojs/router";
+const HomePage: Handler<"home"> = (ctx) => {
+  const meta = ctx.use(Meta);
+  meta({ title: "Home" });
+  meta({ name: "description", content: "Welcome to the site" });
+  return <div>Home page</div>;
+};
+```
+Add `<MetaTags />` in the Document component's `<head>`:
+```typescript
+import { MetaTags } from "@rangojs/router/client";
+function Document({ children }: { children: ReactNode }) {
+  return (
+    <html>
+      <head>
+        <MetaTags />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+Later routes override earlier ones for the same meta key (deduplication).
+## 9. API Routes
+```typescript
+// Next.js: app/api/users/route.ts
+export async function GET(request) { ... }
+// Rango: response routes
+path.json("/api/users", async (ctx) => {
+  const users = await db.getUsers();
+  return users;
+}, { name: "apiUsers" })
+path.text("/api/health", () => "ok", { name: "apiHealth" })
+```
+See `/response-routes` for full API.
+## 10. Theme / Dark Mode
+If the Next.js app uses `next-themes` or a custom theme provider, replace it
+with Rango's built-in theme system (FOUC prevention included):
+```typescript
+const router = createRouter({
+  theme: true, // or { defaultTheme: "system", attribute: "class" }
+});
+```
+Client components use `useTheme()` to read and toggle:
+```typescript
+"use client";
+import { useTheme } from "@rangojs/router/theme";
+function ThemeToggle() {
+  const { theme, setTheme } = useTheme();
+  return <button onClick={() => setTheme(theme === "dark" ? "light" : "dark")}>{theme}</button>;
+}
+```
+See `/theme` for full API including system detection and cookie persistence.
+## Migration Checklist
+1. [ ] Set up Vite config with `rango()` plugin
+2. [ ] Create Document component (replaces root `<html>` layout)
+3. [ ] Create `router.tsx` with `createRouter()`
+4. [ ] Convert file-based routes to `urls()` DSL in `urls.tsx`
+5. [ ] Migrate layouts to `layout()` with `<Outlet />`
+6. [ ] Convert data fetching to `createLoader()` + `ctx.use()`
+7. [ ] Migrate `middleware.ts` to `router.use()` (auth, guards, logging)
+8. [ ] Replace `next/link` with `Link` from `@rangojs/router/client`
+9. [ ] Convert loading/error files to `loading()` / `errorBoundary()`
+10. [ ] Migrate API routes to `path.json()` / `path.text()`
+11. [ ] Update metadata to use `Meta` handle + `<MetaTags />` in document head
+12. [ ] Replace `next-themes` with `theme: true` in createRouter (see `/theme`)
+13. [ ] Run `npx rango generate src/` to generate route types