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

package/dist/lib/geometry/roundedContour.cjs

@@ -0,0 +1,418 @@
+const require_arc = require("./arc.cjs");
+//#region src/geometry/roundedContour.ts
+var DEG_TO_RAD = Math.PI / 180;
+var RAD_TO_DEG = 180 / Math.PI;
+var EPSILON = 1e-9;
+/** 向量长度 */
+var length = (v) => Math.hypot(v[0], v[1]);
+/** 归一化（零向量回退 [1, 0]） */
+var normalize = (v) => {
+	const len = length(v);
+	if (len < EPSILON) return [1, 0];
+	return [v[0] / len, v[1] / len];
+};
+/** 二维叉积 a × b */
+var cross = (a, b) => a[0] * b[1] - a[1] * b[0];
+/** 点 + 角度（度）→ 圆周点 */
+var arcPoint = (center, radius, angleDeg) => {
+	const rad = angleDeg * DEG_TO_RAD;
+	return [center[0] + Math.cos(rad) * radius, center[1] + Math.sin(rad) * radius];
+};
+/** 段起点 */
+var segmentStart = (seg) => seg.kind === "line" ? seg.from : arcPoint(seg.center, seg.radius, seg.startAngle);
+/** 段终点 */
+var segmentEnd = (seg) => seg.kind === "line" ? seg.to : arcPoint(seg.center, seg.radius, seg.endAngle);
+/**
+* 段在某端的「行进切线」单位向量
+* @description atStart=true 取起点处沿行进方向的切线，否则取终点处。line 两端切线相同；
+*   arc 切线垂直于半径，方向随 counterClockwise 翻转（CW: (-sinθ, cosθ)，CCW: (sinθ, -cosθ)）。
+*/
+var tangentAt = (seg, atStart) => {
+	if (seg.kind === "line") return normalize([seg.to[0] - seg.from[0], seg.to[1] - seg.from[1]]);
+	const rad = (atStart ? seg.startAngle : seg.endAngle) * DEG_TO_RAD;
+	const sign = seg.counterClockwise ? -1 : 1;
+	return normalize([-Math.sin(rad) * sign, Math.cos(rad) * sign]);
+};
+/** arc 段的角跨度（带符号：CW 为正递增、CCW 为负），单位度 */
+var arcSpan = (seg) => seg.endAngle - seg.startAngle;
+/**
+* 把一个点投影到段上、返回沿段的「已走比例」(line: t∈[0,1]；arc: 已扫角 / 总跨度)
+* @description 用于逐角夹紧：校验切点是否落在该段长度（弧用角度）内。返回 fraction 可能 <0 或 >1 表示越界。
+*/
+var fractionAlong = (seg, p, fromStart) => {
+	if (seg.kind === "line") {
+		const ex = seg.to[0] - seg.from[0];
+		const ey = seg.to[1] - seg.from[1];
+		const len2 = ex * ex + ey * ey;
+		if (len2 < EPSILON) return 0;
+		const t = ((p[0] - seg.from[0]) * ex + (p[1] - seg.from[1]) * ey) / len2;
+		return fromStart ? t : 1 - t;
+	}
+	const angle = Math.atan2(p[1] - seg.center[1], p[0] - seg.center[0]) * RAD_TO_DEG;
+	const span = Math.abs(arcSpan(seg));
+	if (span < EPSILON) return 0;
+	const ccw = seg.counterClockwise ?? false;
+	const ref = fromStart ? seg.startAngle : seg.endAngle;
+	let swept = ((fromStart ? ccw : !ccw) ? ref - angle : angle - ref) % 360;
+	if (swept < 0) swept += 360;
+	if (swept > 180) swept -= 360;
+	return swept / span;
+};
+/**
+* 段朝 fillet 圆心侧偏移 r：line→平行线、arc→同心圆。
+* @description fillet 圆心所在侧由接缝转向 turnSign 决定（叉积 tIn×tOut）：凸角圆心在轮廓内侧、
+*   凹角（反向转）圆心在外侧（弧仍嵌入凹槽）。故偏移侧 = 行进方向左手 (-dy, dx) 乘 turnSign 符号。
+*   arc 同心偏移返回 radius−r 主候选；±r 两候选由 offsetSegmentAlt 补齐、求交后按真实距离校验择优。
+*/
+var offsetSegment = (seg, r, turnSign, atEnd) => {
+	if (seg.kind === "line") {
+		const dir = tangentAt(seg, true);
+		const sign = turnSign >= 0 ? 1 : -1;
+		const normal = [-dir[1] * sign, dir[0] * sign];
+		const base = atEnd ? seg.to : seg.from;
+		return {
+			kind: "line",
+			point: [base[0] + normal[0] * r, base[1] + normal[1] * r],
+			dir
+		};
+	}
+	return {
+		kind: "circle",
+		center: seg.center,
+		radius: seg.radius - r
+	};
+};
+/** arc 段内侧偏移的另一候选（radius + r），与 offsetSegment 配合枚举 */
+var offsetSegmentAlt = (seg, r) => ({
+	kind: "circle",
+	center: seg.center,
+	radius: seg.radius + r
+});
+/** 直线 ∩ 直线（各以 point + dir 表示），返回交点或 undefined（平行） */
+var intersectLineLine = (a, b) => {
+	const det = cross(a.dir, b.dir);
+	if (Math.abs(det) < EPSILON) return void 0;
+	const dx = b.point[0] - a.point[0];
+	const dy = b.point[1] - a.point[1];
+	const t = (dx * b.dir[1] - dy * b.dir[0]) / det;
+	return [a.point[0] + a.dir[0] * t, a.point[1] + a.dir[1] * t];
+};
+/** 直线（point+dir）∩ 圆（center,radius），返回交点列（0/1/2 个） */
+var intersectLineCircle = (line, circle) => {
+	const ox = line.point[0] - circle.center[0];
+	const oy = line.point[1] - circle.center[1];
+	const ux = line.dir[0];
+	const uy = line.dir[1];
+	const b = 2 * (ox * ux + oy * uy);
+	const c = ox * ox + oy * oy - circle.radius * circle.radius;
+	const disc = b * b - 4 * c;
+	if (disc < 0) return [];
+	const sq = Math.sqrt(disc);
+	const out = [];
+	for (const t of [(-b - sq) / 2, (-b + sq) / 2]) out.push([line.point[0] + ux * t, line.point[1] + uy * t]);
+	return out;
+};
+/** 圆 ∩ 圆，返回交点列（0/1/2 个） */
+var intersectCircleCircle = (a, b) => {
+	const dx = b.center[0] - a.center[0];
+	const dy = b.center[1] - a.center[1];
+	const d = Math.hypot(dx, dy);
+	if (d < EPSILON || d > a.radius + b.radius + EPSILON || d < Math.abs(a.radius - b.radius) - EPSILON) return [];
+	const aa = (a.radius * a.radius - b.radius * b.radius + d * d) / (2 * d);
+	const h2 = a.radius * a.radius - aa * aa;
+	const h = h2 > 0 ? Math.sqrt(h2) : 0;
+	const mx = a.center[0] + aa * dx / d;
+	const my = a.center[1] + aa * dy / d;
+	const rx = -dy * h / d;
+	const ry = dx * h / d;
+	return [[mx + rx, my + ry], [mx - rx, my - ry]];
+};
+/** 点到直线（无限延长）的有符号垂足点 */
+var footOnLine = (p, base, dir) => {
+	const t = (p[0] - base[0]) * dir[0] + (p[1] - base[1]) * dir[1];
+	return [base[0] + dir[0] * t, base[1] + dir[1] * t];
+};
+/**
+* 解算一个接缝（segA 终点 = segB 起点）的 fillet
+* @description segA / segB 至少一为 line（arc-arc 由调用方提前拒绝）。流程：
+*   1. 取接缝点 corner、前段到达切线 tIn、后段离开切线 tOut，叉积 turnSign 定转向（含内侧）。
+*   2. 由两段「内侧偏移 r」求 fillet 圆心：候选交点中挑离两段距离均≈r、且落在 corner 内侧的那个。
+*   3. 圆心到两段的垂足 / 投影点 = 两切点。
+*   4. 逐角夹紧：切点须落在两段剩余长度内（fraction∈[0,1]），越界则缩 r 重解；r→0 标记不倒。
+*/
+var solveFillet = (segA, segB, r) => {
+	if (segA.kind === "arc" && segB.kind === "arc") throw new Error("filletContour: arc-arc seam fillet is not supported");
+	const corner = segmentEnd(segA);
+	const turnSign = cross(tangentAt(segA, false), tangentAt(segB, true));
+	const attempt = (radius) => {
+		if (radius <= EPSILON) return void 0;
+		const offA = offsetSegment(segA, radius, turnSign, true);
+		const offB = offsetSegment(segB, radius, turnSign, false);
+		const candidates = [];
+		const pushIntersections = (oa, ob) => {
+			if (oa.kind === "line" && ob.kind === "line") {
+				const p = intersectLineLine(oa, ob);
+				if (p) candidates.push(p);
+			} else if (oa.kind === "line" && ob.kind === "circle") candidates.push(...intersectLineCircle(oa, ob));
+			else if (oa.kind === "circle" && ob.kind === "line") candidates.push(...intersectLineCircle(ob, oa));
+			else if (oa.kind === "circle" && ob.kind === "circle") candidates.push(...intersectCircleCircle(oa, ob));
+		};
+		pushIntersections(offA, offB);
+		if (segA.kind === "arc") pushIntersections(offsetSegmentAlt(segA, radius), offB);
+		if (segB.kind === "arc") pushIntersections(offA, offsetSegmentAlt(segB, radius));
+		if (segA.kind === "arc" && segB.kind === "arc") pushIntersections(offsetSegmentAlt(segA, radius), offsetSegmentAlt(segB, radius));
+		let best;
+		let bestDist = Infinity;
+		for (const cand of candidates) {
+			const tInPt = tangentPointOn(segA, cand, radius);
+			const tOutPt = tangentPointOn(segB, cand, radius);
+			if (!tInPt || !tOutPt) continue;
+			const dA = distanceToAny(segA, cand);
+			const dB = distanceToAny(segB, cand);
+			if (Math.abs(dA - radius) > 1e-6 || Math.abs(dB - radius) > 1e-6) continue;
+			const inFrac = fractionAlong(segA, tInPt, false);
+			const outFrac = fractionAlong(segB, tOutPt, true);
+			if (inFrac < -1e-7 || inFrac > .5000001 || outFrac < -1e-7 || outFrac > .5000001) continue;
+			const d = Math.hypot(cand[0] - corner[0], cand[1] - corner[1]);
+			if (d < bestDist) {
+				bestDist = d;
+				best = {
+					center: cand,
+					tInPt,
+					tOutPt,
+					inFrac,
+					outFrac
+				};
+			}
+		}
+		if (!best) return void 0;
+		const startAngle = Math.atan2(best.tInPt[1] - best.center[1], best.tInPt[0] - best.center[0]) * RAD_TO_DEG;
+		const endAngle = Math.atan2(best.tOutPt[1] - best.center[1], best.tOutPt[0] - best.center[0]) * RAD_TO_DEG;
+		const counterClockwise = turnSign < 0;
+		const adjusted = alignSweep(startAngle, endAngle, counterClockwise);
+		return {
+			tangentInPoint: best.tInPt,
+			tangentOutPoint: best.tOutPt,
+			center: best.center,
+			radius,
+			startAngle: adjusted.start,
+			endAngle: adjusted.end,
+			counterClockwise,
+			clampedToZero: false
+		};
+	};
+	const direct = attempt(r);
+	if (direct) return direct;
+	let lo = 0;
+	let hi = r;
+	let bestSolution;
+	for (let iter = 0; iter < 48; iter++) {
+		const mid = (lo + hi) / 2;
+		const sol = attempt(mid);
+		if (sol) {
+			bestSolution = sol;
+			lo = mid;
+		} else hi = mid;
+	}
+	if (bestSolution) return bestSolution;
+	return {
+		tangentInPoint: corner,
+		tangentOutPoint: corner,
+		center: corner,
+		radius: 0,
+		startAngle: 0,
+		endAngle: 0,
+		counterClockwise: false,
+		clampedToZero: true
+	};
+};
+/** 点到段（line / arc 所在直线 / 圆）的距离 */
+var distanceToAny = (seg, p) => {
+	if (seg.kind === "line") {
+		const dir = tangentAt(seg, true);
+		const foot = footOnLine(p, seg.from, dir);
+		return Math.hypot(p[0] - foot[0], p[1] - foot[1]);
+	}
+	const d = Math.hypot(p[0] - seg.center[0], p[1] - seg.center[1]);
+	return Math.abs(d - seg.radius);
+};
+/**
+* fillet 圆心 → 段上切点
+* @description line：圆心在直线上的垂足。arc：圆心与 arc 圆心连线 ∩ arc 圆周（朝 fillet 圆心一侧）。
+*   切点须落在段几何上（line 在线上、arc 在弧角度区间内）才有效，否则返回 undefined。
+*/
+var tangentPointOn = (seg, filletCenter, radius) => {
+	if (seg.kind === "line") {
+		const dir = tangentAt(seg, true);
+		return footOnLine(filletCenter, seg.from, dir);
+	}
+	const vx = filletCenter[0] - seg.center[0];
+	const vy = filletCenter[1] - seg.center[1];
+	const d = Math.hypot(vx, vy);
+	if (d < EPSILON) return void 0;
+	const ux = vx / d;
+	const uy = vy / d;
+	const candidates = [[seg.center[0] + ux * seg.radius, seg.center[1] + uy * seg.radius], [seg.center[0] - ux * seg.radius, seg.center[1] - uy * seg.radius]];
+	let best;
+	let bestErr = Infinity;
+	for (const cand of candidates) {
+		const angle = Math.atan2(cand[1] - seg.center[1], cand[0] - seg.center[0]) * RAD_TO_DEG;
+		if (!require_arc.arcAngleInRange(seg.startAngle, seg.endAngle, angle, 1e-6)) continue;
+		const err = Math.abs(Math.hypot(cand[0] - filletCenter[0], cand[1] - filletCenter[1]) - radius);
+		if (err < bestErr) {
+			bestErr = err;
+			best = cand;
+		}
+	}
+	return bestErr <= 1e-6 ? best : void 0;
+};
+/**
+* 对闭合轮廓的每个接缝做 fillet，返回 fillet 解算列表（与接缝一一对应，下标 i = 段 i 终点接段 (i+1)%n 起点）
+* @description cornerRadius 省略 / ≤0 → 返回空数组（调用方据此 passthrough 原段序列）。arc-arc 接缝抛错。
+*/
+var filletContour = (segments, cornerRadius) => {
+	if (cornerRadius === void 0 || cornerRadius <= 0 || segments.length < 2) return [];
+	const n = segments.length;
+	const out = [];
+	for (let i = 0; i < n; i++) {
+		const segA = segments[i];
+		const segB = segments[(i + 1) % n];
+		out.push(solveFillet(segA, segB, cornerRadius));
+	}
+	return out;
+};
+/**
+* 把闭合轮廓 + cornerRadius emit 成路径命令（move + 缩短 line + 裁剪原 arc + fillet arc + close）
+* @description cornerRadius 省略 / ≤0 → 直接 emit 原始尖角轮廓（passthrough）。否则每段从「上一接缝的
+*   fillet 出点」走到「本接缝的 fillet 入点」（line 缩短 / arc 裁剪角度），接缝处插 fillet 弧。
+*   夹紧到 0 的角不插弧、按原尖角连接。
+*/
+var contourCommands = (segments, cornerRadius) => {
+	const n = segments.length;
+	if (n === 0) return [];
+	const fillets = filletContour(segments, cornerRadius);
+	if (fillets.length === 0) {
+		const cmds = [];
+		segments.forEach((seg, i) => {
+			if (i === 0) cmds.push({
+				kind: "move",
+				to: segmentStart(seg)
+			});
+			emitSegmentBody(seg, segmentStart(seg), segmentEnd(seg), cmds);
+		});
+		cmds.push({ kind: "close" });
+		return cmds;
+	}
+	const cmds = [];
+	for (let i = 0; i < n; i++) {
+		const seg = segments[i];
+		const prevFillet = fillets[(i - 1 + n) % n];
+		const thisFillet = fillets[i];
+		const start = prevFillet.clampedToZero ? segmentStart(seg) : prevFillet.tangentOutPoint;
+		const end = thisFillet.clampedToZero ? segmentEnd(seg) : thisFillet.tangentInPoint;
+		if (i === 0) cmds.push({
+			kind: "move",
+			to: start
+		});
+		emitSegmentBody(seg, start, end, cmds);
+		if (!thisFillet.clampedToZero) cmds.push({
+			kind: "arc",
+			center: thisFillet.center,
+			radius: thisFillet.radius,
+			startAngle: thisFillet.startAngle,
+			endAngle: thisFillet.endAngle,
+			counterClockwise: thisFillet.counterClockwise
+		});
+	}
+	cmds.push({ kind: "close" });
+	return cmds;
+};
+/** emit 单段主体（line → line 命令到 end；arc → 裁剪角度的 arc 命令到 end），起点由调用方先 move/前段给出 */
+var emitSegmentBody = (seg, start, end, cmds) => {
+	if (seg.kind === "line") {
+		cmds.push({
+			kind: "line",
+			to: end
+		});
+		return;
+	}
+	const adjusted = alignSweep(Math.atan2(start[1] - seg.center[1], start[0] - seg.center[0]) * RAD_TO_DEG, Math.atan2(end[1] - seg.center[1], end[0] - seg.center[0]) * RAD_TO_DEG, seg.counterClockwise ?? false);
+	cmds.push({
+		kind: "arc",
+		center: seg.center,
+		radius: seg.radius,
+		startAngle: adjusted.start,
+		endAngle: adjusted.end,
+		counterClockwise: seg.counterClockwise
+	});
+};
+/** 调整 endAngle 使「start→end」沿给定扫描方向（ccw: 递减 / 否则递增），保持裁剪后弧方向不变 */
+var alignSweep = (start, end, ccw) => {
+	let e = end;
+	if (ccw) {
+		while (e > start) e -= 360;
+		while (e <= start - 360) e += 360;
+	} else {
+		while (e < start) e += 360;
+		while (e >= start + 360) e -= 360;
+	}
+	return {
+		start,
+		end: e
+	};
+};
+/**
+* 从 rayOrigin 朝 toward 射线 ∩ fillet 后轮廓全部段，返回最近正向交点
+* @description rayOrigin 显式传（不假设中心）；toward 是射线指向的目标点（方向 = toward − rayOrigin）。
+*   遍历 fillet 后的有效段（缩短 line / 裁剪 arc / fillet arc），对每段求 ray∩段、取最小正参数命中点。
+*   cornerRadius 省略 / ≤0 → 走原尖角轮廓。无命中返回 undefined（调用方兜底）。
+*/
+var boundaryFromContour = (segments, cornerRadius, rayOrigin, toward) => {
+	const dirRaw = [toward[0] - rayOrigin[0], toward[1] - rayOrigin[1]];
+	const dl = length(dirRaw);
+	if (dl < 1e-12) return void 0;
+	const dir = [dirRaw[0] / dl, dirRaw[1] / dl];
+	const n = segments.length;
+	const fillets = filletContour(segments, cornerRadius);
+	let best = Infinity;
+	const considerLine = (a, b) => {
+		const ex = b[0] - a[0];
+		const ey = b[1] - a[1];
+		const det = dir[0] * -ey - -ex * dir[1];
+		if (Math.abs(det) < 1e-12) return;
+		const ax = a[0] - rayOrigin[0];
+		const ay = a[1] - rayOrigin[1];
+		const s = (ax * -ey - -ex * ay) / det;
+		const t = (dir[0] * ay - ax * dir[1]) / det;
+		if (s <= 1e-9 || s >= best) return;
+		if (t >= -1e-9 && t <= 1.000000001) best = s;
+	};
+	const considerArc = (center, radius, startAngle, endAngle, ccw) => {
+		const aligned = alignSweep(startAngle, endAngle, ccw);
+		const hits = require_arc.rayArc(rayOrigin, dir, center, radius, aligned.start, aligned.end);
+		for (const s of hits) if (s > 1e-9 && s < best) best = s;
+	};
+	if (fillets.length === 0) for (let i = 0; i < n; i++) {
+		const seg = segments[i];
+		if (seg.kind === "line") considerLine(seg.from, seg.to);
+		else considerArc(seg.center, seg.radius, seg.startAngle, seg.endAngle, seg.counterClockwise ?? false);
+	}
+	else for (let i = 0; i < n; i++) {
+		const seg = segments[i];
+		const prevFillet = fillets[(i - 1 + n) % n];
+		const thisFillet = fillets[i];
+		const start = prevFillet.clampedToZero ? segmentStart(seg) : prevFillet.tangentOutPoint;
+		const end = thisFillet.clampedToZero ? segmentEnd(seg) : thisFillet.tangentInPoint;
+		if (seg.kind === "line") considerLine(start, end);
+		else {
+			const aligned = alignSweep(Math.atan2(start[1] - seg.center[1], start[0] - seg.center[0]) * RAD_TO_DEG, Math.atan2(end[1] - seg.center[1], end[0] - seg.center[0]) * RAD_TO_DEG, seg.counterClockwise ?? false);
+			considerArc(seg.center, seg.radius, aligned.start, aligned.end, seg.counterClockwise ?? false);
+		}
+		if (!thisFillet.clampedToZero) considerArc(thisFillet.center, thisFillet.radius, thisFillet.startAngle, thisFillet.endAngle, thisFillet.counterClockwise);
+	}
+	if (!Number.isFinite(best)) return void 0;
+	return [rayOrigin[0] + dir[0] * best, rayOrigin[1] + dir[1] * best];
+};
+//#endregion
+exports.boundaryFromContour = boundaryFromContour;
+exports.contourCommands = contourCommands;

