@retikz/core 0.2.0-alpha.4 → 0.2.0-alpha.6

package/dist/es/compile/anchor-cache.d.ts

@@ -1,3 +1,4 @@
+import { Side } from '../geometry/_edge';
 import { IRPosition } from '../ir';
 import { NodeLayout } from './node';
 /**
@@ -9,4 +10,13 @@ import { NodeLayout } from './node';
  * @returns 全局坐标系下的 IRPosition `[x, y]`
  */
 export declare const resolveAnchor: (layout: NodeLayout, anchorName: string) => IRPosition;
+/**
+ * 取节点边上比例点 `{ side, t }` 的全局坐标，带 per-layout 缓存
+ * @description 走 `layout.shapeDef.edgePoint`——shape 未实现（如自定义 shape）抛"does not support side anchors"；
+ *   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断，见 alpha.6 ADR-01 决策细节 #10）。
+ *   缓存 key = `${side}:${t}`，与命名 anchor（`'north'` / `'30'`）共用 layout 的 Map——key 含 `:` 故命名空间不冲突。
+ * @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
+ * @returns 全局坐标系下的 IRPosition `[x, y]`
+ */
+export declare const resolveEdgePoint: (layout: NodeLayout, side: Side, t: number) => IRPosition;
 //# sourceMappingURL=anchor-cache.d.ts.map

