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