@naturalcycles/js-lib 14.199.0 → 14.201.0

package/dist/abort.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Like AbortSignal, but it can "abort itself" via the `.abort()` method.
+ *
+ * Similar to how DeferredPromise is both a Promise and has `.resolve()` and `.reject()` methods.
+ *
+ * This is to simplify the AbortController/AbortSignal usage.
+ *
+ * Before this - you need to keep track of 2 things: AbortController and AbortSignal.
+ *
+ * After - you are good with only AbortableSignal, which can do both.
+ * And it's compatible with AbortSignal (because it extends it).
+ *
+ * @experimental
+ */
+export interface AbortableSignal extends AbortSignal {
+    abort: AbortController['abort'];
+}
+/**
+ * Creates AbortableSignal,
+ * which is like AbortSignal, but can "abort itself" with `.abort()` method.
+ *
+ * @experimental
+ */
+export declare function createAbortableSignal(): AbortableSignal;

package/dist/abort.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAbortableSignal = void 0;
+/**
+ * Creates AbortableSignal,
+ * which is like AbortSignal, but can "abort itself" with `.abort()` method.
+ *
+ * @experimental
+ */
+function createAbortableSignal() {
+    const ac = new AbortController();
+    return Object.assign(ac.signal, {
+        abort: ac.abort.bind(ac),
+    });
+}
+exports.createAbortableSignal = createAbortableSignal;

package/dist/array/array.util.d.ts

@@ -1,4 +1,4 @@
-import type { FalsyValue, Mapper, Predicate, SortDirection, StringMap } from '../types';
+import { AbortablePredicate, FalsyValue, Mapper, Predicate, SortDirection, StringMap } from '../types';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -110,6 +110,10 @@ export declare function _takeWhile<T>(items: T[], predicate: Predicate<T>): T[];
 export declare function _takeRightWhile<T>(items: T[], predicate: Predicate<T>): T[];
 export declare function _dropWhile<T>(items: T[], predicate: Predicate<T>): T[];
 export declare function _dropRightWhile<T>(items: T[], predicate: Predicate<T>): T[];
+/**
+ * Counts how many items match the predicate.
+ */
+export declare function _count<T>(items: T[], predicate: AbortablePredicate<T>): number;
 export declare function _countBy<T>(items: T[], mapper: Mapper<T, any>): StringMap<number>;
 /**
  * @example

package/dist/array/array.util.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
+exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
+const types_1 = require("../types");
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -200,6 +201,21 @@ function _dropRightWhile(items, predicate) {
         .reverse();
 }
 exports._dropRightWhile = _dropRightWhile;
+/**
+ * Counts how many items match the predicate.
+ */
+function _count(items, predicate) {
+    let count = 0;
+    for (const [i, item] of items.entries()) {
+        const r = predicate(item, i);
+        if (r === types_1.END)
+            break;
+        if (r)
+            count++;
+    }
+    return count;
+}
+exports._count = _count;
 function _countBy(items, mapper) {
     const map = {};
     items.forEach((item, index) => {

package/dist/index.d.ts

@@ -81,6 +81,7 @@ export * from './env/buildInfo';
 export * from './form.util';
 export * from './semver';
 export * from './web';
+export * from './abort';
 export * from './polyfill';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';

package/dist/index.js

@@ -85,6 +85,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("./abort"), exports);
 tslib_1.__exportStar(require("./polyfill"), exports);
 tslib_1.__exportStar(require("./zod/zod.util"), exports);
 tslib_1.__exportStar(require("./zod/zod.shared.schemas"), exports);

package/dist-esm/abort.js

@@ -0,0 +1,12 @@
+/**
+ * Creates AbortableSignal,
+ * which is like AbortSignal, but can "abort itself" with `.abort()` method.
+ *
+ * @experimental
+ */
+export function createAbortableSignal() {
+    const ac = new AbortController();
+    return Object.assign(ac.signal, {
+        abort: ac.abort.bind(ac),
+    });
+}

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

@@ -1,4 +1,5 @@
 import { _isNotNullish } from '../is.util';
+import { END, } from '../types';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -182,6 +183,20 @@ export function _dropRightWhile(items, predicate) {
         .filter((v, index) => (proceed || (proceed = !predicate(v, index))))
         .reverse();
 }
+/**
+ * Counts how many items match the predicate.
+ */
+export function _count(items, predicate) {
+    let count = 0;
+    for (const [i, item] of items.entries()) {
+        const r = predicate(item, i);
+        if (r === END)
+            break;
+        if (r)
+            count++;
+    }
+    return count;
+}
 export function _countBy(items, mapper) {
     const map = {};
     items.forEach((item, index) => {

package/dist-esm/index.js

@@ -81,6 +81,7 @@ export * from './env/buildInfo';
 export * from './form.util';
 export * from './semver';
 export * from './web';
+export * from './abort';
 export * from './polyfill';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';

package/package.json

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

package/src/abort.ts

@@ -0,0 +1,30 @@
+/**
+ * Like AbortSignal, but it can "abort itself" via the `.abort()` method.
+ *
+ * Similar to how DeferredPromise is both a Promise and has `.resolve()` and `.reject()` methods.
+ *
+ * This is to simplify the AbortController/AbortSignal usage.
+ *
+ * Before this - you need to keep track of 2 things: AbortController and AbortSignal.
+ *
+ * After - you are good with only AbortableSignal, which can do both.
+ * And it's compatible with AbortSignal (because it extends it).
+ *
+ * @experimental
+ */
+export interface AbortableSignal extends AbortSignal {
+  abort: AbortController['abort']
+}
+
+/**
+ * Creates AbortableSignal,
+ * which is like AbortSignal, but can "abort itself" with `.abort()` method.
+ *
+ * @experimental
+ */
+export function createAbortableSignal(): AbortableSignal {
+  const ac = new AbortController()
+  return Object.assign(ac.signal, {
+    abort: ac.abort.bind(ac),
+  })
+}

package/src/array/array.util.ts

@@ -1,5 +1,13 @@
 import { _isNotNullish } from '../is.util'
-import type { FalsyValue, Mapper, Predicate, SortDirection, StringMap } from '../types'
+import {
+  AbortablePredicate,
+  END,
+  FalsyValue,
+  Mapper,
+  Predicate,
+  SortDirection,
+  StringMap,
+} from '../types'
 
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -216,6 +224,21 @@ export function _dropRightWhile<T>(items: T[], predicate: Predicate<T>): T[] {
     .reverse()
 }
 
+/**
+ * Counts how many items match the predicate.
+ */
+export function _count<T>(items: T[], predicate: AbortablePredicate<T>): number {
+  let count = 0
+
+  for (const [i, item] of items.entries()) {
+    const r = predicate(item, i)
+    if (r === END) break
+    if (r) count++
+  }
+
+  return count
+}
+
 export function _countBy<T>(items: T[], mapper: Mapper<T, any>): StringMap<number> {
   const map: StringMap<number> = {}
 

package/src/index.ts

@@ -81,6 +81,7 @@ export * from './env/buildInfo'
 export * from './form.util'
 export * from './semver'
 export * from './web'
+export * from './abort'
 export * from './polyfill'
 export * from './zod/zod.util'
 export * from './zod/zod.shared.schemas'