pixi-effects 0.37.0 → 0.38.0

package/ai/tools/mediaBrowser.mjs

@@ -0,0 +1,47 @@
+// The browser engine of the media commands: the tool's local server, a headless Chrome (the one `check` and `render` use) and the page ai/tools/media-page.html.
+//   await withBrowser({ chrome, inputs: Map(id -> path or URL), outDir }, async ({ call }) => call('frames', { id, times, size, sheet }))
+// `call` runs `window.media.<name>(args)` in the page and returns its JSON, or throws the sentence the page threw.
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+
+export async function withBrowser({ chrome, inputs, outDir, requestLog = null, timeoutSec = 180 }, fn) {
+  const check = await import(pathToFileURL(path.join(HERE, 'check.mjs')).href);
+  const { serveMedia } = await import(pathToFileURL(path.join(HERE, 'media.mjs')).href);
+  const chromePath = chrome ?? check.findChrome();
+  if (!chromePath || !fs.existsSync(chromePath)) throw new Error(`Chrome was not found${chromePath ? ` at ${chromePath}` : ''}: this command decodes video in a browser; install Chrome, or pass --chrome PATH (or set CHROME_PATH) with the right path`);
+  const srv = await serveMedia({ inputs, outDir, requestLog });
+  const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pixi-effects-media-'));
+  let proc = null;
+  try {
+    const launched = await check.launchChrome(chromePath, userDataDir);
+    proc = launched.proc;
+    const cdp = launched.cdp;
+    await cdp.send('Runtime.enable');
+    await cdp.send('Page.enable');
+    await cdp.send('Page.navigate', { url: `http://127.0.0.1:${srv.port}/ai/tools/media-page.html` });
+    const deadline = Date.now() + timeoutSec * 1000;
+    while (!(await cdp.eval('window.__mediaReady === true').catch(() => false))) {
+      if (Date.now() > deadline) throw new Error('the media page did not start in the browser');
+      await check.sleep(100);
+    }
+    const call = async (name, args) => {
+      const run = cdp.eval(`(async () => { try { return { ok: await window.media.${name}(${JSON.stringify(args)}) }; } catch (e) { return { error: String(e && e.message || e) }; } })()`);
+      let timer;
+      const timeout = new Promise((_, bad) => { timer = setTimeout(() => bad(new Error(`timed out after ${timeoutSec} s`)), Math.max(1000, deadline - Date.now())); });
+      try {
+        const r = await Promise.race([run, timeout]);
+        if (r.error) throw new Error(r.error);
+        return r.ok;
+      } finally { clearTimeout(timer); }
+    };
+    return await fn({ call });
+  } finally {
+    try { proc?.kill(); } catch { /* gone */ }
+    await srv.close();
+    try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch { /* held a moment longer */ }
+  }
+}

package/ai/tools/pixi-effects.mjs

@@ -15,11 +15,19 @@ import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { runLookup, LOOKUP_COMMANDS } from './lookup.mjs';
 
+const MEDIA = ['probe', 'trim', 'frames', 'sound', 'audio', 'concat'];          // footage tools: one file, `media.mjs`, which gets the command word too
+
 const TOOLS = { check: 'check.mjs', render: 'render.mjs', view: 'view.mjs' };
 const USAGE = `usage:
   pixi-effects check  <page.html> [--at 3,6] [--out dir]    review a video page: warnings, layout, sound, contact sheet, real export
   pixi-effects render <page.html> -o <file.mp4>             export the video
   pixi-effects view   <page.html>                           look at it in a browser, with a timeline
+  pixi-effects probe  <file|url>                            what is in a video or audio file (codecs, size, duration), with no ffmpeg
+  pixi-effects trim   <file|url> <start> <end> -o <out>     cut a file (by copy when it can) and say the real times
+  pixi-effects frames <file|url> [--at 1,50%,end] [--sheet] pictures of a video at those times
+  pixi-effects sound  <file|url> [--waveform]               loudness, peak, silences of a file's sound
+  pixi-effects audio  <file|url> -o <out.m4a>               the sound of a file, copied out
+  pixi-effects concat <a> <b> … -o <out>                    join clips by copy and say where each starts
   pixi-effects new    <name> [--size 1080x1920] [--duration 20]   a page to start from (<name>.html), 1280x720 and 6 s unless asked
   pixi-effects recipe [id]                                  the tested recipes; with an id, one of them with its code
   pixi-effects help   <word>                                the docs about a word (mask, threeD, keyframes, music …)
@@ -28,7 +36,7 @@ const USAGE = `usage:
 function nearest(word) {
   const d = (a, b) => { const m = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]); for (let j = 1; j <= b.length; j++) m[0][j] = j;
     for (let i = 1; i <= a.length; i++) for (let j = 1; j <= b.length; j++) m[i][j] = Math.min(m[i - 1][j] + 1, m[i][j - 1] + 1, m[i - 1][j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)); return m[a.length][b.length]; };
-  const best = [...Object.keys(TOOLS), ...LOOKUP_COMMANDS].map(k => [k, d(word, k)]).sort((x, y) => x[1] - y[1])[0];
+  const best = [...Object.keys(TOOLS), ...MEDIA, ...LOOKUP_COMMANDS].map(k => [k, d(word, k)]).sort((x, y) => x[1] - y[1])[0];
   return best[1] <= 2 ? best[0] : null;
 }
 
@@ -37,9 +45,10 @@ export function route(argv) {
   const [cmd, ...args] = argv;
   if (!cmd || cmd === '--help' || cmd === '-h') return { usage: USAGE };
   if (TOOLS[cmd]) return { tool: TOOLS[cmd], args };
+  if (MEDIA.includes(cmd)) return { tool: 'media.mjs', args: [cmd, ...args] };
   if (LOOKUP_COMMANDS.includes(cmd)) return { inline: cmd, args };
   const guess = /\.html?$/i.test(cmd) ? 'check' : nearest(cmd);
-  return { error: `pixi-effects: unknown command "${cmd}"${guess ? `; did you mean "${guess}"?` : ''} The commands are: ${[...Object.keys(TOOLS), ...LOOKUP_COMMANDS].join(', ')}.\n${USAGE}` };
+  return { error: `pixi-effects: unknown command "${cmd}"${guess ? `; did you mean "${guess}"?` : ''} The commands are: ${[...Object.keys(TOOLS), ...MEDIA, ...LOOKUP_COMMANDS].join(', ')}.\n${USAGE}` };
 }
 
 const self = fileURLToPath(import.meta.url);

package/dist/{Base-BlA6SeqJ.d.cts → Base-BKKwxavW.d.cts}

@@ -1,5 +1,5 @@
 import { Container } from 'pixi.js';
