callman-core 1.28.1 → 1.30.0

package/dist/diagram/routing/path.js

@@ -0,0 +1,128 @@
+const fmt = (n) => (Number.isInteger(n) ? String(n) : n.toFixed(2).replace(/\.?0+$/, ""));
+// Orthogonal polylines get rounded corners of `radius` (clamped to half the
+// shorter adjacent segment); straight polylines are sharp; curved paths use
+// their cubic segments.
+export const svgPathFromRoute = (route, radius = 8) => {
+    const { points } = route;
+    if (points.length === 0)
+        return "";
+    if (route.kind === "curved" && route.curves) {
+        let d = `M ${fmt(points[0].x)} ${fmt(points[0].y)}`;
+        for (const [c1, c2, end] of route.curves) {
+            d += ` C ${fmt(c1.x)} ${fmt(c1.y)} ${fmt(c2.x)} ${fmt(c2.y)} ${fmt(end.x)} ${fmt(end.y)}`;
+        }
+        return d;
+    }
+    if (route.kind !== "orthogonal" || radius <= 0 || points.length < 3) {
+        return points.map((p, i) => `${i === 0 ? "M" : "L"} ${fmt(p.x)} ${fmt(p.y)}`).join(" ");
+    }
+    let d = `M ${fmt(points[0].x)} ${fmt(points[0].y)}`;
+    for (let i = 1; i < points.length - 1; i += 1) {
+        const prev = points[i - 1];
+        const corner = points[i];
+        const next = points[i + 1];
+        const inLen = Math.hypot(corner.x - prev.x, corner.y - prev.y);
+        const outLen = Math.hypot(next.x - corner.x, next.y - corner.y);
+        const r = Math.min(radius, inLen / 2, outLen / 2);
+        if (r <= 0.01) {
+            d += ` L ${fmt(corner.x)} ${fmt(corner.y)}`;
+            continue;
+        }
+        const a = { x: corner.x - ((corner.x - prev.x) / inLen) * r, y: corner.y - ((corner.y - prev.y) / inLen) * r };
+        const b = { x: corner.x + ((next.x - corner.x) / outLen) * r, y: corner.y + ((next.y - corner.y) / outLen) * r };
+        d += ` L ${fmt(a.x)} ${fmt(a.y)} Q ${fmt(corner.x)} ${fmt(corner.y)} ${fmt(b.x)} ${fmt(b.y)}`;
+    }
+    const last = points[points.length - 1];
+    d += ` L ${fmt(last.x)} ${fmt(last.y)}`;
+    return d;
+};
+const cubicAt = (p0, c1, c2, p1, t) => {
+    const mt = 1 - t;
+    return {
+        x: mt * mt * mt * p0.x + 3 * mt * mt * t * c1.x + 3 * mt * t * t * c2.x + t * t * t * p1.x,
+        y: mt * mt * mt * p0.y + 3 * mt * mt * t * c1.y + 3 * mt * t * t * c2.y + t * t * t * p1.y,
+    };
+};
+// Polyline approximation used for lengths and sampling (curves flattened).
+export const flattenRoute = (route, steps = 12) => {
+    if (route.kind !== "curved" || !route.curves)
+        return route.points;
+    const out = [route.points[0]];
+    let from = route.points[0];
+    for (const [c1, c2, end] of route.curves) {
+        for (let i = 1; i <= steps; i += 1)
+            out.push(cubicAt(from, c1, c2, end, i / steps));
+        from = end;
+    }
+    return out;
+};
+export const routeLength = (route) => {
+    const pts = flattenRoute(route);
+    let length = 0;
+    for (let i = 1; i < pts.length; i += 1)
+        length += Math.hypot(pts[i].x - pts[i - 1].x, pts[i].y - pts[i - 1].y);
+    return length;
+};
+// Point at fraction `t` (0..1) of the path length, plus the tangent angle in
+// radians — where an edge label or toolbar sits.
+export const pointAlongRoute = (route, t) => {
+    const pts = flattenRoute(route);
+    if (pts.length === 0)
+        return { point: { x: 0, y: 0 }, angle: 0 };
+    if (pts.length === 1)
+        return { point: pts[0], angle: 0 };
+    const total = routeLength(route);
+    let remaining = Math.min(1, Math.max(0, t)) * total;
+    for (let i = 1; i < pts.length; i += 1) {
+        const a = pts[i - 1];
+        const b = pts[i];
+        const segment = Math.hypot(b.x - a.x, b.y - a.y);
+        if (remaining <= segment || i === pts.length - 1) {
+            const k = segment === 0 ? 0 : remaining / segment;
+            return { point: { x: a.x + (b.x - a.x) * k, y: a.y + (b.y - a.y) * k }, angle: Math.atan2(b.y - a.y, b.x - a.x) };
+        }
+        remaining -= segment;
+    }
+    const last = pts[pts.length - 1];
+    return { point: last, angle: 0 };
+};
+// The fraction along the path nearest to `point` — dragging a label.
+export const nearestFraction = (route, point) => {
+    const pts = flattenRoute(route);
+    const total = routeLength(route);
+    if (total === 0 || pts.length < 2)
+        return 0.5;
+    let best = 0;
+    let bestDistance = Infinity;
+    let walked = 0;
+    for (let i = 1; i < pts.length; i += 1) {
+        const a = pts[i - 1];
+        const b = pts[i];
+        const dx = b.x - a.x;
+        const dy = b.y - a.y;
+        const segment = Math.hypot(dx, dy);
+        const k = segment === 0 ? 0 : Math.min(1, Math.max(0, ((point.x - a.x) * dx + (point.y - a.y) * dy) / (segment * segment)));
+        const px = a.x + dx * k;
+        const py = a.y + dy * k;
+        const distance = Math.hypot(point.x - px, point.y - py);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = (walked + segment * k) / total;
+        }
+        walked += segment;
+    }
+    return best;
+};
+// Midpoints of the interior segments of an orthogonal route — where the
+// canvas shows drag handles that create manual bends.
+export const segmentMidpoints = (route) => {
+    const out = [];
+    const pts = route.points;
+    for (let i = 1; i < pts.length - 2; i += 1) {
+        const a = pts[i];
+        const b = pts[i + 1];
+        out.push({ index: i, point: { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 }, horizontal: Math.abs(a.y - b.y) < 1e-6 });
+    }
+    return out;
+};
+//# sourceMappingURL=path.js.map

