@coral-viz/viz 0.2.3

package/dist/editor/converter.js

@@ -0,0 +1,256 @@
+/**
+ * Graph-IR to React Flow Converter
+ *
+ * Transforms Graph-IR nodes and edges to React Flow format.
+ */
+/**
+ * Default node dimensions by type
+ */
+const DEFAULT_DIMENSIONS = {
+    service: { width: 150, height: 50 },
+    database: { width: 120, height: 60 },
+    external_api: { width: 140, height: 50 },
+    actor: { width: 100, height: 100 },
+    module: { width: 120, height: 40 },
+    group: { width: 200, height: 150 },
+};
+/**
+ * Map Graph-IR node type to React Flow node type
+ */
+function mapNodeType(graphType) {
+    switch (graphType) {
+        case 'service':
+            return 'coralService';
+        case 'database':
+            return 'coralDatabase';
+        case 'external_api':
+            return 'coralExternalApi';
+        case 'actor':
+            return 'coralActor';
+        case 'module':
+            return 'coralModule';
+        case 'group':
+            return 'coralGroup';
+        default:
+            return 'coralService';
+    }
+}
+/**
+ * Convert a Graph-IR node to React Flow node
+ */
+export function convertNode(node, index, parentId) {
+    const dimensions = node.dimensions || DEFAULT_DIMENSIONS[node.type] || DEFAULT_DIMENSIONS.service;
+    const hasChildren = node.children && node.children.length > 0;
+    const data = {
+        label: node.label || node.id,
+        nodeType: node.type,
+        description: node.description,
+        properties: node.properties,
+        pinned: node.pinned,
+        symbolId: node.symbol,
+        variant: node.variant,
+        isGroup: hasChildren || node.type === 'group',
+        childCount: node.children?.length,
+        canonical: {
+            ...(node.symbol !== undefined ? { symbol: node.symbol } : {}),
+            ...(node.variant !== undefined ? { variant: node.variant } : {}),
+            ...(node.parent !== undefined ? { parent: node.parent } : {}),
+            ...(node.ports !== undefined ? { ports: node.ports } : {}),
+            ...(node.dimensions !== undefined ? { dimensions: node.dimensions } : {}),
+            ...(node.layoutOptions !== undefined ? { layoutOptions: node.layoutOptions } : {}),
+            ...(node.sourceInfo !== undefined ? { sourceInfo: node.sourceInfo } : {}),
+        },
+    };
+    const flowNode = {
+        id: node.id,
+        type: mapNodeType(node.type),
+        position: node.position || { x: index * 200, y: index * 100 },
+        draggable: !node.pinned,
+        data,
+        style: {
+            width: dimensions.width,
+            height: dimensions.height,
+        },
+    };
+    // If this node has a parent, set it
+    if (parentId) {
+        flowNode.parentId = parentId;
+        flowNode.extent = 'parent';
+    }
+    // For group nodes, mark as expandable
+    if (hasChildren) {
+        flowNode.style = {
+            ...flowNode.style,
+            width: Math.max(dimensions.width, 250),
+            height: Math.max(dimensions.height, 200),
+        };
+    }
+    return flowNode;
+}
+/**
+ * Flatten nested nodes for React Flow
+ * React Flow doesn't support deeply nested nodes well, so we flatten
+ * and use parentId for grouping
+ */
+export function flattenNodes(nodes) {
+    const result = [];
+    let index = 0;
+    function processNode(node, parentId) {
+        result.push(convertNode(node, index++, parentId));
+        if (node.children) {
+            for (const child of node.children) {
+                processNode(child, node.id);
+            }
+        }
+    }
+    for (const node of nodes) {
+        processNode(node);
+    }
+    return result;
+}
+/**
+ * Convert a Graph-IR edge to React Flow edge
+ */
+export function convertEdge(edge) {
+    const data = {
+        label: edge.label,
+        edgeType: edge.type,
+        properties: edge.properties,
+        lineStyle: edge.style?.lineStyle,
+        routingPoints: edge.routingPoints,
+        canonical: {
+            ...(edge.style !== undefined ? { style: edge.style } : {}),
+            ...(edge.sourceInfo !== undefined ? { sourceInfo: edge.sourceInfo } : {}),
+        },
+    };
+    const flowEdge = {
+        id: edge.id,
+        source: edge.source,
+        target: edge.target,
+        data,
+        label: edge.label,
+        type: 'smoothstep', // Default edge type
+    };
+    // Apply edge style
+    if (edge.style) {
+        flowEdge.style = {};
+        if (edge.style.lineStyle === 'dashed') {
+            flowEdge.style.strokeDasharray = '5,5';
+        }
+        else if (edge.style.lineStyle === 'dotted') {
+            flowEdge.style.strokeDasharray = '2,2';
+        }
+        if (edge.style.targetArrow === 'none') {
+            flowEdge.markerEnd = undefined;
+        }
+    }
+    // Handle source/target ports
+    if (edge.sourcePort) {
+        flowEdge.sourceHandle = edge.sourcePort;
+    }
+    if (edge.targetPort) {
+        flowEdge.targetHandle = edge.targetPort;
+    }
+    return flowEdge;
+}
+/**
+ * Convert entire Graph-IR to React Flow format
+ */
+export function convertGraphToFlow(graph) {
+    const nodes = flattenNodes(graph.nodes);
+    const edges = graph.edges.map(convertEdge);
+    return { nodes, edges };
+}
+/**
+ * Convert React Flow nodes back to Graph-IR nodes
+ * Used for bidirectional sync
+ */
+export function convertFlowToGraphNodes(flowNodes, originalNodes) {
+    // Build a map of original nodes for reference
+    const originalMap = new Map();
+    function mapOriginal(nodes) {
+        for (const node of nodes) {
+            originalMap.set(node.id, node);
+            if (node.children) {
+                mapOriginal(node.children);
+            }
+        }
+    }
+    mapOriginal(originalNodes);
+    // Build result maintaining hierarchy
+    const result = [];
+    const childMap = new Map();
+    // First pass: convert all nodes
+    for (const flowNode of flowNodes) {
+        const original = originalMap.get(flowNode.id);
+        const canonical = flowNode.data.canonical;
+        const graphNode = {
+            ...canonical,
+            id: flowNode.id,
+            type: flowNode.data.nodeType,
+            label: flowNode.data.label,
+            description: flowNode.data.description,
+            properties: flowNode.data.properties,
+            position: flowNode.position,
+            pinned: flowNode.data.pinned ?? original?.pinned,
+            dimensions: (typeof flowNode.width === 'number' && typeof flowNode.height === 'number')
+                ? { width: flowNode.width, height: flowNode.height }
+                : canonical?.dimensions,
+        };
+        if (flowNode.parentId) {
+            graphNode.parent = flowNode.parentId;
+            if (!childMap.has(flowNode.parentId)) {
+                childMap.set(flowNode.parentId, []);
+            }
+            childMap.get(flowNode.parentId).push(graphNode);
+        }
+        else {
+            result.push(graphNode);
+        }
+    }
+    // Second pass: attach children
+    function attachChildren(nodes) {
+        for (const node of nodes) {
+            const children = childMap.get(node.id);
+            if (children) {
+                node.children = children;
+                attachChildren(children);
+            }
+        }
+    }
+    attachChildren(result);
+    return result;
+}
+/**
+ * Convert React Flow edges back to Graph-IR edges
+ */
+export function convertFlowToGraphEdges(flowEdges) {
+    return flowEdges.map(flowEdge => {
+        const canonical = flowEdge.data?.canonical;
+        const graphEdge = {
+            ...canonical,
+            id: flowEdge.id,
+            source: flowEdge.source,
+            target: flowEdge.target,
+            label: flowEdge.data?.label,
+            type: flowEdge.data?.edgeType,
+            properties: flowEdge.data?.properties,
+            routingPoints: flowEdge.data?.routingPoints,
+        };
+        if (flowEdge.sourceHandle) {
+            graphEdge.sourcePort = flowEdge.sourceHandle;
+        }
+        if (flowEdge.targetHandle) {
+            graphEdge.targetPort = flowEdge.targetHandle;
+        }
+        const lineStyle = flowEdge.data?.lineStyle
+            ?? (flowEdge.style?.strokeDasharray
+                ? (String(flowEdge.style.strokeDasharray).includes('2') ? 'dotted' : 'dashed')
+                : undefined);
+        if (lineStyle || canonical?.style) {
+            graphEdge.style = { ...canonical?.style, ...(lineStyle ? { lineStyle } : {}) };
+        }
+        return graphEdge;
+    });
+}
+//# sourceMappingURL=converter.js.map

