notform 1.0.0-alpha.3 → 1.0.0-alpha.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NotForm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -56,12 +56,12 @@ type Paths<TReference> = Paths$1<TReference, {
   leavesOnly: false;
 }> | (string & {});
 //#endregion
-//#region src/types/form.d.ts
+//#region src/types/not-form.d.ts
 /**
  * Configuration options for initializing a new form instance.
  * @template TSchema The validation schema type derived from ObjectSchema.
  */
-type UseFormOptions<TSchema extends ObjectSchema> = {
+type UseNotFormOptions<TSchema extends ObjectSchema> = {
   /** Unique form identifier (autogenerated if omitted) */
   id?: string;
   /** The validation schema used to parse and validate form data */
@@ -87,12 +87,17 @@ type UseFormOptions<TSchema extends ObjectSchema> = {
    * @param errors The list of identified issues.
    */
   onError?: (errors: StandardSchemaV1$1.Issue[]) => void;
+  /**
+   * Callback triggered when form validation passes and form is submitted.
+   * @param data The validated data from the schema.
+   */
+  onSubmit?: (data: StandardSchemaV1$1.InferOutput<TSchema>) => void | Promise<void>;
 };
 /**
  * The core state and methods provided by a form instance.
  * @template TSchema The validation schema type derived from ObjectSchema.
  */
-type FormContext<TSchema extends ObjectSchema> = {
+type NotFormContext<TSchema extends ObjectSchema> = {
   /** Unique form identifier */
   id: string;
   /** Deeply reactive object of field values */
@@ -175,39 +180,38 @@ type FormContext<TSchema extends ObjectSchema> = {
   /**
    * Validates and then triggers form submission.
    * @param event The original form submission event.
-   * @param callback Callback executed only if validation passes.
    */
-  submit: (event?: Event, callback?: (data: StandardSchemaV1$1.InferOutput<TSchema>) => void | Promise<void>) => Promise<void>;
+  submit: (event: Event) => Promise<void>;
 };
 /**
- * Properties accepted by the Form component.
+ * Properties accepted by the NotForm component.
  * @template TSchema The validation schema type derived from ObjectSchema.
  */
-type FormProps<TSchema extends ObjectSchema> = Pick<FormContext<TSchema>, 'id'> & /* @vue-ignore */Omit<FormHTMLAttributes, 'id'>;
+type NotFormProps<TSchema extends ObjectSchema> = Pick<NotFormContext<TSchema>, 'id'> & /* @vue-ignore */Omit<FormHTMLAttributes, 'id'>;
 /**
- * Slots provided by the Form component.
+ * Slots provided by the NotForm component.
  * @template TSchema The validation schema type derived from ObjectSchema.
  */
-type FormSlots<TSchema extends ObjectSchema> = {
+type NotFormSlots<TSchema extends ObjectSchema> = {
   /** The default slot receives the form context as its scope */
-  default: (props: FormContext<TSchema>) => VNodeChild;
+  default: (props: NotFormContext<TSchema>) => VNodeChild;
 };
 /**
- * Expected return type for the useForm composable.
+ * Expected return type for the useNotForm composable.
  * @template TSchema The validation schema type derived from ObjectSchema.
  */
-type UseFormReturn<TSchema extends ObjectSchema> = FormContext<TSchema>;
+type UseNotFormReturn<TSchema extends ObjectSchema> = NotFormContext<TSchema>;
 //#endregion
-//#region src/types/field.d.ts
-/** Configuration properties for the Field component */
-type FieldProps = {
+//#region src/types/not-field.d.ts
+/** Configuration properties for the NotField component */
+type NotFieldProps = {
   /** The unique name/path identifying the field within the form state */
   name: string;
 };
 /**
- * State and methods provided to the Field component's scope.
+ * State and methods provided to the NotField component's scope.
  */
-type FieldContext = {
+type NotFieldContext = {
   /** The name/path of the field */
   name: string;
   /** Array of validation error messages currently active for this field */
@@ -235,45 +239,45 @@ type FieldContext = {
   };
 };
 /**
- * Slots provided by the Field component.
+ * Slots provided by the NotField component.
  */
-type FieldSlots = {
+type NotFieldSlots = {
   /** The default slot receives the field context for use within templates */
-  default: (props: FieldContext) => VNodeChild;
+  default: (props: NotFieldContext) => VNodeChild;
 };
 //#endregion
-//#region src/types/message.d.ts
+//#region src/types/not-message.d.ts
 /**
- * Configuration properties for the Message component.
+ * Configuration properties for the NotMessage component.
  * @template TSchema The validation schema type derived from ObjectSchema.
  */
-type MessageProps<TSchema extends ObjectSchema> = {
+type NotMessageProps<TSchema extends ObjectSchema> = {
   /** The name/path of the field whose error message should be displayed */
   name: Paths$1<StandardSchemaV1$1.InferInput<TSchema>>;
 };
 /**
- * State provided to the Message component's scope.
+ * State provided to the NotMessage component's scope.
  */
-type MessageContext = {
+type NotMessageContext = {
   /** The first active validation error message for the specified field */
-  message: FieldContext['errors'][number];
+  message: NotFieldContext['errors'][number];
 };
 /**
- * Slots provided by the Message component.
+ * Slots provided by the NotMessage component.
  */
-type MessageSlots = {
+type NotMessageSlots = {
   /** The default slot receives the error message context for custom rendering */
-  default: (props: MessageContext) => VNodeChild;
+  default: (props: NotMessageContext) => VNodeChild;
 };
 //#endregion
-//#region src/components/Form.vue.d.ts
+//#region src/components/not-form.vue.d.ts
 declare const __VLS_export$3: <TSchema extends ObjectSchema>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$2<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-  props: vue0.PublicProps & __VLS_PrettifyLocal$2<FormProps<TSchema>> & (typeof globalThis extends {
+  props: vue0.PublicProps & __VLS_PrettifyLocal$2<NotFormProps<TSchema>> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
   expose: (exposed: {}) => void;
   attrs: any;
-  slots: FormSlots<TSchema>;
+  slots: NotFormSlots<TSchema>;
   emit: {};
 }>) => vue0.VNode & {
   __ctx?: Awaited<typeof __VLS_setup>;
@@ -281,12 +285,12 @@ declare const __VLS_export$3: <TSchema extends ObjectSchema>(__VLS_props: NonNul
 declare const _default$2: typeof __VLS_export$3;
 type __VLS_PrettifyLocal$2<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
 //#endregion
-//#region src/components/Field.vue.d.ts
+//#region src/components/not-field.vue.d.ts
 /**
- * Slots provided by the Field component.
+ * Slots provided by the NotField component.
  */
-type __VLS_Slots = FieldSlots;
-declare const __VLS_base: vue0.DefineComponent<FieldProps, {}, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<FieldProps> & Readonly<{}>, {}, {}, {}, {}, string, vue0.ComponentProvideOptions, false, {}, any>;
+type __VLS_Slots = NotFieldSlots;
+declare const __VLS_base: vue0.DefineComponent<NotFieldProps, {}, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<NotFieldProps> & Readonly<{}>, {}, {}, {}, {}, string, vue0.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$2: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default$1: typeof __VLS_export$2;
 type __VLS_WithSlots<T, S> = T & {
@@ -295,14 +299,14 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-//#region src/components/Message.vue.d.ts
+//#region src/components/not-message.vue.d.ts
 declare const __VLS_export$1: <TSchema extends ObjectSchema>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$1<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-  props: vue0.PublicProps & __VLS_PrettifyLocal$1<MessageProps<TSchema>> & (typeof globalThis extends {
+  props: vue0.PublicProps & __VLS_PrettifyLocal$1<NotMessageProps<TSchema>> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
   expose: (exposed: {}) => void;
   attrs: any;
-  slots: MessageSlots;
+  slots: NotMessageSlots;
   emit: {};
 }>) => vue0.VNode & {
   __ctx?: Awaited<typeof __VLS_setup>;
@@ -310,22 +314,22 @@ declare const __VLS_export$1: <TSchema extends ObjectSchema>(__VLS_props: NonNul
 declare const _default$3: typeof __VLS_export$1;
 type __VLS_PrettifyLocal$1<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
 //#endregion
-//#region src/types/array-field.d.ts
+//#region src/types/not-array-field.d.ts
 /**
- * Properties accepted by the ArrayField component.
+ * Properties accepted by the NotArrayField component.
  * @template TSchema The schema of the array field.
  */
-type ArrayFieldProps<TSchema extends ArraySchema> = {
+type NotArrayFieldProps<TSchema extends ArraySchema> = {
   /** The unique name/path identifying the array field in the form state */
   name: string;
   /** The specific schema instance used to validate the array items */
   schema: TSchema;
 };
 /**
- * The core state and methods provided by an ArrayField instance.
+ * The core state and methods provided by an NotArrayField instance.
  * @template TSchema The schema of the array field.
  */
-type ArrayFieldContext<TSchema extends ArraySchema> = {
+type NotArrayFieldContext<TSchema extends ArraySchema> = {
   /**
    * Array of individual field contexts for each item in the collection.
    * Useful for mapping components to array elements.
@@ -367,22 +371,22 @@ type ArrayFieldContext<TSchema extends ArraySchema> = {
   update: (index: number, data: StandardSchemaV1$1.InferInput<TSchema>[number]) => void;
 };
 /**
- * Slots provided by the ArrayField component.
+ * Slots provided by the NotArrayField component.
  * @template TSchema The schema of the array field.
  */
-type ArrayFieldSlots<TSchema extends ArraySchema> = {
+type NotArrayFieldSlots<TSchema extends ArraySchema> = {
   /** The default slot receives the array field context as its scope */
-  default: (props: ArrayFieldContext<TSchema>) => VNodeChild;
+  default: (props: NotArrayFieldContext<TSchema>) => VNodeChild;
 };
 //#endregion
-//#region src/components/ArrayField.vue.d.ts
+//#region src/components/not-array-field.vue.d.ts
 declare const __VLS_export: <TArraySchema extends ArraySchema, TObjectSchema extends ObjectSchema = ObjectSchema>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-  props: vue0.PublicProps & __VLS_PrettifyLocal<ArrayFieldProps<TArraySchema>> & (typeof globalThis extends {
+  props: vue0.PublicProps & __VLS_PrettifyLocal<NotArrayFieldProps<TArraySchema>> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
   expose: (exposed: {}) => void;
   attrs: any;
-  slots: ArrayFieldSlots<TArraySchema>;
+  slots: NotArrayFieldSlots<TArraySchema>;
   emit: {};
 }>) => vue0.VNode & {
   __ctx?: Awaited<typeof __VLS_setup>;
@@ -390,16 +394,16 @@ declare const __VLS_export: <TArraySchema extends ArraySchema, TObjectSchema ext
 declare const _default: typeof __VLS_export;
 type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
 //#endregion
-//#region src/composables/use-form.d.ts
+//#region src/composables/use-not-form.d.ts
 /**
  * Initializes a form instance with validation logic, reactive state, and lifecycle methods.
  * @template TSchema The validation schema type derived from ObjectSchema.
  * @param options Configuration object for the form behavior and initial state.
  * @returns The gathered form context object.
  */
-declare function useForm<TSchema extends ObjectSchema>(options: UseFormOptions<TSchema>): UseFormReturn<TSchema>;
+declare function useNotForm<TSchema extends ObjectSchema>(options: UseNotFormOptions<TSchema>): UseNotFormReturn<TSchema>;
 //#endregion
-//#region src/utils/form-context.d.ts
+//#region src/utils/not-form-context.d.ts
 /**
  * Locates and returns the active form context associated with a given ID.
  * @template TSchema The validation schema type derived from ObjectSchema.
@@ -407,6 +411,6 @@ declare function useForm<TSchema extends ObjectSchema>(options: UseFormOptions<T
  * @returns The resolved form context object.
  * @throws Error if the context cannot be found in the current component tree.
  */
-declare function withContext<TSchema extends ObjectSchema>(id: string): FormContext<TSchema>;
+declare function withContext<TSchema extends ObjectSchema>(id: string): NotFormContext<TSchema>;
 //#endregion
-export { _default as ArrayField, ArraySchema, DeepPartial, _default$1 as Field, FieldContext, FieldProps, FieldSlots, _default$2 as Form, FormContext, FormProps, FormSlots, _default$3 as Message, MessageContext, MessageProps, MessageSlots, ObjectSchema, Paths, type StandardSchemaV1, UseFormOptions, UseFormReturn, ValidationMode, ValidationTriggers, useForm, withContext };
+export { ArraySchema, DeepPartial, _default as NotArrayField, _default$1 as NotField, NotFieldContext, NotFieldProps, NotFieldSlots, _default$2 as NotForm, NotFormContext, NotFormProps, NotFormSlots, _default$3 as NotMessage, NotMessageContext, NotMessageProps, NotMessageSlots, ObjectSchema, Paths, type StandardSchemaV1, UseNotFormOptions, UseNotFormReturn, ValidationMode, ValidationTriggers, useNotForm, withContext };

package/dist/index.js

@@ -1,23 +1,23 @@
 import { computed, createElementBlock, createElementVNode, defineComponent, guardReactiveProps, inject, mergeProps, nextTick, normalizeProps, onMounted, openBlock, provide, reactive, ref, renderSlot, toDisplayString, toValue, unref, useId, vShow, withDirectives } from "vue";
 import { getProperty, parsePath, setProperty } from "dot-prop";
 
-//#region src/utils/form-context.ts
+//#region src/utils/not-form-context.ts
 /** Internal registry mapping form IDs to their injection keys */
-const formContextKeys = /* @__PURE__ */ new Map();
+const notFormContextKeys = /* @__PURE__ */ new Map();
 /** Injection key for the unique identifier of the current active form */
-const CURRENT_FORM_ID_KEY = Symbol("valid:form:id");
+const CURRENT_NOT_FORM_ID_KEY = Symbol("notform:id");
 /**
 * Retrieves an existing injection key or creates a new one for a form ID.
 * @template TSchema The validation schema type derived from ObjectSchema.
 * @param id The unique string identifier for the form.
 * @returns A strictly typed InjectionKey for the form context.
 */
-function getFormContextKey(id) {
-	if (!formContextKeys.has(id)) {
-		const key = Symbol(`valid:form:${id}:context`);
-		formContextKeys.set(id, key);
+function getNotFormContextKey(id) {
+	if (!notFormContextKeys.has(id)) {
+		const key = Symbol(`notform:${id}:context`);
+		notFormContextKeys.set(id, key);
 	}
-	return formContextKeys.get(id);
+	return notFormContextKeys.get(id);
 }
 /**
 * Locates and returns the active form context associated with a given ID.
@@ -27,20 +27,20 @@ function getFormContextKey(id) {
 * @throws Error if the context cannot be found in the current component tree.
 */
 function withContext(id) {
-	const context = inject(getFormContextKey(id));
+	const context = inject(getNotFormContextKey(id));
 	if (!context) throw new Error(`No form context found for form with id "${id}"`);
 	return context;
 }
 
 //#endregion
-//#region src/components/Form.vue?vue&type=script&setup=true&lang.ts
+//#region src/components/not-form.vue?vue&type=script&setup=true&lang.ts
 const _hoisted_1 = ["id"];
 /**
 * Provides form context and a structural wrapper for form fields.
 * @template TSchema The validation schema type derived from ObjectSchema.
 */
-var Form_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
-	__name: "Form",
+var not_form_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	__name: "not-form",
 	props: { id: {
 		type: String,
 		required: true
@@ -51,7 +51,7 @@ var Form_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCom
 		* Slots provided by the Form component.
 		*/
 		const form = withContext(props.id);
-		provide(CURRENT_FORM_ID_KEY, props.id);
+		provide(CURRENT_NOT_FORM_ID_KEY, props.id);
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("form", mergeProps(_ctx.$attrs, { id: props.id }), [renderSlot(_ctx.$slots, "default", normalizeProps(guardReactiveProps(unref(form))))], 16, _hoisted_1);
 		};
@@ -59,17 +59,17 @@ var Form_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCom
 });
 
 //#endregion
-//#region src/components/Form.vue
-var Form_default = Form_vue_vue_type_script_setup_true_lang_default;
+//#region src/components/not-form.vue
+var not_form_default = not_form_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
-//#region src/components/Field.vue?vue&type=script&setup=true&lang.ts
+//#region src/components/not-field.vue?vue&type=script&setup=true&lang.ts
 /**
 * Component for individual form fields.
 * Manages field-level state, validation triggers, and events.
 */
-var Field_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
-	__name: "Field",
+var not_field_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	__name: "not-field",
 	props: { name: {
 		type: String,
 		required: true
@@ -77,10 +77,10 @@ var Field_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 	setup(__props) {
 		const props = __props;
 		/**
-		* Slots provided by the Field component.
+		* Slots provided by the NotField component.
 		*/
-		const formID = inject(CURRENT_FORM_ID_KEY);
-		if (!formID) throw new Error("Field must be used inside a Form component");
+		const formID = inject(CURRENT_NOT_FORM_ID_KEY);
+		if (!formID) throw new Error("NotField must be used inside a NotForm component");
 		const { mode, validateOn, touchedFields, dirtyFields, validateField, getFieldErrors, touchField, dirtyField } = withContext(formID);
 		/**
 		* Triggers validation for this specific field.
@@ -129,17 +129,17 @@ var Field_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 });
 
 //#endregion
-//#region src/components/Field.vue
-var Field_default = Field_vue_vue_type_script_setup_true_lang_default;
+//#region src/components/not-field.vue
+var not_field_default = not_field_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
-//#region src/components/Message.vue?vue&type=script&setup=true&lang.ts
+//#region src/components/not-message.vue?vue&type=script&setup=true&lang.ts
 /**
 * Displays validation error messages for a specific form field.
 * @template TSchema The validation schema type derived from ObjectSchema.
 */
-var Message_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
-	__name: "Message",
+var not_message_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	__name: "not-message",
 	props: { name: {
 		type: null,
 		required: true
@@ -149,8 +149,8 @@ var Message_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ define
 		/**
 		* Slots provided by the Message component.
 		*/
-		const formID = inject(CURRENT_FORM_ID_KEY);
-		if (!formID) throw new Error("Message must be used inside a Form component");
+		const formID = inject(CURRENT_NOT_FORM_ID_KEY);
+		if (!formID) throw new Error("Message must be used inside a NotForm component");
 		const { getFieldErrors } = withContext(formID);
 		/**
 		* The reactive state provided to the component's slot.
@@ -163,19 +163,19 @@ var Message_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ define
 });
 
 //#endregion
-//#region src/components/Message.vue
-var Message_default = Message_vue_vue_type_script_setup_true_lang_default;
+//#region src/components/not-message.vue
+var not_message_default = not_message_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
-//#region src/components/ArrayField.vue?vue&type=script&setup=true&lang.ts
+//#region src/components/not-array-field.vue?vue&type=script&setup=true&lang.ts
 /**
 * Component for managing array-based form fields.
 * Provides methods for adding, removing, and updating array items.
 * @template TArraySchema Schema for the array field.
 * @template TObjectSchema Parent form object schema.
 */
-var ArrayField_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
-	__name: "ArrayField",
+var not_array_field_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	__name: "not-array-field",
 	props: {
 		name: {
 			type: String,
@@ -189,10 +189,10 @@ var ArrayField_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ def
 	setup(__props) {
 		const props = __props;
 		/**
-		* Slots provided by the ArrayField component.
+		* Slots provided by the NotArrayField component.
 		*/
-		const formID = inject(CURRENT_FORM_ID_KEY);
-		if (!formID) throw new Error("ArrayField must be used inside a Form component");
+		const formID = inject(CURRENT_NOT_FORM_ID_KEY);
+		if (!formID) throw new Error("NotArrayField must be used inside a NotForm component");
 		const { state, validateField } = withContext(formID);
 		/**
 		* Reactive bridge between the form state and the specific array field.
@@ -265,7 +265,7 @@ var ArrayField_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ def
 			arrayState.value = newArray;
 		}
 		/**
-		* Reactive context object exposed to the ArrayField slot.
+		* Reactive context object exposed to the NotArrayField slot.
 		*/
 		const context = reactive({
 			fields,
@@ -283,8 +283,8 @@ var ArrayField_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ def
 });
 
 //#endregion
-//#region src/components/ArrayField.vue
-var ArrayField_default = ArrayField_vue_vue_type_script_setup_true_lang_default;
+//#region src/components/not-array-field.vue
+var not_array_field_default = not_array_field_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
 //#region src/utils/helpers.ts
@@ -336,19 +336,19 @@ function getObjectPaths(object, prefix = "") {
 }
 
 //#endregion
-//#region src/composables/use-form.ts
+//#region src/composables/use-not-form.ts
 /**
 * Initializes a form instance with validation logic, reactive state, and lifecycle methods.
 * @template TSchema The validation schema type derived from ObjectSchema.
 * @param options Configuration object for the form behavior and initial state.
 * @returns The gathered form context object.
 */
-function useForm(options) {
+function useNotForm(options) {
 	const { id = useId(), schema: _schema, initialErrors: _initialErrors = [], initialState: _initialState = {}, mode = "eager", validateOn = [
 		"blur",
 		"input",
 		"change"
-	], onValidate, onReset, onError } = options;
+	], onValidate, onReset, onError, onSubmit } = options;
 	/** Active validation schema reference */
 	const schema = computed(() => toValue(_schema));
 	/** Baseline reactive state at creation */
@@ -482,23 +482,35 @@ function useForm(options) {
 			const paths = getObjectPaths(context.state.value);
 			context.dirtyFields.value = new Set(paths);
 		},
-		async submit(event, callback) {
-			event?.preventDefault();
-			event?.stopPropagation();
-			const result = await context.validate();
-			if (result.issues) {
-				context.errors.value = [...result.issues];
-				return;
+		async submit(event) {
+			try {
+				context.touchAllFields();
+				context.dirtyAllFields();
+				const result = await context.validate();
+				if (result.issues) {
+					event.preventDefault();
+					const errors = [...result.issues];
+					context.errors.value = errors;
+					onError?.(errors);
+					return;
+				}
+				if (onSubmit) {
+					event.preventDefault();
+					await onSubmit(result.value);
+				}
+			} catch {
+				event.preventDefault();
+				onError?.([{
+					message: "An unexpected error occurred during submission",
+					path: []
+				}]);
 			}
-			context.touchAllFields();
-			context.dirtyAllFields();
-			if (callback) await callback(result.value);
 		}
 	};
-	provide(getFormContextKey(id), context);
+	provide(getNotFormContextKey(id), context);
 	return context;
 }
-var use_form_default = useForm;
+var use_not_form_default = useNotForm;
 
 //#endregion
-export { ArrayField_default as ArrayField, Field_default as Field, Form_default as Form, Message_default as Message, use_form_default as useForm, withContext };
+export { not_array_field_default as NotArrayField, not_field_default as NotField, not_form_default as NotForm, not_message_default as NotMessage, use_not_form_default as useNotForm, withContext };

package/package.json

@@ -5,8 +5,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.0.0-alpha.3",
-  "description": "Smooth Vue Forms Validation",
+  "version": "1.0.0-alpha.5",
+  "description": "Effortless Vue Forms Validation",
   "author": "Favour Emeka <favorodera@gmail.com>",
   "license": "MIT",
   "homepage": "https://github.com/favorodera/notform#readme",
@@ -47,7 +47,7 @@
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "^5.7.0",
-    "@types/node": "^25.0.3",
+    "@types/node": "^25.0.10",
     "@vitejs/plugin-vue": "^6.0.3",
     "@vitest/browser-playwright": "^4.0.16",
     "@vitest/eslint-plugin": "^1.6.6",

package/README.md

@@ -1,29 +0,0 @@
-# vue-components-starter
-
-A starter for creating a Vue component library.
-
-## Development
-
-- Install dependencies:
-
-```bash
-npm install
-```
-
-- Run the playground:
-
-```bash
-npm run playground
-```
-
-- Run the unit tests:
-
-```bash
-npm run test
-```
-
-- Build the library:
-
-```bash
-npm run build
-```