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

package/dist/es/geometry/{roundedContour.js → contour.js}

@@ -1,37 +1,25 @@
-import { arcAngleInRange, rayArc } from "./arc.js";
-//#region src/geometry/roundedContour.ts
+import { arcAngleInRange, arcEndPoint, rayArc } from "./arc.js";
+import { point } from "./point.js";
+//#region src/geometry/contour.ts
 var DEG_TO_RAD = Math.PI / 180;
 var RAD_TO_DEG = 180 / Math.PI;
 var EPSILON = 1e-9;
-/** 向量长度 */
-var length = (v) => Math.hypot(v[0], v[1]);
-/** 归一化（零向量回退 [1, 0]） */
-var normalize = (v) => {
-	const len = length(v);
-	if (len < EPSILON) return [1, 0];
-	return [v[0] / len, v[1] / len];
-};
 /** 二维叉积 a × b */
 var cross = (a, b) => a[0] * b[1] - a[1] * b[0];
-/** 点 + 角度（度）→ 圆周点 */
-var arcPoint = (center, radius, angleDeg) => {
-	const rad = angleDeg * DEG_TO_RAD;
-	return [center[0] + Math.cos(rad) * radius, center[1] + Math.sin(rad) * radius];
-};
 /** 段起点 */
-var segmentStart = (seg) => seg.kind === "line" ? seg.from : arcPoint(seg.center, seg.radius, seg.startAngle);
+var segmentStart = (seg) => seg.kind === "line" ? seg.from : arcEndPoint(seg.center, seg.radius, seg.startAngle);
 /** 段终点 */
-var segmentEnd = (seg) => seg.kind === "line" ? seg.to : arcPoint(seg.center, seg.radius, seg.endAngle);
+var segmentEnd = (seg) => seg.kind === "line" ? seg.to : arcEndPoint(seg.center, seg.radius, seg.endAngle);
 /**
 * 段在某端的「行进切线」单位向量
 * @description atStart=true 取起点处沿行进方向的切线，否则取终点处。line 两端切线相同；
 *   arc 切线垂直于半径，方向随 counterClockwise 翻转（CW: (-sinθ, cosθ)，CCW: (sinθ, -cosθ)）。
 */
 var tangentAt = (seg, atStart) => {
-	if (seg.kind === "line") return normalize([seg.to[0] - seg.from[0], seg.to[1] - seg.from[1]]);
+	if (seg.kind === "line") return point.normalize([seg.to[0] - seg.from[0], seg.to[1] - seg.from[1]]);
 	const rad = (atStart ? seg.startAngle : seg.endAngle) * DEG_TO_RAD;
 	const sign = seg.counterClockwise ? -1 : 1;
-	return normalize([-Math.sin(rad) * sign, Math.cos(rad) * sign]);
+	return point.normalize([-Math.sin(rad) * sign, Math.cos(rad) * sign]);
 };
 /** arc 段的角跨度（带符号：CW 为正递增、CCW 为负），单位度 */
 var arcSpan = (seg) => seg.endAngle - seg.startAngle;
@@ -44,7 +32,7 @@ var fractionAlong = (seg, p, fromStart) => {
 		const ex = seg.to[0] - seg.from[0];
 		const ey = seg.to[1] - seg.from[1];
 		const len2 = ex * ex + ey * ey;
-		if (len2 < EPSILON) return 0;
+		if (len2 < EPSILON * EPSILON) return 0;
 		const t = ((p[0] - seg.from[0]) * ex + (p[1] - seg.from[1]) * ey) / len2;
 		return fromStart ? t : 1 - t;
 	}
@@ -167,9 +155,10 @@ var solveFillet = (segA, segB, r) => {
 			const tInPt = tangentPointOn(segA, cand, radius);
 			const tOutPt = tangentPointOn(segB, cand, radius);
 			if (!tInPt || !tOutPt) continue;
+			const tol = 1e-6 * Math.max(1, radius, Math.abs(corner[0]), Math.abs(corner[1]));
 			const dA = distanceToAny(segA, cand);
 			const dB = distanceToAny(segB, cand);
-			if (Math.abs(dA - radius) > 1e-6 || Math.abs(dB - radius) > 1e-6) continue;
+			if (Math.abs(dA - radius) > tol || Math.abs(dB - radius) > tol) continue;
 			const inFrac = fractionAlong(segA, tInPt, false);
 			const outFrac = fractionAlong(segB, tOutPt, true);
 			if (inFrac < -1e-7 || inFrac > .5000001 || outFrac < -1e-7 || outFrac > .5000001) continue;
@@ -264,7 +253,8 @@ var tangentPointOn = (seg, filletCenter, radius) => {
 			best = cand;
 		}
 	}
