@ni/nimble-components 21.6.7 → 21.7.0

package/dist/esm/utilities/unit-format/default-unit-format.d.ts

@@ -13,13 +13,10 @@ export declare class DefaultUnitFormat extends UnitFormat {
     private readonly unitScale;
     private readonly defaultIntlNumberFormatOptions;
     private readonly defaultScaledUnitFormatters;
-    private readonly leadingZeroIntlNumberFormatOptions;
-    private readonly leadingZeroScaledUnitFormatters;
     private readonly exponentialIntlNumberFormatOptions;
     private readonly exponentialScaledUnitFormatter;
     constructor(locale: string, { unitScale }?: DefaultUnitFormatOptions);
     resolvedOptions(): ResolvedDefaultUnitFormatOptions;
     protected tryFormat(number: number): string;
-    private resolveNumberStyle;
 }
 export {};

package/dist/esm/utilities/unit-format/default-unit-format.js

@@ -1,5 +1,9 @@
 import { UnitFormat } from './unit-format';
 import { passthroughUnitScale } from './unit-scale/passthrough-unit-scale';
+// 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.
@@ -9,35 +13,26 @@ export class DefaultUnitFormat extends UnitFormat {
         unitScale: passthroughUnitScale
     }) {
         super();
-        // Format options to use by default. It renders the number with a maximum of 6 signficant digits.
+        // 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: DefaultUnitFormat.maximumDigits,
-            useGrouping: true
-        };
-        this.defaultScaledUnitFormatters = new Map();
-        // Format options to use for numbers that have leading zeros. It limits the number of rendered
-        // digits using 'maximumFractionDigits', which will result in less than 6 significant digits
-        // in order to render no more than 6 total digits.
-        this.leadingZeroIntlNumberFormatOptions = {
             maximumFractionDigits: DefaultUnitFormat.maximumDigits - 1,
-            useGrouping: true
+            roundingPriority: 'lessPrecision',
+            signDisplay
         };
