Skip to content

Write HTML. Render video. Built for agents.

2.6 KB
Raw Blame
import { describe, expect, it } from "vitest";
import {
  AUDIO_GAIN_FADER_MAX,
  formatAudioGain,
  AUDIO_GAIN_FADER_MIN,
  MAX_AUDIO_GAIN,
  audioDbToGain,
  audioGainToDb,
  audioGainToFaderPosition,
  audioGainToText,
  audioFaderPositionToGain,
} from "./audioGain";

describe("audio gain fader", () => {
  it("converts decibels to linear gain", () => {
    expect(audioDbToGain(0)).toBe(1);
    expect(audioDbToGain(-6)).toBeCloseTo(10 ** (-6 / 20), 10);
    expect(MAX_AUDIO_GAIN).toBe(audioDbToGain(12));
    expect(audioGainToDb(1)).toBeCloseTo(0, 10);
    expect(audioGainToDb(audioDbToGain(-6))).toBeCloseTo(-6, 10);
  });

  it("puts unity gain at the physical midpoint", () => {
    expect(audioGainToFaderPosition(1)).toBe(0);
    expect(audioFaderPositionToGain(0)).toBe(1);
  });

  it("provides +12 dB of boost above unity", () => {
    expect(audioFaderPositionToGain(AUDIO_GAIN_FADER_MAX)).toBeCloseTo(MAX_AUDIO_GAIN, 6);
    expect(audioGainToText(MAX_AUDIO_GAIN)).toBe("+12.0 dB");
  });

  it("preserves a true silence endpoint below unity", () => {
    expect(audioFaderPositionToGain(AUDIO_GAIN_FADER_MIN)).toBe(0);
    expect(audioGainToText(0)).toBe("-∞ dB");
  });

  it("pins sub-floor gain to the fader's silence endpoint", () => {
    expect(audioGainToFaderPosition(0.00001)).toBe(AUDIO_GAIN_FADER_MIN);
  });

  it("round-trips representative attenuation and boost values", () => {
    for (const gain of [0.1, 0.5, 1, 2, MAX_AUDIO_GAIN]) {
      expect(audioFaderPositionToGain(audioGainToFaderPosition(gain))).toBeCloseTo(gain, 6);
    }
  });

  describe("formatAudioGain", () => {
    it("never collapses an audible fader stop onto silence", () => {
      for (let position = AUDIO_GAIN_FADER_MIN + 1; position <= AUDIO_GAIN_FADER_MAX; position++) {
        const serialized = formatAudioGain(audioFaderPositionToGain(position));
        expect(Number(serialized)).toBeGreaterThan(0);
      }
      // Only the very bottom of the travel is a real mute.
      expect(formatAudioGain(audioFaderPositionToGain(AUDIO_GAIN_FADER_MIN))).toBe("0");
    });

    it("puts the knob back where the user let go of it", () => {
      for (let position = AUDIO_GAIN_FADER_MIN; position <= AUDIO_GAIN_FADER_MAX; position++) {
        const written = Number(formatAudioGain(audioFaderPositionToGain(position)));
        expect(Math.round(audioGainToFaderPosition(written))).toBe(position);
      }
    });

    it("keeps a serialized gain short and inside the ceiling", () => {
      expect(formatAudioGain(1)).toBe("1");
      expect(formatAudioGain(0.5)).toBe("0.5");
      expect(formatAudioGain(99)).toBe(formatAudioGain(MAX_AUDIO_GAIN));
    });
  });
});