@datum-cloud/datum-ui 0.8.1 → 0.9.0

package/dist/components/features/picker/presets/defaults.d.ts

@@ -0,0 +1,16 @@
+import type { PickerMode, PickerPreset } from '../types';
+/**
+ * Date-bearing presets. Operate on calendar days; ignore time-of-day.
+ */
+export declare const DATE_PRESETS: readonly PickerPreset[];
+/**
+ * Datetime-bearing presets. Use "now" as the upper bound for past windows
+ * (so the picker doesn't propose future timestamps).
+ */
+export declare const DATETIME_PRESETS: readonly PickerPreset[];
+/**
+ * Default preset set for a given mode. Time-only modes return empty —
+ * presets rarely make sense for picking a wall-clock time.
+ */
+export declare function getDefaultPresets(mode: PickerMode): readonly PickerPreset[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/components/features/picker/presets/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/presets/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AA0BxD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,YAAY,EAgEtC,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,YAAY,EAsD1C,CAAA;AAIV;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,YAAY,EAAE,CAc3E"}

package/dist/components/features/picker/presets/index.d.ts

@@ -0,0 +1,2 @@
+export { DATE_PRESETS, DATETIME_PRESETS, getDefaultPresets } from './defaults';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/picker/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA"}

package/dist/components/features/picker/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Picker mode — discriminator for the 7 useful cells of the date×time matrix.
+ * (8 cells exist; single-date+time-range collapses into datetime-range with same-day from/to.)
+ */
+export type PickerMode = 'date' | 'date-range' | 'time' | 'time-range' | 'datetime' | 'datetime-range' | 'date-range-time';
+/** When does onChange fire? */
+export type PickerCommit = 'immediate' | 'apply';
+/** A preset is a labeled, TZ-aware range factory. */
+export interface PickerPreset {
+    /** Stable identifier — persisted in emitted value for URL hydration. */
+    key: string;
+    /** Display label (user-facing). */
+    label: string;
+    /** Optional keyboard shortcut (single character; case-insensitive). */
+    shortcut?: string;
+    /** Compute the range in the user's selected timezone. Lazy and TZ-aware. */
+    getRange: (timezone: string) => {
+        from: Date;
+        to: Date;
+    };
+}
+export type DateValue = Date | null;
+export type DateRangeValue = {
+    from: Date;
+    to: Date;
+    /** Set when the range came from a preset click. Undefined for manual ranges. */
+    preset?: string;
+} | null;
+/** Time-of-day in `"HH:mm"` 24-hour format. Display formatting is separate. */
+export type TimeValue = string | null;
+export type TimeRangeValue = {
+    from: string;
+    to: string;
+    preset?: string;
+} | null;
+/** Datetime as UTC ISO string. Display timezone is a separate prop. */
+export type DatetimeValue = string | null;
+export type DatetimeRangeValue = {
+    from: string;
+    to: string;
+    preset?: string;
+} | null;
+export type DateRangeTimeValue = {
+    from: string;
+    to: string;
+    preset?: string;
+} | null;
+export interface PickerValueMap {
+    'date': DateValue;
+    'date-range': DateRangeValue;
+    'time': TimeValue;
+    'time-range': TimeRangeValue;
+    'datetime': DatetimeValue;
+    'datetime-range': DatetimeRangeValue;
+    'date-range-time': DateRangeTimeValue;
+}
+export type PickerValueOf<M extends PickerMode> = PickerValueMap[M];
+export declare const RANGE_MODES: readonly ["date-range", "time-range", "datetime-range", "date-range-time"];
+export type RangeMode = typeof RANGE_MODES[number];
+export declare const TIME_BEARING_MODES: readonly ["time", "time-range", "datetime", "datetime-range", "date-range-time"];
+export type TimeBearingMode = typeof TIME_BEARING_MODES[number];
+export declare const DATE_BEARING_MODES: readonly ["date", "date-range", "datetime", "datetime-range", "date-range-time"];
+export type DateBearingMode = typeof DATE_BEARING_MODES[number];
+export declare function isRangeMode(mode: PickerMode): mode is RangeMode;
+export declare function isTimeBearingMode(mode: PickerMode): mode is TimeBearingMode;
+export declare function isDateBearingMode(mode: PickerMode): mode is DateBearingMode;
+export type HourCycle = '12' | '24';
+export declare const ALLOWED_STEPS: readonly [1, 5, 10, 15, 30, 60];
+export type AllowedStep = typeof ALLOWED_STEPS[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/components/features/picker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/features/picker/types.ts"],"names":[],"mappings":"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"}

package/dist/components/features/picker/utils/commit.d.ts

@@ -0,0 +1,16 @@
+import type { PickerCommit, PickerMode } from '../types';
+/**
+ * Resolves the effective commit semantics for a picker.
+ *
+ * - Date + time combined modes (`datetime` / `datetime-range` /
+ *   `date-range-time`) **always** commit on Apply, regardless of the
+ *   caller-supplied override. Picking a date alone shouldn't publish a
+ *   value with an unconfirmed 00:00 time — the user needs to set the
+ *   time too, then explicitly Apply. The wrappers don't expose a
+ *   `commit` prop for these modes; primitive consumers can still pass
+ *   one through `Picker.Root` but it's silently overridden here.
+ * - Range modes (`date-range`, `time-range`) default to `'apply'`.
+ * - Everything else defaults to `'immediate'`.
+ */
+export declare function resolveCommit(mode: PickerMode, commit: PickerCommit | undefined): PickerCommit;
+//# sourceMappingURL=commit.d.ts.map

package/dist/components/features/picker/utils/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAGxD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAI9F"}

package/dist/components/features/picker/utils/compare.d.ts

@@ -0,0 +1,12 @@
+import type { DateRangeTimeValue, DateRangeValue, DatetimeRangeValue, TimeRangeValue } from '../types';
+/** Strict equality of two nullable Date references by millisecond value. */
+export declare function isSameDate(a: Date | null, b: Date | null): boolean;
+/** Equality of two nullable date ranges. Compares from, to (by ms), and preset. */
+export declare function isSameDateRange(a: DateRangeValue, b: DateRangeValue): boolean;
+/**
+ * Equality of two nullable string ranges. Used for time-of-day, time-range,
+ * and datetime-range value shapes (all structurally identical).
+ * Compares from, to, and optional preset.
+ */
+export declare function isSameStringRange(a: TimeRangeValue | DatetimeRangeValue | DateRangeTimeValue, b: TimeRangeValue | DatetimeRangeValue | DateRangeTimeValue): boolean;
+//# sourceMappingURL=compare.d.ts.map

package/dist/components/features/picker/utils/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/compare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,UAAU,CAAA;AAEjB,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAMlE;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,CAU7E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,kBAAkB,EAC3D,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,kBAAkB,GAC1D,OAAO,CAMT"}

package/dist/components/features/picker/utils/format-value.d.ts

@@ -0,0 +1,25 @@
+import type { HourCycle, PickerMode } from '../types';
+interface FormatOptions {
+    timezone?: string;
+    hourCycle?: HourCycle;
+    locale?: string;
+    /**
+     * date-fns format pattern for the date portion of the display label.
+     * When set, replaces the default `MMM dd, yyyy`-style locale rendering.
+     * Examples: `'dd/MM/yyyy'`, `'EEE, MMM do'`, `'yyyy-MM-dd'`.
+     */
+    dateFormat?: string;
+    /**
+     * date-fns format pattern for the time portion of the display label.
+     * When set, replaces the default `HH:mm` rendering (overrides `hourCycle`).
+     * Examples: `'HH:mm'`, `'hh:mm a'`, `'HH:mm:ss'`.
+     */
+    timeFormat?: string;
+}
+/**
+ * Renders a human-readable trigger label for any picker mode.
+ * Returns the empty string when the value is null/undefined or unparseable.
+ */
+export declare function formatPickerValue(value: unknown, mode: PickerMode, opts?: FormatOptions): string;
+export {};
+//# sourceMappingURL=format-value.d.ts.map

package/dist/components/features/picker/utils/format-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-value.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/format-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAKrD,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AA+DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE,aAAkB,GACvB,MAAM,CA+DR"}

package/dist/components/features/picker/utils/format.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Format a Date as YYYY-MM-DD using local-time components.
+ *
+ * Note: this is the consumer-friendly format for date-only modes.
+ * It does NOT round-trip through timezones; that's intentional —
+ * a calendar day has no timezone.
+ */
+export declare function dateToYYYYMMDD(d: Date): string;
+/**
+ * Extract `"HH:mm"` from a Date using its wall-clock components.
+ *
+ * Caller is responsible for ensuring those components reflect the
+ * intended timezone (typically via `dateToZoned` / `isoToZonedDate`
+ * upstream). Pads single-digit hour/minute to two characters.
+ */
+export declare function dateToHHmm(d: Date): string;
+/**
+ * Strict HH:mm validation. Rejects single-digit components,
+ * out-of-range hours/minutes, and any non-numeric content.
+ */
+export declare function isValidTimeString(s: string): boolean;
+/**
+ * Parse a HH:mm string. Returns null for invalid input.
+ */
+export declare function parseTimeString(s: string): {
+    h: number;
+    m: number;
+} | null;
+/**
+ * Format a HH:mm string for user display, respecting hour cycle.
+ *
+ * - `'24'`: returns the input as-is (`"14:30"`)
+ * - `'12'`: returns `"2:30 PM"` style with AM/PM and no leading zero on hour
+ *
+ * Returns empty string for invalid input — callers should validate first.
+ */
+export declare function formatTimeLabel(time: string, hourCycle: '12' | '24'): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/components/features/picker/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAI1C;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK1E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAW5E"}

package/dist/components/features/picker/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { resolveCommit, } from './commit';
+export { isSameDate, isSameDateRange, isSameStringRange, } from './compare';
+export { dateToYYYYMMDD, formatTimeLabel, isValidTimeString, parseTimeString, } from './format';
+export { formatPickerValue, } from './format-value';
+export { clampRange, getDaysDifference, isRangeValid, } from './range';
+export { formatInTimezone, formatTimezoneLabel, getBrowserTimezone, getTimezoneOffset, isoToZonedDate, zonedDateToIso, } from './timezone';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/picker/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GACd,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,YAAY,GACb,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/components/features/picker/utils/range.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Number of calendar days between two dates. Always non-negative.
+ *
+ * Uses calendar-day boundaries (not 24-hour windows), so a range from
+ * 23:59 today to 00:00 tomorrow counts as 1 day, not 0.
+ */
+export declare function getDaysDifference(from: Date, to: Date): number;
+/**
+ * Validate a range against a maximum span (inclusive).
+ *
+ * - Returns `true` when `maxRange` is undefined.
+ * - Returns `true` when the range spans at most `maxRange` days.
+ */
+export declare function isRangeValid(from: Date, to: Date, maxRange?: number): boolean;
+/**
+ * Clamp a range to fit within `maxRange` days.
+ *
+ * If the range already fits, returns the original `{from, to}`.
+ * Otherwise, holds `from` and clamps `to` forward to exactly `maxRange`
+ * days after `from`.
+ */
+export declare function clampRange(from: Date, to: Date, maxRange: number): {
+    from: Date;
+    to: Date;
+};
+//# sourceMappingURL=range.d.ts.map

package/dist/components/features/picker/utils/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/range.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAI7E;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,IAAI,EACR,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAM1B"}

package/dist/components/features/picker/utils/timezone.d.ts

@@ -0,0 +1,38 @@
+/** Browser-detected IANA timezone, falling back to UTC if unavailable. */
+export declare function getBrowserTimezone(): string;
+/**
+ * UTC offset for a timezone in `±HH:MM` format.
+ * Returns `+00:00` for UTC or any timezone the runtime cannot resolve.
+ */
+export declare function getTimezoneOffset(timezone: string): string;
+/**
+ * Human-readable timezone label.
+ * Example: `'Asia/Jakarta'` → `'Asia/Jakarta (UTC+07:00)'`.
+ */
+export declare function formatTimezoneLabel(timezone: string): string;
+/**
+ * Convert a UTC ISO string to a Date object whose wall-clock components
+ * (year/month/day/hours/minutes) reflect the value as seen in `timezone`.
+ *
+ * Use this to feed Calendar / time slot UI that reads `getHours()` etc.
+ *
+ * INVARIANT: `zonedDateToIso(isoToZonedDate(iso, tz), tz) === iso` for any
+ * valid ISO and tz.
+ */
+export declare function isoToZonedDate(iso: string, timezone: string): Date;
+/**
+ * Date-input variant of `isoToZonedDate`. Skips the ISO round-trip when the
+ * caller already has a Date instance (e.g. preset `getRange(tz)` results).
+ */
+export declare function dateToZoned(date: Date, timezone: string): Date;
+/**
+ * Inverse of `isoToZonedDate`. Treat the Date's wall-clock components
+ * as `timezone`-local and convert back to a UTC ISO instant.
+ */
+export declare function zonedDateToIso(date: Date, timezone: string): string;
+/**
+ * Format a UTC ISO string in the given timezone using a date-fns format pattern.
+ * Returns empty string if the input is not a valid date.
+ */
+export declare function formatInTimezone(iso: string, timezone: string, pattern: string): string;
+//# sourceMappingURL=timezone.d.ts.map

package/dist/components/features/picker/utils/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/utils/timezone.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyB1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUvF"}

package/dist/components/features/picker/wrappers/date-picker.d.ts

@@ -0,0 +1,10 @@
+import type { CalendarMonthsPickerProps, CommitOverridePickerProps, DateBearingPickerProps, UniversalPickerProps } from './types';
+export interface DatePickerProps extends UniversalPickerProps, CommitOverridePickerProps, DateBearingPickerProps, CalendarMonthsPickerProps {
+    value: Date | null;
+    onChange: (value: Date | null) => void;
+}
+export declare function DatePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, numberOfMonths, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, commit, disablePast, disableFuture, minDate, maxDate, dateFormat, }: DatePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DatePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=date-picker.d.ts.map

package/dist/components/features/picker/wrappers/date-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/date-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAQhB,MAAM,WAAW,eACf,SACA,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB;IACzB,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAA;CACvC;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,WAA2B,EAC3B,SAAgB,EAChB,UAAiB,EACjB,UAA0B,EAC1B,cAAkB,EAClB,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,UAAU,GACX,EAAE,eAAe,2CA4CjB;yBAnEe,UAAU"}

package/dist/components/features/picker/wrappers/date-range-picker.d.ts

@@ -0,0 +1,16 @@
+import type { CalendarMonthsPickerProps, CommitOverridePickerProps, DateBearingPickerProps, PresetsPickerProps, UniversalPickerProps } from './types';
+export interface DateRangePickerProps extends UniversalPickerProps, CommitOverridePickerProps, DateBearingPickerProps, CalendarMonthsPickerProps, PresetsPickerProps {
+    value: {
+        from: Date;
+        to: Date;
+    } | null;
+    onChange: (value: {
+        from: Date;
+        to: Date;
+    } | null) => void;
+}
+export declare function DateRangePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, numberOfMonths, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, commit, disablePast, disableFuture, minDate, maxDate, presets, excludePresets, dateFormat, }: DateRangePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DateRangePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=date-range-picker.d.ts.map

