@stellar-expert/formatter 2.3.0 → 2.5.0

package/README.md

@@ -3,11 +3,7 @@
 ## Installation
 
 ```
- "dependencies": {
-    "@stellar-expert/formatter": "github:stellar-expert/formatter#v2.0.0",
-    ...
-  }
-}
+npm i @stellar-expert/formatter
 ```
 
 ## Usage

package/lib/formatter.js

@@ -0,0 +1,368 @@
+(function webpackUniversalModuleDefinition(root, factory) {
+	if(typeof exports === 'object' && typeof module === 'object')
+		module.exports = factory();
+	else if(typeof define === 'function' && define.amd)
+		define([], factory);
+	else if(typeof exports === 'object')
+		exports["formatter"] = factory();
+	else
+		root["formatter"] = factory();
+})(this, () => {
+return /******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	// The require scope
+/******/ 	var __webpack_require__ = {};
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/define property getters */
+/******/ 	(() => {
+/******/ 		// define getter functions for harmony exports
+/******/ 		__webpack_require__.d = (exports, definition) => {
+/******/ 			for(var key in definition) {
+/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
+/******/ 				}
+/******/ 			}
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+var __webpack_exports__ = {};
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  "default": () => (/* binding */ commonjs)
+});
+
+;// CONCATENATED MODULE: ./src/truncation.js
+/**
+ * Remove trailing zero symbols from a formatted numeric string
+ * @param {String} value
+ * @return {String}
+ */
+function stripTrailingZeros(value) {
+  if (typeof value !== 'string') return value;
+  let [int, reminder] = value.split('.');
+  if (!reminder) return int;
+  reminder = reminder.replace(/0+$/, '');
+  if (!reminder.length) return int;
+  return int + '.' + reminder;
+}
+
+/**
+ * Truncate strings longer than N symbols replacing characters in the middle with ellipsis
+ * @param {String} value - Original string
+ * @param {Number} [symbols] - Maximum string length
+ * @return {String}
+ */
+function shortenString(value, symbols = 8) {
+  if (!value || value.length <= symbols) return value;
+  const affixLength = Math.max(2, Math.floor(symbols / 2));
+  return value.substring(0, affixLength) + '…' + value.substring(value.length - affixLength);
+}
+;// CONCATENATED MODULE: ./src/stroops.js
+
+
+/**
+ * Convert value in stroops (Int64 amount) to the normal string representation
+ * @param {String|Number|BigInt} valueInStroops
+ * @return {String}
+ */
+function fromStroops(valueInStroops) {
+  try {
+    let parsed = typeof valueInStroops === 'bigint' ? valueInStroops : BigInt(valueInStroops.toString().replace(/\.\d*/, ''));
+    let negative = false;
+    if (parsed < 0n) {
+      negative = true;
+      parsed *= -1n;
+    }
+    const int = parsed / 10000000n;
+    const fract = parsed % 10000000n;
+    let res = int.toString();
+    if (fract) {
+      res += '.' + fract.toString().padStart(7, '0');
+    }
+    if (negative) {
+      res = '-' + res;
+    }
+    return stripTrailingZeros(res);
+  } catch (e) {
+    return '0';
+  }
+}
+
+/**
+ * Convert arbitrary stringified amount to int64 representation
+ * @param {String|Number} value
+ * @return {BigInt}
+ */
+function toStroops(value) {
+  if (!value) return 0n;
+  if (typeof value === 'number') {
+    value = value.toFixed(7);
+  }
+  if (typeof value !== 'string' || !/^-?[\d.,]+$/.test(value)) return 0n; //invalid format
+  try {
+    let [int, decimal = '0'] = value.split('.', 2);
+    let negative = false;
+    if (int.startsWith('-')) {
+      negative = true;
+      int = int.slice(1);
+    }
+    let res = BigInt(int) * 10000000n + BigInt(decimal.slice(0, 7).padEnd(7, '0'));
+    if (negative) {
+      res *= -1n;
+      if (res < -0x8000000000000000n)
+        //overflow
+        return 0n;
+    } else if (res > 0xFFFFFFFFFFFFFFFFn)
+      //overflow
+      return 0n;
+    return res;
+  } catch (e) {
+    return 0n;
+  }
+}
+;// CONCATENATED MODULE: ./src/numeric-format.js
+
+
+function addDecimalsSeparators(value, separator = ',', trimTrailingZeros = true) {
+  //TODO: use Bignumber.toFormat() method instead
+  //split numeric to parts
+  let [int, reminder] = value.split('.');
+  let res = '';
+  //split digit groups
+  while (int.length > 3) {
+    res = separator + int.substring(int.length - 3) + res;
+    int = int.substring(0, int.length - 3);
+  }
+  //strip negative sign
+  if (int === '-') {
+    res = res.substring(1);
+  }
+  res = int + res;
+  if (reminder) {
+    res += '.' + reminder;
+  }
+  if (trimTrailingZeros) {
+    res = stripTrailingZeros(res);
+  }
+  return res;
+}
+
+/**
+ * Check if a provided value can be safely used as token amount in Stellar operations
+ * @param {String} value
+ * @param {Boolean} denominate
+ * @param {Boolean} nonZero
+ * @return {Boolean}
+ */
+function isValidInt64Amount(value, denominate = true, nonZero = false) {
+  try {
+    const parsed = denominate ? toStroops(value) : BigInt(value);
+    if (nonZero) {
+      if (parsed <= 0n) return false;
+    } else {
+      if (parsed < 0n) return false;
+    }
+    return parsed <= 9223372036854775807n;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * Format a number with specified precision and decimals separator
+ * @param {String|Number|BigInt} value - Numeric value to format
+ * @param {Number} [precision] - Desired precision (7 digits by default)
+ * @param {String} [separator] - Decimals separator
+ * @return {String}
+ */
+function formatWithPrecision(value, precision = 7, separator = ',') {
+  return addDecimalsSeparators(setPrecision(value, precision), separator, true);
+}
+
+/**
+ * Format a number using automatically determined precision
+ * @param {String|Number} value - Numeric value to format
+ * @param {String} [separator] - Decimals separator
+ * @return {String}
+ */
+function formatWithAutoPrecision(value, separator = ',') {
+  if (!value) return '0';
+  const p = Math.ceil(Math.log10(parseFloat(value)));
+  let reminderPrecision = p > 1 ? 3 - p : Math.abs(p) + 2;
+  if (reminderPrecision < 0) {
+    reminderPrecision = 0;
+  }
+  return formatWithPrecision(value, reminderPrecision, separator);
+}
+
+/**
+ * Convert a number to a human-readable format using abbreviation
+ * @param {Number} value - Value to format
+ * @param {Number} [decimals] - Precision of the abbreviated string to retain
+ * @return {String}
+ */
+function formatWithAbbreviation(value, decimals = 2) {
+  let abs = Math.abs(value);
+  const tier = Math.log10(abs) / 3 | 0;
+  if (tier <= 0) return formatWithAutoPrecision(value);
+  const suffix = ['', 'K', 'M', 'G', 'T', 'P'][tier];
+  abs = stripTrailingZeros((abs / Math.pow(10, tier * 3)).toFixed(decimals));
+  return `${value < 0 ? '-' : ''}${abs || '0'}${suffix}`;
+}
+
+/**
+ * Format a number with rounding to specific precision group
+ * @param {String|Number|BigInt} value - Value to format
+ * @param {Number} group - Logarithmic group rate for rounding
+ * @return {String}
+ */
+function formatWithGrouping(value, group) {
+  if (!value) return '0';
+  const precision = group >= 1 || group === 0 ? 0 : Math.abs(Math.log10(group));
+  if (group >= 1) {
+    value = Math.ceil(value / group) * group;
+  }
+  return formatWithPrecision(value, precision);
+}
+
+/**
+ * Format a number as price with specified significant digits precision
+ * @param {String|Number|Bignumber} value - Value to format
+ * @param {Number} significantDigits - Significant digits for automatic formatting
+ * @return {String}
+ */
+function formatPrice(value, significantDigits = 4) {
+  const primitive = typeof value === 'number' ? value.toFixed(7) : value.toString();
+  const [int, fract] = primitive.split('.');
+  if (int.replace('-', '') !== '0') {
+    significantDigits -= int.length;
+    if (significantDigits < 0) {
+      significantDigits = 0;
+    }
+  } else {
+    if (!(fract > 0)) return '0';
+    significantDigits = Math.max(Math.ceil(Math.abs(Math.log10(parseFloat('.' + fract)))), significantDigits);
+  }
+  return formatWithPrecision(value, significantDigits, '');
+}
+
+/**
+ * Format amount according to default Stellar precision
+ * @param {Number|String} amount - Value to format
+ * @return {String}
+ */
+function adjustPrecision(amount = '0') {
+  return stripTrailingZeros(setPrecision(amount, 7));
+}
+function setPrecision(amount, precision) {
+  if (typeof amount === 'number') {
+    amount = amount.toFixed(precision);
+  } else {
+    amount = amount.toString();
+    const sidx = amount.indexOf('.');
+    if (sidx >= 0) {
+      amount = amount.slice(0, sidx + precision + 1);
+    }
+  }
+  return amount;
+}
+;// CONCATENATED MODULE: ./src/timestamp-format.js
+/**
+ * Convert any timestamp representation to a valid date format
+ * @param {Date|String|Number} date - Date to parse
+ * @param {Boolean} [autoUnixFormatDetection] - Intelligent guess for dates already represented as UNIX timestamp (true by default)
+ * @return {Date} Parsed date
+ */
+function normalizeDate(date, autoUnixFormatDetection = true) {
+  //try parse string representation
+  if (typeof date === 'string') {
+    if (!/^\d+$/.test(date)) {
+      if (!date.endsWith('Z')) {
+        date += 'Z';
+      }
+      date = new Date(date);
+    } else {
+      date = parseInt(date);
+    }
+  }
+  //parse numeric representation
+  if (typeof date === 'number') {
+    //input resembles a UNIX timestamp
+    if (date < 2147483648 && autoUnixFormatDetection) {
+      date *= 1000;
+    }
+    date = new Date(date);
+  }
+  //check validity
+  if (!(date instanceof Date) || isNaN(date.valueOf())) throw new Error('Invalid timestamp ' + date);
+  return date;
+}
+
+/**
+ * Convert date to a numeric UNIX timestamp representation
+ * @param {Date|String|Number} date - Date to convert
+ * @return {Number} UNIX timestamp
+ */
+function toUnixTimestamp(date) {
+  return Math.floor(normalizeDate(date).getTime() / 1000);
+}
+
+/**
+ * Convert date to ISO-like human-readable format
+ * @param {Date|String|Number} date - Date to convert
+ * @return {String}
+ */
+function formatDateUTC(date) {
+  return normalizeDate(date).toISOString().replace(/(T|\.\d+Z)/g, ' ') // make it more human friendly
+  .trim();
+}
+;// CONCATENATED MODULE: ./src/approximation.js
+/**
+ * Convert rational price representation to Number
+ * @param {{n: Number, d: Number}|Number|String} price
+ * @return {Number}
+ */
+function approximatePrice(price) {
+  if (!price) return 0;
+  if (price.n) return price.n / price.d;
+  if (typeof price === 'string') return parseFloat(price);
+  return price;
+}
+;// CONCATENATED MODULE: ./src/commonjs.js
+
+
+
+
+
+const formatter = {
+  adjustPrecision: adjustPrecision,
+  formatWithAutoPrecision: formatWithAutoPrecision,
+  formatWithAbbreviation: formatWithAbbreviation,
+  formatWithGrouping: formatWithGrouping,
+  formatWithPrecision: formatWithPrecision,
+  formatPrice: formatPrice,
+  isValidInt64Amount: isValidInt64Amount,
+  formatDateUTC: formatDateUTC,
+  normalizeDate: normalizeDate,
+  toUnixTimestamp: toUnixTimestamp,
+  approximatePrice: approximatePrice,
+  shortenString: shortenString,
+  stripTrailingZeros: stripTrailingZeros,
+  toStroops: toStroops,
+  fromStroops: fromStroops
+};
+/* harmony default export */ const commonjs = (formatter);
+__webpack_exports__ = __webpack_exports__["default"];
+/******/ 	return __webpack_exports__;
+/******/ })()
+;
+});
+//# sourceMappingURL=formatter.js.map

