@parasutcom/fds 0.1.29 → 0.1.31

package/dist/index.d.ts

@@ -38,6 +38,16 @@ import { Tooltip as Tooltip_2 } from '@base-ui/react/tooltip';
 import { useRender } from '@base-ui/react/use-render';
 import { VariantProps } from 'class-variance-authority';
 
+/**
+ * Active filter instance
+ * value varies by filter type: string (single), string[] (multi), DateRangeValue (date-range)
+ */
+export declare interface ActiveFilter {
+    id: string;
+    category: string;
+    value: string | string[] | DateRangeValue;
+}
+
 export declare function Alert({ className, variant, ...props }: React_2.ComponentProps<'div'> & VariantProps<typeof alertVariants>): JSX.Element;
 
 export declare function AlertAction({ className, ...props }: React_2.ComponentProps<'div'>): JSX.Element;
@@ -485,6 +495,14 @@ declare interface DataTableToolbarProps {
     sticky?: string;
 }
 
+/**
+ * Date range value for date-range filters
+ */
+export declare interface DateRangeValue {
+    from: string;
+    to: string;
+}
+
 export declare function DeleteDialog({ onConfirm, children, mode, count, open: controlledOpen, onOpenChange: controlledOnOpenChange, title, description, }: DeleteDialogProps): JSX.Element;
 
 declare interface DeleteDialogProps {
@@ -633,6 +651,141 @@ declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+/**
+ * Config-only component — renders nothing.
+ * Declare inside <FilterDropdown> to define available filter categories.
+ *
+ * @example
+ * <FilterDropdown ...>
+ *   <FilterDropdown.Category id="status" label="Status" options={statusOptions} />
+ *   <FilterDropdown.Category id="type" label="Type" options={typeOptions} multiple />
+ * </FilterDropdown>
+ */
+declare function FilterCategory(_props: FilterCategoryProps): null;
+
+/**
+ * Filter category configuration — discriminated by type
+ */
+declare interface FilterCategoryBase {
+    /** Unique category identifier */
+    id: string;
+    /** Display label for the category (shown in the "add filter" dropdown) */
+    label: string;
+}
+
+declare interface FilterCategoryDateRange extends FilterCategoryBase {
+    /** Date range filter — renders a calendar popover */
+    type: 'date-range';
+    /** Custom quick-select presets for the date range view */
+    quickPresets?: QuickPreset[];
+}
+
+export declare type FilterCategoryProps = FilterCategorySelect | FilterCategoryDateRange;
+
+declare interface FilterCategorySelect extends FilterCategoryBase {
+    /** Select-based filter (default) */
+    type?: 'select';
+    /** Available options for this category */
+    options: FilterOption[];
+    /** Enable multi-select for this category */
+    multiple?: boolean;
+    /** Show search input for filtering options */
+    searchable?: boolean;
+}
+
+export declare function FilterDatePill({ value, onValueChange, placeholder, onRemove, disabled, autoOpen, quickPresets: quickPresetsProp, }: FilterDatePillProps): JSX.Element;
+
+export declare interface FilterDatePillProps {
+    /** Current date range value ({ from: 'YYYY-MM-DD', to: 'YYYY-MM-DD' }) */
+    value: DateRangeValue;
+    /** Callback when date range changes */
+    onValueChange: (value: DateRangeValue) => void;
+    /** Text shown when no value is selected (e.g., the category label) */
+    placeholder?: string;
+    /** Callback when remove button is clicked */
+    onRemove: () => void;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Auto-open on mount */
+    autoOpen?: boolean;
+    /** Custom quick-select presets shown in the date range view. Defaults to standard month/quarter/year presets. */
+    quickPresets?: QuickPreset[];
+}
+
+export declare const FilterDropdown: typeof FilterDropdownRoot & {
+    Category: typeof FilterCategory;
+};
+
+/**
+ * Filter dropdown props
+ */
+export declare interface FilterDropdownProps {
+    /** FilterDropdown.Category children defining available filter categories */
+    children: ReactNode;
+    /** Current active filters */
+    activeFilters: ActiveFilter[];
+    /** Callback when filters change */
+    onFiltersChange: (filters: ActiveFilter[]) => void;
+    /** Label for add filter button */
+    addFilterLabel: string;
+    /** Label for remove all button */
+    removeAllLabel: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+
+/**
+ * Generic filter dropdown with dynamic categories
+ */
+declare function FilterDropdownRoot({ children, activeFilters, onFiltersChange, addFilterLabel, removeAllLabel, disabled, }: FilterDropdownProps): JSX.Element;
+
+/**
+ * Single filter option
+ */
+export declare interface FilterOption {
+    value: string;
+    label: string;
+}
+
+export declare function FilterPill(props: FilterPillProps): JSX.Element;
+
+declare interface FilterPillBaseProps {
+    /** Available options */
+    options: FilterOption[];
+    /** Callback when remove button is clicked */
+    onRemove: () => void;
+    /** Text shown when no value is selected (e.g., the category label) */
+    placeholder?: string;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Auto-open on mount */
+    autoOpen?: boolean;
+    /** Show search input inside the dropdown for filtering options */
+    searchable?: boolean;
+    /** Placeholder for the search input */
+    searchPlaceholder?: string;
+}
+
+declare interface FilterPillMultipleProps extends FilterPillBaseProps {
+    /** Multi-select mode */
+    multiple: true;
+    /** Current selected values */
+    value: string[];
+    /** Callback when values change */
+    onValueChange: (value: string[]) => void;
+}
+
+export declare type FilterPillProps = FilterPillSingleProps | FilterPillMultipleProps;
+
+declare interface FilterPillSingleProps extends FilterPillBaseProps {
+    /** Single-select mode (default) */
+    multiple?: false;
+    /** Current selected value */
+    value: string;
+    /** Callback when value changes */
+    onValueChange: (value: string) => void;
+}
+
 export declare function IbanField({ value, onChange, showPrefix, error, placeholder, ...props }: IbanFieldProps): JSX.Element;
 
 export declare interface IbanFieldProps extends Omit<TextFieldProps, 'type' | 'value' | 'onChange' | 'prefix'> {
@@ -691,6 +844,11 @@ declare const inputVariants: (props?: ({
     size?: "default" | "sm" | "lg" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+/**
+ * Type guard for date range values
+ */
+export declare function isDateRangeValue(value: ActiveFilter['value']): value is DateRangeValue;
+
 export declare function Item({ className, variant, size, render, ...props }: useRender.ComponentProps<"div"> & VariantProps<typeof itemVariants>): React_2.ReactElement<unknown, string | React_2.JSXElementConstructor<any>>;
 
 export declare function ItemActions({ className, ...props }: React_2.ComponentProps<"div">): JSX.Element;
@@ -821,6 +979,12 @@ export declare function ProgressTrack({ className, ...props }: Progress_2.Track.
 
 export declare function ProgressValue({ className, ...props }: Progress_2.Value.Props): JSX.Element;
 
+export declare interface QuickPreset {
+    label: string;
+    from: Date;
+    to: Date;
+}
+
 export declare function RadioGroup({ className, ...props }: RadioGroup_2.Props): JSX.Element;
 
 export declare function RadioGroupItem({ className, ...props }: Radio.Root.Props): JSX.Element;