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

package/dist/es/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,IAkvBrE,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/es/compile/path/index.js

@@ -2,11 +2,12 @@ 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 { 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";
@@ -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 = 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 +207,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 +245,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 +264,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 +278,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 +291,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 +308,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 +321,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,9 +336,9 @@ 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) => {
@@ -339,7 +354,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 +425,22 @@ 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;
 			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 +449,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;
@@ -449,14 +469,17 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			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 +503,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 +527,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 +560,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 +579,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 +588,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 +597,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 +608,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 +617,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);
@@ -627,7 +650,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			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;
@@ -648,6 +671,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			};
 			if (path.id !== void 0) group.id = path.id;
 			if (path.meta !== void 0) group.meta = path.meta;
+			if (path.animations !== void 0) group.animations = path.animations;
 			const transformedPoints = points.map((p) => applyTransformChain(p, transforms));
 			if (!transformedPoints.every(isFinitePoint)) throw new Error("Path rotate / scale produced a non-finite coordinate (scale too large); use a smaller scale.");
 			return {
@@ -658,6 +682,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 	}
 	if (path.id !== void 0) primitive.id = path.id;
 	if (path.meta !== void 0) primitive.meta = path.meta;
+	if (path.animations !== void 0) primitive.animations = path.animations;
 	return {
 		primitives: bodyPrims,
 		points

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 };

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

@@ -1,14 +1,16 @@
 import { IRPosition, IRTransform } from '../ir';
 import { Transform } from '../primitive';
+import { ShapeDefinition } from '../shapes';
 import { NameStack } from './name-stack';
 import { NodeLayout } from './node';
+import { ResolveBetweenGlobal } from './position';
 /**
- * 把 IR 6 变体 transforms 展平为 Scene 3 变体（Cartesian translate / rotate / scale）
- * @description 4 个 translate 变体（translate / polar-translate / at-translate / offset-translate）
+ * 把 IR 7 变体 transforms 展平为 Scene 3 变体（Cartesian translate / rotate / scale）
+ * @description 5 个 translate 变体（translate / polar-translate / at-translate / offset-translate / between-translate）
  *   各自构造对应 Position 字面量并调用 `resolvePosition` 拿到 Cartesian (x, y)，再写成 Cartesian translate；
  *   rotate / scale 直接透传。referent 未解析时返回 null（上游负责发 warn / throw）
  */
-export declare const lowerScopeTransforms: (transforms: ReadonlyArray<IRTransform>, nameStack: NameStack, nodeDistance?: number) => Array<Transform> | null;
+export declare const lowerScopeTransforms: (transforms: ReadonlyArray<IRTransform>, nameStack: NameStack, nodeDistance?: number, resolveBetweenGlobal?: ResolveBetweenGlobal) => Array<Transform> | null;
 /**
  * 把局部坐标点 (x, y) 按 Cartesian-only transform 链 apply 到全局坐标
  * @description 数组语义与 SVG `transform="t0 t1 t2"` / TikZ scope option 顺序一致：
@@ -33,7 +35,7 @@ export declare const inverseTransformChain: (global: IRPosition, chain: Readonly
  *   scale 乘进 rect.width / height / margin——这样 path 端点的 boundary clip 取的是与 SVG `<g>`
  *   实际渲染一致的视觉尺寸 / 朝向，跨 / 入 / 出 rotate / scale scope 的 path 都贴节点视觉边界。
  *   非均匀 scale 与 rotate 在 chain 中混合时，按"累加 rotate + 分量相乘 scale"近似（uniform scale 精确，
- *   anisotropic + rotate 的剪切耦合不展开——alpha 阶段限制）。
+ *   anisotropic + rotate 的剪切耦合不展开——当前投影模型限制）。
  */
 export declare const projectLayoutToGlobal: (layout: NodeLayout, chain: ReadonlyArray<Transform>) => NodeLayout;
 /** scope bbox 计算结果：bbox 几何中心 + 尺寸（width/height ≥ 0；空 scope 退化为 0×0 占位时仍合法） */
@@ -62,5 +64,5 @@ export declare const computeScopeBoundingBox: (layouts: ReadonlyArray<NodeLayout
  *   synthetic layout 完全复用 rectangle 路径：`scope.id.<keyword>` / `scope.id.<deg>` / `scope.id` 作为 referent
  *   走与普通 rectangle Node 完全一致的 anchorOf / boundaryPointOf / 中心点取值
  */
-export declare const registerScopeAsLayout: (id: string, bbox: ScopeBoundingBox | null, fallbackOrigin: IRPosition) => NodeLayout;
+export declare const registerScopeAsLayout: (id: string, bbox: ScopeBoundingBox | null, fallbackOrigin: IRPosition, shapes?: Record<string, ShapeDefinition>) => NodeLayout;
 //# sourceMappingURL=scope.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/compile/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EAEZ,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,aAAa,CAAC,WAAW,CAAC,EACtC,WAAW,SAAS,EACpB,eAAe,MAAM,KACpB,KAAK,CAAC,SAAS,CAAC,GAAG,IAiDrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EACjB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAyBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAuBF,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,UAAU,CAAC,KACjC,gBAAgB,GAAG,IA2BrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,MAAM,gBAAgB,GAAG,IAAI,EAC7B,gBAAgB,UAAU,KACzB,UAiBF,CAAC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/compile/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,UAAU,EACV,WAAW,EAEZ,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,KAAK,oBAAoB,EAAmB,MAAM,YAAY,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,aAAa,CAAC,WAAW,CAAC,EACtC,WAAW,SAAS,EACpB,eAAe,MAAM,EACrB,uBAAuB,oBAAoB,KAC1C,KAAK,CAAC,SAAS,CAAC,GAAG,IAwDrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EACjB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAyBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UA4BF,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,UAAU,CAAC,KACjC,gBAAgB,GAAG,IA6BrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,MAAM,gBAAgB,GAAG,IAAI,EAC7B,gBAAgB,UAAU,EAC1B,SAAQ,MAAM,CAAC,MAAM,EAAE,eAAe,CAAkB,KACvD,UAiBF,CAAC"}