hyperweave 0.2.1__tar.gz → 0.2.2__tar.gz

{hyperweave-0.2.1 → hyperweave-0.2.2}/.gitignore

@@ -27,10 +27,10 @@ htmlcov/
 archive/
 .claude/
 # CLAUDE.md
-docs/_notes/  
+docs/_notes/
 outputs/
-scripts/
 specs/
+# scripts/ is version-controlled (tests/test_proofset.py imports generate_proofset.py)
 
 assets/cards/butterfly-mcp.svg
 assets/cards/card-moon.svg

{hyperweave-0.2.1 → hyperweave-0.2.2}/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.2] - 2026-04-13
+
+### Fixed
+
+- **CI test job** was red on the v0.2.1 push because `tests/test_proofset.py` imports `scripts/generate_proofset.py`, but `scripts/` was excluded from version control by `.gitignore`. The three test runners saw `FileNotFoundError: No such file or directory: scripts/generate_proofset.py`. `scripts/` is now tracked (it is a dev-tools directory, not a runtime dependency, and remains excluded from the PyPI wheel by `[tool.hatch.build.targets.wheel].packages`).
+
 ## [0.2.1] - 2026-04-13
 
 Post-v0.2.0 stabilization: typography alignment, mobile rendering fix, and a streak computation correction.

