@gitlon/math 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Long
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,210 @@
+# @gitlon/math
+
+防精度丢失的十进制四则运算工具。适合金额、数量、比例等不能直接依赖 JavaScript 浮点运算的场景。
+
+## 安装
+
+```bash
+pnpm add @gitlon/math
+```
+
+也可安装聚合包：
+
+```bash
+pnpm add gitlon
+```
+
+## 导入
+
+直接使用子包：
+
+```ts
+import { add, divide, multiply, round, subtract, toFixed } from '@gitlon/math'
+```
+
+通过主包使用：
+
+```ts
+import { add, divide, toFixed } from 'gitlon'
+```
+
+## 基础用法
+
+```ts
+add(0.1, 0.2)       // 0.3
+subtract(0.3, 0.1)  // 0.2
+multiply(0.1, 0.2)  // 0.02
+divide(0.3, 0.1)    // 3
+
+round(1.005, 2)     // 1.01
+toFixed(1.2, 2)      // '1.20'
+```
+
+函数内部按十进制字符串拆分为整数系数和小数位，再进行计算，避免常见浮点误差：
+
+```ts
+0.1 + 0.2             // 0.30000000000000004
+add(0.1, 0.2)         // 0.3
+
+0.3 / 0.1             // 2.9999999999999996
+// divide(0.3, 0.1)   // 3
+```
+
+## 类型
+
+```ts
+type Numeric = number | string
+```
+
+所有函数均接受 `number` 或 `string`：
+
+```ts
+add('0.1', '0.2') // 0.3
+multiply('12.5', 2) // 25
+```
+
+- 空字符串、空白字符串、非法数字字符串返回 `NaN`。
+- 四则运算结果为 `number`。
+- `toFixed` 结果为 `string`。
+- 不抛出输入错误异常，可使用 `Number.isNaN()` 判断失败。
+
+## 加法
+
+```ts
+function add(...values: Numeric[]): number
+const plus: typeof add
+```
+
+```ts
+add(0.1, 0.2)       // 0.3
+add(1, 2, 3)        // 6
+add('10.50', 0.25)  // 10.75
+add()               // 0
+add('invalid', 1)   // NaN
+```
+
+`plus` 是 `add` 的别名：
+
+```ts
+import { plus } from '@gitlon/math'
+
+plus(0.1, 0.2) // 0.3
+```
+
+## 减法
+
+```ts
+function subtract(...values: Numeric[]): number
+const minus: typeof subtract
+```
+
+从左到右计算：
+
+```ts
+subtract(10, 2, 3) // 5
+subtract('1.00', 0.1) // 0.9
+subtract(10)       // 10
+subtract()         // NaN
+```
+
+`minus` 是 `subtract` 的别名。
+
+## 乘法
+
+```ts
+function multiply(...values: Numeric[]): number
+const times: typeof multiply
+```
+
+从左到右计算：
+
+```ts
+multiply(2, 3, 4)   // 24
+multiply(0.1, 0.2)  // 0.02
+multiply('1.25', 8) // 10
+multiply()          // 1
+```
+
+`times` 是 `multiply` 的别名。
+
+## 除法
+
+```ts
+function divide(...values: Numeric[]): number
+```
+
+从左到右计算：
+
+```ts
+divide(100, 2, 5) // 10
+divide(0.3, 0.1)  // 3
+divide(1, 3)      // 0.3333333333333333
+divide(10)        // 10
+divide()          // NaN
+divide(10, 0)     // NaN
+```
+
+除数为零、参数为空或任意参数非法时返回 `NaN`。
+
+## 舍入
+
+```ts
+function round(value: Numeric, decimals?: number): number
+```
+
+使用十进制四舍五入，默认保留 0 位：
+
+```ts
+round(1.005, 2)   // 1.01
+round(1.234, 2)   // 1.23
+round(-1.005, 2)  // -1.01
+round(12.5)       // 13
+round(1.234, -1)  // 1
+round('invalid')  // NaN
+```
+
+`decimals` 会向下取整；负数按 `0` 处理。
+
+## 固定小数位
+
+```ts
+function toFixed(value: Numeric, decimals?: number): string
+```
+
+返回字符串，保留指定小数位：
+
+```ts
+toFixed(1.005, 2)    // '1.01'
+toFixed(1.2, 2)       // '1.20'
+toFixed(12.5)         // '13'
+toFixed(12.5, 3)      // '12.500'
+toFixed('invalid', 2) // ''
+```
+
+与 `Number.prototype.toFixed` 不同，先进行十进制四舍五入，避免 `1.005.toFixed(2)` 这类浮点误差。
+
+## 多参数规则
+
+四则运算支持两个或多个参数，均从左到右计算：
+
+```ts
+add(a, b, c)       // (a + b) + c
+subtract(a, b, c)  // (a - b) - c
+multiply(a, b, c)  // (a * b) * c
+divide(a, b, c)    // (a / b) / c
+```
+
+| 函数 | 无参数结果 |
+| --- | --- |
+| `add` | `0` |
+| `subtract` | `NaN` |
+| `multiply` | `1` |
+| `divide` | `NaN` |
+
+## 边界行为
+
+- 输入支持普通十进制、负数、小数和科学计数法字符串。
+- 非法字符串、空字符串、空白字符串返回 `NaN`；`toFixed` 返回 `''`。
+- 除零返回 `NaN`。
+- 运算最终仍返回 JavaScript `number`，超出 `number` 可表示范围时遵循 JavaScript 数值限制。
+- 需要保留尾零时使用 `toFixed`，不要使用返回 `number` 的 `round`。

