Skip to content

Write HTML. Render video. Built for agents.

31.3 KB
Raw Blame
/**
 * @vitest-environment jsdom
 */
import { describe, it, expect } from "vitest";
import { ensureHfIds } from "./hfIds.js";
import {
  parseHtml,
  updateElementInHtml,
  addElementToHtml,
  removeElementFromHtml,
  validateCompositionHtml,
  extractCompositionMetadata,
} from "./htmlParser.js";

describe("parseHtml", () => {
  it("preserves runtime HTML normalization for mixed-case attributes", () => {
    const result = parseHtml(`<!doctype html><HTML DATA-RESOLUTION="square"><BODY>
      <DIV ID="x" DATA-START="2" DATA-DURATION="3" DATA-TRACK-INDEX="4" DATA-NAME="UP"><DIV>hello</DIV></DIV>
    </BODY></HTML>`);
    expect(result.resolution).toBe("square");
    expect(result.elements).toHaveLength(1);
    expect(result.elements[0]).toMatchObject({
      startTime: 2,
      duration: 3,
      zIndex: 4,
      name: "UP",
      content: "hello",
    });
  });

  it.each([
    `<DIV ID="x" DATA-START="2" DATA-DURATION="3" DATA-NAME="UP"><DIV>hello</DIV></DIV>`,
    `<DIV ID="x" DATA-START="2" DATA-HF-ID="pinned" DATA-HF-STATE="ignored"><DIV>hello</DIV></DIV>`,
  ])("matches persisted and runtime IDs for mixed-case HTML: %s", (body) => {
    const html = `<!doctype html><html><body>${body}</body></html>`;
    const first = parseHtml(html);
    const persisted = parseHtml(ensureHfIds(html));
    expect(first.elements.length).toBeGreaterThan(0);
    expect(first.elements.map((element) => element.id)).toEqual(
      persisted.elements.map((element) => element.id),
    );
  });

  it("extracts elements with data-start and data-end", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5" data-name="Title"><div>Hello World</div></div>
          <div id="text2" data-start="2" data-end="7" data-name="Subtitle"><div>Sub</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.elements).toHaveLength(2);
    expect(result.elements[0].id).toMatch(/^hf-[a-z0-9]{4}$/);
    expect(result.elements[0].startTime).toBe(0);
    expect(result.elements[0].duration).toBe(5);
    expect(result.elements[0].name).toBe("Title");
    expect(result.elements[0].type).toBe("text");

    expect(result.elements[1].id).toMatch(/^hf-[a-z0-9]{4}$/);
    expect(result.elements[1].startTime).toBe(2);
    expect(result.elements[1].duration).toBe(5);
  });

  it("prefers canonical duration/track attributes over conflicting legacy values", () => {
    const result = parseHtml(`
      <html><body><div id="stage">
        <div id="clip" data-start="1" data-duration="2.5" data-end="99" data-track-index="3" data-layer="8"><div>Clip</div></div>
      </div></body></html>
    `);

    expect(result.elements[0]).toMatchObject({ startTime: 1, duration: 2.5, zIndex: 3 });
  });

  it("resolves chained start references with the shared grammar", () => {
    const result = parseHtml(`
      <html><body><div id="stage">
        <div id="intro" data-start="0" data-duration="2"><div>Intro</div></div>
        <div id="body" data-start="intro + .5" data-duration="3"><div>Body</div></div>
        <div id="outro" data-start="body" data-duration="1"><div>Outro</div></div>
      </div></body></html>
    `);

    expect(result.elements.find(({ name }) => name === "Body")?.startTime).toBe(2.5);
    expect(result.elements.find(({ name }) => name === "Outro")?.startTime).toBe(5.5);
  });

  it("handles nested compositions", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="comp1" data-start="0" data-end="10" data-type="composition" data-composition-id="abc123">
            <iframe src="/compositions/abc123"></iframe>
          </div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.elements).toHaveLength(1);
    expect(result.elements[0].type).toBe("composition");
    expect(result.elements[0].id).toMatch(/^hf-[a-z0-9]{4}$/);
    if (result.elements[0].type === "composition") {
      expect(result.elements[0].compositionId).toBe("abc123");
      expect(result.elements[0].src).toBe("/compositions/abc123");
    }
  });

  it("extracts media elements (video, audio, img)", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <video id="vid1" data-start="0" data-end="10" src="video.mp4" data-name="My Video"></video>
          <audio id="aud1" data-start="0" data-end="5" src="music.mp3" data-name="Music"></audio>
          <img id="img1" data-start="2" data-end="8" src="photo.jpg" data-name="Photo" />
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.elements).toHaveLength(3);

    const video = result.elements.find((e) => e.type === "video");
    expect(video).toBeDefined();
    expect(video?.id).toMatch(/^hf-[a-z0-9]{4}$/);
    if (video?.type === "video") {
      expect(video.src).toBe("video.mp4");
    }

    const audio = result.elements.find((e) => e.type === "audio");
    expect(audio).toBeDefined();
    expect(audio?.id).toMatch(/^hf-[a-z0-9]{4}$/);

    const img = result.elements.find((e) => e.type === "image");
    expect(img).toBeDefined();
    expect(img?.id).toMatch(/^hf-[a-z0-9]{4}$/);
  });

  it("handles missing attributes gracefully", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="el1" data-start="3"><div>Some text</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.elements).toHaveLength(1);
    expect(result.elements[0].startTime).toBe(3);
    // Default duration is 5 when data-end is missing
    expect(result.elements[0].duration).toBe(5);
  });

  it("assigns generated ids when elements have no id", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div data-start="0" data-end="5"><div>No ID</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.elements).toHaveLength(1);
    expect(result.elements[0].id).toMatch(/^hf-[a-z0-9]{4}$/);
  });

  it("extracts GSAP script from script tags", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
        <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
        <script>
          const tl = gsap.timeline({ paused: true });
          tl.to("#text1", { opacity: 1, duration: 1 }, 0);
        </script>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.gsapScript).not.toBeNull();
    expect(result.gsapScript).toContain("gsap.timeline");
    expect(result.gsapScript).toContain('tl.to("#text1"');
  });

  it("extracts GSAP script from composition templates", () => {
    const html = `
      <html>
      <body>
        <div id="stage"></div>
        <template data-composition-id="sub-comp">
          <script>const tl = gsap.timeline({ paused: true });</script>
        </template>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.gsapScript).toContain("gsap.timeline");
  });

  it("extracts styles from style tags", () => {
    const html = `
      <html>
      <body>
        <style data-hf-custom="true">
          .my-class { color: red; }
        </style>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.styles).not.toBeNull();
    expect(result.styles).toContain(".my-class");
  });

  it("detects landscape resolution from data attribute", () => {
    const html = `
      <html data-resolution="landscape">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("landscape");
  });

  it("detects portrait resolution from data attribute", () => {
    const html = `
      <html data-resolution="portrait">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("portrait");
  });

  it("keeps explicit portrait resolution even when dimensions are square", () => {
    const html = `
      <html data-resolution="portrait" data-composition-width="1080" data-composition-height="1080">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("portrait");
  });

  it("defaults to portrait when no resolution info is available", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("portrait");
  });

  it("detects landscape-4k resolution from data attribute", () => {
    const html = `
      <html data-resolution="landscape-4k">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("landscape-4k");
  });

  it("infers landscape-4k from composition dimensions", () => {
    const html = `
      <html data-composition-width="3840" data-composition-height="2160">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("landscape-4k");
  });

  it("infers portrait-4k from inline stage style", () => {
    const html = `
      <html>
      <body>
        <div id="stage" style="width: 2160px; height: 3840px;">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("portrait-4k");
  });

  it("classifies 1440p (QHD) as landscape, not landscape-4k", () => {
    // Regression: an earlier `>= 2560` cutoff misclassified QHD compositions
    // as 4K. The current rule uses the canonical 4K long-side (3840) so
    // 2560×1440 stays in the landscape preset.
    const html = `
      <html data-composition-width="2560" data-composition-height="1440">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("landscape");
  });

  it("infers square resolution from equal width/height", () => {
    const html = `
      <html data-composition-width="1080" data-composition-height="1080">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("square");
  });

  it("infers square-4k from equal width/height >= 2160", () => {
    const html = `
      <html data-composition-width="2160" data-composition-height="2160">
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5"><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.resolution).toBe("square-4k");
  });

  it("extracts x, y, scale, opacity from data attributes", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <video id="vid1" data-start="0" data-end="5" src="v.mp4" data-x="100" data-y="200" data-scale="1.5" data-opacity="0.8"></video>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.elements[0].x).toBe(100);
    expect(result.elements[0].y).toBe(200);
    expect(result.elements[0].scale).toBe(1.5);
    expect(result.elements[0].opacity).toBe(0.8);
  });

  it("parses text element properties (color, fontSize, fontWeight, fontFamily)", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5" data-color="red" data-font-size="72" data-font-weight="900" data-font-family="Montserrat"><div>Styled</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    const textEl = result.elements[0];
    expect(textEl.type).toBe("text");
    if (textEl.type === "text") {
      expect(textEl.color).toBe("red");
      expect(textEl.fontSize).toBe(72);
      expect(textEl.fontWeight).toBe(900);
      expect(textEl.fontFamily).toBe("Montserrat");
    }
  });

  it("parses media element properties (mediaStartTime, sourceDuration, volume)", () => {
    const html = `
      <html>
      <body>
        <div id="stage">
          <video id="vid1" data-start="0" data-end="10" src="v.mp4" data-media-start="5" data-source-duration="30" data-volume="0.5" data-has-audio="true"></video>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    const vid = result.elements[0];
    expect(vid.type).toBe("video");
    if (vid.type === "video") {
      expect(vid.mediaStartTime).toBe(5);
      expect(vid.sourceDuration).toBe(30);
      expect(vid.volume).toBe(0.5);
      expect(vid.hasAudio).toBe(true);
    }
  });

  it("extracts data-keyframes attribute", () => {
    const keyframes = JSON.stringify([
      { id: "kf1", time: 0, properties: { opacity: 0 } },
      { id: "kf2", time: 1, properties: { opacity: 1 } },
    ]);
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="text1" data-start="0" data-end="5" data-keyframes='${keyframes}'><div>Hello</div></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    const elId = result.elements[0]?.id ?? "";
    expect(elId).toMatch(/^hf-[a-z0-9]{4}$/);
    const kfs = result.keyframes[elId];
    expect(kfs).toBeDefined();
    expect(kfs).toHaveLength(2);
    expect(kfs[0].id).toBe("kf1");
  });

  it("parses stage zoom keyframes", () => {
    const zoomKeyframes = JSON.stringify([
      { id: "z1", time: 0, zoom: { scale: 1, focusX: 960, focusY: 540 } },
      { id: "z2", time: 2, zoom: { scale: 2, focusX: 500, focusY: 300 } },
    ]);
    const html = `
      <html>
      <body>
        <div id="stage">
          <div id="stage-zoom-container" data-zoom-keyframes='${zoomKeyframes}'></div>
        </div>
      </body>
      </html>
    `;
    const result = parseHtml(html);

    expect(result.stageZoomKeyframes).toHaveLength(2);
    expect(result.stageZoomKeyframes[0].zoom.scale).toBe(1);
    expect(result.stageZoomKeyframes[1].zoom.scale).toBe(2);
  });

  it("returns empty zoom keyframes when no zoom container exists", () => {
    const html = `
      <html>
      <body><div id="stage"></div></body>
      </html>
    `;
    const result = parseHtml(html);
    expect(result.stageZoomKeyframes).toHaveLength(0);
  });
});

