@d3plus/format 3.0.16 → 3.1.0

package/umd/d3plus-format.full.js

@@ -4,110 +4,6 @@
   Copyright (c) 2026 D3plus - https://d3plus.org
   @license MIT
 */
-
-(function (factory) {
-  typeof define === 'function' && define.amd ? define(factory) :
-  factory();
-})((function () { 'use strict';
-
-  if (typeof window !== "undefined") {
-    (function () {
-      try {
-        if (typeof SVGElement === 'undefined' || Boolean(SVGElement.prototype.innerHTML)) {
-          return;
-        }
-      } catch (e) {
-          return;
-      }
-
-      function serializeNode (node) {
-        switch (node.nodeType) {
-          case 1:
-            return serializeElementNode(node);
-          case 3:
-            return serializeTextNode(node);
-          case 8:
-            return serializeCommentNode(node);
-        }
-      }
-
-      function serializeTextNode (node) {
-          return node.textContent.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-      }
-
-      function serializeCommentNode (node) {
-          return '<!--' + node.nodeValue + '-->'
-      }
-
-      function serializeElementNode (node) {
-          var output = '';
-
-          output += '<' + node.tagName;
-
-          if (node.hasAttributes()) {
-              [].forEach.call(node.attributes, function(attrNode) {
-                  output += ' ' + attrNode.name + '="' + attrNode.value + '"';
-              });
-          }
-
-          output += '>';
-
-          if (node.hasChildNodes()) {
-              [].forEach.call(node.childNodes, function(childNode) {
-                  output += serializeNode(childNode);
-              });
-          }
-
-          output += '</' + node.tagName + '>';
-
-          return output;
-      }
-
-      Object.defineProperty(SVGElement.prototype, 'innerHTML', {
-        get: function () {
-          var output = '';
-
-          [].forEach.call(this.childNodes, function(childNode) {
-              output += serializeNode(childNode);
-          });
-
-          return output;
-        },
-        set: function (markup) {
-          while (this.firstChild) {
-            this.removeChild(this.firstChild);
-          }
-
-          try {
-            var dXML = new DOMParser();
-            dXML.async = false;
-
-            var sXML = '<svg xmlns=\'http://www.w3.org/2000/svg\' xmlns:xlink=\'http://www.w3.org/1999/xlink\'>' + markup + '</svg>';
-            var svgDocElement = dXML.parseFromString(sXML, 'text/xml').documentElement;
-
-            [].forEach.call(svgDocElement.childNodes, function(childNode) {
-                this.appendChild(this.ownerDocument.importNode(childNode, true));
-            }.bind(this));
-          } catch (e) {
-              throw new Error('Error parsing markup string');
-          }
-        }
-      });
-
-      Object.defineProperty(SVGElement.prototype, 'innerSVG', {
-        get: function () {
-          return this.innerHTML;
-        },
-        set: function (markup) {
-          this.innerHTML = markup;
-        }
-      });
-
-    })();
-  }
-
-}));
-
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
   typeof define === 'function' && define.amd ? define('@d3plus/format', ['exports'], factory) :
