django-cfg 1.4.110__py3-none-any.whl → 1.4.111__py3-none-any.whl

django_cfg/__init__.py

@@ -32,7 +32,7 @@ Example:
 default_app_config = "django_cfg.apps.DjangoCfgConfig"
 
 # Version information
-__version__ = "1.4.110"
+__version__ = "1.4.111"
 __license__ = "MIT"
 
 # Import registry for organized lazy loading

django_cfg/modules/django_admin/base/pydantic_admin.py

@@ -521,6 +521,11 @@ class PydanticAdminMixin:
                 if doc_config.show_management_commands:
                     extra_context['management_commands'] = doc_config._discover_management_commands(app_path)
 
+                # Add Mermaid resources if plugins enabled
+                if doc_config.enable_plugins:
+                    from django_cfg.modules.django_admin.utils.mermaid_plugin import get_mermaid_resources
+                    extra_context['mermaid_resources'] = get_mermaid_resources()
+
         return super().changelist_view(request, extra_context)
 
     def changeform_view(self, request, object_id=None, form_url='', extra_context=None):
@@ -541,6 +546,11 @@ class PydanticAdminMixin:
                 if doc_config.show_management_commands:
                     extra_context['management_commands'] = doc_config._discover_management_commands(app_path)
 
+                # Add Mermaid resources if plugins enabled
+                if doc_config.enable_plugins:
+                    from django_cfg.modules.django_admin.utils.mermaid_plugin import get_mermaid_resources
+                    extra_context['mermaid_resources'] = get_mermaid_resources()
+
         return super().changeform_view(request, object_id, form_url, extra_context)
 
     def formfield_for_dbfield(self, db_field, request, **kwargs):

django_cfg/modules/django_admin/templates/django_admin/documentation_block.html

@@ -1,5 +1,11 @@
 {% load static %}
