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

package/dist/es/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;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"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/ir/scene.ts"],"names":[],"mappings":"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"}

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

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

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

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

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

@@ -0,0 +1,3 @@
+import { IRTarget } from '../ir';
+export declare const parseTargetSugar: (input: unknown) => IRTarget;
+//# sourceMappingURL=parseTargetSugar.d.ts.map

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

@@ -0,0 +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"}

package/dist/es/parsers/parseTargetSugar.js

@@ -0,0 +1,31 @@
+//#region src/parsers/parseTargetSugar.ts
+/**
+* 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 共用。
+*/
+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);
+	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] };
+};
+//#endregion
+export { parseTargetSugar };

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

@@ -1,12 +1,16 @@
-import { IRStep, IRTarget } from '../ir';
+import { IRControlPoint, IRStep, IRStepLabel, IRTarget } from '../ir';
 /**
  * Sugar 层 way 数组的"关键字常量"。
  *
- * - `DrawWay.cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
+ * - `DrawWay.Cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
  *   （`'retikz-keyword_cycle'`），保证不会与任何合理的节点 id 冲突；用户应当
- *   只通过 `DrawWay.cycle` 引用，不要直接写裸字面量。
- * - `DrawWay.hv`：折角算子，先水平后垂直（裸字面量 `'-|'`）。
- * - `DrawWay.vh`：折角算子，先垂直后水平（裸字面量 `'|-'`）。
+ *   只通过 `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 算子）
@@ -21,37 +25,138 @@ export declare const DrawWay: {
      * 闭合 way 到起点，等价于 `<Step kind="cycle" />`（TikZ 同名保留字 / SVG `Z`）。
      * 底层字符串值刻意写丑以避开节点 id 冲突；不要硬编码这个字符串。
      */
-    readonly cycle: "retikz-keyword_cycle";
+    readonly Cycle: "retikz-keyword_cycle";
     /** 折角：先水平后垂直（TikZ `-|`） */
-    readonly hv: "-|";
+    readonly Hv: "-|";
     /** 折角：先垂直后水平（TikZ `|-`） */
-    readonly vh: "|-";
+    readonly Vh: "|-";
+    /**
+     * 相对偏移 way item 的 `type` 字段值——非累积分支，等价 TikZ `(+x, +y)`。
+     * 解析为 IR `{ rel: position }`，**不**推进 prevEnd；多段链式偏移共享同一锚点。
+     */
+    readonly Relative: "retikz-keyword_relative";
+    /**
+     * 相对偏移 way item 的 `type` 字段值——累积分支，等价 TikZ `(++x, ++y)`。
+     * 解析为 IR `{ relAccumulate: position }`，每段累积更新 prevEnd。
+     */
+    readonly Accumulate: "retikz-keyword_accumulate";
+};
+/**
+ * way 折角算子的字面量类型。`DrawWay.Hv` / `DrawWay.Vh` 与裸字面量等价。
+ */
+export type WayVia = typeof DrawWay.Hv | typeof DrawWay.Vh;
+/**
+ * way 闭合关键字的字面量类型，由 `DrawWay.Cycle` 派生。
+ */
+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 的对象。
+ */
+export type WayRelItem = {
+    position: [number, number];
+    type: typeof DrawWay.Relative | typeof DrawWay.Accumulate;
+};
+/**
+ * 二次贝塞尔算子（infix）：与折角算子一样坐落两个 target 之间，把
+ * "上一项 → 下一项"那段改成 curve step。`curve` 字段携带控制点 `[x, y]`。
+ */
+export type WayCurveOp = {
+    curve: IRControlPoint;
 };
 /**
- * way 折角算子的字面量类型。`DrawWay.hv` / `DrawWay.vh` 与裸字面量等价。
+ * 三次贝塞尔算子（infix）：把"上一项 → 下一项"那段改成 cubic step。
+ * `cubic` 字段携带两个控制点 `[c1, c2]`。
  */
