forlogic-core 2.2.7 → 2.3.0

package/dist/leadership/exports/ui.d.ts

@@ -0,0 +1,98 @@
+export * from '../components/ui/accordion';
+export * from '../components/ui/alert';
+export * from '../components/ui/alert-dialog';
+export * from '../components/ui/avatar';
+export * from '../components/ui/breadcrumb';
+export * from '../components/ui/button';
+export * from '../components/ui/button-group';
+export * from '../components/ui/badge';
+export * from '../components/ui/calendar';
+export * from '../components/ui/card';
+export * from '../components/ui/checkbox';
+export { Collapsible, CollapsibleTrigger, CollapsibleContent } from '../components/ui/collapsible';
+export * from '../components/ui/color-picker';
+export * from '../components/ui/command';
+export * from '../components/ui/context-menu';
+export * from '../components/ui/data-list';
+export * from '../components/ui/date-picker';
+export * from '../components/ui/dialog';
+export * from '../components/ui/drawer';
+export * from '../components/ui/dropdown-menu';
+export * from '../components/ui/disabled-menu-item';
+export * from '../components/ui/empty-state';
+export { Combobox, type ComboboxProps } from '../components/ui/combobox';
+export { Combobox as SelectSearch } from '../components/ui/combobox';
+export type { ComboboxProps as SelectSearchProps } from '../components/ui/combobox';
+export { Combobox as MultiSelect } from '../components/ui/combobox';
+export type { ComboboxProps as MultiSelectProps } from '../components/ui/combobox';
+export { Combobox as EntitySelect } from '../components/ui/combobox';
+export type { ComboboxProps as EntitySelectProps } from '../components/ui/combobox';
+export { Combobox as AutoComplete } from '../components/ui/combobox';
+export type { ComboboxProps as AutoCompleteProps } from '../components/ui/combobox';
+export * from '../components/ui/form';
+export * from '../components/ui/grid';
+export * from '../components/ui/hover-card';
+export * from '../components/ui/icon-picker';
+export * from '../components/ui/input';
+export * from '../components/ui/input-group';
+export * from '../components/ui/label';
+export { LoadingState } from '../components/ui/loading-state';
+export * from '../components/ui/typography';
+export * from '../components/ui/navigation-menu';
+export * from '../components/ui/page-breadcrumb';
+export * from '../components/ui/pagination';
+export * from '../components/ui/popover';
+export * from '../components/ui/progress';
+export * from '../components/ui/radio-group';
+export * from '../components/ui/resizable';
+export * from '../components/ui/scroll-area';
+export * from '../components/ui/select';
+export * from '../components/ui/separator';
+export * from '../components/ui/sheet';
+export * from '../components/ui/sidebar';
+export * from '../components/ui/skeleton';
+export * from '../components/ui/skeleton-variants';
+export * from '../components/ui/slider';
+export { Toaster as SonnerToaster, toast as sonnerToast, toast } from '../components/ui/sonner';
+export * from '../components/ui/spinner';
+export * from '../components/ui/switch';
+export * from '../components/ui/stack';
+export * from '../components/ui/table';
+export { TableResizeHandle } from '../components/ui/table-resize-handle';
+export * from '../components/ui/tabs';
+export * from '../components/ui/tab-page-layout';
+export * from '../components/ui/textarea';
+export * from '../components/ui/toggle';
+export * from '../components/ui/toggle-group';
+export * from '../components/ui/tooltip';
+export * from '../components/ui/truncated-cell';
+export { TruncatedCell as EllipsisText } from '../components/ui/truncated-cell';
+export * from '../components/ui/action-button';
+export { ActionButton as ActionMenu } from '../components/ui/action-button';
+export * from '../components/ui/menubar';
+export * from '../components/ui/chart';
+export * from '../components/ui/rich-text-editor';
+export * from '../components/ui/onboarding-dialog';
+export * from '../components/ui/split-button';
+export * from '../components/ui/export-dialog';
+export * from '../components/ui/timepicker';
+export * from '../components/ui/electronic-signature-dialog';
+export * from '../components/ui/step-selector';
+export { StepSelector as Stepper } from '../components/ui/step-selector';
+export * from '../components/ui/dialog-wizard';
+export { ComboTree, type ComboTreeProps, type ComboTreeOption } from '../components/ui/combo-tree';
+export { ComboTree as TreeSelect } from '../components/ui/combo-tree';
+export type { ComboTreeProps as TreeSelectProps, ComboTreeOption as TreeSelectOption } from '../components/ui/combo-tree';
+export { UpdatesNotification, type UpdateNotification, type UpdateNotificationItem, type UpdatesNotificationProps } from '../components/ui/updates-notification';
+export { useUpdatesNotification } from '../hooks/useUpdatesNotification';
+export * from '../components/ui/viewer-dialog';
+export * from '../components/ui/online-editor-dialog';
+export * from '../components/ui/iframe-dialog';
+export * from '../components/ui/terms-of-use-dialog';
+export * from '../components/ui/users-groups-selector';
+export * from '../components/ui/multiselect-permissions';
+export * from '../components/ui/report-request-list';
+export * from '../components/ui/stimulsoft-viewer';
+export { StatusBadge, createStatusConfig, type StatusBadgeProps, type StatusConfig } from '../components/ui/status-badge';
+export * from '../components/dashboards';
+export * from '../mind-map';

