@retikz/core 0.2.0-alpha.6 → 0.2.0-alpha.8

package/dist/es/geometry/bend.js

@@ -14,5 +14,30 @@ var bendControlPoints = (from, to, direction, bendAngle) => {
 	const ctlOffset = 4 / 3 * (chord * Math.tan(bendAngle * Math.PI / 180 / 2));
 	return [[from[0] + dx / 3 + ctlOffset * nx, from[1] + dy / 3 + ctlOffset * ny], [from[0] + 2 * dx / 3 + ctlOffset * nx, from[1] + 2 * dy / 3 + ctlOffset * ny]];
 };
+/** 默认 looseness（looseness 缺省时） */
+var DEFAULT_LOOSENESS = 1;
+/** self-loop（from==to）默认环大小（user units，受 looseness 缩放） */
+var DEFAULT_LOOP_SIZE = 1;
+/** 直边 cubic 控制点距离系数（chord 的几分之一） */
+var OUTIN_DISTANCE_FACTOR = 1 / 3;
+/** 角度（度）转单位方向向量（0°=+x，90°=+y screen-down，与 IR 角度约定一致） */
+var dirOf = (angleDeg) => {
+	const rad = angleDeg * Math.PI / 180;
+	return [Math.cos(rad), Math.sin(rad)];
+};
+/**
+* out/in 角 + looseness 拟合 from→to 的非对称 cubic（含 self-loop 退化）
+* @description 标准 TikZ：control1 = from + d·dir(outAngle)，control2 = to + d·dir(inAngle)；
+*   d = looseness × distance，distance = chord × 系数（chord>0）或默认环大小（self-loop，from==to chord=0）。
+*   self-loop 时两控制点沿 out/in 两个不同方向各自从端点撑开，画出环（bend 对称弯在 chord=0 时退化为点，故 out/in 是自环唯一手段）。
+*/
+var outInControlPoints = (from, to, outAngle, inAngle, looseness) => {
+	const k = looseness ?? DEFAULT_LOOSENESS;
+	const chord = Math.hypot(to[0] - from[0], to[1] - from[1]);
+	const d = k * (chord === 0 ? DEFAULT_LOOP_SIZE : chord * OUTIN_DISTANCE_FACTOR);
+	const outDir = dirOf(outAngle);
+	const inDir = dirOf(inAngle);
+	return [[from[0] + d * outDir[0], from[1] + d * outDir[1]], [to[0] + d * inDir[0], to[1] + d * inDir[1]]];
+};
 //#endregion
-export { bendControlPoints };
+export { bendControlPoints, outInControlPoints };

package/dist/es/index.d.ts

@@ -2,14 +2,18 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, } 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, } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, 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, } 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, } 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, 
 /** 3 个 named Transform 分支 */
-TranslateTransform, RotateTransform, ScaleTransform, Layout, Scene, } from './primitive';
+TranslateTransform, RotateTransform, ScaleTransform, Layout, Scene, PaintValue, SceneResource, 
+/** 已解析 pattern tile（emit-in-compile 产物，进 Scene 资源，纯数据无函数） */
+ResolvedPatternTile, 
+/** marker 窄子集（ArrowDefinition.emit 产物，renderer-agnostic） */
+MarkerPrimitive, MarkerPathPrim, MarkerEllipsePrim, MarkerRectPrim, MarkerGroupPrim, MarkerPathCommand, MarkerFill, } from './primitive';
 export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, CompileWarning, } from './compile';
 export { computeLayout, fallbackMeasurer, compileToScene } from './compile';
 export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayLabelOp, } from './parsers';
@@ -18,5 +22,11 @@ export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPositio
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
 export type { ShapeDefinition, ShapeStyle } from './shapes';
 export { BUILTIN_SHAPES, worldToLocal, localToWorld } from './shapes';
