@retikz/core 0.1.0-alpha.5 → 0.1.0-beta.1

package/dist/es/compile/path/label.js

@@ -0,0 +1,102 @@
+//#region src/compile/path/label.ts
+/** 边标注默认字号 / 偏移量 */
+var LABEL_FONT_SIZE = 14;
+var LABEL_LINE_HEIGHT_FACTOR = 1.2;
+var LABEL_SIDE_OFFSET = 4;
+var RAD_TO_DEG = 180 / Math.PI;
+/** keyword → t 数值映射；含旧 3 keyword（midway/near-start/near-end）+ 新 4 keyword */
+var KEYWORD_TO_T = {
+	"at-start": 0,
+	"very-near-start": .125,
+	"near-start": .25,
+	midway: .5,
+	"near-end": .75,
+	"very-near-end": .875,
+	"at-end": 1
+};
+/**
+* label.position → 段参数 t∈[0,1]
+* @description 数值原样返回（schema 已 clamp 0..1）；keyword 走 KEYWORD_TO_T 映射；undefined 退默认 midway (0.5)
+*/
+var tForLabelPosition = (pos) => {
+	if (typeof pos === "number") return pos;
+	if (typeof pos === "string" && pos in KEYWORD_TO_T) return KEYWORD_TO_T[pos];
+	return .5;
+};
+/**
+* step.label + 段采样 → TextPrim（sloped 时裹一层 group 旋转）
+* @description 默认 side='above'/position='midway'：above/below 锚点 y±offset、align=middle、baseline=bottom/top；left/right x±offset、align=end/start、baseline=middle；sloped 不偏移裹 group rotate(angle, cx, cy) 由切线 atan2 算（SVG y-down CW 正）。返回 primitive + viewBox 外接点
+*/
+var emitLabelPrimitive = (label, sample, measureText, round) => {
+	const fontSize = LABEL_FONT_SIZE;
+	const lineHeight = fontSize * LABEL_LINE_HEIGHT_FACTOR;
+	const m = measureText(label.text, { size: fontSize });
+	const measuredWidth = m.width;
+	const measuredHeight = m.height || lineHeight;
+	const side = label.side ?? "above";
+	let x = sample.point[0];
+	let y = sample.point[1];
+	let align = "middle";
+	let baseline = "middle";
+	if (side === "above") {
+		y -= LABEL_SIDE_OFFSET;
+		baseline = "bottom";
+	} else if (side === "below") {
+		y += LABEL_SIDE_OFFSET;
+		baseline = "top";
+	} else if (side === "left") {
+		x -= LABEL_SIDE_OFFSET;
+		align = "end";
+	} else if (side === "right") {
+		x += LABEL_SIDE_OFFSET;
+		align = "start";
+	} else baseline = "bottom";
+	const text = {
+		type: "text",
+		x: round(x),
+		y: round(y),
+		lines: [{ text: label.text }],
+		fontSize,
+		align,
+		baseline,
+		lineHeight: round(lineHeight),
+		measuredWidth: round(measuredWidth),
+		measuredHeight: round(measuredHeight),
+		fill: "currentColor"
+	};
+	if (side === "sloped") {
+		const groupPrim = {
+			type: "group",
+			transforms: [{
+				kind: "rotate",
+				degrees: round(Math.atan2(sample.tangent[1], sample.tangent[0]) * RAD_TO_DEG),
+				cx: round(x),
+				cy: round(y)
+			}],
+			children: [text]
+		};
+		const r = Math.max(measuredWidth / 2, measuredHeight / 2);
+		return {
+			primitive: groupPrim,
+			points: [
+				[x - r, y - r],
+				[x + r, y - r],
+				[x - r, y + r],
+				[x + r, y + r]
+			]
+		};
+	}
+	const halfW = measuredWidth / 2;
+	const halfH = measuredHeight / 2;
+	return {
+		primitive: text,
+		points: [
+			[x - halfW, y - halfH],
+			[x + halfW, y - halfH],
+			[x - halfW, y + halfH],
+			[x + halfW, y + halfH]
+		]
+	};
+};
+//#endregion
+export { emitLabelPrimitive, tForLabelPosition };

