deepdoc 2.3.0__tar.gz → 2.3.2__tar.gz

{deepdoc-2.3.0 → deepdoc-2.3.2}/PKG-INFO

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

{deepdoc-2.3.0 → deepdoc-2.3.2}/deepdoc/__init__.py

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

{deepdoc-2.3.0 → deepdoc-2.3.2}/deepdoc/generator/post_processors.py

@@ -421,11 +421,55 @@ def normalize_code_fence_languages(content: str) -> str:
         "output": "plaintext",
     }
 
+    # Languages included in Shiki's default bundle (fumadocs uses bundled-all).
+    # Anything outside this set falls back to plaintext to avoid build failures.
+    _SHIKI_BUNDLED = {
+        "abap", "actionscript-3", "ada", "angular-html", "angular-ts",
+        "apache", "apex", "apl", "applescript", "ara", "asciidoc", "asm",
+        "astro", "awk", "ballerina", "bat", "batch", "beancount", "berry",
+        "be", "bibtex", "bicep", "blade", "c", "cadence", "cdc", "clarity",
+        "clojure", "clj", "cmake", "cobol", "codeowners", "coffescript",
+        "common-lisp", "lisp", "coq", "cpp", "crystal", "csharp", "cs",
+        "css", "csv", "cue", "cypher", "d", "dart", "dax", "desktop",
+        "diff", "docker", "dockerfile", "dotenv", "dream-maker", "edge",
+        "elixir", "elm", "emacs-lisp", "erb", "erlang", "fennel", "fish",
+        "fluent", "fortran-fixed-form", "fortran-free-form", "fsharp",
+        "gdresource", "gdscript", "gdshader", "genie", "gherkin", "git-commit",
+        "git-rebase", "gleam", "glimmer-js", "glimmer-ts", "glsl", "gnuplot",
+        "go", "graphql", "gql", "groovy", "hack", "haml", "handlebars", "hbs",
+        "haskell", "hcl", "hjson", "hlsl", "html", "html-derivative", "http",
+        "hxml", "hy", "imba", "ini", "toml", "java", "javascript", "js",
+        "jinja", "jinja-html", "jison", "json", "json5", "jsonc", "jsonl",
+        "jsonnet", "jssm", "jsx", "julia", "kotlin", "kusto", "kql", "latex",
+        "lean", "less", "liquid", "log", "logo", "lua", "luau", "make",
+        "makefile", "markdown", "md", "marko", "matlab", "mdc", "mdx",
+        "mermaid", "mipsasm", "mojo", "move", "narrat", "nextflow", "nf",
+        "nginx", "nim", "nix", "nushell", "nu", "objective-c", "objc",
+        "objective-cpp", "ocaml", "pascal", "perl", "php", "plsql",
+        "postcss", "powerquery", "powershell", "ps", "ps1", "prisma",
+        "prolog", "proto", "protobuf", "puppet", "purescript", "python",
+        "py", "r", "raku", "perl6", "razor", "reg", "regexp", "regex",
+        "rel", "riscv", "rst", "ruby", "rb", "rust", "rs", "sas", "sass",
+        "scala", "scheme", "scss", "shaderlab", "shader", "shellscript",
+        "bash", "sh", "shell", "zsh", "smalltalk", "solidity", "soy",
+        "sparql", "splunk", "spl", "sql", "ssh-config", "stata", "stylus",
+        "styl", "svelte", "swift", "system-verilog", "systemd", "tasl",
+        "tcl", "templ", "terraform", "tex", "toml", "ts", "tsv", "tsx",
+        "turtle", "twig", "typescript", "typespec", "typst", "v", "vb",
+        "cmd", "verilog", "vhdl", "viml", "vim", "vimscript", "vue",
+        "vue-html", "vyper", "wasm", "wenyan", "wgsl", "wikitext",
+        "mediawiki", "wolfram", "xml", "xsl", "yaml", "yml", "zenscript",
+        "zig", "plaintext",
+    }
+
     def replace(match: re.Match) -> str:
         indent = match.group(1) or ""
         lang = match.group(2)
         rest = match.group(3) or ""
         normalized = alias_map.get(lang.lower(), lang)