package/lib/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","mappings":"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","sources":["webpack://formatter/webpack/universalModuleDefinition","webpack://formatter/webpack/bootstrap","webpack://formatter/webpack/runtime/define property getters","webpack://formatter/webpack/runtime/hasOwnProperty shorthand","webpack://formatter/./src/truncation.js","webpack://formatter/./src/stroops.js","webpack://formatter/./src/numeric-format.js","webpack://formatter/./src/timestamp-format.js","webpack://formatter/./src/approximation.js","webpack://formatter/./src/commonjs.js"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"formatter\"] = factory();\n\telse\n\t\troot[\"formatter\"] = factory();\n})(this, () => {\nreturn ","// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","/**\n * Remove trailing zero symbols from a formatted numeric string\n * @param {String} value\n * @return {String}\n */\nexport function stripTrailingZeros(value) {\n    if (typeof value !== 'string')\n        return value\n    let [int, reminder] = value.split('.')\n    if (!reminder)\n        return int\n    reminder = reminder.replace(/0+$/, '')\n    if (!reminder.length)\n        return int\n    return int + '.' + reminder\n}\n\n/**\n * Truncate strings longer than N symbols replacing characters in the middle with ellipsis\n * @param {String} value - Original string\n * @param {Number} [symbols] - Maximum string length\n * @return {String}\n */\nexport function shortenString(value, symbols = 8) {\n    if (!value || value.length <= symbols)\n        return value\n    const affixLength = Math.max(2, Math.floor(symbols / 2))\n    return value.substring(0, affixLength) + '…' + value.substring(value.length - affixLength)\n}","import {stripTrailingZeros} from './truncation.js'\n\n/**\n * Convert value in stroops (Int64 amount) to the normal string representation\n * @param {String|Number|BigInt} valueInStroops\n * @return {String}\n */\nexport function fromStroops(valueInStroops) {\n    try {\n        let parsed = typeof valueInStroops === 'bigint' ?\n            valueInStroops :\n            BigInt(valueInStroops.toString().replace(/\\.\\d*/,''))\n        let negative = false\n        if (parsed < 0n) {\n            negative = true\n            parsed *= -1n\n        }\n        const int = parsed / 10000000n\n        const fract = parsed % 10000000n\n        let res = int.toString()\n        if (fract) {\n            res += '.' + fract.toString().padStart(7, '0')\n        }\n        if (negative) {\n            res = '-' + res\n        }\n        return stripTrailingZeros(res)\n    } catch (e) {\n        return '0'\n    }\n}\n\n\n/**\n * Convert arbitrary stringified amount to int64 representation\n * @param {String|Number} value\n * @return {BigInt}\n */\nexport function toStroops(value) {\n    if (!value)\n        return 0n\n    if (typeof value === 'number') {\n        value = value.toFixed(7)\n    }\n    if (typeof value !== 'string' || !/^-?[\\d.,]+$/.test(value))\n        return 0n //invalid format\n    try {\n        let [int, decimal = '0'] = value.split('.', 2)\n        let negative = false\n        if (int.startsWith('-')) {\n            negative = true\n            int = int.slice(1)\n        }\n        let res = BigInt(int) * 10000000n + BigInt(decimal.slice(0, 7).padEnd(7, '0'))\n        if (negative) {\n            res *= -1n\n            if (res < -0x8000000000000000n) //overflow\n                return 0n\n        } else if (res > 0xFFFFFFFFFFFFFFFFn) //overflow\n            return 0n\n        return res\n    } catch (e) {\n        return 0n\n    }\n}","import {stripTrailingZeros} from './truncation.js'\nimport {toStroops} from './stroops.js'\n\nfunction addDecimalsSeparators(value, separator = ',', trimTrailingZeros = true) {\n    //TODO: use Bignumber.toFormat() method instead\n    //split numeric to parts\n    let [int, reminder] = value.split('.')\n    let res = ''\n    //split digit groups\n    while (int.length > 3) {\n        res = separator + int.substring(int.length - 3) + res\n        int = int.substring(0, int.length - 3)\n    }\n    //strip negative sign\n    if (int === '-') {\n        res = res.substring(1)\n    }\n    res = int + res\n    if (reminder) {\n        res += '.' + reminder\n    }\n    if (trimTrailingZeros) {\n        res = stripTrailingZeros(res)\n    }\n    return res\n}\n\n/**\n * Check if a provided value can be safely used as token amount in Stellar operations\n * @param {String} value\n * @param {Boolean} denominate\n * @param {Boolean} nonZero\n * @return {Boolean}\n */\nexport function isValidInt64Amount(value, denominate = true, nonZero = false) {\n    try {\n        const parsed = denominate ?\n            toStroops(value) :\n            BigInt(value)\n        if (nonZero) {\n            if (parsed <= 0n)\n                return false\n        } else {\n            if (parsed < 0n)\n                return false\n        }\n        return parsed <= 9223372036854775807n\n    } catch (e) {\n        return false\n    }\n}\n\n/**\n * Format a number with specified precision and decimals separator\n * @param {String|Number|BigInt} value - Numeric value to format\n * @param {Number} [precision] - Desired precision (7 digits by default)\n * @param {String} [separator] - Decimals separator\n * @return {String}\n */\nexport function formatWithPrecision(value, precision = 7, separator = ',') {\n    return addDecimalsSeparators(setPrecision(value, precision), separator, true)\n}\n\n/**\n * Format a number using automatically determined precision\n * @param {String|Number} value - Numeric value to format\n * @param {String} [separator] - Decimals separator\n * @return {String}\n */\nexport function formatWithAutoPrecision(value, separator = ',') {\n    if (!value)\n        return '0'\n    const p = Math.ceil(Math.log10(parseFloat(value)))\n    let reminderPrecision = p > 1 ?\n        (3 - p) :\n        (Math.abs(p) + 2)\n    if (reminderPrecision < 0) {\n        reminderPrecision = 0\n    }\n    return formatWithPrecision(value, reminderPrecision, separator)\n}\n\n/**\n * Convert a number to a human-readable format using abbreviation\n * @param {Number} value - Value to format\n * @param {Number} [decimals] - Precision of the abbreviated string to retain\n * @return {String}\n */\nexport function formatWithAbbreviation(value, decimals = 2) {\n    let abs = Math.abs(value)\n    const tier = Math.log10(abs) / 3 | 0\n\n    if (tier <= 0)\n        return formatWithAutoPrecision(value)\n\n    const suffix = ['', 'K', 'M', 'G', 'T', 'P'][tier]\n    abs = stripTrailingZeros((abs / Math.pow(10, tier * 3)).toFixed(decimals))\n    return `${value < 0 ? '-' : ''}${abs || '0'}${suffix}`\n}\n\n/**\n * Format a number with rounding to specific precision group\n * @param {String|Number|BigInt} value - Value to format\n * @param {Number} group - Logarithmic group rate for rounding\n * @return {String}\n */\nexport function formatWithGrouping(value, group) {\n    if (!value)\n        return '0'\n    const precision = (group >= 1 || group === 0) ?\n        0 :\n        Math.abs(Math.log10(group))\n    if (group >= 1) {\n        value = Math.ceil(value / group) * group\n    }\n    return formatWithPrecision(value, precision)\n}\n\n/**\n * Format a number as price with specified significant digits precision\n * @param {String|Number|Bignumber} value - Value to format\n * @param {Number} significantDigits - Significant digits for automatic formatting\n * @return {String}\n */\nexport function formatPrice(value, significantDigits = 4) {\n    const primitive = (typeof value === 'number') ?\n        value.toFixed(7) :\n        value.toString()\n    const [int, fract] = primitive.split('.')\n    if (int.replace('-', '') !== '0') {\n        significantDigits -= int.length\n        if (significantDigits < 0) {\n            significantDigits = 0\n        }\n    } else {\n        if (!(fract > 0))\n            return '0'\n        significantDigits = Math.max(Math.ceil(Math.abs(Math.log10(parseFloat('.' + fract)))), significantDigits)\n    }\n    return formatWithPrecision(value, significantDigits, '')\n}\n\n/**\n * Format amount according to default Stellar precision\n * @param {Number|String} amount - Value to format\n * @return {String}\n */\nexport function adjustPrecision(amount = '0') {\n    return stripTrailingZeros(setPrecision(amount, 7))\n}\n\nfunction setPrecision(amount, precision) {\n    if (typeof amount === 'number') {\n        amount = amount.toFixed(precision)\n    } else {\n        amount = amount.toString()\n        const sidx = amount.indexOf('.')\n        if (sidx >= 0) {\n            amount = amount.slice(0, sidx + precision + 1)\n        }\n    }\n    return amount\n}","/**\n * Convert any timestamp representation to a valid date format\n * @param {Date|String|Number} date - Date to parse\n * @param {Boolean} [autoUnixFormatDetection] - Intelligent guess for dates already represented as UNIX timestamp (true by default)\n * @return {Date} Parsed date\n */\nexport function normalizeDate(date, autoUnixFormatDetection = true) {\n    //try parse string representation\n    if (typeof date === 'string') {\n        if (!/^\\d+$/.test(date)) {\n            if (!date.endsWith('Z')) {\n                date += 'Z'\n            }\n            date = new Date(date)\n        } else {\n            date = parseInt(date)\n        }\n    }\n    //parse numeric representation\n    if (typeof date === 'number') {\n        //input resembles a UNIX timestamp\n        if (date < 2147483648 && autoUnixFormatDetection) {\n            date *= 1000\n        }\n        date = new Date(date)\n    }\n    //check validity\n    if (!(date instanceof Date) || isNaN(date.valueOf()))\n        throw new Error('Invalid timestamp ' + date)\n    return date\n}\n\n/**\n * Convert date to a numeric UNIX timestamp representation\n * @param {Date|String|Number} date - Date to convert\n * @return {Number} UNIX timestamp\n */\nexport function toUnixTimestamp(date) {\n    return Math.floor(normalizeDate(date).getTime() / 1000)\n}\n\n/**\n * Convert date to ISO-like human-readable format\n * @param {Date|String|Number} date - Date to convert\n * @return {String}\n */\nexport function formatDateUTC(date) {\n    return normalizeDate(date)\n        .toISOString()\n        .replace(/(T|\\.\\d+Z)/g, ' ') // make it more human friendly\n        .trim()\n}","/**\n * Convert rational price representation to Number\n * @param {{n: Number, d: Number}|Number|String} price\n * @return {Number}\n */\nexport function approximatePrice(price) {\n    if (!price)\n        return 0\n    if (price.n)\n        return price.n / price.d\n    if (typeof price === 'string')\n        return parseFloat(price)\n    return price\n}","import {\r\n    adjustPrecision,\r\n    formatWithAutoPrecision,\r\n    formatWithAbbreviation,\r\n    formatWithGrouping,\r\n    formatWithPrecision,\r\n    formatPrice,\r\n    isValidInt64Amount\r\n} from './numeric-format.js'\r\nimport {formatDateUTC, normalizeDate, toUnixTimestamp} from './timestamp-format.js'\r\nimport {approximatePrice} from './approximation.js'\r\nimport {shortenString, stripTrailingZeros} from './truncation.js'\r\nimport {toStroops, fromStroops} from './stroops.js'\r\n\r\nconst formatter = {\r\n    adjustPrecision,\r\n    formatWithAutoPrecision,\r\n    formatWithAbbreviation,\r\n    formatWithGrouping,\r\n    formatWithPrecision,\r\n    formatPrice,\r\n    isValidInt64Amount,\r\n    formatDateUTC,\r\n    normalizeDate,\r\n    toUnixTimestamp,\r\n    approximatePrice,\r\n    shortenString,\r\n    stripTrailingZeros,\r\n    toStroops,\r\n    fromStroops\r\n}\r\n\r\nexport default formatter"],"names":["stripTrailingZeros","value","int","reminder","split","replace","length","shortenString","symbols","affixLength","Math","max","floor","substring","fromStroops","valueInStroops","parsed","BigInt","toString","negative","fract","res","padStart","e","toStroops","toFixed","test","decimal","startsWith","slice","padEnd","addDecimalsSeparators","separator","trimTrailingZeros","isValidInt64Amount","denominate","nonZero","formatWithPrecision","precision","setPrecision","formatWithAutoPrecision","p","ceil","log10","parseFloat","reminderPrecision","abs","formatWithAbbreviation","decimals","tier","suffix","pow","formatWithGrouping","group","formatPrice","significantDigits","primitive","adjustPrecision","amount","sidx","indexOf","normalizeDate","date","autoUnixFormatDetection","endsWith","Date","parseInt","isNaN","valueOf","Error","toUnixTimestamp","getTime","formatDateUTC","toISOString","trim","approximatePrice","price","n","d","formatter"],"sourceRoot":""}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@stellar-expert/formatter",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "Formatting utils and common formats for numeric, string, timestamp and binary data",
-  "type": "module",
-  "main": "index.js",
-  "module": "index.js",
+  "main": "./lib/formatter.js",
+  "module": "./src/index.js",
   "sideEffects": false,
