@retikz/core 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/es/primitive/text.d.ts

@@ -1,32 +1,62 @@
-/** 文本原语；measuredWidth/Height 由 Scene 编译阶段算好，下游直接信任 */
+/**
+ * 行级字段——`<tspan>` 上可独立指定的属性。
+ * 块级（TextPrim 顶层）属性是默认值；行级未填字段走块级默认。
+ */
+export type TextLine = {
+    /** 行内容（必填） */
+    text: string;
+    /** 行字号；未填走 TextPrim.fontSize */
+    fontSize?: number;
+    /** 行字体族；未填走 TextPrim.fontFamily */
+    fontFamily?: string;
+    /** 行字重；未填走 TextPrim.fontWeight */
+    fontWeight?: string | number;
+    /** 行字形；未填走 TextPrim.fontStyle */
+    fontStyle?: 'normal' | 'italic' | 'oblique';
+    /** 行颜色；未填走 TextPrim.fill */
+    fill?: string;
+    /** 行透明度 0~1；未填走 TextPrim.opacity */
+    opacity?: number;
+};
+/**
+ * 文本原语；measuredWidth / Height 由 Scene 编译阶段算好，下游直接信任。
+ *
+ * 多行：`lines` 至少 1 行；renderer 把每行画为 `<tspan>`，按 `lineHeight` 堆叠，
+ * 整块根据 `baseline` 在 (x, y) 锚点上下居中 / 顶 / 底对齐。
+ *
+ * 顶层 `fontSize` / `fontFamily` / `fontWeight` / `fontStyle` / `fill` / `opacity` 是默认值；
+ * 单行可在 `TextLine` 上覆盖（仅生效于该行 `<tspan>`）。
+ */
 export type TextPrim = {
     /** 类型判别符 */
     type: 'text';
-    /** 锚点横坐标（具体含义由 align 决定） */
+    /** 锚点横坐标（具体含义由 align 决定）；多行下作为每行 `<tspan>` 的 x */
     x: number;
     /** 锚点纵坐标（具体含义由 baseline 决定） */
     y: number;
-    /** 文本内容 */
-    content: string;
-    /** 字号 */
+    /** 文本行（至少 1 行）；单行节点也用 `[{ text: 'Hello' }]` 形式 */
+    lines: Array<TextLine>;
+    /** 块级默认字号 */
     fontSize: number;
-    /** 字体族 */
+    /** 块级默认字体族 */
     fontFamily?: string;
-    /** 字重 */
+    /** 块级默认字重 */
     fontWeight?: string | number;
-    /** 字形 */
-    fontStyle?: 'normal' | 'italic';
+    /** 块级默认字形 */
+    fontStyle?: 'normal' | 'italic' | 'oblique';
     /** 水平对齐：start / middle / end 锚点位置 */
     align: 'start' | 'middle' | 'end';
     /** 垂直基线对齐方式 */
     baseline: 'top' | 'middle' | 'bottom' | 'alphabetic';
-    /** 编译期算好的文字宽度（user units） */
+    /** 行高（user units）；多行下相邻 `<tspan>` 的垂直距离 */
+    lineHeight: number;
+    /** 编译期算好的整块文字宽度（user units，= max line width） */
     measuredWidth: number;
-    /** 编译期算好的文字高度（user units） */
+    /** 编译期算好的整块文字高度（user units，≈ lines × lineHeight） */
     measuredHeight: number;
-    /** 文字颜色 */
+    /** 块级默认文字颜色 */
     fill?: string;
-    /** 整体透明度 0~1 */
+    /** 块级默认透明度 0~1 */
     opacity?: number;
 };
 //# sourceMappingURL=text.d.ts.map

package/dist/es/primitive/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS;IACT,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS;IACT,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,eAAe;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,iCAAiC;IACjC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,kDAAkD;IAClD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa;IACb,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,qCAAqC;IACrC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,eAAe;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/lib/compile/node.cjs

@@ -6,8 +6,21 @@ const require_position = require("./position.cjs");
 //#region src/compile/node.ts
 var DEFAULT_FONT_SIZE = 14;
 var DEFAULT_PADDING = 8;
