@pixerate/editor 0.52.0 → 0.54.0

package/dist/tools/index.d.cts

@@ -1,6 +1,6 @@
 export { J as JsonSchema, a as JsonSchemaType, S as SchemaValidationError, v as validateJsonSchema } from '../schema-Di0CS6Pe.cjs';
-import { i as ToolRegistry } from '../registry-B4l-lYts.cjs';
-export { a as AgentTool, b as AgentToolHandler, A as AgentToolProvider, M as McpListToolsResult, c as McpToolContent, d as McpToolDefinition, e as McpToolResult, T as TOOL_NAMESPACE_SEPARATOR, f as ToolCallContext, g as ToolCallError, h as ToolErrorCode, j as ToolRegistryError, k as ToolRegistryOptions, l as createToolRegistry, t as toToolResult } from '../registry-B4l-lYts.cjs';
+export { b as AgentTool, c as AgentToolHandler, A as AgentToolProvider, d as McpListToolsResult, e as McpToolContent, M as McpToolDefinition, a as McpToolResult, f as TOOL_NAMESPACE_SEPARATOR, g as ToolCallContext, h as ToolCallError, i as ToolErrorCode, T as ToolRegistry, j as ToolRegistryError, k as ToolRegistryOptions, l as createToolRegistry, t as toToolResult } from '../registry-DIpIaCkH.cjs';
+export { C as ConnectToolBridgeOptions, J as JSON_RPC_ERRORS, b as JsonRpcId, c as JsonRpcNotification, d as JsonRpcRequest, e as JsonRpcResponse, f as MCP_PROTOCOL_VERSIONS, M as McpServer, g as McpServerOptions, T as TOOL_BRIDGE_DEFAULT_PORT, a as TOOL_BRIDGE_PROTOCOL, h as ToolBridgeConnection, i as ToolBridgeEditorMessage, j as ToolBridgeServerMessage, k as ToolBridgeSocket, l as ToolBridgeStatus, m as connectToolBridge, n as createMcpServer } from '../bridge-client-C5OziCRK.cjs';
 
 /**
  * Standard MCP Tool Definitions for @pixerate/editor.
@@ -1129,75 +1129,4 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }];
 
-/** MCP protocol revisions this server speaks, newest first. */
-declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
-type JsonRpcId = string | number;
-interface JsonRpcRequest {
-    jsonrpc: '2.0';
-    id?: JsonRpcId | null;
-    method: string;
-    params?: Record<string, any>;
-}
-interface JsonRpcResponse {
-    jsonrpc: '2.0';
-    id: JsonRpcId | null;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-interface JsonRpcNotification {
-    jsonrpc: '2.0';
-    method: string;
-    params?: Record<string, unknown>;
-}
-/** Standard JSON-RPC error codes used by the server. */
-declare const JSON_RPC_ERRORS: {
-    readonly parseError: -32700;
-    readonly invalidRequest: -32600;
-    readonly methodNotFound: -32601;
-    readonly invalidParams: -32602;
-    readonly internalError: -32603;
-};
-interface McpServerOptions {
-    /** `serverInfo` sent in the `initialize` result. */
-    name: string;
-    version: string;
-    title?: string;
-    /** Usage hints for the client's model, sent in the `initialize` result. */
-    instructions?: string;
-    /**
-     * Sends server → client messages (`notifications/tools/list_changed`).
-     * Without it the server still answers requests but announces nothing.
-     */
-    send?: (message: JsonRpcNotification) => void;
-}
-interface McpServer {
-    /**
-     * Handles one client message (a JSON string or a parsed object) and
-     * resolves to the response to send back, or `null` for notifications.
-     * Never rejects.
-     */
-    handle(message: string | JsonRpcRequest): Promise<JsonRpcResponse | null>;
-    /** Whether the client has completed the `initialize` handshake. */
-    readonly initialized: boolean;
-    /** Stops list-changed notifications and aborts running tool calls. */
-    close(): void;
-}
-/**
- * A transport-agnostic MCP server for a {@link ToolRegistry}: wire `handle`
- * to any transport (stdio lines, a WebSocket, `postMessage`, an HTTP POST
- * handler) and pass `send` for server → client notifications.
- *
- * Supports `initialize` (with protocol version negotiation), `ping`,
- * `tools/list`, `tools/call` and `notifications/cancelled` (aborts the
- * call's `signal`), and announces `notifications/tools/list_changed` after
- * the client sends `notifications/initialized`. An unknown tool is a
- * JSON-RPC `-32602` error, as the MCP spec asks; invalid arguments and
- * handler failures are `isError` tool results the model can read and fix.
- */
-declare function createMcpServer(registry: ToolRegistry, options: McpServerOptions): McpServer;
-
-export { EDITOR_CANVAS_TOOLS, EDITOR_MCP_TOOLS, EDITOR_PROMPT_TOOLS, EDIT_OPERATION_REQUIRED_ARGUMENTS, EXPORT_EXCLUDED_SELECTORS, JSON_RPC_ERRORS, type JsonRpcId, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, MCP_PROTOCOL_VERSIONS, MCP_TOOL_CANVAS_ADD_NODE, MCP_TOOL_CANVAS_CONNECT, MCP_TOOL_CANVAS_HIGHLIGHT, MCP_TOOL_CANVAS_LAYOUT, MCP_TOOL_CANVAS_REMOVE_NODES, MCP_TOOL_CANVAS_SELECT, MCP_TOOL_CANVAS_UPDATE_NODE, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_PROMPT_INSERT_TEXT, MCP_TOOL_PROMPT_REPLACE_RANGE, MCP_TOOL_PROMPT_SELECT, MCP_TOOL_PROMPT_SET_VARIABLE, MCP_TOOL_VIEW_EDITOR, type McpServer, type McpServerOptions, ToolRegistry, createMcpServer };
+export { EDITOR_CANVAS_TOOLS, EDITOR_MCP_TOOLS, EDITOR_PROMPT_TOOLS, EDIT_OPERATION_REQUIRED_ARGUMENTS, EXPORT_EXCLUDED_SELECTORS, MCP_TOOL_CANVAS_ADD_NODE, MCP_TOOL_CANVAS_CONNECT, MCP_TOOL_CANVAS_HIGHLIGHT, MCP_TOOL_CANVAS_LAYOUT, MCP_TOOL_CANVAS_REMOVE_NODES, MCP_TOOL_CANVAS_SELECT, MCP_TOOL_CANVAS_UPDATE_NODE, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_PROMPT_INSERT_TEXT, MCP_TOOL_PROMPT_REPLACE_RANGE, MCP_TOOL_PROMPT_SELECT, MCP_TOOL_PROMPT_SET_VARIABLE, MCP_TOOL_VIEW_EDITOR };

package/dist/tools/index.d.ts

@@ -1,6 +1,6 @@
 export { J as JsonSchema, a as JsonSchemaType, S as SchemaValidationError, v as validateJsonSchema } from '../schema-Di0CS6Pe.js';
-import { i as ToolRegistry } from '../registry-CSlH4iUn.js';
-export { a as AgentTool, b as AgentToolHandler, A as AgentToolProvider, M as McpListToolsResult, c as McpToolContent, d as McpToolDefinition, e as McpToolResult, T as TOOL_NAMESPACE_SEPARATOR, f as ToolCallContext, g as ToolCallError, h as ToolErrorCode, j as ToolRegistryError, k as ToolRegistryOptions, l as createToolRegistry, t as toToolResult } from '../registry-CSlH4iUn.js';
+export { b as AgentTool, c as AgentToolHandler, A as AgentToolProvider, d as McpListToolsResult, e as McpToolContent, M as McpToolDefinition, a as McpToolResult, f as TOOL_NAMESPACE_SEPARATOR, g as ToolCallContext, h as ToolCallError, i as ToolErrorCode, T as ToolRegistry, j as ToolRegistryError, k as ToolRegistryOptions, l as createToolRegistry, t as toToolResult } from '../registry-7AZFuand.js';
+export { C as ConnectToolBridgeOptions, J as JSON_RPC_ERRORS, b as JsonRpcId, c as JsonRpcNotification, d as JsonRpcRequest, e as JsonRpcResponse, f as MCP_PROTOCOL_VERSIONS, M as McpServer, g as McpServerOptions, T as TOOL_BRIDGE_DEFAULT_PORT, a as TOOL_BRIDGE_PROTOCOL, h as ToolBridgeConnection, i as ToolBridgeEditorMessage, j as ToolBridgeServerMessage, k as ToolBridgeSocket, l as ToolBridgeStatus, m as connectToolBridge, n as createMcpServer } from '../bridge-client-C5dRjrz5.js';
 
 /**
  * Standard MCP Tool Definitions for @pixerate/editor.
@@ -1129,75 +1129,4 @@ declare const EDITOR_MCP_TOOLS: readonly [{
     };
 }];
 
-/** MCP protocol revisions this server speaks, newest first. */
-declare const MCP_PROTOCOL_VERSIONS: readonly ["2025-06-18", "2025-03-26", "2024-11-05"];
-type JsonRpcId = string | number;
-interface JsonRpcRequest {
-    jsonrpc: '2.0';
-    id?: JsonRpcId | null;
-    method: string;
-    params?: Record<string, any>;
-}
-interface JsonRpcResponse {
-    jsonrpc: '2.0';
-    id: JsonRpcId | null;
-    result?: unknown;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-interface JsonRpcNotification {
-    jsonrpc: '2.0';
-    method: string;
-    params?: Record<string, unknown>;
-}
-/** Standard JSON-RPC error codes used by the server. */
-declare const JSON_RPC_ERRORS: {
-    readonly parseError: -32700;
-    readonly invalidRequest: -32600;
-    readonly methodNotFound: -32601;
-    readonly invalidParams: -32602;
-    readonly internalError: -32603;
-};
-interface McpServerOptions {
-    /** `serverInfo` sent in the `initialize` result. */
-    name: string;
-    version: string;
-    title?: string;
-    /** Usage hints for the client's model, sent in the `initialize` result. */
-    instructions?: string;
-    /**
-     * Sends server → client messages (`notifications/tools/list_changed`).
-     * Without it the server still answers requests but announces nothing.
-     */
-    send?: (message: JsonRpcNotification) => void;
-}
-interface McpServer {
-    /**
-     * Handles one client message (a JSON string or a parsed object) and
-     * resolves to the response to send back, or `null` for notifications.
-     * Never rejects.
-     */
-    handle(message: string | JsonRpcRequest): Promise<JsonRpcResponse | null>;
-    /** Whether the client has completed the `initialize` handshake. */
-    readonly initialized: boolean;
-    /** Stops list-changed notifications and aborts running tool calls. */
-    close(): void;
-}
-/**
- * A transport-agnostic MCP server for a {@link ToolRegistry}: wire `handle`
- * to any transport (stdio lines, a WebSocket, `postMessage`, an HTTP POST
- * handler) and pass `send` for server → client notifications.
- *
- * Supports `initialize` (with protocol version negotiation), `ping`,
- * `tools/list`, `tools/call` and `notifications/cancelled` (aborts the
- * call's `signal`), and announces `notifications/tools/list_changed` after
- * the client sends `notifications/initialized`. An unknown tool is a
- * JSON-RPC `-32602` error, as the MCP spec asks; invalid arguments and
- * handler failures are `isError` tool results the model can read and fix.
- */
-declare function createMcpServer(registry: ToolRegistry, options: McpServerOptions): McpServer;
-
-export { EDITOR_CANVAS_TOOLS, EDITOR_MCP_TOOLS, EDITOR_PROMPT_TOOLS, EDIT_OPERATION_REQUIRED_ARGUMENTS, EXPORT_EXCLUDED_SELECTORS, JSON_RPC_ERRORS, type JsonRpcId, type JsonRpcNotification, type JsonRpcRequest, type JsonRpcResponse, MCP_PROTOCOL_VERSIONS, MCP_TOOL_CANVAS_ADD_NODE, MCP_TOOL_CANVAS_CONNECT, MCP_TOOL_CANVAS_HIGHLIGHT, MCP_TOOL_CANVAS_LAYOUT, MCP_TOOL_CANVAS_REMOVE_NODES, MCP_TOOL_CANVAS_SELECT, MCP_TOOL_CANVAS_UPDATE_NODE, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_PROMPT_INSERT_TEXT, MCP_TOOL_PROMPT_REPLACE_RANGE, MCP_TOOL_PROMPT_SELECT, MCP_TOOL_PROMPT_SET_VARIABLE, MCP_TOOL_VIEW_EDITOR, type McpServer, type McpServerOptions, ToolRegistry, createMcpServer };
+export { EDITOR_CANVAS_TOOLS, EDITOR_MCP_TOOLS, EDITOR_PROMPT_TOOLS, EDIT_OPERATION_REQUIRED_ARGUMENTS, EXPORT_EXCLUDED_SELECTORS, MCP_TOOL_CANVAS_ADD_NODE, MCP_TOOL_CANVAS_CONNECT, MCP_TOOL_CANVAS_HIGHLIGHT, MCP_TOOL_CANVAS_LAYOUT, MCP_TOOL_CANVAS_REMOVE_NODES, MCP_TOOL_CANVAS_SELECT, MCP_TOOL_CANVAS_UPDATE_NODE, MCP_TOOL_EDIT_CANVAS, MCP_TOOL_EDIT_PROMPT, MCP_TOOL_GET_EDITOR_STATE, MCP_TOOL_PROMPT_INSERT_TEXT, MCP_TOOL_PROMPT_REPLACE_RANGE, MCP_TOOL_PROMPT_SELECT, MCP_TOOL_PROMPT_SET_VARIABLE, MCP_TOOL_VIEW_EDITOR };

package/dist/tools/index.js

@@ -4,8 +4,6 @@ import {
   EDITOR_PROMPT_TOOLS,
   EDIT_OPERATION_REQUIRED_ARGUMENTS,
   EXPORT_EXCLUDED_SELECTORS,
-  JSON_RPC_ERRORS,
-  MCP_PROTOCOL_VERSIONS,
   MCP_TOOL_CANVAS_ADD_NODE,
   MCP_TOOL_CANVAS_CONNECT,
   MCP_TOOL_CANVAS_HIGHLIGHT,
@@ -20,14 +18,21 @@ import {
   MCP_TOOL_PROMPT_REPLACE_RANGE,
   MCP_TOOL_PROMPT_SELECT,
   MCP_TOOL_PROMPT_SET_VARIABLE,
-  MCP_TOOL_VIEW_EDITOR,
+  MCP_TOOL_VIEW_EDITOR
+} from "../chunk-GPWNYQ7R.js";
+import {
+  JSON_RPC_ERRORS,
+  MCP_PROTOCOL_VERSIONS,
+  TOOL_BRIDGE_DEFAULT_PORT,
+  TOOL_BRIDGE_PROTOCOL,
   TOOL_NAMESPACE_SEPARATOR,
   ToolRegistry,
   ToolRegistryError,
+  connectToolBridge,
   createMcpServer,
   createToolRegistry,
   toToolResult
-} from "../chunk-AMWXSYCI.js";
+} from "../chunk-PTMIGXZ2.js";
 import {
   validateJsonSchema
 } from "../chunk-4FX5ACVG.js";
@@ -54,9 +59,12 @@ export {
   MCP_TOOL_PROMPT_SELECT,
   MCP_TOOL_PROMPT_SET_VARIABLE,
   MCP_TOOL_VIEW_EDITOR,
+  TOOL_BRIDGE_DEFAULT_PORT,
+  TOOL_BRIDGE_PROTOCOL,
   TOOL_NAMESPACE_SEPARATOR,
   ToolRegistry,
   ToolRegistryError,
+  connectToolBridge,
   createMcpServer,
   createToolRegistry,
   toToolResult,

package/dist/types-BULrFyuQ.d.cts

@@ -0,0 +1,316 @@
+/**
+ * Core document model shared by every diagram family.
+ *
+ * Design goals:
+ *  - **Lossless**: a document parsed and serialised without edits is
+ *    byte-identical to its input. Anything the diagram module does not understand is kept
+ *    verbatim as a passthrough statement.
+ *  - **Graph-first**: every editable family projects onto the same
+ *    {@link DiagramGraph} so that one canvas can render all of them.
+ *  - **Mermaid-compatible metadata**: canvas state is stored in
+ *    `%% @pixerate …` comments (or frontmatter) that every Mermaid parser ignores.
+ *
+ * @module
+ */
+/** Mermaid diagram families the diagram module knows how to detect. */
+type DiagramFamily = "flowchart" | "state" | "class" | "er" | "requirement" | "mindmap" | "sequence" | "gantt" | "pie" | "journey" | "timeline" | "gitGraph" | "c4" | "quadrant" | "sankey" | "xychart" | "block" | "architecture" | "packet" | "kanban" | "radar" | "treemap" | "info" | "unknown";
+/**
+ * How deeply the diagram module can edit a family.
+ *
+ * - `editable` — statement-level lossless editing on the canvas. Every
+ *   family the diagram module ships an adapter for is editable; the canvas model differs
+ *   per family (graph, tree, timeline, chart data…).
+ * - `render-only` — source editing with a live Mermaid preview; no canvas.
+ *   Used for families without an adapter and for unknown input.
+ */
+type SupportTier = "editable" | "render-only";
+/** `[x, y]` canvas position in React Flow coordinates. */
+type Point = readonly [number, number];
+/** Line pattern of an edge. Mirrors Mermaid's `thickness` / `pattern`. */
+type EdgePattern = "solid" | "dotted" | "thick" | "invisible";
+/**
+ * Arrow head identifiers, aligned with Mermaid's `arrowTypeStart` /
+ * `arrowTypeEnd` values so React Flow markers can be derived uniformly.
+ */
+type ArrowHead = "none" | "arrow_point" | "arrow_open" | "arrow_cross" | "arrow_circle" | "arrow_barb" | "extension" | "composition" | "aggregation" | "dependency" | "lollipop" | "only_one" | "zero_or_one" | "one_or_more" | "zero_or_more" | "md_parent" | "requirement_arrow" | "requirement_contains";
+interface GraphNode {
+    /** Stable identifier (the Mermaid id, e.g. `A`). */
+    id: string;
+    /** Display label (raw Mermaid text, markdown strings included). */
+    label: string;
+    /**
+     * Canonical shape identifier (`rect`, `diam`, `cyl`, `stateStart`,
+     * `classBox`, `erBox`…). Mermaid aliases such as `squareRect` or `diamond`
+     * are normalised on parse. See `FLOWCHART_SHAPES` for the flowchart set.
+     */
+    shape: string;
+    /** Enclosing group (subgraph / composite state / namespace) id. */
+    parentId?: string;
+    /** CSS class names applied with `:::`, `class`, or `classDef` defaults. */
+    classes: string[];
+    /** Inline `style` declarations (`fill:#f9f`, …). */
+    styles: string[];
+    /** `click` href target. */
+    link?: string;
+    linkTarget?: string;
+    tooltip?: string;
+    /** Family-specific payload (class members, ER attributes, state notes…). */
+    data?: Record<string, unknown>;
+}
+interface GraphGroup {
+    id: string;
+    label: string;
+    parentId?: string;
+    /** Local layout direction override (`TB`, `LR`, …). */
+    direction?: string;
+    classes: string[];
+    styles: string[];
+    data?: Record<string, unknown>;
+}
+interface GraphEdge {
+    /** Mermaid-compatible id (`L_A_B_0` for auto ids, or the user id). */
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+    pattern: EdgePattern;
+    arrowStart: ArrowHead;
+    arrowEnd: ArrowHead;
+    /** Minimum rank length requested with extra dashes (`---->`). */
+    length: number;
+    classes: string[];
+    styles: string[];
+    animate?: boolean;
+    animation?: "fast" | "slow";
+    /** True when the id was written by the user (`A e1@--> B`). */
+    userDefinedId: boolean;
+    data?: Record<string, unknown>;
+}
+/** Normalised, family-independent view of a diagram. */
+interface DiagramGraph {
+    direction: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    groups: GraphGroup[];
+    /** `classDef` declarations keyed by class name. */
+    classDefs: Record<string, string[]>;
+    title?: string;
+    /**
+     * Diagram-level, family-specific settings that are not nodes or edges
+     * (pie `showData`, quadrant axis labels, gantt `dateFormat`…). Edited with
+     * `setGraphData`; the keys are documented per family in `FamilyUI.diagramFields`.
+     */
+    data?: Record<string, unknown>;
+}
+/** Canvas state that Mermaid itself does not model. Persisted as metadata. */
+interface DiagramMeta {
+    /** Schema version of the metadata payload. */
+    v: 1;
+    /** Node / group positions keyed by id. */
+    layout?: Record<string, Point>;
+    /** Explicit node sizes for resized nodes/groups. */
+    sizes?: Record<string, readonly [number, number]>;
+    /** Viewport the user last looked at. */
+    viewport?: {
+        x: number;
+        y: number;
+        zoom: number;
+    };
+    /** Free-form extension slot for host applications. */
+    ext?: Record<string, unknown>;
+}
+/** Where metadata lives in the source. */
+type MetaCarrier = "comment" | "frontmatter";
+/**
+ * Lines that precede the diagram header: YAML frontmatter, `%%{init}%%`
+ * directives, comments and blank lines. Kept verbatim.
+ */
+interface Preamble {
+    /** Raw lines, including the `---` fences of any frontmatter. */
+    lines: string[];
+    /** Parsed frontmatter when present (title/config/pixerate…). */
+    frontmatter?: Record<string, unknown>;
+}
+/** A parse problem reported by the diagram parser or by Mermaid. */
+interface Diagnostic {
+    severity: "error" | "warning" | "info";
+    message: string;
+    /** 1-based line in the source, when known. */
+    line?: number;
+    column?: number;
+    source: "pixerate" | "mermaid";
+}
+/**
+ * The parsed document. Family adapters extend `body` with their own statement
+ * list; consumers that only need the graph never look at it.
+ */
+interface MermaidDocument<TBody = unknown> {
+    family: DiagramFamily;
+    tier: SupportTier;
+    /** Source as given to {@link parseMermaid}. */
+    source: string;
+    preamble: Preamble;
+    /** The header line (`flowchart LR`, `stateDiagram-v2`, …) exactly as written. */
+    header: string;
+    /** Trailing newline / whitespace after the last statement, kept for fidelity. */
+    trailing: string;
+    /** End-of-line sequence detected in the source. */
+    eol: "\n" | "\r\n";
+    graph: DiagramGraph;
+    meta: DiagramMeta;
+    metaCarrier: MetaCarrier;
+    body: TBody;
+    diagnostics: Diagnostic[];
+    /** True once any edit has been applied to this document. */
+    dirty: boolean;
+}
+/** Directions understood by flowchart / state / class / ER. */
+declare const DIRECTIONS: readonly ["TB", "TD", "BT", "LR", "RL"];
+type Direction = (typeof DIRECTIONS)[number];
+type EditOp = {
+    type: "addNode";
+    node: Partial<GraphNode> & {
+        id: string;
+    };
+    position?: Point;
+} | {
+    type: "removeNodes";
+    ids: string[];
+} | {
+    type: "renameNode";
+    id: string;
+    label: string;
+} | {
+    type: "setNodeShape";
+    id: string;
+    shape: string;
+} | {
+    type: "setNodeClasses";
+    id: string;
+    classes: string[];
+} | {
+    type: "setNodeStyles";
+    id: string;
+    styles: string[];
+} | {
+    type: "setNodeLink";
+    id: string;
+    link?: string;
+    target?: string;
+    tooltip?: string;
+} | {
+    type: "setNodeData";
+    id: string;
+    data: Record<string, unknown>;
+} | {
+    type: "moveNodes";
+    moves: {
+        id: string;
+        position: Point;
+    }[];
+} | {
+    type: "resizeNode";
+    id: string;
+    size: readonly [number, number] | undefined;
+} | {
+    type: "addEdge";
+    edge: Partial<GraphEdge> & {
+        source: string;
+        target: string;
+    };
+} | {
+    type: "removeEdges";
+    ids: string[];
+} | {
+    type: "setEdgeLabel";
+    id: string;
+    label: string;
+}
+/** Family-specific edge payload (sequence activation, message order, gantt dependency type…). */
+ | {
+    type: "setEdgeData";
+    id: string;
+    data: Record<string, unknown>;
+} | {
+    type: "setEdgeStyle";
+    id: string;
+    pattern?: EdgePattern;
+    arrowStart?: ArrowHead;
+    arrowEnd?: ArrowHead;
+    length?: number;
+    styles?: string[];
+} | {
+    type: "reconnectEdge";
+    id: string;
+    source: string;
+    target: string;
+} | {
+    type: "groupNodes";
+    groupId: string;
+    label: string;
+    nodeIds: string[];
+    parentId?: string;
+} | {
+    type: "ungroup";
+    groupId: string;
+} | {
+    type: "renameGroup";
+    id: string;
+    label: string;
+} | {
+    type: "setGroupDirection";
+    id: string;
+    direction?: string;
+} | {
+    type: "setNodeParent";
+    ids: string[];
+    parentId?: string;
+} | {
+    type: "setDirection";
+    direction: string;
+} | {
+    type: "setClassDef";
+    name: string;
+    styles: string[] | undefined;
+} | {
+    type: "setTitle";
+    title: string | undefined;
+}
+/** Merge diagram-level settings into `graph.data` (see {@link DiagramGraph.data}). */
+ | {
+    type: "setGraphData";
+    data: Record<string, unknown>;
+} | {
+    type: "setViewport";
+    viewport: DiagramMeta["viewport"];
+} | {
+    type: "setMetaExt";
+    key: string;
+    value: unknown;
+} | {
+    type: "replaceSource";
+    source: string;
+};
+/** Family adapter contract. See `docs/architecture.md`. */
+interface DiagramAdapter<TBody = unknown> {
+    family: DiagramFamily;
+    tier: SupportTier;
+    parse(source: string, context: AdapterParseContext): MermaidDocument<TBody>;
+    serialize(doc: MermaidDocument<TBody>): string;
+    apply(doc: MermaidDocument<TBody>, op: EditOp): MermaidDocument<TBody>;
+}
+/** Pre-split source handed to adapters so they do not repeat the work. */
+interface AdapterParseContext {
+    source: string;
+    eol: "\n" | "\r\n";
+    preamble: Preamble;
+    header: string;
+    /** Body lines after the header (metadata comments already removed). */
+    bodyLines: string[];
+    trailing: string;
+    meta: DiagramMeta;
+    metaCarrier: MetaCarrier;
+    family: DiagramFamily;
+}
+
+export { type ArrowHead as A, type DiagramFamily as D, type EditOp as E, type GraphEdge as G, type MetaCarrier as M, type Preamble as P, type SupportTier as S, type MermaidDocument as a, type DiagramAdapter as b, type DiagramMeta as c, type EdgePattern as d, type Point as e, type DiagramGraph as f, type AdapterParseContext as g, DIRECTIONS as h, type Diagnostic as i, type Direction as j, type GraphGroup as k, type GraphNode as l };