@flickfyi/flkr 0.0.140 → 0.0.146

package/node_modules/decimal.js/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "decimal.js",
+  "description": "An arbitrary-precision Decimal type for JavaScript.",
+  "version": "10.6.0",
+  "keywords": [
+    "arbitrary",
+    "precision",
+    "arithmetic",
+    "big",
+    "number",
+    "decimal",
+    "float",
+    "biginteger",
+    "bigdecimal",
+    "bignumber",
+    "bigint",
+    "bignum"
+  ],
+  "repository" : {
+    "type": "git",
+    "url": "https://github.com/MikeMcl/decimal.js.git"
+  },
+  "main": "decimal",
+  "module": "decimal.mjs",
+  "browser": "decimal.js",
+  "exports": {
+    ".": {
+      "types": "./decimal.d.ts",
+      "import": "./decimal.mjs",
+      "require": "./decimal.js"
+    },
+    "./decimal.mjs": "./decimal.mjs",
+    "./decimal.js": "./decimal.js",
+    "./package.json": "./package.json",
+    "./decimal": {
+      "types": "./decimal.d.ts",
+      "import": "./decimal.mjs",
+      "require": "./decimal.js"
+    }
+  },
+  "author": {
+    "name": "Michael Mclaughlin",
+    "email": "M8ch88l@gmail.com"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test": "node ./test/test.js"
+  },
+  "types": "decimal.d.ts",
+  "files": [
+    "decimal.js",
+    "decimal.mjs",
+    "decimal.d.ts"
+  ]
+}

package/node_modules/format-quantity/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Jake Boone
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/format-quantity/README.md

