@formisch/svelte 0.8.0 → 0.10.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
@@ -13,7 +13,7 @@ interface FocusFieldConfig<TSchema extends FormSchema, TFieldPath extends Requir
   readonly path: ValidPath<v.InferInput<TSchema>, TFieldPath>;
 }
 /**
-* 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.
 *
@@ -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 };

package/dist/methods/index.svelte.js

@@ -1,8 +1,8 @@
-import { INTERNAL, batch, copyItemState, createId, getDirtyFieldInput, getFieldBool, getFieldInput, getFieldStore, initializeFieldStore, resetItemState, setFieldInput, setInitialFieldInput, swapItemState, untrack, validateFormInput, validateIfRequired, walkFieldStore } from "../core/index.svelte";
+import { INTERNAL, batch, copyItemState, createId, focusFieldElement, getDirtyFieldInput, getFieldBool, getFieldInput, getFieldStore, initializeFieldStore, resetItemState, setFieldInput, setInitialFieldInput, swapItemState, untrack, validateFormInput, validateIfRequired, walkFieldStore } from "../core/index.svelte";
 
 //#region src/focus/focus.ts
 /**
-* 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.
 *
@@ -10,30 +10,35 @@ import { INTERNAL, batch, copyItemState, createId, getDirtyFieldInput, getFieldB
 * @param config The focus field configuration.
 */
 function focus(form, config) {
-	getFieldStore(form[INTERNAL], config.path).elements[0]?.focus();
+	focusFieldElement(getFieldStore(form[INTERNAL], config.path));
 }
 
 //#endregion
-//#region src/getAllErrors/getAllErrors.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.
-*
-* @param form The form store to retrieve errors from.
-*
-* @returns A non-empty array of error messages, or null if no errors exist.
-*/
+//#region src/getDeepErrorEntries/getDeepErrorEntries.ts
 /* @__NO_SIDE_EFFECTS__ */
-function getAllErrors(form) {
-	let allErrors = null;
-	walkFieldStore(form[INTERNAL], (internalFieldStore) => {
-		if (internalFieldStore.kind === "array") internalFieldStore.items.value;
+function getDeepErrorEntries(form, config) {
+	const entries = [];
+	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) entries.push({
+			path: internalFieldStore.path,
+			errors
+		});
 	});
-	return allErrors;
+	return entries;
+}
+
+//#endregion
+//#region src/getDeepErrors/getDeepErrors.ts
+/* @__NO_SIDE_EFFECTS__ */
+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 (deepErrors) deepErrors.push(...errors);
+		else deepErrors = [...errors];
+	});
+	return deepErrors;
 }
 
 //#endregion
