bigint-decimal 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 soso
+
+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,143 @@
+# BigintDecimal
+
+A blazing-fast, zero-dependency, arbitrary-precision decimal math library for TypeScript and JavaScript. Built on native `BigInt` to safely handle massive numbers, exact decimals, and eliminate floating-point errors.
+
+Perfect for financial applications, trading platforms, and anywhere precise calculation is critical.
+
+## Installation
+
+```bash
+npm install bigint-decimal
+# or
+yarn add bigint-decimal
+# or
+pnpm add bigint-decimal
+
+```
+
+## Why bigint-decimal?
+
+Native JavaScript floating-point math is notoriously imprecise:
+
+```javascript
+console.log(0.1 + 0.2); // 0.30000000000000004 ❌
+
+```
+
+`bigint-decimal` fixes this natively, without the bloat of massive external math libraries:
+
+```javascript
+import { BigintDecimal } from 'bigint-decimal';
+
+const a = new BigintDecimal("0.1");
+const b = new BigintDecimal("0.2");
+console.log(a.plus(b).toString()); // "0.3" ✅
+
+```
+
+## Usage
+
+### Basic Arithmetic
+
+`BigintDecimal` supports all standard arithmetic operations. Always pass numbers as strings to guarantee precision before JavaScript evaluates them.
+
+```typescript
+import { BigintDecimal } from 'bigint-decimal';
+
+const walletBalance = new BigintDecimal("1500.50");
+const tradeAmount = new BigintDecimal("200.75");
+const gasFee = new BigintDecimal("0.005");
+
+// Addition
+const newBalance = walletBalance.plus(tradeAmount); // "1701.25"
+
+// Subtraction
+const finalBalance = newBalance.minus(gasFee); // "1701.245"
+
+// Multiplication
+const price = new BigintDecimal("45000.50");
+const amount = new BigintDecimal("0.5");
+const totalValue = price.times(amount); // "22500.25"
+
+// Division
+const totalTokens = new BigintDecimal("1000");
+const splits = new BigintDecimal("3");
+const perPerson = totalTokens.div(splits); // "333.33333333333333333333"
+
+```
+
+### Chaining Operations
+
+Every math operation returns a new `BigintDecimal` instance, allowing you to cleanly chain complex formulas.
+
+```typescript
+const result = new BigintDecimal("100")
+  .plus("50.5")
+  .times("2")
+  .minus("1.1")
+  .div("2");
+
+console.log(result.toString()); // "149.95"
+
+```
+
+### Comparisons
+
+Easily compare values without precision loss.
+
+```typescript
+const requiredMargin = new BigintDecimal("1000.00");
+const userBalance = new BigintDecimal("999.99");
+
+userBalance.gt(requiredMargin);  // false (Greater Than)
+userBalance.gte(requiredMargin); // false (Greater Than or Equal)
+userBalance.lt(requiredMargin);  // true  (Less Than)
+userBalance.lte(requiredMargin); // true  (Less Than or Equal)
+userBalance.eq("999.99");        // true  (Equal)
+
+```
+
+### Rounding
+
+Round to a specific number of decimal places. Standard rounding rules apply (halves round up).
+
+```typescript
+const fee = new BigintDecimal("1.555");
+console.log(fee.round(2).toString()); // "1.56"
+console.log(fee.round(0).toString()); // "2"
+
+```
+
+### Managing Precision (For Division)
+
+Division operations can result in infinitely repeating decimals. `BigintDecimal` handles this by defaulting to a maximum precision of `20` decimal places. You can adjust this globally or per instance.
+
+```typescript
+// Change instance precision
+const exactDiv = new BigintDecimal("1");
+exactDiv.setPrecision(5);
+console.log(exactDiv.div("3").toString()); // "0.33333"
+
+// Change global precision for all new instances
+BigintDecimal.setPrecisionGlobal(2);
+console.log(new BigintDecimal("1").div("3").toString()); // "0.33"
+
+```
+
+## Supported Inputs
+
+`BigintDecimal` safely parses a wide variety of inputs, including scientific notation and massive integers.
+
+```typescript
+new BigintDecimal("1e-18"); // "0.000000000000000001"
+new BigintDecimal("9999999999999999999999999999"); // Handles massive numbers natively
+new BigintDecimal("-0.0005"); // Negative floats
+new BigintDecimal(100n); // Native BigInt
+
+```
+
+*Note: While passing `number` primitives (like `new BigintDecimal(100)`) is supported, passing them as strings (`"100"`) is strongly recommended to avoid JS evaluating floating points before the class receives them.*
+
+## License
+
+MIT

