@retikz/core 0.3.0-alpha.3 → 0.3.0-alpha.4

package/dist/es/shapes/define.js

@@ -0,0 +1,13 @@
+//#region src/shapes/define.ts
+/**
+* 注册一个参数化 shape（定义点 typed，返回擦除形态进 registry）
+* @description 定义点用具体 `TParams` 拿全程类型安全（`paramsSchema` 输出与 5 个计算函数末位 `params` 同型），
+*   返回擦除成 `ShapeDefinition`（所有函数收 `IRJsonObject`）供同构 registry 存放。擦除的单点 cast 封在此处，
+*   **形状实现者不 cast**。含函数与 `paramsSchema`，**不进 IR**——它是 `CompileOptions.shapes` 运行时注入的
+*   TS 对象，符合 IR 100% JSON 可序列化约束（函数只在运行时注入面，不在 IR 字段里）。
+* @param def shape 定义（paramsSchema / circumscribe / boundaryPoint / anchor / edgePoint? / emit）
+* @returns 擦除成 `ShapeDefinition` 的同一份 def（便于 `export const sector = defineShape({ ... })`）
+*/
+var defineShape = (def) => def;
+//#endregion
+export { defineShape };

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

@@ -1,8 +1,9 @@
-import { ShapeDefinition } from './types';
 /**
  * ellipse 注册项
- * @description circumscribe = 内框 ×√2（内框 4 顶点落在椭圆周上）；几何由外接框半轴派生；
- *   emit 出 EllipsePrim，与旧 `emitEllipseShape` 逐字段等价
+ * @description circumscribe 受 `params.circumscribe` 控制：`'equal'`（等轴，circle：两轴 = 内框对角线半长
+ *   `√(hw²+hh²)`）/ `'proportional'`（默认，各轴 ×√2，内框 4 顶点落在椭圆周上）。几何由外接框半轴派生；
+ *   emit / anchor / edgePoint / boundaryPoint 只一套（不读 `params`）。circle 在 compile 期规范化为
+ *   `{ type: 'ellipse', params: { circumscribe: 'equal' } }`。
  */
-export declare const ellipse: ShapeDefinition;
+export declare const ellipse: import('./types').ShapeDefinition;
 //# sourceMappingURL=ellipse.d.ts.map

package/dist/es/shapes/ellipse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/shapes/ellipse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAW/C;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,eAwBrB,CAAC"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/shapes/ellipse.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,mCAmClB,CAAC"}

package/dist/es/shapes/ellipse.js

@@ -1,5 +1,7 @@
-import { ellipse as ellipse$1 } from "../geometry/ellipse.js";
+import { defineShape } from "./define.js";
 import { asRectAnchor } from "./_shared.js";
