Fix documentation prose made stale by the dict conversions

Review findings from PR #233:

- TupleManager's docstring referred to "the tuple constants", which no
  longer exist; note the name is historical instead
- The :param regexes: docstring named the wrong wrapper (TupleManager
  instead of RegexTupleManager, whose EMPTY_REGEX fallback is
  behaviorally significant) and used a self-referential xref; point it
  at ~regexes.REGEXES like the sibling capitalization entry
- :type regexes: now says (name, compiled pattern) so readers know the
  values must be re.Pattern objects
- AGENTS.md said every config module defines a set and described
  regexes.py as wrapped in a TupleManager; two modules now define dicts
  and the wrapping happens in Constants, with RegexTupleManager
- The CAPITALIZATION_EXCEPTIONS release-log entry was missing its
  reference (#233), violating the documented release-log convention
- customize.rst promised add()/remove() on every constant; scope that
  to the set-valued ones and note dicts use normal dict operations

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: derek73

AGENTS.md

@@ -73,15 +73,15 @@ The library has two layers: `nameparser/config/` (data) and `nameparser/parser.p
 
 ### Configuration layer (`nameparser/config/`)
 
-Each module defines a plain Python set of known name pieces:
+Most modules define a plain Python set of known name pieces; `capitalization.py` and `regexes.py` define dicts:
 
 - `titles.py` — `TITLES` (prenominals) and `FIRST_NAME_TITLES` (e.g. "Sir", which treat the following name as first, not last)
 - `suffixes.py` — `SUFFIX_ACRONYMS` (with periods, e.g. "M.D.") and `SUFFIX_NOT_ACRONYMS` (e.g. "Jr.")
 - `prefixes.py` — `PREFIXES` (lastname particles, e.g. "de", "van")
 - `bound_first_names.py` — `BOUND_FIRST_NAMES` (bound given-name prefixes, e.g. "abdul", "abu"); `_join_bound_first_name` joins the first non-title piece to its following piece before the main assignment loop
 - `conjunctions.py` — `CONJUNCTIONS` (e.g. "and", "of") used to chain multi-word titles
 - `capitalization.py` — `CAPITALIZATION_EXCEPTIONS` mapping (e.g. `{'phd': 'Ph.D.'}`)
-- `regexes.py` — compiled regular expressions wrapped in a `TupleManager`
+- `regexes.py` — dict of compiled regular expressions (wrapped in `RegexTupleManager` by `Constants`)
 
 `config/__init__.py` wraps everything into `SetManager` and `TupleManager` instances inside a `Constants` class. A module-level singleton `CONSTANTS` is shared across all `HumanName` instances by default.
 

docs/customize.rst

@@ -53,9 +53,11 @@ Editable attributes of nameparser.config.CONSTANTS
 * :py:data:`~nameparser.config.CAPITALIZATION_EXCEPTIONS` - Dictionary of pieces that do not capitalize the first letter, e.g. "Ph.D".
 * :py:data:`~nameparser.config.REGEXES` - Regular expressions used to find words, initials, nicknames, etc.
 
-Each set of constants comes with :py:func:`~nameparser.config.SetManager.add` and :py:func:`~nameparser.config.SetManager.remove` methods for tuning
+Each set-valued constant comes with :py:func:`~nameparser.config.SetManager.add` and :py:func:`~nameparser.config.SetManager.remove` methods for tuning
 the constants for your project. These methods automatically lower case and
-remove punctuation to normalize them for comparison.
+remove punctuation to normalize them for comparison. The two dict-valued
+constants (``CAPITALIZATION_EXCEPTIONS`` and ``REGEXES``) are edited with
+normal dict operations.
 
 Adding Custom Nickname Delimiters
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

docs/release_log.rst

@@ -44,7 +44,7 @@ Release Log
     - Add German/Dutch last-name prefixes and title/degree suffixes; fix ``join_on_conjunctions()`` to register multi-word prefix chains (e.g. ``"von und zu"``) as prefixes, mirroring existing title handling (closes #18)
     - Change ``Constants.__repr__`` to report collection sizes and non-default scalar config, replacing the uninformative ``<Constants() instance>`` (#221)
     - Change ``REGEXES`` from a ``set`` of ``(name, pattern)`` tuples to a ``dict``, so a duplicate name is a visible overwrite in the source instead of a nondeterministic winner at import time; code iterating ``REGEXES`` directly now gets keys instead of pairs — use ``.items()`` (#227)
-    - Change ``CAPITALIZATION_EXCEPTIONS`` from a tuple of ``(key, value)`` tuples to a ``dict``; code iterating it directly now gets keys instead of pairs — use ``.items()``
+    - Change ``CAPITALIZATION_EXCEPTIONS`` from a tuple of ``(key, value)`` tuples to a ``dict``; code iterating it directly now gets keys instead of pairs — use ``.items()`` (#233)
 * 1.2.1 - June 19, 2026
     - Fix ``initials()`` interpolating the literal ``None`` for empty name parts when ``empty_attribute_default = None`` (e.g. ``"J. None D."``); empty parts now render as an empty string and a fully-empty result returns ``empty_attribute_default``
     - Add ``python -m nameparser "Name String"`` command-line helper that prints a parsed name

nameparser/config/__init__.py

@@ -154,8 +154,10 @@ def _is_dunder(attr: str) -> bool:
 
 class TupleManager(dict[str, T]):
     '''
-    A dictionary with dot.notation access. Subclass of ``dict``. Makes the tuple constants
-    more friendly.
+    A dictionary with dot.notation access. Subclass of ``dict``. Wraps the
+    mapping config constants (``capitalization_exceptions``, ``regexes``, and
+    the nickname/maiden delimiter buckets). The name is historical: before
+    1.3.0 these constants were tuples of pairs.
     '''
 
     def __getattr__(self, attr: str) -> T | None:
@@ -276,9 +278,9 @@ class Constants:
     :type capitalization_exceptions: dict or iterable of (key, value) tuples
     :param capitalization_exceptions:
         :py:attr:`~capitalization.CAPITALIZATION_EXCEPTIONS` wrapped with :py:class:`TupleManager`.
-    :type regexes: dict or iterable of (key, value) tuples
+    :type regexes: dict or iterable of (name, compiled pattern) tuples
     :param regexes:
-        :py:attr:`regexes`  wrapped with :py:class:`TupleManager`.
+        :py:attr:`~regexes.REGEXES` wrapped with :py:class:`RegexTupleManager`.
 
     :py:attr:`nickname_delimiters` and :py:attr:`maiden_delimiters` are not
     constructor arguments -- they're always set in ``__init__`` (see the