Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.
#!/usr/bin/env python3
"""Adversarial tests for the label geometry verifier (verify-geometry.py)."""
from __future__ import annotations
import importlib.util
import sys
import tempfile
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
VERIFIER = ROOT / "scripts/verify-geometry.py"
ASSET_DIR = ROOT / "skills/diagram-design/assets"
ARCHITECTURE = ASSET_DIR / "example-architecture.html"
SWIMLANE = ASSET_DIR / "example-swimlane.html"
ZONED = ASSET_DIR / "example-dp-integration.html"
SEQUENCE_OAUTH = ASSET_DIR / "example-sequence-oauth.html"
HIGH_LEVEL = ASSET_DIR / "example-high-level.html"
QUEUE_ANIMATED = ASSET_DIR / "example-queue-animated.html"
MEDALLION = ASSET_DIR / "example-medallion.html"
DB_SCHEMA = ASSET_DIR / "example-db-schema.html"
def load_verifier():
spec = importlib.util.spec_from_file_location("verify_geometry", VERIFIER)
assert spec is not None and spec.loader is not None
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
return module
SVG_HEAD = (
'<svg viewBox="0 0 400 200" xmlns="http://www.w3.org/2000/svg" role="img" '
'aria-labelledby="t-title t-desc">'
"<title id=\"t-title\">T</title><desc id=\"t-desc\">T.</desc>"
)
def document(body: str) -> str:
return f"<!DOCTYPE html><html><body>{SVG_HEAD}{body}</svg></body></html>"
def main() -> int:
module = load_verifier()
failures: list[str] = []
def check(label: str, source: str, expect_findings: int) -> None:
with tempfile.TemporaryDirectory() as scratch:
candidate = Path(scratch) / "candidate.html"
candidate.write_text(source, encoding="utf-8")
findings = module.check(candidate)
if len(findings) != expect_findings:
failures.append(
f"{label}: expected {expect_findings} finding(s), got "
f"{len(findings)}: {findings}"
)
else:
print(f"OK: {label}")
def check_message(label: str, source: str, expect_text: str) -> None:
with tempfile.TemporaryDirectory() as scratch:
candidate = Path(scratch) / "candidate.html"
candidate.write_text(source, encoding="utf-8")
findings = module.check(candidate)
if len(findings) != 1 or expect_text not in findings[0]:
failures.append(f"{label}: expected one finding naming {expect_text!r}, got {findings}")
else:
print(f"OK: {label}")
def check_file(label: str, path: Path, expect_findings: int) -> None:
findings = module.check(path)
if len(findings) != expect_findings:
failures.append(
f"{label}: expected {expect_findings} finding(s), got "
f"{len(findings)}: {findings}"
)
else:
print(f"OK: {label}")
node = '<rect x="100" y="60" width="160" height="64" rx="6" fill="#f5f5f5"/>'
badge = '<rect x="108" y="68" width="32" height="12" rx="2" fill="#f5f5f5"/>'
zone = '<rect x="80" y="40" width="240" height="120" rx="8" fill="#eee"/>'
# A label mask straddling a node declared later is the defect being caught.
check(
"mask clipped by a later node",
document('<rect x="240" y="80" width="48" height="12" rx="2" fill="#f5f5f5"/>' + node),
1,
)
check(
"single-quoted mask clipped by a single-quoted node",
document("<rect x='240' y='80' width='48' height='12' fill='#f5f5f5'/>"
"<rect x='100' y='60' width='160' height='64' fill='#eee'/>"),
1,
)
check(
"attribute-like text inside a value does not replace real coordinates",
document("<rect data-note=\"x='10' y='10'\" x='240' y='80' width='48' height='12' fill='#fff'/>"
+ node),
1,
)
# Same geometry, but the node is painted first, so the label stays on top.
check(
"mask over an earlier node is legal",
document(node + '<rect x="240" y="80" width="48" height="12" rx="2" fill="#f5f5f5"/>'),
0,
)
# A badge chip fully inside its own node is legal regardless of order.
check("badge chip inside a node", document(badge + node), 0)
# A zone eyebrow overlaps the zone container, which is painted first.
check(
"zone eyebrow on a zone container",
document(zone + '<rect x="160" y="34" width="60" height="12" rx="2" fill="#f5f5f5"/>'),
0,
)
# A mask entirely in open canvas is legal.
check(
"mask clear of every node",
document('<rect x="10" y="10" width="48" height="12" rx="2" fill="#f5f5f5"/>' + node),
0,
)
# Touching within the 1px tolerance is not a finding.
check(
"mask abutting a node edge",
document('<rect x="52" y="80" width="48" height="12" rx="2" fill="#f5f5f5"/>' + node),
0,
)
# Snapshot panels use their own local coordinates, but masking happens in
# the shared canvas after enclosing and per-element translations.
mask = '<rect x="50" y="80" width="80" height="12" fill="#fff"/>'
panel_node = '<rect x="100" y="70" width="100" height="60" fill="#eee"/>'
check("translated panels keep clear masks separate", document(
mask + '<g transform="translate(300 0)">' + panel_node + '</g>'), 0)
translated_mask = '<rect x="350" y="80" width="80" height="12" fill="#fff"/>'
check("translated mask is clipped in canvas space", document(
'<g transform="translate(-200 0)">' + translated_mask + '</g>' + panel_node), 1)
check("single-quoted group translation is applied", document(
"<g transform='translate(-200 0)'>" + translated_mask + '</g>' + panel_node), 1)
check("nested translations accumulate", document(
'<g transform="translate(-100 0)"><g transform="translate(-100 0)">'
+ translated_mask + '</g></g>' + panel_node), 1)
check("element translation joins group translation", document(
'<g transform="translate(-100 0)">'
+ translated_mask.replace('<rect ', '<rect transform="translate(-100 0)" ')
+ '</g>' + panel_node), 1)
check("translated earlier node remains legal", document(
panel_node + '<g transform="translate(-200 0)">' + translated_mask + '</g>'), 0)
check("translated contained badge remains legal", document(
'<g transform="translate(300 0)">' + badge + node + '</g>'), 0)
# Definitions are reusable geometry, not paint at their local coordinates.
mask = '<rect x="50" y="80" width="80" height="12" fill="#fff"/>'
prototype = '<rect x="100" y="70" width="100" height="60" fill="#eee" stroke="#000"/>'
check("unpainted reusable node cannot clip a mask", document(mask
+ '<defs><g id="prototype">' + prototype + '</g></defs>'
+ '<use href="#prototype" x="300"/>'), 0)
for container in ("symbol", "marker", "pattern", "clipPath", "mask"):
check(f"{container} definition is not a painted node", document(mask
+ f'<{container} id="definition">' + prototype + f'</{container}>'), 0)
check("painted rectangle after definitions is still checked", document(mask
+ '<defs><g id="prototype">' + prototype + '</g></defs>' + prototype), 1)
check("commented definition opening cannot hide painted nodes", document(mask
+ '<!-- Reusable shapes can be placed under <defs>. -->' + prototype), 1)
check("commented definition close cannot expose prototypes", document(mask
+ '<defs><!-- Close this section with </defs>. -->' + prototype + '</defs>'), 0)
check("commented definition wrapper cannot alter paint custody", document(mask
+ '<!-- <defs><g>prototype</g></defs> -->' + prototype), 1)
check("ordinary painted group is still checked", document(mask + '<g>' + prototype + '</g>'), 1)
check("self-closing definitions do not hide following paint", document(mask + '<defs/>' + prototype), 1)
for quote in ('"', "'"):
for container in ("defs", "symbol", "marker", "pattern", "clipPath", "mask"):
quoted = f"<{container} data-note={quote}a > b{quote}/>"
check(f"quoted {container} self-close cannot hide following node ({quote})",
document(mask + quoted + prototype), 1)
check(f"quoted definition attribute keeps prototypes unpainted ({quote})",
document(mask + f"<defs data-note={quote}a > b{quote}>" + prototype + '</defs>'), 0)
check(f"quoted painted group preserves following connector ({quote})", document(
f"<g data-note={quote}a > b{quote}/>"
+ '<path d="M 10 10 L 60 40" stroke="#000" marker-end="url(#arrow)"/>'), 1)
check("nested definition containers keep prototypes unpainted", document(mask
+ '<defs><symbol id="prototype">' + prototype + '</symbol></defs>'), 0)
check("painted group after nested definitions is still checked", document(mask
+ '<defs><symbol id="prototype">' + prototype + '</symbol></defs><g>'
+ prototype + '</g>'), 1)
check("connector prototypes are not painted arrows", document(
'<defs><path d="M 10 10 L 60 40" stroke="#000" marker-end="url(#arrow)"/></defs>'), 0)
# A long mono plate (128px, as shipped in example-sequence-oauth.html) or a
# wide CJK label plate must be recognized as a mask and checked like any other.
check(
"wide mono mask clipped by a later node",
document('<rect x="180" y="80" width="128" height="12" rx="2" fill="#f5f5f5"/>' + node),
1,
)
check(
"wide mono mask over an earlier node is legal",
document(node + '<rect x="180" y="80" width="128" height="12" rx="2" fill="#f5f5f5"/>'),
0,
)
# Wide-but-tall rects are container header bars or row stripes, not masks —
# the height cap stays at 14 so they are never reported.
check(
"container header bar is not a mask",
document('<rect x="80" y="80" width="188" height="16" rx="2" fill="#eee"/>' + node),
0,
)
# Connector routing. A stroked node; arrows carry a marker to count.
stroked = '<rect x="100" y="60" width="160" height="64" rx="6" fill="#fff" stroke="#2d3142"/>'
arrow = 'fill="none" stroke="#4f5d75" marker-end="url(#arrow)"'
# The reported defect: leave the top edge, then run flat along the border,
# so the arrow appears to grow out of the top-right corner.
check(
"connector riding a node's top border",
document(f'<path d="M 180,60 H 332 Q 340,60 340,52 V 20" {arrow}/>' + stroked),
1,
)
check(
"connector leaving the side edge at its own port",
document(f'<path d="M 260,84 H 332 Q 340,84 340,76 V 20" {arrow}/>' + stroked),
0,
)
check(
"diagonal connector",
document(f'<line x1="10" y1="10" x2="60" y2="40" {arrow}/>'),
1,
)
check(
"single-quoted diagonal connector",
document("<line x1='10' y1='10' x2='60' y2='40' "
"stroke='#4f5d75' marker-end='url(#arrow)'/>"),
1,
)
check(
"diagonal connector with adjacent attributes",
document(f'<line x1="10" y1="10"x2="60" y2="40" {arrow}/>'),
1,
)
check(
"diagonal connector with slash between attributes",
document(f'<line x1="10" y1="10"/x2="60" y2="40" {arrow}/>'),
1,
)
check(
"attribute-like coordinates inside an unusual name are ignored",
document(f'<line @click=" x1=\'10\' y1=\'10\' x2=\'60\' y2=\'10\'" '
f'x1="10" y1="10" x2="60" y2="40" {arrow}/>'),
1,
)
check(
"single-quoted arrowed path",
document("<path d='M 10 10 L 60 40' stroke='#4f5d75' marker-end='url(#arrow)'/>"),
1,
)
check(
"diagonal line without a marker is not a connector",
document('<line x1="10" y1="10" x2="60" y2="40" stroke="#4f5d75"/>'),
0,
)
# Loop write-back spokes are the documented radial exception.
check(
"loop spoke is exempt from the diagonal rule",
document(f'<path class="spoke" d="M 10 10 L 60 40" {arrow}/>'),
0,
)
check(
"connector landing on a node corner",
document(f'<line x1="40" y1="60" x2="100" y2="60" {arrow}/>' + stroked),
1,
)
# A fork shares the port and stacks its first 20px: both rules fire.
check(
"two connectors forking from one port",
document(
f'<path d="M 260,84 H 300" {arrow}/>'
f'<path d="M 260,84 H 280 Q 288,84 288,92 V 120" {arrow}/>' + stroked
),
2,
)
# One arrow lands where the next leaves: a chain the reader follows in order.
check(
"head-to-tail chain joint is legal",
document(
f'<path d="M 60,60 C 60,0 180,0 180,60" {arrow}/>'
f'<path d="M 180,60 C 180,0 300,0 300,60" {arrow}/>' + stroked
),
0,
)
# Identical local geometry in two translated panels must not collide.
panel = f'<path d="M 260,84 H 300" {arrow}/>' + stroked
check(
"translated panels are compared in canvas space",
document(f'<g transform="translate(0 0)">{panel}</g><g transform="translate(400 0)">{panel}</g>'),
0,
)
# An arrowed axis along an unstroked quadrant fill is not a border ride.
check(
"unstroked fill rect is not a node",
document(
'<rect x="100" y="60" width="160" height="64" fill="rgba(191,69,32,0.04)"/>'
f'<line x1="100" y1="40" x2="100" y2="200" {arrow}/>'
),
0,
)
# Compact arc flags (`0120 20` = flags 0 and 1, then 20 20) must parse, so a
# diagonal after the arc is still found rather than the path being dropped.
check_message(
"diagonal after a compact-flag arc is found",
document(f'<path d="M 20,20 A 8 8 0 0128 28 L 60 60" {arrow}/>'),
"diagonal segment",
)
check_message(
"unparseable arrowed path fails closed",
document(f'<path d="M 10 10 L 20" {arrow}/>'),
"cannot parse",
)
# Rule 4: 12px between ports on a normal edge, 8px on a very small box.
check(
"ports 10px apart on a 64px edge",
document(
f'<path d="M 260,80 H 300" {arrow}/><path d="M 260,90 H 280 Q 288,90 288,98 V 140" {arrow}/>'
+ stroked
),
1,
)
check(
"ports 10px apart on a 40px edge",
document(
f'<path d="M 260,72 H 300" {arrow}/><path d="M 260,82 H 280 Q 288,82 288,90 V 140" {arrow}/>'
'<rect x="100" y="60" width="160" height="40" rx="6" fill="#fff" stroke="#2d3142"/>'
),
0,
)
# Rule 3: two sources sharing one trunk stack their strokes.
check(
"two connectors stacked on one trunk",
document(
f'<path d="M 20,200 H 52 Q 60,200 60,192 V 100" {arrow}/>'
f'<path d="M 20,240 H 52 Q 60,240 60,232 V 120" {arrow}/>'
),
1,
)
# Shared curved run with separate straight runs: only curve sampling sees it.
check_message(
"two connectors sharing a curved run",
document(
f'<path d="M 10,100 Q 50,100 50,60 H 90" {arrow}/>'
f'<path d="M 10,110 V 100 Q 50,100 50,60 V 20" {arrow}/>'
),
"runs on top of",
)
# Two connectors that only cross at a right angle are not stacked.
check(
"perpendicular crossing is not a stacked run",
document(f'<path d="M 10,50 H 90" {arrow}/><path d="M 50,10 V 90" {arrow}/>'),
0,
)
# Two separate right-angle crossings touch briefly twice; they must not add
# up to a shared run.
check(
"two separate crossings are not a stacked run",
document(f'<path d="M 10,50 H 90" {arrow}/><path d="M 30,10 V 90 H 70 V 10" {arrow}/>'),
0,
)
# A fork away from any node shares a short stroke from one start point;
# only head-to-tail joints are exempt, so it is measured from that point.
check_message(
"short fork from a shared start with no node",
document(f'<path d="M 10,50 H 16 V 10" {arrow}/><path d="M 10,50 H 16 V 90" {arrow}/>'),
"runs on top of",
)
# Coordinates under a rotate are not canvas space; skip rather than misjudge.
check(
"connector under a non-translate transform is skipped",
document(f'<g transform="rotate(45)"><line x1="10" y1="10" x2="60" y2="40" {arrow}/></g>'),
0,
)
check_file("shipped architecture example", ARCHITECTURE, 0)
check_file("shipped swimlane example", SWIMLANE, 0)
check_file("shipped high-level example", HIGH_LEVEL, 0)
check_file("shipped queue animation", QUEUE_ANIMATED, 0)
# Medallion's promotion arcs meet head to tail at each tier; that joint stays legal.
check_file("shipped medallion chain joints", MEDALLION, 0)
check_file("shipped db-schema example", DB_SCHEMA, 0)
check_file("shipped zoned example", ZONED, 0)
check_file("shipped sequence-oauth example", SEQUENCE_OAUTH, 0)
if failures:
print("\nFAILURES:")
for failure in failures:
print(f" - {failure}")
return 1
print("All label geometry tests passed.")
return 0
if __name__ == "__main__":
sys.exit(main())