@bubblydoo/photoshop-mcp 0.0.2

package/dist-runtime/runtime-code.d.cts

@@ -0,0 +1,9 @@
+import * as uxpToolkit from '@bubblydoo/uxp-toolkit';
+import * as uxpToolkitCommands from '@bubblydoo/uxp-toolkit/commands';
+
+declare const _default: {
+    uxpToolkit: typeof uxpToolkit;
+    uxpToolkitCommands: typeof uxpToolkitCommands;
+};
+
+export { _default as default };

package/dist-schemas/@adobe-uxp-types/photoshop/src/index.d.ts

@@ -0,0 +1,16 @@
+import { constants } from './internal/dom/Constants';
+import { action, core } from './internal/dom/CoreModules';
+import { imaging } from './internal/dom/ImagingModule';
+import { app } from './internal/dom/Photoshop';
+
+export type * from './internal/all-types';
+export { action, app, constants, core, imaging };
+
+const _default: {
+  app: typeof app;
+  core: typeof core;
+  action: typeof action;
+  constants: typeof constants;
+  imaging: typeof imaging;
+};
+export default _default;

package/dist-schemas/@adobe-uxp-types/photoshop/src/internal/all-types.d.ts

@@ -0,0 +1,65 @@
+export type * from './dom/Actions';
+export type * from './dom/Channel';
+export type * from './dom/collections/Channels';
+export type * from './dom/collections/ColorSamplers';
+export type * from './dom/collections/CountItems';
+export type * from './dom/collections/Documents';
+export type * from './dom/collections/Guides';
+export type * from './dom/collections/HistoryStates';
+export type * from './dom/collections/LayerComps';
+export type * from './dom/collections/Layers';
+export type * from './dom/collections/PathItems';
+export type * from './dom/collections/PathPoints';
+export type * from './dom/collections/SubPathItems';
+export type * from './dom/collections/TextFonts';
+export type * from './dom/ColorSampler';
+export type * from './dom/Constants';
+export type * from './dom/CoreModules';
+export type * from './dom/CountItem';
+export type * from './dom/Document';
+export type * from './dom/Guide';
+export type * from './dom/HistoryState';
+export type * from './dom/ImagingModule';
+export type * from './dom/Layer';
+export type * from './dom/LayerComp';
+export type * from './dom/Objects';
+export type * from './dom/objects/Colors';
+export type * from './dom/objects/ConversionOptions';
+export type * from './dom/objects/ImagingBounds';
+export type * from './dom/objects/PathPointInfo';
+export type * from './dom/objects/SaveOptions';
+export type * from './dom/objects/SolidColor';
+export type * from './dom/objects/SubPathInfo';
+export type * from './dom/objects/TextFont';
+export type * from './dom/objects/Tool';
+export type * from './dom/PathItem';
+export type * from './dom/PathPoint';
+export type * from './dom/Photoshop';
+export type * from './dom/preferences/Preferences';
+export type * from './dom/preferences/PreferencesBase';
+export type * from './dom/preferences/PreferencesCursors';
+export type * from './dom/preferences/PreferencesFileHandling';
+export type * from './dom/preferences/PreferencesGeneral';
+export type * from './dom/preferences/PreferencesGuidesGridsAndSlices';
+export type * from './dom/preferences/PreferencesHistory';
+export type * from './dom/preferences/PreferencesInterface';
+export type * from './dom/preferences/PreferencesPerformance';
+export type * from './dom/preferences/PreferencesTools';
+export type * from './dom/preferences/PreferencesTransparencyAndGamut';
+export type * from './dom/preferences/PreferencesType';
+export type * from './dom/preferences/PreferencesUnitsAndRulers';
+export type * from './dom/Selection';
+export type * from './dom/SubPathItem';
+export type * from './dom/text/CharacterStyle';
+export type * from './dom/text/ParagraphStyle';
+export type * from './dom/text/TextWarpStyle';
+export type * from './dom/TextItem';
+export type * from './dom/types/ApplyImageTypes';
+export type * from './dom/types/CalculationsTypes';
+export type * from './dom/types/DocumentTypes';
+export type * from './dom/types/LayerCompTypes';
+export type * from './dom/types/LayerTypes';
+export type * from './dom/types/SharedTypes';
+export type * from './dom/types/TextTypes';
+export type * from './util/colorTypes';
+export type * from './util/unit';

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

