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

package/dist/lib/index.d.ts

@@ -2,11 +2,11 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/render/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
-export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, PATTERN_SHAPES, Boundary, BoundarySchema, AnimationProperty, AnimationEasing, AnimationDirection, AnimationFill, AnimationTrigger, AnimationTrackSchema, KeyframeSchema, TriggerSchema, EasingSchema, OriginSchema, } from './ir';
-export type { BoundaryKeyword, IRBoundary } from './ir';
-export type { BuiltinAnimationProperty, AnimationPropertyRef, AnimationEasingName, AnimationDirectionName, AnimationFillName, AnimationTriggerName, IRAnimationTrack, IRKeyframe, IRAnimationTrigger, IRAnimationOrigin, } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AtDirection, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirectionValue, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShapeValue, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, BuiltinShapeValue, NodeTextAlignValue, PatternShapeValue, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
+export { ArrowShape, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, BuiltinShape, NodeTextAlign, PatternShape, Boundary, BoundarySchema, AnimationProperty, AnimationEasing, AnimationDirection, AnimationFill, AnimationTrigger, AnimationTrackSchema, KeyframeSchema, TriggerSchema, EasingSchema, OriginSchema, } from './ir';
+export type { BoundaryValue, IRBoundary } from './ir';
+export type { BuiltinAnimationProperty, AnimationPropertyRef, AnimationEasingValue, AnimationDirectionValue, AnimationFillValue, AnimationTriggerValue, IRAnimationTrack, IRKeyframe, IRAnimationTrigger, IRAnimationOrigin, } from './ir';
 export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
 MovePathCommand, LinePathCommand, QuadPathCommand, CubicPathCommand, ArcPathCommand, EllipseArcPathCommand, ClosePathCommand, ArrowEndSpec, GroupPrim, Transform, 
@@ -24,16 +24,16 @@ export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayL
 export { parseWay, DrawWay, parseTargetSugar, parseNodeTarget } from './parsers';
 export { fadeIn, drawOn, scaleIn, grow, growUp, slideIn, colorShift, cameraTo, pulse, spin, loop, flash, blink, wiggle, stagger, } from './presets';
 export type { AnimationPresetOptions, ScaleInOptions, GrowUpOptions, SlideInOptions, ColorShiftOptions, CameraToOptions, PulseOptions, SpinOptions, LoopOptions, FlashOptions, BlinkOptions, WiggleOptions, } from './presets';