package/dist/leadership/file-upload/components/SingleFileUpload.d.ts

@@ -0,0 +1,102 @@
+import { StoredFile } from '../types';
+/**
+ * Props do componente {@link SingleFileUpload}.
+ *
+ * Combina estado local de upload (drag & drop) com a representação remota (`storedFile`).
+ * Use callbacks `onFileSelect` / `onFileRemove` para integrar a um form (react-hook-form, etc).
+ *
+ * @example
+ * const props: SingleFileUploadProps = {
+ *   storedFile: { name: 'contrato.pdf', size: 124000, url: 'https://...' },
+ *   allowedExtensions: ['pdf', 'doc', 'docx'],
+ *   maxSizeInBytes: 10 * 1024 * 1024,
+ *   onFileSelect: (file) => uploadMutation.mutate(file),
+ *   onFileRemove: () => removeMutation.mutate(),
+ * };
+ */
+export interface SingleFileUploadProps {
+    /** Pre-existing stored file (server-side) */
+    storedFile?: StoredFile | null;
+    /** Custom display name override */
+    customFileName?: string;
+    /** Allowed extensions (e.g. ['pdf', 'doc']). Empty = all allowed */
+    allowedExtensions?: string[];
+    /** Custom error message for extension validation */
+    customExtensionErrorMessage?: string;
+    /** Min file size in bytes (default: 1) */
+    minSizeInBytes?: number;
+    /** Max file size in bytes (default: 300MB) */
+    maxSizeInBytes?: number;
+    /** Show download button when file exists */
+    showDownloadButton?: boolean;
+    /** Show view button when file exists */
+    showViewButton?: boolean;
+    /** Show replace button when file exists */
+    showReplaceButton?: boolean;
+    /** Show remove/close button when file exists */
+    showCloseButton?: boolean;
+    /** Required field */
+    required?: boolean;
+    /** Touched state (for external form control) */
+    touched?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** External error message */
+    error?: string;
+    /** Called when a valid file is selected */
+    onFileSelect?: (file: File) => void;
+    /** Called when file is removed */
+    onFileRemove?: () => void;
+    /** Called when file is replaced (before file dialog opens) */
+    onFileReplace?: () => void;
+    /** Called when download is requested */
+    onDownload?: (file: StoredFile) => Promise<void> | void;
+    /** Called when view is requested */
+    onView?: (file: StoredFile) => void;
+    className?: string;
+}
+/**
+ * Componente de upload de arquivo único com drag & drop, validação e suporte a arquivos remotos.
+ *
+ * Renderiza dois estados: **vazio** (área de drag & drop) e **preenchido** (chip do arquivo
+ * com botões de download/visualizar/substituir/remover, conforme flags habilitadas).
+ *
+ * Validações automáticas: tamanho (min/max), extensão permitida e bloqueio de tipos perigosos
+ * (`FORBIDDEN_FILE_TYPES`: .exe, .bat, .sh, etc).
+ *
+ * @example
+ * // Upload simples integrado a uma mutation
+ * <SingleFileUpload
+ *   allowedExtensions={['pdf', 'png', 'jpg']}
+ *   maxSizeInBytes={5 * 1024 * 1024}
+ *   onFileSelect={(file) => uploadFile.mutate(file)}
+ * />
+ *
+ * @example
+ * // Exibindo arquivo remoto já enviado, com download customizado
+ * <SingleFileUpload
+ *   storedFile={attachment}
+ *   showReplaceButton={false}
+ *   onDownload={async (f) => window.open(await getSignedUrl(f), '_blank')}
+ *   onView={(f) => openViewerDialog(f)}
+ *   onFileRemove={() => deleteAttachment.mutate(attachment.id)}
+ * />
+ *
+ * @example
+ * // Integrado com react-hook-form
+ * <Controller
+ *   name="evidence"
+ *   control={control}
+ *   render={({ field, fieldState }) => (
+ *     <SingleFileUpload
+ *       storedFile={field.value}
+ *       error={fieldState.error?.message}
+ *       touched={fieldState.isTouched}
+ *       required
+ *       onFileSelect={field.onChange}
+ *       onFileRemove={() => field.onChange(null)}
+ *     />
+ *   )}
+ * />
+ */
+export declare function SingleFileUpload({ storedFile, customFileName, allowedExtensions, customExtensionErrorMessage, minSizeInBytes, maxSizeInBytes, showDownloadButton, showViewButton, showReplaceButton, showCloseButton, required, touched, disabled, error: externalError, onFileSelect, onFileRemove, onFileReplace, onDownload, onView, className, }: SingleFileUploadProps): import("react/jsx-runtime").JSX.Element;

