plotly-print 0.2.2__tar.gz → 0.3.0__tar.gz

plotly_print-0.2.2/.cursor/rules/markdown.mdc → plotly_print-0.3.0/.agents/skills/markdown/SKILL.md

@@ -1,7 +1,8 @@
 ---
-description: Markdown formatting for README, docs, and other .md files
-globs: "**/*.md"
-alwaysApply: false
+name: markdown
+description: Markdown formatting standards for plotly-print. Use when creating or editing Markdown files.
+paths:
+  - "**/*.md"
 ---
 
 # Markdown
@@ -13,7 +14,7 @@ Use fenced code blocks with a language tag when the snippet has a language:
 ```python
 from pathlib import Path
 
-Path("data") / "out.csv"
+Path('data') / 'out.csv'
 ```
 
 Do not leave unlabeled fences for Python, TOML, shell, or JSON. Plain fences are fine for output or prose examples with no language.

plotly_print-0.3.0/.agents/skills/project-standards/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: project-standards
+description: Coding standards for plotly-print. Use before writing or reviewing code in this repository.
+---
+
+# Project standards
+
+Python package + QuickJS micro-DOM under `src/plotly_print/js/`. Source of truth: `pyproject.toml` (Python >= 3.12, uv). Package layout and entry points: `src/plotly_print/AGENTS.md`.
+
+You are a lazy senior developer. Lazy means efficient, not careless. The best code is the code never written.
+
+## Before writing code
+
+Read the task and the code it touches, trace the real flow end to end, then stop at the first rung that holds:
+
+1. Does this need to be built at all? (YAGNI)
+2. Does it already exist in this codebase? Reuse it.
+3. Does the standard library already do this? Use it.
+4. Does an already-declared dependency solve it? Use it.
+5. Can this be one boring line? Make it one line.
+6. Only then: write the minimum code that works.
+
+Bug fix = root cause, not symptom. Grep every caller of the function you touch and fix the shared function once.
+
+## Toolchain
+
+- Do not add a dependency unless it is declared in `pyproject.toml` (or the lockfile). Prefer stdlib.
+- Ruff via `pyproject.toml`. After Python edits: `poe format`. After Markdown: `poe format_docs`.
+- No JS formatter/linter; match `micro_dom.js`. Never hand-edit vendored Plotly bundles.
+
+## Comments and docs
+
+- No docstrings except on base/abstract contracts and complex functions that need them.
+- No unnecessary comments; if needed, explain why, not what.
+- No section-divider comments in classes/functions (allowed in test classes). Group by proximity.
+
+## Language
+
+Shared: ASCII only in identifiers/comments/docs (no emojis). No unnecessary imports.
+
+Python: type-hint every function/method; f-strings; join with `/` on `Path` (avoid extra wrappers).
+
+## Quality
+
+- Deletion over addition. Boring over clever. Fewest files; shortest working diff after understanding the problem.
+- No unrequested abstractions, boilerplate, or dependencies. Question complex asks: does Y cover it?
+- Prefer the edge-case-correct stdlib approach when sizes match.
+- Deliberate ceilings: `ponytail:` comment naming the ceiling and upgrade path.
+- Non-trivial logic: one smallest test that fails if it breaks. Run `poe test` before claiming done.
+- No secrets, `.env`, or local virtualenvs in commits.
+
+Not lazy about: understanding the problem, trust-boundary validation, error handling that prevents data loss, security, anything explicitly requested.

plotly_print-0.3.0/.gitignore

@@ -0,0 +1,36 @@
+.DS_Store
+
+.venv/
+
+__pycache__/
+*.py[cod]
+.ruff_cache/
+.pytest_cache/
+.mypy_cache/
+
+.env
+.env.*
+
+.idea/
+.vscode/
+
+build/
+dist/
+sdist/
+wheels/
+*.egg-info/
+
+.artifacts/
+
+# Platform-specific agent config, kept local by each maintainer.
+.cursor/
+.cursorignore
+.cursorrules
+.claude/
+CLAUDE.md
+CLAUDE.local.md
+.codex/
+AGENTS.override.md
+.opencode/
+opencode.json
+opencode.jsonc

plotly_print-0.3.0/AGENTS.md

@@ -0,0 +1,24 @@
+# Agent instructions
+
+plotly-print: Python package + QuickJS micro-DOM for browser-less Plotly static export.
+
+## Context, loaded on demand
+
+- Package map and flow: `src/plotly_print/AGENTS.md` (auto-loaded there).
+- JS and micro-DOM rules: `src/plotly_print/js/AGENTS.md` (auto-loaded there).
+- Tests: `tests/AGENTS.md` (auto-loaded there).
+- Coding standards: skill `project-standards` (load before changing code).
+- Markdown: skill `markdown` (load before editing `.md`).
+
+## Commands
+
+`poe format` | `poe test` | `poe check` | `poe benchmark` | `poe format_docs`
+
+After Python edits run `poe format`. After Markdown run `poe format_docs`.
+
+## Non-negotiables
+
+- Vendored `src/plotly_print/js/plotly_comprehensive_2d.js`: never open whole-file, never edit. Use capped shell `grep -o ... | head`.
+- No new dependency outside `pyproject.toml` and the lockfile.
+- Scratch under `.artifacts/` (gitignored); do not commit.
+- ASCII only in identifiers, comments, and docs; no emojis.

{plotly_print-0.2.2 → plotly_print-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: plotly-print
-Version: 0.2.2
+Version: 0.3.0
 Summary: Lightweight, browser-less static image exporter for Plotly
 Project-URL: Homepage, https://github.com/roman-kaczanowski/plotly-print
 Project-URL: Repository, https://github.com/roman-kaczanowski/plotly-print
@@ -75,6 +75,25 @@ After registration, existing calls such as `fig.write_image("chart.png")` use pl
 
 plotly-print targets 2D static charts. The bundled Plotly.js build and its licenses are documented in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
 
+## Fonts
+
+Figures keep the font families you set, including `layout.font.family` and any per-trace or per-element override. If a family is not installed, plotly-print uses a system font. With no system fonts, it falls back to the bundled DejaVu Sans, DejaVu Serif, and DejaVu Sans Mono. Licenses for those fonts are in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+To use your own files, set the family on the figure and pass them with the export:
+
+```python
+fig.update_layout(font={'family': 'Inter'})
+
+plotly_print.write_image(
+    fig,
+    'chart.png',
+    font_files=['fonts/Inter-Regular.ttf'],
+    # or: font_dirs=['fonts'],
+)
+```
+
+`font_files` and `font_dirs` also work with `to_svg`, `to_image`, and with `fig.write_image` after `plotly_print.register()`.
+
 <!-- BENCHMARK-START -->
 
 ## Benchmarks

{plotly_print-0.2.2 → plotly_print-0.3.0}/README.md

@@ -49,6 +49,25 @@ After registration, existing calls such as `fig.write_image("chart.png")` use pl
 
 plotly-print targets 2D static charts. The bundled Plotly.js build and its licenses are documented in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
 
+## Fonts
+
+Figures keep the font families you set, including `layout.font.family` and any per-trace or per-element override. If a family is not installed, plotly-print uses a system font. With no system fonts, it falls back to the bundled DejaVu Sans, DejaVu Serif, and DejaVu Sans Mono. Licenses for those fonts are in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+To use your own files, set the family on the figure and pass them with the export:
+
+```python
+fig.update_layout(font={'family': 'Inter'})
+
+plotly_print.write_image(
+    fig,
+    'chart.png',
+    font_files=['fonts/Inter-Regular.ttf'],
+    # or: font_dirs=['fonts'],
+)
+```
+
+`font_files` and `font_dirs` also work with `to_svg`, `to_image`, and with `fig.write_image` after `plotly_print.register()`.
+
 <!-- BENCHMARK-START -->
 
 ## Benchmarks

plotly_print-0.3.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,154 @@
+# Third-party notices
+
+## plotly.js
+
+File: `src/plotly_print/js/plotly_comprehensive_2d.js`
+
+Redistributed plotly.js build (minified) used for offline / isolated 2D static
+rendering in the embedded QuickJS runtime. The full `plotly.min.js` shipped with
+the `plotly` Python package does not load in that runtime, so this smaller
+bundle is included instead.
+
+Copyright 2012-2026, Plotly, Inc.
+All rights reserved.
+Licensed under the MIT license.
+
+```text
+The MIT License (MIT)
+
+Copyright (c) 2014-2026 Plotly, Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+```
+
+Upstream: https://github.com/plotly/plotly.js
+
+## DejaVu fonts
+
+Files: `src/plotly_print/_fonts/DejaVuSans.ttf`,
+`src/plotly_print/_fonts/DejaVuSans-Bold.ttf`,
+`src/plotly_print/_fonts/DejaVuSerif.ttf`,
+`src/plotly_print/_fonts/DejaVuSansMono.ttf`
+
+Bundled as a fallback for systems without the fonts requested by a figure.
+DejaVu changes are in the public domain; the original glyphs are covered by
+the Bitstream Vera and Arev licenses below.
+
+```text
+Fonts are (c) Bitstream (see below). DejaVu changes are in public domain.
+Glyphs imported from Arev fonts are (c) Tavmjong Bah (see below)
+
+
+Bitstream Vera Fonts Copyright
+------------------------------
+
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is
+a trademark of Bitstream, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the fonts accompanying this license ("Fonts") and associated
+documentation files (the "Font Software"), to reproduce and distribute the
+Font Software, including without limitation the rights to use, copy, merge,
+publish, distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright and trademark notices and this permission notice shall
+be included in all copies of one or more of the Font Software typefaces.
+
+The Font Software may be modified, altered, or added to, and in particular
+the designs of glyphs or characters in the Fonts may be modified and
+additional glyphs or characters may be added to the Fonts, only if the fonts
+are renamed to names not containing either the words "Bitstream" or the word
+"Vera".
+
+This License becomes null and void to the extent applicable to Fonts or Font
+Software that has been modified and is distributed under the "Bitstream
+Vera" names.
+
+The Font Software may be sold as part of a larger software package but no
+copy of one or more of the Font Software typefaces may be sold by itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
+TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
+FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
+ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
+FONT SOFTWARE.
+
+Except as contained in this notice, the names of Gnome, the Gnome
+Foundation, and Bitstream Inc., shall not be used in advertising or
+otherwise to promote the sale, use or other dealings in this Font Software
+without prior written authorization from the Gnome Foundation or Bitstream
+Inc., respectively. For further information, contact: fonts at gnome dot
+org.
+
+Arev Fonts Copyright
+------------------------------
+
+Copyright (c) 2006 by Tavmjong Bah. All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the fonts accompanying this license ("Fonts") and
+associated documentation files (the "Font Software"), to reproduce
+and distribute the modifications to the Bitstream Vera Font Software,
+including without limitation the rights to use, copy, merge, publish,
+distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright and trademark notices and this permission notice
+shall be included in all copies of one or more of the Font Software
+typefaces.
+
+The Font Software may be modified, altered, or added to, and in
+particular the designs of glyphs or characters in the Fonts may be
+modified and additional glyphs or characters may be added to the
+Fonts, only if the fonts are renamed to names not containing either
+the words "Tavmjong Bah" or the word "Arev".
+
+This License becomes null and void to the extent applicable to Fonts
+or Font Software that has been modified and is distributed under the
+"Tavmjong Bah Arev" names.
+
+The Font Software may be sold as part of a larger software package but
+no copy of one or more of the Font Software typefaces may be sold by
+itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL
+TAVMJONG BAH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+Except as contained in this notice, the name of Tavmjong Bah shall not
+be used in advertising or otherwise to promote the sale, use or other
+dealings in this Font Software without prior written authorization
+from Tavmjong Bah. For further information, contact: tavmjong @ free
+. fr.
+```
+
+Upstream: https://github.com/dejavu-fonts/dejavu-fonts

{plotly_print-0.2.2 → plotly_print-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plotly-print"
-version = "0.2.2"
+version = "0.3.0"
 description = "Lightweight, browser-less static image exporter for Plotly"
 readme = "README.md"
 license = "MIT"
@@ -38,7 +38,11 @@ build-backend = "hatchling.build"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/plotly_print"]
-# benchmark/ is dev-only and intentionally omitted from the wheel.
+# benchmark/ and nested agent instructions are dev-only.
+exclude = [
+    "src/plotly_print/AGENTS.md",
+    "src/plotly_print/js/AGENTS.md",
+]
 
 [tool.uv]
 default-groups = ["dev", "test"]
@@ -52,6 +56,7 @@ test = [
     "kaleido>=0.2.1",
     "ruff",
     "mdformat",
+    "mdformat-frontmatter>=2.1.2",
     "mdformat-gfm",
     "mdformat-tables",
 ]

plotly_print-0.3.0/src/plotly_print/AGENTS.md

@@ -0,0 +1,30 @@
+# Package map
+
+Browser-less Plotly static export: QuickJS + micro-DOM + vendored Plotly 2D -> SVG -> resvg raster.
+
+## Flow
+
+`core.to_svg` / `to_image` / `write_image` -> `engine.PrintEngine` (QuickJS) -> eval `micro_dom.js` + vendored Plotly -> SVG -> `raster.py` for png/jpeg/webp.
+
+`plotly_hook.register` patches Plotly `to_image` / `write_image`.
+
+## Files
+
+| Path                            | Job                                             |
+| ------------------------------- | ----------------------------------------------- |
+| `core.py`                       | Public API; figure -> JSON                      |
+| `engine.py`                     | QuickJS lifecycle; canvas -> PNG; typed arrays  |
+| `fonts.py`                      | Text metrics callable into JS; font fallbacks   |
+| `_fonts/`                       | Bundled DejaVu fallback fonts + license         |
+| `raster.py`                     | SVG -> raster (resvg)                           |
+| `plotly_hook.py`                | Monkeypatch Plotly                              |
+| `js/micro_dom.js`               | First-party DOM/SVG stubs (**edit here**)       |
+| `js/plotly_comprehensive_2d.js` | Vendored; **never** read or grep the whole file |
+
+Start from this map. Open only listed files unless the task is outside `src/plotly_print/`.
+
+## Related context
+
+- JS and micro-DOM: `js/AGENTS.md`.
+- Tests: `../../tests/AGENTS.md`.
+- Vendored bundle: opaque; never read or grep the whole file. Use capped shell `grep -o ... | head` for call shapes.

plotly_print-0.3.0/src/plotly_print/_fonts/DejaVu-LICENSE.txt

@@ -0,0 +1,98 @@
+Fonts are (c) Bitstream (see below). DejaVu changes are in public domain.
+Glyphs imported from Arev fonts are (c) Tavmjong Bah (see below)
+
+
+Bitstream Vera Fonts Copyright
+------------------------------
+
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream Vera is
+a trademark of Bitstream, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the fonts accompanying this license ("Fonts") and associated
+documentation files (the "Font Software"), to reproduce and distribute the
+Font Software, including without limitation the rights to use, copy, merge,
+publish, distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright and trademark notices and this permission notice shall
+be included in all copies of one or more of the Font Software typefaces.
+
+The Font Software may be modified, altered, or added to, and in particular
+the designs of glyphs or characters in the Fonts may be modified and
+additional glyphs or characters may be added to the Fonts, only if the fonts
+are renamed to names not containing either the words "Bitstream" or the word
+"Vera".
+
+This License becomes null and void to the extent applicable to Fonts or Font
+Software that has been modified and is distributed under the "Bitstream
+Vera" names.
+
+The Font Software may be sold as part of a larger software package but no
+copy of one or more of the Font Software typefaces may be sold by itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
+TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
+FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
+ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
+FONT SOFTWARE.
+
+Except as contained in this notice, the names of Gnome, the Gnome
+Foundation, and Bitstream Inc., shall not be used in advertising or
+otherwise to promote the sale, use or other dealings in this Font Software
+without prior written authorization from the Gnome Foundation or Bitstream
+Inc., respectively. For further information, contact: fonts at gnome dot
+org.
+
+Arev Fonts Copyright
+------------------------------
+
+Copyright (c) 2006 by Tavmjong Bah. All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the fonts accompanying this license ("Fonts") and
+associated documentation files (the "Font Software"), to reproduce
+and distribute the modifications to the Bitstream Vera Font Software,
+including without limitation the rights to use, copy, merge, publish,
+distribute, and/or sell copies of the Font Software, and to permit
+persons to whom the Font Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright and trademark notices and this permission notice
+shall be included in all copies of one or more of the Font Software
+typefaces.
+
+The Font Software may be modified, altered, or added to, and in
+particular the designs of glyphs or characters in the Fonts may be
+modified and additional glyphs or characters may be added to the
+Fonts, only if the fonts are renamed to names not containing either
+the words "Tavmjong Bah" or the word "Arev".
+
+This License becomes null and void to the extent applicable to Fonts
+or Font Software that has been modified and is distributed under the 
+"Tavmjong Bah Arev" names.
+
+The Font Software may be sold as part of a larger software package but
+no copy of one or more of the Font Software typefaces may be sold by
+itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL
+TAVMJONG BAH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+Except as contained in this notice, the name of Tavmjong Bah shall not
+be used in advertising or otherwise to promote the sale, use or other
+dealings in this Font Software without prior written authorization
+from Tavmjong Bah. For further information, contact: tavmjong @ free
+. fr.

{plotly_print-0.2.2 → plotly_print-0.3.0}/src/plotly_print/core.py

@@ -4,6 +4,7 @@ import os
 from typing import Any, BinaryIO
 
 from plotly_print.engine import get_engine
+from plotly_print.fonts import FontPaths, resolve_font_dirs, resolve_font_files
 from plotly_print.raster import svg_to_jpeg, svg_to_png, svg_to_webp, write_raster
 
 
@@ -22,9 +23,11 @@ def to_svg(
     fig: Any,
     width: int | None = None,
     height: int | None = None,
+    font_files: FontPaths | None = None,
+    font_dirs: FontPaths | None = None,
 ) -> str:
     data, layout = _extract_figure_spec(fig)
-    return get_engine().render_svg(data, layout, width=width, height=height)
+    return get_engine().render_svg(data, layout, width=width, height=height, font_files=font_files, font_dirs=font_dirs)
 
 
 def to_image(
@@ -33,18 +36,22 @@ def to_image(
     width: int | None = None,
     height: int | None = None,
     scale: float = 1.0,
+    font_files: FontPaths | None = None,
+    font_dirs: FontPaths | None = None,
 ) -> bytes:
     fmt = format.lower().strip()
-    svg = to_svg(fig, width=width, height=height)
+    font_files = resolve_font_files(font_files) or None
+    font_dirs = resolve_font_dirs(font_dirs) or None
+    svg = to_svg(fig, width=width, height=height, font_files=font_files, font_dirs=font_dirs)
 
     if fmt == 'svg':
         return svg.encode('utf-8')
     if fmt == 'png':
-        return svg_to_png(svg, width=width, height=height, scale=scale)
+        return svg_to_png(svg, width=width, height=height, scale=scale, font_files=font_files, font_dirs=font_dirs)
     if fmt in ('jpg', 'jpeg'):
-        return svg_to_jpeg(svg, width=width, height=height, scale=scale)
+        return svg_to_jpeg(svg, width=width, height=height, scale=scale, font_files=font_files, font_dirs=font_dirs)
     if fmt == 'webp':
-        return svg_to_webp(svg, width=width, height=height, scale=scale)
+        return svg_to_webp(svg, width=width, height=height, scale=scale, font_files=font_files, font_dirs=font_dirs)
     raise ValueError(f"Unsupported format: {format}. Supported: 'svg', 'png', 'jpeg', 'webp'")
 
 
@@ -55,6 +62,8 @@ def write_image(
     scale: float = 1.0,
     width: int | None = None,
     height: int | None = None,
+    font_files: FontPaths | None = None,
+    font_dirs: FontPaths | None = None,
 ) -> None:
     if format is None:
         if isinstance(file, (str, os.PathLike)):
@@ -64,7 +73,9 @@ def write_image(
             format = 'png'
 
     fmt = format.lower().strip()
-    svg_str = to_svg(fig, width=width, height=height)
+    font_files = resolve_font_files(font_files) or None
+    font_dirs = resolve_font_dirs(font_dirs) or None
+    svg_str = to_svg(fig, width=width, height=height, font_files=font_files, font_dirs=font_dirs)
     if fmt == 'svg':
         if isinstance(file, (str, os.PathLike)):
             with open(file, 'w', encoding='utf-8') as f:
@@ -73,4 +84,13 @@ def write_image(
             file.write(svg_str.encode('utf-8'))
         return
 
-    write_raster(svg_str, file, format=fmt, width=width, height=height, scale=scale)
+    write_raster(
+        svg_str,
+        file,
+        format=fmt,
+        width=width,
+        height=height,
+        scale=scale,
+        font_files=font_files,
+        font_dirs=font_dirs,
+    )