package/dist/lib/geometry/roundedContour.d.ts

@@ -0,0 +1,88 @@
+import { Position } from './point';
+/** 直线段：从 from 到 to 的有向线段 */
+export type LineSegment = {
+    /** 鉴别字面量 */
+    kind: 'line';
+    /** 起点 [x, y] */
+    from: Position;
+    /** 终点 [x, y] */
+    to: Position;
+};
+/** 圆弧段：圆心 + 半径 + 起末角（度）+ 扫描方向，与 ir/path arc 同参数化 */
+export type ArcSegment = {
+    /** 鉴别字面量 */
+    kind: 'arc';
+    /** 圆心 [x, y] */
+    center: Position;
+    /** 半径（user units） */
+    radius: number;
+    /** 起始角度（度，0=+x、90=+y 视觉下） */
+    startAngle: number;
+    /** 终止角度（度） */
+    endAngle: number;
+    /** 是否逆时针扫描；缺省 / false = CW（角度递增 / 屏幕顺时针） */
+    counterClockwise?: boolean;
+};
+/** 轮廓段：组成闭合轮廓的最小单元（直线或圆弧） */
+export type ContourSegment = LineSegment | ArcSegment;
+/** fillet 后用于 emit 的路径命令（与 primitive/path PathCommand 的 move/line/arc/close 子集对齐） */
+export type ContourCommand = {
+    kind: 'move';
+    to: Position;
+} | {
+    kind: 'line';
+    to: Position;
+} | {
+    kind: 'arc';
+    center: Position;
+    radius: number;
+    startAngle: number;
+    endAngle: number;
+    counterClockwise?: boolean;
+} | {
+    kind: 'close';
+};
+/**
+ * 一个接缝处 fillet 的解算结果
+ * @description tangentInPoint = 前段被裁短到此点（前段新终点）；tangentOutPoint = 后段从此点起（后段新起点）；
+ *   filletArc 描述连接两切点的圆弧。clampedToZero=true 表示该角夹紧后 r→0，不倒角（保持尖角）。
+ */
+type FilletSolution = {
+    /** 前段切点（前段新终点） */
+    tangentInPoint: Position;
+    /** 后段切点（后段新起点） */
+    tangentOutPoint: Position;
+    /** fillet 圆心 */
+    center: Position;
+    /** fillet 半径 */
+    radius: number;
+    /** fillet 弧起始角（度，从 center 看 tangentInPoint） */
+    startAngle: number;
+    /** fillet 弧终止角（度，从 center 看 tangentOutPoint） */
+    endAngle: number;
+    /** fillet 弧是否逆时针 */
+    counterClockwise: boolean;
+    /** 夹紧后 r→0，本角不倒（emit 走原尖角） */
+    clampedToZero: boolean;
+};
+/**
+ * 对闭合轮廓的每个接缝做 fillet，返回 fillet 解算列表（与接缝一一对应，下标 i = 段 i 终点接段 (i+1)%n 起点）
+ * @description cornerRadius 省略 / ≤0 → 返回空数组（调用方据此 passthrough 原段序列）。arc-arc 接缝抛错。
+ */
+export declare const filletContour: (segments: Array<ContourSegment>, cornerRadius?: number) => Array<FilletSolution>;
+/**
+ * 把闭合轮廓 + cornerRadius emit 成路径命令（move + 缩短 line + 裁剪原 arc + fillet arc + close）
+ * @description cornerRadius 省略 / ≤0 → 直接 emit 原始尖角轮廓（passthrough）。否则每段从「上一接缝的
+ *   fillet 出点」走到「本接缝的 fillet 入点」（line 缩短 / arc 裁剪角度），接缝处插 fillet 弧。
+ *   夹紧到 0 的角不插弧、按原尖角连接。
+ */
+export declare const contourCommands: (segments: Array<ContourSegment>, cornerRadius?: number) => Array<ContourCommand>;
+/**
+ * 从 rayOrigin 朝 toward 射线 ∩ fillet 后轮廓全部段，返回最近正向交点
+ * @description rayOrigin 显式传（不假设中心）；toward 是射线指向的目标点（方向 = toward − rayOrigin）。
+ *   遍历 fillet 后的有效段（缩短 line / 裁剪 arc / fillet arc），对每段求 ray∩段、取最小正参数命中点。
+ *   cornerRadius 省略 / ≤0 → 走原尖角轮廓。无命中返回 undefined（调用方兜底）。
+ */
+export declare const boundaryFromContour: (segments: Array<ContourSegment>, cornerRadius: number | undefined, rayOrigin: Position, toward: Position) => Position | undefined;
+export {};
+//# sourceMappingURL=roundedContour.d.ts.map