package/dist/diagram/routing/path.js.map

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

package/dist/diagram/routing/sides.d.ts

@@ -0,0 +1,22 @@
+import { type Rect } from "../geometry.js";
+import type { Point } from "../schema.js";
+import type { Side, Terminal } from "./types.js";
+export interface Sides {
+    source: Side;
+    target: Side;
+}
+export declare const chooseSides: (source: Rect, target: Rect, fixed?: {
+    source?: Side;
+    target?: Side;
+}, previous?: {
+    source?: Side;
+    target?: Side;
+}) => Sides;
+export declare const sidesFor: (source: Terminal, target: Terminal, previous?: {
+    source?: Side;
+    target?: Side;
+}) => Sides;
+export declare const sideVector: (side: Side) => Point;
+export declare const attachPoint: (terminal: Terminal, side: Side) => Point;
+export declare const boundaryToward: (rect: Rect, toward: Point) => Point;
+//# sourceMappingURL=sides.d.ts.map

package/dist/diagram/routing/sides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sides.d.ts","sourceRoot":"","sources":["../../../src/diagram/routing/sides.ts"],"names":[],"mappings":"AAKA,OAAO,EAA4B,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;CACd;AAaD,eAAO,MAAM,WAAW,GACtB,QAAQ,IAAI,EACZ,QAAQ,IAAI,EACZ,QAAO;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CAAO,EAC5C,WAAW;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CAAE,KAC1C,KAuBF,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,QAAQ,QAAQ,EAAE,QAAQ,QAAQ,EAAE,WAAW;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,IAAI,CAAA;CAAE,KAAG,KACZ,CAAC;AAEhG,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,KAYvC,CAAC;AAIF,eAAO,MAAM,WAAW,GAAI,UAAU,QAAQ,EAAE,MAAM,IAAI,KAAG,KAA4D,CAAC;AAI1H,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,EAAE,QAAQ,KAAK,KAAG,KAS1D,CAAC"}

