@pixerate/editor 0.240.0 → 0.242.0

package/dist/{chunk-JWCKJNDR.cjs → chunk-K5DS2JTA.cjs}

@@ -4,7 +4,7 @@
 
 
 
-var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
+var _chunkGHCSC2WPcjs = require('./chunk-GHCSC2WP.cjs');
 
 // src/effects/templates.ts
 var SLOT_NAME = /^[A-Za-z][\w-]*$/;
@@ -133,7 +133,7 @@ function searchTemplateSummaries(catalog, options = {}) {
   const words = (_nullishCoalesce(options.query, () => ( ""))).toLowerCase().split(/\s+/).filter(Boolean);
   const scored = [];
   for (const t of catalog) {
-    if (!_chunkJAOSL334cjs.hasEffectTags.call(void 0, t, options.tags)) continue;
+    if (!_chunkGHCSC2WPcjs.hasEffectTags.call(void 0, t, options.tags)) continue;
     let score = 0;
     const name = t.name.toLowerCase();
     const rest = [t.id, ..._nullishCoalesce(t.tags, () => ( [])), t.description].join(" ").toLowerCase();
@@ -200,7 +200,7 @@ function checkEffectSequence(sequence, catalog) {
           const p = effectSubjectProblem(layer.subject);
           if (p) problems.push(`${where}: ${p}.`);
         }
-        if (layer.role !== void 0 && !_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkJAOSL334cjs.EFFECT_LAYER_ROLES.join(", ")}.`);
+        if (layer.role !== void 0 && !_chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES.includes(layer.role)) problems.push(`${where}: role is one of ${_chunkGHCSC2WPcjs.EFFECT_LAYER_ROLES.join(", ")}.`);
         if (layer.rect !== void 0 && !isRect(layer.rect)) problems.push(`${where}: rect must be { x, y, width, height } with width and height > 0.`);
         for (const k of ["from", "until"]) if (layer[k] !== void 0 && !isLayerTime(layer[k])) problems.push(`${where}: ${k} is ms \u2265 0 or { shots: n } with n \u2265 1.`);
         if (layer.opacity !== void 0 && !(typeof layer.opacity === "number" && layer.opacity >= 0 && layer.opacity <= 1)) problems.push(`${where}: opacity is 0\u20131.`);
@@ -235,8 +235,8 @@ function effectSequenceSlots(sequence) {
   return [...out];
 }
 async function fillEffectTemplate(provider, id, values = {}, options = {}) {
-  if (!provider) throw new (0, _chunkJAOSL334cjs.NoEffectsProviderError)();
-  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkJAOSL334cjs.EffectUnsupportedError)(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
+  if (!provider) throw new (0, _chunkGHCSC2WPcjs.NoEffectsProviderError)();
+  if (!provider.capabilities.supportsTemplates || !provider.describeTemplate || !provider.instantiateTemplate) throw new (0, _chunkGHCSC2WPcjs.EffectUnsupportedError)(`${provider.name} has no sequence templates (capabilities.supportsTemplates is not set).`);
   const template = await provider.describeTemplate(id);
   const errors = checkTemplateValues(template.slots, values);
   if (errors.length) throw new Error(`${errors.join(" ")} describe_template lists what each slot takes.`);
@@ -256,7 +256,7 @@ function effectSequenceTiming(sequence) {
   const leadIns = [];
   let t = 0;
   sequence.shots.forEach((shot, i) => {
-    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkJAOSL334cjs.EFFECT_TRANSITION_MS)) : 0;
+    const transition = i > 0 && shot.transition ? _nullishCoalesce(shot.transition.ms, () => ( _chunkGHCSC2WPcjs.EFFECT_TRANSITION_MS)) : 0;
     const move = typeof _optionalChain([shot, 'access', _4 => _4.camera, 'optionalAccess', _5 => _5.in]) === "object" && i > 0 ? _nullishCoalesce(shot.camera.in.ms, () => ( 0)) : 0;
     const lead = Math.max(transition, move);
     starts.push(t);

package/dist/{chunk-THXFU3JB.cjs → chunk-KCMV2534.cjs}

@@ -1,6 +1,6 @@
 "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 _chunkNKTNLJUJcjs = require('./chunk-NKTNLJUJ.cjs');
+var _chunk5BR7LC24cjs = require('./chunk-5BR7LC24.cjs');
 
 
 var _chunkCVFAAZXEcjs = require('./chunk-CVFAAZXE.cjs');
@@ -2527,7 +2527,7 @@ function vectorExtrudeFaces(path, params) {
 // src/vector/brushstroke.ts
 var VECTOR_BRUSHSTROKE_SCALE = 2;
 function vectorBrushstrokeBrushes() {
-  return _chunkNKTNLJUJcjs.BUILTIN_BRUSHES.filter((b) => _chunkPQ3H2AANcjs.isBrushstrokeBrush.call(void 0, b));
+  return _chunk5BR7LC24cjs.BUILTIN_BRUSHES.filter((b) => _chunkPQ3H2AANcjs.isBrushstrokeBrush.call(void 0, b));
 }
 function vectorBrushstrokeBrush(id) {
   return _nullishCoalesce(vectorBrushstrokeBrushes().find((b) => b.id === id), () => ( null));

package/dist/{chunk-WDDUPWVG.js → chunk-L3JFOTBQ.js}

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

package/dist/{chunk-3E36VDMJ.js → chunk-NE6OOKWJ.js}

@@ -104,7 +104,7 @@ import {
   transformTextRect,
   translateMatrix,
   warpPresetMesh
-} from "./chunk-7YGBSFC6.js";
+} from "./chunk-ILM6GYAX.js";
 import {
   bezierPathBounds,
   outlineStroke,

package/dist/{chunk-SIK3LT6M.js → chunk-OFH6Q67U.js}

@@ -6,6 +6,8 @@ import {
 var EFFECT_KINDS = ["shader", "vector", "motion", "camera"];
 var EFFECT_USES = ["filter", "transition", "generator", "overlay", "title", "motion", "interactive", "camera"];
 var CAMERA_MOVE_ROLES = ["transition", "hold"];
+var EFFECT_ACCEPTS = ["path"];
+var EFFECT_PATH_FORMAT = "svg-path";
 var EFFECT_SUBJECT_KINDS = ["image", "video", "svg", "text", "slot"];
 var EFFECT_LAYER_ROLES = ["background", "subject", "overlay"];
 var EFFECT_TRANSITION_MS = 800;
@@ -104,7 +106,11 @@ function countEffectTags(effects) {
   for (const e of effects) for (const tag of new Set((e.tags ?? []).map(normaliseEffectTag))) if (tag) counts.set(tag, (counts.get(tag) ?? 0) + 1);
   return [...counts].map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
 }
-var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags);
+var matchesFilters = (e, o) => (!o.kind || e.kind === o.kind) && (!o.category || e.category === o.category) && (!o.use || e.uses.includes(o.use)) && hasEffectTags(e, o.tags) && (!o.accepts?.length || o.accepts.every((a) => e.accepts?.includes(a)));
+function pathControlsOf(d) {
+  const isPath = (s) => !!s && (s.format === EFFECT_PATH_FORMAT || [...s.anyOf ?? [], ...s.oneOf ?? []].some((x) => isPath(x)));
+  return Object.entries(d.controls?.properties ?? {}).filter(([, s]) => isPath(s)).map(([name]) => name);
+}
 function searchEffectSummaries(catalog, query = "", options = {}) {
   const words = query.toLowerCase().split(/\s+/).filter(Boolean);
   const scored = [];
@@ -322,7 +328,8 @@ var summaryOut = (e) => ({
   transparent: e.transparent,
   loop: e.loop,
   ...e.duration !== void 0 ? { duration: e.duration } : {},
-  ...e.camera ? { camera: e.camera } : {}
+  ...e.camera ? { camera: e.camera } : {},
+  ...e.accepts?.length ? { accepts: e.accepts } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -380,21 +387,32 @@ function createEffectToolProvider(host) {
     {
       name: "search_effects",
       title: "Search effects",
-      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one). For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
+      description: `Searches the effects provider's catalog. Every word of query must appear in an effect's id, name, category, tags or description; filter by kind (shader, vector, motion, camera), category, use (${EFFECT_USES.join(", ")}) or tags (effects carrying every one), and accepts ["path"] for effects that draw along a path you give. For this editor, apply_effect takes uses ${host.applyUses.join(" or ")}. Returns { provider, effects: [{ id, name, kind, category, uses, description, tags, transparent, loop, duration (ms), camera: { role, durationMs, cut } for camera moves, accepts }], total, tags: [{ tag, count }] }: tags lists the tags of every match, the most used first, so a broad search (or none) shows the tags to narrow by. A tag the catalog does not have comes back in unknownTags with the nearest ones. With no provider registered it returns available: false and the reason. Call describe_effect next for an effect's controls.`,
       inputSchema: object({
         query: { type: "string", description: "Words to match (default: every effect)." },
         kind: { type: "string", enum: [...EFFECT_KINDS], description: "shader (pixels), vector (animated SVG), motion (animates vector art) or camera (moves a scene's camera; no pixels)." },
         category: { type: "string", minLength: 1, description: `The provider's category, e.g. "gradient", "light", "transition".` },
         use: { type: "string", enum: [...EFFECT_USES], description: "What the effect is for: filter changes a picture, transition blends two, generator draws a background, overlay draws over content, title draws a title, motion animates vector art, interactive reacts to input, camera moves a scene's camera." },
         tags: { type: "array", items: { type: "string", minLength: 1 }, description: "Only effects carrying every one of these tags, as search_effects lists them (any case; spaces count as hyphens)." },
-        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." }
+        limit: { type: "integer", minimum: 1, maximum: 200, description: "Most effects to return (default 20)." },
+        accepts: { type: "array", items: { type: "string", enum: [...EFFECT_ACCEPTS], description: "path: the effect has a control that draws along a path given at run time." }, description: "Only effects that take every one of these (path: effects that draw along a path you give; describe_effect names the controls in pathControls)." }
       }),
       annotations: { title: "Search effects", ...ANNOTATIONS.read },
       handler: async (args) => {
         const p = host.provider();
         if (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };
         const tags = args.tags;
-        const found = (await explain(async () => p.search(args.query ?? "", { kind: args.kind, category: args.category, use: args.use, tags }))).filter((e) => hasEffectTags(e, tags));
+        const accepts = args.accepts;
+        let found = (await explain(async () => p.search(args.query ?? "", { kind: args.kind, category: args.category, use: args.use, tags, ...accepts?.length ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
+        if (accepts?.includes("path")) {
+          const kept = [];
+          for (const e of found) {
+            if (e.accepts) {
+              if (accepts.every((a) => e.accepts.includes(a))) kept.push(e);
+            } else if (kept.length < 200 && pathControlsOf(await explain(async () => p.describe(e.id))).length) kept.push(e);
+          }
+          found = kept;
+        }
         const limit = args.limit ?? 20;
         const out = { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length, tags: countEffectTags(found).slice(0, TAG_LIMIT) };
         if (tags?.length && !found.length) {
@@ -416,7 +434,8 @@ function createEffectToolProvider(host) {
         const p = host.provider();
         if (!p) return { available: false, reason: NO_PROVIDER };
         const d = await explain(async () => p.describe(args.effect));
-        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) };
+        const pathControls = pathControlsOf(d);
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses), ...pathControls.length ? { pathControls } : {} };
       }
     },
     {
@@ -531,6 +550,8 @@ export {
   EFFECT_KINDS,
   EFFECT_USES,
   CAMERA_MOVE_ROLES,
+  EFFECT_ACCEPTS,
+  EFFECT_PATH_FORMAT,
   EFFECT_SUBJECT_KINDS,
   EFFECT_LAYER_ROLES,
   EFFECT_TRANSITION_MS,
@@ -550,6 +571,7 @@ export {
   normaliseEffectTag,
   hasEffectTags,
   countEffectTags,
+  pathControlsOf,
   searchEffectSummaries,
   createEffectPixels,
   isEffectPixels,

package/dist/{chunk-RV5DKZHU.js → chunk-QP2B3MID.js}

@@ -74,7 +74,7 @@ function profileAlongPolyline(points, values, count = 32) {
 var round3 = (v) => Math.round(v * 1e3) / 1e3;
 var loading = null;
 function loadCanvasBrushstrokeRenderer() {
-  loading ??= import("./brushstrokeRender-WB67GMUP.js").catch((error) => {
+  loading ??= import("./brushstrokeRender-MOYGEXOC.js").catch((error) => {
     loading = null;
     throw error;
   });

package/dist/{chunk-G3RUKJ5C.js → chunk-RXZL4NG5.js}

@@ -4,7 +4,7 @@ import {
   EffectUnsupportedError,
   NoEffectsProviderError,
   hasEffectTags
-} from "./chunk-SIK3LT6M.js";
+} from "./chunk-OFH6Q67U.js";
 
 // src/effects/templates.ts
 var SLOT_NAME = /^[A-Za-z][\w-]*$/;

package/dist/{chunk-UUBO6RB5.js → chunk-UDBDYZET.js}

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

package/dist/{chunk-TEFQISBY.js → chunk-X3ZINLIP.js}

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

package/dist/{chunk-PJYG6FCF.js → chunk-XBZK47LV.js}

@@ -36,12 +36,50 @@ import {
 } from "./chunk-F67XMVDI.js";
 
 // src/paint-editor/effect-paint.ts
+var EFFECT_STRIP_HEIGHT = 256;
+var EFFECT_MAP_REPEATS = ["repeat", "mirror", "clamp"];
+function effectPaintSize(p, canvas) {
+  return p.map ? { width: p.map.length, height: EFFECT_STRIP_HEIGHT } : { width: canvas.width, height: canvas.height };
+}
+function readEffectStrokeMap(raw) {
+  if (raw === void 0 || raw === null || raw.by === "canvas") return void 0;
+  const r = raw;
+  if (r.by !== "stroke") throw new Error(`map.by ${JSON.stringify(r.by)} is not a mapping; use "canvas" (fixed to the canvas) or "stroke" (along each stroke).`);
+  const length = r.length === void 0 ? 300 : Number(r.length);
+  if (!(Number.isFinite(length) && length >= 16 && length <= 4096)) throw new Error(`map.length ${JSON.stringify(r.length)} is out of range; use 16..4096 px of stroke per repeat.`);
+  const repeat = r.repeat === void 0 ? "repeat" : r.repeat;
+  if (!EFFECT_MAP_REPEATS.includes(repeat)) throw new Error(`map.repeat ${JSON.stringify(r.repeat)} is not a repeat mode; use ${EFFECT_MAP_REPEATS.join(", ")}.`);
+  return { by: "stroke", length: Math.round(length), repeat };
+}
+function stripIndex(img, map, dab, x, y) {
+  const ca = Math.cos(dab.direction);
+  const sa = Math.sin(dab.direction);
+  const dx = x - dab.x;
+  const dy = y - dab.y;
+  let u = (dab.travel + dx * ca - dy * sa) / map.length;
+  if (map.repeat === "clamp") u = Math.min(1, Math.max(0, u));
+  else if (map.repeat === "mirror") {
+    const m = (u % 2 + 2) % 2;
+    u = m > 1 ? 2 - m : m;
+  } else u = (u % 1 + 1) % 1;
+  const v = Math.min(1, Math.max(0, ((dx * sa + dy * ca) / Math.max(0.5, dab.radius) + 1) / 2));
+  const px = Math.min(img.width - 1, Math.floor(u * img.width));
+  const py = Math.min(img.height - 1, Math.floor(v * img.height));
+  return (py * img.width + px) * 4;
+}
 function effectPaintKey(p) {
-  return JSON.stringify({ type: "effect", effect: p.effect, provider: p.provider, values: p.values, time: p.time });
+  return JSON.stringify({ type: "effect", effect: p.effect, provider: p.provider, values: p.values, time: p.time, ...p.map ? { map: p.map } : {} });
 }
 function isPaintEffectPaint(raw) {
   return Boolean(raw) && typeof raw === "object" && raw.type === "effect";
 }
+function readMapLeniently(raw) {
+  try {
+    return readEffectStrokeMap(raw);
+  } catch {
+    return void 0;
+  }
+}
 function readPaintEffectPaint(raw) {
   if (!isPaintEffectPaint(raw)) return null;
   const r = raw;
@@ -51,11 +89,27 @@ function readPaintEffectPaint(raw) {
     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
+    time: typeof r.time === "number" && Number.isFinite(r.time) && r.time > 0 ? r.time : 0,
+    ...readMapLeniently(r.map) ? { map: readMapLeniently(r.map) } : {},
+    ...r.live === true ? { live: true } : {}
   };
 }
-function sampleEffectField(img, rect, vals, field) {
+function sampleEffectField(img, rect, vals, field, dab) {
   const { width, height, data } = img;
+  if (img.map && dab) {
+    for (let yy = 0, k = 0; yy < rect.height; yy++) {
+      for (let xx = 0; xx < rect.width; xx++, k++) {
+        const i = stripIndex(img, img.map, dab, rect.x + xx + 0.5, rect.y + yy + 0.5);
+        const f = k * 3;
+        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;
+      }
+    }
+    return;
+  }
   for (let yy = 0, k = 0; yy < rect.height; yy++) {
     const y = rect.y + yy;
     const inY = y >= 0 && y < height;
@@ -76,7 +130,14 @@ function sampleEffectField(img, rect, vals, field) {
     }
   }
 }
-function sampleEffectAt(img, x, y, out) {
+function sampleEffectAt(img, x, y, out, dab) {
+  if (img.map && dab) {
+    const i2 = stripIndex(img, img.map, dab, x, y);
+    out[0] = img.data[i2] / 255;
+    out[1] = img.data[i2 + 1] / 255;
+    out[2] = img.data[i2 + 2] / 255;
+    return img.data[i2 + 3] / 255;
+  }
   const px = Math.floor(x);
   const py = Math.floor(y);
   if (px < 0 || py < 0 || px >= img.width || py >= img.height) return 0;
@@ -86,6 +147,20 @@ function sampleEffectAt(img, x, y, out) {
   out[2] = img.data[i + 2] / 255;
   return img.data[i + 3] / 255;
 }
+function effectDabField(img, rect, cov, centre, mixed, field, steps = 0, dab = null) {
+  sampleEffectField(img, rect, cov, field, dab);
+  const d0 = mixed[0] - centre[0];
+  const d1 = mixed[1] - centre[1];
+  const d2 = mixed[2] - centre[2];
+  const n = rect.width * rect.height;
+  for (let k = 0; k < n; k++) {
+    if (steps) cov[k] = Math.round(cov[k] * steps) / steps;
+    const f = k * 3;
+    field[f] = Math.min(1, Math.max(0, field[f] + d0));
+    field[f + 1] = Math.min(1, Math.max(0, field[f + 1] + d1));
+    field[f + 2] = Math.min(1, Math.max(0, field[f + 2] + d2));
+  }
+}
 
 // src/paint-editor/paper.ts
 var PAPER_FAMILIES = ["watercolor", "drawing", "pastel", "canvas", "panel", "smooth"];
@@ -490,7 +565,7 @@ var DryStroke = class {
       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);
+        sampleEffectField(this.options.effect, rect, vals, field, d);
       }
       this.coverage.accumulate(rect, vals, d.opacity, null, field);
       rects.push(rect);
@@ -692,6 +767,10 @@ var StickerSpray = class {
     const a = rand01(seed, i, 53) * Math.PI * 2;
     const dist = rand01(seed, i, 55) * off;
     const base = this.colorAt(d, Math.cos(a) * dist, Math.sin(a) * dist);
+    if (!(base.alpha > 0)) {
+      this.next++;
+      return;
+    }
     const sticker = {
       id: `st${this.next++}`,
       stamp: st.stamps[Math.floor(rand01(seed, i, 57) * st.stamps.length)] ?? "dot",
@@ -710,6 +789,12 @@ var StickerSpray = class {
   sampler;
   /** A sticker's colour: the paint colour, or gradient paint at its dab (`dx`, `dy` from the dab's centre). */
   colorAt(d, dx, dy) {
+    const effect = this.init.effect;
+    if (effect) {
+      const rgb = [0, 0, 0];
+      const alpha = sampleEffectAt(effect, d.x + dx, d.y + dy, rgb, d);
+      return { color: "#" + rgb.map((c) => Math.round(c * 255).toString(16).padStart(2, "0")).join(""), alpha };
+    }
     const g = this.init.paint;
     if (!g) return { color: this.init.color, alpha: 1 };
     this.sampler ??= new PaintGradientSampler(g, this.init.seed);
@@ -841,10 +926,8 @@ var MarkStroke = class {
     return rects;
   }
   step(copy, d, rects) {
-    if (this.sampler) {
-      this.pen = d;
-      if (!this.tipTable) this.sampler.dab(d, this.penColor);
-    }
+    this.pen = d;
+    if (this.sampler && !this.tipTable) this.sampler.dab(d, this.penColor);
     this.advance(copy, d, rects);
   }
   /** The colour of a mark at (x, y): its pen dab's, or across the tip by its offset from the pen. */
@@ -887,7 +970,7 @@ var MarkStroke = class {
     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);
+      sampleEffectField(this.options.effect, rect, vals, field, this.pen);
       this.coverage.accumulate(rect, vals, dab.opacity, null, field);
     } else {
       const color = this.markColor(x, y);
@@ -1888,11 +1971,16 @@ function parseBrushLibrary(raw, problems = []) {
 }
 
 export {
+  EFFECT_STRIP_HEIGHT,
+  EFFECT_MAP_REPEATS,
+  effectPaintSize,
+  readEffectStrokeMap,
   effectPaintKey,
   isPaintEffectPaint,
   readPaintEffectPaint,
   sampleEffectField,
   sampleEffectAt,
+  effectDabField,
   PAPER_FAMILIES,
   PAPER_LIBRARY,
   DEFAULT_PAPER,

package/dist/{chunk-ZQIWBJGH.cjs → chunk-XNZFVYC2.cjs}

@@ -7,7 +7,7 @@ var _chunkPY4GWSE2cjs = require('./chunk-PY4GWSE2.cjs');
 
 
 
-var _chunkJAOSL334cjs = require('./chunk-JAOSL334.cjs');
+var _chunkGHCSC2WPcjs = require('./chunk-GHCSC2WP.cjs');
 
 
 var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
@@ -1316,12 +1316,12 @@ function videoEffectLayerKey(layer, width, height) {
 }
 function mixEffectPixels(a, b, k) {
   if (k >= 1) return b;
-  const out = _chunkJAOSL334cjs.createEffectPixels.call(void 0, a.width, a.height);
+  const out = _chunkGHCSC2WPcjs.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 = _chunkJAOSL334cjs.createEffectPixels.call(void 0, base.width, base.height);
+  const out = _chunkGHCSC2WPcjs.createEffectPixels.call(void 0, base.width, base.height);
   const o = out.data;
   const b = base.data;
   const t = top.data;
@@ -1366,7 +1366,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, _chunkJAOSL334cjs.EffectsSlot)()));
+    this.slot = _nullishCoalesce(options.slot, () => ( new (0, _chunkGHCSC2WPcjs.EffectsSlot)()));
     this.maxEntries = _nullishCoalesce(options.maxEntries, () => ( 120));
     this.toImage = _nullishCoalesce(options.toImage, () => ( defaultToImage));
     this.pool = new (0, _chunkPY4GWSE2cjs.EffectRendererPool)({ maxRenderers: options.maxRenderers });
@@ -1508,7 +1508,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, _chunkJAOSL334cjs.EffectUnsupportedError)(
+    throw new (0, _chunkGHCSC2WPcjs.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
     );
@@ -1529,12 +1529,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 _chunkJAOSL334cjs.effectValueErrors.call(void 0, d, plain)) {
+  for (const e of _chunkGHCSC2WPcjs.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, _chunkJAOSL334cjs.EffectControlError)(d.id, errors);
+  if (errors.length) throw new (0, _chunkGHCSC2WPcjs.EffectControlError)(d.id, errors);
   return { ..._nullishCoalesce(options.base, () => ( d.defaults)), ..._nullishCoalesce(values, () => ( {})) };
 }
 

package/dist/{chunk-XK4SST43.js → chunk-ZDPLZDTT.js}

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

package/dist/effects/fake.d.cts

@@ -9,6 +9,10 @@
  * - `crossfade` (transition)
  * - `fade-in` (motion, vector only)
  * - `badge` (a vector effect with its own picture: a disc that fades in; vector only)
+ * - `trail` (an overlay that draws a line along its `path` control, transparent)
+ * - `route` (a vector effect that draws its `path` control as a line; vector only)
+ *
+ * It writes words as path data (`pathFromText`): a zig-zag per letter, font `zig`.
  *
  * With `camera: true` it also has camera moves (no pixels): `glide` and `whip` (transitions; the
  * whip cuts halfway) and `drift` (a hold that zooms in slowly).

package/dist/effects/fake.d.ts

@@ -9,6 +9,10 @@
  * - `crossfade` (transition)
  * - `fade-in` (motion, vector only)
  * - `badge` (a vector effect with its own picture: a disc that fades in; vector only)
+ * - `trail` (an overlay that draws a line along its `path` control, transparent)
+ * - `route` (a vector effect that draws its `path` control as a line; vector only)
+ *
+ * It writes words as path data (`pathFromText`): a zig-zag per letter, font `zig`.
  *
  * With `camera: true` it also has camera moves (no pixels): `glide` and `whip` (transitions; the
  * whip cuts halfway) and `drift` (a hold that zooms in slowly).

package/dist/effects/helpers.d.cts

@@ -27,6 +27,12 @@ export declare function countEffectTags(effects: readonly Pick<EffectSummary, 't
     tag: string;
     count: number;
 }[];
+/**
+ * The controls of an effect that draw along a path given at run time: those whose schema (or one
+ * of its `anyOf` / `oneOf` choices) has `format: 'svg-path'`. See `EFFECT_PATH_FORMAT` for the
+ * values they take.
+ */
+export declare function pathControlsOf(d: Pick<EffectDescription, 'controls'>): string[];
 /**
  * Filters a catalog (kind, category, use and every tag) and ranks it against `query` (every word
  * must appear in the id, name, category, tags or description; name matches rank first). An empty query keeps catalog order.

package/dist/effects/helpers.d.ts

@@ -27,6 +27,12 @@ export declare function countEffectTags(effects: readonly Pick<EffectSummary, 't
     tag: string;
     count: number;
 }[];
+/**
+ * The controls of an effect that draw along a path given at run time: those whose schema (or one
+ * of its `anyOf` / `oneOf` choices) has `format: 'svg-path'`. See `EFFECT_PATH_FORMAT` for the
+ * values they take.
+ */
+export declare function pathControlsOf(d: Pick<EffectDescription, 'controls'>): string[];
 /**
  * Filters a catalog (kind, category, use and every tag) and ranks it against `query` (every word
  * must appear in the id, name, category, tags or description; name matches rank first). An empty query keeps catalog order.