@retikz/core 0.2.0-alpha.3 → 0.2.0-alpha.5

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

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAwC,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAa,KAAK,EAA6B,MAAM,cAAc,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAoBjD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA4CrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C,CAAC;AAsDF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KAgOrE,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAwC,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAa,KAAK,EAA6B,MAAM,cAAc,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAoBjD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA4CrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C,CAAC;AA6FF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KA4RrE,CAAC"}

package/dist/es/compile/compile.js

@@ -56,6 +56,18 @@ var defaultWarnDispatcher = (warning) => {
 	if (typeof process !== "undefined" && process.env.NODE_ENV === "production") return;
 	console.warn(`[retikz] ${warning.code} at ${warning.path}: ${warning.message}`);
 };
+var makePathPlaceholder = () => ({ type: "path-placeholder" });
+/** 把内部 sink 收窄回公开 ScenePrimitive[]：占位已全部回填（compileToScene 末端 placeholderBalance 无条件校验兜底） */
+var sealSink = (sink) => sink;
+/** dev 诊断：递归找出残留占位的 index 路径，供末端无条件校验报错时定位 */
+var collectPlaceholderLocators = (prims, prefix = "primitives") => {
+	const locators = [];
+	prims.forEach((prim, idx) => {
+		if (prim.type === "path-placeholder") locators.push(`${prefix}[${idx}]`);
+		else if (prim.type === "group") locators.push(...collectPlaceholderLocators(prim.children, `${prefix}[${idx}].children`));
+	});
+	return locators;
+};
 /** scope.transforms 解析失败时根据失败成因映射的 warn code */
 var scopeTransformWarnCode = (scope) => {
 	for (const t of scope.transforms ?? []) {
@@ -98,11 +110,32 @@ var compileToScene = (ir, options = {}) => {
 		});
 	}
 	const primitives = [];
+	/** 已 push 但未回填的占位计数；compileToScene 返回前必须归零（无条件守 Scene 公开契约） */
+	let placeholderBalance = 0;
+	/**
+	* primitive → 显式 zIndex 旁路记录（缺省视为 0）；sealSink 后按它稳定排序，不写进 primitive 本体（保 Scene 输出纯净）。
+	* key 只会是 real ScenePrimitive——占位 PathPlaceholder 永不进此 Map（占位即将被回填替换）。
+	*/
+	const zIndexOf = /* @__PURE__ */ new Map();
+	/**
+	* 按 zIndex 升序原地稳定排序：同 zIndex 保持原 IR 顺序（decorate-sort 带原始下标）。全 0 键 = 恒等。
+	* 仅在 sealSink（占位已回填、类型已收窄回 ScenePrimitive）之后调用。
+	*/
+	const stableSortByZIndex = (arr) => {
+		const decorated = arr.map((prim, index) => ({
+			prim,
+			index,
+			z: zIndexOf.get(prim) ?? 0
+		}));
+		decorated.sort((a, b) => a.z - b.z || a.index - b.index);
+		for (let i = 0; i < arr.length; i++) arr[i] = decorated[i].prim;
+		return arr;
+	};
 	const nameStack = new NameStack({ onDuplicate: (info) => onWarn(formatDuplicateWarning(info)) });
 	const allPoints = [];
 	/**
 	* 解析一批本层收集的 pending paths（lookup-only 阶段）
-	* @description path primitive 一律 push 到顶层 `primitives` —— 端点已是全局坐标，不能进 GroupPrim 否则被 scope.transform 二次 apply。NameStack 切到 pass2 守门：path 解析中误调 register 抛 internal error；解析完切回 pass1 让上层 scope 子树继续 register 子节点。
+	* @description 两种落点：有 `slot`（scopeChain 为空）→ 原位 splice 回填该 path 在本层 sink 占的位（按引用定位免索引漂移），保住与同层 node 的 IR 声明序；无 `slot`（scopeChain 非空）→ hoist 到顶层 `primitives`，因端点已是全局坐标、进 transformed GroupPrim 会被 scope.transform 二次 apply。NameStack 切到 pass2 守门：path 解析中误调 register 抛 internal error；解析完切回 pass1 让上层 scope 子树继续 register 子节点。
 	*   `item.scopeChain` 记录该 path 所属 scope 累积 transform 链——传给 emitPathPrimitive，
 	*   让 step.to 内的 polar/at/offset 字面量按"当前 scope 局部度量 + 末端 apply chain"投影回全局。
 	*/
