Files
hyperframes/packages/cli/src/server/studioServer.previewAssets.test.ts
T
James RussoandClaude Opus 5.5 7f19f2335a feat(studio): load GSAP from the CLI's bundled copy by default (#6256)
* feat(studio): load GSAP from the CLI's bundled copy by default

Studio preview now loads the GSAP, CustomEase and MotionPathPlugin scripts
it adds from files the CLI ships and serves same-origin at /api/vendor/npm,
instead of jsDelivr. HYPERFRAMES_GSAP_BASE_URL still wins when set, and a
composition on another GSAP version gets its plugin from jsDelivr.

Renders now honor HYPERFRAMES_GSAP_BASE_URL when they replace a missing
local GSAP script, and the setting accepts plain http only for loopback
hosts.

Closes #6205

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* refactor(studio): keep comment share flat for the GSAP local root

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(cli): find the installed gsap with node resolution when run from source

The Windows CI lane installs with the hoisted linker, so gsap is not under
packages/core/node_modules there.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(producer): load a nested composition's missing GSAP from the mirror

A sub-composition's missing local gsap/dist script was hoisted into the
render unchanged, so HYPERFRAMES_GSAP_BASE_URL (and the jsDelivr fallback)
only reached the entry document. Run the same rewrite on every
sub-composition before it is compiled, resolving its path the way the
inliner will hoist it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-25 03:08:42 +00:00

144 lines
6.5 KiB
TypeScript

