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

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

@@ -0,0 +1,46 @@
+//#region src/compile/path/split.ts
+/**
+* 多 sub-path + 有端点箭头：按 sub-path split 成多个 PathPrim
+* @description 端点箭头只属于整条 path 的首端和末端；单 sub-path 或无箭头时直接产一个 PathPrim。
+*/
+var splitSubPathsForEndpointArrows = (commands, baseProps, endpointArrows) => {
+	const hasArrows = !!endpointArrows.arrowStart || !!endpointArrows.arrowEnd;
+	const subPathStarts = [];
+	commands.forEach((cmd, idx) => {
+		if (cmd.kind === "move") subPathStarts.push(idx);
+	});
+	if (!hasArrows || subPathStarts.length <= 1) return {
+		primitive: {
+			type: "path",
+			commands,
+			...baseProps,
+			...endpointArrows
+		},
+		isGrouped: false
+	};
+	const subPathSlices = [];
+	for (let s = 0; s < subPathStarts.length; s++) {
+		const start = subPathStarts[s];
+		const end = s + 1 < subPathStarts.length ? subPathStarts[s + 1] : commands.length;
+		subPathSlices.push(commands.slice(start, end));
+	}
+	return {
+		primitive: {
+			type: "group",
+			children: subPathSlices.map((sub, i) => {
+				const isFirst = i === 0;
+				const isLast = i === subPathSlices.length - 1;
+				return {
+					type: "path",
+					commands: sub,
+					...baseProps,
+					...isFirst && endpointArrows.arrowStart ? { arrowStart: endpointArrows.arrowStart } : {},
+					...isLast && endpointArrows.arrowEnd ? { arrowEnd: endpointArrows.arrowEnd } : {}
+				};
+			})
+		},
+		isGrouped: true
+	};
+};
+//#endregion
+export { splitSubPathsForEndpointArrows };

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

