@schemd/core 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to `@schemd/core` are recorded here. Dates describe actual npm publication dates; unpublished versions deliberately use `Unreleased`.
 
+## [0.3.1] - 07/20/2026
+
+### Fixed
+
+- Orthogonal routing no longer fails diagrams whose components sit closer than twice the 12-unit clearance margin. The post-routing guard now rejects only physical body clips; escape stubs may legitimately pass through a neighbor's clearance ring, so densely packed parallel wires route as straight traces instead of throwing `Orthogonal route intersects … after routing.`
+- Empty `qgate` detail rows (`parameter=""`, `phase=""`, `matrix=""`) no longer reserve blank text space: layout and renderer now agree that empty details are absent, so such gates keep the canonical shared quantum shell.
+- `embedded-css` output no longer emits keyboard-focusable component and wire groups beneath its `role="img"` root, which flattened them for assistive technology while leaving unlabeled tab stops. Internal `tabindex`/ARIA semantics are now exclusive to `full` mode, and every `full`-mode root is `role="group"` regardless of which semantic hooks are enabled.
+
+### Changed
+
+- `renderSchematic` skips the redundant geometry revalidation pass when the parser's route cache proves the same frozen document already validated against identical bounds, and computes the AST-serializing signature hash only when no `idPrefix` is supplied. Rendered output is byte-identical; hosts that pass `idPrefix` (such as compile endpoints) no longer pay an `O(document)` serialization per render.
+
+### Verified release-candidate measurements
+
+- Compiler bundle: 90,294 B minified, 26,479 B gzip — 4,241 B below the 30,720 B gate and 33 B smaller than 0.3.0.
+- Coverage: 100% statements, branches, functions, and lines across 123 tests, including new regressions for sub-clearance routing, single-track barriers, and empty quantum detail rows.
+- Runtime dependencies: zero. No public API, grammar, or geometry contracts changed; no migration is required.
+
 ## [0.3.0] - 07/19/2026
 
 ### Added

package/dist/layout.d.ts

