@naturalcycles/js-lib 14.181.1 → 14.183.0

package/dist/datetime/localDate.d.ts

@@ -15,7 +15,7 @@ export declare class LocalDate {
     private constructor();
     static create(year: number, month: number, day: number): LocalDate;
     /**
-     * Parses input String into LocalDate.
+     * Parses input into LocalDate.
      * Input can already be a LocalDate - it is returned as-is in that case.
      */
     static of(d: LocalDateInput): LocalDate;
@@ -94,12 +94,20 @@ export declare class LocalDate {
     format(fmt: Intl.DateTimeFormat | LocalDateFormatter): string;
 }
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Convenience wrapper around `LocalDate.of`
  */
-export declare function localDate(d?: LocalDateInput | null): LocalDate;
+export declare function localDate(d: LocalDateInput): LocalDate;
+/**
+ * Convenience wrapper around `LocalDate.today`
+ */
+export declare function localDateToday(): LocalDate;
 /**
  * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
  *
  * `localDate` function will instead return LocalDate of today for falsy input.
  */
 export declare function localDateOrUndefined(d?: LocalDateInput | null): LocalDate | undefined;
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns LocalDate.today.
+ */
+export declare function localDateOrToday(d?: LocalDateInput | null): LocalDate;

package/dist/datetime/localDate.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localDateOrUndefined = exports.localDate = exports.LocalDate = void 0;
+exports.localDateOrToday = exports.localDateOrUndefined = exports.localDateToday = exports.localDate = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
 const localTime_1 = require("./localTime");
 const MDAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -18,7 +18,7 @@ class LocalDate {
         return new LocalDate(year, month, day);
     }
     /**
-     * Parses input String into LocalDate.
+     * Parses input into LocalDate.
      * Input can already be a LocalDate - it is returned as-is in that case.
      */
     static of(d) {
@@ -412,12 +412,19 @@ class LocalDate {
 }
 exports.LocalDate = LocalDate;
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Convenience wrapper around `LocalDate.of`
  */
 function localDate(d) {
-    return d ? LocalDate.of(d) : LocalDate.today();
+    return LocalDate.of(d);
 }
 exports.localDate = localDate;
+/**
+ * Convenience wrapper around `LocalDate.today`
+ */
+function localDateToday() {
+    return LocalDate.today();
+}
+exports.localDateToday = localDateToday;
 /**
  * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
  *
@@ -427,3 +434,10 @@ function localDateOrUndefined(d) {
     return d ? LocalDate.of(d) : undefined;
 }
 exports.localDateOrUndefined = localDateOrUndefined;
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns LocalDate.today.
+ */
+function localDateOrToday(d) {
+    return d ? LocalDate.of(d) : LocalDate.today();
+}
+exports.localDateOrToday = localDateOrToday;

package/dist/datetime/localTime.d.ts

@@ -123,12 +123,20 @@ export declare class LocalTime {
     format(fmt: Intl.DateTimeFormat | LocalTimeFormatter): string;
 }
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Shortcut wrapper around `LocalTime.of`
  */
-export declare function localTime(d?: LocalTimeInput | null): LocalTime;
+export declare function localTime(d: LocalTimeInput): LocalTime;
+/**
+ * Shortcut wrapper around `LocalTime.now`
+ */
+export declare function localTimeNow(): LocalTime;
 /**
  * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
  *
  * `localTime` function will instead return LocalTime of `now` for falsy input.
  */
 export declare function localTimeOrUndefined(d?: LocalTimeInput | null): LocalTime | undefined;
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
+ */
+export declare function localTimeOrNow(d?: LocalTimeInput | null): LocalTime;

package/dist/datetime/localTime.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localTimeOrUndefined = exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
+exports.localTimeOrNow = exports.localTimeOrUndefined = exports.localTimeNow = exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
 const assert_1 = require("../error/assert");
 const time_util_1 = require("../time/time.util");
 const localDate_1 = require("./localDate");
@@ -489,12 +489,19 @@ class LocalTime {
 }
 exports.LocalTime = LocalTime;
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Shortcut wrapper around `LocalTime.of`
  */
 function localTime(d) {
-    return d ? LocalTime.of(d) : LocalTime.now();
+    return LocalTime.of(d);
 }
 exports.localTime = localTime;
+/**
+ * Shortcut wrapper around `LocalTime.now`
+ */
+function localTimeNow() {
+    return LocalTime.now();
+}
+exports.localTimeNow = localTimeNow;
 /**
  * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
  *
@@ -504,6 +511,13 @@ function localTimeOrUndefined(d) {
     return d ? LocalTime.of(d) : undefined;
 }
 exports.localTimeOrUndefined = localTimeOrUndefined;
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
+ */
+function localTimeOrNow(d) {
+    return d ? LocalTime.of(d) : LocalTime.now();
+}
+exports.localTimeOrNow = localTimeOrNow;
 // based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
 function getWeek(date) {
     const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime();

package/dist/env/buildInfo.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateBuildInfoDev = void 0;
 const localTime_1 = require("../datetime/localTime");
 function generateBuildInfoDev() {
-    const now = (0, localTime_1.localTime)();
+    const now = (0, localTime_1.localTimeNow)();
     const ts = now.unix();
     const rev = 'devRev';
     const branchName = 'devBranch';

package/dist-esm/datetime/localDate.js

@@ -15,7 +15,7 @@ export class LocalDate {
         return new LocalDate(year, month, day);
     }
     /**
-     * Parses input String into LocalDate.
+     * Parses input into LocalDate.
      * Input can already be a LocalDate - it is returned as-is in that case.
      */
     static of(d) {
@@ -408,10 +408,16 @@ export class LocalDate {
     }
 }
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Convenience wrapper around `LocalDate.of`
  */
 export function localDate(d) {
-    return d ? LocalDate.of(d) : LocalDate.today();
+    return LocalDate.of(d);
+}
+/**
+ * Convenience wrapper around `LocalDate.today`
+ */
+export function localDateToday() {
+    return LocalDate.today();
 }
 /**
  * Creates a LocalDate from the input, unless it's falsy - then returns undefined.
@@ -421,3 +427,9 @@ export function localDate(d) {
 export function localDateOrUndefined(d) {
     return d ? LocalDate.of(d) : undefined;
 }
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns LocalDate.today.
+ */
+export function localDateOrToday(d) {
+    return d ? LocalDate.of(d) : LocalDate.today();
+}

package/dist-esm/datetime/localTime.js

@@ -486,10 +486,16 @@ export class LocalTime {
     }
 }
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Shortcut wrapper around `LocalTime.of`
  */
 export function localTime(d) {
-    return d ? LocalTime.of(d) : LocalTime.now();
+    return LocalTime.of(d);
+}
+/**
+ * Shortcut wrapper around `LocalTime.now`
+ */
+export function localTimeNow() {
+    return LocalTime.now();
 }
 /**
  * Creates a LocalTime from the input, unless it's falsy - then returns undefined.
@@ -499,6 +505,12 @@ export function localTime(d) {
 export function localTimeOrUndefined(d) {
     return d ? LocalTime.of(d) : undefined;
 }
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
+ */
+export function localTimeOrNow(d) {
+    return d ? LocalTime.of(d) : LocalTime.now();
+}
 // based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
 function getWeek(date) {
     const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime();

package/dist-esm/env/buildInfo.js

@@ -1,6 +1,6 @@
-import { localTime } from '../datetime/localTime';
+import { localTimeNow } from '../datetime/localTime';
 export function generateBuildInfoDev() {
-    const now = localTime();
+    const now = localTimeNow();
     const ts = now.unix();
     const rev = 'devRev';
     const branchName = 'devBranch';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.181.1",
+  "version": "14.183.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/datetime/localDate.ts

@@ -32,7 +32,7 @@ export class LocalDate {
   }
 
   /**
-   * Parses input String into LocalDate.
+   * Parses input into LocalDate.
    * Input can already be a LocalDate - it is returned as-is in that case.
    */
   static of(d: LocalDateInput): LocalDate {
@@ -505,10 +505,17 @@ export class LocalDate {
 }
 
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Convenience wrapper around `LocalDate.of`
  */
-export function localDate(d?: LocalDateInput | null): LocalDate {
-  return d ? LocalDate.of(d) : LocalDate.today()
+export function localDate(d: LocalDateInput): LocalDate {
+  return LocalDate.of(d)
+}
+
+/**
+ * Convenience wrapper around `LocalDate.today`
+ */
+export function localDateToday(): LocalDate {
+  return LocalDate.today()
 }
 
 /**
@@ -519,3 +526,10 @@ export function localDate(d?: LocalDateInput | null): LocalDate {
 export function localDateOrUndefined(d?: LocalDateInput | null): LocalDate | undefined {
   return d ? LocalDate.of(d) : undefined
 }
+
+/**
+ * Creates a LocalDate from the input, unless it's falsy - then returns LocalDate.today.
+ */
+export function localDateOrToday(d?: LocalDateInput | null): LocalDate {
+  return d ? LocalDate.of(d) : LocalDate.today()
+}

package/src/datetime/localTime.ts

@@ -597,10 +597,17 @@ export class LocalTime {
 }
 
 /**
- * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
+ * Shortcut wrapper around `LocalTime.of`
  */
-export function localTime(d?: LocalTimeInput | null): LocalTime {
-  return d ? LocalTime.of(d) : LocalTime.now()
+export function localTime(d: LocalTimeInput): LocalTime {
+  return LocalTime.of(d)
+}
+
+/**
+ * Shortcut wrapper around `LocalTime.now`
+ */
+export function localTimeNow(): LocalTime {
+  return LocalTime.now()
 }
 
 /**
@@ -612,6 +619,13 @@ export function localTimeOrUndefined(d?: LocalTimeInput | null): LocalTime | und
   return d ? LocalTime.of(d) : undefined
 }
 
+/**
+ * Creates a LocalTime from the input, unless it's falsy - then returns LocalTime.now
+ */
+export function localTimeOrNow(d?: LocalTimeInput | null): LocalTime {
+  return d ? LocalTime.of(d) : LocalTime.now()
+}
+
 // based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
 function getWeek(date: Date): number {
   const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime()

package/src/env/buildInfo.ts

@@ -1,4 +1,4 @@
-import { localTime } from '../datetime/localTime'
+import { localTimeNow } from '../datetime/localTime'
 import type { UnixTimestampNumber } from '../types'
 
 export interface BuildInfo {
@@ -43,7 +43,7 @@ export interface BuildInfo {
 }
 
 export function generateBuildInfoDev(): BuildInfo {
-  const now = localTime()
+  const now = localTimeNow()
   const ts = now.unix()
   const rev = 'devRev'
   const branchName = 'devBranch'