{hyperweave-0.2.1 → hyperweave-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperweave
-Version: 0.2.1
+Version: 0.2.2
 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

hyperweave-0.2.2/scripts/extract_glyphs.py

@@ -0,0 +1,276 @@
+#!/usr/bin/env python3
+"""Extract curated glyphs from Simple Icons and output data/glyphs.json.
+
+Build-time only. Requires: npm install simple-icons (temp dev dependency).
+
+Usage:
+    npm install simple-icons  # one-time
+    python scripts/extract_glyphs.py
+
+Output:
+    src/hyperweave/data/glyphs.json
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+# Curated icon set per PRD SS10
+# Keys = Simple Icons export names (camelCase with 'si' prefix)
+# Values = (our slug, category)
+CURATED_ICONS: dict[str, tuple[str, str]] = {
+    # Social (LinkedIn/Slack removed from SI v16 — trademark)
+    "siGithub": ("github", "social"),
+    "siX": ("x", "social"),
+    "siDiscord": ("discord", "social"),
+    "siYoutube": ("youtube", "social"),
+    "siSpotify": ("spotify", "social"),
+    "siInstagram": ("instagram", "social"),
+    "siTiktok": ("tiktok", "social"),
+    "siReddit": ("reddit", "social"),
+    "siMastodon": ("mastodon", "social"),
+    "siBluesky": ("bluesky", "social"),
+    # Dev
+    "siPython": ("python", "dev"),
+    "siNpm": ("npm", "dev"),
+    "siDocker": ("docker", "dev"),
+    "siRust": ("rust", "dev"),
+    "siGo": ("go", "dev"),
+    "siTypescript": ("typescript", "dev"),
+    "siJavascript": ("javascript", "dev"),
+    "siReact": ("react", "dev"),
+    "siVuedotjs": ("vue", "dev"),
+    "siSvelte": ("svelte", "dev"),
+    "siNextdotjs": ("nextjs", "dev"),
+    "siNodedotjs": ("nodejs", "dev"),
+    "siDeno": ("deno", "dev"),
+    "siSwift": ("swift", "dev"),
+    "siKotlin": ("kotlin", "dev"),
+    "siCplusplus": ("cplusplus", "dev"),
+    "siRuby": ("ruby", "dev"),
+    "siPhp": ("php", "dev"),
+    "siElixir": ("elixir", "dev"),
+    "siZig": ("zig", "dev"),
+    # Platforms (AWS/Azure/Heroku removed from SI v16 — trademark)
+    "siPypi": ("pypi", "platforms"),
+    "siHuggingface": ("huggingface", "platforms"),
+    "siArxiv": ("arxiv", "platforms"),
+    "siKaggle": ("kaggle", "platforms"),
+    "siVercel": ("vercel", "platforms"),
+    "siNetlify": ("netlify", "platforms"),
+    "siCloudflare": ("cloudflare", "platforms"),
+    "siGooglecloud": ("googlecloud", "platforms"),
+    "siDigitalocean": ("digitalocean", "platforms"),
+    "siSupabase": ("supabase", "platforms"),
+    "siFirebase": ("firebase", "platforms"),
+    "siGithubactions": ("githubactions", "platforms"),
+    "siGitlab": ("gitlab", "platforms"),
+    "siBitbucket": ("bitbucket", "platforms"),
+    # Tools (VS Code removed from SI v16 — trademark)
+    "siNeovim": ("neovim", "tools"),
+    "siFigma": ("figma", "tools"),
+    "siNotion": ("notion", "tools"),
+    "siObsidian": ("obsidian", "tools"),
+    "siLinear": ("linear", "tools"),
+    "siPostman": ("postman", "tools"),
+    "siGrafana": ("grafana", "tools"),
+    "siPrometheus": ("prometheus", "tools"),
+    "siJetbrains": ("jetbrains", "tools"),
+    "siSublimetext": ("sublimetext", "tools"),
+    "siStorybook": ("storybook", "tools"),
+    "siEslint": ("eslint", "tools"),
+    "siPrettier": ("prettier", "tools"),
+    # AI / ML (OpenAI removed from SI v16 — trademark)
+    "siAnthropic": ("anthropic", "ai"),
+    "siTensorflow": ("tensorflow", "ai"),
+    "siPytorch": ("pytorch", "ai"),
+    "siJupyter": ("jupyter", "ai"),
+    "siApachespark": ("spark", "ai"),
+    "siGithubcopilot": ("githubcopilot", "ai"),
+    # Infrastructure (AWS/Azure/Heroku removed from SI v16 — trademark)
+    "siKubernetes": ("kubernetes", "infra"),
+    "siTerraform": ("terraform", "infra"),
+    "siNginx": ("nginx", "infra"),
+    "siRedis": ("redis", "infra"),
+    "siPostgresql": ("postgresql", "infra"),
+    "siMongodb": ("mongodb", "infra"),
+    "siElasticsearch": ("elasticsearch", "infra"),
+    "siApachekafka": ("kafka", "infra"),
+    "siRabbitmq": ("rabbitmq", "infra"),
+    "siGnubash": ("bash", "infra"),
+    "siGit": ("git", "infra"),
+    # Web / Frameworks
+    "siTailwindcss": ("tailwindcss", "dev"),
+    "siVite": ("vite", "dev"),
+    "siBun": ("bun", "dev"),
+    "siPnpm": ("pnpm", "dev"),
+    "siAstro": ("astro", "dev"),
+    "siRemix": ("remix", "dev"),
+    "siFlutter": ("flutter", "dev"),
+    "siDart": ("dart", "dev"),
+    "siHtml5": ("html5", "dev"),
+    "siSass": ("sass", "dev"),
+    "siMarkdown": ("markdown", "dev"),
+    # Mobile / OS
+    "siAndroid": ("android", "platforms"),
+    "siApple": ("apple", "platforms"),
+    "siLinux": ("linux", "platforms"),
+    # Commerce / Services
+    "siStripe": ("stripe", "platforms"),
+    "siShopify": ("shopify", "platforms"),
+    "siAuth0": ("auth0", "platforms"),
+}
+
+# Geometric shapes (hand-authored, not from Simple Icons)
+# Defined in 640x640 viewBox per PRD SS10
+GEOMETRIC_SHAPES: dict[str, dict[str, str | None]] = {
+    "triangle": {
+        "path": "M320 53.3 586.6 533.3H53.4Z",
+        "viewBox": "0 0 640 640",
+        "brand_color": None,
+        "category": "geometric",
+    },
+    "diamond": {
+        "path": "M320 53.3 506.7 320 320 586.7 133.3 320Z",
+        "viewBox": "0 0 640 640",
+        "brand_color": None,
+        "category": "geometric",
+    },
+    "hexagon": {
+        "path": "M320 53.3 566.4 186.7V453.3L320 586.7 73.6 453.3V186.7Z",
+        "viewBox": "0 0 640 640",
+        "brand_color": None,
+        "category": "geometric",
+    },
+    "shield": {
+        "path": "M320 53.3 533.3 186.7V373.3C533.3 480 320 586.7 320 586.7S106.7 480 106.7 373.3V186.7Z",
+        "viewBox": "0 0 640 640",
+        "brand_color": None,
+        "category": "geometric",
+    },
+    "circle": {
+        "path": "M320 106.7A213.3 213.3 0 11106.7 320 213.3 213.3 0 01320 106.7Z",
+        "viewBox": "0 0 640 640",
+        "brand_color": None,
+        "category": "geometric",
+    },
+    "star": {
+        "path": (
+            "M320 53.3 396.4 237.8 586.7 253.3 440 381.5 483.3 566.7"
+            " 320 471.1 156.7 566.7 200 381.5 53.3 253.3 243.6 237.8Z"
+        ),
+        "viewBox": "0 0 640 640",
+        "brand_color": None,
+        "category": "geometric",
+    },
+}
+
+
+def extract_from_npm() -> dict[str, dict[str, object]]:
+    """Extract icons from the simple-icons npm package via Node.js subprocess.
+
+    Uses `node -e` to require simple-icons, extract all curated paths,
+    and return JSON to stdout. This avoids parsing JS manually.
+    """
+    # Build the Node.js extraction script
+    icon_keys = list(CURATED_ICONS.keys())
+    icon_keys_json = json.dumps(icon_keys)
+    slugs_json = json.dumps({k: v[0] for k, v in CURATED_ICONS.items()})
+    cats_json = json.dumps({k: v[1] for k, v in CURATED_ICONS.items()})
+
+    node_script = f"""
+    const si = require('simple-icons');
+    const keys = {icon_keys_json};
+    const slugs = {slugs_json};
+    const cats = {cats_json};
+    const result = {{}};
+    for (const key of keys) {{
+        const icon = si[key];
+        if (!icon) {{
+            process.stderr.write('WARN: ' + key + ' not found in simple-icons\\n');
+            continue;
+        }}
+        result[slugs[key]] = {{
+            path: icon.path,
+            viewBox: '0 0 24 24',
+            brand_color: '#' + icon.hex,
+            category: cats[key],
+        }};
+    }}
+    process.stdout.write(JSON.stringify(result));
+    """
+
+    try:
+        proc = subprocess.run(
+            ["node", "-e", node_script],
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        if proc.returncode != 0:
+            print(f"Node.js extraction failed: {proc.stderr}", file=sys.stderr)
+            return {}
+        if proc.stderr:
+            # Print warnings (missing icons)
+            for line in proc.stderr.strip().splitlines():
+                print(line, file=sys.stderr)
+
+        return json.loads(proc.stdout)
+
+    except FileNotFoundError:
+        print("Node.js not found. Install Node.js to extract Simple Icons.", file=sys.stderr)
+        return {}
+    except subprocess.TimeoutExpired:
+        print("Node.js extraction timed out.", file=sys.stderr)
+        return {}
+    except json.JSONDecodeError as e:
+        print(f"Invalid JSON from Node.js: {e}", file=sys.stderr)
+        return {}
+
+
+def main() -> None:
+    """Run glyph extraction and write data/glyphs.json."""
+    output_path = Path(__file__).resolve().parent.parent / "src" / "hyperweave" / "data" / "glyphs.json"
+
+    # Extract from npm (via Node subprocess)
+    glyphs = extract_from_npm()
+
+    if not glyphs:
+        print("No SI icons extracted. Check that simple-icons is installed.", file=sys.stderr)
+        print("Run: npm install simple-icons", file=sys.stderr)
+        sys.exit(1)
+
+    # Add geometric shapes (always)
+    for glyph_id, definition in GEOMETRIC_SHAPES.items():
+        glyphs[glyph_id] = definition  # type: ignore[assignment]
+
+    # Sort by category then name for readability
+    sorted_glyphs = dict(
+        sorted(
+            glyphs.items(),
+            key=lambda x: (x[1].get("category", "zzz"), x[0]),
+        )
+    )
+
+    # Write output
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+    with output_path.open("w", encoding="utf-8") as f:
+        json.dump(sorted_glyphs, f, indent=2)
+        f.write("\n")
+
+    # Summary
+    by_cat: dict[str, int] = {}
+    for v in sorted_glyphs.values():
+        cat = v.get("category", "unknown")
+        by_cat[cat] = by_cat.get(cat, 0) + 1
+
+    print(f"Wrote {len(sorted_glyphs)} glyphs to {output_path}")
+    for cat, count in sorted(by_cat.items()):
+        print(f"  {cat}: {count}")
+
+
+if __name__ == "__main__":
+    main()

hyperweave-0.2.2/scripts/generate_hw_compliant.py

@@ -0,0 +1,327 @@
+#!/usr/bin/env python3
+"""Generate HW-compliant versions of all specimen SVGs.
+
+For each specimen SVG in specs/components/ and specs/motion/:
+  1. Do NOT modify originals
+  2. Create hw-compliant/ subfolder within each specimen's directory
+  3. Regenerate with full HyperWeave v8.0 protocol scaffolding
+  4. ZERO visual changes
+
+Usage:
+    python3 scripts/generate_hw_compliant.py
+"""
+
+from __future__ import annotations
+
+import re
+import uuid
+from datetime import UTC, datetime
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+SPECS = ROOT / "specs"
+
+
+def _has_hw_metadata(svg: str) -> bool:
+    """Check if SVG already has HW protocol metadata."""
+    return "hw:artifact" in svg and "xmlns:hw" in svg and 'role="img"' in svg
+
+
+def _has_reduced_motion(svg: str) -> bool:
+    return "prefers-reduced-motion" in svg
+
+
+def _has_color_scheme(svg: str) -> bool:
+    return "prefers-color-scheme" in svg
+
+
+def _extract_viewbox(svg: str) -> str:
+    m = re.search(r'viewBox="([^"]+)"', svg, re.IGNORECASE)
+    return m.group(1) if m else "0 0 800 220"
+
+
+def _extract_dims(svg: str) -> tuple[str, str]:
+    """Extract width/height from SVG, preserving original values exactly."""
+    w = re.search(r'width="([^"]+)"', svg)
+    h = re.search(r'height="([^"]+)"', svg)
+    return (w.group(1) if w else "800", h.group(1) if h else "220")
+
+
+def _extract_svg_tag(svg: str) -> tuple[str, str]:
+    """Split into the opening <svg ...> tag and everything after."""
+    m = re.match(r"(<svg[^>]*>)(.*)", svg, re.DOTALL)
+    if m:
+        return m.group(1), m.group(2)
+    return "<svg>", svg
+
+
+def _augment_svg_tag(tag: str, attrs: dict[str, str]) -> str:
+    """Add attributes to an existing <svg ...> tag without replacing originals.
+
+    Preserves ALL original attributes (xmlns, viewBox, width, height, etc.).
+    Only ADDS attributes that don't already exist in the tag.
+    """
+    for key, val in attrs.items():
+        # Skip if attribute already exists
+        if f"{key}=" in tag or f"{key} =" in tag:
+            continue
+        # Insert before the closing >
+        tag = tag.rstrip(">").rstrip() + f'\n     {key}="{val}">'
+        # Fix: ensure single closing >
+        tag = tag.replace(">>", ">")
+    return tag
+
+
+def _infer_type(path: Path) -> str:
+    """Infer artifact type from directory structure."""
+    parts = str(path).lower()
+    if "divider" in parts:
+        return "divider"
+    if "icon" in parts:
+        return "icon"
+    if "banner" in parts or "holofoil" in parts:
+        return "banner"
+    if "marquee" in parts:
+        return "marquee"
+    if "border-frame" in parts:
+        return "motion-primitive"
+    if "kinetic-typography" in parts:
+        return "kinetic-typography"
+    return "specimen"
+
+
+def _infer_motion_id(path: Path) -> str:
+    """Infer motion ID from filename."""
+    name = path.stem.lower()
+    mapping = {
+        "002-chromatic-pulse": "chromatic-pulse",
+        "003-corner-trace": "corner-trace",
+        "004-dual-orbit": "dual-orbit",
+        "020-quantum-entanglement": "entanglement",
+        "rim-runners": "rimrun",
+        "banner_bars": "bars",
+        "banner_broadcast": "broadcast",
+        "banner_cascade": "cascade",
+        "banner_convergence": "converge",
+        "banner_drop": "drop",
+        "crash": "crash",
+        "chromatic_impact_physics": "impact",
+        "quantum_tunneling_breach": "breach",
+        "pulse": "pulse",
+        "z_axis_illusion_via_exponential_scale_blur_convergence": "collapse",
+    }
+    return mapping.get(name, name)
+
+
+def _slug(path: Path) -> str:
+    return path.stem.lower().replace(" ", "-").replace("_", "-")
+
+
+def _check_cim(svg: str) -> tuple[bool, str]:
+    """Check CIM compliance and return waiver if needed."""
+    non_cim_indicators = []
+    if "stop-color" in svg and "animate" in svg.lower():
+        non_cim_indicators.append("stop-color animation")
+    if "stroke-dashoffset" in svg and "animate" in svg.lower():
+        non_cim_indicators.append("stroke-dashoffset animation")
+    if "stroke-width" in svg and "<animate" in svg.lower() and "stroke-width" in svg.split("<animate")[1][:200]:
+        non_cim_indicators.append("stroke-width animation")
+    if "letter-spacing" in svg and "animate" in svg.lower():
+        non_cim_indicators.append("letter-spacing animation")
+    if "stdDeviation" in svg and "animate" in svg.lower():
+        non_cim_indicators.append("filter blur animation")
+    if "baseFrequency" in svg and "animate" in svg.lower():
+        non_cim_indicators.append("turbulence animation")
+    if "clip-path" in svg and "@keyframes" in svg:
+        non_cim_indicators.append("clip-path animation")
+    # Check for animated gradients
+    if re.search(r'<animate[^>]*attributeName="x[12]"', svg, re.IGNORECASE):
+        non_cim_indicators.append("gradient coordinate animation")
+
+    if non_cim_indicators:
+        return False, f"Non-CIM: {', '.join(non_cim_indicators)}"
+    return True, ""
+
+
+def wrap_specimen(src: Path) -> str:
+    """Wrap a raw specimen SVG with HW v8.0 protocol scaffolding.
+
+    CRITICAL: The original <svg> tag's xmlns, viewBox, width, height are
+    preserved EXACTLY. We only ADD new attributes (xmlns:hw, role,
+    aria-labelledby, data-hw-*). Never replace existing ones.
+    """
+    svg = src.read_text(encoding="utf-8").strip()
+
+    # Already compliant — add only missing layers
+    if _has_hw_metadata(svg):
+        if not _has_reduced_motion(svg):
+            svg = _inject_reduced_motion(svg)
+        if not _has_color_scheme(svg):
+            svg = _inject_color_scheme(svg)
+        return svg
+
+    # Raw specimen — full protocol wrap
+    artifact_id = str(uuid.uuid4())
+    uid = f"hw-{artifact_id[:8]}"
+    now = datetime.now(UTC).isoformat()
+    w, h = _extract_dims(svg)
+    art_type = _infer_type(src)
+    slug = _slug(src)
+    motion_id = _infer_motion_id(src) if "motion" in str(src) else "static"
+    cim_ok, cim_waiver = _check_cim(svg)
+
+    # Extract the original <svg ...> tag and inner content
+    svg_tag, inner = _extract_svg_tag(svg)
+    if inner.rstrip().endswith("</svg>"):
+        inner = inner.rstrip()[:-6]
+
+    # Augment the ORIGINAL tag — preserve xmlns, viewBox, width, height
+    augmented = _augment_svg_tag(
+        svg_tag,
+        {
+            "xmlns:hw": "https://hyperweave.dev/hw/v8.0",
+            "role": "img",
+            "aria-labelledby": f"{uid}-title {uid}-desc",
+            "data-hw-id": artifact_id,
+            "data-hw-frame": art_type,
+            "data-hw-chromatic": "adaptive",
+            "data-hw-motion": motion_id,
+        },
+    )
+
+    perf = "composite-only" if cim_ok else "paint-ok"
+    cim_str = "true" if cim_ok else "false"
+    tradeoffs = "CIM-compliant: uses only compositor-friendly properties." if cim_ok else f"CIM waiver: {cim_waiver}"
+
+    return f'''{augmented}
+
+  <title id="{uid}-title">{slug} -- HyperWeave Specimen</title>
+  <desc id="{uid}-desc">HW-compliant version of {src.name}. Type: {art_type}. Zero visual changes from original.</desc>
+
+  <metadata>
+    <hw:artifact id="{artifact_id}" type="{art_type}" series="specimens" version="1.0.0"
+                 xmlns:hw="https://hyperweave.dev/hw/v8.0">
+      <hw:provenance>
+        <hw:generator>HyperWeave Specimen Wrapper v0.1 (InnerAura Labs)</hw:generator>
+        <hw:created>{now}</hw:created>
+        <hw:human-directed>true</hw:human-directed>
+        <hw:source-file>{src.relative_to(ROOT)}</hw:source-file>
+      </hw:provenance>
+      <hw:spec size="{w}x{h}" performance="{perf}"
+               theme="adaptive" a11y="WCAG-AA"/>
+      <hw:composition>
+        <hw:frame>{art_type}</hw:frame>
+        <hw:environment motion="{motion_id}" status="active"/>
+      </hw:composition>
+      <hw:aesthetic>
+        <hw:motion vocabulary="{motion_id}" cim-compliant="{cim_str}"/>
+      </hw:aesthetic>
+      <hw:reasoning>
+        <hw:intent>Specimen artifact wrapped with HW v8.0 protocol for Layer 1 editorial publishing.</hw:intent>
+        <hw:approach>Zero-visual-change wrapping: original SVG preserved, HW metadata injected around it.</hw:approach>
+        <hw:tradeoffs>{tradeoffs}</hw:tradeoffs>
+      </hw:reasoning>
+    </hw:artifact>
+  </metadata>
+
+  <style>
+    @media (prefers-reduced-motion: reduce) {{
+      *, *::before, *::after {{
+        animation-duration: 0.01ms !important;
+        animation-iteration-count: 1 !important;
+        transition-duration: 0.01ms !important;
+      }}
+      animate, animateTransform, animateMotion, set {{
+        display: none !important;
+      }}
+    }}
+    @media (prefers-color-scheme: light) {{
+      svg {{ --hw-scheme: light; }}
+    }}
+    @media (prefers-color-scheme: dark) {{
+      svg {{ --hw-scheme: dark; }}
+    }}
+  </style>
+
+  <!-- Original specimen content (zero visual changes) -->
+  <g data-hw-zone="specimen-content">
+{_indent(inner, 4)}
+  </g>
+
+</svg>'''
+
+
+def _inject_reduced_motion(svg: str) -> str:
+    """Inject prefers-reduced-motion into existing compliant SVG."""
+    rm_block = """
+    @media (prefers-reduced-motion: reduce) {
+      *, *::before, *::after {
+        animation-duration: 0.01ms !important;
+        animation-iteration-count: 1 !important;
+        transition-duration: 0.01ms !important;
+      }
+      animate, animateTransform, animateMotion, set {
+        display: none !important;
+      }
+    }"""
+    # Try to inject into existing <style> block
+    if "<style>" in svg:
+        return svg.replace("<style>", f"<style>{rm_block}", 1)
+    # Or add before </svg>
+    return svg.replace("</svg>", f"<style>{rm_block}</style>\n</svg>")
+
+
+def _inject_color_scheme(svg: str) -> str:
+    """Inject prefers-color-scheme into existing compliant SVG."""
+    cs_block = """
+    @media (prefers-color-scheme: light) { svg { --hw-scheme: light; } }
+    @media (prefers-color-scheme: dark) { svg { --hw-scheme: dark; } }"""
+    if "</style>" in svg:
+        return svg.replace("</style>", f"{cs_block}\n</style>", 1)
+    return svg
+
+
+def _indent(text: str, spaces: int) -> str:
+    """Indent every line by N spaces."""
+    pad = " " * spaces
+    return "\n".join(f"{pad}{line}" if line.strip() else line for line in text.splitlines())
+
+
+def generate() -> None:
+    total = 0
+    dirs = [
+        SPECS / "components" / "dividers",
+        SPECS / "components" / "icons",
+        SPECS / "components" / "banners",
+        SPECS / "components" / "marquees",
+        SPECS / "motion" / "motion-border-frames",
+        SPECS / "motion" / "motion-kinetic-typography",
+    ]
+
+    for d in dirs:
+        if not d.exists():
+            continue
+        svgs = sorted(d.glob("*.svg"))
+        if not svgs:
+            continue
+
+        out_dir = d / "hw-compliant"
+        out_dir.mkdir(exist_ok=True)
+
+        for src in svgs:
+            wrapped = wrap_specimen(src)
+            out = out_dir / src.name
+            out.write_text(wrapped, encoding="utf-8")
+            total += 1
+
+            cim_ok, _ = _check_cim(wrapped)
+            already = _has_hw_metadata(src.read_text())
+            status = "copy" if already else "wrap"
+            cim_tag = "CIM" if cim_ok else "NON-CIM"
+            print(f"  [{status:4s}] [{cim_tag:7s}] {src.relative_to(ROOT)}")
+
+    print(f"\nWrote {total} hw-compliant specimens.")
+
+
+if __name__ == "__main__":
+    generate()