@@ -47,9 +52,8 @@ function getDirtyInput(form, config) {
 //#region src/getDirtyPaths/getDirtyPaths.ts
 /* @__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;
 }
 
@@ -112,26 +116,51 @@ 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");
 	});
 }
 
+//#endregion
+//#region src/isDirty/isDirty.ts
+/* @__NO_SIDE_EFFECTS__ */
+function isDirty(form, config) {
+	return getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "isDirty");
+}
+
+//#endregion
+//#region src/isEdited/isEdited.ts
+/* @__NO_SIDE_EFFECTS__ */
+function isEdited(form, config) {
+	return getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "isEdited");
+}
+
+//#endregion
+//#region src/isTouched/isTouched.ts
+/* @__NO_SIDE_EFFECTS__ */
+function isTouched(form, config) {
+	return getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "isTouched");
+}
+
+//#endregion
+//#region src/isValid/isValid.ts
+/* @__NO_SIDE_EFFECTS__ */
+function isValid(form, config) {
+	return !getFieldBool(config?.path ? getFieldStore(form[INTERNAL], config.path) : form[INTERNAL], "errors");
+}
+
 //#endregion
 //#region src/move/move.ts
 /**
@@ -156,6 +185,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");
 	});
@@ -225,6 +255,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");
 	});
@@ -248,6 +279,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");
 	});
@@ -265,6 +297,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") {
@@ -335,6 +368,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");
 	});
@@ -357,4 +391,4 @@ function validate(form, config) {
 }
 
 //#endregion
-export { focus, getAllErrors, getDirtyInput, getDirtyPaths, getErrors, getInput, handleSubmit, insert, move, pickDirty, remove, replace, reset, setErrors, setInput, submit, swap, validate };
+export { focus, getDeepErrorEntries, getDeepErrors, getDirtyInput, getDirtyPaths, getErrors, getInput, handleSubmit, insert, isDirty, isEdited, isTouched, isValid, move, pickDirty, remove, replace, reset, setErrors, setInput, submit, swap, validate };

package/dist/runes/createForm/createForm.svelte.js

@@ -10,6 +10,7 @@ export function createForm(config) {
         }
     });
     const isTouched = $derived(getFieldBool(internalFormStore, 'isTouched'));
+    const isEdited = $derived(getFieldBool(internalFormStore, 'isEdited'));
     const isDirty = $derived(getFieldBool(internalFormStore, 'isDirty'));
     const isValid = $derived(!getFieldBool(internalFormStore, 'errors'));
     return {
@@ -26,6 +27,9 @@ export function createForm(config) {
         get isTouched() {
             return isTouched;
         },
+        get isEdited() {
+            return isEdited;
+        },
         get isDirty() {
             return isDirty;
         },

package/dist/runes/useField/useField.svelte.js

@@ -8,6 +8,7 @@ export function useField(form, config) {
     const internalFieldStore = $derived(getFieldStore(internalFormStore, path));
     const input = $derived(getFieldInput(internalFieldStore));
     const isTouched = $derived(getFieldBool(internalFieldStore, 'isTouched'));
+    const isEdited = $derived(getFieldBool(internalFieldStore, 'isEdited'));
     const isDirty = $derived(getFieldBool(internalFieldStore, 'isDirty'));
     const isValid = $derived(!getFieldBool(internalFieldStore, 'errors'));
     return {
@@ -23,6 +24,9 @@ export function useField(form, config) {
         get isTouched() {
             return isTouched;
         },
+        get isEdited() {
+            return isEdited;
+        },
         get isDirty() {
             return isDirty;
         },
@@ -41,7 +45,13 @@ export function useField(form, config) {
             [createAttachmentKey()](element) {
                 internalFieldStore.elements.push(element);
                 return () => {
-                    internalFieldStore.elements = internalFieldStore.elements.filter((el) => el !== element);
+                    const elements = internalFieldStore.elements.filter((el) => el !== element);
+                    // Keep `initialElements` in sync unless a reorder has moved the
+                    // elements, so resetting a remounted field restores its live element
+                    if (internalFieldStore.elements === internalFieldStore.initialElements) {
+                        internalFieldStore.initialElements = elements;
+                    }
+                    internalFieldStore.elements = elements;
                 };
             },
             onfocus() {

package/dist/runes/useFieldArray/useFieldArray.svelte.js

@@ -5,6 +5,7 @@ export function useFieldArray(form, config) {
     const path = $derived(unwrap(config).path);
     const internalFieldStore = $derived(getFieldStore(unwrap(form)[INTERNAL], path));
     const isTouched = $derived(getFieldBool(internalFieldStore, 'isTouched'));
+    const isEdited = $derived(getFieldBool(internalFieldStore, 'isEdited'));
     const isDirty = $derived(getFieldBool(internalFieldStore, 'isDirty'));
     const isValid = $derived(!getFieldBool(internalFieldStore, 'errors'));
     return {
@@ -20,6 +21,9 @@ export function useFieldArray(form, config) {
         get isTouched() {
             return isTouched;
         },
+        get isEdited() {
+            return isEdited;
+        },
         get isDirty() {
             return isDirty;
         },

package/dist/types/field.d.ts

@@ -54,6 +54,10 @@ export interface FieldStore<TSchema extends FormSchema = FormSchema, TFieldPath
      * Whether the field has been touched.
      */
     readonly isTouched: boolean;
+    /**
+     * Whether the field value has been edited.
+     */
+    readonly isEdited: boolean;
     /**
      * Whether the field input differs from its initial value.
      */
@@ -91,6 +95,10 @@ export interface FieldArrayStore<TSchema extends FormSchema = FormSchema, TField
      * Whether the field array has been touched.
      */
     readonly isTouched: boolean;
+    /**
+     * Whether the field array value has been edited.
+     */
+    readonly isEdited: boolean;
     /**
      * Whether the field array input differs from its initial value.
      */

package/dist/types/form.d.ts

@@ -19,6 +19,10 @@ export interface FormStore<TSchema extends FormSchema = FormSchema> extends Base
      * Whether any field in the form has been touched.
      */
     readonly isTouched: boolean;
+    /**
+     * Whether any field in the form has been edited.
+     */
+    readonly isEdited: boolean;
     /**
      * Whether any field in the form differs from its initial value.
      */
@@ -31,7 +35,7 @@ export interface FormStore<TSchema extends FormSchema = FormSchema> extends Base
      * The current error messages of the form.
      *
      * Hint: This property only contains validation errors at the root level
-     * of the form. To get all errors from all fields, use `getAllErrors`.
+     * of the form. To get all errors from all fields, use `getDeepErrors`.
      */
     readonly errors: [string, ...string[]] | null;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formisch/svelte",
   "description": "The lightweight, schema-first, and fully type-safe form library for Svelte",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "license": "MIT",
   "author": "Fabian Hiller",
   "homepage": "https://formisch.dev",
@@ -58,7 +58,8 @@
     "@sveltejs/vite-plugin-svelte": "^6.2.0",
     "@testing-library/jest-dom": "^6.6.0",
     "@testing-library/svelte": "^5.2.4",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@types/node": "24.0.13",
+    "@vitest/coverage-v8": "^4.1.7",
     "eslint": "^9.35.0",
     "eslint-plugin-svelte": "^3.12.2",
     "globals": "^16.4.0",
@@ -69,7 +70,7 @@
     "typescript": "^5.9.2",
     "valibot": "^1.4.1",
     "vite": "^7.1.5",
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
     "svelte": "^5.29.0",