@retikz/core 0.1.0-alpha.3 → 0.1.0-alpha.5

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

@@ -1,9 +1,8 @@
-import { IRPosition, PolarPosition } from '../ir';
+import { IRAtPosition, IROffsetPosition, IRPosition, PolarPosition } from '../ir';
 import { NodeLayout } from './node';
 /**
- * 把 IR 里出现的位置形态（笛卡尔 / 极坐标 / 节点 id）解析为笛卡尔位置。
- * 极坐标的 origin 可递归 / 可引用节点 id；按节点定义顺序处理（前向引用要求节点先定义）。
- * 解析失败返回 null（如引用了未定义节点）。
+ * IR 各种位置形态（笛卡尔/极坐标/相对定位/偏移定位/节点 id）→ 笛卡尔位置
+ * @description 极坐标 origin / 偏移定位 of 均可递归引用节点 id 或字面坐标；relative `AtPosition` of 必须引用已定义节点/coordinate；解析失败返回 null。nodeDistance 为容器 prop 注入默认距离，AtPosition 自带 distance 优先
  */
-export declare const resolvePosition: (pos: IRPosition | PolarPosition | string, nodeMap: Map<string, NodeLayout>) => IRPosition | null;
+export declare const resolvePosition: (pos: IRPosition | PolarPosition | IRAtPosition | IROffsetPosition | string, nodeMap: Map<string, NodeLayout>, nodeDistance?: number) => IRPosition | null;
 //# sourceMappingURL=position.d.ts.map

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,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,UAAU,GAAG,aAAa,GAAG,MAAM,EACxC,SAAS,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KAC/B,UAAU,GAAG,IAoBf,CAAC"}
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/compile/position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACpG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAoBzC;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,GAAG,MAAM,EAC1E,SAAS,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,eAAc,MAA8B,KAC3C,UAAU,GAAG,IAkCf,CAAC"}

package/dist/es/compile/position.js

@@ -1,19 +1,46 @@
 //#region src/compile/position.ts
+/** 默认相对定位距离（CompileOptions.nodeDistance 未配时使用） */
+var DEFAULT_NODE_DISTANCE = 1;
 /**
-* 把 IR 里出现的位置形态（笛卡尔 / 极坐标 / 节点 id）解析为笛卡尔位置。
-* 极坐标的 origin 可递归 / 可引用节点 id；按节点定义顺序处理（前向引用要求节点先定义）。
-* 解析失败返回 null（如引用了未定义节点）。
+* 8 方向 → 屏幕坐标系（y 向下）单位向量
+* @description above=视觉上方 (y 减小)；4 对角分量 1/√2 保证斜向与水平/垂直距离等长（对角点落在半径=distance 圆周上）
 */
