react-country-kit 1.0.0 → 1.1.1

package/dist/ui.d.ts

@@ -1,413 +1 @@
-import { ClassValue } from 'clsx';
-import { default as default_2 } from 'react';
-import { JSX as JSX_2 } from 'react/jsx-runtime';
-import * as PopoverPrimitive from '@radix-ui/react-popover';
-
-export declare const Badge: {
-    ({ children, className }: {
-        children: default_2.ReactNode;
-        className?: string;
-    }): JSX_2.Element;
-    displayName: string;
-};
-
-export declare const CheckIcon: {
-    ({ className }: {
-        className?: string;
-    }): JSX_2.Element;
-    displayName: string;
-};
-
-/**
- * Merges Tailwind CSS classes safely, resolving conflicts.
- * Re-exported from react-country-kit/ui for consumer convenience.
- */
-export declare function cn(...inputs: ClassValue[]): string;
-
-export declare const CommandEmpty: default_2.ForwardRefExoticComponent<default_2.HTMLAttributes<HTMLDivElement> & default_2.RefAttributes<HTMLDivElement>>;
-
-export declare const CommandInput: default_2.ForwardRefExoticComponent<CommandInputProps & default_2.RefAttributes<HTMLInputElement>>;
-
-declare interface CommandInputProps extends Omit<default_2.InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
-    onValueChange?: (value: string) => void;
-}
-
-export declare const CommandItem: default_2.ForwardRefExoticComponent<CommandItemProps & default_2.RefAttributes<HTMLDivElement>>;
-
-declare interface CommandItemProps extends default_2.HTMLAttributes<HTMLDivElement> {
-    /** Called when the item is clicked or activated via keyboard Enter. */
-    onSelect?: () => void;
-    disabled?: boolean;
-    selected?: boolean;
-    /** Kept for API compatibility; not used internally. */
-    value?: string;
-}
-
-export declare const CommandList: default_2.ForwardRefExoticComponent<default_2.HTMLAttributes<HTMLDivElement> & default_2.RefAttributes<HTMLDivElement>>;
-
-/** Wrapper that groups search input + scrollable list. */
-export declare const CommandRoot: default_2.ForwardRefExoticComponent<default_2.HTMLAttributes<HTMLDivElement> & default_2.RefAttributes<HTMLDivElement>>;
-
-export declare interface Country {
-    name: string;
-    iso2: string;
-    iso3: string;
-    phone_code: string;
-    phone_format: PhoneFormat;
-    currency: Currency;
-    division_type: string;
-    divisions: Division[];
-    timezones: Timezone[];
-    /** Emoji flag computed from iso2 */
-    flag: string;
-}
-
-export declare function CountryMultiSelect({ value, onChange, placeholder, maxItems, showFlags, searchable, disabled, className, label, }: CountryMultiSelectProps): JSX_2.Element;
-
-export declare interface CountryMultiSelectProps {
-    value: Country[];
-    onChange: (countries: Country[]) => void;
-    placeholder?: string;
-    /** Maximum number of selections (undefined = unlimited) */
-    maxItems?: number;
-    showFlags?: boolean;
-    searchable?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-export declare function CountryPicker({ value, onChange, placeholder, searchable, showFlag, showPhoneCode, disabled, className, label, }: CountryPickerProps): JSX_2.Element;
-
-export declare interface CountryPickerProps {
-    /** Currently selected country */
-    value?: Country | null;
-    /** Callback when user selects a country */
-    onChange: (country: Country) => void;
-    placeholder?: string;
-    /** Enable search input */
-    searchable?: boolean;
-    /** Show emoji flag next to country name */
-    showFlag?: boolean;
-    /** Show phone dial code */
-    showPhoneCode?: boolean;
-    /** Disable the picker */
-    disabled?: boolean;
-    /** Additional wrapper class */
-    className?: string;
-    /** aria-label */
-    label?: string;
-}
-
-export declare interface Currency {
-    code: string;
-    name: string;
-    symbol: string;
-}
-
-export declare function CurrencyMultiSelect({ value, onChange, placeholder, maxItems, showSymbol, searchable, disabled, className, label, }: CurrencyMultiSelectProps): JSX_2.Element;
-
-export declare interface CurrencyMultiSelectProps {
-    value: Currency[];
-    onChange: (currencies: Currency[]) => void;
-    placeholder?: string;
-    maxItems?: number;
-    showSymbol?: boolean;
-    searchable?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-export declare function CurrencyPicker({ value, onChange, placeholder, searchable, showSymbol, countryIso2, autoSelect, disabled, className, label, }: CurrencyPickerProps): JSX_2.Element;
-
-export declare interface CurrencyPickerProps {
-    value?: Currency | null;
-    onChange: (currency: Currency) => void;
-    placeholder?: string;
-    searchable?: boolean;
-    /** Filter currencies to a specific country (iso2) and enable auto-selection */
-    countryIso2?: string;
-    /** Auto-select the first currency if countryIso2 is provided. Defaults to true if countryIso2 is present and value is empty. */
-    autoSelect?: boolean;
-    /** Show currency symbol alongside code */
-    showSymbol?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-export declare interface Division {
-    name: string;
-    iso2: string;
-    timezone: string;
-}
-
-export declare function DivisionPicker({ countryIso2, value, onChange, placeholder, searchable, disabled, className, label, }: DivisionPickerProps): JSX_2.Element;
-
-export declare interface DivisionPickerProps {
-    /** ISO2 code of the parent country (required) */
-    countryIso2: string;
-    value?: Division | null;
-    onChange: (division: Division) => void;
-    placeholder?: string;
-    searchable?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-/**
- * Returns all countries
- */
-export declare function getAllCountries(): Country[];
-
-/**
- * Returns all unique currencies across all countries
- */
-export declare function getAllCurrencies(): Currency[];
-
-/**
- * Returns all languages
- */
-export declare function getAllLanguages(): Language[];
-
-/**
- * Returns all unique timezones across all countries
- */
-export declare function getAllTimezones(): Timezone[];
-
-/**
- * Find a country by its ISO2 code (case-insensitive)
- */
-export declare function getCountryByIso2(iso2: string): Country | undefined;
-
-/**
- * Find a country by its ISO3 code (case-insensitive)
- */
-export declare function getCountryByIso3(iso3: string): Country | undefined;
-
-/**
- * Find a country by its name (partial, case-insensitive)
- */
-export declare function getCountryByName(name: string): Country | undefined;
-
-/**
- * Find a currency by its code (e.g. "USD")
- */
-export declare function getCurrencyByCode(code: string): Currency | undefined;
-
-/**
- * Get the currency of a country
- */
-export declare function getCurrencyByCountry(iso2: string): Currency | undefined;
-
-/**
- * Get all divisions for a country
- */
-export declare function getDivisionsByCountry(iso2: string): Division[];
-
-/**
- * Find a language by its BCP-47 code
- */
-export declare function getLanguageByCode(code: string): Language | undefined;
-
-/**
- * Find a timezone by its IANA name (e.g. "America/New_York")
- */
-export declare function getTimezoneByName(name: string): Timezone | undefined;
-
-/**
- * Get all timezones for a country
- */
-export declare function getTimezonesByCountry(iso2: string): Timezone[];
-
-/**
- * Auto-generated country dataset — DO NOT EDIT MANUALLY.
- * Source: https://raw.githubusercontent.com/kishormainali/country_division_database/refs/heads/main/countries.json
- * Generated: 2026-04-19T05:48:30.758Z
- * Countries: 250
- */
-export declare function iso2ToFlag(iso2: string): string;
-
-export declare interface Language {
-    code: string;
-    english_name: string;
-    native_name: string;
-}
-
-export declare function LanguagePicker({ value, onChange, placeholder, searchable, showNativeName, disabled, className, label, }: LanguagePickerProps): JSX_2.Element;
-
-export declare interface LanguagePickerProps {
-    value?: Language | null;
-    onChange: (language: Language) => void;
-    placeholder?: string;
-    searchable?: boolean;
-    /** Show native language name alongside english name */
-    showNativeName?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-export declare interface PhoneFormat {
-    countryCode?: string;
-    iso2: string;
-    dialCode: string;
-    patterns: string;
-    possibleLengths: string;
-    example: string | number;
-}
-
-export declare const PhoneInput: default_2.ForwardRefExoticComponent<PhoneInputProps & default_2.RefAttributes<HTMLDivElement>>;
-
-export declare interface PhoneInputProps {
-    value?: PhoneValue | null;
-    onChange: (value: PhoneValue) => void;
-    /** Pre-select a country by ISO2 on first render */
-    defaultCountryIso2?: string;
-    placeholder?: string;
-    showFlag?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-/**
- * Value object returned by PhoneInput.
- */
-export declare interface PhoneValue {
-    /** Full Country object of the selected country */
-    country: Country;
-    /** Dial code with + prefix, e.g. "+1" */
-    dialCode: string;
-    /** Raw phone number without dial code, e.g. "4155551234" */
-    number: string;
-    /** Full number with dial code, e.g. "+14155551234" */
-    full: string;
-}
-
-export declare const PickerTrigger: default_2.ForwardRefExoticComponent<PickerTriggerProps & default_2.RefAttributes<HTMLButtonElement>>;
-
-declare interface PickerTriggerProps extends default_2.ButtonHTMLAttributes<HTMLButtonElement> {
-    isOpen?: boolean;
-    hasValue?: boolean;
-    placeholder?: string;
-}
-
-export declare const Popover: default_2.FC<PopoverPrimitive.PopoverProps>;
-
-export declare const PopoverContent: default_2.ForwardRefExoticComponent<PopoverContentProps & default_2.RefAttributes<HTMLDivElement>>;
-
-declare interface PopoverContentProps extends default_2.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content> {
-}
-
-export declare const PopoverTrigger: default_2.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & default_2.RefAttributes<HTMLButtonElement>>;
-
-/**
- * Search countries by name, iso2, iso3 or phone code
- */
-export declare function searchCountries(query: string): Country[];
-
-/**
- * Search currencies by code, name, or symbol
- */
-export declare function searchCurrencies(query: string, countryIso2?: string): Currency[];
-
-/**
- * Search languages by english name, native name, or code
- */
-export declare function searchLanguages(query: string): Language[];
-
-/**
- * Search timezones by name, abbreviation, or offset string
- */
-export declare function searchTimezones(query: string, countryIso2?: string): Timezone[];
-
-export declare interface Timezone {
-    name: string;
-    offset: number;
-    offset_name: string;
-    abbreviation: string;
-    tzName: string;
-}
-
-export declare function TimezonePicker({ value, onChange, placeholder, searchable, countryIso2, autoSelect, disabled, className, label, }: TimezonePickerProps): JSX_2.Element;
-
-export declare interface TimezonePickerProps {
-    value?: Timezone | null;
-    onChange: (timezone: Timezone) => void;
-    placeholder?: string;
-    searchable?: boolean;
-    /** Filter timezones to a specific country (iso2) and enable auto-selection */
-    countryIso2?: string;
-    /** Auto-select the first timezone if countryIso2 is provided. Defaults to true if countryIso2 is present and value is empty. */
-    autoSelect?: boolean;
-    disabled?: boolean;
-    className?: string;
-    label?: string;
-}
-
-export declare function useCountryPicker(initialValue?: Country | null, onChange?: (country: Country) => void): UsePickerReturn<Country>;
-
-export declare function useCurrencyPicker(initialValue?: Currency | null, onChange?: (currency: Currency) => void): UsePickerReturn<Currency>;
-
-export declare function useDivisionPicker(countryIso2: string, initialValue?: Division | null, onChange?: (division: Division) => void): UsePickerReturn<Division>;
-
-export declare function useLanguagePicker(initialValue?: Language | null, onChange?: (language: Language) => void): UsePickerReturn<Language>;
-
-/**
- * Generic multi-selection hook.
- * Handles open/close, search, and toggle-selection of multiple items.
- */
-export declare function useMultiSelect<T>(allItems: T[], filterFn: (items: T[], query: string) => T[], keyFn: (item: T) => string, initialValue?: T[], onChange?: (items: T[]) => void, maxItems?: number): UseMultiSelectReturn<T>;
-
-export declare interface UseMultiSelectReturn<T> {
-    isOpen: boolean;
-    searchQuery: string;
-    filteredItems: T[];
-    selectedItems: T[];
-    open: () => void;
-    close: () => void;
-    toggle: () => void;
-    setSearchQuery: (query: string) => void;
-    toggleItem: (item: T) => void;
-    isSelected: (item: T) => boolean;
-    removeItem: (item: T) => void;
-    clearAll: () => void;
-}
-
-export declare function usePhoneInput(initialValue?: PhoneValue | null, onChange?: (value: PhoneValue) => void, defaultCountryIso2?: string): UsePhoneInputReturn;
-
-declare interface UsePhoneInputReturn {
-    country: Country | null;
-    number: string;
-    value: PhoneValue | null;
-    isOpen: boolean;
-    searchQuery: string;
-    filteredCountries: Country[];
-    minLength?: number;
-    maxLength?: number;
-    setSearchQuery: (q: string) => void;
-    selectCountry: (country: Country) => void;
-    setNumber: (num: string) => void;
-    toggle: () => void;
-    close: () => void;
-}
-
-export declare interface UsePickerReturn<T> {
-    isOpen: boolean;
-    searchQuery: string;
-    filteredItems: T[];
-    selectedItem: T | null;
-    open: () => void;
-    close: () => void;
-    toggle: () => void;
-    setSearchQuery: (query: string) => void;
-    selectItem: (item: T) => void;
-    clearSelection: () => void;
-}
-
-export declare function useTimezonePicker(initialValue?: Timezone | null, onChange?: (timezone: Timezone) => void, countryIso2?: string): UsePickerReturn<Timezone>;
-
-export { }
+export * from './ui/index'