@lehnihon/bit-form 2.2.1 → 2.2.3

package/dist/index.d.ts

@@ -1,9 +1,174 @@
-import { B as BitConfig, P as PatternMaskOptions, a as BitMask, C as CurrencyMaskConfig, D as DateMaskConfig } from './bus-B3pGaiFZ.js';
-export { b as BitAfterSubmitEvent, c as BitAfterValidateEvent, d as BitArrayItem, e as BitArrayPath, f as BitBeforeSubmitEvent, g as BitBeforeValidateEvent, h as BitComputedFn, i as BitErrors, j as BitFieldChangeEvent, k as BitFieldChangeMeta, l as BitFieldConditional, m as BitFieldDefinition, n as BitFieldState, o as BitFieldValidation, p as BitHistoryConfig, q as BitPath, r as BitPathValue, s as BitPersistConfig, t as BitPersistMode, u as BitPersistStorageAdapter, v as BitPlugin, w as BitPluginContext, x as BitPluginErrorEvent, y as BitPluginHooks, z as BitState, A as BitTouched, E as BitTransformFn, F as BitValidationConfig, G as DeepPartial, S as ScopeStatus, V as ValidateScopeResult, H as ValidatorFn, I as bitBus } from './bus-B3pGaiFZ.js';
-import { B as BitStoreApi } from './public-types-Lq3eLstW.js';
-export { a as BitEqualityFn, b as BitFrameworkConfig, c as BitFrameworkStore, d as BitHistoryMetadata, e as BitPersistMetadata, f as BitPublicStore, g as BitSelector, h as BitSelectorSubscriptionOptions, i as BitValidationOptions } from './public-types-Lq3eLstW.js';
+import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.js';
+import { B as BitState, a as BitTransformFn, b as BitFieldChangeEvent, c as BitBeforeSubmitEvent, d as BitAfterSubmitEvent, e as BitFieldDefinition, f as BitErrors, g as BitBeforeValidateEvent, h as BitAfterValidateEvent, i as BitConfig, j as BitComputedFn, k as BitPath, l as BitFieldState, m as BitPathValue, n as BitFieldChangeMeta, D as DeepPartial, o as BitArrayPath, p as BitArrayItem } from './bus-DHQHDwUp.js';
+export { q as BitFieldConditional, r as BitFieldValidation, s as BitHistoryConfig, t as BitPersistConfig, u as BitPersistMode, v as BitPersistStorageAdapter, w as BitPlugin, x as BitPluginContext, y as BitPluginErrorEvent, z as BitPluginHooks, A as BitTouched, C as BitValidationConfig, S as ScopeStatus, V as ValidateScopeResult, E as ValidatorFn, F as bitBus } from './bus-DHQHDwUp.js';
+import { B as BitResolvedConfig, a as BitValidationOptions, b as BitSelector, c as BitSelectorSubscriptionOptions, d as BitHistoryMetadata, e as BitStoreApi, f as BitStoreHooksApi } from './public-types-Bgws0aVJ.js';
+export { g as BitEqualityFn, h as BitFrameworkConfig, i as BitPersistMetadata } from './public-types-Bgws0aVJ.js';
 export { B as BitDeleteUploadFn, a as BitUploadFn, b as BitUploadResult } from './types-C2mpfhp1.js';
 
+interface BitLifecycleStorePort<T extends object> {
+    getState: () => BitState<T>;
+    internalUpdateState: (partial: Partial<BitState<T>>, changedPaths?: string[]) => void;
+    internalSaveSnapshot: () => void;
+    getTransformEntries: () => [string, BitTransformFn<T>][];
+    config: BitResolvedConfig<T>;
+    updateDependencies: (changedPath: string, newValues: T) => string[];
+    isFieldHidden: (path: string) => boolean;
+    evaluateAllDependencies: (values: T) => void;
+    getHiddenFields: () => string[];
+    clearFieldValidation: (path: string) => void;
+    triggerValidation: (scopeFields?: string[]) => void;
+    handleFieldAsyncValidation: (path: string, value: any) => void;
+    cancelAllValidations: () => void;
+    validateNow: (options?: BitValidationOptions) => Promise<boolean>;
+    hasValidationsInProgress: (scopeFields?: string[]) => boolean;
+    updateDirtyForPath: (path: string, nextValues: T, baselineValues: T) => boolean;
+    rebuildDirtyState: (nextValues: T, baselineValues: T) => boolean;
+    clearDirtyState: () => void;
+    buildDirtyValues: (values: T) => Partial<T>;
+    resetHistory: (initialValues: T) => void;
+    emitFieldChange: (event: BitFieldChangeEvent<T>) => void;
+    emitBeforeSubmit: (event: BitBeforeSubmitEvent<T>) => Promise<void>;
+    emitAfterSubmit: (event: BitAfterSubmitEvent<T>) => Promise<void>;
+    emitOperationalError: (event: {
+        source: "submit";
+        error: unknown;
+        payload?: unknown;
+    }) => Promise<void>;
+}
+
+interface BitValidationStorePort<T extends object> {
+    getState: () => BitState<T>;
+    internalUpdateState: (partial: Partial<BitState<T>>) => void;
+    setError: (path: string, message: string | undefined) => void;
+    validate: (opts: BitValidationOptions) => Promise<boolean>;
+    getFieldConfig: (path: string) => BitFieldDefinition<T> | undefined;
+    getScopeFields: (scopeName: string) => string[];
+    config: BitResolvedConfig<T>;
+    getRequiredErrors: (values: T) => BitErrors<T>;
+    getHiddenFields: () => string[];
+    emitBeforeValidate: (event: BitBeforeValidateEvent<T>) => Promise<void>;
+    emitAfterValidate: (event: BitAfterValidateEvent<T>) => Promise<void>;
+}
+
+/**
+ * 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> implements BitValidationStorePort<T>, BitLifecycleStorePort<T> {
+    private state;
+    private readonly subscriptions;
+    private readonly effects;
+    private readonly capabilities;
+    config: BitResolvedConfig<T>;
+    storeId: string;
+    private readonly depsMg;
+    private readonly computedMg;
+    private readonly dirtyMg;
+    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(): BitResolvedConfig<T>;
+    getFieldConfig(path: string): BitFieldDefinition<T> | undefined;
+    getScopeFields(scopeName: string): string[];
+    getComputedEntries(): [string, BitComputedFn<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<P extends BitPath<T>>(path: P): 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;
+    submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<void>;
+    registerMask(name: BitMaskName, mask: BitMask): void;
+    getDirtyValues(): Partial<T>;
+    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[]): 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(): 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>;
+    resetHistory(initialValues: T): void;
+    internalUpdateState(partialState: Partial<BitState<T>>, changedPaths?: string[]): void;
+    internalSaveSnapshot(): void;
+    private applyPersistedValues;
+    cleanup(): void;
+}
+
+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 deepClone<T>(obj: T): T;
@@ -27,98 +192,4 @@ declare function isValidationErrorShape(x: unknown): x is Record<string, string
  */
 declare function extractServerErrors(x: unknown): Record<string, string | string[]>;
 
