@lehnihon/bit-form 2.2.6 → 2.2.7

package/dist/index.d.cts

@@ -1,175 +1,12 @@
-import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.cjs';
-import { o as BitComputedFn, B as BitConfig, a as BitFieldDefinition, p as BitTransformFn, e as BitState, f as BitPath, m as BitFieldState, g as BitPathValue, q as BitFieldChangeMeta, h as DeepPartial, i as BitErrors, j as BitPersistMetadata, k as BitArrayPath, l as BitArrayItem, r as BitBeforeValidateEvent, s as BitAfterValidateEvent, t as BitBeforeSubmitEvent, u as BitAfterSubmitEvent, v as BitFieldChangeEvent } from './bus-BeAeZwWu.cjs';
-export { w as BitFieldConditional, x as BitFieldValidation, y as BitHistoryConfig, z as BitPersistConfig, A as BitPersistMode, C as BitPersistStorageAdapter, d as BitPlugin, E as BitPluginContext, F as BitPluginErrorEvent, G as BitPluginHooks, H as BitTouched, I as BitValidationConfig, S as ScopeStatus, n as ValidateScopeResult, V as ValidatorFn, J as bitBus } from './bus-BeAeZwWu.cjs';
-import { B as BitFrameworkConfig, a as BitSelector, b as BitSelectorSubscriptionOptions, c as BitHistoryMetadata, d as BitValidationOptions, e as BitStoreApi, f as BitStoreHooksApi } from './public-types-Cd9ai20P.cjs';
-export { g as BitEqualityFn } from './public-types-Cd9ai20P.cjs';
+import { j as BitConfig } from './bus-rcUiufS7.cjs';
+export { s as BitAfterSubmitEvent, t as BitAfterValidateEvent, a as BitArrayItem, B as BitArrayPath, u as BitBeforeSubmitEvent, v as BitBeforeValidateEvent, d as BitBus, w as BitBusListener, x as BitComputedFn, c as BitErrors, y as BitFieldChangeEvent, z as BitFieldChangeMeta, A as BitFieldConditional, h as BitFieldDefinition, g as BitFieldState, C as BitFieldValidation, q as BitFormGlobal, E as BitHistoryConfig, e as BitPath, b as BitPathValue, F as BitPersistConfig, i as BitPersistMetadata, G as BitPersistMode, H as BitPersistStorageAdapter, o as BitPlugin, I as BitPluginContext, J as BitPluginErrorEvent, K as BitPluginHooks, p as BitScheduler, f as BitState, r as BitTouched, L as BitTransformFn, M as BitValidationConfig, D as DeepPartial, l as DevToolsOptions, S as ScopeStatus, V as ValidateScopeResult, k as ValidatorFn, N as bitBus, O as createBitBus } from './bus-rcUiufS7.cjs';
+import { a as BitStoreHooksApi } from './store-api-types-B6_bPoVI.cjs';
+export { B as BitArrayBindingApi, h as BitEqualityFn, g as BitFieldBindingApi, b as BitFormBindingApi, f as BitFormMeta, e as BitFormMetaBindingApi, i as BitFrameworkConfig, c as BitHistoryMetadata, j as BitSelector, k as BitSelectorSubscriptionOptions, l as BitStoreApi, m as BitStoreArrayFeatureApi, n as BitStoreFeatureApi, o as BitStoreHistoryFeatureApi, p as BitStoreObserveApi, q as BitStorePersistFeatureApi, r as BitStoreQueryApi, s as BitStoreRegistrationFeatureApi, t as BitStoreWriteApi, d as BitValidationOptions } from './store-api-types-B6_bPoVI.cjs';
 export { a as BitDeleteUploadFn, B as BitUploadFn, b as BitUploadResult } from './upload-EXnJLq8k.cjs';
+import './types-CUXh7PqD.cjs';
 