package/dist/diagram/routing/sides.js

@@ -0,0 +1,74 @@
+// Which side of each node a FLOATING edge leaves from / arrives at. draw.io's
+// rule: the pair of facing sides along the axis with the larger gap; when
+// the rectangles overlap on both axes, the sides the centre vector points
+// through. A previous choice is kept while the gaps are nearly equal so a
+// node dragged along the diagonal does not flip its edges every frame.
+import { rectCenter, sideMidpoint } from "../geometry.js";
+const HYSTERESIS = 24;
+const sideToward = (from, to) => {
+    const center = rectCenter(from);
+    const dx = to.x - center.x;
+    const dy = to.y - center.y;
+    // Compare against the rectangle's aspect so wide nodes prefer left/right.
+    if (Math.abs(dx) * from.height >= Math.abs(dy) * from.width)
+        return dx >= 0 ? "right" : "left";
+    return dy >= 0 ? "bottom" : "top";
+};
+export const chooseSides = (source, target, fixed = {}, previous) => {
+    if (fixed.source && fixed.target)
+        return { source: fixed.source, target: fixed.target };
+    if (fixed.source)
+        return { source: fixed.source, target: sideToward(target, sideMidpoint(source, fixed.source)) };
+    if (fixed.target)
+        return { source: sideToward(source, sideMidpoint(target, fixed.target)), target: fixed.target };
+    const gapX = Math.max(target.x - (source.x + source.width), source.x - (target.x + target.width));
+    const gapY = Math.max(target.y - (source.y + source.height), source.y - (target.y + target.height));
+    const sc = rectCenter(source);
+    const tc = rectCenter(target);
+    let horizontal;
+    if (previous?.source && previous.target && Math.abs(gapX - gapY) < HYSTERESIS) {
+        horizontal = previous.source === "left" || previous.source === "right";
+    }
+    else if (gapX < 0 && gapY < 0) {
+        // Overlapping on both axes: go by the centre vector.
+        horizontal = Math.abs(tc.x - sc.x) >= Math.abs(tc.y - sc.y);
+    }
+    else {
+        horizontal = gapX >= gapY;
+    }
+    if (horizontal) {
+        return tc.x >= sc.x ? { source: "right", target: "left" } : { source: "left", target: "right" };
+    }
+    return tc.y >= sc.y ? { source: "bottom", target: "top" } : { source: "top", target: "bottom" };
+};
+export const sidesFor = (source, target, previous) => chooseSides(source.rect, target.rect, { source: source.side, target: target.side }, previous);
+export const sideVector = (side) => {
+    switch (side) {
+        case "top":
+            return { x: 0, y: -1 };
+        case "bottom":
+            return { x: 0, y: 1 };
+        case "left":
+            return { x: -1, y: 0 };
+        case "right":
+        default:
+            return { x: 1, y: 0 };
+    }
+};
+// The point on the boundary where a terminal attaches: the explicit point
+// when given (legacy anchors, free ends), else the side's midpoint.
+export const attachPoint = (terminal, side) => terminal.point ?? sideMidpoint(terminal.rect, side);
+// Where the straight line from the rectangle's centre toward `toward` leaves
+// the rectangle — used by straight and curved edges so they meet the outline.
+export const boundaryToward = (rect, toward) => {
+    const c = rectCenter(rect);
+    const dx = toward.x - c.x;
+    const dy = toward.y - c.y;
+    if (dx === 0 && dy === 0)
+        return { x: c.x, y: rect.y };
+    const hw = rect.width / 2;
+    const hh = rect.height / 2;
+    const scale = Math.min(hw / Math.max(Math.abs(dx), 1e-9), hh / Math.max(Math.abs(dy), 1e-9));
+    return { x: c.x + dx * scale, y: c.y + dy * scale };
+};
+//# sourceMappingURL=sides.js.map