@@ -116,10 +149,18 @@ var compileToScene = (ir, options = {}) => {
 					irPath: item.irPath,
 					scopeChain: item.scopeChain
 				});
-				if (result) {
-					for (const prim of result.primitives) primitives.push(prim);
-					for (const p of result.points) allPoints.push(p);
+				if (item.slot) {
+					const idx = item.slot.sink.indexOf(item.slot.placeholder);
+					if (idx === -1) throw new Error("internal: path placeholder missing from its sink");
+					const real = result?.primitives ?? [];
+					item.slot.sink.splice(idx, 1, ...real);
+					if (item.zIndex !== void 0) for (const prim of real) zIndexOf.set(prim, item.zIndex);
+					placeholderBalance--;
+				} else if (result) for (const prim of result.primitives) {
+					primitives.push(prim);
+					if (item.zIndex !== void 0) zIndexOf.set(prim, item.zIndex);
 				}
+				if (result) for (const p of result.points) allPoints.push(p);
 			}
 		} finally {
 			nameStack.exitLookupPhase();
@@ -143,7 +184,10 @@ var compileToScene = (ir, options = {}) => {
 				const layout = layoutNode(resolveNodeStyle(child, styleStack), measureText, nameStack, nodeDistance, chain, resolveLabelDefault(styleStack), effectiveShapes);
 				const globalLayout = chain.length === 0 ? layout : projectLayoutToGlobal(layout, chain);
 				if (child.id) nameStack.register(child.id, globalLayout, `${locatorPrefix}children[${i}].node.id`);
-				for (const prim of emitNodePrimitives(layout, round)) sink.push(prim);
+				for (const prim of emitNodePrimitives(layout, round)) {
+					sink.push(prim);
+					if (child.zIndex !== void 0) zIndexOf.set(prim, child.zIndex);
+				}
 				allPoints.push(rect.anchor(globalLayout.rect, "north-west"), rect.anchor(globalLayout.rect, "north-east"), rect.anchor(globalLayout.rect, "south-west"), rect.anchor(globalLayout.rect, "south-east"));
 				layoutsAccumulator.push(globalLayout);
 			} else if (child.type === "coordinate") {
@@ -196,22 +240,40 @@ var compileToScene = (ir, options = {}) => {
 				if (innerSink.length === 0 && !hasOwnTransforms && child.id === void 0) continue;
 				const group = {
 					type: "group",
-					children: innerSink
+					children: stableSortByZIndex(sealSink(innerSink))
 				};
 				if (hasOwnTransforms) group.transforms = [...ownTransforms];
 				sink.push(group);
-			} else pathsAccumulator.push({
-				path: resolveEffectivePath(child, styleStack),
-				irPath: `${locatorPrefix}children[${i}].path`,
-				scopeChain: chain
-			});
+				if (child.zIndex !== void 0) zIndexOf.set(group, child.zIndex);
+			} else {
+				const pending = {
+					path: resolveEffectivePath(child, styleStack),
+					irPath: `${locatorPrefix}children[${i}].path`,
+					scopeChain: chain,
+					zIndex: child.zIndex
+				};
+				if (chain.length === 0) {
+					const placeholder = makePathPlaceholder();
+					sink.push(placeholder);
+					pending.slot = {
+						sink,
+						placeholder
+					};
+					placeholderBalance++;
+				}
+				pathsAccumulator.push(pending);
+			}
 		}
 	};
 	const rootPaths = [];
 	processChildren(ir.children, [], primitives, "", [], rootPaths, []);
 	resolvePendingPaths(rootPaths);