-export type WayVia = typeof DrawWay.hv | typeof DrawWay.vh;
+export type WayCubicOp = {
+    cubic: [IRControlPoint, IRControlPoint];
+};
+/**
+ * 弧形简记算子（infix）：把"上一项 → 下一项"那段改成 bend step。
+ * `bend` 字段是方向 `'left'` / `'right'`；`angle` 可选（缺省 30°）。
+ */
+export type WayBendOp = {
+    bend: 'left' | 'right';
+    angle?: number;
+};
+/**
+ * 弧段算子（infix）：以"上一项"为圆心，按起末角度 + 半径画弧；不消耗下一项
+ * （形状 step 没有 to 字段）。
+ *
+ * 注意与曲线 / 折角 infix 算子不同：way 数组里 `[..., target, { arc: {...} }, ...]`
+ * 时 arc 算子**只**消耗"前一个 target"作为圆心，**不**与"下一项"合并；
+ * 后续的 way item 仍按各自规则解析。
+ */
+export type WayArcOp = {
+    arc: {
+        startAngle: number;
+        endAngle: number;
+        radius: number;
+    };
+};
+/** 整圆算子（infix）：以"上一项"为圆心、给定半径，画整圆。pen 留圆心 */
+export type WayCircleOp = {
+    circle: {
+        radius: number;
+    };
+};
+/** 整椭圆算子（infix）：以"上一项"为圆心，给定 x/y 半径，画整椭圆。pen 留圆心 */
+export type WayEllipseOp = {
+    ellipse: {
+        radiusX: number;
+        radiusY: number;
+    };
+};
+/**
+ * 边标注的 sugar 形态（ADR-0004）：
+ * - 字符串：等价 `{ text: <string> }`，其它字段走默认（midway / above）
+ * - 对象：与 IR `step.label` 字面一致
+ */
+export type WayLabel = IRStepLabel | string;
 /**
- * way 闭合关键字的字面量类型，由 `DrawWay.cycle` 派生。
+ * 边标注 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 同样抛错——保持"标注总有
+ * 段可挂"。
  */
-export type WayCycle = typeof DrawWay.cycle;
+export type WayLabelOp = {
+    label: WayLabel;
+};
 /**
  * Sugar 层的 way 数组 DSL 元素。
  *
- * v0.1.0-alpha.1 接受五种形态：
+ * 接受十二种形态：
  * - 节点 id 字符串：`'A'` → line（首项时为 move）
  * - 笛卡尔坐标：`[x, y]` → line
  * - 极坐标：`{ origin?, angle, radius }` → line
- * - 折角算子：`'-|'` / `'|-'`（或 `DrawWay.hv` / `DrawWay.vh`）→ 当前项 +
+ * - 相对偏移对象（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（闭合到起点）
- *
- * 后续会加：相对位移（`{ rel: [x, y] }`）、curve / cubic 等。
+ * - 闭合关键字：`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 使用。
+ * 注意：闭合刻意只走 `DrawWay.Cycle`（底层字符串是 `'retikz-keyword_cycle'`），
+ * 这样裸字符串 `'cycle'` 仍可作为正常节点 id 使用。相对偏移的 `Relative` /
+ * `Accumulate` 同理刻意写丑——避免与节点 id / Position 形态撞结构。
  */
-export type WayItem = IRTarget | WayVia | WayCycle;
+export type WayItem = IRTarget | WayRelItem | WayVia | WayCycle | WayCurveOp | WayCubicOp | WayBendOp | WayArcOp | WayCircleOp | WayEllipseOp | WayLabelOp;
 /** way DSL 数组：sugar `<Draw way={...}>` 接受的输入形态 */
 export type WayDSL = Array<WayItem>;
 /**
@@ -60,10 +165,14 @@ export type WayDSL = Array<WayItem>;
  * - 第一个元素始终是 move：取 way[0] 的目标点；若 way[0] 是 cycle / via 算子等
  *   非 target 项，则降级到原点 `[0, 0]`（容错）。
  * - 后续元素：
- *   - 普通 target → line
- *   - `DrawWay.cycle` → cycle 步
+ *   - 普通 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 组件复用。
  */

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

@@ -1 +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"}
+{"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"}

package/dist/es/parsers/parseWay.js

