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

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

@@ -0,0 +1,8 @@
+export * from './rect';
+export * from './ellipse';
+export * from './text';
+export * from './path';
+export * from './group';
+export * from './view-box';
+export * from './scene';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/primitive/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,29 @@
+import { ArrowShape } from '../ir/path/arrow';
+/** 路径原语：SVG path d 字符串；Canvas/PDF renderer 自行解析 */
+export type PathPrim = {
+    /** 类型判别符 */
+    type: 'path';
+    /** SVG path d 字符串 */
+    d: string;
+    /** 填充色；不填表示不填充 */
+    fill?: string;
+    /** SVG fill-rule：`nonzero`（默认）/ `evenodd`（环形 / 孔洞场景） */
+    fillRule?: 'nonzero' | 'evenodd';
+    /** 描边色 */
+    stroke?: string;
+    /** 描边宽度 */
+    strokeWidth?: number;
+    /** SVG stroke-dasharray 模式 */
+    strokeDasharray?: string;
+    /** 端点形状 */
+    strokeLinecap?: 'butt' | 'round' | 'square';
+    /** 拐点形状 */
+    strokeLinejoin?: 'miter' | 'round' | 'bevel';
+    /** 起点箭头形状；undefined = 无 */
+    arrowStart?: ArrowShape;
+    /** 终点箭头形状；undefined = 无 */
+    arrowEnd?: ArrowShape;
+    /** 整体透明度 0~1 */
+    opacity?: number;
+};
+//# sourceMappingURL=path.d.ts.map

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

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

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

@@ -0,0 +1,28 @@
+/** 矩形原语 */
+export type RectPrim = {
+    /** 类型判别符 */
+    type: 'rect';
+    /** 左上角横坐标 */
+    x: number;
+    /** 左上角纵坐标 */
+    y: number;
+    /** 矩形宽度 */
+    width: number;
+    /** 矩形高度 */
+    height: number;
+    /** 填充色，CSS 颜色字符串 */
+    fill?: string;
+    /** 填充透明度 0~1 */
+    fillOpacity?: number;
+    /** 描边色 */
+    stroke?: string;
+    /** 描边宽度 */
+    strokeWidth?: number;
+    /** SVG stroke-dasharray 模式 */
+    strokeDasharray?: string;
+    /** 圆角半径（同时作用于 rx/ry） */
+    cornerRadius?: number;
+    /** 整体透明度 0~1 */
+    opacity?: number;
+};
+//# sourceMappingURL=rect.d.ts.map

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

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

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

@@ -0,0 +1,21 @@
+import { EllipsePrim } from './ellipse';
+import { GroupPrim } from './group';
+import { PathPrim } from './path';
+import { RectPrim } from './rect';
+import { TextPrim } from './text';
+import { ViewBox } from './view-box';
+/**
+ * Scene primitive：渲染目标无关的最大公约子集。
+ * 所有 adapter（SVG / Canvas / PDF / Skia）都应能消费这些原语。
+ *
+ * 不允许出现 SVG-only 或 Canvas-only 特性（filter、marker、imageData 等）。
+ */
+export type ScenePrimitive = RectPrim | EllipsePrim | TextPrim | PathPrim | GroupPrim;
+/** 场景：渲染目标无关的"已布局好的图元集合 + viewBox" */
+export type Scene = {
+    /** 已布局好的图元数组，按渲染顺序排列 */
+    primitives: Array<ScenePrimitive>;
+    /** 整个场景的视口范围 */
+    viewBox: ViewBox;
+};
+//# sourceMappingURL=scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/primitive/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,sCAAsC;AACtC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

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

@@ -0,0 +1,32 @@
+/** 文本原语；measuredWidth/Height 由 Scene 编译阶段算好，下游直接信任 */
+export type TextPrim = {
+    /** 类型判别符 */
+    type: 'text';
+    /** 锚点横坐标（具体含义由 align 决定） */
+    x: number;
+    /** 锚点纵坐标（具体含义由 baseline 决定） */
+    y: number;
+    /** 文本内容 */
+    content: string;
+    /** 字号 */
+    fontSize: number;
+    /** 字体族 */
+    fontFamily?: string;
+    /** 字重 */
+    fontWeight?: string | number;
+    /** 字形 */
+    fontStyle?: 'normal' | 'italic';
+    /** 水平对齐：start / middle / end 锚点位置 */
+    align: 'start' | 'middle' | 'end';
+    /** 垂直基线对齐方式 */
+    baseline: 'top' | 'middle' | 'bottom' | 'alphabetic';
+    /** 编译期算好的文字宽度（user units） */
+    measuredWidth: number;
+    /** 编译期算好的文字高度（user units） */
+    measuredHeight: number;
+    /** 文字颜色 */
+    fill?: string;
+    /** 整体透明度 0~1 */
+    opacity?: number;
+};
+//# sourceMappingURL=text.d.ts.map

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

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

