@retikz/core 0.3.0-alpha.5 → 0.3.0-beta.2

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

@@ -2,25 +2,35 @@ import { JsonObjectSchema } from "../../ir/json.js";
 import { rectOutline } from "../../geometry/rect.js";
 import { arcBoundingPoints, arcEndPoint, ellipseArcBoundingPoints, ellipseArcPoint } from "../../geometry/arc.js";
 import { BUILTIN_ARROWS } from "../../arrows/index.js";
+import { CompileWarningCode } from "../constant.js";
 import { applyTransformChain } from "../scope.js";
 import { bendControlPoints, outInControlPoints } from "../../geometry/bend.js";
-import { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseArcSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample } from "../../geometry/segment.js";
+import { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseArcSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample, rectPerimeterSample } from "../../geometry/segment.js";
 import { fallbackMeasurer } from "../text-metrics.js";
-import { clipForTarget, cornerOf, refPointOfTarget, samePoint } from "./anchor.js";
+import { clipForTarget, cornerOf, isAutoBoundaryTarget, refPointOfTarget, samePoint } from "./anchor.js";
 import { emitLabelPrimitive, tForLabelPosition } from "./label.js";
 import { normalizeRelativeTargets } from "./relative.js";
 import { applyArrowShrinks, endpointArrows, resolveMarkArrowSpec } from "./shrink.js";
 import { splitSubPathsForEndpointArrows } from "./split.js";
 //#region src/compile/path/index.ts
 /**
+* referent（offset.of / polar.origin 的并集形态：节点 id 字符串 / `[x, y]` 字面量 / 嵌套 PolarPosition）里挖节点 id
+* @description 裸字符串即节点 id（offset.of / polar.origin 的 string 分支语义）；其余交回 nodeRefId 递归。
+*/
+var referentNodeId = (ref) => typeof ref === "string" ? ref : nodeRefId(ref);
+/**
 * 目标里的一个代表性节点 id——给 UNRESOLVED_NODE_REFERENCE 诊断用
 * @description 对象 NodeTarget（`{ id, ... }`）直接取 id；between 比例点递归挖端点里第一个节点引用
-*   （端点未解析时整 between 失败，需照样报 unresolved 而非静默）；其余形态返回 undefined。
+*   （端点未解析时整 between 失败，需照样报 unresolved 而非静默）；OffsetPosition（`{ of }`）/ PolarPosition
+*   （`{ origin }`）递归挖其 referent——否则引用未定义节点时 refPoint 为 null 但 toId 为 undefined，整条 path
+*   会被静默丢弃（零诊断）；直接坐标 / 极坐标无 origin 等形态返回 undefined。
 */
 var nodeRefId = (t) => {
 	if (typeof t !== "object" || Array.isArray(t)) return void 0;
 	if ("id" in t) return t.id;
 	if ("between" in t) return nodeRefId(t.between[0]) ?? nodeRefId(t.between[1]);
+	if ("of" in t) return referentNodeId(t.of);
+	if ("origin" in t) return referentNodeId(t.origin);
 };
 /** 有限数 */
 var isFiniteNum = (n) => typeof n === "number" && Number.isFinite(n);
