@mezo-org/passport 0.4.0-dev.9 → 0.5.1-dev.0

package/dist/src/utils/number2.js

@@ -0,0 +1,289 @@
+// Matches floating point numbers with optional thousands separators
+export const FLOATING_POINT_REGEX = /^[^0-9]*([0-9,]+)(?:\.([0-9]*))?$/;
+const FRIENDLY_DECIMALS_AMOUNT = 6;
+/**
+ * HELPER FUNCTIONS
+ * These functions are used to convert between floating-point numbers and fixed-point numbers.
+ * They handle parsing, conversion, and formatting of numbers with specific decimal places.
+ * They shouldn't be used directly in the UI or business logic.
+ */
+/**
+ * Parses a floating-point string into a fixed-point number representation.
+ * @param floatingPointString The floating-point string to parse.
+ * @returns The fixed-point number representation or undefined if parsing fails.
+ */
+const parseToFixedPointNumber = (floatingPointString) => {
+    if (!floatingPointString.match(FLOATING_POINT_REGEX)) {
+        return undefined;
+    }
+    const [whole, decimals, ...extra] = floatingPointString.split(".");
+    // Only one `.` supported.
+    if (extra.length > 0) {
+        return undefined;
+    }
+    const noThousandsSeparatorWhole = whole.replace(",", "");
+    const setDecimals = decimals ?? "";
+    try {
+        return {
+            amount: BigInt([noThousandsSeparatorWhole, setDecimals].join("")),
+            decimals: setDecimals.length,
+        };
+    }
+    catch (error) {
+        return undefined;
+    }
+};
+/**
+ * Separates thousands in a number with commas.
+ * @param value The value to format.
+ * @param minDecimals The minimum number of decimal places.
+ * @param maxDecimals The maximum number of decimal places.
+ * @returns The formatted value with thousands separators.
+ */
+const separateThousandsWithComma = (value, minDecimals = 0, maxDecimals = 2) => {
+    let adjustedValue = value;
+    let adjustedMaxDecimals = maxDecimals;
+    // If passed value is not numeric we should return 0
+    if (Number.isNaN(+value.toString())) {
+        adjustedValue = 0;
+    }
+    if (typeof adjustedValue === "string") {
+        adjustedValue = +adjustedValue;
+    }
+    if (minDecimals > maxDecimals) {
+        adjustedMaxDecimals = minDecimals;
+    }
+    // Ensure maximumFractionDigits is within allowed range [0, 20]
+    const safeMaxDecimals = Math.max(0, Math.min(adjustedMaxDecimals, 20));
+    // @ts-expect-error - `maximumFractionDigits` wants to get number less than 21,
+    // but as the tokens have 18 decimals have, we can safely pass a parameter
+    return adjustedValue.toLocaleString("en-US", {
+        minimumFractionDigits: minDecimals,
+        maximumFractionDigits: safeMaxDecimals,
+        roundingMode: "halfExpand",
+    });
+};
+/** PUBLIC HELPER FUNCTIONS for calculations */
+/**
+ * Multiplies a bigint with a decimal number, taking into account the decimal places.
+ *
+ * @param bigint - The bigint value to multiply.
+ * @param number - The decimal number to multiply with.
+ * @returns The result of the multiplication as a bigint.
+ */
+export const multiplyBigIntWithDecimal = (bigint, number) => {
+    const numberString = number.toString();
+    const scientificMatch = /^1e-(\d+)$/.exec(numberString);
+    // Ensure we can correctly deal with scientific number expression
+    if (scientificMatch) {
+        const exponent = parseInt(scientificMatch[1], 10);
+        const scale = BigInt(10 ** exponent);
+        return (bigint * 1n) / scale;
+    }
+    const decimalsPart = number.toString().split(".")[1];
+    const decimalsCount = decimalsPart ? decimalsPart.length : 0;
+    if (!decimalsCount)
+        return bigint * BigInt(number);
+    const scale = BigInt(10 ** decimalsCount);
+    const scaledNumber = BigInt(Math.round(number * Number(scale)));
+    return (bigint * scaledNumber) / scale;
+};
+/**
+ * Converts a fixed-point number to another fixed-point number with a different decimal precision.
+ * @param args The arguments for the conversion.
+ *  - amount: required, the fixed-point number to convert.
+ *  - decimals: required, the current decimal precision of the number.
+ *  - targetDecimals: required, the target decimal precision for the conversion.
+ * @returns The converted fixed-point number.
+ */
+export const convertDecimals = ({ amount, decimals, targetDecimals, }) => {
+    if (decimals >= targetDecimals) {
+        return amount / 10n ** BigInt(decimals - targetDecimals);
+    }
+    return amount * 10n ** BigInt(targetDecimals - decimals);
+};
+/** Helper functions for input components */
+/**
+ * Trims decimal places to a specified precision - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of decimal places to keep
+ * @returns The trimmed value
+ */
+export const trimDecimals = (value, precision) => {
+    const [integerPart, decimalPart = ""] = value.split(".");
+    return decimalPart.length > precision
+        ? `${integerPart}.${decimalPart.slice(0, precision)}`
+        : value;
+};
+/**
+ * Trims integer part to a specified length - NO ROUNDING!
+ * @param value The value to trim
+ * @param precision The number of integer places to keep
+ * @returns The trimmed value
+ * @deprecated just compare the value to the max allowed value in the input component
+ */
+export const trimBeforeDecimals = (value, precision) => {
+    const [integerPart, decimalPart = ""] = value.split(".");
+    return integerPart.length > precision
+        ? `${integerPart.slice(0, precision)}.${decimalPart}`
+        : value;
+};
+/**
+ * Normalizes a decimal number input by removing invalid characters and preventing multiple dots.
+ * @param value The value to normalize
+ * @returns The normalized value
+ */
+export const normalizeDecimalNumber = (value) => value.replace(/[^0-9.]/g, "").replace(/\.(?=.*\.)/g, ""); // Remove all dots except the first one
+/**
+ * CONVERSION FUNCTIONS
+ * These functions convert between floating-point numbers and big integers as well as
+ * provide human-readable formats.
+ *
+ * They are used to ensure that numbers are correctly formatted for display and calculations
+ * and should be used in the UI and business logic to ensure correct number formatting.
+ */
+/** Basic conversion bigint <-> float  */
+/**
+ * Converts a floating-point number to a big integer representation.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ * @returns The big integer representation of the floating-point number.
+ */
+export const floatToBigInt = ({ amount, decimals = 18, }) => {
+    const parsedAmount = amount.toString();
+    const fixedPointAmount = parseToFixedPointNumber(parsedAmount);
+    if (typeof fixedPointAmount === "undefined") {
+        return 0n;
+    }
+    const bigIntAmount = convertDecimals({
+        amount: fixedPointAmount.amount,
+        decimals: fixedPointAmount.decimals,
+        targetDecimals: decimals,
+    });
+    return bigIntAmount;
+};
+/**
+ * Converts a big integer representation to a floating-point number.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the big integer representation to convert.
+ *   - decimals: optional, the number of decimal places to consider.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ * @returns The floating-point representation of the big integer.
+ */
+export const bigIntToFloat = ({ amount, decimals = 18, desiredDecimals = decimals, }) => {
+    let isNegative = false;
+    let normalizedAmount = amount;
+    if (amount < 0n) {
+        normalizedAmount = -amount;
+        isNegative = true;
+    }
+    const desiredDecimalsAmount = normalizedAmount / 10n ** BigInt(Math.max(0, decimals - desiredDecimals));
+    // Desired decimals amount with additional decimal to check if number
+    // should be rounded up
+    const desiredDecimalsAmountWithAdditionalDecimal = normalizedAmount /
+        10n ** BigInt(Math.max(0, decimals - desiredDecimals - 1));
+    // We are getting the first value that has been cut off
+    const firstDecimalAfterCutOff = desiredDecimalsAmountWithAdditionalDecimal
+        .toString()
+        .at(-1);
+    // Padding amount when its length is smaller than desired
+    const parsedDesiredAmount = desiredDecimalsAmount
+        .toString()
+        .padStart(desiredDecimals + 1, "0");
+    const integersPart = parsedDesiredAmount.slice(0, -desiredDecimals);
+    const decimalsPart = parsedDesiredAmount.slice(-desiredDecimals);
+    // If number is above or equal to 5 we should round up the number
+    const shouldIncreaseDecimalsPart = Number(firstDecimalAfterCutOff) >= 5 && desiredDecimals !== decimals;
+    // If above is true we add 1 to the decimals value and convert it back to string
+    const adjustedDecimalsPart = shouldIncreaseDecimalsPart
+        ? (Number(decimalsPart) + 1).toString().padStart(desiredDecimals, "0")
+        : decimalsPart;
+    // Determining whether integer part needs to be increased due to rounding up
+    const shouldIncreaseIntegerPart = (decimalsPart === "0" && adjustedDecimalsPart !== decimalsPart) ||
+        adjustedDecimalsPart.length > decimalsPart.length;
+    // If above is true we add 1 to the integers value and convert it back to string
+    // and set first value of decimals part to 0
+    const adjustedIntegersPart = shouldIncreaseIntegerPart
+        ? (Number(integersPart) + 1).toString()
+        : integersPart;
+    const decimalsPartAfterIntegersAdjustments = shouldIncreaseIntegerPart
+        ? `0${adjustedDecimalsPart.slice(1)}`
+        : adjustedDecimalsPart;
+    // Inserting "." to separate integers part from decimal part
+    const desiredAmount = [
+        ...adjustedIntegersPart,
+        ".",
+        ...decimalsPartAfterIntegersAdjustments,
+    ].join("");
+    // Remove trailing zeros and the trailing decimal point (if exists)
+    const trimmedDesiredAmount = desiredAmount.replace(/(?:\.0*|(\.\d+?)0+)$/, "$1");
+    return isNegative ? `-${trimmedDesiredAmount}` : trimmedDesiredAmount;
+};
+/**
+ * Helpers for setting correct arguments and getting unified human-readable
+ * formats across the app with _toHumanReadableFormat functions.
+ */
+export const amountAsUSD = (args) => ({
+    desiredDecimals: 2,
+    minDecimals: 2,
+    ...args,
+});
+export const amountAsToken = (args) => ({
+    desiredDecimals: FRIENDLY_DECIMALS_AMOUNT,
+    minDecimals: 0,
+    ...args,
+});
+export const amountAsMusd = (args) => ({
+    desiredDecimals: 2,
+    minDecimals: 2,
+    decimals: 18, // MUSD has 18 decimals
+    ...args,
+});
+export const amountAsMats = (args) => ({
+    desiredDecimals: 0,
+    minDecimals: 0,
+    ...args,
+});
+/**
+ * Converts a floating-point number to a human-readable format - with thousands
+ * separators and specified decimal places.
+ * @param args The arguments for the conversion.
+ *   - amount: required, the floating-point number to convert.
+ *   - desiredDecimals: optional, the desired number of decimal places for the output.
+ *   - minDecimals: optional, the minimum number of decimal places.
+ * @returns The human-readable format of the floating-point number.
+ */
+export const floatToHumanReadableFormat = ({ amount, desiredDecimals = 2, // treat is as an USD amount by default
+minDecimals = 0, }) => separateThousandsWithComma(amount, minDecimals, desiredDecimals);
+export const bigIntToHumanReadableFormat = ({ amount, decimals = 18, desiredDecimals = FRIENDLY_DECIMALS_AMOUNT, // treat is as a token by default
+minDecimals = 0, }) => {
+    let isNegative = false;
+    let normalizedAmount = amount;
+    let adjustedDesiredDecimals = desiredDecimals;
+    if (minDecimals > desiredDecimals) {
+        adjustedDesiredDecimals = minDecimals;
+    }
+    if (normalizedAmount < 0n) {
+        normalizedAmount = -normalizedAmount;
+        isNegative = true;
+    }
+    const trimmedDesiredAmount = bigIntToFloat({
+        amount: normalizedAmount,
+        decimals,
+        desiredDecimals: adjustedDesiredDecimals,
+    });
+    if (trimmedDesiredAmount === "0" && normalizedAmount !== 0n) {
+        const decimalsString = "1".padStart(adjustedDesiredDecimals, "0");
+        return `<0.${decimalsString}`;
+    }
+    const desiredValue = isNegative
+        ? `-${trimmedDesiredAmount}`
+        : trimmedDesiredAmount;
+    return floatToHumanReadableFormat({
+        amount: desiredValue,
+        desiredDecimals: adjustedDesiredDecimals,
+        minDecimals,
+    });
+};
+//# sourceMappingURL=number2.js.map

