@motionscript/audio 0.1.0 → 0.1.1-alpha.1

package/dist/waveform/live-waveform.d.ts

@@ -1,129 +1,92 @@
 import { type Fill, type FillResolved, type NodeOf, type Node2D as _Node2D, type Node2DProps as _Node2DProps } from "@motionscript/sdk";
 import { type AudioEnvelope } from "./envelope.js";
 /**
- * A **live audio visualiser**: bars that move with the recording as it plays.
+ * A visualiser whose bars move with the recording: a picture of this moment
+ * where {@link FullWaveform} is of the file. The bars are sampled from a baked
+ * envelope at the node's own elapsed time, so a frame is a pure function of time
+ * and an export, which has no playback to analyse and may render out of order,
+ * draws what the preview drew.
  *
- * The thing every podcast-to-video tool puts beside the artwork. It is not a
- * picture of the file — that is {@link FullWaveform} — it is a picture of *this
- * moment*, and what it is for is making a static frame of a talking head feel
- * like it is playing.
- *
- * ## "Live" without listening
- *
- * Nothing here reads an audio device. The bars are sampled out of a baked
- * envelope at the node's own elapsed time, which is what makes the visualiser
- * survive the thing it exists for: an **export**, where there is no playback to
- * analyse and frames may be rendered out of order or in parallel. A frame is a
- * pure function of its time, so scrubbing back and forth over the visualiser
- * redraws exactly what it drew the first time — which an analyser node, by
- * construction, cannot promise. See {@link AudioEnvelope}.
- *
- * ## The speaker filter
- *
- * `speaker` narrows the node to one voice of a diarized recording, and it
- * is the reason this node knows about transcripts at all. Two visualisers beside
- * two headshots, each filtered to its own host, is a podcast edit that would
- * otherwise be done by hand for every turn — and because the filter *silences*
- * rather than skips (see {@link forSpeaker}), the quiet host visibly stops
- * talking instead of vanishing. Nothing about that requires the words: only who
- * is talking when, which is what the diarizer produces.
- *
- * A filter naming a voice the recording doesn't have draws a resting row rather
- * than everything — a picture of "this person never speaks here", which is
- * true, where falling back to the unfiltered mix would be a silent lie about
- * whose voice you were watching.
+ * `speaker` narrows the node to one voice of a diarized recording; it silences
+ * the other voices (see {@link forSpeaker}) so the quiet host visibly stops. A
+ * voice the recording does not have draws a resting row, not the unfiltered mix,
+ * which would be a silent lie about whose voice you are watching.
  */
 export declare const LiveWaveform: import("@motionscript/sdk").Component<"liveWaveform", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
-    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+    /** The baked recording; see {@link AudioEnvelope}. */
     readonly envelope: import("@motionscript/sdk").Type<AudioEnvelope, AudioEnvelope, false>;
-    /** How many bars the visualiser is made of. */
     readonly bars: 48;
-    /** Space between bars, as a fraction of the pitch. */
+    /** Space between bars as a fraction of the pitch. */
     readonly gap: 0.35;
     readonly radius: 4;
-    /** How many seconds of audio are on screen at once. */
+    /** Seconds of audio on screen at once. */
     readonly window: 3;
-    /** Seconds into the file the node's first frame shows. */
+    /** Seconds into the file the first frame shows. */
     readonly offset: 0;
-    /** Advance with the scene clock. Off freezes the picture at `offset`. */
+    /** Advance with the scene clock; off freezes the picture at `offset`. */
     readonly playing: true;
-    /** Multiplies every magnitude before it is clamped. */
     readonly gain: 1.4;
-    /** How much of the box a silent bar still occupies, `0`–`1`. */
+    /** The share of the box a silent bar still occupies, `0`-`1`. */
     readonly floor: 0.04;
     readonly align: import("@motionscript/sdk").Type<"center" | "bottom", "center" | "bottom", false>;
     readonly style: import("@motionscript/sdk").Type<"bars" | "line" | "blocks", "bars" | "line" | "blocks", false>;
-    /**
-     * Show only this voice's activity, by index into the recording's own
-     * numbering. `-1` — the default — is every voice.
-     */
+    /** Show only this voice, by index into the recording's own numbering; `-1` is every voice. */
     readonly speaker: -1;
     /** Colour each bar by whoever is speaking in it. */
     readonly byVoice: false;
-    /** A colour per voice index. Short or empty falls back to the palette. */
+    /** A colour per voice index; short or empty falls back to the palette. */
     readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
     readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
 }>, {}, null, _Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
-    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+    /** The baked recording; see {@link AudioEnvelope}. */
     readonly envelope: import("@motionscript/sdk").Type<AudioEnvelope, AudioEnvelope, false>;
-    /** How many bars the visualiser is made of. */
     readonly bars: 48;
-    /** Space between bars, as a fraction of the pitch. */
+    /** Space between bars as a fraction of the pitch. */
     readonly gap: 0.35;
     readonly radius: 4;
-    /** How many seconds of audio are on screen at once. */
+    /** Seconds of audio on screen at once. */
     readonly window: 3;
