@schemd/core 0.1.2 → 0.2.1

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./assets/brand/schemd-logo.svg" alt="Schemd — engineering vectors" width="640" />
+</p>
+
 # @schemd/core
 
 Write schematics and UML as text. Get accessible, deterministic SVG.
@@ -7,21 +11,21 @@ Schemd has no runtime dependencies, browser layout pass, or DOM requirement. It
 ## Install
 
 ```sh
-npm install @schemd/core
+npm i @schemd/core # bun i @schemd/core
 ```
 
-Node.js 24+ is required. Install `marked` too if you use Markdown fences.
+Node.js 24+ is required.
 
 ## Quick start
 
 ```ts
-import { parseSchematic, parseSchematicFence, renderSchematic } from "@schemd/core";
+import { compileSchematic, parseSchematicFence } from "@schemd/core";
 
 const fence = parseSchematicFence(
   'schemd bounds="640x260" title="Sensor input"',
 )!;
 
-const diagram = parseSchematic(`
+const { svg, document, metrics } = compileSchematic(`
 port:VIN "Input" at (60, 130) #blue
 resistor:R1 "10 k\\Omega" at (220, 130) #amber
 capacitor:C1 "100 nF" at (400, 130) #cyan
@@ -29,8 +33,6 @@ capacitor:C1 "100 nF" at (400, 130) #cyan
 VIN.out -> R1.in #blue [ortho]
 R1.out -> C1.in #amber [ortho]
 `, fence);
-
-const html = renderSchematic(diagram, fence);
 ```
 
 The DSL is intentionally small:
@@ -55,6 +57,14 @@ Class, actor, use-case, state, lifeline, note, package, initial, and final nodes
 
 Use `mode: "embedded-css"` for built-in styling or `mode: "full"` for interaction metadata. The default output stays compact and static.
 
-For Markdown, use `schematicMarkedExtension()` from the main package or the `@schemd/core/marked` subpath.
+On a colored surface, set `--schematic-surface` to that background color so hollow UML markers and connector-label halos match it.
+
+Markdown belongs at the host boundary. Detect `schemd` fences in your server-side Markdown renderer and pass their text to `compileSchematic`; core does not ship or require a Markdown parser.
+
+## Roadmap
+
+**Now: topology and routing** → **Next: visual precision** → **Later: language and footprint**
+
+Known limits and contributor-sized work live in the [active roadmap](./ROADMAP.md). Pick an item, open its claim link, and agree on the approach before starting a large change. Completed items are removed after merge.
 
-[Documentation](https://johnowolabiidogun.dev/tools/schemd/docs/overview) · [Issues](https://github.com/Sirneij/schemd/issues) · [MIT](https://github.com/Sirneij/schemd/blob/main/LICENSE)
+[Documentation](https://johnowolabiidogun.dev/tools/schemd/docs/overview) · [Roadmap](./ROADMAP.md) · [Issues](https://github.com/Sirneij/schemd/issues) · [MIT](https://github.com/Sirneij/schemd/blob/main/LICENSE)

package/assets/brand/README.md

@@ -0,0 +1,6 @@
+# Schemd brand assets
+
+- `schemd-mark.svg` is the square product mark for favicons, avatars, and compact UI.
+- `schemd-logo.svg` is the primary horizontal lockup for dark surfaces.
+
+Keep one terminal-node diameter of clear space around the mark. Do not recolor individual wires or stretch either asset. The core palette is canvas `#080b0b`, signal `#72dbbb`, paper `#f4f8f5`, and secondary signal `#e1a15c`.

package/assets/brand/schemd-logo.svg

@@ -0,0 +1,29 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 200" role="img" aria-labelledby="title description">
+  <title id="title">Schemd</title>
+  <desc id="description">Schemd engineering vectors logo.</desc>
+  <defs>
+    <linearGradient id="surface" x1="0" y1="0" x2="720" y2="200" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#111817" />
+      <stop offset="1" stop-color="#080b0b" />
+    </linearGradient>
+    <linearGradient id="signal" x1="42" y1="68" x2="158" y2="132" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#9aead1" />
+      <stop offset="1" stop-color="#52c7a5" />
+    </linearGradient>
+  </defs>
+  <rect x="1" y="1" width="718" height="198" rx="28" fill="url(#surface)" stroke="#29473f" stroke-width="2" />
+  <g>
+    <rect x="24" y="24" width="152" height="152" rx="30" fill="#0c1110" stroke="#33574d" stroke-width="2" />
+    <path d="M44 72h31l17 28h16l17-28h31M44 128h31l17-28m16 0 17 28h31" fill="none" stroke="url(#signal)" stroke-width="8" stroke-linecap="round" stroke-linejoin="round" />
+    <path d="M92 100h16" stroke="#e1a15c" stroke-width="8" stroke-linecap="round" />
+    <g fill="#72dbbb" stroke="#080b0b" stroke-width="3">
+      <circle cx="44" cy="72" r="7" />
+      <circle cx="156" cy="72" r="7" />
+      <circle cx="44" cy="128" r="7" />
+      <circle cx="156" cy="128" r="7" />
+    </g>
+  </g>
+  <text x="210" y="106" fill="#f4f8f5" font-family="Inter, 'Fira Sans', system-ui, sans-serif" font-size="72" font-weight="640" letter-spacing="-3">schemd</text>
+  <path d="M214 128h430" stroke="#29473f" stroke-width="2" />
+  <text x="212" y="154" fill="#72dbbb" font-family="'Fira Code', ui-monospace, monospace" font-size="15" font-weight="600" letter-spacing="4">ENGINEERING VECTORS</text>
+</svg>

package/assets/brand/schemd-mark.svg

@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-labelledby="title description">
+  <title id="title">Schemd mark</title>
+  <desc id="description">Four circuit terminals converge through a central vector path.</desc>
+  <defs>
+    <linearGradient id="surface" x1="12" y1="8" x2="116" y2="120" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#17231f" />
+      <stop offset="1" stop-color="#080b0b" />
+    </linearGradient>
+    <linearGradient id="signal" x1="18" y1="32" x2="110" y2="96" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#9aead1" />
+      <stop offset="1" stop-color="#52c7a5" />
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="120" height="120" rx="24" fill="url(#surface)" stroke="#33574d" stroke-width="2" />
+  <path d="M20 40h25l13 24h12l13-24h25M20 88h25l13-24m12 0 13 24h25" fill="none" stroke="url(#signal)" stroke-width="7" stroke-linecap="round" stroke-linejoin="round" />
+  <path d="M58 64h12" stroke="#e1a15c" stroke-width="7" stroke-linecap="round" />
+  <g fill="#72dbbb" stroke="#080b0b" stroke-width="3">
+    <circle cx="20" cy="40" r="7" />
+    <circle cx="108" cy="40" r="7" />
+    <circle cx="20" cy="88" r="7" />
+    <circle cx="108" cy="88" r="7" />
+  </g>
+</svg>

