@regle/rules 1.20.4 → 1.21.0-beta.2

package/dist/regle-rules.d.ts

@@ -1,5 +1,5 @@
 /**
- * @regle/rules v1.20.4
+ * @regle/rules v1.21.0-beta.2
  * (c) 2026 Victor Garcia
  * @license MIT
  */

package/dist/regle-rules.js

@@ -1,19 +1,17 @@
 /**
- * @regle/rules v1.20.4
+ * @regle/rules v1.21.0-beta.2
  * (c) 2026 Victor Garcia
  * @license MIT
  */
 
 import { InternalRuleType, createRule, unwrapRuleParameters } from "@regle/core";
 import { capitalize, computed, effectScope, onScopeDispose, ref, toValue } from "vue";
-
 /**
 * Server side friendly way of checking for a File
 */
 function isFile(value) {
 	return value?.constructor?.name == "File";
 }
-
 /**
 * Checks if a value is empty in any way (including arrays and objects).
 * This is the inverse of `isFilled`.
@@ -58,16 +56,13 @@ function isEmpty(value, considerEmptyArrayInvalid = true, considerEmptyObjectInv
 	}
 	return !String(value).length;
 }
-
 function isObject(obj) {
 	if (obj && (obj instanceof Date || obj.constructor.name == "File" || obj.constructor.name == "FileList")) return false;
 	return typeof obj === "object" && obj !== null && !Array.isArray(obj);
 }
-
 function isRuleDef(rule) {
 	return (isObject(rule) || typeof rule === "function") && "_validator" in rule;
 }
-
 function extractValidator(rule) {
 	let _type;
 	let validator;
@@ -90,7 +85,6 @@ function extractValidator(rule) {
 		_active
 	};
 }
-
 function withMessage(rule, newMessage) {
 	const { _type, validator, _active, _params, _async } = extractValidator(rule);
 	const newRule = createRule({
@@ -112,7 +106,6 @@ function withMessage(rule, newMessage) {
 		return newRule;
 	} else return newRule;
 }
-
 function withTooltip(rule, newTooltip) {
 	const { _type, validator, _active, _params, _message, _async } = extractValidator(rule);
 	const newRule = createRule({
@@ -132,7 +125,6 @@ function withTooltip(rule, newTooltip) {
 		return executedRule;
 	} else return newRule;
 }
-
 function withAsync(rule, depsArray) {
 	let validator;
 	const { _type, _params, _message, _active } = extractValidator(rule);
@@ -151,7 +143,6 @@ function withAsync(rule, depsArray) {
 	newRule._params = augmentedParams;
 	return newRule(...depsArray ?? []);
 }
-
 function withParams(rule, depsArray) {
 	let validator;
 	const { _type, _params, _message, _active, _async } = extractValidator(rule);
@@ -170,7 +161,6 @@ function withParams(rule, depsArray) {
 	newRule._params = augmentedParams;
 	return newRule(...depsArray);
 }
-
 function applyIf(_condition, rule, options) {
 	const { _type, validator, _params, _message, _async, _active } = extractValidator(rule);
 	const augmentedParams = (_params ?? []).concat(options?.hideParams ? [] : [_condition]);
@@ -196,7 +186,6 @@ function applyIf(_condition, rule, options) {
 	if (typeof newRule === "function") return newRule(...augmentedParams);
 	else return newRule;
 }
-
 /**
 * Checks if the provided value is a valid Date. Used internally for date rules.
 * Can also validate date strings.
@@ -233,7 +222,6 @@ function isDate(value) {
 	}
 	return !!possibleDate;
 }
-
 /**
 * Coerces any string, number, or Date value into a `Date` using the `Date` constructor.
 *
@@ -259,7 +247,6 @@ function toDate(argument) {
 	else if (typeof argument === "string" || argStr === "[object String]") return new Date(argument);
 	else return /* @__PURE__ */ new Date(NaN);
 }
