@retikz/core 0.3.0-alpha.5 → 0.3.0-beta.1

package/dist/lib/compile/node.cjs

@@ -1,6 +1,8 @@
 const require_json = require("../ir/json.cjs");
-const require__shared = require("../shapes/_shared.cjs");
+const require_arc = require("../geometry/arc.cjs");
+const require_anchor = require("../geometry/anchor.cjs");
 const require_index = require("../shapes/index.cjs");
+const require_direction = require("./direction.cjs");
 const require_position = require("./position.cjs");
 const require_text_baseline = require("./text-baseline.cjs");
 const require_boundary = require("./boundary.cjs");
@@ -14,8 +16,8 @@ var EMPTY_SHAPE_PARAMS = {};
 * @description 裸 string → `{ type, params: {} }`；`{ type, params? }` → params 缺省补 `{}`；
 *   缺省（undefined）→ `{ type: 'rectangle', params: {} }`。`'circle'`（裸 string）消解为
 *   `{ type: 'ellipse', params: { circumscribe: 'equal' } }`——circle 无独立几何，是 ellipse 等轴 preset 别名。
-*   `'diamond'`（裸 string）消解为 `{ type: 'polygon', params: { sides: 4, rotate: 45 } }`——diamond 无独立几何，
-*   是 polygon 4 边形（自旋 45°）preset 别名。仅做形态归一，不查表 / 不校验。
+*   `'diamond'`（裸 string）消解为 `{ type: 'polygon', params: { sides: 4, rotate: 0 } }`——diamond 无独立几何，
+*   是 polygon 4 边形 preset 别名。仅做形态归一，不查表 / 不校验。
 */
 var normalizeShape = (shape) => {
 	if (shape === void 0) return {
@@ -30,7 +32,7 @@ var normalizeShape = (shape) => {
 		type: "polygon",
 		params: {
 			sides: 4,
-			rotate: 45
+			rotate: 0
 		}
 	};
 	if (typeof shape === "string") return {
@@ -108,9 +110,9 @@ var DEFAULT_LABEL_DISTANCE = 12;
 var DASHED_PATTERN = [4, 2];
 /** dotted 预设：1 px 圆点 + 2 px 间隙 */
 var DOTTED_PATTERN = [1, 2];
-/** dashed / dotted / dashArray 优先级：dashArray > dashed > dotted */
-var resolveDashArray = (dashArray, dashed, dotted) => {
-	if (dashArray !== void 0) return dashArray;
+/** dashed / dotted / dashPattern 优先级：dashPattern > dashed > dotted */
+var resolveDashPattern = (dashPattern, dashed, dotted) => {
+	if (dashPattern !== void 0) return dashPattern;
 	if (dashed) return DASHED_PATTERN;
 	if (dotted) return DOTTED_PATTERN;
 };
@@ -125,6 +127,14 @@ var inflateRect = (r, m) => m === 0 ? r : {
 	rotate: r.rotate
 };
 /**
+* 视觉 rect 外扩 outerSep（margin）得到外边界 AABB
+* @description = `inflateRect(layout.rect, layout.margin)`，中心不变、四向各 +margin。border 类
+*   anchor（compass / 数字角度）解析与 bbox / viewBox / 布局占位都基于这层；视觉 emit / 裁剪 /
+*   形状专属 anchor / edgePoint / label 附着点仍读 `layout.rect`（不外扩）。单一派生量，不另存字段。
+*   （TikZ outer sep 对齐见 v0.3-beta.1 ADR-07。）
+*/
+var outerRectOf = (layout) => inflateRect(layout.rect, layout.margin);
+/**
 * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
 * @description 走连接面（boundary）对应的 def.boundaryPoint；margin > 0 时先膨胀外接 Rect，让 path 在 border 外停 margin。
 *   boundary 缺省 = 'shape'（视觉形状自身），与改前行为一致。
@@ -135,15 +145,19 @@ var boundaryPointOf = (layout, toward, boundary = "shape") => {
 };
 /**
 * 取节点 shape 命名 anchor（center / north / east / north-east 等）
-* @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点。
+* @description 纯几何：在传入的 `layout.rect` 上求点，本体**不施加 outerSep（margin）**。outerSep 的
+*   「border 外推」由调用方决定——`anchor-cache.ts` 的 compass 解析先把 rect 外扩 margin（`outerRectOf`）
+*   再调本函数；`labelBorderPoint` 喂视觉 rect（label 附着点不含 margin）。这样 outer sep 只作用于
+*   path / position 的 anchor 引用，不波及 label（详见 v0.3-beta.1 ADR-07 §1/§2）。
 *   compass（9 个 rect 方位名）走连接面 AABB：'shape' 时归一为 'rectangle'（矩形 AABB），其余按 boundary 解析。
 *   形状专属命名 anchor（tip-N / apex 等非 compass 名）恒走视觉形状自身，boundary 不影响。
-*   boundary 缺省 = 'shape'，与改前 compass 走 AABB 行为一致（原 shapeDef.anchor 内部也走 rect AABB）。
+*   boundary 缺省 = 'shape'。
 */
 var anchorOf = (layout, name, boundary = "shape") => {
-	if (require__shared.asRectAnchor(name) !== void 0) {
+	const compassAnchor = require_anchor.normalizeCompassAnchor(name);
+	if (compassAnchor !== void 0) {
 		const { def, rect, params } = require_boundary.resolveBoundary(boundary === "shape" ? "rectangle" : boundary, layout.shapeDef, layout.rect, layout.shapeParams ?? EMPTY_SHAPE_PARAMS, layout.shapes);
-		const p = def.anchor(rect, name, params);
+		const p = def.anchor(rect, compassAnchor, params);
 		if (p === void 0) throw new Error(`Unknown anchor '${name}' for shape '${layout.shapeName}'`);
 		return p;
 	}
@@ -151,41 +165,6 @@ var anchorOf = (layout, name, boundary = "shape") => {
 	if (p === void 0) throw new Error(`Unknown anchor '${name}' for shape '${layout.shapeName}'`);
 	return p;
 };
-/** 8 方向 label position → (anchorName, 单位向量)；above 视觉上方即 y 减小 */
-var LABEL_DIRECTION_MAP = {
-	above: {
-		anchor: "north",
-		vec: [0, -1]
-	},
-	below: {
-		anchor: "south",
-		vec: [0, 1]
-	},
-	left: {
-		anchor: "west",
-		vec: [-1, 0]
-	},
-	right: {
-		anchor: "east",
-		vec: [1, 0]
-	},
-	"above-left": {
-		anchor: "north-west",
-		vec: [-Math.SQRT1_2, -Math.SQRT1_2]
-	},
-	"above-right": {
-		anchor: "north-east",
-		vec: [Math.SQRT1_2, -Math.SQRT1_2]
-	},
-	"below-left": {
-		anchor: "south-west",
-		vec: [-Math.SQRT1_2, Math.SQRT1_2]
-	},
-	"below-right": {
-		anchor: "south-east",
-		vec: [Math.SQRT1_2, Math.SQRT1_2]
-	}
-};
 /**
 * 算 label 中心点（节点局部坐标系，未旋转）
 * @description 8 方向：节点对应 anchor 出发按单位向量 × distance 外推；数字角度：先取 angleBoundary 边界点再沿 (cos,sin) × distance 外推。
@@ -203,16 +182,12 @@ var labelBorderPoint = (layout, label) => {
 		}
 	};
 	if (typeof label.position === "number") return angleBoundaryOf(aaLayout, label.position);
-	const { anchor } = LABEL_DIRECTION_MAP[label.position];
-	return anchorOf(aaLayout, anchor);
+	return anchorOf(aaLayout, require_direction.LabelAnchorByAtDirection[label.position]);
 };
 var labelCenter = (layout, label) => {
 	const [bx, by] = labelBorderPoint(layout, label);
-	if (typeof label.position === "number") {
-		const rad = label.position * Math.PI / 180;
-		return [bx + Math.cos(rad) * label.distance, by + Math.sin(rad) * label.distance];
-	}
-	const { vec } = LABEL_DIRECTION_MAP[label.position];
+	if (typeof label.position === "number") return require_arc.arcEndPoint([bx, by], label.distance, label.position);
+	const vec = require_direction.DirectionVectorByAtDirection[label.position];
 	return [bx + vec[0] * label.distance, by + vec[1] * label.distance];
 };
 /** 从 label 中心朝 border 方向，求 label 框（halfW×halfH）边界交点（pin 引线终点 = label 框近 node 边） */
@@ -252,8 +227,8 @@ var resolveLabelRotateDeg = (label, lx, ly, cx, cy) => {
 };
 /**
 * 取节点 shape 在指定角度方向的边界点
-* @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。不应用 margin（同 anchorOf）；用于 `'A.30'` 落点。
-*   boundary 缺省 = 'shape'（视觉形状自身），与改前行为一致。
+* @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。本体**不施加 margin（同 anchorOf）**——outerSep 外推由 `anchor-cache.ts` 调用方喂 `outerRectOf` 实现；用于 `'A.30'` 落点。
+*   boundary 缺省 = 'shape'（视觉形状自身）。
 */
 var angleBoundaryOf = (layout, angleDeg, boundary = "shape") => {
 	const rad = angleDeg * Math.PI / 180;
@@ -271,7 +246,7 @@ var angleBoundaryOf = (layout, angleDeg, boundary = "shape") => {
 * @description 文本度量 + padding 推内框半轴；按 shape 算外接边界（circle 取半对角线、ellipse ×√2、diamond ×2）；解析 position 为几何中心；rotate 度数转弧度。
 *   `scopeChain` 非空时 `resolvePosition` 返回**当前 scope 局部坐标**（relative position 在当前
 *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
-*   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
+*   笛卡尔字面量 `Position` 已在 scope 局部度量，保持局部坐标语义。
 */
 var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], labelDefault, shapes = require_index.BUILTIN_SHAPES, resolveBetweenGlobal) => {
 	const { type: shapeName, params: rawShapeParams } = normalizeShape(node.shape);
@@ -310,12 +285,12 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 			const text = isObj ? spec.text : spec;
 			const lineFont = isObj ? spec.font : void 0;
 			const font = {
-				size: lineFont?.size ?? fontSize,
+				size: lineFont?.size !== void 0 ? lineFont.size * fontScale : fontSize,
 				family: lineFont?.family ?? fontFamily,
 				weight: lineFont?.weight ?? fontWeight,
 				style: lineFont?.style ?? fontStyle
 			};
-			const physical = maxTextWidth !== void 0 ? wrapText(text, font, maxTextWidth, measureText) : [text];
+			const physical = text.split("\n").flatMap((hardLine) => maxTextWidth !== void 0 ? wrapText(hardLine, font, maxTextWidth, measureText) : [hardLine]);
 			for (const ptext of physical) {
 				const m = measureText(ptext, font);
 				if (m.width > textWidth) textWidth = m.width;
@@ -323,7 +298,7 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 				if (isObj) {
 					if (spec.fill !== void 0) out.fill = spec.fill;
 					if (spec.opacity !== void 0) out.opacity = spec.opacity;
-					if (lineFont?.size !== void 0) out.fontSize = lineFont.size;
+					if (lineFont?.size !== void 0) out.fontSize = lineFont.size * fontScale;
 					if (lineFont?.family !== void 0) out.fontFamily = lineFont.family;
 					if (lineFont?.weight !== void 0) out.fontWeight = lineFont.weight;
 					if (lineFont?.style !== void 0) out.fontStyle = lineFont.style;
@@ -399,7 +374,7 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 		stroke: node.stroke,
 		strokeOpacity: node.drawOpacity,
 		strokeWidth: node.strokeWidth,
-		dashPattern: resolveDashArray(node.dashArray, node.dashed, node.dotted),
+		dashPattern: resolveDashPattern(node.dashPattern, node.dashed, node.dotted),
 		cornerRadius: node.cornerRadius,
 		textColor: node.textColor,
 		opacity: node.opacity,
@@ -458,12 +433,13 @@ var labelExtentPoints = (layout) => {
 	}
 	return pts;
 };
+var cloneScenePrimitive = (primitive) => ({ ...primitive });
 var emitNodePrimitives = (layout, round, resolveFill) => {
 	const axisAlignedRect = {
 		...layout.rect,
 		rotate: 0
 	};
-	const shapePrims = [...layout.shapeDef.emit(axisAlignedRect, toShapeStyle(layout, resolveFill), round, layout.shapeParams ?? EMPTY_SHAPE_PARAMS)];
+	const shapePrims = [...layout.shapeDef.emit(axisAlignedRect, toShapeStyle(layout, resolveFill), round, layout.shapeParams ?? EMPTY_SHAPE_PARAMS)].map(cloneScenePrimitive);
 	const inner = [...shapePrims];
 	if (layout.lines) {
 		const halfBlockW = layout.textWidth / 2;
@@ -527,7 +503,7 @@ var emitNodePrimitives = (layout, round, resolveFill) => {
 				lineHeight: labLineHeight,
 				fill: lab.textColor ?? "currentColor",
 				opacity: lab.opacity ?? layout.opacity,
-				measuredWidth: 0,
+				measuredWidth: round(lab.measuredWidth),
 				measuredHeight: round(lab.fontSize)
 			};
 			const deg = resolveLabelRotateDeg(lab, lx, ly, cx, cy);
@@ -572,3 +548,4 @@ exports.boundaryPointOf = boundaryPointOf;
 exports.emitNodePrimitives = emitNodePrimitives;
 exports.labelExtentPoints = labelExtentPoints;
 exports.layoutNode = layoutNode;
+exports.outerRectOf = outerRectOf;

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

@@ -1,6 +1,6 @@
 import { Position } from '../geometry/point';
 import { Rect } from '../geometry/rect';
-import { AtDirection, IRAnimationTrack, IRBoundary, IRJsonObject, IRLabelDefault, IRNode, IRPaintSpec } from '../ir';
+import { AtDirectionValue, IRAnimationTrack, IRBoundary, IRJsonObject, IRLabelDefault, IRNode, IRPaintSpec } from '../ir';
 import { PaintResolver } from './paint';
 import { ScenePrimitive, TextLine, Transform } from '../primitive';
 import { ShapeDefinition } from '../shapes';
@@ -86,7 +86,7 @@ export type NodeLayout = {
 export type NodeLabelLayout = {
     text: string;
     /** 8 方向枚举或数字角度 */
-    position: AtDirection | number;
+    position: AtDirectionValue | number;
     /** 已应用默认值 */
     distance: number;
     textColor?: string;
@@ -108,6 +108,14 @@ export type NodeLabelLayout = {
         dashPattern?: Array<number>;
     };
 };
+/**
+ * 视觉 rect 外扩 outerSep（margin）得到外边界 AABB
+ * @description = `inflateRect(layout.rect, layout.margin)`，中心不变、四向各 +margin。border 类
+ *   anchor（compass / 数字角度）解析与 bbox / viewBox / 布局占位都基于这层；视觉 emit / 裁剪 /
+ *   形状专属 anchor / edgePoint / label 附着点仍读 `layout.rect`（不外扩）。单一派生量，不另存字段。
+ *   （TikZ outer sep 对齐见 v0.3-beta.1 ADR-07。）
+ */
+export declare const outerRectOf: (layout: NodeLayout) => Rect;
 /**
  * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
  * @description 走连接面（boundary）对应的 def.boundaryPoint；margin > 0 时先膨胀外接 Rect，让 path 在 border 外停 margin。
@@ -116,16 +124,19 @@ export type NodeLabelLayout = {
 export declare const boundaryPointOf: (layout: NodeLayout, toward: Position, boundary?: IRBoundary | undefined) => Position;
 /**
  * 取节点 shape 命名 anchor（center / north / east / north-east 等）
- * @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点。
+ * @description 纯几何：在传入的 `layout.rect` 上求点，本体**不施加 outerSep（margin）**。outerSep 的
+ *   「border 外推」由调用方决定——`anchor-cache.ts` 的 compass 解析先把 rect 外扩 margin（`outerRectOf`）
+ *   再调本函数；`labelBorderPoint` 喂视觉 rect（label 附着点不含 margin）。这样 outer sep 只作用于
+ *   path / position 的 anchor 引用，不波及 label（详见 v0.3-beta.1 ADR-07 §1/§2）。
  *   compass（9 个 rect 方位名）走连接面 AABB：'shape' 时归一为 'rectangle'（矩形 AABB），其余按 boundary 解析。
  *   形状专属命名 anchor（tip-N / apex 等非 compass 名）恒走视觉形状自身，boundary 不影响。
- *   boundary 缺省 = 'shape'，与改前 compass 走 AABB 行为一致（原 shapeDef.anchor 内部也走 rect AABB）。
+ *   boundary 缺省 = 'shape'。
  */
 export declare const anchorOf: (layout: NodeLayout, name: string, boundary?: IRBoundary | undefined) => Position;
 /**
  * 取节点 shape 在指定角度方向的边界点
- * @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。不应用 margin（同 anchorOf）；用于 `'A.30'` 落点。
- *   boundary 缺省 = 'shape'（视觉形状自身），与改前行为一致。
+ * @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。本体**不施加 margin（同 anchorOf）**——outerSep 外推由 `anchor-cache.ts` 调用方喂 `outerRectOf` 实现；用于 `'A.30'` 落点。
+ *   boundary 缺省 = 'shape'（视觉形状自身）。
  */
 export declare const angleBoundaryOf: (layout: NodeLayout, angleDeg: number, boundary?: IRBoundary | undefined) => Position;
 /**
@@ -133,7 +144,7 @@ export declare const angleBoundaryOf: (layout: NodeLayout, angleDeg: number, bou
  * @description 文本度量 + padding 推内框半轴；按 shape 算外接边界（circle 取半对角线、ellipse ×√2、diamond ×2）；解析 position 为几何中心；rotate 度数转弧度。
  *   `scopeChain` 非空时 `resolvePosition` 返回**当前 scope 局部坐标**（relative position 在当前
  *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
- *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
+ *   笛卡尔字面量 `Position` 已在 scope 局部度量，保持局部坐标语义。
  */
 export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault, shapes?: Record<string, ShapeDefinition>, resolveBetweenGlobal?: ResolveBetweenGlobal) => NodeLayout;
 /**

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

@@ -77,7 +77,7 @@ var createPaintRegistry = (effectivePatterns, round) => {
 				id,
 				spec: fill
 			};
-			if (fill.type === "pattern") resource.tile = resolvePatternTile(fill, effectivePatterns, round);
+			if (fill.kind === "pattern") resource.tile = resolvePatternTile(fill, effectivePatterns, round);
 			list.push(resource);
 		}
 		return {

package/dist/lib/compile/path/anchor.cjs

@@ -1,4 +1,6 @@
-const require__edge = require("../../geometry/_edge.cjs");
+const require_step = require("../../ir/path/step.cjs");
+const require_edge = require("../../geometry/edge.cjs");
+const require_point = require("../../geometry/point.cjs");
 const require_scope = require("../scope.cjs");
 const require_position = require("../position.cjs");
 const require_node = require("../node.cjs");
@@ -6,6 +8,7 @@ const require_anchor_cache = require("../anchor-cache.cjs");
 //#region src/compile/path/anchor.ts
 /** target 是否对象形态 NodeTarget（`{ id, anchor?, offset? }`）；与 Position(array) / Polar / Offset(of) / Relative 区分（独有 `id`） */
 var isNodeTarget = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t;
+var isAutoBoundaryTarget = (target) => isNodeTarget(target) && target.anchor === void 0 && target.offset === void 0;
 /** target 是否 between 比例点（`{ between, t }`）；独有 `between` 字段 */
 var isBetween = (t) => typeof t === "object" && !Array.isArray(t) && "between" in t;
 /** 解析 NodeTarget 的 anchor（非 undefined）到世界坐标：命名 / 角度走 resolveAnchor（可选连接面），`{ side, t }` 恒走视觉形状（不传 boundary） */
@@ -21,7 +24,7 @@ var addOffset = (base, offset) => offset ? [base[0] + offset[0], base[1] + offse
 * @description 三态：`'A'`(auto) 节点中心；`'A.<anchor>'`/`'A.<deg>'` 显式锚点 refPoint=endpoint 位置不随邻居变。直接坐标/极坐标解析为笛卡尔。
 *   string id lookup 拿到的 layout 已是全局坐标——不走 scopeChain 投影；Position / Polar /
 *   At / Offset 字面量经 `resolvePosition(..., scopeChain)` 拿到当前 scope 局部坐标后
-*   `applyTransformChain` 投回全局。`scopeChain=[]` 等价 v0.1（恒等）。
+*   `applyTransformChain` 投回全局。`scopeChain=[]` 时按恒等变换处理。
 */
 var refPointOfTarget = (target, nameStack, scopeChain = []) => {
 	if (isNodeTarget(target)) {
@@ -33,7 +36,7 @@ var refPointOfTarget = (target, nameStack, scopeChain = []) => {
 		const a = refPointOfTarget(target.between[0], nameStack, scopeChain);
 		const b = refPointOfTarget(target.between[1], nameStack, scopeChain);
 		if (!a || !b) return null;
-		const mid = require__edge.lerpPoint(a, b, target.t);
+		const mid = require_edge.lerpPoint(a, b, target.t);
 		if (!Number.isFinite(mid[0]) || !Number.isFinite(mid[1])) return null;
 		return mid;
 	}
@@ -43,7 +46,7 @@ var refPointOfTarget = (target, nameStack, scopeChain = []) => {
 	return scopeChain.length === 0 ? local : require_scope.applyTransformChain(local, scopeChain);
 };
 /** 折角中间点：`-|` → (curr.x, prev.y)；`|-` → (prev.x, curr.y) */
-var cornerOf = (prev, curr, via) => via === "-|" ? [curr[0], prev[1]] : [prev[0], curr[1]];
+var cornerOf = (prev, curr, via) => via === require_step.FoldStepVia.HorizontalThenVertical ? [curr[0], prev[1]] : [prev[0], curr[1]];
 /**
 * 在 toward 方向算 step.to 的实际绘制端点
 * @description 节点 auto `'A'`：按 shape 走 boundaryPointOf 求中心→toward 射线交点；命名 anchor/角度：位置已定不受 toward 影响；直接坐标/极坐标：解析后返回；失败返回 null。
@@ -64,18 +67,13 @@ var clipForTarget = (target, toward, nameStack, scopeChain = []) => {
 	return scopeChain.length === 0 ? local : require_scope.applyTransformChain(local, scopeChain);
 };
 /** 两个 IRPosition 两分量精确相等（未 round） */
-var samePoint = (a, b) => !!a && !!b && a[0] === b[0] && a[1] === b[1];
+var samePoint = (a, b) => !!a && !!b && require_point.point.equal(a, b);
 /** 把 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];
-};
+var shiftToward = (p, target, dist) => require_point.point.shiftToward(p, target, dist);
 //#endregion
 exports.clipForTarget = clipForTarget;
 exports.cornerOf = cornerOf;
+exports.isAutoBoundaryTarget = isAutoBoundaryTarget;
 exports.refPointOfTarget = refPointOfTarget;
 exports.samePoint = samePoint;
 exports.shiftToward = shiftToward;

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

@@ -1,16 +1,17 @@
-import { IRPosition, IRTarget } from '../../ir';
+import { FoldStepViaValue, IRPosition, IRTarget } from '../../ir';
 import { Transform } from '../../primitive';
 import { NameStack } from '../name-stack';
+export declare const isAutoBoundaryTarget: (target: IRTarget) => boolean;
 /**
  * 求 step.to 的参考点（给 boundary clip 算方向 / 折角 corner 用）
  * @description 三态：`'A'`(auto) 节点中心；`'A.<anchor>'`/`'A.<deg>'` 显式锚点 refPoint=endpoint 位置不随邻居变。直接坐标/极坐标解析为笛卡尔。
  *   string id lookup 拿到的 layout 已是全局坐标——不走 scopeChain 投影；Position / Polar /
  *   At / Offset 字面量经 `resolvePosition(..., scopeChain)` 拿到当前 scope 局部坐标后
- *   `applyTransformChain` 投回全局。`scopeChain=[]` 等价 v0.1（恒等）。
+ *   `applyTransformChain` 投回全局。`scopeChain=[]` 时按恒等变换处理。
  */
 export declare const refPointOfTarget: (target: IRTarget, nameStack: NameStack, scopeChain?: ReadonlyArray<Transform>) => IRPosition | null;
 /** 折角中间点：`-|` → (curr.x, prev.y)；`|-` → (prev.x, curr.y) */
-export declare const cornerOf: (prev: IRPosition, curr: IRPosition, via: "-|" | "|-") => IRPosition;
+export declare const cornerOf: (prev: IRPosition, curr: IRPosition, via: FoldStepViaValue) => IRPosition;
 /**
  * 在 toward 方向算 step.to 的实际绘制端点
  * @description 节点 auto `'A'`：按 shape 走 boundaryPointOf 求中心→toward 射线交点；命名 anchor/角度：位置已定不受 toward 影响；直接坐标/极坐标：解析后返回；失败返回 null。

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

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA6B/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IA8Bf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,IAAI,GAAG,IAAI,KACf,UACqD,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAuBf,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"}
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAmC,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAExG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAU/C,eAAO,MAAM,oBAAoB,GAAI,QAAQ,QAAQ,KAAG,OAC4B,CAAC;AAqBrF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IA8Bf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,gBAAgB,KACpB,UACmF,CAAC;AAEvF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAuBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACtC,CAAC;AAElC,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAC1C,CAAC"}