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

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

@@ -1,15 +1,27 @@
 import { IR } from '../ir';
 import { Scene } from '../primitive';
 import { TextMeasurer } from './text-metrics';
+/** 编译期警告：path / position 解析失败时通过 `CompileOptions.onWarn` 发出，不影响编译产物 */
+export type CompileWarning = {
+    /**
+     * 警告类型代码（机器可读）
+     * @description 用户可按 code 分支处理；未来 alpha 加新 code 不破坏调用方
+     */
+    code: 'UNRESOLVED_NODE_REFERENCE' | 'PATH_TOO_SHORT' | 'ANCHOR_RESOLUTION_FAILED' | 'OFFSET_BASE_UNRESOLVED' | 'POLAR_ORIGIN_UNRESOLVED' | 'AT_TARGET_UNRESOLVED' | 'RELATIVE_INITIAL_NO_PREV_END' | 'BBOX_EXTREME_INPUT' | (string & {});
+    /** 人类可读消息（英文） */
+    message: string;
+    /** IR locator 路径（jq-like，如 `'children[3].path.children[1].to'`） */
+    path: string;
+};
 /** compileToScene 的可选参数 */
 export type CompileOptions = {
     /** 注入文字度量函数；不传则用 fallback（不准但可跑） */
     measureText?: TextMeasurer;
-    /** viewBox 周围的留白（user units），默认 10 */
+    /** layout 周围的留白（user units），默认 10 */
     padding?: number;
     /**
      * 输出坐标的小数位精度；默认 2
-     * @description 仅作用于 Scene primitive / path d / viewBox；内部几何计算保持完整 double 精度
+     * @description 仅作用于 Scene primitive / path d / layout；内部几何计算保持完整 double 精度
      */
     precision?: number;
     /**
@@ -17,10 +29,15 @@ export type CompileOptions = {
      * @description `Node.position` 为 `{ direction, of }` 且未自带 `distance` 时取此值；未配回退到 1
      */
     nodeDistance?: number;
+    /**
+     * 编译期警告收集器
+     * @description path / position 解析失败时按 IR locator + code + message 同步触发；不传时 dev 模式（`process.env.NODE_ENV !== 'production'`）默认 `console.warn`、生产静默
+     */
+    onWarn?: (warning: CompileWarning) => void;
 };
 /**
  * IR → Scene 纯函数转换，所有 adapter 共享
- * @description Pass 1 处理 Node/coordinate 并注册 nodeIndex、发 primitive、累积 bbox；Pass 2 解析 Path 端点写 d 字符串；末端按 precision 折算 viewBox
+ * @description Pass 1 处理 Node/coordinate 并注册 nodeIndex、发 primitive、累积 bbox；Pass 2 解析 Path 端点写 d 字符串；末端按 precision 折算 layout
  */
 export declare const compileToScene: (ir: IR, options?: CompileOptions) => Scene;
 //# sourceMappingURL=compile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,cAAc,CAAC;AAK1D,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAuBrE,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KAsDrE,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,cAAc,CAAC;AAK1D,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAuBrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C,CAAC;AAWF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KAkErE,CAAC"}

package/dist/es/compile/compile.js

@@ -2,9 +2,9 @@ import { rect } from "../geometry/rect.js";
 import { resolvePosition } from "./position.js";
 import { emitNodePrimitives, layoutNode } from "./node.js";
 import { fallbackMeasurer } from "./text-metrics.js";
-import { emitPathPrimitive } from "./path.js";
+import { emitPathPrimitive } from "./path/index.js";
 import { makeRound } from "./precision.js";
