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

package/dist/lib/geometry/segment.d.ts

@@ -1,38 +1,35 @@
 import { Position } from './point';
+/**
+ * 段几何采样结果：t 处坐标点 + 归一化切线向量
+ * @description 各 `*SegmentSample` 函数（line / quad / cubic / fold / arc / circle / ellipse）的统一返回形态；供 step.label emit 算位置 / 切线 / sloped 旋转角
+ */
 export type SegmentSample = {
-    /** t 处的点坐标 */
+    /** t 处的点（user units） */
     point: Position;
-    /** t 处的切线方向（单位向量；零向量时回退到 [1, 0]） */
+    /** t 处的切线（单位向量；零向量时回退 [1, 0]） */
     tangent: Position;
 };
 /** 直线段 from → to */
 export declare const lineSegmentSample: (from: Position, to: Position, t: number) => SegmentSample;
 /**
- * 二次贝塞尔 from → control → to。
- * P(t)  = (1-t)²·P0 + 2(1-t)t·P1 + t²·P2
- * P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
+ * 二次贝塞尔 from → control → to
+ * @description P(t) = (1-t)²P0 + 2(1-t)t·P1 + t²P2；P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
  */
 export declare const quadSegmentSample: (from: Position, control: Position, to: Position, t: number) => SegmentSample;
 /**
- * 三次贝塞尔 from → c1 → c2 → to。
- * P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
+ * 三次贝塞尔 from → c1 → c2 → to
+ * @description P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
  */
 export declare const cubicSegmentSample: (from: Position, c1: Position, c2: Position, to: Position, t: number) => SegmentSample;
 /**
- * 折角段 from → corner → to。
- * t∈[0, 0.5] 走第一段（参数 2t）；t∈(0.5, 1] 走第二段（参数 2t-1）。
- * t=0.5 落在 corner，切线取第一段方向（与"靠近 prev 一侧"一致）。
+ * 折角段 from → corner → to
+ * @description t∈[0,0.5] 走第一段（参数 2t）；t∈(0.5,1] 走第二段（参数 2t-1）；t=0.5 落 corner 切线取第一段方向
  */
 export declare const foldSegmentSample: (from: Position, corner: Position, to: Position, t: number) => SegmentSample;
-/**
- * 弧段（与 ir/path arc 同约定，角度单位为度）。
- * 切线沿"扫描方向"——endAngle ≥ startAngle 时为 (-sin, cos)，否则反向。
- */
+/** 弧段（角度度数，与 ir/path arc 同约定）；切线沿扫描方向：endAngle ≥ start 取 (-sin,cos)，否则反向 */
 export declare const arcSegmentSample: (center: Position, radius: number, startAngleDeg: number, endAngleDeg: number, t: number) => SegmentSample;
-/**
- * 整圆——从 0°（east）开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致。
- */
+/** 整圆，从 0°(east) 开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致 */
 export declare const circleSegmentSample: (center: Position, radius: number, t: number) => SegmentSample;
-/** 整椭圆——参数化 (rx·cos(2πt), ry·sin(2πt)) */
+/** 整椭圆，参数化 (rx·cos(2πt), ry·sin(2πt)) */
 export declare const ellipseSegmentSample: (center: Position, rx: number, ry: number, t: number) => SegmentSample;
 //# sourceMappingURL=segment.d.ts.map

package/dist/lib/geometry/segment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAuBxC,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAQF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aASF,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aASF,CAAC"}
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAiBxC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAQF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aASF,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aASF,CAAC"}

package/dist/lib/index.cjs

@@ -2,6 +2,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_position = require("./ir/position/position.cjs");
 const require_polar_position = require("./ir/position/polar-position.cjs");
 const require_at_position = require("./ir/position/at-position.cjs");
