@formisch/svelte 0.9.0 → 0.10.0

package/dist/core/index.svelte.js

@@ -68,11 +68,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"`);
@@ -82,16 +84,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);
@@ -108,10 +107,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);
@@ -134,8 +132,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.
@@ -148,19 +147,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]);
 				}
@@ -173,10 +169,10 @@ function copyItemState(fromInternalFieldStore, toInternalFieldStore) {
 //#region src/array/resetItemState/resetItemState.ts
 /**
 * 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 input The new input value (can be any type including array or object).
@@ -191,30 +187,32 @@ function resetItemState(internalFieldStore, input, keepStart = false) {
 		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 = input == null ? input : true;
+			const objectInput = internalFieldStore.isNullish && input == null ? input : true;
 			if (!keepStart) internalFieldStore.startInput.value = objectInput;
 			internalFieldStore.input.value = objectInput;
-			if (internalFieldStore.kind === "array") if (input) {
-				const length = internalFieldStore.schema.type === "array" ? input.length : internalFieldStore.children.length;
-				const newItems = Array.from({ length }, createId);
-				if (!keepStart) internalFieldStore.startItems.value = newItems;
-				internalFieldStore.items.value = newItems;
-				let path;
-				for (let index = 0; index < length; index++) if (internalFieldStore.children[index]) resetItemState(internalFieldStore.children[index], input[index], keepStart);
-				else {
-					path ??= JSON.parse(internalFieldStore.name);
-					internalFieldStore.children[index] = {};
-					path.push(index);
-					initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, input[index], path);
-					path.pop();
+			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 {
-				if (!keepStart) internalFieldStore.startItems.value = [];
-				internalFieldStore.items.value = [];
-			}
-			else for (const key in internalFieldStore.children) resetItemState(internalFieldStore.children[key], input?.[key], keepStart);
+			} else for (const key in internalFieldStore.children) resetItemState(internalFieldStore.children[key], input?.[key], keepStart);
 		} else {
 			if (!keepStart) internalFieldStore.startInput.value = input;
 			internalFieldStore.input.value = input;
@@ -227,8 +225,8 @@ function resetItemState(internalFieldStore, input, keepStart = false) {
 /**
 * 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.
@@ -251,6 +249,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;
@@ -263,22 +264,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]);
 				}
@@ -312,6 +305,32 @@ function focusFieldElement(internalFieldStore) {
 	return false;
 }
 
+//#endregion
+//#region src/field/walkFieldStore/walkFieldStore.ts
+/**
+* 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;
+}
+
 //#endregion
 //#region src/field/getFieldBool/getFieldBool.ts
 /**
@@ -325,16 +344,7 @@ function focusFieldElement(internalFieldStore) {
 */
 /* @__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));
 }
 
 //#endregion
@@ -467,9 +477,11 @@ function getFieldStore(internalFormStore, path) {
 */
 function setFieldBool(internalFieldStore, type, bool) {
 	batch(() => {
-		internalFieldStore[type].value = bool;
-		if (internalFieldStore.kind === "array") 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);
+		untrack(() => {
+			walkFieldStore(internalFieldStore, (internalFieldStore$1) => {
+				internalFieldStore$1[type].value = bool;
+			});
+		});
 	});
 }
 
@@ -484,19 +496,17 @@ 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;
 		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) {
-			const path = JSON.parse(internalFieldStore.name);
 			for (let index = items.length; index < length; index++) if (internalFieldStore.children[index]) resetItemState(internalFieldStore.children[index], arrayInput[index], true);
 			else {
 				internalFieldStore.children[index] = {};
-				path.push(index);
-				initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, arrayInput[index], path);
-				path.pop();
+				initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, arrayInput[index], [...internalFieldStore.path, index]);
 			}
 			internalFieldStore.items.value = [...items, ...Array.from({ length: length - items.length }, createId)];
 		}