package/dist/es/compile/path/relative.d.ts

@@ -0,0 +1,8 @@
+import { IRStep } from '../../ir';
+import { NodeLayout } from '../node';
+/**
+ * relative/relativeAccumulate 目标解析为绝对 Position（step kind 不变，to 全为绝对坐标）
+ * @description relative 不更新 prevEnd（TikZ `+`），relativeAccumulate 更新（TikZ `++`）。prevEnd 推进：有 to 的 kind 用 refPointOfTarget(to)；arc 用 arcEndPoint；circlePath/ellipsePath/cycle 不变。首步 relative 时 prevEnd 回退 [0,0]；解析失败保持原 step
+ */
+export declare const normalizeRelativeTargets: (steps: ReadonlyArray<IRStep>, nodeIndex: Map<string, NodeLayout>) => Array<IRStep>;
+//# sourceMappingURL=relative.d.ts.map

package/dist/es/compile/path/relative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KACjC,KAAK,CAAC,MAAM,CA0Dd,CAAC"}

package/dist/es/compile/path/relative.js

@@ -0,0 +1,48 @@
+import { arcEndPoint } from "../../geometry/arc.js";
+import { refPointOfTarget } from "./anchor.js";
+//#region src/compile/path/relative.ts
+/**
+* relative/relativeAccumulate 目标解析为绝对 Position（step kind 不变，to 全为绝对坐标）
+* @description relative 不更新 prevEnd（TikZ `+`），relativeAccumulate 更新（TikZ `++`）。prevEnd 推进：有 to 的 kind 用 refPointOfTarget(to)；arc 用 arcEndPoint；circlePath/ellipsePath/cycle 不变。首步 relative 时 prevEnd 回退 [0,0]；解析失败保持原 step
+*/
+var normalizeRelativeTargets = (steps, nodeIndex) => {
+	let prevEnd = null;
+	const out = [];
+	for (const step of steps) {
+		if (step.kind === "cycle") {
+			out.push(step);
+			continue;
+		}
+		if (step.kind === "circlePath" || step.kind === "ellipsePath") {
+			out.push(step);
+			continue;
+		}
+		if (step.kind === "arc") {
+			out.push(step);
+			if (prevEnd) prevEnd = arcEndPoint(prevEnd, step.radius, step.endAngle);
+			continue;
+		}
+		const original = step.to;
+		let resolvedTo = original;
+		let updatePrevEnd = true;
+		if (typeof original === "object" && !Array.isArray(original) && "relative" in original) {
+			const ref = prevEnd ?? [0, 0];
+			resolvedTo = [ref[0] + original.relative[0], ref[1] + original.relative[1]];
+			updatePrevEnd = false;
+		} else if (typeof original === "object" && !Array.isArray(original) && "relativeAccumulate" in original) {
+			const ref = prevEnd ?? [0, 0];
+			resolvedTo = [ref[0] + original.relativeAccumulate[0], ref[1] + original.relativeAccumulate[1]];
+		}
+		out.push({
+			...step,
+			to: resolvedTo
+		});
+		if (updatePrevEnd) {
+			const pos = refPointOfTarget(resolvedTo, nodeIndex);
+			if (pos) prevEnd = pos;
+		}
+	}
+	return out;
+};
+//#endregion
+export { normalizeRelativeTargets };

package/dist/es/compile/path/shrink.d.ts

