randex 0.26.0 → 0.28.0

package/README.md

@@ -17,12 +17,13 @@ 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)
@@ -118,6 +119,84 @@ Options:
 |range|`string`| Range or custom chars |
 |length|[RandexLength](#randexlength) | 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|[RandexLength](#randexlength) | 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 length 5 chars
+Randex.sentence({ wordRange: 5 });
+// or:
+Randex.sentence(5);
+// Xja wyfbhnhtl ptn shemiukme poyyjtr.
+
+// with word range
+Randex.sentence({ wordRange: [3, 6] });
+// or:
+Randex.sentence([3, 6]);
+// Vg nfobxcwg tmhfu hiqonw.
+
+// name from 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|
+| ------------------------ | ---- |------------ |
+|length|[RandexLength](#randexlength) | Length of chars. Default: [2,10] |
+|alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
+
 ## fileName
 
 Randoms file name.
@@ -302,50 +381,6 @@ Options:
 |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] |
-|alphabet|[RandexAlphabet](#randexalphabet) | Defined alphabet. Default: `english` |
-
-
 ## number
 
 Generates random number from a range of numbers.

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,23 @@ 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 numberArray(length: RandexRange, 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: RandexRange): string[];
+        };
+        sentence: {
+            (options?: import("../interfaces").RandexSentenceOptions | undefined): string[];
+            (length: RandexRange): string[];
             (alphabet?: import("../interfaces").RandexAlphabet | undefined): string[];
-            (alphabet: import("../interfaces").RandexAlphabet, length: RandexLength): string[];
+            (alphabet: import("../interfaces").RandexAlphabet, length: RandexRange): string[];
         };
     };
 }

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");
@@ -68,7 +69,7 @@ var Randex = /** @class */ (function () {
         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) };
     };
     Randex.random = random_1.randexRandom;
     Randex.bool = bool_1.randexBool;
@@ -76,9 +77,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,3 @@
-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;

package/lib/custom/number.js

@@ -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);
     }

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];
         }

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,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 RandexLength = number | [number, number];
+export type RandexRange = number | [number, number];
 interface RandexItemBasicOptions {
     set?: RandexSet;
     range?: string;
-    length?: RandexLength;
+    length?: RandexRange;
 }
 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, "range"> {
     range: 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/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.28.0",
   "description": "",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",