@aetherwing/fcp-drawio 0.2.0

package/dist/types/index.d.ts

@@ -0,0 +1,238 @@
+export type ShapeType = "box" | "svc" | "circle" | "decision" | "db" | "api" | "cloud" | "actor" | "doc" | "queue" | "triangle" | "process";
+export type ArrowType = "arrow" | "open-arrow" | "diamond" | "circle" | "crow-foot" | "none";
+export type EdgeStyleType = "solid" | "dashed" | "dotted" | "animated" | "thick" | "curved" | "orthogonal";
+export type ArrowOperator = "->" | "<->" | "--";
+export type Direction = "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
+export type FlowDirection = "TB" | "LR" | "BT" | "RL";
+export type ThemeName = "blue" | "green" | "red" | "yellow" | "orange" | "purple" | "gray" | "dark" | "white";
+export interface Bounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface StyleSet {
+    fillColor: string | null;
+    strokeColor: string | null;
+    fontColor: string | null;
+    fontSize: number | null;
+    fontFamily: string | null;
+    fontStyle: number | null;
+    rounded: boolean;
+    dashed: boolean;
+    shadow: boolean;
+    opacity: number;
+    align: string | null;
+    verticalAlign: string | null;
+    [key: string]: unknown;
+}
+export interface EdgeStyleSet extends StyleSet {
+    edgeStyle: string;
+    curved: boolean;
+    flowAnimation: boolean;
+    dotted: boolean;
+}
+export interface ThemeColors {
+    fill: string;
+    stroke: string;
+    fontColor?: string;
+}
+export interface ShapeMetadata {
+    tooltip?: string;
+    badges?: Badge[];
+    custom?: Record<string, unknown>;
+}
+export interface Badge {
+    text: string;
+    position: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+}
+export interface Shape {
+    id: string;
+    label: string;
+    type: ShapeType;
+    bounds: Bounds;
+    style: StyleSet;
+    parentGroup: string | null;
+    layer: string;
+    metadata: ShapeMetadata;
+    baseStyleOverride?: string;
+    createdAt: number;
+    modifiedAt: number;
+}
+export interface Edge {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    label: string | null;
+    style: EdgeStyleSet;
+    waypoints: Point[];
+    sourceArrow: ArrowType;
+    targetArrow: ArrowType;
+    createdAt: number;
+    modifiedAt: number;
+}
+export interface Group {
+    id: string;
+    name: string;
+    memberIds: Set<string>;
+    isContainer: boolean;
+    collapsed: boolean;
+    bounds: Bounds;
+    style: StyleSet;
+}
+export interface Layer {
+    id: string;
+    name: string;
+    visible: boolean;
+    locked: boolean;
+    order: number;
+}
+export interface Page {
+    id: string;
+    name: string;
+    shapes: Map<string, Shape>;
+    edges: Map<string, Edge>;
+    groups: Map<string, Group>;
+    layers: Layer[];
+    defaultLayer: string;
+    flowDirection?: FlowDirection;
+}
+export interface DiagramMetadata {
+    host: string;
+    modified: string;
+    version: string;
+}
+export interface CustomType {
+    name: string;
+    base: ShapeType;
+    theme?: ThemeName;
+    badge?: string;
+    defaultSize?: {
+        width: number;
+        height: number;
+    };
+}
+export interface CustomTheme {
+    name: string;
+    fill: string;
+    stroke: string;
+    fontColor?: string;
+}
+export interface Diagram {
+    id: string;
+    title: string;
+    filePath: string | null;
+    pages: Page[];
+    activePage: string;
+    customTypes: Map<string, CustomType>;
+    customThemes: Map<string, CustomTheme>;
+    loadedStencilPacks: Set<string>;
+    metadata: DiagramMetadata;
+}
+export type DiagramEvent = {
+    type: "shape_created";
+    shape: Shape;
+} | {
+    type: "shape_modified";
+    id: string;
+    before: Partial<Shape>;
+    after: Partial<Shape>;
+} | {
+    type: "shape_deleted";
+    shape: Shape;
+} | {
+    type: "edge_created";
+    edge: Edge;
+} | {
+    type: "edge_modified";
+    id: string;
+    before: Partial<Edge>;
+    after: Partial<Edge>;
+} | {
+    type: "edge_deleted";
+    edge: Edge;
+} | {
+    type: "group_created";
+    group: Group;
+} | {
+    type: "group_modified";
+    id: string;
+    before: Partial<Group>;
+    after: Partial<Group>;
+} | {
+    type: "group_dissolved";
+    group: Group;
+} | {
+    type: "page_added";
+    page: Page;
+} | {
+    type: "page_removed";
+    page: Page;
+} | {
+    type: "layer_created";
+    layer: Layer;
+    pageId: string;
+} | {
+    type: "layer_modified";
+    pageId: string;
+    layerId: string;
+    before: Partial<Layer>;
+    after: Partial<Layer>;
+} | {
+    type: "flow_direction_changed";
+    pageId: string;
+    before: string | undefined;
+    after: string;
+} | {
+    type: "title_changed";
+    before: string;
+    after: string;
+} | {
+    type: "checkpoint";
+    name: string;
+    eventIndex: number;
+};
+export interface EventLog {
+    events: DiagramEvent[];
+    cursor: number;
+    checkpoints: Map<string, number>;
+}
+export type Verb = "add" | "remove" | "define" | "connect" | "disconnect" | "style" | "label" | "badge" | "move" | "resize" | "swap" | "layout" | "orient" | "group" | "ungroup" | "layer" | "page" | "checkpoint" | "title" | "load";
+export interface KeyValue {
+    key: string;
+    value: string;
+}
+export interface ParsedOp {
+    verb: Verb;
+    raw: string;
+    type?: string;
+    target?: string;
+    targets?: string[];
+    arrows?: ArrowOperator[];
+    params: Map<string, string>;
+    selector?: string;
+    subcommand?: string;
+}
+export type SelectorType = "type" | "group" | "connected" | "page" | "layer" | "recent" | "all" | "orphan";
+export interface Selector {
+    kind: SelectorType;
+    value?: string;
+}
+export interface OpResult {
+    success: boolean;
+    message: string;
+    warnings?: string[];
+    suggestion?: string;
+}
+export interface NodeTypeDefinition {
+    shorthand: ShapeType;
+    drawioShape: string;
+    baseStyle: string;
+    defaultWidth: number;
+    defaultHeight: number;
+    description: string;
+}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// ── Shape Types ──────────────────────────────────────────────
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/verb-specs.d.ts

