@retikz/core 0.3.0-beta.2 → 0.4.0-alpha.1

package/dist/lib/geometry/arc.cjs

@@ -1,113 +0,0 @@
-//#region src/geometry/arc.ts
-var DEG_TO_RAD = Math.PI / 180;
-/**
-* 在 [lo, hi] 内枚举所有 90°·k 方向角（弧轴向极值候选）
-* @description 一圈最多 4 个轴向，合法弧 sweep ≤ 360° → 至多 5 个 90°·k；正常区间直接 for 扫。
-*   但 lo/hi 为巨型角度（如 1e308）时 k=ceil(lo/90) 落在浮点无整数分辨率区，`k++` 满足 k+1===k →
-*   for 循环永不前进而挂死（DoS）。此时端点投影已覆盖全部 x/y 极值（巨角下弧实际是退化点 / 单端），
-*   轴向点无新增信息 → 直接跳过枚举。守卫：仅当 kEnd−kStart 是 finite 且 ≤ 安全上界（远大于
-*   任何合法弧的轴向点数）时才枚举，否则返回空（端点已足够定界）。
-*/
-var axisAngles = (lo, hi) => {
-	const kStart = Math.ceil(lo / 90);
-	const kEnd = Math.floor(hi / 90);
-	const span = kEnd - kStart;
-	if (!Number.isFinite(span) || span < 0 || span > 1e6) return [];
-	const angles = [];
-	for (let k = kStart; k <= kEnd; k++) angles.push(k * 90);
-	return angles;
-};
-/** 圆心、半径、角度（度，与 polar.toPosition 同约定）→ 圆周上对应点 */
-var arcEndPoint = (center, radius, angleDeg) => {
-	const rad = angleDeg * DEG_TO_RAD;
-	return [center[0] + Math.cos(rad) * radius, center[1] + Math.sin(rad) * radius];
-};
-/**
-* 弧的 bbox 极值候选：起点、终点，加 [startAngle,endAngle] 内所有 90°·k 方向的圆周点
-* @description 弧投影到 x/y 轴的极值只可能在弧端点或圆周轴向四点出现。endAngle < startAngle 时按 min..max 扫描；跨 360°（270→450）按数值区间正确处理；不去重——端角恰在 90°·k 上时调用方处理
-*/
-var arcBoundingPoints = (center, radius, startAngleDeg, endAngleDeg) => {
-	const points = [arcEndPoint(center, radius, startAngleDeg), arcEndPoint(center, radius, endAngleDeg)];
-	const lo = Math.min(startAngleDeg, endAngleDeg);
-	const hi = Math.max(startAngleDeg, endAngleDeg);
-	for (const angle of axisAngles(lo, hi)) {
-		if (angle === startAngleDeg || angle === endAngleDeg) continue;
-		points.push(arcEndPoint(center, radius, angle));
-	}
-	return points;
-};
-/** 角度（度）→ 规范化到 [0, 360) */
-var normalizeDeg = (deg) => {
-	const m = deg % 360;
-	return m < 0 ? m + 360 : m;
-};
-/**
-* 角度 a（度）是否落在弧的角度区间 [startAngle, endAngle] 内（含端点，带容差）
-* @description 与 ir/path arc 同约定：弧从 startAngle 扫到 endAngle，counterClockwise=false（缺省）
-*   时角度递增（屏幕顺时针）、true 时角度递减（逆时针）。统一把扫描量化为「从 start 出发、沿扫描方向
-*   累积的非负 sweep ∈ [0, |span|]」判定，跨 360°、负角、巨型角都正确（不死循环）。
-*/
-var arcAngleInRange = (startAngleDeg, endAngleDeg, angleDeg, toleranceDeg = 1e-7) => {
-	const span = endAngleDeg - startAngleDeg;
-	const total = Math.abs(span);
-	if (total >= 360 - toleranceDeg) return true;
-	const swept = normalizeDeg(span < 0 ? startAngleDeg - angleDeg : angleDeg - startAngleDeg);
-	return swept <= total + toleranceDeg || swept >= 360 - toleranceDeg;
-};
-/**
-* 射线（origin + 单位方向 dir）∩ 圆弧（center, radius, [startAngle, endAngle]）
-* @description 泛化 sector 的内联 rayCircle：先解 |origin + s·dir|² = radius² 得至多两个参数 s，
-*   再用 arcAngleInRange 过滤掉不在弧角度区间内的交点。返回沿射线的正向参数 s（命中点 = origin + s·dir），
-*   按 s 升序、仅含 s > tolerance 的正向交点；不在区间内的根被剔除。dir 必须为单位向量。
-*/
-var rayArc = (origin, dir, center, radius, startAngleDeg, endAngleDeg, tolerance = 1e-9) => {
-	const ox = origin[0] - center[0];
-	const oy = origin[1] - center[1];
-	const ux = dir[0];
-	const uy = dir[1];
-	const b = 2 * (ox * ux + oy * uy);
-	const c = ox * ox + oy * oy - radius * radius;
-	const disc = b * b - 4 * c;
-	if (disc < 0) return [];
-	const sq = Math.sqrt(disc);
-	const roots = [(-b - sq) / 2, (-b + sq) / 2];
-	const hits = [];
-	for (const s of roots) {
-		if (s <= tolerance) continue;
-		const px = ox + s * ux;
-		const py = oy + s * uy;
-		if (arcAngleInRange(startAngleDeg, endAngleDeg, Math.atan2(py, px) * (180 / Math.PI))) hits.push(s);
-	}
-	hits.sort((a, z) => a - z);
-	return hits;
-};
-/**
-* 椭圆弧参数点：中心 + 半轴 rx/ry + 参数角（度）→ 椭圆周上点
-* @description 与 arcEndPoint 同角度约定（SVG y-down）；endpoint = [cx + rx·cosθ, cy + ry·sinθ]。
-*   θ 是参数角（非真实极角，rx≠ry 时两者不等）
-*/
-var ellipseArcPoint = (center, radiusX, radiusY, angleDeg) => {
-	const rad = angleDeg * DEG_TO_RAD;
-	return [center[0] + Math.cos(rad) * radiusX, center[1] + Math.sin(rad) * radiusY];
-};
-/**
-* 椭圆弧 bbox 极值候选：起点、终点，加 [start,end] 区间内所有 90°·k 参数角处的椭圆周点
-* @description 轴对齐椭圆的 x 极值在 θ=0/180、y 极值在 θ=90/270，与正圆同结构（仅半轴用 rx/ry）
-*/
-var ellipseArcBoundingPoints = (center, radiusX, radiusY, startAngleDeg, endAngleDeg) => {
-	const points = [ellipseArcPoint(center, radiusX, radiusY, startAngleDeg), ellipseArcPoint(center, radiusX, radiusY, endAngleDeg)];
-	const lo = Math.min(startAngleDeg, endAngleDeg);
-	const hi = Math.max(startAngleDeg, endAngleDeg);
-	for (const angle of axisAngles(lo, hi)) {
-		if (angle === startAngleDeg || angle === endAngleDeg) continue;
-		points.push(ellipseArcPoint(center, radiusX, radiusY, angle));
-	}
-	return points;
-};
-//#endregion
-exports.arcAngleInRange = arcAngleInRange;
-exports.arcBoundingPoints = arcBoundingPoints;
-exports.arcEndPoint = arcEndPoint;
-exports.ellipseArcBoundingPoints = ellipseArcBoundingPoints;
-exports.ellipseArcPoint = ellipseArcPoint;
-exports.rayArc = rayArc;

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

