@retikz/core 0.2.0-alpha.6 → 0.2.0-alpha.7

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

@@ -65,6 +65,19 @@ export declare const NodeLabelSchema: z.ZodObject<{
     }>>;
     rotate: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["none", "radial", "tangent"]>, z.ZodNumber]>>;
     keepUpright: z.ZodOptional<z.ZodBoolean>;
+    pin: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    }, {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
     distance?: number | undefined;
@@ -79,6 +92,11 @@ export declare const NodeLabelSchema: z.ZodObject<{
     textColor?: string | undefined;
     rotate?: number | "none" | "radial" | "tangent" | undefined;
     keepUpright?: boolean | undefined;
+    pin?: boolean | {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    } | undefined;
 }, {
     text: string;
     distance?: number | undefined;
@@ -93,6 +111,11 @@ export declare const NodeLabelSchema: z.ZodObject<{
     textColor?: string | undefined;
     rotate?: number | "none" | "radial" | "tangent" | undefined;
     keepUpright?: boolean | undefined;
+    pin?: boolean | {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    } | undefined;
 }>;
 /** Node label IR 类型 */
 export type IRNodeLabel = z.infer<typeof NodeLabelSchema>;
@@ -179,8 +202,112 @@ export declare const NodeSchema: z.ZodObject<{
         readonly right: "right";
     }>>;
     lineHeight: z.ZodOptional<z.ZodNumber>;
+    maxTextWidth: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
-    fill: z.ZodOptional<z.ZodString>;
+    fill: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"linearGradient">;
+        stops: z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodString;
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }>, "many">;
+        angle: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    }, {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"radialGradient">;
+        stops: z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodString;
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }>, "many">;
+        center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        radius: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    }, {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"pattern">;
+        shape: z.ZodEnum<["lines", "dots", "grid"]>;
+        color: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        lineWidth: z.ZodOptional<z.ZodNumber>;
+        rotation: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "pattern";
+        shape: "lines" | "dots" | "grid";
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    }, {
+        type: "pattern";
+        shape: "lines" | "dots" | "grid";
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        href: z.ZodString;
+        fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "cover"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    }, {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    }>]>]>>;
     fillOpacity: z.ZodOptional<z.ZodNumber>;
     stroke: z.ZodOptional<z.ZodString>;
     drawOpacity: z.ZodOptional<z.ZodNumber>;
@@ -251,6 +378,19 @@ export declare const NodeSchema: z.ZodObject<{
         }>>;
         rotate: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["none", "radial", "tangent"]>, z.ZodNumber]>>;
         keepUpright: z.ZodOptional<z.ZodBoolean>;
+        pin: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            stroke: z.ZodOptional<z.ZodString>;
+            strokeWidth: z.ZodOptional<z.ZodNumber>;
+            dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         distance?: number | undefined;
@@ -265,6 +405,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }, {
         text: string;
         distance?: number | undefined;
@@ -279,6 +424,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }>, z.ZodArray<z.ZodObject<{
         text: z.ZodString;
         position: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
@@ -312,6 +462,19 @@ export declare const NodeSchema: z.ZodObject<{
         }>>;
         rotate: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["none", "radial", "tangent"]>, z.ZodNumber]>>;
         keepUpright: z.ZodOptional<z.ZodBoolean>;
+        pin: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            stroke: z.ZodOptional<z.ZodString>;
+            strokeWidth: z.ZodOptional<z.ZodNumber>;
+            dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         distance?: number | undefined;
@@ -326,6 +489,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }, {
         text: string;
         distance?: number | undefined;
@@ -340,6 +508,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }>, "many">]>>;
     zIndex: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -352,7 +525,39 @@ export declare const NodeSchema: z.ZodObject<{
         of: string | [number, number] | import('./position').PolarPosition;
         offset: [number, number];
     };
-    fill?: string | undefined;
+    fill?: string | {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    } | {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    } | {
+        type: "pattern";
+        shape: "lines" | "dots" | "grid";
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    } | {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    } | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    shape?: string | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -364,16 +569,13 @@ 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?: string | undefined;
     scale?: number | undefined;
-    color?: string | undefined;
     id?: string | undefined;
     textColor?: string | undefined;
     label?: {
@@ -390,6 +592,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     } | {
         text: string;
         distance?: number | undefined;
@@ -404,6 +611,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }[] | undefined;
     roundedCorners?: number | undefined;
     stroke?: string | undefined;
