@lehnihon/bit-form 2.2.9 → 2.2.10

package/dist/react-native/index.js

@@ -1,2 +1,2 @@
-import{a as x,b as P,c as v,d as B,e as y,f as h,g as V,h as T,i as S}from"../chunk-J5GQLEVA.js";import"../chunk-5NA2TFPG.js";import"../chunk-UARLAXZX.js";import{h as m}from"../chunk-Y3XVQGCU.js";import"../chunk-W2E5UIXT.js";import"../chunk-UIKO6GGW.js";import{a as p}from"../chunk-ICYXODTQ.js";import"../chunk-2QLQPMCZ.js";import"../chunk-QX2IVNMK.js";import"../chunk-3NUJVIAM.js";import{useMemo as c,useCallback as a}from"react";function g(i){let{fieldState:r,setBlur:o,store:l}=B(i),{fieldController:t}=c(()=>m(l,i),[l,i]),u=c(()=>t.displayValue(r.value),[r.value,t]),d=a(s=>t.setValue(s),[t]),F=a(s=>t.setValue(s),[t]),{value:f}=r,e=p(r),n=a(()=>{o()},[o]);return{value:f,displayValue:u,setValue:F,setBlur:o,onChangeText:d,onBlur:n,meta:{error:e.error,touched:e.touched,invalid:e.invalid,isValidating:e.isValidating,isDirty:e.isDirty,isHidden:e.isHidden,isRequired:e.isRequired,hasError:e.hasError},props:{value:u,onChangeText:d,onBlur:n}}}export{x as BitFormProvider,y as useBitArray,g as useBitField,v as useBitForm,S as useBitPersist,h as useBitScope,V as useBitSteps,P as useBitStore,T as useBitWatch};
+import{a as x,b as P,c as v,d as B,e as y,f as h,g as V,h as T,i as S}from"../chunk-GQ2QJCBF.js";import"../chunk-5NA2TFPG.js";import"../chunk-G2FQQDRK.js";import{h as m}from"../chunk-2AFWJAQG.js";import"../chunk-W2E5UIXT.js";import"../chunk-UIKO6GGW.js";import{a as p}from"../chunk-ICYXODTQ.js";import"../chunk-OPC7HFNN.js";import"../chunk-FLFIOW75.js";import"../chunk-3NUJVIAM.js";import{useMemo as c,useCallback as a}from"react";function g(i){let{fieldState:r,setBlur:o,store:l}=B(i),{fieldController:t}=c(()=>m(l,i),[l,i]),u=c(()=>t.displayValue(r.value),[r.value,t]),d=a(s=>t.setValue(s),[t]),F=a(s=>t.setValue(s),[t]),{value:f}=r,e=p(r),n=a(()=>{o()},[o]);return{value:f,displayValue:u,setValue:F,setBlur:o,onChangeText:d,onBlur:n,meta:{error:e.error,touched:e.touched,invalid:e.invalid,isValidating:e.isValidating,isDirty:e.isDirty,isHidden:e.isHidden,isRequired:e.isRequired,hasError:e.hasError},props:{value:u,onChangeText:d,onBlur:n}}}export{x as BitFormProvider,y as useBitArray,g as useBitField,v as useBitForm,S as useBitPersist,h as useBitScope,V as useBitSteps,P as useBitStore,T as useBitWatch};
 //# sourceMappingURL=index.js.map

package/dist/resolvers/index.d.cts

@@ -3,8 +3,7 @@ export { zodResolver } from './zod.cjs';
 export { yupResolver } from './yup.cjs';
 export { BitJoiResolverConfig, BitResolverScopeOptions, BitYupResolverConfig, BitZodResolverConfig } from './types.cjs';
 import 'joi';
-import '../types-SOg9xEce.cjs';
-import '../types-D8DgIUhJ.cjs';
-import '../bus-WOHGxuVy.cjs';
+import '../state-types-8bUndWfg.cjs';
+import '../bus-DzTqgkZ4.cjs';
 import 'zod';
 import 'yup';

package/dist/resolvers/index.d.ts

@@ -3,8 +3,7 @@ export { zodResolver } from './zod.js';
 export { yupResolver } from './yup.js';
 export { BitJoiResolverConfig, BitResolverScopeOptions, BitYupResolverConfig, BitZodResolverConfig } from './types.js';
 import 'joi';