@@ -0,0 +1,24 @@
+import { IRArrowDetail } from '../../ir';
+import { ArrowEndSpec, PathCommand } from '../../primitive';
+/** IR path-level `arrow` + `arrowDetail` → PathPrim 起末视觉规格 */
+export declare const arrowMarkers: (arrow: "none" | "->" | "<-" | "<->" | undefined, detail: IRArrowDetail | undefined) => {
+    arrowStart?: ArrowEndSpec;
+    arrowEnd?: ArrowEndSpec;
+};
+/**
+ * 端点级 shrink（strokeWidth 倍）：line 末端朝起点缩这么多，让 marker apex 落回原 target
+ * @description 不分实心/空心：所有 shape 都让 line 端点接在箭头尾部、apex 顶端仍贴原 target。低 opacity 下不会再透出 line。viewBox=10，shrink = (apex.x - refX) × length × scale / 10（strokeWidth 倍）。
+ *
+ * 几何对齐（必须与 react/render/arrowMarkers.tsx 中 renderInner 的 refX 一致）：
+ * - `normal` / `diamond` / `circle`：apex 在 viewBox x=10、back 外缘 x=0 → refX=0，shrink = length × scale
+ * - `stealth`：apex x=10、V tip x=3（line 嵌进 V 凹口）→ refX=3，shrink = 0.7 × length × scale
+ * - `open` / `openDiamond`：apex x=9、back stroke 外缘 x = 1 - lineWidth/2 → refX = 1 - lineWidth/2，shrink = (8 + lineWidth/2) × length × scale / 10
+ * - `openCircle`：apex 外缘右 x ≈ 10、back 外缘左 x = 0.75 - lineWidth/2 → refX = 0.75 - lineWidth/2，shrink ≈ length × scale
+ */
+export declare const computeShrink: (spec: ArrowEndSpec) => number;
+/**
+ * 按 shape + spec（length / scale / lineWidth）把首/末段端点向内缩短
+ * @description 让 line 端点接在 hollow arrow 尾部外缘、不贯穿 back outline；shrink=0 的实心 shape 跳过。in-place 改写 commands 数组
+ */
+export declare const applyArrowShrinks: (commands: Array<PathCommand>, shrinkStart: number, shrinkEnd: number, strokeWidth: number, round: (n: number) => number) => void;
+//# sourceMappingURL=shrink.d.ts.map

package/dist/es/compile/path/shrink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrink.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/shrink.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkCjE,8DAA8D;AAC9D,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,EAC/C,QAAQ,aAAa,GAAG,SAAS,KAChC;IAAE,UAAU,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAatD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,KAAG,MAWlD,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,KAAK,CAAC,WAAW,CAAC,EAC5B,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,IA4CF,CAAC"}

package/dist/es/compile/path/shrink.js