@@ -550,14 +560,9 @@ function setInitialFieldInput(internalFieldStore, initialInput) {
 			internalFieldStore.initialInput.value = initialInput == null ? initialInput : true;
 			const initialArrayInput = initialInput ?? [];
 			const length = internalFieldStore.schema.type === "array" ? initialArrayInput.length : internalFieldStore.children.length;
-			if (length > internalFieldStore.children.length) {
-				const path = JSON.parse(internalFieldStore.name);
-				for (let index = internalFieldStore.children.length; index < length; index++) {
-					internalFieldStore.children[index] = {};
-					path.push(index);
-					initializeFieldStore(internalFieldStore.children[index], internalFieldStore.schema.item, initialArrayInput[index], path);
-					path.pop();
-				}
+			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 = Array.from({ length }, createId);
 			for (let index = 0; index < internalFieldStore.children.length; index++) setInitialFieldInput(internalFieldStore.children[index], initialArrayInput[index]);
@@ -568,21 +573,6 @@ function setInitialFieldInput(internalFieldStore, initialInput) {
 	});
 }
 
-//#endregion
-//#region src/field/walkFieldStore/walkFieldStore.ts
-/**
-* 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);
-}
-
 //#endregion
 //#region src/form/createFormStore/createFormStore.ts
 /**
@@ -844,13 +834,15 @@ async function validateFormInput(internalFormStore, config) {
 		}
 		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 && focusFieldElement(internalFieldStore)) shouldFocus = false;
-				}
+			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;

package/dist/methods/index.svelte.d.ts

@@ -1,4 +1,4 @@
-import { BaseFormStore, DeepPartial, DirtyPath, FormSchema, PartialValues, PathValue, RequiredPath, SubmitEventHandler, SubmitHandler, ValidArrayPath, ValidPath } from "../core/index.svelte";
+import { BaseFormStore, DeepPartial, DirtyPath, FieldPath, FormSchema, PartialValues, Path, PathValue, RequiredPath, SubmitEventHandler, SubmitHandler, ValidArrayPath, ValidPath } from "../core/index.svelte";
 import * as v from "valibot";
 
 //#region src/focus/focus.d.ts
@@ -22,17 +22,104 @@ interface FocusFieldConfig<TSchema extends FormSchema, TFieldPath extends Requir
 */
 declare function focus<TSchema extends FormSchema, TFieldPath extends RequiredPath>(form: BaseFormStore<TSchema>, config: FocusFieldConfig<TSchema, TFieldPath>): void;
 //#endregion