-interface BitComputedEntry<T extends object> {
-    path: string;
-    compute: BitComputedFn<T>;
-    dependsOn?: readonly string[];
-}
-
-interface BitValidationTriggerOptions {
-    forceDebounce?: boolean;
-}
-
-/**
- * BitStore
- *
- * The core orchestrator of form state management.
- *
- * This store coordinates multiple managers to provide comprehensive form handling:
- * - Core managers handle essential state and validation
- * - Feature managers provide optional enhancements (history, arrays, scopes)
- * - Query/mutation managers organize domain-specific operations
- */
-declare class BitStore<T extends object = any> {
-    private state;
-    private readonly subscriptions;
-    private readonly effects;
-    private readonly capabilities;
-    /** Baseline for dirty tracking. Decoupled from config so that rebaseValues
-     * can update it without mutating the user-provided config object. */
-    private _initialValues;
-    /** Incremented on every registerMask() call so React hooks can track mask
-     * configuration changes via useSyncExternalStore without putting masks in
-     * BitState and triggering a full re-render of all fields. */
-    private _masksVersion;
-    config: BitFrameworkConfig<T>;
-    readonly storeId: string;
-    private readonly dependencyManager;
-    private readonly computedManager;
-    private readonly dirtyManager;
-    private scopeFieldsIndex;
-    private computedEntriesCache;
-    private transformEntriesCache;
-    private batchDepth;
-    private batchedState;
-    private batchedChangedPaths;
-    private batchedValuesChanged;
-    private invalidateFieldIndexes;
-    private registerCachedFieldIndexes;
-    private unregisterCachedFieldIndexes;
-    private getCapability;
-    private get validation();
-    private get lifecycle();
-    private get history();
-    private get arrays();
-    private get scope();
-    private get query();
-    private get error();
-    constructor(config?: BitConfig<T>);
-    getConfig(): BitFrameworkConfig<T>;
-    getFieldConfig(path: string): BitFieldDefinition<T> | undefined;
-    getScopeFields(scopeName: string): string[];
-    getComputedEntries(): BitComputedEntry<T>[];
-    getTransformEntries(): [string, BitTransformFn<T>][];
-    resolveMask(path: string): BitMask | undefined;
-    getState(): BitState<T>;
-    getFieldState<P extends BitPath<T>>(path: P): BitFieldState<T, BitPathValue<T, P>>;
-    get isValid(): boolean;
-    get isSubmitting(): boolean;
-    get isDirty(): boolean;
-    registerField(path: string, config: BitFieldDefinition<T>): void;
-    unregisterField(path: string): void;
-    unregisterPrefix(prefix: string): void;
-    isHidden<P extends BitPath<T>>(path: P): boolean;
-    isRequired<P extends BitPath<T>>(path: P): boolean;
-    isFieldDirty(path: string): boolean;
-    isFieldValidating(path: string): boolean;
-    subscribe(listener: () => void): () => void;
-    subscribeSelector<TSlice>(selector: BitSelector<T, TSlice>, listener: (slice: TSlice) => void, options?: BitSelectorSubscriptionOptions<TSlice>): () => void;
-    subscribePath<P extends BitPath<T>>(path: P, listener: (value: BitPathValue<T, P>) => void, options?: BitSelectorSubscriptionOptions<BitPathValue<T, P>>): () => void;
-    watch<P extends BitPath<T>>(path: P, callback: (value: BitPathValue<T, P>) => void): () => void;
-    setField<P extends BitPath<T>>(path: P, value: BitPathValue<T, P>): void;
-    setFieldWithMeta(path: string, value: any, meta?: BitFieldChangeMeta): void;
-    blurField<P extends BitPath<T>>(path: P): void;
-    markFieldsTouched(paths: string[]): void;
-    replaceValues(newValues: T): void;
-    hydrate(values: DeepPartial<T>): void;
-    rebase(newValues: T): void;
-    setError(path: string, message: string | undefined): void;
-    setErrors(errors: BitErrors<T>): void;
-    setServerErrors(serverErrors: Record<string, string[] | string>): void;
-    reset(): void;
-    transaction<TResult>(callback: () => TResult): TResult;
-    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<void>;
-    registerMask(name: BitMaskName, mask: BitMask): void;
-    getDirtyValues(): Partial<T>;
-    getPersistMetadata(): BitPersistMetadata;
-    restorePersisted(): Promise<boolean>;
-    forceSave(): Promise<void>;
-    clearPersisted(): Promise<void>;
-    pushItem<P extends BitArrayPath<T>>(path: P, value: BitArrayItem<BitPathValue<T, P>>): void;
-    prependItem<P extends BitArrayPath<T>>(path: P, value: BitArrayItem<BitPathValue<T, P>>): void;
-    insertItem<P extends BitArrayPath<T>>(path: P, index: number, value: BitArrayItem<BitPathValue<T, P>>): void;
-    removeItem<P extends BitArrayPath<T>>(path: P, index: number): void;
-    swapItems<P extends BitArrayPath<T>>(path: P, indexA: number, indexB: number): void;
-    moveItem<P extends BitArrayPath<T>>(path: P, from: number, to: number): void;
-    get canUndo(): boolean;
-    get canRedo(): boolean;
-    undo(): void;
-    redo(): void;
-    getHistoryMetadata(): BitHistoryMetadata;
-    validate(options?: BitValidationOptions): Promise<boolean>;
-    emitBeforeValidate(event: BitBeforeValidateEvent<T>): Promise<void>;
-    emitAfterValidate(event: BitAfterValidateEvent<T>): Promise<void>;
-    emitBeforeSubmit(event: BitBeforeSubmitEvent<T>): Promise<void>;
-    emitAfterSubmit(event: BitAfterSubmitEvent<T>): Promise<void>;
-    emitFieldChange(event: BitFieldChangeEvent<T>): void;
-    emitOperationalError(event: {
-        source: "submit";
-        error: unknown;
-        payload?: unknown;
-    }): Promise<void>;
-    hasValidationsInProgress(scopeFields?: string[]): boolean;
-    triggerValidation(scopeFields?: string[], options?: BitValidationTriggerOptions): void;
-    getStepStatus(scopeName: string): {
-        hasErrors: boolean;
-        isDirty: boolean;
-        errors: Record<string, string>;
-    };
-    getStepErrors(scopeName: string): Record<string, string>;
-    updateDependencies(changedPath: string, newValues: T): string[];
-    isFieldHidden(path: string): boolean;
-    evaluateAllDependencies(values: T): void;
-    getHiddenFields(): ReadonlySet<string>;
-    getRequiredErrors(values: T): BitErrors<T>;
-    clearFieldValidation(path: string): void;
-    handleFieldAsyncValidation(path: string, value: any): void;
-    cancelAllValidations(): void;
-    validateNow(options?: BitValidationOptions): Promise<boolean>;
-    updateDirtyForPath(path: string, nextValues: T, baselineValues: T): boolean;
-    rebuildDirtyState(nextValues: T, baselineValues: T): boolean;
-    clearDirtyState(): void;
-    buildDirtyValues(values: T): Partial<T>;
-    batchStateUpdates<TResult>(callback: () => TResult): TResult;
-    resetHistory(initialValues: T): void;
-    /** Current baseline used for dirty-state comparisons. */
-    get initialValues(): T;
-    /** Returns the current baseline (usable as a port method). */
-    getInitialValues(): T;
-    /**
-     * Updates the baseline used for dirty comparisons.
-     * Called by rebaseValues so that config is never mutated directly by managers.
-     * Also syncs config.initialValues so getConfig() reflects the new baseline.
-     */
-    setInitialValues(values: T): void;
-    /** Returns a monotonically increasing counter that increments every time a
-     * mask is registered via registerMask(). Used by React components to track
-     * mask configuration changes reactively without storing masks in BitState. */
-    getMasksVersion(): number;
-    internalUpdateState(partialState: Partial<BitState<T>>, changedPaths?: string[]): void;
-    internalSaveSnapshot(): void;
-    private applyPersistedValues;
-    cleanup(): void;
-    private flushBatchedStateUpdates;
-}
-
-declare function resolveBitStoreForHooks<T extends object>(store: BitStoreApi<T> | BitStore<T>): BitStoreHooksApi<T>;
-declare function createBitStore<T extends object = any>(config?: BitConfig<T>): BitStoreApi<T>;
+declare function resolveBitStoreForHooks<T extends object>(store: unknown): BitStoreHooksApi<T>;
+declare function createBitStore<T extends object = any>(config?: BitConfig<T>): BitStoreHooksApi<T>;
 
 declare function deepClone<T>(obj: T): T;
 declare function deepMerge<T>(target: T, source: any): T;
@@ -192,4 +29,60 @@ declare function isValidationErrorShape(x: unknown): x is Record<string, string
  */
 declare function extractServerErrors(x: unknown): Record<string, string | string[]>;
 
-export { BitAfterSubmitEvent, BitAfterValidateEvent, BitArrayItem, BitArrayPath, BitBeforeSubmitEvent, BitBeforeValidateEvent, BitComputedFn, BitConfig, BitErrors, BitFieldChangeEvent, BitFieldChangeMeta, BitFieldDefinition, BitFieldState, BitFrameworkConfig, BitHistoryMetadata, BitPath, BitPathValue, BitPersistMetadata, BitSelector, BitSelectorSubscriptionOptions, BitState, BitStoreApi, BitStoreHooksApi, BitTransformFn, BitValidationOptions, DeepPartial, cleanPrefixedKeys, createBitStore, deepClone, deepEqual, deepMerge, extractServerErrors, getDeepValue, isValidationErrorShape, resolveBitStoreForHooks, setDeepValue, valueEqual };
+/**
+ * Field State Snapshot Utilities
+ *
+ * Shared utilities for creating and managing field state snapshots across frameworks
+ * (React, Vue, Angular). Reduces code duplication while maintaining type safety.
+ */
+/**
+ * Represents a stable snapshot of field state that can be compared for equality.
+ */
+interface BitFieldSnapshot<TValue = any> {
+    value: TValue;
+    error: string | undefined;
+    touched: boolean;
+    isHidden: boolean;
+    isRequired: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}
+/**
+ * Creates or reuses a field state snapshot with shallow equality checking.
+ *
+ * This function prevents unnecessary re-renders in frameworks like React by
+ * returning the same object reference when field state hasn't changed.
+ *
+ * @param nextState - The new field state from the store
+ * @param lastSnapshot - The previous snapshot (can be null on first call)
+ * @returns A stable snapshot object that can be used for equality comparison
+ *
+ * @example
+ * ```typescript
+ * const snapshot = createFieldStateSnapshot(store.getFieldState("email"), lastSnapshot);
+ * if (snapshot !== lastSnapshot) {
+ *   // Field state changed, update component
+ *   render(snapshot);
+ * }
+ * ```
+ */
+declare function createFieldStateSnapshot<TValue = any>(nextState: {
+    value: TValue;
+    error: string | undefined;
+    touched: boolean;
+    isHidden: boolean;
+    isRequired: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}, lastSnapshot: BitFieldSnapshot<TValue> | null): BitFieldSnapshot<TValue>;
+/**
+ * Deep comparison utility for field state snapshots.
+ * Useful for scenarios where shallow comparison isn't sufficient (e.g., object/array values).
+ *
+ * @param snapshotA - First snapshot
+ * @param snapshotB - Second snapshot
+ * @returns true if snapshots are deeply equal
+ */
+declare function areFieldSnapshotsEqual(snapshotA: BitFieldSnapshot | null | undefined, snapshotB: BitFieldSnapshot | null | undefined): boolean;
+
+export { BitConfig, type BitFieldSnapshot, BitStoreHooksApi, areFieldSnapshotsEqual, cleanPrefixedKeys, createBitStore, createFieldStateSnapshot, deepClone, deepEqual, deepMerge, extractServerErrors, getDeepValue, isValidationErrorShape, resolveBitStoreForHooks, setDeepValue, valueEqual };