@@ -25,6 +25,9 @@ export type TextMetrics = {
  * @description @retikz/react: canvas measureText；@retikz/ssr: opentype.js/fontkit；@retikz/canvas: ctx.measureText
  */
 export type TextMeasurer = (text: string, font: FontSpec) => TextMetrics;
-/** 默认 fallback 度量：基于平均字宽估算，不准但保证可运行 */
+/**
+ * 默认 fallback 度量：基于平均字宽估算，不准但保证可运行
+ * @description size=0 → 退化返回 (0, 0)（与 text='' 一致）；负 size 或 NaN size → throw（非法输入早 fail，避免 NaN 噪音传播到 Scene）
+ */
 export declare const fallbackMeasurer: TextMeasurer;
 //# sourceMappingURL=text-metrics.d.ts.map

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;;;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"}
+{"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;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAU9B,CAAC"}

package/dist/es/compile/text-metrics.js

@@ -1,8 +1,14 @@
 //#region src/compile/text-metrics.ts
-/** 默认 fallback 度量：基于平均字宽估算，不准但保证可运行 */
-var fallbackMeasurer = (text, font) => ({
-	width: text.length * font.size * .55,
-	height: font.size * 1.2
-});
+/**
+* 默认 fallback 度量：基于平均字宽估算，不准但保证可运行
+* @description size=0 → 退化返回 (0, 0)（与 text='' 一致）；负 size 或 NaN size → throw（非法输入早 fail，避免 NaN 噪音传播到 Scene）
+*/
+var fallbackMeasurer = (text, font) => {
+	if (Number.isNaN(font.size) || font.size < 0) throw new Error(`fallbackMeasurer: invalid font.size '${font.size}'; must be a non-negative finite number`);
+	return {
+		width: text.length * font.size * .55,
+		height: font.size * 1.2
+	};
+};
 //#endregion
 export { fallbackMeasurer };

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

@@ -0,0 +1,21 @@
+import { Position } from './point';
+/** 任何"中心 + 可选旋转"形状的几何契约（rect / circle / ellipse / diamond 共用） */
+export type CenteredShape = {
+    /** 中心横坐标 */
+    x: number;
+    /** 中心纵坐标 */
+    y: number;
+    /** 绕中心旋转弧度（可选，0 / 缺省 = 不旋转） */
+    rotate?: number;
+};
+/**
+ * 本地坐标（以中心为原点）→ 世界坐标
+ * @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移
+ */
+export declare const localToWorld: (s: CenteredShape, local: Position) => Position;
+/**
+ * 世界坐标 → 本地坐标（`localToWorld` 逆变换）
+ * @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
+ */
+export declare const worldToLocal: (s: CenteredShape, world: Position) => Position;
+//# 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

@@ -0,0 +1,27 @@
+//#region src/geometry/_transform.ts
+/**
+* 本地坐标（以中心为原点）→ 世界坐标
+* @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移
+*/
+var localToWorld = (s, local) => {
+	const angle = s.rotate ?? 0;
+	if (angle === 0) return [s.x + local[0], s.y + local[1]];
+	const cos = Math.cos(angle);
+	const sin = Math.sin(angle);
+	return [s.x + local[0] * cos - local[1] * sin, s.y + local[0] * sin + local[1] * cos];
+};
+/**
+* 世界坐标 → 本地坐标（`localToWorld` 逆变换）
+* @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
+*/
+var worldToLocal = (s, world) => {
+	const tx = world[0] - s.x;
+	const ty = world[1] - s.y;
+	const angle = s.rotate ?? 0;
+	if (angle === 0) return [tx, ty];
+	const cos = Math.cos(angle);
+	const sin = Math.sin(angle);
+	return [tx * cos + ty * sin, -tx * sin + ty * cos];
+};
+//#endregion
+export { localToWorld, worldToLocal };

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

@@ -1,7 +1,7 @@
 import { Position } from './point';
 /**
  * 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
+ * @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向（screen 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.js

@@ -1,7 +1,7 @@
 //#region src/geometry/bend.ts
 /**
 * 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
+* @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向（screen 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,4 +1,5 @@
 import { Position } from './point';
+import { RectAnchor } from './rect';
 /** 圆形：几何中心 + 半径，预留旋转字段保持与 Rect 同形 API */
 export type Circle = {
     x: number;
@@ -8,8 +9,6 @@ export type Circle = {
     /** 绕中心旋转弧度（圆视觉不变，与 Rect 同形保留） */
     rotate?: number;
 };
-/** 圆形 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: {
     /** 圆心 */
@@ -17,7 +16,7 @@ export declare const circle: {
     /** 判断点是否在圆内（含边界） */
     contains: (c: Circle, p: Position) => boolean;
     /** 9 个标准 anchor 之一的世界坐标 */
-    anchor: (c: Circle, name: CircleAnchor) => Position;
+    anchor: (c: Circle, name: RectAnchor) => Position;
     /** 从圆心向 toward 方向射线与圆周交点（Path 端点贴 Node 边界用） */
     boundaryPoint: (c: Circle, toward: Position) => Position;
 };

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,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"}
+{"version":3,"file":"circle.d.ts","sourceRoot":"","sources":["../../../src/geometry/circle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,yCAAyC;AACzC,MAAM,MAAM,MAAM,GAAG;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS;IACT,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,MAAM;IACjB,SAAS;gBACG,MAAM,KAAG,QAAQ;IAC7B,oBAAoB;kBACN,MAAM,KAAK,QAAQ,KAAG,OAAO;IAI3C,2BAA2B;gBACf,MAAM,QAAQ,UAAU,KAAG,QAAQ;IAsC/C,+CAA+C;uBAC5B,MAAM,UAAU,QAAQ,KAAG,QAAQ;CAOvD,CAAC"}

package/dist/es/geometry/circle.js

@@ -1,21 +1,6 @@
+import { localToWorld, worldToLocal } from "./_transform.js";
 //#region src/geometry/circle.ts
 var SQRT_HALF = Math.SQRT1_2;
-var localToWorld = (c, local) => {
-	const angle = c.rotate ?? 0;
-	if (angle === 0) return [c.x + local[0], c.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [c.x + local[0] * cos - local[1] * sin, c.y + local[0] * sin + local[1] * cos];
-};
-var worldToLocal = (c, world) => {
-	const tx = world[0] - c.x;
-	const ty = world[1] - c.y;
-	const angle = c.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
 /** 圆形相关基础工具 */
 var circle = {
 	/** 圆心 */

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

@@ -1,4 +1,5 @@
 import { Position } from './point';
+import { RectAnchor } from './rect';
 /** 菱形：中心 + halfA/halfB 半轴长 + 可选旋转；顶点在 (±halfA,0) 与 (0,±halfB) */
 export type Diamond = {
     x: number;
@@ -10,8 +11,6 @@ export type Diamond = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 菱形 9 个标准 anchor（4 顶点 + 4 边中点 + 中心） */
-export type DiamondAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 菱形相关基础工具 */
 export declare const diamond: {
     /** 中心 */
@@ -19,7 +18,7 @@ export declare const diamond: {
     /** 点是否在菱形内（含边界，含旋转）；方程 |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: DiamondAnchor) => Position;
+    anchor: (d: Diamond, name: RectAnchor) => 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":"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"}
+{"version":3,"file":"diamond.d.ts","sourceRoot":"","sources":["../../../src/geometry/diamond.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,iEAAiE;AACjE,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,oDAAoD;kBACtC,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C,sDAAsD;gBAC1C,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAOxD,CAAC"}

package/dist/es/geometry/diamond.js

@@ -1,20 +1,5 @@
+import { localToWorld, worldToLocal } from "./_transform.js";
 //#region src/geometry/diamond.ts
-var localToWorld = (d, local) => {
-	const angle = d.rotate ?? 0;
-	if (angle === 0) return [d.x + local[0], d.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [d.x + local[0] * cos - local[1] * sin, d.y + local[0] * sin + local[1] * cos];
-};
-var worldToLocal = (d, world) => {
-	const tx = world[0] - d.x;
-	const ty = world[1] - d.y;
-	const angle = d.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
 /** 菱形相关基础工具 */
 var diamond = {
 	/** 中心 */

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

@@ -1,4 +1,5 @@
 import { Position } from './point';
+import { RectAnchor } from './rect';
 /** 椭圆：中心 + 半长轴 rx / 半短轴 ry + 可选旋转 */
 export type Ellipse = {
     x: number;
@@ -10,8 +11,6 @@ export type Ellipse = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 椭圆 9 个标准 anchor（与 RECT_ANCHORS 同名同义） */
-export type EllipseAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
 /** 椭圆相关基础工具 */
 export declare const ellipse: {
     /** 中心 */
@@ -22,7 +21,7 @@ export declare const ellipse: {
      * 9 个 anchor 的世界坐标
      * @description 对角（NE/NW/SE/SW）取参数曲线 t=π/4 处 (rx/√2, ry/√2)，与 TikZ 椭圆 anchor 参数等分约定一致
      */
-    anchor: (e: Ellipse, name: EllipseAnchor) => Position;
+    anchor: (e: Ellipse, name: RectAnchor) => 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":"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"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI9C;;;OAGG;gBACW,OAAO,QAAQ,UAAU,KAAG,QAAQ;IAqClD;;;OAGG;uBACkB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}

package/dist/es/geometry/ellipse.js

@@ -1,21 +1,6 @@
+import { localToWorld, worldToLocal } from "./_transform.js";
 //#region src/geometry/ellipse.ts
 var SQRT_HALF = Math.SQRT1_2;
-var localToWorld = (e, local) => {
-	const angle = e.rotate ?? 0;
-	if (angle === 0) return [e.x + local[0], e.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [e.x + local[0] * cos - local[1] * sin, e.y + local[0] * sin + local[1] * cos];
-};
-var worldToLocal = (e, world) => {
-	const tx = world[0] - e.x;
-	const ty = world[1] - e.y;
-	const angle = e.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
 /** 椭圆相关基础工具 */
 var ellipse = {
 	/** 中心 */

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

@@ -6,7 +6,7 @@ import { Position } from './point';
 export type PolarPosition = {
     /** 极坐标原点：节点 id / 笛卡尔 / 嵌套极坐标；省略表示 [0,0] */
     origin?: string | Position | PolarPosition;
-    /** 角度（度数，逆时针为正） */
+    /** 角度（度数）：从 +x 轴量起，90° 朝 +y（屏幕下方），与 ArcStep / Node label 角度约定一致 */
     angle: number;
     /** 半径（非负） */
     radius: number;
@@ -18,7 +18,7 @@ export declare const polar: {
      * @description origin 为字符串（节点 id）时抛错——字符串解析依赖 Scene 编译器 nodeIndex
      */
     toPosition: (p: PolarPosition) => Position;
-    /** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
+    /** 笛卡尔 → 极坐标（point.toPolar 别名，angle ∈ (-180,180]，origin 默认 [0,0]） */
     fromPosition: (p: Position) => PolarPosition;
     /** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
     offsetFrom: (origin: Position, offset: {

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;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"}
+{"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,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAIF,oDAAoD;AACpD,eAAO,MAAM,KAAK;IAChB;;;OAGG;oBACa,aAAa,KAAG,QAAQ;IAmBxC,qEAAqE;sBACnD,QAAQ,KAAG,aAAa;IAC1C,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

@@ -1,7 +1,6 @@
 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 不参与几何计算，参与时先 toPosition） */
 var polar = {
 	/**
@@ -17,11 +16,8 @@ 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]） */
-	fromPosition: (p) => ({
-		angle: Math.atan2(p[1], p[0]) * RAD_TO_DEG,
-		radius: Math.hypot(p[0], p[1])
-	}),
+	/** 笛卡尔 → 极坐标（point.toPolar 别名，angle ∈ (-180,180]，origin 默认 [0,0]） */
+	fromPosition: (p) => point.toPolar(p),
 	/** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
 	offsetFrom: (origin, offset) => {
 		const rad = offset.angle * DEG_TO_RAD;

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,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"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AACA,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;CAUrD,CAAC"}

package/dist/es/geometry/rect.js

@@ -1,3 +1,4 @@
+import { localToWorld, worldToLocal } from "./_transform.js";
 //#region src/geometry/rect.ts
 /** 矩形 9 个标准 anchor 名常量（与 RectAnchor 配对，用 RECT_ANCHORS.NORTH 避免拼错） */
 var RECT_ANCHORS = {
@@ -11,24 +12,6 @@ var RECT_ANCHORS = {
 	SOUTH_EAST: "south-east",
 	SOUTH_WEST: "south-west"
 };
-/** 本地坐标（以中心为原点）→ 世界坐标，考虑 rect.rotate */
-var localToWorld = (r, local) => {
-	const angle = r.rotate ?? 0;
-	if (angle === 0) return [r.x + local[0], r.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [r.x + local[0] * cos - local[1] * sin, r.y + local[0] * sin + local[1] * cos];
-};
-/** 世界坐标 → 本地坐标（localToWorld 逆变换） */
-var worldToLocal = (r, world) => {
-	const tx = world[0] - r.x;
-	const ty = world[1] - r.y;
-	const angle = r.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
 var rect = {
 	/** 几何中心 */
 	center: (r) => [r.x, r.y],

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

@@ -1,6 +1,10 @@
 import { Position } from './point';
+/**
+ * 段几何采样结果：t 处坐标点 + 归一化切线向量
+ * @description 各 `*SegmentSample` 函数（line / quad / cubic / fold / arc / circle / ellipse）的统一返回形态；供 step.label emit 算位置 / 切线 / sloped 旋转角
+ */
 export type SegmentSample = {
-    /** t 处的点 */
+    /** t 处的点（user units） */
     point: Position;
     /** t 处的切线（单位向量；零向量时回退 [1, 0]） */
     tangent: Position;

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,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"}
+{"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,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/index.d.ts

@@ -2,15 +2,19 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-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 { 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, TextBlockSchema, 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, IRTextBlock, 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 { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
+/** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
+MovePathCommand, LinePathCommand, QuadPathCommand, CubicPathCommand, ArcPathCommand, EllipseArcPathCommand, ClosePathCommand, ArrowEndSpec, GroupPrim, Transform, 
+/** 3 个 named Transform 分支 */
+TranslateTransform, RotateTransform, ScaleTransform, Layout, Scene, } from './primitive';
+export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, CompileWarning, } from './compile';
+export { computeLayout, fallbackMeasurer, compileToScene } from './compile';
 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 type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
-export type { ValueOf } from './types';
+export type { ValueOf, AssertEqual } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"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,eAAe,EACf,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,WAAW,EACX,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;AACX,oDAAoD;AACpD,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,SAAS;AACT,6BAA6B;AAC7B,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,MAAM,EACN,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5E,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,OAAO,EACP,OAAO,EACP,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,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/es/index.js

@@ -2,11 +2,13 @@ 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 { OffsetPositionSchema } from "./ir/position/offset-position.js";
+import { FontSchema } from "./ir/font.js";
+import { LineSpecSchema, TextBlockSchema } from "./ir/text.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";
+import { NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema } from "./ir/node.js";
 import { CoordinateSchema } from "./ir/coordinate.js";
 import { CURRENT_IR_VERSION, ChildSchema, SceneSchema } from "./ir/scene.js";
 import { RECT_ANCHORS, rect } from "./geometry/rect.js";
@@ -14,9 +16,10 @@ import { circle } from "./geometry/circle.js";
 import { diamond } from "./geometry/diamond.js";
 import { ellipse } from "./geometry/ellipse.js";
 import { fallbackMeasurer } from "./compile/text-metrics.js";
+import { computeLayout } from "./compile/layout.js";
 import { compileToScene } from "./compile/compile.js";
 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_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 };
+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, OffsetPositionSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, circle, compileToScene, computeLayout, diamond, ellipse, fallbackMeasurer, parseTargetSugar, parseWay, point, polar, rect };

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

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 /**
  * Coordinate 占位节点（TikZ `\coordinate (m) at (3,2);` 同义）
- * @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 viewBox 扩展，与 Node 在同一 nodeIndex 注册
+ * @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 layout 扩展，与 Node 在同一 nodeIndex 注册
  */
 export declare const CoordinateSchema: z.ZodObject<{
     type: z.ZodLiteral<"coordinate">;

package/dist/es/ir/coordinate.js

@@ -6,7 +6,7 @@ import { z } from "zod";
 //#region src/ir/coordinate.ts
 /**
 * Coordinate 占位节点（TikZ `\coordinate (m) at (3,2);` 同义）
-* @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 viewBox 扩展，与 Node 在同一 nodeIndex 注册
+* @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 layout 扩展，与 Node 在同一 nodeIndex 注册
 */
 var CoordinateSchema = z.object({
 	type: z.literal("coordinate").describe("Discriminator marking this child as a coordinate placeholder"),

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

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/** 字体规格：family/size/weight/style 全部可选 */
+export declare const FontSchema: z.ZodObject<{
+    family: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+    style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+}, "strip", z.ZodTypeAny, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}>;
+/** 字体规格 IR 类型（所有字段可选，编译期解析默认值） */
+export type IRFont = z.infer<typeof FontSchema>;
+//# sourceMappingURL=font.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"font.d.ts","sourceRoot":"","sources":["../../../src/ir/font.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAyBpB,CAAC;AAEJ,kCAAkC;AAClC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/es/ir/font.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+//#region src/ir/font.ts
+/** 字体规格：family/size/weight/style 全部可选 */
+var FontSchema = z.object({
+	family: z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
+	size: z.number().positive().finite().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
+	weight: z.union([z.enum(["normal", "bold"]), z.number().finite()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
+	style: z.enum([
+		"normal",
+		"italic",
+		"oblique"
+	]).optional().describe("CSS font-style")
+}).describe("Font properties (family / size / weight / style). All fields optional; consumed by Node text / Node label / LineSpec / future TikZ / Scope font defaults.");
+//#endregion
+export { FontSchema };

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

@@ -1,4 +1,6 @@
 export * from './position';
+export * from './font';
+export * from './text';
 export * from './path';
 export * from './node';
 export * from './coordinate';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}