+        # Fall back to plaintext for langs not in Shiki's bundle to prevent build failures
+        if normalized.lower() not in _SHIKI_BUNDLED:
+            normalized = "plaintext"
         return f"{indent}```{normalized}{rest}"
 
     return re.sub(

{deepdoc-2.3.0 → deepdoc-2.3.2}/deepdoc/site/builder/scaffold_files.py

@@ -1425,9 +1425,7 @@ def _docs_page_tsx() -> str:
         """\
         import { notFound } from 'next/navigation';
         import { DocsBody, DocsPage } from 'fumadocs-ui/page';
-        import { findNeighbour } from 'fumadocs-core/server';
         import { docsSource } from '@/lib/source';
-        import { pageTree } from '@/lib/page-tree.generated';
         import { getMDXComponents } from '@/mdx-components';
         import type { ComponentType } from 'react';
         import type { TOCItemType } from 'fumadocs-core/server';
@@ -1477,10 +1475,9 @@ def _docs_page_tsx() -> str:
           const prereqs = meta.deepdoc_prereqs ?? [];
           const status = meta.deepdoc_status?.trim() || null;
           const evidenceRecords = meta.deepdoc_evidence_records ?? [];
-          const { previous, next } = findNeighbour(pageTree, page.url);
 
           return (
-            <DocsPage toc={toc} prev={previous ?? false} next={next ?? false}>
+            <DocsPage toc={toc}>
               <DocsBody>
                 {prereqs.length > 0 ? (
                   <p
@@ -1655,9 +1652,44 @@ def _mermaid_component_tsx() -> str:
         """\
         'use client';
 
-        import { use, useEffect, useId, useState } from 'react';
+        import { Component, use, useEffect, useId, useState } from 'react';
+        import type { ReactNode } from 'react';
         import { useTheme } from 'next-themes';
 
+        // Error boundary so a bad diagram never crashes the whole page
+        class MermaidErrorBoundary extends Component<
+          { children: ReactNode },
+          { error: string | null }
+        > {
+          constructor(props: { children: ReactNode }) {
+            super(props);
+            this.state = { error: null };
+          }
+          static getDerivedStateFromError(err: unknown) {
+            return { error: err instanceof Error ? err.message : String(err) };
+          }
+          render() {
+            if (this.state.error) {
+              return (
+                <pre
+                  style={{
+                    padding: '0.75rem 1rem',
+                    background: 'var(--color-fd-muted)',
+                    borderRadius: '6px',
+                    fontSize: '0.75rem',
+                    color: 'var(--color-fd-muted-foreground)',
+                    whiteSpace: 'pre-wrap',
+                    wordBreak: 'break-word',
+                  }}
+                >
+                  {'[diagram parse error] ' + this.state.error}
+                </pre>
+              );
+            }
+            return this.props.children;
+          }
+        }
+
         export function Mermaid({ chart }: { chart: string }) {
           const [mounted, setMounted] = useState(false);
 
@@ -1666,7 +1698,11 @@ def _mermaid_component_tsx() -> str:
           }, []);
 
           if (!mounted) return null;
-          return <MermaidContent chart={chart} />;
+          return (
+            <MermaidErrorBoundary>
+              <MermaidContent chart={chart} />
+            </MermaidErrorBoundary>
+          );
         }
 
         const cache = new Map<string, Promise<unknown>>();
@@ -1675,7 +1711,11 @@ def _mermaid_component_tsx() -> str:
           const cached = cache.get(key);
           if (cached) return cached as Promise<T>;
 
-          const promise = setPromise();
+          const promise = setPromise().catch((err) => {
+            // Remove from cache so a retry is possible, then re-throw for boundary
+            cache.delete(key);
+            throw err;
+          }) as Promise<T>;
           cache.set(key, promise);
           return promise;
         }

{deepdoc-2.3.0 → deepdoc-2.3.2}/deepdoc.egg-info/PKG-INFO

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

{deepdoc-2.3.0 → deepdoc-2.3.2}/pyproject.toml

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