Home Manual Reference Source Test

tests/theory.test.js

  1. import { describe, it, expect } from "vitest";
  2. import { chordName, chordGraph, timeGrid } from "../src/model/theory.js";
  4. /** @test {chordName} */
  5. describe("chordName", () => {
  6.   /** @test {chordName} */
  7.   it("returns label form without keyIndex; transposes to concrete chord with sharp/flat spelling and quality suffix; passes NC and unknowns through", () => {
  8.     expect(chordName("I")).toBe("I: Tonic");
  9.     expect(chordName("V")).toBe("V: Dominant");
  10.     expect(chordName("NC")).toBe("NC: No Chord");
  11.     expect(chordName("UNKNOWN")).toBe("UNKNOWN");
  12.     expect(chordName("NC", 0)).toBe("NC");
  13.     expect(chordName("I", 0)).toBe("C");
  14.     expect(chordName("I", 7)).toBe("G");
  15.     expect(chordName("vi", 0)).toBe("Am");
  16.     expect(chordName("viio", 0)).toBe("Bo");
  17.     expect(chordName("UNKNOWN", 0)).toBe("UNKNOWN");
  18.   });
  19. });
  21. /** @test {chordGraph} */
  22. describe("chordGraph", () => {
  23.   /** @test {chordGraph} */
  24.   it("provides major and minor defaults with nodes, tonic, cadence-normal-NC-loop cost ordering and edges aligned with costs.keys()", () => {
  25.     const major = chordGraph();
  26.     expect(major.tonic).toBe("I");
  27.     expect(major.nodes).toEqual("I ii iii IV V vi viio NC".split(" "));
  28.     expect(major.activeNodes).toEqual(major.nodes);
  30.     const c = major.costs;
  31.     expect(c.get("V->I")).toBeLessThan(c.get("I->ii"));
  32.     expect(c.get("I->ii")).toBeLessThan(c.get("I->NC"));
  33.     expect(c.get("I->NC")).toBeLessThan(c.get("I->I"));
  34.     expect(major.edges.every(([u, v]) => c.has(`${u}->${v}`))).toBe(true);
  36.     const minor = chordGraph("minor");
  37.     expect(minor.tonic).toBe("i");
  38.     expect(minor.nodes).toContain("bVI");
  39.     expect(minor.nodes).toContain("bVII");
  40.     expect(minor.costs.get("V->i")).toBeLessThan(minor.costs.get("i->iv"));
  41.   });
  43.   /** @test {chordGraph} */
  44.   it("adds chromatic nodes from a preset, applies preset costs, clamps self-loops and skips unknown edges", () => {
  45.     const baseLoopCost = chordGraph("major").costs.get("I->I");
  46.     const g = chordGraph("major", {
  47.       major: {
  48.         chromatic: ["bII"],
  49.         edges: { "I->bII": 3, "bII->V": 5, "I->I": 1, "Foo->Bar": 99 },
  50.       },
  51.     });
  52.     expect(g.nodes).toContain("bII");
  53.     expect(g.costs.get("I->bII")).toBe(3);
  54.     expect(g.costs.get("bII->V")).toBe(5);
  55.     expect(g.costs.get("I->I")).toBe(baseLoopCost);
  56.     expect(g.costs.has("Foo->Bar")).toBe(false);
  57.   });
  58. });
  60. /** @test {timeGrid} */
  61. describe("timeGrid", () => {
  62.   /** @test {timeGrid} */
  63.   it("derives tau as LCM of voice durations (1 for unknowns), T = iota * zeta * tau, and per-voice onset sets", () => {
  64.     const v = (duration) => ({ duration });
  65.     expect(
  66.       timeGrid([v("whole"), v("eighth"), v("triplet")], 3, 4, 1).subdivision,
  67.     ).toBe(6);
  68.     expect(timeGrid([v("half"), v("sixteenth")], 2, 4, 1).subdivision).toBe(4);
  69.     expect(timeGrid([v("weird")], 1, 4, 1).subdivision).toBe(1);
  71.     const t = timeGrid([v("quarter"), v("eighth")], 2, 4, 2);
  72.     expect(t.subdivision).toBe(2);
  73.     expect(t.subBeatsPerBar).toBe(8);
  74.     expect(t.numSubBeats).toBe(16);
  75.     expect(t.activeBeats[0].has(0)).toBe(true);
  76.     expect(t.activeBeats[1].has(1)).toBe(true);
  77.   });
  78. });