-
 function debounce(func, wait, { immediate = false, trackDebounceRef } = {}) {
 	let timeout;
 	const debouncedFn = (...args) => {
@@ -299,7 +286,6 @@ function debounce(func, wait, { immediate = false, trackDebounceRef } = {}) {
 	};
 	return debouncedFn;
 }
-
 /**
 * Formats a file size in bytes to a human readable string.
 * @param size - The size in bytes
@@ -312,7 +298,6 @@ function formatFileSize(size) {
 	if (size < 1024 * 1024 * 1024) return `${(size / 1024 / 1024).toFixed(2)} mb`;
 	return `${(size / 1024 / 1024 / 1024).toFixed(2)} gb`;
 }
-
 /**
 * Checks if any value you provide is defined (including arrays and objects).
 * This is almost a must-have for optional fields when writing custom rules.
@@ -346,7 +331,6 @@ function formatFileSize(size) {
 function isFilled(value, considerEmptyArrayInvalid = true, considerEmptyObjectInvalid = true) {
 	return !isEmpty(typeof value === "string" ? value.trim() : value, considerEmptyArrayInvalid, considerEmptyObjectInvalid);
 }
-
 /**
 * Type guard that checks if the passed value is a real `Number`.
 * Returns `false` for `NaN`, making it safer than `typeof value === "number"`.
@@ -378,7 +362,6 @@ function isNumber(value) {
 	else if (isNaN(value)) return false;
 	else return true;
 }
-
 /**
 * Tests a value against one or more regular expressions.
 * Returns `true` if the value is empty or matches **all** provided patterns.
@@ -413,7 +396,6 @@ function matchRegex(_value, ...expr) {
 		return reg.test(value);
 	});
 }
-
 /**
 * Returns the length/size of any data type. Works with strings, arrays, objects and numbers.
 *
@@ -448,7 +430,6 @@ function getSize(value) {
 	}
 	return String(_value).length;
 }
-
 /**
 * Converts any string (or number) into a number using the `Number` constructor.
 *
@@ -481,7 +462,6 @@ function toNumber(argument) {
 	}
 	return NaN;
 }
-
 /**
 * Type guard that checks if the passed value is a real `String`.
 */
@@ -490,7 +470,6 @@ function isString(value) {
 	else if (typeof value !== "string") return false;
 	return true;
 }
-
 function isAnyRuleAsync(rules) {
 	return rules.some((rule) => {
 		if (typeof rule === "function") return rule.constructor.name === "AsyncFunction";
@@ -581,7 +560,6 @@ function combineRules(rules, options) {
 	if (typeof newRule === "function") return newRule(...newParams);
 	else return newRule;
 }
-
 /**
 * The `and` operator combines multiple rules and validates successfully only if **all** provided rules are valid.
 *
@@ -615,7 +593,6 @@ function and(...rules) {
 		message: "The value does not match all of the provided validators"
 	});
 }
-
 /**
 * The `or` operator validates successfully if **at least one** of the provided rules is valid.
 *
@@ -649,7 +626,6 @@ function or(...rules) {
 		message: "The value does not match any of the provided validators"
 	});
 }
-
 /**
 * The `xor` operator validates successfully if **exactly one** of the provided rules is valid (exclusive or).
 *
@@ -683,7 +659,6 @@ function xor(...rules) {
 		message: "The value does not match exactly one of the provided validators"
 	});
 }
-
 /**
 * The `not` operator passes when the provided rule **fails** and fails when the rule **passes**.
 * It can be combined with other rules.
@@ -740,7 +715,6 @@ function not(rule, message) {
 	if (typeof newRule === "function") return newRule(...newParams);
 	else return newRule;
 }
-
 function mapRulesWithCondition(condition, rules, trueCheck) {
 	return Object.entries(toValue(rules)).map(([key, rule]) => {
 		if (typeof rule === "function" || isObject(rule) && "_validator" in rule) return [key, applyIf(trueCheck ? condition : () => !toValue(condition), rule)];
@@ -774,7 +748,6 @@ function assignIf(_condition, rules, otherwiseRules) {
 	let falseRules = otherwiseRules ? mapRulesWithCondition(_condition, otherwiseRules, false) : [];
 	return Object.fromEntries([...trueRules, ...falseRules]);
 }
-
 /**
 * Creates a computed ref that checks if all previous rules have passed.
 */
@@ -854,7 +827,6 @@ function pipe(...rules) {
 		$debounce: 0
 	};
 }
-
 /** Regex for validating url protocols */
 const DEFAULT_PROTOCOL_REGEX = /^https?$/;
 /** Regex for validating url hostnames */
@@ -892,7 +864,6 @@ const EMAIL_REGEX = /^(?:[A-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-z0-9!#$%&'*+/=?^_`{
 const INTEGER_REGEX = /(^[0-9]*$)|(^-[0-9]+$)/;
 /** Regex for validating numeric strings */
 const NUMERIC_REGEX = /^\d*(\.\d+)?$/;
-
 /**
 * Allows only alphabetic characters.
 *
@@ -923,7 +894,6 @@ const alpha = createRule({
 	},
 	message: "The value must be alphabetical"
 });
-
 /**
 * Allows only alphanumeric characters.
 *
@@ -954,7 +924,6 @@ const alphaNum = createRule({
 	},
 	message: "The value must be alpha-numeric"
 });
-
 /**
 * Checks if at least one key is filled in the object.
 *
@@ -986,7 +955,6 @@ const atLeastOne = createRule({
 	},
 	message: "At least one item is required"
 });
-
 /**
 * Checks if a number is in specified bounds. `min` and `max` are both inclusive by default.
 *
@@ -1033,7 +1001,6 @@ const between = createRule({
 		return `The value must be between ${min} and ${max}`;
 	}
 });
-
 /**
 * Requires a value to be a native boolean type.
 *
@@ -1061,7 +1028,6 @@ const boolean = createRule({
 	},
 	message: "The value must be a native boolean"
 });
-
 /**
 * Requires a boolean value to be `true`. This is useful for checkbox inputs like "accept terms".
 *
@@ -1084,7 +1050,6 @@ const checked = createRule({
 	message: "The field must be checked",
 	required: true
 });
-
 /**
 * Factory function to create string operation rules (contains/startsWith/endsWith).
 * Reduces duplication between similar string validation rules.
@@ -1115,7 +1080,6 @@ function createStringOperationRule({ type, operation }) {
 		}
 	});
 }
-
 /**
 * Checks if the string contains the specified substring.
 *
@@ -1138,7 +1102,6 @@ const contains = createStringOperationRule({
 	type: "contains",
 	operation: "contains"
 });
-
 /**
 * Checks if the value matches one or more regular expressions.
 *
@@ -1167,7 +1130,6 @@ const regex = createRule({
 	},
 	message: "The value must match the required pattern"
 });
-
 /**
 * Requires a string field to contain at least a given number of special characters.
 *
@@ -1205,7 +1167,6 @@ const containsSpecialCharacter = createRule({
 		return `This field must contain at least ${minCharactersCount} special character${minCharactersCount > 1 ? "s" : ""}`;
 	}
 });
-
 /**
 * Requires a string field to contain at least a given number of uppercase letters.
 *
@@ -1241,7 +1202,6 @@ const containsUppercase = createRule({
 		return `This field must contain at least ${minUppercaseCount} uppercase letter${minUppercaseCount > 1 ? "s" : ""}`;
 	}
 });
-
 /**
 * Requires a value to be a native `Date` constructor.
 *
@@ -1269,7 +1229,6 @@ const date = createRule({
 	},
 	message: "The value must be a native Date"
 });
-
 function getUserLocale() {
 	if (navigator.languages != void 0) return navigator.languages[0];
 	return navigator.language ?? "en-US";
@@ -1278,7 +1237,6 @@ function formatLocaleDate(date) {
 	if (date) return new Intl.DateTimeFormat(getUserLocale(), { dateStyle: "short" }).format(new Date(date));
 	return "?";
 }
-
 /**
 * Checks if the date is after the given parameter.
 *
@@ -1325,7 +1283,6 @@ const dateAfter = createRule({
 		return `The date must be after ${formatLocaleDate(after)}`;
 	}
 });
-
 /**
 * Checks if the date is before the given parameter.
 *
@@ -1372,7 +1329,6 @@ const dateBefore = createRule({
 		return `The date must be before ${formatLocaleDate(before)}`;
 	}
 });
-
 /**
 * Checks if the date falls between the specified bounds.
 *
@@ -1408,7 +1364,6 @@ const dateBetween = createRule({
 		return `The date must be between ${formatLocaleDate(before)} and ${formatLocaleDate(after)}`;
 	}
 });
-
 /**
 * Allows positive and negative decimal numbers.
 *
@@ -1431,7 +1386,6 @@ const decimal = createRule({
 	},
 	message: "The value must be decimal"
 });
-
 /**
 * Validates domain names.
 *
@@ -1454,7 +1408,6 @@ const domain = createRule({
 	},
 	message: "The value is not a valid domain"
 });
-
 /**
 * Validates email addresses. Always verify on the server to ensure the address is real and not already in use.
 *
@@ -1477,7 +1430,6 @@ const email = createRule({
 	},
 	message: "The value must be a valid email address"
 });
-
 /**
 * Validates if the value is a valid emoji.
 *
@@ -1500,7 +1452,6 @@ const emoji = createRule({
 	},
 	message: "The value should be a valid emoji"
 });
-
 /**
 * Checks if the string ends with the specified substring.
 *
@@ -1521,7 +1472,6 @@ const endsWith = createStringOperationRule({
 	type: "endsWith",
 	operation: "endsWith"
 });
-
 /**
 * Requires the input value to have a strict specified length. Works with arrays, objects and strings.
 *
@@ -1563,7 +1513,6 @@ const exactDigits = createRule({
 		return `The value should have exactly ${count} digits`;
 	}
 });
-
 /**
 * Requires the input value to have a strict specified length. Works with arrays, objects and strings.
 *
@@ -1602,7 +1551,6 @@ const exactLength = createRule({
 		return `The value must be exactly ${count} characters long`;
 	}
 });
-
 /**
 * Requires a field to have a strict numeric value.
 *
@@ -1641,7 +1589,6 @@ const exactValue = createRule({
 		return `The value must be equal to ${count}`;
 	}
 });
-
 /**
 * Requires a value to be a native `File` constructor.
 *
@@ -1669,7 +1616,6 @@ const file = createRule({
 	},
 	message: "The value must be a native File"
 });
-
 /**
 * Requires a value to be a file with a specific type.
 *
@@ -1701,7 +1647,6 @@ const fileType = createRule({
 		return `File type is not allowed. Allowed types are: ${accept.map((type) => type.split("/")[1]).join(", ")}.`;
 	}
 });
-
 /**
 * Validates hexadecimal values.
 *
@@ -1724,7 +1669,6 @@ const hexadecimal = createRule({
 	},
 	message: "The value must be hexadecimal"
 });
-
 /**
 * Validates hostnames.
 *
@@ -1747,7 +1691,6 @@ const hostname = createRule({
 	},
 	message: "The value is not a valid hostname"
 });
-
 /**
 * Validates URLs.
 *
@@ -1785,7 +1728,6 @@ const url = createRule({
 	},
 	message: "The value must be a valid URL"
 });
-
 /**
 * Validates HTTP URLs.
 *
@@ -1814,7 +1756,6 @@ const httpUrl = createRule({
 	},
 	message: "The value is not a valid http URL address"
 });
-
 /**
 * Allows only integers (positive and negative).
 *
@@ -1837,7 +1778,6 @@ const integer = createRule({
 	},
 	message: "The value must be an integer"
 });
-
 function nibbleValid(nibble) {
 	if (nibble.length > 3 || nibble.length === 0) return false;
 	if (nibble[0] === "0" && nibble !== "0") return false;
@@ -1869,7 +1809,6 @@ const ipv4Address = createRule({
 	},
 	message: "The value is not a valid IPv4 address"
 });
-
 /**
 * Allow only one possible literal value.
 *
@@ -1892,7 +1831,6 @@ function literal(literal) {
 		return true;
 	}, [computed(() => toValue(literal))]), ({ $params: [literal] }) => `Value should be ${literal}.`);
 }
-
 /**
 * Validates lowercase strings.
 *
@@ -1915,7 +1853,6 @@ const lowercase = createRule({
 	},
 	message: "The value must be lowercase"
 });
-
 /**
 * Validates MAC addresses. Call as a function to specify a custom separator (e.g., `':'` or an empty string for `00ff1122334455`).
 *
@@ -1947,7 +1884,6 @@ const macAddress = createRule({
 	message: "The value is not a valid MAC Address"
 });
 const hexValid = (hex) => hex.toLowerCase().match(/^[0-9a-f]{2}$/);
-
 /**
 * Requires a value to be a file with a maximum size.
 *
@@ -1982,7 +1918,6 @@ const maxFileSize = createRule({
 		return `File size (${formatFileSize(fileSize)}) cannot exceed ${formatFileSize(maxSize)}`;
 	}
 });
-
 /**
 * Factory function to create length comparison rules (minLength/maxLength).
 * Reduces duplication between similar length rules.
@@ -2012,7 +1947,6 @@ function createLengthRule({ type, direction }) {
 		}
 	});
 }
-
 /**
 * Requires the input value to have a maximum specified length, inclusive. Works with arrays, objects and strings.
 *
@@ -2043,7 +1977,6 @@ const maxLength = createLengthRule({
 	type: "maxLength",
 	direction: "max"
 });
-
 /**
 * Factory function to create value comparison rules (minValue/maxValue).
 * Reduces duplication between similar comparison rules.
@@ -2074,7 +2007,6 @@ function createValueComparisonRule({ type, direction }) {
 		}
 	});
 }
-
 /**
 * Requires a field to have a specified maximum numeric value.
 *
@@ -2105,7 +2037,6 @@ const maxValue = createValueComparisonRule({
 	type: "maxValue",
 	direction: "max"
 });
-
 /**
 * Requires a value to be a file with a minimum size.
 *
@@ -2140,7 +2071,6 @@ const minFileSize = createRule({
 		return `File size (${formatFileSize(fileSize)}) must be at least ${formatFileSize(minSize)}`;
 	}
 });
-
 /**
 * Requires the input value to have a minimum specified length, inclusive. Works with arrays, objects and strings.
 *
@@ -2171,7 +2101,6 @@ const minLength = createLengthRule({
 	type: "minLength",
 	direction: "min"
 });
-
 /**
 * Requires a field to have a specified minimum numeric value.
 *
@@ -2202,7 +2131,6 @@ const minValue = createValueComparisonRule({
 	type: "minValue",
 	direction: "min"
 });
-
 function getValidEnumValues(obj) {
 	const validKeys = Object.keys(obj).filter((k) => typeof obj[obj[k]] !== "number");
 	const filtered = {};
@@ -2235,7 +2163,6 @@ function nativeEnum(enumLike) {
 		return true;
 	}, [computed(() => toValue(enumLike))]), ({ $params: [enumLike] }) => `The value must be one of the following: ${Object.values(enumLike).join(", ")}`);
 }
-
 /**
 * Requires a value to be a native number type.
 *
@@ -2263,7 +2190,6 @@ const number = createRule({
 	},
 	message: "The value must be a native number"
 });
-
 /**
 * Allows only numeric values (including numeric strings).
 *
@@ -2286,7 +2212,6 @@ const numeric = createRule({
 	},
 	message: "The value must be numeric"
 });
-
 /**
 * Allow only one of the values from a fixed Array of possible entries.
 *
@@ -2316,7 +2241,6 @@ const oneOf = createRule({
 		return `The value must be one of the following: ${(Array.isArray(options) ? options : Object.values(options)).join(", ")}`;
 	}
 });
-
 /**
 * Requires non-empty data. Checks for empty arrays and strings containing only whitespaces.
 *
@@ -2339,7 +2263,6 @@ const required = createRule({
 	message: "This field is required",
 	required: true
 });
-
 /**
 * Requires non-empty data, only if provided data property, ref, or a function resolves to `true`.
 *
@@ -2374,7 +2297,6 @@ const requiredIf = createRule({
 		return condition;
 	}
 });
-
 /**
 * Requires non-empty data, only if provided data property, ref, or a function resolves to `false`.
 *
@@ -2409,7 +2331,6 @@ const requiredUnless = createRule({
 		return !condition;
 	}
 });
-
 /**
 * Checks if the value matches the specified property or ref. Useful for password confirmation fields.
 *
@@ -2444,7 +2365,6 @@ const sameAs = createRule({
 		return `The value must be equal to the ${otherName} value`;
 	}
 });
-
 /**
 * Checks if the string starts with the specified substring.
 *
@@ -2467,7 +2387,6 @@ const startsWith = createStringOperationRule({
 	type: "startsWith",
 	operation: "startsWith"
 });
-
 /**
 * Requires a value to be a native string type.
 *
@@ -2495,7 +2414,6 @@ const string = createRule({
 	},
 	message: "The value must be a string"
 });
-
 /**
 * Define the input type of a rule. No runtime validation.
 *
@@ -2519,7 +2437,6 @@ const string = createRule({
 function type() {
 	return (() => true);
 }
-
 /**
 * Validates uppercase strings.
 *
@@ -2542,5 +2459,4 @@ const uppercase = createRule({
 	},
 	message: "The value must be uppercase"
 });
-
-export { alpha, alphaNum, and, applyIf, assignIf, atLeastOne, between, boolean, checked, contains, containsSpecialCharacter, containsUppercase, date, dateAfter, dateBefore, dateBetween, decimal, domain, 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, pipe, regex, required, requiredIf, requiredUnless, sameAs, startsWith, string, toDate, toNumber, type, uppercase, url, withAsync, withMessage, withParams, withTooltip, xor };
+export { alpha, alphaNum, and, applyIf, assignIf, atLeastOne, between, boolean, checked, contains, containsSpecialCharacter, containsUppercase, date, dateAfter, dateBefore, dateBetween, decimal, domain, 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, pipe, regex, required, requiredIf, requiredUnless, sameAs, startsWith, string, toDate, toNumber, type, uppercase, url, withAsync, withMessage, withParams, withTooltip, xor };

package/dist/regle-rules.min.js

@@ -1,5 +1,5 @@
 /**
- * @regle/rules v1.20.4
+ * @regle/rules v1.21.0-beta.2
  * (c) 2026 Victor Garcia
  * @license MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@regle/rules",
-  "version": "1.20.4",
+  "version": "1.21.0-beta.2",
   "description": "Collection of rules and helpers for Regle",
   "homepage": "https://reglejs.dev/",
   "license": "MIT",
@@ -35,20 +35,20 @@
     "access": "public"
   },
   "dependencies": {
-    "type-fest": "5.4.4",
-    "@regle/core": "1.20.4"
+    "type-fest": "5.5.0",
+    "@regle/core": "1.21.0-beta.2"
   },
   "devDependencies": {
     "@types/node": "24.12.0",
     "@typescript/native-preview": "7.0.0-dev.20260317.1",
     "@vue/reactivity": "3.5.30",
     "@vue/test-utils": "2.4.6",
-    "tsdown": "0.20.3",
-    "type-fest": "5.4.4",
+    "tsdown": "0.21.4",
+    "type-fest": "5.5.0",
     "typescript": "5.9.3",
     "vitest": "4.1.0",
     "vue": "3.5.30",
-    "vue-tsc": "3.2.5"
+    "vue-tsc": "3.2.6"
   },
   "scripts": {
     "typecheck": "tsgo --noEmit",