-var resolvePosition = (pos, nodeMap) => {
+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 极坐标 origin / 偏移定位 of 均可递归引用节点 id 或字面坐标；relative `AtPosition` of 必须引用已定义节点/coordinate；解析失败返回 null。nodeDistance 为容器 prop 注入默认距离，AtPosition 自带 distance 优先
+*/
+var resolvePosition = (pos, nodeMap, nodeDistance = DEFAULT_NODE_DISTANCE) => {
 	if (typeof pos === "string") {
 		const node = nodeMap.get(pos);
 		return node ? [node.rect.x, node.rect.y] : null;
 	}
 	if (Array.isArray(pos)) return pos;
+	if ("direction" in pos) {
+		const ref = nodeMap.get(pos.of);
+		if (!ref) return null;
+		const distance = pos.distance ?? nodeDistance;
+		const [dx, dy] = DIRECTION_VECTOR[pos.direction];
+		return [ref.rect.x + dx * distance, ref.rect.y + dy * distance];
+	}
+	if ("offset" in pos) {
+		const base = resolvePosition(pos.of, nodeMap, nodeDistance);
+		if (!base) return null;
+		return [base[0] + pos.offset[0], base[1] + pos.offset[1]];
+	}
 	let origin;
 	if (!pos.origin) origin = [0, 0];
 	else {
-		const resolved = resolvePosition(pos.origin, nodeMap);
+		const resolved = resolvePosition(pos.origin, nodeMap, nodeDistance);
 		if (!resolved) return null;
 		origin = resolved;
 	}

package/dist/es/compile/text-metrics.d.ts

@@ -21,10 +21,8 @@ export type TextMetrics = {
     descent?: number;
 };
 /**
- * 文字度量函数接口（编译期由 adapter 注入）。
- * - @retikz/react：用 canvas measureText
- * - @retikz/ssr：用 opentype.js / fontkit
- * - @retikz/canvas：用 ctx.measureText
+ * 文字度量函数接口（编译期由 adapter 注入）
+ * @description @retikz/react: canvas measureText；@retikz/ssr: opentype.js/fontkit；@retikz/canvas: ctx.measureText
  */
 export type TextMeasurer = (text: string, font: FontSpec) => TextMetrics;
 /** 默认 fallback 度量：基于平均字宽估算，不准但保证可运行 */

package/dist/es/compile/text-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../../src/compile/text-metrics.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAEzE,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,YAG7B,CAAC"}
+{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../../src/compile/text-metrics.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAEzE,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,YAG7B,CAAC"}

package/dist/es/compile/view-box.d.ts

@@ -1,8 +1,5 @@
 import { IRPosition } from '../ir';
 import { ViewBox } from '../primitive';
-/**
- * 由所有"贡献给 bbox"的点算出 viewBox（含四周 padding）。
- * points 为空时返回固定的 100×100 兜底框。
- */
+/** 由所有 bbox 候选点算出 viewBox（含 padding）；points 为空时返回 100×100 兜底 */
 export declare const computeViewBox: (points: Array<IRPosition>, padding: number, round: (n: number) => number) => ViewBox;
 //# sourceMappingURL=view-box.d.ts.map

package/dist/es/compile/view-box.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-box.d.ts","sourceRoot":"","sources":["../../../src/compile/view-box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,KAAK,CAAC,UAAU,CAAC,EACzB,SAAS,MAAM,EACf,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,OAkBF,CAAC"}
+{"version":3,"file":"view-box.d.ts","sourceRoot":"","sources":["../../../src/compile/view-box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,gEAAgE;AAChE,eAAO,MAAM,cAAc,GACzB,QAAQ,KAAK,CAAC,UAAU,CAAC,EACzB,SAAS,MAAM,EACf,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,OAkBF,CAAC"}

package/dist/es/compile/view-box.js

@@ -1,8 +1,5 @@
 //#region src/compile/view-box.ts
-/**
-* 由所有"贡献给 bbox"的点算出 viewBox（含四周 padding）。
-* points 为空时返回固定的 100×100 兜底框。
-*/
+/** 由所有 bbox 候选点算出 viewBox（含 padding）；points 为空时返回 100×100 兜底 */
 var computeViewBox = (points, padding, round) => {
 	if (points.length === 0) return {
 		x: 0,

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

@@ -1,34 +1,9 @@
 import { Position } from './point';
-/**
- * 给定圆心、半径、角度（度，与 polar.toPosition 同约定），返回圆周上对应点。
- */
+/** 圆心、半径、角度（度，与 polar.toPosition 同约定）→ 圆周上对应点 */
 export declare const arcEndPoint: (center: Position, radius: number, angleDeg: number) => Position;
 /**
- * 计算 SVG `<path>` A 命令需要的 large-arc-flag 与 sweep-flag。
- *
- * - `largeArc`：弧跨度 `|endAngle - startAngle|` 严格大于 180° 时为 1。
- * - `sweep`：`endAngle >= startAngle` 时为 1，否则为 0；与"角度增加方向 = 在
- *   SVG 屏幕上视觉顺时针"一致——因为我们投影时未翻转 y，SVG sweep=1（屏幕 CW）
- *   恰好等价 math 角度增加。
- *
- * 边界：`|Δ|=180°` 时 `largeArc=0`（半弧不算大弧）；恰好同点 `|Δ|=0` 也返回 0。
- */
-export declare const arcSvgFlags: (startAngleDeg: number, endAngleDeg: number) => {
-    largeArc: 0 | 1;
-    sweep: 0 | 1;
-};
-/**
- * 弧的 bounding box 极值候选点：起点、终点，以及 `[startAngle, endAngle]` 区间
- * 里所有 90°·k 的基本方向（0°、90°、180°、270° 及其周期延拓）对应的圆周点。
- *
- * 这些点是计算视图框（viewBox）/ bbox 时必须考虑的候选——因为弧线投影到 x/y
- * 轴的极值只可能在弧端点或圆周上的轴向四点处出现。
- *
- * 说明：
- * - 接受 `endAngle < startAngle`（CW math 方向）：以 `min..max` 区间扫描 90°·k；
- *   语义上是"无论扫描方向，此弧覆盖到的角度区间内的基本方向都算极值候选"。
- * - 跨 360°（如 270° → 450°）也按数值区间处理，正确收录中间穿越的 0°、90° 等。
- * - 不去重：若起点恰好落在 90°·k 上会同时出现两次，调用方根据需要再处理。
+ * 弧的 bbox 极值候选：起点、终点，加 [startAngle,endAngle] 内所有 90°·k 方向的圆周点
+ * @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>;
 //# 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;AAkBxC;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GACtB,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB;IAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;CAMjC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAmBhB,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"}

package/dist/es/geometry/arc.js

@@ -1,40 +1,13 @@
 //#region src/geometry/arc.ts
 var DEG_TO_RAD = Math.PI / 180;
-/**
-* 给定圆心、半径、角度（度，与 polar.toPosition 同约定），返回圆周上对应点。
-*/
+/** 圆心、半径、角度（度，与 polar.toPosition 同约定）→ 圆周上对应点 */
 var arcEndPoint = (center, radius, angleDeg) => {
 	const rad = angleDeg * DEG_TO_RAD;
 	return [center[0] + Math.cos(rad) * radius, center[1] + Math.sin(rad) * radius];
 };
 /**
-* 计算 SVG `<path>` A 命令需要的 large-arc-flag 与 sweep-flag。
-*
-* - `largeArc`：弧跨度 `|endAngle - startAngle|` 严格大于 180° 时为 1。
-* - `sweep`：`endAngle >= startAngle` 时为 1，否则为 0；与"角度增加方向 = 在
-*   SVG 屏幕上视觉顺时针"一致——因为我们投影时未翻转 y，SVG sweep=1（屏幕 CW）
-*   恰好等价 math 角度增加。
-*
-* 边界：`|Δ|=180°` 时 `largeArc=0`（半弧不算大弧）；恰好同点 `|Δ|=0` 也返回 0。
-*/
-var arcSvgFlags = (startAngleDeg, endAngleDeg) => {
-	return {
-		largeArc: Math.abs(endAngleDeg - startAngleDeg) > 180 ? 1 : 0,
-		sweep: endAngleDeg >= startAngleDeg ? 1 : 0
-	};
-};
-/**
-* 弧的 bounding box 极值候选点：起点、终点，以及 `[startAngle, endAngle]` 区间
-* 里所有 90°·k 的基本方向（0°、90°、180°、270° 及其周期延拓）对应的圆周点。
-*
-* 这些点是计算视图框（viewBox）/ bbox 时必须考虑的候选——因为弧线投影到 x/y
-* 轴的极值只可能在弧端点或圆周上的轴向四点处出现。
-*
-* 说明：
-* - 接受 `endAngle < startAngle`（CW math 方向）：以 `min..max` 区间扫描 90°·k；
-*   语义上是"无论扫描方向，此弧覆盖到的角度区间内的基本方向都算极值候选"。
-* - 跨 360°（如 270° → 450°）也按数值区间处理，正确收录中间穿越的 0°、90° 等。
-* - 不去重：若起点恰好落在 90°·k 上会同时出现两次，调用方根据需要再处理。
+* 弧的 bbox 极值候选：起点、终点，加 [startAngle,endAngle] 内所有 90°·k 方向的圆周点
+* @description 弧投影到 x/y 轴的极值只可能在弧端点或圆周轴向四点出现。endAngle < startAngle 时按 min..max 扫描；跨 360°（270→450）按数值区间正确处理；不去重——端角恰在 90°·k 上时调用方处理
 */
 var arcBoundingPoints = (center, radius, startAngleDeg, endAngleDeg) => {
 	const points = [arcEndPoint(center, radius, startAngleDeg), arcEndPoint(center, radius, endAngleDeg)];
@@ -50,4 +23,4 @@ var arcBoundingPoints = (center, radius, startAngleDeg, endAngleDeg) => {
 	return points;
 };
 //#endregion
-export { arcBoundingPoints, arcEndPoint, arcSvgFlags };
+export { arcBoundingPoints, arcEndPoint };

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

@@ -1,18 +1,7 @@
 import { Position } from './point';
 /**
- * 用 cubic Bezier 拟合 from→to 的弧形 bend。
- *
- * 算法（ADR-0001）：
- * 1. apex offset = chord × tan(bendAngle / 2)（沿 path 法向 left / right 偏移量）
- * 2. 控制点取 chord 1/3 / 2/3 处沿法向偏移；为让 cubic 在 t=0.5 处穿过 apex，
- *    控制点 offset = (4/3) × apex offset（推导：B(0.5) = midpoint + (3/4)·s·n）
- *
- * 法向定义（SVG y 向下，"left/right" 按视觉，不按数学）：
- *   chord direction = (dx, dy) / |chord|
- *   visual-left normal  =  ( dy, -dx) / |chord|   （从 from 看向 to，向左偏）
- *   visual-right normal =  (-dy,  dx) / |chord|
- *
- * chord 长度为 0 时无方向可推，两个控制点都返回 from。
+ * cubic Bezier 拟合 from→to 的弧形 bend
+ * @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向 SVG y-down：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
  */
 export declare const bendControlPoints: (from: Position, to: Position, direction: "left" | "right", bendAngle: number) => [Position, Position];
 //# sourceMappingURL=bend.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bend.d.ts","sourceRoot":"","sources":["../../../src/geometry/bend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,WAAW,MAAM,GAAG,OAAO,EAC3B,WAAW,MAAM,KAChB,CAAC,QAAQ,EAAE,QAAQ,CAgBrB,CAAC"}
+{"version":3,"file":"bend.d.ts","sourceRoot":"","sources":["../../../src/geometry/bend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,WAAW,MAAM,GAAG,OAAO,EAC3B,WAAW,MAAM,KAChB,CAAC,QAAQ,EAAE,QAAQ,CAgBrB,CAAC"}

package/dist/es/geometry/bend.js

@@ -1,18 +1,7 @@
 //#region src/geometry/bend.ts
 /**
-* 用 cubic Bezier 拟合 from→to 的弧形 bend。
-*
-* 算法（ADR-0001）：
-* 1. apex offset = chord × tan(bendAngle / 2)（沿 path 法向 left / right 偏移量）
-* 2. 控制点取 chord 1/3 / 2/3 处沿法向偏移；为让 cubic 在 t=0.5 处穿过 apex，
-*    控制点 offset = (4/3) × apex offset（推导：B(0.5) = midpoint + (3/4)·s·n）
-*
-* 法向定义（SVG y 向下，"left/right" 按视觉，不按数学）：
-*   chord direction = (dx, dy) / |chord|
-*   visual-left normal  =  ( dy, -dx) / |chord|   （从 from 看向 to，向左偏）
-*   visual-right normal =  (-dy,  dx) / |chord|
-*
-* chord 长度为 0 时无方向可推，两个控制点都返回 from。
+* cubic Bezier 拟合 from→to 的弧形 bend
+* @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向 SVG y-down：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
 */
 var bendControlPoints = (from, to, direction, bendAngle) => {
 	const dx = to[0] - from[0];

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

@@ -1,19 +1,14 @@
 import { Position } from './point';
-/** 圆形：几何中心 (x, y) + 半径；与 Rect 一样支持可选旋转（圆对自身旋转无影响，预留供 anchor 命名一致性） */
+/** 圆形：几何中心 + 半径，预留旋转字段保持与 Rect 同形 API */
 export type Circle = {
-    /** 圆心横坐标 */
     x: number;
-    /** 圆心纵坐标 */
     y: number;
-    /** 半径（user units） */
+    /** 半径 */
     radius: number;
-    /** 绕几何中心旋转弧度；保留与 Rect 同形 API，圆形本身旋转后视觉不变 */
+    /** 绕中心旋转弧度（圆视觉不变，与 Rect 同形保留） */
     rotate?: number;
 };
-/**
- * 圆形 9 个标准 anchor 名集合，与 RECT_ANCHORS 同名同义。
- * 圆的"4 方位 + 4 对角"在圆周上等距分布（每 45°）。
- */
+/** 圆形 9 个标准 anchor（与 RECT_ANCHORS 同名同义，圆周每 45° 等距分布） */
 export type CircleAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 圆形相关基础工具 */
 export declare const circle: {
@@ -23,10 +18,7 @@ export declare const circle: {
     contains: (c: Circle, p: Position) => boolean;
     /** 9 个标准 anchor 之一的世界坐标 */
     anchor: (c: Circle, name: CircleAnchor) => Position;
-    /**
-     * 从圆心向 toward 方向画射线，求与圆周的交点。
-     * 用于把 Path 端点贴到 Node 边界。
-     */
+    /** 从圆心向 toward 方向射线与圆周交点（Path 端点贴 Node 边界用） */
     boundaryPoint: (c: Circle, toward: Position) => 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":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,sEAAsE;AACtE,MAAM,MAAM,MAAM,GAAG;IACnB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,YAAY,KAAG,QAAQ;IAsCjD;;;OAGG;uBACgB,MAAM,UAAU,QAAQ,KAAG,QAAQ;CAOvD,CAAC"}
+{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../../src/geometry/circle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,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,wDAAwD;AACxD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,YAAY,KAAG,QAAQ;IAsCjD,+CAA+C;uBAC5B,MAAM,UAAU,QAAQ,KAAG,QAAQ;CAOvD,CAAC"}

package/dist/es/geometry/circle.js

@@ -63,10 +63,7 @@ var circle = {
 		}
 		return localToWorld(c, [lx, ly]);
 	},
-	/**
-	* 从圆心向 toward 方向画射线，求与圆周的交点。
-	* 用于把 Path 端点贴到 Node 边界。
-	*/
+	/** 从圆心向 toward 方向射线与圆周交点（Path 端点贴 Node 边界用） */
 	boundaryPoint: (c, toward) => {
 		const [lx, ly] = worldToLocal(c, toward);
 		const len = Math.sqrt(lx * lx + ly * ly);

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

@@ -1,43 +1,28 @@
 import { Position } from './point';
-/**
- * 菱形：几何中心 (x, y) + 半轴长 halfA（水平）/ halfB（垂直）+ 可选旋转。
- * 4 个顶点位于 (±halfA, 0) 与 (0, ±halfB)，4 条边界线把这些顶点两两相连。
- */
+/** 菱形：中心 + halfA/halfB 半轴长 + 可选旋转；顶点在 (±halfA,0) 与 (0,±halfB) */
 export type Diamond = {
-    /** 中心横坐标 */
     x: number;
-    /** 中心纵坐标 */
     y: number;
-    /** 水平半轴长（中心到 east/west 顶点的距离） */
+    /** 中心到 east/west 顶点距离 */
     halfA: number;
-    /** 垂直半轴长（中心到 north/south 顶点的距离） */
+    /** 中心到 north/south 顶点距离 */
     halfB: number;
-    /** 绕几何中心旋转弧度；省略或 0 表示不旋转 */
+    /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 菱形 9 个标准 anchor 名（4 顶点 + 4 边中点 + 中心） */
+/** 菱形 9 个标准 anchor（4 顶点 + 4 边中点 + 中心） */
 export type DiamondAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 菱形相关基础工具 */
 export declare const diamond: {
     /** 中心 */
     center: (d: Diamond) => Position;
-    /**
-     * 判断点是否在菱形内（含边界，考虑旋转）。
-     * 菱形方程：|x|/halfA + |y|/halfB ≤ 1。
-     */
+    /** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
     contains: (d: Diamond, p: Position) => boolean;
-    /**
-     * 9 个标准 anchor 的世界坐标。
-     * - N/S/E/W：四个顶点
-     * - NE/NW/SE/SW：四条边的中点
-     * - center：几何中心
-     */
+    /** 9 个 anchor：N/S/E/W=顶点，NE/NW/SE/SW=边中点，center=中心 */
     anchor: (d: Diamond, name: DiamondAnchor) => Position;
     /**
-     * 从中心向 toward 方向画射线，求与菱形 4 条边之一的交点。
-     * 菱形方程：|x|/halfA + |y|/halfB = 1。
-     * 沿方向 (lx, ly) 缩放 t 倍命中：t × (|lx|/halfA + |ly|/halfB) = 1
-     * → t = 1 / (|lx|/halfA + |ly|/halfB)。
+     * 从中心向 toward 方向射线与菱形 4 边的交点
+     * @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)
      */
     boundaryPoint: (d: Diamond, toward: Position) => Position;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B;;;OAGG;kBACW,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C;;;;;OAKG;gBACS,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCnD;;;;;OAKG;uBACgB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAOxD,CAAC"}
+{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,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,yCAAyC;AACzC,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C,sDAAsD;gBAC1C,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCrD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAOxD,CAAC"}

package/dist/es/geometry/diamond.js

@@ -19,20 +19,12 @@ var worldToLocal = (d, world) => {
 var diamond = {
 	/** 中心 */
 	center: (d) => [d.x, d.y],
-	/**
-	* 判断点是否在菱形内（含边界，考虑旋转）。
-	* 菱形方程：|x|/halfA + |y|/halfB ≤ 1。
-	*/
+	/** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
 	contains: (d, p) => {
 		const [lx, ly] = worldToLocal(d, p);
 		return Math.abs(lx) / d.halfA + Math.abs(ly) / d.halfB <= 1.000000001;
 	},
-	/**
-	* 9 个标准 anchor 的世界坐标。
-	* - N/S/E/W：四个顶点
-	* - NE/NW/SE/SW：四条边的中点
-	* - center：几何中心
-	*/
+	/** 9 个 anchor：N/S/E/W=顶点，NE/NW/SE/SW=边中点，center=中心 */
 	anchor: (d, name) => {
 		let lx = 0;
 		let ly = 0;
@@ -70,10 +62,8 @@ var diamond = {
 		return localToWorld(d, [lx, ly]);
 	},
 	/**
-	* 从中心向 toward 方向画射线，求与菱形 4 条边之一的交点。
-	* 菱形方程：|x|/halfA + |y|/halfB = 1。
-	* 沿方向 (lx, ly) 缩放 t 倍命中：t × (|lx|/halfA + |ly|/halfB) = 1
-	* → t = 1 / (|lx|/halfA + |ly|/halfB)。
+	* 从中心向 toward 方向射线与菱形 4 边的交点
+	* @description 菱形方程 |x|/halfA + |y|/halfB = 1；沿方向 (lx,ly) 缩放 t 倍命中：t = 1 / (|lx|/halfA + |ly|/halfB)
 	*/
 	boundaryPoint: (d, toward) => {
 		const [lx, ly] = worldToLocal(d, toward);

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

@@ -1,18 +1,16 @@
 import { Position } from './point';
-/** 椭圆：几何中心 (x, y) + 半长轴 rx / 半短轴 ry + 可选旋转（弧度） */
+/** 椭圆：中心 + 半长轴 rx / 半短轴 ry + 可选旋转 */
 export type Ellipse = {
-    /** 中心横坐标 */
     x: number;
-    /** 中心纵坐标 */
     y: number;
-    /** 半长轴（沿本地 +x 方向） */
+    /** 沿本地 +x */
     rx: number;
-    /** 半短轴（沿本地 +y 方向） */
+    /** 沿本地 +y */
     ry: number;
-    /** 绕几何中心旋转弧度；省略或 0 表示不旋转 */
+    /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 椭圆 9 个标准 anchor 名（含义与 RECT_ANCHORS 一致） */
+/** 椭圆 9 个标准 anchor（与 RECT_ANCHORS 同名同义） */
 export type EllipseAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 椭圆相关基础工具 */
 export declare const ellipse: {
@@ -21,17 +19,13 @@ export declare const ellipse: {
     /** 判断点是否在椭圆内（含边界，考虑旋转） */
     contains: (e: Ellipse, p: Position) => boolean;
     /**
-     * 9 个标准 anchor 的世界坐标。
-     * 对角 anchor（NE/NW/SE/SW）取参数曲线 t=π/4 处的点：
-     * (rx·cos(π/4), ry·sin(π/4)) = (rx/√2, ry/√2)。
-     * 这与 TikZ 椭圆对角 anchor 的"参数等分"约定一致。
+     * 9 个 anchor 的世界坐标
+     * @description 对角（NE/NW/SE/SW）取参数曲线 t=π/4 处 (rx/√2, ry/√2)，与 TikZ 椭圆 anchor 参数等分约定一致
      */
     anchor: (e: Ellipse, name: EllipseAnchor) => Position;
     /**
-     * 从中心向 toward 方向画射线，求与椭圆的交点。
-     * 椭圆方程：(x/rx)² + (y/ry)² = 1。
-     * 沿方向 (lx, ly) 缩放 t 倍命中：t² × ((lx/rx)² + (ly/ry)²) = 1
-     * → t = 1 / √((lx/rx)² + (ly/ry)²)。
+     * 从中心向 toward 方向射线与椭圆交点
+     * @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)
      */
     boundaryPoint: (e: Ellipse, toward: Position) => Position;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,kDAAkD;AAClD,MAAM,MAAM,OAAO,GAAG;IACpB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C;;;;;OAKG;gBACS,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCnD;;;;;OAKG;uBACgB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,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,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI9C;;;OAGG;gBACW,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCrD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}

package/dist/es/geometry/ellipse.js

@@ -26,10 +26,8 @@ var ellipse = {
 		return lx * lx / (e.rx * e.rx) + ly * ly / (e.ry * e.ry) <= 1;
 	},
 	/**
-	* 9 个标准 anchor 的世界坐标。
-	* 对角 anchor（NE/NW/SE/SW）取参数曲线 t=π/4 处的点：
-	* (rx·cos(π/4), ry·sin(π/4)) = (rx/√2, ry/√2)。
-	* 这与 TikZ 椭圆对角 anchor 的"参数等分"约定一致。
+	* 9 个 anchor 的世界坐标
+	* @description 对角（NE/NW/SE/SW）取参数曲线 t=π/4 处 (rx/√2, ry/√2)，与 TikZ 椭圆 anchor 参数等分约定一致
 	*/
 	anchor: (e, name) => {
 		let lx = 0;
@@ -68,10 +66,8 @@ var ellipse = {
 		return localToWorld(e, [lx, ly]);
 	},
 	/**
-	* 从中心向 toward 方向画射线，求与椭圆的交点。
-	* 椭圆方程：(x/rx)² + (y/ry)² = 1。
-	* 沿方向 (lx, ly) 缩放 t 倍命中：t² × ((lx/rx)² + (ly/ry)²) = 1
-	* → t = 1 / √((lx/rx)² + (ly/ry)²)。
+	* 从中心向 toward 方向射线与椭圆交点
+	* @description 椭圆方程 (x/rx)² + (y/ry)² = 1；沿 (lx,ly) 缩放 t 倍命中 t = 1 / √((lx/rx)² + (ly/ry)²)
 	*/
 	boundaryPoint: (e, toward) => {
 		const [lx, ly] = worldToLocal(e, toward);

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

@@ -3,22 +3,21 @@ import { PolarPosition } from './polar';
 export type Position = [number, number];
 /** 二维向量 / 坐标的基础运算工具集 */
 export declare const point: {
-    /** 两点相加（向量加法）：a + b */
+    /** 向量加 a + b */
     add: (a: Position, b: Position) => Position;
-    /** 两点相减（向量减法）：a - b */
+    /** 向量减 a - b */
     sub: (a: Position, b: Position) => Position;
-    /** 等比缩放：a * k */
+    /** 等比缩放 a * k */
     scale: (a: Position, k: number) => Position;
-    /** 判断两点坐标是否完全相等（精确比较，不带容差） */
+    /** 两点精确相等（不带容差） */
     equal: (a: Position, b: Position) => boolean;
-    /** 笛卡尔点 → 极坐标（angle 落在 (-180, 180]，origin 取默认 [0, 0]） */
+    /** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
     toPolar: (p: Position) => PolarPosition;
     /**
-     * 判断两个点是否相同（跨坐标系）。每个参数可以是笛卡尔 [x, y] 或 PolarPosition；
-     * 极坐标先转为笛卡尔，再按 precision 指定的小数位数四舍五入比较。
-     * `polar.equal` 委托到本方法。
+     * 跨坐标系两点相同判断（笛卡尔或 PolarPosition）
+     * @description 极坐标先转笛卡尔再按 precision 四舍五入比较；polar.equal 委托到本方法
      * @param precision 小数点后位数；默认 2
-     * @throws 当 PolarPosition 的 origin 是节点 id 字符串时——字符串解析需 Scene 上下文
+     * @throws 当 PolarPosition.origin 是节点 id 字符串时（需 Scene 上下文）
      */
     equalPolar: (a: Position | PolarPosition, b: Position | PolarPosition, precision?: number) => boolean;
 };

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,uBAAuB;aACd,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,uBAAuB;aACd,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,iBAAiB;eACN,QAAQ,KAAK,MAAM,KAAG,QAAQ;IACzC,8BAA8B;eACnB,QAAQ,KAAK,QAAQ,KAAG,OAAO;IAC1C,yDAAyD;iBAC5C,QAAQ,KAAG,aAAa;IAIrC;;;;;;OAMG;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;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"}

package/dist/es/geometry/point.js

@@ -3,25 +3,24 @@ import { polar } from "./polar.js";
 var RAD_TO_DEG = 180 / Math.PI;
 /** 二维向量 / 坐标的基础运算工具集 */
 var point = {
-	/** 两点相加（向量加法）：a + b */
+	/** 向量加 a + b */
 	add: (a, b) => [a[0] + b[0], a[1] + b[1]],
-	/** 两点相减（向量减法）：a - b */
+	/** 向量减 a - b */
 	sub: (a, b) => [a[0] - b[0], a[1] - b[1]],
-	/** 等比缩放：a * k */
+	/** 等比缩放 a * k */
 	scale: (a, k) => [a[0] * k, a[1] * k],
-	/** 判断两点坐标是否完全相等（精确比较，不带容差） */
+	/** 两点精确相等（不带容差） */
 	equal: (a, b) => a[0] === b[0] && a[1] === b[1],
-	/** 笛卡尔点 → 极坐标（angle 落在 (-180, 180]，origin 取默认 [0, 0]） */
+	/** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
 	toPolar: (p) => ({
 		angle: Math.atan2(p[1], p[0]) * RAD_TO_DEG,
 		radius: Math.hypot(p[0], p[1])
 	}),
 	/**
-	* 判断两个点是否相同（跨坐标系）。每个参数可以是笛卡尔 [x, y] 或 PolarPosition；
-	* 极坐标先转为笛卡尔，再按 precision 指定的小数位数四舍五入比较。
-	* `polar.equal` 委托到本方法。
+	* 跨坐标系两点相同判断（笛卡尔或 PolarPosition）
+	* @description 极坐标先转笛卡尔再按 precision 四舍五入比较；polar.equal 委托到本方法
 	* @param precision 小数点后位数；默认 2
-	* @throws 当 PolarPosition 的 origin 是节点 id 字符串时——字符串解析需 Scene 上下文
+	* @throws 当 PolarPosition.origin 是节点 id 字符串时（需 Scene 上下文）
 	*/
 	equalPolar: (a, b, precision = 2) => {
 		const aCart = Array.isArray(a) ? a : polar.toPosition(a);