@ps-generator-bridge/generator 0.1.0

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

@@ -0,0 +1,191 @@
+/**
+ * Photoshop 选区类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+/**
+ * 文档或图层中的选定区域。
+ * 通过 Document.selection 属性访问。
+ */
+declare class Selection {
+  /** 整个选区的边界矩形（只读）*/
+  readonly bounds: [number, number, number, number];
+  /** 对象的容器（只读）*/
+  readonly parent: Document;
+  /** 如果为 true，则边界矩形为实心矩形（只读）*/
+  readonly solid: boolean;
+  /** 对象的类名（只读）*/
+  readonly typename: string;
+
+  /** 清除选区（不复制到剪贴板）*/
+  clear(): void;
+
+  /**
+   * 收缩选区。
+   * @param by 收缩量（像素）
+   */
+  contract(by: number): void;
+
+  /**
+   * 将选区复制到剪贴板。
+   * @param merged 是否复制所有可见图层（可选）
+   */
+  copy(merged?: boolean): void;
+
+  /** 将当前选区剪切到剪贴板 */
+  cut(): void;
+
+  /** 取消选择当前选区 */
+  deselect(): void;
+
+  /**
+   * 扩大选区。
+   * @param by 扩大量（像素）
+   */
+  expand(by: number): void;
+
+  /**
+   * 羽化选区的边缘。
+   * @param by 羽化量（像素）
+   */
+  feather(by: number): void;
+
+  /**
+   * 填充选区。
+   * @param fillType 填充类型（颜色、内容识别等）
+   * @param mode 混合模式（可选）
+   * @param opacity 不透明度（可选）
+   * @param preserveTransparency 是否保留透明度（可选）
+   */
+  fill(
+    fillType: SolidColor | DocumentFill,
+    mode?: BlendMode,
+    opacity?: number,
+    preserveTransparency?: boolean
+  ): void;
+
+  /**
+   * 增大选区以包含所有落在指定容差范围内的相邻像素。
+   * @param tolerance 容差值（0-255）
+   * @param antiAlias 是否使用消除锯齿（可选）
+   */
+  grow(tolerance: number, antiAlias?: boolean): void;
+
+  /** 反转选区 */
+  invert(): void;
+
+  /**
+   * 从指定通道加载选区。
+   * @param from 包含选区的文档
+   * @param channel 要从中加载选区的通道
+   * @param inverting 是否反转通道的选区（可选）
+   */
+  load(from: Document, channel: Channel, inverting?: boolean): void;
+
+  /**
+   * 将此选区项作为此文档的工作路径。
+   * @param tolerance 容差值（可选）
+   */
+  makeWorkPath(tolerance?: number): void;
+
+  /**
+   * 将选定区域调整大小到指定的尺寸和锚点位置。
+   * @param horizontal 水平缩放（百分比）
+   * @param vertical 垂直缩放（百分比）
+   * @param anchor 锚点位置（可选）
+   */
+  resize(horizontal?: number, vertical?: number, anchor?: AnchorPosition): void;
+
+  /**
+   * 缩放选区的边界（不缩放内容）。
+   * @param horizontal 水平缩放（百分比）
+   * @param vertical 垂直缩放（百分比）
+   * @param anchor 锚点位置（可选）
+   */
+  resizeBoundary(horizontal?: number, vertical?: number, anchor?: AnchorPosition): void;
+
+  /**
+   * 旋转对象。
+   * @param angle 旋转角度（度）
+   * @param anchor 锚点位置（可选）
+   */
+  rotate(angle: number, anchor?: AnchorPosition): void;
+
+  /**
+   * 旋转选区的边界（不旋转内容）。
+   * @param angle 旋转角度（度）
+   * @param anchor 锚点位置（可选）
+   */
+  rotateBoundary(angle: number, anchor?: AnchorPosition): void;
+
+  /**
+   * 选择指定的区域。
+   * @param region 定义选区的坐标数组（[左, 上, 右, 下] 或多边形点数组）
+   * @param type 选区操作类型（可选）
+   * @param feather 羽化量（可选）
+   * @param antiAlias 是否消除锯齿（可选）
+   */
+  select(region: number[][], type?: SelectionType, feather?: number, antiAlias?: boolean): void;
+
+  /** 选择整个图层 */
+  selectAll(): void;
+
+  /**
+   * 仅选择选区边框（在指定宽度内）。
+   * @param width 边框宽度（像素）
+   */
+  selectBorder(width: number): void;
+
+  /**
+   * 增大选区以包含图像中所有落在容差范围内的像素。
+   * @param tolerance 容差值（0-255）
+   * @param antiAlias 是否使用消除锯齿（可选）
+   */
+  similar(tolerance: number, antiAlias?: boolean): void;
+
+  /**
+   * 清理基于颜色的选区内部或外部残留的像素。
+   * @param radius 半径（像素）
+   */
+  smooth(radius: number): void;
+
+  /**
+   * 将选区保存为通道。
+   * @param into 目标文档
+   * @param channel 目标通道（可选，若不提供则创建新通道）
+   * @param replacing 是否替换已有通道（可选）
+   */
+  store(into: Document, channel?: Channel, replacing?: SelectionType): void;
+
+  /**
+   * 描边选区。
+   * @param strokeColor 描边颜色
+   * @param width 描边宽度（像素）
+   * @param location 描边位置（可选）
+   * @param mode 混合模式（可选）
+   * @param opacity 不透明度（可选）
+   * @param preserveTransparency 是否保留透明度（可选）
+   */
+  stroke(
+    strokeColor: SolidColor,
+    width: number,
+    location?: StrokeLocation,
+    mode?: BlendMode,
+    opacity?: number,
+    preserveTransparency?: boolean
+  ): void;
+
+  /**
+   * 相对于当前位置移动对象。
+   * @param deltaX 水平移动量
+   * @param deltaY 垂直移动量
+   */
+  translate(deltaX?: number, deltaY?: number): void;
+
+  /**
+   * 相对于当前位置移动选区边界（不移动内容）。
+   * @param deltaX 水平移动量
+   * @param deltaY 垂直移动量
+   */
+  translateBoundary(deltaX?: number, deltaY?: number): void;
+}

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