-declare const unmask: (value: string | number | null | undefined, allowChars?: string) => string;
-declare const unmaskCurrency: (value: any, precision?: number) => number;
-declare const createPatternMask: (pattern: string | string[], options?: PatternMaskOptions) => BitMask;
-declare const createCurrencyMask: ({ prefix, suffix, thousand, decimal, precision, allowNegative, saveRaw, }: CurrencyMaskConfig) => BitMask;
-declare const createCreditCardMask: (options?: PatternMaskOptions) => BitMask;
-declare const createDateMask: (config?: DateMaskConfig) => BitMask;
-
-/** BRL - Real Brasileiro (R$ 1.000,00) */
-declare const maskBRL: BitMask;
-/** USD - Dólar Americano ($1,000.00) */
-declare const maskUSD: BitMask;
-/** EUR - Euro Padrão (€ 1.000,00) - Sufixo comum na Europa */
-declare const maskEUR: BitMask;
-/** GBP - Libra Esterlina (£1,000.00) */
-declare const maskGBP: BitMask;
-/** JPY - Iene Japonês (¥1,000) - Geralmente sem decimais */
-declare const maskJPY: BitMask;
-/** Porcentagem PT-BR (10,5%) */
-declare const maskPercent: BitMask;
-/** Decimal Genérico PT-BR (1.000,00) - Sem símbolo */
-declare const maskDecimal: BitMask;
-/** Inteiro (1.000) - Apenas separador de milhar */
-declare const maskInteger: BitMask;
-/** CPF (000.000.000-00) */
-declare const maskCPF: BitMask;
-/** CNPJ (00.000.000/0000-00) */
-declare const maskCNPJ: BitMask;
-declare const maskPhone: BitMask;
-/** Telefone Fixo BR (11) 0000-0000 */
-declare const maskLandline: BitMask;
-/** CEP (00000-000) */
-declare const maskCEP: BitMask;
-/** Data PT/BR com correção automática de dia/mês */
-declare const maskDate: BitMask;
-/** Hora Curta (HH:MM) */
-declare const maskTime: BitMask;
-/** CNH (Carteira de Motorista - 11 dígitos) */
-declare const maskCNH: BitMask;
-/** RG (00.000.000-X) - Suporta o 'X' como dígito verificador */
-declare const maskRG: BitMask;
-/** US Phone ((000) 000-0000) */
-declare const maskUSPhone: BitMask;
-/** ZIP Code (00000 or 00000-0000) */
-declare const maskZipCode: BitMask;
-/** Date US (MM/DD/YYYY) - Igual ao BR, mas semântica diferente */
-declare const maskDateUS: BitMask;
-/** SSN (Social Security Number) */
-declare const maskSSN: BitMask;
-/** Cartão de Crédito Inteligente (Detecta Visa/Master, Amex e Diners) */
-declare const maskCreditCard: BitMask;
-/** CVV (3 ou 4 dígitos) */
-declare const maskCVV: BitMask;
-/** Data ISO (Ideal para base de dados: YYYY-MM-DD) */
-declare const maskDateISO: BitMask;
-/** Endereço MAC (HH:HH:HH:HH:HH:HH) - Usa o token Hexadecimal */
-declare const maskMacAddress: BitMask;
-/** Cor Hexadecimal (#HHHHHH) */
-declare const maskColorHex: BitMask;
-/** IPv4 (000.000.000.000) - Formato de blocos fixos */
-declare const maskIPv4: BitMask;
-/** IPv6 (HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH) */
-declare const maskIPv6: BitMask;
-/** * IBAN Internacional
- * Força as duas primeiras letras para maiúsculas e agrupa de 4 em 4.
- * O tamanho máximo cobre os 34 caracteres do padrão IBAN.
- */
-declare const maskIBAN: BitMask;
-
-declare const bitMasks: {
-    brl: BitMask;
-    usd: BitMask;
-    eur: BitMask;
-    gbp: BitMask;
-    jpy: BitMask;
-    cpf: BitMask;
-    cnpj: BitMask;
-    rg: BitMask;
-    cep: BitMask;
-    cnh: BitMask;
-    phone: BitMask;
-    landline: BitMask;
-    date: BitMask;
-    time: BitMask;
-    ip: BitMask;
-    ipv6: BitMask;
-    mac: BitMask;
-    color: BitMask;
-    cc: BitMask;
-    cvv: BitMask;
-    percent: BitMask;
-    decimal: BitMask;
-    int: BitMask;
-};
-
-export { BitConfig, BitMask, BitStoreApi, CurrencyMaskConfig, DateMaskConfig, PatternMaskOptions, bitMasks, cleanPrefixedKeys, createBitStore, createCreditCardMask, createCurrencyMask, createDateMask, createPatternMask, deepClone, deepEqual, deepMerge, extractServerErrors, getDeepValue, isValidationErrorShape, maskBRL, maskCEP, maskCNH, maskCNPJ, maskCPF, maskCVV, maskColorHex, maskCreditCard, maskDate, maskDateISO, maskDateUS, maskDecimal, maskEUR, maskGBP, maskIBAN, maskIPv4, maskIPv6, maskInteger, maskJPY, maskLandline, maskMacAddress, maskPercent, maskPhone, maskRG, maskSSN, maskTime, maskUSD, maskUSPhone, maskZipCode, setDeepValue, unmask, unmaskCurrency, valueEqual };
+export { BitAfterSubmitEvent, BitAfterValidateEvent, BitArrayItem, BitArrayPath, BitBeforeSubmitEvent, BitBeforeValidateEvent, BitComputedFn, BitConfig, BitErrors, BitFieldChangeEvent, BitFieldChangeMeta, BitFieldDefinition, BitFieldState, BitHistoryMetadata, BitPath, BitPathValue, BitSelector, BitSelectorSubscriptionOptions, BitState, BitStore, BitStoreApi, BitStoreHooksApi, BitTransformFn, BitValidationOptions, DeepPartial, cleanPrefixedKeys, createBitStore, deepClone, deepEqual, deepMerge, extractServerErrors, getDeepValue, isValidationErrorShape, resolveBitStoreForHooks, setDeepValue, valueEqual };

