Skip to content

Write HTML. Render video. Built for agents.

18.2 KB
Raw Blame
import { describe, expect, it } from "vitest";
import { Window } from "happy-dom";
import {
  createStudioManualEditsRenderBodyScript,
  createStudioPositionSeekReapplyScript,
} from "./manualEditsRenderScript";

function runScript(
  window: Window,
  script: string,
  getComputedStyle: typeof window.getComputedStyle = window.getComputedStyle.bind(window),
  timers: {
    setInterval?: typeof globalThis.setInterval;
    clearInterval?: typeof globalThis.clearInterval;
  } = {},
): void {
  const execute = new Function(
    "window",
    "document",
    "HTMLElement",
    "getComputedStyle",
    "setInterval",
    "clearInterval",
    script,
  );
  execute(
    window,
    window.document,
    window.HTMLElement,
    getComputedStyle,
    timers.setInterval ??
      (((callback: TimerHandler) => {
        void callback;
        return 0 as never;
      }) as typeof globalThis.setInterval),
    timers.clearInterval ?? globalThis.clearInterval,
  );
}

describe("createStudioManualEditsRenderBodyScript", () => {
  it("returns null for an empty manifest", () => {
    expect(createStudioManualEditsRenderBodyScript("")).toBeNull();
  });

  it("applies manual edits and reapplies them after render seeks", () => {
    const window = new Window();
    window.document.body.innerHTML = '<div id="card" style="width: 20px; height: 20px"></div>';
    const card = window.document.getElementById("card");
    if (!(card instanceof window.HTMLElement)) {
      throw new Error("card fixture missing");
    }

    let seekCalls = 0;
    (
      window as unknown as {
        __hf: { seek: (time: number) => void };
      }
    ).__hf = {
      seek: () => {
        seekCalls += 1;
        card.style.removeProperty("translate");
      },
    };

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "path-offset",
            target: { sourceFile: "index.html", id: "card" },
            x: 12,
            y: 24,
          },
          {
            kind: "box-size",
            target: { sourceFile: "index.html", id: "card" },
            width: 120,
            height: 64,
          },
          {
            kind: "rotation",
            target: { sourceFile: "index.html", id: "card" },
            angle: 15,
          },
        ],
      }),
    );
    if (!script) throw new Error("script fixture missing");

    const computedStyle = (element: Element) =>
      ({
        display: element === card ? "block" : "block",
        flexDirection: "row",
      }) as CSSStyleDeclaration;

    const intervalCallbacks: Array<() => void> = [];
    runScript(window, script, computedStyle, {
      setInterval: ((callback: TimerHandler) => {
        if (typeof callback === "function") intervalCallbacks.push(callback as () => void);
        return 0 as never;
      }) as typeof globalThis.setInterval,
    });

    expect(card.style.getPropertyValue("translate")).toContain("--hf-studio-offset-x");
    expect(card.style.getPropertyValue("width")).toBe("120px");
    expect(card.style.getPropertyValue("height")).toBe("64px");
    expect(card.style.getPropertyValue("rotate")).toContain("--hf-studio-rotation");
    expect(card.style.getPropertyValue("transform-origin")).toBe("center center");

    (
      window as unknown as {
        __hf: { seek: (time: number) => void };
      }
    ).__hf.seek(1);

    expect(seekCalls).toBe(1);
    expect(card.style.getPropertyValue("translate")).toContain("--hf-studio-offset-x");

    (
      window as unknown as {
        __hf: { seek: (time: number) => void };
      }
    ).__hf.seek = () => {
      card.style.removeProperty("rotate");
    };
    intervalCallbacks.forEach((callback) => callback());
    (
      window as unknown as {
        __hf: { seek: (time: number) => void };
      }
    ).__hf.seek(2);
    expect(card.style.getPropertyValue("rotate")).toContain("--hf-studio-rotation");

    (
      window as unknown as {
        __player: { renderSeek: (time: number) => void };
      }
    ).__player = {
      renderSeek: () => {
        card.style.removeProperty("rotate");
      },
    };
    intervalCallbacks.forEach((callback) => callback());
    (
      window as unknown as {
        __player: { renderSeek: (time: number) => void };
      }
    ).__player.renderSeek(3);
    expect(card.style.getPropertyValue("rotate")).toContain("--hf-studio-rotation");
  });

  it("applies render edits to the matching source file target", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div data-composition-id="root">
        <div id="card"></div>
        <div data-composition-id="nested" data-composition-file="scenes/nested.html">
          <div id="card"></div>
        </div>
      </div>
    `;
    const cards = Array.from(window.document.getElementsByTagName("*")).filter(
      (element): element is HTMLElement =>
        element instanceof window.HTMLElement && element.id === "card",
    );
    const rootCard = cards[0];
    const nestedCard = cards[1];
    if (!rootCard || !nestedCard) {
      throw new Error("source-scoped render fixture missing");
    }

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "rotation",
            target: { sourceFile: "scenes/nested.html", id: "card" },
            angle: 21,
          },
        ],
      }),
    );
    if (!script) throw new Error("script fixture missing");

    runScript(window, script);

    expect(rootCard.style.getPropertyValue("rotate")).toBe("");
    expect(nestedCard.style.getPropertyValue("rotate")).toContain("--hf-studio-rotation");
  });

  it("applies render edits inside composition-file hosts without composition ids", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div data-composition-id="root">
        <div id="card"></div>
        <div data-composition-file="scenes/anonymous.html">
          <div id="card"></div>
        </div>
      </div>
    `;
    const cards = Array.from(window.document.getElementsByTagName("*")).filter(
      (element): element is HTMLElement =>
        element instanceof window.HTMLElement && element.id === "card",
    );
    const rootCard = cards[0];
    const nestedCard = cards[1];
    if (!rootCard || !nestedCard) {
      throw new Error("anonymous composition render fixture missing");
    }

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "path-offset",
            target: { sourceFile: "scenes/anonymous.html", id: "card" },
            x: 12,
            y: 24,
          },
        ],
      }),
    );
    if (!script) throw new Error("script fixture missing");

    runScript(window, script);

    expect(rootCard.style.getPropertyValue("translate")).toBe("");
    expect(nestedCard.style.getPropertyValue("translate")).toContain("--hf-studio-offset-x");
  });

  it("uses the active composition path as the unscoped document fallback", () => {
    const window = new Window();
    window.document.body.innerHTML = `<div id="card"></div>`;
    const card = window.document.getElementById("card");
    if (!(card instanceof window.HTMLElement)) {
      throw new Error("card fixture missing");
    }

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "path-offset",
            target: { sourceFile: "compositions/scene-2.html", id: "card" },
            x: 12,
            y: 24,
          },
        ],
      }),
      { activeCompositionPath: "compositions/scene-2.html" },
    );
    if (!script) throw new Error("script fixture missing");

    runScript(window, script);

    expect(card.style.getPropertyValue("translate")).toContain("--hf-studio-offset-x");
  });

  it("preserves computed transform longhands as render edit bases", () => {
    const window = new Window();
    window.document.body.innerHTML = `<div id="card"></div>`;
    const card = window.document.getElementById("card");
    if (!(card instanceof window.HTMLElement)) {
      throw new Error("card fixture missing");
    }

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "path-offset",
            target: { sourceFile: "index.html", id: "card" },
            x: 12,
            y: 24,
          },
          {
            kind: "rotation",
            target: { sourceFile: "index.html", id: "card" },
            angle: 15,
          },
        ],
      }),
    );
    if (!script) throw new Error("script fixture missing");

    const computedStyle = (element: Element) =>
      ({
        getPropertyValue: (property: string) => {
          if (element !== card) return "";
          if (property === "translate") return "10px 20px";
          if (property === "rotate") return "8deg";
          return "";
        },
      }) as CSSStyleDeclaration;

    runScript(window, script, computedStyle);

    expect(card.style.getPropertyValue("translate")).toContain("calc(10px +");
    expect(card.style.getPropertyValue("translate")).toContain("calc(20px +");
    expect(card.style.getPropertyValue("rotate")).toContain("8deg");
    expect(card.style.getPropertyValue("rotate")).toContain("--hf-studio-rotation");
    expect(card.style.getPropertyValue("transform-origin")).toBe("center center");
  });

  it("does not compound stale studio variables during render reapply", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card" style="
        translate: var(--hf-studio-offset-x, 0px) var(--hf-studio-offset-y, 0px);
        rotate: var(--hf-studio-rotation, 0deg);
      "></div>
    `;
    const card = window.document.getElementById("card");
    if (!(card instanceof window.HTMLElement)) {
      throw new Error("card fixture missing");
    }

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "path-offset",
            target: { sourceFile: "index.html", id: "card" },
            x: 12,
            y: 24,
          },
          {
            kind: "rotation",
            target: { sourceFile: "index.html", id: "card" },
            angle: 15,
          },
        ],
      }),
    );
    if (!script) throw new Error("script fixture missing");

    runScript(window, script);

    expect(card.style.getPropertyValue("translate")).toBe(
      "var(--hf-studio-offset-x, 0px) var(--hf-studio-offset-y, 0px)",
    );
    expect(card.style.getPropertyValue("rotate")).toBe("var(--hf-studio-rotation, 0deg)");
  });

  it("exposes a render reapply hook for thumbnails after layout settles", () => {
    const window = new Window();
    window.document.body.innerHTML = `<div id="card"></div>`;
    const card = window.document.getElementById("card");
    if (!(card instanceof window.HTMLElement)) {
      throw new Error("card fixture missing");
    }

    const script = createStudioManualEditsRenderBodyScript(
      JSON.stringify({
        version: 1,
        edits: [
          {
            kind: "path-offset",
            target: { sourceFile: "index.html", id: "card" },
            x: 12,
            y: 24,
          },
        ],
      }),
    );
    if (!script) throw new Error("script fixture missing");

    runScript(window, script);
    card.style.removeProperty("translate");

    (
      window as unknown as {
        __hfStudioManualEditsApply?: () => number;
      }
    ).__hfStudioManualEditsApply?.();

    expect(card.style.getPropertyValue("translate")).toContain("--hf-studio-offset-x");
  });
});

describe("createStudioPositionSeekReapplyScript", () => {
  function runPositionScript(
    window: Window,
    timers: {
      setInterval?: typeof globalThis.setInterval;
      clearInterval?: typeof globalThis.clearInterval;
    } = {},
  ): void {
    Object.assign(window, { SyntaxError });
    const script = createStudioPositionSeekReapplyScript();
    const execute = new Function(
      "window",
      "document",
      "HTMLElement",
      "DOMMatrix",
      "setInterval",
      "clearInterval",
      script,
    );
    execute(
      window,
      window.document,
      window.HTMLElement,
      globalThis.DOMMatrix,
      timers.setInterval ??
        (((callback: TimerHandler) => {
          void callback;
          return 0 as never;
        }) as typeof globalThis.setInterval),
      timers.clearInterval ?? globalThis.clearInterval,
    );
  }

  it("reapplies box-size after seek", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card"
        data-hf-studio-box-size="true"
        style="--hf-studio-width: 200px; --hf-studio-height: 100px; width: 200px; height: 100px">
      </div>
    `;
    const card = window.document.getElementById("card") as unknown as HTMLElement;

    const originalSeek = () => {
      card.style.removeProperty("width");
      card.style.removeProperty("height");
    };
    (window as unknown as { __hf: Record<string, unknown> }).__hf = { seek: originalSeek };

    runPositionScript(window);
    const wrappedSeek = (window as unknown as { __hf: { seek: (t: number) => void } }).__hf.seek;
    wrappedSeek(1);

    expect(card.style.getPropertyValue("width")).toBe("200px");
    expect(card.style.getPropertyValue("height")).toBe("100px");
  });

  it("strips GSAP translate from transform after reapplying path offset", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card"
        data-hf-studio-path-offset="true"
        data-hf-studio-original-translate=""
        style="--hf-studio-offset-x: 50px; --hf-studio-offset-y: 30px; translate: var(--hf-studio-offset-x, 0px) var(--hf-studio-offset-y, 0px)">
      </div>
    `;
    const card = window.document.getElementById("card") as unknown as HTMLElement;

    const originalSeek = () => {
      card.style.setProperty("transform", "matrix(1, 0, 0, 1, 120, 60)");
    };
    (window as unknown as { __hf: Record<string, unknown> }).__hf = { seek: originalSeek };

    runPositionScript(window);
    const wrappedSeek = (window as unknown as { __hf: { seek: (t: number) => void } }).__hf.seek;
    wrappedSeek(1);

    expect(card.style.getPropertyValue("translate")).toContain("--hf-studio-offset-x");
    const transform = card.style.getPropertyValue("transform");
    if (transform && transform !== "none") {
      const m = new DOMMatrix(transform);
      expect(m.m41).toBe(0);
      expect(m.m42).toBe(0);
    }
  });

  it("preserves non-translate components when stripping GSAP transform", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card"
        data-hf-studio-path-offset="true"
        data-hf-studio-original-translate=""
        style="--hf-studio-offset-x: 10px; --hf-studio-offset-y: 20px; translate: var(--hf-studio-offset-x, 0px) var(--hf-studio-offset-y, 0px)">
      </div>
    `;
    const card = window.document.getElementById("card") as unknown as HTMLElement;

    const originalSeek = () => {
      card.style.setProperty("transform", "matrix(0.5, 0, 0, 0.5, 80, 40)");
    };
    (window as unknown as { __hf: Record<string, unknown> }).__hf = { seek: originalSeek };

    runPositionScript(window);
    const wrappedSeek = (window as unknown as { __hf: { seek: (t: number) => void } }).__hf.seek;
    wrappedSeek(1);

    const transform = card.style.getPropertyValue("transform");
    expect(transform).toBeTruthy();
    expect(transform).not.toContain("80");
    expect(transform).not.toContain("40");
  });

  it("removes transform entirely when it becomes identity after stripping translate", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card"
        data-hf-studio-path-offset="true"
        data-hf-studio-original-translate=""
        style="--hf-studio-offset-x: 10px; --hf-studio-offset-y: 20px; translate: var(--hf-studio-offset-x, 0px) var(--hf-studio-offset-y, 0px)">
      </div>
    `;
    const card = window.document.getElementById("card") as unknown as HTMLElement;

    const originalSeek = () => {
      card.style.setProperty("transform", "matrix(1, 0, 0, 1, 50, 25)");
    };
    (window as unknown as { __hf: Record<string, unknown> }).__hf = { seek: originalSeek };

    runPositionScript(window);
    const wrappedSeek = (window as unknown as { __hf: { seek: (t: number) => void } }).__hf.seek;
    wrappedSeek(1);

    const transform = card.style.getPropertyValue("transform");
    expect(!transform || transform === "none" || transform === "").toBe(true);
  });

  it("no-ops when transform is 'none'", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card"
        data-hf-studio-path-offset="true"
        data-hf-studio-original-translate=""
        style="--hf-studio-offset-x: 10px; --hf-studio-offset-y: 20px; translate: var(--hf-studio-offset-x, 0px) var(--hf-studio-offset-y, 0px); transform: none">
      </div>
    `;
    const card = window.document.getElementById("card") as unknown as HTMLElement;

    (window as unknown as { __hf: Record<string, unknown> }).__hf = { seek: () => {} };
    runPositionScript(window);

    expect(card.style.getPropertyValue("transform")).toBe("none");
  });

  it("strips GSAP translate for rotation-only elements", () => {
    const window = new Window();
    window.document.body.innerHTML = `
      <div id="card"
        data-hf-studio-rotation="true"
        data-hf-studio-original-rotate=""
        style="--hf-studio-rotation: 45deg; rotate: var(--hf-studio-rotation, 0deg)">
      </div>
    `;
    const card = window.document.getElementById("card") as unknown as HTMLElement;

    const originalSeek = () => {
      card.style.setProperty("transform", "matrix(1, 0, 0, 1, 100, 50)");
    };
    (window as unknown as { __hf: Record<string, unknown> }).__hf = { seek: originalSeek };

    runPositionScript(window);
    const wrappedSeek = (window as unknown as { __hf: { seek: (t: number) => void } }).__hf.seek;
    wrappedSeek(1);

    expect(card.style.getPropertyValue("rotate")).toContain("--hf-studio-rotation");
    const transform = card.style.getPropertyValue("transform");
    expect(!transform || transform === "none" || transform === "").toBe(true);
  });
});