agent-markdown-pdf 0.3.0__tar.gz → 0.4.0__tar.gz

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-markdown-pdf
-Version: 0.3.0
+Version: 0.4.0
 Summary: Agent-friendly Markdown-to-PDF CLI with HTML preview and JSON diagnostics
 Author: rainp
 License-Expression: MIT
@@ -87,7 +87,7 @@ command-line interface where the style can be defined up front.
 Install from PyPI in your Python environment:
 
 ```shell
-python -m pip install "agent-markdown-pdf>=0.3.0"
+python -m pip install "agent-markdown-pdf>=0.4.0"
 ```
 
 The PyPI distribution is `agent-markdown-pdf`; it installs the `mdtopdf` command.
@@ -218,7 +218,8 @@ bundled renderer makes the basic doctor check fail.
 The gallery below is rendered from the final PDF produced by
 `examples/visual-test-en.md`. It shows the actual pages an agent can hand back
 to a user: headings, callouts, tables, code, math, images, Mermaid, and
-pagination.
+pagination. The images show the 0.4.0 renderer, with Pele diagrams
+and Chromium PDF rendering.
 
 | Page 1 | Page 2 |
 | --- | --- |
@@ -234,10 +235,83 @@ pagination.
 Markdown -> markdown-it-py HTML -> theme/custom CSS -> Chromium PDF
 ```
 
-One Chromium session renders bundled KaTeX and Mermaid, waits for fonts and
-images, and prints the PDF. No separate Mermaid CLI, Node.js installation,
-WeasyPrint, or MSYS2 setup is needed. Browser installation is an explicit setup
-step; conversion never downloads a browser.
+One Chromium session renders formulas with bundled KaTeX and Mermaid code blocks
+with bundled Pele, waits for fonts and images, and prints the PDF. No separate
+Mermaid CLI, Node.js installation, WeasyPrint, or MSYS2 setup is needed. Browser
+installation is an explicit setup step; conversion never downloads a browser.
+
+### Mermaid diagrams with Pele
+
+Keep using `mermaid` or `mmd` fenced code blocks:
+
+````markdown
+```mermaid
+flowchart LR
+    A[Draft] --> B[Review] --> C[PDF]
+```
+````
+
+Pele produces SVG for HTML preview and PDF. Diagram label formulas written as
+`$$...$$` use the bundled KaTeX renderer. The default SVG theme matches the
+document's soft lavender palette and Latin-first font stack, with pale purple
+nodes, dark text, and gray-purple connectors.
+
+To customize the document and diagram palette, pass a CSS file with `--css`:
+
+```css
+:root {
+  --mdtopdf-accent: #7352a6;
+  --mdtopdf-surface: #f3effa;
+}
+.mermaid-diagram {
+  --pele-border: #b5a2cf;
+}
+```
+
+Shared palette variables are `--mdtopdf-background`, `--mdtopdf-text`,
+`--mdtopdf-heading`, `--mdtopdf-accent`, `--mdtopdf-muted`, `--mdtopdf-surface`,
+`--mdtopdf-surface-alt`, `--mdtopdf-border`, and `--mdtopdf-critical`.
+Heading levels 2–6 also have `--mdtopdf-heading-2` through `--mdtopdf-heading-6`.
+Local `--pele-*` overrides still customize diagrams independently.
+
+Diagram layout uses the configured `@page` size and margins, including named
+pages. Before pagination, it conservatively uses the smallest available width
+and height across matching first/left/right page styles. The source diagram
+direction is preserved. This supports common print CSS; inspect the final PDF
+when using more complex page rules.
+
+If fitting a diagram makes its text smaller than approximately **8pt**, the
+result includes a `diagram_text_too_small` warning with the diagram index and
+estimated printed font size. Prefer a wider page, larger labels, or smaller
+diagrams. To adjust the warning threshold, use
+`.mermaid-diagram { --mdtopdf-diagram-min-font-size: 9pt; }` in your CSS.
+This changes the check, not the font size. `--strict` rejects the warning and
+preserves an existing output.
+
+Diagram failures return `error_code: "diagram_render_failed"`, an actionable
+`hint`, and `error_details` with Pele's code, the 1-based diagram index, and a
+source excerpt. When the location can be established, `diagram_line`,
+`diagram_column`, and `source_line` refer to the original diagram and Markdown;
+`source_start_line` identifies the code block's first content line.
+Pele's own `renderer_line` / `renderer_column` are kept separately because its
+preprocessing can shift locations. Unknown locations are omitted, not guessed.
+
+Pele has its own layout, so diagram geometry can change. Mermaid `theme` and
+`themeVariables` settings do not set its colors; use the CSS variables above.
+Arbitrary HTML labels and external Mermaid plugins are unsupported. Review
+existing diagrams in HTML and the final PDF. See Pele's
+[compatibility guide](https://pele.run/compatibility) and
+[theme variables](https://pele.run/theming).
+
+The bundled Pele **1.8.0** requires ASCII Sankey node names. Chinese node names,
+including quoted names, fail to parse in this version.
+
+Use `examples/pele-compatibility.md` with its companion CSS to review diagram output:
+
+```shell
+mdtopdf html examples/pele-compatibility.md --css examples/pele-compatibility.css -o pele-compatibility.html --overwrite
+mdtopdf convert examples/pele-compatibility.md --css examples/pele-compatibility.css -o pele-compatibility.pdf --overwrite
+```
 
 ### Upgrading from 0.2.x
 
@@ -253,7 +327,7 @@ the old backend. See the [release notes](https://github.com/ABClize/mdtopdf/blob
 | Feature | Notes |
 | --- | --- |
 | JSON output | `--json` is available for conversion, HTML preview, doctor, and theme listing. |
-| Environment checks | `doctor --json` checks Python imports, the browser executable, bundled KaTeX/Mermaid assets, and recommended fonts. |
+| Environment checks | `doctor --json` checks Python imports, the browser executable, bundled KaTeX/Pele assets, and recommended fonts. |
 | Local rendering | Markdown, CSS, math, Mermaid SVG generation, and PDF export stay on the machine. |
 | HTML preview | Generate standalone HTML before PDF export for fast visual inspection. |
 | Obsidian compatibility | Wikilinks, aliases, frontmatter hiding, comments, highlights, and typed callouts. |
@@ -371,7 +445,7 @@ markdown_file_to_pdf("report.md", output_path="report.pdf", overwrite=True)
 `mdtopdf` supports:
 
 - CommonMark
-- Tables
+- Tables with content-based column widths and wrapping for long words and URLs
 - Strikethrough
 - Task lists
 - Footnotes
@@ -384,7 +458,7 @@ markdown_file_to_pdf("report.md", output_path="report.pdf", overwrite=True)
 - Obsidian-style callouts such as `> [!note] Title`
 - Safe inline HTML tags such as `<br>`, `<kbd>`, `<mark>`, `<sup>`, and `<sub>`
 - TeX math through `$inline$`, `$$block$$`, and common `amsmath` environments
-- Mermaid diagrams through bundled Mermaid in Chromium
+- Mermaid code blocks through bundled Pele in Chromium
 
 Raw HTML is disabled by default except for the safe subset above. For trusted
 local Markdown, pass `--unsafe-html`.
@@ -484,8 +558,11 @@ python -m twine check dist/*
 
 ## License
 
-MIT. Bundled KaTeX and Mermaid assets include their MIT licenses at
-`mdtopdf/vendor/katex/LICENSE` and `mdtopdf/vendor/mermaid/LICENSE`.
+MIT. Bundled KaTeX and Pele assets include their MIT licenses at
+`mdtopdf/vendor/katex/LICENSE` and `mdtopdf/vendor/pele/LICENSE`.
+`mdtopdf/vendor/pele/LICENSE` also includes the Lucide ISC license.
+Pele's bundled version, source, and asset hash are recorded in
+`mdtopdf/vendor/pele/NOTICE.md`.
 
 `mdtopdf` does not bundle CJK body fonts, emoji fonts, or proprietary system
 fonts. The default theme references local system fonts such as Segoe UI,

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/README.md

@@ -44,7 +44,7 @@ command-line interface where the style can be defined up front.
 Install from PyPI in your Python environment:
 
 ```shell