@@ -65,7 +75,7 @@ var assertValidGeneratedCommand = (name, cmd) => {
 /**
 * 语义 stroke 档位 → 数值（user units）
 * @description 对齐 TikZ 比例（thin=0.4pt→1=默认 strokeWidth）：ultraThin 0.25、veryThin 0.5、thin 1、semithick 1.5、thick 2、veryThick 3、ultraThick 4。显式 strokeWidth 覆盖 thickness。
-* `as const satisfies` + `AssertEqual` 双约束：加 IRPath['thickness'] 档位时漏写 TS 报错（字段表互锁，同 ADR-06 主题）
+* `as const satisfies` + `AssertEqual` 双约束：加 IRPath['thickness'] 档位时漏写 TS 报错（字段表互锁）
 */
 var THICKNESS_TO_WIDTH = {
 	ultraThin: .25,
@@ -129,13 +139,32 @@ var buildPathTransforms = (rotate, scale, center, round) => {
 * 把已物化的 arrow marker（局部 baseSize 坐标系，尖端 +x）按路径切线定向放到采样点
 * @description marker 局部系：viewBox `0 0 baseSize baseSize`，参考点 (refX, baseSize/2)，尖端朝 +x。
 *   GroupPrim transforms 数组语义 array[0] 最外层（最后 apply），故链 = translate(point) ∘ rotate(tangentDeg)
-*   ∘ scale(markerWidth/baseSize, markerHeight/baseSize) ∘ translate(-refX, -baseSize/2)：先把参考点移到原点、
-*   缩放到目标尺寸、绕切线角旋转、平移到采样点。marker 几何（`MarkerPrimitive[]`）是 ScenePrimitive 的结构子集，直接作 children。
+*   ∘ scale(markerWidth·strokeWidth/baseSize, markerHeight·strokeWidth/baseSize) ∘ translate(-refX, -baseSize/2)：
+*   先把参考点移到原点、缩放到目标尺寸、绕切线角旋转、平移到采样点。缩放含 strokeWidth 因子，与端点箭头
+*   （SVG markerUnits=strokeWidth / Canvas 同口径 ×strokeWidth）一致——中段 mark 随线宽缩放（TikZ 语义）。
+*
+*   marker 几何拍平进 Scene 作 children：marker 窄子集结构上是 ScenePrimitive 子集，唯一差异是 fill/stroke 可为
+*   `{ kind: 'contextStroke' }`。端点箭头物化成真正的 `<marker>` 时 contextStroke 由 renderer 继承引用方描边；
+*   但中段 mark 是独立 Scene group，已无引用上下文可继承，故在此把 contextStroke 解析成 path 的实际描边色
+*   （contextStroke 字符串单位 = path 的已解析 stroke）。
 */
-var buildMarkMarkerGroup = (spec, sample, round) => {
+var resolveMarkerContextFill = (value, contextStroke) => typeof value === "string" ? value : contextStroke;
+/** marker 图元 → Scene 图元：结构同构，仅把 fill/stroke 的 contextStroke 解析成具体描边色（递归 group） */
+var markerPrimToScene = (prim, contextStroke) => {
+	if (prim.type === "group") return {
+		...prim,
+		children: prim.children.map((c) => markerPrimToScene(c, contextStroke))
+	};
+	return {
+		...prim,
+		...prim.fill !== void 0 && { fill: resolveMarkerContextFill(prim.fill, contextStroke) },
+		...prim.stroke !== void 0 && { stroke: resolveMarkerContextFill(prim.stroke, contextStroke) }
+	};
+};
+var buildMarkMarkerGroup = (spec, sample, strokeWidth, round, contextStroke) => {
 	const angleDeg = Math.atan2(sample.tangent[1], sample.tangent[0]) * 180 / Math.PI;
-	const sx = spec.markerWidth / spec.baseSize;
-	const sy = spec.markerHeight / spec.baseSize;
+	const sx = spec.markerWidth * strokeWidth / spec.baseSize;
+	const sy = spec.markerHeight * strokeWidth / spec.baseSize;
 	const refY = spec.baseSize / 2;
 	return {
 		type: "group",
@@ -160,7 +189,7 @@ var buildMarkMarkerGroup = (spec, sample, round) => {
 				y: round(-refY)
 			}
 		],
-		children: [...spec.marker]
+		children: spec.marker.map((p) => markerPrimToScene(p, contextStroke))
 	};
 };
 /**
@@ -181,7 +210,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 	const steps = normalizeRelativeTargets(path.children, nameStack, scopeChain);
 	const soloSelfContained = steps.length === 1 && steps[0].kind === "rectangle";
 	if (steps.length < 2 && !soloSelfContained) {
-		warn("PATH_TOO_SHORT", `Path requires at least 2 steps (got ${steps.length}); the entire path is skipped`, "children");
+		warn(CompileWarningCode.PathTooShort, `Path requires at least 2 steps (got ${steps.length}); the entire path is skipped`, "children");
 		return null;
 	}
 	/** 每段 step.label 翻译出的 TextPrim（或 sloped 旋转的 group），与 path 主体同级返回 */
@@ -206,7 +235,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		if (!hasTo(s)) return null;
 		const ref = refPointOfTarget(s.to, nameStack, scopeChain);
 		const toId = nodeRefId(s.to);
-		if (!ref && toId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Step.to references undefined node id '${toId}'; the entire path is skipped`, `children[${idx}].to`);
+		if (!ref && toId !== void 0) warn(CompileWarningCode.UnresolvedNodeReference, `Step.to references undefined node id '${toId}'; the entire path is skipped`, `children[${idx}].to`);
 		return ref;
 	});
 	/**
@@ -244,7 +273,16 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 	*/
 	const readCursor = () => lastEnd;
 	const roundPoint = (p) => [round(p[0]), round(p[1])];
-	const emitMove = (p) => {
+	const endpointSource = {
+		firstAutoBoundary: false,
+		lastAutoBoundary: false
+	};
+	const noteEndpointSource = (sourceAutoBoundary) => {
+		if (commands.length === 0) endpointSource.firstAutoBoundary = sourceAutoBoundary;
+		endpointSource.lastAutoBoundary = sourceAutoBoundary;
+	};
+	const emitMove = (p, sourceAutoBoundary = false) => {
+		noteEndpointSource(sourceAutoBoundary);
 		const rp = roundPoint(p);
 		commands.push({
 			kind: "move",
@@ -254,7 +292,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		subPathStart = p;
 		lastEnd = p;
 	};
-	const emitLine = (p) => {
+	const emitLine = (p, sourceAutoBoundary = false) => {
+		noteEndpointSource(sourceAutoBoundary);
 		const rp = roundPoint(p);
 		commands.push({
 			kind: "line",
@@ -267,7 +306,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		commands.push({ kind: "close" });
 		lastEnd = subPathStart;
 	};
-	const emitQuad = (control, p) => {
+	const emitQuad = (control, p, sourceAutoBoundary = false) => {
+		noteEndpointSource(sourceAutoBoundary);
 		const rc = roundPoint(control);
 		const rp = roundPoint(p);
 		commands.push({
@@ -279,7 +319,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		points.push(p);
 		lastEnd = p;
 	};
-	const emitCubic = (c1, c2, p) => {
+	const emitCubic = (c1, c2, p, sourceAutoBoundary = false) => {
+		noteEndpointSource(sourceAutoBoundary);
 		const rc1 = roundPoint(c1);
 		const rc2 = roundPoint(c2);
 		const rp = roundPoint(p);
@@ -295,6 +336,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		lastEnd = p;
 	};
 	const emitArc = (center, radius, startAngle, endAngle) => {
+		noteEndpointSource(false);
 		const rc = roundPoint(center);
 		commands.push({
 			kind: "arc",
@@ -307,6 +349,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		lastEnd = arcEndPoint(center, radius, endAngle);
 	};
 	const emitEllipseArc = (center, radiusX, radiusY, startAngle, endAngle) => {
+		noteEndpointSource(false);
 		const rc = roundPoint(center);
 		commands.push({
 			kind: "ellipseArc",
@@ -321,15 +364,15 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		lastEnd = endPt;
 	};
 	/** 段起点：与 lastEnd 相同则复用 cursor（省 move），否则发 move */
-	const startSegment = (p) => {
+	const startSegment = (p, sourceAutoBoundary = false) => {
 		if (samePoint(p, lastEnd)) return;
-		emitMove(p);
+		emitMove(p, sourceAutoBoundary);
 	};
 	/** 部分圆/椭圆的闭合模式：'open' 直接返回；'sector' 连回中心；缺省 / 误给 'closed' 回退 'chord' */
 	const resolvePartialClosed = (closed, idx) => {
 		if (closed === "open") return "open";
 		if (closed === "sector") return "sector";
-		if (closed === "closed") warn("PARTIAL_ARC_CLOSED_INVALID", "Partial circle/ellipse (with angles) cannot use closed:'closed'; falling back to 'chord'", `children[${idx}]`);
+		if (closed === "closed") warn(CompileWarningCode.PartialArcClosedInvalid, "Partial circle/ellipse (with angles) cannot use closed:'closed'; falling back to 'chord'", `children[${idx}]`);
 		return "chord";
 	};
 	for (let i = 0; i < steps.length; i++) {
@@ -339,7 +382,10 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			if (prevStep.kind === "move") lastMoveTo = prevStep.to;
 		}
 		const step = steps[i];
-		if (step.kind === "move") continue;
+		if (step.kind === "move") {
+			penOverride = null;
+			continue;
+		}
 		if (step.kind === "generator") {
 			const generators = warnHook.effectivePathGenerators ?? {};
 			const def = Object.prototype.hasOwnProperty.call(generators, step.name) ? generators[step.name] : void 0;
@@ -407,20 +453,23 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			continue;
 		}
 		if (step.kind === "cycle") {
+			const usedOverride = penOverride;
+			penOverride = null;
 			const moveTo = lastMoveTo;
 			const prev = findPrev();
-			if (!moveTo || !prev) continue;
+			if (!moveTo || !prev && !usedOverride) continue;
 			const moveAnchor = refPointOfTarget(moveTo, nameStack, scopeChain);
 			if (!moveAnchor) return null;
-			const fromClip = clipForTarget(prev.step.to, moveAnchor, nameStack, scopeChain);
-			const toClip = clipForTarget(moveTo, prev.anchor, nameStack, scopeChain);
+			const fromClip = usedOverride ?? (prev ? clipForTarget(prev.step.to, moveAnchor, nameStack, scopeChain) : null);
+			const toClip = clipForTarget(moveTo, fromClip ?? prev?.anchor ?? moveAnchor, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
+			segmentSamplers.push((t) => lineSegmentSample(fromClip, toClip, t));
 			if (samePoint(fromClip, lastEnd) && samePoint(toClip, subPathStart)) {
 				emitClose();
 				continue;
 			}
-			startSegment(fromClip);
-			emitLine(toClip);
+			startSegment(fromClip, usedOverride === null && prev !== null && isAutoBoundaryTarget(prev.step.to));
+			emitLine(toClip, isAutoBoundaryTarget(moveTo));
 			continue;
 		}
 		if (step.kind === "rectangle") {
@@ -429,8 +478,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			if (!fromPt || !toPt) {
 				const fromId = nodeRefId(step.from);
 				const rectToId = nodeRefId(step.to);
-				if (!fromPt && fromId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Rectangle from references undefined node id '${fromId}'; the entire path is skipped`, `children[${i}].from`);
-				if (!toPt && rectToId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Rectangle to references undefined node id '${rectToId}'; the entire path is skipped`, `children[${i}].to`);
+				if (!fromPt && fromId !== void 0) warn(CompileWarningCode.UnresolvedNodeReference, `Rectangle from references undefined node id '${fromId}'; the entire path is skipped`, `children[${i}].from`);
+				if (!toPt && rectToId !== void 0) warn(CompileWarningCode.UnresolvedNodeReference, `Rectangle to references undefined node id '${rectToId}'; the entire path is skipped`, `children[${i}].to`);
 				return null;
 			}
 			let rectStart = null;
@@ -445,18 +494,22 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const ry0 = Math.min(fromPt[1], toPt[1]);
 			const ry1 = Math.max(fromPt[1], toPt[1]);
 			points.push([rx0, ry0], [rx1, ry0], [rx1, ry1], [rx0, ry1]);
+			segmentSamplers.push((t) => rectPerimeterSample(fromPt, toPt, t));
 			if (rectStart) penOverride = rectStart;
 			continue;
 		}
 		const prev = findPrev();
-		if (!prev) return null;
+		if (!prev) {
+			warn(CompileWarningCode.PathTooShort, `Step '${step.kind}' requires a previous position; the entire path is skipped`, `children[${i}]`);
+			return null;
+		}
 		if (step.kind === "arc") {
 			let center;
 			if (step.center !== void 0) {
 				const c = refPointOfTarget(step.center, nameStack, scopeChain);
 				if (!c) {
 					const centerId = nodeRefId(step.center);
-					if (centerId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Arc step center references undefined node id '${centerId}'; the entire path is skipped`, `children[${i}].center`);
+					if (centerId !== void 0) warn(CompileWarningCode.UnresolvedNodeReference, `Arc step center references undefined node id '${centerId}'; the entire path is skipped`, `children[${i}].center`);
 					return null;
 				}
 				center = c;
@@ -480,7 +533,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 				penOverride = arcEndPoint(center, r, step.endAngle);
 				continue;
 			}
-			warn("ARC_MISSING_RADIUS", "Arc step requires radius (circular) or both radiusX and radiusY (elliptical); the entire path is skipped", `children[${i}]`);
+			warn(CompileWarningCode.ArcMissingRadius, "Arc step requires radius (circular) or both radiusX and radiusY (elliptical); the entire path is skipped", `children[${i}]`);
 			return null;
 		}
 		if (step.kind === "circlePath") {
@@ -504,7 +557,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 				} else penOverride = ellipseArcPoint(center, r, r, endA);
 				continue;
 			}