-import { S as SequenceSpec, C as CompositionShape } from './types-DvnXXm33.cjs';
+import { a as SequenceSpec, C as CompositionShape } from './types-BXi-0iZS.cjs';
 
 /**
  * Resolves a routed keyframe path to a concrete tween target.

package/dist/{Base-YqM0Ljvp.d.ts → Base-ioh_AjLB.d.ts}

@@ -1,5 +1,5 @@
 import { Container } from 'pixi.js';
-import { S as SequenceSpec, C as CompositionShape } from './types-DvnXXm33.js';
+import { a as SequenceSpec, C as CompositionShape } from './types-BXi-0iZS.js';
 
 /**
  * Resolves a routed keyframe path to a concrete tween target.

package/dist/Composition-23KGIJX4.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkFE42PKHP_cjs = require('./chunk-FE42PKHP.cjs');
+require('./chunk-7NXKBRT7.cjs');
+require('./chunk-JN7JHNZR.cjs');
+require('./chunk-3SAS3ZE5.cjs');
+require('./chunk-TWZNOUM7.cjs');
+
+
+
+Object.defineProperty(exports, "CompositionSequence", {
+  enumerable: true,
+  get: function () { return chunkFE42PKHP_cjs.CompositionSequence; }
+});
+//# sourceMappingURL=Composition-23KGIJX4.cjs.map
+//# sourceMappingURL=Composition-23KGIJX4.cjs.map

package/dist/{Composition-MHDI7UNZ.cjs.map → Composition-23KGIJX4.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"Composition-MHDI7UNZ.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Composition-23KGIJX4.cjs"}

package/dist/Composition-5SQXSZNA.js

@@ -0,0 +1,7 @@
+export { CompositionSequence } from './chunk-4CSL5QSL.js';
+import './chunk-UDTLYYGY.js';
+import './chunk-VNP7QCJE.js';
+import './chunk-32MMNDDN.js';
+import './chunk-BXOCEZ4U.js';
+//# sourceMappingURL=Composition-5SQXSZNA.js.map
+//# sourceMappingURL=Composition-5SQXSZNA.js.map

package/dist/{Composition-5KZETM4J.js.map → Composition-5SQXSZNA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"Composition-5KZETM4J.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Composition-5SQXSZNA.js"}

package/dist/Controller.d.cts

@@ -1,6 +1,7 @@
-import { l as Movie } from './Movie-CJN_gvLB.cjs';
+import { M as Movie } from './Movie-CSWUTnMd.cjs';
 import 'pixi.js';
-import './types-DvnXXm33.cjs';
+import './soundEntry-DT13DNt8.cjs';
+import './types-BXi-0iZS.cjs';
 
 /**
  * The look of the bar. Each key sets a CSS custom property on the bar (so you can also set `--mc-accent` … in your own CSS, on the

package/dist/Controller.d.ts

@@ -1,6 +1,7 @@
-import { l as Movie } from './Movie-CfHaGmUP.js';
+import { M as Movie } from './Movie-BtwFI2ne.js';
 import 'pixi.js';
-import './types-DvnXXm33.js';
+import './soundEntry-DT13DNt8.js';
+import './types-BXi-0iZS.js';
 
 /**
  * The look of the bar. Each key sets a CSS custom property on the bar (so you can also set `--mc-accent` … in your own CSS, on the

package/dist/{Movie-CfHaGmUP.d.ts → Movie-BtwFI2ne.d.ts}

@@ -1,5 +1,6 @@
 import { Application } from 'pixi.js';
-import { $ as Stop, c as AssetSpec, m as CompositionSpec } from './types-DvnXXm33.js';
+import { A as AudioReport, a as AudioInspectOptions } from './soundEntry-DT13DNt8.js';
+import { d as Stop, A as AssetSpec, c as CompositionSpec } from './types-BXi-0iZS.js';
 
 type EaseFn = (p: number) => number;
 
@@ -126,165 +127,6 @@ declare class PureTimeline {
  */
 type Timeline = PureTimeline;
 
-/** One note or chord of a track, as a score reader sees it. */
-interface MusicNote {
-    /** Where it starts: beats from the start, and the same moment in seconds (the tempo map applied; swing and humanize are not). */
-    beat: number;
-    time: number;
-    /** How long it is held, in beats and in seconds. */
-    duration: number;
-    seconds: number;
-    /** The bar it starts in (1-based, from `meter`) and its beat inside that bar (1 = the downbeat, 1.5 = the "and" of 1). */
-    bar: number;
-    beatInBar: number;
-    /** The audible MIDI notes (`music.transpose` and the track's `transpose` are in). */
-    midi: number[];
-    /** What the score called it: `Am7`, `c4`, `[c4 e4 g4]`. */
-    name: string;
-    /** More than one note at once. */
-    chord: boolean;
-    /** 0–1 (0.8 normal, 1 accented with `!`, 0.55 soft with `,`). */
-    velocity: number;
-}
-interface MusicTrackEvents {
-    inst: string;
-    /** The track's length in beats and in bars (not a whole number when a bar is short: that is what to look for). */
-    beats: number;
-    bars: number;
-    notes: MusicNote[];
-}
-interface MusicDrumHit {
-    beat: number;
-    time: number;
-    bar: number;
-    beatInBar: number;
-    velocity: number;
-}
-interface MusicDrumEvents {
-    kind: string;
-    hits: MusicDrumHit[];
-}
-interface MusicEvents {
-    /** The tempo at the start. */
-    bpm: number;
-    meter: number;
-    beats: number;
-    bars: number;
-    /** The music without its reverb tail. */
-    seconds: number;
-    tracks: MusicTrackEvents[];
-    /** Every drum that is hit, over all sections, with every hit written out. */
-    drums: MusicDrumEvents[];
-}
-/** What the `check` tool prints about a music layer: lengths in bars (a short track shows), what starts in each bar, where the drums play. */
-interface MusicSummary {
-    bpm: number;
-    meter: number;
-    /** The score set `meter`; when false 4 is only assumed. */
-    meterSet: boolean;
-    beats: number;
-    bars: number;
-    seconds: number;
-    tail: number;
-    tracks: Array<{
-        inst: string;
-        beats: number;
-        bars: number;
-        events: number;
-        perBar: string[];
-    }>;
-    drums: Array<{
-        from: number;
-        to: number;
-        kinds: string[];
-    }>;
-}
-
-interface AudioInspectOptions {
-    /** Width of each loudness window in seconds. Default 0.1. */
-    window?: number;
-    /** The scenes to measure one by one (`movie.inspectAudio()` fills this from the movie's named top-level compositions). Default: the whole movie as one. */
-    scenes?: Array<{
-        name: string;
-        start: number;
-        end: number;
-    }>;
-}
-/** One sound measured ON ITS OWN (not mixed), so overlapping layers do not blur it. */
-interface SoundMeasure {
-    /** Seconds of audio the source has (an sfx: its length; a file: the file's length). */
-    length: number;
-    /** Its own loudest sample, dBFS (before the layer's volume). */
-    peakDb: number;
-    /** Seconds from its start to its loudest sample — the moment to line up with the picture. */
-    loudestAt: number;
-    /** Spectral centroid in Hz: < 500 dark / boomy, 1–4 k mid, > 8 k airy / hissy. */
-    brightnessHz: number;
-}
-interface AudioSourceReport {
-    /** `layer "pop-1"` (or `unnamed audio layer`). */
-    layer: string;
-    /** `sfx "pop"`, `asset "bgm"`, `video "green"`. */
-    source: string;
-    /** Movie time, seconds. */
-    start: number;
-    end: number;
-    /** Loudest sample of the MIX while this source plays, dBFS (−120 = silence). */
-    peakDb: number;
-    sound: SoundMeasure;
-    /**
-     * How far below the loudest sample of the MIX around its own loudest moment this source is, dB (0 = it is the loudest thing there; 20 = the mix is 20 dB louder, so
-     * the source is hardly heard). Absent for a sound inside a remapped composition (its time is not the movie's).
-     */
-    belowMixDb?: number;
-    /** For a `music` layer: its score read back (bars per track, what starts in each bar, the drum spans). */
-    music?: MusicSummary;
-}
-interface AudioReport {
-    duration: number;
-    sampleRate: number;
-    /** Loudest sample of the mix before limiting, dBFS. Above 0 the mix was limited. */
-    peakDb: number;
-    peakAt: number;
-    /** Every audio layer / video soundtrack in the mix, in start order. */
-    sources: AudioSourceReport[];
-    /** The mix over time: one row per window, `t` = window start. */
-    windows: Array<{
-        t: number;
-        rmsDb: number;
-        peakDb: number;
-        brightnessHz: number;
-    }>;
-    /** Problems worth fixing: limiting, clipping, a true peak above 0 dBTP, inaudible layers, sounds cut off by the end of the movie. Read this first. */
-    issues: string[];
-    /** The mix as a whole (ITU-R BS.1770 loudness; `integratedLufs` is null for a mix shorter than 0.4 s or with nothing above −70 LUFS). */
-    loudness: {
-        integratedLufs: number | null;
-        truePeakDb: number;
-        clippedSamples: number;
-        silences: Array<{
-            from: number;
-            to: number;
-        }>;
-    };
-    /** The same measure for each scene (`silent`: nothing above −60 dBFS). */
-    scenes: Array<{
-        name: string;
-        from: number;
-        to: number;
-        lufs: number | null;
-        peakDb: number;
-        silent: boolean;
-    }>;
-    /** When each sound starts: what a waveform marks. */
-    cues: Array<{
-        t: number;
-        name: string;
-    }>;
-    /** Advice, not faults: a mix that is quiet or loud for web video, little headroom, silent stretches. */
-    notes: string[];
-}
-
 interface FontReport {
     /** Text layers none of whose fonts is available here: they are drawn in a fallback. */
     missing: Array<{
@@ -921,4 +763,4 @@ declare class Movie {
     destroy(): Promise<void>;
 }
 
-export { type AudioInspectOptions as A, type TimelineHtmlOptions as B, type ContactSheetOptions as C, type TimelineRow as D, type TimelineSvgOptions as E, type FontReport as F, type TimelineTransition as G, dismissLoader as H, type InspectOptions as I, failLoader as J, resolveLoader as K, type LayerInfo as L, type MusicEvents as M, type OnionSkinOptions as O, type ProgressEvent as P, type RebuildOptions as R, type SnapshotOptions as S, type ThumbnailOptions as T, type VolumeEvent as V, type AudioReport as a, type AudioSourceReport as b, type FrameEvent as c, type InspectReport as d, type IssueGroup as e, type LoadProgressState as f, type LoadStage as g, type LoaderOption as h, type LoopEvent as i, type MotionBlurOptions as j, type MotionBlurSpec as k, Movie as l, type MovieErrorEvent as m, type MovieOptions as n, type MusicDrumEvents as o, type MusicDrumHit as p, type MusicNote as q, type MusicSummary as r, type MusicTrackEvents as s, type RebuildReason as t, type RebuildReport as u, type RenderOptions as v, type ReviewOptions as w, type ReviewReport as x, type SoundMeasure as y, type TimelineData as z };
+export { type ContactSheetOptions as C, type FontReport as F, type InspectOptions as I, type LayerInfo as L, Movie as M, type OnionSkinOptions as O, type ProgressEvent as P, type RebuildOptions as R, type SnapshotOptions as S, type ThumbnailOptions as T, type VolumeEvent as V, type MotionBlurSpec as a, type FrameEvent as b, type InspectReport as c, type IssueGroup as d, type LoadProgressState as e, type LoadStage as f, type LoaderOption as g, type LoopEvent as h, type MotionBlurOptions as i, type MovieErrorEvent as j, type MovieOptions as k, type RebuildReason as l, type RebuildReport as m, type RenderOptions as n, type ReviewOptions as o, type ReviewReport as p, type TimelineData as q, type TimelineHtmlOptions as r, type TimelineRow as s, type TimelineSvgOptions as t, type TimelineTransition as u, dismissLoader as v, failLoader as w, resolveLoader as x };

package/dist/{Movie-CJN_gvLB.d.cts → Movie-CSWUTnMd.d.cts}

@@ -1,5 +1,6 @@
 import { Application } from 'pixi.js';
-import { $ as Stop, c as AssetSpec, m as CompositionSpec } from './types-DvnXXm33.cjs';
+import { A as AudioReport, a as AudioInspectOptions } from './soundEntry-DT13DNt8.cjs';
+import { d as Stop, A as AssetSpec, c as CompositionSpec } from './types-BXi-0iZS.cjs';
 
 type EaseFn = (p: number) => number;
 
@@ -126,165 +127,6 @@ declare class PureTimeline {
  */
 type Timeline = PureTimeline;
 
-/** One note or chord of a track, as a score reader sees it. */
-interface MusicNote {
-    /** Where it starts: beats from the start, and the same moment in seconds (the tempo map applied; swing and humanize are not). */
-    beat: number;
-    time: number;
-    /** How long it is held, in beats and in seconds. */
-    duration: number;
-    seconds: number;
-    /** The bar it starts in (1-based, from `meter`) and its beat inside that bar (1 = the downbeat, 1.5 = the "and" of 1). */
-    bar: number;
-    beatInBar: number;
-    /** The audible MIDI notes (`music.transpose` and the track's `transpose` are in). */
-    midi: number[];
-    /** What the score called it: `Am7`, `c4`, `[c4 e4 g4]`. */
-    name: string;
-    /** More than one note at once. */
-    chord: boolean;
-    /** 0–1 (0.8 normal, 1 accented with `!`, 0.55 soft with `,`). */
-    velocity: number;
-}
-interface MusicTrackEvents {
-    inst: string;
-    /** The track's length in beats and in bars (not a whole number when a bar is short: that is what to look for). */
-    beats: number;
-    bars: number;
-    notes: MusicNote[];
-}
-interface MusicDrumHit {
-    beat: number;
-    time: number;
-    bar: number;
-    beatInBar: number;
-    velocity: number;
-}
-interface MusicDrumEvents {
-    kind: string;
-    hits: MusicDrumHit[];
-}
-interface MusicEvents {
-    /** The tempo at the start. */
-    bpm: number;
-    meter: number;
-    beats: number;
-    bars: number;
-    /** The music without its reverb tail. */
-    seconds: number;
-    tracks: MusicTrackEvents[];
-    /** Every drum that is hit, over all sections, with every hit written out. */
-    drums: MusicDrumEvents[];
-}
-/** What the `check` tool prints about a music layer: lengths in bars (a short track shows), what starts in each bar, where the drums play. */
-interface MusicSummary {
-    bpm: number;
-    meter: number;
-    /** The score set `meter`; when false 4 is only assumed. */
-    meterSet: boolean;
-    beats: number;
-    bars: number;
-    seconds: number;
-    tail: number;
-    tracks: Array<{
-        inst: string;
-        beats: number;
-        bars: number;
-        events: number;
-        perBar: string[];
-    }>;
-    drums: Array<{
-        from: number;
-        to: number;
-        kinds: string[];
-    }>;
-}
-
-interface AudioInspectOptions {
-    /** Width of each loudness window in seconds. Default 0.1. */
-    window?: number;
-    /** The scenes to measure one by one (`movie.inspectAudio()` fills this from the movie's named top-level compositions). Default: the whole movie as one. */
-    scenes?: Array<{
-        name: string;
-        start: number;
-        end: number;
-    }>;
-}
-/** One sound measured ON ITS OWN (not mixed), so overlapping layers do not blur it. */
-interface SoundMeasure {
-    /** Seconds of audio the source has (an sfx: its length; a file: the file's length). */
-    length: number;
-    /** Its own loudest sample, dBFS (before the layer's volume). */
-    peakDb: number;
-    /** Seconds from its start to its loudest sample — the moment to line up with the picture. */
-    loudestAt: number;
-    /** Spectral centroid in Hz: < 500 dark / boomy, 1–4 k mid, > 8 k airy / hissy. */
-    brightnessHz: number;
-}
-interface AudioSourceReport {
-    /** `layer "pop-1"` (or `unnamed audio layer`). */
-    layer: string;
-    /** `sfx "pop"`, `asset "bgm"`, `video "green"`. */
-    source: string;
-    /** Movie time, seconds. */
-    start: number;
-    end: number;
-    /** Loudest sample of the MIX while this source plays, dBFS (−120 = silence). */
-    peakDb: number;
-    sound: SoundMeasure;
-    /**
-     * How far below the loudest sample of the MIX around its own loudest moment this source is, dB (0 = it is the loudest thing there; 20 = the mix is 20 dB louder, so
-     * the source is hardly heard). Absent for a sound inside a remapped composition (its time is not the movie's).
-     */
-    belowMixDb?: number;
-    /** For a `music` layer: its score read back (bars per track, what starts in each bar, the drum spans). */
-    music?: MusicSummary;
-}
-interface AudioReport {
-    duration: number;
-    sampleRate: number;
-    /** Loudest sample of the mix before limiting, dBFS. Above 0 the mix was limited. */
-    peakDb: number;
-    peakAt: number;
-    /** Every audio layer / video soundtrack in the mix, in start order. */
-    sources: AudioSourceReport[];
-    /** The mix over time: one row per window, `t` = window start. */
-    windows: Array<{
-        t: number;
-        rmsDb: number;
-        peakDb: number;
-        brightnessHz: number;
-    }>;
-    /** Problems worth fixing: limiting, clipping, a true peak above 0 dBTP, inaudible layers, sounds cut off by the end of the movie. Read this first. */
-    issues: string[];
-    /** The mix as a whole (ITU-R BS.1770 loudness; `integratedLufs` is null for a mix shorter than 0.4 s or with nothing above −70 LUFS). */
-    loudness: {
-        integratedLufs: number | null;
-        truePeakDb: number;
-        clippedSamples: number;
-        silences: Array<{
-            from: number;
-            to: number;
-        }>;
-    };
-    /** The same measure for each scene (`silent`: nothing above −60 dBFS). */
-    scenes: Array<{
-        name: string;
-        from: number;
-        to: number;
-        lufs: number | null;
-        peakDb: number;
-        silent: boolean;
-    }>;
-    /** When each sound starts: what a waveform marks. */
-    cues: Array<{
-        t: number;
-        name: string;
-    }>;
-    /** Advice, not faults: a mix that is quiet or loud for web video, little headroom, silent stretches. */
-    notes: string[];
-}
-
 interface FontReport {
     /** Text layers none of whose fonts is available here: they are drawn in a fallback. */
     missing: Array<{
@@ -921,4 +763,4 @@ declare class Movie {
     destroy(): Promise<void>;
 }
 
-export { type AudioInspectOptions as A, type TimelineHtmlOptions as B, type ContactSheetOptions as C, type TimelineRow as D, type TimelineSvgOptions as E, type FontReport as F, type TimelineTransition as G, dismissLoader as H, type InspectOptions as I, failLoader as J, resolveLoader as K, type LayerInfo as L, type MusicEvents as M, type OnionSkinOptions as O, type ProgressEvent as P, type RebuildOptions as R, type SnapshotOptions as S, type ThumbnailOptions as T, type VolumeEvent as V, type AudioReport as a, type AudioSourceReport as b, type FrameEvent as c, type InspectReport as d, type IssueGroup as e, type LoadProgressState as f, type LoadStage as g, type LoaderOption as h, type LoopEvent as i, type MotionBlurOptions as j, type MotionBlurSpec as k, Movie as l, type MovieErrorEvent as m, type MovieOptions as n, type MusicDrumEvents as o, type MusicDrumHit as p, type MusicNote as q, type MusicSummary as r, type MusicTrackEvents as s, type RebuildReason as t, type RebuildReport as u, type RenderOptions as v, type ReviewOptions as w, type ReviewReport as x, type SoundMeasure as y, type TimelineData as z };
+export { type ContactSheetOptions as C, type FontReport as F, type InspectOptions as I, type LayerInfo as L, Movie as M, type OnionSkinOptions as O, type ProgressEvent as P, type RebuildOptions as R, type SnapshotOptions as S, type ThumbnailOptions as T, type VolumeEvent as V, type MotionBlurSpec as a, type FrameEvent as b, type InspectReport as c, type IssueGroup as d, type LoadProgressState as e, type LoadStage as f, type LoaderOption as g, type LoopEvent as h, type MotionBlurOptions as i, type MovieErrorEvent as j, type MovieOptions as k, type RebuildReason as l, type RebuildReport as m, type RenderOptions as n, type ReviewOptions as o, type ReviewReport as p, type TimelineData as q, type TimelineHtmlOptions as r, type TimelineRow as s, type TimelineSvgOptions as t, type TimelineTransition as u, dismissLoader as v, failLoader as w, resolveLoader as x };

package/dist/{Spans-FSSO2HGX.js → Spans-4IBQASGK.js}

@@ -1,5 +1,5 @@
-import { CompositionSequence } from './chunk-IPQNT65V.js';
-import { spansMeta, resolveNumber, bindCounterKeyframes, TextSequence } from './chunk-SBR75G73.js';
+import { CompositionSequence } from './chunk-4CSL5QSL.js';
+import { spansMeta, resolveNumber, bindCounterKeyframes, TextSequence } from './chunk-UDTLYYGY.js';
 import './chunk-VNP7QCJE.js';
 import './chunk-32MMNDDN.js';
 import './chunk-BXOCEZ4U.js';
@@ -49,5 +49,5 @@ var SpansSequence = class extends CompositionSequence {
 };
 
 export { SpansSequence };
-//# sourceMappingURL=Spans-FSSO2HGX.js.map
-//# sourceMappingURL=Spans-FSSO2HGX.js.map
+//# sourceMappingURL=Spans-4IBQASGK.js.map
+//# sourceMappingURL=Spans-4IBQASGK.js.map

package/dist/{Spans-FSSO2HGX.js.map → Spans-4IBQASGK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/sequences/Spans.ts"],"names":[],"mappings":";;;;;;;AAQA,IAAM,KAAA,GAAQ,CAAC,KAAA,KAAgD;AAC7D,EAAA,IAAI,CAAC,KAAA,IAAS,EAAE,cAAA,IAAkB,QAAQ,OAAO,KAAA;AACjD,EAAA,MAAM,EAAE,YAAA,EAAc,KAAA,EAAO,GAAG,MAAK,GAAI,KAAA;AACzC,EAAA,OAAO,IAAA;AACT,CAAA;AAEO,IAAM,aAAA,GAAN,cAA4B,mBAAA,CAAoB;AAAA,EACpC,KAAA;AAAA,EACA,MAAA,GAAuB,EAAE,KAAA,EAAO,CAAA,EAAG,cAAc,CAAA,EAAE;AAAA,EAEpE,WAAA,CAAY,IAAA,EAAoB,MAAA,EAAiC,IAAA,EAAwB;AACvF,IAAA,KAAA,CAAM,IAAA,EAAM,QAAQ,IAAI,CAAA;AACxB,IAAA,IAAA,CAAK,KAAA,GAAQ,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAAA,EACjC;AAAA;AAAA,EAGmB,YAAA,GAAyH;AAC1I,IAAA,MAAM,CAAA,GAAI,MAAM,YAAA,EAAa;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO,OAAO,CAAA;AAC/B,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,KAAA,CAAM,CAAA,CAAE,OAA4B,CAAA;AAAA,MAC7C,SAAA,EAAW,EAAE,SAAA,EAAW,GAAA,CAAI,SAAO,EAAE,GAAG,EAAA,EAAI,GAAA,EAAK,KAAA,CAAM,EAAA,CAAG,GAAG,CAAA,EAAG,EAAA,EAAI,KAAA,CAAM,EAAA,CAAG,EAAE,CAAA,EAAG,MAAM,KAAA,CAAM,EAAA,CAAG,IAAI,CAAA,EAAE,CAAE;AAAA,KAC3G;AAAA,EACF;AAAA,EAES,YAAA,CAAa,QAAA,EAAoB,MAAA,GAAS,CAAA,EAAS;AAC1D,IAAA,KAAA,CAAM,YAAA,CAAa,UAAU,MAAM,CAAA;AACnC,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO;AACxB,IAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,EAAM;AACzB,IAAA,MAAM,KAAA,GAAS,IAAA,CAAK,IAAA,CAAK,OAAA,EAAiD,YAAA;AAC1E,IAAA,IAAA,CAAK,OAAO,YAAA,GAAe,KAAA,KAAU,SAAY,CAAA,GAAI,aAAA,CAAc,OAAO,KAAK,CAAA;AAC/E,IAAA,oBAAA,CAAqB,UAAU,IAAA,CAAK,MAAA,EAAQ,gBAAgB,MAAM,IAAA,CAAK,aAAY,EAAG,IAAA,CAAK,IAAA,CAAK,SAAA,IAAa,EAAC,EAAG,IAAA,CAAK,UAAW,MAAA,GAAS,IAAA,CAAK,IAAI,KAAK,CAAA;AACxJ,IAAA,IAAA,CAAK,WAAA,EAAY;AAAA,EACnB;AAAA;AAAA,EAGQ,WAAA,GAAoB;AAC1B,IAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAO,MAAA;AAC3B,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,YAAY,CAAC,CAAA;AAC9D,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,SAAA,EAAW;AAClC,MAAA,IAAI,EAAE,iBAAiB,YAAA,CAAA,EAAe;AACtC,MAAA,MAAM,CAAA,GAAI,OAAO,CAAA,EAAG,CAAA;AACpB,MAAA,IAAI,CAAA,EAAG,KAAA,CAAM,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAA,CAAE,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAC,CAAC,CAAA;AAAA,IAC/E;AAAA,EACF;AACF","file":"Spans-FSSO2HGX.js","sourcesContent":["// The sequence behind a text layer with `spans`: a composition of ordinary text layers (see src/text/spans.ts) that also owns the typewriter\n// (`visibleChars`) of the whole text: it counts over every character of every piece, and tells each piece how many of its own to show.\nimport { CompositionSequence } from './Composition';\nimport { TextSequence, bindCounterKeyframes, resolveNumber, type CounterState } from './Text';\nimport { spansMeta, type SpansMeta } from '../text/spans';\nimport type { CompositionShape, SequenceSpec, Props } from '../types';\nimport type { Timeline } from '../core/timelineEngine';\n\nconst strip = (props: Props | undefined): Props | undefined => {\n  if (!props || !('visibleChars' in props)) return props;\n  const { visibleChars: _gone, ...rest } = props as Record<string, unknown>;\n  return rest as unknown as Props;\n};\n\nexport class SpansSequence extends CompositionSequence {\n  private readonly _meta: SpansMeta | undefined;\n  private readonly _count: CounterState = { value: 0, visibleChars: 0 };\n\n  constructor(spec: SequenceSpec, parent: CompositionShape | null, root: CompositionShape) {\n    super(spec, parent, root);\n    this._meta = spansMeta.get(spec);\n  }\n\n  /** `visibleChars` is the group's own counter, not a property to write on the container. */\n  protected override displayProps(): { initial: CompositionSequence['spec']['initial']; keyframes: CompositionSequence['spec']['keyframes'] } {\n    const p = super.displayProps();\n    if (!this._meta?.typed) return p;\n    return {\n      initial: strip(p.initial as Props | undefined) as never,\n      keyframes: p.keyframes?.map(kf => ({ ...kf, set: strip(kf.set), to: strip(kf.to), from: strip(kf.from) })),\n    };\n  }\n\n  override bindTimeline(timeline: Timeline, offset = 0): void {\n    super.bindTimeline(timeline, offset);\n    if (!this._meta?.typed) return;\n    const scope = this.scope();\n    const first = (this.spec.initial as Record<string, unknown> | undefined)?.visibleChars;\n    this._count.visibleChars = first === undefined ? 0 : resolveNumber(first, scope);          // like a text: it starts at 0 once it is animated\n    bindCounterKeyframes(timeline, this._count, 'visibleChars', () => this._distribute(), this.spec.keyframes ?? [], this.duration!, offset + this.at, scope);\n    this._distribute();\n  }\n\n  /** Every piece shows its part of the first N characters of the whole text. */\n  private _distribute(): void {\n    const pieces = this._meta!.pieces;\n    const total = Math.max(0, Math.floor(this._count.visibleChars));\n    let i = 0;\n    for (const child of this._children) {\n      if (!(child instanceof TextSequence)) continue;\n      const p = pieces[i++];\n      if (p) child.setVisibleChars(Math.min(p.length, Math.max(0, total - p.start)));\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../src/sequences/Spans.ts"],"names":[],"mappings":";;;;;;;AAQA,IAAM,KAAA,GAAQ,CAAC,KAAA,KAAgD;AAC7D,EAAA,IAAI,CAAC,KAAA,IAAS,EAAE,cAAA,IAAkB,QAAQ,OAAO,KAAA;AACjD,EAAA,MAAM,EAAE,YAAA,EAAc,KAAA,EAAO,GAAG,MAAK,GAAI,KAAA;AACzC,EAAA,OAAO,IAAA;AACT,CAAA;AAEO,IAAM,aAAA,GAAN,cAA4B,mBAAA,CAAoB;AAAA,EACpC,KAAA;AAAA,EACA,MAAA,GAAuB,EAAE,KAAA,EAAO,CAAA,EAAG,cAAc,CAAA,EAAE;AAAA,EAEpE,WAAA,CAAY,IAAA,EAAoB,MAAA,EAAiC,IAAA,EAAwB;AACvF,IAAA,KAAA,CAAM,IAAA,EAAM,QAAQ,IAAI,CAAA;AACxB,IAAA,IAAA,CAAK,KAAA,GAAQ,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAAA,EACjC;AAAA;AAAA,EAGmB,YAAA,GAAyH;AAC1I,IAAA,MAAM,CAAA,GAAI,MAAM,YAAA,EAAa;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO,OAAO,CAAA;AAC/B,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,KAAA,CAAM,CAAA,CAAE,OAA4B,CAAA;AAAA,MAC7C,SAAA,EAAW,EAAE,SAAA,EAAW,GAAA,CAAI,SAAO,EAAE,GAAG,EAAA,EAAI,GAAA,EAAK,KAAA,CAAM,EAAA,CAAG,GAAG,CAAA,EAAG,EAAA,EAAI,KAAA,CAAM,EAAA,CAAG,EAAE,CAAA,EAAG,MAAM,KAAA,CAAM,EAAA,CAAG,IAAI,CAAA,EAAE,CAAE;AAAA,KAC3G;AAAA,EACF;AAAA,EAES,YAAA,CAAa,QAAA,EAAoB,MAAA,GAAS,CAAA,EAAS;AAC1D,IAAA,KAAA,CAAM,YAAA,CAAa,UAAU,MAAM,CAAA;AACnC,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO;AACxB,IAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,EAAM;AACzB,IAAA,MAAM,KAAA,GAAS,IAAA,CAAK,IAAA,CAAK,OAAA,EAAiD,YAAA;AAC1E,IAAA,IAAA,CAAK,OAAO,YAAA,GAAe,KAAA,KAAU,SAAY,CAAA,GAAI,aAAA,CAAc,OAAO,KAAK,CAAA;AAC/E,IAAA,oBAAA,CAAqB,UAAU,IAAA,CAAK,MAAA,EAAQ,gBAAgB,MAAM,IAAA,CAAK,aAAY,EAAG,IAAA,CAAK,IAAA,CAAK,SAAA,IAAa,EAAC,EAAG,IAAA,CAAK,UAAW,MAAA,GAAS,IAAA,CAAK,IAAI,KAAK,CAAA;AACxJ,IAAA,IAAA,CAAK,WAAA,EAAY;AAAA,EACnB;AAAA;AAAA,EAGQ,WAAA,GAAoB;AAC1B,IAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAO,MAAA;AAC3B,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,YAAY,CAAC,CAAA;AAC9D,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,SAAA,EAAW;AAClC,MAAA,IAAI,EAAE,iBAAiB,YAAA,CAAA,EAAe;AACtC,MAAA,MAAM,CAAA,GAAI,OAAO,CAAA,EAAG,CAAA;AACpB,MAAA,IAAI,CAAA,EAAG,KAAA,CAAM,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAA,CAAE,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAC,CAAC,CAAA;AAAA,IAC/E;AAAA,EACF;AACF","file":"Spans-4IBQASGK.js","sourcesContent":["// The sequence behind a text layer with `spans`: a composition of ordinary text layers (see src/text/spans.ts) that also owns the typewriter\n// (`visibleChars`) of the whole text: it counts over every character of every piece, and tells each piece how many of its own to show.\nimport { CompositionSequence } from './Composition';\nimport { TextSequence, bindCounterKeyframes, resolveNumber, type CounterState } from './Text';\nimport { spansMeta, type SpansMeta } from '../text/spans';\nimport type { CompositionShape, SequenceSpec, Props } from '../types';\nimport type { Timeline } from '../core/timelineEngine';\n\nconst strip = (props: Props | undefined): Props | undefined => {\n  if (!props || !('visibleChars' in props)) return props;\n  const { visibleChars: _gone, ...rest } = props as Record<string, unknown>;\n  return rest as unknown as Props;\n};\n\nexport class SpansSequence extends CompositionSequence {\n  private readonly _meta: SpansMeta | undefined;\n  private readonly _count: CounterState = { value: 0, visibleChars: 0 };\n\n  constructor(spec: SequenceSpec, parent: CompositionShape | null, root: CompositionShape) {\n    super(spec, parent, root);\n    this._meta = spansMeta.get(spec);\n  }\n\n  /** `visibleChars` is the group's own counter, not a property to write on the container. */\n  protected override displayProps(): { initial: CompositionSequence['spec']['initial']; keyframes: CompositionSequence['spec']['keyframes'] } {\n    const p = super.displayProps();\n    if (!this._meta?.typed) return p;\n    return {\n      initial: strip(p.initial as Props | undefined) as never,\n      keyframes: p.keyframes?.map(kf => ({ ...kf, set: strip(kf.set), to: strip(kf.to), from: strip(kf.from) })),\n    };\n  }\n\n  override bindTimeline(timeline: Timeline, offset = 0): void {\n    super.bindTimeline(timeline, offset);\n    if (!this._meta?.typed) return;\n    const scope = this.scope();\n    const first = (this.spec.initial as Record<string, unknown> | undefined)?.visibleChars;\n    this._count.visibleChars = first === undefined ? 0 : resolveNumber(first, scope);          // like a text: it starts at 0 once it is animated\n    bindCounterKeyframes(timeline, this._count, 'visibleChars', () => this._distribute(), this.spec.keyframes ?? [], this.duration!, offset + this.at, scope);\n    this._distribute();\n  }\n\n  /** Every piece shows its part of the first N characters of the whole text. */\n  private _distribute(): void {\n    const pieces = this._meta!.pieces;\n    const total = Math.max(0, Math.floor(this._count.visibleChars));\n    let i = 0;\n    for (const child of this._children) {\n      if (!(child instanceof TextSequence)) continue;\n      const p = pieces[i++];\n      if (p) child.setVisibleChars(Math.min(p.length, Math.max(0, total - p.start)));\n    }\n  }\n}\n"]}

package/dist/{Spans-WVJH77BW.cjs → Spans-WJFPHMSQ.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkMJMOPWMK_cjs = require('./chunk-MJMOPWMK.cjs');
-var chunkQHIOOK5S_cjs = require('./chunk-QHIOOK5S.cjs');
+var chunkFE42PKHP_cjs = require('./chunk-FE42PKHP.cjs');
+var chunk7NXKBRT7_cjs = require('./chunk-7NXKBRT7.cjs');
 require('./chunk-JN7JHNZR.cjs');
 require('./chunk-3SAS3ZE5.cjs');
 require('./chunk-TWZNOUM7.cjs');
@@ -12,12 +12,12 @@ var strip = (props) => {
   const { visibleChars: _gone, ...rest } = props;
   return rest;
 };
-var SpansSequence = class extends chunkMJMOPWMK_cjs.CompositionSequence {
+var SpansSequence = class extends chunkFE42PKHP_cjs.CompositionSequence {
   _meta;
   _count = { value: 0, visibleChars: 0 };
   constructor(spec, parent, root) {
     super(spec, parent, root);
-    this._meta = chunkQHIOOK5S_cjs.spansMeta.get(spec);
+    this._meta = chunk7NXKBRT7_cjs.spansMeta.get(spec);
   }
   /** `visibleChars` is the group's own counter, not a property to write on the container. */
   displayProps() {
@@ -33,8 +33,8 @@ var SpansSequence = class extends chunkMJMOPWMK_cjs.CompositionSequence {
     if (!this._meta?.typed) return;
     const scope = this.scope();
     const first = this.spec.initial?.visibleChars;
-    this._count.visibleChars = first === void 0 ? 0 : chunkQHIOOK5S_cjs.resolveNumber(first, scope);
-    chunkQHIOOK5S_cjs.bindCounterKeyframes(timeline, this._count, "visibleChars", () => this._distribute(), this.spec.keyframes ?? [], this.duration, offset + this.at, scope);
+    this._count.visibleChars = first === void 0 ? 0 : chunk7NXKBRT7_cjs.resolveNumber(first, scope);
+    chunk7NXKBRT7_cjs.bindCounterKeyframes(timeline, this._count, "visibleChars", () => this._distribute(), this.spec.keyframes ?? [], this.duration, offset + this.at, scope);
     this._distribute();
   }
   /** Every piece shows its part of the first N characters of the whole text. */
@@ -43,7 +43,7 @@ var SpansSequence = class extends chunkMJMOPWMK_cjs.CompositionSequence {
     const total = Math.max(0, Math.floor(this._count.visibleChars));
     let i = 0;
     for (const child of this._children) {
-      if (!(child instanceof chunkQHIOOK5S_cjs.TextSequence)) continue;
+      if (!(child instanceof chunk7NXKBRT7_cjs.TextSequence)) continue;
       const p = pieces[i++];
       if (p) child.setVisibleChars(Math.min(p.length, Math.max(0, total - p.start)));
     }
@@ -51,5 +51,5 @@ var SpansSequence = class extends chunkMJMOPWMK_cjs.CompositionSequence {
 };
 
 exports.SpansSequence = SpansSequence;
-//# sourceMappingURL=Spans-WVJH77BW.cjs.map
-//# sourceMappingURL=Spans-WVJH77BW.cjs.map
+//# sourceMappingURL=Spans-WJFPHMSQ.cjs.map
+//# sourceMappingURL=Spans-WJFPHMSQ.cjs.map

package/dist/{Spans-WVJH77BW.cjs.map → Spans-WJFPHMSQ.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/sequences/Spans.ts"],"names":["CompositionSequence","spansMeta","resolveNumber","bindCounterKeyframes","TextSequence"],"mappings":";;;;;;;;;AAQA,IAAM,KAAA,GAAQ,CAAC,KAAA,KAAgD;AAC7D,EAAA,IAAI,CAAC,KAAA,IAAS,EAAE,cAAA,IAAkB,QAAQ,OAAO,KAAA;AACjD,EAAA,MAAM,EAAE,YAAA,EAAc,KAAA,EAAO,GAAG,MAAK,GAAI,KAAA;AACzC,EAAA,OAAO,IAAA;AACT,CAAA;AAEO,IAAM,aAAA,GAAN,cAA4BA,qCAAA,CAAoB;AAAA,EACpC,KAAA;AAAA,EACA,MAAA,GAAuB,EAAE,KAAA,EAAO,CAAA,EAAG,cAAc,CAAA,EAAE;AAAA,EAEpE,WAAA,CAAY,IAAA,EAAoB,MAAA,EAAiC,IAAA,EAAwB;AACvF,IAAA,KAAA,CAAM,IAAA,EAAM,QAAQ,IAAI,CAAA;AACxB,IAAA,IAAA,CAAK,KAAA,GAAQC,2BAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAAA,EACjC;AAAA;AAAA,EAGmB,YAAA,GAAyH;AAC1I,IAAA,MAAM,CAAA,GAAI,MAAM,YAAA,EAAa;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO,OAAO,CAAA;AAC/B,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,KAAA,CAAM,CAAA,CAAE,OAA4B,CAAA;AAAA,MAC7C,SAAA,EAAW,EAAE,SAAA,EAAW,GAAA,CAAI,SAAO,EAAE,GAAG,EAAA,EAAI,GAAA,EAAK,KAAA,CAAM,EAAA,CAAG,GAAG,CAAA,EAAG,EAAA,EAAI,KAAA,CAAM,EAAA,CAAG,EAAE,CAAA,EAAG,MAAM,KAAA,CAAM,EAAA,CAAG,IAAI,CAAA,EAAE,CAAE;AAAA,KAC3G;AAAA,EACF;AAAA,EAES,YAAA,CAAa,QAAA,EAAoB,MAAA,GAAS,CAAA,EAAS;AAC1D,IAAA,KAAA,CAAM,YAAA,CAAa,UAAU,MAAM,CAAA;AACnC,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO;AACxB,IAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,EAAM;AACzB,IAAA,MAAM,KAAA,GAAS,IAAA,CAAK,IAAA,CAAK,OAAA,EAAiD,YAAA;AAC1E,IAAA,IAAA,CAAK,OAAO,YAAA,GAAe,KAAA,KAAU,SAAY,CAAA,GAAIC,+BAAA,CAAc,OAAO,KAAK,CAAA;AAC/E,IAAAC,sCAAA,CAAqB,UAAU,IAAA,CAAK,MAAA,EAAQ,gBAAgB,MAAM,IAAA,CAAK,aAAY,EAAG,IAAA,CAAK,IAAA,CAAK,SAAA,IAAa,EAAC,EAAG,IAAA,CAAK,UAAW,MAAA,GAAS,IAAA,CAAK,IAAI,KAAK,CAAA;AACxJ,IAAA,IAAA,CAAK,WAAA,EAAY;AAAA,EACnB;AAAA;AAAA,EAGQ,WAAA,GAAoB;AAC1B,IAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAO,MAAA;AAC3B,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,YAAY,CAAC,CAAA;AAC9D,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,SAAA,EAAW;AAClC,MAAA,IAAI,EAAE,iBAAiBC,8BAAA,CAAA,EAAe;AACtC,MAAA,MAAM,CAAA,GAAI,OAAO,CAAA,EAAG,CAAA;AACpB,MAAA,IAAI,CAAA,EAAG,KAAA,CAAM,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAA,CAAE,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAC,CAAC,CAAA;AAAA,IAC/E;AAAA,EACF;AACF","file":"Spans-WVJH77BW.cjs","sourcesContent":["// The sequence behind a text layer with `spans`: a composition of ordinary text layers (see src/text/spans.ts) that also owns the typewriter\n// (`visibleChars`) of the whole text: it counts over every character of every piece, and tells each piece how many of its own to show.\nimport { CompositionSequence } from './Composition';\nimport { TextSequence, bindCounterKeyframes, resolveNumber, type CounterState } from './Text';\nimport { spansMeta, type SpansMeta } from '../text/spans';\nimport type { CompositionShape, SequenceSpec, Props } from '../types';\nimport type { Timeline } from '../core/timelineEngine';\n\nconst strip = (props: Props | undefined): Props | undefined => {\n  if (!props || !('visibleChars' in props)) return props;\n  const { visibleChars: _gone, ...rest } = props as Record<string, unknown>;\n  return rest as unknown as Props;\n};\n\nexport class SpansSequence extends CompositionSequence {\n  private readonly _meta: SpansMeta | undefined;\n  private readonly _count: CounterState = { value: 0, visibleChars: 0 };\n\n  constructor(spec: SequenceSpec, parent: CompositionShape | null, root: CompositionShape) {\n    super(spec, parent, root);\n    this._meta = spansMeta.get(spec);\n  }\n\n  /** `visibleChars` is the group's own counter, not a property to write on the container. */\n  protected override displayProps(): { initial: CompositionSequence['spec']['initial']; keyframes: CompositionSequence['spec']['keyframes'] } {\n    const p = super.displayProps();\n    if (!this._meta?.typed) return p;\n    return {\n      initial: strip(p.initial as Props | undefined) as never,\n      keyframes: p.keyframes?.map(kf => ({ ...kf, set: strip(kf.set), to: strip(kf.to), from: strip(kf.from) })),\n    };\n  }\n\n  override bindTimeline(timeline: Timeline, offset = 0): void {\n    super.bindTimeline(timeline, offset);\n    if (!this._meta?.typed) return;\n    const scope = this.scope();\n    const first = (this.spec.initial as Record<string, unknown> | undefined)?.visibleChars;\n    this._count.visibleChars = first === undefined ? 0 : resolveNumber(first, scope);          // like a text: it starts at 0 once it is animated\n    bindCounterKeyframes(timeline, this._count, 'visibleChars', () => this._distribute(), this.spec.keyframes ?? [], this.duration!, offset + this.at, scope);\n    this._distribute();\n  }\n\n  /** Every piece shows its part of the first N characters of the whole text. */\n  private _distribute(): void {\n    const pieces = this._meta!.pieces;\n    const total = Math.max(0, Math.floor(this._count.visibleChars));\n    let i = 0;\n    for (const child of this._children) {\n      if (!(child instanceof TextSequence)) continue;\n      const p = pieces[i++];\n      if (p) child.setVisibleChars(Math.min(p.length, Math.max(0, total - p.start)));\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../src/sequences/Spans.ts"],"names":["CompositionSequence","spansMeta","resolveNumber","bindCounterKeyframes","TextSequence"],"mappings":";;;;;;;;;AAQA,IAAM,KAAA,GAAQ,CAAC,KAAA,KAAgD;AAC7D,EAAA,IAAI,CAAC,KAAA,IAAS,EAAE,cAAA,IAAkB,QAAQ,OAAO,KAAA;AACjD,EAAA,MAAM,EAAE,YAAA,EAAc,KAAA,EAAO,GAAG,MAAK,GAAI,KAAA;AACzC,EAAA,OAAO,IAAA;AACT,CAAA;AAEO,IAAM,aAAA,GAAN,cAA4BA,qCAAA,CAAoB;AAAA,EACpC,KAAA;AAAA,EACA,MAAA,GAAuB,EAAE,KAAA,EAAO,CAAA,EAAG,cAAc,CAAA,EAAE;AAAA,EAEpE,WAAA,CAAY,IAAA,EAAoB,MAAA,EAAiC,IAAA,EAAwB;AACvF,IAAA,KAAA,CAAM,IAAA,EAAM,QAAQ,IAAI,CAAA;AACxB,IAAA,IAAA,CAAK,KAAA,GAAQC,2BAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAAA,EACjC;AAAA;AAAA,EAGmB,YAAA,GAAyH;AAC1I,IAAA,MAAM,CAAA,GAAI,MAAM,YAAA,EAAa;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO,OAAO,CAAA;AAC/B,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,KAAA,CAAM,CAAA,CAAE,OAA4B,CAAA;AAAA,MAC7C,SAAA,EAAW,EAAE,SAAA,EAAW,GAAA,CAAI,SAAO,EAAE,GAAG,EAAA,EAAI,GAAA,EAAK,KAAA,CAAM,EAAA,CAAG,GAAG,CAAA,EAAG,EAAA,EAAI,KAAA,CAAM,EAAA,CAAG,EAAE,CAAA,EAAG,MAAM,KAAA,CAAM,EAAA,CAAG,IAAI,CAAA,EAAE,CAAE;AAAA,KAC3G;AAAA,EACF;AAAA,EAES,YAAA,CAAa,QAAA,EAAoB,MAAA,GAAS,CAAA,EAAS;AAC1D,IAAA,KAAA,CAAM,YAAA,CAAa,UAAU,MAAM,CAAA;AACnC,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,KAAA,EAAO;AACxB,IAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,EAAM;AACzB,IAAA,MAAM,KAAA,GAAS,IAAA,CAAK,IAAA,CAAK,OAAA,EAAiD,YAAA;AAC1E,IAAA,IAAA,CAAK,OAAO,YAAA,GAAe,KAAA,KAAU,SAAY,CAAA,GAAIC,+BAAA,CAAc,OAAO,KAAK,CAAA;AAC/E,IAAAC,sCAAA,CAAqB,UAAU,IAAA,CAAK,MAAA,EAAQ,gBAAgB,MAAM,IAAA,CAAK,aAAY,EAAG,IAAA,CAAK,IAAA,CAAK,SAAA,IAAa,EAAC,EAAG,IAAA,CAAK,UAAW,MAAA,GAAS,IAAA,CAAK,IAAI,KAAK,CAAA;AACxJ,IAAA,IAAA,CAAK,WAAA,EAAY;AAAA,EACnB;AAAA;AAAA,EAGQ,WAAA,GAAoB;AAC1B,IAAA,MAAM,MAAA,GAAS,KAAK,KAAA,CAAO,MAAA;AAC3B,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,IAAA,CAAK,MAAA,CAAO,YAAY,CAAC,CAAA;AAC9D,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,SAAA,EAAW;AAClC,MAAA,IAAI,EAAE,iBAAiBC,8BAAA,CAAA,EAAe;AACtC,MAAA,MAAM,CAAA,GAAI,OAAO,CAAA,EAAG,CAAA;AACpB,MAAA,IAAI,CAAA,EAAG,KAAA,CAAM,eAAA,CAAgB,IAAA,CAAK,IAAI,CAAA,CAAE,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAC,CAAC,CAAA;AAAA,IAC/E;AAAA,EACF;AACF","file":"Spans-WJFPHMSQ.cjs","sourcesContent":["// The sequence behind a text layer with `spans`: a composition of ordinary text layers (see src/text/spans.ts) that also owns the typewriter\n// (`visibleChars`) of the whole text: it counts over every character of every piece, and tells each piece how many of its own to show.\nimport { CompositionSequence } from './Composition';\nimport { TextSequence, bindCounterKeyframes, resolveNumber, type CounterState } from './Text';\nimport { spansMeta, type SpansMeta } from '../text/spans';\nimport type { CompositionShape, SequenceSpec, Props } from '../types';\nimport type { Timeline } from '../core/timelineEngine';\n\nconst strip = (props: Props | undefined): Props | undefined => {\n  if (!props || !('visibleChars' in props)) return props;\n  const { visibleChars: _gone, ...rest } = props as Record<string, unknown>;\n  return rest as unknown as Props;\n};\n\nexport class SpansSequence extends CompositionSequence {\n  private readonly _meta: SpansMeta | undefined;\n  private readonly _count: CounterState = { value: 0, visibleChars: 0 };\n\n  constructor(spec: SequenceSpec, parent: CompositionShape | null, root: CompositionShape) {\n    super(spec, parent, root);\n    this._meta = spansMeta.get(spec);\n  }\n\n  /** `visibleChars` is the group's own counter, not a property to write on the container. */\n  protected override displayProps(): { initial: CompositionSequence['spec']['initial']; keyframes: CompositionSequence['spec']['keyframes'] } {\n    const p = super.displayProps();\n    if (!this._meta?.typed) return p;\n    return {\n      initial: strip(p.initial as Props | undefined) as never,\n      keyframes: p.keyframes?.map(kf => ({ ...kf, set: strip(kf.set), to: strip(kf.to), from: strip(kf.from) })),\n    };\n  }\n\n  override bindTimeline(timeline: Timeline, offset = 0): void {\n    super.bindTimeline(timeline, offset);\n    if (!this._meta?.typed) return;\n    const scope = this.scope();\n    const first = (this.spec.initial as Record<string, unknown> | undefined)?.visibleChars;\n    this._count.visibleChars = first === undefined ? 0 : resolveNumber(first, scope);          // like a text: it starts at 0 once it is animated\n    bindCounterKeyframes(timeline, this._count, 'visibleChars', () => this._distribute(), this.spec.keyframes ?? [], this.duration!, offset + this.at, scope);\n    this._distribute();\n  }\n\n  /** Every piece shows its part of the first N characters of the whole text. */\n  private _distribute(): void {\n    const pieces = this._meta!.pieces;\n    const total = Math.max(0, Math.floor(this._count.visibleChars));\n    let i = 0;\n    for (const child of this._children) {\n      if (!(child instanceof TextSequence)) continue;\n      const p = pieces[i++];\n      if (p) child.setVisibleChars(Math.min(p.length, Math.max(0, total - p.start)));\n    }\n  }\n}\n"]}