pepka 1.8.2 → 1.9.0

package/dist/bundle.cjs

@@ -95,6 +95,25 @@ function isFunc(s) { return to(s) === 'function'; }
 const isStr = (s) => (to(s) === 'string');
 const isObj = (s) => (!isNull(s) && to(s) === 'object');
 const isNil = (s) => (isNull(s) || isUndef(s));
+class QPromise extends Promise {
+    ff;
+    rj;
+    cancel(resolve = false) {
+        if (resolve)
+            this.ff();
+        else {
+            this.catch(noop);
+            this.rj('canceled');
+        }
+    }
+    constructor(fn) {
+        super((ff, rj) => {
+            this.ff = ff;
+            this.rj = rj;
+            return fn(ff, rj);
+        });
+    }
+}
 
 // It's faster that toUpperCase() !
 const caseMap = { u: 'U', b: 'B', n: 'N', s: 'S', f: 'F', o: 'O' };
@@ -398,6 +417,7 @@ const noop = (() => { });
  * @param {string} fnName - property name of the function.
  * @param {AnyObject} o - the object with the function. */
 const callFrom = curry((args, fn, o) => o[fn](...args));
+// FIXME: complement(flip(includes)) -> one arg fn!
 const complement = (fn) => (...args) => {
     const out = fn(...args);
     const f = isFunc(out);
@@ -656,7 +676,7 @@ const qwaitAll = async (xs) => new Promise((ff, rj) => {
  */
 const waitTap = curry2(async (fn, s) => { await fn(s); return s; });
 /** Waits for all promises mapped by the fn. */
-const forEachAsync = curry2((fn, items) => Promise.all(items.map(fn)));
+const forEachParallel = curry2((fn, items) => Promise.all(items.map(fn)));
 /** The same as compose, but waits for promises in chains and returns a Promise.  */
 const composeAsync = (() => {
     const pipe = async (fns, input, i) => ~i ? await pipe(fns, [await fns[i](...input)], --i) : head(input);
@@ -765,12 +785,13 @@ const throttle = (time, fn) => {
         return res;
     };
 };
-const wait = (time) => new Promise((ff) => setTimeout(ff, time));
+const wait = (time) => new QPromise((ff) => setTimeout(ff, time));
 
 // TODO: possibly introduce a second argument limiting unfolding.
 const uncurry = (fn) => (...args) => qreduce(((fn, arg) => fn ? fn(arg) : fn), fn, args);
 
 exports.F = F;
+exports.QPromise = QPromise;
 exports.T = T;
 exports.__ = __;
 exports.add = add;
@@ -812,7 +833,7 @@ exports.flatShallow = flatShallow;
 exports.flatTo = flatTo;
 exports.flip = flip;
 exports.forEach = forEach;
-exports.forEachAsync = forEachAsync;
+exports.forEachParallel = forEachParallel;
 exports.forEachSerial = forEachSerial;
 exports.freeze = freeze;
 exports.freezeShallow = freezeShallow;

package/dist/bundle.d.ts

@@ -63,7 +63,7 @@ export declare const waitTap: {
 	(a: AnyFunc<Promise<any>>, b: any): Promise<any>;
 };
 /** Waits for all promises mapped by the fn. */
-export declare const forEachAsync: {
+export declare const forEachParallel: {
 	(a: Placeholder, b: any[]): (a: (item: any) => Promise<any>) => Promise<any[]>;
 	(a: (item: any) => Promise<any>, b: Placeholder): (b: any[]) => Promise<any[]>;
 	(a: (item: any) => Promise<any>): (b: any[]) => Promise<any[]>;
@@ -239,6 +239,15 @@ export declare const qpush: {
 	(a: any, b: any[]): any[];
 };
 export declare const isNil: <T extends any>(s: T) => T extends (null | undefined) ? true : false;
+export declare class QPromise<T> extends Promise<T> {
+	private ff;
+	private rj;
+	cancel(resolve?: boolean): void;
+	constructor(fn: AnyFunc<any, [
+		AnyFunc,
+		AnyFunc
+	]>);
+}
 export declare const take: (argN: number) => (...args: any[]) => any;
 export declare const ifElse: (...args: AnyArgs) => any;
 export declare const when: (...args: AnyArgs) => any;
@@ -774,7 +783,7 @@ type StrTmpl = ((data: AnyObject) => string);
 export declare const getTmpl: (tmpl: string) => StrTmpl;
 export declare const debounce: <T extends AnyFunc>(time: number, fn: T) => (...args: Parameters<T>) => Promise<ReturnType<T>>;
 export declare const throttle: <T extends AnyFunc>(time: number, fn: T) => (...args: Parameters<T>) => any;
-export declare const wait: (time: number) => Promise<unknown>;
+export declare const wait: (time: number) => QPromise<unknown>;
 export declare const uncurry: <Args extends any[] = any[], ReturnT = any>(fn: Curried<Args>) => AnyFunc;
 
 export {

package/dist/bundle.mjs

@@ -93,6 +93,25 @@ function isFunc(s) { return to(s) === 'function'; }
 const isStr = (s) => (to(s) === 'string');
 const isObj = (s) => (!isNull(s) && to(s) === 'object');
 const isNil = (s) => (isNull(s) || isUndef(s));
+class QPromise extends Promise {
+    ff;
+    rj;
+    cancel(resolve = false) {
+        if (resolve)
+            this.ff();
+        else {
+            this.catch(noop);
+            this.rj('canceled');
+        }
+    }
+    constructor(fn) {
+        super((ff, rj) => {
+            this.ff = ff;
+            this.rj = rj;
+            return fn(ff, rj);
+        });
+    }
+}
 
 // It's faster that toUpperCase() !
 const caseMap = { u: 'U', b: 'B', n: 'N', s: 'S', f: 'F', o: 'O' };
@@ -396,6 +415,7 @@ const noop = (() => { });
  * @param {string} fnName - property name of the function.
  * @param {AnyObject} o - the object with the function. */
 const callFrom = curry((args, fn, o) => o[fn](...args));
+// FIXME: complement(flip(includes)) -> one arg fn!
 const complement = (fn) => (...args) => {
     const out = fn(...args);
     const f = isFunc(out);
@@ -654,7 +674,7 @@ const qwaitAll = async (xs) => new Promise((ff, rj) => {
  */
 const waitTap = curry2(async (fn, s) => { await fn(s); return s; });
 /** Waits for all promises mapped by the fn. */
-const forEachAsync = curry2((fn, items) => Promise.all(items.map(fn)));
+const forEachParallel = curry2((fn, items) => Promise.all(items.map(fn)));
 /** The same as compose, but waits for promises in chains and returns a Promise.  */
 const composeAsync = (() => {
     const pipe = async (fns, input, i) => ~i ? await pipe(fns, [await fns[i](...input)], --i) : head(input);
@@ -763,9 +783,9 @@ const throttle = (time, fn) => {
         return res;
     };
 };
-const wait = (time) => new Promise((ff) => setTimeout(ff, time));
+const wait = (time) => new QPromise((ff) => setTimeout(ff, time));
 
 // TODO: possibly introduce a second argument limiting unfolding.
 const uncurry = (fn) => (...args) => qreduce(((fn, arg) => fn ? fn(arg) : fn), fn, args);
 
-export { F, T, __, add, all, allPass, always, any, anyPass, append, assoc, assocPath, bind, both, callFrom, callWith, clone, cloneShallow, complement, compose, composeAsync, concat, cond, curry, curry2, curry3, debounce, diff, divide, echo, empty, eq, equals, explore, filter, find, findIndex, flat, flatShallow, flatTo, flip, forEach, forEachAsync, forEachSerial, freeze, freezeShallow, fromPairs, genBy, getTmpl, gt, gte, head, identity, ifElse, includes, indexOf, intersection, isEmpty, isNil, join, keys, last, length, lt, lte, map, mapKeys, mapObj, memoize, mergeDeep, mergeDeepAdd, mergeDeepX, mergeShallow, mirror, multiply, noop, not, notf, nth, omit, once, overProp, path, pathEq, pathExists, pathOr, pathsEq, pick, pickBy, prepend, prop, propEq, propsEq, push, qappend, qassoc, qassocPath, qempty, qfilter, qfilterAsync, qfreeze, qfreezeShallow, qmap, qmapKeys, qmapObj, qmergeDeep, qmergeDeepAdd, qmergeDeepX, qmergeShallow, qomit, qoverProp, qpick, qprepend, qpush, qreduce, qreverse, qslice, qsort, quniq, qwaitAll, range, reduce, reflect, replace, reverse, sizeof, slice, some, sort, split, startsWith, startsWithShallow, subtract, symbol, tail, take, tap, test, throttle, toLower, toPairs, toUpper, trim, type, typeIs, uncurry, uniq, uniqBy, uniqWith, values, wait, waitAll, waitTap, weakEq, when, zip, zipObj, zipWith };
+export { F, QPromise, T, __, add, all, allPass, always, any, anyPass, append, assoc, assocPath, bind, both, callFrom, callWith, clone, cloneShallow, complement, compose, composeAsync, concat, cond, curry, curry2, curry3, debounce, diff, divide, echo, empty, eq, equals, explore, filter, find, findIndex, flat, flatShallow, flatTo, flip, forEach, forEachParallel, forEachSerial, freeze, freezeShallow, fromPairs, genBy, getTmpl, gt, gte, head, identity, ifElse, includes, indexOf, intersection, isEmpty, isNil, join, keys, last, length, lt, lte, map, mapKeys, mapObj, memoize, mergeDeep, mergeDeepAdd, mergeDeepX, mergeShallow, mirror, multiply, noop, not, notf, nth, omit, once, overProp, path, pathEq, pathExists, pathOr, pathsEq, pick, pickBy, prepend, prop, propEq, propsEq, push, qappend, qassoc, qassocPath, qempty, qfilter, qfilterAsync, qfreeze, qfreezeShallow, qmap, qmapKeys, qmapObj, qmergeDeep, qmergeDeepAdd, qmergeDeepX, qmergeShallow, qomit, qoverProp, qpick, qprepend, qpush, qreduce, qreverse, qslice, qsort, quniq, qwaitAll, range, reduce, reflect, replace, reverse, sizeof, slice, some, sort, split, startsWith, startsWithShallow, subtract, symbol, tail, take, tap, test, throttle, toLower, toPairs, toUpper, trim, type, typeIs, uncurry, uniq, uniqBy, uniqWith, values, wait, waitAll, waitTap, weakEq, when, zip, zipObj, zipWith };

package/package.json

@@ -41,7 +41,7 @@
     "prod": "npm run gentypes && npm run prod:es && npm run prod:cjs",
     "all": "npm run dev && npm run prod"
   },
-  "version": "1.8.2",
+  "version": "1.9.0",
   "devDependencies": {
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-node-resolve": "^16.0.3",

package/src/async.ts

@@ -28,7 +28,7 @@ export const qwaitAll = async <T>(xs: Promise<T>[]) => new Promise<T[]>((ff, rj)
  */
 export const waitTap = curry2(async (fn: AnyFunc<Promise<any>>, s: any) => { await fn(s); return s })
 /** Waits for all promises mapped by the fn. */
-export const forEachAsync = curry2(
+export const forEachParallel = curry2(
   (fn: (item: any) => Promise<any>, items: any[]) => Promise.all(items.map(fn))
 )
 /** The same as compose, but waits for promises in chains and returns a Promise.  */

package/src/index.ts

@@ -8,3 +8,5 @@ export * from './strings'
 export * from './timers'
 export * from './types'
 export * from './uncurry'
+export { QPromise } from './utils'
+

package/src/safe.ts

@@ -152,6 +152,7 @@ export const callFrom = curry((args: any[], fn: string, o: AnyObject) => o[fn](.
 type T_complement<F extends AnyFunc> = {
   (...args: Parameters<F>): ReturnType<F> extends AnyFunc ? T_complement<ReturnType<F>> : boolean
 }
+// FIXME: complement(flip(includes)) -> one arg fn!
 export const complement = <F extends AnyFunc>(fn: F): T_complement<F> => (...args: any[]): any => {
   const out = fn(...args)
   const f = isFunc(out)

package/src/timers.ts

@@ -1,4 +1,5 @@
 import { AnyFunc } from "./types"
+import { QPromise } from "./utils"
 
 export const debounce = <T extends AnyFunc>(time: number, fn: T) => {
   let queue: AnyFunc[] = []
@@ -25,4 +26,4 @@ export const throttle = <T extends AnyFunc>(time: number, fn: T) => {
     return res
   }
 }
-export const wait = (time: number) => new Promise((ff) => setTimeout(ff, time))
+export const wait = (time: number) => new QPromise((ff) => setTimeout(ff, time))

package/src/utils.ts

@@ -1,3 +1,4 @@
+import { noop } from "./safe"
 import { AnyFunc, AnyObject } from "./types"
 
 export const undef = undefined
@@ -13,4 +14,22 @@ export function isFunc(value: any): false
 export function isFunc(s: any) { return to(s)==='function' }
 export const isStr = <T extends any>(s: T) => (to(s)==='string') as T extends string ? true : false
 export const isObj = <T extends any>(s: T) => (!isNull(s) && to(s)==='object') as T extends AnyObject ? true : false
-export const isNil = <T extends any>(s: T) => (isNull(s) || isUndef(s)) as T extends (null|undefined) ? true : false
+export const isNil = <T extends any>(s: T) => (isNull(s) || isUndef(s)) as T extends (null|undefined) ? true : false
+
+export class QPromise<T> extends Promise<T> {
+  private ff: AnyFunc
+  private rj: AnyFunc
+  public cancel(resolve = false) {
+    if(resolve) this.ff()
+    else {
+      this.catch(noop)
+      this.rj('canceled')
+    }
+  }
+  constructor(fn: AnyFunc<any, [AnyFunc, AnyFunc]>) {
+    super((ff, rj) => {
+      this.ff=ff; this.rj = rj
+      return fn(ff, rj)
+    })
+  }
+}