package/dist/index.js

@@ -1,2 +1,2 @@
-import{A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,W as U,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,m as g,n as h,o as i,p as j,q as k,r as l,s as n,t as q,u as s,v as u,w as v,x as w,y,z}from"./chunk-6FJEE6O3.js";export{o as bitBus,T as bitMasks,x as cleanPrefixedKeys,U as createBitStore,i as createCreditCardMask,h as createCurrencyMask,j as createDateMask,g as createPatternMask,r as deepClone,m as deepEqual,e as deepMerge,b as extractServerErrors,p as getDeepValue,a as isValidationErrorShape,k as maskBRL,C as maskCEP,F as maskCNH,z as maskCNPJ,y as maskCPF,M as maskCVV,P as maskColorHex,L as maskCreditCard,D as maskDate,N as maskDateISO,J as maskDateUS,v as maskDecimal,n as maskEUR,q as maskGBP,S as maskIBAN,Q as maskIPv4,R as maskIPv6,w as maskInteger,s as maskJPY,B as maskLandline,O as maskMacAddress,u as maskPercent,A as maskPhone,G as maskRG,K as maskSSN,E as maskTime,l as maskUSD,H as maskUSPhone,I as maskZipCode,t as setDeepValue,c as unmask,d as unmaskCurrency,f as valueEqual};
+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,m as g}from"./chunk-ULC4OPIQ.js";import"./chunk-VDWCFNA6.js";export{c as BitStore,b as bitBus,t as cleanPrefixedKeys,g as createBitStore,o as deepClone,f as deepEqual,r as deepMerge,a as extractServerErrors,m as getDeepValue,x as isValidationErrorShape,d as resolveBitStoreForHooks,p as setDeepValue,e as valueEqual};
 //# sourceMappingURL=index.js.map

