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

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

@@ -1,19 +1,8 @@
 import { z } from 'zod';
 import { ValueOf } from '../types';
 /**
- * 节点形状常量。值是 IR 中 `shape` 字段的字面字符串；
- * 用 const + ValueOf 派生（不用 TS enum）。
- *
- * - `rectangle`：矩形（默认；UML 类、流程图常规节点）
- * - `circle`：圆形（流程图起止、状态机）
- * - `ellipse`：椭圆（状态机、集合图）
- * - `diamond`：菱形（流程图判定）
- *
- * 每个 shape 的几何语义：node 的视觉边界包住"text 矩形 + padding"——
- * - rectangle: 视觉 rect = text rect
- * - circle:    外接圆，r = √(innerHalfW² + innerHalfH²)
- * - ellipse:   外接椭圆，rx = innerHalfW×√2、ry = innerHalfH×√2
- * - diamond:   外接菱形，halfA = 2×innerHalfW、halfB = 2×innerHalfH
+ * 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
+ * @description rectangle 默认；circle/ellipse/diamond 几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；circle: r=√(innerHalfW²+innerHalfH²)；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2；diamond: halfA=2×innerHalfW,halfB=2×innerHalfH
  */
 export declare const NODE_SHAPES: {
     readonly rectangle: "rectangle";
@@ -21,152 +10,18 @@ export declare const NODE_SHAPES: {
     readonly ellipse: "ellipse";
     readonly diamond: "diamond";
 };
-/** 节点形状字面量类型，由 `NODE_SHAPES` 派生 */
+/** 节点形状字面量类型 */
 export type NodeShape = ValueOf<typeof NODE_SHAPES>;
-/**
- * 节点字体规格——family / size / weight / style 全部可选；
- * 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
- *
- * 取代 alpha.1 的标量 `fontSize` 字段（已删）。
- */
-export declare const FontSchema: z.ZodObject<{
-    family: z.ZodOptional<z.ZodString>;
-    size: z.ZodOptional<z.ZodNumber>;
-    weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
-    style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
-}, "strip", z.ZodTypeAny, {
-    family?: string | undefined;
-    size?: number | undefined;
-    weight?: number | "normal" | "bold" | undefined;
-    style?: "normal" | "italic" | "oblique" | undefined;
-}, {
-    family?: string | undefined;
-    size?: number | undefined;
-    weight?: number | "normal" | "bold" | undefined;
-    style?: "normal" | "italic" | "oblique" | undefined;
-}>;
-/** 节点字体规格（IR 层）——所有字段可选，编译期解析默认值 */
-export type IRFont = z.infer<typeof FontSchema>;
-/**
- * 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
- *
- * 行级覆盖只生效于本行的 `<tspan>`：
- * - `fill`：仅这一行颜色
- * - `opacity`：仅这一行 0~1 透明度
- * - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
- *
- * 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
- */
-export declare const LineSpecSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
-    text: z.ZodString;
-    fill: z.ZodOptional<z.ZodString>;
-    opacity: z.ZodOptional<z.ZodNumber>;
-    font: z.ZodOptional<z.ZodObject<{
-        family: z.ZodOptional<z.ZodString>;
-        size: z.ZodOptional<z.ZodNumber>;
-        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
-        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
-    }, "strip", z.ZodTypeAny, {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    }, {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    text: string;
-    fill?: string | undefined;
-    opacity?: number | undefined;
-    font?: {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    } | undefined;
-}, {
-    text: string;
-    fill?: string | undefined;
-    opacity?: number | undefined;
-    font?: {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    } | undefined;
-}>]>;
-/** 行规格 IR 类型（string 或对象） */
-export type IRLineSpec = z.infer<typeof LineSpecSchema>;
-/**
- * 节点文本——单行字符串或非空多行数组（每元素一个 LineSpec）：
- * - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
- * - `['Line 1', 'Line 2']` 两行无样式覆盖
- * - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
- *
- * 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
- */
-export declare const NodeTextSchema: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
-    text: z.ZodString;
-    fill: z.ZodOptional<z.ZodString>;
-    opacity: z.ZodOptional<z.ZodNumber>;
-    font: z.ZodOptional<z.ZodObject<{
-        family: z.ZodOptional<z.ZodString>;
-        size: z.ZodOptional<z.ZodNumber>;
-        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
-        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
-    }, "strip", z.ZodTypeAny, {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    }, {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    text: string;
-    fill?: string | undefined;
-    opacity?: number | undefined;
-    font?: {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    } | undefined;
-}, {
-    text: string;
-    fill?: string | undefined;
-    opacity?: number | undefined;
-    font?: {
-        family?: string | undefined;
-        size?: number | undefined;
-        weight?: number | "normal" | "bold" | undefined;
-        style?: "normal" | "italic" | "oblique" | undefined;
-    } | undefined;
-}>]>, "many">]>;
-/** 节点文本对齐（多行内文本对齐）——TikZ `align=` 同义词 */
+/** 节点文本对齐（TikZ `align=` 同义） */
 export declare const NODE_TEXT_ALIGNS: {
     readonly left: "left";
     readonly center: "center";
     readonly right: "right";
 };
