@coral-viz/viz 0.2.3

package/dist/file/schema.d.ts

@@ -0,0 +1,385 @@
+/**
+ * Coral Document Schema (CORAL-REQ-008)
+ *
+ * Defines the TypeScript types for the Coral file format.
+ * File extension: .coral.json
+ */
+import type { GraphIR, SizingMode } from '../types.js';
+/**
+ * Current schema version. Increment when making breaking changes.
+ */
+export declare const CURRENT_SCHEMA_VERSION = "1.0.0";
+/**
+ * Supported schema versions for migration
+ */
+export declare const SUPPORTED_SCHEMA_VERSIONS: readonly ["0.9.0", "1.0.0", "1.0"];
+/**
+ * Document metadata
+ */
+export interface DocumentMetadata {
+    /** Document name (required) */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Optional tags for organization */
+    tags?: string[];
+    /** User-defined document version */
+    version?: string;
+    /** ISO 8601 timestamp of creation */
+    created: string;
+    /** ISO 8601 timestamp of last modification */
+    modified: string;
+}
+/**
+ * Layout direction options
+ */
+export type LayoutDirection = 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
+/**
+ * Layout spacing options
+ */
+export interface LayoutSpacing {
+    /** Spacing between nodes */
+    nodeNode?: number;
+    /** Spacing between edges and nodes */
+    edgeNode?: number;
+    /** Spacing between layers (for layered algorithm) */
+    layerSpacing?: number;
+}
+/**
+ * Layout configuration
+ */
+export interface LayoutSettings {
+    /** Layout algorithm (e.g., 'layered', 'stress', 'force') */
+    algorithm: string;
+    /** Layout direction */
+    direction: LayoutDirection;
+    /** Spacing options */
+    spacing?: LayoutSpacing;
+    /** Additional ELK options as key-value pairs */
+    elkOptions?: Record<string, string | number | boolean>;
+    /** Node sizing mode (CORAL-REQ-011) */
+    sizingMode?: SizingMode;
+}
+/**
+ * Document settings (saved with file)
+ */
+export interface DocumentSettings {
+    /** Notation type (e.g., 'flowchart', 'bpmn', 'erd') */
+    notation: string;
+    /** Layout configuration */
+    layout: LayoutSettings;
+    /** Font settings (CORAL-REQ-012) */
+    font?: DiagramFontSettings;
+    /** Suppress error annotations on edges (issues still appear in diagnostics log) */
+    suppressErrorAnnotations?: boolean;
+    /** Suppress warning annotations on edges (issues still appear in diagnostics log) */
+    suppressWarningAnnotations?: boolean;
+}
+/**
+ * View state for restoring exact view
+ */
+export interface ViewState {
+    /** Zoom level */
+    zoom: number;
+    /** Pan offset */
+    pan: {
+        x: number;
+        y: number;
+    };
+    /** Currently selected node IDs */
+    selectedNodes?: string[];
+    /** If true, fit view on load instead of using zoom/pan */
+    fitView?: boolean;
+}
+/**
+ * Node position
+ */
+export interface NodePosition {
+    x: number;
+    y: number;
+}
+/**
+ * DSL content type
+ */
+export type DslType = 'coral' | 'mermaid' | 'dot';
+/**
+ * Document content - either DSL text or Graph-IR
+ */
+export interface DocumentContent {
+    /** Content format */
+    format: 'dsl' | 'graph-ir';
+    /** DSL type if format is 'dsl' */
+    dslType?: DslType;
+    /** DSL text if format is 'dsl' */
+    text?: string;
+    /** Graph-IR if format is 'graph-ir' */
+    graphIR?: GraphIR;
+}
+/**
+ * Saved waypoint data for manual edge routing (CORAL-REQ-015)
+ */
+export interface SavedWaypoint {
+    id: string;
+    x: number;
+    y: number;
+    type: string;
+}
+/**
+ * Saved edge routing data (ELK-compatible bend points)
+ */
+export interface EdgeRoutingData {
+    /** Bend point coordinates */
+    bendPoints: NodePosition[];
+    /** Whether this routing was user-pinned (vs computed) */
+    isPinned: boolean;
+    /** User-placed waypoints (CORAL-REQ-015) — present when isPinned is true */
+    waypoints?: SavedWaypoint[];
+}
+/**
+ * Coral Document - the complete file format
+ */
+export interface CoralDocument {
+    /** Schema version for migrations */
+    schemaVersion: string;
+    /** Document metadata */
+    metadata: DocumentMetadata;
+    /** Document content */
+    content: DocumentContent;
+    /** Document settings */
+    settings: DocumentSettings;
+    /** Optional view state for restoring exact view */
+    viewState?: ViewState;
+    /** Node positions (for preserving manual layout) */
+    nodePositions?: Record<string, NodePosition>;
+    /** Edge routing data (bend points, keyed by edge ID) */
+    edgeRouting?: Record<string, EdgeRoutingData>;
+}
+/**
+ * Options for creating a new document
+ */
+export interface CreateDocumentOptions {
+    /** Document name (required) */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Optional tags */
+    tags?: string[];
+    /** Optional version */
+    version?: string;
+    /** Content configuration */
+    content?: Partial<DocumentContent>;
+    /** Settings configuration */
+    settings?: Partial<DocumentSettings>;
+    /** View state */
+    viewState?: ViewState;
+    /** Node positions */
+    nodePositions?: Record<string, NodePosition>;
+}
+/**
+ * Options for serializing nodes/edges
+ */
+export interface SerializeOptions {
+    /** Document name (required) */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Optional tags */
+    tags?: string[];
+    /** Optional version */
+    version?: string;
+    /** Settings configuration */
+    settings?: Partial<DocumentSettings>;
+    /** View state */
+    viewState?: ViewState;
+    /** Existing created timestamp (for updates) */
+    created?: string;
+    /** Existing GraphIR envelope whose graph-level fields must survive a save. */
+    graphIR?: GraphIR;
+}
+/**
+ * Result of deserializing a document
+ */
+export interface DeserializeResult {
+    /** React Flow nodes */
+    nodes: import('../types.js').CoralNode[];
+    /** React Flow edges */
+    edges: import('../types.js').CoralEdge[];
+    /** Document settings */
+    settings: DocumentSettings;
+    /** View state (if present) */
+    viewState?: ViewState;
+    /** Document metadata */
+    metadata: DocumentMetadata;
+    /** Restored edge waypoints (CORAL-REQ-015) — Map<edgeId, waypoints> */
+    edgeWaypoints?: Map<string, Array<{
+        id: string;
+        x: number;
+        y: number;
+        type: string;
+    }>>;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether the document is valid */
+    valid: boolean;
+    /** List of validation errors */
+    errors: string[];
+}
+/**
+ * Font settings for diagram text
+ */
+export interface FontSettings {
+    /** Font family (CSS font-family value) */
+    family: string;
+    /** Font size in pixels */
+    size: number;
+    /** Font weight */
+    weight: 'normal' | 'bold' | number;
+    /** Line height multiplier */
+    lineHeight: number;
+}
+/**
+ * Diagram font settings with optional symbol overrides
+ */
+export interface DiagramFontSettings {
+    /** Default font settings for all text */
+    default: FontSettings;
+    /** Override font settings for specific symbol types */
+    symbolOverrides?: Record<string, Partial<FontSettings>>;
+}
+/**
+ * Font family preset
+ */
+export interface FontFamilyPreset {
+    id: string;
+    name: string;
+    family: string;
+}
+/**
+ * Font size preset
+ */
+export interface FontSizePreset {
+    id: string;
+    name: string;
+    size: number;
+}
+/**
+ * Default font settings
+ */
+export declare const DEFAULT_FONT_SETTINGS: FontSettings;
+/**
+ * Font family presets
+ */
+export declare const FONT_FAMILY_PRESETS: FontFamilyPreset[];
+/**
+ * Font size presets
+ */
+export declare const FONT_SIZE_PRESETS: FontSizePreset[];
+/**
+ * Get a font family preset by ID
+ */
+export declare function getFontFamilyPreset(id: string): FontFamilyPreset | undefined;
+/**
+ * Get a font size preset by ID
+ */
+export declare function getFontSizePreset(id: string): FontSizePreset | undefined;
+/**
+ * ELK edge routing options
+ */
+export type EdgeRouting = 'ORTHOGONAL' | 'POLYLINE' | 'SPLINES';
+/**
+ * ELK layout algorithm options
+ */
+export type LayoutAlgorithm = 'layered' | 'mrtree' | 'stress' | 'force' | 'radial' | 'box';
+/**
+ * Layout preset identifier
+ */
+export type LayoutPresetId = 'flowchart' | 'org-chart' | 'network' | 'radial' | 'custom';
+/**
+ * Layout preset definition
+ */
+export interface LayoutPreset {
+    /** Unique identifier */
+    id: LayoutPresetId;
+    /** Display name */
+    name: string;
+    /** Description of when to use this preset */
+    description: string;
+    /** Preset settings */
+    settings: LayoutSettings;
+}
+/**
+ * LLM provider identifier for AI generation
+ */
+export type LLMProviderPreference = 'anthropic' | 'openai' | 'google' | 'mistral';
+/**
+ * Speech recognition mode for voice input (#49)
+ * - 'local': On-device Whisper via Web Worker (default)
+ * - 'browser': Native Web Speech API (Chrome/Edge, sends audio to cloud)
+ * - 'off': Disabled
+ */
+export type SpeechRecognitionMode = 'local' | 'browser' | 'off';
+/**
+ * User preferences stored in localStorage
+ * These are NOT saved with the document
+ */
+export interface UserPreferences {
+    /** Default notation for new diagrams */
+    defaultNotation: string;
+    /** Default layout preset for new diagrams */
+    defaultLayoutPreset: LayoutPresetId;
+    /** Theme (future use) */
+    theme: 'light' | 'dark' | 'system';
+    /** Show minimap by default */
+    showMinimap: boolean;
+    /** Show controls by default */
+    showControls: boolean;
+    /** Fit view on load */
+    fitViewOnLoad: boolean;
+    /** Auto-save interval in ms (0 = disabled) */
+    autoSaveInterval: number;
+    /** Remember last opened files */
+    recentFiles: string[];
+    /** Maximum recent files to remember */
+    maxRecentFiles: number;
+    /** LLM provider for AI generation */
+    llmProvider: LLMProviderPreference;
+    /** LLM model for AI generation */
+    llmModel: string;
+    /** Whether to save API key to localStorage */
+    llmSaveApiKey: boolean;
+    /** Saved API key (only if llmSaveApiKey is true) */
+    llmSavedApiKey: string;
+    /** Speech recognition mode for voice input (#49) */
+    speechRecognitionMode: SpeechRecognitionMode;
+}
+/**
+ * Default user preferences
+ */
+export declare const DEFAULT_USER_PREFERENCES: UserPreferences;
+/**
+ * Default layout settings
+ */
+export declare const DEFAULT_LAYOUT_SETTINGS: LayoutSettings;
+/**
+ * Layout presets
+ */
+export declare const LAYOUT_PRESETS: LayoutPreset[];
+/**
+ * Get a layout preset by ID
+ */
+export declare function getLayoutPreset(id: LayoutPresetId): LayoutPreset | undefined;
+/**
+ * Combined settings for the settings panel
+ */
+export interface SettingsPanelState {
+    /** Document-level settings (saved with file) */
+    document: DocumentSettings;
+    /** User preferences (saved to localStorage) */
+    user: UserPreferences;
+    /** Currently selected preset (for UI display) */
+    selectedPreset: LayoutPresetId;
+}
+//# sourceMappingURL=schema.d.ts.map

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

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

