@oliasoft-open-source/units 5.4.2 → 5.5.1

package/dist/index.cjs

@@ -2,24 +2,25 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_units = require("./units2.cjs");
 //#region src/rounding/cosmetic-rounding.ts
 const COSMETIC_ROUNDING_DEFAULT_PRECISION = 14;
-const safeToString = (value) => {
-	return String(require_units.toString(value));
-};
 /**
 * Applies display-only rounding to remove floating-point conversion noise.
 *
 * The value is rounded to 14 significant digits, while strings written in
 * scientific notation are preserved as entered.
 *
-* @param value - numeric value in string representation
-* @returns the cosmetically rounded string
+* - accepts number types, stringified numbers, and unit strings
+* - returns the same type as the input
+*
+* @param value - numeric value to cosmetically round
+* @returns the cosmetically rounded value
 *
 * @example
-* roundNumberCosmetic('9750.000000000004') -> '9750'
+* roundCosmetic('9750.000000000004') -> '9750'
+* roundCosmetic('9750.000000000004|m') -> '9750|m'
 */
-const roundNumberCosmetic = (value) => {
+const roundCosmetic = (value) => {
 	if (require_units.isScientificStringNum(value)) return value;
-	return safeToString(require_units.roundToPrecision(require_units.toNum(value), COSMETIC_ROUNDING_DEFAULT_PRECISION));
+	return require_units.roundToPrecision(value, COSMETIC_ROUNDING_DEFAULT_PRECISION);
 };
 //#endregion
 //#region src/index.ts
@@ -73,7 +74,7 @@ exports.round = require_units.round;
 exports.roundByMagnitude = require_units.roundByMagnitude;
 exports.roundByMagnitudeToFixed = require_units.roundByMagnitudeToFixed;
 exports.roundByRange = require_units.roundByRange;
-exports.roundNumberCosmetic = roundNumberCosmetic;
+exports.roundCosmetic = roundCosmetic;
 exports.roundNumberWithLabel = require_units.roundNumberWithLabel;
 exports.roundToDecimalPrecision = require_units.roundToDecimalPrecision;
 exports.roundToFixed = require_units.roundToFixed;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["toString","isScientificStringNum","roundToPrecision","toNum"],"sources":["../src/rounding/cosmetic-rounding.ts","../src/index.ts"],"sourcesContent":["import { isScientificStringNum, toNum, toString } from '../numbers/numbers.ts';\nimport { roundToPrecision } from './rounding.ts';\n\nconst COSMETIC_ROUNDING_DEFAULT_PRECISION = 14;\n\nconst safeToString = (value: string | number): string => {\n  return String(toString(value));\n};\n\n/**\n * Applies display-only rounding to remove floating-point conversion noise.\n *\n * The value is rounded to 14 significant digits, while strings written in\n * scientific notation are preserved as entered.\n *\n * @param value - numeric value in string representation\n * @returns the cosmetically rounded string\n *\n * @example\n * roundNumberCosmetic('9750.000000000004') -> '9750'\n */\nexport const roundNumberCosmetic = (value: string): string => {\n  if (isScientificStringNum(value)) {\n    return value;\n  }\n\n  return safeToString(\n    roundToPrecision(toNum(value), COSMETIC_ROUNDING_DEFAULT_PRECISION),\n  );\n};\n","/* istanbul ignore file */\nimport {\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  getUnitsForQuantity,\n  getQuantities,\n  unitFromQuantity,\n  withPrettyUnitLabel,\n  validateNumber,\n} from './units.ts';\n\nimport {\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n} from './constants.ts';\n\nimport {\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  stripLeadingZeros,\n} from './utils.ts';\n\nimport {\n  toNum,\n  toString,\n  isValidNum,\n  isScientificStringNum,\n} from './numbers/numbers.ts';\n\nimport {\n  displayNumber,\n  displayNumberToFixed,\n} from './numbers/display-number.ts';\n\nimport {\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n} from './rounding/rounding.ts';\n\nimport { roundNumberCosmetic } from './rounding/cosmetic-rounding.ts';\n\nimport {\n  isCloseTo,\n  isDeepCloseTo,\n  isCloseToOrLessThan,\n  isCloseToOrGreaterThan,\n} from './comparison/comparison.ts';\n\nexport {\n  // Units\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  getUnitsForQuantity,\n  getQuantities,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  unitFromQuantity,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  withPrettyUnitLabel,\n  validateNumber,\n  //Rounding\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n  roundNumberCosmetic,\n  //Comparison\n  isCloseTo,\n  isDeepCloseTo,\n  isCloseToOrLessThan,\n  isCloseToOrGreaterThan,\n  // Utils\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  displayNumber,\n  displayNumberToFixed,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  toNum,\n  toString,\n  isValidNum,\n  isScientificStringNum,\n  stripLeadingZeros,\n  // Constants\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n};\n"],"mappings":";;;AAGA,MAAM,sCAAsC;AAE5C,MAAM,gBAAgB,UAAmC;AACvD,QAAO,OAAOA,cAAAA,SAAS,MAAM,CAAC;;;;;;;;;;;;;;AAehC,MAAa,uBAAuB,UAA0B;AAC5D,KAAIC,cAAAA,sBAAsB,MAAM,CAC9B,QAAO;AAGT,QAAO,aACLC,cAAAA,iBAAiBC,cAAAA,MAAM,MAAM,EAAE,oCAAoC,CACpE"}
