quon-2d-typst-graphs

name	quon-2d-typst-graphs
description	Use when plotting 2D Quon-language diagrams in Typst/CeTZ, especially dot-based basis encoders, Majorana dot rules, planar tensor operations, Clifford/matchgate generator sketches, or arXiv:2505.06336-style demos.

2D Quon Typst Graphs

Overview

Use this skill to draw 2D Quon diagrams in Typst. The public library is lib.typ; it wraps the internal assets/quon2d.typ CeTZ module for the paper's Table I Majorana dictionary and compatibility helpers for dot-based tensor-leg notation from arXiv:2505.06336.

Quick Start

#import "skills/quon-2d-typst-graphs/lib.typ": *

#qtd-table-identity()
#qtd-table-majorana()
#qtd-table-positive-braid()

Follow reports/quon-2d-typst-demo.typ for a complete report. Compile scripts/harness.typ through scripts/build-harness.py for a minimal check of the public plotting library.

Diagram Families

• Table I Majorana dictionary: qtd-table-identity, qtd-table-majorana, qtd-table-parity, qtd-table-global-parity, qtd-table-ket-vac, qtd-table-ket-state, qtd-table-bra-vac, qtd-table-bra-state, qtd-table-pair-creation, qtd-table-pair-annihilation, qtd-table-positive-braid, qtd-table-negative-braid, qtd-table-scattering
• basis encoders: qtd-basis-encoder, qtd-basis-dictionary
• Majorana dot rules: qtd-majorana-dot-dictionary, qtd-pair-dots-to-braid, qtd-time-direction-dots
• elementary tensors: qtd-one-leg-zero, qtd-two-leg-identity, qtd-two-leg-x, qtd-two-leg-z-rotation, qtd-parity-tensor
• planar tensor operations: qtd-planar-tensor, qtd-leg-bending, qtd-tensor-contraction
• matchgate topology: qtd-punctured-matchgate
• noisy-circuit sketches: qtd-noisy-circuit-slice, qtd-syndrome-extraction, qtd-repetition-code-timeline, qtd-surface-code-patch
• VGQEC paper-exact figures from arXiv:2410.02608v2: qtd-paper-vgqec-overview, qtd-paper-five-qubit-encoding-circuit
• VGQEC code tutorials: qtd-quon-basis-primer, qtd-quon-crossing-primer, qtd-three-qubit-repetition-graph, qtd-three-qubit-charged-graph, qtd-three-qubit-cycle-stabilizer, qtd-three-qubit-vgqec-graph, qtd-five-qubit-code-graph, qtd-five-qubit-cycle-l-one, qtd-five-qubit-vgqec-graph, qtd-five-qubit-encoding-circuit

Source Cues

The companion LaTeX skill quon-2d-latex-graphs contains references/2d-dot-notation.md. Use the same semantic conventions in Typst:

• Table I dictionary glyphs use sparse black worldlines, dots, caps, cups, crossings, labels, and no colored manifold frame.
• Full 2D examples can use blue manifold boundary, pale planar region, gray tensor legs;
• thin black Majorana worldlines, red boundary-tracking worldlines;
• filled dots for Majorana actions and open placeholder dots when showing the two basis cases side by side;
• explicit time-arrow cues whenever dots affect the scalar convention.

Layout Rules

• Keep Typst output vector-first: deliver the PDF, and render inspection PNGs at 300 DPI or higher.
• For paper-faithful VGQEC code graphs, screen against the LaTeX/TikZ reference before changing aesthetics. The physical-qubit discs use the TikZ node scale, roughly 0.31cm radius at a 10mm CeTZ canvas unit.
• Draw graph interiors first and draw the white blue-outlined qubit discs afterward. TikZ clips edges to node boundaries; drawing discs last is the Typst/CeTZ way to avoid black lines crossing node labels.
• When matching TikZ to[out=..., in=...] curves, prefer boundary-clipped Bezier coordinates extracted from the LaTeX render over eyeballed center-to-center curves. After tuning, check that black dots and open circles still sit on the intended edge or crossing.
• Table I glyphs need reserved label zones. Scalars such as $2^{-n/4}$, occupancy labels such as $p_1$, and strand labels such as $j+1$ must not touch caps, cups, dots, table borders, or each other.
• Prefer larger canvas defaults and wider diagram columns over shrinking text. If a cell is cramped, widen the table/page or split the demo rather than accepting overlap.
• After any coordinate change, compile and inspect a high-resolution raster preview before claiming the table is readable.
• For noisy-circuit and QEC tutorials, black strands are Majorana worldlines, red marks are faults or error histories, blue open circles are syndrome defects, and gray boxes/dashed bands are checks or measurement slices.
• Match the LaTeX tutorial before polishing Typst aesthetics. If Typst compresses labels such as 2n-1, j+1, s_2, or data Majoranas, widen the canvas/page or move the label into reserved whitespace.
• For VGQEC tutorials based on arXiv:2410.02608v2 and 42005_2026_2681_MOESM1_ESM.pdf, use the paper source vocabulary: blue physical-qubit discs, short blue start marks, black charges, orange stabilizer cycles, red variable-crossing parameters, and formulas beside the graphs.
• Use qtd-paper-vgqec-overview and qtd-paper-five-qubit-encoding-circuit when exact paper fidelity is required. The source archive ships those plots as vector PDFs, so the Typst skill includes the same assets.
• Keep formulas out of dense CeTZ graph canvases; put them beside or below the graph in Typst prose. This avoids the label overlap that happens when long equations are forced into small canvases.
• Do not draw syndrome extraction as many unlabeled red strands fanning into an ancilla. In Typst this almost always reads as accidental overplotting rather than an explanation.

Validation

python3 skills/quon-2d-typst-graphs/scripts/check-2d-typst-plotting.py
python3 skills/quon-2d-typst-graphs/scripts/build-harness.py
ion --json --pretty validate skills/quon-2d-typst-graphs
/private/tmp/typst-0.14.2/typst-aarch64-apple-darwin/typst compile --root . reports/quon-2d-typst-demo.typ reports/quon-2d-typst-demo.pdf
/private/tmp/typst-0.14.2/typst-aarch64-apple-darwin/typst compile --root . reports/quon-2d-noisy-qec-typst-tutorial.typ reports/quon-2d-noisy-qec-typst-tutorial.pdf
/private/tmp/typst-0.14.2/typst-aarch64-apple-darwin/typst compile --root . reports/quon-2d-plot-comparison-typst.typ reports/quon-2d-plot-comparison-typst.pdf
gs -dSAFER -dBATCH -dNOPAUSE -sDEVICE=png16m -r300 -sOutputFile=/private/tmp/quon-2d-typst-demo-page-%d.png reports/quon-2d-typst-demo.pdf
gs -dSAFER -dBATCH -dNOPAUSE -sDEVICE=png16m -r300 -sOutputFile=/private/tmp/quon-2d-noisy-qec-typst-page-%d.png reports/quon-2d-noisy-qec-typst-tutorial.pdf
gs -dSAFER -dBATCH -dNOPAUSE -sDEVICE=png16m -r300 -sOutputFile=/private/tmp/quon-2d-plot-comparison-typst-page-%d.png reports/quon-2d-plot-comparison-typst.pdf

These macros are schematic plotters, not a symbolic Quon evaluator.