@regle/core 1.26.1 → 1.27.0-beta.2

package/dist/regle-core.js

@@ -1,5 +1,5 @@
 /**
- * @regle/core v1.26.1
+ * @regle/core v1.27.0-beta.2
  * (c) 2026 Victor Garcia
  * @license MIT
  */
@@ -759,7 +759,6 @@ const REGLE_FLAGS = { REGLE_STATIC: "__regle_static" };
 function isRegleDevtoolsTestEnv() {
 	return Boolean(typeof globalThis !== "undefined" && ("__vitest_worker__" in globalThis || "__JEST_GLOBAL__" in globalThis || typeof window !== "undefined" && "Cypress" in window || typeof process !== "undefined" && process.env && (process.env.VITEST || process.env.JEST_WORKER_ID || process.env.NODE_ENV === "test" || process.env.PLAYWRIGHT_TEST)));
 }
-/*#__PURE__*/
 function useRegleDevtoolsRegistry() {
 	const loggedWarning = ref(false);
 	const devtoolsApi = shallowRef();
@@ -767,6 +766,7 @@ function useRegleDevtoolsRegistry() {
 	const watchers = shallowRef(/* @__PURE__ */ new Map());
 	const idCounters = shallowRef(/* @__PURE__ */ new Map());
 	const looseIdCounter = ref(0);
+	let pendingNotifyFrame;
 	function setApi(api) {
 		devtoolsApi.value = api;
 	}
@@ -784,11 +784,17 @@ function useRegleDevtoolsRegistry() {
 			componentName: options?.componentName,
 			filePath: options?.filePath
 		});
-		const stopHandle = watch(() => r$, () => notifyDevtools(), {
+		const stopHandle = watch([
+			() => r$.$value,
+			() => r$.$errors,
+			() => r$.$externalErrors,
+			() => r$.$issues,
+			() => r$.$externalIssues
+		], () => scheduleNotifyDevtools(), {
 			deep: true,
 			flush: "post"
 		});
-		regleDevtoolsRegistry.addWatcher(id, stopHandle);
+		watchers.value.set(id, stopHandle);
 		window.requestAnimationFrame(() => {
 			notifyDevtools();
 		});
@@ -797,6 +803,13 @@ function useRegleDevtoolsRegistry() {
 	function notifyDevtools() {
 		if (devtoolsApi.value) emitInspectorState(devtoolsApi.value);
 	}
+	function scheduleNotifyDevtools() {
+		if (pendingNotifyFrame != null) return;
+		pendingNotifyFrame = window.requestAnimationFrame(() => {
+			pendingNotifyFrame = void 0;
+			notifyDevtools();
+		});
+	}
 	function unregister(id) {
 		const watcher = watchers.value.get(id);
 		if (watcher) {
@@ -818,9 +831,6 @@ function useRegleDevtoolsRegistry() {
 		instances.value.clear();
 		notifyDevtools();
 	}
-	function addWatcher(id, stopHandle) {
-		watchers.value.set(id, stopHandle);
-	}
 	return {
 		devtoolsApi,
 		register,
@@ -828,13 +838,11 @@ function useRegleDevtoolsRegistry() {
 		getAll,
 		get,
 		clear,
-		addWatcher,
 		setApi,
 		notifyDevtools,
 		loggedWarning
 	};
 }
-/*#__PURE__*/
 const regleDevtoolsRegistry = useRegleDevtoolsRegistry();
 /**
 * To be used by `useRegle` like composables.
@@ -1127,7 +1135,10 @@ function handleEditInspectorState(payload) {
 	const instance = regleDevtoolsRegistry.get(instanceId);
 	if (instance && instance.r$.$fields) {
 		const fieldStatus = resolveFieldByPath(instance.r$.$fields, fieldPath);
-		if (fieldStatus && "$value" in fieldStatus) fieldStatus.$value = state.value;
+		if (fieldStatus && "$value" in fieldStatus) {
+			fieldStatus.$value = state.value;
+			regleDevtoolsRegistry.notifyDevtools();
+		}
 	}
 }
 async function emitInspectorState(api) {
@@ -1357,7 +1368,7 @@ function filterInspectorTree(nodes, filter) {
 	}
 	return filtered;
 }
-var version$1 = "1.26.1";
+var version$1 = "1.27.0-beta.2";
 function createDevtools(app) {
 	setupDevtoolsPlugin({
 		id: "regle-devtools",
@@ -1545,15 +1556,18 @@ function useStorage() {
 			};
 		}
 	}
-	if (getCurrentScope()) onScopeDispose(() => {
+	function clearAll() {
 		ruleDeclStorage.value.clear();
 		fieldsStorage.value.clear();
 		collectionsStorage.value.clear();
 		dirtyStorage.value.clear();
 		ruleStatusStorage.value.clear();
+		additionalRulesStorage.value.clear();
 		arrayStatusStorage.value.clear();
-	});
+	}
+	if (getCurrentScope()) onScopeDispose(clearAll);
 	return {
+		clearAll,
 		addRuleDeclEntry,
 		setDirtyEntry,
 		checkRuleDeclEntry,
@@ -1590,17 +1604,23 @@ function extractRulesIssues({ field, silent = false }) {
 		})));
 		return acc;
 	}, []);
-	const externalIssues = field.$error && field.$externalErrors && Array.isArray(field.$externalErrors) ? field.$externalErrors.map((error) => ({
+	const externalErrorIssues = field.$error && field.$externalErrors && Array.isArray(field.$externalErrors) && !field.$externalIssues?.length ? field.$externalErrors.map((error) => ({
 		$message: error,
 		$property: field.fieldName,
 		$rule: "external",
 		$type: void 0
 	})) : [];
+	const externalIssues = field.$error && field.$externalIssues && Array.isArray(field.$externalIssues) ? field.$externalIssues.map((issue) => ({
+		...issue,
+		$property: issue.$property ?? field.fieldName,
+		$rule: issue.$rule ?? "external"
+	})) : [];
 	let schemaIssues = [];
 	if (field.$schemaErrors && field.$error) if (!Array.isArray(field.$schemaErrors) && "$self" in field.$schemaErrors) schemaIssues = field.$schemaErrors.$self ?? [];
 	else schemaIssues = field.$schemaErrors ?? [];
 	return [
 		...ruleIssues,
+		...externalErrorIssues,
 		...externalIssues,
 		...schemaIssues
 	];
@@ -1891,7 +1911,7 @@ function shouldApplyFieldImmediateDirty(mode, value, rootValue, isRootField = fa
 	return false;
 }
 const DEFAULT_DEBOUNCE_TIME = 200;
-function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cachePath, fieldName, storage, options, externalErrors, schemaErrors, schemaMode, onUnwatch, $isArray, initialState, rootInitialState, originalState, shortcuts, overrides, onValidate }) {
+function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cachePath, fieldName, storage, options, externalErrors, externalIssues, schemaErrors, schemaMode, onUnwatch, $isArray, initialState, rootInitialState, originalState, shortcuts, overrides, onValidate }) {
 	let scope = effectScope();
 	let scopeState;
 	let fieldScopes = [];
@@ -2074,6 +2094,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 					$rules: $rules.value,
 					$error: $error.value,
 					$externalErrors: externalErrors?.value,
+					$externalIssues: externalIssues?.value,
 					$schemaErrors: schemaErrors?.value,
 					fieldName: $name.value
 				} });
@@ -2084,6 +2105,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 						$rules: $rules.value,
 						$error: $error.value,
 						$externalErrors: externalErrors?.value,
+						$externalIssues: externalIssues?.value,
 						$schemaErrors: schemaErrors?.value,
 						fieldName: $name.value
 					},
@@ -2122,7 +2144,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				return false;
 			});
 			const $invalid = computed(() => {
-				if (externalErrors?.value?.length || schemaErrors?.value?.length) return true;
+				if (externalErrors?.value?.length || externalIssues?.value?.length || schemaErrors?.value?.length) return true;
 				else if ($inactive.value) return false;
 				else return Object.values($rules.value).some((ruleResult) => !ruleResult.$valid || ruleResult.$maybePending);
 			});
@@ -2131,7 +2153,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				return !schemaMode && !Object.keys($rules.value).some((key) => !key.startsWith("$"));
 			});
 			const $correct = computed(() => {
-				if (externalErrors?.value?.length) return false;
+				if (externalErrors?.value?.length || externalIssues?.value?.length) return false;
 				else if ($inactive.value) return false;
 				else if ($isDebouncing.value) return false;
 				else if ($dirty.value && !isEmpty(state.value) && !$validating.value && !$pending.value) if (schemaMode) return !schemaErrors?.value?.length;
@@ -2170,6 +2192,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 							result.value = value(reactive({
 								$dirty,
 								$externalErrors: externalErrors?.value ?? [],
+								$externalIssues: externalIssues?.value ?? [],
 								$value: state,
 								$silentValue,
 								$rules,
@@ -2258,7 +2281,10 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 			}
 			if (rulesDef.value instanceof Function) createReactiveRulesResult();
 			if (!scopeState.$silent.value || scopeState.$rewardEarly.value && scopeState.$error.value) $commit();
-			if (scopeState.$clearExternalErrorsOnChange.value) $clearExternalErrors();
+			if (scopeState.$clearExternalErrorsOnChange.value) {
+				$clearExternalErrors();
+				$clearExternalIssues();
+			}
 		}, { deep: scopeState.$isArrayOrRegleStatic.value ? true : isVueSuperiorOrEqualTo3dotFive ? 1 : true });
 	}
 	async function $commitHandler() {
@@ -2276,6 +2302,7 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 	function $reset(options, fromParent) {
 		abortCommit();
 		$clearExternalErrors();
+		$clearExternalIssues();
 		scopeState.$dirty.value = false;
 		storage.setDirtyEntry(cachePath, false);
 		if (!fromParent) if (options?.toOriginalState) {
@@ -2289,7 +2316,10 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 			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?.clearExternalErrors) $clearExternalErrors();
+		if (options?.clearExternalErrors) {
+			$clearExternalErrors();
+			$clearExternalIssues();
+		}
 		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();
 		applyImmediateDirty();
@@ -2337,6 +2367,10 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 				issues: scopeState.$issues.value
 			};
 			const data = state.value;
+			if (scopeState.$clearExternalErrorsOnValidate.value) {
+				$clearExternalErrors();
+				$clearExternalIssues();
+			}
 			if (scopeState.$autoDirty.value && !scopeState.$silent.value && scopeState.$dirty.value && !scopeState.$validating.value && !scopeState.$pending.value && !$isDebouncing.value && !isEmpty($rules.value)) return {
 				valid: !scopeState.$invalid.value,
 				data,
@@ -2380,6 +2414,10 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 			if (forceValues) state.value = forceValues;
 			if (!scopeState.$dirty.value) scopeState.$dirty.value = true;
 			if (schemaMode) return false;
+			if (scopeState.$clearExternalErrorsOnValidate.value) {
+				$clearExternalErrors();
+				$clearExternalIssues();
+			}
 			return Object.values($rules.value).map((rule) => rule.$parseSync()).every((result) => !!result);
 		} catch {
 			return false;
@@ -2392,16 +2430,25 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 	}
 	function $setExternalErrors(errors) {
 		if (externalErrors) externalErrors.value = errors;
+		$clearExternalIssues();
 	}
 	function $clearExternalErrors() {
 		if (externalErrors?.value?.length) externalErrors.value = [];
 	}
+	function $setExternalIssues(issues) {
+		if (externalIssues) externalIssues.value = issues;
+		$clearExternalErrors();
+	}
+	function $clearExternalIssues() {
+		if (externalIssues?.value?.length) externalIssues.value = [];
+	}
 	if (!scopeState.$lazy.value && !scopeState.$dirty.value && !scopeState.$silent.value) $commitHandler();
 	applyImmediateDirty();
 	const { $shortcuts, $validating, $autoDirty, $rewardEarly, $clearExternalErrorsOnChange, $clearExternalErrorsOnValidate, $haveAnyAsyncRule, $debounce, $lazy, ...restScope } = scopeState;
 	const fullStatus = reactive({
 		...restScope,
 		$externalErrors: externalErrors,
+		$externalIssues: externalIssues,
 		$value: state,
 		$output: state,
 		$initialValue: initialState,
@@ -2419,18 +2466,20 @@ function createReactiveFieldStatus({ state, rulesDef, customMessages, path, cach
 		$watch,
 		$extractDirtyFields,
 		$clearExternalErrors,
+		$clearExternalIssues,
 		$abort,
 		$addRules,
 		addRules,
 		$schemaMode: schemaMode,
 		"~modifiers": scopeState.$modifiers,
 		$setExternalErrors,
+		$setExternalIssues,
 		...createStandardSchema($validate)
 	});
 	Object.defineProperty(fullStatus, Symbol.for("regle:instance"), { value: true });
 	return fullStatus;
 }
-function createCollectionElement({ $id, path, cachePath, index, options, storage, stateValue, customMessages, rules, externalErrors, schemaErrors, initialState, originalState, shortcuts, fieldName, schemaMode, overrides, currentIndexes }) {
+function createCollectionElement({ $id, path, cachePath, index, options, storage, stateValue, customMessages, rules, externalErrors, externalIssues, schemaErrors, initialState, originalState, shortcuts, fieldName, schemaMode, overrides, currentIndexes }) {
 	const computedRules = computed(() => toValue(rules));
 	const $fieldId = stateValue.value?.$id ?? computedRules.value.$key ?? randomId();
 	let $cachePath = `${cachePath}.${String($fieldId)}`;
@@ -2455,6 +2504,7 @@ function createCollectionElement({ $id, path, cachePath, index, options, storage
 		storage,
 		options,
 		externalErrors: toRef(externalErrors?.value ?? [], index),
+		externalIssues: toRef(externalIssues?.value ?? [], index),
 		schemaErrors: computed(() => schemaErrors?.value?.[currentIndex.value]),
 		initialState,
 		originalState,
@@ -2471,7 +2521,7 @@ function createCollectionElement({ $id, path, cachePath, index, options, storage
 	if (stateValue.value && (!isObject(stateValue.value) || isStatic(stateValue.value)) && schemaMode) $status?.$touch();
 	return $status;
 }
-function createReactiveCollectionStatus({ state, rulesDef, customMessages, path, cachePath, storage, options, externalErrors, schemaErrors, schemaMode, initialState, originalState, shortcuts, fieldName, overrides }) {
+function createReactiveCollectionStatus({ state, rulesDef, customMessages, path, cachePath, storage, options, externalErrors, externalIssues, schemaErrors, schemaMode, initialState, originalState, shortcuts, fieldName, overrides }) {
 	let scope = effectScope();
 	let scopeState;
 	let immediateScope = effectScope();
@@ -2515,6 +2565,7 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 			if (scope) collectionScopes.push(scope);
 			const initialStateRef = toRef(initialState.value ?? [], index);
 			const $externalErrors = toRef(externalErrors?.value ?? {}, `$each`);
+			const $externalIssues = toRef(externalIssues?.value ?? {}, `$each`);
 			const $schemaErrors = computed(() => schemaErrors?.value?.$each);
 			const element = createCollectionElement({
 				$id: $id.value,
@@ -2527,6 +2578,7 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 				options,
 				storage,
 				externalErrors: $externalErrors,
+				externalIssues: $externalIssues,
 				schemaErrors: $schemaErrors,
 				initialState: initialStateRef,
 				originalState,
@@ -2552,6 +2604,7 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 			storage,
 			options,
 			externalErrors: toRef(externalErrors?.value ?? {}, `$self`),
+			externalIssues: toRef(externalIssues?.value ?? {}, `$self`),
 			schemaErrors: computed(() => schemaErrors?.value?.$self),
 			$isArray: true,
 			initialState,
@@ -2582,6 +2635,7 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 					const { scope, unwrapped } = unwrapGetter(rulesDef.value.$each, currentValue, index);
 					if (scope) collectionScopes.push(scope);
 					const $externalErrors = toRef(externalErrors?.value ?? {}, `$each`);
+					const $externalIssues = toRef(externalIssues?.value ?? {}, `$each`);
 					const $schemaErrors = computed(() => schemaErrors?.value?.$each ?? []);
 					const element = createCollectionElement({
 						$id: $id.value,
@@ -2594,6 +2648,7 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 						options,
 						storage,
 						externalErrors: $externalErrors,
+						externalIssues: $externalIssues,
 						schemaErrors: $schemaErrors,
 						initialState: toRef(initialState.value ?? [], index),
 						originalState,
@@ -2854,7 +2909,10 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 			initialState.value = cloneDeep(newInitialState);
 			state.value = cloneDeep(newInitialState);
 		} else initialState.value = cloneDeep(state.value);
-		if (options?.clearExternalErrors) $clearExternalErrors();
+		if (options?.clearExternalErrors) {
+			$clearExternalErrors();
+			$clearExternalIssues();
+		}
 		if (!options?.keepValidationState) {
 			$selfStatus.value.$reset(options, fromParent);
 			$eachStatus.value.forEach(($each) => {
@@ -2915,7 +2973,8 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 		}
 	}
 	function $setExternalErrors(errors) {
-		if (externalErrors?.value) externalErrors.value = errors;
+		if (externalErrors) externalErrors.value = errors;
+		$clearExternalIssues();
 	}
 	function $clearExternalErrors() {
 		$selfStatus.value.$clearExternalErrors();
@@ -2923,6 +2982,16 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 			$each.$clearExternalErrors();
 		});
 	}
+	function $setExternalIssues(issues) {
+		if (externalIssues) externalIssues.value = issues;
+		$clearExternalErrors();
+	}
+	function $clearExternalIssues() {
+		$selfStatus.value.$clearExternalIssues();
+		$eachStatus.value.forEach(($each) => {
+			$each.$clearExternalIssues();
+		});
+	}
 	function $extractDirtyFields(filterNullishValues = true) {
 		let dirtyFields = $eachStatus.value.map(($each) => {
 			if (isNestedRulesStatus($each)) return $each.$extractDirtyFields(filterNullishValues);
@@ -2955,20 +3024,22 @@ function createReactiveCollectionStatus({ state, rulesDef, customMessages, path,
 		$abort,
 		$extractDirtyFields,
 		$clearExternalErrors,
+		$clearExternalIssues,
 		$setExternalErrors,
+		$setExternalIssues,
 		"~modifiers": scopeState.$modifiers,
 		...createStandardSchema($validate)
 	});
 }
-function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, rootRules, externalErrors, schemaErrors, rootInitialState, rootSchemaErrors, validationGroups, initialState, originalState, fieldName, nestedReactiveRules, ...commonArgs }) {
+function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, rootRules, externalErrors, externalIssues, schemaErrors, rootInitialState, rootSchemaErrors, validationGroups, initialState, originalState, fieldName, nestedReactiveRules, ...commonArgs }) {
 	let scope = effectScope();
 	let scopeState;
 	let nestedScopes = [];
 	let $unwatchRules = null;
 	let $unwatchSchemaErrors = null;
 	let $unwatchExternalErrors = null;
+	let $unwatchExternalIssues = null;
 	let $unwatchState = null;
-	let $unwatchGroups = null;
 	const $selfStatus = ref(void 0);
 	async function createReactiveFieldsStatus(watchSources = true) {
 		const mapOfRulesDef = Object.entries(rulesDef.value).filter(([key]) => key !== "$self");
@@ -2977,6 +3048,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			const stateRef = toRef(state.value ?? {}, statePropKey);
 			const statePropRulesRef = toRef(() => statePropRules);
 			const $externalErrors = toRef(externalErrors?.value ?? {}, statePropKey);
+			const $externalIssues = toRef(externalIssues?.value ?? {}, statePropKey);
 			const $schemaErrors = computed(() => schemaErrors?.value?.[statePropKey]);
 			const initialStateRef = toRef(initialState?.value ?? {}, statePropKey);
 			acc.push([statePropKey, createReactiveChildrenStatus({
@@ -2985,6 +3057,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				path: path ? `${path}.${statePropKey}` : statePropKey,
 				cachePath: cachePath ? `${cachePath}.${statePropKey}` : statePropKey,
 				externalErrors: $externalErrors,
+				externalIssues: $externalIssues,
 				schemaErrors: $schemaErrors,
 				initialState: initialStateRef,
 				originalState: originalState?.[statePropKey],
@@ -2993,9 +3066,10 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			})]);
 			return acc;
 		}, []));
-		const externalRulesStatus = Object.fromEntries(Object.entries(toValue(externalErrors) ?? {}).filter(([key, errors]) => !(key in rulesDef.value) && !!errors).map(([key]) => {
+		const externalRulesStatus = Object.fromEntries(Array.from(new Set([...Object.keys(toValue(externalErrors) ?? {}), ...Object.keys(toValue(externalIssues) ?? {})])).filter((key) => !(key in rulesDef.value)).map((key) => {
 			const stateRef = toRef(state.value ?? {}, key);
 			const $externalErrors = toRef(externalErrors?.value ?? {}, key);
+			const $externalIssues = toRef(externalIssues?.value ?? {}, key);
 			const $schemaErrors = computed(() => schemaErrors?.value?.[key]);
 			const initialStateRef = toRef(initialState?.value ?? {}, key);
 			const computedPath = path ? `${path}.${key}` : key;
@@ -3006,6 +3080,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				path: computedPath,
 				cachePath: computedCachePath,
 				externalErrors: $externalErrors,
+				externalIssues: $externalIssues,
 				schemaErrors: $schemaErrors,
 				initialState: initialStateRef,
 				originalState: originalState?.[key],
@@ -3018,6 +3093,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			const computedCachePath = cachePath ? `${cachePath}.${key}` : key;
 			const stateRef = toRef(state.value ?? {}, key);
 			const $externalErrors = toRef(externalErrors?.value ?? {}, key);
+			const $externalIssues = toRef(externalIssues?.value ?? {}, key);
 			const $schemaErrors = computed(() => schemaErrors?.value?.[key]);
 			const initialStateRef = toRef(initialState?.value ?? {}, key);
 			return [key, createReactiveChildrenStatus({
@@ -3026,6 +3102,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				path: computedPath,
 				cachePath: computedCachePath,
 				externalErrors: $externalErrors,
+				externalIssues: $externalIssues,
 				schemaErrors: $schemaErrors,
 				initialState: initialStateRef,
 				originalState: originalState?.[key],
@@ -3036,6 +3113,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 		const statesWithNoRules = Object.fromEntries(Object.entries(state.value ?? {}).filter(([key]) => !(key in rulesDef.value) && !(key in (externalRulesStatus ?? {})) && !(key in (schemasRulesStatus ?? {}))).map(([key]) => {
 			const stateRef = toRef(state.value ?? {}, key);
 			const $externalErrors = toRef(externalErrors?.value ?? {}, key);
+			const $externalIssues = toRef(externalIssues?.value ?? {}, key);
 			const $schemaErrors = computed(() => schemaErrors?.value?.[key]);
 			const initialStateRef = toRef(initialState?.value ?? {}, key);
 			return [key, createReactiveChildrenStatus({
@@ -3044,6 +3122,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				path: path ? `${path}.${key}` : key,
 				cachePath: cachePath ? `${cachePath}.${key}` : key,
 				externalErrors: $externalErrors,
+				externalIssues: $externalIssues,
 				schemaErrors: $schemaErrors,
 				initialState: initialStateRef,
 				originalState: originalState?.[key],
@@ -3066,9 +3145,10 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			path,
 			cachePath,
 			externalErrors: ref(void 0),
+			externalIssues: ref(void 0),
 			schemaErrors: ref(void 0),
-			initialState: toRef(initialState?.value ?? {}, `$self`),
-			originalState: originalState?.[`$self`],
+			initialState: initialState ?? ref(void 0),
+			originalState,
 			fieldName: `$self`,
 			...commonArgs
 		});
@@ -3082,11 +3162,21 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			createReactiveFieldsStatus();
 		}, { deep: true });
 	}
+	function define$WatchExternalIssues() {
+		if (externalIssues) $unwatchExternalIssues = watch(externalIssues, () => {
+			$unwatch();
+			createReactiveFieldsStatus();
+		}, { deep: true });
+	}
 	function define$watchState() {
 		$unwatchState = watch(state, () => {
 			$unwatch();
 			createReactiveFieldsStatus();
 			if (scopeState.$autoDirty.value && !scopeState.$silent.value) $touch(false, true);
+			if (scopeState.$clearExternalErrorsOnChange.value) {
+				$clearExternalErrors();
+				$clearExternalIssues();
+			}
 		}, { flush: "post" });
 	}
 	function $watch() {
@@ -3100,6 +3190,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				flush: "pre"
 			});
 			define$WatchExternalErrors();
+			define$WatchExternalIssues();
 		}
 		if (rootSchemaErrors) {
 			$unwatchSchemaErrors?.();
@@ -3117,6 +3208,10 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 					state.value = value;
 					createReactiveFieldsStatus();
 					if (scopeState.$autoDirty.value && !scopeState.$silent.value) $touch(false, true);
+					if (scopeState.$clearExternalErrorsOnChange.value) {
+						$clearExternalErrors();
+						$clearExternalIssues();
+					}
 				}
 			});
 			const $output = readonly($value);
@@ -3196,7 +3291,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			});
 			const $clearExternalErrorsOnChange = computed(() => {
 				if (toValue(commonArgs.options.clearExternalErrorsOnChange) != null) return toValue(commonArgs.options.clearExternalErrorsOnChange) === true;
-				return false;
+				return true;
 			});
 			const $clearExternalErrorsOnValidate = computed(() => {
 				if (toValue(commonArgs.options.clearExternalErrorsOnValidate) != null) return toValue(commonArgs.options.clearExternalErrorsOnValidate) === true;
@@ -3321,6 +3416,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 				$errors,
 				$silentErrors,
 				$clearExternalErrorsOnValidate,
+				$clearExternalErrorsOnChange,
 				$ready,
 				$name,
 				$shortcuts,
@@ -3341,19 +3437,28 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 	function $unwatch() {
 		$unwatchRules?.();
 		$unwatchExternalErrors?.();
+		$unwatchExternalIssues?.();
 		$unwatchState?.();
-		$unwatchGroups?.();
 		$unwatchSchemaErrors?.();
+		nestedScopes.forEach((s) => s.stop());
 		nestedScopes = [];
 		scopeState = {};
 		if ($fields.value) for (const field of Object.values($fields.value)) field?.$unwatch();
 	}
 	function $setExternalErrors(errors) {
 		if (externalErrors) externalErrors.value = errors;
+		$clearExternalIssues();
 	}
 	function $clearExternalErrors() {
 		if (externalErrors && !isEmpty(externalErrors.value)) externalErrors.value = {};
 	}
+	function $setExternalIssues(issues) {
+		if (externalIssues) externalIssues.value = issues;
+		$clearExternalErrors();
+	}
+	function $clearExternalIssues() {
+		if (externalIssues && !isEmpty(externalIssues.value)) externalIssues.value = {};
+	}
 	function applyImmediateDirty() {
 		if (!scopeState) return;
 		if (scopeState.$immediateDirty.value !== "lazy-non-empty" && shouldApplyImmediateDirty(scopeState.$immediateDirty.value, initialState.value, rootInitialState?.value ?? initialState.value)) $touch(true, false);
@@ -3376,8 +3481,12 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			for (const field of Object.values($fields.value)) field?.$reset(options, true);
 			$selfStatus.value?.$reset(options, true);
 		}
-		if (options?.clearExternalErrors === false) $clearExternalErrors();
+		if (options?.clearExternalErrors === false) {
+			$clearExternalErrors();
+			$clearExternalIssues();
+		}
 		define$WatchExternalErrors();
+		define$WatchExternalIssues();
 		if (!fromParent) {
 			createReactiveFieldsStatus();
 			applyImmediateDirty();
@@ -3426,7 +3535,10 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 			else {
 				const data = state.value;
 				$abort();
-				if (scopeState.$clearExternalErrorsOnValidate.value) $clearExternalErrors();
+				if (scopeState.$clearExternalErrorsOnValidate.value) {
+					$clearExternalErrors();
+					$clearExternalIssues();
+				}
 				const validatePromises = [...Object.values($fields.value).map((statusOrField) => statusOrField.$validateWithoutRaceconditions()), ...$selfStatus.value ? [$selfStatus.value?.$validateWithoutRaceconditions()] : []];
 				return {
 					valid: (await Promise.allSettled(validatePromises)).every((value) => value.status === "fulfilled" && value?.value?.valid === true),
@@ -3455,7 +3567,10 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 	function $validateSync(forceValues) {
 		try {
 			if (forceValues) state.value = forceValues;
-			if (scopeState.$clearExternalErrorsOnValidate.value) $clearExternalErrors();
+			if (scopeState.$clearExternalErrorsOnValidate.value) {
+				$clearExternalErrors();
+				$clearExternalIssues();
+			}
 			return [...Object.values($fields.value).map((statusOrField) => statusOrField.$validateSync()), ...$selfStatus.value ? [$selfStatus.value?.$validateSync()] : []].every((result) => !!result);
 		} catch {
 			return false;
@@ -3471,6 +3586,7 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 		$originalValue: originalState,
 		$self: $selfStatus,
 		$externalErrors: externalErrors,
+		$externalIssues: externalIssues,
 		$fields,
 		$reset,
 		$touch,
@@ -3478,7 +3594,9 @@ function createReactiveNestedStatus({ rulesDef, state, path = "", cachePath, roo
 		$unwatch,
 		$watch,
 		$setExternalErrors,
+		$setExternalIssues,
 		$clearExternalErrors,
+		$clearExternalIssues,
 		$extractDirtyFields,
 		$abort,
 		$validateSync,
@@ -3528,6 +3646,89 @@ function createReactiveChildrenStatus({ rulesDef, ...properties }) {
 		...properties
 	});
 }
+function normalizeExternalValue(value) {
+	if (value && isObject(value) && Object.keys(value).some((key) => key.includes("."))) return dotPathObjectToNested(value);
+	return value;
+}
+function hasExternalValue(value) {
+	if (Array.isArray(value)) return value.length > 0;
+	return isObject(value) && Object.keys(value).length > 0;
+}
+function emptyExternalValue(value) {
+	return Array.isArray(value) ? [] : {};
+}
+function createExternalChannels(options) {
+	const externalErrors = ref();
+	const externalIssues = ref();
+	let unwatchOptionErrors;
+	let unwatchInternalErrors;
+	let unwatchOptionIssues;
+	let unwatchInternalIssues;
+	let syncing = false;
+	function clearIssues() {
+		const emptyIssues = emptyExternalValue(externalIssues.value ?? options.externalIssues?.value);
+		externalIssues.value = emptyIssues;
+		if (options.externalIssues) options.externalIssues.value = emptyIssues;
+	}
+	function clearErrors() {
+		const emptyErrors = emptyExternalValue(externalErrors.value ?? options.externalErrors?.value);
+		externalErrors.value = emptyErrors;
+		if (options.externalErrors) options.externalErrors.value = emptyErrors;
+	}
+	function syncErrors(newErrors, updateOptionRef = false) {
+		if (syncing) return;
+		syncing = true;
+		const normalizedErrors = normalizeExternalValue(newErrors);
+		externalErrors.value = normalizedErrors;
+		if (updateOptionRef && options.externalErrors) options.externalErrors.value = normalizedErrors;
+		if (hasExternalValue(normalizedErrors)) clearIssues();
+		syncing = false;
+	}
+	function syncIssues(newIssues, updateOptionRef = false) {
+		if (syncing) return;
+		syncing = true;
+		const normalizedIssues = normalizeExternalValue(newIssues);
+		externalIssues.value = normalizedIssues;
+		if (updateOptionRef && options.externalIssues) options.externalIssues.value = normalizedIssues;
+		if (hasExternalValue(normalizedIssues)) clearErrors();
+		syncing = false;
+	}
+	function watchOptionRefs() {
+		unwatchOptionErrors?.();
+		unwatchOptionIssues?.();
+		unwatchOptionErrors = watch(() => options.externalErrors?.value, (errors) => syncErrors(errors), { deep: true });
+		unwatchOptionIssues = watch(() => options.externalIssues?.value, (issues) => syncIssues(issues), { deep: true });
+	}
+	function watchInternalRefs() {
+		unwatchInternalErrors?.();
+		unwatchInternalIssues?.();
+		unwatchInternalErrors = watch(() => externalErrors.value, (errors) => syncErrors(errors, true), { deep: true });
+		unwatchInternalIssues = watch(() => externalIssues.value, (issues) => syncIssues(issues, true), { deep: true });
+	}
+	function start() {
+		stop();
+		syncErrors(options.externalErrors?.value);
+		syncIssues(options.externalIssues?.value);
+		watchInternalRefs();
+	}
+	function stop() {
+		unwatchInternalErrors?.();
+		unwatchOptionErrors?.();
+		unwatchInternalIssues?.();
+		unwatchOptionIssues?.();
+		unwatchInternalErrors = void 0;
+		unwatchOptionErrors = void 0;
+		unwatchInternalIssues = void 0;
+		unwatchOptionIssues = void 0;
+	}
+	return {
+		externalErrors,
+		externalIssues,
+		start,
+		watchOptionRefs,
+		stop
+	};
+}
 /**
 * @internal
 * This is the internal function that creates the root storage for the Regle instance.
@@ -3539,37 +3740,18 @@ function useRootStorage({ initialState, originalState, options, scopeRules, stat
 	const attachedScopes = /* @__PURE__ */ new Set();
 	let rootScope;
 	const regle = ref();
-	const computedExternalErrors = ref();
-	let $unwatchExternalErrors;
-	let $unwatchComputedExternalErrors;
+	const externalChannels = createExternalChannels(options);
 	let $unwatchDisabled;
 	function defineDisabledWatchSource() {
 		$unwatchDisabled = watch(() => toValue(options.disabled), async (disabled) => {
 			if (disabled) unwatchRegle();
 			else {
 				createRegleInstance();
-				defineExternalErrorsWatchSource();
+				externalChannels.start();
+				externalChannels.watchOptionRefs();
 			}
 		});
 	}
-	function handleExternalErrorsChange(newErrors) {
-		$unwatchComputedExternalErrors?.();
-		if (newErrors) if (isObject(newErrors) && Object.keys(newErrors).some((key) => key.includes("."))) computedExternalErrors.value = dotPathObjectToNested(newErrors);
-		else if (Array.isArray(newErrors)) computedExternalErrors.value = newErrors;
-		else computedExternalErrors.value = newErrors ?? {};
-		defineComputedExternalErrorsWatchSource();
-	}
-	function defineExternalErrorsWatchSource() {
-		$unwatchExternalErrors = watch(() => options.externalErrors?.value, handleExternalErrorsChange, { deep: true });
-	}
-	function defineComputedExternalErrorsWatchSource() {
-		$unwatchComputedExternalErrors = watch(() => computedExternalErrors.value, (newErrors) => {
-			$unwatchExternalErrors?.();
-			if (options.externalErrors?.value) options.externalErrors.value = newErrors;
-			handleExternalErrorsChange(newErrors);
-			defineExternalErrorsWatchSource();
-		}, { deep: true });
-	}
 	function createRegleInstance() {
 		if (isNestedRulesDef(state, scopeRules)) regle.value = createReactiveNestedStatus({
 			rootRules: scopeRules,
@@ -3579,7 +3761,8 @@ function useRootStorage({ initialState, originalState, options, scopeRules, stat
 			storage,
 			options,
 			rootInitialState: initialState,
-			externalErrors: computedExternalErrors,
+			externalErrors: externalChannels.externalErrors,
+			externalIssues: externalChannels.externalIssues,
 			validationGroups: options.validationGroups,
 			initialState,
 			originalState,
@@ -3600,7 +3783,8 @@ function useRootStorage({ initialState, originalState, options, scopeRules, stat
 			storage,
 			options,
 			rootInitialState: initialState,
-			externalErrors: computedExternalErrors,
+			externalErrors: externalChannels.externalErrors,
+			externalIssues: externalChannels.externalIssues,
 			initialState,
 			originalState,
 			shortcuts,
@@ -3614,26 +3798,23 @@ function useRootStorage({ initialState, originalState, options, scopeRules, stat
 		});
 	}
 	function clearWatchHandles() {
-		$unwatchComputedExternalErrors = void 0;
-		$unwatchExternalErrors = void 0;
 		$unwatchDisabled = void 0;
 	}
 	function unwatchRegle() {
 		regle.value?.$unwatch();
-		$unwatchComputedExternalErrors?.();
-		$unwatchExternalErrors?.();
+		externalChannels.stop();
 	}
 	function startRootStorage() {
 		if (isEnabled.value) return;
 		isEnabled.value = true;
 		rootScope = effectScope(true);
 		rootScope.run(() => {
-			handleExternalErrorsChange(options.externalErrors?.value);
+			externalChannels.start();
 			createRegleInstance();
 			if (toValue(options.disabled)) nextTick().then(() => {
 				regle.value?.$unwatch();
 			});
-			else defineExternalErrorsWatchSource();
+			else externalChannels.watchOptionRefs();
 			defineDisabledWatchSource();
 		});
 	}
@@ -3645,6 +3826,8 @@ function useRootStorage({ initialState, originalState, options, scopeRules, stat
 		clearWatchHandles();
 		rootScope?.stop();
 		rootScope = void 0;
+		regle.value = void 0;
+		storage.clearAll();
 	}
 	function bindToCurrentScope() {
 		const currentScope = getCurrentScope();
@@ -3733,7 +3916,9 @@ function createUseRegleComposable(options) {
 			shortcuts,
 			overrides
 		});
-		return { r$: toReactive(regle, isDisabled, bindToCurrentScope) };
+		return { r$: toReactive(regle, isDisabled, () => {
+			if (!regle.value) bindToCurrentScope();
+		}) };
 	}
 	return useRegle;
 }
@@ -3908,7 +4093,9 @@ function createUseRulesComposable(options) {
 			shortcuts,
 			overrides
 		});
-		return toReactive(regle, isDisabled, bindToCurrentScope);
+		return toReactive(regle, isDisabled, () => {
+			if (!regle.value) bindToCurrentScope();
+		});
 	}
 	return useRules;
 }
@@ -4275,11 +4462,21 @@ function mergeRegles(regles, _scoped) {
 			regle.$setExternalErrors(errors);
 		});
 	}
+	function $setExternalIssues(issues) {
+		Object.values(regles).forEach((regle) => {
+			regle.$setExternalIssues(issues);
+		});
+	}
 	function $clearExternalErrors() {
 		Object.values(regles).forEach((regle) => {
 			regle.$clearExternalErrors();
 		});
 	}
+	function $clearExternalIssues() {
+		Object.values(regles).forEach((regle) => {
+			regle.$clearExternalIssues();
+		});
+	}
 	function $validateSync(forceValues) {
 		try {
 			if (forceValues) $value.value = forceValues;
@@ -4338,7 +4535,9 @@ function mergeRegles(regles, _scoped) {
 		$validateSync,
 		$extractDirtyFields,
 		$clearExternalErrors,
-		$setExternalErrors
+		$clearExternalIssues,
+		$setExternalErrors,
+		$setExternalIssues
 	});
 	watchEffect(() => {
 		if (scoped) return;