@@ -0,0 +1,6 @@
+import type { VerbSpec } from "@aetherwing/fcp-core";
+/**
+ * All verb specifications for the drawio FCP domain.
+ * Used for reference card generation and verb validation.
+ */
+export declare const DRAWIO_VERB_SPECS: VerbSpec[];

package/dist/verb-specs.js

@@ -0,0 +1,144 @@
+/**
+ * All verb specifications for the drawio FCP domain.
+ * Used for reference card generation and verb validation.
+ */
+export const DRAWIO_VERB_SPECS = [
+    // ── Shapes ────────────────────────────────────────────────
+    {
+        verb: "add",
+        syntax: "add TYPE LABEL [theme:T] [near:REF dir:DIR] [at:X,Y] [size:WxH] [label:\"Display Name\"]",
+        category: "shapes",
+        params: ["theme", "near", "dir", "at", "size", "label", "in", "count"],
+        description: "Add a shape to the diagram",
+    },
+    {
+        verb: "remove",
+        syntax: "remove REF | remove @SELECTOR",
+        category: "shapes",
+        description: "Remove a shape or shapes matching a selector",
+    },
+    {
+        verb: "define",
+        syntax: "define NAME base:TYPE [theme:T] [badge:\"text\"] [size:WxH]",
+        category: "shapes",
+        params: ["base", "theme", "badge", "size", "name", "fill", "stroke", "font-color"],
+        description: "Define a custom type or theme",
+    },
+    // ── Connections ────────────────────────────────────────────
+    {
+        verb: "connect",
+        syntax: "connect SRC ARROW TGT [label:\"text\"] [style:STYLE] [exit:FACE entry:FACE]",
+        category: "connections",
+        params: ["label", "style", "exit", "entry", "source-arrow", "target-arrow"],
+        description: "Connect two shapes with an edge",
+    },
+    {
+        verb: "disconnect",
+        syntax: "disconnect SRC -> TGT",
+        category: "connections",
+        description: "Remove an edge between two shapes",
+    },
+    // ── Appearance ─────────────────────────────────────────────
+    {
+        verb: "style",
+        syntax: "style REF [fill:#HEX] [stroke:#HEX] [font:#HEX] [fontSize:N] [bold] [italic]",
+        category: "appearance",
+        params: ["fill", "stroke", "font", "font-color", "fontSize", "font-size", "opacity", "rounded", "dashed", "shadow", "font-family", "align", "valign", "theme"],
+        description: "Change style properties of a shape or selector",
+    },
+    {
+        verb: "label",
+        syntax: "label REF \"new text\" | label SRC -> TGT \"new text\"",
+        category: "appearance",
+        description: "Rename a shape or relabel an edge",
+    },
+    {
+        verb: "badge",
+        syntax: "badge REF \"text\" [pos:POSITION]",
+        category: "appearance",
+        params: ["pos"],
+        description: "Add a badge to a shape",
+    },
+    // ── Position ───────────────────────────────────────────────
+    {
+        verb: "move",
+        syntax: "move REF to:X,Y | to:REGION | near:REF dir:DIR",
+        category: "position",
+        params: ["to", "near", "dir", "strict"],
+        description: "Move a shape or group",
+    },
+    {
+        verb: "resize",
+        syntax: "resize REF to:WxH",
+        category: "position",
+        params: ["to"],
+        description: "Resize a shape",
+    },
+    {
+        verb: "swap",
+        syntax: "swap REF REF",
+        category: "position",
+        description: "Exchange positions of two shapes",
+    },
+    {
+        verb: "layout",
+        syntax: "layout @all algo:layered|force|tree dir:TB|LR|BT|RL [spacing:N]",
+        category: "position",
+        params: ["algo", "dir", "spacing"],
+        description: "Apply automatic layout to the diagram",
+    },
+    {
+        verb: "orient",
+        syntax: "orient TB|LR|BT|RL",
+        category: "position",
+        description: "Set the page flow direction",
+    },
+    // ── Organization ───────────────────────────────────────────
+    {
+        verb: "group",
+        syntax: "group REF REF ... as:\"Group Name\"",
+        category: "organization",
+        params: ["as", "label", "theme"],
+        description: "Group shapes together",
+    },
+    {
+        verb: "ungroup",
+        syntax: "ungroup \"Group Name\"",
+        category: "organization",
+        description: "Dissolve a group",
+    },
+    // ── Pages & Layers ─────────────────────────────────────────
+    {
+        verb: "page",
+        syntax: "page add|switch|remove|list \"Name\"",
+        category: "structure",
+        description: "Manage diagram pages",
+    },
+    {
+        verb: "layer",
+        syntax: "layer create|switch|show|hide|list \"Name\"",
+        category: "structure",
+        description: "Manage diagram layers",
+    },
+    // ── Meta ───────────────────────────────────────────────────
+    {
+        verb: "checkpoint",
+        syntax: "checkpoint NAME",
+        category: "meta",
+        description: "Create a named snapshot for undo",
+    },
+    {
+        verb: "title",
+        syntax: "title \"Diagram Title\"",
+        category: "meta",
+        description: "Set the diagram title",
+    },
+    {
+        verb: "load",
+        syntax: "load list | load PACK",
+        category: "meta",
+        params: [],
+        description: "Load a stencil pack (aws, azure, gcp, k8s, cisco, ibm)",
+    },
+];
+//# sourceMappingURL=verb-specs.js.map

package/dist/verb-specs.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@aetherwing/fcp-drawio",
+  "version": "0.2.0",
+  "description": "MCP server for creating and editing draw.io diagrams through intent-level commands",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@aetherwing/fcp-core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "elkjs": "^0.11.0",
+    "fast-xml-parser": "^4.5.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/aetherwing-io/fcp-drawio" },
+  "keywords": ["drawio", "diagrams", "architecture", "mcp", "fcp"]
+}