illustrator-mcp-server 1.2.4 → 1.2.6

package/dist/tools/modify/group-objects.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { WRITE_ANNOTATIONS, coerceBoolean } from './shared.js';
+/**
+ * group_objects — 複数オブジェクトをグループ化
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/GroupItems/ — GroupItems.add()
+ *
+ * JSX API:
+ *   GroupItems.add() → GroupItem  (空グループ作成)
+ *   PageItem.move(relativeObject, insertionLocation: ElementPlacement) → PageItem
+ *   GroupItem.clipped → Boolean (writable)
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var uuids = params.uuids;
+
+    var items = [];
+    for (var i = 0; i < uuids.length; i++) {
+      var item = findItemByUUID(uuids[i]);
+      if (item) items.push(item);
+    }
+
+    if (items.length === 0) {
+      writeResultFile(RESULT_PATH, { error: true, message: "No valid objects found for the given UUIDs" });
+    } else {
+      var parentLayer = items[0].layer;
+      var group = parentLayer.groupItems.add();
+
+      // 順方向で PLACEATEND → items[0] がグループ最下位 (bottom)、最後が最上位 (top)
+      // クリッピングマスクでは最上位アイテム（＝配列末尾）がクリップパスになる
+      for (var j = 0; j < items.length; j++) {
+        items[j].move(group, ElementPlacement.PLACEATEND);
+      }
+
+      if (params.name) {
+        group.name = params.name;
+      }
+      if (params.clipped === true) {
+        group.clipped = true;
+      }
+
+      var uuid = ensureUUID(group);
+      writeResultFile(RESULT_PATH, {
+        success: true,
+        uuid: uuid,
+        childCount: group.pageItems.length,
+        verified: verifyItem(group)
+      });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "group_objects failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('group_objects', {
+        title: 'Group Objects',
+        description: 'Group multiple objects into a single group. The first UUID in the array becomes the bottommost item, the last becomes the topmost. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            uuids: z.array(z.string()).min(1).describe('UUIDs of objects to group. Order matters: first=bottom, last=top in layer panel.'),
+            name: z.string().optional().describe('Name for the new group'),
+            clipped: coerceBoolean
+                .optional()
+                .default(false)
+                .describe('Create as clipping group. The last UUID becomes the clip path (topmost). Example: [content-uuid, mask-uuid] — mask-uuid clips content-uuid.'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=group-objects.js.map

package/dist/tools/modify/group-objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-objects.js","sourceRoot":"","sources":["../../../src/tools/modify/group-objects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;GASG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Cf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,kNAAkN;QACpN,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kFAAkF,CAAC;YAC9H,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC9D,OAAO,EAAE,aAAa;iBACnB,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,6IAA6I,CAAC;SAC3J;QACD,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-artboards.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-artboards.d.ts.map

package/dist/tools/modify/manage-artboards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-artboards.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-artboards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgHpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8ChD"}

package/dist/tools/modify/manage-artboards.js

@@ -0,0 +1,152 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { DESTRUCTIVE_ANNOTATIONS } from './shared.js';
+/**
+ * manage_artboards — アートボードの追加・削除・リサイズ・リネーム・整列
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Artboards/ — Artboards collection
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Document/ — Document.rearrangeArtboards(), fitArtboardToSelectedArt()
+ *
+ * JSX API:
+ *   Artboards.add(artboardRect: Rect) → Artboard
+ *   Artboards.remove(index: Number) → void  ※最後の1つは削除不可
+ *   Artboard.artboardRect → Rect [left, top, right, bottom] (writable)
+ *   Artboard.name → String (writable)
+ *   Document.fitArtboardToSelectedArt([index]) → Boolean  ※要選択
+ *   Document.rearrangeArtboards(layout, rowsOrCols, spacing, moveArtwork) → Boolean
+ *
+ * rect パラメータはドキュメント座標系 (Y-up)。artboardRect への変換:
+ *   [r.x, r.y + r.height, r.x + r.width, r.y]
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var action = params.action;
+
+    if (action === "add") {
+      if (!params.rect) {
+        writeResultFile(RESULT_PATH, { error: true, message: "rect is required for add action" });
+      } else {
+        var r = params.rect;
+        // artboardRect = [left, top, right, bottom] (document coordinates, Y-up)
+        var abRect = [r.x, r.y + r.height, r.x + r.width, r.y];
+        var ab = doc.artboards.add(abRect);
+        invalidateArtboardCache();
+        if (params.name) ab.name = params.name;
+        var addedRect = ab.artboardRect;
+        writeResultFile(RESULT_PATH, {
+          success: true,
+          index: doc.artboards.length - 1,
+          name: ab.name,
+          verified: { artboardRect: addedRect }
+        });
+      }
+    } else if (action === "remove") {
+      if (typeof params.index !== "number") {
+        writeResultFile(RESULT_PATH, { error: true, message: "index is required for remove action" });
+      } else if (doc.artboards.length <= 1) {
+        writeResultFile(RESULT_PATH, { error: true, message: "Cannot remove the last artboard" });
+      } else {
+        // Artboards.remove(index: Number) → void
+        doc.artboards.remove(params.index);
+        invalidateArtboardCache();
+        writeResultFile(RESULT_PATH, { success: true, removedIndex: params.index });
+      }
+    } else if (action === "resize") {
+      if (typeof params.index !== "number" || !params.rect) {
+        writeResultFile(RESULT_PATH, { error: true, message: "index and rect required for resize" });
+      } else {
+        var r2 = params.rect;
+        // Artboard.artboardRect = [left, top, right, bottom] (document coordinates, Y-up)
+        doc.artboards[params.index].artboardRect = [r2.x, r2.y + r2.height, r2.x + r2.width, r2.y];
+        var resizedRect = doc.artboards[params.index].artboardRect;
+        writeResultFile(RESULT_PATH, { success: true, index: params.index, verified: { artboardRect: resizedRect } });
+      }
+    } else if (action === "rename") {
+      if (typeof params.index !== "number" || !params.name) {
+        writeResultFile(RESULT_PATH, { error: true, message: "index and name required for rename" });
+      } else {
+        doc.artboards[params.index].name = params.name;
+        var renamedName = doc.artboards[params.index].name;
+        writeResultFile(RESULT_PATH, { success: true, index: params.index, name: params.name, verified: { name: renamedName } });
+      }
+    } else if (action === "fit_to_art") {
+      if (!doc.selection || doc.selection.length === 0) {
+        writeResultFile(RESULT_PATH, { error: true, message: "fit_to_art requires objects to be selected first" });
+      } else {
+        var fitIdx = (typeof params.index === "number") ? params.index : 0;
+        doc.fitArtboardToSelectedArt(fitIdx);
+        writeResultFile(RESULT_PATH, { success: true, index: fitIdx, verified: { artboardRect: doc.artboards[fitIdx].artboardRect } });
+      }
+    } else if (action === "rearrange") {
+      var layoutMap = {
+        "grid_by_row": DocumentArtboardLayout.GridByRow,
+        "grid_by_col": DocumentArtboardLayout.GridByCol,
+        "row": DocumentArtboardLayout.Row,
+        "column": DocumentArtboardLayout.Column
+      };
+      var layout = layoutMap[params.layout] || DocumentArtboardLayout.GridByRow;
+      var rowsOrCols = params.rows_or_cols || 1;
+      var spacing = (typeof params.spacing === "number") ? params.spacing : 20;
+      doc.rearrangeArtboards(layout, rowsOrCols, spacing, true);
+      var rearrangedInfo = [];
+      for (var rai = 0; rai < doc.artboards.length; rai++) {
+        rearrangedInfo.push({ index: rai, name: doc.artboards[rai].name, rect: doc.artboards[rai].artboardRect });
+      }
+      writeResultFile(RESULT_PATH, { success: true, verified: { artboardCount: doc.artboards.length, artboards: rearrangedInfo } });
+    } else {
+      writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + action });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "manage_artboards failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_artboards', {
+        title: 'Manage Artboards',
+        description: 'Add, remove, resize, rename, fit, or rearrange artboards. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            action: z
+                .enum(['add', 'remove', 'resize', 'rename', 'fit_to_art', 'rearrange'])
+                .describe('Action to perform'),
+            index: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Target artboard index (0-based). Required for remove/resize/rename/fit_to_art. Note: the last remaining artboard cannot be removed.'),
+            rect: z
+                .object({
+                x: z.number(),
+                y: z.number(),
+                width: z.number(),
+                height: z.number(),
+            })
+                .optional()
+                .describe('Position and size for add/resize (document coordinates)'),
+            name: z.string().optional().describe('New name for rename action'),
+            layout: z
+                .enum(['grid_by_row', 'grid_by_col', 'row', 'column'])
+                .optional()
+                .describe('Artboard layout for rearrange'),
+            rows_or_cols: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe('Number of rows or columns for rearrange'),
+            spacing: z.number().optional().default(20).describe('Spacing in points for rearrange'),
+        },
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-artboards.js.map

package/dist/tools/modify/manage-artboards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-artboards.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-artboards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwFf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;iBACtE,QAAQ,CAAC,mBAAmB,CAAC;YAChC,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,qIAAqI,CAAC;YAClJ,IAAI,EAAE,CAAC;iBACJ,MAAM,CAAC;gBACN,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;gBACb,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;gBACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;aACnB,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,yDAAyD,CAAC;YACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAClE,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;iBACrD,QAAQ,EAAE;iBACV,QAAQ,CAAC,+BAA+B,CAAC;YAC5C,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,yCAAyC,CAAC;YACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SACvF;QACD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-datasets.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-datasets.d.ts.map

package/dist/tools/modify/manage-datasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-datasets.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+SpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgDhD"}

package/dist/tools/modify/manage-datasets.js

@@ -0,0 +1,345 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { WRITE_ANNOTATIONS } from './shared.js';
+/**
+ * manage_datasets — 変数・データセットの一覧・適用・作成・インポート/エクスポート
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Dataset/ — Dataset, Variable, Document.importVariables()
+ *
+ * JSX API:
+ *   Document.variables → Variables コレクション
+ *   Variable.kind → VariableKind (TEXTUAL | VISIBILITY | IMAGE | GRAPH)
+ *   Document.dataSets → Datasets コレクション
+ *   Dataset.display() → void  (データセットを表示)
+ *   Datasets.add() → Dataset
+ *   Document.importVariables(fileSpec: File) → void
+ *   Document.exportVariables(fileSpec: File) → void
+ */
+const jsxCode = `
+function parseCsvLine(line) {
+  var result = [];
+  var current = "";
+  var inQuotes = false;
+  for (var ci = 0; ci < line.length; ci++) {
+    var ch = line.charAt(ci);
+    if (inQuotes) {
+      if (ch === '"' && ci + 1 < line.length && line.charAt(ci + 1) === '"') {
+        current += '"';
+        ci++;
+      } else if (ch === '"') {
+        inQuotes = false;
+      } else {
+        current += ch;
+      }
+    } else {
+      if (ch === '"') {
+        inQuotes = true;
+      } else if (ch === ',') {
+        result.push(current);
+        current = "";
+      } else {
+        current += ch;
+      }
+    }
+  }
+  result.push(current);
+  return result;
+}
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var action = params.action;
+
+    if (action === "list_variables") {
+      var vars = [];
+      for (var i = 0; i < doc.variables.length; i++) {
+        var v = doc.variables[i];
+        var kindStr = "unknown";
+        if (v.kind === VariableKind.TEXTUAL) kindStr = "textual";
+        else if (v.kind === VariableKind.VISIBILITY) kindStr = "visibility";
+        else if (v.kind === VariableKind.IMAGE) kindStr = "image";
+        else if (v.kind === VariableKind.GRAPH) kindStr = "graph";
+        vars.push({ name: v.name, kind: kindStr });
+      }
+      writeResultFile(RESULT_PATH, { count: vars.length, variables: vars });
+    } else if (action === "list_datasets") {
+      var ds = [];
+      for (var j = 0; j < doc.dataSets.length; j++) {
+        ds.push({ index: j, name: doc.dataSets[j].name });
+      }
+      writeResultFile(RESULT_PATH, { count: ds.length, datasets: ds });
+    } else if (action === "apply_dataset") {
+      if (!params.dataset_name) {
+        writeResultFile(RESULT_PATH, { error: true, message: "dataset_name is required" });
+      } else {
+        var found = false;
+        for (var k = 0; k < doc.dataSets.length; k++) {
+          if (doc.dataSets[k].name === params.dataset_name) {
+            doc.dataSets[k].display();
+            found = true;
+            break;
+          }
+        }
+        if (found) {
+          writeResultFile(RESULT_PATH, { success: true, dataset: params.dataset_name });
+        } else {
+          writeResultFile(RESULT_PATH, { error: true, message: "Dataset not found: " + params.dataset_name });
+        }
+      }
+    } else if (action === "create_dataset") {
+      // Check that at least one variable is bound to an object
+      var hasBound = false;
+      for (var cb = 0; cb < doc.pageItems.length && !hasBound; cb++) {
+        try { if (doc.pageItems[cb].contentVariable) hasBound = true; } catch(_e1) {}
+        try { if (doc.pageItems[cb].visibilityVariable) hasBound = true; } catch(_e2) {}
+      }
+      if (!hasBound) {
+        writeResultFile(RESULT_PATH, { error: true, message: "Cannot create dataset: no variables are bound to objects. Use bind_variable or import_csv first." });
+      } else {
+        var newDs = doc.dataSets.add();
+        if (params.dataset_name) newDs.name = params.dataset_name;
+        writeResultFile(RESULT_PATH, { success: true, name: newDs.name, index: doc.dataSets.length - 1 });
+      }
+    } else if (action === "import") {
+      if (!params.file_path) {
+        writeResultFile(RESULT_PATH, { error: true, message: "file_path is required for import" });
+      } else {
+        var impFile = new File(params.file_path);
+        if (!impFile.exists) {
+          writeResultFile(RESULT_PATH, { error: true, message: "File not found: " + params.file_path });
+        } else {
+          doc.importVariables(impFile);
+          writeResultFile(RESULT_PATH, { success: true, action: "import", path: params.file_path });
+        }
+      }
+    } else if (action === "bind_variable") {
+      if (!params.variable_name || !params.object_name) {
+        writeResultFile(RESULT_PATH, { error: true, message: "variable_name and object_name are required" });
+      } else {
+        var bindVar = null;
+        for (var bv = 0; bv < doc.variables.length; bv++) {
+          if (doc.variables[bv].name === params.variable_name) {
+            bindVar = doc.variables[bv];
+            break;
+          }
+        }
+        if (!bindVar) {
+          writeResultFile(RESULT_PATH, { error: true, message: "Variable not found: " + params.variable_name });
+        } else {
+          var bindItem = null;
+          for (var bp = 0; bp < doc.pageItems.length; bp++) {
+            if (doc.pageItems[bp].name === params.object_name) {
+              bindItem = doc.pageItems[bp];
+              break;
+            }
+          }
+          if (!bindItem) {
+            writeResultFile(RESULT_PATH, { error: true, message: "Object not found: " + params.object_name });
+          } else {
+            if (bindVar.kind === VariableKind.TEXTUAL) {
+              bindItem.contentVariable = bindVar;
+            } else if (bindVar.kind === VariableKind.VISIBILITY) {
+              bindItem.visibilityVariable = bindVar;
+            } else if (bindVar.kind === VariableKind.IMAGE) {
+              bindItem.contentVariable = bindVar;
+            } else {
+              bindItem.contentVariable = bindVar;
+            }
+            writeResultFile(RESULT_PATH, { success: true, variable: params.variable_name, object: params.object_name });
+          }
+        }
+      }
+    } else if (action === "import_csv") {
+      if (!params.file_path) {
+        writeResultFile(RESULT_PATH, { error: true, message: "file_path is required for import_csv" });
+      } else {
+        var csvFile = new File(params.file_path);
+        if (!csvFile.exists) {
+          writeResultFile(RESULT_PATH, { error: true, message: "File not found: " + params.file_path });
+        } else {
+          csvFile.encoding = "UTF-8";
+          csvFile.open("r");
+          var csvText = csvFile.read();
+          csvFile.close();
+
+          var lines = csvText.split(/\\r?\\n/);
+          // Remove empty trailing lines
+          while (lines.length > 0 && lines[lines.length - 1].replace(/^\\s+|\\s+$/g, "") === "") {
+            lines.pop();
+          }
+          if (lines.length < 2) {
+            writeResultFile(RESULT_PATH, { error: true, message: "CSV must have a header row and at least one data row" });
+          } else {
+            // Parse CSV header
+            var headers = parseCsvLine(lines[0]);
+            for (var hi = 0; hi < headers.length; hi++) {
+              headers[hi] = headers[hi].replace(/^\\s+|\\s+$/g, "");
+            }
+
+            // Duplicate artboards for each CSV row
+            var abRect = doc.artboards[0].artboardRect;
+            var abWidth = abRect[2] - abRect[0];
+
+            // Collect references to original items (iterate in reverse for z-order)
+            var origItems = [];
+            var rightOverhang = 0;
+            var leftOverhang = 0;
+            for (var oi = doc.pageItems.length - 1; oi >= 0; oi--) {
+              var item = doc.pageItems[oi];
+              origItems.push(item);
+              // Calculate how far items extend beyond artboard edges
+              // geometricBounds: [left, top, right, bottom]
+              var gb = item.geometricBounds;
+              var rOver = gb[2] - abRect[2];
+              var lOver = abRect[0] - gb[0];
+              if (rOver > rightOverhang) rightOverhang = rOver;
+              if (lOver > leftOverhang) leftOverhang = lOver;
+            }
+            // Spacing = overhang on both sides + 20pt gap
+            var hSpacing = rightOverhang + leftOverhang + 20;
+            // Vertical overhang
+            var topOverhang = 0;
+            var bottomOverhang = 0;
+            var abHeight = abRect[1] - abRect[3]; // top - bottom (document coords)
+            for (var oi2 = 0; oi2 < origItems.length; oi2++) {
+              var gb2 = origItems[oi2].geometricBounds;
+              var tOver = gb2[1] - abRect[1];
+              var bOver = abRect[3] - gb2[3];
+              if (tOver > topOverhang) topOverhang = tOver;
+              if (bOver > bottomOverhang) bottomOverhang = bOver;
+            }
+            var vSpacing = topOverhang + bottomOverhang + 20;
+
+            // Grid layout: max 4 columns per row
+            var maxCols = 4;
+            var totalRows = lines.length - 1;
+            if (totalRows <= maxCols) maxCols = totalRows;
+
+            var artboardNames = [];
+            for (var ri = 1; ri < lines.length; ri++) {
+              var values = parseCsvLine(lines[ri]);
+              var rowName = params.dataset_name_prefix
+                ? params.dataset_name_prefix + " " + ri
+                : values[0] || ("Row " + ri);
+              var gridIndex = ri - 1;
+              var col = gridIndex % maxCols;
+              var row = Math.floor(gridIndex / maxCols);
+              var xOffset = col * (abWidth + hSpacing);
+              var yOffset = row * (abHeight + vSpacing);
+
+              if (ri === 1) {
+                // First row: set text on original artboard
+                doc.artboards[0].name = rowName;
+                for (var ci2 = 0; ci2 < headers.length && ci2 < values.length; ci2++) {
+                  if (headers[ci2] === "") continue;
+                  for (var pi = 0; pi < origItems.length; pi++) {
+                    if (origItems[pi].name === headers[ci2] && origItems[pi].typename === "TextFrame") {
+                      origItems[pi].contents = values[ci2];
+                      break;
+                    }
+                  }
+                }
+              } else {
+                // Subsequent rows: add artboard and duplicate items
+                // Document coords: y increases upward, so subtract yOffset
+                var newRect = [abRect[0] + xOffset, abRect[1] - yOffset, abRect[2] + xOffset, abRect[3] - yOffset];
+                var newAb = doc.artboards.add(newRect);
+                newAb.name = rowName;
+                invalidateArtboardCache();
+
+                for (var di = 0; di < origItems.length; di++) {
+                  var dup = origItems[di].duplicate();
+                  dup.translate(xOffset, -yOffset);
+                  if (dup.typename === "TextFrame") {
+                    for (var ci3 = 0; ci3 < headers.length && ci3 < values.length; ci3++) {
+                      if (dup.name === headers[ci3]) {
+                        dup.contents = values[ci3];
+                        break;
+                      }
+                    }
+                  }
+                }
+              }
+              artboardNames.push(rowName);
+            }
+
+            // Verify each artboard using common helper
+            var verification = [];
+            for (var vai = 0; vai < doc.artboards.length; vai++) {
+              verification.push(verifyArtboardContents(vai));
+            }
+
+            writeResultFile(RESULT_PATH, {
+              success: true,
+              action: "import_csv",
+              columns: headers,
+              artboards: verification
+            });
+          }
+        }
+      }
+    } else if (action === "export") {
+      if (!params.file_path) {
+        writeResultFile(RESULT_PATH, { error: true, message: "file_path is required for export" });
+      } else {
+        var expFile = new File(params.file_path);
+        doc.exportVariables(expFile);
+        writeResultFile(RESULT_PATH, { success: true, action: "export", path: params.file_path });
+      }
+    } else {
+      writeResultFile(RESULT_PATH, { error: true, message: "Unknown action: " + action });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "manage_datasets failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('manage_datasets', {
+        title: 'Manage Variables & Datasets',
+        description: 'List variables/datasets, apply or create datasets, bind variables to objects, import CSV/XML. CSV headers are auto-bound to objects with matching names. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            action: z
+                .enum([
+                'list_variables',
+                'list_datasets',
+                'apply_dataset',
+                'create_dataset',
+                'bind_variable',
+                'import_csv',
+                'import',
+                'export',
+            ])
+                .describe('Action to perform'),
+            dataset_name: z
+                .string()
+                .optional()
+                .describe('Dataset name (for apply_dataset, create_dataset)'),
+            variable_name: z
+                .string()
+                .optional()
+                .describe('Variable name (for bind_variable)'),
+            object_name: z
+                .string()
+                .optional()
+                .describe('Object name to bind variable to (for bind_variable)'),
+            dataset_name_prefix: z
+                .string()
+                .optional()
+                .describe('Prefix for auto-generated dataset names (for import_csv). If omitted, first column value is used.'),
+            file_path: z
+                .string()
+                .optional()
+                .describe('File path (XML for import/export, CSV for import_csv)'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=manage-datasets.js.map

package/dist/tools/modify/manage-datasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-datasets.js","sourceRoot":"","sources":["../../../src/tools/modify/manage-datasets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Rf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,wOAAwO;QAC1O,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC;gBACJ,gBAAgB;gBAChB,eAAe;gBACf,eAAe;gBACf,gBAAgB;gBAChB,eAAe;gBACf,YAAY;gBACZ,QAAQ;gBACR,QAAQ;aACT,CAAC;iBACD,QAAQ,CAAC,mBAAmB,CAAC;YAChC,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kDAAkD,CAAC;YAC/D,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mCAAmC,CAAC;YAChD,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;YAClE,mBAAmB,EAAE,CAAC;iBACnB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mGAAmG,CAAC;YAChH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,uDAAuD,CAAC;SACrE;QACD,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/modify/manage-layers.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=manage-layers.d.ts.map

package/dist/tools/modify/manage-layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage-layers.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/manage-layers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoHpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoChD"}