@@ -1,34 +0,0 @@
-import { Position } from './point';
-/** 圆心、半径、角度（度，与 polar.toPosition 同约定）→ 圆周上对应点 */
-export declare const arcEndPoint: (center: Position, radius: number, angleDeg: number) => Position;
-/**
- * 弧的 bbox 极值候选：起点、终点，加 [startAngle,endAngle] 内所有 90°·k 方向的圆周点
- * @description 弧投影到 x/y 轴的极值只可能在弧端点或圆周轴向四点出现。endAngle < startAngle 时按 min..max 扫描；跨 360°（270→450）按数值区间正确处理；不去重——端角恰在 90°·k 上时调用方处理
- */
-export declare const arcBoundingPoints: (center: Position, radius: number, startAngleDeg: number, endAngleDeg: number) => Array<Position>;
-/**
- * 角度 a（度）是否落在弧的角度区间 [startAngle, endAngle] 内（含端点，带容差）
- * @description 与 ir/path arc 同约定：弧从 startAngle 扫到 endAngle，counterClockwise=false（缺省）
- *   时角度递增（屏幕顺时针）、true 时角度递减（逆时针）。统一把扫描量化为「从 start 出发、沿扫描方向
- *   累积的非负 sweep ∈ [0, |span|]」判定，跨 360°、负角、巨型角都正确（不死循环）。
- */
-export declare const arcAngleInRange: (startAngleDeg: number, endAngleDeg: number, angleDeg: number, toleranceDeg?: number) => boolean;
-/**
- * 射线（origin + 单位方向 dir）∩ 圆弧（center, radius, [startAngle, endAngle]）
- * @description 泛化 sector 的内联 rayCircle：先解 |origin + s·dir|² = radius² 得至多两个参数 s，
- *   再用 arcAngleInRange 过滤掉不在弧角度区间内的交点。返回沿射线的正向参数 s（命中点 = origin + s·dir），
- *   按 s 升序、仅含 s > tolerance 的正向交点；不在区间内的根被剔除。dir 必须为单位向量。
- */
-export declare const rayArc: (origin: Position, dir: Position, center: Position, radius: number, startAngleDeg: number, endAngleDeg: number, tolerance?: number) => Array<number>;
-/**
- * 椭圆弧参数点：中心 + 半轴 rx/ry + 参数角（度）→ 椭圆周上点
- * @description 与 arcEndPoint 同角度约定（SVG y-down）；endpoint = [cx + rx·cosθ, cy + ry·sinθ]。
- *   θ 是参数角（非真实极角，rx≠ry 时两者不等）
- */
-export declare const ellipseArcPoint: (center: Position, radiusX: number, radiusY: number, angleDeg: number) => Position;
-/**
- * 椭圆弧 bbox 极值候选：起点、终点，加 [start,end] 区间内所有 90°·k 参数角处的椭圆周点
- * @description 轴对齐椭圆的 x 极值在 θ=0/180、y 极值在 θ=90/270，与正圆同结构（仅半轴用 rx/ry）
- */
-export declare const ellipseArcBoundingPoints: (center: Position, radiusX: number, radiusY: number, startAngleDeg: number, endAngleDeg: number) => Array<Position>;
-//# sourceMappingURL=arc.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"arc.d.ts","sourceRoot":"","sources":["../../../src/geometry/arc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA8BxC,iDAAiD;AACjD,eAAO,MAAM,WAAW,GACtB,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAchB,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,UAAU,MAAM,EAChB,qBAAmB,KAClB,OASF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GACjB,QAAQ,QAAQ,EAChB,KAAK,QAAQ,EACb,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,kBAAgB,KACf,KAAK,CAAC,MAAM,CAuBd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,QAAQ,EAChB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,UAAU,MAAM,KACf,QAMF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,QAAQ,EAChB,SAAS,MAAM,EACf,SAAS,MAAM,EACf,eAAe,MAAM,EACrB,aAAa,MAAM,KAClB,KAAK,CAAC,QAAQ,CAYhB,CAAC"}

