@obra-studio/figma-console-mcp 1.32.0

package/dist/core/accessibility-tools.js.map

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

package/dist/core/annotation-tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Figma Annotations MCP Tools
+ * Tools for reading, writing, and managing design annotations on Figma nodes.
+ * Annotations are a Plugin API feature — requires Desktop Bridge plugin connection.
+ *
+ * Annotations are distinct from comments: they are node-level design specs that
+ * can pin specific properties (fills, width, typography, etc.) and support
+ * markdown-formatted labels. Designers use them to communicate animation timings,
+ * accessibility requirements, interaction specs, and other implementation details
+ * that don't fit in the description field.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnnotationTools(server: McpServer, getDesktopConnector: () => Promise<any>): void;
+//# sourceMappingURL=annotation-tools.d.ts.map

package/dist/core/annotation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-tools.d.ts","sourceRoot":"","sources":["../../src/core/annotation-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4EzE,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACrC,IAAI,CA0LN"}

package/dist/core/annotation-tools.js

@@ -0,0 +1,231 @@
+/**
+ * Figma Annotations MCP Tools
+ * Tools for reading, writing, and managing design annotations on Figma nodes.
+ * Annotations are a Plugin API feature — requires Desktop Bridge plugin connection.
+ *
+ * Annotations are distinct from comments: they are node-level design specs that
+ * can pin specific properties (fills, width, typography, etc.) and support
+ * markdown-formatted labels. Designers use them to communicate animation timings,
+ * accessibility requirements, interaction specs, and other implementation details
+ * that don't fit in the description field.
+ */
+import { z } from "zod";
+import { createChildLogger } from "./logger.js";
+const logger = createChildLogger({ component: "annotation-tools" });
+// Valid AnnotationPropertyType values from the Figma Plugin API
+// Sourced from @figma/plugin-typings — keep in sync with AnnotationPropertyType union
+// Reference: https://developers.figma.com/docs/plugins/api/AnnotationProperty
+const ANNOTATION_PROPERTY_TYPES = [
+    "width",
+    "height",
+    "maxWidth",
+    "minWidth",
+    "maxHeight",
+    "minHeight",
+    "fills",
+    "strokes",
+    "effects",
+    "strokeWeight",
+    "cornerRadius",
+    "textStyleId",
+    "textAlignHorizontal",
+    "fontFamily",
+    "fontStyle",
+    "fontSize",
+    "fontWeight",
+    "lineHeight",
+    "letterSpacing",
+    "itemSpacing",
+    "padding",
+    "layoutMode",
+    "alignItems",
+    "opacity",
+    "mainComponent",
+    "gridRowGap",
+    "gridColumnGap",
+    "gridRowCount",
+    "gridColumnCount",
+    "gridRowAnchorIndex",
+    "gridColumnAnchorIndex",
+    "gridRowSpan",
+    "gridColumnSpan",
+];
+// Zod schema for annotation property
+const annotationPropertySchema = z.object({
+    type: z
+        .enum(ANNOTATION_PROPERTY_TYPES)
+        .describe("Design property to pin (e.g., 'fills', 'width', 'fontSize')"),
+});
+// Zod schema for a single annotation
+const annotationSchema = z.object({
+    label: z
+        .string()
+        .optional()
+        .describe("Plain text annotation label"),
+    labelMarkdown: z
+        .string()
+        .optional()
+        .describe("Rich text annotation label with markdown formatting. Supports bold, italic, links, lists, code, and headers."),
+    properties: z
+        .array(annotationPropertySchema)
+        .optional()
+        .describe("Design properties to pin to this annotation (e.g., fills, width, fontSize)"),
+    categoryId: z
+        .string()
+        .optional()
+        .describe("Annotation category ID. Use figma_get_annotation_categories to list available categories."),
+});
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerAnnotationTools(server, getDesktopConnector) {
+    // -----------------------------------------------------------------------
+    // Tool: figma_get_annotations
+    // -----------------------------------------------------------------------
+    server.tool("figma_get_annotations", "Read annotations from a Figma node. Annotations are designer-authored specs attached to nodes — they can include notes (plain text or markdown), pinned design properties (fills, width, fontSize, etc.), and category labels. Use this to discover animation timings, interaction specs, accessibility requirements, and other implementation details that designers annotate directly on the design. Set include_children=true to get annotations from child nodes too (useful for full component documentation). Requires Desktop Bridge plugin.", {
+        nodeId: z
+            .string()
+            .describe("Node ID to read annotations from (e.g., '695:313')"),
+        include_children: z.preprocess((v) => (typeof v === "string" ? v === "true" : v), z.boolean().optional().default(false)).describe("Also read annotations from child nodes. Useful for getting all annotations within a component tree."),
+        depth: z.preprocess((v) => (typeof v === "string" ? Number(v) : v), z.number().optional().default(1)).describe("How many levels deep to traverse when include_children is true (default: 1, max recommended: 5)"),
+    }, async ({ nodeId, include_children = false, depth = 1 }) => {
+        try {
+            logger.info({ nodeId, include_children, depth }, "Getting annotations");
+            const connector = await getDesktopConnector();
+            const result = await connector.getAnnotations(nodeId, include_children, Math.min(depth, 10));
+            if (!result || (result.success === false)) {
+                throw new Error(result?.error || "Failed to get annotations");
+            }
+            // The result may come back as { success, data } (WebSocket) or directly as data
+            const data = result.data || result;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error }, "Failed to get annotations");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "get_annotations_failed",
+                            message: `Cannot get annotations. ${message}`,
+                            hint: "Annotations require the Desktop Bridge plugin to be running in Figma.",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Tool: figma_set_annotations
+    // -----------------------------------------------------------------------
+    server.tool("figma_set_annotations", "Write or clear annotations on a Figma node. Annotations communicate design specs to developers — use them to document animation timings, easing curves, interaction behaviors, accessibility requirements, and implementation notes. Supports plain text labels, rich markdown labels, pinned design properties, and annotation categories. Pass an empty array to clear all annotations. Use mode='append' to add to existing annotations, or mode='replace' (default) to overwrite. Requires Desktop Bridge plugin. This operation is undoable in Figma (Cmd+Z).", {
+        nodeId: z
+            .string()
+            .describe("Node ID to write annotations to (e.g., '695:313')"),
+        annotations: z.preprocess((v) => {
+            if (typeof v === "string") {
+                try {
+                    return JSON.parse(v);
+                }
+                catch {
+                    return v;
+                }
+            }
+            return v;
+        }, z.array(annotationSchema)).describe("Array of annotations to set. Each annotation can have a label (plain or markdown), pinned properties, and a category. Pass an empty array [] to clear all annotations."),
+        mode: z
+            .enum(["replace", "append"])
+            .optional()
+            .default("replace")
+            .describe("'replace' (default) overwrites all existing annotations. 'append' adds new annotations while keeping existing ones."),
+    }, async ({ nodeId, annotations, mode = "replace" }) => {
+        try {
+            logger.info({ nodeId, count: annotations.length, mode }, "Setting annotations");
+            const connector = await getDesktopConnector();
+            const result = await connector.setAnnotations(nodeId, annotations, mode);
+            if (!result || (result.success === false)) {
+                throw new Error(result?.error || "Failed to set annotations");
+            }
+            const data = result.data || result;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            ...data,
+                            note: "Annotations set successfully. This operation is undoable in Figma (Cmd+Z).",
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error }, "Failed to set annotations");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "set_annotations_failed",
+                            message: `Cannot set annotations. ${message}`,
+                            hint: "Annotations require the Desktop Bridge plugin to be running in Figma.",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Tool: figma_get_annotation_categories
+    // -----------------------------------------------------------------------
+    server.tool("figma_get_annotation_categories", "List available annotation categories in the current Figma file. Categories group annotations by purpose (e.g., interactions, accessibility, development notes). Use the returned category IDs when creating annotations with figma_set_annotations. Requires Desktop Bridge plugin.", {}, async () => {
+        try {
+            logger.info("Getting annotation categories");
+            const connector = await getDesktopConnector();
+            const result = await connector.getAnnotationCategories();
+            if (!result || (result.success === false)) {
+                throw new Error(result?.error || "Failed to get annotation categories");
+            }
+            const data = result.data || result;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(data),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error({ error }, "Failed to get annotation categories");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "get_annotation_categories_failed",
+                            message: `Cannot get annotation categories. ${message}`,
+                            hint: "Annotation categories require the Desktop Bridge plugin to be running in Figma.",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=annotation-tools.js.map

package/dist/core/annotation-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-tools.js","sourceRoot":"","sources":["../../src/core/annotation-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAEpE,gEAAgE;AAChE,sFAAsF;AACtF,8EAA8E;AAC9E,MAAM,yBAAyB,GAAG;IACjC,OAAO;IACP,QAAQ;IACR,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,OAAO;IACP,SAAS;IACT,SAAS;IACT,cAAc;IACd,cAAc;IACd,aAAa;IACb,qBAAqB;IACrB,YAAY;IACZ,WAAW;IACX,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,aAAa;IACb,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,eAAe;IACf,YAAY;IACZ,eAAe;IACf,cAAc;IACd,iBAAiB;IACjB,oBAAoB;IACpB,uBAAuB;IACvB,aAAa;IACb,gBAAgB;CACP,CAAC;AAEX,qCAAqC;AACrC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC;SACL,IAAI,CAAC,yBAAyB,CAAC;SAC/B,QAAQ,CAAC,6DAA6D,CAAC;CACzE,CAAC,CAAC;AAEH,qCAAqC;AACrC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;IACzC,aAAa,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8GAA8G,CAAC;IAC1H,UAAU,EAAE,CAAC;SACX,KAAK,CAAC,wBAAwB,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;IACxF,UAAU,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2FAA2F,CAAC;CACvG,CAAC,CAAC;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,UAAU,uBAAuB,CACtC,MAAiB,EACjB,mBAAuC;IAEvC,0EAA0E;IAC1E,8BAA8B;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACV,uBAAuB,EACvB,qhBAAqhB,EACrhB;QACC,MAAM,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,oDAAoD,CAAC;QAChE,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EACjD,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CACrC,CAAC,QAAQ,CAAC,qGAAqG,CAAC;QACjH,KAAK,EAAE,CAAC,CAAC,UAAU,CAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAChC,CAAC,QAAQ,CAAC,iGAAiG,CAAC;KAC7G,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE;QACzD,IAAI;YACH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAExE,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,CAC5C,MAAM,EACN,gBAAgB,EAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CACnB,CAAC;YAEF,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE;gBAC1C,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,2BAA2B,CAAC,CAAC;aAC9D;YAED,gFAAgF;YAChF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;YAEnC,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;qBAC1B;iBACD;aACD,CAAC;SACF;QAAC,OAAO,KAAK,EAAE;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,2BAA2B,CAAC,CAAC;YAErD,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACpB,KAAK,EAAE,wBAAwB;4BAC/B,OAAO,EAAE,2BAA2B,OAAO,EAAE;4BAC7C,IAAI,EAAE,uEAAuE;yBAC7E,CAAC;qBACF;iBACD;gBACD,OAAO,EAAE,IAAI;aACb,CAAC;SACF;IACF,CAAC,CACD,CAAC;IAEF,0EAA0E;IAC1E,8BAA8B;IAC9B,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACV,uBAAuB,EACvB,oiBAAoiB,EACpiB;QACC,MAAM,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,mDAAmD,CAAC;QAC/D,WAAW,EAAE,CAAC,CAAC,UAAU,CACxB,CAAC,CAAC,EAAE,EAAE;YACL,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;gBAC1B,IAAI;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;iBAAE;gBAAC,MAAM;oBAAE,OAAO,CAAC,CAAC;iBAAE;aACjD;YACD,OAAO,CAAC,CAAC;QACV,CAAC,EACD,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CACzB,CAAC,QAAQ,CAAC,wKAAwK,CAAC;QACpL,IAAI,EAAE,CAAC;aACL,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;aAC3B,QAAQ,EAAE;aACV,OAAO,CAAC,SAAS,CAAC;aAClB,QAAQ,CAAC,qHAAqH,CAAC;KACjI,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE;QACnD,IAAI;YACH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAEhF,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;YAEzE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE;gBAC1C,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,2BAA2B,CAAC,CAAC;aAC9D;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;YAEnC,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACpB,OAAO,EAAE,IAAI;4BACb,GAAG,IAAI;4BACP,IAAI,EAAE,4EAA4E;yBAClF,CAAC;qBACF;iBACD;aACD,CAAC;SACF;QAAC,OAAO,KAAK,EAAE;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,2BAA2B,CAAC,CAAC;YAErD,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACpB,KAAK,EAAE,wBAAwB;4BAC/B,OAAO,EAAE,2BAA2B,OAAO,EAAE;4BAC7C,IAAI,EAAE,uEAAuE;yBAC7E,CAAC;qBACF;iBACD;gBACD,OAAO,EAAE,IAAI;aACb,CAAC;SACF;IACF,CAAC,CACD,CAAC;IAEF,0EAA0E;IAC1E,wCAAwC;IACxC,0EAA0E;IAC1E,MAAM,CAAC,IAAI,CACV,iCAAiC,EACjC,qRAAqR,EACrR,EAAE,EACF,KAAK,IAAI,EAAE;QACV,IAAI;YACH,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;YAE7C,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,uBAAuB,EAAE,CAAC;YAEzD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE;gBAC1C,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,qCAAqC,CAAC,CAAC;aACxE;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC;YAEnC,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;qBAC1B;iBACD;aACD,CAAC;SACF;QAAC,OAAO,KAAK,EAAE;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,qCAAqC,CAAC,CAAC;YAE/D,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACpB,KAAK,EAAE,kCAAkC;4BACzC,OAAO,EAAE,qCAAqC,OAAO,EAAE;4BACvD,IAAI,EAAE,iFAAiF;yBACvF,CAAC;qBACF;iBACD;gBACD,OAAO,EAAE,IAAI;aACb,CAAC;SACF;IACF,CAAC,CACD,CAAC;AACH,CAAC"}

package/dist/core/autodocs-tools.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register Obra Autodocs generation/removal tools. Requires a Desktop Bridge
+ * connector (local mode). Mirrors registerWriteTools' connector pattern.
+ */
+export declare function registerAutodocsTools(server: McpServer, getDesktopConnector: () => Promise<any>): void;
+//# sourceMappingURL=autodocs-tools.d.ts.map

package/dist/core/autodocs-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autodocs-tools.d.ts","sourceRoot":"","sources":["../../src/core/autodocs-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4EpE;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,QAkIvC"}

package/dist/core/autodocs-tools.js

@@ -0,0 +1,195 @@
+import { z } from "zod";
+import { createChildLogger } from "./logger.js";
+import { AUTODOCS_BODY } from "../vendor/obra-autodocs/autodocs-body.generated.js";
+const logger = createChildLogger({ component: "autodocs-tools" });
+/**
+ * Obra Autodocs, runnable from inside the Desktop Bridge sandbox.
+ *
+ * The Obra Autodocs Figma plugin draws the labeled grid/bracket documentation
+ * around component sets. Running it as a *plugin* would swap the active plugin
+ * and tear down the Desktop Bridge connection. Instead we vendor the plugin's
+ * code.js (UI-init statements stripped — see scripts/build-autodocs-runtime.mjs)
+ * and inject its generate()/remove() entry points over the SAME execute bridge,
+ * so the Bridge stays connected throughout.
+ *
+ * Source of truth: src/vendor/obra-autodocs/code.js. The plugin is stable, so
+ * re-vendoring is rare; rerun the build script when code.js is updated.
+ */
+// JS that loads the label fonts generate() requires, then satisfies the
+// plugin's font-readiness gate (_fontLoaded / _fontLoadPromise live in the body
+// and are reset to false/null when the body runs, so we set them here, after).
+const FONT_PRELUDE = `
+await Promise.all([
+  figma.loadFontAsync({ family: 'Inter', style: 'Regular' }),
+  figma.loadFontAsync({ family: 'Inter', style: 'Semi Bold' }),
+  figma.loadFontAsync({ family: 'Inter', style: 'Bold' }),
+  figma.loadFontAsync({ family: 'Inter', style: 'Italic' }),
+  figma.loadFontAsync({ family: 'Inter', style: 'Bold Italic' }),
+]);
+_fontLoaded = true;
+_fontLoadPromise = Promise.resolve();
+`;
+// Optionally select a target node (and switch to its page) before generating,
+// since generate()/remove() operate on figma.currentPage.selection.
+function selectSnippet(nodeId) {
+    if (!nodeId)
+        return "";
+    return `
+const __target = await figma.getNodeByIdAsync(${JSON.stringify(nodeId)});
+if (!__target) return { error: 'Node not found: ' + ${JSON.stringify(nodeId)} };
+let __pg = __target; while (__pg && __pg.type !== 'PAGE') __pg = __pg.parent;
+if (__pg && figma.currentPage !== __pg) await figma.setCurrentPageAsync(__pg);
+figma.currentPage.selection = [__target];
+`;
+}
+function buildGenerateScript(opts, nodeId) {
+    const entry = `${FONT_PRELUDE}${selectSnippet(nodeId)}
+const __cs = getComponentSet();
+const __standalone = __cs ? null : getStandaloneComponent();
+const __node = __cs || __standalone;
+if (!__node) return { error: 'No component set or component selected. Pass nodeId or select one in Figma.' };
+const __opts = Object.assign({ showGrid: __standalone ? false : true }, ${JSON.stringify(opts)});
+await generate(__opts);
+return { generated: true, target: __node.name, type: __node.type, nodeId: __node.id };
+`;
+    return `${AUTODOCS_BODY}\n${entry}`;
+}
+function buildRemoveScript(nodeId) {
+    const entry = `${selectSnippet(nodeId)}
+const __cs = getComponentSet();
+const __node = __cs || getStandaloneComponent();
+if (!__node) return { error: 'No component set or component selected. Pass nodeId or select one in Figma.' };
+const __wrapper = findExistingWrapper(__node);
+const __hasPropstar = __cs ? detectGusPropstar(__cs) : false;
+if (!__wrapper && !__hasPropstar) return { removed: false, reason: 'No docs found to remove.' };
+if (__hasPropstar) { removeGusPropstar(__cs); } else { removeDocs(); }
+return { removed: true, target: __node.name, nodeId: __node.id };
+`;
+    return `${AUTODOCS_BODY}\n${entry}`;
+}
+/**
+ * Register Obra Autodocs generation/removal tools. Requires a Desktop Bridge
+ * connector (local mode). Mirrors registerWriteTools' connector pattern.
+ */
+export function registerAutodocsTools(server, getDesktopConnector) {
+    server.tool("figma_generate_autodocs", `Generate Obra Autodocs documentation (labeled variant grid with brackets/labels) around a component set or component — the same output as the Obra Autodocs plugin's "Generate docs" command, but run inside the Desktop Bridge so the connection stays alive (running the plugin itself would disconnect the Bridge).
+
+Select the target component set first, or pass its nodeId. Re-running regenerates (replaces) existing docs. Use figma_remove_autodocs to remove them. After generating, screenshot with figma_capture_screenshot to verify.`, {
+        nodeId: z
+            .string()
+            .optional()
+            .describe("Component set / component node id to document. If omitted, uses the current selection."),
+        showGrid: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("Draw the dashed alignment grid behind the variants (default true; ignored for standalone components)."),
+        color: z
+            .string()
+            .optional()
+            .describe("Doc accent color as hex (e.g. '#9747FF'). Defaults to the Autodocs purple."),
+        showBooleanVisibility: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Also document boolean-property visibility combinations (plugin 'generate-boolean')."),
+        showNestedInstances: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Also document nested instance swaps (plugin 'generate-nested')."),
+        fontFamily: z
+            .string()
+            .optional()
+            .describe("Override the label font family (defaults to Inter)."),
+        timeout: z
+            .number()
+            .optional()
+            .default(60000)
+            .describe("Execution timeout in ms (default 60000). Large variant sets take longer."),
+    }, async ({ nodeId, showGrid, color, showBooleanVisibility, showNestedInstances, fontFamily, timeout }) => {
+        try {
+            const opts = { showGrid, showBooleanVisibility, showNestedInstances };
+            if (color)
+                opts.color = color;
+            if (fontFamily)
+                opts.fontFamily = fontFamily;
+            const code = buildGenerateScript(opts, nodeId);
+            const connector = await getDesktopConnector();
+            const result = await connector.executeCodeViaUI(code, Math.min(timeout, 120000));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: result.success,
+                            result: result.result,
+                            error: result.error,
+                            fileContext: result.fileContext,
+                            timestamp: Date.now(),
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_generate_autodocs failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                            message: "Failed to generate autodocs",
+                            hint: "Make sure the Desktop Bridge plugin is running and a component set is selected (or pass nodeId).",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("figma_remove_autodocs", `Remove Obra Autodocs documentation from a component set or component (mirrors the plugin's "Remove docs" command). Select the target or pass its nodeId.`, {
+        nodeId: z
+            .string()
+            .optional()
+            .describe("Component set / component node id. If omitted, uses the current selection."),
+        timeout: z.number().optional().default(30000).describe("Execution timeout in ms (default 30000)."),
+    }, async ({ nodeId, timeout }) => {
+        try {
+            const code = buildRemoveScript(nodeId);
+            const connector = await getDesktopConnector();
+            const result = await connector.executeCodeViaUI(code, Math.min(timeout, 60000));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: result.success,
+                            result: result.result,
+                            error: result.error,
+                            timestamp: Date.now(),
+                        }),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error({ error }, "figma_remove_autodocs failed");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error instanceof Error ? error.message : String(error),
+                            message: "Failed to remove autodocs",
+                            hint: "Make sure the Desktop Bridge plugin is running and a component set is selected (or pass nodeId).",
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=autodocs-tools.js.map

package/dist/core/autodocs-tools.js.map

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

package/dist/core/comment-tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Figma Comments MCP Tools
+ * Tools for getting, posting, and deleting comments on Figma files via REST API.
+ * Works in both local and Cloudflare Workers modes — no Plugin API dependency.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FigmaAPI } from "./figma-api.js";
+export declare function registerCommentTools(server: McpServer, getFigmaAPI: () => Promise<FigmaAPI>, getCurrentUrl: () => string | null, options?: {
+    isRemoteMode?: boolean;
+}): void;
+//# sourceMappingURL=comment-tools.d.ts.map

package/dist/core/comment-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-tools.d.ts","sourceRoot":"","sources":["../../src/core/comment-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU/C,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EACpC,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,EAClC,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,IAAI,CAgUN"}