flikkui 0.1.0-beta.8 → 0.2.0-beta.1

package/dist/components/forms/DatePicker/DatePicker.js

@@ -0,0 +1,143 @@
+import React__default, { createContext, useState, useRef, useEffect } from 'react';
+import { datePickerTheme } from './DatePicker.theme.js';
+import { FormLabel } from '../FormLabel/FormLabel.js';
+import { DatePickerTrigger } from './DatePickerTrigger.js';
+import { DatePickerContent } from './DatePickerContent.js';
+import { DatePickerPresets } from './DatePickerPresets.js';
+import { cn } from '../../../utils/cn.js';
+import { formatDateCustom } from '../../../utils/dateUtils.js';
+
+const DatePickerContext = createContext(undefined);
+/**
+ * Format date for display
+ * Uses formatString if provided, otherwise falls back to dateFormat (Intl API)
+ */
+const formatDate = (date, formatString, options = {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+}) => {
+    // If formatString is provided, use the custom formatter
+    if (formatString) {
+        return formatDateCustom(date, formatString);
+    }
+    // Otherwise use the Intl API
+    return date.toLocaleDateString(undefined, options);
+};
+/**
+ * Format date range for display
+ */
+const formatDateRange = (range, formatString, options) => {
+    if (!range.start && !range.end) {
+        return "";
+    }
+    if (range.start && !range.end) {
+        return formatDate(range.start, formatString, options);
+    }
+    if (!range.start && range.end) {
+        return formatDate(range.end, formatString, options);
+    }
+    return `${formatDate(range.start, formatString, options)} - ${formatDate(range.end, formatString, options)}`;
+};
+/**
+ * Main DatePicker Component - follows Select pattern exactly
+ */
+const DatePickerComponent = ({ id, name, mode = "single", size = "md", state = "default", value, defaultValue, placeholder = "Select date...", disabled = false, required = false, label, helperText, onChange, onFocus, onBlur, minDate, maxDate, isDateDisabled, showToday = true, selectTodayByDefault = false, weekdays, months, dateFormat, formatString, presets, className = "", wrapperClassName = "", portal = true, placement = "bottom-start", offset = 4, children, }) => {
+    var _a, _b;
+    // Merge theme with defaults
+    const theme = { ...datePickerTheme };
+    // State
+    const [isOpen, setIsOpen] = useState(false);
+    const [selectedValue, setSelectedValue] = useState(value || defaultValue);
+    // Refs
+    const triggerRef = useRef(null);
+    const contentRef = useRef(null);
+    // Update internal state when prop value changes
+    useEffect(() => {
+        setSelectedValue(value);
+    }, [value]);
+    // Date selection handler (single mode)
+    const handleDateSelect = (newDate) => {
+        if (mode === "single") {
+            if (newDate !== selectedValue) {
+                setSelectedValue(newDate);
+                onChange === null || onChange === void 0 ? void 0 : onChange(newDate);
+            }
+            setIsOpen(false);
+        }
+    };
+    // Range selection handler (range mode)
+    const handleRangeSelect = (newRange) => {
+        setSelectedValue(newRange);
+        onChange === null || onChange === void 0 ? void 0 : onChange(newRange);
+        // Don't auto-close anymore - footer Apply button handles this
+    };
+    // Button click handler
+    const handleButtonClick = () => {
+        if (!disabled) {
+            setIsOpen((prev) => !prev);
+        }
+    };
+    // Format selected date/range for display
+    // formatString takes precedence over dateFormat
+    const displayValue = selectedValue
+        ? mode === "single" && selectedValue instanceof Date
+            ? formatDate(selectedValue, formatString, dateFormat)
+            : mode === "range" &&
+                typeof selectedValue === "object" &&
+                "start" in selectedValue
+                ? formatDateRange(selectedValue, formatString, dateFormat)
+                : placeholder
+        : placeholder;
+    // Calendar icon is now built-in to the trigger component
+    // Generate a unique ID if not provided
+    const datePickerId = id || `datepicker-${Math.random().toString(36).substring(2, 9)}`;
+    // Helper text state style
+    const helperTextStateStyle = theme.helperTextStates[state];
+    const helperTextStyle = theme.helperTextStyle;
+    // Container style
+    const containerStyle = theme.containerStyle;
+    return (React__default.createElement(DatePickerContext.Provider, { value: {
+            mode,
+            isOpen,
+            setIsOpen,
+            selectedValue,
+            setSelectedValue,
+            minDate,
+            maxDate,
+            isDateDisabled,
+            showToday,
+            selectTodayByDefault,
+            weekdays,
+            months,
+            handleDateSelect,
+            handleRangeSelect,
+            size,
+            state,
+            theme,
+            triggerRef,
+            contentRef,
+        } },
+        React__default.createElement("div", { className: cn(containerStyle, wrapperClassName) },
+            label && (React__default.createElement(FormLabel, { htmlFor: datePickerId, required: required }, label)),
+            React__default.createElement(DatePickerTrigger, { id: datePickerId, disabled: disabled, isOpen: isOpen, state: state, size: size, onClick: handleButtonClick, onFocus: onFocus, onBlur: onBlur, className: className },
+                React__default.createElement("span", { className: cn("block truncate", selectedValue ? theme.valueTextStyle : theme.placeholderTextStyle) }, displayValue)),
+            React__default.createElement(DatePickerContent, { isOpen: isOpen, onClose: () => setIsOpen(false), portal: portal, placement: placement, offset: offset, presets: presets }, children),
+            helperText && (React__default.createElement("p", { className: cn(helperTextStyle, helperTextStateStyle) }, helperText)),
+            name && mode === "single" && selectedValue instanceof Date && (React__default.createElement("input", { type: "hidden", name: name, value: selectedValue.toISOString() })),
+            name &&
+                mode === "range" &&
+                selectedValue &&
+                typeof selectedValue === "object" &&
+                "start" in selectedValue && (React__default.createElement(React__default.Fragment, null,
+                React__default.createElement("input", { type: "hidden", name: `${name}[start]`, value: ((_a = selectedValue.start) === null || _a === void 0 ? void 0 : _a.toISOString()) || "" }),
+                React__default.createElement("input", { type: "hidden", name: `${name}[end]`, value: ((_b = selectedValue.end) === null || _b === void 0 ? void 0 : _b.toISOString()) || "" }))))));
+};
+// Create a compound component with proper typing
+const DatePickerWithCompounds = DatePickerComponent;
+// Attach compound components
+DatePickerWithCompounds.Trigger = DatePickerTrigger;
+DatePickerWithCompounds.Content = DatePickerContent;
+DatePickerWithCompounds.Presets = DatePickerPresets;
+
+export { DatePickerWithCompounds as DatePicker, DatePickerContent, DatePickerContext, DatePickerPresets, DatePickerTrigger, DatePickerWithCompounds };

