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

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoGpB,CAAC;AAEJ,+CAA+C;AAC/C,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiGpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/lib/ir/path/step.cjs

@@ -3,17 +3,20 @@ const require_target = require("./target.cjs");
 let zod = require("zod");
 //#region src/ir/path/step.ts
 /**
-* 边标注（ADR-0004）：挂在画线 step 上的 label，渲染时按段几何 + side 偏移
-* 翻译为一个 TextPrim。`move` / `cycle` 不挂 label——前者不画线、后者是闭合
-* 标记，标签语义不清。
+* 边标注：画线 step 上的 label
+* @description 按段几何 + side 偏移翻译为 TextPrim；move/cycle 不挂 label
 */
 var StepLabelSchema = zod.z.object({
 	text: zod.z.string().describe("Label text content. Single-line; for multi-line use \\n."),
-	position: zod.z.enum([
-		"midway",
+	position: zod.z.union([zod.z.enum([
+		"at-start",
+		"very-near-start",
 		"near-start",
-		"near-end"
-	]).optional().describe("Position along the step segment (TikZ `midway` / `near start` / `near end`). Default `midway`."),
+		"midway",
+		"near-end",
+		"very-near-end",
+		"at-end"
+	]), zod.z.number().min(0).max(1)]).optional().describe("Normalized position t along the step (TikZ `pos`). Accepts a number 0..1 or one of 7 keyword sugars (at-start=0 / very-near-start=0.125 / near-start=0.25 / midway=0.5 / near-end=0.75 / very-near-end=0.875 / at-end=1). Geometric meaning of t varies by step kind: line/step use normalized arc length (fold partitions t equally across N legs — corner sits at t=j/N); curve/cubic/bend use the Bezier parameter (NOT arc length, so t=0.5 is not always the visual midpoint); arc maps t linearly across startAngle..endAngle; circlePath/ellipsePath use angle parametrization with t=0 at angle 0 (+x axis), CCW growth. Default `midway` (t=0.5)."),
 	side: zod.z.enum([
 		"above",
 		"below",
@@ -21,15 +24,15 @@ var StepLabelSchema = zod.z.object({
 		"right",
 		"sloped"
 	]).optional().describe("Side relative to segment direction. `above` / `below` / `left` / `right` offset along segment normal; `sloped` rotates label along the tangent (no normal offset). Default `above`.")
-}).describe("Edge label spec attached to a drawn step (ADR-0004); compiled to a TextPrim positioned along the segment.");
+}).describe("Edge label spec attached to a drawn step; compiled to a TextPrim positioned along the segment.");
 var MoveStepSchema = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.z.literal("move").describe("Move the cursor to the target without drawing (like SVG path \"M\")"),
+	kind: zod.z.literal("move").describe("Move the cursor to the target without drawing (TikZ `(A)`, no drawing operation)"),
 	to: require_target.TargetSchema.describe("Destination point of the move")
 }).describe("Move action: relocate the path cursor without drawing");
 var LineStepSchema = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.z.literal("line").describe("Draw a straight line from the current cursor to the target (like SVG path \"L\")"),
+	kind: zod.z.literal("line").describe("Draw a straight line from the current cursor to the target (TikZ `(A) -- (B)`)"),
 	to: require_target.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");
@@ -42,27 +45,23 @@ var FoldStepSchema = zod.z.object({
 }).describe("Fold action: TikZ-style right-angle fold with a single intermediate point chosen by `via`");
 var CycleStepSchema = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.z.literal("cycle").describe("Close the path back to the most recent move target (TikZ `cycle` / SVG path \"Z\")")
+	kind: zod.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 别名。
-*
-* 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 与下游不变
 */
 var ControlPointSchema = require_position.PositionSchema.describe("Bezier control point. Currently Cartesian [x, y]; reserved for node ref / polar in future versions.");
 var CurveStepSchema = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.z.literal("curve").describe("Quadratic Bezier curve from cursor to target with one control point (TikZ `.. controls (B) ..`, SVG path \"Q\")"),
+	kind: zod.z.literal("curve").describe("Quadratic Bezier curve from cursor to target with one control point (TikZ `.. controls (B) ..`)"),
 	to: require_target.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 = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.z.literal("cubic").describe("Cubic Bezier curve from cursor to target with two control points (TikZ `.. controls (B) and (C) ..`, SVG path \"C\")"),
+	kind: zod.z.literal("cubic").describe("Cubic Bezier curve from cursor to target with two control points (TikZ `.. controls (B) and (C) ..`)"),
 	to: require_target.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)"),
@@ -79,20 +78,20 @@ var BendStepSchema = zod.z.object({
 var ArcStepSchema = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
 	kind: zod.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: zod.z.number().describe("Arc start angle in degrees, CCW from +x axis (math convention; SVG y-down means visual CW)"),
+	startAngle: zod.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: zod.z.number().describe("Arc end angle in degrees; sweep direction inferred from startAngle vs endAngle"),
 	radius: zod.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 = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.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: zod.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: zod.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 = zod.z.object({
 	type: zod.z.literal("step").describe("Discriminator marking this as a path step node"),
-	kind: zod.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: zod.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: zod.z.number().positive().describe("Ellipse x-axis radius (semi-major or semi-minor on x)"),
 	radiusY: zod.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")