describe("updateElementInHtml", () => {
  it("updates startTime and duration", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="el1" data-start="0" data-end="5"><div>Hello</div></div>
</body></html>`;

    const updated = updateElementInHtml(html, "el1", { startTime: 2, duration: 3 });

    expect(updated).toContain('data-start="2"');
    expect(updated).toContain('data-duration="3"');
    expect(updated).not.toContain('data-end="');
  });

  it("updates element name", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="el1" data-start="0" data-end="5" data-name="Old"><div>Hello</div></div>
</body></html>`;

    const updated = updateElementInHtml(html, "el1", { name: "New Name" });

    expect(updated).toContain('data-name="New Name"');
  });

  it("returns original html when element not found", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="el1" data-start="0" data-end="5"><div>Hello</div></div>
</body></html>`;

    const updated = updateElementInHtml(html, "nonexistent", { name: "Test" });

    expect(updated).toBe(html);
  });
});

describe("addElementToHtml", () => {
  it("adds a new text element to the HTML", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="stage">
    <div id="stage-zoom-container"></div>
  </div>
</body></html>`;

    const { html: updated, id } = addElementToHtml(html, {
      type: "text",
      name: "New Text",
      content: "Hello!",
      startTime: 1,
      duration: 3,
      zIndex: 1,
    });

    expect(id).toBeDefined();
    expect(updated).toContain(`id="${id}"`);
    expect(updated).toContain('data-start="1"');
    expect(updated).toContain('data-duration="3"');
    expect(updated).toContain('data-track-index="1"');
    expect(updated).not.toContain('data-end="');
    expect(updated).not.toContain('data-layer="');
    expect(updated).toContain("Hello!");
  });

  it("adds a video element", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="stage">
    <div id="stage-zoom-container"></div>
  </div>
</body></html>`;

    const { html: updated, id } = addElementToHtml(html, {
      type: "video",
      name: "My Video",
      src: "video.mp4",
      startTime: 0,
      duration: 10,
      zIndex: 0,
    });

    expect(updated).toContain(`id="${id}"`);
    expect(updated).toContain("video.mp4");
  });
});

describe("removeElementFromHtml", () => {
  it("removes an element by id", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="stage">
    <div id="el1" data-start="0" data-end="5"><div>Hello</div></div>
    <div id="el2" data-start="1" data-end="6"><div>World</div></div>
  </div>
</body></html>`;

    const updated = removeElementFromHtml(html, "el1");

    expect(updated).not.toContain('id="el1"');
    expect(updated).toContain('id="el2"');
  });

  it("cascades DOM and stable ids for every descendant", () => {
    const html = `<!doctype html><html><body>
      <div id="parent"><div id="box" data-hf-id="hf-box"></div></div>
      <script>const tl = gsap.timeline();
        tl.to("#parent", { x: 10 }); tl.to("#box", { x: 20 });
        tl.to('[data-hf-id="hf-box"]', { x: 30 });
      </script></body></html>`;
    const updated = removeElementFromHtml(html, "parent");
    expect(updated).not.toContain("#parent");
    expect(updated).not.toContain("#box");
    expect(updated).not.toContain("hf-box");
  });

  it("strips ALL gsap tweens for the removed element, not just the first", () => {
    // Two tweens on the same element → count-based ids renumber when the first is
    // removed, so a single up-front parse left the second tween orphaned.
    const html = `<!DOCTYPE html>
<html><body>
  <div id="stage">
    <div id="box" data-hf-id="box" data-start="0" data-end="5">box</div>
  </div>
  <script>
    var tl = gsap.timeline({ paused: true });
    tl.to("[data-hf-id=\\"box\\"]", { x: 100, duration: 1 }, 0);
    tl.to("[data-hf-id=\\"box\\"]", { x: 200, duration: 1 }, 1);
  </script>
</body></html>`;

    const updated = removeElementFromHtml(html, "box");

    expect(updated).not.toContain('data-hf-id="box"');
    // Neither tween may survive — the orphaned second tl.to referenced a deleted element.
    expect(updated).not.toContain("x: 100");
    expect(updated).not.toContain("x: 200");
  });

  it("strips GSAP tweens from composition templates", () => {
    const html = `<!DOCTYPE html>
<html><body>
  <div id="stage">
    <div id="box" data-hf-id="box" data-start="0" data-end="5">box</div>
  </div>
  <template data-composition-id="sub-comp">
    <script>
      var tl = gsap.timeline({ paused: true });
      tl.to("[data-hf-id=\\"box\\"]", { x: 100, duration: 1 }, 0);
    </script>
  </template>
</body></html>`;

    const updated = removeElementFromHtml(html, "box");

    expect(updated).not.toContain('data-hf-id="box"');
    expect(updated).not.toContain("x: 100");
  });
});

