Files
hyperframes/packages/studio/src/hooks/useRazorSplit.history.test.tsx
T
Miguel Ángelandukimsanov c6a508a9bc fix(studio): continuation of #2277 (#2286)
* feat(studio): timeline collision and placement model

What: new pure module timelineCollision — zone-aware drop placement
(clampTrackToZone, resolveZoneDropPlacement, resolveInsertRow,
resolvePlacement, lane/overlap predicates) with its full test suite.

Why: the no-overlap core of the NLE clip-drag engine; plain functions, no
DOM, no React, no store writes.

How: new files only; type-only imports from the existing playerStore.
First runtime consumer arrives with the drag-engine PRs.

Test plan: bunx vitest run timelineCollision.test.ts; tsc --noEmit; fallow
audit clean (all exports test-consumed).

* feat(studio): timeline magnetic snapping

What: new pure module timelineSnapping — snap-target collection and
pixel-threshold time snapping (collectTimelineSnapTargets, snapTimelineTime,
snapMoveToTargets) with tests.

Why: the magnet math for clip drags/trims, reviewable standalone.

How: new files only; type-only playerStore imports; consumers land with the
drag engine.

Test plan: bunx vitest run timelineSnapping.test.ts; tsc --noEmit; fallow
audit clean.

* feat(studio): multi-clip drag preview math

What: new pure module timelineMultiDragPreview — group-drag passenger
offsets and clamped group deltas (isMultiDragActive, multiDragDeltaSeconds,
multiDragPassengerOffsetPx, clampGroupMoveDelta) with tests.

Why: the group-drag math, standalone and DOM-free.

How: new files only; consumed later by TimelineLanes.

Test plan: bunx vitest run timelineMultiDragPreview.test.ts; tsc --noEmit;
fallow audit clean.

* feat(studio): timeline z-stacking sync model

What: new pure module timelineStackingSync — lane order ↔ z-index
reconciliation (laneIsAbove, computeStackingPatches) with tests.

Why: the single source of truth for how timeline lane order maps to canvas
stacking; the ordering rules and tie-breaks live here.

How: new files only; consumed later by timelineZones and the stacking-sync
hook.

Test plan: bunx vitest run timelineStackingSync.test.ts; tsc --noEmit;
fallow audit clean.

* feat(studio): timeline lane-zone model

What: new pure module timelineZones — visual/audio track-zone
classification (classifyZone) and normalizeToZones, which re-packs lanes
into zone-consistent rows; tests cover the stacking/zones interaction.

Why: completes the z-model started in the stacking-sync PR.

How: new files; consumes isAudioTimelineElement (leaf-helpers PR) and
computeStackingPatches (stacking-sync PR); type-only playerStore imports.

Test plan: bunx vitest run timelineZones.test.ts; tsc --noEmit; fallow
audit clean.

* feat(studio): asset click policy and canvas nudge gate

What: two small pure modules with tests — assetClickBehavior (click vs
double-click policy for sidebar assets) and canvasNudgeGate (debounce gate
for arrow-key canvas nudges).

Why: policy dependencies of the upcoming asset card and nudge hook,
reviewable as plain decision tables.

How: new files only.

Test plan: bunx vitest run on both test files; tsc --noEmit; fallow audit
clean.

* test(studio): characterization suites for resize commit and razor history

What: two test-only suites pinning CURRENT behavior before the NLE swap:
anchoredResizeReleaseShift.test.ts (manual-offset resize release commits)
and useRazorSplit.history.test.tsx (razor split undo/redo history).

Why: regression tripwires — the later glue-swap PRs must keep these green.

How: test files only; they import existing main modules unchanged and pass
against them as-is.

Test plan: bunx vitest run on both suites; fallow audit clean.

---------

Co-authored-by: ukimsanov <ular.kimsanov@heygen.com>
2026-07-12 00:19:36 -04:00

174 lines
5.7 KiB
TypeScript

