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/src/browser/react/NavigationProvider.tsx CHANGED Viewed

@@ -28,6 +28,44 @@ import { NonceContext } from "./nonce-context.js";
 import type { ResolvedThemeConfig, Theme } from "../../theme/types.js";
 import { cancelAllPrefetches } from "../prefetch/queue.js";
 import { handleNavigationEnd } from "../scroll-restoration.js";
+import { createAppShellRef, type AppShellRef } from "../app-shell.js";
+import { startConnectionWarmup } from "../connection-warmup.js";
+import { debugLog } from "../logging.js";
+import { isThenable } from "../../handles/is-thenable.js";
+/** True when any handle value in this snapshot is a deferred (Promise) value. */
+function hasDeferredHandleValue(data: HandleData): boolean {
+  for (const handleName of Object.keys(data)) {
+    for (const segmentId of Object.keys(data[handleName])) {
+      if (data[handleName][segmentId].some(isThenable)) return true;
+    }
+  }
+  return false;
+}
+/** Snapshot with deferred (Promise) values awaited; a rejected deferred is
+ *  dropped (it contributes nothing), mirroring the render-side REJECTED_META. */
+async function resolveDeferredHandleValues(
+  data: HandleData,
+): Promise<HandleData> {
+  const out: HandleData = {};
+  await Promise.all(
+    Object.keys(data).flatMap((handleName) => {
+      out[handleName] = {};
+      return Object.keys(data[handleName]).map(async (segmentId) => {
+        const settled = await Promise.allSettled(
+          data[handleName][segmentId].map((v) =>
+            isThenable(v) ? v : Promise.resolve(v),
+          ),
+        );
+        out[handleName][segmentId] = settled
+          .filter((r) => r.status === "fulfilled")
+          .map((r) => (r as PromiseFulfilledResult<unknown>).value);
+      });
+    }),
+  );
+  return out;
+}
 /**
  * Process handles from an async generator, updating the event controller
@@ -46,10 +84,22 @@ async function processHandles(
     store: NavigationStore;
     matched?: string[];
     isPartial?: boolean;
+    /** Server's `resolvedIds`: every segment re-resolved this request,
+     *  including null-component ones excluded from `diff`/`segments`.
+     *  Drives cleanup of stale handle buckets when a re-resolved segment
+     *  pushed nothing. */
+    resolvedIds?: string[];
     historyKey: string;
   },
 ): Promise<void> {
-  const { eventController, store, matched, isPartial, historyKey } = opts;
+  const {
+    eventController,
+    store,
+    matched,
+    isPartial,
+    resolvedIds,
+    historyKey,
+  } = opts;
   let yieldCount = 0;
   for await (const handleData of handlesGenerator) {
@@ -57,14 +107,44 @@ async function processHandles(
     // This prevents handle data from cancelled navigations polluting
     // the current route's breadcrumbs (e.g., quick popstate after clicking a link).
     if (historyKey !== store.getHistoryKey()) {
-      console.log(
+      debugLog(
         "[NavigationProvider] Stopping handle processing - user navigated away",
       );
       return;
     }
     yieldCount++;
-    eventController.setHandleData(handleData, matched, isPartial);
+    if (!hasDeferredHandleValue(handleData)) {
+      eventController.setHandleData(
+        handleData,
+        matched,
+        isPartial,
+        resolvedIds,
+      );
+      continue;
+    }
+    // A handle value can be a deferred Promise (e.g.
+    // ctx.use(Meta)(data.then(v => ({ title: v.t })))). Resolving it on the
+    // client here — instead of letting the consumer use() it — keeps the
+    // consumer (useHandle/MetaTags) dumb: it only ever sees resolved values, so
+    // it never suspends mid-navigation. MetaTags lives in <head>, above the
+    // route's <Suspense>, so an uncontained suspension there would revert the
+    // just-committed route and hide its loading fallback.
+    //
+    // Keep the PREVIOUS handle data on screen (stale-while-revalidate) until the
+    // resolved snapshot is ready, then swap it in atomically. Do NOT apply a
+    // stripped snapshot first: that would blank a title/meta whose only value is
+    // deferred for the whole resolution window. Skip if the user navigated away.
+    void resolveDeferredHandleValues(handleData).then((resolved) => {
+      if (historyKey !== store.getHistoryKey()) return; // navigated away
+      eventController.setHandleData(resolved, matched, isPartial, resolvedIds);
+      store.updateCacheHandleData(
+        historyKey,
+        eventController.getHandleState().data,
+      );
+    });
   }
   // Check again before final updates
@@ -72,12 +152,11 @@ async function processHandles(
     return;
   }
-  // For partial updates where the generator yielded nothing (cached handlers),
-  // we still need to update the segment order to clean up stale handle data.
-  // This happens when navigating away from a route - the handlers for the new
-  // route might not push any breadcrumbs, but we still need to remove the old ones.
+  // For partial updates where the generator yielded nothing (every
+  // re-resolved handler pushed nothing), still call setHandleData so the
+  // cleanup pass can clear out stale buckets for those segments.
   if (yieldCount === 0 && matched) {
-    eventController.setHandleData({}, matched, true);
+    eventController.setHandleData({}, matched, true, resolvedIds);
   }
   // After handles processing completes, update the cache's handleData.
@@ -133,15 +212,33 @@ export interface NavigationProviderProps {
   warmupEnabled?: boolean;
   /**
-   * App version from server payload (stable, immutable).
-   * Forwarded to context for cache key building.
+   * App version from server payload.
+   * Used only as a fallback when `appShellRef` is not supplied.
    */
   version?: string;
   /**
    * URL prefix for all routes (from createRouter({ basename })).
+   * Used only as a fallback when `appShellRef` is not supplied.
    */
   basename?: string;
+  /**
+   * App-shell ref. When provided, the context's `basename` and `version` are
+   * read through it (live getters) so they don't close over a stale snapshot or
+   * invalidate the memoized context value. The shell is set once at init and is
+   * not swapped within a session — a cross-app navigation is a full document
+   * load (X-RSC-Reload), so the target app establishes its own shell on load.
+   */
+  appShellRef?: AppShellRef;
+  /**
+   * CSP nonce to expose via NonceContext. Production leaves this undefined — the
+   * browser has no nonce (it is a server-side HTML concern), and SSR provides the
+   * nonce through its own NonceContext.Provider. Test harnesses (renderRoute) set
+   * it to seed a nonce so components calling useNonce() can be exercised.
+   */
+  nonce?: string;
 }
 /**
@@ -175,6 +272,8 @@ export function NavigationProvider({
   warmupEnabled,
   version,
   basename,
+  appShellRef,
+  nonce,
 }: NavigationProviderProps): ReactNode {
   // Track current payload for rendering (this triggers re-renders)
   const [payload, setPayload] = useState(initialPayload);
@@ -196,104 +295,43 @@ export function NavigationProvider({
     await bridge.refresh();
   }, []);
-  // Context value is stable (store, eventController, navigate, refresh never change)
-  const contextValue = useMemo<NavigationStoreContextValue>(
-    () => ({
+  // basename/version are always read through a shell ref so the context value
+  // has a single shape. Both are set once: a supplied appShellRef is seeded
+  // from the init payload (a cross-app navigation reloads, so it is not swapped
+  // in-session), and the standalone fallback wraps the mount-time props.
+  const fallbackShellRef = useRef<AppShellRef | null>(null);
+  if (!fallbackShellRef.current) {
+    fallbackShellRef.current = createAppShellRef({ basename, version });
+  }
+  const shellRef = appShellRef ?? fallbackShellRef.current;
+  const contextValue = useMemo<NavigationStoreContextValue>(() => {
+    const value = {
       store,
       eventController,
       navigate,
       refresh,
-      version,
-      basename,
-    }),
-    [],
-  );
+    } as NavigationStoreContextValue;
+    Object.defineProperty(value, "basename", {
+      configurable: true,
+      enumerable: true,
+      get: () => shellRef.get().basename,
+    });
+    Object.defineProperty(value, "version", {
+      configurable: true,
+      enumerable: true,
+      get: () => shellRef.get().version,
+    });
+    return value;
+  }, []);
-  // Connection warmup: keep TLS alive after idle periods.
-  // After 60s of no user interaction, marks connection as "cold".
-  // On next interaction or visibility change, sends a HEAD request to warm TLS
-  // before the user actually clicks a link.
+  // Connection warmup: keep TLS alive after idle periods. After 60s of no
+  // interaction the connection is marked cold; the next pointer/touch
+  // interaction or visibility change warms TLS via a HEAD request before the
+  // user clicks a link. State machine lives in connection-warmup.ts.
   useEffect(() => {
     if (!warmupEnabled) return;
-    const IDLE_TIMEOUT = 60_000;
-    const DEBOUNCE_DELAY = 150;
-    let idleTimer: ReturnType<typeof setTimeout> | undefined;
-    let debounceTimer: ReturnType<typeof setTimeout> | undefined;
-    let isCold = false;
-    let warmupListenersAttached = false;
-    function sendWarmup() {
-      isCold = false;
-      fetch("/?_rsc_warmup", { method: "HEAD" }).catch(() => {});
-    }
-    function triggerWarmup() {
-      if (!isCold) return;
-      clearTimeout(debounceTimer);
-      debounceTimer = setTimeout(() => {
-        sendWarmup();
-        detachWarmupListeners();
-        resetIdleTimer();
-      }, DEBOUNCE_DELAY);
-    }
-    function onVisibilityChange() {
-      if (document.visibilityState === "visible" && isCold) {
-        triggerWarmup();
-      }
-    }
-    function attachWarmupListeners() {
-      if (warmupListenersAttached) return;
-      warmupListenersAttached = true;
-      document.addEventListener("visibilitychange", onVisibilityChange);
-      document.addEventListener("mousemove", triggerWarmup, { once: true });
-      document.addEventListener("touchstart", triggerWarmup, { once: true });
-    }
-    function detachWarmupListeners() {
-      warmupListenersAttached = false;
-      document.removeEventListener("visibilitychange", onVisibilityChange);
-      document.removeEventListener("mousemove", triggerWarmup);
-      document.removeEventListener("touchstart", triggerWarmup);
-    }
-    function markCold() {
-      isCold = true;
-      attachWarmupListeners();
-    }
-    function resetIdleTimer() {
-      clearTimeout(idleTimer);
-      isCold = false;
-      idleTimer = setTimeout(markCold, IDLE_TIMEOUT);
-    }
-    // Activity events that reset the idle timer
-    const activityEvents = [
-      "mousemove",
-      "keydown",
-      "touchstart",
-      "scroll",
-    ] as const;
-    const activityOptions: AddEventListenerOptions = { passive: true };
-    for (const event of activityEvents) {
-      document.addEventListener(event, resetIdleTimer, activityOptions);
-    }
-    resetIdleTimer();
-    return () => {
-      clearTimeout(idleTimer);
-      clearTimeout(debounceTimer);
-      detachWarmupListeners();
-      for (const event of activityEvents) {
-        document.removeEventListener(event, resetIdleTimer);
-      }
-    };
+    return startConnectionWarmup();
   }, [warmupEnabled]);
   // Cancel non-matching prefetches when navigation starts.
@@ -345,8 +383,12 @@ export function NavigationProvider({
         metadata: update.metadata,
       });
-      // Update route params
-      eventController.setParams(update.metadata.params ?? {});
+      // Update route params. Only reset when the server actually sends a params
+      // map — an absent `params` field means "no change" (e.g., legacy action
+      // responses that omitted params). Explicit `{}` still clears correctly.
+      if (update.metadata.params !== undefined) {
+        eventController.setParams(update.metadata.params);
+      }
       // Update handle data progressively as it streams in
       if (update.metadata.handles) {
@@ -359,24 +401,20 @@ export function NavigationProvider({
           store,
           matched: update.metadata.matched,
           isPartial: update.metadata.isPartial,
+          resolvedIds: update.metadata.resolvedIds,
           historyKey,
         }).catch((err) =>
           console.error("[NavigationProvider] Error consuming handles:", err),
         );
-      } else if (update.metadata.cachedHandleData) {
-        // For back/forward navigation from cache, restore the cached handleData
-        // This restores breadcrumbs to the exact state they were when the page was cached
-        eventController.setHandleData(
-          update.metadata.cachedHandleData,
-          update.metadata.matched,
-          false, // full replace - restore entire cached state
-        );
       } else if (update.metadata.matched) {
-        // For cached navigations without handleData, update segmentOrder to clean up stale data
+        // cachedHandleData present -> full restore (back/forward); absent ->
+        // partial cleanup of segments no longer matched.
+        const cached = update.metadata.cachedHandleData;
         eventController.setHandleData(
-          {}, // Empty data - all existing data not in matched will be cleaned up
+          cached ?? {},
           update.metadata.matched,
-          true, // partial update - will clean up segments not in matched
+          cached === undefined,
+          cached === undefined ? update.metadata.resolvedIds : undefined,
         );
       }
     });
@@ -389,7 +427,8 @@ export function NavigationProvider({
     payload.root instanceof Promise ? use(payload.root) : payload.root;
   // Wrap content in RootErrorBoundary to catch:
-  // 1. Errors from NetworkErrorThrower (rendered during network failures)
+  // 1. Errors from RenderErrorThrower (network failures and unprocessable
+  //    navigation responses, routed here by the navigation bridge)
   // 2. Client component errors that occur before/outside the segment tree's error boundary
   // 3. Errors during promise resolution or navigation state updates
   // This acts as a safety net - the segment tree has its own RootErrorBoundary that
@@ -398,7 +437,11 @@ export function NavigationProvider({
   // Build the content tree
   let content = <RootErrorBoundary>{root}</RootErrorBoundary>;
-  // Wrap with ThemeProvider when theme is enabled
+  // Wrap with ThemeProvider when theme is enabled. The ThemeProvider is
+  // document-lifetime: its config comes from the initial load and persists for
+  // the session. It sits above the segment tree and is not remounted in-session;
+  // a cross-app navigation is a full document load (X-RSC-Reload), so the target
+  // app's theme config takes effect on its own load.
   if (themeConfig) {
     content = (
       <ThemeProvider config={themeConfig} initialTheme={initialTheme}>
@@ -409,9 +452,10 @@ export function NavigationProvider({
   // Match SSR tree shape: NonceContext.Provider is always present so
   // hydration sees the same component tree. Value is undefined on the
-  // client — CSP nonces are a server-side HTML concern.
+  // client — CSP nonces are a server-side HTML concern — unless a test
+  // harness seeded one via the `nonce` prop.
   content = (
-    <NonceContext.Provider value={undefined}>{content}</NonceContext.Provider>
+    <NonceContext.Provider value={nonce}>{content}</NonceContext.Provider>
   );
   return (

package/src/browser/react/ScrollRestoration.tsx CHANGED Viewed

@@ -14,17 +14,21 @@ export interface ScrollRestorationProps {
    * Return location.pathname to restore scroll based on path
    * (useful for keeping scroll position on the same page).
    *
+   * Provide a stable reference: a module-level function or one wrapped in
+   * useCallback. The init effect re-runs when getKey's identity changes, and
+   * teardown clears in-memory scroll positions — a fresh inline arrow on every
+   * parent render would discard unpersisted positions mid-session.
+   *
    * @example
    * ```tsx
+   * // Stable module-level getKey (recommended)
+   * const byPathname = (location) => location.pathname;
+   *
    * // Restore based on pathname (same URL = same scroll)
-   * <ScrollRestoration
-   *   getKey={(location) => location.pathname}
-   * />
+   * <ScrollRestoration getKey={byPathname} />
    *
    * // Restore based on unique history entry (default)
-   * <ScrollRestoration
-   *   getKey={(location) => location.key}
-   * />
+   * // <ScrollRestoration /> — omit getKey to use location.key
    * ```
    */
   getKey?: (location: {

package/src/browser/react/filter-segment-order.ts CHANGED Viewed

@@ -1,11 +1,70 @@
 /**
- * Filter segment IDs to only include routes and layouts.
- * Excludes parallels (contain .@) and loaders (contain D followed by digit).
+ * Build the handle-collection segment order from a raw `matched` list.
+ *
+ * Two responsibilities:
+ *
+ * 1. Drop loader sub-ids ("D" followed by a digit, e.g. "M0L0D1.user") —
+ *    loaders never push handles.
+ *
+ * 2. Place each parallel slot id (contains ".@") immediately after its
+ *    parent layout/route id. Raw segment-resolution emission order does NOT
+ *    guarantee this: route-mounted parallels are resolved/pushed BEFORE the
+ *    route handler's segment is appended (see fresh.ts:resolveSegment for
+ *    routes, and revalidation.ts ~915-919), so matched can read
+ *    `[..., R0.@panel, R0]`. collectHandleData consumes segmentOrder verbatim
+ *    with later-wins semantics, so without normalization the route handler's
+ *    Meta would override the slot's more-specific Meta — backwards.
+ *
+ * Slot-id format is `<parentShortCode>.@<slotName>`; `parentShortCode` never
+ * contains ".@", so splitting at the first ".@" reliably yields the parent.
  */
 export function filterSegmentOrder(matched: string[]): string[] {
-  return matched.filter((id) => {
-    if (id.includes(".@")) return false;
-    if (/D\d+\./.test(id)) return false;
-    return true;
-  });
+  const slotsByParent = new Map<string, string[]>();
+  const nonSlots: string[] = [];
+  const nonSlotSet = new Set<string>();
+  for (const id of matched) {
+    if (/D\d+\./.test(id)) continue;
+    const slotIdx = id.indexOf(".@");
+    if (slotIdx >= 0) {
+      const parent = id.slice(0, slotIdx);
+      const list = slotsByParent.get(parent);
+      if (list) {
+        list.push(id);
+      } else {
+        slotsByParent.set(parent, [id]);
+      }
+    } else {
+      nonSlots.push(id);
+      nonSlotSet.add(id);
+    }
+  }
+  const result: string[] = [];
+  for (const id of nonSlots) {
+    result.push(id);
+    const slots = slotsByParent.get(id);
+    if (slots) result.push(...slots);
+  }
+  for (const [parent, slots] of slotsByParent) {
+    if (!nonSlotSet.has(parent)) result.push(...slots);
+  }
+  return result;
+}
+/**
+ * Build the "layouts and routes only" id list for useSegments().segmentIds.
+ *
+ * Strips parallel slot ids (contain ".@") and loader sub-ids ("D" followed by
+ * a digit, e.g. "M0L0D1.user") without reordering. Distinct from
+ * filterSegmentOrder, which also reorders slots after their parent for handle
+ * collection.
+ *
+ * Shared by SSR (ssr/index.tsx) and the client event controller
+ * (event-controller.ts) so both produce identical output; if they diverge,
+ * useSegments().segmentIds rendered during SSR and after hydration disagree
+ * and React reports a hydration mismatch.
+ */
+export function filterRouteSegmentIds(matched: string[]): string[] {
+  return matched.filter((id) => !id.includes(".@") && !/D\d+\./.test(id));
 }

package/src/browser/react/index.ts CHANGED Viewed

@@ -1,52 +1,4 @@
-// React exports for browser navigation
-// Hook with Zustand-style selectors
-export { useNavigation } from "./use-navigation.js";
-// Router actions hook (stable reference, no re-renders)
-export { useRouter } from "./use-router.js";
-// URL hooks
-export { usePathname } from "./use-pathname.js";
-export { useSearchParams } from "./use-search-params.js";
-export { useParams } from "./use-params.js";
-// Action state tracking hook
-export { useAction, type TrackedActionState } from "./use-action.js";
-// Segments state hook
-export { useSegments, type SegmentsState } from "./use-segments.js";
-// Handle data hook
-export { useHandle } from "./use-handle.js";
-// Client cache controls hook
-export {
-  useClientCache,
-  type ClientCacheControls,
-} from "./use-client-cache.js";
-// Provider
 export {
   NavigationProvider,
   type NavigationProviderProps,
 } from "./NavigationProvider.js";
-// Context (for advanced usage)
-export {
-  NavigationStoreContext,
-  type NavigationStoreContextValue,
-} from "./context.js";
-// Link component
-export { Link, type LinkProps, type PrefetchStrategy } from "./Link.js";
-// Link status hook
-export { useLinkStatus, type LinkStatus } from "./use-link-status.js";
-// Scroll restoration
-export {
-  ScrollRestoration,
-  useScrollRestoration,
-  type ScrollRestorationProps,
-} from "./ScrollRestoration.js";