hyperweave 0.3.6__tar.gz → 0.3.7__tar.gz

{hyperweave-0.3.6 → hyperweave-0.3.7}/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to HyperWeave 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).
 
+## [0.3.7] - 2026-05-18
+
+Font payloads now embed only the characters each artifact actually renders, and fonts an artifact never displays are no longer embedded at all. Across every text-bearing artifact type — badges, strips, stats cards, star charts, marquees, receipts, and rhythm strips — and across all three genomes, gzip size drops by an average of 59% per artifact.
+
+### Changed
+
+- **Brutalist badge embedding** — single JetBrains Mono `@font-face` block. Barlow Condensed embeds only in stats, strips, and charts.
+- **Automata badge embedding** — Orbitron + Chakra Petch only. JetBrains Mono no longer ships in badges since no badge text uses it.
+- **Automata chart embedding** — Orbitron + JetBrains Mono only. Chakra Petch dropped since no chart text uses it.
+- **Per-genome, per-frame embed list** — `data/font-embedding.yaml` declares which fonts ship for each genome-and-artifact combination. Adding a font is a single YAML edit, no Python changes.
+
+### Fixed
+
+- **Codex Stop hook crash on receipt render** — `fonttools` and `brotli` are now runtime dependencies, so `uv tool install` users no longer hit `ModuleNotFoundError: fontTools` when the hook fires.
+
+### Notes
+
+- Repeat renders of the same text reuse a cached subset, so the first request pays the subsetting cost and subsequent requests don't.
+- CJK locale font embedding deferred to a future release.
+- Icons and dividers continue to embed zero fonts.
+
 ## [0.3.6] - 2026-05-18
 
 Receipt active-duration sources from per-turn compute when the runtime emits it; long-running sessions no longer inflate via stage-span summation. Codex hooks migrate to the wrapped-matcher GA layout shipped in the Codex CLI v0.129 release. The `data-hw-genome` root attribute reflects the resolved genome ID instead of raw spec input.