-			if (step.startAngle !== void 0 || step.endAngle !== void 0) warn("PARTIAL_ARC_NEEDS_BOTH_ANGLES", "circlePath needs both startAngle and endAngle for a partial circle; treated as a full circle", `children[${i}]`);
+			if (step.startAngle !== void 0 || step.endAngle !== void 0) warn(CompileWarningCode.PartialArcNeedsBothAngles, "circlePath needs both startAngle and endAngle for a partial circle; treated as a full circle", `children[${i}]`);
 			startSegment([center[0] + r, center[1]]);
 			emitEllipseArc(center, r, r, 0, 360);
 			points.push([center[0] + r, center[1]]);
@@ -537,7 +590,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 				} else penOverride = ellipseArcPoint(center, rx, ry, endA);
 				continue;
 			}
-			if (step.startAngle !== void 0 || step.endAngle !== void 0) warn("PARTIAL_ARC_NEEDS_BOTH_ANGLES", "ellipsePath needs both startAngle and endAngle for a partial ellipse; treated as a full ellipse", `children[${i}]`);
+			if (step.startAngle !== void 0 || step.endAngle !== void 0) warn(CompileWarningCode.PartialArcNeedsBothAngles, "ellipsePath needs both startAngle and endAngle for a partial ellipse; treated as a full ellipse", `children[${i}]`);
 			startSegment([center[0] + rx, center[1]]);
 			emitEllipseArc(center, rx, ry, 0, 360);
 			points.push([center[0] + rx, center[1]]);