describe("validateCompositionHtml", () => {
  it("returns valid for a well-formed composition", () => {
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-1" data-composition-duration="10">
<body>
  <div id="stage"></div>
</body>
</html>`;

    const result = validateCompositionHtml(html);
    expect(result.valid).toBe(true);
    expect(result.errors).toHaveLength(0);
  });

  it("reports error for missing composition-id", () => {
    const html = `<!DOCTYPE html>
<html data-composition-duration="10">
<body>
  <div id="stage"></div>
</body>
</html>`;

    const result = validateCompositionHtml(html);
    expect(result.valid).toBe(false);
    expect(result.errors).toContain("Missing data-composition-id attribute on <html> element");
  });

  it("reports error for missing composition-duration", () => {
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-1">
<body>
  <div id="stage"></div>
</body>
</html>`;

    const result = validateCompositionHtml(html);
    expect(result.valid).toBe(false);
    expect(result.errors).toContain(
      "Missing data-composition-duration attribute on <html> element",
    );
  });

  it("reports error for missing #stage", () => {
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-1" data-composition-duration="10">
<body></body>
</html>`;

    const result = validateCompositionHtml(html);
    expect(result.valid).toBe(false);
    expect(result.errors).toContain("Missing #stage element");
  });

  it("reports error for inline event handlers", () => {
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-1" data-composition-duration="10">
<body>
  <div id="stage" onclick="alert('hi')"></div>
</body>
</html>`;

    const result = validateCompositionHtml(html);
    expect(result.valid).toBe(false);
    expect(result.errors).toContain("Inline event handlers (onclick, onload, etc.) not allowed");
  });

  it("validates GSAP scripts inside composition templates", () => {
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-1" data-composition-duration="10">
<body>
  <div id="stage"></div>
  <template data-composition-id="sub-comp">
    <script>
      const tl = gsap.timeline({ paused: true });
      tl.to("#text1", { onComplete: () => {}, duration: 1 }, 0);
    </script>
  </template>
</body>
</html>`;

    const result = validateCompositionHtml(html);

    expect(result.errors).toContain("onComplete callback not allowed");
  });
});

describe("extractCompositionMetadata", () => {
  it("extracts composition id and duration", () => {
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-abc" data-composition-duration="15.5">
<body></body>
</html>`;

    const meta = extractCompositionMetadata(html);
    expect(meta.compositionId).toBe("comp-abc");
    expect(meta.compositionDuration).toBe(15.5);
  });

  it("returns null for missing metadata", () => {
    const html = `<!DOCTYPE html><html><body></body></html>`;

    const meta = extractCompositionMetadata(html);
    expect(meta.compositionId).toBeNull();
    expect(meta.compositionDuration).toBeNull();
  });

  it("extracts composition variables", () => {
    const variables = JSON.stringify([
      { id: "title", type: "string", label: "Title", default: "Hello" },
      { id: "count", type: "number", label: "Count", default: 5 },
    ]);
    const html = `<!DOCTYPE html>
<html data-composition-id="comp-1" data-composition-duration="10" data-composition-variables='${variables}'>
<body></body>
</html>`;

    const meta = extractCompositionMetadata(html);
    expect(meta.variables).toHaveLength(2);
    expect(meta.variables[0].id).toBe("title");
    expect(meta.variables[0].type).toBe("string");
    expect(meta.variables[1].id).toBe("count");
    expect(meta.variables[1].type).toBe("number");
  });

  it("reads variables declared on the composition root, templated or not", () => {
    const decl = (id: string, def = "x") =>
      JSON.stringify([{ id, type: "string", label: id, default: def }]);
    const onRoot = `<!DOCTYPE html><html><body><div data-composition-id="c" data-composition-variables='${decl("title")}'></div></body></html>`;
    expect(extractCompositionMetadata(onRoot).variables.map((v) => v.id)).toEqual(["title"]);
    const inTemplate = `<!DOCTYPE html><html><body><template id="c-template"><div data-composition-id="c" data-composition-variables='${decl("sub")}'></div></template></body></html>`;
    expect(extractCompositionMetadata(inTemplate).variables.map((v) => v.id)).toEqual(["sub"]);
  });

  it("merges <html> and root declarations, the root winning a shared id", () => {
    const html = `<!DOCTYPE html>
<html data-composition-variables='[{"id":"title","type":"string","label":"T","default":"A"},{"id":"count","type":"number","label":"C","default":1}]'>
<body><div data-composition-id="c" data-composition-variables='[{"id":"title","type":"string","label":"T","default":"B"}]'></div></body>
</html>`;
    const vars = extractCompositionMetadata(html).variables;
    expect(vars.map((v) => v.id)).toEqual(["title", "count"]);
    expect(vars[0]?.default).toBe("B");
  });

  // T9 — CompositionVariable font/image parse (WS-B R1 implemented).

  it("parses a font variable (type: font) with name and source", () => {
    const variables = JSON.stringify([
      {
        id: "brand-font-primary",
        type: "font",
        label: "Heading font",
        default: "Inter",
        source: "https://fonts.googleapis.com/css2?family=Inter",
        default_name: "sans-serif",
        default_source: "",
      },
    ]);
    const html = `<!DOCTYPE html>
<html data-composition-id="c" data-composition-duration="5" data-composition-variables='${variables}'>
<body></body></html>`;
    const meta = extractCompositionMetadata(html);
    const v = meta.variables.find((x) => x.id === "brand-font-primary");
    expect(v).toBeDefined();
    expect(v?.type).toBe("font");
    // source, default_name, default_source are load-bearing for brand-kit font apply.
    expect((v as Record<string, unknown>)?.source).toBe(
      "https://fonts.googleapis.com/css2?family=Inter",
    );
    expect((v as Record<string, unknown>)?.default_name).toBe("sans-serif");
    expect((v as Record<string, unknown>)?.default_source).toBe("");
  });

  it("parses an image variable with brandRole logo:primary", () => {
    const variables = JSON.stringify([
      { id: "brand-logo", type: "image", label: "Logo", default: "", brandRole: "logo:primary" },
    ]);
    const html = `<!DOCTYPE html>
<html data-composition-id="c" data-composition-duration="5" data-composition-variables='${variables}'>
<body></body></html>`;
    const meta = extractCompositionMetadata(html);
    const v = meta.variables.find((x) => x.id === "brand-logo");
    expect(v).toBeDefined();
    expect(v?.type).toBe("image");
    expect((v as Record<string, unknown>)?.brandRole).toBe("logo:primary");
  });

  it("[spec] parses a color variable with brandRole and preserves the brandRole field", () => {
    const variables = JSON.stringify([
      {
        id: "brand-color-primary",
        type: "color",
        label: "Primary",
        default: "#0066cc",
        brandRole: "color:primary",
      },
    ]);
    const html = `<!DOCTYPE html>
<html data-composition-id="c" data-composition-duration="5" data-composition-variables='${variables}'>
<body></body></html>`;
    const meta = extractCompositionMetadata(html);
    const v = meta.variables.find((x) => x.id === "brand-color-primary");
    expect(v).toBeDefined();
    // TODO(R1): remove cast once ColorVariable.brandRole is typed
    expect((v as Record<string, unknown>)?.brandRole).toBe("color:primary");
  });

  it("color variable without brandRole parses normally (brandRole is optional)", () => {
    const variables = JSON.stringify([
      { id: "accent", type: "color", label: "Accent", default: "#ff0000" },
    ]);
    const html = `<!DOCTYPE html>
<html data-composition-id="c" data-composition-duration="5" data-composition-variables='${variables}'>
<body></body></html>`;
    const meta = extractCompositionMetadata(html);
    const v = meta.variables.find((x) => x.id === "accent");
    expect(v).toBeDefined();
    expect(v?.type).toBe("color");
    expect((v as Record<string, unknown>)?.brandRole).toBeUndefined();
  });

  it.todo(
    "[spec] font variable without source field is rejected (source is required for brand-kit font apply)",
  );

  it.todo(
    "[spec] image variable without default is rejected gracefully (default is required for image variables)",
  );

  it("unknown variable type is rejected gracefully (does not throw, variable is skipped)", () => {
    const variables = JSON.stringify([
      { id: "ok", type: "string", label: "Ok", default: "yes" },
      { id: "x", type: "widget", label: "Unknown", default: null },
    ]);
    const html = `<!DOCTYPE html>
<html data-composition-id="c" data-composition-duration="5" data-composition-variables='${variables}'>
<body></body></html>`;
    expect(() => extractCompositionMetadata(html)).not.toThrow();
    const meta = extractCompositionMetadata(html);
    expect(meta.variables.find((v) => v.id === "x")).toBeUndefined();
    expect(meta.variables.find((v) => v.id === "ok")).toBeDefined();
  });
});

