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

package/dist/lib/compile/path/shrink.cjs

@@ -0,0 +1,138 @@
+const require_arrow = require("../../ir/path/arrow.cjs");
+const require_anchor = require("./anchor.cjs");
+//#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 (!require_arrow.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 (require_arrow.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, require_anchor.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 = require_anchor.shiftToward(curPt, prevPt, shrinkEnd * strokeWidth);
+					setEndpoint(commands, lastIdx, shifted, round);
+				}
+			}
+		}
+	}
+};
+//#endregion
+exports.applyArrowShrinks = applyArrowShrinks;
+exports.arrowMarkers = arrowMarkers;
+exports.computeShrink = computeShrink;

package/dist/lib/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/lib/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/lib/compile/path/split.cjs

@@ -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
+exports.splitSubPathsForMarkers = splitSubPathsForMarkers;

package/dist/lib/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/lib/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/lib/compile/text-metrics.cjs

@@ -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
 exports.fallbackMeasurer = fallbackMeasurer;

package/dist/lib/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/lib/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/lib/geometry/_transform.cjs

@@ -0,0 +1,28 @@
+//#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
+exports.localToWorld = localToWorld;
+exports.worldToLocal = worldToLocal;

package/dist/lib/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/lib/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/lib/geometry/bend.cjs

@@ -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/lib/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/lib/geometry/circle.cjs

@@ -1,28 +1,13 @@
+const require__transform = require("./_transform.cjs");
 //#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 = {
 	/** 圆心 */
 	center: (c) => [c.x, c.y],
 	/** 判断点是否在圆内（含边界） */
 	contains: (c, p) => {
-		const [lx, ly] = worldToLocal(c, p);
+		const [lx, ly] = require__transform.worldToLocal(c, p);
 		return lx * lx + ly * ly <= c.radius * c.radius;
 	},
 	/** 9 个标准 anchor 之一的世界坐标 */
@@ -61,15 +46,15 @@ var circle = {
 				ly = r * SQRT_HALF;
 				break;
 		}
-		return localToWorld(c, [lx, ly]);
+		return require__transform.localToWorld(c, [lx, ly]);
 	},
 	/** 从圆心向 toward 方向射线与圆周交点（Path 端点贴 Node 边界用） */
 	boundaryPoint: (c, toward) => {
-		const [lx, ly] = worldToLocal(c, toward);
+		const [lx, ly] = require__transform.worldToLocal(c, toward);
 		const len = Math.sqrt(lx * lx + ly * ly);
 		if (len === 0) return [c.x, c.y];
 		const t = c.radius / len;
-		return localToWorld(c, [lx * t, ly * t]);
+		return require__transform.localToWorld(c, [lx * t, ly * t]);
 	}
 };
 //#endregion

package/dist/lib/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/lib/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/lib/geometry/diamond.cjs

@@ -1,27 +1,12 @@
+const require__transform = require("./_transform.cjs");
 //#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 = {
 	/** 中心 */
 	center: (d) => [d.x, d.y],
 	/** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
 	contains: (d, p) => {
-		const [lx, ly] = worldToLocal(d, p);
+		const [lx, ly] = require__transform.worldToLocal(d, p);
 		return Math.abs(lx) / d.halfA + Math.abs(ly) / d.halfB <= 1.000000001;
 	},
 	/** 9 个 anchor：N/S/E/W=顶点，NE/NW/SE/SW=边中点，center=中心 */
@@ -59,18 +44,18 @@ var diamond = {
 				ly = d.halfB / 2;
 				break;
 		}
-		return localToWorld(d, [lx, ly]);
+		return require__transform.localToWorld(d, [lx, ly]);
 	},
 	/**
 	* 从中心向 toward 方向射线与菱形 4 边的交点
 	* @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)
 	*/
 	boundaryPoint: (d, toward) => {
-		const [lx, ly] = worldToLocal(d, toward);
+		const [lx, ly] = require__transform.worldToLocal(d, toward);
 		const denom = Math.abs(lx) / d.halfA + Math.abs(ly) / d.halfB;
 		if (denom === 0) return [d.x, d.y];
 		const t = 1 / denom;
-		return localToWorld(d, [lx * t, ly * t]);
+		return require__transform.localToWorld(d, [lx * t, ly * t]);
 	}
 };
 //#endregion

package/dist/lib/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/lib/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/lib/geometry/ellipse.cjs