package/dist/lib/geometry/roundedContour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundedContour.d.ts","sourceRoot":"","sources":["../../../src/geometry/roundedContour.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAkBxC,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG;IACxB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,gBAAgB;IAChB,EAAE,EAAE,QAAQ,CAAC;CACd,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,gBAAgB;IAChB,MAAM,EAAE,QAAQ,CAAC;IACjB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,6BAA6B;AAC7B,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC;AAEtD,qFAAqF;AACrF,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GACD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AA6CtB;;;;GAIG;AACH,KAAK,cAAc,GAAG;IACpB,kBAAkB;IAClB,cAAc,EAAE,QAAQ,CAAC;IACzB,kBAAkB;IAClB,eAAe,EAAE,QAAQ,CAAC;IAC1B,gBAAgB;IAChB,MAAM,EAAE,QAAQ,CAAC;IACjB,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAgTF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,KAAK,CAAC,cAAc,CAAC,EAC/B,eAAe,MAAM,KACpB,KAAK,CAAC,cAAc,CAUtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,KAAK,CAAC,cAAc,CAAC,EAC/B,eAAe,MAAM,KACpB,KAAK,CAAC,cAAc,CAuCtB,CAAC;AAwCF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,KAAK,CAAC,cAAc,CAAC,EAC/B,cAAc,MAAM,GAAG,SAAS,EAChC,WAAW,QAAQ,EACnB,QAAQ,QAAQ,KACf,QAAQ,GAAG,SA2Eb,CAAC"}

