@ni/unit-format 0.0.1

package/README.md

@@ -0,0 +1,72 @@
+<div align="center">
+    <p><b>ni | unit format</b></p>
+</div>
+
+# Unit Format
+
+[![NPM Version](https://img.shields.io/npm/v/@ni/unit-format.svg)](https://www.npmjs.com/package/@ni/unit-format)
+
+The `@ni/unit-format` library provides a way to format numbers with units. The library:
+
+- Provides opinionated number formatters that are well-suited for:
+    - numbers that can appear in large ranges (very small or very large).
+    - numbers that are always decimal with a configurable number of digits.
+- Can scale number values on a unit scale, for example, a metric scale of voltage.
+- Provides internationalized number formatting and unit strings.
+
+The library is intended to align well with the [`Intl.NumberFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat) API to make it relatively straightforward to swap in.
+
+## Getting Started
+
+Choose a `UnitFormat` and create an instance with an optional `UnitScale` reference:
+
+```ts
+const formatter = new UnitFormatDefault('en', {
+    unitScale: unitScaleByte
+});
+console.log(formatter.format(1000));
+// Output: '1 kB'
+```
+
+## Concepts
+
+### UnitFormat
+
+There are multiple `UnitFormat`s that represent different configurations for formatting numbers. These represent wrappers around `Intl.NumberFormat` with opinionated configurations.
+
+For example, the `UnitFormatDefault` will represent "very large" and "very small" numbers with an exponential notation and numbers between those ranges as decimal. The different `UnitFormat`s take an optional `unitScale` that provides units and automatic conversions of numbers for that unit scale.
+
+### UnitScale
+
+A `UnitScale` represents a collection of `ScaledUnits` where a scale factor is used to define each scaled unit. Each `UnitScale` must have a "base" `ScaledUnit` with scale factor 1. For example, a byte `UnitScale` may contain:
+
+- a `ScaledUnit` of scale factor 1 representing bytes (the base `ScaledUnit`)
+- a `ScaledUnit` of scale factor 1000 representing kilobytes.
+
+Each `ScaledUnit` represents a scale factor and a factory function for creating a `ScaledUnitFormat` instance. This system is used so that the top-level `UnitFormat` objects can pass configuration settings to individual `ScaledUnitFormat` instances.
+
+## ScaledUnitFormat
+
+A `ScaledUnitFormat` is an object for formatting a particular `ScaledUnit` on the `UnitScale`.
+
+There are two main types of `ScaledUnitFormat`s:
+
+- `ScaledUnitFormatIntlNumberFormat` which are scaled units can be translated by [`Intl.NumberFormat`](https://tc39.es/ecma402/#table-sanctioned-single-unit-identifiers).
+- `ScaledUnitFormatManuallyTranslated` which are scaled units manually translated for a set of supported languages via `UnitTranslation` string collections.
+
+The different `ScaledUnitFormat` objects have a static function to assist with their factory creation, for example:
+
+```ts
+new ScaledUnit(
+    10 ** 3,
+    ScaledUnitFormatIntlNumberFormat.createFactory({
+        style: 'unit',
+        unit: 'kilobyte',
+        unitDisplay: 'short'
+    })
+),
+```
+
+## Contributing
+
+See `Getting Started` in [`CONTRIBUTING.md`](/packages/unit-format/CONTRIBUTING.md#getting-started).

package/dist/esm/decimal/index.d.ts

@@ -0,0 +1,19 @@
+import { UnitFormat, type UnitFormatOptions } from '../index.js';
+interface UnitFormatDecimalOptions extends UnitFormatOptions {
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}
+type UnitFormatDecimalResolvedOptions = Required<UnitFormatDecimalOptions>;
+/**
+ * Format for decimal numbers with units.
+ */
+export declare class UnitFormatDecimal extends UnitFormat<UnitFormatDecimalOptions> {
+    private readonly unitScale;
+    private readonly minimumFractionDigits;
+    private readonly maximumFractionDigits;
+    private readonly scaledUnitFormatters;
+    constructor(locale: string, { minimumFractionDigits, maximumFractionDigits, unitScale }?: UnitFormatDecimalOptions);
+    resolvedOptions(): UnitFormatDecimalResolvedOptions;
+    protected tryFormat(number: number): string;
+}
+export {};

package/dist/esm/decimal/index.js

@@ -0,0 +1,46 @@
+import { UnitFormat } from '../index.js';
+import { unitScalePassthrough } from '../unit-scale/passthrough/index.js';
+/**
+ * Format for decimal numbers with units.
+ */
+export class UnitFormatDecimal extends UnitFormat {
+    constructor(locale, { minimumFractionDigits = 0, maximumFractionDigits = Math.max(3, minimumFractionDigits), unitScale = unitScalePassthrough } = {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 3,
+        unitScale: unitScalePassthrough
+    }) {
+        super();
+        this.scaledUnitFormatters = new Map();
+        // Workaround to avoid a ts error about signDisplay not accepting the value 'negative'.
+        // It has been supported by browsers since 8/23, but TypeScript still hasn't
+        // added it to the type definitions. See https://github.com/microsoft/TypeScript/issues/56269
+        const signDisplay = 'negative';
+        const intlNumberFormatOptions = {
+            maximumFractionDigits,
+            minimumFractionDigits,
+            signDisplay
+        };
+        for (const scaledUnit of unitScale.supportedScaledUnits) {
+            this.scaledUnitFormatters.set(scaledUnit.scaleFactor, scaledUnit.scaledUnitFormatFactory({
+                locale,
+                intlNumberFormatOptions
+            }));
+        }
+        this.unitScale = unitScale;
+        this.minimumFractionDigits = minimumFractionDigits;
+        this.maximumFractionDigits = maximumFractionDigits;
+    }
+    resolvedOptions() {
+        return {
+            unitScale: this.unitScale,
+            maximumFractionDigits: this.maximumFractionDigits,
+            minimumFractionDigits: this.minimumFractionDigits
+        };
+    }
+    tryFormat(number) {
+        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(number);
+        const scaledUnitFormatter = this.scaledUnitFormatters.get(scaledUnit.scaleFactor);
+        return scaledUnitFormatter.format(scaledValue);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/decimal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decimal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAQ1E;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAoC;IAOvE,YACI,MAAc,EACd,EACI,qBAAqB,GAAG,CAAC,EACzB,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,EAC1D,SAAS,GAAG,oBAAoB,KACN;QAC1B,qBAAqB,EAAE,CAAC;QACxB,qBAAqB,EAAE,CAAC;QACxB,SAAS,EAAE,oBAAoB;KAClC;QAED,KAAK,EAAE,CAAC;QAdK,yBAAoB,GAAG,IAAI,GAAG,EAA4B,CAAC;QAexE,uFAAuF;QACvF,4EAA4E;QAC5E,6FAA6F;QAC7F,MAAM,WAAW,GAAG,UAAqD,CAAC;QAC1E,MAAM,uBAAuB,GAAG;YAC5B,qBAAqB;YACrB,qBAAqB;YACrB,WAAW;SACd,CAAC;QACF,KAAK,MAAM,UAAU,IAAI,SAAS,CAAC,oBAAoB,EAAE,CAAC;YACtD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CACzB,UAAU,CAAC,WAAW,EACtB,UAAU,CAAC,uBAAuB,CAAC;gBAC/B,MAAM;gBACN,uBAAuB;aAC1B,CAAC,CACL,CAAC;QACN,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,qBAAqB,GAAG,qBAAqB,CAAC;QACnD,IAAI,CAAC,qBAAqB,GAAG,qBAAqB,CAAC;IACvD,CAAC;IAEe,eAAe;QAC3B,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;SACpD,CAAC;IACN,CAAC;IAES,SAAS,CAAC,MAAc;QAC9B,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACvE,MAAM,mBAAmB,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CACrD,UAAU,CAAC,WAAW,CACxB,CAAC;QACH,OAAO,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;CACJ","sourcesContent":["import { UnitFormat, type UnitFormatOptions } from '../index.js';\r\nimport type { ScaledUnitFormat } from '../scaled-unit-format/index.js';\r\nimport type { UnitScale } from '../unit-scale/index.js';\r\nimport { unitScalePassthrough } from '../unit-scale/passthrough/index.js';\r\n\r\ninterface UnitFormatDecimalOptions extends UnitFormatOptions {\r\n    minimumFractionDigits?: number;\r\n    maximumFractionDigits?: number;\r\n}\r\ntype UnitFormatDecimalResolvedOptions = Required<UnitFormatDecimalOptions>;\r\n\r\n/**\r\n * Format for decimal numbers with units.\r\n */\r\nexport class UnitFormatDecimal extends UnitFormat<UnitFormatDecimalOptions> {\r\n    private readonly unitScale: UnitScale;\r\n    private readonly minimumFractionDigits: number;\r\n    private readonly maximumFractionDigits: number;\r\n\r\n    private readonly scaledUnitFormatters = new Map<number, ScaledUnitFormat>();\r\n\r\n    public constructor(\r\n        locale: string,\r\n        {\r\n            minimumFractionDigits = 0,\r\n            maximumFractionDigits = Math.max(3, minimumFractionDigits),\r\n            unitScale = unitScalePassthrough\r\n        }: UnitFormatDecimalOptions = {\r\n            minimumFractionDigits: 0,\r\n            maximumFractionDigits: 3,\r\n            unitScale: unitScalePassthrough\r\n        }\r\n    ) {\r\n        super();\r\n        // Workaround to avoid a ts error about signDisplay not accepting the value 'negative'.\r\n        // It has been supported by browsers since 8/23, but TypeScript still hasn't\r\n        // added it to the type definitions. See https://github.com/microsoft/TypeScript/issues/56269\r\n        const signDisplay = 'negative' as Intl.NumberFormatOptions['signDisplay'];\r\n        const intlNumberFormatOptions = {\r\n            maximumFractionDigits,\r\n            minimumFractionDigits,\r\n            signDisplay\r\n        };\r\n        for (const scaledUnit of unitScale.supportedScaledUnits) {\r\n            this.scaledUnitFormatters.set(\r\n                scaledUnit.scaleFactor,\r\n                scaledUnit.scaledUnitFormatFactory({\r\n                    locale,\r\n                    intlNumberFormatOptions\r\n                })\r\n            );\r\n        }\r\n        this.unitScale = unitScale;\r\n        this.minimumFractionDigits = minimumFractionDigits;\r\n        this.maximumFractionDigits = maximumFractionDigits;\r\n    }\r\n\r\n    public override resolvedOptions(): UnitFormatDecimalResolvedOptions {\r\n        return {\r\n            unitScale: this.unitScale,\r\n            maximumFractionDigits: this.maximumFractionDigits,\r\n            minimumFractionDigits: this.minimumFractionDigits\r\n        };\r\n    }\r\n\r\n    protected tryFormat(number: number): string {\r\n        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(number);\r\n        const scaledUnitFormatter = this.scaledUnitFormatters.get(\r\n            scaledUnit.scaleFactor\r\n        )!;\r\n        return scaledUnitFormatter.format(scaledValue);\r\n    }\r\n}\r\n"]}

package/dist/esm/default/index.d.ts

@@ -0,0 +1,22 @@
+import { UnitFormat, type UnitFormatOptions } from '../index.js';
+interface UnitFormatDefaultOptions extends UnitFormatOptions {
+}
+type UnitFormatDefaultResolvedOptions = Required<UnitFormatDefaultOptions>;
+/**
+ * Format for numbers with units to show in a tabular form.
+ * Large and tiny numbers are shown exponentially and the rest as decimal.
+ */
+export declare class UnitFormatDefault extends UnitFormat {
+    private static readonly maximumDigits;
+    private static readonly exponentialLowerBound;
+    private static readonly exponentialUpperBound;
+    private readonly unitScale;
+    private readonly defaultIntlNumberFormatOptions;
+    private readonly defaultScaledUnitFormatters;
+    private readonly exponentialIntlNumberFormatOptions;
+    private readonly exponentialScaledUnitFormatter;
+    constructor(locale: string, { unitScale }?: UnitFormatDefaultOptions);
+    resolvedOptions(): UnitFormatDefaultResolvedOptions;
+    protected tryFormat(number: number): string;
+}
+export {};

package/dist/esm/default/index.js

@@ -0,0 +1,70 @@
+import { UnitFormat } from '../index.js';
+import { unitScalePassthrough } from '../unit-scale/passthrough/index.js';
+// Workaround to avoid ts errors about signDisplay not accepting the value 'negative'.
+// It has been supported by browsers since 8/23, but TypeScript still hasn't
+// added it to the type definitions. See https://github.com/microsoft/TypeScript/issues/56269
+const signDisplay = 'negative';
+/**
+ * Format for numbers with units to show in a tabular form.
+ * Large and tiny numbers are shown exponentially and the rest as decimal.
+ */
+export class UnitFormatDefault extends UnitFormat {
+    constructor(locale, { unitScale = unitScalePassthrough } = {
+        unitScale: unitScalePassthrough
+    }) {
+        super();
+        // Format options to use by default. It renders the number with a maximum of 6 signficant digits (including zero before decimal point).
+        this.defaultIntlNumberFormatOptions = {
+            maximumSignificantDigits: UnitFormatDefault.maximumDigits,
+            maximumFractionDigits: UnitFormatDefault.maximumDigits - 1,
+            roundingPriority: 'lessPrecision',
+            signDisplay
+        };
+        this.defaultScaledUnitFormatters = new Map();
+        // Format options for numbers that should be displayed in exponential notation. This should be used
+        // for numbers with magintudes over 'exponentialUpperBound' or under 'exponentialLowerBound'.
+        this.exponentialIntlNumberFormatOptions = {
+            maximumSignificantDigits: UnitFormatDefault.maximumDigits,
+            notation: 'scientific',
+            signDisplay
+        };
+        for (const unit of unitScale.supportedScaledUnits) {
+            this.defaultScaledUnitFormatters.set(unit.scaleFactor, unit.scaledUnitFormatFactory({
+                locale,
+                intlNumberFormatOptions: this.defaultIntlNumberFormatOptions
+            }));
+        }
+        this.exponentialScaledUnitFormatter = unitScale.baseScaledUnit.scaledUnitFormatFactory({
+            locale,
+            intlNumberFormatOptions: this.exponentialIntlNumberFormatOptions
+        });
+        this.unitScale = unitScale;
+    }
+    resolvedOptions() {
+        return {
+            unitScale: this.unitScale
+        };
+    }
+    tryFormat(number) {
+        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(number);
+        const absoluteValue = Math.abs(scaledValue);
+        const useExponential = absoluteValue !== 0
+            && (absoluteValue >= UnitFormatDefault.exponentialUpperBound
+                || absoluteValue < UnitFormatDefault.exponentialLowerBound);
+        return useExponential
+            ? this.exponentialScaledUnitFormatter.format(number)
+            : this.defaultScaledUnitFormatters
+                .get(scaledUnit.scaleFactor)
+                .format(scaledValue);
+    }
+}
+// The maximum number of digits that should be rendered for any given value.
+UnitFormatDefault.maximumDigits = 6;
+// Use exponential notation for numbers that will be rendered with 3 leading 0s or more.
+// Because a maximum of 6 digits are rendered, showing more than 3 leading 0s is not ideal
+// because then at least half of the displayed digits will be leading 0s.
+UnitFormatDefault.exponentialLowerBound = 0.000995;
+// Use exponential formatting for numbers whose magnitude cannot otherwise be displayed
+// with 6 digits or less.
+UnitFormatDefault.exponentialUpperBound = 999999.5;
+//# sourceMappingURL=index.js.map

package/dist/esm/default/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/default/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,sFAAsF;AACtF,4EAA4E;AAC5E,6FAA6F;AAC7F,MAAM,WAAW,GAAG,UAAqD,CAAC;AAO1E;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAqC7C,YACI,MAAc,EACd,EAAE,SAAS,GAAG,oBAAoB,KAA+B;QAC7D,SAAS,EAAE,oBAAoB;KAClC;QAED,KAAK,EAAE,CAAC;QA7BZ,uIAAuI;QACtH,mCAA8B,GAA6B;YACxE,wBAAwB,EAAE,iBAAiB,CAAC,aAAa;YACzD,qBAAqB,EAAE,iBAAiB,CAAC,aAAa,GAAG,CAAC;YAC1D,gBAAgB,EAAE,eAAe;YACjC,WAAW;SACd,CAAC;QAEe,gCAA2B,GAAG,IAAI,GAAG,EAGnD,CAAC;QAEJ,mGAAmG;QACnG,6FAA6F;QAC5E,uCAAkC,GAA6B;YAC5E,wBAAwB,EAAE,iBAAiB,CAAC,aAAa;YACzD,QAAQ,EAAE,YAAY;YACtB,WAAW;SACd,CAAC;QAWE,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,oBAAoB,EAAE,CAAC;YAChD,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAChC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,uBAAuB,CAAC;gBACzB,MAAM;gBACN,uBAAuB,EAAE,IAAI,CAAC,8BAA8B;aAC/D,CAAC,CACL,CAAC;QACN,CAAC;QACD,IAAI,CAAC,8BAA8B,GAAG,SAAS,CAAC,cAAc,CAAC,uBAAuB,CAAC;YACnF,MAAM;YACN,uBAAuB,EAAE,IAAI,CAAC,kCAAkC;SACnE,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAEe,eAAe;QAC3B,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC;IACN,CAAC;IAES,SAAS,CAAC,MAAc;QAC9B,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEvE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,cAAc,GAAG,aAAa,KAAK,CAAC;eACnC,CAAC,aAAa,IAAI,iBAAiB,CAAC,qBAAqB;mBACrD,aAAa,GAAG,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;QACpE,OAAO,cAAc;YACjB,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,MAAM,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,2BAA2B;iBAC7B,GAAG,CAAC,UAAU,CAAC,WAAW,CAAE;iBAC5B,MAAM,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;;AA7ED,4EAA4E;AACpD,+BAAa,GAAG,CAAC,AAAJ,CAAK;AAE1C,wFAAwF;AACxF,0FAA0F;AAC1F,yEAAyE;AACjD,uCAAqB,GAAG,QAAQ,AAAX,CAAY;AAEzD,uFAAuF;AACvF,yBAAyB;AACD,uCAAqB,GAAG,QAAQ,AAAX,CAAY","sourcesContent":["import { UnitFormat, type UnitFormatOptions } from '../index.js';\r\nimport type { ScaledUnitFormat } from '../scaled-unit-format/index.js';\r\nimport type { UnitScale } from '../unit-scale/index.js';\r\nimport { unitScalePassthrough } from '../unit-scale/passthrough/index.js';\r\n\r\n// Workaround to avoid ts errors about signDisplay not accepting the value 'negative'.\r\n// It has been supported by browsers since 8/23, but TypeScript still hasn't\r\n// added it to the type definitions. See https://github.com/microsoft/TypeScript/issues/56269\r\nconst signDisplay = 'negative' as Intl.NumberFormatOptions['signDisplay'];\r\n\r\n// Allow consistent pattern for defining Options and ResolvedOptions\r\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\r\ninterface UnitFormatDefaultOptions extends UnitFormatOptions {}\r\ntype UnitFormatDefaultResolvedOptions = Required<UnitFormatDefaultOptions>;\r\n\r\n/**\r\n * Format for numbers with units to show in a tabular form.\r\n * Large and tiny numbers are shown exponentially and the rest as decimal.\r\n */\r\nexport class UnitFormatDefault extends UnitFormat {\r\n    // The maximum number of digits that should be rendered for any given value.\r\n    private static readonly maximumDigits = 6;\r\n\r\n    // Use exponential notation for numbers that will be rendered with 3 leading 0s or more.\r\n    // Because a maximum of 6 digits are rendered, showing more than 3 leading 0s is not ideal\r\n    // because then at least half of the displayed digits will be leading 0s.\r\n    private static readonly exponentialLowerBound = 0.000995;\r\n\r\n    // Use exponential formatting for numbers whose magnitude cannot otherwise be displayed\r\n    // with 6 digits or less.\r\n    private static readonly exponentialUpperBound = 999999.5;\r\n\r\n    private readonly unitScale: UnitScale;\r\n    // Format options to use by default. It renders the number with a maximum of 6 signficant digits (including zero before decimal point).\r\n    private readonly defaultIntlNumberFormatOptions: Intl.NumberFormatOptions = {\r\n        maximumSignificantDigits: UnitFormatDefault.maximumDigits,\r\n        maximumFractionDigits: UnitFormatDefault.maximumDigits - 1,\r\n        roundingPriority: 'lessPrecision',\r\n        signDisplay\r\n    };\r\n\r\n    private readonly defaultScaledUnitFormatters = new Map<\r\n        number,\r\n        ScaledUnitFormat\r\n    >();\r\n\r\n    // Format options for numbers that should be displayed in exponential notation. This should be used\r\n    // for numbers with magintudes over 'exponentialUpperBound' or under 'exponentialLowerBound'.\r\n    private readonly exponentialIntlNumberFormatOptions: Intl.NumberFormatOptions = {\r\n        maximumSignificantDigits: UnitFormatDefault.maximumDigits,\r\n        notation: 'scientific',\r\n        signDisplay\r\n    };\r\n\r\n    private readonly exponentialScaledUnitFormatter: ScaledUnitFormat;\r\n\r\n    public constructor(\r\n        locale: string,\r\n        { unitScale = unitScalePassthrough }: UnitFormatDefaultOptions = {\r\n            unitScale: unitScalePassthrough\r\n        }\r\n    ) {\r\n        super();\r\n        for (const unit of unitScale.supportedScaledUnits) {\r\n            this.defaultScaledUnitFormatters.set(\r\n                unit.scaleFactor,\r\n                unit.scaledUnitFormatFactory({\r\n                    locale,\r\n                    intlNumberFormatOptions: this.defaultIntlNumberFormatOptions\r\n                })\r\n            );\r\n        }\r\n        this.exponentialScaledUnitFormatter = unitScale.baseScaledUnit.scaledUnitFormatFactory({\r\n            locale,\r\n            intlNumberFormatOptions: this.exponentialIntlNumberFormatOptions\r\n        });\r\n        this.unitScale = unitScale;\r\n    }\r\n\r\n    public override resolvedOptions(): UnitFormatDefaultResolvedOptions {\r\n        return {\r\n            unitScale: this.unitScale\r\n        };\r\n    }\r\n\r\n    protected tryFormat(number: number): string {\r\n        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(number);\r\n\r\n        const absoluteValue = Math.abs(scaledValue);\r\n        const useExponential = absoluteValue !== 0\r\n            && (absoluteValue >= UnitFormatDefault.exponentialUpperBound\r\n                || absoluteValue < UnitFormatDefault.exponentialLowerBound);\r\n        return useExponential\r\n            ? this.exponentialScaledUnitFormatter.format(number)\r\n            : this.defaultScaledUnitFormatters\r\n                .get(scaledUnit.scaleFactor)!\r\n                .format(scaledValue);\r\n    }\r\n}\r\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,16 @@
+import type { UnitScale } from './unit-scale/index.js';
+export interface UnitFormatOptions {
+    unitScale?: UnitScale;
+}
+/**
+ * The base class for unit formats.
+ */
+export declare abstract class UnitFormat<Options extends UnitFormatOptions = UnitFormatOptions> {
+    /**
+     * Formats a number value to a string.
+     * For nullish values or values that result in an exception being thrown, empty string is returned
+     */
+    format(value: number | undefined | null): string;
+    abstract resolvedOptions(): Required<Options>;
+    protected abstract tryFormat(number: number): string;
+}

package/dist/esm/index.js

@@ -0,0 +1,21 @@
+/**
+ * The base class for unit formats.
+ */
+export class UnitFormat {
+    /**
+     * Formats a number value to a string.
+     * For nullish values or values that result in an exception being thrown, empty string is returned
+     */
+    format(value) {
+        if (typeof value !== 'number') {
+            return '';
+        }
+        try {
+            return this.tryFormat(value);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,OAAgB,UAAU;IAG5B;;;OAGG;IACI,MAAM,CAAC,KAAgC;QAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;CAKJ","sourcesContent":["import type { UnitScale } from './unit-scale/index.js';\r\n\r\nexport interface UnitFormatOptions {\r\n    unitScale?: UnitScale;\r\n}\r\n\r\n/**\r\n * The base class for unit formats.\r\n */\r\nexport abstract class UnitFormat<\r\n    Options extends UnitFormatOptions = UnitFormatOptions\r\n> {\r\n    /**\r\n     * Formats a number value to a string.\r\n     * For nullish values or values that result in an exception being thrown, empty string is returned\r\n     */\r\n    public format(value: number | undefined | null): string {\r\n        if (typeof value !== 'number') {\r\n            return '';\r\n        }\r\n\r\n        try {\r\n            return this.tryFormat(value);\r\n        } catch {\r\n            return '';\r\n        }\r\n    }\r\n\r\n    public abstract resolvedOptions(): Required<Options>;\r\n\r\n    protected abstract tryFormat(number: number): string;\r\n}\r\n"]}

package/dist/esm/scaled-unit/index.d.ts

@@ -0,0 +1,16 @@
+import type { ScaledUnitFormat } from '../scaled-unit-format/index.js';
+export interface ScaledUnitFormatFactoryOptions {
+    readonly locale: string;
+    readonly intlNumberFormatOptions?: Intl.NumberFormatOptions;
+}
+type ScaledUnitFormatFactory = (scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions) => ScaledUnitFormat;
+/**
+ * A unit that represents a scaled version of a base unit.
+ */
+export declare class ScaledUnit {
+    readonly scaleFactor: number;
+    readonly scaledUnitFormatFactory: ScaledUnitFormatFactory;
+    constructor(scaleFactor: number, scaledUnitFormatFactory: ScaledUnitFormatFactory);
+    isBase(): boolean;
+}
+export {};

package/dist/esm/scaled-unit/index.js

@@ -0,0 +1,13 @@
+/**
+ * A unit that represents a scaled version of a base unit.
+ */
+export class ScaledUnit {
+    constructor(scaleFactor, scaledUnitFormatFactory) {
+        this.scaleFactor = scaleFactor;
+        this.scaledUnitFormatFactory = scaledUnitFormatFactory;
+    }
+    isBase() {
+        return this.scaleFactor === 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/scaled-unit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scaled-unit/index.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,OAAO,UAAU;IACnB,YACoB,WAAmB,EACnB,uBAAgD;QADhD,gBAAW,GAAX,WAAW,CAAQ;QACnB,4BAAuB,GAAvB,uBAAuB,CAAyB;IACjE,CAAC;IAEG,MAAM;QACT,OAAO,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC;IAClC,CAAC;CACJ","sourcesContent":["import type { ScaledUnitFormat } from '../scaled-unit-format/index.js';\r\n\r\nexport interface ScaledUnitFormatFactoryOptions {\r\n    readonly locale: string;\r\n    readonly intlNumberFormatOptions?: Intl.NumberFormatOptions;\r\n}\r\n\r\ntype ScaledUnitFormatFactory = (\r\n    scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions\r\n) => ScaledUnitFormat;\r\n\r\n/**\r\n * A unit that represents a scaled version of a base unit.\r\n */\r\nexport class ScaledUnit {\r\n    public constructor(\r\n        public readonly scaleFactor: number,\r\n        public readonly scaledUnitFormatFactory: ScaledUnitFormatFactory\r\n    ) {}\r\n\r\n    public isBase(): boolean {\r\n        return this.scaleFactor === 1;\r\n    }\r\n}\r\n"]}

package/dist/esm/scaled-unit-format/index.d.ts

@@ -0,0 +1,10 @@
+import type { ScaledUnitFormatFactoryOptions } from '../scaled-unit/index.js';
+/**
+ * A class that knows how to format a numeric value as a string that includes units.
+ */
+export declare abstract class ScaledUnitFormat {
+    protected readonly locale: string;
+    protected readonly intlNumberFormatOptions?: Intl.NumberFormatOptions;
+    protected constructor(scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions);
+    abstract format(value: number): string;
+}

package/dist/esm/scaled-unit-format/index.js

@@ -0,0 +1,10 @@
+/**
+ * A class that knows how to format a numeric value as a string that includes units.
+ */
+export class ScaledUnitFormat {
+    constructor(scaledUnitFormatFactoryOptions) {
+        this.locale = scaledUnitFormatFactoryOptions.locale;
+        this.intlNumberFormatOptions = scaledUnitFormatFactoryOptions.intlNumberFormatOptions;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/scaled-unit-format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scaled-unit-format/index.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAgB,gBAAgB;IAIlC,YACI,8BAA8D;QAE9D,IAAI,CAAC,MAAM,GAAG,8BAA8B,CAAC,MAAM,CAAC;QACpD,IAAI,CAAC,uBAAuB,GAAG,8BAA8B,CAAC,uBAAuB,CAAC;IAC1F,CAAC;CAGJ","sourcesContent":["import type { ScaledUnitFormatFactoryOptions } from '../scaled-unit/index.js';\r\n\r\n/**\r\n * A class that knows how to format a numeric value as a string that includes units.\r\n */\r\nexport abstract class ScaledUnitFormat {\r\n    protected readonly locale: string;\r\n    protected readonly intlNumberFormatOptions?: Intl.NumberFormatOptions;\r\n\r\n    protected constructor(\r\n        scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions\r\n    ) {\r\n        this.locale = scaledUnitFormatFactoryOptions.locale;\r\n        this.intlNumberFormatOptions = scaledUnitFormatFactoryOptions.intlNumberFormatOptions;\r\n    }\r\n\r\n    public abstract format(value: number): string;\r\n}\r\n"]}

package/dist/esm/scaled-unit-format/intl-number-format/index.d.ts

@@ -0,0 +1,11 @@
+import type { ScaledUnitFormatFactoryOptions } from '../../scaled-unit/index.js';
+import { ScaledUnitFormat } from '../index.js';
+/**
+ * A formatter for units that can be formatted/translated by Intl.NumberFormat
+ */
+export declare class ScaledUnitFormatIntlNumberFormat extends ScaledUnitFormat {
+    private readonly formatter;
+    protected constructor(scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions, unitSpecificIntlNumberFormatOptions: Intl.NumberFormatOptions);
+    static createFactory(unitSpecificIntlNumberFormatOptions: Intl.NumberFormatOptions): (scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions) => ScaledUnitFormatIntlNumberFormat;
+    format(value: number): string;
+}

package/dist/esm/scaled-unit-format/intl-number-format/index.js

@@ -0,0 +1,21 @@
+import { ScaledUnitFormat } from '../index.js';
+/**
+ * A formatter for units that can be formatted/translated by Intl.NumberFormat
+ */
+export class ScaledUnitFormatIntlNumberFormat extends ScaledUnitFormat {
+    constructor(scaledUnitFormatFactoryOptions, unitSpecificIntlNumberFormatOptions) {
+        super(scaledUnitFormatFactoryOptions);
+        this.formatter = new Intl.NumberFormat(this.locale, {
+            ...unitSpecificIntlNumberFormatOptions,
+            // Application configured options override unit specific options
+            ...this.intlNumberFormatOptions
+        });
+    }
+    static createFactory(unitSpecificIntlNumberFormatOptions) {
+        return (scaledUnitFormatFactoryOptions) => new ScaledUnitFormatIntlNumberFormat(scaledUnitFormatFactoryOptions, unitSpecificIntlNumberFormatOptions);
+    }
+    format(value) {
+        return this.formatter.format(value);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/scaled-unit-format/intl-number-format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/scaled-unit-format/intl-number-format/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,gCAAiC,SAAQ,gBAAgB;IAGlE,YACI,8BAA8D,EAC9D,mCAA6D;QAE7D,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;YAChD,GAAG,mCAAmC;YACtC,gEAAgE;YAChE,GAAG,IAAI,CAAC,uBAAuB;SAClC,CAAC,CAAC;IACP,CAAC;IAEM,MAAM,CAAC,aAAa,CACvB,mCAA6D;QAE7D,OAAO,CACH,8BAA8D,EAC9B,EAAE,CAAC,IAAI,gCAAgC,CACvE,8BAA8B,EAC9B,mCAAmC,CACtC,CAAC;IACN,CAAC;IAEM,MAAM,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;CACJ","sourcesContent":["import type { ScaledUnitFormatFactoryOptions } from '../../scaled-unit/index.js';\r\nimport { ScaledUnitFormat } from '../index.js';\r\n\r\n/**\r\n * A formatter for units that can be formatted/translated by Intl.NumberFormat\r\n */\r\nexport class ScaledUnitFormatIntlNumberFormat extends ScaledUnitFormat {\r\n    private readonly formatter: Intl.NumberFormat;\r\n\r\n    protected constructor(\r\n        scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions,\r\n        unitSpecificIntlNumberFormatOptions: Intl.NumberFormatOptions\r\n    ) {\r\n        super(scaledUnitFormatFactoryOptions);\r\n        this.formatter = new Intl.NumberFormat(this.locale, {\r\n            ...unitSpecificIntlNumberFormatOptions,\r\n            // Application configured options override unit specific options\r\n            ...this.intlNumberFormatOptions\r\n        });\r\n    }\r\n\r\n    public static createFactory(\r\n        unitSpecificIntlNumberFormatOptions: Intl.NumberFormatOptions\r\n    ) {\r\n        return (\r\n            scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions\r\n        ): ScaledUnitFormatIntlNumberFormat => new ScaledUnitFormatIntlNumberFormat(\r\n            scaledUnitFormatFactoryOptions,\r\n            unitSpecificIntlNumberFormatOptions\r\n        );\r\n    }\r\n\r\n    public format(value: number): string {\r\n        return this.formatter.format(value);\r\n    }\r\n}\r\n"]}

package/dist/esm/scaled-unit-format/manually-translated/index.d.ts

@@ -0,0 +1,43 @@
+import type { ScaledUnitFormatFactoryOptions } from '../../scaled-unit/index.js';
+import { ScaledUnitFormat } from '../index.js';
+/**
+ * Representations of a unit in a particular language
+ */
+export declare class UnitTranslation {
+    readonly singular: string;
+    readonly plural: string;
+    readonly symbol: string;
+    constructor(singular: string, plural: string, symbol: string);
+}
+/**
+ * A map of locales of string format "[lang]" or "[lang]-[region]", for example "en" and / or "en-us", to UnitTranslation objects
+ */
+export type UnitTranslations = ReadonlyMap<string, UnitTranslation>;
+export interface ScaledUnitFormatManuallyTranslatedOptions {
+    /**
+     * Translations for the unit by locale string.
+     * The locale strings must be of the form [lang] or [lang]-[region], for example "en" and / or "en-us".
+     * Other subtags besides lang and region are not supported.
+     * Translations for "en" must be provided.
+     */
+    readonly unitTranslations: UnitTranslations;
+    /**
+     * String for prefix of this scaled unit, for example "k" (for kilo-).
+     * Assumed the same across languages.
+     * Base unit must use "", i.e. empty string, as the scaled prefix text.
+     */
+    readonly scaledPrefixText: string;
+}
+/**
+ * A formatter for units that are not supported by Intl.NumberFormat
+ */
+export declare class ScaledUnitFormatManuallyTranslated extends ScaledUnitFormat {
+    private readonly pluralRules;
+    private readonly formatter;
+    private readonly unitTranslation;
+    private readonly scaledPrefixText;
+    protected constructor(scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions, { unitTranslations, scaledPrefixText }: ScaledUnitFormatManuallyTranslatedOptions);
+    static createFactory(scaledUnitFormatManuallyTranslatedOptions: ScaledUnitFormatManuallyTranslatedOptions): (scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions) => ScaledUnitFormatManuallyTranslated;
+    format(value: number): string;
+    private getTranslationToUse;
+}

package/dist/esm/scaled-unit-format/manually-translated/index.js

@@ -0,0 +1,63 @@
+import { ScaledUnitFormat } from '../index.js';
+/**
+ * Representations of a unit in a particular language
+ */
+export class UnitTranslation {
+    constructor(singular, plural, symbol) {
+        this.singular = singular;
+        this.plural = plural;
+        this.symbol = symbol;
+    }
+}
+/**
+ * A formatter for units that are not supported by Intl.NumberFormat
+ */
+export class ScaledUnitFormatManuallyTranslated extends ScaledUnitFormat {
+    constructor(scaledUnitFormatFactoryOptions, { unitTranslations, scaledPrefixText }) {
+        super(scaledUnitFormatFactoryOptions);
+        if (!unitTranslations.get('en')) {
+            throw new Error('English translations must exist with locale string "en"');
+        }
+        this.pluralRules = new Intl.PluralRules(this.locale);
+        this.formatter = new Intl.NumberFormat(this.locale, this.intlNumberFormatOptions);
+        this.unitTranslation = this.getTranslationToUse(unitTranslations, this.locale);
+        this.scaledPrefixText = scaledPrefixText;
+    }
+    static createFactory(scaledUnitFormatManuallyTranslatedOptions) {
+        return (scaledUnitFormatFactoryOptions) => new ScaledUnitFormatManuallyTranslated(scaledUnitFormatFactoryOptions, scaledUnitFormatManuallyTranslatedOptions);
+    }
+    format(value) {
+        const formatted = this.formatter.format(value);
+        // For non-base units (which are a scaled prefix text of empty string)
+        if (this.scaledPrefixText !== '') {
+            return `${formatted} ${this.scaledPrefixText}${this.unitTranslation.symbol}`;
+        }
+        // Some languages have more than two forms (singular/plural) of cardinal
+        // numbers, but we are treating anything other than the 'one' form as plural.
+        // See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules#description
+        //
+        // Because PluralRules.select() takes a number (not a string), it cannot differentiate
+        // between 1 and 1.0. When NumberFormat is configured to format with a set number
+        // of fractional digits, those fractional digits can have an effect on the pluralization
+        // of the unit. E.g. in English, it formats "1 byte" vs "1.0 bytes". Thus there is
+        // sometimes an inconsistency between unit pluralization for the same number, based
+        // on whether it's supported by NumberFormat, or manually translated.
+        const unitLabel = this.pluralRules.select(value) === 'one'
+            ? this.unitTranslation.singular
+            : this.unitTranslation.plural;
+        return `${formatted} ${unitLabel}`;
+    }
+    getTranslationToUse(unitTranslations, locale) {
+        const localeObject = new Intl.Locale(locale ?? 'en');
+        const language = localeObject.language;
+        const region = localeObject.region;
+        const regionSpecificMatchedTranslations = region
+            ? unitTranslations.get(`${language}-${region}`)
+            : undefined;
+        return (regionSpecificMatchedTranslations
+            ?? unitTranslations.get(language)
+            ?? unitTranslations.get('en'));
+    }
+}
+/* eslint-enable max-classes-per-file */
+//# sourceMappingURL=index.js.map

package/dist/esm/scaled-unit-format/manually-translated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/scaled-unit-format/manually-translated/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,eAAe;IACxB,YACoB,QAAgB,EAChB,MAAc,EACd,MAAc;QAFd,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;IAC/B,CAAC;CACP;AAqBD;;GAEG;AACH,MAAM,OAAO,kCAAmC,SAAQ,gBAAgB;IAMpE,YACI,8BAA8D,EAC9D,EACI,gBAAgB,EAChB,gBAAgB,EACwB;QAE5C,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACX,yDAAyD,CAC5D,CAAC;QACN,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAClC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,uBAAuB,CAC/B,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,mBAAmB,CAC3C,gBAAgB,EAChB,IAAI,CAAC,MAAM,CACd,CAAC;QACF,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC7C,CAAC;IAEM,MAAM,CAAC,aAAa,CACvB,yCAAoF;QAEpF,OAAO,CACH,8BAA8D,EAC5B,EAAE,CAAC,IAAI,kCAAkC,CAC3E,8BAA8B,EAC9B,yCAAyC,CAC5C,CAAC;IACN,CAAC;IAEM,MAAM,CAAC,KAAa;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,sEAAsE;QACtE,IAAI,IAAI,CAAC,gBAAgB,KAAK,EAAE,EAAE,CAAC;YAC/B,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QACjF,CAAC;QAED,wEAAwE;QACxE,6EAA6E;QAC7E,oHAAoH;QACpH,EAAE;QACF,sFAAsF;QACtF,iFAAiF;QACjF,wFAAwF;QACxF,kFAAkF;QAClF,mFAAmF;QACnF,qEAAqE;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK;YACtD,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ;YAC/B,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;QAClC,OAAO,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;IACvC,CAAC;IAEO,mBAAmB,CACvB,gBAAkC,EAClC,MAAc;QAEd,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QACnC,MAAM,iCAAiC,GAAG,MAAM;YAC5C,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC/C,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,CACH,iCAAiC;eAC9B,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;eAC9B,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAE,CACjC,CAAC;IACN,CAAC;CACJ;AACD,wCAAwC","sourcesContent":["/* eslint-disable max-classes-per-file */\r\nimport type { ScaledUnitFormatFactoryOptions } from '../../scaled-unit/index.js';\r\nimport { ScaledUnitFormat } from '../index.js';\r\n\r\n/**\r\n * Representations of a unit in a particular language\r\n */\r\nexport class UnitTranslation {\r\n    public constructor(\r\n        public readonly singular: string,\r\n        public readonly plural: string,\r\n        public readonly symbol: string\r\n    ) {}\r\n}\r\n/**\r\n * A map of locales of string format \"[lang]\" or \"[lang]-[region]\", for example \"en\" and / or \"en-us\", to UnitTranslation objects\r\n */\r\nexport type UnitTranslations = ReadonlyMap<string, UnitTranslation>;\r\nexport interface ScaledUnitFormatManuallyTranslatedOptions {\r\n    /**\r\n     * Translations for the unit by locale string.\r\n     * The locale strings must be of the form [lang] or [lang]-[region], for example \"en\" and / or \"en-us\".\r\n     * Other subtags besides lang and region are not supported.\r\n     * Translations for \"en\" must be provided.\r\n     */\r\n    readonly unitTranslations: UnitTranslations;\r\n    /**\r\n     * String for prefix of this scaled unit, for example \"k\" (for kilo-).\r\n     * Assumed the same across languages.\r\n     * Base unit must use \"\", i.e. empty string, as the scaled prefix text.\r\n     */\r\n    readonly scaledPrefixText: string;\r\n}\r\n\r\n/**\r\n * A formatter for units that are not supported by Intl.NumberFormat\r\n */\r\nexport class ScaledUnitFormatManuallyTranslated extends ScaledUnitFormat {\r\n    private readonly pluralRules: Intl.PluralRules;\r\n    private readonly formatter: Intl.NumberFormat;\r\n    private readonly unitTranslation: UnitTranslation;\r\n    private readonly scaledPrefixText: string;\r\n\r\n    protected constructor(\r\n        scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions,\r\n        {\r\n            unitTranslations,\r\n            scaledPrefixText\r\n        }: ScaledUnitFormatManuallyTranslatedOptions\r\n    ) {\r\n        super(scaledUnitFormatFactoryOptions);\r\n        if (!unitTranslations.get('en')) {\r\n            throw new Error(\r\n                'English translations must exist with locale string \"en\"'\r\n            );\r\n        }\r\n        this.pluralRules = new Intl.PluralRules(this.locale);\r\n        this.formatter = new Intl.NumberFormat(\r\n            this.locale,\r\n            this.intlNumberFormatOptions\r\n        );\r\n        this.unitTranslation = this.getTranslationToUse(\r\n            unitTranslations,\r\n            this.locale\r\n        );\r\n        this.scaledPrefixText = scaledPrefixText;\r\n    }\r\n\r\n    public static createFactory(\r\n        scaledUnitFormatManuallyTranslatedOptions: ScaledUnitFormatManuallyTranslatedOptions\r\n    ) {\r\n        return (\r\n            scaledUnitFormatFactoryOptions: ScaledUnitFormatFactoryOptions\r\n        ): ScaledUnitFormatManuallyTranslated => new ScaledUnitFormatManuallyTranslated(\r\n            scaledUnitFormatFactoryOptions,\r\n            scaledUnitFormatManuallyTranslatedOptions\r\n        );\r\n    }\r\n\r\n    public format(value: number): string {\r\n        const formatted = this.formatter.format(value);\r\n        // For non-base units (which are a scaled prefix text of empty string)\r\n        if (this.scaledPrefixText !== '') {\r\n            return `${formatted} ${this.scaledPrefixText}${this.unitTranslation.symbol}`;\r\n        }\r\n\r\n        // Some languages have more than two forms (singular/plural) of cardinal\r\n        // numbers, but we are treating anything other than the 'one' form as plural.\r\n        // See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules#description\r\n        //\r\n        // Because PluralRules.select() takes a number (not a string), it cannot differentiate\r\n        // between 1 and 1.0. When NumberFormat is configured to format with a set number\r\n        // of fractional digits, those fractional digits can have an effect on the pluralization\r\n        // of the unit. E.g. in English, it formats \"1 byte\" vs \"1.0 bytes\". Thus there is\r\n        // sometimes an inconsistency between unit pluralization for the same number, based\r\n        // on whether it's supported by NumberFormat, or manually translated.\r\n        const unitLabel = this.pluralRules.select(value) === 'one'\r\n            ? this.unitTranslation.singular\r\n            : this.unitTranslation.plural;\r\n        return `${formatted} ${unitLabel}`;\r\n    }\r\n\r\n    private getTranslationToUse(\r\n        unitTranslations: UnitTranslations,\r\n        locale: string\r\n    ): UnitTranslation {\r\n        const localeObject = new Intl.Locale(locale ?? 'en');\r\n        const language = localeObject.language;\r\n        const region = localeObject.region;\r\n        const regionSpecificMatchedTranslations = region\r\n            ? unitTranslations.get(`${language}-${region}`)\r\n            : undefined;\r\n        return (\r\n            regionSpecificMatchedTranslations\r\n            ?? unitTranslations.get(language)\r\n            ?? unitTranslations.get('en')!\r\n        );\r\n    }\r\n}\r\n/* eslint-enable max-classes-per-file */\r\n"]}

package/dist/esm/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../src/index.ts","../../src/decimal/index.ts","../../src/default/index.ts","../../src/scaled-unit/index.ts","../../src/scaled-unit-format/index.ts","../../src/scaled-unit-format/intl-number-format/index.ts","../../src/scaled-unit-format/manually-translated/index.ts","../../src/scaled-unit-format/tests/scaled-unit-format-manually-translated.spec.ts","../../src/tests/scaled-unit-format-test.ts","../../src/tests/unit-format-decimal.spec.ts","../../src/tests/unit-format-default.spec.ts","../../src/unit-scale/index.ts","../../src/unit-scale/byte/index.ts","../../src/unit-scale/byte-1024/index.ts","../../src/unit-scale/celsius/index.ts","../../src/unit-scale/fahrenheit/index.ts","../../src/unit-scale/passthrough/index.ts","../../src/unit-scale/tests/unit-scale-byte-1024.spec.ts","../../src/unit-scale/tests/unit-scale-byte.spec.ts","../../src/unit-scale/tests/unit-scale-celsius.spec.ts","../../src/unit-scale/tests/unit-scale-fahrenheit.spec.ts","../../src/unit-scale/tests/unit-scale-volt.spec.ts","../../src/unit-scale/tests/unit-scale.spec.ts","../../src/unit-scale/utilities/metric-prefixes.ts","../../src/unit-scale/volt/index.ts"],"version":"5.8.3"}

package/dist/esm/unit-scale/byte/index.d.ts

@@ -0,0 +1,9 @@
+import { UnitScale } from '../index.js';
+/**
+ * Byte units (1000-based)
+ */
+declare class UnitScaleByte extends UnitScale {
+    constructor();
+}
+export declare const unitScaleByte: UnitScaleByte;
+export {};

package/dist/esm/unit-scale/byte/index.js

@@ -0,0 +1,25 @@
+import { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';
+import { ScaledUnit } from '../../scaled-unit/index.js';
+import { UnitScale } from '../index.js';
+const unitScaleByteConfig = [
+    [1000 ** 0, 'byte', 'long'],
+    [1000 ** 1, 'kilobyte', 'short'],
+    [1000 ** 2, 'megabyte', 'short'],
+    [1000 ** 3, 'gigabyte', 'short'],
+    [1000 ** 4, 'terabyte', 'short'],
+    [1000 ** 5, 'petabyte', 'short']
+];
+/**
+ * Byte units (1000-based)
+ */
+class UnitScaleByte extends UnitScale {
+    constructor() {
+        super(unitScaleByteConfig.map(([scaleFactor, unit, unitDisplay]) => new ScaledUnit(scaleFactor, ScaledUnitFormatIntlNumberFormat.createFactory({
+            style: 'unit',
+            unit,
+            unitDisplay
+        }))));
+    }
+}
+export const unitScaleByte = new UnitScaleByte();
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/byte/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unit-scale/byte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,mBAAmB,GAAG;IACxB,CAAC,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3B,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;IAChC,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;IAChC,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;IAChC,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;IAChC,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEX;;GAEG;AACH,MAAM,aAAc,SAAQ,SAAS;IACjC;QACI,KAAK,CACD,mBAAmB,CAAC,GAAG,CACnB,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAChD,WAAW,EACX,gCAAgC,CAAC,aAAa,CAAC;YAC3C,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,WAAW;SACd,CAAC,CACL,CACJ,CACJ,CAAC;IACN,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC","sourcesContent":["import { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';\r\nimport { ScaledUnit } from '../../scaled-unit/index.js';\r\nimport { UnitScale } from '../index.js';\r\n\r\nconst unitScaleByteConfig = [\r\n    [1000 ** 0, 'byte', 'long'],\r\n    [1000 ** 1, 'kilobyte', 'short'],\r\n    [1000 ** 2, 'megabyte', 'short'],\r\n    [1000 ** 3, 'gigabyte', 'short'],\r\n    [1000 ** 4, 'terabyte', 'short'],\r\n    [1000 ** 5, 'petabyte', 'short']\r\n] as const;\r\n\r\n/**\r\n * Byte units (1000-based)\r\n */\r\nclass UnitScaleByte extends UnitScale {\r\n    public constructor() {\r\n        super(\r\n            unitScaleByteConfig.map(\r\n                ([scaleFactor, unit, unitDisplay]) => new ScaledUnit(\r\n                    scaleFactor,\r\n                    ScaledUnitFormatIntlNumberFormat.createFactory({\r\n                        style: 'unit',\r\n                        unit,\r\n                        unitDisplay\r\n                    })\r\n                )\r\n            )\r\n        );\r\n    }\r\n}\r\n\r\nexport const unitScaleByte = new UnitScaleByte();\r\n"]}

package/dist/esm/unit-scale/byte-1024/index.d.ts

@@ -0,0 +1,9 @@
+import { UnitScale } from '../index.js';
+/**
+ * Byte units (1024-based)
+ */
+declare class UnitScaleByte1024 extends UnitScale {
+    constructor();
+}
+export declare const unitScaleByte1024: UnitScaleByte1024;
+export {};

package/dist/esm/unit-scale/byte-1024/index.js

@@ -0,0 +1,31 @@
+import { ScaledUnit } from '../../scaled-unit/index.js';
+import { UnitScale } from '../index.js';
+import { ScaledUnitFormatManuallyTranslated, UnitTranslation } from '../../scaled-unit-format/manually-translated/index.js';
+const unitTranslations = new Map([
+    ['en', new UnitTranslation('byte', 'bytes', 'B')],
+    ['fr', new UnitTranslation('octet', 'octets', 'o')],
+    ['de', new UnitTranslation('Byte', 'Byte', 'B')],
+    ['ja', new UnitTranslation('バイト', 'バイト', 'B')],
+    ['zh', new UnitTranslation('字节', '字节', 'B')]
+]);
+const byte1024Prefixes = [
+    [1024 ** 0, ''],
+    [1024 ** 1, 'Ki'],
+    [1024 ** 2, 'Mi'],
+    [1024 ** 3, 'Gi'],
+    [1024 ** 4, 'Ti'],
+    [1024 ** 5, 'Pi']
+];
+/**
+ * Byte units (1024-based)
+ */
+class UnitScaleByte1024 extends UnitScale {
+    constructor() {
+        super(byte1024Prefixes.map(([scaleFactor, scaledPrefixText]) => new ScaledUnit(scaleFactor, ScaledUnitFormatManuallyTranslated.createFactory({
+            unitTranslations,
+            scaledPrefixText
+        }))));
+    }
+}
+export const unitScaleByte1024 = new UnitScaleByte1024();
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/byte-1024/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unit-scale/byte-1024/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACH,kCAAkC,EAElC,eAAe,EAClB,MAAM,uDAAuD,CAAC;AAE/D,MAAM,gBAAgB,GAAqB,IAAI,GAAG,CAAC;IAC/C,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG;IACrB,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;IACf,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC;IACjB,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC;IACjB,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC;IACjB,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC;IACjB,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,CAAC;CACX,CAAC;AAEX;;GAEG;AACH,MAAM,iBAAkB,SAAQ,SAAS;IACrC;QACI,KAAK,CACD,gBAAgB,CAAC,GAAG,CAChB,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAC/C,WAAW,EACX,kCAAkC,CAAC,aAAa,CAAC;YAC7C,gBAAgB;YAChB,gBAAgB;SACnB,CAAC,CACL,CACJ,CACJ,CAAC;IACN,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC","sourcesContent":["import { ScaledUnit } from '../../scaled-unit/index.js';\r\nimport { UnitScale } from '../index.js';\r\nimport {\r\n    ScaledUnitFormatManuallyTranslated,\r\n    type UnitTranslations,\r\n    UnitTranslation\r\n} from '../../scaled-unit-format/manually-translated/index.js';\r\n\r\nconst unitTranslations: UnitTranslations = new Map([\r\n    ['en', new UnitTranslation('byte', 'bytes', 'B')],\r\n    ['fr', new UnitTranslation('octet', 'octets', 'o')],\r\n    ['de', new UnitTranslation('Byte', 'Byte', 'B')],\r\n    ['ja', new UnitTranslation('バイト', 'バイト', 'B')],\r\n    ['zh', new UnitTranslation('字节', '字节', 'B')]\r\n]);\r\n\r\nconst byte1024Prefixes = [\r\n    [1024 ** 0, ''],\r\n    [1024 ** 1, 'Ki'],\r\n    [1024 ** 2, 'Mi'],\r\n    [1024 ** 3, 'Gi'],\r\n    [1024 ** 4, 'Ti'],\r\n    [1024 ** 5, 'Pi']\r\n] as const;\r\n\r\n/**\r\n * Byte units (1024-based)\r\n */\r\nclass UnitScaleByte1024 extends UnitScale {\r\n    public constructor() {\r\n        super(\r\n            byte1024Prefixes.map(\r\n                ([scaleFactor, scaledPrefixText]) => new ScaledUnit(\r\n                    scaleFactor,\r\n                    ScaledUnitFormatManuallyTranslated.createFactory({\r\n                        unitTranslations,\r\n                        scaledPrefixText\r\n                    })\r\n                )\r\n            )\r\n        );\r\n    }\r\n}\r\n\r\nexport const unitScaleByte1024 = new UnitScaleByte1024();\r\n"]}

package/dist/esm/unit-scale/celsius/index.d.ts

@@ -0,0 +1,9 @@
+import { UnitScale } from '../index.js';
+/**
+ * Degrees Celsius units
+ */
+declare class UnitScaleCelsius extends UnitScale {
+    constructor();
+}
+export declare const unitScaleCelsius: UnitScaleCelsius;
+export {};

package/dist/esm/unit-scale/celsius/index.js

@@ -0,0 +1,18 @@
+import { ScaledUnit } from '../../scaled-unit/index.js';
+import { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';
+import { UnitScale } from '../index.js';
+const unitScaleCelsiusConfig = [[1, 'celsius', 'short']];
+/**
+ * Degrees Celsius units
+ */
+class UnitScaleCelsius extends UnitScale {
+    constructor() {
+        super(unitScaleCelsiusConfig.map(([scaleFactor, unit, unitDisplay]) => new ScaledUnit(scaleFactor, ScaledUnitFormatIntlNumberFormat.createFactory({
+            style: 'unit',
+            unit,
+            unitDisplay
+        }))));
+    }
+}
+export const unitScaleCelsius = new UnitScaleCelsius();
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/celsius/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unit-scale/celsius/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,sBAAsB,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAU,CAAC;AAElE;;GAEG;AACH,MAAM,gBAAiB,SAAQ,SAAS;IACpC;QACI,KAAK,CACD,sBAAsB,CAAC,GAAG,CACtB,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAChD,WAAW,EACX,gCAAgC,CAAC,aAAa,CAAC;YAC3C,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,WAAW;SACd,CAAC,CACL,CACJ,CACJ,CAAC;IACN,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC","sourcesContent":["import { ScaledUnit } from '../../scaled-unit/index.js';\r\nimport { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';\r\nimport { UnitScale } from '../index.js';\r\n\r\nconst unitScaleCelsiusConfig = [[1, 'celsius', 'short']] as const;\r\n\r\n/**\r\n * Degrees Celsius units\r\n */\r\nclass UnitScaleCelsius extends UnitScale {\r\n    public constructor() {\r\n        super(\r\n            unitScaleCelsiusConfig.map(\r\n                ([scaleFactor, unit, unitDisplay]) => new ScaledUnit(\r\n                    scaleFactor,\r\n                    ScaledUnitFormatIntlNumberFormat.createFactory({\r\n                        style: 'unit',\r\n                        unit,\r\n                        unitDisplay\r\n                    })\r\n                )\r\n            )\r\n        );\r\n    }\r\n}\r\n\r\nexport const unitScaleCelsius = new UnitScaleCelsius();\r\n"]}

package/dist/esm/unit-scale/fahrenheit/index.d.ts

@@ -0,0 +1,9 @@
+import { UnitScale } from '../index.js';
+/**
+ * Degrees Fahrenheit units
+ */
+declare class UnitScaleFahrenheit extends UnitScale {
+    constructor();
+}
+export declare const unitScaleFahrenheit: UnitScaleFahrenheit;
+export {};

package/dist/esm/unit-scale/fahrenheit/index.js

@@ -0,0 +1,18 @@
+import { ScaledUnit } from '../../scaled-unit/index.js';
+import { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';
+import { UnitScale } from '../index.js';
+const unitScaleFahrenheitConfig = [[1, 'fahrenheit', 'short']];
+/**
+ * Degrees Fahrenheit units
+ */
+class UnitScaleFahrenheit extends UnitScale {
+    constructor() {
+        super(unitScaleFahrenheitConfig.map(([scaleFactor, unit, unitDisplay]) => new ScaledUnit(scaleFactor, ScaledUnitFormatIntlNumberFormat.createFactory({
+            style: 'unit',
+            unit,
+            unitDisplay
+        }))));
+    }
+}
+export const unitScaleFahrenheit = new UnitScaleFahrenheit();
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/fahrenheit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unit-scale/fahrenheit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,yBAAyB,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAU,CAAC;AAExE;;GAEG;AACH,MAAM,mBAAoB,SAAQ,SAAS;IACvC;QACI,KAAK,CACD,yBAAyB,CAAC,GAAG,CACzB,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAChD,WAAW,EACX,gCAAgC,CAAC,aAAa,CAAC;YAC3C,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,WAAW;SACd,CAAC,CACL,CACJ,CACJ,CAAC;IACN,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC","sourcesContent":["import { ScaledUnit } from '../../scaled-unit/index.js';\r\nimport { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';\r\nimport { UnitScale } from '../index.js';\r\n\r\nconst unitScaleFahrenheitConfig = [[1, 'fahrenheit', 'short']] as const;\r\n\r\n/**\r\n * Degrees Fahrenheit units\r\n */\r\nclass UnitScaleFahrenheit extends UnitScale {\r\n    public constructor() {\r\n        super(\r\n            unitScaleFahrenheitConfig.map(\r\n                ([scaleFactor, unit, unitDisplay]) => new ScaledUnit(\r\n                    scaleFactor,\r\n                    ScaledUnitFormatIntlNumberFormat.createFactory({\r\n                        style: 'unit',\r\n                        unit,\r\n                        unitDisplay\r\n                    })\r\n                )\r\n            )\r\n        );\r\n    }\r\n}\r\n\r\nexport const unitScaleFahrenheit = new UnitScaleFahrenheit();\r\n"]}

package/dist/esm/unit-scale/index.d.ts

@@ -0,0 +1,15 @@
+import type { ScaledUnit } from '../scaled-unit/index.js';
+interface ScaledNumber {
+    readonly scaledValue: number;
+    readonly scaledUnit: ScaledUnit;
+}
+/**
+ * A unit scale consisting of a set of scaled units.
+ */
+export declare abstract class UnitScale {
+    readonly supportedScaledUnits: readonly ScaledUnit[];
+    readonly baseScaledUnit: ScaledUnit;
+    constructor(supportedScaledUnits: readonly ScaledUnit[]);
+    scaleNumber(number: number): ScaledNumber;
+}
+export {};

package/dist/esm/unit-scale/index.js

@@ -0,0 +1,49 @@
+/**
+ * A unit scale consisting of a set of scaled units.
+ */
+export class UnitScale {
+    constructor(supportedScaledUnits) {
+        this.supportedScaledUnits = supportedScaledUnits;
+        const unitsSorted = supportedScaledUnits.every((curr, i, arr) => i === 0 || arr[i - 1].scaleFactor < curr.scaleFactor);
+        if (!unitsSorted) {
+            throw new Error('Supported scaled units must have unique and ordered scale factors');
+        }
+        const baseScaledUnit = supportedScaledUnits.find(x => x.isBase());
+        if (!baseScaledUnit) {
+            throw new Error('Supported scaled units must include a base scaled unit (scale factor=1)');
+        }
+        this.supportedScaledUnits = supportedScaledUnits;
+        this.baseScaledUnit = baseScaledUnit;
+    }
+    // Note that for the sake of reducing complexity in the implementation,
+    // we do NOT consider the effects of rounding when picking the unit to
+    // use for a given value. If formatting results in rounding, a value
+    // may be shown with an unexpected unit. Examples:
+    // - 999 bytes with two significant digits => "1000 bytes" (instead of "1 kB")
+    // - 0.00000000000000001 volts (= 0.01 fV) with one fractional digit => "0 fV" (instead of "0 volts")
+    scaleNumber(number) {
+        const magnitude = Math.abs(number);
+        const onlyBaseScaledUnit = this.supportedScaledUnits.length === 1;
+        if (onlyBaseScaledUnit
+            || magnitude === 0
+            || magnitude === Infinity
+            || Number.isNaN(magnitude)) {
+            return { scaledValue: number, scaledUnit: this.baseScaledUnit };
+        }
+        for (let i = this.supportedScaledUnits.length - 1; i >= 0; i -= 1) {
+            const scaledUnit = this.supportedScaledUnits[i];
+            if (magnitude / scaledUnit.scaleFactor >= 1) {
+                return {
+                    scaledValue: number / scaledUnit.scaleFactor,
+                    scaledUnit
+                };
+            }
+        }
+        const smallestUnit = this.supportedScaledUnits[0];
+        return {
+            scaledValue: number / smallestUnit.scaleFactor,
+            scaledUnit: smallestUnit
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/unit-scale/index.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAgB,SAAS;IAG3B,YACoB,oBAA2C;QAA3C,yBAAoB,GAApB,oBAAoB,CAAuB;QAE3D,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAC1C,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAC1E,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACX,mEAAmE,CACtE,CAAC;QACN,CAAC;QACD,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACX,yEAAyE,CAC5E,CAAC;QACN,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED,uEAAuE;IACvE,sEAAsE;IACtE,oEAAoE;IACpE,kDAAkD;IAClD,8EAA8E;IAC9E,qGAAqG;IAC9F,WAAW,CAAC,MAAc;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,kBAAkB,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC,CAAC;QAClE,IACI,kBAAkB;eACf,SAAS,KAAK,CAAC;eACf,SAAS,KAAK,QAAQ;eACtB,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAC5B,CAAC;YACC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpE,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAE,CAAC;YACjD,IAAI,SAAS,GAAG,UAAU,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;gBAC1C,OAAO;oBACH,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW;oBAC5C,UAAU;iBACb,CAAC;YACN,CAAC;QACL,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAE,CAAC;QACnD,OAAO;YACH,WAAW,EAAE,MAAM,GAAG,YAAY,CAAC,WAAW;YAC9C,UAAU,EAAE,YAAY;SAC3B,CAAC;IACN,CAAC;CACJ","sourcesContent":["import type { ScaledUnit } from '../scaled-unit/index.js';\r\n\r\ninterface ScaledNumber {\r\n    readonly scaledValue: number;\r\n    readonly scaledUnit: ScaledUnit;\r\n}\r\n\r\n/**\r\n * A unit scale consisting of a set of scaled units.\r\n */\r\nexport abstract class UnitScale {\r\n    public readonly baseScaledUnit: ScaledUnit;\r\n\r\n    public constructor(\r\n        public readonly supportedScaledUnits: readonly ScaledUnit[]\r\n    ) {\r\n        const unitsSorted = supportedScaledUnits.every(\r\n            (curr, i, arr) => i === 0 || arr[i - 1]!.scaleFactor < curr.scaleFactor\r\n        );\r\n        if (!unitsSorted) {\r\n            throw new Error(\r\n                'Supported scaled units must have unique and ordered scale factors'\r\n            );\r\n        }\r\n        const baseScaledUnit = supportedScaledUnits.find(x => x.isBase());\r\n        if (!baseScaledUnit) {\r\n            throw new Error(\r\n                'Supported scaled units must include a base scaled unit (scale factor=1)'\r\n            );\r\n        }\r\n        this.supportedScaledUnits = supportedScaledUnits;\r\n        this.baseScaledUnit = baseScaledUnit;\r\n    }\r\n\r\n    // Note that for the sake of reducing complexity in the implementation,\r\n    // we do NOT consider the effects of rounding when picking the unit to\r\n    // use for a given value. If formatting results in rounding, a value\r\n    // may be shown with an unexpected unit. Examples:\r\n    // - 999 bytes with two significant digits => \"1000 bytes\" (instead of \"1 kB\")\r\n    // - 0.00000000000000001 volts (= 0.01 fV) with one fractional digit => \"0 fV\" (instead of \"0 volts\")\r\n    public scaleNumber(number: number): ScaledNumber {\r\n        const magnitude = Math.abs(number);\r\n        const onlyBaseScaledUnit = this.supportedScaledUnits.length === 1;\r\n        if (\r\n            onlyBaseScaledUnit\r\n            || magnitude === 0\r\n            || magnitude === Infinity\r\n            || Number.isNaN(magnitude)\r\n        ) {\r\n            return { scaledValue: number, scaledUnit: this.baseScaledUnit };\r\n        }\r\n        for (let i = this.supportedScaledUnits.length - 1; i >= 0; i -= 1) {\r\n            const scaledUnit = this.supportedScaledUnits[i]!;\r\n            if (magnitude / scaledUnit.scaleFactor >= 1) {\r\n                return {\r\n                    scaledValue: number / scaledUnit.scaleFactor,\r\n                    scaledUnit\r\n                };\r\n            }\r\n        }\r\n        const smallestUnit = this.supportedScaledUnits[0]!;\r\n        return {\r\n            scaledValue: number / smallestUnit.scaleFactor,\r\n            scaledUnit: smallestUnit\r\n        };\r\n    }\r\n}\r\n"]}

package/dist/esm/unit-scale/passthrough/index.d.ts

@@ -0,0 +1,9 @@
+import { UnitScale } from '../index.js';
+/**
+ * Unit scale that is used to passthrough a number without applying scaling or units
+ */
+declare class UnitScalePassthrough extends UnitScale {
+    constructor();
+}
+export declare const unitScalePassthrough: UnitScalePassthrough;
+export {};

package/dist/esm/unit-scale/passthrough/index.js

@@ -0,0 +1,15 @@
+import { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';
+import { ScaledUnit } from '../../scaled-unit/index.js';
+import { UnitScale } from '../index.js';
+/**
+ * Unit scale that is used to passthrough a number without applying scaling or units
+ */
+class UnitScalePassthrough extends UnitScale {
+    constructor() {
+        super([
+            new ScaledUnit(10 ** 0, ScaledUnitFormatIntlNumberFormat.createFactory({}))
+        ]);
+    }
+}
+export const unitScalePassthrough = new UnitScalePassthrough();
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/passthrough/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unit-scale/passthrough/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,oBAAqB,SAAQ,SAAS;IACxC;QACI,KAAK,CAAC;YACF,IAAI,UAAU,CACV,EAAE,IAAI,CAAC,EACP,gCAAgC,CAAC,aAAa,CAAC,EAAE,CAAC,CACrD;SACJ,CAAC,CAAC;IACP,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC","sourcesContent":["import { ScaledUnitFormatIntlNumberFormat } from '../../scaled-unit-format/intl-number-format/index.js';\r\nimport { ScaledUnit } from '../../scaled-unit/index.js';\r\nimport { UnitScale } from '../index.js';\r\n\r\n/**\r\n * Unit scale that is used to passthrough a number without applying scaling or units\r\n */\r\nclass UnitScalePassthrough extends UnitScale {\r\n    public constructor() {\r\n        super([\r\n            new ScaledUnit(\r\n                10 ** 0,\r\n                ScaledUnitFormatIntlNumberFormat.createFactory({})\r\n            )\r\n        ]);\r\n    }\r\n}\r\n\r\nexport const unitScalePassthrough = new UnitScalePassthrough();\r\n"]}

package/dist/esm/unit-scale/utilities/metric-prefixes.d.ts

@@ -0,0 +1 @@
+export declare const metricPrefixes: readonly [readonly [number, "f"], readonly [number, "p"], readonly [number, "n"], readonly [number, "μ"], readonly [number, "m"], readonly [number, "c"], readonly [number, "d"], readonly [number, ""], readonly [number, "k"], readonly [number, "M"], readonly [number, "G"], readonly [number, "T"], readonly [number, "P"], readonly [number, "E"]];

package/dist/esm/unit-scale/utilities/metric-prefixes.js

@@ -0,0 +1,17 @@
+export const metricPrefixes = [
+    [10 ** -15, 'f'],
+    [10 ** -12, 'p'],
+    [10 ** -9, 'n'],
+    [10 ** -6, 'μ'],
+    [10 ** -3, 'm'],
+    [10 ** -2, 'c'],
+    [10 ** -1, 'd'],
+    [10 ** 0, ''],
+    [10 ** 3, 'k'],
+    [10 ** 6, 'M'],
+    [10 ** 9, 'G'],
+    [10 ** 12, 'T'],
+    [10 ** 15, 'P'],
+    [10 ** 18, 'E']
+];
+//# sourceMappingURL=metric-prefixes.js.map

package/dist/esm/unit-scale/utilities/metric-prefixes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-prefixes.js","sourceRoot":"","sources":["../../../../src/unit-scale/utilities/metric-prefixes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IAChB,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;IAChB,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IACb,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC;IACd,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC;IACd,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC;IACd,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC;IACf,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC;CACT,CAAC","sourcesContent":["export const metricPrefixes = [\r\n    [10 ** -15, 'f'],\r\n    [10 ** -12, 'p'],\r\n    [10 ** -9, 'n'],\r\n    [10 ** -6, 'μ'],\r\n    [10 ** -3, 'm'],\r\n    [10 ** -2, 'c'],\r\n    [10 ** -1, 'd'],\r\n    [10 ** 0, ''],\r\n    [10 ** 3, 'k'],\r\n    [10 ** 6, 'M'],\r\n    [10 ** 9, 'G'],\r\n    [10 ** 12, 'T'],\r\n    [10 ** 15, 'P'],\r\n    [10 ** 18, 'E']\r\n] as const;\r\n"]}

package/dist/esm/unit-scale/volt/index.d.ts

@@ -0,0 +1,9 @@
+import { UnitScale } from '../index.js';
+/**
+ * Voltage unit scale
+ */
+declare class UnitScaleVolt extends UnitScale {
+    constructor();
+}
+export declare const unitScaleVolt: UnitScaleVolt;
+export {};

package/dist/esm/unit-scale/volt/index.js

@@ -0,0 +1,24 @@
+import { ScaledUnit } from '../../scaled-unit/index.js';
+import { UnitScale } from '../index.js';
+import { metricPrefixes } from '../utilities/metric-prefixes.js';
+import { ScaledUnitFormatManuallyTranslated, UnitTranslation } from '../../scaled-unit-format/manually-translated/index.js';
+const unitTranslations = new Map([
+    ['en', new UnitTranslation('volt', 'volts', 'V')],
+    ['fr', new UnitTranslation('volt', 'volts', 'V')],
+    ['de', new UnitTranslation('Volt', 'Volt', 'V')],
+    ['ja', new UnitTranslation('ボルト', 'ボルト', 'V')],
+    ['zh', new UnitTranslation('伏特', '伏特', 'V')]
+]);
+/**
+ * Voltage unit scale
+ */
+class UnitScaleVolt extends UnitScale {
+    constructor() {
+        super(metricPrefixes.map(([scaleFactor, scaledPrefixText]) => new ScaledUnit(scaleFactor, ScaledUnitFormatManuallyTranslated.createFactory({
+            unitTranslations,
+            scaledPrefixText
+        }))));
+    }
+}
+export const unitScaleVolt = new UnitScaleVolt();
+//# sourceMappingURL=index.js.map

package/dist/esm/unit-scale/volt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unit-scale/volt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EACH,kCAAkC,EAElC,eAAe,EAClB,MAAM,uDAAuD,CAAC;AAE/D,MAAM,gBAAgB,GAAqB,IAAI,GAAG,CAAC;IAC/C,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,aAAc,SAAQ,SAAS;IACjC;QACI,KAAK,CACD,cAAc,CAAC,GAAG,CACd,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,CAC/C,WAAW,EACX,kCAAkC,CAAC,aAAa,CAAC;YAC7C,gBAAgB;YAChB,gBAAgB;SACnB,CAAC,CACL,CACJ,CACJ,CAAC;IACN,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC","sourcesContent":["import { ScaledUnit } from '../../scaled-unit/index.js';\r\nimport { UnitScale } from '../index.js';\r\nimport { metricPrefixes } from '../utilities/metric-prefixes.js';\r\nimport {\r\n    ScaledUnitFormatManuallyTranslated,\r\n    type UnitTranslations,\r\n    UnitTranslation\r\n} from '../../scaled-unit-format/manually-translated/index.js';\r\n\r\nconst unitTranslations: UnitTranslations = new Map([\r\n    ['en', new UnitTranslation('volt', 'volts', 'V')],\r\n    ['fr', new UnitTranslation('volt', 'volts', 'V')],\r\n    ['de', new UnitTranslation('Volt', 'Volt', 'V')],\r\n    ['ja', new UnitTranslation('ボルト', 'ボルト', 'V')],\r\n    ['zh', new UnitTranslation('伏特', '伏特', 'V')]\r\n]);\r\n\r\n/**\r\n * Voltage unit scale\r\n */\r\nclass UnitScaleVolt extends UnitScale {\r\n    public constructor() {\r\n        super(\r\n            metricPrefixes.map(\r\n                ([scaleFactor, scaledPrefixText]) => new ScaledUnit(\r\n                    scaleFactor,\r\n                    ScaledUnitFormatManuallyTranslated.createFactory({\r\n                        unitTranslations,\r\n                        scaledPrefixText\r\n                    })\r\n                )\r\n            )\r\n        );\r\n    }\r\n}\r\n\r\nexport const unitScaleVolt = new UnitScaleVolt();\r\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ni/unit-format",
+  "version": "0.0.1",
+  "description": "NumberFormat aligned library to format numbers with scaled units.",
+  "keywords": [
+    "units", "formatting", "nimble", "engineering", "metric", "si", "volts", "degrees", "bytes"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "lint": "eslint .",
+    "format": "eslint . --fix",
+    "pack": "npm pack",
+    "invoke-publish": "npm publish",
+    "tdd": "npm run build && npm run test",
+    "test": "npm run test:node && npm run test:browser",
+    "test:node": "jasmine",
+    "test:browser": "karma start karma.conf.cjs --browsers=ChromeHeadlessOpt --single-run",
+    "test:browser:debugger": "karma start karma.conf.cjs --browsers=ChromeDebugging"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ni/nimble.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+      "./package.json": "./package.json",
+      ".": {
+        "types": "./dist/esm/index.d.ts",
+        "import": "./dist/esm/index.js"
+      },
+      "./*": {
+        "types": "./dist/esm/*.d.ts",
+        "import": "./dist/esm/*/index.js"
+      }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/esm/*",
+        "dist/esm/*/index.d.ts"
+      ]
+    }
+  },
+  "author": "National Instruments",
+  "license": "MIT",
+  "devDependencies": {
+    "@ni/jasmine-parameterized": "^1.0.7",
+    "@ni-private/eslint-config-nimble": "*",
+    "@types/jasmine": "^5.1.4",
+    "jasmine": "^5.1.0",
+    "jasmine-core": "^5.1.2",
+    "karma": "^6.3.0",
+    "karma-chrome-launcher": "^3.1.0",
+    "karma-jasmine": "^5.1.0",
+    "karma-jasmine-html-reporter": "^2.0.0",
+    "karma-spec-reporter": "^0.0.36",
+    "karma-vite": "^1.0.5",
+    "playwright": "1.54.1",
+    "typescript": "~5.8.3"
+  }
+}