package/dist/common/index.d.ts

@@ -0,0 +1,28 @@
+type SafeValues = string | number | bigint;
+export declare class BigintDecimal {
+    private value;
+    private decimals;
+    static precision: number;
+    precision: number;
+    constructor(val?: SafeValues | BigintDecimal);
+    static setPrecisionGlobal(newPrecision: number): void;
+    setPrecision(newPrecision: number): void;
+    private trim;
+    private toSafeValue;
+    private getNumberIFoForBigintDecimal;
+    toString(): string;
+    toJSON(): string;
+    isBigintDecimal(val: unknown): boolean;
+    plus(val: SafeValues | BigintDecimal): BigintDecimal;
+    minus(val: SafeValues | BigintDecimal): BigintDecimal;
+    times(val: SafeValues | BigintDecimal): BigintDecimal;
+    round(toDecimals: number): BigintDecimal;
+    div(val: SafeValues | BigintDecimal): BigintDecimal;
+    private compare;
+    gt(val: SafeValues | BigintDecimal): boolean;
+    lt(val: SafeValues | BigintDecimal): boolean;
+    gte(val: SafeValues | BigintDecimal): boolean;
+    lte(val: SafeValues | BigintDecimal): boolean;
+    eq(val: SafeValues | BigintDecimal): boolean;
+}
+export { BigintDecimal as default };