@@ -0,0 +1,136 @@
+import { HOLLOW_ARROW_SHAPES } from "../../ir/path/arrow.js";
+import { shiftToward } from "./anchor.js";
+//#region src/compile/path/shrink.ts
+/**
+* 端点级 spec：顶层默认 ⊕ end-side override（逐字段 merge）
+* @description 缺省字段继承顶层（不是"完全替换"）；空心 shape 上 fill 字段被丢（silent no-op）
+*/
+var resolveArrowEndSpec = (topLevel, endSide) => {
+	const baseShape = endSide?.shape ?? topLevel.shape ?? "normal";
+	const out = { shape: baseShape };
+	const scale = endSide?.scale ?? topLevel.scale;
+	if (scale !== void 0) out.scale = scale;
+	const length = endSide?.length ?? topLevel.length;
+	if (length !== void 0) out.length = length;
+	const width = endSide?.width ?? topLevel.width;
+	if (width !== void 0) out.width = width;
+	const color = endSide?.color ?? topLevel.color;
+	if (color !== void 0) out.color = color;
+	const opacity = endSide?.opacity ?? topLevel.opacity;
+	if (opacity !== void 0) out.opacity = opacity;
+	const lineWidth = endSide?.lineWidth ?? topLevel.lineWidth;
+	if (lineWidth !== void 0) out.lineWidth = lineWidth;
+	if (!HOLLOW_ARROW_SHAPES.has(baseShape)) {
+		const fill = endSide?.fill ?? topLevel.fill;
+		if (fill !== void 0) out.fill = fill;
+	}
+	return out;
+};
+/** IR path-level `arrow` + `arrowDetail` → PathPrim 起末视觉规格 */
+var arrowMarkers = (arrow, detail) => {
+	if (!arrow || arrow === "none") return {};
+	const top = detail ?? {};
+	const startSpec = resolveArrowEndSpec(top, top.start);
+	const endSpec = resolveArrowEndSpec(top, top.end);
+	switch (arrow) {
+		case "->": return { arrowEnd: endSpec };
+		case "<-": return { arrowStart: startSpec };
+		case "<->": return {
+			arrowStart: startSpec,
+			arrowEnd: endSpec
+		};
+	}
+};
+/**
+* 端点级 shrink（strokeWidth 倍）：line 末端朝起点缩这么多，让 marker apex 落回原 target
+* @description 不分实心/空心：所有 shape 都让 line 端点接在箭头尾部、apex 顶端仍贴原 target。低 opacity 下不会再透出 line。viewBox=10，shrink = (apex.x - refX) × length × scale / 10（strokeWidth 倍）。
+*
+* 几何对齐（必须与 react/render/arrowMarkers.tsx 中 renderInner 的 refX 一致）：
+* - `normal` / `diamond` / `circle`：apex 在 viewBox x=10、back 外缘 x=0 → refX=0，shrink = length × scale
+* - `stealth`：apex x=10、V tip x=3（line 嵌进 V 凹口）→ refX=3，shrink = 0.7 × length × scale
+* - `open` / `openDiamond`：apex x=9、back stroke 外缘 x = 1 - lineWidth/2 → refX = 1 - lineWidth/2，shrink = (8 + lineWidth/2) × length × scale / 10
+* - `openCircle`：apex 外缘右 x ≈ 10、back 外缘左 x = 0.75 - lineWidth/2 → refX = 0.75 - lineWidth/2，shrink ≈ length × scale
+*/
+var computeShrink = (spec) => {
+	const length = (spec.length ?? 6) * (spec.scale ?? 1);
+	if (HOLLOW_ARROW_SHAPES.has(spec.shape)) {
+		if (spec.shape === "openCircle") return length;
+		return (8 + (spec.lineWidth ?? 1.5) / 2) * length / 10;
+	}
+	if (spec.shape === "stealth") return 7 * length / 10;
+	return length;
+};
+/** 取一个 PathCommand 末端 endpoint（move/line/quad/cubic → to；arc/ellipseArc → polar(end)；close 无端点） */
+var endpointOf = (cmd) => {
+	switch (cmd.kind) {
+		case "move":
+		case "line":
+		case "quad":
+		case "cubic": return [cmd.to[0], cmd.to[1]];
+		case "arc": {
+			const rad = cmd.endAngle * Math.PI / 180;
+			return [cmd.center[0] + Math.cos(rad) * cmd.radius, cmd.center[1] + Math.sin(rad) * cmd.radius];
+		}
+		case "ellipseArc": {
+			const rad = cmd.endAngle * Math.PI / 180;
+			return [cmd.center[0] + Math.cos(rad) * cmd.radiusX, cmd.center[1] + Math.sin(rad) * cmd.radiusY];
+		}
+		case "close": return null;
+	}
+};
+/** 改写一个 PathCommand 的 endpoint（用于 shrink） */
+var setEndpoint = (commands, idx, newPt, round) => {
+	const cmd = commands[idx];
+	if (cmd.kind === "close") return;
+	const rp = [round(newPt[0]), round(newPt[1])];
+	if (cmd.kind === "move" || cmd.kind === "line") commands[idx] = {
+		...cmd,
+		to: rp
+	};
+	else if (cmd.kind === "quad") commands[idx] = {
+		...cmd,
+		to: rp
+	};
+	else if (cmd.kind === "cubic") commands[idx] = {
+		...cmd,
+		to: rp
+	};
+};
+/**
+* 按 shape + spec（length / scale / lineWidth）把首/末段端点向内缩短
+* @description 让 line 端点接在 hollow arrow 尾部外缘、不贯穿 back outline；shrink=0 的实心 shape 跳过。in-place 改写 commands 数组
+*/
+var applyArrowShrinks = (commands, shrinkStart, shrinkEnd, strokeWidth, round) => {
+	if (shrinkStart > 0) {
+		const firstIdx = commands.findIndex((o) => o.kind === "move");
+		if (firstIdx >= 0) {
+			const cur = commands[firstIdx];
+			const nextIdx = commands.findIndex((o, idx) => idx > firstIdx && o.kind !== "close");
+			if (cur.kind === "move" && nextIdx >= 0) {
+				const nextPt = endpointOf(commands[nextIdx]);
+				if (nextPt) setEndpoint(commands, firstIdx, shiftToward([cur.to[0], cur.to[1]], nextPt, shrinkStart * strokeWidth), round);
+			}
+		}
+	}
+	if (shrinkEnd > 0) {
+		let lastIdx = -1;
+		for (let i = commands.length - 1; i >= 0; i--) if (commands[i].kind !== "close") {
+			lastIdx = i;
+			break;
+		}
+		if (lastIdx > 0) {
+			let prevIdx = lastIdx - 1;
+			while (prevIdx >= 0 && commands[prevIdx].kind === "close") prevIdx--;
+			if (prevIdx >= 0) {
+				const curPt = endpointOf(commands[lastIdx]);
+				const prevPt = endpointOf(commands[prevIdx]);
+				if (curPt && prevPt) {
+					const shifted = shiftToward(curPt, prevPt, shrinkEnd * strokeWidth);
+					setEndpoint(commands, lastIdx, shifted, round);
+				}
+			}
+		}
+	}
+};
+//#endregion
+export { applyArrowShrinks, arrowMarkers, computeShrink };

