@pixerate/editor 0.225.0 → 0.227.0

package/dist/{chunk-F7YA3MMC.js → chunk-TQOL6CF7.js}

@@ -28,6 +28,58 @@ import {
   tileKey
 } from "./chunk-HVVR5PZW.js";
 
+// src/paint-editor/effect-paint.ts
+function effectPaintKey(p) {
+  return JSON.stringify({ type: "effect", effect: p.effect, provider: p.provider, values: p.values, time: p.time });
+}
+function isPaintEffectPaint(raw) {
+  return Boolean(raw) && typeof raw === "object" && raw.type === "effect";
+}
+function readPaintEffectPaint(raw) {
+  if (!isPaintEffectPaint(raw)) return null;
+  const r = raw;
+  if (typeof r.effect !== "string" || !r.effect || !r.values || typeof r.values !== "object" || Array.isArray(r.values)) return null;
+  return {
+    type: "effect",
+    effect: r.effect,
+    provider: typeof r.provider === "string" ? r.provider : "",
+    values: JSON.parse(JSON.stringify(r.values)),
+    time: typeof r.time === "number" && Number.isFinite(r.time) && r.time > 0 ? r.time : 0
+  };
+}
+function sampleEffectField(img, rect, vals, field) {
+  const { width, height, data } = img;
+  for (let yy = 0, k = 0; yy < rect.height; yy++) {
+    const y = rect.y + yy;
+    const inY = y >= 0 && y < height;
+    for (let xx = 0; xx < rect.width; xx++, k++) {
+      const x = rect.x + xx;
+      const f = k * 3;
+      if (!inY || x < 0 || x >= width) {
+        vals[k] = 0;
+        field[f] = field[f + 1] = field[f + 2] = 0;
+        continue;
+      }
+      const i = (y * width + x) * 4;
+      const a = data[i + 3];
+      if (a < 255) vals[k] *= a / 255;
+      field[f] = data[i] / 255;
+      field[f + 1] = data[i + 1] / 255;
+      field[f + 2] = data[i + 2] / 255;
+    }
+  }
+}
+function sampleEffectAt(img, x, y, out) {
+  const px = Math.floor(x);
+  const py = Math.floor(y);
+  if (px < 0 || py < 0 || px >= img.width || py >= img.height) return 0;
+  const i = (py * img.width + px) * 4;
+  out[0] = img.data[i] / 255;
+  out[1] = img.data[i + 1] / 255;
+  out[2] = img.data[i + 2] / 255;
+  return img.data[i + 3] / 255;
+}
+
 // src/paint-editor/paper.ts
 var PAPER_FAMILIES = ["watercolor", "drawing", "pastel", "canvas", "panel", "smooth"];
 var unit = (v, d) => typeof v === "number" && Number.isFinite(v) ? Math.min(1, Math.max(0, v)) : d;
@@ -386,6 +438,7 @@ var DryStroke = class {
   copies;
   depth;
   buf = new Float32Array(0);
+  field = new Float32Array(0);
   lastRaw = null;
   lastFed = null;
   /** Feeds raw pen samples; returns the document rectangles the new dabs touched. */
@@ -426,7 +479,13 @@ var DryStroke = class {
           }
         }
       }
-      this.coverage.accumulate(rect, vals, d.opacity);
+      let field = null;
+      if (this.options.effect) {
+        if (this.field.length < n * 3) this.field = new Float32Array(n * 3);
+        field = this.field.subarray(0, n * 3);
+        sampleEffectField(this.options.effect, rect, vals, field);
+      }
+      this.coverage.accumulate(rect, vals, d.opacity, null, field);
       rects.push(rect);
       this.dabCount++;
     }
@@ -719,6 +778,7 @@ var MarkStroke = class {
   walkers;
   depth;
   buf = new Float32Array(0);
+  field = new Float32Array(0);
   lastRaw = null;
   lastFed = null;
   seed;
@@ -785,9 +845,16 @@ var MarkStroke = class {
       for (let yy = 0, k = 0; yy < rect.height; yy++)
         for (let xx = 0; xx < rect.width; xx++, k++) if (vals[k] > 0) vals[k] *= grainCatch(grain.at(rect.x + xx + 0.5, rect.y + yy + 0.5), this.depth, pressure);
     }
-    const color = this.markColor(x, y);
-    if (color && color.alpha < 1) for (let k = 0; k < n; k++) vals[k] *= color.alpha;
-    this.coverage.accumulate(rect, vals, dab.opacity, color ? color.rgb : null);
+    if (this.options.effect) {
+      if (this.field.length < n * 3) this.field = new Float32Array(n * 3);
+      const field = this.field.subarray(0, n * 3);
+      sampleEffectField(this.options.effect, rect, vals, field);
+      this.coverage.accumulate(rect, vals, dab.opacity, null, field);
+    } else {
+      const color = this.markColor(x, y);
+      if (color && color.alpha < 1) for (let k = 0; k < n; k++) vals[k] *= color.alpha;
+      this.coverage.accumulate(rect, vals, dab.opacity, color ? color.rgb : null);
+    }
     rects.push(rect);
     this.dabCount++;
   }