@@ -556,8 +609,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const fromClip = usedOverride ?? clipForTarget(prev.step.to, currAnchor, nameStack, scopeChain);
 			const toClip = clipForTarget(step.to, prev.anchor, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitLine(toClip);
+			startSegment(fromClip, usedOverride === null && isAutoBoundaryTarget(prev.step.to));
+			emitLine(toClip, isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => lineSegmentSample(fromClip, toClip, t));
 			continue;
 		}
@@ -565,8 +618,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const fromClip = usedOverride ?? clipForTarget(prev.step.to, step.control, nameStack, scopeChain);
 			const toClip = clipForTarget(step.to, step.control, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitQuad(step.control, toClip);
+			startSegment(fromClip, usedOverride === null && isAutoBoundaryTarget(prev.step.to));
+			emitQuad(step.control, toClip, isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => quadSegmentSample(fromClip, step.control, toClip, t));
 			continue;
 		}
@@ -574,8 +627,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const fromClip = usedOverride ?? clipForTarget(prev.step.to, step.control1, nameStack, scopeChain);
 			const toClip = clipForTarget(step.to, step.control2, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitCubic(step.control1, step.control2, toClip);
+			startSegment(fromClip, usedOverride === null && isAutoBoundaryTarget(prev.step.to));
+			emitCubic(step.control1, step.control2, toClip, isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => cubicSegmentSample(fromClip, step.control1, step.control2, toClip, t));
 			continue;
 		}