-        this.leadingZeroScaledUnitFormatters = new Map();
+        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: DefaultUnitFormat.maximumDigits,
-            notation: 'scientific'
+            notation: 'scientific',
+            signDisplay
         };
         for (const unit of unitScale.supportedScaledUnits) {
             this.defaultScaledUnitFormatters.set(unit.scaleFactor, unit.scaledUnitFormatFactory({
                 locale,
                 intlNumberFormatOptions: this.defaultIntlNumberFormatOptions
             }));
-            this.leadingZeroScaledUnitFormatters.set(unit.scaleFactor, unit.scaledUnitFormatFactory({
-                locale,
-                intlNumberFormatOptions: this.leadingZeroIntlNumberFormatOptions
-            }));
         }
         this.exponentialScaledUnitFormatter = unitScale.baseScaledUnit.scaledUnitFormatFactory({
             locale,
@@ -51,43 +46,16 @@ export class DefaultUnitFormat extends UnitFormat {
         };
     }
     tryFormat(number) {
-        // Normalize +0 / -0 --> +0
-        const numberNormalized = number === 0 ? 0 : number;
-        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(numberNormalized);
-        const numberStyle = this.resolveNumberStyle(scaledValue);
-        switch (numberStyle) {
-            case 'default': {
-                const scaledUnitFormatter = this.defaultScaledUnitFormatters.get(scaledUnit.scaleFactor);
-                return scaledUnitFormatter.format(scaledValue);
-            }
-            case 'leadingZero': {
-                const scaledUnitFormatter = this.leadingZeroScaledUnitFormatters.get(scaledUnit.scaleFactor);
-                return scaledUnitFormatter.format(scaledValue);
-            }
-            case 'exponential': {
-                const scaledUnitFormatter = this.exponentialScaledUnitFormatter;
-                return scaledUnitFormatter.format(numberNormalized);
-            }
-            default:
-                throw new Error('Unexpected number format style');
-        }
-    }
-    resolveNumberStyle(number) {
-        if (number === 0) {
-            return 'default';
-        }
-        const absoluteValue = Math.abs(number);
-        if (absoluteValue >= DefaultUnitFormat.exponentialUpperBound
-            || absoluteValue < DefaultUnitFormat.exponentialLowerBound) {
-            return 'exponential';
-        }
-        // Ideally, we could set 'roundingPriority: "lessPrecision"' with a formatter that has both 'maximumSignificantDigits' and
-        // 'maximumFractionDigits' configured instead of having two different formatters that we conditionally choose between. However,
-        // 'roundingPrioirty' is not supported yet in all browsers.
-        if (absoluteValue < 1) {
-            return 'leadingZero';
-        }
-        return 'default';
+        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(number);
+        const absoluteValue = Math.abs(scaledValue);
+        const useExponential = absoluteValue !== 0
+            && (absoluteValue >= DefaultUnitFormat.exponentialUpperBound
+                || absoluteValue < DefaultUnitFormat.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.

package/dist/esm/utilities/unit-format/default-unit-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-unit-format.js","sourceRoot":"","sources":["../../../../src/utilities/unit-format/default-unit-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAS3E;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAgD7C,YACI,MAAc,EACd,EAAE,SAAS,GAAG,oBAAoB,KAA+B;QAC7D,SAAS,EAAE,oBAAoB;KAClC;QAED,KAAK,EAAE,CAAC;QAvCZ,iGAAiG;QAChF,mCAA8B,GAA6B;YACxE,wBAAwB,EAAE,iBAAiB,CAAC,aAAa;YACzD,WAAW,EAAE,IAAI;SACpB,CAAC;QAEe,gCAA2B,GAAG,IAAI,GAAG,EAGnD,CAAC;QAEJ,8FAA8F;QAC9F,4FAA4F;QAC5F,kDAAkD;QACjC,uCAAkC,GAA6B;YAC5E,qBAAqB,EAAE,iBAAiB,CAAC,aAAa,GAAG,CAAC;YAC1D,WAAW,EAAE,IAAI;SACpB,CAAC;QAEe,oCAA+B,GAAG,IAAI,GAAG,EAGvD,CAAC;QAEJ,mGAAmG;QACnG,6FAA6F;QAC5E,uCAAkC,GAA6B;YAC5E,wBAAwB,EAAE,iBAAiB,CAAC,aAAa;YACzD,QAAQ,EAAE,YAAY;SACzB,CAAC;QAWE,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,oBAAoB,EAAE;YAC/C,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;YACF,IAAI,CAAC,+BAA+B,CAAC,GAAG,CACpC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,uBAAuB,CAAC;gBACzB,MAAM;gBACN,uBAAuB,EACnB,IAAI,CAAC,kCAAkC;aAC9C,CAAC,CACL,CAAC;SACL;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,2BAA2B;QAC3B,MAAM,gBAAgB,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAEnD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QAEjF,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACzD,QAAQ,WAAW,EAAE;YACjB,KAAK,SAAS,CAAC,CAAC;gBACZ,MAAM,mBAAmB,GAAG,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAC5D,UAAU,CAAC,WAAW,CACxB,CAAC;gBACH,OAAO,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;aAClD;YACD,KAAK,aAAa,CAAC,CAAC;gBAChB,MAAM,mBAAmB,GAAG,IAAI,CAAC,+BAA+B,CAAC,GAAG,CAChE,UAAU,CAAC,WAAW,CACxB,CAAC;gBACH,OAAO,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;aAClD;YACD,KAAK,aAAa,CAAC,CAAC;gBAChB,MAAM,mBAAmB,GAAG,IAAI,CAAC,8BAA8B,CAAC;gBAChE,OAAO,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;aACvD;YACD;gBACI,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;SACzD;IACL,CAAC;IAEO,kBAAkB,CAAC,MAAc;QACrC,IAAI,MAAM,KAAK,CAAC,EAAE;YACd,OAAO,SAAS,CAAC;SACpB;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IACI,aAAa,IAAI,iBAAiB,CAAC,qBAAqB;eACrD,aAAa,GAAG,iBAAiB,CAAC,qBAAqB,EAC5D;YACE,OAAO,aAAa,CAAC;SACxB;QACD,0HAA0H;QAC1H,+HAA+H;QAC/H,2DAA2D;QAC3D,IAAI,aAAa,GAAG,CAAC,EAAE;YACnB,OAAO,aAAa,CAAC;SACxB;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;;AApID,4EAA4E;AACpD,+BAAa,GAAG,CAAC,CAAC;AAE1C,wFAAwF;AACxF,0FAA0F;AAC1F,yEAAyE;AACjD,uCAAqB,GAAG,QAAQ,CAAC;AAEzD,uFAAuF;AACvF,yBAAyB;AACD,uCAAqB,GAAG,QAAQ,CAAC","sourcesContent":["import { UnitFormat, UnitFormatOptions } from './unit-format';\nimport type { ScaledUnitFormat } from './scaled-unit-format/scaled-unit-format';\nimport type { UnitScale } from './unit-scale/unit-scale';\nimport { passthroughUnitScale } from './unit-scale/passthrough-unit-scale';\n\ntype NumberStyle = 'default' | 'leadingZero' | 'exponential';\n\n// Allow consistent pattern for defining Options and ResolvedOptions\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\ninterface DefaultUnitFormatOptions extends UnitFormatOptions {}\ntype ResolvedDefaultUnitFormatOptions = Required<DefaultUnitFormatOptions>;\n\n/**\n * Format for numbers with units to show in a tabular form.\n * Large and tiny numbers are shown exponentially and the rest as decimal.\n */\nexport class DefaultUnitFormat extends UnitFormat {\n    // The maximum number of digits that should be rendered for any given value.\n    private static readonly maximumDigits = 6;\n\n    // Use exponential notation for numbers that will be rendered with 3 leading 0s or more.\n    // Because a maximum of 6 digits are rendered, showing more than 3 leading 0s is not ideal\n    // because then at least half of the displayed digits will be leading 0s.\n    private static readonly exponentialLowerBound = 0.000995;\n\n    // Use exponential formatting for numbers whose magnitude cannot otherwise be displayed\n    // with 6 digits or less.\n    private static readonly exponentialUpperBound = 999999.5;\n\n    private readonly unitScale: UnitScale;\n\n    // Format options to use by default. It renders the number with a maximum of 6 signficant digits.\n    private readonly defaultIntlNumberFormatOptions: Intl.NumberFormatOptions = {\n        maximumSignificantDigits: DefaultUnitFormat.maximumDigits,\n        useGrouping: true\n    };\n\n    private readonly defaultScaledUnitFormatters = new Map<\n    number,\n    ScaledUnitFormat\n    >();\n\n    // Format options to use for numbers that have leading zeros. It limits the number of rendered\n    // digits using 'maximumFractionDigits', which will result in less than 6 significant digits\n    // in order to render no more than 6 total digits.\n    private readonly leadingZeroIntlNumberFormatOptions: Intl.NumberFormatOptions = {\n        maximumFractionDigits: DefaultUnitFormat.maximumDigits - 1,\n        useGrouping: true\n    };\n\n    private readonly leadingZeroScaledUnitFormatters = new Map<\n    number,\n    ScaledUnitFormat\n    >();\n\n    // Format options for numbers that should be displayed in exponential notation. This should be used\n    // for numbers with magintudes over 'exponentialUpperBound' or under 'exponentialLowerBound'.\n    private readonly exponentialIntlNumberFormatOptions: Intl.NumberFormatOptions = {\n        maximumSignificantDigits: DefaultUnitFormat.maximumDigits,\n        notation: 'scientific'\n    };\n\n    private readonly exponentialScaledUnitFormatter: ScaledUnitFormat;\n\n    public constructor(\n        locale: string,\n        { unitScale = passthroughUnitScale }: DefaultUnitFormatOptions = {\n            unitScale: passthroughUnitScale\n        }\n    ) {\n        super();\n        for (const unit of unitScale.supportedScaledUnits) {\n            this.defaultScaledUnitFormatters.set(\n                unit.scaleFactor,\n                unit.scaledUnitFormatFactory({\n                    locale,\n                    intlNumberFormatOptions: this.defaultIntlNumberFormatOptions\n                })\n            );\n            this.leadingZeroScaledUnitFormatters.set(\n                unit.scaleFactor,\n                unit.scaledUnitFormatFactory({\n                    locale,\n                    intlNumberFormatOptions:\n                        this.leadingZeroIntlNumberFormatOptions\n                })\n            );\n        }\n        this.exponentialScaledUnitFormatter = unitScale.baseScaledUnit.scaledUnitFormatFactory({\n            locale,\n            intlNumberFormatOptions: this.exponentialIntlNumberFormatOptions\n        });\n        this.unitScale = unitScale;\n    }\n\n    public override resolvedOptions(): ResolvedDefaultUnitFormatOptions {\n        return {\n            unitScale: this.unitScale\n        };\n    }\n\n    protected tryFormat(number: number): string {\n        // Normalize +0 / -0 --> +0\n        const numberNormalized = number === 0 ? 0 : number;\n\n        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(numberNormalized);\n\n        const numberStyle = this.resolveNumberStyle(scaledValue);\n        switch (numberStyle) {\n            case 'default': {\n                const scaledUnitFormatter = this.defaultScaledUnitFormatters.get(\n                    scaledUnit.scaleFactor\n                )!;\n                return scaledUnitFormatter.format(scaledValue);\n            }\n            case 'leadingZero': {\n                const scaledUnitFormatter = this.leadingZeroScaledUnitFormatters.get(\n                    scaledUnit.scaleFactor\n                )!;\n                return scaledUnitFormatter.format(scaledValue);\n            }\n            case 'exponential': {\n                const scaledUnitFormatter = this.exponentialScaledUnitFormatter;\n                return scaledUnitFormatter.format(numberNormalized);\n            }\n            default:\n                throw new Error('Unexpected number format style');\n        }\n    }\n\n    private resolveNumberStyle(number: number): NumberStyle {\n        if (number === 0) {\n            return 'default';\n        }\n\n        const absoluteValue = Math.abs(number);\n        if (\n            absoluteValue >= DefaultUnitFormat.exponentialUpperBound\n            || absoluteValue < DefaultUnitFormat.exponentialLowerBound\n        ) {\n            return 'exponential';\n        }\n        // Ideally, we could set 'roundingPriority: \"lessPrecision\"' with a formatter that has both 'maximumSignificantDigits' and\n        // 'maximumFractionDigits' configured instead of having two different formatters that we conditionally choose between. However,\n        // 'roundingPrioirty' is not supported yet in all browsers.\n        if (absoluteValue < 1) {\n            return 'leadingZero';\n        }\n        return 'default';\n    }\n}\n"]}
+{"version":3,"file":"default-unit-format.js","sourceRoot":"","sources":["../../../../src/utilities/unit-format/default-unit-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,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;YAC/C,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;SACL;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,CAAC;AAE1C,wFAAwF;AACxF,0FAA0F;AAC1F,yEAAyE;AACjD,uCAAqB,GAAG,QAAQ,CAAC;AAEzD,uFAAuF;AACvF,yBAAyB;AACD,uCAAqB,GAAG,QAAQ,CAAC","sourcesContent":["import { UnitFormat, UnitFormatOptions } from './unit-format';\nimport type { ScaledUnitFormat } from './scaled-unit-format/scaled-unit-format';\nimport type { UnitScale } from './unit-scale/unit-scale';\nimport { passthroughUnitScale } from './unit-scale/passthrough-unit-scale';\n\n// Workaround to avoid ts errors about signDisplay not accepting the value 'negative'.\n// It has been supported by browsers since 8/23, but TypeScript still hasn't\n// added it to the type definitions. See https://github.com/microsoft/TypeScript/issues/56269\nconst signDisplay = 'negative' as Intl.NumberFormatOptions['signDisplay'];\n\n// Allow consistent pattern for defining Options and ResolvedOptions\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\ninterface DefaultUnitFormatOptions extends UnitFormatOptions {}\ntype ResolvedDefaultUnitFormatOptions = Required<DefaultUnitFormatOptions>;\n\n/**\n * Format for numbers with units to show in a tabular form.\n * Large and tiny numbers are shown exponentially and the rest as decimal.\n */\nexport class DefaultUnitFormat extends UnitFormat {\n    // The maximum number of digits that should be rendered for any given value.\n    private static readonly maximumDigits = 6;\n\n    // Use exponential notation for numbers that will be rendered with 3 leading 0s or more.\n    // Because a maximum of 6 digits are rendered, showing more than 3 leading 0s is not ideal\n    // because then at least half of the displayed digits will be leading 0s.\n    private static readonly exponentialLowerBound = 0.000995;\n\n    // Use exponential formatting for numbers whose magnitude cannot otherwise be displayed\n    // with 6 digits or less.\n    private static readonly exponentialUpperBound = 999999.5;\n\n    private readonly unitScale: UnitScale;\n    // Format options to use by default. It renders the number with a maximum of 6 signficant digits (including zero before decimal point).\n    private readonly defaultIntlNumberFormatOptions: Intl.NumberFormatOptions = {\n        maximumSignificantDigits: DefaultUnitFormat.maximumDigits,\n        maximumFractionDigits: DefaultUnitFormat.maximumDigits - 1,\n        roundingPriority: 'lessPrecision',\n        signDisplay\n    };\n\n    private readonly defaultScaledUnitFormatters = new Map<\n    number,\n    ScaledUnitFormat\n    >();\n\n    // Format options for numbers that should be displayed in exponential notation. This should be used\n    // for numbers with magintudes over 'exponentialUpperBound' or under 'exponentialLowerBound'.\n    private readonly exponentialIntlNumberFormatOptions: Intl.NumberFormatOptions = {\n        maximumSignificantDigits: DefaultUnitFormat.maximumDigits,\n        notation: 'scientific',\n        signDisplay\n    };\n\n    private readonly exponentialScaledUnitFormatter: ScaledUnitFormat;\n\n    public constructor(\n        locale: string,\n        { unitScale = passthroughUnitScale }: DefaultUnitFormatOptions = {\n            unitScale: passthroughUnitScale\n        }\n    ) {\n        super();\n        for (const unit of unitScale.supportedScaledUnits) {\n            this.defaultScaledUnitFormatters.set(\n                unit.scaleFactor,\n                unit.scaledUnitFormatFactory({\n                    locale,\n                    intlNumberFormatOptions: this.defaultIntlNumberFormatOptions\n                })\n            );\n        }\n        this.exponentialScaledUnitFormatter = unitScale.baseScaledUnit.scaledUnitFormatFactory({\n            locale,\n            intlNumberFormatOptions: this.exponentialIntlNumberFormatOptions\n        });\n        this.unitScale = unitScale;\n    }\n\n    public override resolvedOptions(): ResolvedDefaultUnitFormatOptions {\n        return {\n            unitScale: this.unitScale\n        };\n    }\n\n    protected tryFormat(number: number): string {\n        const { scaledValue, scaledUnit } = this.unitScale.scaleNumber(number);\n\n        const absoluteValue = Math.abs(scaledValue);\n        const useExponential = absoluteValue !== 0\n            && (absoluteValue >= DefaultUnitFormat.exponentialUpperBound\n                || absoluteValue < DefaultUnitFormat.exponentialLowerBound);\n        return useExponential\n            ? this.exponentialScaledUnitFormatter.format(number)\n            : this.defaultScaledUnitFormatters\n                .get(scaledUnit.scaleFactor)!\n                .format(scaledValue);\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ni/nimble-components",
-  "version": "21.6.7",
+  "version": "21.7.0",
   "description": "Styled web components for the NI Nimble Design System",
   "scripts": {
     "build": "npm run generate-icons && npm run build-components && npm run bundle-components && npm run generate-scss && npm run build-storybook",
@@ -64,7 +64,7 @@
     "@microsoft/fast-element": "^1.12.0",
     "@microsoft/fast-foundation": "2.49.4",
     "@microsoft/fast-web-utilities": "^6.0.0",
-    "@ni/nimble-tokens": "^6.11.1",
+    "@ni/nimble-tokens": "^6.12.0",
     "@tanstack/table-core": "^8.10.7",
     "@tanstack/virtual-core": "^3.0.0-beta.68",
     "@tiptap/core": "^2.2.2",