@cooljs123/easyjs 0.1.0 → 0.2.0

package/README.md

@@ -23,6 +23,23 @@ easyJS.safeGet({ a: { b: 2 } }, "a.b", 0); // 2
 easyJS.safeSet({}, "a.b", 3); // { a: { b: 3 } }
 ```
 
+## Modular Imports
+
+```js
+import { sum, uniq } from "@cooljs123/easyjs";
+import shuffle from "@cooljs123/easyjs/array/shuffle";
+```
+
+## Chain API
+
+```js
+easyJS.chain([1,2,2,3])
+  .uniq()
+  .shuffle()
+  .take(2)
+  .value()
+```
+
 ## Examples (All 100 Functions)
 
 - `identity`:

package/index.d.ts

@@ -0,0 +1,227 @@
+export interface Chain {
+  uniq(...args: any[]): Chain;
+  shuffle(...args: any[]): Chain;
+  take(...args: any[]): Chain;
+  takeRight(...args: any[]): Chain;
+  drop(...args: any[]): Chain;
+  dropRight(...args: any[]): Chain;
+  chunk(...args: any[]): Chain;
+  flatten(...args: any[]): Chain;
+  compact(...args: any[]): Chain;
+  union(...args: any[]): Chain;
+  intersection(...args: any[]): Chain;
+  difference(...args: any[]): Chain;
+  groupBy(...args: any[]): Chain;
+  sortBy(...args: any[]): Chain;
+  pluck(...args: any[]): Chain;
+  first(...args: any[]): Chain;
+  last(...args: any[]): Chain;
+  value(): any;
+}
+
+export function anyOf(...args: any[]): boolean;
+export function arrayGroupBy(...args: any[]): any;
+export function asArray(...args: any[]): any;
+export function avg(...args: any[]): number;
+export function between(...args: any[]): boolean;
+export function capitalize(...args: any[]): any;
+export function chain(value: any): Chain;
+export function chunk(...args: any[]): any;
+export function clamp(...args: any[]): number;
+export function clamp01(...args: any[]): number;
+export function compact(...args: any[]): any;
+export function containsAny(...args: any[]): boolean;
+export function countWords(...args: any[]): any;
+export function debounce(...args: any[]): any;
+export function deepClone(...args: any[]): any;
+export function deepMerge(...args: any[]): any;
+export function defaultTo(...args: any[]): any;
+export function difference(...args: any[]): any;
+export function drop(...args: any[]): any;
+export function dropRight(...args: any[]): any;
+export function endsWithAny(...args: any[]): boolean;
+export function entries(...args: any[]): any;
+export function eqAny(...args: any[]): boolean;
+export function first(...args: any[]): any;
+export function flatten(...args: any[]): any;
+export function fromEntries(...args: any[]): any;
+export function groupBy(...args: any[]): any;
+export function has(...args: any[]): boolean;
+export function identity(...args: any[]): any;
+export function inArray(...args: any[]): boolean;
+export function install(): void;
+export function intersection(...args: any[]): any;
+export function invert(...args: any[]): any;
+export function isBlank(...args: any[]): boolean;
+export function isEmpty(...args: any[]): boolean;
+export function isInt(...args: any[]): boolean;
+export function isNil(...args: any[]): boolean;
+export function isNumber(...args: any[]): boolean;
+export function isObject(...args: any[]): any;
+export function keys(...args: any[]): any;
+export function last(...args: any[]): any;
+export function lerp(...args: any[]): number;
+export function mapKeys(...args: any[]): any;
+export function max(...args: any[]): number;
+export function median(...args: any[]): number;
+export function merge(...args: any[]): any;
+export function min(...args: any[]): number;
+export function mode(...args: any[]): number;
+export function move(...args: any[]): any;
+export function noop(...args: any[]): any;
+export function normalizeString(...args: any[]): any;
+export function objectCompact(...args: any[]): any;
+export function omit(...args: any[]): any;
+export function once(...args: any[]): any;
+export function padLeft(...args: any[]): any;
+export function padRight(...args: any[]): any;
+export function percent(...args: any[]): number;
+export function percentile(...args: any[]): number;
+export function pick(...args: any[]): any;
+export function pluck(...args: any[]): any;
+export function randomFloat(...args: any[]): number;
+export function randomInt(...args: any[]): number;
+export function range(...args: any[]): any;
+export function repeat(...args: any[]): any;
+export function replaceAll(...args: any[]): any;
+export function roundDecimal(...args: any[]): number;
+export function roundDown(...args: any[]): number;
+export function roundTo(...args: any[]): number;
+export function roundUp(...args: any[]): number;
+export function safeGet(...args: any[]): any;
+export function safeJsonParse(...args: any[]): any;
+export function safeJsonStringify(...args: any[]): any;
+export function safeSet(...args: any[]): any;
+export function sample(...args: any[]): any;
+export function shuffle(...args: any[]): any;
+export function size(...args: any[]): any;
+export function sleep(ms: number): Promise<void>;
+export function slugify(...args: any[]): any;
+export function sortBy(...args: any[]): any;
+export function startsWithAny(...args: any[]): boolean;
+export function stripNonAlpha(...args: any[]): any;
+export function sum(...args: any[]): number;
+export function take(...args: any[]): any;
+export function takeRight(...args: any[]): any;
+export function tap(...args: any[]): any;
+export function throttle(...args: any[]): any;
+export function toFloat(...args: any[]): number;
+export function toInt(...args: any[]): number;
+export function toLower(...args: any[]): any;
+export function toNumber(...args: any[]): number;
+export function toTitleCase(...args: any[]): any;
+export function toUpper(...args: any[]): any;
+export function trim(...args: any[]): any;
+export function truncate(...args: any[]): any;
+export function tryCatch(...args: any[]): any;
+export function union(...args: any[]): any;
+export function uniq(...args: any[]): any;
+export function uniqueBy(...args: any[]): any;
+export function unzip(...args: any[]): any;
+export function values(...args: any[]): any;
+export function zip(...args: any[]): any;
+
+declare const easyJS: {
+  anyOf: typeof anyOf;
+  arrayGroupBy: typeof arrayGroupBy;
+  asArray: typeof asArray;
+  avg: typeof avg;
+  between: typeof between;
+  capitalize: typeof capitalize;
+  chain: typeof chain;
+  chunk: typeof chunk;
+  clamp: typeof clamp;
+  clamp01: typeof clamp01;
+  compact: typeof compact;
+  containsAny: typeof containsAny;
+  countWords: typeof countWords;
+  debounce: typeof debounce;
+  deepClone: typeof deepClone;
+  deepMerge: typeof deepMerge;
+  defaultTo: typeof defaultTo;
+  difference: typeof difference;
+  drop: typeof drop;
+  dropRight: typeof dropRight;
+  endsWithAny: typeof endsWithAny;
+  entries: typeof entries;
+  eqAny: typeof eqAny;
+  first: typeof first;
+  flatten: typeof flatten;
+  fromEntries: typeof fromEntries;
+  groupBy: typeof groupBy;
+  has: typeof has;
+  identity: typeof identity;
+  inArray: typeof inArray;
+  install: typeof install;
+  intersection: typeof intersection;
+  invert: typeof invert;
+  isBlank: typeof isBlank;
+  isEmpty: typeof isEmpty;
+  isInt: typeof isInt;
+  isNil: typeof isNil;
+  isNumber: typeof isNumber;
+  isObject: typeof isObject;
+  keys: typeof keys;
+  last: typeof last;
+  lerp: typeof lerp;
+  mapKeys: typeof mapKeys;
+  max: typeof max;
+  median: typeof median;
+  merge: typeof merge;
+  min: typeof min;
+  mode: typeof mode;
+  move: typeof move;
+  noop: typeof noop;
+  normalizeString: typeof normalizeString;
+  objectCompact: typeof objectCompact;
+  omit: typeof omit;
+  once: typeof once;
+  padLeft: typeof padLeft;
+  padRight: typeof padRight;
+  percent: typeof percent;
+  percentile: typeof percentile;
+  pick: typeof pick;
+  pluck: typeof pluck;
+  randomFloat: typeof randomFloat;
+  randomInt: typeof randomInt;
+  range: typeof range;
+  repeat: typeof repeat;
+  replaceAll: typeof replaceAll;
+  roundDecimal: typeof roundDecimal;
+  roundDown: typeof roundDown;
+  roundTo: typeof roundTo;
+  roundUp: typeof roundUp;
+  safeGet: typeof safeGet;
+  safeJsonParse: typeof safeJsonParse;
+  safeJsonStringify: typeof safeJsonStringify;
+  safeSet: typeof safeSet;
+  sample: typeof sample;
+  shuffle: typeof shuffle;
+  size: typeof size;
+  sleep: typeof sleep;
+  slugify: typeof slugify;
+  sortBy: typeof sortBy;
+  startsWithAny: typeof startsWithAny;
+  stripNonAlpha: typeof stripNonAlpha;
+  sum: typeof sum;
+  take: typeof take;
+  takeRight: typeof takeRight;
+  tap: typeof tap;
+  throttle: typeof throttle;
+  toFloat: typeof toFloat;
+  toInt: typeof toInt;
+  toLower: typeof toLower;
+  toNumber: typeof toNumber;
+  toTitleCase: typeof toTitleCase;
+  toUpper: typeof toUpper;
+  trim: typeof trim;
+  truncate: typeof truncate;
+  tryCatch: typeof tryCatch;
+  union: typeof union;
+  uniq: typeof uniq;
+  uniqueBy: typeof uniqueBy;
+  unzip: typeof unzip;
+  values: typeof values;
+  zip: typeof zip;
+};
+export default easyJS;

package/package.json

@@ -1,20 +1,65 @@
 {
   "name": "@cooljs123/easyjs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One import with 100+ small, everyday JavaScript helpers.",
   "keywords": [
     "javascript",
     "easy",
-    "js"
+    "js",
+    "utility",
+    "helpers",
+    "lodash-alternative",
+    "array",
+    "string",
+    "object",
+    "math",
+    "functional",
+    "toolkit"
   ],
   "license": "ISC",
   "author": "Thomas Boerdam",
   "type": "commonjs",
   "main": "src/index.js",
+  "module": "src/index.mjs",
+  "types": "index.d.ts",
   "files": [
-    "src"
+    "src",
+    "index.d.ts"
   ],
+  "exports": {
+    ".": {
+      "require": "./src/index.js",
+      "import": "./src/index.mjs"
+    },
+    "./*": {
+      "require": "./src/*.js",
+      "import": "./src/*.mjs"
+    },
+    "./array/*": {
+      "require": "./src/array/*.js",
+      "import": "./src/array/*.mjs"
+    },
+    "./string/*": {
+      "require": "./src/string/*.js",
+      "import": "./src/string/*.mjs"
+    },
+    "./math/*": {
+      "require": "./src/math/*.js",
+      "import": "./src/math/*.mjs"
+    },
+    "./object/*": {
+      "require": "./src/object/*.js",
+      "import": "./src/object/*.mjs"
+    },
+    "./util/*": {
+      "require": "./src/util/*.js",
+      "import": "./src/util/*.mjs"
+    }
+  },
   "scripts": {
-    "test": "node --test ./tests/*.test.js --test-reporter spec"
+    "test": "jest"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0"
   }
 }

package/src/anyOf.js

@@ -0,0 +1 @@
+module.exports = require("./core").anyOf;

package/src/anyOf.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.anyOf;

package/src/array/arrayGroupBy.js

@@ -0,0 +1 @@
+module.exports = require("../core").arrayGroupBy;

package/src/array/arrayGroupBy.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.arrayGroupBy;

package/src/array/asArray.js

@@ -0,0 +1 @@
+module.exports = require("../core").asArray;

package/src/array/asArray.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.asArray;

package/src/array/chunk.js

@@ -0,0 +1 @@
+module.exports = require("../core").chunk;

package/src/array/chunk.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.chunk;

package/src/array/compact.js

@@ -0,0 +1 @@
+module.exports = require("../core").compact;

package/src/array/compact.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.compact;

package/src/array/difference.js

@@ -0,0 +1 @@
+module.exports = require("../core").difference;

package/src/array/difference.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.difference;

package/src/array/drop.js

@@ -0,0 +1 @@
+module.exports = require("../core").drop;

package/src/array/drop.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.drop;

package/src/array/dropRight.js

@@ -0,0 +1 @@
+module.exports = require("../core").dropRight;

package/src/array/dropRight.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.dropRight;

package/src/array/first.js

@@ -0,0 +1 @@
+module.exports = require("../core").first;

package/src/array/first.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.first;

package/src/array/flatten.js

@@ -0,0 +1 @@
+module.exports = require("../core").flatten;

package/src/array/flatten.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.flatten;

package/src/array/groupBy.js

@@ -0,0 +1 @@
+module.exports = require("../core").groupBy;

package/src/array/groupBy.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.groupBy;

package/src/array/inArray.js

@@ -0,0 +1 @@
+module.exports = require("../core").inArray;

package/src/array/inArray.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.inArray;

package/src/array/intersection.js

@@ -0,0 +1 @@
+module.exports = require("../core").intersection;

package/src/array/intersection.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.intersection;

package/src/array/last.js

@@ -0,0 +1 @@
+module.exports = require("../core").last;

package/src/array/last.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.last;

package/src/array/move.js

@@ -0,0 +1 @@
+module.exports = require("../core").move;

package/src/array/move.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.move;

package/src/array/pluck.js

@@ -0,0 +1 @@
+module.exports = require("../core").pluck;

package/src/array/pluck.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.pluck;

package/src/array/range.js

@@ -0,0 +1 @@
+module.exports = require("../core").range;

package/src/array/range.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.range;

package/src/array/sample.js

@@ -0,0 +1 @@
+module.exports = require("../core").sample;

package/src/array/sample.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.sample;

package/src/array/shuffle.js

@@ -0,0 +1 @@
+module.exports = require("../core").shuffle;

package/src/array/shuffle.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.shuffle;

package/src/array/sortBy.js

@@ -0,0 +1 @@
+module.exports = require("../core").sortBy;

package/src/array/sortBy.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.sortBy;

package/src/array/take.js

@@ -0,0 +1 @@
+module.exports = require("../core").take;

package/src/array/take.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.take;

package/src/array/takeRight.js

@@ -0,0 +1 @@
+module.exports = require("../core").takeRight;

package/src/array/takeRight.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.takeRight;

package/src/array/union.js

@@ -0,0 +1 @@
+module.exports = require("../core").union;

package/src/array/union.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.union;

package/src/array/uniq.js

@@ -0,0 +1 @@
+module.exports = require("../core").uniq;

package/src/array/uniq.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.uniq;

package/src/array/uniqueBy.js

@@ -0,0 +1 @@
+module.exports = require("../core").uniqueBy;

package/src/array/uniqueBy.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.uniqueBy;

package/src/array/unzip.js

@@ -0,0 +1 @@
+module.exports = require("../core").unzip;

package/src/array/unzip.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.unzip;

package/src/array/zip.js

@@ -0,0 +1 @@
+module.exports = require("../core").zip;

package/src/array/zip.mjs

@@ -0,0 +1,2 @@
+import core from "../core.js";
+export default core.zip;

package/src/arrayGroupBy.js

@@ -0,0 +1 @@
+module.exports = require("./core").arrayGroupBy;

package/src/arrayGroupBy.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.arrayGroupBy;

package/src/asArray.js

@@ -0,0 +1 @@
+module.exports = require("./core").asArray;

package/src/asArray.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.asArray;

package/src/avg.js

@@ -0,0 +1 @@
+module.exports = require("./core").avg;

package/src/avg.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.avg;

package/src/between.js

@@ -0,0 +1 @@
+module.exports = require("./core").between;

package/src/between.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.between;

package/src/capitalize.js

@@ -0,0 +1 @@
+module.exports = require("./core").capitalize;

package/src/capitalize.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.capitalize;

package/src/chain.js

@@ -0,0 +1 @@
+module.exports = require("./core").chain;

package/src/chain.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.chain;

package/src/chunk.js

@@ -0,0 +1 @@
+module.exports = require("./core").chunk;

package/src/chunk.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.chunk;

package/src/clamp.js

@@ -0,0 +1 @@
+module.exports = require("./core").clamp;

package/src/clamp.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.clamp;

package/src/clamp01.js

@@ -0,0 +1 @@
+module.exports = require("./core").clamp01;

package/src/clamp01.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.clamp01;

package/src/compact.js

@@ -0,0 +1 @@
+module.exports = require("./core").compact;

package/src/compact.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.compact;

package/src/containsAny.js

@@ -0,0 +1 @@
+module.exports = require("./core").containsAny;

package/src/containsAny.mjs

@@ -0,0 +1,2 @@
+import core from "./core.js";
+export default core.containsAny;