package/dist/index.d.ts

@@ -1,175 +1,12 @@
-import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.js';
-import { o as BitComputedFn, B as BitConfig, a as BitFieldDefinition, p as BitTransformFn, e as BitState, f as BitPath, m as BitFieldState, g as BitPathValue, q as BitFieldChangeMeta, h as DeepPartial, i as BitErrors, j as BitPersistMetadata, k as BitArrayPath, l as BitArrayItem, r as BitBeforeValidateEvent, s as BitAfterValidateEvent, t as BitBeforeSubmitEvent, u as BitAfterSubmitEvent, v as BitFieldChangeEvent } from './bus-B4zZmB9C.js';
-export { w as BitFieldConditional, x as BitFieldValidation, y as BitHistoryConfig, z as BitPersistConfig, A as BitPersistMode, C as BitPersistStorageAdapter, d as BitPlugin, E as BitPluginContext, F as BitPluginErrorEvent, G as BitPluginHooks, H as BitTouched, I as BitValidationConfig, S as ScopeStatus, n as ValidateScopeResult, V as ValidatorFn, J as bitBus } from './bus-B4zZmB9C.js';
-import { B as BitFrameworkConfig, a as BitSelector, b as BitSelectorSubscriptionOptions, c as BitHistoryMetadata, d as BitValidationOptions, e as BitStoreApi, f as BitStoreHooksApi } from './public-types-DdZxD6Op.js';
-export { g as BitEqualityFn } from './public-types-DdZxD6Op.js';
+import { j as BitConfig } from './bus-DgilLszS.js';
+export { s as BitAfterSubmitEvent, t as BitAfterValidateEvent, a as BitArrayItem, B as BitArrayPath, u as BitBeforeSubmitEvent, v as BitBeforeValidateEvent, d as BitBus, w as BitBusListener, x as BitComputedFn, c as BitErrors, y as BitFieldChangeEvent, z as BitFieldChangeMeta, A as BitFieldConditional, h as BitFieldDefinition, g as BitFieldState, C as BitFieldValidation, q as BitFormGlobal, E as BitHistoryConfig, e as BitPath, b as BitPathValue, F as BitPersistConfig, i as BitPersistMetadata, G as BitPersistMode, H as BitPersistStorageAdapter, o as BitPlugin, I as BitPluginContext, J as BitPluginErrorEvent, K as BitPluginHooks, p as BitScheduler, f as BitState, r as BitTouched, L as BitTransformFn, M as BitValidationConfig, D as DeepPartial, l as DevToolsOptions, S as ScopeStatus, V as ValidateScopeResult, k as ValidatorFn, N as bitBus, O as createBitBus } from './bus-DgilLszS.js';
+import { a as BitStoreHooksApi } from './store-api-types-9ipdute1.js';
+export { B as BitArrayBindingApi, h as BitEqualityFn, g as BitFieldBindingApi, b as BitFormBindingApi, f as BitFormMeta, e as BitFormMetaBindingApi, i as BitFrameworkConfig, c as BitHistoryMetadata, j as BitSelector, k as BitSelectorSubscriptionOptions, l as BitStoreApi, m as BitStoreArrayFeatureApi, n as BitStoreFeatureApi, o as BitStoreHistoryFeatureApi, p as BitStoreObserveApi, q as BitStorePersistFeatureApi, r as BitStoreQueryApi, s as BitStoreRegistrationFeatureApi, t as BitStoreWriteApi, d as BitValidationOptions } from './store-api-types-9ipdute1.js';
 export { a as BitDeleteUploadFn, B as BitUploadFn, b as BitUploadResult } from './upload-EXnJLq8k.js';
+import './types-CUXh7PqD.js';
 
