@retikz/core 0.2.0-alpha.5 → 0.2.0-alpha.7

package/dist/lib/compile/node.cjs

@@ -5,6 +5,49 @@ var DEFAULT_FONT_SIZE = 14;
 var DEFAULT_PADDING = 8;
 var DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
 var DEG_TO_RAD = Math.PI / 180;
+/** CJK / fullwidth ranges: break per-character (no whitespace needed) */
+var isCjk = (ch) => {
+	const c = ch.codePointAt(0) ?? 0;
+	return c >= 12288 && c <= 12351 || c >= 12352 && c <= 12543 || c >= 13312 && c <= 19903 || c >= 19968 && c <= 40959 || c >= 63744 && c <= 64255 || c >= 65280 && c <= 65519;
+};
+/**
+* 按 maxWidth 贪心折行：西文按词（空白分割）、CJK 按字；长不可断 token 溢出不硬断
+* @description 用注入的 measureText 度量；连续空白归一为单空格分隔。空文本返回 [''].
+*/
+var wrapText = (text, font, maxWidth, measure) => {
+	const units = [];
+	for (const seg of text.split(/(\s+)/)) {
+		if (seg === "") continue;
+		if (/^\s+$/.test(seg)) {
+			units.push(" ");
+			continue;
+		}
+		let run = "";
+		for (const ch of seg) if (isCjk(ch)) {
+			if (run) {
+				units.push(run);
+				run = "";
+			}
+			units.push(ch);
+		} else run += ch;
+		if (run) units.push(run);
+	}
+	const lines = [];
+	let cur = "";
+	for (const u of units) {
+		if (u === " ") {
+			if (cur !== "") cur += " ";
+			continue;
+		}
+		const candidate = cur === "" ? u : cur + u;
+		if (cur !== "" && measure(candidate, font).width > maxWidth) {
+			lines.push(cur.trimEnd());
+			cur = u;
+		} else cur = candidate;
+	}
+	if (cur.trimEnd() !== "") lines.push(cur.trimEnd());
+	return lines.length > 0 ? lines : [""];
+};
 /** Node label 与 node 边界默认距离（TikZ 默认 0pt 视觉太贴） */
 var DEFAULT_LABEL_DISTANCE = 12;
 /** dashed 预设：4 px 实线 + 2 px 间隙循环 */
