@naturalcycles/js-lib 14.269.0 → 14.270.1

package/dist/browser/topbar.js

@@ -108,7 +108,7 @@ exports.topbar = {
             return currentProgress;
         }
         if (typeof to === 'string') {
-            to = (to.indexOf('+') >= 0 || to.indexOf('-') >= 0 ? currentProgress : 0) + parseFloat(to);
+            to = (to.includes('+') || to.includes('-') ? currentProgress : 0) + parseFloat(to);
         }
         currentProgress = to > 1 ? 1 : to;
         repaint();

package/dist/datetime/localTime.js

@@ -52,7 +52,7 @@ class LocalTime {
      * Opposite of `.utc()` method.
      */
     toLocal() {
-        return new LocalTime(new Date(this.$date.getTime()));
+        return new LocalTime(new Date(this.$date));
     }
     /**
      * Returns [cloned] fake LocalTime that has yyyy-mm-dd hh:mm:ss in the provided timezone.

package/dist/decorators/asyncMemo.decorator.d.ts

@@ -1,7 +1,7 @@
 import type { CommonLogger } from '../log/commonLogger';
 import { AnyAsyncFunction, AnyFunction, AnyObject, MaybeParameters } from '../types';
 import { AsyncMemoCache, MethodDecorator } from './memo.util';
-export interface AsyncMemoOptions<T> {
+export interface AsyncMemoOptions<FN> {
     /**
      * Provide a custom implementation of AsyncMemoCache.
      * Function that creates an instance of `AsyncMemoCache`.
@@ -10,7 +10,7 @@ export interface AsyncMemoOptions<T> {
     /**
      * Provide a custom implementation of CacheKey function.
      */
-    cacheKeyFn?: (args: MaybeParameters<T>) => any;
+    cacheKeyFn?: (args: MaybeParameters<FN>) => any;
     /**
      * Default to `console`
      */
@@ -32,7 +32,7 @@ export interface AsyncMemoInstance {
  *
  * @experimental consider normal @_Memo for most of the cases, it's stable and predictable
  */
-export declare const _AsyncMemo: <T>(opt: AsyncMemoOptions<T>) => MethodDecorator<T>;
+export declare const _AsyncMemo: <FN>(opt: AsyncMemoOptions<FN>) => MethodDecorator<FN>;
 /**
  Call it on a method that is decorated with `@_AsyncMemo` to get access to additional functions,
  e.g `clear` to clear the cache, or get its underlying data.

package/dist/decorators/memo.decorator.d.ts

@@ -2,7 +2,7 @@ import type { CommonLogger } from '../log/commonLogger';
 import { AnyFunction, AnyObject, MaybeParameters } from '../types';
 import type { MemoCache } from './memo.util';
 import { MethodDecorator } from './memo.util';
-export interface MemoOptions<T> {
+export interface MemoOptions<FN> {
     /**
      * Provide a custom implementation of MemoCache.
      * Function that creates an instance of `MemoCache`.
@@ -12,7 +12,7 @@ export interface MemoOptions<T> {
     /**
      * Provide a custom implementation of CacheKey function.
      */
-    cacheKeyFn?: (args: MaybeParameters<T>) => any;
+    cacheKeyFn?: (args: MaybeParameters<FN>) => any;
     /**
      * Default to `console`
      */
@@ -46,7 +46,7 @@ export interface MemoInstance {
  * http://inlehmansterms.net/2015/03/01/javascript-memoization/
  * https://community.risingstack.com/the-worlds-fastest-javascript-memoization-library/
  */
-export declare const _Memo: <T>(opt?: MemoOptions<T>) => MethodDecorator<T>;
+export declare const _Memo: <FN>(opt?: MemoOptions<FN>) => MethodDecorator<FN>;
 /**
  Call it on a method that is decorated with `@_Memo` to get access to additional functions,
  e.g `clear` to clear the cache, or get its underlying data.

package/dist/decorators/memoFn.d.ts

@@ -11,4 +11,4 @@ export interface MemoizedFunction {
  *
  * @experimental
  */
-export declare function _memoFn<T extends AnyFunction>(fn: T, opt?: MemoOptions<T>): T & MemoizedFunction;
+export declare function _memoFn<FN extends AnyFunction>(fn: FN, opt?: MemoOptions<FN>): FN & MemoizedFunction;

package/dist/decorators/memoFnAsync.d.ts

@@ -7,4 +7,4 @@ export interface MemoizedAsyncFunction {
 /**
  * @experimental
  */
-export declare function _memoFnAsync<T extends AnyAsyncFunction>(fn: T, opt: AsyncMemoOptions<T>): T & MemoizedAsyncFunction;
+export declare function _memoFnAsync<FN extends AnyAsyncFunction>(fn: FN, opt: AsyncMemoOptions<FN>): FN & MemoizedAsyncFunction;

package/dist/types.d.ts

@@ -100,7 +100,7 @@ export type LazyNullablePromise<T> = () => Promise<T | null>;
 /**
  * Evaluates to the parameters if T is a function, otherwise never
  */
-export type MaybeParameters<T> = T extends AnyFunction ? Parameters<T> : never;
+export type MaybeParameters<FN> = FN extends AnyFunction ? Parameters<FN> : never;
 /**
  * Symbol to indicate END of Sequence.
  */
@@ -196,6 +196,13 @@ export type IsoDateTime = Branded<string, 'IsoDateTime'>;
  * @example '2023-09'
  */
 export type MonthId = string;
+/**
+ * Identifies IANA timezone name.
+ * Branded type.
+ *
+ * @example 'America/New_York'
+ */
+export type IanaTimezone = Branded<string, 'IanaTimezone'>;
 /**
  * Branded UnixTimestamp in seconds.
  * Extends (compatible with) `number`.

package/dist-esm/browser/topbar.js

@@ -105,7 +105,7 @@ export const topbar = {
             return currentProgress;
         }
         if (typeof to === 'string') {
-            to = (to.indexOf('+') >= 0 || to.indexOf('-') >= 0 ? currentProgress : 0) + parseFloat(to);
+            to = (to.includes('+') || to.includes('-') ? currentProgress : 0) + parseFloat(to);
         }
         currentProgress = to > 1 ? 1 : to;
         repaint();

package/dist-esm/datetime/localTime.js

@@ -49,7 +49,7 @@ export class LocalTime {
      * Opposite of `.utc()` method.
      */
     toLocal() {
-        return new LocalTime(new Date(this.$date.getTime()));
+        return new LocalTime(new Date(this.$date));
     }
     /**
      * Returns [cloned] fake LocalTime that has yyyy-mm-dd hh:mm:ss in the provided timezone.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.269.0",
+  "version": "14.270.1",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build-esm-cjs",

package/src/browser/topbar.ts

@@ -120,7 +120,7 @@ export const topbar = {
       return currentProgress
     }
     if (typeof to === 'string') {
-      to = (to.indexOf('+') >= 0 || to.indexOf('-') >= 0 ? currentProgress : 0) + parseFloat(to)
+      to = (to.includes('+') || to.includes('-') ? currentProgress : 0) + parseFloat(to)
     }
     currentProgress = (to as number) > 1 ? 1 : to
     repaint()

package/src/datetime/localTime.ts

@@ -84,7 +84,7 @@ export class LocalTime {
    * Opposite of `.utc()` method.
    */
   toLocal(): LocalTime {
-    return new LocalTime(new Date(this.$date.getTime()))
+    return new LocalTime(new Date(this.$date))
   }
 
   /**

package/src/decorators/asyncMemo.decorator.ts

@@ -11,7 +11,7 @@ import {
 import { _getTargetMethodSignature } from './decorator.util'
 import { AsyncMemoCache, jsonMemoSerializer, MethodDecorator } from './memo.util'
 
-export interface AsyncMemoOptions<T> {
+export interface AsyncMemoOptions<FN> {
   /**
    * Provide a custom implementation of AsyncMemoCache.
    * Function that creates an instance of `AsyncMemoCache`.
@@ -21,7 +21,7 @@ export interface AsyncMemoOptions<T> {
   /**
    * Provide a custom implementation of CacheKey function.
    */
-  cacheKeyFn?: (args: MaybeParameters<T>) => any
+  cacheKeyFn?: (args: MaybeParameters<FN>) => any
 
   /**
    * Default to `console`
@@ -50,7 +50,7 @@ export interface AsyncMemoInstance {
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export const _AsyncMemo =
-  <T>(opt: AsyncMemoOptions<T>): MethodDecorator<T> =>
+  <FN>(opt: AsyncMemoOptions<FN>): MethodDecorator<FN> =>
   (target, key, descriptor) => {
     _assertTypeOf<AnyFunction>(
       descriptor.value,
@@ -75,7 +75,7 @@ export const _AsyncMemo =
     const methodSignature = _getTargetMethodSignature(target, keyStr)
 
     // eslint-disable-next-line @typescript-eslint/promise-function-async
-    descriptor.value = function (this: typeof target, ...args: MaybeParameters<T>): Promise<any> {
+    descriptor.value = function (this: typeof target, ...args: MaybeParameters<FN>): Promise<any> {
       const ctx = this
       const cacheKey = cacheKeyFn(args)
 

package/src/decorators/memo.decorator.ts

@@ -5,7 +5,7 @@ import { _getTargetMethodSignature } from './decorator.util'
 import type { MemoCache } from './memo.util'
 import { jsonMemoSerializer, MapMemoCache, MethodDecorator } from './memo.util'
 
-export interface MemoOptions<T> {
+export interface MemoOptions<FN> {
   /**
    * Provide a custom implementation of MemoCache.
    * Function that creates an instance of `MemoCache`.
@@ -16,7 +16,7 @@ export interface MemoOptions<T> {
   /**
    * Provide a custom implementation of CacheKey function.
    */
-  cacheKeyFn?: (args: MaybeParameters<T>) => any
+  cacheKeyFn?: (args: MaybeParameters<FN>) => any
 
   /**
    * Default to `console`
@@ -57,7 +57,7 @@ export interface MemoInstance {
  */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export const _Memo =
-  <T>(opt: MemoOptions<T> = {}): MethodDecorator<T> =>
+  <FN>(opt: MemoOptions<FN> = {}): MethodDecorator<FN> =>
   (target, key, descriptor) => {
     _assertTypeOf<AnyFunction>(
       descriptor.value,
@@ -85,7 +85,7 @@ export const _Memo =
     const keyStr = String(key)
     const methodSignature = _getTargetMethodSignature(target, keyStr)
 
-    descriptor.value = function (this: typeof target, ...args: MaybeParameters<T>): any {
+    descriptor.value = function (this: typeof target, ...args: MaybeParameters<FN>): any {
       const ctx = this
       const cacheKey = cacheKeyFn(args)
 

package/src/decorators/memoFn.ts

@@ -14,10 +14,10 @@ export interface MemoizedFunction {
  *
  * @experimental
  */
-export function _memoFn<T extends AnyFunction>(
-  fn: T,
-  opt: MemoOptions<T> = {},
-): T & MemoizedFunction {
+export function _memoFn<FN extends AnyFunction>(
+  fn: FN,
+  opt: MemoOptions<FN> = {},
+): FN & MemoizedFunction {
   const {
     logger = console,
     cacheFactory = () => new MapMemoCache(),
@@ -26,7 +26,7 @@ export function _memoFn<T extends AnyFunction>(
 
   const cache = cacheFactory()
 
-  const memoizedFn = function (this: any, ...args: MaybeParameters<T>): T {
+  const memoizedFn = function (this: any, ...args: MaybeParameters<FN>): FN {
     const ctx = this
     const cacheKey = cacheKeyFn(args)
 
@@ -46,5 +46,5 @@ export function _memoFn<T extends AnyFunction>(
   }
 
   Object.assign(memoizedFn, { cache })
-  return memoizedFn as T & MemoizedFunction
+  return memoizedFn as FN & MemoizedFunction
 }

package/src/decorators/memoFnAsync.ts

@@ -10,10 +10,10 @@ export interface MemoizedAsyncFunction {
 /**
  * @experimental
  */
-export function _memoFnAsync<T extends AnyAsyncFunction>(
-  fn: T,
-  opt: AsyncMemoOptions<T>,
-): T & MemoizedAsyncFunction {
+export function _memoFnAsync<FN extends AnyAsyncFunction>(
+  fn: FN,
+  opt: AsyncMemoOptions<FN>,
+): FN & MemoizedAsyncFunction {
   const {
     logger = console,
     cacheFactory = () => new MapMemoCache(),
@@ -22,7 +22,7 @@ export function _memoFnAsync<T extends AnyAsyncFunction>(
 
   const cache = cacheFactory()
 
-  const memoizedFn = async function (this: any, ...args: MaybeParameters<T>): Promise<any> {
+  const memoizedFn = async function (this: any, ...args: MaybeParameters<FN>): Promise<any> {
     const ctx = this
     const cacheKey = cacheKeyFn(args)
     let value: any
@@ -51,5 +51,5 @@ export function _memoFnAsync<T extends AnyAsyncFunction>(
   }
 
   Object.assign(memoizedFn, { cache })
-  return memoizedFn as T & MemoizedAsyncFunction
+  return memoizedFn as FN & MemoizedAsyncFunction
 }

package/src/types.ts

@@ -122,7 +122,7 @@ export type LazyNullablePromise<T> = () => Promise<T | null>
 /**
  * Evaluates to the parameters if T is a function, otherwise never
  */
-export type MaybeParameters<T> = T extends AnyFunction ? Parameters<T> : never
+export type MaybeParameters<FN> = FN extends AnyFunction ? Parameters<FN> : never
 
 /**
  * Symbol to indicate END of Sequence.
@@ -254,6 +254,14 @@ export type IsoDateTime = Branded<string, 'IsoDateTime'>
  */
 export type MonthId = string
 
+/**
+ * Identifies IANA timezone name.
+ * Branded type.
+ *
+ * @example 'America/New_York'
+ */
+export type IanaTimezone = Branded<string, 'IanaTimezone'>
+
 /**
  * Branded UnixTimestamp in seconds.
  * Extends (compatible with) `number`.