@k3-universe/react-kit 0.0.9 → 0.0.10

package/src/kit/components/monthpicker/MonthInput.tsx

@@ -0,0 +1,122 @@
+'use client';
+
+import * as React from 'react';
+import { Calendar as CalendarIcon } from 'lucide-react';
+import { cn } from '../../../shadcn/lib/utils';
+import { Button } from '../../../shadcn/ui/button';
+import { Popover, PopoverContent, PopoverTrigger } from '../../../shadcn/ui/popover';
+import { MonthPicker } from './MonthPicker';
+
+export interface MonthInputProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+  value?: Date | null;
+  onChange?: (date: Date | null) => void;
+  placeholder?: string;
+  disabled?: boolean;
+  minDate?: Date;
+  maxDate?: Date;
+  disabledDates?: Date[];
+  format?: (date: Date) => string;
+  buttonVariant?: React.ComponentProps<typeof Button>['variant'];
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  showFooter?: boolean; // default true
+  cancelLabel?: string; // default 'Cancel'
+  applyLabel?: string; // default 'Apply'
+  // Back-compat aliases
+  clearLabel?: string;
+  closeLabel?: string;
+}
+
+export function MonthInput({
+  value,
+  onChange,
+  placeholder = 'Pick a month',
+  disabled,
+  minDate,
+  maxDate,
+  disabledDates,
+  format,
+  className,
+  buttonVariant = 'outline',
+  ...props
+}: MonthInputProps) {
+  const [internalOpen, setInternalOpen] = React.useState(false);
+  const isOpen = typeof props.open === 'boolean' ? props.open : internalOpen;
+  const setOpen = (o: boolean) => (props.onOpenChange ? props.onOpenChange(o) : setInternalOpen(o));
+  const [draft, setDraft] = React.useState<Date | null>(value ?? null);
+
+  React.useEffect(() => {
+    if (isOpen) {
+      // Reset draft when opening to current value
+      setDraft(value ?? null);
+    }
+  }, [isOpen, value]);
+
+  const label = value
+    ? format
+      ? format(value)
+      : value.toLocaleDateString(undefined, { year: 'numeric', month: 'short' })
+    : placeholder;
+
+  return (
+    <div className={cn('w-fit', className)} {...props}>
+      <Popover open={isOpen} onOpenChange={setOpen}>
+        <PopoverTrigger asChild>
+          <Button
+            type="button"
+            disabled={disabled}
+            variant={buttonVariant}
+            className={cn('w-[240px] justify-start text-left font-normal', !value && 'text-muted-foreground')}
+          >
+            <CalendarIcon className="mr-2 h-4 w-4" />
+            {label}
+          </Button>
+        </PopoverTrigger>
+        <PopoverContent className="p-0" align="start">
+          <MonthPicker
+            selectedMonth={draft ?? undefined}
+            onMonthSelect={(d) => {
+              if (disabled) return;
+              setDraft(d ?? null);
+            }}
+            minDate={minDate}
+            maxDate={maxDate}
+            disabledDates={disabledDates}
+            variant={{
+              calendar: { main: 'ghost', selected: 'default' },
+              chevrons: 'outline',
+            }}
+          />
+          {(props.showFooter ?? true) && (
+            <div className="flex items-center justify-between gap-2 p-2 border-t">
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                onClick={() => setOpen(false)}
+                disabled={disabled}
+              >
+                {props.cancelLabel ?? props.clearLabel ?? 'Cancel'}
+              </Button>
+              <Button
+                type="button"
+                variant="default"
+                size="sm"
+                onClick={() => {
+                  onChange?.(draft ?? null);
+                  setOpen(false);
+                }}
+              >
+                {props.applyLabel ?? props.closeLabel ?? 'Apply'}
+              </Button>
+            </div>
+          )}
+        </PopoverContent>
+      </Popover>
+    </div>
+  );
+}
+
+MonthInput.displayName = 'MonthInput';
+
+export default MonthInput;

