refactor(canvas): 预演台 - 重构工作台与场景交互链路
This commit is contained in:
1 parent
1dfc8ce7ac
commit
112916587c
128 files changed
+42372
-5011
No files matched your search
@@ -1,25 +1,25 @@
|
||||
import { beforeEach, describe, expect, test } from "bun:test";
|
||||
|
||||
import { DIRECTOR_DEFAULT_MODE, DIRECTOR_MODES, directorModeCapabilities, resolveDirectorModeTransition, type DirectorMode } from "../src/lib/canvas/director/director-modes";
|
||||
import { createDirectorScene } from "../src/lib/canvas/director/director-scene";
|
||||
import { createDirectorSceneFromTemplate } from "../src/lib/canvas/director/director-templates";
|
||||
import { useDirectorWorkbenchStore } from "../src/stores/canvas/use-director-workbench-store";
|
||||
import { PREVIS_DEFAULT_MODE, PREVIS_MODES, previsModeCapabilities, resolvePrevisModeTransition, type PrevisMode } from "../src/lib/canvas/previs/previs-modes";
|
||||
import { createPrevisScene } from "../src/lib/canvas/previs/previs-scene";
|
||||
import { createPrevisSceneFromTemplate } from "../src/lib/canvas/previs/previs-templates";
|
||||
import { usePrevisWorkbenchStore } from "../src/stores/canvas/use-previs-workbench-store";
|
||||
|
||||
const ALL_MODES: DirectorMode[] = ["layout", "pose", "animate", "camera"];
|
||||
const ALL_MODES: PrevisMode[] = ["layout", "pose", "animate", "camera"];
|
||||
|
||||
describe("四模式骨架", () => {
|
||||
test("恰好四个一级模式,顺序为摆场/姿态/动画/摄影机", () => {
|
||||
expect(DIRECTOR_MODES.map((item) => item.mode)).toEqual(ALL_MODES);
|
||||
expect(DIRECTOR_MODES.map((item) => item.label)).toEqual(["摆场", "姿态", "动画", "摄影机"]);
|
||||
expect(PREVIS_MODES.map((item) => item.mode)).toEqual(ALL_MODES);
|
||||
expect(PREVIS_MODES.map((item) => item.label)).toEqual(["摆场", "姿态", "动画", "摄影机"]);
|
||||
});
|
||||
|
||||
test("默认模式是摆场", () => {
|
||||
expect(DIRECTOR_DEFAULT_MODE).toBe("layout");
|
||||
expect(useDirectorWorkbenchStore.getState().mode).toBe("layout");
|
||||
expect(PREVIS_DEFAULT_MODE).toBe("layout");
|
||||
expect(usePrevisWorkbenchStore.getState().mode).toBe("layout");
|
||||
});
|
||||
|
||||
test("每个模式都有可读标签与提示,保证可发现", () => {
|
||||
for (const item of DIRECTOR_MODES) {
|
||||
for (const item of PREVIS_MODES) {
|
||||
expect(item.label.length).toBeGreaterThan(0);
|
||||
expect(item.hint.length).toBeGreaterThan(0);
|
||||
}
|
||||
@@ -29,75 +29,75 @@ describe("四模式骨架", () => {
|
||||
describe("能力矩阵", () => {
|
||||
test("只有动画模式显示时间轴、允许关键帧与 Auto Key", () => {
|
||||
for (const mode of ALL_MODES) {
|
||||
const capabilities = directorModeCapabilities(mode);
|
||||
const capabilities = previsModeCapabilities(mode);
|
||||
expect(capabilities.timeline).toBe(mode === "animate");
|
||||
expect(capabilities.keyframes).toBe(mode === "animate");
|
||||
}
|
||||
});
|
||||
|
||||
test("摆场隐藏骨骼;姿态与动画显示骨骼", () => {
|
||||
expect(directorModeCapabilities("layout").bones).toBe(false);
|
||||
expect(directorModeCapabilities("camera").bones).toBe(false);
|
||||
expect(directorModeCapabilities("pose").bones).toBe(true);
|
||||
expect(directorModeCapabilities("animate").bones).toBe(true);
|
||||
expect(previsModeCapabilities("layout").bones).toBe(false);
|
||||
expect(previsModeCapabilities("camera").bones).toBe(false);
|
||||
expect(previsModeCapabilities("pose").bones).toBe(true);
|
||||
expect(previsModeCapabilities("animate").bones).toBe(true);
|
||||
});
|
||||
|
||||
test("只有摄影机模式突出 shot/camera 工具", () => {
|
||||
for (const mode of ALL_MODES) {
|
||||
expect(directorModeCapabilities(mode).cameraTools).toBe(mode === "camera");
|
||||
expect(previsModeCapabilities(mode).cameraTools).toBe(mode === "camera");
|
||||
}
|
||||
});
|
||||
|
||||
test("摆场不提供深度/法线等高级视图;摄影机模式才提供", () => {
|
||||
expect(directorModeCapabilities("layout").renderModes).toEqual(["beauty", "clay"]);
|
||||
expect(directorModeCapabilities("layout").renderModes).not.toContain("depth");
|
||||
expect(directorModeCapabilities("layout").renderModes).not.toContain("pose");
|
||||
expect(directorModeCapabilities("camera").renderModes).toContain("depth");
|
||||
expect(directorModeCapabilities("camera").renderModes).toContain("normal");
|
||||
expect(previsModeCapabilities("layout").renderModes).toEqual(["beauty", "clay"]);
|
||||
expect(previsModeCapabilities("layout").renderModes).not.toContain("depth");
|
||||
expect(previsModeCapabilities("layout").renderModes).not.toContain("pose");
|
||||
expect(previsModeCapabilities("camera").renderModes).toContain("depth");
|
||||
expect(previsModeCapabilities("camera").renderModes).toContain("normal");
|
||||
});
|
||||
|
||||
test("姿态模式提供骨骼视图", () => {
|
||||
expect(directorModeCapabilities("pose").renderModes).toContain("pose");
|
||||
expect(previsModeCapabilities("pose").renderModes).toContain("pose");
|
||||
});
|
||||
|
||||
test("未知模式回落到默认模式的能力,不返回 undefined", () => {
|
||||
expect(directorModeCapabilities("nope" as DirectorMode)).toEqual(directorModeCapabilities("layout"));
|
||||
expect(previsModeCapabilities("nope" as PrevisMode)).toEqual(previsModeCapabilities("layout"));
|
||||
});
|
||||
});
|
||||
|
||||
describe("切换清理:离开动画不得残留后台动画写入", () => {
|
||||
test("离开动画模式一定停播并关掉 Auto Key", () => {
|
||||
for (const mode of ["layout", "pose", "camera"] as DirectorMode[]) {
|
||||
const next = resolveDirectorModeTransition({ mode, playing: true, autoKey: true, renderMode: "beauty" });
|
||||
for (const mode of ["layout", "pose", "camera"] as PrevisMode[]) {
|
||||
const next = resolvePrevisModeTransition({ mode, playing: true, autoKey: true, renderMode: "beauty" });
|
||||
expect(next.playing).toBe(false);
|
||||
expect(next.autoKey).toBe(false);
|
||||
}
|
||||
});
|
||||
|
||||
test("留在动画模式时保留播放与 Auto Key", () => {
|
||||
const next = resolveDirectorModeTransition({ mode: "animate", playing: true, autoKey: true, renderMode: "beauty" });
|
||||
const next = resolvePrevisModeTransition({ mode: "animate", playing: true, autoKey: true, renderMode: "beauty" });
|
||||
expect(next.playing).toBe(true);
|
||||
expect(next.autoKey).toBe(true);
|
||||
});
|
||||
|
||||
test("renderMode 被夹回目标模式允许的集合", () => {
|
||||
// 摄影机模式的深度视图不能带进摆场。
|
||||
expect(resolveDirectorModeTransition({ mode: "layout", playing: false, autoKey: false, renderMode: "depth" }).renderMode).toBe("beauty");
|
||||
expect(resolvePrevisModeTransition({ mode: "layout", playing: false, autoKey: false, renderMode: "depth" }).renderMode).toBe("beauty");
|
||||
// 姿态模式的骨骼视图同样不属于摆场。
|
||||
expect(resolveDirectorModeTransition({ mode: "layout", playing: false, autoKey: false, renderMode: "pose" }).renderMode).toBe("beauty");
|
||||
expect(resolvePrevisModeTransition({ mode: "layout", playing: false, autoKey: false, renderMode: "pose" }).renderMode).toBe("beauty");
|
||||
// 合法组合保持不变。
|
||||
expect(resolveDirectorModeTransition({ mode: "camera", playing: false, autoKey: false, renderMode: "normal" }).renderMode).toBe("normal");
|
||||
expect(resolveDirectorModeTransition({ mode: "layout", playing: false, autoKey: false, renderMode: "clay" }).renderMode).toBe("clay");
|
||||
expect(resolvePrevisModeTransition({ mode: "camera", playing: false, autoKey: false, renderMode: "normal" }).renderMode).toBe("normal");
|
||||
expect(resolvePrevisModeTransition({ mode: "layout", playing: false, autoKey: false, renderMode: "clay" }).renderMode).toBe("clay");
|
||||
});
|
||||
});
|
||||
|
||||
describe("store 的 setMode", () => {
|
||||
beforeEach(() => {
|
||||
useDirectorWorkbenchStore.getState().reset();
|
||||
usePrevisWorkbenchStore.getState().reset();
|
||||
});
|
||||
|
||||
test("切到动画再切回摆场:playing 与 autoKey 都被清掉", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setMode("animate");
|
||||
store.getState().setPlaying(true);
|
||||
store.getState().setAutoKey(true);
|
||||
@@ -111,7 +111,7 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
|
||||
test("切模式不影响选择状态:draft 归属由 workbench 自己管", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setSelectedObjectId("obj-1");
|
||||
store.getState().setMode("camera");
|
||||
expect(store.getState().selectedObjectId).toBe("obj-1");
|
||||
@@ -120,7 +120,7 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
|
||||
test("切模式不重置 playhead:时间位置不因为换视图而丢", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setMode("animate");
|
||||
store.getState().setPlayhead(2.5);
|
||||
store.getState().setMode("pose");
|
||||
@@ -128,14 +128,14 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
|
||||
test("reset 回到默认摆场", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setMode("animate");
|
||||
store.getState().reset();
|
||||
expect(store.getState().mode).toBe("layout");
|
||||
});
|
||||
|
||||
test("摆场模式拒绝 pose/depth/normal,只接受 beauty/clay", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
expect(store.getState().mode).toBe("layout");
|
||||
|
||||
store.getState().setRenderMode("clay");
|
||||
@@ -149,14 +149,14 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
|
||||
test("dock 的「骨骼视图」在摆场模式点了也无效:store 层夹住了所有路径", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
// dock 按钮等价于直接调 setRenderMode("pose")。
|
||||
store.getState().setRenderMode("pose");
|
||||
expect(store.getState().renderMode).toBe("beauty");
|
||||
});
|
||||
|
||||
test("摄影机模式才接受 depth/normal", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setMode("camera");
|
||||
store.getState().setRenderMode("depth");
|
||||
expect(store.getState().renderMode).toBe("depth");
|
||||
@@ -165,7 +165,7 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
|
||||
test("姿态模式接受骨骼视图,但仍拒绝深度视图", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setMode("pose");
|
||||
store.getState().setRenderMode("pose");
|
||||
expect(store.getState().renderMode).toBe("pose");
|
||||
@@ -174,7 +174,7 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
|
||||
test("带着深度视图离开摄影机模式会被夹回 beauty,不残留非法组合", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const store = usePrevisWorkbenchStore;
|
||||
store.getState().setMode("camera");
|
||||
store.getState().setRenderMode("depth");
|
||||
expect(store.getState().renderMode).toBe("depth");
|
||||
@@ -184,15 +184,15 @@ describe("store 的 setMode", () => {
|
||||
});
|
||||
});
|
||||
|
||||
describe("mode 不进 DirectorScene schema", () => {
|
||||
describe("mode 不进 PrevisScene schema", () => {
|
||||
test("兼容 factory 与模板生成的场景都没有 mode 字段", () => {
|
||||
expect(Object.keys(createDirectorScene("s"))).not.toContain("mode");
|
||||
expect(Object.keys(createDirectorSceneFromTemplate("dialogue"))).not.toContain("mode");
|
||||
expect(Object.keys(createPrevisScene("s"))).not.toContain("mode");
|
||||
expect(Object.keys(createPrevisSceneFromTemplate("dialogue"))).not.toContain("mode");
|
||||
});
|
||||
|
||||
test("切模式不产生任何场景对象:mode 纯属工作台 UI 状态", () => {
|
||||
const store = useDirectorWorkbenchStore;
|
||||
const before = createDirectorSceneFromTemplate("monologue");
|
||||
const store = usePrevisWorkbenchStore;
|
||||
const before = createPrevisSceneFromTemplate("monologue");
|
||||
const snapshot = JSON.stringify(before);
|
||||
store.getState().setMode("animate");
|
||||
store.getState().setMode("layout");
|
||||
|
||||
Reference in new issue
Block a user