react-native-platform-components 1.4.0 → 1.5.0

package/lib/module/ButtonNativeComponent.ts

@@ -1,7 +1,12 @@
 // ButtonNativeComponent.ts
 import type { ColorValue, HostComponent, ViewProps } from 'react-native';
 import { codegenNativeComponent } from 'react-native';
-import type { BubblingEventHandler, Double } from './codegenTypes';
+import type {
+  BubblingEventHandler,
+  Double,
+  Int32,
+  WithDefault,
+} from './codegenTypes';
 
 /**
  * Icon fields, pre-resolved on the JS side (see icons.ts).
@@ -9,6 +14,7 @@ import type { BubblingEventHandler, Double } from './codegenTypes';
 export type ButtonIconProps = Readonly<{
   iconType: string; // '' | 'sfSymbol' | 'drawable' | 'image'
   iconName: string; // SF Symbol (iOS) or drawable resource name (Android)
+  iconRequest: string;
   iconUri: string; // Resolved image URI when iconType === 'image'
   iconScale: Double; // Resolved image scale when iconType === 'image'
   iconTinted: string; // 'true' | 'false' — draw the image as a tinted template
@@ -24,14 +30,77 @@ export type ButtonLabelStyleProps = Readonly<{
   fontStyle?: string; // 'normal' | 'italic'
 }>;
 
+/**
+ * One menu item, the shape of `ContextMenuItem`: the JS action tree is
+ * flattened (see `menuItems.ts`) and each item points at its parent submenu
+ * or section by index. Every field is set; empty strings mean "none" and
+ * flags are 'true' | 'false'.
+ */
+export type ButtonMenuItem = Readonly<{
+  id: string;
+  title: string;
+  subtitle: string;
+  /** Index of the parent submenu or section; -1 at the top level */
+  parent: Int32;
+  /** 'action' | 'menu' | 'section' */
+  kind: string;
+  /** '' | 'sfSymbol' | 'drawable' | 'image' */
+  iconType: string;
+  iconName: string;
+  iconRequest: string;
+  iconUri: string;
+  iconScale: Double;
+  iconTinted: string;
+  imageColor: string;
+  destructive: string;
+  disabled: string;
+  keepsMenuPresented: string;
+  /** '' | 'off' | 'on' | 'mixed' */
+  state: string;
+  /** The action's own haptics; '' = the component's */
+  haptics: string;
+}>;
+
+/** Event emitted when a toggle button is pressed. */
+export type ButtonSelectedChangeEvent = Readonly<{
+  /** The selection the press asks for */
+  selected: boolean;
+}>;
+
+/** Event emitted when a menu item is picked. */
+export type ButtonMenuSelectEvent = Readonly<{
+  id: string;
+  title: string;
+}>;
+
+/**
+ * iOS-specific configuration.
+ */
+export type ButtonIOSProps = Readonly<{
+  /** '' | 'bounce' | 'pulse' | 'variableColor' | 'wiggle' | 'rotate' | 'breathe' */
+  symbolEffect?: string;
+
+  /**
+   * '' runs the effect indefinitely; otherwise it plays once each time this
+   * value changes.
+   */
+  symbolEffectTrigger?: string;
+}>;
+
 export interface ButtonNativeProps extends ViewProps {
   /** Button text. Empty for an icon-only button. */
   label?: string;
 
-  /** Icon shown before the label, or alone when there is no label. */
+  /** Icon shown next to the label, or alone when there is no label. */
   icon?: ButtonIconProps;
 
-  /** 'filled' | 'tonal' | 'outlined' | 'text' | 'elevated' */
+  /** 'leading' | 'trailing' | 'top' | 'bottom' */
+  iconPosition?: string;
+
+  /**
+   * 'filled' | 'tonal' | 'outlined' | 'text' | 'elevated' | 'glass' |
+   * 'prominentGlass' | 'clearGlass' | 'prominentClearGlass'
+   */
   variant?: string;
 
   /** 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' */
@@ -40,15 +109,27 @@ export interface ButtonNativeProps extends ViewProps {
   /** '' (platform default) | 'round' | 'square' */
   shape?: string;
 
+  /** Corner radius in points; negative = use `shape`. */
+  cornerRadius?: WithDefault<Double, -1>;
+
   /** 'enabled' | 'disabled' */
   interactivity?: string;
 
+  /** 'true' | 'false': spinner in place of the label and icon, presses ignored. */
+  loading?: string;
+
   /** Container (background) color. */
   color?: ColorValue;
 
   /** Label and icon color. */
   foregroundColor?: ColorValue;
 
+  /** Container color while disabled; unset = platform disabled look. */
+  disabledColor?: ColorValue;
+
+  /** Label and icon color while disabled; unset = platform disabled look. */
+  disabledForegroundColor?: ColorValue;
+
   /** Android: ripple color shown while pressing. */
   androidRippleColor?: ColorValue;
 
@@ -61,14 +142,49 @@ export interface ButtonNativeProps extends ViewProps {
   /** Label font. */
   labelStyle?: ButtonLabelStyleProps;
 
+  /** Cap on the label's font scaling; 0 (or below 1) = no cap. */
+  maxFontSizeMultiplier?: Double;
+
   /**
    * Screen-reader label, applied to the native button rather than the host
    * view. Empty means "use the label".
    */
   spokenLabel?: string;
 
+  /** '' (not a toggle) | 'true' | 'false': the controlled toggle state. */
+  selected?: string;
+
+  /**
+   * Bumped by JS after every onSelectedChange, so native applies `selected`
+   * again: a toggle the parent didn't accept goes back.
+   */
+  selectedEventCount?: Int32;
+
+  /** Menu shown when the button is pressed, flattened (see ButtonMenuItem). */
+  menu?: ReadonlyArray<ButtonMenuItem>;
+
+  ios?: ButtonIOSProps;
+
+  /**
+   * Haptic played when the button is pressed: '' (none added) | 'none' | 'selection' |
+   * 'light' | 'medium' | 'heavy' | 'success' | 'warning' | 'error'
+   */
+  haptics?: string;
+
   /** Fired when the button is pressed. */
   onButtonPress?: BubblingEventHandler<Readonly<{}>>;
+
+  /** Fired when a toggle button is pressed, with the state it asks for. */
+  onSelectedChange?: BubblingEventHandler<ButtonSelectedChangeEvent>;
+
+  /** Fired when a menu item is picked. */
+  onMenuSelect?: BubblingEventHandler<ButtonMenuSelectEvent>;
+
+  /** Fired when the menu opens. */
+  onMenuOpen?: BubblingEventHandler<Readonly<{}>>;
+
+  /** Fired when the menu closes. */
+  onMenuClose?: BubblingEventHandler<Readonly<{}>>;
 }
 
 export default codegenNativeComponent<ButtonNativeProps>(

package/lib/module/ContextMenu.js

@@ -3,54 +3,8 @@
 // ContextMenu.tsx
 import React, { useCallback, useMemo } from 'react';
 import NativeContextMenu from './ContextMenuNativeComponent';
-
-/**
- * Attributes for a context menu action.
- */
-
-/**
- * A single action in the context menu.
- */
+import { flattenMenuActions } from "./menuItems.js";
 import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * Convert user-friendly subaction to native format (no further nesting).
- */
-function normalizeSubaction(action) {
-  return {
-    id: action.id,
-    title: action.title,
-    subtitle: action.subtitle,
-    image: action.image,
-    imageColor: action.imageColor,
-    attributes: action.attributes ? {
-      destructive: action.attributes.destructive ? 'true' : 'false',
-      disabled: action.attributes.disabled ? 'true' : 'false',
-      hidden: action.attributes.hidden ? 'true' : 'false'
-    } : undefined,
-    state: action.state
-  };
-}
-
-/**
- * Convert user-friendly action to native format.
- * Note: Only one level of nesting is supported by the native component.
- */
-function normalizeAction(action) {
-  return {
-    id: action.id,
-    title: action.title,
-    subtitle: action.subtitle,
-    image: action.image,
-    imageColor: action.imageColor,
-    attributes: action.attributes ? {
-      destructive: action.attributes.destructive ? 'true' : 'false',
-      disabled: action.attributes.disabled ? 'true' : 'false',
-      hidden: action.attributes.hidden ? 'true' : 'false'
-    } : undefined,
-    state: action.state,
-    subactions: action.subactions?.map(normalizeSubaction)
-  };
-}
 export function ContextMenu(props) {
   const {
     style,
@@ -58,15 +12,17 @@ export function ContextMenu(props) {
     actions,
     disabled,
     trigger = 'longPress',
+    haptics,
     onPressAction,
     onMenuOpen,
     onMenuClose,
+    onPreviewPress,
     children,
     ios,
     android,
     ...viewProps
   } = props;
-  const nativeActions = useMemo(() => actions.map(normalizeAction), [actions]);
+  const nativeActions = useMemo(() => flattenMenuActions(actions), [actions]);
   const handlePressAction = useCallback(e => {
     const {
       actionId,
@@ -80,6 +36,9 @@ export function ContextMenu(props) {
   const handleMenuClose = useCallback(() => {
     onMenuClose?.();
   }, [onMenuClose]);
+  const handlePreviewPress = useCallback(() => {
+    onPreviewPress?.();
+  }, [onPreviewPress]);
   const nativeIOS = useMemo(() => {
     if (!ios) return undefined;
     return {
@@ -99,9 +58,11 @@ export function ContextMenu(props) {
     actions: nativeActions,
     interactivity: disabled ? 'disabled' : 'enabled',
     trigger: trigger,
+    haptics: haptics ?? '',
     onPressAction: onPressAction ? handlePressAction : undefined,
     onMenuOpen: onMenuOpen ? handleMenuOpen : undefined,
     onMenuClose: onMenuClose ? handleMenuClose : undefined,
+    onPreviewPress: onPreviewPress ? handlePreviewPress : undefined,
     ios: nativeIOS,
     android: nativeAndroid,
     ...viewProps,

package/lib/module/ContextMenu.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useCallback","useMemo","NativeContextMenu","jsx","_jsx","normalizeSubaction","action","id","title","subtitle","image","imageColor","attributes","destructive","disabled","hidden","undefined","state","normalizeAction","subactions","map","ContextMenu","props","style","actions","trigger","onPressAction","onMenuOpen","onMenuClose","children","ios","android","viewProps","nativeActions","handlePressAction","e","actionId","actionTitle","nativeEvent","handleMenuOpen","handleMenuClose","nativeIOS","enablePreview","nativeAndroid","anchorPosition","visible","interactivity"],"sourceRoot":"../../src","sources":["ContextMenu.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useCallback","useMemo","NativeContextMenu","flattenMenuActions","jsx","_jsx","ContextMenu","props","style","title","actions","disabled","trigger","haptics","onPressAction","onMenuOpen","onMenuClose","onPreviewPress","children","ios","android","viewProps","nativeActions","handlePressAction","e","actionId","actionTitle","nativeEvent","handleMenuOpen","handleMenuClose","handlePreviewPress","nativeIOS","undefined","enablePreview","nativeAndroid","anchorPosition","visible","interactivity"],"sourceRoot":"../../src","sources":["ContextMenu.tsx"],"mappings":";;AAAA;AACA,OAAOA,KAAK,IAAIC,WAAW,EAAEC,OAAO,QAAQ,OAAO;AAGnD,OAAOC,iBAAiB,MAEjB,8BAA8B;AACrC,SAASC,kBAAkB,QAAgC,gBAAa;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAgFzE,OAAO,SAASC,WAAWA,CAACC,KAAuB,EAAsB;EACvE,MAAM;IACJC,KAAK;IACLC,KAAK;IACLC,OAAO;IACPC,QAAQ;IACRC,OAAO,GAAG,WAAW;IACrBC,OAAO;IACPC,aAAa;IACbC,UAAU;IACVC,WAAW;IACXC,cAAc;IACdC,QAAQ;IACRC,GAAG;IACHC,OAAO;IACP,GAAGC;EACL,CAAC,GAAGd,KAAK;EAET,MAAMe,aAAa,GAAGrB,OAAO,CAAC,MAAME,kBAAkB,CAACO,OAAO,CAAC,EAAE,CAACA,OAAO,CAAC,CAAC;EAE3E,MAAMa,iBAAiB,GAAGvB,WAAW,CAClCwB,CAA+C,IAAK;IACnD,MAAM;MAAEC,QAAQ;MAAEC;IAAY,CAAC,GAAGF,CAAC,CAACG,WAAW;IAC/Cb,aAAa,GAAGW,QAAQ,EAAEC,WAAW,CAAC;EACxC,CAAC,EACD,CAACZ,aAAa,CAChB,CAAC;EAED,MAAMc,cAAc,GAAG5B,WAAW,CAAC,MAAM;IACvCe,UAAU,GAAG,CAAC;EAChB,CAAC,EAAE,CAACA,UAAU,CAAC,CAAC;EAEhB,MAAMc,eAAe,GAAG7B,WAAW,CAAC,MAAM;IACxCgB,WAAW,GAAG,CAAC;EACjB,CAAC,EAAE,CAACA,WAAW,CAAC,CAAC;EAEjB,MAAMc,kBAAkB,GAAG9B,WAAW,CAAC,MAAM;IAC3CiB,cAAc,GAAG,CAAC;EACpB,CAAC,EAAE,CAACA,cAAc,CAAC,CAAC;EAEpB,MAAMc,SAAS,GAAG9B,OAAO,CAAC,MAAM;IAC9B,IAAI,CAACkB,GAAG,EAAE,OAAOa,SAAS;IAC1B,OAAO;MACLC,aAAa,EAAEd,GAAG,CAACc,aAAa,GAAG,MAAM,GAAG;IAC9C,CAAC;EACH,CAAC,EAAE,CAACd,GAAG,CAAC,CAAC;EAET,MAAMe,aAAa,GAAGjC,OAAO,CAAC,MAAM;IAClC,IAAI,CAACmB,OAAO,EAAE,OAAOY,SAAS;IAC9B,OAAO;MACLG,cAAc,EAAEf,OAAO,CAACe,cAAc;MACtCC,OAAO,EAAEhB,OAAO,CAACgB,OAAO,GAAG,MAAM,GAAG;IACtC,CAAC;EACH,CAAC,EAAE,CAAChB,OAAO,CAAC,CAAC;EAEb,oBACEf,IAAA,CAACH,iBAAiB;IAChBM,KAAK,EAAEA,KAAM;IACbC,KAAK,EAAEA,KAAM;IACbC,OAAO,EAAEY,aAAc;IACvBe,aAAa,EAAE1B,QAAQ,GAAG,UAAU,GAAG,SAAU;IACjDC,OAAO,EAAEA,OAAQ;IACjBC,OAAO,EAAEA,OAAO,IAAI,EAAG;IACvBC,aAAa,EAAEA,aAAa,GAAGS,iBAAiB,GAAGS,SAAU;IAC7DjB,UAAU,EAAEA,UAAU,GAAGa,cAAc,GAAGI,SAAU;IACpDhB,WAAW,EAAEA,WAAW,GAAGa,eAAe,GAAGG,SAAU;IACvDf,cAAc,EAAEA,cAAc,GAAGa,kBAAkB,GAAGE,SAAU;IAChEb,GAAG,EAAEY,SAAU;IACfX,OAAO,EAAEc,aAAc;IAAA,GACnBb,SAAS;IAAAH,QAAA,EAEZA;EAAQ,CACQ,CAAC;AAExB","ignoreList":[]}

package/lib/module/ContextMenuNativeComponent.ts

@@ -1,61 +1,48 @@
 // ContextMenuNativeComponent.ts
 import type { HostComponent, ViewProps } from 'react-native';
 import { codegenNativeComponent } from 'react-native';
-import type { BubblingEventHandler } from './codegenTypes';
+import type { BubblingEventHandler, Double, Int32 } from './codegenTypes';
 
 /**
- * Attributes for a context menu action.
+ * One menu item. The JS action tree is flattened (see `menuItems.ts`): each
+ * item points at its parent submenu or section by index, so menus nest to any
+ * depth without a recursive codegen type. Every field is set; empty strings
+ * mean "none" and flags are 'true' | 'false'.
  */
-export type ContextMenuActionAttributes = Readonly<{
-  /** Whether the action is destructive (red styling) */
-  destructive?: string; // 'true' | 'false'
-  /** Whether the action is disabled (grayed out) */
-  disabled?: string; // 'true' | 'false'
-  /** Whether the action is hidden */
-  hidden?: string; // 'true' | 'false'
-}>;
-
-/**
- * A leaf subaction (no further nesting to avoid codegen recursion issues).
- */
-export type ContextMenuSubaction = Readonly<{
+export type ContextMenuItem = Readonly<{
   /** Unique identifier returned in callbacks */
   id: string;
-  /** Display title */
+  /** Display title (a section's header on iOS) */
   title: string;
   /** Secondary text (iOS only) */
-  subtitle?: string;
-  /** Icon name (SF Symbol on iOS, drawable resource on Android) */
-  image?: string;
+  subtitle: string;
+  /** Index of the parent submenu or section; -1 at the top level */
+  parent: Int32;
+  /** 'action' | 'menu' | 'section' */
+  kind: string;
+  /** '' | 'sfSymbol' | 'drawable' | 'image' */
+  iconType: string;
+  /** SF Symbol / asset name (iOS) or drawable resource name (Android) */
+  iconName: string;
+  /** Resolved image URI when iconType === 'image' */
+  iconRequest: string;
+  iconUri: string;
+  /** Resolved image scale when iconType === 'image' */
+  iconScale: Double;
+  /** 'true' | 'false': draw the image as a tinted template */
+  iconTinted: string;
   /** Tint color for the icon (hex string, e.g., "#FF0000") */
-  imageColor?: string;
-  /** Action attributes */
-  attributes?: ContextMenuActionAttributes;
-  /** Checkmark state: 'off' | 'on' | 'mixed' */
-  state?: string;
-}>;
-
-/**
- * A single action in the context menu.
- * Actions can be nested one level via `subactions` for submenus.
- */
-export type ContextMenuAction = Readonly<{
-  /** Unique identifier returned in callbacks */
-  id: string;
-  /** Display title */
-  title: string;
-  /** Secondary text (iOS only) */
-  subtitle?: string;
-  /** Icon name (SF Symbol on iOS, drawable resource on Android) */
-  image?: string;
-  /** Tint color for the icon (hex string, e.g., "#FF0000") */
-  imageColor?: string;
-  /** Action attributes */
-  attributes?: ContextMenuActionAttributes;
-  /** Checkmark state: 'off' | 'on' | 'mixed' */
-  state?: string;
-  /** Nested actions for submenu (one level deep) */
-  subactions?: ReadonlyArray<ContextMenuSubaction>;
+  imageColor: string;
+  /** 'true' | 'false' */
+  destructive: string;
+  /** 'true' | 'false' */
+  disabled: string;
+  /** 'true' | 'false' (iOS 16+) */
+  keepsMenuPresented: string;
+  /** '' | 'off' | 'on' | 'mixed' */
+  state: string;
+  /** The action's own haptics; '' = the component's */
+  haptics: string;
 }>;
 
 /**
@@ -102,9 +89,9 @@ export interface ContextMenuProps extends ViewProps {
   title?: string;
 
   /**
-   * Menu actions.
+   * Menu items, flattened (see ContextMenuItem).
    */
-  actions: ReadonlyArray<ContextMenuAction>;
+  actions: ReadonlyArray<ContextMenuItem>;
 
   /**
    * Enabled / disabled state.
@@ -118,6 +105,12 @@ export interface ContextMenuProps extends ViewProps {
    */
   trigger?: string; // ContextMenuTrigger
 
+  /**
+   * Haptic played when an action is pressed: '' (none added) | 'none' | 'selection' |
+   * 'light' | 'medium' | 'heavy' | 'success' | 'warning' | 'error'
+   */
+  haptics?: string;
+
   /**
    * Fired when user presses an action.
    */
@@ -133,6 +126,11 @@ export interface ContextMenuProps extends ViewProps {
    */
   onMenuClose?: BubblingEventHandler<Readonly<{}>>;
 
+  /**
+   * iOS: fired when the user taps the preview (with enablePreview).
+   */
+  onPreviewPress?: BubblingEventHandler<Readonly<{}>>;
+
   ios?: IOSProps;
   android?: AndroidProps;
 }

package/lib/module/DatePicker.js

@@ -1,9 +1,15 @@
 "use strict";
 
 // DatePicker.tsx
-import React, { useCallback } from 'react';
-import { StyleSheet } from 'react-native';
+import React, { useCallback, useEffect } from 'react';
+import { Platform, StyleSheet } from 'react-native';
 import NativeDatePicker from './DatePickerNativeComponent';
+
+/**
+ * Android: how the Material pickers take input. `'text'` opens the date
+ * picker on its text field and the time picker on its keyboard entry;
+ * `'calendar'` on the calendar and the clock dial. Default: `'calendar'`.
+ */
 import { jsx as _jsx } from "react/jsx-runtime";
 // Sentinel value for "no date". Using MIN_SAFE_INTEGER ensures we don't
 // conflict with valid negative timestamps (dates before 1970).
@@ -29,6 +35,7 @@ export function DatePicker(props) {
     mode,
     presentation = 'modal',
     visible,
+    is24Hour,
     onConfirm,
     onClosed,
     ios,
@@ -37,7 +44,12 @@ export function DatePicker(props) {
   } = props;
   const isModal = presentation === 'modal';
   const handleConfirm = useCallback(e => {
-    onConfirm?.(new Date(e.nativeEvent.timestampMs), e.nativeEvent.confirmed);
+    const {
+      timestampMs,
+      confirmed,
+      durationSeconds
+    } = e.nativeEvent;
+    onConfirm?.(new Date(timestampMs), confirmed, durationSeconds ?? 0);
   }, [onConfirm]);
   const handleClosed = useCallback(() => {
     onClosed?.();
@@ -47,6 +59,7 @@ export function DatePicker(props) {
     mode,
     locale,
     timeZoneName,
+    hourFormat: hourFormat(is24Hour),
     presentation,
     visible: normalizeVisible(presentation, visible),
     dateMs: dateToMsOrSentinel(date),
@@ -66,7 +79,8 @@ export function DatePicker(props) {
       material: android.material,
       dialogTitle: android.dialogTitle,
       positiveButtonTitle: android.positiveButtonTitle,
-      negativeButtonTitle: android.negativeButtonTitle
+      negativeButtonTitle: android.negativeButtonTitle,
+      inputMode: android.inputMode
     } : undefined
   };
   return /*#__PURE__*/_jsx(NativeDatePicker, {
@@ -74,6 +88,86 @@ export function DatePicker(props) {
     ...nativeProps
   });
 }
+function hourFormat(is24Hour) {
+  if (is24Hour === undefined) return '';
+  return is24Hour ? '24' : '12';
+}
+
+/** A range of days, as `DateRangePicker` reports it. */
+
+/**
+ * Whether `DateRangePicker` shows anything on this platform. iOS has no
+ * native date range picker; offer two `DatePicker`s there instead.
+ */
+export const isDateRangePickerSupported = rangePickerSupported();
+function rangePickerSupported() {
+  return Platform.OS !== 'ios';
+}
+
+/**
+ * A date range picker: Material's `MaterialDatePicker.dateRangePicker()` on
+ * Android, a modal dialog. iOS has no native range picker, so it renders
+ * nothing there and warns in development (see `isDateRangePickerSupported`).
+ */
+export function DateRangePicker(props) {
+  const {
+    style,
+    startDate,
+    endDate,
+    minDate,
+    maxDate,
+    locale,
+    timeZoneName,
+    visible,
+    onConfirm,
+    onClosed,
+    android,
+    testID
+  } = props;
+  const supported = rangePickerSupported();
+  useEffect(() => {
+    if (__DEV__ && visible && !supported) {
+      console.warn('DateRangePicker: iOS has no native date range picker, so nothing is ' + 'shown. Check isDateRangePickerSupported and offer two DatePickers ' + 'on iOS.');
+    }
+  }, [visible, supported]);
+  const handleConfirm = useCallback(e => {
+    const {
+      timestampMs,
+      endTimestampMs
+    } = e.nativeEvent;
+    onConfirm?.({
+      startDate: new Date(timestampMs),
+      endDate: new Date(endTimestampMs)
+    });
+  }, [onConfirm]);
+  const handleClosed = useCallback(() => {
+    onClosed?.();
+  }, [onClosed]);
+  if (!supported) return null;
+  return /*#__PURE__*/_jsx(NativeDatePicker, {
+    testID: testID,
+    style: [styles.picker, style],
+    mode: "dateRange",
+    presentation: "modal",
+    visible: visible ? 'open' : 'closed',
+    locale: locale,
+    timeZoneName: timeZoneName,
+    dateMs: dateToMsOrSentinel(startDate),
+    endDateMs: dateToMsOrSentinel(endDate),
+    minDateMs: dateToMsOrSentinel(minDate),
+    maxDateMs: dateToMsOrSentinel(maxDate),
+    onConfirm: onConfirm ? handleConfirm : undefined,
+    onClosed: onClosed ? handleClosed : undefined,
+    android: android ? {
+      firstDayOfWeek: android.firstDayOfWeek,
+      material: 'm3',
+      dialogTitle: android.dialogTitle,
+      positiveButtonTitle: android.positiveButtonTitle,
+      negativeButtonTitle: android.negativeButtonTitle,
+      inputMode: android.inputMode
+    } : undefined
+  });
+}
 const styles = StyleSheet.create({
   picker: {}
 });

package/lib/module/DatePicker.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useCallback","StyleSheet","NativeDatePicker","jsx","_jsx","NO_DATE_SENTINEL","Number","MIN_SAFE_INTEGER","dateToMsOrSentinel","d","ms","getTime","isFinite","normalizeVisible","presentation","visible","undefined","DatePicker","props","style","date","minDate","maxDate","locale","timeZoneName","mode","onConfirm","onClosed","ios","android","testID","isModal","handleConfirm","e","Date","nativeEvent","timestampMs","confirmed","handleClosed","nativeProps","styles","picker","dateMs","minDateMs","maxDateMs","preferredStyle","countDownDurationSeconds","minuteInterval","roundsToMinuteInterval","confirmToolbar","showConfirmToolbar","firstDayOfWeek","material","dialogTitle","positiveButtonTitle","negativeButtonTitle","create"],"sourceRoot":"../../src","sources":["DatePicker.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useCallback","useEffect","Platform","StyleSheet","NativeDatePicker","jsx","_jsx","NO_DATE_SENTINEL","Number","MIN_SAFE_INTEGER","dateToMsOrSentinel","d","ms","getTime","isFinite","normalizeVisible","presentation","visible","undefined","DatePicker","props","style","date","minDate","maxDate","locale","timeZoneName","mode","is24Hour","onConfirm","onClosed","ios","android","testID","isModal","handleConfirm","e","timestampMs","confirmed","durationSeconds","nativeEvent","Date","handleClosed","nativeProps","styles","picker","hourFormat","dateMs","minDateMs","maxDateMs","preferredStyle","countDownDurationSeconds","minuteInterval","roundsToMinuteInterval","confirmToolbar","showConfirmToolbar","firstDayOfWeek","material","dialogTitle","positiveButtonTitle","negativeButtonTitle","inputMode","isDateRangePickerSupported","rangePickerSupported","OS","DateRangePicker","startDate","endDate","supported","__DEV__","console","warn","endTimestampMs","endDateMs","create"],"sourceRoot":"../../src","sources":["DatePicker.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/DatePickerNativeComponent.ts

@@ -13,9 +13,20 @@ export type TimestampMs = Double;
 export type DateChangeEvent = {
   timestampMs: Double;
   confirmed: boolean;
+  /**
+   * iOS `countDownTimer` mode: the selected duration in seconds. 0 in every
+   * other mode and on Android (which has no countdown picker).
+   */
+  durationSeconds: Double;
+  /**
+   * `dateRange` mode (Android): the last day of the range, with
+   * `timestampMs` the first. 0 in every other mode.
+   */
+  endTimestampMs: Double;
 };
 
-export type DatePickerMode = 'date' | 'time' | 'dateAndTime' | 'countDownTimer';
+export type DatePickerMode =
+  'date' | 'time' | 'dateAndTime' | 'countDownTimer' | 'yearAndMonth';
 export type DatePickerPresentation = 'modal' | 'embedded';
 
 export type IOSDatePickerStyle = 'automatic' | 'compact' | 'inline' | 'wheels';
@@ -36,6 +47,7 @@ export type AndroidProps = {
   dialogTitle?: string;
   positiveButtonTitle?: string;
   negativeButtonTitle?: string;
+  inputMode?: string; // '' | 'calendar' | 'text'
 };
 
 export type WebProps = Readonly<{}>;
@@ -48,15 +60,20 @@ export type MacOSProps = Readonly<{}>;
  *   (Allows negative timestamps for pre-1970 dates.)
  */
 export type CommonProps = {
-  mode?: string; // DatePickerMode
+  mode?: string; // DatePickerMode, or 'dateRange' for DateRangePicker
 
   dateMs?: WithDefault<TimestampMs, -9007199254740991>;
+  /** `dateRange` mode: the last day of the range (`dateMs` is the first). */
+  endDateMs?: WithDefault<TimestampMs, -9007199254740991>;
   minDateMs?: WithDefault<TimestampMs, -9007199254740991>;
   maxDateMs?: WithDefault<TimestampMs, -9007199254740991>;
 
   locale?: string;
   timeZoneName?: string;
 
+  /** '' (device setting) | '12' | '24' */
+  hourFormat?: string;
+
   /**
    * Only used when presentation === "modal".
    * Defaults should be applied in JS wrapper (recommended).