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

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

@@ -0,0 +1,424 @@
+import { z } from 'zod';
+export declare const ChildSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"node">;
+    id: z.ZodOptional<z.ZodString>;
+    shape: z.ZodOptional<z.ZodNativeEnum<{
+        readonly rectangle: "rectangle";
+        readonly circle: "circle";
+        readonly ellipse: "ellipse";
+        readonly diamond: "diamond";
+    }>>;
+    position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
+    rotate: z.ZodOptional<z.ZodNumber>;
+    text: z.ZodOptional<z.ZodString>;
+    fill: z.ZodOptional<z.ZodString>;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    padding: z.ZodOptional<z.ZodNumber>;
+    margin: z.ZodOptional<z.ZodNumber>;
+    fontSize: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "node";
+    position: [number, number] | import('./position').PolarPosition;
+    fill?: string | undefined;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    stroke?: string | undefined;
+    strokeWidth?: number | undefined;
+    id?: string | undefined;
+    rotate?: number | undefined;
+    text?: string | undefined;
+    padding?: number | undefined;
+    margin?: number | undefined;
+    fontSize?: number | undefined;
+}, {
+    type: "node";
+    position: [number, number] | import('./position').PolarPosition;
+    fill?: string | undefined;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    stroke?: string | undefined;
+    strokeWidth?: number | undefined;
+    id?: string | undefined;
+    rotate?: number | undefined;
+    text?: string | undefined;
+    padding?: number | undefined;
+    margin?: number | undefined;
+    fontSize?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"path">;
+    stroke: z.ZodOptional<z.ZodString>;
+    strokeWidth: z.ZodOptional<z.ZodNumber>;
+    strokeDasharray: z.ZodOptional<z.ZodString>;
+    arrow: z.ZodOptional<z.ZodEnum<["none", "->", "<-", "<->"]>>;
+    arrowShape: z.ZodOptional<z.ZodNativeEnum<{
+        readonly normal: "normal";
+        readonly open: "open";
+        readonly stealth: "stealth";
+        readonly diamond: "diamond";
+        readonly openDiamond: "openDiamond";
+        readonly circle: "circle";
+        readonly openCircle: "openCircle";
+    }>>;
+    fill: z.ZodOptional<z.ZodString>;
+    fillRule: z.ZodOptional<z.ZodEnum<["nonzero", "evenodd"]>>;
+    children: z.ZodArray<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('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "step";
+        kind: "move";
+        to: string | [number, number] | import('./position').PolarPosition;
+    }, {
+        type: "step";
+        kind: "move";
+        to: string | [number, number] | import('./position').PolarPosition;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"step">;
+        kind: z.ZodLiteral<"line">;
+        to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "step";
+        kind: "line";
+        to: string | [number, number] | import('./position').PolarPosition;
+    }, {
+        type: "step";
+        kind: "line";
+        to: string | [number, number] | import('./position').PolarPosition;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"step">;
+        kind: z.ZodLiteral<"step">;
+        via: z.ZodEnum<["-|", "|-"]>;
+        to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodString]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "step";
+        kind: "step";
+        to: string | [number, number] | import('./position').PolarPosition;
+        via: "-|" | "|-";
+    }, {
+        type: "step";
+        kind: "step";
+        to: string | [number, number] | import('./position').PolarPosition;
+        via: "-|" | "|-";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"step">;
+        kind: z.ZodLiteral<"cycle">;
+    }, "strip", z.ZodTypeAny, {
+        type: "step";
+        kind: "cycle";
+    }, {
+        type: "step";
+        kind: "cycle";
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "path";
+    children: ({
+        type: "step";
+        kind: "move";
+        to: string | [number, number] | import('./position').PolarPosition;
+    } | {
+        type: "step";
+        kind: "line";
+        to: string | [number, number] | import('./position').PolarPosition;
+    } | {
+        type: "step";
+        kind: "step";
+        to: string | [number, number] | import('./position').PolarPosition;
+        via: "-|" | "|-";
+    } | {
+        type: "step";
+        kind: "cycle";
+    })[];
+    fill?: string | undefined;
+    stroke?: string | undefined;
+    strokeWidth?: number | undefined;
+    strokeDasharray?: string | undefined;
+    arrow?: "none" | "->" | "<-" | "<->" | undefined;
+    arrowShape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    fillRule?: "nonzero" | "evenodd" | undefined;
+}, {
+    type: "path";
+    children: ({
+        type: "step";
+        kind: "move";
+        to: string | [number, number] | import('./position').PolarPosition;
+    } | {
+        type: "step";
+        kind: "line";
+        to: string | [number, number] | import('./position').PolarPosition;
+    } | {
+        type: "step";
+        kind: "step";
+        to: string | [number, number] | import('./position').PolarPosition;
+        via: "-|" | "|-";
+    } | {
+        type: "step";
+        kind: "cycle";
+    })[];
+    fill?: string | undefined;
+    stroke?: string | undefined;
+    strokeWidth?: number | undefined;
+    strokeDasharray?: string | undefined;
+    arrow?: "none" | "->" | "<-" | "<->" | undefined;
+    arrowShape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    fillRule?: "nonzero" | "evenodd" | undefined;
+}>]>;
+/** 顶层 Scene 的子节点：node 或 path */
+export type IRChild = z.infer<typeof ChildSchema>;
+export declare const SceneSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"scene">;
+    children: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"node">;
+        id: z.ZodOptional<z.ZodString>;
+        shape: z.ZodOptional<z.ZodNativeEnum<{
+            readonly rectangle: "rectangle";
+            readonly circle: "circle";
+            readonly ellipse: "ellipse";
+            readonly diamond: "diamond";
+        }>>;
+        position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
+        rotate: z.ZodOptional<z.ZodNumber>;
+        text: z.ZodOptional<z.ZodString>;
+        fill: z.ZodOptional<z.ZodString>;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        padding: z.ZodOptional<z.ZodNumber>;
+        margin: z.ZodOptional<z.ZodNumber>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "node";
+        position: [number, number] | import('./position').PolarPosition;
+        fill?: string | undefined;
+        shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        id?: string | undefined;
+        rotate?: number | undefined;
+        text?: string | undefined;
+        padding?: number | undefined;
+        margin?: number | undefined;
+        fontSize?: number | undefined;
+    }, {
+        type: "node";
+        position: [number, number] | import('./position').PolarPosition;
+        fill?: string | undefined;
+        shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        id?: string | undefined;
+        rotate?: number | undefined;
+        text?: string | undefined;
+        padding?: number | undefined;
+        margin?: number | undefined;
+        fontSize?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"path">;
+        stroke: z.ZodOptional<z.ZodString>;
+        strokeWidth: z.ZodOptional<z.ZodNumber>;
+        strokeDasharray: z.ZodOptional<z.ZodString>;
+        arrow: z.ZodOptional<z.ZodEnum<["none", "->", "<-", "<->"]>>;
+        arrowShape: z.ZodOptional<z.ZodNativeEnum<{
+            readonly normal: "normal";
+            readonly open: "open";
+            readonly stealth: "stealth";
+            readonly diamond: "diamond";
+            readonly openDiamond: "openDiamond";
+            readonly circle: "circle";
+            readonly openCircle: "openCircle";
+        }>>;
+        fill: z.ZodOptional<z.ZodString>;
+        fillRule: z.ZodOptional<z.ZodEnum<["nonzero", "evenodd"]>>;
+        children: z.ZodArray<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('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "step";
+            kind: "move";
+            to: string | [number, number] | import('./position').PolarPosition;
+        }, {
+            type: "step";
+            kind: "move";
+            to: string | [number, number] | import('./position').PolarPosition;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"step">;
+            kind: z.ZodLiteral<"line">;
+            to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "step";
+            kind: "line";
+            to: string | [number, number] | import('./position').PolarPosition;
+        }, {
+            type: "step";
+            kind: "line";
+            to: string | [number, number] | import('./position').PolarPosition;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"step">;
+            kind: z.ZodLiteral<"step">;
+            via: z.ZodEnum<["-|", "|-"]>;
+            to: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "step";
+            kind: "step";
+            to: string | [number, number] | import('./position').PolarPosition;
+            via: "-|" | "|-";
+        }, {
+            type: "step";
+            kind: "step";
+            to: string | [number, number] | import('./position').PolarPosition;
+            via: "-|" | "|-";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"step">;
+            kind: z.ZodLiteral<"cycle">;
+        }, "strip", z.ZodTypeAny, {
+            type: "step";
+            kind: "cycle";
+        }, {
+            type: "step";
+            kind: "cycle";
+        }>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "path";
+        children: ({
+            type: "step";
+            kind: "move";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "line";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "step";
+            to: string | [number, number] | import('./position').PolarPosition;
+            via: "-|" | "|-";
+        } | {
+            type: "step";
+            kind: "cycle";
+        })[];
+        fill?: string | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        strokeDasharray?: string | undefined;
+        arrow?: "none" | "->" | "<-" | "<->" | undefined;
+        arrowShape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        fillRule?: "nonzero" | "evenodd" | undefined;
+    }, {
+        type: "path";
+        children: ({
+            type: "step";
+            kind: "move";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "line";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "step";
+            to: string | [number, number] | import('./position').PolarPosition;
+            via: "-|" | "|-";
+        } | {
+            type: "step";
+            kind: "cycle";
+        })[];
+        fill?: string | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        strokeDasharray?: string | undefined;
+        arrow?: "none" | "->" | "<-" | "<->" | undefined;
+        arrowShape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        fillRule?: "nonzero" | "evenodd" | undefined;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "scene";
+    children: ({
+        type: "path";
+        children: ({
+            type: "step";
+            kind: "move";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "line";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "step";
+            to: string | [number, number] | import('./position').PolarPosition;
+            via: "-|" | "|-";
+        } | {
+            type: "step";
+            kind: "cycle";
+        })[];
+        fill?: string | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        strokeDasharray?: string | undefined;
+        arrow?: "none" | "->" | "<-" | "<->" | undefined;
+        arrowShape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        fillRule?: "nonzero" | "evenodd" | undefined;
+    } | {
+        type: "node";
+        position: [number, number] | import('./position').PolarPosition;
+        fill?: string | undefined;
+        shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        id?: string | undefined;
+        rotate?: number | undefined;
+        text?: string | undefined;
+        padding?: number | undefined;
+        margin?: number | undefined;
+        fontSize?: number | undefined;
+    })[];
+    version: 1;
+}, {
+    type: "scene";
+    children: ({
+        type: "path";
+        children: ({
+            type: "step";
+            kind: "move";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "line";
+            to: string | [number, number] | import('./position').PolarPosition;
+        } | {
+            type: "step";
+            kind: "step";
+            to: string | [number, number] | import('./position').PolarPosition;
+            via: "-|" | "|-";
+        } | {
+            type: "step";
+            kind: "cycle";
+        })[];
+        fill?: string | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        strokeDasharray?: string | undefined;
+        arrow?: "none" | "->" | "<-" | "<->" | undefined;
+        arrowShape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        fillRule?: "nonzero" | "evenodd" | undefined;
+    } | {
+        type: "node";
+        position: [number, number] | import('./position').PolarPosition;
+        fill?: string | undefined;
+        shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+        stroke?: string | undefined;
+        strokeWidth?: number | undefined;
+        id?: string | undefined;
+        rotate?: number | undefined;
+        text?: string | undefined;
+        padding?: number | undefined;
+        margin?: number | undefined;
+        fontSize?: number | undefined;
+    })[];
+    version: 1;
+}>;
+/** retikz IR 顶层 Scene——可序列化 JSON 形式的绘制描述 */
+export type IR = z.infer<typeof SceneSchema>;
+/** IR 当前主版本号；只在 schema 出现破坏性变更时递增 */
+export declare const CURRENT_IR_VERSION: 1;
+//# sourceMappingURL=scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/ir/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIrB,CAAC;AAEJ,gCAAgC;AAChC,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAElD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBrB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAE7C,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC"}

