@regle/core 1.18.0-beta.3 → 1.18.0

package/dist/regle-core.js

@@ -1,5 +1,5 @@
 /**
- * @regle/core v1.18.0-beta.3
+ * @regle/core v1.18.0
  * (c) 2026 Victor Garcia
  * @license MIT
  */
@@ -18,6 +18,22 @@ 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 getDotPath(obj, propsArg, defaultValue) {
+	if (!obj) return defaultValue;
+	var props, prop;
+	if (Array.isArray(propsArg)) props = propsArg.slice(0);
+	if (typeof propsArg == "string") props = propsArg.split(".");
+	if (typeof propsArg == "symbol") props = [propsArg];
+	if (!Array.isArray(props)) throw new Error("props arg must be an array, a string or a symbol");
+	while (props.length) {
+		prop = props.shift();
+		if (!obj) return defaultValue;
+		if (!prop) return defaultValue;
+		obj = obj[prop];
+		if (obj === void 0) return defaultValue;
+	}
+	return obj;
+}
 function merge(_obj1, ..._objs) {
 	var args = [].slice.call(arguments);
 	var arg;
@@ -381,15 +397,15 @@ function defineRuleProcessors(definition, ...params) {
 			else return definition.tooltip ?? [];
 		},
 		exec(value) {
-			const validator$1 = definition.validator(value, ...unwrapRuleParameters(params));
+			const validator = definition.validator(value, ...unwrapRuleParameters(params));
 			let rawResult;
-			if (validator$1 instanceof Promise) return validator$1.then((result) => {
+			if (validator instanceof Promise) return validator.then((result) => {
 				rawResult = result;
 				if (typeof rawResult === "object" && "$valid" in rawResult) return rawResult.$valid;
 				else if (typeof rawResult === "boolean") return rawResult;
 				return false;
 			});
-			else rawResult = validator$1;
+			else rawResult = validator;
 			if (typeof rawResult === "object" && "$valid" in rawResult) return rawResult.$valid;
 			else if (typeof rawResult === "boolean") return rawResult;
 			return false;
@@ -725,8 +741,8 @@ const REGLE_FLAGS = { REGLE_STATIC: "__regle_static" };
 function isNestedRulesDef(state, rules) {
 	return !isStatic(state.value) && (isRefObject(state) || isObject(rules.value) && !isEmpty(rules.value) && !Object.entries(rules.value).some(([_, rule]) => isRuleDef(rule) || typeof rule === "function"));
 }
-function isCollectionRulesDef(rules, state, schemaMode = false) {
-	return !!rules.value && isObject(rules.value) && "$each" in rules.value || schemaMode && Array.isArray(state.value) || Array.isArray(state.value) && state.value.some(isObject);
+function isCollectionRulesDef(rules, state) {
+	return !!rules.value && isObject(rules.value) && "$each" in rules.value || Array.isArray(state.value);
 }
 function isValidatorRulesDef(rules) {
 	return !!rules.value && (isObject(rules.value) || isRefObject(rules.value));
@@ -953,8 +969,8 @@ function createReactiveRuleStatus({ customMessages, rule, ruleKey, state, path,
 			if (state.value !== cachedValue) return true;
 			if (typeof validatorResult === "boolean") ruleResult = validatorResult;
 			else {
-				const { $valid: $valid$1, ...rest } = validatorResult;
-				ruleResult = $valid$1;
+				const { $valid, ...rest } = validatorResult;
+				ruleResult = $valid;
 				$metadata.value = rest;
 			}
 		} catch {
@@ -976,8 +992,8 @@ function createReactiveRuleStatus({ customMessages, rule, ruleKey, state, path,
 				if (resultOrPromise instanceof Promise) console.warn("You used a async validator function on a non-async rule, please use \"async await\" or the \"withAsync\" helper");
 				else if (resultOrPromise != null) if (typeof resultOrPromise === "boolean") ruleResult = resultOrPromise;
 				else {
-					const { $valid: $valid$1, ...rest } = resultOrPromise;
-					ruleResult = $valid$1;
+					const { $valid, ...rest } = resultOrPromise;
+					ruleResult = $valid;
 					$metadata.value = rest;
 				}
 			}
@@ -1048,9 +1064,9 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 	function createReactiveRulesResult() {
 		const declaredRules = rulesDef.value;
 		const storeResult = storage.checkRuleDeclEntry(cachePath, declaredRules);
-		const options$1 = {};
-		for (const key in declaredRules) if (key.startsWith("$")) options$1[key] = declaredRules[key];
-		$localOptions.value = options$1;
+		const options = {};
+		for (const key in declaredRules) if (key.startsWith("$")) options[key] = declaredRules[key];
+		$localOptions.value = options;
 		$watch();
 		const rules = rulesDef.value;
 		const entries = [];
@@ -1118,7 +1134,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 			const $isArrayOrRegleStatic = computed(() => {
 				return $isArray || isStatic(state.value);
 			});
-			const $debounce$1 = computed(() => {
+			const $debounce = computed(() => {
 				if ($localOptions.value.$debounce != null) return $localOptions.value.$debounce;
 				if (scopeState.$haveAnyAsyncRule.value) return DEFAULT_DEBOUNCE_TIME;
 				return 0;
@@ -1127,7 +1143,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				if ($localOptions.value.$deepCompare != null) return $localOptions.value.$deepCompare;
 				return false;
 			});
-			const $lazy$1 = computed(() => {
+			const $lazy = computed(() => {
 				if ($localOptions.value.$lazy != null) return $localOptions.value.$lazy;
 				else if (unref(options.lazy) != null) return unref(options.lazy);
 				return false;
@@ -1137,29 +1153,29 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				else if (unref(options.immediateDirty) != null) return unref(options.immediateDirty);
 				return false;
 			});
-			const $rewardEarly$1 = computed(() => {
+			const $rewardEarly = computed(() => {
 				if ($localOptions.value.$rewardEarly != null) return $localOptions.value.$rewardEarly;
 				else if (unref(options.rewardEarly) != null) return unref(options.rewardEarly);
 				return false;
 			});
-			const $clearExternalErrorsOnChange$1 = computed(() => {
+			const $clearExternalErrorsOnChange = computed(() => {
 				if ($localOptions.value.$clearExternalErrorsOnChange != null) return $localOptions.value.$clearExternalErrorsOnChange;
 				else if (unref(options.clearExternalErrorsOnChange) != null) return unref(options.clearExternalErrorsOnChange);
 				else if ($silent.value) return false;
 				return true;
 			});
 			const $silent = computed(() => {
-				if ($rewardEarly$1.value) return true;
+				if ($rewardEarly.value) return true;
 				else if ($localOptions.value.$silent != null) return $localOptions.value.$silent;
 				else if (unref(options.silent) != null) return unref(options.silent);
 				else return false;
 			});
-			const $autoDirty$1 = computed(() => {
+			const $autoDirty = computed(() => {
 				if ($localOptions.value.$autoDirty != null) return $localOptions.value.$autoDirty;
 				else if (unref(options.autoDirty) != null) return unref(options.autoDirty);
 				return true;
 			});
-			const $validating$1 = computed(() => {
+			const $validating = computed(() => {
 				for (const ruleResult of Object.values($rules.value)) if (ruleResult.$validating) return true;
 				return false;
 			});
@@ -1223,7 +1239,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				return !($invalid.value || $pending.value);
 			});
 			const $pending = computed(() => {
-				if (triggerPunishment.value || !$rewardEarly$1.value) return Object.entries($rules.value).some(([_, ruleResult]) => {
+				if (triggerPunishment.value || !$rewardEarly.value) return Object.entries($rules.value).some(([_, ruleResult]) => {
 					return ruleResult.$pending;
 				});
 				return false;
@@ -1241,7 +1257,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				if (externalErrors?.value?.length) return false;
 				else if ($inactive.value) return false;
 				else if ($isDebouncing.value) return false;
-				else if ($dirty.value && !isEmpty(state.value) && !$validating$1.value && !$pending.value) if (schemaMode) return !schemaErrors?.value?.length;
+				else if ($dirty.value && !isEmpty(state.value) && !$validating.value && !$pending.value) if (schemaMode) return !schemaErrors?.value?.length;
 				else {
 					const rules = Object.values($rules.value);
 					for (const rule of rules) if (rule.$active) {
@@ -1251,23 +1267,23 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				}
 				return false;
 			});
-			const $haveAnyAsyncRule$1 = computed(() => {
+			const $haveAnyAsyncRule = computed(() => {
 				return Object.values($rules.value).some((rule) => rule.$haveAsync);
 			});
 			const $modifiers = computed(() => {
 				return {
-					$debounce: $debounce$1.value,
-					$lazy: $lazy$1.value,
-					$rewardEarly: $rewardEarly$1.value,
-					$autoDirty: $autoDirty$1.value,
+					$debounce: $debounce.value,
+					$lazy: $lazy.value,
+					$rewardEarly: $rewardEarly.value,
+					$autoDirty: $autoDirty.value,
 					$silent: $silent.value,
-					$clearExternalErrorsOnChange: $clearExternalErrorsOnChange$1.value
+					$clearExternalErrorsOnChange: $clearExternalErrorsOnChange.value
 				};
 			});
 			function processShortcuts() {
 				if (shortcuts?.fields) Object.entries(shortcuts.fields).forEach(([key, value]) => {
-					const scope$1 = effectScope();
-					$shortcuts$1[key] = scope$1.run(() => {
+					const scope = effectScope();
+					$shortcuts[key] = scope.run(() => {
 						const result = ref();
 						watchEffect(() => {
 							result.value = value(reactive({
@@ -1293,35 +1309,35 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 						});
 						return result;
 					});
-					fieldScopes.push(scope$1);
+					fieldScopes.push(scope);
 				});
 			}
-			const $shortcuts$1 = {};
+			const $shortcuts = {};
 			return {
 				$error,
 				$pending,
 				$invalid,
 				$correct,
-				$debounce: $debounce$1,
+				$debounce,
 				$deepCompare,
-				$lazy: $lazy$1,
+				$lazy,
 				$immediateDirty,
 				$ready,
 				$issues,
 				$silentIssues,
 				$errors,
 				$silentErrors,
-				$rewardEarly: $rewardEarly$1,
-				$autoDirty: $autoDirty$1,
+				$rewardEarly,
+				$autoDirty,
 				$silent,
-				$clearExternalErrorsOnChange: $clearExternalErrorsOnChange$1,
+				$clearExternalErrorsOnChange,
 				$anyDirty,
 				$edited,
 				$anyEdited,
 				$name,
-				$haveAnyAsyncRule: $haveAnyAsyncRule$1,
-				$shortcuts: $shortcuts$1,
-				$validating: $validating$1,
+				$haveAnyAsyncRule,
+				$shortcuts,
+				$validating,
 				$tooltips,
 				$dirty,
 				processShortcuts,
@@ -1372,24 +1388,24 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 	const $rules = ref({});
 	const $localOptions = ref({});
 	createReactiveRulesResult();
-	function $reset(options$1, fromParent) {
+	function $reset(options, fromParent) {
 		abortCommit();
 		$clearExternalErrors();
 		scopeState.$dirty.value = false;
 		storage.setDirtyEntry(cachePath, false);
-		if (!fromParent) if (options$1?.toOriginalState) {
+		if (!fromParent) if (options?.toOriginalState) {
 			state.value = cloneDeep(originalState);
 			initialState.value = cloneDeep(originalState);
-		} else if (options$1?.toInitialState) state.value = cloneDeep(initialState.value);
-		else if (options$1?.toState) {
+		} else if (options?.toInitialState) state.value = cloneDeep(initialState.value);
+		else if (options?.toState) {
 			let newInitialState;
-			if (typeof options$1?.toState === "function") newInitialState = options$1?.toState();
-			else newInitialState = options$1?.toState;
+			if (typeof options?.toState === "function") newInitialState = options?.toState();
+			else newInitialState = options?.toState;
 			initialState.value = cloneDeep(newInitialState);
 			state.value = cloneDeep(newInitialState);
 		} else initialState.value = isObject(state.value) && !isStatic(state.value) ? cloneDeep(state.value) : Array.isArray(state.value) ? [...state.value] : state.value;
-		if (options$1?.clearExternalErrors) $clearExternalErrors();
-		if (!fromParent && !options$1?.keepValidationState) for (const rule of Object.values($rules.value)) rule.$reset();
+		if (options?.clearExternalErrors) $clearExternalErrors();
+		if (!fromParent && !options?.keepValidationState) for (const rule of Object.values($rules.value)) rule.$reset();
 		if (!scopeState.$lazy.value && !scopeState.$silent.value && !fromParent) for (const rule of Object.values($rules.value)) rule.$parse();
 	}
 	function abortCommit() {
@@ -1579,8 +1595,8 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 		}
 		$value.value = $selfStatus.value.$value;
 		if (Array.isArray(state.value) && (!immediateScopeState.isPrimitiveArray.value || schemaMode)) $eachStatus.value = state.value.map((value, index) => {
-			const { scope: scope$1, unwrapped } = unwrapGetter(rulesDef.value.$each, toRef(() => value), index);
-			if (scope$1) collectionScopes.push(scope$1);
+			const { scope, unwrapped } = unwrapGetter(rulesDef.value.$each, toRef(() => value), index);
+			if (scope) collectionScopes.push(scope);
 			const initialStateRef = toRef(initialState.value ?? [], index);
 			const $externalErrors = toRef(externalErrors?.value ?? {}, `$each`);
 			const $schemaErrors = computed(() => schemaErrors?.value?.$each);
@@ -1639,8 +1655,8 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 					}
 					return null;
 				} else {
-					const { scope: scope$1, unwrapped } = unwrapGetter(rulesDef.value.$each, currentValue, index);
-					if (scope$1) collectionScopes.push(scope$1);
+					const { scope, unwrapped } = unwrapGetter(rulesDef.value.$each, currentValue, index);
+					if (scope) collectionScopes.push(scope);
 					const $externalErrors = toRef(externalErrors?.value ?? {}, `$each`);
 					const $schemaErrors = computed(() => schemaErrors?.value?.$each ?? []);
 					const element = createCollectionElement({
@@ -1791,8 +1807,8 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 			});
 			function processShortcuts() {
 				if (shortcuts?.collections) Object.entries(shortcuts?.collections).forEach(([key, value]) => {
-					const scope$1 = effectScope();
-					$shortcuts$1[key] = scope$1.run(() => {
+					const scope = effectScope();
+					$shortcuts[key] = scope.run(() => {
 						const result = ref();
 						watchEffect(() => {
 							result.value = value(reactive({
@@ -1820,10 +1836,10 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 						});
 						return result;
 					});
-					collectionScopes.push(scope$1);
+					collectionScopes.push(scope);
 				});
 			}
-			const $shortcuts$1 = {};
+			const $shortcuts = {};
 			processShortcuts();
 			return {
 				$dirty,
@@ -1836,7 +1852,7 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 				$silentErrors,
 				$ready,
 				$name,
-				$shortcuts: $shortcuts$1,
+				$shortcuts,
 				$silentValue,
 				$edited,
 				$anyEdited,
@@ -1868,24 +1884,24 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 			$each.$touch(runCommit, withConditions);
 		});
 	}
-	function $reset(options$1, fromParent) {
+	function $reset(options, fromParent) {
 		$unwatch();
-		if (!fromParent) if (options$1?.toOriginalState) {
+		if (!fromParent) if (options?.toOriginalState) {
 			state.value = cloneDeep(originalState);
 			initialState.value = cloneDeep(originalState);
-		} else if (options$1?.toInitialState) state.value = cloneDeep(initialState.value);
-		else if (options$1?.toState) {
+		} else if (options?.toInitialState) state.value = cloneDeep(initialState.value);
+		else if (options?.toState) {
 			let newInitialState;
-			if (typeof options$1?.toState === "function") newInitialState = options$1?.toState();
-			else newInitialState = options$1?.toState;
+			if (typeof options?.toState === "function") newInitialState = options?.toState();
+			else newInitialState = options?.toState;
 			initialState.value = cloneDeep(newInitialState);
 			state.value = cloneDeep(newInitialState);
 		} else initialState.value = cloneDeep(state.value);
-		if (options$1?.clearExternalErrors) $clearExternalErrors();
-		if (!options$1?.keepValidationState) {
-			$selfStatus.value.$reset(options$1, fromParent);
+		if (options?.clearExternalErrors) $clearExternalErrors();
+		if (!options?.keepValidationState) {
+			$selfStatus.value.$reset(options, fromParent);
 			$eachStatus.value.forEach(($each) => {
-				$each.$reset(options$1, true);
+				$each.$reset(options, true);
 			});
 		}
 		if (!fromParent) createStatus();
@@ -2239,8 +2255,8 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			});
 			function processShortcuts() {
 				if (commonArgs.shortcuts?.nested) Object.entries(commonArgs.shortcuts.nested).forEach(([key, value]) => {
-					const scope$1 = effectScope();
-					$shortcuts$1[key] = scope$1.run(() => {
+					const scope = effectScope();
+					$shortcuts[key] = scope.run(() => {
 						const result = ref();
 						watchEffect(() => {
 							result.value = value(reactive({
@@ -2269,7 +2285,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 						});
 						return result;
 					});
-					nestedScopes.push(scope$1);
+					nestedScopes.push(scope);
 				});
 			}
 			const $groups = computed({
@@ -2291,7 +2307,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				},
 				set() {}
 			});
-			const $shortcuts$1 = {};
+			const $shortcuts = {};
 			processShortcuts();
 			return {
 				$dirty,
@@ -2305,7 +2321,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				$silentErrors,
 				$ready,
 				$name,
-				$shortcuts: $shortcuts$1,
+				$shortcuts,
 				$groups,
 				$silentValue,
 				$edited,
@@ -2433,7 +2449,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 		...createStandardSchema($validate)
 	});
 	watchEffect(() => {
-		for (const key of Object.keys(fullStatus).filter((key$1) => !key$1.startsWith("$") && !key$1.startsWith("~"))) delete fullStatus[key];
+		for (const key of Object.keys(fullStatus).filter((key) => !key.startsWith("$") && !key.startsWith("~"))) delete fullStatus[key];
 		for (const field of Object.values($fields.value)) if (field?.$name) Object.assign(fullStatus, { [field.$name]: field });
 	});
 	return fullStatus;
@@ -2442,7 +2458,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 * Main resolver divider, will distribute the logic depending on the type of the current value (primitive, object, array)
 */
 function createReactiveChildrenStatus({ rulesDef, ...properties }) {
-	if (isCollectionRulesDef(rulesDef, properties.state, properties.schemaMode)) return createReactiveCollectionStatus({
+	if (isCollectionRulesDef(rulesDef, properties.state)) return createReactiveCollectionStatus({
 		rulesDef,
 		...properties
 	});
@@ -2818,9 +2834,9 @@ function buildInspectorState(nodeId, getInstance) {
 	const ruleInfo = parseRuleNodeId(nodeId);
 	if (ruleInfo) {
 		const { instanceId, fieldName, ruleName } = ruleInfo;
-		const instance$1 = getInstance(instanceId);
-		if (!instance$1 || !instance$1.r$.$fields) return null;
-		const fieldStatus = resolveFieldByPath(instance$1.r$.$fields, fieldName);
+		const instance = getInstance(instanceId);
+		if (!instance || !instance.r$.$fields) return null;
+		const fieldStatus = resolveFieldByPath(instance.r$.$fields, fieldName);
 		if (!fieldStatus || !("$rules" in fieldStatus)) return null;
 		const ruleStatus = fieldStatus.$rules[ruleName];
 		if (!ruleStatus) return null;
@@ -2829,9 +2845,9 @@ function buildInspectorState(nodeId, getInstance) {
 	const fieldInfo = parseFieldNodeId(nodeId);
 	if (fieldInfo) {
 		const { instanceId, fieldName } = fieldInfo;
-		const instance$1 = getInstance(instanceId);
-		if (!instance$1 || !instance$1.r$.$fields) return null;
-		const fieldStatus = resolveFieldByPath(instance$1.r$.$fields, fieldName);
+		const instance = getInstance(instanceId);
+		if (!instance || !instance.r$.$fields) return null;
+		const fieldStatus = resolveFieldByPath(instance.r$.$fields, fieldName);
 		if (!fieldStatus) return null;
 		return buildFieldState(fieldStatus);
 	}
@@ -3117,7 +3133,7 @@ function filterInspectorTree(nodes, filter) {
 	return filtered;
 }
 
-var version$1 = "1.18.0-beta.3";
+var version$1 = "1.18.0";
 
 function createDevtools(app) {
 	setupDevtoolsPlugin({
@@ -3318,18 +3334,18 @@ function createUseRegleComposable(options) {
 		clearExternalErrorsOnChange: modifiers?.clearExternalErrorsOnChange,
 		immediateDirty: modifiers?.immediateDirty
 	};
-	function useRegle$1(state, rulesFactory, options$1) {
+	function useRegle(state, rulesFactory, options) {
 		return { r$: createRootRegleLogic({
 			state: isRef(state) ? state : ref(state),
 			rulesFactory,
-			options: options$1,
+			options,
 			globalOptions,
 			customRules,
 			shortcuts,
 			overrides
 		}).regle };
 	}
-	return useRegle$1;
+	return useRegle;
 }
 /**
 * `useRegle` serves as the foundation for validation logic.
@@ -3367,10 +3383,10 @@ function createUseRegleComposable(options) {
 const useRegle = createUseRegleComposable();
 
 function createInferRuleHelper() {
-	function inferRules$1(state, rulesFactory) {
+	function inferRules(state, rulesFactory) {
 		return rulesFactory;
 	}
-	return inferRules$1;
+	return inferRules;
 }
 /**
 * Type helper to provide autocomplete and type-checking for your form rules.
@@ -3401,6 +3417,84 @@ function createInferRuleHelper() {
 */
 const inferRules = createInferRuleHelper();
 
+/**
+* Retrieves error messages for a specific field using a dot-notation path.
+* Provides type-safe access to nested error arrays in a Regle instance.
+*
+* @typeParam TRegle - The Regle instance type (root or status)
+* @typeParam TPath - The dot-notation path type, validated at compile-time
+*
+* @param r$ - The Regle instance (e.g., from `useRegle()`)
+* @param path - Dot-notation path to the field (e.g., `'user.email'` or `'items.0.name'`)
+* @returns Array of error strings for the field, or `undefined` if path doesn't exist
+*
+* @example
+* ```ts
+* import { getErrors, useRegle } from '@regle/core';
+* import { required, email } from '@regle/rules';
+*
+* const { r$ } = useRegle(
+*   { user: { email: '' } },
+*   { user: { email: { required, email } } }
+* );
+*
+* await r$.$validate();
+*
+* // Type-safe access to nested errors
+* const emailErrors = getErrors(r$, 'user.email');
+* // ['This field is required']
+*
+* // Works with collections too
+* const itemErrors = getErrors(r$, 'items.0.name');
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/displaying-errors#get-errors-by-path Documentation}
+*/
+function getErrors(r$, path) {
+	return getDotPath(unref(r$).$errors, String(path));
+}
+
+/**
+* Retrieves detailed validation issues for a specific field using a dot-notation path.
+* Issues contain more information than errors, including the rule name, property, and metadata.
+*
+* @typeParam TRegle - The Regle instance type (root or status)
+* @typeParam TPath - The dot-notation path type, validated at compile-time
+*
+* @param r$ - The Regle instance (e.g., from `useRegle()`)
+* @param path - Dot-notation path to the field (e.g., `'user.email'` or `'items.0.name'`)
+* @returns Array of `RegleFieldIssue` objects for the field, or `undefined` if path doesn't exist
+*
+* @example
+* ```ts
+* import { getIssues, useRegle } from '@regle/core';
+* import { required, email } from '@regle/rules';
+*
+* const { r$ } = useRegle(
+*   { user: { email: '' } },
+*   { user: { email: { required, email } } }
+* );
+*
+* await r$.$validate();
+*
+* // Type-safe access to nested issues with full metadata
+* const emailIssues = getIssues(r$, 'user.email');
+* // [{
+* //   $message: 'This field is required',
+* //   $property: 'email',
+* //   $rule: 'required'
+* // }]
+*
+* // Works with collections too
+* const itemIssues = getIssues(r$, 'items.0.name');
+* ```
+*
+* @see {@link https://reglejs.dev/core-concepts/displaying-errors#get-issues-by-path Documentation}
+*/
+function getIssues(r$, path) {
+	return getDotPath(unref(r$).$issues, String(path));
+}
+
 function createEmptyRuleState(rules) {
 	const result = {};
 	if (Object.entries(rules).some(([_, rule]) => isRuleDef(rule) || typeof rule === "function")) return null;
@@ -3422,19 +3516,19 @@ function createUseRulesComposable(options) {
 		clearExternalErrorsOnChange: modifiers?.clearExternalErrorsOnChange,
 		immediateDirty: modifiers?.immediateDirty
 	};
-	function useRules$1(rulesFactory, options$1) {
+	function useRules(rulesFactory, options) {
 		const definedRules = isRef(rulesFactory) ? rulesFactory : typeof rulesFactory === "function" ? void 0 : computed(() => rulesFactory);
 		return createRootRegleLogic({
 			state: ref(createEmptyRuleState(definedRules?.value)),
 			rulesFactory: definedRules,
-			options: options$1,
+			options,
 			globalOptions,
 			customRules,
 			shortcuts,
 			overrides
 		}).regle;
 	}
-	return useRules$1;
+	return useRules;
 }
 /**
 * `useRules` is a variant of `useRegle` that doesn't require you to provide initial state.
@@ -3534,34 +3628,34 @@ function applyMarkStatic(value) {
 * @see {@link https://reglejs.dev/advanced-usage/global-config Documentation}
 */
 function defineRegleConfig({ rules, modifiers, shortcuts, overrides }) {
-	const useRegle$1 = createUseRegleComposable({
+	const useRegle = createUseRegleComposable({
 		rules,
 		modifiers,
 		shortcuts,
 		overrides
 	});
-	const useRules$1 = createUseRulesComposable({
+	const useRules = createUseRulesComposable({
 		rules,
 		modifiers,
 		shortcuts,
 		overrides
 	});
-	useRegle$1.__config = {
+	useRegle.__config = {
 		rules,
 		modifiers,
 		shortcuts,
 		overrides
 	};
-	useRules$1.__config = {
+	useRules.__config = {
 		rules,
 		modifiers,
 		shortcuts,
 		overrides
 	};
 	return {
-		useRegle: useRegle$1,
+		useRegle,
 		inferRules: createInferRuleHelper(),
-		useRules: useRules$1
+		useRules
 	};
 }
 /**
@@ -3600,20 +3694,20 @@ function extendRegleConfig(regle, { rules, modifiers, shortcuts, overrides }) {
 	const newModifiers = rootConfig.modifiers && modifiers ? merge(rootConfig.modifiers, modifiers) : rootConfig.modifiers ?? modifiers;
 	const newShortcuts = rootConfig.shortcuts && shortcuts ? merge(rootConfig.shortcuts, shortcuts) : rootConfig.shortcuts ?? shortcuts;
 	const newOverrides = rootConfig.overrides && overrides ? merge(rootConfig.overrides, overrides) : rootConfig.overrides ?? overrides;
-	const useRegle$1 = createUseRegleComposable({
+	const useRegle = createUseRegleComposable({
 		rules: newRules,
 		modifiers: newModifiers,
 		shortcuts: newShortcuts,
 		overrides: newOverrides
 	});
-	useRegle$1.__config = {
+	useRegle.__config = {
 		rules: newRules,
 		modifiers: newModifiers,
 		shortcuts: newShortcuts,
 		overrides: newOverrides
 	};
 	return {
-		useRegle: useRegle$1,
+		useRegle,
 		inferRules: createInferRuleHelper()
 	};
 }
@@ -3827,14 +3921,14 @@ function mergeRegles(regles, _scoped) {
 	});
 	watchEffect(() => {
 		if (scoped) return;
-		for (const key of Object.keys(fullStatus).filter((key$1) => !key$1.startsWith("$") && !key$1.startsWith("~"))) delete fullStatus[key];
+		for (const key of Object.keys(fullStatus).filter((key) => !key.startsWith("$") && !key.startsWith("~"))) delete fullStatus[key];
 		for (const [key, field] of Object.entries($instances.value)) Object.assign(fullStatus, { [key]: field });
 	});
 	return fullStatus;
 }
 
 function createUseCollectScope(instances, options) {
-	function useCollectScope$1(namespace) {
+	function useCollectScope(namespace) {
 		const computedNamespace = computed(() => toValue(namespace));
 		const namespaceInstances = reactive({});
 		setEmptyNamespace();
@@ -3843,8 +3937,8 @@ function createUseCollectScope(instances, options) {
 		function setEmptyNamespace() {
 			if (computedNamespace.value) {
 				if (typeof computedNamespace.value === "string" && !instances.value[computedNamespace.value]) instances.value[computedNamespace.value] = {};
-				else if (Array.isArray(computedNamespace.value)) computedNamespace.value.forEach((namespace$1) => {
-					if (!instances.value[namespace$1]) instances.value[namespace$1] = {};
+				else if (Array.isArray(computedNamespace.value)) computedNamespace.value.forEach((namespace) => {
+					if (!instances.value[namespace]) instances.value[namespace] = {};
 				});
 			}
 		}
@@ -3858,9 +3952,9 @@ function createUseCollectScope(instances, options) {
 				Object.keys(namespaceInstances).forEach((key) => {
 					delete namespaceInstances[key];
 				});
-				computedNamespace.value.forEach((namespace$1) => {
-					Object.entries(r$Instances[namespace$1]).forEach(([key, regle$1]) => {
-						Object.assign(namespaceInstances, { [key]: regle$1 });
+				computedNamespace.value.forEach((namespace) => {
+					Object.entries(r$Instances[namespace]).forEach(([key, regle]) => {
+						Object.assign(namespaceInstances, { [key]: regle });
 					});
 				});
 				return mergeRegles(namespaceInstances, !options.asRecord);
@@ -3869,12 +3963,12 @@ function createUseCollectScope(instances, options) {
 		}
 		return { r$: regle.r$ };
 	}
-	return { useCollectScope: useCollectScope$1 };
+	return { useCollectScope };
 }
 
 function createUseScopedRegleComposable(instances, customUseRegle) {
 	const scopedUseRegle = customUseRegle ?? useRegle;
-	const useScopedRegle$1 = ((state, rulesFactory, options) => {
+	const useScopedRegle = ((state, rulesFactory, options) => {
 		const { namespace, scopeKey, id, ...restOptions } = options ?? {};
 		scopedUseRegle.__config ??= {};
 		const computedScopeId = computed(() => id ?? scopeKey);
@@ -3920,7 +4014,7 @@ function createUseScopedRegleComposable(instances, customUseRegle) {
 			register
 		};
 	});
-	return { useScopedRegle: useScopedRegle$1 };
+	return { useScopedRegle };
 }
 
 /**
@@ -3962,11 +4056,11 @@ function createScopedUseRegle(options) {
 	} : createGlobalState(() => {
 		return ref({ "~~global": {} });
 	}))();
-	const { useScopedRegle: useScopedRegle$1 } = createUseScopedRegleComposable(instances, options?.customUseRegle);
-	const { useCollectScope: useCollectScope$1 } = createUseCollectScope(instances, { asRecord: options?.asRecord });
+	const { useScopedRegle } = createUseScopedRegleComposable(instances, options?.customUseRegle);
+	const { useCollectScope } = createUseCollectScope(instances, { asRecord: options?.asRecord });
 	return {
-		useScopedRegle: useScopedRegle$1,
-		useCollectScope: useCollectScope$1
+		useScopedRegle,
+		useCollectScope
 	};
 }
 const { useCollectScope: _useCollectScope, useScopedRegle: _useScopedRegle } = createScopedUseRegle();
@@ -4203,4 +4297,4 @@ const RegleVuePlugin = { install(app) {
 	if (typeof window !== "undefined" && true) createDevtools(app);
 } };
 
-export { InternalRuleType, RegleVuePlugin, createRule, createScopedUseRegle, createVariant, defineRegleConfig, defineRules, extendRegleConfig, flatErrors, inferRules, markStatic, mergeRegles, narrowVariant, refineRules, unwrapRuleParameters, useCollectScope, useRegle, useRootStorage, useRules, useScopedRegle, variantToRef };
+export { InternalRuleType, RegleVuePlugin, createRule, createScopedUseRegle, createVariant, defineRegleConfig, defineRules, extendRegleConfig, flatErrors, getErrors, getIssues, inferRules, markStatic, mergeRegles, narrowVariant, refineRules, unwrapRuleParameters, useCollectScope, useRegle, useRootStorage, useRules, useScopedRegle, variantToRef };