@cooljs123/easyjs 0.1.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Thomas Boerdam
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,602 @@
+# EasyJS
+
+One import with a bunch of small, everyday JavaScript helpers. Written in vanilla JS with no external libraries.
+
+## Install
+
+```bash
+npm i @cooljs123/easyjs
+```
+
+## Use
+
+```js
+const easyJS = require("@cooljs123/easyjs");
+
+// Run once to add prototype helpers (Array/String/Object methods like .shuffle(), .toTitleCase(), .mapKeys()).
+// Use this only if you want prototype sugar; it changes global prototypes.
+easyJS.install();
+
+easyJS.anyOf("tom", ["thomas", "tommy", "tom"]); // true
+easyJS.normalizeString("  ToM  "); // "tom"
+easyJS.safeGet({ a: { b: 2 } }, "a.b", 0); // 2
+easyJS.safeSet({}, "a.b", 3); // { a: { b: 3 } }
+```
+
+## Examples (All 100 Functions)
+
+- `identity`:
+```js
+easyJS.identity(5) // 5
+```
+- `noop`:
+```js
+easyJS.noop() // undefined
+```
+- `isNil`:
+```js
+easyJS.isNil(null) // true
+```
+- `isEmpty`:
+```js
+easyJS.isEmpty([]) // true
+```
+- `defaultTo`:
+```js
+easyJS.defaultTo(null, 10) // 10
+```
+- `toLower`:
+```js
+easyJS.toLower("Hi") // "hi"
+```
+- `toUpper`:
+```js
+easyJS.toUpper("Hi") // "HI"
+```
+- `capitalize`:
+```js
+easyJS.capitalize("hello") // "Hello"
+```
+- `trim`:
+```js
+easyJS.trim("  hi ") // "hi"
+```
+- `normalizeString`:
+```js
+easyJS.normalizeString("  ToM  ") // "tom"
+```
+- `slugify`:
+```js
+easyJS.slugify("Hello World!") // "hello-world"
+```
+- `padLeft`:
+```js
+easyJS.padLeft("7", 3, "0") // "007"
+```
+- `padRight`:
+```js
+easyJS.padRight("7", 3, "0") // "700"
+```
+- `repeat`:
+```js
+easyJS.repeat("ha", 3) // "hahaha"
+```
+- `stripNonAlpha`:
+```js
+easyJS.stripNonAlpha("a-b_c") // "abc"
+```
+- `isBlank`:
+```js
+easyJS.isBlank("   ") // true
+```
+- `asArray`:
+```js
+easyJS.asArray(5) // [5]
+```
+- `anyOf`:
+```js
+easyJS.anyOf("tom", ["thomas", "tom"]) // true
+```
+- `eqAny`:
+```js
+easyJS.eqAny("x", "a", "x") // true
+```
+- `inArray`:
+```js
+easyJS.inArray(2, [1, 2, 3]) // true
+```
+- `clamp`:
+```js
+easyJS.clamp(12, 0, 10) // 10
+```
+- `between`:
+```js
+easyJS.between(5, 1, 10) // true
+```
+- `toInt`:
+```js
+easyJS.toInt("42") // 42
+```
+- `toFloat`:
+```js
+easyJS.toFloat("3.14") // 3.14
+```
+- `toNumber`:
+```js
+easyJS.toNumber("9") // 9
+```
+- `isNumber`:
+```js
+easyJS.isNumber(3.5) // true
+```
+- `isInt`:
+```js
+easyJS.isInt(3) // true
+```
+- `compact`:
+```js
+easyJS.compact([0, null, 2]) // [0, 2]
+```
+- `uniq`:
+```js
+easyJS.uniq([1, 2, 2]) // [1, 2]
+```
+- `flatten`:
+```js
+easyJS.flatten([1, [2, 3]]) // [1, 2, 3]
+```
+- `chunk`:
+```js
+easyJS.chunk([1, 2, 3], 2) // [[1, 2], [3]]
+```
+- `range`:
+```js
+easyJS.range(3) // [0, 1, 2]
+```
+- `min`:
+```js
+easyJS.min([2, 5, 1]) // 1
+```
+- `max`:
+```js
+easyJS.max([2, 5, 1]) // 5
+```
+- `sum`:
+```js
+easyJS.sum([1, 2, 3]) // 6
+```
+- `avg`:
+```js
+easyJS.avg([2, 4]) // 3
+```
+- `median`:
+```js
+easyJS.median([1, 3, 2]) // 2
+```
+- `mode`:
+```js
+easyJS.mode([1, 2, 2, 3]) // 2
+```
+- `percentile`:
+```js
+easyJS.percentile([1, 2, 3, 4, 5], 50) // 3
+```
+- `groupBy`:
+```js
+easyJS.groupBy([1, 2, 3, 4], x => x % 2) // { 0: [2, 4], 1: [1, 3] }
+```
+- `first`:
+```js
+easyJS.first([9, 8, 7]) // 9
+```
+- `last`:
+```js
+easyJS.last([9, 8, 7]) // 7
+```
+- `take`:
+```js
+easyJS.take([1, 2, 3], 2) // [1, 2]
+```
+- `takeRight`:
+```js
+easyJS.takeRight([1, 2, 3], 2) // [2, 3]
+```
+- `drop`:
+```js
+easyJS.drop([1, 2, 3], 1) // [2, 3]
+```
+- `dropRight`:
+```js
+easyJS.dropRight([1, 2, 3], 1) // [1, 2]
+```
+- `zip`:
+```js
+easyJS.zip([[1, 2], ["a", "b"]]) // [[1, "a"], [2, "b"]]
+```
+- `unzip`:
+```js
+easyJS.unzip([[1, "a"], [2, "b"]]) // [[1, 2], ["a", "b"]]
+```
+- `intersection`:
+```js
+easyJS.intersection([1, 2, 3], [2, 3, 4]) // [2, 3]
+```
+- `difference`:
+```js
+easyJS.difference([1, 2, 3], [2]) // [1, 3]
+```
+- `union`:
+```js
+easyJS.union([1, 2], [2, 3]) // [1, 2, 3]
+```
+- `pick`:
+```js
+easyJS.pick({ a: 1, b: 2 }, ["a"]) // { a: 1 }
+```
+- `omit`:
+```js
+easyJS.omit({ a: 1, b: 2 }, ["b"]) // { a: 1 }
+```
+- `has`:
+```js
+easyJS.has({ a: 1 }, "a") // true
+```
+- `keys`:
+```js
+easyJS.keys({ a: 1, b: 2 }) // ["a", "b"]
+```
+- `values`:
+```js
+easyJS.values({ a: 1, b: 2 }) // [1, 2]
+```
+- `entries`:
+```js
+easyJS.entries({ a: 1 }) // [["a", 1]]
+```
+- `fromEntries`:
+```js
+easyJS.fromEntries([["a", 1]]) // { a: 1 }
+```
+- `merge`:
+```js
+easyJS.merge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+```
+- `deepMerge`:
+```js
+easyJS.deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+```
+- `isObject`:
+```js
+easyJS.isObject({}) // true
+```
+- `size`:
+```js
+easyJS.size([1, 2, 3]) // 3
+```
+- `safeGet`:
+```js
+easyJS.safeGet({ a: { b: 2 } }, "a.b", 0) // 2
+```
+- `safeSet`:
+```js
+easyJS.safeSet({}, "a.b", 3) // { a: { b: 3 } }
+```
+- `tryCatch`:
+```js
+easyJS.tryCatch(() => JSON.parse("x"), {}) // {}
+```
+- `tap`:
+```js
+easyJS.tap(5, v => console.log(v)) // 5 (and logs 5)
+```
+- `sleep`:
+```js
+easyJS.sleep(100) // Promise (resolves after ~100ms)
+```
+- `containsAny`:
+```js
+easyJS.containsAny("hello", ["ell"]) // true
+```
+- `startsWithAny`:
+```js
+easyJS.startsWithAny("hello", ["he"]) // true
+```
+- `endsWithAny`:
+```js
+easyJS.endsWithAny("hello", ["lo"]) // true
+```
+- `safeJsonParse`:
+```js
+easyJS.safeJsonParse("{\"a\":1}", {}) // { a: 1 }
+```
+- `once`:
+```js
+easyJS.once(() => 1)() // 1
+```
+- `debounce`:
+```js
+easyJS.debounce(() => {}, 100) // function
+```
+- `throttle`:
+```js
+easyJS.throttle(() => {}, 100) // function
+```
+- `uniqueBy`:
+```js
+easyJS.uniqueBy([{ id: 1 }, { id: 1 }], "id") // [{ id: 1 }]
+```
+- `pluck`:
+```js
+easyJS.pluck([{ a: 1 }, { a: 2 }], "a") // [1, 2]
+```
+- `sortBy`:
+```js
+easyJS.sortBy([{ n: 2 }, { n: 1 }], "n") // [{ n: 1 }, { n: 2 }]
+```
+- `roundTo`:
+```js
+easyJS.roundTo(1.234, 2) // 1.23
+```
+- `roundDecimal`:
+```js
+easyJS.roundDecimal(1.234, "hundredths") // 1.23
+```
+- `roundDown`:
+```js
+easyJS.roundDown(1.9) // 1
+```
+- `roundUp`:
+```js
+easyJS.roundUp(1.1) // 2
+```
+- `lerp`:
+```js
+easyJS.lerp(0, 10, 0.5) // 5
+```
+- `percent`:
+```js
+easyJS.percent(1, 4) // 25
+```
+- `clamp01`:
+```js
+easyJS.clamp01(1.5) // 1
+```
+- `randomInt`:
+```js
+easyJS.randomInt(1, 3) // 1..3 (random)
+```
+- `randomFloat`:
+```js
+easyJS.randomFloat(1, 2) // 1..2 (random)
+```
+- `shuffle`:
+```js
+easyJS.shuffle([1, 2, 3]) // random order
+```
+- `sample`:
+```js
+easyJS.sample([1, 2, 3]) // 1..3 (random)
+```
+- `deepClone`:
+```js
+easyJS.deepClone({ a: 1 }) // { a: 1 }
+```
+- `safeJsonStringify`:
+```js
+easyJS.safeJsonStringify({ a: 1 }) // "{\"a\":1}"
+```
+- `move`:
+```js
+easyJS.move([1, 2, 3], 0, 2) // [2, 3, 1]
+```
+- `arrayGroupBy`:
+```js
+easyJS.arrayGroupBy([1, 2, 3, 4], x => x % 2) // { 0: [2, 4], 1: [1, 3] }
+```
+- `mapKeys`:
+```js
+easyJS.mapKeys({ a: 1 }, k => k.toUpperCase()) // { A: 1 }
+```
+- `invert`:
+```js
+easyJS.invert({ a: 1 }) // { "1": "a" }
+```
+- `objectCompact`:
+```js
+easyJS.objectCompact({ a: null, b: 2 }) // { b: 2 }
+```
+- `toTitleCase`:
+```js
+easyJS.toTitleCase("hello world") // "Hello World"
+```
+- `truncate`:
+```js
+easyJS.truncate("hello world", 8) // "hello..."
+```
+- `replaceAll`:
+```js
+easyJS.replaceAll("a-b", "-", "_") // "a_b"
+```
+- `countWords`:
+```js
+easyJS.countWords("hi there") // 2
+```
+- `install`:
+```js
+easyJS.install() // adds prototype helpers
+```
+
+## Prototype Helpers (Only After `easyJS.install()`)
+
+These methods are added to built-in prototypes and only work after running `easyJS.install()`.
+
+### Array
+- `.shuffle()`:
+```js
+easyJS.install()
+[1, 2, 3].shuffle() // random order
+```
+- `.unique()`:
+```js
+easyJS.install()
+[1, 2, 2].unique() // [1, 2]
+```
+- `.chunk(size)`:
+```js
+easyJS.install()
+[1, 2, 3, 4].chunk(2) // [[1, 2], [3, 4]]
+```
+- `.move(from, to)`:
+```js
+easyJS.install()
+[1, 2, 3].move(0, 2) // [2, 3, 1]
+```
+- `.groupBy(fn)`:
+```js
+easyJS.install()
+[1, 2, 3, 4].groupBy(x => x % 2) // { 0: [2, 4], 1: [1, 3] }
+```
+- `.compact(fn?)`:
+```js
+easyJS.install()
+[0, null, 2].compact() // [0, 2]
+```
+- `.flatten()`:
+```js
+easyJS.install()
+[1, [2, 3]].flatten() // [1, 2, 3]
+```
+- `.first()`:
+```js
+easyJS.install()
+[9, 8, 7].first() // 9
+```
+- `.last()`:
+```js
+easyJS.install()
+[9, 8, 7].last() // 7
+```
+- `.take(n)`:
+```js
+easyJS.install()
+[1, 2, 3].take(2) // [1, 2]
+```
+- `.takeRight(n)`:
+```js
+easyJS.install()
+[1, 2, 3].takeRight(2) // [2, 3]
+```
+- `.drop(n)`:
+```js
+easyJS.install()
+[1, 2, 3].drop(1) // [2, 3]
+```
+- `.dropRight(n)`:
+```js
+easyJS.install()
+[1, 2, 3].dropRight(1) // [1, 2]
+```
+
+### Object
+- `.mapKeys(fn)`:
+```js
+easyJS.install()
+({ a: 1, b: 2 }).mapKeys(k => k.toUpperCase()) // { A: 1, B: 2 }
+```
+- `.pick(keys)`:
+```js
+easyJS.install()
+({ a: 1, b: 2 }).pick(["a"]) // { a: 1 }
+```
+- `.invert()`:
+```js
+easyJS.install()
+({ a: 1 }).invert() // { "1": "a" }
+```
+- `.compact()`:
+```js
+easyJS.install()
+({ a: null, b: 2 }).compact() // { b: 2 }
+```
+- `.omit(keys)`:
+```js
+easyJS.install()
+({ a: 1, b: 2 }).omit(["b"]) // { a: 1 }
+```
+- `.has(key)`:
+```js
+easyJS.install()
+({ a: 1 }).has("a") // true
+```
+- `.merge(...objs)`:
+```js
+easyJS.install()
+({ a: 1 }).merge({ b: 2 }) // { a: 1, b: 2 }
+```
+- `.deepMerge(...objs)`:
+```js
+easyJS.install()
+({ a: { b: 1 } }).deepMerge({ a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+```
+- `.size()`:
+```js
+easyJS.install()
+({ a: 1, b: 2 }).size() // 2
+```
+
+### String
+- `.toTitleCase()`:
+```js
+easyJS.install()
+"hello world".toTitleCase() // "Hello World"
+```
+- `.truncate(len)`:
+```js
+easyJS.install()
+"hello world".truncate(8) // "hello..."
+```
+- `.replaceAllEasy(sub, rep)`:
+```js
+easyJS.install()
+"a-b".replaceAllEasy("-", "_") // "a_b"
+```
+- `.countWords()`:
+```js
+easyJS.install()
+"hi there".countWords() // 2
+```
+- `.slugify()`:
+```js
+easyJS.install()
+"Hello World!".slugify() // "hello-world"
+```
+- `.padLeft(len, ch?)`:
+```js
+easyJS.install()
+"7".padLeft(3, "0") // "007"
+```
+- `.padRight(len, ch?)`:
+```js
+easyJS.install()
+"7".padRight(3, "0") // "700"
+```
+- `.repeatEasy(n)`:
+```js
+easyJS.install()
+"ha".repeatEasy(3) // "hahaha"
+```
+- `.stripNonAlpha()`:
+```js
+easyJS.install()
+"a-b_c".stripNonAlpha() // "abc"
+```
+- `.isBlank()`:
+```js
+easyJS.install()
+"   ".isBlank() // true
+```
+- `.normalizeString()`:
+```js
+easyJS.install()
+"  ToM  ".normalizeString() // "tom"
+```

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@cooljs123/easyjs",
+  "version": "0.1.0",
+  "description": "One import with 100+ small, everyday JavaScript helpers.",
+  "keywords": [
+    "javascript",
+    "easy",
+    "js"
+  ],
+  "license": "ISC",
+  "author": "Thomas Boerdam",
+  "type": "commonjs",
+  "main": "src/index.js",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "test": "node --test ./tests/*.test.js --test-reporter spec"
+  }
+}