-//#region src/getAllErrors/getAllErrors.d.ts
+//#region src/getDeepErrorEntries/getDeepErrorEntries.d.ts
 /**
-* 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.
+* Deep error entry interface.
+*/
+interface DeepErrorEntry<TValue = unknown> {
+  /**
+  * The path to the field with errors, or an empty path for form-level errors.
+  */
+  readonly path: unknown extends TValue ? Path : readonly [] | FieldPath<TValue>;
+  /**
+  * The error messages of the field.
+  */
+  readonly errors: [string, ...string[]];
+}
+/**
+* Get form deep error entries config interface.
+*/
+interface GetFormDeepErrorEntriesConfig {
+  /**
+  * The path to a field. Leave undefined to get the entries of the entire form.
+  */
+  readonly path?: undefined;
+}
+/**
+* Get field deep error entries config interface.
+*/
+interface GetFieldDeepErrorEntriesConfig<TSchema extends FormSchema, TFieldPath extends RequiredPath> {
+  /**
+  * The path to the field to retrieve the entries from.
+  */
+  readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
+}
+/**
+* Retrieves the errors of a specific field or the entire form as a list of
+* entries, each pairing the path to a field with its error messages. This is
+* useful for building custom error summaries that link each message back to
+* its field. Form-level errors are included with an empty path.
+*
+* @param form The form store to retrieve error entries from.
+*
+* @returns A list of path and error message entries.
+*/
+declare function getDeepErrorEntries<TSchema extends FormSchema>(form: BaseFormStore<TSchema>): DeepErrorEntry<v.InferInput<TSchema>>[];
+/**
+* Retrieves the errors of a specific field or the entire form as a list of
+* entries, each pairing the path to a field with its error messages. This is
+* useful for building custom error summaries that link each message back to
+* its field. Form-level errors are included with an empty path.
+*
+* @param form The form store to retrieve error entries from.
+* @param config The get deep error entries configuration.
+*
+* @returns A list of path and error message entries.
+*/
+declare function getDeepErrorEntries<TSchema extends FormSchema, TFieldPath extends RequiredPath | undefined = undefined>(form: BaseFormStore<TSchema>, config: TFieldPath extends RequiredPath ? GetFieldDeepErrorEntriesConfig<TSchema, TFieldPath> : GetFormDeepErrorEntriesConfig): DeepErrorEntry<v.InferInput<TSchema>>[];
+//#endregion
+//#region src/getDeepErrors/getDeepErrors.d.ts
+/**
+* Get form deep errors config interface.
+*/
+interface GetFormDeepErrorsConfig {
+  /**
+  * The path to a field. Leave undefined to get the errors of the entire form.
+  */
+  readonly path?: undefined;
+}
+/**
+* Get field deep errors config interface.
+*/
+interface GetFieldDeepErrorsConfig<TSchema extends FormSchema, TFieldPath extends RequiredPath> {
+  /**
+  * The path to the field to retrieve the errors from.
+  */
+  readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
+}
+/**
+* Retrieves all error messages of a specific field or the entire form by
+* walking through the field store and all its descendants. This is useful for
+* displaying a summary of all validation errors within a section or the whole
+* form. Form-level errors are included.
 *
 * @param form The form store to retrieve errors from.
 *
 * @returns A non-empty array of error messages, or null if no errors exist.
 */
-declare function getAllErrors(form: BaseFormStore): [string, ...string[]] | null;
+declare function getDeepErrors<TSchema extends FormSchema>(form: BaseFormStore<TSchema>): [string, ...string[]] | null;
+/**
+* Retrieves all error messages of a specific field or the entire form by
+* walking through the field store and all its descendants. This is useful for
+* displaying a summary of all validation errors within a section or the whole
+* form. Form-level errors are included.
+*
+* @param form The form store to retrieve errors from.
+* @param config The get deep errors configuration.
+*
+* @returns A non-empty array of error messages, or null if no errors exist.
+*/
+declare function getDeepErrors<TSchema extends FormSchema, TFieldPath extends RequiredPath | undefined = undefined>(form: BaseFormStore<TSchema>, config: TFieldPath extends RequiredPath ? GetFieldDeepErrorsConfig<TSchema, TFieldPath> : GetFormDeepErrorsConfig): [string, ...string[]] | null;
 //#endregion
 //#region src/getDirtyInput/getDirtyInput.d.ts
 /**
@@ -252,6 +339,172 @@ interface InsertConfig<TSchema extends FormSchema, TFieldArrayPath extends Requi
 */
 declare function insert<TSchema extends FormSchema, TFieldArrayPath extends RequiredPath>(form: BaseFormStore<TSchema>, config: InsertConfig<TSchema, TFieldArrayPath>): void;
 //#endregion
