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

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;AASxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoNpB,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,31 +1,32 @@
 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";
 import { BoundarySchema } from "./boundary.js";
 import { BetweenPositionSchema } from "./position/between-position.js";
 import { FontSchema } from "./font.js";
+import { AnimationTrackSchema } from "./animation.js";
 import { PaintSpecSchema } from "./paint.js";
 import { TextBlockSchema } from "./text.js";
 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]` 同义）
@@ -33,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."),
@@ -56,6 +57,7 @@ var NodeSchema = z.object({
 	shape: z.union([z.string().min(1), ShapeRefSchema]).optional().describe("Node visual shape: a bare name string (parameterless, e.g. \"rectangle\") or `{ type, params }` carrying a JSON params object (e.g. `{ type:\"sector\", params:{ innerRadius, outerRadius, startAngle, endAngle } }`). Built-in or registered via CompileOptions.shapes; unregistered type rejected at compile time. Defaults to \"rectangle\"."),
 	boundary: BoundarySchema.optional().describe("Default connection surface for edges meeting this node (see BoundarySchema). Defaults to \"shape\" (use the visual shape). Per-edge overridable via the edge endpoint `boundary` field."),
 	meta: JsonObjectSchema.optional().describe("Opaque provenance metadata carried by this element (e.g. a Tier 2 lowering tagging which datum / series / layer it came from). Provenance passthrough: preserved verbatim into the Scene primitive(s) this element emits, ignored by renderers, and never interpreted by the compiler — it does not affect layout, connection, style, or bounding box. Must be a JSON object (fully serializable). Not inherited across scopes; not part of the every-X style defaults."),
