hyperweave 0.2.4__tar.gz → 0.2.6__tar.gz

{hyperweave-0.2.4 → hyperweave-0.2.6}/.gitignore

@@ -27,7 +27,6 @@ htmlcov/
 archive/
 .claude/
 # CLAUDE.md
-docs/_notes/
 outputs/
 specs/
 # scripts/ is version-controlled (tests/test_proofset.py imports generate_proofset.py)

hyperweave-0.2.6/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+# Runs `ruff check` + `ruff format` automatically on every `git commit`.
+# Mirrors the two lint steps CI enforces in .github/workflows/ci.yml so CI
+# never surfaces formatting or lint failures that local commits should catch.
+#
+# One-time setup after cloning:
+#   uv sync --group dev
+#   uv run pre-commit install
+#
+# Manual run across the whole repo:
+#   uv run pre-commit run --all-files
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: \.svg$
+      - id: end-of-file-fixer
+        exclude: \.(svg|b64)$
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: [--maxkb=500]

{hyperweave-0.2.4 → hyperweave-0.2.6}/CHANGELOG.md

@@ -5,6 +5,47 @@ 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.2.6] - 2026-04-19
+
+### Added
+
+- **Font-aware text measurement.** `measure_text` dispatches to per-font LUTs via a `FontRegistry` (Inter, Orbitron, JetBrains Mono). Callers pass `font_family`, `font_size`, `font_weight`, `letter_spacing_em` — no more `bold` / `monospace` booleans. `scripts/extract_font_metrics.py` decodes base64 WOFF2 sources via fontTools and emits JSON matching the existing `inter.json` schema. The measurement contract (ASCII glyph set, linear size scaling, kerning and ligatures ignored, unknown family falls back to Inter with a one-shot warning) is documented verbatim at the top of `core/font_metrics.py`.
+- **Paradigm config files.** `data/paradigms/{default,chrome,brutalist}.yaml` carry per-paradigm layout and typography config. `ParadigmSpec` Pydantic model with nested frame configs (`badge`, `strip`, `banner`, `chart`, `stats`, `icon`) in `core/paradigm.py`. Loader + registry parity via `load_paradigms()` and `get_paradigms()`.
+- **Paradigm/genome cross-validation.** `compose/validate_paradigms.py::validate_genome_against_paradigms()` runs at `ConfigLoader.load`. Genomes that opt into a paradigm must declare every field in its `requires_genome_fields` or load raises `ValueError` with a structured message listing every missing `(paradigm, field)` pair. Kept out of `GenomeSpec` as a `@model_validator` to avoid a circular loader dependency.
+- **Invariant 11** (CLAUDE.md Verify block): no specimen colors in template fallbacks. `grep "default('#"` in templates must be zero.
+- **Invariant 12** (CLAUDE.md Verify block): adding a new paradigm within the existing frame contract requires zero Python edits. `grep 'paradigm == "'` in `.py` files and `grep '{% if paradigm'` in templates must both be zero.
+- Six extensibility-proof tests in `tests/test_paradigm_extensibility.py`. `tests/helpers.py::build_partial_genome_for_testing` provides an explicit test-only bypass for the validator.
+- `PROFILE_CONTRACTS.md` documents the paradigm contract: required genome fields per paradigm, how the dispatcher routes through `_resolve_paradigm` and `load_paradigms`, how to add a new paradigm from YAML + templates alone.
+
+### Fixed
+
+- **Brutalist badge value text collided with the status indicator.** The pre-v0.2.6 resolver measured monospace text at a cross-platform-safe 7.2 px/char; per-font LUTs measure JetBrains Mono at its accurate 6.6 px/char, so the old safety margin is gone. Brutalist badge, strip, and banner defs now embed `@font-face` declarations via `{{ font_faces | safe }}` so rendered widths equal measured widths in any viewer — not just those that happen to have the system font installed. `default.yaml` font_family declarations corrected to JetBrains Mono to match what the default partials (which alias brutalist) actually render.
+- **Chrome templates no longer carry chrome-horizon's palette as fallback.** Every `| default('#hex')` specimen-leak chain is stripped from stats, chart, strip, banner, badge, icon, and all three marquee chrome templates. A future chrome genome that omits `envelope_stops`, `well_top`, `well_bottom`, `chrome_text_gradient`, `hero_text_gradient`, or `highlight_color` now fails at load time instead of silently inheriting chrome-horizon's cyan.
+
+### Changed
+
+- **`banner.svg.j2` split.** 224-line monolith with inline `{% if paradigm_banner == "chrome" %}` branches replaced by a 23-line dispatcher plus `frames/banner/{chrome,default}-content.j2` partials. Banner now matches the partial-dispatch pattern used by strip, badge, stats, and chart.
+- **Resolvers consume `paradigm_spec` directly.** `resolve_badge`, `resolve_strip`, `resolve_chart`, `resolve_stats`, `resolve_icon`, and `resolve_banner` read `paradigm_spec.{frame}.{key}` instead of comparing the paradigm slug inline. `_PROFILE_SHAPES` and `_STATS_HEIGHTS` dicts are gone; their content lives in the paradigm YAMLs.
+- **Strip inline paradigm branches replaced with context vars.** `divider_render_mode` and `status_shape_rendering` are injected by the resolver from paradigm config; the template branches on resolved values, not on slug strings.
+- `_profile_visual_context` renamed to `_genome_material_context` — it has always read from `genome`, not `profile`.
+- `measure_text` signature is now keyword-only after the leading `text` positional. `bold` and `monospace` kwargs removed.
+
+### Removed
+
+- `text_metrics` field on `GenomeSpec`. The per-zone width multiplier (`badge_value_width_factor: 1.35` on chrome-horizon) was a workaround for the Inter-only LUT; with per-font LUTs it is redundant.
+- `font_scale` heuristic in the marquee row-width helper. Replaced by font-family-aware measurement.
+- Dead `specular_sweep_dur` and `specular_sweep_peak` fields from `GenomeSpec`, `chrome.contract.json`, and `chrome-horizon.json`. `highlight_opacity` is retained — it has live consumers in badge and strip chrome content.
+
+### Dev dependencies
+
+- `fontTools` and `brotli` added so the font-metrics extraction script can decode WOFF2.
+
+## [0.2.5] - 2026-04-13
+
+### Fixed
+
+- **Chart bezier regression on certain data ranges.** The chrome chart bezier path used horizontal tangents at every anchor, which produced a smooth curve only when input points were widely and evenly spaced. On tighter or uneven distributions — common with real GitHub stargazer data — the curve degenerated into flat-then-vertical segments. Replaced with Fritsch-Carlson monotonic cubic interpolation (the same algorithm D3's `curveMonotoneX` uses), which guarantees the curve passes through every anchor, never overshoots between points, and handles any point spacing robustly.
+
 ## [0.2.4] - 2026-04-13
 
 ### Added

{hyperweave-0.2.4 → hyperweave-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.2.4
+Version: 0.2.6
 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
@@ -8,7 +8,7 @@ Project-URL: Discord, https://discord.gg/wVmcAZPQZ8
 Author: InnerAura Labs
 License-Expression: Apache-2.0
 License-File: LICENSE
-Keywords: ai-agents,claude-code,design-system,developer-tools,fastapi,generative-ui,mcp,mcp-server,svg,svg-generation
+Keywords: ai-agents,badges,claude-code,design-system,developer-tools,fastapi,generative-ui,github-profile,mcp,mcp-server,profile-readme,svg,svg-generation
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -56,6 +56,12 @@ Description-Content-Type: text/markdown
 </p>
 
 <!--
+HyperWeave is the generative visual identity system for the agentic era. A user defines a genome — their aesthetic DNA — and HyperWeave renders coherent visual artifacts across any surface, for any context, from any data. Badges for repos. Banners for profiles. Cards for stats. Charts for data. Artifact sets for research papers. Release kits for product launches. Marketing assets for startups. Static when static. Live when live. Generated when generative. Their brand, as infrastructure, for everything their agents will ever need to render.
+
+The list in the middle ("Badges for repos. Banners for profiles. Cards for stats...") reads long. It proves the surface area is broad but it also reads like a features list. Investors skim past enumeration. You could collapse it: "Every surface agents render on, from repos to research papers to product launches." The breadth lands harder when it's a claim than when it's a list.
+
+HyperWeave is the brand agent for engineering teams. Define your identity once; every artifact your team ships carries it wherever their work appears.
+
 Safe, Auditable, Drop-Anywhere Visuals for your Agents.
 
 ---
@@ -397,4 +403,4 @@ HyperWeave is early. If you're interested in building genomes, extending frame t
 [x]: https://x.com/InnerAuraLabs
 [youtube]: https://www.youtube.com/@InnerAuraLabs
 
-[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg
+[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg

{hyperweave-0.2.4 → hyperweave-0.2.6}/README.md

@@ -24,6 +24,12 @@
 </p>
 
 <!--
+HyperWeave is the generative visual identity system for the agentic era. A user defines a genome — their aesthetic DNA — and HyperWeave renders coherent visual artifacts across any surface, for any context, from any data. Badges for repos. Banners for profiles. Cards for stats. Charts for data. Artifact sets for research papers. Release kits for product launches. Marketing assets for startups. Static when static. Live when live. Generated when generative. Their brand, as infrastructure, for everything their agents will ever need to render.
+
+The list in the middle ("Badges for repos. Banners for profiles. Cards for stats...") reads long. It proves the surface area is broad but it also reads like a features list. Investors skim past enumeration. You could collapse it: "Every surface agents render on, from repos to research papers to product launches." The breadth lands harder when it's a claim than when it's a list.
+
+HyperWeave is the brand agent for engineering teams. Define your identity once; every artifact your team ships carries it wherever their work appears.
+
 Safe, Auditable, Drop-Anywhere Visuals for your Agents.
 
 ---
@@ -365,4 +371,4 @@ HyperWeave is early. If you're interested in building genomes, extending frame t
 [x]: https://x.com/InnerAuraLabs
 [youtube]: https://www.youtube.com/@InnerAuraLabs
 
-[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg
+[return-top]: https://raw.githubusercontent.com/InnerAura/hyperweave/f36c8969d15d76da4400ebcfaa04ec1e2eacb170/assets/buttons/button-liquid.svg

{hyperweave-0.2.4 → hyperweave-0.2.6}/pyproject.toml

@@ -17,6 +17,9 @@ keywords = [
     "developer-tools",
     "fastapi",
     "claude-code",
+    "badges",
+    "github-profile",
+    "profile-readme",
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -77,6 +80,9 @@ dev = [
     "ruff>=0.9",
     "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.2.6/scripts/extract_font_metrics.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""Extract per-codepoint advance widths from bundled WOFF2 fonts.
+
+HyperWeave bundles fonts as base64-encoded WOFF2 in
+``src/hyperweave/data/fonts/*.b64`` (so the whole font registry ships
+as plain-text files, diffable in git). This script decodes each font,
+reads its ``hmtx`` table via ``fontTools``, and emits a JSON file at
+``src/hyperweave/data/font-metrics/{slug}.json`` matching the existing
+``inter.json`` schema:
+
+    {
+      "font_family": "Orbitron",
+      "baseline_size_px": 20,
+      "units": "tenths_of_pixels",
+      "bold_expansion_factor": 1.06,
+      "fallback_width": 110,
+      "widths": { " ": 78, "A": 145, ... }
+    }
+
+The baseline size is chosen close to the font's dominant rendered size
+in HyperWeave (20px for Orbitron in stats hero values, 11px for
+Inter in badge labels). Widths are stored in tenths-of-pixels at the
+baseline size, so a glyph of 145 tenths at baseline 20px renders as
+14.5px wide at 20px and ~7.25px wide at 10px (linear scaling).
+
+Usage:
+    uv run python scripts/extract_font_metrics.py orbitron --baseline 20
+    uv run python scripts/extract_font_metrics.py jetbrains-mono --baseline 11
+    uv run python scripts/extract_font_metrics.py --all
+"""
+
+from __future__ import annotations
+
+import argparse
+import base64
+import json
+import sys
+from io import BytesIO
+from pathlib import Path
+
+from fontTools.ttLib import TTFont
+
+ROOT = Path(__file__).resolve().parent.parent
+FONTS_DIR = ROOT / "src" / "hyperweave" / "data" / "fonts"
+METRICS_DIR = ROOT / "src" / "hyperweave" / "data" / "font-metrics"
+
+# ASCII printable characters we shipped in inter.json (space through ~).
+SUPPORTED_ASCII = [chr(c) for c in range(0x20, 0x7F)]
+
+
+def load_font_from_b64(path: Path) -> TTFont:
+    """Decode a base64-encoded WOFF2 payload and return a TTFont."""
+    raw_b64 = path.read_text()
+    return TTFont(BytesIO(base64.b64decode(raw_b64)))
+
+
+def extract_widths(font: TTFont, baseline_size_px: int) -> dict[str, int]:
+    """Return char -> width-in-tenths-of-pixels-at-baseline dict.
+
+    Uses the font's ``cmap`` to map each supported ASCII codepoint to a
+    glyph name, then reads the glyph's ``hmtx`` advance width in
+    font-design units. Units are converted to pixels at
+    ``baseline_size_px`` via ``units_per_em``, then scaled by 10 to
+    match the ``tenths_of_pixels`` convention in ``inter.json``.
+    """
+    cmap = font.getBestCmap()
+    hmtx = font["hmtx"]
+    units_per_em = font["head"].unitsPerEm
+    widths: dict[str, int] = {}
+    for ch in SUPPORTED_ASCII:
+        codepoint = ord(ch)
+        if codepoint not in cmap:
+            continue
+        glyph_name = cmap[codepoint]
+        advance_design_units, _lsb = hmtx[glyph_name]
+        advance_px_at_baseline = advance_design_units * baseline_size_px / units_per_em
+        widths[ch] = round(advance_px_at_baseline * 10)
+    return widths
+
+
+def compute_fallback_width(widths: dict[str, int]) -> int:
+    """Median-ish fallback width for codepoints outside the supported set."""
+    if not widths:
+        return 60
+    sorted_widths = sorted(widths.values())
+    return sorted_widths[len(sorted_widths) // 2]
+
+
+def emit_metrics_json(
+    family: str,
+    baseline_size_px: int,
+    widths: dict[str, int],
+    bold_expansion_factor: float,
+    aliases: list[str],
+    is_monospace: bool = False,
+    char_width_px: float = 0.0,
+) -> dict[str, object]:
+    """Build the JSON dict matching inter.json schema (plus registry fields)."""
+    result: dict[str, object] = {
+        "font_family": family,
+        "baseline_size_px": baseline_size_px,
+        "units": "tenths_of_pixels",
+        "bold_expansion_factor": bold_expansion_factor,
+        "fallback_width": compute_fallback_width(widths),
+        "aliases": aliases,
+        "is_monospace": is_monospace,
+        "char_width_px": char_width_px,
+        "widths": widths,
+    }
+    return result
+
+
+# Known font configs. Add entries here to extend.
+FONT_CONFIGS: dict[str, dict[str, object]] = {
+    "orbitron": {
+        "family": "Orbitron",
+        "baseline_size_px": 20,
+        "bold_expansion_factor": 1.06,
+        "aliases": ["orbitron"],
+        "is_monospace": False,
+        "char_width_px": 0.0,
+    },
+    "jetbrains-mono": {
+        "family": "JetBrains Mono",
+        "baseline_size_px": 11,
+        "bold_expansion_factor": 1.0,  # true monospace — no bold width change
+        "aliases": ["jetbrains mono", "jetbrains-mono", "sf mono", "menlo", "monospace"],
+        "is_monospace": True,
+        # char_width_px populated below from extracted widths (median).
+        "char_width_px": 0.0,
+    },
+}
+
+
+def extract_one(slug: str) -> Path:
+    """Extract one font to ``data/font-metrics/{slug}.json``."""
+    if slug not in FONT_CONFIGS:
+        raise ValueError(f"Unknown font slug '{slug}'. Known: {sorted(FONT_CONFIGS)}")
+    config = FONT_CONFIGS[slug]
+    b64_path = FONTS_DIR / f"{slug}.b64"
+    if not b64_path.exists():
+        raise FileNotFoundError(f"Missing font source: {b64_path}")
+
+    font = load_font_from_b64(b64_path)
+    baseline = int(config["baseline_size_px"])
+    widths = extract_widths(font, baseline)
+
+    char_width_px = float(config["char_width_px"])
+    is_mono = bool(config["is_monospace"])
+    if is_mono and char_width_px == 0.0 and widths:
+        # Monospace: all chars have the same advance; pick the first mapped width.
+        advance_tenths = next(iter(widths.values()))
+        char_width_px = advance_tenths / 10.0
+
+    data = emit_metrics_json(
+        family=str(config["family"]),
+        baseline_size_px=baseline,
+        widths=widths,
+        bold_expansion_factor=float(config["bold_expansion_factor"]),
+        aliases=list(config["aliases"]),  # type: ignore[arg-type]
+        is_monospace=is_mono,
+        char_width_px=char_width_px,
+    )
+
+    out_path = METRICS_DIR / f"{slug}.json"
+    METRICS_DIR.mkdir(parents=True, exist_ok=True)
+    out_path.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n")
+    return out_path
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("slugs", nargs="*", help="Font slugs to extract (e.g. orbitron jetbrains-mono).")
+    parser.add_argument("--all", action="store_true", help="Extract every font in FONT_CONFIGS.")
+    args = parser.parse_args()
+
+    if args.all:
+        slugs = sorted(FONT_CONFIGS.keys())
+    elif args.slugs:
+        slugs = args.slugs
+    else:
+        parser.print_help()
+        return 1
+
+    for slug in slugs:
+        out = extract_one(slug)
+        sys.stdout.write(f"  wrote {out.relative_to(ROOT)}\n")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{hyperweave-0.2.4 → hyperweave-0.2.6}/src/hyperweave/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.4'
-__version_tuple__ = version_tuple = (0, 2, 4)
+__version__ = version = '0.2.6'
+__version_tuple__ = version_tuple = (0, 2, 6)
 
 __commit_id__ = commit_id = None