@alisaitteke/photoshop-mcp 1.1.2 → 1.2.0

package/dist/api/extendscript.d.ts

@@ -2,6 +2,16 @@
  * Helper functions for ExtendScript API
  * ExtendScript is the legacy scripting API for Photoshop
  */
+/** Curves adjustment layer helper — shared by atomics and recipes (uses __mcp_s2t / __mcp_c2t). */
+export declare const MCP_CURVES_ADJUSTMENT_HELPER = "\nfunction __mcp_makeCurvesAdjustmentLayer(preset) {\n  var usePreset = preset || 'auto_tone';\n  var desc = new ActionDescriptor();\n  var ref = new ActionReference();\n  ref.putClass(__mcp_s2t('adjustmentLayer'));\n  desc.putReference(__mcp_s2t('null'), ref);\n  var using = new ActionDescriptor();\n  var curvesAdjust = new ActionDescriptor();\n  var curvesAdjustments = new ActionList();\n  var curvesPair = new ActionDescriptor();\n  var curvesPoints = new ActionList();\n  var ptBlack = new ActionDescriptor();\n  var ptWhite = new ActionDescriptor();\n  if (usePreset === 'neutral') {\n    ptBlack.putDouble(__mcp_c2t('Hrzn'), 0);\n    ptBlack.putDouble(__mcp_c2t('Vrtc'), 0);\n    ptWhite.putDouble(__mcp_c2t('Hrzn'), 255);\n    ptWhite.putDouble(__mcp_c2t('Vrtc'), 255);\n  } else {\n    ptBlack.putDouble(__mcp_c2t('Hrzn'), 12);\n    ptBlack.putDouble(__mcp_c2t('Vrtc'), 0);\n    ptWhite.putDouble(__mcp_c2t('Hrzn'), 243);\n    ptWhite.putDouble(__mcp_c2t('Vrtc'), 255);\n  }\n  curvesPoints.putObject(__mcp_c2t('Pnt '), ptBlack);\n  curvesPoints.putObject(__mcp_c2t('Pnt '), ptWhite);\n  curvesPair.putList(__mcp_c2t('Crv '), curvesPoints);\n  var channelRef = new ActionReference();\n  channelRef.putEnumerated(__mcp_c2t('Chnl'), __mcp_c2t('Chnl'), __mcp_c2t('Cmps'));\n  curvesPair.putReference(__mcp_c2t('Chnl'), channelRef);\n  curvesAdjustments.putObject(__mcp_c2t('CrvA'), curvesPair);\n  curvesAdjust.putList(__mcp_c2t('Adjs'), curvesAdjustments);\n  using.putObject(__mcp_s2t('type'), __mcp_s2t('curves'), curvesAdjust);\n  desc.putObject(__mcp_s2t('using'), __mcp_s2t('adjustmentLayer'), using);\n  executeAction(__mcp_s2t('make'), desc, DialogModes.NO);\n  return app.activeDocument.activeLayer;\n}\n";
+/**
+ * Layer mask helpers — Adobe Community / StackSupport.jsx patterns.
+ * @see https://community.adobe.com/t5/photoshop-ecosystem-discussions/is-it-possible-to-make-a-layer-mask-with-the-current-selection-using-extendscript/td-p/10872052
+ * @see https://github.com/LeZuse/photoshop-scripts/blob/master/default/Stack%20Scripts%20Only/StackSupport.jsx
+ */
+export declare const MCP_LAYER_MASK_HELPERS = "\nfunction __mcp_hasLayerMaskAM() {\n  var ref = new ActionReference();\n  var args = new ActionDescriptor();\n  ref.putProperty(cTID('Prpr'), cTID('UsrM'));\n  ref.putEnumerated(cTID('Lyr '), cTID('Ordn'), cTID('Trgt'));\n  args.putReference(cTID('null'), ref);\n  try {\n    var resultDesc = executeAction(cTID('getd'), args, DialogModes.NO);\n    return resultDesc.hasKey(cTID('UsrM'));\n  } catch (e) {\n    return false;\n  }\n}\n\nfunction __mcp_makeLayerMaskAtChannel(maskMode) {\n  var desc = new ActionDescriptor();\n  var atRef = new ActionReference();\n  desc.putClass(sTID('new'), sTID('channel'));\n  atRef.putEnumerated(sTID('channel'), sTID('channel'), sTID('mask'));\n  desc.putReference(sTID('at'), atRef);\n  desc.putEnumerated(sTID('using'), sTID('userMaskEnabled'), sTID(maskMode));\n  executeAction(sTID('make'), desc, DialogModes.NO);\n}\n\nfunction __mcp_selectLayerMaskChannel() {\n  var selRef = new ActionReference();\n  selRef.putEnumerated(cTID('Chnl'), cTID('Ordn'), cTID('Trgt'));\n  var selDesc = new ActionDescriptor();\n  selDesc.putReference(cTID('null'), selRef);\n  selDesc.putBoolean(cTID('MkVs'), true);\n  executeAction(cTID('slct'), selDesc, DialogModes.NO);\n}\n\nfunction __mcp_pointDescPx(x, y) {\n  var desc = new ActionDescriptor();\n  desc.putUnitDouble(cTID('Hrzn'), cTID('#Pxl'), x);\n  desc.putUnitDouble(cTID('Vrtc'), cTID('#Pxl'), y);\n  return desc;\n}\n\nfunction __mcp_gradientStop(location, midPoint) {\n  var desc = new ActionDescriptor();\n  desc.putInteger(cTID('Lctn'), location);\n  desc.putInteger(cTID('Mdpn'), midPoint);\n  return desc;\n}\n\nfunction __mcp_grayColor(grayValue) {\n  var desc = new ActionDescriptor();\n  desc.putDouble(cTID('Gry '), grayValue);\n  return desc;\n}\n\n/** Linear black-to-white gradient on the active mask channel (StackSupport.jsx pattern). */\nfunction __mcp_gradientFillLayerMask(fromXPx, fromYPx, toXPx, toYPx, reverseGradient) {\n  var args = new ActionDescriptor();\n  args.putObject(cTID('From'), cTID('Pnt '), __mcp_pointDescPx(fromXPx, fromYPx));\n  args.putObject(cTID('T   '), cTID('Pnt '), __mcp_pointDescPx(toXPx, toYPx));\n  args.putEnumerated(cTID('Md  '), cTID('BlnM'), cTID('Nrml'));\n  args.putEnumerated(cTID('Type'), cTID('GrdT'), cTID('Lnr '));\n  args.putBoolean(cTID('Dthr'), true);\n  args.putBoolean(cTID('UsMs'), true);\n  args.putBoolean(cTID('Rvrs'), !!reverseGradient);\n\n  var gradDesc = new ActionDescriptor();\n  gradDesc.putString(cTID('Nm  '), 'Black, White');\n  gradDesc.putEnumerated(cTID('GrdF'), cTID('GrdF'), cTID('CstS'));\n  gradDesc.putDouble(cTID('Intr'), 4096.0);\n\n  var colorList = new ActionList();\n  var stopWhite = __mcp_gradientStop(0, 50);\n  stopWhite.putObject(cTID('Clr '), cTID('Grsc'), __mcp_grayColor(100.0));\n  stopWhite.putEnumerated(cTID('Type'), cTID('Clry'), cTID('UsrS'));\n  colorList.putObject(cTID('Clrt'), stopWhite);\n  var stopBlack = __mcp_gradientStop(4096, 50);\n  stopBlack.putObject(cTID('Clr '), cTID('Grsc'), __mcp_grayColor(0.0));\n  stopBlack.putEnumerated(cTID('Type'), cTID('Clry'), cTID('UsrS'));\n  colorList.putObject(cTID('Clrt'), stopBlack);\n  gradDesc.putList(cTID('Clrs'), colorList);\n\n  var xferList = new ActionList();\n  var xferA = __mcp_gradientStop(0, 50);\n  xferA.putUnitDouble(cTID('Opct'), cTID('#Prc'), 100.0);\n  xferList.putObject(cTID('TrnS'), xferA);\n  var xferB = __mcp_gradientStop(4096, 50);\n  xferB.putUnitDouble(cTID('Opct'), cTID('#Prc'), 100.0);\n  xferList.putObject(cTID('TrnS'), xferB);\n  gradDesc.putList(cTID('Trns'), xferList);\n\n  args.putObject(cTID('Grad'), cTID('Grdn'), gradDesc);\n  executeAction(cTID('Grdn'), args, DialogModes.NO);\n}\n";
+export type CurvesPreset = 'auto_tone' | 'neutral';
+export type GradientMaskDirection = 'top_to_bottom' | 'bottom_to_top' | 'left_to_right' | 'right_to_left';
 /**
  * Common ExtendScript snippets
  */
