javascript-time-ago 2.5.12 → 2.6.0

package/commonjs/FullDateFormatter.js

@@ -0,0 +1,72 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.FallbackDateFormatter = void 0;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var FullDateFormatter = exports["default"] = /*#__PURE__*/function () {
+  function FullDateFormatter(localeOrLocales) {
+    _classCallCheck(this, FullDateFormatter);
+    // See if `Intl.DateTimeFormat` is supported in the current environment.
+    //
+    // `Intl` is present in all modern web browsers and is only absent from some of the ancient ones.
+    //
+    // Babel transforms `typeof` into some "branches"
+    // so istanbul will show this as "branch not covered".
+    /* istanbul ignore next */
+    var isIntlAvailable = (typeof Intl === "undefined" ? "undefined" : _typeof(Intl)) === 'object';
+    var isIntlDateTimeFormatAvailable = isIntlAvailable && typeof Intl.DateTimeFormat === 'function';
+
+    /* istanbul ignore else */
+    if (isIntlDateTimeFormatAvailable) {
+      this.formatter = new Intl.DateTimeFormat(localeOrLocales, VERBOSE_DATE_FORMAT_OPTIONS);
+    } else {
+      this.formatter = new FallbackDateFormatter();
+    }
+  }
+  _createClass(FullDateFormatter, [{
+    key: "format",
+    value: function format(dateOrTimestamp) {
+      return this.formatter.format(getDate(dateOrTimestamp));
+    }
+  }]);
+  return FullDateFormatter;
+}();
+var FallbackDateFormatter = exports.FallbackDateFormatter = /*#__PURE__*/function () {
+  function FallbackDateFormatter() {
+    _classCallCheck(this, FallbackDateFormatter);
+  }
+  _createClass(FallbackDateFormatter, [{
+    key: "format",
+    value: function format(date) {
+      return String(date);
+    }
+  }]);
+  return FallbackDateFormatter;
+}();
+function getDate(dateOrTimestamp) {
+  if (typeof dateOrTimestamp === 'number') {
+    return new Date(dateOrTimestamp);
+  }
+  return dateOrTimestamp;
+}
+
+// `Intl.DateTimeFormat` options for outputting a verbose date.
+// Formatted date example: "Thursday, December 20, 2012, 7:00:00 AM GMT+4"
+var VERBOSE_DATE_FORMAT_OPTIONS = {
+  weekday: 'long',
+  day: 'numeric',
+  month: 'long',
+  year: 'numeric',
+  hour: 'numeric',
+  minute: '2-digit',
+  second: '2-digit'
+  // timeZoneName: 'short'
+};
+//# sourceMappingURL=FullDateFormatter.js.map

