@pixerate/editor 0.224.1 → 0.226.0

package/dist/image-editor/index.js

@@ -405,7 +405,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-S6KKLFZO.js";
+} from "../chunk-5YLOU7VF.js";
 import {
   parseCssColor
 } from "../chunk-3CI7FRMK.js";
@@ -743,7 +743,7 @@ import {
   createEffectToolProvider,
   linearToSrgb,
   resolveEffectValues
-} from "../chunk-HKPLKISO.js";
+} from "../chunk-7DZ55AIE.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   BrushstrokeCache,
@@ -6545,7 +6545,7 @@ var ImageEditorController = class {
       id = res2.layer.id;
       converted = true;
     }
-    const filter = normalizeSmartFilter({ kind: "effect", effect: d.id, provider: this.effects.require().id, name: d.name, values, enabled: options.enabled !== false, blend: options.blend, opacity: options.opacity });
+    const filter = normalizeSmartFilter({ kind: "effect", effect: d.id, provider: this.effects.require().id, name: d.name, values, enabled: options.enabled !== false, blend: options.blend, opacity: options.opacity, preserveTransparency: options.preserveTransparency });
     const res = addSmartFilter(layers, id, filter, this.canvasSize, options.index);
     const masked = this.asOneStep(() => {
       this.commitLayers(res.layers);
@@ -6555,7 +6555,8 @@ var ImageEditorController = class {
   }
   /**
    * Changes an effect smart filter: `values` merged over its own (`null` resets a control to the
-   * effect's default), `enabled`, `blend`, `opacity` or its place in the stack (`index`). Values
+   * effect's default), `enabled`, `blend`, `opacity`, `preserveTransparency` or its place in the
+   * stack (`index`). Values
    * are checked against the provider's controls. One undo step (none with `commitToHistory`
    * false, during a drag).
    */
@@ -6575,7 +6576,7 @@ var ImageEditorController = class {
       }
       update.values = { ...base, ...resolveEffectValues({ ...d, defaults: base }, given) };
     }
-    for (const k of ["enabled", "blend", "opacity"]) if (changes[k] !== void 0) update[k] = changes[k];
+    for (const k of ["enabled", "blend", "opacity", "preserveTransparency"]) if (changes[k] !== void 0) update[k] = changes[k];
     let res = updateSmartFilter(this.state.layers, layerId, filterId, update, this.canvasSize);
     if (changes.index !== void 0) res = { ...res, layers: moveSmartFilter(res.layers, layerId, filterId, changes.index, this.canvasSize).layers };
     this.commitLayers(res.layers, void 0, commitToHistory);
@@ -6586,8 +6587,9 @@ var ImageEditorController = class {
    * the document's size and bit depth (at `time` ms, default 0), placed like `addPixelLayer`. One
    * undo step. Masks, blend and opacity apply as to any layer. An effect with a background of its
    * own (`backgroundOpacity`) starts with it transparent when there are layers below it, unless
-   * `values` set it. `animate` makes it play when the document is output as an animation. Returns
-   * its id.
+   * `values` set it. `animate` makes it play when the document is output as an animation.
+   * `clipped` clips it to the layer below (a clipping mask) in the same step, so it only shows
+   * over that layer's pixels. Returns its id.
    */
   async addEffectLayer(effect, options = {}) {
     const d = await this.describeEffect(effect, "layer");
@@ -6598,6 +6600,7 @@ var ImageEditorController = class {
     const ids = new Set(flattenLayers(this.state.layers).map((l) => l.id));
     const id = options.id && !ids.has(options.id) ? options.id : newLayerId();
     const placed = placeLayer(this.state.layers, { type: "pixel", id, name: "", visible: true, opacity: 1, blend: "normal", surface: emptySurface(4), offset: { x: 0, y: 0 } }, this.newLayerPlacement(options));
+    if (options.clipped) requireClipBase(placed, id);
     const values = resolveEffectValues(d, withBackgroundOpacity(d, options.values, hasLayersBelow(placed, id)));
     const { width, height } = this.naturalSize;
     const pixels = await this.effectsEngine.renderLayer(d.id, values, { width, height, depth: this.bitDepth, time });
@@ -6610,7 +6613,8 @@ var ImageEditorController = class {
       blend: blend ?? "normal",
       surface: effectPixelsToSurface(pixels, this.bitDepth),
       offset: { x: 0, y: 0 },
-      generator: { effect: d.id, provider: this.effects.require().id, name: d.name, values, ...time ? { time } : {}, ...animate ? { animate } : {} }
+      generator: { effect: d.id, provider: this.effects.require().id, name: d.name, values, ...time ? { time } : {}, ...animate ? { animate } : {} },
+      ...options.clipped ? { clipped: true } : {}
     };
     const next = mapLayer(placed, id, () => layer);
     this.commitLayers(next, () => {
@@ -9763,6 +9767,7 @@ var ImageEditorController = class {
    * above the other adjustment layers (or, without any, above the topmost non-annotation layer,
    * so annotations stay on top); `index` counts adjustment layers (0 = below the others);
    * `aboveId` / `parentId` place it anywhere in the stack. `kind` alone gives neutral parameters.
+   * `clipped` clips it to the layer below in the same step, so it only adjusts that layer.
    */
   addAdjustmentLayer(init, index) {
     const spec = typeof init === "string" ? { kind: init } : init;
@@ -9778,14 +9783,17 @@ var ImageEditorController = class {
     });
     while (ids.has(layer.id)) layer.id = newLayerId("adj");
     const { width, height } = this.naturalSize;
-    this.recordHistory();
     const node = adjustmentNodeFromLegacy(layer, width, height);
+    if (spec.clipped) node.clipped = true;
     const positioned = Boolean(spec.aboveId || spec.parentId);
-    this.state.layers = this.placeLayer(this.state.layers, node, {
+    const placed = this.placeLayer(this.state.layers, node, {
       aboveId: spec.aboveId,
       parentId: spec.parentId,
       adjustmentIndex: index !== void 0 ? index : positioned ? void 0 : Infinity
     });
+    if (spec.clipped) requireClipBase(placed, node.id);
+    this.recordHistory();
+    this.state.layers = placed;
     this.notify();
     return layer.id;
   }
@@ -12652,6 +12660,9 @@ function serializeAdjustments(adjustments) {
   }
   return out;
 }
+function requireClipBase(layers, id) {
+  if (findLayer(layers, id)?.index === 0) throw new LayerOperationError("There is no layer below the new layer to clip it to: it would be the bottom layer of its group or the stack. Put it directly above the layer to clip to (aboveId), or leave clipped false.");
+}
 function withDevelop(layer, partial) {
   const filters = [...layer.filters ?? []];
   let i = filters.findIndex((f) => f.kind === "develop");
@@ -19713,7 +19724,7 @@ function createImageEditorToolProvider(controller, options = {}) {
   const addLayer = {
     name: "add_adjustment_layer",
     title: "Add an adjustment layer",
-    description: "Adds a non-destructive adjustment layer on top of the stack (one undoable step) and returns it; with a selection it is masked by it (useSelection, default true; masked in the result says so). Kinds: " + ADJUSTMENT_KINDS.map((k) => k.kind).join(", ") + ". Omitted params are neutral.",
+    description: "Adds a non-destructive adjustment layer on top of the stack (one undoable step) and returns it; with a selection it is masked by it (useSelection, default true; masked in the result says so). clipped clips it to the layer directly below in the same step, so it adjusts only that layer (clipped in the result). Kinds: " + ADJUSTMENT_KINDS.map((k) => k.kind).join(", ") + ". Omitted params are neutral.",
     inputSchema: {
       type: "object",
       properties: {
@@ -19724,7 +19735,8 @@ function createImageEditorToolProvider(controller, options = {}) {
         name: { type: "string", description: "Layer name shown in the layers panel." },
         aboveId: { type: "string", description: "Put the layer directly above this layer (from list_layers). Default: above the other adjustment layers, below annotations." },
         parentId: { type: "string", description: "Put the layer at the top of this group (from list_layers)." },
-        useSelection: { type: "boolean", description: "With a selection, mask the new layer with it so the adjustment only affects the selected area (default true; false for a global layer)." }
+        useSelection: { type: "boolean", description: "With a selection, mask the new layer with it so the adjustment only affects the selected area (default true; false for a global layer)." },
+        clipped: { type: "boolean", description: "Clip it to the layer directly below (a clipping mask) so it adjusts only that layer (default false). Use with aboveId; refused when nothing is below it in its group or the stack." }
       },
       required: ["kind"],
       additionalProperties: false
@@ -19736,7 +19748,7 @@ function createImageEditorToolProvider(controller, options = {}) {
       idempotentHint: false,
       openWorldHint: false
     },
-    handler: ({ kind, params, opacity, blend, name, aboveId, parentId, useSelection }) => {
+    handler: ({ kind, params, opacity, blend, name, aboveId, parentId, useSelection, clipped }) => {
       if (!isAdjustmentKind(kind)) throw new Error(`Unknown adjustment kind "${kind}".`);
       if (blend !== void 0 && !isBlendMode(blend)) throw new Error(`Unknown blend mode "${blend}".`);
       if (aboveId !== void 0 && parentId !== void 0) throw new Error("Give aboveId or parentId, not both.");
@@ -19744,9 +19756,9 @@ function createImageEditorToolProvider(controller, options = {}) {
         if (ref !== void 0 && !controller.getLayer(ref)) throw new Error(`Unknown layer "${ref}". Call list_layers for ids.`);
       }
       if (parentId !== void 0 && controller.getLayer(parentId)?.type !== "group") throw new Error(`Layer "${parentId}" is not a group.`);
-      const id = controller.addAdjustmentLayer({ kind, params, opacity, blend, name, aboveId, parentId, useSelection: useSelection !== false });
+      const id = controller.addAdjustmentLayer({ kind, params, opacity, blend, name, aboveId, parentId, useSelection: useSelection !== false, clipped: clipped === true });
       const layer = controller.getAdjustmentLayer(id);
-      return { layer: JSON.parse(JSON.stringify(layer)), index: controller.getAdjustmentLayers().findIndex((l) => l.id === id), masked: Boolean(layer.mask) };
+      return { layer: JSON.parse(JSON.stringify(layer)), index: controller.getAdjustmentLayers().findIndex((l) => l.id === id), masked: Boolean(layer.mask), clipped: Boolean(controller.getLayer(id)?.clipped) };
     }
   };
   const renderPreview = {
@@ -21776,6 +21788,7 @@ var FreeTransformTool = class {
 };
 
 // src/image-editor/provider-effect-tools.ts
+var FILTER_BLEND_SCHEMA = { type: "string", enum: BLEND_MODES.map((m) => m.id).filter((b) => b !== "pigment"), description: "How the effect's result blends with the layer below it in the stack (default normal)." };
 var ANIMATE_SCHEMA = {
   type: "object",
   properties: { duration: { type: "number", exclusiveMinimum: 0, maximum: MAX_EFFECT_ANIMATION_MS, description: `How long it plays in ms (at most ${MAX_EFFECT_ANIMATION_MS}).` } },
@@ -21789,7 +21802,7 @@ function imageLayerAppliedEffects(layer) {
   if (layer.type === "pixel" && layer.generator) out.push({ id: "generator", ...ref(layer.generator), role: "effect layer", enabled: true, values: layer.generator.values, ...layer.generator.time ? { time: layer.generator.time } : {}, ...layer.generator.animate ? { animate: layer.generator.animate } : {} });
   if (layer.type === "smart")
     (layer.smartFilters?.filters ?? []).forEach((f, index) => {
-      if (f.kind === "effect") out.push({ id: f.id, ...ref(f), role: "smart filter", enabled: f.enabled && layer.smartFilters.enabled, opacity: f.opacity, blend: f.blend, values: f.values, index });
+      if (f.kind === "effect") out.push({ id: f.id, ...ref(f), role: "smart filter", enabled: f.enabled && layer.smartFilters.enabled, opacity: f.opacity, blend: f.blend, preserveTransparency: Boolean(f.preserveTransparency), values: f.values, index });
     });
   return out;
 }
@@ -21819,27 +21832,35 @@ function createImageEffectsToolProvider(controller, options = {}) {
     skill: "pixerate-image-editor",
     target: { noun: "layer", id: "A layer id from list_layers." },
     applyUses: ["filter"],
-    applyDetails: "The effect becomes a smart filter: it runs on the layer's pixels after the smart filters below it, with its own blend and opacity, under the smart filter mask, and can be changed or removed later. A pixel, shape or type layer (or a group) is converted to a smart object first, in the same undo step (one layer keeps its id; the result says converted). With a selection, the filter mask is set from it in the same step, so the filter only changes the selected area (the result says masked); deselect first to filter the whole layer. Generators and overlays go on their own layer through add_effect_layer.",
+    applyDetails: "The effect becomes a smart filter: it runs on the layer's pixels after the smart filters below it, with its own blend and opacity, under the smart filter mask, and can be changed or removed later. It keeps the layer's transparency by default (preserveTransparency: the result only changes the layer's own pixels, never fills transparent ones); preserveTransparency false lets it draw over the whole canvas. A pixel, shape or type layer (or a group) is converted to a smart object first, in the same undo step (one layer keeps its id; the result says converted). With a selection, the filter mask is set from it in the same step, so the filter only changes the selected area (the result says masked); deselect first to filter the whole layer. Generators and overlays go on their own layer through add_effect_layer.",
     provider: () => controller.effectsProvider,
     readOnlyReason,
+    applyOptions: {
+      preserveTransparency: { type: "boolean", description: "Keep the layer's transparency: the result is drawn over the layer and takes its alpha, so transparent pixels stay transparent and only the layer's content changes (default true). false lets the effect's own alpha replace the layer's, so a shader can fill the empty area." },
+      blend: FILTER_BLEND_SCHEMA
+    },
+    updateOptions: {
+      preserveTransparency: { type: "boolean", description: "Keep the layer's transparency (true) or let the effect fill transparent pixels (false). Smart filters only." },
+      blend: FILTER_BLEND_SCHEMA
+    },
     list: (target) => {
       const layers = target ? [layerOf(target)] : flattenLayers(controller.getState().layers);
       return layers.map((l) => ({ target: l.id, ...l.name ? { name: l.name } : {}, effects: imageLayerAppliedEffects(l) })).filter((t) => target || t.effects.length);
     },
     apply: async (target, effect, args) => {
-      const r = await controller.applyEffectFilter(target, effect, { values: plainValues(args.values), index: args.index, enabled: args.enabled, opacity: args.opacity, useSelection: true });
+      const r = await controller.applyEffectFilter(target, effect, { values: plainValues(args.values), index: args.index, enabled: args.enabled, opacity: args.opacity, blend: args.blend, preserveTransparency: args.preserveTransparency !== false, useSelection: true });
       return result(r.layerId, r.filter.id, { converted: r.converted, masked: r.masked });
     },
     update: async (target, instance, changes) => {
       const layer = layerOf(target);
       if (instance === "generator") {
-        const extra = ["enabled", "opacity", "index"].filter((k) => changes[k] !== void 0);
+        const extra = ["enabled", "opacity", "index", "blend", "preserveTransparency"].filter((k) => changes[k] !== void 0);
         if (extra.length) throw new Error(`An effect layer's own effect only takes values; change the layer's ${extra.join(", ")} with update_layer.`);
         if (layer.type !== "pixel" || !layer.generator) throw new Error(`"${target}" is not an effect layer.`);
         await controller.updateEffectLayer(target, { values: changes.values });
         return result(target, "generator");
       }
-      await controller.updateEffectFilter(target, instance, { values: changes.values, enabled: changes.enabled, opacity: changes.opacity, index: changes.index });
+      await controller.updateEffectFilter(target, instance, { values: changes.values, enabled: changes.enabled, opacity: changes.opacity, index: changes.index, blend: changes.blend, preserveTransparency: changes.preserveTransparency });
       return result(target, instance);
     },
     remove: async (target, instance) => {
@@ -21855,7 +21876,7 @@ function createImageEffectsToolProvider(controller, options = {}) {
       {
         name: "add_effect_layer",
         title: "Add an effect layer",
-        description: `Adds a layer drawn by a provider generator, overlay or title effect (search_effects with use generator, overlay or title) at the document's size and bit depth, above the active layer unless placed. Masks, blend mode, opacity and layer styles apply as to any layer; transparent effects show the layers beneath, and an effect with its own background (describe_effect backgroundOpacity) starts with it transparent when there are layers below, unless values set it. animate makes it play when the document is output as an animation. set_effect_layer changes its effect, frame or animation; update_effect with effect "generator" draws it again with new values; remove_effect "generator" keeps its pixels as a plain layer. One undo step. Returns the new layer id and its effect.`,
+        description: `Adds a layer drawn by a provider generator, overlay or title effect (search_effects with use generator, overlay or title) at the document's size and bit depth, above the active layer unless placed. Masks, blend mode, opacity and layer styles apply as to any layer; transparent effects show the layers beneath, and an effect with its own background (describe_effect backgroundOpacity) starts with it transparent when there are layers below, unless values set it. animate makes it play when the document is output as an animation. clipped clips it to the layer directly below (a clipping mask) in the same step, so it only shows over that layer's pixels. set_effect_layer changes its effect, frame or animation; update_effect with effect "generator" draws it again with new values; remove_effect "generator" keeps its pixels as a plain layer. One undo step. Returns the new layer id, whether it is clipped, and its effect.`,
         inputSchema: {
           type: "object",
           properties: {
@@ -21867,7 +21888,8 @@ function createImageEffectsToolProvider(controller, options = {}) {
             aboveId: { type: "string", minLength: 1, description: "Put it directly above this layer (default: above the active layer, else on top)." },
             belowId: { type: "string", minLength: 1, description: "Put it directly below this layer." },
             opacity: { type: "number", minimum: 0, maximum: 1, description: "Layer opacity 0\u20131 (default 1)." },
-            blend: { type: "string", enum: BLEND_MODES.map((m) => m.id).filter((b) => b !== "pigment"), description: "Layer blend mode (default normal); screen or add for light effects, multiply for textures." }
+            blend: { type: "string", enum: BLEND_MODES.map((m) => m.id).filter((b) => b !== "pigment"), description: "Layer blend mode (default normal); screen or add for light effects, multiply for textures." },
+            clipped: { type: "boolean", description: "Clip it to the layer directly below (a clipping mask), so it only shows over that layer's pixels (default false). Refused when nothing is below it in its group or the stack." }
           },
           required: ["effect"],
           additionalProperties: false
@@ -21875,8 +21897,8 @@ function createImageEffectsToolProvider(controller, options = {}) {
         annotations: { title: "Add an effect layer", ...ctx.annotations.write },
         handler: async (args) => {
           ctx.requireProvider();
-          const id = await controller.addEffectLayer(args.effect, { values: plainValues(args.values), time: args.time, animate: args.animate, name: args.name, aboveId: args.aboveId, belowId: args.belowId, opacity: args.opacity, blend: args.blend });
-          return { layerId: id, effects: imageLayerAppliedEffects(layerOf(id)) };
+          const id = await controller.addEffectLayer(args.effect, { values: plainValues(args.values), time: args.time, animate: args.animate, name: args.name, aboveId: args.aboveId, belowId: args.belowId, opacity: args.opacity, blend: args.blend, clipped: args.clipped });
+          return { layerId: id, clipped: Boolean(layerOf(id).clipped), effects: imageLayerAppliedEffects(layerOf(id)) };
         }
       },
       {

package/dist/image-editor/layers/model.d.cts

@@ -465,6 +465,12 @@ export interface EffectSmartFilter {
     name?: string;
     /** Control values (over the effect's defaults). */
     values: Record<string, EffectValue>;
+    /**
+     * Keep the layer's transparency: the effect's result is drawn over its input and takes the
+     * input's alpha, so it never fills transparent pixels (before the filter's blend and opacity).
+     * Missing means false: the result's alpha replaces the input's.
+     */
+    preserveTransparency?: boolean;
 }
 /** One smart filter: a layer filter, a provider effect or a kept PSD filter, with its own blending over the result below it. */
 export type SmartFilter = (LayerFilter | PsdSmartFilter | EffectSmartFilter) & {

package/dist/image-editor/layers/model.d.ts

@@ -465,6 +465,12 @@ export interface EffectSmartFilter {
     name?: string;
     /** Control values (over the effect's defaults). */
     values: Record<string, EffectValue>;
+    /**
+     * Keep the layer's transparency: the effect's result is drawn over its input and takes the
+     * input's alpha, so it never fills transparent pixels (before the filter's blend and opacity).
+     * Missing means false: the result's alpha replaces the input's.
+     */
+    preserveTransparency?: boolean;
 }
 /** One smart filter: a layer filter, a provider effect or a kept PSD filter, with its own blending over the result below it. */
 export type SmartFilter = (LayerFilter | PsdSmartFilter | EffectSmartFilter) & {

package/dist/paint-editor/index.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8; var _class9; var _class10; var _class11; var _class12;
 
-var _chunkMDNYYOBZcjs = require('../chunk-MDNYYOBZ.cjs');
+var _chunkC6CMQXMIcjs = require('../chunk-C6CMQXMI.cjs');
 
 
 
 
 
 
-var _chunkR35YOUP2cjs = require('../chunk-R35YOUP2.cjs');
+var _chunkIWMDW7LBcjs = require('../chunk-IWMDW7LB.cjs');
 require('../chunk-A2IS7EHE.cjs');
 require('../chunk-SS53NNZO.cjs');
 
@@ -132,7 +132,7 @@ require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('../chunk-ABQ2VGUB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -1659,11 +1659,11 @@ function header(state, options) {
   return out;
 }
 function serializePaintDocument(state, options = {}) {
-  const { layers, assets } = _chunkR35YOUP2cjs.serializeLayers.call(void 0, state.layers);
+  const { layers, assets } = _chunkIWMDW7LBcjs.serializeLayers.call(void 0, state.layers);
   return { ...header(state, options), layers, assets };
 }
 async function serializePaintDocumentExternal(state, store, options = {}) {
-  const { layers, assets } = await _chunkR35YOUP2cjs.serializeLayersExternal.call(void 0, state.layers, store);
+  const { layers, assets } = await _chunkIWMDW7LBcjs.serializeLayersExternal.call(void 0, state.layers, store);
   return { ...header(state, options), layers, assets };
 }
 function paintLayersOnly(layers, problems) {
@@ -1700,7 +1700,7 @@ function deserializePaintDocument(raw) {
   const canvas = normalizeCanvas({ width: r.width, height: r.height, dpi: _nullishCoalesce(r.dpi, () => ( void 0)) });
   const paper = _chunkROVK6AXXcjs.normalizePaper.call(void 0, _nullishCoalesce(r.paper, () => ( {})));
   const assets = r.assets && typeof r.assets === "object" ? r.assets : {};
-  const layers = paintLayersOnly(_chunkR35YOUP2cjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
+  const layers = paintLayersOnly(_chunkIWMDW7LBcjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
   const wanted = typeof r.activeLayerId === "string" ? r.activeLayerId : null;
   const activeLayerId = wanted && _chunkB46UQUDCcjs.findLayer.call(void 0, layers, wanted) ? wanted : _nullishCoalesce(_optionalChain([_chunkB46UQUDCcjs.flattenLayers.call(void 0, layers), 'access', _70 => _70.filter, 'call', _71 => _71((l) => l.type === "pixel"), 'access', _72 => _72.pop, 'call', _73 => _73(), 'optionalAccess', _74 => _74.id]), () => ( null));
   const wetEvents = Array.isArray(r.wetEvents) ? r.wetEvents.filter((e) => e && typeof e === "object" && Number.isInteger(e.clock) && typeof e.kind === "string") : [];
@@ -1716,7 +1716,7 @@ async function deserializePaintDocumentAsync(raw, store) {
   if (!raw || typeof raw !== "object") throw new Error("Not a paint document: expected a JSON object.");
   const r = raw;
   const problems = [];
-  const assets = await _chunkR35YOUP2cjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
+  const assets = await _chunkIWMDW7LBcjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
   const loaded = deserializePaintDocument({ ...r, assets });
   return { ...loaded, problems: [...problems, ...loaded.problems] };
 }
@@ -3198,7 +3198,7 @@ function timeLapseVideo(frameCount, width, height, fps, holdMs, name = "Time-lap
   }
   const video = { version: 1, name, width: w, height: h, fps, background: "#000000", assets, tracks: [{ id: "v1", kind: "video", clips }] };
   const durationMs = frameCount ? clips[clips.length - 1].start + clips[clips.length - 1].duration : 0;
-  return { video, ffmpeg: _chunkMDNYYOBZcjs.toVideoFfmpeg.call(void 0, video, { output: "timelapse.mp4" }), durationMs };
+  return { video, ffmpeg: _chunkC6CMQXMIcjs.toVideoFfmpeg.call(void 0, video, { output: "timelapse.mp4" }), durationMs };
 }
 async function buildTimeLapse(source, target, options = {}) {
   const maxSide = Math.max(32, Math.min(4096, Math.round(_nullishCoalesce(options.maxSide, () => ( 720)))));
@@ -3277,7 +3277,7 @@ function checkPaintEffectPlace(d, place) {
   if (d.uses.includes("filter") && place !== "light") instead = "; run it on a layer's dried paint with apply_effect instead";
   else if (place === "light" && d.uses.some((u) => PAINT_EFFECT_PLACES.layer.includes(u))) instead = "; add it as an effect layer (add_effect_layer) or fill a layer with it (fill_layer_with_effect) instead";
   else if (place === "paper" && d.uses.some((u) => u === "overlay" || u === "title")) instead = "; add it as an effect layer with add_effect_layer instead";
-  throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ") || d.kind} effect, and ${PLACE_WORDS[place]}${instead}.`, d.id);
+  throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ") || d.kind} effect, and ${PLACE_WORDS[place]}${instead}.`, d.id);
 }
 var PAPER_EFFECT_BLENDS = ["multiply", "normal", "overlay", "soft-light", "screen", "color"];
 var paperVersion = 1;
@@ -3453,7 +3453,7 @@ var PaintEditorController = (_class10 = class _PaintEditorController {
   /** Set while an operation that changes wet paint runs: the simulation before it (for undo). */
   __init102() {this.wetOp = null}
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init103() {this.effects = new (0, _chunkNTWR5TQBcjs.EffectsSlot)()}
+  __init103() {this.effects = new (0, _chunkABQ2VGUBcjs.EffectsSlot)()}
   __init104() {this.effectsRenderer = new PaintEffectsRenderer()}
   __init105() {this.paperEffectNodeCache = null}
   constructor(options = {}) {;_class10.prototype.__init72.call(this);_class10.prototype.__init73.call(this);_class10.prototype.__init74.call(this);_class10.prototype.__init75.call(this);_class10.prototype.__init76.call(this);_class10.prototype.__init77.call(this);_class10.prototype.__init78.call(this);_class10.prototype.__init79.call(this);_class10.prototype.__init80.call(this);_class10.prototype.__init81.call(this);_class10.prototype.__init82.call(this);_class10.prototype.__init83.call(this);_class10.prototype.__init84.call(this);_class10.prototype.__init85.call(this);_class10.prototype.__init86.call(this);_class10.prototype.__init87.call(this);_class10.prototype.__init88.call(this);_class10.prototype.__init89.call(this);_class10.prototype.__init90.call(this);_class10.prototype.__init91.call(this);_class10.prototype.__init92.call(this);_class10.prototype.__init93.call(this);_class10.prototype.__init94.call(this);_class10.prototype.__init95.call(this);_class10.prototype.__init96.call(this);_class10.prototype.__init97.call(this);_class10.prototype.__init98.call(this);_class10.prototype.__init99.call(this);_class10.prototype.__init100.call(this);_class10.prototype.__init101.call(this);_class10.prototype.__init102.call(this);_class10.prototype.__init103.call(this);_class10.prototype.__init104.call(this);_class10.prototype.__init105.call(this);_class10.prototype.__init106.call(this);_class10.prototype.__init107.call(this);_class10.prototype.__init108.call(this);_class10.prototype.__init109.call(this);
@@ -4126,7 +4126,7 @@ var PaintEditorController = (_class10 = class _PaintEditorController {
       if (v === null) merged[k] = d.defaults[k];
       else given[k] = v;
     }
-    return { ...merged, ..._chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, { ...d, defaults: merged }, given) };
+    return { ...merged, ..._chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, { ...d, defaults: merged }, given) };
   }
   /** Renders a generator, overlay or title effect at the canvas size. */
   renderEffectCanvas(d, values, time = 0) {
@@ -5468,7 +5468,7 @@ var PaintEditorController = (_class10 = class _PaintEditorController {
       return next.type === "group" ? { ...next, children: toStandard(next.children) } : next;
     });
     const layers = toStandard(dried);
-    const result = _chunkR35YOUP2cjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
+    const result = _chunkIWMDW7LBcjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
     for (const [mode, names] of changed) {
       const label = _nullishCoalesce(_optionalChain([_chunkOLNIPTB3cjs.BLEND_MODES, 'access', _279 => _279.find, 'call', _280 => _280((m) => m.id === mode), 'optionalAccess', _281 => _281.label]), () => ( mode));
       const std = _nullishCoalesce(_optionalChain([_chunkOLNIPTB3cjs.BLEND_MODES, 'access', _282 => _282.find, 'call', _283 => _283((m) => m.id === _chunkOLNIPTB3cjs.standardBlendMode.call(void 0, mode)), 'optionalAccess', _284 => _284.label]), () => ( _chunkOLNIPTB3cjs.standardBlendMode.call(void 0, mode)));
@@ -8730,7 +8730,7 @@ function createPaintEffectsToolProvider(controller, options = {}) {
     if (changes.enabled !== void 0) throw new Error("enabled does not apply here: hide an effect layer with update_layer visible false, or remove the effect paper.");
   };
   const values = (v) => v;
-  return withPaintPlayback(_chunkNTWR5TQBcjs.createEffectToolProvider.call(void 0, {
+  return withPaintPlayback(_chunkABQ2VGUBcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "paint-effects")),
     namespace: options.namespace,
     title: "Paint effects",

package/dist/paint-editor/index.js

@@ -1,13 +1,13 @@
 import {
   toVideoFfmpeg
-} from "../chunk-RDTCG5MS.js";
+} from "../chunk-56RFHF7O.js";
 import {
   deserializeLayers,
   exportPsd,
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-S6KKLFZO.js";
+} from "../chunk-5YLOU7VF.js";
 import "../chunk-3CI7FRMK.js";
 import "../chunk-ZNA3IQZF.js";
 import {
@@ -132,7 +132,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-HKPLKISO.js";
+} from "../chunk-7DZ55AIE.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   CoverageMap,

package/dist/vector/index.cjs

@@ -558,7 +558,7 @@ var _chunkNM3G4VQTcjs = require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('../chunk-ABQ2VGUB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -7328,7 +7328,7 @@ var VectorEditorController = (_class7 = class _VectorEditorController {
   }
   // --- Provider effects ---
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init59() {this.effects = new (0, _chunkNTWR5TQBcjs.EffectsSlot)()}
+  __init59() {this.effects = new (0, _chunkABQ2VGUBcjs.EffectsSlot)()}
   /** The registered effects provider, or `null`. */
   get effectsProvider() {
     return this.effects.provider;
@@ -7352,10 +7352,10 @@ var VectorEditorController = (_class7 = class _VectorEditorController {
   /** The effect's picture as group children, scaled into `box` (an affine fit). */
   async vectorEffectPicture(effect, values) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`${provider.name} has no vector effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`${provider.name} has no vector effects.`);
     const d = await provider.describe(effect);
-    if (d.kind !== "vector") throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect; the vector editor adds vector effects, which bring their own picture${d.kind === "motion" ? " (apply motion in the animation editor)" : ""}.`, d.id);
-    const resolved = _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, values);
+    if (d.kind !== "vector") throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect; the vector editor adds vector effects, which bring their own picture${d.kind === "motion" ? " (apply motion in the animation editor)" : ""}.`, d.id);
+    const resolved = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, values);
     const motion = await provider.applyVectorEffect(d.id, this.toSvg(), resolved);
     const parsed = _chunkQAUIZPYIcjs.parseVectorSvg.call(void 0, motion.svg);
     if (!parsed.nodes.length) throw new Error(`"${d.name}" drew no shapes the editor can read.`);
@@ -17233,6 +17233,19 @@ function createVectorCommands(controller, options = {}) {
         return { ok: true };
       }
     },
+    {
+      ...base,
+      id: `${prefix}rename`,
+      label: "Rename Layer\u2026",
+      keywords: ["rename", "name", "layer", "label"],
+      description: "Renames node `id` (a path, group, text or any layer) to `name`, as the Layers panel shows it. One undo step. Returns { id, name }.",
+      params: { type: "object", properties: { id: { type: "string", description: "The node (from vector.list)." }, name: { type: "string", minLength: 1, description: "Its new name." } }, required: ["id", "name"], additionalProperties: false },
+      undoable: true,
+      run: (_ctx, params) => {
+        check2(controller.rename(params.id, params.name));
+        return { id: params.id, name: params.name };
+      }
+    },
     {
       ...base,
       id: `${prefix}boolean`,
@@ -18159,7 +18172,7 @@ function createVectorEffectsToolProvider(controller, options = {}) {
     const effects = _optionalChain([g, 'optionalAccess', _765 => _765.providerEffect]) ? [info(g)] : [];
     return { target: id, effect: _nullishCoalesce(removed, () => ( effects[0])), effects };
   };
-  return _chunkNTWR5TQBcjs.createEffectToolProvider.call(void 0, {
+  return _chunkABQ2VGUBcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "vector-effects")),
     namespace: options.namespace,
     title: "Vector effects",

package/dist/vector/index.js

@@ -558,7 +558,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-HKPLKISO.js";
+} from "../chunk-7DZ55AIE.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   GRAIN_PATTERNS
@@ -17233,6 +17233,19 @@ function createVectorCommands(controller, options = {}) {
         return { ok: true };
       }
     },
+    {
+      ...base,
+      id: `${prefix}rename`,
+      label: "Rename Layer\u2026",
+      keywords: ["rename", "name", "layer", "label"],
+      description: "Renames node `id` (a path, group, text or any layer) to `name`, as the Layers panel shows it. One undo step. Returns { id, name }.",
+      params: { type: "object", properties: { id: { type: "string", description: "The node (from vector.list)." }, name: { type: "string", minLength: 1, description: "Its new name." } }, required: ["id", "name"], additionalProperties: false },
+      undoable: true,
+      run: (_ctx, params) => {
+        check2(controller.rename(params.id, params.name));
+        return { id: params.id, name: params.name };
+      }
+    },
     {
       ...base,
       id: `${prefix}boolean`,