package/dist/leadership/file-upload/index.d.ts

@@ -0,0 +1,6 @@
+export { SingleFileUpload } from './components/SingleFileUpload';
+export type { SingleFileUploadProps } from './components/SingleFileUpload';
+export type { StoredFile, FileUploadError } from './types';
+export { FORBIDDEN_FILE_TYPES } from './types';
+export { formatBytes } from './utils/formatBytes';
+export { getFileExtension } from './utils/getFileExtension';

package/dist/leadership/file-upload/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tipo `StoredFile` exportado pela lib.
+ * @example
+ * const value: StoredFile = {} as StoredFile;
+ */
+export interface StoredFile {
+    id: string;
+    name: string;
+    extension: string;
+    size: number;
+}
+/**
+ * Tipo `FileUploadError` exportado pela lib.
+ * @example
+ * const value: FileUploadError = {} as FileUploadError;
+ */
+export interface FileUploadError {
+    type: 'extension' | 'min-size' | 'max-size' | 'forbidden-type' | 'custom';
+    message?: string;
+}
+/**
+ * Componente `FORBIDDEN_FILE_TYPES` da lib.
+ * @example
+ * <FORBIDDEN_FILE_TYPES />
+ */
+export declare const FORBIDDEN_FILE_TYPES: string[];

package/dist/leadership/file-upload/utils/formatBytes.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Função utilitária `formatBytes`.
+ * @example
+ * formatBytes();
+ */
+export declare function formatBytes(bytes: number): string;

package/dist/leadership/file-upload/utils/getFileExtension.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Função utilitária `getFileExtension`.
+ * @example
+ * getFileExtension();
+ */
+export declare function getFileExtension(fileName: string): string;

