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

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

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/ir/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIrB,CAAC;AAEJ,6CAA6C;AAC7C,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"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/ir/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}

package/dist/lib/ir/text.cjs

@@ -0,0 +1,21 @@
+const require_font = require("./font.cjs");
+let zod = require("zod");
+//#region src/ir/text.ts
+/**
+* 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
+* @description 行级覆盖只生效于本行；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
+*/
+var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
+	text: zod.z.string().describe("Line content"),
+	fill: zod.z.string().optional().describe("Per-line text color; overrides block default"),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Per-line opacity 0..1"),
+	font: require_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，行级覆盖天然落字段；通用文本结构，Node text / 未来 Step.label 等共用
+*/
+var TextBlockSchema = zod.z.union([zod.z.string(), zod.z.array(LineSpecSchema).min(1)]).describe("Text block: a single string for one line, or a non-empty array of line specs (string for default, object for per-line overrides).");
+//#endregion
+exports.LineSpecSchema = LineSpecSchema;
+exports.TextBlockSchema = TextBlockSchema;

package/dist/lib/ir/text.d.ts

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+/**
+ * 单行文本规格：纯字符串走块级默认，对象形式可覆盖 fill/opacity/font
+ * @description 行级覆盖只生效于本行；font 子字段未填则继承块级；align/lineHeight 不可被行覆盖
+ */
+export declare const LineSpecSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    text: z.ZodString;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}>]>;
+/** 行规格 IR 类型 */
+export type IRLineSpec = z.infer<typeof LineSpecSchema>;
+/**
+ * 文本块：单字符串或非空多行 LineSpec 数组
+ * @description 选数组而非 `\n` 字符串：JSON 友好无 escape，行级覆盖天然落字段；通用文本结构，Node text / 未来 Step.label 等共用
+ */
+export declare const TextBlockSchema: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    text: z.ZodString;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}>]>, "many">]>;
+/** 文本块 IR 类型（单字符串或多行 LineSpec 数组） */
+export type IRTextBlock = z.infer<typeof TextBlockSchema>;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/ir/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBxB,CAAC;AAEJ,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAIzB,CAAC;AAEJ,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/lib/parsers/parseTargetSugar.cjs

@@ -1,31 +1,19 @@
 //#region src/parsers/parseTargetSugar.ts
+/** TikZ 风格相对偏移字面量正则：捕获 `+` / `++` 前缀 + dx / dy 数值 */
+var RELATIVE_OFFSET_RE = /^(\+{1,2})\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)$/;
 /**
-* Sugar 字符串解析：识别 TikZ 风格的相对偏移字面量，把 `'+1,0'` /
-* `'++1.5,-2'` 这类字符串转成 IR 的 { rel } / { relAccumulate } 对象；
-* 其它形态（节点 id `'A'` / `'A.north'`、笛卡尔元组、极坐标对象、已经
-* 是 rel/relAccumulate 对象）原样返回。
-*
-* 语法：
-* - `'+<dx>,<dy>'`     → `{ rel: [dx, dy] }`           （TikZ `+` 语义，不更新 prevEnd）
-* - `'++<dx>,<dy>'`    → `{ relAccumulate: [dx, dy] }` （TikZ `++` 语义，累积更新）
-* - `<dx>` / `<dy>`：可带正负号小数，如 `'+1,0'` / `'++1.5,-2.5'` / `'+ -3, 4'`
-*
-* 不匹配的字符串（如 `'A'` / `'A.north'` / `'A.30'`）原样返回——首字母为字母时
-* 不会撞 `+` 前缀；含 `.` 但不含 `,` 的也不撞。
-*
-* 这是纯函数，没有 nodeIndex 依赖，住在 core/parsers，react adapter 与
-* Draw way DSL 共用。
+* Sugar 字符串解析：TikZ 风格相对偏移字面量 → IR 对象
+* @description `'+dx,dy'` → `{relative:[dx,dy]}`（TikZ `+`，不更新 prevEnd）；`'++dx,dy'` → `{relativeAccumulate:[dx,dy]}`（TikZ `++`，累积）；其他形态（节点 id、笛卡尔 / 极坐标、已是 relative 对象）原样返回。纯函数无 nodeIndex 依赖，react adapter 与 Draw DSL 共用
 */
