@vinicunca/perkakas 0.2.1 → 0.3.1

package/README.md

@@ -0,0 +1,9 @@
+# @vinicunca/perkakas
+
+[![npm](https://img.shields.io/npm/v/@vinicunca/perkakas/latest.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@vinicunca/perkakas)
+[![downloads](https://img.shields.io/npm/dm/@vinicunca/perkakas.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://npmjs.com/package/@vinicunca/perkakas)
+[![license](https://img.shields.io/github/license/vinicunca/perkakas.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://github.com/vinicunca/perkakas/blob/main/LICENSE)
+
+Utilities functions for javascript/typescript projects.
+
+[📖  Documentation](https://perkakas.vinicunca.dev/)

package/dist/commonjs/aria/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./key-codes"), exports);

package/dist/commonjs/aria/key-codes.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_CODES = void 0;
+exports.KEY_CODES = {
+    ALT: 'Alt',
+    ARROW_DOWN: 'ArrowDown',
+    ARROW_LEFT: 'ArrowLeft',
+    ARROW_RIGHT: 'ArrowRight',
+    ARROW_UP: 'ArrowUp',
+    AT: '@',
+    BACKSPACE: 'Backspace',
+    CTRL: 'Control',
+    DELETE: 'Delete',
+    END: 'End',
+    ENTER: 'Enter',
+    ESC: 'Escape',
+    HOME: 'Home',
+    KEY_F: 'KEY_F',
+    META: 'Meta',
+    PAGE_DOWN: 'PageDown',
+    PAGE_UP: 'PageUp',
+    SHIFT: 'Shift',
+    SPACE: 'Space',
+    TAB: 'Tab',
+};

package/dist/commonjs/array/all-pass.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allPass = void 0;
+const purry_1 = require("../function/purry");
+function allPass(...args) {
+    return (0, purry_1.purry)(_allPass, args);
+}
+exports.allPass = allPass;
+function _allPass(data, fns) {
+    return fns.every((fn) => fn(data));
+}

package/dist/commonjs/array/any-pass.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anyPass = void 0;
+const purry_1 = require("../function/purry");
+function anyPass(...args) {
+    return (0, purry_1.purry)(_anyPass, args);
+}
+exports.anyPass = anyPass;
+function _anyPass(data, fns) {
+    return fns.some((fn) => fn(data));
+}

package/dist/commonjs/array/chunk.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunk = void 0;
+const purry_1 = require("../function/purry");
+function chunk(...args) {
+    return (0, purry_1.purry)(_chunk, args);
+}
+exports.chunk = chunk;
+function _chunk(array, size) {
+    const ret = Array.from({
+        length: Math.ceil(array.length / size),
+    });
+    for (let index = 0; index < ret.length; index += 1) {
+        ret[index] = array.slice(index * size, (index + 1) * size);
+    }
+    return ret;
+}

package/dist/commonjs/array/compact.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compact = void 0;
+const is_truthy_1 = require("../guard/is-truthy");
+function compact(items) {
+    return items.filter(is_truthy_1.isTruthy);
+}
+exports.compact = compact;

package/dist/commonjs/array/concat.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.concat = void 0;
+const purry_1 = require("../function/purry");
+function concat(...args) {
+    return (0, purry_1.purry)(_concat, args);
+}
+exports.concat = concat;
+function _concat(arr1, arr2) {
+    return arr1.concat(arr2);
+}

package/dist/commonjs/array/count-by.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countBy = void 0;
+const purry_1 = require("../function/purry");
+function _countBy(indexed) {
+    return (array, fn) => {
+        return array.reduce((ret, item, index) => {
+            const value = indexed ? fn(item, index, array) : fn(item);
+            return ret + (value ? 1 : 0);
+        }, 0);
+    };
+}
+function countBy(...args) {
+    return (0, purry_1.purry)(_countBy(false), args);
+}
+exports.countBy = countBy;
+(function (countBy) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(_countBy(true), args);
+    }
+    countBy.indexed = indexed;
+})(countBy || (exports.countBy = countBy = {}));

package/dist/commonjs/array/difference-with.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.differenceWith = void 0;
+const purry_1 = require("../function/purry");
+const reduce_lazy_1 = require("../utils/reduce-lazy");
+function differenceWith(...args) {
+    return (0, purry_1.purry)(_differenceWith, args, differenceWith.lazy);
+}
+exports.differenceWith = differenceWith;
+function _differenceWith(array, other, isEquals) {
+    const lazy = differenceWith.lazy(other, isEquals);
+    return (0, reduce_lazy_1.reduceLazy)(array, lazy);
+}
+(function (differenceWith) {
+    function lazy(other, isEquals) {
+        return (value) => {
+            if (other.every((otherValue) => !isEquals(value, otherValue))) {
+                return {
+                    done: false,
+                    hasNext: true,
+                    next: value,
+                };
+            }
+            return {
+                done: false,
+                hasNext: false,
+            };
+        };
+    }
+    differenceWith.lazy = lazy;
+})(differenceWith || (exports.differenceWith = differenceWith = {}));

package/dist/commonjs/array/difference.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.difference = void 0;
+const purry_1 = require("../function/purry");
+const reduce_lazy_1 = require("../utils/reduce-lazy");
+function difference(...args) {
+    return (0, purry_1.purry)(_difference, args, difference.lazy);
+}
+exports.difference = difference;
+function _difference(array, other) {
+    const lazy = difference.lazy(other);
+    return (0, reduce_lazy_1.reduceLazy)(array, lazy);
+}
+(function (difference) {
+    function lazy(other) {
+        const set = new Set(other);
+        return (value) => {
+            if (!set.has(value)) {
+                return {
+                    done: false,
+                    hasNext: true,
+                    next: value,
+                };
+            }
+            return {
+                done: false,
+                hasNext: false,
+            };
+        };
+    }
+    difference.lazy = lazy;
+})(difference || (exports.difference = difference = {}));

package/dist/commonjs/array/drop-first-by.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropFirstBy = void 0;
+const heap_1 = require("../utils/heap");
+const purry_order_rules_1 = require("../utils/purry-order-rules");
+function dropFirstBy(...args) {
+    return (0, purry_order_rules_1.purryOrderRulesWithArgument)(dropFirstByImplementation, args);
+}
+exports.dropFirstBy = dropFirstBy;
+function dropFirstByImplementation(data, compareFn, n) {
+    if (n >= data.length) {
+        return [];
+    }
+    if (n <= 0) {
+        return [...data];
+    }
+    const heap = data.slice(0, n);
+    (0, heap_1.heapify)(heap, compareFn);
+    const out = [];
+    const rest = data.slice(n);
+    for (const item of rest) {
+        const previousHead = (0, heap_1.heapMaybeInsert)(heap, compareFn, item);
+        out.push(previousHead ?? item);
+    }
+    return out;
+}

package/dist/commonjs/array/drop-last-while.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropLastWhile = void 0;
+const purry_1 = require("../function/purry");
+function dropLastWhile(...args) {
+    return (0, purry_1.purry)(_dropLastWhile, args);
+}
+exports.dropLastWhile = dropLastWhile;
+function _dropLastWhile(data, predicate) {
+    for (let i = data.length - 1; i >= 0; i--) {
+        if (!predicate(data[i])) {
+            return data.slice(0, i + 1);
+        }
+    }
+    return [];
+}

package/dist/commonjs/array/drop-last.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropLast = void 0;
+const purry_1 = require("../function/purry");
+function dropLast(...args) {
+    return (0, purry_1.purry)(_dropLast, args);
+}
+exports.dropLast = dropLast;
+function _dropLast(array, n) {
+    const copy = [...array];
+    if (n > 0) {
+        copy.splice(-n);
+    }
+    return copy;
+}

package/dist/commonjs/array/drop-while.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropWhile = void 0;
+const purry_1 = require("../function/purry");
+function dropWhile(...args) {
+    return (0, purry_1.purry)(_dropWhile, args);
+}
+exports.dropWhile = dropWhile;
+function _dropWhile(data, predicate) {
+    for (let i = 0; i < data.length; i++) {
+        if (!predicate(data[i])) {
+            return data.slice(i);
+        }
+    }
+    return [];
+}

package/dist/commonjs/array/drop.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.drop = void 0;
+const purry_1 = require("../function/purry");
+const reduce_lazy_1 = require("../utils/reduce-lazy");
+function drop(...args) {
+    return (0, purry_1.purry)(_drop, args, drop.lazy);
+}
+exports.drop = drop;
+function _drop(array, n) {
+    return (0, reduce_lazy_1.reduceLazy)(array, drop.lazy(n));
+}
+(function (drop) {
+    function lazy(n) {
+        let left = n;
+        return (value) => {
+            if (left > 0) {
+                left--;
+                return {
+                    done: false,
+                    hasNext: false,
+                };
+            }
+            return {
+                done: false,
+                hasNext: true,
+                next: value,
+            };
+        };
+    }
+    drop.lazy = lazy;
+})(drop || (exports.drop = drop = {}));

package/dist/commonjs/array/filter.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filter = void 0;
+const purry_1 = require("../function/purry");
+const reduce_lazy_1 = require("../utils/reduce-lazy");
+const to_lazy_indexed_1 = require("../utils/to-lazy-indexed");
+function filter(...args) {
+    return (0, purry_1.purry)(filter_(false), args, filter.lazy);
+}
+exports.filter = filter;
+function filter_(indexed) {
+    return (array, fn) => {
+        return (0, reduce_lazy_1.reduceLazy)(array, indexed ? filter.lazyIndexed(fn) : filter.lazy(fn), indexed);
+    };
+}
+function lazy_(indexed) {
+    return (fn) => {
+        return (value, index, array) => {
+            const valid = indexed ? fn(value, index, array) : fn(value);
+            if (valid) {
+                return {
+                    done: false,
+                    hasNext: true,
+                    next: value,
+                };
+            }
+            return {
+                done: false,
+                hasNext: false,
+            };
+        };
+    };
+}
+(function (filter) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(filter_(true), args, filter.lazyIndexed);
+    }
+    filter.indexed = indexed;
+    filter.lazy = lazy_(false);
+    filter.lazyIndexed = (0, to_lazy_indexed_1.toLazyIndexed)(lazy_(true));
+})(filter || (exports.filter = filter = {}));

package/dist/commonjs/array/find-index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findIndex = void 0;
+const purry_1 = require("../function/purry");
+const to_lazy_indexed_1 = require("../utils/to-lazy-indexed");
+const to_single_1 = require("../utils/to-single");
+function findIndex(...args) {
+    return (0, purry_1.purry)(_findIndex(false), args, findIndex.lazy);
+}
+exports.findIndex = findIndex;
+function _findIndex(indexed) {
+    return (array, fn) => {
+        if (indexed) {
+            return array.findIndex(fn);
+        }
+        return array.findIndex((x) => fn(x));
+    };
+}
+function _lazy(indexed) {
+    return (fn) => {
+        let i = 0;
+        return (value, index, array) => {
+            const valid = indexed ? fn(value, index, array) : fn(value);
+            if (valid) {
+                return {
+                    done: true,
+                    hasNext: true,
+                    next: i,
+                };
+            }
+            i++;
+            return {
+                done: false,
+                hasNext: false,
+            };
+        };
+    };
+}
+(function (findIndex) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(_findIndex(true), args, findIndex.lazyIndexed);
+    }
+    findIndex.indexed = indexed;
+    findIndex.lazy = (0, to_single_1.toSingle)(_lazy(false));
+    findIndex.lazyIndexed = (0, to_single_1.toSingle)((0, to_lazy_indexed_1.toLazyIndexed)(_lazy(true)));
+})(findIndex || (exports.findIndex = findIndex = {}));

package/dist/commonjs/array/find-last-index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findLastIndex = void 0;
+const purry_1 = require("../function/purry");
+function findLastIndex(...args) {
+    return (0, purry_1.purry)(_findLastIndex(false), args);
+}
+exports.findLastIndex = findLastIndex;
+function _findLastIndex(indexed) {
+    return (array, fn) => {
+        for (let i = array.length - 1; i >= 0; i--) {
+            if (indexed ? fn(array[i], i, array) : fn(array[i])) {
+                return i;
+            }
+        }
+        return -1;
+    };
+}
+(function (findLastIndex) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(_findLastIndex(true), args);
+    }
+    findLastIndex.indexed = indexed;
+})(findLastIndex || (exports.findLastIndex = findLastIndex = {}));

