nodejs-audio-visualizer 5.5.3 → 5.6.4

package/src/subtitleConvert.ts

@@ -1,63 +1,63 @@
-/** LRC timestamp line: [mm:ss.xx] text — hundredths optional after dot. */
-const LRC_LINE = /^\[(\d+):(\d+)(?:\.(\d+))?\]\s*(.*)$/;
-
-export const isLikelyLrc = (text: string): boolean => {
-  const body = text.replace(/^\uFEFF/, '');
-  for (const line of body.split(/\r?\n/)) {
-    const t = line.trim();
-    if (t.length === 0) {
-      continue;
-    }
-    return LRC_LINE.test(t);
-  }
-  return false;
-};
-
-const msToSrtTime = (ms: number): string => {
-  const h = Math.floor(ms / 3600000);
-  const m = Math.floor((ms % 3600000) / 60000);
-  const s = Math.floor((ms % 60000) / 1000);
-  const milli = ms % 1000;
-  const pad = (n: number, w: number) => String(n).padStart(w, '0');
-  return `${pad(h, 2)}:${pad(m, 2)}:${pad(s, 2)},${pad(milli, 3)}`;
-};
-
-const DEFAULT_TAIL_MS = 2000;
-
-export const lrcToSrt = (lrc: string): string => {
-  const body = lrc.replace(/^\uFEFF/, '');
-  const entries: { startMs: number; text: string }[] = [];
-  for (const line of body.split(/\r?\n/)) {
-    const match = line.trim().match(LRC_LINE);
-    if (!match) {
-      continue;
-    }
-    const min = parseInt(match[1], 10);
-    const sec = parseInt(match[2], 10);
-    const centisec =
-      match[3] !== undefined
-        ? parseInt(match[3].padEnd(2, '0').slice(0, 2), 10)
-        : 0;
-    const startMs = (min * 60 + sec) * 1000 + centisec * 10;
-    const text = (match[4] || '').trim();
-    if (text.length > 0) {
-      entries.push({ startMs, text });
-    }
-  }
-  entries.sort((a, b) => a.startMs - b.startMs);
-  let out = '';
-  for (let i = 0; i < entries.length; i++) {
-    const start = entries[i].startMs;
-    const end =
-      i + 1 < entries.length
-        ? Math.max(entries[i + 1].startMs, start + 1)
-        : start + DEFAULT_TAIL_MS;
-    out += `${i + 1}\n`;
-    out += `${msToSrtTime(start)} --> ${msToSrtTime(end)}\n`;
-    out += `${entries[i].text}\n\n`;
-  }
-  return out.length > 0 ? out.replace(/\n*$/, '\n') : '';
-};
-
-export const normalizeInlineSubtitlesToSrt = (text: string): string =>
-  isLikelyLrc(text) ? lrcToSrt(text) : text;
+/** LRC timestamp line: [mm:ss.xx] text — hundredths optional after dot. */
+const LRC_LINE = /^\[(\d+):(\d+)(?:\.(\d+))?\]\s*(.*)$/;
+
+export const isLikelyLrc = (text: string): boolean => {
+  const body = text.replace(/^\uFEFF/, '');
+  for (const line of body.split(/\r?\n/)) {
+    const t = line.trim();
+    if (t.length === 0) {
+      continue;
+    }
+    return LRC_LINE.test(t);
+  }
+  return false;
+};
+
+const msToSrtTime = (ms: number): string => {
+  const h = Math.floor(ms / 3600000);
+  const m = Math.floor((ms % 3600000) / 60000);
+  const s = Math.floor((ms % 60000) / 1000);
+  const milli = ms % 1000;
+  const pad = (n: number, w: number) => String(n).padStart(w, '0');
+  return `${pad(h, 2)}:${pad(m, 2)}:${pad(s, 2)},${pad(milli, 3)}`;
+};
+
+const DEFAULT_TAIL_MS = 2000;
+
+export const lrcToSrt = (lrc: string): string => {
+  const body = lrc.replace(/^\uFEFF/, '');
+  const entries: { startMs: number; text: string }[] = [];
+  for (const line of body.split(/\r?\n/)) {
+    const match = line.trim().match(LRC_LINE);
+    if (!match) {
+      continue;
+    }
+    const min = parseInt(match[1], 10);
+    const sec = parseInt(match[2], 10);
+    const centisec =
+      match[3] !== undefined
+        ? parseInt(match[3].padEnd(2, '0').slice(0, 2), 10)
+        : 0;
+    const startMs = (min * 60 + sec) * 1000 + centisec * 10;
+    const text = (match[4] || '').trim();
+    if (text.length > 0) {
+      entries.push({ startMs, text });
+    }
+  }
+  entries.sort((a, b) => a.startMs - b.startMs);
+  let out = '';
+  for (let i = 0; i < entries.length; i++) {
+    const start = entries[i].startMs;
+    const end =
+      i + 1 < entries.length
+        ? Math.max(entries[i + 1].startMs, start + 1)
+        : start + DEFAULT_TAIL_MS;
+    out += `${i + 1}\n`;
+    out += `${msToSrtTime(start)} --> ${msToSrtTime(end)}\n`;
+    out += `${entries[i].text}\n\n`;
+  }
+  return out.length > 0 ? out.replace(/\n*$/, '\n') : '';
+};
+
+export const normalizeInlineSubtitlesToSrt = (text: string): string =>
+  isLikelyLrc(text) ? lrcToSrt(text) : text;