@@ -1782,6 +1849,11 @@ function parseBrushLibrary(raw, problems = []) {
 }
 
 export {
+  effectPaintKey,
+  isPaintEffectPaint,
+  readPaintEffectPaint,
+  sampleEffectField,
+  sampleEffectAt,
   PAPER_FAMILIES,
   PAPER_LIBRARY,
   DEFAULT_PAPER,

package/dist/{chunk-ZMHPQ6HP.cjs → chunk-V3L7U63N.cjs}

@@ -74,7 +74,7 @@ function profileAlongPolyline(points, values, count = 32) {
 var round3 = (v) => Math.round(v * 1e3) / 1e3;
 var loading = null;
 function loadCanvasBrushstrokeRenderer() {
-  loading ??= Promise.resolve().then(() => _interopRequireWildcard(require("./brushstrokeRender-EAJNE6WP.cjs"))).catch((error) => {
+  loading ??= Promise.resolve().then(() => _interopRequireWildcard(require("./brushstrokeRender-WDTKD54B.cjs"))).catch((error) => {
     loading = null;
     throw error;
   });

package/dist/{chunk-DJBYJOHM.js → chunk-XSVUNSDJ.js}

@@ -5,7 +5,7 @@ import {
   moveAnchorHandle,
   subpathSegment,
   subpathSegmentCount
-} from "./chunk-NDMXB4PR.js";
+} from "./chunk-CU6ANS5L.js";
 import {
   segmentPoint
 } from "./chunk-WEIK3UYB.js";

package/dist/{chunk-BGOCAUXH.js → chunk-YMREOA67.js}

@@ -18,7 +18,7 @@ import {
   unionBounds,
   vectorGradientPoints,
   widthProfileAt
-} from "./chunk-NDMXB4PR.js";
+} from "./chunk-CU6ANS5L.js";
 import {
   segmentLength,
   segmentParamAtLength,

package/dist/effects/index.cjs

@@ -3,7 +3,7 @@
 var _chunk4XSBOGMKcjs = require('../chunk-4XSBOGMK.cjs');
 
 
-var _chunk7AAS3JO6cjs = require('../chunk-7AAS3JO6.cjs');
+var _chunk4PA6YS6Wcjs = require('../chunk-4PA6YS6W.cjs');
 
 
 var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
@@ -37,7 +37,7 @@ var _chunkPY4GWSE2cjs = require('../chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkNTWR5TQBcjs = require('../chunk-NTWR5TQB.cjs');
+var _chunkABQ2VGUBcjs = require('../chunk-ABQ2VGUB.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-FJ2MSI43.cjs');
 
@@ -45,7 +45,7 @@ require('../chunk-FJ2MSI43.cjs');
 var _chunkDWJJI6RTcjs = require('../chunk-DWJJI6RT.cjs');
 
 // src/effects/conformance.ts
-var codeOf = (e) => _chunkNTWR5TQBcjs.isEffectError.call(void 0, e) ? e.code : e instanceof Error ? `untyped ${e.name}: ${e.message}` : String(e);
+var codeOf = (e) => _chunkABQ2VGUBcjs.isEffectError.call(void 0, e) ? e.code : e instanceof Error ? `untyped ${e.name}: ${e.message}` : String(e);
 async function rejectsWith(code, run) {
   try {
     await run();
@@ -59,10 +59,10 @@ function checkSummary(e, issues) {
   const at = (message) => issues.push({ effectId: e.id, message });
   if (!e.id || typeof e.id !== "string") at("summary has no id");
   if (!e.name) at("summary has no name");
-  if (!_chunkNTWR5TQBcjs.EFFECT_KINDS.includes(e.kind)) at(`kind "${e.kind}" is not one of ${_chunkNTWR5TQBcjs.EFFECT_KINDS.join(", ")}`);
+  if (!_chunkABQ2VGUBcjs.EFFECT_KINDS.includes(e.kind)) at(`kind "${e.kind}" is not one of ${_chunkABQ2VGUBcjs.EFFECT_KINDS.join(", ")}`);
   if (!e.category) at("summary has no category");
   if (!Array.isArray(e.uses) || !e.uses.length) at("summary has no uses");
-  for (const u of _nullishCoalesce(e.uses, () => ( []))) if (!_chunkNTWR5TQBcjs.EFFECT_USES.includes(u)) at(`use "${u}" is not one of ${_chunkNTWR5TQBcjs.EFFECT_USES.join(", ")}`);
+  for (const u of _nullishCoalesce(e.uses, () => ( []))) if (!_chunkABQ2VGUBcjs.EFFECT_USES.includes(u)) at(`use "${u}" is not one of ${_chunkABQ2VGUBcjs.EFFECT_USES.join(", ")}`);
   if (typeof e.transparent !== "boolean") at("transparent is not a boolean");
   if (typeof e.loop !== "boolean") at("loop is not a boolean");
   if (e.duration !== void 0 && !(e.duration > 0)) at("duration must be a positive number of ms when present");
@@ -72,7 +72,7 @@ function checkSummary(e, issues) {
     const m = e.camera;
     if (!m) at("a camera effect needs camera: { role, durationMs }");
     else {
-      if (!_chunkNTWR5TQBcjs.CAMERA_MOVE_ROLES.includes(m.role)) at(`camera.role "${m.role}" is not one of ${_chunkNTWR5TQBcjs.CAMERA_MOVE_ROLES.join(", ")}`);
+      if (!_chunkABQ2VGUBcjs.CAMERA_MOVE_ROLES.includes(m.role)) at(`camera.role "${m.role}" is not one of ${_chunkABQ2VGUBcjs.CAMERA_MOVE_ROLES.join(", ")}`);
       if (!(Number.isFinite(m.durationMs) && m.durationMs >= 0)) at("camera.durationMs must be a number of ms \u2265 0");
       if (m.cut !== void 0 && !(m.cut >= 0 && m.cut <= 1)) at("camera.cut must be 0\u20131 when present");
       if (e.duration !== void 0 && e.duration !== m.durationMs) at(`duration ${e.duration} differs from camera.durationMs ${m.durationMs}`);
@@ -98,8 +98,8 @@ function checkDescription(id, d, issues) {
     if (!control) at(`backgroundOpacity "${d.backgroundOpacity}" is not a control`);
     else if (control.type !== "number" || control.minimum !== 0 || control.maximum !== 1) at(`backgroundOpacity "${d.backgroundOpacity}" must be a number control from 0 to 1`);
   }
-  for (const e of _chunkNTWR5TQBcjs.effectValueErrors.call(void 0, d, d.defaults)) at(`default ${e.path}: ${e.message}`);
-  for (const p of _nullishCoalesce(d.presets, () => ( []))) for (const e of _chunkNTWR5TQBcjs.effectValueErrors.call(void 0, d, p.values)) at(`preset "${p.name}" ${e.path}: ${e.message}`);
+  for (const e of _chunkABQ2VGUBcjs.effectValueErrors.call(void 0, d, d.defaults)) at(`default ${e.path}: ${e.message}`);
+  for (const p of _nullishCoalesce(d.presets, () => ( []))) for (const e of _chunkABQ2VGUBcjs.effectValueErrors.call(void 0, d, p.values)) at(`preset "${p.name}" ${e.path}: ${e.message}`);
   for (const input2 of _nullishCoalesce(d.inputs, () => ( []))) {
     if (!input2.name || !input2.description) at("every input needs a name and a description");
     if (input2.kind !== "image" && input2.kind !== "audio") at(`input "${input2.name}" has kind "${input2.kind}"`);
@@ -110,7 +110,7 @@ function checkDescription(id, d, issues) {
   }
 }
 function grey(size) {
-  const p = _chunkNTWR5TQBcjs.createEffectPixels.call(void 0, size, size);
+  const p = _chunkABQ2VGUBcjs.createEffectPixels.call(void 0, size, size);
   p.data.fill(128);
   return p;
 }
@@ -127,7 +127,7 @@ async function checkRender(provider, d, size, issues) {
   }
   try {
     const out = await renderer.render({ time: 0, inputs });
-    if (!_chunkNTWR5TQBcjs.isEffectPixels.call(void 0, out)) at("render did not return EffectPixels");
+    if (!_chunkABQ2VGUBcjs.isEffectPixels.call(void 0, out)) at("render did not return EffectPixels");
     else if (out.width !== size || out.height !== size || out.data.length !== size * size * 4) at(`render returned ${out.width}\xD7${out.height}, not ${size}\xD7${size}`);
   } catch (e) {
     at(`render failed: ${codeOf(e)}`);
@@ -157,10 +157,10 @@ async function checkCamera(provider, d, issues) {
         at("cameraView must be synchronous; it returned a Promise");
         return;
       }
-      if (!_chunkNTWR5TQBcjs.isCameraView.call(void 0, view)) at(`cameraView at u ${u} is not a CameraView (zoom > 0, finite scrollX and scrollY): ${JSON.stringify(view)}`);
+      if (!_chunkABQ2VGUBcjs.isCameraView.call(void 0, view)) at(`cameraView at u ${u} is not a CameraView (zoom > 0, finite scrollX and scrollY): ${JSON.stringify(view)}`);
       else views.push(view);
       const again = provider.cameraView(d.id, ctx(u));
-      if (_chunkNTWR5TQBcjs.isCameraView.call(void 0, view) && !sameView(view, again)) at(`cameraView is not pure: two calls at u ${u} gave different views`);
+      if (_chunkABQ2VGUBcjs.isCameraView.call(void 0, view) && !sameView(view, again)) at(`cameraView is not pure: two calls at u ${u} gave different views`);
     } catch (e) {
       at(`cameraView at u ${u} failed: ${codeOf(e)}`);
     }
@@ -173,7 +173,7 @@ async function checkCamera(provider, d, issues) {
       const keys = _optionalChain([sample, 'optionalAccess', _11 => _11.keys]);
       if (!Array.isArray(keys) || keys.length < 2) at("sampleCameraMove returned fewer than two keys");
       else {
-        if (keys.some((k, i) => !_chunkNTWR5TQBcjs.isCameraView.call(void 0, k.view) || !Number.isFinite(k.t) || i > 0 && k.t < keys[i - 1].t)) at("sampleCameraMove keys must be CameraViews in time order");
+        if (keys.some((k, i) => !_chunkABQ2VGUBcjs.isCameraView.call(void 0, k.view) || !Number.isFinite(k.t) || i > 0 && k.t < keys[i - 1].t)) at("sampleCameraMove keys must be CameraViews in time order");
         if (keys[0].t !== 0 || keys[keys.length - 1].t !== ms) at(`sampleCameraMove keys must run from 0 to ${ms} ms, got ${keys[0].t} to ${keys[keys.length - 1].t}`);
         else if (!near(keys[0].view, views[0]) || !near(keys[keys.length - 1].view, views[4])) at("sampleCameraMove disagrees with cameraView at the start or end of the move");
         if (camera.cut !== void 0 && sample.cut === void 0) at("sampleCameraMove gave no cut for a move that cuts");
@@ -543,15 +543,15 @@ var smooth = (t) => t * t * (3 - 2 * t);
 var clamp01 = (v) => v < 0 ? 0 : v > 1 ? 1 : v;
 function input(request, name, id, width, height) {
   const src = _optionalChain([request, 'access', _24 => _24.inputs, 'optionalAccess', _25 => _25[name]]);
-  if (!src) throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`Effect "${id}" needs an input named "${name}".`, id);
-  if (!_chunkNTWR5TQBcjs.isEffectPixels.call(void 0, src)) throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`The fake provider only takes EffectPixels inputs ("${name}").`, id);
+  if (!src) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`Effect "${id}" needs an input named "${name}".`, id);
+  if (!_chunkABQ2VGUBcjs.isEffectPixels.call(void 0, src)) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`The fake provider only takes EffectPixels inputs ("${name}").`, id);
   if (src.width !== width || src.height !== height) {
-    throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`Input "${name}" is ${src.width}\xD7${src.height}; the renderer is ${width}\xD7${height}.`, id);
+    throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`Input "${name}" is ${src.width}\xD7${src.height}; the renderer is ${width}\xD7${height}.`, id);
   }
   return src;
 }
 function renderPixels(d, v, request, width, height) {
-  const out = _chunkNTWR5TQBcjs.createEffectPixels.call(void 0, width, height);
+  const out = _chunkABQ2VGUBcjs.createEffectPixels.call(void 0, width, height);
   const o = out.data;
   switch (d.id) {
     case "fake.invert": {
@@ -617,7 +617,7 @@ function renderPixels(d, v, request, width, height) {
       break;
     }
     default:
-      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect; use applyVectorEffect.`, d.id);
+      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect; use applyVectorEffect.`, d.id);
   }
   return out;
 }
@@ -647,22 +647,22 @@ function cameraViewOf(d, ctx, v) {
     case "fake.drift":
       return viewAt(x0, y0, from.zoom * lerp(1, v.scale, smooth(u)), ctx);
     default:
-      throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect, not a camera move.`, d.id);
+      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" is a ${d.kind} effect, not a camera move.`, d.id);
   }
 }
 function toFloat(p) {
   const f = new Float32Array(p.data.length);
   for (let i = 0; i < f.length; i += 4) {
-    f[i] = _chunkNTWR5TQBcjs.srgbToLinear.call(void 0, p.data[i] / 255);
-    f[i + 1] = _chunkNTWR5TQBcjs.srgbToLinear.call(void 0, p.data[i + 1] / 255);
-    f[i + 2] = _chunkNTWR5TQBcjs.srgbToLinear.call(void 0, p.data[i + 2] / 255);
+    f[i] = _chunkABQ2VGUBcjs.srgbToLinear.call(void 0, p.data[i] / 255);
+    f[i + 1] = _chunkABQ2VGUBcjs.srgbToLinear.call(void 0, p.data[i + 1] / 255);
+    f[i + 2] = _chunkABQ2VGUBcjs.srgbToLinear.call(void 0, p.data[i + 2] / 255);
     f[i + 3] = p.data[i + 3] / 255;
   }
-  return _chunkNTWR5TQBcjs.encodeEffectFloat.call(void 0, { ...p, float: f });
+  return _chunkABQ2VGUBcjs.encodeEffectFloat.call(void 0, { ...p, float: f });
 }
 function maskResult(out, mask, source, id) {
-  if (!_chunkNTWR5TQBcjs.isEffectPixels.call(void 0, mask) || mask.width !== out.width || mask.height !== out.height) {
-    throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)("The mask must be EffectPixels the size of the renderer.", id);
+  if (!_chunkABQ2VGUBcjs.isEffectPixels.call(void 0, mask) || mask.width !== out.width || mask.height !== out.height) {
+    throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)("The mask must be EffectPixels the size of the renderer.", id);
   }
   const o = out.data;
   for (let i = 0; i < o.length; i += 4) {
@@ -688,32 +688,32 @@ function createFakeEffectProvider(options = {}) {
   const byId = new Map(all.map((d) => [d.id, d]));
   const get = (id) => {
     const d = byId.get(id);
-    if (!d) throw new (0, _chunkNTWR5TQBcjs.UnknownEffectError)(id, "the fake provider");
+    if (!d) throw new (0, _chunkABQ2VGUBcjs.UnknownEffectError)(id, "the fake provider");
     return d;
   };
   const summaries = all.map(summaryOf);
   const camera = (id, ctx, values) => {
     const d = get(id);
-    if (d.kind !== "camera") throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a camera move.`, id);
-    if (!(ctx.u >= 0 && ctx.u <= 1)) throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`u must be 0\u20131 through the move, got ${ctx.u}.`, id);
-    return cameraViewOf(d, ctx, _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, values));
+    if (d.kind !== "camera") throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a camera move.`, id);
+    if (!(ctx.u >= 0 && ctx.u <= 1)) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`u must be 0\u20131 through the move, got ${ctx.u}.`, id);
+    return cameraViewOf(d, ctx, _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, values));
   };
   const provider = {
     id: "fake",
     name: "Fake effects",
     version: "1",
     capabilities,
-    list: (o) => _chunkNTWR5TQBcjs.searchEffectSummaries.call(void 0, summaries, "", o),
-    search: (q, o) => _chunkNTWR5TQBcjs.searchEffectSummaries.call(void 0, summaries, q, o),
+    list: (o) => _chunkABQ2VGUBcjs.searchEffectSummaries.call(void 0, summaries, "", o),
+    search: (q, o) => _chunkABQ2VGUBcjs.searchEffectSummaries.call(void 0, summaries, q, o),
     describe: (id) => structuredClone(get(id)),
     createRenderer(id, ro) {
       const d = get(id);
-      if (d.kind === "camera") throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${id}" is a camera move: it moves a scene's camera and draws no pixels. Use cameraView.`, id);
-      if (d.kind !== "shader") throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect; use applyVectorEffect.`, id);
+      if (d.kind === "camera") throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${id}" is a camera move: it moves a scene's camera and draws no pixels. Use cameraView.`, id);
+      if (d.kind !== "shader") throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect; use applyVectorEffect.`, id);
       const { width, height } = ro;
       const depth = _nullishCoalesce(ro.depth, () => ( 8));
       if (!(width > 0 && height > 0) || width > capabilities.maxSize || height > capabilities.maxSize) {
-        throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`Renderer size ${width}\xD7${height} is outside 1\u2013${capabilities.maxSize}.`, id);
+        throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`Renderer size ${width}\xD7${height} is outside 1\u2013${capabilities.maxSize}.`, id);
       }
       let disposed = false;
       return {
@@ -722,15 +722,15 @@ function createFakeEffectProvider(options = {}) {
         height,
         depth,
         async render(request) {
-          if (disposed) throw new (0, _chunkNTWR5TQBcjs.EffectDisposedError)(id);
+          if (disposed) throw new (0, _chunkABQ2VGUBcjs.EffectDisposedError)(id);
           if (!Number.isFinite(request.time) || request.time < 0) {
-            throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`time must be a finite number of ms \u2265 0, got ${request.time}.`, id);
+            throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`time must be a finite number of ms \u2265 0, got ${request.time}.`, id);
           }
-          const values = _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, request.values);
+          const values = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, request.values);
           _optionalChain([options, 'access', _26 => _26.onRender, 'optionalCall', _27 => _27(id, request)]);
           const out = renderPixels(d, values, request, width, height);
           if (request.mask) {
-            if (!capabilities.supportsMask) throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)("This provider does not take masks.", id);
+            if (!capabilities.supportsMask) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)("This provider does not take masks.", id);
             const source = d.uses.includes("filter") ? _optionalChain([request, 'access', _28 => _28.inputs, 'optionalAccess', _29 => _29.source]) : void 0;
             maskResult(out, request.mask, source, id);
           }
@@ -743,8 +743,8 @@ function createFakeEffectProvider(options = {}) {
     },
     applyVectorEffect(id, target, values) {
       const d = get(id);
-      if (d.kind !== "motion" && d.kind !== "vector") throw new (0, _chunkNTWR5TQBcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a vector one.`, id);
-      const v = _chunkNTWR5TQBcjs.resolveEffectValues.call(void 0, d, values);
+      if (d.kind !== "motion" && d.kind !== "vector") throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${id}" is a ${d.kind} effect, not a vector one.`, id);
+      const v = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, values);
       if (d.kind === "vector") {
         return { svg: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100"><circle id="badge" cx="50" cy="50" r="40" fill="${v.color}"/></svg>`, animate: [{ id: "badge", ms: v.ms, attrs: { opacity: [0, 1] } }], duration: v.ms, loop: false };
       }
@@ -764,11 +764,11 @@ function createFakeEffectProvider(options = {}) {
       sampleCameraMove: (id, request) => {
         const d = get(id);
         const { from, to, ms, stage, fps, values } = request;
-        return _chunkNTWR5TQBcjs.sampleCameraViews.call(void 0, (u) => camera(id, { from, to, u, ms, stage }, values), { ms, fps, cut: _optionalChain([d, 'access', _30 => _30.camera, 'optionalAccess', _31 => _31.cut]) });
+        return _chunkABQ2VGUBcjs.sampleCameraViews.call(void 0, (u) => camera(id, { from, to, u, ms, stage }, values), { ms, fps, cut: _optionalChain([d, 'access', _30 => _30.camera, 'optionalAccess', _31 => _31.cut]) });
       }
     } : {},
     ...supportsAuthoring ? {
-      openAuthoring: (from) => _chunk7AAS3JO6cjs.createEffectAuthoringSession.call(void 0, from, { provider })
+      openAuthoring: (from) => _chunk4PA6YS6Wcjs.createEffectAuthoringSession.call(void 0, from, { provider })
     } : {}
   };
   return provider;
@@ -849,7 +849,7 @@ var effectFieldValue = (field, value) => {
   return value === void 0 || value === null || typeof value === "object" && !Array.isArray(value) ? field.default : value;
 };
 function effectSamplePicture(width, height, variant = 0) {
-  const p = _chunkNTWR5TQBcjs.createEffectPixels.call(void 0, width, height);
+  const p = _chunkABQ2VGUBcjs.createEffectPixels.call(void 0, width, height);
   for (let y = 0, i = 0; y < height; y++) {
     for (let x = 0; x < width; x++, i += 4) {
       const u = x / Math.max(1, width - 1);
@@ -1336,4 +1336,4 @@ function createEffectAuthoringToolProvider(host, options) {
 
 
 
-exports.CAMERA_MOVE_ROLES = _chunkNTWR5TQBcjs.CAMERA_MOVE_ROLES; exports.EFFECT_ERROR_CODES = _chunkNTWR5TQBcjs.EFFECT_ERROR_CODES; exports.EFFECT_KINDS = _chunkNTWR5TQBcjs.EFFECT_KINDS; exports.EFFECT_USES = _chunkNTWR5TQBcjs.EFFECT_USES; exports.EFFECT_USE_LABELS = EFFECT_USE_LABELS; exports.EffectControlError = _chunkNTWR5TQBcjs.EffectControlError; exports.EffectDisposedError = _chunkNTWR5TQBcjs.EffectDisposedError; exports.EffectError = _chunkNTWR5TQBcjs.EffectError; exports.EffectRendererPool = _chunkPY4GWSE2cjs.EffectRendererPool; exports.EffectUnsupportedError = _chunkNTWR5TQBcjs.EffectUnsupportedError; exports.EffectsSlot = _chunkNTWR5TQBcjs.EffectsSlot; exports.NoEffectsProviderError = _chunkNTWR5TQBcjs.NoEffectsProviderError; exports.UnknownEffectError = _chunkNTWR5TQBcjs.UnknownEffectError; exports.applyEffectMask = _chunkNTWR5TQBcjs.applyEffectMask; exports.checkEffectProvider = checkEffectProvider; exports.countEffectTags = _chunkNTWR5TQBcjs.countEffectTags; exports.createEffectAuthoringSession = _chunk7AAS3JO6cjs.createEffectAuthoringSession; exports.createEffectAuthoringToolProvider = createEffectAuthoringToolProvider; exports.createEffectPixels = _chunkNTWR5TQBcjs.createEffectPixels; exports.createEffectToolProvider = _chunkNTWR5TQBcjs.createEffectToolProvider; exports.createFakeEffectProvider = createFakeEffectProvider; exports.effectControlField = effectControlField; exports.effectFieldValue = effectFieldValue; exports.effectFontFamilies = effectFontFamilies; exports.effectOffered = _chunkNTWR5TQBcjs.effectOffered; exports.effectParameterFields = effectParameterFields; exports.effectSampleInputs = effectSampleInputs; exports.effectSamplePicture = effectSamplePicture; exports.effectValueErrors = _chunkNTWR5TQBcjs.effectValueErrors; exports.encodeEffectFloat = _chunkNTWR5TQBcjs.encodeEffectFloat; exports.groupEffectsByCategory = groupEffectsByCategory; exports.hasEffectTags = _chunkNTWR5TQBcjs.hasEffectTags; exports.isCameraView = _chunkNTWR5TQBcjs.isCameraView; exports.isEffectError = _chunkNTWR5TQBcjs.isEffectError; exports.isEffectFontControl = isEffectFontControl; exports.isEffectPixels = _chunkNTWR5TQBcjs.isEffectPixels; exports.linearToSrgb = _chunkNTWR5TQBcjs.linearToSrgb; exports.normaliseEffectTag = _chunkNTWR5TQBcjs.normaliseEffectTag; exports.renderEffectThumbnail = renderEffectThumbnail; exports.resolveEffectValues = _chunkNTWR5TQBcjs.resolveEffectValues; exports.sampleCameraViews = _chunkNTWR5TQBcjs.sampleCameraViews; exports.sampleEffectCameraMove = _chunkNTWR5TQBcjs.sampleEffectCameraMove; exports.searchEffectSummaries = _chunkNTWR5TQBcjs.searchEffectSummaries; exports.srgbToLinear = _chunkNTWR5TQBcjs.srgbToLinear;
+exports.CAMERA_MOVE_ROLES = _chunkABQ2VGUBcjs.CAMERA_MOVE_ROLES; exports.EFFECT_ERROR_CODES = _chunkABQ2VGUBcjs.EFFECT_ERROR_CODES; exports.EFFECT_KINDS = _chunkABQ2VGUBcjs.EFFECT_KINDS; exports.EFFECT_USES = _chunkABQ2VGUBcjs.EFFECT_USES; exports.EFFECT_USE_LABELS = EFFECT_USE_LABELS; exports.EffectControlError = _chunkABQ2VGUBcjs.EffectControlError; exports.EffectDisposedError = _chunkABQ2VGUBcjs.EffectDisposedError; exports.EffectError = _chunkABQ2VGUBcjs.EffectError; exports.EffectRendererPool = _chunkPY4GWSE2cjs.EffectRendererPool; exports.EffectUnsupportedError = _chunkABQ2VGUBcjs.EffectUnsupportedError; exports.EffectsSlot = _chunkABQ2VGUBcjs.EffectsSlot; exports.NoEffectsProviderError = _chunkABQ2VGUBcjs.NoEffectsProviderError; exports.UnknownEffectError = _chunkABQ2VGUBcjs.UnknownEffectError; exports.applyEffectMask = _chunkABQ2VGUBcjs.applyEffectMask; exports.checkEffectProvider = checkEffectProvider; exports.countEffectTags = _chunkABQ2VGUBcjs.countEffectTags; exports.createEffectAuthoringSession = _chunk4PA6YS6Wcjs.createEffectAuthoringSession; exports.createEffectAuthoringToolProvider = createEffectAuthoringToolProvider; exports.createEffectPixels = _chunkABQ2VGUBcjs.createEffectPixels; exports.createEffectToolProvider = _chunkABQ2VGUBcjs.createEffectToolProvider; exports.createFakeEffectProvider = createFakeEffectProvider; exports.effectControlField = effectControlField; exports.effectFieldValue = effectFieldValue; exports.effectFontFamilies = effectFontFamilies; exports.effectOffered = _chunkABQ2VGUBcjs.effectOffered; exports.effectParameterFields = effectParameterFields; exports.effectSampleInputs = effectSampleInputs; exports.effectSamplePicture = effectSamplePicture; exports.effectValueErrors = _chunkABQ2VGUBcjs.effectValueErrors; exports.encodeEffectFloat = _chunkABQ2VGUBcjs.encodeEffectFloat; exports.groupEffectsByCategory = groupEffectsByCategory; exports.hasEffectTags = _chunkABQ2VGUBcjs.hasEffectTags; exports.isCameraView = _chunkABQ2VGUBcjs.isCameraView; exports.isEffectError = _chunkABQ2VGUBcjs.isEffectError; exports.isEffectFontControl = isEffectFontControl; exports.isEffectPixels = _chunkABQ2VGUBcjs.isEffectPixels; exports.linearToSrgb = _chunkABQ2VGUBcjs.linearToSrgb; exports.normaliseEffectTag = _chunkABQ2VGUBcjs.normaliseEffectTag; exports.renderEffectThumbnail = renderEffectThumbnail; exports.resolveEffectValues = _chunkABQ2VGUBcjs.resolveEffectValues; exports.sampleCameraViews = _chunkABQ2VGUBcjs.sampleCameraViews; exports.sampleEffectCameraMove = _chunkABQ2VGUBcjs.sampleEffectCameraMove; exports.searchEffectSummaries = _chunkABQ2VGUBcjs.searchEffectSummaries; exports.srgbToLinear = _chunkABQ2VGUBcjs.srgbToLinear;

package/dist/effects/index.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-N4ZXW3WB.js";
 import {
   createEffectAuthoringSession
-} from "../chunk-WA4IS2EY.js";
+} from "../chunk-4MDWEX44.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
@@ -37,7 +37,7 @@ import {
   sampleEffectCameraMove,
   searchEffectSummaries,
   srgbToLinear
-} from "../chunk-HKPLKISO.js";
+} from "../chunk-7DZ55AIE.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-RNSANXPT.js";
 import {

package/dist/effects/tools.d.cts

@@ -68,17 +68,23 @@ export interface EffectToolHost {
     readOnlyReason(): string | null;
     /** Every target with effects, or one target (throws for an unknown id, naming valid ones). */
     list(target?: string): EffectTargetEffects[];
+    /** Arguments `apply_effect` takes on this editor besides the shared ones (name → schema); given ones reach `apply` in `args`. */
+    applyOptions?: Record<string, JsonSchema>;
+    /** Arguments `update_effect` takes on this editor besides the shared ones; given ones reach `update` in `changes`. */
+    updateOptions?: Record<string, JsonSchema>;
     apply(target: string, effect: string, args: {
         values?: Record<string, unknown>;
         index?: number;
         enabled?: boolean;
         opacity?: number;
+        [option: string]: unknown;
     }): Promise<EffectChangeResult>;
     update(target: string, instance: string, changes: {
         values?: Record<string, unknown>;
         index?: number;
         enabled?: boolean;
         opacity?: number;
+        [option: string]: unknown;
     }): Promise<EffectChangeResult>;
     remove(target: string, instance: string): Promise<EffectChangeResult>;
     /** Editor-specific effect tools (transitions, effect clips, effect layers, keyframes). */

package/dist/effects/tools.d.ts

@@ -68,17 +68,23 @@ export interface EffectToolHost {
     readOnlyReason(): string | null;
     /** Every target with effects, or one target (throws for an unknown id, naming valid ones). */
     list(target?: string): EffectTargetEffects[];
+    /** Arguments `apply_effect` takes on this editor besides the shared ones (name → schema); given ones reach `apply` in `args`. */
+    applyOptions?: Record<string, JsonSchema>;
+    /** Arguments `update_effect` takes on this editor besides the shared ones; given ones reach `update` in `changes`. */
+    updateOptions?: Record<string, JsonSchema>;
     apply(target: string, effect: string, args: {
         values?: Record<string, unknown>;
         index?: number;
         enabled?: boolean;
         opacity?: number;
+        [option: string]: unknown;
     }): Promise<EffectChangeResult>;
     update(target: string, instance: string, changes: {
         values?: Record<string, unknown>;
         index?: number;
         enabled?: boolean;
         opacity?: number;
+        [option: string]: unknown;
     }): Promise<EffectChangeResult>;
     remove(target: string, instance: string): Promise<EffectChangeResult>;
     /** Editor-specific effect tools (transitions, effect clips, effect layers, keyframes). */

package/dist/image-editor/controller.d.cts

@@ -225,7 +225,8 @@ export interface AdjustmentLayerInit<K extends AdjustmentKind = AdjustmentKind>
      * Mask the new layer with the selection when there is one and no `mask` is given (Photoshop's
      * behaviour). Default false here, for compatibility; the agent tool and the panels pass true.
      */
-    useSelection?: boolean;
+    useSelection?: boolean; /** Clip the new layer to the layer below it (a clipping mask), so it only adjusts that layer. Default false. */
+    clipped?: boolean;
 }
 /** A new pixel layer: empty, a solid colour over the canvas, or given pixels, plus its properties and position. */
 export interface PixelLayerInit extends LayerPlacement {
@@ -859,6 +860,8 @@ export declare class ImageEditorController {
         enabled?: boolean;
         blend?: string;
         opacity?: number;
+        /** Keep the layer's transparency: the result never fills transparent pixels. Default false (the effect's alpha replaces the layer's). */
+        preserveTransparency?: boolean;
         /** Limit the filter to the selection (sets the filter mask from it, same undo step). Default false. */
         useSelection?: boolean;
     }): Promise<{
@@ -869,7 +872,8 @@ export declare class ImageEditorController {
     }>;
     /**
      * 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).
      */
@@ -878,6 +882,7 @@ export declare class ImageEditorController {
         enabled?: boolean;
         blend?: string;
         opacity?: number;
+        preserveTransparency?: boolean;
         index?: number;
     }, commitToHistory?: boolean): Promise<SmartFilter>;
     /**
@@ -885,8 +890,9 @@ export declare class ImageEditorController {
      * 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.
      */
     addEffectLayer(effect: string, options?: LayerPlacement & {
         values?: Record<string, EffectValue>;
@@ -896,6 +902,7 @@ export declare class ImageEditorController {
         opacity?: number;
         blend?: string;
         id?: string;
+        clipped?: boolean;
     }): Promise<string>;
     /**
      * Draws an effect layer again, replacing its pixels (painting on it is lost): with new `values`
@@ -1757,6 +1764,7 @@ export declare class ImageEditorController {
      * 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<K extends AdjustmentKind>(init: K | AdjustmentLayerInit<K>, index?: number): string;
     /**

package/dist/image-editor/controller.d.ts

@@ -225,7 +225,8 @@ export interface AdjustmentLayerInit<K extends AdjustmentKind = AdjustmentKind>
      * Mask the new layer with the selection when there is one and no `mask` is given (Photoshop's
      * behaviour). Default false here, for compatibility; the agent tool and the panels pass true.
      */
-    useSelection?: boolean;
+    useSelection?: boolean; /** Clip the new layer to the layer below it (a clipping mask), so it only adjusts that layer. Default false. */
+    clipped?: boolean;
 }
 /** A new pixel layer: empty, a solid colour over the canvas, or given pixels, plus its properties and position. */
 export interface PixelLayerInit extends LayerPlacement {
@@ -859,6 +860,8 @@ export declare class ImageEditorController {
         enabled?: boolean;
         blend?: string;
         opacity?: number;
+        /** Keep the layer's transparency: the result never fills transparent pixels. Default false (the effect's alpha replaces the layer's). */
+        preserveTransparency?: boolean;
         /** Limit the filter to the selection (sets the filter mask from it, same undo step). Default false. */
         useSelection?: boolean;
     }): Promise<{
@@ -869,7 +872,8 @@ export declare class ImageEditorController {
     }>;
     /**
      * 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).
      */
@@ -878,6 +882,7 @@ export declare class ImageEditorController {
         enabled?: boolean;
         blend?: string;
         opacity?: number;
+        preserveTransparency?: boolean;
         index?: number;
     }, commitToHistory?: boolean): Promise<SmartFilter>;
     /**
@@ -885,8 +890,9 @@ export declare class ImageEditorController {
      * 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.
      */
     addEffectLayer(effect: string, options?: LayerPlacement & {
         values?: Record<string, EffectValue>;
@@ -896,6 +902,7 @@ export declare class ImageEditorController {
         opacity?: number;
         blend?: string;
         id?: string;
+        clipped?: boolean;
     }): Promise<string>;
     /**
      * Draws an effect layer again, replacing its pixels (painting on it is lost): with new `values`
@@ -1757,6 +1764,7 @@ export declare class ImageEditorController {
      * 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<K extends AdjustmentKind>(init: K | AdjustmentLayerInit<K>, index?: number): string;
     /**