package/dist/components/features/picker/wrappers/date-range-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/date-range-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAShB,MAAM,WAAW,oBACf,SACA,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IACtC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAA;CAC3D;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,WAAiC,EACjC,SAAgB,EAChB,UAAiB,EACjB,UAAgC,EAChC,cAAkB,EAClB,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,UAAU,GACX,EAAE,oBAAoB,2CAgDtB;yBAzEe,eAAe"}

package/dist/components/features/picker/wrappers/date-range-time-picker.d.ts

@@ -0,0 +1,16 @@
+import type { CalendarMonthsPickerProps, DateBearingPickerProps, PresetsPickerProps, TimeOfDayPickerProps, TimezonePickerProps, UniversalPickerProps } from './types';
+export interface DateRangeTimePickerProps extends UniversalPickerProps, DateBearingPickerProps, CalendarMonthsPickerProps, TimezonePickerProps, TimeOfDayPickerProps, PresetsPickerProps {
+    value: {
+        from: string;
+        to: string;
+    } | null;
+    onChange: (value: {
+        from: string;
+        to: string;
+    } | null) => void;
+}
+export declare function DateRangeTimePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, timezone, step, hourCycle, numberOfMonths, hideTimezone, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, disablePast, disableFuture, minDate, maxDate, presets, excludePresets, dateFormat, timeFormat, }: DateRangeTimePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DateRangeTimePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=date-range-time-picker.d.ts.map