+const require_offset_position = require("./ir/position/offset-position.cjs");
+const require_font = require("./ir/font.cjs");
+const require_text = require("./ir/text.cjs");
 const require_arrow = require("./ir/path/arrow.cjs");
 const require_target = require("./ir/path/target.cjs");
 const require_step = require("./ir/path/step.cjs");
@@ -19,9 +22,13 @@ const require_parseTargetSugar = require("./parsers/parseTargetSugar.cjs");
 const require_parseWay = require("./parsers/parseWay.cjs");
 const require_polar = require("./geometry/polar.cjs");
 const require_point = require("./geometry/point.cjs");
+exports.ARROW_MARKER_DEFAULT_SIZE = require_arrow.ARROW_MARKER_DEFAULT_SIZE;
+exports.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = require_arrow.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH;
 exports.ARROW_SHAPES = require_arrow.ARROW_SHAPES;
 exports.AT_DIRECTIONS = require_at_position.AT_DIRECTIONS;
 exports.ArcStepSchema = require_step.ArcStepSchema;
+exports.ArrowDetailSchema = require_arrow.ArrowDetailSchema;
+exports.ArrowEndDetailSchema = require_arrow.ArrowEndDetailSchema;
 exports.AtPositionSchema = require_at_position.AtPositionSchema;
 exports.BendStepSchema = require_step.BendStepSchema;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
@@ -35,25 +42,27 @@ exports.CycleStepSchema = require_step.CycleStepSchema;
 exports.DrawWay = require_parseWay.DrawWay;
 exports.EllipsePathStepSchema = require_step.EllipsePathStepSchema;
 exports.FoldStepSchema = require_step.FoldStepSchema;
-exports.FontSchema = require_node.FontSchema;
-exports.LineSpecSchema = require_node.LineSpecSchema;
+exports.FontSchema = require_font.FontSchema;
+exports.HOLLOW_ARROW_SHAPES = require_arrow.HOLLOW_ARROW_SHAPES;
+exports.LineSpecSchema = require_text.LineSpecSchema;
 exports.LineStepSchema = require_step.LineStepSchema;
 exports.MoveStepSchema = require_step.MoveStepSchema;
 exports.NODE_SHAPES = require_node.NODE_SHAPES;
 exports.NODE_TEXT_ALIGNS = require_node.NODE_TEXT_ALIGNS;
 exports.NodeLabelSchema = require_node.NodeLabelSchema;
 exports.NodeSchema = require_node.NodeSchema;
-exports.NodeTextSchema = require_node.NodeTextSchema;
+exports.OffsetPositionSchema = require_offset_position.OffsetPositionSchema;
 exports.PathSchema = require_path.PathSchema;
 exports.PolarPositionSchema = require_polar_position.PolarPositionSchema;
 exports.PositionSchema = require_position.PositionSchema;
 exports.RECT_ANCHORS = require_rect.RECT_ANCHORS;
-exports.RelAccumulateTargetSchema = require_target.RelAccumulateTargetSchema;
-exports.RelTargetSchema = require_target.RelTargetSchema;
+exports.RelativeAccumulateTargetSchema = require_target.RelativeAccumulateTargetSchema;
+exports.RelativeTargetSchema = require_target.RelativeTargetSchema;
 exports.SceneSchema = require_scene.SceneSchema;
 exports.StepLabelSchema = require_step.StepLabelSchema;
 exports.StepSchema = require_step.StepSchema;
 exports.TargetSchema = require_target.TargetSchema;
+exports.TextBlockSchema = require_text.TextBlockSchema;
 exports.circle = require_circle.circle;
 exports.compileToScene = require_compile.compileToScene;
 exports.diamond = require_diamond.diamond;

package/dist/lib/index.d.ts