package/src/tests/audio.test.ts

@@ -1,102 +1,102 @@
-import { expect } from 'chai';
-import { Readable, Writable, Pipe } from 'stream';
-import child_process, { ChildProcessWithoutNullStreams } from 'child_process';
-import {
-  bufferToUInt8,
-  normalizeAudioData,
-  pcmU8ToFloatSamples,
-  spawnFfmpegAudioReader,
-  skipEvery,
-  getPeaks,
-  correctPeaks,
-  createSpectrumsProcessor,
-} from '../audio';
-import { createSandbox } from 'sinon';
-
-let childProcessStream = {
-  stdin: new Writable(),
-  stderr: new Readable(),
-};
-
-const videoSandbox = createSandbox();
-
-describe('audio', function () {
-
-  this.beforeAll(function () {
-    videoSandbox.stub(child_process, 'spawn').returns(childProcessStream as ChildProcessWithoutNullStreams);
-  });
-
-  this.afterAll(function () {
-    videoSandbox.restore();
-  });
-
-  it('bufferToUInt8', function () {
-    const expected = [1, 2, 3, 4, 5];
-    const buffer = Buffer.from(new Uint8Array(expected));
-    const result = bufferToUInt8(buffer, 0, 5);
-    expect(result).deep.equal(expected);
-  });
-
-  it('normalizeAudioData', function () {
-    const result = normalizeAudioData([4, 5, 23, 78, 2]);
-    const expected = [-0.96875, -0.9609375, -0.8203125, -0.390625, -0.984375];
-    expect(result).deep.equal(expected);
-  });
-
-  it('pcmU8ToFloatSamples', function () {
-    const buffer = Buffer.from([128, 255, 0]);
-    expect(pcmU8ToFloatSamples(buffer)).deep.equal([0, 127 / 128, -1]);
-  });
-
-  it('spawnFfmpegAudioReader', function (done) {
-    const childProcessReadableStream = new Readable();
-    const childProcessWritableStream = new Writable();
-    childProcessReadableStream._read = () => { done(); };
-    (<Pipe>childProcessWritableStream.pipe) = () => childProcessWritableStream;
-
-    childProcessStream.stdin = childProcessWritableStream;
-    childProcessStream.stderr = childProcessReadableStream;
-
-    const ffmpegProcess = spawnFfmpegAudioReader('filename', 'format');
-    ffmpegProcess.stderr.on('data', (data) => {
-      expect(data).equal('some data');
-    });
-
-    childProcessStream.stderr.emit('data', 'some data');
-  });
-
-  it('skipEvery', () => {
-    const sampleData = [1, 2, 3, 4];
-    const result = sampleData.filter(skipEvery(2));
-    const expected = [1, 3];
-    expect(result).deep.equal(expected);
-  });
-
-  it('getPeaks', () => {
-    const sampleData = [1, 2, 3, 4];
-    const prevPeaks = [2, 2, 2, 5];
-    const resultNoPrevPeaks = getPeaks(sampleData);
-    expect(resultNoPrevPeaks).deep.equal(sampleData);
-    const resultWithPrevPeaks = getPeaks(sampleData, prevPeaks);
-    const expectedWithPrevPeaks = [2, 2, 3, 5];
-    expect(resultWithPrevPeaks).deep.equal(expectedWithPrevPeaks);
-  });
-
-  it('correctPeaks', () => {
-    const spectrums = [1, 2, 3, 4];
-    const peaks = [2, 2, 3, 5];
-    const result = correctPeaks(spectrums, peaks);
-    const expected = [1 / 3, 2 / 3, 1, 0.8];
-    expect(result).deep.equal(expected);
-  });
-
-
-  it('createSpectrumsProcessor', () => {
-    const spectrumsProcessor = createSpectrumsProcessor(44100);
-    
-    const frame0 = spectrumsProcessor(() => ([1, 2, 3, 4]));
-    expect(frame0).to.have.length(24);
-    const frame1 = spectrumsProcessor(() => ([2, 2, 6, 2]));
-    expect(frame1).to.have.length(24);
-  });
-});
+import { expect } from 'chai';
+import { Readable, Writable, Pipe } from 'stream';
+import child_process, { ChildProcessWithoutNullStreams } from 'child_process';
+import {
+  bufferToUInt8,
+  normalizeAudioData,
+  pcmU8ToFloatSamples,
+  spawnFfmpegAudioReader,
+  skipEvery,
+  getPeaks,
+  correctPeaks,
+  createSpectrumsProcessor,
+} from '../audio';
+import { createSandbox } from 'sinon';
+
+let childProcessStream = {
+  stdin: new Writable(),
+  stderr: new Readable(),
+};
+
+const videoSandbox = createSandbox();
+
+describe('audio', function () {
+
+  this.beforeAll(function () {
+    videoSandbox.stub(child_process, 'spawn').returns(childProcessStream as ChildProcessWithoutNullStreams);
+  });
+
+  this.afterAll(function () {
+    videoSandbox.restore();
+  });
+
+  it('bufferToUInt8', function () {
+    const expected = [1, 2, 3, 4, 5];
+    const buffer = Buffer.from(new Uint8Array(expected));
+    const result = bufferToUInt8(buffer, 0, 5);
+    expect(result).deep.equal(expected);
+  });
+
+  it('normalizeAudioData', function () {
+    const result = normalizeAudioData([4, 5, 23, 78, 2]);
+    const expected = [-0.96875, -0.9609375, -0.8203125, -0.390625, -0.984375];
+    expect(result).deep.equal(expected);
+  });
+
+  it('pcmU8ToFloatSamples', function () {
+    const buffer = Buffer.from([128, 255, 0]);
+    expect(pcmU8ToFloatSamples(buffer)).deep.equal([0, 127 / 128, -1]);
+  });
+
+  it('spawnFfmpegAudioReader', function (done) {
+    const childProcessReadableStream = new Readable();
+    const childProcessWritableStream = new Writable();
+    childProcessReadableStream._read = () => { done(); };
+    (<Pipe>childProcessWritableStream.pipe) = () => childProcessWritableStream;
+
+    childProcessStream.stdin = childProcessWritableStream;
+    childProcessStream.stderr = childProcessReadableStream;
+
+    const ffmpegProcess = spawnFfmpegAudioReader('filename', 'format');
+    ffmpegProcess.stderr.on('data', (data) => {
+      expect(data).equal('some data');
+    });
+
+    childProcessStream.stderr.emit('data', 'some data');
+  });
+
+  it('skipEvery', () => {
+    const sampleData = [1, 2, 3, 4];
+    const result = sampleData.filter(skipEvery(2));
+    const expected = [1, 3];
+    expect(result).deep.equal(expected);
+  });
+
+  it('getPeaks', () => {
+    const sampleData = [1, 2, 3, 4];
+    const prevPeaks = [2, 2, 2, 5];
+    const resultNoPrevPeaks = getPeaks(sampleData);
+    expect(resultNoPrevPeaks).deep.equal(sampleData);
+    const resultWithPrevPeaks = getPeaks(sampleData, prevPeaks);
+    const expectedWithPrevPeaks = [2, 2, 3, 5];
+    expect(resultWithPrevPeaks).deep.equal(expectedWithPrevPeaks);
+  });
+
+  it('correctPeaks', () => {
+    const spectrums = [1, 2, 3, 4];
+    const peaks = [2, 2, 3, 5];
+    const result = correctPeaks(spectrums, peaks);
+    const expected = [1 / 3, 2 / 3, 1, 0.8];
+    expect(result).deep.equal(expected);
+  });
+
+
+  it('createSpectrumsProcessor', () => {
+    const spectrumsProcessor = createSpectrumsProcessor(44100);
+    
+    const frame0 = spectrumsProcessor(() => ([1, 2, 3, 4]));
+    expect(frame0).to.have.length(24);
+    const frame1 = spectrumsProcessor(() => ([2, 2, 6, 2]));
+    expect(frame1).to.have.length(24);
+  });
+});