-import '../types-CRCP4Pgq.js';
-import '../types-D8DgIUhJ.js';
-import '../bus-BKuMV3E7.js';
+import '../state-types-8bUndWfg.js';
+import '../bus-BFOBGmd9.js';
 import 'zod';
 import 'yup';

package/dist/resolvers/joi.d.cts

@@ -1,8 +1,7 @@
 import { ObjectSchema } from 'joi';
-import { k as BitErrors } from '../types-SOg9xEce.cjs';
-import '../bus-WOHGxuVy.cjs';
+import { b as BitErrors } from '../state-types-8bUndWfg.cjs';
+import '../bus-DzTqgkZ4.cjs';
 import { BitJoiResolverConfig, BitResolverScopeOptions } from './types.cjs';
-import '../types-D8DgIUhJ.cjs';
 
 declare const joiResolver: <T extends object>(schema: ObjectSchema<T>, config?: BitJoiResolverConfig) => (values: T, options?: BitResolverScopeOptions) => Promise<BitErrors<T>>;
 

package/dist/resolvers/joi.d.ts

@@ -1,8 +1,7 @@
 import { ObjectSchema } from 'joi';
-import { k as BitErrors } from '../types-CRCP4Pgq.js';
-import '../bus-BKuMV3E7.js';
+import { b as BitErrors } from '../state-types-8bUndWfg.js';
+import '../bus-BFOBGmd9.js';
 import { BitJoiResolverConfig, BitResolverScopeOptions } from './types.js';
-import '../types-D8DgIUhJ.js';
 
 declare const joiResolver: <T extends object>(schema: ObjectSchema<T>, config?: BitJoiResolverConfig) => (values: T, options?: BitResolverScopeOptions) => Promise<BitErrors<T>>;
 

package/dist/resolvers/yup.d.cts

@@ -1,8 +1,7 @@
 import { Schema } from 'yup';
-import { k as BitErrors } from '../types-SOg9xEce.cjs';
-import '../bus-WOHGxuVy.cjs';
+import { b as BitErrors } from '../state-types-8bUndWfg.cjs';
+import '../bus-DzTqgkZ4.cjs';
 import { BitYupResolverConfig, BitResolverScopeOptions } from './types.cjs';
-import '../types-D8DgIUhJ.cjs';
 
 declare const yupResolver: <T extends object>(schema: Schema<T>, config?: BitYupResolverConfig) => (values: T, options?: BitResolverScopeOptions) => Promise<BitErrors<T>>;
 

package/dist/resolvers/yup.d.ts

@@ -1,8 +1,7 @@
 import { Schema } from 'yup';
-import { k as BitErrors } from '../types-CRCP4Pgq.js';
-import '../bus-BKuMV3E7.js';
+import { b as BitErrors } from '../state-types-8bUndWfg.js';
+import '../bus-BFOBGmd9.js';
 import { BitYupResolverConfig, BitResolverScopeOptions } from './types.js';
-import '../types-D8DgIUhJ.js';
 
 declare const yupResolver: <T extends object>(schema: Schema<T>, config?: BitYupResolverConfig) => (values: T, options?: BitResolverScopeOptions) => Promise<BitErrors<T>>;
 

package/dist/resolvers/zod.d.cts

@@ -1,8 +1,7 @@
 import { ZodSchema } from 'zod';
-import { k as BitErrors } from '../types-SOg9xEce.cjs';
-import '../bus-WOHGxuVy.cjs';
+import { b as BitErrors } from '../state-types-8bUndWfg.cjs';
+import '../bus-DzTqgkZ4.cjs';
 import { BitZodResolverConfig, BitResolverScopeOptions } from './types.cjs';
-import '../types-D8DgIUhJ.cjs';
 
 declare const zodResolver: <T extends object>(schema: ZodSchema<T>, _config?: BitZodResolverConfig) => (values: T, options?: BitResolverScopeOptions) => Promise<BitErrors<T>>;
 

package/dist/resolvers/zod.d.ts

@@ -1,8 +1,7 @@
 import { ZodSchema } from 'zod';
-import { k as BitErrors } from '../types-CRCP4Pgq.js';
-import '../bus-BKuMV3E7.js';
+import { b as BitErrors } from '../state-types-8bUndWfg.js';
+import '../bus-BFOBGmd9.js';
 import { BitZodResolverConfig, BitResolverScopeOptions } from './types.js';