@@ -1,20 +1,20 @@
 /**
  * @retikz/core 公开 API
- *
- * 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）
- * 只能 import 本文件导出的内容，不准走子路径。
- *
- * 本包零 React、零 DOM 依赖。
+ * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, AT_DIRECTIONS, TargetSchema, RelTargetSchema, RelAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, NodeTextSchema, LineSpecSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRAtPosition, AtDirection, IRTarget, IRRelTarget, IRRelAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRPath, IRChild, IR, ArrowShape, NodeShape, NodeTextAlign, } from './ir';
-export { ARROW_SHAPES, NODE_SHAPES, NODE_TEXT_ALIGNS } from './ir';
-export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, GroupPrim, ViewBox, Scene, } from './primitive';
-export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, } from './compile';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, NodeTextAlign, } from './ir';
+export { ARROW_SHAPES, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, } 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, ViewBox, Scene, } from './primitive';
+export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, CompileWarning, } from './compile';
 export { fallbackMeasurer, compileToScene } from './compile';
-export type { WayItem, WayDSL, WayCycle, WayVia, WayRelItem, WayLabel, WayLabelOp, } from './parsers';
+export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayLabelOp, } from './parsers';
 export { parseWay, DrawWay, parseTargetSugar } from './parsers';
-export type { Position, Rect, RectAnchor, Circle, CircleAnchor, Ellipse, EllipseAnchor, Diamond, DiamondAnchor, PolarPosition, } from './geometry';
+export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
-export type { ValueOf } from './types';
+export type { ValueOf, AssertEqual } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAGnE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIhE,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,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,OAAO,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,oBAAoB,EACpB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,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,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,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,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,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,MAAM,WAAW,CAAC;AAIhE,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,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/lib/ir/coordinate.cjs

@@ -1,18 +1,12 @@
 const require_position = require("./position/position.cjs");
 const require_polar_position = require("./position/polar-position.cjs");
 const require_at_position = require("./position/at-position.cjs");
+const require_offset_position = require("./position/offset-position.cjs");
 let zod = require("zod");
 //#region src/ir/coordinate.ts
 /**
-* Coordinate（占位节点）——TikZ `\coordinate (m) at (3,2);` 同义。
-*
-* 命名一个点供后续 path / at 引用，自身不绘制任何图形。
-* 支持笛卡尔 / 极坐标 / 相对定位三种 position 形态，与 `Node.position` 完全一致。
-*
-* 特点：
-* - 必须有 `id`（无 id 的占位节点没有意义）
-* - 不参与 viewBox 扩展（无视觉边界）；只在被引用时才间接影响 viewBox（通过引用它的 node / path）
-* - 与 Node 在同一个 nodeIndex 中注册——path target 字符串、`Node.position.of` 都能命中 coordinate id
+* Coordinate 占位节点（TikZ `\coordinate (m) at (3,2);` 同义）
+* @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 viewBox 扩展，与 Node 在同一 nodeIndex 注册
 */
 var CoordinateSchema = zod.z.object({
 	type: zod.z.literal("coordinate").describe("Discriminator marking this child as a coordinate placeholder"),
@@ -20,8 +14,9 @@ var CoordinateSchema = zod.z.object({
 	position: zod.z.union([
 		require_position.PositionSchema,
 		require_polar_position.PolarPositionSchema,
-		require_at_position.AtPositionSchema
-	]).describe("Coordinate position; Cartesian [x, y], polar, or relative-to-another-node (`at`-style). Resolved at compile time.")
+		require_at_position.AtPositionSchema,
+		require_offset_position.OffsetPositionSchema
+	]).describe("Coordinate position; Cartesian [x, y], polar, relative-to-another-node (`at`-style), or offset from a base point (`{ of, offset }` form). Resolved at compile time.")
 }).describe("Coordinate placeholder: a named point with no visual; usable as a target for paths and as an anchor for relative positioning. Mirrors TikZ `\\coordinate (id) at (...);`");
 //#endregion
 exports.CoordinateSchema = CoordinateSchema;

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