+//#region src/isDirty/isDirty.d.ts
+/**
+* Is form dirty config interface.
+*/
+interface IsFormDirtyConfig {
+  /**
+  * The path to a field. Leave undefined to check the entire form.
+  */
+  readonly path?: undefined;
+}
+/**
+* Is field dirty config interface.
+*/
+interface IsFieldDirtyConfig<TSchema extends FormSchema, TFieldPath extends RequiredPath> {
+  /**
+  * The path to the field to check for dirtiness.
+  */
+  readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
+}
+/**
+* Checks whether a specific field or the entire form is dirty by walking
+* through the field store and all its descendants. A field is dirty when its
+* input differs from its initial value.
+*
+* @param form The form store to check for dirtiness.
+*
+* @returns Whether the field or form is dirty.
+*/
+declare function isDirty<TSchema extends FormSchema>(form: BaseFormStore<TSchema>): boolean;
+/**
+* Checks whether a specific field or the entire form is dirty by walking
+* through the field store and all its descendants. A field is dirty when its
+* input differs from its initial value.
+*
+* @param form The form store to check for dirtiness.
+* @param config The is dirty configuration.
+*
+* @returns Whether the field or form is dirty.
+*/
+declare function isDirty<TSchema extends FormSchema, TFieldPath extends RequiredPath | undefined = undefined>(form: BaseFormStore<TSchema>, config: TFieldPath extends RequiredPath ? IsFieldDirtyConfig<TSchema, TFieldPath> : IsFormDirtyConfig): boolean;
+//#endregion
+//#region src/isEdited/isEdited.d.ts
+/**
+* Is form edited config interface.
+*/
+interface IsFormEditedConfig {
+  /**
+  * The path to a field. Leave undefined to check the entire form.
+  */
+  readonly path?: undefined;
+}
+/**
+* Is field edited config interface.
+*/
+interface IsFieldEditedConfig<TSchema extends FormSchema, TFieldPath extends RequiredPath> {
+  /**
+  * The path to the field to check for being edited.
+  */
+  readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
+}
+/**
+* Checks whether a specific field or the entire form is edited by walking
+* through the field store and all its descendants. A field is edited once its
+* value has been changed by the user.
+*
+* @param form The form store to check for being edited.
+*
+* @returns Whether the field or form is edited.
+*/
+declare function isEdited<TSchema extends FormSchema>(form: BaseFormStore<TSchema>): boolean;
+/**
+* Checks whether a specific field or the entire form is edited by walking
+* through the field store and all its descendants. A field is edited once its
+* value has been changed by the user.
+*
+* @param form The form store to check for being edited.
+* @param config The is edited configuration.
+*
+* @returns Whether the field or form is edited.
+*/
+declare function isEdited<TSchema extends FormSchema, TFieldPath extends RequiredPath | undefined = undefined>(form: BaseFormStore<TSchema>, config: TFieldPath extends RequiredPath ? IsFieldEditedConfig<TSchema, TFieldPath> : IsFormEditedConfig): boolean;
+//#endregion
+//#region src/isTouched/isTouched.d.ts
+/**
+* Is form touched config interface.
+*/
+interface IsFormTouchedConfig {
+  /**
+  * The path to a field. Leave undefined to check the entire form.
+  */
+  readonly path?: undefined;
+}
+/**
+* Is field touched config interface.
+*/
+interface IsFieldTouchedConfig<TSchema extends FormSchema, TFieldPath extends RequiredPath> {
+  /**
+  * The path to the field to check for being touched.
+  */
+  readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
+}
+/**
+* Checks whether a specific field or the entire form is touched by walking
+* through the field store and all its descendants. A field is touched once it
+* has received and lost focus.
+*
+* @param form The form store to check for being touched.
+*
+* @returns Whether the field or form is touched.
+*/
+declare function isTouched<TSchema extends FormSchema>(form: BaseFormStore<TSchema>): boolean;
+/**
+* Checks whether a specific field or the entire form is touched by walking
+* through the field store and all its descendants. A field is touched once it
+* has received and lost focus.
+*
+* @param form The form store to check for being touched.
+* @param config The is touched configuration.
+*
+* @returns Whether the field or form is touched.
+*/
+declare function isTouched<TSchema extends FormSchema, TFieldPath extends RequiredPath | undefined = undefined>(form: BaseFormStore<TSchema>, config: TFieldPath extends RequiredPath ? IsFieldTouchedConfig<TSchema, TFieldPath> : IsFormTouchedConfig): boolean;
+//#endregion
+//#region src/isValid/isValid.d.ts
+/**
+* Is form valid config interface.
+*/
+interface IsFormValidConfig {
+  /**
+  * The path to a field. Leave undefined to check the entire form.
+  */
+  readonly path?: undefined;
+}
+/**
+* Is field valid config interface.
+*/
+interface IsFieldValidConfig<TSchema extends FormSchema, TFieldPath extends RequiredPath> {
+  /**
+  * The path to the field to check for validity.
+  */
+  readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
+}
+/**
+* Checks whether a specific field or the entire form is valid by walking
+* through the field store and all its descendants. A field is valid when
+* neither it nor any of its descendants contains an error. Form-level errors
+* are included.
+*
+* @param form The form store to check for validity.
+*
+* @returns Whether the field or form is valid.
+*/
+declare function isValid<TSchema extends FormSchema>(form: BaseFormStore<TSchema>): boolean;
+/**
+* Checks whether a specific field or the entire form is valid by walking
+* through the field store and all its descendants. A field is valid when
+* neither it nor any of its descendants contains an error. Form-level errors
+* are included.
+*
+* @param form The form store to check for validity.
+* @param config The is valid configuration.
+*
+* @returns Whether the field or form is valid.
+*/
+declare function isValid<TSchema extends FormSchema, TFieldPath extends RequiredPath | undefined = undefined>(form: BaseFormStore<TSchema>, config: TFieldPath extends RequiredPath ? IsFieldValidConfig<TSchema, TFieldPath> : IsFormValidConfig): boolean;
+//#endregion
 //#region src/move/move.d.ts
 /**
 * Move array field config interface.
@@ -367,6 +620,10 @@ interface ResetBaseConfig {
   */
   readonly keepTouched?: boolean | undefined;
   /**
+  * Whether to keep the edited state during reset. Defaults to false.
+  */
+  readonly keepEdited?: boolean | undefined;
+  /**
   * Whether to keep the error messages during reset. Defaults to false.
   */
   readonly keepErrors?: boolean | undefined;
