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

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

@@ -6,8 +6,21 @@ import { resolvePosition } from "./position.js";
 //#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/es/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/es/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/es/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/es/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/es/index.js

@@ -4,7 +4,7 @@ import { ARROW_SHAPES } from "./ir/path/arrow.js";
 import { TargetSchema } from "./ir/path/target.js";
 import { CycleStepSchema, FoldStepSchema, LineStepSchema, MoveStepSchema, StepSchema } from "./ir/path/step.js";
 import { PathSchema } from "./ir/path/path.js";
-import { NODE_SHAPES, NodeSchema } from "./ir/node.js";
+import { FontSchema, LineSpecSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeSchema, NodeTextSchema } from "./ir/node.js";
 import { CURRENT_IR_VERSION, ChildSchema, SceneSchema } from "./ir/scene.js";
 import { RECT_ANCHORS, rect } from "./geometry/rect.js";
 import { circle } from "./geometry/circle.js";
@@ -15,4 +15,4 @@ import { compileToScene } from "./compile/compile.js";
 import { DrawWay, parseWay } from "./parsers/parseWay.js";
 import { polar } from "./geometry/polar.js";
 import { point } from "./geometry/point.js";
-export { ARROW_SHAPES, CURRENT_IR_VERSION, ChildSchema, CycleStepSchema, DrawWay, FoldStepSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NodeSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, SceneSchema, StepSchema, TargetSchema, circle, compileToScene, diamond, ellipse, fallbackMeasurer, parseWay, point, polar, rect };
+export { ARROW_SHAPES, CURRENT_IR_VERSION, ChildSchema, CycleStepSchema, DrawWay, FoldStepSchema, FontSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeSchema, NodeTextSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, SceneSchema, StepSchema, TargetSchema, circle, compileToScene, diamond, ellipse, fallbackMeasurer, parseWay, point, polar, rect };

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

@@ -23,6 +23,140 @@ export declare const NODE_SHAPES: {
 };
 /** 节点形状字面量类型，由 `NODE_SHAPES` 派生 */
 export type NodeShape = ValueOf<typeof NODE_SHAPES>;
+/**
+ * 节点字体规格——family / size / weight / style 全部可选；
+ * 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
+ *
+ * 取代 alpha.1 的标量 `fontSize` 字段（已删）。
+ */
+export declare const FontSchema: z.ZodObject<{
+    family: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+    style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+}, "strip", z.ZodTypeAny, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}>;
+/** 节点字体规格（IR 层）——所有字段可选，编译期解析默认值 */
+export type IRFont = z.infer<typeof FontSchema>;
+/**
+ * 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
+ *
+ * 行级覆盖只生效于本行的 `<tspan>`：
+ * - `fill`：仅这一行颜色
+ * - `opacity`：仅这一行 0~1 透明度
+ * - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
+ *
+ * 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
+ */
+export declare const LineSpecSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    text: z.ZodString;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}>]>;
+/** 行规格 IR 类型（string 或对象） */
+export type IRLineSpec = z.infer<typeof LineSpecSchema>;
+/**
+ * 节点文本——单行字符串或非空多行数组（每元素一个 LineSpec）：
+ * - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
+ * - `['Line 1', 'Line 2']` 两行无样式覆盖
+ * - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
+ *
+ * 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
+ */
+export declare const NodeTextSchema: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    text: z.ZodString;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}>]>, "many">]>;
+/** 节点文本对齐（多行内文本对齐）——TikZ `align=` 同义词 */
+export declare const NODE_TEXT_ALIGNS: {
+    readonly left: "left";
+    readonly center: "center";
+    readonly right: "right";
+};
+/** 多行文本对齐字面量类型 */
+export type NodeTextAlign = ValueOf<typeof NODE_TEXT_ALIGNS>;
 export declare const NodeSchema: z.ZodObject<{
     type: z.ZodLiteral<"node">;
     id: z.ZodOptional<z.ZodString>;
@@ -34,13 +168,91 @@ export declare const NodeSchema: z.ZodObject<{
     }>>;
     position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
     rotate: z.ZodOptional<z.ZodNumber>;
-    text: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        text: z.ZodString;
+        fill: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        font: z.ZodOptional<z.ZodObject<{
+            family: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodNumber>;
+            weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+            style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+        }, "strip", z.ZodTypeAny, {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        }, {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    }, {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    }>]>, "many">]>>;
+    align: z.ZodOptional<z.ZodNativeEnum<{
+        readonly left: "left";
+        readonly center: "center";
+        readonly right: "right";
+    }>>;
+    lineHeight: z.ZodOptional<z.ZodNumber>;
     fill: z.ZodOptional<z.ZodString>;
