fix(types): add missing types, harmonize defaults, correct some default error, ordonne like the documentation

Author: thib3113

index.d.ts

@@ -66,6 +66,10 @@ export interface RuleArray<T = any> extends RuleCustom {
      * The array must contain this element too
      */
     contains?: T | T[];
+	/**
+	 * The array must be unique (array of objects is always unique).
+	 */
+	unique?: boolean;
     /**
      * Every element must be an element of the enum array
      */
@@ -74,10 +78,10 @@ export interface RuleArray<T = any> extends RuleCustom {
      * Validation rules that should be applied to each element of array
      */
     items?: ValidationRule;
-    /**
-	 * The array must be unique (array of objects is always unique).
+	/**
+	 * Wrap value into array if different type provided
 	 */
-    unique?: boolean;
+	convert?: boolean
 }
 
 /**
@@ -122,7 +126,6 @@ export interface RuleCurrency extends RuleCustom {
 	type: "currency";
 	/**
 	 * The currency symbol expected in string (as prefix)
-	 * @default null
 	 */
 	currencySymbol?: string;
 	/**
@@ -173,13 +176,19 @@ export interface RuleEmail extends RuleCustom {
 	type: "email";
 	/**
 	 * If true, the validator accepts an empty string ""
-	 * @default true
+	 * @default false
 	 */
 	empty?: boolean;
 	/**
 	 * Checker method. Can be quick or precise
+	 * @default quick
 	 */
 	mode?: "quick" | "precise";
+	/**
+	 * Normalize the e-mail address (trim & lower-case). It's a sanitizer, it will change the value in the original object.
+	 * @default false
+	 */
+	normalize?: boolean;
 	/**
 	 * Minimum value length
 	 */
@@ -188,8 +197,6 @@ export interface RuleEmail extends RuleCustom {
 	 * Maximum value length
 	 */
 	max?: number;
-
-	normalize?: boolean;
 }
 
 /**
@@ -229,8 +236,7 @@ export interface RuleEqual<T = any> extends RuleCustom {
 	/**
 	 * Strict value checking.
 	 *
-	 * @type {'boolean'}
-	 * @memberof RuleEqual
+	 * @default false
 	 */
 	strict?: boolean;
 }
@@ -248,8 +254,7 @@ export interface RuleForbidden extends RuleCustom {
 	/**
 	 * Removes the forbidden value.
 	 *
-	 * @type {'boolean'}
-	 * @memberof RuleForbidden
+	 * @default false
 	 */
 	remove?: boolean;
 }
@@ -377,28 +382,14 @@ export interface RuleObject extends RuleCustom {
 	maxProps?: number;
 }
 
-export interface RuleObjectID extends RuleCustom {
-	/**
-	 * Name of built-in validator
-	 */
-	type: "objectID";
-	/**
-	 * To inject ObjectID dependency
-	 */
-	ObjectID?: any;
-	/**
-	 * Convert HexStringObjectID to ObjectID
-	 */
-	convert?: boolean | "hexString";
-}
-
 export interface RuleRecord extends RuleCustom {
 	/**
 	 * Name of built-in validator
 	 */
 	type: "record";
 	/**
 	 * Key validation rule
+	 * @default "string"
 	 */
 	key?: RuleString;
 	/**
@@ -445,14 +436,14 @@ export interface RuleString extends RuleCustom {
 	 * The value must be an element of the enum array
 	 */
 	enum?: string[];
-	/**
-	 * The value must be a numeric string
-	 */
-	numeric?: boolean;
 	/**
 	 * The value must be an alphabetic string
 	 */
 	alpha?: boolean;
+	/**
+	 * The value must be a numeric string
+	 */
+	numeric?: boolean;
 	/**
 	 * The value must be an alphanumeric string
 	 */
@@ -463,37 +454,61 @@ export interface RuleString extends RuleCustom {
 	alphadash?: boolean;
 	/**
 	 * The value must be a hex string
-	 * @default false
 	 */
 	hex?: boolean;
 	/**
 	 * The value must be a singleLine string
-	 * @default false
 	 */
 	singleLine?: boolean;
 	/**
 	 * The value must be a base64 string
-	 * @default false
 	 */
 	base64?: boolean;
 	/**
-	 * if true and the type is not a String, converts with String()
-	 * @default false
+	 * If true, the value will be trimmed. It's a sanitizer, it will change the value in the original object.
 	 */
-	convert?: boolean;
-
 	trim?: boolean;
+	/**
+	 * If true, the value will be left trimmed. It's a sanitizer, it will change the value in the original object.
+	 */
 	trimLeft?: boolean;
+	/**
+	 * If true, the value will be right trimmed. It's a sanitizer, it will change the value in the original object.
+	 */
 	trimRight?: boolean;
-
+	/**
+	 * If it's a number, the value will be left padded. It's a sanitizer, it will change the value in the original object.
+	 */
 	padStart?: number;
+	/**
+	 * If it's a number, the value will be right padded. It's a sanitizer, it will change the value in the original object.
+	 */
 	padEnd?: number;
+	/**
+	 * The padding character for the padStart and padEnd.
+	 * @default " "
+	 */
 	padChar?: string;
-
+	/**
+	 * If true, the value will be lower-cased. It's a sanitizer, it will change the value in the original object.
+	 */
 	lowercase?: boolean;
+	/**
+	 * If true, the value will be upper-cased. It's a sanitizer, it will change the value in the original object.
+	 */
 	uppercase?: boolean;
+	/**
+	 * If true, the value will be locale lower-cased. It's a sanitizer, it will change the value in the original object.
+	 */
 	localeLowercase?: boolean;
+	/**
+	 * If true, the value will be locale upper-cased. It's a sanitizer, it will change the value in the original object.
+	 */
 	localeUppercase?: boolean;
+	/**
+	 * if true and the type is not a String, converts with String()
+	 */
+	convert?: boolean;
 }
 
 /**
@@ -505,6 +520,10 @@ export interface RuleTuple<T = any> extends RuleCustom {
 	 * Name of built-in validator
 	 */
 	type: "tuple";
+	/**
+	 * If true, the validator accepts an empty array [].
+	 */
+	empty?: boolean
 	/**
 	 * Validation rules that should be applied to the corresponding element of array
 	 */
@@ -522,7 +541,7 @@ export interface RuleURL extends RuleCustom {
 	type: "url";
 	/**
 	 * If true, the validator accepts an empty string ""
-	 * @default true
+	 * @default false
 	 */
 	empty?: boolean;
 }
@@ -542,6 +561,21 @@ export interface RuleUUID extends RuleCustom {
 	version?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
 }
 
+export interface RuleObjectID extends RuleCustom {
+	/**
+	 * Name of built-in validator
+	 */
+	type: "objectID";
+	/**
+	 * To inject ObjectID dependency
+	 */
+	ObjectID?: any;
+	/**
+	 * Convert HexStringObjectID to ObjectID
+	 */
+	convert?: boolean | "hexString";
+}
+
 /**
  * Validation schema definition for custom inline validator
  * @see https://github.com/icebob/fastest-validator#custom-validator