@retikz/core 0.1.0-alpha.5 → 0.1.0-beta.2

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

@@ -12,117 +12,6 @@ export declare const NODE_SHAPES: {
 };
 /** 节点形状字面量类型 */
 export type NodeShape = ValueOf<typeof NODE_SHAPES>;
-/** 节点字体规格：family/size/weight/style 全部可选，透传 SVG `<text>` font-* 属性 */
-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
- * @description 行级覆盖只生效于本行 `<tspan>`；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 类型 */
-export type IRLineSpec = z.infer<typeof LineSpecSchema>;
-/**
- * 节点文本：单字符串或非空多行 LineSpec 数组
- * @description 选数组而非 `\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";
@@ -132,7 +21,7 @@ export declare const NODE_TEXT_ALIGNS: {
 export type NodeTextAlign = ValueOf<typeof NODE_TEXT_ALIGNS>;
 /**
  * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
- * @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
+ * @description 可挂多个；label 不参与 layout。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
  */
 export declare const NodeLabelSchema: z.ZodObject<{
     text: z.ZodString;
@@ -169,25 +58,25 @@ export declare const NodeLabelSchema: z.ZodObject<{
     text: string;
     distance?: number | undefined;
     opacity?: number | undefined;
-    position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
     font?: {
         family?: string | undefined;
         size?: number | undefined;
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
+    position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
     textColor?: string | undefined;
 }, {
     text: string;
     distance?: number | undefined;
     opacity?: number | undefined;
-    position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
     font?: {
         family?: string | undefined;
         size?: number | undefined;
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
+    position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
     textColor?: string | undefined;
 }>;
 /** Node label IR 类型 */
@@ -287,7 +176,7 @@ export declare const NodeSchema: z.ZodObject<{
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     dashed: z.ZodOptional<z.ZodBoolean>;
     dotted: z.ZodOptional<z.ZodBoolean>;
-    dashArray: z.ZodOptional<z.ZodString>;
+    dashArray: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
     roundedCorners: z.ZodOptional<z.ZodNumber>;
     minimumWidth: z.ZodOptional<z.ZodNumber>;
     minimumHeight: z.ZodOptional<z.ZodNumber>;
@@ -353,25 +242,25 @@ export declare const NodeSchema: z.ZodObject<{
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     }, {
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     }>, z.ZodArray<z.ZodObject<{
         text: z.ZodString;
@@ -408,25 +297,25 @@ export declare const NodeSchema: z.ZodObject<{
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     }, {
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     }>, "many">]>>;
 }, "strip", z.ZodTypeAny, {
@@ -440,9 +329,6 @@ export declare const NodeSchema: z.ZodObject<{
         offset: [number, number];
     };
     fill?: string | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
-    scale?: number | undefined;
-    opacity?: number | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -454,41 +340,44 @@ export declare const NodeSchema: z.ZodObject<{
             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;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    scale?: number | undefined;
     label?: {
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     } | {
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     }[] | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
-    font?: {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    } | undefined;
     textColor?: string | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
@@ -496,7 +385,7 @@ export declare const NodeSchema: z.ZodObject<{
     lineHeight?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
-    dashArray?: string | undefined;
+    dashArray?: number[] | undefined;
     roundedCorners?: number | undefined;
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
@@ -519,9 +408,6 @@ export declare const NodeSchema: z.ZodObject<{
         offset: [number, number];
     };
     fill?: string | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
-    scale?: number | undefined;
-    opacity?: number | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -533,41 +419,44 @@ export declare const NodeSchema: z.ZodObject<{
             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;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    scale?: number | undefined;
     label?: {
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     } | {
         text: string;
         distance?: number | undefined;
         opacity?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         font?: {
             family?: string | undefined;
             size?: number | undefined;
             weight?: number | "normal" | "bold" | undefined;
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
+        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         textColor?: string | undefined;
     }[] | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
-    font?: {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    } | undefined;
     textColor?: string | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
@@ -575,7 +464,7 @@ export declare const NodeSchema: z.ZodObject<{
     lineHeight?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
-    dashArray?: string | undefined;
+    dashArray?: number[] | undefined;
     roundedCorners?: number | undefined;
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/ir/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAwBpB,CAAC;AAEJ,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBxB,CAAC;AAEJ,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAIxB,CAAC;AAEJ,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+KpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/ir/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgLpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/es/ir/node.js

@@ -2,6 +2,8 @@ import { PositionSchema } from "./position/position.js";
 import { PolarPositionSchema } from "./position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./position/at-position.js";
 import { OffsetPositionSchema } from "./position/offset-position.js";
+import { FontSchema } from "./font.js";
+import { TextBlockSchema } from "./text.js";
 import { z } from "zod";
 //#region src/ir/node.ts
 /**
@@ -14,32 +16,6 @@ var NODE_SHAPES = {
 	ellipse: "ellipse",
 	diamond: "diamond"
 };
-/** 节点字体规格：family/size/weight/style 全部可选，透传 SVG `<text>` font-* 属性 */
-var FontSchema = z.object({
-	family: z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
-	size: z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
-	weight: z.union([z.enum(["normal", "bold"]), z.number()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
-	style: z.enum([
-		"normal",
-		"italic",
-		"oblique"
-	]).optional().describe("CSS font-style")
-}).describe("Font properties for the node text label; all fields optional, nested object form.");
-/**
-* 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
-* @description 行级覆盖只生效于本行 `<tspan>`；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
-*/
-var LineSpecSchema = z.union([z.string(), z.object({
-	text: z.string().describe("Line content"),
-	fill: z.string().optional().describe("Per-line text color; overrides block default"),
-	opacity: 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 数组
-* @description 选数组而非 `\n` 字符串：JSON 友好无 escape，行级覆盖天然落字段
-*/
-var NodeTextSchema = z.union([z.string(), 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",
@@ -48,7 +24,7 @@ var NODE_TEXT_ALIGNS = {
 };
 /**
 * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
-* @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
+* @description 可挂多个；label 不参与 layout。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
 */
 var NodeLabelSchema = z.object({
 	text: z.string().describe("Label text content; rendered as a single line."),
@@ -69,7 +45,7 @@ var NodeSchema = z.object({
 		OffsetPositionSchema
 	]).describe("Center point of the node content box; Cartesian [x, y], polar, relative-to-another-node (`at`-style with `direction` / `of` / `distance?`), or offset from a base point (`{ of, offset }` form mirroring TikZ `calc`). All non-Cartesian forms resolve at compile time."),
 	rotate: z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: NodeTextSchema.optional(),
+	text: TextBlockSchema.optional(),
 	align: z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
 	lineHeight: z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	fill: z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
@@ -79,8 +55,8 @@ var NodeSchema = z.object({
 	strokeWidth: z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
 	dashed: z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
 	dotted: z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
-	dashArray: z.string().optional().describe("Explicit SVG stroke-dasharray value (e.g. \"4 2\"); overrides `dashed` / `dotted`."),
-	roundedCorners: z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape (rx / ry on `<rect>`)."),
+	dashArray: z.array(z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
+	roundedCorners: z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape."),
 	minimumWidth: z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
 	minimumSize: z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),
@@ -98,4 +74,4 @@ var NodeSchema = z.object({
 	label: z.union([NodeLabelSchema, 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`.")
 }).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
-export { FontSchema, LineSpecSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema, NodeTextSchema };
+export { NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema };

package/dist/es/ir/path/arrow.d.ts

@@ -20,9 +20,9 @@ export type ArrowShape = ValueOf<typeof ARROW_SHAPES>;
  * @description compile 与 render 都引用此表判定 fill 是否丢弃；空心 shape 用 color 主导描边、lineWidth 控描边粗
  */
 export declare const HOLLOW_ARROW_SHAPES: Set<ArrowShape>;
-/** marker 默认尺寸（length / width 的 fallback；arrowMarkers viewBox 内的几何也按 10 单位定义） */
+/** 箭头默认尺寸（length / width 的 fallback） */
 export declare const ARROW_MARKER_DEFAULT_SIZE = 6;
-/** 空心 shape 描边默认粗细（lineWidth fallback；refX / shrink 计算都用它做"back stroke 半宽"） */
+/** 空心 shape 描边默认粗细（lineWidth fallback） */
 export declare const ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
 /**
  * 端点级箭头视觉规格 schema
@@ -48,20 +48,20 @@ export declare const ArrowEndDetailSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
 }>;
 /**
@@ -106,20 +106,20 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }>>;
     end: z.ZodOptional<z.ZodObject<{
@@ -142,78 +142,78 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
 }>;

package/dist/es/ir/path/arrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAA6D,CAAC;AAE9F,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,+EAA+E;AAC/E,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2D9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAA6D,CAAC;AAE9F,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2D9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/es/ir/path/arrow.js

@@ -22,9 +22,9 @@ var HOLLOW_ARROW_SHAPES = new Set([
 	"openDiamond",
 	"openCircle"
 ]);
-/** marker 默认尺寸（length / width 的 fallback；arrowMarkers viewBox 内的几何也按 10 单位定义） */
+/** 箭头默认尺寸（length / width 的 fallback） */
 var ARROW_MARKER_DEFAULT_SIZE = 6;
-/** 空心 shape 描边默认粗细（lineWidth fallback；refX / shrink 计算都用它做"back stroke 半宽"） */
+/** 空心 shape 描边默认粗细（lineWidth fallback） */
 var ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
 /**
 * 端点级箭头视觉规格 schema
@@ -33,9 +33,9 @@ var ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
 var ArrowEndDetailSchema = z.object({
 	shape: z.nativeEnum(ARROW_SHAPES).optional().describe("Arrow tip shape. Defaults to `normal` (filled triangle). Other values: `open` (hollow triangle), `stealth` (sharp barb), `diamond`, `openDiamond`, `circle`, `openCircle`."),
 	scale: z.number().positive().optional().describe("Uniform tip scale factor; multiplies `length` and `width` (e.g. `length=10, scale=1.5` → effective 15). Defaults to 1."),
-	length: z.number().nonnegative().optional().describe("Tip length in user units (the dimension along the path direction). Defaults to ~6 (matching the legacy hardcoded markerWidth)."),
-	width: z.number().nonnegative().optional().describe("Tip width in user units (perpendicular to the path). Defaults to ~6 (matching the legacy hardcoded markerHeight)."),
-	color: z.string().optional().describe("Stroke color override. When omitted, the marker inherits the path stroke via `context-stroke`."),
+	length: z.number().nonnegative().optional().describe("Tip length in user units (the dimension along the path direction). Defaults to ~6."),
+	width: z.number().nonnegative().optional().describe("Tip width in user units (perpendicular to the path). Defaults to ~6."),
+	color: z.string().optional().describe("Stroke color override. When omitted, the renderer should inherit the path stroke."),
 	fill: z.string().optional().describe("Fill color override (effective only on solid shapes). Hollow shapes (`open` / `openDiamond` / `openCircle`) silently ignore this field — `color` drives the stroke."),
 	opacity: z.number().min(0).max(1).optional().describe("Arrow opacity 0..1, independent from the path opacity. When omitted, inherits the path opacity."),
 	lineWidth: z.number().nonnegative().optional().describe("Stroke width for hollow shapes (user units). Defaults to 1.5. Solid shapes ignore this field.")