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

package/dist/lib/geometry/diamond.cjs

@@ -1,27 +1,12 @@
+const require__transform = require("./_transform.cjs");
 //#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 = {
 	/** 中心 */
 	center: (d) => [d.x, d.y],
 	/** 点是否在菱形内（含边界，含旋转）；方程 |x|/halfA + |y|/halfB ≤ 1 */
 	contains: (d, p) => {
-		const [lx, ly] = worldToLocal(d, p);
+		const [lx, ly] = require__transform.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=中心 */
@@ -59,18 +44,18 @@ var diamond = {
 				ly = d.halfB / 2;
 				break;
 		}
-		return localToWorld(d, [lx, ly]);
+		return require__transform.localToWorld(d, [lx, ly]);
 	},
 	/**
 	* 从中心向 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);
+		const [lx, ly] = require__transform.worldToLocal(d, toward);
 		const denom = Math.abs(lx) / d.halfA + Math.abs(ly) / d.halfB;
 		if (denom === 0) return [d.x, d.y];
 		const t = 1 / denom;
-		return localToWorld(d, [lx * t, ly * t]);
+		return require__transform.localToWorld(d, [lx * t, ly * t]);
 	}
 };
 //#endregion

package/dist/lib/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/lib/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/lib/geometry/ellipse.cjs

@@ -1,28 +1,13 @@
+const require__transform = require("./_transform.cjs");
 //#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 = {
 	/** 中心 */
 	center: (e) => [e.x, e.y],
 	/** 判断点是否在椭圆内（含边界，考虑旋转） */
 	contains: (e, p) => {
-		const [lx, ly] = worldToLocal(e, p);
+		const [lx, ly] = require__transform.worldToLocal(e, p);
 		return lx * lx / (e.rx * e.rx) + ly * ly / (e.ry * e.ry) <= 1;
 	},
 	/**
@@ -63,19 +48,19 @@ var ellipse = {
 				ly = e.ry * SQRT_HALF;
 				break;
 		}
-		return localToWorld(e, [lx, ly]);
+		return require__transform.localToWorld(e, [lx, ly]);
 	},
 	/**
 	* 从中心向 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);
+		const [lx, ly] = require__transform.worldToLocal(e, toward);
 		if (lx === 0 && ly === 0) return [e.x, e.y];
 		const a = lx / e.rx;
 		const b = ly / e.ry;
 		const t = 1 / Math.sqrt(a * a + b * b);
-		return localToWorld(e, [lx * t, ly * t]);
+		return require__transform.localToWorld(e, [lx * t, ly * t]);
 	}
 };
 //#endregion

package/dist/lib/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/lib/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/lib/geometry/polar.cjs

@@ -1,7 +1,6 @@
 const require_point = require("./point.cjs");
 //#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) => require_point.point.toPolar(p),
 	/** 在原点附近按极坐标偏移，返回结果点的世界笛卡尔坐标 */
 	offsetFrom: (origin, offset) => {
 		const rad = offset.angle * DEG_TO_RAD;

package/dist/lib/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/lib/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/lib/geometry/rect.cjs

@@ -1,3 +1,4 @@
+const require__transform = require("./_transform.cjs");
 //#region src/geometry/rect.ts
 /** 矩形 9 个标准 anchor 名常量（与 RectAnchor 配对，用 RECT_ANCHORS.NORTH 避免拼错） */
 var RECT_ANCHORS = {
@@ -11,30 +12,12 @@ 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],
 	/** 点是否在矩形内（含边界，含旋转） */
 	contains: (r, p) => {
-		const [lx, ly] = worldToLocal(r, p);
+		const [lx, ly] = require__transform.worldToLocal(r, p);
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
 		return lx >= -halfW && lx <= halfW && ly >= -halfH && ly <= halfH;
@@ -76,18 +59,18 @@ var rect = {
 				ly = halfH;
 				break;
 		}
-		return localToWorld(r, [lx, ly]);
+		return require__transform.localToWorld(r, [lx, ly]);
 	},
 	/** 从中心向 toward 方向射线与矩形边界交点（含旋转），Path 端点贴 Node 边界用 */
 	boundaryPoint: (r, toward) => {
-		const [localX, localY] = worldToLocal(r, toward);
+		const [localX, localY] = require__transform.worldToLocal(r, toward);
 		if (localX === 0 && localY === 0) return [r.x, r.y];
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
 		const tx = localX === 0 ? Infinity : halfW / Math.abs(localX);
 		const ty = localY === 0 ? Infinity : halfH / Math.abs(localY);
 		const t = Math.min(tx, ty);
-		return localToWorld(r, [localX * t, localY * t]);
+		return require__transform.localToWorld(r, [localX * t, localY * t]);
 	}
 };
 //#endregion

