react-country-kit-core 2.0.0 → 2.1.0

package/dist/types/index.d.ts

@@ -212,6 +212,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 +236,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.0",
   "type": "module",
   "description": "Core datasets, utilities, and hooks for react-country-kit. Comprehensive data for countries, currencies, timezones, languages, and divisions.",
   "author": "Kishor Mainali",