deepdoc 2.3.3__tar.gz → 2.3.5__tar.gz

{deepdoc-2.3.3 → deepdoc-2.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepdoc
-Version: 2.3.3
+Version: 2.3.5
 Summary: Auto-generate beautiful docs from any codebase
 Author: Pranav Kumar
 License: MIT

{deepdoc-2.3.3 → deepdoc-2.3.5}/deepdoc/__init__.py

@@ -1,3 +1,3 @@
 """DeepDoc — Auto-generate beautiful docs from any codebase."""
 
-__version__ = "2.3.3"
+__version__ = "2.3.5"

{deepdoc-2.3.3 → deepdoc-2.3.5}/deepdoc/generator/generation.py

@@ -613,6 +613,9 @@ class BucketGenerationEngine:
             content = repair_dangling_plain_fences(content)
             content = normalize_fumadocs_directives(content)
             content = fix_frontmatter_description(content)
+            content = fix_bare_language_markers(content)
+            content = fix_bare_mermaid_fences(content)
+            content = fix_leaf_card_directives(content)
             content = escape_mdx_angle_hazards(content)
             content = repair_internal_doc_links(
                 content,
@@ -652,6 +655,10 @@ class BucketGenerationEngine:
                     content = repair_unbalanced_code_fences(content)
                     content = normalize_explanatory_lines_outside_fences(content)
                     content = repair_dangling_plain_fences(content)
+                    content = normalize_fumadocs_directives(content)
+                    content = fix_frontmatter_description(content)
+                    content = fix_bare_mermaid_fences(content)
+                    content = fix_leaf_card_directives(content)
                     content = escape_mdx_angle_hazards(content)
                     content = repair_internal_doc_links(
                         content,
@@ -694,6 +701,10 @@ class BucketGenerationEngine:
                     content = repair_unbalanced_code_fences(content)
                     content = normalize_explanatory_lines_outside_fences(content)
                     content = repair_dangling_plain_fences(content)
+                    content = normalize_fumadocs_directives(content)
+                    content = fix_frontmatter_description(content)
+                    content = fix_bare_mermaid_fences(content)
+                    content = fix_leaf_card_directives(content)
                     content = escape_mdx_angle_hazards(content)
                     content = repair_internal_doc_links(
                         content,

{deepdoc-2.3.3 → deepdoc-2.3.5}/deepdoc/generator/post_processors.py

@@ -851,6 +851,86 @@ def fix_frontmatter_description(content: str) -> str:
     )
 
 
+def fix_bare_mermaid_fences(content: str) -> str:
+    """Repair mermaid diagrams where the LLM omitted the opening code fence.
+
+    The LLM sometimes writes just the word 'mermaid' on its own line followed
+    by diagram content and a closing ``` — instead of the correct ```mermaid
+    opening fence.  This produces a bare 'mermaid' paragraph in MDX and leaves
+    the diagram body (including {node} labels) unescaped, causing acorn parse
+    errors.
+
+    Pattern matched:
+        <text ending in : or .\n>
+        mermaid\n
+        <diagram type line, e.g. sequenceDiagram>\n
+        ...diagram body...
+        ```
+    """
+    return re.sub(
+        r'(?m)^mermaid\n(?=(sequenceDiagram|flowchart|graph|classDiagram|stateDiagram|erDiagram|gantt|pie|gitGraph|mindmap|timeline|journey|quadrantChart|xychart|block|packet|kanban|architecture))',
+        '```mermaid\n',
+        content,
+    )
+
+
+def fix_bare_language_markers(content: str) -> str:
+    """Repair lines where the LLM appended ':language' instead of opening a fence.
+
+    The LLM sometimes writes:
+        Some description text:typescript
+        interface Foo { ... }
+        ```
+
+    instead of:
+        Some description text
+        ```typescript
+        interface Foo { ... }
+        ```
+
+    The bare ':language' suffix leaves the code content in free MDX body,
+    causing acorn parse errors on any {expression} inside.
+    """
+    _LANGS = (
+        r"typescript|javascript|python|bash|json|yaml|tsx|jsx"
+        r"|go|rust|java|css|html|sql|sh|text|plaintext|ruby|php|c|cpp|swift"
+    )
+    return re.sub(
+        rf"^(.*\S):({_LANGS})\s*$",
+        lambda m: f"{m.group(1)}\n```{m.group(2)}",
+        content,
+        flags=re.MULTILINE,
+    )
+
+
+def fix_leaf_card_directives(content: str) -> str:
+    """Convert LLM-invented ::card{...}\\nCONTENT\\n:: to :::card{...}\\nCONTENT\\n:::.
+
+    The fumadocs remark-directive plugin expects 'card' to be a *container*
+    directive (:::card ... :::) so it can carry child content.  The LLM
+    frequently uses the *leaf* directive form (::card) with a standalone ::
+    close marker — which remark-directive does not recognise, rendering both
+    the content and the :: as raw text.
+    """
+    def fix_cards_block(m: re.Match) -> str:
+        inner = m.group(1)
+        # ::card{...}\nCONTENT\n::  →  :::card{...}\nCONTENT\n:::
+        inner = re.sub(
+            r'^::card(\{[^}]*\})\n(.*?)\n^::$',
+            r':::card\1\n\2\n:::',
+            inner,
+            flags=re.MULTILINE | re.DOTALL,
+        )
+        return f':::cards\n{inner}\n:::'
+
+    return re.sub(
+        r':::cards\n(.*?)\n:::',
+        fix_cards_block,
+        content,
+        flags=re.DOTALL,
+    )
+
+
 def unwrap_markdown_trapped_in_code_fences(content: str) -> str:
     """Detect code fences that contain markdown content and unwrap them.
 

{deepdoc-2.3.3 → deepdoc-2.3.5}/deepdoc.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepdoc
-Version: 2.3.3
+Version: 2.3.5
 Summary: Auto-generate beautiful docs from any codebase
 Author: Pranav Kumar
 License: MIT

{deepdoc-2.3.3 → deepdoc-2.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepdoc"
-version = "2.3.3"
+version = "2.3.5"
 description = "Auto-generate beautiful docs from any codebase"
 readme = "README.md"
 authors = [