-var REL_RE = /^(\+{1,2})\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)$/;
 var parseTargetSugar = (input) => {
 	if (typeof input !== "string") return input;
-	const match = input.match(REL_RE);
+	const match = input.match(RELATIVE_OFFSET_RE);
 	if (!match) return input;
 	const plus = match[1];
 	const dx = Number(match[2]);
 	const dy = Number(match[3]);
-	if (plus === "++") return { relAccumulate: [dx, dy] };
-	return { rel: [dx, dy] };
+	if (plus === "++") return { relativeAccumulate: [dx, dy] };
+	return { relative: [dx, dy] };
 };
 //#endregion
 exports.parseTargetSugar = parseTargetSugar;

package/dist/lib/parsers/parseTargetSugar.d.ts

@@ -1,3 +1,7 @@
 import { IRTarget } from '../ir';
+/**
+ * Sugar 字符串解析：TikZ 风格相对偏移字面量 → IR 对象
+ * @description `'+dx,dy'` → `{relative:[dx,dy]}`（TikZ `+`，不更新 prevEnd）；`'++dx,dy'` → `{relativeAccumulate:[dx,dy]}`（TikZ `++`，累积）；其他形态（节点 id、笛卡尔 / 极坐标、已是 relative 对象）原样返回。纯函数无 nodeIndex 依赖，react adapter 与 Draw DSL 共用
+ */
 export declare const parseTargetSugar: (input: unknown) => IRTarget;
 //# sourceMappingURL=parseTargetSugar.d.ts.map