@@ -1,14 +1,7 @@
 import { z } from 'zod';
 /**
- * Coordinate（占位节点）——TikZ `\coordinate (m) at (3,2);` 同义。
- *
- * 命名一个点供后续 path / at 引用，自身不绘制任何图形。
- * 支持笛卡尔 / 极坐标 / 相对定位三种 position 形态，与 `Node.position` 完全一致。
- *
- * 特点：
- * - 必须有 `id`（无 id 的占位节点没有意义）
- * - 不参与 viewBox 扩展（无视觉边界）；只在被引用时才间接影响 viewBox（通过引用它的 node / path）
- * - 与 Node 在同一个 nodeIndex 中注册——path target 字符串、`Node.position.of` 都能命中 coordinate id
+ * Coordinate 占位节点（TikZ `\coordinate (m) at (3,2);` 同义）
+ * @description 命名一个点供 path/at 引用，不绘制任何图形；支持笛卡尔/极坐标/相对定位三种 position 形态。必须有 id，不参与 viewBox 扩展，与 Node 在同一 nodeIndex 注册
  */
 export declare const CoordinateSchema: z.ZodObject<{
     type: z.ZodLiteral<"coordinate">;
@@ -34,6 +27,15 @@ export declare const CoordinateSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     }>]>;
 }, "strip", z.ZodTypeAny, {
     type: "coordinate";
@@ -41,6 +43,9 @@ export declare const CoordinateSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    } | {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     };
     id: string;
 }, {
@@ -49,9 +54,12 @@ export declare const CoordinateSchema: z.ZodObject<{
         direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
         of: string;
         distance?: number | undefined;
+    } | {
+        of: string | [number, number] | import('./position').PolarPosition;
+        offset: [number, number];
     };
     id: string;
 }>;
-/** Coordinate IR 类型——`{ type: 'coordinate', id, position }` */
+/** Coordinate IR 类型 `{ type:'coordinate', id, position }` */
 export type IRCoordinate = z.infer<typeof CoordinateSchema>;
 //# sourceMappingURL=coordinate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"coordinate.d.ts","sourceRoot":"","sources":["../../../src/ir/coordinate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB1B,CAAC;AAEJ,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"coordinate.d.ts","sourceRoot":"","sources":["../../../src/ir/coordinate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB1B,CAAC;AAEJ,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/lib/ir/font.cjs