@@ -21,7 +31,7 @@ export declare const ExtendScriptSnippets: {
     /**
      * Create a text layer
      */
-    createTextLayer: (text: string, x?: number, y?: number, fontSize?: number) => string;
+    createTextLayer: (text: string, x?: number, y?: number, fontSize?: number, fontName?: string) => string;
     /**
      * Place an image file as a layer
      */
@@ -72,9 +82,9 @@ export declare const ExtendScriptSnippets: {
      */
     getLayerNames: () => string;
     /**
-     * Select layer by name
+     * Select layer by name (recursive search including layer groups)
      */
-    selectLayer: (name: string) => string;
+    selectLayerByName: (name: string) => string;
     /**
      * Scale active layer to fit document (maintain aspect ratio)
      */
@@ -160,6 +170,10 @@ export declare const ExtendScriptSnippets: {
      * Auto contrast adjustment
      */
     autoContrast: () => string;
+    /**
+     * Create a Curves adjustment layer (auto-tone S-curve or neutral identity curve).
+     */
+    adjustCurves: (preset?: CurvesPreset) => string;
     /**
      * Desaturate (convert to grayscale without changing color mode)
      */
@@ -176,6 +190,10 @@ export declare const ExtendScriptSnippets: {
      * Set text layer font
      */
     setTextFont: (fontName: string, fontSize?: number) => string;
+    /**
+     * List installed fonts (PostScript names required for TextItem.font).
+     */
+    listFonts: (query?: string, limit?: number) => string;
     /**
      * Set text color
      */
@@ -204,10 +222,22 @@ export declare const ExtendScriptSnippets: {
      * Invert selection
      */
     invertSelection: () => string;
+    /**
+     * Select the main subject on the active layer (DOM selectSubject, then autoCutout fallback).
+     */
+    selectSubject: (sampleAllLayers?: boolean) => string;
+    /**
+     * Content-aware fill on the current pixel selection.
+     */
+    contentAwareFill: () => string;
     /**
      * Create layer mask from selection
      */
     createLayerMask: () => string;
+    /**
+     * Apply a linear black-to-white gradient on the active layer's mask channel.
+     */
+    applyGradientMask: (direction?: GradientMaskDirection, startPct?: number, endPct?: number, angleDeg?: number) => string;
     /**
      * Delete layer mask
      */
@@ -260,6 +290,14 @@ export declare const ExtendScriptSnippets: {
      * Move layer down one position
      */
     moveLayerDown: () => string;
+    /**
+     * Lightweight session state snapshot (read-only).
+     */
+    getState: () => string;
+    /**
+     * Export a JPEG preview to the system temp folder. Returns filesystem path for Node to read.
+     */
+    exportPreview: (maxDimension?: number, jpegQuality?: number) => string;
 };
 /**
  * Generate ExtendScript code with error handling

package/dist/api/extendscript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extendscript.d.ts","sourceRoot":"","sources":["../../src/api/extendscript.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IASH;;OAEG;yBACkB,MAAM,UAAU,MAAM;IAW3C;;OAEG;;IAYH;;OAEG;4BACqB,MAAM;IAwB9B;;OAEG;2BACoB,MAAM;IAwC7B;;OAEG;0BACmB,MAAM;IAe5B;;OAEG;sBACe,MAAM;IAYxB;;OAEG;uBACgB,MAAM;IAazB;;OAEG;sBACe,MAAM;IAYxB;;OAEG;;IAUH;;OAEG;sBACe,MAAM;IAkBxB;;OAEG;;IAaH;;;;;;;OAOG;qBACc,MAAM,SAAS,MAAM,QAAQ,MAAM;IAyCpD;;OAEG;yBACkB,MAAM,UAAU,MAAM;IAiB3C;;OAEG;;IA4BH;;OAEG;wBACiB,MAAM;IAc1B;;OAEG;;IA8DH;;OAEG;+BACwB,MAAM;IAoBjC;;OAEG;wBACiB,MAAM,UAAU,MAAM;IAoB1C;;OAEG;2BACoB,MAAM;IAmB7B;;OAEG;+BACwB,MAAM;IAqBjC;;OAEG;mCAC4B,MAAM;IAqBrC;;OAEG;kCAC2B,OAAO;IAerC;;OAEG;6BACsB,OAAO;IAehC;;OAEG;2BACoB,MAAM;IAgB7B;;OAEG;+BACwB,MAAM;IAgBjC;;OAEG;;IAaH;;OAEG;;IAaH;;OAEG;gCACyB,MAAM;IA+BlC;;OAEG;+BACwB,MAAM,UAAU,MAAM,aAAa,MAAM;IAyBpE;;OAEG;4BACqB,MAAM,gBAAgB,MAAM,iBAAiB,OAAO;IA0B5E;;OAEG;6BACsB,MAAM,UAAU,MAAM;IAwB/C;;OAEG;2CACoC,MAAM,YAAY,MAAM;IAoB/D;;;;;;;OAOG;+BACwB,MAAM,cAAc,MAAM,aAAa,MAAM;IAsCxE;;OAEG;;IAmBH;;OAEG;;IAmBH;;OAEG;;IAmBH;;OAEG;;IAmBH;;OAEG;yBACkB,MAAM,OAAO,MAAM,SAAS,MAAM,UAAU,MAAM;IAgBvE;;OAEG;4BACqB,MAAM,aAAa,MAAM;IAmBjD;;OAEG;wBACiB,MAAM,SAAS,MAAM,QAAQ,MAAM;IAqBvD;;OAEG;kCAC2B,MAAM;IAiBpC;;OAEG;iCAC0B,MAAM;IAiBnC;;OAEG;4BACqB,MAAM,OAAO,MAAM,SAAS,MAAM,UAAU,MAAM;IAe1E;;OAEG;;IAaH;;OAEG;;IAaH;;OAEG;;IAaH;;OAEG;;IAqBH;;OAEG;;IAmBH;;OAEG;;IAmBH;;OAEG;6BACsB,MAAM,iBAAiB,MAAM;IAStD;;OAEG;gCACyB,MAAM;IAIlC;;OAEG;;IAwBH;;OAEG;;IAwCH;;OAEG;;IAwCH;;OAEG;;IAoCH;;OAEG;2CACoC,MAAM,YAAY,MAAM;IAiD/D;;OAEG;;IAuBH;;OAEG;;IAuBH;;OAEG;;IAuCH;;OAEG;;CAsCJ,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzD"}
+{"version":3,"file":"extendscript.d.ts","sourceRoot":"","sources":["../../src/api/extendscript.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqGH,mGAAmG;AACnG,eAAO,MAAM,4BAA4B,8rDAsCxC,CAAC;AAOF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,wlHA6FlC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,eAAe,GACf,eAAe,GACf,eAAe,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IASH;;OAEG;yBACkB,MAAM,UAAU,MAAM;IAW3C;;OAEG;;IAYH;;OAEG;4BACqB,MAAM,wDAA8C,MAAM;IAiClF;;OAEG;2BACoB,MAAM;IA6C7B;;OAEG;0BACmB,MAAM;IAe5B;;OAEG;sBACe,MAAM;IAYxB;;OAEG;uBACgB,MAAM;IAazB;;OAEG;sBACe,MAAM;IAYxB;;OAEG;;IAUH;;OAEG;sBACe,MAAM;IAkBxB;;OAEG;;IAaH;;;;;;;OAOG;qBACc,MAAM,SAAS,MAAM,QAAQ,MAAM;IAyCpD;;OAEG;yBACkB,MAAM,UAAU,MAAM;IAiB3C;;OAEG;;IAwCH;;OAEG;8BACuB,MAAM;IA6ChC;;OAEG;;IA8DH;;OAEG;+BACwB,MAAM;IAoBjC;;OAEG;wBACiB,MAAM,UAAU,MAAM;IAoB1C;;OAEG;2BACoB,MAAM;IAmB7B;;OAEG;+BACwB,MAAM;IAqBjC;;OAEG;mCAC4B,MAAM;IAqBrC;;OAEG;kCAC2B,OAAO;IAerC;;OAEG;6BACsB,OAAO;IAehC;;OAEG;2BACoB,MAAM;IAgB7B;;OAEG;+BACwB,MAAM;IAgBjC;;OAEG;;IAaH;;OAEG;;IAaH;;OAEG;gCACyB,MAAM;IA+BlC;;OAEG;+BACwB,MAAM,UAAU,MAAM,aAAa,MAAM;IAyBpE;;OAEG;4BACqB,MAAM,gBAAgB,MAAM,iBAAiB,OAAO;IA0B5E;;OAEG;6BACsB,MAAM,UAAU,MAAM;IAwB/C;;OAEG;2CACoC,MAAM,YAAY,MAAM;IAoB/D;;;;;;;OAOG;+BACwB,MAAM,cAAc,MAAM,aAAa,MAAM;IA2DxE;;OAEG;;IAmBH;;OAEG;;IAmBH;;OAEG;4BACoB,YAAY;IAmBnC;;OAEG;;IA+CH;;OAEG;;IAmBH;;OAEG;yBACkB,MAAM,OAAO,MAAM,SAAS,MAAM,UAAU,MAAM;IAgBvE;;OAEG;4BACqB,MAAM,aAAa,MAAM;IAwBjD;;OAEG;wBACiB,MAAM;IAuC1B;;OAEG;wBACiB,MAAM,SAAS,MAAM,QAAQ,MAAM;IAqBvD;;OAEG;kCAC2B,MAAM;IAiBpC;;OAEG;iCAC0B,MAAM;IAiBnC;;OAEG;4BACqB,MAAM,OAAO,MAAM,SAAS,MAAM,UAAU,MAAM;IAe1E;;OAEG;;IAaH;;OAEG;;IAaH;;OAEG;;IAaH;;OAEG;;IA0CH;;OAEG;;IA2BH;;OAEG;;IA6BH;;OAEG;oCAEU,qBAAqB,iDAGrB,MAAM;IA0DnB;;OAEG;;IAwBH;;OAEG;;IA4BH;;OAEG;6BACsB,MAAM,iBAAiB,MAAM;IAStD;;OAEG;gCACyB,MAAM;IAIlC;;OAEG;;IAgDH;;OAEG;;IAwCH;;OAEG;;IAwCH;;OAEG;;IAoCH;;OAEG;2CACoC,MAAM,YAAY,MAAM;IAiD/D;;OAEG;;IAuBH;;OAEG;;IA4BH;;OAEG;;IAuCH;;OAEG;;IAuCH;;OAEG;;IAMH;;OAEG;;CA2CJ,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzD"}