package/dist/mask.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkPA6T2CBRcjs = require('./chunk-PA6T2CBR.cjs');exports.bitMasks = _chunkPA6T2CBRcjs.N; exports.createCreditCardMask = _chunkPA6T2CBRcjs.e; exports.createCurrencyMask = _chunkPA6T2CBRcjs.d; exports.createDateMask = _chunkPA6T2CBRcjs.f; exports.createPatternMask = _chunkPA6T2CBRcjs.c; exports.maskBRL = _chunkPA6T2CBRcjs.g; exports.maskCEP = _chunkPA6T2CBRcjs.s; exports.maskCNH = _chunkPA6T2CBRcjs.v; exports.maskCNPJ = _chunkPA6T2CBRcjs.p; exports.maskCPF = _chunkPA6T2CBRcjs.o; exports.maskCPFCNPJ = _chunkPA6T2CBRcjs.x; exports.maskCVV = _chunkPA6T2CBRcjs.E; exports.maskColorHex = _chunkPA6T2CBRcjs.H; exports.maskCreditCard = _chunkPA6T2CBRcjs.D; exports.maskDate = _chunkPA6T2CBRcjs.t; exports.maskDateISO = _chunkPA6T2CBRcjs.F; exports.maskDateUS = _chunkPA6T2CBRcjs.B; exports.maskDecimal = _chunkPA6T2CBRcjs.m; exports.maskEUR = _chunkPA6T2CBRcjs.i; exports.maskGBP = _chunkPA6T2CBRcjs.j; exports.maskIBAN = _chunkPA6T2CBRcjs.K; exports.maskIPv4 = _chunkPA6T2CBRcjs.I; exports.maskIPv6 = _chunkPA6T2CBRcjs.J; exports.maskInteger = _chunkPA6T2CBRcjs.n; exports.maskJPY = _chunkPA6T2CBRcjs.k; exports.maskLandline = _chunkPA6T2CBRcjs.r; exports.maskMacAddress = _chunkPA6T2CBRcjs.G; exports.maskPercent = _chunkPA6T2CBRcjs.l; exports.maskPhone = _chunkPA6T2CBRcjs.q; exports.maskPlate = _chunkPA6T2CBRcjs.y; exports.maskRG = _chunkPA6T2CBRcjs.w; exports.maskSSN = _chunkPA6T2CBRcjs.C; exports.maskTime = _chunkPA6T2CBRcjs.u; exports.maskUSD = _chunkPA6T2CBRcjs.h; exports.maskUSPhone = _chunkPA6T2CBRcjs.z; exports.maskZipCode = _chunkPA6T2CBRcjs.A; exports.unmask = _chunkPA6T2CBRcjs.a; exports.unmaskCurrency = _chunkPA6T2CBRcjs.b;
+//# sourceMappingURL=mask.cjs.map

package/dist/mask.cjs.map

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

package/dist/mask.d.cts

@@ -0,0 +1,86 @@
+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';
+
+declare const unmask: (value: string | number | null | undefined, allowChars?: string) => string;
+declare const unmaskCurrency: (value: any, precision?: number) => number;
+declare const createPatternMask: (pattern: string | string[], options?: PatternMaskOptions) => BitMask;
+declare const createCurrencyMask: ({ prefix, suffix, thousand, decimal, precision, allowNegative, saveRaw, }: CurrencyMaskConfig) => BitMask;
+declare const createCreditCardMask: (options?: PatternMaskOptions) => BitMask;
+declare const createDateMask: (config?: DateMaskConfig) => BitMask;
+
+/** BRL - Real Brasileiro (R$ 1.000,00) */
+declare const maskBRL: BitMask;
+/** USD - Dólar Americano ($1,000.00) */
+declare const maskUSD: BitMask;
+/** EUR - Euro Padrão (€ 1.000,00) - Sufixo comum na Europa */
+declare const maskEUR: BitMask;
+/** GBP - Libra Esterlina (£1,000.00) */
+declare const maskGBP: BitMask;
+/** JPY - Iene Japonês (¥1,000) - Geralmente sem decimais */
+declare const maskJPY: BitMask;
+/** Porcentagem PT-BR (10,5%) */
+declare const maskPercent: BitMask;
+/** Decimal Genérico PT-BR (1.000,00) - Sem símbolo */
+declare const maskDecimal: BitMask;
+/** Inteiro (1.000) - Apenas separador de milhar */
+declare const maskInteger: BitMask;
+/** CPF (000.000.000-00) */
+declare const maskCPF: BitMask;
+/** CNPJ (00.000.000/0000-00) */
+declare const maskCNPJ: BitMask;
+declare const maskPhone: BitMask;
+/** Telefone Fixo BR (11) 0000-0000 */
+declare const maskLandline: BitMask;
+/** CEP (00000-000) */
+declare const maskCEP: BitMask;
+/** Data PT/BR com correção automática de dia/mês */
+declare const maskDate: BitMask;
+/** Hora Curta (HH:MM) */
+declare const maskTime: BitMask;
+/** CNH (Carteira de Motorista - 11 dígitos) */
+declare const maskCNH: BitMask;
+/** RG (00.000.000-X) - Suporta o 'X' como dígito verificador */
+declare const maskRG: BitMask;
+/**
+ * CPF + CNPJ combinado — alterna automaticamente pelo número de dígitos:
+ * - Até 11 dígitos → CPF  (000.000.000-00)
+ * - Mais de 11     → CNPJ (00.000.000/0000-00)
+ */
+declare const maskCPFCNPJ: BitMask;
+/**
+ * Placa de veículo BR — detecta o formato pelo 5.º caractere:
+ * - Antigo   → ABC-1234 (posição 5 é dígito)
+ * - Mercosul → ABC1D23  (posição 5 é letra)
+ */
+declare const maskPlate: BitMask;
+/** US Phone ((000) 000-0000) */
+declare const maskUSPhone: BitMask;
+/** ZIP Code (00000 or 00000-0000) */
+declare const maskZipCode: BitMask;
+/** Date US (MM/DD/YYYY) - Igual ao BR, mas semântica diferente */
+declare const maskDateUS: BitMask;
+/** SSN (Social Security Number) */
+declare const maskSSN: BitMask;
+/** Cartão de Crédito Inteligente (Detecta Visa/Master, Amex e Diners) */
+declare const maskCreditCard: BitMask;
+/** CVV (3 ou 4 dígitos) */
+declare const maskCVV: BitMask;
+/** Data ISO (Ideal para base de dados: YYYY-MM-DD) */
+declare const maskDateISO: BitMask;
+/** Endereço MAC (HH:HH:HH:HH:HH:HH) - Usa o token Hexadecimal */
+declare const maskMacAddress: BitMask;
+/** Cor Hexadecimal (#HHHHHH) */
+declare const maskColorHex: BitMask;
+/** IPv4 (000.000.000.000) - Formato de blocos fixos */
+declare const maskIPv4: BitMask;
+/** IPv6 (HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH) */
+declare const maskIPv6: BitMask;
+/** * IBAN Internacional
+ * Força as duas primeiras letras para maiúsculas e agrupa de 4 em 4.
+ * O tamanho máximo cobre os 34 caracteres do padrão IBAN.
+ */
+declare const maskIBAN: BitMask;
+
+declare const bitMasks: Record<BitBuiltInMaskName, BitMask>;
+
+export { BitBuiltInMaskName, BitMask, CurrencyMaskConfig, DateMaskConfig, PatternMaskOptions, bitMasks, createCreditCardMask, createCurrencyMask, createDateMask, createPatternMask, maskBRL, maskCEP, maskCNH, maskCNPJ, maskCPF, maskCPFCNPJ, maskCVV, maskColorHex, maskCreditCard, maskDate, maskDateISO, maskDateUS, maskDecimal, maskEUR, maskGBP, maskIBAN, maskIPv4, maskIPv6, maskInteger, maskJPY, maskLandline, maskMacAddress, maskPercent, maskPhone, maskPlate, maskRG, maskSSN, maskTime, maskUSD, maskUSPhone, maskZipCode, unmask, unmaskCurrency };