@@ -1,12 +1,17 @@
+import { parseTargetSugar } from "./parseTargetSugar.js";
 //#region src/parsers/parseWay.ts
 /**
 * Sugar 层 way 数组的"关键字常量"。
 *
-* - `DrawWay.cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
+* - `DrawWay.Cycle`：闭合到 way 起点（way 元素位置）。**底层字符串故意取得很丑**
 *   （`'retikz-keyword_cycle'`），保证不会与任何合理的节点 id 冲突；用户应当
-*   只通过 `DrawWay.cycle` 引用，不要直接写裸字面量。
-* - `DrawWay.hv`：折角算子，先水平后垂直（裸字面量 `'-|'`）。
-* - `DrawWay.vh`：折角算子，先垂直后水平（裸字面量 `'|-'`）。
+*   只通过 `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 算子）
@@ -21,18 +26,50 @@ var DrawWay = {
 	* 闭合 way 到起点，等价于 `<Step kind="cycle" />`（TikZ 同名保留字 / SVG `Z`）。
 	* 底层字符串值刻意写丑以避开节点 id 冲突；不要硬编码这个字符串。
 	*/
-	cycle: "retikz-keyword_cycle",
+	Cycle: "retikz-keyword_cycle",
 	/** 折角：先水平后垂直（TikZ `-|`） */
-	hv: "-|",
+	Hv: "-|",
 	/** 折角：先垂直后水平（TikZ `|-`） */
-	vh: "|-"
+	Vh: "|-",
+	/**
+	* 相对偏移 way item 的 `type` 字段值——非累积分支，等价 TikZ `(+x, +y)`。
+	* 解析为 IR `{ rel: position }`，**不**推进 prevEnd；多段链式偏移共享同一锚点。
+	*/
+	Relative: "retikz-keyword_relative",
+	/**
+	* 相对偏移 way item 的 `type` 字段值——累积分支，等价 TikZ `(++x, ++y)`。
+	* 解析为 IR `{ relAccumulate: position }`，每段累积更新 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 isWayCurveOp = (item) => isPlainObject(item) && "curve" in item;
+var isWayCubicOp = (item) => isPlainObject(item) && "cubic" in item;
+var isWayBendOp = (item) => isPlainObject(item) && "bend" in item;
+var isWayCurveLike = (item) => isWayCurveOp(item) || isWayCubicOp(item) || isWayBendOp(item);
+var isWayArcOp = (item) => isPlainObject(item) && "arc" in item;
+var isWayCircleOp = (item) => isPlainObject(item) && "circle" in item;
+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 }`，对象原样取 */
+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 };
 };
-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;
+	if (isWayOperator(item)) return null;
+	return desugarRelItem(item);
 };
 /**
 * 把 way 数组翻译为 IRStep 序列。
@@ -40,25 +77,44 @@ var targetOf = (item) => {
 * - 第一个元素始终是 move：取 way[0] 的目标点；若 way[0] 是 cycle / via 算子等
 *   非 target 项，则降级到原点 `[0, 0]`（容错）。
 * - 后续元素：
-*   - 普通 target → line
-*   - `DrawWay.cycle` → cycle 步
+*   - 普通 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 组件复用。
 */
 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 消耗它。 */