package/dist/lib/parsers/parseTargetSugar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseTargetSugar.d.ts","sourceRoot":"","sources":["../../../src/parsers/parseTargetSugar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAqBtC,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,QAWjD,CAAC"}
+{"version":3,"file":"parseTargetSugar.d.ts","sourceRoot":"","sources":["../../../src/parsers/parseTargetSugar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAKtC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,QAWjD,CAAC"}

package/dist/lib/parsers/parseWay.cjs

@@ -1,51 +1,25 @@
 const require_parseTargetSugar = require("./parseTargetSugar.cjs");
 //#region src/parsers/parseWay.ts
 /**
-* Sugar 层 way 数组的"关键字常量"。
-*
-* - `DrawWay.Cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
-*   （`'retikz-keyword_cycle'`），保证不会与任何合理的节点 id 冲突；用户应当
-*   只通过 `DrawWay.Cycle` 引用，不要直接写裸字面量。
-* - `DrawWay.Hv`：折角算子，先水平后垂直（裸字面量 `'-|'`）。
-* - `DrawWay.Vh`：折角算子，先垂直后水平（裸字面量 `'|-'`）。
-* - `DrawWay.Relative` / `DrawWay.Accumulate`：相对偏移 way item 的 `type` 鉴别字段值。
-*   配合 `{ position: [dx, dy], type: DrawWay.Relative | DrawWay.Accumulate }` 用——
-*   `Relative` 等价 TikZ `(+x, +y)`（不更新 prevEnd），`Accumulate` 等价 TikZ `(++x, ++y)`
-*   （累积更新）。底层字符串同样刻意写丑，保证不撞节点 id；用户只通过常量引用。
-*
-* 折角值（`-|` / `|-`）含特殊字符，与节点 id 不会冲突，因此**保留字面量与
-* 常量两种写法都合法**。way 数组里直接放 `'-|'` 或 `'|-'`（infix 算子）
-* 即把"上一项 → 下一项"那一段改成折角。
-*
-* 这里**故意不用 TS enum**——enum 在数值场景下生成 reverse-mapping 表、
-* 在 string 场景下与字面量类型不互通，而 const + `as const` 的字面量联合
-* 既可枚举也可与字面量字符串无缝混用。
+* Sugar 层 way 数组的关键字常量
+* @description Cycle 闭合到 way 起点（底层字符串故意写丑避节点 id 冲突，只通过 DrawWay.Cycle 引用）；Hv/Vh 折角算子（裸字面量 `-|`/`|-` 与常量等价）；Relative/Accumulate 相对偏移 way item 的 type 鉴别值（Relative=TikZ `(+x,+y)` 不推进 prevEnd，Accumulate=TikZ `(++x,++y)` 累积更新）。用 const + as const 而非 TS enum 避免 reverse-mapping 与字面量不互通
 */
 var DrawWay = {
-	/**
-	* 闭合 way 到起点，等价于 `<Step kind="cycle" />`（TikZ 同名保留字 / SVG `Z`）。
-	* 底层字符串值刻意写丑以避开节点 id 冲突；不要硬编码这个字符串。
-	*/
+	/** 闭合到起点（TikZ `cycle` / SVG `Z`），底层字符串刻意写丑，不要硬编码 */
 	Cycle: "retikz-keyword_cycle",
 	/** 折角：先水平后垂直（TikZ `-|`） */
 	Hv: "-|",
 	/** 折角：先垂直后水平（TikZ `|-`） */
 	Vh: "|-",
-	/**
-	* 相对偏移 way item 的 `type` 字段值——非累积分支，等价 TikZ `(+x, +y)`。
-	* 解析为 IR `{ rel: position }`，**不**推进 prevEnd；多段链式偏移共享同一锚点。
-	*/
+	/** 相对偏移 type：非累积（TikZ `(+x,+y)`），不推进 prevEnd */
 	Relative: "retikz-keyword_relative",
-	/**
-	* 相对偏移 way item 的 `type` 字段值——累积分支，等价 TikZ `(++x, ++y)`。
-	* 解析为 IR `{ relAccumulate: position }`，每段累积更新 prevEnd。
-	*/
+	/** 相对偏移 type：累积（TikZ `(++x,++y)`），每段更新 prevEnd */
 	Accumulate: "retikz-keyword_accumulate"
 };
 var isWayCycle = (item) => item === DrawWay.Cycle;
 var isWayVia = (item) => item === DrawWay.Hv || item === DrawWay.Vh;
 var isPlainObject = (item) => typeof item === "object" && item !== null && !Array.isArray(item);
-var isWayRelItem = (item) => isPlainObject(item) && "position" in item && "type" in item;
+var isWayRelativeItem = (item) => isPlainObject(item) && "position" in item && "type" in item;
 var isWayCurveOp = (item) => isPlainObject(item) && "curve" in item;
 var isWayCubicOp = (item) => isPlainObject(item) && "cubic" in item;
 var isWayBendOp = (item) => isPlainObject(item) && "bend" in item;
@@ -56,42 +30,26 @@ var isWayEllipseOp = (item) => isPlainObject(item) && "ellipse" in item;
 var isWayShapeOp = (item) => isWayArcOp(item) || isWayCircleOp(item) || isWayEllipseOp(item);
 var isWayLabelOp = (item) => isPlainObject(item) && "label" in item;
 var isWayOperator = (item) => isWayCycle(item) || isWayVia(item) || isWayCurveLike(item) || isWayShapeOp(item) || isWayLabelOp(item);
-/** sugar 字符串 / 对象都映射到 IR `step.label`：字符串 = `{ text: s }`，对象原样取 */
+/** sugar 字符串/对象 → IR step.label（字符串 = `{text:s}`） */
 var normalizeLabel = (l) => typeof l === "string" ? { text: l } : { ...l };
-/**
-* 把 sugar 对象形态 `{ position, type }` 翻译为 IR `{ rel } | { relAccumulate }`；
-* 其它形态原样返回。在每个 parseTargetSugar 入口前调用，集中处理。
-*/
-var desugarRelItem = (item) => {
-	if (!isWayRelItem(item)) return item;
-	return item.type === DrawWay.Accumulate ? { relAccumulate: item.position } : { rel: item.position };
+/** sugar `{position,type}` → IR `{relative}|{relativeAccumulate}`；其它形态原样返回 */
+var desugarRelativeItem = (item) => {
+	if (!isWayRelativeItem(item)) return item;
+	return item.type === DrawWay.Accumulate ? { relativeAccumulate: item.position } : { relative: item.position };
 };
-/** 把 WayItem 归约为它的"目标点"——target 直接返回；算子/关键字返回 null */
+/** WayItem 归约为"目标点"，算子/关键字返回 null */
 var targetOf = (item) => {
 	if (isWayOperator(item)) return null;
-	return desugarRelItem(item);
+	return desugarRelativeItem(item);
 };
 /**
-* 把 way 数组翻译为 IRStep 序列。
-*
-* - 第一个元素始终是 move：取 way[0] 的目标点；若 way[0] 是 cycle / via 算子等
-*   非 target 项，则降级到原点 `[0, 0]`（容错）。
-* - 后续元素：
-*   - 普通 target / `WayRelItem` → line
-*   - `DrawWay.Cycle` → cycle 步
-*   - `'-|'` / `'|-'` → 与**下一项**合并成 fold 步；操作符在 way 末尾或后
-*     接非 target 项时抛错
-*   - curve / cubic / bend infix 算子 → 与**下一项**合并成对应 step
-*   - arc / circle / ellipse infix 算子 → 单独成 step（不消耗下一项）
-*   - `{ label }` infix 算子（ADR-0004）→ 修饰**下一段**——挂在该段的
-*     `step.label` 上；连续 label / 末尾 label / cycle 上的 label 均抛错
-*
-* 这是纯函数，住在 core，被各框架 adapter 的 Sugar 组件复用。
+* way 数组 → IRStep 序列
+* @description 首元素始终 move（way[0] 是算子时降级到原点 [0,0]）；后续元素按各自规则：target/RelItem→line；Cycle→cycle；-|/|- 与下一项合并 fold；curve/cubic/bend 与下一项合并；arc/circle/ellipse 单独成 step；label 算子修饰下一段。连续 label/末尾 label/cycle 上的 label 抛错。纯函数，各框架 adapter Sugar 组件复用
 */
 var parseWay = (way) => {
 	if (way.length < 2) throw new Error("parseWay: way must contain at least 2 items");
 	const out = [];
-	/** ADR-0004：当前未消费的 label 算子结果——下一个产生段的 way item 消耗它。 */
+	/** 当前未消费的 label 算子结果，下一个产生段的 way item 消耗 */
 	let pendingLabel;
 	const consumeLabel = () => {
 		const l = pendingLabel;
@@ -129,7 +87,7 @@ var parseWay = (way) => {
 				type: "step",
 				kind: "step",
 				via: item,
-				to: require_parseTargetSugar.parseTargetSugar(desugarRelItem(next))
+				to: require_parseTargetSugar.parseTargetSugar(desugarRelativeItem(next))
 			};
 			const label = consumeLabel();
 			if (label) fold.label = label;
@@ -141,7 +99,7 @@ var parseWay = (way) => {
 			if (i + 1 >= way.length) throw new Error(`parseWay: curve operator at end of way must be followed by a target`);
 			const next = way[i + 1];
 			if (isWayOperator(next)) throw new Error(`parseWay: curve operator must be followed by a target, got operator/keyword`);
-			const target = require_parseTargetSugar.parseTargetSugar(desugarRelItem(next));
+			const target = require_parseTargetSugar.parseTargetSugar(desugarRelativeItem(next));
 			const label = consumeLabel();
 			if (isWayCurveOp(item)) {
 				const curve = {
@@ -211,7 +169,7 @@ var parseWay = (way) => {
 		const lineStep = {
 			type: "step",
 			kind: "line",
-			to: require_parseTargetSugar.parseTargetSugar(desugarRelItem(item))
+			to: require_parseTargetSugar.parseTargetSugar(desugarRelativeItem(item))
 		};
 		const label = consumeLabel();
 		if (label) lineStep.label = label;

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

@@ -1,98 +1,48 @@
 import { IRControlPoint, IRStep, IRStepLabel, IRTarget } from '../ir';
 /**
- * Sugar 层 way 数组的"关键字常量"。
- *
- * - `DrawWay.Cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
- *   （`'retikz-keyword_cycle'`），保证不会与任何合理的节点 id 冲突；用户应当
- *   只通过 `DrawWay.Cycle` 引用，不要直接写裸字面量。
- * - `DrawWay.Hv`：折角算子，先水平后垂直（裸字面量 `'-|'`）。
- * - `DrawWay.Vh`：折角算子，先垂直后水平（裸字面量 `'|-'`）。
- * - `DrawWay.Relative` / `DrawWay.Accumulate`：相对偏移 way item 的 `type` 鉴别字段值。
- *   配合 `{ position: [dx, dy], type: DrawWay.Relative | DrawWay.Accumulate }` 用——
- *   `Relative` 等价 TikZ `(+x, +y)`（不更新 prevEnd），`Accumulate` 等价 TikZ `(++x, ++y)`
- *   （累积更新）。底层字符串同样刻意写丑，保证不撞节点 id；用户只通过常量引用。
- *
- * 折角值（`-|` / `|-`）含特殊字符，与节点 id 不会冲突，因此**保留字面量与
- * 常量两种写法都合法**。way 数组里直接放 `'-|'` 或 `'|-'`（infix 算子）
- * 即把"上一项 → 下一项"那一段改成折角。
- *
- * 这里**故意不用 TS enum**——enum 在数值场景下生成 reverse-mapping 表、
- * 在 string 场景下与字面量类型不互通，而 const + `as const` 的字面量联合
- * 既可枚举也可与字面量字符串无缝混用。
+ * Sugar 层 way 数组的关键字常量
+ * @description Cycle 闭合到 way 起点（底层字符串故意写丑避节点 id 冲突，只通过 DrawWay.Cycle 引用）；Hv/Vh 折角算子（裸字面量 `-|`/`|-` 与常量等价）；Relative/Accumulate 相对偏移 way item 的 type 鉴别值（Relative=TikZ `(+x,+y)` 不推进 prevEnd，Accumulate=TikZ `(++x,++y)` 累积更新）。用 const + as const 而非 TS enum 避免 reverse-mapping 与字面量不互通
  */
 export declare const DrawWay: {
-    /**
-     * 闭合 way 到起点，等价于 `<Step kind="cycle" />`（TikZ 同名保留字 / SVG `Z`）。
-     * 底层字符串值刻意写丑以避开节点 id 冲突；不要硬编码这个字符串。
-     */
+    /** 闭合到起点（TikZ `cycle` / SVG `Z`），底层字符串刻意写丑，不要硬编码 */
     readonly Cycle: "retikz-keyword_cycle";
     /** 折角：先水平后垂直（TikZ `-|`） */
     readonly Hv: "-|";
     /** 折角：先垂直后水平（TikZ `|-`） */
     readonly Vh: "|-";
-    /**
-     * 相对偏移 way item 的 `type` 字段值——非累积分支，等价 TikZ `(+x, +y)`。
-     * 解析为 IR `{ rel: position }`，**不**推进 prevEnd；多段链式偏移共享同一锚点。
-     */
+    /** 相对偏移 type：非累积（TikZ `(+x,+y)`），不推进 prevEnd */
     readonly Relative: "retikz-keyword_relative";
-    /**
-     * 相对偏移 way item 的 `type` 字段值——累积分支，等价 TikZ `(++x, ++y)`。
-     * 解析为 IR `{ relAccumulate: position }`，每段累积更新 prevEnd。
-     */
+    /** 相对偏移 type：累积（TikZ `(++x,++y)`），每段更新 prevEnd */
     readonly Accumulate: "retikz-keyword_accumulate";
 };
-/**
- * way 折角算子的字面量类型。`DrawWay.Hv` / `DrawWay.Vh` 与裸字面量等价。
- */
+/** way 折角算子字面量类型 */
 export type WayVia = typeof DrawWay.Hv | typeof DrawWay.Vh;
-/**
- * way 闭合关键字的字面量类型，由 `DrawWay.Cycle` 派生。
- */
+/** way 闭合关键字字面量类型 */
 export type WayCycle = typeof DrawWay.Cycle;
 /**
- * 相对偏移 way item（sugar，TS-friendly）：以**前一 step 终点**（首项无前段时回退到 [0, 0]）
- * 为基准的位移。`type: DrawWay.Relative` 不更新 prevEnd（TikZ `(+x, +y)`）；
- * `type: DrawWay.Accumulate` 累积更新（TikZ `(++x, ++y)`）。
- *
- * 与 sugar 字符串 `'+dx,dy'` / `'++dx,dy'` 等价，但对象形态在编辑器里能直接补全
- * `position` / `type` 字段，TS 也能校验元组与鉴别字段值——更适合 IDE 协作。
- *
- * parseWay 在 sugar 层就地翻译为 IR `{ rel }` / `{ relAccumulate }`；IR 持久化
- * 形态保持纯净，仍是带 `rel` / `relAccumulate` discriminator 的对象。
+ * 相对偏移 way item（sugar，TS-friendly），与字符串 `'+dx,dy'`/`'++dx,dy'` 等价
+ * @description 以前一 step 终点为基准（首项回退 [0,0]）；Relative 不更新 prevEnd，Accumulate 累积更新。对象形态便于 IDE 补全字段；parseWay 在 sugar 层就地翻译为 IR `{relative}`/`{relativeAccumulate}`
  */
-export type WayRelItem = {
+export type WayRelativeItem = {
     position: [number, number];
     type: typeof DrawWay.Relative | typeof DrawWay.Accumulate;
 };
-/**
- * 二次贝塞尔算子（infix）：与折角算子一样坐落两个 target 之间，把
- * "上一项 → 下一项"那段改成 curve step。`curve` 字段携带控制点 `[x, y]`。
- */
+/** 二次贝塞尔算子（infix）：把"上一项→下一项"段改成 curve step，curve 字段携控制点 */
 export type WayCurveOp = {
     curve: IRControlPoint;
 };
-/**
- * 三次贝塞尔算子（infix）：把"上一项 → 下一项"那段改成 cubic step。
- * `cubic` 字段携带两个控制点 `[c1, c2]`。
- */
+/** 三次贝塞尔算子（infix）：cubic step；cubic 字段携两个控制点 */
 export type WayCubicOp = {
     cubic: [IRControlPoint, IRControlPoint];
 };
-/**
- * 弧形简记算子（infix）：把"上一项 → 下一项"那段改成 bend step。
- * `bend` 字段是方向 `'left'` / `'right'`；`angle` 可选（缺省 30°）。
- */
+/** 弧形简记算子（infix）：bend step；bend=方向，angle 可选缺省 30° */
 export type WayBendOp = {
     bend: 'left' | 'right';
     angle?: number;
 };
 /**
- * 弧段算子（infix）：以"上一项"为圆心，按起末角度 + 半径画弧；不消耗下一项
- * （形状 step 没有 to 字段）。
- *
- * 注意与曲线 / 折角 infix 算子不同：way 数组里 `[..., target, { arc: {...} }, ...]`
- * 时 arc 算子**只**消耗"前一个 target"作为圆心，**不**与"下一项"合并；
- * 后续的 way item 仍按各自规则解析。
+ * 弧段算子（infix），以上一项为圆心
+ * @description 按起末角度 + 半径画弧；与 curve/fold infix 不同——只消耗前一 target 作圆心，不与下一项合并
  */
 export type WayArcOp = {
     arc: {
@@ -101,80 +51,38 @@ export type WayArcOp = {
         radius: number;
     };
 };
-/** 整圆算子（infix）：以"上一项"为圆心、给定半径，画整圆。pen 留圆心 */
+/** 整圆算子（infix），以上一项为圆心、给定半径画整圆，pen 留圆心 */
 export type WayCircleOp = {
     circle: {
         radius: number;
     };
 };
-/** 整椭圆算子（infix）：以"上一项"为圆心，给定 x/y 半径，画整椭圆。pen 留圆心 */
+/** 整椭圆算子（infix），以上一项为圆心、给定 x/y 半径画整椭圆，pen 留圆心 */
 export type WayEllipseOp = {
     ellipse: {
         radiusX: number;
         radiusY: number;
     };
 };
-/**
- * 边标注的 sugar 形态（ADR-0004）：
- * - 字符串：等价 `{ text: <string> }`，其它字段走默认（midway / above）
- * - 对象：与 IR `step.label` 字面一致
- */
+/** 边标注 sugar 形态：字符串=`{text:s}`，对象=IR `step.label` 字面一致 */
 export type WayLabel = IRStepLabel | string;
 /**
- * 边标注 prefix 算子（infix）：修饰"下一段"——line / fold / curve / cubic / bend /
- * arc / circle / ellipse 都可承载。挂在 way 中两个 way item 之间，下一个产生段的
- * way item 把它消耗到自己的 IR step.label 上。
- *
- * `cycle` 不允许挂 label（schema 已禁），way 中"label op + cycle"的组合会抛错。
- *
- * 多个 label op 不能直接相邻，way 末尾未消费的 label op 同样抛错——保持"标注总有
- * 段可挂"。
+ * 边标注 prefix 算子（infix），修饰下一段
+ * @description line/fold/curve/cubic/bend/arc/circle/ellipse 都可承载；下一个产生段的 way item 消耗到自己的 step.label 上。cycle 不允许挂 label；连续 label/末尾未消费 label 均抛错
  */
 export type WayLabelOp = {
     label: WayLabel;
 };
 /**
- * Sugar 层的 way 数组 DSL 元素。
- *
- * 接受十二种形态：
- * - 节点 id 字符串：`'A'` → line（首项时为 move）
- * - 笛卡尔坐标：`[x, y]` → line
- * - 极坐标：`{ origin?, angle, radius }` → line
- * - 相对偏移对象（sugar，TS-friendly）：`{ position: [dx, dy], type: DrawWay.Relative | DrawWay.Accumulate }`
- *   翻译为 IR `{ rel }` / `{ relAccumulate }`；与裸字符串 `'+dx,dy'` / `'++dx,dy'` 等价
- * - 折角算子：`'-|'` / `'|-'`（或 `DrawWay.Hv` / `DrawWay.Vh`）→ 当前项 +
- *   **下一项**合并成一个折角 step（与 TikZ 的 `(A) -| (B)` infix 写法对齐）
- * - 闭合关键字：`DrawWay.Cycle` → cycle（闭合到起点）
- * - 二次贝塞尔算子（infix）：`{ curve: [cx, cy] }`，与下一项合并为 curve step
- * - 三次贝塞尔算子（infix）：`{ cubic: [[c1x, c1y], [c2x, c2y]] }`，与下一项合并为 cubic step
- * - 弧形简记算子（infix）：`{ bend: 'left' | 'right', angle?: number }`，与下一项合并为 bend step
- * - 弧段算子（infix）：`{ arc: { startAngle, endAngle, radius } }`，以"上一项"为圆心，**不**消耗下一项
- * - 整圆算子（infix）：`{ circle: { radius } }`，以"上一项"为圆心，**不**消耗下一项
- * - 整椭圆算子（infix）：`{ ellipse: { radiusX, radiusY } }`，以"上一项"为圆心，**不**消耗下一项
- *
- * 注意：闭合刻意只走 `DrawWay.Cycle`（底层字符串是 `'retikz-keyword_cycle'`），
- * 这样裸字符串 `'cycle'` 仍可作为正常节点 id 使用。相对偏移的 `Relative` /
- * `Accumulate` 同理刻意写丑——避免与节点 id / Position 形态撞结构。
+ * Sugar 层 way 数组 DSL 元素（十二种形态）
+ * @description 节点 id 字符串/笛卡尔/极坐标 → line（首项 move）；`{position,type}` 相对偏移对象 → IR relative/relativeAccumulate；`-|`/`|-` 与下一项合并 fold；DrawWay.Cycle → cycle；curve/cubic/bend infix 与下一项合并；arc/circle/ellipse infix 以上一项为圆心不消耗下一项。Cycle/Relative/Accumulate 底层字符串刻意写丑避节点 id 撞结构
  */
-export type WayItem = IRTarget | WayRelItem | WayVia | WayCycle | WayCurveOp | WayCubicOp | WayBendOp | WayArcOp | WayCircleOp | WayEllipseOp | WayLabelOp;
-/** way DSL 数组：sugar `<Draw way={...}>` 接受的输入形态 */
+export type WayItem = IRTarget | WayRelativeItem | WayVia | WayCycle | WayCurveOp | WayCubicOp | WayBendOp | WayArcOp | WayCircleOp | WayEllipseOp | WayLabelOp;
+/** way DSL 数组：sugar `<Draw way={...}>` 输入形态 */
 export type WayDSL = Array<WayItem>;
 /**
- * 把 way 数组翻译为 IRStep 序列。
- *
- * - 第一个元素始终是 move：取 way[0] 的目标点；若 way[0] 是 cycle / via 算子等
- *   非 target 项，则降级到原点 `[0, 0]`（容错）。
- * - 后续元素：
- *   - 普通 target / `WayRelItem` → line
- *   - `DrawWay.Cycle` → cycle 步
- *   - `'-|'` / `'|-'` → 与**下一项**合并成 fold 步；操作符在 way 末尾或后
- *     接非 target 项时抛错
- *   - curve / cubic / bend infix 算子 → 与**下一项**合并成对应 step
- *   - arc / circle / ellipse infix 算子 → 单独成 step（不消耗下一项）
- *   - `{ label }` infix 算子（ADR-0004）→ 修饰**下一段**——挂在该段的
- *     `step.label` 上；连续 label / 末尾 label / cycle 上的 label 均抛错
- *
- * 这是纯函数，住在 core，被各框架 adapter 的 Sugar 组件复用。
+ * way 数组 → IRStep 序列
+ * @description 首元素始终 move（way[0] 是算子时降级到原点 [0,0]）；后续元素按各自规则：target/RelItem→line；Cycle→cycle；-|/|- 与下一项合并 fold；curve/cubic/bend 与下一项合并；arc/circle/ellipse 单独成 step；label 算子修饰下一段。连续 label/末尾 label/cycle 上的 label 抛错。纯函数，各框架 adapter Sugar 组件复用
  */
 export declare const parseWay: (way: WayDSL) => Array<IRStep>;
 //# sourceMappingURL=parseWay.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parseWay.d.ts","sourceRoot":"","sources":["../../../src/parsers/parseWay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,cAAc,EAQd,MAAM,EACN,WAAW,EACX,QAAQ,EACT,MAAM,OAAO,CAAC;AAGf;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO;IAClB;;;OAGG;;IAEH,2BAA2B;;IAE3B,2BAA2B;;IAE3B;;;OAGG;;IAEH;;;OAGG;;CAEK,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;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,OAAO,OAAO,CAAC,QAAQ,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC;CAC3D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;CAAE,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEzD,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,UAAU,GACV,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,UAAU,CAAC;AAEf,kDAAkD;AAClD,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAwEpC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,KAAK,CAAC,MAAM,CAoKlD,CAAC"}
+{"version":3,"file":"parseWay.d.ts","sourceRoot":"","sources":["../../../src/parsers/parseWay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,cAAc,EAQd,MAAM,EACN,WAAW,EACX,QAAQ,EACT,MAAM,OAAO,CAAC;AAGf;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB,oDAAoD;;IAEpD,2BAA2B;;IAE3B,2BAA2B;;IAE3B,gDAAgD;;IAEhD,kDAAkD;;CAE1C,CAAC;AAEX,oBAAoB;AACpB,MAAM,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,EAAE,CAAC;AAE3D,qBAAqB;AACrB,MAAM,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,KAAK,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,IAAI,EAAE,OAAO,OAAO,CAAC,QAAQ,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC;CAC3D,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAEnD,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;CAAE,CAAC;AAErE,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEzD,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE7E,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,eAAe,GACf,MAAM,GACN,QAAQ,GACR,UAAU,GACV,UAAU,GACV,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,UAAU,CAAC;AAEf,+CAA+C;AAC/C,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAqEpC;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,KAAK,CAAC,MAAM,CAmKlD,CAAC"}

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

@@ -1,32 +1,22 @@
 /**
- * 椭圆原语：SVG `<ellipse>` 直对应。
- * 圆形（半长轴 = 半短轴）用同一个 EllipsePrim 表示，让 renderer 单一 case 处理。
- * 旋转走 `rotate` 字段（度数，绕中心）；非零时 renderer 用 SVG transform 包裹。
+ * 椭圆原语（cx/cy 圆心，rx/ry 半径）
+ * @description 圆形（rx=ry）复用同一 prim 单 case 处理；rotate 度数绕中心，非零时由 renderer 在 emit 阶段应用旋转变换
  */
 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;
-    /** 描边透明度 0~1（SVG stroke-opacity） */
+    /** 描边透明度 0~1 */
     strokeOpacity?: number;
-    /** 描边宽度 */
     strokeWidth?: number;
-    /** SVG stroke-dasharray 模式 */
     strokeDasharray?: string;
     /** 整体透明度 0~1 */
     opacity?: number;

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

@@ -1 +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,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,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"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/primitive/ellipse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}