fullbleed 2.0.0__tar.gz → 2.2.0__tar.gz

fullbleed-2.2.0/Cargo.lock

@@ -0,0 +1,30 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "fullbleed"
+version = "2.2.0"
+dependencies = [
+ "fullbleed_audit_contract",
+ "subsetter",
+]
+
+[[package]]
+name = "fullbleed_audit_contract"
+version = "0.1.2"
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "subsetter"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38803281d1c23166c5ebcb455439a5d2afe711cc909cf88af72448c297756ad6"
+dependencies = [
+ "rustc-hash",
+]

{fullbleed-2.0.0 → fullbleed-2.2.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "fullbleed"
-version = "2.0.0"
+version = "2.2.0"
 edition = "2024"
 rust-version = "1.85"
 license = "MIT"
@@ -38,3 +38,4 @@ debug = true
 
 [dependencies]
 fullbleed_audit_contract = { version = "0.1.2", path = "crates/fullbleed_audit_contract" }
+subsetter = { version = "0.2.6", default-features = false }

{fullbleed-2.0.0 → fullbleed-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fullbleed
-Version: 2.0.0
+Version: 2.2.0
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS
@@ -69,6 +69,8 @@ Additional focused references are in `docs/`:
 - `docs/css-coverage.md` (validated CSS coverage, parity status, and active gaps)
 - `docs/README.md`
 - `docs/engine.md`
+- `docs/performance-architecture.md`
+- `docs/performance-pass-2026-08-04.md`
 - `docs/python-api.md`
 - `docs/ui-accessibility.md`
 - `docs/cli.md`
@@ -89,7 +91,8 @@ Additional focused references are in `docs/`:
 - Python-first extension surface for hackability and custom workflows.
 - Python render calls release the GIL while Rust rendering executes.
 - Ordered standard-library worker pools for batch rendering and selected internal workloads.
-- No third-party Rust crate graph and no required third-party Python runtime or build packages.
+- A deliberately small, license-audited Rust dependency graph and no required third-party Python
+  runtime or build packages.
 
 ## Concurrency Model
 
@@ -98,6 +101,37 @@ Additional focused references are in `docs/`:
 - The same bounded worker implementation serves selected internal hotspots such as table layout and JIT paint paths.
 - Do not assume every single-document render path will fully saturate all cores end-to-end.
 
+## Performance in 2.2
+
+Fullbleed 2.2 retains exact TrueType glyph subsetting and adds compiled fixed-geometry variable-data
+binding. Across the five independent benchmark fixtures, PDFs are 95.5-97.3% smaller and ordinary
+warm rendering is 2.90x faster by geometric mean than released 2.0.0.
+
+The new compile-once API freezes an immutable Q32.32 display document and can link it repeatedly
+without rerunning HTML parsing, selector matching, layout, pagination, or command planning. For
+identical untagged copies in one ordered PDF, `CompiledDocument.render_pdf_batch(...)` shares each
+source page's content stream across the copied page dictionaries. The measured 20-copy lane is
+200.7x faster per page by geometric mean than the released 2.0.0 warm renderer; a 1,000-page stress
+run sustained 304,479-666,622 pages/s.
+
+The 2.2 compiler includes a genuine fixed-geometry variable-data lane. A compiled invoice
+with six bound fields rendered 100,000 distinct records in a five-run median of 283.807 ms to
+memory (**352,352 pages/s**) and 295.999 ms directly to a flushed 88.1 MB PDF
+(**337,839 pages/s**). Including the one-time 4.168 ms compile gives 333,147 direct-file pages/s.
+The harness verified all 100,000 unique invoice IDs in page order, exact page count, resolved
+markers, deterministic bytes, and equal buffer/file SHA-256. Reproduce it with:
+
+```bash
+python tools/benchmark_fullbleed_vdp.py --records 100000 --repeats 5
+```
+
+The fixed-copy result remains scoped to identical content; the variable-data result is scoped to
+paint-only text whose geometry does not reflow. Neither is a claim that arbitrary new HTML or
+size-changing records render 200x faster. See
+[`docs/performance-pass-2026-08-04.md`](docs/performance-pass-2026-08-04.md) for measurements and
+[`docs/performance-architecture.md`](docs/performance-architecture.md) for the packed vector IR,
+typed-binding, virtual-linker, and shader roadmap.
+
 ## Install
 
 New to Python or setting up on a fresh machine? Start with `docs/install-non-technical.md`.
@@ -109,7 +143,7 @@ python -m pip install fullbleed
 From a local wheel:
 
 ```bash
-python -m pip install C:\path\to\fullbleed-2.0.0-cp310-abi3-win_amd64.whl
+python -m pip install C:\path\to\fullbleed-2.2.0-cp310-abi3-win_amd64.whl
 ```
 
 From a source checkout with Rust installed, no Python build package is needed:
@@ -904,6 +938,7 @@ PdfEngine(
 Module exports:
 
 - `PdfEngine`
+- `CompiledDocument`
 - `AssetBundle`
 - `Asset`
 - `AssetKind`
@@ -921,6 +956,7 @@ Module exports:
 | Method | Return shape |
 | --- | --- |
 | `register_bundle(bundle)` | `None` |
+| `compile_pdf(html, css)` | `CompiledDocument` |
 | `render_pdf(html, css, deterministic_hash=None)` | `bytes` |
 | `render_pdf_to_file(html, css, path, deterministic_hash=None)` | `int` (bytes written) |
 | `render_image_pages(html, css, dpi=150)` | `list[bytes]` |
@@ -941,6 +977,23 @@ Module exports:
 | `render_pdf_batch_with_css(jobs, deterministic_hash=None)` | `bytes` |
 | `render_pdf_batch_with_css_to_file(jobs, path, deterministic_hash=None)` | `int` |
 
+`CompiledDocument` methods:
+
+| Method | Return shape |
+| --- | --- |
+| `stats()` | `dict` |
+| `render_pdf(deterministic_hash=None)` | `bytes` |
+| `render_pdf_to_file(path, deterministic_hash=None)` | `int` |
+| `render_pdf_batch(copies, deterministic_hash=None)` | `bytes` |
+| `render_pdf_bindings(bindings, deterministic_hash=None)` | `bytes` |
+| `render_pdf_bindings_to_file(bindings, path, deterministic_hash=None)` | `int` |
+
+The compiled lane runs parsing/layout once. `render_pdf_batch` virtualizes identical untagged page
+content. The binding methods instead accept columnar `dict[str, list[str]]` data and emit distinct
+fixed-geometry text overlays per record while sharing static paint. They require exact slot keys,
+equal non-zero column lengths, page-local WinAnsi-compatible text, and an untagged profile; bound
+values do not trigger reflow.
+
 When `deterministic_hash` is set, engine writes PDF SHA-256 to the provided file path.
 
 `AssetBundle` methods:

{fullbleed-2.0.0 → fullbleed-2.2.0}/README.md

@@ -32,6 +32,8 @@ Additional focused references are in `docs/`:
 - `docs/css-coverage.md` (validated CSS coverage, parity status, and active gaps)
 - `docs/README.md`
 - `docs/engine.md`
+- `docs/performance-architecture.md`
+- `docs/performance-pass-2026-08-04.md`
 - `docs/python-api.md`
 - `docs/ui-accessibility.md`
 - `docs/cli.md`
@@ -52,7 +54,8 @@ Additional focused references are in `docs/`:
 - Python-first extension surface for hackability and custom workflows.
 - Python render calls release the GIL while Rust rendering executes.
 - Ordered standard-library worker pools for batch rendering and selected internal workloads.
-- No third-party Rust crate graph and no required third-party Python runtime or build packages.
+- A deliberately small, license-audited Rust dependency graph and no required third-party Python
+  runtime or build packages.
 
 ## Concurrency Model
 
@@ -61,6 +64,37 @@ Additional focused references are in `docs/`:
 - The same bounded worker implementation serves selected internal hotspots such as table layout and JIT paint paths.
 - Do not assume every single-document render path will fully saturate all cores end-to-end.
 
+## Performance in 2.2
+
+Fullbleed 2.2 retains exact TrueType glyph subsetting and adds compiled fixed-geometry variable-data
+binding. Across the five independent benchmark fixtures, PDFs are 95.5-97.3% smaller and ordinary
+warm rendering is 2.90x faster by geometric mean than released 2.0.0.
+
+The new compile-once API freezes an immutable Q32.32 display document and can link it repeatedly
+without rerunning HTML parsing, selector matching, layout, pagination, or command planning. For
+identical untagged copies in one ordered PDF, `CompiledDocument.render_pdf_batch(...)` shares each
+source page's content stream across the copied page dictionaries. The measured 20-copy lane is
+200.7x faster per page by geometric mean than the released 2.0.0 warm renderer; a 1,000-page stress
+run sustained 304,479-666,622 pages/s.
+
+The 2.2 compiler includes a genuine fixed-geometry variable-data lane. A compiled invoice
+with six bound fields rendered 100,000 distinct records in a five-run median of 283.807 ms to
+memory (**352,352 pages/s**) and 295.999 ms directly to a flushed 88.1 MB PDF
+(**337,839 pages/s**). Including the one-time 4.168 ms compile gives 333,147 direct-file pages/s.
+The harness verified all 100,000 unique invoice IDs in page order, exact page count, resolved
+markers, deterministic bytes, and equal buffer/file SHA-256. Reproduce it with:
+
+```bash
+python tools/benchmark_fullbleed_vdp.py --records 100000 --repeats 5
+```
+
+The fixed-copy result remains scoped to identical content; the variable-data result is scoped to
+paint-only text whose geometry does not reflow. Neither is a claim that arbitrary new HTML or
+size-changing records render 200x faster. See
+[`docs/performance-pass-2026-08-04.md`](docs/performance-pass-2026-08-04.md) for measurements and
+[`docs/performance-architecture.md`](docs/performance-architecture.md) for the packed vector IR,
+typed-binding, virtual-linker, and shader roadmap.
+
 ## Install
 
 New to Python or setting up on a fresh machine? Start with `docs/install-non-technical.md`.
@@ -72,7 +106,7 @@ python -m pip install fullbleed
 From a local wheel:
 
 ```bash
-python -m pip install C:\path\to\fullbleed-2.0.0-cp310-abi3-win_amd64.whl
+python -m pip install C:\path\to\fullbleed-2.2.0-cp310-abi3-win_amd64.whl
 ```
 
 From a source checkout with Rust installed, no Python build package is needed:
@@ -867,6 +901,7 @@ PdfEngine(
 Module exports:
 
 - `PdfEngine`
+- `CompiledDocument`
 - `AssetBundle`
 - `Asset`
 - `AssetKind`
@@ -884,6 +919,7 @@ Module exports:
 | Method | Return shape |
 | --- | --- |
 | `register_bundle(bundle)` | `None` |
+| `compile_pdf(html, css)` | `CompiledDocument` |
 | `render_pdf(html, css, deterministic_hash=None)` | `bytes` |
 | `render_pdf_to_file(html, css, path, deterministic_hash=None)` | `int` (bytes written) |
 | `render_image_pages(html, css, dpi=150)` | `list[bytes]` |
@@ -904,6 +940,23 @@ Module exports:
 | `render_pdf_batch_with_css(jobs, deterministic_hash=None)` | `bytes` |
 | `render_pdf_batch_with_css_to_file(jobs, path, deterministic_hash=None)` | `int` |
 
+`CompiledDocument` methods:
+
+| Method | Return shape |
+| --- | --- |
+| `stats()` | `dict` |
+| `render_pdf(deterministic_hash=None)` | `bytes` |
+| `render_pdf_to_file(path, deterministic_hash=None)` | `int` |
+| `render_pdf_batch(copies, deterministic_hash=None)` | `bytes` |
+| `render_pdf_bindings(bindings, deterministic_hash=None)` | `bytes` |
+| `render_pdf_bindings_to_file(bindings, path, deterministic_hash=None)` | `int` |
+
+The compiled lane runs parsing/layout once. `render_pdf_batch` virtualizes identical untagged page
+content. The binding methods instead accept columnar `dict[str, list[str]]` data and emit distinct
+fixed-geometry text overlays per record while sharing static paint. They require exact slot keys,
+equal non-zero column lengths, page-local WinAnsi-compatible text, and an untagged profile; bound
+values do not trigger reflow.
+
 When `deterministic_hash` is set, engine writes PDF SHA-256 to the provided file path.
 
 `AssetBundle` methods:

{fullbleed-2.0.0 → fullbleed-2.2.0}/pyproject.toml

@@ -5,7 +5,7 @@ backend-path = ["build_backend"]
 
 [project]
 name = "fullbleed"
-version = "2.0.0"
+version = "2.2.0"
 description = "Deterministic static HTML/CSS-to-PDF renderer built in Rust"
 readme = "README.md"
 requires-python = ">=3.10"

{fullbleed-2.0.0 → fullbleed-2.2.0}/python/fullbleed/_abi.py

@@ -160,6 +160,66 @@ class WatermarkSpec(metaclass=_NativeFacadeType):
         }
 
 
+class CompiledDocument(metaclass=_NativeFacadeType):
+    """Immutable fixed-point display document produced by ``PdfEngine.compile_pdf``."""
+
+    __slots__ = ("_handle",)
+
+    def __init__(self, /):
+        raise TypeError("No constructor defined for CompiledDocument")
+
+    @classmethod
+    def _from_handle(cls, /, handle):
+        instance = object.__new__(cls)
+        instance._handle = handle
+        return instance
+
+    def stats(self, /):
+        return _call(self._handle, "CompiledDocument.stats")
+
+    def render_pdf(self, /, deterministic_hash=None):
+        return _call(
+            self._handle,
+            "CompiledDocument.render_pdf",
+            deterministic_hash,
+        )
+
+    def render_pdf_to_file(self, /, path, deterministic_hash=None):
+        return _call(
+            self._handle,
+            "CompiledDocument.render_pdf_to_file",
+            path,
+            deterministic_hash,
+        )
+
+    def render_pdf_batch(self, /, copies, deterministic_hash=None):
+        return _call(
+            self._handle,
+            "CompiledDocument.render_pdf_batch",
+            copies,
+            deterministic_hash,
+        )
+
+    def render_pdf_bindings(self, /, bindings, deterministic_hash=None):
+        """Render one fixed-geometry page set per row of columnar text bindings."""
+        return _call(
+            self._handle,
+            "CompiledDocument.render_pdf_bindings",
+            bindings,
+            deterministic_hash,
+        )
+
+    def render_pdf_bindings_to_file(self, /, bindings, path, deterministic_hash=None):
+        """Stream a columnar fixed-geometry binding batch directly to ``path``."""
+        return _call(
+            self._handle,
+            "CompiledDocument.render_pdf_bindings_to_file",
+            bindings,
+            path,
+            deterministic_hash,
+        )
+
+
 class PdfEngine(metaclass=_NativeFacadeType):
     __slots__ = ("_handle",)
 
@@ -500,6 +560,10 @@ class PdfEngine(metaclass=_NativeFacadeType):
     def render_pdf(self, /, html, css, deterministic_hash=None):
         return _call(self._handle, "PdfEngine.render_pdf", html, css, deterministic_hash)
 
+    def compile_pdf(self, /, html, css):
+        handle = _call(self._handle, "PdfEngine.compile_pdf", html, css)
+        return CompiledDocument._from_handle(handle)
+
     def render_image_pages(self, /, html, css, dpi=150):
         return _call(self._handle, "PdfEngine.render_image_pages", html, css, dpi)
 
@@ -811,6 +875,7 @@ def audit_sparse_page_visual_pair(source_png_path, render_png_path):
 
 __all__ = [
     "PdfEngine",
+    "CompiledDocument",
     "AssetKind",
     "Asset",
     "AssetBundle",
@@ -836,7 +901,14 @@ __all__ = [
 ]
 
 
-_CLASS_NAMES = {"PdfEngine", "AssetKind", "Asset", "AssetBundle", "WatermarkSpec"}
+_CLASS_NAMES = {
+    "PdfEngine",
+    "CompiledDocument",
+    "AssetKind",
+    "Asset",
+    "AssetBundle",
+    "WatermarkSpec",
+}
 for _name in __all__:
     globals()[_name].__module__ = (
         "builtins" if _name in _CLASS_NAMES else "fullbleed._fullbleed"

{fullbleed-2.0.0 → fullbleed-2.2.0}/python/fullbleed/ui/core.py

@@ -9,6 +9,25 @@ from typing import Any, Callable
 from .style import style_to_css
 
 
+_HTML_VOID_ELEMENTS = frozenset(
+    {
+        "area",
+        "base",
+        "br",
+        "col",
+        "embed",
+        "hr",
+        "img",
+        "input",
+        "link",
+        "meta",
+        "source",
+        "track",
+        "wbr",
+    }
+)
+
+
 def _normalize_css_href(value: str | None) -> str | None:
     if value is None:
         return None
@@ -256,6 +275,8 @@ def render_node(node: Any) -> str:
         return ""
     if isinstance(node, Element):
         attrs = _render_attrs(node.props)
+        if node.tag.casefold() in _HTML_VOID_ELEMENTS:
+            return f"<{node.tag}{attrs}>"
         children_html = "".join(render_node(child) for child in node.children)
         return f"<{node.tag}{attrs}>{children_html}</{node.tag}>"
     return escape(str(node))

{fullbleed-2.0.0 → fullbleed-2.2.0}/src/assets.rs

@@ -115,7 +115,10 @@ pub fn is_supported_font_path(path: &Path) -> bool {
     let Some(ext) = path.extension().and_then(|v| v.to_str()) else {
         return false;
     };
-    matches!(ext.to_ascii_lowercase().as_str(), "ttf" | "otf")
+    matches!(
+        ext.to_ascii_lowercase().as_str(),
+        "ttf" | "otf" | "ttc" | "otc"
+    )
 }
 
 #[cfg_attr(not(feature = "python"), allow(dead_code))]
@@ -512,9 +515,11 @@ mod tests {
     }
 
     #[test]
-    fn supported_font_path_accepts_ttf_and_otf() {
+    fn supported_font_path_accepts_sfnt_fonts_and_collections() {
         assert!(super::is_supported_font_path(Path::new("demo.ttf")));
         assert!(super::is_supported_font_path(Path::new("demo.otf")));
+        assert!(super::is_supported_font_path(Path::new("demo.ttc")));
+        assert!(super::is_supported_font_path(Path::new("demo.otc")));
         assert!(!super::is_supported_font_path(Path::new("demo.woff2")));
     }
 

{fullbleed-2.0.0 → fullbleed-2.2.0}/src/canvas.rs

@@ -164,6 +164,7 @@ pub enum Command {
         height: Pt,
         resource_id: String,
         filter: PaintFilterSpec,
+        css_shadow: bool,
     },
     BeginTag {
         role: String,
@@ -365,6 +366,10 @@ impl Canvas {
         self.current.commands.push(Command::SetStrokeColor(color));
     }
 
+    pub(crate) fn set_stroke_color_to_fill(&mut self) {
+        self.set_stroke_color(self.current_state.fill_color);
+    }
+
     pub fn set_line_width(&mut self, width: Pt) {
         let width = if width < Pt::ZERO { Pt::ZERO } else { width };
         if self.current_state.line_width == width {
@@ -703,6 +708,27 @@ impl Canvas {
             height,
             resource_id: resource_id.into(),
             filter,
+            css_shadow: false,
+        });
+    }
+
+    pub fn draw_css_shadow_filtered_form(
+        &mut self,
+        x: Pt,
+        y: Pt,
+        width: Pt,
+        height: Pt,
+        resource_id: impl Into<String>,
+        filter: PaintFilterSpec,
+    ) {
+        self.current.commands.push(Command::DrawFilteredForm {
+            x,
+            y,
+            width,
+            height,
+            resource_id: resource_id.into(),
+            filter,
+            css_shadow: true,
         });
     }