npm - @rangojs/router - Versions diffs - 0.0.0-experimental.9 → 0.0.0-experimental.a5f27bd5 - Mend

@rangojs/router 0.0.0-experimental.9 → 0.0.0-experimental.a5f27bd5

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

package/AGENTS.md +5 -0
package/README.md +884 -4
package/dist/bin/rango.js +1531 -155
package/dist/vite/index.js +4440 -2170
package/package.json +60 -54
package/skills/breadcrumbs/SKILL.md +250 -0
package/skills/cache-guide/SKILL.md +262 -0
package/skills/caching/SKILL.md +50 -21
package/skills/composability/SKILL.md +172 -0
package/skills/debug-manifest/SKILL.md +12 -8
package/skills/document-cache/SKILL.md +18 -16
package/skills/fonts/SKILL.md +6 -4
package/skills/hooks/SKILL.md +333 -71
package/skills/host-router/SKILL.md +218 -0
package/skills/intercept/SKILL.md +131 -8
package/skills/layout/SKILL.md +100 -3
package/skills/links/SKILL.md +74 -15
package/skills/loader/SKILL.md +388 -38
package/skills/middleware/SKILL.md +171 -34
package/skills/mime-routes/SKILL.md +15 -11
package/skills/parallel/SKILL.md +78 -1
package/skills/prerender/SKILL.md +405 -45
package/skills/rango/SKILL.md +85 -21
package/skills/response-routes/SKILL.md +144 -91
package/skills/route/SKILL.md +226 -14
package/skills/router-setup/SKILL.md +123 -30
package/skills/theme/SKILL.md +9 -8
package/skills/typesafety/SKILL.md +316 -87
package/skills/use-cache/SKILL.md +324 -0
package/src/__internal.ts +102 -4
package/src/bin/rango.ts +312 -15
package/src/browser/action-coordinator.ts +97 -0
package/src/browser/action-response-classifier.ts +99 -0
package/src/browser/event-controller.ts +87 -64
package/src/browser/history-state.ts +80 -0
package/src/browser/intercept-utils.ts +52 -0
package/src/browser/link-interceptor.ts +24 -4
package/src/browser/logging.ts +55 -0
package/src/browser/merge-segment-loaders.ts +20 -12
package/src/browser/navigation-bridge.ts +285 -553
package/src/browser/navigation-client.ts +123 -73
package/src/browser/navigation-store.ts +33 -50
package/src/browser/navigation-transaction.ts +295 -0
package/src/browser/network-error-handler.ts +61 -0
package/src/browser/partial-update.ts +261 -309
package/src/browser/prefetch/cache.ts +154 -0
package/src/browser/prefetch/fetch.ts +135 -0
package/src/browser/prefetch/observer.ts +65 -0
package/src/browser/prefetch/policy.ts +48 -0
package/src/browser/prefetch/queue.ts +88 -0
package/src/browser/rango-state.ts +112 -0
package/src/browser/react/Link.tsx +182 -70
package/src/browser/react/NavigationProvider.tsx +51 -11
package/src/browser/react/context.ts +6 -0
package/src/browser/react/filter-segment-order.ts +11 -0
package/src/browser/react/index.ts +12 -12
package/src/browser/react/location-state-shared.ts +95 -53
package/src/browser/react/location-state.ts +60 -15
package/src/browser/react/mount-context.ts +6 -1
package/src/browser/react/nonce-context.ts +23 -0
package/src/browser/react/shallow-equal.ts +27 -0
package/src/browser/react/use-action.ts +29 -51
package/src/browser/react/use-client-cache.ts +5 -3
package/src/browser/react/use-handle.ts +29 -70
package/src/browser/react/use-link-status.ts +6 -5
package/src/browser/react/use-navigation.ts +22 -63
package/src/browser/react/use-params.ts +65 -0
package/src/browser/react/use-pathname.ts +47 -0
package/src/browser/react/use-router.ts +63 -0
package/src/browser/react/use-search-params.ts +56 -0
package/src/browser/react/use-segments.ts +80 -97
package/src/browser/response-adapter.ts +73 -0
package/src/browser/rsc-router.tsx +106 -27
package/src/browser/scroll-restoration.ts +92 -16
package/src/browser/segment-reconciler.ts +216 -0
package/src/browser/segment-structure-assert.ts +16 -0
package/src/browser/server-action-bridge.ts +504 -599
package/src/browser/shallow.ts +6 -1
package/src/browser/types.ts +107 -47
package/src/browser/validate-redirect-origin.ts +29 -0
package/src/build/generate-manifest.ts +82 -21
package/src/build/generate-route-types.ts +36 -752
package/src/build/index.ts +6 -5
package/src/build/route-trie.ts +39 -13
package/src/build/route-types/ast-helpers.ts +25 -0
package/src/build/route-types/ast-route-extraction.ts +98 -0
package/src/build/route-types/codegen.ts +102 -0
package/src/build/route-types/include-resolution.ts +411 -0
package/src/build/route-types/param-extraction.ts +48 -0
package/src/build/route-types/per-module-writer.ts +128 -0
package/src/build/route-types/router-processing.ts +469 -0
package/src/build/route-types/scan-filter.ts +78 -0
package/src/build/runtime-discovery.ts +231 -0
package/src/cache/background-task.ts +34 -0
package/src/cache/cache-key-utils.ts +44 -0
package/src/cache/cache-policy.ts +125 -0
package/src/cache/cache-runtime.ts +338 -0
package/src/cache/cache-scope.ts +120 -301
package/src/cache/cf/cf-cache-store.ts +119 -7
package/src/cache/cf/index.ts +8 -2
package/src/cache/document-cache.ts +101 -72
package/src/cache/handle-capture.ts +81 -0
package/src/cache/handle-snapshot.ts +41 -0
package/src/cache/index.ts +0 -15
package/src/cache/memory-segment-store.ts +191 -13
package/src/cache/profile-registry.ts +73 -0
package/src/cache/read-through-swr.ts +134 -0
package/src/cache/segment-codec.ts +256 -0
package/src/cache/taint.ts +98 -0
package/src/cache/types.ts +72 -122
package/src/client.rsc.tsx +3 -1
package/src/client.tsx +84 -126
package/src/component-utils.ts +4 -4
package/src/components/DefaultDocument.tsx +5 -1
package/src/context-var.ts +86 -0
package/src/debug.ts +17 -7
package/src/errors.ts +77 -7
package/src/handle.ts +15 -10
package/src/handles/MetaTags.tsx +73 -20
package/src/handles/breadcrumbs.ts +66 -0
package/src/handles/index.ts +1 -0
package/src/handles/meta.ts +30 -13
package/src/host/cookie-handler.ts +21 -15
package/src/host/errors.ts +8 -8
package/src/host/index.ts +4 -7
package/src/host/pattern-matcher.ts +27 -27
package/src/host/router.ts +61 -39
package/src/host/testing.ts +8 -8
package/src/host/types.ts +15 -7
package/src/host/utils.ts +1 -1
package/src/href-client.ts +65 -45
package/src/index.rsc.ts +133 -21
package/src/index.ts +164 -52
package/src/internal-debug.ts +11 -0
package/src/loader.rsc.ts +25 -143
package/src/loader.ts +27 -10
package/src/network-error-thrower.tsx +3 -1
package/src/outlet-provider.tsx +45 -0
package/src/prerender/param-hash.ts +4 -2
package/src/prerender/store.ts +158 -13
package/src/prerender.ts +333 -26
package/src/reverse.ts +184 -121
package/src/root-error-boundary.tsx +41 -29
package/src/route-content-wrapper.tsx +7 -4
package/src/route-definition/dsl-helpers.ts +934 -0
package/src/route-definition/helper-factories.ts +200 -0
package/src/route-definition/helpers-types.ts +430 -0
package/src/route-definition/index.ts +52 -0
package/src/route-definition/redirect.ts +93 -0
package/src/route-definition.ts +1 -1431
package/src/route-map-builder.ts +156 -123
package/src/route-name.ts +53 -0
package/src/route-types.ts +48 -9
package/src/router/content-negotiation.ts +116 -0
package/src/router/debug-manifest.ts +72 -0
package/src/router/error-handling.ts +9 -9
package/src/router/find-match.ts +158 -0
package/src/router/handler-context.ts +374 -81
package/src/router/intercept-resolution.ts +24 -16
package/src/router/lazy-includes.ts +234 -0
package/src/router/loader-resolution.ts +215 -122
package/src/router/logging.ts +248 -0
package/src/router/manifest.ts +83 -32
package/src/router/match-api.ts +118 -119
package/src/router/match-context.ts +4 -2
package/src/router/match-handlers.ts +440 -0
package/src/router/match-middleware/background-revalidation.ts +80 -93
package/src/router/match-middleware/cache-lookup.ts +336 -84
package/src/router/match-middleware/cache-store.ts +43 -24
package/src/router/match-middleware/intercept-resolution.ts +45 -20
package/src/router/match-middleware/segment-resolution.ts +16 -8
package/src/router/match-pipelines.ts +10 -45
package/src/router/match-result.ts +34 -28
package/src/router/metrics.ts +235 -15
package/src/router/middleware-cookies.ts +55 -0
package/src/router/middleware-types.ts +222 -0
package/src/router/middleware.ts +324 -367
package/src/router/pattern-matching.ts +197 -41
package/src/router/prerender-match.ts +402 -0
package/src/router/preview-match.ts +170 -0
package/src/router/revalidation.ts +137 -38
package/src/router/router-context.ts +36 -21
package/src/router/router-interfaces.ts +452 -0
package/src/router/router-options.ts +592 -0
package/src/router/router-registry.ts +24 -0
package/src/router/segment-resolution/fresh.ts +570 -0
package/src/router/segment-resolution/helpers.ts +263 -0
package/src/router/segment-resolution/loader-cache.ts +198 -0
package/src/router/segment-resolution/revalidation.ts +1239 -0
package/src/router/segment-resolution/static-store.ts +67 -0
package/src/router/segment-resolution.ts +21 -1315
package/src/router/segment-wrappers.ts +289 -0
package/src/router/telemetry-otel.ts +299 -0
package/src/router/telemetry.ts +300 -0
package/src/router/timeout.ts +148 -0
package/src/router/trie-matching.ts +96 -29
package/src/router/types.ts +16 -9
package/src/router.ts +590 -1983
package/src/rsc/handler-context.ts +45 -0
package/src/rsc/handler.ts +661 -1015
package/src/rsc/helpers.ts +140 -6
package/src/rsc/index.ts +0 -20
package/src/rsc/loader-fetch.ts +209 -0
package/src/rsc/manifest-init.ts +86 -0
package/src/rsc/nonce.ts +14 -0
package/src/rsc/origin-guard.ts +141 -0
package/src/rsc/progressive-enhancement.ts +379 -0
package/src/rsc/response-error.ts +37 -0
package/src/rsc/response-route-handler.ts +347 -0
package/src/rsc/rsc-rendering.ts +237 -0
package/src/rsc/runtime-warnings.ts +42 -0
package/src/rsc/server-action.ts +348 -0
package/src/rsc/ssr-setup.ts +128 -0
package/src/rsc/types.ts +38 -11
package/src/search-params.ts +230 -0
package/src/segment-system.tsx +25 -13
package/src/server/context.ts +173 -48
package/src/server/cookie-store.ts +190 -0
package/src/server/fetchable-loader-store.ts +37 -0
package/src/server/handle-store.ts +94 -15
package/src/server/loader-registry.ts +15 -56
package/src/server/request-context.ts +430 -70
package/src/server.ts +35 -155
package/src/ssr/index.tsx +100 -31
package/src/static-handler.ts +114 -0
package/src/theme/ThemeProvider.tsx +21 -15
package/src/theme/ThemeScript.tsx +5 -5
package/src/theme/constants.ts +5 -2
package/src/theme/index.ts +4 -14
package/src/theme/theme-context.ts +4 -30
package/src/theme/theme-script.ts +21 -18
package/src/types/boundaries.ts +158 -0
package/src/types/cache-types.ts +198 -0
package/src/types/error-types.ts +192 -0
package/src/types/global-namespace.ts +100 -0
package/src/types/handler-context.ts +687 -0
package/src/types/index.ts +88 -0
package/src/types/loader-types.ts +183 -0
package/src/types/route-config.ts +170 -0
package/src/types/route-entry.ts +102 -0
package/src/types/segments.ts +148 -0
package/src/types.ts +1 -1757
package/src/urls/include-helper.ts +197 -0
package/src/urls/index.ts +53 -0
package/src/urls/path-helper-types.ts +339 -0
package/src/urls/path-helper.ts +329 -0
package/src/urls/pattern-types.ts +95 -0
package/src/urls/response-types.ts +106 -0
package/src/urls/type-extraction.ts +372 -0
package/src/urls/urls-function.ts +98 -0
package/src/urls.ts +1 -1282
package/src/use-loader.tsx +85 -77
package/src/vite/discovery/bundle-postprocess.ts +184 -0
package/src/vite/discovery/discover-routers.ts +344 -0
package/src/vite/discovery/prerender-collection.ts +385 -0
package/src/vite/discovery/route-types-writer.ts +258 -0
package/src/vite/discovery/self-gen-tracking.ts +47 -0
package/src/vite/discovery/state.ts +110 -0
package/src/vite/discovery/virtual-module-codegen.ts +203 -0
package/src/vite/index.ts +11 -1963
package/src/vite/plugin-types.ts +131 -0
package/src/vite/plugins/cjs-to-esm.ts +93 -0
package/src/vite/plugins/client-ref-dedup.ts +115 -0
package/src/vite/plugins/client-ref-hashing.ts +105 -0
package/src/vite/{expose-action-id.ts → plugins/expose-action-id.ts} +72 -51
package/src/vite/plugins/expose-id-utils.ts +287 -0
package/src/vite/plugins/expose-ids/export-analysis.ts +296 -0
package/src/vite/plugins/expose-ids/handler-transform.ts +179 -0
package/src/vite/plugins/expose-ids/loader-transform.ts +74 -0
package/src/vite/plugins/expose-ids/router-transform.ts +110 -0
package/src/vite/plugins/expose-ids/types.ts +45 -0
package/src/vite/plugins/expose-internal-ids.ts +569 -0
package/src/vite/plugins/refresh-cmd.ts +65 -0
package/src/vite/plugins/use-cache-transform.ts +323 -0
package/src/vite/plugins/version-injector.ts +83 -0
package/src/vite/plugins/version-plugin.ts +254 -0
package/src/vite/{virtual-entries.ts → plugins/virtual-entries.ts} +23 -14
package/src/vite/plugins/virtual-stub-plugin.ts +29 -0
package/src/vite/rango.ts +510 -0
package/src/vite/router-discovery.ts +785 -0
package/src/vite/utils/ast-handler-extract.ts +517 -0
package/src/vite/utils/banner.ts +36 -0
package/src/vite/utils/bundle-analysis.ts +137 -0
package/src/vite/utils/manifest-utils.ts +70 -0
package/src/vite/{package-resolution.ts → utils/package-resolution.ts} +25 -29
package/src/vite/utils/prerender-utils.ts +189 -0
package/src/vite/utils/shared-utils.ts +169 -0
package/CLAUDE.md +0 -43
package/src/browser/lru-cache.ts +0 -69
package/src/browser/request-controller.ts +0 -164
package/src/cache/memory-store.ts +0 -253
package/src/href-context.ts +0 -33
package/src/router.gen.ts +0 -6
package/src/urls.gen.ts +0 -8
package/src/vite/expose-handle-id.ts +0 -209
package/src/vite/expose-loader-id.ts +0 -426
package/src/vite/expose-location-state-id.ts +0 -177
package/src/vite/expose-prerender-handler-id.ts +0 -429
/package/src/vite/{version.d.ts → plugins/version.d.ts} +0 -0

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