package/dist/es/compile/path/split.d.ts

@@ -0,0 +1,15 @@
+import { ArrowEndSpec, PathCommand, PathPrim, ScenePrimitive } from '../../primitive';
+/** baseProps：除 commands/markers 外 PathPrim 公共属性集合（多 sub-path 复用） */
+export type PathBaseProps = Omit<PathPrim, 'type' | 'commands' | 'arrowStart' | 'arrowEnd'>;
+/**
+ * 多 sub-path + 有箭头：按 sub-path split 成多个 PathPrim，仅首段挂 arrowStart / 末段挂 arrowEnd，包进 GroupPrim
+ * @description SVG marker 按每个 sub-path 单独贴会在中间节点视觉错乱，故仅首末段挂；单 sub-path 或无箭头直接产一个 PathPrim
+ */
+export declare const splitSubPathsForMarkers: (commands: Array<PathCommand>, baseProps: PathBaseProps, markers: {
+    arrowStart?: ArrowEndSpec;
+    arrowEnd?: ArrowEndSpec;
+}) => {
+    primitive: ScenePrimitive;
+    isGrouped: boolean;
+};
+//# sourceMappingURL=split.d.ts.map

package/dist/es/compile/path/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/split.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3F,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,KAAK,CAAC,WAAW,CAAC,EAC5B,WAAW,aAAa,EACxB,SAAS;IAAE,UAAU,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,KAC9D;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CA4CjD,CAAC"}

package/dist/es/compile/path/split.js

