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

package/dist/es/compile/constant.js

@@ -0,0 +1,23 @@
+//#region src/compile/constant.ts
+/** 编译期 warning code（机器可读）。 */
+var CompileWarningCode = {
+	UnresolvedNodeReference: "UNRESOLVED_NODE_REFERENCE",
+	PathTooShort: "PATH_TOO_SHORT",
+	AnchorResolutionFailed: "ANCHOR_RESOLUTION_FAILED",
+	OffsetBaseUnresolved: "OFFSET_BASE_UNRESOLVED",
+	PolarOriginUnresolved: "POLAR_ORIGIN_UNRESOLVED",
+	AtTargetUnresolved: "AT_TARGET_UNRESOLVED",
+	RelativeInitialNoPrevEnd: "RELATIVE_INITIAL_NO_PREV_END",
+	BboxExtremeInput: "BBOX_EXTREME_INPUT",
+	DuplicateNodeId: "DUPLICATE_NODE_ID",
+	ShapeOverridesBuiltin: "SHAPE_OVERRIDES_BUILTIN",
+	ArrowOverridesBuiltin: "ARROW_OVERRIDES_BUILTIN",
+	PatternOverridesBuiltin: "PATTERN_OVERRIDES_BUILTIN",
+	CompositeNotRegistered: "COMPOSITE_NOT_REGISTERED",
+	AnimationInvalidProperty: "ANIMATION_INVALID_PROPERTY",
+	ArcMissingRadius: "ARC_MISSING_RADIUS",
+	PartialArcNeedsBothAngles: "PARTIAL_ARC_NEEDS_BOTH_ANGLES"
+};
+var formatCompileWarning = (warning) => `[retikz] ${warning.code} at ${warning.path}: ${warning.message}`;
+//#endregion
+export { CompileWarningCode, formatCompileWarning };

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

@@ -0,0 +1,27 @@
+export type DirectionVector = readonly [number, number];
+/**
+ * 8 方向在屏幕坐标系（y 向下）里的单位向量。
+ * @description above=视觉上方（y 减小）；对角分量用 1/√2，保证斜向 distance 与水平 / 垂直 distance 等长。
+ */
+export declare const DirectionVectorByAtDirection: {
+    readonly above: readonly [0, -1];
+    readonly below: readonly [0, 1];
+    readonly left: readonly [-1, 0];
+    readonly right: readonly [1, 0];
+    readonly "above-left": readonly [number, number];
+    readonly "above-right": readonly [number, number];
+    readonly "below-left": readonly [number, number];
+    readonly "below-right": readonly [number, number];
+};
+/** 8 方向 label position 对应的节点边界 anchor。 */
+export declare const LabelAnchorByAtDirection: {
+    readonly above: "north";
+    readonly below: "south";
+    readonly left: "west";
+    readonly right: "east";
+    readonly "above-left": "north-west";
+    readonly "above-right": "north-east";
+    readonly "below-left": "south-west";
+    readonly "below-right": "south-east";
+};
+//# sourceMappingURL=direction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../../src/compile/direction.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;CASqB,CAAC;AAE/D,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB;;;;;;;;;CAS4B,CAAC"}

package/dist/es/compile/direction.js

@@ -0,0 +1,30 @@
+import { AtDirection } from "../ir/position/at-position.js";
+import { CompassAnchor } from "../geometry/anchor.js";
+//#region src/compile/direction.ts
+/**
+* 8 方向在屏幕坐标系（y 向下）里的单位向量。
+* @description above=视觉上方（y 减小）；对角分量用 1/√2，保证斜向 distance 与水平 / 垂直 distance 等长。
+*/
+var DirectionVectorByAtDirection = {
+	[AtDirection.Above]: [0, -1],
+	[AtDirection.Below]: [0, 1],
+	[AtDirection.Left]: [-1, 0],
+	[AtDirection.Right]: [1, 0],
+	[AtDirection.AboveLeft]: [-Math.SQRT1_2, -Math.SQRT1_2],
+	[AtDirection.AboveRight]: [Math.SQRT1_2, -Math.SQRT1_2],
+	[AtDirection.BelowLeft]: [-Math.SQRT1_2, Math.SQRT1_2],
+	[AtDirection.BelowRight]: [Math.SQRT1_2, Math.SQRT1_2]
+};
+/** 8 方向 label position 对应的节点边界 anchor。 */
+var LabelAnchorByAtDirection = {
+	[AtDirection.Above]: CompassAnchor.North,
+	[AtDirection.Below]: CompassAnchor.South,
+	[AtDirection.Left]: CompassAnchor.West,
+	[AtDirection.Right]: CompassAnchor.East,
+	[AtDirection.AboveLeft]: CompassAnchor.NorthWest,
+	[AtDirection.AboveRight]: CompassAnchor.NorthEast,
+	[AtDirection.BelowLeft]: CompassAnchor.SouthWest,
+	[AtDirection.BelowRight]: CompassAnchor.SouthEast
+};
+//#endregion
+export { DirectionVectorByAtDirection, LabelAnchorByAtDirection };

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