package/dist/editor/converter.js.map

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

package/dist/editor/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Coral Visual Editor
+ */
+export { CoralEditor, useGraphIR, type CoralEditorProps } from './CoralEditor.js';
+export { convertGraphToFlow, convertNode, convertEdge, flattenNodes, convertFlowToGraphNodes, convertFlowToGraphEdges, } from './converter.js';
+export { LayoutControls, type LayoutControlsProps } from './LayoutControls.js';
+export { FileControls, type FileControlsProps } from './FileControls.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/editor/index.js

@@ -0,0 +1,8 @@
+/**
+ * Coral Visual Editor
+ */
+export { CoralEditor, useGraphIR } from './CoralEditor.js';
+export { convertGraphToFlow, convertNode, convertEdge, flattenNodes, convertFlowToGraphNodes, convertFlowToGraphEdges, } from './converter.js';
+export { LayoutControls } from './LayoutControls.js';
+export { FileControls } from './FileControls.js';
+//# sourceMappingURL=index.js.map

package/dist/editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/editor/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC"}

package/dist/file/deserialize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Coral Document Deserialization (CORAL-REQ-008)
+ *
+ * Converts CoralDocument to React Flow nodes/edges.
+ */
+import type { CoralDocument, DeserializeResult } from './schema.js';
+/**
+ * Deserialize a CoralDocument to React Flow nodes and edges
+ *
+ * @param doc - CoralDocument to deserialize
+ * @returns Deserialized nodes, edges, settings, and metadata
+ * @throws Error if document is invalid
+ */
+export declare function deserialize(doc: CoralDocument): DeserializeResult;
+//# sourceMappingURL=deserialize.d.ts.map

