format-quantity 2.1.0 → 3.1.0

package/README.md

@@ -1,18 +1,19 @@
-# format-quantity
-
 [![npm][badge-npm]](https://www.npmjs.com/package/format-quantity)
 ![workflow status](https://github.com/jakeboone02/format-quantity/actions/workflows/main.yml/badge.svg)
 [![codecov.io](https://codecov.io/github/jakeboone02/format-quantity/coverage.svg?branch=main)](https://codecov.io/github/jakeboone02/format-quantity?branch=main)
-[![downloads](https://img.shields.io/npm/dm/format-quantity.svg)](http://npm-stat.com/charts.html?package=format-quantity&from=2015-08-01)
-[![MIT License](https://img.shields.io/npm/l/format-quantity.svg)](http://opensource.org/licenses/MIT)
+[![downloads](https://img.shields.io/npm/dm/format-quantity.svg)](https://npm-stat.com/charts.html?package=format-quantity&from=2015-08-01)
+[![MIT License](https://img.shields.io/npm/l/format-quantity.svg)](https://opensource.org/licenses/MIT)
 
 Formats a number (or string that appears to be a number) as one would see it written in imperial measurements, e.g. "1 1/2" instead of "1.5".
 
+**[Full documentation](https://jakeboone02.github.io/format-quantity/)**
+
 Features:
 
-- To use vulgar fraction characters like "⅞", pass `true` as the second argument (see other [options](#options), like Roman numerals, below).
-- The return value will be `null` if the first argument is neither a number nor a string that evaluates to a number using `parseFloat`.
-- The return value will be an empty string (`""`) if the first argument is `0` or `"0"`, which is done to fit the primary use case of formatting recipe ingredient quantities.
+- To use vulgar fraction characters like "⅞", pass `true` as the second argument. Other options like Roman numerals are described below.
+- String inputs are parsed with [`numeric-quantity`](https://www.npmjs.com/package/numeric-quantity), so mixed numbers (`"1 1/2"`), vulgar fractions (`"½"`), bare fractions (`"1/3"`), and comma/underscore-separated numbers (`"1,000"`) are all accepted in addition to plain decimal strings.
+- The return value will be `null` if the first argument is not a recognized numeric format.
+- The return value will be an empty string (`""`) if the first argument is `0` or `"0"`, which fits the primary use case of formatting recipe ingredient quantities.
 
 > _For the inverse operation—converting a string to a `number`—check out [numeric-quantity](https://www.npmjs.com/package/numeric-quantity). It handles mixed numbers, vulgar fractions, comma/underscore separators, and Roman numerals._
 >
@@ -77,13 +78,27 @@ Note: `formatQuantity` supports sixteenths, but no vulgar fraction characters ex
 | --------- | ------: |
 | `boolean` | `false` |
 
-Uses the [fraction slash character](<https://en.wikipedia.org/wiki/Slash_(punctuation)#Fractions>) (`"\u2044"`) to separate the numerator and denominator instead of the regular "solidus" slash (`"\u002f"`). This option is ignored if the `vulgarFractions` option is also `true`.
+Uses the [fraction slash character](<https://en.wikipedia.org/wiki/Slash_(punctuation)#Fractions>) (`"\u2044"`) to separate the numerator and denominator instead of the regular "solidus" slash (`"\u002f"`), with Unicode superscript numerator and subscript denominator digits. This option is ignored if the `vulgarFractions` option is also `true`.
 
 ```js
-formatQuantity(3.875, { fractionSlash: true }); // "3 7⁄8"
+formatQuantity(3.875, { fractionSlash: true }); // "3 ⁷⁄₈"
 formatQuantity(3.875, { fractionSlash: true, vulgarFractions: true }); // "3⅞"
 ```
 
+### `separator`
+
+| Type     | Default |
+| -------- | ------: |
+| `string` |     N/A |
+
+Overrides the string placed between the whole number and the fraction. When not specified, the default is `" "` (a space) for ASCII and fraction-slash fractions, and `""` (no space) for vulgar fractions. Common alternatives include a hyphen (`"-"`) and a no-break space (`"\u00a0"`).
+
+```js
+formatQuantity(1.5, { separator: '-' }); // "1-1/2"
+formatQuantity(1.5, { separator: ' ', vulgarFractions: true }); // "1 ½"
+formatQuantity(1.5, { separator: '\u00a0' }); // "1\u00a01/2" (no-break space)
+```
+
 ### `tolerance`
 
 | Type     |  Default |
@@ -118,18 +133,4 @@ formatQuantity(1214, { romanNumerals: true }); // "MCCXIV"
 formatQuantity(12.14, { romanNumerals: true, vulgarFractions: true }); // "XII"
 ```
 
-## Other exports
-
-| Name                     | Type                                                 | Description                                                                                                                                                 |
-| ------------------------ | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `defaultTolerance`       | `number`                                             | `0.0075`                                                                                                                                                    |
-| `defaultOptions`         | `type`                                               | Object representing the default options                                                                                                                     |
-| `fractionDecimalMatches` | <code>[number, VulgarFraction \| Sixteenth][]</code> | List of decimal values that are close enough to match the associated fraction (inputs are evaluated against the decimal values in the order of this array)  |
-| `vulgarToAsciiMap`       | `object`                                             | Map of vulgar fraction characters to their equivalent ASCII strings (`"⅓"` to `"1/3"`, `"⅞"` to `"7/8"`, etc.)                                              |
-| `formatRomanNumerals`    | `function`                                           | Formats a number as Roman numerals (used internally by `formatQuantity` when the `romanNumerals` option is `true`)                                          |
-| `FormatQuantityOptions`  | `interface`                                          | Shape of `formatQuantity`'s second parameter (if not a `boolean` value)                                                                                     |
-| `SimpleFraction`         | `type`                                               | String template type for valid (positive, no division by zero) ASCII fraction strings with either one or two digits in the numerator and denominator each   |
-| `VulgarFraction`         | `type`                                               | The set of [vulgar fraction characters](https://en.wikipedia.org/wiki/Number_Forms) (`"\u00bc"`, `"\u00bd"`, `"\u00be"`, and `"\u2150"` through `"\u215e"`) |
-| `Sixteenth`              | `type`                                               | Union type of all ASCII representations of odd-numbered sixteenth fractions less than one, (`"1/16"`, `"3/16"`, etc.)                                       |
-
 [badge-npm]: https://img.shields.io/npm/v/numeric-quantity.svg?cacheSeconds=3600&logo=npm

package/dist/cjs/format-quantity.cjs.development.d.ts

@@ -0,0 +1,107 @@
+//#region src/types.d.ts
+interface FormatQuantityOptions {
+  /**
+  * Output vulgar fractions, like "½" instead of "1/2", when appropriate.
+  * Overrides the `fractionSlash` option.
+  */
+  vulgarFractions?: boolean;
+  /**
+  * Amount by which a number can deviate from the calculated quotient to be
+  * considered a match. For example, 0.66 is close enough to 2 ÷ 3 (which
+  * is 0.66666... repeating) to be considered equivalent so the function
+  * will return "2/3". The smaller this number, the higher the likelihood that
+  * the function will return a decimal instead of a fraction or mixed number.
+  *
+  * @default 0.0075
+  */
+  tolerance?: number;
+  /**
+  * Output the fraction slash character (⁄) instead of the "solidus"
+  * slash (/) for fractions. Results appear like "1⁄2" instead of "1/2".
+  * Overridden by the `vulgarFractions` option.
+  */
+  fractionSlash?: boolean;
+  /**
+  * Output in Roman numerals. Provided value must be between 1 and 3999, inclusive.
+  * Decimal values will be ignored (`Math.floor` is used to remove them). Overrides
+  * all other options.
+  */
+  romanNumerals?: boolean;
+  /**
+  * String to place between the whole number and fraction parts. When not specified,
+  * defaults to `" "` for ASCII and fraction-slash fractions, and `""` for vulgar
+  * fractions (preserving the standard typographic convention of no space before
+  * vulgar fraction characters).
+  */
+  separator?: string;
+}
+/**
+* {@link FormatQuantityOptions} with all properties resolved to their
+* default values, except {@link FormatQuantityOptions.separator | separator}
+* which remains optional so that unset vs explicitly-set can be distinguished.
+*/
+type ResolvedFormatQuantityOptions = Required<Omit<FormatQuantityOptions, "separator">> & Pick<FormatQuantityOptions, "separator">;
+/**
+* Function signature of {@link formatQuantity}.
+*/
+interface FormatQuantity {
+  (qty: string | number, options?: boolean | FormatQuantityOptions): string | null;
+}
+/** Any numeric character. */
+type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+/** Any numeric character except '0'. */
+type NonZeroDigit = Exclude<Digit, "0">;
+/**
+* Fraction string with either one or two numeric characters in both the
+* numerator and denominator (but not two characters in the numerator while
+* the denominator only has one).
+*/
+type SimpleFraction = `${NonZeroDigit}/${NonZeroDigit}` | `${NonZeroDigit}/${NonZeroDigit}${Digit}` | `${NonZeroDigit}${Digit}/${NonZeroDigit}${Digit}`;
+/**
+* Odd numerator sixteenth fraction strings.
+*/
+type Sixteenth = `${"1" | "3" | "5" | "7" | "9" | "11" | "13" | "15"}/16`;
+/**
+* Unicode vulgar fraction code points.
+*/
+type VulgarFraction = "¼" | "½" | "¾" | "⅐" | "⅑" | "⅒" | "⅓" | "⅔" | "⅕" | "⅖" | "⅗" | "⅘" | "⅙" | "⅚" | "⅛" | "⅜" | "⅝" | "⅞";
+/** @hidden */
+type FormatQuantityTests = Record<string, ([Parameters<FormatQuantity>[0], ReturnType<FormatQuantity>] | [Parameters<FormatQuantity>[0], ReturnType<FormatQuantity>, Parameters<FormatQuantity>[1]])[]>;
+//#endregion
+//#region src/constants.d.ts
+/**
+* Default tolerance used by {@link formatQuantity} when determining if a number
+* is close enough to a fraction value to be considered equivalent.
+*/
+declare const defaultTolerance: 0.0075;
+/**
+* Default options for {@link formatQuantity}.
+*/
+declare const defaultOptions: ResolvedFormatQuantityOptions;
+/**
+* Map of vulgar fractions to their traditional ASCII equivalents.
+*/
+declare const vulgarToAsciiMap: Record<VulgarFraction, SimpleFraction>;
+/**
+* Map of "close enough" decimal values to the {@link VulgarFraction} or
+* {@link Sixteenth} fraction string matches.
+*/
+declare const fractionDecimalMatches: [number, VulgarFraction | Sixteenth][];
+//#endregion
+//#region src/formatQuantity.d.ts
+/**
+* Formats a number as Roman numerals. The number must be between
+* 1 and 3999, inclusive.
+*/
+declare const formatRomanNumerals: (qty: number) => string | null;
+/**
+* Formats a number (or string that appears to be a number)
+* as one would see it written in imperial measurements, e.g.
+* "1 1/2" instead of "1.5". To use vulgar fraction characters
+* like "½", pass `true` as the second argument. For other options
+* see {@link FormatQuantityOptions}.
+*/
+declare const formatQuantity: FormatQuantity;
+//#endregion
+export { Digit, FormatQuantity, FormatQuantityOptions, FormatQuantityTests, NonZeroDigit, ResolvedFormatQuantityOptions, SimpleFraction, Sixteenth, VulgarFraction, defaultOptions, defaultTolerance, formatQuantity, formatRomanNumerals, fractionDecimalMatches, vulgarToAsciiMap };
+//# sourceMappingURL=format-quantity.cjs.development.d.ts.map

package/dist/cjs/format-quantity.cjs.development.js

@@ -1,192 +1,195 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  default: () => src_default,
-  defaultOptions: () => defaultOptions,
-  defaultTolerance: () => defaultTolerance,
-  formatQuantity: () => formatQuantity,
-  fractionDecimalMatches: () => fractionDecimalMatches,
-  vulgarToAsciiMap: () => vulgarToAsciiMap
-});
-module.exports = __toCommonJS(src_exports);
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let numeric_quantity = require("numeric-quantity");
 
-// src/constants.ts
-var defaultTolerance = 75e-4;
-var defaultOptions = {
-  vulgarFractions: false,
-  tolerance: defaultTolerance,
-  fractionSlash: false,
-  romanNumerals: false
+//#region src/constants.ts
+/**
+* Default tolerance used by {@link formatQuantity} when determining if a number
+* is close enough to a fraction value to be considered equivalent.
+*/
+const defaultTolerance = .0075;
+/**
+* Default options for {@link formatQuantity}.
+*/
+const defaultOptions = {
+	vulgarFractions: false,
+	tolerance: defaultTolerance,
+	fractionSlash: false,
+	romanNumerals: false
 };
-var vulgarToAsciiMap = {
-  "\xBC": "1/4",
-  "\xBD": "1/2",
-  "\xBE": "3/4",
-  "\u2150": "1/7",
-  "\u2151": "1/9",
-  "\u2152": "1/10",
-  "\u2153": "1/3",
-  "\u2154": "2/3",
-  "\u2155": "1/5",
-  "\u2156": "2/5",
-  "\u2157": "3/5",
-  "\u2158": "4/5",
-  "\u2159": "1/6",
-  "\u215A": "5/6",
-  "\u215B": "1/8",
-  "\u215C": "3/8",
-  "\u215D": "5/8",
-  "\u215E": "7/8"
+/**
+* Map of vulgar fractions to their traditional ASCII equivalents.
+*/
+const vulgarToAsciiMap = {
+	"¼": "1/4",
+	"½": "1/2",
+	"¾": "3/4",
+	"⅐": "1/7",
+	"⅑": "1/9",
+	"⅒": "1/10",
+	"⅓": "1/3",
+	"⅔": "2/3",
+	"⅕": "1/5",
+	"⅖": "2/5",
+	"⅗": "3/5",
+	"⅘": "4/5",
+	"⅙": "1/6",
+	"⅚": "5/6",
+	"⅛": "1/8",
+	"⅜": "3/8",
+	"⅝": "5/8",
+	"⅞": "7/8"
 };
-var fractionDecimalMatches = [
-  [0.33, "\u2153"],
-  [0.66, "\u2154"],
-  [0.2, "\u2155"],
-  [0.4, "\u2156"],
-  [0.6, "\u2157"],
-  [0.8, "\u2158"],
-  [0.166, "\u2159"],
-  [0.833, "\u215A"],
-  [0.143, "\u2150"],
-  [0.111, "\u2151"],
-  [0.1, "\u2152"],
-  [0.125, "\u215B"],
-  [0.25, "\xBC"],
-  [0.375, "\u215C"],
-  [0.5, "\xBD"],
-  [0.625, "\u215D"],
-  [0.75, "\xBE"],
-  [0.875, "\u215E"],
-  [0.0625, "1/16"],
-  [0.1875, "3/16"],
-  [0.3125, "5/16"],
-  [0.4375, "7/16"],
-  [0.5625, "9/16"],
-  [0.6875, "11/16"],
-  [0.8125, "13/16"],
-  [0.9375, "15/16"]
+/**
+* Map of "close enough" decimal values to the {@link VulgarFraction} or
+* {@link Sixteenth} fraction string matches.
+*/
+const fractionDecimalMatches = [
+	[.33, "⅓"],
+	[.66, "⅔"],
+	[.2, "⅕"],
+	[.4, "⅖"],
+	[.6, "⅗"],
+	[.8, "⅘"],
+	[.166, "⅙"],
+	[.833, "⅚"],
+	[.143, "⅐"],
+	[.111, "⅑"],
+	[.1, "⅒"],
+	[.125, "⅛"],
+	[.25, "¼"],
+	[.375, "⅜"],
+	[.5, "½"],
+	[.625, "⅝"],
+	[.75, "¾"],
+	[.875, "⅞"],
+	[.0625, "1/16"],
+	[.1875, "3/16"],
+	[.3125, "5/16"],
+	[.4375, "7/16"],
+	[.5625, "9/16"],
+	[.6875, "11/16"],
+	[.8125, "13/16"],
+	[.9375, "15/16"]
 ];
 
-// src/formatQuantity.ts
-var closeEnough = (n1, n2, tolerance) => Math.abs(n1 - n2) < tolerance;
-var getFraction = (vulgarFractionOrSixteenth, { fractionSlash, vulgarFractions }) => {
-  if (vulgarFractions) {
-    return vulgarFractionOrSixteenth;
-  }
-  const plainFraction = vulgarToAsciiMap[vulgarFractionOrSixteenth] ?? vulgarFractionOrSixteenth;
-  if (fractionSlash) {
-    return plainFraction.replace("/", "\u2044");
-  }
-  return plainFraction;
+//#endregion
+//#region src/formatQuantity.ts
+/**
+* Determines if two numbers are close enough to consider
+* them equal for the purposes of this package.
+*/
+const closeEnough = (n1, n2, tolerance) => Math.abs(n1 - n2) < tolerance;
+const superscriptDigits = "⁰¹²³⁴⁵⁶⁷⁸⁹";
+const subscriptDigits = "₀₁₂₃₄₅₆₇₈₉";
+const toSuperscript = (s) => {
+	let r = "";
+	for (let i = 0; i < s.length; i++) r += superscriptDigits[+s[i]];
+	return r;
 };
-var normalizeOptions = (options) => ({
-  ...defaultOptions,
-  ...typeof options === "boolean" ? { vulgarFractions: options } : options
+const toSubscript = (s) => {
+	let r = "";
+	for (let i = 0; i < s.length; i++) r += subscriptDigits[+s[i]];
+	return r;
+};
+/**
+* Applies the `vulgarFractions` or `fractionSlash` options as necessary.
+*/
+const getFraction = (vulgarFractionOrSixteenth, { fractionSlash, vulgarFractions }) => {
+	if (vulgarFractions) return vulgarFractionOrSixteenth;
+	const plainFraction = vulgarToAsciiMap[vulgarFractionOrSixteenth] ?? vulgarFractionOrSixteenth;
+	if (fractionSlash) {
+		const [num, den] = plainFraction.split("/");
+		return `${toSuperscript(num)}⁄${toSubscript(den)}`;
+	}
+	return plainFraction;
+};
+/**
+* Merges options object with default options, converting boolean to object if necessary.
+*/
+const normalizeOptions = (options) => ({
+	...defaultOptions,
+	...typeof options === "boolean" ? { vulgarFractions: options } : options
 });
-var romanNumeralValueKey = [
-  "",
-  "C",
-  "CC",
-  "CCC",
-  "CD",
-  "D",
-  "DC",
-  "DCC",
-  "DCCC",
-  "CM",
-  "",
-  "X",
-  "XX",
-  "XXX",
-  "XL",
-  "L",
-  "LX",
-  "LXX",
-  "LXXX",
-  "XC",
-  "",
-  "I",
-  "II",
-  "III",
-  "IV",
-  "V",
-  "VI",
-  "VII",
-  "VIII",
-  "IX"
+const romanNumeralValueKey = [
+	"",
+	"C",
+	"CC",
+	"CCC",
+	"CD",
+	"D",
+	"DC",
+	"DCC",
+	"DCCC",
+	"CM",
+	"",
+	"X",
+	"XX",
+	"XXX",
+	"XL",
+	"L",
+	"LX",
+	"LXX",
+	"LXXX",
+	"XC",
+	"",
+	"I",
+	"II",
+	"III",
+	"IV",
+	"V",
+	"VI",
+	"VII",
+	"VIII",
+	"IX"
 ];
-var formatRomanNumerals = (qty) => {
-  if (typeof qty !== "number" || isNaN(qty)) {
-    return null;
-  }
-  if (qty < 1 || qty >= 4e3) {
-    return "";
-  }
-  const floored = Math.floor(qty);
-  const digits = `${floored}`.split("");
-  let roman = "";
-  let i = 3;
-  while (i--) {
-    roman = `${romanNumeralValueKey[+digits.pop() + i * 10] || ""}${roman}`;
-  }
-  return `${Array(+digits.join("") + 1).join("M")}${roman}`;
+/**
+* Formats a number as Roman numerals. The number must be between
+* 1 and 3999, inclusive.
+*/
+const formatRomanNumerals = (qty) => {
+	if (typeof qty !== "number" || isNaN(qty)) return null;
+	if (qty < 1 || qty >= 4e3) return "";
+	const digits = `${Math.floor(qty)}`.split("");
+	let roman = "";
+	let i = 3;
+	while (i--) roman = `${romanNumeralValueKey[+digits.pop() + i * 10] || ""}${roman}`;
+	return `${Array(+digits.join("") + 1).join("M")}${roman}`;
 };
-var formatQuantity = (qty, options = defaultOptions) => {
-  const qtyAsNumber = typeof qty === "string" ? parseFloat(qty) : qty;
-  if (isNaN(qtyAsNumber) || qtyAsNumber === null) {
-    return null;
-  }
-  if (qtyAsNumber === 0) {
-    return "";
-  }
-  const opts = normalizeOptions(options ?? defaultOptions);
-  if (opts.romanNumerals) {
-    return formatRomanNumerals(qtyAsNumber);
-  }
-  const absoluteValue = Math.abs(qtyAsNumber);
-  const flooredAbsVal = Math.floor(absoluteValue);
-  const flooredAbsValStr = `${qtyAsNumber < 0 ? "-" : ""}${flooredAbsVal === 0 ? "" : `${flooredAbsVal} `}`;
-  const decimalValue = absoluteValue - flooredAbsVal;
-  if (decimalValue === 0) {
-    return `${qtyAsNumber}`;
-  }
-  for (const [num, vf] of fractionDecimalMatches) {
-    if (closeEnough(decimalValue, num, opts.tolerance)) {
-      const fraction = getFraction(vf, opts);
-      const int = Object.hasOwn(vulgarToAsciiMap, fraction) ? flooredAbsValStr.trim() : flooredAbsValStr;
-      return `${int}${fraction}`;
-    }
-  }
-  return `${qtyAsNumber}`;
+/**
+* Formats a number (or string that appears to be a number)
+* as one would see it written in imperial measurements, e.g.
+* "1 1/2" instead of "1.5". To use vulgar fraction characters
+* like "½", pass `true` as the second argument. For other options
+* see {@link FormatQuantityOptions}.
+*/
+const formatQuantity = (qty, options = defaultOptions) => {
+	const qtyAsNumber = typeof qty === "string" ? (0, numeric_quantity.numericQuantity)(qty, {
+		round: false,
+		allowTrailingInvalid: true
+	}) : qty;
+	if (isNaN(qtyAsNumber) || qtyAsNumber === null) return null;
+	if (qtyAsNumber === 0) return "";
+	const opts = normalizeOptions(options ?? defaultOptions);
+	if (opts.romanNumerals) return formatRomanNumerals(qtyAsNumber);
+	const absoluteValue = Math.abs(qtyAsNumber);
+	const flooredAbsVal = Math.floor(absoluteValue);
+	const sign = qtyAsNumber < 0 ? "-" : "";
+	const wholeStr = flooredAbsVal === 0 ? "" : `${flooredAbsVal}`;
+	const decimalValue = absoluteValue - flooredAbsVal;
+	if (decimalValue === 0) return `${qtyAsNumber}`;
+	for (const [num, vf] of fractionDecimalMatches) if (closeEnough(decimalValue, num, opts.tolerance)) {
+		const fraction = getFraction(vf, opts);
+		const isVulgar = fraction in vulgarToAsciiMap;
+		return `${sign}${wholeStr}${wholeStr ? opts.separator ?? (isVulgar ? "" : " ") : ""}${fraction}`;
+	}
+	return `${qtyAsNumber}`;
 };
 
-// src/index.ts
-var src_default = formatQuantity;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  defaultOptions,
-  defaultTolerance,
-  formatQuantity,
-  fractionDecimalMatches,
-  vulgarToAsciiMap
-});
+//#endregion
+exports.defaultOptions = defaultOptions;
+exports.defaultTolerance = defaultTolerance;
+exports.formatQuantity = formatQuantity;
+exports.formatRomanNumerals = formatRomanNumerals;
+exports.fractionDecimalMatches = fractionDecimalMatches;
+exports.vulgarToAsciiMap = vulgarToAsciiMap;
 //# sourceMappingURL=format-quantity.cjs.development.js.map

package/dist/cjs/format-quantity.cjs.development.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/constants.ts","../../src/formatQuantity.ts"],"sourcesContent":["import { formatQuantity } from './formatQuantity';\nexport * from './constants';\nexport * from './types';\nexport { formatQuantity };\nexport default formatQuantity;\n","import type {\n  FormatQuantityOptions,\n  SimpleFraction,\n  Sixteenth,\n  VulgarFraction,\n} from './types';\n\nexport const defaultTolerance = 0.0075 as const;\n\nexport const defaultOptions = {\n  vulgarFractions: false,\n  tolerance: defaultTolerance,\n  fractionSlash: false,\n  romanNumerals: false,\n} satisfies Required<FormatQuantityOptions>;\n\n/**\n * A map of vulgar or simple sixteenth fractions to their traditional ASCII\n * equivalents. Sixteenths map to themselves.\n */\nexport const vulgarToAsciiMap = {\n  '¼': '1/4',\n  '½': '1/2',\n  '¾': '3/4',\n  '⅐': '1/7',\n  '⅑': '1/9',\n  '⅒': '1/10',\n  '⅓': '1/3',\n  '⅔': '2/3',\n  '⅕': '1/5',\n  '⅖': '2/5',\n  '⅗': '3/5',\n  '⅘': '4/5',\n  '⅙': '1/6',\n  '⅚': '5/6',\n  '⅛': '1/8',\n  '⅜': '3/8',\n  '⅝': '5/8',\n  '⅞': '7/8',\n} satisfies Record<VulgarFraction, SimpleFraction>;\n\nexport const fractionDecimalMatches = [\n  [0.33, '⅓'],\n  [0.66, '⅔'],\n  [0.2, '⅕'],\n  [0.4, '⅖'],\n  [0.6, '⅗'],\n  [0.8, '⅘'],\n  [0.166, '⅙'],\n  [0.833, '⅚'],\n  [0.143, '⅐'],\n  [0.111, '⅑'],\n  [0.1, '⅒'],\n  [0.125, '⅛'],\n  [0.25, '¼'],\n  [0.375, '⅜'],\n  [0.5, '½'],\n  [0.625, '⅝'],\n  [0.75, '¾'],\n  [0.875, '⅞'],\n  [0.0625, '1/16'],\n  [0.1875, '3/16'],\n  [0.3125, '5/16'],\n  [0.4375, '7/16'],\n  [0.5625, '9/16'],\n  [0.6875, '11/16'],\n  [0.8125, '13/16'],\n  [0.9375, '15/16'],\n] satisfies [number, VulgarFraction | Sixteenth][];\n","import {\n  defaultOptions,\n  fractionDecimalMatches,\n  vulgarToAsciiMap,\n} from './constants';\nimport type {\n  FormatQuantity,\n  FormatQuantityOptions,\n  SimpleFraction,\n  Sixteenth,\n  VulgarFraction,\n} from './types';\n\n/**\n * Determines if two numbers are close enough to consider\n * them equal for the purposes of this package.\n */\nconst closeEnough = (n1: number, n2: number, tolerance: number) =>\n  Math.abs(n1 - n2) < tolerance;\n\nconst getFraction = (\n  vulgarFractionOrSixteenth: VulgarFraction | Sixteenth,\n  { fractionSlash, vulgarFractions }: FormatQuantityOptions\n) => {\n  if (vulgarFractions) {\n    return vulgarFractionOrSixteenth;\n  }\n\n  const plainFraction: SimpleFraction =\n    vulgarToAsciiMap[vulgarFractionOrSixteenth as VulgarFraction] ??\n    vulgarFractionOrSixteenth;\n\n  if (fractionSlash) {\n    return plainFraction.replace('/', '⁄');\n  }\n\n  return plainFraction;\n};\n\nconst normalizeOptions = (\n  options: Parameters<FormatQuantity>[1]\n): Required<FormatQuantityOptions> => ({\n  ...defaultOptions,\n  ...(typeof options === 'boolean' ? { vulgarFractions: options } : options),\n});\n\n// prettier-ignore\nconst romanNumeralValueKey = [\n  \"\", \"C\", \"CC\", \"CCC\", \"CD\", \"D\", \"DC\", \"DCC\", \"DCCC\", \"CM\",\n  \"\", \"X\", \"XX\", \"XXX\", \"XL\", \"L\", \"LX\", \"LXX\", \"LXXX\", \"XC\",\n  \"\", \"I\", \"II\", \"III\", \"IV\", \"V\", \"VI\", \"VII\", \"VIII\", \"IX\",\n] as const;\n\n/**\n * Formats a number as Roman numerals. The number must be between\n * 1 and 3999 (inclusive).\n */\nexport const formatRomanNumerals = (qty: number) => {\n  if (typeof qty !== 'number' || isNaN(qty)) {\n    return null;\n  }\n\n  if (qty < 1 || qty >= 4000) {\n    return '';\n  }\n\n  const floored = Math.floor(qty);\n\n  const digits = `${floored}`.split('');\n  let roman = '';\n  let i = 3;\n  while (i--) {\n    roman = `${romanNumeralValueKey[+digits.pop()! + i * 10] || ''}${roman}`;\n  }\n  return `${Array(+digits.join('') + 1).join('M')}${roman}`;\n};\n\n/**\n * Formats a number (or string that appears to be a number)\n * as one would see it written in imperial measurements, e.g.\n * \"1 1/2\" instead of \"1.5\". To use vulgar fraction characters\n * like \"½\", pass `true` as the second argument. For other options\n * see the [documentation](https://jakeboone02.github.io/format-quantity/).\n */\nexport const formatQuantity: FormatQuantity = (\n  qty,\n  options = defaultOptions\n) => {\n  // TODO: use numericQuantity instead of parseFloat?\n  const qtyAsNumber = typeof qty === 'string' ? parseFloat(qty) : qty;\n\n  // Return `null` if input is not number-like\n  if (isNaN(qtyAsNumber) || qtyAsNumber === null) {\n    return null;\n  }\n\n  // Return an empty string if the value is zero\n  if (qtyAsNumber === 0) {\n    return '';\n  }\n\n  // The default options parameter in the function signature only takes effect\n  // if the parameter is `undefined`. The nullish coalescing operator below\n  // covers the `null` case.\n  const opts = normalizeOptions(options ?? defaultOptions);\n\n  if (opts.romanNumerals) {\n    return formatRomanNumerals(qtyAsNumber);\n  }\n\n  const absoluteValue = Math.abs(qtyAsNumber);\n  const flooredAbsVal = Math.floor(absoluteValue);\n  const flooredAbsValStr = `${qtyAsNumber < 0 ? '-' : ''}${\n    flooredAbsVal === 0 ? '' : `${flooredAbsVal} `\n  }`;\n  const decimalValue = absoluteValue - flooredAbsVal;\n\n  // For integers just return the given value as a string\n  if (decimalValue === 0) {\n    return `${qtyAsNumber}`;\n  }\n\n  for (const [num, vf] of fractionDecimalMatches) {\n    if (closeEnough(decimalValue, num, opts.tolerance)) {\n      const fraction = getFraction(vf, opts);\n      const int = Object.hasOwn(vulgarToAsciiMap, fraction)\n        ? flooredAbsValStr.trim()\n        : flooredAbsValStr;\n      return `${int}${fraction}`;\n    }\n  }\n\n  return `${qtyAsNumber}`;\n};\n"],"mappings":"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","names":[]}
+{"version":3,"file":"format-quantity.cjs.development.js","names":[],"sources":["../../src/constants.ts","../../src/formatQuantity.ts"],"sourcesContent":["import type {\n  ResolvedFormatQuantityOptions,\n  SimpleFraction,\n  Sixteenth,\n  VulgarFraction,\n} from './types';\n\n/**\n * Default tolerance used by {@link formatQuantity} when determining if a number\n * is close enough to a fraction value to be considered equivalent.\n */\nexport const defaultTolerance = 0.0075 as const;\n\n/**\n * Default options for {@link formatQuantity}.\n */\nexport const defaultOptions: ResolvedFormatQuantityOptions = {\n  vulgarFractions: false,\n  tolerance: defaultTolerance,\n  fractionSlash: false,\n  romanNumerals: false,\n} as const;\n\n/**\n * Map of vulgar fractions to their traditional ASCII equivalents.\n */\nexport const vulgarToAsciiMap: Record<VulgarFraction, SimpleFraction> = {\n  '¼': '1/4',\n  '½': '1/2',\n  '¾': '3/4',\n  '⅐': '1/7',\n  '⅑': '1/9',\n  '⅒': '1/10',\n  '⅓': '1/3',\n  '⅔': '2/3',\n  '⅕': '1/5',\n  '⅖': '2/5',\n  '⅗': '3/5',\n  '⅘': '4/5',\n  '⅙': '1/6',\n  '⅚': '5/6',\n  '⅛': '1/8',\n  '⅜': '3/8',\n  '⅝': '5/8',\n  '⅞': '7/8',\n} as const;\n\n/**\n * Map of \"close enough\" decimal values to the {@link VulgarFraction} or\n * {@link Sixteenth} fraction string matches.\n */\nexport const fractionDecimalMatches: [number, VulgarFraction | Sixteenth][] = [\n  [0.33, '⅓'],\n  [0.66, '⅔'],\n  [0.2, '⅕'],\n  [0.4, '⅖'],\n  [0.6, '⅗'],\n  [0.8, '⅘'],\n  [0.166, '⅙'],\n  [0.833, '⅚'],\n  [0.143, '⅐'],\n  [0.111, '⅑'],\n  [0.1, '⅒'],\n  [0.125, '⅛'],\n  [0.25, '¼'],\n  [0.375, '⅜'],\n  [0.5, '½'],\n  [0.625, '⅝'],\n  [0.75, '¾'],\n  [0.875, '⅞'],\n  [0.0625, '1/16'],\n  [0.1875, '3/16'],\n  [0.3125, '5/16'],\n  [0.4375, '7/16'],\n  [0.5625, '9/16'],\n  [0.6875, '11/16'],\n  [0.8125, '13/16'],\n  [0.9375, '15/16'],\n] as const;\n","import { numericQuantity } from 'numeric-quantity';\nimport {\n  defaultOptions,\n  fractionDecimalMatches,\n  vulgarToAsciiMap,\n} from './constants';\nimport type {\n  FormatQuantity,\n  FormatQuantityOptions,\n  ResolvedFormatQuantityOptions,\n  SimpleFraction,\n  Sixteenth,\n  VulgarFraction,\n} from './types';\n\n/**\n * Determines if two numbers are close enough to consider\n * them equal for the purposes of this package.\n */\nconst closeEnough = (n1: number, n2: number, tolerance: number) =>\n  Math.abs(n1 - n2) < tolerance;\n\nconst superscriptDigits = '⁰¹²³⁴⁵⁶⁷⁸⁹';\nconst subscriptDigits = '₀₁₂₃₄₅₆₇₈₉';\n\nconst toSuperscript = (s: string) => {\n  let r = '';\n  for (let i = 0; i < s.length; i++) r += superscriptDigits[+s[i]];\n  return r;\n};\nconst toSubscript = (s: string) => {\n  let r = '';\n  for (let i = 0; i < s.length; i++) r += subscriptDigits[+s[i]];\n  return r;\n};\n\n/**\n * Applies the `vulgarFractions` or `fractionSlash` options as necessary.\n */\nconst getFraction = (\n  vulgarFractionOrSixteenth: VulgarFraction | Sixteenth,\n  { fractionSlash, vulgarFractions }: FormatQuantityOptions\n) => {\n  if (vulgarFractions) {\n    return vulgarFractionOrSixteenth;\n  }\n\n  const plainFraction: SimpleFraction =\n    vulgarToAsciiMap[vulgarFractionOrSixteenth as VulgarFraction] ??\n    vulgarFractionOrSixteenth;\n\n  if (fractionSlash) {\n    const [num, den] = plainFraction.split('/');\n    return `${toSuperscript(num)}⁄${toSubscript(den)}`;\n  }\n\n  return plainFraction;\n};\n\n/**\n * Merges options object with default options, converting boolean to object if necessary.\n */\nconst normalizeOptions = (\n  options: Parameters<FormatQuantity>[1]\n): ResolvedFormatQuantityOptions => ({\n  ...defaultOptions,\n  ...(typeof options === 'boolean' ? { vulgarFractions: options } : options),\n});\n\n// prettier-ignore\nconst romanNumeralValueKey = [\n  \"\", \"C\", \"CC\", \"CCC\", \"CD\", \"D\", \"DC\", \"DCC\", \"DCCC\", \"CM\",\n  \"\", \"X\", \"XX\", \"XXX\", \"XL\", \"L\", \"LX\", \"LXX\", \"LXXX\", \"XC\",\n  \"\", \"I\", \"II\", \"III\", \"IV\", \"V\", \"VI\", \"VII\", \"VIII\", \"IX\",\n] as const;\n\n/**\n * Formats a number as Roman numerals. The number must be between\n * 1 and 3999, inclusive.\n */\nexport const formatRomanNumerals = (qty: number): string | null => {\n  if (typeof qty !== 'number' || isNaN(qty)) {\n    return null;\n  }\n\n  if (qty < 1 || qty >= 4000) {\n    return '';\n  }\n\n  const floored = Math.floor(qty);\n\n  const digits = `${floored}`.split('');\n  let roman = '';\n  let i = 3;\n  while (i--) {\n    roman = `${romanNumeralValueKey[+digits.pop()! + i * 10] || ''}${roman}`;\n  }\n\n  return `${Array(+digits.join('') + 1).join('M')}${roman}`;\n};\n\n/**\n * Formats a number (or string that appears to be a number)\n * as one would see it written in imperial measurements, e.g.\n * \"1 1/2\" instead of \"1.5\". To use vulgar fraction characters\n * like \"½\", pass `true` as the second argument. For other options\n * see {@link FormatQuantityOptions}.\n */\nexport const formatQuantity: FormatQuantity = (\n  qty,\n  options = defaultOptions\n) => {\n  const qtyAsNumber =\n    typeof qty === 'string'\n      ? numericQuantity(qty, { round: false, allowTrailingInvalid: true })\n      : qty;\n\n  // Return `null` if input is not number-like.\n  if (isNaN(qtyAsNumber) || qtyAsNumber === null) {\n    return null;\n  }\n\n  // Return an empty string if the value is zero.\n  // TODO: Consider a `zeroDisplay` option (e.g. `{ zeroDisplay: \"0\" }`) so\n  // callers outside the recipe-ingredient use case can get \"0\" instead of \"\".\n  if (qtyAsNumber === 0) {\n    return '';\n  }\n\n  // The default options parameter in the function signature only takes effect\n  // if the parameter is `undefined`. The nullish coalescing operator below\n  // covers the `null` case.\n  const opts = normalizeOptions(options ?? defaultOptions);\n\n  if (opts.romanNumerals) {\n    return formatRomanNumerals(qtyAsNumber);\n  }\n\n  const absoluteValue = Math.abs(qtyAsNumber);\n  const flooredAbsVal = Math.floor(absoluteValue);\n  const sign = qtyAsNumber < 0 ? '-' : '';\n  const wholeStr = flooredAbsVal === 0 ? '' : `${flooredAbsVal}`;\n  const decimalValue = absoluteValue - flooredAbsVal;\n\n  // For integers just return the given value as a string.\n  if (decimalValue === 0) {\n    return `${qtyAsNumber}`;\n  }\n\n  for (const [num, vf] of fractionDecimalMatches) {\n    if (closeEnough(decimalValue, num, opts.tolerance)) {\n      const fraction = getFraction(vf, opts);\n      const isVulgar = fraction in vulgarToAsciiMap;\n      const sep = wholeStr\n        ? (opts.separator ?? (isVulgar ? '' : ' '))\n        : '';\n      return `${sign}${wholeStr}${sep}${fraction}`;\n    }\n  }\n\n  return `${qtyAsNumber}`;\n};\n"],"mappings":"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"}