package/dist/es/ir/scene.js

@@ -0,0 +1,14 @@
+import { PathSchema } from "./path/path.js";
+import { NodeSchema } from "./node.js";
+import { z } from "zod";
+//#region src/ir/scene.ts
+var ChildSchema = z.discriminatedUnion("type", [NodeSchema, PathSchema]).describe("Top-level scene child: either a node or a path; discriminator field is `type`");
+var SceneSchema = z.object({
+	version: z.literal(1).describe("IR major version number; bump only on breaking schema changes"),
+	type: z.literal("scene").describe("Discriminator marking this object as the root scene"),
+	children: z.array(ChildSchema).describe("Top-level children of the scene; nodes register ids that paths can reference")
+}).describe("Top-level retikz IR scene — the canonical, JSON-serializable representation of a drawing");
+/** IR 当前主版本号；只在 schema 出现破坏性变更时递增 */
+var CURRENT_IR_VERSION = 1;
+//#endregion
+export { CURRENT_IR_VERSION, ChildSchema, SceneSchema };

package/dist/es/parsers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './parseWay';
+//# sourceMappingURL=index.d.ts.map

package/dist/es/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/es/parsers/parseWay.d.ts

@@ -0,0 +1,71 @@
+import { IRStep, IRTarget } from '../ir';
+/**
+ * Sugar 层 way 数组的"关键字常量"。
+ *
+ * - `DrawWay.cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
+ *   （`'retikz-keyword_cycle'`），保证不会与任何合理的节点 id 冲突；用户应当
+ *   只通过 `DrawWay.cycle` 引用，不要直接写裸字面量。
+ * - `DrawWay.hv`：折角算子，先水平后垂直（裸字面量 `'-|'`）。
+ * - `DrawWay.vh`：折角算子，先垂直后水平（裸字面量 `'|-'`）。
+ *
+ * 折角值（`-|` / `|-`）含特殊字符，与节点 id 不会冲突，因此**保留字面量与
+ * 常量两种写法都合法**。way 数组里直接放 `'-|'` 或 `'|-'`（infix 算子）
+ * 即把"上一项 → 下一项"那一段改成折角。
+ *
+ * 这里**故意不用 TS enum**——enum 在数值场景下生成 reverse-mapping 表、
+ * 在 string 场景下与字面量类型不互通，而 const + `as const` 的字面量联合
+ * 既可枚举也可与字面量字符串无缝混用。
+ */
+export declare const DrawWay: {
+    /**
+     * 闭合 way 到起点，等价于 `<Step kind="cycle" />`（TikZ 同名保留字 / SVG `Z`）。
+     * 底层字符串值刻意写丑以避开节点 id 冲突；不要硬编码这个字符串。
+     */
+    readonly cycle: "retikz-keyword_cycle";
+    /** 折角：先水平后垂直（TikZ `-|`） */
+    readonly hv: "-|";
+    /** 折角：先垂直后水平（TikZ `|-`） */
+    readonly vh: "|-";
+};
+/**
+ * way 折角算子的字面量类型。`DrawWay.hv` / `DrawWay.vh` 与裸字面量等价。
+ */
+export type WayVia = typeof DrawWay.hv | typeof DrawWay.vh;
+/**
+ * way 闭合关键字的字面量类型，由 `DrawWay.cycle` 派生。
+ */
+export type WayCycle = typeof DrawWay.cycle;
+/**
+ * Sugar 层的 way 数组 DSL 元素。
+ *
+ * v0.1.0-alpha.1 接受五种形态：
+ * - 节点 id 字符串：`'A'` → line（首项时为 move）
+ * - 笛卡尔坐标：`[x, y]` → line
+ * - 极坐标：`{ origin?, angle, radius }` → line
+ * - 折角算子：`'-|'` / `'|-'`（或 `DrawWay.hv` / `DrawWay.vh`）→ 当前项 +
+ *   **下一项**合并成一个折角 step（与 TikZ 的 `(A) -| (B)` infix 写法对齐）
+ * - 闭合关键字：`DrawWay.cycle` → cycle（闭合到起点）
+ *
+ * 后续会加：相对位移（`{ rel: [x, y] }`）、curve / cubic 等。
+ *
+ * 注意：闭合刻意只走 `DrawWay.cycle`（底层字符串是 `'retikz-keyword_cycle'`），
+ * 这样裸字符串 `'cycle'` 仍可作为正常节点 id 使用。
+ */
+export type WayItem = IRTarget | WayVia | WayCycle;
+/** way DSL 数组：sugar `<Draw way={...}>` 接受的输入形态 */
+export type WayDSL = Array<WayItem>;
+/**
+ * 把 way 数组翻译为 IRStep 序列。
+ *
+ * - 第一个元素始终是 move：取 way[0] 的目标点；若 way[0] 是 cycle / via 算子等
+ *   非 target 项，则降级到原点 `[0, 0]`（容错）。
+ * - 后续元素：
+ *   - 普通 target → line
+ *   - `DrawWay.cycle` → cycle 步
+ *   - `'-|'` / `'|-'` → 与**下一项**合并成 fold 步；操作符在 way 末尾或后
+ *     接非 target 项时抛错
+ *
+ * 这是纯函数，住在 core，被各框架 adapter 的 Sugar 组件复用。
+ */
+export declare const parseWay: (way: WayDSL) => Array<IRStep>;
+//# sourceMappingURL=parseWay.d.ts.map

