pixi-effects 0.35.0 → 0.37.0

package/dist/{chunk-RTJD3ZSW.js → chunk-VNP7QCJE.js}

@@ -1,4 +1,4 @@
-import { describeLayer } from './chunk-ITDYFBB6.js';
+import { describeLayer } from './chunk-32MMNDDN.js';
 import { suggestName } from './chunk-BXOCEZ4U.js';
 
 // src/core/blend.ts
@@ -83,7 +83,7 @@ function blendFilterFor(mode) {
 }
 async function enableAdvancedBlend(renderer) {
   try {
-    const { registerBlendModes } = await import('./blendModes-PP5NPBXY.js');
+    const { registerBlendModes } = await import('./blendModes-FMYO6SQN.js');
     registerBlendModes();
   } catch (e) {
     const why = e instanceof Error ? e.message : String(e);
@@ -128,5 +128,5 @@ function maxConcurrentAdvanced(layers, span) {
 }
 
 export { MANY_ADVANCED, applyBlendMode, blendFilterFor, enableAdvancedBlend, isAdvancedBlend, maxConcurrentAdvanced, setBlendFilterFactory, usesAdvancedBlend };
-//# sourceMappingURL=chunk-RTJD3ZSW.js.map
-//# sourceMappingURL=chunk-RTJD3ZSW.js.map
+//# sourceMappingURL=chunk-VNP7QCJE.js.map
+//# sourceMappingURL=chunk-VNP7QCJE.js.map

package/dist/{chunk-RTJD3ZSW.js.map → chunk-VNP7QCJE.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/blend.ts"],"names":[],"mappings":"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","file":"chunk-RTJD3ZSW.js","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":[],"mappings":"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","file":"chunk-VNP7QCJE.js","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/index.cjs

@@ -1,125 +1,133 @@
 'use strict';
 
-var chunk7TTCPHAV_cjs = require('./chunk-7TTCPHAV.cjs');
-require('./chunk-5IJENZOG.cjs');
-var chunkLEECUCTG_cjs = require('./chunk-LEECUCTG.cjs');
-require('./chunk-IMQJVRMT.cjs');
-require('./chunk-GL2AQFLQ.cjs');
+var chunkE26M4NTL_cjs = require('./chunk-E26M4NTL.cjs');
+require('./chunk-MJMOPWMK.cjs');
+var chunkQHIOOK5S_cjs = require('./chunk-QHIOOK5S.cjs');
+require('./chunk-JN7JHNZR.cjs');
+require('./chunk-3SAS3ZE5.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 
 
 
 Object.defineProperty(exports, "Movie", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.Movie; }
+  get: function () { return chunkE26M4NTL_cjs.Movie; }
 });
 Object.defineProperty(exports, "animateText", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.animateText; }
+  get: function () { return chunkE26M4NTL_cjs.animateText; }
 });
 Object.defineProperty(exports, "audioEnvelope", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.audioEnvelope; }
+  get: function () { return chunkE26M4NTL_cjs.audioEnvelope; }
 });
 Object.defineProperty(exports, "bpmEnvelope", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.bpmEnvelope; }
+  get: function () { return chunkE26M4NTL_cjs.bpmEnvelope; }
 });
 Object.defineProperty(exports, "cameraPath", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.cameraPath; }
+  get: function () { return chunkE26M4NTL_cjs.cameraPath; }
 });
 Object.defineProperty(exports, "computeEnvelope", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.computeEnvelope; }
+  get: function () { return chunkE26M4NTL_cjs.computeEnvelope; }
 });
 Object.defineProperty(exports, "dismissLoader", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.dismissLoader; }
+  get: function () { return chunkE26M4NTL_cjs.dismissLoader; }
 });
 Object.defineProperty(exports, "ease", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.parseEase; }
+  get: function () { return chunkE26M4NTL_cjs.parseEase; }
 });
 Object.defineProperty(exports, "failLoader", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.failLoader; }
+  get: function () { return chunkE26M4NTL_cjs.failLoader; }
 });
 Object.defineProperty(exports, "followPath", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.followPath; }
+  get: function () { return chunkE26M4NTL_cjs.followPath; }
 });
 Object.defineProperty(exports, "kenBurns", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.kenBurns; }
+  get: function () { return chunkE26M4NTL_cjs.kenBurns; }
 });
 Object.defineProperty(exports, "measureText", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.measureText; }
+  get: function () { return chunkE26M4NTL_cjs.measureText; }
 });
 Object.defineProperty(exports, "musicBuffer", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.musicBuffer; }
+  get: function () { return chunkE26M4NTL_cjs.musicBuffer; }
 });
 Object.defineProperty(exports, "musicEnvelope", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.musicEnvelope; }
+  get: function () { return chunkE26M4NTL_cjs.musicEnvelope; }
 });
 Object.defineProperty(exports, "musicEvents", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.musicEvents; }
+  get: function () { return chunkE26M4NTL_cjs.musicEvents; }
 });
 Object.defineProperty(exports, "orbit", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.orbit; }
+  get: function () { return chunkE26M4NTL_cjs.orbit; }
 });
 Object.defineProperty(exports, "particles", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.particles; }
