@naturalcycles/js-lib 15.64.0 → 15.66.0

package/dist/datetime/localTime.d.ts

@@ -313,11 +313,6 @@ declare class LocalTimeFactory {
     fromMillis(millis: UnixTimestampMillis): LocalTime;
     fromDateTimeObject(o: DateTimeObjectInput): LocalTime;
     private createDateFromDateTimeObject;
-    /**
-     * Returns the IANA timezone e.g `Europe/Stockholm`.
-     * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
-    getTimezone(): IANATimezone;
     /**
      * Returns true if passed IANA timezone is valid/supported.
      * E.g `Europe/Stockholm` is valid, but `Europe/Stockholm2` is not.

package/dist/datetime/localTime.js

@@ -852,13 +852,6 @@ class LocalTimeFactory {
     //     input,
     //   })
     // }
-    /**
-     * Returns the IANA timezone e.g `Europe/Stockholm`.
-     * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
-    getTimezone() {
-        return Intl.DateTimeFormat().resolvedOptions().timeZone;
-    }
     /**
      * Returns true if passed IANA timezone is valid/supported.
      * E.g `Europe/Stockholm` is valid, but `Europe/Stockholm2` is not.

package/dist/intl/intl.d.ts

@@ -0,0 +1,26 @@
+import type { IANATimezone } from '../types.js';
+/**
+ * Returns cached Intl.* formatters, because they are known to be
+ * very slow to create.
+ *
+ * See https://github.com/poppinss/intl-formatter
+ *
+ * Methods accept non-optional arguments consciously,
+ * to be able to cache them better. Just pass {} for options.
+ */
+declare class MemoizedIntl {
+    /**
+     * Returns the IANA timezone e.g `Europe/Stockholm`.
+     * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
+    getTimezone(): IANATimezone;
+    DateTimeFormat(locales: Intl.LocalesArgument, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+    RelativeTimeFormat(locales: Intl.LocalesArgument, options: Intl.RelativeTimeFormatOptions): Intl.RelativeTimeFormat;
+    NumberFormat(locales: Intl.LocalesArgument, options: Intl.NumberFormatOptions): Intl.NumberFormat;
+    Collator(locales: Intl.LocalesArgument, options: Intl.CollatorOptions): Intl.Collator;
+    PluralRules(locales: Intl.LocalesArgument, options: Intl.PluralRulesOptions): Intl.PluralRules;
+    ListFormat(locales: Intl.LocalesArgument, options: Intl.ListFormatOptions): Intl.ListFormat;
+    DisplayNames(locales: Intl.LocalesArgument, options: Intl.DisplayNamesOptions): Intl.DisplayNames;
+}
+export declare const Intl2: MemoizedIntl;
+export {};

package/dist/intl/intl.js

@@ -0,0 +1,66 @@
+import { __decorate } from "tslib";
+import { _Memo } from '../decorators/memo.decorator.js';
+/**
+ * Returns cached Intl.* formatters, because they are known to be
+ * very slow to create.
+ *
+ * See https://github.com/poppinss/intl-formatter
+ *
+ * Methods accept non-optional arguments consciously,
+ * to be able to cache them better. Just pass {} for options.
+ */
+class MemoizedIntl {
+    /**
+     * Returns the IANA timezone e.g `Europe/Stockholm`.
+     * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     */
+    getTimezone() {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone;
+    }
+    DateTimeFormat(locales, options) {
+        return new Intl.DateTimeFormat(locales, options);
+    }
+    RelativeTimeFormat(locales, options) {
+        return new Intl.RelativeTimeFormat(locales, options);
+    }
+    NumberFormat(locales, options) {
+        return new Intl.NumberFormat(locales, options);
+    }
+    Collator(locales, options) {
+        return new Intl.Collator(locales, options);
+    }
+    PluralRules(locales, options) {
+        return new Intl.PluralRules(locales, options);
+    }
+    ListFormat(locales, options) {
+        return new Intl.ListFormat(locales, options);
+    }
+    DisplayNames(locales, options) {
+        return new Intl.DisplayNames(locales, options);
+    }
+}
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "getTimezone", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "DateTimeFormat", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "RelativeTimeFormat", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "NumberFormat", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "Collator", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "PluralRules", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "ListFormat", null);
+__decorate([
+    _Memo()
+], MemoizedIntl.prototype, "DisplayNames", null);
+export const Intl2 = new MemoizedIntl();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.64.0",
+  "version": "15.66.0",
   "dependencies": {
     "tslib": "^2"
   },
@@ -40,6 +40,7 @@
     "./error": "./dist/error/index.js",
     "./error/*.js": "./dist/error/*.js",
     "./http": "./dist/http/index.js",
+    "./intl": "./dist/intl/intl.js",
     "./log": "./dist/log/commonLogger.js",
     "./math": "./dist/math/index.js",
     "./math/*.js": "./dist/math/*.js",

package/src/datetime/localTime.ts

@@ -1000,14 +1000,6 @@ class LocalTimeFactory {
   //   })
   // }
 
-  /**
-   * Returns the IANA timezone e.g `Europe/Stockholm`.
-   * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-   */
-  getTimezone(): IANATimezone {
-    return Intl.DateTimeFormat().resolvedOptions().timeZone as IANATimezone
-  }
-
   /**
    * Returns true if passed IANA timezone is valid/supported.
    * E.g `Europe/Stockholm` is valid, but `Europe/Stockholm2` is not.

package/src/intl/intl.ts

@@ -0,0 +1,71 @@
+import { _Memo } from '../decorators/memo.decorator.js'
+import type { IANATimezone } from '../types.js'
+
+/**
+ * Returns cached Intl.* formatters, because they are known to be
+ * very slow to create.
+ *
+ * See https://github.com/poppinss/intl-formatter
+ *
+ * Methods accept non-optional arguments consciously,
+ * to be able to cache them better. Just pass {} for options.
+ */
+class MemoizedIntl {
+  /**
+   * Returns the IANA timezone e.g `Europe/Stockholm`.
+   * https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+   */
+  @_Memo()
+  getTimezone(): IANATimezone {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone as IANATimezone
+  }
+
+  @_Memo()
+  DateTimeFormat(
+    locales: Intl.LocalesArgument,
+    options: Intl.DateTimeFormatOptions,
+  ): Intl.DateTimeFormat {
+    return new Intl.DateTimeFormat(locales, options)
+  }
+
+  @_Memo()
+  RelativeTimeFormat(
+    locales: Intl.LocalesArgument,
+    options: Intl.RelativeTimeFormatOptions,
+  ): Intl.RelativeTimeFormat {
+    return new Intl.RelativeTimeFormat(locales, options)
+  }
+
+  @_Memo()
+  NumberFormat(
+    locales: Intl.LocalesArgument,
+    options: Intl.NumberFormatOptions,
+  ): Intl.NumberFormat {
+    return new Intl.NumberFormat(locales, options)
+  }
+
+  @_Memo()
+  Collator(locales: Intl.LocalesArgument, options: Intl.CollatorOptions): Intl.Collator {
+    return new Intl.Collator(locales, options)
+  }
+
+  @_Memo()
+  PluralRules(locales: Intl.LocalesArgument, options: Intl.PluralRulesOptions): Intl.PluralRules {
+    return new Intl.PluralRules(locales, options)
+  }
+
+  @_Memo()
+  ListFormat(locales: Intl.LocalesArgument, options: Intl.ListFormatOptions): Intl.ListFormat {
+    return new Intl.ListFormat(locales, options)
+  }
+
+  @_Memo()
+  DisplayNames(
+    locales: Intl.LocalesArgument,
+    options: Intl.DisplayNamesOptions,
+  ): Intl.DisplayNames {
+    return new Intl.DisplayNames(locales, options)
+  }
+}
+
+export const Intl2 = new MemoizedIntl()