@@ -0,0 +1,169 @@
+/**
+ * Photoshop 文字类型声明
+ * 来源: https://theiviaxx.github.io/photoshop-docs/Photoshop/
+ */
+
+/** 字体对象 */
+declare class TextFont {
+  /** 字体系列名称（只读）*/
+  readonly family: string;
+  /** 字体名称（只读）*/
+  readonly name: string;
+  /** 对象的容器（只读）*/
+  readonly parent: Application;
+  /** 是否为固定宽度字体（只读）*/
+  readonly postScriptName: string;
+  /** 字体样式（只读）*/
+  readonly style: string;
+  /** 对象的类名（只读）*/
+  readonly typename: string;
+}
+
+/** 字体集合 */
+declare class TextFonts {
+  /** 字体数量（只读）*/
+  readonly length: number;
+  /** 对象的容器（只读）*/
+  readonly parent: Application;
+  /** 对象的类名（只读）*/
+  readonly typename: string;
+  /** 通过索引访问字体 */
+  [index: number]: TextFont;
+
+  /**
+   * 通过名称获取字体。
+   * @param name 字体名称
+   */
+  getByName(name: string): TextFont;
+}
+
+/**
+ * 包含在 ArtLayer 中的文本对象。
+ * 仅当图层的 kind 为文字图层时有效。
+ */
+declare class TextItem {
+  /** 如果为 true，使用替代连字 */
+  alternateLigatures: boolean;
+  /** 使用的抗锯齿方法 */
+  antiAliasMethod: AntiAlias;
+  /** 自动字距调整选项 */
+  autoKerning: AutoKernType;
+  /** 用于自动行距的百分比。范围：0.01 到 5000.00 */
+  autoLeadingAmount: number;
+  /** 文本的基线偏移量 */
+  baselineShift: number;
+  /** 文本的大小写格式 */
+  capitalization: Case;
+  /** 文本颜色 */
+  color: SolidColor;
+  /** 图层中的实际文本内容 */
+  contents: string;
+  /** 期望字形缩放百分比。范围：50 - 200（仅两端对齐有效）*/
+  desiredGlyphScaling: number;
+  /** 期望字母间距百分比。范围：100 - 500（仅两端对齐有效）*/
+  desiredLetterScaling: number;
+  /** 期望单词间距百分比。范围：0 - 1000（仅两端对齐有效）*/
+  desiredWordScaling: number;
+  /** 文本方向 */
+  direction: Direction;
+  /** 如果为 true，使用伪粗体 */
+  fauxBold: boolean;
+  /** 如果为 true，使用伪斜体 */
+  fauxItalic: boolean;
+  /** 段落首行缩进量。范围：-1296 到 1296 */
+  firstLineIndent: number;
+  /** 字符的字体名称 */
+  font: string;
+  /** 如果为 true，使用罗马式悬挂标点 */
+  hangingPuntuation: boolean;
+  /** 段落文本边界框的高度 */
+  height: number;
+  /** 字符水平缩放。范围：0 - 1000（百分比）*/
+  horizontalScale: number;
+  /** 允许换行断字的最少字母数。范围：1 到 15 */
+  hyphenateAfterFirst: number;
+  /** 允许换行断字前的最多字母数。范围：1 到 15 */
+  hyphenateBeforeLast: number;
+  /** 如果为 true，大写单词可以断字 */
+  hyphenateCapitalWords: boolean;
+  /** 允许换行断字的最少字母数。范围：2 到 25 */
+  hyphenateWordsLongerThan: number;
+  /** 如果为 true，使用断字 */
+  hyphenation: boolean;
+  /** 行末导致断字的距离。范围：0 - 720 派卡 */
+  hyphenationZone: number;
+  /** 连续以连字符结尾的最大行数 */
+  hyphenLimit: number;
+  /** 段落对齐方式 */
+  justification: Justification;
+  /** 文本类型（点文字/区域文字）*/
+  kind: TextType;
+  /** 语言 */
+  language: Language;
+  /** 行距量 */
+  leading: number;
+  /** 文本左侧缩进量。范围：-1296 到 1296 */
+  leftIndent: number;
+  /** 如果为 true，使用连字 */
+  ligatures: boolean;
+  /** 最大字形缩放百分比。范围：50 - 200 */
+  maximumGlyphScaling: number;
+  /** 最大字母间距百分比。范围：100 - 500 */
+  maximumLetterScaling: number;
+  /** 最大单词间距百分比。范围：0 - 1000 */
+  maximumWordScaling: number;
+  /** 最小字形缩放百分比。范围：50 - 200 */
+  minimumGlyphScaling: number;
+  /** 最小字母间距百分比。范围：100 - 500 */
+  minimumLetterScaling: number;
+  /** 最小单词间距百分比。范围：0 - 1000 */
+  minimumWordScaling: number;
+  /** 如果为 true，禁止在行尾断词 */
+  noBreak: boolean;
+  /** 如果为 true，使用旧式风格 */
+  oldStyle: boolean;
+  /** 对象的容器（只读）*/
+  readonly parent: ArtLayer;
+  /** 文本原点的位置 [x, y] */
+  position: [number, number];
+  /** 文本右侧缩进量。范围：-1296 到 1296 */
+  rightIndent: number;
+  /** 字体大小（点）*/
+  size: number;
+  /** 每个段落后的间距量。范围：-1296 到 1296 */
+  spaceAfter: number;
+  /** 每个段落前的间距量。范围：-1296 到 1296 */
+  spaceBefore: number;
+  /** 删除线选项 */
+  strikeThru: StrikeThruType;
+  /** 使用的文本排版引擎 */
+  textComposer: TextComposer;
+  /** 多个字符之间的均匀间距量。范围：-1000 到 10000 */
+  tracking: number;
+  /** 对象的类名（只读）*/
+  readonly typename: string;
+  /** 下划线选项 */
+  underline: UnderlineType;
+  /** 如果为 true，使用字体内置的行距信息 */
+  useAutoLeading: boolean;
+  /** 字符垂直缩放。范围：0 - 1000（百分比）*/
+  verticalScale: number;
+  /** 变形弯曲百分比。范围：-100 到 100 */
+  warpBend: number;
+  /** 变形方向 */
+  warpDirection: Direction;
+  /** 变形水平扭曲百分比。范围：-100 到 100 */
+  warpHorizontalDistortion: number;
+  /** 变形样式 */
+  warpStyle: WarpStyle;
+  /** 变形垂直扭曲百分比。范围：-100 到 100 */
+  warpVerticalDistortion: number;
+  /** 段落文本边界框的宽度 */
+  width: number;
+
+  /** 将文本对象及其包含的图层转换为填充图层，文本更改为剪切路径 */
+  convertToShape(): void;
+
+  /** 从实际文本项的轮廓创建剪切路径 */
+  createPath(): void;
+}