+export type { ArrowDefinition, ArrowEmitContext } from './arrows';
+export { BUILTIN_ARROWS } from './arrows';
+export type { PatternDefinition, PatternEmitContext } from './patterns';
+export { BUILTIN_PATTERNS } from './patterns';
+export type { PathGeneratorDefinition, PathGeneratorContext } from './pathGenerators';
+export { definePathGenerator } from './pathGenerators';
 export type { ValueOf, AssertEqual } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,EAAE,EACF,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,WAAW,EACX,gBAAgB,GACjB,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW;AACX,oDAAoD;AACpD,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,SAAS;AACT,6BAA6B;AAC7B,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,MAAM,EACN,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5E,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjF,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGtE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,EACP,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,EAAE,EACF,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,SAAS,EACT,YAAY,GACb,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW;AACX,oDAAoD;AACpD,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,SAAS;AACT,6BAA6B;AAC7B,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,MAAM,EACN,KAAK,EACL,UAAU,EACV,aAAa;AACb,6DAA6D;AAC7D,mBAAmB;AACnB,4DAA4D;AAC5D,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5E,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjF,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGtE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/es/index.js

@@ -3,12 +3,14 @@ import { PolarPositionSchema } from "./ir/position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./ir/position/at-position.js";
 import { OffsetPositionSchema } from "./ir/position/offset-position.js";
 import { FontSchema } from "./ir/font.js";
+import { JsonObjectSchema, JsonValueSchema } from "./ir/json.js";
+import { GradientStopSchema, PATTERN_SHAPES, PaintSpecSchema } from "./ir/paint.js";
 import { LineSpecSchema, TextBlockSchema } from "./ir/text.js";
 import { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, ArrowDetailSchema, ArrowEndDetailSchema, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES } from "./ir/path/arrow.js";
 import { localToWorld, worldToLocal } from "./geometry/_transform.js";
 import { RECT_ANCHORS, rect } from "./geometry/rect.js";
 import { AnchorRefSchema, NodeTargetSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, TargetSchema } from "./ir/path/target.js";
-import { ArcStepSchema, BendStepSchema, CirclePathStepSchema, ControlPointSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, EllipsePathStepSchema, FoldStepSchema, LineStepSchema, MoveStepSchema, RectangleStepSchema, StepLabelSchema, StepSchema } from "./ir/path/step.js";
+import { ArcStepSchema, BendStepSchema, CirclePathStepSchema, ControlPointSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, EllipsePathStepSchema, FoldStepSchema, GeneratorStepSchema, LineStepSchema, MoveStepSchema, RectangleStepSchema, StepLabelSchema, StepSchema } from "./ir/path/step.js";
 import { PathSchema } from "./ir/path/path.js";
 import { NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema } from "./ir/node.js";
 import { CoordinateSchema } from "./ir/coordinate.js";
@@ -19,6 +21,8 @@ import { circle } from "./geometry/circle.js";
 import { ellipse } from "./geometry/ellipse.js";
 import { diamond } from "./geometry/diamond.js";
 import { BUILTIN_SHAPES } from "./shapes/index.js";
+import { BUILTIN_ARROWS } from "./arrows/index.js";
+import { BUILTIN_PATTERNS } from "./patterns/index.js";
 import { fallbackMeasurer } from "./compile/text-metrics.js";
 import { computeLayout } from "./compile/layout.js";
 import { compileToScene } from "./compile/compile.js";
@@ -27,4 +31,5 @@ import { parseTargetSugar } from "./parsers/parseTargetSugar.js";
 import { DrawWay, parseWay } from "./parsers/parseWay.js";
 import { polar } from "./geometry/polar.js";
 import { point } from "./geometry/point.js";
-export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, AT_DIRECTIONS, AnchorRefSchema, ArcStepSchema, ArrowDefaultSchema, ArrowDetailSchema, ArrowEndDetailSchema, AtPositionSchema, BUILTIN_SHAPES, BendStepSchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DEFAULT_ARROW_SHAPE, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, HOLLOW_ARROW_SHAPES, LabelDefaultSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeDefaultSchema, NodeLabelSchema, NodeSchema, NodeTargetSchema, OffsetPositionSchema, PathDefaultSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RectangleStepSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, ScopeSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, TransformSchema, circle, compileToScene, computeLayout, diamond, ellipse, fallbackMeasurer, localToWorld, parseNodeTarget, parseTargetSugar, parseWay, point, polar, rect, worldToLocal };
+import { definePathGenerator } from "./pathGenerators/define.js";
+export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, AT_DIRECTIONS, AnchorRefSchema, ArcStepSchema, ArrowDefaultSchema, ArrowDetailSchema, ArrowEndDetailSchema, AtPositionSchema, BUILTIN_ARROWS, BUILTIN_PATTERNS, BUILTIN_SHAPES, BendStepSchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DEFAULT_ARROW_SHAPE, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, GeneratorStepSchema, GradientStopSchema, HOLLOW_ARROW_SHAPES, JsonObjectSchema, JsonValueSchema, LabelDefaultSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeDefaultSchema, NodeLabelSchema, NodeSchema, NodeTargetSchema, OffsetPositionSchema, PATTERN_SHAPES, PaintSpecSchema, PathDefaultSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RectangleStepSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, ScopeSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, TransformSchema, circle, compileToScene, computeLayout, definePathGenerator, diamond, ellipse, fallbackMeasurer, localToWorld, parseNodeTarget, parseTargetSugar, parseWay, point, polar, rect, worldToLocal };

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

