[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A7B0SHKKMSR1FVCVHNG75F":3,"skill-same:01M7A7B0SHKKMSR1FVCVHNG75F":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M7A7B0SHKKMSR1FVCVHNG75F","photopea-embedded-editor",null,"Embed Photopea in web apps using photopea.js. Covers embedding, file I\u002FO, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.","MHassan0000\u002FSkills","MHassan0000","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F224296448?v=4","01M7A14DTC1EZCRN04582533RD","Muhammad Hassan Yousaf","01M7A14DV10KTW8NHQTJPD08X0",1,"MIT","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fantigravity skills\u002Fagentic-awesome-skills\u002Fskills\u002Fphotopea-embedded-editor\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: photopea-embedded-editor\ndescription: Embed Photopea in web apps using photopea.js. Covers embedding, file I\u002FO, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.\nrisk: safe\nsource: community\nsource_repo: yikuansun\u002FPhotopeaAPI\nsource_type: community\nlicense: MIT\nlicense_source: \"https:\u002F\u002Fgithub.com\u002Fyikuansun\u002FPhotopeaAPI\u002Fblob\u002Fmaster\u002FLICENSE\"\ndate_added: 2026-05-20\n---\n\n# Photopea Embedded Editor Skill\n## Using photopea.js (yikuansun\u002FPhotopeaAPI) in Websites & Apps\n\n---\n\n## When to Use This Skill\n\nUse this skill for **every task** that involves:\n- Embedding Photopea as an image editor inside a webpage or web app\n- Controlling an embedded Photopea instance from your JavaScript code\n- Automating image editing workflows from a host page (open files, run scripts, export results)\n- Building an image editing feature into your product using Photopea as the engine\n- Writing scripts to manipulate documents, layers, text, selections, filters, colors, and paths\n\n**Do NOT** use raw `postMessage` wiring — always use `photopea.js` as the wrapper.\n\n---\n\n## Library: photopea.js\n\n`photopea.js` is a Promises-based JavaScript wrapper around the Photopea Live Messaging API.\nRepository: https:\u002F\u002Fgithub.com\u002Fyikuansun\u002FPhotopeaAPI\nnpm package: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fphotopea\n\n### Installation\n\n**CDN (no build step)**\n```html\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fphotopea@1.1.1\u002Fdist\u002Fphotopea.min.js\">\u003C\u002Fscript>\n```\n\n**Self-hosted**\n```html\n\u003Cscript src=\".\u002Fphotopea.min.js\">\u003C\u002Fscript>\n```\n\n**npm (Webpack \u002F Vite \u002F Rollup)**\n```bash\nnpm install photopea\n```\n```js\nimport Photopea from \"photopea\";\n```\n\n---\n\n## Core API: The `Photopea` Class\n\n| Method | Description |\n|--------|-------------|\n| `Photopea.createEmbed(container)` | Creates + injects the iframe, resolves when ready |\n| `new Photopea(window.parent)` | Plugin mode: wrap the parent window |\n| `pea.runScript(script)` | Run JS string inside Photopea; returns output array |\n| `pea.loadAsset(arrayBuffer)` | Load binary file (image, font, brush, etc.) |\n| `pea.openFromURL(url, asSmart)` | Open remote URL as new doc or smart object layer |\n| `pea.exportImage(type)` | Export current doc; returns `Blob` (`\"png\"` or `\"jpg\"`) |\n\nAll methods return Promises — always `await` or `.then()`.\n\n---\n\n## Step 1 — Embed\n\nThe container `\u003Cdiv>` **must** have a fixed width and height before calling `createEmbed`.\n\n```html\n\u003Cdiv id=\"editor\" style=\"width:1000px; height:650px;\">\u003C\u002Fdiv>\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fphotopea@1.1.1\u002Fdist\u002Fphotopea.min.js\">\u003C\u002Fscript>\n\u003Cscript>\n  Photopea.createEmbed(document.getElementById(\"editor\")).then(async (pea) => {\n    \u002F\u002F pea is ready\n  });\n\u003C\u002Fscript>\n```\n\n**React:**\n```jsx\nimport { useEffect, useRef } from \"react\";\nimport Photopea from \"photopea\";\n\nexport default function Editor() {\n  const containerRef = useRef(null);\n  const peaRef       = useRef(null);\n\n  useEffect(() => {\n    if (!containerRef.current || peaRef.current) return;\n    Photopea.createEmbed(containerRef.current).then((pea) => {\n      peaRef.current = pea;\n    });\n  }, []);\n\n  return \u003Cdiv ref={containerRef} style={{ width: \"100%\", height: \"650px\" }} \u002F>;\n}\n```\n\n---\n\n## Step 2 — Opening Files\n\n```js\n\u002F\u002F Remote URL → new document\nawait pea.openFromURL(\"https:\u002F\u002Fexample.com\u002Fdesign.psd\", false);\n\n\u002F\u002F Remote URL → smart object layer inside current document\nawait pea.openFromURL(\"https:\u002F\u002Fexample.com\u002Foverlay.png\", true);\n\n\u002F\u002F Local file (user input → ArrayBuffer → loadAsset)\ndocument.getElementById(\"fileInput\").addEventListener(\"change\", async (e) => {\n  const buf = await e.target.files[0].arrayBuffer();\n  await pea.loadAsset(buf);\n});\n\n\u002F\u002F Base64 data URI via runScript\nawait pea.runScript(`app.open(\"data:image\u002Fpng;base64,iVBORw0...\");`);\n```\n\n---\n\n## Step 3 — Running Scripts\n\n`runScript` sends a JS string, returns an array of `app.echoToOE(...)` values + `\"done\"` last.\n\n```js\nconst result = await pea.runScript(`app.echoToOE(\"hello\");`);\n\u002F\u002F result → [\"hello\", \"done\"]\n\n\u002F\u002F Return structured data\nconst out = await pea.runScript(`\n  app.echoToOE(JSON.stringify({\n    width:  app.activeDocument.width,\n    height: app.activeDocument.height,\n    layers: app.activeDocument.layers.length\n  }));\n`);\nconst info = JSON.parse(out[0]);\n```\n\n---\n\n## Step 4 — Exporting\n\n```js\n\u002F\u002F PNG Blob (via exportImage)\nconst blob = await pea.exportImage(\"png\");\ndocument.getElementById(\"preview\").src = URL.createObjectURL(blob);\n\n\u002F\u002F JPEG Blob\nconst blob = await pea.exportImage(\"jpg\");\n\n\u002F\u002F WebP \u002F PSD \u002F quality-controlled JPEG via saveToOE\nconst result = await pea.runScript(`app.activeDocument.saveToOE(\"webp:0.85\");`);\nconst webpBlob = new Blob([result[0]], { type: \"image\u002Fwebp\" });\n\nconst result = await pea.runScript(`app.activeDocument.saveToOE(\"psd:true\");`);\nconst psdBlob  = new Blob([result[0]], { type: \"application\u002Foctet-stream\" });\n\n\u002F\u002F Trigger download\nasync function download(pea, filename = \"export.png\") {\n  const blob = await pea.exportImage(\"png\");\n  const a    = Object.assign(document.createElement(\"a\"), {\n    href:     URL.createObjectURL(blob),\n    download: filename\n  });\n  a.click();\n}\n```\n\n**Export format strings for `saveToOE`:**\n\n| String | Format |\n|--------|--------|\n| `\"png\"` | PNG lossless |\n| `\"jpg\"` | JPEG default |\n| `\"jpg:0.8\"` | JPEG quality 0.0–1.0 |\n| `\"webp:0.7\"` | WebP quality 0.0–1.0 |\n| `\"psd\"` | Full PSD |\n| `\"psd:true\"` | Minified PSD |\n| `\"svg:true\"` | SVG |\n\n---\n\n## Step 5 — Loading Assets\n\n```js\n\u002F\u002F Font\nconst buf = await (await fetch(\"https:\u002F\u002Fexample.com\u002FMyFont.otf\")).arrayBuffer();\nawait pea.loadAsset(buf);\n\u002F\u002F Now usable in textItem.font\n\n\u002F\u002F Brush\nawait pea.loadAsset(await (await fetch(\"Nature.ABR\")).arrayBuffer());\n\n\u002F\u002F Gradient\nawait pea.loadAsset(await (await fetch(\"Gradients.GRD\")).arrayBuffer());\n```\n\n---\n\n## Step 6 — Plugin Mode\n\n```js\n\u002F\u002F Your page is inside Photopea's sidebar iframe\nconst pea = new Photopea(window.parent);\n\nconst out = await pea.runScript(`app.echoToOE(app.activeDocument.width);`);\nconsole.log(\"Width:\", out[0]);\n\n\u002F\u002F Load an asset from your plugin\nconst buf = await (await fetch(\"https:\u002F\u002Fmy-assets.com\u002Fsticker.png\")).arrayBuffer();\nawait pea.loadAsset(buf);\n```\n\nPlugin config:\n```json\n{\n  \"environment\": {\n    \"plugins\": [{\n      \"name\": \"My Plugin\",\n      \"url\":  \"https:\u002F\u002Fmy-plugin.example.com\",\n      \"icon\": \"===https:\u002F\u002Fmy-plugin.example.com\u002Ficon.png\"\n    }]\n  }\n}\n```\n\n---\n\n## Utility Patterns\n\n### addImageAndWait — robust async layer insertion\n```js\nasync function addImageAndWait(pea, imgURI) {\n  let count = \"done\";\n  while (count === \"done\")\n    count = (await pea.runScript(`app.echoToOE(app.activeDocument.layers.length)`))[0];\n  count = parseInt(count);\n\n  const imageUrlLiteral = JSON.stringify(imgURI);\n  await pea.runScript(`app.open(${imageUrlLiteral}, null, true);`);\n\n  return new Promise((resolve) => {\n    const check = async () => {\n      const n = parseInt((await pea.runScript(\n        `app.echoToOE(app.activeDocument.layers.length)`\n      ))[0]);\n      n === count + 1 ? resolve() : setTimeout(check, 50);\n    };\n    check();\n  });\n}\n```\n\n### getDocumentAsImage — returns `\u003Cimg>` element\n```js\nasync function getDocumentAsImage(pea) {\n  const result = await pea.runScript(`app.activeDocument.saveToOE('png')`);\n  return new Promise((resolve) => {\n    const fr = new FileReader();\n    fr.addEventListener(\"load\", (e) => {\n      const img = new Image(); img.src = e.target.result; resolve(img);\n    });\n    fr.readAsDataURL(new Blob([result[0]], { type: \"image\u002Fpng\" }));\n  });\n}\n```\n\n---\n\n## Real-World Patterns\n\n### Pattern A — Open + Export UI\n```html\n\u003Cinput type=\"file\" id=\"fileInput\" accept=\"image\u002F*,.psd\">\n\u003Cbutton id=\"exportBtn\">Export PNG\u003C\u002Fbutton>\n\u003Cdiv id=\"editor\" style=\"width:100%;height:600px;\">\u003C\u002Fdiv>\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fphotopea@1.1.1\u002Fdist\u002Fphotopea.min.js\">\u003C\u002Fscript>\n\u003Cscript>\nlet pea;\nPhotopea.createEmbed(document.getElementById(\"editor\")).then(p => pea = p);\n\ndocument.getElementById(\"fileInput\").addEventListener(\"change\", async e => {\n  await pea.loadAsset(await e.target.files[0].arrayBuffer());\n});\ndocument.getElementById(\"exportBtn\").addEventListener(\"click\", async () => {\n  const blob = await pea.exportImage(\"png\");\n  const a = Object.assign(document.createElement(\"a\"), {\n    href: URL.createObjectURL(blob), download: \"export.png\"\n  });\n  a.click();\n});\n\u003C\u002Fscript>\n```\n\n### Pattern B — Template + Text Edit + Export\n```js\nasync function generateCard(pea, name, tagline) {\n  await pea.openFromURL(\"https:\u002F\u002Fexample.com\u002Fcard.psd\", false);\n  const nameLiteral = JSON.stringify(name);\n  const taglineLiteral = JSON.stringify(tagline);\n  await pea.runScript(`\n    app.activeDocument.layers.getByName(\"Name\").textItem.contents    = ${nameLiteral};\n    app.activeDocument.layers.getByName(\"Tagline\").textItem.contents = ${taglineLiteral};\n  `);\n  return await pea.exportImage(\"png\");\n}\n```\n\n### Pattern C — Batch Watermark\n```js\nasync function batchWatermark(pea, imageURLs, watermarkURL) {\n  const results = [];\n  for (const url of imageURLs) {\n    await pea.openFromURL(url, false);\n    await pea.openFromURL(watermarkURL, true);\n    await pea.runScript(`\n      var doc = app.activeDocument, wm = doc.activeLayer;\n      wm.translate(doc.width - wm.bounds[2] - 20, doc.height - wm.bounds[3] - 20);\n      wm.opacity = 70;\n    `);\n    results.push(await pea.exportImage(\"png\"));\n    await pea.runScript(`app.activeDocument.close(SaveOptions.DONOTSAVECHANGES);`);\n  }\n  return results;\n}\n```\n\n---\n\n# FULL SCRIPTING API REFERENCE\n\n> All code in this section runs **inside `pea.runScript(\"...\")`** strings.\n> Photopea implements the Adobe Photoshop CC 2015 JavaScript scripting interface.\n> Any Photoshop script targeting that version should work in Photopea.\n\n---\n\n## `app` — Application Object\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `app.activeDocument` | Document | R\u002FW | The currently active document |\n| `app.documents` | Documents | R | Collection of all open documents |\n| `app.documents.length` | number | R | Count of open documents |\n| `app.documents[i]` | Document | R | Access by zero-based index |\n| `app.foregroundColor` | SolidColor | R\u002FW | Current foreground color |\n| `app.backgroundColor` | SolidColor | R\u002FW | Current background color |\n| `app.preferences.rulerUnits` | Units | R\u002FW | `Units.PIXELS`, `Units.CM`, `Units.INCHES`, `Units.MM`, `Units.PICAS`, `Units.POINTS`, `Units.PERCENT` |\n| `app.preferences.typeUnits` | TypeUnits | R\u002FW | `TypeUnits.PIXELS`, `TypeUnits.MM`, `TypeUnits.POINTS` |\n| `app.displayDialogs` | DialogModes | R\u002FW | `DialogModes.NO`, `DialogModes.ALL`, `DialogModes.ERROR` |\n\n### Methods\n\n| Method | Description |\n|--------|-------------|\n| `app.open(url)` | Open URL as new document |\n| `app.open(url, null, true)` | Open URL as smart object layer in active document |\n| `app.echoToOE(string)` | **Photopea extension** — send string to host page (captured by `runScript`) |\n| `app.showWindow(\"magiccut\")` | **Photopea extension** — open Magic Cut panel |\n| `app.showWindow(\"vbitmap\")` | **Photopea extension** — open Vectorize Bitmap panel |\n| `app.UI.zoomIn()` | Zoom in |\n| `app.UI.zoomOut()` | Zoom out |\n| `app.UI.fitTheArea()` | Fit canvas to viewport |\n| `app.UI.pixelToPixel()` | 100% zoom |\n| `app.UI.switchFullscreen()` | Toggle fullscreen |\n| `app.UI.scroll(dx, dy)` | Scroll by delta |\n| `app.UI.scrollTo(x, y)` | Scroll to absolute position |\n\n**Important:** Always set ruler units to pixels at the start of any script that uses pixel measurements:\n```js\nvar savedUnits = app.preferences.rulerUnits;\napp.preferences.rulerUnits = Units.PIXELS;\n\u002F\u002F ... your code ...\napp.preferences.rulerUnits = savedUnits;\n```\n\n---\n\n## `Document` — Document Object\n\nAccess via `app.activeDocument` or `app.documents[i]`.\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `width` | number | R | Document width in current ruler units |\n| `height` | number | R | Document height in current ruler units |\n| `resolution` | number | R | DPI (pixels per inch) |\n| `name` | string | **R\u002FW** | **Photopea extension** — display label (no history step) |\n| `source` | string | **R\u002FW** | **Photopea extension** — file origin URL or `\"local,X,NAME\"` |\n| `mode` | DocumentMode | R | `DocumentMode.RGB`, `GRAYSCALE`, `CMYK`, `LAB`, `BITMAP`, `INDEXEDCOLOR`, `MULTICHANNEL` |\n| `bitsPerChannel` | BitsPerChannelType | R | `BitsPerChannelType.EIGHT`, `SIXTEEN`, `THIRTYTWO` |\n| `colorProfileName` | string | R | Name of embedded color profile |\n| `activeLayer` | Layer\u002FArtLayer\u002FLayerSet | R\u002FW | Set to activate a layer |\n| `currentLayer` | ArtLayer | R\u002FW | Alias for `activeLayer` |\n| `layers` | Layers | R | All top-level layers (both art + group) |\n| `artLayers` | ArtLayers | R | All top-level art layers only |\n| `layerSets` | LayerSets | R | All top-level group layers only |\n| `selection` | Selection | R | The current selection |\n| `channels` | Channels | R | All channels |\n| `historyStates` | HistoryStates | R | Undo history |\n| `activeHistoryState` | HistoryState | R\u002FW | Current history position |\n| `layerComps` | LayerComps | R | Layer comps collection |\n| `guides` | Guides | R | Guides collection |\n| `pathItems` | PathItems | R | Vector paths |\n| `id` | number | R | Unique document ID |\n| `saved` | boolean | R | Whether document has unsaved changes |\n| `quickMaskMode` | boolean | R | Whether in Quick Mask mode |\n| `backgroundLayer` | ArtLayer | R | The background layer |\n| `pixelAspectRatio` | number | R | Custom pixel aspect ratio (0.1–10.0) |\n| `histogram` | array | R | 256-element histogram array |\n\n### Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `resizeImage` | `(w, h, res, resampleMethod)` | Resize image pixels. ResampleMethod: `BICUBIC`, `BILINEAR`, `NEARESTNEIGHBOR`, `NONE`, `BICUBICSHARPER`, `BICUBICSMOOTHER` |\n| `resizeCanvas` | `(w, h, anchor)` | Resize canvas without scaling. AnchorPosition: `TOPLEFT`, `TOPCENTER`, `TOPRIGHT`, `MIDDLELEFT`, `MIDDLECENTER`, `MIDDLERIGHT`, `BOTTOMLEFT`, `BOTTOMCENTER`, `BOTTOMRIGHT` |\n| `rotateCanvas` | `(degrees)` | Rotate entire canvas. Positive = clockwise |\n| `flipCanvas` | `(direction)` | `Direction.HORIZONTAL` or `Direction.VERTICAL` |\n| `crop` | `([x1,y1,x2,y2], angle, w, h)` | Crop canvas. Angle and dimensions are optional |\n| `trim` | `(trimType, top, left, bottom, right)` | Trim transparent\u002Fbackground-color borders. TrimType: `TRANSPARENT`, `TOPLEFT`, `BOTTOMRIGHT` |\n| `revealAll` | `()` | Expand canvas to show clipped content |\n| `flatten` | `()` | Merge all layers into one |\n| `mergeVisibleLayers` | `()` | Merge all visible layers |\n| `rasterizeAllLayers` | `()` | Rasterize all vector\u002Ftext layers |\n| `changeMode` | `(mode, options)` | Convert color mode (e.g., `ChangeMode.GRAYSCALE`) |\n| `convertProfile` | `(profileName, renderingIntent, blackPointCompensation, dither)` | Convert color profile |\n| `duplicate` | `(name, mergedLayers)` | Duplicate the document |\n| `close` | `(saveOptions)` | Close document. SaveOptions: `DONOTSAVECHANGES`, `SAVECHANGES`, `PROMPTTOSAVECHANGES` |\n| `save` | `()` | Save (requires server config in embed) |\n| `saveToOE` | `(format)` | **Photopea extension** — send binary to host. Formats: `\"png\"`, `\"jpg:0.8\"`, `\"webp:0.7\"`, `\"psd:true\"`, `\"svg:true\"` |\n| `clearHistory` | `()` | **Photopea extension** — clear undo history to free RAM |\n| `exportDocument` | `(file, exportType, options)` | Export to filesystem (triggers ZIP). ExportType: `SAVEFORWEB` |\n| `paste` | `(intoSelection)` | Paste clipboard into document |\n| `suspendHistory` | `(historyName, callback)` | Wrap multiple ops in one history state |\n\n**Practical examples:**\n```js\nvar doc = app.activeDocument;\n\n\u002F\u002F Resize image to 1920×1080 at 72dpi bicubic\ndoc.resizeImage(1920, 1080, 72, ResampleMethod.BICUBIC);\n\n\u002F\u002F Expand canvas to 2000px wide, keeping content centered\ndoc.resizeCanvas(2000, doc.height, AnchorPosition.MIDDLECENTER);\n\n\u002F\u002F Crop to a region\ndoc.crop([100, 100, 900, 600]);\n\n\u002F\u002F Trim transparent edges\ndoc.trim(TrimType.TRANSPARENT, true, true, true, true);\n\n\u002F\u002F Flip horizontal\ndoc.flipCanvas(Direction.HORIZONTAL);\n\n\u002F\u002F Change to grayscale\ndoc.changeMode(ChangeMode.GRAYSCALE);\n\n\u002F\u002F One undo step for many operations\ndoc.suspendHistory(\"Batch Edit\", \"action\");\n\u002F\u002F (Inside Photopea, all ops become one history state)\n\n\u002F\u002F Export PNG to filesystem (triggers ZIP download)\nvar opts = new ExportOptionsSaveForWeb();\nopts.format  = SaveDocumentType.PNG;\nopts.PNG8    = false;\nopts.quality = 100;\ndoc.exportDocument(new File(\"\u002Foutput.png\"), ExportType.SAVEFORWEB, opts);\n\n\u002F\u002F Close without saving\ndoc.close(SaveOptions.DONOTSAVECHANGES);\n```\n\n---\n\n## `Layers` \u002F `ArtLayers` \u002F `LayerSets` Collections\n\nThese collections exist on `Document`, `LayerSet` (groups within groups), and can be iterated.\n\n```js\nvar doc = app.activeDocument;\n\n\u002F\u002F Access\ndoc.layers          \u002F\u002F all top-level (art + groups)\ndoc.artLayers       \u002F\u002F top-level art layers only\ndoc.layerSets       \u002F\u002F top-level group layers only\n\n\u002F\u002F By index (0 = topmost)\ndoc.layers[0]\ndoc.layers[doc.layers.length - 1]  \u002F\u002F bottommost\n\n\u002F\u002F By name (throws if not found)\ndoc.layers.getByName(\"Background\")\ndoc.artLayers.getByName(\"Logo\")\ndoc.layerSets.getByName(\"Header Group\")\n\n\u002F\u002F Add\nvar newLayer  = doc.artLayers.add();         \u002F\u002F new blank art layer\nvar newGroup  = doc.layerSets.add();         \u002F\u002F new group\nvar innerLayer = newGroup.artLayers.add();   \u002F\u002F layer inside a group\n\n\u002F\u002F Remove\ndoc.artLayers.getByName(\"Temp\").remove();\n\n\u002F\u002F Iterate all layers recursively\nfunction walkLayers(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") walkLayers(l);\n    else \u002F* ArtLayer *\u002F processLayer(l);\n  }\n}\nwalkLayers(doc);\n```\n\n---\n\n## `ArtLayer` — Individual Layer\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `name` | string | R\u002FW | Layer name |\n| `visible` | boolean | R\u002FW | Layer visibility |\n| `opacity` | number | R\u002FW | Layer opacity 0–100 |\n| `fillOpacity` | number | R | Fill opacity 0–100 |\n| `blendMode` | BlendMode | R\u002FW | Blend mode (see enum below) |\n| `kind` | LayerKind | R\u002FW | Layer type (can set to `LayerKind.TEXT` on empty layer) |\n| `textItem` | TextItem | R | Text object (only when `kind === LayerKind.TEXT`) |\n| `bounds` | array | R | `[left, top, right, bottom]` in current ruler units |\n| `parent` | Document\u002FLayerSet | R | Containing object |\n| `typename` | string | R | Always `\"ArtLayer\"` |\n| `selected` | boolean | R | **Photopea extension** — is layer highlighted in panel |\n| `isBackgroundLayer` | boolean | R | Is this the locked background layer |\n| `grouped` | boolean | R | Is clipping mask applied |\n| `pixelsLocked` | boolean | R | Pixels locked |\n| `positionLocked` | boolean | R | Position locked |\n| `transparentPixelsLocked` | boolean | R | Transparent pixels locked |\n| `layerMaskDensity` | number | R | Layer mask density 0–100 |\n| `layerMaskFeather` | number | R | Layer mask feather 0–250 |\n| `vectorMaskDensity` | number | R | Vector mask density 0–100 |\n| `vectorMaskFeather` | number | R | Vector mask feather 0–250 |\n\n### Transform Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `translate` | `(deltaX, deltaY)` | Move layer by offset |\n| `rotate` | `(angle, anchor)` | Rotate by degrees. AnchorPosition optional (default center) |\n| `resize` | `(widthPct, heightPct, anchor)` | Scale as percentage of current size |\n| `rasterize` | `(target)` | Rasterize. RasterizeType: `ENTIRE`, `FILLCONTENT`, `LAYERCLIPPINGMASK`, `LINKEDLAYERS`, `SHAPE`, `TEXTCONTENTS`, `VECTORMASK` |\n\n### Layer Management Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `duplicate` | `()` | Duplicate to same document, returns new layer |\n| `duplicate` | `(doc, placement)` | Duplicate to another document |\n| `remove` | `()` | Delete the layer |\n| `merge` | `()` | Merge down; returns the merged ArtLayer |\n| `move` | `(relativeLayer, placement)` | Reorder. ElementPlacement: `PLACEBEFORE`, `PLACEAFTER`, `PLACEATBEGINNING`, `PLACEATEND`, `INSIDE` |\n| `copy` | `(merged)` | Copy to clipboard |\n| `cut` | `()` | Cut to clipboard |\n| `clear` | `()` | Cut without clipboard |\n\n### Adjustment Methods on ArtLayer\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `adjustBrightnessContrast` | `(brightness, contrast)` | Brightness -100–100, Contrast -100–100 |\n| `adjustColorBalance` | `(shadows, midtones, highlights, preserveLuminosity)` | Each is `[cyan-red, magenta-green, yellow-blue]` array |\n| `adjustCurves` | `(curveShape)` | Array of `[input,output]` pairs per channel |\n| `adjustLevels` | `(inputRangeStart, inputRangeEnd, gamma, outputRangeStart, outputRangeEnd)` | Levels adjustment |\n| `autoLevels` | `()` | Auto levels |\n| `autoContrast` | `()` | Auto contrast |\n| `desaturate` | `()` | Convert to grayscale values in current mode |\n| `equalize` | `()` | Equalize brightness distribution |\n| `invert` | `()` | Invert pixel colors |\n| `posterize` | `(levels)` | Posterize (2–255 levels) |\n| `threshold` | `(level)` | B&W threshold (1–255) |\n| `shadowHighlight` | `(shadowAmount, shadowWidth, shadowRadius, highlightAmount, highlightWidth, highlightRadius, colorCorrection, midtoneContrast, blackClip, whiteClip)` | Shadows\u002FHighlights |\n| `photoFilter` | `(fillColor, density, luminosity)` | Photo filter |\n| `mixChannels` | `(outputChannels, monochrome)` | Channel mixer |\n| `selectiveColor` | `(colors, cyan, magenta, yellow, black, method)` | Selective color |\n\n### Filter Methods on ArtLayer\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `applyGaussianBlur` | `(radius)` | Gaussian blur (0.1–250 px radius) |\n| `applyMotionBlur` | `(angle, distance)` | Motion blur |\n| `applyRadialBlur` | `(amount, blurMethod, blurQuality)` | Radial blur |\n| `applySmartBlur` | `(radius, threshold, blurQuality, blurMode)` | Smart blur |\n| `applyBlur` | `()` | Simple blur |\n| `applyBlurMore` | `()` | Blur more |\n| `applyUnSharpMask` | `(amount, radius, threshold)` | Unsharp mask |\n| `applySharpen` | `()` | Sharpen |\n| `applySharpenEdges` | `()` | Sharpen edges |\n| `applySharpenMore` | `()` | Sharpen more |\n| `applyAddNoise` | `(amount, distribution, monochromatic)` | Add noise. NoiseDistribution: `GAUSSIAN`, `UNIFORM` |\n| `applyDespeckle` | `()` | Despeckle |\n| `applyDustAndScratches` | `(radius, threshold)` | Dust and scratches |\n| `applyMedianNoise` | `(radius)` | Median noise reduction |\n| `applyMaximum` | `(radius)` | Maximum filter (dilate) |\n| `applyMinimum` | `(radius)` | Minimum filter (erode) |\n| `applyHighPass` | `(radius)` | High pass |\n| `applyOffset` | `(horizontal, vertical, undefinedAreas)` | Offset. UndefinedAreas: `SETTOBACKGROUND`, `WRAPAROUND`, `REPEATEDGEPIXELS` |\n| `applyRipple` | `(amount, size)` | Ripple. RippleSize: `SMALL`, `MEDIUM`, `LARGE` |\n| `applyWave` | `(generators, minWavelength, maxWavelength, minAmplitude, maxAmplitude, horizScale, vertScale, waveType, undefinedAreas, randomSeed)` | Wave filter |\n| `applyZigZag` | `(amount, ridges, style)` | Zig-Zag |\n| `applyTwirl` | `(angle)` | Twirl |\n| `applyPolarCoordinates` | `(conversion)` | Polar coordinates |\n| `applySpherize` | `(amount, mode)` | Spherize |\n| `applyPinch` | `(amount)` | Pinch (-100–100) |\n| `applyShear` | `(curve, undefinedAreas)` | Shear |\n| `applyDisplace` | `(horizontalScale, verticalScale, displacementType, undefinedAreas, displacementMapFile)` | Displace |\n| `applyClouds` | `()` | Render Clouds |\n| `applyDifferenceClouds` | `()` | Difference Clouds |\n| `applyLensFlare` | `(brightness, flareCenter, lensType)` | Lens Flare. LensType: `ZOOMWIDE, ZOOMNORMAL, MOVIE` |\n| `applyDiffuseGlow` | `(graininess, glowAmount, clearAmount)` | Diffuse Glow |\n| `applyGlassEffect` | `(distortion, smoothness, scaling, invert, texture, textureFile)` | Glass |\n| `applyOceanRipple` | `(size, magnitude)` | Ocean Ripple |\n| `applyLensBlur` | `(source, focalDistance, invertDepthMap, shape, radius, bladeCurvature, rotation, brightness, threshold, amount, distribution, monochromatic)` | Lens Blur |\n| `applyAverage` | `()` | Average blur |\n| `applyDeInterlace` | `(eliminateFields, createFields)` | De-interlace |\n| `applyNTSC` | `()` | NTSC colors |\n| `applyCustomFilter` | `(characteristics, scale, offset)` | Custom filter (5×5 matrix) |\n| `applyTextureFill` | `(textureFile)` | Texture fill |\n| `applyStyle` | `(styleName)` | Apply a layer style preset by name |\n| `photoFilter` | `(fillColor, density, luminosity)` | Photo Filter |\n\n**Practical examples:**\n```js\nvar layer = app.activeDocument.activeLayer;\n\n\u002F\u002F Move to absolute position (layer.bounds[0] = current left edge)\nlayer.translate(200 - layer.bounds[0], 100 - layer.bounds[1]);\n\n\u002F\u002F Rotate 45° around center\nlayer.rotate(45);\n\n\u002F\u002F Scale to 50% keeping center\nlayer.resize(50, 50, AnchorPosition.MIDDLECENTER);\n\n\u002F\u002F Gaussian blur radius 10\nlayer.applyGaussianBlur(10);\n\n\u002F\u002F Unsharp mask\nlayer.applyUnSharpMask(50, 2, 0);\n\n\u002F\u002F Levels: input 0–200, gamma 1.2, output 0–255\nlayer.adjustLevels(0, 200, 1.2, 0, 255);\n\n\u002F\u002F Brightness +20, Contrast +10\nlayer.adjustBrightnessContrast(20, 10);\n\n\u002F\u002F Invert\nlayer.invert();\n\n\u002F\u002F Rasterize text\nlayer.rasterize(RasterizeType.TEXTCONTENTS);\n\n\u002F\u002F Duplicate layer\nvar copy = layer.duplicate();\ncopy.name = \"Layer Copy\";\n\n\u002F\u002F Move layer below another\nvar target = doc.layers.getByName(\"Background\");\nlayer.move(target, ElementPlacement.PLACEAFTER);\n```\n\n---\n\n## `LayerSet` — Group Layer\n\nA LayerSet is a folder\u002Fgroup in the Layers panel. It has the same layer management methods as `Document`.\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `name` | string | R\u002FW | Group name |\n| `visible` | boolean | R\u002FW | Group visibility |\n| `opacity` | number | R\u002FW | Group opacity 0–100 |\n| `blendMode` | BlendMode | R\u002FW | Group blend mode |\n| `bounds` | array | R | Bounding box `[left,top,right,bottom]` |\n| `layers` | Layers | R | All layers inside this group |\n| `artLayers` | ArtLayers | R | Art layers inside this group |\n| `layerSets` | LayerSets | R | Sub-groups inside this group |\n| `parent` | Document\u002FLayerSet | R | Parent container |\n| `typename` | string | R | Always `\"LayerSet\"` |\n\n### Methods\nSame as Document for layer management: `layers.add()`, `artLayers.add()`, `layerSets.add()`, `.getByName()`, plus `duplicate()`, `remove()`, `move()`.\n\n```js\n\u002F\u002F Create group with layers inside\nvar group = doc.layerSets.add();\ngroup.name = \"Product Card\";\n\nvar bgLayer   = group.artLayers.add(); bgLayer.name = \"Background\";\nvar textLayer = group.artLayers.add(); textLayer.kind = LayerKind.TEXT;\ntextLayer.textItem.contents = \"Buy Now\";\ntextLayer.textItem.size     = 36;\n\n\u002F\u002F Collapse\u002Fexpand group (Photopea specific, not in standard DOM)\n\u002F\u002F Use visibility as workaround\n\n\u002F\u002F Get specific layer inside a group\nvar innerLayer = doc.layerSets.getByName(\"Header Group\").artLayers.getByName(\"Title\");\n```\n\n---\n\n## `TextItem` — Text Layer Content\n\nAccess via `layer.textItem` on any layer with `layer.kind === LayerKind.TEXT`.\n\n### Core Properties (most commonly used)\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `contents` | string | R\u002FW | The actual text content |\n| `font` | string | R\u002FW | Font PostScript name (e.g. `\"ArialMT\"`, `\"Verdana-Bold\"`) |\n| `size` | number | R\u002FW | Font size in points |\n| `color` | SolidColor | R\u002FW | Text color |\n| `position` | array | R\u002FW | `[x, y]` origin of text (point text) or bounding box top-left |\n| `justification` | Justification | R\u002FW | `Justification.LEFT`, `CENTER`, `RIGHT`, `FULLJUSTIFY` |\n| `kind` | TextType | R\u002FW | `TextType.POINTTEXT` or `TextType.PARAGRAPHTEXT` |\n| `width` | number | R\u002FW | Width of bounding box (paragraph text only) |\n| `height` | number | R\u002FW | Height of bounding box (paragraph text only) |\n| `direction` | Direction | R\u002FW | `Direction.HORIZONTAL` or `Direction.VERTICAL` |\n\n### Typography Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `leading` | number | R\u002FW | Line spacing in points |\n| `tracking` | number | R\u002FW | Letter spacing -1000–10000 (1000 = 1 em) |\n| `horizontalScale` | number | R\u002FW | Horizontal scaling 0–1000% |\n| `verticalScale` | number | R\u002FW | Vertical scaling 0–1000% |\n| `baselineShift` | number | R\u002FW | Baseline offset in points |\n| `capitalization` | Case | R\u002FW | `Case.NORMAL`, `ALLCAPS`, `SMALLCAPS` |\n| `fauxBold` | boolean | R\u002FW | Simulated bold |\n| `fauxItalic` | boolean | R\u002FW | Simulated italic |\n| `underline` | UnderlineType | R\u002FW | `UnderlineType.NONE`, `UNDERLINELEFT`, `UNDERLINERIGHT` |\n| `strikeThru` | StrikeThruType | R\u002FW | `StrikeThruType.NONE`, `STRIKEBOX`, `STRIKEHEIGHT` |\n| `antiAliasMethod` | AntiAlias | R\u002FW | `AntiAlias.NONE`, `SHARP`, `CRISP`, `STRONG`, `SMOOTH` |\n| `autoKerning` | AutoKernType | R\u002FW | `AutoKernType.MANUAL`, `METRICS`, `OPTICAL` |\n| `language` | Language | R\u002FW | `Language.ENGLISH`, etc. |\n| `ligatures` | boolean | R\u002FW | Enable ligatures |\n| `alternateLigatures` | boolean | R\u002FW | Enable alternate ligatures |\n| `oldStyle` | boolean | R\u002FW | Old-style numerals |\n| `noBreak` | boolean | R\u002FW | Prevent line breaks in this text |\n| `useAutoLeading` | boolean | R\u002FW | Use font's built-in leading |\n| `autoLeadingAmount` | number | R\u002FW | Auto leading percentage 0.01–5000 |\n| `hyphenation` | boolean | R\u002FW | Enable hyphenation |\n\n### Paragraph Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `leftIndent` | number | R\u002FW | Left indent -1296–1296 |\n| `rightIndent` | number | R\u002FW | Right indent -1296–1296 |\n| `firstLineIndent` | number | R\u002FW | First line indent -1296–1296 |\n| `spaceBefore` | number | R\u002FW | Space before paragraph -1296–1296 |\n| `spaceAfter` | number | R\u002FW | Space after paragraph -1296–1296 |\n| `hangingPuntuation` | boolean | R\u002FW | Roman hanging punctuation |\n| `textComposer` | TextComposer | R\u002FW | `TextComposer.ADOBEEVERYLINE`, `ADOBESINGLELINE` |\n\n### Warp Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `warpStyle` | WarpStyle | R\u002FW | `WarpStyle.NONE`, `ARC`, `ARCH`, `BULGE`, `SHELLLOWER`, `SHELLUPPER`, `FLAG`, `WAVE`, `FISH`, `RISE`, `FISHEYE`, `INFLATE`, `SQUEEZE`, `TWIST` |\n| `warpDirection` | Direction | R\u002FW | `Direction.HORIZONTAL` or `Direction.VERTICAL` |\n| `warpBend` | number | R\u002FW | Warp bend -100–100 |\n| `warpHorizontalDistortion` | number | R\u002FW | Horizontal distortion -100–100 |\n| `warpVerticalDistortion` | number | R\u002FW | Vertical distortion -100–100 |\n\n### Photopea Extensions\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `totalTextStyle` | string | JSON string with ALL style parameters of the text |\n| `transform` | string | JSON array — the affine transform matrix of the text |\n\n### Methods\n\n| Method | Description |\n|--------|-------------|\n| `convertToShape()` | Convert text to a filled shape layer with text as clipping path |\n| `createPath()` | Create work path from text outlines |\n\n**Practical examples:**\n```js\nvar layer = doc.layers.getByName(\"Headline\");\nvar text  = layer.textItem;\n\n\u002F\u002F Set content\ntext.contents = \"Hello World\";\n\n\u002F\u002F Style\ntext.font   = \"Verdana-Bold\";\ntext.size   = 72;\ntext.color.rgb.hexValue = \"FF0000\";    \u002F\u002F red\n\n\u002F\u002F Position point text at (50, 100)\ntext.position = [50, 100];\n\n\u002F\u002F Center align\ntext.justification = Justification.CENTER;\n\n\u002F\u002F Paragraph text with bounding box\ntext.kind   = TextType.PARAGRAPHTEXT;\ntext.width  = new UnitValue(\"400 pixels\");\ntext.height = new UnitValue(\"200 pixels\");\n\n\u002F\u002F Letter spacing\ntext.tracking = 100;   \u002F\u002F 10% spacing\n\n\u002F\u002F Scale text horizontally to 80%\ntext.horizontalScale = 80;\n\n\u002F\u002F Warp arc\ntext.warpStyle = WarpStyle.ARC;\ntext.warpBend  = 30;\n\n\u002F\u002F Read all text styles as JSON (Photopea extension)\nvar styles = JSON.parse(text.totalTextStyle);\napp.echoToOE(JSON.stringify(styles));\n```\n\n---\n\n## Creating a Text Layer from Scratch\n\n```js\napp.preferences.rulerUnits = Units.PIXELS;\n\nvar layer = doc.artLayers.add();\nlayer.kind = LayerKind.TEXT;      \u002F\u002F Convert blank layer to text\nlayer.name = \"My Title\";\n\nvar text = layer.textItem;\ntext.contents      = \"Welcome\";\ntext.font          = \"ArialMT\";\ntext.size          = 48;\ntext.justification = Justification.CENTER;\ntext.position      = [doc.width \u002F 2, 100];\n\nvar color = new SolidColor();\ncolor.rgb.red   = 255;\ncolor.rgb.green = 255;\ncolor.rgb.blue  = 255;\ntext.color = color;\n```\n\n---\n\n## `SolidColor` — Color Object\n\n```js\n\u002F\u002F RGB (most common in Photopea)\nvar c = new SolidColor();\nc.rgb.red   = 255;      \u002F\u002F 0–255\nc.rgb.green = 128;\nc.rgb.blue  = 0;\nc.rgb.hexValue = \"FF8000\";   \u002F\u002F Set via hex string (no #)\n\n\u002F\u002F CMYK\nvar c2 = new SolidColor();\nc2.cmyk.cyan    = 0;    \u002F\u002F 0–100\nc2.cmyk.magenta = 50;\nc2.cmyk.yellow  = 100;\nc2.cmyk.black   = 0;\n\n\u002F\u002F Grayscale\nvar c3 = new SolidColor();\nc3.gray.gray = 50;    \u002F\u002F 0–100\n\n\u002F\u002F HSB\nvar c4 = new SolidColor();\nc4.hsb.hue        = 30;    \u002F\u002F 0–360\nc4.hsb.saturation = 100;   \u002F\u002F 0–100\nc4.hsb.brightness = 100;   \u002F\u002F 0–100\n\n\u002F\u002F Lab\nvar c5 = new SolidColor();\nc5.lab.l = 50;   \u002F\u002F 0–100\nc5.lab.a = 20;   \u002F\u002F -128–127\nc5.lab.b = 40;   \u002F\u002F -128–127\n\n\u002F\u002F Set as foreground color\napp.foregroundColor = c;\n\n\u002F\u002F Use with selection fill\ndoc.selection.selectAll();\ndoc.selection.fill(c);\ndoc.selection.deselect();\n```\n\n---\n\n## `Selection` — Selection Object\n\nAccess via `doc.selection`.\n\n### Properties\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `bounds` | array | `[left, top, right, bottom]` bounding rectangle |\n| `solid` | boolean | Whether selection is a solid rectangle |\n\n### Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `selectAll` | `()` | Select entire document |\n| `deselect` | `()` | Remove selection |\n| `invert` | `()` | Invert the selection |\n| `select` | `(region, type, feather, antiAlias)` | Select polygon region. Region is array of `[x,y]` points. SelectionType: `REPLACE`, `ADD`, `SUBTRACT`, `INTERSECT` |\n| `feather` | `(radius)` | Feather the selection edges |\n| `contract` | `(radius)` | Contract (shrink) selection |\n| `expand` | `(radius)` | Expand selection |\n| `grow` | `(tolerance, antiAlias)` | Grow selection to similar adjacent pixels |\n| `similar` | `(tolerance, antiAlias)` | Select similar pixels throughout document |\n| `smooth` | `(radius)` | Smooth selection edges |\n| `selectBorder` | `(width)` | Select only the border of the current selection |\n| `resize` | `(widthPct, heightPct, anchor)` | Resize selection boundary |\n| `rotate` | `(angle, anchor)` | Rotate selection boundary |\n| `translate` | `(deltaX, deltaY)` | Move selection boundary |\n| `fill` | `(fillWith, mode, opacity, preserveTransparency)` | Fill selection with color or content. fillWith is SolidColor or string |\n| `stroke` | `(strokeColor, width, location, mode, opacity, preserveTransparency)` | Stroke selection border. StrokeLocation: `INSIDE`, `OUTSIDE`, `CENTER` |\n| `copy` | `(merged)` | Copy selection to clipboard |\n| `cut` | `()` | Cut selection to clipboard |\n| `clear` | `()` | Delete selection content |\n| `load` | `(from, type, invert)` | Load selection from channel |\n| `store` | `(into, type)` | Save selection as channel |\n| `makeWorkPath` | `(tolerance)` | Convert to work path |\n\n**Practical examples:**\n```js\nvar sel = doc.selection;\n\n\u002F\u002F Rectangle select (top-left to bottom-right)\nsel.select([[0,0],[500,0],[500,300],[0,300]]);\n\n\u002F\u002F Select all\nsel.selectAll();\n\n\u002F\u002F Add to existing selection\nsel.select([[600,0],[900,0],[900,300],[600,300]], SelectionType.ADD);\n\n\u002F\u002F Feather 10px\nsel.feather(10);\n\n\u002F\u002F Contract by 5px\nsel.contract(5);\n\n\u002F\u002F Fill with red\nvar red = new SolidColor();\nred.rgb.red = 255; red.rgb.green = 0; red.rgb.blue = 0;\nsel.fill(red);\n\n\u002F\u002F Stroke selection with black, 3px, inside\nvar black = new SolidColor();\nblack.rgb.hexValue = \"000000\";\nsel.stroke(black, 3, StrokeLocation.INSIDE);\n\n\u002F\u002F Copy, paste as new layer\nsel.copy();\ndoc.paste();\n\n\u002F\u002F Invert and delete (remove background)\nsel.invert();\nsel.clear();\nsel.deselect();\n```\n\n---\n\n## `BlendMode` Enum — All Values\n\nUsed in `layer.blendMode` (string form in Photopea) and `BlendMode` constant (standard):\n\n| `BlendMode` Constant | Photopea String | Name |\n|----------------------|-----------------|------|\n| `BlendMode.NORMAL` | `\"norm\"` | Normal |\n| `BlendMode.DISSOLVE` | `\"diss\"` | Dissolve |\n| `BlendMode.DARKEN` | `\"dark\"` | Darken |\n| `BlendMode.MULTIPLY` | `\"mul \"` | Multiply |\n| `BlendMode.COLORBURN` | `\"idiv\"` | Color Burn |\n| `BlendMode.LINEARBURN` | `\"lbrn\"` | Linear Burn |\n| `BlendMode.DARKERCOLOR` | `\"dkCl\"` | Darker Color |\n| `BlendMode.LIGHTEN` | `\"lite\"` | Lighten |\n| `BlendMode.SCREEN` | `\"scrn\"` | Screen |\n| `BlendMode.COLORDODGE` | `\"div \"` | Color Dodge |\n| `BlendMode.LINEARDODGE` | `\"lddg\"` | Linear Dodge (Add) |\n| `BlendMode.LIGHTERCOLOR` | `\"lgCl\"` | Lighter Color |\n| `BlendMode.OVERLAY` | `\"over\"` | Overlay |\n| `BlendMode.SOFTLIGHT` | `\"sLit\"` | Soft Light |\n| `BlendMode.HARDLIGHT` | `\"hLit\"` | Hard Light |\n| `BlendMode.VIVIDLIGHT` | `\"vLit\"` | Vivid Light |\n| `BlendMode.LINEARLIGHT` | `\"lLit\"` | Linear Light |\n| `BlendMode.PINLIGHT` | `\"pLit\"` | Pin Light |\n| `BlendMode.HARDMIX` | `\"hMix\"` | Hard Mix |\n| `BlendMode.DIFFERENCE` | `\"diff\"` | Difference |\n| `BlendMode.EXCLUSION` | `\"smud\"` | Exclusion |\n| `BlendMode.SUBTRACT` | `\"fsub\"` | Subtract |\n| `BlendMode.DIVIDE` | `\"fdiv\"` | Divide |\n| `BlendMode.HUE` | `\"hue \"` | Hue |\n| `BlendMode.SATURATION` | `\"sat \"` | Saturation |\n| `BlendMode.COLOR` | `\"colr\"` | Color |\n| `BlendMode.LUMINOSITY` | `\"lum \"` | Luminosity |\n| `BlendMode.PASSTHROUGH` | `\"pass\"` | Pass Through (groups only) |\n\n```js\n\u002F\u002F Use either form:\nlayer.blendMode = BlendMode.SCREEN;     \u002F\u002F constant\nlayer.blendMode = \"scrn\";               \u002F\u002F string (Photopea internal form)\n```\n\n---\n\n## `LayerKind` Enum\n\n| Constant | Description |\n|----------|-------------|\n| `LayerKind.NORMAL` | Regular pixel layer |\n| `LayerKind.TEXT` | Text layer |\n| `LayerKind.SMARTOBJECT` | Smart Object \u002F linked layer |\n| `LayerKind.SOLIDFILL` | Solid color fill layer |\n| `LayerKind.GRADIENTFILL` | Gradient fill layer |\n| `LayerKind.PATTERNFILL` | Pattern fill layer |\n| `LayerKind.BRIGHTNESSCONTRAST` | Brightness\u002FContrast adjustment layer |\n| `LayerKind.CURVES` | Curves adjustment layer |\n| `LayerKind.LEVELS` | Levels adjustment layer |\n| `LayerKind.HUESATURATION` | Hue\u002FSaturation adjustment layer |\n| `LayerKind.COLORBALANCE` | Color Balance adjustment layer |\n| `LayerKind.CHANNELMIXER` | Channel Mixer adjustment layer |\n| `LayerKind.GRADIENTMAP` | Gradient Map adjustment layer |\n| `LayerKind.INVERSION` | Invert adjustment layer |\n| `LayerKind.POSTERIZE` | Posterize adjustment layer |\n| `LayerKind.THRESHOLD` | Threshold adjustment layer |\n| `LayerKind.SELECTIVECOLOR` | Selective Color adjustment layer |\n| `LayerKind.PHOTOFILTER` | Photo Filter adjustment layer |\n| `LayerKind.EXPOSURE` | Exposure adjustment layer |\n| `LayerKind.VIBRANCE` | Vibrance adjustment layer |\n| `LayerKind.COLORLOOKUP` | Color Lookup adjustment layer |\n| `LayerKind.LAYER3D` | 3D layer (not generally useful in Photopea) |\n| `LayerKind.VIDEO` | Video layer |\n\n```js\n\u002F\u002F Identify layer type\nvar layer = doc.activeLayer;\nif (layer.kind === LayerKind.TEXT)         \u002F* text layer *\u002F;\nif (layer.kind === LayerKind.SMARTOBJECT)  \u002F* smart object *\u002F;\nif (layer.typename === \"LayerSet\")         \u002F* group *\u002F;\n\n\u002F\u002F Filter: collect all text layers recursively\nvar textLayers = [];\nfunction collectText(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") collectText(l);\n    else if (l.kind === LayerKind.TEXT) textLayers.push(l);\n  }\n}\ncollectText(doc);\n```\n\n---\n\n## `AnchorPosition` Enum\n\n| Constant | Position |\n|----------|----------|\n| `AnchorPosition.TOPLEFT` | Top left |\n| `AnchorPosition.TOPCENTER` | Top center |\n| `AnchorPosition.TOPRIGHT` | Top right |\n| `AnchorPosition.MIDDLELEFT` | Middle left |\n| `AnchorPosition.MIDDLECENTER` | Center |\n| `AnchorPosition.MIDDLERIGHT` | Middle right |\n| `AnchorPosition.BOTTOMLEFT` | Bottom left |\n| `AnchorPosition.BOTTOMCENTER` | Bottom center |\n| `AnchorPosition.BOTTOMRIGHT` | Bottom right |\n\n---\n\n## `ElementPlacement` Enum\n\nUsed with `layer.move(relativeObject, placement)`:\n\n| Constant | Effect |\n|----------|--------|\n| `ElementPlacement.PLACEBEFORE` | Above the target layer in the panel |\n| `ElementPlacement.PLACEAFTER` | Below the target layer in the panel |\n| `ElementPlacement.PLACEATBEGINNING` | Top of the layer stack |\n| `ElementPlacement.PLACEATEND` | Bottom of the layer stack |\n| `ElementPlacement.INSIDE` | Into a LayerSet (makes layer a child) |\n\n---\n\n## `ResampleMethod` Enum\n\nUsed with `doc.resizeImage()`:\n\n| Constant | Description |\n|----------|-------------|\n| `ResampleMethod.BICUBIC` | High quality, good for smooth gradients |\n| `ResampleMethod.BICUBICSHARPER` | Best for reduction |\n| `ResampleMethod.BICUBICSMOOTHER` | Best for enlargement |\n| `ResampleMethod.BILINEAR` | Medium quality |\n| `ResampleMethod.NEARESTNEIGHBOR` | No anti-aliasing, fastest |\n| `ResampleMethod.NONE` | No resampling (change resolution only) |\n\n---\n\n## `SaveOptions` Enum\n\nUsed with `doc.close(saveOption)`:\n\n| Constant | Meaning |\n|----------|---------|\n| `SaveOptions.DONOTSAVECHANGES` | Discard all changes and close |\n| `SaveOptions.SAVECHANGES` | Save then close |\n| `SaveOptions.PROMPTTOSAVECHANGES` | Show dialog (may block in headless) |\n\n---\n\n## `ExportOptionsSaveForWeb` — Export to Filesystem\n\nUsed with `doc.exportDocument()` to write files that Photopea packages into a ZIP.\n\n```js\n\u002F\u002F Export PNG\nvar pngOpts = new ExportOptionsSaveForWeb();\npngOpts.format      = SaveDocumentType.PNG;\npngOpts.PNG8        = false;    \u002F\u002F PNG-24\npngOpts.quality     = 100;\npngOpts.transparency = true;\ndoc.exportDocument(new File(\"\u002Fexport.png\"), ExportType.SAVEFORWEB, pngOpts);\n\n\u002F\u002F Export JPEG\nvar jpgOpts = new ExportOptionsSaveForWeb();\njpgOpts.format  = SaveDocumentType.JPEG;\njpgOpts.quality = 80;    \u002F\u002F 0–100\ndoc.exportDocument(new File(\"\u002Fexport.jpg\"), ExportType.SAVEFORWEB, jpgOpts);\n\n\u002F\u002F Export GIF\nvar gifOpts = new ExportOptionsSaveForWeb();\ngifOpts.format     = SaveDocumentType.GIF;\ngifOpts.colors     = 256;\ngifOpts.dither     = 100;\ngifOpts.transparency = true;\ndoc.exportDocument(new File(\"\u002Fexport.gif\"), ExportType.SAVEFORWEB, gifOpts);\n```\n\n---\n\n## `executeAction` — Advanced Operations\n\nUsed for operations not exposed in the standard DOM (adjustments applied as adjustment layers,\nSmart Object editing, etc.). Takes the Photoshop Action Manager approach.\n\n```js\n\u002F\u002F Open Smart Object for editing\nvar l = doc.layers.getByName(\"SmartObj\");\ndoc.activeLayer = l;\nexecuteAction(stringIDToTypeID(\"placedLayerEditContents\"));\n\u002F\u002F Smart Object is now the active document\ndoc.activeLayer.rotate(90);\ndoc.save();\ndoc.close();\n\n\u002F\u002F Apply Hue\u002FSaturation as destructive adjustment\nvar desc = new ActionDescriptor();\nvar list = new ActionList();\nvar channel = new ActionDescriptor();\nchannel.putEnumerated(stringIDToTypeID(\"presetKind\"), stringIDToTypeID(\"presetKindType\"), stringIDToTypeID(\"presetKindDefault\"));\nchannel.putInteger(stringIDToTypeID(\"hue\"),        20);   \u002F\u002F hue shift\nchannel.putInteger(stringIDToTypeID(\"saturation\"), 30);   \u002F\u002F saturation\nchannel.putInteger(stringIDToTypeID(\"lightness\"),  0);\nlist.putObject(stringIDToTypeID(\"hueSaturationAdjustmentV2Layer\"), channel);\ndesc.putList(stringIDToTypeID(\"adjustment\"), list);\nexecuteAction(stringIDToTypeID(\"hueSaturation\"), desc, DialogModes.NO);\n\n\u002F\u002F Select a layer by name using AM\nfunction selectLayerByName(name) {\n  var desc = new ActionDescriptor();\n  var ref  = new ActionReference();\n  ref.putName(charIDToTypeID(\"Lyr \"), name);\n  desc.putReference(charIDToTypeID(\"null\"), ref);\n  desc.putBoolean(charIDToTypeID(\"MkVs\"), false);\n  executeAction(charIDToTypeID(\"slct\"), desc, DialogModes.NO);\n}\n```\n\n---\n\n## Complete Practical Script Examples\n\n### 1. Rename all text layers based on their contents\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc = app.activeDocument;\n\nfunction processLayers(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") processLayers(l);\n    else if (l.kind === LayerKind.TEXT) {\n      l.name = l.textItem.contents.substring(0, 30);\n    }\n  }\n}\nprocessLayers(doc);\napp.echoToOE(\"done\");\n```\n\n### 2. Export each layer as a separate PNG\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc = app.activeDocument;\n\nfor (var i = 0; i \u003C doc.layers.length; i++) {\n  \u002F\u002F Hide all layers\n  for (var j = 0; j \u003C doc.layers.length; j++) doc.layers[j].visible = false;\n  \u002F\u002F Show only this layer\n  doc.layers[i].visible = true;\n  \u002F\u002F Export\n  var opts = new ExportOptionsSaveForWeb();\n  opts.format  = SaveDocumentType.PNG;\n  opts.PNG8    = false;\n  opts.quality = 100;\n  doc.exportDocument(\n    new File(\"\u002F\" + doc.layers[i].name + \".png\"),\n    ExportType.SAVEFORWEB, opts\n  );\n}\n\n\u002F\u002F Restore visibility\nfor (var i = 0; i \u003C doc.layers.length; i++) doc.layers[i].visible = true;\n```\n\n### 3. Find and replace text across all text layers\n```js\nvar searchText   = \"2024\";\nvar replaceText  = \"2025\";\n\nfunction findReplaceText(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") findReplaceText(l);\n    else if (l.kind === LayerKind.TEXT) {\n      var t = l.textItem;\n      if (t.contents.indexOf(searchText) !== -1) {\n        t.contents = t.contents.split(searchText).join(replaceText);\n      }\n    }\n  }\n}\nfindReplaceText(app.activeDocument);\napp.echoToOE(\"Find & Replace complete\");\n```\n\n### 4. Grid of duplicate layers\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc   = app.activeDocument;\nvar layer = doc.activeLayer;\nvar cols  = 4, rows = 3;\nvar padX  = 20, padY = 20;\nvar w = layer.bounds[2] - layer.bounds[0];\nvar h = layer.bounds[3] - layer.bounds[1];\n\nfor (var r = 0; r \u003C rows; r++) {\n  for (var c = 0; c \u003C cols; c++) {\n    if (r === 0 && c === 0) continue; \u002F\u002F skip original\n    var copy = layer.duplicate();\n    var targetX = layer.bounds[0] + c * (w + padX);\n    var targetY = layer.bounds[1] + r * (h + padY);\n    copy.translate(targetX - copy.bounds[0], targetY - copy.bounds[1]);\n    copy.opacity = 100 - (r * cols + c) * 5;\n  }\n}\n```\n\n### 5. Apply watermark from URL\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc = app.activeDocument;\n\n\u002F\u002F Open watermark as smart object layer\napp.open(\"https:\u002F\u002Fexample.com\u002Fwatermark.png\", null, true);\nvar wm = doc.activeLayer;\n\n\u002F\u002F Resize to 20% of document width\nvar wmW = wm.bounds[2] - wm.bounds[0];\nvar targetW = doc.width * 0.2;\nvar scalePct = (targetW \u002F wmW) * 100;\nwm.resize(scalePct, scalePct, AnchorPosition.TOPLEFT);\n\n\u002F\u002F Move to bottom-right with 20px margin\nvar wmNewW = wm.bounds[2] - wm.bounds[0];\nvar wmNewH = wm.bounds[3] - wm.bounds[1];\nwm.translate(\n  doc.width  - wmNewW - 20 - wm.bounds[0],\n  doc.height - wmNewH - 20 - wm.bounds[1]\n);\nwm.opacity = 60;\napp.echoToOE(\"watermark applied\");\n```\n\n### 6. Get all layer info as JSON\n```js\nfunction getLayerInfo(parent, depth) {\n  depth = depth || 0;\n  var result = [];\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    var info = {\n      name:    l.name,\n      type:    l.typename,\n      visible: l.visible,\n      opacity: l.opacity,\n      depth:   depth\n    };\n    if (l.typename === \"ArtLayer\") {\n      info.kind   = l.kind.toString();\n      info.bounds = [l.bounds[0], l.bounds[1], l.bounds[2], l.bounds[3]];\n      if (l.kind === LayerKind.TEXT) {\n        info.text = l.textItem.contents;\n        info.font = l.textItem.font;\n        info.size = l.textItem.size;\n      }\n    } else if (l.typename === \"LayerSet\") {\n      info.children = getLayerInfo(l, depth + 1);\n    }\n    result.push(info);\n  }\n  return result;\n}\napp.echoToOE(JSON.stringify(getLayerInfo(app.activeDocument)));\n```\n\n---\n\n## Common Mistakes & Gotchas\n\n| Problem | Cause | Fix |\n|---------|-------|-----|\n| `createEmbed` never resolves | Container has no size | Add `width` + `height` CSS to the container `\u003Cdiv>` |\n| `runScript` returns `[\"done\"]` with no data | No `echoToOE` in script | Add `app.echoToOE(value)` for anything you want back |\n| `result[0]` is `\"done\"`, not the expected value | `echoToOE` not reached | Check script logic for early exit or errors |\n| Images won't load (network error) | CORS | Server must respond with `Access-Control-Allow-Origin: *` |\n| `openFromURL(url, true)` layer not ready | Async loading lag | Use `addImageAndWait` utility |\n| `exportImage` only PNG\u002FJPG | `exportImage` limitation | Use `runScript(\"saveToOE('webp:0.85')\")` for other formats |\n| Pixel coordinates behave unexpectedly | Wrong ruler units | Always set `app.preferences.rulerUnits = Units.PIXELS` first |\n| Text `size` set but looks different | Wrong type units | Set `app.preferences.typeUnits = TypeUnits.PIXELS` |\n| Layer not found by name | Wrong layer level | Layers are scoped; use recursive search for nested layers |\n| `layer.bounds[0]` returns a UnitValue, not number | Ruler units issue | Force `Units.PIXELS` before reading bounds |\n| Smart Object edit hangs | Missing `doc.save(); doc.close()` | Always save + close when done editing SO |\n| React double-mount in dev | Strict Mode | Use `if (peaRef.current) return` guard in `useEffect` |\n\n---\n\n## Limitations\n\n- This skill covers host-page integration patterns; it does not replace Photopea's own terms, API documentation, or licensing guidance.\n- Remote URL loading depends on browser CORS behavior, network availability, and the user's Photopea account\u002Fsession state.\n- `runScript` executes scripts inside the embedded Photopea document context. Only run scripts you understand and only with user-approved files.\n- Serialize dynamic values with `JSON.stringify` before embedding them in a `runScript` string. Never concatenate user-provided URLs, layer names, or text directly into Photopea script source.\n- Export behavior can vary by document size, browser memory limits, and the formats supported by the active Photopea runtime.\n\n---\n\n## Sources\n\n- photopea.js: https:\u002F\u002Fgithub.com\u002Fyikuansun\u002FPhotopeaAPI\n- npm: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fphotopea\n- Photopea Live Messaging API: https:\u002F\u002Fwww.photopea.com\u002Fapi\u002Flive\n- Photopea Script reference: https:\u002F\u002Fwww.photopea.com\u002Flearn\u002Fscripts\n- Photoshop JS Scripting reference (compatible): https:\u002F\u002Ftheiviaxx.github.io\u002Fphotoshop-docs\u002FPhotoshop\u002Findex.html\n- Plugin dev gists (addImageAndWait, getDocumentAsImage): https:\u002F\u002Fgist.github.com\u002Fyikuansun\u002Fc0f1a602b4e9d4e344a41c4f49ded3bf\n","# Photopea Embedded Editor Skill\n## Using photopea.js (yikuansun\u002FPhotopeaAPI) in Websites & Apps\n\n---\n\n## When to Use This Skill\n\nUse this skill for **every task** that involves:\n- Embedding Photopea as an image editor inside a webpage or web app\n- Controlling an embedded Photopea instance from your JavaScript code\n- Automating image editing workflows from a host page (open files, run scripts, export results)\n- Building an image editing feature into your product using Photopea as the engine\n- Writing scripts to manipulate documents, layers, text, selections, filters, colors, and paths\n\n**Do NOT** use raw `postMessage` wiring — always use `photopea.js` as the wrapper.\n\n---\n\n## Library: photopea.js\n\n`photopea.js` is a Promises-based JavaScript wrapper around the Photopea Live Messaging API.\nRepository: https:\u002F\u002Fgithub.com\u002Fyikuansun\u002FPhotopeaAPI\nnpm package: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fphotopea\n\n### Installation\n\n**CDN (no build step)**\n```html\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fphotopea@1.1.1\u002Fdist\u002Fphotopea.min.js\">\u003C\u002Fscript>\n```\n\n**Self-hosted**\n```html\n\u003Cscript src=\".\u002Fphotopea.min.js\">\u003C\u002Fscript>\n```\n\n**npm (Webpack \u002F Vite \u002F Rollup)**\n```bash\nnpm install photopea\n```\n```js\nimport Photopea from \"photopea\";\n```\n\n---\n\n## Core API: The `Photopea` Class\n\n| Method | Description |\n|--------|-------------|\n| `Photopea.createEmbed(container)` | Creates + injects the iframe, resolves when ready |\n| `new Photopea(window.parent)` | Plugin mode: wrap the parent window |\n| `pea.runScript(script)` | Run JS string inside Photopea; returns output array |\n| `pea.loadAsset(arrayBuffer)` | Load binary file (image, font, brush, etc.) |\n| `pea.openFromURL(url, asSmart)` | Open remote URL as new doc or smart object layer |\n| `pea.exportImage(type)` | Export current doc; returns `Blob` (`\"png\"` or `\"jpg\"`) |\n\nAll methods return Promises — always `await` or `.then()`.\n\n---\n\n## Step 1 — Embed\n\nThe container `\u003Cdiv>` **must** have a fixed width and height before calling `createEmbed`.\n\n```html\n\u003Cdiv id=\"editor\" style=\"width:1000px; height:650px;\">\u003C\u002Fdiv>\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fphotopea@1.1.1\u002Fdist\u002Fphotopea.min.js\">\u003C\u002Fscript>\n\u003Cscript>\n  Photopea.createEmbed(document.getElementById(\"editor\")).then(async (pea) => {\n    \u002F\u002F pea is ready\n  });\n\u003C\u002Fscript>\n```\n\n**React:**\n```jsx\nimport { useEffect, useRef } from \"react\";\nimport Photopea from \"photopea\";\n\nexport default function Editor() {\n  const containerRef = useRef(null);\n  const peaRef       = useRef(null);\n\n  useEffect(() => {\n    if (!containerRef.current || peaRef.current) return;\n    Photopea.createEmbed(containerRef.current).then((pea) => {\n      peaRef.current = pea;\n    });\n  }, []);\n\n  return \u003Cdiv ref={containerRef} style={{ width: \"100%\", height: \"650px\" }} \u002F>;\n}\n```\n\n---\n\n## Step 2 — Opening Files\n\n```js\n\u002F\u002F Remote URL → new document\nawait pea.openFromURL(\"https:\u002F\u002Fexample.com\u002Fdesign.psd\", false);\n\n\u002F\u002F Remote URL → smart object layer inside current document\nawait pea.openFromURL(\"https:\u002F\u002Fexample.com\u002Foverlay.png\", true);\n\n\u002F\u002F Local file (user input → ArrayBuffer → loadAsset)\ndocument.getElementById(\"fileInput\").addEventListener(\"change\", async (e) => {\n  const buf = await e.target.files[0].arrayBuffer();\n  await pea.loadAsset(buf);\n});\n\n\u002F\u002F Base64 data URI via runScript\nawait pea.runScript(`app.open(\"data:image\u002Fpng;base64,iVBORw0...\");`);\n```\n\n---\n\n## Step 3 — Running Scripts\n\n`runScript` sends a JS string, returns an array of `app.echoToOE(...)` values + `\"done\"` last.\n\n```js\nconst result = await pea.runScript(`app.echoToOE(\"hello\");`);\n\u002F\u002F result → [\"hello\", \"done\"]\n\n\u002F\u002F Return structured data\nconst out = await pea.runScript(`\n  app.echoToOE(JSON.stringify({\n    width:  app.activeDocument.width,\n    height: app.activeDocument.height,\n    layers: app.activeDocument.layers.length\n  }));\n`);\nconst info = JSON.parse(out[0]);\n```\n\n---\n\n## Step 4 — Exporting\n\n```js\n\u002F\u002F PNG Blob (via exportImage)\nconst blob = await pea.exportImage(\"png\");\ndocument.getElementById(\"preview\").src = URL.createObjectURL(blob);\n\n\u002F\u002F JPEG Blob\nconst blob = await pea.exportImage(\"jpg\");\n\n\u002F\u002F WebP \u002F PSD \u002F quality-controlled JPEG via saveToOE\nconst result = await pea.runScript(`app.activeDocument.saveToOE(\"webp:0.85\");`);\nconst webpBlob = new Blob([result[0]], { type: \"image\u002Fwebp\" });\n\nconst result = await pea.runScript(`app.activeDocument.saveToOE(\"psd:true\");`);\nconst psdBlob  = new Blob([result[0]], { type: \"application\u002Foctet-stream\" });\n\n\u002F\u002F Trigger download\nasync function download(pea, filename = \"export.png\") {\n  const blob = await pea.exportImage(\"png\");\n  const a    = Object.assign(document.createElement(\"a\"), {\n    href:     URL.createObjectURL(blob),\n    download: filename\n  });\n  a.click();\n}\n```\n\n**Export format strings for `saveToOE`:**\n\n| String | Format |\n|--------|--------|\n| `\"png\"` | PNG lossless |\n| `\"jpg\"` | JPEG default |\n| `\"jpg:0.8\"` | JPEG quality 0.0–1.0 |\n| `\"webp:0.7\"` | WebP quality 0.0–1.0 |\n| `\"psd\"` | Full PSD |\n| `\"psd:true\"` | Minified PSD |\n| `\"svg:true\"` | SVG |\n\n---\n\n## Step 5 — Loading Assets\n\n```js\n\u002F\u002F Font\nconst buf = await (await fetch(\"https:\u002F\u002Fexample.com\u002FMyFont.otf\")).arrayBuffer();\nawait pea.loadAsset(buf);\n\u002F\u002F Now usable in textItem.font\n\n\u002F\u002F Brush\nawait pea.loadAsset(await (await fetch(\"Nature.ABR\")).arrayBuffer());\n\n\u002F\u002F Gradient\nawait pea.loadAsset(await (await fetch(\"Gradients.GRD\")).arrayBuffer());\n```\n\n---\n\n## Step 6 — Plugin Mode\n\n```js\n\u002F\u002F Your page is inside Photopea's sidebar iframe\nconst pea = new Photopea(window.parent);\n\nconst out = await pea.runScript(`app.echoToOE(app.activeDocument.width);`);\nconsole.log(\"Width:\", out[0]);\n\n\u002F\u002F Load an asset from your plugin\nconst buf = await (await fetch(\"https:\u002F\u002Fmy-assets.com\u002Fsticker.png\")).arrayBuffer();\nawait pea.loadAsset(buf);\n```\n\nPlugin config:\n```json\n{\n  \"environment\": {\n    \"plugins\": [{\n      \"name\": \"My Plugin\",\n      \"url\":  \"https:\u002F\u002Fmy-plugin.example.com\",\n      \"icon\": \"===https:\u002F\u002Fmy-plugin.example.com\u002Ficon.png\"\n    }]\n  }\n}\n```\n\n---\n\n## Utility Patterns\n\n### addImageAndWait — robust async layer insertion\n```js\nasync function addImageAndWait(pea, imgURI) {\n  let count = \"done\";\n  while (count === \"done\")\n    count = (await pea.runScript(`app.echoToOE(app.activeDocument.layers.length)`))[0];\n  count = parseInt(count);\n\n  const imageUrlLiteral = JSON.stringify(imgURI);\n  await pea.runScript(`app.open(${imageUrlLiteral}, null, true);`);\n\n  return new Promise((resolve) => {\n    const check = async () => {\n      const n = parseInt((await pea.runScript(\n        `app.echoToOE(app.activeDocument.layers.length)`\n      ))[0]);\n      n === count + 1 ? resolve() : setTimeout(check, 50);\n    };\n    check();\n  });\n}\n```\n\n### getDocumentAsImage — returns `\u003Cimg>` element\n```js\nasync function getDocumentAsImage(pea) {\n  const result = await pea.runScript(`app.activeDocument.saveToOE('png')`);\n  return new Promise((resolve) => {\n    const fr = new FileReader();\n    fr.addEventListener(\"load\", (e) => {\n      const img = new Image(); img.src = e.target.result; resolve(img);\n    });\n    fr.readAsDataURL(new Blob([result[0]], { type: \"image\u002Fpng\" }));\n  });\n}\n```\n\n---\n\n## Real-World Patterns\n\n### Pattern A — Open + Export UI\n```html\n\u003Cinput type=\"file\" id=\"fileInput\" accept=\"image\u002F*,.psd\">\n\u003Cbutton id=\"exportBtn\">Export PNG\u003C\u002Fbutton>\n\u003Cdiv id=\"editor\" style=\"width:100%;height:600px;\">\u003C\u002Fdiv>\n\u003Cscript src=\"https:\u002F\u002Fcdn.jsdelivr.net\u002Fnpm\u002Fphotopea@1.1.1\u002Fdist\u002Fphotopea.min.js\">\u003C\u002Fscript>\n\u003Cscript>\nlet pea;\nPhotopea.createEmbed(document.getElementById(\"editor\")).then(p => pea = p);\n\ndocument.getElementById(\"fileInput\").addEventListener(\"change\", async e => {\n  await pea.loadAsset(await e.target.files[0].arrayBuffer());\n});\ndocument.getElementById(\"exportBtn\").addEventListener(\"click\", async () => {\n  const blob = await pea.exportImage(\"png\");\n  const a = Object.assign(document.createElement(\"a\"), {\n    href: URL.createObjectURL(blob), download: \"export.png\"\n  });\n  a.click();\n});\n\u003C\u002Fscript>\n```\n\n### Pattern B — Template + Text Edit + Export\n```js\nasync function generateCard(pea, name, tagline) {\n  await pea.openFromURL(\"https:\u002F\u002Fexample.com\u002Fcard.psd\", false);\n  const nameLiteral = JSON.stringify(name);\n  const taglineLiteral = JSON.stringify(tagline);\n  await pea.runScript(`\n    app.activeDocument.layers.getByName(\"Name\").textItem.contents    = ${nameLiteral};\n    app.activeDocument.layers.getByName(\"Tagline\").textItem.contents = ${taglineLiteral};\n  `);\n  return await pea.exportImage(\"png\");\n}\n```\n\n### Pattern C — Batch Watermark\n```js\nasync function batchWatermark(pea, imageURLs, watermarkURL) {\n  const results = [];\n  for (const url of imageURLs) {\n    await pea.openFromURL(url, false);\n    await pea.openFromURL(watermarkURL, true);\n    await pea.runScript(`\n      var doc = app.activeDocument, wm = doc.activeLayer;\n      wm.translate(doc.width - wm.bounds[2] - 20, doc.height - wm.bounds[3] - 20);\n      wm.opacity = 70;\n    `);\n    results.push(await pea.exportImage(\"png\"));\n    await pea.runScript(`app.activeDocument.close(SaveOptions.DONOTSAVECHANGES);`);\n  }\n  return results;\n}\n```\n\n---\n\n# FULL SCRIPTING API REFERENCE\n\n> All code in this section runs **inside `pea.runScript(\"...\")`** strings.\n> Photopea implements the Adobe Photoshop CC 2015 JavaScript scripting interface.\n> Any Photoshop script targeting that version should work in Photopea.\n\n---\n\n## `app` — Application Object\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `app.activeDocument` | Document | R\u002FW | The currently active document |\n| `app.documents` | Documents | R | Collection of all open documents |\n| `app.documents.length` | number | R | Count of open documents |\n| `app.documents[i]` | Document | R | Access by zero-based index |\n| `app.foregroundColor` | SolidColor | R\u002FW | Current foreground color |\n| `app.backgroundColor` | SolidColor | R\u002FW | Current background color |\n| `app.preferences.rulerUnits` | Units | R\u002FW | `Units.PIXELS`, `Units.CM`, `Units.INCHES`, `Units.MM`, `Units.PICAS`, `Units.POINTS`, `Units.PERCENT` |\n| `app.preferences.typeUnits` | TypeUnits | R\u002FW | `TypeUnits.PIXELS`, `TypeUnits.MM`, `TypeUnits.POINTS` |\n| `app.displayDialogs` | DialogModes | R\u002FW | `DialogModes.NO`, `DialogModes.ALL`, `DialogModes.ERROR` |\n\n### Methods\n\n| Method | Description |\n|--------|-------------|\n| `app.open(url)` | Open URL as new document |\n| `app.open(url, null, true)` | Open URL as smart object layer in active document |\n| `app.echoToOE(string)` | **Photopea extension** — send string to host page (captured by `runScript`) |\n| `app.showWindow(\"magiccut\")` | **Photopea extension** — open Magic Cut panel |\n| `app.showWindow(\"vbitmap\")` | **Photopea extension** — open Vectorize Bitmap panel |\n| `app.UI.zoomIn()` | Zoom in |\n| `app.UI.zoomOut()` | Zoom out |\n| `app.UI.fitTheArea()` | Fit canvas to viewport |\n| `app.UI.pixelToPixel()` | 100% zoom |\n| `app.UI.switchFullscreen()` | Toggle fullscreen |\n| `app.UI.scroll(dx, dy)` | Scroll by delta |\n| `app.UI.scrollTo(x, y)` | Scroll to absolute position |\n\n**Important:** Always set ruler units to pixels at the start of any script that uses pixel measurements:\n```js\nvar savedUnits = app.preferences.rulerUnits;\napp.preferences.rulerUnits = Units.PIXELS;\n\u002F\u002F ... your code ...\napp.preferences.rulerUnits = savedUnits;\n```\n\n---\n\n## `Document` — Document Object\n\nAccess via `app.activeDocument` or `app.documents[i]`.\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `width` | number | R | Document width in current ruler units |\n| `height` | number | R | Document height in current ruler units |\n| `resolution` | number | R | DPI (pixels per inch) |\n| `name` | string | **R\u002FW** | **Photopea extension** — display label (no history step) |\n| `source` | string | **R\u002FW** | **Photopea extension** — file origin URL or `\"local,X,NAME\"` |\n| `mode` | DocumentMode | R | `DocumentMode.RGB`, `GRAYSCALE`, `CMYK`, `LAB`, `BITMAP`, `INDEXEDCOLOR`, `MULTICHANNEL` |\n| `bitsPerChannel` | BitsPerChannelType | R | `BitsPerChannelType.EIGHT`, `SIXTEEN`, `THIRTYTWO` |\n| `colorProfileName` | string | R | Name of embedded color profile |\n| `activeLayer` | Layer\u002FArtLayer\u002FLayerSet | R\u002FW | Set to activate a layer |\n| `currentLayer` | ArtLayer | R\u002FW | Alias for `activeLayer` |\n| `layers` | Layers | R | All top-level layers (both art + group) |\n| `artLayers` | ArtLayers | R | All top-level art layers only |\n| `layerSets` | LayerSets | R | All top-level group layers only |\n| `selection` | Selection | R | The current selection |\n| `channels` | Channels | R | All channels |\n| `historyStates` | HistoryStates | R | Undo history |\n| `activeHistoryState` | HistoryState | R\u002FW | Current history position |\n| `layerComps` | LayerComps | R | Layer comps collection |\n| `guides` | Guides | R | Guides collection |\n| `pathItems` | PathItems | R | Vector paths |\n| `id` | number | R | Unique document ID |\n| `saved` | boolean | R | Whether document has unsaved changes |\n| `quickMaskMode` | boolean | R | Whether in Quick Mask mode |\n| `backgroundLayer` | ArtLayer | R | The background layer |\n| `pixelAspectRatio` | number | R | Custom pixel aspect ratio (0.1–10.0) |\n| `histogram` | array | R | 256-element histogram array |\n\n### Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `resizeImage` | `(w, h, res, resampleMethod)` | Resize image pixels. ResampleMethod: `BICUBIC`, `BILINEAR`, `NEARESTNEIGHBOR`, `NONE`, `BICUBICSHARPER`, `BICUBICSMOOTHER` |\n| `resizeCanvas` | `(w, h, anchor)` | Resize canvas without scaling. AnchorPosition: `TOPLEFT`, `TOPCENTER`, `TOPRIGHT`, `MIDDLELEFT`, `MIDDLECENTER`, `MIDDLERIGHT`, `BOTTOMLEFT`, `BOTTOMCENTER`, `BOTTOMRIGHT` |\n| `rotateCanvas` | `(degrees)` | Rotate entire canvas. Positive = clockwise |\n| `flipCanvas` | `(direction)` | `Direction.HORIZONTAL` or `Direction.VERTICAL` |\n| `crop` | `([x1,y1,x2,y2], angle, w, h)` | Crop canvas. Angle and dimensions are optional |\n| `trim` | `(trimType, top, left, bottom, right)` | Trim transparent\u002Fbackground-color borders. TrimType: `TRANSPARENT`, `TOPLEFT`, `BOTTOMRIGHT` |\n| `revealAll` | `()` | Expand canvas to show clipped content |\n| `flatten` | `()` | Merge all layers into one |\n| `mergeVisibleLayers` | `()` | Merge all visible layers |\n| `rasterizeAllLayers` | `()` | Rasterize all vector\u002Ftext layers |\n| `changeMode` | `(mode, options)` | Convert color mode (e.g., `ChangeMode.GRAYSCALE`) |\n| `convertProfile` | `(profileName, renderingIntent, blackPointCompensation, dither)` | Convert color profile |\n| `duplicate` | `(name, mergedLayers)` | Duplicate the document |\n| `close` | `(saveOptions)` | Close document. SaveOptions: `DONOTSAVECHANGES`, `SAVECHANGES`, `PROMPTTOSAVECHANGES` |\n| `save` | `()` | Save (requires server config in embed) |\n| `saveToOE` | `(format)` | **Photopea extension** — send binary to host. Formats: `\"png\"`, `\"jpg:0.8\"`, `\"webp:0.7\"`, `\"psd:true\"`, `\"svg:true\"` |\n| `clearHistory` | `()` | **Photopea extension** — clear undo history to free RAM |\n| `exportDocument` | `(file, exportType, options)` | Export to filesystem (triggers ZIP). ExportType: `SAVEFORWEB` |\n| `paste` | `(intoSelection)` | Paste clipboard into document |\n| `suspendHistory` | `(historyName, callback)` | Wrap multiple ops in one history state |\n\n**Practical examples:**\n```js\nvar doc = app.activeDocument;\n\n\u002F\u002F Resize image to 1920×1080 at 72dpi bicubic\ndoc.resizeImage(1920, 1080, 72, ResampleMethod.BICUBIC);\n\n\u002F\u002F Expand canvas to 2000px wide, keeping content centered\ndoc.resizeCanvas(2000, doc.height, AnchorPosition.MIDDLECENTER);\n\n\u002F\u002F Crop to a region\ndoc.crop([100, 100, 900, 600]);\n\n\u002F\u002F Trim transparent edges\ndoc.trim(TrimType.TRANSPARENT, true, true, true, true);\n\n\u002F\u002F Flip horizontal\ndoc.flipCanvas(Direction.HORIZONTAL);\n\n\u002F\u002F Change to grayscale\ndoc.changeMode(ChangeMode.GRAYSCALE);\n\n\u002F\u002F One undo step for many operations\ndoc.suspendHistory(\"Batch Edit\", \"action\");\n\u002F\u002F (Inside Photopea, all ops become one history state)\n\n\u002F\u002F Export PNG to filesystem (triggers ZIP download)\nvar opts = new ExportOptionsSaveForWeb();\nopts.format  = SaveDocumentType.PNG;\nopts.PNG8    = false;\nopts.quality = 100;\ndoc.exportDocument(new File(\"\u002Foutput.png\"), ExportType.SAVEFORWEB, opts);\n\n\u002F\u002F Close without saving\ndoc.close(SaveOptions.DONOTSAVECHANGES);\n```\n\n---\n\n## `Layers` \u002F `ArtLayers` \u002F `LayerSets` Collections\n\nThese collections exist on `Document`, `LayerSet` (groups within groups), and can be iterated.\n\n```js\nvar doc = app.activeDocument;\n\n\u002F\u002F Access\ndoc.layers          \u002F\u002F all top-level (art + groups)\ndoc.artLayers       \u002F\u002F top-level art layers only\ndoc.layerSets       \u002F\u002F top-level group layers only\n\n\u002F\u002F By index (0 = topmost)\ndoc.layers[0]\ndoc.layers[doc.layers.length - 1]  \u002F\u002F bottommost\n\n\u002F\u002F By name (throws if not found)\ndoc.layers.getByName(\"Background\")\ndoc.artLayers.getByName(\"Logo\")\ndoc.layerSets.getByName(\"Header Group\")\n\n\u002F\u002F Add\nvar newLayer  = doc.artLayers.add();         \u002F\u002F new blank art layer\nvar newGroup  = doc.layerSets.add();         \u002F\u002F new group\nvar innerLayer = newGroup.artLayers.add();   \u002F\u002F layer inside a group\n\n\u002F\u002F Remove\ndoc.artLayers.getByName(\"Temp\").remove();\n\n\u002F\u002F Iterate all layers recursively\nfunction walkLayers(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") walkLayers(l);\n    else \u002F* ArtLayer *\u002F processLayer(l);\n  }\n}\nwalkLayers(doc);\n```\n\n---\n\n## `ArtLayer` — Individual Layer\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `name` | string | R\u002FW | Layer name |\n| `visible` | boolean | R\u002FW | Layer visibility |\n| `opacity` | number | R\u002FW | Layer opacity 0–100 |\n| `fillOpacity` | number | R | Fill opacity 0–100 |\n| `blendMode` | BlendMode | R\u002FW | Blend mode (see enum below) |\n| `kind` | LayerKind | R\u002FW | Layer type (can set to `LayerKind.TEXT` on empty layer) |\n| `textItem` | TextItem | R | Text object (only when `kind === LayerKind.TEXT`) |\n| `bounds` | array | R | `[left, top, right, bottom]` in current ruler units |\n| `parent` | Document\u002FLayerSet | R | Containing object |\n| `typename` | string | R | Always `\"ArtLayer\"` |\n| `selected` | boolean | R | **Photopea extension** — is layer highlighted in panel |\n| `isBackgroundLayer` | boolean | R | Is this the locked background layer |\n| `grouped` | boolean | R | Is clipping mask applied |\n| `pixelsLocked` | boolean | R | Pixels locked |\n| `positionLocked` | boolean | R | Position locked |\n| `transparentPixelsLocked` | boolean | R | Transparent pixels locked |\n| `layerMaskDensity` | number | R | Layer mask density 0–100 |\n| `layerMaskFeather` | number | R | Layer mask feather 0–250 |\n| `vectorMaskDensity` | number | R | Vector mask density 0–100 |\n| `vectorMaskFeather` | number | R | Vector mask feather 0–250 |\n\n### Transform Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `translate` | `(deltaX, deltaY)` | Move layer by offset |\n| `rotate` | `(angle, anchor)` | Rotate by degrees. AnchorPosition optional (default center) |\n| `resize` | `(widthPct, heightPct, anchor)` | Scale as percentage of current size |\n| `rasterize` | `(target)` | Rasterize. RasterizeType: `ENTIRE`, `FILLCONTENT`, `LAYERCLIPPINGMASK`, `LINKEDLAYERS`, `SHAPE`, `TEXTCONTENTS`, `VECTORMASK` |\n\n### Layer Management Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `duplicate` | `()` | Duplicate to same document, returns new layer |\n| `duplicate` | `(doc, placement)` | Duplicate to another document |\n| `remove` | `()` | Delete the layer |\n| `merge` | `()` | Merge down; returns the merged ArtLayer |\n| `move` | `(relativeLayer, placement)` | Reorder. ElementPlacement: `PLACEBEFORE`, `PLACEAFTER`, `PLACEATBEGINNING`, `PLACEATEND`, `INSIDE` |\n| `copy` | `(merged)` | Copy to clipboard |\n| `cut` | `()` | Cut to clipboard |\n| `clear` | `()` | Cut without clipboard |\n\n### Adjustment Methods on ArtLayer\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `adjustBrightnessContrast` | `(brightness, contrast)` | Brightness -100–100, Contrast -100–100 |\n| `adjustColorBalance` | `(shadows, midtones, highlights, preserveLuminosity)` | Each is `[cyan-red, magenta-green, yellow-blue]` array |\n| `adjustCurves` | `(curveShape)` | Array of `[input,output]` pairs per channel |\n| `adjustLevels` | `(inputRangeStart, inputRangeEnd, gamma, outputRangeStart, outputRangeEnd)` | Levels adjustment |\n| `autoLevels` | `()` | Auto levels |\n| `autoContrast` | `()` | Auto contrast |\n| `desaturate` | `()` | Convert to grayscale values in current mode |\n| `equalize` | `()` | Equalize brightness distribution |\n| `invert` | `()` | Invert pixel colors |\n| `posterize` | `(levels)` | Posterize (2–255 levels) |\n| `threshold` | `(level)` | B&W threshold (1–255) |\n| `shadowHighlight` | `(shadowAmount, shadowWidth, shadowRadius, highlightAmount, highlightWidth, highlightRadius, colorCorrection, midtoneContrast, blackClip, whiteClip)` | Shadows\u002FHighlights |\n| `photoFilter` | `(fillColor, density, luminosity)` | Photo filter |\n| `mixChannels` | `(outputChannels, monochrome)` | Channel mixer |\n| `selectiveColor` | `(colors, cyan, magenta, yellow, black, method)` | Selective color |\n\n### Filter Methods on ArtLayer\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `applyGaussianBlur` | `(radius)` | Gaussian blur (0.1–250 px radius) |\n| `applyMotionBlur` | `(angle, distance)` | Motion blur |\n| `applyRadialBlur` | `(amount, blurMethod, blurQuality)` | Radial blur |\n| `applySmartBlur` | `(radius, threshold, blurQuality, blurMode)` | Smart blur |\n| `applyBlur` | `()` | Simple blur |\n| `applyBlurMore` | `()` | Blur more |\n| `applyUnSharpMask` | `(amount, radius, threshold)` | Unsharp mask |\n| `applySharpen` | `()` | Sharpen |\n| `applySharpenEdges` | `()` | Sharpen edges |\n| `applySharpenMore` | `()` | Sharpen more |\n| `applyAddNoise` | `(amount, distribution, monochromatic)` | Add noise. NoiseDistribution: `GAUSSIAN`, `UNIFORM` |\n| `applyDespeckle` | `()` | Despeckle |\n| `applyDustAndScratches` | `(radius, threshold)` | Dust and scratches |\n| `applyMedianNoise` | `(radius)` | Median noise reduction |\n| `applyMaximum` | `(radius)` | Maximum filter (dilate) |\n| `applyMinimum` | `(radius)` | Minimum filter (erode) |\n| `applyHighPass` | `(radius)` | High pass |\n| `applyOffset` | `(horizontal, vertical, undefinedAreas)` | Offset. UndefinedAreas: `SETTOBACKGROUND`, `WRAPAROUND`, `REPEATEDGEPIXELS` |\n| `applyRipple` | `(amount, size)` | Ripple. RippleSize: `SMALL`, `MEDIUM`, `LARGE` |\n| `applyWave` | `(generators, minWavelength, maxWavelength, minAmplitude, maxAmplitude, horizScale, vertScale, waveType, undefinedAreas, randomSeed)` | Wave filter |\n| `applyZigZag` | `(amount, ridges, style)` | Zig-Zag |\n| `applyTwirl` | `(angle)` | Twirl |\n| `applyPolarCoordinates` | `(conversion)` | Polar coordinates |\n| `applySpherize` | `(amount, mode)` | Spherize |\n| `applyPinch` | `(amount)` | Pinch (-100–100) |\n| `applyShear` | `(curve, undefinedAreas)` | Shear |\n| `applyDisplace` | `(horizontalScale, verticalScale, displacementType, undefinedAreas, displacementMapFile)` | Displace |\n| `applyClouds` | `()` | Render Clouds |\n| `applyDifferenceClouds` | `()` | Difference Clouds |\n| `applyLensFlare` | `(brightness, flareCenter, lensType)` | Lens Flare. LensType: `ZOOMWIDE, ZOOMNORMAL, MOVIE` |\n| `applyDiffuseGlow` | `(graininess, glowAmount, clearAmount)` | Diffuse Glow |\n| `applyGlassEffect` | `(distortion, smoothness, scaling, invert, texture, textureFile)` | Glass |\n| `applyOceanRipple` | `(size, magnitude)` | Ocean Ripple |\n| `applyLensBlur` | `(source, focalDistance, invertDepthMap, shape, radius, bladeCurvature, rotation, brightness, threshold, amount, distribution, monochromatic)` | Lens Blur |\n| `applyAverage` | `()` | Average blur |\n| `applyDeInterlace` | `(eliminateFields, createFields)` | De-interlace |\n| `applyNTSC` | `()` | NTSC colors |\n| `applyCustomFilter` | `(characteristics, scale, offset)` | Custom filter (5×5 matrix) |\n| `applyTextureFill` | `(textureFile)` | Texture fill |\n| `applyStyle` | `(styleName)` | Apply a layer style preset by name |\n| `photoFilter` | `(fillColor, density, luminosity)` | Photo Filter |\n\n**Practical examples:**\n```js\nvar layer = app.activeDocument.activeLayer;\n\n\u002F\u002F Move to absolute position (layer.bounds[0] = current left edge)\nlayer.translate(200 - layer.bounds[0], 100 - layer.bounds[1]);\n\n\u002F\u002F Rotate 45° around center\nlayer.rotate(45);\n\n\u002F\u002F Scale to 50% keeping center\nlayer.resize(50, 50, AnchorPosition.MIDDLECENTER);\n\n\u002F\u002F Gaussian blur radius 10\nlayer.applyGaussianBlur(10);\n\n\u002F\u002F Unsharp mask\nlayer.applyUnSharpMask(50, 2, 0);\n\n\u002F\u002F Levels: input 0–200, gamma 1.2, output 0–255\nlayer.adjustLevels(0, 200, 1.2, 0, 255);\n\n\u002F\u002F Brightness +20, Contrast +10\nlayer.adjustBrightnessContrast(20, 10);\n\n\u002F\u002F Invert\nlayer.invert();\n\n\u002F\u002F Rasterize text\nlayer.rasterize(RasterizeType.TEXTCONTENTS);\n\n\u002F\u002F Duplicate layer\nvar copy = layer.duplicate();\ncopy.name = \"Layer Copy\";\n\n\u002F\u002F Move layer below another\nvar target = doc.layers.getByName(\"Background\");\nlayer.move(target, ElementPlacement.PLACEAFTER);\n```\n\n---\n\n## `LayerSet` — Group Layer\n\nA LayerSet is a folder\u002Fgroup in the Layers panel. It has the same layer management methods as `Document`.\n\n### Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `name` | string | R\u002FW | Group name |\n| `visible` | boolean | R\u002FW | Group visibility |\n| `opacity` | number | R\u002FW | Group opacity 0–100 |\n| `blendMode` | BlendMode | R\u002FW | Group blend mode |\n| `bounds` | array | R | Bounding box `[left,top,right,bottom]` |\n| `layers` | Layers | R | All layers inside this group |\n| `artLayers` | ArtLayers | R | Art layers inside this group |\n| `layerSets` | LayerSets | R | Sub-groups inside this group |\n| `parent` | Document\u002FLayerSet | R | Parent container |\n| `typename` | string | R | Always `\"LayerSet\"` |\n\n### Methods\nSame as Document for layer management: `layers.add()`, `artLayers.add()`, `layerSets.add()`, `.getByName()`, plus `duplicate()`, `remove()`, `move()`.\n\n```js\n\u002F\u002F Create group with layers inside\nvar group = doc.layerSets.add();\ngroup.name = \"Product Card\";\n\nvar bgLayer   = group.artLayers.add(); bgLayer.name = \"Background\";\nvar textLayer = group.artLayers.add(); textLayer.kind = LayerKind.TEXT;\ntextLayer.textItem.contents = \"Buy Now\";\ntextLayer.textItem.size     = 36;\n\n\u002F\u002F Collapse\u002Fexpand group (Photopea specific, not in standard DOM)\n\u002F\u002F Use visibility as workaround\n\n\u002F\u002F Get specific layer inside a group\nvar innerLayer = doc.layerSets.getByName(\"Header Group\").artLayers.getByName(\"Title\");\n```\n\n---\n\n## `TextItem` — Text Layer Content\n\nAccess via `layer.textItem` on any layer with `layer.kind === LayerKind.TEXT`.\n\n### Core Properties (most commonly used)\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `contents` | string | R\u002FW | The actual text content |\n| `font` | string | R\u002FW | Font PostScript name (e.g. `\"ArialMT\"`, `\"Verdana-Bold\"`) |\n| `size` | number | R\u002FW | Font size in points |\n| `color` | SolidColor | R\u002FW | Text color |\n| `position` | array | R\u002FW | `[x, y]` origin of text (point text) or bounding box top-left |\n| `justification` | Justification | R\u002FW | `Justification.LEFT`, `CENTER`, `RIGHT`, `FULLJUSTIFY` |\n| `kind` | TextType | R\u002FW | `TextType.POINTTEXT` or `TextType.PARAGRAPHTEXT` |\n| `width` | number | R\u002FW | Width of bounding box (paragraph text only) |\n| `height` | number | R\u002FW | Height of bounding box (paragraph text only) |\n| `direction` | Direction | R\u002FW | `Direction.HORIZONTAL` or `Direction.VERTICAL` |\n\n### Typography Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `leading` | number | R\u002FW | Line spacing in points |\n| `tracking` | number | R\u002FW | Letter spacing -1000–10000 (1000 = 1 em) |\n| `horizontalScale` | number | R\u002FW | Horizontal scaling 0–1000% |\n| `verticalScale` | number | R\u002FW | Vertical scaling 0–1000% |\n| `baselineShift` | number | R\u002FW | Baseline offset in points |\n| `capitalization` | Case | R\u002FW | `Case.NORMAL`, `ALLCAPS`, `SMALLCAPS` |\n| `fauxBold` | boolean | R\u002FW | Simulated bold |\n| `fauxItalic` | boolean | R\u002FW | Simulated italic |\n| `underline` | UnderlineType | R\u002FW | `UnderlineType.NONE`, `UNDERLINELEFT`, `UNDERLINERIGHT` |\n| `strikeThru` | StrikeThruType | R\u002FW | `StrikeThruType.NONE`, `STRIKEBOX`, `STRIKEHEIGHT` |\n| `antiAliasMethod` | AntiAlias | R\u002FW | `AntiAlias.NONE`, `SHARP`, `CRISP`, `STRONG`, `SMOOTH` |\n| `autoKerning` | AutoKernType | R\u002FW | `AutoKernType.MANUAL`, `METRICS`, `OPTICAL` |\n| `language` | Language | R\u002FW | `Language.ENGLISH`, etc. |\n| `ligatures` | boolean | R\u002FW | Enable ligatures |\n| `alternateLigatures` | boolean | R\u002FW | Enable alternate ligatures |\n| `oldStyle` | boolean | R\u002FW | Old-style numerals |\n| `noBreak` | boolean | R\u002FW | Prevent line breaks in this text |\n| `useAutoLeading` | boolean | R\u002FW | Use font's built-in leading |\n| `autoLeadingAmount` | number | R\u002FW | Auto leading percentage 0.01–5000 |\n| `hyphenation` | boolean | R\u002FW | Enable hyphenation |\n\n### Paragraph Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `leftIndent` | number | R\u002FW | Left indent -1296–1296 |\n| `rightIndent` | number | R\u002FW | Right indent -1296–1296 |\n| `firstLineIndent` | number | R\u002FW | First line indent -1296–1296 |\n| `spaceBefore` | number | R\u002FW | Space before paragraph -1296–1296 |\n| `spaceAfter` | number | R\u002FW | Space after paragraph -1296–1296 |\n| `hangingPuntuation` | boolean | R\u002FW | Roman hanging punctuation |\n| `textComposer` | TextComposer | R\u002FW | `TextComposer.ADOBEEVERYLINE`, `ADOBESINGLELINE` |\n\n### Warp Properties\n\n| Property | Type | R\u002FW | Description |\n|----------|------|-----|-------------|\n| `warpStyle` | WarpStyle | R\u002FW | `WarpStyle.NONE`, `ARC`, `ARCH`, `BULGE`, `SHELLLOWER`, `SHELLUPPER`, `FLAG`, `WAVE`, `FISH`, `RISE`, `FISHEYE`, `INFLATE`, `SQUEEZE`, `TWIST` |\n| `warpDirection` | Direction | R\u002FW | `Direction.HORIZONTAL` or `Direction.VERTICAL` |\n| `warpBend` | number | R\u002FW | Warp bend -100–100 |\n| `warpHorizontalDistortion` | number | R\u002FW | Horizontal distortion -100–100 |\n| `warpVerticalDistortion` | number | R\u002FW | Vertical distortion -100–100 |\n\n### Photopea Extensions\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `totalTextStyle` | string | JSON string with ALL style parameters of the text |\n| `transform` | string | JSON array — the affine transform matrix of the text |\n\n### Methods\n\n| Method | Description |\n|--------|-------------|\n| `convertToShape()` | Convert text to a filled shape layer with text as clipping path |\n| `createPath()` | Create work path from text outlines |\n\n**Practical examples:**\n```js\nvar layer = doc.layers.getByName(\"Headline\");\nvar text  = layer.textItem;\n\n\u002F\u002F Set content\ntext.contents = \"Hello World\";\n\n\u002F\u002F Style\ntext.font   = \"Verdana-Bold\";\ntext.size   = 72;\ntext.color.rgb.hexValue = \"FF0000\";    \u002F\u002F red\n\n\u002F\u002F Position point text at (50, 100)\ntext.position = [50, 100];\n\n\u002F\u002F Center align\ntext.justification = Justification.CENTER;\n\n\u002F\u002F Paragraph text with bounding box\ntext.kind   = TextType.PARAGRAPHTEXT;\ntext.width  = new UnitValue(\"400 pixels\");\ntext.height = new UnitValue(\"200 pixels\");\n\n\u002F\u002F Letter spacing\ntext.tracking = 100;   \u002F\u002F 10% spacing\n\n\u002F\u002F Scale text horizontally to 80%\ntext.horizontalScale = 80;\n\n\u002F\u002F Warp arc\ntext.warpStyle = WarpStyle.ARC;\ntext.warpBend  = 30;\n\n\u002F\u002F Read all text styles as JSON (Photopea extension)\nvar styles = JSON.parse(text.totalTextStyle);\napp.echoToOE(JSON.stringify(styles));\n```\n\n---\n\n## Creating a Text Layer from Scratch\n\n```js\napp.preferences.rulerUnits = Units.PIXELS;\n\nvar layer = doc.artLayers.add();\nlayer.kind = LayerKind.TEXT;      \u002F\u002F Convert blank layer to text\nlayer.name = \"My Title\";\n\nvar text = layer.textItem;\ntext.contents      = \"Welcome\";\ntext.font          = \"ArialMT\";\ntext.size          = 48;\ntext.justification = Justification.CENTER;\ntext.position      = [doc.width \u002F 2, 100];\n\nvar color = new SolidColor();\ncolor.rgb.red   = 255;\ncolor.rgb.green = 255;\ncolor.rgb.blue  = 255;\ntext.color = color;\n```\n\n---\n\n## `SolidColor` — Color Object\n\n```js\n\u002F\u002F RGB (most common in Photopea)\nvar c = new SolidColor();\nc.rgb.red   = 255;      \u002F\u002F 0–255\nc.rgb.green = 128;\nc.rgb.blue  = 0;\nc.rgb.hexValue = \"FF8000\";   \u002F\u002F Set via hex string (no #)\n\n\u002F\u002F CMYK\nvar c2 = new SolidColor();\nc2.cmyk.cyan    = 0;    \u002F\u002F 0–100\nc2.cmyk.magenta = 50;\nc2.cmyk.yellow  = 100;\nc2.cmyk.black   = 0;\n\n\u002F\u002F Grayscale\nvar c3 = new SolidColor();\nc3.gray.gray = 50;    \u002F\u002F 0–100\n\n\u002F\u002F HSB\nvar c4 = new SolidColor();\nc4.hsb.hue        = 30;    \u002F\u002F 0–360\nc4.hsb.saturation = 100;   \u002F\u002F 0–100\nc4.hsb.brightness = 100;   \u002F\u002F 0–100\n\n\u002F\u002F Lab\nvar c5 = new SolidColor();\nc5.lab.l = 50;   \u002F\u002F 0–100\nc5.lab.a = 20;   \u002F\u002F -128–127\nc5.lab.b = 40;   \u002F\u002F -128–127\n\n\u002F\u002F Set as foreground color\napp.foregroundColor = c;\n\n\u002F\u002F Use with selection fill\ndoc.selection.selectAll();\ndoc.selection.fill(c);\ndoc.selection.deselect();\n```\n\n---\n\n## `Selection` — Selection Object\n\nAccess via `doc.selection`.\n\n### Properties\n\n| Property | Type | Description |\n|----------|------|-------------|\n| `bounds` | array | `[left, top, right, bottom]` bounding rectangle |\n| `solid` | boolean | Whether selection is a solid rectangle |\n\n### Methods\n\n| Method | Signature | Description |\n|--------|-----------|-------------|\n| `selectAll` | `()` | Select entire document |\n| `deselect` | `()` | Remove selection |\n| `invert` | `()` | Invert the selection |\n| `select` | `(region, type, feather, antiAlias)` | Select polygon region. Region is array of `[x,y]` points. SelectionType: `REPLACE`, `ADD`, `SUBTRACT`, `INTERSECT` |\n| `feather` | `(radius)` | Feather the selection edges |\n| `contract` | `(radius)` | Contract (shrink) selection |\n| `expand` | `(radius)` | Expand selection |\n| `grow` | `(tolerance, antiAlias)` | Grow selection to similar adjacent pixels |\n| `similar` | `(tolerance, antiAlias)` | Select similar pixels throughout document |\n| `smooth` | `(radius)` | Smooth selection edges |\n| `selectBorder` | `(width)` | Select only the border of the current selection |\n| `resize` | `(widthPct, heightPct, anchor)` | Resize selection boundary |\n| `rotate` | `(angle, anchor)` | Rotate selection boundary |\n| `translate` | `(deltaX, deltaY)` | Move selection boundary |\n| `fill` | `(fillWith, mode, opacity, preserveTransparency)` | Fill selection with color or content. fillWith is SolidColor or string |\n| `stroke` | `(strokeColor, width, location, mode, opacity, preserveTransparency)` | Stroke selection border. StrokeLocation: `INSIDE`, `OUTSIDE`, `CENTER` |\n| `copy` | `(merged)` | Copy selection to clipboard |\n| `cut` | `()` | Cut selection to clipboard |\n| `clear` | `()` | Delete selection content |\n| `load` | `(from, type, invert)` | Load selection from channel |\n| `store` | `(into, type)` | Save selection as channel |\n| `makeWorkPath` | `(tolerance)` | Convert to work path |\n\n**Practical examples:**\n```js\nvar sel = doc.selection;\n\n\u002F\u002F Rectangle select (top-left to bottom-right)\nsel.select([[0,0],[500,0],[500,300],[0,300]]);\n\n\u002F\u002F Select all\nsel.selectAll();\n\n\u002F\u002F Add to existing selection\nsel.select([[600,0],[900,0],[900,300],[600,300]], SelectionType.ADD);\n\n\u002F\u002F Feather 10px\nsel.feather(10);\n\n\u002F\u002F Contract by 5px\nsel.contract(5);\n\n\u002F\u002F Fill with red\nvar red = new SolidColor();\nred.rgb.red = 255; red.rgb.green = 0; red.rgb.blue = 0;\nsel.fill(red);\n\n\u002F\u002F Stroke selection with black, 3px, inside\nvar black = new SolidColor();\nblack.rgb.hexValue = \"000000\";\nsel.stroke(black, 3, StrokeLocation.INSIDE);\n\n\u002F\u002F Copy, paste as new layer\nsel.copy();\ndoc.paste();\n\n\u002F\u002F Invert and delete (remove background)\nsel.invert();\nsel.clear();\nsel.deselect();\n```\n\n---\n\n## `BlendMode` Enum — All Values\n\nUsed in `layer.blendMode` (string form in Photopea) and `BlendMode` constant (standard):\n\n| `BlendMode` Constant | Photopea String | Name |\n|----------------------|-----------------|------|\n| `BlendMode.NORMAL` | `\"norm\"` | Normal |\n| `BlendMode.DISSOLVE` | `\"diss\"` | Dissolve |\n| `BlendMode.DARKEN` | `\"dark\"` | Darken |\n| `BlendMode.MULTIPLY` | `\"mul \"` | Multiply |\n| `BlendMode.COLORBURN` | `\"idiv\"` | Color Burn |\n| `BlendMode.LINEARBURN` | `\"lbrn\"` | Linear Burn |\n| `BlendMode.DARKERCOLOR` | `\"dkCl\"` | Darker Color |\n| `BlendMode.LIGHTEN` | `\"lite\"` | Lighten |\n| `BlendMode.SCREEN` | `\"scrn\"` | Screen |\n| `BlendMode.COLORDODGE` | `\"div \"` | Color Dodge |\n| `BlendMode.LINEARDODGE` | `\"lddg\"` | Linear Dodge (Add) |\n| `BlendMode.LIGHTERCOLOR` | `\"lgCl\"` | Lighter Color |\n| `BlendMode.OVERLAY` | `\"over\"` | Overlay |\n| `BlendMode.SOFTLIGHT` | `\"sLit\"` | Soft Light |\n| `BlendMode.HARDLIGHT` | `\"hLit\"` | Hard Light |\n| `BlendMode.VIVIDLIGHT` | `\"vLit\"` | Vivid Light |\n| `BlendMode.LINEARLIGHT` | `\"lLit\"` | Linear Light |\n| `BlendMode.PINLIGHT` | `\"pLit\"` | Pin Light |\n| `BlendMode.HARDMIX` | `\"hMix\"` | Hard Mix |\n| `BlendMode.DIFFERENCE` | `\"diff\"` | Difference |\n| `BlendMode.EXCLUSION` | `\"smud\"` | Exclusion |\n| `BlendMode.SUBTRACT` | `\"fsub\"` | Subtract |\n| `BlendMode.DIVIDE` | `\"fdiv\"` | Divide |\n| `BlendMode.HUE` | `\"hue \"` | Hue |\n| `BlendMode.SATURATION` | `\"sat \"` | Saturation |\n| `BlendMode.COLOR` | `\"colr\"` | Color |\n| `BlendMode.LUMINOSITY` | `\"lum \"` | Luminosity |\n| `BlendMode.PASSTHROUGH` | `\"pass\"` | Pass Through (groups only) |\n\n```js\n\u002F\u002F Use either form:\nlayer.blendMode = BlendMode.SCREEN;     \u002F\u002F constant\nlayer.blendMode = \"scrn\";               \u002F\u002F string (Photopea internal form)\n```\n\n---\n\n## `LayerKind` Enum\n\n| Constant | Description |\n|----------|-------------|\n| `LayerKind.NORMAL` | Regular pixel layer |\n| `LayerKind.TEXT` | Text layer |\n| `LayerKind.SMARTOBJECT` | Smart Object \u002F linked layer |\n| `LayerKind.SOLIDFILL` | Solid color fill layer |\n| `LayerKind.GRADIENTFILL` | Gradient fill layer |\n| `LayerKind.PATTERNFILL` | Pattern fill layer |\n| `LayerKind.BRIGHTNESSCONTRAST` | Brightness\u002FContrast adjustment layer |\n| `LayerKind.CURVES` | Curves adjustment layer |\n| `LayerKind.LEVELS` | Levels adjustment layer |\n| `LayerKind.HUESATURATION` | Hue\u002FSaturation adjustment layer |\n| `LayerKind.COLORBALANCE` | Color Balance adjustment layer |\n| `LayerKind.CHANNELMIXER` | Channel Mixer adjustment layer |\n| `LayerKind.GRADIENTMAP` | Gradient Map adjustment layer |\n| `LayerKind.INVERSION` | Invert adjustment layer |\n| `LayerKind.POSTERIZE` | Posterize adjustment layer |\n| `LayerKind.THRESHOLD` | Threshold adjustment layer |\n| `LayerKind.SELECTIVECOLOR` | Selective Color adjustment layer |\n| `LayerKind.PHOTOFILTER` | Photo Filter adjustment layer |\n| `LayerKind.EXPOSURE` | Exposure adjustment layer |\n| `LayerKind.VIBRANCE` | Vibrance adjustment layer |\n| `LayerKind.COLORLOOKUP` | Color Lookup adjustment layer |\n| `LayerKind.LAYER3D` | 3D layer (not generally useful in Photopea) |\n| `LayerKind.VIDEO` | Video layer |\n\n```js\n\u002F\u002F Identify layer type\nvar layer = doc.activeLayer;\nif (layer.kind === LayerKind.TEXT)         \u002F* text layer *\u002F;\nif (layer.kind === LayerKind.SMARTOBJECT)  \u002F* smart object *\u002F;\nif (layer.typename === \"LayerSet\")         \u002F* group *\u002F;\n\n\u002F\u002F Filter: collect all text layers recursively\nvar textLayers = [];\nfunction collectText(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") collectText(l);\n    else if (l.kind === LayerKind.TEXT) textLayers.push(l);\n  }\n}\ncollectText(doc);\n```\n\n---\n\n## `AnchorPosition` Enum\n\n| Constant | Position |\n|----------|----------|\n| `AnchorPosition.TOPLEFT` | Top left |\n| `AnchorPosition.TOPCENTER` | Top center |\n| `AnchorPosition.TOPRIGHT` | Top right |\n| `AnchorPosition.MIDDLELEFT` | Middle left |\n| `AnchorPosition.MIDDLECENTER` | Center |\n| `AnchorPosition.MIDDLERIGHT` | Middle right |\n| `AnchorPosition.BOTTOMLEFT` | Bottom left |\n| `AnchorPosition.BOTTOMCENTER` | Bottom center |\n| `AnchorPosition.BOTTOMRIGHT` | Bottom right |\n\n---\n\n## `ElementPlacement` Enum\n\nUsed with `layer.move(relativeObject, placement)`:\n\n| Constant | Effect |\n|----------|--------|\n| `ElementPlacement.PLACEBEFORE` | Above the target layer in the panel |\n| `ElementPlacement.PLACEAFTER` | Below the target layer in the panel |\n| `ElementPlacement.PLACEATBEGINNING` | Top of the layer stack |\n| `ElementPlacement.PLACEATEND` | Bottom of the layer stack |\n| `ElementPlacement.INSIDE` | Into a LayerSet (makes layer a child) |\n\n---\n\n## `ResampleMethod` Enum\n\nUsed with `doc.resizeImage()`:\n\n| Constant | Description |\n|----------|-------------|\n| `ResampleMethod.BICUBIC` | High quality, good for smooth gradients |\n| `ResampleMethod.BICUBICSHARPER` | Best for reduction |\n| `ResampleMethod.BICUBICSMOOTHER` | Best for enlargement |\n| `ResampleMethod.BILINEAR` | Medium quality |\n| `ResampleMethod.NEARESTNEIGHBOR` | No anti-aliasing, fastest |\n| `ResampleMethod.NONE` | No resampling (change resolution only) |\n\n---\n\n## `SaveOptions` Enum\n\nUsed with `doc.close(saveOption)`:\n\n| Constant | Meaning |\n|----------|---------|\n| `SaveOptions.DONOTSAVECHANGES` | Discard all changes and close |\n| `SaveOptions.SAVECHANGES` | Save then close |\n| `SaveOptions.PROMPTTOSAVECHANGES` | Show dialog (may block in headless) |\n\n---\n\n## `ExportOptionsSaveForWeb` — Export to Filesystem\n\nUsed with `doc.exportDocument()` to write files that Photopea packages into a ZIP.\n\n```js\n\u002F\u002F Export PNG\nvar pngOpts = new ExportOptionsSaveForWeb();\npngOpts.format      = SaveDocumentType.PNG;\npngOpts.PNG8        = false;    \u002F\u002F PNG-24\npngOpts.quality     = 100;\npngOpts.transparency = true;\ndoc.exportDocument(new File(\"\u002Fexport.png\"), ExportType.SAVEFORWEB, pngOpts);\n\n\u002F\u002F Export JPEG\nvar jpgOpts = new ExportOptionsSaveForWeb();\njpgOpts.format  = SaveDocumentType.JPEG;\njpgOpts.quality = 80;    \u002F\u002F 0–100\ndoc.exportDocument(new File(\"\u002Fexport.jpg\"), ExportType.SAVEFORWEB, jpgOpts);\n\n\u002F\u002F Export GIF\nvar gifOpts = new ExportOptionsSaveForWeb();\ngifOpts.format     = SaveDocumentType.GIF;\ngifOpts.colors     = 256;\ngifOpts.dither     = 100;\ngifOpts.transparency = true;\ndoc.exportDocument(new File(\"\u002Fexport.gif\"), ExportType.SAVEFORWEB, gifOpts);\n```\n\n---\n\n## `executeAction` — Advanced Operations\n\nUsed for operations not exposed in the standard DOM (adjustments applied as adjustment layers,\nSmart Object editing, etc.). Takes the Photoshop Action Manager approach.\n\n```js\n\u002F\u002F Open Smart Object for editing\nvar l = doc.layers.getByName(\"SmartObj\");\ndoc.activeLayer = l;\nexecuteAction(stringIDToTypeID(\"placedLayerEditContents\"));\n\u002F\u002F Smart Object is now the active document\ndoc.activeLayer.rotate(90);\ndoc.save();\ndoc.close();\n\n\u002F\u002F Apply Hue\u002FSaturation as destructive adjustment\nvar desc = new ActionDescriptor();\nvar list = new ActionList();\nvar channel = new ActionDescriptor();\nchannel.putEnumerated(stringIDToTypeID(\"presetKind\"), stringIDToTypeID(\"presetKindType\"), stringIDToTypeID(\"presetKindDefault\"));\nchannel.putInteger(stringIDToTypeID(\"hue\"),        20);   \u002F\u002F hue shift\nchannel.putInteger(stringIDToTypeID(\"saturation\"), 30);   \u002F\u002F saturation\nchannel.putInteger(stringIDToTypeID(\"lightness\"),  0);\nlist.putObject(stringIDToTypeID(\"hueSaturationAdjustmentV2Layer\"), channel);\ndesc.putList(stringIDToTypeID(\"adjustment\"), list);\nexecuteAction(stringIDToTypeID(\"hueSaturation\"), desc, DialogModes.NO);\n\n\u002F\u002F Select a layer by name using AM\nfunction selectLayerByName(name) {\n  var desc = new ActionDescriptor();\n  var ref  = new ActionReference();\n  ref.putName(charIDToTypeID(\"Lyr \"), name);\n  desc.putReference(charIDToTypeID(\"null\"), ref);\n  desc.putBoolean(charIDToTypeID(\"MkVs\"), false);\n  executeAction(charIDToTypeID(\"slct\"), desc, DialogModes.NO);\n}\n```\n\n---\n\n## Complete Practical Script Examples\n\n### 1. Rename all text layers based on their contents\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc = app.activeDocument;\n\nfunction processLayers(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") processLayers(l);\n    else if (l.kind === LayerKind.TEXT) {\n      l.name = l.textItem.contents.substring(0, 30);\n    }\n  }\n}\nprocessLayers(doc);\napp.echoToOE(\"done\");\n```\n\n### 2. Export each layer as a separate PNG\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc = app.activeDocument;\n\nfor (var i = 0; i \u003C doc.layers.length; i++) {\n  \u002F\u002F Hide all layers\n  for (var j = 0; j \u003C doc.layers.length; j++) doc.layers[j].visible = false;\n  \u002F\u002F Show only this layer\n  doc.layers[i].visible = true;\n  \u002F\u002F Export\n  var opts = new ExportOptionsSaveForWeb();\n  opts.format  = SaveDocumentType.PNG;\n  opts.PNG8    = false;\n  opts.quality = 100;\n  doc.exportDocument(\n    new File(\"\u002F\" + doc.layers[i].name + \".png\"),\n    ExportType.SAVEFORWEB, opts\n  );\n}\n\n\u002F\u002F Restore visibility\nfor (var i = 0; i \u003C doc.layers.length; i++) doc.layers[i].visible = true;\n```\n\n### 3. Find and replace text across all text layers\n```js\nvar searchText   = \"2024\";\nvar replaceText  = \"2025\";\n\nfunction findReplaceText(parent) {\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    if (l.typename === \"LayerSet\") findReplaceText(l);\n    else if (l.kind === LayerKind.TEXT) {\n      var t = l.textItem;\n      if (t.contents.indexOf(searchText) !== -1) {\n        t.contents = t.contents.split(searchText).join(replaceText);\n      }\n    }\n  }\n}\nfindReplaceText(app.activeDocument);\napp.echoToOE(\"Find & Replace complete\");\n```\n\n### 4. Grid of duplicate layers\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc   = app.activeDocument;\nvar layer = doc.activeLayer;\nvar cols  = 4, rows = 3;\nvar padX  = 20, padY = 20;\nvar w = layer.bounds[2] - layer.bounds[0];\nvar h = layer.bounds[3] - layer.bounds[1];\n\nfor (var r = 0; r \u003C rows; r++) {\n  for (var c = 0; c \u003C cols; c++) {\n    if (r === 0 && c === 0) continue; \u002F\u002F skip original\n    var copy = layer.duplicate();\n    var targetX = layer.bounds[0] + c * (w + padX);\n    var targetY = layer.bounds[1] + r * (h + padY);\n    copy.translate(targetX - copy.bounds[0], targetY - copy.bounds[1]);\n    copy.opacity = 100 - (r * cols + c) * 5;\n  }\n}\n```\n\n### 5. Apply watermark from URL\n```js\napp.preferences.rulerUnits = Units.PIXELS;\nvar doc = app.activeDocument;\n\n\u002F\u002F Open watermark as smart object layer\napp.open(\"https:\u002F\u002Fexample.com\u002Fwatermark.png\", null, true);\nvar wm = doc.activeLayer;\n\n\u002F\u002F Resize to 20% of document width\nvar wmW = wm.bounds[2] - wm.bounds[0];\nvar targetW = doc.width * 0.2;\nvar scalePct = (targetW \u002F wmW) * 100;\nwm.resize(scalePct, scalePct, AnchorPosition.TOPLEFT);\n\n\u002F\u002F Move to bottom-right with 20px margin\nvar wmNewW = wm.bounds[2] - wm.bounds[0];\nvar wmNewH = wm.bounds[3] - wm.bounds[1];\nwm.translate(\n  doc.width  - wmNewW - 20 - wm.bounds[0],\n  doc.height - wmNewH - 20 - wm.bounds[1]\n);\nwm.opacity = 60;\napp.echoToOE(\"watermark applied\");\n```\n\n### 6. Get all layer info as JSON\n```js\nfunction getLayerInfo(parent, depth) {\n  depth = depth || 0;\n  var result = [];\n  for (var i = 0; i \u003C parent.layers.length; i++) {\n    var l = parent.layers[i];\n    var info = {\n      name:    l.name,\n      type:    l.typename,\n      visible: l.visible,\n      opacity: l.opacity,\n      depth:   depth\n    };\n    if (l.typename === \"ArtLayer\") {\n      info.kind   = l.kind.toString();\n      info.bounds = [l.bounds[0], l.bounds[1], l.bounds[2], l.bounds[3]];\n      if (l.kind === LayerKind.TEXT) {\n        info.text = l.textItem.contents;\n        info.font = l.textItem.font;\n        info.size = l.textItem.size;\n      }\n    } else if (l.typename === \"LayerSet\") {\n      info.children = getLayerInfo(l, depth + 1);\n    }\n    result.push(info);\n  }\n  return result;\n}\napp.echoToOE(JSON.stringify(getLayerInfo(app.activeDocument)));\n```\n\n---\n\n## Common Mistakes & Gotchas\n\n| Problem | Cause | Fix |\n|---------|-------|-----|\n| `createEmbed` never resolves | Container has no size | Add `width` + `height` CSS to the container `\u003Cdiv>` |\n| `runScript` returns `[\"done\"]` with no data | No `echoToOE` in script | Add `app.echoToOE(value)` for anything you want back |\n| `result[0]` is `\"done\"`, not the expected value | `echoToOE` not reached | Check script logic for early exit or errors |\n| Images won't load (network error) | CORS | Server must respond with `Access-Control-Allow-Origin: *` |\n| `openFromURL(url, true)` layer not ready | Async loading lag | Use `addImageAndWait` utility |\n| `exportImage` only PNG\u002FJPG | `exportImage` limitation | Use `runScript(\"saveToOE('webp:0.85')\")` for other formats |\n| Pixel coordinates behave unexpectedly | Wrong ruler units | Always set `app.preferences.rulerUnits = Units.PIXELS` first |\n| Text `size` set but looks different | Wrong type units | Set `app.preferences.typeUnits = TypeUnits.PIXELS` |\n| Layer not found by name | Wrong layer level | Layers are scoped; use recursive search for nested layers |\n| `layer.bounds[0]` returns a UnitValue, not number | Ruler units issue | Force `Units.PIXELS` before reading bounds |\n| Smart Object edit hangs | Missing `doc.save(); doc.close()` | Always save + close when done editing SO |\n| React double-mount in dev | Strict Mode | Use `if (peaRef.current) return` guard in `useEffect` |\n\n---\n\n## Limitations\n\n- This skill covers host-page integration patterns; it does not replace Photopea's own terms, API documentation, or licensing guidance.\n- Remote URL loading depends on browser CORS behavior, network availability, and the user's Photopea account\u002Fsession state.\n- `runScript` executes scripts inside the embedded Photopea document context. Only run scripts you understand and only with user-approved files.\n- Serialize dynamic values with `JSON.stringify` before embedding them in a `runScript` string. Never concatenate user-provided URLs, layer names, or text directly into Photopea script source.\n- Export behavior can vary by document size, browser memory limits, and the formats supported by the active Photopea runtime.\n\n---\n\n## Sources\n\n- photopea.js: https:\u002F\u002Fgithub.com\u002Fyikuansun\u002FPhotopeaAPI\n- npm: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fphotopea\n- Photopea Live Messaging API: https:\u002F\u002Fwww.photopea.com\u002Fapi\u002Flive\n- Photopea Script reference: https:\u002F\u002Fwww.photopea.com\u002Flearn\u002Fscripts\n- Photoshop JS Scripting reference (compatible): https:\u002F\u002Ftheiviaxx.github.io\u002Fphotoshop-docs\u002FPhotoshop\u002Findex.html\n- Plugin dev gists (addImageAndWait, getDocumentAsImage): https:\u002F\u002Fgist.github.com\u002Fyikuansun\u002Fc0f1a602b4e9d4e344a41c4f49ded3bf\n",{"name":5,"risk":24,"source":25,"license":15,"date_added":26,"description":7,"source_repo":27,"source_type":25,"license_source":28},"safe","community",1779235200000,"yikuansun\u002FPhotopeaAPI","https:\u002F\u002Fgithub.com\u002Fyikuansun\u002FPhotopeaAPI\u002Fblob\u002Fmaster\u002FLICENSE","main","a4404a75dc81d6b7e58c5906b6aaffbcb5e84747","Claude\u002Fantigravity skills\u002Fagentic-awesome-skills\u002Fskills\u002Fphotopea-embedded-editor",0,"https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills","https:\u002F\u002Fgithub.com\u002FMHassan0000","https:\u002F\u002Fhassanyousaf.vercel.app","Full Stack Developer building web apps, SaaS, AI systems, and automations. Passionate about clean code, UI\u002FUX, backend systems, and turning ideas into products.","2026-08-07 20:42:05",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add MHassan0000\u002FSkills --skill photopea-embedded-editor",{"tool":44,"command":45},"bunx","bunx skills add MHassan0000\u002FSkills --skill photopea-embedded-editor",{"tool":47,"command":48},"pnpm","pnpm dlx skills add MHassan0000\u002FSkills --skill photopea-embedded-editor","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fantigravity skills\u002Fagentic-awesome-skills\u002Fskills\u002Fphotopea-embedded-editor\u002FSKILL.md",true,[],[53,60,67,74,83,91],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7AGBX58S04DX8DKKME8N311","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fskills boraztunc github\u002Fvercel-react-best-practices\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7AGBREE890608Z7YDMAKH27","stop-slop","Remove AI writing patterns from prose. Use when drafting, editing, or reviewing text to eliminate predictable AI tells and produce more human-like writing.","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fskills boraztunc github\u002Fstop-slop\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7AGAS972A2AN7Q5EW8HEAXK","ogilvy-copywriting","Apply David Ogilvy's advertising principles when writing or reviewing copy, headlines, product descriptions, landing pages, ads, emails, or any persuasive text. Use when the goal is copy that sells, not copy that wins awards. Covers positioning, headlines, promises, brand voice, long-form copy, and visual logic. Source: How to Create Advertising That Sells (1972) + Ogilvy on Advertising.","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fskills boraztunc github\u002Fogilvy\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":79,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7AGAF12803G5JPVMK79AYJB","frontend-design","Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML\u002FCSS layouts, or when styling\u002Fbeautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fskills boraztunc github\u002Ffrontend-design\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fskills boraztunc github\u002Ffrontend-design\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":87,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7AG88WWVWCGJY9WA9CH7EY4","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fobra superpower skills\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fobra superpower skills\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":95,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M7AG7ZTNV7XQCWDQ9674FBYB","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fobra superpower skills\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FMHassan0000\u002FSkills\u002Fblob\u002Fmain\u002FClaude\u002Fobra superpower skills\u002Fweb-artifacts-builder\u002FSKILL.md",[],[]]