Fix wrong parameter name in namedtuple_dict_structure_factory (#723)

* Fix wrong parameter name in namedtuple_dict_structure_factory

The call to make_dict_structure_fn_from_attrs passes
_cattrs_use_detailed_validation but the function expects
_cattrs_detailed_validation. Because **kwargs catches the misnamed
parameter as an attribute override, detailed_validation is silently
ignored and always falls back to the converter default.

* Add regression test and changelog for namedtuple detailed_validation fix

Add a test that verifies the detailed_validation parameter passed
to namedtuple_dict_structure_factory is actually used and not
silently ignored. Also add a HISTORY.md entry for the fix.

* Fix namedtuple validation test

---------

Co-authored-by: Tin Tvrtkovic <tinchester@gmail.com>

Author: bysiber

HISTORY.md

@@ -15,6 +15,8 @@ Our backwards-compatibility policy can be found [here](https://github.com/python
 
 - Fix an `AttributeError` in `cattrs` internals that could be triggered by using the `include_subclasses` strategy in a `structure_hook_factory`
   ([#721](https://github.com/python-attrs/cattrs/issues/721), [#722](https://github.com/python-attrs/cattrs/pull/722))
+- Fix the `detailed_validation` parameter being passed under the wrong name in {func}`namedtuple_dict_structure_factory <cattrs.cols.namedtuple_dict_structure_factory>`, causing it to be silently ignored.
+  ([#723](https://github.com/python-attrs/cattrs/pull/723))
 
 ## 26.1.0 (2026-02-18)
 

src/cattrs/cols.py

@@ -277,7 +277,7 @@ def namedtuple_dict_structure_factory(
             cl,
             converter,
             _cattrs_forbid_extra_keys=forbid_extra_keys,
-            _cattrs_use_detailed_validation=detailed_validation,
+            _cattrs_detailed_validation=detailed_validation,
             _cattrs_use_linecache=use_linecache,
             **kwargs,
         )

tests/test_tuples.py

@@ -11,7 +11,7 @@
     namedtuple_dict_unstructure_factory,
 )
 from cattrs.converters import Converter
-from cattrs.errors import ForbiddenExtraKeysError
+from cattrs.errors import ClassValidationError, ForbiddenExtraKeysError
 
 
 def test_simple_hetero_tuples(genconverter: Converter):
@@ -141,3 +141,28 @@ class Test(NamedTuple):
 
     assert isinstance(exc, ForbiddenExtraKeysError)
     assert exc.extra_fields == {"b"}
+
+
+def test_dict_namedtuples_detailed_validation():
+    """Passing detailed_validation to namedtuple_dict_structure_factory works.
+
+    Regression test for the parameter being passed under the wrong name.
+    """
+
+    class Test(NamedTuple):
+        a: int
+
+    # Create a converter that does NOT use detailed validation by default.
+    c = Converter(detailed_validation=False)
+
+    # But explicitly enable it in the factory.
+    c.register_structure_hook_factory(
+        lambda t: t is Test,
+        lambda t, conv: namedtuple_dict_structure_factory(t, conv, True),
+    )
+
+    # With detailed validation, structuring errors should be wrapped
+    # in a ClassValidationError instead of being raised directly.
+
+    with raises(ClassValidationError):
+        c.structure({"a": "not_an_int"}, Test)