@lehnihon/bit-form 2.2.7 → 2.2.8

package/dist/{bus-DgilLszS.d.ts → types-CG5nYeRk.d.ts}

@@ -1,10 +1,22 @@
-import { B as BitMask, b as BitMaskName } from './types-CUXh7PqD.js';
+import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.js';
 
-type BitBusListener<T extends object = any> = (storeId: string, newState: BitState<T>) => void;
+interface BitBusStorePort<T extends object = object> {
+    getState: () => Readonly<BitState<T>>;
+    getHistoryMetadata: () => {
+        canUndo: boolean;
+        canRedo: boolean;
+        historySize: number;
+        historyIndex: number;
+    };
+    undo: () => void;
+    redo: () => void;
+    reset: () => void;
+}
+type BitBusListener<T extends object = object> = (storeId: string, newState: BitState<T>) => void;
 interface BitFormGlobal {
-    stores: Record<string, unknown>;
+    stores: Record<string, BitBusStorePort<object>>;
     listeners: Set<BitBusListener>;
-    dispatch: (storeId: string, state: BitState<any>) => void;
+    dispatch: (storeId: string, state: BitState<object>) => void;
     subscribe: (fn: BitBusListener) => () => void;
 }
 /** Alias for {@link BitFormGlobal}. Prefer this name in user-facing APIs. */
@@ -36,8 +48,18 @@ type DeepPartial<T> = T extends object ? {
 } : T;
 type BitErrors<T extends object> = Partial<Record<BitPath<T>, string | undefined>>;
 type BitTouched<T extends object> = Partial<Record<BitPath<T>, boolean | undefined>>;