package/dist/compiler.d.ts

@@ -0,0 +1,16 @@
+import type { CompileSchematicOptions, SchematicDocument } from './types.js';
+/** Small, allocation-bounded compilation counters. */
+export interface SchematicCompilationMetrics {
+    readonly sourceCharacters: number;
+    readonly components: number;
+    readonly connections: number;
+    readonly svgBytes: number;
+}
+/** Validated AST, rendered SVG, and useful host-side counters. */
+export interface SchematicCompilation {
+    readonly document: SchematicDocument;
+    readonly svg: string;
+    readonly metrics: SchematicCompilationMetrics;
+}
+/** Parse and render a schematic with one stable public call. */
+export declare function compileSchematic(source: string, options: CompileSchematicOptions): SchematicCompilation;

package/dist/compiler.js

@@ -0,0 +1,17 @@
+import { utf8ByteLength } from './limits.js';
+import { parseSchematic } from './parser.js';
+import { renderSchematic } from './renderer.js';
+export function compileSchematic(source, options) {
+    const document = parseSchematic(source, options);
+    const svg = renderSchematic(document, options);
+    return {
+        document,
+        svg,
+        metrics: {
+            sourceCharacters: source.length,
+            components: document.components.length,
+            connections: document.connections.length,
+            svgBytes: utf8ByteLength(svg)
+        }
+    };
+}

package/dist/index.d.ts

@@ -1,16 +1,14 @@
 /**
  * Stable public entry point for the `schemd` server-side compiler.
  *
- * All runtime exports are dependency-free. The Marked integration imports
- * Marked contracts as types only, so applications pay for no Markdown runtime
- * unless they already provide one at the host boundary.
+ * All runtime exports are dependency-free and safe to run without a DOM.
  *
  * @packageDocumentation
  */
 export { parseSchematic, parseSchematicColor, parseSchematicFence } from './parser.js';
 export { renderSchematic } from './renderer.js';
-export { schematicMarkedExtension } from './marked-extension.js';
+export { compileSchematic, type SchematicCompilation, type SchematicCompilationMetrics } from './compiler.js';
 export { mathLabelGlyphLength, mathLabelTextWidth, mathLabelText, parseMathLabel, renderMathLabelTspans, type MathLabelSegment, type MathLabelSegmentKind } from './math-label.js';
 export { MAX_SCHEMATIC_COMPONENTS, MAX_SCHEMATIC_CONNECTIONS, MAX_SCHEMATIC_WIRE_CROSSINGS, MAX_SCHEMATIC_SOURCE_CHARACTERS, MAX_SCHEMATIC_SVG_OUTPUT_BYTES, SCHEMATIC_LIMITS } from './limits.js';
 export { classicalGateHeight, componentObstacleRectangle, componentRectangle, componentTextAnchors, distributedCoordinate, enumerateComponentPorts, positionIcPin, PORT_HOTSPOT_RADIUS, resolvePortPoint, resolvePortGeometry, routeConnections, routeConnection, SCHEMATIC_BRIDGE_RADIUS, SCHEMATIC_OBSTACLE_CLEARANCE, validateDocumentGeometry, type RoutedConnection, type ComponentTextAnchors, type ComponentPort, type IcPinSide, type SchematicRectangle } from './layout.js';
-export { ANALOG_KINDS, COMPONENT_KINDS, CLASSICAL_GATE_KINDS, DIODE_TYPES, GROUND_STYLES, PASSIVE_KINDS, QUANTUM_GATE_KINDS, SCHEMATIC_SIGNAL_MARKERS, SEMANTIC_COLORS, TRANSISTOR_TYPES, UML_COMPONENT_KINDS, UML_RELATION_KINDS, SCHEMD_OUTPUT_MODES, SchematicSyntaxError, type AnalogKind, type CompileSchematicOptions, type ClassicalGateComponent, type ClassicalGateKind, type ComponentKind, type DiodeComponent, type DiodeType, type GroundComponent, type GroundStyle, type IcComponent, type IntegratedCircuitComponent, type IntegratedCircuitPins, type PassiveComponent, type PassiveKind, type PortComponent, type SemanticColor, type SchematicBounds, type SchematicComponent, type SchematicConnection, type SchematicColor, type SchematicDocument, type SchematicEndpoint, type SchematicFence, type SchematicSignalMarker, type SchematicMarkedOptions, type SchematicPoint, type SchemdOutputMode, type TransistorComponent, type TransistorType, type QuantumGateComponent, type QuantumGateKind, type SchematicRelationKind, type UmlActorComponent, type UmlClassComponent, type UmlComponent, type UmlComponentKind, type UmlPseudostateComponent, type UmlRelationKind, type UmlSizedComponent, type UmlStateComponent } from './types.js';
+export { ANALOG_KINDS, COMPONENT_KINDS, CLASSICAL_GATE_KINDS, DIODE_TYPES, GROUND_STYLES, PASSIVE_KINDS, QUANTUM_GATE_KINDS, SCHEMATIC_SIGNAL_MARKERS, SEMANTIC_COLORS, TRANSISTOR_TYPES, UML_COMPONENT_KINDS, UML_RELATION_KINDS, SCHEMD_OUTPUT_MODES, SCHEMD_SEMANTIC_HOOKS, SchematicSyntaxError, type AnalogKind, type CompileSchematicOptions, type ClassicalGateComponent, type ClassicalGateKind, type ComponentKind, type DiodeComponent, type DiodeType, type GroundComponent, type GroundStyle, type IcComponent, type IntegratedCircuitComponent, type IntegratedCircuitPins, type PassiveComponent, type PassiveKind, type PortComponent, type SemanticColor, type SchematicBounds, type SchematicComponent, type SchematicConnection, type SchematicColor, type SchematicDocument, type SchematicEndpoint, type SchematicFence, type SchematicSignalMarker, type SchematicSemanticHook, type SchematicPoint, type SchemdOutputMode, type TransistorComponent, type TransistorType, type QuantumGateComponent, type QuantumGateKind, type SchematicRelationKind, type UmlActorComponent, type UmlClassComponent, type UmlComponent, type UmlComponentKind, type UmlPseudostateComponent, type UmlRelationKind, type UmlSizedComponent, type UmlStateComponent } from './types.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 export { parseSchematic, parseSchematicColor, parseSchematicFence } from './parser.js';
 export { renderSchematic } from './renderer.js';
