@6thbridge/hexa 0.0.96 → 0.0.97

package/dist/index.d.mts

@@ -12,6 +12,7 @@ import { OTPInputProps as OTPInputProps$1 } from 'react-otp-input';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import { Drawer as Drawer$1 } from 'vaul';
 import { RowData, Row, Table as Table$1 } from '@tanstack/react-table';
+import { UseFormReturn } from 'react-hook-form';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as zustand from 'zustand';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
@@ -474,37 +475,83 @@ type TableBulkRowActionsProps = {
     id?: string;
 };
 
-type SelectOption = {
+type FilterSelectOption = {
     value: string;
     label: string;
 };
-type Base = {
-    type: "input" | "drop-down" | "date-range" | "multi" | "date" | "radio";
+type FilterType = "input" | "drop-down" | "date-range" | "multi" | "date" | "radio";
+/**
+ * Base properties shared by all filter types.
+ */
+interface FilterBase {
     key: string;
     label: string;
+    type: FilterType;
     placeholder?: string;
-};
-type FilterListOption = {
+}
+/**
+ * Input-specific filter properties.
+ */
+interface FilterInput extends FilterBase, Omit<InputProps, "value" | "onChange" | "type" | "label"> {
     type: "input";
-} & Exclude<InputProps, "value" | "onChange">;
-type FilterListDate = {
+}
+/**
+ * Drop-down (Select) specific filter properties.
+ */
+interface FilterDropDown extends FilterBase {
+    type: "drop-down";
+    options: FilterSelectOption[];
+    hideSearch?: boolean;
+}
+/**
+ * Radio specific filter properties.
+ */
+interface FilterRadio extends FilterBase {
+    type: "radio";
+    options: FilterSelectOption[];
+}
+/**
+ * Date specific filter properties.
+ */
+interface FilterDate extends FilterBase {
     type: "date";
     date?: string | Date;
-};
-type FilterListInputDropDown = {
-    type: "drop-down" | "multi" | "radio";
-    options: SelectOption[];
+}
+/**
+ * Multi-select specific filter properties.
+ */
+interface FilterMultiSelect extends FilterBase {
+    type: "multi";
+    options: FilterSelectOption[];
     hideSearch?: boolean;
-};
-type FilterListItem = Base & (FilterListOption | FilterListInputDropDown | FilterListDate);
-type FilterContentProps = {
-    filters: FilterListItem[];
-    values?: Record<string, any>;
-    setAppliedFilters?: (values: Record<string, any>) => void;
-    onChange?: (values: Record<string, any>) => void;
-    id?: string;
-};
+}
+/**
+ * Date range specific filter properties.
+ */
+interface FilterDateRange extends FilterBase {
+    type: "date-range";
+}
+/**
+ * Discriminated union of all supported filter item configurations.
+ */
+type FilterListItem = FilterInput | FilterDropDown | FilterRadio | FilterDate | FilterMultiSelect | FilterDateRange;
+/**
+ * Alias for backward compatibility.
+ */
 type FilterListOptions = FilterListItem[];
+/**
+ * Type alias for filter values, used to avoid 'any' in filter state management.
+ */
+type FilterValues = Record<string, string>;
+/**
+ * Shared props for individual filter fields to eliminate 'any'.
+ */
+type FilterFieldProps<T extends FilterListItem = FilterListItem> = {
+    filter: T;
+    id: string;
+    form: UseFormReturn<FilterValues>;
+    onClear?: (fieldKey: string) => void;
+};
 
 type PaginationProps = {
     currentPage?: number;
@@ -552,6 +599,7 @@ type TableProps<T extends RowData> = {
     FilterMenu?: ReactNode;
     setAppliedFilters?: (values: Record<string, any>) => void;
     filterListOptions?: FilterListItem[];
+    filterValues?: Record<string, any>;
     buttonClassName?: string;
     download?: TableDownloadProps;
     id?: string;
@@ -571,7 +619,7 @@ type TableProps<T extends RowData> = {
     };
     emptyDataMessage?: ReactNode;
 };
-declare const Table: <T extends RowData>({ table, isMobile, onRowClick, id, onRefetch, isRefetching, FilterMenu, ExtraNode, onExport, search, download, isLoading, pagination, filterListOptions, setAppliedFilters, onFilterChange, tableBulkActions, emptyDataMessage, }: TableProps<T>) => React$1.JSX.Element;
+declare const Table: <T extends RowData>({ table, isMobile, onRowClick, id, onRefetch, isRefetching, FilterMenu, ExtraNode, onExport, search, download, isLoading, pagination, filterListOptions, filterValues, setAppliedFilters, onFilterChange, tableBulkActions, emptyDataMessage, }: TableProps<T>) => React$1.JSX.Element;
 
 type PageDataToolbarProps = {
     onRefetch?: () => void;
@@ -583,10 +631,11 @@ type PageDataToolbarProps = {
     isRefetching?: boolean;
     setAppliedFilters?: (values: Record<string, any>) => void;
     onFilterChange?: (values: Record<string, any>) => void;
+    filterValues?: Record<string, any>;
     filterListOptions?: FilterListItem[];
     id?: string;
 };
-declare const PageDataToolbar: ({ onRefetch, search, FilterMenu, ExtraNode, onExport, download, isRefetching, filterListOptions, setAppliedFilters, onFilterChange, id, }: PageDataToolbarProps) => React$1.JSX.Element;
+declare const PageDataToolbar: ({ onRefetch, search, FilterMenu, ExtraNode, onExport, download, isRefetching, filterListOptions, filterValues, setAppliedFilters, onFilterChange, id, }: PageDataToolbarProps) => React$1.JSX.Element;
 
 declare const PermissionsContext: React$1.Context<ResourcePermissions | undefined>;
 declare const PermissionsProvider: ({ permissions, children, }: {
@@ -631,13 +680,24 @@ declare const RadioGroupItem: React$1.ForwardRefExoticComponent<Omit<RadioGroupP
     className?: string;
 } & React$1.RefAttributes<HTMLButtonElement>>;
 
-type FilterPopoverProps = FilterContentProps & {
+type FilterContentProps = {
+    filters: FilterListItem[];
+    values?: FilterValues;
+    onChange?: (values: FilterValues) => void;
+    onApply?: (values: FilterValues) => void;
+    onReset?: () => void;
+    /** Called when a single field is cleared, so the parent can update applied state + URL for that key only. */
+    onClearApplied?: (fieldKey: string) => void;
+    id?: string;
+    setAppliedFilters?: (values: FilterValues) => void;
+};
+
+type FilterPopoverProps = Omit<FilterContentProps, "onApply"> & {
     isOpen?: boolean;
     trigger?: ReactNode;
     id?: string;
-    onChange?: (values: Record<string, any>) => void;
 };
-declare const FilterPopover: ({ filters, setAppliedFilters, isOpen, onChange, id, }: FilterPopoverProps) => React$1.JSX.Element | null;
+declare const FilterPopover: ({ filters, setAppliedFilters, isOpen, onChange, values, id, }: FilterPopoverProps) => React$1.JSX.Element | null;
 
 interface FilterSliceType {
     filters: Record<string, any> | null;
@@ -865,4 +925,4 @@ declare const TagsInput: ({ value, onChange, options, label, error, placeholder,
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AmountAction, Banner, Button, CalendarInput, CopyableLabel, Country, CurrencySymbolMap, DateAction, DebouncedInput, DevBanner, Dialog, Drawer, DrawerClose, type DrawerPropsType, DrawerRoot, FeatureBanner, type FilterListItem, type FilterListOptions, FilterPopover, FlagComponent, FormLabel, type FormatCurrencyOptions, HasResourcePermission, Input, Loader, LocaleSelector, MultiSelect, type MultiSelectDataType, MultiSelectTrigger, OTPInput, PageDataToolbar, Pagination, PasswordInput, PermissionsContext, PermissionsProvider, PhoneInput, Popover, PopoverContent, PopoverRoot, PopoverTrigger, RadioGroup, RadioGroupItem, type ResourcePermission, type ResourcePermissionProps, type ResourcePermissions, RichTextEditor, ScrollArea, Select, Sidebar, Status, StringAction, Table, type TableBulkRowActionsProps, type TablePaginationProps, Tabs, type TagOption, TagsInput, type TagsInputProps, TextOverflow, type TextOverflowProps, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger, buttonVariants, cn, useFilterStore, useHasPermission, usePermissions };
+export { AmountAction, Banner, Button, CalendarInput, CopyableLabel, Country, CurrencySymbolMap, DateAction, DebouncedInput, DevBanner, Dialog, Drawer, DrawerClose, type DrawerPropsType, DrawerRoot, FeatureBanner, type FilterFieldProps, type FilterListItem, type FilterListOptions, FilterPopover, FlagComponent, FormLabel, type FormatCurrencyOptions, HasResourcePermission, Input, Loader, LocaleSelector, MultiSelect, type MultiSelectDataType, MultiSelectTrigger, OTPInput, PageDataToolbar, Pagination, PasswordInput, PermissionsContext, PermissionsProvider, PhoneInput, Popover, PopoverContent, PopoverRoot, PopoverTrigger, RadioGroup, RadioGroupItem, type ResourcePermission, type ResourcePermissionProps, type ResourcePermissions, RichTextEditor, ScrollArea, Select, Sidebar, Status, StringAction, Table, type TableBulkRowActionsProps, type TablePaginationProps, Tabs, type TagOption, TagsInput, type TagsInputProps, TextOverflow, type TextOverflowProps, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger, buttonVariants, cn, useFilterStore, useHasPermission, usePermissions };

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import { OTPInputProps as OTPInputProps$1 } from 'react-otp-input';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import { Drawer as Drawer$1 } from 'vaul';
 import { RowData, Row, Table as Table$1 } from '@tanstack/react-table';
+import { UseFormReturn } from 'react-hook-form';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as zustand from 'zustand';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
@@ -474,37 +475,83 @@ type TableBulkRowActionsProps = {
     id?: string;
 };
 
-type SelectOption = {
+type FilterSelectOption = {
     value: string;
     label: string;
 };
-type Base = {
-    type: "input" | "drop-down" | "date-range" | "multi" | "date" | "radio";
+type FilterType = "input" | "drop-down" | "date-range" | "multi" | "date" | "radio";
+/**
+ * Base properties shared by all filter types.
+ */
+interface FilterBase {
     key: string;
     label: string;
+    type: FilterType;
     placeholder?: string;
-};
-type FilterListOption = {
+}
+/**
+ * Input-specific filter properties.
+ */
+interface FilterInput extends FilterBase, Omit<InputProps, "value" | "onChange" | "type" | "label"> {
     type: "input";
-} & Exclude<InputProps, "value" | "onChange">;
-type FilterListDate = {
+}
+/**
+ * Drop-down (Select) specific filter properties.
+ */
+interface FilterDropDown extends FilterBase {
+    type: "drop-down";
+    options: FilterSelectOption[];
+    hideSearch?: boolean;
+}
+/**
+ * Radio specific filter properties.
+ */
+interface FilterRadio extends FilterBase {
+    type: "radio";
+    options: FilterSelectOption[];
+}
+/**
+ * Date specific filter properties.
+ */
+interface FilterDate extends FilterBase {
     type: "date";
     date?: string | Date;
-};
-type FilterListInputDropDown = {
-    type: "drop-down" | "multi" | "radio";
-    options: SelectOption[];
+}
+/**
+ * Multi-select specific filter properties.
+ */
+interface FilterMultiSelect extends FilterBase {
+    type: "multi";
+    options: FilterSelectOption[];
     hideSearch?: boolean;
-};
-type FilterListItem = Base & (FilterListOption | FilterListInputDropDown | FilterListDate);
-type FilterContentProps = {
-    filters: FilterListItem[];
-    values?: Record<string, any>;
-    setAppliedFilters?: (values: Record<string, any>) => void;
-    onChange?: (values: Record<string, any>) => void;
-    id?: string;
-};
+}
+/**
+ * Date range specific filter properties.
+ */
+interface FilterDateRange extends FilterBase {
+    type: "date-range";
+}
+/**
+ * Discriminated union of all supported filter item configurations.
+ */
+type FilterListItem = FilterInput | FilterDropDown | FilterRadio | FilterDate | FilterMultiSelect | FilterDateRange;
+/**
+ * Alias for backward compatibility.
+ */
 type FilterListOptions = FilterListItem[];
+/**
+ * Type alias for filter values, used to avoid 'any' in filter state management.
+ */
+type FilterValues = Record<string, string>;
+/**
+ * Shared props for individual filter fields to eliminate 'any'.
+ */
+type FilterFieldProps<T extends FilterListItem = FilterListItem> = {
+    filter: T;
+    id: string;
+    form: UseFormReturn<FilterValues>;
+    onClear?: (fieldKey: string) => void;
+};
 
 type PaginationProps = {
     currentPage?: number;
@@ -552,6 +599,7 @@ type TableProps<T extends RowData> = {
     FilterMenu?: ReactNode;
     setAppliedFilters?: (values: Record<string, any>) => void;
     filterListOptions?: FilterListItem[];
+    filterValues?: Record<string, any>;
     buttonClassName?: string;
     download?: TableDownloadProps;
     id?: string;
@@ -571,7 +619,7 @@ type TableProps<T extends RowData> = {
     };
     emptyDataMessage?: ReactNode;
 };
-declare const Table: <T extends RowData>({ table, isMobile, onRowClick, id, onRefetch, isRefetching, FilterMenu, ExtraNode, onExport, search, download, isLoading, pagination, filterListOptions, setAppliedFilters, onFilterChange, tableBulkActions, emptyDataMessage, }: TableProps<T>) => React$1.JSX.Element;
+declare const Table: <T extends RowData>({ table, isMobile, onRowClick, id, onRefetch, isRefetching, FilterMenu, ExtraNode, onExport, search, download, isLoading, pagination, filterListOptions, filterValues, setAppliedFilters, onFilterChange, tableBulkActions, emptyDataMessage, }: TableProps<T>) => React$1.JSX.Element;
 
 type PageDataToolbarProps = {
     onRefetch?: () => void;
@@ -583,10 +631,11 @@ type PageDataToolbarProps = {
     isRefetching?: boolean;
     setAppliedFilters?: (values: Record<string, any>) => void;
     onFilterChange?: (values: Record<string, any>) => void;
+    filterValues?: Record<string, any>;
     filterListOptions?: FilterListItem[];
     id?: string;
 };
-declare const PageDataToolbar: ({ onRefetch, search, FilterMenu, ExtraNode, onExport, download, isRefetching, filterListOptions, setAppliedFilters, onFilterChange, id, }: PageDataToolbarProps) => React$1.JSX.Element;
+declare const PageDataToolbar: ({ onRefetch, search, FilterMenu, ExtraNode, onExport, download, isRefetching, filterListOptions, filterValues, setAppliedFilters, onFilterChange, id, }: PageDataToolbarProps) => React$1.JSX.Element;
 
 declare const PermissionsContext: React$1.Context<ResourcePermissions | undefined>;
 declare const PermissionsProvider: ({ permissions, children, }: {
@@ -631,13 +680,24 @@ declare const RadioGroupItem: React$1.ForwardRefExoticComponent<Omit<RadioGroupP
     className?: string;
 } & React$1.RefAttributes<HTMLButtonElement>>;
 
-type FilterPopoverProps = FilterContentProps & {
+type FilterContentProps = {
+    filters: FilterListItem[];
+    values?: FilterValues;
+    onChange?: (values: FilterValues) => void;
+    onApply?: (values: FilterValues) => void;
+    onReset?: () => void;
+    /** Called when a single field is cleared, so the parent can update applied state + URL for that key only. */
+    onClearApplied?: (fieldKey: string) => void;
+    id?: string;
+    setAppliedFilters?: (values: FilterValues) => void;
+};
+
+type FilterPopoverProps = Omit<FilterContentProps, "onApply"> & {
     isOpen?: boolean;
     trigger?: ReactNode;
     id?: string;
-    onChange?: (values: Record<string, any>) => void;
 };
-declare const FilterPopover: ({ filters, setAppliedFilters, isOpen, onChange, id, }: FilterPopoverProps) => React$1.JSX.Element | null;
+declare const FilterPopover: ({ filters, setAppliedFilters, isOpen, onChange, values, id, }: FilterPopoverProps) => React$1.JSX.Element | null;
 
 interface FilterSliceType {
     filters: Record<string, any> | null;
@@ -865,4 +925,4 @@ declare const TagsInput: ({ value, onChange, options, label, error, placeholder,
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AmountAction, Banner, Button, CalendarInput, CopyableLabel, Country, CurrencySymbolMap, DateAction, DebouncedInput, DevBanner, Dialog, Drawer, DrawerClose, type DrawerPropsType, DrawerRoot, FeatureBanner, type FilterListItem, type FilterListOptions, FilterPopover, FlagComponent, FormLabel, type FormatCurrencyOptions, HasResourcePermission, Input, Loader, LocaleSelector, MultiSelect, type MultiSelectDataType, MultiSelectTrigger, OTPInput, PageDataToolbar, Pagination, PasswordInput, PermissionsContext, PermissionsProvider, PhoneInput, Popover, PopoverContent, PopoverRoot, PopoverTrigger, RadioGroup, RadioGroupItem, type ResourcePermission, type ResourcePermissionProps, type ResourcePermissions, RichTextEditor, ScrollArea, Select, Sidebar, Status, StringAction, Table, type TableBulkRowActionsProps, type TablePaginationProps, Tabs, type TagOption, TagsInput, type TagsInputProps, TextOverflow, type TextOverflowProps, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger, buttonVariants, cn, useFilterStore, useHasPermission, usePermissions };
+export { AmountAction, Banner, Button, CalendarInput, CopyableLabel, Country, CurrencySymbolMap, DateAction, DebouncedInput, DevBanner, Dialog, Drawer, DrawerClose, type DrawerPropsType, DrawerRoot, FeatureBanner, type FilterFieldProps, type FilterListItem, type FilterListOptions, FilterPopover, FlagComponent, FormLabel, type FormatCurrencyOptions, HasResourcePermission, Input, Loader, LocaleSelector, MultiSelect, type MultiSelectDataType, MultiSelectTrigger, OTPInput, PageDataToolbar, Pagination, PasswordInput, PermissionsContext, PermissionsProvider, PhoneInput, Popover, PopoverContent, PopoverRoot, PopoverTrigger, RadioGroup, RadioGroupItem, type ResourcePermission, type ResourcePermissionProps, type ResourcePermissions, RichTextEditor, ScrollArea, Select, Sidebar, Status, StringAction, Table, type TableBulkRowActionsProps, type TablePaginationProps, Tabs, type TagOption, TagsInput, type TagsInputProps, TextOverflow, type TextOverflowProps, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger, buttonVariants, cn, useFilterStore, useHasPermission, usePermissions };