From a5f8ef0b860859e32df4f72ba5edbe0f4ba27e87 Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Thu, 30 Apr 2026 20:39:57 +0200
Subject: [PATCH 1/8] fix(react-router): Link isActive on competing optional
 segment routes

---
 packages/react-router/tests/link.test.tsx | 53 +++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/packages/react-router/tests/link.test.tsx b/packages/react-router/tests/link.test.tsx
index b9c739becd6..0f223faf369 100644
--- a/packages/react-router/tests/link.test.tsx
+++ b/packages/react-router/tests/link.test.tsx
@@ -5314,6 +5314,59 @@ describe('Link', () => {
       await runTest({ expectedPreload: false, testIdToHover: 'link-2' })
     })
   })
+
+  test('edge-case: competing optional segment links', async () => {
+    const rootRoute = createRootRoute({
+      component: () => {
+        return (
+          <>
+            <Link to="/">To index</Link>
+            <Link to="/{-$foo}/bar" params={{ foo: 'foo' }}>
+              To /foo/bar
+            </Link>
+            <Link to="/{-$foo}/bar">To /bar</Link>
+            <Outlet />
+          </>
+        )
+      },
+    })
+    const indexRoute = createRoute({
+      getParentRoute: () => rootRoute,
+      path: '/',
+      component: () => <p>index</p>,
+    })
+    const optRoute = createRoute({
+      getParentRoute: () => rootRoute,
+      path: '/{-$foo}/bar',
+      component: () => {
+        const params = useParams({ strict: false })
+        return <pre>{JSON.stringify(params)}</pre>
+      },
+    })
+
+    const router = createRouter({
+      routeTree: rootRoute.addChildren([indexRoute, optRoute]),
+      history,
+    })
+
+    render(<RouterProvider router={router} />)
+    expect(await screen.findByText('index')).toBeInTheDocument()
+
+    const indexLink = await screen.findByRole('link', { name: 'To index' })
+    const fooBarLink = await screen.findByRole('link', { name: 'To /foo/bar' })
+    const barLink = await screen.findByRole('link', { name: 'To /bar' })
+
+    fireEvent.click(fooBarLink)
+    expect(fooBarLink).toHaveAttribute('aria-current', 'page')
+    expect(barLink).not.toHaveAttribute('aria-current', 'page')
+
+    fireEvent.click(indexLink)
+    expect(indexLink).toHaveAttribute('aria-current', 'page')
+
+    fireEvent.click(barLink)
+    expect(fooBarLink).not.toHaveAttribute('aria-current', 'page')
+    expect(barLink).toHaveAttribute('aria-current', 'page')
+  })
 })
 
 describe('createLink', () => {

From 83140d755e3285355259d6ce6d746ccc4eeb17ab Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Thu, 30 Apr 2026 22:08:28 +0200
Subject: [PATCH 2/8] fix

---
 packages/router-core/src/router.ts            |  22 +--
 .../router-core/tests/build-location.test.ts  | 135 ++++++++++++++++++
 packages/solid-router/tests/link.test.tsx     |  57 ++++++++
 packages/vue-router/tests/link.test.tsx       |  57 ++++++++
 4 files changed, 262 insertions(+), 9 deletions(-)

diff --git a/packages/router-core/src/router.ts b/packages/router-core/src/router.ts
index bd8a2898ec4..41e434e64ae 100644
--- a/packages/router-core/src/router.ts
+++ b/packages/router-core/src/router.ts
@@ -1860,15 +1860,19 @@ export class RouterCore<
         : sourcePath
 
       // Resolve the next params
-      const nextParams =
-        dest.params === false || dest.params === null
-          ? Object.create(null)
-          : (dest.params ?? true) === true
-            ? fromParams
-            : Object.assign(
-                fromParams,
-                functionalUpdate(dest.params as any, fromParams),
-              )
+      const inheritParams =
+        dest.from || dest.params === true || typeof dest.params === 'function'
+      const baseParams = inheritParams ? fromParams : Object.create(null)
+      const nextParams = inheritParams
+        ? dest.params === true
+          ? baseParams
+          : Object.assign(
+              baseParams,
+              functionalUpdate(dest.params as any, fromParams),
+            )
+        : dest.params
+          ? Object.assign(baseParams, dest.params)
+          : baseParams
 
       const destRoute = this.routesByPath[
         trimPathRight(nextTo) as keyof typeof this.routesByPath
diff --git a/packages/router-core/tests/build-location.test.ts b/packages/router-core/tests/build-location.test.ts
index c8c12ce42e2..8877bad0307 100644
--- a/packages/router-core/tests/build-location.test.ts
+++ b/packages/router-core/tests/build-location.test.ts
@@ -1036,6 +1036,141 @@ describe('buildLocation - params edge cases', () => {
     expect(location.pathname).toBe('/users/456')
   })
 
+  test('omitted params should not inherit current params without from', async () => {
+    const rootRoute = new BaseRootRoute({})
+    const orgRoute = new BaseRoute({
+      getParentRoute: () => rootRoute,
+      path: '/orgs/$orgId',
+    })
+    const userRoute = new BaseRoute({
+      getParentRoute: () => orgRoute,
+      path: '/users/$userId',
+    })
+
+    const routeTree = rootRoute.addChildren([orgRoute.addChildren([userRoute])])
+
+    const router = createTestRouter({
+      routeTree,
+      history: createMemoryHistory({ initialEntries: ['/orgs/abc/users/123'] }),
+    })
+
+    await router.load()
+
+    const location = router.buildLocation({
+      to: '/orgs/$orgId/users/$userId',
+    })
+
+    expect(location.pathname).toBe('/orgs/undefined/users/undefined')
+  })
+
+  test('omitted params should not inherit current optional params without from', async () => {
+    const rootRoute = new BaseRootRoute({})
+    const optRoute = new BaseRoute({
+      getParentRoute: () => rootRoute,
+      path: '/{-$foo}/bar',
+    })
+
+    const routeTree = rootRoute.addChildren([optRoute])
+
+    const router = createTestRouter({
+      routeTree,
+      history: createMemoryHistory({ initialEntries: ['/foo/bar'] }),
+    })
+
+    await router.load()
+
+    const location = router.buildLocation({
+      to: '/{-$foo}/bar',
+    })
+
+    expect(location.pathname).toBe('/bar')
+  })
+
+  test('params as object should not merge current params without from', async () => {
+    const rootRoute = new BaseRootRoute({})
+    const orgRoute = new BaseRoute({
+      getParentRoute: () => rootRoute,
+      path: '/orgs/$orgId',
+    })
+    const userRoute = new BaseRoute({
+      getParentRoute: () => orgRoute,
+      path: '/users/$userId',
+    })
+
+    const routeTree = rootRoute.addChildren([orgRoute.addChildren([userRoute])])
+
+    const router = createTestRouter({
+      routeTree,
+      history: createMemoryHistory({ initialEntries: ['/orgs/abc/users/123'] }),
+    })
+
+    await router.load()
+
+    const location = router.buildLocation({
+      to: '/orgs/$orgId/users/$userId',
+      params: { userId: '456' },
+    })
+
+    expect(location.pathname).toBe('/orgs/undefined/users/456')
+  })
+
+  test('omitted params should inherit params with explicit from', async () => {
+    const rootRoute = new BaseRootRoute({})
+    const orgRoute = new BaseRoute({
+      getParentRoute: () => rootRoute,
+      path: '/orgs/$orgId',
+    })
+    const userRoute = new BaseRoute({
+      getParentRoute: () => orgRoute,
+      path: '/users/$userId',
+    })
+
+    const routeTree = rootRoute.addChildren([orgRoute.addChildren([userRoute])])
+
+    const router = createTestRouter({
+      routeTree,
+      history: createMemoryHistory({ initialEntries: ['/orgs/abc/users/123'] }),
+    })
+
+    await router.load()
+
+    const location = router.buildLocation({
+      from: '/orgs/$orgId/users/$userId',
+      to: '/orgs/$orgId/users/$userId',
+    })
+
+    expect(location.pathname).toBe('/orgs/abc/users/123')
+  })
+
+  test('params as object should merge params with explicit from', async () => {
+    const rootRoute = new BaseRootRoute({})
+    const orgRoute = new BaseRoute({
+      getParentRoute: () => rootRoute,
+      path: '/orgs/$orgId',
+    })
+    const userRoute = new BaseRoute({
+      getParentRoute: () => orgRoute,
+      path: '/users/$userId',
+    })
+
+    const routeTree = rootRoute.addChildren([orgRoute.addChildren([userRoute])])
+
+    const router = createTestRouter({
+      routeTree,
+      history: createMemoryHistory({ initialEntries: ['/orgs/abc/users/123'] }),
+    })
+
+    await router.load()
+
+    const location = router.buildLocation({
+      from: '/orgs/$orgId/users/$userId',
+      to: '/orgs/$orgId/users/$userId',
+      params: { userId: '456' },
+    })
+
+    expect(location.pathname).toBe('/orgs/abc/users/456')
+  })
+
   test('params as object should merge with current params', async () => {
     const rootRoute = new BaseRootRoute({})
     const orgRoute = new BaseRoute({
diff --git a/packages/solid-router/tests/link.test.tsx b/packages/solid-router/tests/link.test.tsx
index d0fc7ae4697..2d1a628221a 100644
--- a/packages/solid-router/tests/link.test.tsx
+++ b/packages/solid-router/tests/link.test.tsx
@@ -5286,6 +5286,63 @@ describe('Link', () => {
       await runTest({ expectedPreload: false, testIdToHover: 'link-2' })
     })
   })
+
+  test('edge-case: competing optional segment links', async () => {
+    const rootRoute = createRootRoute({
+      component: () => {
+        return (
+          <>
+            <Link to="/">To index</Link>
+            <Link to="/{-$foo}/bar" params={{ foo: 'foo' }}>
+              To /foo/bar
+            </Link>
+            <Link to="/{-$foo}/bar">To /bar</Link>
+            <Outlet />
+          </>
+        )
+      },
+    })
+    const indexRoute = createRoute({
+      getParentRoute: () => rootRoute,
+      path: '/',
+      component: () => <p>index</p>,
+    })
+    const optRoute = createRoute({
+      getParentRoute: () => rootRoute,
+      path: '/{-$foo}/bar',
+      component: () => {
+        const params = useParams({ strict: false })
+        return <pre>{JSON.stringify(params())}</pre>
+      },
+    })
+
+    const router = createRouter({
+      routeTree: rootRoute.addChildren([indexRoute, optRoute]),
+      history,
+    })
+
+    render(() => <RouterProvider router={router} />)
+    expect(await screen.findByText('index')).toBeInTheDocument()
+
+    const indexLink = await screen.findByRole('link', { name: 'To index' })
+    const fooBarLink = await screen.findByRole('link', { name: 'To /foo/bar' })
+    const barLink = await screen.findByRole('link', { name: 'To /bar' })
+
+    await fireEvent.click(fooBarLink)
+    await waitFor(() =>
+      expect(fooBarLink).toHaveAttribute('aria-current', 'page'),
+    )
+    expect(barLink).not.toHaveAttribute('aria-current', 'page')
+
+    await fireEvent.click(indexLink)
+    await waitFor(() =>
+      expect(indexLink).toHaveAttribute('aria-current', 'page'),
+    )
+
+    await fireEvent.click(barLink)
+    await waitFor(() => expect(barLink).toHaveAttribute('aria-current', 'page'))
+    expect(fooBarLink).not.toHaveAttribute('aria-current', 'page')
+  })
 })
 
 describe('createLink', () => {
diff --git a/packages/vue-router/tests/link.test.tsx b/packages/vue-router/tests/link.test.tsx
index e047fe59933..6b506248d32 100644
--- a/packages/vue-router/tests/link.test.tsx
+++ b/packages/vue-router/tests/link.test.tsx
@@ -5446,6 +5446,63 @@ describe('Link', () => {
       await runTest({ expectedPreload: false, testIdToHover: 'link-2' })
     })
   })
+
+  test('edge-case: competing optional segment links', async () => {
+    const rootRoute = createRootRoute({
+      component: () => {
+        return (
+          <>
+            <Link to="/">To index</Link>
+            <Link to="/{-$foo}/bar" params={{ foo: 'foo' }}>
+              To /foo/bar
+            </Link>
+            <Link to="/{-$foo}/bar">To /bar</Link>
+            <Outlet />
+          </>
+        )
+      },
+    })
+    const indexRoute = createRoute({
+      getParentRoute: () => rootRoute,
+      path: '/',
+      component: () => <p>index</p>,
+    })
+    const optRoute = createRoute({
+      getParentRoute: () => rootRoute,
+      path: '/{-$foo}/bar',
+      component: () => {
+        const params = useParams({ strict: false })
+        return <pre>{JSON.stringify(params.value)}</pre>
+      },
+    })
+
+    const router = createRouter({
+      routeTree: rootRoute.addChildren([indexRoute, optRoute]),
+      history,
+    })
+
+    render(<RouterProvider router={router} />)
+    expect(await screen.findByText('index')).toBeInTheDocument()
+
+    const indexLink = await screen.findByRole('link', { name: 'To index' })
+    const fooBarLink = await screen.findByRole('link', { name: 'To /foo/bar' })
+    const barLink = await screen.findByRole('link', { name: 'To /bar' })
+
+    await fireEvent.click(fooBarLink)
+    await waitFor(() =>
+      expect(fooBarLink).toHaveAttribute('aria-current', 'page'),
+    )
+    expect(barLink).not.toHaveAttribute('aria-current', 'page')
+
+    await fireEvent.click(indexLink)
+    await waitFor(() =>
+      expect(indexLink).toHaveAttribute('aria-current', 'page'),
+    )
+
+    await fireEvent.click(barLink)
+    await waitFor(() => expect(barLink).toHaveAttribute('aria-current', 'page'))
+    expect(fooBarLink).not.toHaveAttribute('aria-current', 'page')
+  })
 })
 
 describe('createLink', () => {

From 1beb4b6add0ebec784798dc97a8cf692289065dc Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Thu, 30 Apr 2026 22:08:47 +0200
Subject: [PATCH 3/8] fix related unit tests

---
 packages/react-router/tests/link.test.tsx        | 14 +++++++++-----
 packages/react-router/tests/navigate.test.tsx    | 14 ++++++++++----
 packages/react-router/tests/useNavigate.test.tsx |  5 +++--
 packages/solid-router/tests/link.test.tsx        | 14 +++++++++-----
 packages/solid-router/tests/navigate.test.tsx    | 14 ++++++++++----
 packages/solid-router/tests/useNavigate.test.tsx |  5 +++--
 packages/vue-router/tests/link.test.tsx          | 14 +++++++++-----
 packages/vue-router/tests/navigate.test.tsx      | 14 ++++++++++----
 packages/vue-router/tests/useNavigate.test.tsx   |  5 +++--
 9 files changed, 66 insertions(+), 33 deletions(-)

diff --git a/packages/react-router/tests/link.test.tsx b/packages/react-router/tests/link.test.tsx
index 0f223faf369..f89536da552 100644
--- a/packages/react-router/tests/link.test.tsx
+++ b/packages/react-router/tests/link.test.tsx
@@ -6005,7 +6005,9 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>B Route</h1>
-              <Link to="..">Link to Parent</Link>
+              <Link to=".." params={true}>
+                Link to Parent
+              </Link>
             </>
           )
         },
@@ -6043,7 +6045,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
               <Link from={paramARoute.fullPath} to="..">
                 Link to .. from /param/foo/a
               </Link>
-              <Link to=".." data-testid={'link-to-previous'}>
+              <Link to=".." params={true} data-testid={'link-to-previous'}>
                 Link to .. from current active route
               </Link>
               <Outlet />
@@ -6059,7 +6061,9 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <Link to="..">Link to Parent</Link>
+              <Link to=".." params={true}>
+                Link to Parent
+              </Link>
               <Link to="." params={{ param: 'bar' }}>
                 Link to . with param:bar
               </Link>
@@ -6886,10 +6890,10 @@ describe('relative links to from route', () => {
         return (
           <>
             <h1 data-testid="post-detail-index-heading">Post Detail</h1>
-            <Link data-testid="post-info-link" to="info">
+            <Link data-testid="post-info-link" to="info" params={true}>
               To post info
             </Link>
-            <Link data-testid="post-notes-link" to="notes">
+            <Link data-testid="post-notes-link" to="notes" params={true}>
               To post notes
             </Link>
             <Link
diff --git a/packages/react-router/tests/navigate.test.tsx b/packages/react-router/tests/navigate.test.tsx
index dd7b252c48f..53dc21d0c17 100644
--- a/packages/react-router/tests/navigate.test.tsx
+++ b/packages/react-router/tests/navigate.test.tsx
@@ -195,6 +195,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { projectId: 'query' },
     })
@@ -213,6 +214,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { projectId: 'query' },
     } as any)
     await router.invalidate()
