@desource/phone-mask-react 0.3.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @desource/phone-mask-react
 
+## 1.0.0
+
+### Major Changes
+
+- Core Upgrades:
+  - Refactored core architecture for better separation of concerns and reusability
+  - Added zero-config browser script support path
+  - Improved Intl.DisplayNames caching for performance
+  - Fixed various edge cases in formatting and event handling
+  - Added comprehensive unit tests for core utilities and handlers
+
+- React Upgrades:
+  - Major internal refactor to a controlled pattern with consistent hooks
+  - Improved React 18/19 compatibility for ref behavior
+  - Added and expanded unit/e2e tests for React components and behavior
+
+- Vue Upgrades:
+  - Refactored to align composable structure and reuse core utilities
+  - Fixed directive behavior for external value updates and dropdown close logic
+  - Added substantial unit/e2e test coverage for Vue composables and directive
+
+- 🚀 Svelte Upgrades:
+  - Introduced Svelte version of phone-mask library
+
+- Nuxt Upgrades:
+  - Added full test foundation with @nuxt/test-utils
+  - Added unit tests for module and runtime behavior
+  - Added e2e fixtures/tests and shared e2e utilities
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @desource/phone-mask@1.0.0
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -6,7 +6,7 @@
 [![bundle size](https://img.shields.io/bundlephobia/minzip/@desource/phone-mask-react?label=gzip%20size&color=purple)](https://bundlephobia.com/package/@desource/phone-mask-react)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/DeSource-Labs/phone-mask/blob/main/LICENSE)
 
-Beautiful, accessible, extreme small & tree-shackable React phone input with auto-formatting, country selector, and validation.
+Beautiful, accessible, extreme small & tree-shakeable React phone input with auto-formatting, country selector, and validation.
 
 ## ✨ Features
 
@@ -37,12 +37,14 @@ pnpm add @desource/phone-mask-react
 ### Importing
 
 Component mode:
+
 ```tsx
 import { PhoneInput } from '@desource/phone-mask-react';
 import '@desource/phone-mask-react/assets/lib.css'; // Import styles
 ```
 
 Hook mode:
+
 ```tsx
 import { usePhoneMask } from '@desource/phone-mask-react';
 ```
@@ -60,12 +62,7 @@ function App() {
 
   return (
     <>
-      <PhoneInput
-        value={phone}
-        onChange={setPhone}
-        onValidationChange={setIsValid}
-        country="US"
-      />
+      <PhoneInput value={phone} onChange={setPhone} onValidationChange={setIsValid} country="US" />
 
       {isValid && <p>✓ Valid phone number</p>}
     </>
@@ -78,15 +75,17 @@ function App() {
 For custom input implementations:
 
 ```tsx
+import { useState } from 'react';
 import { usePhoneMask } from '@desource/phone-mask-react';
 
 function CustomPhoneInput() {
+  const [value, setValue] = useState('');
+
   const { ref, digits, full, fullFormatted, isComplete, country, setCountry } = usePhoneMask({
+    value,
+    onChange: setValue,
     country: 'US',
-    detect: true,
-    onChange: (phone) => {
-      console.log(phone.full, phone.digits);
-    }
+    detect: true
   });
 
   return (
@@ -105,10 +104,12 @@ function CustomPhoneInput() {
 
 ### Props
 
+> **Note:** The component requires controlled behavior. Both `value` and `onChange` props are required.
+
 ```ts
 interface PhoneInputProps {
-  // Controlled value (digits only, without country code)
-  value?: string;
+  // Controlled value (digits only, without country code) - REQUIRED
+  value: string;
 
   // Preselected country (ISO 3166-1 alpha-2)
   country?: CountryKey;
@@ -155,9 +156,9 @@ interface PhoneInputProps {
   // Disable default styles
   disableDefaultStyles?: boolean; // Default: false
 
-  // Callback when the digits value changes.
+  // Callback when the digits value changes - REQUIRED
   // Returns only the digits without country code (e.g. '234567890')
-  onChange?: (digits: string) => void;
+  onChange: (digits: string) => void;
 
   // Callback when the phone number changes.
   // Provides an object with:
@@ -218,8 +219,16 @@ phoneInputRef.current?.isComplete(); // Checks if the current phone number is co
 
 ### Options
 
+> **Note:** The hook requires controlled behavior. Both `value` and `onChange` options are required.
+
 ```ts
 interface UsePhoneMaskOptions {
+  // Controlled value (digits only, without country code) - REQUIRED
+  value: string;
+
+  // Callback when the digits value changes - REQUIRED
+  onChange: (digits: string) => void;
+
   // Predefined country ISO code (e.g., 'US', 'DE', 'GB')
   country?: string;
 
@@ -229,8 +238,8 @@ interface UsePhoneMaskOptions {
   // Auto-detect country from IP/locale (default: false)
   detect?: boolean;
 
-  // Value change callback
-  onChange?: (phone: PhoneNumber) => void;
+  // Callback when the phone changes (full, fullFormatted, digits)
+  onPhoneChange?: (phone: PhoneNumber) => void;
 
   // Country change callback
   onCountryChange?: (country: MaskFull) => void;
@@ -373,11 +382,7 @@ function Example() {
       name="phone"
       control={control}
       render={({ field }) => (
-        <PhoneInput
-          value={field.value}
-          onChange={(digits) => field.onChange(digits)}
-          onBlur={field.onBlur}
-        />
+        <PhoneInput value={field.value} onChange={(digits) => field.onChange(digits)} onBlur={field.onBlur} />
       )}
     />
   );
@@ -439,6 +444,7 @@ function Example() {
 - [@desource/phone-mask](../phone-mask) — Core library
 - [@desource/phone-mask-nuxt](../phone-mask-nuxt) — Nuxt module
 - [@desource/phone-mask-vue](../phone-mask-vue) — Vue 3 bindings
+- [@desource/phone-mask-svelte](../phone-mask-svelte) — Svelte bindings
 
 ## 📄 License
 

package/dist/esm/components/PhoneInput.d.ts

@@ -1,11 +1,4 @@
-import { type Ref } from 'react';
+import React from 'react';
 import type { PhoneInputProps, PhoneInputRef } from '../types';
-type PhoneInputComponent = PhoneInputProps & {
-    ref?: Ref<PhoneInputRef>;
-};
-export declare const PhoneInput: {
-    ({ ref, ...props }: PhoneInputComponent): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-export {};
+export declare const PhoneInput: React.ForwardRefExoticComponent<PhoneInputProps & React.RefAttributes<PhoneInputRef>>;
 //# sourceMappingURL=PhoneInput.d.ts.map

package/dist/esm/components/PhoneInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhoneInput.d.ts","sourceRoot":"","sources":["../../../src/components/PhoneInput.tsx"],"names":[],"mappings":"AAAA,OAAc,EAQZ,KAAK,GAAG,EACT,MAAM,OAAO,CAAC;AAYf,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAe,MAAM,UAAU,CAAC;AAS5E,KAAK,mBAAmB,GAAG,eAAe,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,CAAA;CAAE,CAAC;AAE1E,eAAO,MAAM,UAAU;wBAAuB,mBAAmB;;CAuwBhE,CAAC"}
+{"version":3,"file":"PhoneInput.d.ts","sourceRoot":"","sources":["../../../src/components/PhoneInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAUf,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA4W/D,eAAO,MAAM,UAAU,uFAA8D,CAAC"}

package/dist/esm/hooks/internal/useCopyAction.d.ts

@@ -0,0 +1,14 @@
+import { type RefObject } from 'react';
+interface UseCopyActionOptions {
+    fullFormatted: string;
+    liveRef?: RefObject<HTMLElement | null>;
+    onCopy?: (value: string) => void;
+}
+export declare function useCopyAction({ liveRef, fullFormatted, onCopy }: UseCopyActionOptions): {
+    copied: boolean;
+    copyAriaLabel: string;
+    copyButtonTitle: string;
+    onCopyClick: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=useCopyAction.d.ts.map

package/dist/esm/hooks/internal/useCopyAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyAction.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useCopyAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI7D,UAAU,oBAAoB;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAID,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,oBAAoB;;;;;EAiCrF"}

package/dist/esm/hooks/internal/useCountry.d.ts

@@ -0,0 +1,21 @@
+import { type MaskFull } from '@desource/phone-mask';
+export interface UseCountryOptions {
+    /** Country ISO code (e.g., 'US', 'DE', 'GB') */
+    country?: string;
+    /** Locale for country names (default: navigator.language) */
+    locale?: string;
+    /** Auto-detect country from IP/locale (default: false) */
+    detect?: boolean;
+    /** Callback when country changes */
+    onCountryChange?: (country: MaskFull) => void;
+}
+export interface UseCountryReturn {
+    /** Current country data */
+    country: MaskFull;
+    /** Change country programmatically */
+    setCountry: (countryCode?: string | null) => boolean;
+    /** Computed locale value */
+    locale: string;
+}
+export declare function useCountry({ country: countryOption, locale: localeOption, detect, onCountryChange }: UseCountryOptions): UseCountryReturn;
+//# sourceMappingURL=useCountry.d.ts.map

package/dist/esm/hooks/internal/useCountry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountry.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useCountry.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,OAAO,EAAE,QAAQ,CAAC;IAClB,sCAAsC;IACtC,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC;IACrD,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,EACzB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,EACpB,MAAM,EACN,eAAe,EAChB,EAAE,iBAAiB,GAAG,gBAAgB,CAiDtC"}

package/dist/esm/hooks/internal/useCountrySelector.d.ts

@@ -0,0 +1,32 @@
+import React, { type RefObject } from 'react';
+import { type CountryKey } from '@desource/phone-mask';
+interface UseCountrySelectOptions {
+    rootRef: RefObject<HTMLDivElement | null>;
+    dropdownRef: RefObject<HTMLDivElement | null>;
+    searchRef: RefObject<HTMLInputElement | null>;
+    selectorRef: RefObject<HTMLDivElement | null>;
+    locale: string;
+    onSelectCountry: (code: CountryKey) => void;
+    countryOption?: string;
+    inactive?: boolean;
+    onAfterSelect?: () => void;
+}
+export declare function useCountrySelector({ rootRef, dropdownRef, searchRef, selectorRef, locale, countryOption, inactive, onSelectCountry, onAfterSelect }: UseCountrySelectOptions): {
+    dropdownOpen: boolean;
+    isClosing: boolean;
+    search: string;
+    focusedIndex: number;
+    dropdownStyle: React.CSSProperties;
+    filteredCountries: import("@desource/phone-mask").MaskFull[];
+    hasDropdown: boolean;
+    openDropdown: () => void;
+    closeDropdown: () => void;
+    toggleDropdown: () => void;
+    selectCountry: (code: CountryKey) => void;
+    setFocusedIndex: React.Dispatch<React.SetStateAction<number>>;
+    handleSearchChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    handleSearchKeydown: (e: React.KeyboardEvent) => void;
+    handleDropdownAnimationEnd: () => void;
+};
+export {};
+//# sourceMappingURL=useCountrySelector.d.ts.map

package/dist/esm/hooks/internal/useCountrySelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountrySelector.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useCountrySelector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA6C,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAC;AAE7G,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEnF,UAAU,uBAAuB;IAC/B,OAAO,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC1C,WAAW,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC9C,WAAW,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,WAAW,EACX,SAAS,EACT,WAAW,EACX,MAAM,EACN,aAAa,EACb,QAAQ,EACR,eAAe,EACf,aAAa,EACd,EAAE,uBAAuB;;;;;;;;;;;0BA6Cf,UAAU;;4BAUwB,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC;6BA0DxE,KAAK,CAAC,aAAa;;EAmE1B"}

package/dist/esm/hooks/internal/useFormatter.d.ts

@@ -0,0 +1,45 @@
+import { type MaskFull, type FormatterHelpers } from '@desource/phone-mask';
+import type { PhoneNumber } from '../../types';
+/** Configuration options for the useFormatter hook */
+export interface UseFormatterOptions {
+    /** Pre-resolved country data */
+    country: MaskFull;
+    /**
+     * Controlled value (digits only, without country code)
+     * The parent is responsible for managing state via onChange callback.
+     */
+    value: string;
+    /** Callback when the digits value changes. */
+    onChange: (digits: string) => void;
+    /** Callback when the phone number changes. */
+    onPhoneChange?: (value: PhoneNumber) => void;
+    /** Callback when validation state (isComplete) changes */
+    onValidationChange?: (isComplete: boolean) => void;
+}
+/** Return type for useFormatter hook */
+export interface UseFormatterReturn {
+    /** Raw digits without formatting */
+    digits: string;
+    /** Phone formatter instance */
+    formatter: FormatterHelpers;
+    /** Placeholder from formatter */
+    displayPlaceholder: string;
+    /** Formatted display string */
+    displayValue: string;
+    /** Full phone number with country code */
+    full: string;
+    /** Full phone number formatted */
+    fullFormatted: string;
+    /** Whether the phone number is complete */
+    isComplete: boolean;
+    /** Whether the input is empty */
+    isEmpty: boolean;
+    /** Whether to show validation warning */
+    shouldShowWarn: boolean;
+}
+/**
+ * Hook for phone number formatting and derived computations.
+ * Receives pre-resolved country data; country management is handled by the caller.
+ */
+export declare function useFormatter({ country, value, onChange, onPhoneChange, onValidationChange }: UseFormatterOptions): UseFormatterReturn;
+//# sourceMappingURL=useFormatter.d.ts.map

package/dist/esm/hooks/internal/useFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormatter.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useFormatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAuC,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,OAAO,EAAE,QAAQ,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,KAAK,EACL,QAAQ,EACR,aAAa,EACb,kBAAkB,EACnB,EAAE,mBAAmB,GAAG,kBAAkB,CA8C1C"}

package/dist/esm/hooks/internal/useInputHandlers.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { type FormatterHelpers } from '@desource/phone-mask';
+export interface UseInputHandlersOptions {
+    formatter: FormatterHelpers;
+    digits: string;
+    inactive?: boolean;
+    onChange?: (newDigits: string) => void;
+    scheduleValidationHint?: (delay: number) => void;
+}
+export interface UseInputHandlersReturn {
+    handleBeforeInput: (e: React.SyntheticEvent<HTMLInputElement> | InputEvent) => void;
+    handleInput: (e: React.SyntheticEvent<HTMLInputElement> | Event) => void;
+    handleKeydown: (e: React.KeyboardEvent<HTMLInputElement> | KeyboardEvent) => void;
+    handlePaste: (e: React.ClipboardEvent<HTMLInputElement> | ClipboardEvent) => void;
+}
+/**
+ * React hook that provides event handlers for phone input masking.
+ * Handlers are compatible with both native events and React synthetic events.
+ */
+export declare function useInputHandlers(options: UseInputHandlersOptions): UseInputHandlersReturn;
+//# sourceMappingURL=useInputHandlers.d.ts.map

package/dist/esm/hooks/internal/useInputHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInputHandlers.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useInputHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAC3C,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAG,UAAU,KAAK,IAAI,CAAC;IACpF,WAAW,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC;IACzE,aAAa,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,GAAG,aAAa,KAAK,IAAI,CAAC;IAClF,WAAW,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,KAAK,IAAI,CAAC;CACnF;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAyEzF"}

package/dist/esm/hooks/internal/useTheme.d.ts

@@ -0,0 +1,9 @@
+import type { Theme } from '../../types';
+interface UseThemeOptions {
+    theme: Theme;
+}
+export declare function useTheme({ theme }: UseThemeOptions): {
+    themeClass: string;
+};
+export {};
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/esm/hooks/internal/useTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useTheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,UAAU,eAAe;IACvB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,eAAe;;EA0BlD"}

package/dist/esm/hooks/internal/useValidationHint.d.ts

@@ -0,0 +1,6 @@
+export declare function useValidationHint(): {
+    showValidationHint: boolean;
+    clearValidationHint: (hideHint?: boolean) => void;
+    scheduleValidationHint: (delay: number) => void;
+};
+//# sourceMappingURL=useValidationHint.d.ts.map

package/dist/esm/hooks/internal/useValidationHint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useValidationHint.d.ts","sourceRoot":"","sources":["../../../../src/hooks/internal/useValidationHint.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB;;;oCAcrB,MAAM;EAUjB"}

package/dist/esm/hooks/usePhoneMask.d.ts

@@ -2,6 +2,7 @@ import type { UsePhoneMaskOptions, UsePhoneMaskReturn } from '../types';
 /**
  * React hook for phone number masking.
  * Provides low-level phone masking functionality for custom input implementations.
+ * Works in controlled mode — caller manages value state via onChange callback.
  */
-export declare function usePhoneMask(options?: UsePhoneMaskOptions): UsePhoneMaskReturn;
+export declare function usePhoneMask(options: UsePhoneMaskOptions): UsePhoneMaskReturn;
 //# sourceMappingURL=usePhoneMask.d.ts.map

package/dist/esm/hooks/usePhoneMask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePhoneMask.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePhoneMask.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAe,MAAM,UAAU,CAAC;AAyBrF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CAwTlF"}
+{"version":3,"file":"usePhoneMask.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePhoneMask.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA2F7E"}

package/dist/esm/hooks/utility/useClipboard.d.ts

@@ -0,0 +1,6 @@
+export declare function useClipboard(delay?: number): {
+    copied: boolean;
+    isCopying: boolean;
+    copy: (text: string) => Promise<boolean>;
+};
+//# sourceMappingURL=useClipboard.d.ts.map

package/dist/esm/hooks/utility/useClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../../../src/hooks/utility/useClipboard.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,KAAK,SAAQ;;;iBAMzB,MAAM;EAuBtB"}

package/dist/esm/hooks/utility/useTimer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Custom hook for managing timers with automatic cleanup
+ * @returns Object with set and clear methods for timer control
+ */
+export declare function useTimer(): {
+    set: (callback: () => void, delay: number) => void;
+    clear: () => void;
+};
+//# sourceMappingURL=useTimer.d.ts.map

package/dist/esm/hooks/utility/useTimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimer.d.ts","sourceRoot":"","sources":["../../../../src/hooks/utility/useTimer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,QAAQ;oBAWT,MAAM,IAAI,SAAS,MAAM;;EAavC"}

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,OAAO,EACR,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,IAAI,IAAI,cAAc,EACtB,KAAK,IAAI,eAAe,EACzB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,UAAU,IAAI,WAAW,EACzB,QAAQ,IAAI,SAAS,EACrB,WAAW,IAAI,YAAY,EAC3B,IAAI,IAAI,KAAK,EACb,OAAO,IAAI,QAAQ,EACnB,YAAY,IAAI,aAAa,EAC7B,eAAe,IAAI,gBAAgB,EACnC,QAAQ,IAAI,SAAS,EACrB,WAAW,IAAI,YAAY,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,YAAY;;;;;;;CAOxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,OAAO,EACR,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,YAAY,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,IAAI,IAAI,cAAc,EACtB,KAAK,IAAI,eAAe,EACzB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,UAAU,IAAI,WAAW,EACzB,QAAQ,IAAI,SAAS,EACrB,WAAW,IAAI,YAAY,EAC3B,IAAI,IAAI,KAAK,EACb,OAAO,IAAI,QAAQ,EACnB,YAAY,IAAI,aAAa,EAC7B,eAAe,IAAI,gBAAgB,EACnC,QAAQ,IAAI,SAAS,EACrB,WAAW,IAAI,YAAY,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,YAAY;;;;;;;CAOxB,CAAC"}