import { beforeEach, describe, expect, it } from "vitest";
import {
audioGroupOf,
ensureAudioGroupInertStyle,
HF_AUDIO_GROUP_ATTR,
isMemberGroupHidden,
readMasterFxChain,
resolveAudioGroups,
resolveCarveSourceIds,
resolveGroupElement,
} from "./audioGroups.js";
import { AUDIO_GROUP_RENDER_ID_ATTR, MEDIA_RENDER_ID_ATTR } from "./compiler/mediaRenderIds.js";
beforeEach(() => {
document.body.innerHTML = "";
});
describe("resolveAudioGroups", () => {
it("returns one group of two members plus ignores an ungrouped track", () => {
document.body.innerHTML = `
`;
const groups = resolveAudioGroups(document);
expect(groups).toEqual([
{
id: "voiceover",
label: "Voiceover",
memberIds: ["vo-1", "vo-2"],
volume: 1,
hidden: false,
},
]);
});
it("resolves from member tags alone when the group element is absent, label = id", () => {
document.body.innerHTML = `
`;
const groups = resolveAudioGroups(document);
expect(groups).toEqual([
{ id: "narration", label: "narration", memberIds: ["vo-1"], volume: 1, hidden: false },
]);
});
it("ignores data-audio-group on the group element itself (groups do not nest)", () => {
document.body.innerHTML = `
`;
const groups = resolveAudioGroups(document);
expect(groups).toEqual([
{ id: "outer", label: "outer", memberIds: ["vo-1"], volume: 1, hidden: false },
]);
expect(audioGroupOf(document.getElementById("outer") as Element)).toBeNull();
});
it("drops a member removed from the DOM on re-resolve — nothing dangles", () => {
document.body.innerHTML = `
`;
expect(resolveAudioGroups(document)[0].memberIds).toEqual(["vo-1", "vo-2"]);
document.getElementById("vo-2")?.remove();
expect(resolveAudioGroups(document)[0].memberIds).toEqual(["vo-1"]);
});
it("groups an audible video and ignores a muted or silent one", () => {
document.body.innerHTML = `
`;
expect(resolveAudioGroups(document).map((g) => g.memberIds)).toEqual([["v-1"]]);
});
it("reads the group element's fx chain, automation, volume and hidden", () => {
document.body.innerHTML = `
`;
const groups = resolveAudioGroups(document);
expect(groups).toEqual([
{
id: "voiceover",
label: "voiceover",
memberIds: ["vo-1"],
fxChain: '{"version":1,"nodes":[]}',
automation: '{"lanes":[]}',
volume: 0.5,
hidden: true,
},
]);
});
it("defaults volume to 1 and hidden to false when a group element exists but carries neither", () => {
document.body.innerHTML = `
`;
const [group] = resolveAudioGroups(document);
expect(group?.volume).toBe(1);
expect(group?.hidden).toBe(false);
expect(group?.fxChain).toBeUndefined();
expect(group?.automation).toBeUndefined();
});
});
describe("audioGroupOf", () => {
it("reads the member's group id", () => {
document.body.innerHTML = ``;
expect(audioGroupOf(document.getElementById("vo-1") as Element)).toBe("voiceover");
});
it("returns null when the attribute is absent", () => {
document.body.innerHTML = ``;
expect(audioGroupOf(document.getElementById("vo-1") as Element)).toBeNull();
});
it("reads an audible video's membership and ignores a muted video's", () => {
document.body.innerHTML = `
`;
expect(audioGroupOf(document.getElementById("v-1") as Element)).toBe("voiceover");
expect(audioGroupOf(document.getElementById("v-2") as Element)).toBeNull();
});
it("normalizes an empty membership attribute to null", () => {
document.body.innerHTML = ``;
expect(audioGroupOf(document.getElementById("vo-1") as Element)).toBeNull();
expect(resolveAudioGroups(document)).toEqual([]);
});
// Groups do not nest, and the group element is not a member of itself.
it("returns null for the group element even when it carries the attribute", () => {
document.body.innerHTML = ``;
expect(audioGroupOf(document.getElementById("bus") as Element)).toBeNull();
});
});
describe("resolveCarveSourceIds", () => {
it("expands a group id to its current members", () => {
document.body.innerHTML = `
`;
expect(resolveCarveSourceIds(document, ["voiceover"])).toEqual(["vo-1", "vo-2"]);
});
it("picks up a member added to the group after the carve was set (analysis-time, not frozen)", () => {
document.body.innerHTML = `
`;
expect(resolveCarveSourceIds(document, ["voiceover"])).toEqual(["vo-1", "vo-2"]);
document.body.insertAdjacentHTML(
"beforeend",
``,
);
expect(resolveCarveSourceIds(document, ["voiceover"])).toEqual(["vo-1", "vo-2", "vo-3"]);
});
it("passes through a plain clip id that still exists", () => {
document.body.innerHTML = ``;
expect(resolveCarveSourceIds(document, ["vo-1"])).toEqual(["vo-1"]);
});
it("drops an id that resolves to nothing — a deleted clip, an empty or vanished group", () => {
document.body.innerHTML = ``;
expect(resolveCarveSourceIds(document, ["vo-1", "deleted", "no-such-group"])).toEqual(["vo-1"]);
});
it("dedupes and preserves first-seen order across a mix of group and plain ids", () => {
document.body.innerHTML = `
`;
expect(resolveCarveSourceIds(document, ["voiceover", "vo-1"])).toEqual(["vo-1", "vo-2"]);
});
});
describe(HF_AUDIO_GROUP_ATTR, () => {
it("is the attribute name membership is keyed on", () => {
expect(HF_AUDIO_GROUP_ATTR).toBe("data-audio-group");
});
});
describe("resolveGroupElement", () => {
const doc = (html: string): Document => {
const d = document.implementation.createHTMLDocument("t");
d.body.innerHTML = html;
return d;
};
it("returns the bus for a real ", () => {
const d = doc(``);
expect(resolveGroupElement(d, "vo")?.tagName.toLowerCase()).toBe("hf-audio-group");
});
// The trap: a bare getElementById read a member's OWN fader and chain as the
// bus's, applying both a second time on the sub-mix.
it("refuses an