@neutro/form 0.0.5 → 0.1.0

package/dist/adapters/angular.cjs

@@ -29,9 +29,10 @@ module.exports = __toCommonJS(angular_exports);
 var import_core = require("@angular/core");
 function useAngularForm(form) {
   const formSignal = (0, import_core.signal)(form.getState());
-  const unsubscribe = form.subscribe((s) => {
-    formSignal.set(s);
-  });
+  const zone = (0, import_core.inject)(import_core.NgZone, { optional: true });
+  const unsubscribe = form.subscribe(
+    (s) => zone ? zone.run(() => formSignal.set(s)) : formSignal.set(s)
+  );
   (0, import_core.inject)(import_core.DestroyRef).onDestroy(unsubscribe);
   return {
     state: formSignal.asReadonly(),
@@ -42,19 +43,36 @@ function useAngularForm(form) {
     handleSubmit: form.handleSubmit,
     reset: form.reset,
     batch: form.batch,
+    validate: form.validate,
+    subscribeToPath: form.subscribeToPath,
+    getPayload: form.getPayload,
+    getAriaProps: form.getAriaProps,
+    getFieldMode: form.getFieldMode,
+    getConnectedCount: form.getConnectedCount,
+    destroy: form.destroy,
     arrayAppend: form.arrayAppend,
     arrayInsert: form.arrayInsert,
     arrayRemove: form.arrayRemove,
     arrayMove: form.arrayMove,
-    arraySwap: form.arraySwap
+    arraySwap: form.arraySwap,
+    setErrors: form.setErrors,
+    clearErrors: form.clearErrors
   };
 }
 function useAngularFormPath(form, path) {
   const value = (0, import_core.signal)(form.get(path));
   const fieldState = (0, import_core.signal)(null);
+  const zone = (0, import_core.inject)(import_core.NgZone, { optional: true });
   const unsubscribe = form.subscribeToPath(path, (v, fs) => {
-    value.set(v);
-    fieldState.set(fs);
+    if (zone) {
+      zone.run(() => {
+        value.set(v);
+        fieldState.set(fs);
+      });
+    } else {
+      value.set(v);
+      fieldState.set(fs);
+    }
   });
   (0, import_core.inject)(import_core.DestroyRef).onDestroy(unsubscribe);
   return { value: value.asReadonly(), fieldState: fieldState.asReadonly() };

package/dist/adapters/angular.d.cts

@@ -1,27 +1,171 @@
-import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
 
-declare function useAngularForm<T extends object>(form: any): {
-    state: _angular_core.Signal<any>;
-    get: any;
-    set: any;
-    connect: any;
-    submit: any;
-    handleSubmit: any;
-    reset: any;
-    batch: any;
-    arrayAppend: any;
-    arrayInsert: any;
-    arrayRemove: any;
-    arrayMove: any;
-    arraySwap: any;
+/**
+ * @neutro/form-core
+ * High-Performance, Zero-Dependency, Framework-Agnostic Reactive Form Engine.
+ */
+type Primitive = string | number | boolean | null | undefined | Date | File;
+type Prev = [never, 0, 1, 2, 3, 4, 5, ...any[]];
+type PathImpl<T, K extends keyof T, Depth extends number = 5> = [Depth] extends [never] ? never : K extends string ? T[K] extends Primitive ? K : T[K] extends Array<infer U> ? K | `${K}.${number}` | (U extends object ? `${K}.${number}.${PathImpl<U, keyof U, Prev[Depth]>}` : never) : NonNullable<T[K]> extends object ? K | `${K}.${PathImpl<NonNullable<T[K]>, keyof NonNullable<T[K]>, Prev[Depth]>}` : K : never;
+type Path<T> = PathImpl<T, keyof T> & string;
+type _GetPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? _GetPathValue<NonNullable<T[K]>, Rest> : T extends readonly any[] ? _GetPathValue<NonNullable<T[number]>, Rest> : unknown : P extends keyof T ? T[P] : T extends readonly any[] ? T[number] : unknown;
+type GetPathValue<T, P extends string> = _GetPathValue<T, P>;
+interface FormState<T> {
+    values: T;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    dirty: Record<string, boolean>;
+    isSubmitting: boolean;
+    isValidating: boolean;
+}
+type FormSubscriber<T> = (state: FormState<T>) => void;
+type PathSubscriber<V = any> = (value: V, fieldState: {
+    error?: string;
+    touched?: boolean;
+    dirty?: boolean;
+}) => void;
+type ValidationMode = 'onChange' | 'onBlur' | 'onTouched' | 'onSubmitOnly';
+type FormAction = {
+    type: 'SET';
+    path: string;
+    value: unknown;
+    options?: {
+        touch?: boolean;
+        validate?: boolean;
+    };
+} | {
+    type: 'VALIDATE';
+    paths?: string[];
+} | {
+    type: 'SUBMIT';
+} | {
+    type: 'RESET';
+    newValues?: unknown;
+} | {
+    type: 'SET_ERRORS';
+    errors: Record<string, string>;
+} | {
+    type: 'CONNECT';
+    path: string;
+} | {
+    type: 'DISCONNECT';
+    path: string;
+} | {
+    type: 'BLUR';
+    path: string;
+} | {
+    type: 'BATCH_START';
+} | {
+    type: 'BATCH_END';
+} | {
+    type: 'ARRAY_APPEND';
+    path: string;
+    item: unknown;
+} | {
+    type: 'ARRAY_INSERT';
+    path: string;
+    index: number;
+    item: unknown;
+} | {
+    type: 'ARRAY_REMOVE';
+    path: string;
+    index: number;
+} | {
+    type: 'ARRAY_MOVE';
+    path: string;
+    from: number;
+    to: number;
+} | {
+    type: 'ARRAY_SWAP';
+    path: string;
+    i: number;
+    j: number;
+} | {
+    type: 'CLEAR_ERRORS';
 };
-declare function useAngularFormPath(form: any, path: string): {
-    value: _angular_core.Signal<unknown>;
-    fieldState: _angular_core.Signal<{
+interface AriaPropsOptions {
+    required?: boolean;
+    errorId?: string;
+}
+interface AriaProps {
+    'aria-invalid': 'true' | 'false';
+    'aria-describedby': string | undefined;
+    'aria-required': true | undefined;
+}
+interface ConnectOptions {
+    persist?: boolean;
+    format?: (val: string) => string;
+    validateOn?: ValidationMode;
+}
+interface FormInstance<T extends object> {
+    subscribe: (fn: FormSubscriber<T>) => () => void;
+    subscribeToPath<P extends Path<T>>(path: P, fn: PathSubscriber<GetPathValue<T, P>>): () => void;
+    subscribeToPath(path: string, fn: PathSubscriber): () => void;
+    get<P extends Path<T>>(path: P): GetPathValue<T, P>;
+    get(path: string | string[]): any;
+    set: (path: Path<T> | string | string[], val: any, options?: {
+        touch?: boolean;
+        validate?: boolean;
+    }) => void;
+    validate: (scopePaths?: Path<T>[] | string[] | string[][]) => Promise<boolean>;
+    connect: (path: Path<T> | string, el: HTMLElement, options?: ConnectOptions) => () => void;
+    submit: (onValid: (payload: Partial<T>) => void | Promise<void>) => Promise<boolean>;
+    handleSubmit: (onValid: (payload: Partial<T>) => void | Promise<void>, onInvalid?: (errors: Record<string, string>) => void) => (e?: Event) => void;
+    getState: () => FormState<T>;
+    getPayload: () => Partial<T>;
+    getAriaProps: (path: Path<T> | string, options?: AriaPropsOptions) => AriaProps;
+    batch: (fn: () => void) => void;
+    arrayAppend: (path: Path<T> | string | string[], item: any) => void;
+    arrayInsert: (path: Path<T> | string | string[], index: number, item: any) => void;
+    arrayRemove: (path: Path<T> | string | string[], index: number) => void;
+    arrayMove: (path: Path<T> | string | string[], fromIndex: number, toIndex: number) => void;
+    arraySwap: (path: Path<T> | string | string[], indexA: number, indexB: number) => void;
+    reset: (newValues?: T) => void;
+    getConnectedCount: () => number;
+    destroy: () => void;
+    setErrors: (errors: Record<Path<T> | (string & {}), string>) => void;
+    clearErrors: () => void;
+    /**
+     * Returns the effective ValidationMode for a field. Useful for debugging
+     * validation timing; framework adapters should rely on this only in custom
+     * event handlers, not in render logic.
+     */
+    getFieldMode: (path: string) => ValidationMode;
+    _subscribeToActions: (fn: (action: FormAction, state: FormState<T>) => void) => () => void;
+}
+
+interface AngularFormReturn<T extends object> {
+    state: Signal<FormState<T>>;
+    get: FormInstance<T>['get'];
+    set: FormInstance<T>['set'];
+    connect: FormInstance<T>['connect'];
+    submit: FormInstance<T>['submit'];
+    handleSubmit: FormInstance<T>['handleSubmit'];
+    reset: FormInstance<T>['reset'];
+    batch: FormInstance<T>['batch'];
+    validate: FormInstance<T>['validate'];
+    subscribeToPath: FormInstance<T>['subscribeToPath'];
+    getPayload: FormInstance<T>['getPayload'];
+    getAriaProps: FormInstance<T>['getAriaProps'];
+    getFieldMode: FormInstance<T>['getFieldMode'];
+    getConnectedCount: FormInstance<T>['getConnectedCount'];
+    destroy: FormInstance<T>['destroy'];
+    arrayAppend: FormInstance<T>['arrayAppend'];
+    arrayInsert: FormInstance<T>['arrayInsert'];
+    arrayRemove: FormInstance<T>['arrayRemove'];
+    arrayMove: FormInstance<T>['arrayMove'];
+    arraySwap: FormInstance<T>['arraySwap'];
+    setErrors: FormInstance<T>['setErrors'];
+    clearErrors: FormInstance<T>['clearErrors'];
+}
+declare function useAngularForm<T extends object>(form: FormInstance<T>): AngularFormReturn<T>;
+declare function useAngularFormPath<T extends object>(form: FormInstance<T>, path: string): {
+    value: Signal<unknown>;
+    fieldState: Signal<{
         error?: string;
         touched?: boolean;
         dirty?: boolean;
     } | null>;
 };
 
-export { useAngularForm, useAngularFormPath };
+export { type AngularFormReturn, useAngularForm, useAngularFormPath };

package/dist/adapters/angular.d.ts

@@ -1,27 +1,171 @@
-import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
 
-declare function useAngularForm<T extends object>(form: any): {
-    state: _angular_core.Signal<any>;
-    get: any;
-    set: any;
-    connect: any;
-    submit: any;
-    handleSubmit: any;
-    reset: any;
-    batch: any;
-    arrayAppend: any;
-    arrayInsert: any;
-    arrayRemove: any;
-    arrayMove: any;
-    arraySwap: any;
+/**
+ * @neutro/form-core
+ * High-Performance, Zero-Dependency, Framework-Agnostic Reactive Form Engine.
+ */
+type Primitive = string | number | boolean | null | undefined | Date | File;
+type Prev = [never, 0, 1, 2, 3, 4, 5, ...any[]];
+type PathImpl<T, K extends keyof T, Depth extends number = 5> = [Depth] extends [never] ? never : K extends string ? T[K] extends Primitive ? K : T[K] extends Array<infer U> ? K | `${K}.${number}` | (U extends object ? `${K}.${number}.${PathImpl<U, keyof U, Prev[Depth]>}` : never) : NonNullable<T[K]> extends object ? K | `${K}.${PathImpl<NonNullable<T[K]>, keyof NonNullable<T[K]>, Prev[Depth]>}` : K : never;
+type Path<T> = PathImpl<T, keyof T> & string;
+type _GetPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? _GetPathValue<NonNullable<T[K]>, Rest> : T extends readonly any[] ? _GetPathValue<NonNullable<T[number]>, Rest> : unknown : P extends keyof T ? T[P] : T extends readonly any[] ? T[number] : unknown;
+type GetPathValue<T, P extends string> = _GetPathValue<T, P>;
+interface FormState<T> {
+    values: T;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    dirty: Record<string, boolean>;
+    isSubmitting: boolean;
+    isValidating: boolean;
+}
+type FormSubscriber<T> = (state: FormState<T>) => void;
+type PathSubscriber<V = any> = (value: V, fieldState: {
+    error?: string;
+    touched?: boolean;
+    dirty?: boolean;
+}) => void;
+type ValidationMode = 'onChange' | 'onBlur' | 'onTouched' | 'onSubmitOnly';
+type FormAction = {
+    type: 'SET';
+    path: string;
+    value: unknown;
+    options?: {
+        touch?: boolean;
+        validate?: boolean;
+    };
+} | {
+    type: 'VALIDATE';
+    paths?: string[];
+} | {
+    type: 'SUBMIT';
+} | {
+    type: 'RESET';
+    newValues?: unknown;
+} | {
+    type: 'SET_ERRORS';
+    errors: Record<string, string>;
+} | {
+    type: 'CONNECT';
+    path: string;
+} | {
+    type: 'DISCONNECT';
+    path: string;
+} | {
+    type: 'BLUR';
+    path: string;
+} | {
+    type: 'BATCH_START';
+} | {
+    type: 'BATCH_END';
+} | {
+    type: 'ARRAY_APPEND';
+    path: string;
+    item: unknown;
+} | {
+    type: 'ARRAY_INSERT';
+    path: string;
+    index: number;
+    item: unknown;
+} | {
+    type: 'ARRAY_REMOVE';
+    path: string;
+    index: number;
+} | {
+    type: 'ARRAY_MOVE';
+    path: string;
+    from: number;
+    to: number;
+} | {
+    type: 'ARRAY_SWAP';
+    path: string;
+    i: number;
+    j: number;
+} | {
+    type: 'CLEAR_ERRORS';
 };
-declare function useAngularFormPath(form: any, path: string): {
-    value: _angular_core.Signal<unknown>;
-    fieldState: _angular_core.Signal<{
+interface AriaPropsOptions {
+    required?: boolean;
+    errorId?: string;
+}
+interface AriaProps {
+    'aria-invalid': 'true' | 'false';
+    'aria-describedby': string | undefined;
+    'aria-required': true | undefined;
+}
+interface ConnectOptions {
+    persist?: boolean;
+    format?: (val: string) => string;
+    validateOn?: ValidationMode;
+}
+interface FormInstance<T extends object> {
+    subscribe: (fn: FormSubscriber<T>) => () => void;
+    subscribeToPath<P extends Path<T>>(path: P, fn: PathSubscriber<GetPathValue<T, P>>): () => void;
+    subscribeToPath(path: string, fn: PathSubscriber): () => void;
+    get<P extends Path<T>>(path: P): GetPathValue<T, P>;
+    get(path: string | string[]): any;
+    set: (path: Path<T> | string | string[], val: any, options?: {
+        touch?: boolean;
+        validate?: boolean;
+    }) => void;
+    validate: (scopePaths?: Path<T>[] | string[] | string[][]) => Promise<boolean>;
+    connect: (path: Path<T> | string, el: HTMLElement, options?: ConnectOptions) => () => void;
+    submit: (onValid: (payload: Partial<T>) => void | Promise<void>) => Promise<boolean>;
+    handleSubmit: (onValid: (payload: Partial<T>) => void | Promise<void>, onInvalid?: (errors: Record<string, string>) => void) => (e?: Event) => void;
+    getState: () => FormState<T>;
+    getPayload: () => Partial<T>;
+    getAriaProps: (path: Path<T> | string, options?: AriaPropsOptions) => AriaProps;
+    batch: (fn: () => void) => void;
+    arrayAppend: (path: Path<T> | string | string[], item: any) => void;
+    arrayInsert: (path: Path<T> | string | string[], index: number, item: any) => void;
+    arrayRemove: (path: Path<T> | string | string[], index: number) => void;
+    arrayMove: (path: Path<T> | string | string[], fromIndex: number, toIndex: number) => void;
+    arraySwap: (path: Path<T> | string | string[], indexA: number, indexB: number) => void;
+    reset: (newValues?: T) => void;
+    getConnectedCount: () => number;
+    destroy: () => void;
+    setErrors: (errors: Record<Path<T> | (string & {}), string>) => void;
+    clearErrors: () => void;
+    /**
+     * Returns the effective ValidationMode for a field. Useful for debugging
+     * validation timing; framework adapters should rely on this only in custom
+     * event handlers, not in render logic.
+     */
+    getFieldMode: (path: string) => ValidationMode;
+    _subscribeToActions: (fn: (action: FormAction, state: FormState<T>) => void) => () => void;
+}
+
+interface AngularFormReturn<T extends object> {
+    state: Signal<FormState<T>>;
+    get: FormInstance<T>['get'];
+    set: FormInstance<T>['set'];
+    connect: FormInstance<T>['connect'];
+    submit: FormInstance<T>['submit'];
+    handleSubmit: FormInstance<T>['handleSubmit'];
+    reset: FormInstance<T>['reset'];
+    batch: FormInstance<T>['batch'];
+    validate: FormInstance<T>['validate'];
+    subscribeToPath: FormInstance<T>['subscribeToPath'];
+    getPayload: FormInstance<T>['getPayload'];
+    getAriaProps: FormInstance<T>['getAriaProps'];
+    getFieldMode: FormInstance<T>['getFieldMode'];
+    getConnectedCount: FormInstance<T>['getConnectedCount'];
+    destroy: FormInstance<T>['destroy'];
+    arrayAppend: FormInstance<T>['arrayAppend'];
+    arrayInsert: FormInstance<T>['arrayInsert'];
+    arrayRemove: FormInstance<T>['arrayRemove'];
+    arrayMove: FormInstance<T>['arrayMove'];
+    arraySwap: FormInstance<T>['arraySwap'];
+    setErrors: FormInstance<T>['setErrors'];
+    clearErrors: FormInstance<T>['clearErrors'];
+}
+declare function useAngularForm<T extends object>(form: FormInstance<T>): AngularFormReturn<T>;
+declare function useAngularFormPath<T extends object>(form: FormInstance<T>, path: string): {
+    value: Signal<unknown>;
+    fieldState: Signal<{
         error?: string;
         touched?: boolean;
         dirty?: boolean;
     } | null>;
 };
 
-export { useAngularForm, useAngularFormPath };
+export { type AngularFormReturn, useAngularForm, useAngularFormPath };

package/dist/adapters/angular.js

@@ -1,10 +1,11 @@
 // ../adapters/angular/dist/index.js
-import { signal, DestroyRef, inject } from "@angular/core";
+import { DestroyRef, inject, NgZone, signal } from "@angular/core";
 function useAngularForm(form) {
   const formSignal = signal(form.getState());
-  const unsubscribe = form.subscribe((s) => {
-    formSignal.set(s);
-  });
+  const zone = inject(NgZone, { optional: true });
+  const unsubscribe = form.subscribe(
+    (s) => zone ? zone.run(() => formSignal.set(s)) : formSignal.set(s)
+  );
   inject(DestroyRef).onDestroy(unsubscribe);
   return {
     state: formSignal.asReadonly(),
@@ -15,19 +16,36 @@ function useAngularForm(form) {
     handleSubmit: form.handleSubmit,
     reset: form.reset,
     batch: form.batch,
+    validate: form.validate,
+    subscribeToPath: form.subscribeToPath,
+    getPayload: form.getPayload,
+    getAriaProps: form.getAriaProps,
+    getFieldMode: form.getFieldMode,
+    getConnectedCount: form.getConnectedCount,
+    destroy: form.destroy,
     arrayAppend: form.arrayAppend,
     arrayInsert: form.arrayInsert,
     arrayRemove: form.arrayRemove,
     arrayMove: form.arrayMove,
-    arraySwap: form.arraySwap
+    arraySwap: form.arraySwap,
+    setErrors: form.setErrors,
+    clearErrors: form.clearErrors
   };
 }
 function useAngularFormPath(form, path) {
   const value = signal(form.get(path));
   const fieldState = signal(null);
+  const zone = inject(NgZone, { optional: true });
   const unsubscribe = form.subscribeToPath(path, (v, fs) => {
-    value.set(v);
-    fieldState.set(fs);
+    if (zone) {
+      zone.run(() => {
+        value.set(v);
+        fieldState.set(fs);
+      });
+    } else {
+      value.set(v);
+      fieldState.set(fs);
+    }
   });
   inject(DestroyRef).onDestroy(unsubscribe);
   return { value: value.asReadonly(), fieldState: fieldState.asReadonly() };

package/dist/adapters/react.cjs

@@ -42,13 +42,17 @@ function useForm(form) {
     subscribeToPath: form.subscribeToPath,
     validate: form.validate,
     getPayload: form.getPayload,
+    getAriaProps: form.getAriaProps,
+    getFieldMode: form.getFieldMode,
     getConnectedCount: form.getConnectedCount,
     destroy: form.destroy,
     arrayAppend: form.arrayAppend,
     arrayInsert: form.arrayInsert,
     arrayRemove: form.arrayRemove,
     arrayMove: form.arrayMove,
-    arraySwap: form.arraySwap
+    arraySwap: form.arraySwap,
+    setErrors: form.setErrors,
+    clearErrors: form.clearErrors
   };
 }
 function useFormPath(form, path) {

package/dist/adapters/react.d.cts

@@ -4,7 +4,7 @@
  */
 type Primitive = string | number | boolean | null | undefined | Date | File;
 type Prev = [never, 0, 1, 2, 3, 4, 5, ...any[]];
-type PathImpl<T, K extends keyof T, Depth extends number = 5> = [Depth] extends [never] ? never : K extends string ? T[K] extends Primitive ? K : T[K] extends Array<infer U> ? K | `${K}.${number}` | (U extends object ? `${K}.${number}.${PathImpl<U, keyof U, Prev[Depth]>}` : never) : T[K] extends object ? K | `${K}.${PathImpl<T[K], keyof T[K], Prev[Depth]>}` : K : never;
+type PathImpl<T, K extends keyof T, Depth extends number = 5> = [Depth] extends [never] ? never : K extends string ? T[K] extends Primitive ? K : T[K] extends Array<infer U> ? K | `${K}.${number}` | (U extends object ? `${K}.${number}.${PathImpl<U, keyof U, Prev[Depth]>}` : never) : NonNullable<T[K]> extends object ? K | `${K}.${PathImpl<NonNullable<T[K]>, keyof NonNullable<T[K]>, Prev[Depth]>}` : K : never;
 type Path<T> = PathImpl<T, keyof T> & string;
 type _GetPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? _GetPathValue<NonNullable<T[K]>, Rest> : T extends readonly any[] ? _GetPathValue<NonNullable<T[number]>, Rest> : unknown : P extends keyof T ? T[P] : T extends readonly any[] ? T[number] : unknown;
 type GetPathValue<T, P extends string> = _GetPathValue<T, P>;
@@ -17,19 +17,90 @@ interface FormState<T> {
     isValidating: boolean;
 }
 type FormSubscriber<T> = (state: FormState<T>) => void;
-type PathSubscriber = (value: any, fieldState: {
+type PathSubscriber<V = any> = (value: V, fieldState: {
     error?: string;
     touched?: boolean;
     dirty?: boolean;
 }) => void;
+type ValidationMode = 'onChange' | 'onBlur' | 'onTouched' | 'onSubmitOnly';
+type FormAction = {
+    type: 'SET';
+    path: string;
+    value: unknown;
+    options?: {
+        touch?: boolean;
+        validate?: boolean;
+    };
+} | {
+    type: 'VALIDATE';
+    paths?: string[];
+} | {
+    type: 'SUBMIT';
+} | {
+    type: 'RESET';
+    newValues?: unknown;
+} | {
+    type: 'SET_ERRORS';
+    errors: Record<string, string>;
+} | {
+    type: 'CONNECT';
+    path: string;
+} | {
+    type: 'DISCONNECT';
+    path: string;
+} | {
+    type: 'BLUR';
+    path: string;
+} | {
+    type: 'BATCH_START';
+} | {
+    type: 'BATCH_END';
+} | {
+    type: 'ARRAY_APPEND';
+    path: string;
+    item: unknown;
+} | {
+    type: 'ARRAY_INSERT';
+    path: string;
+    index: number;
+    item: unknown;
+} | {
+    type: 'ARRAY_REMOVE';
+    path: string;
+    index: number;
+} | {
+    type: 'ARRAY_MOVE';
+    path: string;
+    from: number;
+    to: number;
+} | {
+    type: 'ARRAY_SWAP';
+    path: string;
+    i: number;
+    j: number;
+} | {
+    type: 'CLEAR_ERRORS';
+};
+interface AriaPropsOptions {
+    required?: boolean;
+    errorId?: string;
+}
+interface AriaProps {
+    'aria-invalid': 'true' | 'false';
+    'aria-describedby': string | undefined;
+    'aria-required': true | undefined;
+}
 interface ConnectOptions {
     persist?: boolean;
     format?: (val: string) => string;
+    validateOn?: ValidationMode;
 }
 interface FormInstance<T extends object> {
     subscribe: (fn: FormSubscriber<T>) => () => void;
-    subscribeToPath: (path: Path<T> | string, fn: PathSubscriber) => () => void;
-    get: (path: Path<T> | string | string[]) => any;
+    subscribeToPath<P extends Path<T>>(path: P, fn: PathSubscriber<GetPathValue<T, P>>): () => void;
+    subscribeToPath(path: string, fn: PathSubscriber): () => void;
+    get<P extends Path<T>>(path: P): GetPathValue<T, P>;
+    get(path: string | string[]): any;
     set: (path: Path<T> | string | string[], val: any, options?: {
         touch?: boolean;
         validate?: boolean;
@@ -40,6 +111,7 @@ interface FormInstance<T extends object> {
     handleSubmit: (onValid: (payload: Partial<T>) => void | Promise<void>, onInvalid?: (errors: Record<string, string>) => void) => (e?: Event) => void;
     getState: () => FormState<T>;
     getPayload: () => Partial<T>;
+    getAriaProps: (path: Path<T> | string, options?: AriaPropsOptions) => AriaProps;
     batch: (fn: () => void) => void;
     arrayAppend: (path: Path<T> | string | string[], item: any) => void;
     arrayInsert: (path: Path<T> | string | string[], index: number, item: any) => void;
@@ -49,9 +121,18 @@ interface FormInstance<T extends object> {
     reset: (newValues?: T) => void;
     getConnectedCount: () => number;
     destroy: () => void;
+    setErrors: (errors: Record<Path<T> | (string & {}), string>) => void;
+    clearErrors: () => void;
+    /**
+     * Returns the effective ValidationMode for a field. Useful for debugging
+     * validation timing; framework adapters should rely on this only in custom
+     * event handlers, not in render logic.
+     */
+    getFieldMode: (path: string) => ValidationMode;
+    _subscribeToActions: (fn: (action: FormAction, state: FormState<T>) => void) => () => void;
 }
 
-declare function useForm<T extends object>(form: FormInstance<T>): FormState<T> & Omit<FormInstance<T>, 'subscribe' | 'getState'>;
+declare function useForm<T extends object>(form: FormInstance<T>): FormState<T> & Omit<FormInstance<T>, 'subscribe' | 'getState' | '_subscribeToActions'>;
 declare function useFormPath<T extends object, P extends Path<T>>(form: FormInstance<T>, path: P): GetPathValue<T, P>;
 declare function useFormConnect(form: any): (path: string, options?: any) => (el: HTMLElement | null) => void;