analytica-frontend-lib 1.2.11 → 1.2.12

package/dist/index.d.mts

@@ -34,7 +34,7 @@ export { ThemeToggle } from './ThemeToggle/index.mjs';
 export { d as SubjectData, e as SubjectEnum, I as SubjectIconProps, S as SubjectInfo, b as getSubjectColorClass, a as getSubjectIcon, g as getSubjectInfo, c as getSubjectName } from './SubjectInfo-Dvt0OodP.mjs';
 export { c as ThemeActions, T as ThemeMode, b as ThemeState, a as ThemeStore, u as useThemeStore } from './themeStore-P2X64zC-.mjs';
 export { default as DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, MenuLabel, ProfileMenuFooter, ProfileMenuHeader, ProfileMenuSection, ProfileMenuTrigger, ProfileToggleTheme } from './DropdownMenu/index.mjs';
-export { default as Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, useTableSort } from './Table/index.mjs';
+export { SortDirection, default as Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, UseTableSortOptions, useTableSort } from './Table/index.mjs';
 export { default as Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from './Select/index.mjs';
 export { default as Menu, MenuContent, MenuItem, MenuOverflow } from './Menu/index.mjs';
 export { CardActivitiesResults, CardAudio, CardPerformance, CardProgress, CardQuestions, CardResults, CardSimulado, CardSimulationHistory, CardStatus, CardTest, CardTopic } from './Card/index.mjs';
@@ -183,7 +183,7 @@ declare const CheckboxListItem: react.ForwardRefExoticComponent<{
     state?: CheckboxListState;
     /** Additional CSS classes */
     className?: string;
-} & Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "value" | "checked" | "type" | "name" | "onChange"> & react.RefAttributes<HTMLInputElement>>;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "name" | "type" | "size" | "value" | "checked"> & react.RefAttributes<HTMLInputElement>>;
 
 type Item = {
     id: string;
@@ -454,6 +454,119 @@ declare const createNotificationsHook: (apiClient: NotificationApiClient) => ()
     }[];
 };
 
+type FilterConfig = {
+    key: string;
+    label: string;
+    categories: CategoryConfig[];
+};
+type UseTableFilterOptions = {
+    syncWithUrl?: boolean;
+};
+type UseTableFilterReturn = {
+    filterConfigs: FilterConfig[];
+    activeFilters: Record<string, string[]>;
+    hasActiveFilters: boolean;
+    updateFilters: (configs: FilterConfig[]) => void;
+    applyFilters: () => void;
+    clearFilters: () => void;
+};
+/**
+ * Hook for managing table filters with URL synchronization
+ *
+ * @param initialConfigs - Initial filter configurations
+ * @param options - Hook options including URL sync
+ * @returns Filter state and management functions
+ *
+ * @example
+ * ```tsx
+ * const { filterConfigs, activeFilters, updateFilters, applyFilters } = useTableFilter(
+ *   [
+ *     {
+ *       key: 'academic',
+ *       label: 'Dados Acadêmicos',
+ *       categories: [...]
+ *     }
+ *   ],
+ *   { syncWithUrl: true }
+ * );
+ * ```
+ */
+declare const useTableFilter: (initialConfigs: FilterConfig[], options?: UseTableFilterOptions) => UseTableFilterReturn;
+
+type FilterModalProps = {
+    /**
+     * Controls modal visibility
+     */
+    isOpen: boolean;
+    /**
+     * Callback when modal should close
+     */
+    onClose: () => void;
+    /**
+     * Filter configurations with categories
+     */
+    filterConfigs: FilterConfig[];
+    /**
+     * Callback when filters change (temporary, before applying)
+     */
+    onFiltersChange: (configs: FilterConfig[]) => void;
+    /**
+     * Callback when "Aplicar" button is clicked
+     */
+    onApply: () => void;
+    /**
+     * Callback when "Limpar filtros" button is clicked
+     */
+    onClear: () => void;
+    /**
+     * Modal title
+     * @default "Filtros"
+     */
+    title?: string;
+    /**
+     * Modal size
+     * @default "md"
+     */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Apply button label
+     * @default "Aplicar"
+     */
+    applyLabel?: string;
+    /**
+     * Clear button label
+     * @default "Limpar filtros"
+     */
+    clearLabel?: string;
+};
+/**
+ * FilterModal component - A modal for table filtering with CheckboxGroup
+ *
+ * Integrates Modal, CheckboxGroup, and Button components to create a
+ * complete filtering interface. Works with useTableFilter hook for URL synchronization.
+ *
+ * @example
+ * ```tsx
+ * const { filterConfigs, updateFilters, applyFilters, clearFilters } = useTableFilter(
+ *   initialConfigs,
+ *   { syncWithUrl: true }
+ * );
+ *
+ * <FilterModal
+ *   isOpen={isOpen}
+ *   onClose={() => setIsOpen(false)}
+ *   filterConfigs={filterConfigs}
+ *   onFiltersChange={updateFilters}
+ *   onApply={() => {
+ *     applyFilters();
+ *     setIsOpen(false);
+ *   }}
+ *   onClear={clearFilters}
+ * />
+ * ```
+ */
+declare const FilterModal: ({ isOpen, onClose, filterConfigs, onFiltersChange, onApply, onClear, title, size, applyLabel, clearLabel, }: FilterModalProps) => react_jsx_runtime.JSX.Element;
+
 interface AccordionGroupProps extends HTMLAttributes<HTMLDivElement> {
     type?: 'single' | 'multiple';
     defaultValue?: string | string[];
@@ -678,4 +791,4 @@ declare const useAppStore: zustand.UseBoundStore<Omit<zustand.StoreApi<AppState>
     };
 }>;
 