package/dist/lib/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/lib/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/lib/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/lib/index.cjs

@@ -3,6 +3,8 @@ const require_position = require("./ir/position/position.cjs");
 const require_polar_position = require("./ir/position/polar-position.cjs");
 const require_at_position = require("./ir/position/at-position.cjs");
 const require_offset_position = require("./ir/position/offset-position.cjs");
+const require_font = require("./ir/font.cjs");
+const require_text = require("./ir/text.cjs");
 const require_arrow = require("./ir/path/arrow.cjs");
 const require_target = require("./ir/path/target.cjs");
 const require_step = require("./ir/path/step.cjs");
@@ -15,6 +17,7 @@ const require_circle = require("./geometry/circle.cjs");
 const require_diamond = require("./geometry/diamond.cjs");
 const require_ellipse = require("./geometry/ellipse.cjs");
 const require_text_metrics = require("./compile/text-metrics.cjs");
+const require_layout = require("./compile/layout.cjs");
 const require_compile = require("./compile/compile.cjs");
 const require_parseTargetSugar = require("./parsers/parseTargetSugar.cjs");
 const require_parseWay = require("./parsers/parseWay.cjs");
@@ -40,16 +43,15 @@ exports.CycleStepSchema = require_step.CycleStepSchema;
 exports.DrawWay = require_parseWay.DrawWay;
 exports.EllipsePathStepSchema = require_step.EllipsePathStepSchema;
 exports.FoldStepSchema = require_step.FoldStepSchema;
-exports.FontSchema = require_node.FontSchema;
+exports.FontSchema = require_font.FontSchema;
 exports.HOLLOW_ARROW_SHAPES = require_arrow.HOLLOW_ARROW_SHAPES;
-exports.LineSpecSchema = require_node.LineSpecSchema;
+exports.LineSpecSchema = require_text.LineSpecSchema;
 exports.LineStepSchema = require_step.LineStepSchema;
 exports.MoveStepSchema = require_step.MoveStepSchema;
 exports.NODE_SHAPES = require_node.NODE_SHAPES;
 exports.NODE_TEXT_ALIGNS = require_node.NODE_TEXT_ALIGNS;
 exports.NodeLabelSchema = require_node.NodeLabelSchema;
 exports.NodeSchema = require_node.NodeSchema;
-exports.NodeTextSchema = require_node.NodeTextSchema;
 exports.OffsetPositionSchema = require_offset_position.OffsetPositionSchema;
 exports.PathSchema = require_path.PathSchema;
 exports.PolarPositionSchema = require_polar_position.PolarPositionSchema;
@@ -61,8 +63,10 @@ exports.SceneSchema = require_scene.SceneSchema;
 exports.StepLabelSchema = require_step.StepLabelSchema;
 exports.StepSchema = require_step.StepSchema;
 exports.TargetSchema = require_target.TargetSchema;
+exports.TextBlockSchema = require_text.TextBlockSchema;
 exports.circle = require_circle.circle;
 exports.compileToScene = require_compile.compileToScene;
+exports.computeLayout = require_layout.computeLayout;
 exports.diamond = require_diamond.diamond;
 exports.ellipse = require_ellipse.ellipse;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;

package/dist/lib/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/lib/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/lib/ir/coordinate.cjs

