@retikz/core 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/lib/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/lib/ir/path/target.cjs

@@ -2,10 +2,16 @@ const require_position = require("../position/position.cjs");
 const require_polar_position = require("../position/polar-position.cjs");
 let zod = require("zod");
 //#region src/ir/path/target.ts
+var RelTargetSchema = zod.z.object({ rel: zod.z.tuple([zod.z.number(), zod.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 = zod.z.object({ relAccumulate: zod.z.tuple([zod.z.number(), zod.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 = zod.z.union([
 	require_position.PositionSchema,
 	require_polar_position.PolarPositionSchema,
-	zod.z.string().min(1)
-]).describe("Path endpoint: Cartesian [x, y], polar position (resolved at compile time), or node id reference");
+	zod.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
+exports.RelAccumulateTargetSchema = RelAccumulateTargetSchema;
+exports.RelTargetSchema = RelTargetSchema;
 exports.TargetSchema = TargetSchema;

package/dist/lib/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/lib/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/lib/ir/position/at-position.cjs

@@ -0,0 +1,31 @@
+let zod = require("zod");
+//#region src/ir/position/at-position.ts
+/**
+* 节点相对方向常量。8 方向（4 主向 + 4 对角），按视觉语义：
+* - above:  y 减小（视觉上方）
+* - below:  y 增大（视觉下方）
+* - left:   x 减小（视觉左方）
+* - right:  x 增大（视觉右方）
+* - 4 对角：两轴各 1/√2 单位向量分量（对角距离与 distance 等长）
+*
+* 与 TikZ `positioning` library 的 `above of` / `right of` / `above right of` 对齐
+* （TikZ y 向上、retikz y 向下，但 `above` 视觉语义在两边一致——视觉上方）。
+*/
+var AT_DIRECTIONS = {
+	above: "above",
+	below: "below",
+	left: "left",
+	right: "right",
+	"above-left": "above-left",
+	"above-right": "above-right",
+	"below-left": "below-left",
+	"below-right": "below-right"
+};
+var AtPositionSchema = zod.z.object({
+	direction: zod.z.nativeEnum(AT_DIRECTIONS).describe("Direction from the referenced node toward this node, in visual convention (above = visually upward, screen y-)."),
+	of: zod.z.string().min(1).describe("Id of the referenced node or coordinate; must be defined earlier in the IR (forward references rejected, mirroring polar `origin` and string targets)."),
+	distance: zod.z.number().positive().optional().describe("Distance from the referenced node center to this node center in user units. Falls back to the Tikz `nodeDistance` compile-time context, then to 1.")
+}).describe("Relative position: place this node at `direction` direction from `of`, `distance` away. Mirrors TikZ `[<direction>=<distance> of <id>]` from the positioning library.");
+//#endregion
+exports.AT_DIRECTIONS = AT_DIRECTIONS;
+exports.AtPositionSchema = AtPositionSchema;

package/dist/lib/ir/position/at-position.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { ValueOf } from '../../types';
+/**
+ * 节点相对方向常量。8 方向（4 主向 + 4 对角），按视觉语义：
+ * - above:  y 减小（视觉上方）
+ * - below:  y 增大（视觉下方）
+ * - left:   x 减小（视觉左方）
+ * - right:  x 增大（视觉右方）
+ * - 4 对角：两轴各 1/√2 单位向量分量（对角距离与 distance 等长）
+ *
+ * 与 TikZ `positioning` library 的 `above of` / `right of` / `above right of` 对齐
+ * （TikZ y 向上、retikz y 向下，但 `above` 视觉语义在两边一致——视觉上方）。
+ */
+export declare const AT_DIRECTIONS: {
+    readonly above: "above";
+    readonly below: "below";
+    readonly left: "left";
+    readonly right: "right";
+    readonly 'above-left': "above-left";
+    readonly 'above-right': "above-right";
+    readonly 'below-left': "below-left";
+    readonly 'below-right': "below-right";
+};
+/** at 方向字面量类型；由 `AT_DIRECTIONS` 派生 */
+export type AtDirection = ValueOf<typeof AT_DIRECTIONS>;
+export declare const AtPositionSchema: z.ZodObject<{
+    direction: z.ZodNativeEnum<{
+        readonly above: "above";
+        readonly below: "below";
+        readonly left: "left";
+        readonly right: "right";
+        readonly 'above-left': "above-left";
+        readonly 'above-right': "above-right";
+        readonly 'below-left': "below-left";
+        readonly 'below-right': "below-right";
+    }>;
+    of: z.ZodString;
+    distance: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
+    of: string;
+    distance?: number | undefined;
+}, {
+    direction: "above" | "below" | "left" | "right" | "above-left" | "above-right" | "below-left" | "below-right";
+    of: string;
+    distance?: number | undefined;
+}>;
+/** 相对定位的 IR 类型——`{ direction, of, distance? }`，与 `IRPosition` / `PolarPosition` 在 union 里平级 */
+export type IRAtPosition = z.infer<typeof AtPositionSchema>;
+//# sourceMappingURL=at-position.d.ts.map

package/dist/lib/ir/position/at-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"at-position.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/at-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CAShB,CAAC;AAEX,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAuB1B,CAAC;AAEJ,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

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

@@ -1,3 +1,4 @@
 export * from './position';
 export * from './polar-position';
+export * from './at-position';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ir/position/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/lib/ir/scene.cjs

@@ -1,8 +1,13 @@
 const require_path = require("./path/path.cjs");
 const require_node = require("./node.cjs");
+const require_coordinate = require("./coordinate.cjs");
 let zod = require("zod");
 //#region src/ir/scene.ts
-var ChildSchema = zod.z.discriminatedUnion("type", [require_node.NodeSchema, require_path.PathSchema]).describe("Top-level scene child: either a node or a path; discriminator field is `type`");
+var ChildSchema = zod.z.discriminatedUnion("type", [
+	require_node.NodeSchema,
+	require_path.PathSchema,
+	require_coordinate.CoordinateSchema
+]).describe("Top-level scene child: a node, a path, or a coordinate placeholder; discriminator field is `type`");
 var SceneSchema = zod.z.object({
 	version: zod.z.literal(1).describe("IR major version number; bump only on breaking schema changes"),
 	type: zod.z.literal("scene").describe("Discriminator marking this object as the root scene"),