package/dist/file/schema.js

@@ -0,0 +1,180 @@
+/**
+ * Coral Document Schema (CORAL-REQ-008)
+ *
+ * Defines the TypeScript types for the Coral file format.
+ * File extension: .coral.json
+ */
+/**
+ * Current schema version. Increment when making breaking changes.
+ */
+export const CURRENT_SCHEMA_VERSION = '1.0.0';
+/**
+ * Supported schema versions for migration
+ */
+export const SUPPORTED_SCHEMA_VERSIONS = ['0.9.0', '1.0.0', '1.0'];
+/**
+ * Default font settings
+ */
+export const DEFAULT_FONT_SETTINGS = {
+    family: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+    size: 14,
+    weight: 'normal',
+    lineHeight: 1.3,
+};
+/**
+ * Font family presets
+ */
+export const FONT_FAMILY_PRESETS = [
+    {
+        id: 'system',
+        name: 'System',
+        family: '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+    },
+    {
+        id: 'sans',
+        name: 'Sans Serif',
+        family: '"Inter", "Helvetica Neue", Arial, sans-serif',
+    },
+    {
+        id: 'serif',
+        name: 'Serif',
+        family: '"Georgia", "Times New Roman", serif',
+    },
+    {
+        id: 'mono',
+        name: 'Monospace',
+        family: '"JetBrains Mono", "Fira Code", "Consolas", monospace',
+    },
+    {
+        id: 'handwritten',
+        name: 'Handwritten',
+        family: '"Comic Neue", "Comic Sans MS", cursive',
+    },
+];
+/**
+ * Font size presets
+ */
+export const FONT_SIZE_PRESETS = [
+    { id: 'small', name: 'Small', size: 11 },
+    { id: 'normal', name: 'Normal', size: 14 },
+    { id: 'large', name: 'Large', size: 16 },
+    { id: 'xlarge', name: 'Extra Large', size: 18 },
+];
+/**
+ * Get a font family preset by ID
+ */
+export function getFontFamilyPreset(id) {
+    return FONT_FAMILY_PRESETS.find((p) => p.id === id);
+}
+/**
+ * Get a font size preset by ID
+ */
+export function getFontSizePreset(id) {
+    return FONT_SIZE_PRESETS.find((p) => p.id === id);
+}
+/**
+ * Default user preferences
+ */
+export const DEFAULT_USER_PREFERENCES = {
+    defaultNotation: 'flowchart',
+    defaultLayoutPreset: 'flowchart',
+    theme: 'system',
+    showMinimap: true,
+    showControls: true,
+    fitViewOnLoad: true,
+    autoSaveInterval: 0,
+    recentFiles: [],
+    maxRecentFiles: 10,
+    llmProvider: 'anthropic',
+    llmModel: 'claude-sonnet-4-5-20250929',
+    llmSaveApiKey: false,
+    llmSavedApiKey: '',
+    speechRecognitionMode: 'local',
+};
+/**
+ * Default layout settings
+ */
+export const DEFAULT_LAYOUT_SETTINGS = {
+    algorithm: 'layered',
+    direction: 'DOWN',
+    spacing: {
+        nodeNode: 50,
+        edgeNode: 20,
+        layerSpacing: 70,
+    },
+    elkOptions: {
+        'elk.edgeRouting': 'ORTHOGONAL',
+    },
+    sizingMode: 'adaptive',
+};
+/**
+ * Layout presets
+ */
+export const LAYOUT_PRESETS = [
+    {
+        id: 'flowchart',
+        name: 'Flowchart',
+        description: 'Top-to-bottom layered layout, ideal for process flows',
+        settings: {
+            algorithm: 'layered',
+            direction: 'DOWN',
+            spacing: { nodeNode: 50, layerSpacing: 70 },
+            elkOptions: { 'elk.edgeRouting': 'ORTHOGONAL' },
+            sizingMode: 'adaptive',
+        },
+    },
+    {
+        id: 'org-chart',
+        name: 'Org Chart',
+        description: 'Tree layout for hierarchical structures',
+        settings: {
+            algorithm: 'mrtree',
+            direction: 'DOWN',
+            spacing: { nodeNode: 40, layerSpacing: 80 },
+            elkOptions: {
+                'elk.edgeRouting': 'POLYLINE',
+                'elk.mrtree.weighting': 'CONSTRAINT',
+            },
+            sizingMode: 'uniform',
+        },
+    },
+    {
+        id: 'network',
+        name: 'Network',
+        description: 'Force-directed layout for even distribution',
+        settings: {
+            algorithm: 'stress',
+            direction: 'DOWN',
+            spacing: { nodeNode: 80 },
+            elkOptions: {
+                'elk.stress.desiredEdgeLength': '100',
+            },
+            sizingMode: 'adaptive',
+        },
+    },
+    {
+        id: 'radial',
+        name: 'Radial',
+        description: 'Circular layout radiating from a center point',
+        settings: {
+            algorithm: 'radial',
+            direction: 'DOWN',
+            spacing: { nodeNode: 60, layerSpacing: 100 },
+            elkOptions: {},
+            sizingMode: 'adaptive',
+        },
+    },
+    {
+        id: 'custom',
+        name: 'Custom',
+        description: 'Manual configuration of layout options',
+        settings: DEFAULT_LAYOUT_SETTINGS,
+    },
+];
+/**
+ * Get a layout preset by ID
+ */
+export function getLayoutPreset(id) {
+    return LAYOUT_PRESETS.find((p) => p.id === id);
+}
+//# sourceMappingURL=schema.js.map

package/dist/file/schema.js.map

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

package/dist/file/serialize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Coral Document Serialization (CORAL-REQ-008)
+ *
+ * Converts React Flow nodes/edges to CoralDocument format.
+ */
+import type { CoralNode, CoralEdge } from '../types.js';
+import type { CoralDocument, CreateDocumentOptions, SerializeOptions } from './schema.js';
+/**
+ * Create a new CoralDocument with default values
+ *
+ * @param options - Document creation options
+ * @returns New CoralDocument
+ */
+export declare function createDocument(options: CreateDocumentOptions): CoralDocument;
+/**
+ * Serialize React Flow nodes and edges to a CoralDocument
+ *
+ * @param nodes - React Flow nodes
+ * @param edges - React Flow edges
+ * @param options - Serialization options
+ * @param waypointMap - Optional map of edge ID to waypoints (CORAL-REQ-015)
+ * @returns CoralDocument
+ */
+export declare function serialize(nodes: CoralNode[], edges: CoralEdge[], options: SerializeOptions, waypointMap?: Map<string, Array<{
+    id: string;
+    x: number;
+    y: number;
+    type: string;
+}>>): CoralDocument;
+//# sourceMappingURL=serialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/file/serialize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAiC,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAKjB,MAAM,aAAa,CAAC;AAuBrB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAqC5E;AAoED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,gBAAgB,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GACnF,aAAa,CAoFf"}