package/dist/lib/geometry/point.cjs

@@ -1,50 +0,0 @@
-const require_polar = require("./polar.cjs");
-//#region src/geometry/point.ts
-var RAD_TO_DEG = 180 / Math.PI;
-var DEFAULT_EPSILON = 1e-9;
-/** 二维向量 / 坐标的基础运算工具集 */
-var point = {
-	/** 向量加 a + b */
-	add: (a, b) => [a[0] + b[0], a[1] + b[1]],
-	/** 向量减 a - b */
-	sub: (a, b) => [a[0] - b[0], a[1] - b[1]],
-	/** 等比缩放 a * k */
-	scale: (a, k) => [a[0] * k, a[1] * k],
-	/** 向量长度 */
-	length: (a) => Math.hypot(a[0], a[1]),
-	/** 归一化向量；零长度 / 极短向量回退到 fallback */
-	normalize: (a, fallback = [1, 0], epsilon = DEFAULT_EPSILON) => {
-		const len = Math.hypot(a[0], a[1]);
-		if (len < epsilon) return fallback;
-		return [a[0] / len, a[1] / len];
-	},
-	/** 把点 p 沿 target 方向移动 dist */
-	shiftToward: (p, target, dist) => {
-		if (dist === 0) return p;
-		const delta = [target[0] - p[0], target[1] - p[1]];
-		const dir = point.normalize(delta, [0, 0]);
-		if (point.equal(dir, [0, 0])) return p;
-		return [p[0] + dir[0] * dist, p[1] + dir[1] * dist];
-	},
-	/** 两点精确相等（不带容差） */
-	equal: (a, b) => a[0] === b[0] && a[1] === b[1],
-	/** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */
-	toPolar: (p) => ({
-		angle: Math.atan2(p[1], p[0]) * RAD_TO_DEG,
-		radius: Math.hypot(p[0], p[1])
-	}),
-	/**
-	* 跨坐标系两点相同判断（笛卡尔或 PolarPosition）
-	* @description 极坐标先转笛卡尔再按 precision 四舍五入比较；polar.equal 委托到本方法
-	* @param precision 小数点后位数；默认 2
-	* @throws 当 PolarPosition.origin 是节点 id 字符串时（需 Scene 上下文）
-	*/
-	equalPolar: (a, b, precision = 2) => {
-		const aCart = Array.isArray(a) ? a : require_polar.polar.toPosition(a);
-		const bCart = Array.isArray(b) ? b : require_polar.polar.toPosition(b);
-		const factor = 10 ** precision;
-		return Math.round(aCart[0] * factor) === Math.round(bCart[0] * factor) && Math.round(aCart[1] * factor) === Math.round(bCart[1] * factor);
-	}
-};
-//#endregion
-exports.point = point;

package/dist/lib/geometry/transform.cjs

@@ -1,28 +0,0 @@
-//#region src/geometry/transform.ts
-/**
-* 本地坐标（以中心为原点）→ 世界坐标
-* @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移
-*/
-var localToWorld = (s, local) => {
-	const angle = s.rotate ?? 0;
-	if (angle === 0) return [s.x + local[0], s.y + local[1]];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [s.x + local[0] * cos - local[1] * sin, s.y + local[0] * sin + local[1] * cos];
-};
-/**
-* 世界坐标 → 本地坐标（`localToWorld` 逆变换）
-* @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
-*/
-var worldToLocal = (s, world) => {
-	const tx = world[0] - s.x;
-	const ty = world[1] - s.y;
-	const angle = s.rotate ?? 0;
-	if (angle === 0) return [tx, ty];
-	const cos = Math.cos(angle);
-	const sin = Math.sin(angle);
-	return [tx * cos + ty * sin, -tx * sin + ty * cos];
-};
-//#endregion
-exports.localToWorld = localToWorld;
-exports.worldToLocal = worldToLocal;