-export { AccordionGroup, type AuthState, type CategoryConfig, CheckboxGroup, CheckboxList, CheckboxListItem, FetchNotificationsParams, ImageUpload, type ImageUploadProps, type Item, Notification, type NotificationActions, NotificationApiClient, NotificationEntityType, NotificationGroup, type NotificationState, type NotificationStore, NotificationType, Question, QuizAlternative, QuizConnectDots, QuizDissertative, QuizHeaderResult, QuizImageQuestion, QuizListResult, QuizListResultByMateria, QuizMultipleChoice, QuizResultHeaderTitle, QuizResultPerformance, QuizResultTitle, QuizTrueOrFalse, createNotificationStore, createNotificationsHook, createUseNotificationStore, createUseNotifications, formatTimeAgo, getStatusBadge, useAppContent, useAppInitialization, useAppStore, useAuthStore, useInstitutionId };
+export { AccordionGroup, type AuthState, type CategoryConfig, CheckboxGroup, CheckboxList, CheckboxListItem, FetchNotificationsParams, type FilterConfig, FilterModal, type FilterModalProps, ImageUpload, type ImageUploadProps, type Item, Notification, type NotificationActions, NotificationApiClient, NotificationEntityType, NotificationGroup, type NotificationState, type NotificationStore, NotificationType, Question, QuizAlternative, QuizConnectDots, QuizDissertative, QuizHeaderResult, QuizImageQuestion, QuizListResult, QuizListResultByMateria, QuizMultipleChoice, QuizResultHeaderTitle, QuizResultPerformance, QuizResultTitle, QuizTrueOrFalse, type UseTableFilterOptions, type UseTableFilterReturn, createNotificationStore, createNotificationsHook, createUseNotificationStore, createUseNotifications, formatTimeAgo, getStatusBadge, useAppContent, useAppInitialization, useAppStore, useAuthStore, useInstitutionId, useTableFilter };

package/dist/index.d.ts

@@ -34,7 +34,7 @@ export { ThemeToggle } from './ThemeToggle/index.js';
 export { d as SubjectData, e as SubjectEnum, I as SubjectIconProps, S as SubjectInfo, b as getSubjectColorClass, a as getSubjectIcon, g as getSubjectInfo, c as getSubjectName } from './SubjectInfo-Dvt0OodP.js';
 export { c as ThemeActions, T as ThemeMode, b as ThemeState, a as ThemeStore, u as useThemeStore } from './themeStore-P2X64zC-.js';
 export { default as DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, MenuLabel, ProfileMenuFooter, ProfileMenuHeader, ProfileMenuSection, ProfileMenuTrigger, ProfileToggleTheme } from './DropdownMenu/index.js';
-export { default as Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, useTableSort } from './Table/index.js';
+export { SortDirection, default as Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, UseTableSortOptions, useTableSort } from './Table/index.js';
 export { default as Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from './Select/index.js';
 export { default as Menu, MenuContent, MenuItem, MenuOverflow } from './Menu/index.js';
 export { CardActivitiesResults, CardAudio, CardPerformance, CardProgress, CardQuestions, CardResults, CardSimulado, CardSimulationHistory, CardStatus, CardTest, CardTopic } from './Card/index.js';
@@ -183,7 +183,7 @@ declare const CheckboxListItem: react.ForwardRefExoticComponent<{
     state?: CheckboxListState;
     /** Additional CSS classes */
     className?: string;
-} & Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "value" | "checked" | "type" | "name" | "onChange"> & react.RefAttributes<HTMLInputElement>>;
+} & Omit<InputHTMLAttributes<HTMLInputElement>, "onChange" | "name" | "type" | "size" | "value" | "checked"> & react.RefAttributes<HTMLInputElement>>;
 
 type Item = {
     id: string;
@@ -454,6 +454,119 @@ declare const createNotificationsHook: (apiClient: NotificationApiClient) => ()
     }[];
 };
 