+	animations: z.array(AnimationTrackSchema).optional().describe("Declarative timeline animation tracks for this element (fadeIn / drawOn / pulse / …). Each track animates one renderer-agnostic property over normalized time; the element base value is the settled (animation-end) state. Carried verbatim into the Scene primitive(s) this element emits; renderers play them or, when unable, render the static settled state with a diagnosable warning. Does not affect layout / bounding box (animations may transiently overflow). Not inherited across scopes; not part of the every-X style defaults."),
 	position: z.union([
 		PositionSchema,
 		PolarPositionSchema,
@@ -63,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."),
@@ -73,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."),
@@ -88,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"}

package/dist/es/ir/paint.js

@@ -5,10 +5,10 @@ import { z } from "zod";
 * @description 内置 3 motif：`lines`（横向阴影线）/ `dots`（波点）/ `grid`（横竖网格）。
 *   各 motif 的 tile 几何由 `BUILTIN_PATTERNS` 的 `PatternDefinition.emit` 在 compile 期产出。
 */
-var PATTERN_SHAPES = {
-	lines: "lines",
-	dots: "dots",
-	grid: "grid"
+var PatternShape = {
+	Lines: "lines",
+	Dots: "dots",
+	Grid: "grid"
 };
 /**
 * 渐变 stop：位置 + 颜色 + 可选透明度
@@ -24,20 +24,20 @@ var GradientStopSchema = z.object({
 * @description 四种 paint server：linear / radial gradient、pattern（图案）、image（图片）。纯 JSON 形态，保 IR 可序列化。
 *   linear 方向用 `angle`（度，polar 约定：0°=+x，90°=+y 屏幕下）；radial 的 `center` / `radius` 用 objectBoundingBox（0..1，随形状缩放）。
 */
-var PaintSpecSchema = z.discriminatedUnion("type", [
+var PaintSpecSchema = z.discriminatedUnion("kind", [
 	z.object({
-		type: z.literal("linearGradient"),
+		kind: z.literal("linearGradient"),
 		stops: z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
 		angle: z.number().finite().optional().describe("Gradient direction in degrees (polar convention; 0°=+x, 90°=+y screen-down); omitted = renderer default (left→right)")
 	}).describe("Linear gradient paint server"),
 	z.object({
-		type: z.literal("radialGradient"),
+		kind: z.literal("radialGradient"),
 		stops: z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
 		center: z.tuple([z.number().finite(), z.number().finite()]).optional().describe("Center in objectBoundingBox units (0..1 relative to the filled shape); omitted = (0.5, 0.5)"),
 		radius: z.number().finite().positive().optional().describe("Radius in objectBoundingBox units (0..1); omitted = 0.5")
 	}).describe("Radial gradient paint server"),
 	z.object({
-		type: z.literal("pattern"),
+		kind: z.literal("pattern"),
 		shape: z.string().min(1).describe("Registered pattern motif name; built-in `lines` (hatching) / `dots` / `grid` (crosshatch), or an extension motif registered via `CompileOptions.patterns`. Any non-empty string passes schema validation; unregistered names are rejected at compile time."),
 		color: z.string().optional().describe("Motif color; any CSS color, defaults to `currentColor`"),
 		background: z.string().optional().describe("Tile background fill; omitted = transparent"),
@@ -46,7 +46,7 @@ var PaintSpecSchema = z.discriminatedUnion("type", [
 		rotation: z.number().finite().optional().describe("Rotate the whole pattern, in degrees")
 	}).describe("Pattern paint server (hatching / dots / grid)"),
 	z.object({
-		type: z.literal("image"),
+		kind: z.literal("image"),
 		href: z.string().min(1).describe("Image URL (http(s) or data URI)"),
 		fit: z.enum([
 			"fill",
@@ -56,4 +56,4 @@ var PaintSpecSchema = z.discriminatedUnion("type", [
 	}).describe("Image paint server (fills the shape with an image)")
 ]).describe("Paint server spec: gradient / pattern / image. Solid color stays a plain string on `fill` / `stroke`.");
 //#endregion
-export { GradientStopSchema, PATTERN_SHAPES, PaintSpecSchema };
+export { GradientStopSchema, PaintSpecSchema, PatternShape };

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

@@ -2,29 +2,30 @@ import { z } from 'zod';
 import { ValueOf } from '../../types';
 /**
  * 箭头形状常量（用 const 而非 TS enum 避免 reverse-mapping 和字面量不互通）
- * @description normal 实心三角；open 空心三角（UML 泛化/继承）；stealth 尖锐倒钩（默认）；diamond 实心菱形（UML 组合）；openDiamond 空心菱形（聚合）；circle 实心圆点；openCircle 空心圆点
+ * @description normal 实心三角；open 空心三角（UML 泛化/继承）；stealth 尖锐倒钩（默认）；openStealth 空心倒钩；diamond 实心菱形（UML 组合）；openDiamond 空心菱形（聚合）；circle 实心圆点；openCircle 空心圆点
  */
-export declare const ARROW_SHAPES: {
-    readonly normal: "normal";
-    readonly open: "open";
-    readonly stealth: "stealth";
-    readonly diamond: "diamond";
-    readonly openDiamond: "openDiamond";
-    readonly circle: "circle";
-    readonly openCircle: "openCircle";
+export declare const ArrowShape: {
+    readonly Normal: "normal";
+    readonly Open: "open";
+    readonly Stealth: "stealth";
+    readonly OpenStealth: "openStealth";
+    readonly Diamond: "diamond";
+    readonly OpenDiamond: "openDiamond";
+    readonly Circle: "circle";
+    readonly OpenCircle: "openCircle";
 };
 /** 箭头形状字面量类型 */
-export type ArrowShape = ValueOf<typeof ARROW_SHAPES>;
+export type ArrowShapeValue = ValueOf<typeof ArrowShape>;
 /**
- * 内置 7 箭头名联合
+ * 内置 8 箭头名联合
  * @description `BUILTIN_ARROWS` 的 Record key（保穷尽性约束，不随 `ArrowShapeName` 开放而退化为 `string`）；
  *   等价于历史 `ArrowShape`，独立命名对齐 `node.ts` 的 `BuiltinShapeName` 范式
  */
-export type BuiltinArrowName = ValueOf<typeof ARROW_SHAPES>;
+export type BuiltinArrowName = ArrowShapeValue;
 /**
  * 箭头形状名：开放字符串
  * @description 内置 `BuiltinArrowName`，或经 `CompileOptions.arrows` 注册的扩展箭头名；
- *   `& {}` 让 IDE 仍对内置 7 名自动补全，同时接受任意非空字符串（对齐 `node.ts` 的 `NodeShape`）
+ *   `& {}` 让 IDE 仍对内置 8 名自动补全，同时接受任意非空字符串（对齐 `node.ts` 的 `NodeShape`）
  */
 export type ArrowShapeName = BuiltinArrowName | (string & {});
 /** 箭头默认形状 */
@@ -33,7 +34,7 @@ export declare const DEFAULT_ARROW_SHAPE: "stealth";
  * 空心 shape 集合（fill 字段在这些 shape 上 silent no-op）
  * @description compile 与 render 都引用此表判定 fill 是否丢弃；空心 shape 用 color 主导描边、lineWidth 控描边粗
  */
-export declare const HOLLOW_ARROW_SHAPES: Set<ArrowShape>;
+export declare const HOLLOW_ARROW_SHAPES: Set<ArrowShapeValue>;
 /** 箭头默认尺寸（length / width 的 fallback） */
 export declare const ARROW_MARKER_DEFAULT_SIZE = 6;
 /** 空心 shape 描边默认粗细（lineWidth fallback） */
@@ -55,20 +56,20 @@ export declare const ArrowEndDetailSchema: z.ZodObject<{
     length?: number | undefined;
     fill?: string | undefined;
     shape?: string | undefined;
-    color?: string | undefined;
     opacity?: number | undefined;
+    scale?: number | undefined;
+    color?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
-    scale?: number | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
     shape?: string | undefined;
-    color?: string | undefined;
     opacity?: number | undefined;
+    scale?: number | undefined;
+    color?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
-    scale?: number | undefined;
 }>;
 /**
  * Path 级箭头详细配置 schema
@@ -97,20 +98,20 @@ export declare const ArrowDetailSchema: z.ZodObject<{
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     }>>;
     end: z.ZodOptional<z.ZodObject<{
         shape: z.ZodOptional<z.ZodString>;
@@ -125,78 +126,78 @@ export declare const ArrowDetailSchema: z.ZodObject<{
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
     shape?: string | undefined;
-    color?: string | undefined;
     opacity?: number | undefined;
+    scale?: number | undefined;
+    color?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
-    scale?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     } | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
     shape?: string | undefined;
-    color?: string | undefined;
     opacity?: number | undefined;
+    scale?: number | undefined;
+    color?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
-    scale?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
         shape?: string | undefined;
-        color?: string | undefined;
         opacity?: number | undefined;
+        scale?: number | undefined;
+        color?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
-        scale?: number | undefined;
     } | undefined;
 }>;
 /** 端点级箭头视觉规格 */

package/dist/es/ir/path/arrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE9D,aAAa;AACb,eAAO,MAAM,mBAAmB,WAAuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAA6D,CAAC;AAE9F,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgE9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE9D,aAAa;AACb,eAAO,MAAM,mBAAmB,WAAqB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,sBAAqH,CAAC;AAEtJ,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgE9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/es/ir/path/arrow.js

@@ -2,27 +2,29 @@ import { z } from "zod";
 //#region src/ir/path/arrow.ts
 /**
 * 箭头形状常量（用 const 而非 TS enum 避免 reverse-mapping 和字面量不互通）
-* @description normal 实心三角；open 空心三角（UML 泛化/继承）；stealth 尖锐倒钩（默认）；diamond 实心菱形（UML 组合）；openDiamond 空心菱形（聚合）；circle 实心圆点；openCircle 空心圆点
+* @description normal 实心三角；open 空心三角（UML 泛化/继承）；stealth 尖锐倒钩（默认）；openStealth 空心倒钩；diamond 实心菱形（UML 组合）；openDiamond 空心菱形（聚合）；circle 实心圆点；openCircle 空心圆点
 */
-var ARROW_SHAPES = {
-	normal: "normal",
-	open: "open",
-	stealth: "stealth",
-	diamond: "diamond",
-	openDiamond: "openDiamond",
-	circle: "circle",
-	openCircle: "openCircle"
+var ArrowShape = {
+	Normal: "normal",
+	Open: "open",
+	Stealth: "stealth",
+	OpenStealth: "openStealth",
+	Diamond: "diamond",
+	OpenDiamond: "openDiamond",
+	Circle: "circle",
+	OpenCircle: "openCircle"
 };
 /** 箭头默认形状 */
-var DEFAULT_ARROW_SHAPE = ARROW_SHAPES.stealth;
+var DEFAULT_ARROW_SHAPE = ArrowShape.Stealth;
 /**
 * 空心 shape 集合（fill 字段在这些 shape 上 silent no-op）
 * @description compile 与 render 都引用此表判定 fill 是否丢弃；空心 shape 用 color 主导描边、lineWidth 控描边粗
 */
 var HOLLOW_ARROW_SHAPES = new Set([
-	"open",
-	"openDiamond",
-	"openCircle"
+	ArrowShape.Open,
+	ArrowShape.OpenStealth,
+	ArrowShape.OpenDiamond,
+	ArrowShape.OpenCircle
 ]);
 /** 箭头默认尺寸（length / width 的 fallback） */
 var ARROW_MARKER_DEFAULT_SIZE = 6;
@@ -33,12 +35,12 @@ var ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
 * @description 顶层 8 字段全 optional；fill 在空心 shape 上 silent no-op（schema 不拒绝、compile/render 丢字段）；start/end 子对象用相同字段集（无 start/end 递归）
 */
 var ArrowEndDetailSchema = z.object({
-	shape: z.string().min(1).optional().describe("Registered arrow name: built-in 7 (`normal` / `open` / `stealth` / `diamond` / `openDiamond` / `circle` / `openCircle`) or an extension arrow registered via `CompileOptions.arrows`. Any non-empty string passes schema validation; unregistered names are rejected at compile time (throw). Defaults to `stealth`."),
+	shape: z.string().min(1).optional().describe("Registered arrow name: built-in 8 (`normal` / `open` / `stealth` / `openStealth` / `diamond` / `openDiamond` / `circle` / `openCircle`) or an extension arrow registered via `CompileOptions.arrows`. Any non-empty string passes schema validation; unregistered names are rejected at compile time (throw). Defaults to `stealth`."),
 	scale: z.number().finite().positive().optional().describe("Uniform tip scale factor; multiplies `length` and `width` (e.g. `length=10, scale=1.5` → effective 15). Defaults to 1."),
 	length: z.number().finite().nonnegative().optional().describe("Tip length in user units (the dimension along the path direction). Defaults to ~6."),
 	width: z.number().finite().nonnegative().optional().describe("Tip width in user units (perpendicular to the path). Defaults to ~6."),
 	color: z.string().optional().describe("Stroke color override. When omitted, the renderer should inherit the path stroke."),
-	fill: 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."),
+	fill: z.string().optional().describe("Fill color override (effective only on solid shapes). Hollow shapes (`open` / `openStealth` / `openDiamond` / `openCircle`) silently ignore this field — `color` drives the stroke."),
 	opacity: z.number().min(0).max(1).optional().describe("Arrow opacity 0..1, independent from the path opacity. When omitted, inherits the path opacity."),
 	lineWidth: z.number().finite().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.");
@@ -51,4 +53,4 @@ var ArrowDetailSchema = ArrowEndDetailSchema.extend({
 	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
-export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, ArrowDetailSchema, ArrowEndDetailSchema, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES };
+export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ArrowDetailSchema, ArrowEndDetailSchema, ArrowShape, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES };