forlogic-core 2.2.8 → 2.3.1

package/dist/leadership/crud/components/ColumnSettingsPopover.d.ts

@@ -0,0 +1,28 @@
+import type { CrudColumn, BaseEntity } from '../../types';
+/**
+ * Tipo `ColumnSettingsPopoverProps` exportado pela lib.
+ * @example
+ * const value: ColumnSettingsPopoverProps = {} as ColumnSettingsPopoverProps;
+ */
+export interface ColumnSettingsPopoverProps<T> {
+    columns: CrudColumn<T>[];
+    columnOrder: string[];
+    isColumnHidden: (key: string) => boolean;
+    toggleColumn: (key: string) => void;
+    showAllColumns: () => void;
+    resetColumns?: () => void;
+    reorderColumns: (fromIndex: number, toIndex: number) => void;
+    /** @deprecated Use groupByColumns + addGroupByColumn + removeGroupByColumn */
+    groupByColumn?: string | null;
+    /** @deprecated Use addGroupByColumn/removeGroupByColumn */
+    setGroupByColumn?: (key: string | null) => void;
+    groupByColumns?: string[];
+    addGroupByColumn?: (key: string) => void;
+    removeGroupByColumn?: (key: string) => void;
+}
+/**
+ * Função utilitária `ColumnSettingsPopover`.
+ * @example
+ * ColumnSettingsPopover();
+ */
+export declare function ColumnSettingsPopover<T extends BaseEntity>({ columns, columnOrder, isColumnHidden, toggleColumn, showAllColumns, reorderColumns, groupByColumn, setGroupByColumn, groupByColumns, addGroupByColumn, removeGroupByColumn, resetColumns, }: ColumnSettingsPopoverProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/leadership/crud/components/ContextMenu.d.ts

@@ -0,0 +1,21 @@
+import type { BaseEntity } from '../../types';
+interface ContextMenuProps<T extends BaseEntity> {
+    contextMenu: {
+        x: number;
+        y: number;
+        item: T;
+    } | null;
+    onClose: () => void;
+    onEdit?: (item: T) => void;
+    onDelete?: (item: T) => void;
+    onToggleStatus?: (item: T) => void;
+    customActions?: (item: T) => Array<{
+        icon: any;
+        label: string;
+        onClick: () => void;
+    }>;
+}
+export declare const ContextMenu: <T extends BaseEntity & {
+    is_actived?: boolean;
+}>({ contextMenu, onClose, onEdit, onDelete, onToggleStatus, customActions, }: ContextMenuProps<T>) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/leadership/crud/components/CrudActionBar.d.ts

@@ -0,0 +1,59 @@
+import React from 'react';
+import type { BaseEntity, BulkAction } from '../../types';
+/**
+ * Tipo `CustomAction` exportado pela lib.
+ * @example
+ * const value: CustomAction = {} as CustomAction;
+ */
+export interface CustomAction {
+    label: string;
+    icon?: React.ComponentType<{
+        size?: number;
+        className?: string;
+    }>;
+    action: () => void;
+    variant?: 'default' | 'outline' | 'ghost';
+    disabled?: boolean;
+    disabledReason?: string;
+}
+/**
+ * Tipo `ViewMode` exportado pela lib.
+ * @example
+ * const value: ViewMode = {} as ViewMode;
+ */
+export type ViewMode = 'table' | 'list' | 'grid';
+/**
+ * Tipo `CrudActionBarProps` exportado pela lib.
+ * @example
+ * const value: CrudActionBarProps = {} as CrudActionBarProps;
+ */
+export interface CrudActionBarProps<T extends BaseEntity = BaseEntity> {
+    onNew?: () => void;
+    newButtonLabel?: string;
+    showNewButton?: boolean;
+    showSearch?: boolean;
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    searchPlaceholder?: string;
+    showBulkActions?: boolean;
+    selectedCount?: number;
+    bulkActions?: BulkAction<T>[];
+    onBulkDelete?: () => void;
+    onClearSelection?: () => void;
+    customActions?: CustomAction[];
+    filters?: React.ReactNode;
+    viewMode?: ViewMode;
+    onViewModeChange?: (mode: ViewMode) => void;
+    showViewToggle?: boolean;
+    availableViewModes?: ViewMode[];
+    rightSlot?: React.ReactNode;
+    className?: string;
+}
+declare function CrudActionBarComponent<T extends BaseEntity = BaseEntity>({ onNew, newButtonLabel, showNewButton, showSearch, searchValue, onSearchChange, searchPlaceholder, showBulkActions, selectedCount, bulkActions, onBulkDelete, onClearSelection, customActions, filters, viewMode, onViewModeChange, showViewToggle, availableViewModes, rightSlot, className, }: CrudActionBarProps<T>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Componente `CrudActionBar` da lib.
+ * @example
+ * <CrudActionBar />
+ */
+export declare const CrudActionBar: typeof CrudActionBarComponent;
+export default CrudActionBar;

package/dist/leadership/crud/components/CrudGrid.d.ts

@@ -0,0 +1,53 @@
+import React from 'react';
+import type { CrudColumn, CrudManager, BaseEntity, BulkAction } from '../../types';
+import { type CustomAction, type ViewMode } from './CrudActionBar';
+/**
+ * Tipo `CrudGridProps` exportado pela lib.
+ * @example
+ * const value: CrudGridProps = {} as CrudGridProps;
+ */
+export interface CrudGridProps<T extends BaseEntity & {
+    is_actived?: boolean;
+}> {
+    manager: CrudManager<T>;
+    columns: CrudColumn<T>[];
+    onEdit?: (item: T) => void;
+    onView?: (item: T) => void;
+    onToggleStatus?: (item: T) => void;
+    onDelete?: (item: T) => void;
+    renderActions?: (item: T) => React.ReactNode;
+    customRowActions?: (item: T) => Array<{
+        icon: any;
+        label: string;
+        onClick: () => void;
+    }>;
+    enableBulkActions?: boolean;
+    onNew?: () => void;
+    newButtonLabel?: string;
+    showNewButton?: boolean;
+    customActions?: CustomAction[];
+    /** @deprecated Use showActionBar={false} instead */
+    hideActionBar?: boolean;
+    showActionBar?: boolean;
+    showSearch?: boolean;
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    searchPlaceholder?: string;
+    bulkActions?: BulkAction<T>[];
+    onBulkDelete?: () => void;
+    filters?: React.ReactNode;
+    gridColumns?: 1 | 2 | 3 | 4;
+    renderCard?: (item: T) => React.ReactNode;
+    viewMode?: ViewMode;
+    onViewModeChange?: (mode: ViewMode) => void;
+    listCardRenderer?: (item: T) => React.ReactNode;
+    gridCardRenderer?: (item: T) => React.ReactNode;
+    showViewToggle?: boolean;
+}
+/**
+ * Componente `CrudGrid` da lib.
+ * @example
+ * <CrudGrid />
+ */
+export declare const CrudGrid: <T extends BaseEntity>({ manager, columns, onEdit, onView, onToggleStatus, onDelete, renderActions, customRowActions, enableBulkActions, onNew, newButtonLabel, showNewButton, customActions, hideActionBar, showActionBar, showSearch, searchValue, onSearchChange, searchPlaceholder, bulkActions, onBulkDelete, filters, gridColumns, renderCard, viewMode, onViewModeChange, listCardRenderer, gridCardRenderer, showViewToggle }: CrudGridProps<T>) => import("react/jsx-runtime").JSX.Element;
+export default CrudGrid;

package/dist/leadership/crud/components/CrudPagination.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CrudPagination - Paginação CRUD com integração ao CrudManager
+ *
+ * Usa o primitivo Pagination com lógica de CRUD injetada.
+ * Antigo nome: TableFooter
+ */
+import type { CrudManager, BaseEntity } from '../../types';
+interface CrudPaginationProps<T extends BaseEntity> {
+    manager: Pick<CrudManager<T>, 'pagination' | 'handlePageChange' | 'handleItemsPerPageChange'>;
+}
+/**
+ * Função utilitária `CrudPagination`.
+ * @example
+ * CrudPagination();
+ */
+export declare function CrudPagination<T extends BaseEntity>({ manager }: CrudPaginationProps<T>): import("react/jsx-runtime").JSX.Element;
+export { CrudPagination as TableFooter };

package/dist/leadership/crud/components/CrudTable.d.ts

@@ -0,0 +1,66 @@
+import React from 'react';
+import type { CrudColumn, CrudManager, BaseEntity, BulkAction } from '../../types';
+import { type CustomAction, type ViewMode } from './CrudActionBar';
+export interface CrudTableProps<T extends BaseEntity & {
+    is_actived?: boolean;
+}> {
+    manager: CrudManager<T>;
+    columns: CrudColumn<T>[];
+    onEdit?: (item: T) => void;
+    onView?: (item: T) => void;
+    onToggleStatus?: (item: T) => void;
+    onDelete?: (item: T) => void;
+    renderActions?: (item: T) => React.ReactNode;
+    customRowActions?: (item: T) => Array<{
+        icon: any;
+        label: string;
+        onClick: () => void;
+    }>;
+    enableBulkActions?: boolean;
+    /** Variante de ações por linha: 'dropdown' (padrão) ou 'inline' (hover estilo Google Drive) */
+    rowActionsVariant?: 'dropdown' | 'inline';
+    onNew?: () => void;
+    newButtonLabel?: string;
+    showNewButton?: boolean;
+    customActions?: CustomAction[];
+    /** @deprecated Use showActionBar={false} instead */
+    hideActionBar?: boolean;
+    showActionBar?: boolean;
+    showSearch?: boolean;
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    searchPlaceholder?: string;
+    bulkActions?: BulkAction<T>[];
+    onBulkDelete?: () => void;
+    filters?: React.ReactNode;
+    viewMode?: ViewMode;
+    onViewModeChange?: (mode: ViewMode) => void;
+    showViewToggle?: boolean;
+    enableColumnResize?: boolean;
+    resizeStorageKey?: string;
+    enableColumnManager?: boolean;
+    columnManagerStorageKey?: string;
+    /** Column keys to hide by default (before user interaction). Only used when no saved state exists. */
+    defaultHiddenColumns?: string[];
+    /** Habilita agrupamento de colunas (GroupDropZone + opções de grupo no ColumnSettings). Default: false */
+    enableGrouping?: boolean;
+    /** Habilita linhas expandíveis com conteúdo customizado */
+    enableExpandableRows?: boolean;
+    /** Renderiza o conteúdo expandido de cada linha */
+    renderExpandedContent?: (item: T) => React.ReactNode;
+    /** IDs das linhas expandidas (modo controlado) */
+    expandedRowIds?: string[];
+    /** Callback ao expandir/colapsar uma linha (modo controlado) */
+    onToggleExpand?: (id: string) => void;
+    /** Se todas as linhas iniciam expandidas (default: false) */
+    defaultExpandAll?: boolean;
+    /** Oculta a coluna de ações separada. Útil quando ações são renderizadas dentro de uma coluna customizada. */
+    hideActionsColumn?: boolean;
+}
+/**
+ * Componente `CrudTable` da lib.
+ * @example
+ * <CrudTable />
+ */
+export declare const CrudTable: <T extends BaseEntity>({ manager, columns, onEdit, onView, onToggleStatus, onDelete, renderActions, customRowActions, enableBulkActions, rowActionsVariant, onNew, newButtonLabel, showNewButton, customActions, hideActionBar, showActionBar, showSearch, searchValue, onSearchChange, searchPlaceholder, bulkActions, onBulkDelete, filters, viewMode, onViewModeChange, showViewToggle, enableColumnResize, resizeStorageKey, enableColumnManager, columnManagerStorageKey, defaultHiddenColumns, enableGrouping, enableExpandableRows, renderExpandedContent, expandedRowIds: controlledExpandedIds, onToggleExpand: controlledToggleExpand, defaultExpandAll, hideActionsColumn, }: CrudTableProps<T>) => import("react/jsx-runtime").JSX.Element;
+export default CrudTable;

package/dist/leadership/crud/components/FilterBar.d.ts

@@ -0,0 +1,136 @@
+import type { CrudManager, CrudFilter, CrudEntity } from '../../types';
+/**
+ * Props do FilterBar
+ */
+interface FilterBarProps<T extends CrudEntity> {
+    /** Manager de CRUD com métodos de busca e limpeza de filtros */
+    manager: Pick<CrudManager<T>, 'searchTerm' | 'handleSearch' | 'clearFilters'>;
+    /** Array de filtros (busca e customizados) */
+    filters: CrudFilter[];
+    /**
+     * Se true, renderiza filtros inline (sem wrapper Stack).
+     * Usado na Action Bar para alinhar filtros horizontalmente com botões.
+     * @default false
+     */
+    inline?: boolean;
+}
+/**
+ * Barra de filtros para páginas CRUD
+ *
+ * Renderiza filtros de busca e customizados (Select, Checkbox, etc) para
+ * filtrar dados em páginas CRUD. Suporta dois modos de renderização:
+ * - **Standalone** (inline=false): Filtros em Stack vertical/horizontal
+ * - **Inline** (inline=true): Filtros sem wrapper, usados na Action Bar
+ *
+ * **Tipos de filtro suportados:**
+ * - `type: 'search'`: Campo de busca integrado com `manager.searchTerm`
+ * - `type: 'custom'`: Componente React customizado (Select, Checkbox, etc)
+ *
+ * **Botão t('clear_filters'):**
+ * - Aparece quando `manager.searchTerm` tem valor
+ * - Chama `manager.clearFilters()` ao clicar
+ * - Para limpar filtros customizados, sobrescreva `clearFilters` no manager
+ *
+ * @example
+ * ```typescript
+ * // Filtro de busca simples
+ * <FilterBar
+ *   manager={manager}
+ *   filters={[{ type: 'search' }]}
+ * />
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Filtros customizados com Select
+ * import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from 'forlogic-core';
+ *
+ * function ProcessesPage() {
+ *   const manager = useProcessCrud();
+ *   const [statusFilter, setStatusFilter] = useState('all');
+ *   const [departmentFilter, setDepartmentFilter] = useState('all');
+ *
+ *   const filters: CrudFilter[] = [
+ *     { type: 'search' },
+ *     {
+ *       type: 'custom',
+ *       component: ({ value, onChange }) => (
+ *         <Select value={value} onValueChange={onChange}>
+ *           <SelectTrigger className="w-[180px]">
+ *             <SelectValue placeholder="Status" />
+ *           </SelectTrigger>
+ *           <SelectContent>
+ *             <SelectItem value="all">Todos</SelectItem>
+ *             <SelectItem value="active">Ativos</SelectItem>
+ *             <SelectItem value="inactive">Inativos</SelectItem>
+ *           </SelectContent>
+ *         </Select>
+ *       ),
+ *       props: { value: statusFilter, onChange: setStatusFilter }
+ *     }
+ *   ];
+ *
+ *   return <FilterBar manager={manager} filters={filters} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Filtrar dados com useMemo
+ * function ProcessesPage() {
+ *   const manager = useProcessCrud();
+ *   const [statusFilter, setStatusFilter] = useState('all');
+ *
+ *   // Aplicar filtro customizado aos dados
+ *   const filteredData = useMemo(() => {
+ *     if (statusFilter === 'all') return manager.entities;
+ *     return manager.entities.filter(item => item.status === statusFilter);
+ *   }, [manager.entities, statusFilter]);
+ *
+ *   // Passar dados filtrados para a tabela
+ *   return <CrudTable manager={{ ...manager, entities: filteredData }} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Implementar t('clear_filters') customizado
+ * function ProcessesPage() {
+ *   const baseManager = useProcessCrud();
+ *   const [statusFilter, setStatusFilter] = useState('all');
+ *
+ *   // Sobrescrever clearFilters para resetar filtros customizados
+ *   const manager = {
+ *     ...baseManager,
+ *     clearFilters: () => {
+ *       baseManager.clearFilters(); // Limpa busca padrão
+ *       setStatusFilter('all');     // Reseta filtro customizado
+ *     }
+ *   };
+ *
+ *   return <FilterBar manager={manager} filters={[...]} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Modo inline (usado na Action Bar)
+ * <div className="flex items-center gap-4">
+ *   <Button>Novo</Button>
+ *   <FilterBar
+ *     manager={manager}
+ *     filters={filters}
+ *     inline={true}  // Sem wrapper Stack
+ *   />
+ * </div>
+ * ```
+ *
+ * @param props.manager Manager de CRUD com searchTerm, handleSearch, clearFilters
+ * @param props.filters Array de filtros (busca e customizados)
+ * @param props.inline Se true, renderiza sem wrapper Stack (para Action Bar)
+ *
+ * @see {@link CrudFilter} - Interface de configuração de filtros
+ * @see {@link createCrudPage} - Gerador de página CRUD que usa FilterBar
+ */
+export declare function FilterBar<T extends CrudEntity>({ manager, filters, inline, }: FilterBarProps<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/leadership/crud/components/GroupDropZone.d.ts

@@ -0,0 +1,16 @@
+import type { CrudColumn, BaseEntity } from '../../types';
+export interface GroupDropZoneProps<T> {
+    columns: CrudColumn<T>[];
+    groupByColumns: string[];
+    addGroupByColumn: (key: string) => void;
+    removeGroupByColumn: (key: string) => void;
+    reorderGroupByColumns: (fromIndex: number, toIndex: number) => void;
+}
+/**
+ * GroupDropZone
+ *
+ * Zona de drop acima da tabela onde headers de colunas podem ser arrastados
+ * para agrupar os dados. Mostra chips com os agrupamentos ativos.
+ * Suporta reordenação dos chips por drag-and-drop.
+ */
+export declare function GroupDropZone<T extends BaseEntity>({ columns, groupByColumns, addGroupByColumn, removeGroupByColumn, reorderGroupByColumns, }: GroupDropZoneProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/leadership/crud/components/InlineRowActions.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+interface InlineRowActionsProps {
+    onEdit?: () => void;
+    onDelete?: () => void;
+    canDelete?: boolean;
+    onToggleStatus?: () => void;
+    isActive?: boolean;
+    customActions?: Array<{
+        icon: any;
+        label: string;
+        onClick: () => void;
+    }>;
+}
+export declare const InlineRowActions: React.FC<InlineRowActionsProps>;
+export {};

package/dist/leadership/crud/components/SelectionCheckbox.d.ts

@@ -0,0 +1,9 @@
+export interface SelectionCheckboxProps {
+    checked: boolean;
+    onCheckedChange: () => void;
+}
+/**
+ * Memoized checkbox for selection in CrudTable/CrudGrid.
+ * Only re-renders when `checked` changes.
+ */
+export declare const SelectionCheckbox: import("react").NamedExoticComponent<SelectionCheckboxProps>;

package/dist/leadership/crud/components/TableFooter.d.ts

@@ -0,0 +1,14 @@
+interface TableFooterProps {
+    manager: {
+        pagination?: {
+            totalItems?: number;
+            totalPages?: number;
+        };
+        currentPage?: number;
+        itemsPerPage?: number;
+        handlePageChange?: (page: number) => void;
+        handleItemsPerPageChange?: (itemsPerPage: number) => void;
+    };
+}
+export declare const TableFooter: ({ manager }: TableFooterProps) => import("react/jsx-runtime").JSX.Element;
+export default TableFooter;

package/dist/leadership/crud/components/TableRowActions.d.ts

@@ -0,0 +1,19 @@
+interface TableRowActionsProps {
+    onEdit?: () => void;
+    onDelete?: () => void;
+    canDelete?: boolean;
+    onToggleStatus?: () => void;
+    isActive?: boolean;
+    customActions?: Array<{
+        icon: any;
+        label: string;
+        onClick: () => void;
+    }>;
+}
+/**
+ * Componente `TableRowActions` da lib.
+ * @example
+ * <TableRowActions />
+ */
+export declare const TableRowActions: React.FC<TableRowActionsProps>;
+export {};

package/dist/leadership/crud/createCrudPage.d.ts

@@ -0,0 +1,134 @@
+import React from "react";
+import type { CrudPageConfig, CrudEntity, FormSection, CrudFilter, BulkAction } from "../types";
+interface SimpleCrudPageConfig<T extends CrudEntity> {
+    entityName: string;
+    entityNamePlural: string;
+    columns: any[];
+    formSections: FormSection[];
+    cardFields?: any[];
+    filters?: CrudFilter[];
+    defaultSort?: {
+        column: string;
+        direction: "asc" | "desc";
+    };
+    enableBulkActions?: boolean;
+    bulkActions?: BulkAction<T>[];
+    customActions?: Array<{
+        label: string;
+        icon?: React.ComponentType<{
+            size?: number;
+            className?: string;
+        }>;
+        variant?: "default" | "destructive" | "outline" | "ghost";
+        action: () => void;
+        disabled?: boolean;
+        disabledReason?: string;
+    }>;
+    customRowActions?: (item: T) => Array<{
+        icon: any;
+        label: string;
+        onClick: () => void;
+    }>;
+    customListView?: (items: T[], manager?: any) => React.ReactNode;
+    onEdit?: (entity: T) => T | void;
+    /** Handler customizado para o botão "Novo" (abre wizard/modal customizado) */
+    onNew?: () => void;
+    /** Usar roteamento customizado (desabilita BaseForm padrão) */
+    useCustomRouting?: boolean;
+    /** @deprecated Use showNewButton={false} instead */
+    hideNewButton?: boolean;
+    /** Exibir botão "Novo" (default: true) */
+    showNewButton?: boolean;
+    /** Texto customizado para o botão "Novo" */
+    newButtonLabel?: string;
+    /** Exibir busca integrada na Action Bar (default: false - usa busca global) */
+    showSearch?: boolean;
+    /** Placeholder para busca integrada */
+    searchPlaceholder?: string;
+    /** Exibir Action Bar (default: true) */
+    showActionBar?: boolean;
+    /** Column keys to hide by default (before user interaction). Only used when no saved state exists. */
+    defaultHiddenColumns?: string[];
+}
+interface CrudPageGeneratorConfig<T extends CrudEntity> {
+    manager: any;
+    config: SimpleCrudPageConfig<T>;
+    onSave: (data: any) => void;
+    onEdit?: (entity: T) => T | void | Promise<T | void>;
+    onToggleStatus?: (item: T) => void;
+}
+/**
+ * Função utilitária `CrudPageInternal`.
+ * @example
+ * CrudPageInternal();
+ */
+declare function CrudPageInternal<T extends CrudEntity>({ manager, config, formSections, onSave, onToggleStatus, defaultSort, }: {
+    manager: any;
+    config: CrudPageConfig<T>;
+    formSections: FormSection[];
+    onSave: (data: any) => void;
+    onToggleStatus?: (item: T) => void;
+    defaultSort?: {
+        column: string;
+        direction: "asc" | "desc";
+    };
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Gera uma página CRUD completa (toolbar + tabela + paginação + form modal + confirmações).
+ *
+ * **IMPORTANTE**: a config deve ser memoizada (`useMemo` ou definida fora do componente)
+ * para evitar desmontagem e flicker no render — ver
+ * `mem://patterns/admin-render-optimization`.
+ *
+ * @example Pipeline completo
+ * ```tsx
+ * const employeesService = createSimpleService<Employee>({
+ *   tableName: 'employees',
+ *   schema: 'common',
+ * });
+ *
+ * function EmployeesPage() {
+ *   const manager = useCrudHook(employeesService);
+ *
+ *   const Page = useMemo(() => createCrudPage<Employee>({
+ *     manager,
+ *     config: {
+ *       entityName: 'Funcionário',
+ *       entityNamePlural: 'Funcionários',
+ *       columns: [...],
+ *       formSections: [...],
+ *       defaultHiddenColumns: ['created_at'], // formato: column.key
+ *     },
+ *     onSave: createSimpleSaveHandler(manager, c => c, u => u),
+ *   }), [manager]);
+ *
+ *   return <Page />;
+ * }
+ * ```
+ *
+ * @remarks
+ * - `onNew`: handler customizado para o botão "Novo" (abre wizard ao invés do modal padrão).
+ * - `useCustomRouting`: desabilita o `BaseForm` interno (use quando o "Novo/Editar" navega para outra rota).
+ * - `defaultHiddenColumns`: chaves de coluna escondidas no primeiro acesso (ignorado se houver
+ *   estado salvo do column manager).
+ * - `hideNewButton`: **deprecated** — use `showNewButton={false}`.
+ *
+ * @see `docs/design-system/crud.md`
+ */
+export declare function createCrudPage<T extends CrudEntity>(generatorConfig: CrudPageGeneratorConfig<T>): React.FC<{
+    manager?: any;
+}>;
+export { CrudPageInternal };
+/**
+ * Helper para criar handler de save (create ou update)
+ *
+ * @example
+ * ```typescript
+ * const handleSave = createSimpleSaveHandler(
+ *   manager,
+ *   (data) => ({ ...data, alias }),
+ *   (data) => ({ ...data })
+ * );
+ * ```
+ */
+export declare function createSimpleSaveHandler<T extends CrudEntity, TCreate, TUpdate>(manager: any, createTransform: (data: any) => TCreate, updateTransform: (data: any) => TUpdate): (data: any) => void;