package/dist/file/deserialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserialize.d.ts","sourceRoot":"","sources":["../../src/file/deserialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAuGlF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,iBAAiB,CAoDjE"}

package/dist/file/deserialize.js

@@ -0,0 +1,145 @@
+/**
+ * Coral Document Deserialization (CORAL-REQ-008)
+ *
+ * Converts CoralDocument to React Flow nodes/edges.
+ */
+import { assertValidDocument } from './validate.js';
+import { migrateDocument } from './migrate.js';
+/**
+ * Default position for nodes without positions
+ */
+const DEFAULT_POSITION = { x: 0, y: 0 };
+/**
+ * Convert a GraphNode to a CoralNode
+ */
+function graphNodeToNode(graphNode, positions) {
+    const position = positions[graphNode.id] ?? graphNode.position ?? DEFAULT_POSITION;
+    return {
+        id: graphNode.id,
+        type: graphNode.type,
+        position: { x: position.x, y: position.y },
+        parentId: graphNode.parent,
+        draggable: !graphNode.pinned,
+        data: {
+            label: graphNode.label ?? graphNode.id,
+            nodeType: graphNode.type,
+            description: graphNode.description,
+            properties: graphNode.properties,
+            pinned: graphNode.pinned,
+            symbolId: graphNode.symbol,
+            variant: graphNode.variant,
+            isGroup: graphNode.children && graphNode.children.length > 0,
+            childCount: graphNode.children?.length,
+            canonical: {
+                ...(graphNode.symbol !== undefined ? { symbol: graphNode.symbol } : {}),
+                ...(graphNode.variant !== undefined ? { variant: graphNode.variant } : {}),
+                ...(graphNode.parent !== undefined ? { parent: graphNode.parent } : {}),
+                ...(graphNode.ports !== undefined ? { ports: graphNode.ports } : {}),
+                ...(graphNode.dimensions !== undefined ? { dimensions: graphNode.dimensions } : {}),
+                ...(graphNode.layoutOptions !== undefined ? { layoutOptions: graphNode.layoutOptions } : {}),
+                ...(graphNode.sourceInfo !== undefined ? { sourceInfo: graphNode.sourceInfo } : {}),
+            },
+        },
+        ...(graphNode.dimensions && {
+            width: graphNode.dimensions.width,
+            height: graphNode.dimensions.height,
+        }),
+    };
+}
+/**
+ * Convert a GraphEdge to a CoralEdge
+ */
+function graphEdgeToEdge(graphEdge) {
+    return {
+        id: graphEdge.id,
+        source: graphEdge.source,
+        target: graphEdge.target,
+        sourceHandle: graphEdge.sourcePort ?? null,
+        targetHandle: graphEdge.targetPort ?? null,
+        type: graphEdge.style?.lineStyle === 'dashed' ? 'dashed' : undefined,
+        label: graphEdge.label,
+        data: {
+            label: graphEdge.label,
+            edgeType: graphEdge.type,
+            properties: graphEdge.properties,
+            lineStyle: graphEdge.style?.lineStyle,
+            routingPoints: graphEdge.routingPoints,
+            canonical: {
+                ...(graphEdge.style !== undefined ? { style: graphEdge.style } : {}),
+                ...(graphEdge.sourceInfo !== undefined ? { sourceInfo: graphEdge.sourceInfo } : {}),
+            },
+        },
+    };
+}
+/**
+ * Flatten nested nodes (Graph-IR can have children, React Flow uses parentId)
+ */
+function flattenGraphNodes(nodes) {
+    const result = [];
+    function traverse(node, parentId) {
+        result.push({
+            ...node,
+            parent: parentId ?? node.parent,
+        });
+        if (node.children) {
+            for (const child of node.children) {
+                traverse(child, node.id);
+            }
+        }
+    }
+    for (const node of nodes) {
+        traverse(node);
+    }
+    return result;
+}
+/**
+ * Deserialize a CoralDocument to React Flow nodes and edges
+ *
+ * @param doc - CoralDocument to deserialize
+ * @returns Deserialized nodes, edges, settings, and metadata
+ * @throws Error if document is invalid
+ */
+export function deserialize(doc) {
+    // Migrate to current version if needed
+    const migratedDoc = migrateDocument(doc);
+    // Validate the document
+    assertValidDocument(migratedDoc);
+    // Extract positions map
+    const positions = migratedDoc.nodePositions ?? {};
+    // Get nodes and edges from Graph-IR content
+    let nodes = [];
+    let edges = [];
+    if (migratedDoc.content.format === 'graph-ir' && migratedDoc.content.graphIR) {
+        const graphIR = migratedDoc.content.graphIR;
+        // Flatten nested nodes
+        const flatNodes = flattenGraphNodes(graphIR.nodes);
+        // Convert to React Flow format
+        nodes = flatNodes.map((n) => graphNodeToNode(n, positions));
+        edges = graphIR.edges.map(graphEdgeToEdge);
+    }
+    // Restore waypoints from pinned edge routing (CORAL-REQ-015)
+    let edgeWaypoints;
+    if (migratedDoc.edgeRouting) {
+        for (const [edgeId, routing] of Object.entries(migratedDoc.edgeRouting)) {
+            if (routing.isPinned && routing.waypoints && routing.waypoints.length > 0) {
+                if (!edgeWaypoints)
+                    edgeWaypoints = new Map();
+                edgeWaypoints.set(edgeId, routing.waypoints.map((wp) => ({
+                    id: wp.id,
+                    x: wp.x,
+                    y: wp.y,
+                    type: wp.type,
+                })));
+            }
+        }
+    }
+    return {
+        nodes,
+        edges,
+        settings: migratedDoc.settings,
+        viewState: migratedDoc.viewState,
+        metadata: migratedDoc.metadata,
+        edgeWaypoints,
+    };
+}
+//# sourceMappingURL=deserialize.js.map

