atomic-fns 1.1.7 → 1.2.0

package/dist/random/index.js

@@ -11,7 +11,8 @@ import { isObject } from '../globals/index.js';
  * @returns {number}
  */
 export function random(min = 0, max = 1) {
-    return Math.random() * (max - min) + min;
+    const value = Math.random() * (max - min) + min;
+    return value === max ? min : value;
 }
 /**
  * Returns a random integer between a [min, max] value (inclusive).
@@ -20,7 +21,9 @@ export function random(min = 0, max = 1) {
  * @returns {number}
  */
 export function randomInt(min = 0, max = 1) {
-    return Math.round(random(min, max));
+    const low = Math.ceil(Math.min(min, max));
+    const high = Math.floor(Math.max(min, max));
+    return low + Math.floor(random(0, high - low + 1));
 }
 /**
  * Returns the item at some random index in a sequence.
@@ -42,7 +45,7 @@ export function choice(arr) {
 export function sample(arr, size) {
     if (!arr?.length || arr.length < size)
         return [];
-    return shuffle(arr.slice()).slice(-size);
+    return shuffle(arr.slice()).slice(0, size);
 }
 /**
  * Shuffles a collection elements in-place. Uses the Fisher-Yates algorithm for uniform shuffling. If collection is an Object it returns shuffled `Object.values()`.
@@ -53,11 +56,11 @@ export function sample(arr, size) {
  * @template T
  */
 export function shuffle(arr, size) {
-    if (!arr?.length)
-        return arr;
     if (isObject(arr))
         arr = Object.values(arr);
-    if (size == null)
+    if (!arr?.length)
+        return arr;
+    if (size == null || size >= arr.length)
         size = arr.length - 1;
     for (let i = 0; i <= size; i++) {
         const j = randomInt(i, size);

package/dist/string/index.d.ts

@@ -33,7 +33,7 @@ export declare function capitalize(s: string): string;
 /**
  * Split a string into an array of its words.
  * @param {string} s The string to split
- * @param {RegExp | string} [pattern] The pattern to match words
+ * @param {RegExp | string} [pattern] The separator to split on, instead of matching words
  * @returns {string[]} Returns the words array.
  * @example
 ```js

package/dist/string/index.js

@@ -3,8 +3,7 @@
  *
  * @module string
  */
-const WORDS_REGEX = // eslint-disable-next-line no-control-regex
- /[A-Z\xc0-\xd6\xd8-\xde]?[a-z\xdf-\xf6\xf8-\xff]+(?:['’](?:d|ll|m|re|s|t|ve))?(?=[\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000]|[A-Z\xc0-\xd6\xd8-\xde]|$)|(?:[A-Z\xc0-\xd6\xd8-\xde]|[^\ud800-\udfff\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000\d+\u2700-\u27bfa-z\xdf-\xf6\xf8-\xffA-Z\xc0-\xd6\xd8-\xde])+(?:['’](?:D|LL|M|RE|S|T|VE))?(?=[\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000]|[A-Z\xc0-\xd6\xd8-\xde](?:[a-z\xdf-\xf6\xf8-\xff]|[^\ud800-\udfff\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000\d+\u2700-\u27bfa-z\xdf-\xf6\xf8-\xffA-Z\xc0-\xd6\xd8-\xde])|$)|[A-Z\xc0-\xd6\xd8-\xde]?(?:[a-z\xdf-\xf6\xf8-\xff]|[^\ud800-\udfff\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000\d+\u2700-\u27bfa-z\xdf-\xf6\xf8-\xffA-Z\xc0-\xd6\xd8-\xde])+(?:['’](?:d|ll|m|re|s|t|ve))?|[A-Z\xc0-\xd6\xd8-\xde]+(?:['’](?:D|LL|M|RE|S|T|VE))?|\d*(?:1ST|2ND|3RD|(?![123])\dTH)(?=\b|[a-z_])|\d*(?:1st|2nd|3rd|(?![123])\dth)(?=\b|[A-Z_])|\d+|(?:[\u2700-\u27bf]|(?:\ud83c[\udde6-\uddff]){2}|[\ud800-\udbff][\udc00-\udfff])[\ufe0e\ufe0f]?(?:[\u0300-\u036f\ufe20-\ufe2f\u20d0-\u20ff]|\ud83c[\udffb-\udfff])?(?:\u200d(?:[^\ud800-\udfff]|(?:\ud83c[\udde6-\uddff]){2}|[\ud800-\udbff][\udc00-\udfff])[\ufe0e\ufe0f]?(?:[\u0300-\u036f\ufe20-\ufe2f\u20d0-\u20ff]|\ud83c[\udffb-\udfff])?)*/g;
+const WORDS_REGEX = /[A-Z\xc0-\xd6\xd8-\xde]?[a-z\xdf-\xf6\xf8-\xff]+(?:['’](?:d|ll|m|re|s|t|ve))?(?=[\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000]|[A-Z\xc0-\xd6\xd8-\xde]|$)|(?:[A-Z\xc0-\xd6\xd8-\xde]|[^\ud800-\udfff\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000\d+\u2700-\u27bfa-z\xdf-\xf6\xf8-\xffA-Z\xc0-\xd6\xd8-\xde])+(?:['’](?:D|LL|M|RE|S|T|VE))?(?=[\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000]|[A-Z\xc0-\xd6\xd8-\xde](?:[a-z\xdf-\xf6\xf8-\xff]|[^\ud800-\udfff\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000\d+\u2700-\u27bfa-z\xdf-\xf6\xf8-\xffA-Z\xc0-\xd6\xd8-\xde])|$)|[A-Z\xc0-\xd6\xd8-\xde]?(?:[a-z\xdf-\xf6\xf8-\xff]|[^\ud800-\udfff\xac\xb1\xd7\xf7\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbf\u2000-\u206f \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000\d+\u2700-\u27bfa-z\xdf-\xf6\xf8-\xffA-Z\xc0-\xd6\xd8-\xde])+(?:['’](?:d|ll|m|re|s|t|ve))?|[A-Z\xc0-\xd6\xd8-\xde]+(?:['’](?:D|LL|M|RE|S|T|VE))?|\d*(?:1ST|2ND|3RD|(?![123])\dTH)(?=\b|[a-z_])|\d*(?:1st|2nd|3rd|(?![123])\dth)(?=\b|[A-Z_])|\d+|(?:[\u2700-\u27bf]|(?:\ud83c[\udde6-\uddff]){2}|[\ud800-\udbff][\udc00-\udfff])[\ufe0e\ufe0f]?(?:[\u0300-\u036f\ufe20-\ufe2f\u20d0-\u20ff]|\ud83c[\udffb-\udfff])?(?:\u200d(?:[^\ud800-\udfff]|(?:\ud83c[\udde6-\uddff]){2}|[\ud800-\udbff][\udc00-\udfff])[\ufe0e\ufe0f]?(?:[\u0300-\u036f\ufe20-\ufe2f\u20d0-\u20ff]|\ud83c[\udffb-\udfff])?)*/g;
 /**
  * Converts only the first character of the given string to upper case. Note that the rest of the characters are preserved.
  * @param {string} s The string
@@ -39,7 +38,7 @@ export function capitalize(s) {
 /**
  * Split a string into an array of its words.
  * @param {string} s The string to split
- * @param {RegExp | string} [pattern] The pattern to match words
+ * @param {RegExp | string} [pattern] The separator to split on, instead of matching words
  * @returns {string[]} Returns the words array.
  * @example
 ```js
@@ -125,7 +124,6 @@ asciify('äÄçÇéÉêPHP-MySQLöÖÐþúÚ')
 ```
  */
 export function asciify(s) {
-    // eslint-disable-next-line no-control-regex
     return s.replace(/[^\x00-\x7F]/g, '');
 }
 /**

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * A generic function type with arbitrary arguments and return.
  */
-export declare type Function<TReturn = any> = (...args: any) => TReturn;
+export type Function<TReturn = any> = (...args: any) => TReturn;
 /**
  * An iteratee function used for collection methods.
  * @see {@link collections.filter}
@@ -15,5 +15,5 @@ export declare type Function<TReturn = any> = (...args: any) => TReturn;
  * @see {@link collections.sortedUniq}
  * @see {@link collections.groupBy}
  */
-export declare type Iteratee<T = any, K = any, TResult = any> = (value: T, key?: K, arr?: any) => TResult;
-export declare type Predicate<T = any, TReturn = any> = (value: T) => TReturn;
+export type Iteratee<T = any, K = any, TResult = any> = (value: T, key?: K, arr?: any) => TResult;
+export type Predicate<T = any, TReturn = any> = (value: T) => TReturn;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atomic-fns",
   "description": "Like Lodash, but for ESNext and with types. Stop shipping code built for browsers from 2015.",
-  "version": "1.1.7",
+  "version": "1.2.0",
   "files": [
     "dist/*"
   ],
@@ -12,30 +12,25 @@
   "sideEffects": false,
   "scripts": {
     "preversion": "npm test",
-    "version": "npm run build && npm run docs && git add -A dist",
+    "version": "npm run build",
     "postversion": "git push && git push --tags",
     "prepublishOnly": "npm run build",
-    "test": "NODE_OPTIONS=--loader=ts-node/esm jasmine --config=jasmine.json",
-    "tsc": "tsc -p . --declaration",
+    "test": "vitest run",
+    "tsc": "tsc -p . --declaration && node scripts/declaration-imports.ts",
     "tsc:w": "tsc -p . --declaration --watch",
-    "lint": "eslint src/**/*.ts --fix",
-    "build": "npm run lint && npm test && npm run tsc && npm run docs",
-    "docs": "typedoc"
+    "lint": "biome check --diagnostic-level=error .",
+    "build": "npm run lint && npm test && npm run tsc",
+    "docs": "deno doc --html --name atomic-fns --output docs src/index.ts src/*/index.ts",
+    "check": "npm run lint && npm run tsc && npm test && npm run jsr",
+    "format": "biome format --write .",
+    "jsr": "deno publish --dry-run --allow-dirty --set-version $npm_package_version"
   },
   "devDependencies": {
-    "@types/jasmine": "^4.3.0",
-    "@typescript-eslint/eslint-plugin": "^5.39.0",
-    "eslint": "^8.25.0",
-    "eslint-config-prettier": "^8.5.0",
-    "eslint-config-standard-with-typescript": "^23.0.0",
-    "eslint-plugin-n": "^15.3.0",
-    "eslint-plugin-prettier": "^4.2.1",
-    "jasmine": "^4.4.0",
-    "jasmine-spec-reporter": "^7.0.0",
-    "prettier": "^2.7.1",
-    "ts-node": "^10.9.1",
-    "typedoc": "^0.23.16",
-    "typescript": "^4.8.4"
+    "@biomejs/biome": "^2.6.5",
+    "@types/node": "^26.6.6",
+    "deno": "^2.9.6",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
   },
   "repository": {
     "type": "git",
@@ -70,5 +65,5 @@
   "bugs": {
     "url": "https://github.com/adrian2x/atomic-fns/issues"
   },
-  "homepage": "https://atomic-stack.github.io/atomic-fns/"
+  "homepage": "https://jsr.io/@atomic-stack/atomic-fns"
 }