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

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,14 +37,14 @@ 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),
 	*emit(r, style, round, params) {
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
-		const cornerRadius = params.cornerRadius ?? style.cornerRadius;
+		const cornerRadius = params.cornerRadius;
 		yield {
 			type: "rect",
 			x: round(r.x - halfW),

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 */
@@ -15,11 +9,12 @@ type AngularRange = {
     mid: number;
 };
 /**
- * 规范化起止角：保证 end ≥ start（end<start 时加 360° 直至 ≥ start），并给出中分角
+ * 规范化起止角：保证 start ≤ end ≤ start+360（end<start 时加 360°、跨度>360° 钳到 360°），并给出中分角
  * @description 角度沿屏幕系（角度递增=CW）从 start 扫到 end；end<start 视为跨过 360°，与 polar / geometry/arc 约定一致。
  *   end<start 时一次性加上 360°·k（k 为使 end ≥ start 的最小非负整数），O(1) 闭式计算——
  *   避免 while 循环在巨型角度（如 1e308 浮点 end+360===end 卡死、1e9 退化成数百万次迭代）下挂死。
- *   end 已 ≥ start 时 ceil((start−end)/360) ≤ 0，k 取 0、end 不变（语义与原逐次加法等价）。
+ *   再把跨度钳到 ≤360°：sweep≥360° 视觉即整圆，超出部分冗余；钳定同时防住巨角（如 endAngle=1e8）
+ *   让下游 arcBoundingPoints 枚举海量 90°·k 轴向极值点。
  */
 export declare const normalizeAngularRange: (startAngle: number, endAngle: number) => AngularRange;
 /**
@@ -38,8 +33,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 +55,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;;;;;;;GAOG;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,23 +1,17 @@
-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），并给出中分角
+* 规范化起止角：保证 start ≤ end ≤ start+360（end<start 时加 360°、跨度>360° 钳到 360°），并给出中分角
 * @description 角度沿屏幕系（角度递增=CW）从 start 扫到 end；end<start 视为跨过 360°，与 polar / geometry/arc 约定一致。
 *   end<start 时一次性加上 360°·k（k 为使 end ≥ start 的最小非负整数），O(1) 闭式计算——
 *   避免 while 循环在巨型角度（如 1e308 浮点 end+360===end 卡死、1e9 退化成数百万次迭代）下挂死。
-*   end 已 ≥ start 时 ceil((start−end)/360) ≤ 0，k 取 0、end 不变（语义与原逐次加法等价）。
+*   再把跨度钳到 ≤360°：sweep≥360° 视觉即整圆，超出部分冗余；钳定同时防住巨角（如 endAngle=1e8）
+*   让下游 arcBoundingPoints 枚举海量 90°·k 轴向极值点。
 */
 var normalizeAngularRange = (startAngle, endAngle) => {
-	const end = endAngle + 360 * Math.max(0, Math.ceil((startAngle - endAngle) / 360));
+	const k = Math.max(0, Math.ceil((startAngle - endAngle) / 360));
+	const end = Math.min(endAngle + 360 * k, startAngle + 360);
 	return {
 		start: startAngle,
 		end,
@@ -34,7 +28,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 +56,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 +66,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":"AAuFA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,mCAkFf,CAAC"}

package/dist/es/shapes/star.js

@@ -1,10 +1,11 @@
-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;
+var MAX_STAR_POINTS = 1024;
 /**
 * 计算 star 单一真源几何
 * @description 局部系以中心为原点：顶点 k 角 = (rotate ?? 0) + k·(180/points) − 90，半径偶 outer / 奇 inner，
@@ -58,7 +59,7 @@ var worldVertices = (rect, geo) => geo.vertices.map((v) => toWorld(rect, v));
 */
 var star = defineShape({
 	paramsSchema: z.strictObject({
-		points: z.number().int().min(3).describe("Number of star points (>= 3)."),
+		points: z.number().int().min(3).max(MAX_STAR_POINTS).describe(`Number of star points (3..${MAX_STAR_POINTS}); capped to bound vertex count (mirrors polygon sides).`),
 		innerRadius: z.number().finite().positive().describe("Inner (notch) radius in user units."),
 		outerRadius: z.number().finite().positive().describe("Outer (tip) radius in user units; must be > innerRadius."),
 		rotate: z.number().finite().optional().describe("Shape self-rotation in degrees; default 0 = first tip points up (screen -y / top); positive rotates clockwise (screen). Composes with Node.rotate."),
@@ -87,17 +88,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/es/shapes/types.d.ts

@@ -21,7 +21,8 @@ export type ShapeStyle = {
 /**
  * 一个 shape 的参数化可注册定义（定义点 typed 形态）
  * @description plain object（factory 友好：`createPolygonShape(6)` 这类普通函数返回它即可）；含函数与
- *   `paramsSchema`，**不进 IR**，走 `CompileOptions.shapes` 运行时注入。内置 4 shape 也是注册项（无内置特权）。
+ *   `paramsSchema`，**不进 IR**，走 `CompileOptions.shapes` 运行时注入。内置 shape（rectangle / ellipse /
+ *   sector / arc / polygon / star，circle / diamond 为 preset 别名）也是注册项（无内置特权）。
  *   每个计算函数末位收 per-instance `params`（类型由 `paramsSchema.parse` 在编译期保证），无参形状用
  *   `z.strictObject({})` 并忽略 `params`。
  *
@@ -55,11 +56,17 @@ export type ShapeDefinitionInput<TParams extends IRJsonObject> = {
     circumscribeOffset?: (params: TParams) => Position;
     /** 中心 → toward 射线 ∩ 边界（rect 带 rotate）；params 喂参数化边界。 */
     boundaryPoint: (rect: Rect, toward: Position, params: TParams) => Position;
-    /** 命名 anchor 世界坐标；shape 不认识的名字返回 `undefined`（调用方据此抛清晰错误）。 */
+    /**
+     * 命名 anchor 世界坐标；shape 不认识的名字返回 `undefined`（调用方据此抛清晰错误）。
+     * @description compass 方位名（north / south / ... / center）的约定（与 TikZ 一致）：默认连接面下 compile 先调本函数，
+     *   shape 返回真实形状上的点即采用（如 ellipse 落真实周长、polygon 落外接 AABB）；返回 `undefined` 则 compile
+     *   回退到外接 AABB 矩形。故 shape 作者可只实现 shape 专属命名 anchor（tip-N / apex 等），compass 名交回退即可；
+     *   要让 compass 贴真实形状边界（圆 / 椭圆类）才需自行处理 compass。
+     */
     anchor: (rect: Rect, name: string, params: TParams) => Position | undefined;
     /**
      * 边上比例点：side 真实边界从约定起点起 t∈[0,1] 处（轴对齐空间求出后由 layout 投回世界系）。
-     * @description 可选——内置 4 shape 必实现，不实现的 shape 收到 `{ side, t }` 时编译期（resolveEdgePoint）抛明确错。
+     * @description 可选——目前仅 rectangle / ellipse 实现；未实现的 shape（polygon / sector / arc / star）收到 `{ side, t }` 时编译期（resolveEdgePoint）抛明确错。
      *   与 `anchor` 同坐标语义：收**带 rotate 的 Rect**，自行用 worldToLocal/localToWorld 处理旋转。
      */
     edgePoint?: (rect: Rect, side: 'north' | 'south' | 'east' | 'west', t: number, params: TParams) => Position;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shapes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,YAAY,IAAI;IAC/D,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC;;;;OAIG;IACH,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,OAAO,KACZ;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;IACnD,wDAAwD;IACxD,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;IAC3E,6DAA6D;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;IAC5E;;;;OAIG;IACH,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EACzC,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,OAAO,KACZ,QAAQ,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,CACJ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,MAAM,EAAE,OAAO,KACZ,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACpE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shapes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,YAAY,IAAI;IAC/D,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC;;;;OAIG;IACH,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,OAAO,KACZ;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;IACnD,wDAAwD;IACxD,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;IAC3E;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;IAC5E;;;;OAIG;IACH,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EACzC,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,OAAO,KACZ,QAAQ,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,CACJ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,MAAM,EAAE,OAAO,KACZ,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACpE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC"}

package/dist/es/types.d.ts

@@ -1,7 +1,7 @@
 /** 获取对象所有值的联合类型，等价于 (typeof T)[keyof typeof T] */
 export type ValueOf<T extends object> = T[keyof T];
 /**
- * 类型层等价检查工具（internal idiom，公开 API 不导出）
+ * 类型层等价检查工具（从包根导出，供各包字段表互锁复用）
  * @description 当 A、B 完全等价时类型为 `true`，否则为 `false`——配合 `as const satisfies` 实现"字段表必须完备覆盖类型 key 集合"的互锁；漏字段或多字段 TS 编译期报错
  * @example
  *   const NODE_FIELDS = ['id', 'shape'] as const satisfies ReadonlyArray<keyof IRNode>;

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, [
@@ -109,7 +122,7 @@ var BUILTIN_ARROWS = {
 			cy: 5,
 			rx: 4.25,
 			ry: 4.25,
-			stroke: typeof ctx.stroke === "string" ? ctx.stroke : "context-stroke",
+			stroke: typeof ctx.stroke === "string" ? ctx.stroke : { kind: "contextStroke" },
 			strokeWidth: ctx.lineWidth
 		}]
 	}

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,CA6DpE,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（compass / 数字角度）在其上解析 */
+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`）上解析。
+*   形状专属命名 anchor（tip-N / apex 等）恒走视觉 rect、不外扩。`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]`

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

@@ -1 +1 @@
-{"version":3,"file":"anchor-cache.d.ts","sourceRoot":"","sources":["../../../src/compile/anchor-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAiCzC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,UAAU,EAClB,YAAY,MAAM,EAClB,WAAU,UAAU,GAAG,SAAmB,KACzC,UAYF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,UAAU,EAClB,MAAM,IAAI,EACV,GAAG,MAAM,KACR,UAuBF,CAAC"}
+{"version":3,"file":"anchor-cache.d.ts","sourceRoot":"","sources":["../../../src/compile/anchor-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA8CzC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,UAAU,EAClB,YAAY,MAAM,EAClB,WAAU,UAAU,GAAG,SAAmB,KACzC,UAYF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,UAAU,EAClB,MAAM,IAAI,EACV,GAAG,MAAM,KACR,UAuBF,CAAC"}