@@ -0,0 +1,230 @@
+/**
+ * Photoshop Actions
+ *
+ * Handles the content in Actions panel.
+ * Actions panel will have a hierarchy of Action Sets that contain a list of Actions
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/}
+ *
+ * @example
+ * ```js
+ * // Play all actions in a set
+ * const actionSet = app.actionTree[0]; // Get first action set
+ * await actionSet.play();
+ * ```
+ *
+ * @example
+ * ```js
+ * // Duplicate an action set
+ * const actionSet = app.actionTree[0];
+ * const copiedSet = actionSet.duplicate();
+ * console.log(copiedSet.name); // Copy of [original name]
+ * ```
+ */
+export class ActionSet {
+  /**
+   * The class name of the referenced object: *"ActionSet"*.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#typename}
+   * @minVersion 23.0
+   */
+  get typename(): 'ActionSet';
+  /**
+   * Zero-based index of this Action Set in the Actions palette
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#index}
+   * @minVersion 22.1
+   */
+  get index(): number;
+  /**
+   * The internal ID of this Action Set
+   * Can be used for batchPlay calls, used internally
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#id}
+   * @minVersion 22.1
+   */
+  get id(): number;
+  /**
+   * The name of this Action Set, displayed in the panel
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#name}
+   * @minVersion 22.1
+   */
+  get name(): string;
+  /**
+   * Renames the Action Set
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#name}
+   * @minVersion 22.1
+   */
+  set name(name: string);
+  /**
+   * List of Actions in this Action Set
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#actions}
+   * @minVersion 22.1
+   */
+  get actions(): Action[];
+  /**
+   * @ignore
+   */
+  constructor(id: any);
+  /**
+   * Deletes this Action Set from the Actions panel
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#delete}
+   *
+   * @example
+   * ```js
+   * const actionSet = app.actionTree[0];
+   * actionSet.delete(); // Removes from Actions panel
+   * ```
+   *
+   * @minVersion 22.1
+   */
+  delete(): void;
+  /**
+   * Creates a copy of this Action Set
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#duplicate}
+   *
+   * @example
+   * ```js
+   * const actionSet = app.actionTree[0];
+   * const copy = actionSet.duplicate();
+   * ```
+   *
+   * @minVersion 22.1
+   */
+  duplicate(): ActionSet;
+  /**
+   * Plays all Actions in this set one by one
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/actionset/#play}
+   *
+   * @example
+   * ```js
+   * const actionSet = app.actionTree[0];
+   * await actionSet.play(); // Plays all actions in sequence
+   * ```
+   *
+   * @async
+   * @minVersion 22.1
+   */
+  play(): Promise<void>;
+}
+/**
+ * Represents an Action in the Actions palette.
+ * Actions are series of commands that can be recorded by user, and can be replayed at a later time
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/}
+ *
+ * @example
+ * ```js
+ * // Access and play an action
+ * const actionSet = app.actionTree[0];
+ * const action = actionSet.actions[0];
+ * await action.play();
+ * ```
+ *
+ * @example
+ * ```js
+ * // Rename and duplicate an action
+ * const action = app.actionTree[0].actions[0];
+ * action.name = "My Custom Action";
+ * const copy = action.duplicate();
+ * ```
+ */
+export class Action {
+  /**
+   * The class name of the referenced object: *"Action"*.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#typename}
+   * @minVersion 23.0
+   */
+  get typename(): 'Action';
+  /**
+   * The internal ID of this Action
+   * Can be used for batchPlay calls, used internally
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#id}
+   * @minVersion 22.1
+   */
+  get id(): number;
+  /**
+   * Zero-based index of this Action in it's parent Action Set
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#index}
+   * @minVersion 22.1
+   */
+  get index(): number;
+  /**
+   * The name of this Action, displayed in the panel
+   * Cannot be changed
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#name}
+   * @minVersion 22.1
+   */
+  get name(): string;
+  /**
+   * Renames the Action Set
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#name}
+   * @minVersion 22.1
+   */
+  set name(name: string);
+  /**
+   * The Action Set this Action belongs to
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#parent}
+   * @minVersion 22.1
+   */
+  get parent(): ActionSet;
+  /**
+   * @ignore
+   */
+  constructor(id: number);
+  /**
+   * Deletes this Action from the Actions panel
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#delete}
+   *
+   * @example
+   * ```js
+   * const action = app.actionTree[0].actions[0];
+   * action.delete(); // Removes from Actions panel
+   * ```
+   *
+   * @minVersion 22.1
+   */
+  delete(): void;
+  /**
+   * Plays this Action
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#play}
+   *
+   * @example
+   * ```js
+   * const action = app.actionTree[0].actions[0];
+   * await action.play(); // Executes the action
+   * ```
+   *
+   * @async
+   * @minVersion 22.1
+   */
+  play(): Promise<void>;
+  /**
+   * Creates a copy of this Action, placing it in the same Action Set
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/action/#duplicate}
+   *
+   * @example
+   * ```js
+   * const action = app.actionTree[0].actions[0];
+   * const copy = action.duplicate();
+   * ```
+   *
+   * @minVersion 22.1
+   */
+  duplicate(): Action;
+}

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