@@ -0,0 +1,181 @@
+[![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)](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 `bigint`, 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. 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- or 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 `number`, `string`, or `bigint`, or is a string with no recognizable numeric portion at the start. Trailing junk is tolerated, so `formatQuantity("1.5 cups")` returns `"1 1/2"`.
+- The return value will be an empty string (`""`) if the first argument is `0`, `0n`, or `"0"`, which fits the primary use case of formatting recipe ingredient quantities.
+- Values too large or too small for positional notation are returned in JavaScript's exponential form (e.g. `formatQuantity(1e21)` is `"1e+21"`), and `Infinity`/`-Infinity` are stringified as-is. `bigint` inputs are never exponential; they stringify in full.
+
+> _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._
+>
+> _If you're interested in parsing recipe ingredient strings, try [parse-ingredient](https://www.npmjs.com/package/parse-ingredient)._
+
+## Usage
+
+### Installed
+
+```js
+import { formatQuantity } from 'format-quantity';
+
+formatQuantity(1.5); // "1 1/2"
+formatQuantity(2.66); // "2 2/3"
+formatQuantity(3.875, true); // "3⅞"
+```
+
+### CDN
+
+As an ES module:
+
+```html
+<script type="module">
+  import { formatQuantity } from 'https://cdn.jsdelivr.net/npm/format-quantity/+esm';
+
+  console.log(formatQuantity(10.5)); // "10 1/2"
+</script>
+```
+
+As UMD (all exports are properties of the global object `FormatQuantity`):
+
+```html
+<script src="https://unpkg.com/format-quantity"></script>
+<script>
+  console.log(FormatQuantity.formatQuantity(10.5)); // "10 1/2"
+</script>
+```
+
+## Options
+
+The second parameter to `formatQuantity` can be a `boolean` value or an options object.
+
+### `vulgarFractions`
+
+| Type      | Default |
+| --------- | ------- |
+| `boolean` | `false` |
+
+Returns vulgar fractions when appropriate. This option has the same effect as passing a plain `boolean` value as the second parameter.
+
+```js
+formatQuantity(3.875, { vulgarFractions: true }); // "3⅞"
+// is the same as
+formatQuantity(3.875, true); // "3⅞"
+```
+
+Note: `formatQuantity` supports sixteenths, but no vulgar fraction characters exist for that denomination. Therefore the `vulgarFractions` option has no effect if the fraction portion of the final string is an odd numerator over a denominator of `16`.
+
+### `fractionSlash`
+
+| Type      | Default |
+| --------- | ------- |
+| `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"`), 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 ⁷⁄₈"
+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 |
+| ----------------- | -------: |
+| `number \| false` | `0.0075` |
+
+This option determines how close the decimal portion of a number has to be to the actual quotient of a fraction to be considered a match. For example, consider the fraction 1⁄3: $1 \div 3 = 0.\overline{333}$, repeating forever. The number `0.333` (exactly 333 thousandths) is not equivalent to 1⁄3, but it's very close. So even though $0.333 \neq 1 \div 3$, both `formatQuantity(0.333)` and `formatQuantity(1/3)` will return `"1/3"`.
+
+The window is centered on the exact quotient and is checked against every candidate fraction; when more than one is within the window, the **closest** one wins regardless of evaluation order.
+
+A lower tolerance increases the likelihood that `formatQuantity` will return a decimal representation instead of a fraction or mixed number since the matching algorithm will be stricter. A higher tolerance increases the likelihood that `formatQuantity` will return a fraction or mixed number, but at the risk of matching a fraction that is only loosely related to the input.
+
+```js
+// Low tolerance - returns a decimal since 0.333 is not close enough to 1/3
+formatQuantity(0.333, { tolerance: 0.00001 }); // "0.333"
+// High tolerance - 0.3 is within 0.1 of both 5/16 and 1/3, and 5/16 is closer
+formatQuantity(0.3, { tolerance: 0.1 }); // "5/16"
+```
+
+Two values are special:
+
+- `0` means **only exact quotients match**. Anything else falls through to its decimal representation.
+- `false` **disables fraction matching entirely**, so every non-integer is returned as a decimal.
+
+```js
+formatQuantity(1.5, { tolerance: 0 }); // "1 1/2" (0.5 is exactly 1 ÷ 2)
+formatQuantity(1.51, { tolerance: 0 }); // "1.51"
+formatQuantity(1.5, { tolerance: false }); // "1.5"
+```
+
+Any other value—a negative number, `NaN`, a numeric string, `null`, `undefined`—is ignored and the default is used instead.
+
+### `zeroFormat`
+
+| Type     | Default |
+| -------- | ------- |
+| `string` | `""`    |
+
+Specify the string to return when the input numerically evaluates to zero (`0`).
+
+```js
+formatQuantity(0, { zeroFormat: '' }); // "" (default)
+formatQuantity(0, { zeroFormat: '0' }); // "0"
+formatQuantity(0, { zeroFormat: 'N/A' }); // "N/A"
+```
+
+### `allowTrailingInvalid`
+
+| Type      | Default |
+| --------- | ------- |
+| `boolean` | `true`  |
+
+If input is a `string`, ignore trailing non-numeric input (à la `parseFloat`). Set to `false` for strict parsing — any invalid characters will result in `null`.
+
+```js
+formatQuantity('123abc', { allowTrailingInvalid: true }); // "123"
+formatQuantity('123abc', { allowTrailingInvalid: false }); // null
+```
+
+### `romanNumerals`
+
+| Type      | Default |
+| --------- | ------: |
+| `boolean` | `false` |
+
+Coerces the number into an integer using `Math.floor`, then formats the value as Roman numerals. The algorithm uses strict, modern rules, so the number must be between `1` and `3999` inclusive (or between `1n` and `3999n` — `bigint` is also allowed). Values outside that range return `null`.
+
+When this option is `true`, all other options are ignored.
+
+```js
+formatQuantity(1214, { romanNumerals: true }); // "MCCXIV"
+formatQuantity(12.14, { romanNumerals: true, vulgarFractions: true }); // "XII"
+formatQuantity(4000, { romanNumerals: true }); // null
+formatQuantity(-1, { romanNumerals: true }); // null
+```
+
+> _`formatQuantity(0, …)` returns `""` (or the configured `zeroFormat`) regardless of this option, since the zero rule is applied before options are processed._
+
+[badge-npm]: https://img.shields.io/npm/v/format-quantity.svg?cacheSeconds=3600&logo=npm

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

