randex 0.31.0 → 0.33.0

package/README.md

@@ -18,12 +18,13 @@ Strings:
 
 - [random](#random)
 - [word](#word)
-- [sentence](#sentence)
 - [fileName](#filename)
 - [username](#username)
 - [email](#email)
 - [singleName](#singlename)
 - [fullName](#fullname)
+- [phrase](#phrase)
+- [sentence](#sentence)
 
 Numbers:
 - [number](#number)
@@ -120,7 +121,7 @@ Options:
 | ------------------------ | ---- |------------ |
 |set|[RandexSet](#randexset) | Defined chars|
 |charRange|`string`| Range or custom chars |
-|length|[RandexRange](#randexrange) | Length of chars |
+|length|[RandexNumberRange](#randexnumberrange) | Length of chars |
 
 ## word
 
@@ -161,43 +162,7 @@ Randex.word("french", 10);
 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] |
+|length|[RandexNumberRange](#randexnumberrange) | Length of chars. Default: [2,10] |
 |alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
 
 ## fileName
@@ -243,8 +208,8 @@ Randex.fileName(8, "xml");
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|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] |
+|fileNameLength|[RandexNumberRange](#randexnumberrange) | Length of file name (not including extension). Default: [3,10] |
+|extensionLength|[RandexNumberRange](#randexnumberrange) | Length of extension (not including file name) chars. Default: [2,5] |
 |extension| `string`| File extension. |
 
 ## username
@@ -274,9 +239,9 @@ Randex.username([2, 5]);
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|length|[RandexRange](#randexrange) | Length of chars. Default: [6,10] |
+|length|[RandexNumberRange](#randexnumberrange) | Length of chars. Default: [6,10] |
 
-## randomEmail
+## email
 
 Randoms an email.
 
@@ -317,9 +282,9 @@ randomEmail("test.com");
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|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] |
+|prefixLength|[RandexNumberRange](#randexnumberrange) | Length of email prefix (chars before `@`). Default: [6, 10] |
+|hightDomainLength|[RandexNumberRange](#randexnumberrange) | Length of hight domain part (example: test.<b>com</b>). Default: [1,6] |
+|lowDomainLength|[RandexNumberRange](#randexnumberrange) | Length of low domain part (example: <b>test</b>.com). Default: [4,2] |
 |domain| `string`| Defined domain. |
 
 ## singleName
@@ -361,10 +326,10 @@ Randex.singleName("french", 10);
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|length|[RandexRange](#randexrange) | Length of chars. Default: [2,10] |
+|length|[RandexNumberRange](#randexnumberrange) | Length of chars. Default: [2,10] |
 |alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
 
-## randomFullName
+## fullName
 
 Randoms a full name of the person.
 
@@ -379,8 +344,81 @@ Randex.fullName();
 Options:
 | Name | Type| Description|
 | ------------------------ | ---- |------------ |
-|firstLength|[RandexRange](#randexrange) | First name length of chars. Default: [2, 10] |
-|secondLength|[RandexRange](#randexrange) | Second name length of chars. Default: [2,10] |
+|firstLength|[RandexNumberRange](#randexnumberrange) | First name length of chars. Default: [2, 10] |
+|secondLength|[RandexNumberRange](#randexnumberrange) | Second name length of chars. Default: [2,10] |
+|alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
+
+## phrase
+
+Randoms a phrase.
+
+```ts
+import Randex from "randex";
+
+// default word range is from 2 to 9
+Randex.phrase();
+// te vdancy poluwsd sswl aqxq
+
+// with 5 words
+Randex.v({ words: 5 });
+// or:
+Randex.sentence(5);
+// wyfb hnhtl ptn shemiukme poyyjtr
+
+// with words range
+Randex.sentence({ words: [3, 6] });
+// or:
+Randex.sentence([3, 6]);
+// nfob xcwg tmhfu hiqonw
+
+// with french alphabet
+Randex.sentence({ alphabet: "french" });
+// or:
+Randex.sentence("french");
+// æeâoô déèbfûûæ aôç udôûsèqpa ygyïœùuè oê
+```
+
+Options:
+| Name | Type| Description|
+| ------------------------ | ---- |------------ |
+|words|[RandexNumberRange](#randexnumberrange) | A number or range of words. Default: [2,9] |
+|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({ words: 5 });
+// or:
+Randex.sentence(5);
+// Xja wyfbhnhtl ptn shemiukme poyyjtr.
+
+// with words range
+Randex.sentence({ words: [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|
+| ------------------------ | ---- |------------ |
+|words|[RandexNumberRange](#randexnumberrange) | A number or range of words. Default: [3,15] |
 |alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
 
 
@@ -413,6 +451,9 @@ import Randex from "randex";
 // Generates three words with english alphabet.
 Randex.many(3).word("english");
 
+// Generates seven phrases with english alphabet.
+Randex.many(7).phrase("english");
+
 // Generates five sentences with french alphabet.
 Randex.many(5).sentence("french");
 
@@ -520,7 +561,7 @@ Randex.random(
 
 ## Types
 
-## RandexRange
+### RandexNumberRange
 
 Possible types:
 
@@ -538,7 +579,7 @@ Randex.random(["bit", 5]);
 Randex.random(["bit", [5, 10]]);
 ```
 
-## RandexSet
+### RandexSet
 
 Possible types:
 
@@ -558,7 +599,7 @@ Randex.random("spanish");
 Randex.random(["spanish", "l"]);
 ```
 
-## RandexAlphabet
+### RandexAlphabet
 
 An alphabet of chars
 
@@ -572,7 +613,7 @@ Randex.random({ set: "spanish" });
 Randex.random("spanish");
 ```
 
-## RandexKit
+### RandexKit
 
 A kit of chars
 
@@ -586,7 +627,7 @@ Randex.random({ set: "hex" });
 Randex.random("hex");
 ```
 
-## RandexCase
+### RandexCase
 
 A case of alphabet
 

package/lib/basic/const.d.ts

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

package/lib/basic/const.js

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

package/lib/basic/set.d.ts

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

package/lib/basic/type.d.ts

@@ -1,11 +1,11 @@
-import { RandexCase, RandexAlphabet, RandexItemSet, RandexContentArrayOptions, RandexSet, RandexSingleSet, RandexRange } from "../interfaces";
+import { RandexCase, RandexAlphabet, RandexItemSet, RandexContentArrayOptions, RandexSet, RandexSingleSet, RandexNumberRange } 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 RandexRange;
+    static isLength(value: any): value is RandexNumberRange;
     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, RandexRange } from "../interfaces";
+import { RandexEmailOptions, RandexNumberRange } from "../interfaces";
 export declare function randexEmail(options?: RandexEmailOptions): string;
-export declare function randexEmail(prefixLength: RandexRange, lowDomainLength?: RandexRange, hightDomainLength?: RandexRange): string;
+export declare function randexEmail(prefixLength: RandexNumberRange, lowDomainLength?: RandexNumberRange, hightDomainLength?: RandexNumberRange): string;
 export declare function randexEmail(domain: string): string;

package/lib/custom/filenameX.d.ts

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

package/lib/custom/fullnameX.d.ts

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

package/lib/custom/index.d.ts

@@ -1,9 +1,10 @@
-import { RandexRange } from "../interfaces";
+import { RandexNumberRange } from "../interfaces";
 import { randexBool } from "./bool";
 import { randexEmail } from "./email";
 import { randexFileName } from "./filenameX";
 import { randexFullName } from "./fullnameX";
 import { randexNumber } from "./number";
+import { randexPhrase } from "./phrase";
 import { randexRandom } from "./random";
 import { randexSentence } from "./sentence";
 import { randexSingleName } from "./singleName";
@@ -23,21 +24,28 @@ export declare class Randex {
     static username: typeof randexUsername;
     static word: typeof randexWord;
     static sentence: typeof randexSentence;
-    static many(count: RandexRange): {
+    static phrase: typeof randexPhrase;
+    static many(count: RandexNumberRange): {
         word: {
             (options?: import("../interfaces").RandexWordOptions | undefined): string[];
-            (length: RandexRange): string[];
+            (length: RandexNumberRange): string[];
             (alphabet?: import("../interfaces").RandexAlphabet | undefined): string[];
-            (alphabet: import("../interfaces").RandexAlphabet, length: RandexRange): string[];
+            (alphabet: import("../interfaces").RandexAlphabet, length: RandexNumberRange): string[];
+        };
+        phrase: {
+            (options?: import("../interfaces").RandexPhraseOptions | undefined): string[];
+            (words: RandexNumberRange): string[];
+            (alphabet?: import("../interfaces").RandexAlphabet | undefined): string[];
+            (alphabet: import("../interfaces").RandexAlphabet, words: RandexNumberRange): string[];
         };
         sentence: {
             (options?: import("../interfaces").RandexSentenceOptions | undefined): string[];
-            (length: RandexRange): string[];
+            (words: RandexNumberRange): string[];
             (alphabet?: import("../interfaces").RandexAlphabet | undefined): string[];
-            (alphabet: import("../interfaces").RandexAlphabet, length: RandexRange): string[];
+            (alphabet: import("../interfaces").RandexAlphabet, words: RandexNumberRange): string[];
         };
         number: {
-            (length: RandexRange, options?: import("../interfaces").RandomNumberOptions | undefined): number[];
+            (length: RandexNumberRange, options?: import("../interfaces").RandomNumberOptions | undefined): number[];
             (from: number, to: number, options?: import("../interfaces").RandomNumberOptions | undefined): number[];
         };
     };

package/lib/custom/index.js

@@ -6,6 +6,7 @@ var email_1 = require("./email");
 var filenameX_1 = require("./filenameX");
 var fullnameX_1 = require("./fullnameX");
 var number_1 = require("./number");
+var phrase_1 = require("./phrase");
 var random_1 = require("./random");
 var sentence_1 = require("./sentence");
 var singleName_1 = require("./singleName");
@@ -44,7 +45,7 @@ var Randex = /** @class */ (function () {
         return result;
     };
     Randex.many = function (count) {
-        return { word: (0, word_1.randexManyWord)(count), sentence: (0, sentence_1.randexManySentence)(count), number: (0, number_1.randexManyNumber)(count) };
+        return { word: (0, word_1.randexManyWord)(count), phrase: (0, phrase_1.randexManyPhrase)(count), sentence: (0, sentence_1.randexManySentence)(count), number: (0, number_1.randexManyNumber)(count) };
     };
     Randex.random = random_1.randexRandom;
     Randex.bool = bool_1.randexBool;
@@ -56,6 +57,7 @@ var Randex = /** @class */ (function () {
     Randex.username = username_1.randexUsername;
     Randex.word = word_1.randexWord;
     Randex.sentence = sentence_1.randexSentence;
+    Randex.phrase = phrase_1.randexPhrase;
     return Randex;
 }());
 exports.Randex = Randex;

package/lib/custom/number.d.ts

@@ -1,7 +1,7 @@
-import { RandexRange, RandomNumberOptions } from "../interfaces";
-export declare function randexNumber(length: RandexRange, options?: RandomNumberOptions): number;
+import { RandexNumberRange, RandomNumberOptions } from "../interfaces";
+export declare function randexNumber(length: RandexNumberRange, 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[];
+export declare function randexManyNumber(count: RandexNumberRange): {
+    (length: RandexNumberRange, options?: RandomNumberOptions): number[];
     (from: number, to: number, options?: RandomNumberOptions): number[];
 };

package/lib/custom/phrase.d.ts

@@ -0,0 +1,11 @@
+import { RandexAlphabet, RandexNumberRange, RandexPhraseOptions } from "../interfaces";
+export declare function randexPhrase(options?: RandexPhraseOptions): string;
+export declare function randexPhrase(words: RandexNumberRange): string;
+export declare function randexPhrase(alphabet?: RandexAlphabet): string;
+export declare function randexPhrase(alphabet: RandexAlphabet, words: RandexNumberRange): string;
+export declare function randexManyPhrase(count: RandexNumberRange): {
+    (options?: RandexPhraseOptions): string[];
+    (words: RandexNumberRange): string[];
+    (alphabet?: RandexAlphabet): string[];
+    (alphabet: RandexAlphabet, words: RandexNumberRange): string[];
+};

package/lib/custom/phrase.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randexManyPhrase = exports.randexPhrase = 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 randexPhrase(p1, p2) {
+    var length = const_1.DEFAULT_PHRASE_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.words) {
+            length = options.words;
+        }
+    }
+    var words = (0, word_1.randexManyWord)(length)(alphabet);
+    return words.join(" ");
+}
+exports.randexPhrase = randexPhrase;
+function randexManyPhrase(count) {
+    function many(p1, p2) {
+        return set_1.RandexSetUtil.many(count, function () { return randexPhrase(p1, p2); });
+    }
+    return many;
+}
+exports.randexManyPhrase = randexManyPhrase;

package/lib/custom/sentence.d.ts

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

package/lib/custom/sentence.js

@@ -22,8 +22,8 @@ function randexSentence(p1, p2) {
         if (options.alphabet) {
             alphabet = options.alphabet;
         }
-        if (options.wordRange) {
-            length = options.wordRange;
+        if (options.words) {
+            length = options.words;
         }
     }
     var words = (0, word_1.randexManyWord)(length)(alphabet);

package/lib/custom/singleName.d.ts

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

package/lib/custom/username.d.ts

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

package/lib/custom/word.d.ts

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

package/lib/interfaces/base.d.ts

@@ -4,11 +4,11 @@ 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 RandexRange = number | [number, number];
+export type RandexNumberRange = number | [number, number];
 interface RandexItemBasicOptions {
     set?: RandexSet;
     charRange?: string;
-    length?: RandexRange;
+    length?: RandexNumberRange;
 }
 export interface RandexContentSetOptions extends Omit<RandexItemBasicOptions, "set"> {
     set: RandexSet;
@@ -16,6 +16,6 @@ export interface RandexContentSetOptions extends Omit<RandexItemBasicOptions, "s
 export interface RandexContentRangeOptions extends Omit<RandexItemBasicOptions, "charRange"> {
     charRange: string;
 }
-export type RandexContentArrayOptions = [RandexSet, string | RandexRange] | [RandexSet, string, RandexRange];
+export type RandexContentArrayOptions = [RandexSet, string | RandexNumberRange] | [RandexSet, string, RandexNumberRange];
 export type RandexContentOptions = RandexContentSetOptions | RandexContentRangeOptions | RandexContentArrayOptions | RandexSet;
 export {};

package/lib/interfaces/email.d.ts

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

package/lib/interfaces/filename.d.ts

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

package/lib/interfaces/fullname.d.ts

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

package/lib/interfaces/index.d.ts

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

package/lib/interfaces/index.js

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

package/lib/interfaces/phrase.d.ts

@@ -0,0 +1,5 @@
+import { RandexAlphabet, RandexNumberRange } from "./base";
+export interface RandexPhraseOptions {
+    alphabet?: RandexAlphabet;
+    words?: RandexNumberRange;
+}

package/lib/interfaces/phrase.js

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

package/lib/interfaces/random.d.ts

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

package/lib/interfaces/sentence.d.ts

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

package/lib/interfaces/username.d.ts

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

package/lib/interfaces/word.d.ts

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

package/lib/test/number.many.test.js

@@ -33,7 +33,7 @@ describe("random many number", function () {
         value = custom_1.Randex.many(count + 10).number([min, max]);
         expect(value.length).toBe(count + 10);
     });
-    it("range: fill all possible values", function () {
+    it.skip("range: fill all possible values", function () {
         var min = 5;
         var max = 10;
         var count = max - min + 1;

package/lib/test/phrase.test.d.ts

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

package/lib/test/phrase.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("phrase", function () {
+    it("default", function () {
+        test_util_1.TestUtil.loop(function () {
+            var text = custom_1.Randex.phrase();
+            expect(test_util_1.TestUtil.isPhraseValid(text)).toBeTruthy();
+        });
+    });
+    it("range", function () {
+        var range = [10, 20];
+        test_util_1.TestUtil.loop(function () {
+            var text = custom_1.Randex.phrase(range);
+            expect(test_util_1.TestUtil.isPhraseValid(text, range)).toBeTruthy();
+        });
+    });
+    it("specific number", function () {
+        var range = 5;
+        test_util_1.TestUtil.loop(function () {
+            var text = custom_1.Randex.phrase(range);
+            expect(test_util_1.TestUtil.isPhraseValid(text, range)).toBeTruthy();
+        });
+    });
+    it("many", function () {
+        var count = 5;
+        var phrases = custom_1.Randex.many(count).phrase();
+        for (var i = 0; i < count; i++) {
+            expect(test_util_1.TestUtil.isPhraseValid(phrases[i])).toBeTruthy();
+        }
+    });
+});

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

@@ -1,21 +1,22 @@
-import { RandexRange, RandexSet } from "../interfaces";
+import { RandexNumberRange, RandexSet } from "../interfaces";
 export declare class TestUtil {
-    static testIn(value: string, length: RandexRange | undefined, action: () => void): void;
+    static testIn(value: string, length: RandexNumberRange | undefined, action: () => void): void;
     static loop(action: (index: number) => void): 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 testInSet(value: string, set: RandexSet, length?: RandexNumberRange): void;
+    static testInSetRange(value: string, set: RandexSet, range: string, length?: RandexNumberRange): void;
+    static testInRange(value: string, range: string, length?: RandexNumberRange): void;
+    static testInBoth(value: string, set: RandexSet, range: string, length?: RandexNumberRange): 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(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 isWordValid(text: string, length?: RandexNumberRange): RegExpMatchArray | null;
+    static isSentenceValid(text: string, length?: RandexNumberRange): boolean;
+    static isPhraseValid(text: string, length?: RandexNumberRange): boolean;
+    static isUpperCharValid(value: string, length?: RandexNumberRange): RegExpMatchArray | null;
+    static isLowerCharValid(value: string, length?: RandexNumberRange): 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

@@ -94,6 +94,17 @@ var TestUtil = /** @class */ (function () {
             return splits.length === length;
         }
     };
+    TestUtil.isPhraseValid = function (text, length) {
+        if (length === void 0) { length = const_1.DEFAULT_PHRASE_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; }
         var l = TestUtil.getLength(length);

package/package.json

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