+	if (placeholderBalance !== 0) {
+		const detail = typeof process !== "undefined" && process.env.NODE_ENV !== "production" ? ` at ${collectPlaceholderLocators(primitives).join(", ")}` : "";
+		throw new Error(`internal: ${placeholderBalance} unresolved path placeholder(s) leaked into Scene output${detail}`);
+	}
 	return {
-		primitives,
+		primitives: stableSortByZIndex(sealSink(primitives)),
 		layout: computeLayout(allPoints, layoutPadding, round)
 	};
 };

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

@@ -79,6 +79,10 @@ export type NodeLabelLayout = {
     fontFamily?: string;
     fontWeight?: string | number;
     fontStyle?: 'normal' | 'italic' | 'oblique';
+    /** label 文本自旋模式（none / radial / tangent / 数字角度）；缺省 = 不旋转 */
+    rotate?: 'none' | 'radial' | 'tangent' | number;
+    /** 自旋后若文字倒置则翻 180°；缺省 false */
+    keepUpright?: boolean;
 };
 /**
  * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/compile/node.ts"],"names":[],"mappings":"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"}

package/dist/es/compile/node.js

@@ -78,19 +78,51 @@ var LABEL_DIRECTION_MAP = {
 	}
 };
 /**
-* 算 label 中心点
-* @description 8 方向：节点对应 anchor 出发按单位向量 × distance 外推；数字角度：先取 angleBoundary 边界点再沿 (cos,sin) × distance 外推
+* 算 label 中心点（节点局部坐标系，未旋转）
+* @description 8 方向：节点对应 anchor 出发按单位向量 × distance 外推；数字角度：先取 angleBoundary 边界点再沿 (cos,sin) × distance 外推。
+*   两个分支都在 **axis-aligned rect（rotate=0）** 上算——node 自身 rotate 由外层 GroupPrim 统一施加；
+*   若用带 rotate 的 rect，label 位置会被 anchorOf / angleBoundaryOf 旋转一次、再被外层 group 旋转一次（双重旋转）。
+*   anchorOf / angleBoundaryOf 本身不改（path anchor `'A.north'` / `'A.30'` 仍需带 rotate 的 rect）。
 */
 var labelCenter = (layout, label) => {
+	const aaLayout = {
+		...layout,
+		rect: {
+			...layout.rect,
+			rotate: 0
+		}
+	};
 	if (typeof label.position === "number") {
 		const rad = label.position * Math.PI / 180;
-		const [bx, by] = angleBoundaryOf(layout, label.position);
+		const [bx, by] = angleBoundaryOf(aaLayout, label.position);
 		return [bx + Math.cos(rad) * label.distance, by + Math.sin(rad) * label.distance];
 	}
 	const { anchor, vec } = LABEL_DIRECTION_MAP[label.position];
-	const [bx, by] = anchorOf(layout, anchor);
+	const [bx, by] = anchorOf(aaLayout, anchor);
 	return [bx + vec[0] * label.distance, by + vec[1] * label.distance];
 };