package/dist/mask.d.ts

@@ -0,0 +1,86 @@
+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';
+
+declare const unmask: (value: string | number | null | undefined, allowChars?: string) => string;
+declare const unmaskCurrency: (value: any, precision?: number) => number;
+declare const createPatternMask: (pattern: string | string[], options?: PatternMaskOptions) => BitMask;
+declare const createCurrencyMask: ({ prefix, suffix, thousand, decimal, precision, allowNegative, saveRaw, }: CurrencyMaskConfig) => BitMask;
+declare const createCreditCardMask: (options?: PatternMaskOptions) => BitMask;
+declare const createDateMask: (config?: DateMaskConfig) => BitMask;
+
+/** BRL - Real Brasileiro (R$ 1.000,00) */
+declare const maskBRL: BitMask;
+/** USD - Dólar Americano ($1,000.00) */
+declare const maskUSD: BitMask;
+/** EUR - Euro Padrão (€ 1.000,00) - Sufixo comum na Europa */
+declare const maskEUR: BitMask;
+/** GBP - Libra Esterlina (£1,000.00) */
+declare const maskGBP: BitMask;
+/** JPY - Iene Japonês (¥1,000) - Geralmente sem decimais */
+declare const maskJPY: BitMask;
+/** Porcentagem PT-BR (10,5%) */
+declare const maskPercent: BitMask;
+/** Decimal Genérico PT-BR (1.000,00) - Sem símbolo */
+declare const maskDecimal: BitMask;
+/** Inteiro (1.000) - Apenas separador de milhar */
+declare const maskInteger: BitMask;
+/** CPF (000.000.000-00) */
+declare const maskCPF: BitMask;
+/** CNPJ (00.000.000/0000-00) */
+declare const maskCNPJ: BitMask;
+declare const maskPhone: BitMask;
+/** Telefone Fixo BR (11) 0000-0000 */
+declare const maskLandline: BitMask;
+/** CEP (00000-000) */
+declare const maskCEP: BitMask;
+/** Data PT/BR com correção automática de dia/mês */
+declare const maskDate: BitMask;
+/** Hora Curta (HH:MM) */
+declare const maskTime: BitMask;
+/** CNH (Carteira de Motorista - 11 dígitos) */
+declare const maskCNH: BitMask;
+/** RG (00.000.000-X) - Suporta o 'X' como dígito verificador */
+declare const maskRG: BitMask;
+/**
+ * CPF + CNPJ combinado — alterna automaticamente pelo número de dígitos:
+ * - Até 11 dígitos → CPF  (000.000.000-00)
+ * - Mais de 11     → CNPJ (00.000.000/0000-00)
+ */
+declare const maskCPFCNPJ: BitMask;
+/**
+ * Placa de veículo BR — detecta o formato pelo 5.º caractere:
+ * - Antigo   → ABC-1234 (posição 5 é dígito)
+ * - Mercosul → ABC1D23  (posição 5 é letra)
+ */
+declare const maskPlate: BitMask;
+/** US Phone ((000) 000-0000) */
+declare const maskUSPhone: BitMask;
+/** ZIP Code (00000 or 00000-0000) */
+declare const maskZipCode: BitMask;
+/** Date US (MM/DD/YYYY) - Igual ao BR, mas semântica diferente */
+declare const maskDateUS: BitMask;
+/** SSN (Social Security Number) */
+declare const maskSSN: BitMask;
+/** Cartão de Crédito Inteligente (Detecta Visa/Master, Amex e Diners) */
+declare const maskCreditCard: BitMask;
+/** CVV (3 ou 4 dígitos) */
+declare const maskCVV: BitMask;
+/** Data ISO (Ideal para base de dados: YYYY-MM-DD) */
+declare const maskDateISO: BitMask;
+/** Endereço MAC (HH:HH:HH:HH:HH:HH) - Usa o token Hexadecimal */
+declare const maskMacAddress: BitMask;
+/** Cor Hexadecimal (#HHHHHH) */
+declare const maskColorHex: BitMask;
+/** IPv4 (000.000.000.000) - Formato de blocos fixos */
+declare const maskIPv4: BitMask;
+/** IPv6 (HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH:HHHH) */
+declare const maskIPv6: BitMask;
+/** * IBAN Internacional
+ * Força as duas primeiras letras para maiúsculas e agrupa de 4 em 4.
+ * O tamanho máximo cobre os 34 caracteres do padrão IBAN.
+ */
+declare const maskIBAN: BitMask;
+
+declare const bitMasks: Record<BitBuiltInMaskName, BitMask>;
+
+export { BitBuiltInMaskName, BitMask, CurrencyMaskConfig, DateMaskConfig, PatternMaskOptions, bitMasks, createCreditCardMask, createCurrencyMask, createDateMask, createPatternMask, maskBRL, maskCEP, maskCNH, maskCNPJ, maskCPF, maskCPFCNPJ, maskCVV, maskColorHex, maskCreditCard, maskDate, maskDateISO, maskDateUS, maskDecimal, maskEUR, maskGBP, maskIBAN, maskIPv4, maskIPv6, maskInteger, maskJPY, maskLandline, maskMacAddress, maskPercent, maskPhone, maskPlate, maskRG, maskSSN, maskTime, maskUSD, maskUSPhone, maskZipCode, unmask, unmaskCurrency };

