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

package/dist/es/geometry/roundedContour.js

@@ -0,0 +1,417 @@
+import { arcAngleInRange, rayArc } from "./arc.js";
+//#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 (!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 = 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
+export { boundaryFromContour, contourCommands };

package/dist/es/index.d.ts

@@ -2,9 +2,10 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/render/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
-export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, PATTERN_SHAPES, } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
+export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, PATTERN_SHAPES, Boundary, BoundarySchema, } from './ir';
+export type { BoundaryKeyword, IRBoundary } from './ir';
 export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
 MovePathCommand, LinePathCommand, QuadPathCommand, CubicPathCommand, ArcPathCommand, EllipseArcPathCommand, ClosePathCommand, ArrowEndSpec, GroupPrim, Transform, 
@@ -22,8 +23,8 @@ export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayL
 export { parseWay, DrawWay, parseTargetSugar, parseNodeTarget } from './parsers';
 export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
-export type { ShapeDefinition, ShapeStyle } from './shapes';
-export { BUILTIN_SHAPES, worldToLocal, localToWorld } from './shapes';
+export type { ShapeDefinition, ShapeDefinitionInput, ShapeStyle } from './shapes';
+export { BUILTIN_SHAPES, defineShape, worldToLocal, localToWorld } from './shapes';
 export type { ArrowDefinition, ArrowEmitContext } from './arrows';
 export { BUILTIN_ARROWS } from './arrows';
 export type { PatternDefinition, PatternEmitContext } from './patterns';

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

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

package/dist/es/index.js

@@ -2,12 +2,12 @@ import { PositionSchema } from "./ir/position/position.js";
 import { PolarPositionSchema } from "./ir/position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./ir/position/at-position.js";
 import { OffsetPositionSchema } from "./ir/position/offset-position.js";
-import { localToWorld, worldToLocal } from "./geometry/_transform.js";
-import { RECT_ANCHORS, rect } from "./geometry/rect.js";
+import { JsonObjectSchema, JsonValueSchema } from "./ir/json.js";
+import { ShapeRefSchema } from "./ir/shape.js";
+import { Boundary, BoundarySchema } from "./ir/boundary.js";
 import { AnchorRefSchema, NodeTargetSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, TargetSchema } from "./ir/path/target.js";
 import { AbsoluteTargetSchema, BetweenPositionSchema } from "./ir/position/between-position.js";
 import { FontSchema } from "./ir/font.js";
-import { JsonObjectSchema, JsonValueSchema } from "./ir/json.js";
 import { GradientStopSchema, PATTERN_SHAPES, PaintSpecSchema } from "./ir/paint.js";
 import { ClipSpecSchema } from "./ir/clip.js";
 import { LineSpecSchema, TextBlockSchema } from "./ir/text.js";
@@ -20,9 +20,10 @@ import { TransformSchema } from "./ir/transform.js";
 import { ArrowDefaultSchema, LabelDefaultSchema, NodeDefaultSchema, PathDefaultSchema, ScopeSchema } from "./ir/scope.js";
 import { CompositeBaseSchema } from "./ir/composite.js";
 import { CURRENT_IR_VERSION, ChildSchema, SceneSchema, ViewBoxSchema } from "./ir/scene.js";
-import { circle } from "./geometry/circle.js";
+import { localToWorld, worldToLocal } from "./geometry/_transform.js";
+import { RECT_ANCHORS, rect } from "./geometry/rect.js";
+import { defineShape } from "./shapes/define.js";
 import { ellipse } from "./geometry/ellipse.js";
-import { diamond } from "./geometry/diamond.js";
 import { BUILTIN_SHAPES } from "./shapes/index.js";
 import { BUILTIN_ARROWS } from "./arrows/index.js";
 import { BUILTIN_PATTERNS } from "./patterns/index.js";
@@ -34,6 +35,8 @@ import { parseTargetSugar } from "./parsers/parseTargetSugar.js";
 import { DrawWay, parseWay } from "./parsers/parseWay.js";
 import { polar } from "./geometry/polar.js";
 import { point } from "./geometry/point.js";
+import { circle } from "./geometry/circle.js";
+import { diamond } from "./geometry/diamond.js";
 import { definePathGenerator } from "./pathGenerators/define.js";
 import { defineComposite } from "./composites/types.js";