package/dist/index.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){if(typeof e==`string`&&e.trim()===``)return;let t=String(e).trim();if(!/^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i.test(t))return;let[n,r]=t.toLowerCase().split(`e`),i=Number(r??0);if(!Number.isFinite(Number(t))||Math.abs(i)>1e3)return;let a=n.startsWith(`-`)?-1n:1n,[o,s=``]=n.replace(/^[+-]/,``).split(`.`),c=`${o}${s}`.replace(/^0+(?=\d)/,``)||`0`,l=s.length-i,u=a*BigInt(c);return l>=0?{coefficient:u,scale:l}:{coefficient:u*10n**BigInt(-l),scale:0}}function t(t){let n=t.map(e);return n.every(e=>e!==void 0)?n:void 0}function n(e,t){let n=Math.max(e.scale,t.scale);return[e.coefficient*10n**BigInt(n-e.scale),t.coefficient*10n**BigInt(n-t.scale),n]}function r(e,t=e.scale){let n=e.coefficient<0n?`-`:``,r=(e.coefficient<0n?-e.coefficient:e.coefficient).toString(),i=Math.max(0,t),a=r.padStart(i+1,`0`),o=a.length-i,s=a.slice(0,o),c=a.slice(o).replace(/0+$/,``);return`${n}${s}${c?`.${c}`:``}`}function i(e){return Number(r(e))}function a(e,t){let[r,i,a]=n(e,t);return{coefficient:r+i,scale:a}}function o(e,t){let[r,i,a]=n(e,t);return{coefficient:r-i,scale:a}}function s(e,t){return{coefficient:e.coefficient*t.coefficient,scale:e.scale+t.scale}}function c(...e){if(e.length===0)return 0;let n=t(e);return n?i(n.reduce(a)):NaN}var l=c;function u(...e){if(e.length===0)return NaN;let n=t(e);return n?i(n.slice(1).reduce(o,n[0])):NaN}var d=u;function f(...e){if(e.length===0)return 1;let n=t(e);return n?i(n.reduce(s)):NaN}var p=f;function m(...e){if(e.length===0)return NaN;let n=t(e);if(!n||n.some((e,t)=>t>0&&e.coefficient===0n))return NaN;let r=n[0];for(let e of n.slice(1)){let t=r.coefficient<0n==e.coefficient<0n?1n:-1n,n=r.coefficient<0n?-r.coefficient:r.coefficient,i=e.coefficient<0n?-e.coefficient:e.coefficient,a=20+e.scale-r.scale;r={coefficient:t*((a>=0?n*10n**BigInt(a):n/10n**BigInt(-a))/i),scale:20}}return i(r)}function h(e){return Number.isFinite(e)?Math.max(0,Math.floor(e)):0}function g(e,t){if(e.scale<=t)return{coefficient:e.coefficient*10n**BigInt(t-e.scale),scale:t};let n=10n**BigInt(e.scale-t),r=e.coefficient/n;return{coefficient:(e.coefficient<0n?-e.coefficient%n:e.coefficient%n)*2n>=n?r+(e.coefficient<0n?-1n:1n):r,scale:t}}function _(t,n=0){let r=e(t);return r?i(g(r,h(n))):NaN}function v(t,n=0){let r=e(t);if(!r)return``;let i=h(n),a=g(r,i),o=a.coefficient<0n?`-`:``,s=(a.coefficient<0n?-a.coefficient:a.coefficient).toString().padStart(i+1,`0`);if(i===0)return`${o}${s}`;let c=s.length-i;return`${o}${s.slice(0,c)}.${s.slice(c)}`}exports.add=c,exports.divide=m,exports.minus=d,exports.multiply=f,exports.plus=l,exports.round=_,exports.subtract=u,exports.times=p,exports.toFixed=v;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type Numeric = number | string\n\ntype Decimal = {\n  coefficient: bigint\n  scale: number\n}\n\nfunction parseDecimal(value: Numeric): Decimal | undefined {\n  if (typeof value === 'string' && value.trim() === '') return undefined\n\n  const text = String(value).trim()\n  if (!/^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:e[+-]?\\d+)?$/i.test(text)) return undefined\n\n  const [base, exponentText] = text.toLowerCase().split('e')\n  const exponent = Number(exponentText ?? 0)\n  if (!Number.isFinite(Number(text)) || Math.abs(exponent) > 1000) return undefined\n  const sign = base.startsWith('-') ? -1n : 1n\n  const unsigned = base.replace(/^[+-]/, '')\n  const [integer, fraction = ''] = unsigned.split('.')\n  const digits = `${integer}${fraction}`.replace(/^0+(?=\\d)/, '') || '0'\n  const scale = fraction.length - exponent\n  const coefficient = sign * BigInt(digits)\n\n  if (scale >= 0) return { coefficient, scale }\n  return { coefficient: coefficient * 10n ** BigInt(-scale), scale: 0 }\n}\n\nfunction parseValues(values: Numeric[]): Decimal[] | undefined {\n  const decimals = values.map(parseDecimal)\n  return decimals.every((value): value is Decimal => value !== undefined) ? decimals : undefined\n}\n\nfunction align(left: Decimal, right: Decimal): [bigint, bigint, number] {\n  const scale = Math.max(left.scale, right.scale)\n  return [\n    left.coefficient * 10n ** BigInt(scale - left.scale),\n    right.coefficient * 10n ** BigInt(scale - right.scale),\n    scale,\n  ]\n}\n\nfunction decimalToString(value: Decimal, fixedScale = value.scale): string {\n  const sign = value.coefficient < 0n ? '-' : ''\n  const digits = (value.coefficient < 0n ? -value.coefficient : value.coefficient).toString()\n  const scale = Math.max(0, fixedScale)\n  const padded = digits.padStart(scale + 1, '0')\n  const point = padded.length - scale\n  const integer = padded.slice(0, point)\n  const fraction = padded.slice(point).replace(/0+$/, '')\n  return `${sign}${integer}${fraction ? `.${fraction}` : ''}`\n}\n\nfunction decimalToNumber(value: Decimal): number {\n  return Number(decimalToString(value))\n}\n\nfunction addDecimals(left: Decimal, right: Decimal): Decimal {\n  const [leftCoefficient, rightCoefficient, scale] = align(left, right)\n  return { coefficient: leftCoefficient + rightCoefficient, scale }\n}\n\nfunction subtractDecimals(left: Decimal, right: Decimal): Decimal {\n  const [leftCoefficient, rightCoefficient, scale] = align(left, right)\n  return { coefficient: leftCoefficient - rightCoefficient, scale }\n}\n\nfunction multiplyDecimals(left: Decimal, right: Decimal): Decimal {\n  return {\n    coefficient: left.coefficient * right.coefficient,\n    scale: left.scale + right.scale,\n  }\n}\n\nexport function add(...values: Numeric[]): number {\n  if (values.length === 0) return 0\n  const decimals = parseValues(values)\n  if (!decimals) return Number.NaN\n  return decimalToNumber(decimals.reduce(addDecimals))\n}\n\nexport const plus = add\n\nexport function subtract(...values: Numeric[]): number {\n  if (values.length === 0) return Number.NaN\n  const decimals = parseValues(values)\n  if (!decimals) return Number.NaN\n  return decimalToNumber(decimals.slice(1).reduce(subtractDecimals, decimals[0]))\n}\n\nexport const minus = subtract\n\nexport function multiply(...values: Numeric[]): number {\n  if (values.length === 0) return 1\n  const decimals = parseValues(values)\n  if (!decimals) return Number.NaN\n  return decimalToNumber(decimals.reduce(multiplyDecimals))\n}\n\nexport const times = multiply\n\nexport function divide(...values: Numeric[]): number {\n  if (values.length === 0) return Number.NaN\n  const decimals = parseValues(values)\n  if (!decimals || decimals.some((value, index) => index > 0 && value.coefficient === 0n)) {\n    return Number.NaN\n  }\n\n  let result = decimals[0]\n  for (const divisor of decimals.slice(1)) {\n    const sameSign = (result.coefficient < 0n) === (divisor.coefficient < 0n)\n    const sign = sameSign ? 1n : -1n\n    const dividend = result.coefficient < 0n ? -result.coefficient : result.coefficient\n    const divisorCoefficient = divisor.coefficient < 0n ? -divisor.coefficient : divisor.coefficient\n    const scale = 20 + divisor.scale - result.scale\n    const scaledDividend = scale >= 0 ? dividend * 10n ** BigInt(scale) : dividend / 10n ** BigInt(-scale)\n    const quotient = scaledDividend / divisorCoefficient\n    result = { coefficient: sign * quotient, scale: 20 }\n  }\n\n  return decimalToNumber(result)\n}\n\nfunction normalizeDecimals(decimals: number): number {\n  return Number.isFinite(decimals) ? Math.max(0, Math.floor(decimals)) : 0\n}\n\nfunction roundDecimal(decimal: Decimal, targetScale: number): Decimal {\n  if (decimal.scale <= targetScale) {\n    return {\n      coefficient: decimal.coefficient * 10n ** BigInt(targetScale - decimal.scale),\n      scale: targetScale,\n    }\n  }\n\n  const divisor = 10n ** BigInt(decimal.scale - targetScale)\n  const quotient = decimal.coefficient / divisor\n  const remainder = decimal.coefficient < 0n\n    ? (-decimal.coefficient) % divisor\n    : decimal.coefficient % divisor\n  const coefficient = remainder * 2n >= divisor\n    ? quotient + (decimal.coefficient < 0n ? -1n : 1n)\n    : quotient\n\n  return { coefficient, scale: targetScale }\n}\n\nexport function round(value: Numeric, decimals = 0): number {\n  const decimal = parseDecimal(value)\n  if (!decimal) return Number.NaN\n  return decimalToNumber(roundDecimal(decimal, normalizeDecimals(decimals)))\n}\n\nexport function toFixed(value: Numeric, decimals = 0): string {\n  const decimal = parseDecimal(value)\n  if (!decimal) return ''\n\n  const targetScale = normalizeDecimals(decimals)\n  const rounded = roundDecimal(decimal, targetScale)\n  const sign = rounded.coefficient < 0n ? '-' : ''\n  const digits = (rounded.coefficient < 0n ? -rounded.coefficient : rounded.coefficient)\n    .toString()\n    .padStart(targetScale + 1, '0')\n\n  if (targetScale === 0) return `${sign}${digits}`\n  const point = digits.length - targetScale\n  return `${sign}${digits.slice(0, point)}.${digits.slice(point)}`\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export declare function add(...values: Numeric[]): number;
+
+export declare function divide(...values: Numeric[]): number;
+
+export declare const minus: typeof subtract;
+
+export declare function multiply(...values: Numeric[]): number;
+
+export declare type Numeric = number | string;
+
+export declare const plus: typeof add;
+
+export declare function round(value: Numeric, decimals?: number): number;
+
+export declare function subtract(...values: Numeric[]): number;
+
+export declare const times: typeof multiply;
+
+export declare function toFixed(value: Numeric, decimals?: number): string;
+
+export { }

package/dist/index.js

@@ -0,0 +1,117 @@
+//#region src/index.ts
+function e(e) {
+	if (typeof e == "string" && e.trim() === "") return;
+	let t = String(e).trim();
+	if (!/^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i.test(t)) return;
+	let [n, r] = t.toLowerCase().split("e"), i = Number(r ?? 0);
+	if (!Number.isFinite(Number(t)) || Math.abs(i) > 1e3) return;
+	let a = n.startsWith("-") ? -1n : 1n, [o, s = ""] = n.replace(/^[+-]/, "").split("."), c = `${o}${s}`.replace(/^0+(?=\d)/, "") || "0", l = s.length - i, u = a * BigInt(c);
+	return l >= 0 ? {
+		coefficient: u,
+		scale: l
+	} : {
+		coefficient: u * 10n ** BigInt(-l),
+		scale: 0
+	};
+}
+function t(t) {
+	let n = t.map(e);
+	return n.every((e) => e !== void 0) ? n : void 0;
+}
+function n(e, t) {
+	let n = Math.max(e.scale, t.scale);
+	return [
+		e.coefficient * 10n ** BigInt(n - e.scale),
+		t.coefficient * 10n ** BigInt(n - t.scale),
+		n
+	];
+}
+function r(e, t = e.scale) {
+	let n = e.coefficient < 0n ? "-" : "", r = (e.coefficient < 0n ? -e.coefficient : e.coefficient).toString(), i = Math.max(0, t), a = r.padStart(i + 1, "0"), o = a.length - i, s = a.slice(0, o), c = a.slice(o).replace(/0+$/, "");
+	return `${n}${s}${c ? `.${c}` : ""}`;
+}
+function i(e) {
+	return Number(r(e));
+}
+function a(e, t) {
+	let [r, i, a] = n(e, t);
+	return {
+		coefficient: r + i,
+		scale: a
+	};
+}
+function o(e, t) {
+	let [r, i, a] = n(e, t);
+	return {
+		coefficient: r - i,
+		scale: a
+	};
+}
+function s(e, t) {
+	return {
+		coefficient: e.coefficient * t.coefficient,
+		scale: e.scale + t.scale
+	};
+}
+function c(...e) {
+	if (e.length === 0) return 0;
+	let n = t(e);
+	return n ? i(n.reduce(a)) : NaN;
+}
+var l = c;
+function u(...e) {
+	if (e.length === 0) return NaN;
+	let n = t(e);
+	return n ? i(n.slice(1).reduce(o, n[0])) : NaN;
+}
+var d = u;
+function f(...e) {
+	if (e.length === 0) return 1;
+	let n = t(e);
+	return n ? i(n.reduce(s)) : NaN;
+}
+var p = f;
+function m(...e) {
+	if (e.length === 0) return NaN;
+	let n = t(e);
+	if (!n || n.some((e, t) => t > 0 && e.coefficient === 0n)) return NaN;
+	let r = n[0];
+	for (let e of n.slice(1)) {
+		let t = r.coefficient < 0n == e.coefficient < 0n ? 1n : -1n, n = r.coefficient < 0n ? -r.coefficient : r.coefficient, i = e.coefficient < 0n ? -e.coefficient : e.coefficient, a = 20 + e.scale - r.scale;
+		r = {
+			coefficient: t * ((a >= 0 ? n * 10n ** BigInt(a) : n / 10n ** BigInt(-a)) / i),
+			scale: 20
+		};
+	}
+	return i(r);
+}
+function h(e) {
+	return Number.isFinite(e) ? Math.max(0, Math.floor(e)) : 0;
+}
+function g(e, t) {
+	if (e.scale <= t) return {
+		coefficient: e.coefficient * 10n ** BigInt(t - e.scale),
+		scale: t
+	};
+	let n = 10n ** BigInt(e.scale - t), r = e.coefficient / n;
+	return {
+		coefficient: (e.coefficient < 0n ? -e.coefficient % n : e.coefficient % n) * 2n >= n ? r + (e.coefficient < 0n ? -1n : 1n) : r,
+		scale: t
+	};
+}
+function _(t, n = 0) {
+	let r = e(t);
+	return r ? i(g(r, h(n))) : NaN;
+}
+function v(t, n = 0) {
+	let r = e(t);
+	if (!r) return "";
+	let i = h(n), a = g(r, i), o = a.coefficient < 0n ? "-" : "", s = (a.coefficient < 0n ? -a.coefficient : a.coefficient).toString().padStart(i + 1, "0");
+	if (i === 0) return `${o}${s}`;
+	let c = s.length - i;
+	return `${o}${s.slice(0, c)}.${s.slice(c)}`;
+}
+//#endregion
+export { c as add, m as divide, d as minus, f as multiply, l as plus, _ as round, u as subtract, p as times, v as toFixed };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type Numeric = number | string\n\ntype Decimal = {\n  coefficient: bigint\n  scale: number\n}\n\nfunction parseDecimal(value: Numeric): Decimal | undefined {\n  if (typeof value === 'string' && value.trim() === '') return undefined\n\n  const text = String(value).trim()\n  if (!/^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:e[+-]?\\d+)?$/i.test(text)) return undefined\n\n  const [base, exponentText] = text.toLowerCase().split('e')\n  const exponent = Number(exponentText ?? 0)\n  if (!Number.isFinite(Number(text)) || Math.abs(exponent) > 1000) return undefined\n  const sign = base.startsWith('-') ? -1n : 1n\n  const unsigned = base.replace(/^[+-]/, '')\n  const [integer, fraction = ''] = unsigned.split('.')\n  const digits = `${integer}${fraction}`.replace(/^0+(?=\\d)/, '') || '0'\n  const scale = fraction.length - exponent\n  const coefficient = sign * BigInt(digits)\n\n  if (scale >= 0) return { coefficient, scale }\n  return { coefficient: coefficient * 10n ** BigInt(-scale), scale: 0 }\n}\n\nfunction parseValues(values: Numeric[]): Decimal[] | undefined {\n  const decimals = values.map(parseDecimal)\n  return decimals.every((value): value is Decimal => value !== undefined) ? decimals : undefined\n}\n\nfunction align(left: Decimal, right: Decimal): [bigint, bigint, number] {\n  const scale = Math.max(left.scale, right.scale)\n  return [\n    left.coefficient * 10n ** BigInt(scale - left.scale),\n    right.coefficient * 10n ** BigInt(scale - right.scale),\n    scale,\n  ]\n}\n\nfunction decimalToString(value: Decimal, fixedScale = value.scale): string {\n  const sign = value.coefficient < 0n ? '-' : ''\n  const digits = (value.coefficient < 0n ? -value.coefficient : value.coefficient).toString()\n  const scale = Math.max(0, fixedScale)\n  const padded = digits.padStart(scale + 1, '0')\n  const point = padded.length - scale\n  const integer = padded.slice(0, point)\n  const fraction = padded.slice(point).replace(/0+$/, '')\n  return `${sign}${integer}${fraction ? `.${fraction}` : ''}`\n}\n\nfunction decimalToNumber(value: Decimal): number {\n  return Number(decimalToString(value))\n}\n\nfunction addDecimals(left: Decimal, right: Decimal): Decimal {\n  const [leftCoefficient, rightCoefficient, scale] = align(left, right)\n  return { coefficient: leftCoefficient + rightCoefficient, scale }\n}\n\nfunction subtractDecimals(left: Decimal, right: Decimal): Decimal {\n  const [leftCoefficient, rightCoefficient, scale] = align(left, right)\n  return { coefficient: leftCoefficient - rightCoefficient, scale }\n}\n\nfunction multiplyDecimals(left: Decimal, right: Decimal): Decimal {\n  return {\n    coefficient: left.coefficient * right.coefficient,\n    scale: left.scale + right.scale,\n  }\n}\n\nexport function add(...values: Numeric[]): number {\n  if (values.length === 0) return 0\n  const decimals = parseValues(values)\n  if (!decimals) return Number.NaN\n  return decimalToNumber(decimals.reduce(addDecimals))\n}\n\nexport const plus = add\n\nexport function subtract(...values: Numeric[]): number {\n  if (values.length === 0) return Number.NaN\n  const decimals = parseValues(values)\n  if (!decimals) return Number.NaN\n  return decimalToNumber(decimals.slice(1).reduce(subtractDecimals, decimals[0]))\n}\n\nexport const minus = subtract\n\nexport function multiply(...values: Numeric[]): number {\n  if (values.length === 0) return 1\n  const decimals = parseValues(values)\n  if (!decimals) return Number.NaN\n  return decimalToNumber(decimals.reduce(multiplyDecimals))\n}\n\nexport const times = multiply\n\nexport function divide(...values: Numeric[]): number {\n  if (values.length === 0) return Number.NaN\n  const decimals = parseValues(values)\n  if (!decimals || decimals.some((value, index) => index > 0 && value.coefficient === 0n)) {\n    return Number.NaN\n  }\n\n  let result = decimals[0]\n  for (const divisor of decimals.slice(1)) {\n    const sameSign = (result.coefficient < 0n) === (divisor.coefficient < 0n)\n    const sign = sameSign ? 1n : -1n\n    const dividend = result.coefficient < 0n ? -result.coefficient : result.coefficient\n    const divisorCoefficient = divisor.coefficient < 0n ? -divisor.coefficient : divisor.coefficient\n    const scale = 20 + divisor.scale - result.scale\n    const scaledDividend = scale >= 0 ? dividend * 10n ** BigInt(scale) : dividend / 10n ** BigInt(-scale)\n    const quotient = scaledDividend / divisorCoefficient\n    result = { coefficient: sign * quotient, scale: 20 }\n  }\n\n  return decimalToNumber(result)\n}\n\nfunction normalizeDecimals(decimals: number): number {\n  return Number.isFinite(decimals) ? Math.max(0, Math.floor(decimals)) : 0\n}\n\nfunction roundDecimal(decimal: Decimal, targetScale: number): Decimal {\n  if (decimal.scale <= targetScale) {\n    return {\n      coefficient: decimal.coefficient * 10n ** BigInt(targetScale - decimal.scale),\n      scale: targetScale,\n    }\n  }\n\n  const divisor = 10n ** BigInt(decimal.scale - targetScale)\n  const quotient = decimal.coefficient / divisor\n  const remainder = decimal.coefficient < 0n\n    ? (-decimal.coefficient) % divisor\n    : decimal.coefficient % divisor\n  const coefficient = remainder * 2n >= divisor\n    ? quotient + (decimal.coefficient < 0n ? -1n : 1n)\n    : quotient\n\n  return { coefficient, scale: targetScale }\n}\n\nexport function round(value: Numeric, decimals = 0): number {\n  const decimal = parseDecimal(value)\n  if (!decimal) return Number.NaN\n  return decimalToNumber(roundDecimal(decimal, normalizeDecimals(decimals)))\n}\n\nexport function toFixed(value: Numeric, decimals = 0): string {\n  const decimal = parseDecimal(value)\n  if (!decimal) return ''\n\n  const targetScale = normalizeDecimals(decimals)\n  const rounded = roundDecimal(decimal, targetScale)\n  const sign = rounded.coefficient < 0n ? '-' : ''\n  const digits = (rounded.coefficient < 0n ? -rounded.coefficient : rounded.coefficient)\n    .toString()\n    .padStart(targetScale + 1, '0')\n\n  if (targetScale === 0) return `${sign}${digits}`\n  const point = digits.length - targetScale\n  return `${sign}${digits.slice(0, point)}.${digits.slice(point)}`\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@gitlon/math",
+  "version": "0.1.0",
+  "description": "Precision-safe arithmetic utilities for gitlon",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "gitlon",
+    "math",
+    "decimal",
+    "precision"
+  ],
+  "license": "MIT",
+  "author": "Long",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}