@ps-generator-bridge/generator 0.1.0

package/jsx/polyfills/Object.js

@@ -0,0 +1,80 @@
+//#region Object Polyfills (ES3 compatible)
+
+// Object.keys
+if (!Object.keys) {
+  Object.keys = function (obj) {
+    if (obj !== Object(obj)) {
+      throw new TypeError("Object.keys called on a non-object");
+    }
+    var result = [];
+    for (var key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        result.push(key);
+      }
+    }
+    return result;
+  };
+}
+
+// Object.values
+if (!Object.values) {
+  Object.values = function (obj) {
+    if (obj !== Object(obj)) {
+      throw new TypeError("Object.values called on a non-object");
+    }
+    var result = [];
+    for (var key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        result.push(obj[key]);
+      }
+    }
+    return result;
+  };
+}
+
+// Object.entries
+if (!Object.entries) {
+  Object.entries = function (obj) {
+    if (obj !== Object(obj)) {
+      throw new TypeError("Object.entries called on a non-object");
+    }
+    var result = [];
+    for (var key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        result.push([key, obj[key]]);
+      }
+    }
+    return result;
+  };
+}
+
+// Object.assign
+if (!Object.assign) {
+  Object.assign = function (target) {
+    if (target == null) {
+      throw new TypeError("Cannot convert undefined or null to object");
+    }
+    var to = Object(target);
+    for (var i = 1; i < arguments.length; i++) {
+      var source = arguments[i];
+      if (source != null) {
+        for (var key in source) {
+          if (Object.prototype.hasOwnProperty.call(source, key)) {
+            to[key] = source[key];
+          }
+        }
+      }
+    }
+    return to;
+  };
+}
+
+// Object.freeze
+if (!Object.freeze) {
+  Object.freeze = function (obj) {
+    // ES3 cannot truly freeze objects — return as-is (noop shim)
+    return obj;
+  };
+}
+
+//#endregion

package/jsx/polyfills/String.js

@@ -0,0 +1,87 @@
+//#region String Polyfills (ES3 compatible)
+
+// String.prototype.trim
+if (!String.prototype.trim) {
+  String.prototype.trim = function () {
+    return this.replace(/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, "");
+  };
+}
+
+// String.prototype.startsWith
+if (!String.prototype.startsWith) {
+  String.prototype.startsWith = function (searchString, position) {
+    var pos = position || 0;
+    return this.substring(pos, pos + searchString.length) === searchString;
+  };
+}
+
+// String.prototype.endsWith
+if (!String.prototype.endsWith) {
+  String.prototype.endsWith = function (searchString, length) {
+    var len = typeof length === "number" ? length : this.length;
+    var end = len;
+    var start = end - searchString.length;
+    if (start < 0) {
+      return false;
+    }
+    return this.substring(start, end) === searchString;
+  };
+}
+
+// String.prototype.includes
+if (!String.prototype.includes) {
+  String.prototype.includes = function (search, start) {
+    if (typeof start !== "number") {
+      start = 0;
+    }
+    if (start + search.length > this.length) {
+      return false;
+    }
+    return this.indexOf(search, start) !== -1;
+  };
+}
+
+// String.prototype.repeat
+if (!String.prototype.repeat) {
+  String.prototype.repeat = function (count) {
+    var n = Math.floor(Number(count));
+    if (n < 0 || n === Infinity) {
+      throw new RangeError("Invalid count value");
+    }
+    var result = "";
+    var str = String(this);
+    while (n > 0) {
+      if (n % 2 === 1) {
+        result = result + str;
+      }
+      n = Math.floor(n / 2);
+      if (n > 0) {
+        str = str + str;
+      }
+    }
+    return result;
+  };
+}
+
+// String.prototype.padStart
+if (!String.prototype.padStart) {
+  String.prototype.padStart = function (targetLength, padString) {
+    var str = String(this);
+    targetLength = targetLength >> 0;
+    if (str.length >= targetLength) {
+      return str;
+    }
+    var pad = typeof padString !== "undefined" ? String(padString) : " ";
+    if (pad.length === 0) {
+      return str;
+    }
+    var needed = targetLength - str.length;
+    var full = "";
+    while (full.length < needed) {
+      full = full + pad;
+    }
+    return full.substring(0, needed) + str;
+  };
+}
+
+//#endregion

package/jsx/types/extendscript/README.md

