@retikz/core 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/lib/ir/node.cjs

@@ -1,21 +1,12 @@
 const require_position = require("./position/position.cjs");
 const require_polar_position = require("./position/polar-position.cjs");
+const require_at_position = require("./position/at-position.cjs");
+const require_offset_position = require("./position/offset-position.cjs");
 let zod = require("zod");
 //#region src/ir/node.ts
 /**
-* 节点形状常量。值是 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
 */
 var NODE_SHAPES = {
 	rectangle: "rectangle",
@@ -23,12 +14,7 @@ var NODE_SHAPES = {
 	ellipse: "ellipse",
 	diamond: "diamond"
 };
-/**
-* 节点字体规格——family / size / weight / style 全部可选；
-* 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
-*
-* 取代 alpha.1 的标量 `fontSize` 字段（已删）。
-*/
+/** 节点字体规格：family/size/weight/style 全部可选，透传 SVG `<text>` font-* 属性 */
 var FontSchema = zod.z.object({
 	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
 	size: zod.z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
@@ -38,16 +24,10 @@ var FontSchema = zod.z.object({
 		"italic",
 		"oblique"
 	]).optional().describe("CSS font-style")
-}).describe("Font properties for the node text label; all fields optional, nested object form (replaces the alpha.1 `fontSize` scalar).");
+}).describe("Font properties for the node text label; all fields optional, nested object form.");
 /**
-* 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
-*
-* 行级覆盖只生效于本行的 `<tspan>`：
-* - `fill`：仅这一行颜色
-* - `opacity`：仅这一行 0~1 透明度
-* - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
-*
-* 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
+* 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
+* @description 行级覆盖只生效于本行 `<tspan>`；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
 */
 var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
 	text: zod.z.string().describe("Line content"),
@@ -56,25 +36,38 @@ var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
 	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）：
-* - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
-* - `['Line 1', 'Line 2']` 两行无样式覆盖
-* - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
-*
-* 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
+* 节点文本：单字符串或非空多行 LineSpec 数组
+* @description 选数组而非 `\n` 字符串：JSON 友好无 escape，行级覆盖天然落字段
 */
 var NodeTextSchema = zod.z.union([zod.z.string(), zod.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=` 同义词 */
+/** 节点文本对齐（TikZ `align=` 同义） */
 var NODE_TEXT_ALIGNS = {
 	left: "left",
 	center: "center",
 	right: "right"
 };
+/**
+* 节点附属标签 label（TikZ `[label=above:foo]` 同义）
+* @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
+*/
+var NodeLabelSchema = zod.z.object({
+	text: zod.z.string().describe("Label text content; rendered as a single line."),
+	position: zod.z.union([zod.z.nativeEnum(require_at_position.AT_DIRECTIONS), zod.z.number()]).optional().describe("Placement around the node border: 8-direction enum (above / right / above-left / ...) or numeric angle in degrees (`label=30:foo` for radial placement). Default `above`. Numeric uses the polar convention (0° = +x, 90° = +y, screen-down)."),
+	distance: zod.z.number().nonnegative().optional().describe("Gap between the node border and the label center, in user units. Default 4."),
+	textColor: zod.z.string().optional().describe("Label text color; falls back to currentColor."),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Label-only opacity 0..1; multiplied with the node opacity if both are set."),
+	font: FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults.")
+}).describe("Extra text attached around a node border. Multiple labels supported via array form on `Node.label`.");
 var NodeSchema = zod.z.object({
 	type: zod.z.literal("node").describe("Discriminator marking this child as a node"),
 	id: zod.z.string().min(1).optional().describe("Optional unique id; required if any path needs to reference this node by string"),
 	shape: zod.z.nativeEnum(NODE_SHAPES).optional().describe("Node visual shape; defaults to `rectangle`. The boundary fully contains text + padding (circumscribed for circle / ellipse / diamond)."),
-	position: zod.z.union([require_position.PositionSchema, require_polar_position.PolarPositionSchema]).describe("Center point of the node content box; Cartesian [x, y] or polar (resolved at compile time)"),
+	position: zod.z.union([
+		require_position.PositionSchema,
+		require_polar_position.PolarPositionSchema,
+		require_at_position.AtPositionSchema,
+		require_offset_position.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: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
 	text: NodeTextSchema.optional(),
 	align: zod.z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
@@ -101,12 +94,14 @@ var NodeSchema = zod.z.object({
 	outerSep: zod.z.number().nonnegative().optional().describe("Outer margin from border to path attachment point in user units; does NOT change the visible border. Falls back to `margin`."),
 	padding: zod.z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
 	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
-	font: FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults.")
+	font: FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults."),
+	label: zod.z.union([NodeLabelSchema, zod.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
 exports.FontSchema = FontSchema;
 exports.LineSpecSchema = LineSpecSchema;
 exports.NODE_SHAPES = NODE_SHAPES;
 exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
+exports.NodeLabelSchema = NodeLabelSchema;
 exports.NodeSchema = NodeSchema;
 exports.NodeTextSchema = NodeTextSchema;

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,14 +10,9 @@ 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` 字段（已删）。
- */
+/** 节点字体规格：family/size/weight/style 全部可选，透传 SVG `<text>` font-* 属性 */
 export declare const FontSchema: z.ZodObject<{
     family: z.ZodOptional<z.ZodString>;
     size: z.ZodOptional<z.ZodNumber>;
@@ -45,17 +29,11 @@ export declare const FontSchema: z.ZodObject<{
     weight?: number | "normal" | "bold" | undefined;
     style?: "normal" | "italic" | "oblique" | undefined;
 }>;
-/** 节点字体规格（IR 层）——所有字段可选，编译期解析默认值 */
+/** 节点字体规格 IR 类型（所有字段可选，编译期解析默认值） */
 export type IRFont = z.infer<typeof FontSchema>;
 /**
- * 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
- *
- * 行级覆盖只生效于本行的 `<tspan>`：
- * - `fill`：仅这一行颜色
- * - `opacity`：仅这一行 0~1 透明度
- * - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
- *
- * 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
+ * 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
+ * @description 行级覆盖只生效于本行 `<tspan>`；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
  */
 export declare const LineSpecSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     text: z.ZodString;
@@ -98,15 +76,11 @@ export declare const LineSpecSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
 }>]>;
-/** 行规格 IR 类型（string 或对象） */
+/** 行规格 IR 类型 */
 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）；行级覆盖天然落字段。
+ * 节点文本：单字符串或非空多行 LineSpec 数组
+ * @description 选数组而非 `\n` 字符串：JSON 友好无 escape，行级覆盖天然落字段
  */
 export declare const NodeTextSchema: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
     text: z.ZodString;
@@ -149,14 +123,75 @@ export declare const NodeTextSchema: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUn
         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]` 同义）
+ * @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
+ */
+export declare const NodeLabelSchema: z.ZodObject<{
+    text: z.ZodString;
+    position: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
+        readonly above: "above";
+        readonly below: "below";
+        readonly left: "left";
+        readonly right: "right";
+        readonly 'above-left': "above-left";
+        readonly 'above-right': "above-right";
+        readonly 'below-left': "below-left";
+        readonly 'below-right': "below-right";
+    }>, z.ZodNumber]>>;
+    distance: z.ZodOptional<z.ZodNumber>;
+    textColor: 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;
+    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;
+    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;
+    textColor?: string | undefined;
+}>;
+/** Node label IR 类型 */
+export type IRNodeLabel = z.infer<typeof NodeLabelSchema>;
 export declare const NodeSchema: z.ZodObject<{
     type: z.ZodLiteral<"node">;
     id: z.ZodOptional<z.ZodString>;
@@ -166,7 +201,37 @@ export declare const NodeSchema: z.ZodObject<{
         readonly ellipse: "ellipse";
         readonly diamond: "diamond";
     }>>;
-    position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
+    position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodObject<{
+        direction: z.ZodNativeEnum<{
+            readonly above: "above";
+            readonly below: "below";
+            readonly left: "left";
+            readonly right: "right";
+            readonly 'above-left': "above-left";
+            readonly 'above-right': "above-right";
+            readonly 'below-left': "below-left";
+            readonly 'below-right': "below-right";
+        }>;
+        of: z.ZodString;
+        distance: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
+        of: string;
+        distance?: number | undefined;
+    }, {
+        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<{
         text: z.ZodString;
@@ -253,10 +318,131 @@ export declare const NodeSchema: z.ZodObject<{
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     }>>;
+    label: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        text: z.ZodString;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
+            readonly above: "above";
+            readonly below: "below";
+            readonly left: "left";
+            readonly right: "right";
+            readonly 'above-left': "above-left";
+            readonly 'above-right': "above-right";
+            readonly 'below-left': "below-left";
+            readonly 'below-right': "below-right";
+        }>, z.ZodNumber]>>;
+        distance: z.ZodOptional<z.ZodNumber>;
+        textColor: 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;
+        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;
+        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;
+        textColor?: string | undefined;
+    }>, z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
+            readonly above: "above";
+            readonly below: "below";
+            readonly left: "left";
+            readonly right: "right";
+            readonly 'above-left': "above-left";
+            readonly 'above-right': "above-right";
+            readonly 'below-left': "below-left";
+            readonly 'below-right': "below-right";
+        }>, z.ZodNumber]>>;
+        distance: z.ZodOptional<z.ZodNumber>;
+        textColor: 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;
+        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;
+        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;
+        textColor?: string | undefined;
+    }>, "many">]>>;
 }, "strip", z.ZodTypeAny, {
     type: "node";
-    position: [number, number] | import('./position').PolarPosition;
+    position: [number, number] | import('./position').PolarPosition | {
+        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;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    scale?: number | undefined;
+    opacity?: number | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -268,10 +454,33 @@ export declare const NodeSchema: z.ZodObject<{
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
     })[] | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | 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;
+        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;
+        textColor?: string | undefined;
+    }[] | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
-    opacity?: number | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
     font?: {
@@ -280,6 +489,7 @@ export declare const NodeSchema: z.ZodObject<{
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
+    textColor?: string | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
@@ -291,10 +501,8 @@ export declare const NodeSchema: z.ZodObject<{
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
     minimumSize?: number | undefined;
-    scale?: number | undefined;
     xScale?: number | undefined;
     yScale?: number | undefined;
-    textColor?: string | undefined;
     innerXSep?: number | undefined;
     innerYSep?: number | undefined;
     outerSep?: number | undefined;
@@ -302,8 +510,18 @@ export declare const NodeSchema: z.ZodObject<{
     margin?: number | undefined;
 }, {
     type: "node";
-    position: [number, number] | import('./position').PolarPosition;
+    position: [number, number] | import('./position').PolarPosition | {
+        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;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    scale?: number | undefined;
+    opacity?: number | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -315,10 +533,33 @@ export declare const NodeSchema: z.ZodObject<{
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
     })[] | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | 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;
+        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;
+        textColor?: string | undefined;
+    }[] | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
-    opacity?: number | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
     font?: {
@@ -327,6 +568,7 @@ export declare const NodeSchema: z.ZodObject<{
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
+    textColor?: string | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
@@ -338,16 +580,14 @@ export declare const NodeSchema: z.ZodObject<{
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
     minimumSize?: number | undefined;
-    scale?: number | undefined;
     xScale?: number | undefined;
     yScale?: number | undefined;
-    textColor?: string | undefined;
     innerXSep?: number | undefined;
     innerYSep?: number | undefined;
     outerSep?: number | undefined;
     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,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyKpB,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;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"}