package/dist/es/parsers/parseWay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseWay.d.ts","sourceRoot":"","sources":["../../../src/parsers/parseWay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,MAAM,EACN,QAAQ,EACT,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO;IAClB;;;OAGG;;IAEH,2BAA2B;;IAE3B,2BAA2B;;CAEnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,EAAE,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,KAAK,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,kDAAkD;AAClD,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAapC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,KAAK,CAAC,MAAM,CAoClD,CAAC"}

package/dist/es/parsers/parseWay.js

@@ -0,0 +1,92 @@
+//#region src/parsers/parseWay.ts
+/**
+* Sugar 层 way 数组的"关键字常量"。
+*
+* - `DrawWay.cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
+*   （`'retikz-keyword_cycle'`），保证不会与任何合理的节点 id 冲突；用户应当
+*   只通过 `DrawWay.cycle` 引用，不要直接写裸字面量。
+* - `DrawWay.hv`：折角算子，先水平后垂直（裸字面量 `'-|'`）。
+* - `DrawWay.vh`：折角算子，先垂直后水平（裸字面量 `'|-'`）。
+*
+* 折角值（`-|` / `|-`）含特殊字符，与节点 id 不会冲突，因此**保留字面量与
+* 常量两种写法都合法**。way 数组里直接放 `'-|'` 或 `'|-'`（infix 算子）
+* 即把"上一项 → 下一项"那一段改成折角。
+*
+* 这里**故意不用 TS enum**——enum 在数值场景下生成 reverse-mapping 表、
+* 在 string 场景下与字面量类型不互通，而 const + `as const` 的字面量联合
+* 既可枚举也可与字面量字符串无缝混用。
+*/
+var DrawWay = {
+	/**
+	* 闭合 way 到起点，等价于 `<Step kind="cycle" />`（TikZ 同名保留字 / SVG `Z`）。
+	* 底层字符串值刻意写丑以避开节点 id 冲突；不要硬编码这个字符串。
+	*/
+	cycle: "retikz-keyword_cycle",
+	/** 折角：先水平后垂直（TikZ `-|`） */
+	hv: "-|",
+	/** 折角：先垂直后水平（TikZ `|-`） */
+	vh: "|-"
+};
+var isWayCycle = (item) => item === DrawWay.cycle;
+var isWayVia = (item) => item === DrawWay.hv || item === DrawWay.vh;
+/** 把 WayItem 归约为它的"目标点"——target 直接返回；算子/关键字返回 null */
+var targetOf = (item) => {
+	if (isWayCycle(item) || isWayVia(item)) return null;
+	return item;
+};
+/**
+* 把 way 数组翻译为 IRStep 序列。
+*
+* - 第一个元素始终是 move：取 way[0] 的目标点；若 way[0] 是 cycle / via 算子等
+*   非 target 项，则降级到原点 `[0, 0]`（容错）。
+* - 后续元素：
+*   - 普通 target → line
+*   - `DrawWay.cycle` → cycle 步
+*   - `'-|'` / `'|-'` → 与**下一项**合并成 fold 步；操作符在 way 末尾或后
+*     接非 target 项时抛错
+*
+* 这是纯函数，住在 core，被各框架 adapter 的 Sugar 组件复用。
+*/
+var parseWay = (way) => {
+	if (way.length < 2) throw new Error("parseWay: way must contain at least 2 items");
+	const out = [];
+	const moveStep = {
+		type: "step",
+		kind: "move",
+		to: targetOf(way[0]) ?? [0, 0]
+	};
+	out.push(moveStep);
+	for (let i = 1; i < way.length; i++) {
+		const item = way[i];
+		if (isWayCycle(item)) {
+			out.push({
+				type: "step",
+				kind: "cycle"
+			});
+			continue;
+		}
+		if (isWayVia(item)) {
+			if (i + 1 >= way.length) throw new Error(`parseWay: via operator '${item}' at end of way must be followed by a target`);
+			const next = way[i + 1];
+			if (isWayCycle(next) || isWayVia(next)) throw new Error(`parseWay: via operator '${item}' must be followed by a target, got '${String(next)}'`);
+			const fold = {
+				type: "step",
+				kind: "step",
+				via: item,
+				to: next
+			};
+			out.push(fold);
+			i++;
+			continue;
+		}
+		const lineStep = {
+			type: "step",
+			kind: "line",
+			to: item
+		};
+		out.push(lineStep);
+	}
+	return out;
+};
+//#endregion
+export { DrawWay, parseWay };