@@ -0,0 +1,46 @@
+//#region src/compile/path/split.ts
+/**
+* 多 sub-path + 有箭头：按 sub-path split 成多个 PathPrim，仅首段挂 arrowStart / 末段挂 arrowEnd，包进 GroupPrim
+* @description SVG marker 按每个 sub-path 单独贴会在中间节点视觉错乱，故仅首末段挂；单 sub-path 或无箭头直接产一个 PathPrim
+*/
+var splitSubPathsForMarkers = (commands, baseProps, markers) => {
+	const hasArrows = !!markers.arrowStart || !!markers.arrowEnd;
+	const subPathStarts = [];
+	commands.forEach((cmd, idx) => {
+		if (cmd.kind === "move") subPathStarts.push(idx);
+	});
+	if (!hasArrows || subPathStarts.length <= 1) return {
+		primitive: {
+			type: "path",
+			commands,
+			...baseProps,
+			...markers
+		},
+		isGrouped: false
+	};
+	const subPathSlices = [];
+	for (let s = 0; s < subPathStarts.length; s++) {
+		const start = subPathStarts[s];
+		const end = s + 1 < subPathStarts.length ? subPathStarts[s + 1] : commands.length;
+		subPathSlices.push(commands.slice(start, end));
+	}
+	return {
+		primitive: {
+			type: "group",
+			children: subPathSlices.map((sub, i) => {
+				const isFirst = i === 0;
+				const isLast = i === subPathSlices.length - 1;
+				return {
+					type: "path",
+					commands: sub,
+					...baseProps,
+					...isFirst && markers.arrowStart ? { arrowStart: markers.arrowStart } : {},
+					...isLast && markers.arrowEnd ? { arrowEnd: markers.arrowEnd } : {}
+				};
+			})
+		},
+		isGrouped: true
+	};
+};
+//#endregion
+export { splitSubPathsForMarkers };

package/dist/es/compile/text-metrics.d.ts

