@naturalcycles/js-lib 14.178.0 → 14.180.0

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/is.util.d.ts

@@ -23,9 +23,9 @@ export declare const _isFalsy: <T>(v: T) => v is Falsy<T>;
 /**
  * Returns true if item is Object, not null and not Array.
  */
-export declare function _isObject(item: any): item is AnyObject;
+export declare function _isObject(obj: any): obj is AnyObject;
 export declare function _isPrimitive(v: any): v is Primitive;
-export declare function _isEmptyObject(obj: any): boolean;
+export declare function _isEmptyObject(obj: AnyObject): boolean;
 /**
  * Object is considered empty if it's one of:
  * undefined

package/dist/is.util.js

@@ -27,8 +27,8 @@ exports._isFalsy = _isFalsy;
 /**
  * Returns true if item is Object, not null and not Array.
  */
-function _isObject(item) {
-    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
+function _isObject(obj) {
+    return obj?.constructor === Object;
 }
 exports._isObject = _isObject;
 function _isPrimitive(v) {
@@ -42,7 +42,7 @@ function _isPrimitive(v) {
 }
 exports._isPrimitive = _isPrimitive;
 function _isEmptyObject(obj) {
-    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
+    return Object.keys(obj).length === 0;
 }
 exports._isEmptyObject = _isEmptyObject;
 /**

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/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/is.util.js

@@ -18,8 +18,8 @@ export const _isFalsy = (v) => !v;
 /**
  * Returns true if item is Object, not null and not Array.
  */
-export function _isObject(item) {
-    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
+export function _isObject(obj) {
+    return (obj === null || obj === void 0 ? void 0 : obj.constructor) === Object;
 }
 export function _isPrimitive(v) {
     return (v === null ||
@@ -31,7 +31,7 @@ export function _isPrimitive(v) {
         typeof v === 'symbol');
 }
 export function _isEmptyObject(obj) {
-    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
+    return Object.keys(obj).length === 0;
 }
 /**
  * Object is considered empty if it's one of:

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.178.0",
+  "version": "14.180.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

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/is.util.ts

@@ -27,8 +27,8 @@ export const _isFalsy = <T>(v: T): v is Falsy<T> => !v
 /**
  * Returns true if item is Object, not null and not Array.
  */
-export function _isObject(item: any): item is AnyObject {
-  return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false
+export function _isObject(obj: any): obj is AnyObject {
+  return obj?.constructor === Object
 }
 
 export function _isPrimitive(v: any): v is Primitive {
@@ -43,8 +43,8 @@ export function _isPrimitive(v: any): v is Primitive {
   )
 }
 
-export function _isEmptyObject(obj: any): boolean {
-  return obj && obj.constructor === Object && Object.keys(obj).length === 0
+export function _isEmptyObject(obj: AnyObject): boolean {
+  return Object.keys(obj).length === 0
 }
 
 /**

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())
  */