@@ -0,0 +1,15 @@
+let zod = require("zod");
+//#region src/ir/font.ts
+/** 字体规格：family/size/weight/style 全部可选 */
+var FontSchema = zod.z.object({
+	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
+	size: zod.z.number().positive().finite().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
+	weight: zod.z.union([zod.z.enum(["normal", "bold"]), zod.z.number().finite()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
+	style: zod.z.enum([
+		"normal",
+		"italic",
+		"oblique"
+	]).optional().describe("CSS font-style")
+}).describe("Font properties (family / size / weight / style). All fields optional; consumed by Node text / Node label / LineSpec / future Tikz / Scope font defaults.");
+//#endregion
+exports.FontSchema = FontSchema;

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

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/** 字体规格：family/size/weight/style 全部可选 */
+export declare const FontSchema: z.ZodObject<{
+    family: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+    style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+}, "strip", z.ZodTypeAny, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}>;
+/** 字体规格 IR 类型（所有字段可选，编译期解析默认值） */
+export type IRFont = z.infer<typeof FontSchema>;
+//# sourceMappingURL=font.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"font.d.ts","sourceRoot":"","sources":["../../../src/ir/font.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAyBpB,CAAC;AAEJ,kCAAkC;AAClC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

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

@@ -1,4 +1,6 @@
 export * from './position';
+export * from './font';
+export * from './text';
 export * from './path';
 export * from './node';
 export * from './coordinate';

package/dist/lib/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,cAAc,CAAC;AAC7B,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,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/lib/ir/node.cjs

@@ -1,22 +1,14 @@
 const require_position = require("./position/position.cjs");
 const require_polar_position = require("./position/polar-position.cjs");
 const require_at_position = require("./position/at-position.cjs");
+const require_offset_position = require("./position/offset-position.cjs");
+const require_font = require("./font.cjs");
+const require_text = require("./text.cjs");
 let zod = require("zod");
 //#region src/ir/node.ts
 /**
-* 节点形状常量。值是 IR 中 `shape` 字段的字面字符串；
-* 用 const + ValueOf 派生（不用 TS enum）。
-*
-* - `rectangle`：矩形（默认；UML 类、流程图常规节点）
-* - `circle`：圆形（流程图起止、状态机）
-* - `ellipse`：椭圆（状态机、集合图）
-* - `diamond`：菱形（流程图判定）
-*
-* 每个 shape 的几何语义：node 的视觉边界包住"text 矩形 + padding"——
-* - rectangle: 视觉 rect = text rect
-* - circle:    外接圆，r = √(innerHalfW² + innerHalfH²)
-* - ellipse:   外接椭圆，rx = innerHalfW×√2、ry = innerHalfH×√2
-* - diamond:   外接菱形，halfA = 2×innerHalfW、halfB = 2×innerHalfH
+* 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
+* @description rectangle 默认；circle/ellipse/diamond 几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；circle: r=√(innerHalfW²+innerHalfH²)；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2；diamond: halfA=2×innerHalfW,halfB=2×innerHalfH
 */
 var NODE_SHAPES = {
 	rectangle: "rectangle",
@@ -24,63 +16,15 @@ var NODE_SHAPES = {
 	ellipse: "ellipse",
 	diamond: "diamond"
 };
-/**
-* 节点字体规格——family / size / weight / style 全部可选；
-* 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
-*
-* 取代 alpha.1 的标量 `fontSize` 字段（已删）。
-*/
-var FontSchema = zod.z.object({
-	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
-	size: zod.z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
-	weight: zod.z.union([zod.z.enum(["normal", "bold"]), zod.z.number()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
-	style: zod.z.enum([
-		"normal",
-		"italic",
-		"oblique"
-	]).optional().describe("CSS font-style")
-}).describe("Font properties for the node text label; all fields optional, nested object form (replaces the alpha.1 `fontSize` scalar).");
-/**
-* 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
-*
-* 行级覆盖只生效于本行的 `<tspan>`：
-* - `fill`：仅这一行颜色
-* - `opacity`：仅这一行 0~1 透明度
-* - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
-*
-* 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
-*/
-var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
-	text: zod.z.string().describe("Line content"),
-	fill: zod.z.string().optional().describe("Per-line text color; overrides block default"),
-	opacity: zod.z.number().min(0).max(1).optional().describe("Per-line opacity 0..1"),
-	font: FontSchema.optional().describe("Per-line font overrides; missing fields inherit from block-level `font`")
-})]).describe("Single line of text: bare string for default styling, or an object with per-line `fill` / `opacity` / `font` overrides.");
-/**
-* 节点文本——单行字符串或非空多行数组（每元素一个 LineSpec）：
-* - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
-* - `['Line 1', 'Line 2']` 两行无样式覆盖
-* - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
-*
-* 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
-*/
-var NodeTextSchema = zod.z.union([zod.z.string(), zod.z.array(LineSpecSchema).min(1)]).describe("Text label rendered inside the node: a single string for one line, or a non-empty array of line specs (string for default, object for per-line overrides).");
-/** 节点文本对齐（多行内文本对齐）——TikZ `align=` 同义词 */
+/** 节点文本对齐（TikZ `align=` 同义） */
 var NODE_TEXT_ALIGNS = {
 	left: "left",
 	center: "center",
 	right: "right"
 };
 /**
-* 节点附属标签（label）——TikZ `[label=above:foo]` / `[label={[red]30:foo}]` 同义。
-*
-* 一个 Node 可挂多个 label（数组形态）；label 自身不参与 viewBox（视觉外延少时可接受）。
-*
-* `position` 接受两种形态：
-* - 8 方向枚举（`above` / `right` / `above-left` ...）：标签贴在 node 该方向边界外
-* - 数字角度：以 node 中心为原点，按该角度方向投射；约定与 polar 一致（0° = +x，90° = +y 屏幕下方）
-*
-* 默认 `position = 'above'`，`distance = 4`（user units，标签与 node 边界的距离）。
+* 节点附属标签 label（TikZ `[label=above:foo]` 同义）
+* @description 可挂多个；label 不参与 viewBox。position 支持 8 方向枚举或数字角度（polar 约定：0°=+x，90°=+y 屏幕下方）；默认 position='above'，distance=4
 */
 var NodeLabelSchema = zod.z.object({
 	text: zod.z.string().describe("Label text content; rendered as a single line."),
@@ -88,7 +32,7 @@ var NodeLabelSchema = zod.z.object({
 	distance: zod.z.number().nonnegative().optional().describe("Gap between the node border and the label center, in user units. Default 4."),
 	textColor: zod.z.string().optional().describe("Label text color; falls back to currentColor."),
 	opacity: zod.z.number().min(0).max(1).optional().describe("Label-only opacity 0..1; multiplied with the node opacity if both are set."),
-	font: FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults.")
+	font: require_font.FontSchema.optional().describe("Label font overrides; missing fields inherit from the parent node font, then renderer defaults.")
 }).describe("Extra text attached around a node border. Multiple labels supported via array form on `Node.label`.");
 var NodeSchema = zod.z.object({
 	type: zod.z.literal("node").describe("Discriminator marking this child as a node"),
@@ -97,10 +41,11 @@ var NodeSchema = zod.z.object({
 	position: zod.z.union([
 		require_position.PositionSchema,
 		require_polar_position.PolarPositionSchema,
-		require_at_position.AtPositionSchema
-	]).describe("Center point of the node content box; Cartesian [x, y], polar, or relative-to-another-node (`at`-style with `direction` / `of` / `distance?`). All non-Cartesian forms resolve at compile time."),
+		require_at_position.AtPositionSchema,
+		require_offset_position.OffsetPositionSchema
+	]).describe("Center point of the node content box; Cartesian [x, y], polar, relative-to-another-node (`at`-style with `direction` / `of` / `distance?`), or offset from a base point (`{ of, offset }` form mirroring TikZ `calc`). All non-Cartesian forms resolve at compile time."),
 	rotate: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: NodeTextSchema.optional(),
+	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)."),
 	lineHeight: zod.z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	fill: zod.z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
@@ -110,8 +55,8 @@ var NodeSchema = zod.z.object({
 	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.string().optional().describe("Explicit SVG stroke-dasharray value (e.g. \"4 2\"); overrides `dashed` / `dotted`."),
-	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape (rx / ry on `<rect>`)."),
+	dashArray: zod.z.string().optional().describe("Explicit stroke dash pattern (e.g. \"4 2\"; same format as SVG/CSS `stroke-dasharray`); overrides `dashed` / `dotted`."),
+	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape."),
 	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."),
 	minimumSize: zod.z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),
@@ -125,14 +70,11 @@ var NodeSchema = zod.z.object({
 	outerSep: zod.z.number().nonnegative().optional().describe("Outer margin from border to path attachment point in user units; does NOT change the visible border. Falls back to `margin`."),
 	padding: zod.z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
 	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
-	font: FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults."),
+	font: 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`.")
 }).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
-exports.FontSchema = FontSchema;
-exports.LineSpecSchema = LineSpecSchema;
 exports.NODE_SHAPES = NODE_SHAPES;
 exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
 exports.NodeLabelSchema = NodeLabelSchema;
 exports.NodeSchema = NodeSchema;
-exports.NodeTextSchema = NodeTextSchema;