@bubblydoo/photoshop-mcp 0.0.2

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/HistoryStates.d.ts

@@ -0,0 +1,56 @@
+import type { HistoryState } from '../HistoryState';
+/**
+ * A collections class allowing for array access into a document's history states,
+ * while also providing familiar methods from ExtendScript, like `getByName`
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/historystates/}
+ *
+ * @example
+ * ```javascript
+ * // Iterate through all history states
+ * app.activeDocument.historyStates.forEach(h => console.log(h.name));
+ *
+ * // Find all snapshot history states
+ * var snapshots = app.activeDocument.historyStates.filter(h => h.snapshot)
+ * ```
+ */
+export class HistoryStates extends Array<HistoryState> {
+  /**
+   * @ignore
+   */
+  readonly _docId: number;
+  /**
+   * @ignore
+   */
+  private proxy;
+  /**
+   * Used to access the history states in the collection.
+   * @minVersion 22.5
+   */
+  [index: number]: HistoryState;
+  /**
+   * @ignore
+   */
+  constructor(docId: number);
+  /**
+   * @ignore
+   */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * Find the first history state with the matching name.
+   * @minVersion 22.5
+   */
+  getByName(name: string): HistoryState;
+  /**
+   * Number of {@link HistoryState} elements in this collection.
+   * @minVersion 22.5
+   */
+  get length(): number;
+  /**
+   * The owner document of this HistoryState collection.
+   * @minVersion 22.5
+   */
+  get parent(): Document;
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/LayerComps.d.ts

@@ -0,0 +1,92 @@
+import type { Document } from '../Document';
+import type { LayerComp } from '../LayerComp';
+import type { LayerCompCreateOptions } from '../types/LayerCompTypes';
+/**
+ * A collections class allowing for array access into a document's Layer Comps
+ *
+ * Access this collection through {@link Document.layerComps} property. For example,
+ * following adds a new Layer Comp to the collection:
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/layercomps/}
+ *
+ * @example
+ * ```javascript
+ * const comp = await app.activeDocument.layerComps.add();
+ * ```
+ *
+ * @minVersion 24.0
+ */
+export class LayerComps extends Array<LayerComp> {
+  /**
+   * @ignore
+   */
+  readonly _docId: number;
+  /**
+   * @ignore
+   */
+  private proxy;
+  /**
+   * Used to access the Layer Comp in the collection
+   */
+  [index: number]: LayerComp;
+  /**
+   * @ignore
+   */
+  constructor(docId: number);
+  /**
+   * @ignore
+   */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * The name for this object collection: LayerComps
+   *
+   * @minVersion 24.0
+   */
+  get typename(): 'LayerComps';
+  /**
+   * Number of {@link LayerComp} elements in this collection
+   *
+   * @minVersion 24.0
+   */
+  get length(): number;
+  /**
+   * The owner document of this Layer comp collection
+   *
+   * @minVersion 24.0
+   */
+  get parent(): Document;
+  /**
+   * Adds a Layer Comp to the document's collection. If no options are given, only visibility will be recorded.
+   *
+   * Note: This command will fail if the document is flat, that is, only a Background and no other layers.
+   *
+   * @param options An optional object literal containing key/value pairs as described by {@link LayerCompCreateOptions}
+   * ```javascript
+   * const options = {
+   *   name: "mockup",
+   *   comment: "First attempt",
+   *   visibility: true,
+   *   position: true
+   *  };
+   * await require('photoshop').app.activeDocument.layerComps.add(options);
+   * ```
+   *
+   * @minVersion 24.0
+   */
+  add(options?: LayerCompCreateOptions): Promise<LayerComp>;
+  /**
+   * Clears all Layer Comps from this collection
+   *
+   * @minVersion 24.0
+   */
+  removeAll(): Promise<void>;
+  /**
+   * Get all Layer Comps by name
+   * @param name
+   *
+   * @minVersion 24.0
+   */
+  getAllByName(name: string): LayerComp[];
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/Layers.d.ts

@@ -0,0 +1,68 @@
+import type { Layer } from '../Layer';
+/**
+ * A collections class allowing for array access into the applications
+ * list of layers on a document,
+ * while also providing familiar methods from ExtendScript, like `getByName`
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/layers/}
+ *
+ * @example
+ * ```javascript
+ * // Iterate through all the top layers of frontmost document
+ * app.activeDocument.layers.forEach(h => console.log(h.name));
+ * ```
+ */
+export class Layers extends Array<Layer> {
+  /** @ignore */
+  private proxy;
+  /** @ignore */
+  private parentDocID;
+  /** @ignore */
+  private layerIDs;
+  /**
+   * Used to access the layers in the collection.
+   * @minVersion 22.5
+   */
+  [index: number]: Layer;
+  /** @ignore */
+  constructor(parentDoc: number, layerIDs: number[]);
+  /** @ignore */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * Find the first layer with the matching name.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/layers/#getbyname}
+   * @minVersion 22.5
+   */
+  getByName(name: string): Layer;
+  /**
+   * Number of {@link Layer} elements in this collection.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/layers/#length}
+   * @minVersion 22.5
+   */
+  get length(): number;
+  /**
+   * The name for this object collection: Layers.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/layers/#typename}
+   * @minVersion 22.5
+   */
+  get typename(): 'Layers';
+  /**
+   * Create a new layer.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/layers/#add}
+   *
+   * @example
+   * ```javascript
+   * let newDoc1 = await app.activeDocument.layers.add();
+   * ```
+   *
+   * @async
+   * @minVersion 22.5
+   */
+  add(): Promise<Layer | null>;
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/PathItems.d.ts

@@ -0,0 +1,65 @@
+import type { SubPathInfo } from '../objects/SubPathInfo';
+import type { PathItem } from '../PathItem';
+/**
+ * The collection of {@link PathItem} objects in a document.
+ *
+ * Access through the {@link Document.pathItems} collection property. To create new paths,
+ * see {@link PathPointInfo} and {@link SubPathInfo} classes and pass them to {@link PathItems.add}() method.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/pathitems/}
+ */
+export class PathItems extends Array<PathItem> {
+  /**
+   * @ignore
+   */
+  readonly _docId: number;
+  /**
+   * @ignore
+   */
+  private proxy;
+  /**
+   * Used to access the paths in the collection.
+   * @minVersion 23.3
+   */
+  [index: number]: PathItem;
+  /**
+   * @ignore
+   */
+  constructor(docId: number);
+  /**
+   * @ignore
+   */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * Number of {@link PathItem} objects in this collection.
+   * @minVersion 23.3
+   */
+  get length(): number;
+  /**
+   * The owner document of this PathItem collection.
+   * @minVersion 23.3
+   */
+  get parent(): Document;
+  /**
+   * Creates a new path item object and adds it to this collection.
+   *
+   * A new {@link SubPathItem} object is created for each {@link SubPathInfo} object provided in `entirePath`,
+   * and those {@link SubPathItem} objects are added to the {@link PathItem.subPathItems} collection of the returned
+   * {@link PathItem}.
+   * @minVersion 23.3
+   */
+  add(name: string, entirePath: SubPathInfo[]): PathItem;
+  /**
+   * Removes all paths from this collection.
+   * @minVersion 23.3
+   */
+  removeAll(): void;
+  /**
+   * Retrieve the first PathItem matching the given name.
+   * @param name Name to find
+   * @minVersion 23.3
+   */
+  getByName(name: string): PathItem;
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/PathPoints.d.ts

@@ -0,0 +1,50 @@
+import type { PathPoint } from '../PathPoint';
+import type { SubPathItem } from '../SubPathItem';
+/**
+ * A collection of {@link PathPoint} objects that define a subpath, kept in the {@link SubPathItem.pathPoints} property.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/pathpoints/}
+ */
+export class PathPoints extends Array<PathPoint> {
+  /**
+   * @ignore
+   */
+  readonly _docId: number;
+  /**
+   * @ignore
+   */
+  readonly _pathId: number;
+  /**
+   * @ignore
+   */
+  readonly _subPathIndex: number;
+  /**
+   * @ignore
+   */
+  private proxy;
+  /**
+   * Used to access the guides in the collection.
+   * @minVersion 23.3
+   */
+  [index: number]: PathPoint;
+  /**
+   * @ignore
+   */
+  constructor(index: number, pathId: number, docId: number);
+  /**
+   * @ignore
+   */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * Number of elements in this collection.
+   * @minVersion 23.3
+   */
+  get length(): number;
+  /**
+   * The SubPathItem that contains this PathPoints collection.
+   * @minVersion 23.3
+   */
+  get parent(): SubPathItem;
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/SubPathItems.d.ts

@@ -0,0 +1,50 @@
+import type { PathItem } from '../PathItem';
+import type { SubPathItem } from '../SubPathItem';
+/**
+ * A collection of {@link SubPathItem} objects that make up a {@link PathItem}. Access this object in the
+ * {@link PathItem.subPathItems} collection property.
+ *
+ *  - Use {@link SubPathInfo} to create subpaths; the properties are writeable.
+ *  - Use the {@link SubPathItem} object to retrieve information about existing subpaths. The properties are read-only.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/subpathitems/}
+ */
+export class SubPathItems extends Array<SubPathItem> {
+  /**
+   * @ignore
+   */
+  readonly _docId: number;
+  /**
+   * @ignore
+   */
+  readonly _pathId: number;
+  /**
+   * @ignore
+   */
+  private proxy;
+  /**
+   * Used to access the guides in the collection.
+   * @minVersion 23.3
+   */
+  [index: number]: SubPathItem;
+  /**
+   * @ignore
+   */
+  constructor(pathId: number, docId: number);
+  /**
+   * @ignore
+   */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * Number of elements in this collection.
+   * @minVersion 23.3
+   */
+  get length(): number;
+  /**
+   * The PathItem that contains this SubPathItem.
+   * @minVersion 23.3
+   */
+  get parent(): PathItem;
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/collections/TextFonts.d.ts

@@ -0,0 +1,43 @@
+import type { TextFont } from '../objects/TextFont';
+import type { Photoshop } from '../Photoshop';
+/**
+ * The collection of fonts available on your computer. Fonts are represented by
+ *  {@link TextFont} objects. Access this object in the {@link Photoshop.fonts} property.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/textfonts/}
+ */
+export class TextFonts extends Array<TextFont> {
+  /** @ignore */
+  private proxy;
+  /** @ignore */
+  constructor();
+  /**
+   * Used to access the text fonts in the collection.
+   * @minVersion 23.0
+   */
+  [index: number]: TextFont;
+  /** @ignore */
+  handler(): {
+    get: (obj: any, key: any) => any;
+  };
+  /**
+   * Find the first font with the given PostScript name.
+   * @minVersion 23.0
+   */
+  getByName(name: string): TextFont;
+  /**
+   * Number of {@link TextFont} elements in this collection.
+   * @minVersion 23.0
+   */
+  get length(): number;
+  /**
+   * The owner application of this TextFonts collection.
+   * @minVersion 23.0
+   */
+  get parent(): Photoshop;
+  /**
+   * The name for this object collection: TextFonts.
+   * @minVersion 23.0
+   */
+  get typename(): 'TextFonts';
+}

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/dom/objects/Colors.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Defines a CMYK color, used in {@link SolidColor} object.
+ *
+ *  ***Fixes in Photoshop 24.2:***
+ * - *Getter now will return number instead of `undefined`*
+ * - *Value used in setter is now respected when passed to Photoshop*
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/objects/cmykcolor/}
+ * @targetfolder colors
+ * @minVersion 23.0
+ */
+export class CMYKColor {
+  /**
+   * The black color value, as percentage.
+   * @default 0
+   * @range 0.0..100.0
+   * @minVersion 23.0
+   */
+  get black(): number;
+  set black(b: number);
+  /**
+   * The cyan color value, as percentage.
+   * @default 0
+   * @range 0.0..100.0
+   * @minVersion 23.0
+   */
+  get cyan(): number;
+  set cyan(c: number);
+  /**
+   * The magenta color value, as percentage.
+   * @default 0
+   * @range 0.0..100.0
+   * @minVersion 23.0
+   */
+  get magenta(): number;
+  set magenta(m: number);
+  /**
+   * The yellow color value, as percentage.
+   * @default 0
+   * @range 0.0..100.0
+   *
+   * @minVersion 23.0
+   */
+  get yellow(): number;
+  set yellow(y: number);
+  /**
+   * The class name of the referenced object: *"CMYKColor"*.
+   * @minVersion 23.0
+   */
+  get typename(): 'CMYKColor';
+}
+/**
+ * Defines a grayscale color, used in {@link SolidColor} object.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/objects/graycolor/}
+ *
+ * @targetfolder colors
+ * @minVersion 23.0
+ */
+export class GrayColor {
+  /**
+   * The gray value.
+   *
+   * @default 0
+   * @range 0..100
+   * @minVersion 23.0
+   */
+  get gray(): number;
+  set gray(g: number);
+  /**
+   * The class name of the referenced object: *"GrayColor"*.
+   * @minVersion 23.0
+   */
+  get typename(): 'GrayColor';
+}
+/**
+ * Defines an HSB color, used in {@link SolidColor} object.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/objects/hsbcolor/}
+ * @targetfolder colors
+ * @minVersion 23.0
+ */
+export class HSBColor {
+  /**
+   * The brightness value.
+   *
+   * @default 100
+   * @range 0..100
+   * @minVersion 23.0
+   */
+  get brightness(): number;
+  set brightness(b: number);
+  /**
+   * The hue value.
+   *
+   * @default 360
+   * @range 0..360
+   * @minVersion 23.0
+   */
+  get hue(): number;
+  set hue(h: number);
+  /**
+   * The saturation value.
+   *
+   * @default 0
+   * @range 0..100
+   * @minVersion 23.0
+   */
+  get saturation(): number;
+  set saturation(s: number);
+  /**
+   * The class name of the referenced object: *"HSBColor"*.
+   * @minVersion 23.0
+   */
+  get typename(): 'HSBColor';
+}
+/**
+ * Defines a L<sup>\*</sup>a<sup>\*</sup>b<sup>\*</sup> color, used in {@link SolidColor} object.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/objects/labcolor/}
+ * @targetfolder colors
+ * @minVersion 23.0
+ */
+export class LabColor {
+  /**
+   * The a-value.
+   *
+   * @default 0
+   * @range -128..127
+   * @minVersion 23.0
+   */
+  get a(): number;
+  set a(a: number);
+  /**
+   * The b-value.
+   *
+   * @default 0
+   * @range -128..127
+   * @minVersion 23.0
+   */
+  get b(): number;
+  set b(b: number);
+  /**
+   * The L-value.
+   *
+   * @default 100
+   * @range 0..100
+   * @minVersion 23.0
+   */
+  get l(): number;
+  set l(l: number);
+  /**
+   * The class name of the referenced object: *"LabColor"*.
+   * @minVersion 23.0
+   */
+  get typename(): 'LabColor';
+}
+/**
+ * Defines an RGB color, used in {@link SolidColor} object.
+ *
+ * Please note: RGB with 32 bits per channels is not currently supported. Color values will be rounded to the nearest
+ * range valid for RGB with 16 bits per channel.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/objects/rgbcolor/}
+ * @targetfolder colors
+ * @minVersion 23.0
+ */
+export class RGBColor {
+  /**
+   * The blue color value.
+   *
+   * @default 255
+   * @range 0..255
+   * @minVersion 23.0
+   */
+  get blue(): number;
+  set blue(b: number);
+  /**
+   * The green color value.
+   *
+   * @default 255
+   * @range 0..255
+   * @minVersion 23.0
+   */
+  get green(): number;
+  set green(g: number);
+  /**
+   * The red color value.
+   *
+   * @default 255
+   * @range 0..255
+   * @minVersion 23.0
+   */
+  get red(): number;
+  set red(r: number);
+  /**
+   * The hexadecimal representation of the color.
+   *
+   * Ex. returns *FF9801*, but accepts *#ff9801* or *FF9801*.
+   *
+   * @default "FFFFFF"
+   * @minVersion 23.0
+   */
+  get hexValue(): string;
+  set hexValue(value: string);
+  /**
+   * The class name of the referenced object: *"RGBColor"*.
+   * @minVersion 23.0
+   */
+  get typename(): 'RGBColor';
+}
+/**
+ * Represents a missing color, used in {@link SolidColor} object.
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/objects/nocolor/}
+ * @targetfolder colors
+ * @minVersion 23.0
+ */
+export class NoColor {
+  /**
+   * The class name of the referenced object: *"NoColor"*.
+   * @minVersion 23.0
+   */
+  get typename(): 'NoColor';
+}