package/dist/lib/index.cjs

@@ -3,12 +3,13 @@ const require_position = require("./ir/position/position.cjs");
 const require_polar_position = require("./ir/position/polar-position.cjs");
 const require_at_position = require("./ir/position/at-position.cjs");
 const require_offset_position = require("./ir/position/offset-position.cjs");
-const require__transform = require("./geometry/_transform.cjs");
-const require_rect = require("./geometry/rect.cjs");
+const require_json = require("./ir/json.cjs");
+const require_shape = require("./ir/shape.cjs");
+const require_boundary = require("./ir/boundary.cjs");
 const require_target = require("./ir/path/target.cjs");
 const require_between_position = require("./ir/position/between-position.cjs");
 const require_font = require("./ir/font.cjs");
-const require_json = require("./ir/json.cjs");
+const require_animation = require("./ir/animation.cjs");
 const require_paint = require("./ir/paint.cjs");
 const require_clip = require("./ir/clip.cjs");
 const require_text = require("./ir/text.cjs");
@@ -21,9 +22,10 @@ const require_transform = require("./ir/transform.cjs");
 const require_scope = require("./ir/scope.cjs");
 const require_composite = require("./ir/composite.cjs");
 const require_scene = require("./ir/scene.cjs");
-const require_circle = require("./geometry/circle.cjs");
+const require__transform = require("./geometry/_transform.cjs");
+const require_rect = require("./geometry/rect.cjs");
+const require_define = require("./shapes/define.cjs");
 const require_ellipse = require("./geometry/ellipse.cjs");
