@mongez/reinforcements 2.2.7 → 2.3.0

package/README.md

@@ -629,7 +629,8 @@ Now let's move to arrays utilities.
 - [Median](#median): Get the median of all values in an array or by given key.
 - [Unique](#unique): Get unique values from an array.
 - [Push Unique](#push-unique): Push a value or more to an array if it doesn't exist.
-- [Unshift Unique](#unshift-unique): Add a value or more to the beginning of an array if it doesn't exist.
+- [Unshift Unique](#unshift-unique): Add a value or more to the beginning of an array if it
+  doesn't exist.
 
 ### Pluck
 
@@ -674,7 +675,7 @@ Group by a single key:
 ```ts
 import { groupBy } from "@mongez/reinforcements";
 
- const studentsClasses = [
+const studentsClasses = [
   {
     id: 1,
     class: "A",
@@ -902,7 +903,7 @@ const studentsClasses = [
   },
 ];
 
-console.log(groupBy(studentsClasses, ["class", "grade"], 'students'));
+console.log(groupBy(studentsClasses, ["class", "grade"], "students"));
 ```
 
 Output:
@@ -1013,7 +1014,7 @@ const array = [
   { id: 5, value: 5 },
 ];
 
-console.log(count(array, (item) => item.value > 2)); // 3
+console.log(count(array, item => item.value > 2)); // 3
 ```
 
 ### Count By
@@ -1026,14 +1027,14 @@ Count total occurrence of values for the given key.
 import { countBy } from "@mongez/reinforcements";
 
 const array = [
-  { id: 1, animal: 'dog' },
-  { id: 2, animal: 'cat' },
-  { id: 3, animal: 'dog' },
-  { id: 4, animal: 'cat' },
-  { id: 5, animal: 'dog' },
+  { id: 1, animal: "dog" },
+  { id: 2, animal: "cat" },
+  { id: 3, animal: "dog" },
+  { id: 4, animal: "cat" },
+  { id: 5, animal: "dog" },
 ];
 
-console.log(countBy(array, 'animal')); // { dog: 3, cat: 2 }
+console.log(countBy(array, "animal")); // { dog: 3, cat: 2 }
 ```
 
 ### Even
@@ -1337,6 +1338,26 @@ const array = [1, 2, 3, 4, 5];
 console.log(unshiftUnique(array, 6, 7, 5, 6, 1, 2, 4, 3)); // [7, 6, 1, 2, 3, 4, 5]
 ```
 
+### Range
+
+> Added in v2.3.0
+
+Generates an array of numbers starting from the given min value to the given max value.
+
+`range(min: number, max: number): number[]`
+
+```ts
+import { range } from "@mongez/reinforcements";
+
+console.log(range(1, 6)); // [1, 2, 3, 4, 5, 6]
+
+console.log(range(3, 5)); // [3, 4, 5]
+```
+
+If the given `min` or `max` parameter is not a number, an error **will be thrown**.
+
+> Min value must be higher than max value.
+
 ## Working With Strings
 
 The following list defines all available string utilities
@@ -1410,7 +1431,7 @@ import { toSnakeCase } from "@mongez/reinforcements";
 
 const words = "hello world";
 
-console.log(toSnakeCase(words, '-')); // hello-world
+console.log(toSnakeCase(words, "-")); // hello-world
 ```
 
 Also setting the third argument to false will not convert letters to lower case, will keep each letter as its own.
@@ -1420,7 +1441,7 @@ import { toSnakeCase } from "@mongez/reinforcements";
 
 const words = "Hello World";
 
-console.log(toSnakeCase(words, '-', false)); // Hello_World
+console.log(toSnakeCase(words, "-", false)); // Hello_World
 ```
 
 ### Kebab Case
@@ -1758,7 +1779,7 @@ import { initials } from "@mongez/reinforcements";
 
 const name = "John Doe";
 
-console.log(initials(name, '.')); // J.D
+console.log(initials(name, ".")); // J.D
 ```
 
 If the given parameter is not a string it will throw an error.
@@ -1918,7 +1939,8 @@ Escape regex special characters in the given string.
 ```ts
 import { escapeRegex } from "@mongez/reinforcements";
 
-const string = "This is a string with special characters like: . * + ? ^ $ { } ( ) | [ ] / \\";
+const string =
+  "This is a string with special characters like: . * + ? ^ $ { } ( ) | [ ] / \\";
 
 console.log(escapeRegex(string)); // This is a string with special characters like: \\. \\* \\+ \\? \\^ \\$ \\{ \\} \\( \\) \\| \\[ \\] / \\\\
 ```
@@ -2038,6 +2060,10 @@ To run tests run `npm run test` or `yarn test`
 
 ## Change Log
 
+- 2.3.0 (25 Mar 2023)
+  - Added [Range](#range) function.
+  - Exposed typings.
+  - Enhanced tests for `areEqual` function,
 - 2.2.7 (22 Feb 2023)
   - Added [Name Initials](#name-initials) function.
 - 2.2.0 (08 Nov 2022)

package/cjs/array/range.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate array of numbers starting from the" given min value to the given max value
+ */
+export default function range(min: number, max: number): number[];
+//# sourceMappingURL=range.d.ts.map

package/cjs/array/range.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * Generate array of numbers starting from the" given min value to the given max value
+ */
+function range(min, max) {
+  if (typeof min !== "number") {
+    throw new Error(`min parameter should be number, "${typeof min}" given.`);
+  }
+  if (typeof max !== "number") {
+    throw new Error(`max parameter should be number, "${typeof max}" given.`);
+  }
+  if (min >= max) {
+    throw new Error("max parameter should be higher than min parameter");
+  }
+  const array = [];
+  for (let i = min; i <= max; i++) {
+    array.push(i);
+  }
+  return array;
+}
+
+module.exports = range;

package/cjs/index.d.ts

@@ -12,6 +12,7 @@ export { default as odd } from "./array/odd";
 export { default as oddIndexes } from "./array/oddIndexes";
 export { default as pluck } from "./array/pluck";
 export { default as pushUnique } from "./array/pushUnique";
+export { default as range } from "./array/range";
 export { default as sum } from "./array/sum";
 export { default as unique } from "./array/unique";
 export { default as unshiftUnique } from "./array/unshiftUnique";
@@ -50,6 +51,7 @@ export { default as toSnakeCase } from "./string/toSnakeCase";
 export { default as toStudlyCase } from "./string/toStudlyCase";
 export { default as trim } from "./string/trim";
 export { default as ucfirst } from "./string/ucfirst";
+export * from "./types";
 export { default as debounce } from "./utils/debounce";
 export { default as escapeRegex } from "./utils/escapeRegex";
 //# sourceMappingURL=index.d.ts.map

package/cjs/index.js

@@ -16,6 +16,7 @@ var odd = require("./array/odd.js");
 var oddIndexes = require("./array/oddIndexes.js");
 var pluck = require("./array/pluck.js");
 var pushUnique = require("./array/pushUnique.js");
+var range = require("./array/range.js");
 var sum = require("./array/sum.js");
 var unique = require("./array/unique.js");
 var unshiftUnique = require("./array/unshiftUnique.js");
@@ -72,6 +73,7 @@ exports.odd = odd;
 exports.oddIndexes = oddIndexes;
 exports.pluck = pluck;
 exports.pushUnique = pushUnique;
+exports.range = range;
 exports.sum = sum;
 exports.unique = unique;
 exports.unshiftUnique = unshiftUnique;

package/cjs/string/toInputName.d.ts

@@ -1,9 +1,6 @@
 /**
  * Convert the current a dot notation string to compound input name
  * my.input.name >> my[input][name]
- *
- * @param   {string} string
- * @returns {string}
  */
 export default function toInputName(string: string): string;
 //# sourceMappingURL=toInputName.d.ts.map

package/cjs/string/toInputName.js

@@ -5,13 +5,9 @@ var rtrim = require("./rtrim.js");
 /**
  * Convert the current a dot notation string to compound input name
  * my.input.name >> my[input][name]
- *
- * @param   {string} string
- * @returns {string}
  */
 function toInputName(string) {
   if (!string) return "";
-  if (!string.includes(".")) return string;
   const namesList = string.split(".");
   let mainName = namesList.shift() || "";
   for (let name of namesList) {

package/esm/array/range.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate array of numbers starting from the" given min value to the given max value
+ */
+export default function range(min: number, max: number): number[];
+//# sourceMappingURL=range.d.ts.map

package/esm/array/range.js

@@ -0,0 +1,21 @@
+/**
+ * Generate array of numbers starting from the" given min value to the given max value
+ */
+function range(min, max) {
+  if (typeof min !== "number") {
+    throw new Error(`min parameter should be number, "${typeof min}" given.`);
+  }
+  if (typeof max !== "number") {
+    throw new Error(`max parameter should be number, "${typeof max}" given.`);
+  }
+  if (min >= max) {
+    throw new Error("max parameter should be higher than min parameter");
+  }
+  const array = [];
+  for (let i = min; i <= max; i++) {
+    array.push(i);
+  }
+  return array;
+}
+
+export { range as default };

package/esm/index.d.ts

@@ -12,6 +12,7 @@ export { default as odd } from "./array/odd";
 export { default as oddIndexes } from "./array/oddIndexes";
 export { default as pluck } from "./array/pluck";
 export { default as pushUnique } from "./array/pushUnique";
+export { default as range } from "./array/range";
 export { default as sum } from "./array/sum";
 export { default as unique } from "./array/unique";
 export { default as unshiftUnique } from "./array/unshiftUnique";
@@ -50,6 +51,7 @@ export { default as toSnakeCase } from "./string/toSnakeCase";
 export { default as toStudlyCase } from "./string/toStudlyCase";
 export { default as trim } from "./string/trim";
 export { default as ucfirst } from "./string/ucfirst";
+export * from "./types";
 export { default as debounce } from "./utils/debounce";
 export { default as escapeRegex } from "./utils/escapeRegex";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.js

@@ -12,6 +12,7 @@ export { default as odd } from "./array/odd.js";
 export { default as oddIndexes } from "./array/oddIndexes.js";
 export { default as pluck } from "./array/pluck.js";
 export { default as pushUnique } from "./array/pushUnique.js";
+export { default as range } from "./array/range.js";
 export { default as sum } from "./array/sum.js";
 export { default as unique } from "./array/unique.js";
 export { default as unshiftUnique } from "./array/unshiftUnique.js";

package/esm/string/toInputName.d.ts

@@ -1,9 +1,6 @@
 /**
  * Convert the current a dot notation string to compound input name
  * my.input.name >> my[input][name]
- *
- * @param   {string} string
- * @returns {string}
  */
 export default function toInputName(string: string): string;
 //# sourceMappingURL=toInputName.d.ts.map

package/esm/string/toInputName.js

@@ -3,13 +3,9 @@ import rtrim from "./rtrim.js";
 /**
  * Convert the current a dot notation string to compound input name
  * my.input.name >> my[input][name]
- *
- * @param   {string} string
- * @returns {string}
  */
 function toInputName(string) {
   if (!string) return "";
-  if (!string.includes(".")) return string;
   const namesList = string.split(".");
   let mainName = namesList.shift() || "";
   for (let name of namesList) {

package/package.json

@@ -1,10 +1,10 @@
 {
     "name": "@mongez/reinforcements",
-    "version": "2.2.7",
+    "version": "2.3.0",
     "description": "A lightweight package to give a massive reinforcements to variant types of data in Nodejs/Javascript",
     "main": "./cjs/index.js",
     "dependencies": {
-        "@mongez/supportive-is": "^1.0.6"
+        "@mongez/supportive-is": "^1.0.11"
     },
     "scripts": {
         "test": "jest ./src",