-    /** Seconds into the file the node's first frame shows. */
+    /** Seconds into the file the first frame shows. */
     readonly offset: 0;
-    /** Advance with the scene clock. Off freezes the picture at `offset`. */
+    /** Advance with the scene clock; off freezes the picture at `offset`. */
     readonly playing: true;
-    /** Multiplies every magnitude before it is clamped. */
     readonly gain: 1.4;
-    /** How much of the box a silent bar still occupies, `0`–`1`. */
+    /** The share of the box a silent bar still occupies, `0`-`1`. */
     readonly floor: 0.04;
     readonly align: import("@motionscript/sdk").Type<"center" | "bottom", "center" | "bottom", false>;
     readonly style: import("@motionscript/sdk").Type<"bars" | "line" | "blocks", "bars" | "line" | "blocks", false>;
-    /**
-     * Show only this voice's activity, by index into the recording's own
-     * numbering. `-1` — the default — is every voice.
-     */
+    /** Show only this voice, by index into the recording's own numbering; `-1` is every voice. */
     readonly speaker: -1;
     /** Colour each bar by whoever is speaking in it. */
     readonly byVoice: false;
-    /** A colour per voice index. Short or empty falls back to the palette. */
+    /** A colour per voice index; short or empty falls back to the palette. */
     readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
     readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
 }>, null, import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
-    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+    /** The baked recording; see {@link AudioEnvelope}. */
     readonly envelope: import("@motionscript/sdk").Type<AudioEnvelope, AudioEnvelope, false>;
-    /** How many bars the visualiser is made of. */
     readonly bars: 48;
-    /** Space between bars, as a fraction of the pitch. */
+    /** Space between bars as a fraction of the pitch. */
     readonly gap: 0.35;
     readonly radius: 4;
-    /** How many seconds of audio are on screen at once. */
+    /** Seconds of audio on screen at once. */
     readonly window: 3;
-    /** Seconds into the file the node's first frame shows. */
+    /** Seconds into the file the first frame shows. */
     readonly offset: 0;
-    /** Advance with the scene clock. Off freezes the picture at `offset`. */
+    /** Advance with the scene clock; off freezes the picture at `offset`. */
     readonly playing: true;
-    /** Multiplies every magnitude before it is clamped. */
     readonly gain: 1.4;
-    /** How much of the box a silent bar still occupies, `0`–`1`. */
+    /** The share of the box a silent bar still occupies, `0`-`1`. */
     readonly floor: 0.04;
     readonly align: import("@motionscript/sdk").Type<"center" | "bottom", "center" | "bottom", false>;
     readonly style: import("@motionscript/sdk").Type<"bars" | "line" | "blocks", "bars" | "line" | "blocks", false>;
-    /**
-     * Show only this voice's activity, by index into the recording's own
-     * numbering. `-1` — the default — is every voice.
-     */
+    /** Show only this voice, by index into the recording's own numbering; `-1` is every voice. */
     readonly speaker: -1;
     /** Colour each bar by whoever is speaking in it. */
     readonly byVoice: false;
-    /** A colour per voice index. Short or empty falls back to the palette. */
+    /** A colour per voice index; short or empty falls back to the palette. */
     readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
     readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
 }>, {}, _Node2D<_Node2DProps>>>>;
 export type LiveWaveform = NodeOf<typeof LiveWaveform>;
-export type LiveWaveformProps = NonNullable<Parameters<typeof LiveWaveform>[0]>;
 //# sourceMappingURL=live-waveform.d.ts.map

package/dist/waveform/live-waveform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-waveform.d.ts","sourceRoot":"","sources":["../../src/waveform/live-waveform.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAGX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EACjC,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAA;AAYnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,YAAY;IAGrB,0EAA0E;;IAE1E,+CAA+C;;IAE/C,sDAAsD;;;IAGtD,uDAAuD;;IAEvD,0DAA0D;;IAE1D,yEAAyE;;IAEzE,uDAAuD;;IAEvD,gEAAgE;;;;IAIhE;;;OAGG;;IAEH,oDAAoD;;IAEpD,0EAA0E;;;;IA1B1E,0EAA0E;;IAE1E,+CAA+C;;IAE/C,sDAAsD;;;IAGtD,uDAAuD;;IAEvD,0DAA0D;;IAE1D,yEAAyE;;IAEzE,uDAAuD;;IAEvD,gEAAgE;;;;IAIhE;;;OAGG;;IAEH,oDAAoD;;IAEpD,0EAA0E;;;;IA1B1E,0EAA0E;;IAE1E,+CAA+C;;IAE/C,sDAAsD;;;IAGtD,uDAAuD;;IAEvD,0DAA0D;;IAE1D,yEAAyE;;IAEzE,uDAAuD;;IAEvD,gEAAgE;;;;IAIhE;;;OAGG;;IAEH,oDAAoD;;IAEpD,0EAA0E;;;gCAU5E,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA;AACtD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"live-waveform.d.ts","sourceRoot":"","sources":["../../src/waveform/live-waveform.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EAGX,KAAK,MAAM,IAAI,OAAO,EACtB,KAAK,WAAW,IAAI,YAAY,EACjC,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAA;AAWnB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY;IAGrB,sDAAsD;;;IAGtD,qDAAqD;;;IAGrD,0CAA0C;;IAE1C,mDAAmD;;IAEnD,yEAAyE;;;IAGzE,iEAAiE;;;;IAIjE,8FAA8F;;IAE9F,oDAAoD;;IAEpD,0EAA0E;;;;IArB1E,sDAAsD;;;IAGtD,qDAAqD;;;IAGrD,0CAA0C;;IAE1C,mDAAmD;;IAEnD,yEAAyE;;;IAGzE,iEAAiE;;;;IAIjE,8FAA8F;;IAE9F,oDAAoD;;IAEpD,0EAA0E;;;;IArB1E,sDAAsD;;;IAGtD,qDAAqD;;;IAGrD,0CAA0C;;IAE1C,mDAAmD;;IAEnD,yEAAyE;;;IAGzE,iEAAiE;;;;IAIjE,8FAA8F;;IAE9F,oDAAoD;;IAEpD,0EAA0E;;;gCAS5E,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA"}