+    fillOpacity: z.ZodOptional<z.ZodNumber>;
     stroke: z.ZodOptional<z.ZodString>;
+    drawOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
+    dashed: z.ZodOptional<z.ZodBoolean>;
+    dotted: z.ZodOptional<z.ZodBoolean>;
+    dashArray: z.ZodOptional<z.ZodString>;
+    roundedCorners: z.ZodOptional<z.ZodNumber>;
+    minimumWidth: z.ZodOptional<z.ZodNumber>;
+    minimumHeight: z.ZodOptional<z.ZodNumber>;
+    minimumSize: z.ZodOptional<z.ZodNumber>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    xScale: z.ZodOptional<z.ZodNumber>;
+    yScale: z.ZodOptional<z.ZodNumber>;
+    textColor: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    innerXSep: z.ZodOptional<z.ZodNumber>;
+    innerYSep: z.ZodOptional<z.ZodNumber>;
+    outerSep: z.ZodOptional<z.ZodNumber>;
     padding: z.ZodOptional<z.ZodNumber>;
     margin: z.ZodOptional<z.ZodNumber>;
-    fontSize: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     type: "node";
     position: [number, number] | import('./position').PolarPosition;
@@ -48,12 +260,46 @@ export declare const NodeSchema: z.ZodObject<{
     shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
+    text?: string | (string | {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    })[] | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
-    text?: string | undefined;
+    align?: "left" | "center" | "right" | undefined;
+    lineHeight?: number | undefined;
+    fillOpacity?: number | undefined;
+    drawOpacity?: number | undefined;
+    dashed?: boolean | undefined;
+    dotted?: boolean | undefined;
+    dashArray?: string | undefined;
+    roundedCorners?: number | undefined;
+    minimumWidth?: number | undefined;
+    minimumHeight?: number | undefined;
+    minimumSize?: number | undefined;
+    scale?: number | undefined;
+    xScale?: number | undefined;
+    yScale?: number | undefined;
+    textColor?: string | undefined;
+    innerXSep?: number | undefined;
+    innerYSep?: number | undefined;
+    outerSep?: number | undefined;
     padding?: number | undefined;
     margin?: number | undefined;
-    fontSize?: number | undefined;
 }, {
     type: "node";
     position: [number, number] | import('./position').PolarPosition;
@@ -61,12 +307,46 @@ export declare const NodeSchema: z.ZodObject<{
     shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
+    text?: string | (string | {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    })[] | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
-    text?: string | undefined;
+    align?: "left" | "center" | "right" | undefined;
+    lineHeight?: number | undefined;
+    fillOpacity?: number | undefined;
+    drawOpacity?: number | undefined;
+    dashed?: boolean | undefined;
+    dotted?: boolean | undefined;
+    dashArray?: string | undefined;
+    roundedCorners?: number | undefined;
+    minimumWidth?: number | undefined;
+    minimumHeight?: number | undefined;
+    minimumSize?: number | undefined;
+    scale?: number | undefined;
+    xScale?: number | undefined;
+    yScale?: number | undefined;
+    textColor?: string | undefined;
+    innerXSep?: number | undefined;
+    innerYSep?: number | undefined;
+    outerSep?: number | undefined;
     padding?: number | undefined;
     margin?: number | undefined;
-    fontSize?: number | undefined;
 }>;
 /** 节点：可定位的形状容器（矩形 / 圆 / 椭圆 / 菱形）+ 可选文本标签 */
 export type IRNode = z.infer<typeof NodeSchema>;