package/dist/leadership/hooks/useActiveModules.d.ts

@@ -0,0 +1,45 @@
+interface UseActiveModulesOptions {
+    enabled?: boolean;
+}
+/**
+ * Hook para buscar módulos ativos da empresa/unidade atual
+ *
+ * Útil para controlar features disponíveis baseado em módulos contratados.
+ * Usa cache do React Query para evitar chamadas repetidas.
+ *
+ * @example
+ * ```typescript
+ * import { useActiveModules } from 'forlogic-core/modular';
+ *
+ * function App() {
+ *   const { data: modules, isLoading } = useActiveModules();
+ *
+ *   const hasTrainingModule = modules?.some(m => m.name === 'training');
+ *
+ *   return (
+ *     <nav>
+ *       {hasTrainingModule && <Link to="/training">Treinamentos</Link>}
+ *     </nav>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Com enabled condicional
+ * function FeatureSettings() {
+ *   const { isAuthenticated } = useAuth();
+ *
+ *   const { data: modules } = useActiveModules({
+ *     enabled: isAuthenticated
+ *   });
+ * }
+ * ```
+ *
+ * @param options Opções de configuração
+ * @param options.enabled Se false, não executa a query (default: true)
+ *
+ * @returns Query result com array de módulos ativos
+ */
+export declare const useActiveModules: (options?: UseActiveModulesOptions) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+export {};

package/dist/leadership/hooks/useAliasFromUrl.d.ts

@@ -0,0 +1,33 @@
+export interface UseAliasFromUrlOptions {
+    /** Nome do param de rota (default: "alias") */
+    paramName?: string;
+}
+export interface UseAliasFromUrlReturn {
+    /** Alias extraído da URL (ou null se ausente) */
+    urlAlias: string | null;
+    /** true se há alias na URL e é diferente do alias ativo */
+    isAliasMismatch: boolean;
+    /** true se o alias da URL existe nas companies do usuário */
+    isValidAlias: boolean;
+    /** true se não há alias na URL */
+    isMissing: boolean;
+    /** Company correspondente ao alias da URL (ou null) */
+    matchedCompany: {
+        id: string;
+        alias: string;
+        name: string;
+    } | null;
+}
+/**
+ * Hook para extrair e validar o alias da URL contra as companies do usuário.
+ *
+ * Lê o param `:alias` do React Router e verifica se é um alias válido
+ * (presente na lista de companies do token de autenticação).
+ *
+ * @example
+ * ```tsx
+ * // Rota: /:alias/documents
+ * const { urlAlias, isAliasMismatch, isValidAlias, isMissing } = useAliasFromUrl();
+ * ```
+ */
+export declare function useAliasFromUrl(options?: UseAliasFromUrlOptions): UseAliasFromUrlReturn;

package/dist/leadership/hooks/useColumnResize.d.ts

@@ -0,0 +1,45 @@
+interface ColumnConfig {
+    key: string;
+    minWidth?: number;
+    maxWidth?: number;
+    defaultWidth?: number;
+}
+interface UseColumnResizeProps {
+    columns: ColumnConfig[];
+    /**
+     * Quando definido, persiste larguras em `localStorage[storageKey]`.
+     * Sem `storageKey`, o redimensionamento existe apenas em memória.
+     */
+    storageKey?: string;
+    onResize?: (widths: Record<string, number>) => void;
+    /** `false` desativa o drag (retorna apenas defaults). Default `true`. */
+    enabled?: boolean;
+}
+interface UseColumnResizeReturn {
+    columnWidths: Record<string, number>;
+    isDragging: boolean;
+    activeColumn: string | null;
+    /**
+     * Anexar ao `onMouseDown` do **handle** de resize (não no header inteiro)
+     * para evitar conflito com sort/click.
+     */
+    handleMouseDown: (columnKey: string, e: React.MouseEvent) => void;
+    /** Restaura defaults e remove a chave do `localStorage`. */
+    resetWidths: () => void;
+}
+/**
+ * Gerencia larguras de colunas com drag-to-resize, persistência opcional em localStorage
+ * e clamps por coluna. Usado internamente por `CrudTable` / `Table`.
+ *
+ * Efeitos colaterais durante o drag: define `cursor: col-resize` e `user-select: none` no `body`.
+ *
+ * @example
+ * ```tsx
+ * const { columnWidths, handleMouseDown, resetWidths } = useColumnResize({
+ *   columns: [{ key: 'name', minWidth: 100 }, { key: 'email' }],
+ *   storageKey: 'users-table-widths',
+ * });
+ * ```
+ */
+export declare function useColumnResize({ columns, storageKey, onResize, enabled }: UseColumnResizeProps): UseColumnResizeReturn;
+export {};