@@ -0,0 +1,131 @@
+//#region src/types.d.ts
+interface FormatQuantityOptions {
+  /**
+   * Output vulgar fractions, like "½" instead of "1/2", when appropriate.
+   * Overrides the `fractionSlash` option.
+   *
+   * @default false
+   */
+  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.
+   *
+   * `0` means only exact quotients match. `false` disables fraction matching
+   * entirely, so decimal values are always returned as decimals.
+   *
+   * Any other value—negative, non-numeric, `NaN`, `null`, `undefined`—resolves
+   * to the default.
+   *
+   * @default 0.0075
+   */
+  tolerance?: number | false;
+  /**
+   * 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.
+   *
+   * @default false
+   */
+  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.
+   *
+   * @default false
+   */
+  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;
+  /**
+   * String to return when the input evaluates numerically to zero.
+   *
+   * @default "" (empty string)
+   */
+  zeroFormat?: string;
+  /**
+   * If `qty` is a string, allow trailing invalid characters after the numeric portion.
+   *
+   * @default true
+   */
+  allowTrailingInvalid?: boolean;
+}
+/**
+ * {@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 | bigint, 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 = "¼" | "½" | "¾" | "⅐" | "⅑" | "⅒" | "⅓" | "⅔" | "⅕" | "⅖" | "⅗" | "⅘" | "⅙" | "⅚" | "⅛" | "⅜" | "⅝" | "⅞";
+//#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: Readonly<ResolvedFormatQuantityOptions>;
+/**
+ * Map of vulgar fractions to their traditional ASCII equivalents.
+ */
+declare const vulgarToAsciiMap: Readonly<Record<VulgarFraction, SimpleFraction>>;
+/**
+ * Map of "close enough" values to the {@link VulgarFraction} or {@link Sixteenth} fraction
+ * string matches. The value +/- the `tolerance` option (or {@link defaultTolerance} if not
+ * specified) is considered close enough to match the fraction.
+ */
+declare const fractionDecimalMatches: readonly (readonly [number, VulgarFraction | Sixteenth])[];
+//#endregion
+//#region src/formatQuantity.d.ts
+/**
+ * Formats a number or bigint as Roman numerals. The number must be between
+ * 1 and 3999, inclusive; any other value—including non-numbers,
+ * `NaN`, and non-finite numbers—yields `null`.
+ */
+declare const formatRomanNumerals: (quantity: number | bigint) => 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, NonZeroDigit, ResolvedFormatQuantityOptions, SimpleFraction, Sixteenth, VulgarFraction, defaultOptions, defaultTolerance, formatQuantity, formatRomanNumerals, fractionDecimalMatches, vulgarToAsciiMap };
+//# sourceMappingURL=format-quantity.cjs.development.d.ts.map

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