@@ -414,6 +626,7 @@ export declare const NodeSchema: z.ZodObject<{
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
     lineHeight?: number | undefined;
+    maxTextWidth?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
     dashArray?: number[] | undefined;
@@ -437,7 +650,39 @@ export declare const NodeSchema: z.ZodObject<{
         of: string | [number, number] | import('./position').PolarPosition;
         offset: [number, number];
     };
-    fill?: string | undefined;
+    fill?: string | {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    } | {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    } | {
+        type: "pattern";
+        shape: "lines" | "dots" | "grid";
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    } | {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    } | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    shape?: string | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -449,16 +694,13 @@ 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?: string | undefined;
     scale?: number | undefined;
-    color?: string | undefined;
     id?: string | undefined;
     textColor?: string | undefined;
     label?: {
@@ -475,6 +717,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     } | {
         text: string;
         distance?: number | undefined;
@@ -489,6 +736,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }[] | undefined;
     roundedCorners?: number | undefined;
     stroke?: string | undefined;
@@ -499,6 +751,7 @@ export declare const NodeSchema: z.ZodObject<{
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
     lineHeight?: number | undefined;
+    maxTextWidth?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
     dashArray?: 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;AAKxC;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,+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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+LpB,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;AAMxC;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,+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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2DzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuMpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/es/ir/node.js

@@ -3,6 +3,7 @@ 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 { PaintSpecSchema } from "./paint.js";
 import { TextBlockSchema } from "./text.js";
 import { z } from "zod";
 //#region src/ir/node.ts
@@ -38,7 +39,12 @@ var NodeLabelSchema = z.object({
 		"radial",
 		"tangent"
 	]), z.number()]).optional().describe("Rotate the label text around its own center. `none` (default) = horizontal; `radial` = along the node-center -> label-center direction; `tangent` = radial + 90 deg; a number = explicit degrees (screen y-down: 0 = +x, 90 = +y). Only changes text orientation, not placement."),
