ZPE-Diagram

Package Install

Installable package: python3.11 -m pip install zpe-diagram. Current release: 0.1.0 on PyPI. Source: Zer0pa/ZPE-Diagram.

python3.11 -m pip install zpe-diagram

For full install, smoke, source, and developer commands, click here.

---

00 · ZPE-DIAGRAM · GRAPH-STRUCTURE RESEARCH-READY · PYPI CONNECTED Encoding the Grammar of Diagrams Bounded structural diagram codec · ZPE-Diagram · PyPI zpe-diagram v0.1.0 · github.com/Zer0pa/ZPE-Diagram Most diagram exports flatten a structured drawing into a picture. Six declared synthetic SVGs round-trip through ZPE-Diagram as explicit graph state — geometry, color, stroke width, and draw order all exact. Three out-of-scope probes — fills, dashed strokes, palette escapes — are refused at the door instead of silently approximated. This is not compression and not a general SVG renderer. It is a bounded codec that keeps the rules that make a diagram readable as a diagram.

Scope: bounded synthetic SVG grammar. Structure, style, and order round-trip; general SVG rendering is outside scope.

01 · THE GAP LOST IN EXPORT A diagram exported as an image loses the grammar that made it a diagram.

02 · MARKETS WEDGE MAP Diagramming software $1.9B Graphic design software $85.5B Technical documentation tooling $4.8B Standards-body technical drawing $0.8B Document archival software $7.3B Diagramming and adjacent archival categories · the wedge is line-based technical drawings, not the whole graphic design market.

03 · VALUE OF MARKET $1.9B 2030 Diagramming software by 2030; ZPE-Diagram keeps line-based drawings readable as drawings after export.

04 · INSIGHT A diagram's grammar is the draw order, not the pixels.

05.1 · CURRENT TECH PIXELS ONLY Standard diagram exports preserve appearance, not intent. The file shows lines in roughly the right place while losing the structural roles, the connection types, and the order in which a person actually built the drawing.

05.2 · OUR TECH KEEP THE GRAMMAR ZPE-Diagram keeps the grammar. On six declared synthetic line-based SVGs, geometry, a frozen eight-color palette, quantized stroke width, and draw order all round-trip exactly. Three out-of-scope probes — fills, dashed strokes, palette escapes — are rejected at encode time rather than silently coerced into something they are not.

05.3 · BENCHMARKS VALIDATION Cases6SVGs Structure1.000exact Style1.000exact Order1.000exact structure 1.000 style 1.000 reject 3 / 3 Source: bounded_style_validation.json · 6/6 in-scope at 1.000 · 3/3 out-of-scope refused.

06 · MEASUREMENT BOUNDED VALIDATION Six in-scope cases verified; three out-of-scope probes refused at encode.

06.1 · BOUNDED VALIDATION SYNTHETIC SVG FIXTURES Structure 1.000 Style (color + stroke) 1.000 Draw order 1.000 Out-of-scope reject 3 / 3 Six declared synthetic SVGs (triangle ×2, square, parallel bars ×2, T-mixed) plus three reject probes (fill, dash, palette escape). Source: validation/results/bounded_style_validation.json. No comparator codec evaluated.

07 · KEY METRICS BOUNDED STRUCTURAL CODEC

07.1 · STRUCTURAL FIDELITY 6/ 6 Synthetic cases · structure, style, draw-order all exact

07.2 · OUT-OF-SCOPE REJECT 3/ 3 Probes refused · fill · dash · palette escape

07.3 · RELEASE v0.1.0 PyPI connected · zpe-diagram 0.1.0

07.4 · CHECKED PACKET VERIFIED Public validation packet · bounded synthetic scope

07.5 · COMPRESSION CLAIM none Not a compression codec · structure preserved, not file size

08 · DETERMINISM COMMITTED FIXTURES Committed fixtures. Same bounded metrics.

08.1 · WHAT DETERMINISTIC MEANS FIXTURES + REJECTS Grammar here means something precise: the rules that make a drawing readable as a diagram rather than a pile of lines. Geometry encodes where elements sit. Style encodes how connections differ. Draw order encodes the sequence in which a person placed them. ZPE-Diagram keeps all three axes on committed fixtures and replays them byte-for-byte. On the bounded surface of six declared synthetic SVGs, structural, style, and draw-order fidelity each measure 1.000 — and the three out-of-scope probes never enter the packet.

08.2 · THE FIDELITY GAP Honest Blocker · No fill encode path. No dash encode path. No arbitrary SVG coverage. No compression claim. The current evidence is six synthetic fixtures plus three out-of-scope rejects. Real-world corpus closure, the is_diagram_header() boundary profile, and stroke-width normalization beyond the synthetic packet all remain open work.

09 DIAGRAMS WITH A RECEIPT.

09.1 · THE AMBITION The ambition is to make exported diagrams behave like the structured objects their authors meant them to be: archivable, comparable, searchable by structure rather than by pixel. A docs team, a standards committee, or an engineering archive should be able to trust that the drawing they store is the drawing they later retrieve.

09.2 · WHAT WORKS NOW Working today, on six declared synthetic SVGs: geometry, style, and draw order survive encoding exactly.

09.3 · WHAT'S STILL OPEN Still open: public corpora, header-boundary profile, and stroke-width handling outside the synthetic packet.

09.4 · DOCS · NEAR-TERM (12–24 MO) Docs teams keep diagram meaning A documentation team that exports a system diagram no longer ships a flat picture. The export carries node positions, line roles, and draw order, so the next writer can update the diagram instead of redrawing it from scratch.

09.5 · PIPELINES · NEAR-TERM (12–24 MO) Pipelines refuse the wrong input An archival pipeline that ingests diagrams now receives either a clean bounded object or a clear refusal. The operations team stops debugging silent visual corruption later and starts seeing rejection reasons at the moment of ingest.

09.6 · STANDARDS · MID-TERM (24–48 MO) Standards bodies archive structure, not screenshots ISO, IEEE, and ANSI technical drawing submissions can travel as structural objects with geometry, color, and draw order intact. A standards committee can compare two revisions of a wiring diagram or process flow without arguing about which export tool rendered it.

09.7 · DIFFS · MID-TERM (24–48 MO) Diagram review moves off pixel overlays Two versions of an architecture diagram become a structural diff: which boxes moved, which lines changed role, which elements were reordered. Reviewers stop squinting at overlaid screenshots and start reading change lists they can talk about in meetings.

09.8 · PROVENANCE · PARADIGM (48 MO+) Drawings acquire chain-of-custody A technical drawing in a regulatory submission, an engineering archive, or a patent filing can be proven identical or different across decades. Drawings stop being images and become governed structural objects that survive the people, vendors, and tools that produced them.

---

Install / Developer Commands Detailed

Package Install

Installable package: python3.11 -m pip install zpe-diagram. Current release: 0.1.0 on PyPI. Source: Zer0pa/ZPE-Diagram.

python3.11 -m pip install zpe-diagram

Import smoke:

python3.11 - <<'PY'
import importlib.metadata as md
import zpe_diagram

print("zpe-diagram", md.version("zpe-diagram"))
PY

Install success only proves package acquisition/import. Product scope, stale PyPI state, platform limits, and blockers remain in the front-door sections below.

Quick Start

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
python proofs/artifacts/reproduce_validation.py
python -m pytest tests/test_style_authority.py