+/** 角度换算常量（弧度 → 度） */
+var RAD_TO_DEG = 180 / Math.PI;
+/**
+* 算 label 文本自旋角度（度，屏幕 y-down，节点局部系）
+* @description radial = atan2(label中心 − node中心)；tangent = radial + 90；number = 原值；none / 缺省 = 0。
+*   keepUpright 时把"偏离正立 > 90°"的角度翻 180° 保阅读方向。方向向量在局部坐标算，node 自身 rotate 由外层 group 叠加。
+*/
+var resolveLabelRotateDeg = (label, lx, ly, cx, cy) => {
+	const mode = label.rotate;
+	if (mode === void 0 || mode === "none") return 0;
+	let deg;
+	if (typeof mode === "number") deg = mode;
+	else {
+		const radial = Math.atan2(ly - cy, lx - cx) * RAD_TO_DEG;
+		deg = mode === "tangent" ? radial + 90 : radial;
+	}
+	if (label.keepUpright) {
+		const norm = (deg % 360 + 360) % 360;
+		if (norm > 90 && norm < 270) deg += 180;
+	}
+	return deg;
+};
 /**
 * 取节点 shape 在指定角度方向的边界点
 * @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。不应用 margin（同 anchorOf）；用于 `'A.30'` 落点
@@ -177,7 +209,9 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 			fontSize: (labFont?.size ?? labelDefault?.font?.size ?? baseFontSize) * fontScale,
 			fontFamily: labFont?.family ?? labelDefault?.font?.family ?? fontFamily,
 			fontWeight: labFont?.weight ?? labelDefault?.font?.weight ?? fontWeight,
-			fontStyle: labFont?.style ?? labelDefault?.font?.style ?? fontStyle
+			fontStyle: labFont?.style ?? labelDefault?.font?.style ?? fontStyle,
+			rotate: lab.rotate,
+			keepUpright: lab.keepUpright
 		};
 	});
 	return {
@@ -257,37 +291,54 @@ var emitNodePrimitives = (layout, round) => {
 			measuredHeight: round(layout.textHeight)
 		});
 	}
-	if (layout.labels) for (const lab of layout.labels) {
-		const [lx, ly] = labelCenter(layout, lab);
-		inner.push({
-			type: "text",
-			x: round(lx),
-			y: round(ly),
-			lines: [{ text: lab.text }],
-			fontSize: lab.fontSize,
-			fontFamily: lab.fontFamily,
-			fontWeight: lab.fontWeight,
-			fontStyle: lab.fontStyle,
-			align: "middle",
-			baseline: "middle",
-			lineHeight: round(lab.fontSize * DEFAULT_LINE_HEIGHT_FACTOR),
-			fill: lab.textColor ?? "currentColor",
-			opacity: lab.opacity ?? layout.opacity,
-			measuredWidth: 0,
-			measuredHeight: round(lab.fontSize)
-		});
+	if (layout.labels) {
+		const cx = layout.rect.x;
+		const cy = layout.rect.y;
+		for (const lab of layout.labels) {
+			const [lx, ly] = labelCenter(layout, lab);
+			const textPrim = {
+				type: "text",
+				x: round(lx),
+				y: round(ly),
+				lines: [{ text: lab.text }],
+				fontSize: lab.fontSize,
+				fontFamily: lab.fontFamily,
+				fontWeight: lab.fontWeight,
+				fontStyle: lab.fontStyle,
+				align: "middle",
+				baseline: "middle",
+				lineHeight: round(lab.fontSize * DEFAULT_LINE_HEIGHT_FACTOR),
+				fill: lab.textColor ?? "currentColor",
+				opacity: lab.opacity ?? layout.opacity,
+				measuredWidth: 0,
+				measuredHeight: round(lab.fontSize)
+			};
+			const deg = resolveLabelRotateDeg(lab, lx, ly, cx, cy);
+			if (deg === 0) inner.push(textPrim);
+			else inner.push({
+				type: "group",
+				transforms: [{
+					kind: "rotate",
+					degrees: round(deg),
+					cx: round(lx),
+					cy: round(ly)
+				}],
+				children: [textPrim]
+			});
+		}
 	}
-	if (layout.rotateDeg === 0) return inner;
-	return [{
+	if (!(layout.rotateDeg !== 0 || layout.lines !== void 0)) return inner;
+	const group = {
 		type: "group",
-		transforms: [{
-			kind: "rotate",
-			degrees: round(layout.rotateDeg),
-			cx: round(layout.rect.x),
-			cy: round(layout.rect.y)
-		}],
 		children: inner
+	};
+	if (layout.rotateDeg !== 0) group.transforms = [{
+		kind: "rotate",
+		degrees: round(layout.rotateDeg),
+		cx: round(layout.rect.x),
+		cy: round(layout.rect.y)
 	}];
+	return [group];
 };
 //#endregion
 export { anchorOf, angleBoundaryOf, boundaryPointOf, emitNodePrimitives, layoutNode };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AA8BtE,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA2XrE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AA8BtE,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA8gBrE,CAAC"}

package/dist/es/compile/path/index.js

@@ -1,6 +1,7 @@
-import { arcBoundingPoints, arcEndPoint } from "../../geometry/arc.js";
+import { rectOutline } from "../../geometry/rect.js";
+import { arcBoundingPoints, arcEndPoint, ellipseArcBoundingPoints, ellipseArcPoint } from "../../geometry/arc.js";
 import { bendControlPoints } from "../../geometry/bend.js";
-import { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample } from "../../geometry/segment.js";
+import { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseArcSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample } from "../../geometry/segment.js";
 import { fallbackMeasurer } from "../text-metrics.js";
 import { clipForTarget, cornerOf, refPointOfTarget, samePoint } from "./anchor.js";
 import { emitLabelPrimitive, tForLabelPosition } from "./label.js";
@@ -51,7 +52,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		labelPrims.push(r.primitive);
 		for (const p of r.points) points.push(p);
 	};
-	const hasTo = (s) => s.kind !== "cycle" && s.kind !== "arc" && s.kind !== "circlePath" && s.kind !== "ellipsePath";
+	const hasTo = (s) => s.kind !== "cycle" && s.kind !== "arc" && s.kind !== "circlePath" && s.kind !== "ellipsePath" && s.kind !== "rectangle";
 	const anchors = steps.map((s, idx) => {
 		if (!hasTo(s)) return null;
 		const ref = refPointOfTarget(s.to, nameStack, scopeChain);
@@ -168,6 +169,12 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 		if (samePoint(p, lastEnd)) return;
 		emitMove(p);
 	};
+	/** 部分圆/椭圆的闭合模式：'open' 直接返回；缺省 / 误给 'closed' 回退 'chord' */
+	const resolvePartialClosed = (closed, idx) => {
+		if (closed === "open") return "open";
+		if (closed === "closed") warn("PARTIAL_ARC_CLOSED_INVALID", "Partial circle/ellipse (with angles) cannot use closed:'closed'; falling back to 'chord'", `children[${idx}]`);
+		return "chord";
+	};
 	for (let i = 0; i < steps.length; i++) {
 		if (i > 0) {
 			const prevStep = steps[i - 1];
@@ -193,22 +200,80 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			emitLine(toClip);
 			continue;
 		}
+		if (step.kind === "rectangle") {
+			const fromPt = refPointOfTarget(step.from, nameStack, scopeChain);
+			const toPt = refPointOfTarget(step.to, nameStack, scopeChain);
+			if (!fromPt || !toPt) {
+				if (!fromPt && typeof step.from === "string") warn("UNRESOLVED_NODE_REFERENCE", `Rectangle from references undefined node id '${step.from}'; the entire path is skipped`, `children[${i}].from`);
+				if (!toPt && typeof step.to === "string") warn("UNRESOLVED_NODE_REFERENCE", `Rectangle to references undefined node id '${step.to}'; the entire path is skipped`, `children[${i}].to`);
+				return null;
+			}
+			let rectStart = null;
+			for (const op of rectOutline(fromPt, toPt, step.roundedCorners)) if (op.kind === "move") {
+				emitMove(op.to);
+				rectStart = op.to;
+			} else if (op.kind === "line") emitLine(op.to);
+			else if (op.kind === "arc") emitArc(op.center, op.radius, op.startAngle, op.endAngle);
+			else emitClose();
+			const rx0 = Math.min(fromPt[0], toPt[0]);
+			const rx1 = Math.max(fromPt[0], toPt[0]);
+			const ry0 = Math.min(fromPt[1], toPt[1]);
+			const ry1 = Math.max(fromPt[1], toPt[1]);
+			points.push([rx0, ry0], [rx1, ry0], [rx1, ry1], [rx0, ry1]);
+			if (rectStart) penOverride = rectStart;
+			continue;
+		}
 		const prev = findPrev();
 		if (!prev) return null;
 		if (step.kind === "arc") {
-			const center = prev.anchor;
-			const startPt = arcEndPoint(center, step.radius, step.startAngle);
-			const endPt = arcEndPoint(center, step.radius, step.endAngle);
-			startSegment(startPt);
-			emitArc(center, step.radius, step.startAngle, step.endAngle);
-			for (const p of arcBoundingPoints(center, step.radius, step.startAngle, step.endAngle)) points.push(p);
-			collectLabel(step, (t) => arcSegmentSample(center, step.radius, step.startAngle, step.endAngle, t));
-			penOverride = endPt;
-			continue;
+			let center;
+			if (step.center !== void 0) {
+				const c = refPointOfTarget(step.center, nameStack, scopeChain);
+				if (!c) {
+					if (typeof step.center === "string") warn("UNRESOLVED_NODE_REFERENCE", `Arc step center references undefined node id '${step.center}'; the entire path is skipped`, `children[${i}].center`);
+					return null;
+				}
+				center = c;
+			} else center = prev.anchor;
+			if (step.radiusX !== void 0 && step.radiusY !== void 0) {
+				const rx = step.radiusX;
+				const ry = step.radiusY;
+				startSegment(ellipseArcPoint(center, rx, ry, step.startAngle));
+				emitEllipseArc(center, rx, ry, step.startAngle, step.endAngle);
+				for (const p of ellipseArcBoundingPoints(center, rx, ry, step.startAngle, step.endAngle)) points.push(p);
+				collectLabel(step, (t) => ellipseArcSegmentSample(center, rx, ry, step.startAngle, step.endAngle, t));
+				penOverride = ellipseArcPoint(center, rx, ry, step.endAngle);
+				continue;
+			}
+			if (step.radius !== void 0) {
+				const r = step.radius;
+				startSegment(arcEndPoint(center, r, step.startAngle));
+				emitArc(center, r, step.startAngle, step.endAngle);
+				for (const p of arcBoundingPoints(center, r, step.startAngle, step.endAngle)) points.push(p);
+				collectLabel(step, (t) => arcSegmentSample(center, r, step.startAngle, step.endAngle, t));
+				penOverride = arcEndPoint(center, r, step.endAngle);
+				continue;
+			}
+			warn("ARC_MISSING_RADIUS", "Arc step requires radius (circular) or both radiusX and radiusY (elliptical); the entire path is skipped", `children[${i}]`);
+			return null;
 		}
 		if (step.kind === "circlePath") {
 			const center = prev.anchor;
 			const r = step.radius;
+			if (step.startAngle !== void 0 && step.endAngle !== void 0) {
+				const startA = step.startAngle;
+				const endA = step.endAngle;
+				startSegment(ellipseArcPoint(center, r, r, startA));
+				emitEllipseArc(center, r, r, startA, endA);
+				for (const p of ellipseArcBoundingPoints(center, r, r, startA, endA)) points.push(p);
+				collectLabel(step, (t) => ellipseArcSegmentSample(center, r, r, startA, endA, t));
+				if (resolvePartialClosed(step.closed, i) === "chord") {
+					emitClose();
+					penOverride = ellipseArcPoint(center, r, r, startA);
+				} else penOverride = ellipseArcPoint(center, r, r, endA);
+				continue;
+			}
+			if (step.startAngle !== void 0 || step.endAngle !== void 0) warn("PARTIAL_ARC_NEEDS_BOTH_ANGLES", "circlePath needs both startAngle and endAngle for a partial circle; treated as a full circle", `children[${i}]`);
 			startSegment([center[0] + r, center[1]]);
 			emitEllipseArc(center, r, r, 0, 360);
 			points.push([center[0] + r, center[1]]);
@@ -223,6 +288,20 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 			const center = prev.anchor;
 			const rx = step.radiusX;
 			const ry = step.radiusY;
+			if (step.startAngle !== void 0 && step.endAngle !== void 0) {
+				const startA = step.startAngle;
+				const endA = step.endAngle;
+				startSegment(ellipseArcPoint(center, rx, ry, startA));
+				emitEllipseArc(center, rx, ry, startA, endA);
+				for (const p of ellipseArcBoundingPoints(center, rx, ry, startA, endA)) points.push(p);
+				collectLabel(step, (t) => ellipseArcSegmentSample(center, rx, ry, startA, endA, t));
+				if (resolvePartialClosed(step.closed, i) === "chord") {
+					emitClose();
+					penOverride = ellipseArcPoint(center, rx, ry, startA);
+				} else penOverride = ellipseArcPoint(center, rx, ry, endA);
+				continue;
+			}
+			if (step.startAngle !== void 0 || step.endAngle !== void 0) warn("PARTIAL_ARC_NEEDS_BOTH_ANGLES", "ellipsePath needs both startAngle and endAngle for a partial ellipse; treated as a full ellipse", `children[${i}]`);
 			startSegment([center[0] + rx, center[1]]);
 			emitEllipseArc(center, rx, ry, 0, 360);
 			points.push([center[0] + rx, center[1]]);

package/dist/es/compile/path/relative.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,KAAK,CAAC,MAAM,CAuEd,CAAC"}
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,KAAK,CAAC,MAAM,CA6Ed,CAAC"}

package/dist/es/compile/path/relative.js

@@ -25,7 +25,11 @@ var normalizeRelativeTargets = (steps, nameStack, scopeChain = []) => {
 		}
 		if (step.kind === "arc") {
 			out.push(step);
-			if (prevEnd) prevEnd = arcEndPoint(prevEnd, step.radius, step.endAngle);
+			if (prevEnd && step.radius !== void 0 && step.center === void 0) prevEnd = arcEndPoint(prevEnd, step.radius, step.endAngle);
+			continue;
+		}
+		if (step.kind === "rectangle") {
+			out.push(step);
 			continue;
 		}
 		const original = step.to;

package/dist/es/geometry/arc.d.ts

@@ -6,4 +6,15 @@ export declare const arcEndPoint: (center: Position, radius: number, angleDeg: n
  * @description 弧投影到 x/y 轴的极值只可能在弧端点或圆周轴向四点出现。endAngle < startAngle 时按 min..max 扫描；跨 360°（270→450）按数值区间正确处理；不去重——端角恰在 90°·k 上时调用方处理
  */
 export declare const arcBoundingPoints: (center: Position, radius: number, startAngleDeg: number, endAngleDeg: number) => Array<Position>;
+/**
+ * 椭圆弧参数点：中心 + 半轴 rx/ry + 参数角（度）→ 椭圆周上点
+ * @description 与 arcEndPoint 同角度约定（SVG y-down）；endpoint = [cx + rx·cosθ, cy + ry·sinθ]。
+ *   θ 是参数角（非真实极角，rx≠ry 时两者不等）
+ */
+export declare const ellipseArcPoint: (center: Position, radiusX: number, radiusY: number, angleDeg: number) => Position;
+/**
+ * 椭圆弧 bbox 极值候选：起点、终点，加 [start,end] 区间内所有 90°·k 参数角处的椭圆周点
+ * @description 轴对齐椭圆的 x 极值在 θ=0/180、y 极值在 θ=90/270，与正圆同结构（仅半轴用 rx/ry）
+ */
+export declare const ellipseArcBoundingPoints: (center: Position, radiusX: number, radiusY: number, startAngleDeg: number, endAngleDeg: number) => Array<Position>;
 //# sourceMappingURL=arc.d.ts.map

package/dist/es/geometry/arc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../src/geometry/arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAWxC,iDAAiD;AACjD,eAAO,MAAM,WAAW,GACtB,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAiBhB,CAAC"}
+{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../src/geometry/arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAWxC,iDAAiD;AACjD,eAAO,MAAM,WAAW,GACtB,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAiBhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,QAAQ,EAChB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,QAAQ,EAChB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAehB,CAAC"}

package/dist/es/geometry/arc.js

@@ -22,5 +22,31 @@ var arcBoundingPoints = (center, radius, startAngleDeg, endAngleDeg) => {
 	}
 	return points;
 };
+/**
+* 椭圆弧参数点：中心 + 半轴 rx/ry + 参数角（度）→ 椭圆周上点
+* @description 与 arcEndPoint 同角度约定（SVG y-down）；endpoint = [cx + rx·cosθ, cy + ry·sinθ]。
+*   θ 是参数角（非真实极角，rx≠ry 时两者不等）
+*/
+var ellipseArcPoint = (center, radiusX, radiusY, angleDeg) => {
+	const rad = angleDeg * DEG_TO_RAD;
+	return [center[0] + Math.cos(rad) * radiusX, center[1] + Math.sin(rad) * radiusY];
+};
+/**
+* 椭圆弧 bbox 极值候选：起点、终点，加 [start,end] 区间内所有 90°·k 参数角处的椭圆周点
+* @description 轴对齐椭圆的 x 极值在 θ=0/180、y 极值在 θ=90/270，与正圆同结构（仅半轴用 rx/ry）
+*/
+var ellipseArcBoundingPoints = (center, radiusX, radiusY, startAngleDeg, endAngleDeg) => {
+	const points = [ellipseArcPoint(center, radiusX, radiusY, startAngleDeg), ellipseArcPoint(center, radiusX, radiusY, endAngleDeg)];
+	const lo = Math.min(startAngleDeg, endAngleDeg);
+	const hi = Math.max(startAngleDeg, endAngleDeg);
+	const kStart = Math.ceil(lo / 90);
+	const kEnd = Math.floor(hi / 90);
+	for (let k = kStart; k <= kEnd; k++) {
+		const angle = k * 90;
+		if (angle === startAngleDeg || angle === endAngleDeg) continue;
+		points.push(ellipseArcPoint(center, radiusX, radiusY, angle));
+	}
+	return points;
+};
 //#endregion
-export { arcBoundingPoints, arcEndPoint };
+export { arcBoundingPoints, arcEndPoint, ellipseArcBoundingPoints, ellipseArcPoint };

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

@@ -32,4 +32,27 @@ export declare const rect: {
     /** 从中心向 toward 方向射线与矩形边界交点（含旋转），Path 端点贴 Node 边界用 */
     boundaryPoint: (r: Rect, toward: Position) => Position;
 };
+/** rectOutline 的命令算子（供 compile 翻译为 PathCommand；几何在 core 下沉，便于未来 rectangle node shape 复用） */
+export type RectOutlineOp = {
+    kind: 'move';
+    to: Position;
+} | {
+    kind: 'line';
+    to: Position;
+} | {
+    kind: 'arc';
+    center: Position;
+    radius: number;
+    startAngle: number;
+    endAngle: number;
+} | {
+    kind: 'close';
+};
+/**
+ * 矩形 outline：两对角 → 顺时针 path 算子序列
+ * @description from/to 任意顺序，归一化 (x0,y0)=min、(x1,y1)=max。直角 = 4 line + close（起点左上 (x0,y0)）；
+ *   圆角 = 4 line + 4 quarter-arc + close（起点 (x0+r, y0)）。roundedCorners clamp 到 min(w,h)/2。
+ *   角度约定同 geometry/arc（y-down：0=+x, 90=+y/下, 180=-x, 270=-y/上）。
+ */
+export declare const rectOutline: (from: Position, to: Position, roundedCorners?: number) => Array<RectOutlineOp>;
 //# sourceMappingURL=rect.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,eAAO,MAAM,IAAI;IACf,WAAW;gBACC,IAAI,KAAG,QAAQ;IAC3B,uBAAuB;kBACT,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC,sCAAsC;gBAC1B,IAAI,QAAQ,UAAU,KAAG,QAAQ;IAuC7C,qDAAqD;uBAClC,IAAI,UAAU,QAAQ,KAAG,QAAQ;CAUrD,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,eAAO,MAAM,IAAI;IACf,WAAW;gBACC,IAAI,KAAG,QAAQ;IAC3B,uBAAuB;kBACT,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC,sCAAsC;gBAC1B,IAAI,QAAQ,UAAU,KAAG,QAAQ;IAuC7C,qDAAqD;uBAClC,IAAI,UAAU,QAAQ,KAAG,QAAQ;CAUrD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,iBAAiB,MAAM,KACtB,KAAK,CAAC,aAAa,CAgCrB,CAAC"}