-interface BitComputedEntry<T extends object> {
-    path: string;
-    compute: BitComputedFn<T>;
-    dependsOn?: readonly string[];
-}
-
-interface BitValidationTriggerOptions {
-    forceDebounce?: boolean;
-}
-
-/**
- * BitStore
- *
- * The core orchestrator of form state management.
- *
- * This store coordinates multiple managers to provide comprehensive form handling:
- * - Core managers handle essential state and validation
- * - Feature managers provide optional enhancements (history, arrays, scopes)
- * - Query/mutation managers organize domain-specific operations
- */
-declare class BitStore<T extends object = any> {
-    private state;
-    private readonly subscriptions;
-    private readonly effects;
-    private readonly capabilities;
-    /** Baseline for dirty tracking. Decoupled from config so that rebaseValues
-     * can update it without mutating the user-provided config object. */
-    private _initialValues;
-    /** Incremented on every registerMask() call so React hooks can track mask
-     * configuration changes via useSyncExternalStore without putting masks in
-     * BitState and triggering a full re-render of all fields. */
-    private _masksVersion;
-    config: BitFrameworkConfig<T>;
-    readonly storeId: string;
-    private readonly dependencyManager;
-    private readonly computedManager;
-    private readonly dirtyManager;
-    private scopeFieldsIndex;
-    private computedEntriesCache;
-    private transformEntriesCache;
-    private batchDepth;
-    private batchedState;
-    private batchedChangedPaths;
-    private batchedValuesChanged;
-    private invalidateFieldIndexes;
-    private registerCachedFieldIndexes;
-    private unregisterCachedFieldIndexes;
-    private getCapability;
-    private get validation();
-    private get lifecycle();
-    private get history();
-    private get arrays();
-    private get scope();
-    private get query();
-    private get error();
-    constructor(config?: BitConfig<T>);
-    getConfig(): BitFrameworkConfig<T>;
-    getFieldConfig(path: string): BitFieldDefinition<T> | undefined;
-    getScopeFields(scopeName: string): string[];
-    getComputedEntries(): BitComputedEntry<T>[];
-    getTransformEntries(): [string, BitTransformFn<T>][];
-    resolveMask(path: string): BitMask | undefined;
-    getState(): BitState<T>;
-    getFieldState<P extends BitPath<T>>(path: P): BitFieldState<T, BitPathValue<T, P>>;
-    get isValid(): boolean;
-    get isSubmitting(): boolean;
-    get isDirty(): boolean;
-    registerField(path: string, config: BitFieldDefinition<T>): void;
-    unregisterField(path: string): void;
-    unregisterPrefix(prefix: string): void;
-    isHidden<P extends BitPath<T>>(path: P): boolean;
-    isRequired<P extends BitPath<T>>(path: P): boolean;
-    isFieldDirty(path: string): boolean;
-    isFieldValidating(path: string): boolean;
-    subscribe(listener: () => void): () => void;
-    subscribeSelector<TSlice>(selector: BitSelector<T, TSlice>, listener: (slice: TSlice) => void, options?: BitSelectorSubscriptionOptions<TSlice>): () => void;
-    subscribePath<P extends BitPath<T>>(path: P, listener: (value: BitPathValue<T, P>) => void, options?: BitSelectorSubscriptionOptions<BitPathValue<T, P>>): () => void;
-    watch<P extends BitPath<T>>(path: P, callback: (value: BitPathValue<T, P>) => void): () => void;
-    setField<P extends BitPath<T>>(path: P, value: BitPathValue<T, P>): void;
-    setFieldWithMeta(path: string, value: any, meta?: BitFieldChangeMeta): void;
-    blurField<P extends BitPath<T>>(path: P): void;
-    markFieldsTouched(paths: string[]): void;
-    replaceValues(newValues: T): void;
-    hydrate(values: DeepPartial<T>): void;
-    rebase(newValues: T): void;
-    setError(path: string, message: string | undefined): void;
-    setErrors(errors: BitErrors<T>): void;
-    setServerErrors(serverErrors: Record<string, string[] | string>): void;
-    reset(): void;
-    transaction<TResult>(callback: () => TResult): TResult;
-    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<void>;
-    registerMask(name: BitMaskName, mask: BitMask): void;
-    getDirtyValues(): Partial<T>;
-    getPersistMetadata(): BitPersistMetadata;
-    restorePersisted(): Promise<boolean>;
-    forceSave(): Promise<void>;
-    clearPersisted(): Promise<void>;
-    pushItem<P extends BitArrayPath<T>>(path: P, value: BitArrayItem<BitPathValue<T, P>>): void;
-    prependItem<P extends BitArrayPath<T>>(path: P, value: BitArrayItem<BitPathValue<T, P>>): void;
-    insertItem<P extends BitArrayPath<T>>(path: P, index: number, value: BitArrayItem<BitPathValue<T, P>>): void;
-    removeItem<P extends BitArrayPath<T>>(path: P, index: number): void;
-    swapItems<P extends BitArrayPath<T>>(path: P, indexA: number, indexB: number): void;
-    moveItem<P extends BitArrayPath<T>>(path: P, from: number, to: number): void;
-    get canUndo(): boolean;
-    get canRedo(): boolean;
-    undo(): void;
-    redo(): void;
-    getHistoryMetadata(): BitHistoryMetadata;
-    validate(options?: BitValidationOptions): Promise<boolean>;
-    emitBeforeValidate(event: BitBeforeValidateEvent<T>): Promise<void>;
-    emitAfterValidate(event: BitAfterValidateEvent<T>): Promise<void>;
-    emitBeforeSubmit(event: BitBeforeSubmitEvent<T>): Promise<void>;
-    emitAfterSubmit(event: BitAfterSubmitEvent<T>): Promise<void>;
-    emitFieldChange(event: BitFieldChangeEvent<T>): void;
-    emitOperationalError(event: {
-        source: "submit";
-        error: unknown;
-        payload?: unknown;
-    }): Promise<void>;
-    hasValidationsInProgress(scopeFields?: string[]): boolean;
-    triggerValidation(scopeFields?: string[], options?: BitValidationTriggerOptions): void;
-    getStepStatus(scopeName: string): {
-        hasErrors: boolean;
-        isDirty: boolean;
-        errors: Record<string, string>;
-    };
-    getStepErrors(scopeName: string): Record<string, string>;
-    updateDependencies(changedPath: string, newValues: T): string[];
-    isFieldHidden(path: string): boolean;
-    evaluateAllDependencies(values: T): void;
-    getHiddenFields(): ReadonlySet<string>;
-    getRequiredErrors(values: T): BitErrors<T>;
-    clearFieldValidation(path: string): void;
-    handleFieldAsyncValidation(path: string, value: any): void;
-    cancelAllValidations(): void;
-    validateNow(options?: BitValidationOptions): Promise<boolean>;
-    updateDirtyForPath(path: string, nextValues: T, baselineValues: T): boolean;
-    rebuildDirtyState(nextValues: T, baselineValues: T): boolean;
-    clearDirtyState(): void;
-    buildDirtyValues(values: T): Partial<T>;
-    batchStateUpdates<TResult>(callback: () => TResult): TResult;
-    resetHistory(initialValues: T): void;
-    /** Current baseline used for dirty-state comparisons. */
-    get initialValues(): T;
-    /** Returns the current baseline (usable as a port method). */
-    getInitialValues(): T;
-    /**
-     * Updates the baseline used for dirty comparisons.
-     * Called by rebaseValues so that config is never mutated directly by managers.
-     * Also syncs config.initialValues so getConfig() reflects the new baseline.
-     */
-    setInitialValues(values: T): void;
-    /** Returns a monotonically increasing counter that increments every time a
-     * mask is registered via registerMask(). Used by React components to track
-     * mask configuration changes reactively without storing masks in BitState. */
-    getMasksVersion(): number;
-    internalUpdateState(partialState: Partial<BitState<T>>, changedPaths?: string[]): void;
-    internalSaveSnapshot(): void;
-    private applyPersistedValues;
-    cleanup(): void;
-    private flushBatchedStateUpdates;
-}
-
-declare function resolveBitStoreForHooks<T extends object>(store: BitStoreApi<T> | BitStore<T>): BitStoreHooksApi<T>;
-declare function createBitStore<T extends object = any>(config?: BitConfig<T>): BitStoreApi<T>;
+declare function resolveBitStoreForHooks<T extends object>(store: unknown): BitStoreHooksApi<T>;
+declare function createBitStore<T extends object = any>(config?: BitConfig<T>): BitStoreHooksApi<T>;
 
 declare function deepClone<T>(obj: T): T;
 declare function deepMerge<T>(target: T, source: any): T;
@@ -192,4 +29,60 @@ declare function isValidationErrorShape(x: unknown): x is Record<string, string
  */
 declare function extractServerErrors(x: unknown): Record<string, string | string[]>;
 