package/dist/es/primitive/ellipse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 椭圆原语：SVG `<ellipse>` 直对应。
+ * 圆形（半长轴 = 半短轴）用同一个 EllipsePrim 表示，让 renderer 单一 case 处理。
+ * 旋转走 `rotate` 字段（度数，绕中心）；非零时 renderer 用 SVG transform 包裹。
+ */
+export type EllipsePrim = {
+    /** 类型判别符 */
+    type: 'ellipse';
+    /** 中心横坐标 */
+    cx: number;
+    /** 中心纵坐标 */
+    cy: number;
+    /** 水平半轴 */
+    rx: number;
+    /** 垂直半轴 */
+    ry: number;
+    /** 绕中心的旋转角（度数，与 RectPrim 风格一致）；省略或 0 不旋转 */
+    rotate?: number;
+    /** 填充色 */
+    fill?: string;
+    /** 填充透明度 0~1 */
+    fillOpacity?: number;
+    /** 描边色 */
+    stroke?: string;
+    /** 描边宽度 */
+    strokeWidth?: number;
+    /** SVG stroke-dasharray 模式 */
+    strokeDasharray?: string;
+    /** 整体透明度 0~1 */
+    opacity?: number;
+};
+//# sourceMappingURL=ellipse.d.ts.map

package/dist/es/primitive/ellipse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/primitive/ellipse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/es/primitive/group.d.ts

@@ -0,0 +1,11 @@
+import { ScenePrimitive } from './scene';
+/** 编组：把若干 primitive 用 transform 包起来 */
+export type GroupPrim = {
+    /** 类型判别符 */
+    type: 'group';
+    /** SVG transform 字符串（translate / rotate / scale 等） */
+    transform?: string;
+    /** 组内子原语 */
+    children: Array<ScenePrimitive>;
+};
+//# sourceMappingURL=group.d.ts.map

package/dist/es/primitive/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/primitive/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CACjC,CAAC"}