@retikz/core 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/lib/compile/node.cjs

@@ -1,7 +1,4 @@
-const require_rect = require("../geometry/rect.cjs");
-const require_circle = require("../geometry/circle.cjs");
-const require_diamond = require("../geometry/diamond.cjs");
-const require_ellipse = require("../geometry/ellipse.cjs");
+const require_index = require("../shapes/index.cjs");
 const require_position = require("./position.cjs");
 //#region src/compile/node.ts
 var DEFAULT_FONT_SIZE = 14;
@@ -10,7 +7,6 @@ var DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
 var DEG_TO_RAD = Math.PI / 180;
 /** Node label 与 node 边界默认距离（TikZ 默认 0pt 视觉太贴） */
 var DEFAULT_LABEL_DISTANCE = 12;
-var SQRT2 = Math.SQRT2;
 /** dashed 预设：4 px 实线 + 2 px 间隙循环 */
 var DASHED_PATTERN = [4, 2];
 /** dotted 预设：1 px 圆点 + 2 px 间隙 */
@@ -23,61 +19,28 @@ var resolveDashArray = (dashArray, dashed, dotted) => {
 };
 /** IR align → 文字对齐锚点（start / middle / end） */
 var alignToTextAnchor = (a) => a === "left" ? "start" : a === "right" ? "end" : "middle";
-/** 从 layout 构造 Rect（带 margin 扩张） */
-var rectOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	width: layout.rect.width + 2 * marginAdd,
-	height: layout.rect.height + 2 * marginAdd,
-	rotate: layout.rect.rotate
-});
-/** 从 layout 构造 Circle（radius=外接框边长/2 + margin） */
-var circleOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	radius: layout.rect.width / 2 + marginAdd,
-	rotate: layout.rect.rotate
-});
-/** 从 layout 构造 Ellipse（rx/ry 各加 margin） */
-var ellipseOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	rx: layout.rect.width / 2 + marginAdd,
-	ry: layout.rect.height / 2 + marginAdd,
-	rotate: layout.rect.rotate
-});
-/** 从 layout 构造 Diamond（halfA/halfB 各加 margin） */
-var diamondOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	halfA: layout.rect.width / 2 + marginAdd,
-	halfB: layout.rect.height / 2 + marginAdd,
-	rotate: layout.rect.rotate
-});
+/** 把 Rect 各方向外扩 m（margin generic：所有 shape 都 w+2m, h+2m，由 boundaryPointOf 调用前膨胀） */
+var inflateRect = (r, m) => m === 0 ? r : {
+	x: r.x,
+	y: r.y,
+	width: r.width + 2 * m,
+	height: r.height + 2 * m,
+	rotate: r.rotate
+};
 /**
 * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
-* @description 按 shape 多态调用各自 boundaryPoint；margin > 0 时形状先外扩，让 path 在 border 外停 margin
+* @description 走 shapeDef.boundaryPoint；margin > 0 时先膨胀外接 Rect，让 path 在 border 外停 margin
 */
