feat:更新core 和首页代码

miniprogram/core/utils/math-utils.ts

@@ -0,0 +1,79 @@
+/**
+ * 纯数学工具（无随机、无平台依赖），供 generators / 模板引擎使用
+ */
+
+/** 将数值限制在 [min, max] */
+export function clamp(value: number, min: number, max: number): number {
+    return Math.min(max, Math.max(min, value));
+}
+
+/** 最大公约数（非负整数） */
+export function gcd(a: number, b: number): number {
+    let x = Math.abs(Math.trunc(a));
+    let y = Math.abs(Math.trunc(b));
+    while (y !== 0) {
+        const t = y;
+        y = x % y;
+        x = t;
+    }
+    return x || 1;
+}
+
+/** 最小公倍数 */
+export function lcm(a: number, b: number): number {
+    const g = gcd(a, b);
+    return Math.abs(Math.trunc(a) * Math.trunc(b)) / g;
+}
+
+/** 闭区间 [min, max] 上的整数列表 */
+export function integerRangeInclusive(min: number, max: number): number[] {
+    const lo = Math.min(min, max);
+    const hi = Math.max(min, max);
+    const out: number[] = [];
+    for (let i = lo; i <= hi; i += 1) {
+        out.push(i);
+    }
+    return out;
+}
+
+/** 数组求和 */
+export function sum(numbers: readonly number[]): number {
+    let s = 0;
+    for (let i = 0; i < numbers.length; i += 1) {
+        s += numbers[i];
+    }
+    return s;
+}
+
+/** 算术平均（空数组为 0） */
+export function mean(numbers: readonly number[]): number {
+    if (numbers.length === 0) return 0;
+    return sum(numbers) / numbers.length;
+}
+
+/** 各位数字之和（十进制，忽略负号） */
+export function digitSum(n: number): number {
+    let v = Math.abs(Math.trunc(n));
+    let s = 0;
+    while (v > 0) {
+        s += v % 10;
+        v = Math.floor(v / 10);
+    }
+    return s;
+}
+
+export function isEven(n: number): boolean {
+    return n % 2 === 0;
+}
+
+export function isOdd(n: number): boolean {
+    return !isEven(n);
+}
+
+/**
+ * 将浮点数舍入到指定小数位（避免 0.1+0.2 展示问题）
+ */
+export function roundToDecimals(value: number, decimals: number): number {
+    const p = 10 ** decimals;
+    return Math.round(value * p) / p;
+}