Status: accepted. P5_061 extends the native schematic Plotter-IR document with local, global, and hierarchical labels, netclass flags, ordinary text, and text boxes. It preserves the P5_060 native-first boundary: there is no new WASM endpoint and no ambient project, worksheet, or font discovery.
The producer continues to scan bounded raw schematic forms so authored
nanometre precision and text metadata are not lost through the connectivity
model. Annotation records follow the P5_060 header and connectivity records
in the fixed family order label, global_label,
hierarchical_label, netclass_flag,
text, and text_box. Source order is preserved
within each family.
The existing P5_060 entry point remains unchanged. The annotation entry point adds explicit effective drawing settings and an optional bounded font resource set. Drawing settings carry the effective text-offset ratio and default line width in nanometres; callers own conversion from KiCad project mil values. A carrier that requires outline metrics fails closed unless the exact requested face, bold, and italic selection is present. Core never searches platform fonts or project paths.
Labels emit text before an optional direction decoration. Local labels
never decorate; global and hierarchical labels retain their distinct KiCad
placement, colors, point layouts, and supported shapes. Plotted label text
converts the KiCad {slash} escape while record identity keeps
the authored text. Label and netclass-property text does not expand project
variables.
Netclass flags emit their marker before visible property text. Round and dot markers use a colored lead segment and circle; diamond and rectangle markers use one closed polyline. Hidden, empty, and tilde-valued properties do not emit operations. Unsupported valid-domain shapes fail closed rather than silently widening the strict record vocabulary.
Ordinary text and text-box content use a separate one-pass, exact-case variable expander. Built-in sheet and title values override project values; unknown tokens remain literal and an empty token expands to an empty string. This intentionally differs from the recursive, whitespace-trimming worksheet expander. Ordinary text removes exactly one terminal newline for plotting. Text boxes preserve the authoritative fill-before-outline order, bounded wrapping, internal blank-line spacing, and per-line hyperlink context.
The strict schematic record union gains six annotation arms. Generated text operations gain an optional closed hyperlink context and generated thick segments gain an optional stroke color for netclass leads. TypeSpec, JSON Schema, Rust, Python, and TypeScript bindings regenerate atomically. Board, standalone-footprint, and symbol semantic validators continue to reject those new optional states when their producers do not own them.
The strict producer contracts remain incubating through P5_071. Generic
kicad.plotter_ir.a0 consumers remain forward tolerant. No font
bytes, drawing-resource payloads, serialized-output guarantee, or new bot
endpoint is added in this native slice.
Independent limits cover every annotation family, netclass properties, text-box lines, aggregate selected forms, records, operations, input and output points, retained text, and retained metadata. The accepted text resource limits continue to bound font bytes and selection, hashing, shaping, line-breaking output, glyph and outline work. The text-box line ceiling bounds retained logical lines and is preflighted before metric work when already exhausted; the text engine's output and work ceilings bound the temporary line-break result. Derived coordinates and widths are finite and JavaScript-safe before records are published. Limit or malformed-model failures return no partial document.
The hermetic Python oracle extends the shared schematic vectors with one
dense metric-independent annotation document and one document bound to the
committed shaping fixture font. Together they cover all six families,
operation order, variables, drawing settings, hyperlinks, fill and outline
passes, exact global-label width, ordinary-text line height, and text-box
wrapping without platform discovery. Rack L1_036, focused
native tests, strict contract mutations, and generation checks own the
executable evidence.
P5_062 now owns schematic graphics, rule areas, images, and tables. P5_070 owns placed symbols, their fields and pins, and overlap records. P5_071 retains hierarchical sheets, sheet fields, and sheet pins.