-type BitComputedFn<T> = (values: T) => any;
-type BitTransformFn<T> = (value: any, allValues: T) => any;
+type BitBivariantFn<TArgs extends unknown[], TResult> = {
+    bivarianceHack(...args: TArgs): TResult;
+}["bivarianceHack"];
+type BitComputedFn<T> = (values: T) => unknown;
+type BitNormalizeFn<T> = BitBivariantFn<[
+    value: unknown,
+    allValues: T
+], unknown>;
+type BitTransformFn<T> = BitBivariantFn<[
+    value: unknown,
+    allValues: T
+], unknown>;
 interface BitPersistMetadata {
     isSaving: boolean;
     isRestoring: boolean;
@@ -60,7 +82,7 @@ interface BitState<T extends object> {
     isSubmitting: boolean;
     isDirty: boolean;
 }
-interface BitFieldState<T extends object = any, TValue = unknown> {
+interface BitFieldState<T extends object = Record<string, unknown>, TValue = unknown> {
     value: TValue;
     error: string | undefined;
     touched: boolean;
@@ -73,7 +95,7 @@ type ValidatorFn<T extends object> = (values: T, options?: {
     scopeFields?: string[];
 }) => Promise<BitErrors<T>> | BitErrors<T>;
 /** Conditional logic: visibility and dynamic required. */
-interface BitFieldConditional<T extends object = any> {
+interface BitFieldConditional<T extends object = Record<string, unknown>> {
     dependsOn?: string[];
     showIf?: (values: T) => boolean;
     requiredIf?: (values: T) => boolean;
@@ -81,18 +103,27 @@ interface BitFieldConditional<T extends object = any> {
     requiredMessage?: string;
 }
 /** Field-level validation: async validation only. */
-interface BitFieldValidation<T extends object = any> {
+interface BitFieldValidation<T extends object = Record<string, unknown>> {
     /**
      * Breaking change: async validation now defaults to `blur` instead of eager `change`.
      * `validate()`/submit still execute async validators for the targeted fields.
      */
     asyncValidateOn?: "change" | "blur";
-    asyncValidate?: (value: any, values: T) => Promise<string | null | undefined>;
+    asyncValidate?: BitBivariantFn<[
+        value: unknown,
+        values: T
+    ], Promise<string | null | undefined>>;
     asyncValidateDelay?: number;
 }
-interface BitFieldDefinitionBase<T extends object = any> {
+interface BitFieldDefinitionBase<T extends object = Record<string, unknown>> {
     conditional?: BitFieldConditional<T>;
     validation?: BitFieldValidation<T>;
+    normalize?: BitNormalizeFn<T>;
+    /**
+     * Optional explicit dependencies for normalize re-evaluation.
+     * Defaults to the field own path when omitted.
+     */
+    normalizeDependsOn?: string[];
     transform?: BitTransformFn<T>;
     /** Mask name (built-in or custom registry key) or BitMask instance. */
     mask?: BitMask | BitMaskName;
@@ -100,7 +131,7 @@ interface BitFieldDefinitionBase<T extends object = any> {
     scope?: string;
 }
 /** Full field definition: conditional, validation, transform, computed, mask, scope. */
-type BitFieldDefinition<T extends object = any> = (BitFieldDefinitionBase<T> & {
+type BitFieldDefinition<T extends object = Record<string, unknown>> = (BitFieldDefinitionBase<T> & {
     computed?: undefined;
     computedDependsOn?: never;
 }) | (BitFieldDefinitionBase<T> & {
@@ -115,7 +146,7 @@ interface DevToolsOptions {
 }
 type BitPluginHookSource = "beforeValidate" | "afterValidate" | "beforeSubmit" | "afterSubmit" | "onFieldChange" | "setup" | "teardown" | "submit";
 type BitFieldChangeOrigin = "setField" | "rebase" | "replaceValues" | "hydrate" | "array";
-type BitArrayOperation = "push" | "prepend" | "insert" | "remove" | "move" | "swap";
+type BitArrayOperation = "push" | "prepend" | "insert" | "remove" | "move" | "swap" | "replace" | "clear";
 interface BitFieldChangeMeta {
     origin: BitFieldChangeOrigin;
     operation?: BitArrayOperation;
@@ -123,7 +154,7 @@ interface BitFieldChangeMeta {
     from?: number;
     to?: number;
 }
-interface BitFieldChangeEvent<T extends object = any> {
+interface BitFieldChangeEvent<T extends object = Record<string, unknown>> {
     path: string;
     previousValue: unknown;
     nextValue: unknown;
@@ -131,13 +162,13 @@ interface BitFieldChangeEvent<T extends object = any> {
     state: Readonly<BitState<T>>;
     meta: BitFieldChangeMeta;
 }
-interface BitBeforeValidateEvent<T extends object = any> {
+interface BitBeforeValidateEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     state: Readonly<BitState<T>>;
     scope?: string;
     scopeFields?: string[];
 }
-interface BitAfterValidateEvent<T extends object = any> {
+interface BitAfterValidateEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     state: Readonly<BitState<T>>;
     scope?: string;
@@ -146,12 +177,12 @@ interface BitAfterValidateEvent<T extends object = any> {
     result: boolean;
     aborted?: boolean;
 }
-interface BitBeforeSubmitEvent<T extends object = any> {
+interface BitBeforeSubmitEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     dirtyValues: Readonly<Partial<T>>;
     state: Readonly<BitState<T>>;
 }
-interface BitAfterSubmitEvent<T extends object = any> {
+interface BitAfterSubmitEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     dirtyValues: Readonly<Partial<T>>;
     state: Readonly<BitState<T>>;
@@ -159,7 +190,7 @@ interface BitAfterSubmitEvent<T extends object = any> {
     error?: unknown;
     invalid?: boolean;
 }
-interface BitPluginErrorEvent<T extends object = any> {
+interface BitPluginErrorEvent<T extends object = Record<string, unknown>> {
     source: BitPluginHookSource;
     pluginName?: string;
     error: unknown;
@@ -167,12 +198,12 @@ interface BitPluginErrorEvent<T extends object = any> {
     values: Readonly<T>;
     state: Readonly<BitState<T>>;
 }
-interface BitPluginContext<T extends object = any> {
+interface BitPluginContext<T extends object = Record<string, unknown>> {
     storeId: string;
     getState: () => Readonly<BitState<T>>;
     getConfig: () => Readonly<BitConfig<T>>;
 }
-interface BitPluginHooks<T extends object = any> {
+interface BitPluginHooks<T extends object = Record<string, unknown>> {
     beforeValidate?: (event: BitBeforeValidateEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
     afterValidate?: (event: BitAfterValidateEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
     beforeSubmit?: (event: BitBeforeSubmitEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
@@ -180,7 +211,7 @@ interface BitPluginHooks<T extends object = any> {
     onFieldChange?: (event: BitFieldChangeEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
     onError?: (event: BitPluginErrorEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
 }
-interface BitPlugin<T extends object = any> {
+interface BitPlugin<T extends object = Record<string, unknown>> {
     name: string;
     setup?: (context: BitPluginContext<T>) => void | (() => void);
     hooks?: BitPluginHooks<T>;
@@ -192,7 +223,7 @@ interface BitPersistStorageAdapter {
     removeItem(key: string): BitMaybePromise<void>;
 }
 type BitPersistMode = "values" | "dirtyValues";
-interface BitPersistConfig<T extends object = any> {
+interface BitPersistConfig<T extends object = Record<string, unknown>> {
     enabled?: boolean;
     key?: string;
     storage?: BitPersistStorageAdapter;
@@ -203,7 +234,7 @@ interface BitPersistConfig<T extends object = any> {
     deserialize?: (raw: string) => Partial<T>;
     onError?: (error: unknown) => void;
 }
-interface BitPersistResolvedConfig<T extends object = any> {
+interface BitPersistResolvedConfig<T extends object = Record<string, unknown>> {
     enabled: boolean;
     key: string;
     storage?: BitPersistStorageAdapter;
@@ -232,7 +263,7 @@ interface BitHistoryConfig {
  * BitConfig - store configuration.
  * @see CHANGELOG for migration from features to fields in 2.0.
  */
-interface BitConfig<T extends object = any> {
+interface BitConfig<T extends object = Record<string, unknown>> {
     /** Core */
     name?: string;
     storeId?: string;
@@ -271,14 +302,30 @@ interface BitConfig<T extends object = any> {
      * where a global singleton is unsafe (e.g. Next.js Edge Runtime).
      */
     bus?: BitFormGlobal;
+    /**
+     * Handler opcional para erros operacionais não tratados internamente.
+     * Se não informado, o runtime usa fallback para `console.error`.
+     */
+    onUnhandledError?: (error: unknown, source: "submit" | "validation" | "persist") => void;
 }
-/** Return type of BitStore.getStepStatus, used by useBitScope/injectBitScope. */
+type BitSubmitResult = {
+    status: "submitted";
+} | {
+    status: "invalid";
+} | {
+    status: "failed";
+    error: unknown;
+} | {
+    status: "blocked";
+    reason: "isSubmitting" | "validating";
+};
+/** Return type of BitStore.getScopeStatus, used by useBitScope/injectBitScope. */
 interface ScopeStatus {
     hasErrors: boolean;
     isDirty: boolean;
     errors: Record<string, string>;
 }
-/** Return type of validateStep, used by useBitScope/injectBitScope. */
+/** Return type of scope validation helpers, used by useBitScope/injectBitScope. */
 interface ValidateScopeResult {
     valid: boolean;
     errors: Record<string, string>;
@@ -293,23 +340,7 @@ type BitPath<T, Prefix extends string = ""> = T extends Primitive ? never : T ex
     [K in keyof T & (string | number)]: T[K] extends Primitive ? Prefix extends "" ? `${K & (string | number)}` : `${Prefix}.${K & (string | number)}` : Prefix extends "" ? `${K & (string | number)}` | `${K & (string | number)}.${BitPath<T[K]>}` : `${Prefix}.${K & (string | number)}` | `${Prefix}.${K & (string | number)}.${BitPath<T[K]>}`;
 }[keyof T & (string | number)];
 type BitPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends `${number}` ? T extends readonly (infer U)[] ? BitPathValue<U, Rest> : never : K extends keyof T ? BitPathValue<T[K], Rest> : never : P extends `${number}` ? T extends readonly (infer U)[] ? U : never : P extends keyof T ? T[P] : never;
-type BitArrayPath<T> = BitPath<T> extends infer P ? P extends string ? BitPathValue<T, P> extends readonly any[] ? P : never : never : never;
+type BitArrayPath<T> = BitPath<T> extends infer P ? P extends string ? BitPathValue<T, P> extends readonly unknown[] ? P : never : never : never;
 type BitArrayItem<A> = A extends readonly (infer U)[] ? U : A extends (infer U)[] ? U : never;
 
-declare global {
-    var __BIT_FORM__: BitFormGlobal | undefined;
-}
-declare const bitBus: BitFormGlobal;
-/**
- * Creates an isolated bus instance — not connected to the browser global.
- * Use this in SSR / Edge Runtime environments (e.g. Next.js Edge) where a
- * shared `globalThis` singleton is unsafe across request contexts.
- *
- * @example
- * // _app.tsx (SSR-safe)
- * const bus = createBitBus();
- * const store = createBitStore({ bus, initialValues: { ... } });
- */
-declare function createBitBus(): BitFormGlobal;
-
-export { type BitFieldConditional as A, type BitArrayPath as B, type BitFieldValidation as C, type DeepPartial as D, type BitHistoryConfig as E, type BitPersistConfig as F, type BitPersistMode as G, type BitPersistStorageAdapter as H, type BitPluginContext as I, type BitPluginErrorEvent as J, type BitPluginHooks as K, type BitTransformFn as L, type BitValidationConfig as M, bitBus as N, createBitBus as O, type ScopeStatus as S, type ValidateScopeResult as V, type BitArrayItem as a, type BitPathValue as b, type BitErrors as c, type BitBus as d, type BitPath as e, type BitState as f, type BitFieldState as g, type BitFieldDefinition as h, type BitPersistMetadata as i, type BitConfig as j, type ValidatorFn as k, type DevToolsOptions as l, type BitPersistResolvedConfig as m, type BitIdFactory as n, type BitPlugin as o, type BitScheduler as p, type BitFormGlobal as q, type BitTouched as r, type BitAfterSubmitEvent as s, type BitAfterValidateEvent as t, type BitBeforeSubmitEvent as u, type BitBeforeValidateEvent as v, type BitBusListener as w, type BitComputedFn as x, type BitFieldChangeEvent as y, type BitFieldChangeMeta as z };
+export type { BitPlugin as A, BitAfterSubmitEvent as B, BitPluginContext as C, BitPluginErrorEvent as D, BitPluginHooks as E, BitScheduler as F, BitState as G, BitSubmitResult as H, BitTouched as I, BitTransformFn as J, BitValidationConfig as K, DeepPartial as L, DevToolsOptions as M, ValidatorFn as N, BitPersistResolvedConfig as O, BitIdFactory as P, ScopeStatus as S, ValidateScopeResult as V, BitAfterValidateEvent as a, BitArrayItem as b, BitArrayPath as c, BitBeforeSubmitEvent as d, BitBeforeValidateEvent as e, BitBus as f, BitBusListener as g, BitBusStorePort as h, BitComputedFn as i, BitConfig as j, BitErrors as k, BitFieldChangeEvent as l, BitFieldChangeMeta as m, BitFieldConditional as n, BitFieldDefinition as o, BitFieldState as p, BitFieldValidation as q, BitFormGlobal as r, BitHistoryConfig as s, BitNormalizeFn as t, BitPath as u, BitPathValue as v, BitPersistConfig as w, BitPersistMetadata as x, BitPersistMode as y, BitPersistStorageAdapter as z };

package/dist/{bus-rcUiufS7.d.cts → types-D6LhF5GC.d.cts}

@@ -1,10 +1,22 @@
-import { B as BitMask, b as BitMaskName } from './types-CUXh7PqD.cjs';
+import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.cjs';
 
-type BitBusListener<T extends object = any> = (storeId: string, newState: BitState<T>) => void;
+interface BitBusStorePort<T extends object = object> {
+    getState: () => Readonly<BitState<T>>;
+    getHistoryMetadata: () => {
+        canUndo: boolean;
+        canRedo: boolean;
+        historySize: number;
+        historyIndex: number;
+    };
+    undo: () => void;
+    redo: () => void;
+    reset: () => void;
+}
+type BitBusListener<T extends object = object> = (storeId: string, newState: BitState<T>) => void;
 interface BitFormGlobal {
-    stores: Record<string, unknown>;
+    stores: Record<string, BitBusStorePort<object>>;
     listeners: Set<BitBusListener>;
-    dispatch: (storeId: string, state: BitState<any>) => void;
+    dispatch: (storeId: string, state: BitState<object>) => void;
     subscribe: (fn: BitBusListener) => () => void;
 }
 /** Alias for {@link BitFormGlobal}. Prefer this name in user-facing APIs. */
@@ -36,8 +48,18 @@ type DeepPartial<T> = T extends object ? {
 } : T;
 type BitErrors<T extends object> = Partial<Record<BitPath<T>, string | undefined>>;
 type BitTouched<T extends object> = Partial<Record<BitPath<T>, boolean | undefined>>;
-type BitComputedFn<T> = (values: T) => any;
-type BitTransformFn<T> = (value: any, allValues: T) => any;
+type BitBivariantFn<TArgs extends unknown[], TResult> = {
+    bivarianceHack(...args: TArgs): TResult;
+}["bivarianceHack"];
+type BitComputedFn<T> = (values: T) => unknown;
+type BitNormalizeFn<T> = BitBivariantFn<[
+    value: unknown,
+    allValues: T
+], unknown>;
+type BitTransformFn<T> = BitBivariantFn<[
+    value: unknown,
+    allValues: T
+], unknown>;
 interface BitPersistMetadata {
     isSaving: boolean;
     isRestoring: boolean;
@@ -60,7 +82,7 @@ interface BitState<T extends object> {
     isSubmitting: boolean;
     isDirty: boolean;
 }
-interface BitFieldState<T extends object = any, TValue = unknown> {
+interface BitFieldState<T extends object = Record<string, unknown>, TValue = unknown> {
     value: TValue;
     error: string | undefined;
     touched: boolean;
@@ -73,7 +95,7 @@ type ValidatorFn<T extends object> = (values: T, options?: {
     scopeFields?: string[];
 }) => Promise<BitErrors<T>> | BitErrors<T>;
 /** Conditional logic: visibility and dynamic required. */
-interface BitFieldConditional<T extends object = any> {
+interface BitFieldConditional<T extends object = Record<string, unknown>> {
     dependsOn?: string[];
     showIf?: (values: T) => boolean;
     requiredIf?: (values: T) => boolean;
@@ -81,18 +103,27 @@ interface BitFieldConditional<T extends object = any> {
     requiredMessage?: string;
 }
 /** Field-level validation: async validation only. */
-interface BitFieldValidation<T extends object = any> {
+interface BitFieldValidation<T extends object = Record<string, unknown>> {
     /**
      * Breaking change: async validation now defaults to `blur` instead of eager `change`.
      * `validate()`/submit still execute async validators for the targeted fields.
      */
     asyncValidateOn?: "change" | "blur";
-    asyncValidate?: (value: any, values: T) => Promise<string | null | undefined>;
+    asyncValidate?: BitBivariantFn<[
+        value: unknown,
+        values: T
+    ], Promise<string | null | undefined>>;
     asyncValidateDelay?: number;
 }
-interface BitFieldDefinitionBase<T extends object = any> {
+interface BitFieldDefinitionBase<T extends object = Record<string, unknown>> {
     conditional?: BitFieldConditional<T>;
     validation?: BitFieldValidation<T>;
+    normalize?: BitNormalizeFn<T>;
+    /**
+     * Optional explicit dependencies for normalize re-evaluation.
+     * Defaults to the field own path when omitted.
+     */
+    normalizeDependsOn?: string[];
     transform?: BitTransformFn<T>;
     /** Mask name (built-in or custom registry key) or BitMask instance. */
     mask?: BitMask | BitMaskName;
@@ -100,7 +131,7 @@ interface BitFieldDefinitionBase<T extends object = any> {
     scope?: string;
 }
 /** Full field definition: conditional, validation, transform, computed, mask, scope. */
-type BitFieldDefinition<T extends object = any> = (BitFieldDefinitionBase<T> & {
+type BitFieldDefinition<T extends object = Record<string, unknown>> = (BitFieldDefinitionBase<T> & {
     computed?: undefined;
     computedDependsOn?: never;
 }) | (BitFieldDefinitionBase<T> & {
@@ -115,7 +146,7 @@ interface DevToolsOptions {
 }
 type BitPluginHookSource = "beforeValidate" | "afterValidate" | "beforeSubmit" | "afterSubmit" | "onFieldChange" | "setup" | "teardown" | "submit";
 type BitFieldChangeOrigin = "setField" | "rebase" | "replaceValues" | "hydrate" | "array";
-type BitArrayOperation = "push" | "prepend" | "insert" | "remove" | "move" | "swap";
+type BitArrayOperation = "push" | "prepend" | "insert" | "remove" | "move" | "swap" | "replace" | "clear";
 interface BitFieldChangeMeta {
     origin: BitFieldChangeOrigin;
     operation?: BitArrayOperation;
@@ -123,7 +154,7 @@ interface BitFieldChangeMeta {
     from?: number;
     to?: number;
 }
-interface BitFieldChangeEvent<T extends object = any> {
+interface BitFieldChangeEvent<T extends object = Record<string, unknown>> {
     path: string;
     previousValue: unknown;
     nextValue: unknown;
@@ -131,13 +162,13 @@ interface BitFieldChangeEvent<T extends object = any> {
     state: Readonly<BitState<T>>;
     meta: BitFieldChangeMeta;
 }
-interface BitBeforeValidateEvent<T extends object = any> {
+interface BitBeforeValidateEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     state: Readonly<BitState<T>>;
     scope?: string;
     scopeFields?: string[];
 }
-interface BitAfterValidateEvent<T extends object = any> {
+interface BitAfterValidateEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     state: Readonly<BitState<T>>;
     scope?: string;
@@ -146,12 +177,12 @@ interface BitAfterValidateEvent<T extends object = any> {
     result: boolean;
     aborted?: boolean;
 }
-interface BitBeforeSubmitEvent<T extends object = any> {
+interface BitBeforeSubmitEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     dirtyValues: Readonly<Partial<T>>;
     state: Readonly<BitState<T>>;
 }
-interface BitAfterSubmitEvent<T extends object = any> {
+interface BitAfterSubmitEvent<T extends object = Record<string, unknown>> {
     values: Readonly<T>;
     dirtyValues: Readonly<Partial<T>>;
     state: Readonly<BitState<T>>;
@@ -159,7 +190,7 @@ interface BitAfterSubmitEvent<T extends object = any> {
     error?: unknown;
     invalid?: boolean;
 }
-interface BitPluginErrorEvent<T extends object = any> {
+interface BitPluginErrorEvent<T extends object = Record<string, unknown>> {
     source: BitPluginHookSource;
     pluginName?: string;
     error: unknown;
@@ -167,12 +198,12 @@ interface BitPluginErrorEvent<T extends object = any> {
     values: Readonly<T>;
     state: Readonly<BitState<T>>;
 }
-interface BitPluginContext<T extends object = any> {
+interface BitPluginContext<T extends object = Record<string, unknown>> {
     storeId: string;
     getState: () => Readonly<BitState<T>>;
     getConfig: () => Readonly<BitConfig<T>>;
 }
-interface BitPluginHooks<T extends object = any> {
+interface BitPluginHooks<T extends object = Record<string, unknown>> {
     beforeValidate?: (event: BitBeforeValidateEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
     afterValidate?: (event: BitAfterValidateEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
     beforeSubmit?: (event: BitBeforeSubmitEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
@@ -180,7 +211,7 @@ interface BitPluginHooks<T extends object = any> {
     onFieldChange?: (event: BitFieldChangeEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
     onError?: (event: BitPluginErrorEvent<T>, context: BitPluginContext<T>) => BitMaybePromise<void>;
 }
-interface BitPlugin<T extends object = any> {
+interface BitPlugin<T extends object = Record<string, unknown>> {
     name: string;
     setup?: (context: BitPluginContext<T>) => void | (() => void);
     hooks?: BitPluginHooks<T>;
@@ -192,7 +223,7 @@ interface BitPersistStorageAdapter {
     removeItem(key: string): BitMaybePromise<void>;
 }
 type BitPersistMode = "values" | "dirtyValues";
-interface BitPersistConfig<T extends object = any> {
+interface BitPersistConfig<T extends object = Record<string, unknown>> {
     enabled?: boolean;
     key?: string;
     storage?: BitPersistStorageAdapter;
@@ -203,7 +234,7 @@ interface BitPersistConfig<T extends object = any> {
     deserialize?: (raw: string) => Partial<T>;
     onError?: (error: unknown) => void;
 }
-interface BitPersistResolvedConfig<T extends object = any> {
+interface BitPersistResolvedConfig<T extends object = Record<string, unknown>> {
     enabled: boolean;
     key: string;
     storage?: BitPersistStorageAdapter;
@@ -232,7 +263,7 @@ interface BitHistoryConfig {
  * BitConfig - store configuration.
  * @see CHANGELOG for migration from features to fields in 2.0.
  */
-interface BitConfig<T extends object = any> {
+interface BitConfig<T extends object = Record<string, unknown>> {
     /** Core */
     name?: string;
     storeId?: string;
@@ -271,14 +302,30 @@ interface BitConfig<T extends object = any> {
      * where a global singleton is unsafe (e.g. Next.js Edge Runtime).
      */
     bus?: BitFormGlobal;
+    /**
+     * Handler opcional para erros operacionais não tratados internamente.
+     * Se não informado, o runtime usa fallback para `console.error`.
+     */
+    onUnhandledError?: (error: unknown, source: "submit" | "validation" | "persist") => void;
 }
-/** Return type of BitStore.getStepStatus, used by useBitScope/injectBitScope. */
+type BitSubmitResult = {
+    status: "submitted";
+} | {
+    status: "invalid";
+} | {
+    status: "failed";
+    error: unknown;
+} | {
+    status: "blocked";
+    reason: "isSubmitting" | "validating";
+};
+/** Return type of BitStore.getScopeStatus, used by useBitScope/injectBitScope. */
 interface ScopeStatus {
     hasErrors: boolean;
     isDirty: boolean;
     errors: Record<string, string>;
 }
-/** Return type of validateStep, used by useBitScope/injectBitScope. */
+/** Return type of scope validation helpers, used by useBitScope/injectBitScope. */
 interface ValidateScopeResult {
     valid: boolean;
     errors: Record<string, string>;
@@ -293,23 +340,7 @@ type BitPath<T, Prefix extends string = ""> = T extends Primitive ? never : T ex
     [K in keyof T & (string | number)]: T[K] extends Primitive ? Prefix extends "" ? `${K & (string | number)}` : `${Prefix}.${K & (string | number)}` : Prefix extends "" ? `${K & (string | number)}` | `${K & (string | number)}.${BitPath<T[K]>}` : `${Prefix}.${K & (string | number)}` | `${Prefix}.${K & (string | number)}.${BitPath<T[K]>}`;
 }[keyof T & (string | number)];
 type BitPathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends `${number}` ? T extends readonly (infer U)[] ? BitPathValue<U, Rest> : never : K extends keyof T ? BitPathValue<T[K], Rest> : never : P extends `${number}` ? T extends readonly (infer U)[] ? U : never : P extends keyof T ? T[P] : never;
-type BitArrayPath<T> = BitPath<T> extends infer P ? P extends string ? BitPathValue<T, P> extends readonly any[] ? P : never : never : never;
+type BitArrayPath<T> = BitPath<T> extends infer P ? P extends string ? BitPathValue<T, P> extends readonly unknown[] ? P : never : never : never;
 type BitArrayItem<A> = A extends readonly (infer U)[] ? U : A extends (infer U)[] ? U : never;
 
-declare global {
-    var __BIT_FORM__: BitFormGlobal | undefined;
-}
-declare const bitBus: BitFormGlobal;
-/**
- * Creates an isolated bus instance — not connected to the browser global.
- * Use this in SSR / Edge Runtime environments (e.g. Next.js Edge) where a
- * shared `globalThis` singleton is unsafe across request contexts.
- *
- * @example
- * // _app.tsx (SSR-safe)
- * const bus = createBitBus();
- * const store = createBitStore({ bus, initialValues: { ... } });
- */
-declare function createBitBus(): BitFormGlobal;
-
-export { type BitFieldConditional as A, type BitArrayPath as B, type BitFieldValidation as C, type DeepPartial as D, type BitHistoryConfig as E, type BitPersistConfig as F, type BitPersistMode as G, type BitPersistStorageAdapter as H, type BitPluginContext as I, type BitPluginErrorEvent as J, type BitPluginHooks as K, type BitTransformFn as L, type BitValidationConfig as M, bitBus as N, createBitBus as O, type ScopeStatus as S, type ValidateScopeResult as V, type BitArrayItem as a, type BitPathValue as b, type BitErrors as c, type BitBus as d, type BitPath as e, type BitState as f, type BitFieldState as g, type BitFieldDefinition as h, type BitPersistMetadata as i, type BitConfig as j, type ValidatorFn as k, type DevToolsOptions as l, type BitPersistResolvedConfig as m, type BitIdFactory as n, type BitPlugin as o, type BitScheduler as p, type BitFormGlobal as q, type BitTouched as r, type BitAfterSubmitEvent as s, type BitAfterValidateEvent as t, type BitBeforeSubmitEvent as u, type BitBeforeValidateEvent as v, type BitBusListener as w, type BitComputedFn as x, type BitFieldChangeEvent as y, type BitFieldChangeMeta as z };
+export type { BitPlugin as A, BitAfterSubmitEvent as B, BitPluginContext as C, BitPluginErrorEvent as D, BitPluginHooks as E, BitScheduler as F, BitState as G, BitSubmitResult as H, BitTouched as I, BitTransformFn as J, BitValidationConfig as K, DeepPartial as L, DevToolsOptions as M, ValidatorFn as N, BitPersistResolvedConfig as O, BitIdFactory as P, ScopeStatus as S, ValidateScopeResult as V, BitAfterValidateEvent as a, BitArrayItem as b, BitArrayPath as c, BitBeforeSubmitEvent as d, BitBeforeValidateEvent as e, BitBus as f, BitBusListener as g, BitBusStorePort as h, BitComputedFn as i, BitConfig as j, BitErrors as k, BitFieldChangeEvent as l, BitFieldChangeMeta as m, BitFieldConditional as n, BitFieldDefinition as o, BitFieldState as p, BitFieldValidation as q, BitFormGlobal as r, BitHistoryConfig as s, BitNormalizeFn as t, BitPath as u, BitPathValue as v, BitPersistConfig as w, BitPersistMetadata as x, BitPersistMode as y, BitPersistStorageAdapter as z };

package/dist/{types-CUXh7PqD.d.cts → types-D8DgIUhJ.d.cts}

@@ -24,4 +24,4 @@ interface DateMaskConfig extends PatternMaskOptions {
     format?: "DD/MM/YYYY" | "YYYY-MM-DD";
 }
 
-export type { BitMask as B, CurrencyMaskConfig as C, DateMaskConfig as D, PatternMaskOptions as P, BitBuiltInMaskName as a, BitMaskName as b };
+export type { BitMask as B, CurrencyMaskConfig as C, DateMaskConfig as D, PatternMaskOptions as P, BitMaskName as a, BitBuiltInMaskName as b };

package/dist/{types-CUXh7PqD.d.ts → types-D8DgIUhJ.d.ts}

@@ -24,4 +24,4 @@ interface DateMaskConfig extends PatternMaskOptions {
     format?: "DD/MM/YYYY" | "YYYY-MM-DD";
 }
 
-export type { BitMask as B, CurrencyMaskConfig as C, DateMaskConfig as D, PatternMaskOptions as P, BitBuiltInMaskName as a, BitMaskName as b };
+export type { BitMask as B, CurrencyMaskConfig as C, DateMaskConfig as D, PatternMaskOptions as P, BitMaskName as a, BitBuiltInMaskName as b };

package/dist/{upload-EXnJLq8k.d.cts → upload-C2mpfhp1.d.cts}

@@ -14,4 +14,4 @@ type BitUploadFn = (file: File) => Promise<BitUploadResult>;
 /** Optional delete function contract. */
 type BitDeleteUploadFn = (key: string) => Promise<void>;
 
-export type { BitUploadFn as B, BitDeleteUploadFn as a, BitUploadResult as b };
+export type { BitDeleteUploadFn as B, BitUploadFn as a, BitUploadResult as b };

package/dist/{upload-EXnJLq8k.d.ts → upload-C2mpfhp1.d.ts}

@@ -14,4 +14,4 @@ type BitUploadFn = (file: File) => Promise<BitUploadResult>;
 /** Optional delete function contract. */
 type BitDeleteUploadFn = (key: string) => Promise<void>;
 
-export type { BitUploadFn as B, BitDeleteUploadFn as a, BitUploadResult as b };
+export type { BitDeleteUploadFn as B, BitUploadFn as a, BitUploadResult as b };

package/dist/{use-bit-persist-CIKFwtdM.d.cts → use-bit-persist-BTwy8kvA.d.ts}

@@ -1,15 +1,17 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { a as BitStoreHooksApi, b as BitFormBindingApi, c as BitHistoryMetadata, d as BitValidationOptions } from './store-api-types-B6_bPoVI.cjs';
-import { e as BitPath, b as BitPathValue, i as BitPersistMetadata, S as ScopeStatus, V as ValidateScopeResult, c as BitErrors, r as BitTouched, D as DeepPartial, B as BitArrayPath, a as BitArrayItem } from './bus-rcUiufS7.cjs';
-import { B as BitArrayBindingField } from './array-controller-C1A5VKYd.cjs';
-import { B as BitFieldInputEvent } from './field-binding-X5TkvfUt.cjs';
+import { b as BitFrameworkStoreApi, e as BitStoreApi } from './store-api-types-DPi30jQF.js';
+import './bus-B2VEKrPI.js';
+import { u as BitPath, v as BitPathValue, x as BitPersistMetadata, S as ScopeStatus, V as ValidateScopeResult, k as BitErrors, I as BitTouched, L as DeepPartial, c as BitArrayPath, b as BitArrayItem } from './types-CG5nYeRk.js';
+import { a as BitArrayBindingField } from './array-controller-Cx-DMH7Y.js';
+import { a as BitHistoryMetadata, b as BitValidationOptions } from './meta-types-Bzmm21TP.js';
+import { B as BitFieldInputEvent } from './field-binding-MX6jVQbT.js';
 
 declare const BitFormProvider: ({ store, children, }: {
-    store: BitStoreHooksApi<any>;
+    store: BitFrameworkStoreApi<any> | BitStoreApi<any>;
     children: React.ReactNode;
 }) => react_jsx_runtime.JSX.Element;
-declare const useBitStore: <T extends object>() => BitFormBindingApi<T>;
+declare const useBitStore: <T extends object>() => BitFrameworkStoreApi<T>;
 
 /**
  * Metadata describing the current state of a form field.

package/dist/{use-bit-persist-Bc06fmqZ.d.ts → use-bit-persist-C2LHNTVv.d.cts}

@@ -1,15 +1,17 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { a as BitStoreHooksApi, b as BitFormBindingApi, c as BitHistoryMetadata, d as BitValidationOptions } from './store-api-types-9ipdute1.js';
-import { e as BitPath, b as BitPathValue, i as BitPersistMetadata, S as ScopeStatus, V as ValidateScopeResult, c as BitErrors, r as BitTouched, D as DeepPartial, B as BitArrayPath, a as BitArrayItem } from './bus-DgilLszS.js';
-import { B as BitArrayBindingField } from './array-controller-DtkmcnUr.js';
-import { B as BitFieldInputEvent } from './field-binding-Bi1g-D8X.js';
+import { b as BitFrameworkStoreApi, e as BitStoreApi } from './store-api-types-D-ZHxzRy.cjs';
+import './bus-ZLQeq4Vr.cjs';
+import { u as BitPath, v as BitPathValue, x as BitPersistMetadata, S as ScopeStatus, V as ValidateScopeResult, k as BitErrors, I as BitTouched, L as DeepPartial, c as BitArrayPath, b as BitArrayItem } from './types-D6LhF5GC.cjs';
+import { a as BitArrayBindingField } from './array-controller-B5bfXV1W.cjs';
+import { a as BitHistoryMetadata, b as BitValidationOptions } from './meta-types-Bzmm21TP.cjs';
+import { B as BitFieldInputEvent } from './field-binding-B_OX3bjp.cjs';
 
 declare const BitFormProvider: ({ store, children, }: {
-    store: BitStoreHooksApi<any>;
+    store: BitFrameworkStoreApi<any> | BitStoreApi<any>;
     children: React.ReactNode;
 }) => react_jsx_runtime.JSX.Element;
-declare const useBitStore: <T extends object>() => BitFormBindingApi<T>;
+declare const useBitStore: <T extends object>() => BitFrameworkStoreApi<T>;
 
 /**
  * Metadata describing the current state of a form field.

package/dist/utils.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkT2JRSWQUcjs = require('./chunk-T2JRSWQU.cjs');exports.cleanPrefixedKeys = _chunkT2JRSWQUcjs.j; exports.extractServerErrors = _chunkT2JRSWQUcjs.m; exports.isValidationErrorShape = _chunkT2JRSWQUcjs.l;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/bit-form/bit-form/dist/utils.cjs"],"names":[],"mappings":"AAAA,iIAAsD,yJAAoF","file":"/home/runner/work/bit-form/bit-form/dist/utils.cjs"}

package/dist/utils.d.cts

@@ -0,0 +1,6 @@
+declare function cleanPrefixedKeys(obj: Record<string, any>, prefix: string): Record<string, any>;
+
+declare function isValidationErrorShape(x: unknown): x is Record<string, string | string[]>;
+declare function extractServerErrors(x: unknown): Record<string, string | string[]>;
+
+export { cleanPrefixedKeys, extractServerErrors, isValidationErrorShape };

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+declare function cleanPrefixedKeys(obj: Record<string, any>, prefix: string): Record<string, any>;
+
+declare function isValidationErrorShape(x: unknown): x is Record<string, string | string[]>;
+declare function extractServerErrors(x: unknown): Record<string, string | string[]>;
+
+export { cleanPrefixedKeys, extractServerErrors, isValidationErrorShape };