forlogic-core 2.1.5 → 2.2.0

package/dist/crud/primitives/Table.d.ts

@@ -21,6 +21,11 @@
  * ```
  */
 import type { TableProps } from './types';
+/**
+ * Função utilitária `Table`.
+ * @example
+ * Table();
+ */
 export declare function Table<T extends {
     id: string;
 }>({ data, columns, sortField, sortDirection, onSort, onRowClick, renderActions, isLoading, emptyMessage, className, enableSelection, selectedIds, onSelectItem, onSelectAll, isAllSelected, enableColumnResize, onColumnResize, enableColumnReorder, onReorderColumns, storageKey, enableExpandableRows, renderExpandedContent, expandedRowIds: controlledExpandedIds, onToggleExpand: controlledToggleExpand, defaultExpandAll, rowActionsVariant, hideActionsColumn, actionsHeaderContent, }: TableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/crud/primitives/TreeTable.d.ts

@@ -1,2 +1,7 @@
 import type { TreeNode, TreeTableProps } from './types';
+/**
+ * Função utilitária `TreeTable`.
+ * @example
+ * TreeTable();
+ */
 export declare function TreeTable<T extends TreeNode>({ data, columns, nameKey, nameHeader, iconComponent, expandedIds, onToggleExpand, onRowClick, renderActions, actionsHeader, rowActionsVariant, isLoading, emptyMessage, className, enableSelection, selectedIds: selectedIdsArray, onSelectItem, onSelectAll, isAllSelected, enableRowDrag, onMoveNode, onMoveNodes, rootDropLabel, actionsWidth, nameMinWidth, }: TreeTableProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/crud/primitives/types.d.ts

@@ -1,4 +1,21 @@
 import React from 'react';
+/**
+ * Definição de coluna do componente primitivo {@link TableProps | Table} (DataTable).
+ *
+ * Para tabelas CRUD completas, prefira {@link CrudColumn} (suporta `type`, `filterable`, etc).
+ *
+ * @example
+ * const columns: TableColumn<User>[] = [
+ *   { key: 'name', header: 'Nome', sortable: true, weight: 2 },
+ *   { key: 'email', header: 'E-mail', sortable: true, resizable: true },
+ *   {
+ *     key: 'status',
+ *     header: 'Status',
+ *     minWidth: 120,
+ *     render: (u) => <StatusBadge status={u.status} />,
+ *   },
+ * ];
+ */
 export interface TableColumn<T = any> {
     key: keyof T;
     header: string;
@@ -11,6 +28,11 @@ export interface TableColumn<T = any> {
     width?: number;
     resizable?: boolean;
 }
+/**
+ * Tipo `TableProps` exportado pela lib.
+ * @example
+ * const value: TableProps = {} as TableProps;
+ */
 export interface TableProps<T> {
     data: T[];
     columns: TableColumn<T>[];
@@ -50,6 +72,11 @@ export interface TableProps<T> {
     /** Conteúdo customizado para o header da coluna de ações (ex: ColumnSettingsPopover) */
     actionsHeaderContent?: React.ReactNode;
 }
+/**
+ * Tipo `ActionItem` exportado pela lib.
+ * @example
+ * const value: ActionItem = {} as ActionItem;
+ */
 export interface ActionItem {
     label: string;
     icon?: React.ComponentType<{
@@ -64,6 +91,11 @@ export interface ActionItem {
     /** Motivo do bloqueio (exibido em tooltip quando disabled=true) */
     disabledReason?: string;
 }
+/**
+ * Tipo `ActionMenuProps` exportado pela lib.
+ * @example
+ * const value: ActionMenuProps = {} as ActionMenuProps;
+ */
 export interface ActionMenuProps {
     onEdit?: () => void;
     onDelete?: () => void;
@@ -75,6 +107,11 @@ export interface ActionMenuProps {
     renderAs?: 'dropdown' | 'inline';
     variant?: 'default' | 'compact';
 }
+/**
+ * Tipo `PaginationProps` exportado pela lib.
+ * @example
+ * const value: PaginationProps = {} as PaginationProps;
+ */
 export interface PaginationProps {
     currentPage: number;
     totalPages: number;
@@ -84,11 +121,21 @@ export interface PaginationProps {
     onItemsPerPageChange: (limit: number) => void;
     variant?: 'full' | 'compact';
 }
+/**
+ * Tipo `TreeNode` exportado pela lib.
+ * @example
+ * const value: TreeNode = {} as TreeNode;
+ */
 export interface TreeNode {
     id: string;
     children?: TreeNode[];
     [key: string]: any;
 }
+/**
+ * Tipo `TreeTableColumn` exportado pela lib.
+ * @example
+ * const value: TreeTableColumn = {} as TreeTableColumn;
+ */
 export interface TreeTableColumn<T = any> {
     key: keyof T;
     header: string;
@@ -98,6 +145,11 @@ export interface TreeTableColumn<T = any> {
     /** Conteúdo exibido no HoverCard ao passar o mouse sobre o valor */
     hoverContent?: (item: T) => React.ReactNode;
 }
+/**
+ * Tipo `TreeTableProps` exportado pela lib.
+ * @example
+ * const value: TreeTableProps = {} as TreeTableProps;
+ */
 export interface TreeTableProps<T extends TreeNode = TreeNode> {
     data: T[];
     columns: TreeTableColumn<T>[];
@@ -132,6 +184,11 @@ export interface TreeTableProps<T extends TreeNode = TreeNode> {
     /** Largura mínima da coluna de nome em px (default: 200) */
     nameMinWidth?: number;
 }
+/**
+ * Tipo `FilterBarProps` exportado pela lib.
+ * @example
+ * const value: FilterBarProps = {} as FilterBarProps;
+ */
 export interface FilterBarProps {
     searchValue?: string;
     onSearchChange?: (value: string) => void;

package/dist/crud/utils/routingHelpers.d.ts

@@ -1,4 +1,9 @@
 import type { CrudEntity } from '../../types';
+/**
+ * Tipo `RoutingConfig` exportado pela lib.
+ * @example
+ * const value: RoutingConfig = {} as RoutingConfig;
+ */
 export interface RoutingConfig {
     basePath: string;
     newPath?: string;
@@ -8,6 +13,9 @@ export interface RoutingConfig {
  * Creates routing handlers for CRUD operations
  * @param config Configuration for routing paths
  * @returns Object with onNew and onEdit handlers
+ *
+ * @example
+ * createRoutingHandlers();
  */
 export declare function createRoutingHandlers<T extends CrudEntity>(config: RoutingConfig): {
     onNew: () => void;
@@ -18,6 +26,9 @@ export declare function createRoutingHandlers<T extends CrudEntity>(config: Rout
  * @param basePath Base path for the CRUD routes (e.g., '/articles')
  * @param config Optional custom paths
  * @returns Configuration object for CrudPageConfig
+ *
+ * @example
+ * createCrudRoutingConfig();
  */
 export declare function createCrudRoutingConfig<T extends CrudEntity>(basePath: string, config?: {
     newPath?: string;

package/dist/custom-form-fields/components/CustomFormFields.d.ts

@@ -4,5 +4,8 @@ import type { CustomFormFieldsProps } from '../types';
  *
  * Portado de FlcCustomFormFieldsComponent (flc-custom-form-fields).
  * Renderiza campos baseados em FieldAssociation[] e gerencia o state via onChange.
+ *
+ * @example
+ * CustomFormFields();
  */
 export declare function CustomFormFields({ fields, readOnly, hideInactiveWithoutValue, onChange, onFieldChange, }: CustomFormFieldsProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormDateField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de data (date).
  * Usa input type="date" nativo.
+ *
+ * @example
+ * FormDateField();
  */
 export declare function FormDateField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormMultiSelectionField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de seleção múltipla (multiSelection).
  * Suporta checkbox e chips (dropdown) via config.viewMode.
+ *
+ * @example
+ * FormMultiSelectionField();
  */
 export declare function FormMultiSelectionField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormNumericField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo numérico (number).
  * Suporta decimais, min e max via config.
+ *
+ * @example
+ * FormNumericField();
  */
 export declare function FormNumericField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormQuestionsField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de questões (questions).
  * Grid de perguntas × opções (estilo questionário/matriz).
+ *
+ * @example
+ * FormQuestionsField();
  */
 export declare function FormQuestionsField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormSingleSelectionField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de seleção única (singleSelection).
  * Suporta dropdown e radio via config.viewMode.
+ *
+ * @example
+ * FormSingleSelectionField();
  */
 export declare function FormSingleSelectionField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormTextField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de texto (text).
  * Suporta single-line e multiline via config.
+ *
+ * @example
+ * FormTextField();
  */
 export declare function FormTextField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormTimeField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de hora (time).
  * Usa input type="time" nativo. O valor é armazenado como minutos desde meia-noite.
+ *
+ * @example
+ * FormTimeField();
  */
 export declare function FormTimeField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/FormUrlField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de URL (url).
  * Suporta múltiplas URLs quando config.multiple = true.
+ *
+ * @example
+ * FormUrlField();
  */
 export declare function FormUrlField({ field, readOnly, onChange }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/fields/ReadOnlyTextField.d.ts

@@ -2,5 +2,8 @@ import type { BaseFieldProps } from '../types';
 /**
  * Campo de texto somente leitura (readOnlyText).
  * Exibe o texto configurado sem permitir edição.
+ *
+ * @example
+ * ReadOnlyTextField();
  */
 export declare function ReadOnlyTextField({ field }: BaseFieldProps): import("react/jsx-runtime").JSX.Element;

package/dist/custom-form-fields/types.d.ts

@@ -1,4 +1,7 @@
-/** Tipos de campo customizado do formulário */
+/** Tipos de campo customizado do formulário *
+ * @example
+ * const v = ECustomFormFieldType;
+ */
 export declare enum ECustomFormFieldType {
     readOnlyText = 1,
     text = 2,
@@ -10,20 +13,29 @@ export declare enum ECustomFormFieldType {
     multiSelection = 8,
     questions = 9
 }
-/** Modo de visualização de campos de seleção */
+/** Modo de visualização de campos de seleção *
+ * @example
+ * const v = EFieldViewMode;
+ */
 export declare enum EFieldViewMode {
     dropdown = 1,
     buttons = 2,
     radio = 3,
     checkbox = 4
 }
-/** Origem dos dados de campos de seleção */
+/** Origem dos dados de campos de seleção *
+ * @example
+ * const v = ESelectionFieldDataSource;
+ */
 export declare enum ESelectionFieldDataSource {
     custom = 1,
     users = 2,
     usersLists = 3
 }
-/** Item de uma lista de seleção (opção) */
+/** Item de uma lista de seleção (opção) *
+ * @example
+ * const value: RowItem = {} as RowItem;
+ */
 export interface RowItem {
     value: string;
     text: string;
@@ -33,51 +45,78 @@ export interface RowItem {
     /** Tipo do usuário (quando dataSource = users) */
     userType?: number;
 }
-/** Item de resposta de um campo de questões */
+/** Item de resposta de um campo de questões *
+ * @example
+ * const value: QuestionItem = {} as QuestionItem;
+ */
 export interface QuestionItem {
     questionValue: string;
     questionText: string;
     optionValue: string;
     optionText: string;
 }
-/** Configuração base de um campo */
+/** Configuração base de um campo *
+ * @example
+ * const value: FieldConfig = {} as FieldConfig;
+ */
 export interface FieldConfig {
 }
-/** Configuração de campo de texto */
+/** Configuração de campo de texto *
+ * @example
+ * const value: TextFieldConfig = {} as TextFieldConfig;
+ */
 export interface TextFieldConfig extends FieldConfig {
     multiline: boolean;
 }
-/** Configuração de campo numérico */
+/** Configuração de campo numérico *
+ * @example
+ * const value: NumberFieldConfig = {} as NumberFieldConfig;
+ */
 export interface NumberFieldConfig extends FieldConfig {
     decimals: number;
     min?: number;
     max?: number;
 }
-/** Configuração de campo URL */
+/** Configuração de campo URL *
+ * @example
+ * const value: UrlFieldConfig = {} as UrlFieldConfig;
+ */
 export interface UrlFieldConfig extends FieldConfig {
     multiple: boolean;
 }
-/** Configuração de campo de seleção única */
+/** Configuração de campo de seleção única *
+ * @example
+ * const value: SingleSelectionFieldConfig = {} as SingleSelectionFieldConfig;
+ */
 export interface SingleSelectionFieldConfig extends FieldConfig {
     viewMode: EFieldViewMode;
     dataSource: ESelectionFieldDataSource;
     data: RowItem[];
     userListId?: string;
 }
-/** Configuração de campo de seleção múltipla */
+/** Configuração de campo de seleção múltipla *
+ * @example
+ * const value: MultiSelectionFieldConfig = {} as MultiSelectionFieldConfig;
+ */
 export interface MultiSelectionFieldConfig extends FieldConfig {
     viewMode: EFieldViewMode;
     dataSource: ESelectionFieldDataSource;
     data: RowItem[];
     userListId?: string;
 }
-/** Configuração de campo de questões */
+/** Configuração de campo de questões *
+ * @example
+ * const value: QuestionsFieldConfig = {} as QuestionsFieldConfig;
+ */
 export interface QuestionsFieldConfig extends FieldConfig {
     viewMode: EFieldViewMode;
     questions: RowItem[];
     options: RowItem[];
 }
-/** Valor de um campo de formulário */
+/** Valor de um campo de formulário *
+ * @example
+ * const value: FormFieldValue = {} as FormFieldValue;
+ */
 export interface FormFieldValue {
     formFieldAssociationId: string;
     textValue?: string;
@@ -87,7 +126,10 @@ export interface FormFieldValue {
     itemsValue?: RowItem[];
     questionsValue?: QuestionItem[];
 }
-/** Associação de campo com formulário — modelo principal */
+/** Associação de campo com formulário — modelo principal *
+ * @example
+ * const value: FieldAssociation = {} as FieldAssociation;
+ */
 export interface FieldAssociation {
     id: string;
     type: ECustomFormFieldType;
@@ -106,13 +148,19 @@ export interface FieldAssociation {
     itemsValue?: RowItem[];
     questionsValue?: QuestionItem[];
 }
-/** Props compartilhadas por todos os campos individuais */
+/** Props compartilhadas por todos os campos individuais *
+ * @example
+ * const value: BaseFieldProps = {} as BaseFieldProps;
+ */
 export interface BaseFieldProps {
     field: FieldAssociation;
     readOnly?: boolean;
     onChange?: (field: FieldAssociation) => void;
 }
-/** Props do componente container CustomFormFields */
+/** Props do componente container CustomFormFields *
+ * @example
+ * const value: CustomFormFieldsProps = {} as CustomFormFieldsProps;
+ */
 export interface CustomFormFieldsProps {
     fields: FieldAssociation[];
     readOnly?: boolean;
@@ -128,15 +176,30 @@ export interface CustomFormFieldsProps {
         userType?: number;
     }>;
 }
-/** Extrai o valor correto de um FieldAssociation baseado no tipo */
+/** Extrai o valor correto de um FieldAssociation baseado no tipo *
+ * @example
+ * getFieldValue();
+ */
 export declare function getFieldValue(field: FieldAssociation): any;
-/** Verifica se um campo deve ser exibido (campo ativo ou com valor) */
+/** Verifica se um campo deve ser exibido (campo ativo ou com valor) *
+ * @example
+ * shouldShowField();
+ */
 export declare function shouldShowField(field: FieldAssociation, hideInactive: boolean): boolean;
-/** Converte FieldAssociation[] para FormFieldValue[] para envio ao backend */
+/** Converte FieldAssociation[] para FormFieldValue[] para envio ao backend *
+ * @example
+ * getFormFieldValues();
+ */
 export declare function getFormFieldValues(fields: FieldAssociation[]): FormFieldValue[];
-/** Aplica valores salvos a uma lista de FieldAssociation */
+/** Aplica valores salvos a uma lista de FieldAssociation *
+ * @example
+ * setFormFieldValues();
+ */
 export declare function setFormFieldValues(fields: FieldAssociation[], values: FormFieldValue[]): FieldAssociation[];
-/** Valida todos os campos obrigatórios */
+/** Valida todos os campos obrigatórios *
+ * @example
+ * validateFields();
+ */
 export declare function validateFields(fields: FieldAssociation[]): {
     valid: boolean;
     invalidFields: string[];

package/dist/exports/integrations.d.ts

@@ -12,3 +12,4 @@ export * from '../auth/services/AuthService';
 export { TokenManager } from '../auth/services/TokenManager';
 export * from '../auth/services/TokenService';
 export * from '../auth/utils/ErrorInterceptor';
+export * from '../integrations/clarity';

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

@@ -1,4 +1,19 @@
 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;
@@ -40,4 +55,48 @@ export interface SingleFileUploadProps {
     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/file-upload/types.d.ts

@@ -1,11 +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/file-upload/utils/formatBytes.d.ts

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

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

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

package/dist/hooks/useColumnResize.d.ts

@@ -6,16 +6,40 @@ interface ColumnConfig {
 }
 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/hooks/useRowResize.d.ts

@@ -1,8 +1,10 @@
 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;
@@ -13,7 +15,23 @@ interface UseRowResizeReturn {
     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 {};