package/dist/commonjs/array/find-last.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findLast = void 0;
+const purry_1 = require("../function/purry");
+function findLast(...args) {
+    return (0, purry_1.purry)(_findLast(false), args);
+}
+exports.findLast = findLast;
+function _findLast(indexed) {
+    return (array, fn) => {
+        for (let i = array.length - 1; i >= 0; i--) {
+            if (indexed ? fn(array[i], i, array) : fn(array[i])) {
+                return array[i];
+            }
+        }
+        return undefined;
+    };
+}
+(function (findLast) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(_findLast(true), args);
+    }
+    findLast.indexed = indexed;
+})(findLast || (exports.findLast = findLast = {}));

package/dist/commonjs/array/find.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.find = void 0;
+const purry_1 = require("../function/purry");
+const to_lazy_indexed_1 = require("../utils/to-lazy-indexed");
+const to_single_1 = require("../utils/to-single");
+function find(...args) {
+    return (0, purry_1.purry)(_find(false), args, find.lazy);
+}
+exports.find = find;
+function _find(indexed) {
+    return (array, fn) => {
+        if (indexed) {
+            return array.find(fn);
+        }
+        return array.find((x) => fn(x));
+    };
+}
+function _lazy(indexed) {
+    return (fn) => {
+        return (value, index, array) => {
+            const valid = indexed ? fn(value, index, array) : fn(value);
+            return {
+                done: valid,
+                hasNext: valid,
+                next: value,
+            };
+        };
+    };
+}
+(function (find) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(_find(true), args, find.lazyIndexed);
+    }
+    find.indexed = indexed;
+    find.lazy = (0, to_single_1.toSingle)(_lazy(false));
+    find.lazyIndexed = (0, to_single_1.toSingle)((0, to_lazy_indexed_1.toLazyIndexed)(_lazy(true)));
+})(find || (exports.find = find = {}));