package/dist/es/primitive/view-box.d.ts

@@ -0,0 +1,12 @@
+/** SVG viewBox 数值四元组 */
+export type ViewBox = {
+    /** 视口左上角横坐标 */
+    x: number;
+    /** 视口左上角纵坐标 */
+    y: number;
+    /** 视口宽度 */
+    width: number;
+    /** 视口高度 */
+    height: number;
+};
+//# sourceMappingURL=view-box.d.ts.map

package/dist/es/primitive/view-box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-box.d.ts","sourceRoot":"","sources":["../../../src/primitive/view-box.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,MAAM,OAAO,GAAG;IACpB,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/es/types.d.ts

@@ -0,0 +1,3 @@
+/** 获取对象所有值的联合类型，等价于 (typeof T)[keyof typeof T] */
+export type ValueOf<T extends object> = T[keyof T];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/lib/compile/compile.cjs

@@ -0,0 +1,43 @@
+const require_rect = require("../geometry/rect.cjs");
+const require_node = require("./node.cjs");
+const require_path = require("./path.cjs");
+const require_precision = require("./precision.cjs");
+const require_text_metrics = require("./text-metrics.cjs");
+const require_view_box = require("./view-box.cjs");
+//#region src/compile/compile.ts
+/**
+* IR → Scene。纯函数。
+* 这是所有 adapter 共享的最深层共享代码。
+*
+* 流程：
+* 1. Pass 1：按 IR children 源码顺序处理 Node——计算 layout、注册 nodeIndex、发出 RectPrim/TextPrim、累积 bbox 角点
+* 2. Pass 2：处理 Path——解析每个 step 端点（节点 ref 走 boundaryPoint，其他走 resolvePosition），写 d 字符串
+* 3. 末端用 computeViewBox 折算最终 viewBox（按 precision 四舍五入）
+*/
+var compileToScene = (ir, options = {}) => {
+	const measureText = options.measureText ?? require_text_metrics.fallbackMeasurer;
+	const viewBoxPadding = options.padding ?? 10;
+	const round = require_precision.makeRound(options.precision ?? 2);
+	const primitives = [];
+	const nodeIndex = /* @__PURE__ */ new Map();
+	const allPoints = [];
+	for (const child of ir.children) if (child.type === "node") {
+		const layout = require_node.layoutNode(child, measureText, nodeIndex);
+		if (child.id) nodeIndex.set(child.id, layout);
+		for (const prim of require_node.emitNodePrimitives(layout, round)) primitives.push(prim);
+		allPoints.push(require_rect.rect.anchor(layout.rect, "north-west"), require_rect.rect.anchor(layout.rect, "north-east"), require_rect.rect.anchor(layout.rect, "south-west"), require_rect.rect.anchor(layout.rect, "south-east"));
+	}
+	for (const child of ir.children) if (child.type === "path") {
+		const result = require_path.emitPathPrimitive(child, nodeIndex, round);
+		if (result) {
+			primitives.push(result.primitive);
+			for (const p of result.points) allPoints.push(p);
+		}
+	}
+	return {
+		primitives,
+		viewBox: require_view_box.computeViewBox(allPoints, viewBoxPadding, round)
+	};
+};
+//#endregion
+exports.compileToScene = compileToScene;

package/dist/lib/compile/compile.d.ts

