@schemd/core 0.1.2 → 0.2.0

package/README.md

@@ -10,18 +10,18 @@ Schemd has no runtime dependencies, browser layout pass, or DOM requirement. It
 npm install @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 +29,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 +53,6 @@ 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.
+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.
 
 [Documentation](https://johnowolabiidogun.dev/tools/schemd/docs/overview) · [Issues](https://github.com/Sirneij/schemd/issues) · [MIT](https://github.com/Sirneij/schemd/blob/main/LICENSE)

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/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/renderer.js

@@ -1,12 +1,22 @@
 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 { CLASSICAL_GATE_KINDS, SCHEMD_OUTPUT_MODES, SCHEMD_SEMANTIC_HOOKS, UML_COMPONENT_KINDS, SchematicSyntaxError } from './types.js';
 import { mathLabelTextWidth, renderMathLabelTspans } from './math-label.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}}';
+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;
+}
 function validXmlCodePoint(codePoint) {
     if (codePoint === 0x09 || codePoint === 0x0a || codePoint === 0x0d)
         return true;
@@ -82,9 +92,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)));
@@ -516,19 +541,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 +561,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}" />`;
@@ -563,6 +587,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 +601,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 +614,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 +625,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/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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@schemd/core",
-	"version": "0.1.2",
+	"version": "0.2.0",
 	"description": "Zero-dependency text-to-SVG compiler for schematics and UML.",
 	"homepage": "https://johnowolabiidogun.dev/tools/schemd/docs/overview",
 	"bugs": {
@@ -32,6 +32,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 +44,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"
@@ -56,17 +56,8 @@
 		"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",
 		"vitest": "^4.1.10"
 	},
@@ -75,7 +66,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);
-                }
-            }
-        }
-    };
-}