pixi-effects 0.36.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-CmiFiwQM.d.cts → Base-BKKwxavW.d.cts}

@@ -1,5 +1,5 @@
 import { Container } from 'pixi.js';
-import { S as SequenceSpec, C as CompositionShape } from './types-B6zDTU2V.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-CdF7AJop.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-B6zDTU2V.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-XRLYR6GL.cjs.map → Composition-23KGIJX4.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"Composition-XRLYR6GL.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-BMRCE5FH.js.map → Composition-5SQXSZNA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"Composition-BMRCE5FH.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-Bh1HPdKw.cjs';
+import { M as Movie } from './Movie-CSWUTnMd.cjs';
 import 'pixi.js';
-import './types-B6zDTU2V.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-D5WFfZdZ.js';
+import { M as Movie } from './Movie-BtwFI2ne.js';
 import 'pixi.js';
-import './types-B6zDTU2V.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-D5WFfZdZ.d.ts → Movie-BtwFI2ne.d.ts}

@@ -1,5 +1,6 @@
 import { Application } from 'pixi.js';
-import { Z as Stop, c as AssetSpec, k as CompositionSpec } from './types-B6zDTU2V.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<{
@@ -297,12 +139,25 @@ interface FontReport {
     failedUnused: string[];
 }
 
+/** One canvas layer as the check saw it. */
+interface CanvasRow {
+    name: string;
+    /** The moments (seconds of the layer's own time) it was drawn at, in two orders. */
+    moments: number[];
+    /** The usual time of one draw on the CPU canvas of the check (the browser's GPU may be faster or slower). */
+    drawMs: number;
+    ok: boolean;
+    /** Why not, in a sentence (empty when ok). */
+    problem: string;
+}
+
 /** One kind of issue, with how many frames it was seen in. Issues that differ only by numbers are one kind. */
 interface IssueGroup {
     message: string;
     count: number;
     firstFrame: number;
-    lastFrame: number;
+    lastFrame: number; /** `'canvas'`: a canvas layer that does not draw the same picture for the same time (not about the layout; `check` lists it under its own heading). */
+    kind?: 'canvas';
 }
 interface ReviewOptions {
     /** Moments to resolve and report: `3.5`, `50%`, `f120`, `title@end` (comma-separated). */
@@ -317,6 +172,8 @@ interface ReviewReport {
     problems: IssueGroup[];
     /** Text overlaps and fonts that are not available: often intentional, look at them on the contact sheet. */
     review: IssueGroup[];
+    /** Every canvas layer as the determinism check saw it (a failing one is also in `problems` with `kind: 'canvas'`). */
+    canvas: CanvasRow[];
     fonts: FontReport;
     /** The sound as numbers (`movie.inspectAudio()`), or null for a movie with no audio. */
     audio: AudioReport | null;
@@ -817,6 +674,10 @@ declare class Movie {
      * the canvas, cut by an edge, empty, or overlapping other text. Seeks there and stays there.
      */
     inspect(frame?: number, opts?: InspectOptions): Promise<InspectReport>;
+    /** The canvas layers whose same frame is not the same picture (what `check` reports as a problem): one sentence each. */
+    canvasProblems(): string[];
+    /** Every canvas layer as the determinism check saw it: the moments drawn, the usual time of a draw in ms, and whether the same time gave the same picture (`check` prints it even when all pass). */
+    canvasReport(): CanvasRow[];
     /**
      * Every layer as a row with absolute start / end / keyframe times (seconds), plus the transition windows. Runs of
      * similar layers (`pop-1` … `pop-12`) are one row with a `parts` span each. Read it, or draw it with `timelineChart()`.
@@ -902,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-Bh1HPdKw.d.cts → Movie-CSWUTnMd.d.cts}

@@ -1,5 +1,6 @@
 import { Application } from 'pixi.js';
-import { Z as Stop, c as AssetSpec, k as CompositionSpec } from './types-B6zDTU2V.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<{
@@ -297,12 +139,25 @@ interface FontReport {
     failedUnused: string[];
 }
 
+/** One canvas layer as the check saw it. */
+interface CanvasRow {
+    name: string;
+    /** The moments (seconds of the layer's own time) it was drawn at, in two orders. */
+    moments: number[];
+    /** The usual time of one draw on the CPU canvas of the check (the browser's GPU may be faster or slower). */
+    drawMs: number;
+    ok: boolean;
+    /** Why not, in a sentence (empty when ok). */
+    problem: string;
+}
+
 /** One kind of issue, with how many frames it was seen in. Issues that differ only by numbers are one kind. */
 interface IssueGroup {
     message: string;
     count: number;
     firstFrame: number;
-    lastFrame: number;
+    lastFrame: number; /** `'canvas'`: a canvas layer that does not draw the same picture for the same time (not about the layout; `check` lists it under its own heading). */
+    kind?: 'canvas';
 }
 interface ReviewOptions {
     /** Moments to resolve and report: `3.5`, `50%`, `f120`, `title@end` (comma-separated). */
@@ -317,6 +172,8 @@ interface ReviewReport {
     problems: IssueGroup[];
     /** Text overlaps and fonts that are not available: often intentional, look at them on the contact sheet. */
     review: IssueGroup[];
+    /** Every canvas layer as the determinism check saw it (a failing one is also in `problems` with `kind: 'canvas'`). */
+    canvas: CanvasRow[];
     fonts: FontReport;
     /** The sound as numbers (`movie.inspectAudio()`), or null for a movie with no audio. */
     audio: AudioReport | null;
@@ -817,6 +674,10 @@ declare class Movie {
      * the canvas, cut by an edge, empty, or overlapping other text. Seeks there and stays there.
      */
     inspect(frame?: number, opts?: InspectOptions): Promise<InspectReport>;
+    /** The canvas layers whose same frame is not the same picture (what `check` reports as a problem): one sentence each. */
+    canvasProblems(): string[];
+    /** Every canvas layer as the determinism check saw it: the moments drawn, the usual time of a draw in ms, and whether the same time gave the same picture (`check` prints it even when all pass). */
+    canvasReport(): CanvasRow[];
     /**
      * Every layer as a row with absolute start / end / keyframe times (seconds), plus the transition windows. Runs of
      * similar layers (`pop-1` … `pop-12`) are one row with a `parts` span each. Read it, or draw it with `timelineChart()`.
@@ -902,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-MWP2FX3T.js → Spans-4IBQASGK.js}

@@ -1,7 +1,7 @@
-import { CompositionSequence } from './chunk-AZ6AINSW.js';
-import { spansMeta, resolveNumber, bindCounterKeyframes, TextSequence } from './chunk-G3DX65HO.js';
-import './chunk-WIIU42FH.js';
-import './chunk-2JFFKHXO.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';
 
 // src/sequences/Spans.ts
@@ -49,5 +49,5 @@ var SpansSequence = class extends CompositionSequence {
 };
 
 export { SpansSequence };
-//# sourceMappingURL=Spans-MWP2FX3T.js.map
-//# sourceMappingURL=Spans-MWP2FX3T.js.map
+//# sourceMappingURL=Spans-4IBQASGK.js.map
+//# sourceMappingURL=Spans-4IBQASGK.js.map