@@ -0,0 +1,27 @@
+import { IR } from '../ir';
+import { Scene } from '../primitive';
+import { TextMeasurer } from './text-metrics';
+/** compileToScene 的可选参数 */
+export type CompileOptions = {
+    /** 注入文字度量函数；不传则用 fallback（不准但可跑） */
+    measureText?: TextMeasurer;
+    /** viewBox 周围的留白（user units），默认 10 */
+    padding?: number;
+    /**
+     * 输出坐标的小数位精度；默认 2（保留 2 位小数四舍五入）。
+     * 仅在写入 Scene primitive / path d 字符串 / viewBox 时生效；
+     * 内部几何计算保持完整 double 精度，避免误差累积。
+     */
+    precision?: number;
+};
+/**
+ * IR → Scene。纯函数。
+ * 这是所有 adapter 共享的最深层共享代码。
+ *
+ * 流程：
+ * 1. Pass 1：按 IR children 源码顺序处理 Node——计算 layout、注册 nodeIndex、发出 RectPrim/TextPrim、累积 bbox 角点
+ * 2. Pass 2：处理 Path——解析每个 step 端点（节点 ref 走 boundaryPoint，其他走 resolvePosition），写 d 字符串
+ * 3. 末端用 computeViewBox 折算最终 viewBox（按 precision 四舍五入）
+ */
+export declare const compileToScene: (ir: IR, options?: CompileOptions) => Scene;
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,cAAc,CAAC;AAI1D,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAGrE,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KA2CrE,CAAC"}

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

@@ -0,0 +1,9 @@
+export * from './compile';
+export * from './node';
+export * from './parseTarget';
+export * from './path';
+export * from './position';
+export * from './precision';
+export * from './text-metrics';
+export * from './view-box';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compile/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/lib/compile/node.cjs