-var boundaryPointOf = (layout, toward) => {
-	const m = layout.margin;
-	switch (layout.shape) {
-		case "rectangle": return require_rect.rect.boundaryPoint(rectOf(layout, m), toward);
-		case "circle": return require_circle.circle.boundaryPoint(circleOf(layout, m), toward);
-		case "ellipse": return require_ellipse.ellipse.boundaryPoint(ellipseOf(layout, m), toward);
-		case "diamond": return require_diamond.diamond.boundaryPoint(diamondOf(layout, m), toward);
-	}
-};
+var boundaryPointOf = (layout, toward) => layout.shapeDef.boundaryPoint(inflateRect(layout.rect, layout.margin), toward);
 /**
-* 取节点 shape 命名 anchor（center / north / east / north-east 等 9 个）
-* @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点
+* 取节点 shape 命名 anchor（center / north / east / north-east 等）
+* @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点。
+*   shapeDef.anchor 不认识的名字返回 undefined，此处抛 Unknown anchor（列出 shape 名）
 */
 var anchorOf = (layout, name) => {
-	switch (layout.shape) {
-		case "rectangle": return require_rect.rect.anchor(rectOf(layout, 0), name);
-		case "circle": return require_circle.circle.anchor(circleOf(layout, 0), name);
-		case "ellipse": return require_ellipse.ellipse.anchor(ellipseOf(layout, 0), name);
-		case "diamond": return require_diamond.diamond.anchor(diamondOf(layout, 0), name);
-	}
+	const p = layout.shapeDef.anchor(layout.rect, name);
+	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 = {
@@ -115,19 +78,51 @@ var LABEL_DIRECTION_MAP = {
 	}
 };
 /**
-* 算 label 中心点
-* @description 8 方向：节点对应 anchor 出发按单位向量 × distance 外推；数字角度：先取 angleBoundary 边界点再沿 (cos,sin) × distance 外推
+* 算 label 中心点（节点局部坐标系，未旋转）
+* @description 8 方向：节点对应 anchor 出发按单位向量 × distance 外推；数字角度：先取 angleBoundary 边界点再沿 (cos,sin) × distance 外推。
+*   两个分支都在 **axis-aligned rect（rotate=0）** 上算——node 自身 rotate 由外层 GroupPrim 统一施加；
+*   若用带 rotate 的 rect，label 位置会被 anchorOf / angleBoundaryOf 旋转一次、再被外层 group 旋转一次（双重旋转）。
+*   anchorOf / angleBoundaryOf 本身不改（path anchor `'A.north'` / `'A.30'` 仍需带 rotate 的 rect）。
 */
 var labelCenter = (layout, label) => {
+	const aaLayout = {
+		...layout,
+		rect: {
+			...layout.rect,
+			rotate: 0
+		}
+	};
 	if (typeof label.position === "number") {
 		const rad = label.position * Math.PI / 180;
-		const [bx, by] = angleBoundaryOf(layout, label.position);
+		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(layout, anchor);
+	const [bx, by] = anchorOf(aaLayout, anchor);
 	return [bx + vec[0] * label.distance, by + vec[1] * label.distance];
 };
+/** 角度换算常量（弧度 → 度） */
+var RAD_TO_DEG = 180 / Math.PI;
+/**
+* 算 label 文本自旋角度（度，屏幕 y-down，节点局部系）
+* @description radial = atan2(label中心 − node中心)；tangent = radial + 90；number = 原值；none / 缺省 = 0。
+*   keepUpright 时把"偏离正立 > 90°"的角度翻 180° 保阅读方向。方向向量在局部坐标算，node 自身 rotate 由外层 group 叠加。
+*/
+var resolveLabelRotateDeg = (label, lx, ly, cx, cy) => {
+	const mode = label.rotate;
+	if (mode === void 0 || mode === "none") return 0;
+	let deg;
+	if (typeof mode === "number") deg = mode;
+	else {
+		const radial = Math.atan2(ly - cy, lx - cx) * RAD_TO_DEG;
+		deg = mode === "tangent" ? radial + 90 : radial;
+	}
+	if (label.keepUpright) {
+		const norm = (deg % 360 + 360) % 360;
+		if (norm > 90 && norm < 270) deg += 180;
+	}
+	return deg;
+};
 /**
 * 取节点 shape 在指定角度方向的边界点
 * @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。不应用 margin（同 anchorOf）；用于 `'A.30'` 落点
@@ -140,12 +135,7 @@ var angleBoundaryOf = (layout, angleDeg) => {
 	const cosR = Math.cos(rot);
 	const sinR = Math.sin(rot);
 	const toward = [layout.rect.x + lx * cosR - ly * sinR, layout.rect.y + lx * sinR + ly * cosR];
-	switch (layout.shape) {
-		case "rectangle": return require_rect.rect.boundaryPoint(rectOf(layout, 0), toward);
-		case "circle": return require_circle.circle.boundaryPoint(circleOf(layout, 0), toward);
-		case "ellipse": return require_ellipse.ellipse.boundaryPoint(ellipseOf(layout, 0), toward);
-		case "diamond": return require_diamond.diamond.boundaryPoint(diamondOf(layout, 0), toward);
-	}
+	return layout.shapeDef.boundaryPoint(layout.rect, toward);
 };
 /**
 * IR Node → 内部 NodeLayout
@@ -154,7 +144,10 @@ var angleBoundaryOf = (layout, angleDeg) => {
 *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
 *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
 */
-var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], labelDefault) => {
+var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], labelDefault, shapes = require_index.BUILTIN_SHAPES) => {
+	const shapeName = node.shape ?? "rectangle";
+	const shapeDef = Object.prototype.hasOwnProperty.call(shapes, shapeName) ? shapes[shapeName] : void 0;
+	if (!shapeDef) throw new Error(`Unknown shape '${shapeName}'; registered shapes: ${Object.keys(shapes).sort().join(", ")}`);
 	const sx = node.xScale ?? node.scale ?? 1;
 	const sy = node.yScale ?? node.scale ?? 1;
 	const fontScale = Math.min(sx, sy);
@@ -201,29 +194,7 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 	const minH = node.minimumHeight ?? node.minimumSize ?? 0;
 	const innerHalfW = Math.max(textWidth / 2 + xSep, xSep, minW / 2);
 	const innerHalfH = Math.max(textHeight / 2 + ySep, ySep, minH / 2);
-	const shape = node.shape ?? "rectangle";
-	let boundsHalfW;
-	let boundsHalfH;
-	switch (shape) {
-		case "rectangle":
-			boundsHalfW = innerHalfW;
-			boundsHalfH = innerHalfH;
-			break;
-		case "circle": {
-			const r = Math.sqrt(innerHalfW * innerHalfW + innerHalfH * innerHalfH);
-			boundsHalfW = r;
-			boundsHalfH = r;
-			break;
-		}
-		case "ellipse":
-			boundsHalfW = innerHalfW * SQRT2;
-			boundsHalfH = innerHalfH * SQRT2;
-			break;
-		case "diamond":
-			boundsHalfW = innerHalfW * 2;
-			boundsHalfH = innerHalfH * 2;
-			break;
-	}
+	const { halfWidth: boundsHalfW, halfHeight: boundsHalfH } = shapeDef.circumscribe(innerHalfW, innerHalfH);
 	const rotateDeg = node.rotate ?? 0;
 	const center = require_position.resolvePosition(node.position, nameStack, nodeDistance, scopeChain);
 	if (!center) throw new Error(`Cannot resolve position for node ${node.id ?? "(unnamed)"}; polar.origin or at.of may reference an undefined node`);
@@ -238,12 +209,15 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 			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
+			fontStyle: labFont?.style ?? labelDefault?.font?.style ?? fontStyle,
+			rotate: lab.rotate,
+			keepUpright: lab.keepUpright
 		};
 	});
 	return {
 		id: node.id,
-		shape,
+		shapeName,
+		shapeDef,
 		rect: {
 			x: center[0],
 			y: center[1],
@@ -274,97 +248,28 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 		labels
 	};
 };
