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

package/dist/es/ir/node.js

@@ -2,6 +2,8 @@ import { PositionSchema } from "./position/position.js";
 import { PolarPositionSchema } from "./position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./position/at-position.js";
 import { OffsetPositionSchema } from "./position/offset-position.js";
+import { FontSchema } from "./font.js";
+import { TextBlockSchema } from "./text.js";
 import { z } from "zod";
 //#region src/ir/node.ts
 /**
@@ -14,32 +16,6 @@ var NODE_SHAPES = {
 	ellipse: "ellipse",
 	diamond: "diamond"
 };
-/** 节点字体规格：family/size/weight/style 全部可选，透传 SVG `<text>` font-* 属性 */
-var FontSchema = z.object({
-	family: z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
-	size: z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
-	weight: z.union([z.enum(["normal", "bold"]), z.number()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
-	style: z.enum([
-		"normal",
-		"italic",
-		"oblique"
-	]).optional().describe("CSS font-style")
-}).describe("Font properties for the node text label; all fields optional, nested object form.");
-/**
-* 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
-* @description 行级覆盖只生效于本行 `<tspan>`；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
-*/
-var LineSpecSchema = z.union([z.string(), z.object({
-	text: z.string().describe("Line content"),
-	fill: z.string().optional().describe("Per-line text color; overrides block default"),
-	opacity: 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 数组
-* @description 选数组而非 `\n` 字符串：JSON 友好无 escape，行级覆盖天然落字段
-*/
-var NodeTextSchema = z.union([z.string(), 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=` 同义） */
 var NODE_TEXT_ALIGNS = {
 	left: "left",
@@ -69,7 +45,7 @@ var NodeSchema = z.object({
 		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: z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: NodeTextSchema.optional(),
+	text: TextBlockSchema.optional(),
 	align: z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
 	lineHeight: z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	fill: z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
@@ -79,8 +55,8 @@ var NodeSchema = z.object({
 	strokeWidth: z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
 	dashed: z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
 	dotted: z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
-	dashArray: z.string().optional().describe("Explicit SVG stroke-dasharray value (e.g. \"4 2\"); overrides `dashed` / `dotted`."),
-	roundedCorners: z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape (rx / ry on `<rect>`)."),
+	dashArray: z.string().optional().describe("Explicit stroke dash pattern (e.g. \"4 2\"; same format as SVG/CSS `stroke-dasharray`); overrides `dashed` / `dotted`."),
+	roundedCorners: z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape."),
 	minimumWidth: z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
 	minimumSize: z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),
@@ -98,4 +74,4 @@ var NodeSchema = z.object({
 	label: z.union([NodeLabelSchema, z.array(NodeLabelSchema)]).optional().describe("Extra label(s) attached around the node border (TikZ `[label=above:foo]`); single object or array form. Compiled into one TextPrim per label, positioned by `position` direction / angle and `distance`.")
 }).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
-export { FontSchema, LineSpecSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema, NodeTextSchema };
+export { NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema };

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

@@ -48,20 +48,20 @@ export declare const ArrowEndDetailSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
 }>;
 /**
@@ -106,20 +106,20 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }>>;
     end: z.ZodOptional<z.ZodObject<{
@@ -142,78 +142,78 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    opacity?: number | undefined;
     shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
     scale?: number | undefined;
     width?: number | undefined;
     color?: string | undefined;
-    opacity?: number | undefined;
     lineWidth?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
     } | undefined;
 }>;

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

@@ -43,20 +43,20 @@ export declare const PathSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         }, {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         }>>;
         end: z.ZodOptional<z.ZodObject<{
@@ -79,78 +79,78 @@ export declare const PathSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         }, {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
         start?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
         end?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
         start?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
         end?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
     }>>;
@@ -843,30 +843,30 @@ export declare const PathSchema: z.ZodObject<{
     arrowDetail?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
         start?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
         end?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
     } | undefined;
@@ -1018,30 +1018,30 @@ export declare const PathSchema: z.ZodObject<{
     arrowDetail?: {
         length?: number | undefined;
         fill?: string | undefined;
+        opacity?: number | undefined;
         shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
         scale?: number | undefined;
         width?: number | undefined;
         color?: string | undefined;
-        opacity?: number | undefined;
         lineWidth?: number | undefined;
         start?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
         end?: {
             length?: number | undefined;
             fill?: string | undefined;
+            opacity?: number | undefined;
             shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
             scale?: number | undefined;
             width?: number | undefined;
             color?: string | undefined;
-            opacity?: number | undefined;
             lineWidth?: number | undefined;
         } | undefined;
     } | undefined;

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

@@ -6,7 +6,7 @@ var PathSchema = z.object({
 	type: z.literal("path").describe("Discriminator marking this child as a path"),
 	stroke: z.string().optional().describe("Stroke color of the path; any CSS color. Defaults to currentColor when omitted"),
 	strokeWidth: z.number().optional().describe("Stroke width in user units; defaults to 1 when omitted"),
-	strokeDasharray: z.string().optional().describe("SVG stroke-dasharray pattern (e.g. \"4 2\"); leave empty for solid line"),
+	strokeDasharray: z.string().optional().describe("Stroke dash pattern (e.g. \"4 2\"; same format as SVG/CSS `stroke-dasharray`); leave empty for solid line"),
 	arrow: z.enum([
 		"none",
 		"->",
@@ -15,17 +15,17 @@ var PathSchema = z.object({
 	]).optional().describe("Path-level arrow direction. omitted/`none` = no arrows; `->` = arrow at end; `<-` = at start; `<->` = both."),
 	arrowDetail: ArrowDetailSchema.optional().describe("Detailed arrow visual config (shape / scale / length / width / color / fill / opacity / lineWidth) with optional `start` / `end` per-end overrides. Omitted = built-in defaults (shape `normal`, all visuals inherit from path stroke / opacity)."),
 	fill: z.string().optional().describe("Fill color of the closed region; any CSS color. Omitted = no fill (stroke only). Pairs with `cycle` step for filled shapes."),
-	fillRule: z.enum(["nonzero", "evenodd"]).optional().describe("How self-intersecting / nested sub-paths are filled. `nonzero` (default, SVG default) winds-by-direction; `evenodd` toggles fill on each crossing — useful for ring / donut shapes."),
+	fillRule: z.enum(["nonzero", "evenodd"]).optional().describe("How self-intersecting / nested sub-paths are filled. `nonzero` (default) winds-by-direction; `evenodd` toggles fill on each crossing — useful for ring / donut shapes."),
 	lineCap: z.enum([
 		"butt",
 		"round",
 		"square"
-	]).optional().describe("Stroke endpoint shape (SVG `stroke-linecap`). Default `butt` (sharp end); `round` adds a half-disc cap; `square` extends a half-stroke past the endpoint."),
+	]).optional().describe("Stroke endpoint shape (`butt` / `round` / `square`; same semantics as SVG/CSS `stroke-linecap`). Default `butt` (sharp end); `round` adds a half-disc cap; `square` extends a half-stroke past the endpoint."),
 	lineJoin: z.enum([
 		"miter",
 		"round",
 		"bevel"
-	]).optional().describe("Stroke corner shape (SVG `stroke-linejoin`). Default `miter` (sharp corner); `round` rounds the join; `bevel` cuts the corner flat."),
+	]).optional().describe("Stroke corner shape (`miter` / `round` / `bevel`; same semantics as SVG/CSS `stroke-linejoin`). Default `miter` (sharp corner); `round` rounds the join; `bevel` cuts the corner flat."),
 	thickness: z.enum([
 		"ultraThin",
 		"veryThin",

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

@@ -1118,7 +1118,7 @@ export type IRMoveStep = z.infer<typeof MoveStepSchema>;
 export type IRLineStep = z.infer<typeof LineStepSchema>;
 /** Fold step：折角段，经一个直角中间点（TikZ `-|`/`|-`） */
 export type IRFoldStep = z.infer<typeof FoldStepSchema>;
-/** Cycle step：闭合回起点（TikZ `cycle` / SVG `Z`） */
+/** Cycle step：闭合回起点（TikZ `cycle`） */
 export type IRCycleStep = z.infer<typeof CycleStepSchema>;
 /** Curve step：二次贝塞尔，一个控制点 */
 export type IRCurveStep = z.infer<typeof CurveStepSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EA+BzB,CAAC;AAEJ,gBAAgB;AAChB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQyC,CAAC;AAErE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS4C,CAAC;AAExE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBxB,CAAC;AAEJ,eAAO,MAAM,eAAe;;;;;;;;;EAWzB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,kBAAkB,8CAE9B,CAAC;AAEF,uBAAuB;AACvB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEhE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYoD,CAAC;AAEjF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAezB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkByE,CAAC;AAErG,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBsI,CAAC;AAEjK,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY6E,CAAC;AAE/G,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB8D,CAAC;AAEjG,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAa+C,CAAC;AAEvE,yBAAyB;AACzB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,0BAA0B;AAC1B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,kCAAkC;AAClC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/step.ts"],"names":[],"mappings":"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"}

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

@@ -27,12 +27,12 @@ var StepLabelSchema = z.object({
 }).describe("Edge label spec attached to a drawn step; compiled to a TextPrim positioned along the segment.");
 var MoveStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("move").describe("Move the cursor to the target without drawing (like SVG path \"M\")"),
+	kind: z.literal("move").describe("Move the cursor to the target without drawing (TikZ `(A)`, no drawing operation)"),
 	to: TargetSchema.describe("Destination point of the move")
 }).describe("Move action: relocate the path cursor without drawing");
 var LineStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("line").describe("Draw a straight line from the current cursor to the target (like SVG path \"L\")"),
+	kind: z.literal("line").describe("Draw a straight line from the current cursor to the target (TikZ `(A) -- (B)`)"),
 	to: TargetSchema.describe("Destination point of the line segment"),
 	label: StepLabelSchema.optional().describe("Edge label attached to this line segment")
 }).describe("Line action: straight-line segment from cursor to target");
@@ -45,7 +45,7 @@ var FoldStepSchema = z.object({
 }).describe("Fold action: TikZ-style right-angle fold with a single intermediate point chosen by `via`");
 var CycleStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("cycle").describe("Close the path back to the most recent move target (TikZ `cycle` / SVG path \"Z\")")
+	kind: z.literal("cycle").describe("Close the path back to the most recent move target (TikZ `cycle`)")
 }).describe("Cycle action: close the current sub-path back to its starting point; carries no `to` field");
 /**
 * 控制点 schema 别名
@@ -54,14 +54,14 @@ var CycleStepSchema = z.object({
 var ControlPointSchema = PositionSchema.describe("Bezier control point. Currently Cartesian [x, y]; reserved for node ref / polar in future versions.");
 var CurveStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("curve").describe("Quadratic Bezier curve from cursor to target with one control point (TikZ `.. controls (B) ..`, SVG path \"Q\")"),
+	kind: z.literal("curve").describe("Quadratic Bezier curve from cursor to target with one control point (TikZ `.. controls (B) ..`)"),
 	to: TargetSchema.describe("Destination point of the curve"),
 	control: ControlPointSchema.describe("Single control point for the quadratic Bezier"),
 	label: StepLabelSchema.optional().describe("Edge label attached to this quadratic Bezier")
 }).describe("Curve action: quadratic Bezier; one control point shapes the bend");
 var CubicStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("cubic").describe("Cubic Bezier curve from cursor to target with two control points (TikZ `.. controls (B) and (C) ..`, SVG path \"C\")"),
+	kind: z.literal("cubic").describe("Cubic Bezier curve from cursor to target with two control points (TikZ `.. controls (B) and (C) ..`)"),
 	to: TargetSchema.describe("Destination point of the cubic curve"),
 	control1: ControlPointSchema.describe("First control point (influences the start tangent)"),
 	control2: ControlPointSchema.describe("Second control point (influences the end tangent)"),
@@ -78,20 +78,20 @@ var BendStepSchema = z.object({
 var ArcStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
 	kind: z.literal("arc").describe("Arc segment from cursor as center, sweeping startAngle → endAngle on a circle of given radius (TikZ `arc[start angle=…, end angle=…, radius=…]`); pen ends at the arc endpoint, not the center"),
-	startAngle: z.number().describe("Arc start angle in degrees, CCW from +x axis (math convention; SVG y-down means visual CW)"),
+	startAngle: z.number().describe("Arc start angle in degrees, measured from +x axis. 0° = +x, 90° = +y = screen-down (visual clockwise under screen y-down); matches polar / Node label angle convention."),
 	endAngle: z.number().describe("Arc end angle in degrees; sweep direction inferred from startAngle vs endAngle"),
 	radius: z.number().positive().describe("Arc radius in user units"),
 	label: StepLabelSchema.optional().describe("Edge label attached to this arc")
 }).describe("Arc action: TikZ-style arc with implicit center at the cursor; startAngle / endAngle / radius give the geometry. Pen is left at the arc endpoint.");
 var CirclePathStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("circlePath").describe("Full circle centered at the cursor with given radius (TikZ `circle[radius=…]`); SVG path emits two semi-arcs to avoid the 360° A-command degeneracy. Pen returns to the center."),
+	kind: z.literal("circlePath").describe("Full circle centered at the cursor with given radius (TikZ `circle[radius=…]`); compiled to a single full-sweep ellipse arc command. Pen returns to the center."),
 	radius: z.number().positive().describe("Circle radius in user units"),
 	label: StepLabelSchema.optional().describe("Edge label attached to this full circle")
 }).describe("CirclePath action: full closed circle around the cursor as center; pen returns to center after.");
 var EllipsePathStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: z.literal("ellipsePath").describe("Full ellipse centered at the cursor with given x/y radii (TikZ `ellipse[x radius=…, y radius=…]`); SVG path emits two semi-arcs. Pen returns to the center."),
+	kind: z.literal("ellipsePath").describe("Full ellipse centered at the cursor with given x/y radii (TikZ `ellipse[x radius=…, y radius=…]`); compiled to a single full-sweep ellipse arc command. Pen returns to the center."),
 	radiusX: z.number().positive().describe("Ellipse x-axis radius (semi-major or semi-minor on x)"),
 	radiusY: z.number().positive().describe("Ellipse y-axis radius (semi-major or semi-minor on y)"),
 	label: StepLabelSchema.optional().describe("Edge label attached to this full ellipse")

package/dist/es/ir/position/offset-position.js

@@ -8,7 +8,7 @@ var OffsetPositionSchema = z.object({
 		PositionSchema,
 		PolarPositionSchema
 	]).describe("Reference base point: node id string (forward references rejected), Cartesian [x, y] literal (no pre-definition needed), or PolarPosition (recursive polar chain via its own origin). Mirrors PolarPosition.origin union shape."),
-	offset: z.tuple([z.number(), z.number()]).describe("Offset (dx, dy) from the reference point in user units")
+	offset: z.tuple([z.number().finite(), z.number().finite()]).describe("Offset (dx, dy) from the reference point in user units; rejects NaN / ±Infinity")
 }).describe("Offset position: base point `of` plus a Cartesian `(dx, dy)` offset. Mirrors TikZ `calc` syntax `($(of) + (dx, dy)$)`. The base point may itself be a node id, a literal coordinate, or a polar expression — covering all referent shapes available to PolarPosition.origin.");
 //#endregion
 export { OffsetPositionSchema };

package/dist/es/ir/position/polar-position.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polar-position.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/polar-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAmBxD,CAAC;AAGF,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"polar-position.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/polar-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAuBxD,CAAC;AAGF,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/es/ir/position/polar-position.js

@@ -8,8 +8,8 @@ var PolarPositionSchema = z.lazy(() => z.object({
 		PositionSchema,
 		PolarPositionSchema
 	]).optional().describe("Origin reference: node id string, Cartesian [x, y], or nested PolarPosition (chained); defaults to [0, 0] when omitted"),
-	angle: z.number().describe("Angle in degrees, counter-clockwise positive (TikZ convention)"),
-	radius: z.number().describe("Radius / distance in user units")
+	angle: z.number().finite().describe("Angle in degrees, measured from +x axis (0°). 90° = +y = screen-down (visual clockwise under screen y-down); negative angles go upward. Matches retikz convention used by ArcStep / Node label."),
+	radius: z.number().finite().describe("Radius / distance in user units")
 }).describe("Polar coordinate position; resolved to Cartesian at Scene compile time"));
 //#endregion
 export { PolarPositionSchema };

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

@@ -1 +1 @@
-{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,8CAEa,CAAC;AAEzC,mBAAmB;AACnB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,8CAEqF,CAAC;AAEjH,mBAAmB;AACnB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/es/ir/position/position.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
 //#region src/ir/position/position.ts
-var PositionSchema = z.tuple([z.number(), z.number()]).describe("Cartesian position [x, y]");
+var PositionSchema = z.tuple([z.number().finite(), z.number().finite()]).describe("Cartesian position [x, y]; rejects NaN / ±Infinity to keep IR JSON-serializable round-trip stable");
 //#endregion
 export { PositionSchema };