@retikz/core 0.1.0-alpha.3 → 0.1.0-alpha.5

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

@@ -1,110 +1,139 @@
 import { z } from 'zod';
 /**
- * 边标注（ADR-0004）：挂在画线 step 上的 label，渲染时按段几何 + side 偏移
- * 翻译为一个 TextPrim。`move` / `cycle` 不挂 label——前者不画线、后者是闭合
- * 标记，标签语义不清。
+ * 边标注：画线 step 上的 label
+ * @description 按段几何 + side 偏移翻译为 TextPrim；move/cycle 不挂 label
  */
 export declare const StepLabelSchema: z.ZodObject<{
     text: z.ZodString;
-    position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+    position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
     side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
-    position?: "midway" | "near-start" | "near-end" | undefined;
+    position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
     side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
 }, {
     text: string;
-    position?: "midway" | "near-start" | "near-end" | undefined;
+    position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
     side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
 }>;
-/** 边标注：单段 step 的位置 + side 修饰，编译期变成 TextPrim */
+/** 边标注 IR 类型 */
 export type IRStepLabel = z.infer<typeof StepLabelSchema>;
 export declare const MoveStepSchema: z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"move">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "move";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
 }, {
     type: "step";
     kind: "move";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
 }>;
 export declare const LineStepSchema: z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"line">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        relative: [number, number];
