@retikz/react 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/es/index.d.ts

@@ -6,8 +6,8 @@
  *
  * 渲染管道：buildIR → compileToScene → renderPrim → SVG
  */
-export { Tikz, Node, Path, Step, Text } from './kernel';
-export type { TikzProps, NodeProps, PathProps, StepProps, TextProps } from './kernel';
+export { Tikz, Node, Path, Step, Text, Coordinate } from './kernel';
+export type { TikzProps, NodeProps, PathProps, StepProps, TextProps, CoordinateProps, } from './kernel';
 export { Draw, EdgeLabel } from './sugar';
 export type { DrawProps, EdgeLabelProps } from './sugar';
 export { DrawWay } from '@retikz/core';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/es/index.js

@@ -4,10 +4,11 @@ import { Node } from "./kernel/Node.js";
 import { Path } from "./kernel/Path.js";
 import { Step } from "./kernel/Step.js";
 import { Text } from "./kernel/Text.js";
+import { Coordinate } from "./kernel/Coordinate.js";
 import "./kernel/index.js";
 import { Draw } from "./sugar/Draw.js";
 import { EdgeLabel } from "./sugar/EdgeLabel.js";
 import "./sugar/index.js";
 import { convertIRToReactNode } from "./kernel/_unbuilder.js";
 import { DrawWay } from "@retikz/core";
-export { Draw, DrawWay, EdgeLabel, Node, Path, Step, Text, Tikz, convertIRToReactNode, buildIR as convertReactNodeToIR };
+export { Coordinate, Draw, DrawWay, EdgeLabel, Node, Path, Step, Text, Tikz, convertIRToReactNode, buildIR as convertReactNodeToIR };

package/dist/es/kernel/Coordinate.d.ts

@@ -0,0 +1,23 @@
+import { FC } from 'react';
+import { IRAtPosition, IRPosition, PolarPosition } from '@retikz/core';
+/** <Coordinate> 组件的 props */
+export type CoordinateProps = {
+    /** 占位节点的 id；其它 path / node `at.of` 通过这个 id 引用 */
+    id: string;
+    /**
+     * 占位点位置；与 `<Node position>` 形态完全一致：
+     * - 笛卡尔 `[x, y]`
+     * - 极坐标 `{ angle, radius, origin? }`
+     * - 相对定位 `{ direction, of, distance? }`
+     */
+    position: IRPosition | PolarPosition | IRAtPosition;
+};
+/**
+ * 占位节点——TikZ `\coordinate (id) at (x, y);` 同义。
+ *
+ * 命名一个点供后续 path 与其他 node 的 `at.of` 引用，自身不渲染任何图形，
+ * 不参与 viewBox 扩展。本组件不返回任何 React 元素，由 <Tikz> builder 在
+ * children 扫描阶段读出 props 构造 IR。
+ */
+export declare const Coordinate: FC<CoordinateProps>;
+//# sourceMappingURL=Coordinate.d.ts.map

package/dist/es/kernel/Coordinate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Coordinate.d.ts","sourceRoot":"","sources":["../../../src/kernel/Coordinate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG5E,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,eAAe,CAAc,CAAC"}

package/dist/es/kernel/Coordinate.js

@@ -0,0 +1,13 @@
+import { TIKZ_COORDINATE } from "./_displayNames.js";
+//#region src/kernel/Coordinate.tsx
+/**
+* 占位节点——TikZ `\coordinate (id) at (x, y);` 同义。
+*
+* 命名一个点供后续 path 与其他 node 的 `at.of` 引用，自身不渲染任何图形，
+* 不参与 viewBox 扩展。本组件不返回任何 React 元素，由 <Tikz> builder 在
+* children 扫描阶段读出 props 构造 IR。
+*/
+var Coordinate = () => null;
+Coordinate.displayName = TIKZ_COORDINATE;
+//#endregion
+export { Coordinate };

package/dist/es/kernel/Node.d.ts

@@ -1,13 +1,18 @@
 import { FC, ReactNode } from 'react';
