@izonnet-web-solution/react-native-date-picker-kit 0.0.0-stage โ†’ 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (271) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/LICENSE +5 -0
  3. package/README.md +942 -2
  4. package/assets/screenshots/calendar-picker-blue.jpg +0 -0
  5. package/assets/screenshots/calendar-picker.jpg +0 -0
  6. package/assets/screenshots/datetime-picker-date.jpg +0 -0
  7. package/assets/screenshots/datetime-picker-time-blue.jpg +0 -0
  8. package/assets/screenshots/input-modal-picker.jpg +0 -0
  9. package/assets/screenshots/manual-entry-single.jpg +0 -0
  10. package/assets/screenshots/manual-entry-split.jpg +0 -0
  11. package/assets/screenshots/month-year-selector-modal.jpg +0 -0
  12. package/assets/screenshots/range-picker.jpg +0 -0
  13. package/assets/screenshots/time-12h-wheel.jpg +0 -0
  14. package/assets/screenshots/time-24h-military-blue.jpg +0 -0
  15. package/assets/screenshots/wheel-date-picker.jpg +0 -0
  16. package/lib/components/Calendar/Calendar.d.ts +35 -0
  17. package/lib/components/Calendar/Calendar.d.ts.map +1 -0
  18. package/lib/components/Calendar/Calendar.js +126 -0
  19. package/lib/components/Calendar/Calendar.js.map +1 -0
  20. package/lib/components/Calendar/CalendarGrid.d.ts +11 -0
  21. package/lib/components/Calendar/CalendarGrid.d.ts.map +1 -0
  22. package/lib/components/Calendar/CalendarGrid.js +22 -0
  23. package/lib/components/Calendar/CalendarGrid.js.map +1 -0
  24. package/lib/components/Calendar/CalendarHeader.d.ts +23 -0
  25. package/lib/components/Calendar/CalendarHeader.d.ts.map +1 -0
  26. package/lib/components/Calendar/CalendarHeader.js +62 -0
  27. package/lib/components/Calendar/CalendarHeader.js.map +1 -0
  28. package/lib/components/Calendar/DateCell.d.ts +11 -0
  29. package/lib/components/Calendar/DateCell.d.ts.map +1 -0
  30. package/lib/components/Calendar/DateCell.js +71 -0
  31. package/lib/components/Calendar/DateCell.js.map +1 -0
  32. package/lib/components/Calendar/MonthYearSelectorModal.d.ts +17 -0
  33. package/lib/components/Calendar/MonthYearSelectorModal.d.ts.map +1 -0
  34. package/lib/components/Calendar/MonthYearSelectorModal.js +253 -0
  35. package/lib/components/Calendar/MonthYearSelectorModal.js.map +1 -0
  36. package/lib/components/Calendar/WeekDays.d.ts +13 -0
  37. package/lib/components/Calendar/WeekDays.d.ts.map +1 -0
  38. package/lib/components/Calendar/WeekDays.js +34 -0
  39. package/lib/components/Calendar/WeekDays.js.map +1 -0
  40. package/lib/components/Calendar/index.d.ts +7 -0
  41. package/lib/components/Calendar/index.d.ts.map +1 -0
  42. package/lib/components/Calendar/index.js +23 -0
  43. package/lib/components/Calendar/index.js.map +1 -0
  44. package/lib/components/DatePicker.d.ts +4 -0
  45. package/lib/components/DatePicker.d.ts.map +1 -0
  46. package/lib/components/DatePicker.js +498 -0
  47. package/lib/components/DatePicker.js.map +1 -0
  48. package/lib/components/Input/CalendarPopup.d.ts +26 -0
  49. package/lib/components/Input/CalendarPopup.d.ts.map +1 -0
  50. package/lib/components/Input/CalendarPopup.js +60 -0
  51. package/lib/components/Input/CalendarPopup.js.map +1 -0
  52. package/lib/components/Input/DateInput.d.ts +29 -0
  53. package/lib/components/Input/DateInput.d.ts.map +1 -0
  54. package/lib/components/Input/DateInput.js +110 -0
  55. package/lib/components/Input/DateInput.js.map +1 -0
  56. package/lib/components/Input/index.d.ts +3 -0
  57. package/lib/components/Input/index.d.ts.map +1 -0
  58. package/lib/components/Input/index.js +19 -0
  59. package/lib/components/Input/index.js.map +1 -0
  60. package/lib/components/ManualDateInput/DateInputField.d.ts +19 -0
  61. package/lib/components/ManualDateInput/DateInputField.d.ts.map +1 -0
  62. package/lib/components/ManualDateInput/DateInputField.js +345 -0
  63. package/lib/components/ManualDateInput/DateInputField.js.map +1 -0
  64. package/lib/components/ManualDateInput/DateValidationMessage.d.ts +8 -0
  65. package/lib/components/ManualDateInput/DateValidationMessage.d.ts.map +1 -0
  66. package/lib/components/ManualDateInput/DateValidationMessage.js +45 -0
  67. package/lib/components/ManualDateInput/DateValidationMessage.js.map +1 -0
  68. package/lib/components/ManualDateInput/ManualDateInput.d.ts +19 -0
  69. package/lib/components/ManualDateInput/ManualDateInput.d.ts.map +1 -0
  70. package/lib/components/ManualDateInput/ManualDateInput.js +18 -0
  71. package/lib/components/ManualDateInput/ManualDateInput.js.map +1 -0
  72. package/lib/components/ManualDateInput/index.d.ts +4 -0
  73. package/lib/components/ManualDateInput/index.d.ts.map +1 -0
  74. package/lib/components/ManualDateInput/index.js +20 -0
  75. package/lib/components/ManualDateInput/index.js.map +1 -0
  76. package/lib/components/Range/RangeDateCell.d.ts +11 -0
  77. package/lib/components/Range/RangeDateCell.d.ts.map +1 -0
  78. package/lib/components/Range/RangeDateCell.js +107 -0
  79. package/lib/components/Range/RangeDateCell.js.map +1 -0
  80. package/lib/components/Range/RangePicker.d.ts +29 -0
  81. package/lib/components/Range/RangePicker.d.ts.map +1 -0
  82. package/lib/components/Range/RangePicker.js +261 -0
  83. package/lib/components/Range/RangePicker.js.map +1 -0
  84. package/lib/components/Range/index.d.ts +3 -0
  85. package/lib/components/Range/index.d.ts.map +1 -0
  86. package/lib/components/Range/index.js +19 -0
  87. package/lib/components/Range/index.js.map +1 -0
  88. package/lib/components/Time/ClockDial.d.ts +15 -0
  89. package/lib/components/Time/ClockDial.d.ts.map +1 -0
  90. package/lib/components/Time/ClockDial.js +347 -0
  91. package/lib/components/Time/ClockDial.js.map +1 -0
  92. package/lib/components/Time/DateTimePicker.d.ts +31 -0
  93. package/lib/components/Time/DateTimePicker.d.ts.map +1 -0
  94. package/lib/components/Time/DateTimePicker.js +197 -0
  95. package/lib/components/Time/DateTimePicker.js.map +1 -0
  96. package/lib/components/Time/TimePicker.d.ts +31 -0
  97. package/lib/components/Time/TimePicker.d.ts.map +1 -0
  98. package/lib/components/Time/TimePicker.js +550 -0
  99. package/lib/components/Time/TimePicker.js.map +1 -0
  100. package/lib/components/Time/WheelTimePicker.d.ts +27 -0
  101. package/lib/components/Time/WheelTimePicker.d.ts.map +1 -0
  102. package/lib/components/Time/WheelTimePicker.js +203 -0
  103. package/lib/components/Time/WheelTimePicker.js.map +1 -0
  104. package/lib/components/Time/index.d.ts +5 -0
  105. package/lib/components/Time/index.d.ts.map +1 -0
  106. package/lib/components/Time/index.js +21 -0
  107. package/lib/components/Time/index.js.map +1 -0
  108. package/lib/components/Wheel/WheelColumn.d.ts +17 -0
  109. package/lib/components/Wheel/WheelColumn.d.ts.map +1 -0
  110. package/lib/components/Wheel/WheelColumn.js +192 -0
  111. package/lib/components/Wheel/WheelColumn.js.map +1 -0
  112. package/lib/components/Wheel/WheelPicker.d.ts +26 -0
  113. package/lib/components/Wheel/WheelPicker.d.ts.map +1 -0
  114. package/lib/components/Wheel/WheelPicker.js +123 -0
  115. package/lib/components/Wheel/WheelPicker.js.map +1 -0
  116. package/lib/components/Wheel/index.d.ts +3 -0
  117. package/lib/components/Wheel/index.d.ts.map +1 -0
  118. package/lib/components/Wheel/index.js +19 -0
  119. package/lib/components/Wheel/index.js.map +1 -0
  120. package/lib/components/common/Button.d.ts +17 -0
  121. package/lib/components/common/Button.d.ts.map +1 -0
  122. package/lib/components/common/Button.js +77 -0
  123. package/lib/components/common/Button.js.map +1 -0
  124. package/lib/components/common/IconButton.d.ts +14 -0
  125. package/lib/components/common/IconButton.d.ts.map +1 -0
  126. package/lib/components/common/IconButton.js +150 -0
  127. package/lib/components/common/IconButton.js.map +1 -0
  128. package/lib/components/common/Modal.d.ts +13 -0
  129. package/lib/components/common/Modal.d.ts.map +1 -0
  130. package/lib/components/common/Modal.js +65 -0
  131. package/lib/components/common/Modal.js.map +1 -0
  132. package/lib/components/common/index.d.ts +4 -0
  133. package/lib/components/common/index.d.ts.map +1 -0
  134. package/lib/components/common/index.js +20 -0
  135. package/lib/components/common/index.js.map +1 -0
  136. package/lib/components/index.d.ts +9 -0
  137. package/lib/components/index.d.ts.map +1 -0
  138. package/lib/components/index.js +25 -0
  139. package/lib/components/index.js.map +1 -0
  140. package/lib/hooks/index.d.ts +4 -0
  141. package/lib/hooks/index.d.ts.map +1 -0
  142. package/lib/hooks/index.js +20 -0
  143. package/lib/hooks/index.js.map +1 -0
  144. package/lib/hooks/useCalendar.d.ts +34 -0
  145. package/lib/hooks/useCalendar.d.ts.map +1 -0
  146. package/lib/hooks/useCalendar.js +93 -0
  147. package/lib/hooks/useCalendar.js.map +1 -0
  148. package/lib/hooks/useDatePicker.d.ts +28 -0
  149. package/lib/hooks/useDatePicker.d.ts.map +1 -0
  150. package/lib/hooks/useDatePicker.js +150 -0
  151. package/lib/hooks/useDatePicker.js.map +1 -0
  152. package/lib/hooks/useDateRange.d.ts +23 -0
  153. package/lib/hooks/useDateRange.d.ts.map +1 -0
  154. package/lib/hooks/useDateRange.js +82 -0
  155. package/lib/hooks/useDateRange.js.map +1 -0
  156. package/lib/index.d.ts +7 -0
  157. package/lib/index.d.ts.map +1 -0
  158. package/lib/index.js +29 -0
  159. package/lib/index.js.map +1 -0
  160. package/lib/localization/en.d.ts +3 -0
  161. package/lib/localization/en.d.ts.map +1 -0
  162. package/lib/localization/en.js +80 -0
  163. package/lib/localization/en.js.map +1 -0
  164. package/lib/localization/gu.d.ts +3 -0
  165. package/lib/localization/gu.d.ts.map +1 -0
  166. package/lib/localization/gu.js +80 -0
  167. package/lib/localization/gu.js.map +1 -0
  168. package/lib/localization/hi.d.ts +3 -0
  169. package/lib/localization/hi.d.ts.map +1 -0
  170. package/lib/localization/hi.js +80 -0
  171. package/lib/localization/hi.js.map +1 -0
  172. package/lib/localization/index.d.ts +8 -0
  173. package/lib/localization/index.d.ts.map +1 -0
  174. package/lib/localization/index.js +32 -0
  175. package/lib/localization/index.js.map +1 -0
  176. package/lib/themes/dark.d.ts +3 -0
  177. package/lib/themes/dark.d.ts.map +1 -0
  178. package/lib/themes/dark.js +30 -0
  179. package/lib/themes/dark.js.map +1 -0
  180. package/lib/themes/index.d.ts +16 -0
  181. package/lib/themes/index.d.ts.map +1 -0
  182. package/lib/themes/index.js +56 -0
  183. package/lib/themes/index.js.map +1 -0
  184. package/lib/themes/light.d.ts +3 -0
  185. package/lib/themes/light.d.ts.map +1 -0
  186. package/lib/themes/light.js +30 -0
  187. package/lib/themes/light.js.map +1 -0
  188. package/lib/types/index.d.ts +344 -0
  189. package/lib/types/index.d.ts.map +1 -0
  190. package/lib/types/index.js +3 -0
  191. package/lib/types/index.js.map +1 -0
  192. package/lib/utils/calendarUtils.d.ts +27 -0
  193. package/lib/utils/calendarUtils.d.ts.map +1 -0
  194. package/lib/utils/calendarUtils.js +108 -0
  195. package/lib/utils/calendarUtils.js.map +1 -0
  196. package/lib/utils/dateFormatting.d.ts +29 -0
  197. package/lib/utils/dateFormatting.d.ts.map +1 -0
  198. package/lib/utils/dateFormatting.js +114 -0
  199. package/lib/utils/dateFormatting.js.map +1 -0
  200. package/lib/utils/dateParsing.d.ts +23 -0
  201. package/lib/utils/dateParsing.d.ts.map +1 -0
  202. package/lib/utils/dateParsing.js +289 -0
  203. package/lib/utils/dateParsing.js.map +1 -0
  204. package/lib/utils/dateUtils.d.ts +20 -0
  205. package/lib/utils/dateUtils.d.ts.map +1 -0
  206. package/lib/utils/dateUtils.js +115 -0
  207. package/lib/utils/dateUtils.js.map +1 -0
  208. package/lib/utils/dateValidation.d.ts +36 -0
  209. package/lib/utils/dateValidation.d.ts.map +1 -0
  210. package/lib/utils/dateValidation.js +196 -0
  211. package/lib/utils/dateValidation.js.map +1 -0
  212. package/lib/utils/index.d.ts +7 -0
  213. package/lib/utils/index.d.ts.map +1 -0
  214. package/lib/utils/index.js +23 -0
  215. package/lib/utils/index.js.map +1 -0
  216. package/lib/utils/timeUtils.d.ts +78 -0
  217. package/lib/utils/timeUtils.d.ts.map +1 -0
  218. package/lib/utils/timeUtils.js +335 -0
  219. package/lib/utils/timeUtils.js.map +1 -0
  220. package/package.json +92 -3
  221. package/src/components/Calendar/Calendar.tsx +314 -0
  222. package/src/components/Calendar/CalendarGrid.tsx +47 -0
  223. package/src/components/Calendar/CalendarHeader.tsx +176 -0
  224. package/src/components/Calendar/DateCell.tsx +118 -0
  225. package/src/components/Calendar/MonthYearSelectorModal.tsx +407 -0
  226. package/src/components/Calendar/WeekDays.tsx +49 -0
  227. package/src/components/Calendar/index.ts +6 -0
  228. package/src/components/DatePicker.tsx +834 -0
  229. package/src/components/Input/CalendarPopup.tsx +168 -0
  230. package/src/components/Input/DateInput.tsx +259 -0
  231. package/src/components/Input/index.ts +2 -0
  232. package/src/components/ManualDateInput/DateInputField.tsx +493 -0
  233. package/src/components/ManualDateInput/DateValidationMessage.tsx +65 -0
  234. package/src/components/ManualDateInput/ManualDateInput.tsx +66 -0
  235. package/src/components/ManualDateInput/index.ts +3 -0
  236. package/src/components/Range/RangeDateCell.tsx +174 -0
  237. package/src/components/Range/RangePicker.tsx +484 -0
  238. package/src/components/Range/index.ts +2 -0
  239. package/src/components/Time/ClockDial.tsx +450 -0
  240. package/src/components/Time/DateTimePicker.tsx +395 -0
  241. package/src/components/Time/TimePicker.tsx +899 -0
  242. package/src/components/Time/WheelTimePicker.tsx +356 -0
  243. package/src/components/Time/index.ts +4 -0
  244. package/src/components/Wheel/WheelColumn.tsx +300 -0
  245. package/src/components/Wheel/WheelPicker.tsx +265 -0
  246. package/src/components/Wheel/index.ts +2 -0
  247. package/src/components/common/Button.tsx +125 -0
  248. package/src/components/common/IconButton.tsx +237 -0
  249. package/src/components/common/Modal.tsx +137 -0
  250. package/src/components/common/index.ts +3 -0
  251. package/src/components/index.ts +8 -0
  252. package/src/hooks/index.ts +3 -0
  253. package/src/hooks/useCalendar.ts +153 -0
  254. package/src/hooks/useDatePicker.ts +216 -0
  255. package/src/hooks/useDateRange.ts +135 -0
  256. package/src/index.ts +17 -0
  257. package/src/localization/en.ts +78 -0
  258. package/src/localization/gu.ts +78 -0
  259. package/src/localization/hi.ts +78 -0
  260. package/src/localization/index.ts +31 -0
  261. package/src/themes/dark.ts +28 -0
  262. package/src/themes/index.ts +73 -0
  263. package/src/themes/light.ts +28 -0
  264. package/src/types/index.ts +452 -0
  265. package/src/utils/calendarUtils.ts +152 -0
  266. package/src/utils/dateFormatting.ts +125 -0
  267. package/src/utils/dateParsing.ts +335 -0
  268. package/src/utils/dateUtils.ts +117 -0
  269. package/src/utils/dateValidation.ts +276 -0
  270. package/src/utils/index.ts +6 -0
  271. package/src/utils/timeUtils.ts +416 -0
