docs(tests): explain legacy canvas and workspace unit coverage
This commit is contained in:
@@ -1,7 +1,12 @@
|
||||
/**
|
||||
* 旧画布快照 reducer 的基本历史、节点/边、序列化与分支规则测试。past/present/future 是旧版完整快照结构。
|
||||
* 这里的 checkpoint/replace 不能当作 headless 操作账本、条件增量请求或项目恢复协议的验证。
|
||||
*/
|
||||
import { test } from "node:test";
|
||||
import assert from "node:assert/strict";
|
||||
import { branchCanvasNode, canvasReducer, canvasStorageKey, decodeCanvas, emptyCanvas, makeCanvasNode } from "../src/lib/canvas.ts";
|
||||
|
||||
// 构造两张不同卡片及一条边,返回空 past/future 的独立历史,用于比较编辑前后内容和 viewport。
|
||||
function seeded() {
|
||||
const document = emptyCanvas();
|
||||
document.nodes = [makeCanvasNode("text", { x: 20, y: 30 }), makeCanvasNode("script", { x: 400, y: 30 })];
|
||||
@@ -9,6 +14,7 @@ function seeded() {
|
||||
return { past: [], present: document, future: [] };
|
||||
}
|
||||
|
||||
// checkpoint 后拖动形成一个历史起点;undo/redo 改内容位置但保留当前 viewport,视图导航不跟着旧快照回退。
|
||||
test("node dragging updates its position; undo and redo retain the current viewport", () => {
|
||||
let state = seeded();
|
||||
const id = state.present.nodes[0].id;
|
||||
@@ -23,6 +29,7 @@ test("node dragging updates its position; undo and redo retain the current viewp
|
||||
assert.deepEqual(state.present.nodes[0].position, { x: 220, y: -30 });
|
||||
});
|
||||
|
||||
// 删节点连同附边一起删除,随后重复边删除通知不应再追加历史;一次 undo 恢复节点与边。
|
||||
test("deleting a node removes attached edges and undo restores both", () => {
|
||||
const initial = seeded();
|
||||
const removed = canvasReducer(initial, { type: "nodes", changes: [{ id: initial.present.nodes[0].id, type: "remove" }] });
|
||||
@@ -35,6 +42,7 @@ test("deleting a node removes attached edges and undo restores both", () => {
|
||||
assert.equal(restored.present.edges.length, 1);
|
||||
});
|
||||
|
||||
// 同一 checkpoint 内多次文字修改只留一个 past,undo 回到开始编辑前文字。
|
||||
test("a text editing session is undoable as one operation", () => {
|
||||
let state = seeded();
|
||||
const id = state.present.nodes[0].id;
|
||||
@@ -45,6 +53,7 @@ test("a text editing session is undoable as one operation", () => {
|
||||
assert.equal(canvasReducer(state, { type: "undo" }).present.nodes[0].data.text, "");
|
||||
});
|
||||
|
||||
// JSON 往返保留文本、图片、连线与 viewport,selected 作为临时 UI 字段不恢复。
|
||||
test("export/import retains nodes, edges, text, images and the viewport", () => {
|
||||
const document = seeded().present;
|
||||
const image = makeCanvasNode("image", { x: 80, y: 90 }, "data:image/png;base64,YQ==");
|
||||
@@ -60,6 +69,7 @@ test("export/import retains nodes, edges, text, images and the viewport", () =>
|
||||
assert.deepEqual(restored.viewport, document.viewport);
|
||||
});
|
||||
|
||||
// 悬空端点、重复 ID、不安全图片 URL 和非法 zoom 分别构造非法输入,任一项都使整个 decode 失败。
|
||||
test("import rejects dangling connections, duplicate nodes, unsafe images and invalid zoom", () => {
|
||||
for (const mutate of [
|
||||
(doc) => { doc.edges[0].target = "missing"; },
|
||||
@@ -73,11 +83,13 @@ test("import rejects dangling connections, duplicate nodes, unsafe images and in
|
||||
}
|
||||
});
|
||||
|
||||
// 旧草稿 key 包含 workspace 与 board,不能因同名图谱跨作用域覆盖。
|
||||
test("draft storage is isolated by workspace and graph", () => {
|
||||
assert.notEqual(canvasStorageKey("workspace-a", "board"), canvasStorageKey("workspace-b", "board"));
|
||||
assert.notEqual(canvasStorageKey("workspace", "board-a"), canvasStorageKey("workspace", "board-b"));
|
||||
});
|
||||
|
||||
// 50 次 replace 后 past 受限为 40;undo 产生 redo,新 add 必须清空 redo。
|
||||
test("undo history is bounded and new edits clear the redo stack", () => {
|
||||
let state = seeded();
|
||||
for (let i = 0; i < 50; i++) state = canvasReducer(state, { type: "replace", document: { ...state.present, edges: [] } });
|
||||
@@ -89,6 +101,7 @@ test("undo history is bounded and new edits clear the redo stack", () => {
|
||||
});
|
||||
|
||||
|
||||
// 四方向分支检查相对位置、选中切换、source/target ID 和相反 handle;快照可恢复,整组可撤销。
|
||||
test("selected nodes can branch in all four directions with matching connection handles", () => {
|
||||
const opposite = { top: "bottom", right: "left", bottom: "top", left: "right" };
|
||||
for (const direction of Object.keys(opposite)) {
|
||||
@@ -114,6 +127,7 @@ test("selected nodes can branch in all four directions with matching connection
|
||||
}
|
||||
});
|
||||
|
||||
// 同侧重复添加要避开已有节点,第二个新节点不能占据第一次相同位置。
|
||||
test("repeated additions on the same side avoid existing nodes", () => {
|
||||
const document = emptyCanvas();
|
||||
const parent = makeCanvasNode("text", { x: 0, y: 0 });
|
||||
|
||||
Reference in New Issue
Block a user