+type FilterConfig = {
+    key: string;
+    label: string;
+    categories: CategoryConfig[];
+};
+type UseTableFilterOptions = {
+    syncWithUrl?: boolean;
+};
+type UseTableFilterReturn = {
+    filterConfigs: FilterConfig[];
+    activeFilters: Record<string, string[]>;
+    hasActiveFilters: boolean;
+    updateFilters: (configs: FilterConfig[]) => void;
+    applyFilters: () => void;
+    clearFilters: () => void;
+};
+/**
+ * Hook for managing table filters with URL synchronization
+ *
+ * @param initialConfigs - Initial filter configurations
+ * @param options - Hook options including URL sync
+ * @returns Filter state and management functions
+ *
+ * @example
+ * ```tsx
+ * const { filterConfigs, activeFilters, updateFilters, applyFilters } = useTableFilter(
+ *   [
+ *     {
+ *       key: 'academic',
+ *       label: 'Dados Acadêmicos',
+ *       categories: [...]
+ *     }
+ *   ],
+ *   { syncWithUrl: true }
+ * );
+ * ```
+ */
+declare const useTableFilter: (initialConfigs: FilterConfig[], options?: UseTableFilterOptions) => UseTableFilterReturn;
+
+type FilterModalProps = {
+    /**
+     * Controls modal visibility
+     */
+    isOpen: boolean;
+    /**
+     * Callback when modal should close
+     */
+    onClose: () => void;
+    /**
+     * Filter configurations with categories
+     */
+    filterConfigs: FilterConfig[];
+    /**
+     * Callback when filters change (temporary, before applying)
+     */
+    onFiltersChange: (configs: FilterConfig[]) => void;
+    /**
+     * Callback when "Aplicar" button is clicked
+     */
+    onApply: () => void;
+    /**
+     * Callback when "Limpar filtros" button is clicked
+     */
+    onClear: () => void;
+    /**
+     * Modal title
+     * @default "Filtros"
+     */
+    title?: string;
+    /**
+     * Modal size
+     * @default "md"
+     */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Apply button label
+     * @default "Aplicar"
+     */
+    applyLabel?: string;
+    /**
+     * Clear button label
+     * @default "Limpar filtros"
+     */
+    clearLabel?: string;
+};
+/**
+ * FilterModal component - A modal for table filtering with CheckboxGroup
+ *
+ * Integrates Modal, CheckboxGroup, and Button components to create a
+ * complete filtering interface. Works with useTableFilter hook for URL synchronization.
+ *
+ * @example
+ * ```tsx
+ * const { filterConfigs, updateFilters, applyFilters, clearFilters } = useTableFilter(
+ *   initialConfigs,
+ *   { syncWithUrl: true }
+ * );
+ *
+ * <FilterModal
+ *   isOpen={isOpen}
+ *   onClose={() => setIsOpen(false)}
+ *   filterConfigs={filterConfigs}
+ *   onFiltersChange={updateFilters}
+ *   onApply={() => {
+ *     applyFilters();
+ *     setIsOpen(false);
+ *   }}
+ *   onClear={clearFilters}
+ * />
+ * ```
+ */
+declare const FilterModal: ({ isOpen, onClose, filterConfigs, onFiltersChange, onApply, onClear, title, size, applyLabel, clearLabel, }: FilterModalProps) => react_jsx_runtime.JSX.Element;
+
 interface AccordionGroupProps extends HTMLAttributes<HTMLDivElement> {
     type?: 'single' | 'multiple';
     defaultValue?: string | string[];
@@ -678,4 +791,4 @@ declare const useAppStore: zustand.UseBoundStore<Omit<zustand.StoreApi<AppState>
     };
 }>;
 
-export { AccordionGroup, type AuthState, type CategoryConfig, CheckboxGroup, CheckboxList, CheckboxListItem, FetchNotificationsParams, ImageUpload, type ImageUploadProps, type Item, Notification, type NotificationActions, NotificationApiClient, NotificationEntityType, NotificationGroup, type NotificationState, type NotificationStore, NotificationType, Question, QuizAlternative, QuizConnectDots, QuizDissertative, QuizHeaderResult, QuizImageQuestion, QuizListResult, QuizListResultByMateria, QuizMultipleChoice, QuizResultHeaderTitle, QuizResultPerformance, QuizResultTitle, QuizTrueOrFalse, createNotificationStore, createNotificationsHook, createUseNotificationStore, createUseNotifications, formatTimeAgo, getStatusBadge, useAppContent, useAppInitialization, useAppStore, useAuthStore, useInstitutionId };
+export { AccordionGroup, type AuthState, type CategoryConfig, CheckboxGroup, CheckboxList, CheckboxListItem, FetchNotificationsParams, type FilterConfig, FilterModal, type FilterModalProps, ImageUpload, type ImageUploadProps, type Item, Notification, type NotificationActions, NotificationApiClient, NotificationEntityType, NotificationGroup, type NotificationState, type NotificationStore, NotificationType, Question, QuizAlternative, QuizConnectDots, QuizDissertative, QuizHeaderResult, QuizImageQuestion, QuizListResult, QuizListResultByMateria, QuizMultipleChoice, QuizResultHeaderTitle, QuizResultPerformance, QuizResultTitle, QuizTrueOrFalse, type UseTableFilterOptions, type UseTableFilterReturn, createNotificationStore, createNotificationsHook, createUseNotificationStore, createUseNotifications, formatTimeAgo, getStatusBadge, useAppContent, useAppInitialization, useAppStore, useAuthStore, useInstitutionId, useTableFilter };