rn-grid-date-time-picker 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,90 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses [Semantic Versioning](https://semver.org/).
 
+## [1.2.0] - 2026-11-01
+
+1.2.0 lays out the Hijri tab right to left, gives it its own texts (`hijriStrings`), and lets a long field value scroll instead of ending in "…". No props or types were removed, but some defaults change what users see: check the Changed list if you use the Hijri or dual calendar (its layout, and AM / PM written ص / م), a right-to-left app (the time boxes mirror), or tests that match the field text or the layout.
+
+### Added
+
+- `hijriStrings`: the texts while the Hijri tab shows (e.g. Arabic), for its calendar and time rows, the error messages inside the picker (under its field, the calendar and the time rows), and a date picked in it. The on-screen field's errors keep `strings`, and so do the title, Confirm, Reset and the tabs. A key left out keeps AM / PM in `hijriLocale` (ص / م), then `strings`.
+- `hijriPeriods(locale)`: AM / PM as the Hijri tab writes them, so an app's own text (filter chips, summaries) matches the field. Its return type is exported as `Periods`.
+- The `fieldDateText` style key sets the date of a single date-time value apart from its time in the field, e.g. `{ minWidth: '50%' }` starts the time at the middle of the field.
+
+### Changed
+
+- **A string set to `undefined` (or `null`) keeps its default**, in `strings` and `hijriStrings`, instead of showing nothing. An app can pass every key and leave the ones it has no text for undefined.
+- **The Hijri tab reads right to left.** While a Hijri calendar shows, the calendar (header, month chips, weekdays, days, the year and month grids) and the time rows are laid out right to left, with the arrows and the month swipe mirrored, whatever the app's direction. The Gregorian / Hijri tabs, the field and the buttons keep the app's direction.
+- **AM / PM on the Hijri tab are written in `hijriLocale`** (ص / م for Arabic), in the time rows, and in the field when the date was picked in Hijri. The time rows' digits now follow the tab that shows, not the calendar the date was picked in.
+- **In a right-to-left layout the time boxes mirror**: the hour sits on the right, then the minutes, with AM / PM on the left (the wheels too). In a left-to-right app that's the Hijri tab only.
+- **A value too long for the field scrolls sideways** instead of being cut off with "…"; a tap still opens the picker. Right-to-left text (a Hijri date) opens scrolled to its start.
+- **In a typed date-time field the time sits in the middle** of the space between the date and the icons, instead of right after the date.
+- **The year and month grids have no top padding**; the header's margin already spaces the first row.
+
+### Fixed
+
+- **On Android the field no longer swaps the last word of its value for "…"** when the line is measured a pixel short (most often right-to-left text, such as the end of a Hijri range).
+
+## [1.1.0] - 2026-10-30
+
+1.1.0 reworks the Hijri calendar (Gregorian / Hijri tabs, a calendar switch, Arabic by default) and fixes issues found in real-device testing. It changes some 1.0.0 behaviour, listed below: most apps need no changes, but check this list if you use the Hijri or dual calendar, full `PickerStrings` / `ThemeTokens` objects, or tests that match `onChange` calls exactly.
+
+### Changes from 1.0.0 to check
+
+- **`calendarSystem="dual"`** shows Gregorian and Hijri as two tabs, one calendar at a time; it no longer writes the Hijri day under each Gregorian day. `styles.daySubLabel` is no longer drawn, and `renderDay` gets `subLabel: null`. Use `dualDefaultTab` to choose the tab it opens on. A date shows selected only in the tab it was picked in, and a tap in the other tab starts the selection over.
+- **A folded calendar stays mounted but hidden** while the keyboard is up, so it comes back on the month it showed. A test that checks `dp-calendar` is gone while folded should check that it's hidden instead.
+- **`calendarSystem="hijri"` is written in Arabic** (month and weekday names, Arabic digits), whatever the app's `locale`, and **the field shows the Hijri date** (e.g. "١٥ جمادى الأولى ١٤٤٨ هـ") instead of the Gregorian date in `dateFormat`. `hijriLocale={locale}` and `numerals="latin"` bring back 1.0.0's language and digits; the field still writes the date in Hijri. Values passed to `onChange` stay Gregorian.
+- **`onChange` gets a second argument**, `{ calendarSystem }`, when a Hijri calendar can show. Tests asserting `toHaveBeenCalledWith(value)` need `expect.anything()` added.
+- **Stored values must start with a full `YYYY-MM-DD` day.** Strings such as `'2026-10'`, `'2026'` or `'10:30'` now read as empty instead of being guessed, and so do a leading space, a lowercase `t` and six-digit years (`+002026-…`).
+- **Days outside `yearRange` are greyed**, like days outside `minDate` / `maxDate`.
+- **Outside days** (from the months before and after) use the new `outsideText` token, which follows `mutedText`, instead of `placeholder`.
+- **The built-in sheet's padding** is 8 at the bottom (was 24) and 24 above the title (was 8), plus the bottom safe-area inset, which the sheet now adds itself (see Added). If you added `insets.bottom` to `styles.sheet.paddingBottom` yourself, that still wins; you can drop it.
+- **From / To ranges:** a tap on a full range starts a new range (or moves the nearer end with `reselect: 'moveNearestEnd'`), instead of replacing To.
+- **`strings.errorRangeOrder`** now defaults to "The end date must be greater than the start date".
+
+### Added
+
+- `sheet.bottomInset`: the built-in sheet keeps the bottom safe-area inset (home indicator, Android's navigation bar) free below Confirm. By default it's read from `react-native-safe-area-context` when the app has a `SafeAreaProvider` (an optional peer dependency).
+- `calendarSwitch`: a Gregorian / Hijri / Dual switch above the calendar, with `onCalendarSystemChange`, `renderCalendarSwitch` and style keys for each part.
+- `dualDefaultTab`, `hijriLocale` and `numerals` (`'latin'`, `'arabic'` or `'locale'` digits; values stay 0–9).
+- `info.calendarSystem` in `onChange`: the calendar a date was picked in.
+- `hideCalendarOnKeyboard` (on by default, as the calendar folded in 1.0.0; `false` keeps it in view) and `sheet.keyboardMaxHeight`.
+- `strings.a11yClose` for the sheet backdrop's screen-reader label, which was always English.
+- `strings.dateTimeSeparator` (default `' '`): what goes between the date and the time in the field text and its placeholder.
+- `hijriDateText` and `arabicDigits`, the helpers the field uses to write a Hijri date and Arabic digits, so an app's own text (filter chips, summaries) matches the field.
+- New optional keys: `ThemeTokens.outsideText` and the `PickerStrings` keys `calendarGregorian`, `calendarHijri`, `calendarDual`, `a11yCalendarSystem` and `a11yClose`. A full 1.0.0 `ThemeTokens` or `PickerStrings` object still compiles.
+- Exported types: `ChangeInfo`, `CalendarSwitchRenderProps`, `CalendarSystem`, `Numerals`, `RangeRole`, `StyleKey`, `PickerStyleValue`.
+
+### Changed
+
+- A range end picked on the start's day starts an hour after the start (within the day's `timeBounds`), so a same-day date-time range isn't out of order before the user touches the time.
+- With `commitMode="instant"`, each value is saved once, and typing in the sheet's field saves when focus leaves it or its last box fills.
+- A controlled `visible` waits for the keyboard to close before opening, like the built-in open.
+- The sheet's body scrolls without a scroll bar, and day cells are read out from the platform's own month and weekday names.
+- `getConstraints` gets `yearRange` in `ctx.limits.minDate` / `maxDate`.
+- Time boxes and wheel columns are read out with their row's label ("Start time, Hour"), and a custom `renderMonthChip` keeps the chip's role, name and state.
+- A date typed in another month brings the calendar to that month; browsing without picking leaves it on the month you browsed to, folded or not.
+
+### Fixed
+
+- Android, edge-to-edge apps (the default from Android 15 / recent Expo): the sheet now sits above the keyboard instead of behind it, and Confirm no longer sits under the navigation bar's Back / Home buttons.
+- A date typed or pasted with separators and no padding (`1/12/2025`) reads as 1 December, not 11 February.
+- The field writes AM / PM with `strings.am` / `strings.pm`, like the time row.
+- A minute off the wheel's step shows at the nearest row, not 00.
+- Multiple dates saved with different times keep them on Confirm; before, every date took the first date's time. A day listed twice counts once.
+- Instant mode no longer saves twice on a tap, again on parent re-renders while `value` catches up, or values half-way through typing; a date still being typed is saved when the sheet closes.
+- A controlled `calendarSystem` fed from `onCalendarSystemChange` keeps each selection in one calendar, and typing in the on-screen field keeps the saved date's calendar.
+- Limits built with `dependsOnNow` refresh every minute while the picker is open.
+- Holidays load for the next or previous year when the grid shows its days (a Hijri month running into January, December's outside days).
+- From / To: tapping the start again deselects it instead of leaving the range stuck.
+- A folded calendar comes back on the month and view it showed.
+- The sheet keeps some room under a keyboard as tall as the window, knows a keyboard that's already up, and reads it as down once it has hidden on iOS.
+- RTL chevrons and the selected month chip, digits typed in Arabic and Persian, the date order on Hermes for Android and iOS `ar-SA`, iOS month and weekday names, and scrolling the sheet from the calendar grid.
+
+### Performance
+
+- A tap redraws only the day cells that changed, not all 42, and Hijri dates are worked out once.
+
 ## [1.0.0] - 2026-10-27
 
 Initial release.
@@ -37,4 +121,6 @@ Initial release.
 - `dateFormat` in any case (`'dd/mm/yyyy'`). A format the picker can't use warns in development and falls back to the locale order.
 - Accessibility labels and states, reduce-motion support, a font-scale cap and RTL mirroring. On iOS every typed box gets a Done button above the number pad, and errors are announced to VoiceOver.
 
+[1.2.0]: https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/releases/tag/v1.0.0