package/dist/src/utils/number2.js.map

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

package/dist/src/utils/numbers.d.ts

@@ -1,43 +1,25 @@
+type CompactStringDecimals = Intl.NumberFormatOptions["minimumFractionDigits"] & BigIntToLocaleStringOptions["minimumFractionDigits"];
 /**
- * Formats a number or bigint into a human-readable string with K, M, B, or T suffix.
+ * Formats a number or bigint into compact string with K, M, B, or T suffix.
  * @param value The number or bigint to format.
  * @param decimals Number of decimal places to include (ignored for bigint to avoid floating point issues).
  * @returns The formatted number as a string.
  */
-export declare function formatHumanReadableNumber(value: number | bigint, decimals?: number): string;
+export declare function formatNumberToCompactString(value: number | bigint, decimals?: CompactStringDecimals): string;
 /**
- * Returns a number rounded up to the desired number of decimals.
- * @param amount The number to round up.
- * @param desiredDecimals The number of decimals to round up to.
- * @returns The rounded up number.
- * @see https://github.com/thesis/acre/blob/main/dapp/src/utils/numbersUtils.ts#L1-L3
+ * Normalizes a bigint value to a target precision.
+ * @param value The bigint value to normalize.
+ * @param currentPrecision The current precision of the value.
+ * @param targetPrecision The target precision to normalize to.
+ * @returns The normalized bigint value.
  */
