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

package/dist/es/shapes/arc.js

@@ -1,7 +1,7 @@
-import { localToWorld } from "../geometry/_transform.js";
+import { localToWorld } from "../geometry/transform.js";
 import { arcBoundingPoints, arcEndPoint } from "../geometry/arc.js";
 import { defineShape } from "./define.js";
-import { normalizeAngularRange } from "./_shared.js";
+import { normalizeAngularRange } from "./shared.js";
 import { z } from "zod";
 //#region src/shapes/arc.ts
 /** arc 的派生几何：圆心局部系 AABB + 圆心相对 AABB 中心偏移 */

package/dist/{lib/shapes/_contour.d.ts → es/shapes/contour.d.ts}

@@ -1,6 +1,7 @@
 import { Position } from '../geometry/point';
-import { ContourCommand, LineSegment } from '../geometry/roundedContour';
-import { PathCommand } from '../primitive';
+import { ContourCommand, LineSegment } from '../geometry/contour';
+import { PathCommand, PathPrim } from '../primitive';
+import { ShapeStyle } from './types';
 /**
  * 由顶点环构造闭合折线段序列（接缝顺序同顶点顺序）
  * @description 第 i 段 from = 顶点 i、to = 顶点 (i+1)%n；供 polygon / star 的 emit / boundaryPoint
@@ -16,4 +17,6 @@ export declare const verticesToSegments: (verts: Array<Position>) => Array<LineS
  *   polygon / star 共用此映射器（单一实现）。
  */
 export declare const contourToPathCommands: (commands: Array<ContourCommand>, round: (n: number) => number) => Array<PathCommand>;
-//# sourceMappingURL=_contour.d.ts.map
+/** contour shape 共用的 path primitive 样式落地。 */
+export declare const contourToPathPrimitive: (commands: Array<PathCommand>, style: ShapeStyle) => PathPrim;
+//# sourceMappingURL=contour.d.ts.map

package/dist/es/shapes/contour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contour.d.ts","sourceRoot":"","sources":["../../../src/shapes/contour.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAG,KAAK,CAAC,WAAW,CACQ,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,KAAK,CAAC,cAAc,CAAC,EAC/B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,KAAK,CAAC,WAAW,CAqCnB,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,GACjC,UAAU,KAAK,CAAC,WAAW,CAAC,EAC5B,OAAO,UAAU,KAChB,QAUD,CAAC"}

package/dist/es/shapes/{_contour.js → contour.js}

@@ -1,4 +1,4 @@
-//#region src/shapes/_contour.ts
+//#region src/shapes/contour.ts
 /**
 * 由顶点环构造闭合折线段序列（接缝顺序同顶点顺序）
 * @description 第 i 段 from = 顶点 i、to = 顶点 (i+1)%n；供 polygon / star 的 emit / boundaryPoint
@@ -56,5 +56,17 @@ var contourToPathCommands = (commands, round) => {
 	});
 	return out;
 };
+/** contour shape 共用的 path primitive 样式落地。 */
+var contourToPathPrimitive = (commands, style) => ({
+	type: "path",
+	commands,
+	fill: style.fill ?? "transparent",
+	fillOpacity: style.fillOpacity,
+	stroke: style.stroke ?? "currentColor",
+	strokeOpacity: style.strokeOpacity,
+	strokeWidth: style.strokeWidth ?? 1,
+	dashPattern: style.dashPattern,
+	opacity: style.opacity
+});
 //#endregion
-export { contourToPathCommands, verticesToSegments };
+export { contourToPathCommands, contourToPathPrimitive, verticesToSegments };

package/dist/es/shapes/ellipse.js

@@ -1,6 +1,6 @@
 import { defineShape } from "./define.js";
-import { asRectAnchor } from "./_shared.js";
 import { ellipse as ellipse$1 } from "../geometry/ellipse.js";
+import { normalizeCompassAnchor } from "../geometry/anchor.js";
 import { z } from "zod";
 //#region src/shapes/ellipse.ts
 /** 外接框 Rect → Ellipse（rx/ry = 半宽/半高） */