import { afterEach, beforeEach, describe, expect, it } from "vitest";
import * as fs from "node:fs";
import * as path from "node:path";
import { createStudioServer, type StudioServer } from "./studioServer.js";
import { cleanupStudioServerRoot, makeStudioServerRoot } from "./studioServerTestFixture.js";
const COMPOSITION = `<!doctype html>
<html><head><style>@font-face{font-family:Brand;src:url(assets/brand.ttf)}</style></head>
<body><div id="root" data-composition-id="main" data-width="320" data-height="180">
<img id="pic" src="assets/pic.png" data-start="0" data-duration="1">
<img id="again" src="assets/pic.png" data-start="1" data-duration="1">
<img id="responsive" src="assets/pic.png" srcset="assets/pic.png 1x, assets/pic@2x.png 2x" data-start="0" data-duration="1">
<video id="clip" src="assets/clip.mp4" poster="assets/pic.png" muted data-start="0" data-duration="1"></video>
<div id="scene-host" data-composition-id="scene" data-composition-src="compositions/scene.html" data-start="0" data-duration="1"></div>
</div></body></html>`;
const SCENE = `<template id="scene-template">
<div data-composition-id="scene" data-width="320" data-height="180">
<img id="nested" src="../assets/pic@2x.png">
</div>
</template>`;
const PIC = Buffer.alloc(4096, 7);
const PIC_2X = Buffer.alloc(8192, 9);
let root: string;
let projectDir: string;
let server: StudioServer;
beforeEach(() => {
({ root, projectDir } = makeStudioServerRoot("hf-preview-assets-"));
fs.mkdirSync(path.join(projectDir, "assets"));
fs.mkdirSync(path.join(projectDir, "compositions"));
fs.writeFileSync(path.join(projectDir, "index.html"), COMPOSITION);
fs.writeFileSync(path.join(projectDir, "compositions", "scene.html"), SCENE);
fs.writeFileSync(path.join(projectDir, "assets", "pic.png"), PIC);
fs.writeFileSync(path.join(projectDir, "assets", "pic@2x.png"), PIC_2X);
fs.writeFileSync(path.join(projectDir, "assets", "brand.ttf"), Buffer.alloc(1024, 3));
fs.writeFileSync(path.join(projectDir, "assets", "clip.mp4"), Buffer.alloc(1024, 5));
server = createStudioServer({ projectDir, projectName: "film" });
});
afterEach(() => {
cleanupStudioServerRoot(server, root);
});
async function fetchAsset(url: string): Promise<Buffer> {
const response = await server.app.request(`/api/projects/film/preview/${url}`);
expect(response.status).toBe(200);
return Buffer.from(await response.arrayBuffer());
}
describe("studio preview document", () => {
it("keeps every asset URL instead of inlining it as base64", async () => {
const response = await server.app.request("/api/projects/film/preview");
const html = await response.text();
expect(response.status).toBe(200);
// Served by the bundler, not the raw-HTML fallback, so the assertions below mean something.
expect(html).toContain('data-hyperframes-preview-runtime="1" src="/api/runtime.js"');
expect(html).not.toContain("base64,");
expect(html.match(/src="assets\/pic\.png"/g)?.length).toBeGreaterThanOrEqual(3);
expect(html).toContain("url(assets/brand.ttf)");
expect(html).toContain('poster="assets/pic.png"');
expect(html).toContain('srcset="assets/pic.png 1x, assets/pic@2x.png 2x"');
// Kept URLs resolve against the preview's <base href> through the asset route.
expect(html).toContain('<base href="/api/projects/film/preview/">');
expect(await fetchAsset("assets/pic.png")).toEqual(PIC);
const nested = html.match(/<img [^>]*id="nested" src="([^"]+)"/)?.[1];
expect(nested).toBe("assets/pic%402x.png");
expect(await fetchAsset(nested ?? "")).toEqual(PIC_2X);
});
it("tags no asset a copy tool just rewrote with its old mtime", async () => {
const clip = path.join(projectDir, "assets", "clip.mp4");
fs.writeFileSync(clip, Buffer.alloc(1024, 6));
const copied = new Date("2026-01-01T00:00:00Z");
fs.utimesSync(clip, copied, copied);
const response = await server.app.request("/api/projects/film/preview/assets/clip.mp4");
expect(response.status).toBe(200);
expect(response.headers.get("ETag")).toBeNull();
});
});
describe("bundled GSAP", () => {
const plugin = "/api/vendor/npm/gsap@3.15.0/dist/MotionPathPlugin.min.js";
function writeMotionPathComposition(): void {
fs.writeFileSync(
path.join(projectDir, "index.html"),
`<!doctype html>
<html><head><script src="vendor/gsap.min.js"></script></head>
<body><div id="root" data-composition-id="main" data-width="320" data-height="180">
<div id="card"></div>
<script>gsap.to("#card", { motionPath: { path: [{ x: 10, y: 10 }] } });</script>
</div></body></html>`,
);
}
it("serves Studio's GSAP dependencies same-origin instead of from jsDelivr", async () => {
writeMotionPathComposition();
expect(server.adapter.gsapLocalRoot).toBe("/api/vendor/npm");
const html = await (await server.app.request("/api/projects/film/preview")).text();
expect(html).toContain(`src="${plugin}"`);
expect(html).toContain('<meta name="hyperframes-gsap-base-url" content="/api/vendor/npm">');
expect(html).not.toContain("jsdelivr");
for (const file of ["gsap.min.js", "CustomEase.min.js", "MotionPathPlugin.min.js"]) {
const response = await server.app.request(`/api/vendor/npm/gsap@3.15.0/dist/${file}`);
expect(response.status).toBe(200);
expect(response.headers.get("Content-Type")).toContain("javascript");
expect(await response.text()).toMatch(/^\/\*!\n \* \w+ 3\.15\.0/);
}
});
it.each([
"/api/vendor/npm/gsap@3.14.2/dist/gsap.min.js",
"/api/vendor/npm/gsap@3.15.0/dist/package.json",
"/api/vendor/npm/gsap@3.15.0/dist/..%2Fpackage.json",
"/api/vendor/npm/react@3.15.0/dist/gsap.min.js",
])("serves only the bundled GSAP files: %s", async (url) => {
expect((await server.app.request(url)).status).toBe(404);
});
it("uses HYPERFRAMES_GSAP_BASE_URL over the bundled copy", async () => {
writeMotionPathComposition();
const mirror = "https://mirror.example/npm";
const previous = process.env.HYPERFRAMES_GSAP_BASE_URL;
process.env.HYPERFRAMES_GSAP_BASE_URL = mirror;
try {
server.watcher.close();
server = createStudioServer({ projectDir, projectName: "film" });
const html = await (await server.app.request("/api/projects/film/preview")).text();
expect(html).toContain(`src="${mirror}/gsap@3.15.0/dist/MotionPathPlugin.min.js"`);
expect(html).not.toContain("/api/vendor/npm");
} finally {
if (previous === undefined) delete process.env.HYPERFRAMES_GSAP_BASE_URL;
else process.env.HYPERFRAMES_GSAP_BASE_URL = previous;
}
});
});