package/src/kit/components/monthpicker/MonthPicker.tsx

@@ -0,0 +1,223 @@
+'use client';
+import * as React from 'react';
+import { ChevronLeft, ChevronRight } from 'lucide-react';
+import { buttonVariants } from '@/shadcn/ui/button';
+import { cn } from '@/shadcn/lib/utils';
+
+type Month = {
+  number: number;
+  name: string;
+};
+
+const MONTHS: Month[][] = [
+  [
+    { number: 0, name: 'Jan' },
+    { number: 1, name: 'Feb' },
+    { number: 2, name: 'Mar' },
+    { number: 3, name: 'Apr' },
+  ],
+  [
+    { number: 4, name: 'May' },
+    { number: 5, name: 'Jun' },
+    { number: 6, name: 'Jul' },
+    { number: 7, name: 'Aug' },
+  ],
+  [
+    { number: 8, name: 'Sep' },
+    { number: 9, name: 'Oct' },
+    { number: 10, name: 'Nov' },
+    { number: 11, name: 'Dec' },
+  ],
+];
+
+type MonthCalProps = {
+  selectedMonth?: Date;
+  onMonthSelect?: (date: Date) => void;
+  onYearForward?: () => void;
+  onYearBackward?: () => void;
+  callbacks?: {
+    yearLabel?: (year: number) => string;
+    monthLabel?: (month: Month) => string;
+  };
+  variant?: {
+    calendar?: {
+      main?: ButtonVariant;
+      selected?: ButtonVariant;
+    };
+    chevrons?: ButtonVariant;
+  };
+  minDate?: Date;
+  maxDate?: Date;
+  disabledDates?: Date[];
+};
+
+type ButtonVariant =
+  | 'default'
+  | 'outline'
+  | 'ghost'
+  | 'link'
+  | 'destructive'
+  | 'secondary'
+  | null
+  | undefined;
+
+function MonthPicker({
+  onMonthSelect,
+  selectedMonth,
+  minDate,
+  maxDate,
+  disabledDates,
+  callbacks,
+  onYearBackward,
+  onYearForward,
+  variant,
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement> & MonthCalProps) {
+  return (
+    <div className={cn('min-w-[200px] w-[280px] p-3', className)} {...props}>
+      <div className="flex flex-col sm:flex-row space-y-4 sm:space-x-4 sm:space-y-0">
+        <div className="space-y-4 w-full">
+          <MonthCal
+            onMonthSelect={onMonthSelect}
+            callbacks={callbacks}
+            selectedMonth={selectedMonth}
+            onYearBackward={onYearBackward}
+            onYearForward={onYearForward}
+            variant={variant}
+            minDate={minDate}
+            maxDate={maxDate}
+            disabledDates={disabledDates}
+          />
+        </div>
+      </div>
+    </div>
+  );
+}
+
+function MonthCal({
+  selectedMonth,
+  onMonthSelect,
+  callbacks,
+  variant,
+  minDate,
+  maxDate,
+  disabledDates,
+  onYearBackward,
+  onYearForward,
+}: MonthCalProps) {
+  const [year, setYear] = React.useState<number>(
+    selectedMonth?.getFullYear() ?? new Date().getFullYear()
+  );
+  const [month, setMonth] = React.useState<number>(
+    selectedMonth?.getMonth() ?? new Date().getMonth()
+  );
+  const [menuYear, setMenuYear] = React.useState<number>(year);
+
+  if (minDate && maxDate && minDate > maxDate) minDate = maxDate;
+
+  const disabledDatesMapped = disabledDates?.map((d) => {
+    return { year: d.getFullYear(), month: d.getMonth() };
+  });
+
+  return (
+    <>
+      <div className="flex justify-center pt-1 relative items-center">
+        <div className="text-sm font-medium">
+          {callbacks?.yearLabel ? callbacks?.yearLabel(menuYear) : menuYear}
+        </div>
+        <div className="space-x-1 flex items-center">
+          <button
+            type="button"
+            onClick={() => {
+              setMenuYear(menuYear - 1);
+              if (onYearBackward) onYearBackward();
+            }}
+            className={cn(
+              buttonVariants({ variant: variant?.chevrons ?? 'outline' }),
+              'inline-flex items-center justify-center h-7 w-7 p-0 absolute left-1'
+            )}
+          >
+            <ChevronLeft className="opacity-50 h-4 w-4" />
+          </button>
+          <button
+            type="button"
+            onClick={() => {
+              setMenuYear(menuYear + 1);
+              if (onYearForward) onYearForward();
+            }}
+            className={cn(
+              buttonVariants({ variant: variant?.chevrons ?? 'outline' }),
+              'inline-flex items-center justify-center h-7 w-7 p-0 absolute right-1'
+            )}
+          >
+            <ChevronRight className="opacity-50 h-4 w-4" />
+          </button>
+        </div>
+      </div>
+      <table className="w-full border-collapse space-y-1">
+        <tbody>
+          {MONTHS.map((monthRow, a) => {
+            return (
+              // biome-ignore lint/suspicious/noArrayIndexKey: <explanation>
+              <tr key={`row-${a}`} className="flex w-full mt-2">
+                {monthRow.map((m) => {
+                  return (
+                    <td
+                      key={`month-${m.number}`}
+                      className="h-10 w-1/4 text-center text-sm p-0 relative [&:has([aria-selected].day-range-end)]:rounded-r-md [&:has([aria-selected].day-outside)]:bg-accent/50 [&:has([aria-selected])]:bg-accent first:[&:has([aria-selected])]:rounded-l-md last:[&:has([aria-selected])]:rounded-r-md focus-within:relative focus-within:z-20"
+                    >
+                      <button
+                        type="button"
+                        onClick={() => {
+                          setMonth(m.number);
+                          setYear(menuYear);
+                          if (onMonthSelect)
+                            onMonthSelect(new Date(menuYear, m.number));
+                        }}
+                        disabled={
+                          (maxDate
+                            ? menuYear > maxDate?.getFullYear() ||
+                              (menuYear === maxDate?.getFullYear() &&
+                                m.number > maxDate.getMonth())
+                            : false) ||
+                          (minDate
+                            ? menuYear < minDate?.getFullYear() ||
+                              (menuYear === minDate?.getFullYear() &&
+                                m.number < minDate.getMonth())
+                            : false) ||
+                          (disabledDatesMapped
+                            ? disabledDatesMapped?.some(
+                                (d) => d.year === menuYear && d.month === m.number
+                              )
+                            : false)
+                        }
+                        className={cn(
+                          buttonVariants({
+                            variant:
+                              month === m.number && menuYear === year
+                                ? variant?.calendar?.selected ?? 'default'
+                                : variant?.calendar?.main ?? 'ghost',
+                          }),
+                          'h-full w-full p-0 font-normal aria-selected:opacity-100'
+                        )}
+                      >
+                        {callbacks?.monthLabel
+                          ? callbacks.monthLabel(m)
+                          : m.name}
+                      </button>
+                    </td>
+                  );
+                })}
+              </tr>
+            );
+          })}
+        </tbody>
+      </table>
+    </>
+  );
+}
+
+MonthPicker.displayName = 'MonthPicker';
+
+export { MonthPicker };

package/src/kit/components/monthpicker/MonthRangeInput.tsx

@@ -0,0 +1,132 @@
+'use client';
+
+import * as React from 'react';
+import { Calendar as CalendarIcon } from 'lucide-react';
+import { cn } from '../../../shadcn/lib/utils';
+import { Button } from '../../../shadcn/ui/button';
+import { Popover, PopoverContent, PopoverTrigger } from '../../../shadcn/ui/popover';
+import { MonthRangePicker } from './MonthRangePicker';
+
+export interface MonthRangeInputProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+  value?: { start?: Date | null; end?: Date | null } | null;
+  onChange?: (range: { start?: Date | null; end?: Date | null } | null) => void;
+  placeholder?: string;
+  disabled?: boolean;
+  minDate?: Date;
+  maxDate?: Date;
+  // quick selectors panel
+  showQuickSelectors?: boolean;
+  // formatting
+  format?: (start?: Date | null, end?: Date | null) => string;
+  buttonVariant?: React.ComponentProps<typeof Button>['variant'];
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  popoverSide?: 'top' | 'right' | 'bottom' | 'left';
+  // Footer
+  showFooter?: boolean; // default true
+  cancelLabel?: string; // default 'Cancel'
+  applyLabel?: string; // default 'Apply'
+}
+
+export function MonthRangeInput({
+  value,
+  onChange,
+  placeholder = 'Pick a month range',
+  disabled,
+  minDate,
+  maxDate,
+  showQuickSelectors = true,
+  format,
+  className,
+  buttonVariant = 'outline',
+  popoverSide,
+  ...props
+}: MonthRangeInputProps) {
+  const [internalOpen, setInternalOpen] = React.useState(false);
+  const isOpen = typeof props.open === 'boolean' ? props.open : internalOpen;
+  const setOpen = (o: boolean) => (props.onOpenChange ? props.onOpenChange(o) : setInternalOpen(o));
+  const [draft, setDraft] = React.useState<{ start?: Date | null; end?: Date | null } | null>(value ?? null);
+
+  React.useEffect(() => {
+    if (isOpen) {
+      setDraft(value ?? null);
+    }
+  }, [isOpen, value]);
+
+  const label = ((): string => {
+    const s = value?.start ?? null;
+    const e = value?.end ?? null;
+    if (format) return format(s, e);
+    if (s && e) {
+      const fmt = (d: Date) => d.toLocaleDateString(undefined, { year: 'numeric', month: 'short' });
+      return `${fmt(s)} – ${fmt(e)}`;
+    }
+    return placeholder;
+  })();
+
+  return (
+    <div className={cn('w-fit', className)} {...props}>
+      <Popover open={isOpen} onOpenChange={setOpen}>
+        <PopoverTrigger asChild>
+          <Button
+            type="button"
+            disabled={disabled}
+            variant={buttonVariant}
+            className={cn('w-[280px] justify-start text-left font-normal', !value && 'text-muted-foreground')}
+          >
+            <CalendarIcon className="mr-2 h-4 w-4" />
+            {label}
+          </Button>
+        </PopoverTrigger>
+        <PopoverContent className="p-2 w-auto max-w-none" align="start" side={popoverSide}>
+          <MonthRangePicker
+            selectedMonthRange={draft?.start && draft?.end ? { start: draft.start, end: draft.end } : undefined}
+            onStartMonthSelect={(d) => {
+              if (disabled) return;
+              setDraft({ start: d, end: d });
+            }}
+            onMonthRangeSelect={({ start, end }) => {
+              if (disabled) return;
+              setDraft({ start, end });
+            }}
+            minDate={minDate}
+            maxDate={maxDate}
+            showQuickSelectors={showQuickSelectors}
+            variant={{
+              calendar: { main: 'ghost', selected: 'default' },
+              chevrons: 'outline',
+            }}
+          />
+          {(props.showFooter ?? true) && (
+            <div className="flex items-center justify-between gap-2 pt-2 border-t mt-3">
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                onClick={() => setOpen(false)}
+                disabled={disabled}
+              >
+                {props.cancelLabel ?? 'Cancel'}
+              </Button>
+              <Button
+                type="button"
+                variant="default"
+                size="sm"
+                onClick={() => {
+                  onChange?.(draft ?? null);
+                  setOpen(false);
+                }}
+              >
+                {props.applyLabel ?? 'Apply'}
+              </Button>
+            </div>
+          )}
+        </PopoverContent>
+      </Popover>
+    </div>
+  );
+}
+
+MonthRangeInput.displayName = 'MonthRangeInput';
+
+export default MonthRangeInput;