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

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;AAGxB,eAAO,MAAM,cAAc;;;;;;;;;;;;EAQyC,CAAC;AAErE,eAAO,MAAM,cAAc;;;;;;;;;;;;EAQ4C,CAAC;AAExE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAiBxB,CAAC;AAEJ,eAAO,MAAM,eAAe;;;;;;;;;EAWzB,CAAC;AAEJ,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE+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,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D;;;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

@@ -1,6 +1,27 @@
+import { PositionSchema } from "../position/position.js";
 import { TargetSchema } from "./target.js";
 import { z } from "zod";
 //#region src/ir/path/step.ts
+/**
+* 边标注（ADR-0004）：挂在画线 step 上的 label，渲染时按段几何 + side 偏移
+* 翻译为一个 TextPrim。`move` / `cycle` 不挂 label——前者不画线、后者是闭合
+* 标记，标签语义不清。
+*/
+var StepLabelSchema = z.object({
+	text: z.string().describe("Label text content. Single-line; for multi-line use \\n."),
+	position: z.enum([
+		"midway",
+		"near-start",
+		"near-end"
+	]).optional().describe("Position along the step segment (TikZ `midway` / `near start` / `near end`). Default `midway`."),
+	side: z.enum([
+		"above",
+		"below",
+		"left",
+		"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.");
 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\")"),
@@ -9,23 +30,84 @@ var MoveStepSchema = z.object({
 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\")"),
-	to: TargetSchema.describe("Destination point of the line segment")
+	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");
 var FoldStepSchema = z.object({
 	type: z.literal("step").describe("Discriminator marking this as a path step node"),
 	kind: z.literal("step").describe("Folded right-angle segment from cursor to target through one intermediate point (TikZ `-|` / `|-`)"),
 	via: z.enum(["-|", "|-"]).describe("Folding direction: `-|` first horizontal then vertical; `|-` first vertical then horizontal"),
-	to: TargetSchema.describe("Destination point of the folded segment")
+	to: TargetSchema.describe("Destination point of the folded segment"),
+	label: StepLabelSchema.optional().describe("Edge label attached to this folded segment; positioned along the corresponding leg by `position`.")
 }).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\")")
 }).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 与下游消费侧不变。
+*/
+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\")"),
+	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\")"),
+	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)"),
+	label: StepLabelSchema.optional().describe("Edge label attached to this cubic Bezier")
+}).describe("Cubic action: cubic Bezier; two control points give precise tangent control at both ends");
+var BendStepSchema = z.object({
+	type: z.literal("step").describe("Discriminator marking this as a path step node"),
+	kind: z.literal("bend").describe("Arc-like bend from cursor to target by direction + angle (TikZ `to[bend left=N]` / `to[bend right=N]`); compiles to a cubic Bezier approximation"),
+	to: TargetSchema.describe("Destination point of the bend"),
+	bendDirection: z.enum(["left", "right"]).describe("Bend side relative to from→to direction (visual left vs right of the chord)"),
+	bendAngle: z.number().optional().describe("Bend angle in degrees; default 30 (matches TikZ `bend left` without explicit angle)"),
+	label: StepLabelSchema.optional().describe("Edge label attached to this bend segment")
+}).describe("Bend action: shorthand for an arc-like cubic; control points computed at compile time");
+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)"),
+	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."),
+	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."),
+	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")
+}).describe("EllipsePath action: full closed ellipse around the cursor; pen returns to center.");
 var StepSchema = z.discriminatedUnion("kind", [
 	MoveStepSchema,
 	LineStepSchema,
 	FoldStepSchema,
-	CycleStepSchema
+	CycleStepSchema,
+	CurveStepSchema,
+	CubicStepSchema,
+	BendStepSchema,
+	ArcStepSchema,
+	CirclePathStepSchema,
+	EllipsePathStepSchema
 ]).describe("A single path action; the discriminator field is `kind`");
 //#endregion
-export { CycleStepSchema, FoldStepSchema, LineStepSchema, MoveStepSchema, StepSchema };
+export { ArcStepSchema, BendStepSchema, CirclePathStepSchema, ControlPointSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, EllipsePathStepSchema, FoldStepSchema, LineStepSchema, MoveStepSchema, StepLabelSchema, StepSchema };

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

@@ -1,5 +1,35 @@
 import { z } from 'zod';
-export declare const TargetSchema: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('..').PolarPosition, z.ZodTypeDef, import('..').PolarPosition>, z.ZodString]>;
-/** 路径端点：直接坐标 [x, y]、极坐标，或节点 id 字符串 */
+export declare const RelTargetSchema: z.ZodObject<{
+    rel: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+}, "strip", z.ZodTypeAny, {
+    rel: [number, number];
+}, {
+    rel: [number, number];
+}>;
+export declare const RelAccumulateTargetSchema: z.ZodObject<{
+    relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+}, "strip", z.ZodTypeAny, {
+    relAccumulate: [number, number];
+}, {
+    relAccumulate: [number, number];
+}>;
+export declare const TargetSchema: 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>;
+}, "strip", z.ZodTypeAny, {
+    rel: [number, number];
+}, {
+    rel: [number, number];
+}>, z.ZodObject<{
+    relAccumulate: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+}, "strip", z.ZodTypeAny, {
+    relAccumulate: [number, number];
+}, {
+    relAccumulate: [number, number];
+}>]>;
+/** 路径端点：直接坐标 [x, y]、极坐标、节点 id 字符串、相对偏移对象 */
 export type IRTarget = z.infer<typeof TargetSchema>;
+/** 相对前一 step 终点的偏移；不更新 prevEnd（TikZ `(+x, +y)`） */
+export type IRRelTarget = z.infer<typeof RelTargetSchema>;
+/** 累积相对偏移；更新 prevEnd（TikZ `(++x, ++y)`） */
+export type IRRelAccumulateTarget = z.infer<typeof RelAccumulateTargetSchema>;
 //# sourceMappingURL=target.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY,0JAItB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;EAQzB,CAAC;AAEJ,eAAO,MAAM,yBAAyB;;;;;;EAQnC,CAAC;AAEJ,eAAO,MAAM,YAAY;;;;;;;;;;;;IAUtB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEpD,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

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

@@ -2,10 +2,14 @@ import { PositionSchema } from "../position/position.js";
 import { PolarPositionSchema } from "../position/polar-position.js";
 import { z } from "zod";
 //#region src/ir/path/target.ts
+var RelTargetSchema = z.object({ rel: z.tuple([z.number(), z.number()]).describe("Relative offset (dx, dy)") }).describe("Relative offset from the previous step end point (does NOT update the cursor position; matches TikZ `(+x, +y)` syntax)");
+var RelAccumulateTargetSchema = z.object({ relAccumulate: z.tuple([z.number(), z.number()]).describe("Accumulated relative offset (dx, dy)") }).describe("Accumulated relative offset from the previous step end point (DOES update the cursor; matches TikZ `(++x, ++y)` syntax)");
 var TargetSchema = z.union([
 	PositionSchema,
 	PolarPositionSchema,
-	z.string().min(1)
-]).describe("Path endpoint: Cartesian [x, y], polar position (resolved at compile time), or node id reference");
+	z.string().min(1),
+	RelTargetSchema,
+	RelAccumulateTargetSchema
+]).describe("Path endpoint: Cartesian [x, y], polar position, node id reference, or relative offset object ({ rel } / { relAccumulate }) resolved at compile time");
 //#endregion
-export { TargetSchema };
+export { RelAccumulateTargetSchema, RelTargetSchema, TargetSchema };