docs(tests): explain legacy canvas and workspace unit coverage
This commit is contained in:
@@ -1,12 +1,19 @@
|
||||
/**
|
||||
* 旧 CanvasElement 几何与能力测试,直接验证类、纯函数和旧 reducer;不分派真实 pointer 事件。
|
||||
* 多方向/旋转样本用对边锚点及连接端点作为几何不变量,避免只比较宽高变化。
|
||||
*/
|
||||
import { test } from "node:test";
|
||||
import assert from "node:assert/strict";
|
||||
import { CanvasElement, CardElement, TextCardElement, ImageCardElement, ScriptCardElement, PlainTextElement, elementCapabilities } from "../src/lib/canvas-elements.ts";
|
||||
import { nodeConnector, connectorBezier, nodeCenter, nodeSize, resizeFromPointer, rotateVector, rotationFromPointer } from "../src/lib/canvas-geometry.ts";
|
||||
import { branchCanvasNode, canvasReducer, decodeCanvas, emptyCanvas } from "../src/lib/canvas.ts";
|
||||
|
||||
// 浮点误差容差为 1e-5,失败消息保留 actual/expected,供旋转与坐标换算诊断。
|
||||
function close(actual, expected) { assert(Math.abs(actual - expected) < 0.00001, `${actual} != ${expected}`); }
|
||||
// 将几何 patch 与旧 node.data 中的 rotation/fontSize 合并,重算中心和端点时使用同一模型形状。
|
||||
function transformed(node, patch) { return { ...node, ...patch, data: { ...node.data, rotation: patch.rotation ?? node.data.rotation, fontSize: patch.fontSize ?? node.data.fontSize } }; }
|
||||
|
||||
// 三种卡片共享变换和 branching;PlainText 只继承公共变换,不能通过错误 ID 或自身 ID 绕过不连线/不分支能力。
|
||||
test("card types inherit common element transforms and add branching; plain text inherits only common transforms", () => {
|
||||
for (const Type of [TextCardElement, ImageCardElement, ScriptCardElement]) {
|
||||
const element = new Type({ x: 0, y: 0 });
|
||||
@@ -27,12 +34,14 @@ test("card types inherit common element transforms and add branching; plain text
|
||||
assert.throws(() => branchCanvasNode({ ...emptyCanvas(), nodes: [node] }, node.id, "right"), /纯文本/);
|
||||
});
|
||||
|
||||
// 五种旋转角度乘八方向 handle,检查受影响尺寸和相反局部锚点世界坐标保持不变。
|
||||
test("all eight handles resize cards while retaining the opposite local anchor, including rotated cards", () => {
|
||||
const directions = ["top", "right", "bottom", "left", "top-left", "top-right", "bottom-left", "bottom-right"];
|
||||
for (const rotation of [0, 37, 90, 180, 270]) {
|
||||
for (const direction of directions) {
|
||||
const node = new TextCardElement({ x: 100, y: 200 }).toNode();
|
||||
node.data.rotation = rotation;
|
||||
// hx/hy 表示当前 handle 的局部符号;位移先旋转到世界,再比较缩放前后相反侧锚点的世界位置。
|
||||
const hx = direction.includes("left") ? -1 : direction.includes("right") ? 1 : 0;
|
||||
const hy = direction.includes("top") ? -1 : direction.includes("bottom") ? 1 : 0;
|
||||
const delta = rotateVector({ x: hx * 60, y: hy * 40 }, rotation);
|
||||
@@ -49,6 +58,7 @@ test("all eight handles resize cards while retaining the opposite local anchor,
|
||||
}
|
||||
});
|
||||
|
||||
// 纯文本宽高独立改变,最小值受限但不改变字号;仅拉宽或拉高不应连带另一维度。
|
||||
test("plain text width and height resize independently without changing the font", () => {
|
||||
const node = new PlainTextElement({ x: 0, y: 0 }).toNode();
|
||||
const patch = resizeFromPointer(node, "bottom-right", { x: 240, y: 72 });
|
||||
@@ -61,6 +71,7 @@ test("plain text width and height resize independently without changing the font
|
||||
assert(min.width >= 60); assert(min.height >= 24); assert.equal(min.fontSize, undefined);
|
||||
});
|
||||
|
||||
// 旋转跟随指针绕中心方向,Shift 风格吸附到 15 度,负方向归一为 0..360 范围。
|
||||
test("rotation follows the pointer, supports 15-degree snapping and normalizes the angle", () => {
|
||||
const node = new TextCardElement({ x: 0, y: 0 }).toNode();
|
||||
const center = nodeCenter(node);
|
||||
@@ -71,6 +82,7 @@ test("rotation follows the pointer, supports 15-degree snapping and normalizes t
|
||||
close(rotationFromPointer(node, start, { x: center.x, y: center.y - 100 }), 270);
|
||||
});
|
||||
|
||||
// checkpoint 内变换可保存恢复并一次 undo;纯文本 type、宽高、旋转和原字号各自保持正确。
|
||||
test("geometry and plain-text type survive save/restore and transforms undo as one gesture", () => {
|
||||
const node = new PlainTextElement({ x: 20, y: 30 }).toNode();
|
||||
let state = { past: [], present: { ...emptyCanvas(), nodes: [node] }, future: [] };
|
||||
@@ -84,6 +96,7 @@ test("geometry and plain-text type survive save/restore and transforms undo as o
|
||||
close(undo.present.nodes[0].data.rotation, 0);
|
||||
});
|
||||
|
||||
// 旧 material/text 草稿仍解码成卡片且补默认 rotation;负尺寸、超界角度及超大字号逐项拒绝。
|
||||
test("old text-card drafts remain cards and invalid transform values are rejected", () => {
|
||||
const old = { id: "old", type: "material", position: { x: 0, y: 0 }, data: { kind: "text", title: "Old", text: "Keep" } };
|
||||
const document = { ...emptyCanvas(), nodes: [old] };
|
||||
@@ -94,6 +107,7 @@ test("old text-card drafts remain cards and invalid transform values are rejecte
|
||||
}
|
||||
});
|
||||
|
||||
// 对 0/90/180 度检查四个边中心和单位法线,再验证缩放后的实际 right/bottom 锚点。
|
||||
test("connection endpoints stay on the exact border centers after resize and rotation", () => {
|
||||
const node = new TextCardElement({ x: 20, y: 30 }).toNode();
|
||||
const expected = {
|
||||
@@ -115,6 +129,7 @@ test("connection endpoints stay on the exact border centers after resize and rot
|
||||
assert.deepEqual(nodeConnector(resized, "bottom").point, { x: 200, y: 280 });
|
||||
});
|
||||
|
||||
// Bezier 字符串必须从精确 source anchor 开始到 target anchor 结束;selected 仅改变 UI,不改变几何路径。
|
||||
test("Bezier paths include both exact card anchors, independent of selected handle sizes", () => {
|
||||
const source = new TextCardElement({ x: 20, y: 30 }).toNode();
|
||||
const target = new TextCardElement({ x: 500, y: 180 }).toNode();
|
||||
|
||||
Reference in New Issue
Block a user