+  get: function () { return chunkE26M4NTL_cjs.particles; }
 });
 Object.defineProperty(exports, "react", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.react; }
+  get: function () { return chunkE26M4NTL_cjs.react; }
 });
 Object.defineProperty(exports, "resolveLoader", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.resolveLoader; }
+  get: function () { return chunkE26M4NTL_cjs.resolveLoader; }
+});
+Object.defineProperty(exports, "samplePath", {
+  enumerable: true,
+  get: function () { return chunkE26M4NTL_cjs.samplePath; }
 });
 Object.defineProperty(exports, "splitText", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.splitText; }
+  get: function () { return chunkE26M4NTL_cjs.splitText; }
 });
 Object.defineProperty(exports, "stagger", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.stagger; }
+  get: function () { return chunkE26M4NTL_cjs.stagger; }
 });
 Object.defineProperty(exports, "wiggle", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.wiggle; }
+  get: function () { return chunkE26M4NTL_cjs.wiggle; }
 });
 Object.defineProperty(exports, "withFade", {
   enumerable: true,
-  get: function () { return chunk7TTCPHAV_cjs.withFade; }
+  get: function () { return chunkE26M4NTL_cjs.withFade; }
 });
 Object.defineProperty(exports, "Sequence", {
   enumerable: true,
-  get: function () { return chunkLEECUCTG_cjs.Sequence; }
+  get: function () { return chunkQHIOOK5S_cjs.Sequence; }
 });
 Object.defineProperty(exports, "noise", {
   enumerable: true,
-  get: function () { return chunkLEECUCTG_cjs.noise; }
+  get: function () { return chunkQHIOOK5S_cjs.noise; }
+});
+Object.defineProperty(exports, "noise2", {
+  enumerable: true,
+  get: function () { return chunkQHIOOK5S_cjs.noise2; }
 });
 Object.defineProperty(exports, "rand", {
   enumerable: true,
-  get: function () { return chunkLEECUCTG_cjs.rand; }
+  get: function () { return chunkQHIOOK5S_cjs.rand; }
 });
 Object.defineProperty(exports, "random", {
   enumerable: true,
-  get: function () { return chunkLEECUCTG_cjs.random; }
+  get: function () { return chunkQHIOOK5S_cjs.random; }
 });
 Object.defineProperty(exports, "registerSequenceType", {
   enumerable: true,
-  get: function () { return chunkLEECUCTG_cjs.registerSequenceType; }
+  get: function () { return chunkQHIOOK5S_cjs.registerSequenceType; }
 });
 Object.defineProperty(exports, "warnUnknownOptions", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { M as MusicEvents } from './Movie-Db4QnMIH.cjs';
-export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoadProgressState, g as LoadStage, h as LoaderOption, i as LoopEvent, j as MotionBlurOptions, k as MotionBlurSpec, l as Movie, m as MovieErrorEvent, n as MovieOptions, o as MusicDrumEvents, p as MusicDrumHit, q as MusicNote, r as MusicSummary, s as MusicTrackEvents, O as OnionSkinOptions, P as ProgressEvent, R as RebuildOptions, t as RebuildReason, u as RebuildReport, v as RenderOptions, w as ReviewOptions, x as ReviewReport, S as SnapshotOptions, y as SoundMeasure, T as ThumbnailOptions, z as TimelineData, B as TimelineHtmlOptions, D as TimelineRow, E as TimelineSvgOptions, G as TimelineTransition, V as VolumeEvent, H as dismissLoader, J as failLoader, K as resolveLoader } from './Movie-Db4QnMIH.cjs';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, b as SequenceCommon } from './types-CavnUvd5.cjs';
-export { A as ArcShapeSpec, c as AssetSpec, d as AudioAssetSpec, e as AudioMusicSpec, f as AudioSequenceSpec, g as AudioSfxSpec, B as BlendModeName, h as ChromaKeyFilterSpec, i as CircleShapeSpec, j as CompositionSequenceSpec, k as CompositionSpec, l as CrossfadeTransition, m as CustomFilterSpec, D as DipTransition, n as DissolveTransition, E as EllipseShapeSpec, o as Expr, F as FilterSpec, G as GradientSpec, p as IrisTransition, L as LightSequenceSpec, q as LineShapeSpec, r as LumaTransition, s as MaskRefSpec, t as MatteRefSpec, u as MusicDrum, v as MusicDrums, w as MusicInstrument, x as MusicLevel, y as MusicTrack, N as NullSequenceSpec, P as PathShapeSpec, z as PolygonShapeSpec, H as PropValue, J as Props, R as RectShapeSpec, O as SfxKnobs, Q as SfxOptions, U as SfxPreset, V as SfxVoice, W as ShaderSequenceSpec, X as ShapeSequenceSpec, Y as SlideTransition, Z as Stop, _ as StopSpec, $ as TextSpan, a0 as TransitionCommon, a1 as TransitionSpec, a2 as VideoSequenceSpec, a3 as WipeTransition, a4 as ZoomTransition } from './types-CavnUvd5.cjs';
-import { S as Sequence } from './Base-pNq6sVGl.cjs';
+import { M as MusicEvents } from './Movie-CJN_gvLB.cjs';
+export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoadProgressState, g as LoadStage, h as LoaderOption, i as LoopEvent, j as MotionBlurOptions, k as MotionBlurSpec, l as Movie, m as MovieErrorEvent, n as MovieOptions, o as MusicDrumEvents, p as MusicDrumHit, q as MusicNote, r as MusicSummary, s as MusicTrackEvents, O as OnionSkinOptions, P as ProgressEvent, R as RebuildOptions, t as RebuildReason, u as RebuildReport, v as RenderOptions, w as ReviewOptions, x as ReviewReport, S as SnapshotOptions, y as SoundMeasure, T as ThumbnailOptions, z as TimelineData, B as TimelineHtmlOptions, D as TimelineRow, E as TimelineSvgOptions, G as TimelineTransition, V as VolumeEvent, H as dismissLoader, J as failLoader, K as resolveLoader } from './Movie-CJN_gvLB.cjs';
+import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, b as SequenceCommon } from './types-DvnXXm33.cjs';
+export { A as ArcShapeSpec, c as AssetSpec, d as AudioAssetSpec, e as AudioMusicSpec, f as AudioSequenceSpec, g as AudioSfxSpec, B as BlendModeName, h as CanvasInfo, i as CanvasSequenceSpec, j as ChromaKeyFilterSpec, k as CircleShapeSpec, l as CompositionSequenceSpec, m as CompositionSpec, n as CrossfadeTransition, o as CustomFilterSpec, D as DipTransition, p as DissolveTransition, E as EllipseShapeSpec, q as Expr, F as FilterSpec, G as GradientSpec, r as IrisTransition, L as LightSequenceSpec, s as LineShapeSpec, t as LumaTransition, u as MaskRefSpec, v as MatteRefSpec, w as MusicDrum, x as MusicDrums, y as MusicInstrument, z as MusicLevel, H as MusicTrack, N as NullSequenceSpec, P as PathShapeSpec, J as PolygonShapeSpec, O as PropValue, Q as Props, R as RectShapeSpec, U as SfxKnobs, V as SfxOptions, W as SfxPreset, X as SfxVoice, Y as ShaderSequenceSpec, Z as ShapeSequenceSpec, _ as SlideTransition, $ as Stop, a0 as StopSpec, a1 as TextSpan, a2 as TransitionCommon, a3 as TransitionSpec, a4 as VideoSequenceSpec, a5 as WipeTransition, a6 as ZoomTransition } from './types-DvnXXm33.cjs';
+import { S as Sequence } from './Base-BlA6SeqJ.cjs';
 import 'pixi.js';
 
 /** A text style as written in a `text` layer's `style` (numbers, not expressions, for the fields that size the text). */