+var DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
 var DEG_TO_RAD = Math.PI / 180;
 var SQRT2 = Math.SQRT2;
+/** dashed 预设：SVG stroke-dasharray "4 2"——4 px 实线 + 2 px 间隙循环 */
+var DASHED_PATTERN = "4 2";
+/** dotted 预设：SVG stroke-dasharray "1 2"——1 px 圆点 + 2 px 间隙 */
+var DOTTED_PATTERN = "1 2";
+/** 解析 dashed / dotted / dashArray 优先级：dashArray > dashed > dotted */
+var resolveDashArray = (dashArray, dashed, dotted) => {
+	if (dashArray !== void 0) return dashArray;
+	if (dashed) return DASHED_PATTERN;
+	if (dotted) return DOTTED_PATTERN;
+};
+/** IR `align` ('left' | 'center' | 'right') → SVG textAnchor ('start' | 'middle' | 'end') */
+var alignToTextAnchor = (a) => a === "left" ? "start" : a === "right" ? "end" : "middle";
 /** 由 layout 构造的 Rect（带 margin 扩张） */
 var rectOf = (layout, marginAdd) => ({
 	x: layout.rect.x,
@@ -90,14 +103,52 @@ var angleBoundaryOf = (layout, angleDeg) => {
 * - 透传 margin / 样式属性
 */
 var layoutNode = (node, measureText, nodeIndex) => {
-	const fontSize = node.fontSize ?? DEFAULT_FONT_SIZE;
-	const padding = node.padding ?? DEFAULT_PADDING;
-	const metrics = node.text ? measureText(node.text, { size: fontSize }) : {
-		width: 0,
-		height: 0
-	};
-	const innerHalfW = Math.max(metrics.width / 2 + padding, padding);
-	const innerHalfH = Math.max(metrics.height / 2 + padding, padding);
+	const sx = node.xScale ?? node.scale ?? 1;
+	const sy = node.yScale ?? node.scale ?? 1;
+	const fontScale = Math.min(sx, sy);
+	const baseFontSize = node.font?.size ?? DEFAULT_FONT_SIZE;
+	const fontSize = baseFontSize * fontScale;
+	const fontFamily = node.font?.family;
+	const fontWeight = node.font?.weight;
+	const fontStyle = node.font?.style;
+	const xSep = (node.innerXSep ?? node.padding ?? DEFAULT_PADDING) * sx;
+	const ySep = (node.innerYSep ?? node.padding ?? DEFAULT_PADDING) * sy;
+	const outerSep = (node.outerSep ?? node.margin ?? 0) * Math.max(sx, sy);
+	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;
+	let textWidth = 0;
+	let textHeight = 0;
+	let lines;
+	if (rawLines) {
+		lines = rawLines.map((spec) => {
+			const isObj = typeof spec !== "string";
+			const text = isObj ? spec.text : spec;
+			const lineFont = isObj ? spec.font : void 0;
+			const m = measureText(text, {
+				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;
+			}
+			return out;
+		});
+		textHeight = lines.length * lineHeight;
+	}
+	const minW = node.minimumWidth ?? node.minimumSize ?? 0;
+	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;
@@ -135,14 +186,25 @@ var layoutNode = (node, measureText, nodeIndex) => {
 			rotate: rotateDeg * DEG_TO_RAD
 		},
 		rotateDeg,
-		margin: node.margin ?? 0,
-		text: node.text,
-		textWidth: metrics.width,
-		textHeight: metrics.height,
+		margin: outerSep,
+		lines,
+		textWidth,
+		textHeight,
+		align,
+		lineHeight,
 		fontSize,
+		fontFamily,
+		fontWeight,
+		fontStyle,
 		fill: node.fill,
+		fillOpacity: node.fillOpacity,
 		stroke: node.stroke,
-		strokeWidth: node.strokeWidth
+		strokeOpacity: node.drawOpacity,
+		strokeWidth: node.strokeWidth,
+		strokeDasharray: resolveDashArray(node.dashArray, node.dashed, node.dotted),
+		roundedCorners: node.roundedCorners,
+		textColor: node.textColor,
+		opacity: node.opacity
 	};
 };
 /** rectangle shape 的 RectPrim */
@@ -156,8 +218,13 @@ var emitRectShape = (layout, round) => {
 		width: round(layout.rect.width),
 		height: round(layout.rect.height),
 		fill: layout.fill ?? "transparent",
+		fillOpacity: layout.fillOpacity,
 		stroke: layout.stroke ?? "currentColor",
-		strokeWidth: layout.strokeWidth ?? 1
+		strokeOpacity: layout.strokeOpacity,
+		strokeWidth: layout.strokeWidth ?? 1,
+		strokeDasharray: layout.strokeDasharray,
+		cornerRadius: layout.roundedCorners,
+		opacity: layout.opacity
 	};
 };
 /** circle / ellipse shape 的 EllipsePrim（圆形 rx=ry） */
@@ -168,8 +235,12 @@ var emitEllipseShape = (layout, round) => ({
 	rx: round(layout.rect.width / 2),
 	ry: round(layout.rect.height / 2),
 	fill: layout.fill ?? "transparent",
+	fillOpacity: layout.fillOpacity,
 	stroke: layout.stroke ?? "currentColor",
-	strokeWidth: layout.strokeWidth ?? 1
+	strokeOpacity: layout.strokeOpacity,
+	strokeWidth: layout.strokeWidth ?? 1,
+	strokeDasharray: layout.strokeDasharray,
+	opacity: layout.opacity
 });
 /** diamond shape 的 PathPrim（4 顶点 + Z 闭合） */
 var emitDiamondShape = (layout, round) => {
@@ -182,8 +253,12 @@ var emitDiamondShape = (layout, round) => {
 		type: "path",
 		d: `M ${round(e[0])} ${round(e[1])} L ${round(n[0])} ${round(n[1])} L ${round(w[0])} ${round(w[1])} L ${round(s[0])} ${round(s[1])} Z`,
 		fill: layout.fill ?? "transparent",
+		fillOpacity: layout.fillOpacity,
 		stroke: layout.stroke ?? "currentColor",
-		strokeWidth: layout.strokeWidth ?? 1
+		strokeOpacity: layout.strokeOpacity,
+		strokeWidth: layout.strokeWidth ?? 1,
+		strokeDasharray: layout.strokeDasharray,
+		opacity: layout.opacity
 	};
 };
 /**
@@ -209,18 +284,27 @@ var emitNodePrimitives = (layout, round) => {
 			break;
 	}
 	const inner = [shapePrim];
-	if (layout.text) inner.push({
-		type: "text",
-		x: round(layout.rect.x),
-		y: round(layout.rect.y),
-		content: layout.text,
-		fontSize: layout.fontSize,
-		align: "middle",
-		baseline: "middle",
-		fill: "currentColor",
-		measuredWidth: round(layout.textWidth),
-		measuredHeight: round(layout.textHeight)
-	});
+	if (layout.lines) {
+		const halfBlockW = layout.textWidth / 2;
+		const xOffset = layout.align === "start" ? -halfBlockW : layout.align === "end" ? halfBlockW : 0;
+		inner.push({
+			type: "text",
+			x: round(layout.rect.x + xOffset),
+			y: round(layout.rect.y),
+			lines: layout.lines,
+			fontSize: layout.fontSize,
+			fontFamily: layout.fontFamily,
+			fontWeight: layout.fontWeight,
+			fontStyle: layout.fontStyle,
+			align: layout.align,
+			baseline: "middle",
+			lineHeight: round(layout.lineHeight),
+			fill: layout.textColor ?? "currentColor",
+			opacity: layout.opacity,
+			measuredWidth: round(layout.textWidth),
+			measuredHeight: round(layout.textHeight)
+		});
+	}
 	if (layout.rotateDeg === 0) return inner;
 	return [{
 		type: "group",

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

@@ -1,7 +1,7 @@
 import { Position } from '../geometry/point';
 import { Rect, RectAnchor } from '../geometry/rect';
 import { IRNode, NodeShape } from '../ir';
-import { ScenePrimitive } from '../primitive';
+import { ScenePrimitive, TextLine } from '../primitive';
 import { TextMeasurer } from './text-metrics';
 export type NodeLayout = {
     /** 节点 id（如 IR Node 提供）；其他位置可通过 id 引用本节点 */
@@ -22,20 +22,46 @@ export type NodeLayout = {
     rotateDeg: number;
     /** 外边距（user units，≥ 0）；path 附着到形状外扩 margin 的虚拟边界上 */
     margin: number;
-    /** 节点文本内容；空字符串视为无文本（undefined） */
-    text?: string;
-    /** 文本宽度（user units），由 TextMeasurer 算出 */
+    /**
+     * 节点文本行；undefined 表示无文本，否则非空数组。
+     * 每行可带覆盖样式（fill / opacity / fontSize / fontFamily / fontWeight / fontStyle）；
+     * 未覆盖的字段在 emit 阶段不写出，由下游走 TextPrim 块级默认。
+     */
+    lines?: Array<TextLine>;
+    /** 文本块宽度（user units）= max(per-line measureText.width) */
     textWidth: number;
-    /** 文本高度（user units），由 TextMeasurer 算出 */
+    /** 文本块高度（user units）≈ lines × lineHeight */
     textHeight: number;
-    /** 文本字号（user units） */
+    /** 文本对齐（已映射到 SVG textAnchor 三态）；emit 时透传给 TextPrim.align */
+    align: 'start' | 'middle' | 'end';
+    /** 行高（user units），已应用默认值；emit 时透传给 TextPrim.lineHeight */
+    lineHeight: number;
+    /** 文本字号（user units），已应用默认值 */
     fontSize: number;
+    /** 字体族；CSS font-family；emit 时透传给 TextPrim */
+    fontFamily?: string;
+    /** 字重；emit 时透传给 TextPrim */
+    fontWeight?: string | number;
+    /** 字形：normal / italic / oblique；emit 时透传给 TextPrim */
+    fontStyle?: 'normal' | 'italic' | 'oblique';
     /** 节点背景色，CSS 颜色字符串；emit 时用 'transparent' 兜底 */
     fill?: string;
+    /** 节点填充透明度 0~1；透传 shape primitive */
+    fillOpacity?: number;
     /** 节点边框色，CSS 颜色字符串；emit 时用 'currentColor' 兜底 */
     stroke?: string;
+    /** 节点描边透明度 0~1；TikZ `draw opacity`，透传 shape primitive */
+    strokeOpacity?: number;
     /** 节点边框宽度（user units）；emit 时用 1 兜底 */
     strokeWidth?: number;
+    /** SVG stroke-dasharray 字符串；compile 已把 dashed / dotted 预设解析为具体 pattern */
+    strokeDasharray?: string;
+    /** rectangle shape 的圆角半径（user units）；非 rect shape 该字段无效 */
+    roundedCorners?: number;
+    /** 文字颜色；emit 时透传给 TextPrim.fill，兜底 'currentColor' */
+    textColor?: string;
+    /** 整节点透明度 0~1；emit 时同时挂 shape 与 text primitive */
+    opacity?: number;
 };
 /**
  * 取节点 shape 在 toward 方向上的"附着点"——path 端点贴边用。

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOnD,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;;;;OAQG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAsCF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,QAAQ,QAAQ,KAAG,QAYtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,EAAE,MAAM,UAAU,KAAG,QAW/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,UAAU,MAAM,KAAG,QActE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,aAAa,YAAY,EACzB,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KACjC,UAmEF,CAAC;AAyDF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,UAAU,EAClB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,KAAK,CAAC,cAAc,CAyCtB,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAc,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA8BnD,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;;;;OAQG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,sDAAsD;IACtD,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAsCF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,QAAQ,QAAQ,KAAG,QAYtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,EAAE,MAAM,UAAU,KAAG,QAW/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,UAAU,MAAM,KAAG,QActE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,aAAa,YAAY,EACzB,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KACjC,UAgJF,CAAC;AAsEF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,UAAU,EAClB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,KAAK,CAAC,cAAc,CAoDtB,CAAC"}

package/dist/lib/compile/text-metrics.d.ts

@@ -6,8 +6,8 @@ export type FontSpec = {
     size: number;
     /** 字重；可以是 'normal' / 'bold' / 100~900 数字等 */
     weight?: string | number;
-    /** 字形：normal 或 italic */
-    style?: 'normal' | 'italic';
+    /** 字形：normal / italic / oblique */
+    style?: 'normal' | 'italic' | 'oblique';
 };
 /** 文字度量结果：宽高 + 可选的基线 ascent/descent */
 export type TextMetrics = {

package/dist/lib/compile/text-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../../src/compile/text-metrics.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,yBAAyB;IACzB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAEzE,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,YAG7B,CAAC"}
+{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../../../src/compile/text-metrics.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,MAAM,QAAQ,GAAG;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,WAAW,CAAC;AAEzE,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,YAG7B,CAAC"}

package/dist/lib/index.cjs

@@ -22,10 +22,14 @@ exports.ChildSchema = require_scene.ChildSchema;
 exports.CycleStepSchema = require_step.CycleStepSchema;
 exports.DrawWay = require_parseWay.DrawWay;
 exports.FoldStepSchema = require_step.FoldStepSchema;
+exports.FontSchema = require_node.FontSchema;
+exports.LineSpecSchema = require_node.LineSpecSchema;
 exports.LineStepSchema = require_step.LineStepSchema;
 exports.MoveStepSchema = require_step.MoveStepSchema;
 exports.NODE_SHAPES = require_node.NODE_SHAPES;
+exports.NODE_TEXT_ALIGNS = require_node.NODE_TEXT_ALIGNS;
 exports.NodeSchema = require_node.NodeSchema;
+exports.NodeTextSchema = require_node.NodeTextSchema;
 exports.PathSchema = require_path.PathSchema;
 exports.PolarPositionSchema = require_polar_position.PolarPositionSchema;
 exports.PositionSchema = require_position.PositionSchema;

package/dist/lib/index.d.ts

@@ -6,10 +6,10 @@
  *
  * 本包零 React、零 DOM 依赖。
  */
-export { PositionSchema, PolarPositionSchema, TargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, StepSchema, NodeSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRStep, IRNode, IRPath, IRChild, IR, ArrowShape, NodeShape, } from './ir';
-export { ARROW_SHAPES, NODE_SHAPES } from './ir';
-export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, PathPrim, GroupPrim, ViewBox, Scene, } from './primitive';
+export { PositionSchema, PolarPositionSchema, TargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, StepSchema, NodeSchema, FontSchema, NodeTextSchema, LineSpecSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
+export type { IRPosition, IRTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRStep, IRNode, IRFont, IRLineSpec, IRPath, IRChild, IR, ArrowShape, NodeShape, NodeTextAlign, } from './ir';
+export { ARROW_SHAPES, NODE_SHAPES, NODE_TEXT_ALIGNS } from './ir';
+export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, GroupPrim, ViewBox, Scene, } from './primitive';
 export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, } from './compile';
 export { fallbackMeasurer, compileToScene } from './compile';
 export type { WayItem, WayDSL, WayCycle, WayVia } from './parsers';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,SAAS,GACV,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAGjD,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI9C,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,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,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAGnE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI9C,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,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,MAAM,SAAS,CAAC"}

package/dist/lib/ir/node.cjs

@@ -23,20 +23,90 @@ var NODE_SHAPES = {
 	ellipse: "ellipse",
 	diamond: "diamond"
 };
+/**
+* 节点字体规格——family / size / weight / style 全部可选；
+* 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
+*
+* 取代 alpha.1 的标量 `fontSize` 字段（已删）。
+*/
+var FontSchema = zod.z.object({
+	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
+	size: zod.z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
+	weight: zod.z.union([zod.z.enum(["normal", "bold"]), zod.z.number()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
+	style: zod.z.enum([
+		"normal",
+		"italic",
+		"oblique"
+	]).optional().describe("CSS font-style")
+}).describe("Font properties for the node text label; all fields optional, nested object form (replaces the alpha.1 `fontSize` scalar).");
+/**
+* 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
+*
+* 行级覆盖只生效于本行的 `<tspan>`：
+* - `fill`：仅这一行颜色
+* - `opacity`：仅这一行 0~1 透明度
+* - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
+*
+* 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
+*/
+var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
+	text: zod.z.string().describe("Line content"),
+	fill: zod.z.string().optional().describe("Per-line text color; overrides block default"),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Per-line opacity 0..1"),
+	font: FontSchema.optional().describe("Per-line font overrides; missing fields inherit from block-level `font`")
+})]).describe("Single line of text: bare string for default styling, or an object with per-line `fill` / `opacity` / `font` overrides.");
+/**
+* 节点文本——单行字符串或非空多行数组（每元素一个 LineSpec）：
+* - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
+* - `['Line 1', 'Line 2']` 两行无样式覆盖
+* - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
+*
+* 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
+*/
+var NodeTextSchema = zod.z.union([zod.z.string(), zod.z.array(LineSpecSchema).min(1)]).describe("Text label rendered inside the node: a single string for one line, or a non-empty array of line specs (string for default, object for per-line overrides).");
+/** 节点文本对齐（多行内文本对齐）——TikZ `align=` 同义词 */
+var NODE_TEXT_ALIGNS = {
+	left: "left",
+	center: "center",
+	right: "right"
+};
 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)."),
 	position: zod.z.union([require_position.PositionSchema, require_polar_position.PolarPositionSchema]).describe("Center point of the node content box; Cartesian [x, y] or polar (resolved at compile time)"),
 	rotate: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: zod.z.string().optional().describe("Text label rendered inside the node; omit for an empty node"),