package/dist/common/index.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.BigintDecimal = void 0;
+class BigintDecimal {
+    constructor(val = "0") {
+        this.value = 0n;
+        this.decimals = 0;
+        this.precision = BigintDecimal.precision;
+        if (val instanceof BigintDecimal) {
+            this.value = val.value;
+            this.decimals = val.decimals;
+            return;
+        }
+        if (!this.isBigintDecimal(val)) {
+            throw new Error(`"${val}" is not safe parameter .`);
+        }
+        const numberInfo = this.getNumberIFoForBigintDecimal(val);
+        this.value = numberInfo.value;
+        this.decimals = numberInfo.decimals;
+        this.trim();
+    }
+    static setPrecisionGlobal(newPrecision) {
+        this.precision = newPrecision;
+    }
+    setPrecision(newPrecision) {
+        this.precision = newPrecision;
+    }
+    trim() {
+        if (this.value === 0n) {
+            this.value = 0n;
+            this.decimals = 0;
+        }
+        // While we have decimals AND the last digit is 0
+        while (this.decimals > 0 && this.value !== 0n && this.value % 10n === 0n) {
+            this.value /= 10n; // Shrink the number
+            this.decimals--; // Shrink the scale
+        }
+        return this;
+    }
+    toSafeValue(val) {
+        if (typeof val === "string") {
+            return val.trim();
+        }
+        return `${val}`;
+    }
+    getNumberIFoForBigintDecimal(val) {
+        const safeVal = this.toSafeValue(val);
+        let isDot = false, value = 0n, decimals = 0, sign = 1n;
+        for (let i = 0; i < safeVal.length; i++) {
+            const code = safeVal.charCodeAt(i);
+            if (code >= 48 && code <= 57) {
+                value = (value * 10n) + BigInt(code - 48);
+                if (isDot)
+                    decimals++;
+                continue;
+            }
+            if (code === 46 && !isDot) {
+                isDot = true;
+                continue;
+            }
+            if (i === 0 && (code === 45 || code === 43)) {
+                if (code === 45)
+                    sign = -1n;
+                continue;
+            }
+            // Scientific Notation Handle
+            if (code === 101 || code === 69) {
+                const exp = parseInt(safeVal.slice(i + 1), 10);
+                if (isNaN(exp))
+                    throw new Error("Invalid exponent");
+                decimals -= exp;
+                break;
+            }
+            throw new Error(`Unexpected character: ${String.fromCharCode(code)}`);
+        }
+        // Handle negative decimals (large integers)
+        if (decimals < 0) {
+            value = value * (10n ** BigInt(-decimals));
+            decimals = 0;
+        }
+        ;
+        return { value: value * sign, decimals };
+    }
+    toString() {
+        // 1. Handle Integer case (Fastest exit, Zero Allocation overhead)
+        if (this.decimals === 0)
+            return this.value.toString();
+        // 2. Separate Sign and Magnitude
+        // Check sign using BigInt math (fastest)
+        const isNegative = this.value < 0n;
+        // Get the string of digits ONLY.
+        // isNegative ? -this.value : this.value -> creates a temporary BigInt
+        // .toString() -> creates the string of digits "123"
+        // This is cheaper than creating "-123" and slicing it.
+        const s = (isNegative ? -this.value : this.value).toString();
+        const len = s.length;
+        // 3. Logic for insertion vs padding
+        if (len > this.decimals) {
+            // Case A: 12345 (2 dec) -> 123.45
+            // splitIndex is purely digits before the dot
+            const splitIndex = len - this.decimals;
+            // Build the absolute decimal string
+            const result = s.substring(0, splitIndex) + "." + s.substring(splitIndex);
+            // Add sign if needed
+            return isNegative ? "-" + result : result;
+        }
+        // Case B: 5 (2 dec) -> 0.05
+        // Calculate zeros needed: 2 decimals - length 1 = 1 zero
+        const zerosNeeded = this.decimals - len;
+        // Build the result directly
+        // "0." + "0" + "5" 
+        return (isNegative ? "-0." : "0.") + "0".repeat(zerosNeeded) + s;
+    }
+    toJSON() {
+        return this.toString();
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return this.toString();
+    }
+    isBigintDecimal(val) {
+        const s = this.toSafeValue(val);
+        if (s.length === 0)
+            return false;
+        let dot = false, e = false;
+        for (let i = 0; i < s.length; i++) {
+            const c = s.charCodeAt(i);
+            if (c >= 48 && c <= 57)
+                continue; // 0-9
+            if (c === 46 && !dot && !e) {
+                dot = true;
+                continue;
+            } // .
+            if (i === 0 && (c === 45 || c === 43))
+                continue; // +/- at start
+            if ((c === 101 || c === 69) && !e) { // e/E
+                e = true;
+                const next = s.charCodeAt(i + 1);
+                if (next === 45 || next === 43)
+                    i++; // Skip sign after 'e'
+                continue;
+            }
+            return false;
+        }
+        return true;
+    }
+    plus(val) {
+        const plusValue = new BigintDecimal(val);
+        // 1. Determine which number has more decimals
+        const d1 = this.decimals;
+        const d2 = plusValue.decimals;
+        const newDecimal = d1 > d2 ? d1 : d2;
+        // 2. Align values (Common Denominator)
+        // If 'this' has fewer decimals, scale it up.
+        const v1 = d1 < newDecimal ? this.value * (10n ** BigInt(newDecimal - d1)) : this.value;
+        // If 'plusValue' has fewer decimals, scale it up.
+        const v2 = d2 < newDecimal ? plusValue.value * (10n ** BigInt(newDecimal - d2)) : plusValue.value;
+        // 3. Now add and return
+        const result = new BigintDecimal("0");
+        result.value = v1 + v2;
+        result.decimals = newDecimal;
+        return result.trim();
+    }
+    minus(val) {
+        const other = new BigintDecimal(val);
+        const d1 = this.decimals;
+        const d2 = other.decimals;
+        const newDecimal = d1 > d2 ? d1 : d2;
+        // Scale values to the same precision
+        const v1 = d1 < newDecimal ? this.value * (10n ** BigInt(newDecimal - d1)) : this.value;
+        const v2 = d2 < newDecimal ? other.value * (10n ** BigInt(newDecimal - d2)) : other.value;
+        const result = new BigintDecimal("0"); // Fastest instantiation
+        result.value = v1 - v2;
+        result.decimals = newDecimal;
+        return result.trim();
+    }
+    times(val) {
+        const other = new BigintDecimal(val);
+        const result = new BigintDecimal("0");
+        // Multiplication: (A * 10^d1) * (B * 10^d2) = (A * B) * 10^(d1 + d2)
+        result.value = this.value * other.value;
+        result.decimals = this.decimals + other.decimals;
+        return result.trim();
+    }
+    round(toDecimals) {
+        const result = new BigintDecimal("0");
+        const diff = this.decimals - toDecimals;
+        if (diff <= 0)
+            return this; // Already more precise than requested
+        const power = 10n ** BigInt(diff);
+        const half = power / 2n;
+        // Standard rounding: add half of the divisor before dividing
+        // This turns 0.999... into 1.0
+        const roundedValue = (this.value >= 0n) ? (this.value + half) / power : (this.value - half) / power;
+        result.value = roundedValue;
+        result.decimals = toDecimals;
+        return result.trim();
+    }
+    div(val) {
+        const other = val instanceof BigintDecimal ? val : new BigintDecimal(val);
+        if (other.value === 0n)
+            throw new Error("Division by zero");
+        let v1 = this.value;
+        const v2 = other.value;
+        // 1. Scale up once to your "Max Allowed" precision
+        const shift = this.precision + other.decimals - this.decimals;
+        if (shift > 0)
+            v1 *= 10n ** BigInt(shift);
+        else if (shift < 0)
+            v1 /= 10n ** BigInt(-shift);
+        const result = new BigintDecimal("0");
+        result.value = v1 / v2;
+        result.decimals = this.precision;
+        // 2. Immediately trim it!
+        // This is where 0.500000... becomes 0.5 automatically.
+        return result.trim();
+    }
+    compare(val) {
+        const other = val instanceof BigintDecimal ? val : new BigintDecimal(val);
+        const maxD = Math.max(this.decimals, other.decimals);
+        const v1 = this.decimals < maxD ? this.value * (10n ** BigInt(maxD - this.decimals)) : this.value;
+        const v2 = other.decimals < maxD ? other.value * (10n ** BigInt(maxD - other.decimals)) : other.value;
+        return v1 > v2 ? 1 : v1 < v2 ? -1 : 0;
+    }
+    gt(val) {
+        return this.compare(val) === 1;
+    }
+    lt(val) {
+        return this.compare(val) === -1;
+    }
+    gte(val) {
+        return this.compare(val) >= 0;
+    }
+    lte(val) {
+        return this.compare(val) <= 0;
+    }
+    eq(val) {
+        return this.compare(val) === 0;
+    }
+}
+exports.BigintDecimal = BigintDecimal;
+exports.default = BigintDecimal;
+BigintDecimal.precision = 20;
+;
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

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

