241 lines
11 KiB
TypeScript
241 lines
11 KiB
TypeScript
import { describe, expect, test } from "bun:test";
|
||
|
||
import { createPrevisTransaction } from "../src/lib/canvas/previs/previs-gesture-transaction";
|
||
import { isPrevisOutputSnapshotCurrent, mergePrevisOutputPreview, shouldReinitializePrevisSession, upsertPrevisSceneById } from "../src/lib/canvas/previs/previs-session";
|
||
import { createPrevisScene } from "../src/lib/canvas/previs/previs-scene";
|
||
import type { PrevisScene } from "../src/types/previs";
|
||
|
||
function scene(id: string, title = id): PrevisScene {
|
||
return { ...createPrevisScene(title), id };
|
||
}
|
||
|
||
describe("会话初始化判定：只认 scene id（A1 回归）", () => {
|
||
test("首次挂载会初始化", () => {
|
||
expect(shouldReinitializePrevisSession({ initializedSceneId: null, nextSceneId: "s1" })).toBe(true);
|
||
});
|
||
|
||
test("同 id 的父级镜像回流不重建会话", () => {
|
||
expect(shouldReinitializePrevisSession({ initializedSceneId: "s1", nextSceneId: "s1" })).toBe(false);
|
||
});
|
||
|
||
test("切换到不同 scene id 才重建", () => {
|
||
expect(shouldReinitializePrevisSession({ initializedSceneId: "s1", nextSceneId: "s2" })).toBe(true);
|
||
});
|
||
|
||
test("没有 scene 时不初始化", () => {
|
||
expect(shouldReinitializePrevisSession({ initializedSceneId: "s1", nextSceneId: null })).toBe(false);
|
||
expect(shouldReinitializePrevisSession({ initializedSceneId: null, nextSceneId: null })).toBe(false);
|
||
});
|
||
|
||
test("镜像回流序列中只有 id 变化的那一次会重建", () => {
|
||
let initialized: string | null = null;
|
||
const rebuilds: string[] = [];
|
||
["s1", "s1", "s1", "s2", "s2"].forEach((nextSceneId) => {
|
||
if (!shouldReinitializePrevisSession({ initializedSceneId: initialized, nextSceneId })) return;
|
||
initialized = nextSceneId;
|
||
rebuilds.push(nextSceneId);
|
||
});
|
||
expect(rebuilds).toEqual(["s1", "s2"]);
|
||
});
|
||
});
|
||
|
||
describe("upsertPrevisSceneById：连续保存不丢 scene（A6 回归）", () => {
|
||
test("连续保存 A/B 后两者都在", () => {
|
||
const a = scene("a");
|
||
const b = scene("b");
|
||
const afterA = upsertPrevisSceneById([], a);
|
||
const afterB = upsertPrevisSceneById(afterA, b);
|
||
expect(afterB.map((item) => item.id)).toEqual(["a", "b"]);
|
||
});
|
||
|
||
test("同 id 是替换而不是追加", () => {
|
||
const first = scene("a", "旧标题");
|
||
const second = { ...first, title: "新标题" };
|
||
const next = upsertPrevisSceneById([first], second);
|
||
expect(next).toHaveLength(1);
|
||
expect(next[0].title).toBe("新标题");
|
||
});
|
||
|
||
test("替换时不影响其他 scene 的顺序与内容", () => {
|
||
const list = [scene("a"), scene("b"), scene("c")];
|
||
const next = upsertPrevisSceneById(list, { ...list[1], title: "改过的 b" });
|
||
expect(next.map((item) => item.id)).toEqual(["a", "b", "c"]);
|
||
expect(next[0]).toBe(list[0]);
|
||
expect(next[2]).toBe(list[2]);
|
||
expect(next[1].title).toBe("改过的 b");
|
||
});
|
||
|
||
test("以最新数组为基准的连续保存不会用旧快照覆盖", () => {
|
||
// 模拟缺陷：第二次保存若以「第一次之前的数组」为基准，就会丢掉 a。
|
||
const a = scene("a");
|
||
const b = scene("b");
|
||
const stale: PrevisScene[] = [];
|
||
const authoritative = upsertPrevisSceneById(stale, a);
|
||
expect(upsertPrevisSceneById(stale, b).map((item) => item.id)).toEqual(["b"]);
|
||
expect(upsertPrevisSceneById(authoritative, b).map((item) => item.id)).toEqual(["a", "b"]);
|
||
});
|
||
});
|
||
|
||
describe("异步输出只合并预览引用，不覆盖最新场景", () => {
|
||
test("保留上传期间发生的场景与镜头编辑", () => {
|
||
const latest = scene("s1", "上传期间改过的标题");
|
||
const shotId = latest.shots[0].id;
|
||
latest.shots[0] = { ...latest.shots[0], name: "上传期间改过的镜头" };
|
||
const merged = mergePrevisOutputPreview(latest, { sceneId: latest.id, shotId, previewNodeId: "preview-1" });
|
||
expect(merged?.title).toBe("上传期间改过的标题");
|
||
expect(merged?.shots[0].name).toBe("上传期间改过的镜头");
|
||
expect(merged?.shots[0].previewNodeId).toBe("preview-1");
|
||
expect(merged?.shots[0].depthNodeId).toBeUndefined();
|
||
expect(merged?.shots[0].normalNodeId).toBeUndefined();
|
||
});
|
||
|
||
test("场景或镜头已经切换/删除时拒绝合并", () => {
|
||
const latest = scene("s1");
|
||
expect(mergePrevisOutputPreview(latest, { sceneId: "other", shotId: latest.shots[0].id, previewNodeId: "preview" })).toBeNull();
|
||
expect(mergePrevisOutputPreview(latest, { sceneId: latest.id, shotId: "missing", previewNodeId: "preview" })).toBeNull();
|
||
});
|
||
});
|
||
|
||
describe("截图与录制绑定开始时的场景快照", () => {
|
||
test("同一场景快照引用与同一活动镜头才允许继续", () => {
|
||
const current = scene("s1");
|
||
const expected = { scene: current, shotId: current.shots[0].id };
|
||
expect(isPrevisOutputSnapshotCurrent(current, expected)).toBe(true);
|
||
expect(isPrevisOutputSnapshotCurrent({ ...current }, expected)).toBe(false);
|
||
expect(isPrevisOutputSnapshotCurrent(null, expected)).toBe(false);
|
||
});
|
||
|
||
test("活动镜头切换时拒绝继续，即使原镜头仍存在", () => {
|
||
const current = scene("s1");
|
||
const originalShot = current.shots[0];
|
||
const otherShot = { ...originalShot, id: "shot-2", name: "镜头 2" };
|
||
const withOtherActive = { ...current, shots: [originalShot, otherShot], activeShotId: otherShot.id };
|
||
expect(isPrevisOutputSnapshotCurrent(withOtherActive, { scene: withOtherActive, shotId: originalShot.id })).toBe(false);
|
||
});
|
||
});
|
||
|
||
describe("预览与持久变更的发布边界（A2/A3/A4 回归）", () => {
|
||
/** 最小 session controller：与 workbench 的接线同构，但不依赖 React 挂载。 */
|
||
function harness(initial: PrevisScene) {
|
||
const published: PrevisScene[] = [];
|
||
const history: PrevisScene[] = [];
|
||
const flushes: number[] = [];
|
||
let draft = initial;
|
||
const publish = () => published.push(draft);
|
||
const staged = createPrevisTransaction<PrevisScene>({
|
||
read: () => draft,
|
||
restore: (snapshot) => {
|
||
draft = snapshot;
|
||
},
|
||
commit: (from) => {
|
||
history.push(from);
|
||
publish();
|
||
},
|
||
setActive: () => undefined,
|
||
});
|
||
return {
|
||
published,
|
||
history,
|
||
current: () => draft,
|
||
/** 普通持久提交：先终结暂存手势，再发布。 */
|
||
commit: (next: PrevisScene) => {
|
||
staged.end("commit");
|
||
history.push(draft);
|
||
draft = next;
|
||
publish();
|
||
},
|
||
/** 进行中预览：写草稿但不发布。 */
|
||
stage: (next: PrevisScene) => {
|
||
staged.begin();
|
||
draft = next;
|
||
},
|
||
settle: () => staged.end("commit"),
|
||
cancel: () => staged.end("cancel"),
|
||
close: () => {
|
||
staged.end("cancel");
|
||
publish();
|
||
},
|
||
/** pagehide：active 由 commit 自己 publish，idle 才显式 publish，最后 flush。 */
|
||
pagehide: () => {
|
||
if (staged.active()) staged.end("commit");
|
||
else publish();
|
||
flushes.push(published.length);
|
||
},
|
||
flushes,
|
||
};
|
||
}
|
||
|
||
test("进行中预览不发布，成功终态只发布一次", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.stage({ ...base, title: "拖动中 1" });
|
||
session.stage({ ...base, title: "拖动中 2" });
|
||
expect(session.published).toHaveLength(0);
|
||
session.settle();
|
||
expect(session.published).toHaveLength(1);
|
||
expect(session.published[0].title).toBe("拖动中 2");
|
||
});
|
||
|
||
test("取消的预览值绝不进入已发布 canonical", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.stage({ ...base, title: "会被取消" });
|
||
session.cancel();
|
||
expect(session.published).toHaveLength(0);
|
||
expect(session.current().title).toBe("起点");
|
||
// 后续关闭发布的是恢复后的值。
|
||
session.close();
|
||
expect(session.published.map((item) => item.title)).toEqual(["起点"]);
|
||
});
|
||
|
||
test("关闭前先取消未结束预览，再发布恢复后的 draft", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.stage({ ...base, title: "未结束" });
|
||
session.close();
|
||
expect(session.published).toHaveLength(1);
|
||
expect(session.published[0].title).toBe("起点");
|
||
});
|
||
|
||
test("普通提交前终结暂存手势，两段变更各自发布且历史不串", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.stage({ ...base, title: "滑杆中" });
|
||
session.commit({ ...base, title: "另一个动作" });
|
||
expect(session.published.map((item) => item.title)).toEqual(["滑杆中", "另一个动作"]);
|
||
expect(session.history).toHaveLength(2);
|
||
});
|
||
|
||
test("离开页面且预览进行中：只发布一次（#6 回归）", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.stage({ ...base, title: "离开前未结算" });
|
||
session.pagehide();
|
||
// 缺陷版本会 commit publish 一次 + 无条件 publishDraft 再一次。
|
||
expect(session.published).toHaveLength(1);
|
||
expect(session.published[0].title).toBe("离开前未结算");
|
||
// flush 必须发生在发布之后，否则会把旧快照写盘。
|
||
expect(session.flushes).toEqual([1]);
|
||
});
|
||
|
||
test("离开页面且无进行中预览：显式发布一次", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.pagehide();
|
||
expect(session.published).toHaveLength(1);
|
||
expect(session.flushes).toEqual([1]);
|
||
});
|
||
|
||
test("离开页面后再次 pagehide 不会重复结算同一手势", () => {
|
||
const base = scene("s1", "起点");
|
||
const session = harness(base);
|
||
session.stage({ ...base, title: "一次拖动" });
|
||
session.pagehide();
|
||
session.pagehide();
|
||
// 第二次是 idle 分支：显式发布当前 canonical，仍然各自恰好一次。
|
||
expect(session.published.map((item) => item.title)).toEqual(["一次拖动", "一次拖动"]);
|
||
expect(session.history).toHaveLength(1);
|
||
expect(session.flushes).toEqual([1, 2]);
|
||
});
|
||
});
|