@@ -0,0 +1,244 @@
+const require_rect = require("../geometry/rect.cjs");
+const require_circle = require("../geometry/circle.cjs");
+const require_diamond = require("../geometry/diamond.cjs");
+const require_ellipse = require("../geometry/ellipse.cjs");
+const require_position = require("./position.cjs");
+//#region src/compile/node.ts
+var DEFAULT_FONT_SIZE = 14;
+var DEFAULT_PADDING = 8;
+var DEG_TO_RAD = Math.PI / 180;
+var SQRT2 = Math.SQRT2;
+/** 由 layout 构造的 Rect（带 margin 扩张） */
+var rectOf = (layout, marginAdd) => ({
+	x: layout.rect.x,
+	y: layout.rect.y,
+	width: layout.rect.width + 2 * marginAdd,
+	height: layout.rect.height + 2 * marginAdd,
+	rotate: layout.rect.rotate
+});
+/** 由 layout 构造的 Circle（圆心 + 半径，半径=外接框边长/2 + margin） */
+var circleOf = (layout, marginAdd) => ({
+	x: layout.rect.x,
+	y: layout.rect.y,
+	radius: layout.rect.width / 2 + marginAdd,
+	rotate: layout.rect.rotate
+});
+/** 由 layout 构造的 Ellipse（rx/ry 各加 margin） */
+var ellipseOf = (layout, marginAdd) => ({
+	x: layout.rect.x,
+	y: layout.rect.y,
+	rx: layout.rect.width / 2 + marginAdd,
+	ry: layout.rect.height / 2 + marginAdd,
+	rotate: layout.rect.rotate
+});
+/** 由 layout 构造的 Diamond（halfA/halfB 各加 margin） */
+var diamondOf = (layout, marginAdd) => ({
+	x: layout.rect.x,
+	y: layout.rect.y,
+	halfA: layout.rect.width / 2 + marginAdd,
+	halfB: layout.rect.height / 2 + marginAdd,
+	rotate: layout.rect.rotate
+});
+/**
+* 取节点 shape 在 toward 方向上的"附着点"——path 端点贴边用。
+* 按 shape 多态：rect / circle / ellipse / diamond 各自的 boundaryPoint。
+* margin > 0 时形状先外扩，让 path 在 border 外停 margin 个 user units。
+*/
+var boundaryPointOf = (layout, toward) => {
+	const m = layout.margin;
+	switch (layout.shape) {
+		case "rectangle": return require_rect.rect.boundaryPoint(rectOf(layout, m), toward);
+		case "circle": return require_circle.circle.boundaryPoint(circleOf(layout, m), toward);
+		case "ellipse": return require_ellipse.ellipse.boundaryPoint(ellipseOf(layout, m), toward);
+		case "diamond": return require_diamond.diamond.boundaryPoint(diamondOf(layout, m), toward);
+	}
+};
+/**
+* 取节点 shape 的命名 anchor（center / north / east / north-east 等 9 个）。
+* **不应用 margin**——TikZ 语义中 explicit anchor 取的是视觉边界点，不涉及 outer sep。
+* 用于 `'A.north'` 这种语法落点。
+*/
+var anchorOf = (layout, name) => {
+	switch (layout.shape) {
+		case "rectangle": return require_rect.rect.anchor(rectOf(layout, 0), name);
+		case "circle": return require_circle.circle.anchor(circleOf(layout, 0), name);
+		case "ellipse": return require_ellipse.ellipse.anchor(ellipseOf(layout, 0), name);
+		case "diamond": return require_diamond.diamond.anchor(diamondOf(layout, 0), name);
+	}
+};
+/**
+* 取节点 shape 在指定角度方向上的边界点。角度约定与 PolarPosition 一致（度数）：
+*   0° = +x（east），90° = +y（screen 下方）。
+* **不应用 margin**——同 anchorOf。用于 `'A.30'` 这种语法落点。
+*/
+var angleBoundaryOf = (layout, angleDeg) => {
+	const rad = angleDeg * Math.PI / 180;
+	const toward = [layout.rect.x + Math.cos(rad), layout.rect.y + Math.sin(rad)];
+	switch (layout.shape) {
+		case "rectangle": return require_rect.rect.boundaryPoint(rectOf(layout, 0), toward);
+		case "circle": return require_circle.circle.boundaryPoint(circleOf(layout, 0), toward);
+		case "ellipse": return require_ellipse.ellipse.boundaryPoint(ellipseOf(layout, 0), toward);
+		case "diamond": return require_diamond.diamond.boundaryPoint(diamondOf(layout, 0), toward);
+	}
+};
+/**
+* 把 IR Node 解析为内部 NodeLayout：
+* - 算出文本度量与 padding 推导出"内框"半轴 (innerHalfW/H)
+* - 按 shape 决定外接边界尺寸（circle 取半对角线、ellipse 各 ×√2、diamond 各 ×2）
+* - 解析 position（笛卡尔或极坐标）为几何中心
+* - IR 的 rotate（度数）转弧度存进 Rect.rotate
+* - 透传 margin / 样式属性
+*/
+var layoutNode = (node, measureText, nodeIndex) => {
+	const fontSize = node.fontSize ?? DEFAULT_FONT_SIZE;
+	const padding = node.padding ?? DEFAULT_PADDING;
+	const metrics = node.text ? measureText(node.text, { size: fontSize }) : {
+		width: 0,
+		height: 0
+	};
+	const innerHalfW = Math.max(metrics.width / 2 + padding, padding);
+	const innerHalfH = Math.max(metrics.height / 2 + padding, padding);
+	const shape = node.shape ?? "rectangle";
+	let boundsHalfW;
+	let boundsHalfH;
+	switch (shape) {
+		case "rectangle":
+			boundsHalfW = innerHalfW;
+			boundsHalfH = innerHalfH;
+			break;
+		case "circle": {
+			const r = Math.sqrt(innerHalfW * innerHalfW + innerHalfH * innerHalfH);
+			boundsHalfW = r;
+			boundsHalfH = r;
+			break;
+		}
+		case "ellipse":
+			boundsHalfW = innerHalfW * SQRT2;
+			boundsHalfH = innerHalfH * SQRT2;
+			break;
+		case "diamond":
+			boundsHalfW = innerHalfW * 2;
+			boundsHalfH = innerHalfH * 2;
+			break;
+	}
+	const rotateDeg = node.rotate ?? 0;
+	const center = require_position.resolvePosition(node.position, nodeIndex);
+	if (!center) throw new Error(`Cannot resolve position for node ${node.id ?? "(unnamed)"}; polar.origin may reference an undefined node`);
+	return {
+		id: node.id,
+		shape,
+		rect: {
+			x: center[0],
+			y: center[1],
+			width: 2 * boundsHalfW,
+			height: 2 * boundsHalfH,
+			rotate: rotateDeg * DEG_TO_RAD
+		},
+		rotateDeg,
+		margin: node.margin ?? 0,
+		text: node.text,
+		textWidth: metrics.width,
+		textHeight: metrics.height,
+		fontSize,
+		fill: node.fill,
+		stroke: node.stroke,
+		strokeWidth: node.strokeWidth
+	};
+};
+/** rectangle shape 的 RectPrim */
+var emitRectShape = (layout, round) => {
+	const halfW = layout.rect.width / 2;
+	const halfH = layout.rect.height / 2;
+	return {
+		type: "rect",
+		x: round(layout.rect.x - halfW),
+		y: round(layout.rect.y - halfH),
+		width: round(layout.rect.width),
+		height: round(layout.rect.height),
+		fill: layout.fill ?? "transparent",
+		stroke: layout.stroke ?? "currentColor",
+		strokeWidth: layout.strokeWidth ?? 1
+	};
+};
+/** circle / ellipse shape 的 EllipsePrim（圆形 rx=ry） */
+var emitEllipseShape = (layout, round) => ({
+	type: "ellipse",
+	cx: round(layout.rect.x),
+	cy: round(layout.rect.y),
+	rx: round(layout.rect.width / 2),
+	ry: round(layout.rect.height / 2),
+	fill: layout.fill ?? "transparent",
+	stroke: layout.stroke ?? "currentColor",
+	strokeWidth: layout.strokeWidth ?? 1
+});
+/** diamond shape 的 PathPrim（4 顶点 + Z 闭合） */
+var emitDiamondShape = (layout, round) => {
+	const diam = diamondOf(layout, 0);
+	const e = require_diamond.diamond.anchor(diam, "east");
+	const n = require_diamond.diamond.anchor(diam, "north");
+	const w = require_diamond.diamond.anchor(diam, "west");
+	const s = require_diamond.diamond.anchor(diam, "south");
+	return {
+		type: "path",
+		d: `M ${round(e[0])} ${round(e[1])} L ${round(n[0])} ${round(n[1])} L ${round(w[0])} ${round(w[1])} L ${round(s[0])} ${round(s[1])} Z`,
+		fill: layout.fill ?? "transparent",
+		stroke: layout.stroke ?? "currentColor",
+		strokeWidth: layout.strokeWidth ?? 1
+	};
+};
+/**
+* 把 NodeLayout 翻译为 Scene primitives：
+* - shape 主体：按 shape 分发（rect / ellipse / path）
+* - text（如有内容）：始终走 TextPrim
+* - 若有旋转：外面套一层 GroupPrim 用 SVG `rotate(deg cx cy)` 实现
+*   （PathPrim 的 diamond 顶点已自带旋转坐标，但 text 需要 group 旋转，
+*    所以仍统一用 group 包裹）
+*/
+var emitNodePrimitives = (layout, round) => {
+	let shapePrim;
+	switch (layout.shape) {
+		case "rectangle":
+			shapePrim = emitRectShape(layout, round);
+			break;
+		case "circle":
+		case "ellipse":
+			shapePrim = emitEllipseShape(layout, round);
+			break;
+		case "diamond":
+			shapePrim = emitDiamondShape(unrotated(layout), round);
+			break;
+	}
+	const inner = [shapePrim];
+	if (layout.text) inner.push({
+		type: "text",
+		x: round(layout.rect.x),
+		y: round(layout.rect.y),
+		content: layout.text,
+		fontSize: layout.fontSize,
+		align: "middle",
+		baseline: "middle",
+		fill: "currentColor",
+		measuredWidth: round(layout.textWidth),
+		measuredHeight: round(layout.textHeight)
+	});
+	if (layout.rotateDeg === 0) return inner;
+	return [{
+		type: "group",
+		transform: `rotate(${round(layout.rotateDeg)} ${round(layout.rect.x)} ${round(layout.rect.y)})`,
+		children: inner
+	}];
+};
+/** 返回 layout 的"未旋转"副本——用于先把 diamond 顶点按未旋转算，再由外层 group 统一旋转 */
+var unrotated = (layout) => ({
+	...layout,
+	rect: {
+		...layout.rect,
+		rotate: 0
+	}
+});
+//#endregion
+exports.anchorOf = anchorOf;
+exports.angleBoundaryOf = angleBoundaryOf;
+exports.boundaryPointOf = boundaryPointOf;
+exports.emitNodePrimitives = emitNodePrimitives;
+exports.layoutNode = layoutNode;