@@ -84,7 +127,8 @@ var LABEL_DIRECTION_MAP = {
 *   若用带 rotate 的 rect，label 位置会被 anchorOf / angleBoundaryOf 旋转一次、再被外层 group 旋转一次（双重旋转）。
 *   anchorOf / angleBoundaryOf 本身不改（path anchor `'A.north'` / `'A.30'` 仍需带 rotate 的 rect）。
 */
-var labelCenter = (layout, label) => {
+/** label 在 node 边界上的附着点（未旋转局部系；pin 引线起点 = 此点） */
+var labelBorderPoint = (layout, label) => {
 	const aaLayout = {
 		...layout,
 		rect: {
@@ -92,15 +136,32 @@ var labelCenter = (layout, label) => {
 			rotate: 0
 		}
 	};
+	if (typeof label.position === "number") return angleBoundaryOf(aaLayout, label.position);
+	const { anchor } = LABEL_DIRECTION_MAP[label.position];
+	return anchorOf(aaLayout, anchor);
+};
+var labelCenter = (layout, label) => {
+	const [bx, by] = labelBorderPoint(layout, label);
 	if (typeof label.position === "number") {
 		const rad = label.position * Math.PI / 180;
-		const [bx, by] = angleBoundaryOf(aaLayout, label.position);
 		return [bx + Math.cos(rad) * label.distance, by + Math.sin(rad) * label.distance];
 	}
-	const { anchor, vec } = LABEL_DIRECTION_MAP[label.position];
-	const [bx, by] = anchorOf(aaLayout, anchor);
+	const { vec } = LABEL_DIRECTION_MAP[label.position];
 	return [bx + vec[0] * label.distance, by + vec[1] * label.distance];
 };
+/** 从 label 中心朝 border 方向，求 label 框（halfW×halfH）边界交点（pin 引线终点 = label 框近 node 边） */
+var labelBoxEdgeToward = (center, border, halfW, halfH) => {
+	const dx = border[0] - center[0];
+	const dy = border[1] - center[1];
+	const len = Math.hypot(dx, dy);
+	if (len < 1e-9) return center;
+	const ux = dx / len;
+	const uy = dy / len;
+	const sx = Math.abs(ux) > 1e-9 ? halfW / Math.abs(ux) : Number.POSITIVE_INFINITY;
+	const sy = Math.abs(uy) > 1e-9 ? halfH / Math.abs(uy) : Number.POSITIVE_INFINITY;
+	const s = Math.min(sx, sy, len);
+	return [center[0] + ux * s, center[1] + uy * s];
+};
 /** 角度换算常量（弧度 → 度） */
 var RAD_TO_DEG = 180 / Math.PI;
 /**
@@ -162,32 +223,38 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 	const lineHeight = (node.lineHeight ?? baseFontSize * DEFAULT_LINE_HEIGHT_FACTOR) * sy;
 	const align = alignToTextAnchor(node.align ?? "center");
 	const rawLines = node.text === void 0 ? void 0 : typeof node.text === "string" ? [node.text] : node.text;
+	const maxTextWidth = node.maxTextWidth !== void 0 ? node.maxTextWidth * sx : void 0;
 	let textWidth = 0;
 	let textHeight = 0;
 	let lines;
 	if (rawLines) {
-		lines = rawLines.map((spec) => {
+		lines = [];
+		for (const spec of rawLines) {
 			const isObj = typeof spec !== "string";
 			const text = isObj ? spec.text : spec;
 			const lineFont = isObj ? spec.font : void 0;
-			const m = measureText(text, {
+			const font = {
 				size: lineFont?.size ?? fontSize,
 				family: lineFont?.family ?? fontFamily,
 				weight: lineFont?.weight ?? fontWeight,
 				style: lineFont?.style ?? fontStyle
-			});
-			if (m.width > textWidth) textWidth = m.width;
-			const out = { text };
-			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?.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;
+			};
+			const physical = maxTextWidth !== void 0 ? wrapText(text, font, maxTextWidth, measureText) : [text];
+			for (const ptext of physical) {
+				const m = measureText(ptext, font);
+				if (m.width > textWidth) textWidth = m.width;
+				const out = { text: ptext };
+				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?.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;
+				}
+				lines.push(out);
 			}
-			return out;
-		});
+		}
 		textHeight = lines.length * lineHeight;
 	}
 	const minW = node.minimumWidth ?? node.minimumSize ?? 0;
@@ -200,18 +267,29 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 	if (!center) throw new Error(`Cannot resolve position for node ${node.id ?? "(unnamed)"}; polar.origin or at.of may reference an undefined node`);
 	const labels = (node.label === void 0 ? void 0 : Array.isArray(node.label) ? node.label : [node.label])?.map((lab) => {
 		const labFont = lab.font;
+		const labFontSize = (labFont?.size ?? labelDefault?.font?.size ?? baseFontSize) * fontScale;
+		const labFamily = labFont?.family ?? labelDefault?.font?.family ?? fontFamily;
+		const labWeight = labFont?.weight ?? labelDefault?.font?.weight ?? fontWeight;
+		const labStyle = labFont?.style ?? labelDefault?.font?.style ?? fontStyle;
 		return {
 			text: lab.text,
 			position: lab.position ?? "above",
 			distance: lab.distance ?? DEFAULT_LABEL_DISTANCE,
 			textColor: lab.textColor ?? labelDefault?.textColor ?? labelDefault?.color ?? node.textColor,
 			opacity: lab.opacity ?? labelDefault?.opacity,
-			fontSize: (labFont?.size ?? labelDefault?.font?.size ?? baseFontSize) * fontScale,
-			fontFamily: labFont?.family ?? labelDefault?.font?.family ?? fontFamily,
-			fontWeight: labFont?.weight ?? labelDefault?.font?.weight ?? fontWeight,
-			fontStyle: labFont?.style ?? labelDefault?.font?.style ?? fontStyle,
+			fontSize: labFontSize,
+			fontFamily: labFamily,
+			fontWeight: labWeight,
+			fontStyle: labStyle,
 			rotate: lab.rotate,
-			keepUpright: lab.keepUpright
+			keepUpright: lab.keepUpright,
+			measuredWidth: measureText(lab.text, {
+				size: labFontSize,
+				family: labFamily,
+				weight: labWeight,
+				style: labStyle
+			}).width,
+			pin: lab.pin
 		};
 	});
 	return {
@@ -248,9 +326,9 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 		labels
 	};
 };
-/** 从 NodeLayout 收敛 emit 所需的视觉样式子集（ShapeStyle，不含几何 / 文本） */
-var toShapeStyle = (layout) => ({
-	fill: layout.fill,
+/** 从 NodeLayout 收敛 emit 所需的视觉样式子集（ShapeStyle，不含几何 / 文本）；fill 经 resolveFill 转 PaintValue */
+var toShapeStyle = (layout, resolveFill) => ({
+	fill: resolveFill(layout.fill),
 	fillOpacity: layout.fillOpacity,
 	stroke: layout.stroke,
 	strokeOpacity: layout.strokeOpacity,
@@ -264,12 +342,44 @@ var toShapeStyle = (layout) => ({
 * @description shape 主体走 `shapeDef.emit`（收轴对齐 rect、可出多 primitive）；text 始终走 TextPrim；
 *   有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹 shape + text（diamond 顶点 / text 都靠 group 旋转）
 */
-var emitNodePrimitives = (layout, round) => {
+/**
+* 节点 label 的外接点（供顶层 bbox / viewBox 计算，让 label 不被裁——与 step.label 进 bbox 一致）
+* @description 每个 label 取其文本框四角；label 中心走 labelCenter（轴对齐系），node 自身 rotate 时绕 node 中心旋转
+*   （与 emit 的 group rotate 同步）。pin 引线起点在 node 边界内、已被 node 四角覆盖，无需额外。
+*/
+var labelExtentPoints = (layout) => {
+	if (!layout.labels || layout.labels.length === 0) return [];
+	const cx = layout.rect.x;
+	const cy = layout.rect.y;
+	const rad = layout.rotateDeg * Math.PI / 180;
+	const cos = Math.cos(rad);
+	const sin = Math.sin(rad);
+	const pts = [];
+	for (const lab of layout.labels) {
+		const [lx, ly] = labelCenter(layout, lab);
+		const halfW = lab.measuredWidth / 2;
+		const halfH = lab.fontSize / 2;
+		const corners = [
+			[lx - halfW, ly - halfH],
+			[lx + halfW, ly - halfH],
+			[lx - halfW, ly + halfH],
+			[lx + halfW, ly + halfH]
+		];
+		for (const [px, py] of corners) if (layout.rotateDeg === 0) pts.push([px, py]);
+		else {
+			const dx = px - cx;
+			const dy = py - cy;
+			pts.push([cx + dx * cos - dy * sin, cy + dx * sin + dy * cos]);
+		}
+	}
+	return pts;
+};
+var emitNodePrimitives = (layout, round, resolveFill) => {
 	const axisAlignedRect = {
 		...layout.rect,
 		rotate: 0
 	};
-	const inner = [...layout.shapeDef.emit(axisAlignedRect, toShapeStyle(layout), round)];
+	const inner = [...layout.shapeDef.emit(axisAlignedRect, toShapeStyle(layout, resolveFill), round)];
 	if (layout.lines) {
 		const halfBlockW = layout.textWidth / 2;
 		const xOffset = layout.align === "start" ? -halfBlockW : layout.align === "end" ? halfBlockW : 0;
@@ -296,6 +406,26 @@ var emitNodePrimitives = (layout, round) => {
 		const cy = layout.rect.y;
 		for (const lab of layout.labels) {
 			const [lx, ly] = labelCenter(layout, lab);
+			if (lab.pin) {
+				const style = typeof lab.pin === "object" ? lab.pin : void 0;
+				const [bx, by] = labelBorderPoint(layout, lab);
+				const pad = 2;
+				const [nx, ny] = labelBoxEdgeToward([lx, ly], [bx, by], lab.measuredWidth / 2 + pad, lab.fontSize / 2 + pad);
+				inner.push({
+					type: "path",
+					commands: [{
+						kind: "move",
+						to: [round(bx), round(by)]
+					}, {
+						kind: "line",
+						to: [round(nx), round(ny)]
+					}],
+					stroke: style?.stroke ?? lab.textColor ?? "currentColor",
+					strokeWidth: style?.strokeWidth ?? 1,
+					dashPattern: style?.dashPattern,
+					opacity: lab.opacity ?? layout.opacity
+				});
+			}
 			const textPrim = {
 				type: "text",
 				x: round(lx),
@@ -345,4 +475,5 @@ exports.anchorOf = anchorOf;
 exports.angleBoundaryOf = angleBoundaryOf;
 exports.boundaryPointOf = boundaryPointOf;
 exports.emitNodePrimitives = emitNodePrimitives;
+exports.labelExtentPoints = labelExtentPoints;
 exports.layoutNode = layoutNode;

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

@@ -1,6 +1,7 @@
 import { Position } from '../geometry/point';
 import { Rect } from '../geometry/rect';
-import { AtDirection, IRLabelDefault, IRNode } from '../ir';
+import { AtDirection, IRLabelDefault, IRNode, IRPaintSpec } from '../ir';
+import { PaintResolver } from './paint';
 import { ScenePrimitive, TextLine, Transform } from '../primitive';
 import { ShapeDefinition } from '../shapes';
 import { NameStack } from './name-stack';
@@ -42,8 +43,8 @@ export type NodeLayout = {
     fontWeight?: string | number;
     /** 字形 */
     fontStyle?: 'normal' | 'italic' | 'oblique';
-    /** 节点背景色，emit 时 'transparent' 兜底 */
-    fill?: string;
+    /** 节点背景填充（纯色 / PaintSpec gradient），emit 时经 resolveFill → PaintValue、'transparent' 兜底 */
+    fill?: string | IRPaintSpec;
     /** 填充透明度 0~1 */
     fillOpacity?: number;
     /** 节点边框色，emit 时 'currentColor' 兜底 */
@@ -83,6 +84,14 @@ export type NodeLabelLayout = {
     rotate?: 'none' | 'radial' | 'tangent' | number;
     /** 自旋后若文字倒置则翻 180°；缺省 false */
     keepUpright?: boolean;
+    /** label 文本测量宽度（pin leader 算 label 框近边用） */
+    measuredWidth: number;
+    /** pin：true = 默认引线；对象 = 带样式引线（stroke / strokeWidth / dashPattern）；缺省 / false = 无引线 */
+    pin?: boolean | {
+        stroke?: string;
+        strokeWidth?: number;
+        dashPattern?: Array<number>;
+    };
 };
 /**
  * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
@@ -113,5 +122,11 @@ export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameS
  * @description shape 主体走 `shapeDef.emit`（收轴对齐 rect、可出多 primitive）；text 始终走 TextPrim；
  *   有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹 shape + text（diamond 顶点 / text 都靠 group 旋转）
  */
-export declare const emitNodePrimitives: (layout: NodeLayout, round: (n: number) => number) => Array<ScenePrimitive>;
+/**
+ * 节点 label 的外接点（供顶层 bbox / viewBox 计算，让 label 不被裁——与 step.label 进 bbox 一致）
+ * @description 每个 label 取其文本框四角；label 中心走 labelCenter（轴对齐系），node 自身 rotate 时绕 node 中心旋转
+ *   （与 emit 的 group rotate 同步）。pin 引线起点在 node 边界内、已被 node 四角覆盖，无需额外。
+ */
+export declare const labelExtentPoints: (layout: NodeLayout) => Array<Position>;
+export declare const emitNodePrimitives: (layout: NodeLayout, round: (n: number) => number, resolveFill: PaintResolver) => Array<ScenePrimitive>;
 //# sourceMappingURL=node.d.ts.map

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

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

package/dist/lib/compile/paint.cjs

@@ -0,0 +1,37 @@
+//#region src/compile/paint.ts
+/**
+* 建一个 paint 登记表
+* @description resolve 对相同 PaintSpec（结构化 JSON 深比较）合并为一个资源、派稳定 id（`paint-1` / `paint-2`…，首见序）。
+*   同一份 IR 编译两次 → 同 id（快照稳定、SSR / CSR 一致）。SVG id 跨实例唯一性由 react adapter 加 useId 前缀解决。
+*/
+var createPaintRegistry = () => {
+	const idByKey = /* @__PURE__ */ new Map();
+	const list = [];
+	let counter = 0;
+	const resolve = (fill) => {
+		if (fill === void 0) return void 0;
+		if (typeof fill === "string") return fill;
+		const key = JSON.stringify(fill);
+		let id = idByKey.get(key);
+		if (id === void 0) {
+			counter += 1;
+			id = `paint-${counter}`;
+			idByKey.set(key, id);
+			list.push({
+				kind: "paint",
+				id,
+				spec: fill
+			});
+		}
+		return {
+			kind: "resourceRef",
+			id
+		};
+	};
+	return {
+		resolve,
+		resources: () => list
+	};
+};
+//#endregion
+exports.createPaintRegistry = createPaintRegistry;

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

@@ -0,0 +1,16 @@
+import { IRPaintSpec } from '../ir';
+import { PaintValue, SceneResource } from '../primitive';
+/** fill 解析器：纯色 string 原样返回；PaintSpec 去重 + 派稳定 id → `{ kind:'resourceRef', id }`；undefined 透传 */
+export type PaintResolver = (fill: string | IRPaintSpec | undefined) => PaintValue | undefined;
+/** paint 资源登记表：编译期收集 PaintSpec、去重派 id，最后产出 Scene.resources */
+export type PaintRegistry = {
+    resolve: PaintResolver;
+    resources: () => Array<SceneResource>;
+};
+/**
+ * 建一个 paint 登记表
+ * @description resolve 对相同 PaintSpec（结构化 JSON 深比较）合并为一个资源、派稳定 id（`paint-1` / `paint-2`…，首见序）。
+ *   同一份 IR 编译两次 → 同 id（快照稳定、SSR / CSR 一致）。SVG id 跨实例唯一性由 react adapter 加 useId 前缀解决。
+ */
+export declare const createPaintRegistry: () => PaintRegistry;
+//# sourceMappingURL=paint.d.ts.map

package/dist/lib/compile/paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/compile/paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9D,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,KAAK,UAAU,GAAG,SAAS,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAO,aAkBtC,CAAC"}

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

@@ -2,8 +2,17 @@ const require_scope = require("../scope.cjs");
 const require_position = require("../position.cjs");
 const require_node = require("../node.cjs");
 const require_anchor_cache = require("../anchor-cache.cjs");
-const require_parseTarget = require("../parseTarget.cjs");
 //#region src/compile/path/anchor.ts
+/** target 是否对象形态 NodeTarget（`{ id, anchor?, offset? }`）；与 Position(array) / Polar / Offset(of) / Relative 区分（独有 `id`） */
+var isNodeTarget = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t;
+/** 解析 NodeTarget 的 anchor（非 undefined）到世界坐标：命名 / 角度走 resolveAnchor，`{ side, t }` 走 resolveEdgePoint */
+var resolveAnchorRef = (node, anchor) => {
+	if (typeof anchor === "number") return require_anchor_cache.resolveAnchor(node, String(anchor));
+	if (typeof anchor === "string") return require_anchor_cache.resolveAnchor(node, anchor);
+	return require_anchor_cache.resolveEdgePoint(node, anchor.side, anchor.t);
+};
+/** anchor/边点解析后叠加世界系 offset（不随节点 rotate 旋转） */
+var addOffset = (base, offset) => offset ? [base[0] + offset[0], base[1] + offset[1]] : base;
 /**
 * 求 step.to 的参考点（给 boundary clip 算方向 / 折角 corner 用）
 * @description 三态：`'A'`(auto) 节点中心；`'A.<anchor>'`/`'A.<deg>'` 显式锚点 refPoint=endpoint 位置不随邻居变。直接坐标/极坐标解析为笛卡尔。
@@ -12,15 +21,10 @@ const require_parseTarget = require("../parseTarget.cjs");
 *   `applyTransformChain` 投回全局。`scopeChain=[]` 等价 v0.1（恒等）。
 */
 var refPointOfTarget = (target, nameStack, scopeChain = []) => {
-	if (typeof target === "string") {
-		const ref = require_parseTarget.parseNodeRef(target);
-		const node = nameStack.lookup(ref.id);
+	if (isNodeTarget(target)) {
+		const node = nameStack.lookup(target.id);
 		if (!node) return null;
-		switch (ref.kind) {
-			case "node": return [node.rect.x, node.rect.y];
-			case "anchor": return require_anchor_cache.resolveAnchor(node, ref.anchor);
-			case "angle": return require_anchor_cache.resolveAnchor(node, String(ref.angle));
-		}
+		return addOffset(target.anchor === void 0 ? [node.rect.x, node.rect.y] : resolveAnchorRef(node, target.anchor), target.offset);
 	}
 	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
 	const local = require_position.resolvePosition(target, nameStack, void 0, scopeChain);
@@ -36,15 +40,10 @@ var cornerOf = (prev, curr, via) => via === "-|" ? [curr[0], prev[1]] : [prev[0]
 *   `resolvePosition(..., scopeChain)` 拿到当前 scope 局部坐标后 `applyTransformChain` 投回全局。
 */
 var clipForTarget = (target, toward, nameStack, scopeChain = []) => {
-	if (typeof target === "string") {
-		const ref = require_parseTarget.parseNodeRef(target);
-		const node = nameStack.lookup(ref.id);
+	if (isNodeTarget(target)) {
+		const node = nameStack.lookup(target.id);
 		if (!node) return null;
-		switch (ref.kind) {
-			case "node": return require_node.boundaryPointOf(node, toward);
-			case "anchor": return require_anchor_cache.resolveAnchor(node, ref.anchor);
-			case "angle": return require_anchor_cache.resolveAnchor(node, String(ref.angle));
-		}
+		return addOffset(target.anchor === void 0 ? require_node.boundaryPointOf(node, toward) : resolveAnchorRef(node, target.anchor), target.offset);
 	}
 	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
 	const local = require_position.resolvePosition(target, nameStack, void 0, scopeChain);

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

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAqBf,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,IAqBf,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":"AAAA,OAAO,KAAK,EAAgB,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAqB/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAkBf,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,IAkBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACzB,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAM7E,CAAC"}

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

@@ -9,6 +9,8 @@ const require_relative = require("./relative.cjs");
 const require_shrink = require("./shrink.cjs");
 const require_split = require("./split.cjs");
 //#region src/compile/path/index.ts
+/** 目标若是对象 NodeTarget（`{ id, ... }`）返回其 id，否则 undefined——给 UNRESOLVED_NODE_REFERENCE 诊断用 */
+var nodeRefId = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t ? t.id : void 0;
 /**
 * 语义 stroke 档位 → 数值（user units）
 * @description 对齐 TikZ 比例（thin=0.4pt→1=默认 strokeWidth）：ultraThin 0.25、veryThin 0.5、thin 1、semithick 1.5、thick 2、veryThick 3、ultraThick 4。显式 strokeWidth 覆盖 thickness。
@@ -37,6 +39,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		});
 	};
 	const scopeChain = warnHook.scopeChain ?? [];
+	const resolveFill = warnHook.resolveFill ?? ((f) => typeof f === "string" || f === void 0 ? f : void 0);
 	const steps = require_relative.normalizeRelativeTargets(path.children, nameStack, scopeChain);
 	if (steps.length < 2) {
 		warn("PATH_TOO_SHORT", `Path requires at least 2 steps (got ${steps.length}); the entire path is skipped`, "children");
@@ -56,7 +59,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 	const anchors = steps.map((s, idx) => {
 		if (!hasTo(s)) return null;
 		const ref = require_anchor.refPointOfTarget(s.to, nameStack, scopeChain);
-		if (!ref && typeof s.to === "string") warn("UNRESOLVED_NODE_REFERENCE", `Step.to references undefined node id '${s.to}'; the entire path is skipped`, `children[${idx}].to`);
+		const toId = nodeRefId(s.to);
+		if (!ref && toId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Step.to references undefined node id '${toId}'; the entire path is skipped`, `children[${idx}].to`);
 		return ref;
 	});
 	/**
@@ -204,8 +208,10 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			const fromPt = require_anchor.refPointOfTarget(step.from, nameStack, scopeChain);
 			const toPt = require_anchor.refPointOfTarget(step.to, nameStack, scopeChain);
 			if (!fromPt || !toPt) {
-				if (!fromPt && typeof step.from === "string") warn("UNRESOLVED_NODE_REFERENCE", `Rectangle from references undefined node id '${step.from}'; the entire path is skipped`, `children[${i}].from`);
-				if (!toPt && typeof step.to === "string") warn("UNRESOLVED_NODE_REFERENCE", `Rectangle to references undefined node id '${step.to}'; the entire path is skipped`, `children[${i}].to`);
+				const fromId = nodeRefId(step.from);
+				const rectToId = nodeRefId(step.to);
+				if (!fromPt && fromId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Rectangle from references undefined node id '${fromId}'; the entire path is skipped`, `children[${i}].from`);
+				if (!toPt && rectToId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Rectangle to references undefined node id '${rectToId}'; the entire path is skipped`, `children[${i}].to`);
 				return null;
 			}
 			let rectStart = null;
@@ -230,7 +236,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			if (step.center !== void 0) {
 				const c = require_anchor.refPointOfTarget(step.center, nameStack, scopeChain);
 				if (!c) {
-					if (typeof step.center === "string") warn("UNRESOLVED_NODE_REFERENCE", `Arc step center references undefined node id '${step.center}'; the entire path is skipped`, `children[${i}].center`);
+					const centerId = nodeRefId(step.center);
+					if (centerId !== void 0) warn("UNRESOLVED_NODE_REFERENCE", `Arc step center references undefined node id '${centerId}'; the entire path is skipped`, `children[${i}].center`);
 					return null;
 				}
 				center = c;
@@ -367,7 +374,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 	const baseProps = {
 		stroke: path.stroke ?? "currentColor",
 		strokeWidth,
-		fill: path.fill ?? "none",
+		fill: resolveFill(path.fill) ?? "none",
 		fillRule: path.fillRule,
 		dashPattern: path.dashPattern,
 		strokeLinecap: path.lineCap,

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

@@ -1,3 +1,4 @@
+import { PaintResolver } from '../paint';
 import { IRPath, IRPosition } from '../../ir';
 import { ScenePrimitive, Transform } from '../../primitive';
 import { NameStack } from '../name-stack';
@@ -18,6 +19,8 @@ export type EmitPathWarnHook = {
      *   投影回全局；顶层 path / 无 scope chain 时为 `[]`（恒等，等价 v0.1 行为）
      */
     scopeChain?: ReadonlyArray<Transform>;
+    /** fill 解析器（PaintSpec → resourceRef + 登记资源）；缺省时纯色透传、PaintSpec 退化为无填充 */
+    resolveFill?: PaintResolver;
 };
 /**
  * IR Path → PathPrim

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AA8BtE,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA8gBrE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAkCtE,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,wEAAwE;IACxE,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IAqhBrE,CAAC"}

package/dist/lib/geometry/_edge.cjs

@@ -0,0 +1,38 @@
+//#region src/geometry/_edge.ts
+/**
+* rect 四直边 t=0 / t=1 端点对应的角 anchor
+* @description 方向约定单一真源：north/south = 西→东（t=0 在 west 端），east/west = 北→南（t=0 在 north 端）。
+*   仅 rect 直边用两角端点；circle/ellipse 用 `edgeAngleDeg` 角度表、diamond 用过顶点折线。
+*/
+var EDGE_ENDS = {
+	north: ["north-west", "north-east"],
+	south: ["south-west", "south-east"],
+	east: ["north-east", "south-east"],
+	west: ["north-west", "south-west"]
+};
+/** 线性插值 a + (b − a)·t */
+var lerpPoint = (a, b, t) => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t];
+/**
+* circle / ellipse 周长弧段：side 的局部参数角 θ(t)，单位度
+* @description 约定同 geometry 既有 `(cosθ, sinθ)` + y 轴向下 ⇒ east=0° / south=90° / west=180° / north=270°，
+*   顺时针为正。每条 side 是一段 90° 弧（等角插值）；三点（t=0/0.5/1）与 9-anchor 重合。
+*/
+var edgeAngleDeg = (side, t) => {
+	switch (side) {
+		case "north": return 225 + 90 * t;
+		case "south": return 135 - 90 * t;
+		case "east": return -45 + 90 * t;
+		case "west": return 225 - 90 * t;
+	}
+};
+/**
+* diamond 过 cardinal 顶点的两段折线
+* @description t∈[0,0.5] 走 p0→vertex、t∈[0.5,1] 走 vertex→p1；t=0.5 恰落 vertex。
+*   p0/p1 为相邻边中点 anchor、vertex 为 cardinal 顶点 anchor——全落真实斜边
+*/
+var polylineViaVertex = (p0, vertex, p1, t) => t <= .5 ? lerpPoint(p0, vertex, t * 2) : lerpPoint(vertex, p1, (t - .5) * 2);
+//#endregion
+exports.EDGE_ENDS = EDGE_ENDS;
+exports.edgeAngleDeg = edgeAngleDeg;
+exports.lerpPoint = lerpPoint;
+exports.polylineViaVertex = polylineViaVertex;

package/dist/lib/geometry/_edge.d.ts

@@ -0,0 +1,29 @@
+import { Position } from './point';
+/** 边上比例点 `{ side, t }` 的四个 side（north/south/east/west） */
+export type Side = 'north' | 'south' | 'east' | 'west';
+/**
+ * rect 四直边 t=0 / t=1 端点对应的角 anchor
+ * @description 方向约定单一真源：north/south = 西→东（t=0 在 west 端），east/west = 北→南（t=0 在 north 端）。
+ *   仅 rect 直边用两角端点；circle/ellipse 用 `edgeAngleDeg` 角度表、diamond 用过顶点折线。
+ */
+export declare const EDGE_ENDS: {
+    readonly north: readonly ["north-west", "north-east"];
+    readonly south: readonly ["south-west", "south-east"];
+    readonly east: readonly ["north-east", "south-east"];
+    readonly west: readonly ["north-west", "south-west"];
+};
+/** 线性插值 a + (b − a)·t */
+export declare const lerpPoint: (a: Position, b: Position, t: number) => Position;
+/**
+ * circle / ellipse 周长弧段：side 的局部参数角 θ(t)，单位度
+ * @description 约定同 geometry 既有 `(cosθ, sinθ)` + y 轴向下 ⇒ east=0° / south=90° / west=180° / north=270°，
+ *   顺时针为正。每条 side 是一段 90° 弧（等角插值）；三点（t=0/0.5/1）与 9-anchor 重合。
+ */
+export declare const edgeAngleDeg: (side: Side, t: number) => number;
+/**
+ * diamond 过 cardinal 顶点的两段折线
+ * @description t∈[0,0.5] 走 p0→vertex、t∈[0.5,1] 走 vertex→p1；t=0.5 恰落 vertex。
+ *   p0/p1 为相邻边中点 anchor、vertex 为 cardinal 顶点 anchor——全落真实斜边
+ */
+export declare const polylineViaVertex: (p0: Position, vertex: Position, p1: Position, t: number) => Position;
+//# sourceMappingURL=_edge.d.ts.map

package/dist/lib/geometry/_edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_edge.d.ts","sourceRoot":"","sources":["../../../src/geometry/_edge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,0DAA0D;AAC1D,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;CAK8C,CAAC;AAErE,yBAAyB;AACzB,eAAO,MAAM,SAAS,GAAI,GAAG,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,KAAG,QAG/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,EAAE,GAAG,MAAM,KAAG,MAWpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,QAAQ,EACZ,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,QAA4F,CAAC"}

package/dist/lib/geometry/circle.cjs

@@ -1,5 +1,7 @@
 const require__transform = require("./_transform.cjs");
+const require__edge = require("./_edge.cjs");
 //#region src/geometry/circle.ts
+var DEG_TO_RAD = Math.PI / 180;
 var SQRT_HALF = Math.SQRT1_2;
 /** 圆形相关基础工具 */
 var circle = {
@@ -55,6 +57,11 @@ var circle = {
 		if (len === 0) return [c.x, c.y];
 		const t = c.radius / len;
 		return require__transform.localToWorld(c, [lx * t, ly * t]);
+	},
+	/** 边上比例点：side 的 90° 周长弧段 t∈[0,1] 处（等角，落真实圆周；含旋转） */
+	edgePoint: (c, side, t) => {
+		const rad = require__edge.edgeAngleDeg(side, t) * DEG_TO_RAD;
+		return require__transform.localToWorld(c, [c.radius * Math.cos(rad), c.radius * Math.sin(rad)]);
 	}
 };
 //#endregion