@@ -0,0 +1,214 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let numeric_quantity = require("numeric-quantity");
+//#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 = Object.freeze({
+	vulgarFractions: false,
+	tolerance: defaultTolerance,
+	fractionSlash: false,
+	romanNumerals: false,
+	zeroFormat: "",
+	allowTrailingInvalid: true
+});
+/**
+* Map of vulgar fractions to their traditional ASCII equivalents.
+*/
+const vulgarToAsciiMap = Object.freeze({
+	"¼": "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"
+});
+/**
+* Map of "close enough" values to the {@link VulgarFraction} or {@link Sixteenth} fraction
+* string matches. The value +/- the `tolerance` option (or {@link defaultTolerance} if not
+* specified) is considered close enough to match the fraction.
+*/
+const fractionDecimalMatches = Object.freeze([
+	[1 / 16, "1/16"],
+	[1 / 10, "⅒"],
+	[1 / 9, "⅑"],
+	[1 / 8, "⅛"],
+	[1 / 7, "⅐"],
+	[1 / 6, "⅙"],
+	[3 / 16, "3/16"],
+	[1 / 5, "⅕"],
+	[1 / 4, "¼"],
+	[5 / 16, "5/16"],
+	[1 / 3, "⅓"],
+	[3 / 8, "⅜"],
+	[2 / 5, "⅖"],
+	[7 / 16, "7/16"],
+	[1 / 2, "½"],
+	[9 / 16, "9/16"],
+	[3 / 5, "⅗"],
+	[5 / 8, "⅝"],
+	[2 / 3, "⅔"],
+	[11 / 16, "11/16"],
+	[3 / 4, "¾"],
+	[4 / 5, "⅘"],
+	[13 / 16, "13/16"],
+	[5 / 6, "⅚"],
+	[7 / 8, "⅞"],
+	[15 / 16, "15/16"]
+].map((entry) => Object.freeze(entry)));
+//#endregion
+//#region src/formatQuantity.ts
+const superscriptDigits = "⁰¹²³⁴⁵⁶⁷⁸⁹";
+const subscriptDigits = "₀₁₂₃₄₅₆₇₈₉";
+const toSuperscript = (s) => [...s].map((c) => superscriptDigits[+c]).join("");
+const toSubscript = (s) => [...s].map((c) => subscriptDigits[+c]).join("");
+/**
+* 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;
+};
+/**
+* Only `false` (matching disabled) or a non-negative number is a valid
+* `tolerance`. Everything else—negative numbers, `NaN`, non-numbers,
+* `null`, `undefined`—resolves to {@link defaultTolerance}.
+*/
+const isValidTolerance = (tolerance) => tolerance === false || typeof tolerance === "number" && tolerance >= 0;
+/**
+* Merges options object with default options, converting boolean to object if necessary.
+*/
+const normalizeOptions = (options) => {
+	const opts = {
+		...defaultOptions,
+		...typeof options === "boolean" ? { vulgarFractions: options } : typeof options === "object" && options !== null ? options : {}
+	};
+	if (!isValidTolerance(opts.tolerance)) opts.tolerance = defaultOptions.tolerance;
+	if (typeof opts.zeroFormat !== "string") opts.zeroFormat = defaultOptions.zeroFormat;
+	if (opts.allowTrailingInvalid !== false) opts.allowTrailingInvalid = true;
+	return opts;
+};
+const romanNumeralsByPlace = [
+	"",
+	"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"
+];
+/**
+* Formats a number or bigint as Roman numerals. The number must be between
+* 1 and 3999, inclusive; any other value—including non-numbers,
+* `NaN`, and non-finite numbers—yields `null`.
+*/
+const formatRomanNumerals = (quantity) => {
+	if (typeof quantity !== "number" && typeof quantity !== "bigint" || !(quantity >= 1 && quantity < 4e3)) return null;
+	const qty = Number(quantity);
+	const digits = `${Math.floor(qty)}`.split("");
+	let roman = "";
+	let i = 3;
+	while (i--) roman = `${romanNumeralsByPlace[+digits.pop() + i * 10] || ""}${roman}`;
+	return `${Array(+digits.join("") + 1).join("M")}${roman}`;
+};
+/**
+* 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) => {
+	if (typeof qty !== "number" && typeof qty !== "string" && typeof qty !== "bigint") return null;
+	const opts = normalizeOptions(options);
+	const qtyAsNumber = typeof qty !== "number" && typeof qty !== "bigint" ? (0, numeric_quantity.numericQuantity)(qty, {
+		allowTrailingInvalid: opts.allowTrailingInvalid,
+		romanNumerals: opts.romanNumerals,
+		bigIntOnOverflow: true,
+		round: false
+	}) : qty;
+	if (typeof qtyAsNumber === "number" && isNaN(qtyAsNumber)) return null;
+	if (Number(qtyAsNumber) === 0) return opts.zeroFormat;
+	if (opts.romanNumerals) return formatRomanNumerals(qtyAsNumber);
+	const absoluteValue = typeof qtyAsNumber === "bigint" ? qtyAsNumber < 0n ? -qtyAsNumber : qtyAsNumber : Math.abs(qtyAsNumber);
+	const flooredAbsVal = typeof absoluteValue === "bigint" ? absoluteValue : Math.floor(absoluteValue);
+	const wholeNumberStr = `${flooredAbsVal || ""}`;
+	const decimalValue = typeof absoluteValue === "bigint" ? 0 : absoluteValue - flooredAbsVal;
+	if (decimalValue === 0) return `${qtyAsNumber}`;
+	let closestMatch = null;
+	let closestMatchDiff = Infinity;
+	if (opts.tolerance !== false) for (const [num, vf] of fractionDecimalMatches) {
+		const diff = Math.abs(decimalValue - num);
+		if (diff < opts.tolerance || diff === 0) {
+			if (diff === 0) {
+				closestMatch = vf;
+				break;
+			}
+			if (diff < closestMatchDiff) {
+				closestMatch = vf;
+				closestMatchDiff = diff;
+			}
+		}
+	}
+	if (closestMatch) {
+		const fraction = getFraction(closestMatch, opts);
+		const isVulgar = fraction in vulgarToAsciiMap;
+		const sep = wholeNumberStr ? opts.separator ?? (isVulgar ? "" : " ") : "";
+		return `${qtyAsNumber < 0 ? "-" : ""}${wholeNumberStr}${sep}${fraction}`;
+	}
+	return `${qtyAsNumber}`;
+};
+//#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/node_modules/format-quantity/dist/cjs/format-quantity.cjs.development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-quantity.cjs.development.js","names":["numericQuantity"],"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: Readonly<ResolvedFormatQuantityOptions> = Object.freeze({\n  vulgarFractions: false,\n  tolerance: defaultTolerance,\n  fractionSlash: false,\n  romanNumerals: false,\n  zeroFormat: '',\n  allowTrailingInvalid: true,\n});\n\n/**\n * Map of vulgar fractions to their traditional ASCII equivalents.\n */\nexport const vulgarToAsciiMap: Readonly<Record<VulgarFraction, SimpleFraction>> = Object.freeze({\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});\n\n/**\n * Map of \"close enough\" values to the {@link VulgarFraction} or {@link Sixteenth} fraction\n * string matches. The value +/- the `tolerance` option (or {@link defaultTolerance} if not\n * specified) is considered close enough to match the fraction.\n */\nexport const fractionDecimalMatches: readonly (readonly [number, VulgarFraction | Sixteenth])[] =\n  Object.freeze(\n    (\n      [\n        [1 / 16, '1/16'],\n        [1 / 10, '⅒'],\n        [1 / 9, '⅑'],\n        [1 / 8, '⅛'],\n        [1 / 7, '⅐'],\n        [1 / 6, '⅙'],\n        [3 / 16, '3/16'],\n        [1 / 5, '⅕'],\n        [1 / 4, '¼'],\n        [5 / 16, '5/16'],\n        [1 / 3, '⅓'],\n        [3 / 8, '⅜'],\n        [2 / 5, '⅖'],\n        [7 / 16, '7/16'],\n        [1 / 2, '½'],\n        [9 / 16, '9/16'],\n        [3 / 5, '⅗'],\n        [5 / 8, '⅝'],\n        [2 / 3, '⅔'],\n        [11 / 16, '11/16'],\n        [3 / 4, '¾'],\n        [4 / 5, '⅘'],\n        [13 / 16, '13/16'],\n        [5 / 6, '⅚'],\n        [7 / 8, '⅞'],\n        [15 / 16, '15/16'],\n      ] satisfies [number, VulgarFraction | Sixteenth][]\n    ).map(entry => Object.freeze(entry))\n  );\n","import { numericQuantity } from 'numeric-quantity';\nimport { defaultOptions, fractionDecimalMatches, vulgarToAsciiMap } from './constants';\nimport type {\n  FormatQuantity,\n  ResolvedFormatQuantityOptions,\n  SimpleFraction,\n  Sixteenth,\n  VulgarFraction,\n} from './types';\n\nconst superscriptDigits = '⁰¹²³⁴⁵⁶⁷⁸⁹';\nconst subscriptDigits = '₀₁₂₃₄₅₆₇₈₉';\n\n// oxlint-disable-next-line typescript/no-misused-spread\nconst toSuperscript = (s: string) => [...s].map(c => superscriptDigits[+c]).join('');\n// oxlint-disable-next-line typescript/no-misused-spread\nconst toSubscript = (s: string) => [...s].map(c => subscriptDigits[+c]).join('');\n\n/**\n * Applies the `vulgarFractions` or `fractionSlash` options as necessary.\n */\nconst getFraction = (\n  vulgarFractionOrSixteenth: VulgarFraction | Sixteenth,\n  { fractionSlash, vulgarFractions }: ResolvedFormatQuantityOptions\n) => {\n  if (vulgarFractions) {\n    return vulgarFractionOrSixteenth;\n  }\n\n  const plainFraction: SimpleFraction =\n    vulgarToAsciiMap[vulgarFractionOrSixteenth as VulgarFraction] ?? 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 * Only `false` (matching disabled) or a non-negative number is a valid\n * `tolerance`. Everything else—negative numbers, `NaN`, non-numbers,\n * `null`, `undefined`—resolves to {@link defaultTolerance}.\n */\nconst isValidTolerance = (tolerance: unknown): tolerance is number | false =>\n  tolerance === false || (typeof tolerance === 'number' && tolerance >= 0);\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  const opts: ResolvedFormatQuantityOptions = {\n    ...defaultOptions,\n    ...(typeof options === 'boolean'\n      ? { vulgarFractions: options }\n      : typeof options === 'object' && options !== null\n        ? options\n        : {}),\n  };\n\n  if (!isValidTolerance(opts.tolerance)) {\n    opts.tolerance = defaultOptions.tolerance;\n  }\n\n  if (typeof opts.zeroFormat !== 'string') {\n    opts.zeroFormat = defaultOptions.zeroFormat;\n  }\n\n  if (opts.allowTrailingInvalid !== false) {\n    opts.allowTrailingInvalid = true;\n  }\n\n  return opts;\n};\n\n// oxfmt-ignore\nconst romanNumeralsByPlace = [\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 or bigint as Roman numerals. The number must be between\n * 1 and 3999, inclusive; any other value—including non-numbers,\n * `NaN`, and non-finite numbers—yields `null`.\n */\nexport const formatRomanNumerals = (quantity: number | bigint): string | null => {\n  if (\n    (typeof quantity !== 'number' && typeof quantity !== 'bigint') ||\n    !(quantity >= 1 && quantity < 4000)\n  ) {\n    return null;\n  }\n\n  const qty = Number(quantity);\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 = `${romanNumeralsByPlace[+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 = (qty, options) => {\n  // Only numbers, bigints, and strings are accepted. Anything else (objects, booleans,\n  // nullish, arrays like `[1]` that would coerce to a numeric string) is\n  // rejected up front so off-type inputs behave consistently.\n  if (typeof qty !== 'number' && typeof qty !== 'string' && typeof qty !== 'bigint') {\n    return null;\n  }\n\n  const opts = normalizeOptions(options);\n\n  const qtyAsNumber =\n    typeof qty !== 'number' && typeof qty !== 'bigint'\n      ? numericQuantity(qty, {\n          allowTrailingInvalid: opts.allowTrailingInvalid,\n          romanNumerals: opts.romanNumerals,\n          bigIntOnOverflow: true,\n          round: false,\n        })\n      : qty;\n\n  // Return `null` if input is not number-like.\n  if (typeof qtyAsNumber === 'number' && isNaN(qtyAsNumber)) {\n    return null;\n  }\n\n  // Return empty string (or configured `zeroFormat`) if the value is zero.\n  if (Number(qtyAsNumber) === 0) {\n    return opts.zeroFormat;\n  }\n\n  if (opts.romanNumerals) {\n    return formatRomanNumerals(qtyAsNumber);\n  }\n\n  const absoluteValue =\n    typeof qtyAsNumber === 'bigint'\n      ? qtyAsNumber < 0n\n        ? -qtyAsNumber\n        : qtyAsNumber\n      : Math.abs(qtyAsNumber);\n  const flooredAbsVal =\n    typeof absoluteValue === 'bigint' ? absoluteValue : Math.floor(absoluteValue);\n  const wholeNumberStr = `${flooredAbsVal || ''}`;\n  const decimalValue =\n    typeof absoluteValue === 'bigint' ? 0 : absoluteValue - (flooredAbsVal as number);\n\n  // For integers just return the given value as a string.\n  if (decimalValue === 0) {\n    return `${qtyAsNumber}`;\n  }\n\n  let closestMatch: VulgarFraction | Sixteenth | null = null;\n  let closestMatchDiff = Infinity;\n  // `tolerance: false` disables fraction matching entirely.\n  if (opts.tolerance !== false) {\n    for (const [num, vf] of fractionDecimalMatches) {\n      const diff = Math.abs(decimalValue - num);\n      // `diff === 0` keeps exact quotients matching even at `tolerance: 0`.\n      if (diff < opts.tolerance || diff === 0) {\n        if (diff === 0) {\n          closestMatch = vf;\n          break;\n        }\n        if (diff < closestMatchDiff) {\n          closestMatch = vf;\n          closestMatchDiff = diff;\n        }\n      }\n    }\n  }\n\n  if (closestMatch) {\n    const fraction = getFraction(closestMatch, opts);\n    const isVulgar = fraction in vulgarToAsciiMap;\n    const sep = wholeNumberStr ? (opts.separator ?? (isVulgar ? '' : ' ')) : '';\n    return `${qtyAsNumber < 0 ? '-' : ''}${wholeNumberStr}${sep}${fraction}`;\n  }\n\n  return `${qtyAsNumber}`;\n};\n"],"mappings":"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"}