package/dist/components/forms/DatePicker/DatePicker.theme.d.ts

@@ -1,6 +1,9 @@
-import { DatePickerThemeOverrides } from "./DatePicker.types";
+import { DatePickerTheme } from "./DatePicker.types";
 /**
- * Default theme for the DatePicker component
+ * DatePicker component theme following Select pattern exactly
+ * Uses common forms theme for consistency
+ *
+ * Note: Simple, one-time-use styles are inlined directly in components
+ * Only complex or reused styles are defined here
  */
-export declare const datePickerTheme: DatePickerThemeOverrides;
-export default datePickerTheme;
+export declare const datePickerTheme: DatePickerTheme;

package/dist/components/forms/DatePicker/DatePicker.theme.js

@@ -0,0 +1,54 @@
+import { formsBaseTheme } from '../forms.theme.js';
+
+/**
+ * DatePicker component theme following Select pattern exactly
+ * Uses common forms theme for consistency
+ *
+ * Note: Simple, one-time-use styles are inlined directly in components
+ * Only complex or reused styles are defined here
+ */
+const datePickerTheme = {
+    containerStyle: formsBaseTheme.wrapperStyle,
+    baseStyle: formsBaseTheme.inputGroupBaseStyle + " justify-between cursor-pointer",
+    // Trigger button style - bg-white for light mode; dark mode uses neutral-900
+    triggerButtonStyle: "w-full cursor-pointer bg-white dark:bg-[var(--color-neutral-900)]",
+    // Placeholder text style - matches Input placeholder styling
+    placeholderTextStyle: "text-[var(--color-text-placeholder)] dark:text-[var(--color-neutral-500)]",
+    // Selected value text style
+    valueTextStyle: "text-[var(--color-text-primary)] dark:text-[var(--color-neutral-200)]",
+    triggerSizes: {
+        sm: `${formsBaseTheme.sizes.sm.text} ${formsBaseTheme.sizes.sm.padding} ${formsBaseTheme.sizes.sm.height}`,
+        md: `${formsBaseTheme.sizes.md.text} ${formsBaseTheme.sizes.md.padding} ${formsBaseTheme.sizes.md.height}`,
+        lg: `${formsBaseTheme.sizes.lg.text} ${formsBaseTheme.sizes.lg.padding} ${formsBaseTheme.sizes.lg.height}`,
+    },
+    triggerStates: formsBaseTheme.states,
+    triggerHoverStates: formsBaseTheme.hoverStates,
+    triggerFocusStates: formsBaseTheme.focusStates,
+    iconEndStyle: formsBaseTheme.iconStyles.right,
+    iconEndPadding: formsBaseTheme.iconStyles.padding.right,
+    // Dropdown content - with dark mode support
+    contentStyle: "min-w-fit max-w-none bg-white border border-[var(--color-border)] rounded-lg shadow-real-xl p-0 overflow-hidden z-[9999] fixed " +
+        "dark:bg-[var(--color-neutral-900)] dark:border-[var(--color-neutral-700)]",
+    contentWithPresetsStyle: "flex w-fit max-w-none bg-white border border-[var(--color-border)] rounded-lg shadow-lg p-0 overflow-hidden z-[9999] fixed " +
+        "dark:bg-[var(--color-neutral-900)] dark:border-[var(--color-neutral-700)]",
+    // Presets sidebar - with dark mode support
+    presetsContainerStyle: "flex flex-col gap-1 p-3 border-r border-[var(--color-border)] bg-[var(--color-neutral-50)] min-w-[180px] " +
+        "dark:bg-[var(--color-neutral-800)] dark:border-[var(--color-neutral-700)]",
+    // Preset button - with dark mode support
+    presetButtonStyle: "w-full text-left px-3 py-2 text-sm rounded-md transition-colors cursor-pointer " +
+        "text-[var(--color-text-secondary)] hover:bg-white hover:text-[var(--color-text-primary)] " +
+        "focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-primary)] focus-visible:ring-offset-2 " +
+        "data-[active=true]:bg-white data-[active=true]:text-[var(--color-text-primary)] data-[active=true]:font-medium " +
+        // Dark mode
+        "dark:text-[var(--color-neutral-400)] dark:hover:bg-[var(--color-neutral-700)] dark:hover:text-[var(--color-neutral-200)] " +
+        "dark:data-[active=true]:bg-[var(--color-neutral-700)] dark:data-[active=true]:text-[var(--color-neutral-100)] " +
+        "dark:focus-visible:ring-offset-[var(--color-neutral-800)]",
+    helperTextStyle: formsBaseTheme.helperText,
+    helperTextStates: {
+        default: "text-[var(--color-text-muted)] dark:text-[var(--color-neutral-400)]",
+        disabled: "text-[var(--color-text-disabled)] dark:text-[var(--color-neutral-600)]",
+        invalid: "text-[var(--color-danger)] dark:text-[var(--color-danger-400)]",
+    },
+};
+
+export { datePickerTheme };