-import { computeViewBox } from "./view-box.js";
+import { computeLayout } from "./layout.js";
 //#region src/compile/compile.ts
 /**
 * 把 coordinate 注册成 0×0 NodeLayout
@@ -29,37 +29,62 @@ var coordinateAsLayout = (id, center) => ({
 	fontSize: 0
 });
 /**
+* 默认 warn dispatcher：dev 模式 console.warn、生产静默
+* @description 用户传 onWarn 时使用用户的；不传走此 fallback
+*/
+var defaultWarnDispatcher = (warning) => {
+	if (typeof process !== "undefined" && process.env.NODE_ENV === "production") return;
+	console.warn(`[retikz] ${warning.code} at ${warning.path}: ${warning.message}`);
+};
+/**
 * IR → Scene 纯函数转换，所有 adapter 共享
-* @description Pass 1 处理 Node/coordinate 并注册 nodeIndex、发 primitive、累积 bbox；Pass 2 解析 Path 端点写 d 字符串；末端按 precision 折算 viewBox
+* @description Pass 1 处理 Node/coordinate 并注册 nodeIndex、发 primitive、累积 bbox；Pass 2 解析 Path 端点写 d 字符串；末端按 precision 折算 layout
 */
 var compileToScene = (ir, options = {}) => {
 	const measureText = options.measureText ?? fallbackMeasurer;
-	const viewBoxPadding = options.padding ?? 10;
+	const layoutPadding = options.padding ?? 10;
 	const round = makeRound(options.precision ?? 2);
 	const nodeDistance = options.nodeDistance;
+	const onWarn = options.onWarn ?? defaultWarnDispatcher;
 	const primitives = [];
 	const nodeIndex = /* @__PURE__ */ new Map();
 	const allPoints = [];
-	for (const child of ir.children) if (child.type === "node") {
-		const layout = layoutNode(child, measureText, nodeIndex, nodeDistance);
-		if (child.id) nodeIndex.set(child.id, layout);
-		for (const prim of emitNodePrimitives(layout, round)) primitives.push(prim);
-		allPoints.push(rect.anchor(layout.rect, "north-west"), rect.anchor(layout.rect, "north-east"), rect.anchor(layout.rect, "south-west"), rect.anchor(layout.rect, "south-east"));
-	} else if (child.type === "coordinate") {
-		const center = resolvePosition(child.position, nodeIndex, nodeDistance);
-		if (!center) throw new Error(`Cannot resolve position for coordinate ${child.id}; polar.origin or at.of may reference an undefined node`);
-		nodeIndex.set(child.id, coordinateAsLayout(child.id, center));
+	for (let i = 0; i < ir.children.length; i++) {
+		const child = ir.children[i];
+		if (child.type === "node") {
+			const layout = layoutNode(child, measureText, nodeIndex, nodeDistance);
+			if (child.id) nodeIndex.set(child.id, layout);
+			for (const prim of emitNodePrimitives(layout, round)) primitives.push(prim);
+			allPoints.push(rect.anchor(layout.rect, "north-west"), rect.anchor(layout.rect, "north-east"), rect.anchor(layout.rect, "south-west"), rect.anchor(layout.rect, "south-east"));
+		} else if (child.type === "coordinate") {
+			const center = resolvePosition(child.position, nodeIndex, nodeDistance);
+			if (!center) {
+				onWarn({
+					code: "POLAR_ORIGIN_UNRESOLVED",
+					message: `Cannot resolve position for coordinate '${child.id}'; polar.origin or at.of may reference an undefined node`,
+					path: `children[${i}].coordinate.position`
+				});
+				throw new Error(`Cannot resolve position for coordinate ${child.id}; polar.origin or at.of may reference an undefined node`);
+			}
+			nodeIndex.set(child.id, coordinateAsLayout(child.id, center));
+		}
 	}
-	for (const child of ir.children) if (child.type === "path") {
-		const result = emitPathPrimitive(child, nodeIndex, round, measureText);
-		if (result) {
-			for (const prim of result.primitives) primitives.push(prim);
-			for (const p of result.points) allPoints.push(p);
+	for (let i = 0; i < ir.children.length; i++) {
+		const child = ir.children[i];
+		if (child.type === "path") {
+			const result = emitPathPrimitive(child, nodeIndex, round, measureText, {
+				onWarn,
+				irPath: `children[${i}].path`
+			});
+			if (result) {
+				for (const prim of result.primitives) primitives.push(prim);
+				for (const p of result.points) allPoints.push(p);
+			}
 		}
 	}
 	return {
 		primitives,
-		viewBox: computeViewBox(allPoints, viewBoxPadding, round)
+		layout: computeLayout(allPoints, layoutPadding, round)
 	};
 };
 //#endregion

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

@@ -1,9 +1,9 @@
 export * from './compile';
 export * from './node';
 export * from './parseTarget';
-export * from './path';
+export * from './path/index';
 export * from './position';
 export * from './precision';
 export * from './text-metrics';
-export * from './view-box';
+export * from './layout';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compile/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compile/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,5 @@
+import { IRPosition } from '../ir';
+import { Layout } from '../primitive';
+/** 由所有 bbox 候选点算出布局边界（含 padding）；points 为空时返回 100×100 兜底 */
+export declare const computeLayout: (points: Array<IRPosition>, padding: number, round: (n: number) => number) => Layout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/es/compile/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/compile/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,4DAA4D;AAC5D,eAAO,MAAM,aAAa,GACxB,QAAQ,KAAK,CAAC,UAAU,CAAC,EACzB,SAAS,MAAM,EACf,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,MAkBF,CAAC"}

package/dist/es/compile/{view-box.js → layout.js}

@@ -1,6 +1,6 @@
-//#region src/compile/view-box.ts
-/** 由所有 bbox 候选点算出 viewBox（含 padding）；points 为空时返回 100×100 兜底 */
-var computeViewBox = (points, padding, round) => {
+//#region src/compile/layout.ts
+/** 由所有 bbox 候选点算出布局边界（含 padding）；points 为空时返回 100×100 兜底 */
+var computeLayout = (points, padding, round) => {
 	if (points.length === 0) return {
 		x: 0,
 		y: 0,
@@ -25,4 +25,4 @@ var computeViewBox = (points, padding, round) => {
 	};
 };
 //#endregion
-export { computeViewBox };
+export { computeLayout };

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

@@ -13,7 +13,7 @@ export type NodeLayout = {
      * @description rectangle: rect 本身；circle: width=height=2×radius；ellipse: 2×rx,2×ry；diamond: 2×halfA,2×halfB。x,y 是几何中心，rotate 弧度
      */
     rect: Rect;
-    /** IR 原始旋转角（度数），供 emit 写 SVG transform */
+    /** IR 原始旋转角（度数），供 emit 阶段写入 GroupPrim 的 rotate transform */
     rotateDeg: number;
     /** 外边距（≥ 0），path 附着到外扩 margin 的虚拟边界 */
     margin: number;
@@ -26,7 +26,7 @@ export type NodeLayout = {
     textWidth: number;
     /** 文本块高度 ≈ lines × lineHeight */
     textHeight: number;
-    /** 文本对齐（已映射到 SVG textAnchor 三态） */
+    /** 文本对齐（start / middle / end 三态） */
     align: 'start' | 'middle' | 'end';
     /** 行高（已应用默认值） */
     lineHeight: number;
@@ -48,8 +48,8 @@ export type NodeLayout = {
     strokeOpacity?: number;
     /** 边框宽度，emit 时 1 兜底 */
     strokeWidth?: number;
-    /** SVG stroke-dasharray，已把 dashed/dotted 预设解析为具体 pattern */
-    strokeDasharray?: string;
+    /** 描边 dash pattern，已把 dashed/dotted 预设解析为具体 pattern */
+    dashPattern?: Array<number>;
     /** rectangle 圆角半径（非 rect shape 无效） */
     roundedCorners?: number;
     /** 文字颜色，emit 时 'currentColor' 兜底 */

package/dist/es/compile/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"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"}

package/dist/es/compile/node.js

@@ -12,16 +12,16 @@ var DEG_TO_RAD = Math.PI / 180;
 var DEFAULT_LABEL_DISTANCE = 4;
 var SQRT2 = Math.SQRT2;
 /** dashed 预设：4 px 实线 + 2 px 间隙循环 */
-var DASHED_PATTERN = "4 2";
+var DASHED_PATTERN = [4, 2];
 /** dotted 预设：1 px 圆点 + 2 px 间隙 */
-var DOTTED_PATTERN = "1 2";
+var DOTTED_PATTERN = [1, 2];
 /** dashed / dotted / dashArray 优先级：dashArray > dashed > dotted */
 var resolveDashArray = (dashArray, dashed, dotted) => {
 	if (dashArray !== void 0) return dashArray;
 	if (dashed) return DASHED_PATTERN;
 	if (dotted) return DOTTED_PATTERN;
 };
-/** IR align → SVG textAnchor */
+/** IR align → 文字对齐锚点（start / middle / end） */
 var alignToTextAnchor = (a) => a === "left" ? "start" : a === "right" ? "end" : "middle";
 /** 从 layout 构造 Rect（带 margin 扩张） */
 var rectOf = (layout, marginAdd) => ({
@@ -259,7 +259,7 @@ var layoutNode = (node, measureText, nodeIndex, nodeDistance) => {
 		stroke: node.stroke,
 		strokeOpacity: node.drawOpacity,
 		strokeWidth: node.strokeWidth,
-		strokeDasharray: resolveDashArray(node.dashArray, node.dashed, node.dotted),
+		dashPattern: resolveDashArray(node.dashArray, node.dashed, node.dotted),
 		roundedCorners: node.roundedCorners,
 		textColor: node.textColor,
 		opacity: node.opacity,
@@ -281,7 +281,7 @@ var emitRectShape = (layout, round) => {
 		stroke: layout.stroke ?? "currentColor",
 		strokeOpacity: layout.strokeOpacity,
 		strokeWidth: layout.strokeWidth ?? 1,
-		strokeDasharray: layout.strokeDasharray,
+		dashPattern: layout.dashPattern,
 		cornerRadius: layout.roundedCorners,
 		opacity: layout.opacity
 	};
@@ -298,7 +298,7 @@ var emitEllipseShape = (layout, round) => ({
 	stroke: layout.stroke ?? "currentColor",
 	strokeOpacity: layout.strokeOpacity,
 	strokeWidth: layout.strokeWidth ?? 1,
-	strokeDasharray: layout.strokeDasharray,
+	dashPattern: layout.dashPattern,
 	opacity: layout.opacity
 });
 /** diamond → PathPrim（4 顶点 + close 闭合） */
@@ -334,7 +334,7 @@ var emitDiamondShape = (layout, round) => {
 		stroke: layout.stroke ?? "currentColor",
 		strokeOpacity: layout.strokeOpacity,
 		strokeWidth: layout.strokeWidth ?? 1,
-		strokeDasharray: layout.strokeDasharray,
+		dashPattern: layout.dashPattern,
 		opacity: layout.opacity
 	};
 };

package/dist/es/compile/path/anchor.d.ts

@@ -0,0 +1,19 @@
+import { IRPosition, IRTarget } from '../../ir';
+import { NodeLayout } from '../node';
+/**
+ * 求 step.to 的参考点（给 boundary clip 算方向 / 折角 corner 用）
+ * @description 三态：`'A'`(auto) 节点中心；`'A.<anchor>'`/`'A.<deg>'` 显式锚点 refPoint=endpoint 位置不随邻居变。直接坐标/极坐标解析为笛卡尔
+ */
+export declare const refPointOfTarget: (target: IRTarget, nodeIndex: Map<string, NodeLayout>) => IRPosition | null;
+/** 折角中间点：`-|` → (curr.x, prev.y)；`|-` → (prev.x, curr.y) */
+export declare const cornerOf: (prev: IRPosition, curr: IRPosition, via: "-|" | "|-") => IRPosition;
+/**
+ * 在 toward 方向算 step.to 的实际绘制端点
+ * @description 节点 auto `'A'`：按 shape 走 boundaryPointOf 求中心→toward 射线交点；命名 anchor/角度：位置已定不受 toward 影响；直接坐标/极坐标：解析后返回；失败返回 null
+ */
+export declare const clipForTarget: (target: IRTarget, toward: IRPosition, nodeIndex: Map<string, NodeLayout>) => IRPosition | null;
+/** 两个 IRPosition 两分量精确相等（未 round） */
+export declare const samePoint: (a: IRPosition | null, b: IRPosition | null) => boolean;
+/** 把 p 朝 target 方向移动 dist */
+export declare const shiftToward: (p: IRPosition, target: IRPosition, dist: number) => IRPosition;
+//# sourceMappingURL=anchor.d.ts.map

package/dist/es/compile/path/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,KAAK,UAAU,EAA8C,MAAM,SAAS,CAAC;AAItF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KACjC,UAAU,GAAG,IAmBf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,IAAI,GAAG,IAAI,KACf,UACqD,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KACjC,UAAU,GAAG,IAmBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACzB,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAM7E,CAAC"}

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

@@ -0,0 +1,54 @@
+import { resolvePosition } from "../position.js";
+import { anchorOf, angleBoundaryOf, boundaryPointOf } from "../node.js";
+import { parseNodeRef } from "../parseTarget.js";
+//#region src/compile/path/anchor.ts
+/**
+* 求 step.to 的参考点（给 boundary clip 算方向 / 折角 corner 用）
+* @description 三态：`'A'`(auto) 节点中心；`'A.<anchor>'`/`'A.<deg>'` 显式锚点 refPoint=endpoint 位置不随邻居变。直接坐标/极坐标解析为笛卡尔
+*/
+var refPointOfTarget = (target, nodeIndex) => {
+	if (typeof target === "string") {
+		const ref = parseNodeRef(target);
+		const node = nodeIndex.get(ref.id);
+		if (!node) return null;
+		switch (ref.kind) {
+			case "node": return [node.rect.x, node.rect.y];
+			case "anchor": return anchorOf(node, ref.anchor);
+			case "angle": return angleBoundaryOf(node, ref.angle);
+		}
+	}
+	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
+	return resolvePosition(target, nodeIndex);
+};
+/** 折角中间点：`-|` → (curr.x, prev.y)；`|-` → (prev.x, curr.y) */
+var cornerOf = (prev, curr, via) => via === "-|" ? [curr[0], prev[1]] : [prev[0], curr[1]];
+/**
+* 在 toward 方向算 step.to 的实际绘制端点
+* @description 节点 auto `'A'`：按 shape 走 boundaryPointOf 求中心→toward 射线交点；命名 anchor/角度：位置已定不受 toward 影响；直接坐标/极坐标：解析后返回；失败返回 null
+*/
+var clipForTarget = (target, toward, nodeIndex) => {
+	if (typeof target === "string") {
+		const ref = parseNodeRef(target);
+		const node = nodeIndex.get(ref.id);
+		if (!node) return null;
+		switch (ref.kind) {
+			case "node": return boundaryPointOf(node, toward);
+			case "anchor": return anchorOf(node, ref.anchor);
+			case "angle": return angleBoundaryOf(node, ref.angle);
+		}
+	}
+	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
+	return resolvePosition(target, nodeIndex);
+};
+/** 两个 IRPosition 两分量精确相等（未 round） */
+var samePoint = (a, b) => !!a && !!b && a[0] === b[0] && a[1] === b[1];
+/** 把 p 朝 target 方向移动 dist */
+var shiftToward = (p, target, dist) => {
+	const dx = target[0] - p[0];
+	const dy = target[1] - p[1];
+	const len = Math.sqrt(dx * dx + dy * dy);
+	if (len === 0 || dist === 0) return p;
+	return [p[0] + dx / len * dist, p[1] + dy / len * dist];
+};
+//#endregion
+export { clipForTarget, cornerOf, refPointOfTarget, samePoint, shiftToward };

package/dist/es/compile/path/arrow-geometry.d.ts

@@ -0,0 +1,22 @@
+import { ArrowShape } from '../../ir';
+import { ArrowEndSpec } from '../../primitive';
+/** 箭头形状几何：供路径端点收缩计算使用 */
+export type ArrowShapeGeometry = {
+    /** 标准局部坐标基准尺寸 */
+    baseSize: number;
+    /** 箭头尖端在标准局部坐标里的 x 位置 */
+    tipX: number;
+    /** 路径线段应接触箭头尾部或凹口的位置 */
+    lineContactX: number;
+    /** 默认箭头长度 */
+    defaultLength: number;
+    /** 默认箭头宽度 */
+    defaultWidth: number;
+    /** 空心箭头默认描边宽度 */
+    hollowLineWidth?: number;
+};
+/** 箭头形状是否为空心描边形状 */
+export declare const isHollowArrowShape: (shape: ArrowShape) => boolean;
+/** 解析端点箭头在标准局部坐标中的中性几何 */
+export declare const resolveArrowShapeGeometry: (spec: ArrowEndSpec) => ArrowShapeGeometry;
+//# sourceMappingURL=arrow-geometry.d.ts.map

package/dist/es/compile/path/arrow-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrow-geometry.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/arrow-geometry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,yBAAyB;AACzB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,KAAG,OACvB,CAAC;AAEjC,0BAA0B;AAC1B,eAAO,MAAM,yBAAyB,GAAI,MAAM,YAAY,KAAG,kBAgC9D,CAAC"}

package/dist/es/compile/path/arrow-geometry.js

@@ -0,0 +1,40 @@
+import { HOLLOW_ARROW_SHAPES } from "../../ir/path/arrow.js";
+//#region src/compile/path/arrow-geometry.ts
+/** 标准箭头局部坐标基准尺寸 */
+var ARROW_GEOMETRY_BASE_SIZE = 10;
+/** 箭头形状是否为空心描边形状 */
+var isHollowArrowShape = (shape) => HOLLOW_ARROW_SHAPES.has(shape);
+/** 解析端点箭头在标准局部坐标中的中性几何 */
+var resolveArrowShapeGeometry = (spec) => {
+	const lineWidth = spec.lineWidth ?? 1.5;
+	const base = {
+		baseSize: ARROW_GEOMETRY_BASE_SIZE,
+		tipX: ARROW_GEOMETRY_BASE_SIZE,
+		lineContactX: 0,
+		defaultLength: 6,
+		defaultWidth: 6
+	};
+	switch (spec.shape) {
+		case "normal":
+		case "diamond":
+		case "circle": return base;
+		case "stealth": return {
+			...base,
+			lineContactX: 3
+		};
+		case "open":
+		case "openDiamond": return {
+			...base,
+			tipX: 9,
+			lineContactX: 1 - lineWidth / 2,
+			hollowLineWidth: lineWidth
+		};
+		case "openCircle": return {
+			...base,
+			lineContactX: 0,
+			hollowLineWidth: lineWidth
+		};
+	}
+};
+//#endregion
+export { isHollowArrowShape, resolveArrowShapeGeometry };

package/dist/es/compile/{path.d.ts → path/index.d.ts}

@@ -1,13 +1,24 @@
-import { IRPath, IRPosition } from '../ir';
-import { ScenePrimitive } from '../primitive';
-import { NodeLayout } from './node';
-import { TextMeasurer } from './text-metrics';
+import { IRPath, IRPosition } from '../../ir';
+import { ScenePrimitive } from '../../primitive';
+import { NodeLayout } from '../node';
+import { TextMeasurer } from '../text-metrics';
+/** emitPathPrimitive 可选 warn 钩子 */
+export type EmitPathWarnHook = {
+    /** 警告收集器（由 compileToScene 传入） */
+    onWarn?: (warning: {
+        code: string;
+        message: string;
+        path: string;
+    }) => void;
+    /** 当前 path 在 IR 中的 locator 前缀（如 `'children[3].path'`） */
+    irPath?: string;
+};
 /**
  * IR Path → PathPrim
- * @description 每个绘制段独立用节点中心算两端 boundary clip——中段节点的入/出 boundary 点通常不同，path 在该节点可见"断开"（与 TikZ `\draw (A)--(B)--(C);` 段独立 clip 一致）。仍产一个 PathPrim：commands 用多组 move/line 表达 sub-path；段起点等于上段终点时复用 cursor 省 move。cycle 段闭回最近 move 起点，起点==lastEnd && 终点==subPathStart 时输出 close，否则显式画段 line。引用未定义节点/解析失败返回 null
+ * @description 每个绘制段独立用节点中心算两端 boundary clip——中段节点的入/出 boundary 点通常不同，path 在该节点可见"断开"（与 TikZ `\draw (A)--(B)--(C);` 段独立 clip 一致）。仍产一个 PathPrim：commands 用多组 move/line 表达 sub-path；段起点等于上段终点时复用 cursor 省 move。cycle 段闭回最近 move 起点，起点==lastEnd && 终点==subPathStart 时输出 close，否则显式画段 line。引用未定义节点/解析失败返回 null，并通过 `warnHook.onWarn` 同步触发 warning
  */
-export declare const emitPathPrimitive: (path: IRPath, nodeIndex: Map<string, NodeLayout>, round: (n: number) => number, measureText?: TextMeasurer) => {
+export declare const emitPathPrimitive: (path: IRPath, nodeIndex: Map<string, NodeLayout>, round: (n: number) => number, measureText?: TextMeasurer, warnHook?: EmitPathWarnHook) => {
     primitives: Array<ScenePrimitive>;
     points: Array<IRPosition>;
 } | null;
-//# sourceMappingURL=path.d.ts.map
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AA8BtE,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAClC,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA0XrE,CAAC"}