package/dist/commonjs/array/first-by.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firstBy = void 0;
+const purry_order_rules_1 = require("../utils/purry-order-rules");
+const has_at_least_1 = require("./has-at-least");
+function firstBy(...args) {
+    return (0, purry_order_rules_1.purryOrderRules)(firstByImplementation, args);
+}
+exports.firstBy = firstBy;
+function firstByImplementation(data, compareFn) {
+    if (!(0, has_at_least_1.hasAtLeast)(data, 2)) {
+        return data[0];
+    }
+    let [currentFirst] = data;
+    const [, ...rest] = data;
+    for (const item of rest) {
+        if (compareFn(item, currentFirst) < 0) {
+            currentFirst = item;
+        }
+    }
+    return currentFirst;
+}

package/dist/commonjs/array/first.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.first = void 0;
+const purry_1 = require("../function/purry");
+function first(...args) {
+    return (0, purry_1.purry)(_first, args, first.lazy);
+}
+exports.first = first;
+function _first([first]) {
+    return first;
+}
+(function (first) {
+    function lazy() {
+        return (value) => {
+            return {
+                done: true,
+                hasNext: true,
+                next: value,
+            };
+        };
+    }
+    first.lazy = lazy;
+    (function (lazy) {
+        lazy.single = true;
+    })(lazy = first.lazy || (first.lazy = {}));
+})(first || (exports.first = first = {}));

