@naturalcycles/js-lib 14.179.0 → 14.181.0

package/dist/datetime/localDate.d.ts

@@ -97,3 +97,9 @@ export declare class LocalDate {
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
  */
 export declare function localDate(d?: LocalDateInput): 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): LocalDate | undefined;

package/dist/datetime/localDate.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localDate = exports.LocalDate = void 0;
+exports.localDateOrUndefined = 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];
@@ -418,3 +418,12 @@ function localDate(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
 exports.localDate = 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.
+ */
+function localDateOrUndefined(d) {
+    return d ? LocalDate.of(d) : undefined;
+}
+exports.localDateOrUndefined = localDateOrUndefined;

package/dist/datetime/localTime.d.ts

@@ -126,3 +126,9 @@ export declare class LocalTime {
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`
  */
 export declare function localTime(d?: LocalTimeInput): 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): LocalTime | undefined;

package/dist/datetime/localTime.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
+exports.localTimeOrUndefined = 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");
@@ -495,6 +495,15 @@ function localTime(d) {
     return d ? LocalTime.of(d) : LocalTime.now();
 }
 exports.localTime = 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.
+ */
+function localTimeOrUndefined(d) {
+    return d ? LocalTime.of(d) : undefined;
+}
+exports.localTimeOrUndefined = localTimeOrUndefined;
 // 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/index.d.ts

@@ -80,6 +80,7 @@ export * from './env/buildInfo';
 export * from './form.util';
 export * from './semver';
 export * from './web';
+export * from './polyfill';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';
 import { z, ZodSchema, ZodError, ZodIssue } from 'zod';

package/dist/index.js

@@ -84,6 +84,7 @@ tslib_1.__exportStar(require("./env/buildInfo"), exports);
 tslib_1.__exportStar(require("./form.util"), exports);
 tslib_1.__exportStar(require("./semver"), exports);
 tslib_1.__exportStar(require("./web"), exports);
+tslib_1.__exportStar(require("./polyfill"), exports);
 tslib_1.__exportStar(require("./zod/zod.util"), exports);
 tslib_1.__exportStar(require("./zod/zod.shared.schemas"), exports);
 const zod_1 = require("zod");

package/dist/polyfill.d.ts

@@ -0,0 +1 @@
+export declare function polyfillDispose(): void;

package/dist/polyfill.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.polyfillDispose = void 0;
+function polyfillDispose() {
+    // @ts-expect-error polyfill
+    Symbol.dispose ??= Symbol('Symbol.dispose');
+    // @ts-expect-error polyfill
+    Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose');
+}
+exports.polyfillDispose = polyfillDispose;

package/dist/time/time.util.d.ts

@@ -1,3 +1,13 @@
+/**
+ * using _ = blockTimer()
+ * // will log "took 1.234 sec" on dispose
+ *
+ * using _ = blockTimer('named')
+ * // will log "named took 1.234 sec" on dispose
+ *
+ * @experimental
+ */
+export declare function _blockTimer(name?: string): Disposable;
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */

package/dist/time/time.util.js

@@ -1,6 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._ms = exports._since = void 0;
+exports._ms = exports._since = exports._blockTimer = void 0;
+/**
+ * using _ = blockTimer()
+ * // will log "took 1.234 sec" on dispose
+ *
+ * using _ = blockTimer('named')
+ * // will log "named took 1.234 sec" on dispose
+ *
+ * @experimental
+ */
+function _blockTimer(name) {
+    const started = Date.now();
+    return {
+        [Symbol.dispose]() {
+            console.log(`${name ? name + ' ' : ''}took ${_since(started)}`);
+        },
+    };
+}
+exports._blockTimer = _blockTimer;
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */

package/dist-esm/datetime/localDate.js

@@ -413,3 +413,11 @@ export class LocalDate {
 export function localDate(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
+/**
+ * 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 function localDateOrUndefined(d) {
+    return d ? LocalDate.of(d) : undefined;
+}

package/dist-esm/datetime/localTime.js

@@ -491,6 +491,14 @@ export class LocalTime {
 export function localTime(d) {
     return d ? LocalTime.of(d) : LocalTime.now();
 }
+/**
+ * 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 function localTimeOrUndefined(d) {
+    return d ? LocalTime.of(d) : undefined;
+}
 // 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/index.js

@@ -80,6 +80,7 @@ export * from './env/buildInfo';
 export * from './form.util';
 export * from './semver';
 export * from './web';
+export * from './polyfill';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';
 import { z, ZodSchema, ZodError } from 'zod';

package/dist-esm/polyfill.js

@@ -0,0 +1,7 @@
+export function polyfillDispose() {
+    var _a, _b;
+    // @ts-expect-error polyfill
+    (_a = Symbol.dispose) !== null && _a !== void 0 ? _a : (Symbol.dispose = Symbol('Symbol.dispose'));
+    // @ts-expect-error polyfill
+    (_b = Symbol.asyncDispose) !== null && _b !== void 0 ? _b : (Symbol.asyncDispose = Symbol('Symbol.asyncDispose'));
+}

package/dist-esm/time/time.util.js

@@ -1,3 +1,20 @@
+/**
+ * using _ = blockTimer()
+ * // will log "took 1.234 sec" on dispose
+ *
+ * using _ = blockTimer('named')
+ * // will log "named took 1.234 sec" on dispose
+ *
+ * @experimental
+ */
+export function _blockTimer(name) {
+    const started = Date.now();
+    return {
+        [Symbol.dispose]() {
+            console.log(`${name ? name + ' ' : ''}took ${_since(started)}`);
+        },
+    };
+}
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */

package/package.json

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

package/src/datetime/localDate.ts

@@ -510,3 +510,12 @@ export class LocalDate {
 export function localDate(d?: LocalDateInput): LocalDate {
   return d ? LocalDate.of(d) : LocalDate.today()
 }
+
+/**
+ * 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 function localDateOrUndefined(d?: LocalDateInput): LocalDate | undefined {
+  return d ? LocalDate.of(d) : undefined
+}

package/src/datetime/localTime.ts

@@ -603,6 +603,15 @@ export function localTime(d?: LocalTimeInput): LocalTime {
   return d ? LocalTime.of(d) : LocalTime.now()
 }
 
+/**
+ * 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 function localTimeOrUndefined(d?: LocalTimeInput): LocalTime | undefined {
+  return d ? LocalTime.of(d) : undefined
+}
+
 // 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/index.ts

@@ -80,6 +80,7 @@ export * from './env/buildInfo'
 export * from './form.util'
 export * from './semver'
 export * from './web'
+export * from './polyfill'
 export * from './zod/zod.util'
 export * from './zod/zod.shared.schemas'
 import { z, ZodSchema, ZodError, ZodIssue } from 'zod'

package/src/polyfill.ts

@@ -0,0 +1,6 @@
+export function polyfillDispose(): void {
+  // @ts-expect-error polyfill
+  Symbol.dispose ??= Symbol('Symbol.dispose')
+  // @ts-expect-error polyfill
+  Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose')
+}

package/src/time/time.util.ts

@@ -1,3 +1,21 @@
+/**
+ * using _ = blockTimer()
+ * // will log "took 1.234 sec" on dispose
+ *
+ * using _ = blockTimer('named')
+ * // will log "named took 1.234 sec" on dispose
+ *
+ * @experimental
+ */
+export function _blockTimer(name?: string): Disposable {
+  const started = Date.now()
+  return {
+    [Symbol.dispose](): void {
+      console.log(`${name ? name + ' ' : ''}took ${_since(started)}`)
+    },
+  } as any
+}
+
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */