notform 2.0.0-alpha.6 → 2.0.0-alpha.8

package/README.md

@@ -12,5 +12,5 @@
 ## Documentation
 
 For detailed guides, API reference, and examples, visit:
-**[notform-docs.vercel.app](https://notform-docs.vercel.app/)**
+**[notform-docs.vercel.app](https://notformdocs.vercel.app/)**
 

package/dist/index.d.ts

@@ -199,7 +199,7 @@ type NotFormProps = {
 };
 /** Slots for the `NotForm` component. */
 type NotFormSlots = {
-  default: [];
+  /** The default slot receives the full form instance */default: [];
 };
 //#endregion
 //#region src/composables/use-not-form.d.ts

package/dist/index.js

@@ -1,4 +1,4 @@
-import { computed, createBlock, createCommentVNode, createElementBlock, createTextVNode, defineComponent, guardReactiveProps, inject, markRaw, mergeProps, nextTick, normalizeProps, onMounted, openBlock, provide, reactive, ref, renderSlot, resolveDynamicComponent, toDisplayString, toValue, unref, useAttrs, withCtx } from "vue";
+import { computed, createBlock, createCommentVNode, createElementBlock, createTextVNode, defineComponent, guardReactiveProps, inject, markRaw, mergeProps, nextTick, normalizeProps, onMounted, openBlock, provide, reactive, ref, renderSlot, resolveDynamicComponent, toDisplayString, toValue, unref, useAttrs, watch, withCtx } from "vue";
 import { klona } from "klona/full";
 import { dequal } from "dequal";
 import { deepKeys, deleteProperty, getProperty, hasProperty, parsePath, setProperty } from "dot-prop";
@@ -56,6 +56,11 @@ function useNotForm(config) {
 	/**
 	* Mutable so `reset()` can replace the reference when new values are provided.
 	* Always deep-cloned to prevent external mutation from affecting the baseline.
+	*
+	* These are intentionally `let` — `reset()` replaces them, and the instance
+	* exposes them via getters so consumers always read the current snapshot.
+	* The `readonly` modifier on the type prevents external assignment while still
+	* allowing the getter to return the latest value after a reset.
 	*/
 	let initialValues = klona(config.initialValues ?? {});
 	let initialErrors = klona(config.initialErrors ?? []);
@@ -85,6 +90,25 @@ function useNotForm(config) {
 	const isSubmitting = ref(false);
 	const isValidating = ref(false);
 	/**
+	* Counter-based validation tracking.
+	*
+	* A boolean flag flips to `false` as soon as the first concurrent
+	* validation resolves, even if others are still running.
+	* A counter fixes this: `isValidating` stays `true` until every
+	* in-flight call has settled.
+	*/
+	let validatingCount = 0;
+	/** Increments the validation counter and sets `isValidating` to true. */
+	const beginValidating = () => {
+		validatingCount++;
+		isValidating.value = true;
+	};
+	/** Decrements the validation counter and sets `isValidating` to false if the counter reaches zero. */
+	const endValidating = () => {
+		validatingCount--;
+		if (validatingCount === 0) isValidating.value = false;
+	};
+	/**
 	* Reactive Sets using `reactive()` for the same Pinia-compatibility reason
 	* as `errors` above — `ref(new Set())` would be unwrapped to a plain Set.
 	*/
@@ -129,7 +153,7 @@ function useNotForm(config) {
 		return errors.filter((error) => isIssuePathEqual(error.path, pathSegments));
 	};
 	const validate = async () => {
-		isValidating.value = true;
+		beginValidating();
 		try {
 			const result = await runSchema();
 			if (result?.issues) {
@@ -139,11 +163,11 @@ function useNotForm(config) {
 			clearErrors();
 			return { value: result.value };
 		} finally {
-			isValidating.value = false;
+			endValidating();
 		}
 	};
 	const validateField = async (path) => {
-		isValidating.value = true;
+		beginValidating();
 		try {
 			const result = await runSchema();
 			const pathSegments = parsePath(path);
@@ -162,7 +186,7 @@ function useNotForm(config) {
 			}
 			return { value: getProperty(result.value, path) };
 		} finally {
-			isValidating.value = false;
+			endValidating();
 		}
 	};
 	const submit = async (event) => {
@@ -197,8 +221,12 @@ function useNotForm(config) {
 		dirtyFields.clear();
 	};
 	return markRaw({
-		initialValues,
-		initialErrors,
+		get initialValues() {
+			return initialValues;
+		},
+		get initialErrors() {
+			return initialErrors;
+		},
 		validateOn,
 		validationMode,
 		values,
@@ -533,6 +561,22 @@ var not_array_field_default = /* @__PURE__ */ defineComponent({
 			await nextTick();
 			if (validateOn.value.onMount) validate();
 		});
+		/**
+		* Syncs `itemKeys` whenever the underlying array changes outside of this
+		* component's own mutation methods — most commonly after `form.reset()`.
+		*
+		* Without this, `itemKeys` would be stale until the next mutation:
+		* - If the reset shrinks the array, a subsequent `append` would call
+		*   `syncKeys` and regenerate keys for the surviving items, causing
+		*   Vue to remount them unnecessarily.
+		* - If the reset grows the array, items render with `fallback` keys
+		*   until the next mutation, breaking key stability guarantees.
+		*
+		* Our own mutations already manage keys explicitly before writing to
+		* the array, so when this watcher fires after them, `syncKeys` is a
+		* cheap no-op (lengths already match).
+		*/
+		watch(array, () => syncKeys());
 		const slotProps = computed(() => ({
 			path: props.path,
 			items: items.value,

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "notform",
-  "version": "2.0.0-alpha.6",
+  "version": "2.0.0-alpha.8",
   "type": "module",
   "private": false,
   "description": "Vue Forms Without the Friction",
   "author": "Favour Emeka <favorodera@gmail.com>",
   "license": "MIT",
-  "homepage": "https://notform-docs.vercel.app/",
+  "homepage": "https://notformdocs.vercel.app/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/favorodera/notform.git"
@@ -57,7 +57,7 @@
     "vue form validator"
   ],
   "engines": {
-    "node": ">=24.13.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "build": "tsdown",