pixi-effects 0.21.0 → 0.22.0

package/dist/{chunk-DDIXIWXK.js → chunk-DC4JPY6A.js}

@@ -1,4 +1,5 @@
-import { suggestName, warnUnknownOptions } from './chunk-MNM56B3X.js';
+import { collectPropKeys, describeLayer } from './chunk-E7RONUZ7.js';
+import { suggestName, warnUnknownOptions } from './chunk-NHICCDTC.js';
 import * as PIXI from 'pixi.js';
 import { Rectangle, Container, GraphicsPath, Graphics, Assets, Texture, Sprite, FillGradient, Text, Filter, GlProgram, defaultFilterVert, GpuProgram, UniformGroup, Color } from 'pixi.js';
 import { gsap } from 'gsap';
@@ -1408,269 +1409,6 @@ var NullSequence = class extends Sequence {
     this.buildFilters();
   }
 };
-
-// src/space/specKeys.ts
-function collectPropKeys(spec) {
-  const out = /* @__PURE__ */ new Set();
-  for (const k of Object.keys(spec.initial ?? {})) out.add(k);
-  for (const kf of spec.keyframes ?? []) {
-    for (const bag of [kf.set, kf.to, kf.from]) {
-      for (const k of Object.keys(bag ?? {})) out.add(k);
-    }
-  }
-  return out;
-}
-
-// src/core/layerKeys.ts
-var COMMON = ["type", "name", "parent", "at", "duration", "initial", "keyframes", "filters", "filterArea", "mask", "maskInverted", "blendMode", "threeD", "hideBehindCamera"];
-var VIDEO = [...COMMON, "asset", "loop", "audio", "volume", "speed"];
-var IMAGE = [...COMMON, "asset", "colorSpace"];
-var TEXT = [...COMMON, "text", "format", "style", "colorSpace", "fillGradient"];
-var AUDIO = [...COMMON, "volume", "asset", "loop", "sfx", "music", "speed"];
-var COMPOSITION = [...COMMON, "width", "height", "sequences", "transitions", "speed"];
-var CAMERA = [...COMMON];
-var NULL = [...COMMON];
-var SHAPE = [...COMMON, "shape", "fillGradient", "colorSpace", "strokeCap", "strokeJoin"];
-var TRIM = ["trimStart", "trimEnd", "trimEach"];
-var RECT = [...SHAPE, ...TRIM, "width", "height", "cornerRadius", "anchorX", "anchorY"];
-var CIRCLE = [...SHAPE, ...TRIM, "radius", "anchorX", "anchorY"];
-var ELLIPSE = [...SHAPE, ...TRIM, "radiusX", "radiusY", "anchorX", "anchorY"];
-var ARC = [...SHAPE, "radius", "innerRadius", "startAngle", "endAngle"];
-var LINE = [...SHAPE, ...TRIM, "from", "to"];
-var POLYGON = [...SHAPE, ...TRIM, "points", "open"];
-var PATH = [...SHAPE, ...TRIM, "d", "morphTo", "morph", "morphPoints"];
-var SHAPES = { rect: RECT, circle: CIRCLE, ellipse: ELLIPSE, arc: ARC, line: LINE, polygon: POLYGON, path: PATH };
-var BY_TYPE = { video: VIDEO, image: IMAGE, text: TEXT, audio: AUDIO, composition: COMPOSITION, camera: CAMERA, null: NULL };
-function kindName(spec) {
-  return spec.type === "shape" && spec.shape ? `${spec.shape} shape` : `${spec.type} layer`;
-}
-function layerKeys(spec) {
-  if (spec.type === "shape") return spec.shape && SHAPES[spec.shape] || null;
-  return BY_TYPE[spec.type] ?? null;
-}
-function kindsWithKey(key) {
-  const out = [];
-  for (const [shape, keys] of Object.entries(SHAPES)) if (keys.includes(key)) out.push(`${shape} shape`);
-  for (const [type, keys] of Object.entries(BY_TYPE)) if (keys.includes(key)) out.push(`${type} layer`);
-  return out;
-}
-var PROP_KEYS = /* @__PURE__ */ new Set([
-  // transform and look (GSAP + PixiPlugin names)
-  "x",
-  "y",
-  "z",
-  "alpha",
-  "rotation",
-  "rotationX",
-  "rotationY",
-  "width",
-  "height",
-  "visible",
-  "autoAlpha",
-  "scale",
-  "scaleX",
-  "scaleY",
-  "anchor",
-  "anchorX",
-  "anchorY",
-  "pivot",
-  "pivotX",
-  "pivotY",
-  "skew",
-  "skewX",
-  "skewY",
-  "position",
-  "positionX",
-  "positionY",
-  "tint",
-  "colorize",
-  "colorizeAmount",
-  "blur",
-  "blurX",
-  "blurY",
-  "blurPadding",
-  // shapes
-  "fillColor",
-  "fillAlpha",
-  "strokeColor",
-  "strokeAlpha",
-  "strokeWidth",
-  "lineColor",
-  "lineAlpha",
-  "cornerRadius",
-  "radius",
-  "radiusX",
-  "radiusY",
-  "innerRadius",
-  "startAngle",
-  "endAngle",
-  "trimStart",
-  "trimEnd",
-  "trimEach",
-  "morph",
-  "fillGradient",
-  "strokeCap",
-  "strokeJoin",
-  // text, audio, video
-  "fill",
-  "value",
-  "visibleChars",
-  "text",
-  "volume",
-  "time",
-  // camera
-  "lookAtX",
-  "lookAtY",
-  "lookAtZ",
-  "fov",
-  "focus",
-  "aperture",
-  "offsetX",
-  "offsetY",
-  "offsetZ",
-  "lookOffsetX",
-  "lookOffsetY",
-  "lookOffsetZ"
-]);
-var STYLE_KEYS = [
-  "fontSize",
-  "fontFamily",
-  "fontWeight",
-  "fontStyle",
-  "fontVariant",
-  "fill",
-  "stroke",
-  "dropShadow",
-  "letterSpacing",
-  "lineHeight",
-  "leading",
-  "align",
-  "wordWrap",
-  "wordWrapWidth",
-  "breakWords",
-  "whiteSpace",
-  "padding",
-  "textBaseline",
-  "trim",
-  "lineJoin",
-  "miterLimit",
-  "filters",
-  "tagStyles"
-];
-
-// src/core/lint.ts
-var defaultWarn = (m) => console.warn(m);
-function describeLayer(spec) {
-  return spec.name ? `layer "${spec.name}"` : `unnamed ${spec.type} layer`;
-}
-function lintTiming(spec, parentDuration, warn = defaultWarn) {
-  const who = describeLayer(spec);
-  const at = spec.at ?? 0;
-  if (at >= parentDuration) {
-    warn(`pixi-effects: ${who} starts at ${at}s, after its composition ends (${parentDuration}s), so it is never visible`);
-  }
-  if (spec.type === "audio" && (spec.sfx !== void 0 || spec.music !== void 0) && spec.duration === void 0) return;
-  const duration = spec.duration ?? parentDuration;
-  (spec.keyframes ?? []).forEach((kf, i) => {
-    const kat = kf.at ?? 0;
-    if (kat >= duration) {
-      warn(
-        `pixi-effects: ${who}: keyframes[${i}] starts at ${kat}s, after the layer ends (duration ${duration}s), so it never plays. Keyframe \`at\` is measured from the start of this layer, not from the start of the composition.`,
-        "late-keyframe"
-      );
-    }
-  });
-}
-function summarizeWarnings(messages, shown = 3) {
-  if (messages.length <= shown) return messages;
-  return [...messages.slice(0, shown), `pixi-effects: ${messages.length - shown} more layers with the same problem (the same loop or helper is probably building them): fix the ones above and these go away.`];
-}
-function lintText(spec, warn = defaultWarn) {
-  if (spec.type !== "text") return;
-  const strings = [spec.text ?? "", ...(spec.keyframes ?? []).map((kf) => String(kf.set?.text ?? ""))];
-  const hasPlaceholder = strings.some((t) => t.includes("{value}"));
-  if (hasPlaceholder && !collectPropKeys(spec).has("value")) {
-    warn(`pixi-effects: ${describeLayer(spec)}: the text has a {value} placeholder but nothing sets or animates \`value\`, so it prints 0. Set initial: { value: \u2026 } or animate it; {value} is reserved for counters (there is no way to print a literal "{value}").`);
-  }
-  if (collectPropKeys(spec).has("value") && !hasPlaceholder) {
-    warn(`pixi-effects: ${describeLayer(spec)}: \`value\` is set or animated but the text has no {value} placeholder, so nothing shows it. Use text: '{value}' (or e.g. '{value} users').`);
-  }
-}
-var REMAPPABLE = /* @__PURE__ */ new Set(["video", "audio", "composition"]);
-var REMAP_NAMES = /* @__PURE__ */ new Set(["time", "timeRemap", "reverse"]);
-var TIME_BAGS = ["set", "to", "from"];
-function lintRemap(spec, warn) {
-  const s = spec;
-  const who = describeLayer(spec);
-  const kfs = s.keyframes ?? [];
-  const bags = [s.initial, ...kfs.flatMap((kf) => TIME_BAGS.map((b) => kf[b]))];
-  const timeInInitial = !!s.initial && s.initial.time !== void 0;
-  const timeInKeyframes = kfs.some((kf) => TIME_BAGS.some((b) => kf[b] && kf[b].time !== void 0));
-  const timed = timeInInitial || timeInKeyframes;
-  if (bags.some((bag) => bag && bag.speed !== void 0)) {
-    warn(`pixi-effects: ${who}: speed is a fixed setting, not an animatable property: write it on the layer (speed: 2); to change the speed over time, animate time (keyframes: [{ at: 0, from: { time: 0 }, to: { time: 4 }, duration: 2, ease: 'power2.in' }])`);
-  }
-  if (!REMAPPABLE.has(spec.type)) {
-    if (timed) warn(`pixi-effects: ${who}: "time" only works on video, audio and composition layers; put this layer in a composition and remap that (it is ignored here)`);
-    return;
-  }
-  if (s.reverse !== void 0) warn(`pixi-effects: ${who}: "reverse" is not a key: write speed: -1 to play backward`);
-  if (s.timeRemap !== void 0) warn(`pixi-effects: ${who}: "timeRemap" is not a key: animate time in keyframes (from / to / set), or write speed`);
-  if (s.time !== void 0) warn(`pixi-effects: ${who}: "time" belongs in initial or keyframes (initial: { time: 2 }), not on the layer`);
-  if (spec.type === "audio" && (s.sfx !== void 0 || s.music !== void 0) && (s.speed !== void 0 || timed)) {
-    warn(`pixi-effects: ${who}: speed and time do not apply to a synthesised sound (sfx, music); change an sfx's pitch with pitch (semitones), or put it in a composition and remap that`);
-    return;
-  }
-  if (s.speed !== void 0 && (typeof s.speed !== "number" || !Number.isFinite(s.speed) || s.speed === 0)) {
-    warn(`pixi-effects: ${who}: speed ${JSON.stringify(s.speed)} cannot be used: write a number other than 0 (negative plays backward); to hold a moment, key time to the same value twice`);
-  }
-  if (s.speed !== void 0 && timeInKeyframes) {
-    warn(`pixi-effects: ${who}: speed and keyframed time are both set; time wins and speed is ignored. Use one of them`);
-  }
-  if (timeInInitial && typeof s.initial.time !== "number") {
-    warn(`pixi-effects: ${who}: initial.time must be a number of seconds, got ${JSON.stringify(s.initial.time)}`);
-  }
-  kfs.forEach((kf, i) => {
-    for (const b of TIME_BAGS) {
-      const v = kf[b]?.time;
-      if (v !== void 0 && typeof v !== "number" && typeof v !== "string") warn(`pixi-effects: ${who}: keyframes[${i}].${b}.time must be a number of seconds, got ${JSON.stringify(v)}`);
-    }
-  });
-}
-function lintKeys(spec, warn = defaultWarn) {
-  const who = describeLayer(spec);
-  const valid = layerKeys(spec);
-  if (valid) {
-    for (const key of Object.keys(spec)) {
-      if (valid.includes(key) || spec[key] === void 0) continue;
-      if (REMAPPABLE.has(spec.type) && REMAP_NAMES.has(key)) continue;
-      const guess = suggestName(key, valid.filter((k) => k !== "type"));
-      const owners = kindsWithKey(key);
-      const belongs = owners.length ? ` (it belongs to ${owners.slice(0, 3).join(", ")})` : "";
-      const hint = guess ? ` \u2014 did you mean "${guess}"?${belongs}` : belongs;
-      warn(`pixi-effects: ${who}: "${key}" is not a ${kindName(spec)} key${hint}. Valid keys: ${valid.join(", ")}`);
-    }
-  }
-  lintRemap(spec, warn);
-  const said = /* @__PURE__ */ new Set();
-  const bags = [spec.initial, ...(spec.keyframes ?? []).flatMap((kf) => [kf.set, kf.to, kf.from])];
-  for (const bag of bags) {
-    for (const key of Object.keys(bag ?? {})) {
-      if (bag[key] === void 0) continue;
-      if (PROP_KEYS.has(key) || key.includes(".") || /^gradient/i.test(key) || said.has(key) || key === "speed") continue;
-      said.add(key);
-      const guess = suggestName(key, [...PROP_KEYS]);
-      warn(`pixi-effects: ${who}: "${key}" is not an animatable property${guess ? ` \u2014 did you mean "${guess}"?` : ""} (in initial, set, to or from). See the cheatsheet for the properties of this kind of layer`);
-    }
-  }
-  if (spec.type === "text" && spec.style && typeof spec.style === "object") {
-    for (const key of Object.keys(spec.style)) {
-      if (STYLE_KEYS.includes(key) || spec.style[key] === void 0) continue;
-      const guess = suggestName(key, STYLE_KEYS);
-      warn(`pixi-effects: ${who}: style.${key} is not a text style key${guess ? ` \u2014 did you mean "${guess}"?` : ""} (it is ignored). Keys: ${STYLE_KEYS.join(", ")}`);
-    }
-  }
-}
 var BAGS = ["set", "to", "from"];
 function timeRemapOf(spec, prop = "time") {
   const hasInitial = !!spec.initial && "time" in spec.initial;
@@ -1947,10 +1685,14 @@ function focusProblems(camera, siblings) {
   for (const name of focusNames(camera, known)) {
     if (said.has(name)) continue;
     said.add(name);
-    const hit = siblings.find((s) => s.name === name);
+    const same = siblings.filter((s) => s.name === name);
+    const hit = same.find((s) => s.threeD) ?? same[0];
     if (!hit) out.push({ kind: "missing", name, hint: suggestName(name, threeD) });
     else if (!hit.threeD) out.push({ kind: "not-threeD", name });
-    else if (movesZ(hit)) out.push({ kind: "moving", name });
+    else {
+      if (same.length > 1) out.push({ kind: "duplicate", name, count: same.length });
+      if (movesZ(hit)) out.push({ kind: "moving", name });
+    }
   }
   return out;
 }
@@ -1960,6 +1702,7 @@ var CameraSequence = class extends Sequence {
   compH = 0;
   warnedFov = false;
   warnedLookAt = false;
+  warnedAperture = false;
   /** True when the camera writes `focus` or `aperture` anywhere: depth of field is on. */
   dof = false;
   zOfName = null;
@@ -1988,6 +1731,16 @@ var CameraSequence = class extends Sequence {
     this.autoZ = !keys.has("z");
     this.dof = keys.has("focus") || keys.has("aperture");
   }
+  /** The aperture to use now: off unless depth of field is on and the value is a number of 0 or more (said once if it is not). */
+  apertureNow(a) {
+    if (!this.dof) return 0;
+    if (!(a >= 0) && !this.warnedAperture) {
+      this.warnedAperture = true;
+      const who = this.spec.name ? ` "${this.spec.name}"` : "";
+      console.warn(`pixi-effects: camera${who}: aperture ${a} is not a number of 0 or more; depth of field is off (it is the lens diameter in px: 30 is the default, 0 turns it off)`);
+    }
+    return a > 0 ? a : 0;
+  }
   /** Called by the composition once its children exist: how a layer name in `focus` becomes the z of that layer. */
   resolveFocusNames(zOf, names = /* @__PURE__ */ new Set()) {
     this.zOfName = zOf;
@@ -2021,7 +1774,7 @@ var CameraSequence = class extends Sequence {
       lookAtZ: c.lookAtZ + c.lookOffsetZ,
       fov,
       focus: Number.isFinite(c.focus) ? c.focus : 0,
-      aperture: this.dof && c.aperture > 0 ? c.aperture : 0
+      aperture: this.apertureNow(c.aperture)
     };
   }
   /** Lifespan on the global timeline (valid after bindTimeline). */
@@ -2788,7 +2541,7 @@ var AudioSequence = class extends Sequence {
     const raw = spec;
     if (raw.asset !== void 0) console.warn(`pixi-effects: ${who}: has both asset and sfx \u2014 the sfx plays; remove one`);
     if (raw.loop) console.warn(`pixi-effects: ${who}: loop has no effect on an sfx \u2014 to repeat it, add one audio layer per hit (a JS loop)`);
-    const { resolveSfx, renderSfx, sfxKey } = await import('./sfx-U3GM2MED.js');
+    const { resolveSfx, renderSfx, sfxKey } = await import('./sfx-3IDAJ3UZ.js');
     const sfx = resolveSfx(spec.sfx, spec.duration, who);
     if (!sfx) return;
     this.duration = sfx.length;
@@ -2807,7 +2560,7 @@ var AudioSequence = class extends Sequence {
     const raw = spec;
     if (raw.asset !== void 0) console.warn(`pixi-effects: ${who}: has both asset and music \u2014 the music plays; remove one`);
     if (raw.sfx !== void 0) console.warn(`pixi-effects: ${who}: has both sfx and music \u2014 the music plays; remove one`);
-    const { resolveMusic, renderMusic, musicLength, musicKey } = await import('./music-CFEC7HKL.js');
+    const { resolveMusic, renderMusic, musicLength, musicKey } = await import('./music-FUN7N225.js');
     const music = resolveMusic(spec.music, who);
     if (!music) return;
     const natural = musicLength(music);
@@ -3286,7 +3039,7 @@ function morphAt(pairs, t) {
 }
 
 // src/sequences/Shape.ts
-var STYLE_KEYS2 = ["fillColor", "fillAlpha", "strokeColor", "strokeAlpha", "strokeWidth"];
+var STYLE_KEYS = ["fillColor", "fillAlpha", "strokeColor", "strokeAlpha", "strokeWidth"];
 var COLOR_KEYS = /* @__PURE__ */ new Set(["fillColor", "strokeColor"]);
 var TRIM_KEYS = ["trimStart", "trimEnd"];
 var GEOMETRY_KEYS_BY_SHAPE = {
@@ -3312,7 +3065,7 @@ var ShapeSequence = class extends Sequence {
   // by `Container.onRender`.
   _drawGeometry = () => {
   };
-  _liveKeys = new Set(STYLE_KEYS2);
+  _liveKeys = new Set(STYLE_KEYS);
   async build() {
     const graphics = new Graphics({ label: this.spec.name });
     graphics.cullable = true;
@@ -3506,7 +3259,7 @@ function seedStrokeStyle(state, spec, initial, who) {
   }
 }
 function seedStyle(state, initial, scope) {
-  for (const k of STYLE_KEYS2) {
+  for (const k of STYLE_KEYS) {
     const v = initial[k];
     if (v === void 0) continue;
     state[k] = COLOR_KEYS.has(k) ? v : numOrZero(v, scope);
@@ -3801,7 +3554,7 @@ function numOrZero(v, scope) {
 var _CompositionSequence = null;
 async function getCompositionSequence() {
   if (!_CompositionSequence) {
-    _CompositionSequence = (await import('./Composition-BVI236ZR.js')).CompositionSequence;
+    _CompositionSequence = (await import('./Composition-Q5TVG3HM.js')).CompositionSequence;
   }
   return _CompositionSequence;
 }
@@ -3839,6 +3592,6 @@ async function buildSequenceTree(specs, parent, root) {
   return out;
 }
 
-export { CameraSequence, DEFAULT_FOV, DEG, MANY_BLURRED, MAX_BLUR, MIN_BLUR, NEAR, NullSequence, Sequence, bindClock, blurRadius, buildScope, buildSequenceTree, cameraBasis, checkEase, clockTable, collectPropKeys, contentLength, describeLayer, ensureFilterLibrary, evaluateExpr, flattenSvgPath, focusProblems, homeCamera, homeDistance, layerInitialZ, lintKeys, lintText, lintTiming, noise, projectLayer, projectPoint, rand, random, registerSequenceType, remapOf, resolveAt, summarizeWarnings, timeRemapOf };
-//# sourceMappingURL=chunk-DDIXIWXK.js.map
-//# sourceMappingURL=chunk-DDIXIWXK.js.map
+export { CameraSequence, DEFAULT_FOV, DEG, MANY_BLURRED, MAX_BLUR, MIN_BLUR, NEAR, NullSequence, Sequence, bindClock, blurRadius, buildScope, buildSequenceTree, cameraBasis, checkEase, clockTable, contentLength, ensureFilterLibrary, evaluateExpr, flattenSvgPath, focusProblems, homeCamera, homeDistance, layerInitialZ, noise, projectLayer, projectPoint, rand, random, registerSequenceType, remapOf, resolveAt, timeRemapOf };
+//# sourceMappingURL=chunk-DC4JPY6A.js.map
+//# sourceMappingURL=chunk-DC4JPY6A.js.map