-import { IRFont, IRLineSpec, IRNode, IRPosition, NodeTextAlign, PolarPosition } from '@retikz/core';
+import { IRAtPosition, IRFont, IRLineSpec, IRNode, IRNodeLabel, IRPosition, NodeTextAlign, PolarPosition } from '@retikz/core';
 /** <Node> 组件的 props */
 export type NodeProps = {
     /** 节点 id；其他 Path/Draw 通过这个 id 引用本节点 */
     id?: string;
     /** 节点形状：rectangle（默认）/ circle / ellipse / diamond */
     shape?: IRNode['shape'];
-    /** 节点中心位置；笛卡尔 [x, y] 或极坐标（编译时解析） */
-    position: IRPosition | PolarPosition;
+    /**
+     * 节点中心位置。三种形态：
+     * - 笛卡尔 `[x, y]`
+     * - 极坐标 `{ angle, radius, origin? }`（编译时解析）
+     * - 相对定位 `{ direction, of, distance? }`（TikZ `[<direction>=<distance> of <id>]` 同义；编译时解析）
+     */
+    position: IRPosition | PolarPosition | IRAtPosition;
     /** 旋转角度（度数，与 TikZ 一致），绕节点中心；正值顺时针 */
     rotate?: number;
     /**
@@ -77,6 +82,14 @@ export type NodeProps = {
     textColor?: string;
     /** 整节点透明度 0~1（同时作用于 shape 与 text） */
     opacity?: number;
+    /**
+     * 节点附属标签——TikZ `[label=above:foo]` 同义。
+     *
+     * 单对象或数组形态；每条 label 接 `text` / `position?` / `distance?` / 样式继承。
+     * `position` 接 8 方向枚举（`above`/`right`/...）或数字角度（`label=30:foo` 等价 `position: 30`）；
+     * 缺省 'above'，distance 缺省 4。
+     */
+    label?: IRNodeLabel | Array<IRNodeLabel>;
 };
 /**
  * Node 是 DSL 标记组件——本身不渲染任何 React 元素。

package/dist/es/kernel/Node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/kernel/Node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,oCAAoC;IACpC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAAC;IACrC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/kernel/Node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,MAAM,EACN,UAAU,EACV,MAAM,EACN,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;IACpD,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}

package/dist/es/kernel/Tikz.d.ts

@@ -14,6 +14,12 @@ export type TikzProps = {
     className?: string;
     /** 透传到 svg 元素的内联样式 */
     style?: CSSProperties;
+    /**
+     * 节点相对定位（`Node.position = { direction, of }`）的默认距离，单位 user units；
+     * 对应 TikZ 的 `node distance=...`。当节点 position 自带 `distance` 时优先用自带值；
+     * 都缺省时回退到 1。
+     */
+    nodeDistance?: number;
 };
 /**
  * <Tikz> 顶层容器。

package/dist/es/kernel/Tikz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tikz.d.ts","sourceRoot":"","sources":["../../../src/kernel/Tikz.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,EAAmB,KAAK,EAAE,EAAuC,MAAM,cAAc,CAAC;AAO7F,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,mDAAmD;IACnD,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,gCAAgC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAgBF;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAuB9B,CAAC"}
+{"version":3,"file":"Tikz.d.ts","sourceRoot":"","sources":["../../../src/kernel/Tikz.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,EAAmB,KAAK,EAAE,EAAuC,MAAM,cAAc,CAAC;AAO7F,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,mDAAmD;IACnD,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,gCAAgC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAgBF;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CA2B9B,CAAC"}

package/dist/es/kernel/Tikz.js

@@ -26,9 +26,13 @@ var collectArrowShapes = (prims) => {
 * 每种用到的 shape 一个 marker 定义，id 形如 `${prefix}-${shape}`，
 * marker 内 path 借 `context-stroke` / `context-fill` 让颜色随 path 同步。
 */