package/dist/lib/compile/node.d.ts

@@ -0,0 +1,76 @@
+import { Position } from '../geometry/point';
+import { Rect, RectAnchor } from '../geometry/rect';
+import { IRNode, NodeShape } from '../ir';
+import { ScenePrimitive } from '../primitive';
+import { TextMeasurer } from './text-metrics';
+export type NodeLayout = {
+    /** 节点 id（如 IR Node 提供）；其他位置可通过 id 引用本节点 */
+    id?: string;
+    /** 节点形状——所有几何 / boundaryPoint 计算按 shape 多态 */
+    shape: NodeShape;
+    /**
+     * 节点视觉边界框（所有 shape 共享语义）：
+     * - rectangle: rect 即矩形本身
+     * - circle:    rect.width = rect.height = 2 × radius（外接正方形）
+     * - ellipse:   rect.width = 2 × rx，rect.height = 2 × ry（外接矩形）
+     * - diamond:   rect.width = 2 × halfA，rect.height = 2 × halfB（外接矩形）
+     *
+     * x, y 是几何中心；rotate 是弧度（与 packages/core/AGENTS.md 对齐）。
+     */
+    rect: Rect;
+    /** IR 中原始的旋转角（度数），保留供 emit 阶段写 SVG transform */
+    rotateDeg: number;
+    /** 外边距（user units，≥ 0）；path 附着到形状外扩 margin 的虚拟边界上 */
+    margin: number;
+    /** 节点文本内容；空字符串视为无文本（undefined） */
+    text?: string;
+    /** 文本宽度（user units），由 TextMeasurer 算出 */
+    textWidth: number;
+    /** 文本高度（user units），由 TextMeasurer 算出 */
+    textHeight: number;
+    /** 文本字号（user units） */
+    fontSize: number;
+    /** 节点背景色，CSS 颜色字符串；emit 时用 'transparent' 兜底 */
+    fill?: string;
+    /** 节点边框色，CSS 颜色字符串；emit 时用 'currentColor' 兜底 */
+    stroke?: string;
+    /** 节点边框宽度（user units）；emit 时用 1 兜底 */
+    strokeWidth?: number;
+};
+/**
+ * 取节点 shape 在 toward 方向上的"附着点"——path 端点贴边用。
+ * 按 shape 多态：rect / circle / ellipse / diamond 各自的 boundaryPoint。
+ * margin > 0 时形状先外扩，让 path 在 border 外停 margin 个 user units。
+ */
+export declare const boundaryPointOf: (layout: NodeLayout, toward: Position) => Position;
+/**
+ * 取节点 shape 的命名 anchor（center / north / east / north-east 等 9 个）。
+ * **不应用 margin**——TikZ 语义中 explicit anchor 取的是视觉边界点，不涉及 outer sep。
+ * 用于 `'A.north'` 这种语法落点。
+ */
+export declare const anchorOf: (layout: NodeLayout, name: RectAnchor) => Position;
+/**
+ * 取节点 shape 在指定角度方向上的边界点。角度约定与 PolarPosition 一致（度数）：
+ *   0° = +x（east），90° = +y（screen 下方）。
+ * **不应用 margin**——同 anchorOf。用于 `'A.30'` 这种语法落点。
+ */
+export declare const angleBoundaryOf: (layout: NodeLayout, angleDeg: number) => Position;
+/**
+ * 把 IR Node 解析为内部 NodeLayout：
+ * - 算出文本度量与 padding 推导出"内框"半轴 (innerHalfW/H)
+ * - 按 shape 决定外接边界尺寸（circle 取半对角线、ellipse 各 ×√2、diamond 各 ×2）
+ * - 解析 position（笛卡尔或极坐标）为几何中心
+ * - IR 的 rotate（度数）转弧度存进 Rect.rotate
+ * - 透传 margin / 样式属性
+ */
+export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nodeIndex: Map<string, NodeLayout>) => NodeLayout;
+/**
+ * 把 NodeLayout 翻译为 Scene primitives：
+ * - shape 主体：按 shape 分发（rect / ellipse / path）
+ * - text（如有内容）：始终走 TextPrim
+ * - 若有旋转：外面套一层 GroupPrim 用 SVG `rotate(deg cx cy)` 实现
+ *   （PathPrim 的 diamond 顶点已自带旋转坐标，但 text 需要 group 旋转，
+ *    所以仍统一用 group 包裹）
+ */
+export declare const emitNodePrimitives: (layout: NodeLayout, round: (n: number) => number) => Array<ScenePrimitive>;
+//# sourceMappingURL=node.d.ts.map

