@d3plus/format 3.0.0-alpha.0

package/umd/d3plus-format.js

@@ -0,0 +1,260 @@
+/*
+  @d3plus/format v3.0.0
+  JavaScript formatters for localized numbers and dates.
+  Copyright (c) 2025 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, require('d3-format'), require('@d3plus/locales'), require('d3-time'), require('d3-time-format')) :
+  typeof define === 'function' && define.amd ? define('@d3plus/format', ['exports', 'd3-format', '@d3plus/locales', 'd3-time', 'd3-time-format'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.d3plus = {}, global.d3Format, global.locales, global.d3Time, global.d3TimeFormat));
+})(this, (function (exports, d3Format, locales, d3Time, d3TimeFormat) { 'use strict';
+
+  const round = (x, n)=>parseFloat(Math.round(x * Math.pow(10, n)) / Math.pow(10, n)).toFixed(n);
+  /**
+   * @private
+  */ function formatSuffix(str, precision, suffixes) {
+      let i = 0;
+      let value = parseFloat(str.replace("−", "-"), 10);
+      if (value) {
+          if (value < 0) value *= -1;
+          i = 1 + Math.floor(1e-12 + Math.log(value) / Math.LN10);
+          i = Math.max(-24, Math.min(24, Math.floor((i - 1) / 3) * 3));
+      }
+      const d = suffixes[8 + i / 3];
+      return {
+          number: round(d.scale(value), precision),
+          symbol: d.symbol
+      };
+  }
+  /**
+   * @private
+  */ function parseSuffixes(d, i) {
+      const k = Math.pow(10, Math.abs(8 - i) * 3);
+      return {
+          scale: i > 8 ? (d)=>d / k : (d)=>d * k,
+          symbol: d
+      };
+  }
+  /**
+      @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;
+      else return "N/A";
+      const negative = n < 0;
+      const length = n.toString().split(".")[0].replace("-", "").length, localeConfig = typeof locale === "object" ? locale : locales.formatLocale[locale] || locales.formatLocale["en-US"], suffixes = localeConfig.suffixes.map(parseSuffixes);
+      const decimal = localeConfig.delimiters.decimal || ".", separator = localeConfig.separator || "", thousands = localeConfig.delimiters.thousands || ",";
+      const d3plusFormatLocale = d3Format.formatLocale({
+          currency: localeConfig.currency || [
+              "$",
+              ""
+          ],
+          decimal,
+          grouping: localeConfig.grouping || [
+              3
+          ],
+          thousands
+      });
+      let val;
+      if (precision) val = d3plusFormatLocale.format(precision)(n);
+      else if (n === 0) val = "0";
+      else if (length >= 3) {
+          const f = formatSuffix(d3plusFormatLocale.format(".3r")(n), 2, suffixes);
+          const num = parseFloat(f.number).toString().replace(".", decimal);
+          const char = f.symbol;
+          val = `${num}${separator}${char}`;
+      } 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 (-)
+      .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.
+
+  The new specifier strings added by d3plus-format are:
+   - `.3~a` - abbreviated decimal notation with a numeric suffix (ie. "k", "M", "B", etc). This is an alias of the `formatAbbreviate` function.
+      @param {String} specifier The string specifier used by the format function.
+      @returns {Function}
+  */ var format = ((specifier)=>{
+      if (specifier === ".3~a") return abbreviate;
+      return d3Format.format(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 = d3Format.formatDefaultLocale(definition);
+      locale.format = format;
+      return locale;
+  });
+
+  /**
+      @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}
+  */ function formatDate(d, dataArray, formatter = d3TimeFormat.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);
+      const firstOrLast = labelIndex === 0 || labelIndex === dataArray.length - 1;
+      const smallArray = dataArray.length <= 5;
+      const [yearlySteps, monthlySteps, dailySteps, hourlySteps] = dataArray.reduce((arr, d, i)=>{
+          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)));
+          }
+          return arr;
+      }, [
+          [],
+          [],
+          [],
+          []
+      ]);
+      return (yearlySteps.every((s)=>s >= 1 && !(s % 1)) // Yearly Data 
+       ? formatYear : monthlySteps.every((s)=>s >= 3 && !(s % 3)) // Quarterly Data
+       ? +d3Time.timeYear(d) === d || firstOrLast || smallArray ? formatQuarterYear : formatQuarter : monthlySteps.every((s)=>s >= 1 && !(s % 1)) // Monthly Data
+       ? +d3Time.timeYear(d) === d || firstOrLast || smallArray ? formatMonthYear : formatMonth : dailySteps.every((s)=>s >= 1 && !(s % 1)) // Daily Data
+       ? +d3Time.timeYear(d) === d || firstOrLast || smallArray ? formatMonthDayYear : formatMonthDay : hourlySteps.every((s)=>s >= 1 && !(s % 1)) // Hourly Data
+       ? firstOrLast || smallArray ? formatMonthDayYear : +d3Time.timeMonth(d) === d ? formatMonthDay : formatHour : d3Time.timeSecond(d) < d ? formatMillisecond : d3Time.timeMinute(d) < d ? formatSecond : d3Time.timeHour(d) < d ? formatMinute : d)(d);
+  }
+  /**
+      @function monthDiff
+      @desc Returns the number of months between two Date objects
+      @param {*} d1
+      @param {*} d2
+      @returns {Number} the number of months between the two Date objects
+      @private
+  */ function monthDiff(d1, d2) {
+      let months;
+      months = (d2.getFullYear() - d1.getFullYear()) * 12;
+      months -= d1.getMonth();
+      months += d2.getMonth();
+      return months <= 0 ? 0 : months;
+  }
+
+  exports.format = format;
+  exports.formatAbbreviate = abbreviate;
+  exports.formatDate = formatDate;
+  exports.formatDefaultLocale = formatDefaultLocale;
+
+}));
+//# sourceMappingURL=d3plus-format.js.map