-const require_diamond = require("./geometry/diamond.cjs");
 const require_index = require("./shapes/index.cjs");
 const require_index$1 = require("./arrows/index.cjs");
 const require_index$2 = require("./patterns/index.cjs");
@@ -33,9 +35,12 @@ const require_compile = require("./compile/compile.cjs");
 const require_parseNodeTarget = require("./parsers/parseNodeTarget.cjs");
 const require_parseTargetSugar = require("./parsers/parseTargetSugar.cjs");
 const require_parseWay = require("./parsers/parseWay.cjs");
+const require_animation$1 = require("./presets/animation.cjs");
 const require_polar = require("./geometry/polar.cjs");
 const require_point = require("./geometry/point.cjs");
-const require_define = require("./pathGenerators/define.cjs");
+const require_circle = require("./geometry/circle.cjs");
+const require_diamond = require("./geometry/diamond.cjs");
+const require_define$1 = require("./pathGenerators/define.cjs");
 const require_types = require("./composites/types.cjs");
 exports.ARROW_MARKER_DEFAULT_SIZE = require_arrow.ARROW_MARKER_DEFAULT_SIZE;
 exports.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = require_arrow.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH;
@@ -43,6 +48,12 @@ exports.ARROW_SHAPES = require_arrow.ARROW_SHAPES;
 exports.AT_DIRECTIONS = require_at_position.AT_DIRECTIONS;
 exports.AbsoluteTargetSchema = require_between_position.AbsoluteTargetSchema;
 exports.AnchorRefSchema = require_target.AnchorRefSchema;