// @vitest-environment happy-dom
import React, { act } from "react";
import { createRoot } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import type { TimelineElement } from "../player";
import { useRazorSplit } from "./useRazorSplit";
import { createPersistentEditHistoryStore } from "./usePersistentEditHistory";
import { createMemoryEditHistoryStorage } from "../utils/editHistoryStorage";
import { createEmptyEditHistory } from "../utils/editHistory";
(globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
const ORIGINAL = `<div class="clip" id="clip1" data-start="0" data-duration="4">hi</div>`;
const SPLIT =
`<div class="clip" id="clip1" data-start="0" data-duration="2">hi</div>` +
`<div class="clip" id="clip1-split" data-start="2" data-duration="2">hi</div>`;
const element: TimelineElement = {
id: "clip1",
tag: "div",
start: 0,
duration: 4,
track: 0,
domId: "clip1",
sourceFile: "index.html",
timingSource: "authored",
};
type Split = (element: TimelineElement, splitTime: number) => Promise<void>;
interface Harness {
disk: Record<string, string>;
store: ReturnType<typeof createPersistentEditHistoryStore>;
splitRef: { current: Split | undefined };
root: ReturnType<typeof createRoot>;
expected: string;
}
const SPLIT_GSAP = SPLIT.replace(
"</div>",
"</div><script>window.__timelines={};const tl=gsap.timeline({paused:true});" +
'tl.set("#clip1-split",{x:0},2);window.__timelines["c"]=tl;</script>',
);
function mountRazorSplit(opts: { gsap?: boolean } = {}): Harness {
const disk: Record<string, string> = { "index.html": ORIGINAL };
const finalContent = opts.gsap ? SPLIT_GSAP : SPLIT;
const storage = createMemoryEditHistoryStorage();
const store = createPersistentEditHistoryStore({
projectId: "p1",
storage,
initialState: createEmptyEditHistory(),
now: (() => {
let t = 1000;
return () => (t += 10);
})(),
onChange: () => {},
});
// Faithful stand-in for the studio-server file-mutation endpoints: the server
// writes the split to disk itself, then returns the patched content.
const fetchMock = vi.fn(async (url: string, init?: RequestInit) => {
const u = String(url);
if (u.includes("/gsap-mutations/")) {
if (opts.gsap) {
// Mirror the server: rewrites the GSAP script for the new id, writes to
// disk, returns the final content.
disk["index.html"] = SPLIT_GSAP;
return new Response(JSON.stringify({ ok: true, after: SPLIT_GSAP }), {
status: 200,
headers: { "Content-Type": "application/json" },
});
}
// The fixture has no GSAP script — mirror the server's 400 response.
return new Response(JSON.stringify({ error: "no GSAP script found in file" }), {
status: 400,
headers: { "Content-Type": "application/json" },
});
}
if (u.includes("/file-mutations/split-element/")) {
disk["index.html"] = SPLIT;
return new Response(
JSON.stringify({ ok: true, changed: true, content: SPLIT, newId: "clip1-split" }),
{ status: 200, headers: { "Content-Type": "application/json" } },
);
}
if (u.includes("/files/")) {
return new Response(JSON.stringify({ content: disk["index.html"] }), {
status: 200,
headers: { "Content-Type": "application/json" },
});
}
void init;
throw new Error(`unexpected fetch: ${u}`);
});
vi.stubGlobal("fetch", fetchMock);
const splitRef: { current: Split | undefined } = { current: undefined };
function Component() {
const { handleRazorSplit } = useRazorSplit({
projectId: "p1",
activeCompPath: "index.html",
showToast: () => {},
writeProjectFile: async (path, content) => {
disk[path] = content;
},
recordEdit: store.recordEdit,
domEditSaveTimestampRef: { current: 0 },
reloadPreview: () => {},
});
splitRef.current = handleRazorSplit;
return null;
}
const host = document.createElement("div");
document.body.append(host);
const root = createRoot(host);
act(() => {
root.render(<Component />);
});
return { disk, store, splitRef, root, expected: finalContent };
}
async function undoViaDisk(harness: Harness) {
return harness.store.undo({
readFile: async (path) => harness.disk[path],
writeFile: async (path, content) => {
harness.disk[path] = content;
},
});
}
afterEach(() => {
document.body.innerHTML = "";
vi.unstubAllGlobals();
});
describe("useRazorSplit — split is undoable via edit history", () => {
for (const gsap of [false, true]) {
describe(gsap ? "with GSAP rewrite" : "plain HTML split", () => {
let harness: Harness;
beforeEach(() => {
harness = mountRazorSplit({ gsap });
});
afterEach(() => {
act(() => harness.root.unmount());
});
it("records a single 'Split timeline clip' history entry that undo restores", async () => {
await act(async () => {
await harness.splitRef.current!(element, 2);
});
// The split reached disk.
expect(harness.disk["index.html"]).toBe(harness.expected);
// The split must be the top of the undo stack — not a prior/other entry.
expect(harness.store.snapshot().canUndo).toBe(true);
expect(harness.store.snapshot().undoLabel).toBe("Split timeline clip");
// Undo restores the exact pre-split file.
const result = await undoViaDisk(harness);
expect(result.ok).toBe(true);
expect(result.label).toBe("Split timeline clip");
expect(harness.disk["index.html"]).toBe(ORIGINAL);
});
});
}
});