package/dist/waveform/live-waveform.js

@@ -1,88 +1,53 @@
-import { Types, component2d, fillOps, } from "@motionscript/sdk";
+import { Types, clamp, component2d, fillOps, } from "@motionscript/sdk";
 import { EMPTY_ENVELOPE, forSpeaker, sampleEnvelope, } from "./envelope.js";
-import { clamp01, groupByPaint, layOutBars, livePaintKey, paintBars, voiceColor, } from "./shared.js";
+import { groupByPaint, layOutBars, livePaintKey, paintBars, voiceFill, } from "./shared.js";
 /**
- * A **live audio visualiser**: bars that move with the recording as it plays.
+ * A visualiser whose bars move with the recording: a picture of this moment
+ * where {@link FullWaveform} is of the file. The bars are sampled from a baked
+ * envelope at the node's own elapsed time, so a frame is a pure function of time
+ * and an export, which has no playback to analyse and may render out of order,
+ * draws what the preview drew.
  *
- * The thing every podcast-to-video tool puts beside the artwork. It is not a
- * picture of the file — that is {@link FullWaveform} — it is a picture of *this
- * moment*, and what it is for is making a static frame of a talking head feel
- * like it is playing.
- *
- * ## "Live" without listening
- *
- * Nothing here reads an audio device. The bars are sampled out of a baked
- * envelope at the node's own elapsed time, which is what makes the visualiser
- * survive the thing it exists for: an **export**, where there is no playback to
- * analyse and frames may be rendered out of order or in parallel. A frame is a
- * pure function of its time, so scrubbing back and forth over the visualiser
- * redraws exactly what it drew the first time — which an analyser node, by
- * construction, cannot promise. See {@link AudioEnvelope}.
- *
- * ## The speaker filter
- *
- * `speaker` narrows the node to one voice of a diarized recording, and it
- * is the reason this node knows about transcripts at all. Two visualisers beside
- * two headshots, each filtered to its own host, is a podcast edit that would
- * otherwise be done by hand for every turn — and because the filter *silences*
- * rather than skips (see {@link forSpeaker}), the quiet host visibly stops
- * talking instead of vanishing. Nothing about that requires the words: only who
- * is talking when, which is what the diarizer produces.
- *
- * A filter naming a voice the recording doesn't have draws a resting row rather
- * than everything — a picture of "this person never speaks here", which is
- * true, where falling back to the unfiltered mix would be a silent lie about
- * whose voice you were watching.
+ * `speaker` narrows the node to one voice of a diarized recording; it silences
+ * the other voices (see {@link forSpeaker}) so the quiet host visibly stops. A
+ * voice the recording does not have draws a resting row, not the unfiltered mix,
+ * which would be a silent lie about whose voice you are watching.
  */
 export const LiveWaveform = component2d({
     key: "liveWaveform",
     state: {
-        /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+        /** The baked recording; see {@link AudioEnvelope}. */
         envelope: Types.custom(EMPTY_ENVELOPE),
-        /** How many bars the visualiser is made of. */
         bars: 48,
-        /** Space between bars, as a fraction of the pitch. */
+        /** Space between bars as a fraction of the pitch. */
         gap: 0.35,
         radius: 4,
-        /** How many seconds of audio are on screen at once. */
+        /** Seconds of audio on screen at once. */
         window: 3,
-        /** Seconds into the file the node's first frame shows. */
+        /** Seconds into the file the first frame shows. */
         offset: 0,
-        /** Advance with the scene clock. Off freezes the picture at `offset`. */
+        /** Advance with the scene clock; off freezes the picture at `offset`. */
         playing: true,
-        /** Multiplies every magnitude before it is clamped. */
         gain: 1.4,
-        /** How much of the box a silent bar still occupies, `0`–`1`. */
+        /** The share of the box a silent bar still occupies, `0`-`1`. */
         floor: 0.04,
         align: Types.custom("center"),
         style: Types.custom("bars"),
-        /**
-         * Show only this voice's activity, by index into the recording's own
-         * numbering. `-1` — the default — is every voice.
-         */
+        /** Show only this voice, by index into the recording's own numbering; `-1` is every voice. */
         speaker: -1,
         /** Colour each bar by whoever is speaking in it. */
         byVoice: false,
-        /** A colour per voice index. Short or empty falls back to the palette. */
+        /** A colour per voice index; short or empty falls back to the palette. */
         voiceColors: Types.custom([]),
         fill: Types.custom("#6366f1", { resolve: fillOps.resolve, lerp: fillOps.lerp }),
     },
-    // Nothing declares a component's paints but itself.
     load: (loader, state) => loader.fill(state.fill),
     render: (ctx, state) => {
         drawBars(ctx, state);
         ctx.children();
     },
 });
