randex 0.26.0 → 0.31.0

package/README.md

@@ -17,16 +17,20 @@ npm i randex
 Strings:
 
 - [random](#random)
+- [word](#word)
+- [sentence](#sentence)
 - [fileName](#filename)
 - [username](#username)
 - [email](#email)
 - [singleName](#singlename)
 - [fullName](#fullname)
-- [word](#word)
 
 Numbers:
 - [number](#number)
-- [numberArray](#numberarray)
+
+Many
+- [many](#many)
+
 
 Generic Type:
 - [array](#array)
@@ -79,9 +83,9 @@ Randex.random({
 Randex.random(["number", 3]);
 // 643
 
-// 3 chars from custom range
+// 3 chars from custom char range
 Randex.random({
-  range: "abc123",
+  charRange: "abc123",
   length: 3,
 });
 // a21
@@ -115,8 +119,86 @@ Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
 |set|[RandexSet](#randexset) | Defined chars|
-|range|`string`| Range or custom chars |
-|length|[RandexLength](#randexlength) | Length of chars |
+|charRange|`string`| Range or custom chars |
+|length|[RandexRange](#randexrange) | Length of chars |
+
+## word
+
+Randoms a simple word.
+
+```ts
+import Randex from "randex";
+
+// default
+Randex.word();
+// kpmld
+
+// with length 5 chars
+Randex.word({ length: 5 });
+// or short:
+Randex.word(5);
+// imphs
+
+// with 2 min and 5 max chars
+Randex.word({ length: [2, 5] });
+// or short:
+Randex.word([2, 5]);
+// kslg
+
+// name from french alphabet
+Randex.word({ alphabet: "french" });
+// or short:
+Randex.word("french");
+// dbïœ
+
+// name from french alphabet with length
+Randex.word({ alphabet: "french", length: 10 });
+// or short:
+Randex.word("french", 10);
+// rsîrjhjôôw
+```
+
+Options:
+| Name | Type| Description|
+| ------------------------ | ---- |------------ |
+|length|[RandexRange](#randexrange) | Length of chars. Default: [2,10] |
+|alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
+
+## sentence
+
+Randoms a sentence.
+
+```ts
+import Randex from "randex";
+
+// default word range is from 3 to 15
+Randex.sentence();
+// Gpgowb te vdancy poluwsd sswl aqxq.
+
+// with 5 words
+Randex.sentence({ wordRange: 5 });
+// or:
+Randex.sentence(5);
+// Xja wyfbhnhtl ptn shemiukme poyyjtr.
+
+// with words range
+Randex.sentence({ wordRange: [3, 6] });
+// or:
+Randex.sentence([3, 6]);
+// Vg nfobxcwg tmhfu hiqonw.
+
+// with french alphabet
+Randex.sentence({ alphabet: "french" });
+// or:
+Randex.sentence("french");
+// Êid æeâoô déèbfûûæ aôç udôûsèqpa ygyïœùuè oê rmânacgwnc kuàq qêœççzœx iolîœsqàu aùàrpëhuâh rèèfhmæ klltu.
+```
+
+Options:
+| Name | Type| Description|
+| ------------------------ | ---- |------------ |
+|wordRange|[RandexRange](#randexrange) | Range of words. Default: [3,15] |
+|alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
 
 ## fileName
 
@@ -161,8 +243,8 @@ Randex.fileName(8, "xml");
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|fileNameLength|[RandexLength](#randexlength) | Length of file name (not including extension). Default: [3,10] |
-|extensionLength|[RandexLength](#randexlength) | Length of extension (not including file name) chars. Default: [2,5] |
+|fileNameLength|[RandexRange](#randexrange) | Length of file name (not including extension). Default: [3,10] |
+|extensionLength|[RandexRange](#randexrange) | Length of extension (not including file name) chars. Default: [2,5] |
 |extension| `string`| File extension. |
 
 ## username
@@ -192,7 +274,7 @@ Randex.username([2, 5]);
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|length|[RandexLength](#randexlength) | Length of chars. Default: [6,10] |
+|length|[RandexRange](#randexrange) | Length of chars. Default: [6,10] |
 
 ## randomEmail
 
@@ -235,9 +317,9 @@ randomEmail("test.com");
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|prefixLength|[RandexLength](#randexlength) | Length of email prefix (chars before `@`). Default: [6, 10] |
-|hightDomainLength|[RandexLength](#randexlength) | Length of hight domain part (example: test.<b>com</b>). Default: [1,6] |
-|lowDomainLength|[RandexLength](#randexlength) | Length of low domain part (example: <b>test</b>.com). Default: [4,2] |
+|prefixLength|[RandexRange](#randexrange) | Length of email prefix (chars before `@`). Default: [6, 10] |
+|hightDomainLength|[RandexRange](#randexrange) | Length of hight domain part (example: test.<b>com</b>). Default: [1,6] |
+|lowDomainLength|[RandexRange](#randexrange) | Length of low domain part (example: <b>test</b>.com). Default: [4,2] |
 |domain| `string`| Defined domain. |
 
 ## singleName
@@ -279,7 +361,7 @@ Randex.singleName("french", 10);
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|length|[RandexLength](#randexlength) | Length of chars. Default: [2,10] |
+|length|[RandexRange](#randexrange) | Length of chars. Default: [2,10] |
 |alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
 
 ## randomFullName
@@ -297,52 +379,8 @@ Randex.fullName();
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|firstLength|[RandexLength](#randexlength) | First name length of chars. Default: [2, 10] |
-|secondLength|[RandexLength](#randexlength) | Second name length of chars. Default: [2,10] |
-|alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
-
-
-
-## word
-
-Randoms a simple word.
-
-```ts
-import Randex from "randex";
-
-// default
-Randex.word();
-// kpmld
-
-// with length 5 chars
-Randex.word({ length: 5 });
-// or short:
-Randex.word(5);
-// imphs
-
-// with 2 min and 5 max chars
-Randex.word({ length: [2, 5] });
-// or short:
-Randex.word([2, 5]);
-// kslg
-
-// name from french alphabet
-Randex.word({ alphabet: "french" });
-// or short:
-Randex.word("french");
-// dbïœ
-
-// name from french alphabet with length
-Randex.word({ alphabet: "french", length: 10 });
-// or short:
-Randex.word("french", 10);
-// rsîrjhjôôw
-```
-
-Options:
-| Name | Type| Description|
-| ------------------------ | ---- |------------ |
-|length|[RandexLength](#randexlength) | Length of chars. Default: [2,10] |
+|firstLength|[RandexRange](#randexrange) | First name length of chars. Default: [2, 10] |
+|secondLength|[RandexRange](#randexrange) | Second name length of chars. Default: [2,10] |
 |alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
 
 
@@ -365,18 +403,21 @@ Options:
 | ------------------------ | ---- |------------ |
 |decimals| `number` | Number of decimal digits |
 
-## numberArray
+## many
 
-Generates random array with values from a range.
+Generates many defined random methods.
 
 ```ts
 import Randex from "randex";
 
-// Generates an array (with length equals 2) with unique numbers from a range: [0, 3].
-Randex.numberArray(3, 2);
+// Generates three words with english alphabet.
+Randex.many(3).word("english");
+
+// Generates five sentences with french alphabet.
+Randex.many(5).sentence("french");
 
-// Generates an array (with length equals 3) with unique numbers from a range: [3, 7].
-Randex.numberArray([3, 7], 3);
+// Generates an array with length from 2 to 4 of random numbers from 3 to 7.
+Randex.many([2, 4]).number([3, 7]);
 ```
 
 ## array
@@ -479,13 +520,13 @@ Randex.random(
 
 ## Types
 
-## RandexLength
+## RandexRange
 
 Possible types:
 
-`number`: strict length
+`number`: strict number
 
-`[number, number]`: an array of min and max length.
+`[number, number]`: an array of min and max numbers.
 
 Example:
 

package/lib/basic/const.d.ts

@@ -0,0 +1,3 @@
+import { RandexRange } from "../interfaces";
+export declare const DEFAULT_WORD_RANGE: RandexRange;
+export declare const DEFAULT_SENTENCE_RANGE: RandexRange;

package/lib/basic/const.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SENTENCE_RANGE = exports.DEFAULT_WORD_RANGE = void 0;
+exports.DEFAULT_WORD_RANGE = [2, 10];
+exports.DEFAULT_SENTENCE_RANGE = [3, 15];

package/lib/basic/set.d.ts

@@ -1,16 +1,17 @@
-import { RandexSet, RandexLength } from "../interfaces";
+import { RandexSet, RandexRange } from "../interfaces";
 export declare class RandexSetUtil {
-    static readonly defaultFileNameLength: RandexLength;
-    static readonly defaultExtensionLength: RandexLength;
+    static readonly defaultFileNameLength: RandexRange;
+    static readonly defaultExtensionLength: RandexRange;
     static readonly fileNameExtraChars = "";
-    static readonly defaultEmailPrefixLength: RandexLength;
-    static readonly defaultHightDomainEmailLength: RandexLength;
-    static readonly defaultLowDomainEmailLength: RandexLength;
+    static readonly defaultEmailPrefixLength: RandexRange;
+    static readonly defaultHightDomainEmailLength: RandexRange;
+    static readonly defaultLowDomainEmailLength: RandexRange;
     private static toSingleRange;
     private static toAlphabetCase;
     private static toAlphabetRange;
     static toRange(set: RandexSet): string;
-    static getLength(reservedChars: number, length: RandexLength | undefined, defaultLength: RandexLength): RandexLength;
-    static randomNumber(length: number): number;
-    static many<TItem>(count: number, callback: () => TItem): TItem[];
+    static getLength(reservedChars: number, length: RandexRange | undefined, defaultLength: RandexRange): RandexRange;
+    static randomSingleNumber(length: number): number;
+    static randomRangeNumber(min: number, max: number): number;
+    static many<TItem>(count: RandexRange, callback: () => TItem): TItem[];
 }

package/lib/basic/set.js

@@ -94,12 +94,18 @@ var RandexSetUtil = /** @class */ (function () {
         }
         return result;
     };
-    RandexSetUtil.randomNumber = function (length) {
+    RandexSetUtil.randomSingleNumber = function (length) {
         return Math.floor(Math.random() * length);
     };
+    RandexSetUtil.randomRangeNumber = function (min, max) {
+        var minN = Math.min(min, max);
+        var maxN = Math.max(min, max);
+        return RandexSetUtil.randomSingleNumber(maxN - minN + 1) + minN;
+    };
     RandexSetUtil.many = function (count, callback) {
         var result = [];
-        for (var i = 0; i < count; i++) {
+        var length = Array.isArray(count) ? RandexSetUtil.randomRangeNumber(count[0], count[1]) : count;
+        for (var i = 0; i < length; i++) {
             result.push(callback());
         }
         return result;

package/lib/basic/type.d.ts

@@ -1,11 +1,11 @@
-import { RandexCase, RandexAlphabet, RandexItemSet, RandexContentArrayOptions, RandexSet, RandexSingleSet, RandexLength } from "../interfaces";
+import { RandexCase, RandexAlphabet, RandexItemSet, RandexContentArrayOptions, RandexSet, RandexSingleSet, RandexRange } from "../interfaces";
 export declare class RandexTypeParser {
     private static inRange;
     private static inLiteral;
     static inCase(value: string): value is RandexCase;
     static inAlphabet(value: any): value is RandexAlphabet;
     static inSet(value: string): value is RandexSingleSet;
-    static isLength(value: any): value is RandexLength;
+    static isLength(value: any): value is RandexRange;
     static isSetSingle(value: any): value is RandexItemSet;
     static isSet(value: any): value is RandexSet;
     static isPartArray(value: any): value is RandexContentArrayOptions;

package/lib/custom/email.d.ts

@@ -1,4 +1,4 @@
-import { RandexEmailOptions, RandexLength } from "../interfaces";
+import { RandexEmailOptions, RandexRange } from "../interfaces";
 export declare function randexEmail(options?: RandexEmailOptions): string;
-export declare function randexEmail(prefixLength: RandexLength, lowDomainLength?: RandexLength, hightDomainLength?: RandexLength): string;
+export declare function randexEmail(prefixLength: RandexRange, lowDomainLength?: RandexRange, hightDomainLength?: RandexRange): string;
 export declare function randexEmail(domain: string): string;

package/lib/custom/filenameX.d.ts

@@ -1,5 +1,5 @@
-import { RandexFileNameOptions, RandexLength } from "../interfaces";
+import { RandexFileNameOptions, RandexRange } from "../interfaces";
 export declare function randexFileName(options?: RandexFileNameOptions): string;
-export declare function randexFileName(fileNameLength: RandexLength, extensionLength?: RandexLength): string;
-export declare function randexFileName(fileNameLength: RandexLength, extension: string): string;
+export declare function randexFileName(fileNameLength: RandexRange, extensionLength?: RandexRange): string;
+export declare function randexFileName(fileNameLength: RandexRange, extension: string): string;
 export declare function randexFileName(extension: string): string;

package/lib/custom/fullnameX.d.ts

@@ -1,6 +1,6 @@
-import { RandexAlphabet, RandexFullNameOptions, RandexLength } from "../interfaces";
+import { RandexAlphabet, RandexFullNameOptions, RandexRange } from "../interfaces";
 export declare function randexFullName(options?: RandexFullNameOptions): string;
-export declare function randexFullName(length: RandexLength): string;
+export declare function randexFullName(length: RandexRange): string;
 export declare function randexFullName(alphabet?: RandexAlphabet): string;
-export declare function randexFullName(alphabet: RandexAlphabet, length: RandexLength): string;
-export declare function randexFullName(alphabet: RandexAlphabet, firstLength: RandexLength, secondLength: RandexLength): string;
+export declare function randexFullName(alphabet: RandexAlphabet, length: RandexRange): string;
+export declare function randexFullName(alphabet: RandexAlphabet, firstLength: RandexRange, secondLength: RandexRange): string;

package/lib/custom/index.d.ts

@@ -1,10 +1,11 @@
-import { RandexLength } from "../interfaces";
+import { RandexRange } from "../interfaces";
 import { randexBool } from "./bool";
 import { randexEmail } from "./email";
 import { randexFileName } from "./filenameX";
 import { randexFullName } from "./fullnameX";
 import { randexNumber } from "./number";
 import { randexRandom } from "./random";
+import { randexSentence } from "./sentence";
 import { randexSingleName } from "./singleName";
 import { randexUsername } from "./username";
 import { randexWord } from "./word";
@@ -18,16 +19,26 @@ export declare class Randex {
     static fileName: typeof randexFileName;
     static fullName: typeof randexFullName;
     static singleName: typeof randexSingleName;
-    static word: typeof randexWord;
-    static numberArray(length: RandexLength, count: number): number[];
     static number: typeof randexNumber;
     static username: typeof randexUsername;
-    static many(count: number): {
+    static word: typeof randexWord;
+    static sentence: typeof randexSentence;
+    static many(count: RandexRange): {
         word: {
             (options?: import("../interfaces").RandexWordOptions | undefined): string[];
-            (length: RandexLength): string[];
+            (length: RandexRange): string[];
             (alphabet?: import("../interfaces").RandexAlphabet | undefined): string[];
-            (alphabet: import("../interfaces").RandexAlphabet, length: RandexLength): string[];
+            (alphabet: import("../interfaces").RandexAlphabet, length: RandexRange): string[];
+        };
+        sentence: {
+            (options?: import("../interfaces").RandexSentenceOptions | undefined): string[];
+            (length: RandexRange): string[];
+            (alphabet?: import("../interfaces").RandexAlphabet | undefined): string[];
+            (alphabet: import("../interfaces").RandexAlphabet, length: RandexRange): string[];
+        };
+        number: {
+            (length: RandexRange, options?: import("../interfaces").RandomNumberOptions | undefined): number[];
+            (from: number, to: number, options?: import("../interfaces").RandomNumberOptions | undefined): number[];
         };
     };
 }

package/lib/custom/index.js

@@ -7,6 +7,7 @@ var filenameX_1 = require("./filenameX");
 var fullnameX_1 = require("./fullnameX");
 var number_1 = require("./number");
 var random_1 = require("./random");
+var sentence_1 = require("./sentence");
 var singleName_1 = require("./singleName");
 var username_1 = require("./username");
 var word_1 = require("./word");
@@ -42,33 +43,8 @@ var Randex = /** @class */ (function () {
         }
         return result;
     };
-    Randex.numberArray = function (length, count) {
-        var min = 0;
-        var max = 0;
-        var result = [];
-        if (typeof length === "number") {
-            max = length;
-        }
-        else {
-            min = length[0];
-            max = length[1];
-        }
-        var maxCount = max - min + 1;
-        var numberArray = [];
-        for (var i = min; i <= max; i++) {
-            numberArray.push(i);
-        }
-        for (var i = 0; i < count && i < maxCount; i++) {
-            var arrayCount = numberArray.length - 1;
-            var index = Randex.number(arrayCount);
-            var value = numberArray[index];
-            result.push(value);
-            numberArray.splice(index, 1);
-        }
-        return result;
-    };
     Randex.many = function (count) {
-        return { word: (0, word_1.randexManyWord)(count) };
+        return { word: (0, word_1.randexManyWord)(count), sentence: (0, sentence_1.randexManySentence)(count), number: (0, number_1.randexManyNumber)(count) };
     };
     Randex.random = random_1.randexRandom;
     Randex.bool = bool_1.randexBool;
@@ -76,9 +52,10 @@ var Randex = /** @class */ (function () {
     Randex.fileName = filenameX_1.randexFileName;
     Randex.fullName = fullnameX_1.randexFullName;
     Randex.singleName = singleName_1.randexSingleName;
-    Randex.word = word_1.randexWord;
     Randex.number = number_1.randexNumber;
     Randex.username = username_1.randexUsername;
+    Randex.word = word_1.randexWord;
+    Randex.sentence = sentence_1.randexSentence;
     return Randex;
 }());
 exports.Randex = Randex;

package/lib/custom/number.d.ts

@@ -1,3 +1,7 @@
-import { RandexLength, RandomNumberOptions } from "../interfaces";
-export declare function randexNumber(length: RandexLength, options?: RandomNumberOptions): number;
+import { RandexRange, RandomNumberOptions } from "../interfaces";
+export declare function randexNumber(length: RandexRange, options?: RandomNumberOptions): number;
 export declare function randexNumber(from: number, to: number, options?: RandomNumberOptions): number;
+export declare function randexManyNumber(count: RandexRange): {
+    (length: RandexRange, options?: RandomNumberOptions): number[];
+    (from: number, to: number, options?: RandomNumberOptions): number[];
+};

package/lib/custom/number.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randexNumber = void 0;
+exports.randexManyNumber = exports.randexNumber = void 0;
 var set_1 = require("../basic/set");
 function getNumberBase(decimals) {
     return decimals === 1 ? 10 : Math.pow(10, decimals);
@@ -15,7 +15,7 @@ function getNumberValue(value, decimals) {
 function innerRandomNumber(from, to, decimals) {
     var fromV = getNumberValue(from, decimals);
     var toV = getNumberValue(to, decimals);
-    var result = set_1.RandexSetUtil.randomNumber(toV - fromV + 1) + fromV;
+    var result = set_1.RandexSetUtil.randomRangeNumber(fromV, toV);
     if (typeof decimals === "number") {
         result = result / getNumberBase(decimals);
     }
@@ -37,3 +37,10 @@ function randexNumber(p1, p2, p3) {
     }
 }
 exports.randexNumber = randexNumber;
+function randexManyNumber(count) {
+    function many(p1, p2, p3) {
+        return set_1.RandexSetUtil.many(count, function () { return randexNumber(p1, p2, p3); });
+    }
+    return many;
+}
+exports.randexManyNumber = randexManyNumber;

package/lib/custom/random.js

@@ -12,10 +12,10 @@ function randomString(params) {
     }
     else if (Array.isArray(length)) {
         var min = length[0], max = length[1];
-        currentLength = min + set_1.RandexSetUtil.randomNumber(max - min + 1);
+        currentLength = set_1.RandexSetUtil.randomRangeNumber(min, max);
     }
     for (var i = 0; i < currentLength; i++) {
-        var index = set_1.RandexSetUtil.randomNumber(range.length - 1);
+        var index = set_1.RandexSetUtil.randomSingleNumber(range.length - 1);
         if (range.length >= index || range.length <= index) {
             result += range[index];
         }
@@ -38,14 +38,14 @@ function toContent(options) {
                 }
                 : {
                     set: set,
-                    range: rangeOrLength,
+                    charRange: rangeOrLength,
                 };
         }
         else if (options.length === 3) {
             var set = options[0], range = options[1], length_1 = options[2];
             return {
                 set: set,
-                range: range,
+                charRange: range,
                 length: length_1,
             };
         }
@@ -54,7 +54,7 @@ function toContent(options) {
 }
 function toRangeOptions(options) {
     var fullRange = "";
-    var set = options.set, range = options.range, _a = options.length, length = _a === void 0 ? 1 : _a;
+    var set = options.set, range = options.charRange, _a = options.length, length = _a === void 0 ? 1 : _a;
     if (range) {
         fullRange += range;
     }

package/lib/custom/sentence.d.ts

@@ -0,0 +1,11 @@
+import { RandexAlphabet, RandexRange, RandexSentenceOptions } from "../interfaces";
+export declare function randexSentence(options?: RandexSentenceOptions): string;
+export declare function randexSentence(length: RandexRange): string;
+export declare function randexSentence(alphabet?: RandexAlphabet): string;
+export declare function randexSentence(alphabet: RandexAlphabet, length: RandexRange): string;
+export declare function randexManySentence(count: RandexRange): {
+    (options?: RandexSentenceOptions): string[];
+    (length: RandexRange): string[];
+    (alphabet?: RandexAlphabet): string[];
+    (alphabet: RandexAlphabet, length: RandexRange): string[];
+};

package/lib/custom/sentence.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randexManySentence = exports.randexSentence = void 0;
+var const_1 = require("../basic/const");
+var set_1 = require("../basic/set");
+var type_1 = require("../basic/type");
+var word_1 = require("./word");
+function randexSentence(p1, p2) {
+    var length = const_1.DEFAULT_SENTENCE_RANGE;
+    var alphabet = "english";
+    if (type_1.RandexTypeParser.isLength(p1)) {
+        length = p1;
+    }
+    else if (type_1.RandexTypeParser.inAlphabet(p1)) {
+        alphabet = p1;
+        if (type_1.RandexTypeParser.isLength(p2)) {
+            length = p2;
+        }
+    }
+    else if (typeof p1 === "object") {
+        var options = p1;
+        if (options.alphabet) {
+            alphabet = options.alphabet;
+        }
+        if (options.wordRange) {
+            length = options.wordRange;
+        }
+    }
+    var words = (0, word_1.randexManyWord)(length)(alphabet);
+    return words
+        .map(function (text, index) {
+        var wordText = text;
+        if (index === 0 && text.length > 0) {
+            wordText = text[0].toUpperCase() + text.slice(1);
+        }
+        if (index + 1 >= words.length) {
+            wordText = wordText + ".";
+        }
+        return wordText;
+    })
+        .join(" ");
+}
+exports.randexSentence = randexSentence;
+function randexManySentence(count) {
+    function many(p1, p2) {
+        return set_1.RandexSetUtil.many(count, function () { return randexSentence(p1, p2); });
+    }
+    return many;
+}
+exports.randexManySentence = randexManySentence;

package/lib/custom/singleName.d.ts

@@ -1,5 +1,5 @@
-import { RandexAlphabet, RandexLength, RandexWordOptions } from "../interfaces";
+import { RandexAlphabet, RandexRange, RandexWordOptions } from "../interfaces";
 export declare function randexSingleName(options?: RandexWordOptions): string;
-export declare function randexSingleName(length: RandexLength): string;
+export declare function randexSingleName(length: RandexRange): string;
 export declare function randexSingleName(alphabet?: RandexAlphabet): string;
-export declare function randexSingleName(alphabet: RandexAlphabet, length: RandexLength): string;
+export declare function randexSingleName(alphabet: RandexAlphabet, length: RandexRange): string;

package/lib/custom/username.d.ts

@@ -1,2 +1,2 @@
-import { RandexLength, RandexUsernameOptions } from "../interfaces";
-export declare function randexUsername(options?: RandexUsernameOptions | RandexLength): string;
+import { RandexRange, RandexUsernameOptions } from "../interfaces";
+export declare function randexUsername(options?: RandexUsernameOptions | RandexRange): string;

package/lib/custom/word.d.ts

@@ -1,11 +1,11 @@
-import { RandexAlphabet, RandexLength, RandexWordOptions } from "../interfaces";
+import { RandexAlphabet, RandexRange, RandexWordOptions } from "../interfaces";
 export declare function randexWord(options?: RandexWordOptions): string;
-export declare function randexWord(length: RandexLength): string;
+export declare function randexWord(length: RandexRange): string;
 export declare function randexWord(alphabet?: RandexAlphabet): string;
-export declare function randexWord(alphabet: RandexAlphabet, length: RandexLength): string;
-export declare function randexManyWord(count: number): {
+export declare function randexWord(alphabet: RandexAlphabet, length: RandexRange): string;
+export declare function randexManyWord(count: RandexRange): {
     (options?: RandexWordOptions): string[];
-    (length: RandexLength): string[];
+    (length: RandexRange): string[];
     (alphabet?: RandexAlphabet): string[];
-    (alphabet: RandexAlphabet, length: RandexLength): string[];
+    (alphabet: RandexAlphabet, length: RandexRange): string[];
 };

package/lib/custom/word.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.randexManyWord = exports.randexWord = void 0;
+var const_1 = require("../basic/const");
 var set_1 = require("../basic/set");
 var type_1 = require("../basic/type");
 var random_1 = require("./random");
 function randexWord(p1, p2) {
-    var length = [2, 10];
+    var length = const_1.DEFAULT_WORD_RANGE;
     var alphabet = "english";
     if (type_1.RandexTypeParser.isLength(p1)) {
         length = p1;

package/lib/interfaces/base.d.ts

@@ -4,18 +4,18 @@ export type RandexSingleSet = RandexAlphabet | "hex" | "symbol" | "number" | "bi
 export type RandexAlphabetCase = [RandexAlphabet, RandexCase];
 export type RandexItemSet = RandexSingleSet | RandexAlphabetCase;
 export type RandexSet = RandexItemSet | RandexItemSet[];
-export type RandexLength = number | [number, number];
+export type RandexRange = number | [number, number];
 interface RandexItemBasicOptions {
     set?: RandexSet;
-    range?: string;
-    length?: RandexLength;
+    charRange?: string;
+    length?: RandexRange;
 }
 export interface RandexContentSetOptions extends Omit<RandexItemBasicOptions, "set"> {
     set: RandexSet;
 }
-export interface RandexContentRangeOptions extends Omit<RandexItemBasicOptions, "range"> {
-    range: string;
+export interface RandexContentRangeOptions extends Omit<RandexItemBasicOptions, "charRange"> {
+    charRange: string;
 }
-export type RandexContentArrayOptions = [RandexSet, string | RandexLength] | [RandexSet, string, RandexLength];
+export type RandexContentArrayOptions = [RandexSet, string | RandexRange] | [RandexSet, string, RandexRange];
 export type RandexContentOptions = RandexContentSetOptions | RandexContentRangeOptions | RandexContentArrayOptions | RandexSet;
 export {};

package/lib/interfaces/email.d.ts

@@ -1,10 +1,10 @@
-import { RandexLength } from "./base";
+import { RandexRange } from "./base";
 interface BasicEmailOptions {
-    prefixLength?: RandexLength;
+    prefixLength?: RandexRange;
 }
 interface DomainLengthEmailOptions {
-    hightDomainLength?: RandexLength;
-    lowDomainLength?: RandexLength;
+    hightDomainLength?: RandexRange;
+    lowDomainLength?: RandexRange;
 }
 interface DomainEmailOptions {
     domain?: string;

package/lib/interfaces/filename.d.ts

@@ -1,9 +1,9 @@
-import { RandexLength } from "./base";
+import { RandexRange } from "./base";
 interface BasicFileNameOptions {
-    fileNameLength?: RandexLength;
+    fileNameLength?: RandexRange;
 }
 interface ExtensionLengthFileNameOptions {
-    extensionLength?: RandexLength;
+    extensionLength?: RandexRange;
 }
 interface ExtensionFileNameOptions {
     extension?: string;

package/lib/interfaces/fullname.d.ts

@@ -1,6 +1,6 @@
-import { RandexAlphabet, RandexLength } from "./base";
+import { RandexAlphabet, RandexRange } from "./base";
 export interface RandexFullNameOptions {
     alphabet?: RandexAlphabet;
-    firstLength?: RandexLength;
-    secondLength?: RandexLength;
+    firstLength?: RandexRange;
+    secondLength?: RandexRange;
 }

package/lib/interfaces/index.d.ts

@@ -6,3 +6,4 @@ export * from "./number";
 export * from "./random";
 export * from "./username";
 export * from "./word";
+export * from "./sentence";

package/lib/interfaces/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./number"), exports);
 __exportStar(require("./random"), exports);
 __exportStar(require("./username"), exports);
 __exportStar(require("./word"), exports);
+__exportStar(require("./sentence"), exports);

package/lib/interfaces/random.d.ts

@@ -1,5 +1,5 @@
-import { RandexLength } from "./base";
+import { RandexRange } from "./base";
 export interface RandexRangeOptions {
     range: string;
-    length: RandexLength;
+    length: RandexRange;
 }

package/lib/interfaces/sentence.d.ts

@@ -0,0 +1,5 @@
+import { RandexAlphabet, RandexRange } from "./base";
+export interface RandexSentenceOptions {
+    alphabet?: RandexAlphabet;
+    wordRange?: RandexRange;
+}

package/lib/interfaces/sentence.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/interfaces/username.d.ts

@@ -1,4 +1,4 @@
-import { RandexLength } from "./base";
+import { RandexRange } from "./base";
 export interface RandexUsernameOptions {
-    length?: RandexLength;
+    length?: RandexRange;
 }

package/lib/interfaces/word.d.ts

@@ -1,5 +1,5 @@
-import { RandexAlphabet, RandexLength } from "./base";
+import { RandexAlphabet, RandexRange } from "./base";
 export interface RandexWordOptions {
     alphabet?: RandexAlphabet;
-    length?: RandexLength;
+    length?: RandexRange;
 }

package/lib/test/markdown.test.js

@@ -36,7 +36,7 @@ describe("markdown", function () {
         expect(value.length).toBe(3);
         //
         value = custom_1.Randex.random({
-            range: "abc123",
+            charRange: "abc123",
             length: 3,
         });
         expect(value.length).toBe(3);

package/lib/test/{number-array.test.js → number.many.test.js}

@@ -2,20 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 var custom_1 = require("../custom");
 function testNumber(min, max, count) {
-    var value = custom_1.Randex.numberArray([min, max], count);
+    var value = custom_1.Randex.many(count).number([min, max]);
     var uniqueResult = [];
-    var _loop_1 = function (i) {
+    for (var i = 0; i < count; i++) {
         var uniqueValue = value[i];
-        expect(uniqueResult.find(function (x) { return x === uniqueValue; })).toBeFalsy();
         expect(value[i]).toBeGreaterThanOrEqual(min);
         expect(value[i]).toBeLessThanOrEqual(max);
         uniqueResult.push(uniqueValue);
-    };
-    for (var i = 0; i < count; i++) {
-        _loop_1(i);
     }
 }
-describe("randomNumberArray", function () {
+describe("random many number", function () {
     it("param: number", function () {
         testNumber(0, 2, 0);
         testNumber(1, 5, 1);
@@ -31,23 +27,23 @@ describe("randomNumberArray", function () {
         var min = 5;
         var max = 10;
         var count = max - min + 1;
-        var value = custom_1.Randex.numberArray([min, max], count);
+        var value = custom_1.Randex.many(count).number([min, max]);
         expect(value.length).toBe(count);
         // max length limit
-        value = custom_1.Randex.numberArray([min, max], count + 10);
-        expect(value.length).toBe(count);
+        value = custom_1.Randex.many(count + 10).number([min, max]);
+        expect(value.length).toBe(count + 10);
     });
     it("range: fill all possible values", function () {
         var min = 5;
         var max = 10;
         var count = max - min + 1;
-        var value = custom_1.Randex.numberArray([min, max], count);
-        expect(value.length).toBe(count);
-        var _loop_2 = function (i) {
+        var value = custom_1.Randex.many(count + 10).number([min, max]);
+        expect(value.length).toBe(count + 10);
+        var _loop_1 = function (i) {
             expect(value.find(function (x) { return x === i; })).toBeTruthy();
         };
         for (var i = min; i <= max; i++) {
-            _loop_2(i);
+            _loop_1(i);
         }
     });
 });

package/lib/test/params.test.js

@@ -36,7 +36,7 @@ describe("random params", function () {
     it("array 2 (range)", function () {
         var set = "number";
         var range = "abcdefghijklmnopqrstuvwxyz";
-        var result1 = custom_1.Randex.random({ set: set, range: range });
+        var result1 = custom_1.Randex.random({ set: set, charRange: range });
         var result2 = custom_1.Randex.random([set, range]);
         test_util_1.TestUtil.testInBoth(result1, set, range);
         test_util_1.TestUtil.testInBoth(result2, set, range);
@@ -53,7 +53,7 @@ describe("random params", function () {
         var set = "number";
         var range = "abcdefghijklmnopqrstuvwxyz";
         var length = 3;
-        var result1 = custom_1.Randex.random({ set: set, range: range, length: length });
+        var result1 = custom_1.Randex.random({ set: set, charRange: range, length: length });
         var result2 = custom_1.Randex.random([set, range, length]);
         test_util_1.TestUtil.testInBoth(result1, set, range, length);
         test_util_1.TestUtil.testInBoth(result2, set, range, length);

package/lib/test/random.test.js

@@ -9,7 +9,7 @@ function inSet(set, length) {
 }
 function inRange(range, length) {
     if (length === void 0) { length = 1; }
-    var result = custom_1.Randex.random({ range: range, length: length });
+    var result = custom_1.Randex.random({ charRange: range, length: length });
     test_util_1.TestUtil.testInRange(result, range, length);
 }
 describe("random", function () {

package/lib/test/sentence.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/test/sentence.test.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var custom_1 = require("../custom");
+var test_util_1 = require("./test-util");
+describe("sentence", function () {
+    it("default", function () {
+        test_util_1.TestUtil.loop(function () {
+            var text = custom_1.Randex.sentence();
+            expect(test_util_1.TestUtil.isSentenceValid(text)).toBeTruthy();
+        });
+    });
+    it("range", function () {
+        var range = [10, 20];
+        test_util_1.TestUtil.loop(function () {
+            var text = custom_1.Randex.sentence(range);
+            expect(test_util_1.TestUtil.isSentenceValid(text, range)).toBeTruthy();
+        });
+    });
+    it("specific number", function () {
+        var range = 5;
+        test_util_1.TestUtil.loop(function () {
+            var text = custom_1.Randex.sentence(range);
+            expect(test_util_1.TestUtil.isSentenceValid(text, range)).toBeTruthy();
+        });
+    });
+    it("many", function () {
+        var count = 5;
+        var sentences = custom_1.Randex.many(count).sentence();
+        for (var i = 0; i < count; i++) {
+            expect(test_util_1.TestUtil.isSentenceValid(sentences[i])).toBeTruthy();
+        }
+    });
+});

package/lib/test/test-util.d.ts

@@ -1,20 +1,21 @@
-import { RandexLength, RandexSet } from "../interfaces";
+import { RandexRange, RandexSet } from "../interfaces";
 export declare class TestUtil {
-    static testIn(value: string, length: RandexLength | undefined, action: () => void): void;
+    static testIn(value: string, length: RandexRange | undefined, action: () => void): void;
     static loop(action: (index: number) => void): void;
-    static testInSet(value: string, set: RandexSet, length?: RandexLength): void;
-    static testInSetRange(value: string, set: RandexSet, range: string, length?: RandexLength): void;
-    static testInRange(value: string, range: string, length?: RandexLength): void;
-    static testInBoth(value: string, set: RandexSet, range: string, length?: RandexLength): void;
+    static testInSet(value: string, set: RandexSet, length?: RandexRange): void;
+    static testInSetRange(value: string, set: RandexSet, range: string, length?: RandexRange): void;
+    static testInRange(value: string, range: string, length?: RandexRange): void;
+    static testInBoth(value: string, set: RandexSet, range: string, length?: RandexRange): void;
     static inRange(value: string, range: string): boolean;
     static inSet(value: string, set: RandexSet, range?: string): boolean;
     static inBoth(value: string, set: RandexSet, range: string): boolean;
     static isEmailValid(email: string): RegExpMatchArray | null;
     static isUsernameValid(email: string): RegExpMatchArray | null;
     static isNameValid(email: string): RegExpMatchArray | null;
-    static isWordValid(word: string, length?: RandexLength): RegExpMatchArray | null;
-    static isUpperCharValid(value: string, length?: RandexLength): RegExpMatchArray | null;
-    static isLowerCharValid(value: string, length?: RandexLength): RegExpMatchArray | null;
+    static isWordValid(text: string, length?: RandexRange): RegExpMatchArray | null;
+    static isSentenceValid(text: string, length?: RandexRange): boolean;
+    static isUpperCharValid(value: string, length?: RandexRange): RegExpMatchArray | null;
+    static isLowerCharValid(value: string, length?: RandexRange): RegExpMatchArray | null;
     static isFullNameValid(email: string): RegExpMatchArray | null;
     static isFileNameValid(email: string): RegExpMatchArray | null;
     static inNumberRange(value: number, range: [number, number]): boolean;

package/lib/test/test-util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestUtil = void 0;
+var const_1 = require("../basic/const");
 var set_1 = require("../basic/set");
 var TestUtil = /** @class */ (function () {
     function TestUtil() {
@@ -77,10 +78,21 @@ var TestUtil = /** @class */ (function () {
     TestUtil.isNameValid = function (email) {
         return String(email).match(/^[A-Z][a-z]{1,}$/);
     };
-    TestUtil.isWordValid = function (word, length) {
-        if (length === void 0) { length = 2; }
+    TestUtil.isWordValid = function (text, length) {
+        if (length === void 0) { length = const_1.DEFAULT_WORD_RANGE; }
         var l = TestUtil.getLength(length);
-        return String(word).match(new RegExp("^[a-z]{".concat(l, "}$")));
+        return String(text).match(new RegExp("^[a-z]{".concat(l, "}$")));
+    };
+    TestUtil.isSentenceValid = function (text, length) {
+        if (length === void 0) { length = const_1.DEFAULT_SENTENCE_RANGE; }
+        var splits = text.split(" ");
+        if (Array.isArray(length)) {
+            var min = length[0], max = length[1];
+            return splits.length >= min && splits.length <= max;
+        }
+        else {
+            return splits.length === length;
+        }
     };
     TestUtil.isUpperCharValid = function (value, length) {
         if (length === void 0) { length = 1; }

package/lib/test/word.test.js

@@ -1,20 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+var const_1 = require("../basic/const");
 var custom_1 = require("../custom");
 var test_util_1 = require("./test-util");
 describe("word", function () {
     it("classic", function () {
         test_util_1.TestUtil.loop(function () {
             var w = custom_1.Randex.word();
-            expect(test_util_1.TestUtil.isWordValid(w, [2, 10])).toBeTruthy();
+            expect(test_util_1.TestUtil.isWordValid(w, const_1.DEFAULT_WORD_RANGE)).toBeTruthy();
         });
     });
-    it("many", function () {
+    it("many - number", function () {
         var count = 5;
         var ws = custom_1.Randex.many(count).word();
         expect(ws.length).toBe(count);
         for (var i = 0; i < count; i++) {
-            expect(test_util_1.TestUtil.isWordValid(ws[i], [2, 10])).toBeTruthy();
+            expect(test_util_1.TestUtil.isWordValid(ws[i], const_1.DEFAULT_WORD_RANGE)).toBeTruthy();
         }
     });
+    it("many - range", function () {
+        var count = [5, 10];
+        var ws = custom_1.Randex.many(count).word();
+        expect(ws.length).toBeGreaterThanOrEqual(5);
+        expect(ws.length).toBeLessThanOrEqual(10);
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "randex",
-  "version": "0.26.0",
+  "version": "0.31.0",
   "description": "",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",