package/dist/file/deserialize.js.map

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

package/dist/file/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Coral File Format (CORAL-REQ-008)
+ *
+ * Exports for CoralDocument handling:
+ * - Schema types
+ * - Validation
+ * - Serialization/Deserialization
+ * - Migration
+ */
+export { CURRENT_SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, type CoralDocument, type DocumentMetadata, type DocumentContent, type DocumentSettings, type LayoutDirection, type LayoutSettings, type LayoutSpacing, type ViewState, type NodePosition, type DslType, type CreateDocumentOptions, type SerializeOptions, type DeserializeResult, type ValidationResult, type EdgeRouting, type LayoutAlgorithm, type LayoutPresetId, type LayoutPreset, type UserPreferences, type LLMProviderPreference, type SpeechRecognitionMode, type SettingsPanelState, DEFAULT_USER_PREFERENCES, DEFAULT_LAYOUT_SETTINGS, LAYOUT_PRESETS, getLayoutPreset, } from './schema.js';
+export { validateDocument, assertValidDocument } from './validate.js';
+export { createDocument, serialize } from './serialize.js';
+export { deserialize } from './deserialize.js';
+export { migrateDocument, needsMigration, getMigrationSteps } from './migrate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/file/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAErB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/file/index.js

@@ -0,0 +1,20 @@
+/**
+ * Coral File Format (CORAL-REQ-008)
+ *
+ * Exports for CoralDocument handling:
+ * - Schema types
+ * - Validation
+ * - Serialization/Deserialization
+ * - Migration
+ */
+// Schema
+export { CURRENT_SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS, DEFAULT_USER_PREFERENCES, DEFAULT_LAYOUT_SETTINGS, LAYOUT_PRESETS, getLayoutPreset, } from './schema.js';
+// Validation
+export { validateDocument, assertValidDocument } from './validate.js';
+// Serialization
+export { createDocument, serialize } from './serialize.js';
+// Deserialization
+export { deserialize } from './deserialize.js';
+// Migration
+export { migrateDocument, needsMigration, getMigrationSteps } from './migrate.js';
+//# sourceMappingURL=index.js.map