package/dist/es/compile/anchor-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchor-cache.d.ts","sourceRoot":"","sources":["../../../src/compile/anchor-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA4BzC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,UAAU,EAClB,YAAY,MAAM,KACjB,UAWF,CAAC"}
+{"version":3,"file":"anchor-cache.d.ts","sourceRoot":"","sources":["../../../src/compile/anchor-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA4BzC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,UAAU,EAClB,YAAY,MAAM,KACjB,UAWF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,UAAU,EAClB,MAAM,IAAI,EACV,GAAG,MAAM,KACR,UAuBF,CAAC"}

package/dist/es/compile/anchor-cache.js

@@ -37,5 +37,29 @@ var resolveAnchor = (layout, anchorName) => {
 	layoutCache.set(anchorName, result);
 	return result;
 };
+/**
+* 取节点边上比例点 `{ side, t }` 的全局坐标，带 per-layout 缓存
+* @description 走 `layout.shapeDef.edgePoint`——shape 未实现（如自定义 shape）抛"does not support side anchors"；
+*   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断，见 alpha.6 ADR-01 决策细节 #10）。
+*   缓存 key = `${side}:${t}`，与命名 anchor（`'north'` / `'30'`）共用 layout 的 Map——key 含 `:` 故命名空间不冲突。
+* @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
+* @returns 全局坐标系下的 IRPosition `[x, y]`
+*/
+var resolveEdgePoint = (layout, side, t) => {
+	const { edgePoint } = layout.shapeDef;
+	if (!edgePoint) throw new Error(`shape '${layout.shapeName}' does not support side anchors ({ side, t })`);
+	if (layout.rect.width === 0 && layout.rect.height === 0) throw new Error(`{ side, t } is not meaningful on a zero-size Coordinate (shape '${layout.shapeName}')`);
+	let layoutCache = cache.get(layout);
+	if (!layoutCache) {
+		layoutCache = /* @__PURE__ */ new Map();
+		cache.set(layout, layoutCache);
+	}
+	const key = `${side}:${t}`;
+	const cached = layoutCache.get(key);
+	if (cached !== void 0) return cached;
+	const result = positionToIR(edgePoint(layout.rect, side, t));
+	layoutCache.set(key, result);
+	return result;
+};
 //#endregion
-export { resolveAnchor };
+export { resolveAnchor, resolveEdgePoint };

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

@@ -1,6 +1,5 @@
 export * from './compile';
 export * from './node';
-export * from './parseTarget';
 export * from './path/index';
 export * from './position';
 export * from './precision';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compile/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compile/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAqBf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,IAAI,GAAG,IAAI,KACf,UACqD,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAqBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACzB,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAM7E,CAAC"}
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAqB/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAkBf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,IAAI,GAAG,IAAI,KACf,UACqD,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAkBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACzB,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAM7E,CAAC"}

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

@@ -1,9 +1,18 @@
 import { applyTransformChain } from "../scope.js";
 import { resolvePosition } from "../position.js";
 import { boundaryPointOf } from "../node.js";
-import { resolveAnchor } from "../anchor-cache.js";
-import { parseNodeRef } from "../parseTarget.js";
+import { resolveAnchor, resolveEdgePoint } from "../anchor-cache.js";
 //#region src/compile/path/anchor.ts
+/** target 是否对象形态 NodeTarget（`{ id, anchor?, offset? }`）；与 Position(array) / Polar / Offset(of) / Relative 区分（独有 `id`） */
+var isNodeTarget = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t;
+/** 解析 NodeTarget 的 anchor（非 undefined）到世界坐标：命名 / 角度走 resolveAnchor，`{ side, t }` 走 resolveEdgePoint */
+var resolveAnchorRef = (node, anchor) => {
+	if (typeof anchor === "number") return resolveAnchor(node, String(anchor));
+	if (typeof anchor === "string") return resolveAnchor(node, anchor);
+	return resolveEdgePoint(node, anchor.side, anchor.t);
+};
+/** anchor/边点解析后叠加世界系 offset（不随节点 rotate 旋转） */
+var addOffset = (base, offset) => offset ? [base[0] + offset[0], base[1] + offset[1]] : base;
 /**
 * 求 step.to 的参考点（给 boundary clip 算方向 / 折角 corner 用）
 * @description 三态：`'A'`(auto) 节点中心；`'A.<anchor>'`/`'A.<deg>'` 显式锚点 refPoint=endpoint 位置不随邻居变。直接坐标/极坐标解析为笛卡尔。
@@ -12,15 +21,10 @@ import { parseNodeRef } from "../parseTarget.js";
 *   `applyTransformChain` 投回全局。`scopeChain=[]` 等价 v0.1（恒等）。
 */
 var refPointOfTarget = (target, nameStack, scopeChain = []) => {
-	if (typeof target === "string") {
-		const ref = parseNodeRef(target);
-		const node = nameStack.lookup(ref.id);
+	if (isNodeTarget(target)) {
+		const node = nameStack.lookup(target.id);
 		if (!node) return null;
-		switch (ref.kind) {
-			case "node": return [node.rect.x, node.rect.y];
-			case "anchor": return resolveAnchor(node, ref.anchor);
-			case "angle": return resolveAnchor(node, String(ref.angle));
-		}
+		return addOffset(target.anchor === void 0 ? [node.rect.x, node.rect.y] : resolveAnchorRef(node, target.anchor), target.offset);
 	}
 	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
 	const local = resolvePosition(target, nameStack, void 0, scopeChain);
@@ -36,15 +40,10 @@ var cornerOf = (prev, curr, via) => via === "-|" ? [curr[0], prev[1]] : [prev[0]
 *   `resolvePosition(..., scopeChain)` 拿到当前 scope 局部坐标后 `applyTransformChain` 投回全局。
 */
 var clipForTarget = (target, toward, nameStack, scopeChain = []) => {
-	if (typeof target === "string") {
-		const ref = parseNodeRef(target);
-		const node = nameStack.lookup(ref.id);
+	if (isNodeTarget(target)) {
+		const node = nameStack.lookup(target.id);
 		if (!node) return null;
-		switch (ref.kind) {
-			case "node": return boundaryPointOf(node, toward);
-			case "anchor": return resolveAnchor(node, ref.anchor);
-			case "angle": return resolveAnchor(node, String(ref.angle));
-		}
+		return addOffset(target.anchor === void 0 ? boundaryPointOf(node, toward) : resolveAnchorRef(node, target.anchor), target.offset);
 	}
 	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
 	const local = resolvePosition(target, nameStack, void 0, scopeChain);

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":"AAYA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AA8BtE,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;CACvC,CAAC;AAEF;;;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,IA2XrE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAkCtE,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;CACvC,CAAC;AAEF;;;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,IAkhBrE,CAAC"}

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

@@ -1,6 +1,7 @@
-import { arcBoundingPoints, arcEndPoint } from "../../geometry/arc.js";
+import { rectOutline } from "../../geometry/rect.js";
+import { arcBoundingPoints, arcEndPoint, ellipseArcBoundingPoints, ellipseArcPoint } from "../../geometry/arc.js";
 import { bendControlPoints } from "../../geometry/bend.js";
-import { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample } from "../../geometry/segment.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 { emitLabelPrimitive, tForLabelPosition } from "./label.js";
@@ -8,6 +9,8 @@ import { normalizeRelativeTargets } from "./relative.js";
 import { applyArrowShrinks, computeShrink, endpointArrows } from "./shrink.js";
 import { splitSubPathsForEndpointArrows } from "./split.js";
 //#region src/compile/path/index.ts
+/** 目标若是对象 NodeTarget（`{ id, ... }`）返回其 id，否则 undefined——给 UNRESOLVED_NODE_REFERENCE 诊断用 */
+var nodeRefId = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t ? t.id : void 0;
 /**
 * 语义 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。
@@ -51,11 +54,12 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		labelPrims.push(r.primitive);
 		for (const p of r.points) points.push(p);
 	};
-	const hasTo = (s) => s.kind !== "cycle" && s.kind !== "arc" && s.kind !== "circlePath" && s.kind !== "ellipsePath";
+	const hasTo = (s) => s.kind !== "cycle" && s.kind !== "arc" && s.kind !== "circlePath" && s.kind !== "ellipsePath" && s.kind !== "rectangle";
 	const anchors = steps.map((s, idx) => {
 		if (!hasTo(s)) return null;
 		const ref = refPointOfTarget(s.to, nameStack, scopeChain);
-		if (!ref && typeof s.to === "string") warn("UNRESOLVED_NODE_REFERENCE", `Step.to references undefined node id '${s.to}'; the entire path is skipped`, `children[${idx}].to`);
+		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`);
 		return ref;
 	});
 	/**
@@ -168,6 +172,12 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		if (samePoint(p, lastEnd)) return;
 		emitMove(p);
 	};
+	/** 部分圆/椭圆的闭合模式：'open' 直接返回；缺省 / 误给 'closed' 回退 'chord' */
+	const resolvePartialClosed = (closed, idx) => {
+		if (closed === "open") return "open";
+		if (closed === "closed") warn("PARTIAL_ARC_CLOSED_INVALID", "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++) {
 		if (i > 0) {
 			const prevStep = steps[i - 1];
@@ -193,22 +203,83 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			emitLine(toClip);
 			continue;
 		}
+		if (step.kind === "rectangle") {
+			const fromPt = refPointOfTarget(step.from, nameStack, scopeChain);
+			const toPt = refPointOfTarget(step.to, nameStack, scopeChain);
+			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`);
+				return null;
+			}
+			let rectStart = null;
+			for (const op of rectOutline(fromPt, toPt, step.roundedCorners)) if (op.kind === "move") {
+				emitMove(op.to);
+				rectStart = op.to;
+			} else if (op.kind === "line") emitLine(op.to);
+			else if (op.kind === "arc") emitArc(op.center, op.radius, op.startAngle, op.endAngle);
+			else emitClose();
+			const rx0 = Math.min(fromPt[0], toPt[0]);
+			const rx1 = Math.max(fromPt[0], toPt[0]);
+			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]);
+			if (rectStart) penOverride = rectStart;
+			continue;
+		}
 		const prev = findPrev();
 		if (!prev) return null;
 		if (step.kind === "arc") {
-			const center = prev.anchor;
-			const startPt = arcEndPoint(center, step.radius, step.startAngle);
-			const endPt = arcEndPoint(center, step.radius, step.endAngle);
-			startSegment(startPt);
-			emitArc(center, step.radius, step.startAngle, step.endAngle);
-			for (const p of arcBoundingPoints(center, step.radius, step.startAngle, step.endAngle)) points.push(p);
-			collectLabel(step, (t) => arcSegmentSample(center, step.radius, step.startAngle, step.endAngle, t));
-			penOverride = endPt;
-			continue;
+			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`);
+					return null;
+				}
+				center = c;
+			} else center = prev.anchor;
+			if (step.radiusX !== void 0 && step.radiusY !== void 0) {
+				const rx = step.radiusX;
+				const ry = step.radiusY;
+				startSegment(ellipseArcPoint(center, rx, ry, step.startAngle));
+				emitEllipseArc(center, rx, ry, step.startAngle, step.endAngle);
+				for (const p of ellipseArcBoundingPoints(center, rx, ry, step.startAngle, step.endAngle)) points.push(p);
+				collectLabel(step, (t) => ellipseArcSegmentSample(center, rx, ry, step.startAngle, step.endAngle, t));
+				penOverride = ellipseArcPoint(center, rx, ry, step.endAngle);
+				continue;
+			}
+			if (step.radius !== void 0) {
+				const r = step.radius;
+				startSegment(arcEndPoint(center, r, step.startAngle));
+				emitArc(center, r, step.startAngle, step.endAngle);
+				for (const p of arcBoundingPoints(center, r, step.startAngle, step.endAngle)) points.push(p);
+				collectLabel(step, (t) => arcSegmentSample(center, r, step.startAngle, step.endAngle, t));
+				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}]`);
+			return null;
 		}
 		if (step.kind === "circlePath") {
 			const center = prev.anchor;
 			const r = step.radius;
+			if (step.startAngle !== void 0 && step.endAngle !== void 0) {
+				const startA = step.startAngle;
+				const endA = step.endAngle;
+				startSegment(ellipseArcPoint(center, r, r, startA));
+				emitEllipseArc(center, r, r, startA, endA);
+				for (const p of ellipseArcBoundingPoints(center, r, r, startA, endA)) points.push(p);
+				collectLabel(step, (t) => ellipseArcSegmentSample(center, r, r, startA, endA, t));
+				if (resolvePartialClosed(step.closed, i) === "chord") {
+					emitClose();
+					penOverride = ellipseArcPoint(center, r, r, startA);
+				} 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}]`);
 			startSegment([center[0] + r, center[1]]);
 			emitEllipseArc(center, r, r, 0, 360);
 			points.push([center[0] + r, center[1]]);
@@ -223,6 +294,20 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const center = prev.anchor;
 			const rx = step.radiusX;
 			const ry = step.radiusY;
+			if (step.startAngle !== void 0 && step.endAngle !== void 0) {
+				const startA = step.startAngle;
+				const endA = step.endAngle;
+				startSegment(ellipseArcPoint(center, rx, ry, startA));
+				emitEllipseArc(center, rx, ry, startA, endA);
+				for (const p of ellipseArcBoundingPoints(center, rx, ry, startA, endA)) points.push(p);
+				collectLabel(step, (t) => ellipseArcSegmentSample(center, rx, ry, startA, endA, t));
+				if (resolvePartialClosed(step.closed, i) === "chord") {
+					emitClose();
+					penOverride = ellipseArcPoint(center, rx, ry, startA);
+				} 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}]`);
 			startSegment([center[0] + rx, center[1]]);
 			emitEllipseArc(center, rx, ry, 0, 360);
 			points.push([center[0] + rx, center[1]]);

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

@@ -1 +1 @@
-{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,KAAK,CAAC,MAAM,CAuEd,CAAC"}
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,KAAK,CAAC,MAAM,CA6Ed,CAAC"}

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

@@ -25,7 +25,11 @@ var normalizeRelativeTargets = (steps, nameStack, scopeChain = []) => {
 		}
 		if (step.kind === "arc") {
 			out.push(step);
-			if (prevEnd) prevEnd = arcEndPoint(prevEnd, step.radius, step.endAngle);
+			if (prevEnd && step.radius !== void 0 && step.center === void 0) prevEnd = arcEndPoint(prevEnd, step.radius, step.endAngle);
+			continue;
+		}
+		if (step.kind === "rectangle") {
+			out.push(step);
 			continue;
 		}
 		const original = step.to;

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

@@ -0,0 +1,29 @@
+import { Position } from './point';
+/** 边上比例点 `{ side, t }` 的四个 side（north/south/east/west） */
+export type Side = 'north' | 'south' | 'east' | 'west';
+/**
+ * rect 四直边 t=0 / t=1 端点对应的角 anchor
+ * @description 方向约定单一真源：north/south = 西→东（t=0 在 west 端），east/west = 北→南（t=0 在 north 端）。
+ *   仅 rect 直边用两角端点；circle/ellipse 用 `edgeAngleDeg` 角度表、diamond 用过顶点折线。
+ */
+export declare const EDGE_ENDS: {
+    readonly north: readonly ["north-west", "north-east"];
+    readonly south: readonly ["south-west", "south-east"];
+    readonly east: readonly ["north-east", "south-east"];
+    readonly west: readonly ["north-west", "south-west"];
+};
+/** 线性插值 a + (b − a)·t */
+export declare const lerpPoint: (a: Position, b: Position, t: number) => Position;
+/**
+ * circle / ellipse 周长弧段：side 的局部参数角 θ(t)，单位度
+ * @description 约定同 geometry 既有 `(cosθ, sinθ)` + y 轴向下 ⇒ east=0° / south=90° / west=180° / north=270°，
+ *   顺时针为正。每条 side 是一段 90° 弧（等角插值）；三点（t=0/0.5/1）与 9-anchor 重合。
+ */
+export declare const edgeAngleDeg: (side: Side, t: number) => number;
+/**
+ * diamond 过 cardinal 顶点的两段折线
+ * @description t∈[0,0.5] 走 p0→vertex、t∈[0.5,1] 走 vertex→p1；t=0.5 恰落 vertex。
+ *   p0/p1 为相邻边中点 anchor、vertex 为 cardinal 顶点 anchor——全落真实斜边
+ */
+export declare const polylineViaVertex: (p0: Position, vertex: Position, p1: Position, t: number) => Position;
+//# sourceMappingURL=_edge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_edge.d.ts","sourceRoot":"","sources":["../../../src/geometry/_edge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,0DAA0D;AAC1D,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;CAK8C,CAAC;AAErE,yBAAyB;AACzB,eAAO,MAAM,SAAS,GAAI,GAAG,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,KAAG,QAG/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,EAAE,GAAG,MAAM,KAAG,MAWpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,QAAQ,EACZ,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,QAA4F,CAAC"}

package/dist/es/geometry/_edge.js

@@ -0,0 +1,35 @@
+//#region src/geometry/_edge.ts
+/**
+* rect 四直边 t=0 / t=1 端点对应的角 anchor
+* @description 方向约定单一真源：north/south = 西→东（t=0 在 west 端），east/west = 北→南（t=0 在 north 端）。
+*   仅 rect 直边用两角端点；circle/ellipse 用 `edgeAngleDeg` 角度表、diamond 用过顶点折线。
+*/
+var EDGE_ENDS = {
+	north: ["north-west", "north-east"],
+	south: ["south-west", "south-east"],
+	east: ["north-east", "south-east"],
+	west: ["north-west", "south-west"]
+};
+/** 线性插值 a + (b − a)·t */
+var lerpPoint = (a, b, t) => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
+/**
+* circle / ellipse 周长弧段：side 的局部参数角 θ(t)，单位度
+* @description 约定同 geometry 既有 `(cosθ, sinθ)` + y 轴向下 ⇒ east=0° / south=90° / west=180° / north=270°，
+*   顺时针为正。每条 side 是一段 90° 弧（等角插值）；三点（t=0/0.5/1）与 9-anchor 重合。
+*/
+var edgeAngleDeg = (side, t) => {
+	switch (side) {
+		case "north": return 225 + 90 * t;
+		case "south": return 135 - 90 * t;
+		case "east": return -45 + 90 * t;
+		case "west": return 225 - 90 * t;
+	}
+};
+/**
+* diamond 过 cardinal 顶点的两段折线
+* @description t∈[0,0.5] 走 p0→vertex、t∈[0.5,1] 走 vertex→p1；t=0.5 恰落 vertex。
+*   p0/p1 为相邻边中点 anchor、vertex 为 cardinal 顶点 anchor——全落真实斜边
+*/
+var polylineViaVertex = (p0, vertex, p1, t) => t <= .5 ? lerpPoint(p0, vertex, t * 2) : lerpPoint(vertex, p1, (t - .5) * 2);
+//#endregion
+export { EDGE_ENDS, edgeAngleDeg, lerpPoint, polylineViaVertex };

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

@@ -6,4 +6,15 @@ export declare const arcEndPoint: (center: Position, radius: number, angleDeg: n
  * @description 弧投影到 x/y 轴的极值只可能在弧端点或圆周轴向四点出现。endAngle < startAngle 时按 min..max 扫描；跨 360°（270→450）按数值区间正确处理；不去重——端角恰在 90°·k 上时调用方处理
  */
 export declare const arcBoundingPoints: (center: Position, radius: number, startAngleDeg: number, endAngleDeg: number) => Array<Position>;
+/**
+ * 椭圆弧参数点：中心 + 半轴 rx/ry + 参数角（度）→ 椭圆周上点
+ * @description 与 arcEndPoint 同角度约定（SVG y-down）；endpoint = [cx + rx·cosθ, cy + ry·sinθ]。
+ *   θ 是参数角（非真实极角，rx≠ry 时两者不等）
+ */
+export declare const ellipseArcPoint: (center: Position, radiusX: number, radiusY: number, angleDeg: number) => Position;
+/**
+ * 椭圆弧 bbox 极值候选：起点、终点，加 [start,end] 区间内所有 90°·k 参数角处的椭圆周点
+ * @description 轴对齐椭圆的 x 极值在 θ=0/180、y 极值在 θ=90/270，与正圆同结构（仅半轴用 rx/ry）
+ */
+export declare const ellipseArcBoundingPoints: (center: Position, radiusX: number, radiusY: number, startAngleDeg: number, endAngleDeg: number) => Array<Position>;
 //# sourceMappingURL=arc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../src/geometry/arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAWxC,iDAAiD;AACjD,eAAO,MAAM,WAAW,GACtB,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAiBhB,CAAC"}
+{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../src/geometry/arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAWxC,iDAAiD;AACjD,eAAO,MAAM,WAAW,GACtB,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAiBhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,QAAQ,EAChB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,QAAQ,EAChB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAehB,CAAC"}

package/dist/es/geometry/arc.js

@@ -22,5 +22,31 @@ var arcBoundingPoints = (center, radius, startAngleDeg, endAngleDeg) => {
 	}
 	return points;
 };
+/**
+* 椭圆弧参数点：中心 + 半轴 rx/ry + 参数角（度）→ 椭圆周上点
+* @description 与 arcEndPoint 同角度约定（SVG y-down）；endpoint = [cx + rx·cosθ, cy + ry·sinθ]。
+*   θ 是参数角（非真实极角，rx≠ry 时两者不等）
+*/
+var ellipseArcPoint = (center, radiusX, radiusY, angleDeg) => {
+	const rad = angleDeg * DEG_TO_RAD;
+	return [center[0] + Math.cos(rad) * radiusX, center[1] + Math.sin(rad) * radiusY];
+};
+/**
+* 椭圆弧 bbox 极值候选：起点、终点，加 [start,end] 区间内所有 90°·k 参数角处的椭圆周点
+* @description 轴对齐椭圆的 x 极值在 θ=0/180、y 极值在 θ=90/270，与正圆同结构（仅半轴用 rx/ry）
+*/
+var ellipseArcBoundingPoints = (center, radiusX, radiusY, startAngleDeg, endAngleDeg) => {
+	const points = [ellipseArcPoint(center, radiusX, radiusY, startAngleDeg), ellipseArcPoint(center, radiusX, radiusY, endAngleDeg)];
+	const lo = Math.min(startAngleDeg, endAngleDeg);
+	const hi = Math.max(startAngleDeg, endAngleDeg);
+	const kStart = Math.ceil(lo / 90);
+	const kEnd = Math.floor(hi / 90);
+	for (let k = kStart; k <= kEnd; k++) {
+		const angle = k * 90;
+		if (angle === startAngleDeg || angle === endAngleDeg) continue;
+		points.push(ellipseArcPoint(center, radiusX, radiusY, angle));
+	}
+	return points;
+};
 //#endregion
-export { arcBoundingPoints, arcEndPoint };
+export { arcBoundingPoints, arcEndPoint, ellipseArcBoundingPoints, ellipseArcPoint };

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

@@ -1,3 +1,4 @@
+import { Side } from './_edge';
 import { Position } from './point';
 import { RectAnchor } from './rect';
 /** 圆形：几何中心 + 半径，预留旋转字段保持与 Rect 同形 API */
@@ -19,5 +20,7 @@ export declare const circle: {
     anchor: (c: Circle, name: RectAnchor) => Position;
     /** 从圆心向 toward 方向射线与圆周交点（Path 端点贴 Node 边界用） */
     boundaryPoint: (c: Circle, toward: Position) => Position;
+    /** 边上比例点：side 的 90° 周长弧段 t∈[0,1] 处（等角，落真实圆周；含旋转） */
+    edgePoint: (c: Circle, side: Side, t: number) => Position;
 };
 //# sourceMappingURL=circle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../../src/geometry/circle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,UAAU,KAAG,QAAQ;IAsC/C,+CAA+C;uBAC5B,MAAM,UAAU,QAAQ,KAAG,QAAQ;CAOvD,CAAC"}
+{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../../src/geometry/circle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,UAAU,KAAG,QAAQ;IAsC/C,+CAA+C;uBAC5B,MAAM,UAAU,QAAQ,KAAG,QAAQ;IAOtD,oDAAoD;mBACrC,MAAM,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAIxD,CAAC"}

package/dist/es/geometry/circle.js

@@ -1,5 +1,7 @@
 import { localToWorld, worldToLocal } from "./_transform.js";
+import { edgeAngleDeg } from "./_edge.js";
 //#region src/geometry/circle.ts
+var DEG_TO_RAD = Math.PI / 180;
 var SQRT_HALF = Math.SQRT1_2;
 /** 圆形相关基础工具 */
 var circle = {
@@ -55,6 +57,11 @@ var circle = {
 		if (len === 0) return [c.x, c.y];
 		const t = c.radius / len;
 		return localToWorld(c, [lx * t, ly * t]);
+	},
+	/** 边上比例点：side 的 90° 周长弧段 t∈[0,1] 处（等角，落真实圆周；含旋转） */
+	edgePoint: (c, side, t) => {
+		const rad = edgeAngleDeg(side, t) * DEG_TO_RAD;
+		return localToWorld(c, [c.radius * Math.cos(rad), c.radius * Math.sin(rad)]);
 	}
 };
 //#endregion

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

@@ -1,3 +1,4 @@
+import { Side } from './_edge';
 import { Position } from './point';
 import { RectAnchor } from './rect';
 /** 菱形：中心 + halfA/halfB 半轴长 + 可选旋转；顶点在 (±halfA,0) 与 (0,±halfB) */
@@ -24,5 +25,7 @@ export declare const diamond: {
      * @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)
      */
     boundaryPoint: (d: Diamond, toward: Position) => Position;
+    /** 边上比例点：side 过 cardinal 顶点的两段折线 t∈[0,1] 处（落真实斜边；含旋转） */
+    edgePoint: (d: Diamond, side: Side, t: number) => Position;
 };
 //# sourceMappingURL=diamond.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C,sDAAsD;gBAC1C,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAOxD,CAAC"}
+{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAqB,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAUzC,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C,sDAAsD;gBAC1C,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;IAOvD,yDAAyD;mBAC1C,OAAO,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CASzD,CAAC"}

package/dist/es/geometry/diamond.js

@@ -1,5 +1,29 @@
 import { localToWorld, worldToLocal } from "./_transform.js";
+import { polylineViaVertex } from "./_edge.js";
 //#region src/geometry/diamond.ts
+/** 每条 side 的过顶点折线三 anchor：[邻边中点, cardinal 顶点, 邻边中点]（方向 north/south=西→东、east/west=北→南） */
+var DIAMOND_EDGE = {
+	north: [
+		"north-west",
+		"north",
+		"north-east"
+	],
+	south: [
+		"south-west",
+		"south",
+		"south-east"
+	],
+	east: [
+		"north-east",
+		"east",
+		"south-east"
+	],
+	west: [
+		"north-west",
+		"west",
+		"south-west"
+	]
+};
 /** 菱形相关基础工具 */
 var diamond = {
 	/** 中心 */
@@ -56,6 +80,11 @@ var diamond = {
 		if (denom === 0) return [d.x, d.y];
 		const t = 1 / denom;
 		return localToWorld(d, [lx * t, ly * t]);
+	},
+	/** 边上比例点：side 过 cardinal 顶点的两段折线 t∈[0,1] 处（落真实斜边；含旋转） */
+	edgePoint: (d, side, t) => {
+		const [mid0, vertex, mid1] = DIAMOND_EDGE[side];
+		return polylineViaVertex(diamond.anchor(d, mid0), diamond.anchor(d, vertex), diamond.anchor(d, mid1), t);
 	}
 };
 //#endregion

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

@@ -1,3 +1,4 @@
+import { Side } from './_edge';
 import { Position } from './point';
 import { RectAnchor } from './rect';
 /** 椭圆：中心 + 半长轴 rx / 半短轴 ry + 可选旋转 */
@@ -27,5 +28,7 @@ export declare const ellipse: {
      * @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)
      */
     boundaryPoint: (e: Ellipse, toward: Position) => Position;
+    /** 边上比例点：side 的 90° 周长弧段 t∈[0,1] 处（等角，落真实椭圆周；含旋转） */
+    edgePoint: (e: Ellipse, side: Side, t: number) => Position;
 };
 //# sourceMappingURL=ellipse.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI9C;;;OAGG;gBACW,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI9C;;;OAGG;gBACW,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;IAQvD,qDAAqD;mBACtC,OAAO,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAIzD,CAAC"}

package/dist/es/geometry/ellipse.js

@@ -1,5 +1,7 @@
 import { localToWorld, worldToLocal } from "./_transform.js";
+import { edgeAngleDeg } from "./_edge.js";
 //#region src/geometry/ellipse.ts
+var DEG_TO_RAD = Math.PI / 180;
 var SQRT_HALF = Math.SQRT1_2;
 /** 椭圆相关基础工具 */
 var ellipse = {
@@ -61,6 +63,11 @@ var ellipse = {
 		const b = ly / e.ry;
 		const t = 1 / Math.sqrt(a * a + b * b);
 		return localToWorld(e, [lx * t, ly * t]);
+	},
+	/** 边上比例点：side 的 90° 周长弧段 t∈[0,1] 处（等角，落真实椭圆周；含旋转） */
+	edgePoint: (e, side, t) => {
+		const rad = edgeAngleDeg(side, t) * DEG_TO_RAD;
+		return localToWorld(e, [e.rx * Math.cos(rad), e.ry * Math.sin(rad)]);
 	}
 };
 //#endregion