package/umd/d3plus-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d3plus-format.js","sources":["../src/formatAbbreviate.js","../src/format.js","../src/formatDefaultLocale.js","../src/formatDate.js"],"sourcesContent":["import {formatLocale} from \"d3-format\";\nimport {formatLocale as defaultLocale} from \"@d3plus/locales\";\n\nconst round = (x, n) =>\n  parseFloat(Math.round(x * Math.pow(10, n)) / Math.pow(10, n)).toFixed(n);\n\n/**\n * @private\n*/\nfunction formatSuffix(str, precision, suffixes) {\n  let i = 0;\n  let value = parseFloat(str.replace(\"−\", \"-\"), 10);\n  if (value) {\n    if (value < 0) value *= -1;\n    i = 1 + Math.floor(1e-12 + Math.log(value) / Math.LN10);\n    i = Math.max(-24, Math.min(24, Math.floor((i - 1) / 3) * 3));\n  }\n  const d = suffixes[8 + i / 3];\n\n  return {\n    number: round(d.scale(value), precision),\n    symbol: d.symbol\n  };\n}\n\n/**\n * @private\n*/\nfunction parseSuffixes(d, i) {\n  const k = Math.pow(10, Math.abs(8 - i) * 3);\n  return {\n    scale: i > 8 ? d => d / k : d => d * k,\n    symbol: d\n  };\n}\n\n\n/**\n    @function formatAbbreviate\n    @desc Formats a number to an appropriate number of decimal places and rounding, adding suffixes if applicable (ie. `1200000` to `\"1.2M\"`).\n    @param {Number|String} n The number to be formatted.\n    @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.\n    @returns {String}\n*/\nexport default function(n, locale = \"en-US\", precision = undefined) {\n  if (isFinite(n)) n *= 1;\n  else return \"N/A\";\n\n  const negative = n < 0;\n\n  const length = n.toString().split(\".\")[0].replace(\"-\", \"\").length,\n        localeConfig = typeof locale === \"object\" ? locale : defaultLocale[locale] || defaultLocale[\"en-US\"],\n        suffixes = localeConfig.suffixes.map(parseSuffixes);\n\n  const decimal = localeConfig.delimiters.decimal || \".\",\n        separator = localeConfig.separator || \"\",\n        thousands = localeConfig.delimiters.thousands || \",\";\n\n  const d3plusFormatLocale = formatLocale({\n    currency: localeConfig.currency || [\"$\", \"\"],\n    decimal,\n    grouping: localeConfig.grouping || [3],\n    thousands\n  });\n\n  let val;\n  if (precision) val = d3plusFormatLocale.format(precision)(n);\n  else if (n === 0) val = \"0\";\n  else if (length >= 3) {\n    const f = formatSuffix(d3plusFormatLocale.format(\".3r\")(n), 2, suffixes);\n    const num = parseFloat(f.number).toString().replace(\".\", decimal);\n    const char = f.symbol;\n    val = `${num}${separator}${char}`;\n  }\n  else if (length === 3) val = d3plusFormatLocale.format(\",f\")(n);\n  else if (n < 1 && n > -1) val = d3plusFormatLocale.format(\".2g\")(n);\n  else val = d3plusFormatLocale.format(\".3g\")(n);\n\n  return `${negative && val.charAt(0) !== \"−\" ? \"−\" : \"\"}${val}`\n    .replace(/−/g, \"-\") // replace new d3 default minus sign (−) to hyphen-minus (-)\n    .replace(/(\\.[0]*[1-9]*)[0]*$/g, \"$1\") // removes any trailing zeros\n    .replace(/\\.[0]*$/g, \"\"); // removes any trailing decimal point\n\n}\n","import abbreviate from \"./formatAbbreviate.js\";\nimport {format} from \"d3-format\";\n\n/**\n    @function format\n    @desc An extension to d3's [format](https://github.com/d3/d3-format#api-reference) function that adds more string formatting types and localizations.\n\nThe new specifier strings added by d3plus-format are:\n - `.3~a` - abbreviated decimal notation with a numeric suffix (ie. \"k\", \"M\", \"B\", etc). This is an alias of the `formatAbbreviate` function.\n    @param {String} specifier The string specifier used by the format function.\n    @returns {Function}\n*/\nexport default specifier => {\n  if (specifier === \".3~a\") return abbreviate;\n  return format(specifier);\n};\n","import format from \"./format.js\";\nimport {formatDefaultLocale} from \"d3-format\";\n\n/**\n    @function formatDefaultLocale\n    @desc An extension to d3's [formatDefaultLocale](https://github.com/d3/d3-format#api-reference) function that allows setting the locale globally for formatters.\n    @param {Object} definition The localization definition.\n    @returns {Object}\n*/\nexport default definition => {\n  const locale = formatDefaultLocale(definition);\n  locale.format = format;\n  return locale;\n};\n","import {timeYear, timeMonth, timeHour, timeMinute, timeSecond} from \"d3-time\";\nimport {timeFormat} from \"d3-time-format\";\n\n/**\n    @function formatDate\n    @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.\n    @param {Date} d The date string to be formatted.\n    @param {Array} dataArray The full array of ordered Date Objects.\n    @param {Function} [formatter = d3.timeFormat] An optional instance of d3.timeFormat to be used for localization.\n    @returns {String}\n*/\nexport default function(d, dataArray, formatter = timeFormat) {\n\n  const formatHour = formatter(\"%I %p\"),\n        formatMillisecond = formatter(\".%L\"),\n        formatMinute = formatter(\"%I:%M\"),\n        formatMonth = formatter(\"%b\"),\n        formatMonthDay = formatter(\"%b %-d\"),\n        formatMonthDayYear = formatter(\"%b %-d, %Y\"),\n        formatMonthYear = formatter(\"%b %Y\"),\n        formatQuarter = formatter(\"Q%q\"),\n        formatQuarterYear = formatter(\"Q%q %Y\"),\n        formatSecond = formatter(\":%S\"),\n        formatYear = formatter(\"%Y\");\n\n  const labelIndex = dataArray.findIndex(a => +a === +d);\n  const firstOrLast = labelIndex === 0 || labelIndex === dataArray.length - 1;\n  const smallArray = dataArray.length <= 5;\n\n  const [yearlySteps, monthlySteps, dailySteps, hourlySteps] = dataArray.reduce((arr, d, i) => {\n    if (i) {\n      arr[0].push(d.getFullYear() - dataArray[i - 1].getFullYear());\n      arr[1].push(monthDiff(dataArray[i - 1], d));\n      arr[2].push(Math.round((d - dataArray[i - 1]) / (1000 * 60 * 60 * 24)));\n      arr[3].push(Math.round((d - dataArray[i - 1]) / (1000 * 60 * 60)));\n    }\n    return arr;\n  }, [[], [], [], []]);\n\n  return (\n    yearlySteps.every(s => s >= 1 && !(s % 1)) // Yearly Data \n      ? formatYear\n    : monthlySteps.every(s => s >= 3 && !(s % 3)) // Quarterly Data\n      ? +timeYear(d) === d || firstOrLast || smallArray ? formatQuarterYear : formatQuarter\n    : monthlySteps.every(s => s >= 1 && !(s % 1)) // Monthly Data\n      ? +timeYear(d) === d || firstOrLast || smallArray ? formatMonthYear : formatMonth \n    : dailySteps.every(s => s >= 1 && !(s % 1)) // Daily Data\n      ? +timeYear(d) === d || firstOrLast || smallArray ? formatMonthDayYear : formatMonthDay \n    : hourlySteps.every(s => s >= 1 && !(s % 1)) // Hourly Data\n      ? firstOrLast || smallArray ? formatMonthDayYear : +timeMonth(d) === d ? formatMonthDay : formatHour\n    : timeSecond(d) < d ? formatMillisecond\n    : timeMinute(d) < d ? formatSecond\n    : timeHour(d) < d ? formatMinute : d\n  )(d);\n\n}\n\n/**\n    @function monthDiff\n    @desc Returns the number of months between two Date objects\n    @param {*} d1\n    @param {*} d2\n    @returns {Number} the number of months between the two Date objects\n    @private\n*/\nfunction monthDiff(d1, d2) {\n  let months;\n  months = (d2.getFullYear() - d1.getFullYear()) * 12;\n  months -= d1.getMonth();\n  months += d2.getMonth();\n  return months <= 0 ? 0 : months;\n}\n"],"names":["round","x","n","parseFloat","Math","pow","toFixed","formatSuffix","str","precision","suffixes","i","value","replace","floor","log","LN10","max","min","d","number","scale","symbol","parseSuffixes","k","abs","locale","undefined","isFinite","negative","length","toString","split","localeConfig","defaultLocale","map","decimal","delimiters","separator","thousands","d3plusFormatLocale","formatLocale","currency","grouping","val","format","f","num","char","charAt","specifier","abbreviate","definition","formatDefaultLocale","dataArray","formatter","timeFormat","formatHour","formatMillisecond","formatMinute","formatMonth","formatMonthDay","formatMonthDayYear","formatMonthYear","formatQuarter","formatQuarterYear","formatSecond","formatYear","labelIndex","findIndex","a","firstOrLast","smallArray","yearlySteps","monthlySteps","dailySteps","hourlySteps","reduce","arr","push","getFullYear","monthDiff","every","s","timeYear","timeMonth","timeSecond","timeMinute","timeHour","d1","d2","months","getMonth"],"mappings":"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"}