@@ -107,6 +107,18 @@ export declare function rotateQuarterExtents(extents: SchematicHalfExtents, turn
  * @returns Relative coordinate between negative and positive half-span.
  */
 export declare function distributedCoordinate(index: number, count: number, span: number): number;
+/** Total centered height of a quantum glyph carrying `tracks` qubit lines. */
+export declare function quantumTrackSpan(tracks: number): number;
+/**
+ * Vertical offset of quantum track `index` within a `tracks`-line glyph.
+ *
+ * Unlike {@link distributedCoordinate}, tracks are spread *edge-to-edge* so the
+ * outermost rails land exactly at ±span/2 — where the connecting bar and body
+ * extent terminate. That keeps control dots, targets, and swap crosses on rails
+ * a full pitch apart instead of collapsing a two-qubit swap into an overlapped
+ * star. Renderer and port geometry both call this, so marks and wires align.
+ */
+export declare function quantumTrackCoordinate(index: number, tracks: number): number;
 /**
  * Compute a classical gate height that scales with its busiest terminal side.
  *

package/dist/layout.js

@@ -83,11 +83,20 @@ function formatNumber(value) {
 export function distributedCoordinate(index, count, span) {
     return ((index + 1) * span) / (count + 1) - span / 2;
 }
+export function quantumTrackSpan(tracks) {
+    return Math.max(16, (tracks - 1) * 18);
+}
+export function quantumTrackCoordinate(index, tracks) {
+    if (tracks <= 1)
+        return 0;
+    const span = quantumTrackSpan(tracks);
+    return -span / 2 + (index * span) / (tracks - 1);
+}
 export function classicalGateHeight(component) {
     return Math.max(48, Math.max(component.inputs, component.outputs) * 16);
 }
 export function quantumGateDimensions(component) {
-    const details = [component.parameter, component.phase, component.matrix].filter((value) => value !== undefined);
+    const details = [component.parameter, component.phase, component.matrix].filter((value) => value !== undefined && value !== '');
     let widest = 16;
     if (details.length > 0 && component.kind === 'qgate')
         widest = mathLabelTextWidth(component.label, 8);
@@ -454,12 +463,12 @@ export function resolvePortPoint(component, port) {
                 index += component.controls;
             const tracks = Math.max(component.wires, component.controls + component.targets);
             if (port.startsWith('control') || port.startsWith('target')) {
-                local = { x: 0, y: distributedCoordinate(index, Math.max(1, tracks), Math.max(16, (tracks - 1) * 18)) };
+                local = { x: 0, y: quantumTrackCoordinate(index, tracks) };
             }
             else {
                 local = {
                     x: port.startsWith('out') ? 42 : -42,
-                    y: distributedCoordinate(index, Math.max(1, tracks), Math.max(16, (tracks - 1) * 18))
+                    y: quantumTrackCoordinate(index, tracks)
                 };
             }
             break;
@@ -1091,7 +1100,7 @@ function routeConnectionInternal(connection, components, bounds, cachedObstacles
             for (const obstacle of obstacleCache) {
                 if (!(allowFrom && obstacle.id === from.component.id) &&
                     !(allowTo && obstacle.id === to.component.id) &&
-                    segmentIntersectsRectangle(points[index - 1], points[index], obstacleRectangle(obstacle))) {
+                    segmentIntersectsRectangle(points[index - 1], points[index], obstacle.body)) {
                     throw new SchematicSyntaxError(`Orthogonal route intersects ${obstacle.id} after routing.`, connection.line);
                 }
             }

package/dist/math-label.d.ts

@@ -57,9 +57,11 @@ export declare function mathLabelTextWidth(value: string, cellAdvance?: number):
 /**
  * Emit escaped inline SVG text with explicit baseline restoration.
  *
- * Plain labels avoid `<tspan>` allocation entirely. Shifted segments carry
- * absolute scale and baseline metrics; each emitted `dy` is the delta from the
- * preceding run, so nested and consecutive scripts cannot accumulate drift.
+ * Baseline shifts are tracked in root-em units, but SVG resolves a `<tspan>`'s
+ * `dy="…em"` against *that tspan's own* (scaled) font-size. Each emitted `dy` is
+ * therefore the root-em delta divided by the tspan's font scale, so a shift of
+ * `d` root-em applied on a `s`-scaled run renders as exactly `d` — nested and
+ * consecutive scripts return to the parent baseline with zero drift.
  *
  * @param value - Raw micro-math label.
  * @returns Trusted compiler-owned XML text suitable inside an SVG `<text>` node.

package/dist/math-label.js

@@ -191,33 +191,19 @@ export function renderMathLabelTspans(value) {
     if (segments.length === 1 && segments[0]?.kind === 'text' && segments[0].value === value) {
         return escapeXml(value);
     }
-    const nested = segments.some((segment) => segment.fontScale !== undefined);
-    if (nested) {
-        let previousShift = 0;
-        let markup = '';
-        for (const segment of segments) {
-            const shift = segment.baselineShiftEm ??
-                (segment.kind === 'subscript' ? 0.35 : segment.kind === 'superscript' ? -0.55 : 0);
-            const scale = segment.fontScale ?? (segment.kind === 'text' ? 1 : 0.7);
-            const delta = Number((shift - previousShift).toFixed(4));
-            const fontPercent = Number((scale * 100).toFixed(2));
-            markup += `<tspan dy="${delta}em" font-size="${fontPercent}%">${escapeXml(segment.value)}</tspan>`;
-            previousShift = shift;
-        }
-        if (previousShift !== 0) {
-            markup += `<tspan dy="${Number((-previousShift).toFixed(4))}em" font-size="100%"></tspan>`;
-        }
-        return markup;
+    let previousShift = 0;
+    let markup = '';
+    for (const segment of segments) {
+        const shift = segment.baselineShiftEm ??
+            (segment.kind === 'subscript' ? 0.35 : segment.kind === 'superscript' ? -0.55 : 0);
+        const scale = segment.fontScale ?? (segment.kind === 'text' ? 1 : 0.7);
+        const delta = Number(((shift - previousShift) / scale).toFixed(4));
+        const fontPercent = Number((scale * 100).toFixed(2));
+        markup += `<tspan dy="${delta}em" font-size="${fontPercent}%">${escapeXml(segment.value)}</tspan>`;
+        previousShift = shift;
     }
-    return segments
-        .map((segment) => {
-        const content = escapeXml(segment.value);
-        if (segment.kind === 'text')
-            return `<tspan dy="0">${content}</tspan>`;
-        if (segment.kind === 'subscript') {
-            return `<tspan dy="0.35em" font-size="70%">${content}</tspan><tspan dy="-0.35em" font-size="100%"></tspan>`;
-        }
-        return `<tspan dy="-0.55em" font-size="70%">${content}</tspan><tspan dy="0.55em" font-size="100%"></tspan>`;
-    })
-        .join('');
+    if (previousShift !== 0) {
+        markup += `<tspan dy="${Number((-previousShift).toFixed(4))}em" font-size="100%"></tspan>`;
+    }
+    return markup;
 }

package/dist/renderer.js

@@ -1,4 +1,4 @@
-import { classicalGateHeight, componentTextAnchors, distributedCoordinate, enumerateComponentPorts, PORT_HOTSPOT_RADIUS, quantumGateDimensions, routeConnections, validateDocumentGeometry } from './layout.js';
+import { classicalGateHeight, componentTextAnchors, distributedCoordinate, enumerateComponentPorts, PORT_HOTSPOT_RADIUS, quantumGateDimensions, quantumTrackCoordinate, quantumTrackSpan, routeConnections, validateDocumentGeometry } from './layout.js';
 import { MAX_SCHEMATIC_SVG_OUTPUT_BYTES, utf8ByteLength } from './limits.js';
 import { assertParsedSchematicDocument } from './parser.js';
 import { parsedSchematicRoutes } from './route-cache.js';
@@ -560,14 +560,14 @@ function quantumSpecialShape(component, paint, nodePaint) {
     if (component.kind === 'classical-bit' || component.kind === 'classical-register')
         return `<path ${paint} d="M -40 -2 H 40 M -40 2 H 40" />`;
     const tracks = Math.max(component.wires, component.controls + component.targets);
-    const span = Math.max(16, (tracks - 1) * 18);
-    const lines = Array.from({ length: tracks }, (_, index) => `<path ${paint} d="M -42 ${svgNumber(distributedCoordinate(index, tracks, span))} H 42" />`).join('');
+    const span = quantumTrackSpan(tracks);
+    const lines = Array.from({ length: tracks }, (_, index) => `<path ${paint} d="M -42 ${svgNumber(quantumTrackCoordinate(index, tracks))} H 42" />`).join('');
     if (component.kind === 'barrier')
         return `${lines}<path ${paint} stroke-dasharray="4 3" d="M 0 ${svgNumber(-span / 2 - 8)} V ${svgNumber(span / 2 + 8)}" />`;
     if (component.kind === 'delay')
         return `${lines}<rect ${paint} x="-12" y="${svgNumber(-span / 2 - 7)}" width="24" height="${svgNumber(span + 14)}" rx="2" />`;
     const marks = Array.from({ length: tracks }, (_, index) => {
-        const y = distributedCoordinate(index, tracks, span);
+        const y = quantumTrackCoordinate(index, tracks);
         if (component.kind === 'swap')
             return `<path ${paint} d="M -6 ${svgNumber(y - 6)} L 6 ${svgNumber(y + 6)} M 6 ${svgNumber(y - 6)} L -6 ${svgNumber(y + 6)}" />`;
         if (component.kind === 'cz')
@@ -790,7 +790,7 @@ function compactConnectionMarkup(connections, routes, idPrefix, embedVisuals, gl
         const labels = batch.labels.join('');
         if (!embedVisuals)
             return trace + endpoints + labels;
-        return `<g class="schematic-wire" tabindex="0" role="group" aria-label="${batch.traces.length} grouped connection${batch.traces.length === 1 ? '' : 's'}">${trace}<use class="schematic-glow-layer" href="#${traceId}" filter="url(#${glowId})" aria-hidden="true" pointer-events="none" />${endpoints}${labels}</g>`;
+        return `<g class="schematic-wire">${trace}<use class="schematic-glow-layer" href="#${traceId}" filter="url(#${glowId})" aria-hidden="true" pointer-events="none" />${endpoints}${labels}</g>`;
     }).join('');
 }
 function componentMetadata(component) {
@@ -861,7 +861,7 @@ function componentMarkup(component, index, idPrefix, glowId, mode, nodeHooks, po
         ? ` data-node-id="${id}" data-node-kind="${component.kind}" data-node-label="${label}" data-component="${id}" data-kind="${component.kind}" data-source-line="${component.line}"${'orientation' in component && component.orientation !== undefined ? ` data-orientation="${component.orientation}"` : ''}`
         : '';
     let accessibility = '';
-    if (styles) {
+    if (mode === 'full') {
         const metadata = componentMetadata(component);
         const ariaLabel = escapeXml(`${component.id}, ${component.kind}, ${component.label}${metadata === '' ? '' : `, ${metadata}`}`);
         accessibility = `${portHooks ? '' : ' tabindex="0"'} role="group" aria-label="${ariaLabel}"`;
@@ -883,15 +883,13 @@ function componentMarkup(component, index, idPrefix, glowId, mode, nodeHooks, po
 export function renderSchematic(document, options) {
     assertParsedSchematicDocument(document);
     const normalized = normalizeCompileOptions(options);
-    const components = new Map(document.components.map((component) => [component.id, component]));
     const routedConnections = parsedSchematicRoutes(document, normalized.bounds) ??
-        routeConnections(document.connections, components, normalized.bounds);
-    validateDocumentGeometry(document, normalized, routedConnections);
-    const signature = `${normalized.bounds.width}x${normalized.bounds.height}:${normalized.title}:${JSON.stringify(document)}`;
-    const candidatePrefix = (normalized.idPrefix ?? `schematic-${stableHash(signature)}`).replace(/[^A-Za-z0-9_-]/g, '-');
+        validateDocumentGeometry(document, normalized, routeConnections(document.connections, new Map(document.components.map((component) => [component.id, component])), normalized.bounds));
+    const signatureHash = () => stableHash(`${normalized.bounds.width}x${normalized.bounds.height}:${normalized.title}:${JSON.stringify(document)}`);
+    const candidatePrefix = (normalized.idPrefix ?? `schematic-${signatureHash()}`).replace(/[^A-Za-z0-9_-]/g, '-');
     const safePrefix = /[A-Za-z0-9]/.test(candidatePrefix)
         ? candidatePrefix
-        : `schematic-${stableHash(signature)}`;
+        : `schematic-${signatureHash()}`;
     const titleId = `${safePrefix}-title`;
     const descriptionId = `${safePrefix}-description`;
     const gridId = `${safePrefix}-grid`;
@@ -924,7 +922,7 @@ export function renderSchematic(document, options) {
         ? `<style>${STATIC_SVG_STYLES}${hookStyles}${interactionStyles}</style><pattern id="${gridId}" width="20" height="20" patternUnits="userSpaceOnUse"><path class="schematic-grid-line" d="M20 0H0V20" /></pattern>${glowFilter}`
         : '';
     const definitions = `${embeddedDefinitions}${markerDefinitions}${symbolDefinitions}`;
-    const svgRole = portHooks ? 'group' : 'img';
+    const svgRole = hooks ? 'group' : 'img';
     writer.append(`<figure class="schematic-frame"${hooks ? ' data-schematic' : ''}><svg class="schematic-svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${normalized.bounds.width} ${normalized.bounds.height}" width="${normalized.bounds.width}" height="${normalized.bounds.height}" fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" role="${svgRole}" aria-labelledby="${titleId} ${descriptionId}" preserveAspectRatio="xMidYMid meet"><title id="${titleId}">${title}</title><desc id="${descriptionId}">${description}</desc>${definitions === '' ? '' : `<defs>${definitions}</defs>`}${styles ? `<rect class="schematic-surface" width="100%" height="100%" /><rect class="schematic-grid" width="100%" height="100%" fill="url(#${gridId})" />` : ''}<g class="schematic-vectors">`);
     if (wireHooks) {
         for (const [index, connection] of document.connections.entries()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schemd/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Zero-dependency text-to-SVG compiler for schematics and UML.",
   "homepage": "https://schemd.johnowolabiidogun.dev",
   "bugs": {