@@ -25,6 +25,9 @@ export type TextMetrics = {
  * @description @retikz/react: canvas measureText；@retikz/ssr: opentype.js/fontkit；@retikz/canvas: ctx.measureText
  */
 export type TextMeasurer = (text: string, font: FontSpec) => TextMetrics;
-/** 默认 fallback 度量：基于平均字宽估算，不准但保证可运行 */
+/**
+ * 默认 fallback 度量：基于平均字宽估算，不准但保证可运行
+ * @description size=0 → 退化返回 (0, 0)（与 text='' 一致）；负 size 或 NaN size → throw（非法输入早 fail，避免 NaN 噪音传播到 Scene）
+ */
 export declare const fallbackMeasurer: TextMeasurer;
 //# sourceMappingURL=text-metrics.d.ts.map

package/dist/es/compile/text-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../../src/compile/text-metrics.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAEzE,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,YAG7B,CAAC"}
+{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../../src/compile/text-metrics.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAU9B,CAAC"}

package/dist/es/compile/text-metrics.js

@@ -1,8 +1,14 @@
 //#region src/compile/text-metrics.ts
-/** 默认 fallback 度量：基于平均字宽估算，不准但保证可运行 */
-var fallbackMeasurer = (text, font) => ({
-	width: text.length * font.size * .55,
-	height: font.size * 1.2
-});
+/**
+* 默认 fallback 度量：基于平均字宽估算，不准但保证可运行
+* @description size=0 → 退化返回 (0, 0)（与 text='' 一致）；负 size 或 NaN size → throw（非法输入早 fail，避免 NaN 噪音传播到 Scene）
+*/
+var fallbackMeasurer = (text, font) => {
+	if (Number.isNaN(font.size) || font.size < 0) throw new Error(`fallbackMeasurer: invalid font.size '${font.size}'; must be a non-negative finite number`);
+	return {
+		width: text.length * font.size * .55,
+		height: font.size * 1.2
+	};
+};
 //#endregion
 export { fallbackMeasurer };

package/dist/es/geometry/_transform.d.ts

@@ -0,0 +1,21 @@
+import { Position } from './point';
+/** 任何"中心 + 可选旋转"形状的几何契约（rect / circle / ellipse / diamond 共用） */
+export type CenteredShape = {
+    /** 中心横坐标 */
+    x: number;
+    /** 中心纵坐标 */
+    y: number;
+    /** 绕中心旋转弧度（可选，0 / 缺省 = 不旋转） */
+    rotate?: number;
+};
+/**
+ * 本地坐标（以中心为原点）→ 世界坐标
+ * @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移
+ */
+export declare const localToWorld: (s: CenteredShape, local: Position) => Position;
+/**
+ * 世界坐标 → 本地坐标（`localToWorld` 逆变换）
+ * @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
+ */
+export declare const worldToLocal: (s: CenteredShape, world: Position) => Position;
+//# sourceMappingURL=_transform.d.ts.map

package/dist/es/geometry/_transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_transform.d.ts","sourceRoot":"","sources":["../../../src/geometry/_transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,OAAO,QAAQ,KAAG,QAShE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,OAAO,QAAQ,KAAG,QAQhE,CAAC"}

package/dist/es/geometry/_transform.js

@@ -0,0 +1,27 @@
+//#region src/geometry/_transform.ts
+/**
+* 本地坐标（以中心为原点）→ 世界坐标
+* @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移
+*/
+var localToWorld = (s, local) => {
+	const angle = s.rotate ?? 0;
+	if (angle === 0) return [s.x + local[0], s.y + local[1]];
+	const cos = Math.cos(angle);
+	const sin = Math.sin(angle);
+	return [s.x + local[0] * cos - local[1] * sin, s.y + local[0] * sin + local[1] * cos];
+};
+/**
+* 世界坐标 → 本地坐标（`localToWorld` 逆变换）
+* @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
+*/
+var worldToLocal = (s, world) => {
+	const tx = world[0] - s.x;
+	const ty = world[1] - s.y;
+	const angle = s.rotate ?? 0;
+	if (angle === 0) return [tx, ty];
+	const cos = Math.cos(angle);
+	const sin = Math.sin(angle);
+	return [tx * cos + ty * sin, -tx * sin + ty * cos];
+};
+//#endregion
+export { localToWorld, worldToLocal };

package/dist/es/geometry/bend.d.ts

@@ -1,7 +1,7 @@
 import { Position } from './point';
 /**
  * cubic Bezier 拟合 from→to 的弧形 bend
- * @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向 SVG y-down：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
+ * @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向（screen y-down）：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
  */
 export declare const bendControlPoints: (from: Position, to: Position, direction: "left" | "right", bendAngle: number) => [Position, Position];
 //# sourceMappingURL=bend.d.ts.map

package/dist/es/geometry/bend.js

@@ -1,7 +1,7 @@
 //#region src/geometry/bend.ts
 /**
 * cubic Bezier 拟合 from→to 的弧形 bend
-* @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向 SVG y-down：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
+* @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向（screen y-down）：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
 */
 var bendControlPoints = (from, to, direction, bendAngle) => {
 	const dx = to[0] - from[0];

package/dist/es/geometry/circle.d.ts

@@ -1,4 +1,5 @@
 import { Position } from './point';
+import { RectAnchor } from './rect';
 /** 圆形：几何中心 + 半径，预留旋转字段保持与 Rect 同形 API */
 export type Circle = {
     x: number;
@@ -8,8 +9,6 @@ export type Circle = {
     /** 绕中心旋转弧度（圆视觉不变，与 Rect 同形保留） */
     rotate?: number;
 };
-/** 圆形 9 个标准 anchor（与 RECT_ANCHORS 同名同义，圆周每 45° 等距分布） */
-export type CircleAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 圆形相关基础工具 */
 export declare const circle: {
     /** 圆心 */
@@ -17,7 +16,7 @@ export declare const circle: {
     /** 判断点是否在圆内（含边界） */
     contains: (c: Circle, p: Position) => boolean;
     /** 9 个标准 anchor 之一的世界坐标 */
-    anchor: (c: Circle, name: CircleAnchor) => Position;
+    anchor: (c: Circle, name: RectAnchor) => Position;
     /** 从圆心向 toward 方向射线与圆周交点（Path 端点贴 Node 边界用） */
     boundaryPoint: (c: Circle, toward: Position) => Position;
 };

package/dist/es/geometry/circle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../../src/geometry/circle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,wDAAwD;AACxD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,YAAY,KAAG,QAAQ;IAsCjD,+CAA+C;uBAC5B,MAAM,UAAU,QAAQ,KAAG,QAAQ;CAOvD,CAAC"}
+{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../../src/geometry/circle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,UAAU,KAAG,QAAQ;IAsC/C,+CAA+C;uBAC5B,MAAM,UAAU,QAAQ,KAAG,QAAQ;CAOvD,CAAC"}

package/dist/es/geometry/circle.js

@@ -1,21 +1,6 @@
+import { localToWorld, worldToLocal } from "./_transform.js";
 //#region src/geometry/circle.ts
 var SQRT_HALF = Math.SQRT1_2;
-var localToWorld = (c, local) => {
-	const angle = c.rotate ?? 0;
-	if (angle === 0) return [c.x + local[0], c.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [c.x + local[0] * cos - local[1] * sin, c.y + local[0] * sin + local[1] * cos];
-};
-var worldToLocal = (c, world) => {
-	const tx = world[0] - c.x;
-	const ty = world[1] - c.y;
-	const angle = c.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
 /** 圆形相关基础工具 */
 var circle = {
 	/** 圆心 */

package/dist/es/geometry/diamond.d.ts

@@ -1,4 +1,5 @@
 import { Position } from './point';
+import { RectAnchor } from './rect';
 /** 菱形：中心 + halfA/halfB 半轴长 + 可选旋转；顶点在 (±halfA,0) 与 (0,±halfB) */
 export type Diamond = {
     x: number;
@@ -10,8 +11,6 @@ export type Diamond = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 菱形 9 个标准 anchor（4 顶点 + 4 边中点 + 中心） */
-export type DiamondAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 菱形相关基础工具 */
 export declare const diamond: {
     /** 中心 */
@@ -19,7 +18,7 @@ export declare const diamond: {
     /** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
     contains: (d: Diamond, p: Position) => boolean;
     /** 9 个 anchor：N/S/E/W=顶点，NE/NW/SE/SW=边中点，center=中心 */
-    anchor: (d: Diamond, name: DiamondAnchor) => Position;
+    anchor: (d: Diamond, name: RectAnchor) => Position;
     /**
      * 从中心向 toward 方向射线与菱形 4 边的交点
      * @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)

package/dist/es/geometry/diamond.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C,sDAAsD;gBAC1C,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCrD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAOxD,CAAC"}
+{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C,sDAAsD;gBAC1C,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAOxD,CAAC"}

package/dist/es/geometry/diamond.js

@@ -1,20 +1,5 @@
+import { localToWorld, worldToLocal } from "./_transform.js";
 //#region src/geometry/diamond.ts
-var localToWorld = (d, local) => {
-	const angle = d.rotate ?? 0;
-	if (angle === 0) return [d.x + local[0], d.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [d.x + local[0] * cos - local[1] * sin, d.y + local[0] * sin + local[1] * cos];
-};
-var worldToLocal = (d, world) => {
-	const tx = world[0] - d.x;
-	const ty = world[1] - d.y;
-	const angle = d.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
 /** 菱形相关基础工具 */
 var diamond = {
 	/** 中心 */

package/dist/es/geometry/ellipse.d.ts

@@ -1,4 +1,5 @@
 import { Position } from './point';
+import { RectAnchor } from './rect';
 /** 椭圆：中心 + 半长轴 rx / 半短轴 ry + 可选旋转 */
 export type Ellipse = {
     x: number;
@@ -10,8 +11,6 @@ export type Ellipse = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 椭圆 9 个标准 anchor（与 RECT_ANCHORS 同名同义） */
-export type EllipseAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 椭圆相关基础工具 */
 export declare const ellipse: {
     /** 中心 */
@@ -22,7 +21,7 @@ export declare const ellipse: {
      * 9 个 anchor 的世界坐标
      * @description 对角（NE/NW/SE/SW）取参数曲线 t=π/4 处 (rx/√2, ry/√2)，与 TikZ 椭圆 anchor 参数等分约定一致
      */
-    anchor: (e: Ellipse, name: EllipseAnchor) => Position;
+    anchor: (e: Ellipse, name: RectAnchor) => Position;
     /**
      * 从中心向 toward 方向射线与椭圆交点
      * @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)