package/dist/leadership/hooks/useDebounce.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Hook para aplicar debounce em um valor com capacidade de cancelamento
+ *
+ * Útil para otimizar chamadas de API em campos de busca, evitando requisições
+ * a cada tecla digitada. Aguarda o usuário parar de digitar antes de processar.
+ *
+ * @example
+ * ```typescript
+ * import { useDebounce } from 'forlogic-core/modular';
+ *
+ * function SearchInput() {
+ *   const [searchTerm, setSearchTerm] = useState('');
+ *   const [debouncedSearch, cancelDebounce] = useDebounce(searchTerm, 500);
+ *
+ *   // API é chamada apenas quando usuário para de digitar por 500ms
+ *   const { data } = useQuery({
+ *     queryKey: ['search', debouncedSearch],
+ *     queryFn: () => api.search(debouncedSearch),
+ *     enabled: debouncedSearch.length > 0
+ *   });
+ *
+ *   return (
+ *     <input
+ *       value={searchTerm}
+ *       onChange={(e) => setSearchTerm(e.target.value)}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Com cancelamento manual
+ * function AutoSave() {
+ *   const [content, setContent] = useState('');
+ *   const [debouncedContent, cancelAutoSave] = useDebounce(content, 2000);
+ *
+ *   useEffect(() => {
+ *     if (debouncedContent) {
+ *       saveToServer(debouncedContent);
+ *     }
+ *   }, [debouncedContent]);
+ *
+ *   const handleManualSave = () => {
+ *     cancelAutoSave();  // Cancela auto-save pendente
+ *     saveToServer(content);  // Salva imediatamente
+ *   };
+ * }
+ * ```
+ *
+ * @param value Valor a ser debounced (qualquer tipo)
+ * @param delay Delay em milissegundos antes de aplicar o valor
+ *
+ * @returns Tupla [valor com debounce, função para cancelar]
+ */
+export declare function useDebounce<T>(value: T, delay: number): [T, () => void];

package/dist/leadership/hooks/useDerivedContractedModules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook que deriva a lista de módulos contratados a partir das associações do usuário.
+ * Cruza `association.softwares` com `SOFTWARES_MAP` e `MODULES_DATA`.
+ *
+ * @param override - Se fornecido, retorna diretamente (bypass da derivação)
+ * @returns Lista de nomes de módulos contratados, ou `undefined` se dados indisponíveis
+ */
+export declare function useDerivedContractedModules(override?: string[]): string[] | undefined;