-export { BitAfterSubmitEvent, BitAfterValidateEvent, BitArrayItem, BitArrayPath, BitBeforeSubmitEvent, BitBeforeValidateEvent, BitComputedFn, BitConfig, BitErrors, BitFieldChangeEvent, BitFieldChangeMeta, BitFieldDefinition, BitFieldState, BitFrameworkConfig, BitHistoryMetadata, BitPath, BitPathValue, BitPersistMetadata, BitSelector, BitSelectorSubscriptionOptions, BitState, BitStoreApi, BitStoreHooksApi, BitTransformFn, BitValidationOptions, DeepPartial, cleanPrefixedKeys, createBitStore, deepClone, deepEqual, deepMerge, extractServerErrors, getDeepValue, isValidationErrorShape, resolveBitStoreForHooks, setDeepValue, valueEqual };
+/**
+ * Field State Snapshot Utilities
+ *
+ * Shared utilities for creating and managing field state snapshots across frameworks
+ * (React, Vue, Angular). Reduces code duplication while maintaining type safety.
+ */
+/**
+ * Represents a stable snapshot of field state that can be compared for equality.
+ */
+interface BitFieldSnapshot<TValue = any> {
+    value: TValue;
+    error: string | undefined;
+    touched: boolean;
+    isHidden: boolean;
+    isRequired: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}
+/**
+ * Creates or reuses a field state snapshot with shallow equality checking.
+ *
+ * This function prevents unnecessary re-renders in frameworks like React by
+ * returning the same object reference when field state hasn't changed.
+ *
+ * @param nextState - The new field state from the store
+ * @param lastSnapshot - The previous snapshot (can be null on first call)
+ * @returns A stable snapshot object that can be used for equality comparison
+ *
+ * @example
+ * ```typescript
+ * const snapshot = createFieldStateSnapshot(store.getFieldState("email"), lastSnapshot);
+ * if (snapshot !== lastSnapshot) {
+ *   // Field state changed, update component
+ *   render(snapshot);
+ * }
+ * ```
+ */
+declare function createFieldStateSnapshot<TValue = any>(nextState: {
+    value: TValue;
+    error: string | undefined;
+    touched: boolean;
+    isHidden: boolean;
+    isRequired: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}, lastSnapshot: BitFieldSnapshot<TValue> | null): BitFieldSnapshot<TValue>;
+/**
+ * Deep comparison utility for field state snapshots.
+ * Useful for scenarios where shallow comparison isn't sufficient (e.g., object/array values).
+ *
+ * @param snapshotA - First snapshot
+ * @param snapshotB - Second snapshot
+ * @returns true if snapshots are deeply equal
+ */
+declare function areFieldSnapshotsEqual(snapshotA: BitFieldSnapshot | null | undefined, snapshotB: BitFieldSnapshot | null | undefined): boolean;
+
+export { BitConfig, type BitFieldSnapshot, BitStoreHooksApi, areFieldSnapshotsEqual, cleanPrefixedKeys, createBitStore, createFieldStateSnapshot, deepClone, deepEqual, deepMerge, extractServerErrors, getDeepValue, isValidationErrorShape, resolveBitStoreForHooks, setDeepValue, valueEqual };

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as o,b as r,c as e,d as f,e as m,f as p,g as t,h as x,i as a,j as b,k as c,l as d}from"./chunk-PX6WKENM.js";export{b as bitBus,t as cleanPrefixedKeys,d as createBitStore,o as deepClone,f as deepEqual,r as deepMerge,a as extractServerErrors,m as getDeepValue,x as isValidationErrorShape,c as resolveBitStoreForHooks,p as setDeepValue,e as valueEqual};
+import{a as t,b as i,c as e,d as r,e as o,f as a,g as B,h as n,i as l,j as s,k as p,s as d,t as u,u as S,v as F}from"./chunk-SA47B5OP.js";import"./chunk-3NUJVIAM.js";export{F as areFieldSnapshotsEqual,s as bitBus,B as cleanPrefixedKeys,p as createBitBus,u as createBitStore,S as createFieldStateSnapshot,t as deepClone,r as deepEqual,i as deepMerge,l as extractServerErrors,o as getDeepValue,n as isValidationErrorShape,d as resolveBitStoreForHooks,a as setDeepValue,e as valueEqual};
 //# sourceMappingURL=index.js.map

package/dist/mask.d.cts

@@ -1,5 +1,5 @@
-import { P as PatternMaskOptions, B as BitMask, C as CurrencyMaskConfig, D as DateMaskConfig, b as BitBuiltInMaskName } from './types-D8DgIUhJ.cjs';
-export { a as BitMaskName } from './types-D8DgIUhJ.cjs';
+import { P as PatternMaskOptions, B as BitMask, C as CurrencyMaskConfig, D as DateMaskConfig, a as BitBuiltInMaskName } from './types-CUXh7PqD.cjs';
+export { b as BitMaskName } from './types-CUXh7PqD.cjs';
 
 declare const unmask: (value: string | number | null | undefined, allowChars?: string) => string;
 declare const unmaskCurrency: (value: any, precision?: number) => number;

package/dist/mask.d.ts

@@ -1,5 +1,5 @@
-import { P as PatternMaskOptions, B as BitMask, C as CurrencyMaskConfig, D as DateMaskConfig, b as BitBuiltInMaskName } from './types-D8DgIUhJ.js';
-export { a as BitMaskName } from './types-D8DgIUhJ.js';
+import { P as PatternMaskOptions, B as BitMask, C as CurrencyMaskConfig, D as DateMaskConfig, a as BitBuiltInMaskName } from './types-CUXh7PqD.js';
+export { b as BitMaskName } from './types-CUXh7PqD.js';
 
 declare const unmask: (value: string | number | null | undefined, allowChars?: string) => string;
 declare const unmaskCurrency: (value: any, precision?: number) => number;