+exports.AnimationDirection = require_animation.AnimationDirection;
+exports.AnimationEasing = require_animation.AnimationEasing;
+exports.AnimationFill = require_animation.AnimationFill;
+exports.AnimationProperty = require_animation.AnimationProperty;
+exports.AnimationTrackSchema = require_animation.AnimationTrackSchema;
+exports.AnimationTrigger = require_animation.AnimationTrigger;
 exports.ArcStepSchema = require_step.ArcStepSchema;
 exports.ArrowDefaultSchema = require_scope.ArrowDefaultSchema;
 exports.ArrowDetailSchema = require_arrow.ArrowDetailSchema;
@@ -53,6 +64,8 @@ exports.BUILTIN_PATTERNS = require_index$2.BUILTIN_PATTERNS;
 exports.BUILTIN_SHAPES = require_index.BUILTIN_SHAPES;
 exports.BendStepSchema = require_step.BendStepSchema;
 exports.BetweenPositionSchema = require_between_position.BetweenPositionSchema;
+exports.Boundary = require_boundary.Boundary;
+exports.BoundarySchema = require_boundary.BoundarySchema;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
 exports.ChildSchema = require_scene.ChildSchema;
 exports.CirclePathStepSchema = require_step.CirclePathStepSchema;
@@ -65,6 +78,7 @@ exports.CurveStepSchema = require_step.CurveStepSchema;
 exports.CycleStepSchema = require_step.CycleStepSchema;
 exports.DEFAULT_ARROW_SHAPE = require_arrow.DEFAULT_ARROW_SHAPE;
 exports.DrawWay = require_parseWay.DrawWay;
