@coral-viz/language 0.2.3

package/dist/printer/index.js

@@ -0,0 +1,392 @@
+/**
+ * Coral DSL Printer
+ *
+ * Converts Graph-IR back to Coral DSL text.
+ * Enables roundtrip: DSL → IR → DSL
+ */
+import { printDiagnostic } from '../diagnostics.js';
+import { escapeString, quoteIfNeeded } from '../strings.js';
+import { IdAllocator } from '../ids.js';
+/** Discards everything, so `print` allocates nothing per node or edge. */
+const NULL_SINK = { push() { } };
+/** Node fields with no Coral spelling, reported rather than dropped in silence. */
+/** Coordinates print to at most two decimal places, so the loop settles. */
+function formatCoord(value) {
+    return String(Number(value.toFixed(2)));
+}
+/** True when a property value has a Coral spelling. */
+export function isPrintableScalar(value) {
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return true;
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    return false;
+}
+const UNPRINTABLE_NODE_FIELDS = [
+    'dimensions', 'description', 'layoutOptions',
+    'symbol', 'variant', 'ports',
+];
+/** Edge fields with no Coral spelling. */
+const UNPRINTABLE_EDGE_FIELDS = [
+    ['sourcePort', 'source-port'],
+    ['targetPort', 'target-port'],
+    ['description', 'description'],
+];
+/** Report the node's own unprintable fields. Called by printNode, which owns the walk. */
+function reportNodeFieldLoss(node, out) {
+    const bag = node;
+    for (const field of UNPRINTABLE_NODE_FIELDS) {
+        if (bag[field] !== undefined) {
+            out.push(printDiagnostic({
+                severity: 'warning',
+                code: `coral.node.${field.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase())}.dropped`,
+                message: `Node "${node.id}" carries ${field}, which the Coral surface cannot express`,
+                subject: { kind: 'node', id: node.id },
+            }));
+        }
+    }
+    for (const [key, value] of Object.entries(node.properties ?? {})) {
+        collectPropertyLoss('node', node.id, key, value, out);
+    }
+}
+function collectPropertyLoss(kind, id, key, value, out) {
+    if (key.startsWith('_')) {
+        out.push(printDiagnostic({
+            severity: 'info',
+            code: `coral.${kind}.reserved-property.dropped`,
+            message: `Property "${key}" on ${kind} "${id}" is reserved for internal use and is not emitted`,
+            subject: { kind, id },
+        }));
+        return;
+    }
+    if (value == null)
+        return;
+    if (typeof value === 'number' && !Number.isFinite(value)) {
+        out.push(printDiagnostic({
+            severity: 'warning',
+            code: `coral.${kind}.property.dropped`,
+            message: `Property "${key}" on ${kind} "${id}" is not a finite number and is not emitted`,
+            subject: { kind, id },
+        }));
+        return;
+    }
+    if (!['string', 'number', 'boolean'].includes(typeof value)) {
+        out.push(printDiagnostic({
+            severity: 'warning',
+            code: `coral.${kind}.property.dropped`,
+            message: `Property "${key}" on ${kind} "${id}" is not a scalar and is not emitted`,
+            subject: { kind, id },
+        }));
+    }
+}
+/** Report the edge's unprintable fields. Called by printEdge. */
+function reportEdgeFieldLoss(edge, out) {
+    const bag = edge;
+    // Edge ids are re-derived from endpoints on parse and cannot survive (R-010).
+    out.push(printDiagnostic({
+        severity: 'info',
+        code: 'coral.edge.id.dropped',
+        message: `Edge id "${edge.id}" is not emitted; it is re-derived from its endpoints on parse`,
+        subject: { kind: 'edge', id: edge.id },
+    }));
+    for (const [field, slug] of UNPRINTABLE_EDGE_FIELDS) {
+        if (bag[field] !== undefined) {
+            out.push(printDiagnostic({
+                severity: 'warning',
+                code: `coral.edge.${slug}.dropped`,
+                message: `Edge "${edge.id}" carries ${field}, which the Coral surface cannot express`,
+                subject: { kind: 'edge', id: edge.id },
+            }));
+        }
+    }
+    // Only lineStyle has a Coral spelling; the rest of EdgeStyle does not.
+    for (const key of ['sourceArrow', 'targetArrow', 'routing']) {
+        if (edge.style?.[key] !== undefined) {
+            out.push(printDiagnostic({
+                severity: 'warning',
+                code: `coral.edge.style-${key.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase())}.dropped`,
+                message: `Edge "${edge.id}" carries style.${key}, which the Coral surface cannot express`,
+                subject: { kind: 'edge', id: edge.id },
+            }));
+        }
+    }
+    for (const [key, value] of Object.entries(edge.properties ?? {})) {
+        collectPropertyLoss('edge', edge.id, key, value, out);
+    }
+}
+function reportGraphFieldLoss(graph, out) {
+    const bag = graph;
+    for (const field of ['id', 'name', 'metadata', 'layoutOptions']) {
+        if (bag[field] !== undefined) {
+            out.push(printDiagnostic({
+                severity: 'info',
+                code: `coral.graph.${field.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase())}.dropped`,
+                message: `Graph ${field} is not emitted; the Coral surface has no spelling for it`,
+                subject: { kind: 'graph', id: graph.id },
+            }));
+        }
+    }
+}
+/**
+ * Print Graph-IR to Coral DSL text, reporting everything the surface cannot
+ * carry.
+ *
+ * `print` keeps its bare-string signature for existing consumers; this is the
+ * variant the editor uses.
+ */
+export function printWithDiagnostics(graph, options = {}) {
+    const diagnostics = [];
+    const text = renderGraph(graph, options, diagnostics);
+    return { text, diagnostics };
+}
+/** The single traversal that both emits text and records what it declined to emit. */
+function renderGraph(graph, options, diagnostics) {
+    const { indent = '  ' } = options;
+    const lines = [];
+    reportGraphFieldLoss(graph, diagnostics);
+    // Make the input safe for the replay: unique, non-empty ids, with edges
+    // rewritten to follow (R-010 AC-2, AC-3).
+    const safe = normaliseIds(graph, diagnostics);
+    graph = safe;
+    // Decide which nodes need an explicit `as` clause.
+    const explicit = markExplicitIds(graph);
+    // Top-level nodes only; printNode recurses into children and reports as it goes.
+    for (const node of graph.nodes) {
+        printNode(node, lines, 0, indent, diagnostics, explicit);
+    }
+    if (graph.nodes.length > 0 && graph.edges.length > 0) {
+        lines.push('');
+    }
+    for (const edge of graph.edges) {
+        lines.push(printEdge(edge, diagnostics));
+    }
+    return lines.join('\n');
+}
+/**
+ * Print Graph-IR to Coral DSL text
+ */
+export function print(graph, options = {}) {
+    return renderGraph(graph, options, NULL_SINK);
+}
+/** The label text the printer will actually emit for a node. */
+function emittedLabel(node) {
+    return node.label !== undefined ? node.label : node.id;
+}
+/** Every node, in declaration order, children included. */
+function inDeclarationOrder(nodes) {
+    const out = [];
+    const walk = (list) => {
+        for (const n of list) {
+            out.push(n);
+            if (n.children)
+                walk(n.children);
+        }
+    };
+    walk(nodes);
+    return out;
+}
+/**
+ * Give every node a unique, non-empty id before the replay runs, rewriting the
+ * edges that referenced a substituted id (R-010 AC-2, AC-3).
+ *
+ * Returns the original graph untouched when nothing needed changing, so the
+ * common path allocates nothing.
+ */
+function normaliseIds(graph, out) {
+    const seen = new Set();
+    const substitutions = new Map();
+    const pool = new IdAllocator();
+    // Seed with every id that is already unique and usable, so the pre-pass does
+    // not hand a later node an id an untouched node is holding.
+    for (const node of inDeclarationOrder(graph.nodes)) {
+        if (node.id !== '' && !seen.has(node.id)) {
+            seen.add(node.id);
+            pool.reserve(node.id);
+        }
+    }
+    const taken = new Set();
+    const rewrite = new Map();
+    for (const node of inDeclarationOrder(graph.nodes)) {
+        if (node.id !== '' && !taken.has(node.id)) {
+            taken.add(node.id);
+            continue;
+        }
+        const replacement = pool.allocateFromLabel(emittedLabel(node));
+        rewrite.set(node, replacement);
+        taken.add(replacement);
+        // Only an empty id is orphaned. A duplicate id is still held by the
+        // earlier node, which keeps it, so edges must continue to resolve there
+        // (R-010 AC-3) and must not be rewritten to the renamed occurrence.
+        if (node.id === '' && !substitutions.has(''))
+            substitutions.set('', replacement);
+        out.push(printDiagnostic({
+            severity: 'warning',
+            code: 'coral.node.id.degraded',
+            message: node.id === ''
+                ? `A node had an empty id, which Coral cannot express; it was given "${replacement}"`
+                : `Node id "${node.id}" was used more than once; one occurrence was given "${replacement}"`,
+            subject: { kind: 'node', id: replacement },
+        }));
+    }
+    if (rewrite.size === 0)
+        return graph;
+    const cloneNode = (node) => ({
+        ...node,
+        id: rewrite.get(node) ?? node.id,
+        ...(node.children ? { children: node.children.map(cloneNode) } : {}),
+    });
+    return {
+        ...graph,
+        nodes: graph.nodes.map(cloneNode),
+        edges: graph.edges.map((edge) => ({
+            ...edge,
+            source: substitutions.get(edge.source) ?? edge.source,
+            target: substitutions.get(edge.target) ?? edge.target,
+        })),
+    };
+}
+/**
+ * Decide which nodes need an explicit `as` clause.
+ *
+ * One forward pass in declaration order, applying each decision immediately: a
+ * node whose allocated id matches keeps it, otherwise the speculative id is
+ * released so a later node may still receive it, and `node.id` is reserved.
+ * Deciding every node before applying any of them over-annotates, because
+ * marking one node explicit changes what a later node is allocated.
+ */
+function markExplicitIds(graph) {
+    const allocator = new IdAllocator();
+    const explicit = new Set();
+    for (const node of inDeclarationOrder(graph.nodes)) {
+        const allocated = allocator.allocateFromLabel(emittedLabel(node));
+        if (allocated === node.id)
+            continue;
+        allocator.release(allocated);
+        allocator.reserve(node.id);
+        explicit.add(node.id);
+    }
+    return explicit;
+}
+/**
+ * Print a single node and its children
+ */
+function printNode(node, lines, depth, indent, out, explicit) {
+    reportNodeFieldLoss(node, out);
+    const prefix = indent.repeat(depth);
+    const nodeType = node.type || 'service';
+    const emitted = emittedLabel(node);
+    const label = escapeString(emitted);
+    const idClause = explicit.has(node.id) ? ` as ${quoteIfNeeded(node.id)}` : '';
+    const geometry = node.position
+        ? ` @ (${formatCoord(node.position.x)}, ${formatCoord(node.position.y)})`
+        : '';
+    const pinned = node.pinned ? ' pinned' : '';
+    // Check if node has body content (children or printable properties)
+    const hasChildren = node.children && node.children.length > 0;
+    const hasProperties = node.properties && Object.entries(node.properties).some(([key, value]) => !key.startsWith('_') && value != null && isPrintableScalar(value));
+    const hasBody = hasChildren || hasProperties;
+    if (hasBody) {
+        lines.push(`${prefix}${nodeType} "${label}"${idClause}${geometry}${pinned} {`);
+        // Print properties first
+        if (hasProperties) {
+            for (const [key, value] of Object.entries(node.properties)) {
+                // Skip internal properties
+                if (key.startsWith('_'))
+                    continue;
+                // Skip null/undefined
+                if (value == null)
+                    continue;
+                if (!isPrintableScalar(value))
+                    continue;
+                if (typeof value === 'string') {
+                    lines.push(`${prefix}${indent}${quoteIfNeeded(key)}: "${escapeString(value)}"`);
+                }
+                else {
+                    lines.push(`${prefix}${indent}${quoteIfNeeded(key)}: ${value}`);
+                }
+            }
+        }
+        // Print children
+        if (hasChildren) {
+            for (const child of node.children) {
+                printNode(child, lines, depth + 1, indent, out, explicit);
+            }
+        }
+        lines.push(`${prefix}}`);
+    }
+    else {
+        lines.push(`${prefix}${nodeType} "${label}"${idClause}${geometry}${pinned}`);
+    }
+}
+/**
+ * Print a single edge
+ */
+function printEdge(edge, out) {
+    reportEdgeFieldLoss(edge, out);
+    const parts = [`${quoteIfNeeded(edge.source)} -> ${quoteIfNeeded(edge.target)}`];
+    // Build attributes
+    const attrs = [];
+    if (edge.type) {
+        // A bare leading token that spells a line style would be misread as one,
+        // so it is quoted; a quoted leading token is always the relation type.
+        const ambiguous = ['solid', 'dashed', 'dotted'].includes(edge.type);
+        attrs.push(ambiguous || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(edge.type)
+            ? `"${escapeString(edge.type)}"`
+            : edge.type);
+    }
+    // `solid` is emitted like any other style so it survives the round-trip.
+    if (edge.style?.lineStyle) {
+        attrs.push(edge.style.lineStyle);
+    }
+    if (edge.label !== undefined) {
+        attrs.push(`label: "${escapeString(edge.label)}"`);
+    }
+    // Add other properties as attributes (sorted for deterministic output)
+    if (edge.properties) {
+        const sortedKeys = Object.keys(edge.properties).sort();
+        for (const key of sortedKeys) {
+            const value = edge.properties[key];
+            if (key === 'label')
+                continue; // Already handled
+            // Reserved for internal use; omitted on both sides (R-009 AC-7).
+            if (key.startsWith('_'))
+                continue;
+            if (value == null)
+                continue;
+            if (!isPrintableScalar(value))
+                continue;
+            if (typeof value === 'string') {
+                attrs.push(`${quoteIfNeeded(key)}: "${escapeString(value)}"`);
+            }
+            else {
+                attrs.push(`${quoteIfNeeded(key)}: ${value}`);
+            }
+        }
+    }
+    if (attrs.length > 0) {
+        parts.push(`[${attrs.join(', ')}]`);
+    }
+    if (edge.routingPoints && edge.routingPoints.length > 0) {
+        parts.push(`via ${edge.routingPoints
+            .map((p) => `(${formatCoord(p.x)}, ${formatCoord(p.y)})`)
+            .join(' ')}`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Pretty print with additional formatting options
+ */
+export function prettyPrint(graph, options = {}) {
+    const { sortByType = false, ...printOptions } = options;
+    let nodes = [...graph.nodes];
+    if (sortByType) {
+        const typeOrder = ['actor', 'service', 'module', 'database', 'external_api', 'group'];
+        nodes.sort((a, b) => {
+            const aIndex = typeOrder.indexOf(a.type || 'service');
+            const bIndex = typeOrder.indexOf(b.type || 'service');
+            return aIndex - bIndex;
+        });
+    }
+    return print({ ...graph, nodes }, printOptions);
+}
+//# sourceMappingURL=index.js.map

package/dist/printer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/printer/index.ts"],"names":[],"mappings":"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"}

package/dist/strings.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Quoting (R-009).
+ *
+ * One escaper and one unescaper, inverse over the characters Coral quotes.
+ * Every quoted position — node label, property value, edge attribute and the
+ * id spellings — is written by the first and read by the second, so a string
+ * survives any number of round-trips rather than growing a backslash on each.
+ */
+/** Escape the characters that cannot appear raw inside a Coral quoted string. */
+export declare function escapeString(str: string): string;
+/** Reverse {@link escapeString}. */
+export declare function unescapeString(str: string): string;
+/** A bare identifier needs no quoting; anything else does. */
+export declare const BARE_IDENTIFIER: RegExp;
+/** Emit an id or key bare when it can be, quoted when it cannot. */
+export declare function quoteIfNeeded(value: string): string;
+//# sourceMappingURL=strings.d.ts.map

package/dist/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBlD;AAED,8DAA8D;AAC9D,eAAO,MAAM,eAAe,QAA6B,CAAC;AAE1D,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/strings.js

@@ -0,0 +1,48 @@
+/**
+ * Quoting (R-009).
+ *
+ * One escaper and one unescaper, inverse over the characters Coral quotes.
+ * Every quoted position — node label, property value, edge attribute and the
+ * id spellings — is written by the first and read by the second, so a string
+ * survives any number of round-trips rather than growing a backslash on each.
+ */
+/** Escape the characters that cannot appear raw inside a Coral quoted string. */
+export function escapeString(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/** Reverse {@link escapeString}. */
+export function unescapeString(str) {
+    let out = '';
+    for (let i = 0; i < str.length; i++) {
+        if (str[i] !== '\\' || i + 1 >= str.length) {
+            out += str[i];
+            continue;
+        }
+        const next = str[++i];
+        if (next === 'n')
+            out += '\n';
+        else if (next === 'r')
+            out += '\r';
+        else if (next === 't')
+            out += '\t';
+        else if (next === '"')
+            out += '"';
+        else if (next === '\\')
+            out += '\\';
+        else
+            out += next;
+    }
+    return out;
+}
+/** A bare identifier needs no quoting; anything else does. */
+export const BARE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Emit an id or key bare when it can be, quoted when it cannot. */
+export function quoteIfNeeded(value) {
+    return BARE_IDENTIFIER.test(value) ? value : `"${escapeString(value)}"`;
+}
+//# sourceMappingURL=strings.js.map

package/dist/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC3C,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,GAAG;YAAE,GAAG,IAAI,IAAI,CAAC;aACzB,IAAI,IAAI,KAAK,GAAG;YAAE,GAAG,IAAI,IAAI,CAAC;aAC9B,IAAI,IAAI,KAAK,GAAG;YAAE,GAAG,IAAI,IAAI,CAAC;aAC9B,IAAI,IAAI,KAAK,GAAG;YAAE,GAAG,IAAI,GAAG,CAAC;aAC7B,IAAI,IAAI,KAAK,IAAI;YAAE,GAAG,IAAI,IAAI,CAAC;;YAC/B,GAAG,IAAI,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAE1D,oEAAoE;AACpE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC;AAC1E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+/** Canonical Graph-IR types are owned by @graph-ir/core. */
+import type { GraphIR } from '@graph-ir/core';
+import type { ParseDiagnostic } from './diagnostics.js';
+export type { GraphIR, GraphNode, GraphEdge, Port, PortSide, Dimensions, Position, EdgeStyle, LayoutOptions, SpacingOptions, NodeLayoutOptions, GraphMetadata, SourceInfo, SourceRange, Comment, } from '@graph-ir/core';
+/**
+ * Parser options
+ */
+export interface ParseOptions {
+    /** Include source info for roundtripping */
+    includeSourceInfo?: boolean;
+    /** Graph ID (defaults to 'coral-graph') */
+    graphId?: string;
+    /** Graph name */
+    graphName?: string;
+}
+/**
+ * Parse result
+ */
+export interface ParseResult {
+    success: boolean;
+    /**
+     * Best-effort graph. Populated even when `success` is false, so one bad line
+     * does not discard everything that parsed (R-009 AC-8).
+     */
+    graph?: GraphIR;
+    /**
+     * The error-severity view of `diagnostics`: element-identical, same order,
+     * frozen. Derived by the builder, never accumulated in parallel (R-011 AC-2).
+     */
+    errors: ParseError[];
+    /** Every diagnostic, at every severity (R-011). */
+    diagnostics: ParseDiagnostic[];
+}
+export interface ParseError {
+    message: string;
+    line: number;
+    column: number;
+    offset: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,YAAY,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,WAAW,EACX,OAAO,GACR,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,mDAAmD;IACnD,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@coral-viz/language",
+  "version": "0.2.3",
+  "description": "Coral DSL parser and printer",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coreyt/coral.git",
+    "directory": "packages/language"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./parser": {
+      "types": "./dist/parser/index.d.ts",
+      "import": "./dist/parser/index.js"
+    },
+    "./printer": {
+      "types": "./dist/printer/index.d.ts",
+      "import": "./dist/printer/index.js"
+    },
+    "./formats": {
+      "types": "./dist/formats/index.d.ts",
+      "import": "./dist/formats/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/clean.mjs dist && tsc",
+    "prepack": "npm run build",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@graph-ir/core": "0.2.0"
+  },
+  "optionalDependencies": {
+    "tree-sitter": "0.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "@vitest/coverage-v8": "5.0.0",
+    "typescript": "6.0.3",
+    "vitest": "5.0.0"
+  },
+  "engines": {
+    "node": ">=24.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}