package/dist/react/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunk3EDD3V43cjs = require('../chunk-3EDD3V43.cjs');var _chunkVQ7MK5VBcjs = require('../chunk-VQ7MK5VB.cjs');require('../chunk-Y2ONHDRE.cjs');require('../chunk-YCSWULEN.cjs');var _chunkPFPGASVZcjs = require('../chunk-PFPGASVZ.cjs');var _react = require('react');function F(e){let{fieldState:s,setValue:n,setBlur:o,store:t}=_chunk3EDD3V43cjs.d.call(void 0, e),d=_react.useSyncExternalStore.call(void 0, u=>t.subscribe(u),()=>t.getMasksVersion(),()=>t.getMasksVersion()),a=_react.useMemo.call(void 0, ()=>t.resolveMask(e),[d,t.config.fields,e]),r=_react.useMemo.call(void 0, ()=>_chunkPFPGASVZcjs.b.call(void 0, s.value,_nullishCoalesce(a, () => (void 0))),[s.value,a]),i=_react.useCallback.call(void 0, u=>n(_chunkPFPGASVZcjs.c.call(void 0, u,_nullishCoalesce(a, () => (void 0)))),[a,n]),{isHidden:B,isRequired:f,value:l,error:p,touched:y,isDirty:h,isValidating:T}=s,E=!!(y&&p),I=y?p:void 0,x=_react.useCallback.call(void 0, u=>{let C=_chunkPFPGASVZcjs.a.call(void 0, u)?_optionalChain([u, 'access', _ => _.target, 'optionalAccess', _2 => _2.value]):u;i(C)},[i]),g=_react.useCallback.call(void 0, ()=>{o()},[o]);return{value:l,displayValue:r,setValue:i,setBlur:o,onChange:x,onBlur:g,props:{value:r,onChange:x,onBlur:g},meta:{error:I,touched:y,invalid:E,isDirty:h,isValidating:T,isHidden:B,isRequired:f,hasError:!!p}}}function G(){let e=_chunk3EDD3V43cjs.b.call(void 0, ),s=_react.useRef.call(void 0, null),n=_react.useCallback.call(void 0, ()=>{let r=e.getHistoryMetadata();if(s.current&&_chunkVQ7MK5VBcjs.a.call(void 0, s.current,r))return s.current;let i={canUndo:r.canUndo,canRedo:r.canRedo,historyIndex:r.historyIndex,historySize:r.historySize};return s.current=i,i},[e]),o=_react.useCallback.call(void 0, r=>e.subscribe(r),[e]),t=_react.useSyncExternalStore.call(void 0, o,n,n),d=_react.useCallback.call(void 0, ()=>{e.undo()},[e]),a=_react.useCallback.call(void 0, ()=>{e.redo()},[e]);return{...t,undo:d,redo:a}}function Q(e,s,n){let o=_chunk3EDD3V43cjs.b.call(void 0, ),t=F(e),d=_react.useRef.call(void 0, null),[a,r]=_react.useState.call(void 0, !1),i={setLoading:r,setError:(l,p)=>o.setError(l,p),setValue:l=>t.setValue(l),getUploadKey:()=>d.current,setUploadKey:l=>{d.current=l}},B=_react.useCallback.call(void 0, _chunkVQ7MK5VBcjs.b.call(void 0, e,s,i),[s,t,e,o]),f=_react.useCallback.call(void 0, _chunkVQ7MK5VBcjs.c.call(void 0, e,n,i),[n,t,e,o]);return{value:t.value,setValue:t.setValue,error:_optionalChain([t, 'access', _3 => _3.meta, 'optionalAccess', _4 => _4.error]),isValidating:!!_optionalChain([t, 'access', _5 => _5.meta, 'optionalAccess', _6 => _6.isValidating])||a,upload:B,remove:f}}exports.BitFormProvider = _chunk3EDD3V43cjs.a; exports.useBitArray = _chunk3EDD3V43cjs.e; exports.useBitField = F; exports.useBitForm = _chunk3EDD3V43cjs.c; exports.useBitHistory = G; exports.useBitPersist = _chunk3EDD3V43cjs.i; exports.useBitScope = _chunk3EDD3V43cjs.f; exports.useBitSteps = _chunk3EDD3V43cjs.g; exports.useBitStore = _chunk3EDD3V43cjs.b; exports.useBitUpload = Q; exports.useBitWatch = _chunk3EDD3V43cjs.h;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunkKWLLYQOLcjs = require('../chunk-KWLLYQOL.cjs');var _chunkIV32WXCFcjs = require('../chunk-IV32WXCF.cjs');var _chunkFUUQB4DVcjs = require('../chunk-FUUQB4DV.cjs');var _chunkPFPGASVZcjs = require('../chunk-PFPGASVZ.cjs');var _react = require('react');function f(e){let{fieldState:t,setBlur:n,store:a}=_chunkKWLLYQOLcjs.d.call(void 0, e),{fieldController:r}=_react.useMemo.call(void 0, ()=>_chunkFUUQB4DVcjs.E.call(void 0, a,e),[a,e]),l=_react.useMemo.call(void 0, ()=>r.displayValue(t.value),[t.value,r]),u=_react.useCallback.call(void 0, i=>{r.setValue(i)},[r]),{value:o}=t,s=_chunkFUUQB4DVcjs.I.call(void 0, t),p=_react.useCallback.call(void 0, i=>{let B=_chunkPFPGASVZcjs.a.call(void 0, i)?_optionalChain([i, 'access', _ => _.target, 'optionalAccess', _2 => _2.value]):i;u(B)},[u]),c=_react.useCallback.call(void 0, ()=>{n()},[n]);return{value:o,displayValue:l,setValue:u,setBlur:n,onChange:p,onBlur:c,props:{value:l,onChange:p,onBlur:c},meta:{error:s.error,touched:s.touched,invalid:s.invalid,isDirty:s.isDirty,isValidating:s.isValidating,isHidden:s.isHidden,isRequired:s.isRequired,hasError:s.hasError}}}function D(){let e=_chunkKWLLYQOLcjs.b.call(void 0, ),t=_react.useRef.call(void 0, null),n=_react.useCallback.call(void 0, ()=>{let o=_chunkFUUQB4DVcjs.m.call(void 0, e);return t.current&&t.current.canUndo===o.canUndo&&t.current.canRedo===o.canRedo&&t.current.historyIndex===o.historyIndex&&t.current.historySize===o.historySize?t.current:(t.current=o,o)},[e]),a=_react.useCallback.call(void 0, o=>e.subscribeHistoryMeta(()=>o()),[e]),r=_react.useSyncExternalStore.call(void 0, a,n,n),l=_react.useCallback.call(void 0, ()=>{e.undo()},[e]),u=_react.useCallback.call(void 0, ()=>{e.redo()},[e]);return{...r,undo:l,redo:u}}function q(e,t,n){let a=_chunkKWLLYQOLcjs.b.call(void 0, ),r=f(e),l=_react.useRef.call(void 0, null),[u,o]=_react.useState.call(void 0, !1),s={setLoading:o,setError:(i,B)=>a.setError(i,B),setValue:i=>r.setValue(i),getUploadKey:()=>l.current,setUploadKey:i=>{l.current=i}},p=_react.useCallback.call(void 0, _chunkIV32WXCFcjs.a.call(void 0, e,t,s),[t,r,e,a]),c=_react.useCallback.call(void 0, _chunkIV32WXCFcjs.b.call(void 0, e,n,s),[n,r,e,a]);return{value:r.value,setValue:r.setValue,error:_optionalChain([r, 'access', _3 => _3.meta, 'optionalAccess', _4 => _4.error]),isValidating:!!_optionalChain([r, 'access', _5 => _5.meta, 'optionalAccess', _6 => _6.isValidating])||u,upload:p,remove:c}}exports.BitFormProvider = _chunkKWLLYQOLcjs.a; exports.useBitArray = _chunkKWLLYQOLcjs.e; exports.useBitField = f; exports.useBitForm = _chunkKWLLYQOLcjs.c; exports.useBitHistory = D; exports.useBitPersist = _chunkKWLLYQOLcjs.i; exports.useBitScope = _chunkKWLLYQOLcjs.f; exports.useBitSteps = _chunkKWLLYQOLcjs.g; exports.useBitStore = _chunkKWLLYQOLcjs.b; exports.useBitUpload = q; exports.useBitWatch = _chunkKWLLYQOLcjs.h;
 //# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/bit-form/bit-form/dist/react/index.cjs","../../src/react/use-bit-field.ts","../../src/react/use-bit-history.ts","../../src/react/use-bit-upload.ts"],"names":["useBitField","path","fieldState","rawSetValue","setBlur","store","useBitFieldBase","masksVersion","useSyncExternalStore","cb","resolvedMask","useMemo","displayValue","formatMaskedValue","setValue","useCallback","val","parseMaskedInput","isHidden","isRequired","value","error","touched","isDirty","isValidating","invalid","visibleError","onChange","e","isBitFieldInputEventObject","onBlur","useBitHistory","useBitStore","lastMeta","useRef","getSnapshot","nextMeta","isHistoryMetaEqual","stableMeta","subscribe","meta","undo","redo","useBitUpload","fieldPath","uploadFn","deleteFile","field","uploadKeyRef","isUploading","setIsUploading","useState","kernelCallbacks","msg","key","upload","createUploadHandler","remove","createRemoveHandler"],"mappings":"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","file":"/home/runner/work/bit-form/bit-form/dist/react/index.cjs","sourcesContent":[null,"import { useMemo, useCallback, useSyncExternalStore } from \"react\";\nimport { useBitFieldBase } from \"./use-bit-field-base\";\nimport { BitPath, BitPathValue } from \"../core\";\nimport {\n  formatMaskedValue,\n  parseMaskedInput,\n  isBitFieldInputEventObject,\n} from \"../core/mask/field-binding\";\nimport type {\n  BitFieldInputEvent,\n  UseBitFieldMeta,\n  UseBitFieldBindProps,\n  UseBitFieldResult,\n} from \"./types\";\n\nexport function useBitField<\n  TForm extends object = any,\n  P extends BitPath<TForm> = BitPath<TForm>,\n>(path: P): UseBitFieldResult<TForm, P> {\n  const {\n    fieldState,\n    setValue: rawSetValue,\n    setBlur,\n    store,\n  } = useBitFieldBase<BitPathValue<TForm, P>, TForm, P>(path);\n\n  // Track mask registrations reactively. getMasksVersion() returns a counter\n  // that increments on every registerMask() call. useSyncExternalStore fires\n  // the snapshot on every store notification; the integer comparison is O(1)\n  // so this only triggers a re-render when a mask is actually added.\n  const masksVersion = useSyncExternalStore(\n    // store.subscribe fires on every state change (global listener)\n    (cb) => store.subscribe(cb),\n    () => store.getMasksVersion(),\n    () => store.getMasksVersion(),\n  );\n\n  const resolvedMask = useMemo(() => {\n    return store.resolveMask(path as string);\n  }, [masksVersion, store.config.fields, path]);\n\n  const displayValue = useMemo(\n    () => formatMaskedValue(fieldState.value, resolvedMask ?? undefined),\n    [fieldState.value, resolvedMask],\n  );\n\n  const setValue = useCallback(\n    (val: BitPathValue<TForm, P> | string | number | null | undefined) =>\n      rawSetValue(\n        parseMaskedInput(val, resolvedMask ?? undefined) as BitPathValue<\n          TForm,\n          P\n        >,\n      ),\n    [resolvedMask, rawSetValue],\n  );\n\n  const { isHidden, isRequired, value, error, touched, isDirty, isValidating } =\n    fieldState;\n\n  const invalid = !!(touched && error);\n  const visibleError = touched ? error : undefined;\n\n  const onChange = useCallback(\n    (e: BitFieldInputEvent) => {\n      const val = isBitFieldInputEventObject(e) ? e.target?.value : e;\n      setValue(val);\n    },\n    [setValue],\n  );\n\n  const onBlur = useCallback(() => {\n    setBlur();\n  }, [setBlur]);\n\n  return {\n    // Main handlers and values (flat)\n    value: value as BitPathValue<TForm, P>,\n    displayValue,\n    setValue,\n    setBlur,\n    onChange,\n    onBlur,\n    // Props helper\n    props: {\n      value: displayValue,\n      onChange,\n      onBlur,\n    },\n    // Metadata (grouped)\n    meta: {\n      error: visibleError,\n      touched,\n      invalid,\n      isDirty,\n      isValidating,\n      isHidden,\n      isRequired,\n      hasError: !!error,\n    },\n  };\n}\n","import { useCallback, useRef, useSyncExternalStore } from \"react\";\nimport { isHistoryMetaEqual, type HistoryMeta } from \"../core/history-status\";\nimport { useBitStore } from \"./context\";\nimport type { UseBitHistoryResult } from \"./types\";\n\nexport function useBitHistory<T extends object = any>(): UseBitHistoryResult {\n  const store = useBitStore<T>();\n  const lastMeta = useRef<HistoryMeta | null>(null);\n\n  const getSnapshot = useCallback(() => {\n    const nextMeta = store.getHistoryMetadata();\n\n    if (lastMeta.current && isHistoryMetaEqual(lastMeta.current, nextMeta)) {\n      return lastMeta.current;\n    }\n\n    const stableMeta = {\n      canUndo: nextMeta.canUndo,\n      canRedo: nextMeta.canRedo,\n      historyIndex: nextMeta.historyIndex,\n      historySize: nextMeta.historySize,\n    };\n\n    lastMeta.current = stableMeta;\n    return stableMeta;\n  }, [store]);\n\n  const subscribe = useCallback(\n    (cb: () => void) => store.subscribe(cb),\n    [store],\n  );\n\n  const meta = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  const undo = useCallback(() => {\n    store.undo();\n  }, [store]);\n\n  const redo = useCallback(() => {\n    store.redo();\n  }, [store]);\n\n  return {\n    ...meta,\n    undo,\n    redo,\n  };\n}\n","/**\n * React Hook for File Upload Integration\n *\n * Minimal upload API integrated with global field validation lifecycle.\n *\n * @example\n * ```typescript\n * const avatar = useBitUpload(\"avatar\", uploadFn);\n *\n * return (\n *   <>\n *     <input\n *       type=\"file\"\n *       onChange={(e) => avatar.upload(e.target.files?.[0])}\n *       disabled={avatar.isValidating}\n *     />\n *     {avatar.error && <Error>{avatar.error}</Error>}\n *   </>\n * );\n * ```\n */\n\nimport { useCallback, useRef, useState } from \"react\";\nimport { useBitField } from \"./use-bit-field\";\nimport { useBitStore } from \"./context\";\nimport { BitUploadFn, BitDeleteUploadFn } from \"../core\";\nimport { createUploadHandler, createRemoveHandler } from \"../core/adapters\";\nimport type { UseBitUploadResult } from \"./types\";\n\nexport function useBitUpload(\n  fieldPath: string,\n  uploadFn: BitUploadFn,\n  deleteFile?: BitDeleteUploadFn,\n): UseBitUploadResult {\n  const store = useBitStore<any>();\n  const field = useBitField(fieldPath);\n  const uploadKeyRef = useRef<string | null>(null);\n  const [isUploading, setIsUploading] = useState(false);\n\n  const kernelCallbacks = {\n    setLoading: setIsUploading,\n    setError: (path: string, msg: string | undefined) =>\n      store.setError(path, msg),\n    setValue: (val: string | null) => field.setValue(val as any),\n    getUploadKey: () => uploadKeyRef.current,\n    setUploadKey: (key: string | null) => {\n      uploadKeyRef.current = key;\n    },\n  };\n\n  const upload = useCallback(\n    createUploadHandler(fieldPath, uploadFn, kernelCallbacks),\n    [uploadFn, field, fieldPath, store],\n  );\n\n  const remove = useCallback(\n    createRemoveHandler(fieldPath, deleteFile, kernelCallbacks),\n    [deleteFile, field, fieldPath, store],\n  );\n\n  return {\n    value: field.value,\n    setValue: field.setValue,\n    error: field.meta?.error,\n    isValidating: !!field.meta?.isValidating || isUploading,\n    upload,\n    remove,\n  };\n}\n"]}
