pixi-effects 0.34.0 → 0.36.0

package/dist/{chunk-IMQJVRMT.cjs → chunk-NEUPEENI.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGL2AQFLQ_cjs = require('./chunk-GL2AQFLQ.cjs');
+var chunk42ML5AKN_cjs = require('./chunk-42ML5AKN.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 
 // src/core/blend.ts
@@ -40,7 +40,7 @@ function usesAdvancedBlend(spec) {
   };
   return visit(spec);
 }
-var sayNow = (message, spec) => console.warn(`pixi-effects: ${chunkGL2AQFLQ_cjs.describeLayer(spec)}: ${message}`);
+var sayNow = (message, spec) => console.warn(`pixi-effects: ${chunk42ML5AKN_cjs.describeLayer(spec)}: ${message}`);
 function blendUnavailableMessage(mode) {
   return `blendMode "${mode}" could not be set up (the blend filters are not registered); the layer is drawn normal`;
 }
@@ -85,7 +85,7 @@ function blendFilterFor(mode) {
 }
 async function enableAdvancedBlend(renderer) {
   try {
-    const { registerBlendModes } = await import('./blendModes-WIUCYIMC.cjs');
+    const { registerBlendModes } = await import('./blendModes-KU7XLV7U.cjs');
     registerBlendModes();
   } catch (e) {
     const why = e instanceof Error ? e.message : String(e);
@@ -137,5 +137,5 @@ exports.isAdvancedBlend = isAdvancedBlend;
 exports.maxConcurrentAdvanced = maxConcurrentAdvanced;
 exports.setBlendFilterFactory = setBlendFilterFactory;
 exports.usesAdvancedBlend = usesAdvancedBlend;
-//# sourceMappingURL=chunk-IMQJVRMT.cjs.map
-//# sourceMappingURL=chunk-IMQJVRMT.cjs.map
+//# sourceMappingURL=chunk-NEUPEENI.cjs.map
+//# sourceMappingURL=chunk-NEUPEENI.cjs.map

package/dist/{chunk-IMQJVRMT.cjs.map → chunk-NEUPEENI.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/blend.ts"],"names":["suggestName","describeLayer"],"mappings":"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","file":"chunk-IMQJVRMT.cjs","sourcesContent":["import { describeLayer } from './lint';\nimport { suggestName } from './options';\n\n/** The modes Pixi draws itself (`add`, `screen`, `multiply`) and `normal`. */\nexport const BASIC_BLEND_MODES = ['normal', 'add', 'screen', 'multiply'] as const;\n/** The modes that need the backdrop: our own `BlendModeFilter`s (`src/filters/blendModes.ts`), loaded only when a movie uses one. */\nexport const ADVANCED_BLEND_MODES = [\n  'overlay', 'soft-light', 'hard-light', 'color-dodge', 'color-burn', 'darken', 'lighten', 'difference', 'exclusion',\n  'hue', 'saturation', 'color', 'luminosity', 'linear-burn',\n] as const;\n/** Every `blendMode` there is (the one table the warnings, the types and the docs check against). */\nexport const BLEND_MODES: readonly string[] = [...BASIC_BLEND_MODES, ...ADVANCED_BLEND_MODES];\n\nexport function isAdvancedBlend(mode: unknown): boolean {\n  return typeof mode === 'string' && (ADVANCED_BLEND_MODES as readonly string[]).includes(mode);\n}\n\n/** Why `mode` is not a blend mode, with the likely name and the choices; null when it is one. */\nexport function blendProblem(mode: unknown): string | null {\n  if (typeof mode === 'string' && BLEND_MODES.includes(mode)) return null;\n  const guess = typeof mode === 'string' ? suggestName(mode, BLEND_MODES) : null;\n  const shown = typeof mode === 'string' ? `\"${mode}\"` : String(mode);\n  return `blendMode ${shown} is not supported${guess ? `; did you mean \"${guess}\"?` : ''} (use ${BLEND_MODES.join(', ')})`;\n}\n\n/** Does any layer of this composition (or one nested in it, or a mask layer) use an advanced blend? */\nexport function usesAdvancedBlend(spec: unknown): boolean {\n  const visit = (n: unknown): boolean => {\n    if (!n || typeof n !== 'object') return false;\n    if (Array.isArray(n)) return n.some(visit);\n    const o = n as Record<string, unknown>;\n    return isAdvancedBlend(o.blendMode) || visit(o.sequences) || visit(o.mask) || visit(o.layer);       // (`layer`: a mask written as { layer: <spec>, invert })\n  };\n  return visit(spec);\n}\n\n/** What to say about a layer's blend mode: `Composition` collects these per build, so the same mistake in 300 particle layers is said once. */\nexport type BlendReport = (message: string, spec: { name?: string; type: string }) => void;\nconst sayNow: BlendReport = (message, spec) => console.warn(`pixi-effects: ${describeLayer(spec)}: ${message}`);\n\n/** The blend filters of an advanced mode were not registered (a movie registers them in `Movie.init`, or loading them failed): the layer is drawn normal. */\nexport function blendUnavailableMessage(mode: string): string {\n  return `blendMode \"${mode}\" could not be set up (the blend filters are not registered); the layer is drawn normal`;\n}\n\n/**\n * Apply a layer's `blendMode` to its display object; an unknown mode, or an advanced mode while the blend filters are not registered, says so\n * and the layer is drawn normal. Returns the blend filter it added to the layer's filter chain (the caller destroys it with the layer), if any.\n */\nexport function applyBlendMode(\n  spec: { blendMode?: string; name?: string; type: string },\n  display: { blendMode?: unknown; filters?: unknown },\n  report: BlendReport = sayNow,\n): BlendFilterLike | null {\n  const mode = spec.blendMode;\n  if (mode === undefined) return null;\n  const problem = blendProblem(mode);\n  if (problem) { report(problem, spec); return null; }\n  if (isAdvancedBlend(mode) && !blendRegistered()) { report(blendUnavailableMessage(mode), spec); return null; }\n  // A container's blend mode applies INSIDE a filter's offscreen pass (against transparent black: multiply gave\n  // solid black) and not to the filtered result. With filters, the pass that draws onto the backdrop is the last\n  // filter's, so the mode goes there; the container stays normal.\n  const filters = display.filters;\n  if (Array.isArray(filters) && filters.length > 0) {\n    if (isAdvancedBlend(mode)) {\n      // an advanced mode is a filter of its own (it reads the backdrop): it joins the chain as the last pass\n      const blend = blendFilterFor(mode);\n      if (!blend) { report(blendUnavailableMessage(mode), spec); return null; }\n      display.filters = [...filters, blend];\n      return blend;\n    }\n    (filters[filters.length - 1] as { blendMode?: unknown }).blendMode = mode;\n    return null;\n  }\n  display.blendMode = mode;\n  return null;\n}\n\n/** What blend.ts needs of a blend filter (the real ones are Pixi filters; tests use plain objects). */\nexport type BlendFilterLike = { blendMode?: unknown; destroy(): void };\nlet factory: ((mode: string) => BlendFilterLike | null) | null = null;\n\n/** `filters/blendModes.ts` hands its filter maker here when it registers, so this file never imports Pixi. */\nexport function setBlendFilterFactory(f: ((mode: string) => BlendFilterLike | null) | null): void {\n  factory = f;\n}\n\n/** Are the blend filters registered (a movie that uses an advanced mode registers them in `Movie.init`)? */\nexport function blendRegistered(): boolean {\n  return factory !== null;\n}\n\n/** A fresh blend filter for an advanced mode, or null when the blends are not registered (or the mode is not an advanced one). */\nexport function blendFilterFor(mode: string): BlendFilterLike | null {\n  return isAdvancedBlend(mode) && factory ? factory(mode) : null;\n}\n\n/**\n * Called by `Movie.init` when a layer uses an advanced mode, and only then: loads our blend filters (a separate chunk), registers them on\n * the pixi the movie runs on, and on WebGL turns the back buffer on (an advanced blend reads what is already drawn; WebGPU copies the\n * backdrop by itself, and has no such switch). A movie that uses none never reaches this, so nothing about it changes.\n */\nexport async function enableAdvancedBlend(renderer: unknown): Promise<void> {\n  try {\n    const { registerBlendModes } = await import('../filters/blendModes');\n    registerBlendModes();\n  } catch (e) {\n    // a page that serves dist/index.js without its chunk, a CDN hiccup: the movie still plays, its advanced blends drawn normal\n    const why = e instanceof Error ? e.message : String(e);\n    console.warn(`pixi-effects: the blend filters could not be loaded (${why}); layers with an advanced blendMode are drawn normal. Serve the whole dist/ folder (the filters are the blendModes-*.js file next to index.js)`);\n    return;\n  }\n  const bb = (renderer as { backBuffer?: { useBackBuffer: boolean } }).backBuffer;\n  if (bb) bb.useBackBuffer = true;\n}\n\n/** This many layers with an advanced blend on screen at once is slow: each is a full-frame pass (measured on WebGL: about 1.5–2 ms each at 1080p). */\nexport const MANY_ADVANCED = 10;\n\ntype Counted = { at?: number; duration?: number; blendMode?: unknown; type?: string; sequences?: unknown };\n\n/** The layers a composition draws (its children each blend one by one when it has a mode): null, camera and audio layers draw nothing; nested compositions are walked. */\nfunction drawnLeaves(sequences: unknown): number {\n  if (!Array.isArray(sequences)) return 0;\n  let n = 0;\n  for (const s of sequences as Counted[]) {\n    if (!s || s.type === 'null' || s.type === 'camera' || s.type === 'audio') continue;\n    n += s.type === 'composition' ? drawnLeaves(s.sequences) : 1;\n  }\n  return n;\n}\n\n/**\n * The full-frame passes one layer costs while it is on screen: 1 for a layer with an advanced mode; for a composition with one, one for each\n * drawn layer inside it (its children inherit the mode and blend one by one); for a composition without, the most that its own layers add\n * at one instant (a card with three blends in it, on screen with four other cards, is twelve).\n */\nfunction passesOf(l: Counted, span: number): number {\n  const isComposition = l.type === 'composition';\n  if (isAdvancedBlend(l.blendMode)) return isComposition ? Math.max(1, drawnLeaves(l.sequences)) : 1;\n  return isComposition && Array.isArray(l.sequences) ? maxConcurrentAdvanced(l.sequences as Counted[], l.duration ?? span) : 0;\n}\n\n/** The most full-frame advanced-blend passes on screen at one instant, from the layers' `at` and `duration` (a layer with no duration lasts to the end). */\nexport function maxConcurrentAdvanced(layers: ReadonlyArray<Counted>, span: number): number {\n  const events: Array<[number, number]> = [];\n  for (const l of layers) {\n    const w = passesOf(l, span);\n    if (w === 0) continue;\n    const at = l.at ?? 0;\n    const end = l.duration === undefined ? span : at + l.duration;\n    const start = Math.max(0, at);                                     // a negative `at` starts before the composition: only what is after 0 is on screen\n    if (end > start) events.push([start, w], [end, -w]);\n  }\n  events.sort((a, b) => a[0] - b[0] || a[1] - b[1]);                  // at one instant, the layers that end go before the ones that start\n  let now = 0, most = 0;\n  for (const [, d] of events) { now += d; most = Math.max(most, now); }\n  return most;\n}\n"]}
+{"version":3,"sources":["../src/core/blend.ts"],"names":["suggestName","describeLayer"],"mappings":";;;;;;AAIO,IAAM,iBAAA,GAAoB,CAAC,QAAA,EAAU,KAAA,EAAO,UAAU,UAAU,CAAA;AAEhE,IAAM,oBAAA,GAAuB;AAAA,EAClC,SAAA;AAAA,EAAW,YAAA;AAAA,EAAc,YAAA;AAAA,EAAc,aAAA;AAAA,EAAe,YAAA;AAAA,EAAc,QAAA;AAAA,EAAU,SAAA;AAAA,EAAW,YAAA;AAAA,EAAc,WAAA;AAAA,EACvG,KAAA;AAAA,EAAO,YAAA;AAAA,EAAc,OAAA;AAAA,EAAS,YAAA;AAAA,EAAc;AAC9C,CAAA;AAEO,IAAM,WAAA,GAAiC,CAAC,GAAG,iBAAA,EAAmB,GAAG,oBAAoB,CAAA;AAErF,SAAS,gBAAgB,IAAA,EAAwB;AACtD,EAAA,OAAO,OAAO,IAAA,KAAS,QAAA,IAAa,oBAAA,CAA2C,SAAS,IAAI,CAAA;AAC9F;AAGO,SAAS,aAAa,IAAA,EAA8B;AACzD,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,YAAY,QAAA,CAAS,IAAI,GAAG,OAAO,IAAA;AACnE,EAAA,MAAM,QAAQ,OAAO,IAAA,KAAS,WAAWA,6BAAA,CAAY,IAAA,EAAM,WAAW,CAAA,GAAI,IAAA;AAC1E,EAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,KAAS,QAAA,GAAW,IAAI,IAAI,CAAA,CAAA,CAAA,GAAM,OAAO,IAAI,CAAA;AAClE,EAAA,OAAO,CAAA,UAAA,EAAa,KAAK,CAAA,iBAAA,EAAoB,KAAA,GAAQ,CAAA,gBAAA,EAAmB,KAAK,CAAA,EAAA,CAAA,GAAO,EAAE,CAAA,MAAA,EAAS,WAAA,CAAY,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAA;AACvH;AAGO,SAAS,kBAAkB,IAAA,EAAwB;AACxD,EAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,KAAwB;AACrC,IAAA,IAAI,CAAC,CAAA,IAAK,OAAO,CAAA,KAAM,UAAU,OAAO,KAAA;AACxC,IAAA,IAAI,MAAM,OAAA,CAAQ,CAAC,GAAG,OAAO,CAAA,CAAE,KAAK,KAAK,CAAA;AACzC,IAAA,MAAM,CAAA,GAAI,CAAA;AACV,IAAA,OAAO,eAAA,CAAgB,CAAA,CAAE,SAAS,CAAA,IAAK,MAAM,CAAA,CAAE,SAAS,CAAA,IAAK,KAAA,CAAM,CAAA,CAAE,IAAI,CAAA,IAAK,KAAA,CAAM,EAAE,KAAK,CAAA;AAAA,EAC7F,CAAA;AACA,EAAA,OAAO,MAAM,IAAI,CAAA;AACnB;AAIA,IAAM,MAAA,GAAsB,CAAC,OAAA,EAAS,IAAA,KAAS,OAAA,CAAQ,IAAA,CAAK,CAAA,cAAA,EAAiBC,+BAAA,CAAc,IAAI,CAAC,CAAA,EAAA,EAAK,OAAO,CAAA,CAAE,CAAA;AAGvG,SAAS,wBAAwB,IAAA,EAAsB;AAC5D,EAAA,OAAO,cAAc,IAAI,CAAA,uFAAA,CAAA;AAC3B;AAMO,SAAS,cAAA,CACd,IAAA,EACA,OAAA,EACA,MAAA,GAAsB,MAAA,EACE;AACxB,EAAA,MAAM,OAAO,IAAA,CAAK,SAAA;AAClB,EAAA,IAAI,IAAA,KAAS,QAAW,OAAO,IAAA;AAC/B,EAAA,MAAM,OAAA,GAAU,aAAa,IAAI,CAAA;AACjC,EAAA,IAAI,OAAA,EAAS;AAAE,IAAA,MAAA,CAAO,SAAS,IAAI,CAAA;AAAG,IAAA,OAAO,IAAA;AAAA,EAAM;AACnD,EAAA,IAAI,eAAA,CAAgB,IAAI,CAAA,IAAK,CAAC,iBAAgB,EAAG;AAAE,IAAA,MAAA,CAAO,uBAAA,CAAwB,IAAI,CAAA,EAAG,IAAI,CAAA;AAAG,IAAA,OAAO,IAAA;AAAA,EAAM;AAI7G,EAAA,MAAM,UAAU,OAAA,CAAQ,OAAA;AACxB,EAAA,IAAI,MAAM,OAAA,CAAQ,OAAO,CAAA,IAAK,OAAA,CAAQ,SAAS,CAAA,EAAG;AAChD,IAAA,IAAI,eAAA,CAAgB,IAAI,CAAA,EAAG;AAEzB,MAAA,MAAM,KAAA,GAAQ,eAAe,IAAI,CAAA;AACjC,MAAA,IAAI,CAAC,KAAA,EAAO;AAAE,QAAA,MAAA,CAAO,uBAAA,CAAwB,IAAI,CAAA,EAAG,IAAI,CAAA;AAAG,QAAA,OAAO,IAAA;AAAA,MAAM;AACxE,MAAA,OAAA,CAAQ,OAAA,GAAU,CAAC,GAAG,OAAA,EAAS,KAAK,CAAA;AACpC,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAC,OAAA,CAAQ,OAAA,CAAQ,MAAA,GAAS,CAAC,EAA8B,SAAA,GAAY,IAAA;AACrE,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAA,CAAQ,SAAA,GAAY,IAAA;AACpB,EAAA,OAAO,IAAA;AACT;AAIA,IAAI,OAAA,GAA6D,IAAA;AAG1D,SAAS,sBAAsB,CAAA,EAA4D;AAChG,EAAA,OAAA,GAAU,CAAA;AACZ;AAGO,SAAS,eAAA,GAA2B;AACzC,EAAA,OAAO,OAAA,KAAY,IAAA;AACrB;AAGO,SAAS,eAAe,IAAA,EAAsC;AACnE,EAAA,OAAO,gBAAgB,IAAI,CAAA,IAAK,OAAA,GAAU,OAAA,CAAQ,IAAI,CAAA,GAAI,IAAA;AAC5D;AAOA,eAAsB,oBAAoB,QAAA,EAAkC;AAC1E,EAAA,IAAI;AACF,IAAA,MAAM,EAAE,kBAAA,EAAmB,GAAI,MAAM,OAAO,2BAAuB,CAAA;AACnE,IAAA,kBAAA,EAAmB;AAAA,EACrB,SAAS,CAAA,EAAG;AAEV,IAAA,MAAM,MAAM,CAAA,YAAa,KAAA,GAAQ,CAAA,CAAE,OAAA,GAAU,OAAO,CAAC,CAAA;AACrD,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,qDAAA,EAAwD,GAAG,CAAA,+IAAA,CAAiJ,CAAA;AACzN,IAAA;AAAA,EACF;AACA,EAAA,MAAM,KAAM,QAAA,CAAyD,UAAA;AACrE,EAAA,IAAI,EAAA,KAAO,aAAA,GAAgB,IAAA;AAC7B;AAGO,IAAM,aAAA,GAAgB;AAK7B,SAAS,YAAY,SAAA,EAA4B;AAC/C,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,SAAS,GAAG,OAAO,CAAA;AACtC,EAAA,IAAI,CAAA,GAAI,CAAA;AACR,EAAA,KAAA,MAAW,KAAK,SAAA,EAAwB;AACtC,IAAA,IAAI,CAAC,CAAA,IAAK,CAAA,CAAE,IAAA,KAAS,MAAA,IAAU,EAAE,IAAA,KAAS,QAAA,IAAY,CAAA,CAAE,IAAA,KAAS,OAAA,EAAS;AAC1E,IAAA,CAAA,IAAK,EAAE,IAAA,KAAS,aAAA,GAAgB,WAAA,CAAY,CAAA,CAAE,SAAS,CAAA,GAAI,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,CAAA;AACT;AAOA,SAAS,QAAA,CAAS,GAAY,IAAA,EAAsB;AAClD,EAAA,MAAM,aAAA,GAAgB,EAAE,IAAA,KAAS,aAAA;AACjC,EAAA,IAAI,eAAA,CAAgB,CAAA,CAAE,SAAS,CAAA,EAAG,OAAO,aAAA,GAAgB,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,WAAA,CAAY,CAAA,CAAE,SAAS,CAAC,CAAA,GAAI,CAAA;AACjG,EAAA,OAAO,aAAA,IAAiB,KAAA,CAAM,OAAA,CAAQ,CAAA,CAAE,SAAS,CAAA,GAAI,qBAAA,CAAsB,CAAA,CAAE,SAAA,EAAwB,CAAA,CAAE,QAAA,IAAY,IAAI,CAAA,GAAI,CAAA;AAC7H;AAGO,SAAS,qBAAA,CAAsB,QAAgC,IAAA,EAAsB;AAC1F,EAAA,MAAM,SAAkC,EAAC;AACzC,EAAA,KAAA,MAAW,KAAK,MAAA,EAAQ;AACtB,IAAA,MAAM,CAAA,GAAI,QAAA,CAAS,CAAA,EAAG,IAAI,CAAA;AAC1B,IAAA,IAAI,MAAM,CAAA,EAAG;AACb,IAAA,MAAM,EAAA,GAAK,EAAE,EAAA,IAAM,CAAA;AACnB,IAAA,MAAM,MAAM,CAAA,CAAE,QAAA,KAAa,MAAA,GAAY,IAAA,GAAO,KAAK,CAAA,CAAE,QAAA;AACrD,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,EAAE,CAAA;AAC5B,IAAA,IAAI,GAAA,GAAM,KAAA,EAAO,MAAA,CAAO,IAAA,CAAK,CAAC,KAAA,EAAO,CAAC,CAAA,EAAG,CAAC,GAAA,EAAK,CAAC,CAAC,CAAC,CAAA;AAAA,EACpD;AACA,EAAA,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,CAAC,CAAA,GAAI,CAAA,CAAE,CAAC,KAAK,CAAA,CAAE,CAAC,CAAA,GAAI,CAAA,CAAE,CAAC,CAAC,CAAA;AAChD,EAAA,IAAI,GAAA,GAAM,GAAG,IAAA,GAAO,CAAA;AACpB,EAAA,KAAA,MAAW,GAAG,CAAC,CAAA,IAAK,MAAA,EAAQ;AAAE,IAAA,GAAA,IAAO,CAAA;AAAG,IAAA,IAAA,GAAO,IAAA,CAAK,GAAA,CAAI,IAAA,EAAM,GAAG,CAAA;AAAA,EAAG;AACpE,EAAA,OAAO,IAAA;AACT","file":"chunk-NEUPEENI.cjs","sourcesContent":["import { describeLayer } from './lint';\nimport { suggestName } from './options';\n\n/** The modes Pixi draws itself (`add`, `screen`, `multiply`) and `normal`. */\nexport const BASIC_BLEND_MODES = ['normal', 'add', 'screen', 'multiply'] as const;\n/** The modes that need the backdrop: our own `BlendModeFilter`s (`src/filters/blendModes.ts`), loaded only when a movie uses one. */\nexport const ADVANCED_BLEND_MODES = [\n  'overlay', 'soft-light', 'hard-light', 'color-dodge', 'color-burn', 'darken', 'lighten', 'difference', 'exclusion',\n  'hue', 'saturation', 'color', 'luminosity', 'linear-burn',\n] as const;\n/** Every `blendMode` there is (the one table the warnings, the types and the docs check against). */\nexport const BLEND_MODES: readonly string[] = [...BASIC_BLEND_MODES, ...ADVANCED_BLEND_MODES];\n\nexport function isAdvancedBlend(mode: unknown): boolean {\n  return typeof mode === 'string' && (ADVANCED_BLEND_MODES as readonly string[]).includes(mode);\n}\n\n/** Why `mode` is not a blend mode, with the likely name and the choices; null when it is one. */\nexport function blendProblem(mode: unknown): string | null {\n  if (typeof mode === 'string' && BLEND_MODES.includes(mode)) return null;\n  const guess = typeof mode === 'string' ? suggestName(mode, BLEND_MODES) : null;\n  const shown = typeof mode === 'string' ? `\"${mode}\"` : String(mode);\n  return `blendMode ${shown} is not supported${guess ? `; did you mean \"${guess}\"?` : ''} (use ${BLEND_MODES.join(', ')})`;\n}\n\n/** Does any layer of this composition (or one nested in it, or a mask layer) use an advanced blend? */\nexport function usesAdvancedBlend(spec: unknown): boolean {\n  const visit = (n: unknown): boolean => {\n    if (!n || typeof n !== 'object') return false;\n    if (Array.isArray(n)) return n.some(visit);\n    const o = n as Record<string, unknown>;\n    return isAdvancedBlend(o.blendMode) || visit(o.sequences) || visit(o.mask) || visit(o.layer);       // (`layer`: a mask written as { layer: <spec>, invert })\n  };\n  return visit(spec);\n}\n\n/** What to say about a layer's blend mode: `Composition` collects these per build, so the same mistake in 300 particle layers is said once. */\nexport type BlendReport = (message: string, spec: { name?: string; type: string }) => void;\nconst sayNow: BlendReport = (message, spec) => console.warn(`pixi-effects: ${describeLayer(spec)}: ${message}`);\n\n/** The blend filters of an advanced mode were not registered (a movie registers them in `Movie.init`, or loading them failed): the layer is drawn normal. */\nexport function blendUnavailableMessage(mode: string): string {\n  return `blendMode \"${mode}\" could not be set up (the blend filters are not registered); the layer is drawn normal`;\n}\n\n/**\n * Apply a layer's `blendMode` to its display object; an unknown mode, or an advanced mode while the blend filters are not registered, says so\n * and the layer is drawn normal. Returns the blend filter it added to the layer's filter chain (the caller destroys it with the layer), if any.\n */\nexport function applyBlendMode(\n  spec: { blendMode?: string; name?: string; type: string },\n  display: { blendMode?: unknown; filters?: unknown },\n  report: BlendReport = sayNow,\n): BlendFilterLike | null {\n  const mode = spec.blendMode;\n  if (mode === undefined) return null;\n  const problem = blendProblem(mode);\n  if (problem) { report(problem, spec); return null; }\n  if (isAdvancedBlend(mode) && !blendRegistered()) { report(blendUnavailableMessage(mode), spec); return null; }\n  // A container's blend mode applies INSIDE a filter's offscreen pass (against transparent black: multiply gave\n  // solid black) and not to the filtered result. With filters, the pass that draws onto the backdrop is the last\n  // filter's, so the mode goes there; the container stays normal.\n  const filters = display.filters;\n  if (Array.isArray(filters) && filters.length > 0) {\n    if (isAdvancedBlend(mode)) {\n      // an advanced mode is a filter of its own (it reads the backdrop): it joins the chain as the last pass\n      const blend = blendFilterFor(mode);\n      if (!blend) { report(blendUnavailableMessage(mode), spec); return null; }\n      display.filters = [...filters, blend];\n      return blend;\n    }\n    (filters[filters.length - 1] as { blendMode?: unknown }).blendMode = mode;\n    return null;\n  }\n  display.blendMode = mode;\n  return null;\n}\n\n/** What blend.ts needs of a blend filter (the real ones are Pixi filters; tests use plain objects). */\nexport type BlendFilterLike = { blendMode?: unknown; destroy(): void };\nlet factory: ((mode: string) => BlendFilterLike | null) | null = null;\n\n/** `filters/blendModes.ts` hands its filter maker here when it registers, so this file never imports Pixi. */\nexport function setBlendFilterFactory(f: ((mode: string) => BlendFilterLike | null) | null): void {\n  factory = f;\n}\n\n/** Are the blend filters registered (a movie that uses an advanced mode registers them in `Movie.init`)? */\nexport function blendRegistered(): boolean {\n  return factory !== null;\n}\n\n/** A fresh blend filter for an advanced mode, or null when the blends are not registered (or the mode is not an advanced one). */\nexport function blendFilterFor(mode: string): BlendFilterLike | null {\n  return isAdvancedBlend(mode) && factory ? factory(mode) : null;\n}\n\n/**\n * Called by `Movie.init` when a layer uses an advanced mode, and only then: loads our blend filters (a separate chunk), registers them on\n * the pixi the movie runs on, and on WebGL turns the back buffer on (an advanced blend reads what is already drawn; WebGPU copies the\n * backdrop by itself, and has no such switch). A movie that uses none never reaches this, so nothing about it changes.\n */\nexport async function enableAdvancedBlend(renderer: unknown): Promise<void> {\n  try {\n    const { registerBlendModes } = await import('../filters/blendModes');\n    registerBlendModes();\n  } catch (e) {\n    // a page that serves dist/index.js without its chunk, a CDN hiccup: the movie still plays, its advanced blends drawn normal\n    const why = e instanceof Error ? e.message : String(e);\n    console.warn(`pixi-effects: the blend filters could not be loaded (${why}); layers with an advanced blendMode are drawn normal. Serve the whole dist/ folder (the filters are the blendModes-*.js file next to index.js)`);\n    return;\n  }\n  const bb = (renderer as { backBuffer?: { useBackBuffer: boolean } }).backBuffer;\n  if (bb) bb.useBackBuffer = true;\n}\n\n/** This many layers with an advanced blend on screen at once is slow: each is a full-frame pass (measured on WebGL: about 1.5–2 ms each at 1080p). */\nexport const MANY_ADVANCED = 10;\n\ntype Counted = { at?: number; duration?: number; blendMode?: unknown; type?: string; sequences?: unknown };\n\n/** The layers a composition draws (its children each blend one by one when it has a mode): null, camera and audio layers draw nothing; nested compositions are walked. */\nfunction drawnLeaves(sequences: unknown): number {\n  if (!Array.isArray(sequences)) return 0;\n  let n = 0;\n  for (const s of sequences as Counted[]) {\n    if (!s || s.type === 'null' || s.type === 'camera' || s.type === 'audio') continue;\n    n += s.type === 'composition' ? drawnLeaves(s.sequences) : 1;\n  }\n  return n;\n}\n\n/**\n * The full-frame passes one layer costs while it is on screen: 1 for a layer with an advanced mode; for a composition with one, one for each\n * drawn layer inside it (its children inherit the mode and blend one by one); for a composition without, the most that its own layers add\n * at one instant (a card with three blends in it, on screen with four other cards, is twelve).\n */\nfunction passesOf(l: Counted, span: number): number {\n  const isComposition = l.type === 'composition';\n  if (isAdvancedBlend(l.blendMode)) return isComposition ? Math.max(1, drawnLeaves(l.sequences)) : 1;\n  return isComposition && Array.isArray(l.sequences) ? maxConcurrentAdvanced(l.sequences as Counted[], l.duration ?? span) : 0;\n}\n\n/** The most full-frame advanced-blend passes on screen at one instant, from the layers' `at` and `duration` (a layer with no duration lasts to the end). */\nexport function maxConcurrentAdvanced(layers: ReadonlyArray<Counted>, span: number): number {\n  const events: Array<[number, number]> = [];\n  for (const l of layers) {\n    const w = passesOf(l, span);\n    if (w === 0) continue;\n    const at = l.at ?? 0;\n    const end = l.duration === undefined ? span : at + l.duration;\n    const start = Math.max(0, at);                                     // a negative `at` starts before the composition: only what is after 0 is on screen\n    if (end > start) events.push([start, w], [end, -w]);\n  }\n  events.sort((a, b) => a[0] - b[0] || a[1] - b[1]);                  // at one instant, the layers that end go before the ones that start\n  let now = 0, most = 0;\n  for (const [, d] of events) { now += d; most = Math.max(most, now); }\n  return most;\n}\n"]}

package/dist/{chunk-67LG7MN5.js → chunk-VF56PRAA.js}

@@ -1,6 +1,6 @@
-import { CompositionSequence, maskSourceOf } from './chunk-XV4L72FW.js';
-import { EXPRESSION_NAMES, createTimeline, lengthen, ensureFilterLibrary, checkEase, parseEase, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, rand, DEG, timeRemapOf, contentLength, resolveAt, parseSpring, springDuration, spansMeta } from './chunk-Y253JQOH.js';
-import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-RTJD3ZSW.js';
+import { CompositionSequence, maskSourceOf } from './chunk-AZ6AINSW.js';
+import { EXPRESSION_NAMES, createTimeline, lengthen, ensureFilterLibrary, checkEase, parseEase, homeDistance, DEFAULT_FOV, random, noise, flattenSvgPath, rand, DEG, timeRemapOf, contentLength, resolveAt, parseSpring, springDuration, spansMeta } from './chunk-G3DX65HO.js';
+import { usesAdvancedBlend, enableAdvancedBlend } from './chunk-WIIU42FH.js';
 import { warnUnknownOptions, suggestName } from './chunk-BXOCEZ4U.js';
 import { extensions, CullerPlugin, Application, Container, Rectangle, Culler, CanvasTextMetrics, TextStyle, Assets, ExtensionType, Filter, Texture, UniformGroup, GpuProgram, GlProgram, defaultFilterVert } from 'pixi.js';
 import { Output, BufferTarget, CanvasSource, AudioBufferSource, Input, ALL_FORMATS, BlobSource, WavOutputFormat, Conversion, VideoSampleSink, OggOutputFormat, QUALITY_VERY_HIGH, QUALITY_HIGH, QUALITY_MEDIUM, QUALITY_LOW, QUALITY_VERY_LOW, MkvOutputFormat, WebMOutputFormat, MovOutputFormat, Mp4OutputFormat, canEncodeVideo, getFirstEncodableAudioCodec } from 'mediabunny';
@@ -390,6 +390,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) => {
@@ -475,6 +476,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";
@@ -502,8 +504,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`);
@@ -1882,6 +1898,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);
@@ -1925,7 +1955,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);
@@ -1969,6 +2003,10 @@ 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;
@@ -1981,7 +2019,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 CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero);
+      if (seq instanceof CompositionSequence) walk2(seq, prefix + label + "/", insideThreeD || threeD, visible, group, motion, zero, parentAlpha * alpha);
     });
   };
   walk2(root, "", false, true);
@@ -2017,6 +2055,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 };
@@ -2643,6 +2717,10 @@ var Movie = class {
   _silent = 0;
   /** render() / peek() in flight: a rebuild does not swap the composition under them. */
   _busy = 0;
+  /** > 0 while the movie is moving its scene to another moment (a seek, a motion-blurred frame, the poster): a thumbnail does not start then. */
+  _moving = 0;
+  /** The thumbnail being drawn, if any: a seek waits for it (it has the scene on another moment for a few microtasks). */
+  _thumbRun = null;
   _idleWaiters = [];
   /** What went into the mix, and its peak before limiting — kept for inspectAudio(). */
   _audioSources = [];
@@ -2690,6 +2768,7 @@ var Movie = class {
     if (this._posterFrame === null || !this.timeline) return;
     const back = this.currentFrame;
     this.currentFrame = this._posterFrame;
+    this._moving++;
     try {
       this.timeline.time(this._timeOf(this._posterFrame));
       await this._awaitVideoFrames();
@@ -2697,6 +2776,7 @@ var Movie = class {
       this._renderNow();
     } finally {
       this.currentFrame = back;
+      this._moving--;
     }
     this._atPoster = true;
   }
@@ -3083,12 +3163,18 @@ var Movie = class {
     this.emit("error", { where, message: error instanceof Error ? error.message : String(error), error });
   }
   async _goto(frame) {
-    this._atPoster = false;
-    this.currentFrame = Math.max(0, Math.min(frame, this.totalFrames));
-    this.timeline.time(this._timeOf(this.currentFrame));
-    await this._awaitVideoFrames();
-    this._updateSpace();
-    this._renderNow();
+    if (this._thumbRun) await this._thumbRun;
+    this._moving++;
+    try {
+      this._atPoster = false;
+      this.currentFrame = Math.max(0, Math.min(frame, this.totalFrames));
+      this.timeline.time(this._timeOf(this.currentFrame));
+      await this._awaitVideoFrames();
+      this._updateSpace();
+      this._renderNow();
+    } finally {
+      this._moving--;
+    }
     this.emit("frame", { frame: this.currentFrame, totalFrames: this.totalFrames });
   }
   /**
@@ -3136,6 +3222,69 @@ var Movie = class {
     if (o.as === "imageData") return out.getContext("2d").getImageData(0, 0, out.width, out.height);
     return encodeCanvas(out, o.type, o.as, o.quality);
   }
+  /**
+   * Why `thumbnail()` is off for this movie: `'variables'` (it declares `vars`: the picture depends on them and changes when they do) or `'video'` (a video
+   * layer: its frame must be waited for, which would seek the playing video). `null`: it works.
+   */
+  get thumbnailsOff() {
+    if (this._declared.size > 0) return "variables";
+    if (!this._rootSequence) return null;
+    const found = [];
+    collectVideoSequences(this._rootSequence, found);
+    return found.some((v) => v.spec?.type === "video") ? "video" : null;
+  }
+  /**
+   * A small picture of any frame, drawn WITHOUT moving the playhead or changing what is on the canvas, so it can be made while the movie plays or is
+   * paused (a seek-bar preview). The scene is put on that moment, drawn, copied, and put back, all within the microtasks of one task: the browser never
+   * shows the in-between. Gives `null` when it cannot be made right now: the movie has thumbnails off (see `thumbnailsOff`), is moving somewhere else
+   * (a seek, a render, a peek), or is another thumbnail's turn. It is the picture `snapshot()` gives at that size (without motion blur).
+   */
+  async thumbnail(frame, opts = {}) {
+    warnUnknownOptions("movie.thumbnail()", opts, ["width", "scale"]);
+    this._requireReady("thumbnail");
+    if (opts.width !== void 0 && !(opts.width > 0 && opts.width <= this.width * 4)) throw new Error(`pixi-effects: movie.thumbnail(): width must be above 0 and at most ${this.width * 4} px, got ${opts.width}`);
+    if (opts.scale !== void 0 && !(opts.scale > 0 && opts.scale <= 4)) throw new Error(`pixi-effects: movie.thumbnail(): scale must be above 0 and at most 4, got ${opts.scale}`);
+    if (this.thumbnailsOff || this._moving > 0 || this._busy > 0 || this._thumbRun) return null;
+    const w = Math.max(1, Math.round(opts.width ?? (opts.scale !== void 0 ? this.width * opts.scale : 160)));
+    const h = Math.max(1, Math.round(w * this.height / this.width));
+    let done;
+    this._thumbRun = new Promise((r) => {
+      done = r;
+    });
+    try {
+      return await this._drawThumbnail(clampFrame(frame, this.totalFrames), w, h);
+    } finally {
+      this._thumbRun = null;
+      done();
+    }
+  }
+  async _drawThumbnail(frame, w, h) {
+    const stage = this.app.canvas;
+    const out = document.createElement("canvas");
+    out.width = w;
+    out.height = h;
+    const keep = this.timeline.time();
+    const t = this._timeOf(frame);
+    this._nominalTime = t;
+    try {
+      this.timeline.time(t);
+      await this._awaitVideoFrames(t);
+      this._updateSpace(t);
+      this._renderNow();
+      out.getContext("2d").drawImage(stage, 0, 0, w, h);
+    } finally {
+      this._nominalTime = keep;
+      try {
+        this.timeline.time(keep);
+        await this._awaitVideoFrames(keep);
+        this._updateSpace(keep);
+        this._renderNow();
+      } finally {
+        this._nominalTime = null;
+      }
+    }
+    return out;
+  }
   async onionSkin(opts = {}) {
     warnUnknownOptions("movie.onionSkin()", opts, ["from", "to", "count", "scale", "as", "motionBlur"]);
     this._requireReady("onionSkin");
@@ -3314,9 +3463,11 @@ var Movie = class {
   async _exposeFrame(frame, mb, target, settle) {
     const g = target.getContext("2d");
     const stage = this.app.canvas;
+    if (this._thumbRun) await this._thumbRun;
     this._atPoster = false;
     const times = blurTimes(frame, this.frameRate, mb, Math.max(0, this.duration - END_MARGIN));
     this._nominalTime = this._timeOf(Math.max(0, Math.min(frame, this.totalFrames)));
+    this._moving++;
     try {
       for (let k = 0; k < times.length; k++) {
         const t = times[k];
@@ -3330,6 +3481,7 @@ var Movie = class {
       }
     } finally {
       this._nominalTime = null;
+      this._moving--;
     }
     g.globalAlpha = 1;
     if (settle) await this._goto(frame);
@@ -3638,7 +3790,7 @@ function measureText(text, style = {}) {
   return { width: m.width, height: m.height, lines: text.split("\n").length };
 }
 function splitText(text, style = {}, opts = {}) {
-  warnUnknownOptions("splitText()", opts, ["by", "x", "y", "align"]);
+  warnUnknownOptions("splitText()", opts, ["by", "x", "y", "align", "vertical"]);
   let by = opts.by ?? "chars";
   if (!BY.includes(by)) {
     const g = suggestName(String(by), BY);
@@ -3657,6 +3809,7 @@ function splitText(text, style = {}, opts = {}) {
   }
   if (text === "") return [];
   const ts = new TextStyle(style);
+  if (opts.vertical) return splitVertical(text, style, ts, x0, y0, align, by);
   const lineHeight = CanvasTextMetrics.measureText("M", ts).lineHeight ?? CanvasTextMetrics.measureText("M", ts).height;
   const sentinel = widthOf("|", ts);
   const out = [];
@@ -3680,6 +3833,36 @@ 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 = CanvasTextMetrics.measureText("M", ts).lineHeight ?? 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) {
@@ -4195,7 +4378,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" },
@@ -4208,14 +4391,14 @@ var PRESETS = {
 var PRESET_NAMES = Object.keys(PRESETS);
 function animateText(text, style, options) {
   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");
@@ -4234,12 +4417,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,
@@ -4278,7 +4461,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
     };
   });
@@ -4620,5 +4803,5 @@ function withFade(spec, opts) {
 }
 
 export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, parseEase2 as parseEase, particles, react, resolveLoader, splitText, stagger, wiggle, withFade };
-//# sourceMappingURL=chunk-67LG7MN5.js.map
-//# sourceMappingURL=chunk-67LG7MN5.js.map
+//# sourceMappingURL=chunk-VF56PRAA.js.map
+//# sourceMappingURL=chunk-VF56PRAA.js.map