@@ -1,5 +1,7 @@
 export * from './position';
 export * from './font';
+export * from './json';
+export * from './paint';
 export * from './text';
 export * from './path';
 export * from './node';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * 递归 JSON 值 schema
+ * @description 守 IR 100% JSON 可序列化：path generator step 的 params 只能由 JSON 值构成；
+ *   函数 / undefined / class 实例 / Symbol / Map / Set 等非 JSON 值在 parse 阶段被拒。
+ *   `z.lazy` 让 array / object 分支可递归引用本 schema，深度不限。
+ */
+export declare const JsonValueSchema: z.ZodType<JsonValue>;
+/**
+ * JSON 对象 schema
+ * @description path generator step 的 `params` 类型；键为字符串、值为递归 JSON 值。
+ *   作为 compile 运行时的第二道护栏：即便外部 `paramsSchema` 是宽松类型，对其 parse 结果再跑本 schema
+ *   可拦下非 JSON 输出（function / undefined 等）。core 公开供外部 refine。
+ */
+export declare const JsonObjectSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>>;
+/** 单个 JSON 值（字符串 / 数字 / 布尔 / null / 数组 / 对象，递归） */
+export type JsonValue = string | number | boolean | null | Array<JsonValue> | {
+    [key: string]: JsonValue;
+};
+/** JSON 对象类型（path generator step 的 params 形态） */
+export type IRJsonObject = z.infer<typeof JsonObjectSchema>;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/ir/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAahD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,yEAI1B,CAAC;AAEJ,mDAAmD;AACnD,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,KAAK,CAAC,SAAS,CAAC,GAChB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/es/ir/json.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+//#region src/ir/json.ts
+/**
+* 递归 JSON 值 schema
+* @description 守 IR 100% JSON 可序列化：path generator step 的 params 只能由 JSON 值构成；
+*   函数 / undefined / class 实例 / Symbol / Map / Set 等非 JSON 值在 parse 阶段被拒。
+*   `z.lazy` 让 array / object 分支可递归引用本 schema，深度不限。
+*/
+var JsonValueSchema = z.lazy(() => z.union([
+	z.string(),
+	z.number().finite(),
+	z.boolean(),
+	z.null(),
+	z.array(JsonValueSchema),
+	JsonObjectSchema
+]).describe("A JSON value: string, finite number, boolean, null, an array of JSON values, or an object of JSON values. Recursive with no depth limit. Functions, undefined, Symbol, class instances, Map, and Set are rejected to keep the IR fully JSON-serializable."));
+/**
+* JSON 对象 schema
+* @description path generator step 的 `params` 类型；键为字符串、值为递归 JSON 值。
+*   作为 compile 运行时的第二道护栏：即便外部 `paramsSchema` 是宽松类型，对其 parse 结果再跑本 schema
+*   可拦下非 JSON 输出（function / undefined 等）。core 公开供外部 refine。
+*/
+var JsonObjectSchema = z.record(JsonValueSchema).describe("A JSON object: string keys mapping to recursive JSON values. Used as the params payload of a path generator step and as the runtime guard that the value is fully JSON-serializable. No maximum depth or size is enforced.");
+//#endregion
+export { JsonObjectSchema, JsonValueSchema };

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

@@ -65,6 +65,19 @@ export declare const NodeLabelSchema: z.ZodObject<{
     }>>;
     rotate: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["none", "radial", "tangent"]>, z.ZodNumber]>>;
     keepUpright: z.ZodOptional<z.ZodBoolean>;