package/dist/components/features/picker/wrappers/date-range-time-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-range-time-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/date-range-time-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAWhB,MAAM,WAAW,wBACf,SACA,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAA;CAC/D;AAED,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,WAA2C,EAC3C,SAAgB,EAChB,UAAiB,EACjB,UAA0C,EAC1C,QAAQ,EACR,IAAS,EACT,SAAS,EACT,cAAkB,EAClB,YAAoB,EACpB,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,GACX,EAAE,wBAAwB,2CA0D1B;yBAvFe,mBAAmB"}

package/dist/components/features/picker/wrappers/date-time-picker.d.ts

@@ -0,0 +1,20 @@
+import type { CalendarMonthsPickerProps, DateBearingPickerProps, TimeOfDayPickerProps, TimezonePickerProps, UniversalPickerProps } from './types';
+export interface DateTimePickerProps extends UniversalPickerProps, DateBearingPickerProps, CalendarMonthsPickerProps, TimezonePickerProps, TimeOfDayPickerProps {
+    value: string | null;
+    onChange: (value: string | null) => void;
+    /**
+     * `'slot'` (default) renders the embedded time slot dropdown.
+     * `'input'` renders a typeable HH:mm input via `Picker.TimeInputField`.
+     */
+    timeInputMode?: 'slot' | 'input';
+    /**
+     * `'full'` (default) renders the full TZ indicator below the time input.
+     * `'compact'` renders just the bare timezone identifier.
+     */
+    timezoneIndicatorVariant?: 'full' | 'compact';
+}
+export declare function DateTimePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, timezone, step, hourCycle, numberOfMonths, hideTimezone, timeInputMode, timezoneIndicatorVariant, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, disablePast, disableFuture, minDate, maxDate, dateFormat, timeFormat, }: DateTimePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DateTimePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=date-time-picker.d.ts.map