+  "exports": {
+    "import": "./src/index.js",
+    "require": "./lib/formatter.js"
+  },
   "scripts": {
+    "build": "webpack --mode=production --config webpack.config.cjs",
     "test": "jest"
   },
   "repository": {
@@ -19,6 +23,11 @@
     "url": "https://github.com/stellar-expert/formatter/issues"
   },
   "devDependencies": {
-    "jest": "^29.7.0"
+    "@babel/core": "^7.24.8",
+    "@babel/preset-env": "^7.24.8",
+    "babel-loader": "^9.1.3",
+    "jest": "^29.7.0",
+    "webpack": "^5.93.0",
+    "webpack-cli": "^5.1.4"
   }
 }

package/src/index.js

@@ -0,0 +1,10 @@
+export * from './numeric-format.js'
+export * from './timestamp-format.js'
+export * from './approximation.js'
+export * from './truncation.js'
+export * from './stroops.js'
+
+//changes
+//formatLongHex -> shortenString
+//adjustAmount -> adjustPrecision
+//formatCurrency deprecated

package/index.js

@@ -1,10 +0,0 @@
-export * from './src/numeric-format.js'
-export * from './src/timestamp-format.js'
-export * from './src/approximation.js'
-export * from './src/truncation.js'
-export * from './src/stroops.js'
-
-//changes
-//formatLongHex -> shortenString
-//adjustAmount -> adjustPrecision
-//formatCurrency deprecated