@@ -1,28 +1,13 @@
+const require__transform = require("./_transform.cjs");
 //#region src/geometry/ellipse.ts
 var SQRT_HALF = Math.SQRT1_2;
-var localToWorld = (e, local) => {
-	const angle = e.rotate ?? 0;
-	if (angle === 0) return [e.x + local[0], e.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [e.x + local[0] * cos - local[1] * sin, e.y + local[0] * sin + local[1] * cos];
-};
-var worldToLocal = (e, world) => {
-	const tx = world[0] - e.x;
-	const ty = world[1] - e.y;
-	const angle = e.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 ellipse = {
 	/** 中心 */
 	center: (e) => [e.x, e.y],
 	/** 判断点是否在椭圆内（含边界，考虑旋转） */
 	contains: (e, p) => {
-		const [lx, ly] = worldToLocal(e, p);
+		const [lx, ly] = require__transform.worldToLocal(e, p);
 		return lx * lx / (e.rx * e.rx) + ly * ly / (e.ry * e.ry) <= 1;
 	},
 	/**
@@ -63,19 +48,19 @@ var ellipse = {
 				ly = e.ry * SQRT_HALF;
 				break;
 		}
-		return localToWorld(e, [lx, ly]);
+		return require__transform.localToWorld(e, [lx, ly]);
 	},
 	/**
 	* 从中心向 toward 方向射线与椭圆交点
 	* @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)
 	*/
 	boundaryPoint: (e, toward) => {
-		const [lx, ly] = worldToLocal(e, toward);
+		const [lx, ly] = require__transform.worldToLocal(e, toward);
 		if (lx === 0 && ly === 0) return [e.x, e.y];
 		const a = lx / e.rx;
 		const b = ly / e.ry;
 		const t = 1 / Math.sqrt(a * a + b * b);
-		return localToWorld(e, [lx * t, ly * t]);
+		return require__transform.localToWorld(e, [lx * t, ly * t]);
 	}
 };
 //#endregion

package/dist/lib/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)²)

package/dist/lib/geometry/ellipse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,2CAA2C;AAC3C,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,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI9C;;;OAGG;gBACW,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCrD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI9C;;;OAGG;gBACW,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}

package/dist/lib/geometry/polar.cjs

@@ -1,7 +1,6 @@
 const require_point = require("./point.cjs");
 //#region src/geometry/polar.ts
 var DEG_TO_RAD = Math.PI / 180;
-var RAD_TO_DEG = 180 / Math.PI;
 /** 极坐标 ↔ 笛卡尔转换工具集（polar 不参与几何计算，参与时先 toPosition） */
 var polar = {
 	/**
@@ -17,11 +16,8 @@ var polar = {
 		const rad = p.angle * DEG_TO_RAD;
 		return [origin[0] + Math.cos(rad) * p.radius, origin[1] + Math.sin(rad) * p.radius];
 	},
-	/** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
-	fromPosition: (p) => ({
-		angle: Math.atan2(p[1], p[0]) * RAD_TO_DEG,
-		radius: Math.hypot(p[0], p[1])
-	}),
+	/** 笛卡尔 → 极坐标（point.toPolar 别名，angle ∈ (-180,180]，origin 默认 [0,0]） */
+	fromPosition: (p) => require_point.point.toPolar(p),
 	/** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
 	offsetFrom: (origin, offset) => {
 		const rad = offset.angle * DEG_TO_RAD;

package/dist/lib/geometry/polar.d.ts

@@ -6,7 +6,7 @@ import { Position } from './point';
 export type PolarPosition = {
     /** 极坐标原点：节点 id / 笛卡尔 / 嵌套极坐标；省略表示 [0,0] */
     origin?: string | Position | PolarPosition;
-    /** 角度（度数，逆时针为正） */
+    /** 角度（度数）：从 +x 轴量起，90° 朝 +y（屏幕下方），与 ArcStep / Node label 角度约定一致 */
     angle: number;
     /** 半径（非负） */
     radius: number;
@@ -18,7 +18,7 @@ export declare const polar: {
      * @description origin 为字符串（节点 id）时抛错——字符串解析依赖 Scene 编译器 nodeIndex
      */
     toPosition: (p: PolarPosition) => Position;
-    /** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
+    /** 笛卡尔 → 极坐标（point.toPolar 别名，angle ∈ (-180,180]，origin 默认 [0,0]） */
     fromPosition: (p: Position) => PolarPosition;
     /** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
     offsetFrom: (origin: Position, offset: {