{hyperweave-0.3.6 → hyperweave-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.3.6
+Version: 0.3.7
 Summary: Headless visual output layer for AI agents. One API call → self-contained SVG.
 Project-URL: Repository, https://github.com/InnerAura/hyperweave
 Project-URL: Issues, https://github.com/InnerAura/hyperweave/issues
@@ -19,8 +19,10 @@ Classifier: Topic :: Multimedia :: Graphics
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
+Requires-Dist: brotli>=1.2.0
 Requires-Dist: fastapi>=0.115
 Requires-Dist: fastmcp>=3.0
+Requires-Dist: fonttools>=4.62.1
 Requires-Dist: httpx[http2]>=0.28
 Requires-Dist: jinja2>=3.1
 Requires-Dist: pydantic-settings>=2.0
@@ -241,11 +243,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=celadon" alt="github — celadon" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=circle&variant=carbon" alt="discord — carbon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=circle&variant=celadon" alt="spotify — celadon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=carbon" alt="github — carbon" width="56"/>
   <img src="https://hyperweave.app/v1/icon/docker/brutalist.static?shape=circle&variant=alloy" alt="docker — alloy" width="56"/>
   <img src="https://hyperweave.app/v1/icon/npm/brutalist.static?shape=square&variant=temper" alt="npm — temper" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=square&variant=pigment" alt="spotify — pigment" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=square&variant=pigment" alt="discord — pigment" width="56"/>
   <img src="https://hyperweave.app/v1/icon/anthropic/brutalist.static?shape=square&variant=ember" alt="anthropic — ember" width="56"/>
   <br/>
   <ul>
@@ -269,11 +271,23 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="automata">automata</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/DOCKER/PULL/automata.static?glyph=docker&variant=teal" alt="DOCKER PULL — teal variant"/>
-  <img src="https://hyperweave.app/v1/badge/DISCORD/JOIN/automata.static?glyph=discord&variant=violet" alt="DISCORD JOIN — violet variant"/>
-  <img src="https://hyperweave.app/v1/badge/STARS/automata.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=amber" alt="STARS — amber variant"/>
-  <img src="https://hyperweave.app/v1/badge/HF/MODELS/automata.static?glyph=huggingface&variant=sulfur" alt="HF MODELS — sulfur variant"/>
-  <img src="https://hyperweave.app/v1/badge/SPOTIFY/LISTEN/automata.static?glyph=spotify&variant=jade" alt="SPOTIFY LISTEN — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=violet&size=compact" alt="PYPI — violet variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=teal&size=compact" alt="PYPI — teal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=bone&size=compact" alt="PYPI — bone variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=steel&size=compact" alt="PYPI — steel variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=amber&size=compact" alt="PYPI — amber variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=jade&size=compact" alt="PYPI — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=magenta&size=compact" alt="PYPI — magenta variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=cobalt&size=compact" alt="PYPI — cobalt variant"/>
+  <br/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=toxic&size=compact" alt="PYPI — toxic variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=solar&size=compact" alt="PYPI — solar variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal&size=compact" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=crimson&size=compact" alt="PYPI — crimson variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=sulfur&size=compact" alt="PYPI — sulfur variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=indigo&size=compact" alt="PYPI — indigo variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=burgundy&size=compact" alt="PYPI — burgundy variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=copper&size=compact" alt="PYPI — copper variant"/>
 </p>
 
 <p align="center">
@@ -370,11 +384,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="chrome">chrome</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/BUILD/chrome.static?data=gh:InnerAura/hyperweave.build&glyph=githubactions&variant=horizon" alt="BUILD — horizon variant"/>
-  <img src="https://hyperweave.app/v1/badge/BLUESKY/POST/chrome.static?glyph=bluesky&variant=abyssal" alt="BLUESKY POST — abyssal variant"/>
-  <img src="https://hyperweave.app/v1/badge/DOCKER/chrome.static?data=docker:zeroxeli/readme-ai.pull_count&glyph=docker&variant=lightning" alt="DOCKER pulls — lightning variant"/>
-  <img src="https://hyperweave.app/v1/badge/STARS/chrome.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=graphite" alt="STARS — graphite variant"/>
-  <img src="https://hyperweave.app/v1/badge/ANTHROPIC/CLAUDE/chrome.static?glyph=anthropic&variant=moth" alt="ANTHROPIC CLAUDE — moth variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=horizon" alt="PYPI — horizon variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=lightning" alt="PYPI — lightning variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=graphite" alt="PYPI — graphite variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=moth" alt="PYPI — moth variant"/>
 </p>
 
 <p align="center">
@@ -442,10 +456,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/youtube/chrome.static?shape=circle&variant=horizon" alt="youtube" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=horizon" alt="notion" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/npm/chrome.static?shape=square&variant=horizon" alt="npm" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/instagram/chrome.static?shape=square&variant=horizon" alt="instagram" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/chrome.static?shape=circle&variant=horizon" alt="github — horizon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=graphite" alt="notion — graphite" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/rust/chrome.static?shape=square&variant=moth" alt="rust — moth" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/docker/chrome.static?shape=square&variant=lightning" alt="docker — lightning" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/chrome.static?shape=square&variant=abyssal" alt="spotify — abyssal" width="56"/>
   <br/>
   <ul>
 <li><sub><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></sub></li>

{hyperweave-0.3.6 → hyperweave-0.3.7}/README.md

@@ -209,11 +209,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=celadon" alt="github — celadon" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=circle&variant=carbon" alt="discord — carbon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=circle&variant=celadon" alt="spotify — celadon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/brutalist.static?shape=circle&variant=carbon" alt="github — carbon" width="56"/>
   <img src="https://hyperweave.app/v1/icon/docker/brutalist.static?shape=circle&variant=alloy" alt="docker — alloy" width="56"/>
   <img src="https://hyperweave.app/v1/icon/npm/brutalist.static?shape=square&variant=temper" alt="npm — temper" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/spotify/brutalist.static?shape=square&variant=pigment" alt="spotify — pigment" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/discord/brutalist.static?shape=square&variant=pigment" alt="discord — pigment" width="56"/>
   <img src="https://hyperweave.app/v1/icon/anthropic/brutalist.static?shape=square&variant=ember" alt="anthropic — ember" width="56"/>
   <br/>
   <ul>
@@ -237,11 +237,23 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="automata">automata</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/DOCKER/PULL/automata.static?glyph=docker&variant=teal" alt="DOCKER PULL — teal variant"/>
-  <img src="https://hyperweave.app/v1/badge/DISCORD/JOIN/automata.static?glyph=discord&variant=violet" alt="DISCORD JOIN — violet variant"/>
-  <img src="https://hyperweave.app/v1/badge/STARS/automata.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=amber" alt="STARS — amber variant"/>
-  <img src="https://hyperweave.app/v1/badge/HF/MODELS/automata.static?glyph=huggingface&variant=sulfur" alt="HF MODELS — sulfur variant"/>
-  <img src="https://hyperweave.app/v1/badge/SPOTIFY/LISTEN/automata.static?glyph=spotify&variant=jade" alt="SPOTIFY LISTEN — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=violet&size=compact" alt="PYPI — violet variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=teal&size=compact" alt="PYPI — teal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=bone&size=compact" alt="PYPI — bone variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=steel&size=compact" alt="PYPI — steel variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=amber&size=compact" alt="PYPI — amber variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=jade&size=compact" alt="PYPI — jade variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=magenta&size=compact" alt="PYPI — magenta variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=cobalt&size=compact" alt="PYPI — cobalt variant"/>
+  <br/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=toxic&size=compact" alt="PYPI — toxic variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=solar&size=compact" alt="PYPI — solar variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal&size=compact" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=crimson&size=compact" alt="PYPI — crimson variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=sulfur&size=compact" alt="PYPI — sulfur variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=indigo&size=compact" alt="PYPI — indigo variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=burgundy&size=compact" alt="PYPI — burgundy variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/automata.static?data=pypi:hyperweave.version&glyph=python&variant=copper&size=compact" alt="PYPI — copper variant"/>
 </p>
 
 <p align="center">
@@ -338,11 +350,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <h3 id="chrome">chrome</h3>
 
 <p align="center">
-  <img src="https://hyperweave.app/v1/badge/BUILD/chrome.static?data=gh:InnerAura/hyperweave.build&glyph=githubactions&variant=horizon" alt="BUILD — horizon variant"/>
-  <img src="https://hyperweave.app/v1/badge/BLUESKY/POST/chrome.static?glyph=bluesky&variant=abyssal" alt="BLUESKY POST — abyssal variant"/>
-  <img src="https://hyperweave.app/v1/badge/DOCKER/chrome.static?data=docker:zeroxeli/readme-ai.pull_count&glyph=docker&variant=lightning" alt="DOCKER pulls — lightning variant"/>
-  <img src="https://hyperweave.app/v1/badge/STARS/chrome.static?data=gh:eli64s/readme-ai.stars&glyph=github&variant=graphite" alt="STARS — graphite variant"/>
-  <img src="https://hyperweave.app/v1/badge/ANTHROPIC/CLAUDE/chrome.static?glyph=anthropic&variant=moth" alt="ANTHROPIC CLAUDE — moth variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=horizon" alt="PYPI — horizon variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=abyssal" alt="PYPI — abyssal variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=lightning" alt="PYPI — lightning variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=graphite" alt="PYPI — graphite variant"/>
+  <img src="https://hyperweave.app/v1/badge/PYPI/chrome.static?data=pypi:hyperweave.version&glyph=python&variant=moth" alt="PYPI — moth variant"/>
 </p>
 
 <p align="center">
@@ -410,10 +422,11 @@ Why genome and not theme? Because brand isn't a design problem, it's an infrastr
 <tr>
 <th align="left">Icons<br/><sub>circle + square</sub></th>
 <td>
-  <img src="https://hyperweave.app/v1/icon/youtube/chrome.static?shape=circle&variant=horizon" alt="youtube" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=horizon" alt="notion" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/npm/chrome.static?shape=square&variant=horizon" alt="npm" width="56"/>
-  <img src="https://hyperweave.app/v1/icon/instagram/chrome.static?shape=square&variant=horizon" alt="instagram" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/github/chrome.static?shape=circle&variant=horizon" alt="github — horizon" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/notion/chrome.static?shape=circle&variant=graphite" alt="notion — graphite" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/rust/chrome.static?shape=square&variant=moth" alt="rust — moth" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/docker/chrome.static?shape=square&variant=lightning" alt="docker — lightning" width="56"/>
+  <img src="https://hyperweave.app/v1/icon/spotify/chrome.static?shape=square&variant=abyssal" alt="spotify — abyssal" width="56"/>
   <br/>
   <ul>
 <li><sub><code>/v1/icon/{glyph}/{genome}.static?shape={circle|square}&variant={variant}</code></sub></li>

{hyperweave-0.3.6 → hyperweave-0.3.7}/pyproject.toml

@@ -42,6 +42,13 @@ dependencies = [
     "httpx[http2]>=0.28",
     "fastmcp>=3.0",
     "pyyaml>=6.0",
+    # Font subsetting (v0.3.7). Runtime — not dev-only — because
+    # render/fonts.py imports fontTools at module top-level, which
+    # executes on every receipt render. brotli is the WOFF2 codec
+    # fontTools uses inside font.save(flavor="woff2") and must be
+    # importable on every install (uv tool install, pip install, etc.).
+    "fonttools>=4.62.1",
+    "brotli>=1.2.0",
 ]
 
 [project.urls]
@@ -81,8 +88,6 @@ dev = [
     "mypy>=1.14",
     "types-pyyaml>=6.0.12.20250915",
     "pre-commit>=4.0",
-    "fonttools>=4.62.1",
-    "brotli>=1.2.0",
 ]
 
 [tool.pytest.ini_options]

{hyperweave-0.3.6 → hyperweave-0.3.7}/scripts/generate_proofset.py

@@ -1691,6 +1691,18 @@ def main() -> None:
     parser.add_argument("--live", action="store_true", help="Include network-dependent artifacts")
     args = parser.parse_args()
 
+    # Wipe outputs/proofset/ before regenerating so renamed/retired artifacts
+    # (paired-variant pairings, telemetry size variants) don't carry stale
+    # payloads forward and create false audit noise. READMEs live one level up
+    # (outputs/README*.md) and are preserved.
+    import shutil
+
+    proofset_dir = OUT / "proofset"
+    if proofset_dir.exists():
+        stale = sum(1 for _ in proofset_dir.rglob("*.svg"))
+        shutil.rmtree(proofset_dir)
+        print(f"Cleaned {stale} stale artifacts from {proofset_dir}")
+
     print("Generating static proof set...")
     total = generate_static()
     print(f"  {total} static artifacts")

{hyperweave-0.3.6 → hyperweave-0.3.7}/src/hyperweave/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.3.6'
-__version_tuple__ = version_tuple = (0, 3, 6)
+__version__ = version = '0.3.7'
+__version_tuple__ = version_tuple = (0, 3, 7)
 
 __commit_id__ = commit_id = None

{hyperweave-0.3.6 → hyperweave-0.3.7}/src/hyperweave/compose/assembler.py

@@ -19,63 +19,49 @@ _BRIDGE_FRAMES: frozenset[str] = frozenset({FrameType.BADGE, FrameType.STRIP, Fr
 # Marquee frame types — need frame_fill, status colors, ink tiers
 _MARQUEE_FRAMES: frozenset[str] = frozenset({FrameType.MARQUEE_HORIZONTAL})
 
-# Per-frame font allowlist: maps each frame type to the font slugs that frame's
-# templates actually render. Frames absent from the dict embed zero fonts (icon,
-# divider). This is a refinement of the pre-v0.3.0 binary gate (frozenset of
-# frame names): the dict shape lets each frame declare exactly the slugs it
-# needs, so a marquee carrying only Orbitron text doesn't ship JetBrains Mono
-# and Chakra Petch base64 payloads it never references.
-#
-# Slugs match the keys in ``data/fonts/{slug}.b64`` and the entries in genome
-# ``fonts`` lists. The intersection of the genome's font list and a frame's
-# allowed slugs is what actually gets embedded.
+
+# Font embedding gate: per-(genome_id, frame_type) lookup against the YAML
+# config at ``data/font-embedding.yaml``. Replaces the v0.3.5 frozenset
+# table that was keyed only by frame_type — which meant the brutalist
+# badge embedded the genome's full font list (~28KB of unused Barlow
+# Condensed base64) because the genome declared Barlow for stats/strip/
+# chart and the badge frame's allowlist passed it through.
 #
-# Per-frame allocation rationale:
-# - BADGE / STRIP / RECEIPT / RHYTHM_STRIP / MASTER_CARD / CATALOG: full 3-font
-#   set — these frames render mixed typography (mono labels, display values,
-#   chakra-petch metrics).
-# - STATS: full 3-font set — Chakra Petch for metric values, Orbitron for
-#   username/title, JetBrains Mono for labels.
-# - CHART: Orbitron (header zone) + JetBrains Mono (axis labels). Chart never
-#   renders Chakra Petch — saving ~13KB per chart artifact.
-# - MARQUEE_HORIZONTAL: Orbitron only. Cellular marquee scroll text is Orbitron
-#   11px 700 with no other typography. Saving ~55KB per marquee artifact.
-# - ICON / DIVIDER: not in dict — zero fonts. Glyph-only rendering, no <text>
-#   elements.
-_BRUTALIST_FONTS: frozenset[str] = frozenset(
-    {"jetbrains-mono", "orbitron", "chakra-petch", "barlow-condensed-700", "barlow-condensed-900"}
-)
-_CHART_FONTS: frozenset[str] = frozenset({"jetbrains-mono", "orbitron", "barlow-condensed-700", "barlow-condensed-900"})
-_TELEMETRY_FONTS: frozenset[str] = frozenset({"jetbrains-mono", "orbitron", "chakra-petch"})
-
-_NEEDS_FONTS: dict[str, frozenset[str]] = {
-    FrameType.BADGE: _BRUTALIST_FONTS,
-    FrameType.STRIP: _BRUTALIST_FONTS,
-    FrameType.STATS: _BRUTALIST_FONTS,
-    FrameType.CHART: _CHART_FONTS,
-    FrameType.MARQUEE_HORIZONTAL: frozenset({"orbitron"}),
-    FrameType.RECEIPT: _TELEMETRY_FONTS,
-    FrameType.RHYTHM_STRIP: _TELEMETRY_FONTS,
-    FrameType.MASTER_CARD: _TELEMETRY_FONTS,
-    FrameType.CATALOG: _TELEMETRY_FONTS,
-}
-
-
-def frame_needs_fonts(frame_type: str) -> bool:
-    """Per-frame font-loading gate. Returns True if any fonts should be
-    embedded for this frame type. Frames absent from the ``_NEEDS_FONTS`` dict
-    return False — icon and divider render glyph-only with no ``<text>``
-    elements, so embedding fonts in them is pure payload waste.
+# The genome-aware lookup lets the brutalist badge embed only JetBrains
+# Mono (the one font its CSS classes actually reference) while the
+# brutalist stats card continues to embed all three fonts it needs.
+# Adding a new (genome, frame) binding is a YAML edit only (Invariant 12).
+def fonts_for_frame(frame_type: str, genome_id: str = "") -> frozenset[str]:
+    """Return the font slugs to embed for ``(frame_type, genome_id)``.
+
+    When ``genome_id`` matches a row in ``font-embedding.yaml``'s
+    ``genomes`` block, returns that row's per-frame list. Otherwise
+    falls back to ``defaults.<frame_type>`` — an empty list in v0.3.7,
+    matching icon/divider semantics for callers without resolved genome
+    context (e.g. ``_error_badge``).
+
+    The composer further intersects this with the genome's declared
+    ``fonts`` list at ``compose/context.py:_load_font_faces``, so a slug
+    listed here that the genome does not declare is a noop.
     """
-    return frame_type in _NEEDS_FONTS
+    from hyperweave.config.loader import load_font_embedding
+
+    embedding = load_font_embedding()
+    genome_block = embedding["genomes"].get(genome_id) if genome_id else None
+    if isinstance(genome_block, dict) and frame_type in genome_block:
+        slugs = genome_block.get(frame_type) or []
+    else:
+        slugs = embedding["defaults"].get(frame_type) or []
+    return frozenset(slugs)
 
 
-def fonts_for_frame(frame_type: str) -> frozenset[str]:
-    """Return the set of font slugs allowed for embedding in ``frame_type``'s
-    templates. Empty set for frames that don't render text. The font loader
-    intersects this with the genome's declared font list so genomes that don't
-    declare a slug still skip it even if the frame allows it."""
-    return _NEEDS_FONTS.get(frame_type, frozenset())
+def frame_needs_fonts(frame_type: str, genome_id: str = "") -> bool:
+    """Per-(frame_type, genome_id) font-loading gate. Returns True when
+    any fonts should be embedded — used by context-builder to gate the
+    ``data-hw-fonts="self-contained"`` SVG-root attribute and the
+    ``hw:css-modules`` debug comment.
+    """
+    return bool(fonts_for_frame(frame_type, genome_id))
 
 
 # Genome fields that signal a telemetry skin (presence-gates the tool-color CSS block)

{hyperweave-0.3.6 → hyperweave-0.3.7}/src/hyperweave/compose/context.py

@@ -95,27 +95,164 @@ def _compute_contrast_ratio(fg_hex: str, bg_hex: str) -> str:
     return f"{ratio:.1f}:1"
 
 
-def _load_font_faces(genome: dict[str, Any], frame_type: str) -> str:
-    """Load embedded font CSS for ``frame_type``, filtered to slugs the frame
-    actually renders.
-
-    Intersects the genome's declared ``fonts`` list with the per-frame allowlist
-    returned by :func:`fonts_for_frame`. A genome that declares all 3 fonts
-    (chakra-petch, orbitron, jetbrains-mono) will only embed Orbitron when the
-    frame is a marquee, saving ~55KB per artifact. Frames absent from the
-    allowlist (icon, divider) get an empty allowed set and embed zero fonts.
-
-    The intersection is order-preserving against the genome's declared list so
-    @font-face declarations render in genome-author intent order.
+def _load_font_faces(
+    genome: dict[str, Any],
+    frame_type: str,
+    char_set: frozenset[str] | None = None,
+) -> str:
+    """Load embedded font CSS for ``(frame_type, genome.id)``.
+
+    Intersects the genome's declared ``fonts`` list with the per-(genome,
+    frame) allowlist returned by :func:`fonts_for_frame`. The allowlist
+    is genome-aware (v0.3.7): the brutalist badge embeds JetBrains Mono
+    only even though the brutalist genome declares Barlow Condensed for
+    its stats/strip/chart frames. Frames whose ``(genome, frame)`` row
+    is empty (icons, dividers, error badges) embed zero fonts.
+
+    When ``char_set`` is provided each surviving font is subset to only
+    the codepoints the artifact actually renders. ``None`` embeds full
+    fonts (legacy behavior, ``_error_badge``).
+
+    The intersection is order-preserving against the genome's declared
+    list so ``@font-face`` declarations render in genome-author intent
+    order.
     """
     declared = genome.get("fonts") or ["jetbrains-mono"]
     if not isinstance(declared, list):
         declared = ["jetbrains-mono"]
-    allowed = fonts_for_frame(frame_type)
+    genome_id = genome.get("id", "")
+    allowed = fonts_for_frame(frame_type, genome_id)
     if not allowed:
         return ""
     filtered = [slug for slug in declared if slug in allowed]
-    return load_font_face_css(filtered)
+    return load_font_face_css(filtered, char_set)
+
+
+# Per-frame text-field maps for glyph subsetting. Each entry lists the
+# context keys whose string content reaches a rendered <text> element
+# and therefore must be present in the font subset. Glyph SVG paths,
+# reasoning metadata, ARIA strings, and version/created/contract_id
+# render via different paths (paths render as <path>, metadata renders
+# in <hw:*> blocks read by no browser font) and stay outside the
+# extraction surface.
+_TEXT_FIELDS_BY_FRAME: dict[str, tuple[str, ...]] = {
+    "badge": ("title", "value", "label", "description"),
+    "strip": ("title", "value", "label", "description"),
+    "stats": (
+        "stats_username",
+        "stats_bio",
+        "stats_repo_label",
+        "stars_display",
+        "stars_delta_display",
+        "commits_display",
+        "prs_display",
+        "issues_display",
+        "contrib_display",
+        "streak_display",
+        "languages",
+        "activity_bars",
+    ),
+    "chart": (
+        "chart_repo",
+        "chart_title",
+        "chart_current_stars",
+        "chart_axes",
+        "chart_milestones",
+        "chart_empty_state",
+    ),
+    "marquee-horizontal": ("scroll_items",),
+    "receipt": (
+        "hero_headline",
+        "hero_subline",
+        "hero_right_stats",
+        "treemap_legend",
+        "metadata_left",
+        "metadata_right",
+        "footer_left",
+        "footer_right",
+        "dominant_profile",
+        "phase_legend",
+    ),
+    "rhythm-strip": (
+        "session_id_short",
+        "elapsed_label",
+        "token_summary",
+        "velocity_value",
+        "loop_label",
+        "loop_detail",
+        "profile_label",
+        "stages",
+    ),
+    "master-card": (
+        "mc_title",
+        "mc_subtitle",
+        "mc_total_tokens",
+        "mc_total_cost",
+        "mc_sessions",
+        "mc_skills",
+        "session_entries",
+        "footer_left",
+        "footer_right",
+    ),
+    "catalog": (
+        "catalog_title",
+        "catalog_subtitle",
+        "catalog_items",
+        "catalog_footer_left",
+        "catalog_footer_right",
+    ),
+}
+
+# Conservative baseline character set. Always included even when the
+# template's resolved text is sparse — covers axis tick labels, %
+# suffixes, numeric formatters, paren-wrapped clarifiers, and unicode
+# arrows / dots used in chrome/brutalist label glyphs.
+_SAFE_BASELINE: frozenset[str] = frozenset(
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 .:,;-_/·→×%+()[]"  # noqa: RUF001  middle-dot / right-arrow / multiplication-sign are deliberate
+)
+
+
+def _collect_text(value: Any, chars: set[str]) -> None:
+    """Recursively walk ``value`` and absorb every string codepoint into ``chars``.
+
+    Lists, tuples, and dicts (keys + values) are traversed; ``None`` and
+    non-string scalars (numbers, bools) are skipped. The recursive shape
+    keeps the collector resilient against future context-field additions
+    that wrap text in additional dict/list layers — a new ``chart_axes``
+    entry shape doesn't need a corresponding extractor edit.
+    """
+    if value is None:
+        return
+    if isinstance(value, str):
+        chars.update(value)
+        return
+    if isinstance(value, list | tuple):
+        for item in value:
+            _collect_text(item, chars)
+        return
+    if isinstance(value, dict):
+        for k, v in value.items():
+            if isinstance(k, str):
+                chars.update(k)
+            _collect_text(v, chars)
+
+
+def _extract_char_set(ctx: dict[str, Any], frame_type: str) -> frozenset[str]:
+    """Return the union of the safe baseline and every rendered text char.
+
+    Reads the per-frame text-field map at :data:`_TEXT_FIELDS_BY_FRAME`
+    and recursively flattens each context value to its component codepoints.
+    Frames not in the map fall back to the baseline only.
+
+    Run AFTER the per-frame builder populates ``ctx`` (which means the
+    resolver-emitted text fields like ``chart_milestones`` and
+    ``stats_username`` are visible) — see the ordering note on
+    :func:`build_context`.
+    """
+    chars: set[str] = set(_SAFE_BASELINE)
+    for field in _TEXT_FIELDS_BY_FRAME.get(frame_type, ()):
+        _collect_text(ctx.get(field), chars)
+    return frozenset(chars)
 
 
 def build_context(
@@ -123,7 +260,17 @@ def build_context(
     resolved: ResolvedArtifact,
     css_bundle: dict[str, str],
 ) -> dict[str, Any]:
-    """Dispatch to the per-frame context builder."""
+    """Dispatch to the per-frame context builder, then wire font subsetting.
+
+    Per-frame builders fill ``ctx`` with the safe defaults and then merge
+    ``resolved.frame_context`` (resolver output: ``chart_milestones``,
+    ``stats_username``, ``scroll_items[*].text``, etc.). Only after that
+    merge runs does the rendered text surface become observable — which is
+    why v0.3.7 moves the ``font_faces`` assignment OUT of ``_base_context``
+    and INTO this post-builder step. The extractor at :func:`_extract_char_set`
+    then walks the fully-populated ctx and the subsetter at
+    :func:`_load_font_faces` emits a payload tuned to the actual glyph set.
+    """
     _BUILDERS: dict[str, _CtxBuilder] = {
         FrameType.BADGE: _ctx_badge,
         FrameType.STRIP: _ctx_strip,
@@ -140,6 +287,10 @@ def build_context(
     builder = _BUILDERS.get(spec.type, _ctx_badge)
     ctx = builder(spec, resolved, css_bundle)
     _inject_motion(ctx, spec, resolved)
+    genome_id = resolved.genome.get("id", "")
+    if frame_needs_fonts(spec.type, genome_id):
+        char_set = _extract_char_set(ctx, spec.type)
+        ctx["font_faces"] = _load_font_faces(resolved.genome, spec.type, char_set)
     return ctx
 
 
@@ -168,7 +319,7 @@ def _base_context(
     # surfaces here too so `grep "hw:css-modules"` across outputs/proofset/ can
     # confirm fonts were correctly excluded for icons/dividers.
     module_names = [k for k, v in css_bundle.items() if v]
-    if frame_needs_fonts(spec.type):
+    if frame_needs_fonts(spec.type, resolved.genome.get("id", "")):
         module_names.append("fonts")
     css_debug = f"/* hw:css-modules: {','.join(module_names)} */"
     css_assembled = css_debug + "\n" + "\n".join(p for p in css_parts if p)
@@ -310,14 +461,16 @@ def _base_context(
         # enforced at load time; missing entries return None and the metadata
         # template emits empty hw:reasoning fields gracefully.
         **_resolve_reasoning_context(spec, resolved),
-        # Embedded fonts (base64 @font-face CSS) — gated per frame_type via
-        # frame_needs_fonts() and filtered per frame's font allowlist via
-        # fonts_for_frame(). Icons / dividers receive empty string (not in
-        # _NEEDS_FONTS dict) so template-level {{ font_faces }} renders
-        # nothing. Marquee receives Orbitron only; chart receives Orbitron +
-        # JetBrains Mono. The frame-aware filtering mirrors the per-frame CSS
-        # module pattern at assembler.py:14-32.
-        "font_faces": _load_font_faces(resolved.genome, spec.type) if frame_needs_fonts(spec.type) else "",
+        # Embedded fonts (base64 @font-face CSS) — placeholder. The real
+        # assignment lands in build_context() AFTER the per-frame builder
+        # merges resolver text fields into ctx, so the glyph subsetter
+        # at _extract_char_set + _load_font_faces sees the full rendered
+        # text surface (chart milestone labels, stats username, marquee
+        # scroll items, etc.). Setting the empty default here keeps
+        # Jinja's StrictUndefined happy for any code path that bypasses
+        # build_context (none exist today, but the default is defense
+        # against future drift).
+        "font_faces": "",
     }
     return ctx, uid, artifact_id