package/umd/d3plus-format.min.js

@@ -0,0 +1,53 @@
+/*
+  @d3plus/format v3.0.0
+  JavaScript formatters for localized numbers and dates.
+  Copyright (c) 2025 D3plus - https://d3plus.org
+  @license MIT
+*/
+(e=>{"function"==typeof define&&define.amd?define(e):e()})(function(){if("undefined"!=typeof window){try{if("undefined"==typeof SVGElement||Boolean(SVGElement.prototype.innerHTML))return}catch(e){return}function o(e){switch(e.nodeType){case 1:var t=e,r="";return r+="<"+t.tagName,t.hasAttributes()&&[].forEach.call(t.attributes,function(e){r+=" "+e.name+'="'+e.value+'"'}),r+=">",t.hasChildNodes()&&[].forEach.call(t.childNodes,function(e){r+=o(e)}),r+="</"+t.tagName+">";case 3:return e.textContent.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;");case 8:return"\x3c!--"+e.nodeValue+"--\x3e"}}Object.defineProperty(SVGElement.prototype,"innerHTML",{get:function(){var t="";return[].forEach.call(this.childNodes,function(e){t+=o(e)}),t},set:function(e){for(;this.firstChild;)this.removeChild(this.firstChild);try{var t=new DOMParser,r=(t.async=!1,"<svg xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'>"+e+"</svg>"),o=t.parseFromString(r,"text/xml").documentElement;[].forEach.call(o.childNodes,function(e){this.appendChild(this.ownerDocument.importNode(e,!0))}.bind(this))}catch(e){throw new Error("Error parsing markup string")}}}),Object.defineProperty(SVGElement.prototype,"innerSVG",{get:function(){return this.innerHTML},set:function(e){this.innerHTML=e}})}}),((e,t)=>{"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("d3-format"),require("@d3plus/locales"),require("d3-time"),require("d3-time-format")):"function"==typeof define&&define.amd?define("@d3plus/format",["exports","d3-format","@d3plus/locales","d3-time","d3-time-format"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).d3plus={},e.d3Format,e.locales,e.d3Time,e.d3TimeFormat)})(this,function(e,s,m,b,v){let c=(e,t)=>parseFloat(Math.round(e*Math.pow(10,t))/Math.pow(10,t)).toFixed(t);
+/**
+   * @private
+  */
+/**
+   * @private
+  */function d(e,t){let r=Math.pow(10,3*Math.abs(8-t));return{scale:8<t?e=>e/r:e=>e*r,symbol:e}}
+/**
+      @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 t(e,t="en-US",r=void 0){if(!isFinite(e))return"N/A";var o=(e*=1)<0,n=e.toString().split(".")[0].replace("-","").length,t="object"==typeof t?t:m.formatLocale[t]||m.formatLocale["en-US"],a=t.suffixes.map(d),i=t.delimiters.decimal||".",l=t.separator||"",f=t.delimiters.thousands||",",t=s.formatLocale({currency:t.currency||["$",""],decimal:i,grouping:t.grouping||[3],thousands:f});let u;return u=r?t.format(r)(e):0===e?"0":3<=n?(f=((e,t,r)=>{let o=0,n=parseFloat(e.replace("−","-"),10);return n&&(n<0&&(n*=-1),o=1+Math.floor(1e-12+Math.log(n)/Math.LN10),o=Math.max(-24,Math.min(24,3*Math.floor((o-1)/3)))),e=r[8+o/3],{number:c(e.scale(n),t),symbol:e.symbol}})(t.format(".3r")(e),2,a),""+parseFloat(f.number).toString().replace(".",i)+l+f.symbol):(3===n?t.format(",f"):e<1&&-1<e?t.format(".2g"):t.format(".3g"))(e),((o&&"−"!==u.charAt(0)?"−":"")+u).replace(/−/g,"-").replace(/(\.[0]*[1-9]*)[0]*$/g,"$1").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.
+
+  The new specifier strings added by d3plus-format are:
+   - `.3~a` - abbreviated decimal notation with a numeric suffix (ie. "k", "M", "B", etc). This is an alias of the `formatAbbreviate` function.
+      @param {String} specifier The string specifier used by the format function.
+      @returns {Function}
+  */var r=e=>".3~a"===e?t:s.format(e);
+/**
+      @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}
+  */e.format=r,e.formatAbbreviate=t,e.formatDate=
+/**
+      @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}
+  */function(t,i,e=v.timeFormat){var r=e("%I %p"),o=e(".%L"),n=e("%I:%M"),a=e("%b"),l=e("%b %-d"),f=e("%b %-d, %Y"),u=e("%b %Y"),s=e("Q%q"),m=e("Q%q %Y"),c=e(":%S"),e=e("%Y"),d=0===(d=i.findIndex(e=>+e==+t))||d===i.length-1,h=i.length<=5,[p,g,y,M]=i.reduce((e,t,r)=>{
+/**
+      @function monthDiff
+      @desc Returns the number of months between two Date objects
+      @param {*} d1
+      @param {*} d2
+      @returns {Number} the number of months between the two Date objects
+      @private
+  */var o,n,a;return r&&(e[0].push(t.getFullYear()-i[r-1].getFullYear()),e[1].push((o=i[r-1],a=12*((n=t).getFullYear()-o.getFullYear()),(a=(a-=o.getMonth())+n.getMonth())<=0?0:a)),e[2].push(Math.round((t-i[r-1])/864e5)),e[3].push(Math.round((t-i[r-1])/36e5))),e},[[],[],[],[]]);return(p.every(e=>1<=e&&!(e%1))?e:g.every(e=>3<=e&&!(e%3))?+b.timeYear(t)===t||d||h?m:s:g.every(e=>1<=e&&!(e%1))?+b.timeYear(t)===t||d||h?u:a:y.every(e=>1<=e&&!(e%1))?+b.timeYear(t)===t||d||h?f:l:M.every(e=>1<=e&&!(e%1))?d||h?f:+b.timeMonth(t)===t?l:r:b.timeSecond(t)<t?o:b.timeMinute(t)<t?c:b.timeHour(t)<t?n:t)(t)},e.formatDefaultLocale=e=>{e=s.formatDefaultLocale(e);return e.format=r,e}});
+//# sourceMappingURL=d3plus-format.js.map