package/dist/mask.js

@@ -0,0 +1,2 @@
+import{A as U,B as g,C as J,D as R,E as h,F as v,G as A,H as E,I as F,J as G,K as H,N as L,a,b as s,c as k,d as e,e as m,f as t,g as r,h as C,i as n,j as o,k as P,l as i,m as M,n as c,o as d,p,q as B,r as D,s as N,t as f,u,v as I,w as S,x as l,y as x,z as y}from"./chunk-VDWCFNA6.js";export{L as bitMasks,m as createCreditCardMask,e as createCurrencyMask,t as createDateMask,k as createPatternMask,r as maskBRL,N as maskCEP,I as maskCNH,p as maskCNPJ,d as maskCPF,l as maskCPFCNPJ,h as maskCVV,E as maskColorHex,R as maskCreditCard,f as maskDate,v as maskDateISO,g as maskDateUS,M as maskDecimal,n as maskEUR,o as maskGBP,H as maskIBAN,F as maskIPv4,G as maskIPv6,c as maskInteger,P as maskJPY,D as maskLandline,A as maskMacAddress,i as maskPercent,B as maskPhone,x as maskPlate,S as maskRG,J as maskSSN,u as maskTime,C as maskUSD,y as maskUSPhone,U as maskZipCode,a as unmask,s as unmaskCurrency};
+//# sourceMappingURL=mask.js.map

package/dist/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{public-types-Lq3eLstW.d.ts → public-types-Bgws0aVJ.d.ts}