+{"version":3,"file":"index.cjs","names":["isScientificStringNum","roundToPrecision"],"sources":["../src/rounding/cosmetic-rounding.ts","../src/index.ts"],"sourcesContent":["import { isScientificStringNum } from '../numbers/numbers.ts';\nimport { roundToPrecision } from './rounding.ts';\n\nconst COSMETIC_ROUNDING_DEFAULT_PRECISION = 14;\n\n/**\n * Applies display-only rounding to remove floating-point conversion noise.\n *\n * The value is rounded to 14 significant digits, while strings written in\n * scientific notation are preserved as entered.\n *\n * - accepts number types, stringified numbers, and unit strings\n * - returns the same type as the input\n *\n * @param value - numeric value to cosmetically round\n * @returns the cosmetically rounded value\n *\n * @example\n * roundCosmetic('9750.000000000004') -> '9750'\n * roundCosmetic('9750.000000000004|m') -> '9750|m'\n */\nexport const roundCosmetic = <Value extends number | string>(value: Value): Value => {\n  if (isScientificStringNum(value)) {\n    return value;\n  }\n\n  return roundToPrecision(value, COSMETIC_ROUNDING_DEFAULT_PRECISION);\n};\n","/* istanbul ignore file */\nimport {\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  getUnitsForQuantity,\n  getQuantities,\n  unitFromQuantity,\n  withPrettyUnitLabel,\n  validateNumber,\n} from './units.ts';\n\nimport {\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n} from './constants.ts';\n\nimport {\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  stripLeadingZeros,\n} from './utils.ts';\n\nimport { toNum, toString, isValidNum, isScientificStringNum } from './numbers/numbers.ts';\n\nimport { displayNumber, displayNumberToFixed } from './numbers/display-number.ts';\n\nimport {\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n} from './rounding/rounding.ts';\n\nimport { roundCosmetic } from './rounding/cosmetic-rounding.ts';\n\nimport { isCloseTo, isDeepCloseTo, isCloseToOrLessThan, isCloseToOrGreaterThan } from './comparison/comparison.ts';\n\nexport {\n  // Units\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  getUnitsForQuantity,\n  getQuantities,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  unitFromQuantity,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  withPrettyUnitLabel,\n  validateNumber,\n  //Rounding\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n  roundCosmetic,\n  //Comparison\n  isCloseTo,\n  isDeepCloseTo,\n  isCloseToOrLessThan,\n  isCloseToOrGreaterThan,\n  // Utils\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  displayNumber,\n  displayNumberToFixed,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  toNum,\n  toString,\n  isValidNum,\n  isScientificStringNum,\n  stripLeadingZeros,\n  // Constants\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n};\n"],"mappings":";;;AAGA,MAAM,sCAAsC;;;;;;;;;;;;;;;;;AAkB5C,MAAa,iBAAgD,UAAwB;AACnF,KAAIA,cAAAA,sBAAsB,MAAM,CAC9B,QAAO;AAGT,QAAOC,cAAAA,iBAAiB,OAAO,oCAAoC"}

package/dist/index.d.cts

