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

package/dist/lib/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";
@@ -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 类型 */
@@ -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;
@@ -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;

package/dist/lib/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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+KpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

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

@@ -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/lib/ir/path/path.cjs

@@ -6,7 +6,7 @@ var PathSchema = zod.z.object({
 	type: zod.z.literal("path").describe("Discriminator marking this child as a path"),
 	stroke: zod.z.string().optional().describe("Stroke color of the path; any CSS color. Defaults to currentColor when omitted"),
 	strokeWidth: zod.z.number().optional().describe("Stroke width in user units; defaults to 1 when omitted"),
-	strokeDasharray: zod.z.string().optional().describe("SVG stroke-dasharray pattern (e.g. \"4 2\"); leave empty for solid line"),
+	strokeDasharray: zod.z.string().optional().describe("Stroke dash pattern (e.g. \"4 2\"; same format as SVG/CSS `stroke-dasharray`); leave empty for solid line"),
 	arrow: zod.z.enum([
 		"none",
 		"->",
@@ -15,17 +15,17 @@ var PathSchema = zod.z.object({
 	]).optional().describe("Path-level arrow direction. omitted/`none` = no arrows; `->` = arrow at end; `<-` = at start; `<->` = both."),
 	arrowDetail: require_arrow.ArrowDetailSchema.optional().describe("Detailed arrow visual config (shape / scale / length / width / color / fill / opacity / lineWidth) with optional `start` / `end` per-end overrides. Omitted = built-in defaults (shape `normal`, all visuals inherit from path stroke / opacity)."),
 	fill: zod.z.string().optional().describe("Fill color of the closed region; any CSS color. Omitted = no fill (stroke only). Pairs with `cycle` step for filled shapes."),
-	fillRule: zod.z.enum(["nonzero", "evenodd"]).optional().describe("How self-intersecting / nested sub-paths are filled. `nonzero` (default, SVG default) winds-by-direction; `evenodd` toggles fill on each crossing — useful for ring / donut shapes."),
+	fillRule: zod.z.enum(["nonzero", "evenodd"]).optional().describe("How self-intersecting / nested sub-paths are filled. `nonzero` (default) winds-by-direction; `evenodd` toggles fill on each crossing — useful for ring / donut shapes."),
 	lineCap: zod.z.enum([
 		"butt",
 		"round",
 		"square"
-	]).optional().describe("Stroke endpoint shape (SVG `stroke-linecap`). Default `butt` (sharp end); `round` adds a half-disc cap; `square` extends a half-stroke past the endpoint."),
+	]).optional().describe("Stroke endpoint shape (`butt` / `round` / `square`; same semantics as SVG/CSS `stroke-linecap`). Default `butt` (sharp end); `round` adds a half-disc cap; `square` extends a half-stroke past the endpoint."),
 	lineJoin: zod.z.enum([
 		"miter",
 		"round",
 		"bevel"
-	]).optional().describe("Stroke corner shape (SVG `stroke-linejoin`). Default `miter` (sharp corner); `round` rounds the join; `bevel` cuts the corner flat."),
+	]).optional().describe("Stroke corner shape (`miter` / `round` / `bevel`; same semantics as SVG/CSS `stroke-linejoin`). Default `miter` (sharp corner); `round` rounds the join; `bevel` cuts the corner flat."),
 	thickness: zod.z.enum([
 		"ultraThin",
 		"veryThin",