package/commonjs/FullDateFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FullDateFormatter.js","names":["FullDateFormatter","exports","localeOrLocales","_classCallCheck","isIntlAvailable","Intl","_typeof","isIntlDateTimeFormatAvailable","DateTimeFormat","formatter","VERBOSE_DATE_FORMAT_OPTIONS","FallbackDateFormatter","_createClass","key","value","format","dateOrTimestamp","getDate","date","String","Date","weekday","day","month","year","hour","minute","second"],"sources":["../source/FullDateFormatter.js"],"sourcesContent":["export default class FullDateFormatter {\r\n\tconstructor(localeOrLocales) {\r\n\t\t// See if `Intl.DateTimeFormat` is supported in the current environment.\r\n\t\t//\r\n\t\t// `Intl` is present in all modern web browsers and is only absent from some of the ancient ones.\r\n\t\t//\r\n\t\t// Babel transforms `typeof` into some \"branches\"\r\n\t\t// so istanbul will show this as \"branch not covered\".\r\n\t\t/* istanbul ignore next */\r\n\t\tconst isIntlAvailable = typeof Intl === 'object'\r\n\t\tconst isIntlDateTimeFormatAvailable = isIntlAvailable && typeof Intl.DateTimeFormat === 'function'\r\n\r\n\t\t/* istanbul ignore else */\r\n\t\tif (isIntlDateTimeFormatAvailable) {\r\n\t\t\tthis.formatter = new Intl.DateTimeFormat(localeOrLocales, VERBOSE_DATE_FORMAT_OPTIONS)\r\n\t\t} else {\r\n\t\t\tthis.formatter = new FallbackDateFormatter()\r\n\t\t}\r\n\t}\r\n\r\n\tformat(dateOrTimestamp) {\r\n\t\treturn this.formatter.format(getDate(dateOrTimestamp))\r\n\t}\r\n}\r\n\r\nexport class FallbackDateFormatter {\r\n\tformat(date) {\r\n\t\treturn String(date)\r\n\t}\r\n}\r\n\r\nfunction getDate(dateOrTimestamp) {\r\n\tif (typeof dateOrTimestamp === 'number') {\r\n\t\treturn new Date(dateOrTimestamp)\r\n\t}\r\n\treturn dateOrTimestamp\r\n}\r\n\r\n// `Intl.DateTimeFormat` options for outputting a verbose date.\r\n// Formatted date example: \"Thursday, December 20, 2012, 7:00:00 AM GMT+4\"\r\nconst VERBOSE_DATE_FORMAT_OPTIONS = {\r\n\tweekday: 'long',\r\n\tday: 'numeric',\r\n\tmonth: 'long',\r\n\tyear: 'numeric',\r\n\thour: 'numeric',\r\n\tminute: '2-digit',\r\n\tsecond: '2-digit'\r\n\t// timeZoneName: 'short'\r\n}"],"mappings":";;;;;;;;;;;;IAAqBA,iBAAiB,GAAAC,OAAA;EACrC,SAAAD,kBAAYE,eAAe,EAAE;IAAAC,eAAA,OAAAH,iBAAA;IAC5B;IACA;IACA;IACA;IACA;IACA;IACA;IACA,IAAMI,eAAe,GAAG,QAAOC,IAAI,iCAAAC,OAAA,CAAJD,IAAI,OAAK,QAAQ;IAChD,IAAME,6BAA6B,GAAGH,eAAe,IAAI,OAAOC,IAAI,CAACG,cAAc,KAAK,UAAU;;IAElG;IACA,IAAID,6BAA6B,EAAE;MAClC,IAAI,CAACE,SAAS,GAAG,IAAIJ,IAAI,CAACG,cAAc,CAACN,eAAe,EAAEQ,2BAA2B,CAAC;IACvF,CAAC,MAAM;MACN,IAAI,CAACD,SAAS,GAAG,IAAIE,qBAAqB,CAAC,CAAC;IAC7C;EACD;EAACC,YAAA,CAAAZ,iBAAA;IAAAa,GAAA;IAAAC,KAAA,EAED,SAAAC,OAAOC,eAAe,EAAE;MACvB,OAAO,IAAI,CAACP,SAAS,CAACM,MAAM,CAACE,OAAO,CAACD,eAAe,CAAC,CAAC;IACvD;EAAC;EAAA,OAAAhB,iBAAA;AAAA;AAAA,IAGWW,qBAAqB,GAAAV,OAAA,CAAAU,qBAAA;EAAA,SAAAA,sBAAA;IAAAR,eAAA,OAAAQ,qBAAA;EAAA;EAAAC,YAAA,CAAAD,qBAAA;IAAAE,GAAA;IAAAC,KAAA,EACjC,SAAAC,OAAOG,IAAI,EAAE;MACZ,OAAOC,MAAM,CAACD,IAAI,CAAC;IACpB;EAAC;EAAA,OAAAP,qBAAA;AAAA;AAGF,SAASM,OAAOA,CAACD,eAAe,EAAE;EACjC,IAAI,OAAOA,eAAe,KAAK,QAAQ,EAAE;IACxC,OAAO,IAAII,IAAI,CAACJ,eAAe,CAAC;EACjC;EACA,OAAOA,eAAe;AACvB;;AAEA;AACA;AACA,IAAMN,2BAA2B,GAAG;EACnCW,OAAO,EAAE,MAAM;EACfC,GAAG,EAAE,SAAS;EACdC,KAAK,EAAE,MAAM;EACbC,IAAI,EAAE,SAAS;EACfC,IAAI,EAAE,SAAS;EACfC,MAAM,EAAE,SAAS;EACjBC,MAAM,EAAE;EACR;AACD,CAAC","ignoreList":[]}

package/commonjs/FullDateFormatter.test.js

@@ -0,0 +1,26 @@
+"use strict";
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _FullDateFormatter = _interopRequireWildcard(require("./FullDateFormatter.js"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) { "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); } return f; })(e, t); }
+describe('FullDateFormatter', function () {
+  it('should format full date', function () {
+    var formatter = new _FullDateFormatter["default"]('en');
+    expect(formatter.format(new Date(Date.UTC(2000, 0, 1)))).to.equal('Saturday, January 1, 2000 at 3:00:00 AM');
+  });
+  it('should format full date (`locales` argument)', function () {
+    var formatter = new _FullDateFormatter["default"](['en', 'ru']);
+    expect(formatter.format(new Date(Date.UTC(2000, 0, 1)))).to.equal('Saturday, January 1, 2000 at 3:00:00 AM');
+  });
+  it('should format full date (timestamp)', function () {
+    var formatter = new _FullDateFormatter["default"]('en');
+    expect(formatter.format(Date.UTC(2000, 0, 1))).to.equal('Saturday, January 1, 2000 at 3:00:00 AM');
+  });
+  it('should fallback to non-`Intl` formatter', function () {
+    var formatter = new _FullDateFormatter.FallbackDateFormatter('en');
+    // The output depends on the user's time zone.
+    // Example when running in Moscow: "Sat Jan 01 2000 03:00:00 GMT+0300 (Moscow Standard Time)".
+    expect(formatter.format(new Date(Date.UTC(2000, 1, 1)))).to.include(':00:00 GMT');
+  });
+});
+//# sourceMappingURL=FullDateFormatter.test.js.map

package/commonjs/FullDateFormatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FullDateFormatter.test.js","names":["_FullDateFormatter","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","_typeof","has","get","set","_t","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","describe","it","formatter","FullDateFormatter","expect","format","Date","UTC","to","equal","FallbackDateFormatter","include"],"sources":["../source/FullDateFormatter.test.js"],"sourcesContent":["import FullDateFormatter, { FallbackDateFormatter } from './FullDateFormatter.js'\r\n\r\ndescribe('FullDateFormatter', () => {\r\n\tit('should format full date', () => {\r\n\t\tconst formatter = new FullDateFormatter('en')\r\n\t\texpect(\r\n\t\t\tformatter.format(new Date(Date.UTC(2000, 0, 1)))\r\n\t\t).to.equal('Saturday, January 1, 2000 at 3:00:00 AM')\r\n\t})\r\n\r\n\tit('should format full date (`locales` argument)', () => {\r\n\t\tconst formatter = new FullDateFormatter(['en', 'ru'])\r\n\t\texpect(\r\n\t\t\tformatter.format(new Date(Date.UTC(2000, 0, 1)))\r\n\t\t).to.equal('Saturday, January 1, 2000 at 3:00:00 AM')\r\n\t})\r\n\r\n\tit('should format full date (timestamp)', () => {\r\n\t\tconst formatter = new FullDateFormatter('en')\r\n\t\texpect(\r\n\t\t\tformatter.format(Date.UTC(2000, 0, 1))\r\n\t\t).to.equal('Saturday, January 1, 2000 at 3:00:00 AM')\r\n\t})\r\n\r\n\tit('should fallback to non-`Intl` formatter', () => {\r\n\t\tconst formatter = new FallbackDateFormatter('en')\r\n\t\t// The output depends on the user's time zone.\r\n\t\t// Example when running in Moscow: \"Sat Jan 01 2000 03:00:00 GMT+0300 (Moscow Standard Time)\".\r\n\t\texpect(\r\n\t\t\tformatter.format(new Date(Date.UTC(2000, 1, 1)))\r\n\t\t).to.include(':00:00 GMT')\r\n\t})\r\n})"],"mappings":";;;AAAA,IAAAA,kBAAA,GAAAC,uBAAA,CAAAC,OAAA;AAAiF,SAAAD,wBAAAE,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAJ,uBAAA,YAAAA,wBAAAE,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,mBAAAT,CAAA,iBAAAA,CAAA,gBAAAU,OAAA,CAAAV,CAAA,0BAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,cAAAM,EAAA,IAAAd,CAAA,kBAAAc,EAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,EAAA,OAAAP,CAAA,IAAAD,CAAA,GAAAW,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAnB,CAAA,EAAAc,EAAA,OAAAP,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAM,EAAA,EAAAP,CAAA,IAAAC,CAAA,CAAAM,EAAA,IAAAd,CAAA,CAAAc,EAAA,aAAAN,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAEjFmB,QAAQ,CAAC,mBAAmB,EAAE,YAAM;EACnCC,EAAE,CAAC,yBAAyB,EAAE,YAAM;IACnC,IAAMC,SAAS,GAAG,IAAIC,6BAAiB,CAAC,IAAI,CAAC;IAC7CC,MAAM,CACLF,SAAS,CAACG,MAAM,CAAC,IAAIC,IAAI,CAACA,IAAI,CAACC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAChD,CAAC,CAACC,EAAE,CAACC,KAAK,CAAC,yCAAyC,CAAC;EACtD,CAAC,CAAC;EAEFR,EAAE,CAAC,8CAA8C,EAAE,YAAM;IACxD,IAAMC,SAAS,GAAG,IAAIC,6BAAiB,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrDC,MAAM,CACLF,SAAS,CAACG,MAAM,CAAC,IAAIC,IAAI,CAACA,IAAI,CAACC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAChD,CAAC,CAACC,EAAE,CAACC,KAAK,CAAC,yCAAyC,CAAC;EACtD,CAAC,CAAC;EAEFR,EAAE,CAAC,qCAAqC,EAAE,YAAM;IAC/C,IAAMC,SAAS,GAAG,IAAIC,6BAAiB,CAAC,IAAI,CAAC;IAC7CC,MAAM,CACLF,SAAS,CAACG,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CACtC,CAAC,CAACC,EAAE,CAACC,KAAK,CAAC,yCAAyC,CAAC;EACtD,CAAC,CAAC;EAEFR,EAAE,CAAC,yCAAyC,EAAE,YAAM;IACnD,IAAMC,SAAS,GAAG,IAAIQ,wCAAqB,CAAC,IAAI,CAAC;IACjD;IACA;IACAN,MAAM,CACLF,SAAS,CAACG,MAAM,CAAC,IAAIC,IAAI,CAACA,IAAI,CAACC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAChD,CAAC,CAACC,EAAE,CAACG,OAAO,CAAC,YAAY,CAAC;EAC3B,CAAC,CAAC;AACH,CAAC,CAAC","ignoreList":[]}

package/commonjs/TimeAgo.js

@@ -29,10 +29,6 @@ function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o =
 function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-// Valid time units.
-var UNITS = ['now',
-// The rest are the same as in `Intl.RelativeTimeFormat`.
-'second', 'minute', 'hour', 'day', 'week', 'month', 'quarter', 'year'];
 var TimeAgo = exports["default"] = /*#__PURE__*/function () {
   /**
    * @param {(string|string[])} locales=[] - Preferred locales (or locale).
@@ -97,11 +93,16 @@ var TimeAgo = exports["default"] = /*#__PURE__*/function () {
    *
    * @param {boolean} [options.getTimeToNextUpdate] — Pass `true` to return `[formattedDate, timeToNextUpdate]` instead of just `formattedDate`.
    *
+   * @param {boolean} [options.getTimeToNextUpdateUncapped] — Pass `true` to not apply the workaround for `setTimeout()` bug. https://stackoverflow.com/questions/3468607/why-does-settimeout-break-for-large-millisecond-delay-values
+   *
+   * @param {function} [options.refresh] — When `refresh` function is passed, it will be automatically called with a new text when it's time to refresh the label.
+   *
    * @return {string} The formatted relative date/time. If no eligible `step` is found, then an empty string is returned.
    */
   _createClass(TimeAgo, [{
     key: "format",
     value: function format(input, style, options) {
+      var _this = this;
       if (!options) {
         if (style && !isStyle(style)) {
           options = style;
@@ -123,125 +124,203 @@ var TimeAgo = exports["default"] = /*#__PURE__*/function () {
       var _this$getLabels = this.getLabels(style.flavour || style.labels),
         labels = _this$getLabels.labels,
         labelsType = _this$getLabels.labelsType;
+
+      // `round` setting could be passed as a parameter to `.format()` function
+      // or be configured globally for a style.
+      var round = options.round || style.round;
+
+      // A developer can pass a custom `now`, e.g. for testing purposes.
       var now;
-      // Can pass a custom `now`, e.g. for testing purposes.
-      //
+      var nowRealWhenCalled = Date.now();
+      // (deprecated)
       // Legacy way was passing `now` in `style`.
-      // That way is deprecated.
       if (style.now !== undefined) {
         now = style.now;
       }
-      // The new way is passing `now` option to `.format()`.
+      // One could pass `now` option to `.format()`.
       if (now === undefined && options.now !== undefined) {
         now = options.now;
       }
+      // The default `now` is `Date.now()`.
       if (now === undefined) {
-        now = Date.now();
+        now = nowRealWhenCalled;
       }
-
-      // how much time has passed (in seconds)
-      var secondsPassed = (now - timestamp) / 1000; // in seconds
-
-      var future = options.future || secondsPassed < 0;
-      var nowLabel = getNowLabel(labels, (0, _LocaleDataStore.getLocaleData)(this.locale).now, (0, _LocaleDataStore.getLocaleData)(this.locale)["long"], future);
-
-      // `custom` – A function of `{ elapsed, time, date, now, locale }`.
-      //
-      // Looks like `custom` function is deprecated and will be removed
-      // in the next major version.
-      //
-      // If this function returns a value, then the `.format()` call will return that value.
-      // Otherwise the relative date/time is formatted as usual.
-      // This feature is currently not used anywhere and is here
-      // just for providing the ultimate customization point
-      // in case anyone would ever need that. Prefer using
-      // `steps[step].format(value, locale)` instead.
-      //
-      if (style.custom) {
-        var custom = style.custom({
-          now: now,
-          date: new Date(timestamp),
-          time: timestamp,
-          elapsed: secondsPassed,
-          locale: this.locale
-        });
-        if (custom !== undefined) {
-          // Won't return `timeToNextUpdate` here
-          // because `custom()` seems deprecated.
-          return custom;
+      var getTextAndTextRefreshDelayGetterFunctions = function getTextAndTextRefreshDelayGetterFunctions(_ref2) {
+        var now = _ref2.now;
+        // how much time has passed (in seconds)
+        var secondsPassed = (now - timestamp) / 1000; // in seconds
+
+        var future = options.future || secondsPassed < 0;
+        var nowLabel = getNowLabel(labels, (0, _LocaleDataStore.getLocaleData)(_this.locale).now, (0, _LocaleDataStore.getLocaleData)(_this.locale)["long"], future);
+
+        // (deprecated)
+        //
+        // `custom` – A function of `{ elapsed, time, date, now, locale }`.
+        //
+        // If this function returns a value, then the `.format()` call will return that value.
+        // Otherwise the relative date/time is formatted as usual.
+        // This feature is currently not used anywhere and is here
+        // just for providing the ultimate customization point
+        // in case anyone would ever need that. Prefer using
+        // `steps[step].format(value, locale)` instead.
+        //
+        if (style.custom) {
+          var text = style.custom({
+            now: now,
+            date: new Date(timestamp),
+            time: timestamp,
+            elapsed: secondsPassed,
+            locale: _this.locale
+          });
+          if (text !== undefined) {
+            // Won't return `timeToNextUpdate` here
+            // because `custom()` seems deprecated.
+            return {
+              getText: function getText() {
+                return text;
+              },
+              getTextRefreshDelay: function getTextRefreshDelay() {
+                throw new Error('`getTimeToNextUpdate: true` feature is not supported by legacy "styles" that have a `custom` function');
+              }
+            };
+          }
         }
-      }
-
-      // Get the list of available time interval units.
-      var units = getTimeIntervalMeasurementUnits(
-      // Controlling `style.steps` through `style.units` seems to be deprecated:
-      // create a new custom `style` instead.
-      style.units, labels, nowLabel);
 
-      // // If no available time unit is suitable, just output an empty string.
-      // if (units.length === 0) {
-      // 	console.error(`None of the "${units.join(', ')}" time units have been found in "${labelsType}" labels for "${this.locale}" locale.`)
-      // 	return ''
-      // }
-
-      var round = options.round || style.round;
+        // Get the list of available time interval units.
+        var units = getTimeIntervalMeasurementUnits(
+        // Controlling `style.steps` through `style.units` seems to be deprecated:
+        // create a new custom `style` instead.
+        style.units, labels, nowLabel);
+
+        // Choose the appropriate time measurement unit
+        // and get the corresponding rounded time amount.
+        var _getStep = (0, _getStep3["default"])(
+          // "gradation" is a legacy name for "steps".
+          // For historical reasons, "approximate" steps are used by default.
+          // In the next major version, there'll be no default for `steps`.
+          style.gradation || style.steps || _roundMinute["default"].steps, secondsPassed, {
+            now: now,
+            units: units,
+            round: round,
+            future: future,
+            getNextStep: true
+          }),
+          _getStep2 = _slicedToArray(_getStep, 3),
+          prevStep = _getStep2[0],
+          step = _getStep2[1],
+          nextStep = _getStep2[2];
+        var getText = function getText() {
+          return _this.formatDateForStep(timestamp, step, secondsPassed, {
+            labels: labels,
+            labelsType: labelsType,
+            nowLabel: nowLabel,
+            now: now,
+            future: future,
+            round: round
+          }) || '';
+        };
+
+        // Returns the time (in milliseconds) after which the formatted date label should be refreshed.
+        //
+        // It will return `undefined` for a custom style
+        // that doesn't meet the minimum requirements for this feature.
+        // See the README for more details.
+        //
+        var getTextRefreshDelay = function getTextRefreshDelay() {
+          var timeToNextUpdate = (0, _getTimeToNextUpdate["default"])(timestamp, step, {
+            nextStep: nextStep,
+            prevStep: prevStep,
+            now: now,
+            future: future,
+            round: round
+          });
 
-      // Choose the appropriate time measurement unit
-      // and get the corresponding rounded time amount.
-      var _getStep = (0, _getStep3["default"])(
-        // "gradation" is a legacy name for "steps".
-        // For historical reasons, "approximate" steps are used by default.
-        // In the next major version, there'll be no default for `steps`.
-        style.gradation || style.steps || _roundMinute["default"].steps, secondsPassed, {
-          now: now,
-          units: units,
-          round: round,
-          future: future,
-          getNextStep: true
+          // `timeToNextUpdate` could be `undefined` for a custom style
+          // that doesn't meet the minimum requirements for this feature.
+          // See the README for more details.
+          if (typeof timeToNextUpdate === 'number') {
+            // `setTimeout()` function has a bug when it fires immediately
+            // when the delay is longer than about `24.85` days.
+            // https://stackoverflow.com/questions/3468607/why-does-settimeout-break-for-large-millisecond-delay-values
+            //
+            // To not burden the end user of this library with manually working around that bug,
+            // this library automatically caps the returned delay to a maximum value that
+            // still works with `setTimeout()` and doesn't break it.
+            //
+            // The end user of this library could still opt out of this auto-workaround feature
+            // by passing a `getTimeToNextUpdateUncapped: true` option.
+            //
+            if (options.getTimeToNextUpdateUncapped) {
+              return timeToNextUpdate;
+            }
+            return getSafeTimeoutDelay(timeToNextUpdate);
+          }
+        };
+        return {
+          getText: getText,
+          getTextRefreshDelay: getTextRefreshDelay
+        };
+      };
+      var _getTextAndTextRefres = getTextAndTextRefreshDelayGetterFunctions({
+          now: now
         }),
-        _getStep2 = _slicedToArray(_getStep, 3),
-        prevStep = _getStep2[0],
-        step = _getStep2[1],
-        nextStep = _getStep2[2];
-      var formattedDate = this.formatDateForStep(timestamp, step, secondsPassed, {
-        labels: labels,
-        labelsType: labelsType,
-        nowLabel: nowLabel,
-        now: now,
-        future: future,
-        round: round
-      }) || '';
+        getText = _getTextAndTextRefres.getText,
+        getTextRefreshDelay = _getTextAndTextRefres.getTextRefreshDelay;
       if (options.getTimeToNextUpdate) {
-        var timeToNextUpdate = (0, _getTimeToNextUpdate["default"])(timestamp, step, {
-          nextStep: nextStep,
-          prevStep: prevStep,
-          now: now,
-          future: future,
-          round: round
-        });
-        return [formattedDate, timeToNextUpdate];
+        return [getText(), getTextRefreshDelay()];
       }
-      return formattedDate;
+      if (options.refresh) {
+        // `getTextRefreshDelay()` will return `undefined` for a custom style
+        // that doesn't meet the minimum requirements for this feature.
+        // See the README for more details.
+        //
+        // This is a "sensible default" interval for refreshing time labels
+        // that use such custom style.
+        //
+        var defaultRefreshInterval = 60 * 1000;
+
+        // If `refresh` function was passed, schedule it to be called when the time comes,
+        // after which schedule the next refresh.
+        var refreshTimer;
+        var scheduleRefresh = function scheduleRefresh() {
+          var delay = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : defaultRefreshInterval;
+          refreshTimer = setTimeoutSafe(function () {
+            var _getTextAndTextRefres2 = getTextAndTextRefreshDelayGetterFunctions({
+                now: now + (Date.now() - nowRealWhenCalled)
+              }),
+              getText = _getTextAndTextRefres2.getText,
+              getTextRefreshDelay = _getTextAndTextRefres2.getTextRefreshDelay;
+            options.refresh(getText());
+            scheduleRefresh(getTextRefreshDelay());
+          }, delay);
+        };
+        scheduleRefresh(getTextRefreshDelay());
+        var stopRefreshing = function stopRefreshing() {
+          clearTimeout(refreshTimer);
+        };
+        return [getText(), stopRefreshing];
+      }
+      return getText();
     }
   }, {
     key: "formatDateForStep",
-    value: function formatDateForStep(timestamp, step, secondsPassed, _ref2) {
-      var _this = this;
-      var labels = _ref2.labels,
-        labelsType = _ref2.labelsType,
-        nowLabel = _ref2.nowLabel,
-        now = _ref2.now,
-        future = _ref2.future,
-        round = _ref2.round;
+    value: function formatDateForStep(timestamp, step, secondsPassed, _ref3) {
+      var _this2 = this;
+      var labels = _ref3.labels,
+        labelsType = _ref3.labelsType,
+        nowLabel = _ref3.nowLabel,
+        now = _ref3.now,
+        future = _ref3.future,
+        round = _ref3.round;
       // If no step matches, then output an empty string.
       if (!step) {
         return;
       }
       if (step.format) {
         return step.format(timestamp, this.locale, {
-          formatAs: function formatAs(unit, value) {
+          formatAs: function formatAs(unit, amount) {
             // Mimicks `Intl.RelativeTimeFormat.format()`.
-            return _this.formatValue(value, unit, {
+            return _this2.formatValue(amount, unit, {
               labels: labels,
               future: future
             });
@@ -322,9 +401,9 @@ var TimeAgo = exports["default"] = /*#__PURE__*/function () {
      */
   }, {
     key: "formatValue",
-    value: function formatValue(value, unit, _ref3) {
-      var labels = _ref3.labels,
-        future = _ref3.future;
+    value: function formatValue(value, unit, _ref4) {
+      var labels = _ref4.labels,
+        future = _ref4.future;
       return this.getFormattingRule(labels, unit, value, {
         future: future
       }).replace('{0}', this.formatNumber(Math.abs(value)));
@@ -343,8 +422,8 @@ var TimeAgo = exports["default"] = /*#__PURE__*/function () {
      */
   }, {
     key: "getFormattingRule",
-    value: function getFormattingRule(formattingRules, unit, value, _ref4) {
-      var future = _ref4.future;
+    value: function getFormattingRule(formattingRules, unit, value, _ref5) {
+      var future = _ref5.future;
       // Passing the language is required in order to
       // be able to correctly classify the `value` as a number.
       var locale = this.locale;
@@ -477,7 +556,7 @@ TimeAgo.getDefaultLocale = function () {
  * @param  {string} locale
  */
 TimeAgo.setDefaultLocale = function (locale) {
-  return defaultLocale = locale;
+  defaultLocale = locale;
 };
 
 /**
@@ -485,14 +564,19 @@ TimeAgo.setDefaultLocale = function (locale) {
  * @param {Object} localeData
  */
 TimeAgo.addDefaultLocale = function (localeData) {
+  // Warn the user if they've previously already added a default locale (a different one).
   if (defaultLocaleHasBeenSpecified) {
-    return console.error('[javascript-time-ago] `TimeAgo.addDefaultLocale()` can only be called once. To add other locales, use `TimeAgo.addLocale()`.');
+    if (TimeAgo.getDefaultLocale() !== localeData.locale) {
+      console.warn("[javascript-time-ago] You're adding \"".concat(localeData.locale, "\" as the default locale but you have already added \"").concat(TimeAgo.getDefaultLocale(), "\" as the default locale. \"").concat(localeData.locale, "\" is the default locale now."));
+    }
   }
   defaultLocaleHasBeenSpecified = true;
-  TimeAgo.setDefaultLocale(localeData.locale);
+
+  // `addDefaultLocale()` is just a shortcut to `addLocale()` + `setDefaultLocale()`.
   TimeAgo.addLocale(localeData);
+  TimeAgo.setDefaultLocale(localeData.locale);
 };
-var defaultLocaleHasBeenSpecified;
+var defaultLocaleHasBeenSpecified = false;
 
 /**
  * Adds locale data for a specific locale.
@@ -599,4 +683,22 @@ function getNowLabel(labels, nowLabels, longLabels, future) {
 function isStyle(variable) {
   return typeof variable === 'string' || (0, _isStyleObject["default"])(variable);
 }
+
+// `setTimeout()` function has a bug when it fires immediately
+// when the delay is longer than about `24.85` days.
+// https://stackoverflow.com/questions/3468607/why-does-settimeout-break-for-large-millisecond-delay-values
+//
+// Since `renderLabel()` function uses `setTimeout()` for recursion,
+// that would mean infinite recursion.
+//
+// `setTimeoutSafe()` function works around that bug
+// by capping the delay at the maximum allowed value.
+//
+function setTimeoutSafe(func, delay) {
+  return setTimeout(func, getSafeTimeoutDelay(delay));
+}
+function getSafeTimeoutDelay(delay) {
+  return Math.min(delay, SET_TIMEOUT_MAX_SAFE_DELAY);
+}
+var SET_TIMEOUT_MAX_SAFE_DELAY = 2147483647;
 //# sourceMappingURL=TimeAgo.js.map