@@ -14,14 +14,14 @@ Configure document cache in router:
 ```typescript
 import { createRouter } from "@rangojs/router";
-import { CFCacheStore } from "@rangojs/router/cache/cf";
+import { CFCacheStore } from "@rangojs/router/cache";
 import { urlpatterns } from "./urls";
-const router = createRouter<AppEnv>({
+const router = createRouter<AppBindings>({
   document: Document,
   urls: urlpatterns,
-  documentCache: (env) => ({
-    store: new CFCacheStore({ ctx: env.ctx }),
+  documentCache: (_env, ctx) => ({
+    store: new CFCacheStore({ ctx: ctx! }),
     skipPaths: ["/api", "/admin"],
     debug: process.env.NODE_ENV === "development",
   }),
@@ -58,9 +58,9 @@ export const urlpatterns = urls(({ path, cache }) => [
 ```typescript
 createRouter({
   // ...
-  documentCache: (env) => ({
+  documentCache: (_env, ctx) => ({
     // Cache store (required)
-    store: new CFCacheStore({ ctx: env.ctx }),
+    store: new CFCacheStore({ ctx: ctx! }),
     // Skip specific paths
     skipPaths: ["/api", "/admin"],
@@ -102,6 +102,7 @@ Request → Check Cache
 ## Cache Status Header
 Response includes `x-document-cache-status`:
 - `HIT` - Fresh cache hit
 - `STALE` - Served stale, revalidating in background
 - `MISS` - Cache miss, response was generated fresh
@@ -109,6 +110,7 @@ Response includes `x-document-cache-status`:
 ## Cache Key Generation
 Default keys differentiate:
 - HTML requests: `{pathname}:html`
 - RSC partials: `{pathname}:{segmentHash}:rsc`
@@ -132,14 +134,14 @@ Segment hash ensures different cached responses for navigations from different s
 ```typescript
 // router.tsx
 import { createRouter } from "@rangojs/router";
-import { CFCacheStore } from "@rangojs/router/cache/cf";
+import { CFCacheStore } from "@rangojs/router/cache";
 import { urlpatterns } from "./urls";
-const router = createRouter<AppEnv>({
+const router = createRouter<AppBindings>({
   document: Document,
   urls: urlpatterns,
-  documentCache: (env) => ({
-    store: new CFCacheStore({ ctx: env.ctx }),
+  documentCache: (_env, ctx) => ({
+    store: new CFCacheStore({ ctx: ctx! }),
     skipPaths: ["/api"],
     debug: process.env.NODE_ENV === "development",
   }),
@@ -170,11 +172,11 @@ export const urlpatterns = urls(({ path, layout, cache, loader }) => [
 ## Document Cache vs Segment Cache
-| Feature | Document Cache | Segment Cache |
-|---------|---------------|---------------|
-| Granularity | Full response | Individual segments |
-| Opt-in | `documentCache` in cache() | `cache({ ttl, swr })` |
-| Use case | Static pages | Dynamic compositions |
-| Key includes | URL + segment hash | Route params |
+| Feature      | Document Cache             | Segment Cache         |
+| ------------ | -------------------------- | --------------------- |
+| Granularity  | Full response              | Individual segments   |
+| Opt-in       | `documentCache` in cache() | `cache({ ttl, swr })` |
+| Use case     | Static pages               | Dynamic compositions  |
+| Key includes | URL + segment hash         | Route params          |
 Use document cache for mostly-static pages. Use segment cache when different parts of a page have different cache requirements.

package/skills/fonts/SKILL.md CHANGED Viewed

@@ -24,7 +24,11 @@ export function Document({ children }: { children: ReactNode }) {
       <head>
         {/* Preconnect to Google Fonts */}
         <link rel="preconnect" href="https://fonts.googleapis.com" />
-        <link rel="preconnect" href="https://fonts.gstatic.com" crossOrigin="anonymous" />
+        <link
+          rel="preconnect"
+          href="https://fonts.gstatic.com"
+          crossOrigin="anonymous"
+        />
         {/* Load font stylesheet */}
         <link
@@ -37,9 +41,7 @@ export function Document({ children }: { children: ReactNode }) {
         <link rel="stylesheet" href={styles} />
         <MetaTags />
       </head>
-      <body>
-        {children}
-      </body>
+      <body>{children}</body>
     </html>
   );
 }