-{# Multi-Section Markdown Documentation Block with Management Commands - Used with unfold hooks #}
+{# Multi-Section Markdown Documentation Block with Management Commands and Mermaid Support #}
+
+{# Load Mermaid resources once per page #}
+{% if documentation_config.enable_plugins and not mermaid_loaded %}
+    {{ mermaid_resources|safe }}
+    {% with mermaid_loaded=True %}{% endwith %}
+{% endif %}
 
 {% if documentation_config and documentation_sections or management_commands %}
 <div class="mb-6">

django_cfg/modules/django_admin/utils/markdown_renderer.py

@@ -58,16 +58,32 @@ class MarkdownRenderer:
     _md_without_plugins = None
 
     @classmethod
-    def _get_markdown_parser(cls, enable_plugins: bool = True):
-        """Get or create markdown parser instance (singleton pattern)."""
+    def _get_markdown_parser(cls, enable_plugins: bool = True, enable_mermaid: bool = True):
+        """
+        Get or create markdown parser instance (singleton pattern).
+
+        Args:
+            enable_plugins: Enable standard mistune plugins
+            enable_mermaid: Enable Mermaid diagram support
+        """
         if not MISTUNE_AVAILABLE:
             return None
 
         if enable_plugins:
             if cls._md_with_plugins is None:
-                cls._md_with_plugins = mistune.create_markdown(
+                # Import Mermaid plugin
+                from .mermaid_plugin import mermaid_plugin
+
+                # Create markdown with standard plugins
+                md = mistune.create_markdown(
                     plugins=['strikethrough', 'table', 'url', 'task_lists', 'def_list']
                 )
+
+                # Add Mermaid plugin if enabled
+                if enable_mermaid:
+                    md = mermaid_plugin(md)
+
+                cls._md_with_plugins = md
             return cls._md_with_plugins
         else:
             if cls._md_without_plugins is None:

django_cfg/modules/django_admin/utils/mermaid_plugin.py

@@ -0,0 +1,288 @@
+"""
+Mermaid diagram plugin for Mistune markdown parser.
+
+Renders ```mermaid code blocks as interactive diagrams using Mermaid.js.
+"""
+
+import re
+from typing import Any, Dict
+
+
+def mermaid_plugin(md):
+    """
+    Mistune plugin to render Mermaid diagrams.
+
+    Detects code fences with 'mermaid' language and renders them as
+    Mermaid diagram containers that will be processed by Mermaid.js.
+
+    Usage:
+        ```mermaid
+        graph TD
+            A[Start] --> B{Decision}
+            B -->|Yes| C[OK]
+            B -->|No| D[Cancel]
+        ```
+
+    Args:
+        md: Mistune markdown instance
+    """
+
+    def render_mermaid(text: str, **attrs: Any) -> str:
+        """
+        Render Mermaid diagram HTML.
+
+        Args:
+            text: Mermaid diagram code
+            **attrs: Additional attributes
+
+        Returns:
+            HTML with Mermaid container
+        """
+        # Generate unique ID for this diagram
+        import hashlib
+        diagram_id = f"mermaid-{hashlib.md5(text.encode()).hexdigest()[:8]}"
+
+        # Escape HTML special characters but preserve Mermaid syntax
+        escaped_text = text.strip()
+
+        # Return HTML container with Mermaid code
+        return f'''<div class="mermaid-container">
+    <div class="mermaid-wrapper">
+        <pre class="mermaid" id="{diagram_id}">
+{escaped_text}
+        </pre>
+    </div>
+</div>'''
+
+    # Override code block renderer for mermaid language
+    original_code = md.renderer.block_code
+
+    def patched_code(code: str, info: str = None, **attrs: Any) -> str:
+        """
+        Patched code block renderer that checks for mermaid language.
+
+        Args:
+            code: Code content
+            info: Language info
+            **attrs: Additional attributes
+
+        Returns:
+            Rendered code block (either Mermaid or normal code)
+        """
+        if info and info.strip().lower() == 'mermaid':
+            return render_mermaid(code, **attrs)
+        return original_code(code, info, **attrs)
+
+    md.renderer.block_code = patched_code
+
+    return md
+
+
+def get_mermaid_styles() -> str:
+    """
+    Get CSS styles for Mermaid diagrams with Unfold semantic colors.
+
+    Returns:
+        CSS string for Mermaid container styling
+    """
+    return """
+<style>
+    /* Mermaid container styles with Unfold semantic colors */
+    .mermaid-container {
+        margin: 1.5rem 0;
+        padding: 0;
+    }
+
+    .mermaid-wrapper {
+        border: 1px solid rgb(var(--color-base-200));
+        border-radius: 0.5rem;
+        padding: 1.5rem;
+        background: rgb(var(--color-base-50));
+        overflow-x: auto;
+    }
+
+    /* Dark mode styles with semantic colors */
+    .dark .mermaid-wrapper {
+        border-color: rgb(var(--color-base-700));
+        background: rgb(var(--color-base-900));
+    }
+
+    /* Mermaid diagram */
+    .mermaid {
+        display: flex;
+        justify-content: center;
+        background: transparent !important;
+        border: none !important;
+        padding: 0 !important;
+        margin: 0 !important;
+        font-family: inherit !important;
+    }
+
+    /* Ensure diagrams are centered */
+    .mermaid svg {
+        max-width: 100%;
+        height: auto;
+    }
+
+    /* Loading state with semantic colors */
+    .mermaid[data-processed="false"] {
+        color: rgb(var(--color-base-400));
+        text-align: center;
+        padding: 2rem;
+    }
+
+    .dark .mermaid[data-processed="false"] {
+        color: rgb(var(--color-base-500));
+    }
+
+    /* Error state with semantic colors */
+    .mermaid.error {
+        color: rgb(239, 68, 68);
+        border: 1px solid rgb(252, 165, 165);
+        background: rgb(254, 242, 242);
+        padding: 1rem;
+        border-radius: 0.375rem;
+    }
+
+    .dark .mermaid.error {
+        color: rgb(248, 113, 113);
+        border-color: rgb(153, 27, 27);
+        background: rgb(127, 29, 29);
+    }
+</style>
+"""
+
+
+def get_mermaid_script(theme: str = "default") -> str:
+    """
+    Get Mermaid.js initialization script with Unfold semantic colors.
+
+    Args:
+        theme: Mermaid theme ('default', 'dark', 'forest', 'neutral')
+
+    Returns:
+        HTML script tag with Mermaid.js and initialization
+    """
+    return f"""
+<script type="module">
+    import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
+
+    // Helper to get CSS variable value
+    function getCSSVar(name) {{
+        const value = getComputedStyle(document.documentElement).getPropertyValue(name).trim();
+        // Convert "R, G, B" format to "#RRGGBB"
+        if (value.includes(',')) {{
+            const [r, g, b] = value.split(',').map(x => parseInt(x.trim()));
+            return '#' + [r, g, b].map(x => x.toString(16).padStart(2, '0')).join('');
+        }}
+        return value;
+    }}
+
+    // Auto-detect dark mode
+    const isDarkMode = document.documentElement.classList.contains('dark') ||
+                       window.matchMedia('(prefers-color-scheme: dark)').matches;
+
+    // Get Unfold semantic colors
+    function getThemeColors() {{
+        if (isDarkMode) {{
+            return {{
+                primaryColor: '#3b82f6',
+                primaryTextColor: getCSSVar('--color-base-100'),
+                primaryBorderColor: getCSSVar('--color-base-700'),
+                lineColor: getCSSVar('--color-base-600'),
+                secondaryColor: getCSSVar('--color-base-800'),
+                tertiaryColor: getCSSVar('--color-base-700'),
+                background: getCSSVar('--color-base-900'),
+                mainBkg: getCSSVar('--color-base-800'),
+                secondBkg: getCSSVar('--color-base-700'),
+                border1: getCSSVar('--color-base-700'),
+                border2: getCSSVar('--color-base-600'),
+                note: getCSSVar('--color-base-800'),
+                noteText: getCSSVar('--color-base-200'),
+                noteBorder: getCSSVar('--color-base-600'),
+                text: getCSSVar('--color-base-200'),
+                critical: '#ef4444',
+                done: '#10b981',
+                active: '#3b82f6',
+            }};
+        }} else {{
+            return {{
+                primaryColor: '#2563eb',
+                primaryTextColor: getCSSVar('--color-base-900'),
+                primaryBorderColor: getCSSVar('--color-base-300'),
+                lineColor: getCSSVar('--color-base-400'),
+                secondaryColor: getCSSVar('--color-base-100'),
+                tertiaryColor: '#ffffff',
+                background: '#ffffff',
+                mainBkg: getCSSVar('--color-base-50'),
+                secondBkg: '#ffffff',
+                border1: getCSSVar('--color-base-300'),
+                border2: getCSSVar('--color-base-200'),
+                note: '#fef3c7',
+                noteText: getCSSVar('--color-base-900'),
+                noteBorder: '#fbbf24',
+                text: getCSSVar('--color-base-900'),
+                critical: '#dc2626',
+                done: '#059669',
+                active: '#2563eb',
+            }};
+        }}
+    }}
+
+    // Initialize Mermaid with Unfold semantic colors
+    mermaid.initialize({{
+        startOnLoad: true,
+        theme: 'base',
+        securityLevel: 'loose',
+        fontFamily: 'ui-sans-serif, system-ui, sans-serif',
+        themeVariables: getThemeColors()
+    }});
+
+    // Listen for dark mode changes and re-render
+    const observer = new MutationObserver((mutations) => {{
+        mutations.forEach((mutation) => {{
+            if (mutation.attributeName === 'class') {{
+                // Re-initialize with new theme colors
+                mermaid.initialize({{
+                    startOnLoad: true,
+                    theme: 'base',
+                    securityLevel: 'loose',
+                    fontFamily: 'ui-sans-serif, system-ui, sans-serif',
+                    themeVariables: getThemeColors()
+                }});
+                // Re-render all diagrams
+                mermaid.run({{
+                    querySelector: '.mermaid',
+                }});
+            }}
+        }});
+    }});
+
+    observer.observe(document.documentElement, {{
+        attributes: true,
+        attributeFilter: ['class'],
+    }});
+
+    // Error handling
+    window.addEventListener('error', (event) => {{
+        if (event.message && event.message.includes('mermaid')) {{
+            console.error('Mermaid error:', event);
+            const mermaidElements = document.querySelectorAll('.mermaid[data-processed="false"]');
+            mermaidElements.forEach(el => {{
+                el.classList.add('error');
+                el.textContent = 'Error rendering diagram. Check console for details.';
+            }});
+        }}
+    }});
+</script>
+"""
+
+
+def get_mermaid_resources() -> str:
+    """
+    Get complete Mermaid resources (styles + script).
+
+    Returns:
+        HTML string with styles and script for Mermaid support
+    """
+    return get_mermaid_styles() + get_mermaid_script()

django_cfg/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "django-cfg"
-version = "1.4.110"
+version = "1.4.111"
 description = "Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features."
 readme = "README.md"
 keywords = [ "django", "configuration", "pydantic", "settings", "type-safety", "pydantic-settings", "django-environ", "startup-validation", "ide-autocomplete", "nextjs-admin", "react-admin", "websocket", "centrifugo", "real-time", "typescript-generation", "ai-agents", "enterprise-django", "django-settings", "type-safe-config", "modern-django",]

{django_cfg-1.4.110.dist-info → django_cfg-1.4.111.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-cfg
-Version: 1.4.110
+Version: 1.4.111
 Summary: Modern Django framework with type-safe Pydantic v2 configuration, Next.js admin integration, real-time WebSockets, and 8 enterprise apps. Replace settings.py with validated models, 90% less code. Production-ready with AI agents, auto-generated TypeScript clients, and zero-config features.
 Project-URL: Homepage, https://djangocfg.com
 Project-URL: Documentation, https://djangocfg.com

{django_cfg-1.4.110.dist-info → django_cfg-1.4.111.dist-info}/RECORD

@@ -1,5 +1,5 @@
 django_cfg/README.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_cfg/__init__.py,sha256=HbtRDtHlqf7LLLnJjYEq_tMe99Y4cjV_Kx8txhAOD_k,1621
+django_cfg/__init__.py,sha256=nlFfAVPhDfA96placDSiyW_fDaW9Op6e1pCYQC1crb4,1621
 django_cfg/apps.py,sha256=72m3uuvyqGiLx6gOfE-BD3P61jddCCERuBOYpxTX518,1605
 django_cfg/config.py,sha256=y4Z3rnYsHBE0TehpwAIPaxr---mkvyKrZGGsNwYso74,1398
 django_cfg/apps/__init__.py,sha256=JtDmEYt1OcleWM2ZaeX0LKDnRQzPOavfaXBWG4ECB5Q,26
@@ -670,7 +670,7 @@ django_cfg/modules/__init__.py,sha256=Ip9WMpzImEwIAywpFwU056_v0O9oIGG7nCT1YSArxk
 django_cfg/modules/base.py,sha256=Grmgxc5dvnAEM1sudWEWO4kv8L0Ks-y32nxTk2vwdjQ,6272
 django_cfg/modules/django_admin/__init__.py,sha256=ncTMbxR7ccVd5xS-sZE_yJODjVMFq8HDFaDnP6lyvIg,3328
 django_cfg/modules/django_admin/base/__init__.py,sha256=tzre09bnD_SlS-pA30WzYZRxyvch7eLq3q0wLEcZOmc,118
-django_cfg/modules/django_admin/base/pydantic_admin.py,sha256=EZnkPFXDHvqR-JtDfYvJfg5_Nocn7svgXvQdVsTbv9A,24389
+django_cfg/modules/django_admin/base/pydantic_admin.py,sha256=6tB_8hZLT3ZzwUu6rlvzhkQ_BkDq8niaTE3TIa0IcgM,24977
 django_cfg/modules/django_admin/base/unfold_admin.py,sha256=iqpRWSkzW5HktXDuuG7G3J6RoIfW48dWPMJTa7Yk08g,729
 django_cfg/modules/django_admin/config/__init__.py,sha256=HDuJxhAS27EiL1pXLNvMePREB2gfoS2i_0Ur1ITCjAM,926
 django_cfg/modules/django_admin/config/action_config.py,sha256=JjS01JxLT-FzUVq7RlKaB7L38wmVL8uibXO_iXZcljo,1668
@@ -691,7 +691,7 @@ django_cfg/modules/django_admin/models/base.py,sha256=fmgS-X3GAGEBXiBy4OQGeOMzB7
 django_cfg/modules/django_admin/models/display_models.py,sha256=rONmja60Qz8n4qNvzjXIQryO_-UGZK136SrElO8iFfM,1087
 django_cfg/modules/django_admin/templates/django_admin/change_form_docs.html,sha256=MtP-UKebcOdz6YsZxLV5-UFq6WfmlV3mEF7qsCdYOKg,815
 django_cfg/modules/django_admin/templates/django_admin/change_list_docs.html,sha256=MfH6mf9v6E3y97TjvjvZ2A7RMhOkKd6CtxEw3tPV5WE,802
-django_cfg/modules/django_admin/templates/django_admin/documentation_block.html,sha256=IHB1dDGavvHNnez6modI1wJxvoXuZSQmsBu0nheYcZA,13974
+django_cfg/modules/django_admin/templates/django_admin/documentation_block.html,sha256=fDUZYDWuB68NOm4fjTr0OLfqG2m-UpE-MZL1upkUNHc,14174
 django_cfg/modules/django_admin/templates/django_admin/markdown_docs_block.html,sha256=nO9oEyDYozYF-euaLzE0Cn_Yo_LGUlta-BsRgShDG10,1992
 django_cfg/modules/django_admin/utils/CODE_BLOCK_DOCS.md,sha256=rp5qMG-Ci30fIs6EyZctjEbhQwxfNq9e36B4CTZOnR0,9456
 django_cfg/modules/django_admin/utils/__init__.py,sha256=5V1Og6fpIpRqDIoqF7jYnBmPl9TjV5kByghzT6iOpPs,745
@@ -699,7 +699,8 @@ django_cfg/modules/django_admin/utils/badges.py,sha256=eZ1UThdwvv2cHAIDc4vTrD5xA
 django_cfg/modules/django_admin/utils/decorators.py,sha256=s4jTcgPklY4T4xjXsMHpShd71K_LzgKogem9JKBgNzk,8371
 django_cfg/modules/django_admin/utils/displays.py,sha256=f-FT1mD-X56X6xLDJ9FuCi4oz_UYirdLosYrXnJP3hI,7862
 django_cfg/modules/django_admin/utils/html_builder.py,sha256=EMzz1rGJCM7jTgfWb8LKqSdok1oq_oaWbBk6v9qvCrU,12831
-django_cfg/modules/django_admin/utils/markdown_renderer.py,sha256=nrMopdVA114W_UOvYFUtnbfj_Di0LHmtmrxG53hsn_Y,13834
+django_cfg/modules/django_admin/utils/markdown_renderer.py,sha256=eMYde8cDo9y5CO5qNjy7juYe_OPpSpFB1-d84ylpbk4,14324
+django_cfg/modules/django_admin/utils/mermaid_plugin.py,sha256=37x_0FQE5IyR6TiaDZDrQQHeQmAsPtlZBnq5N8eAKqA,8889
 django_cfg/modules/django_admin/widgets/__init__.py,sha256=mmPw5FMYR21GDGFMr-MOCcdM4G2_ZR60ClInHjdnTBE,115
 django_cfg/modules/django_admin/widgets/registry.py,sha256=q0Yyaze5ZTYLJslPyX9e4Few_FGLnGBQwtNln9Okyt4,5610
 django_cfg/modules/django_client/__init__.py,sha256=iHaGKbsyR2wMmVCWNsETC7cwB60fZudvnFMiK1bchW8,529
@@ -1053,9 +1054,9 @@ django_cfg/utils/version_check.py,sha256=WO51J2m2e-wVqWCRwbultEwu3q1lQasV67Mw2aa
 django_cfg/CHANGELOG.md,sha256=jtT3EprqEJkqSUh7IraP73vQ8PmKUMdRtznQsEnqDZk,2052
 django_cfg/CONTRIBUTING.md,sha256=DU2kyQ6PU0Z24ob7O_OqKWEYHcZmJDgzw-lQCmu6uBg,3041
 django_cfg/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg/pyproject.toml,sha256=lz106jlJ2YsUxr9D0NqVgp5x2TZSNT1vbTrZ_YaeydQ,8637
-django_cfg-1.4.110.dist-info/METADATA,sha256=xG_TAByn-K2qm3HlL_4cMNNHz4UpMrpV5hVIzTNGdKU,23836
-django_cfg-1.4.110.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-django_cfg-1.4.110.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
-django_cfg-1.4.110.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
-django_cfg-1.4.110.dist-info/RECORD,,
+django_cfg/pyproject.toml,sha256=gPSeLcWnzT8nOM1SW0-4PTlRjLnYYLTqGXeRnoDXN5w,8637
+django_cfg-1.4.111.dist-info/METADATA,sha256=zMEB1rQo52w6G3TcTEChugaK1CMRMdkJ9ClhP0VzcJ0,23836
+django_cfg-1.4.111.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+django_cfg-1.4.111.dist-info/entry_points.txt,sha256=Ucmde4Z2wEzgb4AggxxZ0zaYDb9HpyE5blM3uJ0_VNg,56
+django_cfg-1.4.111.dist-info/licenses/LICENSE,sha256=xHuytiUkSZCRG3N11nk1X6q1_EGQtv6aL5O9cqNRhKE,1071
+django_cfg-1.4.111.dist-info/RECORD,,