@regle/rules 1.15.2 → 1.16.0

package/dist/regle-rules.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @regle/rules v1.16.0
+ * (c) 2025 Victor Garcia
+ * @license MIT
+ */
+
 import { CommonAlphaOptions, CommonComparisonOptions, ExtendedRulesDeclarations, FormRuleDeclaration, InlineRuleDeclaration, Maybe, MaybeInput, MaybeReadonly, NonEmptyTuple, RegleRuleDecl, RegleRuleDefinition, RegleRuleDefinitionWithMetadataProcessor, RegleRuleMetadataConsumer, RegleRuleMetadataDefinition, RegleRuleWithParamsDefinition, UnwrapRegleUniversalParams } from "@regle/core";
 import { ComputedRef, MaybeRef, MaybeRefOrGetter, Ref } from "vue";
 import { EmptyObject } from "type-fest";
@@ -27,10 +33,10 @@ import { EmptyObject } from "type-fest";
  *
  * @see {@link https://reglejs.dev/core-concepts/rules/rule-wrappers#withmessage Documentation}
  */
-declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
-declare function withMessage<TValue$1 extends any, TParams$1 extends unknown[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
-declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TReturn$1 extends Promise<infer M> ? M : TReturn$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TReturn$1 extends Promise<infer M> ? M : TReturn$1>;
-declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: (...args: any[]) => RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function withMessage<TValue$1 extends any, TParams$1 extends unknown[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TReturn extends Promise<infer M> ? M : TReturn>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TReturn extends Promise<infer M> ? M : TReturn>;
+declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: (...args: any[]) => RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newMessage: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
 /**
  * The `withTooltip` wrapper allows you to display additional messages for your field that aren't necessarily errors.
  * Tooltips are aggregated and accessible via `$tooltips` property.
@@ -57,9 +63,9 @@ declare function withMessage<TValue$1 extends any, TParams$1 extends any[], TRet
  *
  * @see {@link https://reglejs.dev/core-concepts/rules/rule-wrappers#withtooltip Documentation}
  */
-declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newTooltip: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
-declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newTooltip: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
-declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn$1>, newTooltip: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TReturn$1 extends Promise<infer M> ? M : TReturn$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TReturn$1 extends Promise<infer M> ? M : TReturn$1>;
+declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newTooltip: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, newTooltip: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition>, TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn>, newTooltip: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TReturn extends Promise<infer M> ? M : TReturn>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TReturn extends Promise<infer M> ? M : TReturn>;
 /**
  * `withAsync` works like `withParams`, but is specifically designed for async rules that depend on external values.
  *
@@ -83,7 +89,7 @@ declare function withTooltip<TValue$1 extends any, TParams$1 extends any[], TRet
  *
  * @see {@link https://reglejs.dev/core-concepts/rules/rule-wrappers#withasync Documentation}
  */
-declare function withAsync<TValue$1, TParams$1 extends (Ref<unknown> | (() => unknown))[] = [], TReturn$1 extends Promise<RegleRuleMetadataDefinition> = Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn$1>, depsArray?: [...TParams$1]): RegleRuleDefinition<TValue$1, UnwrapRegleUniversalParams<TParams$1>, true, TMetadata$1>;
+declare function withAsync<TValue$1, TParams$1 extends (Ref<unknown> | (() => unknown))[] = [], TReturn extends Promise<RegleRuleMetadataDefinition> = Promise<RegleRuleMetadataDefinition>, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn>, depsArray?: [...TParams$1]): RegleRuleDefinition<TValue$1, UnwrapRegleUniversalParams<TParams$1>, true, TMetadata$1>;
 declare function withAsync<TValue$1 extends any, TParams$1 extends any[], TMetadata$1 extends RegleRuleMetadataDefinition>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, true, TMetadata$1>, depsArray?: [...TParams$1]): RegleRuleWithParamsDefinition<TValue$1, TParams$1, true, TMetadata$1>;
 /**
  * The `withParams` wrapper allows your rule to depend on external parameters,
@@ -112,8 +118,8 @@ declare function withAsync<TValue$1 extends any, TParams$1 extends any[], TMetad
  *
  * @see {@link https://reglejs.dev/core-concepts/rules/rule-wrappers#withparams Documentation}
  */
-declare function withParams<TValue$1, TParams$1 extends (Ref<unknown> | (() => unknown))[] = [], TReturn$1 extends RegleRuleMetadataDefinition = RegleRuleMetadataDefinition, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn$1> | RegleRuleDefinition<TValue$1, any[], TAsync$1, TMetadata$1>, depsArray: [...TParams$1]): RegleRuleDefinition<TValue$1, UnwrapRegleUniversalParams<TParams$1>, TAsync$1, TMetadata$1>;
-declare function withParams<TValue$1 extends any, TParams$1 extends any[], TReturn$1 extends RegleRuleMetadataDefinition = RegleRuleMetadataDefinition, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, depsArray: [...TParams$1]): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function withParams<TValue$1, TParams$1 extends (Ref<unknown> | (() => unknown))[] = [], TReturn extends RegleRuleMetadataDefinition = RegleRuleMetadataDefinition, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: InlineRuleDeclaration<TValue$1, TParams$1, TReturn> | RegleRuleDefinition<TValue$1, any[], TAsync$1, TMetadata$1>, depsArray: [...TParams$1]): RegleRuleDefinition<TValue$1, UnwrapRegleUniversalParams<TParams$1>, TAsync$1, TMetadata$1>;
+declare function withParams<TValue$1 extends any, TParams$1 extends any[], TReturn extends RegleRuleMetadataDefinition = RegleRuleMetadataDefinition, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>, depsArray: [...TParams$1]): RegleRuleWithParamsDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
 /**
  * The `applyIf` operator is similar to `requiredIf`, but it can be used with **any rule**.
  * It simplifies conditional rule declarations.
@@ -443,7 +449,7 @@ declare function or<TRules extends [FormRuleDeclaration<any, any>, ...FormRuleDe
  *
  * @see {@link https://reglejs.dev/core-concepts/rules/rules-operators#not Documentation}
  */