-import '../types-D8DgIUhJ.js';
 
 declare const zodResolver: <T extends object>(schema: ZodSchema<T>, _config?: BitZodResolverConfig) => (values: T, options?: BitResolverScopeOptions) => Promise<BitErrors<T>>;
 

package/dist/runtime-types-D1SRZr-n.d.cts

@@ -0,0 +1,43 @@
+/**
+ * Pluggable scheduler used for validation debounce.
+ * Replace the default (setTimeout-based) with a framework-aware scheduler.
+ */
+interface BitScheduler {
+    schedule(fn: () => void, delayMs: number): () => void;
+}
+interface BitIdFactoryContext {
+    scope: "store" | "array";
+    path?: string;
+    index?: number;
+    storeName?: string;
+}
+type BitIdFactory = (context: BitIdFactoryContext) => string;
+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 scope validation helpers, used by useBitScope/injectBitScope. */
+interface ValidateScopeResult {
+    valid: boolean;
+    errors: Record<string, string>;
+}
+interface DevToolsOptions {
+    enabled?: boolean;
+    mode?: "local" | "remote";
+    url?: string;
+}
+
+export type { BitScheduler as B, DevToolsOptions as D, ScopeStatus as S, ValidateScopeResult as V, BitSubmitResult as a, BitIdFactory as b };

package/dist/runtime-types-D1SRZr-n.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Pluggable scheduler used for validation debounce.
+ * Replace the default (setTimeout-based) with a framework-aware scheduler.
+ */
+interface BitScheduler {
+    schedule(fn: () => void, delayMs: number): () => void;
+}
+interface BitIdFactoryContext {
+    scope: "store" | "array";
+    path?: string;
+    index?: number;
+    storeName?: string;
+}
+type BitIdFactory = (context: BitIdFactoryContext) => string;
+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 scope validation helpers, used by useBitScope/injectBitScope. */
+interface ValidateScopeResult {
+    valid: boolean;
+    errors: Record<string, string>;
+}
+interface DevToolsOptions {
+    enabled?: boolean;
+    mode?: "local" | "remote";
+    url?: string;
+}
+
+export type { BitScheduler as B, DevToolsOptions as D, ScopeStatus as S, ValidateScopeResult as V, BitSubmitResult as a, BitIdFactory as b };

package/dist/state-types-8bUndWfg.d.cts