@@ -561,4 +818,4 @@ interface ValidateFormConfig {
 */
 declare function validate<TSchema extends FormSchema>(form: BaseFormStore<TSchema>, config?: ValidateFormConfig): Promise<v.SafeParseResult<TSchema>>;
 //#endregion
-export { FocusFieldConfig, GetFieldDirtyInputConfig, GetFieldDirtyPathsConfig, GetFieldErrorsConfig, GetFieldInputConfig, GetFormDirtyInputConfig, GetFormDirtyPathsConfig, GetFormErrorsConfig, GetFormInputConfig, InsertConfig, MoveConfig, PickDirtyConfig, RemoveConfig, ReplaceConfig, ResetFieldConfig, ResetFormConfig, SetFieldErrorsConfig, SetFieldInputConfig, SetFormErrorsConfig, SetFormInputConfig, SwapConfig, ValidateFormConfig, focus, getAllErrors, getDirtyInput, getDirtyPaths, getErrors, getInput, handleSubmit, insert, move, pickDirty, remove, replace, reset, setErrors, setInput, submit, swap, validate };
+export { DeepErrorEntry, FocusFieldConfig, GetFieldDeepErrorEntriesConfig, GetFieldDeepErrorsConfig, GetFieldDirtyInputConfig, GetFieldDirtyPathsConfig, GetFieldErrorsConfig, GetFieldInputConfig, GetFormDeepErrorEntriesConfig, GetFormDeepErrorsConfig, GetFormDirtyInputConfig, GetFormDirtyPathsConfig, GetFormErrorsConfig, GetFormInputConfig, InsertConfig, IsFieldDirtyConfig, IsFieldEditedConfig, IsFieldTouchedConfig, IsFieldValidConfig, IsFormDirtyConfig, IsFormEditedConfig, IsFormTouchedConfig, IsFormValidConfig, MoveConfig, PickDirtyConfig, RemoveConfig, ReplaceConfig, ResetFieldConfig, ResetFormConfig, SetFieldErrorsConfig, SetFieldInputConfig, SetFormErrorsConfig, SetFormInputConfig, SwapConfig, ValidateFormConfig, focus, getDeepErrorEntries, getDeepErrors, getDirtyInput, getDirtyPaths, getErrors, getInput, handleSubmit, insert, isDirty, isEdited, isTouched, isValid, move, pickDirty, remove, replace, reset, setErrors, setInput, submit, swap, validate };