-export { schematicMarkedExtension } from './marked-extension.js';
+export { compileSchematic } from './compiler.js';
 export { mathLabelGlyphLength, mathLabelTextWidth, mathLabelText, parseMathLabel, renderMathLabelTspans } from './math-label.js';
 export { MAX_SCHEMATIC_COMPONENTS, MAX_SCHEMATIC_CONNECTIONS, MAX_SCHEMATIC_WIRE_CROSSINGS, MAX_SCHEMATIC_SOURCE_CHARACTERS, MAX_SCHEMATIC_SVG_OUTPUT_BYTES, SCHEMATIC_LIMITS } from './limits.js';
 export { classicalGateHeight, componentObstacleRectangle, componentRectangle, componentTextAnchors, distributedCoordinate, enumerateComponentPorts, positionIcPin, PORT_HOTSPOT_RADIUS, resolvePortPoint, resolvePortGeometry, routeConnections, routeConnection, SCHEMATIC_BRIDGE_RADIUS, SCHEMATIC_OBSTACLE_CLEARANCE, validateDocumentGeometry } from './layout.js';
-export { ANALOG_KINDS, COMPONENT_KINDS, CLASSICAL_GATE_KINDS, DIODE_TYPES, GROUND_STYLES, PASSIVE_KINDS, QUANTUM_GATE_KINDS, SCHEMATIC_SIGNAL_MARKERS, SEMANTIC_COLORS, TRANSISTOR_TYPES, UML_COMPONENT_KINDS, UML_RELATION_KINDS, SCHEMD_OUTPUT_MODES, SchematicSyntaxError } from './types.js';
+export { ANALOG_KINDS, COMPONENT_KINDS, CLASSICAL_GATE_KINDS, DIODE_TYPES, GROUND_STYLES, PASSIVE_KINDS, QUANTUM_GATE_KINDS, SCHEMATIC_SIGNAL_MARKERS, SEMANTIC_COLORS, TRANSISTOR_TYPES, UML_COMPONENT_KINDS, UML_RELATION_KINDS, SCHEMD_OUTPUT_MODES, SCHEMD_SEMANTIC_HOOKS, SchematicSyntaxError } from './types.js';

package/dist/layout.d.ts

@@ -158,4 +158,4 @@ export declare function componentRectangle(component: SchematicComponent): Schem
  * @param fence - Intrinsic canvas contract.
  * @throws {SchematicSyntaxError} At the originating component or connection line.
  */
-export declare function validateDocumentGeometry(document: SchematicDocument, fence: SchematicFence, routedConnections?: readonly RoutedConnection[]): void;
+export declare function validateDocumentGeometry(document: SchematicDocument, fence: SchematicFence, routedConnections?: readonly RoutedConnection[]): readonly RoutedConnection[];

package/dist/layout.js

@@ -7,6 +7,7 @@ export const SCHEMATIC_BRIDGE_RADIUS = 5;
 const MAX_ROUTER_STATES = 40_000;
 const ROUTER_BEND_PENALTY = 0.25;
 const CROSSING_BUCKET_SIZE = 64;
+const MIN_RENDERABLE_BRIDGE_RADIUS = 0.001;
 const DESIGNATOR_BASELINE_GAP = 10;
 const LABEL_BASELINE_GAP = 19;
 const TEXT_ASCENT_GUTTER = 12;
@@ -609,6 +610,19 @@ function routeBetweenEscapes(start, end, obstacles, bounds, line) {
     }
     return best ?? searchOrthogonalRoute(start, end, obstacles, bounds, line);
 }
+function endpointsFaceEachOther(from, to) {
+    const dx = to.point.x - from.point.x;
+    const dy = to.point.y - from.point.y;
+    if (dy === 0 && dx !== 0) {
+        const direction = Math.sign(dx);
+        return from.normal.x === direction && to.normal.x === -direction;
+    }
+    if (dx === 0 && dy !== 0) {
+        const direction = Math.sign(dy);
+        return from.normal.y === direction && to.normal.y === -direction;
+    }
+    return false;
+}
 function routeConnectionInternal(connection, components, bounds, cachedObstacles) {
     const from = endpointGeometry(connection.from, components);
     const to = endpointGeometry(connection.to, components);
@@ -635,6 +649,13 @@ function routeConnectionInternal(connection, components, bounds, cachedObstacles
                 expanded: componentObstacleRectangle(component),
                 body: componentObstacleRectangle(component, 0)
             }));