@@ -0,0 +1,120 @@
+import type * as Constants from './Constants';
+import type { Document } from './Document';
+import type { SolidColor } from './objects/SolidColor';
+/**
+ * Represents a channel in a Photoshop document.
+ * You can access instances of channels using one of these methods:
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/}
+ *
+ * @example
+ * ```javascript
+ * // An array of component channels in the document
+ * const componentChannels = app.activeDocument.componentChannels
+ *
+ * // An array of active (selected) channels in the document
+ * const activeChannels = app.activeDocument.activeChannels
+ *
+ * // Reference a document's Red channel
+ * const redChannel = app.activeDocument.channels[0]
+ * ```
+ * @minVersion 23.0
+ */
+export abstract class Channel {
+  /**
+   * The containing document.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#parent}
+   * @minVersion 23.0
+   */
+  get parent(): Document;
+  /**
+   * The type or kind of the channel.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#kind}
+   * @minVersion 23.0
+   */
+  get kind(): Constants.ChannelType;
+  set kind(kind: Constants.ChannelType);
+  /**
+   * The visibility of the channel.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#visible}
+   * @minVersion 23.0
+   */
+  get visible(): boolean;
+  set visible(visible: boolean);
+  /**
+   * Duplicates the channel to the parent document, or a target document
+   * if specified.
+   *
+   * @param targetDocument if specified, duplicate to a different document target.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#duplicate}
+   *
+   * @example
+   * ```javascript
+   * // duplicate the channel
+   * await channel.duplicate()
+   *
+   * // duplicate to a different, compatible document
+   * const newDoc = psApp.documents[1]
+   * await channel.duplicate(newDoc)
+   * ```
+   *
+   * @async
+   * @minVersion 23.0
+   */
+  duplicate(targetDocument?: Document): Promise<void>;
+  /**
+   * The name of the channel. For component channels this name can be localized.
+   *
+   * ***Fixes in Photoshop 24.6***
+   * - *For component channel it is no longer converted into lowercase and is same as in UI*
+   * - *For component channel it will throw an error if channel no longer exist in document*
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#name}
+   * @minVersion 23.0
+   */
+  abstract get name(): string;
+  abstract set name(name: string);
+  /**
+   * A histogram containing the number of pixels at each color
+   * intensity level for this channel. The array contains 256
+   * members. The target channel must be visible.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#histogram}
+   * @minVersion 23.0
+   */
+  abstract get histogram(): number[];
+  /**
+   * The color of the channel.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#color}
+   * @minVersion 23.0
+   */
+  abstract get color(): SolidColor;
+  abstract set color(color: SolidColor);
+  /**
+   * The opacity or solidity of the channel.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#opacity}
+   * @minVersion 23.0
+   */
+  abstract get opacity(): number;
+  abstract set opacity(opacity: number);
+  /**
+   * Deletes the channel.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#remove}
+   * @minVersion 23.0
+   */
+  abstract remove(): Promise<void>;
+  /**
+   * Merges a Spot Color channel into the component channels.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/channel/#merge}
+   * @minVersion 23.0
+   */
+  abstract merge(): Promise<void>;
+}

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

