rn-grid-date-time-picker 0.0.0-stage → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,101 @@
+# Changelog
+
+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.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.
+
+### Added
+
+- `DateTimePicker` for dates and date-times, in `single`, `multiple` and `range` modes (one field or From / To), as a bottom sheet or inline. Range lengths (`minDays` / `maxDays`) count calendar days, both ends included.
+- String values in `'iso'` (default) or `'utc-midnight'` format, or through your own `ValueAdapter`.
+- Typed segments in the field, typed time boxes or a wheel, 12- / 24-hour, minute steps that divide the hour.
+- Limits: `minDate` / `maxDate`, `disabledWeekdays`, `disabledDates` / `enabledDates`, `timeBounds`, `holidays` / `loadHolidays` / `disableHolidays`, and `getConstraints` for full control. `createConstraints` is exported.
+- Gregorian, dual and Hijri (Umm al-Qura) calendars, with a Gregorian fallback.
+- Locale-based defaults for the date order and the clock (through `Intl`) and for the first day of the week (from the locale's region).
+- Theme tokens, `styles` keys for every part, `strings` for every text, and render props for the sheet, field, label, instruction, days, cells and time row.
+- The system font by default, so there's nothing to load. `INTER_FONTS` switches to Inter (`Inter-Regular`, `Inter-Medium`, `Inter-SemiBold`, loaded by the app); `SYSTEM_FONTS` switches back.
+- A `fontFamily` token that sets the font for all text, next to the per-weight `fontRegular` / `fontMedium` / `fontSemiBold`.
+- `icons` replaces any icon with your own component or hides it, and `iconProps` sets each icon's colour, disabled colour, size, width and height.
+- `renderField` receives `displayText` and `clear`, so your own input can show the value and clear it. `renderTimeRow` receives `time`, `rangeTimes` and `setTime`, so your own time row can change the time.
+- `initialVisibleDate` opens an empty calendar on a chosen month (e.g. for a date of birth).
+- `sheet` sets the sheet's `height` and `maxHeight`, whether the header and footer stay fixed or scroll with the body, and whether the field above the calendar shows (`showField`, `fieldPlaceholder`), and whether that field shows the calendar icon (`fieldIcon`).
+- Placeholder strings for the typed segments and time boxes (`placeholderDay`, `placeholderMonth`, `placeholderYear`, `placeholderHour`, `placeholderHour24`, `placeholderMinute`).
+- `precision: 'month' | 'year'` picks a whole month or year: the month or year grid is the last step, the saved value is the period's first day, the field shows "March 2026" / "2026", and a period can be picked when any day in it can. The current month or year is outlined (`monthCellCurrent`, `yearCellCurrent`).
+- `strings.rangeSeparator` (default `' – '`) joins the two ends of a range in the field text.
+- `fieldTextDisabled` style key for the value's text while the field is disabled.
+- With `commitMode="instant"`, × in the field above the calendar clears the saved value (`onChange('')`), not just the selection.
+- Text style keys for every text: `yearCellText`, `monthCellText`, `daySubLabel`, `timeBoxText`, `ampmOptionText`, `wheelText`, `todayButtonText`, `fieldPeriodText`.
+- `validate` runs your own check before a value is saved (on Confirm, with `commitMode="instant"`, and when typing in the on-screen field) and shows its message (`styles.validationText`).
+- Times are checked when Confirm is pressed, not while typing; `onError` reports the time problem.
+- Typed segments handle fast input (hardware keyboards, autofill) without dropping or doubling digits, and a full last box can still be corrected.
+- With `allowFieldTyping`, the on-screen field saves once typing pauses (focus leaves it or its last box fills), not on every complete value.
+- A date typed into the field takes the time already entered in the time row, so Confirm works without retyping it.
+- In 12-hour mode a typed time reads as AM until switched; segment boxes grow with the font size and system text size, and the time wraps to a second line instead of overlapping the icons.
+- A bad `minuteStep`, an unknown `timeZone` or a throwing custom `parse` falls back with a development warning instead of crashing.
+- `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.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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bhairavi M
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,177 @@
-# Temporary Holding Version
+# rn-grid-date-time-picker
 
-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.
+[![npm version](https://img.shields.io/npm/v/rn-grid-date-time-picker)](https://www.npmjs.com/package/rn-grid-date-time-picker)
+![Platforms](https://img.shields.io/badge/platforms-iOS%20%7C%20Android%20%7C%20Expo%20Go-blue)
+[![types](https://img.shields.io/npm/types/rn-grid-date-time-picker)](https://www.npmjs.com/package/rn-grid-date-time-picker)
+
+A themeable date and time picker for React Native: one date, several dates or a range, typed or tapped, with limits, holidays and the Hijri calendar. Pure JS, so there's nothing native to install. It runs on iOS and Android and works in Expo Go.
+
+<!-- Absolute URLs so the screenshots also show on npmjs.com. -->
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Bhairavi-ancy/rn-grid-date-time-picker/main/docs/screenshots.png" width="760" alt="The bottom sheet three ways: a date picked, a From / To date range, and a date with a typed time" />
+</p>
+
+<!--
+  Live demo: after publishing, create a Snack (see CONTRIBUTING.md) and uncomment.
+  The query offers only Expo Go, iOS and Android (no web) and opens on Android.
+
+**[Try it in Expo Snack →](https://snack.expo.dev/@your-account/rn-grid-date-time-picker?supportedPlatforms=mydevice,ios,android&platform=android)**
+-->
+
+## Why this picker
+
+- **Every kind of pick**: one date, several dates, or a range in one field or as From / To, with or without a time. Month-and-year and year-only picks too.
+- **Typed or tapped**: users type the date and time, or pick them on the calendar. Time is typed boxes or a scrolling wheel, 12- or 24-hour, in minute steps.
+- **Only the days you allow**: block past dates, weekends, holidays loaded from your server, booked days, or hours outside opening times.
+- **Saves only on Confirm**: by default `onChange` fires once, when the user confirms, and closing the sheet never touches your value. `commitMode="instant"` saves each edit instead.
+- **Gregorian, Hijri or both**: a Hijri (Umm al-Qura) calendar written in Arabic, Gregorian and Hijri tabs, or a switch between them. Layouts mirror in RTL.
+- **Your design**: colours, fonts, corners and every text, a style for every part, or your own field, sheet and day cells.
+- **Accessible and light**: every control is labelled for screen readers, reduce motion is respected, and the only dependency is [Luxon](https://moment.github.io/luxon/).
+
+## Hijri and Arabic
+
+<img align="right" src="https://raw.githubusercontent.com/Bhairavi-ancy/rn-grid-date-time-picker/main/docs/hijri-dual.png" width="200" alt="Gregorian and Hijri tabs, the Hijri month in Arabic" />
+
+`calendarSystem="hijri"` lays out Hijri months, days and years in Arabic, whatever your app's language. `"dual"` shows Gregorian and Hijri as two tabs, and `calendarSwitch` lets users switch for themselves. Values stay plain Gregorian strings, so your API doesn't change.
+
+```tsx
+<DateTimePicker
+  type="date"
+  value={value}
+  onChange={setValue}
+  calendarSystem="dual"
+/>
+```
+
+More in [Locale, RTL and Hijri](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/localization.md).
+
+<br clear="right" />
+
+## Make it yours
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Bhairavi-ancy/rn-grid-date-time-picker/main/docs/theme-blue-sharp.png" width="200" alt="Blue accent, square corners" />
+  <img src="https://raw.githubusercontent.com/Bhairavi-ancy/rn-grid-date-time-picker/main/docs/theme-teal.png" width="200" alt="Teal accent, medium corners" />
+  <img src="https://raw.githubusercontent.com/Bhairavi-ancy/rn-grid-date-time-picker/main/docs/theme-coral-round.png" width="200" alt="Coral accent, round corners" />
+</p>
+
+One `theme` prop sets the colours, fonts, corners and sizes. Each of the sheets above is one line:
+
+```tsx
+const blue = { accent: '#2563EB', rangeFill: '#DBEAFE', radius: 4 };
+const teal = { accent: '#0F766E', rangeFill: '#CCFBF1', radius: 8 };
+const coral = { accent: '#D9434B', rangeFill: '#FDE2E2', radius: 16 };
+
+<DateTimePicker type="date" value={value} onChange={setValue} theme={teal} />
+```
+
+Every text can be changed with `strings`, every part has a style key in `styles`, and the field, sheet and day cells can be your own components. See [Theming, fonts and icons](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/theming.md).
+
+## Install
+
+```sh
+npm i rn-grid-date-time-picker
+# or
+yarn add rn-grid-date-time-picker
+```
+
+There are no native steps. `react` (18 or later) and `react-native` (0.71 or later) are peer dependencies.
+
+## Quick start
+
+```tsx
+import { useState } from 'react';
+import DateTimePicker, { type PickerValue } from 'rn-grid-date-time-picker';
+
+export function DueDate() {
+  const [value, setValue] = useState<PickerValue>('');
+  return (
+    <DateTimePicker
+      type="date"
+      label="Due date"
+      value={value} // '2026-10-24'
+      onChange={setValue}
+    />
+  );
+}
+```
+
+A date-time value:
+
+```tsx
+<DateTimePicker
+  type="datetime"
+  value={startsAt} // '2026-10-24T10:00:00.000Z'
+  onChange={setStartsAt}
+  timeZone="Europe/London"
+  minuteStep={15}
+/>
+```
+
+A range:
+
+```tsx
+<DateTimePicker
+  type="date"
+  mode="range"
+  range={{ layout: 'fromTo', minDays: 1, maxDays: 14 }}
+  value={stay} // { from: '2026-10-24', to: '2026-10-27' }
+  onChange={setStay}
+/>
+```
+
+Values are strings, so they go straight into a form, a store or an API. See [Values](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/values.md) for other formats.
+
+## Common props
+
+| Prop | Type | Default | What it does |
+|---|---|---|---|
+| `type` | `'date' \| 'datetime'` | required | A date, or a date and time |
+| `mode` | `'single' \| 'multiple' \| 'range'` | `'single'` | One date, several, or a range |
+| `value` / `onChange` | `PickerValue` | required | The saved value; `onChange` fires on Confirm |
+| `presentation` | `'sheet' \| 'inline'` | `'sheet'` | A bottom sheet, or in place on the page |
+| `label`, `placeholder` | `string` | – | The field's label and placeholder |
+| `allowTyping` | `boolean` | `false` | Type the date and time in the sheet |
+| `allowClear` | `boolean` | `false` | An × that clears the value |
+| `minDate`, `maxDate` | `{ year, month, day }` | – | The first and last days that can be picked |
+| `disabledWeekdays` | `Weekday[]` | `[]` | Weekdays that can't be picked, e.g. `[6, 7]` |
+| `holidays`, `loadHolidays` | `string[]`, `(year) => Promise<string[]>` | – | Holidays to mark, or to block with `disableHolidays` |
+| `timeInput` | `'typed' \| 'wheel'` | `'typed'` | Typed time boxes or a scrolling wheel |
+| `timeFormat` | `'12h' \| '24h'` | from `locale` | The clock |
+| `minuteStep` | `number` | `1` | Minutes in steps, e.g. `15` |
+| `locale` | BCP-47 tag | the device's | Month and weekday names, date order, first day of the week |
+| `calendarSystem` | `'gregory' \| 'dual' \| 'hijri'` | `'gregory'` | The calendar |
+| `theme` | `Partial<ThemeTokens>` | – | Colours, fonts, corners and sizes |
+| `strings` | `Partial<PickerStrings>` | English | Every visible and spoken text |
+
+Every other prop is in [Props](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/props.md).
+
+## How do I…
+
+- **Grey out past days, weekends or booked days?** [Limits and validation](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/limits.md)
+- **Check a value with my own rule on Confirm?** [Your own validation](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/limits.md#your-own-validation)
+- **Store epoch milliseconds or UTC midnight?** [Values](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/values.md)
+- **Change the sheet, or show the picker inline?** [Sheet, field and time](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/presentation.md)
+- **Use my own input or my own sheet?** [Your own input](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/presentation.md#your-own-input)
+- **Pick only a month and year?** `precision="month"` in [Props](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/props.md#calendar)
+- **Match my app's colours, fonts and icons?** [Theming, fonts and icons](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/theming.md)
+- **Translate the texts?** [Strings and i18n](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/localization.md#strings--i18n)
+- **Find the testIDs for my tests?** [Accessibility and testing](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/testing.md)
+
+All pages: [docs](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/README.md).
+
+## Platform support
+
+- **iOS and Android**, in Expo Go and bare React Native apps. Web is untested.
+- **Hijri** needs the platform's `Intl` support for the Islamic calendar. Some Hermes builds on Android lack it, and the picker then falls back to Gregorian.
+- **The built-in sheet** sits on the keyboard while it's up, and keeps the home indicator or Android's navigation bar free below Confirm, read from `react-native-safe-area-context` when your app has it, or from `sheet.bottomInset`.
+
+Other known limits are listed in the [docs](https://github.com/Bhairavi-ancy/rn-grid-date-time-picker/blob/main/docs/README.md#platform-support-and-known-limits).
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the setup, scripts and the example app.
+
+## License
+
+MIT © 2026 Bhairavi M. See [LICENSE](LICENSE).

package/lib/commonjs/adapters/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "isoAdapter", {
+  enumerable: true,
+  get: function () {
+    return _iso.isoAdapter;
+  }
+});
+exports.resolveAdapter = void 0;
+Object.defineProperty(exports, "utcMidnightAdapter", {
+  enumerable: true,
+  get: function () {
+    return _utcMidnight.utcMidnightAdapter;
+  }
+});
+var _iso = require("./iso.js");
+var _utcMidnight = require("./utcMidnight.js");
+/** The adapter for a `valueFormat` prop (default 'iso'). */
+const resolveAdapter = (valueFormat = 'iso') => {
+  if (valueFormat === 'iso') return _iso.isoAdapter;
+  if (valueFormat === 'utc-midnight') return _utcMidnight.utcMidnightAdapter;
+  return valueFormat;
+};
+exports.resolveAdapter = resolveAdapter;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_iso","require","_utcMidnight","resolveAdapter","valueFormat","isoAdapter","utcMidnightAdapter","exports"],"sourceRoot":"../../../src","sources":["adapters/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;AACA,IAAAA,IAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAIA;AACO,MAAME,cAAc,GAAGA,CAC5BC,WAAwB,GAAG,KAAK,KACf;EACjB,IAAIA,WAAW,KAAK,KAAK,EAAE,OAAOC,eAAU;EAC5C,IAAID,WAAW,KAAK,cAAc,EAAE,OAAOE,+BAAkB;EAC7D,OAAOF,WAAW;AACpB,CAAC;AAACG,OAAA,CAAAJ,cAAA,GAAAA,cAAA","ignoreList":[]}

package/lib/commonjs/adapters/iso.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isoAdapter = void 0;
+var _calendarDate = require("../core/calendarDate.js");
+var _utcMidnight = require("./utcMidnight.js");
+/**
+ * `valueFormat: 'iso'` (the default):
+ * - date:      'YYYY-MM-DD'; anything else is invalid;
+ * - date-time: the same as 'utc-midnight', a UTC ISO instant with seconds and
+ *   milliseconds zeroed, read and written in `timeZone`.
+ *
+ * There is no `formatUnchanged`: an untouched Confirm emits the stored string as it came in.
+ */
+
+const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+const isoAdapter = exports.isoAdapter = {
+  parse: (raw, {
+    type,
+    timeZone
+  }) => {
+    if (type === 'datetime') return (0, _utcMidnight.parseInstant)(raw, timeZone);
+    if (!raw || !DATE_ONLY.test(raw)) return null;
+    const date = (0, _calendarDate.fromDateKey)(raw);
+    return date && (0, _calendarDate.isValidCalendarDate)(date) ? {
+      date,
+      time: null
+    } : null;
+  },
+  format: (value, {
+    type,
+    timeZone
+  }) => {
+    if (type === 'datetime') return (0, _utcMidnight.formatInstant)(value, timeZone);
+    return value && (0, _calendarDate.isValidCalendarDate)(value.date) && (0, _utcMidnight.isWritableYear)(value.date.year) ? (0, _calendarDate.toDateKey)(value.date) : '';
+  }
+};
+//# sourceMappingURL=iso.js.map

package/lib/commonjs/adapters/iso.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_calendarDate","require","_utcMidnight","DATE_ONLY","isoAdapter","exports","parse","raw","type","timeZone","parseInstant","test","date","fromDateKey","isValidCalendarDate","time","format","value","formatInstant","isWritableYear","year","toDateKey"],"sourceRoot":"../../../src","sources":["adapters/iso.ts"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA;AAMA,IAAAC,YAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAME,SAAS,GAAG,qBAAqB;AAEhC,MAAMC,UAAwB,GAAAC,OAAA,CAAAD,UAAA,GAAG;EACtCE,KAAK,EAAEA,CAACC,GAAG,EAAE;IAAEC,IAAI;IAAEC;EAAS,CAAC,KAAK;IAClC,IAAID,IAAI,KAAK,UAAU,EAAE,OAAO,IAAAE,yBAAY,EAACH,GAAG,EAAEE,QAAQ,CAAC;IAC3D,IAAI,CAACF,GAAG,IAAI,CAACJ,SAAS,CAACQ,IAAI,CAACJ,GAAG,CAAC,EAAE,OAAO,IAAI;IAC7C,MAAMK,IAAI,GAAG,IAAAC,yBAAW,EAACN,GAAG,CAAC;IAC7B,OAAOK,IAAI,IAAI,IAAAE,iCAAmB,EAACF,IAAI,CAAC,GAAG;MAAEA,IAAI;MAAEG,IAAI,EAAE;IAAK,CAAC,GAAG,IAAI;EACxE,CAAC;EACDC,MAAM,EAAEA,CAACC,KAAK,EAAE;IAAET,IAAI;IAAEC;EAAS,CAAC,KAAK;IACrC,IAAID,IAAI,KAAK,UAAU,EAAE,OAAO,IAAAU,0BAAa,EAACD,KAAK,EAAER,QAAQ,CAAC;IAC9D,OAAOQ,KAAK,IACV,IAAAH,iCAAmB,EAACG,KAAK,CAACL,IAAI,CAAC,IAC/B,IAAAO,2BAAc,EAACF,KAAK,CAACL,IAAI,CAACQ,IAAI,CAAC,GAC7B,IAAAC,uBAAS,EAACJ,KAAK,CAACL,IAAI,CAAC,GACrB,EAAE;EACR;AACF,CAAC","ignoreList":[]}

package/lib/commonjs/adapters/utcMidnight.js

@@ -0,0 +1,125 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.utcMidnightAdapter = exports.parseInstant = exports.isWritableYear = exports.formatInstant = void 0;
+var _luxon = require("luxon");
+var _calendarDate = require("../core/calendarDate.js");
+var _zoned = require("../core/zoned.js");
+/**
+ * `valueFormat: 'utc-midnight'`:
+ * - date:      'YYYY-MM-DDT00:00:00.000Z', the calendar day (never shifted by a zone);
+ * - date-time: a UTC ISO string with seconds and milliseconds zeroed.
+ *
+ * `zone` is passed in by the caller; this module never reads the device zone.
+ */
+
+const isValidTime = t => !!t && Number.isInteger(t.hour) && Number.isInteger(t.minute) && t.hour >= 0 && t.hour <= 23 && t.minute >= 0 && t.minute <= 59;
+
+/** Years that ISO strings write with four digits, so they read back the same. */
+const isWritableYear = year => year >= 1 && year <= 9999;
+
+/**
+ * A stored value must start with a full day: Luxon also reads '10:30' (today),
+ * '2026' or week and ordinal dates, which aren't dates the picker saved.
+ */
+exports.isWritableYear = isWritableYear;
+const STARTS_WITH_DAY = /^\d{4}-\d{2}-\d{2}(?:T|$)/;
+
+/**
+ * A stored instant → its day and wall-clock time in `zone`, or null when it
+ * can't be parsed. Shared by every built-in format for date-time values.
+ */
+const parseInstant = (value, zone) => {
+  if (!value || !STARTS_WITH_DAY.test(value)) return null;
+  const utc = _luxon.DateTime.fromISO(value, {
+    zone: 'utc'
+  });
+  if (!utc.isValid) return null;
+  const local = utc.setZone(zone);
+  if (!local.isValid || !isWritableYear(local.year)) return null;
+  return {
+    date: (0, _calendarDate.calendarDateOf)(local),
+    time: {
+      hour: local.hour,
+      minute: local.minute
+    }
+  };
+};
+
+/**
+ * A date-time value → a UTC ISO instant (seconds and ms zeroed), or '' when it
+ * is incomplete. Shared by every built-in format for date-time values.
+ */
+exports.parseInstant = parseInstant;
+const formatInstant = (value, zone) => {
+  if (!value || !(0, _calendarDate.isValidCalendarDate)(value.date)) return '';
+  if (!isValidTime(value.time)) return '';
+  const utc = (0, _zoned.toZonedDateTime)(value, zone).toUTC();
+  // A day near year 1 or 9999 can fall in year 0 or 10000 in UTC.
+  return utc.isValid && isWritableYear(utc.year) ? utc.toISO() ?? '' : '';
+};
+
+/** Saved string → picker value. Returns null for '' or an unparsable string. */
+exports.formatInstant = formatInstant;
+const fromWire = (value, type, zone) => {
+  if (!value) return null;
+  if (type !== 'date') return parseInstant(value, zone);
+  if (!STARTS_WITH_DAY.test(value)) return null;
+  // The calendar day as written: an offset in the string ('+05:30') is kept,
+  // not converted to UTC, so the day never moves.
+  const written = _luxon.DateTime.fromISO(value, {
+    setZone: true
+  });
+  if (!written.isValid || !isWritableYear(written.year)) return null;
+  return {
+    date: (0, _calendarDate.calendarDateOf)(written),
+    time: null
+  };
+};
+
+/**
+ * Picker value → saved string. Returns '' when the value is incomplete
+ * (no valid day, or a date-time without a valid time).
+ */
+const toWire = (value, type, zone) => {
+  if (!value || !(0, _calendarDate.isValidCalendarDate)(value.date)) return '';
+  if (!isWritableYear(value.date.year)) return '';
+  if (type === 'date') {
+    return _luxon.DateTime.utc(value.date.year, value.date.month, value.date.day).toISO() ?? '';
+  }
+  return formatInstant(value, zone);
+};
+
+/**
+ * What to emit when the user confirms without changing anything.
+ * - date-time keeps the stored instant, including seconds/ms (re-serialised as UTC ISO);
+ * - date re-serialises the stored day, as written, as UTC midnight.
+ * Returns '' for an unparsable value.
+ */
+const unchangedWire = (value, type) => {
+  if (!value) return '';
+  if (type === 'datetime') {
+    if (!STARTS_WITH_DAY.test(value)) return '';
+    const dt = _luxon.DateTime.fromISO(value, {
+      zone: 'utc'
+    });
+    return dt.isValid ? dt.toUTC().toISO() ?? '' : '';
+  }
+  return toWire(fromWire(value, 'date', 'utc'), 'date', 'utc');
+};
+const utcMidnightAdapter = exports.utcMidnightAdapter = {
+  parse: (raw, {
+    type,
+    timeZone
+  }) => fromWire(raw, type, timeZone),
+  format: (value, {
+    type,
+    timeZone
+  }) => toWire(value, type, timeZone),
+  formatUnchanged: (raw, {
+    type
+  }) => unchangedWire(raw, type)
+};
+//# sourceMappingURL=utcMidnight.js.map

package/lib/commonjs/adapters/utcMidnight.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_luxon","require","_calendarDate","_zoned","isValidTime","t","Number","isInteger","hour","minute","isWritableYear","year","exports","STARTS_WITH_DAY","parseInstant","value","zone","test","utc","DateTime","fromISO","isValid","local","setZone","date","calendarDateOf","time","formatInstant","isValidCalendarDate","toZonedDateTime","toUTC","toISO","fromWire","type","written","toWire","month","day","unchangedWire","dt","utcMidnightAdapter","parse","raw","timeZone","format","formatUnchanged"],"sourceRoot":"../../../src","sources":["adapters/utcMidnight.ts"],"mappings":"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","ignoreList":[]}