+        if (from.component.id !== to.component.id &&
+            endpointsFaceEachOther(from, to) &&
+            !obstacleCache.some((entry) => entry.id !== from.component.id &&
+                entry.id !== to.component.id &&
+                segmentIntersectsRectangle(start, end, entry.expanded))) {
+            return { curve: 'ortho', d: orthogonalPath([start, end]), points: [start, end] };
+        }
         const fromObstacle = componentObstacleRectangle(from.component);
         const toObstacle = componentObstacleRectangle(to.component);
         const escape = (geometry, obstacle) => ({
@@ -651,13 +672,8 @@ function routeConnectionInternal(connection, components, bounds, cachedObstacles
         });
         const startEscape = escape(from, fromObstacle);
         const endEscape = escape(to, toObstacle);
-        const obstacleEntries = obstacleCache.map((entry) => ({
-            id: entry.id,
-            rectangle: entry.id === from.component.id || entry.id === to.component.id
-                ? entry.body
-                : entry.expanded
-        }));
-        const obstacleRectangles = obstacleEntries.map((entry) => entry.rectangle);
+        const obstacleRectangle = (entry) => entry.id === from.component.id || entry.id === to.component.id ? entry.body : entry.expanded;
+        const obstacleRectangles = obstacleCache.map(obstacleRectangle);
         const middle = routeBetweenEscapes(startEscape, endEscape, obstacleRectangles, bounds, connection.line);
         if (middle === undefined) {
             throw new SchematicSyntaxError('No collision-free orthogonal route exists.', connection.line);
@@ -666,10 +682,10 @@ function routeConnectionInternal(connection, components, bounds, cachedObstacles
         for (let index = 1; index < points.length; index += 1) {
             const allowFrom = index === 1;
             const allowTo = index === points.length - 1;
-            for (const obstacle of obstacleEntries) {
+            for (const obstacle of obstacleCache) {
                 if (!(allowFrom && obstacle.id === from.component.id) &&
                     !(allowTo && obstacle.id === to.component.id) &&
-                    segmentIntersectsRectangle(points[index - 1], points[index], obstacle.rectangle)) {
+                    segmentIntersectsRectangle(points[index - 1], points[index], obstacleRectangle(obstacle))) {
                     throw new SchematicSyntaxError(`Orthogonal route intersects ${obstacle.id} after routing.`, connection.line);
                 }
             }
@@ -743,6 +759,8 @@ function bridgedOrthogonalPath(route, crossings) {
             let cursorX = start.x;
             for (const [crossingIndex, crossing] of segmentCrossings.entries()) {
                 const radius = radii[crossingIndex];
+                if (radius < MIN_RENDERABLE_BRIDGE_RADIUS)
+                    continue;
                 const before = crossing.x - direction * radius;
                 const after = crossing.x + direction * radius;
                 if (before !== cursorX)
@@ -758,6 +776,8 @@ function bridgedOrthogonalPath(route, crossings) {
             let cursorY = start.y;
             for (const [crossingIndex, crossing] of segmentCrossings.entries()) {
                 const radius = radii[crossingIndex];
+                if (radius < MIN_RENDERABLE_BRIDGE_RADIUS)
+                    continue;
                 const before = crossing.y - direction * radius;
                 const after = crossing.y + direction * radius;
                 if (before !== cursorY)
@@ -961,4 +981,5 @@ export function validateDocumentGeometry(document, fence, routedConnections) {
             throw new SchematicSyntaxError('Connection trace exceeds the declared schematic bounds.', connection.line);
         }
     }
+    return routes;
 }

package/dist/limits.d.ts

@@ -1,9 +1,7 @@
 /**
- * Hard compiler budgets shared by the parser, renderer, and Marked integration.
+ * Hard compiler budgets shared by the parser and renderer.
  *
  * `parseSchematic` and `renderSchematic` enforce these limits for one diagram.
- * `schematicMarkedExtension` additionally enforces them cumulatively across all
- * schematic fences encountered during one Marked document pass.
  *
  * @packageDocumentation
  */

package/dist/math-label.js

@@ -1,3 +1,4 @@
+import { escapeXml } from './xml.js';
 const MATH_SYMBOLS = Object.freeze({
     alpha: 'α',
     beta: 'β',
@@ -20,28 +21,6 @@ const MATH_SYMBOLS = Object.freeze({
     theta: 'θ',
     times: '×'
 });
-function validXmlCodePoint(codePoint) {
-    if (codePoint === 0x09 || codePoint === 0x0a || codePoint === 0x0d)
-        return true;
-    if (codePoint >= 0x20 && codePoint <= 0xd7ff)
-        return true;
-    if (codePoint >= 0xe000 && codePoint <= 0xfffd)
-        return true;
-    return codePoint >= 0x10000 && codePoint <= 0x10ffff;
-}
-function escapeXml(value) {
-    let normalized = '';
-    for (const character of value) {
-        const codePoint = character.codePointAt(0);
-        normalized += validXmlCodePoint(codePoint) ? character : '\ufffd';
-    }
-    return normalized
-        .replaceAll('&', '&amp;')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;')
-        .replaceAll('"', '&quot;')
-        .replaceAll("'", '&#39;');
-}
 function commandAt(value, index) {
     const escaped = value[index + 1];
     if (escaped === '\\' ||

package/dist/parser.js

@@ -1,6 +1,7 @@
 import { ANALOG_KINDS, CLASSICAL_GATE_KINDS, COMPONENT_KINDS, DIODE_TYPES, GROUND_STYLES, PASSIVE_KINDS, SEMANTIC_COLORS, SCHEMATIC_SIGNAL_MARKERS, TRANSISTOR_TYPES, UML_COMPONENT_KINDS, UML_RELATION_KINDS, SchematicSyntaxError } from './types.js';
 import { validateDocumentGeometry } from './layout.js';
 import { mathLabelTextWidth } from './math-label.js';
+import { cacheParsedSchematicRoutes } from './route-cache.js';
 import { MAX_SCHEMATIC_COMPONENTS, MAX_SCHEMATIC_CONNECTIONS, MAX_SCHEMATIC_SOURCE_CHARACTERS } from './limits.js';
 const COMPONENT_PATTERN = /^([A-Za-z][A-Za-z0-9_-]*):([A-Za-z][A-Za-z0-9_-]*)\s+"([^"]+)"\s+at\s+\((-?\d+(?:\.\d+)?),\s*(-?\d+(?:\.\d+)?)\)\s+(.+)$/;
 const CONNECTION_PATTERN = /^([A-Za-z][A-Za-z0-9_-]*)\.([A-Za-z][A-Za-z0-9_-]*)\s*->\s*([A-Za-z][A-Za-z0-9_-]*)\.([A-Za-z][A-Za-z0-9_-]*)\s+(.+)$/;
@@ -764,6 +765,9 @@ export function parseSchematicFence(info, defaultTitle = 'Engineering schematic'
         throw new SchematicSyntaxError('Schematic bounds must be integers from 64 through 4096.');
     }
     const title = match[3] ?? defaultTitle;
+    if (title.trim() === '') {
+        throw new SchematicSyntaxError('Schematic titles cannot be empty.');
+    }
     if (title.length > MAX_FENCE_TITLE_LENGTH) {
         throw new SchematicSyntaxError('Schematic titles cannot exceed 512 characters.');
     }
@@ -814,6 +818,8 @@ export function parseSchematic(source, fence) {
         validateEndpoint(connection.to, componentsById, connection.line);
     }
     const document = { components, connections };
-    validateDocumentGeometry(document, fence);
-    return freezeParsedDocument(document);
+    const routes = validateDocumentGeometry(document, fence);
+    const parsedDocument = freezeParsedDocument(document);
+    cacheParsedSchematicRoutes(parsedDocument, fence.bounds, routes);
+    return parsedDocument;
 }

package/dist/renderer.js

@@ -1,36 +1,23 @@
 import { classicalGateHeight, componentTextAnchors, distributedCoordinate, enumerateComponentPorts, positionIcPin, PORT_HOTSPOT_RADIUS, routeConnections, validateDocumentGeometry } from './layout.js';
 import { MAX_SCHEMATIC_SVG_OUTPUT_BYTES, utf8ByteLength } from './limits.js';
 import { assertParsedSchematicDocument } from './parser.js';
-import { CLASSICAL_GATE_KINDS, SCHEMD_OUTPUT_MODES, UML_COMPONENT_KINDS, SchematicSyntaxError } from './types.js';
+import { parsedSchematicRoutes } from './route-cache.js';
+import { CLASSICAL_GATE_KINDS, SCHEMD_OUTPUT_MODES, SCHEMD_SEMANTIC_HOOKS, UML_COMPONENT_KINDS, SchematicSyntaxError } from './types.js';
 import { mathLabelTextWidth, renderMathLabelTspans } from './math-label.js';
+import { escapeXml } from './xml.js';
 export const MAX_SVG_OUTPUT_BYTES = MAX_SCHEMATIC_SVG_OUTPUT_BYTES;
 const STATIC_SVG_STYLES = '.schematic-token{fill:none;stroke:var(--schematic-vector,var(--schematic-vector-fallback,currentColor));stroke-linecap:round;stroke-linejoin:round;stroke-width:var(--schematic-stroke-width,1.65);vector-effect:non-scaling-stroke}.schematic-node-fill{fill:var(--schematic-vector,var(--schematic-vector-fallback,currentColor))}.schematic-designator,.schematic-label,.schematic-gate-symbol,.schematic-quantum-detail,.schematic-pin-label,.schematic-uml-text,.schematic-connection-label{fill:currentColor}.schematic-uml-row{font-size:12px}.schematic-uml-stereotype{font-size:11px}.schematic-connection-label{font-size:11px;paint-order:stroke;stroke:var(--schematic-surface,#fff);stroke-width:4;stroke-linejoin:round}.schematic-surface{fill:var(--schematic-surface,transparent)}.schematic-grid-line{fill:none;stroke:var(--schematic-grid,currentColor);stroke-width:1;opacity:.12;vector-effect:non-scaling-stroke}';
 const HOOK_SVG_STYLES = '.schematic-port-hotspot{fill:transparent!important;stroke:transparent!important;stroke-width:8;vector-effect:non-scaling-stroke;pointer-events:all;outline:none}.schematic-port-hotspot:focus-visible{fill:var(--schematic-vector,var(--schematic-vector-fallback,currentColor))!important;fill-opacity:.22!important;stroke:var(--schematic-vector,var(--schematic-vector-fallback,currentColor))!important;stroke-width:2}';
 const INTERACTIVE_SVG_STYLES = '.schematic-component,.schematic-wire{outline:none;transition:opacity .2s ease,filter .2s ease}.schematic-component .schematic-token,.schematic-wire .schematic-token{transition:stroke .2s ease,fill .2s ease,color .2s ease,opacity .2s ease,stroke-width .2s ease}.schematic-glow-layer{opacity:0;pointer-events:none;transition:opacity .2s ease}.schematic-component:hover>.schematic-glow-layer,.schematic-component:focus>.schematic-glow-layer,.schematic-component:focus-within>.schematic-glow-layer,.schematic-component.is-hovered>.schematic-glow-layer,.schematic-component.is-active>.schematic-glow-layer,.schematic-component.is-selected>.schematic-glow-layer,.schematic-wire:hover>.schematic-glow-layer,.schematic-wire:focus>.schematic-glow-layer,.schematic-wire.is-hovered>.schematic-glow-layer,.schematic-wire.is-active>.schematic-glow-layer,.schematic-wire.is-selected>.schematic-glow-layer{opacity:1}.schematic-component.is-degraded,.schematic-wire.is-degraded{opacity:.45}.schematic-component.is-degraded>.schematic-glow-layer,.schematic-wire.is-degraded>.schematic-glow-layer{opacity:0}.schematic-component:hover .schematic-token,.schematic-component:focus .schematic-token,.schematic-component:focus-within .schematic-token,.schematic-component.is-hovered .schematic-token,.schematic-component.is-active .schematic-token,.schematic-component.is-selected .schematic-token,.schematic-wire:hover .schematic-token,.schematic-wire:focus .schematic-token,.schematic-wire.is-hovered .schematic-token,.schematic-wire.is-active .schematic-token,.schematic-wire.is-selected .schematic-token{stroke-width:var(--schematic-interactive-stroke-width,2.25)}.schematic-port-hotspot{fill:var(--schematic-vector,var(--schematic-vector-fallback,currentColor))!important;fill-opacity:0;transition:fill-opacity .2s ease,opacity .2s ease}.schematic-port-hotspot:hover,.schematic-port-hotspot:focus,.schematic-port-hotspot.is-hovered,.schematic-port-hotspot.is-active,.schematic-port-hotspot.is-selected{fill-opacity:.2}.schematic-port-hotspot.is-degraded{opacity:.45}@media(prefers-reduced-motion:reduce){.schematic-component,.schematic-wire,.schematic-token,.schematic-glow-layer,.schematic-port-hotspot{transition:none}}';
-function validXmlCodePoint(codePoint) {
-    if (codePoint === 0x09 || codePoint === 0x0a || codePoint === 0x0d)
-        return true;
-    if (codePoint >= 0x20 && codePoint <= 0xd7ff)
-        return true;
-    if (codePoint >= 0xe000 && codePoint <= 0xfffd)
-        return true;
-    return codePoint >= 0x10000 && codePoint <= 0x10ffff;
-}
-function replaceInvalidXmlCharacters(value) {
-    let normalized = '';
-    for (const character of value) {
-        const codePoint = character.codePointAt(0);
-        normalized += validXmlCodePoint(codePoint) ? character : '\ufffd';
-    }
-    return normalized;
-}
-function escapeXml(value) {
-    return replaceInvalidXmlCharacters(value)
-        .replaceAll('&', '&amp;')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;')
-        .replaceAll('"', '&quot;')
-        .replaceAll("'", '&#39;');
+const NODE_HOOK = 1;
+const PORT_HOOK = 2;
+const WIRE_HOOK = 4;
+function semanticHookBit(hook) {
+    if (hook === 'nodes')
+        return NODE_HOOK;
+    if (hook === 'ports')
+        return PORT_HOOK;
+    return WIRE_HOOK;
 }
 export class BoundedSvgWriter {
     #chunks = [];
@@ -82,9 +69,24 @@ function normalizeCompileOptions(value) {
         throw new SchematicSyntaxError('Render mode must be one of: default, embedded-css, or full.');
     }
     const normalizedMode = (mode ?? 'default');
+    const rawSemanticHooks = candidate.semanticHooks;
+    let semanticHookMask = NODE_HOOK | PORT_HOOK | WIRE_HOOK;
+    if (rawSemanticHooks !== undefined) {
+        if (!Array.isArray(rawSemanticHooks)) {
+            throw new SchematicSyntaxError('Render semanticHooks must be an array.');
+        }
+        semanticHookMask = 0;
+        for (const hook of rawSemanticHooks) {
+            if (typeof hook !== 'string' ||
+                !SCHEMD_SEMANTIC_HOOKS.includes(hook)) {
+                throw new SchematicSyntaxError('Render semanticHooks may contain only: nodes, ports, or wires.');
+            }
+            semanticHookMask |= semanticHookBit(hook);
+        }
+    }
     return idPrefix === undefined
-        ? { bounds: { width, height }, title, mode: normalizedMode }
-        : { bounds: { width, height }, title, idPrefix, mode: normalizedMode };
+        ? { bounds: { width, height }, title, mode: normalizedMode, semanticHookMask }
+        : { bounds: { width, height }, title, idPrefix, mode: normalizedMode, semanticHookMask };
 }
 function svgNumber(value) {
     return String(Number(value.toFixed(3)));
@@ -284,7 +286,7 @@ function integratedCircuitShape(component, paint) {
     return `<rect ${paint} x="${left}" y="${top}" width="${component.bodyWidth}" height="${component.bodyHeight}" rx="3" />${icPinMarkup(component, 'left', paint)}${icPinMarkup(component, 'right', paint)}${icPinMarkup(component, 'top', paint)}${icPinMarkup(component, 'bottom', paint)}<text class="schematic-gate-symbol" fill="currentColor" stroke="none" x="0" y="4" text-anchor="middle" font-size="12" textLength="${fittedTextLength(component.label, component.bodyWidth - 12, 7)}" lengthAdjust="spacingAndGlyphs">${renderMathLabelTspans(component.label)}</text>`;
 }
 function umlRow(value, x, y) {
-    return `<text class="schematic-uml-text schematic-uml-row" fill="currentColor" stroke="none" x="${svgNumber(x)}" y="${svgNumber(y)}" font-size="12">${escapeXml(value)}</text>`;
+    return `<text class="schematic-uml-text schematic-uml-row" fill="currentColor" stroke="none" x="${svgNumber(x)}" y="${svgNumber(y)}" font-size="12">${renderMathLabelTspans(value)}</text>`;
 }
 function umlClassShape(component, paint) {
     const left = -component.bodyWidth / 2;
@@ -295,7 +297,7 @@ function umlClassShape(component, paint) {
     const operationSeparator = attributeSeparator + attributeHeight;
     const stereotype = component.stereotype === undefined
         ? ''
-        : `<text class="schematic-uml-text schematic-uml-stereotype" fill="currentColor" stroke="none" x="0" y="${svgNumber(top + 13)}" text-anchor="middle" font-size="11">«${escapeXml(component.stereotype)}»</text>`;
+        : `<text class="schematic-uml-text schematic-uml-stereotype" fill="currentColor" stroke="none" x="0" y="${svgNumber(top + 13)}" text-anchor="middle" font-size="11">«${renderMathLabelTspans(component.stereotype)}»</text>`;
     const nameY = top + (component.stereotype === undefined ? 23 : 32);
     const attributes = component.attributes
         .map((row, index) => umlRow(row, left + 8, attributeSeparator + 17 + index * 16))
@@ -516,19 +518,18 @@ function componentPortMarkup(component) {
     })
         .join('');
 }
-function componentMarkup(component, index, idPrefix, glowId, mode, symbolId) {
+function componentMarkup(component, index, idPrefix, glowId, mode, nodeHooks, portHooks, symbolId) {
     const label = escapeXml(component.label);
     const renderedLabel = renderMathLabelTspans(component.label);
     const anchors = componentTextAnchors(component);
     const id = escapeXml(component.id);
     const vectorId = `${idPrefix}-node-${index}-vector`;
     const styles = mode === 'embedded-css' || mode === 'full';
-    const hooks = mode === 'full';
-    const dataAttributes = hooks
+    const dataAttributes = nodeHooks
         ? ` data-node-id="${id}" data-node-kind="${component.kind}" data-node-label="${label}" data-component="${id}" data-kind="${component.kind}"`
         : '';
     let accessibility = '';
-    if (styles || hooks) {
+    if (styles) {
         const metadata = componentMetadata(component);
         const ariaLabel = escapeXml(`${component.id}, ${component.kind}, ${component.label}${metadata === '' ? '' : `, ${metadata}`}`);
         accessibility = ` tabindex="0" role="group" aria-label="${ariaLabel}"`;
@@ -537,7 +538,7 @@ function componentMarkup(component, index, idPrefix, glowId, mode, symbolId) {
     const glow = styles
         ? `<use class="schematic-glow-layer" href="#${vectorId}" filter="url(#${glowId})" aria-hidden="true" pointer-events="none" />`
         : '';
-    const hotspots = hooks ? componentPortMarkup(component) : '';
+    const hotspots = portHooks ? componentPortMarkup(component) : '';
     const vector = symbolId === undefined
         ? `<g${vectorIdAttribute} class="schematic-component-vector">${componentShape(component)}</g>`
         : `<use${vectorIdAttribute} ${colorAttributes(component.color, 'schematic-component-vector')} href="#${symbolId}" />`;
@@ -550,7 +551,8 @@ export function renderSchematic(document, options) {
     assertParsedSchematicDocument(document);
     const normalized = normalizeCompileOptions(options);
     const components = new Map(document.components.map((component) => [component.id, component]));
-    const routedConnections = routeConnections(document.connections, components, normalized.bounds);
+    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, '-');
@@ -563,6 +565,9 @@ export function renderSchematic(document, options) {
     const glowId = `${safePrefix}-schematic-glow-filter`;
     const styles = normalized.mode === 'embedded-css' || normalized.mode === 'full';
     const hooks = normalized.mode === 'full';
+    const nodeHooks = hooks && (normalized.semanticHookMask & NODE_HOOK) !== 0;
+    const portHooks = hooks && (normalized.semanticHookMask & PORT_HOOK) !== 0;
+    const wireHooks = hooks && (normalized.semanticHookMask & WIRE_HOOK) !== 0;
     const reusableSymbols = new Map();
     for (const component of document.components) {
         const key = reusableSymbolKey(component);
@@ -574,7 +579,7 @@ export function renderSchematic(document, options) {
     const componentCount = document.components.length;
     const description = `${componentCount} component${componentCount === 1 ? '' : 's'} and ${document.connections.length} connection${document.connections.length === 1 ? '' : 's'}.`;
     const writer = new BoundedSvgWriter();
-    const hookStyles = hooks ? HOOK_SVG_STYLES : '';
+    const hookStyles = portHooks ? HOOK_SVG_STYLES : '';
     const interactionStyles = styles ? INTERACTIVE_SVG_STYLES : '';
     const glowFilter = styles
         ? `<filter id="${glowId}" x="-30%" y="-30%" width="160%" height="160%" color-interpolation-filters="sRGB"><feGaussianBlur stdDeviation="2.2" result="blur" /><feMerge><feMergeNode in="blur" /><feMergeNode in="SourceGraphic" /></feMerge></filter>`
@@ -587,7 +592,7 @@ export function renderSchematic(document, options) {
         : '';
     const definitions = `${embeddedDefinitions}${markerDefinitions}${symbolDefinitions}`;
     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="img" 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 (hooks) {
+    if (wireHooks) {
         for (const [index, connection] of document.connections.entries()) {
             writer.append(connectionMarkup(connection, routedConnections[index], index, safePrefix, glowId));
         }
@@ -598,7 +603,7 @@ export function renderSchematic(document, options) {
     for (const [index, component] of document.components.entries()) {
         const key = reusableSymbolKey(component);
         const symbolId = key === undefined ? undefined : reusableSymbols.get(key)?.id;
-        writer.append(componentMarkup(component, index, safePrefix, glowId, normalized.mode, symbolId));
+        writer.append(componentMarkup(component, index, safePrefix, glowId, normalized.mode, nodeHooks, portHooks, symbolId));
     }
     writer.append(`</g></svg><figcaption>${title}</figcaption></figure>`);
     return writer.finish();

package/dist/route-cache.d.ts

@@ -0,0 +1,6 @@
+import type { RoutedConnection } from './layout.js';
+import type { SchematicBounds, SchematicDocument } from './types.js';
+/** Cache a validated route set against the bounds that produced it. */
+export declare function cacheParsedSchematicRoutes(document: SchematicDocument, bounds: SchematicBounds, routes: readonly RoutedConnection[]): void;
+/** Reuse routes only when render bounds match the parser's geometry contract. */
+export declare function parsedSchematicRoutes(document: SchematicDocument, bounds: SchematicBounds): readonly RoutedConnection[] | undefined;

package/dist/route-cache.js

@@ -0,0 +1,10 @@
+const parsedDocumentRoutes = new WeakMap();
+export function cacheParsedSchematicRoutes(document, bounds, routes) {
+    parsedDocumentRoutes.set(document, { width: bounds.width, height: bounds.height, routes });
+}
+export function parsedSchematicRoutes(document, bounds) {
+    const cached = parsedDocumentRoutes.get(document);
+    return cached?.width === bounds.width && cached.height === bounds.height
+        ? cached.routes
+        : undefined;
+}

package/dist/types.d.ts

@@ -261,6 +261,10 @@ export interface SchematicDocument {
 export declare const SCHEMD_OUTPUT_MODES: readonly ["default", "embedded-css", "full"];
 /** Static, CSS-enhanced, or fully attributed SVG output mode. */
 export type SchemdOutputMode = (typeof SCHEMD_OUTPUT_MODES)[number];
+/** Optional semantic payloads emitted by `full` mode. */
+export declare const SCHEMD_SEMANTIC_HOOKS: readonly ["nodes", "ports", "wires"];
+/** A selectable delegated-interaction payload. */
+export type SchematicSemanticHook = (typeof SCHEMD_SEMANTIC_HOOKS)[number];
 /** Marker primitives that can terminate or originate a signal trace. */
 export declare const SCHEMATIC_SIGNAL_MARKERS: readonly ["none", "arrow", "open-arrow", "dot", "triangle", "diamond", "diamond-filled"];
 /** A validated connection marker selection. */
@@ -271,17 +275,8 @@ export interface CompileSchematicOptions extends SchematicFence {
     idPrefix?: string;
     /** Markup and interaction budget for the generated SVG. */
     mode?: SchemdOutputMode;
-}
-/** Configuration accepted by the type-only Marked extension factory. */
-export interface SchematicMarkedOptions {
-    /** Accessible title used when the fence omits one. */
-    defaultTitle?: string;
-    /** Fixed output mode for every schemd fence in a Markdown pass. */
-    mode?: SchemdOutputMode;
-    /** Synchronous mode resolver for hosts with request-scoped rendering state. */
-    resolveMode?: () => SchemdOutputMode;
-    /** Optional safe fallback renderer for bounded syntax failures. */
-    onError?: (error: SchematicSyntaxError, source: string) => string;
+    /** Full-mode metadata to emit. Defaults to nodes, ports, and wires. */
+    semanticHooks?: readonly SchematicSemanticHook[];
 }
 /**
  * Deterministic syntax or geometry failure with optional source location.

package/dist/types.js

@@ -38,6 +38,7 @@ export const UML_RELATION_KINDS = [
     'extend'
 ];
 export const SCHEMD_OUTPUT_MODES = ['default', 'embedded-css', 'full'];
+export const SCHEMD_SEMANTIC_HOOKS = ['nodes', 'ports', 'wires'];
 export const SCHEMATIC_SIGNAL_MARKERS = [
     'none',
     'arrow',

package/dist/xml.d.ts

@@ -0,0 +1,6 @@
+/** Shared single-pass XML character-data escaping for generated SVG markup. */
+/**
+ * Replace XML-forbidden code points and escape XML-significant characters in
+ * one pass, avoiding the normalized copy plus five full-string replacements.
+ */
+export declare function escapeXml(value: string): string;

package/dist/xml.js

@@ -0,0 +1,38 @@
+function validXmlCodePoint(codePoint) {
+    if (codePoint === 0x09 || codePoint === 0x0a || codePoint === 0x0d)
+        return true;
+    if (codePoint >= 0x20 && codePoint <= 0xd7ff)
+        return true;
+    if (codePoint >= 0xe000 && codePoint <= 0xfffd)
+        return true;
+    return codePoint >= 0x10000 && codePoint <= 0x10ffff;
+}
+export function escapeXml(value) {
+    let escaped = '';
+    for (const character of value) {
+        if (!validXmlCodePoint(character.codePointAt(0))) {
+            escaped += '\ufffd';
+            continue;
+        }
+        switch (character) {
+            case '&':
+                escaped += '&amp;';
+                break;
+            case '<':
+                escaped += '&lt;';
+                break;
+            case '>':
+                escaped += '&gt;';
+                break;
+            case '"':
+                escaped += '&quot;';
+                break;
+            case "'":
+                escaped += '&#39;';
+                break;
+            default:
+                escaped += character;
+        }
+    }
+    return escaped;
+}

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@schemd/core",
-	"version": "0.1.2",
+	"version": "0.2.1",
 	"description": "Zero-dependency text-to-SVG compiler for schematics and UML.",
-	"homepage": "https://johnowolabiidogun.dev/tools/schemd/docs/overview",
+	"homepage": "https://johnowolabiidogun.dev/tools/schemd",
 	"bugs": {
 		"url": "https://github.com/Sirneij/schemd/issues"
 	},
@@ -17,7 +17,9 @@
 	"types": "./dist/index.d.ts",
 	"files": [
 		"dist",
-		"README.md"
+		"README.md",
+		"assets/brand/schemd-logo.svg",
+		"assets/brand/schemd-mark.svg"
 	],
 	"exports": {
 		".": {
@@ -32,6 +34,10 @@
 			"types": "./dist/renderer.d.ts",
 			"import": "./dist/renderer.js"
 		},
+		"./compiler": {
+			"types": "./dist/compiler.d.ts",
+			"import": "./dist/compiler.js"
+		},
 		"./layout": {
 			"types": "./dist/layout.d.ts",
 			"import": "./dist/layout.js"
@@ -40,10 +46,6 @@
 			"types": "./dist/math-label.d.ts",
 			"import": "./dist/math-label.js"
 		},
-		"./marked": {
-			"types": "./dist/marked-extension.d.ts",
-			"import": "./dist/marked-extension.js"
-		},
 		"./types": {
 			"types": "./dist/types.d.ts",
 			"import": "./dist/types.js"
@@ -53,21 +55,14 @@
 		"build": "node -e \"require('node:fs').rmSync('dist',{ recursive: true, force: true })\" && tsc -p tsconfig.build.json && tsc -p tsconfig.types.json",
 		"check": "tsc -p tsconfig.json --noEmit",
 		"prepack": "npm run build",
+		"size": "node scripts/check-bundle-size.mjs",
 		"test": "vitest run",
 		"test:coverage": "vitest run --coverage"
 	},
-	"peerDependencies": {
-		"marked": ">=17 <19"
-	},
-	"peerDependenciesMeta": {
-		"marked": {
-			"optional": true
-		}
-	},
 	"devDependencies": {
 		"@vitest/coverage-v8": "^4.1.10",
-		"marked": "^18.0.6",
 		"typescript": "^6.0.3",
+		"vite": "^8.1.4",
 		"vitest": "^4.1.10"
 	},
 	"engines": {
@@ -75,7 +70,6 @@
 	},
 	"keywords": [
 		"schemd",
-		"marked",
 		"schematic",
 		"svg",
 		"compiler",

package/dist/marked-extension.d.ts

@@ -1,23 +0,0 @@
-/**
- * Type-only Marked adapter for compiling fenced `schemd` diagrams during SSR.
- *
- * The module imports no Marked runtime. Its factory returns ordinary extension
- * hooks to a host-owned parser and enforces both per-diagram compiler ceilings
- * and cumulative limits across each Markdown document pass.
- *
- * @packageDocumentation
- */
-import type { MarkedExtension } from 'marked';
-import { type SchematicMarkedOptions } from './types.js';
-/**
- * Create a bounded Marked extension that compiles `schemd` fences into inline SVG.
- *
- * The returned extension keeps aggregate per-document budgets in closure state,
- * resets them from Marked's `preprocess` hook, and recognizes only the canonical
- * `schemd` language identifier.
- *
- * @param options - Output mode, accessible-title fallback, dynamic mode resolver,
- *   and trusted server-side diagnostic renderer.
- * @returns A Marked extension suitable for a server-owned `Marked` instance.
- */
-export declare function schematicMarkedExtension(options?: SchematicMarkedOptions): MarkedExtension;

package/dist/marked-extension.js

@@ -1,75 +0,0 @@
-import { MAX_SCHEMATIC_COMPONENTS, MAX_SCHEMATIC_CONNECTIONS, MAX_SCHEMATIC_SOURCE_CHARACTERS, MAX_SCHEMATIC_SVG_OUTPUT_BYTES, utf8ByteLength } from './limits.js';
-import { parseSchematic, parseSchematicFence } from './parser.js';
-import { renderSchematic } from './renderer.js';
-import { SchematicSyntaxError } from './types.js';
-class SchematicDocumentBudgetError extends SchematicSyntaxError {
-}
-function emptyDocumentBudget() {
-    return { sourceCharacters: 0, components: 0, connections: 0, svgOutputBytes: 0 };
-}
-function consumeBudget(used, amount, limit, unit) {
-    if (amount > limit - used) {
-        throw new SchematicDocumentBudgetError(`Schematic document exceeds the cumulative ${limit.toLocaleString('en-US')} ${unit} limit.`);
-    }
-    return used + amount;
-}
-function escapeHtml(value) {
-    return value
-        .replaceAll('&', '&')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;')
-        .replaceAll('"', '&quot;')
-        .replaceAll("'", '&#39;');
-}
-function defaultErrorRenderer(error, source) {
-    return `<figure class="schematic-error" role="group" aria-label="Schematic compilation error"><figcaption>${escapeHtml(error.message)}</figcaption><pre><code class="language-schemd">${escapeHtml(source)}</code></pre></figure>`;
-}
-export function schematicMarkedExtension(options = {}) {
-    let diagramIndex = 0;
-    let budget = emptyDocumentBudget();
-    let budgetError;
-    return {
-        hooks: {
-            preprocess(source) {
-                diagramIndex = 0;
-                budget = emptyDocumentBudget();
-                budgetError = undefined;
-                return source;
-            }
-        },
-        renderer: {
-            code(token) {
-                if (!token.lang || !/^schemd(?:\s|$)/i.test(token.lang.trim())) {
-                    return false;
-                }
-                try {
-                    if (budgetError)
-                        throw budgetError;
-                    budget.sourceCharacters = consumeBudget(budget.sourceCharacters, token.text.length, MAX_SCHEMATIC_SOURCE_CHARACTERS, 'schematic source character');
-                    const fence = parseSchematicFence(token.lang, options.defaultTitle);
-                    diagramIndex += 1;
-                    const document = parseSchematic(token.text, fence);
-                    const nextComponents = consumeBudget(budget.components, document.components.length, MAX_SCHEMATIC_COMPONENTS, 'component');
-                    const nextConnections = consumeBudget(budget.connections, document.connections.length, MAX_SCHEMATIC_CONNECTIONS, 'connection');
-                    const html = renderSchematic(document, {
-                        ...fence,
-                        idPrefix: `schematic-${diagramIndex}`,
-                        mode: options.resolveMode?.() ?? options.mode ?? 'default'
-                    });
-                    const nextSvgOutputBytes = consumeBudget(budget.svgOutputBytes, utf8ByteLength(html), MAX_SCHEMATIC_SVG_OUTPUT_BYTES, 'compiled SVG byte');
-                    budget.components = nextComponents;
-                    budget.connections = nextConnections;
-                    budget.svgOutputBytes = nextSvgOutputBytes;
-                    return html;
-                }
-                catch (error) {
-                    if (!(error instanceof SchematicSyntaxError))
-                        throw error;
-                    if (error instanceof SchematicDocumentBudgetError)
-                        budgetError = error;
-                    return (options.onError ?? defaultErrorRenderer)(error, token.text);
-                }
-            }
-        }
-    };
-}