@@ -22,6 +22,13 @@ interface SplitOptions {
     y?: number;
     /** How each line sits on `x`. Default `'left'`. */
     align?: 'left' | 'center' | 'right';
+    /**
+     * Vertical writing (tategaki): characters go down a column, a new line is a new column to the left. `x` is then the RIGHT edge of the first column and `y` the top
+     * of a column (`align`: `'left'` keeps y at the top, `'center'` at the middle, `'right'` at the bottom). Only `by: 'chars'` has a vertical form. Each piece also gets
+     * `cx` / `cy` (the centre of its cell, punctuation already moved to the upper right) and `rotation` (degrees: the long vowel mark, dashes, waves and brackets are turned
+     * a quarter clockwise); place a text layer with `anchorX: 0.5, anchorY: 0.5` at `cx` / `cy` and `rotation: p.rotation`. `animateText(..., { vertical: true })` does all of it.
+     */
+    vertical?: boolean;
 }
 interface TextPiece {
     text: string;
@@ -34,6 +41,11 @@ interface TextPiece {
     index: number;
     /** Which line (0-based) the piece is on. */
     line: number;
+    /** Vertical text only: where the centre of the piece goes (a text layer with `anchorX: 0.5, anchorY: 0.5`). */
+    cx?: number;
+    cy?: number;
+    /** Vertical text only: the turn in degrees the piece needs (0 or 90). */
+    rotation?: number;
 }
 /**
  * How big `text` is drawn with `style`: the same numbers a text layer with that style has, measured with the font the
@@ -277,6 +289,30 @@ interface FollowPathOptions {
  */
 declare function followPath(opts: FollowPathOptions): Keyframe[];
 
+/** A path walked by length: where a fraction of the way along is, which way it heads, and the part between two fractions. */
+interface PathSampler {
+    /** The arc length of all the sub-paths together, in the path's own units. */
+    length: number;
+    /** The point a fraction `u` (0–1, clamped) of the length along, and the heading there in radians (`Math.atan2` of the direction, 0 = right, π/2 = down). */
+    at(u: number): {
+        x: number;
+        y: number;
+        angle: number;
+    };
+    /** The part between the fractions `start` and `end` (default the whole path) as flat `[x, y, x, y, …]` pieces, one per sub-path it touches: draw each with `moveTo` / `lineTo` (a line that draws on). */
+    trim(start?: number, end?: number): number[][];
+}
+/**
+ * Walks SVG path data by arc length, the way `followPath` does, for a `canvas` layer's `draw` (or anything that needs the points of a curve): text set along a curve, a leader
+ * line that draws on, a petal that falls along a route. Curves are flattened the way the shape layer draws them. Build it once (module scope or `setup`), ask it every frame.
+ *
+ * ```js
+ * const route = samplePath('M 40 300 C 200 20 400 20 560 300');
+ * // in draw: const { x, y, angle } = route.at(t / 4); for (const piece of route.trim(0, t / 4)) { ctx.moveTo(piece[0], piece[1]); … }
+ * ```
+ */
+declare function samplePath(d: string): PathSampler;
+
 interface CameraPathOptions {
     /** The route: `[x, y, z]` points the camera passes, in order (at least two). */
     points: Array<[number, number, number]>;
@@ -403,7 +439,7 @@ type TextPreset = keyof typeof PRESETS;
 interface AnimateTextTween {
     /** Start from this preset and change what you give below. */
     preset?: TextPreset;
-    /** The hidden state: `x` / `y` are offsets from the resting place, everything else (`alpha`, `scale`, `rotation`, …) is absolute. */
+    /** The hidden state: `x` / `y` are offsets from the resting place, everything else (`alpha`, `scale`, …) is absolute; `rotation` too, from the resting rotation (0, except the turned glyphs of vertical text, which rest at 90°). */
     from?: Record<string, number>;
     /** The resting state, for properties that have none of their own (`alpha` 1, `scale` 1, `rotation` 0 and the place are known). */
     to?: Record<string, number>;
@@ -422,6 +458,8 @@ interface AnimateTextOptions {
     /** Top of the first line. */
     y?: number;
     align?: 'left' | 'center' | 'right';
+    /** Vertical writing: characters go down a column, a new line is a new column to the left, and `x` is the RIGHT edge of the first column (see `splitText`). Punctuation and the long vowel mark are placed and turned the way tategaki wants. */
+    vertical?: boolean;
     /** Layers are named `<name>-0`, `<name>-1`, … (default `'text'`). */
     name?: string;
     /** When the first piece starts, in composition seconds. Default 0. */
@@ -652,6 +690,8 @@ declare function rand(seed: number): number;
 declare function random(seed: number): () => number;
 /** Smooth 1-D noise in [-1, 1]: continuous in `x`, a different curve for every `seed`. */
 declare function noise(x: number, seed?: number): number;
+/** Smooth 2-D noise in [-1, 1]: continuous in `x` and in `y`, a different field for every `seed` (add octaves yourself for clouds: `noise2(x, y) + 0.5 * noise2(2 * x, 2 * y)`). */
+declare function noise2(x: number, y: number, seed?: number): number;
 
 interface WithFadeOptions {
     /** Fade-in duration (seconds), at the start of the sequence. */
@@ -687,4 +727,4 @@ interface WithFadeOptions {
  */
 declare function withFade<T extends SequenceCommon>(spec: T, opts: WithFadeOptions): T;
 
-export { type AnimateTextOptions, type AnimateTextTween, type AudioEnvelope, type AudioEnvelopeSource, type CameraPathOptions, CameraSequenceSpec, CompositionShape, type EnvelopeOptions, type FollowPathOptions, ImageSequenceSpec, type KenBurnsOptions, Keyframe, type MeasureStyle, MusicEvents, MusicOptions, type OrbitOptions, type ParticlesOptions, type ReactOptions, type ReactProp, Sequence, SequenceCommon, type SequenceCtor, SequenceSpec, type SplitOptions, type StaggerOptions, type TextPiece, type TextPreset, TextSequenceSpec, type TextSize, type WiggleOptions, type WiggleProp, type WithFadeOptions, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, parseEase as ease, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, noise, orbit, particles, rand, random, react, registerSequenceType, splitText, stagger, warnUnknownOptions, wiggle, withFade };
+export { type AnimateTextOptions, type AnimateTextTween, type AudioEnvelope, type AudioEnvelopeSource, type CameraPathOptions, CameraSequenceSpec, CompositionShape, type EnvelopeOptions, type FollowPathOptions, ImageSequenceSpec, type KenBurnsOptions, Keyframe, type MeasureStyle, MusicEvents, MusicOptions, type OrbitOptions, type ParticlesOptions, type PathSampler, type ReactOptions, type ReactProp, Sequence, SequenceCommon, type SequenceCtor, SequenceSpec, type SplitOptions, type StaggerOptions, type TextPiece, type TextPreset, TextSequenceSpec, type TextSize, type WiggleOptions, type WiggleProp, type WithFadeOptions, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, parseEase as ease, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, noise, noise2, orbit, particles, rand, random, react, registerSequenceType, samplePath, splitText, stagger, warnUnknownOptions, wiggle, withFade };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { M as MusicEvents } from './Movie-VYtUN4TS.js';
-export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoadProgressState, g as LoadStage, h as LoaderOption, i as LoopEvent, j as MotionBlurOptions, k as MotionBlurSpec, l as Movie, m as MovieErrorEvent, n as MovieOptions, o as MusicDrumEvents, p as MusicDrumHit, q as MusicNote, r as MusicSummary, s as MusicTrackEvents, O as OnionSkinOptions, P as ProgressEvent, R as RebuildOptions, t as RebuildReason, u as RebuildReport, v as RenderOptions, w as ReviewOptions, x as ReviewReport, S as SnapshotOptions, y as SoundMeasure, T as ThumbnailOptions, z as TimelineData, B as TimelineHtmlOptions, D as TimelineRow, E as TimelineSvgOptions, G as TimelineTransition, V as VolumeEvent, H as dismissLoader, J as failLoader, K as resolveLoader } from './Movie-VYtUN4TS.js';
-import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, b as SequenceCommon } from './types-CavnUvd5.js';
-export { A as ArcShapeSpec, c as AssetSpec, d as AudioAssetSpec, e as AudioMusicSpec, f as AudioSequenceSpec, g as AudioSfxSpec, B as BlendModeName, h as ChromaKeyFilterSpec, i as CircleShapeSpec, j as CompositionSequenceSpec, k as CompositionSpec, l as CrossfadeTransition, m as CustomFilterSpec, D as DipTransition, n as DissolveTransition, E as EllipseShapeSpec, o as Expr, F as FilterSpec, G as GradientSpec, p as IrisTransition, L as LightSequenceSpec, q as LineShapeSpec, r as LumaTransition, s as MaskRefSpec, t as MatteRefSpec, u as MusicDrum, v as MusicDrums, w as MusicInstrument, x as MusicLevel, y as MusicTrack, N as NullSequenceSpec, P as PathShapeSpec, z as PolygonShapeSpec, H as PropValue, J as Props, R as RectShapeSpec, O as SfxKnobs, Q as SfxOptions, U as SfxPreset, V as SfxVoice, W as ShaderSequenceSpec, X as ShapeSequenceSpec, Y as SlideTransition, Z as Stop, _ as StopSpec, $ as TextSpan, a0 as TransitionCommon, a1 as TransitionSpec, a2 as VideoSequenceSpec, a3 as WipeTransition, a4 as ZoomTransition } from './types-CavnUvd5.js';
-import { S as Sequence } from './Base-CXsMdmJB.js';
+import { M as MusicEvents } from './Movie-CfHaGmUP.js';
+export { A as AudioInspectOptions, a as AudioReport, b as AudioSourceReport, C as ContactSheetOptions, F as FontReport, c as FrameEvent, I as InspectOptions, d as InspectReport, e as IssueGroup, L as LayerInfo, f as LoadProgressState, g as LoadStage, h as LoaderOption, i as LoopEvent, j as MotionBlurOptions, k as MotionBlurSpec, l as Movie, m as MovieErrorEvent, n as MovieOptions, o as MusicDrumEvents, p as MusicDrumHit, q as MusicNote, r as MusicSummary, s as MusicTrackEvents, O as OnionSkinOptions, P as ProgressEvent, R as RebuildOptions, t as RebuildReason, u as RebuildReport, v as RenderOptions, w as ReviewOptions, x as ReviewReport, S as SnapshotOptions, y as SoundMeasure, T as ThumbnailOptions, z as TimelineData, B as TimelineHtmlOptions, D as TimelineRow, E as TimelineSvgOptions, G as TimelineTransition, V as VolumeEvent, H as dismissLoader, J as failLoader, K as resolveLoader } from './Movie-CfHaGmUP.js';
+import { S as SequenceSpec, C as CompositionShape, I as ImageSequenceSpec, a as CameraSequenceSpec, K as Keyframe, T as TextSequenceSpec, M as MusicOptions, b as SequenceCommon } from './types-DvnXXm33.js';
+export { A as ArcShapeSpec, c as AssetSpec, d as AudioAssetSpec, e as AudioMusicSpec, f as AudioSequenceSpec, g as AudioSfxSpec, B as BlendModeName, h as CanvasInfo, i as CanvasSequenceSpec, j as ChromaKeyFilterSpec, k as CircleShapeSpec, l as CompositionSequenceSpec, m as CompositionSpec, n as CrossfadeTransition, o as CustomFilterSpec, D as DipTransition, p as DissolveTransition, E as EllipseShapeSpec, q as Expr, F as FilterSpec, G as GradientSpec, r as IrisTransition, L as LightSequenceSpec, s as LineShapeSpec, t as LumaTransition, u as MaskRefSpec, v as MatteRefSpec, w as MusicDrum, x as MusicDrums, y as MusicInstrument, z as MusicLevel, H as MusicTrack, N as NullSequenceSpec, P as PathShapeSpec, J as PolygonShapeSpec, O as PropValue, Q as Props, R as RectShapeSpec, U as SfxKnobs, V as SfxOptions, W as SfxPreset, X as SfxVoice, Y as ShaderSequenceSpec, Z as ShapeSequenceSpec, _ as SlideTransition, $ as Stop, a0 as StopSpec, a1 as TextSpan, a2 as TransitionCommon, a3 as TransitionSpec, a4 as VideoSequenceSpec, a5 as WipeTransition, a6 as ZoomTransition } from './types-DvnXXm33.js';
+import { S as Sequence } from './Base-YqM0Ljvp.js';
 import 'pixi.js';
 
 /** A text style as written in a `text` layer's `style` (numbers, not expressions, for the fields that size the text). */
@@ -22,6 +22,13 @@ interface SplitOptions {
     y?: number;
     /** How each line sits on `x`. Default `'left'`. */
     align?: 'left' | 'center' | 'right';
+    /**
+     * Vertical writing (tategaki): characters go down a column, a new line is a new column to the left. `x` is then the RIGHT edge of the first column and `y` the top
+     * of a column (`align`: `'left'` keeps y at the top, `'center'` at the middle, `'right'` at the bottom). Only `by: 'chars'` has a vertical form. Each piece also gets
+     * `cx` / `cy` (the centre of its cell, punctuation already moved to the upper right) and `rotation` (degrees: the long vowel mark, dashes, waves and brackets are turned
+     * a quarter clockwise); place a text layer with `anchorX: 0.5, anchorY: 0.5` at `cx` / `cy` and `rotation: p.rotation`. `animateText(..., { vertical: true })` does all of it.
+     */
+    vertical?: boolean;
 }
 interface TextPiece {
     text: string;
@@ -34,6 +41,11 @@ interface TextPiece {
     index: number;
     /** Which line (0-based) the piece is on. */
     line: number;
+    /** Vertical text only: where the centre of the piece goes (a text layer with `anchorX: 0.5, anchorY: 0.5`). */
+    cx?: number;
+    cy?: number;
+    /** Vertical text only: the turn in degrees the piece needs (0 or 90). */
+    rotation?: number;
 }
 /**
  * How big `text` is drawn with `style`: the same numbers a text layer with that style has, measured with the font the
@@ -277,6 +289,30 @@ interface FollowPathOptions {
  */
 declare function followPath(opts: FollowPathOptions): Keyframe[];
 
+/** A path walked by length: where a fraction of the way along is, which way it heads, and the part between two fractions. */
+interface PathSampler {
+    /** The arc length of all the sub-paths together, in the path's own units. */
+    length: number;
+    /** The point a fraction `u` (0–1, clamped) of the length along, and the heading there in radians (`Math.atan2` of the direction, 0 = right, π/2 = down). */
+    at(u: number): {
+        x: number;
+        y: number;
+        angle: number;
+    };
+    /** The part between the fractions `start` and `end` (default the whole path) as flat `[x, y, x, y, …]` pieces, one per sub-path it touches: draw each with `moveTo` / `lineTo` (a line that draws on). */
+    trim(start?: number, end?: number): number[][];
+}
+/**
+ * Walks SVG path data by arc length, the way `followPath` does, for a `canvas` layer's `draw` (or anything that needs the points of a curve): text set along a curve, a leader
+ * line that draws on, a petal that falls along a route. Curves are flattened the way the shape layer draws them. Build it once (module scope or `setup`), ask it every frame.
+ *
+ * ```js
+ * const route = samplePath('M 40 300 C 200 20 400 20 560 300');
+ * // in draw: const { x, y, angle } = route.at(t / 4); for (const piece of route.trim(0, t / 4)) { ctx.moveTo(piece[0], piece[1]); … }
+ * ```
+ */
+declare function samplePath(d: string): PathSampler;
+
 interface CameraPathOptions {
     /** The route: `[x, y, z]` points the camera passes, in order (at least two). */
     points: Array<[number, number, number]>;
@@ -403,7 +439,7 @@ type TextPreset = keyof typeof PRESETS;
 interface AnimateTextTween {
     /** Start from this preset and change what you give below. */
     preset?: TextPreset;
-    /** The hidden state: `x` / `y` are offsets from the resting place, everything else (`alpha`, `scale`, `rotation`, …) is absolute. */
+    /** The hidden state: `x` / `y` are offsets from the resting place, everything else (`alpha`, `scale`, …) is absolute; `rotation` too, from the resting rotation (0, except the turned glyphs of vertical text, which rest at 90°). */
     from?: Record<string, number>;
     /** The resting state, for properties that have none of their own (`alpha` 1, `scale` 1, `rotation` 0 and the place are known). */
     to?: Record<string, number>;
@@ -422,6 +458,8 @@ interface AnimateTextOptions {
     /** Top of the first line. */
     y?: number;
     align?: 'left' | 'center' | 'right';
+    /** Vertical writing: characters go down a column, a new line is a new column to the left, and `x` is the RIGHT edge of the first column (see `splitText`). Punctuation and the long vowel mark are placed and turned the way tategaki wants. */
+    vertical?: boolean;
     /** Layers are named `<name>-0`, `<name>-1`, … (default `'text'`). */
     name?: string;
     /** When the first piece starts, in composition seconds. Default 0. */
@@ -652,6 +690,8 @@ declare function rand(seed: number): number;
 declare function random(seed: number): () => number;
 /** Smooth 1-D noise in [-1, 1]: continuous in `x`, a different curve for every `seed`. */
 declare function noise(x: number, seed?: number): number;
+/** Smooth 2-D noise in [-1, 1]: continuous in `x` and in `y`, a different field for every `seed` (add octaves yourself for clouds: `noise2(x, y) + 0.5 * noise2(2 * x, 2 * y)`). */
+declare function noise2(x: number, y: number, seed?: number): number;
 
 interface WithFadeOptions {
     /** Fade-in duration (seconds), at the start of the sequence. */
@@ -687,4 +727,4 @@ interface WithFadeOptions {
  */
 declare function withFade<T extends SequenceCommon>(spec: T, opts: WithFadeOptions): T;
 
-export { type AnimateTextOptions, type AnimateTextTween, type AudioEnvelope, type AudioEnvelopeSource, type CameraPathOptions, CameraSequenceSpec, CompositionShape, type EnvelopeOptions, type FollowPathOptions, ImageSequenceSpec, type KenBurnsOptions, Keyframe, type MeasureStyle, MusicEvents, MusicOptions, type OrbitOptions, type ParticlesOptions, type ReactOptions, type ReactProp, Sequence, SequenceCommon, type SequenceCtor, SequenceSpec, type SplitOptions, type StaggerOptions, type TextPiece, type TextPreset, TextSequenceSpec, type TextSize, type WiggleOptions, type WiggleProp, type WithFadeOptions, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, parseEase as ease, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, noise, orbit, particles, rand, random, react, registerSequenceType, splitText, stagger, warnUnknownOptions, wiggle, withFade };
+export { type AnimateTextOptions, type AnimateTextTween, type AudioEnvelope, type AudioEnvelopeSource, type CameraPathOptions, CameraSequenceSpec, CompositionShape, type EnvelopeOptions, type FollowPathOptions, ImageSequenceSpec, type KenBurnsOptions, Keyframe, type MeasureStyle, MusicEvents, MusicOptions, type OrbitOptions, type ParticlesOptions, type PathSampler, type ReactOptions, type ReactProp, Sequence, SequenceCommon, type SequenceCtor, SequenceSpec, type SplitOptions, type StaggerOptions, type TextPiece, type TextPreset, TextSequenceSpec, type TextSize, type WiggleOptions, type WiggleProp, type WithFadeOptions, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, parseEase as ease, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, noise, noise2, orbit, particles, rand, random, react, registerSequenceType, samplePath, splitText, stagger, warnUnknownOptions, wiggle, withFade };

package/dist/index.js

@@ -1,8 +1,8 @@
-export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, parseEase as ease, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, particles, react, resolveLoader, splitText, stagger, wiggle, withFade } from './chunk-2GNK6DPV.js';
-import './chunk-XV4L72FW.js';
-export { Sequence, noise, rand, random, registerSequenceType } from './chunk-Y253JQOH.js';
-import './chunk-RTJD3ZSW.js';
-import './chunk-ITDYFBB6.js';
+export { Movie, animateText, audioEnvelope, bpmEnvelope, cameraPath, computeEnvelope, dismissLoader, parseEase as ease, failLoader, followPath, kenBurns, measureText, musicBuffer, musicEnvelope, musicEvents, orbit, particles, react, resolveLoader, samplePath, splitText, stagger, wiggle, withFade } from './chunk-KNDEKWQO.js';
+import './chunk-IPQNT65V.js';
+export { Sequence, noise, noise2, rand, random, registerSequenceType } from './chunk-SBR75G73.js';
+import './chunk-VNP7QCJE.js';
+import './chunk-32MMNDDN.js';
 export { warnUnknownOptions } from './chunk-BXOCEZ4U.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/loader.css

@@ -1,7 +1,7 @@
 /*
  * pixi-effects loader: one line of HTML on the page, a few lines of CSS, no JavaScript of your own.
  *
- *   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.35.0/dist/loader.css">
+ *   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/pixi-effects@0.37.0/dist/loader.css">
  *   <div class="stage" style="position: relative">                      <!-- any box the canvas sits in, with position: relative -->
  *     <canvas id="stage" width="1280" height="720"></canvas>
  *     <div class="pe-loader" data-label="LOADING"></div>                <!-- or class="pe-loader pe-loader--bar" -->

package/dist/present.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-require('./chunk-7TTCPHAV.cjs');
-require('./chunk-5IJENZOG.cjs');
-require('./chunk-LEECUCTG.cjs');
-require('./chunk-IMQJVRMT.cjs');
-require('./chunk-GL2AQFLQ.cjs');
+require('./chunk-E26M4NTL.cjs');
+require('./chunk-MJMOPWMK.cjs');
+require('./chunk-QHIOOK5S.cjs');
+require('./chunk-JN7JHNZR.cjs');
+require('./chunk-3SAS3ZE5.cjs');
 var chunkTWZNOUM7_cjs = require('./chunk-TWZNOUM7.cjs');
 
 // src/present/stops.ts

package/dist/present.d.cts

@@ -1,5 +1,5 @@
-import { l as Movie, k as MotionBlurSpec } from './Movie-Db4QnMIH.cjs';
-import { S as SequenceSpec, J as Props, K as Keyframe, a1 as TransitionSpec, k as CompositionSpec, Z as Stop } from './types-CavnUvd5.cjs';
+import { l as Movie, k as MotionBlurSpec } from './Movie-CJN_gvLB.cjs';
+import { S as SequenceSpec, Q as Props, K as Keyframe, a3 as TransitionSpec, m as CompositionSpec, $ as Stop } from './types-DvnXXm33.cjs';
 import 'pixi.js';
 
 interface PresenterOptions {

package/dist/present.d.ts

@@ -1,5 +1,5 @@
-import { l as Movie, k as MotionBlurSpec } from './Movie-VYtUN4TS.js';
-import { S as SequenceSpec, J as Props, K as Keyframe, a1 as TransitionSpec, k as CompositionSpec, Z as Stop } from './types-CavnUvd5.js';
+import { l as Movie, k as MotionBlurSpec } from './Movie-CfHaGmUP.js';
+import { S as SequenceSpec, Q as Props, K as Keyframe, a3 as TransitionSpec, m as CompositionSpec, $ as Stop } from './types-DvnXXm33.js';
 import 'pixi.js';
 
 interface PresenterOptions {

package/dist/present.js

@@ -1,8 +1,8 @@
-import './chunk-2GNK6DPV.js';
-import './chunk-XV4L72FW.js';
-import './chunk-Y253JQOH.js';
-import './chunk-RTJD3ZSW.js';
-import './chunk-ITDYFBB6.js';
+import './chunk-KNDEKWQO.js';
+import './chunk-IPQNT65V.js';
+import './chunk-SBR75G73.js';
+import './chunk-VNP7QCJE.js';
+import './chunk-32MMNDDN.js';
 import { warnUnknownOptions } from './chunk-BXOCEZ4U.js';
 
 // src/present/stops.ts

package/dist/three.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkLEECUCTG_cjs = require('./chunk-LEECUCTG.cjs');
-require('./chunk-GL2AQFLQ.cjs');
+var chunkQHIOOK5S_cjs = require('./chunk-QHIOOK5S.cjs');
+require('./chunk-3SAS3ZE5.cjs');
 require('./chunk-TWZNOUM7.cjs');
 var pixi_js = require('pixi.js');
 var three$1 = require('three');
 
-var ThreeSequence = class extends chunkLEECUCTG_cjs.Sequence {
+var ThreeSequence = class extends chunkQHIOOK5S_cjs.Sequence {
   _renderer = null;
   _scene = null;
   _camera = null;
@@ -25,7 +25,7 @@ var ThreeSequence = class extends chunkLEECUCTG_cjs.Sequence {
     if (this.duration === void 0) {
       this.duration = this.parent?.duration ?? this.root.duration;
     }
-    const scope = chunkLEECUCTG_cjs.buildScope(this, this.parent, this.root);
+    const scope = chunkQHIOOK5S_cjs.buildScope(this, this.parent, this.root);
     const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;
     const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;
     const resolution = spec.resolution ?? 1;
@@ -145,12 +145,12 @@ var ThreeSequence = class extends chunkLEECUCTG_cjs.Sequence {
 function resolveDim(v, scope) {
   if (v === void 0) return void 0;
   if (typeof v === "number") return v;
-  return chunkLEECUCTG_cjs.evaluateExpr(v, scope);
+  return chunkQHIOOK5S_cjs.evaluateExpr(v, scope);
 }
 
 // src/three/index.ts
 function registerThree() {
-  chunkLEECUCTG_cjs.registerSequenceType("three", ThreeSequence);
+  chunkQHIOOK5S_cjs.registerSequenceType("three", ThreeSequence);
 }
 function three(spec) {
   return spec;

package/dist/three.d.cts

@@ -1,6 +1,6 @@
-import { b as SequenceCommon, H as PropValue, S as SequenceSpec } from './types-CavnUvd5.cjs';
+import { b as SequenceCommon, O as PropValue, S as SequenceSpec } from './types-DvnXXm33.cjs';
 import { Scene, Camera, WebGLRenderer } from 'three';
-import { S as Sequence, P as PathRouters } from './Base-pNq6sVGl.cjs';
+import { S as Sequence, P as PathRouters } from './Base-BlA6SeqJ.cjs';
 import 'pixi.js';
 
 /** Handed to setup / update / dispose. One per three sequence. */

package/dist/three.d.ts

@@ -1,6 +1,6 @@
-import { b as SequenceCommon, H as PropValue, S as SequenceSpec } from './types-CavnUvd5.js';
+import { b as SequenceCommon, O as PropValue, S as SequenceSpec } from './types-DvnXXm33.js';
 import { Scene, Camera, WebGLRenderer } from 'three';
-import { S as Sequence, P as PathRouters } from './Base-CXsMdmJB.js';
+import { S as Sequence, P as PathRouters } from './Base-YqM0Ljvp.js';
 import 'pixi.js';
 
 /** Handed to setup / update / dispose. One per three sequence. */