@motionscript/audio 0.1.0-alpha.5 → 0.1.0-alpha.6

package/dist/waveform/full-waveform.js

@@ -1,13 +1,8 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { Node2D, node, command, easeInOut, fillOps, property, } from "@motionscript/sdk";
-import { declarePaints } from "@motionscript/sdk/component";
+import { Types, component2d, easeInOut, fillOps, } from "@motionscript/sdk";
 import { EMPTY_ENVELOPE, sampleEnvelope } from "./envelope.js";
 import { clamp01, groupByPaint, layOutBars, paintBars, voiceColor, } from "./shared.js";
+/** A paint entry as the waveforms declare theirs: resolved and tweened like a fill, its kind read off the default. */
+const paint = (initial) => Types.custom(initial, { resolve: fillOps.resolve, lerp: fillOps.lerp });
 /**
  * A **waveform overview**: the whole recording's shape, drawn at once.
  *
@@ -19,7 +14,7 @@ import { clamp01, groupByPaint, layOutBars, paintBars, voiceColor, } from "./sha
  *
  * ## Progress is authored, not assumed
  *
- * {@link follow} is off by default, and that default is the considered one. A
+ * `follow` is off by default, and that default is the considered one. A
  * scene has no idea where the recording it is drawing sits on the video's audio
  * lane — a clip is placed, trimmed and sped up out there, and none of that is
  * visible from in here. So the honest default is that the fill is *animation*:
@@ -31,162 +26,121 @@ import { clamp01, groupByPaint, layOutBars, paintBars, voiceColor, } from "./sha
  *
  * ## Voices instead of progress
  *
- * With {@link byVoice} on, the played/ahead split is replaced by one colour per
+ * With `byVoice` on, the played/ahead split is replaced by one colour per
  * speaking voice, at a size you can read. For a two-hander it is a map of the conversation: who has the
  * floor, where the turns are, how long each one ran. It replaces the progress
  * colours rather than combining with them, because a bar cannot mean two things
  * at once and "played, and also Grace" is a legend nobody can hold in their
  * head.
  */