-	keepUpright: z.boolean().optional().describe("When true, flips the rotated label 180 deg if it would otherwise read upside-down (more than 90 deg from upright). Default false (strict geometric angle).")
+	keepUpright: z.boolean().optional().describe("When true, flips the rotated label 180 deg if it would otherwise read upside-down (more than 90 deg from upright). Default false (strict geometric angle)."),
+	pin: z.union([z.boolean(), z.object({
+		stroke: z.string().optional().describe("Leader line color; defaults to the label color / currentColor"),
+		strokeWidth: z.number().finite().positive().optional().describe("Leader line width (user units); default 1"),
+		dashPattern: z.array(z.number().finite()).optional().describe("Leader dash pattern (e.g. [2, 2])")
+	})]).optional().describe("Draw a leader line from the node border to the label (TikZ `pin`). `true` = default thin solid line; an object = leader with style overrides (`stroke` / `strokeWidth` / `dashPattern`); omitted / `false` = no leader. Label placement is unchanged either way.")
 }).describe("Extra text attached around a node border. Multiple labels supported via array form on `Node.label`.");
 var NodeSchema = z.object({
 	type: z.literal("node").describe("Discriminator marking this child as a node"),
@@ -54,8 +60,9 @@ var NodeSchema = z.object({
 	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."),
+	maxTextWidth: z.number().finite().positive().optional().describe("Max line width before wrapping (user units). The text box shrinks to the actual longest line for short text — this is a wrap threshold, NOT a fixed paragraph width. Western text wraps on word boundaries, CJK per character. Omitted = no auto-wrap (only manual line breaks)."),
 	color: z.string().optional().describe("Master color (TikZ `color=`). When set, stroke / fill / text default to it unless individually overridden, and it cascades to the inner text and edge labels. Individual fields (stroke / fill / textColor) always win over this within the same node."),
-	fill: z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
+	fill: z.union([z.string(), PaintSpecSchema]).optional().describe("Node background paint: any CSS color string (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\") or a PaintSpec (linear / radial gradient, pattern, or image)."),
 	fillOpacity: z.number().min(0).max(1).optional().describe("Fill opacity 0..1; affects only the shape fill, leaves stroke / text alone."),
 	stroke: z.string().optional().describe("Border color of the node shape; any CSS color. Defaults to currentColor when omitted"),
 	drawOpacity: z.number().min(0).max(1).optional().describe("Stroke opacity 0..1 (TikZ `draw opacity`); affects only the border."),

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

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+/**
+ * 渐变 stop：位置 + 颜色 + 可选透明度
+ * @description offset 0..1（沿渐变轴的位置）；color 任意 CSS 颜色（含 `currentColor` 主题反应）；opacity 0..1。
+ */
+export declare const GradientStopSchema: z.ZodObject<{
+    offset: z.ZodNumber;
+    color: z.ZodString;
+    opacity: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    offset: number;
+    color: string;
+    opacity?: number | undefined;
+}, {
+    offset: number;
+    color: string;
+    opacity?: number | undefined;
+}>;
+/**
+ * Paint server 规格（渐变 / 图案 / 图片）；纯色仍是 `fill` / `stroke` 上的 string，不进此 schema
+ * @description 四种 paint server：linear / radial gradient、pattern（图案）、image（图片）。纯 JSON 形态，保 IR 可序列化。
+ *   linear 方向用 `angle`（度，polar 约定：0°=+x，90°=+y 屏幕下）；radial 的 `center` / `radius` 用 objectBoundingBox（0..1，随形状缩放）。
+ */
+export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"linearGradient">;
+    stops: z.ZodArray<z.ZodObject<{
+        offset: z.ZodNumber;
+        color: z.ZodString;
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }>, "many">;
+    angle: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "linearGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    angle?: number | undefined;
+}, {
+    type: "linearGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    angle?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"radialGradient">;
+    stops: z.ZodArray<z.ZodObject<{
+        offset: z.ZodNumber;
+        color: z.ZodString;
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }>, "many">;
+    center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    radius: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "radialGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    radius?: number | undefined;
+    center?: [number, number] | undefined;
+}, {
+    type: "radialGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    radius?: number | undefined;
+    center?: [number, number] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"pattern">;
+    shape: z.ZodEnum<["lines", "dots", "grid"]>;
+    color: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    lineWidth: z.ZodOptional<z.ZodNumber>;
+    rotation: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "pattern";
+    shape: "lines" | "dots" | "grid";
+    size?: number | undefined;
+    color?: string | undefined;
+    background?: string | undefined;
+    lineWidth?: number | undefined;
+    rotation?: number | undefined;
+}, {
+    type: "pattern";
+    shape: "lines" | "dots" | "grid";
+    size?: number | undefined;
+    color?: string | undefined;
+    background?: string | undefined;
+    lineWidth?: number | undefined;
+    rotation?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    href: z.ZodString;
+    fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "cover"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    href: string;
+    fit?: "fill" | "contain" | "cover" | undefined;
+}, {
+    type: "image";
+    href: string;
+    fit?: "fill" | "contain" | "cover" | undefined;
+}>]>;
+/** 渐变 stop 类型 */
+export type IRGradientStop = z.infer<typeof GradientStopSchema>;
+/** Paint server 规格类型（渐变 / 图案 / 图片） */
+export type IRPaintSpec = z.infer<typeof PaintSpecSchema>;
+//# sourceMappingURL=paint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/ir/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAMY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmEwF,CAAC;AAErH,iBAAiB;AACjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/es/ir/paint.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+//#region src/ir/paint.ts
+/**
+* 渐变 stop：位置 + 颜色 + 可选透明度
+* @description offset 0..1（沿渐变轴的位置）；color 任意 CSS 颜色（含 `currentColor` 主题反应）；opacity 0..1。
+*/
+var GradientStopSchema = z.object({
+	offset: z.number().min(0).max(1).describe("Stop position along the gradient axis, 0..1"),
+	color: z.string().describe("Any CSS color (e.g. \"#08f\", \"navy\", \"currentColor\")"),
+	opacity: z.number().min(0).max(1).optional().describe("Stop opacity 0..1; omitted = fully opaque")
+}).describe("A single gradient color stop");
+/**
+* Paint server 规格（渐变 / 图案 / 图片）；纯色仍是 `fill` / `stroke` 上的 string，不进此 schema
+* @description 四种 paint server：linear / radial gradient、pattern（图案）、image（图片）。纯 JSON 形态，保 IR 可序列化。
+*   linear 方向用 `angle`（度，polar 约定：0°=+x，90°=+y 屏幕下）；radial 的 `center` / `radius` 用 objectBoundingBox（0..1，随形状缩放）。
+*/
+var PaintSpecSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("linearGradient"),
+		stops: z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
+		angle: z.number().finite().optional().describe("Gradient direction in degrees (polar convention; 0°=+x, 90°=+y screen-down); omitted = renderer default (left→right)")
+	}).describe("Linear gradient paint server"),
+	z.object({
+		type: z.literal("radialGradient"),
+		stops: z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
+		center: z.tuple([z.number().finite(), z.number().finite()]).optional().describe("Center in objectBoundingBox units (0..1 relative to the filled shape); omitted = (0.5, 0.5)"),
+		radius: z.number().finite().positive().optional().describe("Radius in objectBoundingBox units (0..1); omitted = 0.5")
+	}).describe("Radial gradient paint server"),
+	z.object({
+		type: z.literal("pattern"),
+		shape: z.enum([
+			"lines",
+			"dots",
+			"grid"
+		]).describe("Pattern motif: `lines` (hatching) / `dots` / `grid` (crosshatch)"),
+		color: z.string().optional().describe("Motif color; any CSS color, defaults to `currentColor`"),
+		background: z.string().optional().describe("Tile background fill; omitted = transparent"),
+		size: z.number().finite().positive().optional().describe("Tile period in user units (line gap / dot spacing); default 8"),
+		lineWidth: z.number().finite().positive().optional().describe("Line / grid stroke width; for dots, drives the dot radius. Default 1 (dots default to size/5)"),
+		rotation: z.number().finite().optional().describe("Rotate the whole pattern, in degrees")
+	}).describe("Pattern paint server (hatching / dots / grid)"),
+	z.object({
+		type: z.literal("image"),
+		href: z.string().min(1).describe("Image URL (http(s) or data URI)"),
+		fit: z.enum([
+			"fill",
+			"contain",
+			"cover"
+		]).optional().describe("How the image maps to the shape: `fill` (stretch) / `contain` / `cover`. Default `cover`")
+	}).describe("Image paint server (fills the shape with an image)")
+]).describe("Paint server spec: gradient / pattern / image. Solid color stays a plain string on `fill` / `stroke`.");
+//#endregion
+export { GradientStopSchema, PaintSpecSchema };