package/dist/diagram/routing/sides.js.map

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

package/dist/diagram/routing/types.d.ts

@@ -0,0 +1,46 @@
+import type { Rect } from "../geometry.js";
+import type { DiagramRouting, HandleSide, Point } from "../schema.js";
+export type { Rect } from "../geometry.js";
+export type Side = HandleSide;
+export interface Terminal {
+    rect: Rect;
+    side?: Side;
+    point?: Point;
+}
+export interface RoutedPath {
+    points: Point[];
+    kind: "orthogonal" | "straight" | "curved";
+    sourceSide: Side;
+    targetSide: Side;
+    curves?: Array<[Point, Point, Point]>;
+    via: "orthogonal" | "smart" | "smart-fallback" | "straight" | "curved" | "waypoints" | "legacy";
+}
+export interface RouteOptions {
+    margin?: number;
+    cornerRadius?: number;
+    bendPenalty?: number;
+    hugPenalty?: number;
+    nudgeGap?: number;
+    regionPad?: number;
+    smartObstacleLimit?: number;
+    previous?: {
+        source?: Side;
+        target?: Side;
+    };
+}
+export interface ResolvedRouteOptions {
+    margin: number;
+    cornerRadius: number;
+    bendPenalty: number;
+    hugPenalty: number;
+    nudgeGap: number;
+    regionPad: number;
+    smartObstacleLimit: number;
+    previous?: {
+        source?: Side;
+        target?: Side;
+    };
+}
+export declare const resolveRouteOptions: (options?: RouteOptions) => ResolvedRouteOptions;
+export type { DiagramRouting, Point };
+//# sourceMappingURL=types.d.ts.map

package/dist/diagram/routing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/diagram/routing/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAEtE,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,MAAM,MAAM,IAAI,GAAG,UAAU,CAAC;AAI9B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IAIzB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3C,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtC,GAAG,EAAE,YAAY,GAAG,OAAO,GAAG,gBAAgB,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;CACjG;AAED,MAAM,WAAW,YAAY;IAE3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC;CAC7C;AAED,eAAO,MAAM,mBAAmB,GAAI,UAAS,YAAiB,KAAG,oBAS/D,CAAC;AAEH,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC"}

package/dist/diagram/routing/types.js

@@ -0,0 +1,11 @@
+export const resolveRouteOptions = (options = {}) => ({
+    margin: options.margin ?? 24,
+    cornerRadius: options.cornerRadius ?? 8,
+    bendPenalty: options.bendPenalty ?? 30,
+    hugPenalty: options.hugPenalty ?? 6,
+    nudgeGap: options.nudgeGap ?? 6,
+    regionPad: options.regionPad ?? 200,
+    smartObstacleLimit: options.smartObstacleLimit ?? 60,
+    previous: options.previous,
+});
+//# sourceMappingURL=types.js.map

package/dist/diagram/routing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/diagram/routing/types.ts"],"names":[],"mappings":"AA+DA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAwB,EAAE,EAAwB,EAAE,CAAC,CAAC;IACxF,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;IAC5B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;IACvC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;IACtC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;IACnC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,EAAE;IACpD,QAAQ,EAAE,OAAO,CAAC,QAAQ;CAC3B,CAAC,CAAC"}

package/dist/diagram/schema.d.ts

@@ -1,6 +1,19 @@
 export declare const SCHEMA_VERSION: 1;