-let FullWaveform = class FullWaveform extends Node2D {
-    /**
-     * Fill the waveform in, left to right — the node's one command, since
-     * everything else about it is expressible as an ordinary `to`.
-     */
-    sweep(args) {
-        return this.to({
-            data: { progress: 1 },
-            duration: args.duration,
-            easing: args.easing ?? easeInOut(),
-        });
-    }
-    /**
-     * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the
-     * paint props it carries — see {@link declarePaints}. `playedFill` is named
-     * past the conventional slots, so it is passed explicitly.
-     */
-    declareAssets(assets) {
-        super.declareAssets(assets);
-        declarePaints(this, assets, { fills: [this.playedFill] });
-    }
-    /** Where the fill has reached, from whichever source is in charge. */
-    get played() {
-        if (!this.follow)
-            return clamp01(this.progress);
-        const length = this.envelope.duration;
-        if (length <= 0)
-            return 0;
-        return clamp01(this.time.elapsed / length);
-    }
-    renderSelf(ctx) {
-        const rect = this.layoutBounds;
-        const width = rect?.width ?? 0;
-        const height = rect?.height ?? 0;
-        if (width <= 0 || height <= 0)
-            return;
-        const count = Math.max(1, Math.round(this.bars));
-        const sampled = sampleEnvelope(this.envelope, 0, this.envelope.duration, count);
-        const boxes = layOutBars(sampled, {
-            width,
-            height,
-            gap: this.gap,
-            align: this.align,
-            gain: this.gain,
-            floor: this.floor,
-        });
-        if (boxes.length === 0)
-            return;
-        // One draw per colour rather than per bar — see {@link paintBars}. The key
-        // is a string because it has to be comparable; the paint it stands for is
-        // resolved after the grouping.
-        const edge = this.played * boxes.length;
-        const groups = groupByPaint(boxes, (i) => this.byVoice
-            ? `voice:${sampled[i].speaker}`
-            : i < edge
-                ? "played"
-                : "ahead");
-        for (const [key, run] of groups) {
-            const graphics = paintBars(run, this.paintFor(key), this.radius);
-            if (graphics)
-                ctx.draw(graphics);
-        }
-    }
-    /**
-     * The paint a group takes.
-     *
-     * A voice's colour is a **colour string**, never one of the node's two fill
-     * props, and that is deliberate: a voice is identified by hue, so a gradient
-     * or an image there would defeat the only thing the colour is for. It also
-     * means these paints declare no assets, which is why {@link declareAssets}
-     * only has to account for the two real fill props.
-     */
-    paintFor(key) {
-        if (key === "played")
-            return this.playedFill;
-        if (key === "ahead")
-            return this.fill;
-        const voice = Number(key.slice("voice:".length));
-        if (!Number.isFinite(voice) || voice < 0)
-            return this.fill;
-        return this.voiceColors[voice] ?? voiceColor(voice);
-    }
-};
-__decorate([
-    property({ default: EMPTY_ENVELOPE })
-], FullWaveform.prototype, "envelope", void 0);
-__decorate([
-    property({ default: 120 })
-], FullWaveform.prototype, "bars", void 0);
-__decorate([
-    property({ default: 0.3 })
-], FullWaveform.prototype, "gap", void 0);
-__decorate([
-    property({ default: 2 })
-], FullWaveform.prototype, "radius", void 0);
-__decorate([
-    property({ default: 0 })
-], FullWaveform.prototype, "progress", void 0);
-__decorate([
-    property({ default: false })
-], FullWaveform.prototype, "follow", void 0);
-__decorate([
-    property({ default: 1 })
-], FullWaveform.prototype, "gain", void 0);
-__decorate([
-    property({ default: 0.015 })
-], FullWaveform.prototype, "floor", void 0);
-__decorate([
-    property({ default: "center" })
-], FullWaveform.prototype, "align", void 0);
-__decorate([
-    property({ default: false })
-], FullWaveform.prototype, "byVoice", void 0);
-__decorate([
-    property({ default: [] })
-], FullWaveform.prototype, "voiceColors", void 0);
-__decorate([
-    property({
-        default: "#5b5b7a",
-        mapper: fillOps.resolve,
-        tween: fillOps.lerp,
-    })
-], FullWaveform.prototype, "fill", void 0);
-__decorate([
-    property({
-        default: "#6366f1",
-        mapper: fillOps.resolve,
-        tween: fillOps.lerp,
-    })
-], FullWaveform.prototype, "playedFill", void 0);
-__decorate([
-    command()
-], FullWaveform.prototype, "sweep", null);
-FullWaveform = __decorate([
-    node({
-        key: "fullWaveform",
-        parentKey: "node",
-        forkable: true,
-        layout: {
-            children: "freeform",
-            defaultWidthMode: "fixed",
-            defaultHeightMode: "fixed",
-            acceptsChildren: true,
+export const FullWaveform = component2d({
+    key: "fullWaveform",
+    state: {
+        /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
+        envelope: Types.custom(EMPTY_ENVELOPE),
+        /** How many columns the whole file is drawn as. */
+        bars: 120,
+        /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */
+        gap: 0.3,
+        /** Corner radius of a bar, capped at half its width. */
+        radius: 2,
+        /** How much of the file reads as played, `0`–`1`. Tweenable. */
+        progress: 0,
+        /** Drive `progress` from the node's own clock instead of the prop. */
+        follow: false,
+        /** Multiplies every magnitude — a quiet track pulled up to fill its box. */
+        gain: 1,
+        /** How much of the box a silent bar still occupies, `0`–`1`. */
+        floor: 0.015,
+        align: Types.custom("center"),
+        /** Colour each voice's turns rather than splitting on played / not played. */
+        byVoice: false,
+        /** A colour per voice index. Short or empty falls back to the palette. */
+        voiceColors: Types.custom([]),
+        /** The bars ahead of the playhead. */
+        fill: paint("#5b5b7a"),
+        /** …and the bars behind it. */
+        playedFill: paint("#6366f1"),
+    },
+    // Nothing declares a component's paints but itself: `fill` and `playedFill` both.
+    load: (loader, state) => {
+        loader.fill(state.fill);
+        loader.fill(state.playedFill);
+    },
+    commands: {
+        /**
+         * Fill the waveform in, left to right — the node's one command, since
+         * everything else about it is expressible as an ordinary `to`. Eased in-out
+         * unless it is given an easing of its own.
+         */
+        sweep: (timeline, state) => {
+            const ease = timeline.easing ? null : easeInOut();
+            const from = state.progress;
+            return timeline.animate((t) => ({ progress: from + (1 - from) * (ease ? ease(t) : t) }));
         },
-        seed: {
-            width: 900,
-            height: 160,
-        },
-    })
-], FullWaveform);
-export { FullWaveform };
+    },
+    render: (ctx, state) => {
+        drawBars(ctx, state);
+        ctx.children();
+    },
+});
+function drawBars(ctx, s) {
+    const { width, height } = ctx.size;
+    if (width <= 0 || height <= 0)
+        return;
+    const count = Math.max(1, Math.round(s.bars));
+    const sampled = sampleEnvelope(s.envelope, 0, s.envelope.duration, count);
+    const boxes = layOutBars(sampled, {
+        width,
+        height,
+        gap: s.gap,
+        align: s.align,
+        gain: s.gain,
+        floor: s.floor,
+    });
+    if (boxes.length === 0)
+        return;
+    // One draw per colour rather than per bar — see {@link paintBars}. The key
+    // is a string because it has to be comparable; the paint it stands for is
+    // resolved after the grouping.
+    const edge = played(ctx, s) * boxes.length;
+    const groups = groupByPaint(boxes, (i) => s.byVoice
+        ? `voice:${sampled[i].speaker}`
+        : i < edge
+            ? "played"
+            : "ahead");
+    for (const [key, run] of groups) {
+        const graphics = paintBars(run, paintFor(s, key), s.radius);
+        if (graphics)
+            ctx.draw(graphics);
+    }
+}
+/** Where the fill has reached, from whichever source is in charge. */
+function played(ctx, s) {
+    if (!s.follow)
+        return clamp01(s.progress);
+    const length = s.envelope.duration;
+    if (length <= 0)
+        return 0;
+    return clamp01(ctx.time.elapsed / length);
+}
+/**
+ * The paint a group takes.
+ *
+ * A voice's colour is a **colour string**, never one of the node's two fill
+ * props, and that is deliberate: a voice is identified by hue, so a gradient
+ * or an image there would defeat the only thing the colour is for. It also
+ * means these paints declare no assets, which is why `load` only has to account
+ * for the two real fill props.
+ */
+function paintFor(s, key) {
+    if (key === "played")
+        return s.playedFill;
+    if (key === "ahead")
+        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);
+}
 //# sourceMappingURL=full-waveform.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"full-waveform.js","sourceRoot":"","sources":["../../src/waveform/full-waveform.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Node2D,\r\n  node,\r\n  command,\r\n  easeInOut,\r\n  fillOps,\r\n  property,\r\n  type AssetScope,\r\n  type CommandArgs,\r\n  type Fill,\r\n  type FillResolved,\r\n  type Node2DProps,\r\n  type RenderContext2D,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { declarePaints } from \"@motionscript/sdk/component\"\r\nimport type { Seekable } from \"@motionscript/sdk/component\"\r\nimport { EMPTY_ENVELOPE, sampleEnvelope, type AudioEnvelope } from \"./envelope\"\r\nimport {\r\n  clamp01,\r\n  groupByPaint,\r\n  layOutBars,\r\n  paintBars,\r\n  voiceColor,\r\n  type WaveformAlignment,\r\n} from \"./shared\"\r\n\r\nexport interface FullWaveformProps extends Node2DProps {\r\n  /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\r\n  envelope: AudioEnvelope\r\n  /** How many columns the whole file is drawn as. */\r\n  bars: number\r\n  /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */\r\n  gap: number\r\n  /** Corner radius of a bar, capped at half its width. */\r\n  radius: number\r\n  /** How much of the file reads as played, `0`–`1`. Tweenable. */\r\n  progress: number\r\n  /** Drive {@link progress} from the node's own clock instead of the prop. */\r\n  follow: boolean\r\n  /** Multiplies every magnitude — a quiet track pulled up to fill its box. */\r\n  gain: number\r\n  /** How much of the box a silent bar still occupies, `0`–`1`. */\r\n  floor: number\r\n  align: WaveformAlignment\r\n  /** Colour each voice's turns rather than splitting on played / not played. */\r\n  byVoice: boolean\r\n  /** A colour per voice index. Short or empty falls back to the palette. */\r\n  voiceColors: string[]\r\n  /** The bars ahead of the playhead. */\r\n  fill: Fill\r\n  /** …and the bars behind it. */\r\n  playedFill: Fill\r\n}\r\n\r\n/**\r\n * A **waveform overview**: the whole recording's shape, drawn at once.\r\n *\r\n * The picture every audio editor opens with, and the one a podcast clip puts\r\n * under its caption — a static silhouette of the file, with a played portion\r\n * that advances. It answers \"how long is this and where are the loud parts\",\r\n * which is a question about the *file*, not about the moment; its sibling\r\n * {@link LiveWaveform} answers the other one.\r\n *\r\n * ## Progress is authored, not assumed\r\n *\r\n * {@link follow} is off by default, and that default is the considered one. A\r\n * scene has no idea where the recording it is drawing sits on the video's audio\r\n * lane — a clip is placed, trimmed and sped up out there, and none of that is\r\n * visible from in here. So the honest default is that the fill is *animation*:\r\n * the author sweeps it with a command, the same as any other tween, and it lands\r\n * wherever they put it. `follow` is the shortcut for the common arrangement\r\n * where the node appears exactly as the track starts, and it says so by being a\r\n * switch someone has to turn on rather than a behaviour that quietly disagrees\r\n * with the mix.\r\n *\r\n * ## Voices instead of progress\r\n *\r\n * With {@link byVoice} on, the played/ahead split is replaced by one colour per\r\n * speaking voice, at a size you can read. For a two-hander it is a map of the conversation: who has the\r\n * floor, where the turns are, how long each one ran. It replaces the progress\r\n * colours rather than combining with them, because a bar cannot mean two things\r\n * at once and \"played, and also Grace\" is a legend nobody can hold in their\r\n * head.\r\n */\r\n@node({\r\n  key: \"fullWaveform\",\r\n  parentKey: \"node\",\r\n  forkable: true,\r\n  layout: {\r\n    children: \"freeform\",\r\n    defaultWidthMode: \"fixed\",\r\n    defaultHeightMode: \"fixed\",\r\n    acceptsChildren: true,\r\n  },\r\n  seed: {\r\n    width: 900,\r\n    height: 160,\r\n  },\r\n})\r\nexport class FullWaveform extends Node2D<FullWaveformProps> {\r\n  @property({ default: EMPTY_ENVELOPE }) declare envelope: AudioEnvelope\r\n  @property({ default: 120 }) declare bars: number\r\n  @property({ default: 0.3 }) declare gap: number\r\n  @property({ default: 2 }) declare radius: number\r\n  @property({ default: 0 }) declare progress: number\r\n  @property({ default: false }) declare follow: boolean\r\n  @property({ default: 1 }) declare gain: number\r\n  @property({ default: 0.015 }) declare floor: number\r\n  @property({ default: \"center\" }) declare align: WaveformAlignment\r\n  @property({ default: false }) declare byVoice: boolean\r\n  @property({ default: [] }) declare voiceColors: string[]\r\n\r\n  @property({\r\n    default: \"#5b5b7a\",\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare fill: Fill\r\n\r\n  @property({\r\n    default: \"#6366f1\",\r\n    mapper: fillOps.resolve,\r\n    tween: fillOps.lerp,\r\n  })\r\n  declare playedFill: Fill\r\n\r\n  /**\r\n   * Fill the waveform in, left to right — the node's one command, since\r\n   * everything else about it is expressible as an ordinary `to`.\r\n   */\r\n  @command()\r\n  sweep(args: CommandArgs<Record<string, never>> & { duration: number }): Seekable {\r\n    return this.to({\r\n      data: { progress: 1 } as Partial<FullWaveformProps>,\r\n      duration: args.duration,\r\n      easing: args.easing ?? easeInOut(),\r\n    })\r\n  }\r\n\r\n  /**\r\n   * This node extends `Node2D` rather than `ShapeNode`, so nothing declares the\r\n   * paint props it carries — see {@link declarePaints}. `playedFill` is named\r\n   * past the conventional slots, so it is passed explicitly.\r\n   */\r\n  override declareAssets(assets: AssetScope): void {\r\n    super.declareAssets(assets)\r\n    declarePaints(this, assets, { fills: [this.playedFill as FillResolved[]] })\r\n  }\r\n\r\n  /** Where the fill has reached, from whichever source is in charge. */\r\n  private get played(): number {\r\n    if (!this.follow) return clamp01(this.progress)\r\n    const length = this.envelope.duration\r\n    if (length <= 0) return 0\r\n    return clamp01(this.time.elapsed / length)\r\n  }\r\n\r\n  protected renderSelf(ctx: RenderContext2D): void {\r\n    const rect = this.layoutBounds\r\n    const width = rect?.width ?? 0\r\n    const height = rect?.height ?? 0\r\n    if (width <= 0 || height <= 0) return\r\n\r\n    const count = Math.max(1, Math.round(this.bars))\r\n    const sampled = sampleEnvelope(\r\n      this.envelope,\r\n      0,\r\n      this.envelope.duration,\r\n      count\r\n    )\r\n    const boxes = layOutBars(sampled, {\r\n      width,\r\n      height,\r\n      gap: this.gap,\r\n      align: this.align,\r\n      gain: this.gain,\r\n      floor: this.floor,\r\n    })\r\n    if (boxes.length === 0) return\r\n\r\n    // One draw per colour rather than per bar — see {@link paintBars}. The key\r\n    // is a string because it has to be comparable; the paint it stands for is\r\n    // resolved after the grouping.\r\n    const edge = this.played * boxes.length\r\n    const groups = groupByPaint(boxes, (i) =>\r\n      this.byVoice\r\n        ? `voice:${sampled[i].speaker}`\r\n        : i < edge\r\n          ? \"played\"\r\n          : \"ahead\"\r\n    )\r\n\r\n    for (const [key, run] of groups) {\r\n      const graphics = paintBars(run, this.paintFor(key), this.radius)\r\n      if (graphics) ctx.draw(graphics)\r\n    }\r\n  }\r\n\r\n  /**\r\n   * The paint a group takes.\r\n   *\r\n   * A voice's colour is a **colour string**, never one of the node's two fill\r\n   * props, and that is deliberate: a voice is identified by hue, so a gradient\r\n   * or an image there would defeat the only thing the colour is for. It also\r\n   * means these paints declare no assets, which is why {@link declareAssets}\r\n   * only has to account for the two real fill props.\r\n   */\r\n  private paintFor(key: string): Fill {\r\n    if (key === \"played\") return this.playedFill\r\n    if (key === \"ahead\") return this.fill\r\n\r\n    const voice = Number(key.slice(\"voice:\".length))\r\n    if (!Number.isFinite(voice) || voice < 0) return this.fill\r\n    return this.voiceColors[voice] ?? voiceColor(voice)\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"full-waveform.js","sourceRoot":"","sources":["../../src/waveform/full-waveform.ts"],"names":[],"mappings":"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","sourcesContent":["import {\r\n  Types,\r\n  component2d,\r\n  easeInOut,\r\n  fillOps,\r\n  type Fill,\r\n  type FillResolved,\r\n  type NodeOf,\r\n  type RenderContext,\r\n  // Named so the emitted declaration reaches these through the sdk, not core.\r\n  type Node2D as _Node2D,\r\n  type Node2DProps as _Node2DProps,\r\n} from \"@motionscript/sdk\"\r\n\r\nimport { EMPTY_ENVELOPE, sampleEnvelope, type AudioEnvelope } from \"./envelope\"\r\nimport {\r\n  clamp01,\r\n  groupByPaint,\r\n  layOutBars,\r\n  paintBars,\r\n  voiceColor,\r\n  type WaveformAlignment,\r\n} from \"./shared\"\r\n\r\n/** A paint entry as the waveforms declare theirs: resolved and tweened like a fill, its kind read off the default. */\r\nconst paint = (initial: string) =>\r\n  Types.custom<Fill, FillResolved[]>(initial, { resolve: fillOps.resolve, lerp: fillOps.lerp })\r\n\r\n/**\r\n * A **waveform overview**: the whole recording's shape, drawn at once.\r\n *\r\n * The picture every audio editor opens with, and the one a podcast clip puts\r\n * under its caption — a static silhouette of the file, with a played portion\r\n * that advances. It answers \"how long is this and where are the loud parts\",\r\n * which is a question about the *file*, not about the moment; its sibling\r\n * {@link LiveWaveform} answers the other one.\r\n *\r\n * ## Progress is authored, not assumed\r\n *\r\n * `follow` is off by default, and that default is the considered one. A\r\n * scene has no idea where the recording it is drawing sits on the video's audio\r\n * lane — a clip is placed, trimmed and sped up out there, and none of that is\r\n * visible from in here. So the honest default is that the fill is *animation*:\r\n * the author sweeps it with a command, the same as any other tween, and it lands\r\n * wherever they put it. `follow` is the shortcut for the common arrangement\r\n * where the node appears exactly as the track starts, and it says so by being a\r\n * switch someone has to turn on rather than a behaviour that quietly disagrees\r\n * with the mix.\r\n *\r\n * ## Voices instead of progress\r\n *\r\n * With `byVoice` on, the played/ahead split is replaced by one colour per\r\n * speaking voice, at a size you can read. For a two-hander it is a map of the conversation: who has the\r\n * floor, where the turns are, how long each one ran. It replaces the progress\r\n * colours rather than combining with them, because a bar cannot mean two things\r\n * at once and \"played, and also Grace\" is a legend nobody can hold in their\r\n * head.\r\n */\r\nexport const FullWaveform = component2d({\r\n  key: \"fullWaveform\",\r\n  state: {\r\n    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */\r\n    envelope: Types.custom<AudioEnvelope>(EMPTY_ENVELOPE),\r\n    /** How many columns the whole file is drawn as. */\r\n    bars: 120,\r\n    /** Space between bars, as a fraction of the pitch. See {@link layOutBars}. */\r\n    gap: 0.3,\r\n    /** Corner radius of a bar, capped at half its width. */\r\n    radius: 2,\r\n    /** How much of the file reads as played, `0`–`1`. Tweenable. */\r\n    progress: 0,\r\n    /** Drive `progress` from the node's own clock instead of the prop. */\r\n    follow: false,\r\n    /** Multiplies every magnitude — a quiet track pulled up to fill its box. */\r\n    gain: 1,\r\n    /** How much of the box a silent bar still occupies, `0`–`1`. */\r\n    floor: 0.015,\r\n    align: Types.custom<WaveformAlignment>(\"center\"),\r\n    /** Colour each voice's turns rather than splitting on played / not played. */\r\n    byVoice: false,\r\n    /** A colour per voice index. Short or empty falls back to the palette. */\r\n    voiceColors: Types.custom<string[]>([]),\r\n    /** The bars ahead of the playhead. */\r\n    fill: paint(\"#5b5b7a\"),\r\n    /** …and the bars behind it. */\r\n    playedFill: paint(\"#6366f1\"),\r\n  },\r\n  // Nothing declares a component's paints but itself: `fill` and `playedFill` both.\r\n  load: (loader, state) => {\r\n    loader.fill(state.fill)\r\n    loader.fill(state.playedFill)\r\n  },\r\n  commands: {\r\n    /**\r\n     * Fill the waveform in, left to right — the node's one command, since\r\n     * everything else about it is expressible as an ordinary `to`. Eased in-out\r\n     * unless it is given an easing of its own.\r\n     */\r\n    sweep: (timeline, state) => {\r\n      const ease = timeline.easing ? null : easeInOut()\r\n      const from = state.progress\r\n      return timeline.animate((t) => ({ progress: from + (1 - from) * (ease ? ease(t) : t) }))\r\n    },\r\n  },\r\n  render: (ctx, state) => {\r\n    drawBars(ctx, state)\r\n    ctx.children()\r\n  },\r\n})\r\n\r\nexport type FullWaveform = NodeOf<typeof FullWaveform>\r\nexport type FullWaveformProps = NonNullable<Parameters<typeof FullWaveform>[0]>\r\n\r\ninterface FullState {\r\n  readonly envelope: AudioEnvelope\r\n  readonly bars: number\r\n  readonly gap: number\r\n  readonly radius: number\r\n  readonly progress: number\r\n  readonly follow: boolean\r\n  readonly gain: number\r\n  readonly floor: number\r\n  readonly align: WaveformAlignment\r\n  readonly byVoice: boolean\r\n  readonly voiceColors: string[]\r\n  readonly fill: FillResolved[]\r\n  readonly playedFill: FillResolved[]\r\n}\r\n\r\nfunction drawBars(ctx: RenderContext, s: FullState): void {\r\n  const { width, height } = ctx.size\r\n  if (width <= 0 || height <= 0) return\r\n\r\n  const count = Math.max(1, Math.round(s.bars))\r\n  const sampled = sampleEnvelope(s.envelope, 0, s.envelope.duration, count)\r\n  const boxes = layOutBars(sampled, {\r\n    width,\r\n    height,\r\n    gap: s.gap,\r\n    align: s.align,\r\n    gain: s.gain,\r\n    floor: s.floor,\r\n  })\r\n  if (boxes.length === 0) return\r\n\r\n  // One draw per colour rather than per bar — see {@link paintBars}. The key\r\n  // is a string because it has to be comparable; the paint it stands for is\r\n  // resolved after the grouping.\r\n  const edge = played(ctx, s) * boxes.length\r\n  const groups = groupByPaint(boxes, (i) =>\r\n    s.byVoice\r\n      ? `voice:${sampled[i].speaker}`\r\n      : i < edge\r\n        ? \"played\"\r\n        : \"ahead\"\r\n  )\r\n\r\n  for (const [key, run] of groups) {\r\n    const graphics = paintBars(run, paintFor(s, key), s.radius)\r\n    if (graphics) ctx.draw(graphics)\r\n  }\r\n}\r\n\r\n/** Where the fill has reached, from whichever source is in charge. */\r\nfunction played(ctx: RenderContext, s: FullState): number {\r\n  if (!s.follow) return clamp01(s.progress)\r\n  const length = s.envelope.duration\r\n  if (length <= 0) return 0\r\n  return clamp01(ctx.time.elapsed / length)\r\n}\r\n\r\n/**\r\n * The paint a group takes.\r\n *\r\n * A voice's colour is a **colour string**, never one of the node's two fill\r\n * props, and that is deliberate: a voice is identified by hue, so a gradient\r\n * or an image there would defeat the only thing the colour is for. It also\r\n * means these paints declare no assets, which is why `load` only has to account\r\n * for the two real fill props.\r\n */\r\nfunction paintFor(s: FullState, key: string): Fill {\r\n  if (key === \"played\") return s.playedFill\r\n  if (key === \"ahead\") return s.fill\r\n\r\n  const voice = Number(key.slice(\"voice:\".length))\r\n  if (!Number.isFinite(voice) || voice < 0) return s.fill\r\n  return s.voiceColors[voice] ?? voiceColor(voice)\r\n}\r\n"]}

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

