@retikz/react 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/lib/kernel/Step.d.ts

@@ -1,9 +1,14 @@
-import { FC } from 'react';
-import { IRTarget } from '@retikz/core';
+import { FC, ReactNode } from 'react';
+import { IRControlPoint, IRStepLabel, IRTarget } from '@retikz/core';
 /**
  * <Step> 组件的 props。
- * v0.1.0-alpha.1 支持四种 kind：'move' / 'line' / 'step'（折角）/ 'cycle'（闭合）。
+ * alpha.3 起支持十种 kind：'move' / 'line' / 'step'（折角）/ 'cycle'（闭合）/
+ * 'curve'（二次贝塞尔）/ 'cubic'（三次贝塞尔）/ 'bend'（弧形简记）/
+ * 'arc'（圆弧段）/ 'circlePath'（整圆）/ 'ellipsePath'（整椭圆）。
  * kind 默认 'line'。
+ *
+ * ADR-0004：除 'move' / 'cycle' 外的八种 kind 都可挂 `label?: IRStepLabel` 边标注；
+ * 等价的写法是用 sugar `<EdgeLabel>` 当 children。两者并存时 prop 优先。
  */
 export type StepProps = {
     /** 移动游标但不绘制（类似 SVG path "M"） */
@@ -15,6 +20,10 @@ export type StepProps = {
     kind?: 'line';
     /** 直线终点 */
     to: IRTarget;
+    /** 边标注（ADR-0004），等价于 <EdgeLabel> child */
+    label?: IRStepLabel;
+    /** sugar 形态：`<Step><EdgeLabel>...</EdgeLabel></Step>`；其它 children 静默忽略 */
+    children?: ReactNode;
 } | {
     /** 折角段：从游标经一个直角拐点到目标点（TikZ `-|` / `|-`） */
     kind: 'step';
@@ -22,9 +31,83 @@ export type StepProps = {
     via: '-|' | '|-';
     /** 折角终点 */
     to: IRTarget;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
 } | {
     /** 闭合：把当前子路径回到最近一个 move 起点（TikZ `cycle` / SVG `Z`） */
     kind: 'cycle';
+} | {
+    /** 二次贝塞尔：一个控制点（TikZ `.. controls (B) ..`） */
+    kind: 'curve';
+    /** 控制点（alpha.3 仅支持 [x, y]，未来可能扩展） */
+    control: IRControlPoint;
+    /** 曲线终点 */
+    to: IRTarget;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
+} | {
+    /** 三次贝塞尔：两个控制点（TikZ `.. controls (B) and (C) ..`） */
+    kind: 'cubic';
+    /** 第一控制点（影响起点切线） */
+    control1: IRControlPoint;
+    /** 第二控制点（影响终点切线） */
+    control2: IRControlPoint;
+    /** 曲线终点 */
+    to: IRTarget;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
+} | {
+    /** 弧形简记：按方向 + 角度生成 cubic（TikZ `to[bend left=N]` / `to[bend right=N]`） */
+    kind: 'bend';
+    /** 弯向：'left' / 'right'（视觉左右，相对 from→to） */
+    bendDirection: 'left' | 'right';
+    /** 弯角度（度），缺省 30 */
+    bendAngle?: number;
+    /** 终点 */
+    to: IRTarget;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
+} | {
+    /** 弧段：以游标为圆心，按起末角度 + 半径绘制（TikZ `arc[start angle=…, end angle=…, radius=…]`） */
+    kind: 'arc';
+    /** 弧的起始角度（度），CCW from +x（注意 retikz polar y 轴向下，角度 90 视觉朝下） */
+    startAngle: number;
+    /** 弧的终止角度（度） */
+    endAngle: number;
+    /** 弧的半径 */
+    radius: number;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
+} | {
+    /** 整圆：以游标为圆心，按半径绘制；画完画笔留在圆心 */
+    kind: 'circlePath';
+    /** 圆的半径 */
+    radius: number;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
+} | {
+    /** 整椭圆：以游标为圆心，按 x/y 轴半径绘制；画完画笔留在圆心 */
+    kind: 'ellipsePath';
+    /** 椭圆 x 轴半径 */
+    radiusX: number;
+    /** 椭圆 y 轴半径 */
+    radiusY: number;
+    /** 边标注（ADR-0004） */
+    label?: IRStepLabel;
+    /** sugar 形态 */
+    children?: ReactNode;
 };
 /**
  * Step 是 DSL 标记组件——本身不渲染。

package/dist/lib/kernel/Step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../../src/kernel/Step.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IACE,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
+{"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../../src/kernel/Step.tsx"],"names":[],"mappings":"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"}

package/dist/lib/kernel/Text.cjs

@@ -0,0 +1,22 @@
+const require__displayNames = require("./_displayNames.cjs");
+//#region src/kernel/Text.tsx
+/**
+* Text 是 Node 内的"行级"标记组件——本身不渲染，
+* 由 buildIR 在扫描 Node children 时识别为 LineSpec。
+*
+* 和字符串 children 平等参与——String 按 `'\n'` 拆纯样式行；
+* `<Text>` 一次贡献一行带样式行；保持 JSX 顺序。
+*
+* 用法：
+* ```tsx
+* <Node>
+*   <Text fill="red" font={{ weight: 'bold' }}>Heading</Text>
+*   body line 1
+*   body line 2
+* </Node>
+* ```
+*/
+var Text = () => null;
+Text.displayName = require__displayNames.TIKZ_TEXT;
+//#endregion
+exports.Text = Text;

package/dist/lib/kernel/Text.d.ts

@@ -0,0 +1,31 @@
+import { FC } from 'react';
+import { IRFont } from '@retikz/core';
+/** <Text> 组件的 props——Node 多行文本里给某一行带覆盖样式 */
+export type TextProps = {
+    /** 行内容（必须是字符串） */
+    children: string;
+    /** 行级覆盖颜色；不填走 Node 块级默认 */
+    fill?: string;
+    /** 行级透明度 0~1；不填走 Node 块级默认 */
+    opacity?: number;
+    /** 行级字体覆盖；missing 字段继承 Node 的 `font` 块级值 */
+    font?: IRFont;
+};
+/**
+ * Text 是 Node 内的"行级"标记组件——本身不渲染，
+ * 由 buildIR 在扫描 Node children 时识别为 LineSpec。
+ *
+ * 和字符串 children 平等参与——String 按 `'\n'` 拆纯样式行；
+ * `<Text>` 一次贡献一行带样式行；保持 JSX 顺序。
+ *
+ * 用法：
+ * ```tsx
+ * <Node>
+ *   <Text fill="red" font={{ weight: 'bold' }}>Heading</Text>
+ *   body line 1
+ *   body line 2
+ * </Node>
+ * ```
+ */
+export declare const Text: FC<TextProps>;
+//# sourceMappingURL=Text.d.ts.map

package/dist/lib/kernel/Text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../src/kernel/Text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG;IACtB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}

package/dist/lib/kernel/_builder.cjs

@@ -8,25 +8,130 @@ var getDisplayName = (el) => {
 	if (typeof t === "string") return t;
 	return t.displayName;
 };
-/** 把 <Node> props 翻成 IRChild；text 优先取 props.text，其次取字符串 children */
-var buildNode = (props) => {
-	const text = typeof props.text === "string" ? props.text : typeof props.children === "string" ? props.children : void 0;
+/**
+* 把 <Text> 元素的 props + children 串解析为 IRLineSpec 对象形式。
+* children 必须是 string；非字符串 children 静默跳过此 <Text> 元素。
+*/
+var textElementToLineSpec = (el) => {
+	const props = el.props;
+	if (typeof props.children !== "string") return void 0;
+	if (props.fill === void 0 && props.opacity === void 0 && props.font === void 0) return props.children;
 	return {
-		type: "node",
-		id: props.id,
-		shape: props.shape,
-		position: props.position,
-		rotate: props.rotate,
-		text,
+		text: props.children,
 		fill: props.fill,
-		stroke: props.stroke,
-		strokeWidth: props.strokeWidth,
-		padding: props.padding,
-		margin: props.margin,
-		fontSize: props.fontSize
+		opacity: props.opacity,
+		font: props.font
 	};
 };
 /**
+* 递归收集 Node children 中的行：
+* - 字符串按 `'\n'` 拆行（每段 → 字符串 LineSpec）
+* - 数组（JSX 多 child 自动展平）逐项递归
+* - <Text> 元素 → 对象 LineSpec（带覆盖样式）
+* - 其它类型（其它 React 元素 / null / 数字等）忽略——附带让 `<br/>` 当软分段
+*
+* 顺序保留——按 JSX 写的顺序行就是 IR 行顺序。
+*/
+var collectChildLines = (children) => {
+	const out = [];
+	const visit = (node) => {
+		if (typeof node === "string") {
+			for (const part of node.split("\n")) out.push(part);
+			return;
+		}
+		if (Array.isArray(node)) {
+			for (const c of node) visit(c);
+			return;
+		}
+		if ((0, react.isValidElement)(node) && getDisplayName(node) === "@retikz/Text") {
+			const spec = textElementToLineSpec(node);
+			if (spec !== void 0) out.push(spec);
+		}
+	};
+	visit(children);
+	return out;
+};
+/**
+* Node 文本读取顺序：
+* 1. `props.text`（string / string[] / LineSpec[]）— 显式优先，直接透传到 IR
+* 2. `props.children` — 字符串按 `'\n'` 拆行；`<Text>` 元素带样式贡献一行；保持 JSX 顺序
+*
+* 用 children 写多行的几种姿势：
+* - 字符串带换行：`<Node>{'Line 1\nLine 2'}</Node>`
+* - 模板字面量：``<Node>{`Line 1\nLine 2`}</Node>``
+* - 数组：`<Node>{['Line 1', 'Line 2']}</Node>`
+* - <Text>（带样式）：`<Node><Text fill="red">Heading</Text>body</Node>`
+*/
+var readNodeText = (props) => {
+	if (typeof props.text === "string") return props.text;
+	if (Array.isArray(props.text)) return props.text;
+	const lines = collectChildLines(props.children);
+	if (lines.length === 0) return void 0;
+	if (lines.length === 1 && typeof lines[0] === "string") return lines[0];
+	return lines;
+};
+/** 把 <Node> props 翻成 IRChild；text 优先取 props.text，其次取字符串 children */
+var buildNode = (props) => ({
+	type: "node",
+	id: props.id,
+	shape: props.shape,
+	position: props.position,
+	rotate: props.rotate,
+	text: readNodeText(props),
+	align: props.align,
+	lineHeight: props.lineHeight,
+	fill: props.fill,
+	fillOpacity: props.fillOpacity,
+	stroke: props.stroke,
+	drawOpacity: props.drawOpacity,
+	strokeWidth: props.strokeWidth,
+	dashed: props.dashed,
+	dotted: props.dotted,
+	dashArray: props.dashArray,
+	roundedCorners: props.roundedCorners,
+	minimumWidth: props.minimumWidth,
+	minimumHeight: props.minimumHeight,
+	minimumSize: props.minimumSize,
+	scale: props.scale,
+	xScale: props.xScale,
+	yScale: props.yScale,
+	textColor: props.textColor,
+	opacity: props.opacity,
+	innerXSep: props.innerXSep,
+	innerYSep: props.innerYSep,
+	outerSep: props.outerSep,
+	padding: props.padding,
+	margin: props.margin,
+	font: props.font
+});
+/**
+* 扫描 Step children，把首个 <EdgeLabel> 翻译为 IRStepLabel；
+* 非字符串 children 静默跳过；多个 <EdgeLabel> 取首个。
+*/
+var readEdgeLabel = (children) => {
+	let result;
+	react.Children.forEach(children, (child) => {
+		if (result !== void 0) return;
+		if (!(0, react.isValidElement)(child)) return;
+		if (getDisplayName(child) !== "@retikz/EdgeLabel") return;
+		const props = child.props;
+		if (typeof props.children !== "string") return;
+		const out = { text: props.children };
+		if (props.position !== void 0) out.position = props.position;
+		if (props.side !== void 0) out.side = props.side;
+		result = out;
+	});
+	return result;
+};
+/**
+* 解析 Step 的 label 来源：prop `label` 优先于 sugar `<EdgeLabel>` child；
+* 都缺省时返回 undefined。
+*/
+var resolveStepLabel = (props) => {
+	if (props.label !== void 0) return props.label;
+	return readEdgeLabel(props.children);
+};
+/**
 * 扫描 <Path> children 收集 <Step> 序列。
 * 至少 2 段；首段不是 move 时强制改为 move（与 SVG path 的 "M …" 语义对齐）；
 * cycle 没有 to 字段，若用户把 cycle 放在首段，coerce 时降级到 move (0,0)。
@@ -45,32 +150,109 @@ var readPathChildren = (children) => {
 			});
 			return;
 		}
+		const label = kind === "move" ? void 0 : resolveStepLabel(props);
 		if (kind === "step") {
-			out.push({
+			const step = {
 				type: "step",
 				kind: "step",
 				via: props.via,
-				to: props.to
+				to: (0, _retikz_core.parseTargetSugar)(props.to)
+			};
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "curve") {
+			const step = {
+				type: "step",
+				kind: "curve",
+				to: (0, _retikz_core.parseTargetSugar)(props.to),
+				control: props.control
+			};
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "cubic") {
+			const step = {
+				type: "step",
+				kind: "cubic",
+				to: (0, _retikz_core.parseTargetSugar)(props.to),
+				control1: props.control1,
+				control2: props.control2
+			};
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "bend") {
+			const step = {
+				type: "step",
+				kind: "bend",
+				to: (0, _retikz_core.parseTargetSugar)(props.to),
+				bendDirection: props.bendDirection
+			};
+			if (props.bendAngle !== void 0) step.bendAngle = props.bendAngle;
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "arc") {
+			const step = {
+				type: "step",
+				kind: "arc",
+				startAngle: props.startAngle,
+				endAngle: props.endAngle,
+				radius: props.radius
+			};
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "circlePath") {
+			const step = {
+				type: "step",
+				kind: "circlePath",
+				radius: props.radius
+			};
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "ellipsePath") {
+			const step = {
+				type: "step",
+				kind: "ellipsePath",
+				radiusX: props.radiusX,
+				radiusY: props.radiusY
+			};
+			if (label) step.label = label;
+			out.push(step);
+			return;
+		}
+		if (kind === "move") {
+			out.push({
+				type: "step",
+				kind: "move",
+				to: (0, _retikz_core.parseTargetSugar)(props.to)
 			});
 			return;
 		}
-		out.push({
+		const step = {
 			type: "step",
-			kind,
-			to: props.to
-		});
+			kind: "line",
+			to: (0, _retikz_core.parseTargetSugar)(props.to)
+		};
+		if (label) step.label = label;
+		out.push(step);
 	});
 	if (out.length < 2) throw new Error("<Path> requires at least 2 <Step> children");
 	if (out[0].kind !== "move") {
 		const first = out[0];
-		out[0] = first.kind === "cycle" ? {
-			type: "step",
-			kind: "move",
-			to: [0, 0]
-		} : {
+		out[0] = {
 			type: "step",
 			kind: "move",
-			to: first.to
+			to: first.kind === "cycle" || first.kind === "arc" || first.kind === "circlePath" || first.kind === "ellipsePath" ? [0, 0] : first.to
 		};
 	}
 	return out;
@@ -81,10 +263,16 @@ var buildPath = (props) => ({
 	stroke: props.stroke,
 	strokeWidth: props.strokeWidth,
 	strokeDasharray: props.strokeDasharray,
+	lineCap: props.lineCap,
+	lineJoin: props.lineJoin,
+	thickness: props.thickness,
 	arrow: props.arrow,
 	arrowShape: props.arrowShape,
 	fill: props.fill,
 	fillRule: props.fillRule,
+	opacity: props.opacity,
+	fillOpacity: props.fillOpacity,
+	drawOpacity: props.drawOpacity,
 	children: readPathChildren(props.children)
 });
 /**

package/dist/lib/kernel/_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AAoIhE;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}
+{"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EACV,EAAE,EAQH,MAAM,cAAc,CAAC;AAkXtB;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}

package/dist/lib/kernel/_displayNames.cjs

@@ -5,7 +5,13 @@ var TIKZ_NODE = "@retikz/Node";
 var TIKZ_PATH = "@retikz/Path";
 /** <Step> 组件的 displayName */
 var TIKZ_STEP = "@retikz/Step";
+/** <Text> 组件的 displayName（Node 内多行文本带样式） */
+var TIKZ_TEXT = "@retikz/Text";
+/** <EdgeLabel> 组件的 displayName（Step 内边标注，ADR-0004） */
+var TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
 //#endregion
+exports.TIKZ_EDGE_LABEL = TIKZ_EDGE_LABEL;
 exports.TIKZ_NODE = TIKZ_NODE;
 exports.TIKZ_PATH = TIKZ_PATH;
 exports.TIKZ_STEP = TIKZ_STEP;
+exports.TIKZ_TEXT = TIKZ_TEXT;

package/dist/lib/kernel/_displayNames.d.ts

@@ -4,4 +4,8 @@ export declare const TIKZ_NODE = "@retikz/Node";
 export declare const TIKZ_PATH = "@retikz/Path";
 /** <Step> 组件的 displayName */
 export declare const TIKZ_STEP = "@retikz/Step";
+/** <Text> 组件的 displayName（Node 内多行文本带样式） */
+export declare const TIKZ_TEXT = "@retikz/Text";
+/** <EdgeLabel> 组件的 displayName（Step 内边标注，ADR-0004） */
+export declare const TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
 //# sourceMappingURL=_displayNames.d.ts.map

package/dist/lib/kernel/_displayNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC"}
+{"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,4CAA4C;AAC5C,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,eAAe,sBAAsB,CAAC"}

package/dist/lib/kernel/_unbuilder.cjs

@@ -10,12 +10,31 @@ var nodePropsFromIR = (n) => {
 	if (n.shape !== void 0) props.shape = n.shape;
 	if (n.rotate !== void 0) props.rotate = n.rotate;
 	if (n.text !== void 0) props.text = n.text;
-	if (n.fontSize !== void 0) props.fontSize = n.fontSize;
+	if (n.align !== void 0) props.align = n.align;
+	if (n.lineHeight !== void 0) props.lineHeight = n.lineHeight;
+	if (n.font !== void 0) props.font = n.font;
+	if (n.innerXSep !== void 0) props.innerXSep = n.innerXSep;
+	if (n.innerYSep !== void 0) props.innerYSep = n.innerYSep;
+	if (n.outerSep !== void 0) props.outerSep = n.outerSep;
 	if (n.padding !== void 0) props.padding = n.padding;
 	if (n.margin !== void 0) props.margin = n.margin;
 	if (n.fill !== void 0) props.fill = n.fill;
+	if (n.fillOpacity !== void 0) props.fillOpacity = n.fillOpacity;
 	if (n.stroke !== void 0) props.stroke = n.stroke;
+	if (n.drawOpacity !== void 0) props.drawOpacity = n.drawOpacity;
 	if (n.strokeWidth !== void 0) props.strokeWidth = n.strokeWidth;
+	if (n.dashed !== void 0) props.dashed = n.dashed;
+	if (n.dotted !== void 0) props.dotted = n.dotted;
+	if (n.dashArray !== void 0) props.dashArray = n.dashArray;
+	if (n.roundedCorners !== void 0) props.roundedCorners = n.roundedCorners;
+	if (n.minimumWidth !== void 0) props.minimumWidth = n.minimumWidth;
+	if (n.minimumHeight !== void 0) props.minimumHeight = n.minimumHeight;
+	if (n.minimumSize !== void 0) props.minimumSize = n.minimumSize;
+	if (n.scale !== void 0) props.scale = n.scale;
+	if (n.xScale !== void 0) props.xScale = n.xScale;
+	if (n.yScale !== void 0) props.yScale = n.yScale;
+	if (n.textColor !== void 0) props.textColor = n.textColor;
+	if (n.opacity !== void 0) props.opacity = n.opacity;
 	return props;
 };
 /** 单个 IRStep → <Step /> element */
@@ -28,12 +47,63 @@ var stepToElement = (step, key) => {
 		key,
 		kind: "step",
 		via: step.via,
+		to: step.to,
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "curve") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "curve",
+		to: step.to,
+		control: step.control,
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "cubic") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "cubic",
+		to: step.to,
+		control1: step.control1,
+		control2: step.control2,
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "bend") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "bend",
+		to: step.to,
+		bendDirection: step.bendDirection,
+		...step.bendAngle !== void 0 && { bendAngle: step.bendAngle },
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "arc") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "arc",
+		startAngle: step.startAngle,
+		endAngle: step.endAngle,
+		radius: step.radius,
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "circlePath") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "circlePath",
+		radius: step.radius,
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "ellipsePath") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "ellipsePath",
+		radiusX: step.radiusX,
+		radiusY: step.radiusY,
+		...step.label !== void 0 && { label: step.label }
+	});
+	if (step.kind === "move") return (0, react.createElement)(require_Step.Step, {
+		key,
+		kind: "move",
 		to: step.to
 	});
 	return (0, react.createElement)(require_Step.Step, {
 		key,
 		kind: step.kind,
-		to: step.to
+		to: step.to,
+		...step.label !== void 0 && { label: step.label }
 	});
 };
 /** discriminated union 兜底：编译期保证不漏 case，运行时给出明确错误 */