@@ -0,0 +1,34 @@
+# ExtendScript ambient type declarations
+
+Ambient (`declare`) type declarations for the Photoshop ExtendScript runtime DOM
+— the global `app`, `File`/`Folder`, `Document`, `Layer`, `RGBColor`, the enum
+constants, and so on. Sourced from the Photoshop scripting reference
+(https://theiviaxx.github.io/photoshop-docs/).
+
+## Status: reference only — not compiled
+
+These declarations are **not wired into any `tsconfig`**. The packaged `.jsx`
+files under `jsx/` are authored as plain ExtendScript and are not type-checked by
+the build (`tsconfig.json` includes only `src`, `test`, and `jsx/polyfills`).
+
+They are kept here as:
+
+- a reference while hand-writing `.jsx` files, and
+- ready material for a future opt-in JSX type-checking pass (a separate
+  `tsconfig` with `allowJs`/`checkJs` over `jsx/**/*.jsx` that loads these
+  globals).
+
+Because every file uses `declare` (global) declarations, they must **not** be
+added to a `tsconfig` that compiles consumer-facing code — doing so would inject
+`app`, `File`, `RGBColor`, etc. into that project's global scope. To use them
+manually, reference the barrel from a single jsx-authoring `tsconfig`:
+
+```jsonc
+// e.g. a dedicated jsx/tsconfig.json (not created yet)
+{
+  "compilerOptions": { "allowJs": true, "checkJs": true, "noEmit": true },
+  "include": ["**/*.jsx", "types/extendscript/index.d.ts"],
+}
+```
+
+`index.d.ts` is the triple-slash aggregator that pulls in every sibling `.d.ts`.

package/jsx/types/extendscript/actions.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Photoshop Action Manager 类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+// ============================================================
+// ActionDescriptor
+// ============================================================
+
+/**
+ * Action Manager 的核心类，包含键值对的记录，用于定义和存储动作。
+ * 用于 app.executeAction() 和 app.executeActionGet()。
+ */
+declare class ActionDescriptor {
+  /** 描述符中包含的键的数量（只读）*/
+  readonly count: number;
+
+  /** 清空描述符 */
+  clear(): void;
+
+  /** 判断描述符是否包含指定键 */
+  hasKey(key: number): boolean;
+
+  /** 获取键对应的值类型 */
+  getType(key: number): DescValueType;
+
+  // Getter 方法
+  getBoolean(key: number): boolean;
+  getClass(key: number): number;
+  getData(key: number): string;
+  getDouble(key: number): number;
+  getEnumerationType(key: number): number;
+  getEnumerationValue(key: number): number;
+  getInteger(key: number): number;
+  getLargeInteger(key: number): number;
+  getList(key: number): ActionList;
+  getObjectType(key: number): number;
+  getObjectValue(key: number): ActionDescriptor;
+  getPath(key: number): File;
+  getReference(key: number): ActionReference;
+  getString(key: number): string;
+  getUnitDoubleType(key: number): number;
+  getUnitDoubleValue(key: number): number;
+
+  // Setter 方法
+  putBoolean(key: number, value: boolean): void;
+  putClass(key: number, value: number): void;
+  putData(key: number, value: string): void;
+  putDouble(key: number, value: number): void;
+  putEnumerated(key: number, enumType: number, value: number): void;
+  putInteger(key: number, value: number): void;
+  putLargeInteger(key: number, value: number): void;
+  putList(key: number, value: ActionList): void;
+  putObject(key: number, type: number, value: ActionDescriptor): void;
+  putPath(key: number, value: File): void;
+  putReference(key: number, value: ActionReference): void;
+  putString(key: number, value: string): void;
+  putUnitDouble(key: number, unitID: number, value: number): void;
+
+  /** 返回描述符中位置为 index 的键 */
+  getKey(index: number): number;
+
+  /** 将描述符序列化为字符串 */
+  toStream(): string;
+
+  /** 从字符串反序列化描述符 */
+  fromStream(stream: string): void;
+}
+
+// ============================================================
+// ActionList
+// ============================================================
+
+/** Action Manager 的列表容器，存储一系列值。*/
+declare class ActionList {
+  /** 列表中的元素数量（只读）*/
+  readonly count: number;
+
+  /** 获取指定索引的值类型 */
+  getType(index: number): DescValueType;
+
+  // Getter 方法
+  getBoolean(index: number): boolean;
+  getClass(index: number): number;
+  getData(index: number): string;
+  getDouble(index: number): number;
+  getEnumerationType(index: number): number;
+  getEnumerationValue(index: number): number;
+  getInteger(index: number): number;
+  getLargeInteger(index: number): number;
+  getList(index: number): ActionList;
+  getObjectType(index: number): number;
+  getObjectValue(index: number): ActionDescriptor;
+  getPath(index: number): File;
+  getReference(index: number): ActionReference;
+  getString(index: number): string;
+  getUnitDoubleType(index: number): number;
+  getUnitDoubleValue(index: number): number;
+
+  // Putter 方法（附加到末尾）
+  putBoolean(value: boolean): void;
+  putClass(value: number): void;
+  putData(value: string): void;
+  putDouble(value: number): void;
+  putEnumerated(enumType: number, value: number): void;
+  putInteger(value: number): void;
+  putLargeInteger(value: number): void;
+  putList(value: ActionList): void;
+  putObject(type: number, value: ActionDescriptor): void;
+  putPath(value: File): void;
+  putReference(value: ActionReference): void;
+  putString(value: string): void;
+  putUnitDouble(unitID: number, value: number): void;
+}
+
+// ============================================================
+// ActionReference
+// ============================================================
+
+/** Action Manager 的引用对象，用于引用文档中的特定元素。*/
+declare class ActionReference {
+  /** 获取此引用的容器 */
+  getContainer(): ActionReference;
+
+  /** 获取引用表示类型 */
+  getForm(): ReferenceFormType;
+
+  /** 获取引用的实际对象类型 */
+  getDesiredClass(): number;
+
+  // 获取各种类型的引用值
+  getEnumerationType(): number;
+  getEnumerationValue(): number;
+  getIdentifier(): number;
+  getIndex(): number;
+  getName(): string;
+  getOffset(): number;
+  getProperty(): number;
+
+  // 设置各种类型的引用值
+  putClass(value: number): void;
+  putEnumerated(desiredClass: number, enumType: number, value: number): void;
+  putIdentifier(desiredClass: number, value: number): void;
+  putIndex(desiredClass: number, value: number): void;
+  putName(desiredClass: number, value: string): void;
+  putOffset(desiredClass: number, value: number): void;
+  putProperty(desiredClass: number, value: number): void;
+}

package/jsx/types/extendscript/application.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Photoshop Application 类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+declare class Application {
+  activeDocument: Document;
+  backgroundColor: SolidColor;
+  readonly build: string;
+  colorSettings: string;
+  currentTool: string;
+  displayDialogs: DialogModes;
+  readonly documents: Documents;
+  readonly fonts: TextFonts;
+  foregroundColor: SolidColor;
+  readonly freeMemory: number;
+  readonly locale: string;
+  readonly macintoshFileTypes: string[];
+  readonly measurementLog: MeasurementLog;
+  readonly name: string;
+  readonly notifiers: Notifiers;
+  notifiersEnabled: boolean;
+  readonly parent: any;
+  readonly path: File;
+  readonly playbackDisplayDialogs: DialogModes;
+  readonly playbackParameters: ActionDescriptor;
+  readonly preferences: Preferences;
+  readonly preferencesFolder: Folder;
+  readonly recentFiles: File[];
+  readonly scriptingBuildDate: string;
+  readonly scriptingVersion: string;
+  readonly systemInformation: string;
+  readonly typename: string;
+  readonly version: string;
+  readonly windowsFileTypes: string[];
+
+  batch(inputFiles: File[], action: string, from: string, options?: BatchOptions): string;
+  beep(): void;
+  bringToFront(): void;
+  changeProgressText(progressString: string): void;
+  charIDToTypeID(charID: string): number;
+  doAction(action: string, from: string): void;
+  doForcedProgress(taskName: string, func: Function): void;
+  doProgress(progressString: string, func: Function): void;
+  eraseCustomOptions(key: string): void;
+  executeAction(
+    eventID: number,
+    descriptor?: ActionDescriptor,
+    displayDialogs?: DialogModes
+  ): ActionDescriptor;
+  executeActionGet(reference: ActionReference): ActionDescriptor;
+  featureEnabled(name: string): boolean;
+  getCustomOptions(key: string): ActionDescriptor;
+  isQuicktimeAvailable(): boolean;
+  load(document: File): void;
+  makeContactSheet(inputFiles: File[], options?: any): string;
+  makePDFPresentation(inputFiles: File[], outputFile: File, options?: any): string;
+  makePicturePackage(inputFiles?: File[], options?: any): string;
+  open(document: File, openAs?: OpenDocumentType, openOptions?: any): Document;
+  openDialog(): File[];
+  purge(target: PurgeTarget): void;
+  putCustomOptions(key: string, customObject: ActionDescriptor, persistent?: boolean): void;
+  refresh(): void;
+  refreshFonts(): void;
+  runMenuItem(menuID: number): void;
+  showColorPicker(): boolean;
+  stringIDToTypeID(stringID: string): number;
+  system(callString: string): number;
+  togglePalettes(): void;
+  toolSupportsBrushes(tool: string): boolean;
+  typeIDToCharID(typeID: number): string;
+  typeIDToStringID(typeID: number): string;
+  updateProgress(done: number, total: number): void;
+}

package/jsx/types/extendscript/channel.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Photoshop 通道类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+/**
+ * 存储图像颜色元素信息的通道对象。
+ * 文档的颜色模式决定了默认通道的数量。
+ */
+declare class Channel {
+  /** 通道的颜色（对组件通道无效）*/
+  color: SolidColor;
+  /** 通道颜色的直方图（只读）*/
+  readonly histogram: number[];
+  /** 通道的类型（只读）*/
+  readonly kind: ChannelType;
+  /** 通道的名称 */
+  name: string;
+  /**
+   * Alpha 通道的不透明度（对专色通道称为 solidity）。
+   * 范围：0 到 100。仅当类型为 masked area 或 selected area 时有效。
+   */
+  opacity: number;
+  /** 对象的容器（只读）*/
+  readonly parent: Document;
+  /** 对象的类名（只读）*/
+  readonly typename: string;
+  /** 如果为 true，则通道可见 */
+  visible: boolean;
+
+  /**
+   * 复制该通道。
+   * @param targetDocument 目标文档（可选）
+   * @param placement 放置位置（可选）
+   */
+  duplicate(targetDocument?: Document, placement?: ElementPlacement): Channel;
+
+  /** 将专色通道合并到组件通道中 */
+  merge(): void;
+
+  /** 删除此通道 */
+  remove(): void;
+}
+
+/** 通道集合 */
+declare class Channels {
+  /** 通道数量（只读）*/
+  readonly length: number;
+  /** 对象的容器（只读）*/
+  readonly parent: Document;
+  /** 对象的类名（只读）*/
+  readonly typename: string;
+  /** 通过索引访问通道 */
+  [index: number]: Channel;
+
+  /**
+   * 添加一个新通道。
+   * @returns 新创建的通道
+   */
+  add(): Channel;
+
+  /**
+   * 通过名称获取通道。
+   * @param name 通道名称
+   */
+  getByName(name: string): Channel;
+
+  /** 删除所有通道 */
+  removeAll(): void;
+}

package/jsx/types/extendscript/color.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Photoshop 颜色类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+// ============================================================
+// 颜色分量类
+// ============================================================
+
+/** RGB 颜色模型 */
+declare class RGBColor {
+  /** 蓝色通道值。范围：0.0 到 255.0 */
+  blue: number;
+  /** 绿色通道值。范围：0.0 到 255.0 */
+  green: number;
+  /** 十六进制颜色字符串（例如 "ff0000"）*/
+  hexValue: string;
+  /** 红色通道值。范围：0.0 到 255.0 */
+  red: number;
+}
+
+/** CMYK 颜色模型 */
+declare class CMYKColor {
+  /** 黑色（K）通道值。范围：0.0 到 100.0 */
+  black: number;
+  /** 青色通道值。范围：0.0 到 100.0 */
+  cyan: number;
+  /** 品红色通道值。范围：0.0 到 100.0 */
+  magenta: number;
+  /** 黄色通道值。范围：0.0 到 100.0 */
+  yellow: number;
+}
+
+/** HSB 颜色模型 */
+declare class HSBColor {
+  /** 亮度。范围：0.0 到 100.0 */
+  brightness: number;
+  /** 色相。范围：0.0 到 360.0 */
+  hue: number;
+  /** 饱和度。范围：0.0 到 100.0 */
+  saturation: number;
+}
+
+/** Lab 颜色模型 */
+declare class LabColor {
+  /** A 通道值。范围：-128.0 到 127.0 */
+  a: number;
+  /** B 通道值。范围：-128.0 到 127.0 */
+  b: number;
+  /** 亮度（L）值。范围：0.0 到 100.0 */
+  l: number;
+}
+
+/** 灰度颜色模型 */
+declare class GrayColor {
+  /** 灰度值。范围：0.0 到 100.0 */
+  gray: number;
+}
+
+/** 无颜色（透明）*/
+declare class NoColor {}
+
+// ============================================================
+// SolidColor 主颜色类
+// ============================================================
+
+/**
+ * 用于文档中的颜色定义。
+ * 可通过 rgb、cmyk、hsb、lab、gray 属性访问不同颜色模型。
+ */
+declare class SolidColor {
+  /** CMYK 颜色模型 */
+  cmyk: CMYKColor;
+  /** 灰度颜色模型 */
+  gray: GrayColor;
+  /** HSB 颜色模型 */
+  hsb: HSBColor;
+  /** Lab 颜色模型 */
+  lab: LabColor;
+  /** 颜色模型 */
+  model: ColorModel;
+  /** 最接近当前颜色的 Web 安全色（只读）*/
+  readonly nearestWebColor: RGBColor;
+  /** RGB 颜色模型 */
+  rgb: RGBColor;
+
+  /**
+   * 比较两种颜色是否相等。
+   * @param color 要比较的颜色
+   */
+  isEqual(color: SolidColor): boolean;
+}

package/jsx/types/extendscript/document.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Photoshop 文档类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+declare class Document {
+  activeChannels: Channel[];
+  readonly activeHistoryBrushSource: HistoryState;
+  activeHistoryState: HistoryState;
+  activeLayer: ArtLayer | LayerSet;
+  readonly artLayers: ArtLayers;
+  readonly backgroundLayer: ArtLayer;
+  bitsPerChannel: BitsPerChannelType;
+  readonly channels: Channels;
+  colorProfileName: string;
+  colorProfileType: ColorProfileType;
+  readonly colorSamplers: ColorSamplers;
+  readonly componentChannels: Channel[];
+  readonly countItems: CountItems;
+  readonly fullName: File;
+  readonly guides: Guides;
+  readonly height: number;
+  readonly histogram: number[];
+  readonly historyStates: HistoryStates;
+  readonly id: number;
+  readonly info: DocumentInfo;
+  readonly layerComps: LayerComps;
+  readonly layerSets: LayerSets;
+  readonly layers: Layers;
+  readonly managed: boolean;
+  readonly measurementScale: MeasurementScale;
+  readonly mode: DocumentMode;
+  readonly name: string;
+  readonly parent: Application;
+  readonly path: File;
+  readonly pathItems: PathItems;
+  readonly pixelAspectRatio: number;
+  readonly printSettings: DocumentPrintSettings;
+  quickMaskMode: boolean;
+  readonly resolution: number;
+  readonly saved: boolean;
+  readonly selection: Selection;
+  readonly typename: string;
+  readonly width: number;
+  readonly xmpMetadata: XMPMetadata;
+
+  autoCount(channel: Channel, merge: boolean): void;
+  changeMode(destinationMode: ChangeMode, options?: any): void;
+  close(saving?: SaveOptions): void;
+  convertProfile(
+    destinationProfile: string,
+    intent: Intent,
+    blackPointCompensation?: boolean,
+    dither?: boolean
+  ): void;
+  crop(bounds: Rectangle, angle?: number, width?: number, height?: number): void;
+  duplicate(name?: string, mergeLayersOnly?: boolean): Document;
+  exportDocument(exportIn: File, exportAs?: ExportType, options?: ExportOptions): void;
+  flatten(): void;
+  flipCanvas(direction: Direction): void;
+  importAnnotations(from: File): void;
+  mergeVisibleLayers(): void;
+  paste(intoSelection?: boolean): ArtLayer;
+  print(
+    sourceSpace?: SourceSpaceType,
+    printSpace?: string,
+    intent?: Intent,
+    blackPointCompensation?: boolean
+  ): void;
+  printOneCopy(): void;
+  rasterizeAllLayers(): void;
+  recordMeasurements(selection?: MeasurementSource, dataPoints?: string[]): void;
+  resizeCanvas(width: number, height: number, anchor?: AnchorPosition): void;
+  resizeImage(
+    width?: number,
+    height?: number,
+    resolution?: number,
+    resampleImage?: ResampleMethod,
+    amount?: number
+  ): void;
+  revealAll(): void;
+  rotateCanvas(angle: number): void;
+  save(): void;
+  saveAs(saveIn: File, options?: any, asCopy?: boolean, extensionType?: MacExtensionType): void;
+  splitChannels(): Document[];
+  suspendHistory(historyString: string, javaScriptString: string): void;
+  trap(width: number): void;
+  trim(type?: TrimType, top?: boolean, left?: boolean, bottom?: boolean, right?: boolean): void;
+}
+
+/** 打开文档的集合 */
+declare class Documents {
+  readonly length: number;
+  readonly parent: Application;
+  readonly typename: string;
+  [index: number]: Document;
+
+  add(
+    width?: number,
+    height?: number,
+    resolution?: number,
+    name?: string,
+    mode?: NewDocumentMode,
+    initialFill?: DocumentFill,
+    pixelAspectRatio?: number,
+    bitsPerChannel?: BitsPerChannelType,
+    colorProfileName?: string
+  ): Document;
+  getByName(name: string): Document;
+}