@@ -1,37 +1,5 @@
-import { Node2D, type AssetScope, type Fill, type Node2DProps, type RenderContext2D } from "@motionscript/sdk";
+import { type Fill, type FillResolved, type NodeOf, type Node2D as _Node2D, type Node2DProps as _Node2DProps } from "@motionscript/sdk";
 import { type AudioEnvelope } from "./envelope.js";
-import { type WaveformAlignment, type WaveformStyle } from "./shared.js";
-export interface LiveWaveformProps extends Node2DProps {
-    /** The baked recording. See {@link AudioEnvelope} for why it is baked. */
-    envelope: AudioEnvelope;
-    /** How many bars the visualiser is made of. */
-    bars: number;
-    /** Space between bars, as a fraction of the pitch. */
-    gap: number;
-    radius: number;
-    /** How many seconds of audio are on screen at once. */
-    window: number;
-    /** Seconds into the file the node's first frame shows. */
-    offset: number;
-    /** Advance with the scene clock. Off freezes the picture at {@link offset}. */
-    playing: boolean;
-    /** Multiplies every magnitude before it is clamped. */
-    gain: number;
-    /** How much of the box a silent bar still occupies, `0`–`1`. */
-    floor: number;
-    align: WaveformAlignment;
-    style: WaveformStyle;
-    /**
-     * Show only this voice's activity, by index into the recording's own
-     * numbering. `-1` — the default — is every voice.
-     */
-    speaker: number;
-    /** Colour each bar by whoever is speaking in it. */
-    byVoice: boolean;
-    /** A colour per voice index. Short or empty falls back to the palette. */
-    voiceColors: string[];
-    fill: Fill;
-}
 /**
  * A **live audio visualiser**: bars that move with the recording as it plays.
  *
@@ -52,7 +20,7 @@ export interface LiveWaveformProps extends Node2DProps {
  *
  * ## The speaker filter
  *
- * {@link speaker} narrows the node to one voice of a diarized recording, and it
+ * `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*
@@ -65,35 +33,67 @@ export interface LiveWaveformProps extends Node2DProps {
  * true, where falling back to the unfiltered mix would be a silent lie about
  * whose voice you were watching.
  */