package/README.md CHANGED
@@ -1,3 +1,943 @@
1
- # Temporary Holding Version
1
+ # @izonnet-web-solution/react-native-date-picker-kit
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ <div align="center">
4
+
5
+ ![npm version](https://img.shields.io/badge/version-1.0.0-blue.svg)
6
+ ![TypeScript](https://img.shields.io/badge/TypeScript-100%25-3178C6?logo=typescript&logoColor=white)
7
+ ![React Native](https://img.shields.io/badge/React%20Native-0.68%2B-61DAFB?logo=react&logoColor=black)
8
+ ![Platform](https://img.shields.io/badge/Platform-iOS%20%7C%20Android-brightgreen.svg)
9
+ ![Tests](https://img.shields.io/badge/Tests-93%20passed-success.svg)
10
+ ![Zero Native Dependencies](https://img.shields.io/badge/Dependencies-Zero%20Native-orange.svg)
11
+ ![License](https://img.shields.io/badge/License-MIT-green.svg)
12
+ [![GitHub Repository](https://img.shields.io/badge/GitHub-date--time--picker-181717?logo=github)](https://github.com/Izonnet-Web-Solution/date-time-picker)
13
+ [![Issues](https://img.shields.io/github/issues/Izonnet-Web-Solution/date-time-picker)](https://github.com/Izonnet-Web-Solution/date-time-picker/issues)
14
+
15
+ **A production-grade, highly customizable, and lightweight React Native Date & Time Picker library.**
16
+ Built entirely in 100% pure TypeScript and React Native core components โ€” zero native linking, zero `pod install`, works seamlessly with bare React Native and Expo Go with 60 FPS performance.
17
+
18
+ </div>
19
+
20
+ ---
21
+
22
+ ## ๐Ÿ“ธ Live Visual Previews
23
+
24
+ <div align="center">
25
+
26
+ ### Date Pickers & Month/Year Selector
27
+ | Calendar (Violet) | Calendar (Sky Blue) | Wheel Date Picker | Month & Year Fast Modal |
28
+ |:---:|:---:|:---:|:---:|
29
+ | <img src="assets/screenshots/calendar-picker.jpg" width="200" alt="Calendar Picker Violet" /> | <img src="assets/screenshots/calendar-picker-blue.jpg" width="200" alt="Calendar Picker Sky Blue" /> | <img src="assets/screenshots/wheel-date-picker.jpg" width="200" alt="Wheel Date Picker" /> | <img src="assets/screenshots/month-year-selector-modal.jpg" width="200" alt="Month Year Selector Modal" /> |
30
+
31
+ ### Time & DateTime Pickers
32
+ | 12-Hour Time (Wheel) | 24-Hour Military Time | DateTime (Date Tab) | DateTime (Time Tab) |
33
+ |:---:|:---:|:---:|:---:|
34
+ | <img src="assets/screenshots/time-12h-wheel.jpg" width="200" alt="12-Hour Time Picker" /> | <img src="assets/screenshots/time-24h-military-blue.jpg" width="200" alt="24-Hour Military Time" /> | <img src="assets/screenshots/datetime-picker-date.jpg" width="200" alt="DateTime Picker Date Tab" /> | <img src="assets/screenshots/datetime-picker-time-blue.jpg" width="200" alt="DateTime Picker Time Tab" /> |
35
+
36
+ ### Range & Manual Keyboard Entry Pickers
37
+ | Date Range Picker | Input Modal Picker | Manual Entry (Single Box) | Manual Entry (Split Pods) |
38
+ |:---:|:---:|:---:|:---:|
39
+ | <img src="assets/screenshots/range-picker.jpg" width="200" alt="Date Range Picker" /> | <img src="assets/screenshots/input-modal-picker.jpg" width="200" alt="Input Modal Picker" /> | <img src="assets/screenshots/manual-entry-single.jpg" width="200" alt="Manual Entry Single Box" /> | <img src="assets/screenshots/manual-entry-split.jpg" width="200" alt="Manual Entry Split Pods" /> |
40
+
41
+ </div>
42
+
43
+ ---
44
+
45
+ ## ๐Ÿ“‹ Table of Contents
46
+
47
+ - [Live Visual Previews](#-live-visual-previews)
48
+ - [Features](#-features)
49
+ - [Architecture & Highlights](#-architecture--highlights)
50
+ - [Installation](#-installation)
51
+ - [Modes Overview](#-modes-overview)
52
+ - [Quick Start & Code Examples](#-quick-start--code-examples)
53
+ - [1. Calendar Date Picker (Modal Dialog)](#1-calendar-date-picker-modal-dialog)
54
+ - [2. Wheel Date Picker (3D Inertial Scroll)](#2-wheel-date-picker-3d-inertial-scroll)
55
+ - [3. 12-Hour Time Picker (with AM/PM & Intervals)](#3-12-hour-time-picker-with-ampm--intervals)
56
+ - [4. 24-Hour Military Time Picker (with Seconds)](#4-24-hour-military-time-picker-with-seconds)
57
+ - [5. Analog Clock Dial & Spinner Layout](#5-analog-clock-dial--spinner-layout)
58
+ - [6. Combined Date + Time Picker (DateTime)](#6-combined-date--time-picker-datetime)
59
+ - [7. Date Range Picker (with Ribbon Highlights & Limit)](#7-date-range-picker-with-ribbon-highlights--limit)
60
+ - [8. Input Modal Picker (Tap-to-Open Field)](#8-input-modal-picker-tap-to-open-field)
61
+ - [9. Strict Manual Keyboard Entry (Single Box & Split Pods)](#9-strict-manual-keyboard-entry-single-box--split-pods)
62
+ - [10. Standalone Component Usage](#10-standalone-component-usage)
63
+ - [Modal & Color Customization](#-modal--color-customization)
64
+ - [Month & Year Fast Navigator Modal](#-month--year-fast-navigator-modal)
65
+ - [Dynamic Format Switcher Bar](#-dynamic-format-switcher-bar)
66
+ - [Formatting Tokens Reference](#-formatting-tokens-reference)
67
+ - [Multilingual Localization](#-multilingual-localization)
68
+ - [Themes & Styling Reference](#-themes--styling-reference)
69
+ - [Comprehensive Props Reference](#-comprehensive-props-reference)
70
+ - [Exported Components & Hooks](#-exported-components--hooks)
71
+ - [Testing & Quality Assurance](#-testing--quality-assurance)
72
+ - [Links & Resources](#-links--resources)
73
+ - [License](#-license)
74
+
75
+ ---
76
+
77
+ ## โœจ Features
78
+
79
+ - ๐Ÿ“… **Interactive Calendar Picker**: Full-featured monthly grid with smooth month navigation, previous/next jump, disable filters, and current day indicator.
80
+ - ๐ŸŽก **3D Wheel Date & Time Picker**: Inertial scrolling wheel columns for Day, Month, Year, Hours, Minutes, and AM/PM with realistic physics and snap feedback.
81
+ - ๐Ÿ•’ **12-Hour Time Picker (AM/PM)**: 12-hour digital/wheel clock (01โ€“12) with instant AM/PM toggle, configurable minute intervals (1m, 5m, 15m, 30m), and live preview.
82
+ - โฑ๏ธ **24-Hour Military Time Picker**: Military clock navigation (00โ€“23) with optional seconds support (`HH:mm:ss`).
83
+ - ๐Ÿงญ **Analog Clock Dial & Spinner**: Circular analog clock face with fluid angle calculation, dual-circle 24h layout, and visual needle pointers.
84
+ - ๐Ÿ—“๏ธ **Unified DateTime Picker**: Seamless synchronization of calendar date and time in one unified tabbed component.
85
+ - โ†”๏ธ **Continuous Date Range Picker**: Interactive start/end selection cards, continuous highlight ribbon between dates, and `maxRangeDays` limits.
86
+ - ๐Ÿ“ **Input Modal & Inline Field**: Clean text input with calendar popup trigger, auto-formatting, and error validation badge.
87
+ - โŒจ๏ธ **Strict Manual Keyboard Date Entry**:
88
+ - **Single Box**: Format-guided smart typing with auto-masking.
89
+ - **Split Pods**: 3 discrete boxes for Day, Month, and Year with auto-advance focus.
90
+ - ๐ŸŽจ **Live Modal Color Customization**: Complete dynamic color customization (`accentColor`, `primaryColor`, `cardColor`, `modalBackgroundColor`, `modalContentStyle`).
91
+ - ๐Ÿ—‚๏ธ **Nested Month & Year Selector Modal**: Dedicated 2-column scrollable sheet that automatically closes the parent modal cleanly and restores state without flicker or loop issues.
92
+ - ๐Ÿ”˜ **Flexible Action Buttons**: `Today` / `Now`, `Clear`, `Cancel`, and `Confirm` / `Apply` buttons with independent visibility toggles.
93
+ - ๐Ÿ”ค **Dynamic Format Switcher**: Real-time format switching bar supporting `DD/MM/YYYY`, `MM/DD/YYYY`, `YYYY/DD/MM`, and `YYYY/MM/DD`.
94
+ - ๐ŸŒ **Built-in Multilingual Localization**: English (`en`), Hindi (`hi`), and Gujarati (`gu`) with custom dictionary support.
95
+ - ๐ŸŒ“ **Adaptive Light & Dark Themes**: Pixel-perfect dark and light themes with automatic contrast calculations.
96
+ - ๐Ÿš€ **Zero Native Code**: Runs everywhere React Native runs โ€” iOS, Android, Expo Go, Web (with React Native Web).
97
+
98
+ ---
99
+
100
+ ## ๐Ÿ› ๏ธ Architecture & Highlights
101
+
102
+ | Feature | Details |
103
+ |---|---|
104
+ | **Dependencies** | **0 native dependencies**. Pure React Native core (`View`, `Text`, `TouchableOpacity`, `ScrollView`, `Modal`, `StyleSheet`). |
105
+ | **Expo Compatibility** | **100% Expo Go ready**. No prebuild, no config plugins, no native modules. |
106
+ | **TypeScript** | Written in 100% strict TypeScript with comprehensive type definitions exported. |
107
+ | **Performance** | Optimized rendering with `useCallback`, `useMemo`, and ref comparison guards to eliminate unnecessary re-renders. |
108
+ | **Test Coverage** | 93 Jest unit tests covering date arithmetic, time parsing, validation constraints, and component rendering. |
109
+
110
+ ---
111
+
112
+ ## ๐Ÿ“ฆ Installation
113
+
114
+ Install via npm:
115
+
116
+ ```bash
117
+ npm install @izonnet-web-solution/react-native-date-picker-kit
118
+ ```
119
+
120
+ Or via yarn:
121
+
122
+ ```bash
123
+ yarn add @izonnet-web-solution/react-native-date-picker-kit
124
+ ```
125
+
126
+ Or via pnpm:
127
+
128
+ ```bash
129
+ pnpm add @izonnet-web-solution/react-native-date-picker-kit
130
+ ```
131
+
132
+ ### Peer Dependencies
133
+
134
+ Ensure your project has React and React Native installed:
135
+
136
+ ```bash
137
+ npm install react react-native
138
+ ```
139
+
140
+ - React: `>=18.0.0`
141
+ - React Native: `>=0.68.0`
142
+
143
+ > [!NOTE]
144
+ > No `pod install` or native module configuration is required!
145
+
146
+ ---
147
+
148
+ ## ๐ŸŽฏ Modes Overview
149
+
150
+ The library provides 8 primary modes through the unified `<DatePicker>` component:
151
+
152
+ | Mode | `mode="..."` | Primary Use Case |
153
+ |---|---|---|
154
+ | **Calendar** | `'calendar'` | Standard date selection with calendar grid and month navigation |
155
+ | **Wheel** | `'wheel'` | Spinning 3D wheel columns for Day, Month, and Year |
156
+ | **Time (12h)** | `'time'` (`is24Hour={false}`) | 12-hour time picker with AM/PM toggle and minute intervals |
157
+ | **Time (24h)** | `'time'` (`is24Hour={true}`) | 24-hour military time picker with optional seconds |
158
+ | **DateTime** | `'datetime'` | Combined Date + Time tabbed picker in one dialog |
159
+ | **Range** | `'range'` | Date range selection with start/end cards and highlight ribbon |
160
+ | **Input** | `'input'` | Text input field with tap-to-open calendar popup |
161
+ | **Manual Entry** | `'calendar'` + `allowManualEntry` | Direct numeric typing via Single Box or Split Pods |
162
+
163
+ ---
164
+
165
+ ## ๐Ÿš€ Quick Start & Code Examples
166
+
167
+ ### 1. Calendar Date Picker (Modal Dialog)
168
+
169
+ <div align="center">
170
+ <img src="assets/screenshots/calendar-picker.jpg" width="220" alt="Calendar Picker" />
171
+ &nbsp;&nbsp;&nbsp;&nbsp;
172
+ <img src="assets/screenshots/calendar-picker-blue.jpg" width="220" alt="Calendar Picker Blue" />
173
+ </div>
174
+
175
+ Opens an interactive calendar dialog with Today, Clear, Cancel, and Confirm buttons:
176
+
177
+ ```tsx
178
+ import React, { useState } from 'react';
179
+ import { View, Button, Text } from 'react-native';
180
+ import { DatePicker, formatDate } from '@izonnet-web-solution/react-native-date-picker-kit';
181
+
182
+ export default function CalendarModalDemo() {
183
+ const [open, setOpen] = useState(false);
184
+ const [date, setDate] = useState<Date | null>(new Date());
185
+
186
+ return (
187
+ <View style={{ padding: 20 }}>
188
+ <Button title="Open Calendar" onPress={() => setOpen(true)} />
189
+ <Text style={{ marginTop: 10 }}>
190
+ Selected: {date ? formatDate(date, 'DD/MM/YYYY') : 'None'}
191
+ </Text>
192
+
193
+ <DatePicker
194
+ modal
195
+ open={open}
196
+ mode="calendar"
197
+ value={date}
198
+ onChange={setDate}
199
+ onConfirm={(selected) => {
200
+ setDate(selected);
201
+ setOpen(false);
202
+ }}
203
+ onClose={() => setOpen(false)}
204
+ onCancel={() => setOpen(false)}
205
+ accentColor="#4F46E5"
206
+ theme="dark"
207
+ locale="en"
208
+ format="DD/MM/YYYY"
209
+ minimumDate={new Date(2020, 0, 1)}
210
+ maximumDate={new Date(2030, 11, 31)}
211
+ />
212
+ </View>
213
+ );
214
+ }
215
+ ```
216
+
217
+ ---
218
+
219
+ ### 2. Wheel Date Picker (3D Inertial Scroll)
220
+
221
+ <div align="center">
222
+ <img src="assets/screenshots/wheel-date-picker.jpg" width="220" alt="Wheel Date Picker" />
223
+ </div>
224
+
225
+ Smooth Day, Month, and Year spinning wheel columns:
226
+
227
+ ```tsx
228
+ import React, { useState } from 'react';
229
+ import { View, Button } from 'react-native';
230
+ import { DatePicker } from '@izonnet-web-solution/react-native-date-picker-kit';
231
+
232
+ export default function WheelDateDemo() {
233
+ const [open, setOpen] = useState(false);
234
+ const [date, setDate] = useState<Date | null>(new Date());
235
+
236
+ return (
237
+ <View style={{ padding: 20 }}>
238
+ <Button title="Open Wheel Picker" onPress={() => setOpen(true)} />
239
+
240
+ <DatePicker
241
+ modal
242
+ open={open}
243
+ mode="wheel"
244
+ value={date}
245
+ onChange={setDate}
246
+ onConfirm={(d) => {
247
+ setDate(d);
248
+ setOpen(false);
249
+ }}
250
+ onClose={() => setOpen(false)}
251
+ accentColor="#8B5CF6"
252
+ minYear={1970}
253
+ maxYear={2050}
254
+ theme="dark"
255
+ />
256
+ </View>
257
+ );
258
+ }
259
+ ```
260
+
261
+ ---
262
+
263
+ ### 3. 12-Hour Time Picker (with AM/PM & Intervals)
264
+
265
+ <div align="center">
266
+ <img src="assets/screenshots/time-12h-wheel.jpg" width="220" alt="12-Hour Time Picker" />
267
+ </div>
268
+
269
+ 12-hour clock layout with configurable minute intervals (1m, 5m, 15m, 30m):
270
+
271
+ ```tsx
272
+ import React, { useState } from 'react';
273
+ import { View, Button } from 'react-native';
274
+ import { DatePicker } from '@izonnet-web-solution/react-native-date-picker-kit';
275
+
276
+ export default function Time12Demo() {
277
+ const [open, setOpen] = useState(false);
278
+ const [time, setTime] = useState<Date | null>(new Date());
279
+
280
+ return (
281
+ <View style={{ padding: 20 }}>
282
+ <Button title="Pick 12-Hour Time" onPress={() => setOpen(true)} />
283
+
284
+ <DatePicker
285
+ modal
286
+ open={open}
287
+ mode="time"
288
+ value={time}
289
+ onChange={setTime}
290
+ onConfirm={(t) => {
291
+ setTime(t);
292
+ setOpen(false);
293
+ }}
294
+ onClose={() => setOpen(false)}
295
+ is24Hour={false}
296
+ minuteInterval={5}
297
+ timePickerLayout="wheel"
298
+ accentColor="#8B5CF6"
299
+ format="hh:mm A"
300
+ />
301
+ </View>
302
+ );
303
+ }
304
+ ```
305
+
306
+ ---
307
+
308
+ ### 4. 24-Hour Military Time Picker (with Seconds)
309
+
310
+ <div align="center">
311
+ <img src="assets/screenshots/time-24h-military-blue.jpg" width="220" alt="24-Hour Military Time" />
312
+ </div>
313
+
314
+ Complete 24-hour clock (00โ€“23) with optional seconds display:
315
+
316
+ ```tsx
317
+ import React, { useState } from 'react';
318
+ import { View, Button } from 'react-native';
319
+ import { DatePicker } from '@izonnet-web-solution/react-native-date-picker-kit';
320
+
321
+ export default function Time24Demo() {
322
+ const [open, setOpen] = useState(false);
323
+ const [time, setTime] = useState<Date | null>(new Date());
324
+
325
+ return (
326
+ <View style={{ padding: 20 }}>
327
+ <Button title="Pick 24-Hour Time" onPress={() => setOpen(true)} />
328
+
329
+ <DatePicker
330
+ modal
331
+ open={open}
332
+ mode="time"
333
+ value={time}
334
+ onChange={setTime}
335
+ onConfirm={(t) => {
336
+ setTime(t);
337
+ setOpen(false);
338
+ }}
339
+ onClose={() => setOpen(false)}
340
+ is24Hour={true}
341
+ showSeconds={true}
342
+ format="HH:mm:ss"
343
+ accentColor="#0EA5E9"
344
+ theme="dark"
345
+ />
346
+ </View>
347
+ );
348
+ }
349
+ ```
350
+
351
+ ---
352
+
353
+ ### 5. Analog Clock Dial & Spinner Layout
354
+
355
+ Analog circular clock face with smooth angle calculation and visual needle pointers:
356
+
357
+ ```tsx
358
+ import React, { useState } from 'react';
359
+ import { View, Button } from 'react-native';
360
+ import { DatePicker } from '@izonnet-web-solution/react-native-date-picker-kit';
361
+
362
+ export default function AnalogClockDemo() {
363
+ const [open, setOpen] = useState(false);
364
+ const [time, setTime] = useState<Date | null>(new Date());
365
+
366
+ return (
367
+ <View style={{ padding: 20 }}>
368
+ <Button title="Open Analog Clock" onPress={() => setOpen(true)} />
369
+
370
+ <DatePicker
371
+ modal
372
+ open={open}
373
+ mode="time"
374
+ timePickerLayout="spinner"
375
+ value={time}
376
+ onChange={setTime}
377
+ onConfirm={(t) => {
378
+ setTime(t);
379
+ setOpen(false);
380
+ }}
381
+ onClose={() => setOpen(false)}
382
+ accentColor="#F59E0B"
383
+ format="hh:mm A"
384
+ />
385
+ </View>
386
+ );
387
+ }
388
+ ```
389
+
390
+ ---
391
+
392
+ ### 6. Combined Date + Time Picker (DateTime)
393
+
394
+ <div align="center">
395
+ <img src="assets/screenshots/datetime-picker-date.jpg" width="220" alt="DateTime Picker Date" />
396
+ &nbsp;&nbsp;&nbsp;&nbsp;
397
+ <img src="assets/screenshots/datetime-picker-time-blue.jpg" width="220" alt="DateTime Picker Time" />
398
+ </div>
399
+
400
+ Cohesive date and time synchronization in one unified dialog:
401
+
402
+ ```tsx
403
+ import React, { useState } from 'react';
404
+ import { View, Button } from 'react-native';
405
+ import { DatePicker } from '@izonnet-web-solution/react-native-date-picker-kit';
406
+
407
+ export default function DateTimeDemo() {
408
+ const [open, setOpen] = useState(false);
409
+ const [dateTime, setDateTime] = useState<Date | null>(new Date());
410
+
411
+ return (
412
+ <View style={{ padding: 20 }}>
413
+ <Button title="Pick Date & Time" onPress={() => setOpen(true)} />
414
+
415
+ <DatePicker
416
+ modal
417
+ open={open}
418
+ mode="datetime"
419
+ value={dateTime}
420
+ onChange={setDateTime}
421
+ onConfirm={(dt) => {
422
+ setDateTime(dt);
423
+ setOpen(false);
424
+ }}
425
+ onClose={() => setOpen(false)}
426
+ is24Hour={false}
427
+ minuteInterval={15}
428
+ format="DD/MM/YYYY hh:mm A"
429
+ accentColor="#4F46E5"
430
+ theme="dark"
431
+ />
432
+ </View>
433
+ );
434
+ }
435
+ ```
436
+
437
+ ---
438
+
439
+ ### 7. Date Range Picker (with Ribbon Highlights & Limit)
440
+
441
+ <div align="center">
442
+ <img src="assets/screenshots/range-picker.jpg" width="220" alt="Date Range Picker" />
443
+ </div>
444
+
445
+ Select start date and end date with interactive cards, direction arrow, range highlight ribbon, and maximum span limits:
446
+
447
+ ```tsx
448
+ import React, { useState } from 'react';
449
+ import { View, Button } from 'react-native';
450
+ import { DatePicker, DateRange } from '@izonnet-web-solution/react-native-date-picker-kit';
451
+
452
+ export default function DateRangeDemo() {
453
+ const [open, setOpen] = useState(false);
454
+ const [range, setRange] = useState<DateRange>({
455
+ startDate: new Date(),
456
+ endDate: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
457
+ });
458
+
459
+ return (
460
+ <View style={{ padding: 20 }}>
461
+ <Button title="Select Date Range" onPress={() => setOpen(true)} />
462
+
463
+ <DatePicker
464
+ modal
465
+ open={open}
466
+ mode="range"
467
+ startDate={range.startDate}
468
+ endDate={range.endDate}
469
+ onRangeChange={setRange}
470
+ onConfirm={(r) => {
471
+ if (r) setRange(r);
472
+ setOpen(false);
473
+ }}
474
+ onClose={() => setOpen(false)}
475
+ maxRangeDays={14}
476
+ accentColor="#8B5CF6"
477
+ theme="dark"
478
+ />
479
+ </View>
480
+ );
481
+ }
482
+ ```
483
+
484
+ ---
485
+
486
+ ### 8. Input Modal Picker (Tap-to-Open Field)
487
+
488
+ <div align="center">
489
+ <img src="assets/screenshots/input-modal-picker.jpg" width="220" alt="Input Modal Picker" />
490
+ </div>
491
+
492
+ A clean interactive input box with calendar icon that opens a synchronized popup picker:
493
+
494
+ ```tsx
495
+ import React, { useState } from 'react';
496
+ import { View } from 'react-native';
497
+ import { DatePicker } from '@izonnet-web-solution/react-native-date-picker-kit';
498
+
499
+ export default function InputPickerDemo() {
500
+ const [date, setDate] = useState<Date | null>(new Date());
501
+
502
+ return (
503
+ <View style={{ padding: 20 }}>
504
+ <DatePicker
505
+ mode="input"
506
+ value={date}
507
+ onChange={setDate}
508
+ onConfirm={setDate}
509
+ label="Appointment Date"
510
+ format="DD/MM/YYYY"
511
+ allowManualEntry={true}
512
+ accentColor="#8B5CF6"
513
+ />
514
+ </View>
515
+ );
516
+ }
517
+ ```
518
+
519
+ ---
520
+
521
+ ### 9. Strict Manual Keyboard Entry (Single Box & Split Pods)
522
+
523
+ <div align="center">
524
+ <img src="assets/screenshots/manual-entry-single.jpg" width="220" alt="Manual Entry Single Box" />
525
+ &nbsp;&nbsp;&nbsp;&nbsp;
526
+ <img src="assets/screenshots/manual-entry-split.jpg" width="220" alt="Manual Entry Split Pods" />
527
+ </div>
528
+
529
+ Enables direct numeric typing with validation feedback for leap years and month boundaries:
530
+
531
+ #### Single Box Mode:
532
+ ```tsx
533
+ <DatePicker
534
+ modal
535
+ open={open}
536
+ mode="calendar"
537
+ defaultManualMode={true}
538
+ allowManualEntry={true}
539
+ manualEntryType="single"
540
+ value={date}
541
+ onChange={setDate}
542
+ format="DD/MM/YYYY"
543
+ accentColor="#4F46E5"
544
+ />
545
+ ```
546
+
547
+ #### Split Pods Mode (Day, Month, Year discrete boxes with auto-focus):
548
+ ```tsx
549
+ <DatePicker
550
+ modal
551
+ open={open}
552
+ mode="calendar"
553
+ defaultManualMode={true}
554
+ allowManualEntry={true}
555
+ manualEntryType="split"
556
+ value={date}
557
+ onChange={setDate}
558
+ format="DD/MM/YYYY"
559
+ accentColor="#4F46E5"
560
+ />
561
+ ```
562
+
563
+ ---
564
+
565
+ ### 10. Standalone Component Usage
566
+
567
+ All sub-components are exported independently for custom layouts:
568
+
569
+ ```tsx
570
+ import {
571
+ Calendar,
572
+ WheelPicker,
573
+ RangePicker,
574
+ TimePicker,
575
+ ClockDial,
576
+ DateTimePicker,
577
+ DateInput,
578
+ ManualDateInput,
579
+ MonthYearSelectorModal,
580
+ } from '@izonnet-web-solution/react-native-date-picker-kit';
581
+ ```
582
+
583
+ ---
584
+
585
+ ## ๐ŸŽจ Modal & Color Customization
586
+
587
+ The library provides fine-grained control over colors and styles. When you specify `accentColor`, all primary components automatically adapt to that color:
588
+
589
+ ```tsx
590
+ <DatePicker
591
+ modal
592
+ open={open}
593
+ accentColor="#F43F5E" // Selected circles, buttons, highlights, dial needle
594
+ cardColor="#1E293B" // Modal dialog background color
595
+ modalBackgroundColor="#1E293B" // Dedicated modal container background
596
+ textColor="#F8FAFC" // Primary text color
597
+ borderRadius={20} // Modal & button corner radius
598
+ modalContentStyle={{ // Custom styling for inner modal container
599
+ paddingHorizontal: 20,
600
+ borderWidth: 1,
601
+ borderColor: 'rgba(255,255,255,0.1)',
602
+ }}
603
+ theme="dark"
604
+ ...
605
+ />
606
+ ```
607
+
608
+ ### What `accentColor` Controls:
609
+ 1. **Calendar**: Selected date circle background, Today indicator border and text.
610
+ 2. **Month & Year Selector**: Active month and year pill background, Confirm button background.
611
+ 3. **Range Picker**: Start and end date circles, connection ribbon background (`${accentColor}20`).
612
+ 4. **Time Picker / Clock Dial**: Selected hour/minute pills, analog clock needle, AM/PM active switch.
613
+ 5. **Action Buttons**: `Confirm` / `Apply` button background, `Today` and `Clear` button text, `Cancel` button border.
614
+ 6. **Input Fields**: Focus borders and calendar accessory icons.
615
+
616
+ ---
617
+
618
+ ## ๐Ÿ—‚๏ธ Month & Year Fast Navigator Modal
619
+
620
+ <div align="center">
621
+ <img src="assets/screenshots/month-year-selector-modal.jpg" width="220" alt="Month & Year Selector Modal" />
622
+ </div>
623
+
624
+ Tap the month header (e.g. **"November 2026 โ–พ"**) on any calendar to open the dedicated Month & Year selection sheet:
625
+ - Two smooth scrollable columns: **MONTH** (January to December) and **YEAR** (minYear to maxYear).
626
+ - **Auto-scroll**: Automatically scrolls to the currently selected month and year on open.
627
+ - **Nested Modal Transition**: If the calendar is inside a modal dialog, the parent modal hides smoothly while the Month & Year selector is open and re-opens seamlessly upon Confirm or Close โ€” preventing stacked modal conflicts or selection loss.
628
+
629
+ ---
630
+
631
+ ## ๐Ÿ”ค Dynamic Format Switcher Bar
632
+
633
+ Allow users to switch date formats on the fly by enabling `showFormatSelector`:
634
+
635
+ ```tsx
636
+ <DatePicker
637
+ mode="calendar"
638
+ showFormatSelector={true}
639
+ supportedFormats={['DD/MM/YYYY', 'MM/DD/YYYY', 'YYYY/DD/MM', 'YYYY/MM/DD']}
640
+ onFormatChange={(newFormat) => console.log('Format changed:', newFormat)}
641
+ ...
642
+ />
643
+ ```
644
+
645
+ ---
646
+
647
+ ## ๐Ÿ”ค Formatting Tokens Reference
648
+
649
+ ### Date Tokens
650
+ | Token | Description | Example |
651
+ |---|---|---|
652
+ | `YYYY` | 4-digit full year | `2026` |
653
+ | `YY` | 2-digit short year | `26` |
654
+ | `MMMM` | Full month name | `November` |
655
+ | `MMM` | Short 3-letter month name | `Nov` |
656
+ | `MM` | 2-digit month with leading zero | `01` โ€“ `12` |
657
+ | `M` | 1-digit month | `1` โ€“ `12` |
658
+ | `DD` | 2-digit day of month | `01` โ€“ `31` |
659
+ | `D` | 1-digit day of month | `1` โ€“ `31` |
660
+ | `dddd` | Full weekday name | `Friday` |
661
+ | `ddd` | Short weekday name | `Fri` |
662
+ | `dd` | Minimized weekday name | `Fr` |
663
+
664
+ ### Time Tokens
665
+ | Token | Description | Example |
666
+ |---|---|---|
667
+ | `HH` | 2-digit 24-hour clock | `00` โ€“ `23` |
668
+ | `H` | 1-digit 24-hour clock | `0` โ€“ `23` |
669
+ | `hh` | 2-digit 12-hour clock | `01` โ€“ `12` |
670
+ | `h` | 1-digit 12-hour clock | `1` โ€“ `12` |
671
+ | `mm` | 2-digit minute | `00` โ€“ `59` |
672
+ | `m` | 1-digit minute | `0` โ€“ `59` |
673
+ | `ss` | 2-digit second | `00` โ€“ `59` |
674
+ | `s` | 1-digit second | `0` โ€“ `59` |
675
+ | `A` | Uppercase meridiem | `AM` / `PM` |
676
+ | `a` | Lowercase meridiem | `am` / `pm` |
677
+
678
+ ---
679
+
680
+ ## ๐ŸŒ Multilingual Localization
681
+
682
+ Built-in translation dictionaries:
683
+ - **English** (`'en'`) โ€” Default
684
+ - **Hindi** (`'hi'`)
685
+ - **Gujarati** (`'gu'`)
686
+
687
+ ```tsx
688
+ <DatePicker
689
+ locale="hi" // Hindi labels ("เค†เคœ", "เคธเคพเคซเคผ เค•เคฐเฅ‡เค‚", "เคฐเคฆเฅเคฆ เค•เคฐเฅ‡เค‚", "เคชเฅเคทเฅเคŸเคฟ เค•เคฐเฅ‡เค‚")
690
+ ...
691
+ />
692
+ ```
693
+
694
+ ### Custom Locale Dictionary
695
+ You can pass a custom `DatePickerLocale` object:
696
+
697
+ ```tsx
698
+ import type { DatePickerLocale } from '@izonnet-web-solution/react-native-date-picker-kit';
699
+
700
+ const frenchLocale: DatePickerLocale = {
701
+ code: 'fr',
702
+ months: ['Janvier', 'Fรฉvrier', 'Mars', 'Avril', 'Mai', 'Juin', 'Juillet', 'Aoรปt', 'Septembre', 'Octobre', 'Novembre', 'Dรฉcembre'],
703
+ monthsShort: ['Jan', 'Fรฉv', 'Mar', 'Avr', 'Mai', 'Juin', 'Juil', 'Aoรปt', 'Sep', 'Oct', 'Nov', 'Dรฉc'],
704
+ weekdays: ['Dimanche', 'Lundi', 'Mardi', 'Mercredi', 'Jeudi', 'Vendredi', 'Samedi'],
705
+ weekdaysShort: ['Dim', 'Lun', 'Mar', 'Mer', 'Jeu', 'Ven', 'Sam'],
706
+ weekdaysMin: ['Di', 'Lu', 'Ma', 'Me', 'Je', 'Ve', 'Sa'],
707
+ today: "Aujourd'hui",
708
+ clear: 'Effacer',
709
+ cancel: 'Annuler',
710
+ confirm: 'Confirmer',
711
+ apply: 'Appliquer',
712
+ selectDate: 'Sรฉlectionner une date',
713
+ monthLabel: 'MOIS',
714
+ yearLabel: 'ANNร‰E',
715
+ errors: {
716
+ invalidDate: 'Date invalide',
717
+ outOfRange: 'Date hors limites',
718
+ minDate: 'La date ne peut pas รชtre antรฉrieure au minimum',
719
+ maxDate: 'La date ne peut pas dรฉpasser le maximum',
720
+ disabledDate: 'Cette date est dรฉsactivรฉe',
721
+ disabledWeekday: 'Ce jour est dรฉsactivรฉ',
722
+ startDateAfterEndDate: 'La date de dรฉbut doit prรฉcรฉder la date de fin',
723
+ maxRangeExceeded: 'Plage maximale dรฉpassรฉe',
724
+ invalidTime: 'Heure invalide',
725
+ minTime: "L'heure ne peut pas รชtre antรฉrieure au minimum",
726
+ maxTime: "L'heure ne peut pas dรฉpasser le maximum",
727
+ },
728
+ };
729
+
730
+ <DatePicker locale={frenchLocale} ... />
731
+ ```
732
+
733
+ ---
734
+
735
+ ## ๐ŸŽจ Themes & Styling Reference
736
+
737
+ ### Predefined Themes
738
+ - `theme="light"` (Default clean white background with slate text)
739
+ - `theme="dark"` (High-contrast obsidian theme with subtle borders)
740
+
741
+ ### `DatePickerTheme` Object Properties
742
+
743
+ ```typescript
744
+ interface DatePickerTheme {
745
+ backgroundColor: string;
746
+ surfaceColor: string;
747
+ cardColor: string;
748
+ primaryColor: string;
749
+ primaryTextColor: string;
750
+ textColor: string;
751
+ secondaryTextColor: string;
752
+ disabledTextColor: string;
753
+ borderColor: string;
754
+ selectedDayBackgroundColor: string;
755
+ selectedDayTextColor: string;
756
+ todayBorderColor: string;
757
+ todayTextColor: string;
758
+ rangeBetweenBackgroundColor: string;
759
+ rangeBetweenTextColor: string;
760
+ errorColor: string;
761
+ errorBackgroundColor: string;
762
+ borderRadius: number;
763
+ fontSize: {
764
+ small: number;
765
+ medium: number;
766
+ large: number;
767
+ title: number;
768
+ };
769
+ }
770
+ ```
771
+
772
+ ---
773
+
774
+ ## ๐Ÿ“– Comprehensive Props Reference
775
+
776
+ ### Core & Presentation Props
777
+
778
+ | Prop | Type | Default | Description |
779
+ |---|---|---|---|
780
+ | `mode` | `'calendar' \| 'wheel' \| 'range' \| 'input' \| 'time' \| 'datetime'` | `'calendar'` | Primary picker mode |
781
+ | `modal` | `boolean` | `false` | When `true`, presents picker in a popup modal dialog |
782
+ | `open` | `boolean` | `false` | Controls visibility in modal mode |
783
+ | `format` | `DateFormat` | `'DD/MM/YYYY'` | Date/Time format string |
784
+ | `theme` | `'light' \| 'dark' \| Partial<DatePickerTheme>` | `'light'` | Color theme or partial theme object |
785
+ | `locale` | `'en' \| 'hi' \| 'gu' \| DatePickerLocale` | `'en'` | Active language code or custom locale dictionary |
786
+ | `accentColor` | `string` | `undefined` | Live primary accent color override |
787
+ | `primaryColor` | `string` | `undefined` | Alias for `accentColor` |
788
+ | `cardColor` | `string` | `undefined` | Card / modal container background color |
789
+ | `modalBackgroundColor`| `string` | `undefined` | Dedicated modal container background override |
790
+ | `modalContentStyle` | `StyleProp<ViewStyle>` | `undefined` | Custom style applied to the modal dialog card |
791
+ | `borderRadius` | `number` | `12` | Corner radius override for cards and buttons |
792
+ | `style` | `StyleProp<ViewStyle>` | `undefined` | Custom container style |
793
+ | `testID` | `string` | `undefined` | Test identifier for automated testing |
794
+
795
+ ### Single Date & Calendar Props
796
+
797
+ | Prop | Type | Default | Description |
798
+ |---|---|---|---|
799
+ | `value` | `Date \| null` | `null` | Currently selected date value |
800
+ | `defaultValue` | `Date \| null` | `null` | Initial date value |
801
+ | `onChange` | `(date: Date \| null) => void` | `undefined` | Fired when date selection changes |
802
+ | `minimumDate` | `Date` | `undefined` | Earliest selectable date boundary |
803
+ | `maximumDate` | `Date` | `undefined` | Latest selectable date boundary |
804
+ | `disabledDates` | `(Date \| string)[] \| ((d: Date) => boolean)` | `undefined` | Array of disabled dates or filter function |
805
+ | `disabledWeekdays` | `number[]` | `undefined` | Days of week to disable (`0` = Sun, `6` = Sat) |
806
+ | `firstDayOfWeek` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6` | `0` | Column start day (`0` = Sun, `1` = Mon) |
807
+ | `autoCloseOnSelect` | `boolean` | `false` | Automatically confirm and close modal upon date cell tap |
808
+
809
+ ### Range Picker Props (`mode="range"`)
810
+
811
+ | Prop | Type | Default | Description |
812
+ |---|---|---|---|
813
+ | `startDate` | `Date \| null` | `null` | Range start date |
814
+ | `endDate` | `Date \| null` | `null` | Range end date |
815
+ | `defaultStartDate` | `Date \| null` | `null` | Initial start date |
816
+ | `defaultEndDate` | `Date \| null` | `null` | Initial end date |
817
+ | `onRangeChange` | `(range: DateRange) => void` | `undefined` | Fired when range changes |
818
+ | `maxRangeDays` | `number` | `undefined` | Maximum allowed range span in days |
819
+
820
+ ### Time & DateTime Props (`mode="time"` / `mode="datetime"`)
821
+
822
+ | Prop | Type | Default | Description |
823
+ |---|---|---|---|
824
+ | `is24Hour` | `boolean` | `false` | Enable 24-hour military clock or 12-hour AM/PM mode |
825
+ | `minuteInterval` | `1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 10 \| 12 \| 15 \| 20 \| 30` | `1` | Minute step intervals |
826
+ | `minimumTime` | `string \| Date` | `undefined` | Earliest allowable time (e.g. `"09:00 AM"` or `"09:00"`) |
827
+ | `maximumTime` | `string \| Date` | `undefined` | Latest allowable time (e.g. `"06:00 PM"` or `"18:00"`) |
828
+ | `showSeconds` | `boolean` | `false` | Show seconds column in time modes |
829
+ | `timePickerLayout` | `'wheel' \| 'spinner' \| 'input' \| 'segmented'` | `'wheel'` | Time picker presentation style |
830
+ | `initialTab` | `'date' \| 'time'` | `'date'` | Default active tab in datetime mode |
831
+
832
+ ### Wheel Picker Props (`mode="wheel"`)
833
+
834
+ | Prop | Type | Default | Description |
835
+ |---|---|---|---|
836
+ | `minYear` | `number` | `1970` | Minimum selectable year |
837
+ | `maxYear` | `number` | `2050` | Maximum selectable year |
838
+
839
+ ### Manual Input & Validation Props
840
+
841
+ | Prop | Type | Default | Description |
842
+ |---|---|---|---|
843
+ | `allowManualEntry` | `boolean` | `false` | Show keyboard toggle button in calendar header |
844
+ | `defaultManualMode` | `boolean` | `false` | Start with manual input view enabled by default |
845
+ | `manualEntryType` | `'single' \| 'split'` | `'single'` | Single text box vs 3 separate Day/Month/Year boxes |
846
+ | `placeholder` | `string` | `undefined` | Input placeholder text (`mode="input"`) |
847
+ | `label` | `string` | `undefined` | Input field label (`mode="input"`) |
848
+ | `editable` | `boolean` | `true` | Enable or disable input editing (`mode="input"`) |
849
+
850
+ ### Action Button & Callback Props
851
+
852
+ | Prop | Type | Default | Description |
853
+ |---|---|---|---|
854
+ | `showActionButtons` | `boolean` | `true` | Show footer action button row |
855
+ | `showTodayButton` | `boolean` | `true` | Show `Today` / `Now` button |
856
+ | `showClearButton` | `boolean` | `true` | Show `Clear` button |
857
+ | `showCancelButton` | `boolean` | `true` | Show `Cancel` button |
858
+ | `showConfirmButton` | `boolean` | `true` | Show `Confirm` / `Apply` button |
859
+ | `onConfirm` | `(value: any) => void` | `undefined` | Callback fired on Confirm / Apply press |
860
+ | `onCancel` | `() => void` | `undefined` | Callback fired on Cancel press |
861
+ | `onClear` | `() => void` | `undefined` | Callback fired on Clear press |
862
+ | `onClose` | `() => void` | `undefined` | Callback fired when modal is dismissed |
863
+
864
+ ### Format Switcher Props
865
+
866
+ | Prop | Type | Default | Description |
867
+ |---|---|---|---|
868
+ | `showFormatSelector` | `boolean` | `false` | Show format pills row above picker |
869
+ | `supportedFormats` | `DateFormat[]` | `['DD/MM/YYYY', 'MM/DD/YYYY', 'YYYY/DD/MM', 'YYYY/MM/DD']` | List of selectable formats |
870
+ | `onFormatChange` | `(format: DateFormat) => void` | `undefined` | Callback fired when format is changed |
871
+
872
+ ---
873
+
874
+ ## ๐Ÿ“ฆ Exported Components & Hooks
875
+
876
+ ### Components
877
+ - `DatePicker`: Main versatile picker component supporting all 8 modes.
878
+ - `Calendar`: Month grid calendar component.
879
+ - `WheelPicker`: 3D-feel Day/Month/Year wheel date picker.
880
+ - `RangePicker`: Date range picker component.
881
+ - `TimePicker`: Standalone time picker with dial and wheel layouts.
882
+ - `ClockDial`: Analog clock face component.
883
+ - `WheelTimePicker`: Wheel-based time picker.
884
+ - `DateTimePicker`: Combined date and time picker.
885
+ - `DateInput`: Text input field with embedded calendar icon.
886
+ - `ManualDateInput`: Manual keyboard entry component (Single & Split).
887
+ - `MonthYearSelectorModal`: Two-column month and year selector modal.
888
+ - `Modal`: Lightweight accessible backdrop modal dialog.
889
+ - `Button`: Themed button component.
890
+ - `IconButton`: Accessible icon button.
891
+
892
+ ### Utility Functions
893
+ - `formatDate(date, format, locale)`: Format Date object to tokenized string.
894
+ - `parseDate(dateString, format)`: Parse formatted string into Date object.
895
+ - `validateDate(date, options)`: Validate date against boundaries and disable rules.
896
+ - `isSameDay(date1, date2)`: Compare if two dates share the same day.
897
+ - `isToday(date)`: Check if date is today.
898
+ - `addDays(date, days)` / `subDays(date, days)`: Date addition/subtraction.
899
+ - `getDaysInMonth(year, month)`: Get number of days in specified month.
900
+
901
+ ### Hooks
902
+ - `useDatePicker`: Complete state management for calendar selection and manual entry.
903
+ - `useDateRange`: State management for date range selection.
904
+ - `useTimePicker`: State management for 12h/24h time selection and clock angle math.
905
+
906
+ ---
907
+
908
+ ## ๐Ÿงช Testing & Quality Assurance
909
+
910
+ The library comes with comprehensive Jest unit test suites covering:
911
+ - Date arithmetic & leap year calculations
912
+ - Format token parsing and serialization
913
+ - Range boundaries and max days constraint validation
914
+ - Business hours & operating time constraints
915
+ - Component mounting, user interactions, and callbacks
916
+
917
+ Run the test suite:
918
+
919
+ ```bash
920
+ npm test
921
+ ```
922
+
923
+ Build declarations and bundles:
924
+
925
+ ```bash
926
+ npm run build
927
+ ```
928
+
929
+ ---
930
+
931
+ ## ๐Ÿ”— Links & Resources
932
+
933
+ - ๐Ÿ“ฆ **GitHub Repository**: [https://github.com/Izonnet-Web-Solution/date-time-picker](https://github.com/Izonnet-Web-Solution/date-time-picker)
934
+ - ๐Ÿ“– **Documentation & Readme**: [https://github.com/Izonnet-Web-Solution/date-time-picker#readme](https://github.com/Izonnet-Web-Solution/date-time-picker#readme)
935
+ - ๐Ÿ› **Issue Tracker & Bug Reports**: [https://github.com/Izonnet-Web-Solution/date-time-picker/issues](https://github.com/Izonnet-Web-Solution/date-time-picker/issues)
936
+
937
+ ---
938
+
939
+ ## ๐Ÿ“„ License
940
+
941
+ MIT ยฉ [Izonnet Web Solution](https://github.com/Izonnet-Web-Solution)
942
+ Repository: [date-time-picker](https://github.com/Izonnet-Web-Solution/date-time-picker)
943
+ Authored by Jenil.