package/dist/components/forms/DatePicker/DatePicker.types.d.ts

@@ -1,106 +1,144 @@
-import React from 'react';
-import { CalendarView } from './components/CalendarHeader';
+import React from "react";
 /**
- * DatePicker component props
- * @property {Date} value - The selected date
- * @property {Date} defaultValue - Default selected date for uncontrolled mode
- * @property {function} onChange - Callback when date is selected
- * @property {Date} minDate - Minimum selectable date
- * @property {Date} maxDate - Maximum selectable date
- * @property {function} isDateDisabled - Function to determine if a date should be disabled
- * @property {string} dateFormat - Format for displaying dates (default: 'yyyy-MM-dd')
- * @property {boolean} showToday - Whether to highlight today's date
- * @property {string[]} weekdays - Custom weekday labels
- * @property {string[]} months - Custom month names
- * @property {boolean} enableYearPicker - Enable year picker functionality
- * @property {boolean} enableMonthPicker - Enable month picker functionality
- * @property {boolean} showTodayButton - Show today button in header
- * @property {CalendarView} defaultView - Default view mode
+ * Size variants for DatePicker components
  */
-export interface DatePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
-    /** The selected date (controlled mode) */
-    value?: Date;
-    /** Default selected date (uncontrolled mode) */
-    defaultValue?: Date;
-    /** Callback fired when a date is selected */
-    onChange?: (date: Date | null) => void;
+export type DatePickerSize = "sm" | "md" | "lg";
+/**
+ * State variants for DatePicker components (aligned with forms theme)
+ */
+export type DatePickerState = "default" | "disabled" | "invalid";
+/**
+ * Placement options for DatePicker popover
+ */
+export type DatePickerPlacement = "bottom-start" | "bottom-end" | "top-start" | "top-end";
+/**
+ * Selection mode for DatePicker
+ */
+export type DatePickerMode = "single" | "range";
+import type { DateRange } from "../../core/Calendar/Calendar.types";
+export type { DateRange };
+/**
+ * Preset for quick date range selection
+ */
+export interface DateRangePreset {
+    label: string;
+    getValue: () => DateRange;
+}
+/**
+ * Main DatePicker component props (follows Select pattern)
+ */
+export interface DatePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue" | "onFocus" | "onBlur"> {
+    /** Unique identifier */
+    id?: string;
+    /** Form field name */
+    name?: string;
+    /** Size variant */
+    size?: DatePickerSize;
+    /** State variant */
+    state?: DatePickerState;
+    /** Selection mode - single date or date range */
+    mode?: DatePickerMode;
+    /** The selected date (controlled mode - for single mode) */
+    value?: Date | DateRange;
+    /** Default selected date (uncontrolled mode - for single mode) */
+    defaultValue?: Date | DateRange;
+    /** Placeholder text when no date selected */
+    placeholder?: string;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Label for the field */
+    label?: string;
+    /** Helper text below the field */
+    helperText?: string;
+    /** Callback fired when a date is selected - type depends on mode */
+    onChange?: (value: Date | DateRange | null) => void;
+    /** Array of preset date ranges (only for range mode) */
+    presets?: DateRangePreset[];
+    /** Focus event handler */
+    onFocus?: (event: React.FocusEvent<HTMLButtonElement>) => void;
+    /** Blur event handler */
+    onBlur?: (event: React.FocusEvent<HTMLButtonElement>) => void;
     /** Minimum selectable date */
     minDate?: Date;
     /** Maximum selectable date */
     maxDate?: Date;
     /** Function to determine if a specific date should be disabled */
     isDateDisabled?: (date: Date) => boolean;