+exports.EasingSchema = require_animation.EasingSchema;
 exports.EllipsePathStepSchema = require_step.EllipsePathStepSchema;
 exports.FoldStepSchema = require_step.FoldStepSchema;
 exports.FontSchema = require_font.FontSchema;
@@ -73,6 +87,7 @@ exports.GradientStopSchema = require_paint.GradientStopSchema;
 exports.HOLLOW_ARROW_SHAPES = require_arrow.HOLLOW_ARROW_SHAPES;
 exports.JsonObjectSchema = require_json.JsonObjectSchema;
 exports.JsonValueSchema = require_json.JsonValueSchema;
+exports.KeyframeSchema = require_animation.KeyframeSchema;
 exports.LabelDefaultSchema = require_scope.LabelDefaultSchema;
 exports.LineSpecSchema = require_text.LineSpecSchema;
 exports.LineStepSchema = require_step.LineStepSchema;
@@ -84,6 +99,7 @@ exports.NodeLabelSchema = require_node.NodeLabelSchema;
 exports.NodeSchema = require_node.NodeSchema;
 exports.NodeTargetSchema = require_target.NodeTargetSchema;
 exports.OffsetPositionSchema = require_offset_position.OffsetPositionSchema;
+exports.OriginSchema = require_animation.OriginSchema;
 exports.PATTERN_SHAPES = require_paint.PATTERN_SHAPES;
 exports.PaintSpecSchema = require_paint.PaintSpecSchema;
 exports.PathDefaultSchema = require_scope.PathDefaultSchema;