package/dist/components/features/picker/wrappers/date-time-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/date-time-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAWhB,MAAM,WAAW,mBACf,SACA,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACxC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9C;AAED,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,QAAQ,EACR,WAAkC,EAClC,SAAgB,EAChB,UAAiB,EACjB,UAAiC,EACjC,QAAQ,EACR,IAAS,EACT,SAAS,EACT,cAAkB,EAClB,YAAoB,EACpB,aAAsB,EACtB,wBAAiC,EACjC,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,UAAU,EACV,UAAU,GACX,EAAE,mBAAmB,2CAuDrB;yBApFe,cAAc"}

package/dist/components/features/picker/wrappers/date-time-range-picker.d.ts

@@ -0,0 +1,16 @@
+import type { CalendarMonthsPickerProps, DateBearingPickerProps, PresetsPickerProps, TimeOfDayPickerProps, TimezonePickerProps, UniversalPickerProps } from './types';
+export interface DateTimeRangePickerProps extends UniversalPickerProps, DateBearingPickerProps, CalendarMonthsPickerProps, TimezonePickerProps, TimeOfDayPickerProps, PresetsPickerProps {
+    value: {
+        from: string;
+        to: string;
+    } | null;
+    onChange: (value: {
+        from: string;
+        to: string;
+    } | null) => void;
+}
+export declare function DateTimeRangePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, timezone, step, hourCycle, numberOfMonths, hideTimezone, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, disablePast, disableFuture, minDate, maxDate, presets, excludePresets, dateFormat, timeFormat, }: DateTimeRangePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DateTimeRangePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=date-time-range-picker.d.ts.map