-    /** Format for displaying dates */
-    dateFormat?: string;
     /** Whether to highlight today's date (default: true) */
     showToday?: boolean;
     /** Custom weekday labels (default: ['M', 'T', 'W', 'T', 'F', 'S', 'S']) */
     weekdays?: string[];
     /** Custom month names */
     months?: string[];
-    /** Enable year picker functionality (default: true) */
-    enableYearPicker?: boolean;
-    /** Enable month picker functionality (default: true) */
-    enableMonthPicker?: boolean;
-    /** Show today button in header (default: true) */
-    showTodayButton?: boolean;
-    /** Default view mode (default: 'days') */
-    defaultView?: CalendarView;
-    /** Additional class name for the container */
+    /** Format for displaying selected date (Intl API) */
+    dateFormat?: Intl.DateTimeFormatOptions;
+    /** Custom format string for date display (e.g., 'DD MMM YYYY', 'DD/MM/YYYY') - takes precedence over dateFormat */
+    formatString?: string;
+    /** Auto-select today's date when calendar opens without a value (default: false) */
+    selectTodayByDefault?: boolean;
+    /** Additional class name for trigger button */
+    className?: string;
+    /** Additional class name for wrapper */
+    wrapperClassName?: string;
+    /** Whether to use portal rendering (default: true) */
+    portal?: boolean;
+    /** Popover placement */
+    placement?: DatePickerPlacement;
+    /** Offset from trigger element */
+    offset?: number;
+    /** Children (for compound component usage) */
+    children?: React.ReactNode;
+}
+/**
+ * DatePicker trigger button props
+ */
+export interface DatePickerTriggerProps {
+    id?: string;
+    disabled?: boolean;
+    isOpen?: boolean;
+    state?: DatePickerState;
+    size?: DatePickerSize;
     className?: string;
-    /** Component-level theme overrides */
-    theme?: DatePickerThemeOverrides;
+    onClick?: () => void;
+    onFocus?: (event: React.FocusEvent<HTMLButtonElement>) => void;
+    onBlur?: (event: React.FocusEvent<HTMLButtonElement>) => void;
+    children?: React.ReactNode;
 }
 /**
- * Internal day object used by the DatePicker
+ * DatePicker content props
  */
