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

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

@@ -1,42 +1,33 @@
 import { Position } from './point';
 /**
- * 极坐标点：相对 origin 的角度 + 半径偏移。
- * - 可进 IR；Scene 编译时统一解析为笛卡尔
- * - 不直接参与几何计算，参与时先转为 Position（见本文件顶部说明）
- * - origin 可嵌套（PolarPosition），可引用节点 id（string），可直接给坐标（Position），省略表示原点 [0, 0]
+ * 极坐标点：相对 origin 的角度 + 半径偏移
+ * @description IR 保留 polar 形态，Scene 编译时统一解析为笛卡尔；origin 可嵌套/节点 id/坐标，省略表示 [0,0]
  */
 export type PolarPosition = {
-    /** 极坐标原点：节点 id / 笛卡尔位置 / 嵌套极坐标；省略表示 [0, 0] */
+    /** 极坐标原点：节点 id / 笛卡尔 / 嵌套极坐标；省略表示 [0,0] */
     origin?: string | Position | PolarPosition;
-    /** 角度（度数，逆时针为正，与 TikZ / 数学习惯一致） */
+    /** 角度（度数，逆时针为正） */
     angle: number;
-    /** 半径（user units，应为非负） */
+    /** 半径（非负） */
     radius: number;
 };
-/**
- * 极坐标 ↔ 笛卡尔坐标 转换工具集。
- *
- * 注意 polar 不参与几何计算——参与计算时一律先用 `polar.toPosition` 转成 Position。
- * 详见本文件顶部的整体说明。
- */
+/** 极坐标 ↔ 笛卡尔转换工具集（polar 不参与几何计算，参与时先 toPosition） */
 export declare const polar: {
     /**
-     * 极坐标 → 笛卡尔位置（递归处理 origin）。
-     * **限制**：origin 为字符串（节点 id）时本方法无法解析，会抛错——
-     * 字符串解析依赖 Scene 编译器的 nodeIndex 上下文。
+     * 极坐标 → 笛卡尔位置（递归处理 origin）
+     * @description origin 为字符串（节点 id）时抛错——字符串解析依赖 Scene 编译器 nodeIndex
      */
     toPosition: (p: PolarPosition) => Position;
-    /** 笛卡尔位置 → 极坐标（angle 落在 (-180, 180]，origin 取默认 [0, 0]） */
+    /** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
     fromPosition: (p: Position) => PolarPosition;
-    /** 在某个原点附近按极坐标偏移；返回结果点的世界笛卡尔坐标 */
+    /** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
     offsetFrom: (origin: Position, offset: {
         angle: number;
         radius: number;
     }) => Position;
     /**
-     * 判断两个点是否相同（跨坐标系）。每个参数可以是笛卡尔 [x, y] 或 PolarPosition；
-     * 极坐标先转为笛卡尔，再按 precision 指定的小数位数四舍五入比较。
-     * 实际是 `point.equalPolar` 的别名（同一份实现，两处可发现）。
+     * 跨坐标系两点相同判断（point.equalPolar 别名）
+     * @description 极坐标先转笛卡尔再按 precision 四舍五入比较
      * @param precision 小数点后位数；默认 2
      */
     equal: (a: Position | PolarPosition, b: Position | PolarPosition, precision?: number) => boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"polar.d.ts","sourceRoot":"","sources":["../../../src/geometry/polar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,SAAS,CAAC;AAkB/C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC3C,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,KAAK;IAChB;;;;OAIG;oBACa,aAAa,KAAG,QAAQ;IAmBxC,0DAA0D;sBACxC,QAAQ,KAAG,aAAa;IAI1C,kCAAkC;yBAExB,QAAQ,UACR;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KACxC,QAAQ;IAOX;;;;;OAKG;eAEE,QAAQ,GAAG,aAAa,KACxB,QAAQ,GAAG,aAAa,yBAE1B,OAAO;CACX,CAAC"}
+{"version":3,"file":"polar.d.ts","sourceRoot":"","sources":["../../../src/geometry/polar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAS,MAAM,SAAS,CAAC;AAS/C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC3C,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF,oDAAoD;AACpD,eAAO,MAAM,KAAK;IAChB;;;OAGG;oBACa,aAAa,KAAG,QAAQ;IAmBxC,oDAAoD;sBAClC,QAAQ,KAAG,aAAa;IAI1C,gCAAgC;yBAEtB,QAAQ,UACR;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KACxC,QAAQ;IAOb;;;;OAIG;eAEI,QAAQ,GAAG,aAAa,KACxB,QAAQ,GAAG,aAAa,yBAE1B,OAAO;CACX,CAAC"}

package/dist/es/geometry/polar.js

@@ -2,17 +2,11 @@ import { point } from "./point.js";
 //#region src/geometry/polar.ts
 var DEG_TO_RAD = Math.PI / 180;
 var RAD_TO_DEG = 180 / Math.PI;
-/**
-* 极坐标 ↔ 笛卡尔坐标 转换工具集。
-*
-* 注意 polar 不参与几何计算——参与计算时一律先用 `polar.toPosition` 转成 Position。
-* 详见本文件顶部的整体说明。
-*/
+/** 极坐标 ↔ 笛卡尔转换工具集（polar 不参与几何计算，参与时先 toPosition） */
 var polar = {
 	/**
-	* 极坐标 → 笛卡尔位置（递归处理 origin）。
-	* **限制**：origin 为字符串（节点 id）时本方法无法解析，会抛错——
-	* 字符串解析依赖 Scene 编译器的 nodeIndex 上下文。
+	* 极坐标 → 笛卡尔位置（递归处理 origin）
+	* @description origin 为字符串（节点 id）时抛错——字符串解析依赖 Scene 编译器 nodeIndex
 	*/
 	toPosition: (p) => {
 		let origin;
@@ -23,20 +17,19 @@ var polar = {
 		const rad = p.angle * DEG_TO_RAD;
 		return [origin[0] + Math.cos(rad) * p.radius, origin[1] + Math.sin(rad) * p.radius];
 	},
-	/** 笛卡尔位置 → 极坐标（angle 落在 (-180, 180]，origin 取默认 [0, 0]） */
+	/** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
 	fromPosition: (p) => ({
 		angle: Math.atan2(p[1], p[0]) * RAD_TO_DEG,
 		radius: Math.hypot(p[0], p[1])
 	}),
-	/** 在某个原点附近按极坐标偏移；返回结果点的世界笛卡尔坐标 */
+	/** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
 	offsetFrom: (origin, offset) => {
 		const rad = offset.angle * DEG_TO_RAD;
 		return [origin[0] + Math.cos(rad) * offset.radius, origin[1] + Math.sin(rad) * offset.radius];
 	},
 	/**
-	* 判断两个点是否相同（跨坐标系）。每个参数可以是笛卡尔 [x, y] 或 PolarPosition；
-	* 极坐标先转为笛卡尔，再按 precision 指定的小数位数四舍五入比较。
-	* 实际是 `point.equalPolar` 的别名（同一份实现，两处可发现）。
+	* 跨坐标系两点相同判断（point.equalPolar 别名）
+	* @description 极坐标先转笛卡尔再按 precision 四舍五入比较
 	* @param precision 小数点后位数；默认 2
 	*/
 	equal: (a, b, precision = 2) => point.equalPolar(a, b, precision)

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

@@ -1,59 +1,35 @@
 import { Position } from './point';
-/** 轴对齐矩形：几何中心 (x, y) + 宽高 + 可选绕中心旋转 */
+/** 轴对齐矩形：几何中心 + 宽高 + 可选绕中心旋转 */
 export type Rect = {
-    /** 矩形几何中心横坐标 */
     x: number;
-    /** 矩形几何中心纵坐标 */
     y: number;
-    /** 矩形宽度（user units） */
     width: number;
-    /** 矩形高度（user units） */
     height: number;
-    /** 绕几何中心的旋转角（弧度）；省略或 0 表示不旋转 */
+    /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/**
- * 矩形 9 个标准 anchor 名常量集合，对应 TikZ 节点的 9 个标准 anchor。
- * 与 `RectAnchor` 类型配对使用——值用 `RECT_ANCHORS.NORTH` 避免拼错，
- * 类型位置用 `RectAnchor`。
- */
+/** 矩形 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 命名约定一致），由 `RECT_ANCHORS` 常量集合派生 */
+/** 矩形 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 一致（north / south / east / west / north-east / ... / center）。
-     */
+    /** 9 个 anchor 之一的世界坐标（含旋转），TikZ 命名 */
     anchor: (r: Rect, name: RectAnchor) => Position;
-    /**
-     * 从矩形中心向 toward 方向画射线，求与矩形边界的交点（考虑旋转）。
-     * 用于把 Path 端点贴到 Node 边界（避免线段穿过节点内部）。
-     */
+    /** 从中心向 toward 方向射线与矩形边界交点（含旋转），Path 端点贴 Node 边界用 */
     boundaryPoint: (r: Rect, toward: Position) => Position;
 };
 //# sourceMappingURL=rect.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,uCAAuC;AACvC,MAAM,MAAM,IAAI,GAAG;IACjB,gBAAgB;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,gBAAgB;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY;IACvB,WAAW;;IAEX,WAAW;;IAEX,WAAW;;IAEX,WAAW;;IAEX,WAAW;;IAEX,UAAU;;IAEV,UAAU;;IAEV,UAAU;;IAEV,UAAU;;CAEF,CAAC;AAEX,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAgC1E,eAAe;AACf,eAAO,MAAM,IAAI;IACf,cAAc;gBACF,IAAI,KAAG,QAAQ;IAC3B,6BAA6B;kBACf,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC;;;OAGG;gBACS,IAAI,QAAQ,UAAU,KAAG,QAAQ;IAuC7C;;;OAGG;uBACgB,IAAI,UAAU,QAAQ,KAAG,QAAQ;CAUrD,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AAAA,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;AA0B1E,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;CAUrD,CAAC"}

package/dist/es/geometry/rect.js

@@ -1,33 +1,17 @@
 //#region src/geometry/rect.ts
-/**
-* 矩形 9 个标准 anchor 名常量集合，对应 TikZ 节点的 9 个标准 anchor。
-* 与 `RectAnchor` 类型配对使用——值用 `RECT_ANCHORS.NORTH` 避免拼错，
-* 类型位置用 `RectAnchor`。
-*/
+/** 矩形 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"
 };
-/**
-* 把"以矩形中心为原点的本地坐标"转换为世界坐标。
-* 考虑 rect.rotate（弧度）的旋转。
-*/
+/** 本地坐标（以中心为原点）→ 世界坐标，考虑 rect.rotate */
 var localToWorld = (r, local) => {
 	const angle = r.rotate ?? 0;
 	if (angle === 0) return [r.x + local[0], r.y + local[1]];
@@ -35,10 +19,7 @@ var localToWorld = (r, local) => {
 	const sin = Math.sin(angle);
 	return [r.x + local[0] * cos - local[1] * sin, r.y + local[0] * sin + local[1] * cos];
 };
-/**
-* 把世界坐标转换为"以矩形中心为原点的本地坐标"。
-* 与 localToWorld 互为逆变换。
-*/
+/** 世界坐标 → 本地坐标（localToWorld 逆变换） */
 var worldToLocal = (r, world) => {
 	const tx = world[0] - r.x;
 	const ty = world[1] - r.y;
@@ -48,21 +29,17 @@ var worldToLocal = (r, world) => {
 	const sin = Math.sin(angle);
 	return [tx * cos + ty * sin, -tx * sin + ty * cos];
 };
-/** 矩形相关基础工具 */
 var rect = {
-	/** 矩形几何中心点 */
+	/** 几何中心 */
 	center: (r) => [r.x, r.y],
-	/** 判断点是否落在矩形范围内（含边界，考虑旋转） */
+	/** 点是否在矩形内（含边界，含旋转） */
 	contains: (r, p) => {
 		const [lx, ly] = worldToLocal(r, p);
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
 		return lx >= -halfW && lx <= halfW && ly >= -halfH && ly <= halfH;
 	},
-	/**
-	* 取矩形 9 个标准 anchor 之一的世界坐标，考虑旋转。
-	* 名字与 TikZ 节点 anchor 一致（north / south / east / west / north-east / ... / center）。
-	*/
+	/** 9 个 anchor 之一的世界坐标（含旋转），TikZ 命名 */
 	anchor: (r, name) => {
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
@@ -101,10 +78,7 @@ var rect = {
 		}
 		return localToWorld(r, [lx, ly]);
 	},
-	/**
-	* 从矩形中心向 toward 方向画射线，求与矩形边界的交点（考虑旋转）。
-	* 用于把 Path 端点贴到 Node 边界（避免线段穿过节点内部）。
-	*/
+	/** 从中心向 toward 方向射线与矩形边界交点（含旋转），Path 端点贴 Node 边界用 */
 	boundaryPoint: (r, toward) => {
 		const [localX, localY] = worldToLocal(r, toward);
 		if (localX === 0 && localY === 0) return [r.x, r.y];

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

@@ -1,38 +1,31 @@
 import { Position } from './point';
 export type SegmentSample = {
-    /** t 处的点坐标 */
+    /** t 处的点 */
     point: Position;
-    /** t 处的切线方向（单位向量；零向量时回退到 [1, 0]） */
+    /** t 处的切线（单位向量；零向量时回退 [1, 0]） */
     tangent: Position;
 };
 /** 直线段 from → to */
 export declare const lineSegmentSample: (from: Position, to: Position, t: number) => SegmentSample;
 /**
- * 二次贝塞尔 from → control → to。
- * P(t)  = (1-t)²·P0 + 2(1-t)t·P1 + t²·P2
- * P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
+ * 二次贝塞尔 from → control → to
+ * @description P(t) = (1-t)²P0 + 2(1-t)t·P1 + t²P2；P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
  */
 export declare const quadSegmentSample: (from: Position, control: Position, to: Position, t: number) => SegmentSample;
 /**
- * 三次贝塞尔 from → c1 → c2 → to。
- * P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
+ * 三次贝塞尔 from → c1 → c2 → to
+ * @description P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
  */
 export declare const cubicSegmentSample: (from: Position, c1: Position, c2: Position, to: Position, t: number) => SegmentSample;
 /**
- * 折角段 from → corner → to。
- * t∈[0, 0.5] 走第一段（参数 2t）；t∈(0.5, 1] 走第二段（参数 2t-1）。
- * t=0.5 落在 corner，切线取第一段方向（与"靠近 prev 一侧"一致）。
+ * 折角段 from → corner → to
+ * @description t∈[0,0.5] 走第一段（参数 2t）；t∈(0.5,1] 走第二段（参数 2t-1）；t=0.5 落 corner 切线取第一段方向
  */
 export declare const foldSegmentSample: (from: Position, corner: Position, to: Position, t: number) => SegmentSample;
-/**
- * 弧段（与 ir/path arc 同约定，角度单位为度）。
- * 切线沿"扫描方向"——endAngle ≥ startAngle 时为 (-sin, cos)，否则反向。
- */
+/** 弧段（角度度数，与 ir/path arc 同约定）；切线沿扫描方向：endAngle ≥ start 取 (-sin,cos)，否则反向 */
 export declare const arcSegmentSample: (center: Position, radius: number, startAngleDeg: number, endAngleDeg: number, t: number) => SegmentSample;
-/**
- * 整圆——从 0°（east）开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致。
- */
+/** 整圆，从 0°(east) 开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致 */
 export declare const circleSegmentSample: (center: Position, radius: number, t: number) => SegmentSample;
-/** 整椭圆——参数化 (rx·cos(2πt), ry·sin(2πt)) */
+/** 整椭圆，参数化 (rx·cos(2πt), ry·sin(2πt)) */
 export declare const ellipseSegmentSample: (center: Position, rx: number, ry: number, 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;AAuBxC,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,oCAAoC;IACpC,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;;;;GAIG;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;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aASF,CAAC;AAEF,0CAA0C;AAC1C,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,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAiBxC,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY;IACZ,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,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"}

package/dist/es/geometry/segment.js

@@ -11,9 +11,8 @@ var lineSegmentSample = (from, to, t) => ({
 	tangent: normalize([to[0] - from[0], to[1] - from[1]])
 });
 /**
-* 二次贝塞尔 from → control → to。
-* P(t)  = (1-t)²·P0 + 2(1-t)t·P1 + t²·P2
-* P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
+* 二次贝塞尔 from → control → to
+* @description P(t) = (1-t)²P0 + 2(1-t)t·P1 + t²P2；P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
 */
 var quadSegmentSample = (from, control, to, t) => {
 	const u = 1 - t;
@@ -23,8 +22,8 @@ var quadSegmentSample = (from, control, to, t) => {
 	};
 };
 /**
-* 三次贝塞尔 from → c1 → c2 → to。
-* P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
+* 三次贝塞尔 from → c1 → c2 → to
+* @description P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
 */
 var cubicSegmentSample = (from, c1, c2, to, t) => {
 	const u = 1 - t;
@@ -34,18 +33,14 @@ var cubicSegmentSample = (from, c1, c2, to, t) => {
 	};
 };
 /**
-* 折角段 from → corner → to。
-* t∈[0, 0.5] 走第一段（参数 2t）；t∈(0.5, 1] 走第二段（参数 2t-1）。
-* t=0.5 落在 corner，切线取第一段方向（与"靠近 prev 一侧"一致）。
+* 折角段 from → corner → to
+* @description t∈[0,0.5] 走第一段（参数 2t）；t∈(0.5,1] 走第二段（参数 2t-1）；t=0.5 落 corner 切线取第一段方向
 */
 var foldSegmentSample = (from, corner, to, t) => {
 	if (t <= .5) return lineSegmentSample(from, corner, t * 2);
 	return lineSegmentSample(corner, to, t * 2 - 1);
 };
-/**
-* 弧段（与 ir/path arc 同约定，角度单位为度）。
-* 切线沿"扫描方向"——endAngle ≥ startAngle 时为 (-sin, cos)，否则反向。
-*/
+/** 弧段（角度度数，与 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);
@@ -56,9 +51,7 @@ var arcSegmentSample = (center, radius, startAngleDeg, endAngleDeg, t) => {
 		tangent: normalize([-sin * sweepSign, cos * sweepSign])
 	};
 };
-/**
-* 整圆——从 0°（east）开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致。
-*/
+/** 整圆，从 0°(east) 开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致 */
 var circleSegmentSample = (center, radius, t) => {
 	const rad = t * 360 * DEG_TO_RAD;
 	const cos = Math.cos(rad);
@@ -68,7 +61,7 @@ var circleSegmentSample = (center, radius, t) => {
 		tangent: normalize([-sin, cos])
 	};
 };
-/** 整椭圆——参数化 (rx·cos(2πt), ry·sin(2π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);

package/dist/es/index.d.ts

@@ -1,18 +1,14 @@
 /**
  * @retikz/core 公开 API
- *
- * 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）
- * 只能 import 本文件导出的内容，不准走子路径。
- *
- * 本包零 React、零 DOM 依赖。
+ * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, AT_DIRECTIONS, TargetSchema, RelTargetSchema, RelAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, NodeTextSchema, LineSpecSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRAtPosition, AtDirection, IRTarget, IRRelTarget, IRRelAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRPath, IRChild, IR, ArrowShape, NodeShape, NodeTextAlign, } from './ir';
-export { ARROW_SHAPES, NODE_SHAPES, NODE_TEXT_ALIGNS } from './ir';
-export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, GroupPrim, ViewBox, Scene, } from './primitive';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, NodeTextSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRPath, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, NodeTextAlign, } from './ir';
+export { ARROW_SHAPES, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, } from './ir';
+export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, ArrowEndSpec, GroupPrim, Transform, ViewBox, Scene, } from './primitive';
 export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, } from './compile';
 export { fallbackMeasurer, compileToScene } from './compile';
-export type { WayItem, WayDSL, WayCycle, WayVia, WayRelItem, WayLabel, WayLabelOp, } from './parsers';
+export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayLabelOp, } from './parsers';
 export { parseWay, DrawWay, parseTargetSugar } from './parsers';
 export type { Position, Rect, RectAnchor, Circle, CircleAnchor, Ellipse, EllipseAnchor, Diamond, DiamondAnchor, PolarPosition, } from './geometry';
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAGnE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIhE,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,WAAW,EACX,gBAAgB,GACjB,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIhE,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC"}

package/dist/es/index.js

@@ -1,8 +1,9 @@
 import { PositionSchema } from "./ir/position/position.js";
 import { PolarPositionSchema } from "./ir/position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./ir/position/at-position.js";
-import { ARROW_SHAPES } from "./ir/path/arrow.js";
-import { RelAccumulateTargetSchema, RelTargetSchema, TargetSchema } from "./ir/path/target.js";
+import { OffsetPositionSchema } from "./ir/position/offset-position.js";
+import { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, ArrowDetailSchema, ArrowEndDetailSchema, HOLLOW_ARROW_SHAPES } from "./ir/path/arrow.js";
+import { RelativeAccumulateTargetSchema, RelativeTargetSchema, TargetSchema } from "./ir/path/target.js";
 import { ArcStepSchema, BendStepSchema, CirclePathStepSchema, ControlPointSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, EllipsePathStepSchema, FoldStepSchema, LineStepSchema, MoveStepSchema, StepLabelSchema, StepSchema } from "./ir/path/step.js";
 import { PathSchema } from "./ir/path/path.js";
 import { FontSchema, LineSpecSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema, NodeTextSchema } from "./ir/node.js";
@@ -18,4 +19,4 @@ import { parseTargetSugar } from "./parsers/parseTargetSugar.js";
 import { DrawWay, parseWay } from "./parsers/parseWay.js";
 import { polar } from "./geometry/polar.js";
 import { point } from "./geometry/point.js";
-export { ARROW_SHAPES, AT_DIRECTIONS, ArcStepSchema, AtPositionSchema, BendStepSchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema, NodeTextSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RelAccumulateTargetSchema, RelTargetSchema, SceneSchema, StepLabelSchema, StepSchema, TargetSchema, circle, compileToScene, diamond, ellipse, fallbackMeasurer, parseTargetSugar, parseWay, point, polar, rect };
+export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, AT_DIRECTIONS, ArcStepSchema, ArrowDetailSchema, ArrowEndDetailSchema, AtPositionSchema, BendStepSchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, HOLLOW_ARROW_SHAPES, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema, NodeTextSchema, OffsetPositionSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, StepLabelSchema, StepSchema, TargetSchema, circle, compileToScene, diamond, ellipse, fallbackMeasurer, parseTargetSugar, parseWay, point, polar, rect };

package/dist/es/ir/coordinate.d.ts

@@ -1,14 +1,7 @@
 import { z } from 'zod';
 /**
- * Coordinate（占位节点）——TikZ `\coordinate (m) at (3,2);` 同义。
- *
- * 命名一个点供后续 path / at 引用，自身不绘制任何图形。
- * 支持笛卡尔 / 极坐标 / 相对定位三种 position 形态，与 `Node.position` 完全一致。
- *
- * 特点：
- * - 必须有 `id`（无 id 的占位节点没有意义）
- * - 不参与 viewBox 扩展（无视觉边界）；只在被引用时才间接影响 viewBox（通过引用它的 node / path）
- * - 与 Node 在同一个 nodeIndex 中注册——path target 字符串、`Node.position.of` 都能命中 coordinate id
+ * Coordinate 占位节点（TikZ `\coordinate (m) at (3,2);` 同义）
+ * @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 viewBox 扩展，与 Node 在同一 nodeIndex 注册
  */
 export declare const CoordinateSchema: z.ZodObject<{
     type: z.ZodLiteral<"coordinate">;
@@ -34,6 +27,15 @@ export declare const CoordinateSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     }>]>;
 }, "strip", z.ZodTypeAny, {
     type: "coordinate";
@@ -41,6 +43,9 @@ export declare const CoordinateSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    } | {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     };
     id: string;
 }, {
@@ -49,9 +54,12 @@ export declare const CoordinateSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    } | {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     };
     id: string;
 }>;
-/** Coordinate IR 类型——`{ type: 'coordinate', id, position }` */
+/** Coordinate IR 类型 `{ type:'coordinate', id, position }` */
 export type IRCoordinate = z.infer<typeof CoordinateSchema>;
 //# sourceMappingURL=coordinate.d.ts.map

package/dist/es/ir/coordinate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinate.d.ts","sourceRoot":"","sources":["../../../src/ir/coordinate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB1B,CAAC;AAEJ,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"coordinate.d.ts","sourceRoot":"","sources":["../../../src/ir/coordinate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB1B,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/es/ir/coordinate.js

@@ -1,18 +1,12 @@
 import { PositionSchema } from "./position/position.js";
 import { PolarPositionSchema } from "./position/polar-position.js";
 import { AtPositionSchema } from "./position/at-position.js";
+import { OffsetPositionSchema } from "./position/offset-position.js";
 import { z } from "zod";
 //#region src/ir/coordinate.ts
 /**
-* Coordinate（占位节点）——TikZ `\coordinate (m) at (3,2);` 同义。
-*
-* 命名一个点供后续 path / at 引用，自身不绘制任何图形。
-* 支持笛卡尔 / 极坐标 / 相对定位三种 position 形态，与 `Node.position` 完全一致。
-*
-* 特点：
-* - 必须有 `id`（无 id 的占位节点没有意义）
-* - 不参与 viewBox 扩展（无视觉边界）；只在被引用时才间接影响 viewBox（通过引用它的 node / path）
-* - 与 Node 在同一个 nodeIndex 中注册——path target 字符串、`Node.position.of` 都能命中 coordinate id
+* Coordinate 占位节点（TikZ `\coordinate (m) at (3,2);` 同义）
+* @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 viewBox 扩展，与 Node 在同一 nodeIndex 注册
 */
 var CoordinateSchema = z.object({
 	type: z.literal("coordinate").describe("Discriminator marking this child as a coordinate placeholder"),
@@ -20,8 +14,9 @@ var CoordinateSchema = z.object({
 	position: z.union([
 		PositionSchema,
 		PolarPositionSchema,
-		AtPositionSchema
-	]).describe("Coordinate position; Cartesian [x, y], polar, or relative-to-another-node (`at`-style). Resolved at compile time.")
+		AtPositionSchema,
+		OffsetPositionSchema
+	]).describe("Coordinate position; Cartesian [x, y], polar, relative-to-another-node (`at`-style), or offset from a base point (`{ of, offset }` form). Resolved at compile time.")
 }).describe("Coordinate placeholder: a named point with no visual; usable as a target for paths and as an anchor for relative positioning. Mirrors TikZ `\\coordinate (id) at (...);`");
 //#endregion
 export { CoordinateSchema };