Remove matplotlib from autodoc mock imports and add custom mock for rcParams assignment

Author: sergioburdisso

docs/conf.py

@@ -37,7 +37,7 @@ def add_line(self, line: str, source: str, *lineno: int) -> None:
 # Mock imports for Sphinx documentation generation
 autodoc_mock_imports = [
     # Heavy / optional scientific stack
-    'numpy', 'pandas', 'scipy', 'torch', 'transformers', 'sklearn', 'matplotlib', 'networkx',
+    'numpy', 'pandas', 'scipy', 'torch', 'transformers', 'sklearn', 'networkx',
     # Embedding / NLP helper libs
     'sentence_transformers', 'simpleneighbors', 'syllables',
     # LangChain ecosystem
@@ -51,6 +51,21 @@ def add_line(self, line: str, source: str, *lineno: int) -> None:
     'tqdm', 'print_color', 'jinja2', 'graphviz', 'PIL', 'tenacity', 'joblib'
 ]
 
+# Custom mock for matplotlib to handle rcParams assignment
+from unittest.mock import MagicMock
+
+class MockRcParams(dict):
+    """Mock rcParams that behaves like a dict and supports item assignment."""
+    def __setitem__(self, key, value):
+        super().__setitem__(key, value)
+
+class MockMatplotlib(MagicMock):
+    """Mock matplotlib with properly configured rcParams."""
+    rcParams = MockRcParams()
+    
+sys.modules['matplotlib'] = MockMatplotlib()
+sys.modules['matplotlib.pyplot'] = MagicMock()
+
 # -- Project version ---------------------------------------------------------
 
 _version_re__ = r"__version__\s*=\s*['\"]([^'\"]+)['\"]"