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

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

@@ -1,3 +1,4 @@
+import { Side } from '../geometry/_edge';
 import { IRPosition } from '../ir';
 import { NodeLayout } from './node';
 /**
@@ -9,4 +10,13 @@ import { NodeLayout } from './node';
  * @returns 全局坐标系下的 IRPosition `[x, y]`
  */
 export declare const resolveAnchor: (layout: NodeLayout, anchorName: string) => IRPosition;
+/**
+ * 取节点边上比例点 `{ side, t }` 的全局坐标，带 per-layout 缓存
+ * @description 走 `layout.shapeDef.edgePoint`——shape 未实现（如自定义 shape）抛"does not support side anchors"；
+ *   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断，见 alpha.6 ADR-01 决策细节 #10）。
+ *   缓存 key = `${side}:${t}`，与命名 anchor（`'north'` / `'30'`）共用 layout 的 Map——key 含 `:` 故命名空间不冲突。
+ * @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
+ * @returns 全局坐标系下的 IRPosition `[x, y]`
+ */
+export declare const resolveEdgePoint: (layout: NodeLayout, side: Side, t: number) => IRPosition;
 //# sourceMappingURL=anchor-cache.d.ts.map

package/dist/es/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;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA4BzC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,UAAU,EAClB,YAAY,MAAM,KACjB,UAWF,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,mBAAmB,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AA4BzC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,UAAU,EAClB,YAAY,MAAM,KACjB,UAWF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,UAAU,EAClB,MAAM,IAAI,EACV,GAAG,MAAM,KACR,UAuBF,CAAC"}

package/dist/es/compile/anchor-cache.js

@@ -37,5 +37,29 @@ var resolveAnchor = (layout, anchorName) => {
 	layoutCache.set(anchorName, result);
 	return result;
 };
+/**
+* 取节点边上比例点 `{ side, t }` 的全局坐标，带 per-layout 缓存
+* @description 走 `layout.shapeDef.edgePoint`——shape 未实现（如自定义 shape）抛"does not support side anchors"；
+*   零尺寸 layout（Coordinate）抛错（边上比例点对一个点无意义，报错比退化中心更可诊断，见 alpha.6 ADR-01 决策细节 #10）。
+*   缓存 key = `${side}:${t}`，与命名 anchor（`'north'` / `'30'`）共用 layout 的 Map——key 含 `:` 故命名空间不冲突。
+* @param layout 已 Pass 1 完成的 NodeLayout（rect 已是全局坐标）
+* @returns 全局坐标系下的 IRPosition `[x, y]`
+*/
+var resolveEdgePoint = (layout, side, t) => {
+	const { edgePoint } = layout.shapeDef;
+	if (!edgePoint) throw new Error(`shape '${layout.shapeName}' does not support side anchors ({ side, t })`);
+	if (layout.rect.width === 0 && layout.rect.height === 0) throw new Error(`{ side, t } is not meaningful on a zero-size Coordinate (shape '${layout.shapeName}')`);
+	let layoutCache = cache.get(layout);
+	if (!layoutCache) {
+		layoutCache = /* @__PURE__ */ new Map();
+		cache.set(layout, layoutCache);
+	}
+	const key = `${side}:${t}`;
+	const cached = layoutCache.get(key);
+	if (cached !== void 0) return cached;
+	const result = positionToIR(edgePoint(layout.rect, side, t));
+	layoutCache.set(key, result);
+	return result;
+};
 //#endregion
-export { resolveAnchor };
+export { resolveAnchor, resolveEdgePoint };

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

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAwC,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAa,KAAK,EAA6B,MAAM,cAAc,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAoBjD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA4CrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C,CAAC;AA6FF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KA4RrE,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAwC,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAa,KAAK,EAA6B,MAAM,cAAc,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAqBjD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA4CrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C,CAAC;AA6FF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KAoSrE,CAAC"}

package/dist/es/compile/compile.js

@@ -3,7 +3,8 @@ import { BUILTIN_SHAPES } from "../shapes/index.js";
 import { NameStack } from "./name-stack.js";
 import { applyTransformChain, computeScopeBoundingBox, lowerScopeTransforms, projectLayoutToGlobal, registerScopeAsLayout } from "./scope.js";
 import { resolvePosition } from "./position.js";
-import { emitNodePrimitives, layoutNode } from "./node.js";
+import { emitNodePrimitives, labelExtentPoints, layoutNode } from "./node.js";
+import { createPaintRegistry } from "./paint.js";
 import { fallbackMeasurer } from "./text-metrics.js";
 import { emitPathPrimitive } from "./path/index.js";
 import { makeRound } from "./precision.js";
@@ -133,6 +134,7 @@ var compileToScene = (ir, options = {}) => {
 	};
 	const nameStack = new NameStack({ onDuplicate: (info) => onWarn(formatDuplicateWarning(info)) });
 	const allPoints = [];
