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

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

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/primitive/rect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,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,iEAAiE;IACjE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/primitive/rect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,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,iEAAiE;IACjE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

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

@@ -5,6 +5,7 @@ import { RectPrim } from './rect';
 import { TextPrim } from './text';
 import { Layout } from './layout';
 import { SceneResource } from './paint';
+import { IRAnimationTrack } from '../ir/animation';
 export type { PaintValue, SceneResource, PaintResource, ResolvedPatternTile } from './paint';
 export type { ClipShape, ClipResource } from './clip';
 /**
@@ -20,5 +21,7 @@ export type Scene = {
     layout: Layout;
     /** 渲染无关资源表（paint server 等）；adapter 物化（SVG → `<defs>`）。无资源时省略 */
     resources?: Array<SceneResource>;
+    /** scene 根（镜头）时间轴动画 tracks（viewBox property）：compile 从 IR 根 animations 原样透传；renderer 能播则播、不能则用静态 layout 并 warn。无则省略 */
+    animations?: Array<IRAnimationTrack>;
 };
 //# sourceMappingURL=scene.d.ts.map

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

@@ -1 +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,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7F,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,qCAAqC;AACrC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;CAClC,CAAC"}
+{"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,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7F,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,qCAAqC;AACrC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,uHAAuH;IACvH,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CACtC,CAAC"}

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

