@cloudflare/util-formatters 2.6.14 → 2.7.2

package/CHANGELOG.md

@@ -3,6 +3,41 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.7.2](http://stash.cfops.it:7999/fe/stratus/compare/@cloudflare/util-formatters@2.7.1...@cloudflare/util-formatters@2.7.2) (2022-02-14)
+
+**Note:** Version bump only for package @cloudflare/util-formatters
+
+
+
+
+
+## [2.7.1](http://stash.cfops.it:7999/fe/stratus/compare/@cloudflare/util-formatters@2.7.0...@cloudflare/util-formatters@2.7.1) (2021-12-06)
+
+**Note:** Version bump only for package @cloudflare/util-formatters
+
+
+
+
+
+# [2.7.0](http://stash.cfops.it:7999/fe/stratus/compare/@cloudflare/util-formatters@2.6.15...@cloudflare/util-formatters@2.7.0) (2021-11-29)
+
+
+### Features
+
+* **stratus:** EW-5929 Integrate percentage view for chart legend ([7fecfd9](http://stash.cfops.it:7999/fe/stratus/commits/7fecfd9))
+
+
+
+
+
+## [2.6.15](http://stash.cfops.it:7999/fe/stratus/compare/@cloudflare/util-formatters@2.6.14...@cloudflare/util-formatters@2.6.15) (2021-11-23)
+
+**Note:** Version bump only for package @cloudflare/util-formatters
+
+
+
+
+
 ## [2.6.14](http://stash.cfops.it:7999/fe/stratus/compare/@cloudflare/util-formatters@2.6.13...@cloudflare/util-formatters@2.6.14) (2021-11-22)
 
 **Note:** Version bump only for package @cloudflare/util-formatters

package/dist/formatters.d.ts

@@ -67,3 +67,5 @@ export declare const formatBits: (number: number, locale: SupportedLocales | und
  */
 export declare const formatNumberForAnalytics: (number: number, locale?: SupportedLocales, useSI?: boolean, decimalPlaces?: number, trimInsignificantZeros?: boolean) => string;
 export declare const capitalizeStr: (str: string) => string | undefined;
+export declare const formatPercentage: (value: number, total: number) => string;
+export declare const roundPercentage: (val: number, roundDecimalCases?: number, locale?: SupportedLocales) => string;

package/es/formatters.js

@@ -163,4 +163,27 @@ export const formatBits = (number, locale = DEFAULT_LOCALE, includeDecimals, use
 export const formatNumberForAnalytics = (number, locale = DEFAULT_LOCALE, useSI = false, decimalPlaces = 2, trimInsignificantZeros = true) => {
   return formatNumber(number, locale, useSI, decimalPlaces, trimInsignificantZeros);
 };
-export const capitalizeStr = str => str && str.charAt(0).toUpperCase() + str.slice(1);
+export const capitalizeStr = str => str && str.charAt(0).toUpperCase() + str.slice(1);
+export const formatPercentage = (value, total) => `${Math.round(value * 100 / total * 100) / 100}%`;
+export const roundPercentage = (val, roundDecimalCases = 0, locale = DEFAULT_LOCALE) => {
+  const roundDiv = Math.pow(10, roundDecimalCases); // Treat ~0% and ~100% values specially so the precision is surfaced
+
+  let localizedString = '';
+
+  if (val > 99) {
+    // Edge case: between 99 and 100, produce values with precision like this:
+    // 99.999735 --> 99.9997
+    localizedString = localizeNumberWithPrecision(100 - +(100 - val).toPrecision(1), locale);
+  } else if (val < 1) {
+    // Edge case: between 0 and 1, produce values with the precision of one
+    // significant digit:
+    // 0.000273 --> 0.0003
+    localizedString = localizeNumberWithPrecision(+val.toPrecision(1), locale);
+  } else {
+    // In all other cases, round to the nearest integer:
+    // 78.612 --> 79
+    localizedString = formatNumberForAnalytics(val * roundDiv / roundDiv, locale, false, roundDecimalCases);
+  }
+
+  return localizedString + '%';
+};

package/lib/formatters.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.capitalizeStr = exports.formatNumberForAnalytics = exports.formatBits = exports.formatBytes = exports.formatCurrency = exports.formatNumber = exports.localizeNumberWithPrecision = exports.formatDate = exports.DateFormatters = void 0;
+exports.roundPercentage = exports.formatPercentage = exports.capitalizeStr = exports.formatNumberForAnalytics = exports.formatBits = exports.formatBytes = exports.formatCurrency = exports.formatNumber = exports.localizeNumberWithPrecision = exports.formatDate = exports.DateFormatters = void 0;
 
 var _d3Format = require("d3-format");
 
@@ -221,4 +221,37 @@ var capitalizeStr = function capitalizeStr(str) {
   return str && str.charAt(0).toUpperCase() + str.slice(1);
 };
 
-exports.capitalizeStr = capitalizeStr;
+exports.capitalizeStr = capitalizeStr;
+
+var formatPercentage = function formatPercentage(value, total) {
+  return "".concat(Math.round(value * 100 / total * 100) / 100, "%");
+};
+
+exports.formatPercentage = formatPercentage;
+
+var roundPercentage = function roundPercentage(val) {
+  var roundDecimalCases = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  var locale = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : DEFAULT_LOCALE;
+  var roundDiv = Math.pow(10, roundDecimalCases); // Treat ~0% and ~100% values specially so the precision is surfaced
+
+  var localizedString = '';
+
+  if (val > 99) {
+    // Edge case: between 99 and 100, produce values with precision like this:
+    // 99.999735 --> 99.9997
+    localizedString = localizeNumberWithPrecision(100 - +(100 - val).toPrecision(1), locale);
+  } else if (val < 1) {
+    // Edge case: between 0 and 1, produce values with the precision of one
+    // significant digit:
+    // 0.000273 --> 0.0003
+    localizedString = localizeNumberWithPrecision(+val.toPrecision(1), locale);
+  } else {
+    // In all other cases, round to the nearest integer:
+    // 78.612 --> 79
+    localizedString = formatNumberForAnalytics(val * roundDiv / roundDiv, locale, false, roundDecimalCases);
+  }
+
+  return localizedString + '%';
+};
+
+exports.roundPercentage = roundPercentage;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cloudflare/util-formatters",
   "description": "",
-  "version": "2.6.14",
+  "version": "2.7.2",
   "types": "./dist/index.d.ts",
   "main": "lib/index.js",
   "module": "es/index.js",
@@ -17,9 +17,9 @@
     "autoGeneratedReadme": true
   },
   "dependencies": {
-    "@cloudflare/intl-core": "^1.10.3",
+    "@cloudflare/intl-core": "^1.10.4",
     "d3-format": "^1.3.2",
-    "moment": "^2.22.1"
+    "moment": "^2.29.1"
   },
-  "gitHead": "569113c2ab73ce93969008d15ad9e6648d0d3ed0"
+  "gitHead": "e291d1ce7d364a3bdc62b63aaf17a0164e3abce0"
 }