feat: Update README and documentation to include masks utilities; bump version to 1.1.9

Co-authored-by: Copilot <copilot@github.com>

Author: kelsoncm

README.md

@@ -8,10 +8,32 @@
 [![Docs](https://github.com/kelsoncm/python-sc4py/actions/workflows/docs.yml/badge.svg)](https://kelsoncm.github.io/python-sc4py/)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
 
-Utilities for date/time, environment parsing, dynamic class loading, percentages, string-to-bool conversion, choice tuples, and in-memory ZIP reading.
+Utilities for date/time, environment parsing, dynamic class loading, percentages, string-to-bool conversion, choice tuples,
+in-memory ZIP reading, and advanced string masking/validation (CPF/CNPJ, DVs, etc).
 
 > See each package's [documentation](https://kelsoncm.github.io/python-sc4py/) for details and usage examples.
 
+## Masks utilities (CPF/CNPJ, DVs, etc)
+
+```python
+from sc4py.masks import apply_mask, validate_masked_value, validate_mask, validate_mod11, validate_dv_by_mask
+
+# Apply a mask
+print(apply_mask('12345678901', '###.###.###-##'))  # '123.456.789-01'
+
+# Validate masked value
+print(validate_masked_value('12345678901', '###.###.###-##'))  # '123.456.789-01'
+
+# Validate mask
+validate_mask('###.###-##')
+
+# Validate mod11 DV
+validate_mod11('12345678909', 11, 2)
+
+# Validate value and DV by mask
+print(validate_dv_by_mask('12345678909', '#########00'))  # '12345678909'
+```
+
 ## Installation
 
 ```bash

docs/index.rst

@@ -46,13 +46,13 @@ Installation
 Modules
 -------
 
-* :doc:`sc4py.choice <sc4py.choice>` - Convert plain values and `Enum` types to Django-style choice tuples
 * :doc:`sc4py.datetime <sc4py.datetime>` - Date/time helpers and `daterange` generator
 * :doc:`sc4py.env <sc4py.env>` - Type-safe environment variable reading
 * :doc:`sc4py.klass <sc4py.klass>` - Dynamic class instantiation from dotted path strings
 * :doc:`sc4py.number <sc4py.number>` - Percentage calculation
 * :doc:`sc4py.str <sc4py.str>` - Multilingual boolean string parsing
 * :doc:`sc4py.zip <sc4py.zip>` - In-memory ZIP extraction (text and CSV)
+* :doc:`sc4py.masks <sc4py.masks>` - String masking, validation and DV utilities (mod11)
 
 Quick start
 -----------

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sc4py"
-version = "1.1.7"
+version = "1.1.9"
 description = "Python library specific brazilian validations"
 readme = "README.md"
 license = { file = "LICENSE.md" }
@@ -48,7 +48,7 @@ where = ["."]
 include = ["sc4py*"]
 
 [tool.coverage.run]
-source = ["pyfwf"]
+source = ["sc4py"]
 omit = ["tests/*", "sandbox/*"]
 
 [tool.coverage.report]