Document name transform configuration

- Document built-in transform names and custom transform callbacks
- Show string and per-kind mapping examples for pyproject and YAML config
- Explain config precedence, prefix stripping, explicit renames, and enum value handling

Author: virtuald

docs/config/autowrap.rst

@@ -61,11 +61,73 @@ generated by semiwrap. In your ``meson.build`` after you include the generated
    )
 
 
+Name transforms
+---------------
+
+Generated Python names for functions, methods, attributes/properties, and enum
+values can be configured with ``name_transform``. Explicit ``rename`` entries are
+final and are not transformed.
+
+Precedence is:
+
+#. YAML ``name_transform``
+#. ``[tool.semiwrap.extension_modules."pkg.name"].name_transform``
+#. ``[tool.semiwrap].name_transform``
+#. built-in ``default`` behavior
+
+``name_transform`` may be a string or a mapping. String form applies to all
+transformable kinds, including enum values:
+
+.. code-block:: yaml
+
+   name_transform: snake_case
+
+Mapping form can configure each kind separately:
+
+.. code-block:: yaml
+
+   name_transform:
+     default: snake_case
+     method: camelCase
+     attribute: none
+     enum_value: PascalCase
+
+Mapping keys are ``default``, ``function``, ``method``, ``attribute``, and
+``enum_value``. Missing kind-specific keys use ``default``. Mapping values merge
+across precedence levels, so a YAML file can override only one kind while
+preserving project-level settings. A string value applies to every kind at that
+precedence level.
+
+Built-ins are:
+
+* ``none``: passes the C++ name directly through without changing case.
+* ``default``: function and method names lowercase the first character unless
+  the first two characters are uppercase, while attribute and enum value names
+  are unchanged.
+* ``camelCase``: converts names to lower camel case, such as ``GetFoo`` or
+  ``get_foo`` becoming ``getFoo``.
+* ``snake_case``: converts names to lowercase words separated by underscores,
+  such as ``GetFoo`` or ``getFoo`` becoming ``get_foo``.
+* ``PascalCase``: converts names to upper camel case, such as ``getFoo`` or
+  ``get_foo`` becoming ``GetFoo``.
+* ``CAPS_CASE``: converts names to uppercase words separated by underscores,
+  such as ``GetFoo`` or ``getFoo`` becoming ``GET_FOO``.
+
+Custom transforms use ``custom: package.name:function`` and receive
+``(name: str, kind: str)`` where kind is ``function``, ``method``,
+``attribute``, or ``enum_value``.
+
+Enum value transforms run after semiwrap's existing enum value prefix stripping.
+``rename`` on an enum value remains exact and is not transformed.
+
 Reference
 ---------
 
-The following strctures describe the dictionaries that are read from the YAML
+The following structures describe the dictionaries that are read from the YAML
 files. The toplevel structure is :class:`.AutowrapConfigYaml`.
 
+.. autoclass:: semiwrap.name_transform.NameTransformConfig
+   :members:
+
 .. automodule:: semiwrap.config.autowrap_yml
    :members: