weasysvg 0.1.0__tar.gz

weasysvg-0.1.0/.gitignore

@@ -0,0 +1,52 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# macOS
+.DS_Store
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Type checking
+.mypy_cache/
+
+# Ruff
+.ruff_cache/
+coverage.xml
+
+# Visual regression bench output
+tools/visual/out/

weasysvg-0.1.0/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-21
+
+### Added
+
+- `weasysvg.install()` patches WeasyPrint 70.x to render SVG close to Chromium: `<foreignObject>` with
+  the list markers of Chromium and the white space of empty inline boxes collapsed as there,
+  conditional processing, vector filter chains (blur, exact for a plain rect, color matrices and
+  transfer functions included), masks set before the path, pattern and gradient fixes, `mix-blend-mode`, unclipped
+  opacity groups, marker orientation, text baselines from font metrics, text-anchor per text chunk, filters, masks and clips on text, circles of the right length, dots of zero-length dashes in place in PDFium, negative dash offsets of odd dash arrays, decorations placed as in Chromium with underlines that skip the ink of the glyphs (laid out whole or character by character), font-size
+  keywords, relative font sizes inherited as computed, `ex` from the x-height of the font, and Chromium font selection. No SVG content is rasterized: the PDF stays vector.
+- `feTurbulence`, drawn as an image of the noise, and `feComposite` arithmetic.
+- `systemLanguage` reads the `lang` of the document where the image sits, else `install(language=...)`,
+  `en` by default: a German document shows the German branch of a `<switch>`.
+- Arabic laid out one character at a time, on a path or down a column, takes its joining forms and runs
+  right to left, numbers in it read left to right.
+- Upright CJK in vertical text hangs from the vertical origin of its font (`VORG`, `vmtx`), as in Chromium
+  and resvg, and `rotate` turns it about that point.
+- Python 3.10 to 3.14 and PyPy 3.11, the versions WeasyPrint 70 supports.
+- Releases on PyPI (`pip install weasysvg`), with publish attestations, and on GitHub, with signed
+  build provenance of the same files.
+- Upstream tracking for WeasyPrint upgrades (UPGRADING.md): probes of the gaps weasysvg covers, a
+  snapshot of the internals it hooks, a bench baseline, and a weekly run against the newest WeasyPrint.
+- A visual regression corpus of 115 SVGs with Chromium and resvg references, and a bench that
+  compares weasysvg with Chromium.
+- `corpus/COMPARISON.md` and the interactive `corpus/comparison.html` on GitHub Pages: every corpus SVG
+  in Chromium, resvg, WeasyPrint alone and with weasysvg, each panel at 2x as lossless WebP, sharp when zoomed.
+- Each corpus SVG names its reference (Chromium, resvg, or both). The verdicts say
+  whether a rendering is better than it, matches it, comes close or differs, and what differs, in a
+  table with an icon per status. The comparison page shows the SVG in your own browser too, and a swipe
+  between any two renderers.
+- `make review`: the renderings of each corpus SVG compared region by region at twice the resolution of the
+  references, with sheets of the cells that differ, to judge the verdicts at full size.
+- The visual image has Trebuchet MS, the first font of Mermaid, as Safari has it: Mermaid labels fit their
+  boxes in the references.
+- Chromium prints the references with the Accept-Language list of a desktop Chrome in English
+  (`en-US,en`): `systemLanguage` matches English as there.
+- `corpus/fonts`: the fonts the resvg tests ask for. The references, weasysvg, resvg and the browser panel of the comparison page all use them.

weasysvg-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sergey Grigoriev
+
+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.

weasysvg-0.1.0/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.5
+Name: weasysvg
+Version: 0.1.0
+Summary: Native SVG rendering for WeasyPrint, close to Chromium: foreignObject, filters, masks, blending and text.
+Project-URL: Homepage, https://github.com/grigoriev/weasysvg
+Project-URL: Repository, https://github.com/grigoriev/weasysvg
+Project-URL: Issues, https://github.com/grigoriev/weasysvg/issues
+Author-email: Sergey Grigoriev <grigoriev@fastmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Printing
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: fonttools>=4.59.2
+Requires-Dist: weasyprint<71,>=70
+Provides-Extra: dev
+Requires-Dist: mypy==2.4.0; extra == 'dev'
+Requires-Dist: pypdfium2==5.14.0; extra == 'dev'
+Requires-Dist: pytest-cov==7.1.0; extra == 'dev'
+Requires-Dist: pytest==9.1.1; extra == 'dev'
+Requires-Dist: ruff==0.17.1; extra == 'dev'
+Provides-Extra: visual
+Requires-Dist: numpy==2.5.4; (python_version >= '3.12') and extra == 'visual'
+Requires-Dist: playwright==1.64.0; extra == 'visual'
+Requires-Dist: resvg-py==0.5.0; extra == 'visual'
+Description-Content-Type: text/markdown
+
+# weasysvg
+
+[![CI](https://github.com/grigoriev/weasysvg/actions/workflows/ci.yml/badge.svg)](https://github.com/grigoriev/weasysvg/actions/workflows/ci.yml)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/grigoriev/weasysvg/badge)](https://scorecard.dev/viewer/?uri=github.com/grigoriev/weasysvg)
+[![Release](https://img.shields.io/github/v/release/grigoriev/weasysvg)](https://github.com/grigoriev/weasysvg/releases)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/grigoriev/weasysvg/blob/main/LICENSE)
+
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=grigoriev_weasysvg&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=grigoriev_weasysvg)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=grigoriev_weasysvg&metric=coverage)](https://sonarcloud.io/summary/new_code?id=grigoriev_weasysvg)
+
+A plugin for [WeasyPrint](https://weasyprint.org) 70.x that renders SVG natively, close to Chromium.
+
+## Why?
+
+WeasyPrint draws SVG as vector graphics, but it lacks `<foreignObject>` and has gaps in filters, masks,
+blending and text. Diagram tools depend on these: draw.io and Mermaid put their labels in
+`<foreignObject>`, D2 masks its edge labels, and many tools draw shadows with filters. Services that
+turn HTML into PDF therefore rasterize SVG in a headless Chromium first.
+
+weasysvg closes these gaps inside WeasyPrint. The SVG stays vector, text stays selectable, and the
+service needs no browser.
+
+## Installation
+
+weasysvg runs on CPython 3.10 to 3.14 and on PyPy 3.11, as WeasyPrint 70 does. On PyPy a C compiler
+must be present: zopfli, which WeasyPrint needs, has no PyPy wheel and builds from source.
+
+Install it from PyPI:
+
+```sh
+pip install weasysvg
+```
+
+weasysvg depends on WeasyPrint only. Every SVG feature it adds stays vector in the PDF, blur included.
+The one exception is the noise of `feTurbulence`: it has no vector form, so it is an image, computed in
+Python.
+
+WeasyPrint needs Pango, see its
+[installation guide](https://doc.courtbouillon.org/weasyprint/stable/first_steps.html).
+
+### Verify
+
+The build of each release has signed provenance on GitHub, and the GitHub release carries its bundle.
+PyPI and the GitHub release hold the same files, so verify a file from either with
+`gh attestation verify <file> --repo grigoriev/weasysvg`. On PyPI each file also has a publish
+attestation (PEP 740): it ties the upload to `release.yml` of this repository.
+
+## Usage
+
+Call `install()` once, before the first rendering:
+
+```python
+import weasyprint
+import weasysvg
+
+weasysvg.install()
+weasyprint.HTML("report.html").write_pdf("report.pdf")
+```
+
+`install()` patches WeasyPrint in place, for the whole process. It is idempotent, and it returns the
+names of the installed features. Each feature can be turned off:
+
+```python
+weasysvg.install(filters=False, fonts=False)
+```
+
+| Argument | Default | Effect |
+|---|---|---|
+| `conditional_processing` | `True` | `<switch>`, `requiredExtensions`, `systemLanguage` |
+| `foreign_object` | `True` | `<foreignObject>` content laid out by WeasyPrint |
+| `filters` | `True` | filter chains, `drop-shadow()` and `blur()` |
+| `paint` | `True` | gradients, patterns and masks |
+| `blend` | `True` | `mix-blend-mode` (needs `paint`) |
+| `text` | `True` | text baselines, decorations, font-size keywords |
+| `fonts` | `True` | font family selection as Chromium does it |
+| `fetch_cache` | `True` | one fetch per URL and SVG |
+| `markers` | `True` | marker orientation as in Chromium |
+| `language` | `"en"` | the language `systemLanguage` reads where the document has no `lang` |
+
+weasysvg targets WeasyPrint 70.x and warns on any other major version: it patches internals that
+change between releases.
+
+## Features
+
+| Area | What weasysvg adds |
+|---|---|
+| `<foreignObject>` | The XHTML inside is laid out as a WeasyPrint document and drawn in place. The SVG stylesheet still matches it. All objects of one SVG share one layout run. Tables taller than their rows grow their rows, as browsers do. Disc, circle and square list markers are the shapes Chromium paints, placed from the ascent of the font. |
+| Conditional processing | `<switch>` draws its first matching child. `requiredExtensions` and `systemLanguage` hide elements, so draw.io no longer draws both the label and its fallback. XHTML counts as supported only with `foreign_object` on; without it the fallback wins. `systemLanguage` reads the `lang` of the element that holds the image (`<html lang="de">`), else the `language` of `install()`, and matches as Chromium does with the Accept-Language list of that language (`de-CH` reads `de-CH,de`). An SVG from CSS (`background-image`, `list-style-image`, `content: url()`) reads `language`. |
+| Filters | `feGaussianBlur`, `feOffset`, `feFlood`, `feDropShadow`, `feMerge`, `feBlend` normal, `feComposite` over, in and arithmetic, `feColorMatrix`, `feComponentTransfer`, `primitiveUnits="objectBoundingBox"`, and the CSS `drop-shadow()` and `blur()` functions, all in vector. `feTurbulence` noise is an image. A blur is a soft mask: exact for a plain rect, as the product of two Gaussian profiles, and in steps through the profile for other shapes. A color matrix or transfer function recolors each fill, stroke and gradient stop. |
+| Masks and clips | A mask is set before the path starts, so viewers apply it. `maskContentUnits`, the region of an `objectBoundingBox` mask, self-referencing masks, and `mask` on a `<mask>` ignored as in Chromium. A clip path with `clip-rule="evenodd"`, text, `<use>` or clipped children becomes a soft mask. |
+| Gradients and patterns | Tiles start at the user space origin, `patternTransform` moves the tile origin too, patterns used twice, a gradient cell that covers the shape under any `gradientTransform`, colors mixed unpremultiplied as in Chromium, radial `r` and `fr` percentages, `href` stops used twice, a gradient cell that Quartz and Splash do not drop. |
+| Blending and opacity | `mix-blend-mode` as an isolated group. Opacity groups are no longer clipped to the bounding box, which cut off shifted text. |
+| Text | Vertical `writing-mode` (`tb`, `vertical-rl`): CJK upright from the vertical origin of the font (`VORG`, `vmtx`), other scripts sideways, `rotate` about the origin of each glyph as in resvg. `textPath` (SVG 2 `path` attribute, `href`, `startOffset`, `text-anchor`, `<tspan>` inside, decorations). A run with one position at most is laid out whole, so Arabic joins, bidi orders and kerning and ligatures apply; laid out one character at a time, on a path or down a column, Arabic in one text node still takes its joining forms and runs right to left; `letter-spacing` skips cursive scripts. `dominant-baseline` and `alignment-baseline` from real font metrics, `text-decoration` placed and sized as in Chromium, underlines and overlines skip the ink of the glyphs, font-size keywords, a relative font size inherited as computed and `ex` from the x-height of the font, nested `<text>` ignored, `text-anchor` per text chunk. A filter, mask or clip on text uses the box of the text as drawn. |
+| Fonts | A CSS family list resolves to one family as Chromium on Linux does, with its metric-compatible replacements (Arial to Liberation Sans). A character the family lacks comes from the sans-serif list, as in Chromium. |
+| Markers | `orient="auto"` follows the tangents of lines, curves and arcs, and a mid marker bisects its vertex with the angle wrap of Chromium. |
+| Presentation attributes | An empty attribute such as `fill=""` is ignored, as in browsers. |
+
+## How it compares to Chromium
+
+The bench in [`tools/visual`](https://github.com/grigoriev/weasysvg/tree/main/tools/visual) renders a corpus of 115 SVGs. The corpus holds draw.io,
+Mermaid, PlantUML, Graphviz, D2 and BPMN diagrams, real-world files from Wikimedia Commons, and tests of
+the resvg suite. Every SVG has a reference: Chromium, resvg, or both where they agree (69 SVGs). For the resvg tests the expected
+image of the resvg suite decides between Chromium and resvg where they differ. `make review` compares the
+renderings at twice the resolution of the panels, in an 8 x 8 grid, and a look at each cell that differs
+gives the verdict:
+
+| Verdict | WeasyPrint 70 | WeasyPrint 70 with weasysvg |
+|---|---|---|
+| ⬆️ better than the reference | 0 | 1 |
+| ✅ matches the reference | 39 | 110 |
+| 🟡 close to the reference | 22 | 4 |
+| ❌ differs from the reference | 54 | 0 |
+
+Of the 35 diagrams from draw.io, kroki and mermaid.ink, 34 match the reference and 1 is close.
+Each verdict says what differs. The verdicts are in [`corpus/verdicts.json`](https://github.com/grigoriev/weasysvg/blob/main/corpus/verdicts.json). The [comparison page](https://grigoriev.github.io/weasysvg/corpus/comparison.html)
+shows every SVG in Chromium, your own browser, resvg, WeasyPrint alone and WeasyPrint with weasysvg, in a row,
+with the reference marked and a swipe between any two of them, as GitHub compares images;
+[`corpus/COMPARISON.md`](https://github.com/grigoriev/weasysvg/blob/main/corpus/COMPARISON.md) holds the same in the repository.
+
+## Known gaps
+
+- On a `textPath` and in vertical text each character is laid out alone. Arabic takes its joining forms,
+  but loses the forms and ligatures some fonts pick from the whole word (Amiri): such a word runs longer.
+- On a `textPath` and in vertical text, joining and right-to-left order stop at the edge of a `<tspan>`: an
+  Arabic word split by one falls apart there.
+- An underline or overline skips no ink under a turned character (`rotate`) or on vertical text.
+- Text with several `y` or `dy` values draws no decoration line.
+- A plain rect is blurred exactly. Any other shape is blurred in levels by the distance to its nearest
+  edge, which knows nothing of the far edge: a filled shape thinner than about two deviations comes out
+  darker and sharper than in Chromium, and corners come out mitered inside the shape.
+- Lighting, morphology, convolution and displacement have no vector form: the element draws
+  unfiltered, with a warning.
+- `feComposite` arithmetic needs one input to be a flood of the whole filter region, or both inputs to
+  be the same. A translucent result composites over the value of the formula on nothing.
+- Except on a plain rect, a blur with two different deviations uses their mean.
+
+## Development
+
+Tests and the bench run in Docker, since WeasyPrint needs Pango. See [CONTRIBUTING.md](https://github.com/grigoriev/weasysvg/blob/main/CONTRIBUTING.md).
+
+```sh
+make lint     # ruff and mypy, on the host
+make test     # pytest with coverage, in Docker
+make visual   # the visual bench, report in tools/visual/out/report.html
+make comparison # corpus/COMPARISON.md, the renderings of every SVG side by side
+make upstream # probes of the WeasyPrint gaps and of the hooked internals
+```
+
+weasysvg supports the latest WeasyPrint major only. [UPGRADING.md](https://github.com/grigoriev/weasysvg/blob/main/UPGRADING.md) describes how a new one
+is taken: which patches it makes redundant, which internals changed, what renders worse.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/grigoriev/weasysvg/blob/main/CONTRIBUTING.md). Report vulnerabilities privately, see [SECURITY.md](https://github.com/grigoriev/weasysvg/blob/main/SECURITY.md).
+
+## Disclaimer
+
+This software is provided "as is", without warranty of any kind, as the LICENSE states. Use
+it at your own risk. Sergey Grigoriev is not liable for damage from its use, as far as the law
+allows. It is published free of charge, outside of any commercial offering, with no
+obligation to support it. Security reports are welcome, see [SECURITY.md](https://github.com/grigoriev/weasysvg/blob/main/SECURITY.md).
+
+## License
+
+MIT, see [LICENSE](https://github.com/grigoriev/weasysvg/blob/main/LICENSE). The test corpus keeps the licenses of its sources, see
+[corpus/SOURCES.md](https://github.com/grigoriev/weasysvg/blob/main/corpus/SOURCES.md).

weasysvg-0.1.0/README.md

@@ -0,0 +1,169 @@
+# weasysvg
+
+[![CI](https://github.com/grigoriev/weasysvg/actions/workflows/ci.yml/badge.svg)](https://github.com/grigoriev/weasysvg/actions/workflows/ci.yml)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/grigoriev/weasysvg/badge)](https://scorecard.dev/viewer/?uri=github.com/grigoriev/weasysvg)
+[![Release](https://img.shields.io/github/v/release/grigoriev/weasysvg)](https://github.com/grigoriev/weasysvg/releases)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/grigoriev/weasysvg/blob/main/LICENSE)
+
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=grigoriev_weasysvg&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=grigoriev_weasysvg)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=grigoriev_weasysvg&metric=coverage)](https://sonarcloud.io/summary/new_code?id=grigoriev_weasysvg)
+
+A plugin for [WeasyPrint](https://weasyprint.org) 70.x that renders SVG natively, close to Chromium.
+
+## Why?
+
+WeasyPrint draws SVG as vector graphics, but it lacks `<foreignObject>` and has gaps in filters, masks,
+blending and text. Diagram tools depend on these: draw.io and Mermaid put their labels in
+`<foreignObject>`, D2 masks its edge labels, and many tools draw shadows with filters. Services that
+turn HTML into PDF therefore rasterize SVG in a headless Chromium first.
+
+weasysvg closes these gaps inside WeasyPrint. The SVG stays vector, text stays selectable, and the
+service needs no browser.
+
+## Installation
+
+weasysvg runs on CPython 3.10 to 3.14 and on PyPy 3.11, as WeasyPrint 70 does. On PyPy a C compiler
+must be present: zopfli, which WeasyPrint needs, has no PyPy wheel and builds from source.
+
+Install it from PyPI:
+
+```sh
+pip install weasysvg
+```
+
+weasysvg depends on WeasyPrint only. Every SVG feature it adds stays vector in the PDF, blur included.
+The one exception is the noise of `feTurbulence`: it has no vector form, so it is an image, computed in
+Python.
+
+WeasyPrint needs Pango, see its
+[installation guide](https://doc.courtbouillon.org/weasyprint/stable/first_steps.html).
+
+### Verify
+
+The build of each release has signed provenance on GitHub, and the GitHub release carries its bundle.
+PyPI and the GitHub release hold the same files, so verify a file from either with
+`gh attestation verify <file> --repo grigoriev/weasysvg`. On PyPI each file also has a publish
+attestation (PEP 740): it ties the upload to `release.yml` of this repository.
+
+## Usage
+
+Call `install()` once, before the first rendering:
+
+```python
+import weasyprint
+import weasysvg
+
+weasysvg.install()
+weasyprint.HTML("report.html").write_pdf("report.pdf")
+```
+
+`install()` patches WeasyPrint in place, for the whole process. It is idempotent, and it returns the
+names of the installed features. Each feature can be turned off:
+
+```python
+weasysvg.install(filters=False, fonts=False)
+```
+
+| Argument | Default | Effect |
+|---|---|---|
+| `conditional_processing` | `True` | `<switch>`, `requiredExtensions`, `systemLanguage` |
+| `foreign_object` | `True` | `<foreignObject>` content laid out by WeasyPrint |
+| `filters` | `True` | filter chains, `drop-shadow()` and `blur()` |
+| `paint` | `True` | gradients, patterns and masks |
+| `blend` | `True` | `mix-blend-mode` (needs `paint`) |
+| `text` | `True` | text baselines, decorations, font-size keywords |
+| `fonts` | `True` | font family selection as Chromium does it |
+| `fetch_cache` | `True` | one fetch per URL and SVG |
+| `markers` | `True` | marker orientation as in Chromium |
+| `language` | `"en"` | the language `systemLanguage` reads where the document has no `lang` |
+
+weasysvg targets WeasyPrint 70.x and warns on any other major version: it patches internals that
+change between releases.
+
+## Features
+
+| Area | What weasysvg adds |
+|---|---|
+| `<foreignObject>` | The XHTML inside is laid out as a WeasyPrint document and drawn in place. The SVG stylesheet still matches it. All objects of one SVG share one layout run. Tables taller than their rows grow their rows, as browsers do. Disc, circle and square list markers are the shapes Chromium paints, placed from the ascent of the font. |
+| Conditional processing | `<switch>` draws its first matching child. `requiredExtensions` and `systemLanguage` hide elements, so draw.io no longer draws both the label and its fallback. XHTML counts as supported only with `foreign_object` on; without it the fallback wins. `systemLanguage` reads the `lang` of the element that holds the image (`<html lang="de">`), else the `language` of `install()`, and matches as Chromium does with the Accept-Language list of that language (`de-CH` reads `de-CH,de`). An SVG from CSS (`background-image`, `list-style-image`, `content: url()`) reads `language`. |
+| Filters | `feGaussianBlur`, `feOffset`, `feFlood`, `feDropShadow`, `feMerge`, `feBlend` normal, `feComposite` over, in and arithmetic, `feColorMatrix`, `feComponentTransfer`, `primitiveUnits="objectBoundingBox"`, and the CSS `drop-shadow()` and `blur()` functions, all in vector. `feTurbulence` noise is an image. A blur is a soft mask: exact for a plain rect, as the product of two Gaussian profiles, and in steps through the profile for other shapes. A color matrix or transfer function recolors each fill, stroke and gradient stop. |
+| Masks and clips | A mask is set before the path starts, so viewers apply it. `maskContentUnits`, the region of an `objectBoundingBox` mask, self-referencing masks, and `mask` on a `<mask>` ignored as in Chromium. A clip path with `clip-rule="evenodd"`, text, `<use>` or clipped children becomes a soft mask. |
+| Gradients and patterns | Tiles start at the user space origin, `patternTransform` moves the tile origin too, patterns used twice, a gradient cell that covers the shape under any `gradientTransform`, colors mixed unpremultiplied as in Chromium, radial `r` and `fr` percentages, `href` stops used twice, a gradient cell that Quartz and Splash do not drop. |
+| Blending and opacity | `mix-blend-mode` as an isolated group. Opacity groups are no longer clipped to the bounding box, which cut off shifted text. |
+| Text | Vertical `writing-mode` (`tb`, `vertical-rl`): CJK upright from the vertical origin of the font (`VORG`, `vmtx`), other scripts sideways, `rotate` about the origin of each glyph as in resvg. `textPath` (SVG 2 `path` attribute, `href`, `startOffset`, `text-anchor`, `<tspan>` inside, decorations). A run with one position at most is laid out whole, so Arabic joins, bidi orders and kerning and ligatures apply; laid out one character at a time, on a path or down a column, Arabic in one text node still takes its joining forms and runs right to left; `letter-spacing` skips cursive scripts. `dominant-baseline` and `alignment-baseline` from real font metrics, `text-decoration` placed and sized as in Chromium, underlines and overlines skip the ink of the glyphs, font-size keywords, a relative font size inherited as computed and `ex` from the x-height of the font, nested `<text>` ignored, `text-anchor` per text chunk. A filter, mask or clip on text uses the box of the text as drawn. |
+| Fonts | A CSS family list resolves to one family as Chromium on Linux does, with its metric-compatible replacements (Arial to Liberation Sans). A character the family lacks comes from the sans-serif list, as in Chromium. |
+| Markers | `orient="auto"` follows the tangents of lines, curves and arcs, and a mid marker bisects its vertex with the angle wrap of Chromium. |
+| Presentation attributes | An empty attribute such as `fill=""` is ignored, as in browsers. |
+
+## How it compares to Chromium
+
+The bench in [`tools/visual`](https://github.com/grigoriev/weasysvg/tree/main/tools/visual) renders a corpus of 115 SVGs. The corpus holds draw.io,
+Mermaid, PlantUML, Graphviz, D2 and BPMN diagrams, real-world files from Wikimedia Commons, and tests of
+the resvg suite. Every SVG has a reference: Chromium, resvg, or both where they agree (69 SVGs). For the resvg tests the expected
+image of the resvg suite decides between Chromium and resvg where they differ. `make review` compares the
+renderings at twice the resolution of the panels, in an 8 x 8 grid, and a look at each cell that differs
+gives the verdict:
+
+| Verdict | WeasyPrint 70 | WeasyPrint 70 with weasysvg |
+|---|---|---|
+| ⬆️ better than the reference | 0 | 1 |
+| ✅ matches the reference | 39 | 110 |
+| 🟡 close to the reference | 22 | 4 |
+| ❌ differs from the reference | 54 | 0 |
+
+Of the 35 diagrams from draw.io, kroki and mermaid.ink, 34 match the reference and 1 is close.
+Each verdict says what differs. The verdicts are in [`corpus/verdicts.json`](https://github.com/grigoriev/weasysvg/blob/main/corpus/verdicts.json). The [comparison page](https://grigoriev.github.io/weasysvg/corpus/comparison.html)
+shows every SVG in Chromium, your own browser, resvg, WeasyPrint alone and WeasyPrint with weasysvg, in a row,
+with the reference marked and a swipe between any two of them, as GitHub compares images;
+[`corpus/COMPARISON.md`](https://github.com/grigoriev/weasysvg/blob/main/corpus/COMPARISON.md) holds the same in the repository.
+
+## Known gaps
+
+- On a `textPath` and in vertical text each character is laid out alone. Arabic takes its joining forms,
+  but loses the forms and ligatures some fonts pick from the whole word (Amiri): such a word runs longer.
+- On a `textPath` and in vertical text, joining and right-to-left order stop at the edge of a `<tspan>`: an
+  Arabic word split by one falls apart there.
+- An underline or overline skips no ink under a turned character (`rotate`) or on vertical text.
+- Text with several `y` or `dy` values draws no decoration line.
+- A plain rect is blurred exactly. Any other shape is blurred in levels by the distance to its nearest
+  edge, which knows nothing of the far edge: a filled shape thinner than about two deviations comes out
+  darker and sharper than in Chromium, and corners come out mitered inside the shape.
+- Lighting, morphology, convolution and displacement have no vector form: the element draws
+  unfiltered, with a warning.
+- `feComposite` arithmetic needs one input to be a flood of the whole filter region, or both inputs to
+  be the same. A translucent result composites over the value of the formula on nothing.
+- Except on a plain rect, a blur with two different deviations uses their mean.
+
+## Development
+
+Tests and the bench run in Docker, since WeasyPrint needs Pango. See [CONTRIBUTING.md](https://github.com/grigoriev/weasysvg/blob/main/CONTRIBUTING.md).
+
+```sh
+make lint     # ruff and mypy, on the host
+make test     # pytest with coverage, in Docker
+make visual   # the visual bench, report in tools/visual/out/report.html
+make comparison # corpus/COMPARISON.md, the renderings of every SVG side by side
+make upstream # probes of the WeasyPrint gaps and of the hooked internals
+```
+
+weasysvg supports the latest WeasyPrint major only. [UPGRADING.md](https://github.com/grigoriev/weasysvg/blob/main/UPGRADING.md) describes how a new one
+is taken: which patches it makes redundant, which internals changed, what renders worse.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/grigoriev/weasysvg/blob/main/CONTRIBUTING.md). Report vulnerabilities privately, see [SECURITY.md](https://github.com/grigoriev/weasysvg/blob/main/SECURITY.md).
+
+## Disclaimer
+
+This software is provided "as is", without warranty of any kind, as the LICENSE states. Use
+it at your own risk. Sergey Grigoriev is not liable for damage from its use, as far as the law
+allows. It is published free of charge, outside of any commercial offering, with no
+obligation to support it. Security reports are welcome, see [SECURITY.md](https://github.com/grigoriev/weasysvg/blob/main/SECURITY.md).
+
+## License
+
+MIT, see [LICENSE](https://github.com/grigoriev/weasysvg/blob/main/LICENSE). The test corpus keeps the licenses of its sources, see
+[corpus/SOURCES.md](https://github.com/grigoriev/weasysvg/blob/main/corpus/SOURCES.md).

weasysvg-0.1.0/pyproject.toml

@@ -0,0 +1,113 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "weasysvg"
+version = "0.1.0"
+description = "Native SVG rendering for WeasyPrint, close to Chromium: foreignObject, filters, masks, blending and text."
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Sergey Grigoriev", email = "grigoriev@fastmail.com" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Topic :: Multimedia :: Graphics :: Graphics Conversion",
+    "Topic :: Printing",
+    "Typing :: Typed",
+]
+requires-python = ">=3.10"
+dependencies = [
+    # ink.py reads glyph outlines; WeasyPrint 70 requires it already
+    "fonttools>=4.59.2",
+    "weasyprint>=70,<71",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest==9.1.1",
+    "pytest-cov==7.1.0",
+    "mypy==2.4.0",
+    "ruff==0.17.1",
+    "pypdfium2==5.14.0",
+]
+# The visual regression bench in tools/visual, run in Docker
+visual = [
+    "numpy==2.5.4; python_version >= '3.12'",
+    "playwright==1.64.0",
+    "resvg-py==0.5.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/grigoriev/weasysvg"
+Repository = "https://github.com/grigoriev/weasysvg"
+Issues = "https://github.com/grigoriev/weasysvg/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/weasysvg"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/weasysvg", "tests", "README.md", "LICENSE", "CHANGELOG.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 240
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "C4", "SIM"]
+ignore = []
+
+[tool.ruff.lint.isort]
+known-first-party = ["weasysvg"]
+
+[tool.uv]
+required-version = ">=0.5.0"
+
+[tool.coverage.run]
+source = ["weasysvg"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "if __name__ == .__main__.:",
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+follow_imports = "normal"
+show_error_codes = true
+
+# WeasyPrint ships no type information
+[[tool.mypy.overrides]]
+module = ["weasyprint.*", "weasyprint", "pypdfium2.*", "numpy.*", "fontTools.*"]
+ignore_missing_imports = true