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/AGENTS.md CHANGED Viewed

@@ -7,3 +7,11 @@ Run `/rango` to understand the API. Detailed guides for each feature are in the
 ## Development rules
 - Always commit generated files (e.g. `*.gen.ts`) alongside the source changes that produced them.
+## Repo-wide rules (read before pushing)
+This package inherits the repo-wide conventions in the root [`AGENTS.md`](../../AGENTS.md) and [`CLAUDE.md`](../../CLAUDE.md). The ones a package-scoped reader is most likely to miss:
+- **Pre-push gate** — before EVERY push, run all of the following from the **repo root** and fix any failures: `pnpm run typecheck`, `pnpm run test:unit:all`, `pnpm run lint`, `pnpm run format`.
+- **`test:unit:all` is recursive** — it runs the unit AND Flight/RSC suites for every package and consumer app (cloudflare-basic, mini, vite-rsc-demo, ...), not just `@rangojs/router`. A change can pass this package's own tests while breaking a consumer app's `@rangojs/router/testing` dogfood suite, so do not run only `pnpm --filter @rangojs/router test:unit`.
+- **Dev + prod e2e parity is mandatory** — every e2e test must cover BOTH dev and production modes; never add a dev-only test without its production counterpart. See the dev/prod bucketing convention in the root `AGENTS.md`.

package/README.md CHANGED Viewed

@@ -1,6 +1,8 @@
-# @rangojs/router
+# Rango
-Named-route RSC router with structural composability and type-safe partial rendering for Vite.
+React RSC Route Wrangler
+A code-first, type-safe React Server Components router
 > **Experimental:** This package is under active development. APIs may change between releases. Install with `@experimental` tag.
@@ -10,6 +12,7 @@ Named-route RSC router with structural composability and type-safe partial rende
 - **Structural composability** — Attach routes, loaders, middleware, handles, caching, prerendering, and static generation without hiding the route tree
 - **Composable URL patterns** — Django-style `urls()` DSL with `path`, `layout`, `include`
 - **Data loaders** — `createLoader()` with automatic streaming and Suspense integration
+- **Server actions** — `"use server"` mutations with `useActionState`, `useOptimistic`, and per-segment + per-loader `revalidate()` rules
 - **Live data layer** — Pre-render or cache the UI shell while loaders stay live by default at request time
 - **Layouts & nesting** — Nested layouts with `<Outlet />` and parallel routes
 - **Segment-level caching** — `cache()` DSL with TTL/SWR and pluggable cache stores
@@ -124,20 +127,29 @@ export const router = createRouter().routes(urlpatterns);
 "use client";
 import type { ReactNode } from "react";
-import { MetaTags } from "@rangojs/router/client";
+import { MetaTags, Scripts } from "@rangojs/router/client";
 export function Document({ children }: { children: ReactNode }) {
   return (
     <html lang="en">
       <head>
         <MetaTags />
+        <Scripts />
       </head>
-      <body>{children}</body>
+      <body>
+        <Scripts position="body" />
+        {children}
+      </body>
     </html>
   );
 }
 ```
+`<MetaTags />` and `<Scripts />` render the tags collected by the built-in `Meta`
+and `Script` handles (see [Meta Tags](#meta-tags) and [Scripts](#scripts)). The
+built-in `DefaultDocument` already includes all three sites, so this is only
+needed for a custom document.
 ## Defining Routes
 Rango is a named-route router first.
@@ -161,13 +173,18 @@ const urlpatterns = urls(({ path }) => [
 ]);
 ```
-Use `reverse()` as the default way to link to routes:
+Use `ctx.reverse()` from handler context as the default way to link to routes from server code:
 ```tsx
-router.reverse("product", { slug: "widget" }); // "/product/widget"
-router.reverse("search", undefined, { q: "rsc" }); // "/search?q=rsc"
+const ProductPage: Handler<"product"> = (ctx) => {
+  const url = ctx.reverse("product", { slug: "widget" }); // "/product/widget"
+  const searchUrl = ctx.reverse("search", undefined, { q: "rsc" }); // "/search?q=rsc"
+  return <Link to={url}>Widget</Link>;
+};
 ```