@@ -6,7 +6,7 @@ let zod = require("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 = zod.z.object({
 	type: zod.z.literal("coordinate").describe("Discriminator marking this child as a coordinate placeholder"),

package/dist/lib/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/lib/ir/font.cjs

@@ -0,0 +1,15 @@
+let zod = require("zod");
+//#region src/ir/font.ts
+/** 字体规格：family/size/weight/style 全部可选 */
+var FontSchema = zod.z.object({
+	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
+	size: zod.z.number().positive().finite().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
+	weight: zod.z.union([zod.z.enum(["normal", "bold"]), zod.z.number().finite()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
+	style: zod.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
+exports.FontSchema = FontSchema;

package/dist/lib/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/lib/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/lib/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/lib/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"}

package/dist/lib/ir/node.cjs

@@ -2,6 +2,8 @@ const require_position = require("./position/position.cjs");
 const require_polar_position = require("./position/polar-position.cjs");
 const require_at_position = require("./position/at-position.cjs");
 const require_offset_position = require("./position/offset-position.cjs");
+const require_font = require("./font.cjs");
+const require_text = require("./text.cjs");
 let zod = require("zod");
 //#region src/ir/node.ts
 /**
@@ -14,32 +16,6 @@ var NODE_SHAPES = {
 	ellipse: "ellipse",
 	diamond: "diamond"
 };
-/** 节点字体规格：family/size/weight/style 全部可选，透传 SVG `<text>` font-* 属性 */
-var FontSchema = zod.z.object({
-	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
-	size: zod.z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
-	weight: zod.z.union([zod.z.enum(["normal", "bold"]), zod.z.number()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
-	style: zod.z.enum([
-		"normal",
-		"italic",
-		"oblique"
-	]).optional().describe("CSS font-style")
-}).describe("Font properties for the node text label; all fields optional, nested object form.");
-/**
-* 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
-* @description 行级覆盖只生效于本行 `<tspan>`；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
-*/
-var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
-	text: zod.z.string().describe("Line content"),
-	fill: zod.z.string().optional().describe("Per-line text color; overrides block default"),
-	opacity: zod.z.number().min(0).max(1).optional().describe("Per-line opacity 0..1"),
-	font: FontSchema.optional().describe("Per-line font overrides; missing fields inherit from block-level `font`")
-})]).describe("Single line of text: bare string for default styling, or an object with per-line `fill` / `opacity` / `font` overrides.");
-/**
-* 节点文本：单字符串或非空多行 LineSpec 数组
-* @description 选数组而非 `\n` 字符串：JSON 友好无 escape，行级覆盖天然落字段
-*/
-var NodeTextSchema = zod.z.union([zod.z.string(), zod.z.array(LineSpecSchema).min(1)]).describe("Text label rendered inside the node: a single string for one line, or a non-empty array of line specs (string for default, object for per-line overrides).");
 /** 节点文本对齐（TikZ `align=` 同义） */
 var NODE_TEXT_ALIGNS = {
 	left: "left",
@@ -48,7 +24,7 @@ var NODE_TEXT_ALIGNS = {
 };
 /**
 * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
-* @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
+* @description 可挂多个；label 不参与 layout。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
 */
 var NodeLabelSchema = zod.z.object({
 	text: zod.z.string().describe("Label text content; rendered as a single line."),
@@ -56,7 +32,7 @@ var NodeLabelSchema = zod.z.object({
 	distance: zod.z.number().nonnegative().optional().describe("Gap between the node border and the label center, in user units. Default 4."),
 	textColor: zod.z.string().optional().describe("Label text color; falls back to currentColor."),
 	opacity: zod.z.number().min(0).max(1).optional().describe("Label-only opacity 0..1; multiplied with the node opacity if both are set."),
-	font: FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults.")
+	font: require_font.FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults.")
 }).describe("Extra text attached around a node border. Multiple labels supported via array form on `Node.label`.");
 var NodeSchema = zod.z.object({
 	type: zod.z.literal("node").describe("Discriminator marking this child as a node"),
@@ -69,7 +45,7 @@ var NodeSchema = zod.z.object({
 		require_offset_position.OffsetPositionSchema
 	]).describe("Center point of the node content box; Cartesian [x, y], polar, relative-to-another-node (`at`-style with `direction` / `of` / `distance?`), or offset from a base point (`{ of, offset }` form mirroring TikZ `calc`). All non-Cartesian forms resolve at compile time."),
 	rotate: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: NodeTextSchema.optional(),
+	text: require_text.TextBlockSchema.optional(),
 	align: zod.z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
 	lineHeight: zod.z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	fill: zod.z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
@@ -79,8 +55,8 @@ var NodeSchema = zod.z.object({
 	strokeWidth: zod.z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
 	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
 	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
-	dashArray: zod.z.string().optional().describe("Explicit SVG stroke-dasharray value (e.g. \"4 2\"); overrides `dashed` / `dotted`."),
-	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape (rx / ry on `<rect>`)."),
+	dashArray: zod.z.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
+	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape."),
 	minimumWidth: zod.z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: zod.z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
 	minimumSize: zod.z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),
@@ -94,14 +70,11 @@ var NodeSchema = zod.z.object({
 	outerSep: zod.z.number().nonnegative().optional().describe("Outer margin from border to path attachment point in user units; does NOT change the visible border. Falls back to `margin`."),
 	padding: zod.z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
 	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
-	font: FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults."),
+	font: require_font.FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults."),
 	label: zod.z.union([NodeLabelSchema, zod.z.array(NodeLabelSchema)]).optional().describe("Extra label(s) attached around the node border (TikZ `[label=above:foo]`); single object or array form. Compiled into one TextPrim per label, positioned by `position` direction / angle and `distance`.")
 }).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
-exports.FontSchema = FontSchema;
-exports.LineSpecSchema = LineSpecSchema;
 exports.NODE_SHAPES = NODE_SHAPES;
 exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
 exports.NodeLabelSchema = NodeLabelSchema;
 exports.NodeSchema = NodeSchema;
-exports.NodeTextSchema = NodeTextSchema;