package/dist/lib/compile/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOnD,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;;;;OAQG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAsCF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,QAAQ,QAAQ,KAAG,QAYtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,EAAE,MAAM,UAAU,KAAG,QAW/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,EAAE,UAAU,MAAM,KAAG,QActE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GACrB,MAAM,MAAM,EACZ,aAAa,YAAY,EACzB,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,KACjC,UAmEF,CAAC;AAyDF;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,UAAU,EAClB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,KAAK,CAAC,cAAc,CAyCtB,CAAC"}

package/dist/lib/compile/parseTarget.cjs

@@ -0,0 +1,48 @@
+const require_rect = require("../geometry/rect.cjs");
+//#region src/compile/parseTarget.ts
+/**
+* 节点 ref 字符串扩展语法（ADR-0004）：
+*
+*   `'A'`         → 节点 A，由 path 自动 boundary clip（auto 模式）
+*   `'A.<name>'`  → 节点 A 的命名 anchor（center/north/south/east/west/north-east/...）
+*   `'A.<deg>'`   → 节点 A 在 degree 角度方向上的边界点（同 PolarPosition 角度约定）
+*
+* id 约束：`[A-Za-z_][\w-]*`——禁数字开头、禁含 `.`（与 anchor 分隔符冲突）；
+* anchor 名只接受 alpha.1 首批 9 个 RECT_ANCHORS（其余如 'text' / 'base' / 'mid'
+* 留 alpha.2 + 字体改造时再支持）；角度纯数字（含可选 `.`/`-`）。
+*/
+/** alpha.1 支持的 anchor 名集合（RECT_ANCHORS 的 9 个值） */
+var ANCHOR_NAMES = new Set(Object.values(require_rect.RECT_ANCHORS));
+/** 纯数字（可选小数 / 负号），用于识别 `A.30` / `A.-45` / `A.180.5` */
+var ANGLE_RE = /^-?\d+(\.\d+)?$/;
+/**
+* 解析节点 ref 字符串。
+*
+* - 不带 `.`：node（auto-clip）
+* - 带 `.` 后纯数字：angle（toward 方向上的边界点，与 PolarPosition 同角度约定）
+* - 带 `.` 后字母 / 连字符：anchor（命中 ANCHOR_NAMES 才合法，否则抛错）
+*
+* 抛错路径：未知 anchor 名（避免静默吞掉拼写错误）。
+*/
+var parseNodeRef = (s) => {
+	const dot = s.indexOf(".");
+	if (dot < 0) return {
+		kind: "node",
+		id: s
+	};
+	const id = s.slice(0, dot);
+	const tail = s.slice(dot + 1);
+	if (ANGLE_RE.test(tail)) return {
+		kind: "angle",
+		id,
+		angle: Number(tail)
+	};
+	if (!ANCHOR_NAMES.has(tail)) throw new Error(`parseNodeRef: unknown anchor '${tail}' in '${s}' (alpha.1 supports: ${[...ANCHOR_NAMES].join(", ")})`);
+	return {
+		kind: "anchor",
+		id,
+		anchor: tail
+	};
+};
+//#endregion
+exports.parseNodeRef = parseNodeRef;

package/dist/lib/compile/parseTarget.d.ts

@@ -0,0 +1,25 @@
+import { RectAnchor } from '../geometry/rect';
+/** 解析后的节点 ref 三态 */
+export type ParsedNodeRef = {
+    kind: 'node';
+    id: string;
+} | {
+    kind: 'anchor';
+    id: string;
+    anchor: RectAnchor;
+} | {
+    kind: 'angle';
+    id: string;
+    angle: number;
+};
+/**
+ * 解析节点 ref 字符串。
+ *
+ * - 不带 `.`：node（auto-clip）
+ * - 带 `.` 后纯数字：angle（toward 方向上的边界点，与 PolarPosition 同角度约定）
+ * - 带 `.` 后字母 / 连字符：anchor（命中 ANCHOR_NAMES 才合法，否则抛错）
+ *
+ * 抛错路径：未知 anchor 名（避免静默吞掉拼写错误）。
+ */
+export declare const parseNodeRef: (s: string) => ParsedNodeRef;
+//# sourceMappingURL=parseTarget.d.ts.map