@formisch/react 0.5.0 → 0.7.0

package/dist/index.js

@@ -123,11 +123,13 @@ function initializeFieldStore(internalFieldStore, schema, initialInput, path, nu
 	else {
 		internalFieldStore.schema = schema;
 		internalFieldStore.name = JSON.stringify(path);
+		internalFieldStore.path = path;
 		const initialElements = [];
 		internalFieldStore.initialElements = initialElements;
 		internalFieldStore.elements = initialElements;
 		internalFieldStore.errors = /* @__PURE__ */ createSignal(null);
 		internalFieldStore.isTouched = /* @__PURE__ */ createSignal(false);
+		internalFieldStore.isEdited = /* @__PURE__ */ createSignal(false);
 		internalFieldStore.isDirty = /* @__PURE__ */ createSignal(false);
 		if (schema.type === "array" || schema.type === "loose_tuple" || schema.type === "strict_tuple" || schema.type === "tuple") {
 			if (internalFieldStore.kind && internalFieldStore.kind !== "array") throw new Error(`Store initialized as "${internalFieldStore.kind}" cannot be reinitialized as "array"`);
@@ -137,16 +139,13 @@ function initializeFieldStore(internalFieldStore, schema, initialInput, path, nu
 				if (schema.type === "array") {
 					if (initialInput) for (let index = 0; index < initialInput.length; index++) {
 						internalFieldStore.children[index] = {};
-						path.push(index);
-						initializeFieldStore(internalFieldStore.children[index], schema.item, initialInput[index], path);
-						path.pop();
+						initializeFieldStore(internalFieldStore.children[index], schema.item, initialInput[index], [...path, index]);
 					}
 				} else for (let index = 0; index < schema.items.length; index++) {
 					internalFieldStore.children[index] = {};
-					path.push(index);
-					initializeFieldStore(internalFieldStore.children[index], schema.items[index], initialInput?.[index], path);
-					path.pop();
+					initializeFieldStore(internalFieldStore.children[index], schema.items[index], initialInput?.[index], [...path, index]);
 				}
+				internalFieldStore.isNullish = nullish;
 				const arrayInput = nullish && initialInput == null ? initialInput : true;
 				internalFieldStore.initialInput = /* @__PURE__ */ createSignal(arrayInput);
 				internalFieldStore.startInput = /* @__PURE__ */ createSignal(arrayInput);
@@ -163,10 +162,9 @@ function initializeFieldStore(internalFieldStore, schema, initialInput, path, nu
 				internalFieldStore.children ??= {};
 				for (const key in schema.entries) {
 					internalFieldStore.children[key] ??= {};
-					path.push(key);
-					initializeFieldStore(internalFieldStore.children[key], schema.entries[key], initialInput?.[key], path);
-					path.pop();
+					initializeFieldStore(internalFieldStore.children[key], schema.entries[key], initialInput?.[key], [...path, key]);
 				}
+				internalFieldStore.isNullish = nullish;
 				const objectInput = nullish && initialInput == null ? initialInput : true;
 				internalFieldStore.initialInput = /* @__PURE__ */ createSignal(objectInput);
 				internalFieldStore.startInput = /* @__PURE__ */ createSignal(objectInput);
@@ -186,8 +184,9 @@ function initializeFieldStore(internalFieldStore, schema, initialInput, path, nu
 /**
 * Copies the deeply nested state (signal values) from one field store to
 * another. This includes the `elements`, `errors`, `startInput`, `input`,
-* `isTouched`, `isDirty`, and for arrays `startItems` and `items` properties.
-* Recursively walks through the field stores and copies all signal values.
+* `isTouched`, `isEdited`, `isDirty`, and for arrays `startItems` and `items`
+* properties. Recursively walks through the field stores and copies all signal
+* values.
 *
 * @param fromInternalFieldStore The source field store to copy from.
 * @param toInternalFieldStore The destination field store to copy to.
@@ -200,19 +199,16 @@ function copyItemState(fromInternalFieldStore, toInternalFieldStore) {
 			toInternalFieldStore.startInput.value = fromInternalFieldStore.startInput.value;
 			toInternalFieldStore.input.value = fromInternalFieldStore.input.value;
 			toInternalFieldStore.isTouched.value = fromInternalFieldStore.isTouched.value;
+			toInternalFieldStore.isEdited.value = fromInternalFieldStore.isEdited.value;
 			toInternalFieldStore.isDirty.value = fromInternalFieldStore.isDirty.value;
 			if (fromInternalFieldStore.kind === "array" && toInternalFieldStore.kind === "array") {
 				const fromItems = fromInternalFieldStore.items.value;
 				toInternalFieldStore.startItems.value = fromInternalFieldStore.startItems.value;
 				toInternalFieldStore.items.value = fromItems;
-				let path;
 				for (let index = 0; index < fromItems.length; index++) {
 					if (!toInternalFieldStore.children[index]) {
-						path ??= JSON.parse(toInternalFieldStore.name);
 						toInternalFieldStore.children[index] = {};
-						path.push(index);
-						initializeFieldStore(toInternalFieldStore.children[index], toInternalFieldStore.schema.item, void 0, path);
-						path.pop();
+						initializeFieldStore(toInternalFieldStore.children[index], toInternalFieldStore.schema.item, void 0, [...toInternalFieldStore.path, index]);
 					}
 					copyItemState(fromInternalFieldStore.children[index], toInternalFieldStore.children[index]);
 				}
@@ -222,45 +218,61 @@ function copyItemState(fromInternalFieldStore, toInternalFieldStore) {
 }
 /**
 * Resets the state of a field store (signal values) deeply nested. Sets
-* `elements` to empty array, `errors` to `null`, `isTouched` and `isDirty` to
-* `false`, and `startInput`, `input`, `startItems`, and `items` to the new
-* input value. Keeps the `initialInput` and `initialItems` state unchanged for
-* form reset functionality.
+* `elements` to empty array, `errors` to `null`, `isTouched`, `isEdited` and
+* `isDirty` to `false`, and `startInput`, `input`, `startItems`, and `items` to
+* the new input value. Keeps the `initialInput` and `initialItems` state
+* unchanged for form reset functionality.
 *
 * @param internalFieldStore The field store to reset.
-* @param initialInput The new input value (can be any type including array or object).
+* @param input The new input value (can be any type including array or object).
+* @param keepStart Whether to keep `startInput` and `startItems` as the dirty
+* baseline instead of resetting them to the new input. Used when a field store
+* is reused for an in-place edit so its dirty state is detected correctly.
 */
-function resetItemState(internalFieldStore, initialInput) {
+function resetItemState(internalFieldStore, input, keepStart = false) {
 	batch(() => {
-		internalFieldStore.elements = [];
+		const elements = [];
+		if (internalFieldStore.elements === internalFieldStore.initialElements) internalFieldStore.initialElements = elements;
+		internalFieldStore.elements = elements;
 		internalFieldStore.errors.value = null;
 		internalFieldStore.isTouched.value = false;
+		internalFieldStore.isEdited.value = false;
 		internalFieldStore.isDirty.value = false;
 		if (internalFieldStore.kind === "array" || internalFieldStore.kind === "object") {
-			const objectInput = initialInput == null ? initialInput : true;
-			internalFieldStore.startInput.value = objectInput;
+			const objectInput = internalFieldStore.isNullish && input == null ? input : true;
+			if (!keepStart) internalFieldStore.startInput.value = objectInput;
 			internalFieldStore.input.value = objectInput;
-			if (internalFieldStore.kind === "array") if (initialInput) {
-				const newItems = initialInput.map(createId);
-				internalFieldStore.startItems.value = newItems;
-				internalFieldStore.items.value = newItems;
-				for (let index = 0; index < initialInput.length; index++) if (internalFieldStore.children[index]) resetItemState(internalFieldStore.children[index], initialInput[index]);
-			} else {
-				internalFieldStore.startItems.value = [];
-				internalFieldStore.items.value = [];
-			}
-			else for (const key in internalFieldStore.children) resetItemState(internalFieldStore.children[key], initialInput?.[key]);
+			if (internalFieldStore.kind === "array") {
+				const isTuple = internalFieldStore.schema.type !== "array";
+				if (input || isTuple) {
+					const length = isTuple ? internalFieldStore.children.length : input.length;
+					const newItems = Array.from({ length }, createId);
+					if (!keepStart) internalFieldStore.startItems.value = newItems;
+					internalFieldStore.items.value = newItems;
+					for (let index = 0; index < length; index++) {
+						const itemInput = input?.[index];
+						if (internalFieldStore.children[index]) resetItemState(internalFieldStore.children[index], itemInput, keepStart);
+						else {
+							internalFieldStore.children[index] = {};
+							initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, itemInput, [...internalFieldStore.path, index]);
+						}
+					}
+				} else {
+					if (!keepStart) internalFieldStore.startItems.value = [];
+					internalFieldStore.items.value = [];
+				}
+			} else for (const key in internalFieldStore.children) resetItemState(internalFieldStore.children[key], input?.[key], keepStart);
 		} else {
-			internalFieldStore.startInput.value = initialInput;
-			internalFieldStore.input.value = initialInput;
+			if (!keepStart) internalFieldStore.startInput.value = input;
+			internalFieldStore.input.value = input;
 		}
 	});
 }
 /**
 * Swaps the deeply nested state (signal values) between two field stores. This
 * includes the `elements`, `errors`, `startInput`, `input`, `isTouched`,
-* `isDirty`, and for arrays `startItems` and `items` properties. Recursively
-* walks through the field stores and swaps all signal values.
+* `isEdited`, `isDirty`, and for arrays `startItems` and `items` properties.
+* Recursively walks through the field stores and swaps all signal values.
 *
 * @param firstInternalFieldStore The first field store to swap.
 * @param secondInternalFieldStore The second field store to swap.
@@ -283,6 +295,9 @@ function swapItemState(firstInternalFieldStore, secondInternalFieldStore) {
 			const tempIsTouched = firstInternalFieldStore.isTouched.value;
 			firstInternalFieldStore.isTouched.value = secondInternalFieldStore.isTouched.value;
 			secondInternalFieldStore.isTouched.value = tempIsTouched;
+			const tempIsEdited = firstInternalFieldStore.isEdited.value;
+			firstInternalFieldStore.isEdited.value = secondInternalFieldStore.isEdited.value;
+			secondInternalFieldStore.isEdited.value = tempIsEdited;
 			const tempIsDirty = firstInternalFieldStore.isDirty.value;
 			firstInternalFieldStore.isDirty.value = secondInternalFieldStore.isDirty.value;
 			secondInternalFieldStore.isDirty.value = tempIsDirty;
@@ -295,22 +310,14 @@ function swapItemState(firstInternalFieldStore, secondInternalFieldStore) {
 				firstInternalFieldStore.items.value = secondItems;
 				secondInternalFieldStore.items.value = firstItems;
 				const maxLength = Math.max(firstItems.length, secondItems.length);
-				let firstPath;
-				let secondPath;
 				for (let index = 0; index < maxLength; index++) {
 					if (!firstInternalFieldStore.children[index]) {
-						firstPath ??= JSON.parse(firstInternalFieldStore.name);
 						firstInternalFieldStore.children[index] = {};
-						firstPath.push(index);
-						initializeFieldStore(firstInternalFieldStore.children[index], firstInternalFieldStore.schema.item, void 0, firstPath);
-						firstPath.pop();
+						initializeFieldStore(firstInternalFieldStore.children[index], firstInternalFieldStore.schema.item, void 0, [...firstInternalFieldStore.path, index]);
 					}
 					if (!secondInternalFieldStore.children[index]) {
-						secondPath ??= JSON.parse(secondInternalFieldStore.name);
 						secondInternalFieldStore.children[index] = {};
-						secondPath.push(index);
-						initializeFieldStore(secondInternalFieldStore.children[index], secondInternalFieldStore.schema.item, void 0, secondPath);
-						secondPath.pop();
+						initializeFieldStore(secondInternalFieldStore.children[index], secondInternalFieldStore.schema.item, void 0, [...secondInternalFieldStore.path, index]);
 					}
 					swapItemState(firstInternalFieldStore.children[index], secondInternalFieldStore.children[index]);
 				}
@@ -319,6 +326,51 @@ function swapItemState(firstInternalFieldStore, secondInternalFieldStore) {
 	});
 }
 /**
+* Focuses the first focusable element of a field store. The elements are tried
+* in order and the first one that actually receives focus wins, so detached,
+* disabled or hidden elements are skipped. The browser decides focusability,
+* which is read back via the element's root `activeElement` so elements in a
+* shadow root or another document are handled correctly.
+*
+* Hint: A `display: none` or `hidden` element is correctly skipped in real
+* browsers, but jsdom has no layout and focuses it anyway, so that case cannot
+* be covered by unit tests.
+*
+* @param internalFieldStore The field store to focus.
+*
+* @returns Whether an element was focused.
+*/
+function focusFieldElement(internalFieldStore) {
+	for (const element of internalFieldStore.elements) {
+		element.focus();
+		if (element.getRootNode().activeElement === element) return true;
+	}
+	return false;
+}
+/**
+* Walks through the field store and all nested children, calling the callback
+* for each field store in depth-first order. The callback may return `true` to
+* stop the walk early, in which case `walkFieldStore` returns `true` as well.
+*
+* The walk reads array `items` reactively, so a reactive caller subscribes to
+* structural changes naturally. Imperative callers that must not subscribe
+* (e.g. when invoked inside an effect) should wrap the call in `untrack`.
+*
+* @param internalFieldStore The field store to walk.
+* @param callback The callback to invoke for each field store. Return `true` to stop the walk early.
+*
+* @returns Whether the walk was stopped early by the callback.
+*/
+function walkFieldStore(internalFieldStore, callback) {
+	if (callback(internalFieldStore)) return true;
+	if (internalFieldStore.kind === "array") {
+		for (let index = 0; index < internalFieldStore.items.value.length; index++) if (walkFieldStore(internalFieldStore.children[index], callback)) return true;
+	} else if (internalFieldStore.kind === "object") {
+		for (const key in internalFieldStore.children) if (walkFieldStore(internalFieldStore.children[key], callback)) return true;
+	}
+	return false;
+}
+/**
 * Returns whether the specified boolean property is true for the field store
 * or any of its nested children. Recursively checks arrays and objects.
 *
@@ -329,16 +381,7 @@ function swapItemState(firstInternalFieldStore, secondInternalFieldStore) {
 */
 /* @__NO_SIDE_EFFECTS__ */
 function getFieldBool(internalFieldStore, type) {
-	if (internalFieldStore[type].value) return true;
-	if (internalFieldStore.kind === "array") {
-		for (let index = 0; index < internalFieldStore.items.value.length; index++) if (/* @__PURE__ */ getFieldBool(internalFieldStore.children[index], type)) return true;
-		return false;
-	}
-	if (internalFieldStore.kind == "object") {
-		for (const key in internalFieldStore.children) if (/* @__PURE__ */ getFieldBool(internalFieldStore.children[key], type)) return true;
-		return false;
-	}
-	return false;
+	return walkFieldStore(internalFieldStore, (internalFieldStore$1) => Boolean(internalFieldStore$1[type].value));
 }
 /**
 * Returns only the dirty input of the field store. Arrays are treated as
@@ -456,11 +499,11 @@ function getFieldStore(internalFormStore, path) {
 */
 function setFieldBool(internalFieldStore, type, bool) {
 	batch(() => {
-		if (internalFieldStore.kind === "array") {
-			internalFieldStore[type].value = bool;
-			for (let index = 0; index < untrack(() => internalFieldStore.items.value).length; index++) setFieldBool(internalFieldStore.children[index], type, bool);
-		} else if (internalFieldStore.kind == "object") for (const key in internalFieldStore.children) setFieldBool(internalFieldStore.children[key], type, bool);
-		else internalFieldStore[type].value = bool;
+		untrack(() => {
+			walkFieldStore(internalFieldStore, (internalFieldStore$1) => {
+				internalFieldStore$1[type].value = bool;
+			});
+		});
 	});
 }
 /**
@@ -472,23 +515,21 @@ function setFieldBool(internalFieldStore, type, bool) {
 */
 function setNestedInput(internalFieldStore, input) {
 	internalFieldStore.isTouched.value = true;
+	internalFieldStore.isEdited.value = true;
 	if (internalFieldStore.kind === "array") {
 		const arrayInput = input ?? [];
 		const items = internalFieldStore.items.value;
-		if (arrayInput.length < items.length) internalFieldStore.items.value = items.slice(0, arrayInput.length);
-		else if (arrayInput.length > items.length) {
-			if (arrayInput.length > internalFieldStore.children.length) {
-				const path = JSON.parse(internalFieldStore.name);
-				for (let index = internalFieldStore.children.length; index < arrayInput.length; index++) {
-					internalFieldStore.children[index] = {};
-					path.push(index);
-					initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, arrayInput[index], path);
-					path.pop();
-				}
+		const length = internalFieldStore.schema.type === "array" ? arrayInput.length : internalFieldStore.children.length;
+		if (length < items.length) internalFieldStore.items.value = items.slice(0, length);
+		else if (length > items.length) {
+			for (let index = items.length; index < length; index++) if (internalFieldStore.children[index]) resetItemState(internalFieldStore.children[index], arrayInput[index], true);
+			else {
+				internalFieldStore.children[index] = {};
+				initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, arrayInput[index], [...internalFieldStore.path, index]);
 			}
-			internalFieldStore.items.value = [...items, ...arrayInput.slice(items.length).map(createId)];
+			internalFieldStore.items.value = [...items, ...Array.from({ length: length - items.length }, createId)];
 		}
-		for (let index = 0; index < arrayInput.length; index++) setNestedInput(internalFieldStore.children[index], arrayInput[index]);
+		for (let index = 0; index < length; index++) setNestedInput(internalFieldStore.children[index], arrayInput[index]);
 		internalFieldStore.input.value = input == null ? input : true;
 		internalFieldStore.isDirty.value = internalFieldStore.startInput.value !== internalFieldStore.input.value || internalFieldStore.startItems.value.length !== internalFieldStore.items.value.length;
 	} else if (internalFieldStore.kind === "object") {
@@ -532,38 +573,22 @@ function setFieldInput(internalFormStore, path, input) {
 function setInitialFieldInput(internalFieldStore, initialInput) {
 	batch(() => {
 		if (internalFieldStore.kind === "array") {
-			internalFieldStore.input.value = initialInput == null ? initialInput : true;
+			internalFieldStore.initialInput.value = initialInput == null ? initialInput : true;
 			const initialArrayInput = initialInput ?? [];
-			if (initialArrayInput.length > internalFieldStore.children.length) {
-				const path = JSON.parse(internalFieldStore.name);
-				for (let index = internalFieldStore.children.length; index < initialArrayInput.length; index++) {
-					internalFieldStore.children[index] = {};
-					path.push(index);
-					initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, initialArrayInput[index], path);
-					path.pop();
-				}
+			const length = internalFieldStore.schema.type === "array" ? initialArrayInput.length : internalFieldStore.children.length;
+			if (length > internalFieldStore.children.length) for (let index = internalFieldStore.children.length; index < length; index++) {
+				internalFieldStore.children[index] = {};
+				initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, initialArrayInput[index], [...internalFieldStore.path, index]);
 			}
-			internalFieldStore.initialItems.value = initialArrayInput.map(createId);
+			internalFieldStore.initialItems.value = Array.from({ length }, createId);
 			for (let index = 0; index < internalFieldStore.children.length; index++) setInitialFieldInput(internalFieldStore.children[index], initialArrayInput[index]);
 		} else if (internalFieldStore.kind === "object") {
-			internalFieldStore.input.value = initialInput == null ? initialInput : true;
+			internalFieldStore.initialInput.value = initialInput == null ? initialInput : true;
 			for (const key in internalFieldStore.children) setInitialFieldInput(internalFieldStore.children[key], initialInput?.[key]);
 		} else internalFieldStore.initialInput.value = initialInput;
 	});
 }
 /**
-* Walks through the field store and all nested children, calling the callback
-* for each field store in depth-first order.
-*
-* @param internalFieldStore The field store to walk.
-* @param callback The callback to invoke for each field store.
-*/
-function walkFieldStore(internalFieldStore, callback) {
-	callback(internalFieldStore);
-	if (internalFieldStore.kind === "array") for (let index = 0; index < untrack(() => internalFieldStore.items.value).length; index++) walkFieldStore(internalFieldStore.children[index], callback);
-	else if (internalFieldStore.kind === "object") for (const key in internalFieldStore.children) walkFieldStore(internalFieldStore.children[key], callback);
-}
-/**
 * Creates a new internal form store from the provided configuration.
 * Initializes the field store hierarchy, sets validation modes, and
 * creates form state signals.
@@ -598,44 +623,51 @@ function createFormStore(config, parse) {
 async function validateFormInput(internalFormStore, config) {
 	internalFormStore.validators++;
 	internalFormStore.isValidating.value = true;
-	const result = await internalFormStore.parse(untrack(() => /* @__PURE__ */ getFieldInput(internalFormStore)));
-	let rootErrors;
-	let nestedErrors;
-	if (result.issues) {
-		nestedErrors = {};
-		for (const issue of result.issues) if (issue.path) {
-			const path = [];
-			for (const pathItem of issue.path) {
-				const key = pathItem.key;
-				const keyType = typeof key;
-				const itemType = pathItem.type;
-				if (keyType !== "string" && keyType !== "number" || itemType === "map" || itemType === "set") break;
-				path.push(key);
-			}
-			const name = JSON.stringify(path);
-			const fieldErrors = nestedErrors[name];
-			if (fieldErrors) fieldErrors.push(issue.message);
-			else nestedErrors[name] = [issue.message];
-		} else if (rootErrors) rootErrors.push(issue.message);
-		else rootErrors = [issue.message];
-	}
-	let shouldFocus = config?.shouldFocus ?? false;
-	batch(() => {
-		walkFieldStore(internalFormStore, (internalFieldStore) => {
-			if (internalFieldStore.name === "[]") internalFieldStore.errors.value = rootErrors ?? null;
-			else {
-				const fieldErrors = nestedErrors?.[internalFieldStore.name] ?? null;
-				internalFieldStore.errors.value = fieldErrors;
-				if (shouldFocus && fieldErrors) {
-					internalFieldStore.elements[0]?.focus();
-					shouldFocus = false;
+	try {
+		const result = await internalFormStore.parse(untrack(() => /* @__PURE__ */ getFieldInput(internalFormStore)));
+		let rootErrors;
+		let nestedErrors;
+		if (result.issues) {
+			nestedErrors = {};
+			for (const issue of result.issues) if (issue.path) {
+				const path = [];
+				for (const pathItem of issue.path) {
+					const key = pathItem.key;
+					const keyType = typeof key;
+					const itemType = pathItem.type;
+					if (keyType !== "string" && keyType !== "number" || itemType === "map" || itemType === "set") break;
+					path.push(key);
 				}
-			}
+				const name = JSON.stringify(path);
+				const fieldErrors = nestedErrors[name];
+				if (fieldErrors) fieldErrors.push(issue.message);
+				else nestedErrors[name] = [issue.message];
+			} else if (rootErrors) rootErrors.push(issue.message);
+			else rootErrors = [issue.message];
+		}
+		let shouldFocus = config?.shouldFocus ?? false;
+		batch(() => {
+			untrack(() => {
+				walkFieldStore(internalFormStore, (internalFieldStore) => {
+					if (internalFieldStore.path.length === 0) internalFieldStore.errors.value = rootErrors ?? null;
+					else {
+						const fieldErrors = nestedErrors?.[internalFieldStore.name] ?? null;
+						internalFieldStore.errors.value = fieldErrors;
+						if (shouldFocus && fieldErrors && focusFieldElement(internalFieldStore)) shouldFocus = false;
+					}
+				});
+			});
+			internalFormStore.validators--;
+			internalFormStore.isValidating.value = internalFormStore.validators > 0;
 		});
-		internalFormStore.validators--;
-		internalFormStore.isValidating.value = internalFormStore.validators > 0;
-	});
-	return result;
+		return result;
+	} catch (error) {
+		batch(() => {
+			internalFormStore.validators--;
+			internalFormStore.isValidating.value = internalFormStore.validators > 0;
+		});
+		throw error;
+	}
 }
 /**
 * Validates the form input if required based on the validation mode and form
@@ -657,7 +689,7 @@ const INTERNAL = "~internal";
 //#endregion
 //#region ../../packages/methods/dist/index.react.js
 /**
-* Focuses the first input element of a field. This is useful for
+* Focuses the first focusable input element of a field. This is useful for
 * programmatically setting focus to a specific field, such as after
 * validation errors or user interactions.
 *
@@ -665,27 +697,29 @@ const INTERNAL = "~internal";
 * @param config The focus field configuration.
 */
 function focus(form, config) {
-	getFieldStore(form[INTERNAL], config.path).elements[0]?.focus();
+	focusFieldElement(getFieldStore(form[INTERNAL], config.path));
+}
+/* @__NO_SIDE_EFFECTS__ */
+function getDeepErrorEntries(form, config) {
+	const entries = [];
+	walkFieldStore(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], (internalFieldStore) => {
+		const errors = internalFieldStore.errors.value;
+		if (errors) entries.push({
+			path: internalFieldStore.path,
+			errors
+		});
+	});
+	return entries;
 }
-/**
-* Retrieves all error messages from all fields in the form by walking through
-* the entire field store tree. This is useful for displaying a summary of all
-* validation errors across the form.
-*
-* @param form The form store to retrieve errors from.
-*
-* @returns A non-empty array of error messages, or null if no errors exist.
-*/
 /* @__NO_SIDE_EFFECTS__ */
-function getAllErrors(form) {
-	let allErrors = null;
-	walkFieldStore(form[INTERNAL], (internalFieldStore) => {
-		if (internalFieldStore.kind === "array") internalFieldStore.items.value;
+function getDeepErrors(form, config) {
+	let deepErrors = null;
+	walkFieldStore(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], (internalFieldStore) => {
 		const errors = internalFieldStore.errors.value;
-		if (errors) if (allErrors) allErrors.push(...errors);
-		else allErrors = [...errors];
+		if (errors) if (deepErrors) deepErrors.push(...errors);
+		else deepErrors = [...errors];
 	});
-	return allErrors;
+	return deepErrors;
 }
 /* @__NO_SIDE_EFFECTS__ */
 function getDirtyInput(form, config) {
@@ -693,9 +727,8 @@ function getDirtyInput(form, config) {
 }
 /* @__NO_SIDE_EFFECTS__ */
 function getDirtyPaths(form, config) {
-	config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL];
 	const paths = [];
-	config?.path && [...config.path];
+	config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL];
 	return paths;
 }
 /* @__NO_SIDE_EFFECTS__ */
@@ -750,25 +783,38 @@ function insert(form, config) {
 		internalArrayStore.items.value = newItems;
 		for (let index = items.length; index > insertIndex; index--) {
 			if (!internalArrayStore.children[index]) {
-				const path = JSON.parse(internalArrayStore.name);
 				internalArrayStore.children[index] = {};
-				path.push(index);
-				initializeFieldStore(internalArrayStore.children[index], internalArrayStore.schema.item, void 0, path);
+				initializeFieldStore(internalArrayStore.children[index], internalArrayStore.schema.item, void 0, [...internalArrayStore.path, index]);
 			}
 			copyItemState(internalArrayStore.children[index - 1], internalArrayStore.children[index]);
 		}
 		if (!internalArrayStore.children[insertIndex]) {
-			const path = JSON.parse(internalArrayStore.name);
 			internalArrayStore.children[insertIndex] = {};
-			path.push(insertIndex);
-			initializeFieldStore(internalArrayStore.children[insertIndex], internalArrayStore.schema.item, config.initialInput, path);
+			initializeFieldStore(internalArrayStore.children[insertIndex], internalArrayStore.schema.item, config.initialInput, [...internalArrayStore.path, insertIndex]);
 		} else resetItemState(internalArrayStore.children[insertIndex], config.initialInput);
 		internalArrayStore.input.value = true;
 		internalArrayStore.isTouched.value = true;
+		internalArrayStore.isEdited.value = true;
 		internalArrayStore.isDirty.value = true;
 		validateIfRequired(internalFormStore, internalArrayStore, "input");
 	});
 }
+/* @__NO_SIDE_EFFECTS__ */
+function isDirty(form, config) {
+	return getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "isDirty");
+}
+/* @__NO_SIDE_EFFECTS__ */
+function isEdited(form, config) {
+	return getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "isEdited");
+}
+/* @__NO_SIDE_EFFECTS__ */
+function isTouched(form, config) {
+	return getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "isTouched");
+}
+/* @__NO_SIDE_EFFECTS__ */
+function isValid(form, config) {
+	return !getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "errors");
+}
 /**
 * Moves an item from one index to another within a field array. All items
 * between the source and destination indices are shifted accordingly.
@@ -791,6 +837,7 @@ function move(form, config) {
 		else for (let index = config.from; index > config.to; index--) copyItemState(internalArrayStore.children[index - 1], internalArrayStore.children[index]);
 		copyItemState(tempInternalFieldStore, internalArrayStore.children[config.to]);
 		internalArrayStore.isTouched.value = true;
+		internalArrayStore.isEdited.value = true;
 		internalArrayStore.isDirty.value = internalArrayStore.startItems.value.join() !== newItems.join();
 		validateIfRequired(internalFormStore, internalArrayStore, "input");
 	});
@@ -854,6 +901,7 @@ function remove(form, config) {
 		internalArrayStore.items.value = newItems;
 		for (let index = config.at; index < items.length - 1; index++) copyItemState(internalArrayStore.children[index + 1], internalArrayStore.children[index]);
 		internalArrayStore.isTouched.value = true;
+		internalArrayStore.isEdited.value = true;
 		internalArrayStore.isDirty.value = internalArrayStore.startItems.value.join() !== newItems.join();
 		validateIfRequired(internalFormStore, internalArrayStore, "input");
 	});
@@ -874,6 +922,7 @@ function replace(form, config) {
 		internalArrayStore.items.value = newItems;
 		resetItemState(internalArrayStore.children[config.at], config.initialInput);
 		internalArrayStore.isTouched.value = true;
+		internalArrayStore.isEdited.value = true;
 		internalArrayStore.isDirty.value = true;
 		validateIfRequired(internalFormStore, internalArrayStore, "input");
 	});
@@ -888,6 +937,7 @@ function reset(form, config) {
 				internalFieldStore$1.elements = internalFieldStore$1.initialElements;
 				if (!config?.keepErrors) internalFieldStore$1.errors.value = null;
 				if (!config?.keepTouched) internalFieldStore$1.isTouched.value = false;
+				if (!config?.keepEdited) internalFieldStore$1.isEdited.value = false;
 				internalFieldStore$1.startInput.value = internalFieldStore$1.initialInput.value;
 				if (!config?.keepInput) internalFieldStore$1.input.value = internalFieldStore$1.initialInput.value;
 				if (internalFieldStore$1.kind === "array") {
@@ -948,6 +998,7 @@ function swap(form, config) {
 		internalArrayStore.items.value = newItems;
 		swapItemState(internalArrayStore.children[config.at], internalArrayStore.children[config.and]);
 		internalArrayStore.isTouched.value = true;
+		internalArrayStore.isEdited.value = true;
 		internalArrayStore.isDirty.value = internalArrayStore.startItems.value.join() !== newItems.join();
 		validateIfRequired(internalFormStore, internalArrayStore, "input");
 	});
@@ -1001,7 +1052,9 @@ function useField(form, config) {
 	const internalFieldStore = getFieldStore(internalFormStore, config.path);
 	useEffect(() => {
 		return () => {
-			internalFieldStore.elements = internalFieldStore.elements.filter((element) => element.isConnected);
+			const elements = internalFieldStore.elements.filter((element) => element.isConnected);
+			if (internalFieldStore.elements === internalFieldStore.initialElements) internalFieldStore.initialElements = elements;
+			internalFieldStore.elements = elements;
 		};
 	}, [internalFieldStore]);
 	return useMemo(() => ({
@@ -1015,6 +1068,9 @@ function useField(form, config) {
 		get isTouched() {
 			return getFieldBool(internalFieldStore, "isTouched");
 		},
+		get isEdited() {
+			return getFieldBool(internalFieldStore, "isEdited");
+		},
 		get isDirty() {
 			return getFieldBool(internalFieldStore, "isDirty");
 		},
@@ -1066,6 +1122,9 @@ function useFieldArray(form, config) {
 		get isTouched() {
 			return getFieldBool(internalFieldStore, "isTouched");
 		},
+		get isEdited() {
+			return getFieldBool(internalFieldStore, "isEdited");
+		},
 		get isDirty() {
 			return getFieldBool(internalFieldStore, "isDirty");
 		},
@@ -1098,6 +1157,9 @@ function useForm(config) {
 		get isTouched() {
 			return getFieldBool(internalFormStore, "isTouched");
 		},
+		get isEdited() {
+			return getFieldBool(internalFormStore, "isEdited");
+		},
 		get isDirty() {
 			return getFieldBool(internalFormStore, "isDirty");
 		},
@@ -1158,4 +1220,4 @@ function Form({ of, onSubmit, ...other }) {
 }
 
 //#endregion
-export { Field, FieldArray, Form, focus, getAllErrors, getDirtyInput, getDirtyPaths, getErrors, getInput, handleSubmit, insert, move, pickDirty, remove, replace, reset, setErrors, setInput, submit, swap, useField, useFieldArray, useForm, validate };
+export { Field, FieldArray, Form, focus, getDeepErrorEntries, getDeepErrors, getDirtyInput, getDirtyPaths, getErrors, getInput, handleSubmit, insert, isDirty, isEdited, isTouched, isValid, move, pickDirty, remove, replace, reset, setErrors, setInput, submit, swap, useField, useFieldArray, useForm, validate };