package/main.js

@@ -0,0 +1,16 @@
+/*
+ * CJS plugin entry — the file generator-core `require`s (package.json "main").
+ * This is the only boundary between the CommonJS world and the bundled plugin
+ * code. Its jobs, in order:
+ *   1. set PS_BRIDGE_LOG_DIR before the bundle is required (in case a file sink reads it),
+ *   2. require the tsup bundle and re-export its `init` for generator-core.
+ */
+"use strict";
+
+var path = require("path");
+
+if (!process.env.PS_BRIDGE_LOG_DIR) {
+  process.env.PS_BRIDGE_LOG_DIR = path.join(__dirname, "logs");
+}
+
+module.exports = require("./dist/index.js");

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@ps-generator-bridge/generator",
+  "version": "0.1.0",
+  "description": "PS Generator Bridge — Photoshop Generator plugin + WebSocket service (runs in PS's bundled Node)",
+  "license": "MIT",
+  "author": "wojzj57",
+  "homepage": "https://github.com/wojzj57/ps-generator-bridge-service#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wojzj57/ps-generator-bridge-service.git",
+    "directory": "packages/generator"
+  },
+  "bugs": {
+    "url": "https://github.com/wojzj57/ps-generator-bridge-service/issues"
+  },
+  "keywords": [
+    "photoshop",
+    "generator",
+    "websocket",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "main.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./main.js",
+      "default": "./main.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "require": "./dist/contract.js",
+      "default": "./dist/contract.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "main.js",
+    "dist",
+    "jsx",
+    "plugins",
+    "README.md"
+  ],
+  "generator-core-version": ">=1.0.0",
+  "dependencies": {
+    "@fastify/websocket": "^10.0.1",
+    "cos-nodejs-sdk-v5": "^2.15.4",
+    "fastify": "^4.29.1",
+    "sharp": "^0.35.2",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.5",
+    "@types/ws": "^8.5.12",
+    "@vitest/coverage-v8": "^2.1.9",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9",
+    "@ps-generator-bridge/sdk": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "dev": "tsx test/devServer.ts",
+    "clean": "rimraf dist logs coverage *.tsbuildinfo"
+  }
+}