@@ -1,9 +1,11 @@
 export * from './compile';
+export * from './constant';
 export * from './node';
-export * from './path/index';
+export * from './path';
 export * from './position';
 export * from './precision';
 export * from './scope';
 export * from './text-metrics';
 export * from './layout';
+export * from './composite';
 //# 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,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compile/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/es/compile/name-stack.d.ts

@@ -70,8 +70,10 @@ export declare class NameStack {
      * @param id 要替换的 id（必须已在该 frame 注册过）
      * @param layout 新的 NodeLayout（覆盖旧值）
      * @param frameDepth 0 = 根 frame；通常传 scope 入场前的栈深 - 1
+     * @param expectedCurrent 可选的当前 layout 引用；传入后仅当 frame 中仍是该引用时才替换
+     * @returns true = 完成替换；false = 当前值已被后续 register 覆盖，未替换
      */
-    replaceLayout(id: string, layout: NodeLayout, frameDepth: number): void;
+    replaceLayout(id: string, layout: NodeLayout, frameDepth: number, expectedCurrent?: NodeLayout): boolean;
     /**
      * inside-out 查找 id 对应的 NodeLayout
      * @description 从栈顶向栈底依次查找；首个命中的 frame 返回；都没命中返回 undefined。内层可见外层（shadowing），外层不可见内层

package/dist/es/compile/name-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"name-stack.d.ts","sourceRoot":"","sources":["../../../src/compile/name-stack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAqB;AACrB,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAwC;IACrE,6EAA6E;IAC7E,OAAO,CAAC,YAAY,CAA8B;gBAEtC,OAAO,GAAE,gBAAqB;IAM1C,6BAA6B;IAC7B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,8BAA8B;IAC9B,IAAI,KAAK,IAAI,OAAO,GAAG,OAAO,CAE7B;IAED,iDAAiD;IACjD,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAQhB,kEAAkE;IAClE,gBAAgB,IAAI,IAAI;IAIxB,6EAA6E;IAC7E,eAAe,IAAI,IAAI;IAIvB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAuBlE;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAoBvE;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;CAO3C"}
+{"version":3,"file":"name-stack.d.ts","sourceRoot":"","sources":["../../../src/compile/name-stack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAqB;AACrB,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAwC;IACrE,6EAA6E;IAC7E,OAAO,CAAC,YAAY,CAA8B;gBAEtC,OAAO,GAAE,gBAAqB;IAM1C,6BAA6B;IAC7B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,8BAA8B;IAC9B,IAAI,KAAK,IAAI,OAAO,GAAG,OAAO,CAE7B;IAED,iDAAiD;IACjD,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAQhB,kEAAkE;IAClE,gBAAgB,IAAI,IAAI;IAIxB,6EAA6E;IAC7E,eAAe,IAAI,IAAI;IAIvB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAuBlE;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,UAAU,GAAG,OAAO;IAsBxG;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;CAO3C"}

package/dist/es/compile/name-stack.js

@@ -81,13 +81,17 @@ var NameStack = class {
 	* @param id 要替换的 id（必须已在该 frame 注册过）
 	* @param layout 新的 NodeLayout（覆盖旧值）
 	* @param frameDepth 0 = 根 frame；通常传 scope 入场前的栈深 - 1
+	* @param expectedCurrent 可选的当前 layout 引用；传入后仅当 frame 中仍是该引用时才替换
+	* @returns true = 完成替换；false = 当前值已被后续 register 覆盖，未替换
 	*/
-	replaceLayout(id, layout, frameDepth) {
+	replaceLayout(id, layout, frameDepth, expectedCurrent) {
 		if (this.currentPhase !== "pass1") throw new Error(`NameStack.replaceLayout('${id}'): only allowed during pass1; current phase is '${this.currentPhase}'`);
 		if (frameDepth < 0 || frameDepth >= this.frames.length) throw new Error(`NameStack.replaceLayout('${id}'): frameDepth ${frameDepth} out of range (stack depth ${this.frames.length})`);
 		const targetFrame = this.frames[frameDepth];
 		if (!targetFrame.has(id)) throw new Error(`NameStack.replaceLayout('${id}'): id not previously registered in frame at depth ${frameDepth}`);
+		if (expectedCurrent !== void 0 && targetFrame.get(id) !== expectedCurrent) return false;
 		targetFrame.set(id, layout);
+		return true;
 	}
 	/**
 	* inside-out 查找 id 对应的 NodeLayout

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

@@ -1,6 +1,6 @@
 import { Position } from '../geometry/point';
 import { Rect } from '../geometry/rect';
-import { AtDirection, 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';
@@ -77,6 +77,8 @@ export type NodeLayout = {
     boundary?: IRBoundary;
     /** provenance 元数据（来自 IR `node.meta`）；emit 时原样 stamp 到 node 的 top-level 图元，renderer 忽略 */
     meta?: IRJsonObject;
+    /** 时间轴动画 tracks（来自 IR `node.animations`）；emit 时原样 stamp 到 node 的 top-level 图元，renderer 播放 / 降级 */
+    animations?: Array<IRAnimationTrack>;
     /** 构建本 layout 的 shape 注册表引用——借用连接面（borrowed boundary）查表用 */
     shapes: Record<string, ShapeDefinition>;
 };
@@ -84,7 +86,7 @@ export type NodeLayout = {
 export type NodeLabelLayout = {
     text: string;
     /** 8 方向枚举或数字角度 */
-    position: AtDirection | number;
+    position: AtDirectionValue | number;
     /** 已应用默认值 */
     distance: number;
     textColor?: string;
@@ -106,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。
@@ -114,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;
 /**
@@ -131,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/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

@@ -1,6 +1,8 @@
 import { JsonObjectSchema } from "../ir/json.js";
-import { asRectAnchor } from "../shapes/_shared.js";
+import { arcEndPoint } from "../geometry/arc.js";
+import { normalizeCompassAnchor } from "../geometry/anchor.js";
 import { BUILTIN_SHAPES } from "../shapes/index.js";
+import { DirectionVectorByAtDirection, LabelAnchorByAtDirection } from "./direction.js";
 import { resolvePosition } from "./position.js";
 import { toAlphabeticBaselineY } from "./text-baseline.js";
 import { resolveBoundary } from "./boundary.js";
@@ -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 (asRectAnchor(name) !== void 0) {
+	const compassAnchor = normalizeCompassAnchor(name);
+	if (compassAnchor !== void 0) {
 		const { def, rect, params } = 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, 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 arcEndPoint([bx, by], label.distance, label.position);
+	const vec = 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 = 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,13 +374,14 @@ 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,
 		labels,
 		boundary: node.boundary,
 		meta: node.meta,
+		animations: node.animations,
 		shapes
 	};
 };
@@ -457,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;
@@ -526,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);
@@ -546,6 +523,7 @@ var emitNodePrimitives = (layout, round, resolveFill) => {
 	if (!(layout.rotateDeg !== 0 || layout.lines !== void 0)) {
 		if (layout.id !== void 0) for (const prim of shapePrims) prim.id = layout.id;
 		if (layout.meta !== void 0) for (const prim of shapePrims) prim.meta = layout.meta;
+		if (layout.animations !== void 0) for (const prim of shapePrims) prim.animations = layout.animations;
 		return inner;
 	}
 	const group = {
@@ -554,6 +532,7 @@ var emitNodePrimitives = (layout, round, resolveFill) => {
 	};
 	if (layout.id !== void 0) group.id = layout.id;
 	if (layout.meta !== void 0) group.meta = layout.meta;
+	if (layout.animations !== void 0) group.animations = layout.animations;
 	if (layout.rotateDeg !== 0) group.transforms = [{
 		kind: "rotate",
 		degrees: round(layout.rotateDeg),
@@ -563,4 +542,4 @@ var emitNodePrimitives = (layout, round, resolveFill) => {
 	return [group];
 };
 //#endregion
-export { anchorOf, angleBoundaryOf, boundaryPointOf, emitNodePrimitives, labelExtentPoints, layoutNode };
+export { anchorOf, angleBoundaryOf, boundaryPointOf, emitNodePrimitives, labelExtentPoints, layoutNode, outerRectOf };

package/dist/es/compile/paint.js

@@ -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/es/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/es/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"}

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

@@ -1,4 +1,6 @@
-import { lerpPoint } from "../../geometry/_edge.js";
+import { FoldStepVia } from "../../ir/path/step.js";
+import { lerpPoint } from "../../geometry/edge.js";
+import { point } from "../../geometry/point.js";
 import { applyTransformChain } from "../scope.js";
 import { resolvePosition } from "../position.js";
 import { boundaryPointOf } from "../node.js";
@@ -6,6 +8,7 @@ import { resolveAnchor, resolveEdgePoint } from "../anchor-cache.js";
 //#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)) {
@@ -43,7 +46,7 @@ var refPointOfTarget = (target, nameStack, scopeChain = []) => {
 	return scopeChain.length === 0 ? local : 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 === FoldStepVia.HorizontalThenVertical ? [curr[0], prev[1]] : [prev[0], curr[1]];
 /**
 * 在 toward 方向算 step.to 的实际绘制端点
 * @description 节点 auto `'A'`：按 shape 走 boundaryPointOf 求中心→toward 射线交点；命名 anchor/角度：位置已定不受 toward 影响；直接坐标/极坐标：解析后返回；失败返回 null。
@@ -64,14 +67,8 @@ var clipForTarget = (target, toward, nameStack, scopeChain = []) => {
 	return scopeChain.length === 0 ? local : 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 && 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) => point.shiftToward(p, target, dist);
 //#endregion
-export { clipForTarget, cornerOf, refPointOfTarget, samePoint, shiftToward };
+export { clipForTarget, cornerOf, isAutoBoundaryTarget, refPointOfTarget, samePoint, shiftToward };

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

@@ -1,30 +1,27 @@
 import { PaintResolver } from '../paint';
 import { IRPath, IRPosition } from '../../ir';
 import { ScenePrimitive, Transform } from '../../primitive';
-import { PathGeneratorDefinition } from '../../pathGenerators';
+import { PathGeneratorDefinition } from '../../path-generators';
+import { CompileWarning } from '../constant';
 import { NameStack } from '../name-stack';
 import { TextMeasurer } from '../text-metrics';
 import { EffectiveArrows } from './shrink';
 /** emitPathPrimitive 可选 warn 钩子 */
 export type EmitPathWarnHook = {
     /** 警告收集器（由 compileToScene 传入） */
-    onWarn?: (warning: {
-        code: string;
-        message: string;
-        path: string;
-    }) => void;
+    onWarn?: (warning: CompileWarning) => void;
     /** 当前 path 在 IR 中的 locator 前缀（如 `'children[3].path'`） */
     irPath?: string;
     /**
      * 该 path 所属 scope 的累积 Cartesian-only transform 链
      * @description step.to 内的 polar/at/offset 字面量按"当前 scope 局部度量 + 末端 apply chain"
-     *   投影回全局；顶层 path / 无 scope chain 时为 `[]`（恒等，等价 v0.1 行为）
+     *   投影回全局；顶层 path / 无 scope chain 时为 `[]`（恒等，全局坐标）
      */
     scopeChain?: ReadonlyArray<Transform>;
     /** fill 解析器（PaintSpec → resourceRef + 登记资源）；缺省时纯色透传、PaintSpec 退化为无填充 */
     resolveFill?: PaintResolver;
     /**
-     * 有效 arrow 表（内置 7 + 注入）；缺省 = 仅内置 7
+     * 有效 arrow 表（内置 8 + 注入）；缺省 = 仅内置 8
      * @description compileToScene 合并 `{ ...BUILTIN_ARROWS, ...options.arrows }` 传入；
      *   endpointArrows 据此查表算 shrink / 调 def.emit；未注册名编译期 throw
      */
@@ -45,4 +42,5 @@ export declare const emitPathPrimitive: (path: IRPath, nameStack: NameStack, rou
     primitives: Array<ScenePrimitive>;
     points: Array<IRPosition>;
 } | null;
+export { refPointOfTarget } from './anchor';
 //# sourceMappingURL=index.d.ts.map