-export declare class LiveWaveform extends Node2D<LiveWaveformProps> {
-    envelope: AudioEnvelope;
-    bars: number;
-    gap: number;
-    radius: number;
-    window: number;
-    offset: number;
-    playing: boolean;
-    gain: number;
-    floor: number;
-    align: WaveformAlignment;
-    style: WaveformStyle;
-    speaker: number;
-    byVoice: boolean;
-    voiceColors: string[];
-    fill: Fill;
-    declareAssets(assets: AssetScope): void;
+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. */
+    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. */
+    readonly gap: 0.35;
+    readonly radius: 4;
+    /** How many seconds of audio are on screen at once. */
+    readonly window: 3;
+    /** Seconds into the file the node's first frame shows. */
+    readonly offset: 0;
+    /** 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`. */
+    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.
+     */
+    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. */
+    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. */
+    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. */
+    readonly gap: 0.35;
+    readonly radius: 4;
+    /** How many seconds of audio are on screen at once. */
+    readonly window: 3;
+    /** Seconds into the file the node's first frame shows. */
+    readonly offset: 0;
+    /** 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`. */
+    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>;
     /**
-     * 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.
+     * Show only this voice's activity, by index into the recording's own
+     * numbering. `-1` — the default — is every voice.
      */
-    private get at();
-    protected renderSelf(ctx: RenderContext2D): void;
-    /** See {@link FullWaveform.paintFor} — a voice is a hue, never a gradient. */
-    private paintFor;
-}
+    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. */
+    readonly voiceColors: import("@motionscript/sdk").Type<string[], string[], false>;
+    readonly fill: import("@motionscript/sdk").Type<Fill, FillResolved[], false>;
+}>, null>>;
+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,EACL,MAAM,EAIN,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAIL,KAAK,aAAa,EAEnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAOL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,0EAA0E;IAC1E,QAAQ,EAAE,aAAa,CAAA;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAA;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,iBAAiB,CAAA;IACxB,KAAK,EAAE,aAAa,CAAA;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,IAAI,EAAE,IAAI,CAAA;CACX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAea,YAAa,SAAQ,MAAM,CAAC,iBAAiB,CAAC;IACV,QAAQ,EAAE,aAAa,CAAA;IACnC,IAAI,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,iBAAiB,CAAA;IAC1B,KAAK,EAAE,aAAa,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IAOhD,IAAI,EAAE,IAAI,CAAA;IAET,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKhD;;;;;;;;OAQG;IACH,OAAO,KAAK,EAAE,GAEb;IAED,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAwChD,8EAA8E;IAC9E,OAAO,CAAC,QAAQ;CAMjB"}
+{"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;;;UAU5E,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"}