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

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

@@ -2,6 +2,7 @@ const require_json = require("../../ir/json.cjs");
 const require_rect = require("../../geometry/rect.cjs");
 const require_arc = require("../../geometry/arc.cjs");
 const require_index = require("../../arrows/index.cjs");
+const require_constant = require("../constant.cjs");
 const require_scope = require("../scope.cjs");
 const require_bend = require("../../geometry/bend.cjs");
 const require_segment = require("../../geometry/segment.cjs");
@@ -65,7 +66,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,
@@ -181,7 +182,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 	const steps = require_relative.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(require_constant.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 +207,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		if (!hasTo(s)) return null;
 		const ref = require_anchor.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(require_constant.CompileWarningCode.UnresolvedNodeReference, `Step.to references undefined node id '${toId}'; the entire path is skipped`, `children[${idx}].to`);
 		return ref;
 	});
 	/**
@@ -244,7 +245,16 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 	*/
 	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 +264,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		subPathStart = p;
 		lastEnd = p;
 	};
-	const emitLine = (p) => {
+	const emitLine = (p, sourceAutoBoundary = false) => {
+		noteEndpointSource(sourceAutoBoundary);
 		const rp = roundPoint(p);
 		commands.push({
 			kind: "line",
@@ -267,7 +278,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		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 +291,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		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 +308,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		lastEnd = p;
 	};
 	const emitArc = (center, radius, startAngle, endAngle) => {
+		noteEndpointSource(false);
 		const rc = roundPoint(center);
 		commands.push({
 			kind: "arc",
@@ -307,6 +321,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		lastEnd = require_arc.arcEndPoint(center, radius, endAngle);
 	};
 	const emitEllipseArc = (center, radiusX, radiusY, startAngle, endAngle) => {
+		noteEndpointSource(false);
 		const rc = roundPoint(center);
 		commands.push({
 			kind: "ellipseArc",
@@ -321,9 +336,9 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		lastEnd = endPt;
 	};
 	/** 段起点：与 lastEnd 相同则复用 cursor（省 move），否则发 move */
-	const startSegment = (p) => {
+	const startSegment = (p, sourceAutoBoundary = false) => {
 		if (require_anchor.samePoint(p, lastEnd)) return;
-		emitMove(p);
+		emitMove(p, sourceAutoBoundary);
 	};
 	/** 部分圆/椭圆的闭合模式：'open' 直接返回；'sector' 连回中心；缺省 / 误给 'closed' 回退 'chord' */
 	const resolvePartialClosed = (closed, idx) => {
@@ -339,7 +354,10 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			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 +425,22 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			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 = require_anchor.refPointOfTarget(moveTo, nameStack, scopeChain);
 			if (!moveAnchor) return null;
-			const fromClip = require_anchor.clipForTarget(prev.step.to, moveAnchor, nameStack, scopeChain);
-			const toClip = require_anchor.clipForTarget(moveTo, prev.anchor, nameStack, scopeChain);
+			const fromClip = usedOverride ?? (prev ? require_anchor.clipForTarget(prev.step.to, moveAnchor, nameStack, scopeChain) : null);
+			const toClip = require_anchor.clipForTarget(moveTo, fromClip ?? prev?.anchor ?? moveAnchor, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
 			if (require_anchor.samePoint(fromClip, lastEnd) && require_anchor.samePoint(toClip, subPathStart)) {
 				emitClose();
 				continue;
 			}
-			startSegment(fromClip);
-			emitLine(toClip);
+			startSegment(fromClip, usedOverride === null && prev !== null && require_anchor.isAutoBoundaryTarget(prev.step.to));
+			emitLine(toClip, require_anchor.isAutoBoundaryTarget(moveTo));
 			continue;
 		}
 		if (step.kind === "rectangle") {
@@ -429,8 +449,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			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(require_constant.CompileWarningCode.UnresolvedNodeReference, `Rectangle from references undefined node id '${fromId}'; the entire path is skipped`, `children[${i}].from`);
+				if (!toPt && rectToId !== void 0) warn(require_constant.CompileWarningCode.UnresolvedNodeReference, `Rectangle to references undefined node id '${rectToId}'; the entire path is skipped`, `children[${i}].to`);
 				return null;
 			}
 			let rectStart = null;
@@ -449,14 +469,17 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			continue;
 		}
 		const prev = findPrev();
-		if (!prev) return null;
+		if (!prev) {
+			warn(require_constant.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 = require_anchor.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(require_constant.CompileWarningCode.UnresolvedNodeReference, `Arc step center references undefined node id '${centerId}'; the entire path is skipped`, `children[${i}].center`);
 					return null;
 				}
 				center = c;
@@ -480,7 +503,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 				penOverride = require_arc.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(require_constant.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 +527,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 				} else penOverride = require_arc.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(require_constant.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 +560,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 				} else penOverride = require_arc.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(require_constant.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 +579,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			const fromClip = usedOverride ?? require_anchor.clipForTarget(prev.step.to, currAnchor, nameStack, scopeChain);
 			const toClip = require_anchor.clipForTarget(step.to, prev.anchor, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitLine(toClip);
+			startSegment(fromClip, usedOverride === null && require_anchor.isAutoBoundaryTarget(prev.step.to));
+			emitLine(toClip, require_anchor.isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => require_segment.lineSegmentSample(fromClip, toClip, t));
 			continue;
 		}
@@ -565,8 +588,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			const fromClip = usedOverride ?? require_anchor.clipForTarget(prev.step.to, step.control, nameStack, scopeChain);
 			const toClip = require_anchor.clipForTarget(step.to, step.control, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitQuad(step.control, toClip);
+			startSegment(fromClip, usedOverride === null && require_anchor.isAutoBoundaryTarget(prev.step.to));
+			emitQuad(step.control, toClip, require_anchor.isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => require_segment.quadSegmentSample(fromClip, step.control, toClip, t));
 			continue;
 		}
@@ -574,8 +597,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			const fromClip = usedOverride ?? require_anchor.clipForTarget(prev.step.to, step.control1, nameStack, scopeChain);
 			const toClip = require_anchor.clipForTarget(step.to, step.control2, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitCubic(step.control1, step.control2, toClip);
+			startSegment(fromClip, usedOverride === null && require_anchor.isAutoBoundaryTarget(prev.step.to));
+			emitCubic(step.control1, step.control2, toClip, require_anchor.isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => require_segment.cubicSegmentSample(fromClip, step.control1, step.control2, toClip, t));
 			continue;
 		}
@@ -585,8 +608,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			const fromClip = usedOverride ?? require_anchor.clipForTarget(prev.step.to, c1, nameStack, scopeChain);
 			const toClip = require_anchor.clipForTarget(step.to, c2, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
-			startSegment(fromClip);
-			emitCubic(c1, c2, toClip);
+			startSegment(fromClip, usedOverride === null && require_anchor.isAutoBoundaryTarget(prev.step.to));
+			emitCubic(c1, c2, toClip, require_anchor.isAutoBoundaryTarget(step.to));
 			collectLabel(step, (t) => require_segment.cubicSegmentSample(fromClip, c1, c2, toClip, t));
 			continue;
 		}
@@ -594,9 +617,9 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		const fromClip = usedOverride ?? require_anchor.clipForTarget(prev.step.to, corner, nameStack, scopeChain);
 		const toClip = require_anchor.clipForTarget(step.to, corner, nameStack, scopeChain);
 		if (!fromClip || !toClip) return null;
-		startSegment(fromClip);
+		startSegment(fromClip, usedOverride === null && require_anchor.isAutoBoundaryTarget(prev.step.to));
 		emitLine(corner);
-		emitLine(toClip);
+		emitLine(toClip, require_anchor.isAutoBoundaryTarget(step.to));
 		collectLabel(step, (t) => require_segment.foldSegmentSample(fromClip, corner, toClip, t));
 	}
 	const strokeWidth = path.strokeWidth ?? (path.thickness ? THICKNESS_TO_WIDTH[path.thickness] : 1);
@@ -627,7 +650,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			points.push(sample.point);
 		}
 	}
-	require_shrink.applyArrowShrinks(commands, arrows.shrinkStart, arrows.shrinkEnd, strokeWidth, round);
+	require_shrink.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/lib/compile/path/index.d.ts

@@ -1,30 +1,27 @@
 import { PaintResolver } from '../paint';
 import { IRPath, IRPosition } from '../../ir';
 import { ScenePrimitive, Transform } from '../../primitive';
-import { PathGeneratorDefinition } from '../../pathGenerators';
+import { PathGeneratorDefinition } from '../../path-generators';
+import { CompileWarning } from '../constant';
 import { NameStack } from '../name-stack';
 import { TextMeasurer } from '../text-metrics';
 import { EffectiveArrows } from './shrink';
 /** emitPathPrimitive 可选 warn 钩子 */
 export type EmitPathWarnHook = {
     /** 警告收集器（由 compileToScene 传入） */
-    onWarn?: (warning: {
-        code: string;
-        message: string;
-        path: string;
-    }) => void;
+    onWarn?: (warning: CompileWarning) => void;
     /** 当前 path 在 IR 中的 locator 前缀（如 `'children[3].path'`） */
     irPath?: string;
     /**
      * 该 path 所属 scope 的累积 Cartesian-only transform 链
      * @description step.to 内的 polar/at/offset 字面量按"当前 scope 局部度量 + 末端 apply chain"
-     *   投影回全局；顶层 path / 无 scope chain 时为 `[]`（恒等，等价 v0.1 行为）
+     *   投影回全局；顶层 path / 无 scope chain 时为 `[]`（恒等，全局坐标）
      */
     scopeChain?: ReadonlyArray<Transform>;
     /** fill 解析器（PaintSpec → resourceRef + 登记资源）；缺省时纯色透传、PaintSpec 退化为无填充 */
     resolveFill?: PaintResolver;
     /**
-     * 有效 arrow 表（内置 7 + 注入）；缺省 = 仅内置 7
+     * 有效 arrow 表（内置 8 + 注入）；缺省 = 仅内置 8
      * @description compileToScene 合并 `{ ...BUILTIN_ARROWS, ...options.arrows }` 传入；
      *   endpointArrows 据此查表算 shrink / 调 def.emit；未注册名编译期 throw
      */
@@ -45,4 +42,5 @@ export declare const emitPathPrimitive: (path: IRPath, nameStack: NameStack, rou
     primitives: Array<ScenePrimitive>;
     points: Array<IRPosition>;
 } | null;
+export { refPointOfTarget } from './anchor';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/compile/path/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,OAAO,KAAK,EACV,MAAM,EAEN,UAAU,EAGX,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAIV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAKtE,OAAO,EAAE,KAAK,eAAe,EAA2D,MAAM,UAAU,CAAC;AA8FzG,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,wEAAwE;IACxE,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACnE,CAAC;AA0EF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IAsvBrE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,OAAO,KAAK,EACV,MAAM,EAEN,UAAU,EAGX,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAIV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAKtE,OAAO,EAAE,KAAK,eAAe,EAA2D,MAAM,UAAU,CAAC;AA8FzG,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,wEAAwE;IACxE,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACnE,CAAC;AA0EF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA6xBrE,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

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

@@ -9,7 +9,7 @@ const require_anchor = require("./anchor.cjs");
 *   先反向投影 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/lib/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/lib/compile/path/shrink.cjs

@@ -1,4 +1,5 @@
 const require_arrow = require("../../ir/path/arrow.cjs");
+const require_arc = require("../../geometry/arc.cjs");
 const require_marker_prim = require("../marker-prim.cjs");
 const require_anchor = require("./anchor.cjs");
 //#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 require_arc.arcEndPoint(cmd.center, cmd.radius, cmd.endAngle);
+		case "ellipseArc": return require_arc.ellipseArcPoint(cmd.center, cmd.radiusX, cmd.radiusY, cmd.endAngle);
 		case "close": return null;
 	}
 };

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

@@ -1,34 +1,22 @@
+const require_arc = require("../geometry/arc.cjs");
+const require_direction = require("./direction.cjs");
 const require_scope = require("./scope.cjs");
 //#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 : require_scope.inverseTransformChain(refGlobal, scopeChain);
 		const distance = pos.distance ?? nodeDistance;
-		const [dx, dy] = DIRECTION_VECTOR[pos.direction];
+		const [dx, dy] = require_direction.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 require_arc.arcEndPoint(origin, pos.radius, pos.angle);
 };
 //#endregion
 exports.resolvePosition = resolvePosition;

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

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

package/dist/lib/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/lib/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"}