-declare function not<TValue$1, TParams$1 extends any[] = [], TReturn$1 extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition> = RegleRuleMetadataDefinition, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn$1 extends Promise<infer M> ? M : TReturn$1), TAsync$1 extends boolean = (TReturn$1 extends Promise<any> ? true : false)>(rule: RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1> | InlineRuleDeclaration<TValue$1, TParams$1, TReturn$1>, message?: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
+declare function not<TValue$1, TParams$1 extends any[] = [], TReturn extends RegleRuleMetadataDefinition | Promise<RegleRuleMetadataDefinition> = RegleRuleMetadataDefinition, TMetadata$1 extends RegleRuleMetadataDefinition = (TReturn extends Promise<infer M> ? M : TReturn), TAsync$1 extends boolean = (TReturn extends Promise<any> ? true : false)>(rule: RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1> | InlineRuleDeclaration<TValue$1, TParams$1, TReturn>, message?: RegleRuleDefinitionWithMetadataProcessor<TValue$1, RegleRuleMetadataConsumer<TValue$1, TParams$1, TMetadata$1>, string | string[]>): RegleRuleDefinition<TValue$1, TParams$1, TAsync$1, TMetadata$1>;
 /**
  * The `assignIf` is a shorthand for conditional destructuring assignment.
  * It allows applying **multiple rules** to a field conditionally.
@@ -471,6 +477,7 @@ declare function assignIf<TValue$1 extends unknown = any, TCustomRules extends P
  * Allows only alphabetic characters.
  *
  * @param options - Optional configuration for alpha validation
+ * @param options.allowSymbols - Optional flag to allow symbols (_) in the alpha string
  *
  * @example
  * ```ts
@@ -492,6 +499,7 @@ declare const alpha: RegleRuleWithParamsDefinition<string, [options?: CommonAlph
  * Allows only alphanumeric characters.
  *
  * @param options - Optional configuration for alphanumeric validation
+ * @param options.allowSymbols - Optional flag to allow symbols (_) in the alphanumeric string
  *
  * @example
  * ```ts
@@ -515,6 +523,7 @@ declare const alphaNum: RegleRuleWithParamsDefinition<string | number, [options?
  * @param min - The minimum limit
  * @param max - The maximum limit
  * @param options - Optional configuration (e.g., `{ allowEqual: false }` for exclusive bounds)
+ * @param options.allowEqual - Optional flag to allow equal bounds
  *
  * @example
  * ```ts
@@ -615,6 +624,7 @@ declare const date: RegleRuleDefinition<unknown, [], false, boolean, MaybeInput<
  *
  * @param after - The date to compare to (can be a `Date`, string, ref, or getter)
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal dates
  *
  * @example
  * ```ts
@@ -643,6 +653,7 @@ declare const dateAfter: RegleRuleWithParamsDefinition<string | Date, [after: Ma
  *
  * @param before - The date to compare to (can be a `Date`, string, ref, or getter)
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal dates
  *
  * @example
  * ```ts
@@ -672,6 +683,7 @@ declare const dateBefore: RegleRuleWithParamsDefinition<string | Date, [before:
  * @param before - The minimum date limit
  * @param after - The maximum date limit
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal dates
  *
  * @example
  * ```ts
@@ -719,6 +731,21 @@ declare const decimal: RegleRuleDefinition<string | number, [], false, boolean,
  * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#email Documentation}
  */
 declare const email: RegleRuleDefinition<string, [], false, boolean, MaybeInput<string>>;
+/**
+ * Validates if the value is a valid emoji.
+ *
+ * @example
+ * ```ts
+ * import { emoji } from '@regle/rules';
+ *
+ * const { r$ } = useRegle({ emoji: '' }, {
+ *   emoji: { emoji },
+ * })
+ * ```
+ *
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#emoji Documentation}
+ */
+declare const emoji: RegleRuleDefinition<string, [], false, boolean, unknown, string>;
 /**
  * Checks if the string ends with the specified substring.
  *
@@ -736,6 +763,31 @@ declare const email: RegleRuleDefinition<string, [], false, boolean, MaybeInput<
  * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#endswith Documentation}
  */
 declare const endsWith: RegleRuleWithParamsDefinition<string, [part: MaybeInput<string>], false, boolean, MaybeInput<string>>;
+/**
+ * Requires the input value to have a strict specified length. Works with arrays, objects and strings.
+ *
+ * @param count - The exact required length
+ *
+ * @example
+ * ```ts
+ * import { exactDigits } from '@regle/rules';
+ *
+ * const exactValue = ref(6);
+ *
+ * const { r$ } = useRegle({ digits: '' }, {
+ *   digits: {
+ *     exactDigits: exactDigits(6),
+ *     // or with reactive value
+ *     exactDigits: exactDigits(exactValue),
+ *     // or with getter
+ *     exactDigits: exactDigits(() => exactValue.value)
+ *   },
+ * })
+ * ```
+ *
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#exactdigits Documentation}
+ */
+declare const exactDigits: RegleRuleWithParamsDefinition<string | number, [count: number], false, boolean>;
 /**
  * Requires the input value to have a strict specified length. Works with arrays, objects and strings.
  *
@@ -809,6 +861,8 @@ declare const file: RegleRuleDefinition<unknown, [], false, boolean, MaybeInput<
 /**
  * Requires a value to be a file with a specific type.
  *
+ * @param accept - The allowed file types
+ *
  * @example
  * ```ts
  * import { type InferInput } from '@regle/core';
@@ -838,6 +892,64 @@ declare const fileType: RegleRuleWithParamsDefinition<File, [accept: readonly st
  * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#hexadecimal Documentation}
  */
 declare const hexadecimal: RegleRuleDefinition<string, [], false, boolean, MaybeInput<string>>;
+/**
+ * Validates hostnames.
+ *
+ * @example
+ * ```ts
+ * import { hostname } from '@regle/rules';
+ *
+ * const { r$ } = useRegle({ siteHost: '' }, {
+ *   siteHost: { hostname },
+ * })
+ * ```
+ *
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#hostname Documentation}
+ */
+declare const hostname: RegleRuleDefinition<string, [], false, boolean, unknown, string>;
+interface UrlOptions {
+  protocol?: RegExp;
+}
+/**
+ * Validates URLs.
+ *
+ * @param options - Optional configuration for url validation
+ * @param options.protocol - Optional regex for validating the protocol
+ *
+ * @example
+ * ```ts
+ * import { url } from '@regle/rules';
+ *
+ * const { r$ } = useRegle({ bestUrl: '' }, {
+ *   bestUrl: { url },
+ *   // or with custom protocol validation
+ *   bestUrl: { url: url({ protocol: /^https?$/ }) },
+ * })
+ * ```
+ *
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#url Documentation}
+ */
+declare const url: RegleRuleWithParamsDefinition<string, [options?: UrlOptions | undefined], false, boolean, unknown, string>;
+/**
+ * Validates HTTP URLs.
+ *
+ * @param options - Optional configuration for http url validation
+ * @param options.protocol - Optional regex for validating the protocol
+ *
+ * @example
+ * ```ts
+ * import { httpUrl } from '@regle/rules';
+ *
+ * const { r$ } = useRegle({ bestUrl: '' }, {
+ *   bestUrl: { httpUrl },
+ *   // or to force https protocol
+ *   bestUrl: { httpUrl: httpUrl({ protocol: /^https$/ }) },
+ * })
+ * ```
+ *
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#httpurl Documentation}
+ */
+declare const httpUrl: RegleRuleWithParamsDefinition<string, [options?: UrlOptions | undefined], false, boolean, unknown, string>;
 /**
  * Allows only integers (positive and negative).
  *
@@ -885,6 +997,21 @@ declare const ipv4Address: RegleRuleDefinition<string, [], false, boolean, Maybe
  * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#literal Documentation}
  */
 declare function literal<const TValue$1 extends string | number>(literal: MaybeRefOrGetter<TValue$1>): RegleRuleDefinition<TValue$1, [literal: TValue$1], false, boolean, MaybeInput<TValue$1>, string | number>;
+/**
+ * Validates lowercase strings.
+ *
+ * @example
+ * ```ts
+ * import { lowercase } from '@regle/rules';
+ *
+ * const { r$ } = useRegle({ name: '' }, {
+ *   name: { lowercase },
+ * })
+ * ```
+ *
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#lowercase Documentation}
+ */
+declare const lowercase: RegleRuleDefinition<string, [], false, boolean, unknown, string>;
 /**
  * Validates MAC addresses. Call as a function to specify a custom separator (e.g., `':'` or an empty string for `00ff1122334455`).
  *
@@ -909,6 +1036,8 @@ declare const macAddress: RegleRuleWithParamsDefinition<string, [separator?: str
 /**
  * Requires a value to be a file with a maximum size.
  *
+ * @param maxSize - The maximum size of the file
+ *
  * @example
  * ```ts
  * import { type InferInput } from '@regle/core';
@@ -931,6 +1060,7 @@ declare const maxFileSize: RegleRuleWithParamsDefinition<File, [maxSize: number]
  *
  * @param max - The maximum length
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal length
  *
  * @example
  * ```ts
@@ -957,6 +1087,7 @@ declare const maxLength: RegleRuleWithParamsDefinition<string | any[] | Record<P
  *
  * @param max - The maximum value
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal value
  *
  * @example
  * ```ts
@@ -981,6 +1112,8 @@ declare const maxValue: RegleRuleWithParamsDefinition<number | string, [max: num
 /**
  * Requires a value to be a file with a minimum size.
  *
+ * @param minSize - The minimum size of the file
+ *
  * @example
  * ```ts
  * import { type InferInput } from '@regle/core';
@@ -1003,6 +1136,7 @@ declare const minFileSize: RegleRuleWithParamsDefinition<File, [minSize: number]
  *
  * @param min - The minimum length
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal length
  *
  * @example
  * ```ts
@@ -1029,6 +1163,7 @@ declare const minLength: RegleRuleWithParamsDefinition<string | any[] | Record<P
  *
  * @param min - The minimum value
  * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+ * @param options.allowEqual - Optional flag to allow equal value
  *
  * @example
  * ```ts
@@ -1309,18 +1444,18 @@ declare const string: RegleRuleDefinition<unknown, [], false, boolean, MaybeInpu
  */
 declare function type<T>(): RegleRuleDefinition<unknown, [], false, boolean, MaybeInput<T>>;
 /**
- * Validates URLs.
+ * Validates uppercase strings.
  *
  * @example
  * ```ts
- * import { url } from '@regle/rules';
+ * import { uppercase } from '@regle/rules';
  *
- * const { r$ } = useRegle({ bestUrl: '' }, {
- *   bestUrl: { url },
+ * const { r$ } = useRegle({ name: '' }, {
+ *   name: { uppercase },
  * })
  * ```
  *
- * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#url Documentation}
+ * @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#uppercase Documentation}
  */
-declare const url: RegleRuleDefinition<string, [], false, boolean, MaybeInput<string>>;
-export { EnumLike, alpha, alphaNum, and, applyIf, assignIf, between, boolean, checked, contains, date, dateAfter, dateBefore, dateBetween, decimal, email, endsWith, exactLength, exactValue, file, fileType, getSize, hexadecimal, integer, ipv4Address, isDate, isEmpty, isFilled, isNumber, literal, macAddress, matchRegex, maxFileSize, maxLength, maxValue, minFileSize, minLength, minValue, nativeEnum, not, number, numeric, oneOf, or, regex, required, requiredIf, requiredUnless, sameAs, startsWith, string, toDate, toNumber, type, url, withAsync, withMessage, withParams, withTooltip };
+declare const uppercase: RegleRuleDefinition<string, [], false, boolean, unknown, string>;
+export { EnumLike, UrlOptions, alpha, alphaNum, and, applyIf, assignIf, between, boolean, checked, contains, date, dateAfter, dateBefore, dateBetween, decimal, email, emoji, endsWith, exactDigits, exactLength, exactValue, file, fileType, getSize, hexadecimal, hostname, httpUrl, integer, ipv4Address, isDate, isEmpty, isFilled, isNumber, literal, lowercase, macAddress, matchRegex, maxFileSize, maxLength, maxValue, minFileSize, minLength, minValue, nativeEnum, not, number, numeric, oneOf, or, regex, required, requiredIf, requiredUnless, sameAs, startsWith, string, toDate, toNumber, type, uppercase, url, withAsync, withMessage, withParams, withTooltip };

package/dist/regle-rules.js

@@ -1,3 +1,9 @@
+/**
+ * @regle/rules v1.16.0
+ * (c) 2025 Victor Garcia
+ * @license MIT
+ */
+
 import { InternalRuleType, createRule, unwrapRuleParameters } from "@regle/core";
 import { computed, toValue, unref } from "vue";
 
@@ -246,18 +252,14 @@ function isObject(obj) {
 */
 function isDate(value) {
 	if (isEmpty(value)) return false;
-	try {
-		let possibleDate = null;
-		if (value instanceof Date) possibleDate = value;
-		else if (typeof value === "string") {
-			const date$1 = new Date(value);
-			if (date$1.toString() === "Invalid Date") return false;
-			possibleDate = date$1;
-		}
-		return !!possibleDate;
-	} catch {
-		return false;
+	let possibleDate = null;
+	if (value instanceof Date) possibleDate = value;
+	else if (typeof value === "string") {
+		const date$1 = new Date(value);
+		if (date$1.toString() === "Invalid Date") return false;
+		possibleDate = date$1;
 	}
+	return !!possibleDate;
 }
 
 /**
@@ -736,12 +738,47 @@ function assignIf(_condition, rules, otherwiseRules) {
 	});
 }
 
-const alphaRegex = /^[a-zA-Z]*$/;
-const alphaSymbolRegex = /^[\w.]+$/;
+/** Regex for validating url protocols */
+const DEFAULT_PROTOCOL_REGEX = /^https?$/;
+/** Regex for validating url hostnames */
+const HOSTNAME_REGEX = /^(?=.{1,253}\.?$)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[-0-9a-zA-Z]{0,61}[0-9a-zA-Z])?)*\.?$/;
+/**
+* Regex taken from {@link https://gist.github.com/dperini/729294}
+*/
+const URL_REGEX = /^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+(?:[a-z\u00a1-\uffff]{2,}\.?))(?::\d{2,5})?(?:[/?#]\S*)?$/i;
+/** Regex for validating emoji */
+const _EMOJI_REGEX = `^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$`;
+function EMOJI_REGEX() {
+	return new RegExp(_EMOJI_REGEX, "u");
+}
+/** Regex for validating lowercase strings */
+const LOWERCASE_REGEX = /^[^A-Z]*$/;
+/** Regex for validating uppercase strings */
+const UPPERCASE_REGEX = /^[^a-z]*$/;
+/** Regex for validating hexadecimal strings */
+const HEX_REGEX = /^[0-9a-fA-F]*$/;
+/** Regex for validating alpha strings */
+const ALPHA_REGEX = /^[a-zA-Z]*$/;
+/** Regex for validating alpha-symbol strings */
+const ALPHA_SYMBOL_REGEX = /^[\w.]+$/;
+/** Regex for validating alpha-numeric strings */
+const ALPHA_NUM_REGEX = /^[a-zA-Z0-9]*$/;
+/** Regex for validating alpha-numeric-symbol strings */
+const ALPHA_NUM_SYMBOL_REGEX = /^[a-zA-Z0-9_]*$/;
+/** Regex for validating decimal strings */
+const DECIMAL_REGEX = /^[-]?\d*(\.\d+)?$/;
+/** Regex for validating email addresses */
+const EMAIL_REGEX = /^(?:[A-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9]{2,}(?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/i;
+/** Regex for validating integer strings */
+const INTEGER_REGEX = /(^[0-9]*$)|(^-[0-9]+$)/;
+/** Regex for validating numeric strings */
+const NUMERIC_REGEX = /^\d*(\.\d+)?$/;
+
 /**
 * Allows only alphabetic characters.
 *
 * @param options - Optional configuration for alpha validation
+* @param options.allowSymbols - Optional flag to allow symbols (_) in the alpha string
 *
 * @example
 * ```ts
@@ -762,18 +799,17 @@ const alpha = createRule({
 	type: "alpha",
 	validator(value, options) {
 		if (isEmpty(value)) return true;
-		if (options?.allowSymbols) return matchRegex(value, alphaSymbolRegex);
-		return matchRegex(value, alphaRegex);
+		if (options?.allowSymbols) return matchRegex(value, ALPHA_SYMBOL_REGEX);
+		return matchRegex(value, ALPHA_REGEX);
 	},
 	message: "The value is not alphabetical"
 });
 
-const alphaNumRegex = /^[a-zA-Z0-9]*$/;
-const alphaNumSymbolRegex = /^[a-zA-Z0-9_]*$/;
 /**
 * Allows only alphanumeric characters.
 *
 * @param options - Optional configuration for alphanumeric validation
+* @param options.allowSymbols - Optional flag to allow symbols (_) in the alphanumeric string
 *
 * @example
 * ```ts
@@ -794,8 +830,8 @@ const alphaNum = createRule({
 	type: "alphaNum",
 	validator(value, options) {
 		if (isEmpty(value)) return true;
-		if (options?.allowSymbols) return matchRegex(value, alphaNumSymbolRegex);
-		return matchRegex(value, alphaNumRegex);
+		if (options?.allowSymbols) return matchRegex(value, ALPHA_NUM_SYMBOL_REGEX);
+		return matchRegex(value, ALPHA_NUM_REGEX);
 	},
 	message: "The value must be alpha-numeric"
 });
@@ -806,6 +842,7 @@ const alphaNum = createRule({
 * @param min - The minimum limit
 * @param max - The maximum limit
 * @param options - Optional configuration (e.g., `{ allowEqual: false }` for exclusive bounds)
+* @param options.allowEqual - Optional flag to allow equal bounds
 *
 * @example
 * ```ts
@@ -968,6 +1005,7 @@ function formatLocaleDate(date$1) {
 *
 * @param after - The date to compare to (can be a `Date`, string, ref, or getter)
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal dates
 *
 * @example
 * ```ts
@@ -1014,6 +1052,7 @@ const dateAfter = createRule({
 *
 * @param before - The date to compare to (can be a `Date`, string, ref, or getter)
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal dates
 *
 * @example
 * ```ts
@@ -1061,6 +1100,7 @@ const dateBefore = createRule({
 * @param before - The minimum date limit
 * @param after - The maximum date limit
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal dates
 *
 * @example
 * ```ts
@@ -1090,7 +1130,6 @@ const dateBetween = createRule({
 	}
 });
 
-const decimalRegex = /^[-]?\d*(\.\d+)?$/;
 /**
 * Allows positive and negative decimal numbers.
 *
@@ -1109,12 +1148,11 @@ const decimal = createRule({
 	type: "decimal",
 	validator(value) {
 		if (isEmpty(value)) return true;
-		return matchRegex(value, decimalRegex);
+		return matchRegex(value, DECIMAL_REGEX);
 	},
 	message: "The value must be decimal"
 });
 
-const emailRegex = /^(?:[A-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9]{2,}(?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/i;
 /**
 * Validates email addresses. Always verify on the server to ensure the address is real and not already in use.
 *
@@ -1133,11 +1171,34 @@ const email = createRule({
 	type: "email",
 	validator(value) {
 		if (isEmpty(value)) return true;
-		return matchRegex(value, emailRegex);
+		return matchRegex(value, EMAIL_REGEX);
 	},
 	message: "The value must be an valid email address"
 });
 
+/**
+* Validates if the value is a valid emoji.
+*
+* @example
+* ```ts
+* import { emoji } from '@regle/rules';
+*
+* const { r$ } = useRegle({ emoji: '' }, {
+*   emoji: { emoji },
+* })
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#emoji Documentation}
+*/
+const emoji = createRule({
+	type: "emoji",
+	validator(value) {
+		if (isEmpty(value)) return true;
+		return EMOJI_REGEX().test(value);
+	},
+	message: "The value should be a valid emoji"
+});
+
 /**
 * Checks if the string ends with the specified substring.
 *
@@ -1165,6 +1226,48 @@ const endsWith = createRule({
 	}
 });
 
+/**
+* Requires the input value to have a strict specified length. Works with arrays, objects and strings.
+*
+* @param count - The exact required length
+*
+* @example
+* ```ts
+* import { exactDigits } from '@regle/rules';
+*
+* const exactValue = ref(6);
+*
+* const { r$ } = useRegle({ digits: '' }, {
+*   digits: {
+*     exactDigits: exactDigits(6),
+*     // or with reactive value
+*     exactDigits: exactDigits(exactValue),
+*     // or with getter
+*     exactDigits: exactDigits(() => exactValue.value)
+*   },
+* })
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#exactdigits Documentation}
+*/
+const exactDigits = createRule({
+	type: "exactDigits",
+	validator: (value, count) => {
+		if (isFilled(value, false) && isFilled(count)) {
+			if (isNumber(count)) {
+				const digitsRegex = /* @__PURE__ */ new RegExp(`^\\d{${count}}$`);
+				return matchRegex(value.toString(), digitsRegex);
+			}
+			console.warn(`[exactDigits] Parameter isn't a number, got parameter: ${count}`);
+			return false;
+		}
+		return true;
+	},
+	message: ({ $params: [count] }) => {
+		return `The value should have exactly ${count} digits`;
+	}
+});
+
 /**
 * Requires the input value to have a strict specified length. Works with arrays, objects and strings.
 *
@@ -1194,7 +1297,7 @@ const exactLength = createRule({
 	validator: (value, count) => {
 		if (isFilled(value, false) && isFilled(count)) {
 			if (isNumber(count)) return getSize(value) === count;
-			console.warn(`[minLength] Parameter isn't a number, got parameter: ${count}`);
+			console.warn(`[exactLength] Parameter isn't a number, got parameter: ${count}`);
 			return false;
 		}
 		return true;
@@ -1274,6 +1377,8 @@ const file = createRule({
 /**
 * Requires a value to be a file with a specific type.
 *
+* @param accept - The allowed file types
+*
 * @example
 * ```ts
 * import { type InferInput } from '@regle/core';
@@ -1301,7 +1406,6 @@ const fileType = createRule({
 	}
 });
 
-const hexadecimalRegex = /^[a-fA-F0-9]*$/;
 /**
 * Validates hexadecimal values.
 *
@@ -1320,12 +1424,101 @@ const hexadecimal = createRule({
 	type: "hexadecimal",
 	validator(value) {
 		if (isEmpty(value)) return true;
-		return matchRegex(value, hexadecimalRegex);
+		return matchRegex(value, HEX_REGEX);
 	},
 	message: "The value must be hexadecimal"
 });
 
-const integerRegex = /(^[0-9]*$)|(^-[0-9]+$)/;
+/**
+* Validates hostnames.
+*
+* @example
+* ```ts
+* import { hostname } from '@regle/rules';
+*
+* const { r$ } = useRegle({ siteHost: '' }, {
+*   siteHost: { hostname },
+* })
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#hostname Documentation}
+*/
+const hostname = createRule({
+	type: "hostname",
+	validator(value) {
+		if (isEmpty(value)) return true;
+		return matchRegex(value, HOSTNAME_REGEX);
+	},
+	message: "The value is not a valid hostname"
+});
+
+/**
+* Validates URLs.
+*
+* @param options - Optional configuration for url validation
+* @param options.protocol - Optional regex for validating the protocol
+*
+* @example
+* ```ts
+* import { url } from '@regle/rules';
+*
+* const { r$ } = useRegle({ bestUrl: '' }, {
+*   bestUrl: { url },
+*   // or with custom protocol validation
+*   bestUrl: { url: url({ protocol: /^https?$/ }) },
+* })
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#url Documentation}
+*/
+const url = createRule({
+	type: "url",
+	validator(value, options = {}) {
+		try {
+			if (isEmpty(value)) return true;
+			const { protocol } = options || {};
+			const urlInput = new URL(value);
+			if (!HOSTNAME_REGEX.test(urlInput.hostname)) return false;
+			if (protocol) {
+				if (!protocol.test(urlInput.protocol.endsWith(":") ? urlInput.protocol.slice(0, -1) : urlInput.protocol)) return false;
+			}
+			return matchRegex(value, URL_REGEX);
+		} catch {
+			return false;
+		}
+	},
+	message: "The value is not a valid URL address"
+});
+
+/**
+* Validates HTTP URLs.
+*
+* @param options - Optional configuration for http url validation
+* @param options.protocol - Optional regex for validating the protocol
+*
+* @example
+* ```ts
+* import { httpUrl } from '@regle/rules';
+*
+* const { r$ } = useRegle({ bestUrl: '' }, {
+*   bestUrl: { httpUrl },
+*   // or to force https protocol
+*   bestUrl: { httpUrl: httpUrl({ protocol: /^https$/ }) },
+* })
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#httpurl Documentation}
+*/
+const httpUrl = createRule({
+	type: "httpUrl",
+	validator(value, options = {}) {
+		if (isEmpty(value)) return true;
+		const { protocol = DEFAULT_PROTOCOL_REGEX } = options || {};
+		return url({ protocol }).exec(value);
+	},
+	message: "The value is not a valid http URL address"
+});
+
 /**
 * Allows only integers (positive and negative).
 *
@@ -1344,7 +1537,7 @@ const integer = createRule({
 	type: "integer",
 	validator(value) {
 		if (isEmpty(value)) return true;
-		return matchRegex(value, integerRegex);
+		return matchRegex(value, INTEGER_REGEX);
 	},
 	message: "The value must be an integer"
 });
@@ -1404,6 +1597,29 @@ function literal(literal$1) {
 	}, [computed(() => toValue(literal$1))]), ({ $params: [literal$2] }) => `Value should be ${literal$2}.`);
 }
 
+/**
+* Validates lowercase strings.
+*
+* @example
+* ```ts
+* import { lowercase } from '@regle/rules';
+*
+* const { r$ } = useRegle({ name: '' }, {
+*   name: { lowercase },
+* })
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#lowercase Documentation}
+*/
+const lowercase = createRule({
+	type: "lowercase",
+	validator(value) {
+		if (isEmpty(value)) return true;
+		return matchRegex(value, LOWERCASE_REGEX);
+	},
+	message: "The value is not a valid lowercase string"
+});
+
 /**
 * Validates MAC addresses. Call as a function to specify a custom separator (e.g., `':'` or an empty string for `00ff1122334455`).
 *
@@ -1439,6 +1655,8 @@ const hexValid = (hex) => hex.toLowerCase().match(/^[0-9a-f]{2}$/);
 /**
 * Requires a value to be a file with a maximum size.
 *
+* @param maxSize - The maximum size of the file
+*
 * @example
 * ```ts
 * import { type InferInput } from '@regle/core';
@@ -1474,6 +1692,7 @@ const maxFileSize = createRule({
 *
 * @param max - The maximum length
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal length
 *
 * @example
 * ```ts
@@ -1517,6 +1736,7 @@ const maxLength = createRule({
 *
 * @param max - The maximum value
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal value
 *
 * @example
 * ```ts
@@ -1559,6 +1779,8 @@ const maxValue = createRule({
 /**
 * Requires a value to be a file with a minimum size.
 *
+* @param minSize - The minimum size of the file
+*
 * @example
 * ```ts
 * import { type InferInput } from '@regle/core';
@@ -1594,6 +1816,7 @@ const minFileSize = createRule({
 *
 * @param min - The minimum length
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal length
 *
 * @example
 * ```ts
@@ -1637,6 +1860,7 @@ const minLength = createRule({
 *
 * @param min - The minimum value
 * @param options - Optional configuration (e.g., `{ allowEqual: false }`)
+* @param options.allowEqual - Optional flag to allow equal value
 *
 * @example
 * ```ts
@@ -1737,7 +1961,6 @@ const number = createRule({
 	message: "The value must be a native number"
 });
 
-const numericRegex = /^\d*(\.\d+)?$/;
 /**
 * Allows only numeric values (including numeric strings).
 *
@@ -1756,7 +1979,7 @@ const numeric = createRule({
 	type: "numeric",
 	validator(value) {
 		if (isEmpty(value)) return true;
-		return matchRegex(value, numericRegex);
+		return matchRegex(value, NUMERIC_REGEX);
 	},
 	message: "The value must be numeric"
 });
@@ -2026,30 +2249,26 @@ function type() {
 }
 
 /**
-* Regex taken from {@link https://gist.github.com/dperini/729294}
-*/
-const urlRegex = /^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+(?:[a-z\u00a1-\uffff]{2,}\.?))(?::\d{2,5})?(?:[/?#]\S*)?$/i;
-/**
-* Validates URLs.
+* Validates uppercase strings.
 *
 * @example
 * ```ts
-* import { url } from '@regle/rules';
+* import { uppercase } from '@regle/rules';
 *
-* const { r$ } = useRegle({ bestUrl: '' }, {
-*   bestUrl: { url },
+* const { r$ } = useRegle({ name: '' }, {
+*   name: { uppercase },
 * })
 * ```
 *
-* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#url Documentation}
+* @see {@link https://reglejs.dev/core-concepts/rules/built-in-rules#uppercase Documentation}
 */
-const url = createRule({
-	type: "url",
+const uppercase = createRule({
+	type: "uppercase",
 	validator(value) {
 		if (isEmpty(value)) return true;
-		return matchRegex(value, urlRegex);
+		return matchRegex(value, UPPERCASE_REGEX);
 	},
-	message: "The value is not a valid URL address"
+	message: "The value is not a valid uppercase string"
 });
 
-export { alpha, alphaNum, and, applyIf, assignIf, between, boolean, checked, contains, date, dateAfter, dateBefore, dateBetween, decimal, email, endsWith, exactLength, exactValue, file, fileType, getSize, hexadecimal, integer, ipv4Address, isDate, isEmpty, isFilled, isNumber, literal, macAddress, matchRegex, maxFileSize, maxLength, maxValue, minFileSize, minLength, minValue, nativeEnum, not, number, numeric, oneOf, or, regex, required, requiredIf, requiredUnless, sameAs, startsWith, string, toDate, toNumber, type, url, withAsync, withMessage, withParams, withTooltip };
+export { alpha, alphaNum, and, applyIf, assignIf, between, boolean, checked, contains, date, dateAfter, dateBefore, dateBetween, decimal, email, emoji, endsWith, exactDigits, exactLength, exactValue, file, fileType, getSize, hexadecimal, hostname, httpUrl, integer, ipv4Address, isDate, isEmpty, isFilled, isNumber, literal, lowercase, macAddress, matchRegex, maxFileSize, maxLength, maxValue, minFileSize, minLength, minValue, nativeEnum, not, number, numeric, oneOf, or, regex, required, requiredIf, requiredUnless, sameAs, startsWith, string, toDate, toNumber, type, uppercase, url, withAsync, withMessage, withParams, withTooltip };

package/dist/regle-rules.min.js

@@ -1 +1,7 @@
-import{InternalRuleType as e,createRule as t,unwrapRuleParameters as n}from"@regle/core";import{computed as r,toValue as i,unref as a}from"vue";function o(n,r){let i,a,o,s,c=!1;typeof n==`function`&&!(`_validator`in n)?(i=e.Inline,a=n):{_type:i,validator:a,_active:o,_params:s,_async:c}=n;let l=t({type:i,validator:a,active:o,message:r,async:c}),u=[...s??[]];if(l._params=u,l._message_patched=!0,typeof l==`function`){if(s!=null){let e=l(...u);return e._message_patched=!0,e}return l}else return l}function s(n,r){let i,a,o,s,c,l=!1;typeof n==`function`&&!(`_validator`in n)?(i=e.Inline,a=n):{_type:i,validator:a,_active:o,_params:s,_message:c,_async:l}=n;let u=t({type:i,validator:a,active:o,message:c,tooltip:r,async:l}),d=[...s??[]];if(u._params=d,u._tooltip_patched=!0,typeof u==`function`){let e=u(...d);return u._tooltip_patched=!0,e}else return u}function c(n,r){let i,a,o=[],s=``;typeof n==`function`?(a=async(e,...t)=>n(e,...t),o=[r]):({_type:i,_message:s}=n,o=o=n._params?.concat(r),a=async(...e)=>n.validator(e));let c=t({type:i??e.Async,validator:a,message:s,async:!0});return c._params=c._params?.concat(o),c(...r??[])}function l(n,r){let i,a,o=[],s=``;typeof n==`function`?(e.Inline,a=(e,...t)=>n(e,...t),o=[r]):({_type:i,validator:a,_message:s}=n,o=o=n._params?.concat(r));let c=t({type:e.Inline,validator:a,message:s});return c._params=c._params?.concat(o),c(...r)}function u(r,i){let a,o,s=[],c=``;typeof i==`function`?(a=e.Inline,o=i,s=[r]):({_type:a,validator:o,_message:c}=i,s=i._params?.concat([r]));function l(e,...t){let[i]=n([r]);return i?o(e,...t):!0}function u(){let[e]=n([r]);return e}let d=t({type:a,validator:l,active:u,message:c}),f=[...s??[]];return d._params=f,typeof d==`function`?d(...f):d}function d(e){return e?.constructor?.name==`File`}function f(e,t=!0){return e==null?!0:e instanceof Date?isNaN(e.getTime()):d(e)?e.size<=0:Array.isArray(e)?t?e.length===0:!1:typeof e==`object`&&e?Object.keys(e).length===0:!String(e).length}function p(e){return e&&(e instanceof Date||e.constructor.name==`File`||e.constructor.name==`FileList`)?!1:typeof e==`object`&&!!e&&!Array.isArray(e)}function m(e){if(f(e))return!1;try{let t=null;if(e instanceof Date)t=e;else if(typeof e==`string`){let n=new Date(e);if(n.toString()===`Invalid Date`)return!1;t=n}return!!t}catch{return!1}}function h(e){let t=Object.prototype.toString.call(e);return e==null?new Date(NaN):e instanceof Date||typeof e==`object`&&t===`[object Date]`?new Date(e.getTime()):typeof e==`number`||t===`[object Number]`||typeof e==`string`||t===`[object String]`?new Date(e):new Date(NaN)}function g(e){return e===void 0?`0 bytes`:e<1024?`${e} bytes`:e<1024*1024?`${(e/1024).toFixed(2)} kb`:e<1024*1024*1024?`${(e/1024/1024).toFixed(2)} mb`:`${(e/1024/1024/1024).toFixed(2)} gb`}function _(e,t=!0){return!f(typeof e==`string`?e.trim():e,t)}function v(e){return e==null?!1:typeof e==`number`?!isNaN(e):!1}function y(e,...t){if(f(e))return!0;let n=typeof e==`number`?e.toString():e;return t.every(e=>(e.lastIndex=0,e.test(n)))}function b(e){let t=a(e);return Array.isArray(t)?t.length:typeof t==`object`?Object.keys(t).length:typeof t==`number`?isNaN(t)?0:t:String(t).length}function x(e){return typeof e==`number`?e:e==null?NaN:typeof e==`string`&&e.trim()===e?+e:NaN}function S(...e){let n=e.some(e=>typeof e==`function`?e.constructor.name===`AsyncFunction`:e._async),r=e.map(e=>{if(typeof e==`function`)return null;{let t=e._params;return t?.length?t:[]}}).flat().filter(e=>!!e);function i(e,t,...n){let r=[],i=0;for(let a of e)if(typeof a==`function`)r.push(a(t)),i++;else{let e=a._params?.length??0;r.push(a.validator(t,...n.slice(i,e))),e&&(i+=e)}return r}function a(e){return e?.some(e=>typeof e!=`boolean`)?{$valid:e.every(e=>typeof e==`boolean`?!!e:e.$valid),...e.reduce((e,t)=>{if(typeof t==`boolean`)return e;let{$valid:n,...r}=t;return{...e,...r}},{})}:e.every(e=>!!e)}let o;o=e.length?n?async(t,...n)=>a(await Promise.all(i(e,t,...n))):(t,...n)=>a(i(e,t,...n)):e=>!1;let s=t({type:`and`,validator:o,message:`The value does not match all of the provided validators`}),c=[...r??[]];return s._params=c,typeof s==`function`?s(...c):s}function ee(...e){let n=e.some(e=>typeof e==`function`?e.constructor.name===`AsyncFunction`:e._async),r=e.map(e=>typeof e==`function`?null:e._params).flat().filter(e=>!!e);function i(e,t,...n){let r=[],i=0;for(let a of e)if(typeof a==`function`)r.push(a(t)),i++;else{let e=a._params?.length??0;r.push(a.validator(t,...n.slice(i,e))),e&&(i+=e)}return r}function a(e){return e.some(e=>typeof e!=`boolean`)?{$valid:e.some(e=>typeof e==`boolean`?!!e:e.$valid),...e.reduce((e,t)=>{if(typeof t==`boolean`)return e;let{$valid:n,...r}=t;return{...e,...r}},{})}:e.some(e=>!!e)}let o=t({type:`or`,validator:n?async(t,...n)=>a(await Promise.all(i(e,t,...n))):(t,...n)=>a(i(e,t,...n)),message:`The value does not match any of the provided validators`}),s=[...r??[]];return o._params=s,typeof o==`function`?o(...s):o}function C(e,n){let r,i,a,o,s;typeof e==`function`?(i=e,s=e.constructor.name===`AsyncFunction`):({_type:r,validator:i,_params:o}=e,s=e._async),a=s?async(e,...t)=>_(e)?!await i(e,...t):!0:(e,...t)=>_(e)?!i(e,...t):!0;let c=t({type:`not`,validator:a,message:n??`Error`}),l=[...o??[]];return c._params=l,typeof c==`function`?c(...l):c}function w(e,t,n){return Object.entries(i(t)).map(([t,r])=>typeof r==`function`||p(r)&&`_validator`in r?[t,u(n?e:()=>!i(e),r)]:[t,r])}function T(e,t,n){return r(()=>{let r=w(e,t,!0),i=n?w(e,n,!1):[];return Object.fromEntries([...r,...i])})}const E=/^[a-zA-Z]*$/,D=/^[\w.]+$/,O=t({type:`alpha`,validator(e,t){return f(e)?!0:t?.allowSymbols?y(e,D):y(e,E)},message:`The value is not alphabetical`}),k=/^[a-zA-Z0-9]*$/,A=/^[a-zA-Z0-9_]*$/,j=t({type:`alphaNum`,validator(e,t){return f(e)?!0:t?.allowSymbols?y(e,A):y(e,k)},message:`The value must be alpha-numeric`}),M=t({type:`between`,validator:(e,t,n,r)=>{let{allowEqual:i=!0}=r??{};if(_(e)&&_(t)&&_(n)){let r=x(e),a=x(t),o=x(n);return v(r)&&v(a)&&v(o)?i?r>=a&&r<=o:r>a&&r<o:(console.warn(`[between] Value or parameters aren't numbers, got value: ${e}, min: ${t}, max: ${n}`),!1)}return!0},message:({$params:[e,t]})=>`The value must be between ${e} and ${t}`}),N=t({type:`boolean`,validator:e=>_(e)?typeof e==`boolean`:!0,message:`The value must be a native boolean`}),P=t({type:`checked`,validator:e=>_(e)?e===!0:!0,message:`The field must be checked`}),F=t({type:`contains`,validator(e,t){return _(e)&&_(t)?e.includes(t):!0},message({$params:[e]}){return`The value must contain ${e}`}}),I=t({type:`date`,validator:e=>_(e)?e instanceof Date:!0,message:`The value must be a native Date`});function L(){return navigator.languages==null?navigator.language:navigator.languages[0]}function R(e){return e?new Intl.DateTimeFormat(L(),{dateStyle:`short`}).format(new Date(e)):`?`}const z=t({type:`dateAfter`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return _(e)&&_(t)?m(e)&&m(t)?(r?h(e).getTime()>=h(t).getTime():h(e).getTime()>h(t).getTime())?!0:{$valid:!1,error:`date-not-after`}:{$valid:!1,error:`value-or-parameter-not-a-date`}:!0},message:({$params:[e],error:t})=>t===`value-or-parameter-not-a-date`?`The values must be dates`:`The date must be after ${R(e)}`}),B=t({type:`dateBefore`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return _(e)&&_(t)?m(e)&&m(t)?(r?h(e).getTime()<=h(t).getTime():h(e).getTime()<h(t).getTime())?!0:{$valid:!1,error:`date-not-before`}:{$valid:!1,error:`value-or-parameter-not-a-date`}:!0},message:({$params:[e],error:t})=>t===`value-or-parameter-not-a-date`?`The values must be dates`:`The date must be before ${R(e)}`}),V=t({type:`dateBetween`,validator:(e,t,n,r)=>{let{allowEqual:i=!0}=r??{};return m(e)&&m(t)&&m(n)?i?h(e).getTime()>=h(t).getTime()&&h(e).getTime()<=h(n).getTime():h(e).getTime()>h(t).getTime()&&h(e).getTime()<h(n).getTime():!0},message:({$params:[e,t]})=>`The date must be between ${R(e)} and ${R(t)}`}),H=/^[-]?\d*(\.\d+)?$/,U=t({type:`decimal`,validator(e){return f(e)?!0:y(e,H)},message:`The value must be decimal`}),W=/^(?:[A-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9]{2,}(?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/i,G=t({type:`email`,validator(e){return f(e)?!0:y(e,W)},message:`The value must be an valid email address`}),K=t({type:`endsWith`,validator(e,t){return _(e)&&_(t)?e.endsWith(t):!0},message({$params:[e]}){return`The value must end with ${e}`}}),q=t({type:`exactLength`,validator:(e,t)=>_(e,!1)&&_(t)?v(t)?b(e)===t:(console.warn(`[minLength] Parameter isn't a number, got parameter: ${t}`),!1):!0,message:({$params:[e]})=>`The value should be exactly ${e} characters long`}),J=t({type:`exactValue`,validator:(e,t)=>_(e)&&_(t)?v(t)&&!isNaN(x(e))?x(e)===t:(console.warn(`[exactValue] Value or parameter isn't a number, got value: ${e}, parameter: ${t}`),!0):!0,message:({$params:[e]})=>`The value must be equal to ${e}`}),Y=t({type:`file`,validator:e=>_(e)?d(e):!0,message:`The value must be a native File`}),X=t({type:`fileType`,validator:(e,t)=>_(e)?d(e)?t.includes(e.type):!1:!0,message({$params:[e]}){return`File type is not allowed. Allowed types are: ${e.map(e=>e.split(`/`)[1]).join(`, `)}.`}}),te=/^[a-fA-F0-9]*$/,Z=t({type:`hexadecimal`,validator(e){return f(e)?!0:y(e,te)},message:`The value must be hexadecimal`}),Q=/(^[0-9]*$)|(^-[0-9]+$)/,ne=t({type:`integer`,validator(e){return f(e)?!0:y(e,Q)},message:`The value must be an integer`});function re(e){if(e.length>3||e.length===0||e[0]===`0`&&e!==`0`||!e.match(/^\d+$/))return!1;let t=e|0;return t>=0&&t<=255}const ie=t({type:`ipv4Address`,validator(e){if(f(e))return!0;if(typeof e!=`string`)return!1;let t=e.split(`.`);return t.length===4&&t.every(re)},message:`The value is not a valid IPv4 address`});function ae(e){return o(l((e,t)=>_(e)&&_(t)?t===e:!0,[r(()=>i(e))]),({$params:[e]})=>`Value should be ${e}.`)}const oe=t({type:`macAddress`,validator(e,t=`:`){if(f(e))return!0;if(typeof e!=`string`)return!1;let n=typeof t==`string`&&t!==``?e.split(t):e.length===12||e.length===16?e.match(/.{2}/g):null;return n!==null&&(n.length===6||n.length===8)&&n.every(se)},message:`The value is not a valid MAC Address`}),se=e=>e.toLowerCase().match(/^[0-9a-f]{2}$/),ce=t({type:`maxFileSize`,validator:(e,t)=>_(e)&&d(e)?{$valid:e.size<=t,fileSize:e.size}:!0,message({$params:[e],fileSize:t}){return`File size (${g(t)}) cannot exceed ${g(e)}`}}),le=t({type:`maxLength`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return _(e,!1)&&_(t)?v(t)?r?b(e)<=t:b(e)<t:(console.warn(`[maxLength] Value or parameter isn't a number, got value: ${e}, parameter: ${t}`),!1):!0},message:({$value:e,$params:[t]})=>Array.isArray(e)?`This list should have maximum ${t} items`:`The value length should not exceed ${t}`}),ue=t({type:`maxValue`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return _(e)&&_(t)?!isNaN(x(e))&&!isNaN(x(t))?r?x(e)<=x(t):x(e)<x(t):(console.warn(`[maxValue] Value or parameter isn't a number, got value: ${e}, parameter: ${t}`),!1):!0},message:({$params:[e,t]})=>{let{allowEqual:n=!0}=t??{};return n?`The value must be less than or equal to ${e}`:`The value must be less than ${e}`}}),de=t({type:`minFileSize`,validator:(e,t)=>_(e)&&d(e)?{$valid:e.size>=t,fileSize:e.size}:!0,message({$params:[e],fileSize:t}){return`File size (${g(t)}) must be at least ${g(e)}`}}),fe=t({type:`minLength`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return _(e,!1)&&_(t)?v(t)?r?b(e)>=t:b(e)>t:(console.warn(`[minLength] Parameter isn't a number, got parameter: ${t}`),!1):!0},message:({$value:e,$params:[t]})=>Array.isArray(e)?`The list should have at least ${t} items`:`The value length should be at least ${t}`}),pe=t({type:`minValue`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return _(e)&&_(t)?!isNaN(x(e))&&!isNaN(x(t))?r?x(e)>=x(t):x(e)>x(t):(console.warn(`[minValue] Value or parameter isn't a number, got value: ${e}, parameter: ${t}`),!1):!0},message:({$params:[e,t]})=>{let{allowEqual:n=!0}=t??{};return n?`The value must be greater than or equal to ${e}`:`The value must be greater than ${e}`}});function me(e){let t=Object.keys(e).filter(t=>typeof e[e[t]]!=`number`),n={};for(let r of t)n[r]=e[r];return Object.values(n)}function he(e){return o(l((e,t)=>_(e)&&!f(t)?me(t).includes(e):!0,[r(()=>i(e))]),({$params:[e]})=>`The value should be one of those options: ${Object.values(e).join(`, `)}.`)}const ge=t({type:`number`,validator:e=>_(e)?v(e):!0,message:`The value must be a native number`}),_e=/^\d*(\.\d+)?$/,ve=t({type:`numeric`,validator(e){return f(e)?!0:y(e,_e)},message:`The value must be numeric`}),ye=t({type:`oneOf`,validator(e,t){return _(e)&&_(t,!1)?t.includes(e):!0},message:({$params:[e]})=>`The value should be one of those options: ${e.join(`, `)}.`}),be=t({type:`regex`,validator(e,t){return _(e)?y(e,...Array.isArray(t)?t:[t]):!0},message:`The value does not match the required pattern`}),$=t({type:`required`,validator:e=>_(e),message:`This field is required`}),xe=t({type:`required`,validator(e,t){return t?_(e):!0},message:`This field is required`,active({$params:[e]}){return e}}),Se=t({type:`required`,validator(e,t){return t?!0:_(e)},message:`This field is required`,active({$params:[e]}){return!e}}),Ce=t({type:`sameAs`,validator(e,t,n){return f(e)?!0:e===t},message({$params:[e,t=`other`]}){return`The value must be equal to the ${t} value`}}),we=t({type:`startsWith`,validator(e,t){return _(e)&&_(t)?e.startsWith(t):!0},message({$params:[e]}){return`The value must start with ${e}`}}),Te=t({type:`string`,validator:e=>_(e)?typeof e==`string`:!0,message:`The value must be a string`});function Ee(){return(()=>!0)}const De=/^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+(?:[a-z\u00a1-\uffff]{2,}\.?))(?::\d{2,5})?(?:[/?#]\S*)?$/i,Oe=t({type:`url`,validator(e){return f(e)?!0:y(e,De)},message:`The value is not a valid URL address`});export{O as alpha,j as alphaNum,S as and,u as applyIf,T as assignIf,M as between,N as boolean,P as checked,F as contains,I as date,z as dateAfter,B as dateBefore,V as dateBetween,U as decimal,G as email,K as endsWith,q as exactLength,J as exactValue,Y as file,X as fileType,b as getSize,Z as hexadecimal,ne as integer,ie as ipv4Address,m as isDate,f as isEmpty,_ as isFilled,v as isNumber,ae as literal,oe as macAddress,y as matchRegex,ce as maxFileSize,le as maxLength,ue as maxValue,de as minFileSize,fe as minLength,pe as minValue,he as nativeEnum,C as not,ge as number,ve as numeric,ye as oneOf,ee as or,be as regex,$ as required,xe as requiredIf,Se as requiredUnless,Ce as sameAs,we as startsWith,Te as string,h as toDate,x as toNumber,Ee as type,Oe as url,c as withAsync,o as withMessage,l as withParams,s as withTooltip};
+/**
+ * @regle/rules v1.16.0
+ * (c) 2025 Victor Garcia
+ * @license MIT
+ */
+
+import{InternalRuleType as e,createRule as t,unwrapRuleParameters as n}from"@regle/core";import{computed as r,toValue as i,unref as a}from"vue";function o(n,r){let i,a,o,s,c=!1;typeof n==`function`&&!(`_validator`in n)?(i=e.Inline,a=n):{_type:i,validator:a,_active:o,_params:s,_async:c}=n;let l=t({type:i,validator:a,active:o,message:r,async:c}),u=[...s??[]];if(l._params=u,l._message_patched=!0,typeof l==`function`){if(s!=null){let e=l(...u);return e._message_patched=!0,e}return l}else return l}function s(n,r){let i,a,o,s,c,l=!1;typeof n==`function`&&!(`_validator`in n)?(i=e.Inline,a=n):{_type:i,validator:a,_active:o,_params:s,_message:c,_async:l}=n;let u=t({type:i,validator:a,active:o,message:c,tooltip:r,async:l}),d=[...s??[]];if(u._params=d,u._tooltip_patched=!0,typeof u==`function`){let e=u(...d);return u._tooltip_patched=!0,e}else return u}function c(n,r){let i,a,o=[],s=``;typeof n==`function`?(a=async(e,...t)=>n(e,...t),o=[r]):({_type:i,_message:s}=n,o=o=n._params?.concat(r),a=async(...e)=>n.validator(e));let c=t({type:i??e.Async,validator:a,message:s,async:!0});return c._params=c._params?.concat(o),c(...r??[])}function l(n,r){let i,a,o=[],s=``;typeof n==`function`?(e.Inline,a=(e,...t)=>n(e,...t),o=[r]):({_type:i,validator:a,_message:s}=n,o=o=n._params?.concat(r));let c=t({type:e.Inline,validator:a,message:s});return c._params=c._params?.concat(o),c(...r)}function u(r,i){let a,o,s=[],c=``;typeof i==`function`?(a=e.Inline,o=i,s=[r]):({_type:a,validator:o,_message:c}=i,s=i._params?.concat([r]));function l(e,...t){let[i]=n([r]);return i?o(e,...t):!0}function u(){let[e]=n([r]);return e}let d=t({type:a,validator:l,active:u,message:c}),f=[...s??[]];return d._params=f,typeof d==`function`?d(...f):d}function d(e){return e?.constructor?.name==`File`}function f(e,t=!0){return e==null?!0:e instanceof Date?isNaN(e.getTime()):d(e)?e.size<=0:Array.isArray(e)?t?e.length===0:!1:typeof e==`object`&&e?Object.keys(e).length===0:!String(e).length}function ee(e){return e&&(e instanceof Date||e.constructor.name==`File`||e.constructor.name==`FileList`)?!1:typeof e==`object`&&!!e&&!Array.isArray(e)}function p(e){if(f(e))return!1;let t=null;if(e instanceof Date)t=e;else if(typeof e==`string`){let n=new Date(e);if(n.toString()===`Invalid Date`)return!1;t=n}return!!t}function m(e){let t=Object.prototype.toString.call(e);return e==null?new Date(NaN):e instanceof Date||typeof e==`object`&&t===`[object Date]`?new Date(e.getTime()):typeof e==`number`||t===`[object Number]`||typeof e==`string`||t===`[object String]`?new Date(e):new Date(NaN)}function h(e){return e===void 0?`0 bytes`:e<1024?`${e} bytes`:e<1024*1024?`${(e/1024).toFixed(2)} kb`:e<1024*1024*1024?`${(e/1024/1024).toFixed(2)} mb`:`${(e/1024/1024/1024).toFixed(2)} gb`}function g(e,t=!0){return!f(typeof e==`string`?e.trim():e,t)}function _(e){return e==null?!1:typeof e==`number`?!isNaN(e):!1}function v(e,...t){if(f(e))return!0;let n=typeof e==`number`?e.toString():e;return t.every(e=>(e.lastIndex=0,e.test(n)))}function y(e){let t=a(e);return Array.isArray(t)?t.length:typeof t==`object`?Object.keys(t).length:typeof t==`number`?isNaN(t)?0:t:String(t).length}function b(e){return typeof e==`number`?e:e==null?NaN:typeof e==`string`&&e.trim()===e?+e:NaN}function x(...e){let n=e.some(e=>typeof e==`function`?e.constructor.name===`AsyncFunction`:e._async),r=e.map(e=>{if(typeof e==`function`)return null;{let t=e._params;return t?.length?t:[]}}).flat().filter(e=>!!e);function i(e,t,...n){let r=[],i=0;for(let a of e)if(typeof a==`function`)r.push(a(t)),i++;else{let e=a._params?.length??0;r.push(a.validator(t,...n.slice(i,e))),e&&(i+=e)}return r}function a(e){return e?.some(e=>typeof e!=`boolean`)?{$valid:e.every(e=>typeof e==`boolean`?!!e:e.$valid),...e.reduce((e,t)=>{if(typeof t==`boolean`)return e;let{$valid:n,...r}=t;return{...e,...r}},{})}:e.every(e=>!!e)}let o;o=e.length?n?async(t,...n)=>a(await Promise.all(i(e,t,...n))):(t,...n)=>a(i(e,t,...n)):e=>!1;let s=t({type:`and`,validator:o,message:`The value does not match all of the provided validators`}),c=[...r??[]];return s._params=c,typeof s==`function`?s(...c):s}function S(...e){let n=e.some(e=>typeof e==`function`?e.constructor.name===`AsyncFunction`:e._async),r=e.map(e=>typeof e==`function`?null:e._params).flat().filter(e=>!!e);function i(e,t,...n){let r=[],i=0;for(let a of e)if(typeof a==`function`)r.push(a(t)),i++;else{let e=a._params?.length??0;r.push(a.validator(t,...n.slice(i,e))),e&&(i+=e)}return r}function a(e){return e.some(e=>typeof e!=`boolean`)?{$valid:e.some(e=>typeof e==`boolean`?!!e:e.$valid),...e.reduce((e,t)=>{if(typeof t==`boolean`)return e;let{$valid:n,...r}=t;return{...e,...r}},{})}:e.some(e=>!!e)}let o=t({type:`or`,validator:n?async(t,...n)=>a(await Promise.all(i(e,t,...n))):(t,...n)=>a(i(e,t,...n)),message:`The value does not match any of the provided validators`}),s=[...r??[]];return o._params=s,typeof o==`function`?o(...s):o}function te(e,n){let r,i,a,o,s;typeof e==`function`?(i=e,s=e.constructor.name===`AsyncFunction`):({_type:r,validator:i,_params:o}=e,s=e._async),a=s?async(e,...t)=>g(e)?!await i(e,...t):!0:(e,...t)=>g(e)?!i(e,...t):!0;let c=t({type:`not`,validator:a,message:n??`Error`}),l=[...o??[]];return c._params=l,typeof c==`function`?c(...l):c}function C(e,t,n){return Object.entries(i(t)).map(([t,r])=>typeof r==`function`||ee(r)&&`_validator`in r?[t,u(n?e:()=>!i(e),r)]:[t,r])}function ne(e,t,n){return r(()=>{let r=C(e,t,!0),i=n?C(e,n,!1):[];return Object.fromEntries([...r,...i])})}const w=/^https?$/,T=/^(?=.{1,253}\.?$)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[-0-9a-zA-Z]{0,61}[0-9a-zA-Z])?)*\.?$/,E=/^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z0-9\u00a1-\uffff][a-z0-9\u00a1-\uffff_-]{0,62})?[a-z0-9\u00a1-\uffff]\.)+(?:[a-z\u00a1-\uffff]{2,}\.?))(?::\d{2,5})?(?:[/?#]\S*)?$/i;function D(){return RegExp(`^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$`,`u`)}const O=/^[^A-Z]*$/,k=/^[^a-z]*$/,A=/^[0-9a-fA-F]*$/,j=/^[a-zA-Z]*$/,M=/^[\w.]+$/,N=/^[a-zA-Z0-9]*$/,P=/^[a-zA-Z0-9_]*$/,F=/^[-]?\d*(\.\d+)?$/,I=/^(?:[A-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9]{2,}(?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/i,L=/(^[0-9]*$)|(^-[0-9]+$)/,R=/^\d*(\.\d+)?$/,z=t({type:`alpha`,validator(e,t){return f(e)?!0:t?.allowSymbols?v(e,M):v(e,j)},message:`The value is not alphabetical`}),B=t({type:`alphaNum`,validator(e,t){return f(e)?!0:t?.allowSymbols?v(e,P):v(e,N)},message:`The value must be alpha-numeric`}),V=t({type:`between`,validator:(e,t,n,r)=>{let{allowEqual:i=!0}=r??{};if(g(e)&&g(t)&&g(n)){let r=b(e),a=b(t),o=b(n);return _(r)&&_(a)&&_(o)?i?r>=a&&r<=o:r>a&&r<o:!1}return!0},message:({$params:[e,t]})=>`The value must be between ${e} and ${t}`}),H=t({type:`boolean`,validator:e=>g(e)?typeof e==`boolean`:!0,message:`The value must be a native boolean`}),U=t({type:`checked`,validator:e=>g(e)?e===!0:!0,message:`The field must be checked`}),W=t({type:`contains`,validator(e,t){return g(e)&&g(t)?e.includes(t):!0},message({$params:[e]}){return`The value must contain ${e}`}}),G=t({type:`date`,validator:e=>g(e)?e instanceof Date:!0,message:`The value must be a native Date`});function K(){return navigator.languages==null?navigator.language:navigator.languages[0]}function q(e){return e?new Intl.DateTimeFormat(K(),{dateStyle:`short`}).format(new Date(e)):`?`}const J=t({type:`dateAfter`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return g(e)&&g(t)?p(e)&&p(t)?(r?m(e).getTime()>=m(t).getTime():m(e).getTime()>m(t).getTime())?!0:{$valid:!1,error:`date-not-after`}:{$valid:!1,error:`value-or-parameter-not-a-date`}:!0},message:({$params:[e],error:t})=>t===`value-or-parameter-not-a-date`?`The values must be dates`:`The date must be after ${q(e)}`}),Y=t({type:`dateBefore`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return g(e)&&g(t)?p(e)&&p(t)?(r?m(e).getTime()<=m(t).getTime():m(e).getTime()<m(t).getTime())?!0:{$valid:!1,error:`date-not-before`}:{$valid:!1,error:`value-or-parameter-not-a-date`}:!0},message:({$params:[e],error:t})=>t===`value-or-parameter-not-a-date`?`The values must be dates`:`The date must be before ${q(e)}`}),X=t({type:`dateBetween`,validator:(e,t,n,r)=>{let{allowEqual:i=!0}=r??{};return p(e)&&p(t)&&p(n)?i?m(e).getTime()>=m(t).getTime()&&m(e).getTime()<=m(n).getTime():m(e).getTime()>m(t).getTime()&&m(e).getTime()<m(n).getTime():!0},message:({$params:[e,t]})=>`The date must be between ${q(e)} and ${q(t)}`}),Z=t({type:`decimal`,validator(e){return f(e)?!0:v(e,F)},message:`The value must be decimal`}),re=t({type:`email`,validator(e){return f(e)?!0:v(e,I)},message:`The value must be an valid email address`}),ie=t({type:`emoji`,validator(e){return f(e)?!0:D().test(e)},message:`The value should be a valid emoji`}),ae=t({type:`endsWith`,validator(e,t){return g(e)&&g(t)?e.endsWith(t):!0},message({$params:[e]}){return`The value must end with ${e}`}}),oe=t({type:`exactDigits`,validator:(e,t)=>{if(g(e,!1)&&g(t)){if(_(t)){let n=RegExp(`^\\d{${t}}$`);return v(e.toString(),n)}return!1}return!0},message:({$params:[e]})=>`The value should have exactly ${e} digits`}),se=t({type:`exactLength`,validator:(e,t)=>g(e,!1)&&g(t)?_(t)?y(e)===t:!1:!0,message:({$params:[e]})=>`The value should be exactly ${e} characters long`}),ce=t({type:`exactValue`,validator:(e,t)=>g(e)&&g(t)&&_(t)&&!isNaN(b(e))?b(e)===t:!0,message:({$params:[e]})=>`The value must be equal to ${e}`}),le=t({type:`file`,validator:e=>g(e)?d(e):!0,message:`The value must be a native File`}),ue=t({type:`fileType`,validator:(e,t)=>g(e)?d(e)?t.includes(e.type):!1:!0,message({$params:[e]}){return`File type is not allowed. Allowed types are: ${e.map(e=>e.split(`/`)[1]).join(`, `)}.`}}),de=t({type:`hexadecimal`,validator(e){return f(e)?!0:v(e,A)},message:`The value must be hexadecimal`}),fe=t({type:`hostname`,validator(e){return f(e)?!0:v(e,T)},message:`The value is not a valid hostname`}),Q=t({type:`url`,validator(e,t={}){try{if(f(e))return!0;let{protocol:n}=t||{},r=new URL(e);return!T.test(r.hostname)||n&&!n.test(r.protocol.endsWith(`:`)?r.protocol.slice(0,-1):r.protocol)?!1:v(e,E)}catch{return!1}},message:`The value is not a valid URL address`}),pe=t({type:`httpUrl`,validator(e,t={}){if(f(e))return!0;let{protocol:n=w}=t||{};return Q({protocol:n}).exec(e)},message:`The value is not a valid http URL address`}),me=t({type:`integer`,validator(e){return f(e)?!0:v(e,L)},message:`The value must be an integer`});function he(e){if(e.length>3||e.length===0||e[0]===`0`&&e!==`0`||!e.match(/^\d+$/))return!1;let t=e|0;return t>=0&&t<=255}const ge=t({type:`ipv4Address`,validator(e){if(f(e))return!0;if(typeof e!=`string`)return!1;let t=e.split(`.`);return t.length===4&&t.every(he)},message:`The value is not a valid IPv4 address`});function _e(e){return o(l((e,t)=>g(e)&&g(t)?t===e:!0,[r(()=>i(e))]),({$params:[e]})=>`Value should be ${e}.`)}const ve=t({type:`lowercase`,validator(e){return f(e)?!0:v(e,O)},message:`The value is not a valid lowercase string`}),ye=t({type:`macAddress`,validator(e,t=`:`){if(f(e))return!0;if(typeof e!=`string`)return!1;let n=typeof t==`string`&&t!==``?e.split(t):e.length===12||e.length===16?e.match(/.{2}/g):null;return n!==null&&(n.length===6||n.length===8)&&n.every(be)},message:`The value is not a valid MAC Address`}),be=e=>e.toLowerCase().match(/^[0-9a-f]{2}$/),xe=t({type:`maxFileSize`,validator:(e,t)=>g(e)&&d(e)?{$valid:e.size<=t,fileSize:e.size}:!0,message({$params:[e],fileSize:t}){return`File size (${h(t)}) cannot exceed ${h(e)}`}}),Se=t({type:`maxLength`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return g(e,!1)&&g(t)?_(t)?r?y(e)<=t:y(e)<t:!1:!0},message:({$value:e,$params:[t]})=>Array.isArray(e)?`This list should have maximum ${t} items`:`The value length should not exceed ${t}`}),Ce=t({type:`maxValue`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return g(e)&&g(t)?!isNaN(b(e))&&!isNaN(b(t))?r?b(e)<=b(t):b(e)<b(t):!1:!0},message:({$params:[e,t]})=>{let{allowEqual:n=!0}=t??{};return n?`The value must be less than or equal to ${e}`:`The value must be less than ${e}`}}),we=t({type:`minFileSize`,validator:(e,t)=>g(e)&&d(e)?{$valid:e.size>=t,fileSize:e.size}:!0,message({$params:[e],fileSize:t}){return`File size (${h(t)}) must be at least ${h(e)}`}}),Te=t({type:`minLength`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return g(e,!1)&&g(t)?_(t)?r?y(e)>=t:y(e)>t:!1:!0},message:({$value:e,$params:[t]})=>Array.isArray(e)?`The list should have at least ${t} items`:`The value length should be at least ${t}`}),Ee=t({type:`minValue`,validator:(e,t,n)=>{let{allowEqual:r=!0}=n??{};return g(e)&&g(t)?!isNaN(b(e))&&!isNaN(b(t))?r?b(e)>=b(t):b(e)>b(t):!1:!0},message:({$params:[e,t]})=>{let{allowEqual:n=!0}=t??{};return n?`The value must be greater than or equal to ${e}`:`The value must be greater than ${e}`}});function De(e){let t=Object.keys(e).filter(t=>typeof e[e[t]]!=`number`),n={};for(let r of t)n[r]=e[r];return Object.values(n)}function $(e){return o(l((e,t)=>g(e)&&!f(t)?De(t).includes(e):!0,[r(()=>i(e))]),({$params:[e]})=>`The value should be one of those options: ${Object.values(e).join(`, `)}.`)}const Oe=t({type:`number`,validator:e=>g(e)?_(e):!0,message:`The value must be a native number`}),ke=t({type:`numeric`,validator(e){return f(e)?!0:v(e,R)},message:`The value must be numeric`}),Ae=t({type:`oneOf`,validator(e,t){return g(e)&&g(t,!1)?t.includes(e):!0},message:({$params:[e]})=>`The value should be one of those options: ${e.join(`, `)}.`}),je=t({type:`regex`,validator(e,t){return g(e)?v(e,...Array.isArray(t)?t:[t]):!0},message:`The value does not match the required pattern`}),Me=t({type:`required`,validator:e=>g(e),message:`This field is required`}),Ne=t({type:`required`,validator(e,t){return t?g(e):!0},message:`This field is required`,active({$params:[e]}){return e}}),Pe=t({type:`required`,validator(e,t){return t?!0:g(e)},message:`This field is required`,active({$params:[e]}){return!e}}),Fe=t({type:`sameAs`,validator(e,t,n){return f(e)?!0:e===t},message({$params:[e,t=`other`]}){return`The value must be equal to the ${t} value`}}),Ie=t({type:`startsWith`,validator(e,t){return g(e)&&g(t)?e.startsWith(t):!0},message({$params:[e]}){return`The value must start with ${e}`}}),Le=t({type:`string`,validator:e=>g(e)?typeof e==`string`:!0,message:`The value must be a string`});function Re(){return(()=>!0)}const ze=t({type:`uppercase`,validator(e){return f(e)?!0:v(e,k)},message:`The value is not a valid uppercase string`});export{z as alpha,B as alphaNum,x as and,u as applyIf,ne as assignIf,V as between,H as boolean,U as checked,W as contains,G as date,J as dateAfter,Y as dateBefore,X as dateBetween,Z as decimal,re as email,ie as emoji,ae as endsWith,oe as exactDigits,se as exactLength,ce as exactValue,le as file,ue as fileType,y as getSize,de as hexadecimal,fe as hostname,pe as httpUrl,me as integer,ge as ipv4Address,p as isDate,f as isEmpty,g as isFilled,_ as isNumber,_e as literal,ve as lowercase,ye as macAddress,v as matchRegex,xe as maxFileSize,Se as maxLength,Ce as maxValue,we as minFileSize,Te as minLength,Ee as minValue,$ as nativeEnum,te as not,Oe as number,ke as numeric,Ae as oneOf,S as or,je as regex,Me as required,Ne as requiredIf,Pe as requiredUnless,Fe as sameAs,Ie as startsWith,Le as string,m as toDate,b as toNumber,Re as type,ze as uppercase,Q as url,c as withAsync,o as withMessage,l as withParams,s as withTooltip};

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@regle/rules",
-  "version": "1.15.2",
+  "version": "1.16.0",
   "description": "Collection of rules and helpers for Regle",
   "dependencies": {
-    "type-fest": "5.2.0",
-    "@regle/core": "1.15.2"
+    "type-fest": "5.3.1",
+    "@regle/core": "1.16.0"
   },
   "devDependencies": {
-    "@types/node": "22.19.1",
-    "@vue/reactivity": "3.5.25",
+    "@types/node": "22.19.3",
+    "@vue/reactivity": "3.5.26",
     "@vue/test-utils": "2.4.6",
-    "prettier": "3.7.3",
-    "tsdown": "0.16.8",
-    "type-fest": "5.2.0",
+    "prettier": "3.7.4",
+    "tsdown": "0.18.3",
+    "type-fest": "5.3.1",
     "typescript": "5.9.3",
-    "vitest": "4.0.13",
-    "vue": "3.5.25",
-    "vue-tsc": "3.1.5"
+    "vitest": "4.0.16",
+    "vue": "3.5.26",
+    "vue-tsc": "3.2.1"
   },
   "type": "module",
   "exports": {