package/dist/common/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const createBigintPermutations: (size: bigint, momentumSize: bigint) => bigint[];
+export declare const createNumberPermutations: (size: number, momentumSize: number) => number[];

package/dist/common/utils.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNumberPermutations = exports.createBigintPermutations = void 0;
+const factorial = (n) => {
+    let result = 1n;
+    for (let i = 1n; i <= n; i++) {
+        result *= i;
+    }
+    return result;
+};
+const permutationsBigint = (n, r) => factorial(n) / factorial(n - r);
+const createBigintPermutations = (size, momentumSize) => {
+    const permutations = [];
+    for (let i = 0n; i < momentumSize; i++) {
+        permutations.push(permutationsBigint(size - i - 1n, momentumSize - i - 1n));
+    }
+    return permutations;
+};
+exports.createBigintPermutations = createBigintPermutations;
+const createNumberPermutations = (size, momentumSize) => {
+    return (0, exports.createBigintPermutations)(BigInt(size), BigInt(momentumSize)).map(Number);
+};
+exports.createNumberPermutations = createNumberPermutations;
+//# sourceMappingURL=utils.js.map

package/dist/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../utils.ts"],"names":[],"mappings":";;;AAAA,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE;IACpC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAChD,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAG7B,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,YAAoB,EAAE,EAAE;IAC3E,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,EAAE,YAAY,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,YAAY,CAAA;AACvB,CAAC,CAAA;AANY,QAAA,wBAAwB,4BAMpC;AAEM,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,YAAoB,EAAE,EAAE;IAC3E,OAAO,IAAA,gCAAwB,EAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACnF,CAAC,CAAA;AAFY,QAAA,wBAAwB,4BAEpC"}

package/dist/global/index.d.ts

