@gnome-ui/react-native 1.12.0 → 1.13.0

package/dist/components/TimePicker/TimeFields.d.ts

@@ -0,0 +1,36 @@
+import { StyleProp, ViewStyle } from 'react-native';
+import { TimeValue } from './timeUtils';
+export interface TimeFieldsProps {
+    /** The time the columns show. Always concrete — callers supply the fallback. */
+    value: TimeValue;
+    /** Called with the whole time whenever any column moves. */
+    onChange: (value: TimeValue) => void;
+    /** 12- or 24-hour presentation. Defaults to `24`. */
+    hourCycle?: 12 | 24;
+    /** Minute increment for the spinner. Defaults to `1`. */
+    minuteStep?: number;
+    /**
+     * Prefix for each column's accessible label — `"Start"` gives
+     * "Start hours". Needed when a panel carries more than one set of columns.
+     */
+    labelPrefix?: string;
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * The hour/minute (and AM/PM) `SpinButton` columns — the panel half of
+ * `TimePicker`, split out so `DatePicker`'s `showTime` footer can reuse the
+ * same 12/24-hour bookkeeping without re-implementing it.
+ *
+ * Ported from `@gnome-ui/react`'s `TimePicker/TimeFields.tsx`: mirrors its
+ * prop API and `to12`/`to24` bookkeeping exactly, rebuilt on this package's
+ * own `SpinButton` (already shipped in Tier 5, with a matching `wrap`
+ * boolean and `format: (n: number) => string` callback — confirmed by
+ * reading `SpinButton.tsx` before wiring this up, no new prop needed for the
+ * AM/PM column's "numeric spinner whose `format` maps 0/1 to text" trick).
+ *
+ * **Not exported from the package**: `TimePicker` is this module's public
+ * face; `DatePicker`'s `showTime` footer imports it directly via
+ * `@/components/TimePicker/TimeFields`, the same cross-folder internal
+ * import `Calendar/calendarUtils.ts`'s `WeekStart` already established.
+ */
+export declare const TimeFields: ({ value, onChange, hourCycle, minuteStep, labelPrefix, style, }: TimeFieldsProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/TimePicker/TimePicker.d.ts

@@ -0,0 +1,55 @@
+import { StyleProp, ViewStyle } from 'react-native';
+import { PopoverPlacement } from '../Popover';
+import { TimeValue } from './timeUtils';
+export type { TimeValue } from './timeUtils';
+export interface TimePickerProps {
+    /** Controlled selected time. Pass `null` for "no selection". */
+    value?: TimeValue | null;
+    /** Initial selected time when uncontrolled. Defaults to `null`. */
+    defaultValue?: TimeValue | null;
+    /** Called when the user changes the time. */
+    onChange?: (value: TimeValue) => void;
+    /** 12- or 24-hour presentation. Defaults to `24`. */
+    hourCycle?: 12 | 24;
+    /** Minute increment for the spinner. Defaults to `1`. */
+    minuteStep?: number;
+    /** Text shown in the trigger while no time is selected. */
+    placeholder?: string;
+    /** Visible label rendered above the trigger. */
+    label?: string;
+    /** Accessible name for the trigger when no visible `label` is provided. */
+    accessibilityLabel?: string;
+    /** Disable the control. */
+    disabled?: boolean;
+    /** Preferred popover placement relative to the trigger. Defaults to `'bottom'`. */
+    placement?: PopoverPlacement;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+/**
+ * Hour/minute selection built from paired `SpinButton`s inside a `Popover`,
+ * behind an entry-styled trigger — mirrors the `GtkSpinButton` + `GtkPopover`
+ * composition GNOME apps use for time entry, with 12- and 24-hour support.
+ *
+ * Rebuilt on this package's own already-shipped `Popover` (Tier 5) rather
+ * than reinventing its trigger-rect + panel-size positioning, the same
+ * standing pitfall `DatePicker` already avoided. The panel is just
+ * `TimeFields` — no Done button, unlike `DatePicker`'s `showTime` footer:
+ * there is no calendar tap to disambiguate from a close here, so each
+ * column commits live and the popover only closes the same way `Dropdown`'s
+ * does, by tapping outside or the trigger again.
+ *
+ * **`TimeFields`/`timeUtils` moved here from `DatePicker`'s own folder**,
+ * where they first shipped as an internal dependency of its `showTime`
+ * footer — this is their intended public home (per the ROADMAP note left
+ * when `DatePicker` shipped), `DatePicker` now imports them from here
+ * instead of carrying its own copy.
+ *
+ * The web version's entire keyboard layer drops (no `ArrowDown`-opens focus
+ * management, no `Enter`/`Space` on the trigger) — the same touch-first
+ * convention `DatePicker` already follows. `locale` is dropped in favor of
+ * `GnomeProvider`'s app-wide `useDateTimeFormatter`, same as `DatePicker`.
+ *
+ * @see https://developer.gnome.org/hig/patterns/controls/spin-buttons.html
+ */
+export declare const TimePicker: ({ value: controlledValue, defaultValue, onChange, hourCycle, minuteStep, placeholder, label, accessibilityLabel, disabled, placement, style, testID, }: TimePickerProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/TimePicker/index.d.ts

@@ -0,0 +1,2 @@
+export type { TimePickerProps, TimeValue } from './TimePicker';
+export { TimePicker } from './TimePicker';

package/dist/components/TimePicker/timeUtils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pure time helpers shared by `TimePicker` and `DatePicker`'s `showTime`
+ * footer. Ported verbatim from `@gnome-ui/react`'s `TimePicker/timeUtils.ts`
+ * — no DOM dependency there already, the same `calendarUtils.ts` precedent.
+ *
+ * Not exported from the package barrel — `DatePicker` imports it directly
+ * via `@/components/TimePicker/timeUtils`, the same cross-folder internal
+ * import `Calendar/calendarUtils.ts`'s `WeekStart` already established.
+ */
+/** A wall-clock time, in 24-hour terms. */
+export interface TimeValue {
+    /** Hours, `0`–`23`. */
+    hours: number;
+    /** Minutes, `0`–`59`. */
+    minutes: number;
+}
+/** Zero-padded two-digit rendering for a clock column. */
+export declare const pad2: (n: number) => string;
+/** Split a 0–23 hour into its 12-hour parts (`period`: 0 = AM, 1 = PM). */
+export declare const to12: (hours24: number) => {
+    hour: number;
+    period: number;
+};
+/** Recombine a 12-hour clock reading into a 0–23 hour. */
+export declare const to24: (hour12: number, period: number) => number;
+/** The wall-clock time carried by a `Date`. */
+export declare const timeOf: (date: Date) => TimeValue;
+/**
+ * `date`'s calendar day at `time`'s wall clock.
+ *
+ * A local `Date` cannot represent an hour that a DST spring-forward skips, and
+ * the platform silently shifts it (02:30 → 03:30). That shift is kept — it is
+ * the only real instant for that reading — so callers should read the result
+ * back rather than assume the requested hour survived.
+ */
+export declare const mergeDateAndTime: (date: Date, time: TimeValue) => Date;