@pixerate/editor 0.224.1 → 0.226.0

package/dist/animation-editor/index.cjs

@@ -48,7 +48,7 @@ require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('../chunk-ABQ2VGUB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-PQ3H2AAN.cjs');
 require('../chunk-YQGCPL5X.cjs');
@@ -3828,7 +3828,7 @@ var AnimationEditorController = (_class = class {
   
   
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init() {this.effects = new (0, _chunkNTWR5TQBcjs.EffectsSlot)()}
+  __init() {this.effects = new (0, _chunkABQ2VGUBcjs.EffectsSlot)()}
   
   
   __init2() {this.selection = null}
@@ -4013,7 +4013,7 @@ var AnimationEditorController = (_class = class {
     try {
       plan = await work();
     } catch (error) {
-      if (_chunkNTWR5TQBcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunkABQ2VGUBcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
     const r = this.apply({ op: "replace_scene", scene: plan.scene }, plan.label, { merge });
@@ -4024,11 +4024,11 @@ var AnimationEditorController = (_class = class {
   }
   async describeFor(effect, kinds) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
     const d = await provider.describe(effect);
     if (!kinds.includes(d.kind)) {
       const hint = d.kind === "motion" ? "apply it to nodes with apply_effect" : d.kind === "vector" ? "add it with add_vector_effect" : "it draws pixels, which scenes cannot hold";
-      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
+      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
     }
     return d;
   }
@@ -4049,7 +4049,7 @@ var AnimationEditorController = (_class = class {
     return this.effectEdit(async () => {
       this.knownNodes(targets);
       const d = await this.describeFor(effect, ["motion"]);
-      const values = _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, options.values);
       const instance = _nullishCoalesce(options.instance, () => ( nextMotionEffectInstance(this.scene)));
       const motion = await this.effects.require().applyVectorEffect(d.id, { svg: motionArtworkSvg(this.scene.artwork), nodeIds: [...targets] }, values);
       const source = { instance, effect: d.id, provider: this.effects.require().id, name: d.name, values };
@@ -4071,7 +4071,7 @@ var AnimationEditorController = (_class = class {
   addVectorEffect(effect, options = {}) {
     return this.effectEdit(async () => {
       const d = await this.describeFor(effect, ["vector"]);
-      const values = _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, options.values);
       const instance = _nullishCoalesce(options.instance, () => ( nextMotionEffectInstance(this.scene)));
       const motion = await this.effects.require().applyVectorEffect(d.id, motionArtworkSvg(this.scene.artwork), values);
       const source = { instance, effect: d.id, provider: this.effects.require().id, name: d.name, values };
@@ -4095,7 +4095,7 @@ var AnimationEditorController = (_class = class {
         else if (k in d.controls.properties) base[k] = d.defaults[k];
         else throw new Error(`"${k}" is not a control of "${d.id}"; its controls are ${Object.keys(d.controls.properties).join(", ")}.`);
       }
-      const merged = { ...base, ..._chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+      const merged = { ...base, ..._chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
       const { scene: bare, place } = withoutMotionEffect(this.scene, instance);
       const provider = this.effects.require();
       const source = { instance, effect: d.id, provider: provider.id, name: d.name, values: merged };
@@ -5868,7 +5868,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
     if (!r.ok) throw new Error(r.error);
     return { target, effect: info(r.effect), effects: controller.appliedEffects().filter((e) => e.targets.includes(target)).map(info), ...r.notes.length ? { notes: r.notes } : {} };
   };
-  return withAnimationPlayback(_chunkNTWR5TQBcjs.createEffectToolProvider.call(void 0, {
+  return withAnimationPlayback(_chunkABQ2VGUBcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "animation-effects")),
     namespace: options.namespace,
     title: "Animation effects",

package/dist/animation-editor/index.js

@@ -48,7 +48,7 @@ import {
   createEffectToolProvider,
   isEffectError,
   resolveEffectValues
-} from "../chunk-HKPLKISO.js";
+} from "../chunk-7DZ55AIE.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-2PBZBRP5.js";
 import "../chunk-ODBT55Q7.js";

package/dist/canvas/index.cjs

@@ -209,7 +209,7 @@ var _chunkNM3G4VQTcjs = require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('../chunk-ABQ2VGUB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -11396,14 +11396,14 @@ function canvasNodeEffect(node) {
   return _chunkNM3G4VQTcjs.isShapeDescription.call(void 0, shape) ? shape.effect : void 0;
 }
 function createCanvasEffectsController(options) {
-  const slot = new (0, _chunkNTWR5TQBcjs.EffectsSlot)();
+  const slot = new (0, _chunkABQ2VGUBcjs.EffectsSlot)();
   if (options.effects) slot.set(options.effects);
   const describe = async (effect, place2) => {
     const d = await slot.require().describe(effect);
     const allowed = CANVAS_EFFECT_PLACES[place2];
     if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
       const where = place2 === "transition" ? "a scene transition" : place2 === "fill" ? "a fill" : "an overlay";
-      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
+      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be ${where}, which takes ${allowed.join(" or ")} effects; search_effects with use "${allowed[0]}" lists ones that fit.`, d.id);
     }
     return d;
   };
@@ -11434,7 +11434,7 @@ function createCanvasEffectsController(options) {
       else if (k in d.controls.properties) base[k] = d.defaults[k];
       else throw new Error(`"${k}" is not a control of "${d.id}"; its controls are ${Object.keys(d.controls.properties).join(", ")}.`);
     }
-    return { ...base, ..._chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+    return { ...base, ..._chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
   };
   return {
     /** The provider slot. */
@@ -11464,7 +11464,7 @@ function createCanvasEffectsController(options) {
       const mode = _nullishCoalesce(opts.mode, () => ( "fill"));
       const d = await describe(effect, mode);
       if (opts.opacity !== void 0 && !(opts.opacity >= 0 && opts.opacity <= 1)) throw new Error("opacity must be from 0 to 1.");
-      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
+      const next = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, opts.values), mode, ...opts.opacity !== void 0 && opts.opacity !== 1 ? { opacity: opts.opacity } : {} };
       commit(`Add effect ${d.name}`, withEffect(nodeId, next));
       return next;
     },
@@ -11521,7 +11521,7 @@ function createCanvasEffectsController(options) {
       const d = await describe(effect, "transition");
       const duration = _nullishCoalesce(_nullishCoalesce(opts.duration, () => ( d.duration)), () => ( 600));
       if (!(duration > 0)) throw new Error("duration must be a number of ms above 0.");
-      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
+      const transition = { effect: d.id, provider: slot.require().id, name: d.name, values: _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, opts.values), duration };
       scenes2.update(sceneId, { transition });
       return transition;
     }
@@ -11665,7 +11665,7 @@ function createCanvasEffectsToolProvider(controller, options = {}) {
   const once = (instance) => {
     if (instance !== "effect") throw new Error('A shape node has one effect, "effect".');
   };
-  return _chunkNTWR5TQBcjs.createEffectToolProvider.call(void 0, {
+  return _chunkABQ2VGUBcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "canvas-effects")),
     namespace: options.namespace,
     title: "Canvas effects",

package/dist/canvas/index.js

@@ -209,7 +209,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-HKPLKISO.js";
+} from "../chunk-7DZ55AIE.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket

package/dist/{chunk-WA4IS2EY.js → chunk-4MDWEX44.js}

@@ -3,7 +3,7 @@ import {
   EffectDisposedError,
   EffectUnsupportedError,
   effectValueErrors
-} from "./chunk-HKPLKISO.js";
+} from "./chunk-7DZ55AIE.js";
 import {
   HistoryManager
 } from "./chunk-RNSANXPT.js";

package/dist/{chunk-7AAS3JO6.cjs → chunk-4PA6YS6W.cjs}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkNTWR5TQBcjs = require('./chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('./chunk-ABQ2VGUB.cjs');
 
 
 var _chunkFJ2MSI43cjs = require('./chunk-FJ2MSI43.cjs');
@@ -26,7 +26,7 @@ function documentErrors(doc, description) {
   const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
   if (doc.values !== void 0) {
     if (!isRecord(doc.values)) errors.push({ path: "/values", message: "must be an object of control values" });
-    else errors.push(..._chunkNTWR5TQBcjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
+    else errors.push(..._chunkABQ2VGUBcjs.effectValueErrors.call(void 0, description, doc.values).map((e) => ({ ...e, path: `/values${e.path}` })));
   }
   if (doc.tracks !== void 0) {
     if (!isRecord(doc.tracks)) errors.push({ path: "/tracks", message: "must be an object of keyframe lists" });
@@ -39,7 +39,7 @@ function documentErrors(doc, description) {
           kfs.forEach((kf, i) => {
             if (!isRecord(kf)) return errors.push({ path: `${at}/${i}`, message: "must be a keyframe object" });
             if (typeof kf.time !== "number" || !Number.isFinite(kf.time) || kf.time < 0) errors.push({ path: `${at}/${i}/time`, message: "must be a finite number of ms >= 0" });
-            errors.push(..._chunkNTWR5TQBcjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
+            errors.push(..._chunkABQ2VGUBcjs.effectValueErrors.call(void 0, description, { [control]: kf.value }).map((e) => ({ ...e, path: `${at}/${i}/value` })));
             if (kf.easing !== void 0 && !_chunkDWJJI6RTcjs.isAnimationEasing.call(void 0, kf.easing)) errors.push({ path: `${at}/${i}/easing`, message: "is not a valid easing" });
           });
       }
@@ -49,7 +49,7 @@ function documentErrors(doc, description) {
     else
       doc.presets.forEach((p, i) => {
         if (!isRecord(p) || typeof p.name !== "string" || !p.name) return errors.push({ path: `/presets/${i}`, message: "must have a name" });
-        errors.push(..._chunkNTWR5TQBcjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
+        errors.push(..._chunkABQ2VGUBcjs.effectValueErrors.call(void 0, description, p.values).map((e) => ({ ...e, path: `/presets/${i}/values${e.path}` })));
       });
   }
   if (doc.duration !== void 0 && (typeof doc.duration !== "number" || !Number.isFinite(doc.duration) || !(doc.duration > 0))) {
@@ -170,7 +170,7 @@ async function createEffectAuthoringSession(source, options) {
   if (isDocumentSource(source)) {
     const doc = source.document;
     if (doc.version !== 1 || !doc.effectId) {
-      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
+      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)("Invalid effect authoring document: version 1 required");
     }
     effectId = doc.effectId;
     initialDoc = doc;
@@ -178,15 +178,15 @@ async function createEffectAuthoringSession(source, options) {
     effectId = source.effectId;
     requestedPreset = source.preset;
   } else {
-    throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)("Invalid effect authoring source");
+    throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)("Invalid effect authoring source");
   }
   const description = await provider.describe(effectId);
   if (initialDoc) {
     const problems = documentErrors(initialDoc, description);
-    if (problems.length) throw new (0, _chunkNTWR5TQBcjs.EffectControlError)(effectId, problems);
+    if (problems.length) throw new (0, _chunkABQ2VGUBcjs.EffectControlError)(effectId, problems);
   }
   if (description.kind === "motion") {
-    throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
+    throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)("Motion effects cannot be authored as pixel effects", effectId);
   }
   let disposed = false;
   let playing = false;
@@ -207,7 +207,7 @@ async function createEffectAuthoringSession(source, options) {
     const found = description.presets.find((p) => p.name === requestedPreset);
     if (!found) {
       const validNames = description.presets.map((p) => `"${p.name}"`).join(", ");
-      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(
+      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(
         `Unknown preset "${requestedPreset}" for effect "${effectId}". Valid presets are: ${validNames || "none"}`,
         effectId
       );
@@ -321,7 +321,7 @@ async function createEffectAuthoringSession(source, options) {
       if (!validNames.includes(name)) {
         return { ok: false, message: `there is no control "${name}"; the controls are ${validNames.join(", ")}` };
       }
-      const errors = _chunkNTWR5TQBcjs.effectValueErrors.call(void 0, description, { [name]: value });
+      const errors = _chunkABQ2VGUBcjs.effectValueErrors.call(void 0, description, { [name]: value });
       if (errors.length > 0) {
         return { ok: false, message: valueErrorMessage(errors) };
       }
@@ -391,7 +391,7 @@ async function createEffectAuthoringSession(source, options) {
         if (!validNames.includes(k)) {
           return { ok: false, message: `there is no control "${k}"; the controls are ${validNames.join(", ")}` };
         }
-        const errors = _chunkNTWR5TQBcjs.effectValueErrors.call(void 0, description, { [k]: v });
+        const errors = _chunkABQ2VGUBcjs.effectValueErrors.call(void 0, description, { [k]: v });
         if (errors.length > 0) {
           return { ok: false, message: valueErrorMessage(errors) };
         }
@@ -528,7 +528,7 @@ async function createEffectAuthoringSession(source, options) {
         return { ok: false, message: `invalid easing: ${String(easing)}` };
       }
       const targetValue = value !== void 0 ? value : valuesAtTime(time, baseValues, tracks)[name];
-      const errors = _chunkNTWR5TQBcjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
+      const errors = _chunkABQ2VGUBcjs.effectValueErrors.call(void 0, description, { [name]: targetValue });
       if (errors.length > 0) {
         return { ok: false, message: valueErrorMessage(errors) };
       }
@@ -705,7 +705,7 @@ async function createEffectAuthoringSession(source, options) {
     },
     async createPreview(opts) {
       if (disposed) {
-        throw new (0, _chunkNTWR5TQBcjs.EffectDisposedError)(effectId);
+        throw new (0, _chunkABQ2VGUBcjs.EffectDisposedError)(effectId);
       }
       let renderer;
       try {
@@ -730,7 +730,7 @@ async function createEffectAuthoringSession(source, options) {
         height: renderer.height,
         depth: renderer.depth,
         render: async (req) => {
-          if (disposed) throw new (0, _chunkNTWR5TQBcjs.EffectDisposedError)(effectId);
+          if (disposed) throw new (0, _chunkABQ2VGUBcjs.EffectDisposedError)(effectId);
           const effectiveValues = _nullishCoalesce(req.values, () => ( valuesAtTime(req.time, baseValues, tracks)));
           const pixels = await renderer.render({
             ...req,

package/dist/{chunk-RDTCG5MS.js → chunk-56RFHF7O.js}

@@ -7,7 +7,7 @@ import {
   EffectsSlot,
   createEffectPixels,
   effectValueErrors
-} from "./chunk-HKPLKISO.js";
+} from "./chunk-7DZ55AIE.js";
 import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";

package/dist/{chunk-S6KKLFZO.js → chunk-5YLOU7VF.js}

@@ -4894,13 +4894,14 @@ function applySmartFilters(placed, stack, canvas) {
       let out2;
       if (f.kind === "effect") {
         if (incomplete) continue;
-        const inputKey = JSON.stringify([surfaceId(placed), W, H, active.slice(0, i + 1).map((x) => ({ ...x, id: void 0, blend: x === f ? void 0 : x.blend, opacity: x === f ? void 0 : x.opacity }))]);
+        const inputKey = JSON.stringify([surfaceId(placed), W, H, active.slice(0, i + 1).map((x) => x === f ? { ...x, id: void 0, blend: void 0, opacity: void 0, preserveTransparency: void 0 } : { ...x, id: void 0 })]);
         const r = canvas.effects?.resolve(f, acc, W, H, inputKey);
         if (!r?.result) {
           if (r?.pending) incomplete = true;
           continue;
         }
         out2 = new Uint8ClampedArray(r.result);
+        if (f.preserveTransparency) keepAlphaOf(out2, acc);
       } else {
         out2 = new Uint8ClampedArray(acc);
         runLayerFilters(out2, W, H, [f]);
@@ -4925,6 +4926,18 @@ function applySmartFilters(placed, stack, canvas) {
   if (incomplete) incompleteSurfaces.add(out);
   return out;
 }
+function keepAlphaOf(result, input) {
+  for (let i = 0; i < result.length; i += 4) {
+    const ia = input[i + 3];
+    const ta = result[i + 3] / 255;
+    if (ta < 1) {
+      const ba = ia / 255;
+      const a = ta + ba * (1 - ta);
+      for (let c = 0; c < 3; c++) result[i + c] = a > 0 ? (result[i + c] * ta + input[i + c] * ba * (1 - ta)) / a : 0;
+    }
+    result[i + 3] = ia;
+  }
+}
 function lerpInto(dst, src, k, coverage) {
   for (let i = 0, p = 0; i < dst.length; i += 4, p++) {
     const t = coverage ? k * coverage[p] : k;
@@ -5269,6 +5282,7 @@ function normalizeEffectSmartFilter(raw, id) {
   if (typeof raw.effect !== "string" || !raw.effect) fail4('An effect smart filter needs an "effect" id from search_effects.');
   const values = raw.values ?? {};
   if (typeof values !== "object" || values === null || Array.isArray(values)) fail4('"values" must be an object of control values.');
+  if (raw.preserveTransparency !== void 0 && typeof raw.preserveTransparency !== "boolean") fail4('"preserveTransparency" must be true or false.');
   return {
     id,
     kind: "effect",
@@ -5276,7 +5290,8 @@ function normalizeEffectSmartFilter(raw, id) {
     effect: raw.effect,
     ...typeof raw.provider === "string" ? { provider: raw.provider } : {},
     ...typeof raw.name === "string" ? { name: raw.name } : {},
-    values: { ...values }
+    values: { ...values },
+    ...typeof raw.preserveTransparency === "boolean" ? { preserveTransparency: raw.preserveTransparency } : {}
   };
 }
 function withStack(layer, stack, canvas) {
@@ -6097,7 +6112,7 @@ function readSmartFilters(raw, ctx, what) {
       if (base) filters.push({ ...base, blend, opacity });
     } else if (f.kind === "effect") {
       const ref = readEffectRef(f);
-      if (ref) filters.push({ id: typeof f.id === "string" ? f.id : newLayerId("flt"), kind: "effect", enabled: f.enabled !== false, ...ref, blend, opacity });
+      if (ref) filters.push({ id: typeof f.id === "string" ? f.id : newLayerId("flt"), kind: "effect", enabled: f.enabled !== false, ...ref, ...typeof f.preserveTransparency === "boolean" ? { preserveTransparency: f.preserveTransparency } : {}, blend, opacity });
       else ctx.problems.push(`${what}: an effect smart filter without an effect id was left out`);
     }
   }

package/dist/{chunk-HKPLKISO.js → chunk-7DZ55AIE.js}

@@ -358,6 +358,7 @@ function createEffectToolProvider(host) {
       }
     }
   ];
+  const hostOptions = (schemas, args) => Object.fromEntries(Object.keys(schemas ?? {}).filter((k) => args[k] !== void 0).map((k) => [k, args[k]]));
   const writeTools = () => [
     {
       name: "apply_effect",
@@ -370,14 +371,15 @@ function createEffectToolProvider(host) {
           values: valuesSchema("Control values over the effect's defaults", true),
           index: INDEX,
           enabled: ENABLED,
-          opacity: OPACITY
+          opacity: OPACITY,
+          ...host.applyOptions
         },
         ["target", "effect"]
       ),
       annotations: { title: "Apply an effect", ...ANNOTATIONS.write },
       handler: async (args) => {
         writable();
-        return explain(() => host.apply(args.target, args.effect, { values: args.values, index: args.index, enabled: args.enabled, opacity: args.opacity }));
+        return explain(() => host.apply(args.target, args.effect, { ...hostOptions(host.applyOptions, args), values: args.values, index: args.index, enabled: args.enabled, opacity: args.opacity }));
       }
     },
     {
@@ -391,15 +393,18 @@ function createEffectToolProvider(host) {
           values: { ...valuesSchema("Control values to change", true), description: `${valuesSchema("Control values to change", true).description} null resets a control to its default.` },
           enabled: ENABLED,
           opacity: OPACITY,
-          index: { ...INDEX, description: `Move it to this place in the ${host.target.noun}'s stack (0 = applied first).` }
+          index: { ...INDEX, description: `Move it to this place in the ${host.target.noun}'s stack (0 = applied first).` },
+          ...host.updateOptions
         },
         ["target", "effect"]
       ),
       annotations: { title: "Change an applied effect", ...ANNOTATIONS.writeIdempotent },
       handler: async (args) => {
         writable();
-        if (args.values === void 0 && args.enabled === void 0 && args.opacity === void 0 && args.index === void 0) throw new Error("Give at least one of values, enabled, opacity or index to change.");
-        return explain(() => host.update(args.target, args.effect, { values: args.values, enabled: args.enabled, opacity: args.opacity, index: args.index }));
+        const options = hostOptions(host.updateOptions, args);
+        if (args.values === void 0 && args.enabled === void 0 && args.opacity === void 0 && args.index === void 0 && !Object.keys(options).length)
+          throw new Error(`Give at least one of ${["values", "enabled", "opacity", "index", ...Object.keys(host.updateOptions ?? {})].join(", ")} to change.`);
+        return explain(() => host.update(args.target, args.effect, { ...options, values: args.values, enabled: args.enabled, opacity: args.opacity, index: args.index }));
       }
     },
     {

package/dist/{chunk-NTWR5TQB.cjs → chunk-ABQ2VGUB.cjs}

@@ -358,6 +358,7 @@ function createEffectToolProvider(host) {
       }
     }
   ];
+  const hostOptions = (schemas, args) => Object.fromEntries(Object.keys(_nullishCoalesce(schemas, () => ( {}))).filter((k) => args[k] !== void 0).map((k) => [k, args[k]]));
   const writeTools = () => [
     {
       name: "apply_effect",
@@ -370,14 +371,15 @@ function createEffectToolProvider(host) {
           values: valuesSchema("Control values over the effect's defaults", true),
           index: INDEX,
           enabled: ENABLED,
-          opacity: OPACITY
+          opacity: OPACITY,
+          ...host.applyOptions
         },
         ["target", "effect"]
       ),
       annotations: { title: "Apply an effect", ...ANNOTATIONS.write },
       handler: async (args) => {
         writable();
-        return explain(() => host.apply(args.target, args.effect, { values: args.values, index: args.index, enabled: args.enabled, opacity: args.opacity }));
+        return explain(() => host.apply(args.target, args.effect, { ...hostOptions(host.applyOptions, args), values: args.values, index: args.index, enabled: args.enabled, opacity: args.opacity }));
       }
     },
     {
@@ -391,15 +393,18 @@ function createEffectToolProvider(host) {
           values: { ...valuesSchema("Control values to change", true), description: `${valuesSchema("Control values to change", true).description} null resets a control to its default.` },
           enabled: ENABLED,
           opacity: OPACITY,
-          index: { ...INDEX, description: `Move it to this place in the ${host.target.noun}'s stack (0 = applied first).` }
+          index: { ...INDEX, description: `Move it to this place in the ${host.target.noun}'s stack (0 = applied first).` },
+          ...host.updateOptions
         },
         ["target", "effect"]
       ),
       annotations: { title: "Change an applied effect", ...ANNOTATIONS.writeIdempotent },
       handler: async (args) => {
         writable();
-        if (args.values === void 0 && args.enabled === void 0 && args.opacity === void 0 && args.index === void 0) throw new Error("Give at least one of values, enabled, opacity or index to change.");
-        return explain(() => host.update(args.target, args.effect, { values: args.values, enabled: args.enabled, opacity: args.opacity, index: args.index }));
+        const options = hostOptions(host.updateOptions, args);
+        if (args.values === void 0 && args.enabled === void 0 && args.opacity === void 0 && args.index === void 0 && !Object.keys(options).length)
+          throw new Error(`Give at least one of ${["values", "enabled", "opacity", "index", ...Object.keys(_nullishCoalesce(host.updateOptions, () => ( {})))].join(", ")} to change.`);
+        return explain(() => host.update(args.target, args.effect, { ...options, values: args.values, enabled: args.enabled, opacity: args.opacity, index: args.index }));
       }
     },
     {

package/dist/{chunk-MDNYYOBZ.cjs → chunk-C6CMQXMI.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkNTWR5TQBcjs = require('./chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('./chunk-ABQ2VGUB.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -1307,12 +1307,12 @@ function videoEffectLayerKey(layer, width, height) {
 }
 function mixEffectPixels(a, b, k) {
   if (k >= 1) return b;
-  const out = _chunkNTWR5TQBcjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunkABQ2VGUBcjs.createEffectPixels.call(void 0, a.width, a.height);
   for (let i = 0; i < out.data.length; i++) out.data[i] = a.data[i] + (b.data[i] - a.data[i]) * k;
   return out;
 }
 function overEffectPixels(base, top, opacity = 1) {
-  const out = _chunkNTWR5TQBcjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunkABQ2VGUBcjs.createEffectPixels.call(void 0, base.width, base.height);
   const o = out.data;
   const b = base.data;
   const t = top.data;
@@ -1357,7 +1357,7 @@ var VideoEffectsEngine = (_class2 = class {
   __init10() {this.generation = 0}
   
   constructor(options = {}) {;_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);
-    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkNTWR5TQBcjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkABQ2VGUBcjs.EffectsSlot)()));
     this.maxEntries = _nullishCoalesce(options.maxEntries, () => ( 120));
     this.toImage = _nullishCoalesce(options.toImage, () => ( defaultToImage));
     this.pool = new (0, _chunkPY4GWSE2cjs.EffectRendererPool)({ maxRenderers: options.maxRenderers });
@@ -1499,7 +1499,7 @@ function checkVideoEffectPlace(d, place) {
   if (d.kind === "motion" || !d.uses.some((u) => allowed.includes(u))) {
     const where = place === "clip" ? "on a clip" : place === "transition" ? "as a transition" : "as an effect clip";
     const instead = d.uses.includes("transition") ? "set_video_effect_transition" : d.uses.some((u) => VIDEO_EFFECT_PLACES.generator.includes(u)) ? "add_video_effect_clip" : d.uses.some((u) => u === "filter") ? "apply_effect" : null;
-    throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(
+    throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(
       `"${d.id}" (${d.name}) is a ${d.uses.join(" / ")} effect and cannot be used ${where}, which takes ${allowed.join(" or ")} effects${instead ? `; use ${instead} instead` : ""}. search_effects with use "${allowed[0]}" lists ones that fit.`,
       d.id
     );
@@ -1520,12 +1520,12 @@ function checkVideoEffectValues(d, values, options = {}) {
     else if (type !== "number" && type !== "integer") errors.push({ path: `/${k}`, message: "only number controls can be keyframed." });
     else for (const [i, key] of v.keys.entries()) for (const e of _chunkWOFXZ3XUcjs.validateJsonSchema.call(void 0, key.v, schema)) errors.push({ path: `/${k}/keys/${i}/v`, message: e.message });
   }
-  for (const e of _chunkNTWR5TQBcjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunkABQ2VGUBcjs.effectValueErrors.call(void 0, d, plain)) {
     const name = e.path.split("/")[1];
     const about = name && _optionalChain([d, 'access', _46 => _46.controls, 'access', _47 => _47.properties, 'access', _48 => _48[name], 'optionalAccess', _49 => _49.description]);
     errors.push(about ? { path: e.path, message: `${e.message} (${about})` } : e);
   }
-  if (errors.length) throw new (0, _chunkNTWR5TQBcjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunkABQ2VGUBcjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/{chunk-R35YOUP2.cjs → chunk-IWMDW7LB.cjs}

@@ -4894,13 +4894,14 @@ function applySmartFilters(placed, stack, canvas) {
       let out2;
       if (f.kind === "effect") {
         if (incomplete) continue;
-        const inputKey = JSON.stringify([surfaceId(placed), W, H, active.slice(0, i + 1).map((x) => ({ ...x, id: void 0, blend: x === f ? void 0 : x.blend, opacity: x === f ? void 0 : x.opacity }))]);
+        const inputKey = JSON.stringify([surfaceId(placed), W, H, active.slice(0, i + 1).map((x) => x === f ? { ...x, id: void 0, blend: void 0, opacity: void 0, preserveTransparency: void 0 } : { ...x, id: void 0 })]);
         const r = _optionalChain([canvas, 'access', _112 => _112.effects, 'optionalAccess', _113 => _113.resolve, 'call', _114 => _114(f, acc, W, H, inputKey)]);
         if (!_optionalChain([r, 'optionalAccess', _115 => _115.result])) {
           if (_optionalChain([r, 'optionalAccess', _116 => _116.pending])) incomplete = true;
           continue;
         }
         out2 = new Uint8ClampedArray(r.result);
+        if (f.preserveTransparency) keepAlphaOf(out2, acc);
       } else {
         out2 = new Uint8ClampedArray(acc);
         runLayerFilters(out2, W, H, [f]);
@@ -4925,6 +4926,18 @@ function applySmartFilters(placed, stack, canvas) {
   if (incomplete) incompleteSurfaces.add(out);
   return out;
 }
+function keepAlphaOf(result, input) {
+  for (let i = 0; i < result.length; i += 4) {
+    const ia = input[i + 3];
+    const ta = result[i + 3] / 255;
+    if (ta < 1) {
+      const ba = ia / 255;
+      const a = ta + ba * (1 - ta);
+      for (let c = 0; c < 3; c++) result[i + c] = a > 0 ? (result[i + c] * ta + input[i + c] * ba * (1 - ta)) / a : 0;
+    }
+    result[i + 3] = ia;
+  }
+}
 function lerpInto(dst, src, k, coverage) {
   for (let i = 0, p = 0; i < dst.length; i += 4, p++) {
     const t = coverage ? k * coverage[p] : k;
@@ -5269,6 +5282,7 @@ function normalizeEffectSmartFilter(raw, id) {
   if (typeof raw.effect !== "string" || !raw.effect) fail4('An effect smart filter needs an "effect" id from search_effects.');
   const values = _nullishCoalesce(raw.values, () => ( {}));
   if (typeof values !== "object" || values === null || Array.isArray(values)) fail4('"values" must be an object of control values.');
+  if (raw.preserveTransparency !== void 0 && typeof raw.preserveTransparency !== "boolean") fail4('"preserveTransparency" must be true or false.');
   return {
     id,
     kind: "effect",
@@ -5276,7 +5290,8 @@ function normalizeEffectSmartFilter(raw, id) {
     effect: raw.effect,
     ...typeof raw.provider === "string" ? { provider: raw.provider } : {},
     ...typeof raw.name === "string" ? { name: raw.name } : {},
-    values: { ...values }
+    values: { ...values },
+    ...typeof raw.preserveTransparency === "boolean" ? { preserveTransparency: raw.preserveTransparency } : {}
   };
 }
 function withStack(layer, stack, canvas) {
@@ -6097,7 +6112,7 @@ function readSmartFilters(raw, ctx, what) {
       if (base) filters.push({ ...base, blend, opacity });
     } else if (f.kind === "effect") {
       const ref = readEffectRef(f);
-      if (ref) filters.push({ id: typeof f.id === "string" ? f.id : newLayerId("flt"), kind: "effect", enabled: f.enabled !== false, ...ref, blend, opacity });
+      if (ref) filters.push({ id: typeof f.id === "string" ? f.id : newLayerId("flt"), kind: "effect", enabled: f.enabled !== false, ...ref, ...typeof f.preserveTransparency === "boolean" ? { preserveTransparency: f.preserveTransparency } : {}, blend, opacity });
       else ctx.problems.push(`${what}: an effect smart filter without an effect id was left out`);
     }
   }