+	text: NodeTextSchema.optional(),
+	align: zod.z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
+	lineHeight: zod.z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	fill: zod.z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
+	fillOpacity: zod.z.number().min(0).max(1).optional().describe("Fill opacity 0..1; affects only the shape fill, leaves stroke / text alone."),
 	stroke: zod.z.string().optional().describe("Border color of the node shape; any CSS color. Defaults to currentColor when omitted"),
+	drawOpacity: zod.z.number().min(0).max(1).optional().describe("Stroke opacity 0..1 (TikZ `draw opacity`); affects only the border."),
 	strokeWidth: zod.z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
-	padding: zod.z.number().optional().describe("Inner padding in user units between the text content and the node border"),
-	margin: zod.z.number().nonnegative().optional().describe("Outer margin in user units: distance between the visual border and where paths attach. Lines stop this far from the border. Defaults to 0."),
-	fontSize: zod.z.number().optional().describe("Text font size in user units; defaults to a fixed size for now (TikZ font sizes will be supported later)")
+	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
+	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
+	dashArray: zod.z.string().optional().describe("Explicit SVG stroke-dasharray value (e.g. \"4 2\"); overrides `dashed` / `dotted`."),
+	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape (rx / ry on `<rect>`)."),
+	minimumWidth: zod.z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
+	minimumHeight: zod.z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
+	minimumSize: zod.z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),
+	scale: zod.z.number().positive().optional().describe("Uniform scale factor; multiplies all node dimensions (border, padding, text, fontSize) at layout time. Affects path attachment positions."),
+	xScale: zod.z.number().positive().optional().describe("Horizontal scale factor; overrides `scale` for the X axis."),
+	yScale: zod.z.number().positive().optional().describe("Vertical scale factor; overrides `scale` for the Y axis."),
+	textColor: zod.z.string().optional().describe("Text label color; any CSS color. Defaults to `currentColor`."),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Whole-node opacity 0..1; applies uniformly to shape and text."),
+	innerXSep: zod.z.number().nonnegative().optional().describe("Inner horizontal padding from text to border in user units. Falls back to `padding` then default."),
+	innerYSep: zod.z.number().nonnegative().optional().describe("Inner vertical padding from text to border in user units. Falls back to `padding` then default."),
+	outerSep: zod.z.number().nonnegative().optional().describe("Outer margin from border to path attachment point in user units; does NOT change the visible border. Falls back to `margin`."),
+	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: FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults.")
 }).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
+exports.FontSchema = FontSchema;
+exports.LineSpecSchema = LineSpecSchema;
 exports.NODE_SHAPES = NODE_SHAPES;
+exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
 exports.NodeSchema = NodeSchema;
+exports.NodeTextSchema = NodeTextSchema;