@@ -96,25 +112,43 @@ exports.RelativeAccumulateTargetSchema = require_target.RelativeAccumulateTarget
 exports.RelativeTargetSchema = require_target.RelativeTargetSchema;
 exports.SceneSchema = require_scene.SceneSchema;
 exports.ScopeSchema = require_scope.ScopeSchema;
+exports.ShapeRefSchema = require_shape.ShapeRefSchema;
 exports.StepLabelSchema = require_step.StepLabelSchema;
 exports.StepSchema = require_step.StepSchema;
 exports.TargetSchema = require_target.TargetSchema;
 exports.TextBlockSchema = require_text.TextBlockSchema;
 exports.TransformSchema = require_transform.TransformSchema;
+exports.TriggerSchema = require_animation.TriggerSchema;
 exports.ViewBoxSchema = require_scene.ViewBoxSchema;
+exports.blink = require_animation$1.blink;
+exports.cameraTo = require_animation$1.cameraTo;
 exports.circle = require_circle.circle;
+exports.colorShift = require_animation$1.colorShift;
 exports.compileToScene = require_compile.compileToScene;
 exports.computeLayout = require_layout.computeLayout;
 exports.defineComposite = require_types.defineComposite;
-exports.definePathGenerator = require_define.definePathGenerator;
+exports.definePathGenerator = require_define$1.definePathGenerator;
+exports.defineShape = require_define.defineShape;
 exports.diamond = require_diamond.diamond;
+exports.drawOn = require_animation$1.drawOn;
 exports.ellipse = require_ellipse.ellipse;
+exports.fadeIn = require_animation$1.fadeIn;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;
+exports.flash = require_animation$1.flash;
+exports.grow = require_animation$1.grow;
+exports.growUp = require_animation$1.growUp;
 exports.localToWorld = require__transform.localToWorld;
+exports.loop = require_animation$1.loop;
 exports.parseNodeTarget = require_parseNodeTarget.parseNodeTarget;
 exports.parseTargetSugar = require_parseTargetSugar.parseTargetSugar;
 exports.parseWay = require_parseWay.parseWay;
 exports.point = require_point.point;
 exports.polar = require_polar.polar;
+exports.pulse = require_animation$1.pulse;
 exports.rect = require_rect.rect;
+exports.scaleIn = require_animation$1.scaleIn;
+exports.slideIn = require_animation$1.slideIn;
+exports.spin = require_animation$1.spin;
+exports.stagger = require_animation$1.stagger;
+exports.wiggle = require_animation$1.wiggle;
 exports.worldToLocal = require__transform.worldToLocal;