@conform-to/react 1.19.3 → 1.20.0

package/dist/future/hooks.d.ts

@@ -1,6 +1,6 @@
 import { type FormValue, type Serialize, type SubmissionResult } from '@conform-to/dom/future';
 import { useEffect } from 'react';
-import type { FormContext, Control, Selector, UseFormDataOptions, ValidateHandler, ErrorHandler, SubmitHandler, FormState, FormRef, BaseControlProps, StandardControlOptions, DefaultControlValue, CheckedControlOptions, CustomControlOptions } from './types';
+import type { FormContext, Control, Selector, UseFormDataOptions, ValidateHandler, ErrorHandler, SubmitHandler, FormState, FormRef, BaseControlProps, StandardControlOptions, DefaultControlValue, CheckedControlOptions, CustomControlOptions, IntentHandler, FormCustomState, CustomStateHandler } from './types';
 export declare const INITIAL_KEY = "INITIAL_KEY";
 export declare const GlobalFormsObserverContext: import("react").Context<{
     onFieldUpdate(callback: (event: {
@@ -17,7 +17,7 @@ export declare const GlobalFormsObserverContext: import("react").Context<{
     }) => void): () => void;
     dispose(): void;
 }>;
-export declare const FormContextContext: import("react").Context<FormContext<any>[]>;
+export declare const FormContextContext: import("react").Context<FormContext<any, {}>[]>;
 /**
  * Preserves form field values when its contents are unmounted.
  * Useful for multi-step forms and virtualized lists.
@@ -42,16 +42,21 @@ export declare function useFormContext(formId?: string): FormContext;
  * Core form hook that manages form state, validation, and submission.
  * Handles both sync and async validation, intent dispatching, and DOM updates.
  */
-export declare function useConform<FormShape extends Record<string, any>, ErrorShape, Value = undefined, SchemaValue = undefined, SchemaErrorShape = unknown>(formRef: FormRef, options: {
+export declare function useConform<FormShape extends Record<string, any>, ErrorShape, Value = undefined, SchemaValue = undefined, SchemaErrorShape = unknown, CustomStateHandlers extends Record<string, CustomStateHandler<any, any, ErrorShape>> = {}>(formRef: FormRef, options: {
     key?: string | undefined;
     defaultValue?: Record<string, FormValue> | null | undefined;
     serialize: Serialize;
     intentName: string;
+    intentHandlers: Record<string, IntentHandler<any, any>>;
+    customStateHandlers?: CustomStateHandlers | undefined;
     lastResult?: SubmissionResult<NoInfer<ErrorShape>> | null | undefined;
     onValidate?: ValidateHandler<ErrorShape, Value, SchemaValue, SchemaErrorShape> | undefined;
     onError?: ErrorHandler<ErrorShape> | undefined;
     onSubmit?: SubmitHandler<FormShape, NoInfer<ErrorShape>, NoInfer<Value>> | undefined;
-}): [FormState<ErrorShape>, (event: React.FormEvent<HTMLFormElement>) => void];
+}): [
+    FormState<ErrorShape, FormCustomState<CustomStateHandlers>>,
+    (event: React.FormEvent<HTMLFormElement>) => void
+];
 /**
  * A React hook that lets you sync the state of an input and dispatch native form events from it.
  * This is useful when emulating native input behavior — typically by rendering a hidden base control

package/dist/future/hooks.js

@@ -73,25 +73,38 @@ function useConform(formRef, options) {
   var [state$1, setState] = react.useState(() => {
     var state$1 = state.initializeState({
       defaultValue: options.defaultValue,
+      customStateHandlers: options.customStateHandlers,
       resetKey: INITIAL_KEY
     });
     if (lastResult) {
-      var intent$1 = lastResult.submission.intent ? intent.deserializeIntent(lastResult.submission.intent) : null;
-      var result = intent.applyIntent(lastResult, intent$1, {
-        handlers: intent.intentHandlers
+      var intent$1 = intent.parseIntent(lastResult.submission.intent, {
+        handlers: options.intentHandlers
       });
-      state$1 = state.updateState(state$1, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, result), {}, {
-        type: 'initialize',
-        intent: intent$1,
-        ctx: {
-          handlers: intent.intentHandlers,
-          cancelled: result !== lastResult,
-          reset: defaultValue => state.initializeState({
-            defaultValue: defaultValue !== null && defaultValue !== void 0 ? defaultValue : options.defaultValue,
-            resetKey: INITIAL_KEY
-          })
-        }
-      }));
+      if (intent$1) {
+        var result = intent.applyIntent(lastResult, intent$1, {
+          handlers: options.intentHandlers
+        });
+        state$1 = state.updateState(state$1, {
+          type: 'initialize',
+          intent: intent$1,
+          result,
+          ctx: {
+            intentHandlers: options.intentHandlers,
+            customStateHandlers: options.customStateHandlers,
+            status: state.getApplyStatus(lastResult.targetValue, result.targetValue),
+            reset() {
+              var _result$targetValue;
+              return state.initializeState({
+                defaultValue: (_result$targetValue = result.targetValue) !== null && _result$targetValue !== void 0 ? _result$targetValue : options.defaultValue,
+                resetKey: INITIAL_KEY,
+                customStateHandlers: options.customStateHandlers,
+                lastCustomState: state$1.customState,
+                result: result
+              });
+            }
+          }
+        });
+      }
     }
     return state$1;
   });
@@ -107,27 +120,38 @@ function useConform(formRef, options) {
     var normalizedResult = !result.error ? result : _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, result), {}, {
       error: future.normalizeFormError(result.error)
     });
-    var intent$1 = result.submission.intent ? intent.deserializeIntent(result.submission.intent) : null;
-    var finalResult = intent.applyIntent(normalizedResult, intent$1, {
-      handlers: intent.intentHandlers
+    var intent$1 = intent.parseIntent(result.submission.intent, {
+      handlers: options.intentHandlers
     });
+    if (!intent$1) {
+      throw new Error("Unknown intent found in the submission result; Received intent: ".concat(result.submission.intent));
+    }
     var formElement = dom.getFormElement(formRef);
-    if (formElement && (finalResult.reset || typeof finalResult.targetValue !== 'undefined')) {
+    var finalResult = type === 'client' ? intent.applyIntent(normalizedResult, intent$1, {
+      handlers: options.intentHandlers
+    }) : normalizedResult;
+    if (formElement && type === 'client' && (finalResult.reset || typeof finalResult.targetValue !== 'undefined')) {
       future.dispatchInternalUpdateEvent(formElement);
     }
-    setState(state$1 => state.updateState(state$1, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, finalResult), {}, {
+    setState(current => state.updateState(current, {
       type,
       intent: intent$1,
+      result: finalResult,
       ctx: {
-        handlers: intent.intentHandlers,
-        cancelled: finalResult !== normalizedResult,
-        reset(defaultValue) {
+        intentHandlers: options.intentHandlers,
+        customStateHandlers: options.customStateHandlers,
+        status: state.getApplyStatus(normalizedResult.targetValue, finalResult.targetValue),
+        reset() {
+          var _finalResult$targetVa;
           return state.initializeState({
-            defaultValue: defaultValue !== null && defaultValue !== void 0 ? defaultValue : options.defaultValue
+            defaultValue: (_finalResult$targetVa = finalResult.targetValue) !== null && _finalResult$targetVa !== void 0 ? _finalResult$targetVa : options.defaultValue,
+            customStateHandlers: options.customStateHandlers,
+            lastCustomState: current.customState,
+            result: finalResult
           });
         }
       }
-    })));
+    }));
 
     // TODO: move on error handler to a new effect
     if (formElement && finalResult.error) {
@@ -146,8 +170,10 @@ function useConform(formRef, options) {
     if (formElement) {
       future.dispatchInternalUpdateEvent(formElement);
     }
-    setState(state.initializeState({
-      defaultValue: options.defaultValue
+    setState(current => state.initializeState({
+      defaultValue: options.defaultValue,
+      customStateHandlers: options.customStateHandlers,
+      lastCustomState: current.customState
     }));
   } else if (lastResult && lastResult !== lastResultRef.current) {
     lastResultRef.current = lastResult;
@@ -197,6 +223,9 @@ function useConform(formRef, options) {
     var submission = future.parseSubmission(formData, {
       intentName: optionsRef.current.intentName
     });
+    var intent$1 = intent.parseIntent(submission.intent, {
+      handlers: optionsRef.current.intentHandlers
+    });
 
     // Patch missing fields in the submission object
     for (var element of formElement.elements) {
@@ -215,17 +244,20 @@ function useConform(formRef, options) {
     lastAsyncResultRef.current = null;
     if (lastAsyncResult &&
     // Only default submission will be re-submitted after async validation
-    !submission.intent &&
+    (intent$1 === null || intent$1 === void 0 ? void 0 : intent$1.type) === 'submit' &&
     // Ensure the submission payload is the same as the one being validated
     future.deepEqual(submission.payload, lastAsyncResult.result.submission.payload)) {
       result = lastAsyncResult.result;
       resolvedValue = lastAsyncResult.resolvedValue;
     } else {
       var _optionsRef$current$o2, _optionsRef$current2;
-      var value = intent.resolveIntent(submission);
+      var value = intent.resolveIntent(submission, {
+        handlers: optionsRef.current.intentHandlers,
+        intent: intent$1
+      });
       var submissionResult = future.report(submission, {
         keepFiles: true,
-        value
+        targetValue: value
       });
       var validateResult =
       // Skip validation on form reset
@@ -235,7 +267,7 @@ function useConform(formRef, options) {
           formErrors: null,
           fieldErrors: {}
         },
-        intent: submission.intent ? intent.deserializeIntent(submission.intent) : null,
+        intent: intent$1,
         formElement,
         submitter: submitEvent.submitter,
         formData,
@@ -262,10 +294,10 @@ function useConform(formRef, options) {
           // There is no need to flush the update in this case
           if (!abortController.signal.aborted) {
             submissionResult.error = error;
-            handleSubmission('server', submissionResult);
+            handleSubmission('client:async', submissionResult);
 
             // If the form is meant to be submitted and there is no error
-            if (submissionResult.error === null && !submission.intent) {
+            if (submissionResult.error === null && (intent$1 === null || intent$1 === void 0 ? void 0 : intent$1.type) === 'submit') {
               // Keep track of the validated payload and resume submission on the next task.
               // Calling requestSubmit() directly from the async callback, or from a
               // microtask, can still be ignored before the native submission lifecycle
@@ -293,7 +325,7 @@ function useConform(formRef, options) {
       // If client validation happens
       (typeof syncResult !== 'undefined' || typeof asyncResult !== 'undefined') && (
       // Either the form is not meant to be submitted (i.e. intent is present) or there is an error / pending validation
-      clientResult.submission.intent || clientResult.error !== null)) {
+      (intent$1 === null || intent$1 === void 0 ? void 0 : intent$1.type) !== 'submit' || clientResult.error !== null)) {
         event.preventDefault();
       }
       result = clientResult;
@@ -301,7 +333,7 @@ function useConform(formRef, options) {
 
     // We might not prevent form submission if server validation is required
     // But the `onSubmit` handler should be triggered only if there is no intent
-    if (!event.isDefaultPrevented() && result.submission.intent === null) {
+    if (!event.isDefaultPrevented() && (intent$1 === null || intent$1 === void 0 ? void 0 : intent$1.type) === 'submit') {
       var _optionsRef$current$o3, _optionsRef$current3;
       (_optionsRef$current$o3 = (_optionsRef$current3 = optionsRef.current).onSubmit) === null || _optionsRef$current$o3 === void 0 || _optionsRef$current$o3.call(_optionsRef$current3, event, {
         formData,

package/dist/future/hooks.mjs

@@ -3,8 +3,8 @@ import { objectSpread2 as _objectSpread2, objectWithoutProperties as _objectWith
 import { createGlobalFormsObserver, isGlobalInstance, deepEqual, isFieldElement, change, focus, blur, getFormData, defaultSerialize, isPlainObject, normalizeFormError, dispatchInternalUpdateEvent, parseSubmission, report, requestSubmit } from '@conform-to/dom/future';
 import { createContext, useRef, useContext, useMemo, useState, useEffect, useSyncExternalStore, useCallback, useLayoutEffect, forwardRef } from 'react';
 import { appendUniqueItem, resolveValidateResult } from './util.mjs';
-import { initializeState, updateState } from './state.mjs';
-import { deserializeIntent, applyIntent, intentHandlers, resolveIntent } from './intent.mjs';
+import { initializeState, updateState, getApplyStatus } from './state.mjs';
+import { parseIntent, applyIntent, resolveIntent } from './intent.mjs';
 import { cleanupPreservedInputs, preserveInputs, deriveDefaultPayload, resolveControlPayload, initializeField, getFormElement, resetFormValue, updateFormValue, getSubmitEvent } from './dom.mjs';
 import { flushSync } from 'react-dom';
 import { jsx } from 'react/jsx-runtime';
@@ -69,25 +69,38 @@ function useConform(formRef, options) {
   var [state, setState] = useState(() => {
     var state = initializeState({
       defaultValue: options.defaultValue,
+      customStateHandlers: options.customStateHandlers,
       resetKey: INITIAL_KEY
     });
     if (lastResult) {
-      var intent = lastResult.submission.intent ? deserializeIntent(lastResult.submission.intent) : null;
-      var result = applyIntent(lastResult, intent, {
-        handlers: intentHandlers
+      var intent = parseIntent(lastResult.submission.intent, {
+        handlers: options.intentHandlers
       });
-      state = updateState(state, _objectSpread2(_objectSpread2({}, result), {}, {
-        type: 'initialize',
-        intent,
-        ctx: {
-          handlers: intentHandlers,
-          cancelled: result !== lastResult,
-          reset: defaultValue => initializeState({
-            defaultValue: defaultValue !== null && defaultValue !== void 0 ? defaultValue : options.defaultValue,
-            resetKey: INITIAL_KEY
-          })
-        }
-      }));
+      if (intent) {
+        var result = applyIntent(lastResult, intent, {
+          handlers: options.intentHandlers
+        });
+        state = updateState(state, {
+          type: 'initialize',
+          intent,
+          result,
+          ctx: {
+            intentHandlers: options.intentHandlers,
+            customStateHandlers: options.customStateHandlers,
+            status: getApplyStatus(lastResult.targetValue, result.targetValue),
+            reset() {
+              var _result$targetValue;
+              return initializeState({
+                defaultValue: (_result$targetValue = result.targetValue) !== null && _result$targetValue !== void 0 ? _result$targetValue : options.defaultValue,
+                resetKey: INITIAL_KEY,
+                customStateHandlers: options.customStateHandlers,
+                lastCustomState: state.customState,
+                result: result
+              });
+            }
+          }
+        });
+      }
     }
     return state;
   });
@@ -103,27 +116,38 @@ function useConform(formRef, options) {
     var normalizedResult = !result.error ? result : _objectSpread2(_objectSpread2({}, result), {}, {
       error: normalizeFormError(result.error)
     });
-    var intent = result.submission.intent ? deserializeIntent(result.submission.intent) : null;
-    var finalResult = applyIntent(normalizedResult, intent, {
-      handlers: intentHandlers
+    var intent = parseIntent(result.submission.intent, {
+      handlers: options.intentHandlers
     });
+    if (!intent) {
+      throw new Error("Unknown intent found in the submission result; Received intent: ".concat(result.submission.intent));
+    }
     var formElement = getFormElement(formRef);
-    if (formElement && (finalResult.reset || typeof finalResult.targetValue !== 'undefined')) {
+    var finalResult = type === 'client' ? applyIntent(normalizedResult, intent, {
+      handlers: options.intentHandlers
+    }) : normalizedResult;
+    if (formElement && type === 'client' && (finalResult.reset || typeof finalResult.targetValue !== 'undefined')) {
       dispatchInternalUpdateEvent(formElement);
     }
-    setState(state => updateState(state, _objectSpread2(_objectSpread2({}, finalResult), {}, {
+    setState(current => updateState(current, {
       type,
       intent,
+      result: finalResult,
       ctx: {
-        handlers: intentHandlers,
-        cancelled: finalResult !== normalizedResult,
-        reset(defaultValue) {
+        intentHandlers: options.intentHandlers,
+        customStateHandlers: options.customStateHandlers,
+        status: getApplyStatus(normalizedResult.targetValue, finalResult.targetValue),
+        reset() {
+          var _finalResult$targetVa;
           return initializeState({
-            defaultValue: defaultValue !== null && defaultValue !== void 0 ? defaultValue : options.defaultValue
+            defaultValue: (_finalResult$targetVa = finalResult.targetValue) !== null && _finalResult$targetVa !== void 0 ? _finalResult$targetVa : options.defaultValue,
+            customStateHandlers: options.customStateHandlers,
+            lastCustomState: current.customState,
+            result: finalResult
           });
         }
       }
-    })));
+    }));
 
     // TODO: move on error handler to a new effect
     if (formElement && finalResult.error) {
@@ -131,7 +155,7 @@ function useConform(formRef, options) {
       (_optionsRef$current$o = (_optionsRef$current = optionsRef.current).onError) === null || _optionsRef$current$o === void 0 || _optionsRef$current$o.call(_optionsRef$current, {
         formElement,
         error: finalResult.error,
-        intent
+        intent: intent
       });
     }
     return finalResult;
@@ -142,8 +166,10 @@ function useConform(formRef, options) {
     if (formElement) {
       dispatchInternalUpdateEvent(formElement);
     }
-    setState(initializeState({
-      defaultValue: options.defaultValue
+    setState(current => initializeState({
+      defaultValue: options.defaultValue,
+      customStateHandlers: options.customStateHandlers,
+      lastCustomState: current.customState
     }));
   } else if (lastResult && lastResult !== lastResultRef.current) {
     lastResultRef.current = lastResult;
@@ -193,6 +219,9 @@ function useConform(formRef, options) {
     var submission = parseSubmission(formData, {
       intentName: optionsRef.current.intentName
     });
+    var intent = parseIntent(submission.intent, {
+      handlers: optionsRef.current.intentHandlers
+    });
 
     // Patch missing fields in the submission object
     for (var element of formElement.elements) {
@@ -211,17 +240,20 @@ function useConform(formRef, options) {
     lastAsyncResultRef.current = null;
     if (lastAsyncResult &&
     // Only default submission will be re-submitted after async validation
-    !submission.intent &&
+    (intent === null || intent === void 0 ? void 0 : intent.type) === 'submit' &&
     // Ensure the submission payload is the same as the one being validated
     deepEqual(submission.payload, lastAsyncResult.result.submission.payload)) {
       result = lastAsyncResult.result;
       resolvedValue = lastAsyncResult.resolvedValue;
     } else {
       var _optionsRef$current$o2, _optionsRef$current2;
-      var value = resolveIntent(submission);
+      var value = resolveIntent(submission, {
+        handlers: optionsRef.current.intentHandlers,
+        intent
+      });
       var submissionResult = report(submission, {
         keepFiles: true,
-        value
+        targetValue: value
       });
       var validateResult =
       // Skip validation on form reset
@@ -231,7 +263,7 @@ function useConform(formRef, options) {
           formErrors: null,
           fieldErrors: {}
         },
-        intent: submission.intent ? deserializeIntent(submission.intent) : null,
+        intent,
         formElement,
         submitter: submitEvent.submitter,
         formData,
@@ -258,10 +290,10 @@ function useConform(formRef, options) {
           // There is no need to flush the update in this case
           if (!abortController.signal.aborted) {
             submissionResult.error = error;
-            handleSubmission('server', submissionResult);
+            handleSubmission('client:async', submissionResult);
 
             // If the form is meant to be submitted and there is no error
-            if (submissionResult.error === null && !submission.intent) {
+            if (submissionResult.error === null && (intent === null || intent === void 0 ? void 0 : intent.type) === 'submit') {
               // Keep track of the validated payload and resume submission on the next task.
               // Calling requestSubmit() directly from the async callback, or from a
               // microtask, can still be ignored before the native submission lifecycle
@@ -289,7 +321,7 @@ function useConform(formRef, options) {
       // If client validation happens
       (typeof syncResult !== 'undefined' || typeof asyncResult !== 'undefined') && (
       // Either the form is not meant to be submitted (i.e. intent is present) or there is an error / pending validation
-      clientResult.submission.intent || clientResult.error !== null)) {
+      (intent === null || intent === void 0 ? void 0 : intent.type) !== 'submit' || clientResult.error !== null)) {
         event.preventDefault();
       }
       result = clientResult;
@@ -297,7 +329,7 @@ function useConform(formRef, options) {
 
     // We might not prevent form submission if server validation is required
     // But the `onSubmit` handler should be triggered only if there is no intent
-    if (!event.isDefaultPrevented() && result.submission.intent === null) {
+    if (!event.isDefaultPrevented() && (intent === null || intent === void 0 ? void 0 : intent.type) === 'submit') {
       var _optionsRef$current$o3, _optionsRef$current3;
       (_optionsRef$current$o3 = (_optionsRef$current3 = optionsRef.current).onSubmit) === null || _optionsRef$current$o3 === void 0 || _optionsRef$current$o3.call(_optionsRef$current3, event, {
         formData,

package/dist/future/index.d.ts

@@ -1,7 +1,9 @@
 export type { FieldName, FormError, FormValue, Submission, SubmissionResult, } from '@conform-to/dom/future';
 export { getFieldValue, parseSubmission, report, isDirty, } from '@conform-to/dom/future';
-export type { Control, ControlOptions, BaseControlProps, DefaultValue, BaseFieldMetadata, CustomSchemaTypes, FormsConfig, FormContext, FormMetadata, FormOptions, FormRef, FieldMetadata, Fieldset, IntentDispatcher, InferBaseErrorShape, InferCustomFormMetadata, InferCustomFieldMetadata, } from './types';
-export { configureForms, FormProvider, useForm, useFormMetadata, useField, useIntent, } from './forms';
+export type { Control, ControlOptions, BaseControlProps, DefaultValue, BaseFieldMetadata, CustomSchemaTypes, CustomStateHandler, FormsConfig, FormContext, FormMetadata, FormOptions, FormRef, FieldMetadata, Fieldset, FormIntent, IntentHandler, IntentDispatcher, InferBaseErrorShape, InferCustomFormMetadata, InferCustomFieldMetadata, InferCustomState, } from './types';
+export { configureForms, FormProvider, useForm, useFormMetadata, useField, useIntent, resolveSubmission, } from './forms';
+export { defineIntent } from './intent';
+export { defineCustomState } from './state';
 export { BaseControl, PreserveBoundary, useControl, useFormData, } from './hooks';
 export { shape } from './util';
 export { memoize } from './memoize';

package/dist/future/index.js

@@ -4,6 +4,8 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var future = require('@conform-to/dom/future');
 var forms = require('./forms.js');
+var intent = require('./intent.js');
+var state = require('./state.js');
 var hooks = require('./hooks.js');
 var util = require('./util.js');
 var memoize = require('./memoize.js');
@@ -28,10 +30,13 @@ Object.defineProperty(exports, 'report', {
 });
 exports.FormProvider = forms.FormProvider;
 exports.configureForms = forms.configureForms;
+exports.resolveSubmission = forms.resolveSubmission;
 exports.useField = forms.useField;
 exports.useForm = forms.useForm;
 exports.useFormMetadata = forms.useFormMetadata;
 exports.useIntent = forms.useIntent;
+exports.defineIntent = intent.defineIntent;
+exports.defineCustomState = state.defineCustomState;
 exports.BaseControl = hooks.BaseControl;
 exports.PreserveBoundary = hooks.PreserveBoundary;
 exports.useControl = hooks.useControl;

package/dist/future/index.mjs

@@ -1,5 +1,7 @@
 export { getFieldValue, isDirty, parseSubmission, report } from '@conform-to/dom/future';
-export { FormProvider, configureForms, useField, useForm, useFormMetadata, useIntent } from './forms.mjs';
+export { FormProvider, configureForms, resolveSubmission, useField, useForm, useFormMetadata, useIntent } from './forms.mjs';
+export { defineIntent } from './intent.mjs';
+export { defineCustomState } from './state.mjs';
 export { BaseControl, PreserveBoundary, useControl, useFormData } from './hooks.mjs';
 export { shape } from './util.mjs';
 export { memoize } from './memoize.mjs';

package/dist/future/intent.d.ts

@@ -1,26 +1,27 @@
 import type { FormValue, Submission, SubmissionResult } from '@conform-to/dom/future';
-import type { IntentHandler, IntentDispatcher, UnknownIntent } from './types';
+import type { FormIntent, IntentHandler, NormalizeIntentType, UnknownIntent, TransportIntent, ResetIntent, SubmitIntent, ValidateIntent, UpdateIntent, InsertIntent, RemoveIntent, ReorderIntent, DefaultIntentHandlers } from './types';
+export declare function defineIntent<Definition = () => void, Payload = never>(definition?: Partial<IntentHandler<NormalizeIntentType<Definition>, Payload>>): IntentHandler<NormalizeIntentType<Definition>, Payload>;
+export declare function mergeIntentHandlers<DefaultHandlers extends Record<string, IntentHandler<any, any>>, CustomHandlers extends Record<string, IntentHandler<any, any>> | undefined>(defaultHandlers: DefaultHandlers, customHandlers: CustomHandlers): DefaultHandlers & CustomHandlers;
 /**
- * Serializes intent to string format: "type" or "type(payload)".
+ * Serializes a transport intent to string format.
  */
-export declare function serializeIntent<Intent extends UnknownIntent = UnknownIntent>(intent: Intent): string;
+export declare function serializeIntent(intent: TransportIntent): string;
 /**
- * Parses serialized intent string back to intent object.
+ * Parses the serialized intent string into a transport intent.
  */
-export declare function deserializeIntent(value: string): UnknownIntent;
-/**
- * Applies intent transformation to submission payload.
- * Returns modified payload or null for reset intent.
- */
-export declare function resolveIntent(submission: Submission, options?: {
-    handlers?: Record<string, IntentHandler>;
+export declare function deserializeIntent(serializedIntent: string): TransportIntent | undefined;
+export declare function parseIntent<Handlers extends Record<string, IntentHandler<any, any>>>(intentValue: string | null, options: {
+    handlers: Handlers;
+}): FormIntent<Record<string, any>, Handlers> | {
+    type: 'submit';
+    payload: undefined;
+} | undefined;
+export declare function resolveIntent(submission: Submission, options: {
+    handlers: Record<string, IntentHandler<any, any>>;
+    intent: UnknownIntent | undefined;
 }): Record<string, FormValue> | undefined;
-/**
- * Resolves an intent after validation by calling the handler's onResolve.
- * Mutates the result with updated value/error and returns whether the intent was cancelled.
- */
-export declare function applyIntent<ErrorShape>(result: SubmissionResult<ErrorShape>, intent: UnknownIntent | null, options?: {
-    handlers?: Record<string, IntentHandler>;
+export declare function applyIntent<ErrorShape>(result: SubmissionResult<ErrorShape>, intent: UnknownIntent | undefined, options: {
+    handlers: Record<string, IntentHandler<any, any>>;
 }): SubmissionResult<ErrorShape>;
 export declare function insertItem<Item>(list: Array<Item>, item: Item, index: number): void;
 export declare function removeItem(list: Array<unknown>, index: number): void;
@@ -29,14 +30,19 @@ export declare function reorderItems(list: Array<unknown>, fromIndex: number, to
  * Updates list keys by removing child keys and optionally transforming remaining keys.
  */
 export declare function updateListKeys(keys: Record<string, string[]> | undefined, keyToBeRemoved: string, updateKey?: (key: string) => string | null): Record<string, string[]>;
+export declare const submit: IntentHandler<SubmitIntent, never>;
+export declare const reset: IntentHandler<ResetIntent, never>;
+export declare const validate: IntentHandler<ValidateIntent, never>;
+export declare const update: IntentHandler<UpdateIntent, never>;
+export declare const insert: IntentHandler<InsertIntent, never>;
+export declare const remove: IntentHandler<RemoveIntent, never>;
+export declare const reorder: IntentHandler<ReorderIntent, never>;
 /**
- * Built-in action handlers for form intents:
+ * Default Intent handlers
  * - reset: clears form data
  * - validate: marks fields as touched for validation display
  * - update: updates specific field values
  * - insert/remove/reorder: manages array field operations
  */
-export declare const intentHandlers: {
-    [Type in keyof IntentDispatcher]: IntentDispatcher[Type] extends (payload: any) => void ? IntentHandler<IntentDispatcher[Type]> : never;
-};
+export declare const defaultIntentHandlers: DefaultIntentHandlers;
 //# sourceMappingURL=intent.d.ts.map