mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +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
291 lines
10 KiB
TypeScript
291 lines
10 KiB
TypeScript
// @vitest-environment happy-dom
|
|
|
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
import {
|
|
historyTooltipLabel,
|
|
findMatchingTimelineElementId,
|
|
findTimelineIdByAncestor,
|
|
resolveAssetHasAudio,
|
|
resolveDroppedAssetDuration,
|
|
resolveDroppedAssetDimensions,
|
|
resolveElementTrack,
|
|
resolveTimelineIdForSelection,
|
|
resolveTimelineSelectionSeekTime,
|
|
} from "./studioHelpers";
|
|
|
|
afterEach(() => {
|
|
vi.useRealTimers();
|
|
vi.unstubAllGlobals();
|
|
vi.restoreAllMocks();
|
|
});
|
|
|
|
describe("resolveTimelineSelectionSeekTime", () => {
|
|
it("keeps the current time when it is already inside the clip range", () => {
|
|
expect(resolveTimelineSelectionSeekTime(3, { start: 0, duration: 5 })).toBe(3);
|
|
});
|
|
|
|
it("clamps to the clip start when current time is before the clip", () => {
|
|
expect(resolveTimelineSelectionSeekTime(1, { start: 4, duration: 3 })).toBe(4);
|
|
});
|
|
|
|
it("clamps to the clip end when current time is after the clip", () => {
|
|
expect(resolveTimelineSelectionSeekTime(10, { start: 4, duration: 3 })).toBe(7);
|
|
});
|
|
|
|
it("falls back to the clip start for invalid current time", () => {
|
|
expect(resolveTimelineSelectionSeekTime(Number.NaN, { start: 2, duration: 5 })).toBe(2);
|
|
});
|
|
});
|
|
|
|
describe("findMatchingTimelineElementId", () => {
|
|
const el = (over: Record<string, unknown>) =>
|
|
({ id: "x", start: 0, duration: 1, track: 0, tag: "div", ...over }) as never;
|
|
|
|
it("matches a top-level element by domId + sourceFile", () => {
|
|
const els = [el({ id: "s1", domId: "s1", sourceFile: "index.html" })];
|
|
expect(findMatchingTimelineElementId({ id: "s1", sourceFile: "index.html" }, els)).toBe("s1");
|
|
});
|
|
|
|
it("matches by hfId when the selection has no domId, so an element with no authored id can still be found", () => {
|
|
const els = [el({ id: "hf-1", domId: undefined, hfId: "hf-1", sourceFile: "index.html" })];
|
|
expect(
|
|
findMatchingTimelineElementId({ id: undefined, hfId: "hf-1", sourceFile: "index.html" }, els),
|
|
).toBe("hf-1");
|
|
});
|
|
|
|
it("returns a qualified id for a sub-comp child with no matching timeline element", () => {
|
|
const els = [el({ id: "s3", domId: "s3", sourceFile: "index.html" })];
|
|
expect(
|
|
findMatchingTimelineElementId(
|
|
{ id: "stat-3", sourceFile: "compositions/stats-panel.html" },
|
|
els,
|
|
),
|
|
).toBe("compositions/stats-panel.html#stat-3");
|
|
});
|
|
|
|
it("returns null for an unmatched element in index.html", () => {
|
|
expect(findMatchingTimelineElementId({ id: "ghost", sourceFile: "index.html" }, [])).toBe(null);
|
|
});
|
|
|
|
it("resolves the correct repeated composition host by domId, not the first host sharing the same compositionSrc", () => {
|
|
// Two hosts import the SAME sub-composition — only compositionSrc alone
|
|
// can't tell them apart, but each still has its own domId (as any
|
|
// element does). Selecting the SECOND host must not collapse to the
|
|
// first one just because an earlier, unrelated element also happens to
|
|
// share its compositionSrc.
|
|
const els = [
|
|
el({ id: "host-a", domId: "host-a", sourceFile: "index.html", compositionSrc: "scene.html" }),
|
|
el({ id: "host-b", domId: "host-b", sourceFile: "index.html", compositionSrc: "scene.html" }),
|
|
];
|
|
expect(
|
|
findMatchingTimelineElementId(
|
|
{
|
|
id: "host-b",
|
|
sourceFile: "index.html",
|
|
compositionSrc: "scene.html",
|
|
isCompositionHost: true,
|
|
},
|
|
els,
|
|
),
|
|
).toBe("host-b");
|
|
});
|
|
|
|
it("falls back to compositionSrc-only matching when the host selection has neither a domId nor a selector", () => {
|
|
const els = [
|
|
el({
|
|
id: "host-only",
|
|
domId: undefined,
|
|
sourceFile: "index.html",
|
|
compositionSrc: "scene.html",
|
|
}),
|
|
];
|
|
expect(
|
|
findMatchingTimelineElementId(
|
|
{
|
|
id: undefined,
|
|
sourceFile: "index.html",
|
|
compositionSrc: "scene.html",
|
|
isCompositionHost: true,
|
|
},
|
|
els,
|
|
),
|
|
).toBe("host-only");
|
|
});
|
|
});
|
|
|
|
describe("findTimelineIdByAncestor", () => {
|
|
const el = (over: Record<string, unknown>) =>
|
|
({ id: "x", start: 0, duration: 1, track: 0, tag: "div", ...over }) as never;
|
|
|
|
it("resolves a static descendant (.num) to its nearest clip ancestor", () => {
|
|
// #stat1 (a clip) > .num (selected, not a clip)
|
|
const stat1 = document.createElement("div");
|
|
stat1.id = "stat1";
|
|
const num = document.createElement("div");
|
|
num.className = "num";
|
|
stat1.appendChild(num);
|
|
|
|
const els = [el({ id: "stat1", domId: "stat1", key: "index.html#stat1" })];
|
|
expect(findTimelineIdByAncestor(num, els, "index.html")).toBe("index.html#stat1");
|
|
});
|
|
|
|
it("returns null when no ancestor is a clip", () => {
|
|
const wrap = document.createElement("div");
|
|
const child = document.createElement("span");
|
|
wrap.appendChild(child);
|
|
expect(findTimelineIdByAncestor(child, [], "index.html")).toBe(null);
|
|
});
|
|
});
|
|
|
|
describe("resolveTimelineIdForSelection", () => {
|
|
const el = (over: Record<string, unknown>) =>
|
|
({ id: "x", start: 0, duration: 1, track: 0, tag: "div", ...over }) as never;
|
|
|
|
it("resolves an ancestor clip against activeCompPath when the selection has no sourceFile", () => {
|
|
// #card (a clip in a sub-composition) > .leaf (selected, not itself a clip)
|
|
const card = document.createElement("div");
|
|
card.id = "card";
|
|
const leaf = document.createElement("span");
|
|
leaf.className = "leaf";
|
|
card.appendChild(leaf);
|
|
|
|
const els = [
|
|
el({
|
|
id: "card",
|
|
domId: "card",
|
|
key: "comps/panel.html#card",
|
|
sourceFile: "comps/panel.html",
|
|
}),
|
|
];
|
|
const selection = { element: leaf } as never;
|
|
|
|
// Falling back to the active comp matches; the old index.html-only fallback would miss.
|
|
expect(resolveTimelineIdForSelection(selection, els, "comps/panel.html")).toBe(
|
|
"comps/panel.html#card",
|
|
);
|
|
expect(resolveTimelineIdForSelection(selection, els, null)).toBe(null);
|
|
});
|
|
});
|
|
|
|
describe("resolveDroppedAssetDimensions", () => {
|
|
it("aborts an image probe when metadata times out", async () => {
|
|
vi.useFakeTimers();
|
|
const probe = {
|
|
addEventListener: vi.fn(),
|
|
naturalHeight: 0,
|
|
naturalWidth: 0,
|
|
src: "",
|
|
};
|
|
// Vitest 4 refuses to `new` an arrow-function mock, and the code under test
|
|
// constructs the probe with `new Image()`.
|
|
vi.stubGlobal(
|
|
"Image",
|
|
vi.fn(function () {
|
|
return probe;
|
|
}),
|
|
);
|
|
|
|
const result = resolveDroppedAssetDimensions("demo", "assets/hung.png", "image");
|
|
await vi.advanceTimersByTimeAsync(3000);
|
|
|
|
await expect(result).resolves.toBeNull();
|
|
expect(probe.src).toBe("");
|
|
});
|
|
|
|
it("aborts a video probe when metadata times out", async () => {
|
|
vi.useFakeTimers();
|
|
const video = document.createElement("video");
|
|
const load = vi.fn();
|
|
Object.defineProperty(video, "load", { configurable: true, value: load });
|
|
const createElement = document.createElement.bind(document);
|
|
vi.spyOn(document, "createElement").mockImplementation((tagName, options) =>
|
|
tagName === "video" ? video : createElement(tagName, options),
|
|
);
|
|
|
|
const result = resolveDroppedAssetDimensions("demo", "assets/hung.mp4", "video");
|
|
await vi.advanceTimersByTimeAsync(3000);
|
|
|
|
await expect(result).resolves.toBeNull();
|
|
expect(video.getAttribute("src")).toBe("");
|
|
expect(load).toHaveBeenCalledOnce();
|
|
});
|
|
});
|
|
|
|
describe("dropped asset probes", () => {
|
|
const NAME = "assets/50% off #1?'s take.mp4";
|
|
const URL = "/api/projects/demo/preview/assets/50%25%20off%20%231%3F%27s%20take.mp4";
|
|
|
|
it("probe a dropped file's length and size at its own URL", async () => {
|
|
vi.useFakeTimers();
|
|
const probes: HTMLVideoElement[] = [];
|
|
const createElement = document.createElement.bind(document);
|
|
vi.spyOn(document, "createElement").mockImplementation((tagName, options) => {
|
|
const el = createElement(tagName, options);
|
|
if (tagName === "video") probes.push(el as HTMLVideoElement);
|
|
return el;
|
|
});
|
|
|
|
const duration = resolveDroppedAssetDuration("demo", NAME, "video");
|
|
const size = resolveDroppedAssetDimensions("demo", NAME, "video");
|
|
expect(probes.map((probe) => probe.getAttribute("src"))).toEqual([URL, URL]);
|
|
await vi.advanceTimersByTimeAsync(3000);
|
|
await Promise.all([duration, size]);
|
|
});
|
|
});
|
|
|
|
describe("resolveElementTrack", () => {
|
|
it("rounds an authored track", () => {
|
|
expect(resolveElementTrack({ authoredTrack: 2.4, track: 0 })).toBe(2);
|
|
});
|
|
|
|
it("falls back to the resolved track, rounded, when nothing was authored", () => {
|
|
expect(resolveElementTrack({ authoredTrack: undefined, track: 3.6 })).toBe(4);
|
|
});
|
|
});
|
|
|
|
describe("historyTooltipLabel", () => {
|
|
// A disabled control gets no pointer events, so its tooltip cannot be opened
|
|
// to read. The wording is checked here instead of through the DOM.
|
|
it("names the action that would be undone", () => {
|
|
expect(historyTooltipLabel("undo", "Move layer")).toMatch(/^Undo Move layer \(.+\)$/);
|
|
});
|
|
|
|
it("names the action that would be redone", () => {
|
|
expect(historyTooltipLabel("redo", "Move layer")).toMatch(/^Redo Move layer \(.+\)$/);
|
|
});
|
|
|
|
it("keeps the shortcut when the history is empty", () => {
|
|
expect(historyTooltipLabel("undo", undefined)).toMatch(/^Undo \(.+\)$/);
|
|
expect(historyTooltipLabel("redo", null)).toMatch(/^Redo \(.+\)$/);
|
|
});
|
|
});
|
|
|
|
describe("resolveAssetHasAudio", () => {
|
|
afterEach(() => vi.unstubAllGlobals());
|
|
|
|
const stubMetadata = (response: Response | Error) =>
|
|
vi.stubGlobal(
|
|
"fetch",
|
|
vi.fn(async () => {
|
|
if (response instanceof Error) throw response;
|
|
return response;
|
|
}),
|
|
);
|
|
|
|
it("answers the metadata endpoint's audio flag", async () => {
|
|
stubMetadata(new Response(JSON.stringify({ metadata: { hasAudio: true } })));
|
|
expect(await resolveAssetHasAudio("p1", "assets/talk.mp4")).toBe(true);
|
|
stubMetadata(new Response(JSON.stringify({ metadata: { hasAudio: false } })));
|
|
expect(await resolveAssetHasAudio("p1", "assets/cutout.webm")).toBe(false);
|
|
});
|
|
|
|
it("answers null when the probe cannot tell", async () => {
|
|
stubMetadata(new Response("nope", { status: 500 }));
|
|
expect(await resolveAssetHasAudio("p1", "assets/talk.mp4")).toBeNull();
|
|
stubMetadata(new Error("offline"));
|
|
expect(await resolveAssetHasAudio("p1", "assets/talk.mp4")).toBeNull();
|
|
stubMetadata(new Response(JSON.stringify({ metadata: {} })));
|
|
expect(await resolveAssetHasAudio("p1", "assets/talk.mp4")).toBeNull();
|
|
});
|
|
});
|