@pixerate/editor 0.189.0 → 0.191.0

package/dist/{chunk-ZEHTUR7Z.js → chunk-TXYXF32N.js}

@@ -2589,192 +2589,6 @@ function removeAlpha(imageData) {
   }
 }
 
-// src/text/types.ts
-var TEXT_ALIGNS = ["left", "center", "right", "justify"];
-
-// src/image-editor/layers/model.ts
-var MAX_EFFECT_ANIMATION_MS = 6e4;
-var SHAPE_OPERATIONS = ["combine", "subtract", "intersect", "exclude"];
-var LIVE_SHAPE_KINDS = ["rect", "ellipse", "polygon", "star", "line"];
-var idCounter = 0;
-function newLayerId(prefix = "layer") {
-  return `${prefix}_${Date.now().toString(36)}_${(++idCounter).toString(36)}`;
-}
-function pixelLayers(layers) {
-  return flattenLayers(layers).filter((l) => l.type === "pixel");
-}
-function developFilter(layer) {
-  return layer.filters?.find((f) => f.kind === "develop");
-}
-function blurFilter(layer) {
-  return layer.filters?.find((f) => f.kind === "blur");
-}
-function isActiveFilter(f) {
-  if (!f.enabled) return false;
-  if (f.kind === "blur") return Math.min(Math.round(f.radius), 40) >= 1;
-  return Boolean(f.brightness || f.contrast || f.saturation || f.exposure || f.temperature || f.tint);
-}
-function isSpatialFilter(f) {
-  return f.kind === "blur";
-}
-function pixelLayerBounds(layer, surface = layer.surface) {
-  const b = surface.bounds;
-  if (!b) return null;
-  return { x: b.x + layer.offset.x, y: b.y + layer.offset.y, width: b.width, height: b.height };
-}
-function layerTypeLabel(type) {
-  return type === "pixel" ? "Pixel layer" : type === "adjustment" ? "Adjustment layer" : type === "group" ? "Group" : type === "smart" ? "Smart object" : type === "shape" ? "Shape layer" : type === "type" ? "Type layer" : "Annotation";
-}
-function hasSurface(layer) {
-  return layer.type === "pixel" || layer.type === "smart" || layer.type === "shape" || layer.type === "type";
-}
-function isRenderedLayer(layer) {
-  return layer.type === "smart" || layer.type === "shape" || layer.type === "type";
-}
-function shapeLayers(layers) {
-  return flattenLayers(layers).filter((l) => l.type === "shape");
-}
-function smartObjectLayers(layers) {
-  return flattenLayers(layers).filter((l) => l.type === "smart");
-}
-
-// src/image-editor/layers/compositor.ts
-var legacyViewCache = /* @__PURE__ */ new WeakMap();
-function adjustmentNodeAsLayer(node) {
-  let view = legacyViewCache.get(node);
-  if (!view) {
-    view = {
-      id: node.id,
-      kind: node.kind,
-      enabled: node.visible,
-      opacity: node.opacity,
-      blend: node.blend,
-      params: node.params
-    };
-    legacyViewCache.set(node, view);
-  }
-  return view;
-}
-function developAdjustments(f) {
-  return {
-    brightness: f.brightness,
-    contrast: f.contrast,
-    saturation: f.saturation,
-    exposure: f.exposure,
-    temperature: f.temperature,
-    tint: f.tint ?? 0,
-    blur: 0,
-    opacity: 1,
-    process: f.process
-  };
-}
-function applyPixelFilters(data, filters) {
-  for (const f of filters) {
-    if (!isActiveFilter(f) || f.kind !== "develop") continue;
-    const adj = developAdjustments(f);
-    if (normalizeProcessVersion(adj.process) === LATEST_PROCESS_VERSION) applyProcess2Adjustments({ data }, adj);
-    else applyLegacyAdjustments({ data }, adj);
-  }
-}
-function depthMaskAlpha(depth, options) {
-  const { mode, depthRange, softness, invert } = options;
-  let v = invert ? 255 - depth : depth;
-  const soft = Math.max(1, softness || 10);
-  const [lo, hi] = depthRange;
-  if (mode === "threshold") {
-    if (v >= hi + soft) return 0;
-    if (v > hi) return Math.round((hi + soft - v) / soft * 255);
-    if (v >= lo) return 255;
-    if (v < lo - soft) return 0;
-    return Math.round((v - (lo - soft)) / soft * 255);
-  }
-  v += lo;
-  return v < 0 ? 0 : v > 255 ? 255 : v;
-}
-function runLayerFilters(data, width, height, filters) {
-  for (const f of filters) {
-    if (!isActiveFilter(f)) continue;
-    if (f.kind === "develop") applyPixelFilters(data, [f]);
-    else if (f.kind === "blur") applyBoxBlur({ width, height, data }, Math.min(Math.round(f.radius), 40));
-  }
-}
-function runLayerFiltersFloat(data, width, height, filters, linear) {
-  for (const f of filters) {
-    if (!isActiveFilter(f)) continue;
-    if (f.kind === "blur") applyBoxBlurFloat({ width, height, data }, Math.min(Math.round(f.radius), 40));
-    else if (f.kind === "develop") {
-      const adj = developAdjustments(f);
-      if (normalizeProcessVersion(adj.process) === LATEST_PROCESS_VERSION) applyProcess2Float(data, adj, linear);
-      else applyLegacyFloat(data, adj, linear);
-    }
-  }
-}
-function filterReach(filters) {
-  let r = 0;
-  for (const f of filters) if (isActiveFilter(f) && f.kind === "blur") r += Math.min(Math.round(f.radius), 40);
-  return r;
-}
-var filterSpecCache = /* @__PURE__ */ new WeakMap();
-function pixelFilterSpec(layer) {
-  const list2 = layer.filters;
-  if (!list2?.length) return null;
-  if (filterSpecCache.has(list2)) return filterSpecCache.get(list2);
-  const filters = list2.filter(isActiveFilter);
-  let spec = null;
-  if (filters.length) {
-    const spatial = filters.some(isSpatialFilter);
-    spec = {
-      key: JSON.stringify(filters),
-      spatial,
-      apply: (data, width, height) => runLayerFilters(data, width, height, filters)
-    };
-  }
-  filterSpecCache.set(list2, spec);
-  return spec;
-}
-var PHOTO_PROFILE = {
-  isFilterLayer: (l) => l.type === "adjustment",
-  applyFilterRun: (layers, acc, _r, masks) => {
-    const views = layers.map(adjustmentNodeAsLayer);
-    applyAdjustmentLayers({ data: acc }, views, masks);
-  },
-  contentTile: (l, r, sources) => l.type === "annotation" ? sources.rasterizeAnnotation?.(l.annotation, r) ?? null : null,
-  /** Annotation layers draw with their annotation's blend mode unless the layer sets one. */
-  contentBlend: (l) => l.type === "annotation" && l.blend === "normal" && l.annotation.blend ? l.annotation.blend : l.blend,
-  layerKey: (l) => l.type === "pixel" ? [l.filters ?? null, l.source ?? null] : l.type === "adjustment" ? [l.kind, l.params] : l.type === "annotation" ? l.annotation : void 0,
-  pixelFilters: (l) => l.type === "pixel" ? pixelFilterSpec(l) : null,
-  /**
-   * A smart object draws its rendered pixels (contents → placement → smart filters) like a pixel
-   * layer, and a shape layer the pixels rendered from its paths.
-   */
-  isPixelLike: (l) => l.type === "smart" || l.type === "shape" || l.type === "type",
-  maskSourcePlane: (source, W, H, sources) => {
-    const opts = source;
-    const depth = sources.depthMap?.(opts) ?? null;
-    if (!depth || depth.width !== W || depth.height !== H) return null;
-    const v = new Float32Array(W * H);
-    for (let i = 0; i < v.length; i++) v[i] = depthMaskAlpha(depth.data[i * 4], opts) / 255;
-    return v;
-  }
-};
-var LayerCompositor = class extends RasterCompositor {
-  constructor(options = {}) {
-    super(PHOTO_PROFILE, options);
-  }
-};
-function compositeDeep(layers, rect, sources, depth) {
-  const deep = new DeepCompositor(new LayerCompositor(), PHOTO_PROFILE, {
-    applyFilterRunDeep: (run, acc, _r, masks) => applyAdjustmentLayersFloat(acc, run.map(adjustmentNodeAsLayer), masks),
-    pixelFiltersDeep: (l) => {
-      if (l.type !== "pixel") return null;
-      const filters = (l.filters ?? []).filter(isActiveFilter);
-      if (!filters.length) return null;
-      return { reach: filterReach(filters), apply: (data, width, height, linear) => runLayerFiltersFloat(data, width, height, filters, linear) };
-    }
-  }, depth);
-  return deep.composite(layers, rect, sources);
-}
-
 // src/image-editor/layers/vector-raster.ts
 var FLATNESS = 0.01;
 function flattenPath(path, tolerance = FLATNESS) {
@@ -3108,439 +2922,143 @@ function combineCoverage(a, b, op, n) {
   return out;
 }
 
-// src/image-editor/layers/ops.ts
-var LayerOperationError = class extends Error {
-  userMessage;
-  constructor(message, userMessage) {
-    super(message);
-    this.name = "LayerOperationError";
-    if (userMessage) this.userMessage = userMessage;
-  }
-};
-function userErrorMessage(err) {
-  if (err instanceof LayerOperationError && err.userMessage) return err.userMessage;
-  return err instanceof Error ? err.message : String(err);
-}
-function isPaintableLayer(layer) {
-  return layer.type === "pixel" && layer.visible && !isLayerLocked(layer, "pixels");
+// src/text/types.ts
+var TEXT_ALIGNS = ["left", "center", "right", "justify"];
+
+// src/image-editor/layers/model.ts
+var MAX_EFFECT_ANIMATION_MS = 6e4;
+var SHAPE_OPERATIONS = ["combine", "subtract", "intersect", "exclude"];
+var LIVE_SHAPE_KINDS = ["rect", "ellipse", "polygon", "star", "line"];
+var idCounter = 0;
+function newLayerId(prefix = "layer") {
+  return `${prefix}_${Date.now().toString(36)}_${(++idCounter).toString(36)}`;
 }
-function defaultActiveLayerId(layers) {
-  const pixels = flattenLayers(layers).filter((l) => l.type === "pixel");
-  for (let i = pixels.length - 1; i >= 0; i--) if (isPaintableLayer(pixels[i])) return pixels[i].id;
-  return pixels[pixels.length - 1]?.id ?? null;
+function pixelLayers(layers) {
+  return flattenLayers(layers).filter((l) => l.type === "pixel");
 }
-function activeLayerAfterRemoval(prev, next, removedId) {
-  const before = flattenLayers(prev);
-  const at = before.findIndex((l) => l.id === removedId);
-  for (let i = at - 1; i >= 0; i--) {
-    const loc = findLayer(next, before[i].id);
-    if (loc && isPaintableLayer(loc.layer)) return loc.layer.id;
-  }
-  return defaultActiveLayerId(next);
+function developFilter(layer) {
+  return layer.filters?.find((f) => f.kind === "develop");
 }
-var fail = (message) => {
-  throw new LayerOperationError(message);
-};
-function requireLayer(layers, id) {
-  const loc = findLayer(layers, id);
-  if (!loc) {
-    const ids = flattenLayers(layers).map((l) => l.id);
-    fail(`Unknown layer "${id}". ${ids.length ? `Layers: ${ids.join(", ")}.` : "The document has no layers."} Call list_layers for ids.`);
-  }
-  return loc;
+function blurFilter(layer) {
+  return layer.filters?.find((f) => f.kind === "blur");
 }
-function requireUnlocked(layer, what, action) {
-  if (isLayerLocked(layer, "all")) fail(`Layer "${layer.name || layer.id}" is locked (all); unlock it before you ${action}.`);
-  if (what !== "all" && isLayerLocked(layer, what)) fail(`Layer "${layer.name || layer.id}" has its ${what} locked; unlock it before you ${action}.`);
+function isActiveFilter(f) {
+  if (!f.enabled) return false;
+  if (f.kind === "blur") return Math.min(Math.round(f.radius), 40) >= 1;
+  return Boolean(f.brightness || f.contrast || f.saturation || f.exposure || f.temperature || f.tint);
 }
-function placeLayer(layers, layer, placement = {}, defaultIndex) {
-  const given = [placement.aboveId, placement.belowId, placement.parentId].filter((v) => v !== void 0).length;
-  if (given > 1) fail("Give only one of aboveId, belowId and parentId.");
-  if (placement.aboveId || placement.belowId) {
-    const ref = requireLayer(layers, placement.aboveId ?? placement.belowId);
-    return insertLayer(layers, layer, ref.parent?.id ?? null, ref.index + (placement.aboveId ? 1 : 0));
-  }
-  if (placement.parentId) {
-    const ref = requireLayer(layers, placement.parentId);
-    if (ref.layer.type !== "group") fail(`Layer "${placement.parentId}" is not a group; parentId must be a group id.`);
-    return insertLayer(layers, layer, ref.layer.id, placement.index);
-  }
-  return insertLayer(layers, layer, null, placement.index ?? defaultIndex);
+function isSpatialFilter(f) {
+  return f.kind === "blur";
 }
-function removeLayer(layers, id) {
-  const loc = requireLayer(layers, id);
-  requireUnlocked(loc.layer, "all", "delete it");
-  return mapLayer(layers, id, () => null);
-}
-function moveLayer(layers, id, placement) {
-  const loc = requireLayer(layers, id);
-  requireUnlocked(loc.layer, "all", "move it");
-  const target = placement.aboveId ?? placement.belowId ?? placement.parentId;
-  if (target === id) fail("A layer cannot be placed relative to itself.");
-  if (target && loc.layer.type === "group" && flattenLayers(loc.layer.children).some((l) => l.id === target)) {
-    fail(`Group "${id}" cannot be moved into its own child "${target}".`);
-  }
-  if (target) requireLayer(layers, target);
-  if (!target && placement.index === void 0) fail("Give aboveId, belowId, parentId or index.");
-  const without = mapLayer(layers, id, () => null);
-  return placeLayer(without, loc.layer, placement);
+function pixelLayerBounds(layer, surface = layer.surface) {
+  const b = surface.bounds;
+  if (!b) return null;
+  return { x: b.x + layer.offset.x, y: b.y + layer.offset.y, width: b.width, height: b.height };
 }
-function withNewIds(layer) {
-  const next = { ...layer, id: newLayerId(layer.type === "adjustment" ? "adj" : layer.type) };
-  if (next.type === "group") next.children = next.children.map(withNewIds);
-  if (next.type === "annotation") next.annotation = { ...next.annotation, id: next.id };
-  if (next.type === "shape" || next.type === "type") delete next.annotation;
-  if (next.type === "smart" && next.psd?.placed) {
-    next.psd = { ...next.psd };
-    delete next.psd.placed;
-  }
-  return next;
+function layerTypeLabel(type) {
+  return type === "pixel" ? "Pixel layer" : type === "adjustment" ? "Adjustment layer" : type === "group" ? "Group" : type === "smart" ? "Smart object" : type === "shape" ? "Shape layer" : type === "type" ? "Type layer" : "Annotation";
 }
-function duplicateLayer(layers, id, name) {
-  const loc = requireLayer(layers, id);
-  const copy = withNewIds(loc.layer);
-  copy.name = name ?? `${loc.layer.name || "Layer"} copy`;
-  delete copy.locks;
-  return { layers: insertLayer(layers, copy, loc.parent?.id ?? null, loc.index + 1), id: copy.id };
+function hasSurface(layer) {
+  return layer.type === "pixel" || layer.type === "smart" || layer.type === "shape" || layer.type === "type";
 }
-function setLayerProperties(layers, id, props) {
-  const loc = requireLayer(layers, id);
-  const layer = loc.layer;
-  const onlyUnlocking = Object.keys(props).every((k) => k === "locks" || k === "visible" || k === "collapsed");
-  if (!onlyUnlocking) requireUnlocked(layer, "all", "change its properties");
-  const next = { ...layer };
-  if (props.name !== void 0) {
-    if (typeof props.name !== "string" || !props.name.trim()) fail("name must be a non-empty string.");
-    next.name = props.name.trim();
-  }
-  if (props.visible !== void 0) next.visible = Boolean(props.visible);
-  if (props.opacity !== void 0) {
-    if (!(typeof props.opacity === "number" && props.opacity >= 0 && props.opacity <= 1)) fail("opacity must be a number from 0 to 1.");
-    next.opacity = props.opacity;
-  }
-  if (props.fillOpacity !== void 0) {
-    if (layer.type !== "pixel" && layer.type !== "smart" && layer.type !== "shape" && layer.type !== "type") fail(`fillOpacity applies to pixel, shape, type and smart object layers; "${id}" is a ${layer.type} layer.`);
-    if (!(typeof props.fillOpacity === "number" && props.fillOpacity >= 0 && props.fillOpacity <= 1)) fail("fillOpacity must be a number from 0 to 1.");
-    const p = next;
-    if (props.fillOpacity === 1) delete p.fillOpacity;
-    else p.fillOpacity = props.fillOpacity;
-  }
-  if (props.blend !== void 0) {
-    if (props.blend === "pass-through") {
-      if (layer.type !== "group") fail("pass-through is only for groups.");
-    } else if (!isBlendMode(props.blend)) fail(`Unknown blend mode "${props.blend}".`);
-    next.blend = props.blend;
-  }
-  if (props.clipped !== void 0) {
-    if (props.clipped && loc.index === 0) fail("The bottom layer of a group or the stack has nothing below to clip to.");
-    if (props.clipped) next.clipped = true;
-    else delete next.clipped;
-  }
-  if (props.locks !== void 0) {
-    const locks = {};
-    for (const k of ["pixels", "transparency", "position", "all"]) if (props.locks[k]) locks[k] = true;
-    if (Object.keys(locks).length) next.locks = locks;
-    else delete next.locks;
-  }
-  if (props.collapsed !== void 0) {
-    if (layer.type !== "group") fail("collapsed applies to groups.");
-    const g = next;
-    if (props.collapsed) g.collapsed = true;
-    else delete g.collapsed;
-  }
-  return mapLayer(layers, id, () => next);
+function isRenderedLayer(layer) {
+  return layer.type === "smart" || layer.type === "shape" || layer.type === "type";
 }
-function groupLayers(layers, ids, name = "Group") {
-  if (!ids.length) fail("Give at least one layer id to group.");
-  const locs = ids.map((id) => requireLayer(layers, id));
-  const parent = locs[0].parent?.id ?? null;
-  if (locs.some((l) => (l.parent?.id ?? null) !== parent)) fail("Layers to group must share one parent; move them next to each other first.");
-  for (const l of locs) requireUnlocked(l.layer, "all", "group it");
-  const ordered = [...new Set(locs)].sort((a, b) => a.index - b.index);
-  const top = ordered[ordered.length - 1].index;
-  const below = ordered.filter((l) => l.index < top).length;
-  const group = {
-    type: "group",
-    id: newLayerId("group"),
-    name,
-    visible: true,
-    opacity: 1,
-    blend: "pass-through",
-    children: ordered.map((l) => {
-      const c = { ...l.layer };
-      return c;
-    })
-  };
-  if (group.children[0]?.clipped) {
-    const c = { ...group.children[0] };
-    delete c.clipped;
-    group.children[0] = c;
-  }
-  let out = layers;
-  for (const l of ordered) out = mapLayer(out, l.layer.id, () => null);
-  return { layers: insertLayer(out, group, parent, top - below), id: group.id };
+function shapeLayers(layers) {
+  return flattenLayers(layers).filter((l) => l.type === "shape");
 }
-function ungroupLayer(layers, id) {
-  const loc = requireLayer(layers, id);
-  if (loc.layer.type !== "group") fail(`Layer "${id}" is not a group.`);
-  requireUnlocked(loc.layer, "all", "ungroup it");
-  const group = loc.layer;
-  let out = mapLayer(layers, id, () => null);
-  group.children.forEach((c, i) => {
-    out = insertLayer(out, c, loc.parent?.id ?? null, loc.index + i);
-  });
-  return { layers: out, ids: group.children.map((c) => c.id) };
+function smartObjectLayers(layers) {
+  return flattenLayers(layers).filter((l) => l.type === "smart");
 }
-function offsetLayer(layers, id, offset) {
-  const loc = requireLayer(layers, id);
-  if (loc.layer.type !== "pixel") fail(`Only pixel layers move; "${id}" is a ${loc.layer.type} layer.`);
-  requireUnlocked(loc.layer, "position", "move it");
-  if (!Number.isFinite(offset.x) || !Number.isFinite(offset.y)) fail("x and y must be numbers.");
-  const layer = loc.layer;
-  const next = { ...layer, offset: { x: Math.round(offset.x), y: Math.round(offset.y) } };
-  const mask = layer.mask;
-  if (mask && mask.linked === false && !mask.source) {
-    next.mask = { ...mask, surface: translateSurface(mask.surface, layer.offset.x - next.offset.x, layer.offset.y - next.offset.y) };
+
+// src/image-editor/layers/shape.ts
+var SHAPE_RENDER_MARGIN = MAX_EFFECT_REACH;
+var DEFAULT_MITER_LIMIT = 100;
+var fail = (message) => {
+  throw new LayerOperationError(message);
+};
+var orientation = (anchors) => {
+  let a = 0;
+  for (let i = 0; i < anchors.length; i++) {
+    const p = anchors[i];
+    const q2 = anchors[(i + 1) % anchors.length];
+    a += p.x * q2.y - q2.x * p.y;
   }
-  return mapLayer(layers, id, () => next);
+  return a;
+};
+function polygon(points) {
+  const anchors = orientation(points) < 0 ? [...points].reverse() : points;
+  return { closed: true, anchors: anchors.map((p) => ({ x: p.x, y: p.y })) };
 }
-function setLayerMask(layers, id, mask) {
-  const loc = requireLayer(layers, id);
-  requireUnlocked(loc.layer, "all", "change its mask");
-  return mapLayer(layers, id, (l) => {
-    const next = { ...l };
-    if (mask) next.mask = mask;
-    else delete next.mask;
-    return next;
-  });
+function arrowheadPolygon(head, tip, dir) {
+  const len = Math.max(0, head.length);
+  const hw = Math.max(0, head.width) / 2;
+  if (!(len > 0) || !(hw > 0)) return null;
+  const n = { x: -dir.y, y: dir.x };
+  const base = { x: tip.x - dir.x * len, y: tip.y - dir.y * len };
+  const c = Math.max(-0.5, Math.min(0.5, head.concavity ?? 0));
+  const pts = [tip, { x: base.x + n.x * hw, y: base.y + n.y * hw }];
+  if (c) pts.push({ x: base.x + dir.x * len * c, y: base.y + dir.y * len * c });
+  pts.push({ x: base.x - n.x * hw, y: base.y - n.y * hw });
+  return polygon(pts);
 }
-var DEVELOP_FIELDS = ["brightness", "contrast", "saturation", "exposure", "temperature", "tint"];
-function normalizeFilter(raw, id = newLayerId("flt")) {
-  const enabled = raw.enabled !== false;
-  if (raw.kind === "blur") {
-    const r = raw.radius;
-    if (r !== void 0 && !(typeof r === "number" && r >= 0 && r <= 50)) fail("blur radius must be a number from 0 to 50 px.");
-    return { id, kind: "blur", enabled, radius: typeof r === "number" ? r : 2 };
-  }
-  if (raw.kind !== "develop") fail(`Unknown filter kind "${raw.kind}". Use develop or blur.`);
-  const out = { id, kind: "develop", enabled, brightness: 0, contrast: 0, saturation: 0, exposure: 0, temperature: 0, tint: 0, process: 2 };
-  for (const k of DEVELOP_FIELDS) {
-    const v = raw[k];
-    if (v === void 0) continue;
-    if (!(typeof v === "number" && v >= -100 && v <= 100)) fail(`${k} must be a number from -100 to 100.`);
-    out[k] = v;
-  }
-  const p = raw.process;
-  if (p !== void 0) {
-    if (p !== 1 && p !== 2) fail("process must be 1 or 2.");
-    out.process = p;
-  }
+function mapAnchor(a, f) {
+  const p = f(a);
+  const out = { x: p.x, y: p.y };
+  if (a.in) out.in = f(a.in);
+  if (a.out) out.out = f(a.out);
+  if (a.type) out.type = a.type;
+  if (a.corner) out.corner = { ...a.corner };
   return out;
 }
-function requirePixelLayer(layers, id) {
-  const loc = requireLayer(layers, id);
-  if (loc.layer.type !== "pixel") fail(`Filters belong to pixel layers; "${id}" is a ${loc.layer.type} layer.`);
-  requireUnlocked(loc.layer, "all", "change its filters");
-  return loc.layer;
+function mapSubpaths(subpaths, f) {
+  return expandVectorCorners(subpaths).map((sp) => ({ closed: sp.closed, anchors: sp.anchors.map((a) => mapAnchor(a, f)) }));
 }
-function addLayerFilter(layers, id, filter) {
-  const layer = requirePixelLayer(layers, id);
-  if (layer.filters?.some((f) => f.kind === filter.kind)) fail(`Layer "${id}" already has a ${filter.kind} filter; change it with update_layer_filter.`);
-  return mapLayer(layers, id, () => ({ ...layer, filters: [...layer.filters ?? [], filter] }));
+function liveShapeSubpaths(live) {
+  let out;
+  switch (live.kind) {
+    case "rect": {
+      const x = Math.min(live.x, live.x + live.width);
+      const y = Math.min(live.y, live.y + live.height);
+      const sp = rectSubpath({ x, y, width: Math.abs(live.width), height: Math.abs(live.height) });
+      const r = live.radii ?? [0, 0, 0, 0];
+      out = [{ closed: true, anchors: sp.anchors.map((a, i) => r[i] > 0 ? setAnchorCorner(a, r[i]) : a) }];
+      break;
+    }
+    case "ellipse":
+      out = [ellipseSubpath(normBox(live))];
+      break;
+    case "polygon":
+      out = [polygonSubpath(normBox(live), live.sides)];
+      break;
+    case "star":
+      out = [starSubpath(normBox(live), live.points, Math.max(0, Math.min(1, live.innerRatio)))];
+      break;
+    case "line": {
+      const a = { x: live.x1, y: live.y1 };
+      const b = { x: live.x2, y: live.y2 };
+      const len = Math.hypot(b.x - a.x, b.y - a.y);
+      out = [];
+      if (len > 0) {
+        const d = { x: (b.x - a.x) / len, y: (b.y - a.y) / len };
+        const hw = Math.max(0, live.weight) / 2;
+        if (hw > 0) {
+          const n = { x: -d.y * hw, y: d.x * hw };
+          out.push(polygon([{ x: a.x + n.x, y: a.y + n.y }, { x: b.x + n.x, y: b.y + n.y }, { x: b.x - n.x, y: b.y - n.y }, { x: a.x - n.x, y: a.y - n.y }]));
+        }
+        const end = live.endArrow ? arrowheadPolygon(live.endArrow, b, d) : null;
+        const start = live.startArrow ? arrowheadPolygon(live.startArrow, a, { x: -d.x, y: -d.y }) : null;
+        if (start) out.push(start);
+        if (end) out.push(end);
+      }
+      break;
+    }
+  }
+  const m = live.transform;
+  return m && !isIdentityMatrix(m) ? mapSubpaths(out, (p) => applyMatrix(m, p)) : out;
 }
-function updateLayerFilter(layers, id, filterId, changes) {
-  const layer = requirePixelLayer(layers, id);
-  const i = (layer.filters ?? []).findIndex((f) => f.id === filterId);
-  if (i === -1) fail(`Layer "${id}" has no filter "${filterId}". Filters: ${(layer.filters ?? []).map((f) => f.id).join(", ") || "none"}.`);
-  const current = layer.filters[i];
-  if ("kind" in changes && changes.kind !== current.kind) fail("A filter kind cannot change; remove it and add another.");
-  const merged2 = normalizeFilter({ ...current, ...changes, kind: current.kind }, current.id);
-  const filters = [...layer.filters];
-  filters[i] = merged2;
-  return mapLayer(layers, id, () => ({ ...layer, filters }));
-}
-function removeLayerFilter(layers, id, filterId) {
-  const layer = requirePixelLayer(layers, id);
-  if (!(layer.filters ?? []).some((f) => f.id === filterId)) fail(`Layer "${id}" has no filter "${filterId}".`);
-  const filters = layer.filters.filter((f) => f.id !== filterId);
-  const next = { ...layer };
-  if (filters.length) next.filters = filters;
-  else delete next.filters;
-  return mapLayer(layers, id, () => next);
-}
-function requireEffectLayer(layers, id, action) {
-  const layer = requireLayer(layers, id).layer;
-  if (layer.type === "adjustment") fail(`Layer "${layer.name || id}" is an adjustment layer; effects go on pixel, annotation and group layers.`);
-  requireUnlocked(layer, "all", action);
-  return layer;
-}
-function layerEffectsOf(layer) {
-  return layer.effects ?? { enabled: true, items: [] };
-}
-function guard(fn) {
-  try {
-    return fn();
-  } catch (e) {
-    if (e instanceof LayerEffectError) fail(e.message);
-    throw e;
-  }
-}
-function setLayerEffects(layers, id, effects) {
-  const layer = requireEffectLayer(layers, id, "change its effects");
-  const next = { ...layer };
-  if (effects && (effects.items.length || effects.psd || effects.scale !== void 0 || !effects.enabled)) {
-    guard(() => validateLayerEffects(effects));
-    next.effects = effects;
-  } else delete next.effects;
-  return mapLayer(layers, id, () => next);
-}
-function addLayerEffect(layers, id, kind, params = {}, index) {
-  if (!isLayerEffectKind(kind)) fail(`Unknown effect kind "${String(kind)}". Kinds: ${LAYER_EFFECT_KINDS.join(", ")}.`);
-  const layer = requireEffectLayer(layers, id, "add effects");
-  const current = layerEffectsOf(layer);
-  const ids = new Set(current.items.map((e) => e.id));
-  let effectId = newEffectId();
-  while (ids.has(effectId)) effectId = newEffectId();
-  const { id: _ignored, kind: _kind, ...rest } = params;
-  const effect = guard(() => mergeLayerEffect(defaultLayerEffect(kind, effectId), rest));
-  const items = [...current.items];
-  const at = index === void 0 ? items.length : Math.max(0, Math.min(items.length, Math.floor(index)));
-  items.splice(at, 0, effect);
-  return { layers: setLayerEffects(layers, id, { ...current, items }), effect };
-}
-function requireEffect(layer, effectId) {
-  const items = layer.effects?.items ?? [];
-  const i = items.findIndex((e) => e.id === effectId);
-  if (i === -1) fail(`Layer "${layer.name || layer.id}" has no effect "${effectId}". Effects: ${items.map((e) => `${e.id} (${e.kind})`).join(", ") || "none"}; call list_layer_effects.`);
-  return i;
-}
-function updateLayerEffect(layers, id, effectId, changes) {
-  const layer = requireEffectLayer(layers, id, "change its effects");
-  const i = requireEffect(layer, effectId);
-  const current = layer.effects;
-  const items = [...current.items];
-  items[i] = guard(() => mergeLayerEffect(items[i], changes));
-  return setLayerEffects(layers, id, { ...current, items });
-}
-function removeLayerEffect(layers, id, effectId) {
-  const layer = requireEffectLayer(layers, id, "change its effects");
-  requireEffect(layer, effectId);
-  const current = layer.effects;
-  return setLayerEffects(layers, id, { ...current, items: current.items.filter((e) => e.id !== effectId) });
-}
-function setLayerEffectsEnabled(layers, id, enabled, scale) {
-  const layer = requireEffectLayer(layers, id, "change its effects");
-  if (scale !== void 0 && !(Number.isFinite(scale) && scale >= 0.01 && scale <= 10)) fail(`scale must be from 0.01 to 10 (1 = 100 %), got ${scale}.`);
-  const current = layerEffectsOf(layer);
-  const next = { ...current, enabled };
-  if (scale !== void 0) {
-    if (scale === 1) delete next.scale;
-    else next.scale = scale;
-  }
-  return setLayerEffects(layers, id, next);
-}
-function parseBlend(value, allowPassThrough = false) {
-  if (value === void 0) return void 0;
-  if (value === "pass-through" && allowPassThrough) return value;
-  if (!isBlendMode(value)) fail(`Unknown blend mode "${String(value)}".`);
-  return value;
-}
-function unionRect(a, b) {
-  if (!a) return b;
-  if (!b) return a;
-  const x = Math.min(a.x, b.x);
-  const y = Math.min(a.y, b.y);
-  return { x, y, width: Math.max(a.x + a.width, b.x + b.width) - x, height: Math.max(a.y + a.height, b.y + b.height) - y };
-}
-
-// src/image-editor/layers/shape.ts
-var SHAPE_RENDER_MARGIN = MAX_EFFECT_REACH;
-var DEFAULT_MITER_LIMIT = 100;
-var fail2 = (message) => {
-  throw new LayerOperationError(message);
-};
-var orientation = (anchors) => {
-  let a = 0;
-  for (let i = 0; i < anchors.length; i++) {
-    const p = anchors[i];
-    const q2 = anchors[(i + 1) % anchors.length];
-    a += p.x * q2.y - q2.x * p.y;
-  }
-  return a;
-};
-function polygon(points) {
-  const anchors = orientation(points) < 0 ? [...points].reverse() : points;
-  return { closed: true, anchors: anchors.map((p) => ({ x: p.x, y: p.y })) };
-}
-function arrowheadPolygon(head, tip, dir) {
-  const len = Math.max(0, head.length);
-  const hw = Math.max(0, head.width) / 2;
-  if (!(len > 0) || !(hw > 0)) return null;
-  const n = { x: -dir.y, y: dir.x };
-  const base = { x: tip.x - dir.x * len, y: tip.y - dir.y * len };
-  const c = Math.max(-0.5, Math.min(0.5, head.concavity ?? 0));
-  const pts = [tip, { x: base.x + n.x * hw, y: base.y + n.y * hw }];
-  if (c) pts.push({ x: base.x + dir.x * len * c, y: base.y + dir.y * len * c });
-  pts.push({ x: base.x - n.x * hw, y: base.y - n.y * hw });
-  return polygon(pts);
-}
-function mapAnchor(a, f) {
-  const p = f(a);
-  const out = { x: p.x, y: p.y };
-  if (a.in) out.in = f(a.in);
-  if (a.out) out.out = f(a.out);
-  if (a.type) out.type = a.type;
-  if (a.corner) out.corner = { ...a.corner };
-  return out;
-}
-function mapSubpaths(subpaths, f) {
-  return expandVectorCorners(subpaths).map((sp) => ({ closed: sp.closed, anchors: sp.anchors.map((a) => mapAnchor(a, f)) }));
-}
-function liveShapeSubpaths(live) {
-  let out;
-  switch (live.kind) {
-    case "rect": {
-      const x = Math.min(live.x, live.x + live.width);
-      const y = Math.min(live.y, live.y + live.height);
-      const sp = rectSubpath({ x, y, width: Math.abs(live.width), height: Math.abs(live.height) });
-      const r = live.radii ?? [0, 0, 0, 0];
-      out = [{ closed: true, anchors: sp.anchors.map((a, i) => r[i] > 0 ? setAnchorCorner(a, r[i]) : a) }];
-      break;
-    }
-    case "ellipse":
-      out = [ellipseSubpath(normBox(live))];
-      break;
-    case "polygon":
-      out = [polygonSubpath(normBox(live), live.sides)];
-      break;
-    case "star":
-      out = [starSubpath(normBox(live), live.points, Math.max(0, Math.min(1, live.innerRatio)))];
-      break;
-    case "line": {
-      const a = { x: live.x1, y: live.y1 };
-      const b = { x: live.x2, y: live.y2 };
-      const len = Math.hypot(b.x - a.x, b.y - a.y);
-      out = [];
-      if (len > 0) {
-        const d = { x: (b.x - a.x) / len, y: (b.y - a.y) / len };
-        const hw = Math.max(0, live.weight) / 2;
-        if (hw > 0) {
-          const n = { x: -d.y * hw, y: d.x * hw };
-          out.push(polygon([{ x: a.x + n.x, y: a.y + n.y }, { x: b.x + n.x, y: b.y + n.y }, { x: b.x - n.x, y: b.y - n.y }, { x: a.x - n.x, y: a.y - n.y }]));
-        }
-        const end = live.endArrow ? arrowheadPolygon(live.endArrow, b, d) : null;
-        const start = live.startArrow ? arrowheadPolygon(live.startArrow, a, { x: -d.x, y: -d.y }) : null;
-        if (start) out.push(start);
-        if (end) out.push(end);
-      }
-      break;
-    }
-  }
-  const m = live.transform;
-  return m && !isIdentityMatrix(m) ? mapSubpaths(out, (p) => applyMatrix(m, p)) : out;
-}
-function normBox(b) {
-  return { x: Math.min(b.x, b.x + b.width), y: Math.min(b.y, b.y + b.height), width: Math.abs(b.width), height: Math.abs(b.height) };
+function normBox(b) {
+  return { x: Math.min(b.x, b.x + b.width), y: Math.min(b.y, b.y + b.height), width: Math.abs(b.width), height: Math.abs(b.height) };
 }
 function liveComponent(live, op = "combine") {
   return { op, subpaths: liveShapeSubpaths(live), live };
@@ -3667,6 +3185,10 @@ function fillCoverage(geo, rect, rule, inverted = false) {
   });
   return acc;
 }
+function componentsCoverage(components, rect, rule = "nonzero", inverted = false) {
+  const geo = { fills: components.map((c) => ({ op: c.op, flat: flattenPath(componentPath(c)) })) };
+  return fillCoverage(geo, rect, rule, inverted) ?? new Float32Array(rect.width * rect.height);
+}
 function paintContext(env) {
   const tiles = /* @__PURE__ */ new Map();
   return {
@@ -3766,29 +3288,29 @@ function rerenderShape(layer, env) {
 }
 var isNum = (v) => typeof v === "number" && Number.isFinite(v);
 function requireNum(v, path, min = -Infinity, max = Infinity) {
-  if (!isNum(v)) fail2(`${path} must be a finite number.`);
-  if (v < min || v > max) fail2(`${path} must be between ${min} and ${max}, got ${v}.`);
+  if (!isNum(v)) fail(`${path} must be a finite number.`);
+  if (v < min || v > max) fail(`${path} must be between ${min} and ${max}, got ${v}.`);
   return v;
 }
 function normalizeShapePaint(v, path = "paint") {
   if (typeof v === "string") {
     const c = parseCssColor(v);
-    if (!c) return fail2(`${path}: "${v}" is not a colour; use #rrggbb (or #rrggbbaa, rgb(), a CSS colour name).`);
+    if (!c) return fail(`${path}: "${v}" is not a colour; use #rrggbb (or #rrggbbaa, rgb(), a CSS colour name).`);
     return c.alpha < 1 ? { type: "color", color: c.hex, opacity: c.alpha } : { type: "color", color: c.hex };
   }
-  if (!v || typeof v !== "object") return fail2(`${path} must be a colour string or an object with type color, gradient or pattern.`);
+  if (!v || typeof v !== "object") return fail(`${path} must be a colour string or an object with type color, gradient or pattern.`);
   const o = v;
   const opacity = o.opacity === void 0 ? void 0 : requireNum(o.opacity, `${path}.opacity`, 0, 1);
   const withOpacity = (p) => opacity !== void 0 && opacity !== 1 ? { ...p, opacity } : p;
   if (o.type === "color") {
     const c = parseCssColor(o.color);
-    if (!c) return fail2(`${path}.color must be a colour such as #rrggbb.`);
+    if (!c) return fail(`${path}.color must be a colour such as #rrggbb.`);
     const op = (opacity ?? 1) * c.alpha;
     return op !== 1 ? { type: "color", color: c.hex, opacity: op } : { type: "color", color: c.hex };
   }
   if (o.type === "gradient") {
     const g = o.gradient;
-    if (!g || typeof g !== "object") return fail2(`${path}.gradient is required: { stops: [{ position, color }], style, angle, \u2026 }.`);
+    if (!g || typeof g !== "object") return fail(`${path}.gradient is required: { stops: [{ position, color }], style, angle, \u2026 }.`);
     const gradient = {
       stops: Array.isArray(g.stops) ? g.stops.map((s) => ({ position: s.position, color: parseCssColor(s.color)?.hex ?? s.color })) : [],
       ...g.opacityStops ? { opacityStops: g.opacityStops } : {},
@@ -3802,14 +3324,14 @@ function normalizeShapePaint(v, path = "paint") {
     try {
       validateEffectGradient(gradient, `${path}.gradient`);
     } catch (e) {
-      if (e instanceof LayerEffectError) fail2(e.message);
+      if (e instanceof LayerEffectError) fail(e.message);
       throw e;
     }
-    if (gradient.stops.length < 1) fail2(`${path}.gradient.stops needs at least one { position, color }.`);
+    if (gradient.stops.length < 1) fail(`${path}.gradient.stops needs at least one { position, color }.`);
     return withOpacity({ type: "gradient", gradient });
   }
   if (o.type === "pattern") {
-    if (typeof o.patternId !== "string" || !o.patternId) fail2(`${path}.patternId is required (a document or built-in pattern id).`);
+    if (typeof o.patternId !== "string" || !o.patternId) fail(`${path}.patternId is required (a document or built-in pattern id).`);
     const p = { type: "pattern", patternId: o.patternId, scale: o.scale === void 0 ? 1 : requireNum(o.scale, `${path}.scale`, 0.01, 10) };
     if (typeof o.name === "string") p.name = o.name;
     if (o.angle !== void 0) p.angle = requireNum(o.angle, `${path}.angle`, -360, 360);
@@ -3820,10 +3342,10 @@ function normalizeShapePaint(v, path = "paint") {
     }
     return withOpacity(p);
   }
-  return fail2(`${path}.type must be color, gradient or pattern, got ${JSON.stringify(o.type)}.`);
+  return fail(`${path}.type must be color, gradient or pattern, got ${JSON.stringify(o.type)}.`);
 }
 function normalizeShapeStroke(v, path = "stroke", base) {
-  if (!v || typeof v !== "object") return fail2(`${path} must be an object { width, paint, align?, cap?, join?, miterLimit?, dashes?, dashOffset? } or null.`);
+  if (!v || typeof v !== "object") return fail(`${path} must be an object { width, paint, align?, cap?, join?, miterLimit?, dashes?, dashOffset? } or null.`);
   const o = v;
   const width = o.width === void 0 && base ? base.width : requireNum(o.width, `${path}.width`, 0, 1e4);
   const paint = o.paint === void 0 && base ? base.paint : o.paint === void 0 && o.color !== void 0 ? normalizeShapePaint(o.color, `${path}.color`) : normalizeShapePaint(o.paint, `${path}.paint`);
@@ -3831,7 +3353,7 @@ function normalizeShapeStroke(v, path = "stroke", base) {
   const pick = (k, allowed) => {
     const value = o[k] === void 0 ? base?.[k] : o[k];
     if (value === void 0) return;
-    if (!allowed.includes(value)) fail2(`${path}.${k} must be one of ${allowed.join(", ")}, got ${JSON.stringify(value)}.`);
+    if (!allowed.includes(value)) fail(`${path}.${k} must be one of ${allowed.join(", ")}, got ${JSON.stringify(value)}.`);
     if (value !== (k === "align" ? "center" : k === "cap" ? "butt" : "miter")) out[k] = value;
   };
   pick("align", ["inside", "center", "outside"]);
@@ -3841,9 +3363,9 @@ function normalizeShapeStroke(v, path = "stroke", base) {
   if (miter !== void 0 && miter !== DEFAULT_MITER_LIMIT) out.miterLimit = miter;
   const dashes = o.dashes === void 0 ? base?.dashes : o.dashes;
   if (dashes !== void 0 && dashes !== null) {
-    if (!Array.isArray(dashes) || dashes.length > 32 || !dashes.every((d) => isNum(d) && d >= 0 && d <= 1e4)) fail2(`${path}.dashes must be at most 32 lengths 0..10000 (multiples of the width).`);
+    if (!Array.isArray(dashes) || dashes.length > 32 || !dashes.every((d) => isNum(d) && d >= 0 && d <= 1e4)) fail(`${path}.dashes must be at most 32 lengths 0..10000 (multiples of the width).`);
     if (dashes.length) {
-      if (dashes.reduce((s, d) => s + d, 0) < 0.01) fail2(`${path}.dashes must add up to at least 0.01 widths.`);
+      if (dashes.reduce((s, d) => s + d, 0) < 0.01) fail(`${path}.dashes must add up to at least 0.01 widths.`);
       out.dashes = [...dashes];
     }
   }
@@ -3861,7 +3383,7 @@ function box(o, path) {
 }
 function arrowhead(v, path) {
   if (v === null || v === void 0 || v === false) return null;
-  if (typeof v !== "object") return fail2(`${path} must be { width, length, concavity? } in pixels, or null.`);
+  if (typeof v !== "object") return fail(`${path} must be { width, length, concavity? } in pixels, or null.`);
   const o = v;
   const head = { width: requireNum(o.width, `${path}.width`, 0, 1e5), length: requireNum(o.length, `${path}.length`, 0, 1e5) };
   if (o.concavity !== void 0 && o.concavity !== 0) head.concavity = requireNum(o.concavity, `${path}.concavity`, -0.5, 0.5);
@@ -3869,13 +3391,13 @@ function arrowhead(v, path) {
 }
 function matrixArg(v, path) {
   if (v === void 0 || v === null) return void 0;
-  if (!Array.isArray(v) || v.length !== 6 || !v.every(isNum)) fail2(`${path} must be six numbers [a, b, c, d, e, f].`);
+  if (!Array.isArray(v) || v.length !== 6 || !v.every(isNum)) fail(`${path} must be six numbers [a, b, c, d, e, f].`);
   const m = v;
-  if (Math.abs(m[0] * m[3] - m[1] * m[2]) < 1e-12) fail2(`${path} is singular.`);
+  if (Math.abs(m[0] * m[3] - m[1] * m[2]) < 1e-12) fail(`${path} is singular.`);
   return isIdentityMatrix(m) ? void 0 : [...m];
 }
 function normalizeLiveShape(v, path = "shape") {
-  if (!v || typeof v !== "object") return fail2(`${path} must be an object with kind ${LIVE_SHAPE_KINDS.join(", ")}.`);
+  if (!v || typeof v !== "object") return fail(`${path} must be an object with kind ${LIVE_SHAPE_KINDS.join(", ")}.`);
   const o = v;
   const transform = matrixArg(o.transform, `${path}.transform`);
   const t = transform ? { transform } : {};
@@ -3886,7 +3408,7 @@ function normalizeLiveShape(v, path = "shape") {
       if (o.radii !== void 0 || o.radius !== void 0) {
         const r = o.radii ?? o.radius;
         const list2 = typeof r === "number" ? [r, r, r, r] : r;
-        if (!Array.isArray(list2) || list2.length !== 4 || !list2.every((x) => isNum(x) && x >= 0)) fail2(`${path}.radii must be four radii \u2265 0 [top-left, top-right, bottom-right, bottom-left] (or radius, one number).`);
+        if (!Array.isArray(list2) || list2.length !== 4 || !list2.every((x) => isNum(x) && x >= 0)) fail(`${path}.radii must be four radii \u2265 0 [top-left, top-right, bottom-right, bottom-left] (or radius, one number).`);
         if (list2.some((x) => x > 0)) radii = [...list2];
       }
       return { kind: "rect", ...b, ...radii ? { radii } : {}, ...t };
@@ -3917,16 +3439,16 @@ function normalizeLiveShape(v, path = "shape") {
       const e = arrowhead(o.endArrow, `${path}.endArrow`);
       if (s) line.startArrow = s;
       if (e) line.endArrow = e;
-      if (line.x1 === line.x2 && line.y1 === line.y2) fail2(`${path}: the line's two ends are the same point.`);
+      if (line.x1 === line.x2 && line.y1 === line.y2) fail(`${path}: the line's two ends are the same point.`);
       return line;
     }
     default:
-      return fail2(`${path}.kind must be one of ${LIVE_SHAPE_KINDS.join(", ")}, got ${JSON.stringify(o.kind)}.`);
+      return fail(`${path}.kind must be one of ${LIVE_SHAPE_KINDS.join(", ")}, got ${JSON.stringify(o.kind)}.`);
   }
 }
 function point(v, path) {
   const p = v;
-  if (!p || typeof p !== "object") return fail2(`${path} must be { x, y } in document pixels.`);
+  if (!p || typeof p !== "object") return fail(`${path} must be { x, y } in document pixels.`);
   return { x: requireNum(p.x, `${path}.x`), y: requireNum(p.y, `${path}.y`) };
 }
 function normalizeSubpaths(v, path = "subpaths") {
@@ -3935,15 +3457,15 @@ function normalizeSubpaths(v, path = "subpaths") {
     try {
       subs = bezierToSubpaths(v);
     } catch {
-      return fail2(`${path}: could not read the SVG path data.`);
+      return fail(`${path}: could not read the SVG path data.`);
     }
-    if (!subs.length || !subs.every((s) => s.anchors.every((a) => isNum(a.x) && isNum(a.y)))) fail2(`${path}: the SVG path data holds no drawable subpath.`);
+    if (!subs.length || !subs.every((s) => s.anchors.every((a) => isNum(a.x) && isNum(a.y)))) fail(`${path}: the SVG path data holds no drawable subpath.`);
     return subs;
   }
-  if (!Array.isArray(v) || !v.length) return fail2(`${path} must be a non-empty array of { anchors: [{ x, y, in?, out? }], closed } (or SVG path data).`);
+  if (!Array.isArray(v) || !v.length) return fail(`${path} must be a non-empty array of { anchors: [{ x, y, in?, out? }], closed } (or SVG path data).`);
   return v.map((s, i) => {
     const sp = s;
-    if (!sp || !Array.isArray(sp.anchors) || sp.anchors.length < 1) fail2(`${path}[${i}].anchors must be a non-empty array.`);
+    if (!sp || !Array.isArray(sp.anchors) || sp.anchors.length < 1) fail(`${path}[${i}].anchors must be a non-empty array.`);
     const anchors = sp.anchors.map((a, j) => {
       const at = `${path}[${i}].anchors[${j}]`;
       const p = point(a, at);
@@ -3963,16 +3485,16 @@ function normalizeSubpaths(v, path = "subpaths") {
 }
 function requireOperation(v, path = "op") {
   if (v === void 0) return "combine";
-  if (!SHAPE_OPERATIONS.includes(v)) fail2(`${path} must be one of ${SHAPE_OPERATIONS.join(", ")}, got ${JSON.stringify(v)}.`);
+  if (!SHAPE_OPERATIONS.includes(v)) fail(`${path} must be one of ${SHAPE_OPERATIONS.join(", ")}, got ${JSON.stringify(v)}.`);
   return v;
 }
 function requireShapeLayer(layers, id) {
   const layer = requireLayer(layers, id).layer;
-  if (layer.type !== "shape") fail2(`Layer "${layer.name || id}" is a ${layer.type} layer, not a shape layer; list_layers shows each layer's type.`);
+  if (layer.type !== "shape") fail(`Layer "${layer.name || id}" is a ${layer.type} layer, not a shape layer; list_layers shows each layer's type.`);
   return layer;
 }
 function createShapeLayer(init, env, id = newLayerId()) {
-  if (!init.components.length) fail2("A shape needs at least one component.");
+  if (!init.components.length) fail("A shape needs at least one component.");
   const layer = {
     type: "shape",
     id,
@@ -4012,7 +3534,7 @@ function updateShapeLayer(layers, id, change, env, action = "edit it") {
   const patch = change(current);
   const next = { ...current, ...patch };
   if (!("annotation" in patch)) delete next.annotation;
-  if (!next.components.length) fail2("A shape needs at least one component; delete the layer instead.");
+  if (!next.components.length) fail("A shape needs at least one component; delete the layer instead.");
   const rendered = rerenderShape(next, env);
   return { layers: mapLayer(layers, id, () => rendered), layer: rendered };
 }
@@ -4036,7 +3558,7 @@ function mergeShapeComponents(components, fillRule = "nonzero") {
   if (components.length < 2) return [...components];
   const path = shapeOutline(components, fillRule);
   const subpaths = bezierToSubpaths(path);
-  if (!subpaths.length) fail2("The components combine to nothing (the operations remove every area), so there is nothing to merge into.");
+  if (!subpaths.length) fail("The components combine to nothing (the operations remove every area), so there is nothing to merge into.");
   return [{ op: "combine", subpaths }];
 }
 function shapeAsPixelLayer(layer) {
@@ -4106,20 +3628,642 @@ function shapeFromAnnotation(a) {
     default:
       return null;
   }
-}
-function annotationBlend(a, layerBlend) {
-  if (layerBlend !== "normal") return layerBlend;
-  return a.blend && isBlendMode(a.blend) ? a.blend : "normal";
-}
-function annotationOfShape(layer) {
-  const a = layer.annotation;
-  if (!a) return null;
-  const blend = layer.blend;
-  if ((a.blend ?? "normal") === blend) return a;
-  const out = { ...a };
-  if (blend === "normal") delete out.blend;
-  else out.blend = blend;
-  return out;
+}
+function annotationBlend(a, layerBlend) {
+  if (layerBlend !== "normal") return layerBlend;
+  return a.blend && isBlendMode(a.blend) ? a.blend : "normal";
+}
+function annotationOfShape(layer) {
+  const a = layer.annotation;
+  if (!a) return null;
+  const blend = layer.blend;
+  if ((a.blend ?? "normal") === blend) return a;
+  const out = { ...a };
+  if (blend === "normal") delete out.blend;
+  else out.blend = blend;
+  return out;
+}
+
+// src/image-editor/layers/vector-mask.ts
+function isActiveVectorMask(vm) {
+  return Boolean(vm && vm.enabled !== false);
+}
+function vectorMaskCoverage(vm, width, height) {
+  let v = componentsCoverage(vm.components, { x: 0, y: 0, width, height }, vm.fillRule ?? "nonzero", vm.inverted === true);
+  if ((vm.feather ?? 0) > 0) v = gaussianBlur(v, width, height, vm.feather, "clamp");
+  const density = vm.density ?? 1;
+  if (density !== 1) for (let i = 0; i < v.length; i++) v[i] = 1 - density * (1 - v[i]);
+  return v;
+}
+function outsideValue(vm) {
+  return 1 - (vm.density ?? 1) * (1 - (vm.inverted ? 1 : 0));
+}
+function rasterCoverage(mask, ox, oy, width, height) {
+  const bytes = readRegion(mask.surface, { x: -ox, y: -oy, width, height });
+  let v = new Float32Array(width * height);
+  for (let i = 0; i < v.length; i++) v[i] = bytes[i] / 255;
+  if ((mask.feather ?? 0) > 0) v = gaussianBlur(v, width, height, mask.feather, "clamp");
+  const density = mask.density ?? 1;
+  if (density !== 1) for (let i = 0; i < v.length; i++) v[i] = 1 - density * (1 - v[i]);
+  return v;
+}
+var layerOffset = (layer) => layer.type === "pixel" ? layer.offset : { x: 0, y: 0 };
+function effectiveLayerMask(layer, width, height) {
+  const vm = layer.vectorMask;
+  const raster = layer.mask;
+  if (!isActiveVectorMask(vm) || raster?.source || width < 1 || height < 1) return raster;
+  const { x: ox, y: oy } = layerOffset(layer);
+  const v = vectorMaskCoverage(vm, width, height);
+  let outside = outsideValue(vm);
+  if (raster && raster.enabled !== false) {
+    const r = rasterCoverage(raster, ox, oy, width, height);
+    for (let i = 0; i < v.length; i++) v[i] *= r[i];
+    outside *= 1 - (raster.density ?? 1) * (1 - raster.defaultValue / 255);
+  }
+  const bytes = new Uint8ClampedArray(v.length);
+  for (let i = 0; i < v.length; i++) bytes[i] = Math.round(v[i] * 255);
+  const defaultValue = outside >= 0.5 ? 255 : 0;
+  return { surface: writeRegion(emptySurface(1, defaultValue), { x: -ox, y: -oy, width, height }, bytes), defaultValue };
+}
+var resolved = /* @__PURE__ */ new WeakMap();
+function hasVectorMask(layers) {
+  for (const l of layers) {
+    if (isActiveVectorMask(l.vectorMask)) return true;
+    if (l.type === "group" && hasVectorMask(l.children)) return true;
+  }
+  return false;
+}
+function resolveVectorMasks(layers, width, height) {
+  if (!hasVectorMask(layers)) return layers;
+  return layers.map((l) => resolveLayer(l, width, height));
+}
+function resolveLayer(layer, width, height) {
+  let next = layer;
+  if (layer.type === "group" && hasVectorMask(layer.children)) {
+    const key2 = `${width}x${height}`;
+    const hit2 = resolved.get(layer);
+    if (hit2?.key === key2) return hit2.layer;
+    next = { ...layer, children: layer.children.map((c) => resolveLayer(c, width, height)) };
+    if (!isActiveVectorMask(layer.vectorMask)) {
+      resolved.set(layer, { key: key2, layer: next });
+      return next;
+    }
+  }
+  if (!isActiveVectorMask(layer.vectorMask)) return layer;
+  const key = `${width}x${height}:v`;
+  const hit = resolved.get(layer);
+  if (hit?.key === key) return hit.layer;
+  const mask = effectiveLayerMask(layer, width, height);
+  const out = { ...next, mask };
+  delete out.vectorMask;
+  if (!mask) delete out.mask;
+  resolved.set(layer, { key, layer: out });
+  return out;
+}
+function offsetVectorMask(vm, dx, dy) {
+  if (!dx && !dy) return vm;
+  return { ...vm, components: vm.components.map((c) => ({ ...c, subpaths: mapSubpaths(c.subpaths, (p) => ({ x: p.x + dx, y: p.y + dy })), ...c.live ? { live: offsetLive(c.live, dx, dy) } : {} })) };
+}
+function offsetLive(live, dx, dy) {
+  if (live.kind === "line") return { ...live, x1: live.x1 + dx, y1: live.y1 + dy, x2: live.x2 + dx, y2: live.y2 + dy };
+  return { ...live, x: live.x + dx, y: live.y + dy };
+}
+function transformVectorMask(vm, f, affine) {
+  return { ...vm, components: transformShapeComponents(vm.components, f, affine) };
+}
+function followLayerMove(layer, dx, dy) {
+  const vm = layer.vectorMask;
+  if (!vm || vm.linked === false || !dx && !dy) return layer;
+  return { ...layer, vectorMask: offsetVectorMask(vm, dx, dy) };
+}
+function vectorMaskBounds(vm) {
+  let x0 = Infinity;
+  let y0 = Infinity;
+  let x1 = -Infinity;
+  let y1 = -Infinity;
+  for (const c of vm.components) {
+    for (const ring of flattenPath(componentPath(c))) {
+      for (let k = 0; k + 1 < ring.length; k += 2) {
+        x0 = Math.min(x0, ring[k]);
+        x1 = Math.max(x1, ring[k]);
+        y0 = Math.min(y0, ring[k + 1]);
+        y1 = Math.max(y1, ring[k + 1]);
+      }
+    }
+  }
+  return x0 === Infinity ? null : { x: x0, y: y0, width: x1 - x0, height: y1 - y0 };
+}
+var thumbCache = /* @__PURE__ */ new WeakMap();
+function vectorMaskThumbnail(vm, width, height, maxSide = 64) {
+  const key = `${width}x${height}:${maxSide}`;
+  const hit = thumbCache.get(vm);
+  if (hit?.key === key) return hit.pixels;
+  const k = Math.min(1, maxSide / Math.max(1, width, height));
+  const tw = Math.max(1, Math.round(width * k));
+  const th = Math.max(1, Math.round(height * k));
+  const scaled = transformVectorMask(vm, (p) => ({ x: p.x * k, y: p.y * k }), [k, 0, 0, k, 0, 0]);
+  const cov = componentsCoverage(scaled.components, { x: 0, y: 0, width: tw, height: th }, vm.fillRule ?? "nonzero", vm.inverted === true);
+  const data = new Uint8ClampedArray(tw * th * 4);
+  for (let i = 0; i < cov.length; i++) {
+    const v = Math.round(Math.min(1, Math.max(0, cov[i])) * 255);
+    data[i * 4] = data[i * 4 + 1] = data[i * 4 + 2] = v;
+    data[i * 4 + 3] = 255;
+  }
+  const pixels = { width: tw, height: th, data };
+  thumbCache.set(vm, { key, pixels });
+  return pixels;
+}
+
+// src/image-editor/layers/ops.ts
+var LayerOperationError = class extends Error {
+  userMessage;
+  constructor(message, userMessage) {
+    super(message);
+    this.name = "LayerOperationError";
+    if (userMessage) this.userMessage = userMessage;
+  }
+};
+function userErrorMessage(err) {
+  if (err instanceof LayerOperationError && err.userMessage) return err.userMessage;
+  return err instanceof Error ? err.message : String(err);
+}
+function isPaintableLayer(layer) {
+  return layer.type === "pixel" && layer.visible && !isLayerLocked(layer, "pixels");
+}
+function defaultActiveLayerId(layers) {
+  const pixels = flattenLayers(layers).filter((l) => l.type === "pixel");
+  for (let i = pixels.length - 1; i >= 0; i--) if (isPaintableLayer(pixels[i])) return pixels[i].id;
+  return pixels[pixels.length - 1]?.id ?? null;
+}
+function activeLayerAfterRemoval(prev, next, removedId) {
+  const before = flattenLayers(prev);
+  const at = before.findIndex((l) => l.id === removedId);
+  for (let i = at - 1; i >= 0; i--) {
+    const loc = findLayer(next, before[i].id);
+    if (loc && isPaintableLayer(loc.layer)) return loc.layer.id;
+  }
+  return defaultActiveLayerId(next);
+}
+var fail2 = (message) => {
+  throw new LayerOperationError(message);
+};
+function requireLayer(layers, id) {
+  const loc = findLayer(layers, id);
+  if (!loc) {
+    const ids = flattenLayers(layers).map((l) => l.id);
+    fail2(`Unknown layer "${id}". ${ids.length ? `Layers: ${ids.join(", ")}.` : "The document has no layers."} Call list_layers for ids.`);
+  }
+  return loc;
+}
+function requireUnlocked(layer, what, action) {
+  if (isLayerLocked(layer, "all")) fail2(`Layer "${layer.name || layer.id}" is locked (all); unlock it before you ${action}.`);
+  if (what !== "all" && isLayerLocked(layer, what)) fail2(`Layer "${layer.name || layer.id}" has its ${what} locked; unlock it before you ${action}.`);
+}
+function placeLayer(layers, layer, placement = {}, defaultIndex) {
+  const given = [placement.aboveId, placement.belowId, placement.parentId].filter((v) => v !== void 0).length;
+  if (given > 1) fail2("Give only one of aboveId, belowId and parentId.");
+  if (placement.aboveId || placement.belowId) {
+    const ref = requireLayer(layers, placement.aboveId ?? placement.belowId);
+    return insertLayer(layers, layer, ref.parent?.id ?? null, ref.index + (placement.aboveId ? 1 : 0));
+  }
+  if (placement.parentId) {
+    const ref = requireLayer(layers, placement.parentId);
+    if (ref.layer.type !== "group") fail2(`Layer "${placement.parentId}" is not a group; parentId must be a group id.`);
+    return insertLayer(layers, layer, ref.layer.id, placement.index);
+  }
+  return insertLayer(layers, layer, null, placement.index ?? defaultIndex);
+}
+function removeLayer(layers, id) {
+  const loc = requireLayer(layers, id);
+  requireUnlocked(loc.layer, "all", "delete it");
+  return mapLayer(layers, id, () => null);
+}
+function moveLayer(layers, id, placement) {
+  const loc = requireLayer(layers, id);
+  requireUnlocked(loc.layer, "all", "move it");
+  const target = placement.aboveId ?? placement.belowId ?? placement.parentId;
+  if (target === id) fail2("A layer cannot be placed relative to itself.");
+  if (target && loc.layer.type === "group" && flattenLayers(loc.layer.children).some((l) => l.id === target)) {
+    fail2(`Group "${id}" cannot be moved into its own child "${target}".`);
+  }
+  if (target) requireLayer(layers, target);
+  if (!target && placement.index === void 0) fail2("Give aboveId, belowId, parentId or index.");
+  const without = mapLayer(layers, id, () => null);
+  return placeLayer(without, loc.layer, placement);
+}
+function withNewIds(layer) {
+  const next = { ...layer, id: newLayerId(layer.type === "adjustment" ? "adj" : layer.type) };
+  if (next.type === "group") next.children = next.children.map(withNewIds);
+  if (next.type === "annotation") next.annotation = { ...next.annotation, id: next.id };
+  if (next.type === "shape" || next.type === "type") delete next.annotation;
+  if (next.type === "smart" && next.psd?.placed) {
+    next.psd = { ...next.psd };
+    delete next.psd.placed;
+  }
+  return next;
+}
+function duplicateLayer(layers, id, name) {
+  const loc = requireLayer(layers, id);
+  const copy = withNewIds(loc.layer);
+  copy.name = name ?? `${loc.layer.name || "Layer"} copy`;
+  delete copy.locks;
+  return { layers: insertLayer(layers, copy, loc.parent?.id ?? null, loc.index + 1), id: copy.id };
+}
+function setLayerProperties(layers, id, props) {
+  const loc = requireLayer(layers, id);
+  const layer = loc.layer;
+  const onlyUnlocking = Object.keys(props).every((k) => k === "locks" || k === "visible" || k === "collapsed");
+  if (!onlyUnlocking) requireUnlocked(layer, "all", "change its properties");
+  const next = { ...layer };
+  if (props.name !== void 0) {
+    if (typeof props.name !== "string" || !props.name.trim()) fail2("name must be a non-empty string.");
+    next.name = props.name.trim();
+  }
+  if (props.visible !== void 0) next.visible = Boolean(props.visible);
+  if (props.opacity !== void 0) {
+    if (!(typeof props.opacity === "number" && props.opacity >= 0 && props.opacity <= 1)) fail2("opacity must be a number from 0 to 1.");
+    next.opacity = props.opacity;
+  }
+  if (props.fillOpacity !== void 0) {
+    if (layer.type !== "pixel" && layer.type !== "smart" && layer.type !== "shape" && layer.type !== "type") fail2(`fillOpacity applies to pixel, shape, type and smart object layers; "${id}" is a ${layer.type} layer.`);
+    if (!(typeof props.fillOpacity === "number" && props.fillOpacity >= 0 && props.fillOpacity <= 1)) fail2("fillOpacity must be a number from 0 to 1.");
+    const p = next;
+    if (props.fillOpacity === 1) delete p.fillOpacity;
+    else p.fillOpacity = props.fillOpacity;
+  }
+  if (props.blend !== void 0) {
+    if (props.blend === "pass-through") {
+      if (layer.type !== "group") fail2("pass-through is only for groups.");
+    } else if (!isBlendMode(props.blend)) fail2(`Unknown blend mode "${props.blend}".`);
+    next.blend = props.blend;
+  }
+  if (props.clipped !== void 0) {
+    if (props.clipped && loc.index === 0) fail2("The bottom layer of a group or the stack has nothing below to clip to.");
+    if (props.clipped) next.clipped = true;
+    else delete next.clipped;
+  }
+  if (props.locks !== void 0) {
+    const locks = {};
+    for (const k of ["pixels", "transparency", "position", "all"]) if (props.locks[k]) locks[k] = true;
+    if (Object.keys(locks).length) next.locks = locks;
+    else delete next.locks;
+  }
+  if (props.collapsed !== void 0) {
+    if (layer.type !== "group") fail2("collapsed applies to groups.");
+    const g = next;
+    if (props.collapsed) g.collapsed = true;
+    else delete g.collapsed;
+  }
+  return mapLayer(layers, id, () => next);
+}
+function groupLayers(layers, ids, name = "Group") {
+  if (!ids.length) fail2("Give at least one layer id to group.");
+  const locs = ids.map((id) => requireLayer(layers, id));
+  const parent = locs[0].parent?.id ?? null;
+  if (locs.some((l) => (l.parent?.id ?? null) !== parent)) fail2("Layers to group must share one parent; move them next to each other first.");
+  for (const l of locs) requireUnlocked(l.layer, "all", "group it");
+  const ordered = [...new Set(locs)].sort((a, b) => a.index - b.index);
+  const top = ordered[ordered.length - 1].index;
+  const below = ordered.filter((l) => l.index < top).length;
+  const group = {
+    type: "group",
+    id: newLayerId("group"),
+    name,
+    visible: true,
+    opacity: 1,
+    blend: "pass-through",
+    children: ordered.map((l) => {
+      const c = { ...l.layer };
+      return c;
+    })
+  };
+  if (group.children[0]?.clipped) {
+    const c = { ...group.children[0] };
+    delete c.clipped;
+    group.children[0] = c;
+  }
+  let out = layers;
+  for (const l of ordered) out = mapLayer(out, l.layer.id, () => null);
+  return { layers: insertLayer(out, group, parent, top - below), id: group.id };
+}
+function ungroupLayer(layers, id) {
+  const loc = requireLayer(layers, id);
+  if (loc.layer.type !== "group") fail2(`Layer "${id}" is not a group.`);
+  requireUnlocked(loc.layer, "all", "ungroup it");
+  const group = loc.layer;
+  let out = mapLayer(layers, id, () => null);
+  group.children.forEach((c, i) => {
+    out = insertLayer(out, c, loc.parent?.id ?? null, loc.index + i);
+  });
+  return { layers: out, ids: group.children.map((c) => c.id) };
+}
+function offsetLayer(layers, id, offset) {
+  const loc = requireLayer(layers, id);
+  if (loc.layer.type !== "pixel") fail2(`Only pixel layers move; "${id}" is a ${loc.layer.type} layer.`);
+  requireUnlocked(loc.layer, "position", "move it");
+  if (!Number.isFinite(offset.x) || !Number.isFinite(offset.y)) fail2("x and y must be numbers.");
+  const layer = loc.layer;
+  const next = { ...layer, offset: { x: Math.round(offset.x), y: Math.round(offset.y) } };
+  const mask = layer.mask;
+  if (mask && mask.linked === false && !mask.source) {
+    next.mask = { ...mask, surface: translateSurface(mask.surface, layer.offset.x - next.offset.x, layer.offset.y - next.offset.y) };
+  }
+  return mapLayer(layers, id, () => followLayerMove(next, next.offset.x - layer.offset.x, next.offset.y - layer.offset.y));
+}
+function setLayerMask(layers, id, mask) {
+  const loc = requireLayer(layers, id);
+  requireUnlocked(loc.layer, "all", "change its mask");
+  return mapLayer(layers, id, (l) => {
+    const next = { ...l };
+    if (mask) next.mask = mask;
+    else delete next.mask;
+    return next;
+  });
+}
+var DEVELOP_FIELDS = ["brightness", "contrast", "saturation", "exposure", "temperature", "tint"];
+function normalizeFilter(raw, id = newLayerId("flt")) {
+  const enabled = raw.enabled !== false;
+  if (raw.kind === "blur") {
+    const r = raw.radius;
+    if (r !== void 0 && !(typeof r === "number" && r >= 0 && r <= 50)) fail2("blur radius must be a number from 0 to 50 px.");
+    return { id, kind: "blur", enabled, radius: typeof r === "number" ? r : 2 };
+  }
+  if (raw.kind !== "develop") fail2(`Unknown filter kind "${raw.kind}". Use develop or blur.`);
+  const out = { id, kind: "develop", enabled, brightness: 0, contrast: 0, saturation: 0, exposure: 0, temperature: 0, tint: 0, process: 2 };
+  for (const k of DEVELOP_FIELDS) {
+    const v = raw[k];
+    if (v === void 0) continue;
+    if (!(typeof v === "number" && v >= -100 && v <= 100)) fail2(`${k} must be a number from -100 to 100.`);
+    out[k] = v;
+  }
+  const p = raw.process;
+  if (p !== void 0) {
+    if (p !== 1 && p !== 2) fail2("process must be 1 or 2.");
+    out.process = p;
+  }
+  return out;
+}
+function requirePixelLayer(layers, id) {
+  const loc = requireLayer(layers, id);
+  if (loc.layer.type !== "pixel") fail2(`Filters belong to pixel layers; "${id}" is a ${loc.layer.type} layer.`);
+  requireUnlocked(loc.layer, "all", "change its filters");
+  return loc.layer;
+}
+function addLayerFilter(layers, id, filter) {
+  const layer = requirePixelLayer(layers, id);
+  if (layer.filters?.some((f) => f.kind === filter.kind)) fail2(`Layer "${id}" already has a ${filter.kind} filter; change it with update_layer_filter.`);
+  return mapLayer(layers, id, () => ({ ...layer, filters: [...layer.filters ?? [], filter] }));
+}
+function updateLayerFilter(layers, id, filterId, changes) {
+  const layer = requirePixelLayer(layers, id);
+  const i = (layer.filters ?? []).findIndex((f) => f.id === filterId);
+  if (i === -1) fail2(`Layer "${id}" has no filter "${filterId}". Filters: ${(layer.filters ?? []).map((f) => f.id).join(", ") || "none"}.`);
+  const current = layer.filters[i];
+  if ("kind" in changes && changes.kind !== current.kind) fail2("A filter kind cannot change; remove it and add another.");
+  const merged2 = normalizeFilter({ ...current, ...changes, kind: current.kind }, current.id);
+  const filters = [...layer.filters];
+  filters[i] = merged2;
+  return mapLayer(layers, id, () => ({ ...layer, filters }));
+}
+function removeLayerFilter(layers, id, filterId) {
+  const layer = requirePixelLayer(layers, id);
+  if (!(layer.filters ?? []).some((f) => f.id === filterId)) fail2(`Layer "${id}" has no filter "${filterId}".`);
+  const filters = layer.filters.filter((f) => f.id !== filterId);
+  const next = { ...layer };
+  if (filters.length) next.filters = filters;
+  else delete next.filters;
+  return mapLayer(layers, id, () => next);
+}
+function requireEffectLayer(layers, id, action) {
+  const layer = requireLayer(layers, id).layer;
+  if (layer.type === "adjustment") fail2(`Layer "${layer.name || id}" is an adjustment layer; effects go on pixel, annotation and group layers.`);
+  requireUnlocked(layer, "all", action);
+  return layer;
+}
+function layerEffectsOf(layer) {
+  return layer.effects ?? { enabled: true, items: [] };
+}
+function guard(fn) {
+  try {
+    return fn();
+  } catch (e) {
+    if (e instanceof LayerEffectError) fail2(e.message);
+    throw e;
+  }
+}
+function setLayerEffects(layers, id, effects) {
+  const layer = requireEffectLayer(layers, id, "change its effects");
+  const next = { ...layer };
+  if (effects && (effects.items.length || effects.psd || effects.scale !== void 0 || !effects.enabled)) {
+    guard(() => validateLayerEffects(effects));
+    next.effects = effects;
+  } else delete next.effects;
+  return mapLayer(layers, id, () => next);
+}
+function addLayerEffect(layers, id, kind, params = {}, index) {
+  if (!isLayerEffectKind(kind)) fail2(`Unknown effect kind "${String(kind)}". Kinds: ${LAYER_EFFECT_KINDS.join(", ")}.`);
+  const layer = requireEffectLayer(layers, id, "add effects");
+  const current = layerEffectsOf(layer);
+  const ids = new Set(current.items.map((e) => e.id));
+  let effectId = newEffectId();
+  while (ids.has(effectId)) effectId = newEffectId();
+  const { id: _ignored, kind: _kind, ...rest } = params;
+  const effect = guard(() => mergeLayerEffect(defaultLayerEffect(kind, effectId), rest));
+  const items = [...current.items];
+  const at = index === void 0 ? items.length : Math.max(0, Math.min(items.length, Math.floor(index)));
+  items.splice(at, 0, effect);
+  return { layers: setLayerEffects(layers, id, { ...current, items }), effect };
+}
+function requireEffect(layer, effectId) {
+  const items = layer.effects?.items ?? [];
+  const i = items.findIndex((e) => e.id === effectId);
+  if (i === -1) fail2(`Layer "${layer.name || layer.id}" has no effect "${effectId}". Effects: ${items.map((e) => `${e.id} (${e.kind})`).join(", ") || "none"}; call list_layer_effects.`);
+  return i;
+}
+function updateLayerEffect(layers, id, effectId, changes) {
+  const layer = requireEffectLayer(layers, id, "change its effects");
+  const i = requireEffect(layer, effectId);
+  const current = layer.effects;
+  const items = [...current.items];
+  items[i] = guard(() => mergeLayerEffect(items[i], changes));
+  return setLayerEffects(layers, id, { ...current, items });
+}
+function removeLayerEffect(layers, id, effectId) {
+  const layer = requireEffectLayer(layers, id, "change its effects");
+  requireEffect(layer, effectId);
+  const current = layer.effects;
+  return setLayerEffects(layers, id, { ...current, items: current.items.filter((e) => e.id !== effectId) });
+}
+function setLayerEffectsEnabled(layers, id, enabled, scale) {
+  const layer = requireEffectLayer(layers, id, "change its effects");
+  if (scale !== void 0 && !(Number.isFinite(scale) && scale >= 0.01 && scale <= 10)) fail2(`scale must be from 0.01 to 10 (1 = 100 %), got ${scale}.`);
+  const current = layerEffectsOf(layer);
+  const next = { ...current, enabled };
+  if (scale !== void 0) {
+    if (scale === 1) delete next.scale;
+    else next.scale = scale;
+  }
+  return setLayerEffects(layers, id, next);
+}
+function parseBlend(value, allowPassThrough = false) {
+  if (value === void 0) return void 0;
+  if (value === "pass-through" && allowPassThrough) return value;
+  if (!isBlendMode(value)) fail2(`Unknown blend mode "${String(value)}".`);
+  return value;
+}
+function unionRect(a, b) {
+  if (!a) return b;
+  if (!b) return a;
+  const x = Math.min(a.x, b.x);
+  const y = Math.min(a.y, b.y);
+  return { x, y, width: Math.max(a.x + a.width, b.x + b.width) - x, height: Math.max(a.y + a.height, b.y + b.height) - y };
+}
+
+// src/image-editor/layers/compositor.ts
+var legacyViewCache = /* @__PURE__ */ new WeakMap();
+function adjustmentNodeAsLayer(node) {
+  let view = legacyViewCache.get(node);
+  if (!view) {
+    view = {
+      id: node.id,
+      kind: node.kind,
+      enabled: node.visible,
+      opacity: node.opacity,
+      blend: node.blend,
+      params: node.params
+    };
+    legacyViewCache.set(node, view);
+  }
+  return view;
+}
+function developAdjustments(f) {
+  return {
+    brightness: f.brightness,
+    contrast: f.contrast,
+    saturation: f.saturation,
+    exposure: f.exposure,
+    temperature: f.temperature,
+    tint: f.tint ?? 0,
+    blur: 0,
+    opacity: 1,
+    process: f.process
+  };
+}
+function applyPixelFilters(data, filters) {
+  for (const f of filters) {
+    if (!isActiveFilter(f) || f.kind !== "develop") continue;
+    const adj = developAdjustments(f);
+    if (normalizeProcessVersion(adj.process) === LATEST_PROCESS_VERSION) applyProcess2Adjustments({ data }, adj);
+    else applyLegacyAdjustments({ data }, adj);
+  }
+}
+function depthMaskAlpha(depth, options) {
+  const { mode, depthRange, softness, invert } = options;
+  let v = invert ? 255 - depth : depth;
+  const soft = Math.max(1, softness || 10);
+  const [lo, hi] = depthRange;
+  if (mode === "threshold") {
+    if (v >= hi + soft) return 0;
+    if (v > hi) return Math.round((hi + soft - v) / soft * 255);
+    if (v >= lo) return 255;
+    if (v < lo - soft) return 0;
+    return Math.round((v - (lo - soft)) / soft * 255);
+  }
+  v += lo;
+  return v < 0 ? 0 : v > 255 ? 255 : v;
+}
+function runLayerFilters(data, width, height, filters) {
+  for (const f of filters) {
+    if (!isActiveFilter(f)) continue;
+    if (f.kind === "develop") applyPixelFilters(data, [f]);
+    else if (f.kind === "blur") applyBoxBlur({ width, height, data }, Math.min(Math.round(f.radius), 40));
+  }
+}
+function runLayerFiltersFloat(data, width, height, filters, linear) {
+  for (const f of filters) {
+    if (!isActiveFilter(f)) continue;
+    if (f.kind === "blur") applyBoxBlurFloat({ width, height, data }, Math.min(Math.round(f.radius), 40));
+    else if (f.kind === "develop") {
+      const adj = developAdjustments(f);
+      if (normalizeProcessVersion(adj.process) === LATEST_PROCESS_VERSION) applyProcess2Float(data, adj, linear);
+      else applyLegacyFloat(data, adj, linear);
+    }
+  }
+}
+function filterReach(filters) {
+  let r = 0;
+  for (const f of filters) if (isActiveFilter(f) && f.kind === "blur") r += Math.min(Math.round(f.radius), 40);
+  return r;
+}
+var filterSpecCache = /* @__PURE__ */ new WeakMap();
+function pixelFilterSpec(layer) {
+  const list2 = layer.filters;
+  if (!list2?.length) return null;
+  if (filterSpecCache.has(list2)) return filterSpecCache.get(list2);
+  const filters = list2.filter(isActiveFilter);
+  let spec = null;
+  if (filters.length) {
+    const spatial = filters.some(isSpatialFilter);
+    spec = {
+      key: JSON.stringify(filters),
+      spatial,
+      apply: (data, width, height) => runLayerFilters(data, width, height, filters)
+    };
+  }
+  filterSpecCache.set(list2, spec);
+  return spec;
+}
+var PHOTO_PROFILE = {
+  isFilterLayer: (l) => l.type === "adjustment",
+  applyFilterRun: (layers, acc, _r, masks) => {
+    const views = layers.map(adjustmentNodeAsLayer);
+    applyAdjustmentLayers({ data: acc }, views, masks);
+  },
+  contentTile: (l, r, sources) => l.type === "annotation" ? sources.rasterizeAnnotation?.(l.annotation, r) ?? null : null,
+  /** Annotation layers draw with their annotation's blend mode unless the layer sets one. */
+  contentBlend: (l) => l.type === "annotation" && l.blend === "normal" && l.annotation.blend ? l.annotation.blend : l.blend,
+  layerKey: (l) => l.type === "pixel" ? [l.filters ?? null, l.source ?? null] : l.type === "adjustment" ? [l.kind, l.params] : l.type === "annotation" ? l.annotation : void 0,
+  pixelFilters: (l) => l.type === "pixel" ? pixelFilterSpec(l) : null,
+  /**
+   * A smart object draws its rendered pixels (contents → placement → smart filters) like a pixel
+   * layer, and a shape layer the pixels rendered from its paths.
+   */
+  isPixelLike: (l) => l.type === "smart" || l.type === "shape" || l.type === "type",
+  maskSourcePlane: (source, W, H, sources) => {
+    const opts = source;
+    const depth = sources.depthMap?.(opts) ?? null;
+    if (!depth || depth.width !== W || depth.height !== H) return null;
+    const v = new Float32Array(W * H);
+    for (let i = 0; i < v.length; i++) v[i] = depthMaskAlpha(depth.data[i * 4], opts) / 255;
+    return v;
+  }
+};
+var LayerCompositor = class extends RasterCompositor {
+  constructor(options = {}) {
+    super(PHOTO_PROFILE, options);
+  }
+  // Vector masks reach the engine as part of each layer's raster mask (see `resolveVectorMasks`).
+  composite(layers, rect, sources, options) {
+    return super.composite(resolveVectorMasks(layers, sources.width, sources.height), rect, sources, options);
+  }
+  compositeTiles(layers, rect, sources, onTile, options) {
+    super.compositeTiles(resolveVectorMasks(layers, sources.width, sources.height), rect, sources, onTile, options);
+  }
+  tile(layers, tx, ty, sources) {
+    return super.tile(resolveVectorMasks(layers, sources.width, sources.height), tx, ty, sources);
+  }
+};
+function compositeDeep(layers, rect, sources, depth) {
+  const deep = new DeepCompositor(new LayerCompositor(), PHOTO_PROFILE, {
+    applyFilterRunDeep: (run, acc, _r, masks) => applyAdjustmentLayersFloat(acc, run.map(adjustmentNodeAsLayer), masks),
+    pixelFiltersDeep: (l) => {
+      if (l.type !== "pixel") return null;
+      const filters = (l.filters ?? []).filter(isActiveFilter);
+      if (!filters.length) return null;
+      return { reach: filterReach(filters), apply: (data, width, height, linear) => runLayerFiltersFloat(data, width, height, filters, linear) };
+    }
+  }, depth);
+  return deep.composite(resolveVectorMasks(layers, sources.width, sources.height), rect, sources);
 }
 
 // src/image-editor/layers/text.ts
@@ -5247,6 +5391,7 @@ function offsetSmartObject(layers, id, dx, dy, canvas) {
   const moveMask = (m2) => m2 && m2.linked !== false && !m2.source ? { ...m2, surface: translateSurface(m2.surface, mx, my) } : m2;
   if (layer.mask) next.mask = moveMask(layer.mask);
   if (layer.smartFilters?.mask) next.smartFilters = { ...layer.smartFilters, mask: moveMask(layer.smartFilters.mask) };
+  next = followLayerMove(next, mx, my);
   const spatial = activeSmartFilters(layer.smartFilters).some((f) => f.kind === "blur") || activeEffectSmartFilters(layer.smartFilters).length > 0;
   const b = contentBounds(layer.surface);
   const m = SMART_RENDER_MARGIN;
@@ -5389,9 +5534,9 @@ function convertToSmartObject(layers, ids, canvas, options) {
     const nested = ordered.map((l) => {
       let layer = l.layer;
       if (layer.type === "pixel" && layer.source === "document") {
-        const resolved = { ...layer, surface: options.surfaceOf(layer) };
-        delete resolved.source;
-        layer = resolved;
+        const resolved2 = { ...layer, surface: options.surfaceOf(layer) };
+        delete resolved2.source;
+        layer = resolved2;
       }
       if (flattenLayers([layer]).some((x) => x.type === "pixel" && x.source === "document")) fail4(`Layer "${layer.name || layer.id}" holds the document image inside a group; convert the Background on its own.`);
       return translateLayer(layer, -b.x, -b.y);
@@ -5683,6 +5828,7 @@ function baseFields(layer, ctx) {
   };
   if (layer.clipped) out.clipped = true;
   if (layer.mask) out.mask = serializeMask(layer.mask, `${layer.id}-mask`, ctx);
+  if (layer.vectorMask) out.vectorMask = serializeVectorMask(layer.vectorMask);
   if (layer.locks && Object.values(layer.locks).some(Boolean)) out.locks = { ...layer.locks };
   if (layer.effects) out.effects = serializeEffects(layer.effects);
   return out;
@@ -5707,6 +5853,36 @@ function deserializeEffects(raw) {
   }
   return normalizeLayerEffects({ ...r, psd });
 }
+function serializeVectorMask(vm) {
+  const out = { components: JSON.parse(JSON.stringify(vm.components)) };
+  if (vm.fillRule === "evenodd") out.fillRule = "evenodd";
+  if (vm.inverted) out.inverted = true;
+  if (vm.enabled === false) out.enabled = false;
+  if (vm.linked === false) out.linked = false;
+  if (vm.density !== void 0 && vm.density !== 1) out.density = vm.density;
+  if (vm.feather) out.feather = vm.feather;
+  return out;
+}
+function readVectorMask(r) {
+  if (!Array.isArray(r.components)) throw new Error("its components are missing");
+  const components = r.components.map((raw, i) => {
+    const c = raw;
+    const op = requireOperation(c?.op, `components[${i}].op`);
+    if (c?.live) {
+      const live = normalizeLiveShape(c.live, `components[${i}].live`);
+      return { op, subpaths: liveShapeSubpaths(live), live };
+    }
+    return { op, subpaths: Array.isArray(c?.subpaths) && !c.subpaths.length ? [] : normalizeSubpaths(c?.subpaths, `components[${i}].subpaths`) };
+  });
+  const vm = { components };
+  if (r.fillRule === "evenodd") vm.fillRule = "evenodd";
+  if (r.inverted === true) vm.inverted = true;
+  if (r.enabled === false) vm.enabled = false;
+  if (r.linked === false) vm.linked = false;
+  if (typeof r.density === "number" && r.density !== 1) vm.density = num2(r.density, 0, 1, 1);
+  if (typeof r.feather === "number" && r.feather > 0) vm.feather = num2(r.feather, 0, 1e3, 0);
+  return vm;
+}
 function serializeMask(mask, hint, ctx) {
   const out = { defaultValue: mask.defaultValue };
   if (!mask.source) {
@@ -6114,6 +6290,13 @@ function deserializeLayer(raw, ctx) {
   if (r.clipped === true) base.clipped = true;
   const mask = readMask(r.mask, ctx, `Layer "${base.name || id}"`);
   if (mask) base.mask = mask;
+  if (r.vectorMask && typeof r.vectorMask === "object" && r.type !== "shape") {
+    try {
+      base.vectorMask = readVectorMask(r.vectorMask);
+    } catch (err) {
+      ctx.problems.push(`The vector mask of layer "${base.name || id}" could not be read (${err instanceof Error ? err.message : String(err)}); it was left out.`);
+    }
+  }
   if (r.locks && typeof r.locks === "object") {
     const locks = {};
     for (const k of ["pixels", "transparency", "position", "all"]) if (r.locks[k] === true) locks[k] = true;
@@ -7337,97 +7520,6 @@ function writeAdjustmentBlock(kind, params) {
   throw new Error(`Unknown adjustment kind "${kind}".`);
 }
 
-// src/image-editor/psd/channels.ts
-var hexToRgb2 = (hex) => {
-  const v = parseInt(/^#?([0-9a-f]{6})$/i.exec(hex)?.[1] ?? "ff0000", 16);
-  return [v >> 16 & 255, v >> 8 & 255, v & 255];
-};
-var rgbToHex = (r, g, b) => `#${[r, g, b].map((c) => c.toString(16).padStart(2, "0")).join("")}`;
-function alphaChannelResources(channels) {
-  if (!channels.length) return [];
-  const names = new PsdWriter();
-  for (const c of channels) names.pascal(encodeLegacyName(c.name), 1);
-  const unicode = new PsdWriter();
-  for (const c of channels) unicode.unicode(c.name);
-  const display = new PsdWriter();
-  display.u32(1);
-  for (const c of channels) {
-    const [r, g, b] = hexToRgb2(c.color);
-    display.u16(0);
-    for (const v of [r, g, b, 0]) display.u16(v * 257);
-    display.u16(Math.round(Math.min(1, Math.max(0, c.opacity)) * 100));
-    display.u8(c.indicates === "selected" ? 0 : 1);
-    display.u8(0);
-  }
-  return [
-    { id: 1006, name: "", data: names.result() },
-    { id: 1045, name: "", data: unicode.result() },
-    { id: 1077, name: "", data: display.result() }
-  ];
-}
-function planeTo8(plane, n, depth) {
-  if (depth === 8) return plane.slice(0, n);
-  const out = new Uint8Array(n);
-  const view = new DataView(plane.buffer, plane.byteOffset, plane.byteLength);
-  for (let i = 0; i < n; i++) {
-    if (depth === 16) out[i] = plane[2 * i];
-    else out[i] = Math.round(Math.min(1, Math.max(0, view.getFloat32(4 * i, false))) * 255);
-  }
-  return out;
-}
-function readAlphaChannels(planes, header, first, resource2, warn) {
-  const count = header.channels - first;
-  if (count <= 0 || header.depth === 1) return [];
-  const size = rowBytes(header.width, header.depth) * header.height;
-  const n = header.width * header.height;
-  const names = [];
-  const unicode = resource2(1045);
-  if (unicode) {
-    const r = new PsdReader(unicode);
-    while (r.remaining >= 4 && names.length < count) names.push(r.unicode().replace(/\0+$/, ""));
-  } else {
-    const legacy = resource2(1006);
-    if (legacy) {
-      const r = new PsdReader(legacy);
-      while (r.remaining >= 1 && names.length < count) names.push(new TextDecoder("latin1").decode(r.pascal(1)));
-    }
-  }
-  const display = [];
-  const info = resource2(1077);
-  if (info && info.length >= 4) {
-    const r = new PsdReader(info);
-    r.u32();
-    while (r.remaining >= 14 && display.length < count) {
-      r.u16();
-      const [cr, cg, cb] = [r.u16(), r.u16(), r.u16()];
-      r.u16();
-      const opacity = r.u16();
-      const kind = r.u8();
-      r.u8();
-      display.push({ color: rgbToHex(cr >> 8, cg >> 8, cb >> 8), opacity: Math.min(100, opacity) / 100, kind });
-    }
-  }
-  const out = [];
-  for (let i = 0; i < count; i++) {
-    const start = (first + i) * size;
-    if (start + size > planes.length) break;
-    const d = display[i];
-    const name = names[i] || `Alpha ${i + 1}`;
-    if (d?.kind === 2) {
-      warn(`Spot colour channel "${name}" is not supported and was left out.`);
-      continue;
-    }
-    out.push({
-      name,
-      data: planeTo8(planes.subarray(start, start + size), n, header.depth),
-      color: d?.color ?? "#ff0000",
-      opacity: d?.opacity ?? 0.5,
-      indicates: d?.kind === 0 ? "selected" : "masked"
-    });
-  }
-  return out;
-}
-
 // src/image-editor/psd/paths.ts
 var RECORD = 26;
 var fixed = (v) => v / 16777216;
@@ -7487,6 +7579,8 @@ function writePathRecords(path) {
   return w.result();
 }
 var VMSK_INVERT = 1;
+var VMSK_NOT_LINKED = 2;
+var VMSK_DISABLED = 4;
 function readVectorBlock(data) {
   if (data.length < 8) return null;
   const r = new PsdReader(data);
@@ -7557,6 +7651,97 @@ function vectorBlockForComponents(components, inverted, width, height, flags = 0
   return writeVectorBlock({ subpaths, initialFill: subpaths.length === 0 && inverted }, flags & ~VMSK_INVERT | (inverted && subpaths.length ? VMSK_INVERT : 0));
 }
 
+// src/image-editor/psd/channels.ts
+var hexToRgb2 = (hex) => {
+  const v = parseInt(/^#?([0-9a-f]{6})$/i.exec(hex)?.[1] ?? "ff0000", 16);
+  return [v >> 16 & 255, v >> 8 & 255, v & 255];
+};
+var rgbToHex = (r, g, b) => `#${[r, g, b].map((c) => c.toString(16).padStart(2, "0")).join("")}`;
+function alphaChannelResources(channels) {
+  if (!channels.length) return [];
+  const names = new PsdWriter();
+  for (const c of channels) names.pascal(encodeLegacyName(c.name), 1);
+  const unicode = new PsdWriter();
+  for (const c of channels) unicode.unicode(c.name);
+  const display = new PsdWriter();
+  display.u32(1);
+  for (const c of channels) {
+    const [r, g, b] = hexToRgb2(c.color);
+    display.u16(0);
+    for (const v of [r, g, b, 0]) display.u16(v * 257);
+    display.u16(Math.round(Math.min(1, Math.max(0, c.opacity)) * 100));
+    display.u8(c.indicates === "selected" ? 0 : 1);
+    display.u8(0);
+  }
+  return [
+    { id: 1006, name: "", data: names.result() },
+    { id: 1045, name: "", data: unicode.result() },
+    { id: 1077, name: "", data: display.result() }
+  ];
+}
+function planeTo8(plane, n, depth) {
+  if (depth === 8) return plane.slice(0, n);
+  const out = new Uint8Array(n);
+  const view = new DataView(plane.buffer, plane.byteOffset, plane.byteLength);
+  for (let i = 0; i < n; i++) {
+    if (depth === 16) out[i] = plane[2 * i];
+    else out[i] = Math.round(Math.min(1, Math.max(0, view.getFloat32(4 * i, false))) * 255);
+  }
+  return out;
+}
+function readAlphaChannels(planes, header, first, resource2, warn) {
+  const count = header.channels - first;
+  if (count <= 0 || header.depth === 1) return [];
+  const size = rowBytes(header.width, header.depth) * header.height;
+  const n = header.width * header.height;
+  const names = [];
+  const unicode = resource2(1045);
+  if (unicode) {
+    const r = new PsdReader(unicode);
+    while (r.remaining >= 4 && names.length < count) names.push(r.unicode().replace(/\0+$/, ""));
+  } else {
+    const legacy = resource2(1006);
+    if (legacy) {
+      const r = new PsdReader(legacy);
+      while (r.remaining >= 1 && names.length < count) names.push(new TextDecoder("latin1").decode(r.pascal(1)));
+    }
+  }
+  const display = [];
+  const info = resource2(1077);
+  if (info && info.length >= 4) {
+    const r = new PsdReader(info);
+    r.u32();
+    while (r.remaining >= 14 && display.length < count) {
+      r.u16();
+      const [cr, cg, cb] = [r.u16(), r.u16(), r.u16()];
+      r.u16();
+      const opacity = r.u16();
+      const kind = r.u8();
+      r.u8();
+      display.push({ color: rgbToHex(cr >> 8, cg >> 8, cb >> 8), opacity: Math.min(100, opacity) / 100, kind });
+    }
+  }
+  const out = [];
+  for (let i = 0; i < count; i++) {
+    const start = (first + i) * size;
+    if (start + size > planes.length) break;
+    const d = display[i];
+    const name = names[i] || `Alpha ${i + 1}`;
+    if (d?.kind === 2) {
+      warn(`Spot colour channel "${name}" is not supported and was left out.`);
+      continue;
+    }
+    out.push({
+      name,
+      data: planeTo8(planes.subarray(start, start + size), n, header.depth),
+      color: d?.color ?? "#ff0000",
+      opacity: d?.opacity ?? 0.5,
+      indicates: d?.kind === 0 ? "selected" : "masked"
+    });
+  }
+  return out;
+}
+
 // src/image-editor/psd/shapes.ts
 var SHAPE_PSD_KEYS = ["vsms", "vmsk", "vscg", "vstk", "vogk", "SoCo", "GdFl", "PtFl"];
 var unit = (u, value) => ({ type: "UntF", unit: u, value });
@@ -10188,9 +10373,22 @@ function baseProps(ctx, rec, name, notes) {
     ctx.warn.add("Artboards are not supported; they came in as plain groups, without their background colour and clipping", name);
     notes.push("artboard imported as a group");
   }
-  if (rec.blocks.some((b) => VECTOR_KEYS.includes(b.key)) && psdKind(rec) === "pixel") {
-    ctx.warn.add("Vector masks are not supported and were ignored", name);
-    notes.push("vector mask ignored");
+  const vectorBlock = psdKind(rec) === "shape" ? void 0 : rec.blocks.find((b) => b.key === "vsms") ?? rec.blocks.find((b) => b.key === "vmsk");
+  if (vectorBlock) {
+    const read2 = componentsFromVectorBlock(vectorBlock.data, ctx.file.header.width, ctx.file.header.height);
+    if (read2) {
+      const vm = { components: read2.components };
+      if (read2.inverted) vm.inverted = true;
+      if (read2.flags & VMSK_NOT_LINKED) vm.linked = false;
+      if (read2.flags & VMSK_DISABLED) vm.enabled = false;
+      const m = rec.mask;
+      if (m?.vectorDensity !== void 0 && m.vectorDensity < 255) vm.density = percent(m.vectorDensity);
+      if (m?.vectorFeather !== void 0 && m.vectorFeather > 0) vm.feather = Math.min(1e3, m.vectorFeather);
+      props.vectorMask = vm;
+    } else {
+      ctx.warn.add("A vector mask could not be read and was ignored", name);
+      notes.push("vector mask ignored");
+    }
   }
   return props;
 }
@@ -11539,6 +11737,13 @@ function exportPsd(input) {
     if (fx) blocks.push(fx);
     const locks = lockBits(layer);
     if (locks) blocks.push({ key: "lspf", data: u32Bytes(locks >>> 0) });
+    const vm = layer.type !== "shape" ? layer.vectorMask : void 0;
+    if (vm) {
+      const flags = (vm.linked === false ? VMSK_NOT_LINKED : 0) | (vm.enabled === false ? VMSK_DISABLED : 0);
+      blocks.push({ key: "vmsk", data: vectorBlockForComponents(vm.components, vm.inverted === true, width, height, flags) });
+      if ((vm.density ?? 1) !== 1 || (vm.feather ?? 0) > 0) note("Vector mask density and feather are not written; the paths are", layer.name);
+      if (vm.fillRule === "evenodd") note("Vector masks are written with the nonzero fill rule (Photoshop has no even-odd paths)", layer.name);
+    }
     return {
       opacity: Math.round(Math.min(1, Math.max(0, layer.opacity)) * 255),
       clipping: layer.clipped ? 1 : 0,
@@ -11934,6 +12139,8 @@ export {
   applyBoxBlur,
   applyDepthMask,
   removeAlpha,
+  flattenPath,
+  rasterizeCoverage,
   TEXT_ALIGNS,
   MAX_EFFECT_ANIMATION_MS,
   SHAPE_OPERATIONS,
@@ -11950,17 +12157,6 @@ export {
   isRenderedLayer,
   shapeLayers,
   smartObjectLayers,
-  adjustmentNodeAsLayer,
-  depthMaskAlpha,
-  runLayerFilters,
-  runLayerFiltersFloat,
-  LayerCompositor,
-  compositeDeep,
-  DEFAULT_ADJUSTMENTS_VALUES,
-  DEFAULT_TRANSFORM_VALUES,
-  DEFAULT_DEPTH_MASK_VALUES,
-  flattenPath,
-  rasterizeCoverage,
   LayerOperationError,
   userErrorMessage,
   isPaintableLayer,
@@ -11998,6 +12194,7 @@ export {
   componentPath,
   shapeOutline,
   shapeGeometryBounds,
+  componentsCoverage,
   shapeRenderClip,
   renderShapeRect,
   renderShape,
@@ -12018,6 +12215,24 @@ export {
   shapeFromAnnotation,
   annotationBlend,
   annotationOfShape,
+  isActiveVectorMask,
+  vectorMaskCoverage,
+  effectiveLayerMask,
+  resolveVectorMasks,
+  offsetVectorMask,
+  transformVectorMask,
+  followLayerMove,
+  vectorMaskBounds,
+  vectorMaskThumbnail,
+  adjustmentNodeAsLayer,
+  depthMaskAlpha,
+  runLayerFilters,
+  runLayerFiltersFloat,
+  LayerCompositor,
+  compositeDeep,
+  DEFAULT_ADJUSTMENTS_VALUES,
+  DEFAULT_TRANSFORM_VALUES,
+  DEFAULT_DEPTH_MASK_VALUES,
   TEXT_RENDER_MARGIN,
   textMatrix,
   textOutlines,