+    pin: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    }, {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
     distance?: number | undefined;
@@ -79,6 +92,11 @@ export declare const NodeLabelSchema: z.ZodObject<{
     textColor?: string | undefined;
     rotate?: number | "none" | "radial" | "tangent" | undefined;
     keepUpright?: boolean | undefined;
+    pin?: boolean | {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    } | undefined;
 }, {
     text: string;
     distance?: number | undefined;
@@ -93,6 +111,11 @@ export declare const NodeLabelSchema: z.ZodObject<{
     textColor?: string | undefined;
     rotate?: number | "none" | "radial" | "tangent" | undefined;
     keepUpright?: boolean | undefined;
+    pin?: boolean | {
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        dashPattern?: number[] | undefined;
+    } | undefined;
 }>;
 /** Node label IR 类型 */
 export type IRNodeLabel = z.infer<typeof NodeLabelSchema>;
@@ -179,8 +202,112 @@ export declare const NodeSchema: z.ZodObject<{
         readonly right: "right";
     }>>;
     lineHeight: z.ZodOptional<z.ZodNumber>;
+    maxTextWidth: z.ZodOptional<z.ZodNumber>;
     color: z.ZodOptional<z.ZodString>;
-    fill: z.ZodOptional<z.ZodString>;
+    fill: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"linearGradient">;
+        stops: z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodString;
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }>, "many">;
+        angle: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    }, {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"radialGradient">;
+        stops: z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodString;
+            opacity: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }, {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }>, "many">;
+        center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        radius: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    }, {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"pattern">;
+        shape: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        lineWidth: z.ZodOptional<z.ZodNumber>;
+        rotation: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "pattern";
+        shape: string;
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    }, {
+        type: "pattern";
+        shape: string;
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        href: z.ZodString;
+        fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "cover"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    }, {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    }>]>]>>;
     fillOpacity: z.ZodOptional<z.ZodNumber>;
     stroke: z.ZodOptional<z.ZodString>;
     drawOpacity: z.ZodOptional<z.ZodNumber>;
@@ -251,6 +378,19 @@ export declare const NodeSchema: z.ZodObject<{
         }>>;
         rotate: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["none", "radial", "tangent"]>, z.ZodNumber]>>;
         keepUpright: z.ZodOptional<z.ZodBoolean>;
+        pin: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            stroke: z.ZodOptional<z.ZodString>;
+            strokeWidth: z.ZodOptional<z.ZodNumber>;
+            dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         distance?: number | undefined;
@@ -265,6 +405,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }, {
         text: string;
         distance?: number | undefined;
@@ -279,6 +424,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }>, z.ZodArray<z.ZodObject<{
         text: z.ZodString;
         position: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
@@ -312,6 +462,19 @@ export declare const NodeSchema: z.ZodObject<{
         }>>;
         rotate: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["none", "radial", "tangent"]>, z.ZodNumber]>>;
         keepUpright: z.ZodOptional<z.ZodBoolean>;
+        pin: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            stroke: z.ZodOptional<z.ZodString>;
+            strokeWidth: z.ZodOptional<z.ZodNumber>;
+            dashPattern: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }, {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         distance?: number | undefined;
@@ -326,6 +489,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }, {
         text: string;
         distance?: number | undefined;
@@ -340,6 +508,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }>, "many">]>>;
     zIndex: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -352,7 +525,39 @@ export declare const NodeSchema: z.ZodObject<{
         of: string | [number, number] | import('./position').PolarPosition;
         offset: [number, number];
     };
-    fill?: string | undefined;
+    fill?: string | {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    } | {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    } | {
+        type: "pattern";
+        shape: string;
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    } | {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    } | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    shape?: string | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -364,16 +569,13 @@ export declare const NodeSchema: z.ZodObject<{
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
     })[] | undefined;