@@ -585,8 +638,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const fromClip = usedOverride ?? clipForTarget(prev.step.to, c1, nameStack, scopeChain);
 			const toClip = clipForTarget(step.to, c2, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitCubic(c1, c2, toClip);
+			startSegment(fromClip, usedOverride === null && isAutoBoundaryTarget(prev.step.to));
+			emitCubic(c1, c2, toClip, isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => cubicSegmentSample(fromClip, c1, c2, toClip, t));
 			continue;
 		}
@@ -594,9 +647,9 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		const fromClip = usedOverride ?? clipForTarget(prev.step.to, corner, nameStack, scopeChain);
 		const toClip = clipForTarget(step.to, corner, nameStack, scopeChain);
 		if (!fromClip || !toClip) return null;
-		startSegment(fromClip);
+		startSegment(fromClip, usedOverride === null && isAutoBoundaryTarget(prev.step.to));
 		emitLine(corner);
-		emitLine(toClip);
+		emitLine(toClip, isAutoBoundaryTarget(step.to));
 		collectLabel(step, (t) => foldSegmentSample(fromClip, corner, toClip, t));
 	}
 	const strokeWidth = path.strokeWidth ?? (path.thickness ? THICKNESS_TO_WIDTH[path.thickness] : 1);
@@ -623,11 +676,11 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const localT = scaled - segIdx;
 			const sample = segmentSamplers[segIdx](pos === 1 ? 1 : localT);
 			const spec = resolveMarkArrowSpec(mark, effectiveArrows, round);
-			markPrims.push(buildMarkMarkerGroup(spec, sample, round));
+			markPrims.push(buildMarkMarkerGroup(spec, sample, strokeWidth, round, baseProps.stroke ?? "currentColor"));
 			points.push(sample.point);
 		}
 	}
-	applyArrowShrinks(commands, arrows.shrinkStart, arrows.shrinkEnd, strokeWidth, round);
+	applyArrowShrinks(commands, arrows.shrinkStart + (endpointSource.firstAutoBoundary ? arrows.boundaryOuterInsetStart : 0), arrows.shrinkEnd + (endpointSource.lastAutoBoundary ? arrows.boundaryOuterInsetEnd : 0), strokeWidth, round);
 	const endpointSpecs = {};
 	if (arrows.arrowStart) endpointSpecs.arrowStart = arrows.arrowStart;
 	if (arrows.arrowEnd) endpointSpecs.arrowEnd = arrows.arrowEnd;

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

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAmBpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,WAAW,CAAC,UAAU,CAAC,KAAG,MAIhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,WAAW,EAClB,QAAQ,aAAa,EACrB,aAAa,YAAY,EACzB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAc,MAAM,KACnB;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAmGxD,CAAC"}
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAmBpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,WAAW,CAAC,UAAU,CAAC,KAAG,MAIhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,WAAW,EAClB,QAAQ,aAAa,EACrB,aAAa,YAAY,EACzB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAc,MAAM,KACnB;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAyGxD,CAAC"}

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

@@ -103,13 +103,17 @@ var emitLabelPrimitive = (label, sample, measureText, round, hostOpacity) => {
 	}
 	const halfW = measuredWidth / 2;
 	const halfH = measuredHeight / 2;
+	const left = align === "start" ? x : align === "end" ? x - measuredWidth : x - halfW;
+	const right = align === "start" ? x + measuredWidth : align === "end" ? x : x + halfW;
+	const top = baseline === "top" ? y : baseline === "bottom" ? y - measuredHeight : y - halfH;
+	const bottom = baseline === "top" ? y + measuredHeight : baseline === "bottom" ? y : y + halfH;
 	return {
 		primitive: text,
 		points: [
-			[x - halfW, y - halfH],
-			[x + halfW, y - halfH],
-			[x - halfW, y + halfH],
-			[x + halfW, y + halfH]
+			[left, top],
+			[right, top],
+			[left, bottom],
+			[right, bottom]
 		]
 	};
 };

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

@@ -8,7 +8,7 @@ import { NameStack } from '../name-stack';
  *   先反向投影 prevEnd 到 scope 局部 + 加 (dx, dy) 得局部 tuple，写回 step.to。下游
  *   `refPointOfTarget` / `clipForTarget` 把 tuple 视作 scope 局部字面量，统一 `applyTransformChain` 投回全局——
  *   relative 分支只负责"折算到局部"，不能在此处提前投影到全局，否则与下游 chain apply 形成 double-apply。
- *   `scopeChain=[]` 时 inverse 恒等，等价 v0.1 行为。
+ *   `scopeChain=[]` 时 inverse 恒等，保持全局坐标语义。
  */
 export declare const normalizeRelativeTargets: (steps: ReadonlyArray<IRStep>, nameStack: NameStack, scopeChain?: ReadonlyArray<Transform>) => Array<IRStep>;
 //# sourceMappingURL=relative.d.ts.map

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