-export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, AT_DIRECTIONS, AbsoluteTargetSchema, AnchorRefSchema, ArcStepSchema, ArrowDefaultSchema, ArrowDetailSchema, ArrowEndDetailSchema, AtPositionSchema, BUILTIN_ARROWS, BUILTIN_PATTERNS, BUILTIN_SHAPES, BendStepSchema, BetweenPositionSchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ClipSpecSchema, CompositeBaseSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DEFAULT_ARROW_SHAPE, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, GeneratorStepSchema, GradientStopSchema, HOLLOW_ARROW_SHAPES, JsonObjectSchema, JsonValueSchema, LabelDefaultSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeDefaultSchema, NodeLabelSchema, NodeSchema, NodeTargetSchema, OffsetPositionSchema, PATTERN_SHAPES, PaintSpecSchema, PathDefaultSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RectangleStepSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, ScopeSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, TransformSchema, ViewBoxSchema, circle, compileToScene, computeLayout, defineComposite, definePathGenerator, diamond, ellipse, fallbackMeasurer, localToWorld, parseNodeTarget, parseTargetSugar, parseWay, point, polar, rect, worldToLocal };
+export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, AT_DIRECTIONS, AbsoluteTargetSchema, AnchorRefSchema, ArcStepSchema, ArrowDefaultSchema, ArrowDetailSchema, ArrowEndDetailSchema, AtPositionSchema, BUILTIN_ARROWS, BUILTIN_PATTERNS, BUILTIN_SHAPES, BendStepSchema, BetweenPositionSchema, Boundary, BoundarySchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ClipSpecSchema, CompositeBaseSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DEFAULT_ARROW_SHAPE, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, GeneratorStepSchema, GradientStopSchema, HOLLOW_ARROW_SHAPES, JsonObjectSchema, JsonValueSchema, LabelDefaultSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeDefaultSchema, NodeLabelSchema, NodeSchema, NodeTargetSchema, OffsetPositionSchema, PATTERN_SHAPES, PaintSpecSchema, PathDefaultSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RectangleStepSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, ScopeSchema, ShapeRefSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, TransformSchema, ViewBoxSchema, circle, compileToScene, computeLayout, defineComposite, definePathGenerator, defineShape, diamond, ellipse, fallbackMeasurer, localToWorld, parseNodeTarget, parseTargetSugar, parseWay, point, polar, rect, worldToLocal };

package/dist/es/ir/boundary.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { ValueOf } from '../types';
+/** 连接面引用：保留字 'shape'/'circle' 或借用已注册 shape（裸名 / {type, params}） */
+export declare const BoundarySchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    type: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    params?: Record<string, import('./json').JsonValue> | undefined;
+}, {
+    type: string;
+    params?: Record<string, import('./json').JsonValue> | undefined;
+}>]>;
+/** 连接面引用类型（'shape' | 'circle' | 其它 shape 名 | {type, params}） */
+export type IRBoundary = z.infer<typeof BoundarySchema>;
+/** 连接面保留关键字：非「借用已注册 shape」的两个内置语义（编译期消解） */
+export declare const Boundary: {
+    /** 连接面 = 节点自身视觉形状（默认） */
+    readonly Self: "shape";
+    /** 真圆：半径 = 节点 AABB 较长半轴 max(halfWidth, halfHeight) */
+    readonly Circle: "circle";
+};
+/** 连接面保留关键字联合（'shape' | 'circle'；其余取值为借用的 shape 引用） */
+export type BoundaryKeyword = ValueOf<typeof Boundary>;
+//# sourceMappingURL=boundary.d.ts.map

package/dist/es/ir/boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/ir/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,mEAAmE;AACnE,eAAO,MAAM,cAAc;;;;;;;;;IAIxB,CAAC;AAEJ,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ;IACnB,yBAAyB;;IAEzB,sDAAsD;;CAE9C,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/es/ir/boundary.js

@@ -0,0 +1,14 @@
+import { ShapeRefSchema } from "./shape.js";
+import { z } from "zod";
+//#region src/ir/boundary.ts
+/** 连接面引用：保留字 'shape'/'circle' 或借用已注册 shape（裸名 / {type, params}） */
+var BoundarySchema = z.union([z.string().min(1), ShapeRefSchema]).describe("Connection surface: how edges meet this node and how compass anchors resolve, independent of the visual `shape`. Reserved keywords: \"shape\" (default — the node's own visual shape) and \"circle\" (true circle, radius = larger AABB half-axis). Any other registered shape name (\"rectangle\" / \"ellipse\" / \"polygon\" / …) or `{ type, params }` borrows that shape's boundary over this node's bounding box. Layout-neutral: never changes the node footprint. Named shape-specific anchors and edge proportional points always resolve against the visual shape.");
+/** 连接面保留关键字：非「借用已注册 shape」的两个内置语义（编译期消解） */
+var Boundary = {
+	/** 连接面 = 节点自身视觉形状（默认） */
+	Self: "shape",
+	/** 真圆：半径 = 节点 AABB 较长半轴 max(halfWidth, halfHeight) */
+	Circle: "circle"
+};
+//#endregion
+export { Boundary, BoundarySchema };

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

@@ -5,6 +5,8 @@ export * from './paint';
 export * from './clip';
 export * from './text';
 export * from './path';
+export * from './shape';
+export * from './boundary';
 export * from './node';
 export * from './coordinate';
 export * from './transform';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}