pixi-effects 0.35.0 → 0.36.0

package/dist/{chunk-7TTCPHAV.cjs → chunk-CC7SUR7Q.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk5IJENZOG_cjs = require('./chunk-5IJENZOG.cjs');
-var chunkLEECUCTG_cjs = require('./chunk-LEECUCTG.cjs');
-var chunkIMQJVRMT_cjs = require('./chunk-IMQJVRMT.cjs');
+var chunkY5UWFH6Y_cjs = require('./chunk-Y5UWFH6Y.cjs');
+var chunkKJSEQVBV_cjs = require('./chunk-KJSEQVBV.cjs');
+var chunkNEUPEENI_cjs = require('./chunk-NEUPEENI.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 var pixi_js = require('pixi.js');
 var mediabunny = require('mediabunny');
@@ -392,6 +392,7 @@ function findSilences(channels, sampleRate, opts = {}) {
 }
 
 // src/core/inspectAudio.ts
+var BURIED_DB = 12;
 var INAUDIBLE_DB = -50;
 var db = (x) => Math.round(10 * Math.max(-120, 20 * Math.log10(x))) / 10;
 var mono = (chans) => {
@@ -477,6 +478,7 @@ function analyzeAudio(mix, sources, stats, movieDuration, opts = {}) {
     return measure(Array.from({ length: b.numberOfChannels }, (_, c) => b.getChannelData(c)), b.sampleRate);
   };
   const scoreNotes = [];
+  const buried = [];
   const list = [...sources].sort((a, b) => a.start - b.start).map((s) => {
     const layer = s.layer ?? "an audio layer";
     const source = s.source ?? "audio";
@@ -504,8 +506,22 @@ function analyzeAudio(mix, sources, stats, movieDuration, opts = {}) {
       const over = s.music.seconds - plays;
       if (over > 2 && over / s.music.seconds > 0.15) scoreNotes.push(`${layer} (${source}): the score is ${Math.round(s.music.seconds * 10) / 10}s long but only ${Math.round(plays * 100) / 100}s of it play, so it is cut off mid-phrase. Write fewer bars (or a faster tempo) so it ends with the movie`);
     }
-    return { layer, source, start: s.start, end: s.end, peakDb, sound, ...s.music ? { music: s.music } : {} };
+    let belowMixDb;
+    if (!clock && !s.sourceMap && s.start < movieDuration && ownDb > INAUDIBLE_DB) {
+      const at = s.start + sound.loudestAt;
+      const around = db(peakIn(Math.max(0, at - 0.05), Math.min(movieDuration, at + 0.05)));
+      belowMixDb = Math.max(0, Math.round((around - ownDb) * 10) / 10);
+      if (!s.music && source.startsWith("sfx") && sound.length <= 4 && belowMixDb >= BURIED_DB) {
+        buried.push({ layer, source, ownDb, topVolume, around, belowMixDb, at: Math.round(at * 100) / 100 });
+      }
+    }
+    return { layer, source, start: s.start, end: s.end, peakDb, sound, ...belowMixDb !== void 0 ? { belowMixDb } : {}, ...s.music ? { music: s.music } : {} };
   });
+  if (buried.length > 0) {
+    const worst = buried.reduce((a, b) => b.belowMixDb > a.belowMixDb ? b : a);
+    const names = new Set(buried.map((x) => x.layer + x.source));
+    scoreNotes.push(`${names.size === 1 ? "1 sound effect is" : `${names.size} sound effects are`} buried (${BURIED_DB} dB or more under the loudest sample of the mix around its loudest moment${buried.length > names.size ? `, ${buried.length} times in all` : ""}): the worst is ${worst.layer} (${worst.source}), its own peak ${worst.ownDb} dBFS at volume ${worst.topVolume} against ${worst.around} dBFS at ${worst.at} s, ${worst.belowMixDb} dB louder. If it is meant to be heard, raise its volume (an accent over music needs 2 to 3) or lower what plays there; every source's belowMixDb has its own number`);
+  }
   const whole = measureLoudness(chans, sr);
   const silences = findSilences(chans, sr, { minLength: 1 });
   if (whole.clippedSamples > 0) issues.push(`${whole.clippedSamples} sample(s) of the mix are at full scale (clipped) \u2014 lower the volume of the layers that play loudest`);
@@ -1490,8 +1506,8 @@ function expandTransitions(spec) {
   }
   const transitions = out.transitions;
   const sequences = out.sequences ?? [];
-  const remap = out.duration !== void 0 ? chunkLEECUCTG_cjs.timeRemapOf(out) : null;
-  const parentDuration = remap ? chunkLEECUCTG_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
+  const remap = out.duration !== void 0 ? chunkKJSEQVBV_cjs.timeRemapOf(out) : null;
+  const parentDuration = remap ? chunkKJSEQVBV_cjs.contentLength(remap, out.duration) : out.duration ?? Infinity;
   const compW = out.width;
   const compH = out.height;
   const threeDByName = new Set(sequences.filter((s) => s.name && s.threeD).map((s) => s.name));
@@ -1559,16 +1575,16 @@ function expandTransitions(spec) {
     if (toUses > 1) {
       throw new Error(`pixi-effects: ${tag} sequence "${t.to}" is used as \`to\` in more than one transition`);
     }
-    const tStart = chunkLEECUCTG_cjs.resolveAt(t.at, parentDuration);
+    const tStart = chunkKJSEQVBV_cjs.resolveAt(t.at, parentDuration);
     const tEnd = tStart + t.duration;
     const fromSeq = fromEntry.seq;
-    const fromStart = chunkLEECUCTG_cjs.resolveAt(fromSeq.at, parentDuration);
+    const fromStart = chunkKJSEQVBV_cjs.resolveAt(fromSeq.at, parentDuration);
     const fromEnd = fromStart + (fromSeq.duration ?? parentDuration);
     if (tStart < fromStart - EPS || tEnd > fromEnd + EPS) {
       throw new Error(`pixi-effects: ${tag} window [${tStart}, ${tEnd}] is not covered by \`from\` "${t.from}" (lives [${fromStart}, ${fromEnd}], so it ends at ${fromEnd})`);
     }
     const toSeq = toEntry.seq;
-    const toStart = chunkLEECUCTG_cjs.resolveAt(toSeq.at, parentDuration);
+    const toStart = chunkKJSEQVBV_cjs.resolveAt(toSeq.at, parentDuration);
     const toEnd = toStart + (toSeq.duration ?? parentDuration);
     if (tStart < toStart - EPS || tEnd > toEnd + EPS) {
       throw new Error(`pixi-effects: ${tag} window [${tStart}, ${tEnd}] is not covered by \`to\` "${t.to}" (lives [${toStart}, ${toEnd}], so it starts at ${toStart})`);
@@ -1628,7 +1644,7 @@ function wrapAsFullComposition(seq, compW, compH) {
   delete inner.at;
   delete inner.duration;
   const m = inner.mask;
-  const carriesMatte = m !== void 0 && chunk5IJENZOG_cjs.maskSourceOf(m).kind === "refs";
+  const carriesMatte = m !== void 0 && chunkY5UWFH6Y_cjs.maskSourceOf(m).kind === "refs";
   if (carriesMatte) delete inner.mask;
   return {
     ...carriesMatte ? { mask: m } : {},
@@ -1884,6 +1900,20 @@ function rejectReservedNameCollision(filters, seqName) {
 }
 
 // src/core/inspect.ts
+function chainOf(node) {
+  const chain = [];
+  for (let n = node; n && n.parent; n = n.parent) {
+    const i = n.parent.children?.indexOf(n);
+    if (i === void 0 || i < 0) return null;
+    chain.unshift(i);
+  }
+  return chain.length ? chain : null;
+}
+function drawnAfter(a, b) {
+  if (!a || !b) return null;
+  for (let i = 0; i < Math.min(a.length, b.length); i++) if (a[i] !== b[i]) return a[i] > b[i];
+  return null;
+}
 var FAINT = 0.3;
 var intersection = (a, b) => {
   const w = Math.min(a.x + a.width, b.x + b.width) - Math.max(a.x, b.x);
@@ -1907,8 +1937,8 @@ function motionOf(keyframes, local, lives, keys = (k) => GEOMETRY.has(k)) {
     let length = 0;
     if (typeof kf.duration === "number") length = kf.duration;
     else if (kf.duration === "auto") {
-      const sp = chunkLEECUCTG_cjs.parseSpring(kf.ease);
-      length = sp ? Math.round(chunkLEECUCTG_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
+      const sp = chunkKJSEQVBV_cjs.parseSpring(kf.ease);
+      length = sp ? Math.round(chunkKJSEQVBV_cjs.springDuration(sp) * 1e3) / 1e3 : 0.5;
     }
     if (!(length > 0)) continue;
     const kat = kf.at ?? 0;
@@ -1927,7 +1957,11 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
   const scene = /* @__PURE__ */ new Map();
   const scaledToNothing = /* @__PURE__ */ new Set();
   const hasMotion = /* @__PURE__ */ new Set();
-  const walk2 = (comp, prefix, insideThreeD, parentVisible, parentScene, parentMotion = NO_MOTION, parentZero = false) => {
+  const kinds = /* @__PURE__ */ new Map();
+  const specs = /* @__PURE__ */ new Map();
+  const chains = /* @__PURE__ */ new Map();
+  const chainAlpha = /* @__PURE__ */ new Map();
+  const walk2 = (comp, prefix, insideThreeD, parentVisible, parentScene, parentMotion = NO_MOTION, parentZero = false, parentAlpha = 1) => {
     const blending = /* @__PURE__ */ new Set();
     const now = comp.childTime(time);
     const cameraMotion = (comp.spec.sequences ?? []).filter((q) => q.type === "camera").reduce((m, q) => either(m, motionOf(q.keyframes, now - comp.childBase - (q.at ?? 0), q.duration ?? comp.duration ?? Infinity, () => true)), NO_MOTION);
@@ -1971,10 +2005,14 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
       if (threeD) info.depthBlur = Number(depthBlur.toFixed(2));
       if (threeD && light !== void 0) info.light = Number(light.toFixed(2));
       layers.push(info);
+      chainAlpha.set(info, parentAlpha * alpha);
+      chains.set(info, chainOf(display));
+      specs.set(info, seq.spec);
+      kinds.set(info, seq.spec.type === "shape" ? String(seq.spec.shape) : seq.spec.type);
       if (motion.ever) hasMotion.add(info);
       let shown = bounds ? clip(bounds, view) : null;
       const maskTarget = seq.maskSequence?.target;
-      const maskSrc = chunk5IJENZOG_cjs.maskSourceOf(seq.spec.mask);
+      const maskSrc = chunkY5UWFH6Y_cjs.maskSourceOf(seq.spec.mask);
       if (shown && maskTarget && !(maskSrc.kind === "inline" && maskSrc.invert)) {
         const m = maskTarget.getBounds();
         shown = clip(shown, { x: m.x, y: m.y, width: m.width, height: m.height });
@@ -1983,7 +2021,7 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
       const group = parentScene ?? (name !== void 0 && blending.has(name) ? name : void 0);
       if (group) scene.set(info, group);
       if (zero || seq.showsNothingYet) scaledToNothing.add(info);
-      if (seq instanceof chunk5IJENZOG_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero);
+      if (seq instanceof chunkY5UWFH6Y_cjs.CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
     });
   };
   walk2(root, "", false, true);
@@ -2019,6 +2057,42 @@ function inspectScene(root, frame, time, canvas, opts = {}) {
       if (share > 0.25) issues.push(`text layers "${texts[i].path}" and "${texts[j].path}" overlap by ${Math.round(share * 100)}% of the smaller one`);
     }
   }
+  const FILLED = /* @__PURE__ */ new Set(["rect", "circle", "ellipse", "image", "video"]);
+  for (const t of texts) {
+    const tb = seen.get(t);
+    if (!tb) continue;
+    const area = tb.width * tb.height;
+    if (!(area > 0)) continue;
+    for (const o of layers) {
+      if (o === t || o.type === "text" || !o.visible || !o.bounds) continue;
+      if (o.path.startsWith(t.path + "/") || t.path.startsWith(o.path + "/")) continue;
+      const kind = kinds.get(o) ?? o.type, spec = specs.get(o) ?? {};
+      const initial = spec.initial ?? {};
+      const hairline = (kind === "line" || kind === "rect") && Math.min(o.bounds.width, o.bounds.height) < 12 && Math.max(o.bounds.width, o.bounds.height) >= 40;
+      const soft = spec.blendMode !== void 0 && spec.blendMode !== "normal" || Array.isArray(spec.filters) && spec.filters.length > 0;
+      const filled = kind === "image" || kind === "video" || initial.fillColor !== void 0 || spec.fillGradient !== void 0 || initial.fillGradient !== void 0;
+      if (o.threeD || t.threeD) continue;
+      const over = drawnAfter(chains.get(o) ?? null, chains.get(t) ?? null) ?? layers.indexOf(o) > layers.indexOf(t);
+      const opacity = chainAlpha.get(o) ?? o.alpha;
+      const hides = FILLED.has(kind) && !hairline && filled && !soft && over && opacity >= 0.8;
+      const cuts = hairline && !soft && over && opacity >= FAINT;
+      if (!hides && !cuts) continue;
+      const st = scene.get(t), so = scene.get(o);
+      if (st && so && st !== so) continue;
+      const ob = seen.get(o);
+      if (!ob) continue;
+      const covered = intersection(tb, ob) / area;
+      if (cuts) {
+        const horizontal = ob.width >= ob.height;
+        const mid = horizontal ? ob.y + ob.height / 2 : ob.x + ob.width / 2;
+        const lo = horizontal ? tb.y + tb.height * 0.2 : tb.x + tb.width * 0.2, hi = horizontal ? tb.y + tb.height * 0.8 : tb.x + tb.width * 0.8;
+        const along = horizontal ? Math.min(ob.x + ob.width, tb.x + tb.width) - Math.max(ob.x, tb.x) : Math.min(ob.y + ob.height, tb.y + tb.height) - Math.max(ob.y, tb.y);
+        if (mid < lo || mid > hi || along < 0.3 * (horizontal ? tb.width : tb.height)) continue;
+      } else if (covered < 0.1) continue;
+      const word = kind === "image" || kind === "video" ? kind : "shape";
+      issues.push(`text layer "${t.path}" and ${word} layer "${o.path}" overlap: it covers ${Math.round(covered * 100)}% of the text (drawn ${over ? "over" : "under"} it)`);
+    }
+  }
   const mode = opts.layers ?? "all";
   const listed = mode === "none" ? [] : mode === "visible" ? layers.filter((l) => l.visible) : layers;
   return { frame, time, canvas, summary: { layers: layers.length, visible: layers.filter((l) => l.visible).length }, issues, layers: listed };
@@ -2031,7 +2105,7 @@ var round = (n) => Math.round(n * 1e6) / 1e6;
 var family = (name) => name.replace(/\d+/g, "#");
 function detailOf(seq) {
   const s = seq.spec;
-  const spans = chunkLEECUCTG_cjs.spansMeta.get(seq.spec)?.preview;
+  const spans = chunkKJSEQVBV_cjs.spansMeta.get(seq.spec)?.preview;
   if (spans) return spans.length > 60 ? spans.slice(0, 57) + "\u2026" : spans;
   if (typeof s.text === "string") return s.text.length > 60 ? s.text.slice(0, 57) + "\u2026" : s.text;
   if (typeof s.asset === "string") return `asset \u201C${s.asset}\u201D`;
@@ -2047,10 +2121,10 @@ function walk(comp, parentStart, parentEnd, depth, prefix, rows, transitions, lo
     const start = parentStart + (seq.at ?? 0);
     const end = Math.min(parentEnd, seq.duration !== void 0 ? start + seq.duration : parentEnd);
     const span = end - start;
-    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkLEECUCTG_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
+    const keys = (seq.spec.keyframes ?? []).map((kf) => round(start + chunkKJSEQVBV_cjs.resolveAt(kf.at, span))).sort((a, b) => a - b).slice(0, MAX_KEYS);
     const row = { path: prefix + name, name, type: seq.spec.type, depth, start: round(start), end: round(end), keys, detail: detailOf(seq), ...local ? { local } : {} };
     const inner = [];
-    const isComp = seq instanceof chunk5IJENZOG_cjs.CompositionSequence;
+    const isComp = seq instanceof chunkY5UWFH6Y_cjs.CompositionSequence;
     if (isComp) {
       const label = seq.remapLabel();
       walk(seq, label ? 0 : start, label ? seq.contentSpan : end, depth + 1, prefix + name + "/", inner, transitions, label ? `${name} ${label}` : local);
@@ -2209,7 +2283,7 @@ function sheetLayout(n, columns, cellW, srcW, srcH, labelH) {
 }
 
 // src/core/vars.ts
-var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunkLEECUCTG_cjs.EXPRESSION_NAMES];
+var RESERVED_NAMES = ["w", "h", "W", "H", "GW", "GH", "t", "d", "T", "contain", "cover", "value", ...chunkKJSEQVBV_cjs.EXPRESSION_NAMES];
 var NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var isPlain = (v) => !!v && typeof v === "object" && (Object.getPrototypeOf(v) === Object.prototype || Object.getPrototypeOf(v) === null);
 function normalizeVars(raw, where, warn = (m) => console.warn(m)) {
@@ -2748,8 +2822,8 @@ var Movie = class {
       this.stops = normalizeStops(applyVars(options.composition, this._vars)?.stops, this.duration, this.frameRate);
       this._posterFrame = poster.frame;
       this.background = options.background ?? "#000000";
-      this.timeline = chunkLEECUCTG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkLEECUCTG_cjs.lengthen(this.timeline, this.duration);
+      this.timeline = chunkKJSEQVBV_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkKJSEQVBV_cjs.lengthen(this.timeline, this.duration);
       const baseAppOptions = {
         width: this.width,
         height: this.height,
@@ -2843,8 +2917,8 @@ var Movie = class {
       height: sizeWins ? height : spec.height ?? height,
       duration: spec.duration ?? this.duration
     } : void 0;
-    await chunkLEECUCTG_cjs.ensureFilterLibrary(seededComposition);
-    if (chunkIMQJVRMT_cjs.usesAdvancedBlend(seededComposition)) await chunkIMQJVRMT_cjs.enableAdvancedBlend(this.app.renderer);
+    await chunkKJSEQVBV_cjs.ensureFilterLibrary(seededComposition);
+    if (chunkNEUPEENI_cjs.usesAdvancedBlend(seededComposition)) await chunkNEUPEENI_cjs.enableAdvancedBlend(this.app.renderer);
     const userComposition = seededComposition ? expandTransitions(seededComposition) : void 0;
     const rootSeqSpec = {
       type: "composition",
@@ -2854,7 +2928,7 @@ var Movie = class {
       ...userComposition
     };
     if (userComposition) carryTransitionWindows(userComposition, rootSeqSpec);
-    const sequence = new chunk5IJENZOG_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
+    const sequence = new chunkY5UWFH6Y_cjs.CompositionSequence(rootSeqSpec, null, rootShape);
     lp?.begin("build", countLayers(rootSeqSpec));
     try {
       await sequence.build();
@@ -2990,8 +3064,8 @@ var Movie = class {
       if (!changed) return { reason, ms: 0, audio: "none", frame: this.currentFrame, playing: this.isPlaying, unchanged: true };
       sequence = await this._construct(composition, vars, width, height, void 0, this._resized || sizeChanged);
       alive();
-      const timeline = chunkLEECUCTG_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
-      chunkLEECUCTG_cjs.lengthen(timeline, this.duration);
+      const timeline = chunkKJSEQVBV_cjs.createTimeline({ paused: true, defaults: { ease: "none" } });
+      chunkKJSEQVBV_cjs.lengthen(timeline, this.duration);
       sequence.bindTimeline(timeline);
       const hadSound = this.audioBuffer !== null;
       const audio = await this._mixSound(sequence, this._ensureAudioContext());
@@ -3705,7 +3779,7 @@ function countLayers(spec) {
     n += 1 + countLayers(s);
     const spans = s.spans;
     if (Array.isArray(spans)) n += spans.length;
-    const src = chunk5IJENZOG_cjs.maskSourceOf(mask);
+    const src = chunkY5UWFH6Y_cjs.maskSourceOf(mask);
     if (src.kind === "inline") n += 1 + countLayers(src.spec);
   }
   return n;
@@ -3718,7 +3792,7 @@ function measureText(text, style = {}) {
   return { width: m.width, height: m.height, lines: text.split("\n").length };
 }
 function splitText(text, style = {}, opts = {}) {
-  chunkTWZNOUM7_cjs.warnUnknownOptions("splitText()", opts, ["by", "x", "y", "align"]);
+  chunkTWZNOUM7_cjs.warnUnknownOptions("splitText()", opts, ["by", "x", "y", "align", "vertical"]);
   let by = opts.by ?? "chars";
   if (!BY.includes(by)) {
     const g = chunkTWZNOUM7_cjs.suggestName(String(by), BY);
@@ -3737,6 +3811,7 @@ function splitText(text, style = {}, opts = {}) {
   }
   if (text === "") return [];
   const ts = new pixi_js.TextStyle(style);
+  if (opts.vertical) return splitVertical(text, style, ts, x0, y0, align, by);
   const lineHeight = pixi_js.CanvasTextMetrics.measureText("M", ts).lineHeight ?? pixi_js.CanvasTextMetrics.measureText("M", ts).height;
   const sentinel = widthOf("|", ts);
   const out = [];
@@ -3760,11 +3835,41 @@ function splitText(text, style = {}, opts = {}) {
   });
   return out;
 }
+var PUNCT = new Set("\u3001\u3002\uFF0C\uFF0E\uFF64\uFF61");
+var SMALL = new Set("\u3041\u3043\u3045\u3047\u3049\u3063\u3083\u3085\u3087\u308E\u30A1\u30A3\u30A5\u30A7\u30A9\u30C3\u30E3\u30E5\u30E7\u30EE\u30F5\u30F6");
+var TURNED = new Set("\u30FC\u2015\u2014\uFF0D\uFF5E\u301C\u2026\u2025\uFF08\uFF09()\uFF3B\uFF3D[]\uFF5B\uFF5D{}\u300C\u300D\u300E\u300F\u3008\u3009\u300A\u300B\u3010\u3011\u3014\u3015<>\u226A\u226B");
+function splitVertical(text, style, ts, right, top, align, by) {
+  if (by !== "chars") console.warn(`pixi-effects: splitText(): vertical text has only a "chars" form (by "${by}" has no vertical layout); using "chars"`);
+  const em = typeof style.fontSize === "number" ? style.fontSize : Number(ts.fontSize) || 26;
+  const spacing = typeof style.letterSpacing === "number" ? style.letterSpacing : 0;
+  const cell = em + spacing;
+  const lineHeight = pixi_js.CanvasTextMetrics.measureText("M", ts).lineHeight ?? pixi_js.CanvasTextMetrics.measureText("M", ts).height;
+  const out = [];
+  text.split("\n").forEach((line, lineNo) => {
+    const chars = Array.from(line);
+    const start = align === "center" ? top - chars.length * cell / 2 : align === "right" ? top - chars.length * cell : top;
+    const column = right - lineHeight / 2 - lineNo * lineHeight;
+    chars.forEach((ch, i) => {
+      if (/\s/.test(ch)) return;
+      let cx = column, cy = start + i * cell + cell / 2;
+      if (PUNCT.has(ch)) {
+        cx += 0.5 * em;
+        cy -= 0.5 * em;
+      } else if (SMALL.has(ch)) {
+        cx += 0.1 * em;
+        cy -= 0.1 * em;
+      }
+      const width = widthOf(ch, ts);
+      out.push({ text: ch, x: cx - width / 2, y: cy - lineHeight / 2, width, index: out.length, line: lineNo, cx, cy, rotation: TURNED.has(ch) ? 90 : 0 });
+    });
+  });
+  return out;
+}
 
 // src/presets/_ease.ts
 function parseEase2(name) {
-  chunkLEECUCTG_cjs.checkEase(name, "a preset");
-  return chunkLEECUCTG_cjs.parseEase(name);
+  chunkKJSEQVBV_cjs.checkEase(name, "a preset");
+  return chunkKJSEQVBV_cjs.parseEase(name);
 }
 
 // src/presets/kenBurns.ts
@@ -3899,17 +4004,17 @@ function orbit(opts) {
     throw new Error("pixi-effects: orbit() cannot combine `radius` with `dollyZoom` \u2014 the radius follows the animated fov");
   }
   const [cx, cy] = opts.center ?? [width / 2, height / 2];
-  const fixedR = opts.radius ?? chunkLEECUCTG_cjs.homeDistance(height, fov ?? chunkLEECUCTG_cjs.DEFAULT_FOV);
+  const fixedR = opts.radius ?? chunkKJSEQVBV_cjs.homeDistance(height, fov ?? chunkKJSEQVBV_cjs.DEFAULT_FOV);
   const start = opts.start ?? -degrees / 2;
   const steps = Math.max(1, Math.round(duration * stepsPerSecond));
   const easeFn = parseEase2(ease);
   const dollyEase = dolly ? parseEase2(dolly.ease ?? ease) : null;
   const pos = (i) => {
     const p = i / steps;
-    const a = (start + degrees * easeFn(p)) * chunkLEECUCTG_cjs.DEG;
+    const a = (start + degrees * easeFn(p)) * chunkKJSEQVBV_cjs.DEG;
     if (!dolly) return { x: cx + fixedR * Math.sin(a), z: fixedR * Math.cos(a) };
     const f = dolly.from + (dolly.to - dolly.from) * dollyEase(p);
-    const R = chunkLEECUCTG_cjs.homeDistance(height, f);
+    const R = chunkKJSEQVBV_cjs.homeDistance(height, f);
     return { x: cx + R * Math.sin(a), z: R * Math.cos(a), fov: f };
   };
   const keyframes = [];
@@ -3964,7 +4069,7 @@ function particles(opts) {
   const round2 = (v) => Math.round(v * 1e6) / 1e6;
   const out = [];
   for (let i = 0; i < count; i++) {
-    const r = chunkLEECUCTG_cjs.random(seed * 1000003 + i * 7919 + 17);
+    const r = chunkKJSEQVBV_cjs.random(seed * 1000003 + i * 7919 + 17);
     const pick = ([a2, b]) => a2 + r() * (b - a2);
     const born = at + r() * emit;
     const lifetime = pick(life);
@@ -3977,7 +4082,7 @@ function particles(opts) {
     const turn = spin ? pick(spin) : 0;
     const startAngle = spin ? r() * 360 : 0;
     const swayAmp = sway?.amp ?? 0, swayFreq = sway?.freq ?? 1;
-    const n0 = sway ? chunkLEECUCTG_cjs.noise(0, seed * 1000003 + i) : 0;
+    const n0 = sway ? chunkKJSEQVBV_cjs.noise(0, seed * 1000003 + i) : 0;
     const at_ = (t) => {
       const axis = (p0, v0, acc) => {
         if (drag > 0) {
@@ -3986,7 +4091,7 @@ function particles(opts) {
         }
         return p0 + v0 * t + 0.5 * acc * t * t;
       };
-      const sw = sway ? swayAmp * (chunkLEECUCTG_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
+      const sw = sway ? swayAmp * (chunkKJSEQVBV_cjs.noise(t * swayFreq, seed * 1000003 + i) - n0) : 0;
       return { x: axis(x0, vx, wind) + sw, y: axis(y0, vy, gravity) };
     };
     const kfs = [];
@@ -4048,7 +4153,7 @@ function followPath(opts) {
   if (steps > MAX_STEPS) throw new Error(`followPath(): ${steps} samples is too many (max ${MAX_STEPS}); lower frameRate or duration`);
   const segments = [];
   let total = 0;
-  for (const line of chunkLEECUCTG_cjs.flattenSvgPath(d)) {
+  for (const line of chunkKJSEQVBV_cjs.flattenSvgPath(d)) {
     const p = line.closed ? [...line.pts, line.pts[0], line.pts[1]] : line.pts;
     for (let i = 2; i < p.length; i += 2) {
       const len = Math.hypot(p[i] - p[i - 2], p[i + 1] - p[i - 1]);
@@ -4202,7 +4307,7 @@ function distances(n, from, grid, seed) {
   if (n === 0) return [];
   if (from === "random") {
     const order = Array.from({ length: n }, (_, i) => i);
-    const r = chunkLEECUCTG_cjs.random(seed);
+    const r = chunkKJSEQVBV_cjs.random(seed);
     for (let i = n - 1; i > 0; i--) {
       const j = Math.floor(r() * (i + 1));
       [order[i], order[j]] = [order[j], order[i]];
@@ -4264,7 +4369,7 @@ function wiggle(opts) {
         to[n] = p.around;
         return;
       }
-      const off = (chunkLEECUCTG_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
+      const off = (chunkKJSEQVBV_cjs.rand(seed * 7919 + pi * 104729 + s * 31 + 1) * 2 - 1) * p.amp;
       to[n] = typeof p.around === "number" ? p.around + off : `(${p.around}) ${off < 0 ? "-" : "+"} ${Math.abs(off)}`;
     });
     out.push({ at: at + s * stepLen, to, duration: stepLen, ease });
@@ -4275,7 +4380,7 @@ function wiggle(opts) {
 // src/presets/animateText.ts
 var TWEEN_KEYS = ["preset", "from", "to", "duration", "ease"];
 var TIME_KEYS = ["at", "delay", "start", "begin", "time"];
-var KEYS5 = ["by", "x", "y", "align", "name", "at", "duration", "in", "out", "stagger", "idle", "styleFor"];
+var KEYS5 = ["by", "x", "y", "align", "vertical", "name", "at", "duration", "in", "out", "stagger", "idle", "styleFor"];
 var PRESETS = {
   rise: { from: { y: 40, alpha: 0 }, duration: 0.5, ease: "back.out(2)" },
   drop: { from: { y: -50, alpha: 0 }, duration: 0.7, ease: "bounce.out" },
@@ -4288,14 +4393,14 @@ var PRESETS = {
 var PRESET_NAMES = Object.keys(PRESETS);
 function animateText(text, style, options) {
   chunkTWZNOUM7_cjs.warnUnknownOptions("animateText()", options, KEYS5);
-  const { by = "chars", x = 0, y = 0, align = "left", name = "text", at = 0, duration, idle, styleFor } = options;
+  const { by = "chars", x = 0, y = 0, align = "left", vertical = false, name = "text", at = 0, duration, idle, styleFor } = options;
   for (const [n, v] of [["x", x], ["y", y]]) {
     if (typeof v !== "number" || !Number.isFinite(v)) {
       throw new Error(`animateText(): ${n} must be a number of pixels (e.g. ${n}: 640), got ${JSON.stringify(v)}. The letters are measured once, when the layers are made, so an expression such as 'GW/2' cannot be used here: compute the number (W / 2) yourself. \`y\` is the TOP of the line.`);
     }
   }
   if (!(Number.isFinite(duration) && duration > 0)) throw new Error(`animateText(): duration must be a positive number of seconds (how long until the last piece is gone), got ${duration}`);
-  const pieces = splitText(text, style, { by, x, y, align });
+  const pieces = splitText(text, style, { by, x, y, align, ...vertical ? { vertical } : {} });
   if (pieces.length === 0) return [];
   const lineHeight = measureText("M", style).height;
   const inTween = options.in === false ? null : resolveTween(options.in ?? "rise", "in");
@@ -4314,12 +4419,12 @@ function animateText(text, style, options) {
     if (inTween && outTween.at - at < inTween.duration - 1e-9) console.warn(`pixi-effects: animateText(): out.at ${outTween.at} is before the entrance has finished (it takes ${inTween.duration} s from at ${at}): use out.at \u2265 ${+(at + inTween.duration).toFixed(3)}`);
   }
   return pieces.map((p, i) => {
-    const cx = p.x + p.width / 2, cy = p.y + lineHeight / 2;
-    const rest = { x: cx, y: cy, alpha: 1, scale: 1, scaleX: 1, scaleY: 1, rotation: 0 };
+    const cx = p.cx ?? p.x + p.width / 2, cy = p.cy ?? p.y + lineHeight / 2;
+    const rest = { x: cx, y: cy, alpha: 1, scale: 1, scaleX: 1, scaleY: 1, rotation: p.rotation ?? 0 };
     const start = at + delays[i];
     const len = end - start;
     const keyframes = [];
-    const place = (key, v) => key === "x" || key === "y" ? rest[key] + v : v;
+    const place = (key, v) => key === "x" || key === "y" || key === "rotation" ? rest[key] + v : v;
     if (inTween) {
       keyframes.push({
         at: 0,
@@ -4358,7 +4463,7 @@ function animateText(text, style, options) {
       style: styleFor ? { ...style, ...styleFor(p) } : style,
       at: start,
       duration: len,
-      initial: { x: cx, y: cy, anchorX: 0.5, anchorY: 0.5 },
+      initial: { x: cx, y: cy, anchorX: 0.5, anchorY: 0.5, ...rest.rotation !== 0 ? { rotation: rest.rotation } : {} },
       keyframes
     };
   });
@@ -4722,5 +4827,5 @@ exports.splitText = splitText;
 exports.stagger = stagger;
 exports.wiggle = wiggle;
 exports.withFade = withFade;
-//# sourceMappingURL=chunk-7TTCPHAV.cjs.map
-//# sourceMappingURL=chunk-7TTCPHAV.cjs.map
+//# sourceMappingURL=chunk-CC7SUR7Q.cjs.map
+//# sourceMappingURL=chunk-CC7SUR7Q.cjs.map