@@ -0,0 +1,42 @@
+/**
+ * Type-safe path utilities for form structures.
+ */
+type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+type BitPath<T, Prefix extends string = ""> = T extends Primitive ? never : T extends readonly (infer U)[] ? Prefix extends "" ? `${number}` | `${number}.${BitPath<U>}` : `${Prefix}.${number}` | `${Prefix}.${number}.${BitPath<U>}` : {
+    [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 unknown[] ? P : never : never : never;
+type BitArrayItem<A> = A extends readonly (infer U)[] ? U : A extends (infer U)[] ? U : never;
+
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+type BitErrors<T extends object> = Partial<Record<BitPath<T>, string | undefined>>;
+type BitTouched<T extends object> = Partial<Record<BitPath<T>, boolean | undefined>>;
+interface BitPersistMetadata {
+    isSaving: boolean;
+    isRestoring: boolean;
+    error: Error | null;
+}
+interface BitState<T extends object> {
+    values: T;
+    errors: BitErrors<T>;
+    touched: BitTouched<T>;
+    isValidating: Record<string, boolean>;
+    persist: BitPersistMetadata;
+    isValid: boolean;
+    isSubmitting: boolean;
+    isDirty: boolean;
+}
+interface BitFieldState<_T extends object = Record<string, unknown>, TValue = unknown> {
+    value: TValue;
+    error: string | undefined;
+    touched: boolean;
+    isHidden: boolean;
+    isRequired: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}
+
+export type { BitArrayItem as B, DeepPartial as D, BitArrayPath as a, BitErrors as b, BitFieldState as c, BitPath as d, BitPathValue as e, BitPersistMetadata as f, BitState as g, BitTouched as h };

package/dist/state-types-8bUndWfg.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Type-safe path utilities for form structures.
+ */
+type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+type BitPath<T, Prefix extends string = ""> = T extends Primitive ? never : T extends readonly (infer U)[] ? Prefix extends "" ? `${number}` | `${number}.${BitPath<U>}` : `${Prefix}.${number}` | `${Prefix}.${number}.${BitPath<U>}` : {
+    [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 unknown[] ? P : never : never : never;
+type BitArrayItem<A> = A extends readonly (infer U)[] ? U : A extends (infer U)[] ? U : never;
+
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+type BitErrors<T extends object> = Partial<Record<BitPath<T>, string | undefined>>;
+type BitTouched<T extends object> = Partial<Record<BitPath<T>, boolean | undefined>>;
+interface BitPersistMetadata {
+    isSaving: boolean;
+    isRestoring: boolean;
+    error: Error | null;
+}
+interface BitState<T extends object> {
+    values: T;
+    errors: BitErrors<T>;
+    touched: BitTouched<T>;
+    isValidating: Record<string, boolean>;
+    persist: BitPersistMetadata;
+    isValid: boolean;
+    isSubmitting: boolean;
+    isDirty: boolean;
+}
+interface BitFieldState<_T extends object = Record<string, unknown>, TValue = unknown> {
+    value: TValue;
+    error: string | undefined;
+    touched: boolean;
+    isHidden: boolean;
+    isRequired: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}
+
+export type { BitArrayItem as B, DeepPartial as D, BitArrayPath as a, BitErrors as b, BitFieldState as c, BitPath as d, BitPathValue as e, BitPersistMetadata as f, BitState as g, BitTouched as h };

package/dist/{store-api-types-Bm3EAqR_.d.cts → store-api-types-Bozwlwyb.d.ts}

@@ -1,6 +1,9 @@
-import { B as BitMask } from './types-D8DgIUhJ.cjs';
-import { G as BitState, j as BitConfig, N as ValidatorFn, o as BitFieldDefinition, M as DevToolsOptions, O as BitPersistResolvedConfig, P as BitIdFactory, A as BitPlugin, F as BitScheduler, r as BitFormGlobal, Q as BitOperationalErrorSource, u as BitPath, p as BitFieldState, v as BitPathValue, x as BitPersistMetadata, S as ScopeStatus, L as DeepPartial, k as BitErrors, H as BitSubmitResult, c as BitArrayPath, b as BitArrayItem } from './types-SOg9xEce.cjs';
-import { a as BitHistoryMetadata, B as BitFormMeta, b as BitValidationOptions } from './meta-types-Bzmm21TP.cjs';
+import { B as BitMask } from './types-CUXh7PqD.js';
+import { c as BitFormGlobal } from './bus-BFOBGmd9.js';
+import { e as BitConfig, V as ValidatorFn, i as BitFieldDefinition, v as BitPersistResolvedConfig, p as BitPlugin, w as BitOperationalErrorSource } from './config-types-D9n-rQLk.js';
+import { g as BitState, d as BitPath, c as BitFieldState, e as BitPathValue, f as BitPersistMetadata, D as DeepPartial, b as BitErrors, a as BitArrayPath, B as BitArrayItem } from './state-types-8bUndWfg.js';
+import { D as DevToolsOptions, b as BitIdFactory, B as BitScheduler, S as ScopeStatus, a as BitSubmitResult } from './runtime-types-D1SRZr-n.js';
+import { a as BitHistoryMetadata, B as BitFormMeta, c as BitServerErrorOptions, b as BitValidationOptions } from './meta-types-BC1VLABk.js';
 
 interface BitValidationTriggerOptions {
     forceDebounce?: boolean;
@@ -76,10 +79,10 @@ interface BitFormWriteApi<T extends object = Record<string, unknown>> {
     }): void;
     setError(path: string, message: string | undefined): void;
     setErrors(errors: BitErrors<T>): void;
-    setServerErrors(serverErrors: Record<string, string[] | string>): void;
+    setServerErrors(serverErrors: Record<string, string[] | string>, options?: BitServerErrorOptions): void;
     reset(): void;
     transaction<TResult>(callback: () => TResult): TResult;
-    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<BitSubmitResult>;
+    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => unknown | Promise<unknown>): Promise<BitSubmitResult>;
 }
 interface BitStoreLifecycleApi {
     cleanup(): void;
@@ -103,6 +106,7 @@ interface BitStoreArrayFeatureApi<T extends object = Record<string, unknown>> {
     swapItems<P extends BitArrayPath<T>>(path: P, indexA: number, indexB: number): void;
     replaceItems<P extends BitArrayPath<T>>(path: P, items: BitArrayItem<BitPathValue<T, P>>[]): void;
     clearItems<P extends BitArrayPath<T>>(path: P): void;
+    getArrayItemIds<P extends BitArrayPath<T>>(path: P, length?: number): string[];
 }
 interface BitStoreHistoryFeatureApi {
     readonly canUndo: boolean;

package/dist/{store-api-types-DfTFy2h4.d.ts → store-api-types-DSgYwMS3.d.cts}

@@ -1,6 +1,9 @@
-import { B as BitMask } from './types-D8DgIUhJ.js';
-import { G as BitState, j as BitConfig, N as ValidatorFn, o as BitFieldDefinition, M as DevToolsOptions, O as BitPersistResolvedConfig, P as BitIdFactory, A as BitPlugin, F as BitScheduler, r as BitFormGlobal, Q as BitOperationalErrorSource, u as BitPath, p as BitFieldState, v as BitPathValue, x as BitPersistMetadata, S as ScopeStatus, L as DeepPartial, k as BitErrors, H as BitSubmitResult, c as BitArrayPath, b as BitArrayItem } from './types-CRCP4Pgq.js';
-import { a as BitHistoryMetadata, B as BitFormMeta, b as BitValidationOptions } from './meta-types-Bzmm21TP.js';
+import { B as BitMask } from './types-CUXh7PqD.cjs';
+import { c as BitFormGlobal } from './bus-DzTqgkZ4.cjs';
+import { e as BitConfig, V as ValidatorFn, i as BitFieldDefinition, v as BitPersistResolvedConfig, p as BitPlugin, w as BitOperationalErrorSource } from './config-types-5eR82k2V.cjs';
+import { g as BitState, d as BitPath, c as BitFieldState, e as BitPathValue, f as BitPersistMetadata, D as DeepPartial, b as BitErrors, a as BitArrayPath, B as BitArrayItem } from './state-types-8bUndWfg.cjs';
+import { D as DevToolsOptions, b as BitIdFactory, B as BitScheduler, S as ScopeStatus, a as BitSubmitResult } from './runtime-types-D1SRZr-n.cjs';
+import { a as BitHistoryMetadata, B as BitFormMeta, c as BitServerErrorOptions, b as BitValidationOptions } from './meta-types-BC1VLABk.cjs';
 
 interface BitValidationTriggerOptions {
     forceDebounce?: boolean;
@@ -76,10 +79,10 @@ interface BitFormWriteApi<T extends object = Record<string, unknown>> {
     }): void;
     setError(path: string, message: string | undefined): void;
     setErrors(errors: BitErrors<T>): void;
-    setServerErrors(serverErrors: Record<string, string[] | string>): void;
+    setServerErrors(serverErrors: Record<string, string[] | string>, options?: BitServerErrorOptions): void;
     reset(): void;
     transaction<TResult>(callback: () => TResult): TResult;
-    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<BitSubmitResult>;
+    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => unknown | Promise<unknown>): Promise<BitSubmitResult>;
 }
 interface BitStoreLifecycleApi {
     cleanup(): void;
@@ -103,6 +106,7 @@ interface BitStoreArrayFeatureApi<T extends object = Record<string, unknown>> {
     swapItems<P extends BitArrayPath<T>>(path: P, indexA: number, indexB: number): void;
     replaceItems<P extends BitArrayPath<T>>(path: P, items: BitArrayItem<BitPathValue<T, P>>[]): void;
     clearItems<P extends BitArrayPath<T>>(path: P): void;
+    getArrayItemIds<P extends BitArrayPath<T>>(path: P, length?: number): string[];
 }
 interface BitStoreHistoryFeatureApi {
     readonly canUndo: boolean;

package/dist/{types-D8DgIUhJ.d.cts → types-CUXh7PqD.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, BitMaskName as a, BitBuiltInMaskName as b };
+export type { BitMask as B, CurrencyMaskConfig as C, DateMaskConfig as D, PatternMaskOptions as P, BitBuiltInMaskName as a, BitMaskName as b };

package/dist/{types-D8DgIUhJ.d.ts → types-CUXh7PqD.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, BitMaskName as a, BitBuiltInMaskName as b };
+export type { BitMask as B, CurrencyMaskConfig as C, DateMaskConfig as D, PatternMaskOptions as P, BitBuiltInMaskName as a, BitMaskName as b };

package/dist/upload-C4JqIaU2.d.cts

@@ -0,0 +1,89 @@
+import { a as BitArrayPath, B as BitArrayItem, e as BitPathValue } from './state-types-8bUndWfg.cjs';
+
+interface BitArrayBindingField<TItem> {
+    key: string;
+    value: TItem;
+    index: number;
+}
+interface BitArrayBinding<TForm extends object, P extends BitArrayPath<TForm>> {
+    readItems(): BitArrayItem<BitPathValue<TForm, P>>[];
+    getFields(items: BitArrayItem<BitPathValue<TForm, P>>[]): BitArrayBindingField<BitArrayItem<BitPathValue<TForm, P>>>[];
+    append(value: BitArrayItem<BitPathValue<TForm, P>>): void;
+    prepend(value: BitArrayItem<BitPathValue<TForm, P>>): void;
+    insert(index: number, value: BitArrayItem<BitPathValue<TForm, P>>): void;
+    remove(index: number): void;
+    move(from: number, to: number): void;
+    swap(indexA: number, indexB: number): void;
+    replace(items: BitArrayItem<BitPathValue<TForm, P>>[]): void;
+    clear(): void;
+}
+
+/**
+ * Shared framework adapter contracts.
+ *
+ * These contracts define shape only; each framework provides its own reactive wrappers.
+ */
+interface BitStepsAdapterResult<TStep, TStepIndex, TScope, TBoolean, TStatus, TErrors, TValidateResult> {
+    step: TStep;
+    stepIndex: TStepIndex;
+    scope: TScope;
+    next: () => Promise<boolean>;
+    prev: () => void;
+    goTo: (step: number) => void;
+    isFirst: TBoolean;
+    isLast: TBoolean;
+    status: TStatus;
+    errors: TErrors;
+    isValid: TBoolean;
+    isDirty: TBoolean;
+    validate: () => Promise<TValidateResult>;
+    getErrors: () => Record<string, string>;
+}
+interface BitHistoryAdapterResult<TCanUndo, TCanRedo, THistoryIndex, THistorySize> {
+    canUndo: TCanUndo;
+    canRedo: TCanRedo;
+    historyIndex: THistoryIndex;
+    historySize: THistorySize;
+    undo: () => void;
+    redo: () => void;
+}
+interface BitPersistAdapterResult<TMeta> {
+    restore: () => Promise<boolean>;
+    save: () => Promise<void>;
+    clear: () => Promise<void>;
+    meta: TMeta;
+}
+
+/**
+ * Upload Integration Types
+ *
+ * Core types for backend-first upload integration.
+ */
+/** Upload result with URL and key for reference/deletion. */
+interface BitUploadResult<TMetadata extends Record<string, unknown> = Record<string, unknown>> {
+    url: string;
+    key: string;
+    metadata?: TMetadata;
+}
+/** Upload function contract (backend-first). All context is managed by the caller. */
+type BitUploadFn<TMetadata extends Record<string, unknown> = Record<string, unknown>> = (file: File) => Promise<BitUploadResult<TMetadata>>;
+/** Optional delete function contract. */
+type BitDeleteUploadFn = (key: string) => Promise<void>;
+/** Canonical value used by upload bindings across frameworks. */
+type BitUploadValue = string | File | null;
+/** Input accepted by upload handlers. */
+type BitUploadInput = File | null | undefined;
+/**
+ * Base upload contract for framework adapters.
+ * Frameworks specialize `value`, `error`, and `isValidating` with their reactive wrappers.
+ */
+interface BitUploadAdapterResult<TValue, TError, TIsValidating> {
+    value: TValue;
+    setValue: (value: BitUploadValue) => void;
+    error: TError;
+    isValidating: TIsValidating;
+    upload: (file: BitUploadInput) => Promise<void>;
+    remove: () => Promise<void>;
+}
+
+export type { BitArrayBinding as B, BitArrayBindingField as a, BitDeleteUploadFn as b, BitHistoryAdapterResult as c, BitPersistAdapterResult as d, BitStepsAdapterResult as e, BitUploadAdapterResult as f, BitUploadFn as g, BitUploadInput as h, BitUploadResult as i, BitUploadValue as j };

package/dist/upload-ao6skK9K.d.ts

@@ -0,0 +1,89 @@
+import { a as BitArrayPath, B as BitArrayItem, e as BitPathValue } from './state-types-8bUndWfg.js';
+
+interface BitArrayBindingField<TItem> {
+    key: string;
+    value: TItem;
+    index: number;
+}
+interface BitArrayBinding<TForm extends object, P extends BitArrayPath<TForm>> {
+    readItems(): BitArrayItem<BitPathValue<TForm, P>>[];
+    getFields(items: BitArrayItem<BitPathValue<TForm, P>>[]): BitArrayBindingField<BitArrayItem<BitPathValue<TForm, P>>>[];
+    append(value: BitArrayItem<BitPathValue<TForm, P>>): void;
+    prepend(value: BitArrayItem<BitPathValue<TForm, P>>): void;
+    insert(index: number, value: BitArrayItem<BitPathValue<TForm, P>>): void;
+    remove(index: number): void;
+    move(from: number, to: number): void;
+    swap(indexA: number, indexB: number): void;
+    replace(items: BitArrayItem<BitPathValue<TForm, P>>[]): void;
+    clear(): void;
+}
+
+/**
+ * Shared framework adapter contracts.
+ *
+ * These contracts define shape only; each framework provides its own reactive wrappers.
+ */
+interface BitStepsAdapterResult<TStep, TStepIndex, TScope, TBoolean, TStatus, TErrors, TValidateResult> {
+    step: TStep;
+    stepIndex: TStepIndex;
+    scope: TScope;
+    next: () => Promise<boolean>;
+    prev: () => void;
+    goTo: (step: number) => void;
+    isFirst: TBoolean;
+    isLast: TBoolean;
+    status: TStatus;
+    errors: TErrors;
+    isValid: TBoolean;
+    isDirty: TBoolean;
+    validate: () => Promise<TValidateResult>;
+    getErrors: () => Record<string, string>;
+}
+interface BitHistoryAdapterResult<TCanUndo, TCanRedo, THistoryIndex, THistorySize> {
+    canUndo: TCanUndo;
+    canRedo: TCanRedo;
+    historyIndex: THistoryIndex;
+    historySize: THistorySize;
+    undo: () => void;
+    redo: () => void;
+}
+interface BitPersistAdapterResult<TMeta> {
+    restore: () => Promise<boolean>;
+    save: () => Promise<void>;
+    clear: () => Promise<void>;
+    meta: TMeta;
+}
+
+/**
+ * Upload Integration Types
+ *
+ * Core types for backend-first upload integration.
+ */
+/** Upload result with URL and key for reference/deletion. */
+interface BitUploadResult<TMetadata extends Record<string, unknown> = Record<string, unknown>> {
+    url: string;
+    key: string;
+    metadata?: TMetadata;
+}
+/** Upload function contract (backend-first). All context is managed by the caller. */
+type BitUploadFn<TMetadata extends Record<string, unknown> = Record<string, unknown>> = (file: File) => Promise<BitUploadResult<TMetadata>>;
+/** Optional delete function contract. */
+type BitDeleteUploadFn = (key: string) => Promise<void>;
+/** Canonical value used by upload bindings across frameworks. */
+type BitUploadValue = string | File | null;
+/** Input accepted by upload handlers. */
+type BitUploadInput = File | null | undefined;
+/**
+ * Base upload contract for framework adapters.
+ * Frameworks specialize `value`, `error`, and `isValidating` with their reactive wrappers.
+ */
+interface BitUploadAdapterResult<TValue, TError, TIsValidating> {
+    value: TValue;
+    setValue: (value: BitUploadValue) => void;
+    error: TError;
+    isValidating: TIsValidating;
+    upload: (file: BitUploadInput) => Promise<void>;
+    remove: () => Promise<void>;
+}
+
+export type { BitArrayBinding as B, BitArrayBindingField as a, BitDeleteUploadFn as b, BitHistoryAdapterResult as c, BitPersistAdapterResult as d, BitStepsAdapterResult as e, BitUploadAdapterResult as f, BitUploadFn as g, BitUploadInput as h, BitUploadResult as i, BitUploadValue as j };

package/dist/{use-bit-persist-BDMZmxBh.d.ts → use-bit-persist-Bd1H2fge.d.ts}

@@ -1,11 +1,12 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { b as BitFrameworkStoreApi, e as BitStoreApi } from './store-api-types-DfTFy2h4.js';
-import './bus-BKuMV3E7.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-CRCP4Pgq.js';
-import { a as BitArrayBindingField } from './array-controller-C61ByyG6.js';
-import { a as BitHistoryMetadata, b as BitValidationOptions } from './meta-types-Bzmm21TP.js';
-import { B as BitFieldInputEvent } from './field-binding-MX6jVQbT.js';
+import { b as BitFrameworkStoreApi, e as BitStoreApi } from './store-api-types-Bozwlwyb.js';
+import './bus-BFOBGmd9.js';
+import { d as BitPath, e as BitPathValue, f as BitPersistMetadata, b as BitErrors, h as BitTouched, D as DeepPartial, a as BitArrayPath, B as BitArrayItem } from './state-types-8bUndWfg.js';
+import { c as BitHistoryAdapterResult, d as BitPersistAdapterResult, e as BitStepsAdapterResult, f as BitUploadAdapterResult, a as BitArrayBindingField } from './upload-ao6skK9K.js';
+import { S as ScopeStatus, V as ValidateScopeResult } from './runtime-types-D1SRZr-n.js';
+import { a as BitHistoryMetadata, b as BitValidationOptions } from './meta-types-BC1VLABk.js';
+import { B as BitFieldInputEvent } from './field-binding-Bi1g-D8X.js';
 
 declare const BitFormProvider: ({ store, children, }: {
     store: BitFrameworkStoreApi<any> | BitStoreApi<any>;
@@ -52,52 +53,18 @@ interface UseBitFieldResult<TForm extends object = any, P extends BitPath<TForm>
  * Result from useBitSteps hook.
  * Provides multi-step form navigation and validation.
  */
-interface UseBitStepsResult {
-    step: number;
-    stepIndex: number;
-    scope: string;
-    next: () => Promise<boolean>;
-    prev: () => void;
-    goTo: (step: number) => void;
-    isFirst: boolean;
-    isLast: boolean;
-    status: ScopeStatus;
-    errors: Record<string, string>;
-    isValid: boolean;
-    isDirty: boolean;
-    validate: () => Promise<ValidateScopeResult>;
-    getErrors: () => Record<string, string>;
-}
+type UseBitStepsResult = BitStepsAdapterResult<number, number, string, boolean, ScopeStatus, Record<string, string>, ValidateScopeResult>;
 /**
  * Result from useBitUpload hook.
  * Provides file upload functionality with integrated validation.
  */
-interface UseBitUploadResult {
-    value: string | File | null;
-    setValue: (value: string | File | null) => void;
-    error?: string;
-    isValidating: boolean;
-    upload: (file: File | null | undefined) => Promise<void>;
-    remove: () => Promise<void>;
-}
+type UseBitUploadResult = BitUploadAdapterResult<string | File | null, string | undefined, boolean>;
 /**
  * Result from useBitHistory hook.
  * Provides form history undo/redo capabilities.
  */
-interface UseBitHistoryResult {
-    canUndo: BitHistoryMetadata["canUndo"];
-    canRedo: BitHistoryMetadata["canRedo"];
-    historyIndex: BitHistoryMetadata["historyIndex"];
-    historySize: BitHistoryMetadata["historySize"];
-    undo: () => void;
-    redo: () => void;
-}
-interface UseBitPersistResult {
-    restore: () => Promise<boolean>;
-    save: () => Promise<void>;
-    clear: () => Promise<void>;
-    meta: BitPersistMetadata;
-}
+type UseBitHistoryResult = BitHistoryAdapterResult<BitHistoryMetadata["canUndo"], BitHistoryMetadata["canRedo"], BitHistoryMetadata["historyIndex"], BitHistoryMetadata["historySize"]>;
+type UseBitPersistResult = BitPersistAdapterResult<BitPersistMetadata>;
 interface UseBitFormMeta {
     isValid: boolean;
     isDirty: boolean;
@@ -111,7 +78,7 @@ interface UseBitFormResult<T extends object = any> {
     getErrors: () => BitErrors<T>;
     getTouched: () => BitTouched<T>;
     getDirtyValues: () => Partial<T>;
-    submit: (onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>) => (e?: {
+    submit: (onSuccess: (values: T, dirtyValues?: Partial<T>) => unknown | Promise<unknown>) => (e?: {
         preventDefault: () => void;
     }) => Promise<void>;
     onSubmit: (handler: (values: T, dirtyValues?: Partial<T>) => Promise<unknown>) => (e?: {