@@ -230,6 +232,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { version: 'v3' },
     })
@@ -248,6 +251,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { version: 'v3' },
     } as any)
     await router.invalidate()
@@ -265,6 +269,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { framework: 'vue' },
     })
@@ -283,6 +288,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { framework: 'vue' },
     } as any)
     await router.invalidate()
@@ -778,7 +784,7 @@ describe('router.navigate navigation using optional path parameters - object syn
     expect(router.state.location.pathname).toBe('/p/router/vue')
   })
 
-  it('should carry over optional parameters from current route when using empty params', async () => {
+  it('should carry over optional parameters from current route when params is true', async () => {
     const { router } = createOptionalParamTestRouter(
       createMemoryHistory({ initialEntries: ['/posts/tech'] }),
     )
@@ -798,7 +804,7 @@ describe('router.navigate navigation using optional path parameters - object syn
     // Navigate back to posts - should carry over 'news' from current params
     await router.navigate({
       to: '/posts/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
@@ -1039,7 +1045,7 @@ describe('router.navigate navigation using optional path parameters - parameter
     // Navigate to articles without specifying category
     await router.navigate({
       to: '/articles/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
@@ -1067,7 +1073,7 @@ describe('router.navigate navigation using optional path parameters - parameter
     // Navigate back to posts without explicit category removal
     await router.navigate({
       to: '/posts/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
diff --git a/packages/react-router/tests/useNavigate.test.tsx b/packages/react-router/tests/useNavigate.test.tsx
index b5f473885f7..0de04528e58 100644
--- a/packages/react-router/tests/useNavigate.test.tsx
+++ b/packages/react-router/tests/useNavigate.test.tsx
@@ -1659,6 +1659,7 @@ test.each([true, false])(
         (open: boolean) => {
           navigate({
             to: '.',
+            params: true,
             search: (prev: {}) => ({
               ...prev,
               [`_${name}`]: open ? true : undefined,
@@ -2352,7 +2353,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
                 Link to .. from /param/foo/a
               </button>
               <button
-                onClick={() => navigate({ to: '..' })}
+                onClick={() => navigate({ to: '..', params: true })}
                 data-testid={'link-to-previous'}
               >
                 Link to .. from current active route
@@ -2371,7 +2372,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <button onClick={() => navigate({ to: '..' })}>
+              <button onClick={() => navigate({ to: '..', params: true })}>
                 Link to Parent
               </button>
               <button
diff --git a/packages/solid-router/tests/link.test.tsx b/packages/solid-router/tests/link.test.tsx
index 2d1a628221a..d8b5e5b4961 100644
--- a/packages/solid-router/tests/link.test.tsx
+++ b/packages/solid-router/tests/link.test.tsx
@@ -5988,7 +5988,9 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>B Route</h1>
-              <Link to="..">Link to Parent</Link>
+              <Link to=".." params={true}>
+                Link to Parent
+              </Link>
             </>
           )
         },
@@ -6026,7 +6028,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
               <Link from={paramARoute.fullPath} to="..">
                 Link to .. from /param/foo/a
               </Link>
-              <Link to=".." data-testid={'link-to-previous'}>
+              <Link to=".." params={true} data-testid={'link-to-previous'}>
                 Link to .. from current active route
               </Link>
               <Outlet />
@@ -6042,7 +6044,9 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <Link to="..">Link to Parent</Link>
+              <Link to=".." params={true}>
+                Link to Parent
+              </Link>
               <Link to="." params={{ param: 'bar' }}>
                 Link to . with param:bar
               </Link>
@@ -6863,10 +6867,10 @@ describe('relative links to from route', () => {
         return (
           <>
             <h1 data-testid="post-detail-index-heading">Post Detail</h1>
-            <Link data-testid="post-info-link" to="info">
+            <Link data-testid="post-info-link" to="info" params={true}>
               To post info
             </Link>
-            <Link data-testid="post-notes-link" to="notes">
+            <Link data-testid="post-notes-link" to="notes" params={true}>
               To post notes
             </Link>
             <Link
diff --git a/packages/solid-router/tests/navigate.test.tsx b/packages/solid-router/tests/navigate.test.tsx
index fdc85abb62e..2f144dcd31f 100644
--- a/packages/solid-router/tests/navigate.test.tsx
+++ b/packages/solid-router/tests/navigate.test.tsx
@@ -196,6 +196,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { projectId: 'query' },
     })
@@ -214,6 +215,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { projectId: 'query' },
     } as any)
     await router.invalidate()
@@ -231,6 +233,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { version: 'v3' },
     })
@@ -249,6 +252,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { version: 'v3' },
     } as any)
     await router.invalidate()
@@ -266,6 +270,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { framework: 'vue' },
     })
@@ -284,6 +289,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { framework: 'vue' },
     } as any)
     await router.invalidate()
@@ -802,7 +808,7 @@ describe('router.navigate navigation using optional path parameters - object syn
     expect(router.state.location.pathname).toBe('/p/router/vue')
   })
 
-  it('should carry over optional parameters from current route when using empty params', async () => {
+  it('should carry over optional parameters from current route when params is true', async () => {
     const { router } = createOptionalParamTestRouter(
       createMemoryHistory({ initialEntries: ['/posts/tech'] }),
     )
@@ -822,7 +828,7 @@ describe('router.navigate navigation using optional path parameters - object syn
     // Navigate back to posts - should carry over 'news' from current params
     await router.navigate({
       to: '/posts/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
@@ -1063,7 +1069,7 @@ describe('router.navigate navigation using optional path parameters - parameter
     // Navigate to articles without specifying category
     await router.navigate({
       to: '/articles/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
@@ -1091,7 +1097,7 @@ describe('router.navigate navigation using optional path parameters - parameter
     // Navigate back to posts without explicit category removal
     await router.navigate({
       to: '/posts/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
diff --git a/packages/solid-router/tests/useNavigate.test.tsx b/packages/solid-router/tests/useNavigate.test.tsx
index a90b63fd4f1..7736325f194 100644
--- a/packages/solid-router/tests/useNavigate.test.tsx
+++ b/packages/solid-router/tests/useNavigate.test.tsx
@@ -1557,7 +1557,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
                 Link to .. from /param/foo/a
               </button>
               <button
-                onClick={() => navigate({ to: '..' })}
+                onClick={() => navigate({ to: '..', params: true })}
                 data-testid={'link-to-previous'}
               >
                 Link to .. from current active route
@@ -1576,7 +1576,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <button onClick={() => navigate({ to: '..' })}>
+              <button onClick={() => navigate({ to: '..', params: true })}>
                 Link to Parent
               </button>
               <button
@@ -2035,6 +2035,7 @@ describe('relative navigate to current route', () => {
         const setModal = (open: boolean) => {
           navigate({
             to: '.',
+            params: true,
             search: (prev: {}) => ({
               ...prev,
               [`_${name}`]: open ? true : undefined,
diff --git a/packages/vue-router/tests/link.test.tsx b/packages/vue-router/tests/link.test.tsx
index 6b506248d32..7301c858e42 100644
--- a/packages/vue-router/tests/link.test.tsx
+++ b/packages/vue-router/tests/link.test.tsx
@@ -6159,7 +6159,9 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>B Route</h1>
-              <Link to="..">Link to Parent</Link>
+              <Link to=".." params={true}>
+                Link to Parent
+              </Link>
             </>
           )
         },
@@ -6197,7 +6199,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
               <Link from={paramARoute.fullPath} to="..">
                 Link to .. from /param/foo/a
               </Link>
-              <Link to=".." data-testid={'link-to-previous'}>
+              <Link to=".." params={true} data-testid={'link-to-previous'}>
                 Link to .. from current active route
               </Link>
               <Outlet />
@@ -6213,7 +6215,9 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <Link to="..">Link to Parent</Link>
+              <Link to=".." params={true}>
+                Link to Parent
+              </Link>
               <Link to="." params={{ param: 'bar' }}>
                 Link to . with param:bar
               </Link>
@@ -7035,10 +7039,10 @@ describe('relative links to from route', () => {
         return (
           <>
             <h1 data-testid="post-detail-index-heading">Post Detail</h1>
-            <Link data-testid="post-info-link" to="info">
+            <Link data-testid="post-info-link" to="info" params={true}>
               To post info
             </Link>
-            <Link data-testid="post-notes-link" to="notes">
+            <Link data-testid="post-notes-link" to="notes" params={true}>
               To post notes
             </Link>
             <Link
diff --git a/packages/vue-router/tests/navigate.test.tsx b/packages/vue-router/tests/navigate.test.tsx
index b66e604dc55..89099e511ae 100644
--- a/packages/vue-router/tests/navigate.test.tsx
+++ b/packages/vue-router/tests/navigate.test.tsx
@@ -196,6 +196,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { projectId: 'query' },
     })
@@ -214,6 +215,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { projectId: 'query' },
     } as any)
     await router.invalidate()
@@ -231,6 +233,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { version: 'v3' },
     })
@@ -249,6 +252,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { version: 'v3' },
     } as any)
     await router.invalidate()
@@ -266,6 +270,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       to: '/p/$projectId/$version/$framework',
       params: { framework: 'vue' },
     })
@@ -284,6 +289,7 @@ describe('router.navigate navigation using multiple path params - object syntax
     expect(router.state.location.pathname).toBe('/p/router/v1/react')
 
     await router.navigate({
+      from: '/p/$projectId/$version/$framework',
       params: { framework: 'vue' },
     } as any)
     await router.invalidate()
@@ -802,7 +808,7 @@ describe('router.navigate navigation using optional path parameters - object syn
     expect(router.state.location.pathname).toBe('/p/router/vue')
   })
 
-  it('should carry over optional parameters from current route when using empty params', async () => {
+  it('should carry over optional parameters from current route when params is true', async () => {
     const { router } = createOptionalParamTestRouter(
       createMemoryHistory({ initialEntries: ['/posts/tech'] }),
     )
@@ -822,7 +828,7 @@ describe('router.navigate navigation using optional path parameters - object syn
     // Navigate back to posts - should carry over 'news' from current params
     await router.navigate({
       to: '/posts/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
@@ -1063,7 +1069,7 @@ describe('router.navigate navigation using optional path parameters - parameter
     // Navigate to articles without specifying category
     await router.navigate({
       to: '/articles/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
@@ -1091,7 +1097,7 @@ describe('router.navigate navigation using optional path parameters - parameter
     // Navigate back to posts without explicit category removal
     await router.navigate({
       to: '/posts/{-$category}',
-      params: {},
+      params: true,
     })
     await router.invalidate()
 
diff --git a/packages/vue-router/tests/useNavigate.test.tsx b/packages/vue-router/tests/useNavigate.test.tsx
index e71151863f7..fa584ed7ef0 100644
--- a/packages/vue-router/tests/useNavigate.test.tsx
+++ b/packages/vue-router/tests/useNavigate.test.tsx
@@ -1558,7 +1558,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
                 Link to .. from /param/foo/a
               </button>
               <button
-                onClick={() => navigate({ to: '..' })}
+                onClick={() => navigate({ to: '..', params: true })}
                 data-testid={'link-to-previous'}
               >
                 Link to .. from current active route
@@ -1577,7 +1577,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <button onClick={() => navigate({ to: '..' })}>
+              <button onClick={() => navigate({ to: '..', params: true })}>
                 Link to Parent
               </button>
               <button
@@ -2036,6 +2036,7 @@ describe('relative navigate to current route', () => {
         const setModal = (open: boolean) => {
           navigate({
             to: '.',
+            params: true,
             search: (prev: {}) => ({
               ...prev,
               [`_${name}`]: open ? true : undefined,

From cf04ac91859cc7ad755539b011dfdbce98e6bf20 Mon Sep 17 00:00:00 2001
From: "nx-cloud[bot]" <71083854+nx-cloud[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 20:22:10 +0000
Subject: [PATCH 4/8] fix related unit tests [Self-Healing CI Rerun]


From 5cd457632a1ce12ae1d229ce81b93b1e69db6409 Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Fri, 1 May 2026 12:41:05 +0200
Subject: [PATCH 5/8] relative links inherit params

---
 packages/router-core/src/router.ts | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/router-core/src/router.ts b/packages/router-core/src/router.ts
index 41e434e64ae..31dfd548cc0 100644
--- a/packages/router-core/src/router.ts
+++ b/packages/router-core/src/router.ts
@@ -1861,15 +1861,15 @@ export class RouterCore<
 
       // Resolve the next params
       const inheritParams =
-        dest.from || dest.params === true || typeof dest.params === 'function'
+        !isAbsoluteTo ||
+        dest.from ||
+        dest.params === true ||
+        typeof dest.params === 'function'
       const baseParams = inheritParams ? fromParams : Object.create(null)
       const nextParams = inheritParams
         ? dest.params === true
           ? baseParams
-          : Object.assign(
-              baseParams,
-              functionalUpdate(dest.params as any, fromParams),
-            )
+          : Object.assign(baseParams, functionalUpdate(dest.params, fromParams))
         : dest.params
           ? Object.assign(baseParams, dest.params)
           : baseParams

From 47d7c1af7c19fdb254b51a6eb0ef2e12d3a9051a Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Fri, 1 May 2026 13:01:13 +0200
Subject: [PATCH 6/8] cleanup tests

---
 packages/react-router/tests/link.test.tsx        | 14 +++++---------
 packages/react-router/tests/useNavigate.test.tsx |  5 ++---
 packages/solid-router/tests/link.test.tsx        | 14 +++++---------
 packages/solid-router/tests/useNavigate.test.tsx |  5 ++---
 packages/vue-router/tests/link.test.tsx          | 14 +++++---------
 packages/vue-router/tests/useNavigate.test.tsx   |  5 ++---
 6 files changed, 21 insertions(+), 36 deletions(-)

diff --git a/packages/react-router/tests/link.test.tsx b/packages/react-router/tests/link.test.tsx
index f89536da552..0f223faf369 100644
--- a/packages/react-router/tests/link.test.tsx
+++ b/packages/react-router/tests/link.test.tsx
@@ -6005,9 +6005,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>B Route</h1>
-              <Link to=".." params={true}>
-                Link to Parent
-              </Link>
+              <Link to="..">Link to Parent</Link>
             </>
           )
         },
@@ -6045,7 +6043,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
               <Link from={paramARoute.fullPath} to="..">
                 Link to .. from /param/foo/a
               </Link>
-              <Link to=".." params={true} data-testid={'link-to-previous'}>
+              <Link to=".." data-testid={'link-to-previous'}>
                 Link to .. from current active route
               </Link>
               <Outlet />
@@ -6061,9 +6059,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <Link to=".." params={true}>
-                Link to Parent
-              </Link>
+              <Link to="..">Link to Parent</Link>
               <Link to="." params={{ param: 'bar' }}>
                 Link to . with param:bar
               </Link>
@@ -6890,10 +6886,10 @@ describe('relative links to from route', () => {
         return (
           <>
             <h1 data-testid="post-detail-index-heading">Post Detail</h1>
-            <Link data-testid="post-info-link" to="info" params={true}>
+            <Link data-testid="post-info-link" to="info">
               To post info
             </Link>
-            <Link data-testid="post-notes-link" to="notes" params={true}>
+            <Link data-testid="post-notes-link" to="notes">
               To post notes
             </Link>
             <Link
diff --git a/packages/react-router/tests/useNavigate.test.tsx b/packages/react-router/tests/useNavigate.test.tsx
index 0de04528e58..b5f473885f7 100644
--- a/packages/react-router/tests/useNavigate.test.tsx
+++ b/packages/react-router/tests/useNavigate.test.tsx
@@ -1659,7 +1659,6 @@ test.each([true, false])(
         (open: boolean) => {
           navigate({
             to: '.',
-            params: true,
             search: (prev: {}) => ({
               ...prev,
               [`_${name}`]: open ? true : undefined,
@@ -2353,7 +2352,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
                 Link to .. from /param/foo/a
               </button>
               <button
-                onClick={() => navigate({ to: '..', params: true })}
+                onClick={() => navigate({ to: '..' })}
                 data-testid={'link-to-previous'}
               >
                 Link to .. from current active route
@@ -2372,7 +2371,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <button onClick={() => navigate({ to: '..', params: true })}>
+              <button onClick={() => navigate({ to: '..' })}>
                 Link to Parent
               </button>
               <button
diff --git a/packages/solid-router/tests/link.test.tsx b/packages/solid-router/tests/link.test.tsx
index d8b5e5b4961..2d1a628221a 100644
--- a/packages/solid-router/tests/link.test.tsx
+++ b/packages/solid-router/tests/link.test.tsx
@@ -5988,9 +5988,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>B Route</h1>
-              <Link to=".." params={true}>
-                Link to Parent
-              </Link>
+              <Link to="..">Link to Parent</Link>
             </>
           )
         },
@@ -6028,7 +6026,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
               <Link from={paramARoute.fullPath} to="..">
                 Link to .. from /param/foo/a
               </Link>
-              <Link to=".." params={true} data-testid={'link-to-previous'}>
+              <Link to=".." data-testid={'link-to-previous'}>
                 Link to .. from current active route
               </Link>
               <Outlet />
@@ -6044,9 +6042,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <Link to=".." params={true}>
-                Link to Parent
-              </Link>
+              <Link to="..">Link to Parent</Link>
               <Link to="." params={{ param: 'bar' }}>
                 Link to . with param:bar
               </Link>
@@ -6867,10 +6863,10 @@ describe('relative links to from route', () => {
         return (
           <>
             <h1 data-testid="post-detail-index-heading">Post Detail</h1>
-            <Link data-testid="post-info-link" to="info" params={true}>
+            <Link data-testid="post-info-link" to="info">
               To post info
             </Link>
-            <Link data-testid="post-notes-link" to="notes" params={true}>
+            <Link data-testid="post-notes-link" to="notes">
               To post notes
             </Link>
             <Link
diff --git a/packages/solid-router/tests/useNavigate.test.tsx b/packages/solid-router/tests/useNavigate.test.tsx
index 7736325f194..a90b63fd4f1 100644
--- a/packages/solid-router/tests/useNavigate.test.tsx
+++ b/packages/solid-router/tests/useNavigate.test.tsx
@@ -1557,7 +1557,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
                 Link to .. from /param/foo/a
               </button>
               <button
-                onClick={() => navigate({ to: '..', params: true })}
+                onClick={() => navigate({ to: '..' })}
                 data-testid={'link-to-previous'}
               >
                 Link to .. from current active route
@@ -1576,7 +1576,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <button onClick={() => navigate({ to: '..', params: true })}>
+              <button onClick={() => navigate({ to: '..' })}>
                 Link to Parent
               </button>
               <button
@@ -2035,7 +2035,6 @@ describe('relative navigate to current route', () => {
         const setModal = (open: boolean) => {
           navigate({
             to: '.',
-            params: true,
             search: (prev: {}) => ({
               ...prev,
               [`_${name}`]: open ? true : undefined,
diff --git a/packages/vue-router/tests/link.test.tsx b/packages/vue-router/tests/link.test.tsx
index 7301c858e42..6b506248d32 100644
--- a/packages/vue-router/tests/link.test.tsx
+++ b/packages/vue-router/tests/link.test.tsx
@@ -6159,9 +6159,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>B Route</h1>
-              <Link to=".." params={true}>
-                Link to Parent
-              </Link>
+              <Link to="..">Link to Parent</Link>
             </>
           )
         },
@@ -6199,7 +6197,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
               <Link from={paramARoute.fullPath} to="..">
                 Link to .. from /param/foo/a
               </Link>
-              <Link to=".." params={true} data-testid={'link-to-previous'}>
+              <Link to=".." data-testid={'link-to-previous'}>
                 Link to .. from current active route
               </Link>
               <Outlet />
@@ -6215,9 +6213,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <Link to=".." params={true}>
-                Link to Parent
-              </Link>
+              <Link to="..">Link to Parent</Link>
               <Link to="." params={{ param: 'bar' }}>
                 Link to . with param:bar
               </Link>
@@ -7039,10 +7035,10 @@ describe('relative links to from route', () => {
         return (
           <>
             <h1 data-testid="post-detail-index-heading">Post Detail</h1>
-            <Link data-testid="post-info-link" to="info" params={true}>
+            <Link data-testid="post-info-link" to="info">
               To post info
             </Link>
-            <Link data-testid="post-notes-link" to="notes" params={true}>
+            <Link data-testid="post-notes-link" to="notes">
               To post notes
             </Link>
             <Link
diff --git a/packages/vue-router/tests/useNavigate.test.tsx b/packages/vue-router/tests/useNavigate.test.tsx
index fa584ed7ef0..e71151863f7 100644
--- a/packages/vue-router/tests/useNavigate.test.tsx
+++ b/packages/vue-router/tests/useNavigate.test.tsx
@@ -1558,7 +1558,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
                 Link to .. from /param/foo/a
               </button>
               <button
-                onClick={() => navigate({ to: '..', params: true })}
+                onClick={() => navigate({ to: '..' })}
                 data-testid={'link-to-previous'}
               >
                 Link to .. from current active route
@@ -1577,7 +1577,7 @@ describe.each([{ basepath: '' }, { basepath: '/basepath' }])(
           return (
             <>
               <h1>Param B Route</h1>
-              <button onClick={() => navigate({ to: '..', params: true })}>
+              <button onClick={() => navigate({ to: '..' })}>
                 Link to Parent
               </button>
               <button
@@ -2036,7 +2036,6 @@ describe('relative navigate to current route', () => {
         const setModal = (open: boolean) => {
           navigate({
             to: '.',
-            params: true,
             search: (prev: {}) => ({
               ...prev,
               [`_${name}`]: open ? true : undefined,

From b2eac473a5f138fec15238370728aa3d063c9d56 Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Fri, 1 May 2026 13:17:06 +0200
Subject: [PATCH 7/8] dont inherit when explicitly told not to

---
 packages/router-core/src/router.ts | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/router-core/src/router.ts b/packages/router-core/src/router.ts
index 31dfd548cc0..0b2152a8eed 100644
--- a/packages/router-core/src/router.ts
+++ b/packages/router-core/src/router.ts
@@ -1861,10 +1861,11 @@ export class RouterCore<
 
       // Resolve the next params
       const inheritParams =
-        !isAbsoluteTo ||
-        dest.from ||
         dest.params === true ||
-        typeof dest.params === 'function'
+        typeof dest.params === 'function' ||
+        ((dest.from || !isAbsoluteTo) &&
+          dest.params !== false &&
+          dest.params !== null)
       const baseParams = inheritParams ? fromParams : Object.create(null)
       const nextParams = inheritParams
         ? dest.params === true

From 38a98ae219d83331ab0b417b92378891e025883d Mon Sep 17 00:00:00 2001
From: Sheraff <me@florianpellet.com>
Date: Fri, 1 May 2026 13:17:15 +0200
Subject: [PATCH 8/8] make eslint happy

---
 packages/react-router/tests/link.test.tsx | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/packages/react-router/tests/link.test.tsx b/packages/react-router/tests/link.test.tsx
index 0f223faf369..468540a3e36 100644
--- a/packages/react-router/tests/link.test.tsx
+++ b/packages/react-router/tests/link.test.tsx
@@ -5335,13 +5335,14 @@ describe('Link', () => {
       path: '/',
       component: () => <p>index</p>,
     })
+    const OptRouteComponent = () => {
+      const params = useParams({ strict: false })
+      return <pre>{JSON.stringify(params)}</pre>
+    }
     const optRoute = createRoute({
       getParentRoute: () => rootRoute,
       path: '/{-$foo}/bar',
-      component: () => {
-        const params = useParams({ strict: false })
-        return <pre>{JSON.stringify(params)}</pre>
-      },
+      component: OptRouteComponent,
     })
 
     const router = createRouter({