-	return bestErr <= 1e-6 ? best : void 0;
+	const tol = 1e-6 * Math.max(1, radius, Math.abs(filletCenter[0]), Math.abs(filletCenter[1]));
+	return bestErr <= tol ? best : void 0;
 };
 /**
 * 对闭合轮廓的每个接缝做 fillet，返回 fillet 解算列表（与接缝一一对应，下标 i = 段 i 终点接段 (i+1)%n 起点）
@@ -287,10 +277,9 @@ var filletContour = (segments, cornerRadius) => {
 *   fillet 出点」走到「本接缝的 fillet 入点」（line 缩短 / arc 裁剪角度），接缝处插 fillet 弧。
 *   夹紧到 0 的角不插弧、按原尖角连接。
 */
-var contourCommands = (segments, cornerRadius) => {
+var contourCommands = (segments, cornerRadius, fillets = filletContour(segments, cornerRadius)) => {
 	const n = segments.length;
 	if (n === 0) return [];
-	const fillets = filletContour(segments, cornerRadius);
 	if (fillets.length === 0) {
 		const cmds = [];
 		segments.forEach((seg, i) => {
@@ -348,17 +337,19 @@ var emitSegmentBody = (seg, start, end, cmds) => {
 };
 /** 调整 endAngle 使「start→end」沿给定扫描方向（ccw: 递减 / 否则递增），保持裁剪后弧方向不变 */
 var alignSweep = (start, end, ccw) => {
-	let e = end;
-	if (ccw) {
-		while (e > start) e -= 360;
-		while (e <= start - 360) e += 360;
-	} else {
-		while (e < start) e += 360;
-		while (e >= start + 360) e -= 360;
-	}
+	const sweep = end - start;
+	if (sweep === 0) return {
+		start,
+		end: start
+	};
+	if (Math.abs(sweep) === 360) return {
+		start,
+		end: start + (ccw ? -360 : 360)
+	};
+	const normalized = (sweep % 360 + 360) % 360;
 	return {
 		start,
-		end: e
+		end: start + (ccw ? normalized === 0 ? -360 : normalized - 360 : normalized === 0 ? 360 : normalized)
 	};
 };
 /**
@@ -367,13 +358,12 @@ var alignSweep = (start, end, ccw) => {
 *   遍历 fillet 后的有效段（缩短 line / 裁剪 arc / fillet arc），对每段求 ray∩段、取最小正参数命中点。
 *   cornerRadius 省略 / ≤0 → 走原尖角轮廓。无命中返回 undefined（调用方兜底）。
 */
-var boundaryFromContour = (segments, cornerRadius, rayOrigin, toward) => {
+var boundaryFromContour = (segments, cornerRadius, rayOrigin, toward, fillets = filletContour(segments, cornerRadius)) => {
 	const dirRaw = [toward[0] - rayOrigin[0], toward[1] - rayOrigin[1]];
-	const dl = length(dirRaw);
+	const dl = point.length(dirRaw);
 	if (dl < 1e-12) return void 0;
 	const dir = [dirRaw[0] / dl, dirRaw[1] / dl];
 	const n = segments.length;
-	const fillets = filletContour(segments, cornerRadius);
 	let best = Infinity;
 	const considerLine = (a, b) => {
 		const ex = b[0] - a[0];
@@ -414,4 +404,4 @@ var boundaryFromContour = (segments, cornerRadius, rayOrigin, toward) => {
 	return [rayOrigin[0] + dir[0] * best, rayOrigin[1] + dir[1] * best];
 };
 //#endregion
-export { boundaryFromContour, contourCommands };
+export { boundaryFromContour, contourCommands, filletContour };

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

@@ -1,6 +1,6 @@
-import { Side } from './_edge';
+import { Side } from './edge';
+import { CompassAnchorValue } from './anchor';
 import { Position } from './point';
-import { RectAnchor } from './rect';
 /** 菱形：中心 + halfA/halfB 半轴长 + 可选旋转；顶点在 (±halfA,0) 与 (0,±halfB) */
 export type Diamond = {
     x: number;
@@ -12,14 +12,20 @@ export type Diamond = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 菱形相关基础工具 */
+/**
+ * 菱形相关基础工具（独立几何原语）
+ * @description 注意：这是一套独立的菱形几何工具，**与 Node 的 diamond shape 不是同一条路径**——
+ *   后者已被 compile 规范化为 `polygon` preset（`{ sides: 4 }`），其 compass anchor 走外接 AABB 角。
+ *   本工具的 NE/NW/SE/SW anchor 取斜边中点（落在真实菱形边上），语义与 polygon 路径不同；
+ *   作为通用几何 API 保留，勿假设它与 Node diamond shape 行为一致。
+ */
 export declare const diamond: {
     /** 中心 */
     center: (d: Diamond) => Position;
     /** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
     contains: (d: Diamond, p: Position) => boolean;
     /** 9 个 anchor：N/S/E/W=顶点，NE/NW/SE/SW=边中点，center=中心 */
-    anchor: (d: Diamond, name: RectAnchor) => Position;
+    anchor: (d: Diamond, name: CompassAnchorValue) => Position;
     /**
      * 从中心向 toward 方向射线与菱形 4 边的交点
      * @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)

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,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"}
+{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAqB,MAAM,QAAQ,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAUxC,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;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAK5C,sDAAsD;gBAC1C,OAAO,QAAQ,kBAAkB,KAAG,QAAQ;IAqC1D;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;IAQvD,yDAAyD;mBAC1C,OAAO,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CASzD,CAAC"}

package/dist/es/geometry/diamond.js

@@ -1,5 +1,5 @@
-import { localToWorld, worldToLocal } from "./_transform.js";
-import { polylineViaVertex } from "./_edge.js";
+import { polylineViaVertex } from "./edge.js";
+import { localToWorld, worldToLocal } from "./transform.js";
 //#region src/geometry/diamond.ts
 /** 每条 side 的过顶点折线三 anchor：[邻边中点, cardinal 顶点, 邻边中点]（方向 north/south=西→东、east/west=北→南） */
 var DIAMOND_EDGE = {
@@ -24,12 +24,19 @@ var DIAMOND_EDGE = {
 		"south-west"
 	]
 };
-/** 菱形相关基础工具 */
+/**
+* 菱形相关基础工具（独立几何原语）
+* @description 注意：这是一套独立的菱形几何工具，**与 Node 的 diamond shape 不是同一条路径**——
+*   后者已被 compile 规范化为 `polygon` preset（`{ sides: 4 }`），其 compass anchor 走外接 AABB 角。
+*   本工具的 NE/NW/SE/SW anchor 取斜边中点（落在真实菱形边上），语义与 polygon 路径不同；
+*   作为通用几何 API 保留，勿假设它与 Node diamond shape 行为一致。
+*/
 var diamond = {
 	/** 中心 */
 	center: (d) => [d.x, d.y],
 	/** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
 	contains: (d, p) => {
+		if (d.halfA === 0 || d.halfB === 0) return false;
 		const [lx, ly] = worldToLocal(d, p);
 		return Math.abs(lx) / d.halfA + Math.abs(ly) / d.halfB <= 1.000000001;
 	},
@@ -75,6 +82,7 @@ var diamond = {
 	* @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)
 	*/
 	boundaryPoint: (d, toward) => {
+		if (d.halfA === 0 || d.halfB === 0) return [d.x, d.y];
 		const [lx, ly] = worldToLocal(d, toward);
 		const denom = Math.abs(lx) / d.halfA + Math.abs(ly) / d.halfB;
 		if (denom === 0) return [d.x, d.y];

package/dist/{lib/geometry/_edge.d.ts → es/geometry/edge.d.ts}

@@ -26,4 +26,4 @@ export declare const edgeAngleDeg: (side: Side, t: number) => number;
  *   p0/p1 为相邻边中点 anchor、vertex 为 cardinal 顶点 anchor——全落真实斜边
  */
 export declare const polylineViaVertex: (p0: Position, vertex: Position, p1: Position, t: number) => Position;
-//# sourceMappingURL=_edge.d.ts.map
+//# 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":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,0DAA0D;AAC1D,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;CAK8D,CAAC;AAErF,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 → edge.js}

@@ -1,4 +1,4 @@
-//#region src/geometry/_edge.ts
+//#region src/geometry/edge.ts
 /**
 * rect 四直边 t=0 / t=1 端点对应的角 anchor
 * @description 方向约定单一真源：north/south = 西→东（t=0 在 west 端），east/west = 北→南（t=0 在 north 端）。

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

@@ -1,6 +1,6 @@
-import { Side } from './_edge';
+import { Side } from './edge';
+import { CompassAnchorValue } from './anchor';
 import { Position } from './point';
-import { RectAnchor } from './rect';
 /** 椭圆：中心 + 半长轴 rx / 半短轴 ry + 可选旋转 */
 export type Ellipse = {
     x: number;
@@ -22,7 +22,7 @@ export declare const ellipse: {
      * 9 个 anchor 的世界坐标
      * @description 对角（NE/NW/SE/SW）取参数曲线 t=π/4 处 (rx/√2, ry/√2)，与 TikZ 椭圆 anchor 参数等分约定一致
      */
-    anchor: (e: Ellipse, name: RectAnchor) => Position;
+    anchor: (e: Ellipse, name: CompassAnchorValue) => Position;
     /**
      * 从中心向 toward 方向射线与椭圆交点
      * @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)

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,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"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,QAAQ,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,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;IAK9C;;;OAGG;gBACW,OAAO,QAAQ,kBAAkB,KAAG,QAAQ;IAqC1D;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;IASvD,qDAAqD;mBACtC,OAAO,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAIzD,CAAC"}

package/dist/es/geometry/ellipse.js

@@ -1,5 +1,5 @@
-import { localToWorld, worldToLocal } from "./_transform.js";
-import { edgeAngleDeg } from "./_edge.js";
+import { edgeAngleDeg } from "./edge.js";
+import { localToWorld, worldToLocal } from "./transform.js";
 //#region src/geometry/ellipse.ts
 var DEG_TO_RAD = Math.PI / 180;
 var SQRT_HALF = Math.SQRT1_2;
@@ -9,6 +9,7 @@ var ellipse = {
 	center: (e) => [e.x, e.y],
 	/** 判断点是否在椭圆内（含边界，考虑旋转） */
 	contains: (e, p) => {
+		if (e.rx === 0 || e.ry === 0) return false;
 		const [lx, ly] = worldToLocal(e, p);
 		return lx * lx / (e.rx * e.rx) + ly * ly / (e.ry * e.ry) <= 1;
 	},
@@ -57,6 +58,7 @@ var ellipse = {
 	* @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)
 	*/
 	boundaryPoint: (e, toward) => {
+		if (e.rx === 0 || e.ry === 0) return [e.x, e.y];
 		const [lx, ly] = worldToLocal(e, toward);
 		if (lx === 0 && ly === 0) return [e.x, e.y];
 		const a = lx / e.rx;

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

@@ -1,4 +1,5 @@
 export * from './point';
+export * from './anchor';
 export * from './rect';
 export * from './circle';
 export * from './ellipse';
@@ -7,5 +8,9 @@ export * from './polar';
 export * from './bend';
 export * from './arc';
 export * from './segment';
-export * from './roundedContour';
+export * from './contour';
+export { EDGE_ENDS, lerpPoint, edgeAngleDeg, polylineViaVertex } from './edge';
+export type { Side } from './edge';
+export { localToWorld, worldToLocal } from './transform';
+export type { CenteredShape } from './transform';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC/E,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

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

@@ -9,6 +9,12 @@ export declare const point: {
     sub: (a: Position, b: Position) => Position;
     /** 等比缩放 a * k */
     scale: (a: Position, k: number) => Position;
+    /** 向量长度 */
+    length: (a: Position) => number;
+    /** 归一化向量；零长度 / 极短向量回退到 fallback */
+    normalize: (a: Position, fallback?: Position, epsilon?: number) => Position;
+    /** 把点 p 沿 target 方向移动 dist */
+    shiftToward: (p: Position, target: Position, dist: number) => Position;
     /** 两点精确相等（不带容差） */
     equal: (a: Position, b: Position) => boolean;
     /** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */

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

@@ -1 +1 @@
-{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../src/geometry/point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,SAAS,CAAC;AAEpD,oBAAoB;AACpB,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAIxC,wBAAwB;AACxB,eAAO,MAAM,KAAK;IAChB,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,iBAAiB;eACN,QAAQ,KAAK,MAAM,KAAG,QAAQ;IACzC,mBAAmB;eACR,QAAQ,KAAK,QAAQ,KAAG,OAAO;IAC1C,oDAAoD;iBACvC,QAAQ,KAAG,aAAa;IAIrC;;;;;OAKG;oBAEE,QAAQ,GAAG,aAAa,KACxB,QAAQ,GAAG,aAAa,yBAE1B,OAAO;CASX,CAAC"}
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../src/geometry/point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,SAAS,CAAC;AAEpD,oBAAoB;AACpB,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAKxC,wBAAwB;AACxB,eAAO,MAAM,KAAK;IAChB,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,iBAAiB;eACN,QAAQ,KAAK,MAAM,KAAG,QAAQ;IACzC,WAAW;gBACC,QAAQ,KAAG,MAAM;IAC7B,mCAAmC;mBAE9B,QAAQ,aACD,QAAQ,uBAEjB,QAAQ;IAKX,8BAA8B;qBACb,QAAQ,UAAU,QAAQ,QAAQ,MAAM,KAAG,QAAQ;IAOpE,mBAAmB;eACR,QAAQ,KAAK,QAAQ,KAAG,OAAO;IAC1C,oDAAoD;iBACvC,QAAQ,KAAG,aAAa;IAIrC;;;;;OAKG;oBAEE,QAAQ,GAAG,aAAa,KACxB,QAAQ,GAAG,aAAa,yBAE1B,OAAO;CASX,CAAC"}

package/dist/es/geometry/point.js

@@ -1,6 +1,7 @@
 import { polar } from "./polar.js";
 //#region src/geometry/point.ts
 var RAD_TO_DEG = 180 / Math.PI;
+var DEFAULT_EPSILON = 1e-9;
 /** 二维向量 / 坐标的基础运算工具集 */
 var point = {
 	/** 向量加 a + b */
@@ -9,6 +10,22 @@ var point = {
 	sub: (a, b) => [a[0] - b[0], a[1] - b[1]],
 	/** 等比缩放 a * k */
 	scale: (a, k) => [a[0] * k, a[1] * k],
+	/** 向量长度 */
+	length: (a) => Math.hypot(a[0], a[1]),
+	/** 归一化向量；零长度 / 极短向量回退到 fallback */
+	normalize: (a, fallback = [1, 0], epsilon = DEFAULT_EPSILON) => {
+		const len = Math.hypot(a[0], a[1]);
+		if (len < epsilon) return fallback;
+		return [a[0] / len, a[1] / len];
+	},
+	/** 把点 p 沿 target 方向移动 dist */
+	shiftToward: (p, target, dist) => {
+		if (dist === 0) return p;
+		const delta = [target[0] - p[0], target[1] - p[1]];
+		const dir = point.normalize(delta, [0, 0]);
+		if (point.equal(dir, [0, 0])) return p;
+		return [p[0] + dir[0] * dist, p[1] + dir[1] * dist];
+	},
 	/** 两点精确相等（不带容差） */
 	equal: (a, b) => a[0] === b[0] && a[1] === b[1],
 	/** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */

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

@@ -1,4 +1,5 @@
-import { Side } from './_edge';
+import { Side } from './edge';
+import { CompassAnchorValue } from './anchor';
 import { Position } from './point';
 /** 轴对齐矩形：几何中心 + 宽高 + 可选绕中心旋转 */
 export type Rect = {
@@ -9,27 +10,13 @@ export type Rect = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 矩形 9 个标准 anchor 名常量（与 RectAnchor 配对，用 RECT_ANCHORS.NORTH 避免拼错） */
-export declare const RECT_ANCHORS: {
-    readonly CENTER: "center";
-    readonly NORTH: "north";
-    readonly SOUTH: "south";
-    readonly EAST: "east";
-    readonly WEST: "west";
-    readonly NORTH_EAST: "north-east";
-    readonly NORTH_WEST: "north-west";
-    readonly SOUTH_EAST: "south-east";
-    readonly SOUTH_WEST: "south-west";
-};
-/** 矩形 anchor 名（与 TikZ 命名一致） */
-export type RectAnchor = (typeof RECT_ANCHORS)[keyof typeof RECT_ANCHORS];
 export declare const rect: {
     /** 几何中心 */
     center: (r: Rect) => Position;
     /** 点是否在矩形内（含边界，含旋转） */
     contains: (r: Rect, p: Position) => boolean;
-    /** 9 个 anchor 之一的世界坐标（含旋转），TikZ 命名 */
-    anchor: (r: Rect, name: RectAnchor) => Position;
+    /** 9 个标准方位 anchor 之一的世界坐标（含旋转），TikZ 命名 */
+    anchor: (r: Rect, name: CompassAnchorValue) => Position;
     /** 从中心向 toward 方向射线与矩形边界交点（含旋转），Path 端点贴 Node 边界用 */
     boundaryPoint: (r: Rect, toward: Position) => Position;
     /** 边上比例点：side 直边 t∈[0,1] 处（两角 anchor 线性插值，含旋转）；方向见 EDGE_ENDS */

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

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,IAAI,EAAa,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,eAAO,MAAM,IAAI;IACf,WAAW;gBACC,IAAI,KAAG,QAAQ;IAC3B,uBAAuB;kBACT,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC,sCAAsC;gBAC1B,IAAI,QAAQ,UAAU,KAAG,QAAQ;IAuC7C,qDAAqD;uBAClC,IAAI,UAAU,QAAQ,KAAG,QAAQ;IAUpD,gEAAgE;mBACjD,IAAI,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAItD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,eAAe,MAAM,KACpB,KAAK,CAAC,aAAa,CAgCrB,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,IAAI,EAAa,MAAM,QAAQ,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,IAAI;IACf,WAAW;gBACC,IAAI,KAAG,QAAQ;IAC3B,uBAAuB;kBACT,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC,0CAA0C;gBAC9B,IAAI,QAAQ,kBAAkB,KAAG,QAAQ;IAuCrD,qDAAqD;uBAClC,IAAI,UAAU,QAAQ,KAAG,QAAQ;IAUpD,gEAAgE;mBACjD,IAAI,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAItD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,eAAe,MAAM,KACpB,KAAK,CAAC,aAAa,CAgCrB,CAAC"}

package/dist/es/geometry/rect.js

@@ -1,18 +1,6 @@
-import { localToWorld, worldToLocal } from "./_transform.js";
-import { EDGE_ENDS, lerpPoint } from "./_edge.js";
+import { EDGE_ENDS, lerpPoint } from "./edge.js";
+import { localToWorld, worldToLocal } from "./transform.js";
 //#region src/geometry/rect.ts
-/** 矩形 9 个标准 anchor 名常量（与 RectAnchor 配对，用 RECT_ANCHORS.NORTH 避免拼错） */
-var RECT_ANCHORS = {
-	CENTER: "center",
-	NORTH: "north",
-	SOUTH: "south",
-	EAST: "east",
-	WEST: "west",
-	NORTH_EAST: "north-east",
-	NORTH_WEST: "north-west",
-	SOUTH_EAST: "south-east",
-	SOUTH_WEST: "south-west"
-};
 var rect = {
 	/** 几何中心 */
 	center: (r) => [r.x, r.y],
@@ -23,7 +11,7 @@ var rect = {
 		const halfH = r.height / 2;
 		return lx >= -halfW && lx <= halfW && ly >= -halfH && ly <= halfH;
 	},
-	/** 9 个 anchor 之一的世界坐标（含旋转），TikZ 命名 */
+	/** 9 个标准方位 anchor 之一的世界坐标（含旋转），TikZ 命名 */
 	anchor: (r, name) => {
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
@@ -163,4 +151,4 @@ var rectOutline = (from, to, cornerRadius) => {
 	];
 };
 //#endregion
-export { RECT_ANCHORS, rect, rectOutline };
+export { rect, rectOutline };

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

@@ -34,4 +34,11 @@ export declare const ellipseArcSegmentSample: (center: Position, rx: number, ry:
 export declare const circleSegmentSample: (center: Position, radius: number, t: number) => SegmentSample;
 /** 整椭圆，参数化 (rx·cos(2πt), ry·sin(2πt)) */
 export declare const ellipseSegmentSample: (center: Position, rx: number, ry: number, t: number) => SegmentSample;
+/**
+ * 矩形周长段：两对角 → 闭合周长上 t∈[0,1] 的点 / 切线
+ * @description 4 条边按 rectOutline 的顺时针绕向（y-down：左上→右上→右下→左下→闭合回左上）均分参数，
+ *   每条边占 1/4 t；切线 = 该边方向。忽略 cornerRadius（采尖角折线周长），mark 落在直边上精确、
+ *   贴近圆角处略偏轮廓——对中段 marking 足够。退化（零宽 / 零高）由 lineSegmentSample 的零切线回退兜底。
+ */
+export declare const rectPerimeterSample: (from: Position, to: Position, t: number) => SegmentSample;
 //# sourceMappingURL=segment.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAiBxC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAQF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,GAClC,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aASF,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aASF,CAAC"}
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,SAAS,CAAC;AAiB3D;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAqBF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAAwF,CAAC;AAE5F,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,GAClC,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAAgF,CAAC;AAEpF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aAAoE,CAAC;AAExE,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aAA4D,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAkBF,CAAC"}

package/dist/es/geometry/segment.js

@@ -1,14 +1,20 @@
+import { point } from "./point.js";
 //#region src/geometry/segment.ts
 var DEG_TO_RAD = Math.PI / 180;
-var normalize = (v) => {
-	const len = Math.hypot(v[0], v[1]);
-	if (len === 0) return [1, 0];
-	return [v[0] / len, v[1] / len];
+var sampleEllipseArc = (center, rx, ry, startAngleDeg, endAngleDeg, t) => {
+	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
+	const cos = Math.cos(rad);
+	const sin = Math.sin(rad);
+	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
+	return {
+		point: [center[0] + rx * cos, center[1] + ry * sin],
+		tangent: point.normalize([-rx * sin * sweepSign, ry * cos * sweepSign])
+	};
 };
 /** 直线段 from → to */
 var lineSegmentSample = (from, to, t) => ({
 	point: [from[0] + (to[0] - from[0]) * t, from[1] + (to[1] - from[1]) * t],
-	tangent: normalize([to[0] - from[0], to[1] - from[1]])
+	tangent: point.normalize([to[0] - from[0], to[1] - from[1]])
 });
 /**
 * 二次贝塞尔 from → control → to
@@ -16,9 +22,12 @@ var lineSegmentSample = (from, to, t) => ({
 */
 var quadSegmentSample = (from, control, to, t) => {
 	const u = 1 - t;
+	const point$1 = [u * u * from[0] + 2 * u * t * control[0] + t * t * to[0], u * u * from[1] + 2 * u * t * control[1] + t * t * to[1]];
+	const tx = 2 * u * (control[0] - from[0]) + 2 * t * (to[0] - control[0]);
+	const ty = 2 * u * (control[1] - from[1]) + 2 * t * (to[1] - control[1]);
 	return {
-		point: [u * u * from[0] + 2 * u * t * control[0] + t * t * to[0], u * u * from[1] + 2 * u * t * control[1] + t * t * to[1]],
-		tangent: normalize([2 * u * (control[0] - from[0]) + 2 * t * (to[0] - control[0]), 2 * u * (control[1] - from[1]) + 2 * t * (to[1] - control[1])])
+		point: point$1,
+		tangent: point.normalize([tx, ty])
 	};
 };
 /**
@@ -27,9 +36,12 @@ var quadSegmentSample = (from, control, to, t) => {
 */
 var cubicSegmentSample = (from, c1, c2, to, t) => {
 	const u = 1 - t;
+	const point$2 = [u * u * u * from[0] + 3 * u * u * t * c1[0] + 3 * u * t * t * c2[0] + t * t * t * to[0], u * u * u * from[1] + 3 * u * u * t * c1[1] + 3 * u * t * t * c2[1] + t * t * t * to[1]];
+	const tx = 3 * u * u * (c1[0] - from[0]) + 6 * u * t * (c2[0] - c1[0]) + 3 * t * t * (to[0] - c2[0]);
+	const ty = 3 * u * u * (c1[1] - from[1]) + 6 * u * t * (c2[1] - c1[1]) + 3 * t * t * (to[1] - c2[1]);
 	return {
-		point: [u * u * u * from[0] + 3 * u * u * t * c1[0] + 3 * u * t * t * c2[0] + t * t * t * to[0], u * u * u * from[1] + 3 * u * u * t * c1[1] + 3 * u * t * t * c2[1] + t * t * t * to[1]],
-		tangent: normalize([3 * u * u * (c1[0] - from[0]) + 6 * u * t * (c2[0] - c1[0]) + 3 * t * t * (to[0] - c2[0]), 3 * u * u * (c1[1] - from[1]) + 6 * u * t * (c2[1] - c1[1]) + 3 * t * t * (to[1] - c2[1])])
+		point: point$2,
+		tangent: point.normalize([tx, ty])
 	};
 };
 /**
@@ -41,46 +53,35 @@ var foldSegmentSample = (from, corner, to, t) => {
 	return lineSegmentSample(corner, to, t * 2 - 1);
 };
 /** 弧段（角度度数，与 ir/path arc 同约定）；切线沿扫描方向：endAngle ≥ start 取 (-sin,cos)，否则反向 */
-var arcSegmentSample = (center, radius, startAngleDeg, endAngleDeg, t) => {
-	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
-	return {
-		point: [center[0] + radius * cos, center[1] + radius * sin],
-		tangent: normalize([-sin * sweepSign, cos * sweepSign])
-	};
-};
+var arcSegmentSample = (center, radius, startAngleDeg, endAngleDeg, t) => sampleEllipseArc(center, radius, radius, startAngleDeg, endAngleDeg, t);
 /** 椭圆弧段（参数角度数，与 ir/path arc 同约定）；点用 (rx·cos, ry·sin)，切线沿扫描方向 */
-var ellipseArcSegmentSample = (center, rx, ry, startAngleDeg, endAngleDeg, t) => {
-	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
-	return {
-		point: [center[0] + rx * cos, center[1] + ry * sin],
-		tangent: normalize([-rx * sin * sweepSign, ry * cos * sweepSign])
-	};
-};
+var ellipseArcSegmentSample = (center, rx, ry, startAngleDeg, endAngleDeg, t) => sampleEllipseArc(center, rx, ry, startAngleDeg, endAngleDeg, t);
 /** 整圆，从 0°(east) 开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致 */
-var circleSegmentSample = (center, radius, t) => {
-	const rad = t * 360 * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	return {
-		point: [center[0] + radius * cos, center[1] + radius * sin],
-		tangent: normalize([-sin, cos])
-	};
-};
+var circleSegmentSample = (center, radius, t) => sampleEllipseArc(center, radius, radius, 0, 360, t);
 /** 整椭圆，参数化 (rx·cos(2πt), ry·sin(2πt)) */
-var ellipseSegmentSample = (center, rx, ry, t) => {
-	const rad = t * 360 * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	return {
-		point: [center[0] + rx * cos, center[1] + ry * sin],
-		tangent: normalize([-rx * sin, ry * cos])
-	};
+var ellipseSegmentSample = (center, rx, ry, t) => sampleEllipseArc(center, rx, ry, 0, 360, t);
+/**
+* 矩形周长段：两对角 → 闭合周长上 t∈[0,1] 的点 / 切线
+* @description 4 条边按 rectOutline 的顺时针绕向（y-down：左上→右上→右下→左下→闭合回左上）均分参数，
+*   每条边占 1/4 t；切线 = 该边方向。忽略 cornerRadius（采尖角折线周长），mark 落在直边上精确、
+*   贴近圆角处略偏轮廓——对中段 marking 足够。退化（零宽 / 零高）由 lineSegmentSample 的零切线回退兜底。
+*/
+var rectPerimeterSample = (from, to, t) => {
+	const x0 = Math.min(from[0], to[0]);
+	const x1 = Math.max(from[0], to[0]);
+	const y0 = Math.min(from[1], to[1]);
+	const y1 = Math.max(from[1], to[1]);
+	const corners = [
+		[x0, y0],
+		[x1, y0],
+		[x1, y1],
+		[x0, y1],
+		[x0, y0]
+	];
+	const scaled = (t <= 0 ? 0 : t >= 1 ? 1 : t) * 4;
+	const edge = Math.min(Math.floor(scaled), 3);
+	const localT = scaled - edge;
+	return lineSegmentSample(corners[edge], corners[edge + 1], localT);
 };
 //#endregion
-export { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseArcSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample };
+export { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseArcSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample, rectPerimeterSample };

package/dist/{lib/geometry/_transform.d.ts → es/geometry/transform.d.ts}

@@ -18,4 +18,4 @@ export declare const localToWorld: (s: CenteredShape, local: Position) => Positi
  * @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
  */
 export declare const worldToLocal: (s: CenteredShape, world: Position) => Position;
-//# sourceMappingURL=_transform.d.ts.map
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/geometry/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,OAAO,QAAQ,KAAG,QAShE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,OAAO,QAAQ,KAAG,QAQhE,CAAC"}

package/dist/es/geometry/{_transform.js → transform.js}

@@ -1,4 +1,4 @@
-//#region src/geometry/_transform.ts
+//#region src/geometry/transform.ts
 /**
 * 本地坐标（以中心为原点）→ 世界坐标
 * @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移