+`router.reverse()` (exported from the router module) is the same function without a handler context, useful in scripts or tests. In request code, prefer `ctx.reverse()` — it auto-fills mount params from the current match.
 ### Composable URL Modules
 Local route names compose cleanly with `include(..., { name })`:
@@ -477,41 +494,130 @@ const urlpatterns = urls(({ path, loader }) => [
 ]);
 ```
-## Navigation & Links
+## Server Actions
-### Named Routes with `reverse()` (Server Components)
+Server actions are React's RSC mutation primitive. Define them with the
+`"use server"` directive — Rango uses standard React 19 hooks
+(`useActionState`, `useFormStatus`, `useOptimistic`) with no framework wrapper.
-In server components, use `reverse()` to generate URLs by route name:
+```tsx
+// app/actions/cart.ts
+"use server";
+import { getRequestContext } from "@rangojs/router";
+export async function addToCart(productId: string): Promise<void> {
+  const ctx = getRequestContext();
+  const userId = ctx.get("user").id;
+  await db.cart.insert({ userId, productId });
+}
+```
 ```tsx
-import { Link } from "@rangojs/router/client";
-import { reverse } from "./router";
+// Client form with progressive enhancement + pending state
+"use client";
+import { useActionState } from "react";
+import { saveProfile } from "../actions/profile";
-function BlogIndex() {
+export function ProfileForm() {
+  const [state, action, pending] = useActionState(saveProfile, null);
   return (
-    <nav>
-      <Link to={reverse("home")}>Home</Link>
-      <Link to={reverse("blogPost", { slug: "my-post" })}>My Post</Link>
-      <Link to={reverse("about")}>About</Link>
-    </nav>
+    <form action={action}>
+      <input name="name" defaultValue={state?.values?.name} />
+      {state?.errors?.name && <p role="alert">{state.errors.name}</p>}
+      <button disabled={pending}>{pending ? "Saving…" : "Save"}</button>
+    </form>
   );
 }
 ```
-`reverse()` is type-safe — route names and required params are checked at compile time. Included routes use dotted names: `reverse("api.health")`.
+After an action runs, matched route segments (path/layout/parallel/intercept)
+and loaders can re-render/re-resolve so the UI reflects the new state.
+Attach a `revalidate(({ actionId }) => ...)` rule on any segment or loader
+that owns data the action touched:
-Handlers also have `ctx.reverse()` directly on the context:
+```tsx
+urls(({ path, loader, revalidate }) => [
+  // Segment-level: re-render the cart page handler after cart actions.
+  // Nest loaders that belong to this route inside the same path() so the
+  // segment owns its data dependencies.
+  path("/cart", CartPage, { name: "cart" }, () => [
+    revalidate(
+      ({ actionId }) => actionId?.startsWith("src/actions/cart.ts#") ?? false,
+    ),
+    loader(CartLoader, () => [
+      revalidate(
+        ({ actionId }) => actionId?.startsWith("src/actions/cart.ts#") ?? false,
+      ),
+    ]),
+  ]),
+]);
+```
+For the full guide — validation with Zod, error handling, file uploads,
+`useOptimistic`, redirects, and progressive enhancement — see the
+`/server-actions` skill.
+## Navigation & Links
+### Named Routes with `ctx.reverse()` (Server)
+In server components and handlers, use `ctx.reverse()` to generate URLs by route name. This is the default — it is typed, auto-fills mount params from the current match, and resolves both local (`.name`) and absolute (`name.sub`) names:
 ```tsx
+import { Link } from "@rangojs/router/client";
+import type { Handler } from "@rangojs/router";
 const BlogPostPage: Handler<"blogPost"> = (ctx) => {
   const backUrl = ctx.reverse("blog");
   return <Link to={backUrl}>Back to blog</Link>;
 };
 ```
+`reverse()` is type-safe — route names and required params are checked at compile time. Included routes use dotted names: `ctx.reverse("api.health")`.
+For scripts, tests, or other code without a handler context, import the router-level `reverse`:
+```tsx
+import { reverse } from "./router";
+reverse("blogPost", { slug: "my-post" });
+```
+### Client Components
+**`reverse()` is server-only.** It depends on the route manifest and handler context — neither is available in the browser bundle. Client components receive URLs as props, loader data, or server-action return values:
+```tsx
+// server
+function BlogIndex(ctx: HandlerContext) {
+  return (
+    <Nav
+      home={ctx.reverse("home")}
+      post={ctx.reverse("blogPost", { slug: "my-post" })}
+    />
+  );
+}
+```
+```tsx
+"use client";
+import { Link } from "@rangojs/router/client";
+export function Nav({ home, post }: { home: string; post: string }) {
+  return (
+    <nav>
+      <Link to={home}>Home</Link>
+      <Link to={post}>My Post</Link>
+    </nav>
+  );
+}
+```
+For client-side navigation to static paths (no named-route lookup), use `href()` — see below. For URLs tied to named routes, you have two options: import the per-module generated `routes` map and use `useReverse(routes)` for in-module names (see [`/links` skill](./skills/links/SKILL.md)), or generate the URL on the server and pass the string in for cross-module URLs.
 ### `href()` for Path Validation (Client Components)
-In client components, use `href()` for compile-time path validation:
+In client components, use `href()` for compile-time path validation on static path strings:
 ```tsx
 "use client";
@@ -848,9 +954,9 @@ import { createHostRouter } from "@rangojs/router/host";
 const hostRouter = createHostRouter();
-hostRouter.host(["*.localhost"]).map(() => import("./apps/admin/handler.js"));
-hostRouter.host(["localhost"]).map(() => import("./apps/site/handler.js"));
-hostRouter.fallback().map(() => import("./apps/site/handler.js"));
+hostRouter.host(["*.localhost"]).lazy(() => import("./apps/admin/handler.js"));
+hostRouter.host(["localhost"]).lazy(() => import("./apps/site/handler.js"));
+hostRouter.fallback().lazy(() => import("./apps/site/handler.js"));
 export default {
   async fetch(request, env, ctx) {
@@ -859,7 +965,7 @@ export default {
 };
 ```
-Each sub-app has its own `createRouter()` and `urls()`. The host router lazily imports the matched app's handler. Patterns are matched in registration order — register more specific patterns (subdomains) before catch-alls.
+Use `.lazy(() => import("./sub-app"))` to mount a lazily-imported sub-app (a module whose `default` export is a handler or nested host router), and `.map((request) => Response)` for an inline request handler. Only `.lazy()` mounts are imported during build-time discovery; `.map(() => import(...))` is a type error. Each sub-app has its own `createRouter()` and `urls()`. Patterns are matched in registration order — register more specific patterns (subdomains) before catch-alls.
 ## Meta Tags
@@ -881,6 +987,38 @@ export function BlogPostPage(ctx: HandlerContext) {
 Render collected tags in the document with `<MetaTags />` from `@rangojs/router/client`.
+## Scripts
+Inject `<script>` tags (analytics, GTM, widgets) the same way, using the built-in
+`Script` handle — push a config from a handler, render with `<Scripts />`:
+```tsx
+import { Script } from "@rangojs/router";
+import type { HandlerContext } from "@rangojs/router";
+import { Outlet } from "@rangojs/router/client";
+export function RootLayout(ctx: HandlerContext) {
+  // Inline bootstrap (GTM/GA4/Segment) — rendered with the request CSP nonce.
+  ctx.use(Script)({ id: "gtm", children: gtmBootstrap("GTM-XXXX") });
+  // External async resource (loads on first encounter, deduped by src).
+  ctx.use(Script)({
+    id: "plausible",
+    src: "https://plausible.io/js/script.js",
+    async: true,
+    attributes: { "data-domain": "example.com" },
+  });
+  return <Outlet />;
+}
+```
+Render with `<Scripts />` (head) and `<Scripts position="body" />` (body) from
+`@rangojs/router/client` (both are wired in `DefaultDocument`). The request CSP
+nonce is applied automatically to document-rendered scripts. `ScriptConfig` is a
+discriminated union (inline / external-async / external-ordered), and inline +
+ordered scripts are document-load while async externals are React resources — see
+the [`/scripts` skill](./skills/scripts/SKILL.md) for the full execution contract
+and CSP guidance.
 ## CLI: `rango generate`
 Route types are generated automatically by the Vite plugin. The CLI is a manual fallback for generating types outside the dev server (e.g. in CI or for IDE support before first `pnpm dev`):
@@ -898,16 +1036,16 @@ Auto-detects file type:
 ## Type Safety
-The Vite plugin automatically generates a `router.named-routes.gen.ts` file that globally registers route names, patterns, and search schemas via `RSCRouter.GeneratedRouteMap`. This powers server-side named-route typing such as `Handler<"name">`, `ctx.reverse()`, `getRequestContext().reverse()`, and `RouteParams<"name">` without any manual route registration. The gen file is updated on dev server startup, HMR, and production builds.
+The Vite plugin automatically generates a `router.named-routes.gen.ts` file that globally registers route names, patterns, and search schemas via `Rango.GeneratedRouteMap`. This powers server-side named-route typing such as `Handler<"name">`, `ctx.reverse()`, `getRequestContext().reverse()`, and `RouteParams<"name">` without any manual route registration. The gen file is updated on dev server startup, HMR, and production builds.
-Use the generated map by default. Augment `RSCRouter.RegisteredRoutes` only when you need the richer `typeof router.routeMap` shape globally, especially for response-aware and path-based utilities.
+Use the generated map by default. Augment `Rango.RegisteredRoutes` only when you need the richer `typeof router.routeMap` shape globally, especially for response-aware and path-based utilities.
 ```typescript
 // router.tsx
 const router = createRouter<AppBindings>({}).routes(urlpatterns);
 declare global {
-  namespace RSCRouter {
+  namespace Rango {
     interface Env extends AppEnv {}
     interface Vars extends AppVars {}
     interface RegisteredRoutes extends typeof router.routeMap {}
@@ -919,7 +1057,7 @@ Quick rule of thumb:
 - `GeneratedRouteMap` (auto-generated) — use for server-side named-route typing: `Handler<"name">`, `ctx.reverse()`, `Prerender<"name">`
 - `typeof router.routeMap` — use when you need route entries with response metadata
-- `RegisteredRoutes` (manual augmentation) — use to expose `typeof router.routeMap` globally for `href()`, `PathResponse`, `ValidPaths`, and other path/response-aware utilities
+- `RegisteredRoutes` (manual augmentation) — use to expose `typeof router.routeMap` globally for `href()`, `Rango.Path`, `Rango.PathResponse`, and other path/response-aware utilities
 For extracted reusable loaders or middleware, prefer global dotted names on
 `ctx.reverse()` by default. If you want type-safe local names for a specific
@@ -947,9 +1085,9 @@ APIs, use their dedicated subpaths.
 ## Examples
-See the `examples/` directory for full working applications:
+See the example and demo apps for full working applications:
-- [`cloudflare-basic`](../../examples/cloudflare-basic) — Cloudflare Workers with caching, loaders, theme, and pre-rendering
+- [`cloudflare-basic`](../../tests/cloudflare-basic) — Cloudflare Workers with caching, loaders, theme, and pre-rendering
 - [`cloudflare-multi-router`](../../examples/cloudflare-multi-router) — Multi-app host routing
 ## License