Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
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));
});
});
});