package/dist/file/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,SAAS;AACT,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EAwBzB,wBAAwB,EACxB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEtE,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/file/migrate.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Coral Document Migration (CORAL-REQ-008)
+ *
+ * Handles schema version upgrades for backward compatibility.
+ */
+import type { CoralDocument } from './schema.js';
+/**
+ * Migrate a document to the current schema version
+ *
+ * @param doc - Document to migrate (may be older version)
+ * @returns Migrated document at current version
+ * @throws Error if document has unknown schema version
+ */
+export declare function migrateDocument(doc: CoralDocument): CoralDocument;
+/**
+ * Check if a document needs migration
+ *
+ * @param doc - Document to check
+ * @returns true if document needs migration
+ */
+export declare function needsMigration(doc: CoralDocument): boolean;
+/**
+ * Get the migration path for a document
+ *
+ * @param doc - Document to check
+ * @returns Array of migration steps, empty if no migration needed
+ */
+export declare function getMigrationSteps(doc: CoralDocument): string[];
+//# sourceMappingURL=migrate.d.ts.map

package/dist/file/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/file/migrate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA6DjD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,aAAa,CAkCjE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE,CAE9D"}

package/dist/file/migrate.js

@@ -0,0 +1,103 @@
+/**
+ * Coral Document Migration (CORAL-REQ-008)
+ *
+ * Handles schema version upgrades for backward compatibility.
+ */
+import { CURRENT_SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSIONS } from './schema.js';
+/**
+ * Migration registry: maps "fromVersion→toVersion" to migration function
+ */
+const migrations = {
+    /**
+     * Migrate from 0.9.0 to 1.0.0
+     *
+     * Changes:
+     * - Added optional viewState.fitView field
+     * - Added optional settings.layout.elkOptions field
+     */
+    '0.9.0→1.0.0': (doc) => {
+        const d = doc;
+        return {
+            ...d,
+            schemaVersion: '1.0.0',
+        };
+    },
+};
+/**
+ * Get the migration path from one version to another
+ */
+function getMigrationPath(fromVersion, toVersion) {
+    const path = [];
+    const versionIndex = new Map(SUPPORTED_SCHEMA_VERSIONS.map((v, i) => [v, i]));
+    const fromIdx = versionIndex.get(fromVersion);
+    const toIdx = versionIndex.get(toVersion);
+    if (fromIdx === undefined || toIdx === undefined) {
+        return [];
+    }
+    // Build migration path
+    for (let i = fromIdx; i < toIdx; i++) {
+        const from = SUPPORTED_SCHEMA_VERSIONS[i];
+        const to = SUPPORTED_SCHEMA_VERSIONS[i + 1];
+        path.push(`${from}→${to}`);
+    }
+    return path;
+}
+/**
+ * Check if a schema version is known
+ */
+function isKnownVersion(version) {
+    return SUPPORTED_SCHEMA_VERSIONS.includes(version);
+}
+/**
+ * Migrate a document to the current schema version
+ *
+ * @param doc - Document to migrate (may be older version)
+ * @returns Migrated document at current version
+ * @throws Error if document has unknown schema version
+ */
+export function migrateDocument(doc) {
+    const currentVersion = doc.schemaVersion;
+    // Already at current version
+    if (currentVersion === CURRENT_SCHEMA_VERSION) {
+        return doc;
+    }
+    // 1.0 was emitted briefly before semantic-version normalization.
+    if (currentVersion === '1.0') {
+        return { ...doc, schemaVersion: CURRENT_SCHEMA_VERSION };
+    }
+    // Check if version is known
+    if (!isKnownVersion(currentVersion)) {
+        throw new Error(`Unknown schema version: ${currentVersion}. ` +
+            `Supported versions: ${SUPPORTED_SCHEMA_VERSIONS.join(', ')}`);
+    }
+    // Get migration path
+    const path = getMigrationPath(currentVersion, CURRENT_SCHEMA_VERSION);
+    // Apply migrations in sequence
+    let result = doc;
+    for (const step of path) {
+        const migrateFn = migrations[step];
+        if (migrateFn) {
+            result = migrateFn(result);
+        }
+    }
+    return result;
+}
+/**
+ * Check if a document needs migration
+ *
+ * @param doc - Document to check
+ * @returns true if document needs migration
+ */
+export function needsMigration(doc) {
+    return doc.schemaVersion !== CURRENT_SCHEMA_VERSION;
+}
+/**
+ * Get the migration path for a document
+ *
+ * @param doc - Document to check
+ * @returns Array of migration steps, empty if no migration needed
+ */
+export function getMigrationSteps(doc) {
+    return getMigrationPath(doc.schemaVersion, CURRENT_SCHEMA_VERSION);
+}
+//# sourceMappingURL=migrate.js.map

package/dist/file/migrate.js.map

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