@@ -1,3 +1,5 @@
+import { IRAnimationTrack } from '../ir/animation';
+import { IRJsonObject } from '../ir/json';
 /** 行级字段（每行可独立指定），未填走块级 TextPrim 默认 */
 export type TextLine = {
     /** 行文字内容 */
@@ -23,6 +25,10 @@ export type TextPrim = {
     type: 'text';
     /** 稳定挂点 id：compile 从 IR 元素 user id stamp，供 renderer emit data-retikz-id / canvas hit-test */
     id?: string;
+    /** provenance 元数据：compile 从 IR 元素（node / path / scope）的 `meta` 原样 stamp，renderer 忽略（不进 DOM），交互层 / 工具链从 Scene 读 */
+    meta?: IRJsonObject;
+    /** 时间轴动画 tracks：compile 从 IR 元素的 animations 原样 stamp；renderer 能播则播、不能则渲染 settled 静态态并 warn（不丢图） */
+    animations?: Array<IRAnimationTrack>;
     /** 锚点横坐标（具体含义由 align 决定） */
     x: number;
     /** 锚点纵坐标（具体含义由 baseline 决定） */

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

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,0CAA0C;IAC1C,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,0CAA0C;IAC1C,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

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

@@ -0,0 +1,19 @@
+import { Position } from '../geometry/point';
+import { ContourCommand, LineSegment } from '../geometry/roundedContour';
+import { PathCommand } from '../primitive';
+/**
+ * 由顶点环构造闭合折线段序列（接缝顺序同顶点顺序）
+ * @description 第 i 段 from = 顶点 i、to = 顶点 (i+1)%n；供 polygon / star 的 emit / boundaryPoint
+ *   委托 rounded-contour 模块。绕向与各形状现状 emit 顶点顺序一致（rounded-contour 据接缝转向叉积判内外侧、
+ *   凸 / 凹角统一处理），polygon 全凸、star 凸尖 / 凹角交替都用这同一条构造。
+ */
+export declare const verticesToSegments: (verts: Array<Position>) => Array<LineSegment>;
+/**
+ * contour 命令 → path PathCommand（每点过 round）
+ * @description passthrough（r 省略 / 0）时每段都 emit 一条回到起点的 line、末尾接 close；而顶点形状现状 emit
+ *   是 `move + (n−1) line + close`（无回起点的冗余 line）——故此处剔除「紧贴 close 前、落点 == 初始 move 落点」
+ *   的那条 line，保证 r=0 与现状逐字等价。fillet（r>0）时末尾 fillet 弧已自然收尾，无该冗余。
+ *   polygon / star 共用此映射器（单一实现）。
+ */
+export declare const contourToPathCommands: (commands: Array<ContourCommand>, round: (n: number) => number) => Array<PathCommand>;
+//# sourceMappingURL=_contour.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_contour.d.ts","sourceRoot":"","sources":["../../../src/shapes/_contour.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAG,KAAK,CAAC,WAAW,CACQ,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,KAAK,CAAC,cAAc,CAAC,EAC/B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,KAAK,CAAC,WAAW,CAqCnB,CAAC"}

package/dist/es/shapes/_contour.js

@@ -0,0 +1,60 @@
+//#region src/shapes/_contour.ts
+/**
+* 由顶点环构造闭合折线段序列（接缝顺序同顶点顺序）
+* @description 第 i 段 from = 顶点 i、to = 顶点 (i+1)%n；供 polygon / star 的 emit / boundaryPoint
+*   委托 rounded-contour 模块。绕向与各形状现状 emit 顶点顺序一致（rounded-contour 据接缝转向叉积判内外侧、
+*   凸 / 凹角统一处理），polygon 全凸、star 凸尖 / 凹角交替都用这同一条构造。
+*/
+var verticesToSegments = (verts) => verts.map((from, i) => ({
+	kind: "line",
+	from,
+	to: verts[(i + 1) % verts.length]
+}));
+/**
+* contour 命令 → path PathCommand（每点过 round）
+* @description passthrough（r 省略 / 0）时每段都 emit 一条回到起点的 line、末尾接 close；而顶点形状现状 emit
+*   是 `move + (n−1) line + close`（无回起点的冗余 line）——故此处剔除「紧贴 close 前、落点 == 初始 move 落点」
+*   的那条 line，保证 r=0 与现状逐字等价。fillet（r>0）时末尾 fillet 弧已自然收尾，无该冗余。
+*   polygon / star 共用此映射器（单一实现）。
+*/
+var contourToPathCommands = (commands, round) => {
+	const rp = (p) => [round(p[0]), round(p[1])];
+	const out = [];
+	let moveTo;
+	commands.forEach((cmd, i) => {
+		switch (cmd.kind) {
+			case "move":
+				moveTo = rp(cmd.to);
+				out.push({
+					kind: "move",
+					to: moveTo
+				});
+				break;
+			case "line": {
+				const to = rp(cmd.to);
+				if (i + 1 < commands.length && commands[i + 1].kind === "close" && moveTo && to[0] === moveTo[0] && to[1] === moveTo[1]) break;
+				out.push({
+					kind: "line",
+					to
+				});
+				break;
+			}
+			case "arc":
+				out.push({
+					kind: "arc",
+					center: rp(cmd.center),
+					radius: round(cmd.radius),
+					startAngle: cmd.startAngle,
+					endAngle: cmd.endAngle,
+					counterClockwise: cmd.counterClockwise
+				});
+				break;
+			case "close":
+				out.push({ kind: "close" });
+				break;
+		}
+	});
+	return out;
+};
+//#endregion
+export { contourToPathCommands, verticesToSegments };

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

@@ -1,7 +1,61 @@
+import { Position } from '../geometry/point';
 import { RectAnchor } from '../geometry/rect';
 /**
  * 把任意字符串收窄为合法 RectAnchor，否则 undefined
  * @description 内置 4 shape 的 anchor 只认这 9 名；不在集合内返回 undefined，由 `anchorOf` 抛 Unknown anchor
  */
 export declare const asRectAnchor: (name: string) => RectAnchor | undefined;
+/** sector / arc 共用的角度约定起止角 */
+type AngularRange = {
+    /** 规范化后的起始角（度）= 原 startAngle */
+    start: number;
+    /** 规范化后的终止角（度）≥ start（end<start 时已加 360°） */
+    end: number;
+    /** 起止角中分角（度），= (start + end) / 2 */
+    mid: number;
+};
+/**
+ * 规范化起止角：保证 end ≥ start（end<start 时加 360° 直至 ≥ start），并给出中分角
+ * @description 角度沿屏幕系（角度递增=CW）从 start 扫到 end；end<start 视为跨过 360°，与 polar / geometry/arc 约定一致。
+ *   end<start 时一次性加上 360°·k（k 为使 end ≥ start 的最小非负整数），O(1) 闭式计算——
+ *   避免 while 循环在巨型角度（如 1e308 浮点 end+360===end 卡死、1e9 退化成数百万次迭代）下挂死。
+ *   end 已 ≥ start 时 ceil((start−end)/360) ≤ 0，k 取 0、end 不变（语义与原逐次加法等价）。
+ */
+export declare const normalizeAngularRange: (startAngle: number, endAngle: number) => AngularRange;
+/**
+ * sector 的派生几何（circumscribe / boundaryPoint / anchor / emit 单一真源）
+ * @description 据 params（内外半径 + 起止角）在「圆心(apex)为原点」局部系算精确 AABB 与各特征点偏移。
+ *   AABB 覆盖 圆心 ∪ 外弧 ∪ 内弧（含弧跨过的 90°·k 轴向 outerRadius 极值点），其半轴即 circumscribe 输出；
+ *   apex / centroid 等特征点以「相对 AABB 中心的偏移」给出，便于上层用 rect.center + offset 落到世界系。
+ */
+export type SectorGeometry = {
+    /** 规范化起止角与中分角 */
+    range: AngularRange;
+    /** 含圆心 + 内外弧的精确 AABB 半轴（circumscribe 输出） */
+    aabbHalfAxes: {
+        halfWidth: number;
+        halfHeight: number;
+    };
+    /** 圆心(apex)相对 AABB 中心的偏移（apex 常在 AABB 内角，非 AABB 中心） */
+    apexOffset: Position;
+    /** 质心(centroid)相对 AABB 中心的偏移（落在环楔内，作 boundaryPoint 向外射线起点） */
+    centroidOffset: Position;
+};
+/** sector params 的最小结构（与 sector.ts 的 SectorParams 同形，避免循环 import 类型） */
+type SectorGeometryInput = {
+    innerRadius: number;
+    outerRadius: number;
+    startAngle: number;
+    endAngle: number;
+};
+/**
+ * 计算 sector 单一真源几何
+ * @description 局部系以圆心为原点：候选极值点 = 圆心(0,0) ∪ 外弧 bbox 点 ∪ 内弧 bbox 点
+ *   （arcBoundingPoints 已含起止端点与区间内 90°·k 轴向点）。由这些点的 min/max 得 AABB，
+ *   AABB 中心相对圆心的偏移即 −apexOffset。质心用环楔解析公式（极坐标积分）。
+ */
+export declare const sectorGeometry: (params: SectorGeometryInput) => SectorGeometry;
+/** sector 局部系点（圆心为原点）：极角(度) + 半径 → 直角坐标 */
+export declare const sectorPolarPoint: (radius: number, angleDeg: number) => Position;
+export {};
 //# sourceMappingURL=_shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/shapes/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKjE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,UAAU,GAAG,SACK,CAAC"}
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/shapes/_shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKjE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,UAAU,GAAG,SACK,CAAC;AAI/D,8BAA8B;AAC9B,KAAK,YAAY,GAAG;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,MAAM,EAAE,UAAU,MAAM,KAAG,YAI5E,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,iBAAiB;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,4CAA4C;IAC5C,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,uDAAuD;IACvD,UAAU,EAAE,QAAQ,CAAC;IACrB,8DAA8D;IAC9D,cAAc,EAAE,QAAQ,CAAC;CAC1B,CAAC;AAEF,wEAAwE;AACxE,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,mBAAmB,KAAG,cA0D5D,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,QAC7B,CAAC"}

package/dist/es/shapes/_shared.js

@@ -1,4 +1,5 @@
 import { RECT_ANCHORS } from "../geometry/rect.js";
+import { arcBoundingPoints, arcEndPoint } from "../geometry/arc.js";
 //#region src/shapes/_shared.ts
 /** RECT_ANCHORS 的 9 个合法 anchor 名集合（成员校验用） */
 var RECT_ANCHOR_SET = new Set(Object.values(RECT_ANCHORS));
@@ -7,5 +8,71 @@ var RECT_ANCHOR_SET = new Set(Object.values(RECT_ANCHORS));
 * @description 内置 4 shape 的 anchor 只认这 9 名；不在集合内返回 undefined，由 `anchorOf` 抛 Unknown anchor
 */
 var asRectAnchor = (name) => RECT_ANCHOR_SET.has(name) ? name : void 0;
+var DEG_TO_RAD = Math.PI / 180;
+/**
+* 规范化起止角：保证 end ≥ start（end<start 时加 360° 直至 ≥ start），并给出中分角
+* @description 角度沿屏幕系（角度递增=CW）从 start 扫到 end；end<start 视为跨过 360°，与 polar / geometry/arc 约定一致。
+*   end<start 时一次性加上 360°·k（k 为使 end ≥ start 的最小非负整数），O(1) 闭式计算——
+*   避免 while 循环在巨型角度（如 1e308 浮点 end+360===end 卡死、1e9 退化成数百万次迭代）下挂死。
+*   end 已 ≥ start 时 ceil((start−end)/360) ≤ 0，k 取 0、end 不变（语义与原逐次加法等价）。
+*/
+var normalizeAngularRange = (startAngle, endAngle) => {
+	const end = endAngle + 360 * Math.max(0, Math.ceil((startAngle - endAngle) / 360));
+	return {
+		start: startAngle,
+		end,
+		mid: (startAngle + end) / 2
+	};
+};
+/**
+* 计算 sector 单一真源几何
+* @description 局部系以圆心为原点：候选极值点 = 圆心(0,0) ∪ 外弧 bbox 点 ∪ 内弧 bbox 点
+*   （arcBoundingPoints 已含起止端点与区间内 90°·k 轴向点）。由这些点的 min/max 得 AABB，
+*   AABB 中心相对圆心的偏移即 −apexOffset。质心用环楔解析公式（极坐标积分）。
+*/
+var sectorGeometry = (params) => {
+	const { innerRadius, outerRadius } = params;
+	const range = normalizeAngularRange(params.startAngle, params.endAngle);
+	const apex = [0, 0];
+	const candidates = [apex];
+	candidates.push(...arcBoundingPoints(apex, outerRadius, range.start, range.end));
+	if (innerRadius > 0) candidates.push(...arcBoundingPoints(apex, innerRadius, range.start, range.end));
+	let minX = Infinity;
+	let maxX = -Infinity;
+	let minY = Infinity;
+	let maxY = -Infinity;
+	for (const [px, py] of candidates) {
+		if (px < minX) minX = px;
+		if (px > maxX) maxX = px;
+		if (py < minY) minY = py;
+		if (py > maxY) maxY = py;
+	}
+	const halfWidth = (maxX - minX) / 2;
+	const halfHeight = (maxY - minY) / 2;
+	const aabbCenter = [(minX + maxX) / 2, (minY + maxY) / 2];
+	const apexOffset = [-aabbCenter[0], -aabbCenter[1]];
+	const sweepRad = (range.end - range.start) * DEG_TO_RAD;
+	const midRad = range.mid * DEG_TO_RAD;
+	const R = outerRadius;
+	const r = innerRadius;
+	const half = sweepRad / 2;
+	const areaDenom = R * R - r * r;
+	let centroidRadius;
+	if (Math.abs(half) < 1e-9 || Math.abs(areaDenom) < 1e-12) centroidRadius = (R + r) / 2;
+	else centroidRadius = 2 / 3 * (Math.sin(half) / half) * ((R * R * R - r * r * r) / areaDenom);
+	const centroidLocal = [Math.cos(midRad) * centroidRadius, Math.sin(midRad) * centroidRadius];
+	const centroidOffset = [centroidLocal[0] - aabbCenter[0], centroidLocal[1] - aabbCenter[1]];
+	return {
+		range,
+		aabbHalfAxes: {
+			halfWidth,
+			halfHeight
+		},
+		apexOffset,
+		centroidOffset
+	};
+};
+/** sector 局部系点（圆心为原点）：极角(度) + 半径 → 直角坐标 */
+var sectorPolarPoint = (radius, angleDeg) => arcEndPoint([0, 0], radius, angleDeg);
 //#endregion
-export { asRectAnchor };
+export { asRectAnchor, normalizeAngularRange, sectorGeometry, sectorPolarPoint };

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

@@ -0,0 +1,8 @@
+/**
+ * arc 注册项：单半径曲线（描边、可选闭合为弓形）
+ * @description circumscribe 返回弧 bbox 半轴（含弧跨过的 90°·k 轴向极值点），node position = AABB 中心；
+ *   emit 出弧 path（close=false 开放描边、无 close 命令；close=true 弦闭合成弓形可填充）；anchor 提供
+ *   arc-mid（弧中点）/ start / end / center（圆心）。scaleParams 只缩 radius、不缩角度与 close。
+ */
+export declare const arc: import('./types').ShapeDefinition;
+//# sourceMappingURL=arc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../src/shapes/arc.ts"],"names":[],"mappings":"AA8DA;;;;;GAKG;AACH,eAAO,MAAM,GAAG,mCA8Ed,CAAC"}

package/dist/es/shapes/arc.js

@@ -0,0 +1,104 @@
+import { localToWorld } from "../geometry/_transform.js";
+import { arcBoundingPoints, arcEndPoint } from "../geometry/arc.js";
+import { defineShape } from "./define.js";
+import { normalizeAngularRange } from "./_shared.js";
+import { z } from "zod";
+//#region src/shapes/arc.ts
+/** arc 的派生几何：圆心局部系 AABB + 圆心相对 AABB 中心偏移 */
+var arcGeometry = (params) => {
+	const { radius } = params;
+	const range = normalizeAngularRange(params.startAngle, params.endAngle);
+	const points = arcBoundingPoints([0, 0], radius, range.start, range.end);
+	let minX = Infinity;
+	let maxX = -Infinity;
+	let minY = Infinity;
+	let maxY = -Infinity;
+	for (const [px, py] of points) {
+		if (px < minX) minX = px;
+		if (px > maxX) maxX = px;
+		if (py < minY) minY = py;
+		if (py > maxY) maxY = py;
+	}
+	const aabbCenter = [(minX + maxX) / 2, (minY + maxY) / 2];
+	return {
+		range,
+		aabbHalfAxes: {
+			halfWidth: (maxX - minX) / 2,
+			halfHeight: (maxY - minY) / 2
+		},
+		centerOffset: [-aabbCenter[0], -aabbCenter[1]]
+	};
+};
+/** 圆心局部点（相对圆心）→ 世界系（+centerOffset 到相对 AABB 中心后经 rect 投影） */
+var arcLocalToWorld = (rect, centerOffset, localFromCenter) => localToWorld(rect, [localFromCenter[0] + centerOffset[0], localFromCenter[1] + centerOffset[1]]);
+/**
+* arc 注册项：单半径曲线（描边、可选闭合为弓形）
+* @description circumscribe 返回弧 bbox 半轴（含弧跨过的 90°·k 轴向极值点），node position = AABB 中心；
+*   emit 出弧 path（close=false 开放描边、无 close 命令；close=true 弦闭合成弓形可填充）；anchor 提供
+*   arc-mid（弧中点）/ start / end / center（圆心）。scaleParams 只缩 radius、不缩角度与 close。
+*/
+var arc = defineShape({
+	paramsSchema: z.strictObject({
+		radius: z.number().finite().positive().describe("Arc radius in user units."),
+		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 from startAngle in screen space."),
+		close: z.boolean().optional().describe("When true, close the arc into a chord/segment outline (fillable); default false = open stroked arc.")
+	}),
+	circumscribe: (_hw, _hh, params) => arcGeometry(params).aabbHalfAxes,
+	circumscribeOffset: (params) => {
+		const { centerOffset } = arcGeometry(params);
+		return [-centerOffset[0], -centerOffset[1]];
+	},
+	boundaryPoint: (rect, _toward, params) => {
+		const geo = arcGeometry(params);
+		return arcLocalToWorld(rect, geo.centerOffset, arcEndPoint([0, 0], params.radius, geo.range.mid));
+	},
+	anchor: (rect, name, params) => {
+		const geo = arcGeometry(params);
+		const { radius } = params;
+		const { start, end, mid } = geo.range;
+		const at = (angle) => arcLocalToWorld(rect, geo.centerOffset, arcEndPoint([0, 0], radius, angle));
+		switch (name) {
+			case "center": return arcLocalToWorld(rect, geo.centerOffset, [0, 0]);
+			case "arc-mid": return at(mid);
+			case "start": return at(start);
+			case "end": return at(end);
+			default: return;
+		}
+	},
+	*emit(rect, style, round, params) {
+		const geo = arcGeometry(params);
+		const { radius, close } = params;
+		const { start, end } = geo.range;
+		const rp = (p) => [round(p[0]), round(p[1])];
+		const center = arcLocalToWorld(rect, geo.centerOffset, [0, 0]);
+		const commands = [{
+			kind: "move",
+			to: rp(arcLocalToWorld(rect, geo.centerOffset, arcEndPoint([0, 0], radius, start)))
+		}, {
+			kind: "arc",
+			center: rp(center),
+			radius: round(radius),
+			startAngle: start,
+			endAngle: end
+		}];
+		if (close) commands.push({ kind: "close" });
+		yield {
+			type: "path",
+			commands,
+			fill: close ? style.fill ?? "transparent" : "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,
+		radius: params.radius * Math.sqrt(sx * sy)
+	})
+});
+//#endregion
+export { arc };

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

@@ -0,0 +1,13 @@
+import { IRJsonObject } from '../ir/json';
+import { ShapeDefinition, ShapeDefinitionInput } from './types';
+/**
+ * 注册一个参数化 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({ ... })`）
+ */
+export declare const defineShape: <TParams extends IRJsonObject>(def: ShapeDefinitionInput<TParams>) => ShapeDefinition;
+//# sourceMappingURL=define.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../src/shapes/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,SAAS,YAAY,EACtD,KAAK,oBAAoB,CAAC,OAAO,CAAC,KACjC,eAAoD,CAAC"}

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"}