format-quantity 1.0.2 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +71 -9
- package/dist/constants.d.ts +12 -0
- package/dist/format-quantity.cjs.js +1 -1
- package/dist/format-quantity.cjs.js.map +1 -1
- package/dist/format-quantity.es.js +96 -47
- package/dist/format-quantity.es.js.map +1 -1
- package/dist/format-quantity.umd.js +1 -1
- package/dist/format-quantity.umd.js.map +1 -1
- package/dist/formatQuantity.d.ts +9 -0
- package/dist/index.d.ts +4 -7
- package/dist/types.d.ts +36 -0
- package/package.json +22 -16
- package/CHANGELOG.md +0 -33
package/README.md
CHANGED
|
@@ -6,9 +6,9 @@
|
|
|
6
6
|
[](http://npm-stat.com/charts.html?package=format-quantity&from=2015-08-01)
|
|
7
7
|
[](http://opensource.org/licenses/MIT)
|
|
8
8
|
|
|
9
|
-
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
|
|
9
|
+
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.
|
|
10
10
|
|
|
11
|
-
For the inverse operation, converting a string (which may include mixed numbers or vulgar fractions) to a number
|
|
11
|
+
For the inverse operation, converting a string (which may include mixed numbers or vulgar fractions) to a `number`, check out [numeric-quantity](https://www.npmjs.com/package/numeric-quantity) or, if you're interested in parsing recipe ingredient strings, try [parse-ingredient](https://www.npmjs.com/package/parse-ingredient).
|
|
12
12
|
|
|
13
13
|
## Installation
|
|
14
14
|
|
|
@@ -24,23 +24,85 @@ yarn add format-quantity
|
|
|
24
24
|
|
|
25
25
|
### Browser
|
|
26
26
|
|
|
27
|
-
In the browser, available
|
|
27
|
+
In the browser, all exports including the `formatQuantity` function are available on the global object `FormatQuantity`.
|
|
28
28
|
|
|
29
29
|
```html
|
|
30
30
|
<script src="https://unpkg.com/format-quantity"></script>
|
|
31
31
|
<script>
|
|
32
|
-
console.log(formatQuantity(10.5)); // "10 1/2"
|
|
32
|
+
console.log(FormatQuantity.formatQuantity(10.5)); // "10 1/2"
|
|
33
33
|
</script>
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
## Usage
|
|
37
37
|
|
|
38
38
|
```js
|
|
39
|
-
import formatQuantity from 'format-quantity';
|
|
39
|
+
import { formatQuantity } from 'format-quantity';
|
|
40
40
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
41
|
+
formatQuantity(1.5); // "1 1/2"
|
|
42
|
+
formatQuantity(2.66); // "2 2/3"
|
|
43
|
+
formatQuantity(3.875, true); // "3⅞"
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
The return value will be `null` if the provided argument is not a number or a string that evaluates to a number using `parseFloat`. The return value will be an empty string (`""`) if the provided argument is `0` or `"0"` (this is done to fit the primary use case of recipe
|
|
46
|
+
The return value will be `null` if the provided argument is not a number or a string that evaluates to a number using `parseFloat`. The return value will be an empty string (`""`) if the provided argument is `0` or `"0"` (this is done to fit the primary use case of recipe ingredient quantities).
|
|
47
|
+
|
|
48
|
+
## Options
|
|
49
|
+
|
|
50
|
+
The second parameter to `formatQuantity` can be a `boolean` value or an options object.
|
|
51
|
+
|
|
52
|
+
### `vulgarFractions`
|
|
53
|
+
|
|
54
|
+
| Type | Default |
|
|
55
|
+
| --------- | ------: |
|
|
56
|
+
| `boolean` | `false` |
|
|
57
|
+
|
|
58
|
+
Returns vulgar fractions when appropriate. This option has the same effect as passing a plain `boolean` value as the second parameter.
|
|
59
|
+
|
|
60
|
+
```js
|
|
61
|
+
formatQuantity(3.875, { vulgarFractions: true }); // "3⅞"
|
|
62
|
+
// is the same as
|
|
63
|
+
formatQuantity(3.875, true); // "3⅞"
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
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`.
|
|
67
|
+
|
|
68
|
+
### `tolerance`
|
|
69
|
+
|
|
70
|
+
| Type | Default |
|
|
71
|
+
| -------- | ------: |
|
|
72
|
+
| `number` | `0.009` |
|
|
73
|
+
|
|
74
|
+
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 ÷ 3 = 0.3333...` repeating forever. The number `0.333` (333 thousandths) is not equivalent to 1⁄3, but it's very close. So even though `0.333 !== (1 / 3)`, `formatQuantity(0.333)` will return `"1/3"` the same as `formatQuantity(1/3)`.
|
|
75
|
+
|
|
76
|
+
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. An greater tolerance increases the likelihood that `formatQuantity` will return a fraction or mixed number, but at the risk of arbitrarily matching an incorrect fraction simply because it gets evaluated first (see [`src/index.ts`](src/index.ts) for the actual order of evaluation).
|
|
77
|
+
|
|
78
|
+
```js
|
|
79
|
+
// Low tolerance - returns a decimal since 0.333 is not close enough to 1/3
|
|
80
|
+
formatQuantity(0.333, { tolerance: 0.00001 }); // "0.333"
|
|
81
|
+
// High tolerance - matches "1/3" even for "3/10"
|
|
82
|
+
formatQuantity(0.3, { tolerance: 0.1 }); // "1/3"
|
|
83
|
+
// Way too high tolerance - incorrect result because thirds get evaluated before halves
|
|
84
|
+
formatQuantity(0.5, { tolerance: 0.5 }); // "1/3"
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### `fractionSlash`
|
|
88
|
+
|
|
89
|
+
| Type | Default |
|
|
90
|
+
| --------- | ------: |
|
|
91
|
+
| `boolean` | `false` |
|
|
92
|
+
|
|
93
|
+
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`.
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
formatQuantity(3.875, { fractionSlash: true }); // "3 7⁄8"
|
|
97
|
+
formatQuantity(3.875, { fractionSlash: true, vulgarFractions: true }); // "3⅞"
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## Other exports
|
|
101
|
+
|
|
102
|
+
| Name | Type | Description |
|
|
103
|
+
| ------------------------ | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
104
|
+
| `defaultTolerance` | `number` | `0.0075` |
|
|
105
|
+
| `fractionDecimalMatches` | `[number, VulgarFraction][]` | List of fractions and the decimal values that are close enough to match them (inputs are evaluated against the decimal values in the order of this array) |
|
|
106
|
+
| `vulgarToPlainMap` | `object` | Map of vulgar fraction characters to their equivalent ASCII strings (`"⅓"` to `"1/3"`, `"⅞"` to `"7/8"`, etc.) |
|
|
107
|
+
| `FormatQuantityOptions` | `interface` | Shape of `formatQuantity`'s second parameter, if not a `boolean` value |
|
|
108
|
+
| `VulgarFraction` | `type` | The set of [vulgar fraction characters](https://en.wikipedia.org/wiki/Number_Forms) (`"\u00bc"`, `"\u00bd"`, `"\u00be"`, and `"\u2150"` through `"\u215e"`) |
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { SimpleFraction, VulgarFraction } from './types';
|
|
2
|
+
export declare const defaultTolerance = 0.0075;
|
|
3
|
+
export declare const vulgarFractions: string[];
|
|
4
|
+
/**
|
|
5
|
+
* A map of vulgar or simple fractions to their traditional ASCII equivalents.
|
|
6
|
+
* Simple fractions map to themselves.
|
|
7
|
+
*/
|
|
8
|
+
export declare const vulgarToPlainMap: Record<string, SimpleFraction>;
|
|
9
|
+
export declare const fractionDecimalMatches: [
|
|
10
|
+
number,
|
|
11
|
+
VulgarFraction | SimpleFraction
|
|
12
|
+
][];
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
"use strict";
|
|
1
|
+
"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const f=.0075,B=["\xBC","\xBD","\xBE","\u2150","\u2151","\u2152","\u2153","\u2154","\u2155","\u2156","\u2157","\u2158","\u2159","\u215A","\u215B","\u215C","\u215D","\u215E"],r={"\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","1/16":"1/16","3/16":"3/16","5/16":"5/16","7/16":"7/16","9/16":"9/16","11/16":"11/16","13/16":"13/16","15/16":"15/16"},g=[[.33,"\u2153"],[.66,"\u2154"],[.2,"\u2155"],[.4,"\u2156"],[.6,"\u2157"],[.8,"\u2158"],[.166,"\u2159"],[.833,"\u215A"],[.143,"\u2150"],[.111,"\u2151"],[.1,"\u2152"],[.125,"\u215B"],[.25,"\xBC"],[.375,"\u215C"],[.5,"\xBD"],[.625,"\u215D"],[.75,"\xBE"],[.875,"\u215E"],[.0625,"1/16"],[.1875,"3/16"],[.3125,"5/16"],[.4375,"7/16"],[.5625,"9/16"],[.6875,"11/16"],[.8125,"13/16"],[.9375,"15/16"]],D=(t,u,a)=>Math.abs(t-u)<a,M=(t,u)=>u.vulgarFractions?t:u.fractionSlash?r[t].replace("/","\u2044"):r[t],d=(t,u)=>{var s;const a=typeof t=="string"?parseFloat(t):t;if(isNaN(a)||a===null)return null;if(a===0)return"";const n=Math.abs(a),e=Math.floor(n),o=`${a<0?"-":""}${e===0?"":`${e} `}`,c=n-e;if(c===0)return`${a}`;const l=typeof u=="boolean"?{vulgarFractions:u}:u!=null?u:{};for(const[v,x]of g)if(D(c,v,(s=l.tolerance)!=null?s:f)){const i=M(x,l);return`${B.includes(i)?o.trim():o}${i}`}return`${a}`};exports.default=d;exports.defaultTolerance=f;exports.formatQuantity=d;exports.fractionDecimalMatches=g;exports.vulgarFractions=B;exports.vulgarToPlainMap=r;
|
|
2
2
|
//# sourceMappingURL=format-quantity.cjs.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"format-quantity.cjs.js","sources":["../src/
|
|
1
|
+
{"version":3,"file":"format-quantity.cjs.js","sources":["../src/constants.ts","../src/formatQuantity.ts"],"sourcesContent":["import type { SimpleFraction, VulgarFraction } from './types';\n\nexport const defaultTolerance = 0.0075;\n\nexport const vulgarFractions = [\n '¼',\n '½',\n '¾',\n '⅐',\n '⅑',\n '⅒',\n '⅓',\n '⅔',\n '⅕',\n '⅖',\n '⅗',\n '⅘',\n '⅙',\n '⅚',\n '⅛',\n '⅜',\n '⅝',\n '⅞',\n];\n\n/**\n * A map of vulgar or simple fractions to their traditional ASCII equivalents.\n * Simple fractions map to themselves.\n */\nexport const vulgarToPlainMap: Record<string, 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 '1/16': '1/16',\n '3/16': '3/16',\n '5/16': '5/16',\n '7/16': '7/16',\n '9/16': '9/16',\n '11/16': '11/16',\n '13/16': '13/16',\n '15/16': '15/16',\n};\n\nexport const fractionDecimalMatches: [\n number,\n VulgarFraction | SimpleFraction\n][] = [\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];\n","import {\n defaultTolerance,\n fractionDecimalMatches,\n vulgarFractions,\n vulgarToPlainMap,\n} from './constants';\nimport type {\n FormatQuantity,\n FormatQuantityOptions,\n SimpleFraction,\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 fraction: VulgarFraction | SimpleFraction,\n opts: FormatQuantityOptions\n) =>\n opts.vulgarFractions\n ? fraction\n : opts.fractionSlash\n ? vulgarToPlainMap[fraction].replace('/', '⁄')\n : vulgarToPlainMap[fraction];\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 = (qty, options) => {\n const dQty = typeof qty === 'string' ? parseFloat(qty) : qty;\n\n // Return `null` if input is not number-like\n if (isNaN(dQty) || dQty === null) {\n return null;\n }\n\n // Return an empty string if the value is zero\n if (dQty === 0) {\n return '';\n }\n\n const dQtyAbs = Math.abs(dQty);\n const iFloor = Math.floor(dQtyAbs);\n const sFloor = `${dQty < 0 ? '-' : ''}${iFloor === 0 ? '' : `${iFloor} `}`;\n const dDecimal = dQtyAbs - iFloor;\n\n // For integers just return the given value as a string\n if (dDecimal === 0) {\n return `${dQty}`;\n }\n\n const opts: FormatQuantityOptions =\n typeof options === 'boolean' ? { vulgarFractions: options } : options ?? {};\n\n for (const [num, vf] of fractionDecimalMatches) {\n if (closeEnough(dDecimal, num, opts.tolerance ?? defaultTolerance)) {\n const fraction = getFraction(vf, opts);\n const int = vulgarFractions.includes(fraction) ? sFloor.trim() : sFloor;\n return `${int}${fraction}`;\n }\n }\n\n return `${dQty}`;\n};\n"],"names":["defaultTolerance","vulgarFractions","vulgarToPlainMap","fractionDecimalMatches","closeEnough","n1","n2","tolerance","getFraction","fraction","opts","formatQuantity","qty","options","dQty","dQtyAbs","iFloor","sFloor","dDecimal","num","vf","_a"],"mappings":"4GAEO,MAAMA,EAAmB,MAEnBC,EAAkB,CAC7B,OACA,OACA,OACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,QACF,EAMaC,EAAmD,CAC9D,OAAK,MACL,OAAK,MACL,OAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,OACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,OAAQ,OACR,OAAQ,OACR,OAAQ,OACR,OAAQ,OACR,OAAQ,OACR,QAAS,QACT,QAAS,QACT,QAAS,OACX,EAEaC,EAGP,CACJ,CAAC,IAAM,QAAG,EACV,CAAC,IAAM,QAAG,EACV,CAAC,GAAK,QAAG,EACT,CAAC,GAAK,QAAG,EACT,CAAC,GAAK,QAAG,EACT,CAAC,GAAK,QAAG,EACT,CAAC,KAAO,QAAG,EACX,CAAC,KAAO,QAAG,EACX,CAAC,KAAO,QAAG,EACX,CAAC,KAAO,QAAG,EACX,CAAC,GAAK,QAAG,EACT,CAAC,KAAO,QAAG,EACX,CAAC,IAAM,MAAG,EACV,CAAC,KAAO,QAAG,EACX,CAAC,GAAK,MAAG,EACT,CAAC,KAAO,QAAG,EACX,CAAC,IAAM,MAAG,EACV,CAAC,KAAO,QAAG,EACX,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,OAAO,EAChB,CAAC,MAAQ,OAAO,EAChB,CAAC,MAAQ,OAAO,CAClB,ECvEMC,EAAc,CAACC,EAAYC,EAAYC,IAC3C,KAAK,IAAIF,EAAKC,CAAE,EAAIC,EAEhBC,EAAc,CAClBC,EACAC,IAEAA,EAAK,gBACDD,EACAC,EAAK,cACLR,EAAiBO,GAAU,QAAQ,IAAK,QAAG,EAC3CP,EAAiBO,GASVE,EAAiC,CAACC,EAAKC,IAAY,OAC9D,MAAMC,EAAO,OAAOF,GAAQ,SAAW,WAAWA,CAAG,EAAIA,EAGzD,GAAI,MAAME,CAAI,GAAKA,IAAS,KACnB,OAAA,KAIT,GAAIA,IAAS,EACJ,MAAA,GAGH,MAAAC,EAAU,KAAK,IAAID,CAAI,EACvBE,EAAS,KAAK,MAAMD,CAAO,EAC3BE,EAAS,GAAGH,EAAO,EAAI,IAAM,KAAKE,IAAW,EAAI,GAAK,GAAGA,OACzDE,EAAWH,EAAUC,EAG3B,GAAIE,IAAa,EACf,MAAO,GAAGJ,IAGN,MAAAJ,EACJ,OAAOG,GAAY,UAAY,CAAE,gBAAiBA,CAAA,EAAYA,GAAA,KAAAA,EAAW,GAE3E,SAAW,CAACM,EAAKC,CAAE,IAAKjB,EACtB,GAAIC,EAAYc,EAAUC,GAAKE,EAAAX,EAAK,YAAL,KAAAW,EAAkBrB,CAAgB,EAAG,CAC5D,MAAAS,EAAWD,EAAYY,EAAIV,CAAI,EAErC,MAAO,GADKT,EAAgB,SAASQ,CAAQ,EAAIQ,EAAO,KAAS,EAAAA,IACjDR,GAClB,CAGF,MAAO,GAAGK,GACZ"}
|
|
@@ -1,51 +1,100 @@
|
|
|
1
|
-
const
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
1
|
+
const F = 75e-4, x = [
|
|
2
|
+
"\xBC",
|
|
3
|
+
"\xBD",
|
|
4
|
+
"\xBE",
|
|
5
|
+
"\u2150",
|
|
6
|
+
"\u2151",
|
|
7
|
+
"\u2152",
|
|
8
|
+
"\u2153",
|
|
9
|
+
"\u2154",
|
|
10
|
+
"\u2155",
|
|
11
|
+
"\u2156",
|
|
12
|
+
"\u2157",
|
|
13
|
+
"\u2158",
|
|
14
|
+
"\u2159",
|
|
15
|
+
"\u215A",
|
|
16
|
+
"\u215B",
|
|
17
|
+
"\u215C",
|
|
18
|
+
"\u215D",
|
|
19
|
+
"\u215E"
|
|
20
|
+
], f = {
|
|
21
|
+
"\xBC": "1/4",
|
|
22
|
+
"\xBD": "1/2",
|
|
23
|
+
"\xBE": "3/4",
|
|
24
|
+
"\u2150": "1/7",
|
|
25
|
+
"\u2151": "1/9",
|
|
26
|
+
"\u2152": "1/10",
|
|
27
|
+
"\u2153": "1/3",
|
|
28
|
+
"\u2154": "2/3",
|
|
29
|
+
"\u2155": "1/5",
|
|
30
|
+
"\u2156": "2/5",
|
|
31
|
+
"\u2157": "3/5",
|
|
32
|
+
"\u2158": "4/5",
|
|
33
|
+
"\u2159": "1/6",
|
|
34
|
+
"\u215A": "5/6",
|
|
35
|
+
"\u215B": "1/8",
|
|
36
|
+
"\u215C": "3/8",
|
|
37
|
+
"\u215D": "5/8",
|
|
38
|
+
"\u215E": "7/8",
|
|
39
|
+
"1/16": "1/16",
|
|
40
|
+
"3/16": "3/16",
|
|
41
|
+
"5/16": "5/16",
|
|
42
|
+
"7/16": "7/16",
|
|
43
|
+
"9/16": "9/16",
|
|
44
|
+
"11/16": "11/16",
|
|
45
|
+
"13/16": "13/16",
|
|
46
|
+
"15/16": "15/16"
|
|
47
|
+
}, D = [
|
|
48
|
+
[0.33, "\u2153"],
|
|
49
|
+
[0.66, "\u2154"],
|
|
50
|
+
[0.2, "\u2155"],
|
|
51
|
+
[0.4, "\u2156"],
|
|
52
|
+
[0.6, "\u2157"],
|
|
53
|
+
[0.8, "\u2158"],
|
|
54
|
+
[0.166, "\u2159"],
|
|
55
|
+
[0.833, "\u215A"],
|
|
56
|
+
[0.143, "\u2150"],
|
|
57
|
+
[0.111, "\u2151"],
|
|
58
|
+
[0.1, "\u2152"],
|
|
59
|
+
[0.125, "\u215B"],
|
|
60
|
+
[0.25, "\xBC"],
|
|
61
|
+
[0.375, "\u215C"],
|
|
62
|
+
[0.5, "\xBD"],
|
|
63
|
+
[0.625, "\u215D"],
|
|
64
|
+
[0.75, "\xBE"],
|
|
65
|
+
[0.875, "\u215E"],
|
|
66
|
+
[0.0625, "1/16"],
|
|
67
|
+
[0.1875, "3/16"],
|
|
68
|
+
[0.3125, "5/16"],
|
|
69
|
+
[0.4375, "7/16"],
|
|
70
|
+
[0.5625, "9/16"],
|
|
71
|
+
[0.6875, "11/16"],
|
|
72
|
+
[0.8125, "13/16"],
|
|
73
|
+
[0.9375, "15/16"]
|
|
74
|
+
], d = (t, u, a) => Math.abs(t - u) < a, g = (t, u) => u.vulgarFractions ? t : u.fractionSlash ? f[t].replace("/", "\u2044") : f[t], $ = (t, u) => {
|
|
75
|
+
var l;
|
|
76
|
+
const a = typeof t == "string" ? parseFloat(t) : t;
|
|
77
|
+
if (isNaN(a) || a === null)
|
|
5
78
|
return null;
|
|
6
|
-
|
|
7
|
-
if (dQty === 0) {
|
|
79
|
+
if (a === 0)
|
|
8
80
|
return "";
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
const
|
|
13
|
-
const
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
const sFloorFinal = useVulgarFractions ? sFloor.trim() : sFloor;
|
|
18
|
-
if (closeEnough(dDecimal, 0.33)) {
|
|
19
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u2153" : "1/3"}`;
|
|
20
|
-
} else if (closeEnough(dDecimal, 0.66)) {
|
|
21
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u2154" : "2/3"}`;
|
|
22
|
-
} else if (closeEnough(dDecimal, 0.2)) {
|
|
23
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u2155" : "1/5"}`;
|
|
24
|
-
} else if (closeEnough(dDecimal, 0.4)) {
|
|
25
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u2156" : "2/5"}`;
|
|
26
|
-
} else if (closeEnough(dDecimal, 0.6)) {
|
|
27
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u2157" : "3/5"}`;
|
|
28
|
-
} else if (closeEnough(dDecimal, 0.8)) {
|
|
29
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u2158" : "4/5"}`;
|
|
30
|
-
} else {
|
|
31
|
-
switch (dDecimal) {
|
|
32
|
-
case 0.125:
|
|
33
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u215B" : "1/8"}`;
|
|
34
|
-
case 0.25:
|
|
35
|
-
return `${sFloorFinal}${useVulgarFractions ? "\xBC" : "1/4"}`;
|
|
36
|
-
case 0.375:
|
|
37
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u215C" : "3/8"}`;
|
|
38
|
-
case 0.5:
|
|
39
|
-
return `${sFloorFinal}${useVulgarFractions ? "\xBD" : "1/2"}`;
|
|
40
|
-
case 0.625:
|
|
41
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u215D" : "5/8"}`;
|
|
42
|
-
case 0.75:
|
|
43
|
-
return `${sFloorFinal}${useVulgarFractions ? "\xBE" : "3/4"}`;
|
|
44
|
-
case 0.875:
|
|
45
|
-
return `${sFloorFinal}${useVulgarFractions ? "\u215E" : "7/8"}`;
|
|
81
|
+
const r = Math.abs(a), n = Math.floor(r), c = `${a < 0 ? "-" : ""}${n === 0 ? "" : `${n} `}`, o = r - n;
|
|
82
|
+
if (o === 0)
|
|
83
|
+
return `${a}`;
|
|
84
|
+
const e = typeof u == "boolean" ? { vulgarFractions: u } : u != null ? u : {};
|
|
85
|
+
for (const [i, B] of D)
|
|
86
|
+
if (d(o, i, (l = e.tolerance) != null ? l : 75e-4)) {
|
|
87
|
+
const s = g(B, e);
|
|
88
|
+
return `${x.includes(s) ? c.trim() : c}${s}`;
|
|
46
89
|
}
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
90
|
+
return `${a}`;
|
|
91
|
+
};
|
|
92
|
+
export {
|
|
93
|
+
$ as default,
|
|
94
|
+
F as defaultTolerance,
|
|
95
|
+
$ as formatQuantity,
|
|
96
|
+
D as fractionDecimalMatches,
|
|
97
|
+
x as vulgarFractions,
|
|
98
|
+
f as vulgarToPlainMap
|
|
99
|
+
};
|
|
51
100
|
//# sourceMappingURL=format-quantity.es.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"format-quantity.es.js","sources":["../src/
|
|
1
|
+
{"version":3,"file":"format-quantity.es.js","sources":["../src/constants.ts","../src/formatQuantity.ts"],"sourcesContent":["import type { SimpleFraction, VulgarFraction } from './types';\n\nexport const defaultTolerance = 0.0075;\n\nexport const vulgarFractions = [\n '¼',\n '½',\n '¾',\n '⅐',\n '⅑',\n '⅒',\n '⅓',\n '⅔',\n '⅕',\n '⅖',\n '⅗',\n '⅘',\n '⅙',\n '⅚',\n '⅛',\n '⅜',\n '⅝',\n '⅞',\n];\n\n/**\n * A map of vulgar or simple fractions to their traditional ASCII equivalents.\n * Simple fractions map to themselves.\n */\nexport const vulgarToPlainMap: Record<string, 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 '1/16': '1/16',\n '3/16': '3/16',\n '5/16': '5/16',\n '7/16': '7/16',\n '9/16': '9/16',\n '11/16': '11/16',\n '13/16': '13/16',\n '15/16': '15/16',\n};\n\nexport const fractionDecimalMatches: [\n number,\n VulgarFraction | SimpleFraction\n][] = [\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];\n","import {\n defaultTolerance,\n fractionDecimalMatches,\n vulgarFractions,\n vulgarToPlainMap,\n} from './constants';\nimport type {\n FormatQuantity,\n FormatQuantityOptions,\n SimpleFraction,\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 fraction: VulgarFraction | SimpleFraction,\n opts: FormatQuantityOptions\n) =>\n opts.vulgarFractions\n ? fraction\n : opts.fractionSlash\n ? vulgarToPlainMap[fraction].replace('/', '⁄')\n : vulgarToPlainMap[fraction];\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 = (qty, options) => {\n const dQty = typeof qty === 'string' ? parseFloat(qty) : qty;\n\n // Return `null` if input is not number-like\n if (isNaN(dQty) || dQty === null) {\n return null;\n }\n\n // Return an empty string if the value is zero\n if (dQty === 0) {\n return '';\n }\n\n const dQtyAbs = Math.abs(dQty);\n const iFloor = Math.floor(dQtyAbs);\n const sFloor = `${dQty < 0 ? '-' : ''}${iFloor === 0 ? '' : `${iFloor} `}`;\n const dDecimal = dQtyAbs - iFloor;\n\n // For integers just return the given value as a string\n if (dDecimal === 0) {\n return `${dQty}`;\n }\n\n const opts: FormatQuantityOptions =\n typeof options === 'boolean' ? { vulgarFractions: options } : options ?? {};\n\n for (const [num, vf] of fractionDecimalMatches) {\n if (closeEnough(dDecimal, num, opts.tolerance ?? defaultTolerance)) {\n const fraction = getFraction(vf, opts);\n const int = vulgarFractions.includes(fraction) ? sFloor.trim() : sFloor;\n return `${int}${fraction}`;\n }\n }\n\n return `${dQty}`;\n};\n"],"names":["defaultTolerance","vulgarFractions","vulgarToPlainMap","fractionDecimalMatches","closeEnough","n1","n2","tolerance","getFraction","fraction","opts","formatQuantity","qty","options","_a","dQty","dQtyAbs","iFloor","sFloor","dDecimal","num","vf"],"mappings":"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"}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
(function(
|
|
1
|
+
(function(u,a){typeof exports=="object"&&typeof module<"u"?a(exports):typeof define=="function"&&define.amd?define(["exports"],a):(u=typeof globalThis<"u"?globalThis:u||self,a(u.FormatQuantity={}))})(this,function(u){"use strict";const c=["\xBC","\xBD","\xBE","\u2150","\u2151","\u2152","\u2153","\u2154","\u2155","\u2156","\u2157","\u2158","\u2159","\u215A","\u215B","\u215C","\u215D","\u215E"],o={"\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","1/16":"1/16","3/16":"3/16","5/16":"5/16","7/16":"7/16","9/16":"9/16","11/16":"11/16","13/16":"13/16","15/16":"15/16"},r=[[.33,"\u2153"],[.66,"\u2154"],[.2,"\u2155"],[.4,"\u2156"],[.6,"\u2157"],[.8,"\u2158"],[.166,"\u2159"],[.833,"\u215A"],[.143,"\u2150"],[.111,"\u2151"],[.1,"\u2152"],[.125,"\u215B"],[.25,"\xBC"],[.375,"\u215C"],[.5,"\xBD"],[.625,"\u215D"],[.75,"\xBE"],[.875,"\u215E"],[.0625,"1/16"],[.1875,"3/16"],[.3125,"5/16"],[.4375,"7/16"],[.5625,"9/16"],[.6875,"11/16"],[.8125,"13/16"],[.9375,"15/16"]],h=(t,e,n)=>Math.abs(t-e)<n,v=(t,e)=>e.vulgarFractions?t:e.fractionSlash?o[t].replace("/","\u2044"):o[t],i=(t,e)=>{var g;const n=typeof t=="string"?parseFloat(t):t;if(isNaN(n)||n===null)return null;if(n===0)return"";const f=Math.abs(n),l=Math.floor(f),s=`${n<0?"-":""}${l===0?"":`${l} `}`,d=f-l;if(d===0)return`${n}`;const B=typeof e=="boolean"?{vulgarFractions:e}:e!=null?e:{};for(const[D,F]of r)if(h(d,D,(g=B.tolerance)!=null?g:.0075)){const m=v(F,B);return`${c.includes(m)?s.trim():s}${m}`}return`${n}`};u.default=i,u.defaultTolerance=.0075,u.formatQuantity=i,u.fractionDecimalMatches=r,u.vulgarFractions=c,u.vulgarToPlainMap=o,Object.defineProperties(u,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});
|
|
2
2
|
//# sourceMappingURL=format-quantity.umd.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"format-quantity.umd.js","sources":["../src/
|
|
1
|
+
{"version":3,"file":"format-quantity.umd.js","sources":["../src/constants.ts","../src/formatQuantity.ts"],"sourcesContent":["import type { SimpleFraction, VulgarFraction } from './types';\n\nexport const defaultTolerance = 0.0075;\n\nexport const vulgarFractions = [\n '¼',\n '½',\n '¾',\n '⅐',\n '⅑',\n '⅒',\n '⅓',\n '⅔',\n '⅕',\n '⅖',\n '⅗',\n '⅘',\n '⅙',\n '⅚',\n '⅛',\n '⅜',\n '⅝',\n '⅞',\n];\n\n/**\n * A map of vulgar or simple fractions to their traditional ASCII equivalents.\n * Simple fractions map to themselves.\n */\nexport const vulgarToPlainMap: Record<string, 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 '1/16': '1/16',\n '3/16': '3/16',\n '5/16': '5/16',\n '7/16': '7/16',\n '9/16': '9/16',\n '11/16': '11/16',\n '13/16': '13/16',\n '15/16': '15/16',\n};\n\nexport const fractionDecimalMatches: [\n number,\n VulgarFraction | SimpleFraction\n][] = [\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];\n","import {\n defaultTolerance,\n fractionDecimalMatches,\n vulgarFractions,\n vulgarToPlainMap,\n} from './constants';\nimport type {\n FormatQuantity,\n FormatQuantityOptions,\n SimpleFraction,\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 fraction: VulgarFraction | SimpleFraction,\n opts: FormatQuantityOptions\n) =>\n opts.vulgarFractions\n ? fraction\n : opts.fractionSlash\n ? vulgarToPlainMap[fraction].replace('/', '⁄')\n : vulgarToPlainMap[fraction];\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 = (qty, options) => {\n const dQty = typeof qty === 'string' ? parseFloat(qty) : qty;\n\n // Return `null` if input is not number-like\n if (isNaN(dQty) || dQty === null) {\n return null;\n }\n\n // Return an empty string if the value is zero\n if (dQty === 0) {\n return '';\n }\n\n const dQtyAbs = Math.abs(dQty);\n const iFloor = Math.floor(dQtyAbs);\n const sFloor = `${dQty < 0 ? '-' : ''}${iFloor === 0 ? '' : `${iFloor} `}`;\n const dDecimal = dQtyAbs - iFloor;\n\n // For integers just return the given value as a string\n if (dDecimal === 0) {\n return `${dQty}`;\n }\n\n const opts: FormatQuantityOptions =\n typeof options === 'boolean' ? { vulgarFractions: options } : options ?? {};\n\n for (const [num, vf] of fractionDecimalMatches) {\n if (closeEnough(dDecimal, num, opts.tolerance ?? defaultTolerance)) {\n const fraction = getFraction(vf, opts);\n const int = vulgarFractions.includes(fraction) ? sFloor.trim() : sFloor;\n return `${int}${fraction}`;\n }\n }\n\n return `${dQty}`;\n};\n"],"names":["vulgarFractions","vulgarToPlainMap","fractionDecimalMatches","closeEnough","n1","n2","tolerance","getFraction","fraction","opts","formatQuantity","qty","options","dQty","dQtyAbs","iFloor","sFloor","dDecimal","num","vf","_a"],"mappings":"sOAIO,MAAMA,EAAkB,CAC7B,OACA,OACA,OACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,SACA,QACF,EAMaC,EAAmD,CAC9D,OAAK,MACL,OAAK,MACL,OAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,OACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,SAAK,MACL,OAAQ,OACR,OAAQ,OACR,OAAQ,OACR,OAAQ,OACR,OAAQ,OACR,QAAS,QACT,QAAS,QACT,QAAS,OACX,EAEaC,EAGP,CACJ,CAAC,IAAM,QAAG,EACV,CAAC,IAAM,QAAG,EACV,CAAC,GAAK,QAAG,EACT,CAAC,GAAK,QAAG,EACT,CAAC,GAAK,QAAG,EACT,CAAC,GAAK,QAAG,EACT,CAAC,KAAO,QAAG,EACX,CAAC,KAAO,QAAG,EACX,CAAC,KAAO,QAAG,EACX,CAAC,KAAO,QAAG,EACX,CAAC,GAAK,QAAG,EACT,CAAC,KAAO,QAAG,EACX,CAAC,IAAM,MAAG,EACV,CAAC,KAAO,QAAG,EACX,CAAC,GAAK,MAAG,EACT,CAAC,KAAO,QAAG,EACX,CAAC,IAAM,MAAG,EACV,CAAC,KAAO,QAAG,EACX,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,MAAM,EACf,CAAC,MAAQ,OAAO,EAChB,CAAC,MAAQ,OAAO,EAChB,CAAC,MAAQ,OAAO,CAClB,ECvEMC,EAAc,CAACC,EAAYC,EAAYC,IAC3C,KAAK,IAAIF,EAAKC,CAAE,EAAIC,EAEhBC,EAAc,CAClBC,EACAC,IAEAA,EAAK,gBACDD,EACAC,EAAK,cACLR,EAAiBO,GAAU,QAAQ,IAAK,QAAG,EAC3CP,EAAiBO,GASVE,EAAiC,CAACC,EAAKC,IAAY,OAC9D,MAAMC,EAAO,OAAOF,GAAQ,SAAW,WAAWA,CAAG,EAAIA,EAGzD,GAAI,MAAME,CAAI,GAAKA,IAAS,KACnB,OAAA,KAIT,GAAIA,IAAS,EACJ,MAAA,GAGH,MAAAC,EAAU,KAAK,IAAID,CAAI,EACvBE,EAAS,KAAK,MAAMD,CAAO,EAC3BE,EAAS,GAAGH,EAAO,EAAI,IAAM,KAAKE,IAAW,EAAI,GAAK,GAAGA,OACzDE,EAAWH,EAAUC,EAG3B,GAAIE,IAAa,EACf,MAAO,GAAGJ,IAGN,MAAAJ,EACJ,OAAOG,GAAY,UAAY,CAAE,gBAAiBA,CAAA,EAAYA,GAAA,KAAAA,EAAW,GAE3E,SAAW,CAACM,EAAKC,CAAE,IAAKjB,EACtB,GAAIC,EAAYc,EAAUC,GAAKE,EAAAX,EAAK,YAAL,KAAAW,EAAkB,KAAgB,EAAG,CAC5D,MAAAZ,EAAWD,EAAYY,EAAIV,CAAI,EAErC,MAAO,GADKT,EAAgB,SAASQ,CAAQ,EAAIQ,EAAO,KAAS,EAAAA,IACjDR,GAClB,CAGF,MAAO,GAAGK,GACZ"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { FormatQuantity } from './types';
|
|
2
|
+
/**
|
|
3
|
+
* Formats a number (or string that appears to be a number)
|
|
4
|
+
* as one would see it written in imperial measurements, e.g.
|
|
5
|
+
* "1 1/2" instead of "1.5". To use vulgar fraction characters
|
|
6
|
+
* like "½", pass `true` as the second argument. For other options
|
|
7
|
+
* see the [documentation](https://jakeboone02.github.io/format-quantity/).
|
|
8
|
+
*/
|
|
9
|
+
export declare const formatQuantity: FormatQuantity;
|
package/dist/index.d.ts
CHANGED
|
@@ -1,8 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
|
|
5
|
-
* pass `true` as the second argument.
|
|
6
|
-
*/
|
|
7
|
-
declare function formatQuantity(qty: string | number, useVulgarFractions?: boolean): string | null;
|
|
1
|
+
import { formatQuantity } from './formatQuantity';
|
|
2
|
+
export * from './constants';
|
|
3
|
+
export * from './types';
|
|
4
|
+
export { formatQuantity };
|
|
8
5
|
export default formatQuantity;
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
export interface FormatQuantityOptions {
|
|
2
|
+
/**
|
|
3
|
+
* Output vulgar fractions, like "½" instead of "1/2", when appropriate.
|
|
4
|
+
* Overrides the `fractionSlash` option.
|
|
5
|
+
*/
|
|
6
|
+
vulgarFractions?: boolean;
|
|
7
|
+
/**
|
|
8
|
+
* Amount by which a number can deviate from the calculated quotient to be
|
|
9
|
+
* considered a match. For example, 0.66 is close enough to 2 ÷ 3 (which
|
|
10
|
+
* is 0.66666... repeating) to be considered equivalent so the function
|
|
11
|
+
* will return "2/3". The smaller this number, the higher the likelihood that
|
|
12
|
+
* the function will return a decimal instead of a fraction or mixed number.
|
|
13
|
+
*
|
|
14
|
+
* @default 0.009
|
|
15
|
+
*/
|
|
16
|
+
tolerance?: number;
|
|
17
|
+
/**
|
|
18
|
+
* Output the fraction slash character (⁄) instead of the "solidus"
|
|
19
|
+
* slash (/) for fractions. Results appear like "1⁄2" instead of "1/2".
|
|
20
|
+
* Overridden by the `vulgarFractions` option.
|
|
21
|
+
*/
|
|
22
|
+
fractionSlash?: boolean;
|
|
23
|
+
}
|
|
24
|
+
export declare type FormatQuantity = (qty: string | number, options?: boolean | FormatQuantityOptions) => string | null;
|
|
25
|
+
declare type NumChar = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
|
|
26
|
+
export declare type SimpleFraction = `${NumChar}/${NumChar}` | `${NumChar}/${NumChar}${NumChar}` | `${NumChar}${NumChar}/${NumChar}${NumChar}`;
|
|
27
|
+
export declare type VulgarFraction = '¼' | '½' | '¾' | '⅐' | '⅑' | '⅒' | '⅓' | '⅔' | '⅕' | '⅖' | '⅗' | '⅘' | '⅙' | '⅚' | '⅛' | '⅜' | '⅝' | '⅞';
|
|
28
|
+
export declare type FormatQuantityTests = [
|
|
29
|
+
string,
|
|
30
|
+
([Parameters<FormatQuantity>[0], ReturnType<FormatQuantity>] | [
|
|
31
|
+
Parameters<FormatQuantity>[0],
|
|
32
|
+
ReturnType<FormatQuantity>,
|
|
33
|
+
Parameters<FormatQuantity>[1]
|
|
34
|
+
])[]
|
|
35
|
+
][];
|
|
36
|
+
export {};
|
package/package.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "
|
|
2
|
+
"version": "2.0.0",
|
|
3
3
|
"name": "format-quantity",
|
|
4
4
|
"author": "Jake Boone <jakeboone02@gmail.com>",
|
|
5
5
|
"description": "Number formatter for imperial measurements with support for vulgar fractions",
|
|
@@ -17,7 +17,9 @@
|
|
|
17
17
|
"quantity",
|
|
18
18
|
"number",
|
|
19
19
|
"format",
|
|
20
|
-
"string"
|
|
20
|
+
"string",
|
|
21
|
+
"fractions",
|
|
22
|
+
"imperial"
|
|
21
23
|
],
|
|
22
24
|
"bugs": {
|
|
23
25
|
"url": "https://github.com/jakeboone02/format-quantity/issues"
|
|
@@ -27,25 +29,29 @@
|
|
|
27
29
|
"type": "git",
|
|
28
30
|
"url": "https://github.com/jakeboone02/format-quantity"
|
|
29
31
|
},
|
|
30
|
-
"engines": {
|
|
31
|
-
"node": ">=10"
|
|
32
|
-
},
|
|
33
32
|
"scripts": {
|
|
34
33
|
"start": "vite",
|
|
35
|
-
"build": "
|
|
34
|
+
"build": "yarn build:main && yarn build:types",
|
|
35
|
+
"build:main": "vite build",
|
|
36
|
+
"build:types": "tsc --project ./tsconfig.build.json",
|
|
36
37
|
"test": "jest --coverage",
|
|
38
|
+
"watch": "jest --watch",
|
|
37
39
|
"publish:npm": "np"
|
|
38
40
|
},
|
|
39
41
|
"devDependencies": {
|
|
40
|
-
"@babel/core": "^7.
|
|
41
|
-
"@babel/preset-env": "^7.
|
|
42
|
-
"@babel/preset-typescript": "^7.
|
|
43
|
-
"@types/jest": "^
|
|
44
|
-
"gh-pages": "^
|
|
45
|
-
"jest": "^
|
|
46
|
-
"np": "^7.
|
|
47
|
-
"prettier": "^2.
|
|
48
|
-
"typescript": "^4.
|
|
49
|
-
"vite": "^
|
|
42
|
+
"@babel/core": "^7.19.1",
|
|
43
|
+
"@babel/preset-env": "^7.19.1",
|
|
44
|
+
"@babel/preset-typescript": "^7.18.6",
|
|
45
|
+
"@types/jest": "^29.0.2",
|
|
46
|
+
"gh-pages": "^4.0.0",
|
|
47
|
+
"jest": "^29.0.3",
|
|
48
|
+
"np": "^7.6.2",
|
|
49
|
+
"prettier": "^2.7.1",
|
|
50
|
+
"typescript": "^4.8.3",
|
|
51
|
+
"vite": "^3.1.0"
|
|
52
|
+
},
|
|
53
|
+
"packageManager": "yarn@3.2.3",
|
|
54
|
+
"publishConfig": {
|
|
55
|
+
"registry": "https://registry.npmjs.org"
|
|
50
56
|
}
|
|
51
57
|
}
|
package/CHANGELOG.md
DELETED
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
## 1.0.1 (2021-02-15)
|
|
2
|
-
|
|
3
|
-
- Added description to package.json
|
|
4
|
-
|
|
5
|
-
## 1.0.0 (2021-02-11)
|
|
6
|
-
|
|
7
|
-
- New build system ([tsdx](https://tsdx.io/))
|
|
8
|
-
|
|
9
|
-
## 0.6.0 (2019-08-31)
|
|
10
|
-
|
|
11
|
-
- Added ability to produce unicode vulgar fractions (pass `true` as the second argument)
|
|
12
|
-
|
|
13
|
-
## 0.5.0 (2019-08-24)
|
|
14
|
-
|
|
15
|
-
### Breaking change
|
|
16
|
-
|
|
17
|
-
- Invalid inputs now return `null` instead of `"-1"`
|
|
18
|
-
|
|
19
|
-
### Bug fixes
|
|
20
|
-
|
|
21
|
-
- Handles negative numbers properly
|
|
22
|
-
|
|
23
|
-
## 0.4.2 (2019-08-23)
|
|
24
|
-
|
|
25
|
-
- Rewritten with TypeScript
|
|
26
|
-
|
|
27
|
-
## 0.3.2 (2018-09-21)
|
|
28
|
-
|
|
29
|
-
## 0.3.1 (2015-07-16)
|
|
30
|
-
|
|
31
|
-
## 0.3.0 (2015-07-16)
|
|
32
|
-
|
|
33
|
-
## 0.1.0 (2015-03-18)
|