+	const paint = createPaintRegistry();
 	/**
 	* 解析一批本层收集的 pending paths（lookup-only 阶段）
 	* @description 两种落点：有 `slot`（scopeChain 为空）→ 原位 splice 回填该 path 在本层 sink 占的位（按引用定位免索引漂移），保住与同层 node 的 IR 声明序；无 `slot`（scopeChain 非空）→ hoist 到顶层 `primitives`，因端点已是全局坐标、进 transformed GroupPrim 会被 scope.transform 二次 apply。NameStack 切到 pass2 守门：path 解析中误调 register 抛 internal error；解析完切回 pass1 让上层 scope 子树继续 register 子节点。
@@ -147,7 +149,8 @@ var compileToScene = (ir, options = {}) => {
 				const result = emitPathPrimitive(item.path, nameStack, round, measureText, {
 					onWarn,
 					irPath: item.irPath,
-					scopeChain: item.scopeChain
+					scopeChain: item.scopeChain,
+					resolveFill: paint.resolve
 				});
 				if (item.slot) {
 					const idx = item.slot.sink.indexOf(item.slot.placeholder);
@@ -184,11 +187,12 @@ var compileToScene = (ir, options = {}) => {
 				const layout = layoutNode(resolveNodeStyle(child, styleStack), measureText, nameStack, nodeDistance, chain, resolveLabelDefault(styleStack), effectiveShapes);
 				const globalLayout = chain.length === 0 ? layout : projectLayoutToGlobal(layout, chain);
 				if (child.id) nameStack.register(child.id, globalLayout, `${locatorPrefix}children[${i}].node.id`);
-				for (const prim of emitNodePrimitives(layout, round)) {
+				for (const prim of emitNodePrimitives(layout, round, paint.resolve)) {
 					sink.push(prim);
 					if (child.zIndex !== void 0) zIndexOf.set(prim, child.zIndex);
 				}
 				allPoints.push(rect.anchor(globalLayout.rect, "north-west"), rect.anchor(globalLayout.rect, "north-east"), rect.anchor(globalLayout.rect, "south-west"), rect.anchor(globalLayout.rect, "south-east"));
+				for (const p of labelExtentPoints(globalLayout)) allPoints.push(p);
 				layoutsAccumulator.push(globalLayout);
 			} else if (child.type === "coordinate") {
 				const localCenter = resolvePosition(child.position, nameStack, nodeDistance, chain);
@@ -272,9 +276,11 @@ var compileToScene = (ir, options = {}) => {
 		const detail = typeof process !== "undefined" && process.env.NODE_ENV !== "production" ? ` at ${collectPlaceholderLocators(primitives).join(", ")}` : "";
 		throw new Error(`internal: ${placeholderBalance} unresolved path placeholder(s) leaked into Scene output${detail}`);
 	}
+	const resources = paint.resources();
 	return {
 		primitives: stableSortByZIndex(sealSink(primitives)),
-		layout: computeLayout(allPoints, layoutPadding, round)
+		layout: computeLayout(allPoints, layoutPadding, round),
+		...resources.length > 0 ? { resources } : {}
 	};
 };
 //#endregion

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

@@ -1,6 +1,5 @@
 export * from './compile';
 export * from './node';
-export * from './parseTarget';
 export * from './path/index';
 export * from './position';
 export * from './precision';

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,eAAe,CAAC;AAC9B,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,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"}

package/dist/es/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/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

@@ -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),
@@ -341,4 +471,4 @@ var emitNodePrimitives = (layout, round) => {
 	return [group];
 };
 //#endregion
-export { anchorOf, angleBoundaryOf, boundaryPointOf, emitNodePrimitives, layoutNode };
+export { anchorOf, angleBoundaryOf, boundaryPointOf, emitNodePrimitives, labelExtentPoints, layoutNode };

package/dist/es/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/es/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/es/compile/paint.js

@@ -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
+export { createPaintRegistry };

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,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/es/compile/path/anchor.js

@@ -1,9 +1,18 @@
 import { applyTransformChain } from "../scope.js";
 import { resolvePosition } from "../position.js";
 import { boundaryPointOf } from "../node.js";
-import { resolveAnchor } from "../anchor-cache.js";
-import { parseNodeRef } from "../parseTarget.js";
+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;
+/** 解析 NodeTarget 的 anchor（非 undefined）到世界坐标：命名 / 角度走 resolveAnchor，`{ side, t }` 走 resolveEdgePoint */
+var resolveAnchorRef = (node, anchor) => {
+	if (typeof anchor === "number") return resolveAnchor(node, String(anchor));
+	if (typeof anchor === "string") return resolveAnchor(node, anchor);
+	return 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 @@ import { parseNodeRef } from "../parseTarget.js";
 *   `applyTransformChain` 投回全局。`scopeChain=[]` 等价 v0.1（恒等）。
 */
 var refPointOfTarget = (target, nameStack, scopeChain = []) => {
-	if (typeof target === "string") {
-		const ref = 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 resolveAnchor(node, ref.anchor);
-			case "angle": return 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 = 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 = 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 boundaryPointOf(node, toward);
-			case "anchor": return resolveAnchor(node, ref.anchor);
-			case "angle": return resolveAnchor(node, String(ref.angle));
-		}
+		return addOffset(target.anchor === void 0 ? 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 = resolvePosition(target, nameStack, void 0, scopeChain);

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