-export type DiagramRouting = "orthogonal" | "straight" | "curved";
-export type ArrowType = "none" | "classic" | "classicThin" | "open" | "block" | "diamond" | "oval";
+export type DiagramRouting = "orthogonal" | "straight" | "curved" | "smart";
+export declare const DIAGRAM_ROUTINGS: readonly DiagramRouting[];
+export type ArrowType = "none" | "classic" | "classicThin" | "open" | "block" | "diamond" | "oval" | "one" | "many" | "zeroOne" | "zeroMany";
+export declare const ARROW_TYPES: readonly ArrowType[];
+export type HandleSide = "top" | "right" | "bottom" | "left";
+export declare const HANDLE_SIDES: readonly HandleSide[];
+export declare const isHandleSide: (value: unknown) => value is HandleSide;
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
 export type TokenRef = {
     token: string;
 } | {
@@ -24,59 +37,55 @@ export interface DiagramStyle {
     shadow?: boolean;
     opacity?: number;
 }
+export interface LegacyAnchor {
+    x: number;
+    y: number;
+    dx?: number;
+    dy?: number;
+    perimeter?: boolean;
+}
+export interface DiagramCallmanBinding {
+    kind: "request" | "scenario" | "connection" | "environment" | "mock" | "kafkaTopic";
+    id: string;
+    workspaceId?: string;
+    name?: string;
+}
 export interface DiagramNode {
     id: string;
     type: string;
-    position: {
-        x: number;
-        y: number;
-    };
-    size: {
-        width: number;
-        height: number;
-    };
+    position: Point;
+    size: Size;
     label?: string;
     rotation?: number;
     style?: DiagramStyle;
-    data?: Record<string, unknown>;
+    data?: Record<string, unknown> & {
+        callman?: DiagramCallmanBinding;
+    };
     parentId?: string;
-    z?: number;
     hidden?: boolean;
     locked?: boolean;
+    collapsed?: boolean;
+    collapsedSize?: Size;
+    /** @deprecated never read or written — array order IS the z-order. Stripped by normalizeDocument. */
+    z?: number;
 }
 export interface DiagramEdge {
     id: string;
     source?: string;
     target?: string;
-    sourcePoint?: {
-        x: number;
-        y: number;
-    };
-    targetPoint?: {
-        x: number;
-        y: number;
-    };
-    sourceAnchor?: {
-        x: number;
-        y: number;
-        dx?: number;
-        dy?: number;
-        perimeter?: boolean;
-    };
-    targetAnchor?: {
-        x: number;
-        y: number;
-        dx?: number;
-        dy?: number;
-        perimeter?: boolean;
-    };
+    sourcePoint?: Point;
+    targetPoint?: Point;
+    sourceAnchor?: LegacyAnchor;
+    targetAnchor?: LegacyAnchor;
+    sourceHandle?: HandleSide;
+    targetHandle?: HandleSide;
     label?: string;
+    labelPosition?: number;
+    labelOffset?: Point;
     routing?: DiagramRouting;
     style?: DiagramStyle;
-    waypoints?: Array<{
-        x: number;
-        y: number;
-    }>;
+    waypoints?: Point[];
+    data?: Record<string, unknown>;
     markerStart?: ArrowType;
     markerEnd?: ArrowType;
 }
@@ -85,10 +94,33 @@ export interface DiagramMeta {
     createdAt: string;
     updatedAt: string;
     appVersion?: string;
+    revision?: number;
 }
+export type LayoutAlgorithm = "layered" | "tree" | "organic" | "radial" | "force";
+export type LayoutDirection = "DOWN" | "RIGHT" | "UP" | "LEFT";
+export declare const LAYOUT_DIRECTIONS: readonly LayoutDirection[];
 export interface DiagramCanvasState {
     background?: "grid" | "dots" | "blank";
     gridSize?: number;
+    viewport?: {
+        x: number;
+        y: number;
+        zoom: number;
+    };
+    layout?: {
+        algorithm: LayoutAlgorithm;
+        direction: LayoutDirection;
+    };
+    defaultRouting?: DiagramRouting;
+}
+export type DiagramSourceFormat = "mermaid" | "bpmn" | "database";
+export interface DiagramSource {
+    format: DiagramSourceFormat;
+    text: string;
+    diagramType: string;
+    grammar?: string;
+    hash?: string;
+    valid?: boolean;
 }
 export interface DiagramDocument {
     schemaVersion: number;
@@ -97,6 +129,7 @@ export interface DiagramDocument {
     canvas?: DiagramCanvasState;
     nodes: DiagramNode[];
     edges: DiagramEdge[];
+    source?: DiagramSource;
 }
 export declare const nowIso: () => string;
 export declare const genId: (prefix?: string) => string;

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

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

package/dist/diagram/schema.js

@@ -1,12 +1,23 @@
 // The diagram DSL — the single source of truth for a diagram. A plain,
-// versioned, git-diffable JSON model that is independent of any renderer
-// (maxGraph in the desktop is just an editor of this document). AI generation,
-// the MCP server and DB persistence produce/consume exactly this shape.
+// versioned, git-diffable JSON model that is independent of any renderer.
+// AI generation, the MCP server, DB persistence and the desktop editor all
+// produce/consume exactly this shape, and every EDIT — from the canvas, from
+// an AI reply, from an MCP tool — is an operation on it (see ops.ts).
+//
+// Versioning policy: `schemaVersion` stays 1 while the shape only GROWS
+// (optional fields). Every reader ignores keys it does not know, so a newer
+// document still opens in an older host; a breaking change bumps the version
+// and registers a step in migrations.ts. The additive fields of the rebuilt
+// studio are marked "(1.29)" below.
 //
-// Moved here from the desktop so every host validates with ONE validator.
 // zod is intentionally NOT used: the hand validator keeps the module
 // dependency-free and CSP-safe (it runs in the Electron renderer).
 export const SCHEMA_VERSION = 1;
+export const DIAGRAM_ROUTINGS = ["orthogonal", "straight", "curved", "smart"];
+export const ARROW_TYPES = ["none", "classic", "classicThin", "open", "block", "diamond", "oval", "one", "many", "zeroOne", "zeroMany"];
+export const HANDLE_SIDES = ["top", "right", "bottom", "left"];
+export const isHandleSide = (value) => typeof value === "string" && HANDLE_SIDES.includes(value);
+export const LAYOUT_DIRECTIONS = ["DOWN", "RIGHT", "UP", "LEFT"];
 // --- id + time helpers -----------------------------------------------------
 export const nowIso = () => new Date().toISOString();
 const randomBytes = (length) => {
@@ -55,6 +66,8 @@ export class DiagramValidationError extends Error {
 const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 const isNum = (v) => typeof v === "number" && Number.isFinite(v);
 const isStr = (v) => typeof v === "string";
+const isPoint = (v) => isObject(v) && isNum(v.x) && isNum(v.y);
+const isSize = (v) => isObject(v) && isNum(v.width) && isNum(v.height);
 const validateNode = (n, i, errors) => {
     if (!isObject(n))
         return void errors.push(`nodes[${i}] is not an object`);
@@ -62,12 +75,15 @@ const validateNode = (n, i, errors) => {
         errors.push(`nodes[${i}].id must be a string`);
     if (!isStr(n.type))
         errors.push(`nodes[${i}].type must be a string`);
-    if (!isObject(n.position) || !isNum(n.position.x) || !isNum(n.position.y))
+    if (!isPoint(n.position))
         errors.push(`nodes[${i}].position must be { x:number, y:number }`);
-    if (!isObject(n.size) || !isNum(n.size.width) || !isNum(n.size.height))
+    if (!isSize(n.size))
         errors.push(`nodes[${i}].size must be { width:number, height:number }`);
+    if (n.collapsedSize !== undefined && !isSize(n.collapsedSize))
+        errors.push(`nodes[${i}].collapsedSize must be { width:number, height:number }`);
+    if (n.parentId !== undefined && !isStr(n.parentId))
+        errors.push(`nodes[${i}].parentId must be a string`);
 };
-const isPoint = (v) => isObject(v) && isNum(v.x) && isNum(v.y);
 const validateEdge = (e, i, ids, errors) => {
     if (!isObject(e))
         return void errors.push(`edges[${i}] is not an object`);
@@ -93,6 +109,42 @@ const validateEdge = (e, i, ids, errors) => {
     else if (!isPoint(e.targetPoint)) {
         errors.push(`edges[${i}] needs a target id or a targetPoint { x, y }`);
     }
+    if (e.sourceHandle !== undefined && !isHandleSide(e.sourceHandle))
+        errors.push(`edges[${i}].sourceHandle must be one of ${HANDLE_SIDES.join(", ")}`);
+    if (e.targetHandle !== undefined && !isHandleSide(e.targetHandle))
+        errors.push(`edges[${i}].targetHandle must be one of ${HANDLE_SIDES.join(", ")}`);
+    if (e.routing !== undefined && !DIAGRAM_ROUTINGS.includes(e.routing))
+        errors.push(`edges[${i}].routing must be one of ${DIAGRAM_ROUTINGS.join(", ")}`);
+    if (e.labelPosition !== undefined && !isNum(e.labelPosition))
+        errors.push(`edges[${i}].labelPosition must be a number`);
+    if (e.labelOffset !== undefined && !isPoint(e.labelOffset))
+        errors.push(`edges[${i}].labelOffset must be { x:number, y:number }`);
+    if (e.waypoints !== undefined && (!Array.isArray(e.waypoints) || !e.waypoints.every(isPoint)))
+        errors.push(`edges[${i}].waypoints must be an array of { x:number, y:number }`);
+};
+const validateCanvas = (c, errors) => {
+    if (c === undefined)
+        return;
+    if (!isObject(c))
+        return void errors.push("canvas must be an object");
+    if (c.viewport !== undefined && !(isObject(c.viewport) && isNum(c.viewport.x) && isNum(c.viewport.y) && isNum(c.viewport.zoom)))
+        errors.push("canvas.viewport must be { x, y, zoom } numbers");
+    if (c.defaultRouting !== undefined && !DIAGRAM_ROUTINGS.includes(c.defaultRouting))
+        errors.push(`canvas.defaultRouting must be one of ${DIAGRAM_ROUTINGS.join(", ")}`);
+    if (c.layout !== undefined && !(isObject(c.layout) && isStr(c.layout.algorithm) && isStr(c.layout.direction)))
+        errors.push("canvas.layout must be { algorithm, direction }");
+};
+const validateSource = (s, errors) => {
+    if (s === undefined)
+        return;
+    if (!isObject(s))
+        return void errors.push("source must be an object");
+    if (s.format !== "mermaid" && s.format !== "bpmn" && s.format !== "database")
+        errors.push('source.format must be "mermaid", "bpmn" or "database"');
+    if (!isStr(s.text))
+        errors.push("source.text must be a string");
+    if (!isStr(s.diagramType))
+        errors.push("source.diagramType must be a string");
 };
 export const safeParseDiagramDocument = (input) => {
     const errors = [];
@@ -113,7 +165,7 @@ export const safeParseDiagramDocument = (input) => {
     const nodes = input.nodes;
     const edges = input.edges;
     nodes.forEach((n, i) => validateNode(n, i, errors));
-    // Valid edge terminals = node ids + edge ids (edges may connect to edges).
+    // Valid edge terminals = node ids + edge ids (legacy edges may connect to edges).
     const terminalIds = new Set();
     for (const n of nodes)
         if (isObject(n) && isStr(n.id))
@@ -122,6 +174,8 @@ export const safeParseDiagramDocument = (input) => {
         if (isObject(e) && isStr(e.id))
             terminalIds.add(e.id);
     edges.forEach((e, i) => validateEdge(e, i, terminalIds, errors));
+    validateCanvas(input.canvas, errors);
+    validateSource(input.source, errors);
     if (errors.length)
         return { ok: false, errors };
     return { ok: true, document: input };