cross-router-core 1.0.2 → 1.0.3

package/README.md

@@ -26,7 +26,6 @@ If you are building a new adapter, use `createRouter` directly:
 import { createRouter, createBrowserHistory } from 'cross-router-core'
 
 const router = createRouter(createBrowserHistory(), {
-  context: {},
   routes: [...],
   middleware: [...],
 })
@@ -97,14 +96,17 @@ Middleware runs before every navigation, in order: global middleware first, then
 Each middleware receives the accumulated context from the previous middleware and passes an extended context to the next one. This is the primary way to propagate things like authenticated user objects, feature flags, or API clients down to loaders.
 
 ```ts
-import { defineMiddleware, redirect } from 'cross-router-core'
+import { createContext, defineMiddleware, redirect } from 'cross-router-core'
+
+const USER_CONTEXT = createContext<User>()
 
 const authMiddleware = defineMiddleware(async ({ context, request }, next) => {
   const user = await getSession()
   if (!user)
     throw redirect('/login')
   // Pass the user into the context — loaders will receive it typed
-  await next({ ...context, user })
+  context.set(USER_CONTEXT, user)
+  await next()
 })
 ```
 
@@ -112,7 +114,6 @@ Pass global middleware to `createRouter`:
 
 ```ts
 createRouter(history, {
-  context: {},
   middleware: [authMiddleware],
   routes: [...],
 })
@@ -126,7 +127,7 @@ Or attach middleware to a specific route:
   path: 'admin',
   middleware: [requireAdminMiddleware],
   loader: async ({ context }) => {
-    // context.user is typed here
+    const user = context.get(USER_CONTEXT) // `user` is properly typed here
   },
 }
 ```
@@ -136,12 +137,17 @@ Or attach middleware to a specific route:
 Helper for authoring middleware with full type inference. Without it you would need to annotate `TIn` and `TOut` manually.
 
 ```ts
+import { createContext, defineMiddleware } from 'cross-router-core'
+
+const ORG_CONTEXT = createContext<Organization>()
+
 const myMiddleware = defineMiddleware<
   { user: User }, // TIn  — what this middleware expects
   { user: User, org: Org }
 >(async ({ context }, next) => {
   const org = await fetchOrg(context.user.orgId)
-  await next({ ...context, org })
+  context.set(ORG_CONTEXT, org)
+  await next()
 })
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cross-router-core",
   "type": "module",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Agnostic router engine for cross-router.",
   "author": "Bricklou <louis13.bailleau@gmail.com>",
   "license": "MIT",