@dev-dga/react 1.0.0 → 1.1.0

package/dist/date-picker.d.ts

@@ -0,0 +1,147 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { ReactNode } from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+type CalendarSystem = 'gregorian' | 'hijri';
+interface CalendarLabels {
+    gregorian: string;
+    hijri: string;
+}
+
+declare const datePickerTriggerVariants: (props?: ({
+    size?: "md" | "lg" | null | undefined;
+    variant?: "default" | "filled-lighter" | "filled-darker" | null | undefined;
+    error?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const datePickerVariants: (props?: ({
+    size?: "md" | "lg" | null | undefined;
+    variant?: "default" | "filled-lighter" | "filled-darker" | null | undefined;
+    error?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface DatePickerProps extends VariantProps<typeof datePickerTriggerVariants> {
+    /** Currently selected date (controlled). Local Y/M/D. */
+    value?: Date | null;
+    /** Initial value when uncontrolled. */
+    defaultValue?: Date | null;
+    /** Fires whenever the user picks a day. `null` when cleared. */
+    onChange?: (value: Date | null) => void;
+    /** Earliest pickable date (inclusive). */
+    minValue?: Date;
+    /** Latest pickable date (inclusive). */
+    maxValue?: Date;
+    /** Visible label above the trigger. */
+    label?: ReactNode;
+    /** Hint shown below the trigger. Hidden while an error message is showing. */
+    helperText?: ReactNode;
+    /** Message shown below the trigger when `error` is true. */
+    errorMessage?: ReactNode;
+    /** Marks the field invalid — sets `aria-invalid` and error styling. */
+    error?: boolean;
+    /** Marks the field required — adds the asterisk + `aria-required`. */
+    required?: boolean;
+    /** Disables the trigger entirely. */
+    disabled?: boolean;
+    /** Read-only: value is shown but not editable (segments + calendar locked). */
+    readOnly?: boolean;
+    /** Caller-supplied id for the field. */
+    id?: string;
+    /** Forwarded to the Group (the trigger row), matching Input/Select. */
+    className?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    /**
+     * Calendar system (controlled). Omit to let the user toggle freely with
+     * the in-popover switch.
+     */
+    calendar?: CalendarSystem;
+    /** Initial calendar system when uncontrolled. Defaults to `'gregorian'`. */
+    defaultCalendar?: CalendarSystem;
+    /** Fires whenever the calendar system toggles. */
+    onCalendarChange?: (calendar: CalendarSystem) => void;
+    /**
+     * Show the Gregorian↔Hijri toggle inside the popover. Defaults to `true`,
+     * but is forced off when `calendar` is controlled — a toggle that ignores
+     * its click is a worse footgun than no toggle.
+     */
+    showCalendarToggle?: boolean;
+    /** Override the toggle labels. Defaults are locale-aware (English / Arabic). */
+    calendarLabels?: CalendarLabels;
+    /**
+     * When `true`, each day cell also shows the *other* calendar's day number
+     * as small secondary text (e.g., Hijri active → Gregorian day shown small
+     * underneath). Helps users cross-reference dates between calendar systems
+     * without round-tripping the toggle. Defaults to `false`.
+     */
+    showSecondaryCalendar?: boolean;
+}
+declare function DatePicker({ value: controlledValue, defaultValue, onChange, minValue, maxValue, label, helperText, errorMessage, error, required, disabled, readOnly, size, variant, id, className, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, calendar: controlledCalendar, defaultCalendar, onCalendarChange, showCalendarToggle, calendarLabels, showSecondaryCalendar, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+
+declare const dateRangePickerTriggerVariants: (props?: ({
+    size?: "md" | "lg" | null | undefined;
+    variant?: "default" | "filled-lighter" | "filled-darker" | null | undefined;
+    error?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const dateRangePickerVariants: (props?: ({
+    size?: "md" | "lg" | null | undefined;
+    variant?: "default" | "filled-lighter" | "filled-darker" | null | undefined;
+    error?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** A complete, inclusive date range. Both ends are local Y/M/D. */
+interface DateRange {
+    start: Date;
+    end: Date;
+}
+interface DateRangePickerProps extends VariantProps<typeof dateRangePickerTriggerVariants> {
+    /** Currently selected range (controlled). `null` clears it. */
+    value?: DateRange | null;
+    /** Initial range when uncontrolled. */
+    defaultValue?: DateRange | null;
+    /** Fires when a complete range is picked, or `null` when cleared. */
+    onChange?: (value: DateRange | null) => void;
+    /** Earliest pickable date (inclusive). */
+    minValue?: Date;
+    /** Latest pickable date (inclusive). */
+    maxValue?: Date;
+    /** Visible label above the trigger. */
+    label?: ReactNode;
+    /** Hint shown below the trigger. Hidden while an error message is showing. */
+    helperText?: ReactNode;
+    /** Message shown below the trigger when `error` is true. */
+    errorMessage?: ReactNode;
+    /** Marks the field invalid — sets `aria-invalid` and error styling. */
+    error?: boolean;
+    /** Marks the field required — adds the asterisk + `aria-required`. */
+    required?: boolean;
+    /** Disables the trigger entirely. */
+    disabled?: boolean;
+    /** Read-only: value is shown but not editable (segments + calendar locked). */
+    readOnly?: boolean;
+    /** Caller-supplied id for the field. */
+    id?: string;
+    /** Forwarded to the Group (the trigger row), matching Input/Select. */
+    className?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    /** Calendar system (controlled). Omit to let the user toggle freely. */
+    calendar?: CalendarSystem;
+    /** Initial calendar system when uncontrolled. Defaults to `'gregorian'`. */
+    defaultCalendar?: CalendarSystem;
+    /** Fires whenever the calendar system toggles. */
+    onCalendarChange?: (calendar: CalendarSystem) => void;
+    /**
+     * Show the Gregorian↔Hijri toggle inside the popover. Defaults to `true`, but
+     * is forced off when `calendar` is controlled.
+     */
+    showCalendarToggle?: boolean;
+    /** Override the toggle labels. Defaults are locale-aware (English / Arabic). */
+    calendarLabels?: CalendarLabels;
+    /**
+     * When `true`, each day cell also shows the *other* calendar's day number as
+     * small secondary text. Helps cross-reference Hijri↔Gregorian. Default `false`.
+     */
+    showSecondaryCalendar?: boolean;
+}
+declare function DateRangePicker({ value: controlledValue, defaultValue, onChange, minValue, maxValue, label, helperText, errorMessage, error, required, disabled, readOnly, size, variant, id, className, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, calendar: controlledCalendar, defaultCalendar, onCalendarChange, showCalendarToggle, calendarLabels, showSecondaryCalendar, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+
+export { type CalendarLabels, type CalendarSystem, DatePicker, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, datePickerVariants, dateRangePickerTriggerVariants, dateRangePickerVariants };

package/dist/date-picker.js

@@ -0,0 +1,25 @@
+"use client";
+import "./chunk-7WDQQSRQ.js";
+import "./chunk-4SDRJW3D.js";
+import {
+  DatePicker,
+  datePickerVariants
+} from "./chunk-BC2DJQ3Y.js";
+import {
+  DateRangePicker,
+  dateRangePickerTriggerVariants,
+  dateRangePickerVariants
+} from "./chunk-XIJKAUCN.js";
+import "./chunk-SDFMITFO.js";
+import "./chunk-AR7K3D3Z.js";
+import "./chunk-FFGALWM2.js";
+import "./chunk-7NTT2UXP.js";
+import "./chunk-TMXABSFE.js";
+export {
+  DatePicker,
+  DateRangePicker,
+  datePickerVariants,
+  dateRangePickerTriggerVariants,
+  dateRangePickerVariants
+};
+//# sourceMappingURL=date-picker.js.map

package/dist/date-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}