-    opacity?: number | undefined;
     font?: {
         family?: string | undefined;
         size?: number | undefined;
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
-    shape?: string | undefined;
     scale?: number | undefined;
-    color?: string | undefined;
     id?: string | undefined;
     textColor?: string | undefined;
     label?: {
@@ -390,6 +592,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     } | {
         text: string;
         distance?: number | undefined;
@@ -404,6 +611,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }[] | undefined;
     roundedCorners?: number | undefined;
     stroke?: string | undefined;
@@ -414,6 +626,7 @@ export declare const NodeSchema: z.ZodObject<{
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
     lineHeight?: number | undefined;
+    maxTextWidth?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
     dashArray?: number[] | undefined;
@@ -437,7 +650,39 @@ export declare const NodeSchema: z.ZodObject<{
         of: string | [number, number] | import('./position').PolarPosition;
         offset: [number, number];
     };
-    fill?: string | undefined;
+    fill?: string | {
+        type: "linearGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        angle?: number | undefined;
+    } | {
+        type: "radialGradient";
+        stops: {
+            offset: number;
+            color: string;
+            opacity?: number | undefined;
+        }[];
+        radius?: number | undefined;
+        center?: [number, number] | undefined;
+    } | {
+        type: "pattern";
+        shape: string;
+        size?: number | undefined;
+        color?: string | undefined;
+        background?: string | undefined;
+        lineWidth?: number | undefined;
+        rotation?: number | undefined;
+    } | {
+        type: "image";
+        href: string;
+        fit?: "fill" | "contain" | "cover" | undefined;
+    } | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    shape?: string | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -449,16 +694,13 @@ export declare const NodeSchema: z.ZodObject<{
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
     })[] | undefined;
-    opacity?: number | undefined;
     font?: {
         family?: string | undefined;
         size?: number | undefined;
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
-    shape?: string | undefined;
     scale?: number | undefined;
-    color?: string | undefined;
     id?: string | undefined;
     textColor?: string | undefined;
     label?: {
@@ -475,6 +717,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     } | {
         text: string;
         distance?: number | undefined;
@@ -489,6 +736,11 @@ export declare const NodeSchema: z.ZodObject<{
         textColor?: string | undefined;
         rotate?: number | "none" | "radial" | "tangent" | undefined;
         keepUpright?: boolean | undefined;
+        pin?: boolean | {
+            stroke?: string | undefined;
+            strokeWidth?: number | undefined;
+            dashPattern?: number[] | undefined;
+        } | undefined;
     }[] | undefined;
     roundedCorners?: number | undefined;
     stroke?: string | undefined;
@@ -499,6 +751,7 @@ export declare const NodeSchema: z.ZodObject<{
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
     lineHeight?: number | undefined;
+    maxTextWidth?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
     dashArray?: 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;AAKxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+LpB,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;AAMxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuMpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/es/ir/node.js

@@ -3,6 +3,7 @@ import { PolarPositionSchema } from "./position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./position/at-position.js";
 import { OffsetPositionSchema } from "./position/offset-position.js";
 import { FontSchema } from "./font.js";
+import { PaintSpecSchema } from "./paint.js";
 import { TextBlockSchema } from "./text.js";
 import { z } from "zod";
 //#region src/ir/node.ts
@@ -38,7 +39,12 @@ var NodeLabelSchema = z.object({
 		"radial",
 		"tangent"
 	]), z.number()]).optional().describe("Rotate the label text around its own center. `none` (default) = horizontal; `radial` = along the node-center -> label-center direction; `tangent` = radial + 90 deg; a number = explicit degrees (screen y-down: 0 = +x, 90 = +y). Only changes text orientation, not placement."),
-	keepUpright: z.boolean().optional().describe("When true, flips the rotated label 180 deg if it would otherwise read upside-down (more than 90 deg from upright). Default false (strict geometric angle).")
+	keepUpright: z.boolean().optional().describe("When true, flips the rotated label 180 deg if it would otherwise read upside-down (more than 90 deg from upright). Default false (strict geometric angle)."),
+	pin: z.union([z.boolean(), z.object({
+		stroke: z.string().optional().describe("Leader line color; defaults to the label color / currentColor"),
+		strokeWidth: z.number().finite().positive().optional().describe("Leader line width (user units); default 1"),
+		dashPattern: z.array(z.number().finite()).optional().describe("Leader dash pattern (e.g. [2, 2])")
+	})]).optional().describe("Draw a leader line from the node border to the label (TikZ `pin`). `true` = default thin solid line; an object = leader with style overrides (`stroke` / `strokeWidth` / `dashPattern`); omitted / `false` = no leader. Label placement is unchanged either way.")
 }).describe("Extra text attached around a node border. Multiple labels supported via array form on `Node.label`.");
 var NodeSchema = z.object({
 	type: z.literal("node").describe("Discriminator marking this child as a node"),
@@ -54,8 +60,9 @@ var NodeSchema = z.object({
 	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)."),
 	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."),
-	fill: z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
+	fill: z.union([z.string(), PaintSpecSchema]).optional().describe("Node background paint: any CSS color string (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\") or a PaintSpec (linear / radial gradient, pattern, or image)."),
 	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."),