-/**
- * The second of the recording the visualiser is showing.
- *
- * Off the node's own clock rather than the scene's, which is what "from the
- * moment this node appeared" means — the same clock the engine's own
- * `Video` times its picture from, and the same one that makes a node dropped
- * halfway through a clip start its recording at its entrance rather than
- * partway in.
- */
+/** The second of the recording on show, off the node's own clock (as `Video`'s is), so a node entering halfway through a clip starts its recording at its entrance. */
 function at(ctx, s) {
     return s.offset + (s.playing ? Math.max(0, ctx.time.elapsed) : 0);
 }
@@ -94,9 +59,7 @@ function drawBars(ctx, s) {
     const span = Math.max(0.05, s.window);
     const now = at(ctx, s);
     const voice = s.speaker < 0 ? null : Math.round(s.speaker);
-    // The window is centred on the playhead, so the bars run *toward* the
-    // middle and away again — the arrangement every mixer's meter uses, and the
-    // one that reads as sound arriving rather than as a strip scrolling past.
+    // Centred on the playhead, so sound reads as arriving rather than a strip scrolling past.
     const sampled = forSpeaker(sampleEnvelope(s.envelope, now - span / 2, now + span / 2, count), voice);
     const shaped = s.style === "line" ? taper(sampled) : sampled;
     const boxes = layOutBars(shaped, {
@@ -116,25 +79,12 @@ function drawBars(ctx, s) {
             ctx.draw(graphics);
     }
 }
-/** See `FullWaveform`'s paints — a voice is a hue, never a gradient. */
 function paintFor(s, key) {
     if (key === "all")
         return s.fill;
-    const voice = Number(key.slice("voice:".length));
-    if (!Number.isFinite(voice) || voice < 0)
-        return s.fill;
-    return s.voiceColors[voice] ?? voiceColor(voice);
+    return voiceFill(key, s.voiceColors, s.fill);
 }
-/**
- * Rolls the ends of a window off toward silence.
- *
- * What separates the `line` style from `bars`: a hard-edged window makes the
- * loud bar entering at the right edge appear from nothing, which reads as a
- * glitch rather than as sound arriving. Fading the outer fifth turns the same
- * data into a shape that grows out of the baseline — the profile a spectrum
- * display has, and the reason it looks like one object rather than a row of
- * separate meters.
- */
+/** Fades the outer fifth of the window to silence, the `line` style: a hard edge makes a loud bar appear from nothing, which reads as a glitch. */
 function taper(bars) {
     const count = bars.length;
     if (count < 3)
@@ -142,7 +92,7 @@ function taper(bars) {
     const edge = Math.max(1, Math.floor(count / 5));
     return bars.map((bar, i) => {
         const fromEnd = Math.min(i, count - 1 - i);
-        const weight = clamp01(fromEnd / edge);
+        const weight = clamp(fromEnd / edge, 0, 1);
         return { magnitude: bar.magnitude * weight, speaker: bar.speaker };
     });
 }

package/dist/waveform/live-waveform.js.map

@@ -1 +1 @@
-{"version":3,"file":"live-waveform.js","sourceRoot":"","sources":["../../src/waveform/live-waveform.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Types,\n  component2d,\n  fillOps,\n  type Fill,\n  type FillResolved,\n  type NodeOf,\n  type RenderContext,\n  // Named so the emitted declaration reaches these through the sdk, not core.\n  type Node2D as _Node2D,\n  type Node2DProps as _Node2DProps,\n} from \"@motionscript/sdk\"\n\nimport {\n  EMPTY_ENVELOPE,\n  forSpeaker,\n  sampleEnvelope,\n  type AudioEnvelope,\n  type EnvelopeBar,\n} from \"./envelope\"\nimport {\n  clamp01,\n  groupByPaint,\n  layOutBars,\n  livePaintKey,\n  paintBars,\n  voiceColor,\n  type WaveformAlignment,\n  type WaveformStyle,\n} from \"./shared\"\n\n/**\n * A **live audio visualiser**: bars that move with the recording as it plays.\n *\n * The thing every podcast-to-video tool puts beside the artwork. It is not a\n * picture of the file — that is {@link FullWaveform} — it is a picture of *this\n * moment*, and what it is for is making a static frame of a talking head feel\n * like it is playing.\n *\n * ## \"Live\" without listening\n *\n * Nothing here reads an audio device. The bars are sampled out of a baked\n * envelope at the node's own elapsed time, which is what makes the visualiser\n * survive the thing it exists for: an **export**, where there is no playback to\n * analyse and frames may be rendered out of order or in parallel. A frame is a\n * pure function of its time, so scrubbing back and forth over the visualiser\n * redraws exactly what it drew the first time — which an analyser node, by\n * construction, cannot promise. See {@link AudioEnvelope}.\n *\n * ## The speaker filter\n *\n * `speaker` narrows the node to one voice of a diarized recording, and it\n * is the reason this node knows about transcripts at all. Two visualisers beside\n * two headshots, each filtered to its own host, is a podcast edit that would\n * otherwise be done by hand for every turn — and because the filter *silences*\n * rather than skips (see {@link forSpeaker}), the quiet host visibly stops\n * talking instead of vanishing. Nothing about that requires the words: only who\n * is talking when, which is what the diarizer produces.\n *\n * A filter naming a voice the recording doesn't have draws a resting row rather\n * than everything — a picture of \"this person never speaks here\", which is\n * true, where falling back to the unfiltered mix would be a silent lie about\n * whose voice you were watching.\n */\nexport const LiveWaveform = component2d({\n  key: \"liveWaveform\",\n  state: {\n    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\n    envelope: Types.custom<AudioEnvelope>(EMPTY_ENVELOPE),\n    /** How many bars the visualiser is made of. */\n    bars: 48,\n    /** Space between bars, as a fraction of the pitch. */\n    gap: 0.35,\n    radius: 4,\n    /** How many seconds of audio are on screen at once. */\n    window: 3,\n    /** Seconds into the file the node's first frame shows. */\n    offset: 0,\n    /** Advance with the scene clock. Off freezes the picture at `offset`. */\n    playing: true,\n    /** Multiplies every magnitude before it is clamped. */\n    gain: 1.4,\n    /** How much of the box a silent bar still occupies, `0`–`1`. */\n    floor: 0.04,\n    align: Types.custom<WaveformAlignment>(\"center\"),\n    style: Types.custom<WaveformStyle>(\"bars\"),\n    /**\n     * Show only this voice's activity, by index into the recording's own\n     * numbering. `-1` — the default — is every voice.\n     */\n    speaker: -1,\n    /** Colour each bar by whoever is speaking in it. */\n    byVoice: false,\n    /** A colour per voice index. Short or empty falls back to the palette. */\n    voiceColors: Types.custom<string[]>([]),\n    fill: Types.custom<Fill, FillResolved[]>(\"#6366f1\", { resolve: fillOps.resolve, lerp: fillOps.lerp }),\n  },\n  // Nothing declares a component's paints but itself.\n  load: (loader, state) => loader.fill(state.fill),\n  render: (ctx, state) => {\n    drawBars(ctx, state)\n    ctx.children()\n  },\n})\n\nexport type LiveWaveform = NodeOf<typeof LiveWaveform>\nexport type LiveWaveformProps = NonNullable<Parameters<typeof LiveWaveform>[0]>\n\ninterface LiveState {\n  readonly envelope: AudioEnvelope\n  readonly bars: number\n  readonly gap: number\n  readonly radius: number\n  readonly window: number\n  readonly offset: number\n  readonly playing: boolean\n  readonly gain: number\n  readonly floor: number\n  readonly align: WaveformAlignment\n  readonly style: WaveformStyle\n  readonly speaker: number\n  readonly byVoice: boolean\n  readonly voiceColors: string[]\n  readonly fill: FillResolved[]\n}\n\n/**\n * The second of the recording the visualiser is showing.\n *\n * Off the node's own clock rather than the scene's, which is what \"from the\n * moment this node appeared\" means — the same clock the engine's own\n * `Video` times its picture from, and the same one that makes a node dropped\n * halfway through a clip start its recording at its entrance rather than\n * partway in.\n */\nfunction at(ctx: RenderContext, s: LiveState): number {\n  return s.offset + (s.playing ? Math.max(0, ctx.time.elapsed) : 0)\n}\n\nfunction drawBars(ctx: RenderContext, s: LiveState): void {\n  const { width, height } = ctx.size\n  if (width <= 0 || height <= 0) return\n\n  const count = Math.max(1, Math.round(s.bars))\n  const span = Math.max(0.05, s.window)\n  const now = at(ctx, s)\n  const voice = s.speaker < 0 ? null : Math.round(s.speaker)\n\n  // The window is centred on the playhead, so the bars run *toward* the\n  // middle and away again — the arrangement every mixer's meter uses, and the\n  // one that reads as sound arriving rather than as a strip scrolling past.\n  const sampled = forSpeaker(\n    sampleEnvelope(s.envelope, now - span / 2, now + span / 2, count),\n    voice\n  )\n\n  const shaped = s.style === \"line\" ? taper(sampled) : sampled\n  const boxes = layOutBars(shaped, {\n    width,\n    height,\n    gap: s.style === \"blocks\" ? 0.12 : s.gap,\n    align: s.align,\n    gain: s.gain,\n    floor: s.floor,\n  })\n  if (boxes.length === 0) return\n\n  const groups = groupByPaint(boxes, (i) =>\n    livePaintKey(shaped[i].speaker, s.byVoice, voice)\n  )\n\n  for (const [key, run] of groups) {\n    const graphics = paintBars(run, paintFor(s, key), s.radius)\n    if (graphics) ctx.draw(graphics)\n  }\n}\n\n/** See `FullWaveform`'s paints — a voice is a hue, never a gradient. */\nfunction paintFor(s: LiveState, key: string): Fill {\n  if (key === \"all\") return s.fill\n  const voice = Number(key.slice(\"voice:\".length))\n  if (!Number.isFinite(voice) || voice < 0) return s.fill\n  return s.voiceColors[voice] ?? voiceColor(voice)\n}\n\n/**\n * Rolls the ends of a window off toward silence.\n *\n * What separates the `line` style from `bars`: a hard-edged window makes the\n * loud bar entering at the right edge appear from nothing, which reads as a\n * glitch rather than as sound arriving. Fading the outer fifth turns the same\n * data into a shape that grows out of the baseline — the profile a spectrum\n * display has, and the reason it looks like one object rather than a row of\n * separate meters.\n */\nfunction taper(bars: readonly EnvelopeBar[]): EnvelopeBar[] {\n  const count = bars.length\n  if (count < 3) return [...bars]\n  const edge = Math.max(1, Math.floor(count / 5))\n\n  return bars.map((bar, i) => {\n    const fromEnd = Math.min(i, count - 1 - i)\n    const weight = clamp01(fromEnd / edge)\n    return { magnitude: bar.magnitude * weight, speaker: bar.speaker }\n  })\n}\n"]}
+{"version":3,"file":"live-waveform.js","sourceRoot":"","sources":["../../src/waveform/live-waveform.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Types,\n  clamp,\n  component2d,\n  fillOps,\n  type Fill,\n  type FillResolved,\n  type NodeOf,\n  type RenderContext,\n  // Named so the emitted declaration reaches these through the sdk, not core.\n  type Node2D as _Node2D,\n  type Node2DProps as _Node2DProps,\n} from \"@motionscript/sdk\"\n\nimport {\n  EMPTY_ENVELOPE,\n  forSpeaker,\n  sampleEnvelope,\n  type AudioEnvelope,\n  type EnvelopeBar,\n} from \"./envelope\"\nimport {\n  groupByPaint,\n  layOutBars,\n  livePaintKey,\n  paintBars,\n  voiceFill,\n  type WaveformAlignment,\n  type WaveformStyle,\n} from \"./shared\"\n\n/**\n * A visualiser whose bars move with the recording: a picture of this moment\n * where {@link FullWaveform} is of the file. The bars are sampled from a baked\n * envelope at the node's own elapsed time, so a frame is a pure function of time\n * and an export, which has no playback to analyse and may render out of order,\n * draws what the preview drew.\n *\n * `speaker` narrows the node to one voice of a diarized recording; it silences\n * the other voices (see {@link forSpeaker}) so the quiet host visibly stops. A\n * voice the recording does not have draws a resting row, not the unfiltered mix,\n * which would be a silent lie about whose voice you are watching.\n */\nexport const LiveWaveform = component2d({\n  key: \"liveWaveform\",\n  state: {\n    /** The baked recording; see {@link AudioEnvelope}. */\n    envelope: Types.custom<AudioEnvelope>(EMPTY_ENVELOPE),\n    bars: 48,\n    /** Space between bars as a fraction of the pitch. */\n    gap: 0.35,\n    radius: 4,\n    /** Seconds of audio on screen at once. */\n    window: 3,\n    /** Seconds into the file the first frame shows. */\n    offset: 0,\n    /** Advance with the scene clock; off freezes the picture at `offset`. */\n    playing: true,\n    gain: 1.4,\n    /** The share of the box a silent bar still occupies, `0`-`1`. */\n    floor: 0.04,\n    align: Types.custom<WaveformAlignment>(\"center\"),\n    style: Types.custom<WaveformStyle>(\"bars\"),\n    /** Show only this voice, by index into the recording's own numbering; `-1` is every voice. */\n    speaker: -1,\n    /** Colour each bar by whoever is speaking in it. */\n    byVoice: false,\n    /** A colour per voice index; short or empty falls back to the palette. */\n    voiceColors: Types.custom<string[]>([]),\n    fill: Types.custom<Fill, FillResolved[]>(\"#6366f1\", { resolve: fillOps.resolve, lerp: fillOps.lerp }),\n  },\n  load: (loader, state) => loader.fill(state.fill),\n  render: (ctx, state) => {\n    drawBars(ctx, state)\n    ctx.children()\n  },\n})\n\nexport type LiveWaveform = NodeOf<typeof LiveWaveform>\n\ninterface LiveState {\n  readonly envelope: AudioEnvelope\n  readonly bars: number\n  readonly gap: number\n  readonly radius: number\n  readonly window: number\n  readonly offset: number\n  readonly playing: boolean\n  readonly gain: number\n  readonly floor: number\n  readonly align: WaveformAlignment\n  readonly style: WaveformStyle\n  readonly speaker: number\n  readonly byVoice: boolean\n  readonly voiceColors: string[]\n  readonly fill: FillResolved[]\n}\n\n/** The second of the recording on show, off the node's own clock (as `Video`'s is), so a node entering halfway through a clip starts its recording at its entrance. */\nfunction at(ctx: RenderContext, s: LiveState): number {\n  return s.offset + (s.playing ? Math.max(0, ctx.time.elapsed) : 0)\n}\n\nfunction drawBars(ctx: RenderContext, s: LiveState): void {\n  const { width, height } = ctx.size\n  if (width <= 0 || height <= 0) return\n\n  const count = Math.max(1, Math.round(s.bars))\n  const span = Math.max(0.05, s.window)\n  const now = at(ctx, s)\n  const voice = s.speaker < 0 ? null : Math.round(s.speaker)\n\n  // Centred on the playhead, so sound reads as arriving rather than a strip scrolling past.\n  const sampled = forSpeaker(\n    sampleEnvelope(s.envelope, now - span / 2, now + span / 2, count),\n    voice\n  )\n\n  const shaped = s.style === \"line\" ? taper(sampled) : sampled\n  const boxes = layOutBars(shaped, {\n    width,\n    height,\n    gap: s.style === \"blocks\" ? 0.12 : s.gap,\n    align: s.align,\n    gain: s.gain,\n    floor: s.floor,\n  })\n  if (boxes.length === 0) return\n\n  const groups = groupByPaint(boxes, (i) =>\n    livePaintKey(shaped[i].speaker, s.byVoice, voice)\n  )\n\n  for (const [key, run] of groups) {\n    const graphics = paintBars(run, paintFor(s, key), s.radius)\n    if (graphics) ctx.draw(graphics)\n  }\n}\n\nfunction paintFor(s: LiveState, key: string): Fill {\n  if (key === \"all\") return s.fill\n  return voiceFill(key, s.voiceColors, s.fill)\n}\n\n/** Fades the outer fifth of the window to silence, the `line` style: a hard edge makes a loud bar appear from nothing, which reads as a glitch. */\nfunction taper(bars: readonly EnvelopeBar[]): EnvelopeBar[] {\n  const count = bars.length\n  if (count < 3) return [...bars]\n  const edge = Math.max(1, Math.floor(count / 5))\n\n  return bars.map((bar, i) => {\n    const fromEnd = Math.min(i, count - 1 - i)\n    const weight = clamp(fromEnd / edge, 0, 1)\n    return { magnitude: bar.magnitude * weight, speaker: bar.speaker }\n  })\n}\n"]}

package/dist/waveform/shared.d.ts

@@ -1,36 +1,15 @@
 import { Graphics2D, type Fill } from "@motionscript/sdk";
 import type { EnvelopeBar } from "./envelope.js";
-/**
- * Geometry and paint shared by the two waveform nodes.
- *
- * They draw the same object — a row of bars whose heights are loudness — and
- * differ only in what decides the heights: the whole file for one, a window
- * around the playhead for the other. Everything about *how a row of bars is
- * laid out and painted* is therefore common, and lives here so the two cannot
- * drift into looking like different components.
- */
 /** How a bar is grown out of its baseline. */
 export declare const WAVEFORM_ALIGNMENTS: readonly ["center", "bottom"];
 export type WaveformAlignment = (typeof WAVEFORM_ALIGNMENTS)[number];
-/** What the bars are shaped like. */
 export declare const WAVEFORM_STYLES: readonly ["bars", "line", "blocks"];
 export type WaveformStyle = (typeof WAVEFORM_STYLES)[number];
-/**
- * The colours voices are drawn in when nobody has assigned any.
- *
- * Eight hues that can be told apart at a glance, handed out by voice index. They
- * are literals rather than looked up, because a scene has to build in a
- * headless render with no database in scope; a host that names its voices
- * supplies its own colours instead.
- */
+/** Eight distinct hues handed out by voice index. Literals, because a scene builds headless with no database in scope; a host that names its voices supplies its own. */
 export declare const VOICE_PALETTE: readonly ["#6366f1", "#14b8a6", "#f59e0b", "#ec4899", "#22c55e", "#3b82f6", "#f97316", "#a855f7"];
 /** The colour a voice takes, wrapping past the end of the palette. */
 export declare function voiceColor(index: number): string;
-/**
- * Where one bar sits and how tall it came out: its top-left corner and size, in
- * the node's own pixels with **y pointing down** from the middle of the box.
- * {@link paintBars} turns that into the centred, y-up rect the renderer draws.
- */
+/** A bar's top-left corner and size in the node's pixels, with y pointing down from the middle of the box; {@link paintBars} turns it into the centred y-up rect. */
 export interface BarBox {
     x: number;
     y: number;
@@ -38,61 +17,41 @@ export interface BarBox {
     height: number;
 }
 /**
- * Lays a row of bars out across a box.
- *
- * The gap is stated as a *fraction of the pitch* rather than in pixels, and
- * that is the one decision here worth stating out loud: the bar count is a
- * control, so a gap in pixels would silently become a solid block at 200 bars
- * and a picket fence at 20. As a fraction, the row keeps the same rhythm at
- * every density — which is what lets the count be a slider anyone can drag.
- *
- * A bar is never thinner than a hairline and never shorter than one either: a
- * silent passage has to read as "audio, and nothing here" rather than as a hole
- * in the drawing.
+ * Lays a row of bars across a box. The gap is a fraction of the pitch, not px:
+ * the bar count is a control, and a px gap would become a solid block at 200
+ * bars and a picket fence at 20. A bar is never thinner or shorter than a
+ * hairline, so a silent passage reads as audio with nothing in it, not a hole.
  */
 export declare function layOutBars(bars: readonly EnvelopeBar[], options: {
     width: number;
     height: number;
     gap: number;
     align: WaveformAlignment;
-    /** Multiplies every magnitude before it is clamped back into 0…1. */
     gain: number;
     /** Fraction of the box a silent bar still occupies. */
     floor: number;
 }): BarBox[];
 /**
- * Draws a run of bars in one paint.
- *
- * Batched by colour by the caller, and this is why: every `Graphics2D` handed to
- * `ctx.draw` is a surface the renderer composites, so a bar apiece would be a
- * thousand surfaces a frame. Chaining the rects of one colour into a single
- * `Graphics2D` before filling makes it one — and, as a bonus, a gradient fill
- * maps across the whole run rather than restarting inside every bar, which is
- * the behaviour anyone reaching for a gradient here actually wants.
+ * Draws a run of bars in one paint. Callers batch by colour: every `Graphics2D`
+ * handed to `ctx.draw` is a surface the renderer composites, so a bar apiece
+ * would be a thousand surfaces a frame. One `Graphics2D` per run also maps a
+ * gradient across the whole run instead of restarting inside every bar.
  */
 export declare function paintBars(boxes: readonly BarBox[], fill: Fill, radius: number): Graphics2D | null;
+/** Groups bars by the paint they take, in order within each group: a diarized waveform has as many colours as voices, so two people is two draws however long it runs. */
+export declare function groupByPaint<K>(boxes: readonly BarBox[], keyOf: (index: number) => K): Map<K, BarBox[]>;
 /**
- * Groups bars by the paint they take, preserving order within each group.
- *
- * The seam that makes {@link paintBars} worth batching: a diarized waveform has
- * as many colours as it has voices, not as many as it has bars, so a
- * conversation of two people is two draws however long it runs.
+ * The colour of a `voice:N` group key, or `fallback` for a bad index. Always a
+ * colour string, never one of the node's fills: a voice is identified by hue, so
+ * a gradient or image would defeat the point, and it keeps these paints from
+ * declaring assets.
  */
-export declare function groupByPaint<K>(boxes: readonly BarBox[], keyOf: (index: number) => K): Map<K, BarBox[]>;
-export declare function clamp01(value: number): number;
+export declare function voiceFill(key: string, voiceColors: readonly string[], fallback: Fill): Fill;
 /**
- * The {@link groupByPaint} key one bar of a live visualiser takes.
- *
- * Filtered to one voice, every bar is that voice regardless of `byVoice` or
- * whose turn the bucket originally belonged to. That second part is the one
- * worth spelling out: {@link forSpeaker} silences a bar by zeroing its
- * magnitude but leaves `speaker` exactly as it was, so a bar sitting in the
- * middle of a *different* voice's turn is still stamped with that voice's
- * index — grouping by `byVoice`'s usual per-bar key would paint those silent
- * stretches in whoever used to be talking there, in flickers too short to
- * read as anything but noise. Forcing every bar under the filtered voice's own
- * key is the true picture instead: the node is drawing exactly one person, on
- * or off, never anyone else's colour.
+ * The {@link groupByPaint} key of one live bar. Filtered to a voice, every bar
+ * takes that voice's key: {@link forSpeaker} zeroes a bar's magnitude but leaves
+ * its `speaker`, so the usual per-bar key would paint the silenced stretches in
+ * whoever used to talk there, in flickers too short to read as anything but noise.
  */
 export declare function livePaintKey(barSpeaker: number, byVoice: boolean, filteredVoice: number | null): string;
 //# sourceMappingURL=shared.d.ts.map

package/dist/waveform/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/waveform/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,EAAqB,MAAM,mBAAmB,CAAA;AAE5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;GAQG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,+BAAgC,CAAA;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,qCAAqC;AACrC,eAAO,MAAM,eAAe,qCAAsC,CAAA;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,mGAShB,CAAA;AAEV,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,iBAAiB,CAAA;IACxB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;CACd,GACA,MAAM,EAAE,CA2BV;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAmBnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,GAC1B,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CASlB;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAGR"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/waveform/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAS,KAAK,IAAI,EAAqB,MAAM,mBAAmB,CAAA;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,+BAAgC,CAAA;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,eAAO,MAAM,eAAe,qCAAsC,CAAA;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D,yKAAyK;AACzK,eAAO,MAAM,aAAa,mGAShB,CAAA;AAEV,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,qKAAqK;AACrK,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,iBAAiB,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;CACd,GACA,MAAM,EAAE,CAwBV;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAiBnB;AAED,0KAA0K;AAC1K,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,GAC1B,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CASlB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAI3F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAGR"}