@naturalcycles/js-lib 14.179.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/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/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.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/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())
  */