@@ -9,7 +9,7 @@ import { refPointOfTarget } from "./anchor.js";
 *   先反向投影 prevEnd 到 scope 局部 + 加 (dx, dy) 得局部 tuple，写回 step.to。下游
 *   `refPointOfTarget` / `clipForTarget` 把 tuple 视作 scope 局部字面量，统一 `applyTransformChain` 投回全局——
 *   relative 分支只负责"折算到局部"，不能在此处提前投影到全局，否则与下游 chain apply 形成 double-apply。
-*   `scopeChain=[]` 时 inverse 恒等，等价 v0.1 行为。
+*   `scopeChain=[]` 时 inverse 恒等，保持全局坐标语义。
 */
 var normalizeRelativeTargets = (steps, nameStack, scopeChain = []) => {
 	let prevEnd = null;

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

@@ -1,7 +1,7 @@
 import { IRArrowDetail, IRArrowMark } from '../../ir';
 import { ArrowDefinition } from '../../arrows';
 import { ArrowEndSpec, PathCommand } from '../../primitive';
-/** 有效 arrow 表：内置 7 + 注入（同名注入覆盖内置） */
+/** 有效 arrow 表：内置 8 + 注入（同名注入覆盖内置） */
 export type EffectiveArrows = Record<string, ArrowDefinition>;
 /**
  * IR path-level `arrow` + `arrowDetail` → PathPrim 起末端点已解析 marker 描述
@@ -14,6 +14,8 @@ export declare const endpointArrows: (arrow: "none" | "->" | "<-" | "<->" | unde
     arrowEnd?: ArrowEndSpec;
     shrinkStart: number;
     shrinkEnd: number;
+    boundaryOuterInsetStart: number;
+    boundaryOuterInsetEnd: number;
 };
 /**
  * 解析一个中段标记 `IRArrowMark` 为已物化的 marker 描述（`ArrowEndSpec`）

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

@@ -1 +1 @@
-{"version":3,"file":"shrink.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/shrink.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,WAAW,EAEjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAA+B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9F,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAwM9D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,EAC/C,QAAQ,aAAa,GAAG,SAAS,EACjC,WAAW,eAAe,EAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B;IACD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAyBnB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,WAAW,EACjB,WAAW,eAAe,EAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,YAaF,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"}
+{"version":3,"file":"shrink.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/shrink.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,WAAW,EAEjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AAEtE,OAAO,KAAK,EAAE,YAAY,EAA+B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9F,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAsN9D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,EAC/C,QAAQ,aAAa,GAAG,SAAS,EACjC,WAAW,eAAe,EAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B;IACD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;CAyC/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,WAAW,EACjB,WAAW,eAAe,EAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,YAaF,CAAC;AAuCF;;;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

@@ -1,4 +1,5 @@
 import { DEFAULT_ARROW_SHAPE } from "../../ir/path/arrow.js";
+import { arcEndPoint, ellipseArcPoint } from "../../geometry/arc.js";
 import { validateMarkerPrimitives } from "../marker-prim.js";
 import { shiftToward } from "./anchor.js";
 //#region src/compile/path/shrink.ts
@@ -45,6 +46,7 @@ var assertFiniteGeometry = (shape, def) => {
 	if (!Number.isFinite(def.lineContactX)) throw new Error(`Arrow '${shape}' has a non-finite lineContactX (${String(def.lineContactX)}); it must be a finite number.`);
 	if (def.baseSize !== void 0 && (!Number.isFinite(def.baseSize) || def.baseSize <= 0)) throw new Error(`Arrow '${shape}' has an invalid baseSize (${String(def.baseSize)}); it must be a finite number greater than 0.`);
 	if (def.tipX !== void 0 && !Number.isFinite(def.tipX)) throw new Error(`Arrow '${shape}' has a non-finite tipX (${String(def.tipX)}); it must be a finite number.`);
+	if (def.outerInset !== void 0 && !Number.isFinite(def.outerInset)) throw new Error(`Arrow '${shape}' has a non-finite outerInset (${String(def.outerInset)}); it must be a finite number.`);
 };
 /**
 * 调 def.emit 收集 marker 并跑窄子集 + JSON-safe 校验
@@ -73,7 +75,9 @@ var resolveGeometry = (visual, effective) => {
 	const scale = visual.scale ?? 1;
 	const resolvedLength = (visual.length ?? def.defaultLength ?? 6) * scale;
 	const resolvedWidth = (visual.width ?? def.defaultWidth ?? 6) * scale;
+	const boundaryOuterInset = (def.outerInset ?? (def.hollow ? lineWidth / 2 : 0)) * resolvedLength / baseSize;
 	if (!Number.isFinite(resolvedLength) || !Number.isFinite(resolvedWidth)) throw new Error(`Arrow '${visual.shape}' resolved length/width is non-finite (length × scale overflowed); use smaller length / scale values.`);
+	if (!Number.isFinite(boundaryOuterInset)) throw new Error(`Arrow '${visual.shape}' resolved outerInset is non-finite; use smaller outerInset / length / scale values.`);
 	return {
 		def,
 		baseSize,
@@ -81,7 +85,8 @@ var resolveGeometry = (visual, effective) => {
 		contactX,
 		lineWidth,
 		resolvedLength,
-		resolvedWidth
+		resolvedWidth,
+		boundaryOuterInset
 	};
 };
 /**
@@ -131,26 +136,32 @@ var materializeArrowEndSpec = (visual, geometry, round) => {
 var endpointArrows = (arrow, detail, effective, round) => {
 	if (!arrow || arrow === "none") return {
 		shrinkStart: 0,
-		shrinkEnd: 0
+		shrinkEnd: 0,
+		boundaryOuterInsetStart: 0,
+		boundaryOuterInsetEnd: 0
 	};
 	const top = detail ?? {};
 	const wantStart = arrow === "<-" || arrow === "<->";
 	const wantEnd = arrow === "->" || arrow === "<->";
 	const result = {
 		shrinkStart: 0,
-		shrinkEnd: 0
+		shrinkEnd: 0,
+		boundaryOuterInsetStart: 0,
+		boundaryOuterInsetEnd: 0
 	};
 	if (wantStart) {
 		const visual = resolveArrowVisual(top, top.start, effective);
 		const geometry = resolveGeometry(visual, effective);
 		result.arrowStart = materializeArrowEndSpec(visual, geometry, round);
 		result.shrinkStart = computeShrink(geometry);
+		result.boundaryOuterInsetStart = geometry.boundaryOuterInset;
 	}
 	if (wantEnd) {
 		const visual = resolveArrowVisual(top, top.end, effective);
 		const geometry = resolveGeometry(visual, effective);
 		result.arrowEnd = materializeArrowEndSpec(visual, geometry, round);
 		result.shrinkEnd = computeShrink(geometry);
+		result.boundaryOuterInsetEnd = geometry.boundaryOuterInset;
 	}
 	return result;
 };
@@ -180,14 +191,8 @@ var endpointOf = (cmd) => {
 		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 "arc": return arcEndPoint(cmd.center, cmd.radius, cmd.endAngle);
+		case "ellipseArc": return ellipseArcPoint(cmd.center, cmd.radiusX, cmd.radiusY, cmd.endAngle);
 		case "close": return null;
 	}
 };

package/dist/es/compile/position.d.ts

@@ -12,14 +12,14 @@ export type ResolveBetweenGlobal = (between: IRBetweenPosition, nameStack: NameS
  * @description
  *   - **返回值语义**：当 `scopeChain` 非空时，返回**当前 scope 局部坐标系**下的笛卡尔位置；
  *     调用方负责走 `applyTransformChain(local, scopeChain)` 投回全局。当 `scopeChain` 为空时
- *     等价于 v0.1 行为（全局坐标）。
+ *     直接按全局坐标返回。
  *   - **referent 处理**：node id lookup 拿到的 layout.rect 已是全局坐标；本函数内部用
  *     `inverseTransformChain` 把全局 referent 反向投影到当前 scope 局部坐标系作为"在当前
  *     scope 局部的固定点"基准。relative 部分（polar 的 angle/radius、at 的 direction/distance、
  *     offset 的 dx/dy）在当前 scope 局部度量后加到 referent 局部坐标上。
  *   - **嵌套**：PolarPosition.origin / OffsetPosition.of 是嵌套 polar 时，递归调用传同样
  *     scopeChain——整条嵌套链都在当前 scope 局部度量。
- *   - **笛卡尔字面量**：`Position` 形态直接返回（v0.1 行为延续：scope 内笛卡尔字面量在
+ *   - **笛卡尔字面量**：`Position` 形态直接返回（scope 内笛卡尔字面量在
  *     当前 scope 局部度量；调用方走 applyTransformChain 投全局）。
  *   - 极坐标 origin / 偏移定位 of 均可递归引用节点 id 或字面坐标；relative `AtPosition` of
  *     必须引用已定义节点/coordinate；解析失败返回 null。

package/dist/es/compile/position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/compile/position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,KACjC,UAAU,GAAG,IAAI,CAAC;AAoBvB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,EAC9F,WAAW,SAAS,EACpB,eAAc,MAA8B,EAC5C,aAAY,aAAa,CAAC,SAAS,CAAM,EACzC,uBAAuB,oBAAoB,KAC1C,UAAU,GAAG,IAiDf,CAAC"}
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/compile/position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE1G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,KACjC,UAAU,GAAG,IAAI,CAAC;AAKvB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,EAC9F,WAAW,SAAS,EACpB,eAAc,MAA8B,EAC5C,aAAY,aAAa,CAAC,SAAS,CAAM,EACzC,uBAAuB,oBAAoB,KAC1C,UAAU,GAAG,IA6Cf,CAAC"}

package/dist/es/compile/position.js

@@ -1,34 +1,22 @@
+import { arcEndPoint } from "../geometry/arc.js";
+import { DirectionVectorByAtDirection } from "./direction.js";
 import { inverseTransformChain } from "./scope.js";
 //#region src/compile/position.ts
 /** 默认相对定位距离（CompileOptions.nodeDistance 未配时使用） */
 var DEFAULT_NODE_DISTANCE = 1;
 /**
-* 8 方向 → 屏幕坐标系（y 向下）单位向量
-* @description above=视觉上方 (y 减小)；4 对角分量 1/√2 保证斜向与水平/垂直距离等长（对角点落在半径=distance 圆周上）
-*/
-var DIRECTION_VECTOR = {
-	above: [0, -1],
-	below: [0, 1],
-	left: [-1, 0],
-	right: [1, 0],
-	"above-left": [-Math.SQRT1_2, -Math.SQRT1_2],
-	"above-right": [Math.SQRT1_2, -Math.SQRT1_2],
-	"below-left": [-Math.SQRT1_2, Math.SQRT1_2],
-	"below-right": [Math.SQRT1_2, Math.SQRT1_2]
-};
-/**
 * IR 各种位置形态（笛卡尔/极坐标/相对定位/偏移定位/节点 id）→ 笛卡尔位置
 * @description
 *   - **返回值语义**：当 `scopeChain` 非空时，返回**当前 scope 局部坐标系**下的笛卡尔位置；
 *     调用方负责走 `applyTransformChain(local, scopeChain)` 投回全局。当 `scopeChain` 为空时
-*     等价于 v0.1 行为（全局坐标）。
+*     直接按全局坐标返回。
 *   - **referent 处理**：node id lookup 拿到的 layout.rect 已是全局坐标；本函数内部用
 *     `inverseTransformChain` 把全局 referent 反向投影到当前 scope 局部坐标系作为"在当前
 *     scope 局部的固定点"基准。relative 部分（polar 的 angle/radius、at 的 direction/distance、
 *     offset 的 dx/dy）在当前 scope 局部度量后加到 referent 局部坐标上。
 *   - **嵌套**：PolarPosition.origin / OffsetPosition.of 是嵌套 polar 时，递归调用传同样
 *     scopeChain——整条嵌套链都在当前 scope 局部度量。
-*   - **笛卡尔字面量**：`Position` 形态直接返回（v0.1 行为延续：scope 内笛卡尔字面量在
+*   - **笛卡尔字面量**：`Position` 形态直接返回（scope 内笛卡尔字面量在
 *     当前 scope 局部度量；调用方走 applyTransformChain 投全局）。
 *   - 极坐标 origin / 偏移定位 of 均可递归引用节点 id 或字面坐标；relative `AtPosition` of
 *     必须引用已定义节点/coordinate；解析失败返回 null。
@@ -49,7 +37,7 @@ var resolvePosition = (pos, nameStack, nodeDistance = DEFAULT_NODE_DISTANCE, sco
 		const refGlobal = [ref.rect.x, ref.rect.y];
 		const refLocal = scopeChain.length === 0 ? refGlobal : inverseTransformChain(refGlobal, scopeChain);
 		const distance = pos.distance ?? nodeDistance;
-		const [dx, dy] = DIRECTION_VECTOR[pos.direction];
+		const [dx, dy] = DirectionVectorByAtDirection[pos.direction];
 		return [refLocal[0] + dx * distance, refLocal[1] + dy * distance];
 	}
 	if ("offset" in pos) {
@@ -70,8 +58,7 @@ var resolvePosition = (pos, nameStack, nodeDistance = DEFAULT_NODE_DISTANCE, sco
 		if (!resolved) return null;
 		origin = resolved;
 	}
-	const rad = pos.angle * Math.PI / 180;
-	return [origin[0] + Math.cos(rad) * pos.radius, origin[1] + Math.sin(rad) * pos.radius];
+	return arcEndPoint(origin, pos.radius, pos.angle);
 };
 //#endregion
 export { resolvePosition };

package/dist/es/compile/precision.d.ts

@@ -6,5 +6,5 @@ export declare const DEFAULT_PRECISION = 2;
  *   而 `JSON.stringify(-0) === '0'` 会让 Scene round-trip 在 `Object.is` 层失真（`-0 !== 0` 于 Object.is）。
  *   归一让序列化往返稳定；数值上 `-0 === 0`，渲染 / 计算无影响。
  */
-export declare const makeRound: (precision: number) => (n: number) => number;
+export declare const createRound: (precision: number) => (n: number) => number;
 //# sourceMappingURL=precision.d.ts.map

package/dist/es/compile/precision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"precision.d.ts","sourceRoot":"","sources":["../../../src/compile/precision.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,MAAM,MAEjC,GAAG,MAAM,WAIlB,CAAC"}
+{"version":3,"file":"precision.d.ts","sourceRoot":"","sources":["../../../src/compile/precision.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,MAAM,MAEnC,GAAG,MAAM,WAIlB,CAAC"}

package/dist/es/compile/precision.js

@@ -5,7 +5,7 @@
 *   而 `JSON.stringify(-0) === '0'` 会让 Scene round-trip 在 `Object.is` 层失真（`-0 !== 0` 于 Object.is）。
 *   归一让序列化往返稳定；数值上 `-0 === 0`，渲染 / 计算无影响。
 */
-var makeRound = (precision) => {
+var createRound = (precision) => {
 	const factor = 10 ** precision;
 	return (n) => {
 		const r = Math.round(n * factor) / factor;
@@ -13,4 +13,4 @@ var makeRound = (precision) => {
 	};
 };
 //#endregion
-export { makeRound };
+export { createRound };