-/** 多行文本对齐字面量类型 */
 export type NodeTextAlign = ValueOf<typeof NODE_TEXT_ALIGNS>;
 /**
- * 节点附属标签（label）——TikZ `[label=above:foo]` / `[label={[red]30:foo}]` 同义。
- *
- * 一个 Node 可挂多个 label（数组形态）；label 自身不参与 viewBox（视觉外延少时可接受）。
- *
- * `position` 接受两种形态：
- * - 8 方向枚举（`above` / `right` / `above-left` ...）：标签贴在 node 该方向边界外
- * - 数字角度：以 node 中心为原点，按该角度方向投射；约定与 polar 一致（0° = +x，90° = +y 屏幕下方）
- *
- * 默认 `position = 'above'`，`distance = 4`（user units，标签与 node 边界的距离）。
+ * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
+ * @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
  */
 export declare const NodeLabelSchema: z.ZodObject<{
     text: z.ZodString;
@@ -202,7 +57,6 @@ export declare const NodeLabelSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     distance?: number | undefined;
-    position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
     opacity?: number | undefined;
     font?: {
         family?: string | undefined;
@@ -210,11 +64,11 @@ export declare const NodeLabelSchema: z.ZodObject<{
         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;
-    position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
     opacity?: number | undefined;
     font?: {
         family?: string | undefined;
@@ -222,9 +76,10 @@ export declare const NodeLabelSchema: z.ZodObject<{
         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 类型——单条 label 的字段集 */
+/** Node label IR 类型 */
 export type IRNodeLabel = z.infer<typeof NodeLabelSchema>;
 export declare const NodeSchema: z.ZodObject<{
     type: z.ZodLiteral<"node">;
@@ -256,6 +111,15 @@ export declare const NodeSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     }>]>;
     rotate: z.ZodOptional<z.ZodNumber>;
     text: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -377,7 +241,6 @@ export declare const NodeSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         text: string;
         distance?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -385,11 +248,11 @@ export declare const NodeSchema: z.ZodObject<{
             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;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -397,6 +260,7 @@ export declare const NodeSchema: z.ZodObject<{
             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;
@@ -432,7 +296,6 @@ export declare const NodeSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         text: string;
         distance?: number | undefined;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -440,11 +303,11 @@ export declare const NodeSchema: z.ZodObject<{
             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;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -452,6 +315,7 @@ export declare const NodeSchema: z.ZodObject<{
             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, {
@@ -460,6 +324,9 @@ export declare const NodeSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    } | {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     };
     fill?: string | undefined;
     text?: string | (string | {
@@ -473,10 +340,18 @@ 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;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -484,11 +359,11 @@ export declare const NodeSchema: z.ZodObject<{
             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;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -496,20 +371,13 @@ export declare const NodeSchema: z.ZodObject<{
             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;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
-    opacity?: 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;
@@ -522,7 +390,6 @@ export declare const NodeSchema: z.ZodObject<{
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
     minimumSize?: number | undefined;
-    scale?: number | undefined;
     xScale?: number | undefined;
     yScale?: number | undefined;
     innerXSep?: number | undefined;
@@ -536,6 +403,9 @@ export declare const NodeSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    } | {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     };
     fill?: string | undefined;
     text?: string | (string | {
@@ -549,10 +419,18 @@ 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;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -560,11 +438,11 @@ export declare const NodeSchema: z.ZodObject<{
             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;
-        position?: number | "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right" | undefined;
         opacity?: number | undefined;
         font?: {
             family?: string | undefined;
@@ -572,20 +450,13 @@ export declare const NodeSchema: z.ZodObject<{
             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;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
-    opacity?: 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;
@@ -598,7 +469,6 @@ export declare const NodeSchema: z.ZodObject<{
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
     minimumSize?: number | undefined;
-    scale?: number | undefined;
     xScale?: number | undefined;
     yScale?: number | undefined;
     innerXSep?: number | undefined;
@@ -607,6 +477,6 @@ export declare const NodeSchema: z.ZodObject<{
     padding?: number | undefined;
     margin?: number | undefined;
 }>;
-/** 节点：可定位的形状容器（矩形 / 圆 / 椭圆 / 菱形）+ 可选文本标签 */
+/** 节点：可定位的形状容器（矩形/圆/椭圆/菱形）+ 可选文本标签 */
 export type IRNode = z.infer<typeof NodeSchema>;
 //# sourceMappingURL=node.d.ts.map

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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,mCAAmC;AACnC,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAwBpB,CAAC;AAEJ,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBxB,CAAC;AAEJ,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAIxB,CAAC;AAEJ,yCAAyC;AACzC,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+KpB,CAAC;AAEJ,4CAA4C;AAC5C,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.cjs

@@ -1,16 +1,8 @@
+let zod = require("zod");
 //#region src/ir/path/arrow.ts
 /**
-* 箭头形状常量。值就是 IR / Scene 中 arrow 字段的字面字符串；
-* 用 const 而不是 TS enum——避免 enum 在数值场景生成 reverse-mapping、
-* 在 string 场景与字面量类型不互通的两个坑。
-*
-* - `normal`：实心三角（默认；最常见）
-* - `open`：空心三角（UML 泛化 / 继承）
-* - `stealth`：尖锐倒钩三角（流图常见、视觉锐利）
-* - `diamond`：实心菱形（UML 组合）
-* - `openDiamond`：空心菱形（UML 聚合）
-* - `circle`：实心圆点（连接点 / dot end）
-* - `openCircle`：空心圆点（白圈 / o-end）
+* 箭头形状常量（用 const 而非 TS enum 避免 reverse-mapping 和字面量不互通）
+* @description normal 实心三角（默认）；open 空心三角（UML 泛化/继承）；stealth 尖锐倒钩；diamond 实心菱形（UML 组合）；openDiamond 空心菱形（聚合）；circle 实心圆点；openCircle 空心圆点
 */
 var ARROW_SHAPES = {
 	normal: "normal",
@@ -21,5 +13,45 @@ var ARROW_SHAPES = {
 	circle: "circle",
 	openCircle: "openCircle"
 };
+/**
+* 空心 shape 集合（fill 字段在这些 shape 上 silent no-op）
+* @description compile 与 render 都引用此表判定 fill 是否丢弃；空心 shape 用 color 主导描边、lineWidth 控描边粗
+*/
+var HOLLOW_ARROW_SHAPES = new Set([
+	"open",
+	"openDiamond",
+	"openCircle"
+]);
+/** marker 默认尺寸（length / width 的 fallback；arrowMarkers viewBox 内的几何也按 10 单位定义） */
+var ARROW_MARKER_DEFAULT_SIZE = 6;
+/** 空心 shape 描边默认粗细（lineWidth fallback；refX / shrink 计算都用它做"back stroke 半宽"） */
+var ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
+/**
+* 端点级箭头视觉规格 schema
+* @description 顶层 8 字段全 optional；fill 在空心 shape 上 silent no-op（schema 不拒绝、compile/render 丢字段）；start/end 子对象用相同字段集（无 start/end 递归）
+*/
+var ArrowEndDetailSchema = zod.z.object({
+	shape: zod.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: zod.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: zod.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: zod.z.number().nonnegative().optional().describe("Tip width in user units (perpendicular to the path). Defaults to ~6 (matching the legacy hardcoded markerHeight)."),
+	color: zod.z.string().optional().describe("Stroke color override. When omitted, the marker inherits the path stroke via `context-stroke`."),
+	fill: zod.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: zod.z.number().min(0).max(1).optional().describe("Arrow opacity 0..1, independent from the path opacity. When omitted, inherits the path opacity."),
+	lineWidth: zod.z.number().nonnegative().optional().describe("Stroke width for hollow shapes (user units). Defaults to 1.5. Solid shapes ignore this field.")
+}).describe("Per-end arrow visual spec: shape + visual fields (scale / length / width / color / fill / opacity / lineWidth). All optional; omitted fields fall through to top-level `arrowDetail` defaults and then built-in defaults.");
+/**
+* Path 级箭头详细配置 schema
+* @description 顶层视觉字段（与 `ArrowEndDetailSchema` 同字段集）作为起末共享默认；`start` / `end` 子对象逐字段 merge 顶层（缺省字段继承，已填字段 override）
+*/
+var ArrowDetailSchema = ArrowEndDetailSchema.extend({
+	start: ArrowEndDetailSchema.optional().describe("Start-end override (effective only when `arrow` includes a start arrow: `<-` / `<->`). Fields merge into the top-level defaults; omitted fields inherit, present fields override."),
+	end: ArrowEndDetailSchema.optional().describe("End-end override (effective only when `arrow` includes an end arrow: `->` / `<->`). Fields merge into the top-level defaults; omitted fields inherit, present fields override.")
+}).describe("Path-level arrow detail. Top-level visual fields (shape / scale / length / width / color / fill / opacity / lineWidth) act as shared defaults for both ends; `start` / `end` sub-objects per-field override the defaults.");
 //#endregion
+exports.ARROW_MARKER_DEFAULT_SIZE = ARROW_MARKER_DEFAULT_SIZE;
+exports.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH;
 exports.ARROW_SHAPES = ARROW_SHAPES;
+exports.ArrowDetailSchema = ArrowDetailSchema;
+exports.ArrowEndDetailSchema = ArrowEndDetailSchema;
+exports.HOLLOW_ARROW_SHAPES = HOLLOW_ARROW_SHAPES;