illustrator-mcp-server 1.2.4 → 1.2.5

package/dist/tools/modify/modify-object.js

@@ -1,6 +1,14 @@
 import { z } from 'zod';
 import { executeJsx } from '../../executor/jsx-runner.js';
-import { colorSchema, strokeSchema, COLOR_HELPERS_JSX, FONT_HELPERS_JSX } from './shared.js';
+import { coordinateSystemSchema, resolveCoordinateSystem, } from '../session.js';
+import { colorSchema, strokeSchema, COLOR_HELPERS_JSX, FONT_HELPERS_JSX, DESTRUCTIVE_ANNOTATIONS } from './shared.js';
+/**
+ * modify_object — オブジェクトのプロパティ変更
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/PageItem/ — position, width, height, opacity, locked, hidden, name
+ *
+ * 注意: rotation の絶対角度指定は atan2(mValueB, mValueA) で現在角度を算出するため、
+ * skew/非等倍スケールされたオブジェクトでは不正確になる場合がある。
+ */
 const jsxCode = `
 var preflight = preflightChecks();
 if (preflight) {
@@ -13,28 +21,6 @@ if (preflight) {
     ${COLOR_HELPERS_JSX}
     ${FONT_HELPERS_JSX}
 
-    function findItemByUUID(uuid) {
-      var doc = app.activeDocument;
-      function search(items) {
-        for (var i = 0; i < items.length; i++) {
-          var item = items[i];
-          try {
-            if (item.note === uuid) return item;
-          } catch(e) {}
-          if (item.typename === "GroupItem") {
-            var found = search(item.pageItems);
-            if (found) return found;
-          }
-        }
-        return null;
-      }
-      for (var li = 0; li < doc.layers.length; li++) {
-        var found = search(doc.layers[li].pageItems);
-        if (found) return found;
-      }
-      return null;
-    }
-
     var item = findItemByUUID(params.uuid);
     if (!item) {
       writeResultFile(RESULT_PATH, { error: true, message: "No object found matching UUID: " + params.uuid });
@@ -44,15 +30,9 @@ if (preflight) {
 
       if (props.position) {
         try {
-          var px = props.position.x;
-          var py = props.position.y;
-          if (coordSystem === "artboard-web") {
-            var ab = doc.artboards[doc.artboards.getActiveArtboardIndex()];
-            var abRect = ab.artboardRect;
-            px = abRect[0] + px;
-            py = abRect[1] + (-py);
-          }
-          item.position = [px, py];
+          var abRect = (coordSystem === "artboard-web") ? getActiveArtboardRect() : null;
+          var pos = webToAiPoint(props.position.x, props.position.y, coordSystem, abRect);
+          item.position = pos;
         } catch(e) { errors.push("position: " + e.message); }
       }
 
@@ -85,7 +65,18 @@ if (preflight) {
       }
 
       if (typeof props.rotation === "number") {
-        try { item.rotate(props.rotation); }
+        try {
+          if (props.rotation_mode === "absolute") {
+            // 現在の回転角を Matrix から算出し、差分を rotate() に渡す
+            var m = item.matrix;
+            var currentRad = Math.atan2(m.mValueB, m.mValueA);
+            var currentDeg = currentRad * 180 / Math.PI;
+            var delta = props.rotation - currentDeg;
+            item.rotate(delta);
+          } else {
+            item.rotate(props.rotation);
+          }
+        }
         catch(e) { errors.push("rotation: " + e.message); }
       }
 
@@ -95,7 +86,7 @@ if (preflight) {
       }
 
       if (typeof props.contents === "string") {
-        try { item.contents = props.contents; }
+        try { item.contents = props.contents.split(String.fromCharCode(10)).join(String.fromCharCode(13)); }
         catch(e) { errors.push("contents: " + e.message); }
       }
 
@@ -158,27 +149,20 @@ export function register(server) {
                 fill: colorSchema.describe('Fill color'),
                 stroke: strokeSchema.describe('Stroke settings'),
                 opacity: z.number().optional().describe('Opacity (0-100)'),
-                rotation: z.number().optional().describe('Rotation delta in degrees (additive — each call adds to current rotation)'),
+                rotation: z.number().optional().describe('Rotation in degrees. Default mode is "delta" (additive). Use rotation_mode: "absolute" for target angle.'),
+                rotation_mode: z.enum(['delta', 'absolute']).optional().default('delta').describe('delta = add to current rotation, absolute = set to exact angle'),
                 name: z.string().optional().describe('Object name'),
                 contents: z.string().optional().describe('Text contents (for text frames)'),
                 font_name: z.string().optional().describe('Font name for text frames (partial match supported)'),
                 font_size: z.number().optional().describe('Font size (for text frames)'),
             })
                 .describe('Properties to modify'),
-            coordinate_system: z
-                .enum(['artboard-web', 'document'])
-                .optional()
-                .default('artboard-web')
-                .describe('Coordinate system (artboard-web: artboard-relative Y-down, document: native Illustrator coordinates)'),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
+            coordinate_system: coordinateSystemSchema,
         },
+        annotations: DESTRUCTIVE_ANNOTATIONS,
     }, async (params) => {
-        const result = await executeJsx(jsxCode, params, { activate: true });
+        const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
+        const result = await executeJsx(jsxCode, resolvedParams, { activate: true });
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
 }

package/dist/tools/modify/modify-object.js.map

@@ -1 +1 @@
-{"version":3,"file":"modify-object.js","sourceRoot":"","sources":["../../../src/tools/modify/modify-object.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"modify-object.js","sourceRoot":"","sources":["../../../src/tools/modify/modify-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtH;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;;;;;;;;;MASV,iBAAiB;MACjB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGrB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wHAAwH;QACrI,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACtD,UAAU,EAAE,CAAC;iBACV,MAAM,CAAC;gBACN,QAAQ,EAAE,CAAC;qBACR,MAAM,CAAC;oBACN,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;oBACtC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;iBACvC,CAAC;qBACD,QAAQ,EAAE;qBACV,QAAQ,CAAC,UAAU,CAAC;gBACvB,IAAI,EAAE,CAAC;qBACJ,MAAM,CAAC;oBACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBACjD,CAAC;qBACD,QAAQ,EAAE;qBACV,QAAQ,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACxC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0GAA0G,CAAC;gBACpJ,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,gEAAgE,CAAC;gBACnJ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;gBAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;gBAChG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;aACzE,CAAC;iBACD,QAAQ,CAAC,sBAAsB,CAAC;YACnC,iBAAiB,EAAE,sBAAsB;SAC1C;QACD,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACjH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,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/move-to-layer.d.ts

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

package/dist/tools/modify/move-to-layer.d.ts.map

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

package/dist/tools/modify/move-to-layer.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { WRITE_ANNOTATIONS } from './shared.js';
+/**
+ * move_to_layer — オブジェクトを別レイヤーに移動
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/PageItem/ — PageItem.move()
+ *
+ * JSX API:
+ *   PageItem.move(relativeObject: Layer, insertionLocation?: ElementPlacement) → PageItem
+ *   ElementPlacement: PLACEATBEGINNING (最前面) | PLACEATEND (最背面)
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+
+    var targetLayer = null;
+    try {
+      targetLayer = doc.layers.getByName(params.target_layer);
+    } catch(e) {
+      writeResultFile(RESULT_PATH, { error: true, message: "Layer not found: " + params.target_layer });
+    }
+
+    if (targetLayer) {
+      var placement = (params.position === "end")
+        ? ElementPlacement.PLACEATEND
+        : ElementPlacement.PLACEATBEGINNING;
+
+      var movedCount = 0;
+      for (var i = 0; i < params.uuids.length; i++) {
+        var item = findItemByUUID(params.uuids[i]);
+        if (item) {
+          item.move(targetLayer, placement);
+          movedCount++;
+        }
+      }
+
+      writeResultFile(RESULT_PATH, {
+        success: true,
+        movedCount: movedCount,
+        targetLayer: params.target_layer
+      });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "move_to_layer failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('move_to_layer', {
+        title: 'Move to Layer',
+        description: 'Move one or more objects to a different layer. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            uuids: z.array(z.string()).min(1).describe('UUIDs of objects to move'),
+            target_layer: z.string().describe('Target layer name'),
+            position: z
+                .enum(['beginning', 'end'])
+                .optional()
+                .default('beginning')
+                .describe('beginning = front of layer, end = back of layer'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=move-to-layer.js.map

package/dist/tools/modify/move-to-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-to-layer.js","sourceRoot":"","sources":["../../../src/tools/modify/move-to-layer.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;;;;;;;;GAQG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACtE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACtD,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;iBAC1B,QAAQ,EAAE;iBACV,OAAO,CAAC,WAAW,CAAC;iBACpB,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;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/open-document.d.ts

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

package/dist/tools/modify/open-document.d.ts.map

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

package/dist/tools/modify/open-document.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { executeJsx } from '../../executor/jsx-runner.js';
+import { invalidateAutoDetectCache } from '../session.js';
+import { WRITE_ANNOTATIONS } from './shared.js';
+/**
+ * open_document — ファイルパスからドキュメントを開く
+ *
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/Application/ — Application.open()
+ *
+ * JSX API:
+ *   Application.open(file: File [, documentColorSpace: DocumentColorSpace]) → Document
+ *
+ * preflightChecks() はドキュメント未開封時にエラーを返すため、
+ * checkIllustratorVersion() のみ使用。
+ * handler 内で invalidateAutoDetectCache() を呼ぶ。
+ */
+const jsxCode = `
+try {
+  var verErr = checkIllustratorVersion();
+  if (verErr) {
+    writeResultFile(RESULT_PATH, verErr);
+  } else {
+    var params = readParamsFile(PARAMS_PATH);
+    var openFile = new File(params.path);
+    if (!openFile.exists) {
+      writeResultFile(RESULT_PATH, { error: true, message: "File not found: " + params.path });
+    } else {
+      var colorSpace = null;
+      if (params.color_space === "RGB") colorSpace = DocumentColorSpace.RGB;
+      else if (params.color_space === "CMYK") colorSpace = DocumentColorSpace.CMYK;
+
+      var doc;
+      if (colorSpace) {
+        doc = app.open(openFile, colorSpace);
+      } else {
+        doc = app.open(openFile);
+      }
+
+      var docName = doc.name;
+      var fullPath = "";
+      try { fullPath = doc.fullName.fsName; } catch(e) {}
+      writeResultFile(RESULT_PATH, {
+        success: true,
+        name: docName,
+        path: fullPath,
+        colorSpace: (doc.documentColorSpace === DocumentColorSpace.CMYK) ? "CMYK" : "RGB"
+      });
+    }
+  }
+} catch (e) {
+  writeResultFile(RESULT_PATH, { error: true, message: "open_document failed: " + e.message, line: e.line });
+}
+`;
+export function register(server) {
+    server.registerTool('open_document', {
+        title: 'Open Document',
+        description: 'Open an Illustrator document from a file path. Note: Illustrator will be activated (brought to foreground) during execution.',
+        inputSchema: {
+            path: z.string().describe('Absolute file path to open (.ai, .eps, .pdf, .svg, etc.)'),
+            color_space: z
+                .enum(['RGB', 'CMYK'])
+                .optional()
+                .describe('Force color space conversion on open. Omit to keep original.'),
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, async (params) => {
+        const result = await executeJsx(jsxCode, params, { activate: true });
+        invalidateAutoDetectCache();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=open-document.js.map

package/dist/tools/modify/open-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-document.js","sourceRoot":"","sources":["../../../src/tools/modify/open-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;YACrF,WAAW,EAAE,CAAC;iBACX,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;iBACrB,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;SAC5E;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,yBAAyB,EAAE,CAAC;QAC5B,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/place-color-chips.d.ts

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

package/dist/tools/modify/place-color-chips.d.ts.map

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

package/dist/tools/modify/place-color-chips.js

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+import { executeJsxHeavy } from '../../executor/jsx-runner.js';
+import { coordinateSystemSchema, resolveCoordinateSystem, } from '../session.js';
+import { WRITE_ANNOTATIONS } from './shared.js';
+/**
+ * place_color_chips — ドキュメント使用色のカラーチップ配置
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/PathItems/ — PathItems.rectangle()
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/TextFrameItems/ — TextFrameItems.add()
+ */
+const jsxCode = `
+var preflight = preflightChecks();
+if (preflight) {
+  writeResultFile(RESULT_PATH, preflight);
+} else {
+  try {
+    var params = readParamsFile(PARAMS_PATH);
+    var doc = app.activeDocument;
+    var abIdx = (typeof params.artboard_index === "number") ? params.artboard_index : doc.artboards.getActiveArtboardIndex();
+    var chipSize = (typeof params.chip_size === "number") ? params.chip_size : 30;
+    var position = params.position || "right";
+    var includeInfo = (typeof params.include_info === "boolean") ? params.include_info : true;
+    var layerName = params.layer_name || "Color Chips";
+    var isCMYKDoc = (doc.documentColorSpace === DocumentColorSpace.CMYK);
+
+    if (abIdx < 0 || abIdx >= doc.artboards.length) {
+      writeResultFile(RESULT_PATH, { error: true, message: "Artboard index out of range" });
+    } else {
+      var abRect = doc.artboards[abIdx].artboardRect;
+
+      // Collect unique colors
+      var colorMap = {};
+      var colorList = [];
+
+      function addColor(color) {
+        try {
+          var key = "";
+          if (color.typename === "CMYKColor") {
+            key = "cmyk_" + Math.round(color.cyan) + "_" + Math.round(color.magenta) + "_" + Math.round(color.yellow) + "_" + Math.round(color.black);
+          } else if (color.typename === "RGBColor") {
+            key = "rgb_" + Math.round(color.red) + "_" + Math.round(color.green) + "_" + Math.round(color.blue);
+          } else if (color.typename === "SpotColor") {
+            key = "spot_" + color.spot.name;
+          } else if (color.typename === "GrayColor") {
+            key = "gray_" + Math.round(color.gray);
+          } else {
+            return;
+          }
+          if (!colorMap[key]) {
+            colorMap[key] = true;
+            colorList.push({ color: color, key: key, info: colorToObject(color) });
+          }
+        } catch(e) {}
+      }
+
+      for (var i = 0; i < doc.pathItems.length; i++) {
+        var item = doc.pathItems[i];
+        try { if (item.filled) addColor(item.fillColor); } catch(e) {}
+        try { if (item.stroked) addColor(item.strokeColor); } catch(e) {}
+      }
+
+      // Get or create layer
+      var chipLayer = resolveTargetLayer(doc, layerName);
+
+      // Calculate start position
+      var startX, startY;
+      var gap = 8;
+      if (position === "right") {
+        startX = abRect[2] + 30; // 30pt right of artboard
+        startY = abRect[1]; // top of artboard
+      } else {
+        startX = abRect[0]; // left of artboard
+        startY = abRect[3] - 30; // 30pt below artboard
+      }
+
+      var placedCount = 0;
+      for (var ci = 0; ci < colorList.length; ci++) {
+        var entry = colorList[ci];
+        var chipX, chipY;
+        if (position === "right") {
+          chipX = startX;
+          chipY = startY - ci * (chipSize + gap);
+        } else {
+          chipX = startX + ci * (chipSize + gap + (includeInfo ? 80 : 0));
+          chipY = startY;
+        }
+
+        // Create color chip rectangle
+        var rect = chipLayer.pathItems.rectangle(chipY, chipX, chipSize, chipSize);
+        try {
+          // Clone the color for the chip
+          if (entry.color.typename === "CMYKColor") {
+            var nc = new CMYKColor();
+            nc.cyan = entry.color.cyan;
+            nc.magenta = entry.color.magenta;
+            nc.yellow = entry.color.yellow;
+            nc.black = entry.color.black;
+            rect.fillColor = nc;
+          } else if (entry.color.typename === "RGBColor") {
+            var nr = new RGBColor();
+            nr.red = entry.color.red;
+            nr.green = entry.color.green;
+            nr.blue = entry.color.blue;
+            rect.fillColor = nr;
+          } else if (entry.color.typename === "SpotColor") {
+            var ns = new SpotColor();
+            ns.spot = entry.color.spot;
+            ns.tint = entry.color.tint;
+            rect.fillColor = ns;
+          } else if (entry.color.typename === "GrayColor") {
+            var ng = new GrayColor();
+            ng.gray = entry.color.gray;
+            rect.fillColor = ng;
+          }
+        } catch(e) {}
+        rect.stroked = true;
+        var strokeC = new GrayColor();
+        strokeC.gray = 80;
+        rect.strokeColor = strokeC;
+        rect.strokeWidth = 0.5;
+
+        // Add info text
+        if (includeInfo) {
+          var label = "";
+          var info = entry.info;
+          if (info.type === "cmyk") {
+            label = "C" + Math.round(info.c) + " M" + Math.round(info.m) + " Y" + Math.round(info.y) + " K" + Math.round(info.k);
+          } else if (info.type === "rgb") {
+            label = "R" + Math.round(info.r) + " G" + Math.round(info.g) + " B" + Math.round(info.b);
+          } else if (info.type === "spot") {
+            label = info.name;
+          } else if (info.type === "gray") {
+            label = "Gray " + Math.round(info.value) + "%";
+          }
+
+          if (label) {
+            var textX, textY;
+            if (position === "right") {
+              textX = chipX + chipSize + 6;
+              textY = chipY - 2;
+            } else {
+              textX = chipX;
+              textY = chipY - chipSize - 4;
+            }
+            var textFrame = chipLayer.textFrames.add();
+            textFrame.contents = label.split(String.fromCharCode(10)).join(String.fromCharCode(13));
+            textFrame.position = [textX, textY];
+            try {
+              textFrame.textRange.characterAttributes.size = 7;
+              // Set text to black/dark
+              if (isCMYKDoc) {
+                var tc = new CMYKColor();
+                tc.cyan = 0; tc.magenta = 0; tc.yellow = 0; tc.black = 100;
+                textFrame.textRange.characterAttributes.fillColor = tc;
+              } else {
+                var trgb = new RGBColor();
+                trgb.red = 0; trgb.green = 0; trgb.blue = 0;
+                textFrame.textRange.characterAttributes.fillColor = trgb;
+              }
+            } catch(e) {}
+          }
+        }
+
+        placedCount++;
+      }
+
+      writeResultFile(RESULT_PATH, {
+        success: true,
+        chipCount: placedCount,
+        layerName: layerName,
+        position: position
+      });
+    }
+  } catch (e) {
+    writeResultFile(RESULT_PATH, { error: true, message: "Place color chips failed: " + e.message, line: e.line });
+  }
+}
+`;
+export function register(server) {
+    server.registerTool('place_color_chips', {
+        title: 'Place Color Chips',
+        description: 'Extract all unique colors from the document and place color chip swatches with labels outside the artboard',
+        inputSchema: {
+            artboard_index: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Target artboard (default: active artboard)'),
+            chip_size: z
+                .number()
+                .optional()
+                .default(30)
+                .describe('Chip size in points (default: 30)'),
+            position: z
+                .enum(['right', 'bottom'])
+                .optional()
+                .default('right')
+                .describe('Place chips to the right or below the artboard'),
+            include_info: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe('Include color value labels next to chips'),
+            layer_name: z
+                .string()
+                .optional()
+                .default('Color Chips')
+                .describe('Layer name for color chips'),
+            coordinate_system: coordinateSystemSchema,
+        },
+        annotations: WRITE_ANNOTATIONS,
+    }, async (params) => {
+        const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
+        const result = await executeJsxHeavy(jsxCode, resolvedParams);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=place-color-chips.js.map

package/dist/tools/modify/place-color-chips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"place-color-chips.js","sourceRoot":"","sources":["../../../src/tools/modify/place-color-chips.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuKf,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,4GAA4G;QAC9G,WAAW,EAAE;YACX,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,4CAA4C,CAAC;YACzD,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,mCAAmC,CAAC;YAChD,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;iBACzB,QAAQ,EAAE;iBACV,OAAO,CAAC,OAAO,CAAC;iBAChB,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,YAAY,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,0CAA0C,CAAC;YACvD,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,aAAa,CAAC;iBACtB,QAAQ,CAAC,4BAA4B,CAAC;YACzC,iBAAiB,EAAE,sBAAsB;SAC1C;QACD,WAAW,EAAE,iBAAiB;KAC/B,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACjH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC9D,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/place-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"place-image.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/place-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4FpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsChD"}
+{"version":3,"file":"place-image.d.ts","sourceRoot":"","sources":["../../../src/tools/modify/place-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8FpE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BhD"}

package/dist/tools/modify/place-image.js

@@ -1,5 +1,15 @@
 import { z } from 'zod';
 import { executeJsx } from '../../executor/jsx-runner.js';
+import { coordinateSystemSchema, resolveCoordinateSystem, } from '../session.js';
+import { WRITE_ANNOTATIONS } from './shared.js';
+/**
+ * place_image — 画像の配置（リンク/埋め込み）
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/PlacedItems/ — PlacedItems.add()
+ * @see https://ai-scripting.docsforadobe.dev/jsobjref/PlacedItem/ — file, embed()
+ *
+ * 注意: PlacedItem.file はリファレンスで read-only と記載されているが、
+ * PlacedItems.add() 後に設定する方法が PlacedItems のドキュメントで推奨されている。
+ */
 const jsxCode = `
 var preflight = preflightChecks();
 if (preflight) {
@@ -15,32 +25,17 @@ if (preflight) {
     if (!imgFile.exists) {
       writeResultFile(RESULT_PATH, { error: true, message: "Image file not found: " + filePath });
     } else {
-      var targetLayer = doc.activeLayer;
-      if (params.layer_name) {
-        try {
-          targetLayer = doc.layers.getByName(params.layer_name);
-        } catch (e) {
-          targetLayer = doc.layers.add();
-          targetLayer.name = params.layer_name;
-        }
-      }
+      var targetLayer = resolveTargetLayer(doc, params.layer_name);
 
       var placed = targetLayer.placedItems.add();
       placed.file = imgFile;
 
       // Position
       if (typeof params.x === "number" && typeof params.y === "number") {
-        var inputX = params.x;
-        var inputY = params.y;
-        if (coordSystem === "artboard-web") {
-          var ab = doc.artboards[doc.artboards.getActiveArtboardIndex()];
-          var abRect = ab.artboardRect;
-          placed.left = abRect[0] + inputX;
-          placed.top = abRect[1] + (-inputY);
-        } else {
-          placed.left = inputX;
-          placed.top = inputY;
-        }
+        var abRect = (coordSystem === "artboard-web") ? getActiveArtboardRect() : null;
+        var pos = webToAiPoint(params.x, params.y, coordSystem, abRect);
+        placed.left = pos[0];
+        placed.top = pos[1];
       }
 
       if (params.name) {
@@ -55,16 +50,20 @@ if (preflight) {
         placed.name = tag;
         placed.embed();
         // After embed(), 'placed' is no longer valid. Find the RasterItem by name.
+        var foundEmbedded = false;
         for (var ri = 0; ri < doc.rasterItems.length; ri++) {
           if (doc.rasterItems[ri].name === tag) {
             resultItem = doc.rasterItems[ri];
+            foundEmbedded = true;
             break;
           }
         }
-        // Restore the requested name
-        if (params.name) {
-          resultItem.name = params.name;
+        if (!foundEmbedded) {
+          writeResultFile(RESULT_PATH, { error: true, message: "embed() succeeded but resulting RasterItem could not be found" });
+          return;
         }
+        // タグ名をクリア（ユーザー指定名があれば復元、なければ空文字に）
+        resultItem.name = params.name || "";
       }
 
       var uuid = ensureUUID(resultItem);
@@ -102,20 +101,12 @@ export function register(server) {
                 .describe('Embed the image instead of linking (default: false)'),
             layer_name: z.string().optional().describe('Target layer name'),
             name: z.string().optional().describe('Object name'),
-            coordinate_system: z
-                .enum(['artboard-web', 'document'])
-                .optional()
-                .default('artboard-web')
-                .describe('Coordinate system (artboard-web: artboard-relative Y-down, document: native Illustrator coordinates)'),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
+            coordinate_system: coordinateSystemSchema,
         },
+        annotations: WRITE_ANNOTATIONS,
     }, async (params) => {
-        const result = await executeJsx(jsxCode, params, { activate: true });
+        const resolvedParams = { ...params, coordinate_system: await resolveCoordinateSystem(params.coordinate_system) };
+        const result = await executeJsx(jsxCode, resolvedParams, { activate: true });
         return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     });
 }