@@ -1,10 +1,13 @@
-import { B as BitConfig, H as ValidatorFn, a as BitMask, m as BitFieldDefinition, J as DevToolsOptions, K as BitPersistResolvedConfig, v as BitPlugin, z as BitState, q as BitPath, n as BitFieldState, r as BitPathValue, G as DeepPartial, i as BitErrors, e as BitArrayPath, d as BitArrayItem, S as ScopeStatus } from './bus-B3pGaiFZ.js';
+import { i as BitConfig, E as ValidatorFn, e as BitFieldDefinition, G as DevToolsOptions, H as BitPersistResolvedConfig, w as BitPlugin, B as BitState, k as BitPath, m as BitPathValue, D as DeepPartial, f as BitErrors, o as BitArrayPath, p as BitArrayItem, S as ScopeStatus, l as BitFieldState } from './bus-DHQHDwUp.js';
+import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.js';
 
 type BitSelector<T extends object, TSlice> = (state: Readonly<BitState<T>>) => TSlice;
 type BitEqualityFn<TValue> = (previous: TValue, next: TValue) => boolean;
 interface BitSelectorSubscriptionOptions<TValue> {
     equalityFn?: BitEqualityFn<TValue>;
     emitImmediately?: boolean;
+    paths?: string[];
+    autoTrackPaths?: boolean;
 }
 interface BitValidationOptions {
     scope?: string;
@@ -34,28 +37,25 @@ interface BitFrameworkConfig<T extends object = any> extends BitConfig<T> {
     persist: BitPersistResolvedConfig<T>;
     plugins: BitPlugin<T>[];
 }
+interface BitResolvedConfig<T extends object = any> extends BitFrameworkConfig<T> {
+}
 interface BitStoreApi<T extends object = any> {
     readonly config: Readonly<BitFrameworkConfig<T>>;
     getConfig(): Readonly<BitFrameworkConfig<T>>;
     getState(): Readonly<BitState<T>>;
-    getFieldState<P extends BitPath<T>>(path: P): Readonly<BitFieldState<T, BitPathValue<T, P>>>;
     subscribe(listener: () => void): () => void;
-    subscribePath<P extends BitPath<T>>(path: P, listener: (value: BitPathValue<T, P>) => void, options?: BitSelectorSubscriptionOptions<BitPathValue<T, P>>): () => void;
-    subscribeSelector<TSlice>(selector: BitSelector<T, TSlice>, listener: (slice: TSlice) => void, options?: BitSelectorSubscriptionOptions<TSlice>): () => void;
     setField<P extends BitPath<T>>(path: P, value: BitPathValue<T, P>): void;
     blurField<P extends BitPath<T>>(path: P): void;
     replaceValues(values: T): void;
     hydrate(values: DeepPartial<T>): void;
     rebase(values: T): void;
-    /** @deprecated Use `rebase()` instead. This method is an alias and may be removed in a future version. */
-    setValues(values: T): void;
     setError(path: string, message: string | undefined): void;
     setErrors(errors: BitErrors<T>): void;
     setServerErrors(serverErrors: Record<string, string[] | string>): void;
     validate(options?: BitValidationOptions): Promise<boolean>;
     reset(): void;
     submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<void>;
-    registerMask(name: string, mask: BitMask): void;
+    registerMask(name: BitMaskName, mask: BitMask): void;
     getDirtyValues(): Partial<T>;
     restorePersisted(): Promise<boolean>;
     forceSave(): Promise<void>;
@@ -63,7 +63,6 @@ interface BitStoreApi<T extends object = any> {
     cleanup(): void;
     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;
@@ -80,20 +79,16 @@ interface BitStoreApi<T extends object = any> {
     redo(): void;
     getStepStatus(scopeName: string): ScopeStatus;
     getStepErrors(scopeName: string): Record<string, string>;
+}
+interface BitStoreHooksApi<T extends object = any> extends BitStoreApi<T> {
+    getFieldState<P extends BitPath<T>>(path: P): Readonly<BitFieldState<T, BitPathValue<T, P>>>;
+    subscribePath<P extends BitPath<T>>(path: P, listener: (value: BitPathValue<T, P>) => void, options?: BitSelectorSubscriptionOptions<BitPathValue<T, P>>): () => void;
+    subscribeSelector<TSlice>(selector: BitSelector<T, TSlice>, listener: (slice: TSlice) => void, options?: BitSelectorSubscriptionOptions<TSlice>): () => void;
+    unregisterPrefix?(prefix: string): void;
     markFieldsTouched(paths: string[]): void;
     hasValidationsInProgress(scopeFields?: string[]): boolean;
-    beginFieldValidation(path: string): void;
-    endFieldValidation(path: string): void;
-    setFieldAsyncError(path: string, message: string): Promise<void>;
-    clearFieldAsyncError(path: string): Promise<void>;
     resolveMask(path: string): BitMask | undefined;
     getScopeFields(scopeName: string): string[];
 }
-/** @deprecated Use `BitStoreApi` instead. */
-interface BitPublicStore<T extends object = any> extends BitStoreApi<T> {
-}
-/** @deprecated Use `BitStoreApi` instead. */
-interface BitFrameworkStore<T extends object = any> extends BitStoreApi<T> {
-}
 
-export type { BitStoreApi as B, BitEqualityFn as a, BitFrameworkConfig as b, BitFrameworkStore as c, BitHistoryMetadata as d, BitPersistMetadata as e, BitPublicStore as f, BitSelector as g, BitSelectorSubscriptionOptions as h, BitValidationOptions as i };
+export type { BitResolvedConfig as B, BitValidationOptions as a, BitSelector as b, BitSelectorSubscriptionOptions as c, BitHistoryMetadata as d, BitStoreApi as e, BitStoreHooksApi as f, BitEqualityFn as g, BitFrameworkConfig as h, BitPersistMetadata as i };

package/dist/{public-types-CtYuIAMP.d.cts → public-types-SU17BarA.d.cts}

@@ -1,10 +1,13 @@
-import { B as BitConfig, H as ValidatorFn, a as BitMask, m as BitFieldDefinition, J as DevToolsOptions, K as BitPersistResolvedConfig, v as BitPlugin, z as BitState, q as BitPath, n as BitFieldState, r as BitPathValue, G as DeepPartial, i as BitErrors, e as BitArrayPath, d as BitArrayItem, S as ScopeStatus } from './bus-B3pGaiFZ.cjs';
+import { i as BitConfig, E as ValidatorFn, e as BitFieldDefinition, G as DevToolsOptions, H as BitPersistResolvedConfig, w as BitPlugin, B as BitState, k as BitPath, m as BitPathValue, D as DeepPartial, f as BitErrors, o as BitArrayPath, p as BitArrayItem, S as ScopeStatus, l as BitFieldState } from './bus-CILR-ENq.cjs';
+import { B as BitMask, a as BitMaskName } from './types-D8DgIUhJ.cjs';
 
 type BitSelector<T extends object, TSlice> = (state: Readonly<BitState<T>>) => TSlice;
 type BitEqualityFn<TValue> = (previous: TValue, next: TValue) => boolean;
 interface BitSelectorSubscriptionOptions<TValue> {
     equalityFn?: BitEqualityFn<TValue>;
     emitImmediately?: boolean;
+    paths?: string[];
+    autoTrackPaths?: boolean;
 }
 interface BitValidationOptions {
     scope?: string;
@@ -34,28 +37,25 @@ interface BitFrameworkConfig<T extends object = any> extends BitConfig<T> {
     persist: BitPersistResolvedConfig<T>;
     plugins: BitPlugin<T>[];
 }
+interface BitResolvedConfig<T extends object = any> extends BitFrameworkConfig<T> {
+}
 interface BitStoreApi<T extends object = any> {
     readonly config: Readonly<BitFrameworkConfig<T>>;
     getConfig(): Readonly<BitFrameworkConfig<T>>;
     getState(): Readonly<BitState<T>>;
-    getFieldState<P extends BitPath<T>>(path: P): Readonly<BitFieldState<T, BitPathValue<T, P>>>;
     subscribe(listener: () => void): () => void;
-    subscribePath<P extends BitPath<T>>(path: P, listener: (value: BitPathValue<T, P>) => void, options?: BitSelectorSubscriptionOptions<BitPathValue<T, P>>): () => void;
-    subscribeSelector<TSlice>(selector: BitSelector<T, TSlice>, listener: (slice: TSlice) => void, options?: BitSelectorSubscriptionOptions<TSlice>): () => void;
     setField<P extends BitPath<T>>(path: P, value: BitPathValue<T, P>): void;
     blurField<P extends BitPath<T>>(path: P): void;
     replaceValues(values: T): void;
     hydrate(values: DeepPartial<T>): void;
     rebase(values: T): void;
-    /** @deprecated Use `rebase()` instead. This method is an alias and may be removed in a future version. */
-    setValues(values: T): void;
     setError(path: string, message: string | undefined): void;
     setErrors(errors: BitErrors<T>): void;
     setServerErrors(serverErrors: Record<string, string[] | string>): void;
     validate(options?: BitValidationOptions): Promise<boolean>;
     reset(): void;
     submit(onSuccess: (values: T, dirtyValues?: Partial<T>) => void | Promise<void>): Promise<void>;
-    registerMask(name: string, mask: BitMask): void;
+    registerMask(name: BitMaskName, mask: BitMask): void;
     getDirtyValues(): Partial<T>;
     restorePersisted(): Promise<boolean>;
     forceSave(): Promise<void>;
@@ -63,7 +63,6 @@ interface BitStoreApi<T extends object = any> {
     cleanup(): void;
     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;
@@ -80,20 +79,16 @@ interface BitStoreApi<T extends object = any> {
     redo(): void;
     getStepStatus(scopeName: string): ScopeStatus;
     getStepErrors(scopeName: string): Record<string, string>;
+}
+interface BitStoreHooksApi<T extends object = any> extends BitStoreApi<T> {
+    getFieldState<P extends BitPath<T>>(path: P): Readonly<BitFieldState<T, BitPathValue<T, P>>>;
+    subscribePath<P extends BitPath<T>>(path: P, listener: (value: BitPathValue<T, P>) => void, options?: BitSelectorSubscriptionOptions<BitPathValue<T, P>>): () => void;
+    subscribeSelector<TSlice>(selector: BitSelector<T, TSlice>, listener: (slice: TSlice) => void, options?: BitSelectorSubscriptionOptions<TSlice>): () => void;
+    unregisterPrefix?(prefix: string): void;
     markFieldsTouched(paths: string[]): void;
     hasValidationsInProgress(scopeFields?: string[]): boolean;
-    beginFieldValidation(path: string): void;
-    endFieldValidation(path: string): void;
-    setFieldAsyncError(path: string, message: string): Promise<void>;
-    clearFieldAsyncError(path: string): Promise<void>;
     resolveMask(path: string): BitMask | undefined;
     getScopeFields(scopeName: string): string[];
 }
-/** @deprecated Use `BitStoreApi` instead. */
-interface BitPublicStore<T extends object = any> extends BitStoreApi<T> {
-}
-/** @deprecated Use `BitStoreApi` instead. */
-interface BitFrameworkStore<T extends object = any> extends BitStoreApi<T> {
-}
 
-export type { BitStoreApi as B, BitEqualityFn as a, BitFrameworkConfig as b, BitFrameworkStore as c, BitHistoryMetadata as d, BitPersistMetadata as e, BitPublicStore as f, BitSelector as g, BitSelectorSubscriptionOptions as h, BitValidationOptions as i };
+export type { BitResolvedConfig as B, BitValidationOptions as a, BitSelector as b, BitSelectorSubscriptionOptions as c, BitHistoryMetadata as d, BitStoreApi as e, BitStoreHooksApi as f, BitEqualityFn as g, BitFrameworkConfig as h, BitPersistMetadata as i };