package/dist/commonjs/array/flat-map-to-obj.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatMapToObj = void 0;
+const purry_1 = require("../function/purry");
+function flatMapToObj(...args) {
+    return (0, purry_1.purry)(_flatMapToObj(false), args);
+}
+exports.flatMapToObj = flatMapToObj;
+function _flatMapToObj(indexed) {
+    return (array, fn) => {
+        return array.reduce((result, element, index) => {
+            const items = indexed ? fn(element, index, array) : fn(element);
+            items.forEach(([key, value]) => {
+                result[key] = value;
+            });
+            return result;
+        }, {});
+    };
+}
+(function (flatMapToObj) {
+    function indexed(...args) {
+        return (0, purry_1.purry)(_flatMapToObj(true), args);
+    }
+    flatMapToObj.indexed = indexed;
+})(flatMapToObj || (exports.flatMapToObj = flatMapToObj = {}));

package/dist/commonjs/array/flat-map.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatMap = void 0;
+const purry_1 = require("../function/purry");
+const flatten_1 = require("./flatten");
+function flatMap(...args) {
+    return (0, purry_1.purry)(_flatMap, args, flatMap.lazy);
+}
+exports.flatMap = flatMap;
+function _flatMap(array, fn) {
+    return (0, flatten_1.flatten)(array.map((item) => fn(item)));
+}
+(function (flatMap) {
+    function lazy(fn) {
+        return (value) => {
+            const next = fn(value);
+            if (Array.isArray(next)) {
+                return {
+                    done: false,
+                    hasMany: true,
+                    hasNext: true,
+                    next,
+                };
+            }
+            return {
+                done: false,
+                hasNext: true,
+                next,
+            };
+        };
+    }
+    flatMap.lazy = lazy;
+})(flatMap || (exports.flatMap = flatMap = {}));

package/dist/commonjs/array/flatten-deep.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenDeep = void 0;
+const purry_1 = require("../function/purry");
+const reduce_lazy_1 = require("../utils/reduce-lazy");
+function flattenDeep(...args) {
+    return (0, purry_1.purry)(_flattenDeep, args, flattenDeep.lazy);
+}
+exports.flattenDeep = flattenDeep;
+function _flattenDeep(items) {
+    return (0, reduce_lazy_1.reduceLazy)(items, flattenDeep.lazy());
+}
+function _flattenDeepValue(value) {
+    if (!Array.isArray(value)) {
+        return value;
+    }
+    const ret = [];
+    value.forEach((item) => {
+        if (Array.isArray(item)) {
+            ret.push(...flattenDeep(item));
+        }
+        else {
+            ret.push(item);
+        }
+    });
+    return ret;
+}
+(function (flattenDeep) {
+    function lazy() {
+        return (value) => {
+            const next = _flattenDeepValue(value);
+            if (Array.isArray(next)) {
+                return {
+                    done: false,
+                    hasMany: true,
+                    hasNext: true,
+                    next,
+                };
+            }
+            return {
+                done: false,
+                hasNext: true,
+                next,
+            };
+        };
+    }
+    flattenDeep.lazy = lazy;
+})(flattenDeep || (exports.flattenDeep = flattenDeep = {}));