package/src/tests/beats.test.ts

@@ -1,134 +1,134 @@
-import { expect } from 'chai';
-import { estimateTempo, beatGridFrameIndices, shiftTempoPhase, tempoForWindow } from '../beats';
-
-const clickTrain = (
-  sampleRate: number,
-  bpm: number,
-  durationSec: number,
-  phaseSec = 0,
-  halfPeriodGhost = 0,
-): number[] => {
-  const n = Math.round(sampleRate * durationSec);
-  const samples = new Array<number>(n).fill(0);
-  const period = 60 / bpm;
-  const clickLen = Math.round(sampleRate * 0.01);
-  const addClick = (timeSec: number, amplitude: number) => {
-    const start = Math.round(timeSec * sampleRate);
-    for (let i = 0; i < clickLen && start + i < n; i++) {
-      const env = Math.exp(-i / (clickLen * 0.25));
-      samples[start + i] += amplitude * env * (i % 2 === 0 ? 1 : -0.7);
-    }
-  };
-  for (let t = phaseSec; t < durationSec; t += period) {
-    addClick(t, 1);
-    if (halfPeriodGhost > 0) {
-      addClick(t + period / 2, halfPeriodGhost);
-    }
-  }
-  return samples;
-};
-
-describe('beats', function () {
-  this.timeout(10000);
-
-  it('estimateTempo detects 128 BPM from a click train', function () {
-    const sampleRate = 22050;
-    const fps = 30;
-    const tempo = estimateTempo(clickTrain(sampleRate, 128, 8), sampleRate, fps);
-    expect(tempo).not.equal(null);
-    expect(tempo!.bpm).closeTo(128, 8);
-    expect(tempo!.periodFrames).closeTo(fps * 60 / 128, 1);
-  });
-
-  it('estimateTempo recovers phase of the click train', function () {
-    const sampleRate = 22050;
-    const fps = 30;
-    const phaseSec = 0.1;
-    const tempo = estimateTempo(clickTrain(sampleRate, 128, 8, phaseSec), sampleRate, fps);
-    expect(tempo).not.equal(null);
-    expect(tempo!.phaseFrame).closeTo(phaseSec * fps, 2);
-  });
-
-  it('estimateTempo prefers ~128 BPM when half-period ghosts are present', function () {
-    const sampleRate = 22050;
-    const fps = 30;
-    const tempo = estimateTempo(clickTrain(sampleRate, 128, 8, 0, 0.35), sampleRate, fps);
-    expect(tempo).not.equal(null);
-    expect(tempo!.bpm).closeTo(128, 8);
-  });
-
-  it('estimateTempo returns null for silence', function () {
-    const sampleRate = 22050;
-    const samples = new Array<number>(sampleRate * 2).fill(0);
-    expect(estimateTempo(samples, sampleRate, 30)).equal(null);
-  });
-
-  it('estimateTempo returns null for empty or invalid input', function () {
-    expect(estimateTempo([], 22050, 30)).equal(null);
-    expect(estimateTempo(clickTrain(22050, 128, 8), 0, 30)).equal(null);
-    expect(estimateTempo(clickTrain(22050, 128, 8), 22050, 0)).equal(null);
-  });
-
-  it('shiftTempoPhase wraps the beat grid into a later window', function () {
-    expect(shiftTempoPhase({ bpm: 120, periodFrames: 15, phaseFrame: 3 }, 0)).deep.equal({
-      bpm: 120,
-      periodFrames: 15,
-      phaseFrame: 3,
-    });
-    expect(shiftTempoPhase({ bpm: 120, periodFrames: 15, phaseFrame: 3 }, 3).phaseFrame).equal(0);
-    expect(shiftTempoPhase({ bpm: 120, periodFrames: 15, phaseFrame: 3 }, 18).phaseFrame).equal(0);
-  });
-
-  it('shiftTempoPhase keeps a non-integer period aligned in a late window', function () {
-    const tempo = { bpm: 128, periodFrames: 14.0625, phaseFrame: 3 };
-    const startFrame = 2000;
-    const shifted = shiftTempoPhase(tempo, startFrame);
-    const expected: number[] = [];
-    for (let n = 0; n < 400; n++) {
-      const local = Math.round(tempo.phaseFrame + n * tempo.periodFrames) - startFrame;
-      if (local > 0 && local < 60) {
-        expected.push(local);
-      }
-    }
-    expect(beatGridFrameIndices(shifted, 60)).deep.equal(expected);
-  });
-
-  it('tempoForWindow locks phase to beat times inside the edited window', function () {
-    const fps = 30;
-    const periodFrames = 15;
-    const startFrame = 90;
-    const tempo = {
-      bpm: 120,
-      periodFrames,
-      phaseFrame: 1,
-      beatsSec: [0.1, 3.2, 3.7, 4.2, 4.7],
-    };
-    const windowed = tempoForWindow(tempo, startFrame, fps, 60);
-    expect(windowed.phaseFrame).closeTo(6, 1);
-    expect(shiftTempoPhase(tempo, startFrame).phaseFrame).closeTo(1, 0.001);
-    expect(beatGridFrameIndices(windowed, 50)[0]).closeTo(6, 1);
-    expect(tempoForWindow(tempo, startFrame, fps, 60, [1, 16, 31]).phaseFrame).closeTo(6, 1);
-  });
-
-  it('tempoForWindow falls back to local onsets when beat times are outside the window', function () {
-    const tempo = {
-      bpm: 120,
-      periodFrames: 15,
-      phaseFrame: 1,
-      beatsSec: [0.1, 0.6, 1.1],
-    };
-    const windowed = tempoForWindow(tempo, 90, 30, 60, [7, 22, 37]);
-    expect(windowed.phaseFrame).closeTo(7, 1);
-  });
-
-  it('beatGridFrameIndices emits every beat and skips frame 0', function () {
-    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 0 }, 50)).deep.equal([14, 28, 42]);
-    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 3 }, 32)).deep.equal([3, 17, 31]);
-    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 0 }, 14)).deep.equal([]);
-  });
-
-  it('beatGridFrameIndices stride emits every Nth beat', function () {
-    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 0 }, 200, 4)).deep.equal([14, 70, 126, 182]);
-    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 3 }, 200, 4)).deep.equal([3, 59, 115, 171]);
-  });
-});
+import { expect } from 'chai';
+import { estimateTempo, beatGridFrameIndices, shiftTempoPhase, tempoForWindow } from '../beats';
+
+const clickTrain = (
+  sampleRate: number,
+  bpm: number,
+  durationSec: number,
+  phaseSec = 0,
+  halfPeriodGhost = 0,
+): number[] => {
+  const n = Math.round(sampleRate * durationSec);
+  const samples = new Array<number>(n).fill(0);
+  const period = 60 / bpm;
+  const clickLen = Math.round(sampleRate * 0.01);
+  const addClick = (timeSec: number, amplitude: number) => {
+    const start = Math.round(timeSec * sampleRate);
+    for (let i = 0; i < clickLen && start + i < n; i++) {
+      const env = Math.exp(-i / (clickLen * 0.25));
+      samples[start + i] += amplitude * env * (i % 2 === 0 ? 1 : -0.7);
+    }
+  };
+  for (let t = phaseSec; t < durationSec; t += period) {
+    addClick(t, 1);
+    if (halfPeriodGhost > 0) {
+      addClick(t + period / 2, halfPeriodGhost);
+    }
+  }
+  return samples;
+};
+
+describe('beats', function () {
+  this.timeout(10000);
+
+  it('estimateTempo detects 128 BPM from a click train', function () {
+    const sampleRate = 22050;
+    const fps = 30;
+    const tempo = estimateTempo(clickTrain(sampleRate, 128, 8), sampleRate, fps);
+    expect(tempo).not.equal(null);
+    expect(tempo!.bpm).closeTo(128, 8);
+    expect(tempo!.periodFrames).closeTo(fps * 60 / 128, 1);
+  });
+
+  it('estimateTempo recovers phase of the click train', function () {
+    const sampleRate = 22050;
+    const fps = 30;
+    const phaseSec = 0.1;
+    const tempo = estimateTempo(clickTrain(sampleRate, 128, 8, phaseSec), sampleRate, fps);
+    expect(tempo).not.equal(null);
+    expect(tempo!.phaseFrame).closeTo(phaseSec * fps, 2);
+  });
+
+  it('estimateTempo prefers ~128 BPM when half-period ghosts are present', function () {
+    const sampleRate = 22050;
+    const fps = 30;
+    const tempo = estimateTempo(clickTrain(sampleRate, 128, 8, 0, 0.35), sampleRate, fps);
+    expect(tempo).not.equal(null);
+    expect(tempo!.bpm).closeTo(128, 8);
+  });
+
+  it('estimateTempo returns null for silence', function () {
+    const sampleRate = 22050;
+    const samples = new Array<number>(sampleRate * 2).fill(0);
+    expect(estimateTempo(samples, sampleRate, 30)).equal(null);
+  });
+
+  it('estimateTempo returns null for empty or invalid input', function () {
+    expect(estimateTempo([], 22050, 30)).equal(null);
+    expect(estimateTempo(clickTrain(22050, 128, 8), 0, 30)).equal(null);
+    expect(estimateTempo(clickTrain(22050, 128, 8), 22050, 0)).equal(null);
+  });
+
+  it('shiftTempoPhase wraps the beat grid into a later window', function () {
+    expect(shiftTempoPhase({ bpm: 120, periodFrames: 15, phaseFrame: 3 }, 0)).deep.equal({
+      bpm: 120,
+      periodFrames: 15,
+      phaseFrame: 3,
+    });
+    expect(shiftTempoPhase({ bpm: 120, periodFrames: 15, phaseFrame: 3 }, 3).phaseFrame).equal(0);
+    expect(shiftTempoPhase({ bpm: 120, periodFrames: 15, phaseFrame: 3 }, 18).phaseFrame).equal(0);
+  });
+
+  it('shiftTempoPhase keeps a non-integer period aligned in a late window', function () {
+    const tempo = { bpm: 128, periodFrames: 14.0625, phaseFrame: 3 };
+    const startFrame = 2000;
+    const shifted = shiftTempoPhase(tempo, startFrame);
+    const expected: number[] = [];
+    for (let n = 0; n < 400; n++) {
+      const local = Math.round(tempo.phaseFrame + n * tempo.periodFrames) - startFrame;
+      if (local > 0 && local < 60) {
+        expected.push(local);
+      }
+    }
+    expect(beatGridFrameIndices(shifted, 60)).deep.equal(expected);
+  });
+
+  it('tempoForWindow locks phase to beat times inside the edited window', function () {
+    const fps = 30;
+    const periodFrames = 15;
+    const startFrame = 90;
+    const tempo = {
+      bpm: 120,
+      periodFrames,
+      phaseFrame: 1,
+      beatsSec: [0.1, 3.2, 3.7, 4.2, 4.7],
+    };
+    const windowed = tempoForWindow(tempo, startFrame, fps, 60);
+    expect(windowed.phaseFrame).closeTo(6, 1);
+    expect(shiftTempoPhase(tempo, startFrame).phaseFrame).closeTo(1, 0.001);
+    expect(beatGridFrameIndices(windowed, 50)[0]).closeTo(6, 1);
+    expect(tempoForWindow(tempo, startFrame, fps, 60, [1, 16, 31]).phaseFrame).closeTo(6, 1);
+  });
+
+  it('tempoForWindow falls back to local onsets when beat times are outside the window', function () {
+    const tempo = {
+      bpm: 120,
+      periodFrames: 15,
+      phaseFrame: 1,
+      beatsSec: [0.1, 0.6, 1.1],
+    };
+    const windowed = tempoForWindow(tempo, 90, 30, 60, [7, 22, 37]);
+    expect(windowed.phaseFrame).closeTo(7, 1);
+  });
+
+  it('beatGridFrameIndices emits every beat and skips frame 0', function () {
+    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 0 }, 50)).deep.equal([14, 28, 42]);
+    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 3 }, 32)).deep.equal([3, 17, 31]);
+    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 0 }, 14)).deep.equal([]);
+  });
+
+  it('beatGridFrameIndices stride emits every Nth beat', function () {
+    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 0 }, 200, 4)).deep.equal([14, 70, 126, 182]);
+    expect(beatGridFrameIndices({ periodFrames: 14, phaseFrame: 3 }, 200, 4)).deep.equal([3, 59, 115, 171]);
+  });
+});