Merge branch '2.x' into improve/route-url-branded-type

Author: pataar

CHANGELOG.md

@@ -8,6 +8,13 @@ Breaking changes are marked with ⚠️.
 
 ## [Unreleased]
 
+## [v2.6.2] - 2026-03-05
+
+**Fixed**
+
+* Fix shared route bindings mutation in _substituteBindings by @pataar in https://github.com/tighten/ziggy/pull/875
+* fix: handle falsy parameter values in _parse by @pataar in https://github.com/tighten/ziggy/pull/876
+
 ## [v2.6.1] - 2026-02-16
 
 **Changed**
@@ -510,7 +517,8 @@ See [UPGRADING](UPGRADING.md#upgrading-from-1x-to-2x) for detailed upgrade instr
 
 For previous changes see the [Releases](https://github.com/tighten/ziggy/releases) page.
 
-[Unreleased]: https://github.com/tighten/ziggy/compare/v2.6.1...HEAD
+[Unreleased]: https://github.com/tighten/ziggy/compare/v2.6.2...HEAD
+[v2.6.2]: https://github.com/tighten/ziggy/compare/v2.6.1...v2.6.2
 [v2.6.1]: https://github.com/tighten/ziggy/compare/v2.6.0...v2.6.1
 [v2.6.0]: https://github.com/tighten/ziggy/compare/v2.5.3...v2.6.0
 [v2.5.3]: https://github.com/tighten/ziggy/compare/v2.5.2...v2.5.3

README.md

@@ -2,7 +2,7 @@
 
 # Ziggy – Use your Laravel routes in JavaScript
 
-[![GitHub Actions Status](https://img.shields.io/github/actions/workflow/status/tighten/ziggy/test.yml?branch=main&style=flat)](https://github.com/tighten/ziggy/actions?query=workflow:Tests+branch:main)
+[![GitHub Actions Status](https://img.shields.io/github/actions/workflow/status/tighten/ziggy/test.yml?branch=main&style=flat)](https://github.com/tighten/ziggy/actions?query=workflow:Test+branch:2.x)
 [![Latest Version on Packagist](https://img.shields.io/packagist/v/tightenco/ziggy.svg?style=flat)](https://packagist.org/packages/tightenco/ziggy)
 [![Downloads on Packagist](https://img.shields.io/packagist/dt/tightenco/ziggy.svg?style=flat)](https://packagist.org/packages/tightenco/ziggy)
 [![Latest Version on NPM](https://img.shields.io/npm/v/ziggy-js.svg?style=flat)](https://npmjs.com/package/ziggy-js)

dist/index.esm.js

@@ -1,6 +1,6 @@
 {
     "name": "ziggy-js",
-    "version": "2.6.1",
+    "version": "2.6.2",
     "description": "Use your Laravel named routes in JavaScript.",
     "keywords": [
         "laravel",

dist/index.js

@@ -263,7 +263,7 @@ export default class Router extends String {
             );
         } else if (
             segments.length === 1 &&
-            !params[segments[0].name] &&
+            !params.hasOwnProperty(segments[0].name) &&
             (params.hasOwnProperty(Object.values(route.bindings)[0]) || params.hasOwnProperty('id'))
         ) {
             // If there is only one template segment and `params` is an object, that object is
@@ -321,18 +321,19 @@ export default class Router extends String {
                 return { ...result, [key]: value };
             }
 
-            if (!value.hasOwnProperty(bindings[key])) {
-                if (value.hasOwnProperty('id')) {
-                    // As a fallback, we still accept an 'id' key not explicitly registered as a binding
-                    bindings[key] = 'id';
-                } else {
-                    throw new Error(
-                        `Ziggy error: object passed as '${key}' parameter is missing route model binding key '${bindings[key]}'.`,
-                    );
-                }
+            const binding = value.hasOwnProperty(bindings[key])
+                ? bindings[key]
+                : value.hasOwnProperty('id')
+                  ? 'id'
+                  : undefined;
+
+            if (binding === undefined) {
+                throw new Error(
+                    `Ziggy error: object passed as '${key}' parameter is missing route model binding key '${bindings[key]}'.`,
+                );
             }
 
-            return { ...result, [key]: value[bindings[key]] };
+            return { ...result, [key]: value[binding] };
         }, {});
     }
 

dist/route.umd.js

@@ -437,6 +437,16 @@ describe('route()', () => {
         );
     });
 
+    test("falling back to 'id' key does not mutate registered route model bindings", () => {
+        expect(route('postComments.show', [1, { id: 1 }])).toBe(
+            'https://ziggy.dev/posts/1/comments/1',
+        );
+
+        expect(route('postComments.show', [1, { id: 1, uuid: '1-2-3' }])).toBe(
+            'https://ziggy.dev/posts/1/comments/1-2-3',
+        );
+    });
+
     test('can generate a URL for an app installed in a subfolder', () => {
         global.Ziggy.url = 'https://ziggy.dev/subfolder';
 
@@ -593,6 +603,10 @@ describe('route()', () => {
         expect(route('posts.update', 0)).toBe('https://ziggy.dev/posts/0');
     });
 
+    test('can handle an object parameter with a falsy value for the segment name', () => {
+        expect(route('posts.show', { post: 0 })).toBe('https://ziggy.dev/posts/0');
+    });
+
     test('can accept a custom Ziggy configuration object', () => {
         const config = {
             url: 'http://notYourAverage.dev',