@esengine/ecs-framework-math 2.10.1 → 2.10.3

package/bin/MathUtils.d.ts

@@ -1,312 +0,0 @@
-import { Vector2 } from './Vector2';
-/**
- * 数学工具函数集合
- *
- * 提供常用的数学运算、插值、随机数生成等实用工具函数
- */
-export declare class MathUtils {
-    /** 圆周率 */
-    static readonly PI: number;
-    /** 2π */
-    static readonly TWO_PI: number;
-    /** π/2 */
-    static readonly HALF_PI: number;
-    /** π/4 */
-    static readonly QUARTER_PI: number;
-    /** 角度到弧度转换系数 */
-    static readonly DEG_TO_RAD: number;
-    /** 弧度到角度转换系数 */
-    static readonly RAD_TO_DEG: number;
-    /** 黄金比例 */
-    static readonly GOLDEN_RATIO: number;
-    /** 默认浮点数比较容差 */
-    static readonly EPSILON: number;
-    /**
-   * 角度转弧度
-   * @param degrees 角度值
-   * @returns 弧度值
-   */
-    static degToRad(degrees: number): number;
-    /**
-   * 弧度转角度
-   * @param radians 弧度值
-   * @returns 角度值
-   */
-    static radToDeg(radians: number): number;
-    /**
-   * 规范化角度到[0, 2π)范围
-   * @param radians 角度（弧度）
-   * @returns 规范化后的角度
-   */
-    static normalizeAngle(radians: number): number;
-    /**
-   * 规范化角度到(-π, π]范围
-   * @param radians 角度（弧度）
-   * @returns 规范化后的角度
-   */
-    static normalizeAngleSigned(radians: number): number;
-    /**
-   * 计算两个角度之间的最短角度差
-   * @param from 起始角度（弧度）
-   * @param to 目标角度（弧度）
-   * @returns 角度差（-π到π）
-   */
-    static angleDifference(from: number, to: number): number;
-    /**
-   * 角度插值（处理角度环绕）
-   * @param from 起始角度（弧度）
-   * @param to 目标角度（弧度）
-   * @param t 插值参数（0到1）
-   * @returns 插值结果角度
-   */
-    static lerpAngle(from: number, to: number, t: number): number;
-    /**
-   * 限制数值在指定范围内
-   * @param value 待限制的值
-   * @param min 最小值
-   * @param max 最大值
-   * @returns 限制后的值
-   */
-    static clamp(value: number, min: number, max: number): number;
-    /**
-   * 限制数值在0到1之间
-   * @param value 待限制的值
-   * @returns 限制后的值
-   */
-    static clamp01(value: number): number;
-    /**
-   * 线性插值
-   * @param a 起始值
-   * @param b 目标值
-   * @param t 插值参数（0到1）
-   * @returns 插值结果
-   */
-    static lerp(a: number, b: number, t: number): number;
-    /**
-   * 反向线性插值（获取插值参数）
-   * @param a 起始值
-   * @param b 目标值
-   * @param value 当前值
-   * @returns 插值参数
-   */
-    static inverseLerp(a: number, b: number, value: number): number;
-    /**
-   * 重映射数值从一个范围到另一个范围
-   * @param value 输入值
-   * @param inMin 输入范围最小值
-   * @param inMax 输入范围最大值
-   * @param outMin 输出范围最小值
-   * @param outMax 输出范围最大值
-   * @returns 重映射后的值
-   */
-    static remap(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
-    /**
-   * 平滑阶跃函数（Hermite插值）
-   * @param t 输入参数（0到1）
-   * @returns 平滑输出（0到1）
-   */
-    static smoothStep(t: number): number;
-    /**
-   * 更平滑的阶跃函数
-   * @param t 输入参数（0到1）
-   * @returns 平滑输出（0到1）
-   */
-    static smootherStep(t: number): number;
-    /**
-   * 浮点数相等比较
-   * @param a 数值a
-   * @param b 数值b
-   * @param epsilon 容差，默认为EPSILON
-   * @returns 是否相等
-   */
-    static approximately(a: number, b: number, epsilon?: number): boolean;
-    /**
-   * 检查数值是否为零
-   * @param value 数值
-   * @param epsilon 容差，默认为EPSILON
-   * @returns 是否为零
-   */
-    static isZero(value: number, epsilon?: number): boolean;
-    /**
-   * 获取数值的符号
-   * @param value 数值
-   * @returns 1、-1或0
-   */
-    static sign(value: number): number;
-    /**
-   * 生成指定范围内的随机数
-   * @param min 最小值（包含）
-   * @param max 最大值（不包含）
-   * @returns 随机数
-   */
-    static random(min?: number, max?: number): number;
-    /**
-   * 生成指定范围内的随机整数
-   * @param min 最小值（包含）
-   * @param max 最大值（包含）
-   * @returns 随机整数
-   */
-    static randomInt(min: number, max: number): number;
-    /**
-   * 随机选择数组中的一个元素
-   * @param array 数组
-   * @returns 随机元素
-   */
-    static randomChoice<T>(array: T[]): T;
-    /**
-   * 生成随机布尔值
-   * @param probability 为true的概率（0到1），默认0.5
-   * @returns 随机布尔值
-   */
-    static randomBoolean(probability?: number): boolean;
-    /**
-   * 生成单位圆内的随机点
-   * @returns 随机向量
-   */
-    static randomInUnitCircle(): Vector2;
-    /**
-   * 生成单位圆上的随机点
-   * @returns 随机单位向量
-   */
-    static randomOnUnitCircle(): Vector2;
-    /**
-   * 快速平方根倒数（用于归一化）
-   * @param value 输入值
-   * @returns 平方根倒数
-   */
-    static fastInverseSqrt(value: number): number;
-    /**
-   * 快速幂运算（整数指数）
-   * @param base 底数
-   * @param exponent 指数（整数）
-   * @returns 幂运算结果
-   */
-    static fastPow(base: number, exponent: number): number;
-    /**
-   * 阶乘
-   * @param n 非负整数
-   * @returns 阶乘结果
-   */
-    static factorial(n: number): number;
-    /**
-   * 最大公约数
-   * @param a 整数a
-   * @param b 整数b
-   * @returns 最大公约数
-   */
-    static gcd(a: number, b: number): number;
-    /**
-   * 最小公倍数
-   * @param a 整数a
-   * @param b 整数b
-   * @returns 最小公倍数
-   */
-    static lcm(a: number, b: number): number;
-    /**
-   * 斐波那契数列
-   * @param n 项数
-   * @returns 第n项斐波那契数
-   */
-    static fibonacci(n: number): number;
-    /**
-   * 等差数列求和
-   * @param first 首项
-   * @param last 末项
-   * @param count 项数
-   * @returns 等差数列和
-   */
-    static arithmeticSum(first: number, last: number, count: number): number;
-    /**
-   * 等比数列求和
-   * @param first 首项
-   * @param ratio 公比
-   * @param count 项数
-   * @returns 等比数列和
-   */
-    static geometricSum(first: number, ratio: number, count: number): number;
-    /**
-   * 贝塞尔二次曲线
-   * @param p0 控制点0
-   * @param p1 控制点1
-   * @param p2 控制点2
-   * @param t 参数（0到1）
-   * @returns 曲线上的点
-   */
-    static quadraticBezier(p0: Vector2, p1: Vector2, p2: Vector2, t: number): Vector2;
-    /**
-   * 贝塞尔三次曲线
-   * @param p0 控制点0
-   * @param p1 控制点1
-   * @param p2 控制点2
-   * @param p3 控制点3
-   * @param t 参数（0到1）
-   * @returns 曲线上的点
-   */
-    static cubicBezier(p0: Vector2, p1: Vector2, p2: Vector2, p3: Vector2, t: number): Vector2;
-    /**
-   * Catmull-Rom样条插值
-   * @param p0 控制点0
-   * @param p1 控制点1
-   * @param p2 控制点2
-   * @param p3 控制点3
-   * @param t 参数（0到1）
-   * @returns 插值结果点
-   */
-    static catmullRom(p0: Vector2, p1: Vector2, p2: Vector2, p3: Vector2, t: number): Vector2;
-    /**
-   * 简单伪随机噪声（基于种子）
-   * @param x 输入X
-   * @param y 输入Y
-   * @param seed 种子
-   * @returns 噪声值（0到1）
-   */
-    static noise(x: number, y?: number, seed?: number): number;
-    /**
-   * 平滑噪声
-   * @param x 输入X
-   * @param y 输入Y
-   * @param seed 种子
-   * @returns 平滑噪声值（0到1）
-   */
-    static smoothNoise(x: number, y?: number, seed?: number): number;
-    /**
-   * 将数值转换为指定精度
-   * @param value 数值
-   * @param precision 精度（小数位数）
-   * @returns 转换后的数值
-   */
-    static toPrecision(value: number, precision: number): number;
-    /**
-   * 检查数值是否在指定范围内
-   * @param value 数值
-   * @param min 最小值
-   * @param max 最大值
-   * @returns 是否在范围内
-   */
-    static inRange(value: number, min: number, max: number): boolean;
-    /**
-   * 获取数组中的最小值
-   * @param values 数值数组
-   * @returns 最小值
-   */
-    static min(...values: number[]): number;
-    /**
-   * 获取数组中的最大值
-   * @param values 数值数组
-   * @returns 最大值
-   */
-    static max(...values: number[]): number;
-    /**
-   * 计算数组的平均值
-   * @param values 数值数组
-   * @returns 平均值
-   */
-    static average(values: number[]): number;
-    /**
-   * 计算数组的中位数
-   * @param values 数值数组
-   * @returns 中位数
-   */
-    static median(values: number[]): number;
-}
-//# sourceMappingURL=MathUtils.d.ts.map

package/bin/MathUtils.d.ts.map

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