@@ -52,10 +122,16 @@ var childToElement = (child, key) => {
 			stroke: child.stroke,
 			strokeWidth: child.strokeWidth,
 			strokeDasharray: child.strokeDasharray,
+			lineCap: child.lineCap,
+			lineJoin: child.lineJoin,
+			thickness: child.thickness,
 			arrow: child.arrow,
 			arrowShape: child.arrowShape,
 			fill: child.fill,
 			fillRule: child.fillRule,
+			opacity: child.opacity,
+			fillOpacity: child.fillOpacity,
+			drawOpacity: child.drawOpacity,
 			children: child.children.map((s, j) => stepToElement(s, j))
 		});
 		default: return assertNever(child);

package/dist/lib/kernel/_unbuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_unbuilder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_unbuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AA2DhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EAAE,KAAG,SACW,CAAC"}
+{"version":3,"file":"_unbuilder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_unbuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AA2JhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EAAE,KAAG,SACW,CAAC"}

package/dist/lib/kernel/index.cjs

@@ -2,3 +2,4 @@ require("./Tikz.cjs");
 require("./Node.cjs");
 require("./Path.cjs");
 require("./Step.cjs");
+require("./Text.cjs");

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

@@ -2,4 +2,5 @@ export * from './Tikz';
 export * from './Node';
 export * from './Path';
 export * from './Step';
+export * from './Text';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kernel/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kernel/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}