describe("video audio attributes", () => {
  const DOC = `<!DOCTYPE html>
<html><body>
  <div id="stage">
    <div id="stage-zoom-container"><video id="v" src="a.mp4" muted data-start="0" data-duration="2"></video></div>
  </div>
</body></html>`;

  const videoTag = (html: string, id: string): string =>
    html.match(new RegExp(`<video[^>]*id="${id}"[^>]*>`))?.[0] ?? "";

  it("addElementToHtml: an audible video gets data-has-audio and no muted", () => {
    const { html, id } = addElementToHtml(DOC, {
      type: "video",
      name: "Audible",
      src: "b.mp4",
      startTime: 0,
      duration: 2,
      zIndex: 0,
      hasAudio: true,
    });
    const tag = videoTag(html, id);
    expect(tag).toContain('data-has-audio="true"');
    expect(tag).not.toMatch(/\bmuted\b/);
  });

  it("addElementToHtml: a silent video is muted with no data-has-audio", () => {
    const { html, id } = addElementToHtml(DOC, {
      type: "video",
      name: "Silent",
      src: "b.mp4",
      startTime: 0,
      duration: 2,
      zIndex: 0,
    });
    const tag = videoTag(html, id);
    expect(tag).toMatch(/\bmuted\b/);
    expect(tag).not.toContain("data-has-audio");
  });

  it("updateElementInHtml hasAudio:true clears muted; false restores it", () => {
    const on = updateElementInHtml(DOC, "v", { hasAudio: true });
    expect(videoTag(on, "v")).not.toMatch(/\bmuted\b/);
    expect(videoTag(on, "v")).toContain('data-has-audio="true"');
    const off = updateElementInHtml(on, "v", { hasAudio: false });
    const tag = videoTag(off, "v");
    expect(tag).toMatch(/\bmuted\b/);
    expect(tag).not.toContain("data-has-audio");
  });

  it("updateElementInHtml hasAudio only touches videos, and only true/false", () => {
    const html =
      '<html><body><video id="v" src="a.mp4" data-has-audio="true"></video><audio id="a" src="m.wav"></audio></body></html>';
    const audio = updateElementInHtml(html, "a", { hasAudio: false });
    expect(audio).not.toMatch(/<audio\b[^>]*\bmuted\b/);
    expect(audio).not.toMatch(/<audio\b[^>]*data-has-audio/);
    const untouched = updateElementInHtml(html, "v", { hasAudio: undefined });
    expect(videoTag(untouched, "v")).toContain('data-has-audio="true"');
    expect(videoTag(untouched, "v")).not.toMatch(/\bmuted\b/);
  });
});