@@ -0,0 +1,105 @@
+import type { Document } from './Document';
+import type { NoColor } from './objects/Colors';
+import type { SolidColor } from './objects/SolidColor';
+/**
+ * Represents a ColorSampler object in the Photoshop DOM.
+ *
+ * ColorSamplers are created through the {@link ColorSamplers} collection via the {@link ColorSamplers.add} method:
+ *
+ * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/}
+ *
+ * @example
+ * ```javascript
+ * const app = require("photoshop").app;
+ * app.activeDocument.colorSamplers.add({x: 100, y: 100});
+ * ```
+ *
+ * Properties such as `color`, `position` and `parent` document can be then accessed on the ColorSampler instance:
+ *
+ * ```javascript
+ * let cs = app.activeDocument.colorSamplers[0];
+ * console.log(cs.position);  // {x: 100, y: 100}
+ * console.log(cs.color.rgb); // SolidColor {red: 0, green: 255, blue: 0}
+ * console.log(cs.parent);    // Document
+ * ```
+ *
+ * An existing ColorSampler instance can be moved to a different position:
+ *
+ * ```javascript
+ * cs.move({x: 200, y: 200});
+ * console.log(cs.position);  // {x: 200, y: 200}
+ * ```
+ *
+ * Or removed altogether from the document:
+ *
+ * ```javascript
+ * cs.remove();
+ * console.log(app.activeDocument.colorSamplers.length); // 0
+ * ```
+ */
+export class ColorSampler {
+  /**
+   * @ignore
+   */
+  constructor(docId: number, index: number, position: {
+    x: number;
+    y: number;
+  }, color: SolidColor | NoColor);
+  /**
+   * The class name of the referenced object: *"ColorSampler"*.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#typename}
+   * @minVersion 24.0
+   */
+  get typename(): 'ColorSampler';
+  /**
+   * The ID of the Document of this ColorSampler.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#docid}
+   * @minVersion 24.0
+   */
+  get docId(): number;
+  /**
+   * Owner document of this ColorSampler.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#parent}
+   * @minVersion 24.0
+   */
+  get parent(): Document;
+  /**
+   * The position of this ColorSampler.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#position}
+   * @minVersion 24.0
+   */
+  get position(): {
+    x: number;
+    y: number;
+  };
+  /**
+   * The color reading of this ColorSampler in its current position.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#color}
+   * @minVersion 24.0
+   * @returns a {@link SolidColor} instance.
+   */
+  get color(): SolidColor | NoColor;
+  /**
+   * Deletes the given ColorSampler object.
+   *
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#remove}
+   * @minVersion 24.0
+   */
+  remove(): void;
+  /**
+   * Moves the ColorSampler object to the given position
+   *
+   * @param position Object literal with target coordinates in pixels `{x: number, y: number}`.
+   * @see {@link https://developer.adobe.com/photoshop/uxp/2022/ps_reference/classes/colorsampler/#move}
+   * @minVersion 24.0
+   */
+  move(position: {
+    x: number;
+    y: number;
+  }): void;
+}