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

package/dist/lib/shapes/polygon.cjs

@@ -0,0 +1,104 @@
+const require__transform = require("../geometry/_transform.cjs");
+const require_rect = require("../geometry/rect.cjs");
+const require_define = require("./define.cjs");
+const require__shared = require("./_shared.cjs");
+const require_roundedContour = require("../geometry/roundedContour.cjs");
+const require__contour = require("./_contour.cjs");
+let zod = require("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 require__transform.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 = require_define.defineShape({
+	paramsSchema: zod.z.strictObject({
+		sides: zod.z.number().int().min(3).describe("Number of sides of the regular polygon (>= 3)."),
+		rotate: zod.z.number().finite().optional().describe("Shape self-rotation in degrees (vertex start direction); default 0. Composes with Node.rotate."),
+		cornerRadius: zod.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 = require__contour.verticesToSegments(polygonVertices(rect, circumradiusFromRect(rect, params), params));
+		const center = [rect.x, rect.y];
+		return require_roundedContour.boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
+	},
+	anchor: (rect$1, name, params) => {
+		const a = require__shared.asRectAnchor(name);
+		return a ? require_rect.rect.anchor(rect$1, a) : void 0;
+	},
+	*emit(rect, style, round, params) {
+		yield {
+			type: "path",
+			commands: require__contour.contourToPathCommands(require_roundedContour.contourCommands(require__contour.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
+exports.polygon = polygon;

package/dist/lib/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/lib/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/lib/shapes/rectangle.cjs

@@ -1,25 +1,50 @@
+const require__transform = require("../geometry/_transform.cjs");
 const require_rect = require("../geometry/rect.cjs");
+const require_define = require("./define.cjs");
 const require__shared = require("./_shared.cjs");
+const require_roundedContour = require("../geometry/roundedContour.cjs");
+const require__contour = require("./_contour.cjs");
+let zod = require("zod");
 //#region src/shapes/rectangle.ts
+/** 轴对齐 / 旋转矩形的 4 个角（CW 绕向：左上 → 右上 → 右下 → 左下），局部系经 localToWorld 投世界 */
+var rectVertices = (rect) => {
+	const halfW = rect.width / 2;
+	const halfH = rect.height / 2;
+	return [
+		require__transform.localToWorld(rect, [-halfW, -halfH]),
+		require__transform.localToWorld(rect, [halfW, -halfH]),
+		require__transform.localToWorld(rect, [halfW, halfH]),
+		require__transform.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 = require_define.defineShape({
+	paramsSchema: zod.z.strictObject({ cornerRadius: zod.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) => require_rect.rect.boundaryPoint(r, toward),
+	boundaryPoint: (rect, toward, params) => {
+		const segments = require__contour.verticesToSegments(rectVertices(rect));
+		const center = [rect.x, rect.y];
+		return require_roundedContour.boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
+	},
 	anchor: (r, name) => {
 		const a = require__shared.asRectAnchor(name);
 		return a ? require_rect.rect.anchor(r, a) : void 0;
 	},
 	edgePoint: (r, side, t) => require_rect.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
 exports.rectangle = rectangle;

package/dist/lib/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/lib/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/lib/shapes/sector.cjs

@@ -0,0 +1,143 @@
+const require__transform = require("../geometry/_transform.cjs");
+const require_define = require("./define.cjs");
+const require__shared = require("./_shared.cjs");
+const require_roundedContour = require("../geometry/roundedContour.cjs");
+const require__contour = require("./_contour.cjs");
+let zod = require("zod");
+//#region src/shapes/sector.ts
+/** sector 局部 AABB 系点（圆心为原点偏移后）→ 世界系（含 rect 旋转 / 平移） */
+var toWorld = (rect, geo, localFromApex) => {
+	return require__transform.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, require__shared.sectorPolarPoint(outerRadius, start));
+	if (innerRadius > 0) {
+		const innerStart = toWorld(rect, geo, require__shared.sectorPolarPoint(innerRadius, start));
+		const innerEnd = toWorld(rect, geo, require__shared.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, require__shared.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, require__shared.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 = require_define.defineShape({
+	paramsSchema: zod.z.strictObject({
+		innerRadius: zod.z.number().finite().nonnegative().describe("Inner radius (user units); 0 = solid pie slice."),
+		outerRadius: zod.z.number().finite().positive().describe("Outer radius (user units); must be > innerRadius."),
+		startAngle: zod.z.number().finite().describe("Start angle in degrees; polar convention 0°=+x, 90°=+y (screen y-down), matching core polar."),
+		endAngle: zod.z.number().finite().describe("End angle in degrees; swept counterclockwise in screen space from startAngle."),
+		cornerRadius: zod.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) => require__shared.sectorGeometry(params).aabbHalfAxes,
+	circumscribeOffset: (params) => {
+		const { apexOffset } = require__shared.sectorGeometry(params);
+		return [-apexOffset[0], -apexOffset[1]];
+	},
+	boundaryPoint: (rect, toward, params) => {
+		const geo = require__shared.sectorGeometry(params);
+		const centroidWorld = require__transform.localToWorld(rect, geo.centroidOffset);
+		return require_roundedContour.boundaryFromContour(sectorSegments(rect, geo, params), params.cornerRadius, centroidWorld, toward) ?? centroidWorld;
+	},
+	anchor: (rect, name, params) => {
+		const geo = require__shared.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 require__transform.localToWorld(rect, geo.centroidOffset);
+			case "outer-arc-mid": return toWorld(rect, geo, require__shared.sectorPolarPoint(outerRadius, mid));
+			case "inner-arc-mid": return toWorld(rect, geo, require__shared.sectorPolarPoint(innerRadius, mid));
+			case "start-edge-mid": return toWorld(rect, geo, require__shared.sectorPolarPoint((innerRadius + outerRadius) / 2, start));
+			case "end-edge-mid": return toWorld(rect, geo, require__shared.sectorPolarPoint((innerRadius + outerRadius) / 2, end));
+			default: return;
+		}
+	},
+	*emit(rect, style, round, params) {
+		yield {
+			type: "path",
+			commands: require__contour.contourToPathCommands(require_roundedContour.contourCommands(sectorSegments(rect, require__shared.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
+exports.sector = sector;

package/dist/lib/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/lib/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/lib/shapes/star.cjs

@@ -0,0 +1,113 @@
+const require__transform = require("../geometry/_transform.cjs");
+const require_define = require("./define.cjs");
+const require_roundedContour = require("../geometry/roundedContour.cjs");
+const require__contour = require("./_contour.cjs");
+let zod = require("zod");
+//#region src/shapes/star.ts
+var DEG_TO_RAD = Math.PI / 180;
+/**
+* 计算 star 单一真源几何
+* @description 局部系以中心为原点：顶点 k 角 = (rotate ?? 0) + k·(180/points) − 90，半径偶 outer / 奇 inner，
+*   point = [r·cosθ, r·sinθ]（0°=+x，90°=+y screen y-down）。−90 基准使默认第一尖角朝上（−y）。
+*   AABB 半轴 = 各顶点 |x| / |y| 的最大值（对称 → 中心即原点）。
+*/
+var starGeometry = (params) => {
+	const { points, innerRadius, outerRadius } = params;
+	const rotate = params.rotate ?? 0;
+	const step = 180 / points;
+	const vertices = [];
+	let maxAbsX = 0;
+	let maxAbsY = 0;
+	for (let k = 0; k < 2 * points; k++) {
+		const angle = (rotate + k * step - 90) * DEG_TO_RAD;
+		const radius = k % 2 === 0 ? outerRadius : innerRadius;
+		const x = radius * Math.cos(angle);
+		const y = radius * Math.sin(angle);
+		vertices.push([x, y]);
+		if (Math.abs(x) > maxAbsX) maxAbsX = Math.abs(x);
+		if (Math.abs(y) > maxAbsY) maxAbsY = Math.abs(y);
+	}
+	return {
+		vertices,
+		aabbHalfAxes: {
+			halfWidth: maxAbsX,
+			halfHeight: maxAbsY
+		}
+	};
+};
+/** 局部顶点（中心为原点）→ 世界系（经 rect 旋转 / 平移） */
+var toWorld = (rect, local) => require__transform.localToWorld(rect, local);
+/**
+* 世界系顶点环（局部 2×points 顶点逐个经 rect 投世界）
+* @description emit 收轴对齐 rect（rotate=0）、boundaryPoint 收带 rotate 的 rect，二者共用此构造；
+*   绕向 = starGeometry 顶点顺序（偶尖 / 奇凹交替），供 verticesToSegments → rounded-contour 模块倒角。
+*/
+var worldVertices = (rect, geo) => geo.vertices.map((v) => toWorld(rect, v));
+/**
+* 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（角度）。
+*/
+var star = require_define.defineShape({
+	paramsSchema: zod.z.strictObject({
+		points: zod.z.number().int().min(3).describe("Number of star points (>= 3)."),
+		innerRadius: zod.z.number().finite().positive().describe("Inner (notch) radius in user units."),
+		outerRadius: zod.z.number().finite().positive().describe("Outer (tip) radius in user units; must be > innerRadius."),
+		rotate: zod.z.number().finite().optional().describe("Shape self-rotation in degrees; default 0 = first tip points up (screen -y / top); positive rotates clockwise (screen). Composes with Node.rotate."),
+		cornerRadius: zod.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) => starGeometry(params).aabbHalfAxes,
+	boundaryPoint: (rect, toward, params) => {
+		const segments = require__contour.verticesToSegments(worldVertices(rect, starGeometry(params)));
+		const center = toWorld(rect, [0, 0]);
+		return require_roundedContour.boundaryFromContour(segments, params.cornerRadius, center, toward) ?? center;
+	},
+	anchor: (rect, name, params) => {
+		const geo = starGeometry(params);
+		if (name === "center") return toWorld(rect, [0, 0]);
+		const tip = /^tip-(\d+)$/.exec(name);
+		if (tip) {
+			const index = 2 * Number(tip[1]);
+			if (index >= geo.vertices.length) return void 0;
+			return toWorld(rect, geo.vertices[index]);
+		}
+		const notch = /^notch-(\d+)$/.exec(name);
+		if (notch) {
+			const index = 2 * Number(notch[1]) + 1;
+			if (index >= geo.vertices.length) return void 0;
+			return toWorld(rect, geo.vertices[index]);
+		}
+	},
+	*emit(rect, style, round, params) {
+		yield {
+			type: "path",
+			commands: require__contour.contourToPathCommands(require_roundedContour.contourCommands(require__contour.verticesToSegments(worldVertices(rect, starGeometry(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
+exports.star = star;

package/dist/lib/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/lib/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"}

package/dist/lib/shapes/types.d.ts

@@ -1,5 +1,7 @@
+import { z } from 'zod';
 import { Position } from '../geometry/point';
 import { Rect } from '../geometry/rect';
+import { IRJsonObject } from '../ir/json';
 import { PaintValue, ScenePrimitive } from '../primitive';
 /**
  * emit 需要的视觉样式子集
@@ -13,38 +15,69 @@ export type ShapeStyle = {
     strokeOpacity?: number;
     strokeWidth?: number;
     dashPattern?: Array<number>;
-    roundedCorners?: number;
+    cornerRadius?: number;
     opacity?: number;
 };
 /**
- * 一个 shape 的可注册定义：外接 / 边界 / anchor / emit 四件事
- * @description plain object（factory 友好：`createPolygonShape(6)` 这类普通函数返回它即可）；含函数、
- *   **不进 IR**，走 `CompileOptions.shapes` 运行时注入。内置 4 shape 也是注册项（无内置特权）。
+ * 一个 shape 的参数化可注册定义（定义点 typed 形态）
+ * @description plain object（factory 友好：`createPolygonShape(6)` 这类普通函数返回它即可）；含函数与
+ *   `paramsSchema`，**不进 IR**，走 `CompileOptions.shapes` 运行时注入。内置 4 shape 也是注册项（无内置特权）。
+ *   每个计算函数末位收 per-instance `params`（类型由 `paramsSchema.parse` 在编译期保证），无参形状用
+ *   `z.strictObject({})` 并忽略 `params`。
+ *
+ *   - `paramsSchema`：类型约束输出 JSON-safe（`z.ZodType<TParams>`）。这是类型层约束，不是运行时唯一保证——
+ *     compile 在 `paramsSchema.parse(params)` 之后还会对结果跑一次 `JsonObjectSchema.parse`，拦下宽松
+ *     schema 放过的非 JSON 输出（function / undefined 等）。
  *
  *   坐标语义两套，第三方最易写错：
  *   - `boundaryPoint` / `anchor` 收**带 `rotate` 的 Rect**——用 re-export 的 `worldToLocal` / `localToWorld` 写局部系几何。
  *   - `emit` 收**轴对齐 Rect（rotate=0）**——旋转由编译器在外层 `GroupPrim` 统一施加。
  */
-export type ShapeDefinition = {
+export type ShapeDefinitionInput<TParams extends IRJsonObject> = {
+    /** params 的 zod schema；类型约束输出 JSON-safe（运行时双 parse 才是真正护栏，见编译期桥接） */
+    paramsSchema: z.ZodType<TParams>;
     /**
-     * 外接：内容半轴（text + padding）→ 外接框半轴。
-     * @description rectangle: identity；circle: √(hw²+hh²) 两轴相等；ellipse: ×√2；diamond: ×2。
+     * 外接：内容半轴（text + padding）+ params → 外接框半轴。
+     * @description 必返回**包含完整 shape 的精确 AABB 半轴**（compile 的 viewBox / scope bbox 只累积该 AABB
+     *   四角）。rectangle: identity；circle: √(hw²+hh²) 两轴相等；ellipse: ×√2；diamond: ×2；参数化形状据 params 算。
      */
-    circumscribe: (innerHalfWidth: number, innerHalfHeight: number) => {
+    circumscribe: (innerHalfWidth: number, innerHalfHeight: number, params: TParams) => {
         halfWidth: number;
         halfHeight: number;
     };
-    /** 中心 → toward 射线 ∩ 边界（rect 带 rotate）。 */
-    boundaryPoint: (rect: Rect, toward: Position) => Position;
+    /**
+     * AABB 中心相对 node `position` 的偏移（可选；缺省 `[0, 0]` = AABB 中心即 position）。
+     * @description 多数 shape 的视觉 AABB 以 position 为中心（rectangle / ellipse / diamond）；但 sector 等
+     *   形状的语义锚点（圆心 apex）才是 position，其外接 AABB 中心偏在一侧——此 hook 让 compile 把
+     *   `rect.center` 放到 `position + offset`，使 bbox / viewBox 罩住完整形状、anchor 以 AABB 中心 rect 计算时
+     *   apex 落回 position。返回**未旋转**局部偏移（compile 在施加 node rotate 前用于定位 rect 中心）。
+     */
+    circumscribeOffset?: (params: TParams) => Position;
+    /** 中心 → toward 射线 ∩ 边界（rect 带 rotate）；params 喂参数化边界。 */
+    boundaryPoint: (rect: Rect, toward: Position, params: TParams) => Position;
     /** 命名 anchor 世界坐标；shape 不认识的名字返回 `undefined`（调用方据此抛清晰错误）。 */
-    anchor: (rect: Rect, name: string) => Position | undefined;
+    anchor: (rect: Rect, name: string, params: TParams) => Position | undefined;
     /**
      * 边上比例点：side 真实边界从约定起点起 t∈[0,1] 处（轴对齐空间求出后由 layout 投回世界系）。
      * @description 可选——内置 4 shape 必实现，不实现的 shape 收到 `{ side, t }` 时编译期（resolveEdgePoint）抛明确错。
      *   与 `anchor` 同坐标语义：收**带 rotate 的 Rect**，自行用 worldToLocal/localToWorld 处理旋转。
      */
-    edgePoint?: (rect: Rect, side: 'north' | 'south' | 'east' | 'west', t: number) => Position;
-    /** 视觉 primitive，**轴对齐空间**（rotate 由编译器外层 GroupPrim 统一施加）。 */
-    emit: (rect: Rect, style: ShapeStyle, round: (n: number) => number) => Iterable<ScenePrimitive>;
+    edgePoint?: (rect: Rect, side: 'north' | 'south' | 'east' | 'west', t: number, params: TParams) => Position;
+    /** 视觉 primitive，**轴对齐空间**（rotate 由编译器外层 GroupPrim 统一施加）；params 喂参数化几何。 */
+    emit: (rect: Rect, style: ShapeStyle, round: (n: number) => number, params: TParams) => Iterable<ScenePrimitive>;
+    /**
+     * node scale 作用于 params 的方式（可选）。
+     * @description 给定原始 params 与水平 / 垂直缩放因子 `sx` / `sy`，返回缩放后的 params。
+     *   缺省时编译器沿用默认行为——深度缩放 params 里所有数值叶子（uniform 几何均值因子）。
+     *   适用于 params 含「非长度」语义字段（如角度）的形状：sector / arc 只缩半径、不缩角度，
+     *   通过本 hook 把 startAngle / endAngle 排除在缩放外。不缩放任何 params 的形状不必实现。
+     */
+    scaleParams?: (params: TParams, sx: number, sy: number) => TParams;
 };
+/**
+ * shape 定义的擦除形态：registry 存这个
+ * @description 所有函数收 `IRJsonObject`（实际类型由 `paramsSchema.parse` 在编译期保证）；registry 同构
+ *   `Record<string, ShapeDefinition>`、不泛型化（避免逆变 / 落 any）。定义点用 `defineShape<TParams>` 拿类型安全。
+ */
+export type ShapeDefinition = ShapeDefinitionInput<IRJsonObject>;
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/shapes/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shapes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;OAGG;IACH,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,KACpB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,0CAA0C;IAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,KAAK,QAAQ,CAAC;IAC1D,6DAA6D;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;IAC3D;;;;OAIG;IACH,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EACzC,CAAC,EAAE,MAAM,KACN,QAAQ,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,QAAQ,CAAC,cAAc,CAAC,CAAC;CACjG,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shapes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,YAAY,IAAI;IAC/D,qEAAqE;IACrE,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC;;;;OAIG;IACH,YAAY,EAAE,CACZ,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,OAAO,KACZ;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;IACnD,wDAAwD;IACxD,aAAa,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;IAC3E,6DAA6D;IAC7D,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;IAC5E;;;;OAIG;IACH,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EACzC,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,OAAO,KACZ,QAAQ,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,CACJ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,MAAM,EAAE,OAAO,KACZ,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACpE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retikz/core",
-  "version": "0.3.0-alpha.3",
+  "version": "0.3.0-alpha.5",
   "description": "retikz v0.1 core: framework-agnostic IR, scene compiler, and pure parsers.",
   "type": "module",
   "author": "Pionpill",
@@ -14,7 +14,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Pionpill/retikz.git",
-    "directory": "packages/core"
+    "directory": "packages/core/core"
   },
   "bugs": {
     "url": "https://github.com/Pionpill/retikz/issues"

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

@@ -1,8 +0,0 @@
-import { ShapeDefinition } from './types';
-/**
- * circle 注册项
- * @description circumscribe = 内框对角线/2（两轴相等）；几何走 circle 数学层；
- *   emit 复用 `ellipse.emit`（circle = rx=ry 的 ellipse），与旧 circle→`emitEllipseShape` 等价
- */
-export declare const circle: ShapeDefinition;
-//# sourceMappingURL=circle.d.ts.map