+{"version":3,"sources":["/home/runner/work/bit-form/bit-form/dist/react/index.cjs","../../src/react/use-bit-field.ts","../../src/react/use-bit-history.ts","../../src/react/use-bit-upload.ts"],"names":["useBitField","path","fieldState","setBlur","store","useBitFieldBase","fieldController","useMemo","createFrameworkMaskedFieldBinding","displayValue","setValue","useCallback","val","value","metaState","deriveFieldMeta","onChange","e","isBitFieldInputEventObject","onBlur","useBitHistory","useBitStore","lastMeta","useRef","getSnapshot","nextMeta","readHistoryMetaSnapshot","subscribe","cb","meta","useSyncExternalStore","undo","redo","useBitUpload","fieldPath","uploadFn","deleteFile","field","uploadKeyRef","isUploading","setIsUploading","useState","kernelCallbacks","msg","key","upload","createUploadHandler","remove","createRemoveHandler"],"mappings":"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","file":"/home/runner/work/bit-form/bit-form/dist/react/index.cjs","sourcesContent":[null,"import { useMemo, useCallback } from \"react\";\nimport { useBitFieldBase } from \"./use-bit-field-base\";\nimport {\n  BitPath,\n  BitPathValue,\n  createFrameworkMaskedFieldBinding,\n  deriveFieldMeta,\n  isBitFieldInputEventObject,\n} from \"../core\";\nimport type {\n  BitFieldInputEvent,\n  UseBitFieldMeta,\n  UseBitFieldBindProps,\n  UseBitFieldResult,\n} from \"./types\";\n\nexport function useBitField<\n  TForm extends object = any,\n  P extends BitPath<TForm> = BitPath<TForm>,\n>(path: P): UseBitFieldResult<TForm, P> {\n  const { fieldState, setBlur, store } = useBitFieldBase<\n    BitPathValue<TForm, P>,\n    TForm,\n    P\n  >(path);\n\n  const { fieldController } = useMemo(() => {\n    return createFrameworkMaskedFieldBinding(store, path);\n  }, [store, path]);\n\n  const displayValue = useMemo(\n    () => fieldController.displayValue(fieldState.value),\n    [fieldState.value, fieldController],\n  );\n\n  const setValue = useCallback(\n    (val: BitPathValue<TForm, P> | string | number | null | undefined) => {\n      fieldController.setValue(val);\n    },\n    [fieldController],\n  );\n\n  const { value } = fieldState;\n  const metaState = deriveFieldMeta(fieldState);\n\n  const onChange = useCallback(\n    (e: BitFieldInputEvent) => {\n      const val = isBitFieldInputEventObject(e) ? e.target?.value : e;\n      setValue(val);\n    },\n    [setValue],\n  );\n\n  const onBlur = useCallback(() => {\n    setBlur();\n  }, [setBlur]);\n\n  return {\n    // Main handlers and values (flat)\n    value: value as BitPathValue<TForm, P>,\n    displayValue,\n    setValue,\n    setBlur,\n    onChange,\n    onBlur,\n    // Props helper\n    props: {\n      value: displayValue,\n      onChange,\n      onBlur,\n    },\n    // Metadata (grouped)\n    meta: {\n      error: metaState.error,\n      touched: metaState.touched,\n      invalid: metaState.invalid,\n      isDirty: metaState.isDirty,\n      isValidating: metaState.isValidating,\n      isHidden: metaState.isHidden,\n      isRequired: metaState.isRequired,\n      hasError: metaState.hasError,\n    },\n  };\n}\n","import { useCallback, useRef, useSyncExternalStore } from \"react\";\nimport { readHistoryMetaSnapshot, type HistoryMeta } from \"../core\";\nimport { useBitStore } from \"./context\";\nimport type { UseBitHistoryResult } from \"./types\";\n\nexport function useBitHistory<T extends object = any>(): UseBitHistoryResult {\n  const store = useBitStore<T>();\n  const lastMeta = useRef<HistoryMeta | null>(null);\n\n  const getSnapshot = useCallback(() => {\n    const nextMeta = readHistoryMetaSnapshot(store);\n\n    if (\n      lastMeta.current &&\n      lastMeta.current.canUndo === nextMeta.canUndo &&\n      lastMeta.current.canRedo === nextMeta.canRedo &&\n      lastMeta.current.historyIndex === nextMeta.historyIndex &&\n      lastMeta.current.historySize === nextMeta.historySize\n    ) {\n      return lastMeta.current;\n    }\n\n    lastMeta.current = nextMeta;\n    return nextMeta;\n  }, [store]);\n\n  const subscribe = useCallback(\n    (cb: () => void) => store.subscribeHistoryMeta(() => cb()),\n    [store],\n  );\n\n  const meta = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  const undo = useCallback(() => {\n    store.undo();\n  }, [store]);\n\n  const redo = useCallback(() => {\n    store.redo();\n  }, [store]);\n\n  return {\n    ...meta,\n    undo,\n    redo,\n  };\n}\n","/**\n * React Hook for File Upload Integration\n *\n * Minimal upload API integrated with global field validation lifecycle.\n *\n * @example\n * ```typescript\n * const avatar = useBitUpload(\"avatar\", uploadFn);\n *\n * return (\n *   <>\n *     <input\n *       type=\"file\"\n *       onChange={(e) => avatar.upload(e.target.files?.[0])}\n *       disabled={avatar.isValidating}\n *     />\n *     {avatar.error && <Error>{avatar.error}</Error>}\n *   </>\n * );\n * ```\n */\n\nimport { useCallback, useRef, useState } from \"react\";\nimport { useBitField } from \"./use-bit-field\";\nimport { useBitStore } from \"./context\";\nimport { BitUploadFn, BitDeleteUploadFn } from \"../core\";\nimport { createUploadHandler, createRemoveHandler } from \"../core/adapters\";\nimport type { UseBitUploadResult } from \"./types\";\n\nexport function useBitUpload(\n  fieldPath: string,\n  uploadFn: BitUploadFn,\n  deleteFile?: BitDeleteUploadFn,\n): UseBitUploadResult {\n  const store = useBitStore<any>();\n  const field = useBitField(fieldPath);\n  const uploadKeyRef = useRef<string | null>(null);\n  const [isUploading, setIsUploading] = useState(false);\n\n  const kernelCallbacks = {\n    setLoading: setIsUploading,\n    setError: (path: string, msg: string | undefined) =>\n      store.setError(path, msg),\n    setValue: (val: string | null) => field.setValue(val as any),\n    getUploadKey: () => uploadKeyRef.current,\n    setUploadKey: (key: string | null) => {\n      uploadKeyRef.current = key;\n    },\n  };\n\n  const upload = useCallback(\n    createUploadHandler(fieldPath, uploadFn, kernelCallbacks),\n    [uploadFn, field, fieldPath, store],\n  );\n\n  const remove = useCallback(\n    createRemoveHandler(fieldPath, deleteFile, kernelCallbacks),\n    [deleteFile, field, fieldPath, store],\n  );\n\n  return {\n    value: field.value,\n    setValue: field.setValue,\n    error: field.meta?.error,\n    isValidating: !!field.meta?.isValidating || isUploading,\n    upload,\n    remove,\n  };\n}\n"]}