+import { ellipse as ellipse$1 } from "../geometry/ellipse.js";
+import { z } from "zod";
 //#region src/shapes/ellipse.ts
 /** 外接框 Rect → Ellipse（rx/ry = 半宽/半高） */
 var toEllipse = (r) => ({
@@ -11,14 +13,20 @@ var toEllipse = (r) => ({
 });
 /**
 * ellipse 注册项
-* @description circumscribe = 内框 ×√2（内框 4 顶点落在椭圆周上）；几何由外接框半轴派生；
-*   emit 出 EllipsePrim，与旧 `emitEllipseShape` 逐字段等价
+* @description circumscribe 受 `params.circumscribe` 控制：`'equal'`（等轴，circle：两轴 = 内框对角线半长
+*   `√(hw²+hh²)`）/ `'proportional'`（默认，各轴 ×√2，内框 4 顶点落在椭圆周上）。几何由外接框半轴派生；
+*   emit / anchor / edgePoint / boundaryPoint 只一套（不读 `params`）。circle 在 compile 期规范化为
+*   `{ type: 'ellipse', params: { circumscribe: 'equal' } }`。
 */
-var ellipse = {
-	circumscribe: (hw, hh) => ({
+var ellipse = defineShape({
+	paramsSchema: z.strictObject({ circumscribe: z.enum(["proportional", "equal"]).optional().describe("Circumscription policy from the inner content box: \"proportional\" (per-axis ×√2, ellipse) or \"equal\" (isotropic, circle: r = diagonal half-length). Default \"proportional\".") }),
+	circumscribe: (hw, hh, params) => params.circumscribe === "equal" ? {
+		halfWidth: Math.hypot(hw, hh),
+		halfHeight: Math.hypot(hw, hh)
+	} : {
 		halfWidth: hw * Math.SQRT2,
 		halfHeight: hh * Math.SQRT2
-	}),
+	},
 	boundaryPoint: (r, toward) => ellipse$1.boundaryPoint(toEllipse(r), toward),
 	anchor: (r, name) => {
 		const a = asRectAnchor(name);
@@ -41,6 +49,6 @@ var ellipse = {
 			opacity: style.opacity
 		};
 	}
-};
+});
 //#endregion
 export { ellipse };

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

@@ -1,13 +1,16 @@
 import { BuiltinShapeName } from '../ir/node';
-import { circle } from './circle';
-import { diamond } from './diamond';
+import { arc } from './arc';
+import { defineShape } from './define';
 import { ellipse } from './ellipse';
+import { polygon } from './polygon';
 import { rectangle } from './rectangle';
+import { sector } from './sector';
+import { star } from './star';
 import { ShapeDefinition } from './types';
-/** 内置 4 shape 注册项；与 `CompileOptions.shapes` 合并时被同名注入覆盖 */
-export declare const BUILTIN_SHAPES: Record<BuiltinShapeName, ShapeDefinition>;
-export { rectangle, circle, ellipse, diamond };
-export type { ShapeDefinition, ShapeStyle } from './types';
+/** 内置 shape 注册项（circle / diamond 已收为 preset，不占独立项）；与 `CompileOptions.shapes` 合并时被同名注入覆盖 */
+export declare const BUILTIN_SHAPES: Record<Exclude<BuiltinShapeName, 'circle' | 'diamond'> | 'sector' | 'arc' | 'polygon' | 'star', ShapeDefinition>;
+export { rectangle, ellipse, polygon, sector, arc, star, defineShape };
+export type { ShapeDefinition, ShapeDefinitionInput, ShapeStyle } from './types';
 export type { Rect } from '../geometry/rect';
 export type { Position } from '../geometry/point';
 export { worldToLocal, localToWorld } from '../geometry/_transform';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shapes/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAKpE,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3D,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shapes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,2FAA2F;AAC3F,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,EAAE,eAAe,CAO3I,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjF,YAAY,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/es/shapes/index.js

@@ -1,15 +1,20 @@
 import "../geometry/_transform.js";
+import "./define.js";
+import { arc } from "./arc.js";
 import { ellipse } from "./ellipse.js";
-import { circle } from "./circle.js";
-import { diamond } from "./diamond.js";
+import { polygon } from "./polygon.js";
 import { rectangle } from "./rectangle.js";
+import { sector } from "./sector.js";
+import { star } from "./star.js";
 //#region src/shapes/index.ts
-/** 内置 4 shape 注册项；与 `CompileOptions.shapes` 合并时被同名注入覆盖 */
+/** 内置 shape 注册项（circle / diamond 已收为 preset，不占独立项）；与 `CompileOptions.shapes` 合并时被同名注入覆盖 */
 var BUILTIN_SHAPES = {
 	rectangle,
-	circle,
 	ellipse,
-	diamond
+	sector,
+	arc,
+	polygon,
+	star
 };
 //#endregion
 export { BUILTIN_SHAPES };

package/dist/es/shapes/polygon.d.ts

@@ -0,0 +1,13 @@
+/**
+ * polygon 注册项：正多边形（sides 顶点均布外接圆，rotate 定起始角，cornerRadius 顶点倒角）
+ * @description 文本容器形状——circumscribe 从内框 `innerHalfWidth/Height` 推能容纳内框的外接圆、再取其 AABB 半轴，
+ *   尺寸仍由内框 + minimumSize 驱动（区别于 sector / star 的 params-半径驱动）。emit / boundaryPoint 把顶点环构造成
+ *   `sides` 条折线段，委托 rounded-contour 模块：cornerRadius 省略 / 0 出原尖角轮廓、>0 在每个顶点插逐角夹紧的
+ *   fillet 弧。emit 收轴对齐 rect（旋转由外层 group 施加）、boundaryPoint 收带 rotate 的 rect 且 rayOrigin = 几何中心
+ *   （多边形关于中心对称，AABB 中心 = 形心 = node position）。命名 anchor 走外接 AABB 的 9 名 rect anchor（不随
+ *   cornerRadius 移）；self-rotate（params.rotate）与 Node.rotate 叠加。scaleParams：cornerRadius 是长度随 scale
+ *   缩（几何均值因子），sides 计数 / rotate 角度不缩。
+ *   diamond ≡ `{ type: 'polygon', params: { sides: 4, rotate: 45 } }`，由 compile 规范化。
+ */
+export declare const polygon: import('./types').ShapeDefinition;
+//# sourceMappingURL=polygon.d.ts.map

package/dist/es/shapes/polygon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../../src/shapes/polygon.ts"],"names":[],"mappings":"AA8EA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,mCAiElB,CAAC"}

package/dist/es/shapes/polygon.js

@@ -0,0 +1,104 @@
+import { localToWorld } from "../geometry/_transform.js";
+import { rect } from "../geometry/rect.js";
+import { defineShape } from "./define.js";
+import { asRectAnchor } from "./_shared.js";
+import { boundaryFromContour, contourCommands } from "../geometry/roundedContour.js";
+import { contourToPathCommands, verticesToSegments } from "./_contour.js";
+import { z } from "zod";
+//#region src/shapes/polygon.ts
+var DEG_TO_RAD = Math.PI / 180;
+/** 顶点角集合（度）：第 k 个顶点角 = rotate + k·(360/sides) */
+var vertexAngles = (params) => {
+	const startDeg = params.rotate ?? 0;
+	const stepDeg = 360 / params.sides;
+	const out = [];
+	for (let k = 0; k < params.sides; k++) out.push(startDeg + k * stepDeg);
+	return out;
+};
+/** 顶点角的 |cos| 最大值（恒 >0，sides≥3 时至少一个顶点不在 ±y 轴上）；用于由 AABB 半宽反推外接半径 */
+var maxAbsCos = (params) => Math.max(...vertexAngles(params).map((a) => Math.abs(Math.cos(a * DEG_TO_RAD))));
+/**
+* 能容纳内框（半轴 hw/hh）的正 sides 边形外接圆半径
+* @description rectangle / polygon 是文本容器——尺寸由内框（text + padding）驱动，circumscribe 从内框推外接。
+*   正多边形 = 各边内法向投影 ≤ 内切半径(apothem) 的半平面交；apothem = R·cos(π/sides)。内框 4 角
+*   (±hw,±hh) 全在多边形内 ⇔ 对每条边法向 φ_j，max 角投影 hw·|cosφ_j|+hh·|sinφ_j| ≤ apothem。
+*   取使等号成立的最小 R = max_j(hw·|cosφ_j|+hh·|sinφ_j|) / cos(π/sides)，φ_j = rotate+(j+0.5)·(360/sides)。
+*/
+var circumradiusFor = (hw, hh, params) => {
+	const { sides } = params;
+	const startDeg = params.rotate ?? 0;
+	const stepDeg = 360 / sides;
+	const apothemFactor = Math.cos(Math.PI / sides);
+	let maxSupport = 0;
+	for (let j = 0; j < sides; j++) {
+		const phi = (startDeg + (j + .5) * stepDeg) * DEG_TO_RAD;
+		const support = hw * Math.abs(Math.cos(phi)) + hh * Math.abs(Math.sin(phi));
+		if (support > maxSupport) maxSupport = support;
+	}
+	return maxSupport / apothemFactor;
+};
+/** 由外接 AABB（emit / boundaryPoint 收到的 rect）反推外接圆半径：R = halfWidth / max|cosθ_k| */
+var circumradiusFromRect = (rect, params) => rect.width / 2 / maxAbsCos(params);
+/**
+* 正多边形 `sides` 个顶点的世界坐标（外接圆半径 radius、起始角 rotate、绕 rect 中心）
+* @description 顶点均布外接圆：第 k 个顶点角 = rotate + k·(360/sides)；点在 rect 局部系算后经 localToWorld 投世界。
+*   emit / boundaryPoint / anchor 共用此真源。
+*/
+var polygonVertices = (rect, radius, params) => vertexAngles(params).map((deg) => {
+	const a = deg * DEG_TO_RAD;
+	return localToWorld(rect, [radius * Math.cos(a), radius * Math.sin(a)]);
+});
+/**
+* polygon 注册项：正多边形（sides 顶点均布外接圆，rotate 定起始角，cornerRadius 顶点倒角）
+* @description 文本容器形状——circumscribe 从内框 `innerHalfWidth/Height` 推能容纳内框的外接圆、再取其 AABB 半轴，
+*   尺寸仍由内框 + minimumSize 驱动（区别于 sector / star 的 params-半径驱动）。emit / boundaryPoint 把顶点环构造成
+*   `sides` 条折线段，委托 rounded-contour 模块：cornerRadius 省略 / 0 出原尖角轮廓、>0 在每个顶点插逐角夹紧的
+*   fillet 弧。emit 收轴对齐 rect（旋转由外层 group 施加）、boundaryPoint 收带 rotate 的 rect 且 rayOrigin = 几何中心
+*   （多边形关于中心对称，AABB 中心 = 形心 = node position）。命名 anchor 走外接 AABB 的 9 名 rect anchor（不随
+*   cornerRadius 移）；self-rotate（params.rotate）与 Node.rotate 叠加。scaleParams：cornerRadius 是长度随 scale
+*   缩（几何均值因子），sides 计数 / rotate 角度不缩。
+*   diamond ≡ `{ type: 'polygon', params: { sides: 4, rotate: 45 } }`，由 compile 规范化。
+*/
+var polygon = defineShape({
+	paramsSchema: z.strictObject({
+		sides: z.number().int().min(3).describe("Number of sides of the regular polygon (>= 3)."),
+		rotate: z.number().finite().optional().describe("Shape self-rotation in degrees (vertex start direction); default 0. Composes with Node.rotate."),
+		cornerRadius: z.number().finite().nonnegative().optional().describe("Corner radius in user units; 0 / omitted = sharp corners. Clamped per corner to the largest non-self-intersecting fillet.")
+	}),
+	circumscribe: (hw, hh, params) => {
+		const radius = circumradiusFor(hw, hh, params);
+		const angles = vertexAngles(params);
+		return {
+			halfWidth: Math.max(...angles.map((a) => Math.abs(radius * Math.cos(a * DEG_TO_RAD)))),
+			halfHeight: Math.max(...angles.map((a) => Math.abs(radius * Math.sin(a * DEG_TO_RAD))))
+		};
+	},
+	boundaryPoint: (rect, toward, params) => {
+		const segments = verticesToSegments(polygonVertices(rect, circumradiusFromRect(rect, params), params));
+		const center = [rect.x, rect.y];
+		return boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
+	},
+	anchor: (rect$1, name, params) => {
+		const a = asRectAnchor(name);
+		return a ? rect.anchor(rect$1, a) : void 0;
+	},
+	*emit(rect, style, round, params) {
+		yield {
+			type: "path",
+			commands: contourToPathCommands(contourCommands(verticesToSegments(polygonVertices(rect, circumradiusFromRect(rect, params), params)), params.cornerRadius), round),
+			fill: style.fill ?? "transparent",
+			fillOpacity: style.fillOpacity,
+			stroke: style.stroke ?? "currentColor",
+			strokeOpacity: style.strokeOpacity,
+			strokeWidth: style.strokeWidth ?? 1,
+			dashPattern: style.dashPattern,
+			opacity: style.opacity
+		};
+	},
+	scaleParams: (params, sx, sy) => params.cornerRadius === void 0 ? params : {
+		...params,
+		cornerRadius: params.cornerRadius * Math.sqrt(sx * sy)
+	}
+});
+//#endregion
+export { polygon };

package/dist/es/shapes/rectangle.d.ts

@@ -1,8 +1,10 @@
-import { ShapeDefinition } from './types';
 /**
- * rectangle 注册项
- * @description circumscribe = identity（视觉边界 = 内框）；boundaryPoint / anchor 直接走 rect 数学层；
- *   emit 出 RectPrim（圆角走 cornerRadius），与旧 `emitRectShape` 逐字段等价
+ * rectangle 注册项（文本容器形状，尺寸由内框 + minimumSize 驱动）
+ * @description circumscribe = identity（视觉边界 = 内框）；anchor / edgePoint 直接走 rect 数学层；
+ *   boundaryPoint 把矩形 4 角构造成 4 条折线段、委托 rounded-contour 模块（cornerRadius 省略 / 0 出原尖角
+ *   求交、>0 在每个角插逐角夹紧的 fillet 弧，连接感知倒角），rayOrigin = 矩形中心（= node position）。
+ *   emit 仍出 RectPrim，圆角半径优先取 `params.cornerRadius`、回退到 `style.cornerRadius`（顶层迁移期兼容）。
+ *   scaleParams：cornerRadius 是长度，随 node scale 用 uniform 几何均值因子协同缩放（边数 / 角度类参数才不缩）。
  */
-export declare const rectangle: ShapeDefinition;
+export declare const rectangle: import('./types').ShapeDefinition;
 //# sourceMappingURL=rectangle.d.ts.map

package/dist/es/shapes/rectangle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rectangle.d.ts","sourceRoot":"","sources":["../../../src/shapes/rectangle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,eA2BvB,CAAC"}
+{"version":3,"file":"rectangle.d.ts","sourceRoot":"","sources":["../../../src/shapes/rectangle.ts"],"names":[],"mappings":"AAgCA;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,mCAiDpB,CAAC"}

package/dist/es/shapes/rectangle.js

@@ -1,25 +1,50 @@
+import { localToWorld } from "../geometry/_transform.js";
 import { rect } from "../geometry/rect.js";
+import { defineShape } from "./define.js";
 import { asRectAnchor } from "./_shared.js";
+import { boundaryFromContour } from "../geometry/roundedContour.js";
+import { verticesToSegments } from "./_contour.js";
+import { z } from "zod";
 //#region src/shapes/rectangle.ts
+/** 轴对齐 / 旋转矩形的 4 个角（CW 绕向：左上 → 右上 → 右下 → 左下），局部系经 localToWorld 投世界 */
+var rectVertices = (rect) => {
+	const halfW = rect.width / 2;
+	const halfH = rect.height / 2;
+	return [
+		localToWorld(rect, [-halfW, -halfH]),
+		localToWorld(rect, [halfW, -halfH]),
+		localToWorld(rect, [halfW, halfH]),
+		localToWorld(rect, [-halfW, halfH])
+	];
+};
 /**
-* rectangle 注册项
-* @description circumscribe = identity（视觉边界 = 内框）；boundaryPoint / anchor 直接走 rect 数学层；
-*   emit 出 RectPrim（圆角走 cornerRadius），与旧 `emitRectShape` 逐字段等价
+* rectangle 注册项（文本容器形状，尺寸由内框 + minimumSize 驱动）
+* @description circumscribe = identity（视觉边界 = 内框）；anchor / edgePoint 直接走 rect 数学层；
+*   boundaryPoint 把矩形 4 角构造成 4 条折线段、委托 rounded-contour 模块（cornerRadius 省略 / 0 出原尖角
+*   求交、>0 在每个角插逐角夹紧的 fillet 弧，连接感知倒角），rayOrigin = 矩形中心（= node position）。
+*   emit 仍出 RectPrim，圆角半径优先取 `params.cornerRadius`、回退到 `style.cornerRadius`（顶层迁移期兼容）。
+*   scaleParams：cornerRadius 是长度，随 node scale 用 uniform 几何均值因子协同缩放（边数 / 角度类参数才不缩）。
 */
-var rectangle = {
+var rectangle = defineShape({
+	paramsSchema: z.strictObject({ cornerRadius: z.number().finite().nonnegative().optional().describe("Corner radius in user units; 0 / omitted = sharp corners. Clamped per corner to the largest non-self-intersecting fillet.") }),
 	circumscribe: (hw, hh) => ({
 		halfWidth: hw,
 		halfHeight: hh
 	}),
-	boundaryPoint: (r, toward) => rect.boundaryPoint(r, toward),
+	boundaryPoint: (rect, toward, params) => {
+		const segments = verticesToSegments(rectVertices(rect));
+		const center = [rect.x, rect.y];
+		return boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
+	},
 	anchor: (r, name) => {
 		const a = asRectAnchor(name);
 		return a ? rect.anchor(r, a) : void 0;
 	},
 	edgePoint: (r, side, t) => rect.edgePoint(r, side, t),
-	*emit(r, style, round) {
+	*emit(r, style, round, params) {
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
+		const cornerRadius = params.cornerRadius ?? style.cornerRadius;
 		yield {
 			type: "rect",
 			x: round(r.x - halfW),
@@ -32,10 +57,14 @@ var rectangle = {
 			strokeOpacity: style.strokeOpacity,
 			strokeWidth: style.strokeWidth ?? 1,
 			dashPattern: style.dashPattern,
-			cornerRadius: style.roundedCorners,
+			cornerRadius: cornerRadius !== void 0 ? round(cornerRadius) : void 0,
 			opacity: style.opacity
 		};
+	},
+	scaleParams: (params, sx, sy) => params.cornerRadius === void 0 ? params : {
+		...params,
+		cornerRadius: params.cornerRadius * Math.sqrt(sx * sy)
 	}
-};
+});
 //#endregion
 export { rectangle };

package/dist/es/shapes/sector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * sector 注册项：环楔（内外半径 + 起止角围成的可填充 2D 区域）
+ * @description 四何函数共用 `sectorGeometry`（单一真源）：circumscribe 返回含圆心 + 内外弧的精确 AABB 半轴
+ *   （含弧跨过 90°·k 轴向的 outerRadius 极值点），node position = AABB 中心；anchor 含 apex（圆心）/ centroid /
+ *   inner-arc-mid / outer-arc-mid / start-edge-mid / end-edge-mid + 角度边界点；emit 出外弧 + 两径向边 + 内弧
+ *   闭合 path（innerRadius=0 时径向边交于圆心、无内弧）。scaleParams 只缩半径、不缩角度。
+ */
+export declare const sector: import('./types').ShapeDefinition;
+//# sourceMappingURL=sector.d.ts.map

package/dist/es/shapes/sector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sector.d.ts","sourceRoot":"","sources":["../../../src/shapes/sector.ts"],"names":[],"mappings":"AA0EA;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,mCAgGjB,CAAC"}

package/dist/es/shapes/sector.js

@@ -0,0 +1,143 @@
+import { localToWorld } from "../geometry/_transform.js";
+import { defineShape } from "./define.js";
+import { sectorGeometry, sectorPolarPoint } from "./_shared.js";
+import { boundaryFromContour, contourCommands } from "../geometry/roundedContour.js";
+import { contourToPathCommands } from "./_contour.js";
+import { z } from "zod";
+//#region src/shapes/sector.ts
+/** sector 局部 AABB 系点（圆心为原点偏移后）→ 世界系（含 rect 旋转 / 平移） */
+var toWorld = (rect, geo, localFromApex) => {
+	return localToWorld(rect, [localFromApex[0] + geo.apexOffset[0], localFromApex[1] + geo.apexOffset[1]]);
+};
+/**
+* 构造 sector 闭合轮廓的有序段序列（line + arc），段序与现状 emit 完全一致
+* @description 环楔（innerRadius>0）4 段闭环：radial Line(inner-start→outer-start) → outer Arc(start→end, CW)
+*   → radial Line(outer-end→inner-end) → inner Arc(end→start, CCW)。pie（innerRadius=0）3 段闭环：
+*   radial Line(apex→outer-start) → outer Arc(start→end, CW) → radial Line(outer-end→apex)，apex 处为 line-line 接缝。
+*   Arc 圆心 = apex 世界坐标、半径 = inner/outer radius、起止角与现状 emit 同（度，CW 即 counterClockwise=false）。
+*   emit / boundaryPoint 共用此真源；emit 收轴对齐 rect、boundaryPoint 收带 rotate 的 rect，rect 不同自然投不同世界系。
+*/
+var sectorSegments = (rect, geo, params) => {
+	const { innerRadius, outerRadius } = params;
+	const { start, end } = geo.range;
+	const apex = toWorld(rect, geo, [0, 0]);
+	const rotateDeg = (rect.rotate ?? 0) * 180 / Math.PI;
+	const sa = start + rotateDeg;
+	const ea = end + rotateDeg;
+	const outerStart = toWorld(rect, geo, sectorPolarPoint(outerRadius, start));
+	if (innerRadius > 0) {
+		const innerStart = toWorld(rect, geo, sectorPolarPoint(innerRadius, start));
+		const innerEnd = toWorld(rect, geo, sectorPolarPoint(innerRadius, end));
+		return [
+			{
+				kind: "line",
+				from: innerStart,
+				to: outerStart
+			},
+			{
+				kind: "arc",
+				center: apex,
+				radius: outerRadius,
+				startAngle: sa,
+				endAngle: ea
+			},
+			{
+				kind: "line",
+				from: toWorld(rect, geo, sectorPolarPoint(outerRadius, end)),
+				to: innerEnd
+			},
+			{
+				kind: "arc",
+				center: apex,
+				radius: innerRadius,
+				startAngle: ea,
+				endAngle: sa,
+				counterClockwise: true
+			}
+		];
+	}
+	return [
+		{
+			kind: "line",
+			from: apex,
+			to: outerStart
+		},
+		{
+			kind: "arc",
+			center: apex,
+			radius: outerRadius,
+			startAngle: sa,
+			endAngle: ea
+		},
+		{
+			kind: "line",
+			from: toWorld(rect, geo, sectorPolarPoint(outerRadius, end)),
+			to: apex
+		}
+	];
+};
+/**
+* sector 注册项：环楔（内外半径 + 起止角围成的可填充 2D 区域）
+* @description 四何函数共用 `sectorGeometry`（单一真源）：circumscribe 返回含圆心 + 内外弧的精确 AABB 半轴
+*   （含弧跨过 90°·k 轴向的 outerRadius 极值点），node position = AABB 中心；anchor 含 apex（圆心）/ centroid /
+*   inner-arc-mid / outer-arc-mid / start-edge-mid / end-edge-mid + 角度边界点；emit 出外弧 + 两径向边 + 内弧
+*   闭合 path（innerRadius=0 时径向边交于圆心、无内弧）。scaleParams 只缩半径、不缩角度。
+*/
+var sector = defineShape({
+	paramsSchema: z.strictObject({
+		innerRadius: z.number().finite().nonnegative().describe("Inner radius (user units); 0 = solid pie slice."),
+		outerRadius: z.number().finite().positive().describe("Outer radius (user units); must be > innerRadius."),
+		startAngle: z.number().finite().describe("Start angle in degrees; polar convention 0°=+x, 90°=+y (screen y-down), matching core polar."),
+		endAngle: z.number().finite().describe("End angle in degrees; swept counterclockwise in screen space from startAngle."),
+		cornerRadius: z.number().finite().nonnegative().optional().describe("Corner radius in user units; 0 / omitted = sharp corners. Clamped per corner to the largest non-self-intersecting fillet.")
+	}).refine((p) => p.outerRadius > p.innerRadius, { message: "outerRadius must be greater than innerRadius" }),
+	circumscribe: (_hw, _hh, params) => sectorGeometry(params).aabbHalfAxes,
+	circumscribeOffset: (params) => {
+		const { apexOffset } = sectorGeometry(params);
+		return [-apexOffset[0], -apexOffset[1]];
+	},
+	boundaryPoint: (rect, toward, params) => {
+		const geo = sectorGeometry(params);
+		const centroidWorld = localToWorld(rect, geo.centroidOffset);
+		return boundaryFromContour(sectorSegments(rect, geo, params), params.cornerRadius, centroidWorld, toward) ?? centroidWorld;
+	},
+	anchor: (rect, name, params) => {
+		const geo = sectorGeometry(params);
+		const { innerRadius, outerRadius } = params;
+		const { start, end, mid } = geo.range;
+		switch (name) {
+			case "apex":
+			case "center": return toWorld(rect, geo, [0, 0]);
+			case "centroid": return localToWorld(rect, geo.centroidOffset);
+			case "outer-arc-mid": return toWorld(rect, geo, sectorPolarPoint(outerRadius, mid));
+			case "inner-arc-mid": return toWorld(rect, geo, sectorPolarPoint(innerRadius, mid));
+			case "start-edge-mid": return toWorld(rect, geo, sectorPolarPoint((innerRadius + outerRadius) / 2, start));
+			case "end-edge-mid": return toWorld(rect, geo, sectorPolarPoint((innerRadius + outerRadius) / 2, end));
+			default: return;
+		}
+	},
+	*emit(rect, style, round, params) {
+		yield {
+			type: "path",
+			commands: contourToPathCommands(contourCommands(sectorSegments(rect, sectorGeometry(params), params), params.cornerRadius), round),
+			fill: style.fill ?? "transparent",
+			fillOpacity: style.fillOpacity,
+			stroke: style.stroke ?? "currentColor",
+			strokeOpacity: style.strokeOpacity,
+			strokeWidth: style.strokeWidth ?? 1,
+			dashPattern: style.dashPattern,
+			opacity: style.opacity
+		};
+	},
+	scaleParams: (params, sx, sy) => {
+		const factor = Math.sqrt(sx * sy);
+		return {
+			...params,
+			innerRadius: params.innerRadius * factor,
+			outerRadius: params.outerRadius * factor,
+			...params.cornerRadius === void 0 ? {} : { cornerRadius: params.cornerRadius * factor }
+		};
+	}
+});
+//#endregion
+export { sector };

package/dist/es/shapes/star.d.ts

@@ -0,0 +1,15 @@
+/**
+ * star 注册项：星形（外径尖角 / 内径凹角交替的 2×points 顶点闭合多边形）
+ * @description params-半径驱动的纯几何形状（像 sector，尺寸由 outerRadius 定、忽略文本内框）：四何函数共用
+ *   `starGeometry`（单一真源）。circumscribe 返回含全部尖角的精确 AABB 半轴（随 rotate 变，不随 cornerRadius 变）；
+ *   星形关于中心对称 → AABB 中心 = 星形中心 = node position，无需 circumscribeOffset。emit / boundaryPoint 把
+ *   `2×points` 顶点环构造成折线段，委托 rounded-contour 模块：cornerRadius 省略 / 0 出原尖角轮廓、>0 在每个顶点
+ *   插逐角夹紧的 fillet 弧——凸尖与凹角（notch）由模块按接缝转向叉积统一处理（凹角弧 sweep 反向、圆心在凸侧），
+ *   emit 与 boundaryPoint 共用同一份 fillet 结果。emit 收轴对齐 rect（旋转由外层 group 施加）、boundaryPoint
+ *   收带 rotate 的 rect 且 rayOrigin = 星形几何中心（关于中心对称，AABB 中心 = 形心 = node position）。
+ *   anchor 含 center / tip-N（第 N 尖角）/ notch-N（第 N 凹角）——恒在原尖角 / 凹角逻辑顶点，不随 cornerRadius 移；
+ *   self-rotate（params.rotate）与 Node.rotate 叠加。scaleParams 只缩 inner/outerRadius / cornerRadius（长度）、
+ *   不缩 points（计数）/ rotate（角度）。
+ */
+export declare const star: import('./types').ShapeDefinition;
+//# sourceMappingURL=star.d.ts.map

package/dist/es/shapes/star.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"star.d.ts","sourceRoot":"","sources":["../../../src/shapes/star.ts"],"names":[],"mappings":"AAsFA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,mCA2Ff,CAAC"}