-python -m pip install "agent-markdown-pdf>=0.3.0"
+python -m pip install "agent-markdown-pdf>=0.4.0"
 ```
 
 The PyPI distribution is `agent-markdown-pdf`; it installs the `mdtopdf` command.
@@ -175,7 +175,8 @@ bundled renderer makes the basic doctor check fail.
 The gallery below is rendered from the final PDF produced by
 `examples/visual-test-en.md`. It shows the actual pages an agent can hand back
 to a user: headings, callouts, tables, code, math, images, Mermaid, and
-pagination.
+pagination. The images show the 0.4.0 renderer, with Pele diagrams
+and Chromium PDF rendering.
 
 | Page 1 | Page 2 |
 | --- | --- |
@@ -191,10 +192,83 @@ pagination.
 Markdown -> markdown-it-py HTML -> theme/custom CSS -> Chromium PDF
 ```
 
-One Chromium session renders bundled KaTeX and Mermaid, waits for fonts and
-images, and prints the PDF. No separate Mermaid CLI, Node.js installation,
-WeasyPrint, or MSYS2 setup is needed. Browser installation is an explicit setup
-step; conversion never downloads a browser.
+One Chromium session renders formulas with bundled KaTeX and Mermaid code blocks
+with bundled Pele, waits for fonts and images, and prints the PDF. No separate
+Mermaid CLI, Node.js installation, WeasyPrint, or MSYS2 setup is needed. Browser
+installation is an explicit setup step; conversion never downloads a browser.
+
+### Mermaid diagrams with Pele
+
+Keep using `mermaid` or `mmd` fenced code blocks:
+
+````markdown
+```mermaid
+flowchart LR
+    A[Draft] --> B[Review] --> C[PDF]
+```
+````
+
+Pele produces SVG for HTML preview and PDF. Diagram label formulas written as
+`$$...$$` use the bundled KaTeX renderer. The default SVG theme matches the
+document's soft lavender palette and Latin-first font stack, with pale purple
+nodes, dark text, and gray-purple connectors.
+
+To customize the document and diagram palette, pass a CSS file with `--css`:
+
+```css
+:root {
+  --mdtopdf-accent: #7352a6;
+  --mdtopdf-surface: #f3effa;
+}
+.mermaid-diagram {
+  --pele-border: #b5a2cf;
+}
+```
+
+Shared palette variables are `--mdtopdf-background`, `--mdtopdf-text`,
+`--mdtopdf-heading`, `--mdtopdf-accent`, `--mdtopdf-muted`, `--mdtopdf-surface`,
+`--mdtopdf-surface-alt`, `--mdtopdf-border`, and `--mdtopdf-critical`.
+Heading levels 2–6 also have `--mdtopdf-heading-2` through `--mdtopdf-heading-6`.
+Local `--pele-*` overrides still customize diagrams independently.
+
+Diagram layout uses the configured `@page` size and margins, including named
+pages. Before pagination, it conservatively uses the smallest available width
+and height across matching first/left/right page styles. The source diagram
+direction is preserved. This supports common print CSS; inspect the final PDF
+when using more complex page rules.
+
+If fitting a diagram makes its text smaller than approximately **8pt**, the
+result includes a `diagram_text_too_small` warning with the diagram index and
+estimated printed font size. Prefer a wider page, larger labels, or smaller
+diagrams. To adjust the warning threshold, use
+`.mermaid-diagram { --mdtopdf-diagram-min-font-size: 9pt; }` in your CSS.
+This changes the check, not the font size. `--strict` rejects the warning and
+preserves an existing output.
+
+Diagram failures return `error_code: "diagram_render_failed"`, an actionable
+`hint`, and `error_details` with Pele's code, the 1-based diagram index, and a
+source excerpt. When the location can be established, `diagram_line`,
+`diagram_column`, and `source_line` refer to the original diagram and Markdown;
+`source_start_line` identifies the code block's first content line.
+Pele's own `renderer_line` / `renderer_column` are kept separately because its
+preprocessing can shift locations. Unknown locations are omitted, not guessed.
+
+Pele has its own layout, so diagram geometry can change. Mermaid `theme` and
+`themeVariables` settings do not set its colors; use the CSS variables above.
+Arbitrary HTML labels and external Mermaid plugins are unsupported. Review
+existing diagrams in HTML and the final PDF. See Pele's
+[compatibility guide](https://pele.run/compatibility) and
+[theme variables](https://pele.run/theming).
+
+The bundled Pele **1.8.0** requires ASCII Sankey node names. Chinese node names,
+including quoted names, fail to parse in this version.
+
+Use `examples/pele-compatibility.md` with its companion CSS to review diagram output:
+
+```shell
+mdtopdf html examples/pele-compatibility.md --css examples/pele-compatibility.css -o pele-compatibility.html --overwrite
+mdtopdf convert examples/pele-compatibility.md --css examples/pele-compatibility.css -o pele-compatibility.pdf --overwrite
+```
 
 ### Upgrading from 0.2.x
 
@@ -210,7 +284,7 @@ the old backend. See the [release notes](https://github.com/ABClize/mdtopdf/blob
 | Feature | Notes |
 | --- | --- |
 | JSON output | `--json` is available for conversion, HTML preview, doctor, and theme listing. |
-| Environment checks | `doctor --json` checks Python imports, the browser executable, bundled KaTeX/Mermaid assets, and recommended fonts. |
+| Environment checks | `doctor --json` checks Python imports, the browser executable, bundled KaTeX/Pele assets, and recommended fonts. |
 | Local rendering | Markdown, CSS, math, Mermaid SVG generation, and PDF export stay on the machine. |
 | HTML preview | Generate standalone HTML before PDF export for fast visual inspection. |
 | Obsidian compatibility | Wikilinks, aliases, frontmatter hiding, comments, highlights, and typed callouts. |
@@ -328,7 +402,7 @@ markdown_file_to_pdf("report.md", output_path="report.pdf", overwrite=True)
 `mdtopdf` supports:
 
 - CommonMark
-- Tables
+- Tables with content-based column widths and wrapping for long words and URLs
 - Strikethrough
 - Task lists
 - Footnotes
@@ -341,7 +415,7 @@ markdown_file_to_pdf("report.md", output_path="report.pdf", overwrite=True)
 - Obsidian-style callouts such as `> [!note] Title`
 - Safe inline HTML tags such as `<br>`, `<kbd>`, `<mark>`, `<sup>`, and `<sub>`
 - TeX math through `$inline$`, `$$block$$`, and common `amsmath` environments
-- Mermaid diagrams through bundled Mermaid in Chromium
+- Mermaid code blocks through bundled Pele in Chromium
 
 Raw HTML is disabled by default except for the safe subset above. For trusted
 local Markdown, pass `--unsafe-html`.
@@ -441,8 +515,11 @@ python -m twine check dist/*
 
 ## License
 
-MIT. Bundled KaTeX and Mermaid assets include their MIT licenses at
-`mdtopdf/vendor/katex/LICENSE` and `mdtopdf/vendor/mermaid/LICENSE`.
+MIT. Bundled KaTeX and Pele assets include their MIT licenses at
+`mdtopdf/vendor/katex/LICENSE` and `mdtopdf/vendor/pele/LICENSE`.
+`mdtopdf/vendor/pele/LICENSE` also includes the Lucide ISC license.
+Pele's bundled version, source, and asset hash are recorded in
+`mdtopdf/vendor/pele/NOTICE.md`.
 
 `mdtopdf` does not bundle CJK body fonts, emoji fonts, or proprietary system
 fonts. The default theme references local system fonts such as Segoe UI,

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/agent_markdown_pdf.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-markdown-pdf
-Version: 0.3.0
+Version: 0.4.0
 Summary: Agent-friendly Markdown-to-PDF CLI with HTML preview and JSON diagnostics
 Author: rainp
 License-Expression: MIT
@@ -87,7 +87,7 @@ command-line interface where the style can be defined up front.
 Install from PyPI in your Python environment:
 
 ```shell
-python -m pip install "agent-markdown-pdf>=0.3.0"
+python -m pip install "agent-markdown-pdf>=0.4.0"
 ```
 
 The PyPI distribution is `agent-markdown-pdf`; it installs the `mdtopdf` command.
@@ -218,7 +218,8 @@ bundled renderer makes the basic doctor check fail.
 The gallery below is rendered from the final PDF produced by
 `examples/visual-test-en.md`. It shows the actual pages an agent can hand back
 to a user: headings, callouts, tables, code, math, images, Mermaid, and
-pagination.
+pagination. The images show the 0.4.0 renderer, with Pele diagrams
+and Chromium PDF rendering.
 
 | Page 1 | Page 2 |
 | --- | --- |
@@ -234,10 +235,83 @@ pagination.
 Markdown -> markdown-it-py HTML -> theme/custom CSS -> Chromium PDF
 ```
 
-One Chromium session renders bundled KaTeX and Mermaid, waits for fonts and
-images, and prints the PDF. No separate Mermaid CLI, Node.js installation,
-WeasyPrint, or MSYS2 setup is needed. Browser installation is an explicit setup
-step; conversion never downloads a browser.
+One Chromium session renders formulas with bundled KaTeX and Mermaid code blocks
+with bundled Pele, waits for fonts and images, and prints the PDF. No separate
+Mermaid CLI, Node.js installation, WeasyPrint, or MSYS2 setup is needed. Browser
+installation is an explicit setup step; conversion never downloads a browser.
+
+### Mermaid diagrams with Pele
+
+Keep using `mermaid` or `mmd` fenced code blocks:
+
+````markdown
+```mermaid
+flowchart LR
+    A[Draft] --> B[Review] --> C[PDF]
+```
+````
+
+Pele produces SVG for HTML preview and PDF. Diagram label formulas written as
+`$$...$$` use the bundled KaTeX renderer. The default SVG theme matches the
+document's soft lavender palette and Latin-first font stack, with pale purple
+nodes, dark text, and gray-purple connectors.
+
+To customize the document and diagram palette, pass a CSS file with `--css`:
+
+```css
+:root {
+  --mdtopdf-accent: #7352a6;
+  --mdtopdf-surface: #f3effa;
+}
+.mermaid-diagram {
+  --pele-border: #b5a2cf;
+}
+```
+
+Shared palette variables are `--mdtopdf-background`, `--mdtopdf-text`,
+`--mdtopdf-heading`, `--mdtopdf-accent`, `--mdtopdf-muted`, `--mdtopdf-surface`,
+`--mdtopdf-surface-alt`, `--mdtopdf-border`, and `--mdtopdf-critical`.
+Heading levels 2–6 also have `--mdtopdf-heading-2` through `--mdtopdf-heading-6`.
+Local `--pele-*` overrides still customize diagrams independently.
+
+Diagram layout uses the configured `@page` size and margins, including named
+pages. Before pagination, it conservatively uses the smallest available width
+and height across matching first/left/right page styles. The source diagram
+direction is preserved. This supports common print CSS; inspect the final PDF
+when using more complex page rules.
+
+If fitting a diagram makes its text smaller than approximately **8pt**, the
+result includes a `diagram_text_too_small` warning with the diagram index and
+estimated printed font size. Prefer a wider page, larger labels, or smaller
+diagrams. To adjust the warning threshold, use
+`.mermaid-diagram { --mdtopdf-diagram-min-font-size: 9pt; }` in your CSS.
+This changes the check, not the font size. `--strict` rejects the warning and
+preserves an existing output.
+
+Diagram failures return `error_code: "diagram_render_failed"`, an actionable
+`hint`, and `error_details` with Pele's code, the 1-based diagram index, and a
+source excerpt. When the location can be established, `diagram_line`,
+`diagram_column`, and `source_line` refer to the original diagram and Markdown;
+`source_start_line` identifies the code block's first content line.
+Pele's own `renderer_line` / `renderer_column` are kept separately because its
+preprocessing can shift locations. Unknown locations are omitted, not guessed.
+
+Pele has its own layout, so diagram geometry can change. Mermaid `theme` and
+`themeVariables` settings do not set its colors; use the CSS variables above.
+Arbitrary HTML labels and external Mermaid plugins are unsupported. Review
+existing diagrams in HTML and the final PDF. See Pele's
+[compatibility guide](https://pele.run/compatibility) and
+[theme variables](https://pele.run/theming).
+
+The bundled Pele **1.8.0** requires ASCII Sankey node names. Chinese node names,
+including quoted names, fail to parse in this version.
+
+Use `examples/pele-compatibility.md` with its companion CSS to review diagram output:
+
+```shell
+mdtopdf html examples/pele-compatibility.md --css examples/pele-compatibility.css -o pele-compatibility.html --overwrite
+mdtopdf convert examples/pele-compatibility.md --css examples/pele-compatibility.css -o pele-compatibility.pdf --overwrite
+```
 
 ### Upgrading from 0.2.x
 
@@ -253,7 +327,7 @@ the old backend. See the [release notes](https://github.com/ABClize/mdtopdf/blob
 | Feature | Notes |
 | --- | --- |
 | JSON output | `--json` is available for conversion, HTML preview, doctor, and theme listing. |
-| Environment checks | `doctor --json` checks Python imports, the browser executable, bundled KaTeX/Mermaid assets, and recommended fonts. |
+| Environment checks | `doctor --json` checks Python imports, the browser executable, bundled KaTeX/Pele assets, and recommended fonts. |
 | Local rendering | Markdown, CSS, math, Mermaid SVG generation, and PDF export stay on the machine. |
 | HTML preview | Generate standalone HTML before PDF export for fast visual inspection. |
 | Obsidian compatibility | Wikilinks, aliases, frontmatter hiding, comments, highlights, and typed callouts. |
@@ -371,7 +445,7 @@ markdown_file_to_pdf("report.md", output_path="report.pdf", overwrite=True)
 `mdtopdf` supports:
 
 - CommonMark
-- Tables
+- Tables with content-based column widths and wrapping for long words and URLs
 - Strikethrough
 - Task lists
 - Footnotes
@@ -384,7 +458,7 @@ markdown_file_to_pdf("report.md", output_path="report.pdf", overwrite=True)
 - Obsidian-style callouts such as `> [!note] Title`
 - Safe inline HTML tags such as `<br>`, `<kbd>`, `<mark>`, `<sup>`, and `<sub>`
 - TeX math through `$inline$`, `$$block$$`, and common `amsmath` environments
-- Mermaid diagrams through bundled Mermaid in Chromium
+- Mermaid code blocks through bundled Pele in Chromium
 
 Raw HTML is disabled by default except for the safe subset above. For trusted
 local Markdown, pass `--unsafe-html`.
@@ -484,8 +558,11 @@ python -m twine check dist/*
 
 ## License
 
-MIT. Bundled KaTeX and Mermaid assets include their MIT licenses at
-`mdtopdf/vendor/katex/LICENSE` and `mdtopdf/vendor/mermaid/LICENSE`.
+MIT. Bundled KaTeX and Pele assets include their MIT licenses at
+`mdtopdf/vendor/katex/LICENSE` and `mdtopdf/vendor/pele/LICENSE`.
+`mdtopdf/vendor/pele/LICENSE` also includes the Lucide ISC license.
+Pele's bundled version, source, and asset hash are recorded in
+`mdtopdf/vendor/pele/NOTICE.md`.
 
 `mdtopdf` does not bundle CJK body fonts, emoji fonts, or proprietary system
 fonts. The default theme references local system fonts such as Segoe UI,

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/agent_markdown_pdf.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ mdtopdf/mdtopdf_cli.py
 mdtopdf/core/__init__.py
 mdtopdf/core/browser.py
 mdtopdf/core/diagnostics.py
+mdtopdf/core/diagram_diagnostics.py
 mdtopdf/core/doctor.py
 mdtopdf/core/fonts.py
 mdtopdf/core/html.py
@@ -27,6 +28,8 @@ mdtopdf/core/pdf.py
 mdtopdf/skills/SKILL.md
 mdtopdf/themes/default.css
 mdtopdf/vendor/browser-render.js
+mdtopdf/vendor/diagram-render.js
+mdtopdf/vendor/page-layout.js
 mdtopdf/vendor/katex/LICENSE
 mdtopdf/vendor/katex/dist/katex.min.css
 mdtopdf/vendor/katex/dist/katex.min.js
@@ -91,17 +94,23 @@ mdtopdf/vendor/katex/dist/fonts/KaTeX_Size4-Regular.woff2
 mdtopdf/vendor/katex/dist/fonts/KaTeX_Typewriter-Regular.ttf
 mdtopdf/vendor/katex/dist/fonts/KaTeX_Typewriter-Regular.woff
 mdtopdf/vendor/katex/dist/fonts/KaTeX_Typewriter-Regular.woff2
-mdtopdf/vendor/mermaid/LICENSE
-mdtopdf/vendor/mermaid/NOTICE.md
-mdtopdf/vendor/mermaid/mermaid.min.js
+mdtopdf/vendor/pele/LICENSE
+mdtopdf/vendor/pele/NOTICE.md
+mdtopdf/vendor/pele/pele.global.js
 tests/test_browser.py
 tests/test_browser_discovery.py
 tests/test_core.py
 tests/test_decorations.py
 tests/test_dependency_diagnostics.py
+tests/test_diagram_diagnostics.py
+tests/test_diagram_layout.py
 tests/test_full_e2e.py
 tests/test_macos_fonts.py
 tests/test_math_alignment.py
+tests/test_page_geometry.py
 tests/test_pdfium.py
+tests/test_pele.py
 tests/test_reliability.py
-tests/test_stdin.py
+tests/test_stdin.py
+tests/test_table_layout.py
+tests/test_theme_tokens.py

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/mdtopdf/core/browser.py

@@ -7,12 +7,15 @@ from dataclasses import dataclass
 from html import escape
 from importlib import resources
 import os
+import math
 import platform
 import secrets
 from pathlib import Path
 import tempfile
 from urllib.parse import urlparse
 
+from mdtopdf.core.diagram_diagnostics import DiagramRenderError, raise_diagram_error
+
 
 BROWSER_ENV = "MDTOPDF_BROWSER_EXECUTABLE"
 INSTALL_HINT = "Run python -m playwright install chromium --no-shell during environment setup."
@@ -149,7 +152,7 @@ def render_document(html, *, base_url=None, output_path=None, timeout=90):
         return await asyncio.wait_for(_render(html, base_url=base_url, output_path=output_path), timeout)
     try:
         return _execute(run)
-    except BrowserRenderError:
+    except (BrowserRenderError, DiagramRenderError):
         raise
     except Exception as exc:
         raise _failure(exc) from exc
@@ -217,13 +220,27 @@ async def _render(html, *, base_url, output_path):
                 await page.emulate_media(media="print")
                 await page.goto(source.as_uri(), wait_until="load")
                 package = resources.files("mdtopdf")
-                if await page.locator("[data-mdtopdf-math]").count():
+                has_diagrams = await page.locator("[data-mdtopdf-mermaid]").count()
+                layouts = []
+                if has_diagrams:
+                    layout_script = package.joinpath("vendor/page-layout.js").read_text(encoding="utf-8")
+                    area = await page.evaluate(layout_script)
+                    await page.set_viewport_size({"width": math.ceil(area["width"]), "height": math.ceil(area["height"])})
+                    layouts = await page.evaluate(layout_script, {"action": "prepare"})
+                if has_diagrams or await page.locator("[data-mdtopdf-math]").count():
                     for name in ("katex.min.js", "contrib/mhchem.min.js"):
                         await _load_script(page, package.joinpath("vendor/katex/dist", name), nonce)
-                if await page.locator("[data-mdtopdf-mermaid]").count():
-                    await _load_script(page, package.joinpath("vendor/mermaid/mermaid.min.js"), nonce)
+                if has_diagrams:
+                    from mdtopdf.core.mermaid import MERMAID_ASSET
+                    await _load_script(page, package.joinpath(MERMAID_ASSET), nonce)
                 diagnostics = await page.evaluate(package.joinpath("vendor/browser-render.js").read_text(encoding="utf-8"))
                 warnings.extend(diagnostics)
+                if has_diagrams:
+                    diagrams = await page.evaluate(package.joinpath("vendor/diagram-render.js").read_text(encoding="utf-8"), layouts)
+                    if diagrams["error"]:
+                        raise_diagram_error(diagrams["error"])
+                    warnings.extend(diagrams["warnings"])
+                    warnings.extend(await page.evaluate(layout_script, {"action": "check", "layouts": layouts}))
                 await page.evaluate("async () => { await document.fonts.ready; await Promise.all([...document.images].map(i => i.decode().catch(() => null))); }")
                 missing = await page.locator("img").evaluate_all("images => images.filter(i => !i.naturalWidth).map(i => i.currentSrc || i.src)")
                 for url in missing:

agent_markdown_pdf-0.4.0/mdtopdf/core/diagram_diagnostics.py

@@ -0,0 +1,37 @@
+"""Actionable diagram failures, separate from browser environment failures."""
+
+from __future__ import annotations
+
+
+class DiagramRenderError(RuntimeError):
+    """A diagram could not be parsed or rendered by the bundled renderer."""
+
+    error_code = "diagram_render_failed"
+
+    def __init__(self, details: dict):
+        self.error_details = dict(details)
+        index = details.get("diagram_index", 1)
+        location = f"Diagram {index}"
+        if details.get("source_line"):
+            location += f" at Markdown line {details['source_line']}"
+        elif details.get("diagram_line"):
+            location += f" at diagram line {details['diagram_line']}"
+        elif details.get("source_start_line"):
+            location += f" starting at Markdown line {details['source_start_line']}"
+        message = details.get("message") or "Pele could not render this diagram."
+        super().__init__(f"{location}: {message}")
+        action = {
+            "limit": "Simplify the diagram or split it into smaller code blocks.",
+            "unsupported-diagram": "Use a diagram type and header supported by Pele.",
+            "syntax": "Correct the reported diagram syntax.",
+            "semantic": "Correct the conflicting or unresolved diagram declarations.",
+        }.get(details.get("code"), "Check the diagram's syntax and Pele compatibility.")
+        self.hint = (
+            f"Check the Mermaid/mmd code block for diagram {index}. {action} "
+            "See error_details for its location and source excerpt."
+        )
+
+
+def raise_diagram_error(details: dict) -> None:
+    """Raise a browser-serialized diagram failure without losing its metadata."""
+    raise DiagramRenderError(details)

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/mdtopdf/core/doctor.py

@@ -13,6 +13,7 @@ from pathlib import Path
 
 from mdtopdf.core.browser import BROWSER_ENV, inspect_browser
 from mdtopdf.core.fonts import inspect_recommended_font_groups
+from mdtopdf.core.mermaid import MERMAID_ASSET
 
 
 def run_doctor(*, render_check=False):
@@ -31,7 +32,7 @@ def run_doctor(*, render_check=False):
         "recommendations": [],
     }
     root = resources.files("mdtopdf")
-    for name, path in (("mermaid", "vendor/mermaid/mermaid.min.js"), ("katex", "vendor/katex/dist/katex.min.js")):
+    for name, path in (("mermaid", MERMAID_ASSET), ("katex", "vendor/katex/dist/katex.min.js")):
         exists = root.joinpath(path).is_file()
         result["tools"][name] = {"ok": exists, "backend": "bundled-javascript", "optional": False,
                                  "requires_network": False, "error": None if exists else "Bundled asset is missing."}

{agent_markdown_pdf-0.3.0 → agent_markdown_pdf-0.4.0}/mdtopdf/core/inline.py

@@ -10,11 +10,17 @@ from markdown_it import MarkdownIt
 FENCE_RE = re.compile(r"^(?P<indent> {0,3})(?P<fence>`{3,}|~{3,})")
 
 
-def protect_code_blocks(markdown_text: str) -> tuple[str, dict[str, str]]:
+def protect_code_blocks(
+    markdown_text: str, *, source_lines: dict[str, int] | None = None,
+) -> tuple[str, dict[str, str]]:
     """Shield CommonMark code blocks, including blocks inside containers.
 
     Restore the source before final parsing, not after HTML rendering: code must
     still be escaped by the Markdown renderer and highlighted normally.
+
+    If supplied, ``source_lines`` records each placeholder's zero-based original
+    line. Consumers can retain source locations even when preprocessing removes
+    frontmatter or comments before restoring the blocks.
     """
     lines = markdown_text.splitlines(keepends=True)
     replacements: dict[str, str] = {}
@@ -30,6 +36,8 @@ def protect_code_blocks(markdown_text: str) -> tuple[str, dict[str, str]]:
         newline = "\r\n" if original.endswith("\r\n") else "\n" if original.endswith("\n") else ""
         marker = f"```{prefix}X{start}END\n```{newline}"
         replacements[marker] = original
+        if source_lines is not None:
+            source_lines[marker] = start
         lines[start:end] = [marker]
     return "".join(lines), replacements