@@ -0,0 +1,28 @@
+type SafeValues = string | number | bigint;
+export declare class BigintDecimal {
+    private value;
+    private decimals;
+    static precision: number;
+    precision: number;
+    constructor(val?: SafeValues | BigintDecimal);
+    static setPrecisionGlobal(newPrecision: number): void;
+    setPrecision(newPrecision: number): void;
+    private trim;
+    private toSafeValue;
+    private getNumberIFoForBigintDecimal;
+    toString(): string;
+    toJSON(): string;
+    isBigintDecimal(val: unknown): boolean;
+    plus(val: SafeValues | BigintDecimal): BigintDecimal;
+    minus(val: SafeValues | BigintDecimal): BigintDecimal;
+    times(val: SafeValues | BigintDecimal): BigintDecimal;
+    round(toDecimals: number): BigintDecimal;
+    div(val: SafeValues | BigintDecimal): BigintDecimal;
+    private compare;
+    gt(val: SafeValues | BigintDecimal): boolean;
+    lt(val: SafeValues | BigintDecimal): boolean;
+    gte(val: SafeValues | BigintDecimal): boolean;
+    lte(val: SafeValues | BigintDecimal): boolean;
+    eq(val: SafeValues | BigintDecimal): boolean;
+}
+export { BigintDecimal as default };

package/dist/global/index.js