-export interface DatePickerDay {
-    /** The date object */
-    date: Date;
-    /** Whether this day belongs to the current month */
-    isCurrentMonth: boolean;
-    /** Whether this day is today */
-    isToday: boolean;
-    /** Whether this day is selected */
-    isSelected: boolean;
-    /** Whether this day is disabled */
-    isDisabled: boolean;
+export interface DatePickerContentProps {
+    isOpen?: boolean;
+    className?: string;
+    onClose?: () => void;
+    portal?: boolean;
+    placement?: DatePickerPlacement;
+    offset?: number;
+    presets?: DateRangePreset[];
+    children?: React.ReactNode;
 }
 /**
- * Theme overrides for the DatePicker component
+ * Theme interface for DatePicker (flat structure following library pattern)
+ * Note: Simple, one-time-use styles are inlined directly in components
  */
-export interface DatePickerThemeOverrides {
-    /** Style for the main container */
-    containerStyle?: string;
-    /** Style for the header container */
-    headerStyle?: string;
-    /** Style for the month/year title */
-    titleStyle?: string;
-    /** Style for navigation buttons */
-    navButtonStyle?: string;
-    /** Style for the weekdays header */
-    weekdaysStyle?: string;
-    /** Style for individual weekday labels */
-    weekdayStyle?: string;
-    /** Style for the days grid */
-    daysGridStyle?: string;
-    /** Style for day cells */
-    dayCellStyle?: string;
-    /** Style for day buttons */
-    dayButtonStyle?: string;
-    /** Styles for different day states */
-    dayStates?: {
-        /** Style for current month days */
-        currentMonth?: string;
-        /** Style for other month days */
-        otherMonth?: string;
-        /** Style for today */
-        today?: string;
-        /** Style for selected day */
-        selected?: string;
-        /** Style for disabled days */
-        disabled?: string;
-        /** Style for hover state */
-        hover?: string;
-    };
+export interface DatePickerTheme {
+    containerStyle: string;
+    baseStyle: string;
+    triggerButtonStyle: string;
+    placeholderTextStyle: string;
+    valueTextStyle: string;
+    triggerSizes: Record<DatePickerSize, string>;
+    triggerStates: Record<DatePickerState, string>;
+    triggerHoverStates: Record<DatePickerState, string>;
+    triggerFocusStates: Record<DatePickerState, string>;
+    iconEndStyle: string;
+    iconEndPadding: string;
+    contentStyle: string;
+    contentWithPresetsStyle: string;
+    presetsContainerStyle: string;
+    presetButtonStyle: string;
+    helperTextStyle: string;
+    helperTextStates: Record<DatePickerState, string>;
 }

package/dist/components/forms/DatePicker/DatePickerContent.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import { DatePickerContentProps } from "./DatePicker.types";
+/**
+ * DatePicker Content Component - contains the Calendar and optional Presets
+ * Uses portal positioning like Select component
+ */
+export declare const DatePickerContent: React.FC<DatePickerContentProps>;