-export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
-export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
+export type { Position, CompassAnchorValue, AnchorInput, WebAnchorValue, Rect, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
+export { point, CompassAnchor, WebAnchor, normalizeCompassAnchor, rect, circle, ellipse, diamond, polar, } from './geometry';
 export type { ShapeDefinition, ShapeDefinitionInput, ShapeStyle } from './shapes';
 export { BUILTIN_SHAPES, defineShape, worldToLocal, localToWorld } from './shapes';
 export type { ArrowDefinition, ArrowEmitContext } from './arrows';
-export { BUILTIN_ARROWS } from './arrows';
+export { BUILTIN_ARROWS, defineArrow } from './arrows';
 export type { PatternDefinition, PatternEmitContext } from './patterns';
-export { BUILTIN_PATTERNS } from './patterns';
-export type { PathGeneratorDefinition, PathGeneratorContext } from './pathGenerators';
-export { definePathGenerator } from './pathGenerators';
+export { BUILTIN_PATTERNS, definePattern } from './patterns';
+export type { PathGeneratorDefinition, PathGeneratorContext } from './path-generators';
+export { definePathGenerator } from './path-generators';
 export type { CompositeDefinition } from './composites';
 export { defineComposite } from './composites';
 export type { ValueOf, AssertEqual } from './types';

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -22,7 +22,8 @@ export declare const AnimationProperty: {
     readonly ViewBox: "viewBox";
 };
 /** 内置可动画属性通道名联合 */
-export type BuiltinAnimationProperty = ValueOf<typeof AnimationProperty>;
+export type AnimationPropertyValue = ValueOf<typeof AnimationProperty>;
+export type BuiltinAnimationProperty = AnimationPropertyValue;
 /** 属性名：内置 ∪ 任意自定义字符串（`& {}` 保内置自动补全，同 NodeShape 范式）；自定义通道由后续 renderer 注册的插值器解释 */
 export type AnimationPropertyRef = BuiltinAnimationProperty | (string & {});
 /** 缓动具名预设（与 CSS 同名）；track / keyframe 亦可改用 cubic-bezier 四元组 */
@@ -34,7 +35,7 @@ export declare const AnimationEasing: {
     readonly EaseInOut: "ease-in-out";
 };
 /** 缓动预设名联合 */
-export type AnimationEasingName = ValueOf<typeof AnimationEasing>;
+export type AnimationEasingValue = ValueOf<typeof AnimationEasing>;
 /** 每次迭代的播放方向（抄 WAAPI / CSS animation-direction） */
 export declare const AnimationDirection: {
     readonly Normal: "normal";
@@ -43,7 +44,7 @@ export declare const AnimationDirection: {
     readonly AlternateReverse: "alternate-reverse";
 };
 /** 播放方向名联合 */
-export type AnimationDirectionName = ValueOf<typeof AnimationDirection>;
+export type AnimationDirectionValue = ValueOf<typeof AnimationDirection>;
 /** 活动区间外取值（抄 WAAPI / CSS animation-fill-mode） */
 export declare const AnimationFill: {
     readonly None: "none";
@@ -52,7 +53,7 @@ export declare const AnimationFill: {
     readonly Both: "both";
 };
 /** 填充模式名联合 */
-export type AnimationFillName = ValueOf<typeof AnimationFill>;
+export type AnimationFillValue = ValueOf<typeof AnimationFill>;
 export declare const EasingSchema: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>;
 export declare const KeyframeSchema: z.ZodObject<{
     at: z.ZodNumber;
@@ -74,7 +75,7 @@ export declare const AnimationTrigger: {
     readonly Manual: "manual";
 };
 /** 触发器关键字联合（不含 { onEvent } 对象形态） */
-export type AnimationTriggerName = ValueOf<typeof AnimationTrigger>;
+export type AnimationTriggerValue = ValueOf<typeof AnimationTrigger>;
 export declare const TriggerSchema: z.ZodUnion<[z.ZodNativeEnum<{
     readonly Load: "load";
     readonly Visible: "visible";

package/dist/lib/ir/animation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../../src/ir/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC;AACX,mBAAmB;AACnB,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACzE,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5E,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE,mDAAmD;AACnD,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,eAAO,MAAM,YAAY,mGAOtB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;EAgBgF,CAAC;AAE5G,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;CAAkE,CAAC;AAChG,oCAAoC;AACpC,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEpE,eAAO,MAAM,aAAa;;;;;;;;;;IAYvB,CAAC;AAEJ,eAAO,MAAM,YAAY,yEActB,CAAC;AAEJ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmF9B,CAAC;AAEJ,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,cAAc;AACd,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC7D,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../../src/ir/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC;AACX,mBAAmB;AACnB,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACvE,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC9D,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5E,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,mDAAmD;AACnD,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEzE,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAE/D,eAAO,MAAM,YAAY,mGAOtB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;EAgBgF,CAAC;AAE5G,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;CAAkE,CAAC;AAChG,oCAAoC;AACpC,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE,eAAO,MAAM,aAAa;;;;;;;;;;IAYvB,CAAC;AAEJ,eAAO,MAAM,YAAY,yEActB,CAAC;AAEJ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmF9B,CAAC;AAEJ,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,cAAc;AACd,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC7D,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

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

@@ -21,5 +21,5 @@ export declare const Boundary: {
     readonly Circle: "circle";
 };
 /** 连接面保留关键字联合（'shape' | 'circle'；其余取值为借用的 shape 引用） */
-export type BoundaryKeyword = ValueOf<typeof Boundary>;
+export type BoundaryValue = ValueOf<typeof Boundary>;
 //# sourceMappingURL=boundary.d.ts.map

package/dist/lib/ir/boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/ir/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,mEAAmE;AACnE,eAAO,MAAM,cAAc;;;;;;;;;IAIxB,CAAC;AAEJ,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ;IACnB,yBAAyB;;IAEzB,sDAAsD;;CAE9C,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/ir/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,mEAAmE;AACnE,eAAO,MAAM,cAAc;;;;;;;;;IAIxB,CAAC;AAEJ,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ;IACnB,yBAAyB;;IAEzB,sDAAsD;;CAE9C,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC"}

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

@@ -8,14 +8,14 @@ export declare const CoordinateSchema: z.ZodObject<{
     id: z.ZodString;
     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>;

package/dist/lib/ir/node.cjs

@@ -14,19 +14,19 @@ let zod = require("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 = 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)."),
+	position: zod.z.union([zod.z.nativeEnum(require_at_position.AtDirection), 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 12."),
 	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."),
@@ -65,9 +65,9 @@ var NodeSchema = zod.z.object({
 		require_offset_position.OffsetPositionSchema,
 		require_between_position.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: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: require_text.TextBlockSchema.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)."),
+	rotate: zod.z.number().finite().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
+	text: require_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: zod.z.nativeEnum(NodeTextAlign).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
 	lineHeight: zod.z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	maxTextWidth: zod.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: zod.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 = zod.z.object({
 	fillOpacity: zod.z.number().min(0).max(1).optional().describe("Fill opacity 0..1; affects only the shape fill, leaves stroke / text alone."),
 	stroke: zod.z.string().optional().describe("Border color of the node shape; any CSS color. Defaults to currentColor when omitted"),
 	drawOpacity: zod.z.number().min(0).max(1).optional().describe("Stroke opacity 0..1 (TikZ `draw opacity`); affects only the border."),
-	strokeWidth: zod.z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
-	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
-	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
-	dashArray: zod.z.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
+	strokeWidth: zod.z.number().finite().nonnegative().optional().describe("Border width in user units; defaults to 1 when omitted"),
+	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashPattern` takes precedence."),
+	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashPattern` and `dashed` take precedence."),
+	dashPattern: zod.z.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
 	cornerRadius: zod.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: zod.z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: zod.z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
@@ -90,15 +90,15 @@ var NodeSchema = zod.z.object({
 	opacity: zod.z.number().min(0).max(1).optional().describe("Whole-node opacity 0..1; applies uniformly to shape and text."),
 	innerXSep: zod.z.number().nonnegative().optional().describe("Inner horizontal padding from text to border in user units. Falls back to `padding` then default."),
 	innerYSep: zod.z.number().nonnegative().optional().describe("Inner vertical padding from text to border in user units. Falls back to `padding` then default."),
-	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`."),
+	outerSep: zod.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: 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."),
+	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer offset, alias for `outerSep` (TikZ `outer sep`); the axis-specific `outerSep` field takes precedence."),
 	font: require_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`."),
 	zIndex: zod.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
-exports.NODE_SHAPES = NODE_SHAPES;
-exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
+exports.BuiltinShape = BuiltinShape;
 exports.NodeLabelSchema = NodeLabelSchema;
 exports.NodeSchema = NodeSchema;
+exports.NodeTextAlign = NodeTextAlign;

package/dist/lib/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;