@@ -0,0 +1,240 @@
+export class BigintDecimal {
+    constructor(val = "0") {
+        this.value = 0n;
+        this.decimals = 0;
+        this.precision = BigintDecimal.precision;
+        if (val instanceof BigintDecimal) {
+            this.value = val.value;
+            this.decimals = val.decimals;
+            return;
+        }
+        if (!this.isBigintDecimal(val)) {
+            throw new Error(`"${val}" is not safe parameter .`);
+        }
+        const numberInfo = this.getNumberIFoForBigintDecimal(val);
+        this.value = numberInfo.value;
+        this.decimals = numberInfo.decimals;
+        this.trim();
+    }
+    static setPrecisionGlobal(newPrecision) {
+        this.precision = newPrecision;
+    }
+    setPrecision(newPrecision) {
+        this.precision = newPrecision;
+    }
+    trim() {
+        if (this.value === 0n) {
+            this.value = 0n;
+            this.decimals = 0;
+        }
+        // While we have decimals AND the last digit is 0
+        while (this.decimals > 0 && this.value !== 0n && this.value % 10n === 0n) {
+            this.value /= 10n; // Shrink the number
+            this.decimals--; // Shrink the scale
+        }
+        return this;
+    }
+    toSafeValue(val) {
+        if (typeof val === "string") {
+            return val.trim();
+        }
+        return `${val}`;
+    }
+    getNumberIFoForBigintDecimal(val) {
+        const safeVal = this.toSafeValue(val);
+        let isDot = false, value = 0n, decimals = 0, sign = 1n;
+        for (let i = 0; i < safeVal.length; i++) {
+            const code = safeVal.charCodeAt(i);
+            if (code >= 48 && code <= 57) {
+                value = (value * 10n) + BigInt(code - 48);
+                if (isDot)
+                    decimals++;
+                continue;
+            }
+            if (code === 46 && !isDot) {
+                isDot = true;
+                continue;
+            }
+            if (i === 0 && (code === 45 || code === 43)) {
+                if (code === 45)
+                    sign = -1n;
+                continue;
+            }
+            // Scientific Notation Handle
+            if (code === 101 || code === 69) {
+                const exp = parseInt(safeVal.slice(i + 1), 10);
+                if (isNaN(exp))
+                    throw new Error("Invalid exponent");
+                decimals -= exp;
+                break;
+            }
+            throw new Error(`Unexpected character: ${String.fromCharCode(code)}`);
+        }
+        // Handle negative decimals (large integers)
+        if (decimals < 0) {
+            value = value * (10n ** BigInt(-decimals));
+            decimals = 0;
+        }
+        ;
+        return { value: value * sign, decimals };
+    }
+    toString() {
+        // 1. Handle Integer case (Fastest exit, Zero Allocation overhead)
+        if (this.decimals === 0)
+            return this.value.toString();
+        // 2. Separate Sign and Magnitude
+        // Check sign using BigInt math (fastest)
+        const isNegative = this.value < 0n;
+        // Get the string of digits ONLY.
+        // isNegative ? -this.value : this.value -> creates a temporary BigInt
+        // .toString() -> creates the string of digits "123"
+        // This is cheaper than creating "-123" and slicing it.
+        const s = (isNegative ? -this.value : this.value).toString();
+        const len = s.length;
+        // 3. Logic for insertion vs padding
+        if (len > this.decimals) {
+            // Case A: 12345 (2 dec) -> 123.45
+            // splitIndex is purely digits before the dot
+            const splitIndex = len - this.decimals;
+            // Build the absolute decimal string
+            const result = s.substring(0, splitIndex) + "." + s.substring(splitIndex);
+            // Add sign if needed
+            return isNegative ? "-" + result : result;
+        }
+        // Case B: 5 (2 dec) -> 0.05
+        // Calculate zeros needed: 2 decimals - length 1 = 1 zero
+        const zerosNeeded = this.decimals - len;
+        // Build the result directly
+        // "0." + "0" + "5" 
+        return (isNegative ? "-0." : "0.") + "0".repeat(zerosNeeded) + s;
+    }
+    toJSON() {
+        return this.toString();
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return this.toString();
+    }
+    isBigintDecimal(val) {
+        const s = this.toSafeValue(val);
+        if (s.length === 0)
+            return false;
+        let dot = false, e = false;
+        for (let i = 0; i < s.length; i++) {
+            const c = s.charCodeAt(i);
+            if (c >= 48 && c <= 57)
+                continue; // 0-9
+            if (c === 46 && !dot && !e) {
+                dot = true;
+                continue;
+            } // .
+            if (i === 0 && (c === 45 || c === 43))
+                continue; // +/- at start
+            if ((c === 101 || c === 69) && !e) { // e/E
+                e = true;
+                const next = s.charCodeAt(i + 1);
+                if (next === 45 || next === 43)
+                    i++; // Skip sign after 'e'
+                continue;
+            }
+            return false;
+        }
+        return true;
+    }
+    plus(val) {
+        const plusValue = new BigintDecimal(val);
+        // 1. Determine which number has more decimals
+        const d1 = this.decimals;
+        const d2 = plusValue.decimals;
+        const newDecimal = d1 > d2 ? d1 : d2;
+        // 2. Align values (Common Denominator)
+        // If 'this' has fewer decimals, scale it up.
+        const v1 = d1 < newDecimal ? this.value * (10n ** BigInt(newDecimal - d1)) : this.value;
+        // If 'plusValue' has fewer decimals, scale it up.
+        const v2 = d2 < newDecimal ? plusValue.value * (10n ** BigInt(newDecimal - d2)) : plusValue.value;
+        // 3. Now add and return
+        const result = new BigintDecimal("0");
+        result.value = v1 + v2;
+        result.decimals = newDecimal;
+        return result.trim();
+    }
+    minus(val) {
+        const other = new BigintDecimal(val);
+        const d1 = this.decimals;
+        const d2 = other.decimals;
+        const newDecimal = d1 > d2 ? d1 : d2;
+        // Scale values to the same precision
+        const v1 = d1 < newDecimal ? this.value * (10n ** BigInt(newDecimal - d1)) : this.value;
+        const v2 = d2 < newDecimal ? other.value * (10n ** BigInt(newDecimal - d2)) : other.value;
+        const result = new BigintDecimal("0"); // Fastest instantiation
+        result.value = v1 - v2;
+        result.decimals = newDecimal;
+        return result.trim();
+    }
+    times(val) {
+        const other = new BigintDecimal(val);
+        const result = new BigintDecimal("0");
+        // Multiplication: (A * 10^d1) * (B * 10^d2) = (A * B) * 10^(d1 + d2)
+        result.value = this.value * other.value;
+        result.decimals = this.decimals + other.decimals;
+        return result.trim();
+    }
+    round(toDecimals) {
+        const result = new BigintDecimal("0");
+        const diff = this.decimals - toDecimals;
+        if (diff <= 0)
+            return this; // Already more precise than requested
+        const power = 10n ** BigInt(diff);
+        const half = power / 2n;
+        // Standard rounding: add half of the divisor before dividing
+        // This turns 0.999... into 1.0
+        const roundedValue = (this.value >= 0n) ? (this.value + half) / power : (this.value - half) / power;
+        result.value = roundedValue;
+        result.decimals = toDecimals;
+        return result.trim();
+    }
+    div(val) {
+        const other = val instanceof BigintDecimal ? val : new BigintDecimal(val);
+        if (other.value === 0n)
+            throw new Error("Division by zero");
+        let v1 = this.value;
+        const v2 = other.value;
+        // 1. Scale up once to your "Max Allowed" precision
+        const shift = this.precision + other.decimals - this.decimals;
+        if (shift > 0)
+            v1 *= 10n ** BigInt(shift);
+        else if (shift < 0)
+            v1 /= 10n ** BigInt(-shift);
+        const result = new BigintDecimal("0");
+        result.value = v1 / v2;
+        result.decimals = this.precision;
+        // 2. Immediately trim it!
+        // This is where 0.500000... becomes 0.5 automatically.
+        return result.trim();
+    }
+    compare(val) {
+        const other = val instanceof BigintDecimal ? val : new BigintDecimal(val);
+        const maxD = Math.max(this.decimals, other.decimals);
+        const v1 = this.decimals < maxD ? this.value * (10n ** BigInt(maxD - this.decimals)) : this.value;
+        const v2 = other.decimals < maxD ? other.value * (10n ** BigInt(maxD - other.decimals)) : other.value;
+        return v1 > v2 ? 1 : v1 < v2 ? -1 : 0;
+    }
+    gt(val) {
+        return this.compare(val) === 1;
+    }
+    lt(val) {
+        return this.compare(val) === -1;
+    }
+    gte(val) {
+        return this.compare(val) >= 0;
+    }
+    lte(val) {
+        return this.compare(val) <= 0;
+    }
+    eq(val) {
+        return this.compare(val) === 0;
+    }
+}
+BigintDecimal.precision = 20;
+;
+export { BigintDecimal as default };
+//# sourceMappingURL=index.js.map