@@ -357,7 +357,7 @@ declare const roundByRange: <Value extends number | string | null | undefined>(v
 declare const roundToFixed: <Value extends number | string | null | undefined>(value: Value, n?: number) => Value;
 //#endregion
 //#region src/rounding/cosmetic-rounding.d.ts
-declare const roundNumberCosmetic: (value: string) => string;
+declare const roundCosmetic: <Value extends number | string>(value: Value) => Value;
 //#endregion
 //#region src/comparison/comparison.d.ts
 type Without<T, U> = { [P in Exclude<keyof T, keyof U>]?: never };
@@ -372,5 +372,5 @@ declare const isCloseToOrGreaterThan: (firstValue: number | string | null, secon
 declare const isCloseToOrLessThan: (firstValue: number | string | null, secondValue: number | string | null, options?: toleranceType) => boolean;
 declare const isDeepCloseTo: (a: any, b: any, options?: toleranceType) => boolean;
 //#endregion
-export { ALT_UNITS, DEPRECATED_UNITS, INTERMEDIATE_CONVERSIONS, KNOWN_CONVERSIONS, KNOWN_UNITS, LABELS, QUANTITIES_DESCRIPTION, UNITS_DESCRIPTION, UNIT_ALIASES, UNIT_FROM_KEY, allNumbers, altUnitsList, asFraction, charCount, checkAndCleanDecimalComma, cleanNum, cleanNumStr, convertAndGetValue, convertAndGetValueStrict, convertSamePrecision, convertTable, displayNumber, displayNumberToFixed, formatNumber, fraction, getAltUnitsListByQuantity, getNumberOfDigitsToShow, getQuantities, getUnit, getUnitsForQuantity, getValue, isCloseTo, isCloseToOrGreaterThan, isCloseToOrLessThan, isDeepCloseTo, isEmptyValueWithUnit, isFraction, isNonNumerical, isNumeric, isScientificStringNum, isValidNum, isValueWithUnit, label, numFraction, round, roundByMagnitude, roundByMagnitudeToFixed, roundByRange, roundNumberCosmetic, roundNumberWithLabel, roundToDecimalPrecision, roundToFixed, roundToPrecision, showAltUnitsList, split, stripLeadingZeros, to, toBase, toNum, toString, unitFromKey, unitFromQuantity, unum, unumWithUnit, validateAndClean, validateNumber, withPrettyUnitLabel, withUnit };
+export { ALT_UNITS, DEPRECATED_UNITS, INTERMEDIATE_CONVERSIONS, KNOWN_CONVERSIONS, KNOWN_UNITS, LABELS, QUANTITIES_DESCRIPTION, UNITS_DESCRIPTION, UNIT_ALIASES, UNIT_FROM_KEY, allNumbers, altUnitsList, asFraction, charCount, checkAndCleanDecimalComma, cleanNum, cleanNumStr, convertAndGetValue, convertAndGetValueStrict, convertSamePrecision, convertTable, displayNumber, displayNumberToFixed, formatNumber, fraction, getAltUnitsListByQuantity, getNumberOfDigitsToShow, getQuantities, getUnit, getUnitsForQuantity, getValue, isCloseTo, isCloseToOrGreaterThan, isCloseToOrLessThan, isDeepCloseTo, isEmptyValueWithUnit, isFraction, isNonNumerical, isNumeric, isScientificStringNum, isValidNum, isValueWithUnit, label, numFraction, round, roundByMagnitude, roundByMagnitudeToFixed, roundByRange, roundCosmetic, roundNumberWithLabel, roundToDecimalPrecision, roundToFixed, roundToPrecision, showAltUnitsList, split, stripLeadingZeros, to, toBase, toNum, toString, unitFromKey, unitFromQuantity, unum, unumWithUnit, validateAndClean, validateNumber, withPrettyUnitLabel, withUnit };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/constants.ts","../src/utils.ts","../src/numbers/display-number.ts","../src/rounding/rounding.ts","../src/rounding/cosmetic-rounding.ts","../src/comparison/comparison.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/constants.ts","../src/utils.ts","../src/numbers/display-number.ts","../src/rounding/rounding.ts","../src/rounding/cosmetic-rounding.ts","../src/comparison/comparison.ts"],"mappings":"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"}

package/dist/index.d.ts

@@ -357,7 +357,7 @@ declare const roundByRange: <Value extends number | string | null | undefined>(v
 declare const roundToFixed: <Value extends number | string | null | undefined>(value: Value, n?: number) => Value;
 //#endregion
 //#region src/rounding/cosmetic-rounding.d.ts
-declare const roundNumberCosmetic: (value: string) => string;
+declare const roundCosmetic: <Value extends number | string>(value: Value) => Value;
 //#endregion
 //#region src/comparison/comparison.d.ts
 type Without<T, U> = { [P in Exclude<keyof T, keyof U>]?: never };
@@ -372,5 +372,5 @@ declare const isCloseToOrGreaterThan: (firstValue: number | string | null, secon
 declare const isCloseToOrLessThan: (firstValue: number | string | null, secondValue: number | string | null, options?: toleranceType) => boolean;
 declare const isDeepCloseTo: (a: any, b: any, options?: toleranceType) => boolean;
 //#endregion
-export { ALT_UNITS, DEPRECATED_UNITS, INTERMEDIATE_CONVERSIONS, KNOWN_CONVERSIONS, KNOWN_UNITS, LABELS, QUANTITIES_DESCRIPTION, UNITS_DESCRIPTION, UNIT_ALIASES, UNIT_FROM_KEY, allNumbers, altUnitsList, asFraction, charCount, checkAndCleanDecimalComma, cleanNum, cleanNumStr, convertAndGetValue, convertAndGetValueStrict, convertSamePrecision, convertTable, displayNumber, displayNumberToFixed, formatNumber, fraction, getAltUnitsListByQuantity, getNumberOfDigitsToShow, getQuantities, getUnit, getUnitsForQuantity, getValue, isCloseTo, isCloseToOrGreaterThan, isCloseToOrLessThan, isDeepCloseTo, isEmptyValueWithUnit, isFraction, isNonNumerical, isNumeric, isScientificStringNum, isValidNum, isValueWithUnit, label, numFraction, round, roundByMagnitude, roundByMagnitudeToFixed, roundByRange, roundNumberCosmetic, roundNumberWithLabel, roundToDecimalPrecision, roundToFixed, roundToPrecision, showAltUnitsList, split, stripLeadingZeros, to, toBase, toNum, toString, unitFromKey, unitFromQuantity, unum, unumWithUnit, validateAndClean, validateNumber, withPrettyUnitLabel, withUnit };
+export { ALT_UNITS, DEPRECATED_UNITS, INTERMEDIATE_CONVERSIONS, KNOWN_CONVERSIONS, KNOWN_UNITS, LABELS, QUANTITIES_DESCRIPTION, UNITS_DESCRIPTION, UNIT_ALIASES, UNIT_FROM_KEY, allNumbers, altUnitsList, asFraction, charCount, checkAndCleanDecimalComma, cleanNum, cleanNumStr, convertAndGetValue, convertAndGetValueStrict, convertSamePrecision, convertTable, displayNumber, displayNumberToFixed, formatNumber, fraction, getAltUnitsListByQuantity, getNumberOfDigitsToShow, getQuantities, getUnit, getUnitsForQuantity, getValue, isCloseTo, isCloseToOrGreaterThan, isCloseToOrLessThan, isDeepCloseTo, isEmptyValueWithUnit, isFraction, isNonNumerical, isNumeric, isScientificStringNum, isValidNum, isValueWithUnit, label, numFraction, round, roundByMagnitude, roundByMagnitudeToFixed, roundByRange, roundCosmetic, roundNumberWithLabel, roundToDecimalPrecision, roundToFixed, roundToPrecision, showAltUnitsList, split, stripLeadingZeros, to, toBase, toNum, toString, unitFromKey, unitFromQuantity, unum, unumWithUnit, validateAndClean, validateNumber, withPrettyUnitLabel, withUnit };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/constants.ts","../src/utils.ts","../src/numbers/display-number.ts","../src/rounding/rounding.ts","../src/rounding/cosmetic-rounding.ts","../src/comparison/comparison.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/constants.ts","../src/utils.ts","../src/numbers/display-number.ts","../src/rounding/rounding.ts","../src/rounding/cosmetic-rounding.ts","../src/comparison/comparison.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,29 +1,30 @@
 import { $ as displayNumber, A as DEPRECATED_UNITS, B as asFraction, C as unum, D as withPrettyUnitLabel, E as validateNumber, F as QUANTITIES_DESCRIPTION, G as fraction, H as cleanNum, I as UNITS_DESCRIPTION, J as isFraction, K as getNumberOfDigitsToShow, L as UNIT_ALIASES, M as KNOWN_CONVERSIONS, N as KNOWN_UNITS, O as withUnit, P as LABELS, Q as stripLeadingZeros, R as UNIT_FROM_KEY, S as unitFromQuantity, T as validateAndClean, U as cleanNumStr, V as charCount, W as formatNumber, X as isNumeric, Y as isNonNumerical, Z as numFraction, _ as showAltUnitsList, a as convertAndGetValue, at as roundToDecimalPrecision, b as toBase, c as convertTable, ct as isCloseTo, d as getUnit, dt as isDeepCloseTo, et as displayNumberToFixed, f as getUnitsForQuantity, ft as isScientificStringNum, g as roundNumberWithLabel, h as label, ht as toString, i as checkAndCleanDecimalComma, it as roundByRange, j as INTERMEDIATE_CONVERSIONS, k as ALT_UNITS, l as getAltUnitsListByQuantity, lt as isCloseToOrGreaterThan, m as isValueWithUnit, mt as toNum, nt as roundByMagnitude, o as convertAndGetValueStrict, ot as roundToFixed, p as getValue, pt as isValidNum, q as isEmptyValueWithUnit, r as altUnitsList, rt as roundByMagnitudeToFixed, s as convertSamePrecision, st as roundToPrecision, tt as round, u as getQuantities, ut as isCloseToOrLessThan, v as split, w as unumWithUnit, x as unitFromKey, y as to, z as allNumbers } from "./units2.js";
 //#region src/rounding/cosmetic-rounding.ts
 const COSMETIC_ROUNDING_DEFAULT_PRECISION = 14;
-const safeToString = (value) => {
-	return String(toString(value));
-};
 /**
 * Applies display-only rounding to remove floating-point conversion noise.
 *
 * The value is rounded to 14 significant digits, while strings written in
 * scientific notation are preserved as entered.
 *
-* @param value - numeric value in string representation
-* @returns the cosmetically rounded string
+* - accepts number types, stringified numbers, and unit strings
+* - returns the same type as the input
+*
+* @param value - numeric value to cosmetically round
+* @returns the cosmetically rounded value
 *
 * @example
-* roundNumberCosmetic('9750.000000000004') -> '9750'
+* roundCosmetic('9750.000000000004') -> '9750'
+* roundCosmetic('9750.000000000004|m') -> '9750|m'
 */
-const roundNumberCosmetic = (value) => {
+const roundCosmetic = (value) => {
 	if (isScientificStringNum(value)) return value;
-	return safeToString(roundToPrecision(toNum(value), COSMETIC_ROUNDING_DEFAULT_PRECISION));
+	return roundToPrecision(value, COSMETIC_ROUNDING_DEFAULT_PRECISION);
 };
 //#endregion
 //#region src/index.ts
 /* istanbul ignore file */
 //#endregion
-export { ALT_UNITS, DEPRECATED_UNITS, INTERMEDIATE_CONVERSIONS, KNOWN_CONVERSIONS, KNOWN_UNITS, LABELS, QUANTITIES_DESCRIPTION, UNITS_DESCRIPTION, UNIT_ALIASES, UNIT_FROM_KEY, allNumbers, altUnitsList, asFraction, charCount, checkAndCleanDecimalComma, cleanNum, cleanNumStr, convertAndGetValue, convertAndGetValueStrict, convertSamePrecision, convertTable, displayNumber, displayNumberToFixed, formatNumber, fraction, getAltUnitsListByQuantity, getNumberOfDigitsToShow, getQuantities, getUnit, getUnitsForQuantity, getValue, isCloseTo, isCloseToOrGreaterThan, isCloseToOrLessThan, isDeepCloseTo, isEmptyValueWithUnit, isFraction, isNonNumerical, isNumeric, isScientificStringNum, isValidNum, isValueWithUnit, label, numFraction, round, roundByMagnitude, roundByMagnitudeToFixed, roundByRange, roundNumberCosmetic, roundNumberWithLabel, roundToDecimalPrecision, roundToFixed, roundToPrecision, showAltUnitsList, split, stripLeadingZeros, to, toBase, toNum, toString, unitFromKey, unitFromQuantity, unum, unumWithUnit, validateAndClean, validateNumber, withPrettyUnitLabel, withUnit };
+export { ALT_UNITS, DEPRECATED_UNITS, INTERMEDIATE_CONVERSIONS, KNOWN_CONVERSIONS, KNOWN_UNITS, LABELS, QUANTITIES_DESCRIPTION, UNITS_DESCRIPTION, UNIT_ALIASES, UNIT_FROM_KEY, allNumbers, altUnitsList, asFraction, charCount, checkAndCleanDecimalComma, cleanNum, cleanNumStr, convertAndGetValue, convertAndGetValueStrict, convertSamePrecision, convertTable, displayNumber, displayNumberToFixed, formatNumber, fraction, getAltUnitsListByQuantity, getNumberOfDigitsToShow, getQuantities, getUnit, getUnitsForQuantity, getValue, isCloseTo, isCloseToOrGreaterThan, isCloseToOrLessThan, isDeepCloseTo, isEmptyValueWithUnit, isFraction, isNonNumerical, isNumeric, isScientificStringNum, isValidNum, isValueWithUnit, label, numFraction, round, roundByMagnitude, roundByMagnitudeToFixed, roundByRange, roundCosmetic, roundNumberWithLabel, roundToDecimalPrecision, roundToFixed, roundToPrecision, showAltUnitsList, split, stripLeadingZeros, to, toBase, toNum, toString, unitFromKey, unitFromQuantity, unum, unumWithUnit, validateAndClean, validateNumber, withPrettyUnitLabel, withUnit };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/rounding/cosmetic-rounding.ts","../src/index.ts"],"sourcesContent":["import { isScientificStringNum, toNum, toString } from '../numbers/numbers.ts';\nimport { roundToPrecision } from './rounding.ts';\n\nconst COSMETIC_ROUNDING_DEFAULT_PRECISION = 14;\n\nconst safeToString = (value: string | number): string => {\n  return String(toString(value));\n};\n\n/**\n * Applies display-only rounding to remove floating-point conversion noise.\n *\n * The value is rounded to 14 significant digits, while strings written in\n * scientific notation are preserved as entered.\n *\n * @param value - numeric value in string representation\n * @returns the cosmetically rounded string\n *\n * @example\n * roundNumberCosmetic('9750.000000000004') -> '9750'\n */\nexport const roundNumberCosmetic = (value: string): string => {\n  if (isScientificStringNum(value)) {\n    return value;\n  }\n\n  return safeToString(\n    roundToPrecision(toNum(value), COSMETIC_ROUNDING_DEFAULT_PRECISION),\n  );\n};\n","/* istanbul ignore file */\nimport {\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  getUnitsForQuantity,\n  getQuantities,\n  unitFromQuantity,\n  withPrettyUnitLabel,\n  validateNumber,\n} from './units.ts';\n\nimport {\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n} from './constants.ts';\n\nimport {\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  stripLeadingZeros,\n} from './utils.ts';\n\nimport {\n  toNum,\n  toString,\n  isValidNum,\n  isScientificStringNum,\n} from './numbers/numbers.ts';\n\nimport {\n  displayNumber,\n  displayNumberToFixed,\n} from './numbers/display-number.ts';\n\nimport {\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n} from './rounding/rounding.ts';\n\nimport { roundNumberCosmetic } from './rounding/cosmetic-rounding.ts';\n\nimport {\n  isCloseTo,\n  isDeepCloseTo,\n  isCloseToOrLessThan,\n  isCloseToOrGreaterThan,\n} from './comparison/comparison.ts';\n\nexport {\n  // Units\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  getUnitsForQuantity,\n  getQuantities,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  unitFromQuantity,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  withPrettyUnitLabel,\n  validateNumber,\n  //Rounding\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n  roundNumberCosmetic,\n  //Comparison\n  isCloseTo,\n  isDeepCloseTo,\n  isCloseToOrLessThan,\n  isCloseToOrGreaterThan,\n  // Utils\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  displayNumber,\n  displayNumberToFixed,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  toNum,\n  toString,\n  isValidNum,\n  isScientificStringNum,\n  stripLeadingZeros,\n  // Constants\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n};\n"],"mappings":";;AAGA,MAAM,sCAAsC;AAE5C,MAAM,gBAAgB,UAAmC;AACvD,QAAO,OAAO,SAAS,MAAM,CAAC;;;;;;;;;;;;;;AAehC,MAAa,uBAAuB,UAA0B;AAC5D,KAAI,sBAAsB,MAAM,CAC9B,QAAO;AAGT,QAAO,aACL,iBAAiB,MAAM,MAAM,EAAE,oCAAoC,CACpE"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/rounding/cosmetic-rounding.ts","../src/index.ts"],"sourcesContent":["import { isScientificStringNum } from '../numbers/numbers.ts';\nimport { roundToPrecision } from './rounding.ts';\n\nconst COSMETIC_ROUNDING_DEFAULT_PRECISION = 14;\n\n/**\n * Applies display-only rounding to remove floating-point conversion noise.\n *\n * The value is rounded to 14 significant digits, while strings written in\n * scientific notation are preserved as entered.\n *\n * - accepts number types, stringified numbers, and unit strings\n * - returns the same type as the input\n *\n * @param value - numeric value to cosmetically round\n * @returns the cosmetically rounded value\n *\n * @example\n * roundCosmetic('9750.000000000004') -> '9750'\n * roundCosmetic('9750.000000000004|m') -> '9750|m'\n */\nexport const roundCosmetic = <Value extends number | string>(value: Value): Value => {\n  if (isScientificStringNum(value)) {\n    return value;\n  }\n\n  return roundToPrecision(value, COSMETIC_ROUNDING_DEFAULT_PRECISION);\n};\n","/* istanbul ignore file */\nimport {\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  getUnitsForQuantity,\n  getQuantities,\n  unitFromQuantity,\n  withPrettyUnitLabel,\n  validateNumber,\n} from './units.ts';\n\nimport {\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n} from './constants.ts';\n\nimport {\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  stripLeadingZeros,\n} from './utils.ts';\n\nimport { toNum, toString, isValidNum, isScientificStringNum } from './numbers/numbers.ts';\n\nimport { displayNumber, displayNumberToFixed } from './numbers/display-number.ts';\n\nimport {\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n} from './rounding/rounding.ts';\n\nimport { roundCosmetic } from './rounding/cosmetic-rounding.ts';\n\nimport { isCloseTo, isDeepCloseTo, isCloseToOrLessThan, isCloseToOrGreaterThan } from './comparison/comparison.ts';\n\nexport {\n  // Units\n  label,\n  showAltUnitsList,\n  getAltUnitsListByQuantity,\n  getUnitsForQuantity,\n  getQuantities,\n  checkAndCleanDecimalComma,\n  unitFromKey,\n  unitFromQuantity,\n  to,\n  split,\n  unum,\n  toBase,\n  altUnitsList,\n  convertTable,\n  roundNumberWithLabel,\n  withUnit,\n  unumWithUnit,\n  validateAndClean,\n  isValueWithUnit,\n  getValue,\n  getUnit,\n  convertSamePrecision,\n  convertAndGetValue,\n  convertAndGetValueStrict,\n  withPrettyUnitLabel,\n  validateNumber,\n  //Rounding\n  round,\n  roundToFixed,\n  roundToPrecision,\n  roundToDecimalPrecision,\n  roundByMagnitude,\n  roundByMagnitudeToFixed,\n  roundByRange,\n  roundCosmetic,\n  //Comparison\n  isCloseTo,\n  isDeepCloseTo,\n  isCloseToOrLessThan,\n  isCloseToOrGreaterThan,\n  // Utils\n  isNumeric,\n  isNonNumerical,\n  isEmptyValueWithUnit,\n  allNumbers,\n  formatNumber,\n  displayNumber,\n  displayNumberToFixed,\n  charCount,\n  getNumberOfDigitsToShow,\n  fraction,\n  isFraction,\n  asFraction,\n  numFraction,\n  cleanNumStr,\n  cleanNum,\n  toNum,\n  toString,\n  isValidNum,\n  isScientificStringNum,\n  stripLeadingZeros,\n  // Constants\n  ALT_UNITS,\n  LABELS,\n  UNIT_FROM_KEY,\n  KNOWN_CONVERSIONS,\n  DEPRECATED_UNITS,\n  UNIT_ALIASES,\n  INTERMEDIATE_CONVERSIONS,\n  KNOWN_UNITS,\n  QUANTITIES_DESCRIPTION,\n  UNITS_DESCRIPTION,\n};\n"],"mappings":";;AAGA,MAAM,sCAAsC;;;;;;;;;;;;;;;;;AAkB5C,MAAa,iBAAgD,UAAwB;AACnF,KAAI,sBAAsB,MAAM,CAC9B,QAAO;AAGT,QAAO,iBAAiB,OAAO,oCAAoC"}

package/dist/numbers/numbers.d.cts

@@ -2,7 +2,7 @@
 declare const isValidNum: (value: unknown) => boolean;
 declare const isScientificStringNum: (value: unknown) => boolean;
 declare const toNum: (value: unknown, fallback?: number, minimum?: number) => any;
-declare const toString: (value?: unknown) => unknown;
+declare const toString: (value?: unknown) => any;
 //#endregion
 export { isScientificStringNum, isValidNum, toNum, toString };
 //# sourceMappingURL=numbers.d.cts.map

package/dist/numbers/numbers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.cts","names":[],"sources":["../../src/numbers/numbers.ts"],"mappings":";cAgCa,UAAA,GAAc,KAAA;AAAA,cA6Dd,qBAAA,GAAyB,KAAA;AAAA,cAsBzB,KAAA,GACX,KAAA,WACA,QAAA,WACA,OAAA;AAAA,cAgCW,QAAA,GAAY,KAAA"}
+{"version":3,"file":"numbers.d.cts","names":[],"sources":["../../src/numbers/numbers.ts"],"mappings":";cAgCa,UAAA,GAAc,KAAA;AAAA,cA6Dd,qBAAA,GAAyB,KAAA;AAAA,cAsBzB,KAAA,GAAS,KAAA,WAAgB,QAAA,WAAmB,OAAA;AAAA,cA+B5C,QAAA,GAAY,KAAA"}

package/dist/numbers/numbers.d.ts

@@ -2,7 +2,7 @@
 declare const isValidNum: (value: unknown) => boolean;
 declare const isScientificStringNum: (value: unknown) => boolean;
 declare const toNum: (value: unknown, fallback?: number, minimum?: number) => any;
-declare const toString: (value?: unknown) => unknown;
+declare const toString: (value?: unknown) => any;
 //#endregion
 export { isScientificStringNum, isValidNum, toNum, toString };
 //# sourceMappingURL=numbers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"numbers.d.ts","names":[],"sources":["../../src/numbers/numbers.ts"],"mappings":";cAgCa,UAAA,GAAc,KAAA;AAAA,cA6Dd,qBAAA,GAAyB,KAAA;AAAA,cAsBzB,KAAA,GACX,KAAA,WACA,QAAA,WACA,OAAA;AAAA,cAgCW,QAAA,GAAY,KAAA"}
+{"version":3,"file":"numbers.d.ts","names":[],"sources":["../../src/numbers/numbers.ts"],"mappings":";cAgCa,UAAA,GAAc,KAAA;AAAA,cA6Dd,qBAAA,GAAyB,KAAA;AAAA,cAsBzB,KAAA,GAAS,KAAA,WAAgB,QAAA,WAAmB,OAAA;AAAA,cA+B5C,QAAA,GAAY,KAAA"}

package/dist/units.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"units.d.cts","names":[],"sources":["../src/units.ts"],"mappings":";;;cA0Ba,SAAA;AAAA,cAEA,eAAA,EAAe,MAAA;AAAA,iBASZ,gBAAA,CAAiB,WAAA;AAAA,iBAUjB,mBAAA,CAAoB,QAAA;AAAA,iBAQpB,aAAA,CAAA;AAAA,iBAUA,KAAA,CAAM,OAAA;AAAA,iBAUN,WAAA,CAAY,QAAA;AAAA,iBAUZ,gBAAA,CAAiB,QAAA;AAAA,iBAUjB,yBAAA,CACd,QAAA,WACC,gBAAA;AAAA,iBAca,yBAAA,CACd,GAAA;AAAA,iBAqBc,EAAA,CACd,KAAA,mBACA,QAAA,UACA,MAAA;AAAA,iBAqFc,KAAA,CAAM,WAAA;AAAA,iBA+BN,QAAA,CAAS,WAAA;AAAA,iBAST,OAAA,CAAQ,WAAA;AAAA,iBAWR,IAAA,CACd,WAAA,mBACA,MAAA,UACA,QAAA;AAAA,iBAsDc,eAAA,CAAgB,KAAA;AAAA,iBAehB,kBAAA,CACd,WAAA,mBACA,MAAA,UACA,QAAA;AAAA,iBAac,wBAAA,CACd,KAAA,0BACA,MAAA,UACA,QAAA;AAAA,iBAwBc,MAAA,CAAO,KAAA,UAAe,QAAA;AAAA,iBAoBtB,YAAA,CACd,SAAA,OACA,KAAA,OACA,cAAA,OACA,mBAAA;AAAA,iBAgDc,oBAAA,CAAqB,KAAA,UAAe,CAAA;AAAA,iBAYpC,QAAA,CACd,KAAA,sCACA,IAAA,iBACA,UAAA;AAAA,iBA2Bc,YAAA,CACd,WAAA,mBACA,MAAA,UACA,QAAA;AAAA,iBAcc,oBAAA,CACd,WAAA,mBACA,MAAA,UACA,MAAA;AAAA,iBAsDc,YAAA,CACd,KAAA,UACA,QAAA;AAAA,iBAuBc,gBAAA,CACd,aAAA,UACA,QAAA;AAAA,iBA0Cc,mBAAA,CAAoB,cAAA;AAAA,iBAMpB,cAAA,CAAe,KAAA,oBAAyB,cAAA"}
+{"version":3,"file":"units.d.cts","names":[],"sources":["../src/units.ts"],"mappings":";;;cAmBa,SAAA;AAAA,cAEA,eAAA,EAAe,MAAA;AAAA,iBAQZ,gBAAA,CAAiB,WAAA;AAAA,iBAUjB,mBAAA,CAAoB,QAAA;AAAA,iBAQpB,aAAA,CAAA;AAAA,iBAUA,KAAA,CAAM,OAAA;AAAA,iBAUN,WAAA,CAAY,QAAA;AAAA,iBAUZ,gBAAA,CAAiB,QAAA;AAAA,iBAUjB,yBAAA,CAA0B,QAAA,WAAmB,gBAAA;AAAA,iBAY7C,yBAAA,CAA0B,GAAA;AAAA,iBAoB1B,EAAA,CAAG,KAAA,mBAAwB,QAAA,UAAkB,MAAA;AAAA,iBA8E7C,KAAA,CAAM,WAAA;AAAA,iBA4BN,QAAA,CAAS,WAAA;AAAA,iBAST,OAAA,CAAQ,WAAA;AAAA,iBAWR,IAAA,CAAK,WAAA,mBAA8B,MAAA,UAAgB,QAAA;AAAA,iBAmDnD,eAAA,CAAgB,KAAA;AAAA,iBAehB,kBAAA,CAAmB,WAAA,mBAA8B,MAAA,UAAgB,QAAA;AAAA,iBAYjE,wBAAA,CACd,KAAA,0BACA,MAAA,UACA,QAAA;AAAA,iBAoBc,MAAA,CAAO,KAAA,UAAe,QAAA;AAAA,iBAoBtB,YAAA,CACd,SAAA,OACA,KAAA,OACA,cAAA,OACA,mBAAA;AAAA,iBA0Cc,oBAAA,CAAqB,KAAA,UAAe,CAAA;AAAA,iBAYpC,QAAA,CAAS,KAAA,sCAA2C,IAAA,iBAAqB,UAAA;AAAA,iBAwBzE,YAAA,CAAa,WAAA,mBAA8B,MAAA,UAAgB,QAAA;AAAA,iBAa3D,oBAAA,CAAqB,WAAA,mBAA8B,MAAA,UAAgB,MAAA;AAAA,iBAiDnE,YAAA,CAAa,KAAA,UAAe,QAAA;AAAA,iBAmB5B,gBAAA,CAAiB,aAAA,UAAuB,QAAA;AAAA,iBAqCxC,mBAAA,CAAoB,cAAA;AAAA,iBAMpB,cAAA,CAAe,KAAA,oBAAyB,cAAA"}

package/dist/units.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"units.d.ts","names":[],"sources":["../src/units.ts"],"mappings":";;;cA0Ba,SAAA;AAAA,cAEA,eAAA,EAAe,MAAA;AAAA,iBASZ,gBAAA,CAAiB,WAAA;AAAA,iBAUjB,mBAAA,CAAoB,QAAA;AAAA,iBAQpB,aAAA,CAAA;AAAA,iBAUA,KAAA,CAAM,OAAA;AAAA,iBAUN,WAAA,CAAY,QAAA;AAAA,iBAUZ,gBAAA,CAAiB,QAAA;AAAA,iBAUjB,yBAAA,CACd,QAAA,WACC,gBAAA;AAAA,iBAca,yBAAA,CACd,GAAA;AAAA,iBAqBc,EAAA,CACd,KAAA,mBACA,QAAA,UACA,MAAA;AAAA,iBAqFc,KAAA,CAAM,WAAA;AAAA,iBA+BN,QAAA,CAAS,WAAA;AAAA,iBAST,OAAA,CAAQ,WAAA;AAAA,iBAWR,IAAA,CACd,WAAA,mBACA,MAAA,UACA,QAAA;AAAA,iBAsDc,eAAA,CAAgB,KAAA;AAAA,iBAehB,kBAAA,CACd,WAAA,mBACA,MAAA,UACA,QAAA;AAAA,iBAac,wBAAA,CACd,KAAA,0BACA,MAAA,UACA,QAAA;AAAA,iBAwBc,MAAA,CAAO,KAAA,UAAe,QAAA;AAAA,iBAoBtB,YAAA,CACd,SAAA,OACA,KAAA,OACA,cAAA,OACA,mBAAA;AAAA,iBAgDc,oBAAA,CAAqB,KAAA,UAAe,CAAA;AAAA,iBAYpC,QAAA,CACd,KAAA,sCACA,IAAA,iBACA,UAAA;AAAA,iBA2Bc,YAAA,CACd,WAAA,mBACA,MAAA,UACA,QAAA;AAAA,iBAcc,oBAAA,CACd,WAAA,mBACA,MAAA,UACA,MAAA;AAAA,iBAsDc,YAAA,CACd,KAAA,UACA,QAAA;AAAA,iBAuBc,gBAAA,CACd,aAAA,UACA,QAAA;AAAA,iBA0Cc,mBAAA,CAAoB,cAAA;AAAA,iBAMpB,cAAA,CAAe,KAAA,oBAAyB,cAAA"}
+{"version":3,"file":"units.d.ts","names":[],"sources":["../src/units.ts"],"mappings":";;;cAmBa,SAAA;AAAA,cAEA,eAAA,EAAe,MAAA;AAAA,iBAQZ,gBAAA,CAAiB,WAAA;AAAA,iBAUjB,mBAAA,CAAoB,QAAA;AAAA,iBAQpB,aAAA,CAAA;AAAA,iBAUA,KAAA,CAAM,OAAA;AAAA,iBAUN,WAAA,CAAY,QAAA;AAAA,iBAUZ,gBAAA,CAAiB,QAAA;AAAA,iBAUjB,yBAAA,CAA0B,QAAA,WAAmB,gBAAA;AAAA,iBAY7C,yBAAA,CAA0B,GAAA;AAAA,iBAoB1B,EAAA,CAAG,KAAA,mBAAwB,QAAA,UAAkB,MAAA;AAAA,iBA8E7C,KAAA,CAAM,WAAA;AAAA,iBA4BN,QAAA,CAAS,WAAA;AAAA,iBAST,OAAA,CAAQ,WAAA;AAAA,iBAWR,IAAA,CAAK,WAAA,mBAA8B,MAAA,UAAgB,QAAA;AAAA,iBAmDnD,eAAA,CAAgB,KAAA;AAAA,iBAehB,kBAAA,CAAmB,WAAA,mBAA8B,MAAA,UAAgB,QAAA;AAAA,iBAYjE,wBAAA,CACd,KAAA,0BACA,MAAA,UACA,QAAA;AAAA,iBAoBc,MAAA,CAAO,KAAA,UAAe,QAAA;AAAA,iBAoBtB,YAAA,CACd,SAAA,OACA,KAAA,OACA,cAAA,OACA,mBAAA;AAAA,iBA0Cc,oBAAA,CAAqB,KAAA,UAAe,CAAA;AAAA,iBAYpC,QAAA,CAAS,KAAA,sCAA2C,IAAA,iBAAqB,UAAA;AAAA,iBAwBzE,YAAA,CAAa,WAAA,mBAA8B,MAAA,UAAgB,QAAA;AAAA,iBAa3D,oBAAA,CAAqB,WAAA,mBAA8B,MAAA,UAAgB,MAAA;AAAA,iBAiDnE,YAAA,CAAa,KAAA,UAAe,QAAA;AAAA,iBAmB5B,gBAAA,CAAiB,aAAA,UAAuB,QAAA;AAAA,iBAqCxC,mBAAA,CAAoB,cAAA;AAAA,iBAMpB,cAAA,CAAe,KAAA,oBAAyB,cAAA"}

package/dist/units2.cjs

@@ -171,7 +171,7 @@ const parseNumber = (value, preserveTrailingZeros = false) => {
 * @returns number or string output value
 */
 const safeStringifyNumber = (value, isScientific) => {
-	return isScientific ? String(value) : String(toString(value));
+	return isScientific ? String(value) : toString(value);
 };
 /**
 * Internal function to unParse a value, unit, and type back to an output value
@@ -2974,7 +2974,7 @@ function convertAndGetValueStrict(value, toUnit, fromUnit) {
 	if (typeof value === "string" && isValueWithUnit(value) && getValue(value) === "") return "";
 	const isString = typeof value === "string";
 	const result = convertAndGetValue(value, toUnit, fromUnit);
-	return isString ? String(toString(result)) : result;
+	return isString ? toString(result) : result;
 }
 /**
 * Convert value to the base unit given by the quantity