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

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

@@ -2,19 +2,20 @@ import { z } from 'zod';
 import { ValueOf } from '../types';
 /**
  * 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
- * @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 45° preset 别名（`{ type:'polygon', params:{ sides:4, rotate:45 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
+ * @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 preset 别名（`{ type:'polygon', params:{ sides:4, rotate:0 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
  */
-export declare const NODE_SHAPES: {
-    readonly rectangle: "rectangle";
-    readonly circle: "circle";
-    readonly ellipse: "ellipse";
-    readonly diamond: "diamond";
+export declare const BuiltinShape: {
+    readonly Rectangle: "rectangle";
+    readonly Circle: "circle";
+    readonly Ellipse: "ellipse";
+    readonly Diamond: "diamond";
 };
 /**
  * 内置 4 shape 名联合
  * @description `BUILTIN_SHAPES` 的 Record key（保穷尽性约束，不随 `NodeShape` 开放而退化为 `string`）
  */
-export type BuiltinShapeName = ValueOf<typeof NODE_SHAPES>;
+export type BuiltinShapeValue = ValueOf<typeof BuiltinShape>;
+export type BuiltinShapeName = BuiltinShapeValue;
 /**
  * 节点形状名：开放字符串
  * @description 内置 `BuiltinShapeName`，或经 `CompileOptions.shapes` 注册的扩展 shape 名；
@@ -22,12 +23,12 @@ export type BuiltinShapeName = ValueOf<typeof NODE_SHAPES>;
  */
 export type NodeShape = BuiltinShapeName | (string & {});
 /** 节点文本对齐（TikZ `align=` 同义） */
-export declare const NODE_TEXT_ALIGNS: {
-    readonly left: "left";
-    readonly center: "center";
-    readonly right: "right";
+export declare const NodeTextAlign: {
+    readonly Left: "left";
+    readonly Center: "center";
+    readonly Right: "right";
 };
-export type NodeTextAlign = ValueOf<typeof NODE_TEXT_ALIGNS>;
+export type NodeTextAlignValue = ValueOf<typeof NodeTextAlign>;
 /**
  * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
  * @description 可挂多个；label 不参与 layout。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=12
@@ -35,14 +36,14 @@ export type NodeTextAlign = ValueOf<typeof NODE_TEXT_ALIGNS>;
 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";
+        readonly Above: "above";
+        readonly Below: "below";
+        readonly Left: "left";
+        readonly Right: "right";
+        readonly AboveLeft: "above-left";
+        readonly AboveRight: "above-right";
+        readonly BelowLeft: "below-left";
+        readonly BelowRight: "below-right";
     }>, z.ZodNumber]>>;
     distance: z.ZodOptional<z.ZodNumber>;
     textColor: z.ZodOptional<z.ZodString>;
@@ -265,14 +266,14 @@ export declare const NodeSchema: z.ZodObject<{
     }>, "many">>;
     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";
+            readonly Above: "above";
+            readonly Below: "below";
+            readonly Left: "left";
+            readonly Right: "right";
+            readonly AboveLeft: "above-left";
+            readonly AboveRight: "above-right";
+            readonly BelowLeft: "below-left";
+            readonly BelowRight: "below-right";
         }>;
         of: z.ZodString;
         distance: z.ZodOptional<z.ZodNumber>;
@@ -337,15 +338,15 @@ export declare const NodeSchema: z.ZodObject<{
         } | undefined;
     }>]>, "many">]>>;
     align: z.ZodOptional<z.ZodNativeEnum<{
-        readonly left: "left";
-        readonly center: "center";
-        readonly right: "right";
+        readonly Left: "left";
+        readonly Center: "center";
+        readonly Right: "right";
     }>>;
     lineHeight: z.ZodOptional<z.ZodNumber>;
     maxTextWidth: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
-    fill: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-        type: z.ZodLiteral<"linearGradient">;
+    fill: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"linearGradient">;
         stops: z.ZodArray<z.ZodObject<{
             offset: z.ZodNumber;
             color: z.ZodString;
@@ -361,7 +362,7 @@ export declare const NodeSchema: z.ZodObject<{
         }>, "many">;
         angle: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        type: "linearGradient";
+        kind: "linearGradient";
         stops: {
             offset: number;
             color: string;
@@ -369,7 +370,7 @@ export declare const NodeSchema: z.ZodObject<{
         }[];
         angle?: number | undefined;
     }, {
-        type: "linearGradient";
+        kind: "linearGradient";
         stops: {
             offset: number;
             color: string;
@@ -377,7 +378,7 @@ export declare const NodeSchema: z.ZodObject<{
         }[];
         angle?: number | undefined;
     }>, z.ZodObject<{
-        type: z.ZodLiteral<"radialGradient">;
+        kind: z.ZodLiteral<"radialGradient">;
         stops: z.ZodArray<z.ZodObject<{
             offset: z.ZodNumber;
             color: z.ZodString;
@@ -394,7 +395,7 @@ export declare const NodeSchema: z.ZodObject<{
         center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
         radius: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        type: "radialGradient";
+        kind: "radialGradient";
         stops: {
             offset: number;
             color: string;
@@ -403,7 +404,7 @@ export declare const NodeSchema: z.ZodObject<{
         radius?: number | undefined;
         center?: [number, number] | undefined;
     }, {
-        type: "radialGradient";
+        kind: "radialGradient";
         stops: {
             offset: number;
             color: string;
@@ -412,7 +413,7 @@ export declare const NodeSchema: z.ZodObject<{
         radius?: number | undefined;
         center?: [number, number] | undefined;
     }>, z.ZodObject<{
-        type: z.ZodLiteral<"pattern">;
+        kind: z.ZodLiteral<"pattern">;
         shape: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
         background: z.ZodOptional<z.ZodString>;
@@ -420,31 +421,31 @@ export declare const NodeSchema: z.ZodObject<{
         lineWidth: z.ZodOptional<z.ZodNumber>;
         rotation: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        type: "pattern";
         shape: string;
+        kind: "pattern";
         size?: number | undefined;
         color?: string | undefined;
         background?: string | undefined;
         lineWidth?: number | undefined;
         rotation?: number | undefined;
     }, {
-        type: "pattern";
         shape: string;
+        kind: "pattern";
         size?: number | undefined;
         color?: string | undefined;
         background?: string | undefined;
         lineWidth?: number | undefined;
         rotation?: number | undefined;
     }>, z.ZodObject<{
-        type: z.ZodLiteral<"image">;
+        kind: z.ZodLiteral<"image">;
         href: z.ZodString;
         fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "cover"]>>;
     }, "strip", z.ZodTypeAny, {
-        type: "image";
+        kind: "image";
         href: string;
         fit?: "fill" | "contain" | "cover" | undefined;
     }, {
-        type: "image";
+        kind: "image";
         href: string;
         fit?: "fill" | "contain" | "cover" | undefined;
     }>]>]>>;
@@ -454,7 +455,7 @@ export declare const NodeSchema: z.ZodObject<{
     strokeWidth: z.ZodOptional<z.ZodNumber>;
     dashed: z.ZodOptional<z.ZodBoolean>;
     dotted: z.ZodOptional<z.ZodBoolean>;
-    dashArray: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
     cornerRadius: z.ZodOptional<z.ZodNumber>;
     minimumWidth: z.ZodOptional<z.ZodNumber>;
     minimumHeight: z.ZodOptional<z.ZodNumber>;
@@ -488,14 +489,14 @@ export declare const NodeSchema: z.ZodObject<{
     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";
+            readonly Above: "above";
+            readonly Below: "below";
+            readonly Left: "left";
+            readonly Right: "right";
+            readonly AboveLeft: "above-left";
+            readonly AboveRight: "above-right";
+            readonly BelowLeft: "below-left";
+            readonly BelowRight: "below-right";
         }>, z.ZodNumber]>>;
         distance: z.ZodOptional<z.ZodNumber>;
         textColor: z.ZodOptional<z.ZodString>;
@@ -572,14 +573,14 @@ export declare const NodeSchema: z.ZodObject<{
     }>, 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";
+            readonly Above: "above";
+            readonly Below: "below";
+            readonly Left: "left";
+            readonly Right: "right";
+            readonly AboveLeft: "above-left";
+            readonly AboveRight: "above-right";
+            readonly BelowLeft: "below-left";
+            readonly BelowRight: "below-right";
         }>, z.ZodNumber]>>;
         distance: z.ZodOptional<z.ZodNumber>;
         textColor: z.ZodOptional<z.ZodString>;
@@ -655,7 +656,7 @@ export declare const NodeSchema: z.ZodObject<{
         } | undefined;
     }>, "many">]>>;
     zIndex: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     type: "node";
     position: [number, number] | import('./position').PolarPosition | {
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
@@ -666,7 +667,7 @@ export declare const NodeSchema: z.ZodObject<{
         offset: [number, number];
     } | import('./position').IRBetweenPosition;
     fill?: string | {
-        type: "linearGradient";
+        kind: "linearGradient";
         stops: {
             offset: number;
             color: string;
@@ -674,7 +675,7 @@ export declare const NodeSchema: z.ZodObject<{
         }[];
         angle?: number | undefined;
     } | {
-        type: "radialGradient";
+        kind: "radialGradient";
         stops: {
             offset: number;
             color: string;
@@ -683,15 +684,15 @@ export declare const NodeSchema: z.ZodObject<{
         radius?: number | undefined;
         center?: [number, number] | undefined;
     } | {
-        type: "pattern";
         shape: string;
+        kind: "pattern";
         size?: number | undefined;
         color?: string | undefined;
         background?: string | undefined;
         lineWidth?: number | undefined;
         rotation?: number | undefined;
     } | {
-        type: "image";
+        kind: "image";
         href: string;
         fit?: "fill" | "contain" | "cover" | undefined;
     } | undefined;
@@ -787,6 +788,7 @@ export declare const NodeSchema: z.ZodObject<{
             onEvent: string;
         } | undefined;
     }[] | undefined;
+    dashPattern?: number[] | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
     zIndex?: number | undefined;
@@ -795,7 +797,6 @@ export declare const NodeSchema: z.ZodObject<{
     maxTextWidth?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
-    dashArray?: number[] | undefined;
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
     minimumSize?: number | undefined;
@@ -817,7 +818,7 @@ export declare const NodeSchema: z.ZodObject<{
         offset: [number, number];
     } | import('./position').IRBetweenPosition;
     fill?: string | {
-        type: "linearGradient";
+        kind: "linearGradient";
         stops: {
             offset: number;
             color: string;
@@ -825,7 +826,7 @@ export declare const NodeSchema: z.ZodObject<{
         }[];
         angle?: number | undefined;
     } | {
-        type: "radialGradient";
+        kind: "radialGradient";
         stops: {
             offset: number;
             color: string;
@@ -834,15 +835,15 @@ export declare const NodeSchema: z.ZodObject<{
         radius?: number | undefined;
         center?: [number, number] | undefined;
     } | {
-        type: "pattern";
         shape: string;
+        kind: "pattern";
         size?: number | undefined;
         color?: string | undefined;
         background?: string | undefined;
         lineWidth?: number | undefined;
         rotation?: number | undefined;
     } | {
-        type: "image";
+        kind: "image";
         href: string;
         fit?: "fill" | "contain" | "cover" | undefined;
     } | undefined;
@@ -938,6 +939,7 @@ export declare const NodeSchema: z.ZodObject<{
             onEvent: string;
         } | undefined;
     }[] | undefined;
+    dashPattern?: number[] | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
     zIndex?: number | undefined;
@@ -946,7 +948,6 @@ export declare const NodeSchema: z.ZodObject<{
     maxTextWidth?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
-    dashArray?: number[] | undefined;
     minimumWidth?: number | undefined;
     minimumHeight?: number | undefined;
     minimumSize?: 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;AAUxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0NpB,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;AAUxC;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,+BAA+B;AAC/B,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAE/D;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgOpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/es/ir/node.js

@@ -1,6 +1,6 @@
 import { PositionSchema } from "./position/position.js";
 import { PolarPositionSchema } from "./position/polar-position.js";
-import { AT_DIRECTIONS, AtPositionSchema } from "./position/at-position.js";
+import { AtDirection, AtPositionSchema } from "./position/at-position.js";
 import { OffsetPositionSchema } from "./position/offset-position.js";
 import { JsonObjectSchema } from "./json.js";
 import { ShapeRefSchema } from "./shape.js";
@@ -14,19 +14,19 @@ import { z } from "zod";
 //#region src/ir/node.ts
 /**
 * 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
-* @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 45° preset 别名（`{ type:'polygon', params:{ sides:4, rotate:45 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
+* @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 preset 别名（`{ type:'polygon', params:{ sides:4, rotate:0 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
 */
-var NODE_SHAPES = {
-	rectangle: "rectangle",
-	circle: "circle",
-	ellipse: "ellipse",
-	diamond: "diamond"
+var BuiltinShape = {
+	Rectangle: "rectangle",
+	Circle: "circle",
+	Ellipse: "ellipse",
+	Diamond: "diamond"
 };
 /** 节点文本对齐（TikZ `align=` 同义） */
-var NODE_TEXT_ALIGNS = {
-	left: "left",
-	center: "center",
-	right: "right"
+var NodeTextAlign = {
+	Left: "left",
+	Center: "center",
+	Right: "right"
 };
 /**
 * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
@@ -34,7 +34,7 @@ var NODE_TEXT_ALIGNS = {
 */
 var NodeLabelSchema = z.object({
 	text: z.string().describe("Label text content; rendered as a single line."),
-	position: z.union([z.nativeEnum(AT_DIRECTIONS), 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)."),
+	position: z.union([z.nativeEnum(AtDirection), 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: z.number().nonnegative().optional().describe("Gap between the node border and the label center, in user units. Default 12."),
 	textColor: z.string().optional().describe("Label text color; falls back to currentColor."),
 	opacity: z.number().min(0).max(1).optional().describe("Label-only opacity 0..1; multiplied with the node opacity if both are set."),
@@ -65,9 +65,9 @@ var NodeSchema = z.object({
 		OffsetPositionSchema,
 		BetweenPositionSchema
 	]).describe("Center point of the node content box; Cartesian [x, y], polar, relative-to-another-node (`at`-style with `direction` / `of` / `distance?`), offset from a base point (`{ of, offset }` form mirroring TikZ `calc`), or between two endpoints (`{ between: [A, B], t }` proportional point). All non-Cartesian forms resolve at compile time."),
-	rotate: z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: 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)."),
+	rotate: z.number().finite().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
+	text: TextBlockSchema.optional().describe("Optional node text content; accepts a string, an array of lines, or styled text line objects. A literal newline (\"\\n\") inside any string is a hard line break, so one string with newlines renders as multiple lines. When omitted the node emits only its shape primitive; when present it participates in text measurement, node box sizing, and TextPrim emission."),
+	align: z.nativeEnum(NodeTextAlign).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."),
@@ -75,10 +75,10 @@ var NodeSchema = z.object({
 	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."),
-	strokeWidth: z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
-	dashed: z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
-	dotted: z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
-	dashArray: z.array(z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
+	strokeWidth: z.number().finite().nonnegative().optional().describe("Border width in user units; defaults to 1 when omitted"),
+	dashed: z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashPattern` takes precedence."),
+	dotted: z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashPattern` and `dashed` take precedence."),
+	dashPattern: z.array(z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
 	cornerRadius: z.number().nonnegative().optional().describe("Migration-period top-level corner radius in user units; only effective on `rectangle` shape. Prefer the shape params form `{ type: \"rectangle\", params: { cornerRadius } }`."),
 	minimumWidth: z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
@@ -90,12 +90,12 @@ var NodeSchema = z.object({
 	opacity: z.number().min(0).max(1).optional().describe("Whole-node opacity 0..1; applies uniformly to shape and text."),
 	innerXSep: z.number().nonnegative().optional().describe("Inner horizontal padding from text to border in user units. Falls back to `padding` then default."),
 	innerYSep: z.number().nonnegative().optional().describe("Inner vertical padding from text to border in user units. Falls back to `padding` then default."),
-	outerSep: 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`."),
+	outerSep: z.number().nonnegative().optional().describe("Uniform outer offset (TikZ `outer sep`) around the node connection boundary, in user units. Applies to ALL border references — automatic edge endpoints AND explicit compass/angle anchors (e.g. `A.north`, `A.30`) — and is included in the node layout footprint / viewBox. Does NOT change the visible shape; center, shape-specific anchors, edge points, and label attachment stay on the visual shape. Default 0. Falls back to `margin`."),
 	padding: z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
-	margin: z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
+	margin: z.number().nonnegative().optional().describe("Symmetric outer offset, alias for `outerSep` (TikZ `outer sep`); the axis-specific `outerSep` 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."),
 	label: z.union([NodeLabelSchema, z.array(NodeLabelSchema)]).optional().describe("Extra label(s) attached around the node border (TikZ `[label=above:foo]`); single object or array form. Compiled into one TextPrim per label, positioned by `position` direction / angle and `distance`."),
 	zIndex: z.number().int().finite().optional().describe("Explicit stacking order among sibling IR children. Higher draws on top. Omitted = 0 = source order. Sorting is stable: same zIndex keeps source order. Scoped per group (a node inside a scope only restacks within that scope).")
-}).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
+}).strict().describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
-export { NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema };
+export { BuiltinShape, NodeLabelSchema, NodeSchema, NodeTextAlign };

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

@@ -5,16 +5,17 @@ import { ValueOf } from '../types';
  * @description 内置 3 motif：`lines`（横向阴影线）/ `dots`（波点）/ `grid`（横竖网格）。
  *   各 motif 的 tile 几何由 `BUILTIN_PATTERNS` 的 `PatternDefinition.emit` 在 compile 期产出。
  */
-export declare const PATTERN_SHAPES: {
-    readonly lines: "lines";
-    readonly dots: "dots";
-    readonly grid: "grid";
+export declare const PatternShape: {
+    readonly Lines: "lines";
+    readonly Dots: "dots";
+    readonly Grid: "grid";
 };
 /**
  * 内置 3 pattern motif 名联合
  * @description `BUILTIN_PATTERNS` 的 Record key（保穷尽性约束，不随 `PatternShapeName` 开放而退化为 `string`）
  */
-export type BuiltinPatternName = ValueOf<typeof PATTERN_SHAPES>;
+export type PatternShapeValue = ValueOf<typeof PatternShape>;
+export type BuiltinPatternName = PatternShapeValue;
 /**
  * pattern motif 名：开放字符串
  * @description 内置 `BuiltinPatternName`，或经 `CompileOptions.patterns` 注册的扩展 motif 名；
@@ -43,8 +44,8 @@ export declare const GradientStopSchema: z.ZodObject<{
  * @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">;
+export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"linearGradient">;
     stops: z.ZodArray<z.ZodObject<{
         offset: z.ZodNumber;
         color: z.ZodString;
@@ -60,7 +61,7 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     }>, "many">;
     angle: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    type: "linearGradient";
+    kind: "linearGradient";
     stops: {
         offset: number;
         color: string;
@@ -68,7 +69,7 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     }[];
     angle?: number | undefined;
 }, {
-    type: "linearGradient";
+    kind: "linearGradient";
     stops: {
         offset: number;
         color: string;
@@ -76,7 +77,7 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     }[];
     angle?: number | undefined;
 }>, z.ZodObject<{
-    type: z.ZodLiteral<"radialGradient">;
+    kind: z.ZodLiteral<"radialGradient">;
     stops: z.ZodArray<z.ZodObject<{
         offset: z.ZodNumber;
         color: z.ZodString;
@@ -93,7 +94,7 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     radius: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    type: "radialGradient";
+    kind: "radialGradient";
     stops: {
         offset: number;
         color: string;
@@ -102,7 +103,7 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     radius?: number | undefined;
     center?: [number, number] | undefined;
 }, {
-    type: "radialGradient";
+    kind: "radialGradient";
     stops: {
         offset: number;
         color: string;
@@ -111,7 +112,7 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     radius?: number | undefined;
     center?: [number, number] | undefined;
 }>, z.ZodObject<{
-    type: z.ZodLiteral<"pattern">;
+    kind: z.ZodLiteral<"pattern">;
     shape: z.ZodString;
     color: z.ZodOptional<z.ZodString>;
     background: z.ZodOptional<z.ZodString>;
@@ -119,31 +120,31 @@ export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObje
     lineWidth: z.ZodOptional<z.ZodNumber>;
     rotation: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    type: "pattern";
     shape: string;
+    kind: "pattern";
     size?: number | undefined;
     color?: string | undefined;
     background?: string | undefined;
     lineWidth?: number | undefined;
     rotation?: number | undefined;
 }, {
-    type: "pattern";
     shape: string;
+    kind: "pattern";
     size?: number | undefined;
     color?: string | undefined;
     background?: string | undefined;
     lineWidth?: number | undefined;
     rotation?: number | undefined;
 }>, z.ZodObject<{
-    type: z.ZodLiteral<"image">;
+    kind: z.ZodLiteral<"image">;
     href: z.ZodString;
     fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "cover"]>>;
 }, "strip", z.ZodTypeAny, {
-    type: "image";
+    kind: "image";
     href: string;
     fit?: "fill" | "contain" | "cover" | undefined;
 }, {
-    type: "image";
+    kind: "image";
     href: string;
     fit?: "fill" | "contain" | "cover" | undefined;
 }>]>;

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

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/ir/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAMY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEwF,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"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/ir/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAMY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEwF,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"}