package/dist/global/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,aAAa;IAOtB,YAAY,MAAkC,GAAG;QALzC,UAAK,GAAW,EAAE,CAAC;QACnB,aAAQ,GAAW,CAAC,CAAC;QAE7B,cAAS,GAAW,aAAa,CAAC,SAAS,CAAC;QAGxC,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;YACtB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAA;YAC5B,OAAM;QACV,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,2BAA2B,CAAC,CAAA;QACvD,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QAEpC,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,YAAoB;QAC1C,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,YAAoB;QAC7B,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;IAClC,CAAC;IAGO,IAAI;QACR,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;YACf,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,iDAAiD;QACjD,OAAO,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,KAAK,EAAE,EAAE,CAAC;YACvE,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,oBAAoB;YACvC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAI,mBAAmB;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,WAAW,CAAC,GAAY;QAC5B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,OAAO,GAAG,GAAG,EAAE,CAAA;IACnB,CAAC;IAEO,4BAA4B,CAAC,GAAY;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC;QAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAEnC,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC3B,KAAK,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC1C,IAAI,KAAK;oBAAE,QAAQ,EAAE,CAAC;gBACtB,SAAS;YACb,CAAC;YAED,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,CAAC;gBACb,SAAS;YACb,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC1C,IAAI,IAAI,KAAK,EAAE;oBAAE,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACb,CAAC;YAED,6BAA6B;YAC7B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,KAAK,CAAC,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;gBACpD,QAAQ,IAAI,GAAG,CAAC;gBAChB,MAAM;YACV,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,4CAA4C;QAC5C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,KAAK,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3C,QAAQ,GAAG,CAAC,CAAC;QACjB,CAAC;QAAA,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,QAAQ;QACJ,kEAAkE;QAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAEtD,iCAAiC;QACjC,yCAAyC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAEnC,iCAAiC;QACjC,sEAAsE;QACtE,oDAAoD;QACpD,uDAAuD;QACvD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE7D,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QAErB,oCAAoC;QACpC,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,kCAAkC;YAClC,6CAA6C;YAC7C,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YAEvC,oCAAoC;YACpC,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAE1E,qBAAqB;YACrB,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9C,CAAC;QAED,4BAA4B;QAC5B,yDAAyD;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QAExC,4BAA4B;QAC5B,oBAAoB;QACpB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,eAAe,CAAC,GAAY;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEjC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS,CAAC,MAAM;YACxC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;gBAAC,GAAG,GAAG,IAAI,CAAC;gBAAC,SAAS;YAAC,CAAC,CAAC,IAAI;YAC1D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;gBAAE,SAAS,CAAC,eAAe;YAChE,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM;gBACvC,CAAC,GAAG,IAAI,CAAC;gBACT,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE;oBAAE,CAAC,EAAE,CAAC,CAAC,sBAAsB;gBAC3D,SAAS;YACb,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,GAA+B;QAChC,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QAEzC,8CAA8C;QAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC;QAC9B,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErC,uCAAuC;QACvC,6CAA6C;QAC7C,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACxF,kDAAkD;QAClD,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QAElG,wBAAwB;QACxB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;QAE7B,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAA+B;QACjC,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC1B,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAErC,qCAAqC;QACrC,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACxF,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAE1F,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;QAC/D,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAA+B;QACjC,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACtC,qEAAqE;QACrE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACxC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAEjD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,UAAkB;QACpB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;QAExC,IAAI,IAAI,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,sCAAsC;QAElE,MAAM,KAAK,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAExB,6DAA6D;QAC7D,+BAA+B;QAC/B,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;QAEpG,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;QAC5B,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAA+B;QAC/B,MAAM,KAAK,GAAG,GAAG,YAAY,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAE5D,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACpB,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;QAEvB,mDAAmD;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9D,IAAI,KAAK,GAAG,CAAC;YAAE,EAAE,IAAI,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;aACrC,IAAI,KAAK,GAAG,CAAC;YAAE,EAAE,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEjC,0BAA0B;QAC1B,uDAAuD;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAEO,OAAO,CAAC,GAA+B;QAC3C,MAAM,KAAK,GAAG,GAAG,YAAY,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAErD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QAClG,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAEtG,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,EAAE,CAAC,GAA+B;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,EAAE,CAAC,GAA+B;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,GAA+B;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,GAA+B;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,EAAE,CAAC,GAA+B;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;;AAlRM,uBAAS,GAAW,EAAE,AAAb,CAAa;AAmRhC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,CAAA"}