-var Tikz = ({ ir: irFromProp, children, width, height, className, style }) => {
+var Tikz = (props) => {
+	const { ir: irFromProp, children, width, height, className, style, nodeDistance } = props;
 	const ir = useMemo(() => irFromProp ?? buildIR(children), [irFromProp, children]);
-	const scene = useMemo(() => compileToScene(ir, { measureText: browserMeasurer }), [ir]);
+	const scene = useMemo(() => compileToScene(ir, {
+		measureText: browserMeasurer,
+		nodeDistance
+	}), [ir, nodeDistance]);
 	const arrowMarkerPrefix = `retikz-arrow-${useId().replace(/[^a-zA-Z0-9]/g, "")}`;
 	const usedShapes = collectArrowShapes(scene.primitives);
 	const arrowMarkerIdFor = (shape) => `${arrowMarkerPrefix}-${shape}`;

package/dist/es/kernel/_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EACV,EAAE,EAQH,MAAM,cAAc,CAAC;AAkXtB;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}
+{"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EACV,EAAE,EASH,MAAM,cAAc,CAAC;AA8XtB;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}

package/dist/es/kernel/_builder.js

@@ -1,4 +1,4 @@
-import { TIKZ_NODE, TIKZ_PATH } from "./_displayNames.js";
+import { TIKZ_COORDINATE, TIKZ_NODE, TIKZ_PATH } from "./_displayNames.js";
 import { Children, isValidElement } from "react";
 import { CURRENT_IR_VERSION, parseTargetSugar } from "@retikz/core";
 //#region src/kernel/_builder.ts
@@ -102,7 +102,8 @@ var buildNode = (props) => ({
 	outerSep: props.outerSep,
 	padding: props.padding,
 	margin: props.margin,
-	font: props.font
+	font: props.font,
+	label: props.label
 });
 /**
 * 扫描 Step children，把首个 <EdgeLabel> 翻译为 IRStepLabel；
@@ -257,6 +258,12 @@ var readPathChildren = (children) => {
 	}
 	return out;
 };
+/** 把 <Coordinate> props 翻成 IRChild（占位节点，无视觉） */
+var buildCoordinate = (props) => ({
+	type: "coordinate",
+	id: props.id,
+	position: props.position
+});
 /** 把 <Path> props 翻成 IRChild；step 序列由 readPathChildren 收集 */
 var buildPath = (props) => ({
 	type: "path",
@@ -293,6 +300,9 @@ var readSceneChildren = (children) => {
 			case TIKZ_PATH:
 				out.push(buildPath(child.props));
 				return;
+			case TIKZ_COORDINATE:
+				out.push(buildCoordinate(child.props));
+				return;
 		}
 		if (typeof child.type === "function") {
 			const expanded = child.type(child.props);

package/dist/es/kernel/_displayNames.d.ts

@@ -6,6 +6,8 @@ export declare const TIKZ_PATH = "@retikz/Path";
 export declare const TIKZ_STEP = "@retikz/Step";
 /** <Text> 组件的 displayName（Node 内多行文本带样式） */
 export declare const TIKZ_TEXT = "@retikz/Text";
-/** <EdgeLabel> 组件的 displayName（Step 内边标注，ADR-0004） */
+/** <EdgeLabel> 组件的 displayName（Step 内边标注） */
 export declare const TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
+/** <Coordinate> 组件的 displayName（占位节点） */
+export declare const TIKZ_COORDINATE = "@retikz/Coordinate";
 //# sourceMappingURL=_displayNames.d.ts.map

package/dist/es/kernel/_displayNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,4CAA4C;AAC5C,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,4CAA4C;AAC5C,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6CAA6C;AAC7C,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,yCAAyC;AACzC,eAAO,MAAM,eAAe,uBAAuB,CAAC"}

package/dist/es/kernel/_displayNames.js

@@ -7,7 +7,9 @@ var TIKZ_PATH = "@retikz/Path";
 var TIKZ_STEP = "@retikz/Step";
 /** <Text> 组件的 displayName（Node 内多行文本带样式） */
 var TIKZ_TEXT = "@retikz/Text";
-/** <EdgeLabel> 组件的 displayName（Step 内边标注，ADR-0004） */
+/** <EdgeLabel> 组件的 displayName（Step 内边标注） */
 var TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
+/** <Coordinate> 组件的 displayName（占位节点） */
+var TIKZ_COORDINATE = "@retikz/Coordinate";
 //#endregion
-export { TIKZ_EDGE_LABEL, TIKZ_NODE, TIKZ_PATH, TIKZ_STEP, TIKZ_TEXT };
+export { TIKZ_COORDINATE, TIKZ_EDGE_LABEL, TIKZ_NODE, TIKZ_PATH, TIKZ_STEP, TIKZ_TEXT };

package/dist/es/kernel/_unbuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_unbuilder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_unbuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AA2JhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EAAE,KAAG,SACW,CAAC"}
+{"version":3,"file":"_unbuilder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_unbuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AAmKhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EAAE,KAAG,SACW,CAAC"}

package/dist/es/kernel/_unbuilder.js

@@ -1,6 +1,7 @@
 import { Node } from "./Node.js";
 import { Path } from "./Path.js";
 import { Step } from "./Step.js";
+import { Coordinate } from "./Coordinate.js";
 import { createElement } from "react";
 //#region src/kernel/_unbuilder.ts
 /** IR 'node' child → NodeProps；过滤 undefined 字段，不污染 React DevTools 显示 */
@@ -35,6 +36,7 @@ var nodePropsFromIR = (n) => {
 	if (n.yScale !== void 0) props.yScale = n.yScale;
 	if (n.textColor !== void 0) props.textColor = n.textColor;
 	if (n.opacity !== void 0) props.opacity = n.opacity;
+	if (n.label !== void 0) props.label = n.label;
 	return props;
 };
 /** 单个 IRStep → <Step /> element */
@@ -134,6 +136,11 @@ var childToElement = (child, key) => {
 			drawOpacity: child.drawOpacity,
 			children: child.children.map((s, j) => stepToElement(s, j))
 		});
+		case "coordinate": return createElement(Coordinate, {
+			key,
+			id: child.id,
+			position: child.position
+		});
 		default: return assertNever(child);
 	}
 };

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

@@ -3,4 +3,5 @@ export * from './Node';
 export * from './Path';
 export * from './Step';
 export * from './Text';
+export * from './Coordinate';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/es/kernel/index.js

@@ -3,3 +3,4 @@ import "./Node.js";
 import "./Path.js";
 import "./Step.js";
 import "./Text.js";
+import "./Coordinate.js";

package/dist/lib/index.cjs

@@ -5,12 +5,14 @@ const require_Node = require("./kernel/Node.cjs");
 const require_Path = require("./kernel/Path.cjs");
 const require_Step = require("./kernel/Step.cjs");
 const require_Text = require("./kernel/Text.cjs");
+const require_Coordinate = require("./kernel/Coordinate.cjs");
 require("./kernel/index.cjs");
 const require_Draw = require("./sugar/Draw.cjs");
 const require_EdgeLabel = require("./sugar/EdgeLabel.cjs");
 require("./sugar/index.cjs");
 const require__unbuilder = require("./kernel/_unbuilder.cjs");
 let _retikz_core = require("@retikz/core");
+exports.Coordinate = require_Coordinate.Coordinate;
 exports.Draw = require_Draw.Draw;
 Object.defineProperty(exports, "DrawWay", {
 	enumerable: true,

package/dist/lib/index.d.ts

@@ -6,8 +6,8 @@
  *
  * 渲染管道：buildIR → compileToScene → renderPrim → SVG
  */
-export { Tikz, Node, Path, Step, Text } from './kernel';
-export type { TikzProps, NodeProps, PathProps, StepProps, TextProps } from './kernel';
+export { Tikz, Node, Path, Step, Text, Coordinate } from './kernel';
+export type { TikzProps, NodeProps, PathProps, StepProps, TextProps, CoordinateProps, } from './kernel';
 export { Draw, EdgeLabel } from './sugar';
 export type { DrawProps, EdgeLabelProps } from './sugar';
 export { DrawWay } from '@retikz/core';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/kernel/Coordinate.cjs

@@ -0,0 +1,13 @@
+const require__displayNames = require("./_displayNames.cjs");
+//#region src/kernel/Coordinate.tsx
+/**
+* 占位节点——TikZ `\coordinate (id) at (x, y);` 同义。
+*
+* 命名一个点供后续 path 与其他 node 的 `at.of` 引用，自身不渲染任何图形，
+* 不参与 viewBox 扩展。本组件不返回任何 React 元素，由 <Tikz> builder 在
+* children 扫描阶段读出 props 构造 IR。
+*/
+var Coordinate = () => null;
+Coordinate.displayName = require__displayNames.TIKZ_COORDINATE;
+//#endregion
+exports.Coordinate = Coordinate;

package/dist/lib/kernel/Coordinate.d.ts

@@ -0,0 +1,23 @@
+import { FC } from 'react';
+import { IRAtPosition, IRPosition, PolarPosition } from '@retikz/core';
+/** <Coordinate> 组件的 props */
+export type CoordinateProps = {
+    /** 占位节点的 id；其它 path / node `at.of` 通过这个 id 引用 */
+    id: string;
+    /**
+     * 占位点位置；与 `<Node position>` 形态完全一致：
+     * - 笛卡尔 `[x, y]`
+     * - 极坐标 `{ angle, radius, origin? }`
+     * - 相对定位 `{ direction, of, distance? }`
+     */
+    position: IRPosition | PolarPosition | IRAtPosition;
+};
+/**
+ * 占位节点——TikZ `\coordinate (id) at (x, y);` 同义。
+ *
+ * 命名一个点供后续 path 与其他 node 的 `at.of` 引用，自身不渲染任何图形，
+ * 不参与 viewBox 扩展。本组件不返回任何 React 元素，由 <Tikz> builder 在
+ * children 扫描阶段读出 props 构造 IR。
+ */
+export declare const Coordinate: FC<CoordinateProps>;
+//# sourceMappingURL=Coordinate.d.ts.map

package/dist/lib/kernel/Coordinate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Coordinate.d.ts","sourceRoot":"","sources":["../../../src/kernel/Coordinate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG5E,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;CACrD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,eAAe,CAAc,CAAC"}

package/dist/lib/kernel/Node.d.ts

@@ -1,13 +1,18 @@
 import { FC, ReactNode } from 'react';
-import { IRFont, IRLineSpec, IRNode, IRPosition, NodeTextAlign, PolarPosition } from '@retikz/core';
+import { IRAtPosition, IRFont, IRLineSpec, IRNode, IRNodeLabel, IRPosition, NodeTextAlign, PolarPosition } from '@retikz/core';
 /** <Node> 组件的 props */
 export type NodeProps = {
     /** 节点 id；其他 Path/Draw 通过这个 id 引用本节点 */
     id?: string;
     /** 节点形状：rectangle（默认）/ circle / ellipse / diamond */
     shape?: IRNode['shape'];
-    /** 节点中心位置；笛卡尔 [x, y] 或极坐标（编译时解析） */
-    position: IRPosition | PolarPosition;
+    /**
+     * 节点中心位置。三种形态：
+     * - 笛卡尔 `[x, y]`
+     * - 极坐标 `{ angle, radius, origin? }`（编译时解析）
+     * - 相对定位 `{ direction, of, distance? }`（TikZ `[<direction>=<distance> of <id>]` 同义；编译时解析）
+     */
+    position: IRPosition | PolarPosition | IRAtPosition;
     /** 旋转角度（度数，与 TikZ 一致），绕节点中心；正值顺时针 */
     rotate?: number;
     /**
@@ -77,6 +82,14 @@ export type NodeProps = {
     textColor?: string;
     /** 整节点透明度 0~1（同时作用于 shape 与 text） */
     opacity?: number;
+    /**
+     * 节点附属标签——TikZ `[label=above:foo]` 同义。
+     *
+     * 单对象或数组形态；每条 label 接 `text` / `position?` / `distance?` / 样式继承。
+     * `position` 接 8 方向枚举（`above`/`right`/...）或数字角度（`label=30:foo` 等价 `position: 30`）；
+     * 缺省 'above'，distance 缺省 4。
+     */
+    label?: IRNodeLabel | Array<IRNodeLabel>;
 };
 /**
  * Node 是 DSL 标记组件——本身不渲染任何 React 元素。

package/dist/lib/kernel/Node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/kernel/Node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,oCAAoC;IACpC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAAC;IACrC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/kernel/Node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,MAAM,EACN,UAAU,EACV,MAAM,EACN,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC;IACpD,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}

package/dist/lib/kernel/Tikz.cjs

@@ -26,9 +26,13 @@ var collectArrowShapes = (prims) => {
 * 每种用到的 shape 一个 marker 定义，id 形如 `${prefix}-${shape}`，
 * marker 内 path 借 `context-stroke` / `context-fill` 让颜色随 path 同步。
 */
-var Tikz = ({ ir: irFromProp, children, width, height, className, style }) => {
+var Tikz = (props) => {
+	const { ir: irFromProp, children, width, height, className, style, nodeDistance } = props;
 	const ir = (0, react.useMemo)(() => irFromProp ?? require__builder.buildIR(children), [irFromProp, children]);
-	const scene = (0, react.useMemo)(() => (0, _retikz_core.compileToScene)(ir, { measureText: require_browser_measurer.browserMeasurer }), [ir]);
+	const scene = (0, react.useMemo)(() => (0, _retikz_core.compileToScene)(ir, {
+		measureText: require_browser_measurer.browserMeasurer,
+		nodeDistance
+	}), [ir, nodeDistance]);
 	const arrowMarkerPrefix = `retikz-arrow-${(0, react.useId)().replace(/[^a-zA-Z0-9]/g, "")}`;
 	const usedShapes = collectArrowShapes(scene.primitives);
 	const arrowMarkerIdFor = (shape) => `${arrowMarkerPrefix}-${shape}`;

package/dist/lib/kernel/Tikz.d.ts

@@ -14,6 +14,12 @@ export type TikzProps = {
     className?: string;
     /** 透传到 svg 元素的内联样式 */
     style?: CSSProperties;
+    /**
+     * 节点相对定位（`Node.position = { direction, of }`）的默认距离，单位 user units；
+     * 对应 TikZ 的 `node distance=...`。当节点 position 自带 `distance` 时优先用自带值；
+     * 都缺省时回退到 1。
+     */
+    nodeDistance?: number;
 };
 /**
  * <Tikz> 顶层容器。

package/dist/lib/kernel/Tikz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tikz.d.ts","sourceRoot":"","sources":["../../../src/kernel/Tikz.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,EAAmB,KAAK,EAAE,EAAuC,MAAM,cAAc,CAAC;AAO7F,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,mDAAmD;IACnD,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,gCAAgC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAgBF;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAuB9B,CAAC"}
+{"version":3,"file":"Tikz.d.ts","sourceRoot":"","sources":["../../../src/kernel/Tikz.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,EAAmB,KAAK,EAAE,EAAuC,MAAM,cAAc,CAAC;AAO7F,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,mDAAmD;IACnD,EAAE,CAAC,EAAE,EAAE,CAAC;IACR,gCAAgC;IAChC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAgBF;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CA2B9B,CAAC"}

package/dist/lib/kernel/_builder.cjs

@@ -102,7 +102,8 @@ var buildNode = (props) => ({
 	outerSep: props.outerSep,
 	padding: props.padding,
 	margin: props.margin,
-	font: props.font
+	font: props.font,
+	label: props.label
 });
 /**
 * 扫描 Step children，把首个 <EdgeLabel> 翻译为 IRStepLabel；
@@ -257,6 +258,12 @@ var readPathChildren = (children) => {
 	}
 	return out;
 };
+/** 把 <Coordinate> props 翻成 IRChild（占位节点，无视觉） */
+var buildCoordinate = (props) => ({
+	type: "coordinate",
+	id: props.id,
+	position: props.position
+});
 /** 把 <Path> props 翻成 IRChild；step 序列由 readPathChildren 收集 */
 var buildPath = (props) => ({
 	type: "path",
@@ -293,6 +300,9 @@ var readSceneChildren = (children) => {
 			case require__displayNames.TIKZ_PATH:
 				out.push(buildPath(child.props));
 				return;
+			case require__displayNames.TIKZ_COORDINATE:
+				out.push(buildCoordinate(child.props));
+				return;
 		}
 		if (typeof child.type === "function") {
 			const expanded = child.type(child.props);

package/dist/lib/kernel/_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EACV,EAAE,EAQH,MAAM,cAAc,CAAC;AAkXtB;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}
+{"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EACV,EAAE,EASH,MAAM,cAAc,CAAC;AA8XtB;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}

package/dist/lib/kernel/_displayNames.cjs

@@ -7,9 +7,12 @@ var TIKZ_PATH = "@retikz/Path";
 var TIKZ_STEP = "@retikz/Step";
 /** <Text> 组件的 displayName（Node 内多行文本带样式） */
 var TIKZ_TEXT = "@retikz/Text";
-/** <EdgeLabel> 组件的 displayName（Step 内边标注，ADR-0004） */
+/** <EdgeLabel> 组件的 displayName（Step 内边标注） */
 var TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
+/** <Coordinate> 组件的 displayName（占位节点） */
+var TIKZ_COORDINATE = "@retikz/Coordinate";
 //#endregion
+exports.TIKZ_COORDINATE = TIKZ_COORDINATE;
 exports.TIKZ_EDGE_LABEL = TIKZ_EDGE_LABEL;
 exports.TIKZ_NODE = TIKZ_NODE;
 exports.TIKZ_PATH = TIKZ_PATH;

package/dist/lib/kernel/_displayNames.d.ts

@@ -6,6 +6,8 @@ export declare const TIKZ_PATH = "@retikz/Path";
 export declare const TIKZ_STEP = "@retikz/Step";
 /** <Text> 组件的 displayName（Node 内多行文本带样式） */
 export declare const TIKZ_TEXT = "@retikz/Text";
-/** <EdgeLabel> 组件的 displayName（Step 内边标注，ADR-0004） */
+/** <EdgeLabel> 组件的 displayName（Step 内边标注） */
 export declare const TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
+/** <Coordinate> 组件的 displayName（占位节点） */
+export declare const TIKZ_COORDINATE = "@retikz/Coordinate";
 //# sourceMappingURL=_displayNames.d.ts.map

package/dist/lib/kernel/_displayNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,4CAA4C;AAC5C,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,4CAA4C;AAC5C,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6CAA6C;AAC7C,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,yCAAyC;AACzC,eAAO,MAAM,eAAe,uBAAuB,CAAC"}

package/dist/lib/kernel/_unbuilder.cjs

@@ -1,6 +1,7 @@
 const require_Node = require("./Node.cjs");
 const require_Path = require("./Path.cjs");
 const require_Step = require("./Step.cjs");
+const require_Coordinate = require("./Coordinate.cjs");
 let react = require("react");
 //#region src/kernel/_unbuilder.ts
 /** IR 'node' child → NodeProps；过滤 undefined 字段，不污染 React DevTools 显示 */
@@ -35,6 +36,7 @@ var nodePropsFromIR = (n) => {
 	if (n.yScale !== void 0) props.yScale = n.yScale;
 	if (n.textColor !== void 0) props.textColor = n.textColor;
 	if (n.opacity !== void 0) props.opacity = n.opacity;
+	if (n.label !== void 0) props.label = n.label;
 	return props;
 };
 /** 单个 IRStep → <Step /> element */
@@ -134,6 +136,11 @@ var childToElement = (child, key) => {
 			drawOpacity: child.drawOpacity,
 			children: child.children.map((s, j) => stepToElement(s, j))
 		});
+		case "coordinate": return (0, react.createElement)(require_Coordinate.Coordinate, {
+			key,
+			id: child.id,
+			position: child.position
+		});
 		default: return assertNever(child);
 	}
 };

package/dist/lib/kernel/_unbuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_unbuilder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_unbuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AA2JhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EAAE,KAAG,SACW,CAAC"}
+{"version":3,"file":"_unbuilder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_unbuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AAmKhE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EAAE,KAAG,SACW,CAAC"}

package/dist/lib/kernel/index.cjs

@@ -3,3 +3,4 @@ require("./Node.cjs");
 require("./Path.cjs");
 require("./Step.cjs");
 require("./Text.cjs");
+require("./Coordinate.cjs");

package/dist/lib/kernel/index.d.ts

@@ -3,4 +3,5 @@ export * from './Node';
 export * from './Path';
 export * from './Step';
 export * from './Text';
+export * from './Coordinate';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/kernel/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retikz/react",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "React adapter for retikz: Kernel/Sugar JSX components and SVG renderer.",
   "type": "module",
   "main": "dist/lib/index.cjs",
@@ -24,7 +24,7 @@
     "react-dom": ">=18"
   },
   "dependencies": {
-    "@retikz/core": "0.1.0-alpha.3"
+    "@retikz/core": "0.1.0-alpha.4"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",