package/dist/components/features/picker/wrappers/date-time-range-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-range-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/date-time-range-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAWhB,MAAM,WAAW,wBACf,SACA,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAA;CAC/D;AAED,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,EACR,WAAwC,EACxC,SAAgB,EAChB,UAAiB,EACjB,UAAuC,EACvC,QAAQ,EACR,IAAS,EACT,SAAS,EACT,cAAkB,EAClB,YAAoB,EACpB,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,aAAa,EACb,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,UAAU,EACV,UAAU,GACX,EAAE,wBAAwB,2CAgE1B;yBA7Fe,mBAAmB"}

package/dist/components/features/picker/wrappers/index.d.ts

@@ -0,0 +1,16 @@
+export { DatePicker } from './date-picker';
+export type { DatePickerProps } from './date-picker';
+export { DateRangePicker } from './date-range-picker';
+export type { DateRangePickerProps } from './date-range-picker';
+export { DateRangeTimePicker } from './date-range-time-picker';
+export type { DateRangeTimePickerProps } from './date-range-time-picker';
+export { DateTimePicker } from './date-time-picker';
+export type { DateTimePickerProps } from './date-time-picker';
+export { DateTimeRangePicker } from './date-time-range-picker';
+export type { DateTimeRangePickerProps } from './date-time-range-picker';
+export { TimePicker } from './time-picker';
+export type { TimePickerProps } from './time-picker';
+export { TimeRangePicker } from './time-range-picker';
+export type { TimeRangePickerProps } from './time-range-picker';
+export type { WrapperBaseProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/features/picker/wrappers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA"}

package/dist/components/features/picker/wrappers/internal/default-footer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The standard Cancel / Reset / Apply footer used by every wrapper.
+ * `Picker.Content` decides whether to render it - desktop popover renders
+ * it only when `commit === 'apply'`; mobile sheet always renders it.
+ */
+export declare function DefaultFooter(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=default-footer.d.ts.map

package/dist/components/features/picker/wrappers/internal/default-footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-footer.d.ts","sourceRoot":"","sources":["../../../../../../src/components/features/picker/wrappers/internal/default-footer.tsx"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,4CAQ5B"}

package/dist/components/features/picker/wrappers/time-picker.d.ts

@@ -0,0 +1,14 @@
+import type { CommitOverridePickerProps, TimeOfDayPickerProps, UniversalPickerProps } from './types';
+export interface TimePickerProps extends UniversalPickerProps, CommitOverridePickerProps, TimeOfDayPickerProps {
+    value: string | null;
+    onChange: (value: string | null) => void;
+    /** Inclusive min slot, format `"HH:mm"`. */
+    minTime?: string;
+    /** Inclusive max slot, format `"HH:mm"`. */
+    maxTime?: string;
+}
+export declare function TimePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, step, hourCycle, minTime, maxTime, timeFormat, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, commit, }: TimePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TimePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=time-picker.d.ts.map

