Add an editable Matplotlib SVG report starter

.gitattributes

@@ -43,3 +43,6 @@ examples/node/** text eol=lf
 examples/node-queue/** text eol=lf
 docs/assets/node-queue/** -text
 docs/assets/node-queue/*.pdf binary
+examples/matplotlib-report/** text eol=lf
+docs/assets/matplotlib-report/** -text
+docs/assets/matplotlib-report/*.pdf binary

.github/workflows/docs.yml

@@ -13,6 +13,37 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  matplotlib:
+    name: Matplotlib report (${{ matrix.os }})
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+      - name: Install the public engine, chart dependencies and independent readers
+        run: |
+          python -m pip install --only-binary=:all: -r examples/matplotlib-report/requirements.txt pypdf==6.19.0 pypdfium2==5.14.0
+      - name: Verify the actual chart-report ZIP and guide
+        run: |
+          python tools/build_matplotlib_starter.py
+          git diff --exit-code -- docs/assets/matplotlib-report/project.zip docs/assets/matplotlib-report/source.json
+          python tools/verify_matplotlib_starter.py
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: matplotlib-verification-${{ matrix.os }}
+          path: |
+            output/matplotlib-verification/*.json
+            output/matplotlib-verification/*.txt
+            output/matplotlib-verification/*.png
+            output/matplotlib-verification/render/
+            output/matplotlib-verification/edited/
+          retention-days: 14
   arabic:
     name: Arabic and English example (${{ matrix.os }})
     strategy:
@@ -425,7 +456,7 @@ jobs:
           path: site
   deploy:
     if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
-    needs: [build, aspnet, chinese, arabic, markdown, tagged-notice, rust-download]
+    needs: [build, aspnet, chinese, arabic, markdown, tagged-notice, rust-download, matplotlib]
     runs-on: ubuntu-latest
     permissions:
       pages: write

README.md

@@ -64,6 +64,16 @@ When changing the canonical domain, update `site_url`, `docs/robots.txt`, and th
 
 Fullbleed is MIT licensed. Do not publish unsupported performance comparisons, standards conformance claims, or stale licensing statements. Retain old page URLs through the redirect map when consolidating reference material.
 
+The Matplotlib report lives in `examples/matplotlib-report`. Install its pinned
+requirements and the independent PDF readers from the `matplotlib` CI job, then
+run `python tools/build_matplotlib_starter.py` and
+`python tools/verify_matplotlib_starter.py`. The verifier extracts the actual ZIP,
+executes its source and the guide snippet, inspects vector/PDF content, and tests
+replay, customization and invalid data. Use `--update-assets` only after reviewing
+both report pages; otherwise the verifier compares the output to the published
+PDF. New evidence runs need a fresh `--out` directory. CI retains Windows and
+Linux results and requires both jobs before deployment.
+
 ## Search discovery
 
 The site publishes an XML sitemap and crawlable canonical URLs. When the optional

docs/assets/matplotlib-report/source.json

@@ -0,0 +1,39 @@
+{
+  "schema": "fullbleed.matplotlib-starter.v1",
+  "fullbleed": "2.5.14",
+  "matplotlib": "3.11.2",
+  "files": [
+    {
+      "path": "README.md",
+      "bytes": 3021,
+      "sha256": "4e7bba4b699316da107842a865a00e5e99d3b15e22db0c2190548af2ba339d1f"
+    },
+    {
+      "path": "LICENSE",
+      "bytes": 1079,
+      "sha256": "36a2115938f6e68cf0d87eccff7a6a3e57c17017e909cbd640d51aff1fa0c5a9"
+    },
+    {
+      "path": "requirements.txt",
+      "bytes": 207,
+      "sha256": "23959e4531e1f1d883b8eb1d9f856a6e515af37e03392a596a653645225ccb30"
+    },
+    {
+      "path": "report.py",
+      "bytes": 10631,
+      "sha256": "6eea2aadcbed835daab999a92d3bc71b61a8650edd271abfc125a06317e5096b"
+    },
+    {
+      "path": "report.css",
+      "bytes": 2307,
+      "sha256": "4eb069e474d4bc063b66c4f0d02b1c741e6a0f2528603c61831c8cebac227960"
+    },
+    {
+      "path": "data.json",
+      "bytes": 696,
+      "sha256": "9c7ee6fbfb4462b3ab7878b2dda95291536ce71eda0bede23c3333ad3c85c601"
+    }
+  ],
+  "zip_bytes": 8180,
+  "zip_sha256": "6481af0405f5513481c362bb18109ef266c9f0b69a516736135e36efca5ea53a"
+}