@@ -29,7 +29,7 @@ var ellipse = defineShape({
 	},
 	boundaryPoint: (r, toward) => ellipse$1.boundaryPoint(toEllipse(r), toward),
 	anchor: (r, name) => {
-		const a = asRectAnchor(name);
+		const a = normalizeCompassAnchor(name);
 		return a ? ellipse$1.anchor(toEllipse(r), a) : void 0;
 	},
 	edgePoint: (r, side, t) => ellipse$1.edgePoint(toEllipse(r), side, t),

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

@@ -13,5 +13,5 @@ export { rectangle, ellipse, polygon, sector, arc, star, defineShape };
 export type { ShapeDefinition, ShapeDefinitionInput, ShapeStyle } from './types';
 export type { Rect } from '../geometry/rect';
 export type { Position } from '../geometry/point';
-export { worldToLocal, localToWorld } from '../geometry/_transform';
+export { worldToLocal, localToWorld } from '../geometry/transform';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shapes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,2FAA2F;AAC3F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,EAAE,eAAe,CAO3I,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjF,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shapes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,2FAA2F;AAC3F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,EAAE,eAAe,CAO3I,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjF,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/es/shapes/index.js

@@ -1,4 +1,4 @@
-import "../geometry/_transform.js";
+import "../geometry/transform.js";
 import "./define.js";
 import { arc } from "./arc.js";
 import { ellipse } from "./ellipse.js";

package/dist/es/shapes/polygon.d.ts

@@ -7,7 +7,7 @@
  *   （多边形关于中心对称，AABB 中心 = 形心 = node position）。命名 anchor 走外接 AABB 的 9 名 rect anchor（不随
  *   cornerRadius 移）；self-rotate（params.rotate）与 Node.rotate 叠加。scaleParams：cornerRadius 是长度随 scale
  *   缩（几何均值因子），sides 计数 / rotate 角度不缩。
- *   diamond ≡ `{ type: 'polygon', params: { sides: 4, rotate: 45 } }`，由 compile 规范化。
+ *   diamond ≡ `{ type: 'polygon', params: { sides: 4, rotate: 0 } }`，由 compile 规范化。
  */
 export declare const polygon: import('./types').ShapeDefinition;
 //# sourceMappingURL=polygon.d.ts.map

package/dist/es/shapes/polygon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../../src/shapes/polygon.ts"],"names":[],"mappings":"AA8EA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,mCAiElB,CAAC"}
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../../src/shapes/polygon.ts"],"names":[],"mappings":"AAqFA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,mCA6DlB,CAAC"}

package/dist/es/shapes/polygon.js

@@ -1,12 +1,13 @@
-import { localToWorld } from "../geometry/_transform.js";
+import { localToWorld } from "../geometry/transform.js";
 import { rect } from "../geometry/rect.js";
 import { defineShape } from "./define.js";
-import { asRectAnchor } from "./_shared.js";
-import { boundaryFromContour, contourCommands } from "../geometry/roundedContour.js";
-import { contourToPathCommands, verticesToSegments } from "./_contour.js";
+import { normalizeCompassAnchor } from "../geometry/anchor.js";
+import { boundaryFromContour, contourCommands } from "../geometry/contour.js";
+import { contourToPathCommands, contourToPathPrimitive, verticesToSegments } from "./contour.js";
 import { z } from "zod";
 //#region src/shapes/polygon.ts
 var DEG_TO_RAD = Math.PI / 180;
+var MAX_POLYGON_SIDES = 1024;
 /** 顶点角集合（度）：第 k 个顶点角 = rotate + k·(360/sides) */
 var vertexAngles = (params) => {
 	const startDeg = params.rotate ?? 0;
@@ -16,7 +17,14 @@ var vertexAngles = (params) => {
 	return out;
 };
 /** 顶点角的 |cos| 最大值（恒 >0，sides≥3 时至少一个顶点不在 ±y 轴上）；用于由 AABB 半宽反推外接半径 */
-var maxAbsCos = (params) => Math.max(...vertexAngles(params).map((a) => Math.abs(Math.cos(a * DEG_TO_RAD))));
+var maxAbsCos = (params) => {
+	let max = 0;
+	for (const angle of vertexAngles(params)) {
+		const value = Math.abs(Math.cos(angle * DEG_TO_RAD));
+		if (value > max) max = value;
+	}
+	return max;
+};
 /**
 * 能容纳内框（半轴 hw/hh）的正 sides 边形外接圆半径
 * @description rectangle / polygon 是文本容器——尺寸由内框（text + padding）驱动，circumscribe 从内框推外接。
@@ -57,20 +65,27 @@ var polygonVertices = (rect, radius, params) => vertexAngles(params).map((deg) =
 *   （多边形关于中心对称，AABB 中心 = 形心 = node position）。命名 anchor 走外接 AABB 的 9 名 rect anchor（不随
 *   cornerRadius 移）；self-rotate（params.rotate）与 Node.rotate 叠加。scaleParams：cornerRadius 是长度随 scale
 *   缩（几何均值因子），sides 计数 / rotate 角度不缩。
-*   diamond ≡ `{ type: 'polygon', params: { sides: 4, rotate: 45 } }`，由 compile 规范化。
+*   diamond ≡ `{ type: 'polygon', params: { sides: 4, rotate: 0 } }`，由 compile 规范化。
 */
 var polygon = defineShape({
 	paramsSchema: z.strictObject({
-		sides: z.number().int().min(3).describe("Number of sides of the regular polygon (>= 3)."),
+		sides: z.number().int().min(3).max(MAX_POLYGON_SIDES).describe(`Number of sides of the regular polygon (3..${MAX_POLYGON_SIDES}).`),
 		rotate: z.number().finite().optional().describe("Shape self-rotation in degrees (vertex start direction); default 0. Composes with Node.rotate."),
 		cornerRadius: z.number().finite().nonnegative().optional().describe("Corner radius in user units; 0 / omitted = sharp corners. Clamped per corner to the largest non-self-intersecting fillet.")
 	}),
 	circumscribe: (hw, hh, params) => {
 		const radius = circumradiusFor(hw, hh, params);
 		const angles = vertexAngles(params);
+		let halfWidth = 0;
+		let halfHeight = 0;
+		for (const angle of angles) {
+			const rad = angle * DEG_TO_RAD;
+			halfWidth = Math.max(halfWidth, Math.abs(radius * Math.cos(rad)));
+			halfHeight = Math.max(halfHeight, Math.abs(radius * Math.sin(rad)));
+		}
 		return {
-			halfWidth: Math.max(...angles.map((a) => Math.abs(radius * Math.cos(a * DEG_TO_RAD)))),
-			halfHeight: Math.max(...angles.map((a) => Math.abs(radius * Math.sin(a * DEG_TO_RAD))))
+			halfWidth,
+			halfHeight
 		};
 	},
 	boundaryPoint: (rect, toward, params) => {
@@ -79,21 +94,11 @@ var polygon = defineShape({
 		return boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
 	},
 	anchor: (rect$1, name, params) => {
-		const a = asRectAnchor(name);
+		const a = normalizeCompassAnchor(name);
 		return a ? rect.anchor(rect$1, a) : void 0;
 	},
 	*emit(rect, style, round, params) {
-		yield {
-			type: "path",
-			commands: contourToPathCommands(contourCommands(verticesToSegments(polygonVertices(rect, circumradiusFromRect(rect, params), params)), params.cornerRadius), round),
-			fill: style.fill ?? "transparent",
-			fillOpacity: style.fillOpacity,
-			stroke: style.stroke ?? "currentColor",
-			strokeOpacity: style.strokeOpacity,
-			strokeWidth: style.strokeWidth ?? 1,
-			dashPattern: style.dashPattern,
-			opacity: style.opacity
-		};
+		yield contourToPathPrimitive(contourToPathCommands(contourCommands(verticesToSegments(polygonVertices(rect, circumradiusFromRect(rect, params), params)), params.cornerRadius), round), style);
 	},
 	scaleParams: (params, sx, sy) => params.cornerRadius === void 0 ? params : {
 		...params,

package/dist/es/shapes/rectangle.js

@@ -1,9 +1,9 @@
-import { localToWorld } from "../geometry/_transform.js";
+import { localToWorld } from "../geometry/transform.js";
 import { rect } from "../geometry/rect.js";
 import { defineShape } from "./define.js";
-import { asRectAnchor } from "./_shared.js";
-import { boundaryFromContour } from "../geometry/roundedContour.js";
-import { verticesToSegments } from "./_contour.js";
+import { normalizeCompassAnchor } from "../geometry/anchor.js";
+import { boundaryFromContour } from "../geometry/contour.js";
+import { verticesToSegments } from "./contour.js";
 import { z } from "zod";
 //#region src/shapes/rectangle.ts
 /** 轴对齐 / 旋转矩形的 4 个角（CW 绕向：左上 → 右上 → 右下 → 左下），局部系经 localToWorld 投世界 */
@@ -37,7 +37,7 @@ var rectangle = defineShape({
 		return boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
 	},
 	anchor: (r, name) => {
-		const a = asRectAnchor(name);
+		const a = normalizeCompassAnchor(name);
 		return a ? rect.anchor(r, a) : void 0;
 	},
 	edgePoint: (r, side, t) => rect.edgePoint(r, side, t),

package/dist/es/shapes/sector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sector.d.ts","sourceRoot":"","sources":["../../../src/shapes/sector.ts"],"names":[],"mappings":"AA0EA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,mCAgGjB,CAAC"}
+{"version":3,"file":"sector.d.ts","sourceRoot":"","sources":["../../../src/shapes/sector.ts"],"names":[],"mappings":"AAoGA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,mCAmFjB,CAAC"}

package/dist/es/shapes/sector.js

@@ -1,8 +1,8 @@
-import { localToWorld } from "../geometry/_transform.js";
+import { localToWorld } from "../geometry/transform.js";
 import { defineShape } from "./define.js";
-import { sectorGeometry, sectorPolarPoint } from "./_shared.js";
-import { boundaryFromContour, contourCommands } from "../geometry/roundedContour.js";
-import { contourToPathCommands } from "./_contour.js";
+import { sectorGeometry, sectorPolarPoint } from "./shared.js";
+import { boundaryFromContour, contourCommands, filletContour } from "../geometry/contour.js";
+import { contourToPathCommands, contourToPathPrimitive } from "./contour.js";
 import { z } from "zod";
 //#region src/shapes/sector.ts
 /** sector 局部 AABB 系点（圆心为原点偏移后）→ 世界系（含 rect 旋转 / 平移） */
@@ -76,6 +76,23 @@ var sectorSegments = (rect, geo, params) => {
 		}
 	];
 };
+var sectorGeometryCache = /* @__PURE__ */ new WeakMap();
+var getSectorGeometry = (params) => {
+	const cached = sectorGeometryCache.get(params);
+	if (cached !== void 0) return cached;
+	const geo = sectorGeometry(params);
+	sectorGeometryCache.set(params, geo);
+	return geo;
+};
+var createSectorContour = (rect, params) => {
+	const geo = getSectorGeometry(params);
+	const segments = sectorSegments(rect, geo, params);
+	return {
+		geo,
+		segments,
+		fillets: filletContour(segments, params.cornerRadius)
+	};
+};
 /**
 * sector 注册项：环楔（内外半径 + 起止角围成的可填充 2D 区域）
 * @description 四何函数共用 `sectorGeometry`（单一真源）：circumscribe 返回含圆心 + 内外弧的精确 AABB 半轴
@@ -88,21 +105,21 @@ var sector = defineShape({
 		innerRadius: z.number().finite().nonnegative().describe("Inner radius (user units); 0 = solid pie slice."),
 		outerRadius: z.number().finite().positive().describe("Outer radius (user units); must be > innerRadius."),
 		startAngle: z.number().finite().describe("Start angle in degrees; polar convention 0°=+x, 90°=+y (screen y-down), matching core polar."),
-		endAngle: z.number().finite().describe("End angle in degrees; swept counterclockwise in screen space from startAngle."),
+		endAngle: z.number().finite().describe("End angle in degrees; swept clockwise in screen space from startAngle."),
 		cornerRadius: z.number().finite().nonnegative().optional().describe("Corner radius in user units; 0 / omitted = sharp corners. Clamped per corner to the largest non-self-intersecting fillet.")
 	}).refine((p) => p.outerRadius > p.innerRadius, { message: "outerRadius must be greater than innerRadius" }),
-	circumscribe: (_hw, _hh, params) => sectorGeometry(params).aabbHalfAxes,
+	circumscribe: (_hw, _hh, params) => getSectorGeometry(params).aabbHalfAxes,
 	circumscribeOffset: (params) => {
-		const { apexOffset } = sectorGeometry(params);
+		const { apexOffset } = getSectorGeometry(params);
 		return [-apexOffset[0], -apexOffset[1]];
 	},
 	boundaryPoint: (rect, toward, params) => {
-		const geo = sectorGeometry(params);
-		const centroidWorld = localToWorld(rect, geo.centroidOffset);
-		return boundaryFromContour(sectorSegments(rect, geo, params), params.cornerRadius, centroidWorld, toward) ?? centroidWorld;
+		const { geo, segments, fillets } = createSectorContour(rect, params);
+		const originWorld = localToWorld(rect, geo.boundaryOriginOffset);
+		return boundaryFromContour(segments, params.cornerRadius, originWorld, toward, fillets) ?? originWorld;
 	},
 	anchor: (rect, name, params) => {
-		const geo = sectorGeometry(params);
+		const geo = getSectorGeometry(params);
 		const { innerRadius, outerRadius } = params;
 		const { start, end, mid } = geo.range;
 		switch (name) {
@@ -117,17 +134,8 @@ var sector = defineShape({
 		}
 	},
 	*emit(rect, style, round, params) {
-		yield {
-			type: "path",
-			commands: contourToPathCommands(contourCommands(sectorSegments(rect, sectorGeometry(params), params), params.cornerRadius), round),
-			fill: style.fill ?? "transparent",
-			fillOpacity: style.fillOpacity,
-			stroke: style.stroke ?? "currentColor",
-			strokeOpacity: style.strokeOpacity,
-			strokeWidth: style.strokeWidth ?? 1,
-			dashPattern: style.dashPattern,
-			opacity: style.opacity
-		};
+		const { segments, fillets } = createSectorContour(rect, params);
+		yield contourToPathPrimitive(contourToPathCommands(contourCommands(segments, params.cornerRadius, fillets), round), style);
 	},
 	scaleParams: (params, sx, sy) => {
 		const factor = Math.sqrt(sx * sy);

package/dist/es/shapes/{_shared.d.ts → shared.d.ts}

@@ -1,10 +1,4 @@
 import { Position } from '../geometry/point';
-import { RectAnchor } from '../geometry/rect';
-/**
- * 把任意字符串收窄为合法 RectAnchor，否则 undefined
- * @description 内置 4 shape 的 anchor 只认这 9 名；不在集合内返回 undefined，由 `anchorOf` 抛 Unknown anchor
- */
-export declare const asRectAnchor: (name: string) => RectAnchor | undefined;
 /** sector / arc 共用的角度约定起止角 */
 type AngularRange = {
     /** 规范化后的起始角（度）= 原 startAngle */
@@ -38,8 +32,10 @@ export type SectorGeometry = {
     };
     /** 圆心(apex)相对 AABB 中心的偏移（apex 常在 AABB 内角，非 AABB 中心） */
     apexOffset: Position;
-    /** 质心(centroid)相对 AABB 中心的偏移（落在环楔内，作 boundaryPoint 向外射线起点） */
+    /** 质心(centroid)相对 AABB 中心的偏移；大角度环形扇区的质心可能落入内孔。 */
     centroidOffset: Position;
+    /** boundaryPoint 射线起点偏移；环形扇区使用填充环楔内的点，而不是质心。 */
+    boundaryOriginOffset: Position;
 };
 /** sector params 的最小结构（与 sector.ts 的 SectorParams 同形，避免循环 import 类型） */
 type SectorGeometryInput = {
@@ -58,4 +54,4 @@ export declare const sectorGeometry: (params: SectorGeometryInput) => SectorGeom
 /** sector 局部系点（圆心为原点）：极角(度) + 半径 → 直角坐标 */
 export declare const sectorPolarPoint: (radius: number, angleDeg: number) => Position;
 export {};
-//# sourceMappingURL=_shared.d.ts.map
+//# sourceMappingURL=shared.d.ts.map

package/dist/es/shapes/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/shapes/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD,8BAA8B;AAC9B,KAAK,YAAY,GAAG;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,MAAM,EAAE,UAAU,MAAM,KAAG,YAI5E,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,iBAAiB;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,4CAA4C;IAC5C,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,uDAAuD;IACvD,UAAU,EAAE,QAAQ,CAAC;IACrB,kDAAkD;IAClD,cAAc,EAAE,QAAQ,CAAC;IACzB,gDAAgD;IAChD,oBAAoB,EAAE,QAAQ,CAAC;CAChC,CAAC;AAEF,wEAAwE;AACxE,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,mBAAmB,KAAG,cAoE5D,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,QAC7B,CAAC"}

package/dist/es/shapes/{_shared.js → shared.js}

@@ -1,13 +1,5 @@
-import { RECT_ANCHORS } from "../geometry/rect.js";
 import { arcBoundingPoints, arcEndPoint } from "../geometry/arc.js";
-//#region src/shapes/_shared.ts
-/** RECT_ANCHORS 的 9 个合法 anchor 名集合（成员校验用） */
-var RECT_ANCHOR_SET = new Set(Object.values(RECT_ANCHORS));
-/**
-* 把任意字符串收窄为合法 RectAnchor，否则 undefined
-* @description 内置 4 shape 的 anchor 只认这 9 名；不在集合内返回 undefined，由 `anchorOf` 抛 Unknown anchor
-*/
-var asRectAnchor = (name) => RECT_ANCHOR_SET.has(name) ? name : void 0;
+//#region src/shapes/shared.ts
 var DEG_TO_RAD = Math.PI / 180;
 /**
 * 规范化起止角：保证 end ≥ start（end<start 时加 360° 直至 ≥ start），并给出中分角
@@ -34,7 +26,7 @@ var sectorGeometry = (params) => {
 	const { innerRadius, outerRadius } = params;
 	const range = normalizeAngularRange(params.startAngle, params.endAngle);
 	const apex = [0, 0];
-	const candidates = [apex];
+	const candidates = innerRadius === 0 ? [apex] : [];
 	candidates.push(...arcBoundingPoints(apex, outerRadius, range.start, range.end));
 	if (innerRadius > 0) candidates.push(...arcBoundingPoints(apex, innerRadius, range.start, range.end));
 	let minX = Infinity;
@@ -62,6 +54,9 @@ var sectorGeometry = (params) => {
 	else centroidRadius = 2 / 3 * (Math.sin(half) / half) * ((R * R * R - r * r * r) / areaDenom);
 	const centroidLocal = [Math.cos(midRad) * centroidRadius, Math.sin(midRad) * centroidRadius];
 	const centroidOffset = [centroidLocal[0] - aabbCenter[0], centroidLocal[1] - aabbCenter[1]];
+	const boundaryOriginRadius = innerRadius > 0 ? (innerRadius + outerRadius) / 2 : centroidRadius;
+	const boundaryOriginLocal = [Math.cos(midRad) * boundaryOriginRadius, Math.sin(midRad) * boundaryOriginRadius];
+	const boundaryOriginOffset = [boundaryOriginLocal[0] - aabbCenter[0], boundaryOriginLocal[1] - aabbCenter[1]];
 	return {
 		range,
 		aabbHalfAxes: {
@@ -69,10 +64,11 @@ var sectorGeometry = (params) => {
 			halfHeight
 		},
 		apexOffset,
-		centroidOffset
+		centroidOffset,
+		boundaryOriginOffset
 	};
 };
 /** sector 局部系点（圆心为原点）：极角(度) + 半径 → 直角坐标 */
 var sectorPolarPoint = (radius, angleDeg) => arcEndPoint([0, 0], radius, angleDeg);
 //#endregion
-export { asRectAnchor, normalizeAngularRange, sectorGeometry, sectorPolarPoint };
+export { normalizeAngularRange, sectorGeometry, sectorPolarPoint };

package/dist/es/shapes/star.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"star.d.ts","sourceRoot":"","sources":["../../../src/shapes/star.ts"],"names":[],"mappings":"AAsFA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,mCA2Ff,CAAC"}
+{"version":3,"file":"star.d.ts","sourceRoot":"","sources":["../../../src/shapes/star.ts"],"names":[],"mappings":"AAsFA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,mCAiFf,CAAC"}

package/dist/es/shapes/star.js

@@ -1,7 +1,7 @@
-import { localToWorld } from "../geometry/_transform.js";
+import { localToWorld } from "../geometry/transform.js";
 import { defineShape } from "./define.js";
-import { boundaryFromContour, contourCommands } from "../geometry/roundedContour.js";
-import { contourToPathCommands, verticesToSegments } from "./_contour.js";
+import { boundaryFromContour, contourCommands } from "../geometry/contour.js";
+import { contourToPathCommands, contourToPathPrimitive, verticesToSegments } from "./contour.js";
 import { z } from "zod";
 //#region src/shapes/star.ts
 var DEG_TO_RAD = Math.PI / 180;
@@ -87,17 +87,7 @@ var star = defineShape({
 		}
 	},
 	*emit(rect, style, round, params) {
-		yield {
-			type: "path",
-			commands: contourToPathCommands(contourCommands(verticesToSegments(worldVertices(rect, starGeometry(params))), params.cornerRadius), round),
-			fill: style.fill ?? "transparent",
-			fillOpacity: style.fillOpacity,
-			stroke: style.stroke ?? "currentColor",
-			strokeOpacity: style.strokeOpacity,
-			strokeWidth: style.strokeWidth ?? 1,
-			dashPattern: style.dashPattern,
-			opacity: style.opacity
-		};
+		yield contourToPathPrimitive(contourToPathCommands(contourCommands(verticesToSegments(worldVertices(rect, starGeometry(params))), params.cornerRadius), round), style);
 	},
 	scaleParams: (params, sx, sy) => {
 		const factor = Math.sqrt(sx * sy);

package/dist/lib/arrows/define.cjs

@@ -0,0 +1,10 @@
+//#region src/arrows/define.ts
+/**
+* 定义一个 arrow 注册项
+* @description 与 `defineShape` / `definePathGenerator` 对齐的定义点 helper；当前不做额外运行时校验，
+*   只保留 `ArrowDefinition` 形态并让第三方扩展面写法一致。
+* @returns 原样返回的 def（便于 `export const bracket = defineArrow({ ... })`）
+*/
+var defineArrow = (def) => def;
+//#endregion
+exports.defineArrow = defineArrow;

package/dist/lib/arrows/define.d.ts

@@ -0,0 +1,9 @@
+import { ArrowDefinition } from './types';
+/**
+ * 定义一个 arrow 注册项
+ * @description 与 `defineShape` / `definePathGenerator` 对齐的定义点 helper；当前不做额外运行时校验，
+ *   只保留 `ArrowDefinition` 形态并让第三方扩展面写法一致。
+ * @returns 原样返回的 def（便于 `export const bracket = defineArrow({ ... })`）
+ */
+export declare const defineArrow: (def: ArrowDefinition) => ArrowDefinition;
+//# sourceMappingURL=define.d.ts.map

package/dist/lib/arrows/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/arrows/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,eAAe,KAAG,eAAsB,CAAC"}

package/dist/lib/arrows/index.cjs

@@ -1,3 +1,4 @@
+require("./define.cjs");
 //#region src/arrows/index.ts
 /** 实心闭合三角 / 菱形 / V 形的 path 工厂：填充走 ctx.fill（无 override = contextStroke） */
 var filledPath = (ctx, points) => ({
@@ -34,9 +35,10 @@ var hollowPath = (ctx, points, strokeLinejoin) => ({
 	...strokeLinejoin ? { strokeLinejoin } : {}
 });
 /**
-* 内置 7 arrow 注册项；与 `CompileOptions.arrows` 合并时被同名注入覆盖
+* 内置 8 arrow 注册项；与 `CompileOptions.arrows` 合并时被同名注入覆盖
 * @description 几何字段（lineContactX 静态 base / tipX / hollow）：
 *   实心 normal/diamond/circle lineContactX=0；stealth=3；open/openDiamond base=1 + tipX=9 + hollow；
+*   openStealth base=3 + tipX=9 + hollow；
 *   openCircle base=0.75 + hollow。baseSize / defaultLength / defaultWidth 走类型缺省（10 / 6 / 6）。
 *   framework 对 hollow def 统一把 lineContactX 减 lineWidth/2 得实际 refX / shrink 接触点。
 *   emit 几何在局部 baseSize=10 坐标系（renderer-agnostic）。
@@ -69,6 +71,17 @@ var BUILTIN_ARROWS = {
 			[3, 5]
 		])]
 	},
+	openStealth: {
+		hollow: true,
+		lineContactX: 3,
+		tipX: 9,
+		emit: (ctx) => [hollowPath(ctx, [
+			[1, 1],
+			[9, 5],
+			[1, 9],
+			[3, 5]
+		], "miter")]
+	},
 	diamond: {
 		lineContactX: 0,
 		emit: (ctx) => [filledPath(ctx, [

package/dist/lib/arrows/index.d.ts

@@ -1,13 +1,15 @@
 import { BuiltinArrowName } from '../ir/path/arrow';
 import { ArrowDefinition } from './types';
 /**
- * 内置 7 arrow 注册项；与 `CompileOptions.arrows` 合并时被同名注入覆盖
+ * 内置 8 arrow 注册项；与 `CompileOptions.arrows` 合并时被同名注入覆盖
  * @description 几何字段（lineContactX 静态 base / tipX / hollow）：
  *   实心 normal/diamond/circle lineContactX=0；stealth=3；open/openDiamond base=1 + tipX=9 + hollow；
+ *   openStealth base=3 + tipX=9 + hollow；
  *   openCircle base=0.75 + hollow。baseSize / defaultLength / defaultWidth 走类型缺省（10 / 6 / 6）。
  *   framework 对 hollow def 统一把 lineContactX 减 lineWidth/2 得实际 refX / shrink 接触点。
  *   emit 几何在局部 baseSize=10 坐标系（renderer-agnostic）。
  */
 export declare const BUILTIN_ARROWS: Record<BuiltinArrowName, ArrowDefinition>;
 export type { ArrowDefinition, ArrowEmitContext } from './types';
+export { defineArrow } from './define';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/arrows/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/arrows/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,SAAS,CAAC;AAiCjE;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAqDpE,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/arrows/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,SAAS,CAAC;AAiCjE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,gBAAgB,EAAE,eAAe,CA2DpE,CAAC;AAEF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/lib/arrows/types.d.ts

@@ -18,10 +18,10 @@ export type ArrowEmitContext = {
 /**
  * 一个 arrow 的可注册定义：几何尺寸 + emit
  * @description plain object（factory 友好），含函数、**不进 IR**，走 `CompileOptions.arrows` 运行时注入。
- *   内置 7 箭头也是注册项（无内置特权，对齐 `ShapeDefinition` / `BUILTIN_SHAPES`）。
+ *   内置 8 箭头也是注册项（无内置特权，对齐 `ShapeDefinition` / `BUILTIN_SHAPES`）。
  *
  *   `lineContactX` 存**静态 base**（不含 lineWidth 调整）：实心 normal/diamond/circle = 0、stealth = 3、
- *   open/openDiamond base = 1、openCircle base = 0.75。framework 对 `hollow: true` 的 def 统一减
+ *   open/openDiamond base = 1、openStealth base = 3、openCircle base = 0.75。framework 对 `hollow: true` 的 def 统一减
  *   `lineWidth/2` 得到实际 refX / shrink 接触点（这条调整由编译器 / adapter 落，def 只声明静态 base）。
  */
 export type ArrowDefinition = {
@@ -31,6 +31,8 @@ export type ArrowDefinition = {
     hollow?: boolean;
     /** 线接触点静态 base（决定 path shrink + marker refX）；空心 def 由 framework 再减 lineWidth/2 */
     lineContactX: number;
+    /** 外轮廓补偿量（marker 局部坐标）；缺省时空心箭头用 lineWidth/2，实心箭头用 0 */
+    outerInset?: number;
     /** 尖端 x（shrink 用）；缺省 = baseSize */
     tipX?: number;
     /** 默认箭头长度（length fallback）；缺省 6 */

package/dist/lib/arrows/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/arrows/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sEAAsE;IACtE,MAAM,EAAE,UAAU,CAAC;IACnB,qDAAqD;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,QAAQ,CAAC,eAAe,CAAC,CAAC;CAC5D,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/arrows/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sEAAsE;IACtE,MAAM,EAAE,UAAU,CAAC;IACnB,qDAAqD;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,IAAI,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,QAAQ,CAAC,eAAe,CAAC,CAAC;CAC5D,CAAC"}

package/dist/lib/compile/anchor-cache.cjs

@@ -1,3 +1,4 @@
+const require_anchor = require("../geometry/anchor.cjs");
 const require_boundary = require("./boundary.cjs");
 const require_node = require("./node.cjs");
 //#region src/compile/anchor-cache.ts
@@ -8,19 +9,31 @@ const require_node = require("./node.cjs");
 var cache = /* @__PURE__ */ new WeakMap();
 /** 角度字符串识别：可选负号 + 数字 + 可选小数；与 parseTarget.ts 的 ANGLE_RE 同语义 */
 var ANGLE_RE = /^-?\d+(\.\d+)?$/;
+/** 把 layout 的 rect 换成外边界 AABB（外扩 outerSep）——border 类 anchor 在其上解析（ADR-07 §1） */
+var withOuterRect = (layout) => ({
+	...layout,
+	rect: require_node.outerRectOf(layout)
+});
 /**
 * 把 anchorName 解析到对应 shape 的 anchor / boundaryPoint 上
-* @description 数字字符串走 angleBoundaryOf；其余按 RectAnchor 走 anchorOf；boundary 透传给两者
+* @description 数字字符串走 angleBoundaryOf；其余按标准方位 / shape-specific anchor 走 anchorOf；boundary 透传给两者。
+*   border 类 anchor（数字角度 + compass 方位名）按 outerSep 外推：在外扩 margin 的 rect（`outerRectOf`）上解析
+*   （ADR-07 §1）。形状专属命名 anchor（tip-N / apex 等）恒走视觉 rect、不外扩（§3）。`center` 在 inflate 下
+*   中心不变，走哪条路结果一致。
 */
 var computeAnchor = (layout, anchorName, boundary) => {
-	if (ANGLE_RE.test(anchorName)) return positionToIR(require_node.angleBoundaryOf(layout, Number(anchorName), boundary));
+	if (ANGLE_RE.test(anchorName)) {
+		const angle = Number(anchorName);
+		return positionToIR(require_node.angleBoundaryOf(withOuterRect(layout), angle, boundary));
+	}
+	if (require_anchor.normalizeCompassAnchor(anchorName) !== void 0) return positionToIR(require_node.anchorOf(withOuterRect(layout), anchorName, boundary));
 	return positionToIR(require_node.anchorOf(layout, anchorName, boundary));
 };
 /** geometry Position（含 readonly 形态）转 IRPosition 元组（IRPosition === [number, number]） */
 var positionToIR = (p) => [p[0], p[1]];
 /**
 * 取节点 anchor 的全局坐标，带 per-layout 缓存
-* @description name 接受 RectAnchor 关键字（如 `'north'` / `'south-west'`）或数字角度字符串（如 `'30'` / `'-45'`）；
+* @description name 接受方位 anchor 关键字（如 `'north'` / `'south-west'` / `'top-left'`）或数字角度字符串（如 `'30'` / `'-45'`）；
 *   boundary 指定连接面（默认 `'shape'`，即节点自身视觉轮廓）；不同 boundary 产生独立缓存条目，互不串扰；
 *   同一 (layout, name, boundary) 组合第二次起返回首调用结果的**同一引用**——上游可用 `===` 判定 cache 命中
 * @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
@@ -44,7 +57,7 @@ var resolveAnchor = (layout, anchorName, boundary = "shape") => {
 /**
 * 取节点边上比例点 `{ side, t }` 的全局坐标，带 per-layout 缓存
 * @description 走 `layout.shapeDef.edgePoint`——shape 未实现（如自定义 shape）抛"does not support side anchors"；
-*   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断，见 alpha.6 ADR-01 决策细节 #10）。
+*   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断）。
 *   缓存 key = `${side}:${t}`，与命名 anchor（`'north'` / `'30'`）共用 layout 的 Map——key 含 `:` 故命名空间不冲突。
 * @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
 * @returns 全局坐标系下的 IRPosition `[x, y]`

package/dist/lib/compile/anchor-cache.d.ts

@@ -1,9 +1,9 @@
-import { Side } from '../geometry/_edge';
+import { Side } from '../geometry/edge';
 import { IRBoundary, IRPosition } from '../ir';
 import { NodeLayout } from './node';
 /**
  * 取节点 anchor 的全局坐标，带 per-layout 缓存
- * @description name 接受 RectAnchor 关键字（如 `'north'` / `'south-west'`）或数字角度字符串（如 `'30'` / `'-45'`）；
+ * @description name 接受方位 anchor 关键字（如 `'north'` / `'south-west'` / `'top-left'`）或数字角度字符串（如 `'30'` / `'-45'`）；
  *   boundary 指定连接面（默认 `'shape'`，即节点自身视觉轮廓）；不同 boundary 产生独立缓存条目，互不串扰；
  *   同一 (layout, name, boundary) 组合第二次起返回首调用结果的**同一引用**——上游可用 `===` 判定 cache 命中
  * @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
@@ -15,7 +15,7 @@ export declare const resolveAnchor: (layout: NodeLayout, anchorName: string, bou
 /**
  * 取节点边上比例点 `{ side, t }` 的全局坐标，带 per-layout 缓存
  * @description 走 `layout.shapeDef.edgePoint`——shape 未实现（如自定义 shape）抛"does not support side anchors"；
- *   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断，见 alpha.6 ADR-01 决策细节 #10）。
+ *   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断）。
  *   缓存 key = `${side}:${t}`，与命名 anchor（`'north'` / `'30'`）共用 layout 的 Map——key 含 `:` 故命名空间不冲突。
  * @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
  * @returns 全局坐标系下的 IRPosition `[x, y]`