react-country-kit-core 2.0.0 → 2.1.1

package/dist/types/index.d.ts

@@ -5,6 +5,7 @@ export interface IPhoneFormat {
     possibleLengths: string;
     example: string | number;
     countryCode: string;
+    nationalPrefix?: string;
 }
 export interface ICurrency {
     code: string;
@@ -47,6 +48,12 @@ export interface ICountry {
     tax_id_placeholder: string;
     /** Label for postal/zip code (e.g. "ZIP Code", "Postcode", "PIN Code") */
     postal_code_label: string;
+    /** Preferred date format, e.g. "DD/MM/YYYY", "MM/DD/YYYY", "YYYY-MM-DD" */
+    date_format: string;
+    /** Preferred date separator, e.g. "/", "-", "." */
+    date_separator: string;
+    /** First day of the week (0 = Sunday, 1 = Monday, 6 = Saturday) */
+    week_start: number;
 }
 export interface ILanguage {
     code: string;
@@ -148,6 +155,8 @@ export interface IPhoneValidation {
     example?: string;
     /** Placeholder text for the phone input */
     placeholder?: string;
+    /** National prefix that can optionally be typed in front, e.g. "0" */
+    nationalPrefix?: string;
 }
 /**
  * Value object returned by PhoneInput.
@@ -212,6 +221,12 @@ export interface IUseMultiSelectReturn<T> {
     removeItem: (item: T) => void;
     clearAll: () => void;
 }
+export interface IDateFormat {
+    countryCode: string;
+    format: string;
+    separator: string;
+    weekStart: number;
+}
 export interface IUseCountryReturn {
     country: ICountry | null;
     divisions: IDivision[];
@@ -230,4 +245,5 @@ export interface IUseCountryReturn {
     postalCode: {
         label: string;
     };
+    dateFormat: IDateFormat | null;
 }

package/dist/utils/date.d.ts

@@ -0,0 +1,27 @@
+import { IDateFormat } from '../types';
+/**
+ * Returns all country date format mappings.
+ */
+export declare function getAllDateFormats(): IDateFormat[];
+/**
+ * Finds the date format configurations for a country by its ISO2 code (case-insensitive).
+ */
+export declare function getDateFormatByCountry(iso2: string): IDateFormat;
+/**
+ * Formats a Date object using a specified pattern (e.g. 'YYYY-MM-DD', 'DD/MM/YYYY').
+ * Only supports standard YYYY, MM, DD placeholders.
+ */
+export declare function formatDateWithPattern(date: Date, pattern: string): string;
+/**
+ * Formats a Date object based on the country's default date format.
+ */
+export declare function formatDateByCountry(date: Date, iso2: string): string;
+/**
+ * Parses a date string matching a specific pattern (e.g. 'YYYY-MM-DD', 'DD/MM/YYYY') and returns a Date object.
+ * Returns null if the string is invalid or does not match the pattern.
+ */
+export declare function parseDateWithPattern(dateString: string, pattern: string): Date | null;
+/**
+ * Parses a date string based on the country's default date format.
+ */
+export declare function parseDateByCountry(dateString: string, iso2: string): Date | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-country-kit-core",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "type": "module",
   "description": "Core datasets, utilities, and hooks for react-country-kit. Comprehensive data for countries, currencies, timezones, languages, and divisions.",
   "author": "Kishor Mainali",