package/dist/leadership/hooks/useI18nFormatters.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hook para formatação de datas respeitando as preferências do usuário
+ *
+ * Este é o hook RECOMENDADO para formatação de datas na aplicação.
+ * Ele automaticamente usa as configurações de locale e timezone
+ * definidas pelo usuário.
+ *
+ * NOTA: O formato de data/hora está temporariamente fixo em "dd/MM/yyyy HH:mm"
+ * até que a funcionalidade de preferências de formato seja implementada.
+ *
+ * @example
+ * ```tsx
+ * import { useI18nFormatters } from 'forlogic-core';
+ *
+ * function ActivityLog({ createdAt }: { createdAt: string }) {
+ *   const { formatDatetime, formatDate } = useI18nFormatters();
+ *
+ *   return (
+ *     <div>
+ *       <p>Criado em: {formatDatetime(createdAt)}</p>
+ *       <p>Data: {formatDate(createdAt)}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns Objeto com funções de formatação e valores de configuração
+ */
+export declare const useI18nFormatters: () => {
+    /** Formata data/hora completa */
+    formatDatetime: (dateString: string) => string;
+    /** Formata apenas data (sem hora) */
+    formatDate: (dateString: string) => string;
+    /** Locale atual do usuário */
+    locale: string;
+    /** Timezone atual do usuário */
+    timezone: string;
+    /** Formato de data/hora atual (fixo por enquanto) */
+    datetimeFormat: string;
+};

package/dist/leadership/hooks/useMediaQuery.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hook reativo para media queries CSS via `matchMedia`.
+ *
+ * @example
+ * ```ts
+ * const isMobile = useMediaQuery('(max-width: 767px)');
+ * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)');
+ * ```
+ */
+export declare function useMediaQuery(query: string): boolean;
+/**
+ * Atalho para detectar telas mobile (< 768px por padrão).
+ */
+export declare function useIsMobile(breakpoint?: number): boolean;

package/dist/leadership/hooks/useModuleAccess.d.ts

@@ -0,0 +1,59 @@
+import type { ModuleAccessResult } from '../types';
+/**
+ * Hook para verificar se o usuário logado tem acesso a um módulo específico.
+ *
+ * Usa um mapa estático de softwares (alias → id) e busca apenas as associações
+ * do usuário via API Qualiex para verificar acesso.
+ *
+ * **Pré-requisitos:**
+ * - O projeto deve configurar `moduleAlias` no `CoreProviders`
+ * - O usuário deve estar autenticado (via `useAuth`)
+ *
+ * **Cache:**
+ * - Associações: cache de 10 minutos (pode mudar com permissões)
+ * - Limpo automaticamente no `switchUnit`
+ *
+ * @param moduleAliasOverride - Alias opcional para verificar acesso a outro módulo
+ *                               (ignora o alias configurado no CoreProviders)
+ *
+ * @example
+ * ```tsx
+ * // Uso básico — verifica o módulo configurado no CoreProviders
+ * function Dashboard() {
+ *   const { hasAccess, isLoading, role } = useModuleAccess();
+ *
+ *   if (isLoading) return <LoadingState />;
+ *   if (!hasAccess) return <AccessDenied />;
+ *
+ *   return <DashboardContent />;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Verificar acesso a outro módulo
+ * function SupplierLink() {
+ *   const { hasAccessTo } = useModuleAccess();
+ *
+ *   if (!hasAccessTo('suppliers')) return null;
+ *   return <Link to="/suppliers">Fornecedores</Link>;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Verificar acesso a múltiplos módulos
+ * function Navigation() {
+ *   const { hasAccessTo } = useModuleAccess();
+ *
+ *   return (
+ *     <nav>
+ *       {hasAccessTo('occurrences') && <Link to="/occurrences">Ocorrências</Link>}
+ *       {hasAccessTo('audit') && <Link to="/audit">Auditorias</Link>}
+ *       {hasAccessTo(['suppliers', 'suppliers-portal']) && <Link to="/suppliers">Fornecedores</Link>}
+ *     </nav>
+ *   );
+ * }
+ * ```
+ */
+export declare function useModuleAccess(moduleAliasOverride?: string): ModuleAccessResult;

package/dist/leadership/hooks/usePageTitle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @deprecated Use a lógica de route matching diretamente no AppHeader.
+ * Mantido apenas para compatibilidade — não adicionar novos consumidores.
+ */
+export declare function usePageTitle(): string;
+/** Função pura para resolver título — usada internamente pelo AppHeader */
+export declare function resolvePageTitle(navigation: Array<{
+    path: string;
+    label: string;
+}> | undefined, pathname: string): string;

package/dist/leadership/hooks/usePermissionQuery.d.ts

@@ -0,0 +1,49 @@
+interface UsePermissionQueryOptions {
+    key: string;
+    enabled: boolean;
+    checkFn: () => Promise<boolean>;
+    staleTime?: number;
+    gcTime?: number;
+}
+/**
+ * Hook para verificar permissões com cache otimizado
+ *
+ * Usa React Query para cachear verificações de permissão, evitando
+ * chamadas repetidas ao servidor. Ideal para controle de acesso em páginas.
+ *
+ * @example
+ * ```typescript
+ * import { usePermissionQuery } from 'forlogic-core/modular';
+ * import { useAuth } from 'forlogic-core';
+ *
+ * function ProtectedPage() {
+ *   const { isAuthenticated } = useAuth();
+ *
+ *   const { data: hasAccess, isLoading } = usePermissionQuery({
+ *     key: 'can-manage-users',
+ *     enabled: isAuthenticated,
+ *     checkFn: async () => {
+ *       const response = await fetch('/api/permissions/manage-users');
+ *       return response.ok;
+ *     },
+ *     staleTime: 5 * 60 * 1000  // Cache por 5 minutos
+ *   });
+ *
+ *   if (isLoading) return <div>Verificando permissões...</div>;
+ *   if (!hasAccess) return <div>Acesso negado</div>;
+ *
+ *   return <div>Conteúdo protegido</div>;
+ * }
+ * ```
+ *
+ * @param options Configuração da verificação
+ * @param options.key Identificador único da permissão (usado como cache key)
+ * @param options.enabled Se false, não executa a verificação
+ * @param options.checkFn Função async que retorna true/false
+ * @param options.staleTime Tempo de cache em ms (default: 5min)
+ * @param options.gcTime Tempo de garbage collection em ms (default: 10min)
+ *
+ * @returns Query result com { data: boolean, isLoading, error }
+ */
+export declare const usePermissionQuery: ({ key, enabled, checkFn, staleTime, gcTime }: UsePermissionQueryOptions) => import("@tanstack/react-query").UseQueryResult<boolean, Error>;
+export {};

package/dist/leadership/hooks/useRowResize.d.ts

@@ -0,0 +1,37 @@
+interface UseRowResizeProps {
+    rowIds: string[];
+    /** Altura usada quando a linha não tem entrada explícita (fallback "virtual"). Default 48. */
+    defaultHeight?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    /** Persiste alturas em `localStorage[storageKey]` se definido. */
+    storageKey?: string;
+    onResize?: (heights: Record<string, number>) => void;
+    enabled?: boolean;
+}
+interface UseRowResizeReturn {
+    rowHeights: Record<string, number>;
+    isDragging: boolean;
+    activeRow: string | null;
+    handleMouseDown: (rowId: string, e: React.MouseEvent) => void;
+    resetHeights: () => void;
+    /**
+     * Retorna a altura de uma linha. Se a linha não foi redimensionada manualmente,
+     * devolve `defaultHeight` (não armazena no estado — comportamento "virtual").
+     */
+    getRowHeight: (rowId: string) => number;
+}
+/**
+ * Gerencia alturas de linhas com drag-to-resize. Apenas linhas modificadas são armazenadas;
+ * `getRowHeight` devolve `defaultHeight` para as demais.
+ *
+ * @example
+ * ```tsx
+ * const { getRowHeight, handleMouseDown } = useRowResize({
+ *   rowIds: rows.map(r => r.id),
+ *   storageKey: 'audit-rows',
+ * });
+ * ```
+ */
+export declare function useRowResize({ rowIds, defaultHeight, minHeight, maxHeight, storageKey, onResize, enabled }: UseRowResizeProps): UseRowResizeReturn;
+export {};