-export declare function roundUpNumber(amount: number, desiredDecimals?: number): number;
+export declare const normalizePrecision: (value: bigint, currentPrecision: number, targetPrecision?: number) => bigint;
 /**
- * Convert a fixed point bigint with precision `fixedPointDecimals` to a
- * floating point number truncated to `desiredDecimals`.
- * @param fixedPoint The fixed point bigint to convert.
- * @param fixedPointDecimals The number of decimals in the fixed point bigint.
- * @param desiredDecimals The number of decimals in the output number.
- * @returns The floating point number truncated to `desiredDecimals`.
- * @see https://github.com/tahowallet/extension/blob/main/background/lib/fixed-point.ts#L216-L239
+ * Utility function to find the maximum value from given `BigInt` values.
+ * @param values Array of BigInt values to find the maximum from.
+ * @returns The maximum value from the provided `BigInt` values.
+ * @dev Works exactly like `Math.max` but for `BigInt` values.
  */
-export declare function fromFixedPoint(fixedPoint: bigint, fixedPointDecimals: number, desiredDecimals?: number): number;
-/**
- * Display a cryptoAsset amount correctly with desired decimals.
- * The function returns a string with a language-sensitive representation of this number.
- * - If the amount entered is zero, return the result with the desired decimals.
- *   For example, 0.00 for a precision of 2.
- * - If `formattedAmount` is less than the minimum amount to display
- *  for the specified precision return information about this.
- *  For example, <0.01 for a precision of 2.
- *  - Other amounts are formatted according to the use of the `bigIntToUserAmount` function.
- * @param amount The amount of tokens to format.
- * @param decimals The number of decimals the cryptoAsset has.
- * @param desiredDecimals The number of decimals to display.
- * @param withRoundUp If true, the amount will be rounded up.
- * @returns The formatted cryptoAsset amount.
- * @see https://github.com/thesis/acre/blob/main/dapp/src/utils/numbersUtils.ts#L57-L87
- */
-export declare function formatTokenAmount(amount: number | string | bigint, decimals?: number, desiredDecimals?: number, withRoundUp?: boolean): string;
+export declare const bigIntMax: (...values: bigint[]) => bigint;
+export {};
 //# sourceMappingURL=numbers.d.ts.map

