mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-20 20:38:34 +00:00
* fix(studio): serve files whose name has a bare percent sign A browser sends src="100%.png" with the % unescaped, and decoding the whole path threw, so Studio answered 500. Only well-formed escapes are decoded now. * fix(cli): serve files with a bare percent sign from the check and snapshot server One shared decode rule for request paths; the image thumbnail route's malformed-escape 400 could no longer fire, so a name that is not a file is a 404. * fix(cli): name a failed file with a bare percent sign in check * fix(studio): keep apostrophes and dollar signs in file names when editing attributes An attribute value is matched by its own quote kind, so src="it's.png" is replaced instead of duplicated, and every insert uses a function replacer, so $1 or $& in a file name is written as is. * fix(studio): rename references spelled with %20 or & and read quoted media sources WIP: not yet tested; see the resume note. * fix(studio): match whole attribute names when editing media sources * fix(studio): compare decoded names and escape replacement references * fix(studio): preserve file references across URL and string consumers * docs: clarify raw file references and URL fields * fix(studio): keep raw path identity distinct from URL spelling * fix: share attribute grammar and decode media URLs at their readers * fix: preserve local filename identity in HTML URL output * fix: decode entity references before rename candidate matching * style: format rename entity handling and regressions * fix: preserve platform file identity when renaming references * fix(core): decode CSS escapes before rebasing asset URLs * fix(core): consume CSS continuations before URL encoding * fix(core): preserve CSS URL identity and escape rebased suffixes * fix(core): express CSS suffix controls with Unicode categories * fix(core): preserve URL backslash identity while rebasing * test(core): respect platform backslash filename semantics * fix(studio): a dropped file with %, # or ? in its name loads, and an encoded reference renames * fix(studio): read an authored src as a URL so dropped files with spaces, %, # or ? load * fix(studio): media routes find files named with ? or #, and the probe reads a src as a URL * fix(studio-server): one rule for request file paths, so loudness finds files named with %, # or ? * chore: drop the design note from the change * fix(core): rename replaced clips whose src is URL-encoded
309 lines
10 KiB
TypeScript
309 lines
10 KiB
TypeScript
// @vitest-environment jsdom
|
|
import { describe, expect, it, vi } from "vitest";
|
|
import {
|
|
buildTimelineFileDropPlacements,
|
|
buildTimelineAssetInsertHtml,
|
|
extendCompositionDurationIfNeeded,
|
|
fitTimelineAssetGeometry,
|
|
getTimelineAssetKind,
|
|
insertTimelineAssetIntoSource,
|
|
resolveTimelineAssetCompositionSize,
|
|
resolveTimelineAssetSrc,
|
|
setCompositionDurationToContent,
|
|
} from "./timelineAssetDrop";
|
|
|
|
describe("setCompositionDurationToContent", () => {
|
|
const src = (dur: number) =>
|
|
`<div id="root" data-composition-id="c" data-duration="${dur}">x</div>`;
|
|
|
|
it("shrinks the root duration to the content end", () => {
|
|
expect(setCompositionDurationToContent(src(20), 8)).toContain('data-duration="8"');
|
|
});
|
|
|
|
it("grows the root duration to the content end", () => {
|
|
expect(setCompositionDurationToContent(src(5), 12)).toContain('data-duration="12"');
|
|
});
|
|
|
|
it.each([0, -1, Number.NaN, Number.POSITIVE_INFINITY])(
|
|
"keeps the declared length without parsing when content end is %s",
|
|
(contentEnd) => {
|
|
const parse = vi.spyOn(DOMParser.prototype, "parseFromString");
|
|
try {
|
|
expect(setCompositionDurationToContent(src(12), contentEnd)).toBe(src(12));
|
|
expect(parse).not.toHaveBeenCalled();
|
|
} finally {
|
|
parse.mockRestore();
|
|
}
|
|
},
|
|
);
|
|
|
|
it("is a no-op when already equal", () => {
|
|
expect(setCompositionDurationToContent(src(9), 9)).toBe(src(9));
|
|
});
|
|
|
|
// Reviewer round-2 finding #3: attribute-order and single-quote variants that
|
|
// the old order-dependent, double-quotes-only regex silently ignored.
|
|
it("patches when data-duration precedes data-composition-id", () => {
|
|
const source = `<div data-duration="20" data-composition-id="c">x</div>`;
|
|
expect(setCompositionDurationToContent(source, 8)).toBe(
|
|
`<div data-duration="8" data-composition-id="c">x</div>`,
|
|
);
|
|
});
|
|
|
|
it("patches single-quoted attributes and keeps the quote style", () => {
|
|
const source = `<div data-composition-id='c' data-duration='20'>x</div>`;
|
|
expect(setCompositionDurationToContent(source, 8)).toBe(
|
|
`<div data-composition-id='c' data-duration='8'>x</div>`,
|
|
);
|
|
});
|
|
});
|
|
|
|
describe("extendCompositionDurationIfNeeded", () => {
|
|
it("grows the root duration when a clip lands past the end", () => {
|
|
const source = `<div data-composition-id="c" data-duration="5">x</div>`;
|
|
expect(extendCompositionDurationIfNeeded(source, 8)).toBe(
|
|
`<div data-composition-id="c" data-duration="8">x</div>`,
|
|
);
|
|
});
|
|
|
|
it("is a no-op when the required end fits within the current duration", () => {
|
|
const source = `<div data-composition-id="c" data-duration="10">x</div>`;
|
|
expect(extendCompositionDurationIfNeeded(source, 8)).toBe(source);
|
|
});
|
|
|
|
it("grows even when the attribute order is swapped and quotes are single", () => {
|
|
const source = `<div data-duration='5' data-composition-id='c'>x</div>`;
|
|
expect(extendCompositionDurationIfNeeded(source, 8)).toBe(
|
|
`<div data-duration='8' data-composition-id='c'>x</div>`,
|
|
);
|
|
});
|
|
|
|
it("is a no-op when there is no composition root", () => {
|
|
const source = `<div data-duration="5">x</div>`;
|
|
expect(extendCompositionDurationIfNeeded(source, 8)).toBe(source);
|
|
});
|
|
});
|
|
|
|
describe("getTimelineAssetKind", () => {
|
|
it("detects image, video, and audio assets", () => {
|
|
expect(getTimelineAssetKind("assets/photo.png")).toBe("image");
|
|
expect(getTimelineAssetKind("assets/clip.mp4")).toBe("video");
|
|
expect(getTimelineAssetKind("assets/clip.mov")).toBe("video");
|
|
expect(getTimelineAssetKind("assets/music.mp3")).toBe("audio");
|
|
expect(getTimelineAssetKind("assets/music.wav")).toBe("audio");
|
|
});
|
|
|
|
it("classifies svg as image", () => {
|
|
expect(getTimelineAssetKind("assets/logo.svg")).toBe("image");
|
|
expect(getTimelineAssetKind("assets/ICON.SVG")).toBe("image");
|
|
});
|
|
|
|
it("classifies avif and webp as image", () => {
|
|
expect(getTimelineAssetKind("assets/photo.avif")).toBe("image");
|
|
expect(getTimelineAssetKind("assets/photo.webp")).toBe("image");
|
|
});
|
|
|
|
it("returns null for unknown extensions", () => {
|
|
expect(getTimelineAssetKind("assets/data.json")).toBeNull();
|
|
expect(getTimelineAssetKind("assets/font.woff2")).toBeNull();
|
|
});
|
|
});
|
|
|
|
describe("buildTimelineAssetInsertHtml", () => {
|
|
it("builds an image clip with explicit timing and track", () => {
|
|
const html = buildTimelineAssetInsertHtml({
|
|
id: "photo_asset",
|
|
hfId: "hf-abc123",
|
|
assetPath: "assets/photo.png",
|
|
kind: "image",
|
|
start: 1.25,
|
|
duration: 3,
|
|
track: 2,
|
|
zIndex: 4,
|
|
geometry: { left: 0, top: 0, width: 1280, height: 720 },
|
|
});
|
|
|
|
expect(html).toContain('img id="photo_asset"');
|
|
expect(html).toContain("left: 0px");
|
|
expect(html).toContain("width: 1280px");
|
|
expect(html).not.toContain("inset:");
|
|
});
|
|
|
|
it("builds an audio clip without visual layout styles", () => {
|
|
const html = buildTimelineAssetInsertHtml({
|
|
id: "music_asset",
|
|
hfId: "hf-xyz789",
|
|
assetPath: "assets/music.wav",
|
|
kind: "audio",
|
|
start: 0.5,
|
|
duration: 5,
|
|
track: 0,
|
|
zIndex: 1,
|
|
});
|
|
expect(html).toContain("<audio");
|
|
expect(html).not.toContain("object-fit");
|
|
});
|
|
});
|
|
|
|
describe("resolveTimelineAssetCompositionSize", () => {
|
|
it("uses the target composition dimensions for visual media", () => {
|
|
expect(
|
|
resolveTimelineAssetCompositionSize(
|
|
`<div data-composition-id="main" data-width="330" data-height="228"></div>`,
|
|
),
|
|
).toEqual({
|
|
width: 330,
|
|
height: 228,
|
|
});
|
|
});
|
|
});
|
|
|
|
describe("resolveTimelineAssetSrc", () => {
|
|
it("keeps project-root asset paths for index.html", () => {
|
|
expect(resolveTimelineAssetSrc("index.html", "assets/photo.png")).toBe("assets/photo.png");
|
|
});
|
|
|
|
it("rewrites asset paths relative to sub-compositions", () => {
|
|
expect(resolveTimelineAssetSrc("compositions/scene-a.html", "assets/photo.png")).toBe(
|
|
"../assets/photo.png",
|
|
);
|
|
});
|
|
});
|
|
|
|
describe("buildTimelineFileDropPlacements", () => {
|
|
it("returns no placements for an empty drop set", () => {
|
|
expect(buildTimelineFileDropPlacements({ start: 1.5, track: 2 }, [])).toEqual([]);
|
|
});
|
|
|
|
it("spaces multiple files by duration and keeps every one on the dropped track", () => {
|
|
// A clip placed onto an occupied track stays there (overlap is allowed); it is
|
|
// NOT bumped to a new track — that produced surprise empty tracks for users.
|
|
expect(buildTimelineFileDropPlacements({ start: 1.5, track: 2 }, [1.2, 1.6, 1.1])).toEqual([
|
|
{ start: 1.5, track: 2 },
|
|
{ start: 2.7, track: 2 },
|
|
{ start: 4.3, track: 2 },
|
|
]);
|
|
});
|
|
|
|
it("uses fallback spacing when a duration is unavailable", () => {
|
|
expect(buildTimelineFileDropPlacements({ start: 1.5, track: 2 }, [1.2, 0, 1.1])).toEqual([
|
|
{ start: 1.5, track: 2 },
|
|
{ start: 2.7, track: 2 },
|
|
{ start: 7.7, track: 2 },
|
|
]);
|
|
});
|
|
});
|
|
|
|
describe("insertTimelineAssetIntoSource", () => {
|
|
it("appends the new asset inside the root composition", () => {
|
|
const source = `<!doctype html><html><body><div id="root" data-composition-id="main"></div></body></html>`;
|
|
const html = insertTimelineAssetIntoSource(
|
|
source,
|
|
'<img id="photo_asset" data-start="0" data-duration="3" />',
|
|
);
|
|
|
|
expect(html).toContain('data-composition-id="main">');
|
|
expect(html).toContain('<img id="photo_asset" data-start="0" data-duration="3" />');
|
|
});
|
|
});
|
|
|
|
describe("buildTimelineAssetInsertHtml — video audio", () => {
|
|
const base = {
|
|
id: "clip_asset",
|
|
hfId: "hf-vid-1",
|
|
assetPath: "assets/clip.mp4",
|
|
kind: "video" as const,
|
|
start: 0,
|
|
duration: 8,
|
|
track: 1,
|
|
zIndex: 2,
|
|
};
|
|
|
|
it("inserts a video muted when nothing says it carries audio", () => {
|
|
const html = buildTimelineAssetInsertHtml(base);
|
|
expect(html).toContain(" muted ");
|
|
expect(html).not.toContain("data-has-audio");
|
|
});
|
|
|
|
it("inserts a video with an audio stream audible: data-has-audio and no muted", () => {
|
|
const html = buildTimelineAssetInsertHtml({ ...base, hasAudio: true });
|
|
expect(html).toContain('data-has-audio="true"');
|
|
expect(html).not.toContain("muted");
|
|
expect(html).toContain("playsinline");
|
|
});
|
|
|
|
it("keeps a video without an audio stream muted", () => {
|
|
const html = buildTimelineAssetInsertHtml({ ...base, hasAudio: false });
|
|
expect(html).toContain(" muted ");
|
|
expect(html).not.toContain("data-has-audio");
|
|
});
|
|
});
|
|
|
|
describe("buildTimelineAssetInsertHtml markup quality", () => {
|
|
const base = {
|
|
id: "clip_1",
|
|
hfId: "hf-test-1",
|
|
assetPath: "assets/a.mp4",
|
|
start: 1,
|
|
duration: 4,
|
|
track: 2,
|
|
zIndex: 3,
|
|
};
|
|
|
|
it("stamps data-hf-id on all kinds", () => {
|
|
for (const kind of ["image", "video", "audio"] as const) {
|
|
expect(buildTimelineAssetInsertHtml({ ...base, kind })).toContain('data-hf-id="hf-test-1"');
|
|
}
|
|
});
|
|
|
|
it("audio gets an explicit data-volume", () => {
|
|
expect(buildTimelineAssetInsertHtml({ ...base, kind: "audio" })).toContain('data-volume="1"');
|
|
});
|
|
});
|
|
|
|
describe("fitTimelineAssetGeometry", () => {
|
|
const comp = { width: 1920, height: 1080 };
|
|
|
|
it("centers a smaller-than-comp asset at natural size", () => {
|
|
expect(fitTimelineAssetGeometry({ width: 640, height: 360 }, comp)).toEqual({
|
|
left: 640,
|
|
top: 360,
|
|
width: 640,
|
|
height: 360,
|
|
});
|
|
});
|
|
|
|
it("scales an oversized asset down to fit, preserving aspect, centered", () => {
|
|
// 4000x1000 → capped to 1920 wide → 1920x480, centered vertically
|
|
expect(fitTimelineAssetGeometry({ width: 4000, height: 1000 }, comp)).toEqual({
|
|
left: 0,
|
|
top: 300,
|
|
width: 1920,
|
|
height: 480,
|
|
});
|
|
});
|
|
|
|
it("falls back to full-frame when natural size is unknown", () => {
|
|
expect(fitTimelineAssetGeometry(null, comp)).toEqual({
|
|
left: 0,
|
|
top: 0,
|
|
width: 1920,
|
|
height: 1080,
|
|
});
|
|
});
|
|
});
|
|
|
|
it("writes a dropped file's name as a URL, so %, #, ? and apostrophes load", () => {
|
|
const html = buildTimelineAssetInsertHtml({
|
|
id: "clip",
|
|
hfId: "hf-clip",
|
|
assetPath: "../assets/50% off #1?'s take.mp4",
|
|
kind: "video",
|
|
start: 0,
|
|
duration: 2,
|
|
track: 1,
|
|
zIndex: 1,
|
|
});
|
|
expect(html).toContain('src="../assets/50%25%20off%20%231%3F%27s%20take.mp4"');
|
|
});
|