package/dist/react/index.d.cts

@@ -1,13 +1,14 @@
-import { g as UseBitFieldResult, h as UseBitHistoryResult, i as UseBitUploadResult } from '../use-bit-persist-D_gimC9A.cjs';
-export { B as BitFormProvider, j as UseBitFieldBindProps, k as UseBitFieldMeta, U as UseBitPersistResult, l as UseBitStepsResult, u as useBitArray, a as useBitForm, b as useBitPersist, c as useBitScope, d as useBitSteps, e as useBitStore, f as useBitWatch } from '../use-bit-persist-D_gimC9A.cjs';
-import { f as BitPath } from '../bus-BeAeZwWu.cjs';
-export { S as ScopeStatus, n as ValidateScopeResult } from '../bus-BeAeZwWu.cjs';
+import { g as UseBitFieldResult, h as UseBitHistoryResult, i as UseBitUploadResult } from '../use-bit-persist-CIKFwtdM.cjs';
+export { B as BitFormProvider, j as UseBitFieldBindProps, k as UseBitFieldMeta, U as UseBitPersistResult, l as UseBitStepsResult, u as useBitArray, a as useBitForm, b as useBitPersist, c as useBitScope, d as useBitSteps, e as useBitStore, f as useBitWatch } from '../use-bit-persist-CIKFwtdM.cjs';
+import { e as BitPath } from '../bus-rcUiufS7.cjs';
+export { S as ScopeStatus, V as ValidateScopeResult } from '../bus-rcUiufS7.cjs';
 import { B as BitUploadFn, a as BitDeleteUploadFn } from '../upload-EXnJLq8k.cjs';
 import 'react/jsx-runtime';
 import 'react';
-import '../public-types-Cd9ai20P.cjs';
-import '../types-D8DgIUhJ.cjs';
-import '../field-binding-BXw0Ku2c.cjs';
+import '../store-api-types-B6_bPoVI.cjs';
+import '../types-CUXh7PqD.cjs';
+import '../array-controller-C1A5VKYd.cjs';
+import '../field-binding-X5TkvfUt.cjs';
 
 declare function useBitField<TForm extends object = any, P extends BitPath<TForm> = BitPath<TForm>>(path: P): UseBitFieldResult<TForm, P>;