+    }, {
+        relative: [number, number];
+    }>, z.ZodObject<{
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "line";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "line";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -113,57 +142,72 @@ export declare const FoldStepSchema: z.ZodObject<{
     kind: z.ZodLiteral<"step">;
     via: z.ZodEnum<["-|", "|-"]>;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "step";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     via: "-|" | "|-";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "step";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     via: "-|" | "|-";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -178,72 +222,83 @@ export declare const CycleStepSchema: z.ZodObject<{
     kind: "cycle";
 }>;
 /**
- * 控制点的 schema 别名。
- *
- * alpha.3：仅支持笛卡尔 `[x, y]`（与 ADR-0001 字面一致）。
- * 未来扩展点：要支持节点 ref / 极坐标作为控制点（如 TikZ `controls (B)`）时，
- * 只把这里改成 `z.union([PositionSchema, PolarPositionSchema, z.string().min(1)])`，
- * curve / cubic schema 与下游消费侧不变。
+ * 控制点 schema 别名
+ * @description 当前仅支持笛卡尔 `[x,y]`；未来扩展节点 ref/极坐标时只改本处 union，curve/cubic schema 与下游不变
  */
 export declare const ControlPointSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
-/** 控制点类型（曲线 step 用）；alpha.3 = `[number, number]`，未来可能扩展 */
+/** 控制点类型（曲线 step 用） */
 export type IRControlPoint = z.infer<typeof ControlPointSchema>;
 export declare const CurveStepSchema: z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"curve">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     control: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "curve";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     control: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "curve";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
     control: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -251,61 +306,76 @@ export declare const CubicStepSchema: z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"cubic">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        relative: [number, number];
+    }, {
+        relative: [number, number];
+    }>, z.ZodObject<{
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     control1: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     control2: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "cubic";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
     control1: [number, number];
     control2: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "cubic";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     control1: [number, number];
     control2: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -313,45 +383,57 @@ export declare const BendStepSchema: z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"bend">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     bendDirection: z.ZodEnum<["left", "right"]>;
     bendAngle: z.ZodOptional<z.ZodNumber>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "bend";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     bendDirection: "left" | "right";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
     bendAngle?: number | undefined;
@@ -359,14 +441,17 @@ export declare const BendStepSchema: z.ZodObject<{
     type: "step";
     kind: "bend";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     bendDirection: "left" | "right";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
     bendAngle?: number | undefined;
@@ -379,15 +464,15 @@ export declare const ArcStepSchema: z.ZodObject<{
     radius: z.ZodNumber;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -398,7 +483,7 @@ export declare const ArcStepSchema: z.ZodObject<{
     endAngle: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
@@ -409,7 +494,7 @@ export declare const ArcStepSchema: z.ZodObject<{
     endAngle: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -419,15 +504,15 @@ export declare const CirclePathStepSchema: z.ZodObject<{
     radius: z.ZodNumber;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -436,7 +521,7 @@ export declare const CirclePathStepSchema: z.ZodObject<{
     kind: "circlePath";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
@@ -445,7 +530,7 @@ export declare const CirclePathStepSchema: z.ZodObject<{
     kind: "circlePath";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -456,15 +541,15 @@ export declare const EllipsePathStepSchema: z.ZodObject<{
     radiusY: z.ZodNumber;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -474,7 +559,7 @@ export declare const EllipsePathStepSchema: z.ZodObject<{
     radiusY: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
@@ -484,7 +569,7 @@ export declare const EllipsePathStepSchema: z.ZodObject<{
     radiusY: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>;
@@ -492,87 +577,117 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"move">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "move";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
 }, {
     type: "step";
     kind: "move";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
 }>, z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"line">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        relative: [number, number];
+    }, {
+        relative: [number, number];
+    }>, z.ZodObject<{
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "line";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "line";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>, z.ZodObject<{
@@ -580,57 +695,72 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"step">;
     via: z.ZodEnum<["-|", "|-"]>;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "step";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     via: "-|" | "|-";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "step";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     via: "-|" | "|-";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>, z.ZodObject<{
@@ -646,164 +776,206 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"curve">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     control: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "curve";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     control: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "curve";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
     control: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"cubic">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        relative: [number, number];
+    }, {
+        relative: [number, number];
+    }>, z.ZodObject<{
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        rel: [number, number];
+        relativeAccumulate: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }, {
-        relAccumulate: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     control1: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     control2: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "cubic";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relative: [number, number];
+    } | {
+        relativeAccumulate: [number, number];
     };
     control1: [number, number];
     control2: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
     type: "step";
     kind: "cubic";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     control1: [number, number];
     control2: [number, number];
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"step">;
     kind: z.ZodLiteral<"bend">;
     to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString, z.ZodObject<{
-        rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relative: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        rel: [number, number];
+        relative: [number, number];
     }, {
-        rel: [number, number];
+        relative: [number, number];
     }>, z.ZodObject<{
-        relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        relativeAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
     }, "strip", z.ZodTypeAny, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     }, {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
+    }>, z.ZodObject<{
+        of: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>]>;
+        offset: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    }, "strip", z.ZodTypeAny, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    }, {
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
     }>]>;
     bendDirection: z.ZodEnum<["left", "right"]>;
     bendAngle: z.ZodOptional<z.ZodNumber>;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "step";
     kind: "bend";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     bendDirection: "left" | "right";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
     bendAngle?: number | undefined;
@@ -811,14 +983,17 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     type: "step";
     kind: "bend";
     to: string | [number, number] | import('..').PolarPosition | {
-        rel: [number, number];
+        of: string | [number, number] | import('..').PolarPosition;
+        offset: [number, number];
+    } | {
+        relative: [number, number];
     } | {
-        relAccumulate: [number, number];
+        relativeAccumulate: [number, number];
     };
     bendDirection: "left" | "right";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
     bendAngle?: number | undefined;
@@ -830,15 +1005,15 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     radius: z.ZodNumber;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -849,7 +1024,7 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     endAngle: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
@@ -860,7 +1035,7 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     endAngle: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>, z.ZodObject<{
@@ -869,15 +1044,15 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     radius: z.ZodNumber;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -886,7 +1061,7 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: "circlePath";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
@@ -895,7 +1070,7 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: "circlePath";
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>, z.ZodObject<{
@@ -905,15 +1080,15 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     radiusY: z.ZodNumber;
     label: z.ZodOptional<z.ZodObject<{
         text: z.ZodString;
-        position: z.ZodOptional<z.ZodEnum<["midway", "near-start", "near-end"]>>;
+        position: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["at-start", "very-near-start", "near-start", "midway", "near-end", "very-near-end", "at-end"]>, z.ZodNumber]>>;
         side: z.ZodOptional<z.ZodEnum<["above", "below", "left", "right", "sloped"]>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }, {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -923,7 +1098,7 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     radiusY: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }, {
@@ -933,7 +1108,7 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     radiusY: number;
     label?: {
         text: string;
-        position?: "midway" | "near-start" | "near-end" | undefined;
+        position?: number | "at-start" | "very-near-start" | "near-start" | "midway" | "near-end" | "very-near-end" | "at-end" | undefined;
         side?: "above" | "below" | "left" | "right" | "sloped" | undefined;
     } | undefined;
 }>]>;
@@ -941,28 +1116,25 @@ export declare const StepSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
 export type IRMoveStep = z.infer<typeof MoveStepSchema>;
 /** Line step：从游标到目标画直线 */
 export type IRLineStep = z.infer<typeof LineStepSchema>;
-/** Fold step：折角段，从游标到目标经一个直角中间点（TikZ `-|` / `|-`） */
+/** Fold step：折角段，经一个直角中间点（TikZ `-|`/`|-`） */
 export type IRFoldStep = z.infer<typeof FoldStepSchema>;
-/** Cycle step：把当前子路径闭合回起点（TikZ `cycle` / SVG `Z`） */
+/** Cycle step：闭合回起点（TikZ `cycle` / SVG `Z`） */
 export type IRCycleStep = z.infer<typeof CycleStepSchema>;
 /** Curve step：二次贝塞尔，一个控制点 */
 export type IRCurveStep = z.infer<typeof CurveStepSchema>;
 /** Cubic step：三次贝塞尔，两控制点 */
 export type IRCubicStep = z.infer<typeof CubicStepSchema>;
-/** Bend step：弧形简记，按方向 + 角度生成 */
+/** Bend step：弧形简记，按方向+角度生成 */
 export type IRBendStep = z.infer<typeof BendStepSchema>;
-/** Arc step：以游标为圆心的圆弧段，按起末角度 + 半径定 */
+/** Arc step：以游标为圆心的圆弧段，按起末角度+半径定 */
 export type IRArcStep = z.infer<typeof ArcStepSchema>;
 /** CirclePath step：以游标为圆心的整圆 */
 export type IRCirclePathStep = z.infer<typeof CirclePathStepSchema>;
 /** EllipsePath step：以游标为圆心的整椭圆 */
 export type IREllipsePathStep = z.infer<typeof EllipsePathStepSchema>;
 /**
- * 路径上的一个动作。alpha.3 起支持十种 kind：'move' / 'line' / 'step'（折角）/
- * 'cycle' / 'curve' / 'cubic' / 'bend'（曲线三件套，ADR-0001）/
- * 'arc' / 'circlePath' / 'ellipsePath'（path-level 形状，ADR-0002）。
- * ADR-0003 引入 `to` 字段的 rel / relAccumulate 变体。
- * ADR-0004 给除 move/cycle 外八种 kind 加 `label?` 字段（边标注）。
+ * 路径上的一个动作（十种 kind）
+ * @description 十种 kind：move / line / step（折角）/ cycle / curve / cubic / bend / arc / circlePath / ellipsePath；`to` 字段支持 relative / relativeAccumulate 变体；除 move/cycle 外可挂 `label?` 边标注
  */
 export type IRStep = z.infer<typeof StepSchema>;
 //# sourceMappingURL=step.d.ts.map