package/dist/src/utils/numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../../src/utils/numbers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,MAAU,GACnB,MAAM,CAgBR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,SAAI,GAAG,MAAM,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,SAAI,GAClB,MAAM,CAUR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAChC,QAAQ,SAAK,EACb,eAAe,SAAI,EACnB,WAAW,UAAQ,UA0BpB"}
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../../src/utils/numbers.ts"],"names":[],"mappings":"AAAA,KAAK,qBAAqB,GAAG,IAAI,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,GAC5E,2BAA2B,CAAC,uBAAuB,CAAC,CAAA;AACtD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,GAAE,qBAAyB,GAClC,MAAM,CAMR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,kBAAkB,MAAM,EACxB,wBAAkC,KACjC,MAQF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,QAAQ,MAAM,EAAE,KAAG,MACY,CAAA"}

package/dist/src/utils/numbers.js

@@ -1,81 +1,37 @@
 /**
- * Formats a number or bigint into a human-readable string with K, M, B, or T suffix.
+ * Formats a number or bigint into compact string with K, M, B, or T suffix.
  * @param value The number or bigint to format.
  * @param decimals Number of decimal places to include (ignored for bigint to avoid floating point issues).
  * @returns The formatted number as a string.
  */
-export function formatHumanReadableNumber(value, decimals = 4) {
-    const suffixes = ["", "K", "M", "B", "T"];
-    const numericValue = typeof value === "bigint" ? Number(value) : value;
-    if (numericValue < 1000)
-        return numericValue.toFixed(decimals);
-    const magnitude = Math.floor(Math.log10(numericValue) / 3);
-    if (magnitude >= suffixes.length) {
-        const max = 10 ** ((suffixes.length - 1) * 3) * 1000 - 1;
-        const capped = max / 10 ** ((suffixes.length - 1) * 3);
-        return `> ${capped.toFixed(0)}${suffixes[suffixes.length - 1]}`;
-    }
-    const scaledValue = numericValue / 10 ** (magnitude * 3);
-    return `${scaledValue.toFixed(decimals)}${suffixes[magnitude]}`;
-}
-/**
- * Returns a number rounded up to the desired number of decimals.
- * @param amount The number to round up.
- * @param desiredDecimals The number of decimals to round up to.
- * @returns The rounded up number.
- * @see https://github.com/thesis/acre/blob/main/dapp/src/utils/numbersUtils.ts#L1-L3
- */
-export function roundUpNumber(amount, desiredDecimals = 2) {
-    return Math.ceil(amount * 10 ** desiredDecimals) / 10 ** desiredDecimals;
-}
-/**
- * Convert a fixed point bigint with precision `fixedPointDecimals` to a
- * floating point number truncated to `desiredDecimals`.
- * @param fixedPoint The fixed point bigint to convert.
- * @param fixedPointDecimals The number of decimals in the fixed point bigint.
- * @param desiredDecimals The number of decimals in the output number.
- * @returns The floating point number truncated to `desiredDecimals`.
- * @see https://github.com/tahowallet/extension/blob/main/background/lib/fixed-point.ts#L216-L239
- */
-export function fromFixedPoint(fixedPoint, fixedPointDecimals, desiredDecimals = 2) {
-    const fixedPointDesiredDecimalsAmount = fixedPoint /
-        10n ** BigInt(Math.max(1, fixedPointDecimals - desiredDecimals));
-    const formattedAmount = Number(fixedPointDesiredDecimalsAmount) /
-        10 ** Math.min(desiredDecimals, fixedPointDecimals);
-    return formattedAmount;
+export function formatNumberToCompactString(value, decimals = 2) {
+    return value.toLocaleString("en-US", {
+        notation: "compact",
+        compactDisplay: "short",
+        maximumFractionDigits: decimals,
+    });
 }
 /**
- * Display a cryptoAsset amount correctly with desired decimals.
- * The function returns a string with a language-sensitive representation of this number.
- * - If the amount entered is zero, return the result with the desired decimals.
- *   For example, 0.00 for a precision of 2.
- * - If `formattedAmount` is less than the minimum amount to display
- *  for the specified precision return information about this.
- *  For example, <0.01 for a precision of 2.
- *  - Other amounts are formatted according to the use of the `bigIntToUserAmount` function.
- * @param amount The amount of tokens to format.
- * @param decimals The number of decimals the cryptoAsset has.
- * @param desiredDecimals The number of decimals to display.
- * @param withRoundUp If true, the amount will be rounded up.
- * @returns The formatted cryptoAsset amount.
- * @see https://github.com/thesis/acre/blob/main/dapp/src/utils/numbersUtils.ts#L57-L87
+ * Normalizes a bigint value to a target precision.
+ * @param value The bigint value to normalize.
+ * @param currentPrecision The current precision of the value.
+ * @param targetPrecision The target precision to normalize to.
+ * @returns The normalized bigint value.
  */
-export function formatTokenAmount(amount, decimals = 18, desiredDecimals = 2, withRoundUp = false) {
-    const fixedPoint = BigInt(amount);
-    if (fixedPoint === 0n) {
-        return `0.${"0".repeat(desiredDecimals)}`;
+export const normalizePrecision = (value, currentPrecision, targetPrecision = currentPrecision) => {
+    if (currentPrecision > targetPrecision) {
+        return value / 10n ** BigInt(currentPrecision - targetPrecision);
     }
-    const formattedAmount = fromFixedPoint(fixedPoint, decimals, 
-    // To round the amount up, let's increase the precision by one.
-    // The desired decimal numbers will be set later anyway.
-    withRoundUp ? desiredDecimals + 1 : desiredDecimals);
-    const minAmountToDisplay = 1 / 10 ** Math.min(desiredDecimals, decimals);
-    if (minAmountToDisplay > formattedAmount) {
-        return `<0.${"0".repeat(desiredDecimals - 1)}1`;
+    if (currentPrecision < targetPrecision) {
+        return value * 10n ** BigInt(targetPrecision - currentPrecision);
     }
-    const finalFormattedAmount = withRoundUp
-        ? roundUpNumber(formattedAmount, desiredDecimals)
-        : formattedAmount;
-    return formatHumanReadableNumber(finalFormattedAmount, desiredDecimals);
-}
+    return value;
+};
+/**
+ * Utility function to find the maximum value from given `BigInt` values.
+ * @param values Array of BigInt values to find the maximum from.
+ * @returns The maximum value from the provided `BigInt` values.
+ * @dev Works exactly like `Math.max` but for `BigInt` values.
+ */
+export const bigIntMax = (...values) => values.reduce((max, value) => (value > max ? value : max));
 //# sourceMappingURL=numbers.js.map

package/dist/src/utils/numbers.js.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../../src/utils/numbers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../../src/utils/numbers.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAsB,EACtB,WAAkC,CAAC;IAEnC,OAAO,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE;QACnC,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,OAAO;QACvB,qBAAqB,EAAE,QAAQ;KAChC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAa,EACb,gBAAwB,EACxB,eAAe,GAAG,gBAAgB,EAC1B,EAAE;IACV,IAAI,gBAAgB,GAAG,eAAe,EAAE,CAAC;QACvC,OAAO,KAAK,GAAG,GAAG,IAAI,MAAM,CAAC,gBAAgB,GAAG,eAAe,CAAC,CAAA;IAClE,CAAC;IACD,IAAI,gBAAgB,GAAG,eAAe,EAAE,CAAC;QACvC,OAAO,KAAK,GAAG,GAAG,IAAI,MAAM,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,MAAgB,EAAU,EAAE,CACvD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA"}

package/dist/src/utils/numbers.test.js

@@ -1,68 +1,72 @@
-import { formatHumanReadableNumber, formatTokenAmount, fromFixedPoint, roundUpNumber, } from "./numbers";
-describe("formatHumanReadableNumber", () => {
+import { formatNumberToCompactString, bigIntMax, normalizePrecision, } from "./numbers";
+describe("formatNumberToCompactString", () => {
     it("formats number less than 1000 with decimals", () => {
-        expect(formatHumanReadableNumber(123.456789, 2)).toBe("123.46");
+        expect(formatNumberToCompactString(123.456789, 2)).toBe("123.46");
     });
     it("formats thousands with K", () => {
-        expect(formatHumanReadableNumber(12_345, 2)).toBe("12.35K");
+        expect(formatNumberToCompactString(12_345, 2)).toBe("12.35K");
     });
     it("formats millions with M", () => {
-        expect(formatHumanReadableNumber(12_345_678, 2)).toBe("12.35M");
+        expect(formatNumberToCompactString(12_345_678, 2)).toBe("12.35M");
     });
     it("formats billions with B", () => {
-        expect(formatHumanReadableNumber(12_345_678_901, 2)).toBe("12.35B");
+        expect(formatNumberToCompactString(12_345_678_901, 2)).toBe("12.35B");
     });
     it("formats trillions with T", () => {
-        expect(formatHumanReadableNumber(12_345_678_901_234, 2)).toBe("12.35T");
+        expect(formatNumberToCompactString(12_345_678_901_234, 2)).toBe("12.35T");
     });
     it("formats bigint as readable number", () => {
-        expect(formatHumanReadableNumber(1234567890123456789n, 2)).toBe("> 1000T");
+        expect(formatNumberToCompactString(1234567890123456789n, 2)).toBe("1,234,567.89T");
     });
     it("caps at > 1000T for huge numbers", () => {
         const hugeNumber = 10 ** 18; // 1e18
-        expect(formatHumanReadableNumber(hugeNumber, 2)).toBe("> 1000T");
+        expect(formatNumberToCompactString(hugeNumber, 2)).toBe("1,000,000T");
     });
-});
-describe("roundUpNumber", () => {
-    it("rounds up to 2 decimals", () => {
-        expect(roundUpNumber(1.234)).toBe(1.24);
-    });
-    it("rounds up to 3 decimals", () => {
-        expect(roundUpNumber(9.87654, 3)).toBe(9.877);
-    });
-    it("rounds up exact decimal", () => {
-        expect(roundUpNumber(2.5, 1)).toBe(2.5);
+    it("formats numbers with trailing zeros correctly", () => {
+        expect(formatNumberToCompactString(1_000, 2)).toBe("1K");
     });
 });
-describe("fromFixedPoint", () => {
-    it("converts fixed point with 18 decimals to float", () => {
-        const raw = 1234567890000000000n; // 1.23456789 ETH in 18 decimals
-        expect(fromFixedPoint(raw, 18, 4)).toBe(1.2345);
+describe("bigIntMax", () => {
+    it("returns the maximum of positive bigint values", () => {
+        expect(bigIntMax(1n, 2n, 3n)).toBe(3n);
     });
-    it("converts with truncation to 2 decimals", () => {
-        const raw = 987654321000000000n; // ~0.987654321 ETH
-        expect(fromFixedPoint(raw, 18, 2)).toBe(0.98);
+    it("returns the maximum of negative bigint values", () => {
+        expect(bigIntMax(-10n, -5n, -20n)).toBe(-5n);
     });
-    it("handles large fixedPoint decimals", () => {
-        const raw = 1000000000000000000000000n; // 1M with 6 decimals
-        expect(fromFixedPoint(raw, 6, 2)).toBe(1000000000000000000);
+    it("returns the only element if array has one bigint", () => {
+        expect(bigIntMax(42n)).toBe(42n);
     });
-});
-describe("formatTokenAmount", () => {
-    it("formats zero value with desired decimals", () => {
-        expect(formatTokenAmount(0, 18, 3)).toBe("0.000");
-        expect(formatTokenAmount("0", 18, 2)).toBe("0.00");
+    it("works with a mix of positive and negative bigints", () => {
+        expect(bigIntMax(-100n, 0n, 50n, -10n)).toBe(50n);
     });
-    it("returns <0.01 if amount is less than minimum display value", () => {
-        expect(formatTokenAmount("1", 18, 2)).toBe("<0.01"); // 1 wei = 1e-18
+    it("throws an error if called with no arguments", () => {
+        expect(() => bigIntMax()).toThrow();
     });
-    it("formats a normal value without rounding", () => {
-        const result = formatTokenAmount("1230000000000000000", 18, 2);
-        expect(result).toBe("1.23");
+    it("returns the correct value when all values are equal", () => {
+        expect(bigIntMax(5n, 5n, 5n)).toBe(5n);
     });
-    it("formats with rounding if withRoundUp = true", () => {
-        const result = formatTokenAmount("1234560000000000000", 18, 2, true);
-        expect(result).toBe("1.24");
+});
+describe("normalizePrecision", () => {
+    it("reduces precision correctly (scale down)", () => {
+        const result = normalizePrecision(1234500n, 6, 3);
+        expect(result).toBe(1234n);
+    });
+    it("increases precision correctly (scale up)", () => {
+        const result = normalizePrecision(1234n, 3, 6);
+        expect(result).toBe(1234000n);
+    });
+    it("returns the same value when precision is equal", () => {
+        const result = normalizePrecision(987654321n, 5, 5);
+        expect(result).toBe(987654321n);
+    });
+    it("handles zero value correctly", () => {
+        const result = normalizePrecision(0n, 4, 8);
+        expect(result).toBe(0n);
+    });
+    it("handles large numbers without precision loss", () => {
+        const value = 123456789012345678901234567890n;
+        const result = normalizePrecision(value, 18, 20);
+        expect(result).toBe(value * 100n);
     });
 });
 //# sourceMappingURL=numbers.test.js.map

package/dist/src/utils/numbers.test.js.map

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