@@ -120,8 +16,8 @@
   // significant digits p, where x is positive and p is in [1, 21] or undefined.
   // For example, formatDecimalParts(1.23) returns ["123", 0].
   function formatDecimalParts(x, p) {
-      if ((i = (x = p ? x.toExponential(p - 1) : x.toExponential()).indexOf("e")) < 0) return null; // NaN, ±Infinity
-      var i, coefficient = x.slice(0, i);
+      if (!isFinite(x) || x === 0) return null; // NaN, ±Infinity, ±0
+      var i = (x = p ? x.toExponential(p - 1) : x.toExponential()).indexOf("e"), coefficient = x.slice(0, i);
       // The string returned by toExponential either has the form \d\.\d+e[-+]\d+
       // (e.g., 1.2e+3) or the form \de[-+]\d+ (e.g., 1e+3).
       return [
@@ -213,7 +109,7 @@
   var prefixExponent;
   function formatPrefixAuto(x, p) {
       var d = formatDecimalParts(x, p);
-      if (!d) return x + "";
+      if (!d) return prefixExponent = undefined, x.toPrecision(p);
       var coefficient = d[0], exponent = d[1], i = exponent - (prefixExponent = Math.max(-8, Math.min(8, Math.floor(exponent / 3))) * 3) + 1, n = coefficient.length;
       return i === n ? coefficient : i > n ? coefficient + new Array(i - n + 1).join("0") : i > 0 ? coefficient.slice(0, i) + "." + coefficient.slice(i) : "0." + new Array(1 - i).join("0") + formatDecimalParts(x, Math.max(0, p + i - 1))[0]; // less than 1y!
   }
@@ -264,9 +160,9 @@
       "Z",
       "Y"
   ];
-  function formatLocale$1(locale) {
+  function formatLocale$2(locale) {
       var group = locale.grouping === undefined || locale.thousands === undefined ? identity : formatGroup(map.call(locale.grouping, Number), locale.thousands + ""), currencyPrefix = locale.currency === undefined ? "" : locale.currency[0] + "", currencySuffix = locale.currency === undefined ? "" : locale.currency[1] + "", decimal = locale.decimal === undefined ? "." : locale.decimal + "", numerals = locale.numerals === undefined ? identity : formatNumerals(map.call(locale.numerals, String)), percent = locale.percent === undefined ? "%" : locale.percent + "", minus = locale.minus === undefined ? "−" : locale.minus + "", nan = locale.nan === undefined ? "NaN" : locale.nan + "";
-      function newFormat(specifier) {
+      function newFormat(specifier, options) {
           specifier = formatSpecifier(specifier);
           var fill = specifier.fill, align = specifier.align, sign = specifier.sign, symbol = specifier.symbol, zero = specifier.zero, width = specifier.width, comma = specifier.comma, precision = specifier.precision, trim = specifier.trim, type = specifier.type;
           // The "n" type is an alias for ",g".
@@ -276,7 +172,7 @@
           if (zero || fill === "0" && align === "=") zero = true, fill = "0", align = "=";
           // Compute the prefix and suffix.
           // For SI-prefix, the suffix is lazily computed.
-          var prefix = symbol === "$" ? currencyPrefix : symbol === "#" && /[boxX]/.test(type) ? "0" + type.toLowerCase() : "", suffix = symbol === "$" ? currencySuffix : /[%p]/.test(type) ? percent : "";
+          var prefix = (options && options.prefix !== undefined ? options.prefix : "") + (symbol === "$" ? currencyPrefix : symbol === "#" && /[boxX]/.test(type) ? "0" + type.toLowerCase() : ""), suffix = (symbol === "$" ? currencySuffix : /[%p]/.test(type) ? percent : "") + (options && options.suffix !== undefined ? options.suffix : "");
           // What format function should we use?
           // Is this an integer type?
           // Can this type generate exponential notation?
@@ -303,7 +199,7 @@
                   if (valueNegative && +value === 0 && sign !== "+") valueNegative = false;
                   // Compute the prefix and suffix.
                   valuePrefix = (valueNegative ? sign === "(" ? sign : minus : sign === "-" || sign === "(" ? "" : sign) + valuePrefix;
-                  valueSuffix = (type === "s" ? prefixes[8 + prefixExponent / 3] : "") + valueSuffix + (valueNegative && sign === "(" ? ")" : "");
+                  valueSuffix = (type === "s" && !isNaN(value) && prefixExponent !== undefined ? prefixes[8 + prefixExponent / 3] : "") + valueSuffix + (valueNegative && sign === "(" ? ")" : "");
                   // Break the formatted value into the integer “value” part that can be
                   // grouped, and fractional or exponential “suffix” part that is not.
                   if (maybeSuffix) {
@@ -346,9 +242,11 @@
           return format;
       }
       function formatPrefix(specifier, value) {
-          var f = newFormat((specifier = formatSpecifier(specifier), specifier.type = "f", specifier)), e = Math.max(-8, Math.min(8, Math.floor(exponent(value) / 3))) * 3, k = Math.pow(10, -e), prefix = prefixes[8 + e / 3];
+          var e = Math.max(-8, Math.min(8, Math.floor(exponent(value) / 3))) * 3, k = Math.pow(10, -e), f = newFormat((specifier = formatSpecifier(specifier), specifier.type = "f", specifier), {
+              suffix: prefixes[8 + e / 3]
+          });
           return function(value) {
-              return f(k * value) + prefix;
+              return f(k * value);
           };
       }
       return {
@@ -359,7 +257,7 @@
 
   var locale$1;
   var format$1;
-  defaultLocale$2({
+  defaultLocale$1({
       thousands: ",",
       grouping: [
           3
@@ -369,8 +267,8 @@
           ""
       ]
   });
-  function defaultLocale$2(definition) {
-      locale$1 = formatLocale$1(definition);
+  function defaultLocale$1(definition) {
+      locale$1 = formatLocale$2(definition);
       format$1 = locale$1.format;
       locale$1.formatPrefix;
       return locale$1;
@@ -378,8 +276,8 @@
 
   /**
       @namespace {Object} formatLocale
-      @desc A set of default locale formatters used when assigning suffixes and currency in numbers.
-  */ var defaultLocale$1 = {
+      A set of default locale formatters used when assigning suffixes and currency in numbers.
+  */ var formatLocale$1 = {
       "ar-SA": {
           separator: "",
           suffixes: [
@@ -389,17 +287,17 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
-              " ألف",
-              " مليون",
-              " بليون",
-              " تريليون",
-              " كوادريليون",
-              " كوينتيليون",
-              " سكستليون",
-              "سبتيليون"
+              " \u0623\u0644\u0641",
+              " \u0645\u0644\u064a\u0648\u0646",
+              " \u0628\u0644\u064a\u0648\u0646",
+              " \u062a\u0631\u064a\u0644\u064a\u0648\u0646",
+              " \u0643\u0648\u0627\u062f\u0631\u064a\u0644\u064a\u0648\u0646",
+              " \u0643\u0648\u064a\u0646\u062a\u064a\u0644\u064a\u0648\u0646",
+              " \u0633\u0643\u0633\u062a\u0644\u064a\u0648\u0646",
+              "\u0633\u0628\u062a\u064a\u0644\u064a\u0648\u0646"
           ],
           grouping: [
               3
@@ -422,7 +320,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "k",
@@ -442,7 +340,7 @@
               decimal: "."
           },
           currency: [
-              "£",
+              "\u00a3",
               ""
           ]
       },
@@ -455,7 +353,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "k",
@@ -488,7 +386,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               " thousand",
@@ -521,7 +419,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "k",
@@ -554,7 +452,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "k",
@@ -587,7 +485,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "k",
@@ -607,7 +505,7 @@
               decimal: ","
           },
           currency: [
-              "€",
+              "\u20ac",
               ""
           ]
       },
@@ -620,7 +518,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "tuhat",
@@ -652,7 +550,7 @@
               "f",
               "p",
               "n",
-              "µ",
+              "\u00b5",
               "m",
               "",
               "k",
@@ -672,30 +570,30 @@
               decimal: ","
           },
           currency: [
-              "€",
+              "\u20ac",
               ""
           ]
       },
       "zh-CN": {
           separator: "",
           suffixes: [
-              "幺",
-              "仄",
-              "阿",
-              "飞",
-              "皮",
-              "纳",
-              "微",
-              "毫",
+              "\u5e7a",
+              "\u4ed4",
+              "\u963f",
+              "\u98de",
+              "\u76ae",
+              "\u7eb3",
+              "\u5fae",
+              "\u6beb",
               "",
-              "千",
-              "兆",
-              "吉",
-              "太",
-              "拍",
-              "艾",
-              "泽",
-              "尧"
+              "\u5343",
+              "\u5146",
+              "\u5409",
+              "\u592a",
+              "\u62cd",
+              "\u827e",
+              "\u6cfd",
+              "\u5c27"
           ],
           grouping: [
               3
@@ -705,18 +603,18 @@
               decimal: "."
           },
           currency: [
-              "¥",
+              "\u00a5",
               ""
           ]
       }
   };
 
-  const round = (x, n)=>parseFloat(Math.round(x * Math.pow(10, n)) / Math.pow(10, n)).toFixed(n);
+  const round = (x, n)=>parseFloat((Math.round(x * Math.pow(10, n)) / Math.pow(10, n)).toString()).toFixed(n);
   /**
    * @private
-  */ function formatSuffix(str, precision, suffixes) {
+   */ function formatSuffix(str, precision, suffixes) {
       let i = 0;
-      let value = parseFloat(str.replace("−", "-"), 10);
+      let value = parseFloat(str.replace("\u2212", "-"));
       if (value) {
           if (value < 0) value *= -1;
           i = 1 + Math.floor(1e-12 + Math.log(value) / Math.LN10);
@@ -730,7 +628,7 @@
   }
   /**
    * @private
-  */ function parseSuffixes(d, i) {
+   */ function parseSuffixes(d, i) {
       const k = Math.pow(10, Math.abs(8 - i) * 3);
       return {
           scale: i > 8 ? (d)=>d / k : (d)=>d * k,
@@ -738,18 +636,17 @@
       };
   }
   /**
-      @function formatAbbreviate
-      @desc Formats a number to an appropriate number of decimal places and rounding, adding suffixes if applicable (ie. `1200000` to `"1.2M"`).
-      @param {Number|String} n The number to be formatted.
-      @param {Object|String} locale The locale config to be used. If *value* is an object, the function will format the numbers according the object. The object must include `suffixes`, `delimiter` and `currency` properties.
-      @returns {String}
-  */ function abbreviate(n, locale = "en-US", precision = undefined) {
-      if (isFinite(n)) n *= 1;
+      Formats a number to an appropriate number of decimal places and rounding, adding suffixes if applicable (ie. `1200000` to `"1.2M"`).
+      @param n The number to be formatted.
+      @param locale The locale config to be used. If an object is provided, the function will format the numbers according to the object. The object must include `suffixes`, `delimiter` and `currency` properties.
+      @param precision Number of significant digits to display.
+  */ function formatAbbreviate(n, locale = "en-US", precision) {
+      if (isFinite(n)) n = n * 1;
       else return "N/A";
       const negative = n < 0;
-      const length = n.toString().split(".")[0].replace("-", "").length, localeConfig = typeof locale === "object" ? locale : defaultLocale$1[locale] || defaultLocale$1["en-US"], suffixes = localeConfig.suffixes.map(parseSuffixes);
+      const length = n.toString().split(".")[0].replace("-", "").length, localeConfig = typeof locale === "object" ? locale : formatLocale$1[locale] || formatLocale$1["en-US"], suffixes = localeConfig.suffixes.map(parseSuffixes);
       const decimal = localeConfig.delimiters.decimal || ".", separator = localeConfig.separator || "", thousands = localeConfig.delimiters.thousands || ",";
-      const d3plusFormatLocale = formatLocale$1({
+      const d3plusFormatLocale = formatLocale$2({
           currency: localeConfig.currency || [
               "$",
               ""
@@ -771,31 +668,24 @@
       } else if (length === 3) val = d3plusFormatLocale.format(",f")(n);
       else if (n < 1 && n > -1) val = d3plusFormatLocale.format(".2g")(n);
       else val = d3plusFormatLocale.format(".3g")(n);
-      return `${negative && val.charAt(0) !== "−" ? "−" : ""}${val}`.replace(/−/g, "-") // replace new d3 default minus sign (−) to hyphen-minus (-)
+      return `${negative && val.charAt(0) !== "\u2212" ? "\u2212" : ""}${val}`.replace(/\u2212/g, "-") // replace new d3 default minus sign (\u2212) to hyphen-minus (-)
       .replace(/(\.[0]*[1-9]*)[0]*$/g, "$1") // removes any trailing zeros
       .replace(/\.[0]*$/g, ""); // removes any trailing decimal point
   }
 
-  /**
-      @function format
-      @desc An extension to d3's [format](https://github.com/d3/d3-format#api-reference) function that adds more string formatting types and localizations.
-      @param {String} specifier The string specifier used by the format function.
-      @returns {Function}
-  */ var format = ((specifier)=>{
-      if (specifier === ".3~a") return abbreviate;
+  function format(specifier) {
+      if (specifier === ".3~a") return formatAbbreviate;
       return format$1(specifier);
-  });
+  }
 
   /**
-      @function formatDefaultLocale
-      @desc An extension to d3's [formatDefaultLocale](https://github.com/d3/d3-format#api-reference) function that allows setting the locale globally for formatters.
-      @param {Object} definition The localization definition.
-      @returns {Object}
-  */ var formatDefaultLocale = ((definition)=>{
-      const locale = defaultLocale$2(definition);
+      An extension to d3's [formatDefaultLocale](https://github.com/d3/d3-format#api-reference) function that allows setting the locale globally for formatters.
+      @param definition The localization definition.
+  */ function formatDefaultLocale(definition) {
+      const locale = defaultLocale$1(definition);
       locale.format = format;
       return locale;
-  });
+  }
 
   const t0 = new Date, t1 = new Date;
   function timeInterval(floori, offseti, count, field) {
@@ -1678,12 +1568,10 @@
   }
 
   /**
-      @function formatDate
-      @desc A default set of date formatters, which takes into account both the interval in between in each data point but also the start/end data points.
-      @param {Date} d The date string to be formatted.
-      @param {Array} dataArray The full array of ordered Date Objects.
-      @param {Function} [formatter = d3.timeFormat] An optional instance of d3.timeFormat to be used for localization.
-      @returns {String}
+      A default set of date formatters, which takes into account both the interval in between in each data point but also the start/end data points.
+      @param d The date to format.
+      @param dataArray The full array of ordered Date Objects.
+      @param formatter Optional custom format string or function.
   */ function formatDate(d, dataArray, formatter = timeFormat) {
       const formatHour = formatter("%I %p"), formatMillisecond = formatter(".%L"), formatMinute = formatter("%I:%M"), formatMonth = formatter("%b"), formatMonthDay = formatter("%b %-d"), formatMonthDayYear = formatter("%b %-d, %Y"), formatMonthYear = formatter("%b %Y"), formatQuarter = formatter("Q%q"), formatQuarterYear = formatter("Q%q %Y"), formatSecond = formatter(":%S"), formatYear = formatter("%Y");
       const labelIndex = dataArray.findIndex((a)=>+a === +d);
@@ -1693,8 +1581,8 @@
           if (i) {
               arr[0].push(d.getFullYear() - dataArray[i - 1].getFullYear());
               arr[1].push(monthDiff(dataArray[i - 1], d));
-              arr[2].push(Math.round((d - dataArray[i - 1]) / (1000 * 60 * 60 * 24)));
-              arr[3].push(Math.round((d - dataArray[i - 1]) / (1000 * 60 * 60)));
+              arr[2].push(Math.round((+d - +dataArray[i - 1]) / (1000 * 60 * 60 * 24)));
+              arr[3].push(Math.round((+d - +dataArray[i - 1]) / (1000 * 60 * 60)));
           }
           return arr;
       }, [
@@ -1703,18 +1591,16 @@
           [],
           []
       ]);
-      return (yearlySteps.every((s)=>s >= 1 && !(s % 1)) // Yearly Data 
+      return (yearlySteps.every((s)=>s >= 1 && !(s % 1)) // Yearly Data
        ? formatYear : monthlySteps.every((s)=>s >= 3 && !(s % 3)) // Quarterly Data
-       ? +timeYear(d) === d || firstOrLast || smallArray ? formatQuarterYear : formatQuarter : monthlySteps.every((s)=>s >= 1 && !(s % 1)) // Monthly Data
-       ? +timeYear(d) === d || firstOrLast || smallArray ? formatMonthYear : formatMonth : dailySteps.every((s)=>s >= 1 && !(s % 1)) // Daily Data
-       ? +timeYear(d) === d || firstOrLast || smallArray ? formatMonthDayYear : formatMonthDay : hourlySteps.every((s)=>s >= 1 && !(s % 1)) // Hourly Data
-       ? firstOrLast || smallArray ? formatMonthDayYear : +timeMonth(d) === d ? formatMonthDay : formatHour : second(d) < d ? formatMillisecond : timeMinute(d) < d ? formatSecond : timeHour(d) < d ? formatMinute : d)(d);
+       ? +timeYear(d) === +d || firstOrLast || smallArray ? formatQuarterYear : formatQuarter : monthlySteps.every((s)=>s >= 1 && !(s % 1)) // Monthly Data
+       ? +timeYear(d) === +d || firstOrLast || smallArray ? formatMonthYear : formatMonth : dailySteps.every((s)=>s >= 1 && !(s % 1)) // Daily Data
+       ? +timeYear(d) === +d || firstOrLast || smallArray ? formatMonthDayYear : formatMonthDay : hourlySteps.every((s)=>s >= 1 && !(s % 1)) // Hourly Data
+       ? firstOrLast || smallArray ? formatMonthDayYear : +timeMonth(d) === +d ? formatMonthDay : formatHour : second(d) < d ? formatMillisecond : timeMinute(d) < d ? formatSecond : timeHour(d) < d ? formatMinute : (_d)=>_d.toString())(d);
   }
   /**
-      @function monthDiff
-      @desc Returns the number of months between two Date objects
-      @param {*} d1
-      @param {*} d2
+      Returns the number of months between two Date objects
+
       @returns {Number} the number of months between the two Date objects
       @private
   */ function monthDiff(d1, d2) {
@@ -1726,7 +1612,7 @@
   }
 
   exports.format = format;
-  exports.formatAbbreviate = abbreviate;
+  exports.formatAbbreviate = formatAbbreviate;
   exports.formatDate = formatDate;
   exports.formatDefaultLocale = formatDefaultLocale;