package/dist/components/features/picker/wrappers/time-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/time-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAWpG,MAAM,WAAW,eACf,SAAQ,oBAAoB,EAAE,yBAAyB,EAAE,oBAAoB;IAC7E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACxC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,WAA2B,EAC3B,SAAgB,EAChB,UAAiB,EACjB,UAA0B,EAC1B,IAAS,EACT,SAAS,EACT,OAAO,EACP,OAAO,EACP,UAAU,EACV,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,MAAM,GACP,EAAE,eAAe,2CAmCjB;yBAzDe,UAAU"}

package/dist/components/features/picker/wrappers/time-range-picker.d.ts

@@ -0,0 +1,16 @@
+import type { CommitOverridePickerProps, TimeOfDayPickerProps, UniversalPickerProps } from './types';
+export interface TimeRangePickerProps extends UniversalPickerProps, CommitOverridePickerProps, TimeOfDayPickerProps {
+    value: {
+        from: string;
+        to: string;
+    } | null;
+    onChange: (value: {
+        from: string;
+        to: string;
+    } | null) => void;
+}
+export declare function TimeRangePicker({ value, onChange, placeholder, clearable, responsive, sheetTitle, step, hourCycle, timeFormat, triggerLabel, icon, disabled, className, triggerClassName, popoverClassName, id, sheetDescription, modal, commit, }: TimeRangePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TimeRangePicker {
+    var displayName: string;
+}
+//# sourceMappingURL=time-range-picker.d.ts.map

package/dist/components/features/picker/wrappers/time-range-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range-picker.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/time-range-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAWpG,MAAM,WAAW,oBACf,SAAQ,oBAAoB,EAAE,yBAAyB,EAAE,oBAAoB;IAC7E,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAA;CAC/D;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,WAAiC,EACjC,SAAgB,EAChB,UAAiB,EACjB,UAAgC,EAChC,IAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,EAChB,KAAK,EACL,MAAM,GACP,EAAE,oBAAoB,2CA4CtB;yBAhEe,eAAe"}

package/dist/components/features/picker/wrappers/types.d.ts

@@ -0,0 +1,118 @@
+import type { ReactNode } from 'react';
+import type { AllowedStep, HourCycle, PickerCommit, PickerPreset } from '../types';
+/**
+ * Universal props every picker wrapper accepts. These all touch the
+ * trigger / popover / sheet chrome — never the inner picker content.
+ */
+export interface UniversalPickerProps {
+    /** Trigger label when value is null. */
+    placeholder?: string;
+    /** Native disabled state — suppresses opening. */
+    disabled?: boolean;
+    /** Show a Clear sub-button on the trigger when a value is set. Default `true`. */
+    clearable?: boolean;
+    /** Class on the outermost trigger Button wrapper. */
+    className?: string;
+    /** Class merged onto the trigger Button. */
+    triggerClassName?: string;
+    /** Class merged onto the popover content (desktop only). */
+    popoverClassName?: string;
+    /** id forwarded to the trigger Button. */
+    id?: string;
+    /** When false, forces desktop popover even on mobile viewports. Default `true`. */
+    responsive?: boolean;
+    /** Mobile sheet header title. */
+    sheetTitle?: string;
+    /** Mobile sheet header description. */
+    sheetDescription?: string;
+    /** Forwarded to ResponsivePopover.modal. */
+    modal?: boolean;
+    /** Render-prop override for the trigger label. Receives the `pendingValue`. */
+    triggerLabel?: (value: unknown) => ReactNode;
+    /**
+     * Trigger leading icon. Pass a ReactNode to override the per-mode default
+     * (calendar for date-bearing modes, clock for time-only modes), or `false`
+     * to hide the icon entirely.
+     */
+    icon?: ReactNode | false;
+}
+/**
+ * Constraints that gate selectable dates. Apply to every wrapper that
+ * renders a calendar (everything except the time-only modes).
+ */
+export interface DateBearingPickerProps {
+    /** Disable past dates in the calendar AND filter past presets. */
+    disablePast?: boolean;
+    /** Disable future dates in the calendar AND filter future presets. */
+    disableFuture?: boolean;
+    /** Inclusive lower bound for selectable dates. */
+    minDate?: Date;
+    /** Inclusive upper bound for selectable dates. */
+    maxDate?: Date;
+    /**
+     * date-fns format pattern for the date portion of the trigger label.
+     * Examples: `'dd/MM/yyyy'`, `'EEE, MMM do'`, `'yyyy-MM-dd'`. Defaults to
+     * a locale-aware `MMM dd, yyyy`-style rendering.
+     */
+    dateFormat?: string;
+}
+/** Number of calendar months shown side-by-side. */
+export interface CalendarMonthsPickerProps {
+    numberOfMonths?: 1 | 2;
+}
+/** Time-of-day controls for time-bearing modes. */
+export interface TimeOfDayPickerProps {
+    /** Time slot step in minutes. Default `15`. */
+    step?: AllowedStep;
+    /** Display cycle for time labels. Default detected from locale. */
+    hourCycle?: HourCycle;
+    /**
+     * date-fns format pattern for the time portion of the trigger label.
+     * Examples: `'HH:mm'`, `'hh:mm a'`, `'HH:mm:ss'`. When set, overrides
+     * `hourCycle` for the trigger display.
+     */
+    timeFormat?: string;
+}
+/**
+ * Timezone props — only meaningful for the modes whose value is a UTC ISO string
+ * (`datetime`, `datetime-range`, `date-range-time`).
+ */
+export interface TimezonePickerProps {
+    /** IANA timezone name. Default: browser-detected. */
+    timezone?: string;
+    /** Hide the always-on TZ indicator. */
+    hideTimezone?: boolean;
+}
+/** Preset rail — only meaningful when a wrapper renders `<PickerPresets />`. */
+export interface PresetsPickerProps {
+    /** Replace default presets entirely. */
+    presets?: readonly PickerPreset[];
+    /** Filter default presets by key. Ignored when `presets` is set. */
+    excludePresets?: readonly string[];
+}
+/**
+ * `commit` override — only exposed on wrappers where the choice is meaningful.
+ *
+ * Date + time combined modes (`datetime` / `datetime-range` / `date-range-time`)
+ * are pinned to `'apply'` internally and intentionally don't extend this mixin:
+ * picking a date alone shouldn't auto-commit a value with an unconfirmed
+ * 00:00 time.
+ */
+export interface CommitOverridePickerProps {
+    /** Override the default per-mode commit semantics (`'immediate'` | `'apply'`). */
+    commit?: PickerCommit;
+}
+/**
+ * @deprecated Compose the per-feature mixin types instead — picking only
+ * the ones a given wrapper actually wires through. Kept as a back-compat
+ * alias of the previous union so existing consumers don't break.
+ *
+ * INTENTIONAL SCOPE: this alias mirrors the **previous** WrapperBaseProps
+ * shape exactly. It excludes `numberOfMonths` (CalendarMonthsPickerProps),
+ * `step`/`hourCycle`/`timeFormat` (TimeOfDayPickerProps), `timezone`
+ * (TimezonePickerProps), and `dateFormat` because those props were never
+ * on the old union — adding them here would silently widen the alias and
+ * break the back-compat contract. Use the new mixins directly to opt in.
+ */
+export type WrapperBaseProps = UniversalPickerProps & CommitOverridePickerProps & DateBearingPickerProps & PresetsPickerProps & Pick<TimezonePickerProps, 'hideTimezone'>;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/features/picker/wrappers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/features/picker/wrappers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAElF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAA;IAC5C;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,kDAAkD;IAClD,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,kDAAkD;IAClD,OAAO,CAAC,EAAE,IAAI,CAAA;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,oEAAoE;IACpE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GACtB,oBAAoB,GACpB,yBAAyB,GACzB,sBAAsB,GACtB,kBAAkB,GAClB,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAA"}