package/dist/global/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const createBigintPermutations: (size: bigint, momentumSize: bigint) => bigint[];
+export declare const createNumberPermutations: (size: number, momentumSize: number) => number[];

package/dist/global/utils.js

@@ -0,0 +1,19 @@
+const factorial = (n) => {
+    let result = 1n;
+    for (let i = 1n; i <= n; i++) {
+        result *= i;
+    }
+    return result;
+};
+const permutationsBigint = (n, r) => factorial(n) / factorial(n - r);
+export const createBigintPermutations = (size, momentumSize) => {
+    const permutations = [];
+    for (let i = 0n; i < momentumSize; i++) {
+        permutations.push(permutationsBigint(size - i - 1n, momentumSize - i - 1n));
+    }
+    return permutations;
+};
+export const createNumberPermutations = (size, momentumSize) => {
+    return createBigintPermutations(BigInt(size), BigInt(momentumSize)).map(Number);
+};
+//# sourceMappingURL=utils.js.map

package/dist/global/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../utils.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,CAAC,CAAS,EAAU,EAAE;IACpC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAChD,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAGpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,YAAoB,EAAE,EAAE;IAC3E,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,EAAE,YAAY,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,YAAY,CAAA;AACvB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAE,YAAoB,EAAE,EAAE;IAC3E,OAAO,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACnF,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "bigint-decimal",
+  "version": "1.0.0",
+  "description": "A zero-dependency, arbitrary-precision decimal math library using native BigInt for safe financial and crypto calculations.",
+  "main": "./dist/global/index.js",
+  "author": "soso tsertsvadze",
+  "license": "MIT",
+  "scripts": {
+    "test": "jest",
+    "dev": "tsc -w --project tsconfig.common.json & tsc -w --project tsconfig.global.json & node --watch --watch-preserve-output ./dist/common/index.js & wait",
+    "build": "tsc --project tsconfig.node.json && tsc --project tsconfig.global.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Generalsimus/bigint-decimal.git"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/global/index.js",
+      "require": "./dist/common/index.js"
+    }
+  },
+  "keywords": [
+    "bigint",
+    "decimal",
+    "math",
+    "number",
+    "finance",
+    "crypto",
+    "precision",
+    "arbitrary-precision",
+    "typescript",
+    "bignumber"
+  ],
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6"
+  }
+}

package/tsconfig.base.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    // --- Strong Type Safety Flags ---
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    // --- Additional Code Quality Checks ---
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    // --- Original Configuration (Updated) ---
+    "moduleResolution": "node",
+    "removeComments": false,
+    "preserveConstEnums": true,
+    "sourceMap": true,
+    "declaration": true,
+    "target": "ES2020",
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "rootDir": "./",
+    "declarationDir": "./dist",
+    "outDir": "./dist"
+  },
+  "exclude": [
+    "./dist/",
+    "node_modules",
+    "./test"
+  ]
+}