+	let pendingLabel;
+	const consumeLabel = () => {
+		const l = pendingLabel;
+		pendingLabel = void 0;
+		return l;
+	};
+	if (isWayLabelOp(way[0])) throw new Error(`parseWay: way[0] must be a target (move start), got label operator`);
+	const rawMove = targetOf(way[0]);
 	const moveStep = {
 		type: "step",
 		kind: "move",
-		to: targetOf(way[0]) ?? [0, 0]
+		to: rawMove === null ? [0, 0] : parseTargetSugar(rawMove)
 	};
 	out.push(moveStep);
 	for (let i = 1; i < way.length; i++) {
 		const item = way[i];
+		if (isWayLabelOp(item)) {
+			if (pendingLabel) throw new Error(`parseWay: label operator at index ${i} cannot directly follow another label operator`);
+			pendingLabel = normalizeLabel(item.label);
+			continue;
+		}
 		if (isWayCycle(item)) {
+			if (pendingLabel) throw new Error(`parseWay: cycle step cannot carry a label (label operator at index ${i - 1})`);
 			out.push({
 				type: "step",
 				kind: "cycle"
@@ -68,24 +124,100 @@ var parseWay = (way) => {
 		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)}'`);
+			if (isWayOperator(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
+				to: parseTargetSugar(desugarRelItem(next))
 			};
+			const label = consumeLabel();
+			if (label) fold.label = label;
 			out.push(fold);
 			i++;
 			continue;
 		}
+		if (isWayCurveLike(item)) {
+			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 = parseTargetSugar(desugarRelItem(next));
+			const label = consumeLabel();
+			if (isWayCurveOp(item)) {
+				const curve = {
+					type: "step",
+					kind: "curve",
+					to: target,
+					control: item.curve
+				};
+				if (label) curve.label = label;
+				out.push(curve);
+			} else if (isWayCubicOp(item)) {
+				const cubic = {
+					type: "step",
+					kind: "cubic",
+					to: target,
+					control1: item.cubic[0],
+					control2: item.cubic[1]
+				};
+				if (label) cubic.label = label;
+				out.push(cubic);
+			} else {
+				const bend = {
+					type: "step",
+					kind: "bend",
+					to: target,
+					bendDirection: item.bend
+				};
+				if (item.angle !== void 0) bend.bendAngle = item.angle;
+				if (label) bend.label = label;
+				out.push(bend);
+			}
+			i++;
+			continue;
+		}
+		if (isWayShapeOp(item)) {
+			const label = consumeLabel();
+			if (isWayArcOp(item)) {
+				const arc = {
+					type: "step",
+					kind: "arc",
+					startAngle: item.arc.startAngle,
+					endAngle: item.arc.endAngle,
+					radius: item.arc.radius
+				};
+				if (label) arc.label = label;
+				out.push(arc);
+			} else if (isWayCircleOp(item)) {
+				const circle = {
+					type: "step",
+					kind: "circlePath",
+					radius: item.circle.radius
+				};
+				if (label) circle.label = label;
+				out.push(circle);
+			} else {
+				const ellipse = {
+					type: "step",
+					kind: "ellipsePath",
+					radiusX: item.ellipse.radiusX,
+					radiusY: item.ellipse.radiusY
+				};
+				if (label) ellipse.label = label;
+				out.push(ellipse);
+			}
+			continue;
+		}
 		const lineStep = {
 			type: "step",
 			kind: "line",
-			to: item
+			to: parseTargetSugar(desugarRelItem(item))
 		};
+		const label = consumeLabel();
+		if (label) lineStep.label = label;
 		out.push(lineStep);
 	}
+	if (pendingLabel) throw new Error(`parseWay: label operator at end of way must be followed by a step`);
 	return out;
 };
 //#endregion

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

@@ -22,6 +22,8 @@ export type EllipsePrim = {
     fillOpacity?: number;
     /** 描边色 */
     stroke?: string;
+    /** 描边透明度 0~1（SVG stroke-opacity） */
+    strokeOpacity?: number;
     /** 描边宽度 */
     strokeWidth?: number;
     /** SVG stroke-dasharray 模式 */

package/dist/es/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,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;;;;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"}

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

@@ -7,10 +7,14 @@ export type PathPrim = {
     d: string;
     /** 填充色；不填表示不填充 */
     fill?: string;
+    /** 填充透明度 0~1 */
+    fillOpacity?: number;
     /** SVG fill-rule：`nonzero`（默认）/ `evenodd`（环形 / 孔洞场景） */
     fillRule?: 'nonzero' | 'evenodd';
     /** 描边色 */
     stroke?: string;
+    /** 描边透明度 0~1（SVG stroke-opacity） */
+    strokeOpacity?: number;
     /** 描边宽度 */
     strokeWidth?: number;
     /** SVG stroke-dasharray 模式 */

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

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/primitive/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW;IACX,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,WAAW;IACX,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,2BAA2B;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/primitive/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,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,WAAW;IACX,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,WAAW;IACX,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,2BAA2B;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

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

@@ -16,6 +16,8 @@ export type RectPrim = {
     fillOpacity?: number;
     /** 描边色 */
     stroke?: string;
+    /** 描边透明度 0~1（SVG stroke-opacity） */
+    strokeOpacity?: number;
     /** 描边宽度 */
     strokeWidth?: number;
     /** SVG stroke-dasharray 模式 */

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

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/primitive/rect.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,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,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/primitive/rect.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,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,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

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

@@ -1,32 +1,62 @@
-/** 文本原语；measuredWidth/Height 由 Scene 编译阶段算好，下游直接信任 */
+/**
+ * 行级字段——`<tspan>` 上可独立指定的属性。
+ * 块级（TextPrim 顶层）属性是默认值；行级未填字段走块级默认。
+ */
+export type TextLine = {
+    /** 行内容（必填） */
+    text: string;
+    /** 行字号；未填走 TextPrim.fontSize */
+    fontSize?: number;
+    /** 行字体族；未填走 TextPrim.fontFamily */
+    fontFamily?: string;
+    /** 行字重；未填走 TextPrim.fontWeight */
+    fontWeight?: string | number;
+    /** 行字形；未填走 TextPrim.fontStyle */
+    fontStyle?: 'normal' | 'italic' | 'oblique';
+    /** 行颜色；未填走 TextPrim.fill */
+    fill?: string;
+    /** 行透明度 0~1；未填走 TextPrim.opacity */
+    opacity?: number;
+};
+/**
+ * 文本原语；measuredWidth / Height 由 Scene 编译阶段算好，下游直接信任。
+ *
+ * 多行：`lines` 至少 1 行；renderer 把每行画为 `<tspan>`，按 `lineHeight` 堆叠，
+ * 整块根据 `baseline` 在 (x, y) 锚点上下居中 / 顶 / 底对齐。
+ *
+ * 顶层 `fontSize` / `fontFamily` / `fontWeight` / `fontStyle` / `fill` / `opacity` 是默认值；
+ * 单行可在 `TextLine` 上覆盖（仅生效于该行 `<tspan>`）。
+ */
 export type TextPrim = {
     /** 类型判别符 */
     type: 'text';
-    /** 锚点横坐标（具体含义由 align 决定） */
+    /** 锚点横坐标（具体含义由 align 决定）；多行下作为每行 `<tspan>` 的 x */
     x: number;
     /** 锚点纵坐标（具体含义由 baseline 决定） */
     y: number;
-    /** 文本内容 */
-    content: string;
-    /** 字号 */
+    /** 文本行（至少 1 行）；单行节点也用 `[{ text: 'Hello' }]` 形式 */
+    lines: Array<TextLine>;
+    /** 块级默认字号 */
     fontSize: number;
-    /** 字体族 */
+    /** 块级默认字体族 */
     fontFamily?: string;
-    /** 字重 */
+    /** 块级默认字重 */
     fontWeight?: string | number;
-    /** 字形 */
-    fontStyle?: 'normal' | 'italic';
+    /** 块级默认字形 */
+    fontStyle?: 'normal' | 'italic' | 'oblique';
     /** 水平对齐：start / middle / end 锚点位置 */
     align: 'start' | 'middle' | 'end';
     /** 垂直基线对齐方式 */
     baseline: 'top' | 'middle' | 'bottom' | 'alphabetic';
-    /** 编译期算好的文字宽度（user units） */
+    /** 行高（user units）；多行下相邻 `<tspan>` 的垂直距离 */
+    lineHeight: number;
+    /** 编译期算好的整块文字宽度（user units，= max line width） */
     measuredWidth: number;
-    /** 编译期算好的文字高度（user units） */
+    /** 编译期算好的整块文字高度（user units，≈ lines × lineHeight） */
     measuredHeight: number;
-    /** 文字颜色 */
+    /** 块级默认文字颜色 */
     fill?: string;
-    /** 整体透明度 0~1 */
+    /** 块级默认透明度 0~1 */
     opacity?: number;
 };
 //# sourceMappingURL=text.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS;IACT,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS;IACT,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,eAAe;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,iCAAiC;IACjC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,kDAAkD;IAClD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa;IACb,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,qCAAqC;IACrC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,eAAe;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}