-/** rectangle → RectPrim */
-var emitRectShape = (layout, round) => {
-	const halfW = layout.rect.width / 2;
-	const halfH = layout.rect.height / 2;
-	return {
-		type: "rect",
-		x: round(layout.rect.x - halfW),
-		y: round(layout.rect.y - halfH),
-		width: round(layout.rect.width),
-		height: round(layout.rect.height),
-		fill: layout.fill ?? "transparent",
-		fillOpacity: layout.fillOpacity,
-		stroke: layout.stroke ?? "currentColor",
-		strokeOpacity: layout.strokeOpacity,
-		strokeWidth: layout.strokeWidth ?? 1,
-		dashPattern: layout.dashPattern,
-		cornerRadius: layout.roundedCorners,
-		opacity: layout.opacity
-	};
-};
-/** circle/ellipse → EllipsePrim（圆形 rx=ry） */
-var emitEllipseShape = (layout, round) => ({
-	type: "ellipse",
-	cx: round(layout.rect.x),
-	cy: round(layout.rect.y),
-	rx: round(layout.rect.width / 2),
-	ry: round(layout.rect.height / 2),
-	fill: layout.fill ?? "transparent",
+/** 从 NodeLayout 收敛 emit 所需的视觉样式子集（ShapeStyle，不含几何 / 文本） */
+var toShapeStyle = (layout) => ({
+	fill: layout.fill,
 	fillOpacity: layout.fillOpacity,
-	stroke: layout.stroke ?? "currentColor",
+	stroke: layout.stroke,
 	strokeOpacity: layout.strokeOpacity,
-	strokeWidth: layout.strokeWidth ?? 1,
+	strokeWidth: layout.strokeWidth,
 	dashPattern: layout.dashPattern,
+	roundedCorners: layout.roundedCorners,
 	opacity: layout.opacity
 });
-/** diamond → PathPrim（4 顶点 + close 闭合） */
-var emitDiamondShape = (layout, round) => {
-	const diam = diamondOf(layout, 0);
-	const e = require_diamond.diamond.anchor(diam, "east");
-	const n = require_diamond.diamond.anchor(diam, "north");
-	const w = require_diamond.diamond.anchor(diam, "west");
-	const s = require_diamond.diamond.anchor(diam, "south");
-	return {
-		type: "path",
-		commands: [
-			{
-				kind: "move",
-				to: [round(e[0]), round(e[1])]
-			},
-			{
-				kind: "line",
-				to: [round(n[0]), round(n[1])]
-			},
-			{
-				kind: "line",
-				to: [round(w[0]), round(w[1])]
-			},
-			{
-				kind: "line",
-				to: [round(s[0]), round(s[1])]
-			},
-			{ kind: "close" }
-		],
-		fill: layout.fill ?? "transparent",
-		fillOpacity: layout.fillOpacity,
-		stroke: layout.stroke ?? "currentColor",
-		strokeOpacity: layout.strokeOpacity,
-		strokeWidth: layout.strokeWidth ?? 1,
-		dashPattern: layout.dashPattern,
-		opacity: layout.opacity
-	};
-};
 /**
 * NodeLayout → Scene primitives
-* @description shape 主体按 shape 分发（rect/ellipse/path）；text 始终走 TextPrim；有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹（text 必须靠 group 旋转）
+* @description shape 主体走 `shapeDef.emit`（收轴对齐 rect、可出多 primitive）；text 始终走 TextPrim；
+*   有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹 shape + text（diamond 顶点 / text 都靠 group 旋转）
 */
 var emitNodePrimitives = (layout, round) => {
-	let shapePrim;
-	switch (layout.shape) {
-		case "rectangle":
-			shapePrim = emitRectShape(layout, round);
-			break;
-		case "circle":
-		case "ellipse":
-			shapePrim = emitEllipseShape(layout, round);
-			break;
-		case "diamond":
-			shapePrim = emitDiamondShape(unrotated(layout), round);
-			break;
-	}
-	const inner = [shapePrim];
+	const axisAlignedRect = {
+		...layout.rect,
+		rotate: 0
+	};
+	const inner = [...layout.shapeDef.emit(axisAlignedRect, toShapeStyle(layout), round)];
 	if (layout.lines) {
 		const halfBlockW = layout.textWidth / 2;
 		const xOffset = layout.align === "start" ? -halfBlockW : layout.align === "end" ? halfBlockW : 0;
@@ -386,46 +291,55 @@ var emitNodePrimitives = (layout, round) => {
 			measuredHeight: round(layout.textHeight)
 		});
 	}
-	if (layout.labels) for (const lab of layout.labels) {
-		const [lx, ly] = labelCenter(layout, lab);
-		inner.push({
-			type: "text",
-			x: round(lx),
-			y: round(ly),
-			lines: [{ text: lab.text }],
-			fontSize: lab.fontSize,
-			fontFamily: lab.fontFamily,
-			fontWeight: lab.fontWeight,
-			fontStyle: lab.fontStyle,
-			align: "middle",
-			baseline: "middle",
-			lineHeight: round(lab.fontSize * DEFAULT_LINE_HEIGHT_FACTOR),
-			fill: lab.textColor ?? "currentColor",
-			opacity: lab.opacity ?? layout.opacity,
-			measuredWidth: 0,
-			measuredHeight: round(lab.fontSize)
-		});
+	if (layout.labels) {
+		const cx = layout.rect.x;
+		const cy = layout.rect.y;
+		for (const lab of layout.labels) {
+			const [lx, ly] = labelCenter(layout, lab);
+			const textPrim = {
+				type: "text",
+				x: round(lx),
+				y: round(ly),
+				lines: [{ text: lab.text }],
+				fontSize: lab.fontSize,
+				fontFamily: lab.fontFamily,
+				fontWeight: lab.fontWeight,
+				fontStyle: lab.fontStyle,
+				align: "middle",
+				baseline: "middle",
+				lineHeight: round(lab.fontSize * DEFAULT_LINE_HEIGHT_FACTOR),
+				fill: lab.textColor ?? "currentColor",
+				opacity: lab.opacity ?? layout.opacity,
+				measuredWidth: 0,
+				measuredHeight: round(lab.fontSize)
+			};
+			const deg = resolveLabelRotateDeg(lab, lx, ly, cx, cy);
+			if (deg === 0) inner.push(textPrim);
+			else inner.push({
+				type: "group",
+				transforms: [{
+					kind: "rotate",
+					degrees: round(deg),
+					cx: round(lx),
+					cy: round(ly)
+				}],
+				children: [textPrim]
+			});
+		}
 	}
-	if (layout.rotateDeg === 0) return inner;
-	return [{
+	if (!(layout.rotateDeg !== 0 || layout.lines !== void 0)) return inner;
+	const group = {
 		type: "group",
-		transforms: [{
-			kind: "rotate",
-			degrees: round(layout.rotateDeg),
-			cx: round(layout.rect.x),
-			cy: round(layout.rect.y)
-		}],
 		children: inner
+	};
+	if (layout.rotateDeg !== 0) group.transforms = [{
+		kind: "rotate",
+		degrees: round(layout.rotateDeg),
+		cx: round(layout.rect.x),
+		cy: round(layout.rect.y)
 	}];
+	return [group];
 };
-/** layout 的"未旋转"副本，让 diamond 顶点先按未旋转算，外层 group 统一旋转 */
-var unrotated = (layout) => ({
-	...layout,
-	rect: {
-		...layout.rect,
-		rotate: 0
-	}
-});
 //#endregion
 exports.anchorOf = anchorOf;
 exports.angleBoundaryOf = angleBoundaryOf;

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

@@ -1,14 +1,17 @@
 import { Position } from '../geometry/point';
-import { Rect, RectAnchor } from '../geometry/rect';
-import { AtDirection, IRLabelDefault, IRNode, NodeShape } from '../ir';
+import { Rect } from '../geometry/rect';
+import { AtDirection, IRLabelDefault, IRNode } from '../ir';
 import { ScenePrimitive, TextLine, Transform } from '../primitive';
+import { ShapeDefinition } from '../shapes';
 import { NameStack } from './name-stack';
 import { TextMeasurer } from './text-metrics';
 export type NodeLayout = {
     /** 节点 id（其他位置可引用） */
     id?: string;
-    /** 节点形状，所有几何 / boundaryPoint 按 shape 多态 */
-    shape: NodeShape;
+    /** 节点形状名（诊断 / 错误信息用；几何走 shapeDef） */
+    shapeName: string;
+    /** 已解析的 shape 定义；circumscribe / boundaryPoint / anchor / emit 多点复用，取代旧 switch */
+    shapeDef: ShapeDefinition;
     /**
      * 节点视觉边界框（所有 shape 共享语义）
      * @description rectangle: rect 本身；circle: width=height=2×radius；ellipse: 2×rx,2×ry；diamond: 2×halfA,2×halfB。x,y 是几何中心，rotate 弧度
@@ -76,17 +79,22 @@ export type NodeLabelLayout = {
     fontFamily?: string;
     fontWeight?: string | number;
     fontStyle?: 'normal' | 'italic' | 'oblique';
+    /** label 文本自旋模式（none / radial / tangent / 数字角度）；缺省 = 不旋转 */
+    rotate?: 'none' | 'radial' | 'tangent' | number;
+    /** 自旋后若文字倒置则翻 180°；缺省 false */
+    keepUpright?: boolean;
 };
 /**
  * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
- * @description 按 shape 多态调用各自 boundaryPoint；margin > 0 时形状先外扩，让 path 在 border 外停 margin
+ * @description 走 shapeDef.boundaryPoint；margin > 0 时先膨胀外接 Rect，让 path 在 border 外停 margin
  */
 export declare const boundaryPointOf: (layout: NodeLayout, toward: Position) => Position;
 /**
- * 取节点 shape 命名 anchor（center / north / east / north-east 等 9 个）
- * @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点
+ * 取节点 shape 命名 anchor（center / north / east / north-east 等）
+ * @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点。
+ *   shapeDef.anchor 不认识的名字返回 undefined，此处抛 Unknown anchor（列出 shape 名）
  */
-export declare const anchorOf: (layout: NodeLayout, name: RectAnchor) => Position;
+export declare const anchorOf: (layout: NodeLayout, name: string) => Position;
 /**
  * 取节点 shape 在指定角度方向的边界点
  * @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。不应用 margin（同 anchorOf）；用于 `'A.30'` 落点
@@ -99,10 +107,11 @@ export declare const angleBoundaryOf: (layout: NodeLayout, angleDeg: number) =>
  *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
  *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
  */
-export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault) => NodeLayout;
+export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault, shapes?: Record<string, ShapeDefinition>) => NodeLayout;
 /**
  * NodeLayout → Scene primitives
- * @description shape 主体按 shape 分发（rect/ellipse/path）；text 始终走 TextPrim；有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹（text 必须靠 group 旋转）
+ * @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>;
 //# 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/scope.cjs

@@ -1,4 +1,5 @@
 const require_rect = require("../geometry/rect.cjs");
+const require_index = require("../shapes/index.cjs");
 const require_position = require("./position.cjs");
 //#region src/compile/scope.ts
 /**
@@ -235,7 +236,8 @@ var registerScopeAsLayout = (id, bbox, fallbackOrigin) => {
 	};
 	return {
 		id,
-		shape: "rectangle",
+		shapeName: "rectangle",
+		shapeDef: require_index.BUILTIN_SHAPES.rectangle,
 		rect: {
 			x: box.x,
 			y: box.y,

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

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/compile/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EAEZ,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,aAAa,CAAC,WAAW,CAAC,EACtC,WAAW,SAAS,EACpB,eAAe,MAAM,KACpB,KAAK,CAAC,SAAS,CAAC,GAAG,IAiDrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EACjB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAyBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAuBF,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,UAAU,CAAC,KACjC,gBAAgB,GAAG,IA2BrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,MAAM,gBAAgB,GAAG,IAAI,EAC7B,gBAAgB,UAAU,KACzB,UAeF,CAAC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/compile/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EAEZ,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,aAAa,CAAC,WAAW,CAAC,EACtC,WAAW,SAAS,EACpB,eAAe,MAAM,KACpB,KAAK,CAAC,SAAS,CAAC,GAAG,IAiDrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EACjB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAyBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAuBF,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,UAAU,CAAC,KACjC,gBAAgB,GAAG,IA2BrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,MAAM,gBAAgB,GAAG,IAAI,EAC7B,gBAAgB,UAAU,KACzB,UAgBF,CAAC"}

package/dist/lib/index.cjs

@@ -14,10 +14,12 @@ const require_coordinate = require("./ir/coordinate.cjs");
 const require_transform = require("./ir/transform.cjs");
 const require_scope = require("./ir/scope.cjs");
 const require_scene = require("./ir/scene.cjs");
+const require__transform = require("./geometry/_transform.cjs");
 const require_rect = require("./geometry/rect.cjs");
 const require_circle = require("./geometry/circle.cjs");
-const require_diamond = require("./geometry/diamond.cjs");
 const require_ellipse = require("./geometry/ellipse.cjs");
+const require_diamond = require("./geometry/diamond.cjs");
+const require_index = require("./shapes/index.cjs");
 const require_text_metrics = require("./compile/text-metrics.cjs");
 const require_layout = require("./compile/layout.cjs");
 const require_compile = require("./compile/compile.cjs");
@@ -34,6 +36,7 @@ exports.ArrowDefaultSchema = require_scope.ArrowDefaultSchema;
 exports.ArrowDetailSchema = require_arrow.ArrowDetailSchema;
 exports.ArrowEndDetailSchema = require_arrow.ArrowEndDetailSchema;
 exports.AtPositionSchema = require_at_position.AtPositionSchema;
+exports.BUILTIN_SHAPES = require_index.BUILTIN_SHAPES;
 exports.BendStepSchema = require_step.BendStepSchema;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
 exports.ChildSchema = require_scene.ChildSchema;
@@ -79,8 +82,10 @@ exports.computeLayout = require_layout.computeLayout;
 exports.diamond = require_diamond.diamond;
 exports.ellipse = require_ellipse.ellipse;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;
+exports.localToWorld = require__transform.localToWorld;
 exports.parseTargetSugar = require_parseTargetSugar.parseTargetSugar;
 exports.parseWay = require_parseWay.parseWay;
 exports.point = require_point.point;
 exports.polar = require_polar.polar;
 exports.rect = require_rect.rect;
+exports.worldToLocal = require__transform.worldToLocal;

package/dist/lib/index.d.ts

@@ -3,7 +3,7 @@
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
 export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, NodeTextAlign, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, } from './ir';
 export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, } from './ir';
 export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
@@ -16,5 +16,7 @@ export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayL
 export { parseWay, DrawWay, parseTargetSugar } from './parsers';
 export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
+export type { ShapeDefinition, ShapeStyle } from './shapes';
+export { BUILTIN_SHAPES, worldToLocal, localToWorld } from './shapes';
 export type { ValueOf, AssertEqual } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,EAAE,EACF,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,WAAW,EACX,gBAAgB,GACjB,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW;AACX,oDAAoD;AACpD,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,SAAS;AACT,6BAA6B;AAC7B,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,MAAM,EACN,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5E,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIhE,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/ir/node.cjs

@@ -32,12 +32,18 @@ var NodeLabelSchema = zod.z.object({
 	distance: zod.z.number().nonnegative().optional().describe("Gap between the node border and the label center, in user units. Default 12."),
 	textColor: zod.z.string().optional().describe("Label text color; falls back to currentColor."),
 	opacity: zod.z.number().min(0).max(1).optional().describe("Label-only opacity 0..1; multiplied with the node opacity if both are set."),
-	font: require_font.FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults.")
+	font: require_font.FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults."),
+	rotate: zod.z.union([zod.z.enum([
+		"none",
+		"radial",
+		"tangent"
+	]), zod.z.number()]).optional().describe("Rotate the label text around its own center. `none` (default) = horizontal; `radial` = along the node-center -> label-center direction; `tangent` = radial + 90 deg; a number = explicit degrees (screen y-down: 0 = +x, 90 = +y). Only changes text orientation, not placement."),
+	keepUpright: zod.z.boolean().optional().describe("When true, flips the rotated label 180 deg if it would otherwise read upside-down (more than 90 deg from upright). Default false (strict geometric angle).")
 }).describe("Extra text attached around a node border. Multiple labels supported via array form on `Node.label`.");
 var NodeSchema = zod.z.object({
 	type: zod.z.literal("node").describe("Discriminator marking this child as a node"),
 	id: zod.z.string().min(1).optional().describe("Optional unique id; required if any path needs to reference this node by string"),
-	shape: zod.z.nativeEnum(NODE_SHAPES).optional().describe("Node visual shape; defaults to `rectangle`. The boundary fully contains text + padding (circumscribed for circle / ellipse / diamond)."),
+	shape: zod.z.string().min(1).optional().describe("Node visual shape name; built-in `rectangle` / `circle` / `ellipse` / `diamond`, or an extension shape registered via `CompileOptions.shapes`. Any non-empty string passes schema validation; unregistered names are rejected at compile time. Defaults to `rectangle`. The boundary fully contains text + padding (circumscribed for circle / ellipse / diamond)."),
 	position: zod.z.union([
 		require_position.PositionSchema,
 		require_polar_position.PolarPositionSchema,
@@ -72,7 +78,8 @@ var NodeSchema = zod.z.object({
 	padding: zod.z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
 	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
 	font: require_font.FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults."),
-	label: zod.z.union([NodeLabelSchema, zod.z.array(NodeLabelSchema)]).optional().describe("Extra label(s) attached around the node border (TikZ `[label=above:foo]`); single object or array form. Compiled into one TextPrim per label, positioned by `position` direction / angle and `distance`.")
+	label: zod.z.union([NodeLabelSchema, zod.z.array(NodeLabelSchema)]).optional().describe("Extra label(s) attached around the node border (TikZ `[label=above:foo]`); single object or array form. Compiled into one TextPrim per label, positioned by `position` direction / angle and `distance`."),
+	zIndex: zod.z.number().int().finite().optional().describe("Explicit stacking order among sibling IR children. Higher draws on top. Omitted = 0 = source order. Sorting is stable: same zIndex keeps source order. Scoped per group (a node inside a scope only restacks within that scope).")
 }).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
 exports.NODE_SHAPES = NODE_SHAPES;