@sfperusacdev/sf-ui 0.2.9 → 0.3.1

package/dist/types/src/components/media-inputs/PhotoCropInput.d.ts

@@ -15,5 +15,5 @@ type PhotoCropInputProps<TFormValues extends FieldValues> = {
     onChange?: (file: File | null) => void;
     onRefresh?: () => Promise<void> | void;
 };
-export declare const PhotoCropInput: <TFormValues extends FieldValues>({ form, name, label, info, required, maxSizeMb, interactive, aspect, readOnly, disabled, small, className, onChange, onRefresh, }: PhotoCropInputProps<TFormValues>) => import("react").JSX.Element;
+export declare const PhotoCropInput: <TFormValues extends FieldValues>({ form, name, label, info, required, maxSizeMb, interactive, aspect, readOnly, disabled, small, className, onChange, onRefresh, }: PhotoCropInputProps<TFormValues>) => import('react').JSX.Element;
 export type { PhotoCropInputProps };

package/dist/types/src/components/media-inputs/SmartMediaInput.d.ts

@@ -39,5 +39,5 @@ type SmartMediaFileProps<TFormValues extends FieldValues> = SmartMediaBaseProps<
     onChange?: (files: File[]) => void;
 };
 export type SmartMediaInputProps<TFormValues extends FieldValues> = SmartMediaPhotoProps<TFormValues> | SmartMediaMultiPhotoProps<TFormValues> | SmartMediaSignatureProps<TFormValues> | SmartMediaFileProps<TFormValues>;
-export declare const SmartMediaInput: <TFormValues extends FieldValues>(props: SmartMediaInputProps<TFormValues>) => import("react").JSX.Element | null;
+export declare const SmartMediaInput: <TFormValues extends FieldValues>(props: SmartMediaInputProps<TFormValues>) => import('react').JSX.Element | null;
 export {};

package/dist/types/src/components/overlays/ConfirmDialog.d.ts

@@ -10,5 +10,5 @@ type ConfirmDialogProps = {
     loading?: boolean;
     danger?: boolean;
 };
-export declare const ConfirmDialog: ({ open, title, message, confirmLabel, cancelLabel, onConfirm, onCancel, loading, danger, }: ConfirmDialogProps) => import("react").JSX.Element;
+export declare const ConfirmDialog: ({ open, title, message, confirmLabel, cancelLabel, onConfirm, onCancel, loading, danger, }: ConfirmDialogProps) => import('react').JSX.Element;
 export {};

package/dist/types/src/components/overlays/ContextMenu.caracterizacion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/ContextMenu.d.ts

@@ -8,8 +8,34 @@ export type ContextMenuItem = {
     onClick?: (ctxValue?: unknown) => void;
 };
 export type ContextMenuItemDef = ContextMenuItem | ((ctxValue?: unknown) => ContextMenuItem | null | undefined);
+type MenuState = {
+    items: ContextMenuItem[];
+    isVisible: boolean;
+    event?: MouseEvent<HTMLElement>;
+    ctxValue?: unknown;
+    /** Posición en coordenadas de página cuando no hay evento de puntero (apertura por teclado). */
+    point?: {
+        x: number;
+        y: number;
+    };
+    /** Abierto con el teclado: el foco entra al menú y vuelve a `returnFocus` al cerrar. */
+    keyboard?: boolean;
+    returnFocus?: HTMLElement | null;
+};
+type MenuDispatch = (state: MenuState) => void;
 export type ContextMenuProviderProps = {
     children: ReactNode;
 };
+/**
+ * Anfitrión del menú (interno, no se exporta desde el índice). Con `keyboardNavigation` el menú sigue el patrón de
+ * menús de WAI-ARIA: flechas, Inicio/Fin, Enter, Escape y Tab, devolviendo el foco a quien lo abrió. Sin esa opción
+ * es exactamente el ContextMenuProvider publicado.
+ */
+export declare const ContextMenuHost: FC<ContextMenuProviderProps & {
+    keyboardNavigation?: boolean;
+}>;
 export declare const ContextMenuProvider: FC<ContextMenuProviderProps>;
+/** Interno: abre el menú del anfitrión más cercano con un estado completo (usado por CustomTable). */
+export declare const useContextMenuDispatch: () => MenuDispatch;
 export declare const useContextMenu: (defs: ContextMenuItemDef[]) => (event: MouseEvent<HTMLElement>, ctxValue?: unknown) => void;
+export {};

package/dist/types/src/components/overlays/Drawer.d.ts

@@ -15,9 +15,12 @@ export type DrawerProps = {
     height?: CSSProperties["height"];
     headerVariant?: OverlayHeaderVariant;
     closeOnOverlay?: boolean;
+    /** Al cerrar, devuelve el foco al control que lo tenía al abrir si quedó perdido. `false` si quien lo usa decide
+     * adónde vuelve el foco. */
+    restoreFocus?: boolean;
     className?: string;
 };
-export declare const Drawer: ({ open, onClose, side, title, subtitle, icon, children, footer, subheader, width, height, headerVariant, closeOnOverlay, className, }: DrawerProps) => import('react').ReactPortal | null;
+export declare const Drawer: ({ open, onClose, side, title, subtitle, icon, children, footer, subheader, width, height, headerVariant, closeOnOverlay, restoreFocus, className, }: DrawerProps) => import('react').ReactPortal | null;
 /** Alias de `Drawer` — patrón shadcn Sheet (panel lateral o inferior). */
-export declare const Sheet: ({ open, onClose, side, title, subtitle, icon, children, footer, subheader, width, height, headerVariant, closeOnOverlay, className, }: DrawerProps) => import('react').ReactPortal | null;
+export declare const Sheet: ({ open, onClose, side, title, subtitle, icon, children, footer, subheader, width, height, headerVariant, closeOnOverlay, restoreFocus, className, }: DrawerProps) => import('react').ReactPortal | null;
 export type SheetProps = DrawerProps;

package/dist/types/src/components/overlays/DropdownMenu.d.ts

@@ -9,7 +9,7 @@ type DropdownMenuProps = {
     className?: string;
 };
 export declare const useDropdownClose: () => () => void;
-export declare const DropdownMenu: ({ trigger, children, align, widthClassName, className, }: DropdownMenuProps) => import("react").JSX.Element;
+export declare const DropdownMenu: ({ trigger, children, align, widthClassName, className, }: DropdownMenuProps) => import('react').JSX.Element;
 type DropdownMenuItemProps = {
     label: string;
     onClick: () => void;

package/dist/types/src/components/overlays/DropdownMenu.estilos.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/Foco.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/MessageDialog.d.ts

@@ -8,4 +8,4 @@ export type MessageDialogProps = {
     message?: ReactNode;
     actionLabel?: string;
 };
-export declare const MessageDialog: ({ open, onClose, variant, title, message, actionLabel, }: MessageDialogProps) => import("react").JSX.Element;
+export declare const MessageDialog: ({ open, onClose, variant, title, message, actionLabel, }: MessageDialogProps) => import('react').JSX.Element;

package/dist/types/src/components/overlays/Modal.d.ts

@@ -22,9 +22,12 @@ export type ModalProps = {
     /** Oculta cabecera estándar (título, subtítulo, icono y cerrar) cuando el consumidor renderiza cabecera propia en el body. */
     hideHeader?: boolean;
     closeOnOverlay?: boolean;
+    /** Al cerrar, devuelve el foco al control que lo tenía al abrir si quedó perdido. `false` si quien lo usa decide
+     * adónde vuelve el foco. */
+    restoreFocus?: boolean;
     className?: string;
 };
-export declare const Modal: ({ open, onClose, title, subtitle, icon, children, footer, subheader, size, maxWidth, width, headerVariant, hideHeader, closeOnOverlay, className, }: ModalProps) => import('react').ReactPortal | null;
+export declare const Modal: ({ open, onClose, title, subtitle, icon, children, footer, subheader, size, maxWidth, width, headerVariant, hideHeader, closeOnOverlay, restoreFocus, className, }: ModalProps) => import('react').ReactPortal | null;
 type UseModalOptions = {
     onOpen?: () => void;
     onClose?: () => void;

package/dist/types/src/components/overlays/NotificationBell.d.ts

@@ -9,4 +9,4 @@ export type NotificationBellProps = {
     emptyLabel?: string;
     className?: string;
 };
-export declare const NotificationBell: ({ items, onItemClick, emptyLabel, className, }: NotificationBellProps) => import("react").JSX.Element;
+export declare const NotificationBell: ({ items, onItemClick, emptyLabel, className, }: NotificationBellProps) => import('react').JSX.Element;

package/dist/types/src/components/overlays/OptionItem.d.ts

@@ -8,4 +8,4 @@ export type OptionItemProps = {
     role?: AriaRole;
     className?: string;
 };
-export declare const OptionItem: ({ title, selected, icon, disabled, onClick, role, className, }: OptionItemProps) => import("react").JSX.Element;
+export declare const OptionItem: ({ title, selected, icon, disabled, onClick, role, className, }: OptionItemProps) => import('react').JSX.Element;

package/dist/types/src/components/overlays/Overlay.anidados.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/QRView.d.ts

@@ -6,4 +6,4 @@ export type QRViewProps = {
     size?: number;
     ariaLabel?: string;
 };
-export declare const QRView: ({ open, onClose, value, title, size, ariaLabel, }: QRViewProps) => import("react").JSX.Element;
+export declare const QRView: ({ open, onClose, value, title, size, ariaLabel, }: QRViewProps) => import('react').JSX.Element;

package/dist/types/src/components/overlays/TabMenuOption.d.ts

@@ -6,4 +6,4 @@ export type TabMenuOptionProps = {
     selected?: boolean;
     className?: string;
 };
-export declare const TabMenuOption: ({ label, icon, selected, className }: TabMenuOptionProps) => import("react").JSX.Element;
+export declare const TabMenuOption: ({ label, icon, selected, className }: TabMenuOptionProps) => import('react').JSX.Element;

package/dist/types/src/components/overlays/Tooltip.d.ts

@@ -7,4 +7,4 @@ export type TooltipProps = {
     className?: string;
     contentClassName?: string;
 };
-export declare const Tooltip: ({ content, children, placement, className, contentClassName, }: TooltipProps) => import("react").JSX.Element;
+export declare const Tooltip: ({ content, children, placement, className, contentClassName, }: TooltipProps) => import('react').JSX.Element;

package/dist/types/src/components/overlays/colorTexto.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/useFocoDeCapa.d.ts

@@ -0,0 +1,8 @@
+import { RefObject } from 'react';
+/**
+ * Foco de un diálogo de la pila (Modal, Drawer). Al abrir, enfoca el primer control del panel salvo que un hijo ya haya
+ * movido el foco dentro (el visor de MediaGallery enfoca su «Cerrar»). Mientras es la capa superior, Tab no sale del
+ * panel; si otro manejador ya atendió el Tab (preventDefault), no interviene. Al cerrar, si el foco quedó perdido,
+ * vuelve al control que tenía el foco al abrir.
+ */
+export declare const useFocoDeCapa: (abierto: boolean, idCapa: string, panel: RefObject<HTMLElement | null>, devolver?: boolean) => void;

package/dist/types/src/components/overlays/useOverlayStack.consulta.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/overlays/useOverlayStack.d.ts

@@ -0,0 +1,13 @@
+import { RefObject } from 'react';
+export declare const OverlayParentContext: import('react').Context<string | null>;
+export declare const useOverlayStack: (abierto: boolean, onClose: () => void, raiz: RefObject<HTMLDivElement | null>) => string;
+/** Capa superior registrada en la pila del documento, o `null`. Lectura pura: uso interno de sf-ui. */
+export declare const overlaySuperior: (documento: Document) => {
+    id: string;
+    raiz: HTMLElement;
+} | null;
+/**
+ * Avisa después de cada alta y baja en la pila del documento. Devuelve la baja (idempotente). Cada suscripción es
+ * propia aunque se repita la función. Uso interno de sf-ui.
+ */
+export declare const suscribirPilaOverlays: (documento: Document, oyente: () => void) => () => void;

package/dist/types/src/components/range-inputs/DateRangeFields.d.ts

@@ -33,5 +33,5 @@ type DateRangeFieldsProps<TFormValues extends FieldValues> = {
  * objeto `{start, end}` (con soporte UTC) — ideal para filtros; este mapea
  * directo a columnas del entity, que es el caso de los mantenimientos.
  */
-export declare const DateRangeFields: <TFormValues extends FieldValues>({ form, startName, endName, startLabel, endLabel, required, endRequired, small, readOnlyEnd, adjustEnd, onEndAdjusted, className, }: DateRangeFieldsProps<TFormValues>) => import("react").JSX.Element;
+export declare const DateRangeFields: <TFormValues extends FieldValues>({ form, startName, endName, startLabel, endLabel, required, endRequired, small, readOnlyEnd, adjustEnd, onEndAdjusted, className, }: DateRangeFieldsProps<TFormValues>) => import('react').JSX.Element;
 export {};

package/dist/types/src/components/range-inputs/DateRangeInput.d.ts

@@ -16,4 +16,4 @@ export type DateRangeInputProps<TFormValues extends FieldValues> = {
     onChange?: (value: DateRange) => void;
     onRefresh?: () => Promise<void> | void;
 };
-export declare const DateRangeInput: <TFormValues extends FieldValues>({ form, name, label, info, required, min, max, readOnly, disabled, small, className, utc, onChange, onRefresh, }: DateRangeInputProps<TFormValues>) => import("react").JSX.Element;
+export declare const DateRangeInput: <TFormValues extends FieldValues>({ form, name, label, info, required, min, max, readOnly, disabled, small, className, utc, onChange, onRefresh, }: DateRangeInputProps<TFormValues>) => import('react').JSX.Element;

package/dist/types/src/components/range-inputs/DateRangeUtcInput.d.ts

@@ -1,3 +1,3 @@
 import { FieldValues } from 'react-hook-form';
 import { DateRangeInputProps } from './DateRangeInput';
-export declare const DateRangeUtcInput: <TFormValues extends FieldValues>(props: Omit<DateRangeInputProps<TFormValues>, "utc">) => import("react").JSX.Element;
+export declare const DateRangeUtcInput: <TFormValues extends FieldValues>(props: Omit<DateRangeInputProps<TFormValues>, "utc">) => import('react').JSX.Element;

package/dist/types/src/components/range-inputs/TimeRangeInput.d.ts

@@ -14,5 +14,5 @@ type TimeRangeInputProps<TFormValues extends FieldValues> = {
     onChange?: (value: TimeRange) => void;
     onRefresh?: () => Promise<void> | void;
 };
-export declare const TimeRangeInput: <TFormValues extends FieldValues>({ form, name, label, info, required, readOnly, disabled, small, className, showDuration, onChange, onRefresh, }: TimeRangeInputProps<TFormValues>) => import("react").JSX.Element;
+export declare const TimeRangeInput: <TFormValues extends FieldValues>({ form, name, label, info, required, readOnly, disabled, small, className, showDuration, onChange, onRefresh, }: TimeRangeInputProps<TFormValues>) => import('react').JSX.Element;
 export type { TimeRangeInputProps };

package/dist/types/src/components/table/ActiveFiltersBar.d.ts

@@ -7,4 +7,4 @@ export type ActiveFiltersBarProps = {
     emptyLabel?: string;
     className?: string;
 };
-export declare const ActiveFiltersBar: ({ filters, onRemove, onClearAll, label, emptyLabel, className, }: ActiveFiltersBarProps) => import("react").JSX.Element;
+export declare const ActiveFiltersBar: ({ filters, onRemove, onClearAll, label, emptyLabel, className, }: ActiveFiltersBarProps) => import('react').JSX.Element;

package/dist/types/src/components/table/AsyncCustomTable.d.ts

@@ -9,5 +9,5 @@ type AsyncCustomTableProps<TData extends Record<string, unknown>> = Omit<CustomT
     errorMessage?: (error: Error) => ReactNode;
     emptyMessage?: string;
 };
-export declare function AsyncCustomTable<TData extends Record<string, unknown>>({ queryKey, queryFn, queryOptions, loadingMessage, errorMessage, emptyMessage, ...tableProps }: AsyncCustomTableProps<TData>): import("react").JSX.Element;
+export declare function AsyncCustomTable<TData extends Record<string, unknown>>({ queryKey, queryFn, queryOptions, loadingMessage, errorMessage, emptyMessage, ...tableProps }: AsyncCustomTableProps<TData>): import('react').JSX.Element;
 export type { AsyncCustomTableProps };

package/dist/types/src/components/table/CustomTable.ajuste.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.caracterizacion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.clavesHeredadas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.columnasOcultas.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.d.ts

@@ -4,6 +4,7 @@ import { AggregationFn } from '@tanstack/react-table';
 import { AsyncStateStore } from './asyncStateStore';
 import { PaginationVariant } from './Pagination';
 import { CustomTableController } from './customTableController';
+import { ExportTableColumn } from '../../utils/exportTableCsv';
 /**
  * Skin del `<thead>` del CustomTable. Los 4 variants nuevos (`soft`, `neon`,
  * `premium`, `matrix`) hacen match visual 1:1 con los variants del
@@ -11,6 +12,8 @@ import { CustomTableController } from './customTableController';
  * Todos se apoyan en tokens `--sf-*` para reaccionar al tema activo.
  */
 export type TableHeaderVariant = "default" | "brand" | "soft" | "neon" | "premium" | "matrix";
+export type CustomTableDensity = "default" | "compact";
+export type CustomTableRowActionsDisplay = "menu" | "inline";
 /** Estado de una paginación que resuelve el backend (limit/offset). `page` es 1-based. */
 export type CustomTableServerPagination = {
     totalItems: number;
@@ -19,6 +22,93 @@ export type CustomTableServerPagination = {
     onPageChange: (page: number) => void;
     onPageSizeChange: (pageSize: number) => void;
 };
+/** Acción del menú contextual de una fila (`getRowContextMenu`): `onClick` recibe la fila, con su tipo. */
+export type CustomTableRowMenuItem<TData> = {
+    id: string;
+    label: string;
+    icon?: IconType | string;
+    disabled?: boolean;
+    onClick: (row: TData) => void;
+};
+/**
+ * Contexto del pie (`footerSlot`). Son datos, no cálculos: los totales de negocio los hace la pantalla.
+ * Con `loadedOnly` (serverPagination o remote) los objetos son solo lo cargado, no el conjunto del servidor.
+ */
+export type CustomTableFooterContext<TData> = {
+    /** Filas de datos visibles en la página actual (búsqueda y orden aplicados; sin filas de grupo). */
+    pageRows: TData[];
+    /** Filas que pasan la búsqueda y los filtros, en todas las páginas de los datos cargados; incluye las hijas de `subRows`, sin orden garantizado. */
+    filteredRows: TData[];
+    /** Filas seleccionadas cargadas (lo mismo que `getSelectedRows`). */
+    selectedRows: TData[];
+    /** Claves seleccionadas con `getRowId`, incluidas las de filas no cargadas; sin identidad, []. */
+    selectedRowKeys: string[];
+    /** true con serverPagination o remote: los objetos anteriores son solo los datos cargados. */
+    loadedOnly: boolean;
+    /** Total informado por serverPagination, si existe. */
+    totalItems?: number;
+};
+/** Alcance de la exportación (`exportOptions`). */
+export type CustomTableExportScope = "selected" | "filtered" | "page" | "all";
+/** Pedido al host para un alcance que la tabla no tiene completo: datos remotos o selección con claves no cargadas. */
+export type CustomTableExportRequest<TData> = {
+    scope: CustomTableExportScope;
+    /** Claves seleccionadas con `getRowId`, incluidas las no cargadas; sin identidad, []. */
+    selectedRowKeys: string[];
+    /** Criterios efectivos de la tabla, para que el host exporte el mismo conjunto que se ve. */
+    criteria: CustomTableExportCriteria;
+    /** Escribe el .xls con las filas que entregue el host, con las mismas columnas, nombre y sanitización. */
+    download: (rows: TData[]) => void;
+};
+/** Búsqueda, filtros por columna y orden vigentes: los del host en modo remoto, los de la tabla en otro caso. */
+export type CustomTableExportCriteria = {
+    search: string;
+    /** Filtros del panel de la tabla (`{ id, value }` de TanStack). En modo remoto no hay filtros locales: []. */
+    columnFilters: {
+        id: string;
+        value: unknown;
+    }[];
+    sorting: CustomTableSort;
+};
+/**
+ * Exportación a Excel .xls (SpreadsheetML, no XLSX). Solo se ofrecen los alcances de `scopes`. Las columnas llevan
+ * encabezado y valor: no se leen las celdas dibujadas. Se exportan filas de datos (con sus hijas de subRows), nunca
+ * grupos ni columnas internas. Con serverPagination o remote, "filtered" y "all" los resuelve el host con `onRequest`;
+ * lo mismo la selección con claves no cargadas. Sin `onRequest` esas opciones quedan deshabilitadas.
+ */
+export type CustomTableExport<TData> = {
+    scopes: CustomTableExportScope[];
+    columns: ExportTableColumn<TData>[];
+    /** Nombre sin extensión; siempre se guarda como .xls. Default: "export". */
+    filename?: string | ((scope: CustomTableExportScope) => string);
+    /** Texto del botón. Default: "Exportar". */
+    label?: string;
+    onRequest?: (request: CustomTableExportRequest<TData>) => void;
+};
+/** Orden de una tabla en modo remoto: columnas por prioridad. */
+export type CustomTableSort = {
+    id: string;
+    desc: boolean;
+}[];
+/**
+ * Modo remoto: búsqueda y orden los resuelve el host. Activo con solo pasar `remote`: la tabla deja de filtrar y
+ * ordenar en el cliente. Cada control necesita su par completo valor + callback; si falta una mitad, ese control
+ * se deshabilita y avisa en desarrollo.
+ */
+export type CustomTableRemote = {
+    search?: {
+        value?: string;
+        onChange?: (value: string) => void;
+        /** Espera tras la última tecla antes de avisar al host. Por defecto 0 (aviso inmediato). */
+        debounceMs?: number;
+        /** Largo mínimo para avisar (vaciar el buscador siempre avisa). Por defecto 0. */
+        minLength?: number;
+    };
+    sorting?: {
+        value?: CustomTableSort;
+        onChange?: (sorting: CustomTableSort) => void;
+    };
+};
 type BuiltInAggregation = "sum" | "min" | "max" | "mean" | "median" | "unique" | "uniqueCount" | "count";
 type TableAggregation = BuiltInAggregation | AggregationFn<unknown>;
 type CustomColumn<TData> = {
@@ -33,6 +123,14 @@ type CustomColumn<TData> = {
     enableSorting?: boolean;
     enableHiding?: boolean;
     size?: number;
+    /**
+     * Ajuste de texto del contenido: `true` (hasta 320 px) o `{ maxWidth }` en píxeles, finito y positivo; un valor
+     * inválido usa 320 px y avisa en desarrollo. Es el ancho máximo del contenido, no de la columna: el encabezado y el
+     * relleno pueden ensancharla. Sin la opción o con `false`, la celda queda en una línea como siempre.
+     */
+    wrap?: boolean | {
+        maxWidth: number;
+    };
 };
 /**
  * Configuración de las filas de detalle expandibles (master-detail).
@@ -75,6 +173,13 @@ type CustomTableProps<TData extends Record<string, unknown>, TDetail extends Rec
     paginationVariant?: PaginationVariant | "legacy";
     /** Opciones del selector "Mostrar N registros por página". Default: 10/25/50/100/200. */
     pageSizeOptions?: number[];
+    /**
+     * Dónde va el paginador: "bottom" (por defecto, como siempre), "top" (antes del cuerpo) o "both" (dos con el mismo
+     * estado, etiquetados como superior e inferior). Sin enablePagination ni serverPagination no tiene efecto.
+     */
+    paginationPosition?: "bottom" | "top" | "both";
+    /** Botón «Exportar» en la barra con los alcances declarados (`CustomTableExport`). Sin la prop, la barra no cambia. */
+    exportOptions?: CustomTableExport<TData>;
     /**
      * Paginación en servidor: `data` ya es UNA página que trajo el backend. El
      * CustomTable no la recorta y dibuja el mismo paginador dentro de la tarjeta
@@ -104,6 +209,34 @@ type CustomTableProps<TData extends Record<string, unknown>, TDetail extends Rec
     onRefresh?: () => void;
     /** Clic en cualquier parte de una fila (excepto botones/enlaces internos). */
     onRowClick?: (row: TData) => void;
+    /**
+     * Doble clic en una fila (excepto botones, enlaces y controles internos; no aplica a filas agrupadas). Con esta
+     * opción la fila recibe foco y Enter ejecuta la misma acción. No retrasa `onRowClick`: si se configuran ambos, un
+     * doble clic produce normalmente dos `onRowClick` y un `onRowDoubleClick`.
+     */
+    onRowDoubleClick?: (row: TData) => void;
+    /**
+     * Columnas ocultas al abrir la tabla, por identificador de columna (`id` o `accessorKey`, no el título). Es solo el
+     * estado inicial: la visibilidad guardada en `stateStore` manda (también `{}`, todas visibles) y lo que el usuario
+     * muestre después no se vuelve a ocultar.
+     */
+    defaultHiddenColumns?: string[];
+    /**
+     * Menú contextual por fila. Sin esta prop el clic derecho abre el menú del navegador. Con ella: clic derecho en la
+     * fila (no en controles ni editores, que conservan el del navegador; no en filas agrupadas) abre el menú, sin
+     * seleccionar la fila; si la lista viene vacía queda el menú del navegador. Con el teclado: la fila recibe foco y
+     * la tecla Menú o Shift+F10 lo abre; flechas, Inicio/Fin, Enter, Escape y Tab, devolviendo el foco a la fila.
+     */
+    getRowContextMenu?: (row: TData) => CustomTableRowMenuItem<TData>[];
+    /** Pie bajo el cuerpo de la tabla, con el contexto de filas (`CustomTableFooterContext`). Sin la prop, sin pie. */
+    footerSlot?: (context: CustomTableFooterContext<TData>) => ReactNode;
+    /**
+     * Columna «N°» con la posición de cada fila raíz en lo filtrado y ordenado, continua entre páginas y entre grupos.
+     * Con serverPagination suma (page - 1) * pageSize: supone que el servidor pagina las mismas raíces que recibe la
+     * tabla. Grupos, hijas de subRows y detalles van sin número. No se ordena, no se oculta ni se guarda.
+     * Con la opción activa, `__rownumber` queda reservado: ninguna columna de datos debe usar ese id.
+     */
+    showRowNumbers?: boolean;
     enableRowSelection?: boolean;
     getRowActions?: (row: TData) => Array<{
         icon?: IconType;
@@ -130,12 +263,35 @@ type CustomTableProps<TData extends Record<string, unknown>, TDetail extends Rec
     searchPlaceholder?: string;
     /** Oculta título, toolbar y chrome exterior — para uso dentro de ExpandableTableSection u otros contenedores. */
     embedded?: boolean;
+    /**
+     * "compact": filas y cabecera bajas, letra menor y sin borde exterior del área de scroll; la tabla puede medir menos
+     * que su contenido máximo para caber en tarjetas angostas. Con `embedded` no hay título ni barra. Por defecto
+     * "default" (acabado publicado).
+     */
+    density?: CustomTableDensity;
+    /**
+     * "inline": las acciones de `getRowActions` se muestran como botones de ícono visibles en la fila (nombre accesible
+     * = `label`), en vez del menú ⋮. Por defecto "menu" (acabado publicado).
+     */
+    rowActionsDisplay?: CustomTableRowActionsDisplay;
     /**
      * Filas de detalle expandibles (master-detail). Agrega una columna de chevron al inicio
      * y, al expandir, inserta una fila con el detalle debajo de la fila padre.
      */
     detail?: CustomTableDetail<TData, TDetail>;
     controller?: CustomTableController<TData>;
+    /**
+     * Identidad de fila por clave: selección, detalle y controlador siguen a la fila aunque cambie su posición o su
+     * objeto. Exige `selectionAcrossPages`; sin ella se ignora (comportamiento anterior) y avisa en desarrollo.
+     */
+    getRowId?: (row: TData) => string;
+    /**
+     * Con `getRowId`: qué pasa con la selección al cambiar de página. "keep" conserva las claves (las filas que no
+     * están en la página no salen de la selección); "clear" la vacía. Sin valor por defecto: hay que declararlo.
+     */
+    selectionAcrossPages?: "keep" | "clear";
+    /** Búsqueda y orden resueltos por el host (ver `CustomTableRemote`). */
+    remote?: CustomTableRemote;
 };
-export declare function CustomTable<TData extends Record<string, unknown>, TDetail extends Record<string, unknown> = Record<string, unknown>>({ id, stateStore, data, columns, grouping, defaultGrouping, enableGrouping, enableSorting, enableFiltering, enablePagination, pageSize, paginationVariant, pageSizeOptions, serverPagination, fillParentHeight, maxBodyHeightPx, className, emptyMessage, title, subtitle, sidePanel, onGroupingChange, toolbarSlot, belowToolbarSlot, loading, loadingMessage, isFetching, error, onRetry, onRefresh, onRowClick, enableRowSelection, getRowActions, getBulkActions, bulkActionsSlot, onSelectionChange, headerVariant, searchPlaceholder, embedded, detail, controller, }: CustomTableProps<TData, TDetail>): import("react").JSX.Element;
+export declare function CustomTable<TData extends Record<string, unknown>, TDetail extends Record<string, unknown> = Record<string, unknown>>({ id, stateStore, data, columns, grouping, defaultGrouping, enableGrouping, enableSorting, enableFiltering, enablePagination, pageSize, paginationVariant, pageSizeOptions, paginationPosition, exportOptions, serverPagination, fillParentHeight, maxBodyHeightPx, className, emptyMessage, title, subtitle, sidePanel, onGroupingChange, toolbarSlot, belowToolbarSlot, loading, loadingMessage, isFetching, error, onRetry, onRefresh, onRowClick, onRowDoubleClick, defaultHiddenColumns, getRowContextMenu, footerSlot, showRowNumbers, enableRowSelection, getRowActions, getBulkActions, bulkActionsSlot, onSelectionChange, headerVariant, searchPlaceholder, embedded, density, rowActionsDisplay, detail, controller, getRowId, selectionAcrossPages, remote, }: CustomTableProps<TData, TDetail>): import('react').JSX.Element;
 export type { CustomColumn, CustomTableDetail, CustomTableProps, TableAggregation };

package/dist/types/src/components/table/CustomTable.defectosPublicados.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.densidad.caracterizacion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.densidad.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.dobleClic.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.estadoPorClave.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.exportacion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.identidadRemoto.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.l3Regresiones.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.menuContextual.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.numeracion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.paginador.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/CustomTable.pie.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/src/components/table/EditableDataGrid.d.ts

@@ -47,4 +47,4 @@ export type EditableDataGridProps<T extends Record<string, unknown>> = {
 };
 /** true si TODOS los campos indicados están vacíos ("" / null / undefined / 0 no cuenta como vacío) */
 export declare const isBlankRow: <T extends object>(row: T, keys: Array<keyof T & string>) => boolean;
-export declare const EditableDataGrid: <T extends Record<string, unknown>>({ data, columns, rowKey, onChange, className, mode, showIndex, onAddRow, addLabel, onRemoveRow, title, pageSize, emptyMessage, }: EditableDataGridProps<T>) => import("react").JSX.Element;
+export declare const EditableDataGrid: <T extends Record<string, unknown>>({ data, columns, rowKey, onChange, className, mode, showIndex, onAddRow, addLabel, onRemoveRow, title, pageSize, emptyMessage, }: EditableDataGridProps<T>) => import('react').JSX.Element;

package/dist/types/src/components/table/ExpandableTableSection.d.ts

@@ -23,4 +23,4 @@ export type ExpandableTableSectionProps<TData extends Record<string, unknown> =
     className?: string;
     ariaLabel?: string;
 };
-export declare const ExpandableTableSection: <TData extends Record<string, unknown> = Record<string, unknown>>({ items, type, className, ariaLabel, }: ExpandableTableSectionProps<TData>) => import("react").JSX.Element;
+export declare const ExpandableTableSection: <TData extends Record<string, unknown> = Record<string, unknown>>({ items, type, className, ariaLabel, }: ExpandableTableSectionProps<TData>) => import('react').JSX.Element;

package/dist/types/src/components/table/Pagination.d.ts

@@ -38,6 +38,8 @@ export interface PaginationProps {
     labels?: Partial<PaginationLabels>;
     /** id opcional para tests / a11y. */
     id?: string;
+    /** Nombre de la zona de navegación. Default: "Paginación". Distínguelo si hay más de un paginador en la página. */
+    ariaLabel?: string;
 }
 export interface PaginationLabels {
     showing: (from: number, to: number, total: number) => string;

package/dist/types/src/components/table/RowActionsMenu.d.ts

@@ -24,4 +24,4 @@ export declare function RowActionsMenu<T>({ row, actions, open, onOpenChange, }:
     actions: RowActionItem<T>[];
     open: boolean;
     onOpenChange: (open: boolean) => void;
-}): import("react").JSX.Element;
+}): import('react').JSX.Element;

package/dist/types/src/components/table/TableFiltersPanel.d.ts

@@ -13,5 +13,5 @@ type Props<TData extends Record<string, unknown>> = {
     table: Table<TData>;
     markUserEdit: () => void;
 };
-export declare function TableFiltersPanel<TData extends Record<string, unknown>>({ open, onClose, columnsMeta, headerLabelById, columnTypeById, columnFilters, table, markUserEdit, }: Props<TData>): import("react").JSX.Element | null;
+export declare function TableFiltersPanel<TData extends Record<string, unknown>>({ open, onClose, columnsMeta, headerLabelById, columnTypeById, columnFilters, table, markUserEdit, }: Props<TData>): import('react').JSX.Element | null;
 export {};

package/dist/types/src/components/table/TableSortingPanel.d.ts

@@ -12,5 +12,5 @@ type Props<TData extends Record<string, unknown>> = {
     table: Table<TData>;
     markUserEdit: () => void;
 };
-export declare function TableSortingPanel<TData extends Record<string, unknown>>({ open, onClose, columnsMeta, headerLabelById, sorting, table, markUserEdit, }: Props<TData>): import("react").JSX.Element | null;
+export declare function TableSortingPanel<TData extends Record<string, unknown>>({ open, onClose, columnsMeta, headerLabelById, sorting, table, markUserEdit, }: Props<TData>): import('react').JSX.Element | null;
 export {};

package/dist/types/src/components/table/customTableController.d.ts

@@ -5,11 +5,14 @@ type RegisterProps<T> = {
         selectRowFn: SelectRowFn<T>;
         cleanSelectionFn: () => void;
         getSelectedRowsFn: SelectedRowsFn<T>;
+        getSelectedRowKeysFn?: () => string[];
+        forgetKeysFn?: (keys: string[]) => void;
     };
     row?: {
         selectRowFn: (row: T) => void;
         cleanSelectionFn: () => void;
         getSelectedRowFn: () => T | undefined;
+        getSelectedRowKeyFn?: () => string | undefined;
     };
 };
 type SelectionController<T> = {
@@ -29,6 +32,22 @@ export type CustomTableController<T> = {
     selection: SelectionController<T>;
     row: RowController<T>;
 };
+/**
+ * Lo que devuelve useCustomTableController: el controlador publicado más los métodos por clave de la identidad de
+ * fila (`getRowId` en la tabla). Es asignable a CustomTableController, que no cambia.
+ */
+export type CustomTableKeyedController<T> = CustomTableController<T> & {
+    selection: {
+        /** Claves de la selección, incluidas las de filas no cargadas. Sin identidad: []. */
+        getSelectedRowKeys: () => string[];
+        /** Quita de la selección las claves de filas eliminadas de verdad (eliminación confirmada por el host). */
+        forgetKeys: (keys: string[]) => void;
+    };
+    row: {
+        /** Clave de la fila elegida. Sin identidad: undefined. */
+        getSelectedRowKey: () => string | undefined;
+    };
+};
 export type CustomTableControllerInternal<T> = {
     events: {
         selection: {
@@ -47,5 +66,5 @@ export declare const useCustomTableController: <TData>(props?: {
     row?: {
         onChange?: (row?: TData) => void;
     };
-}) => CustomTableController<TData>;
+}) => CustomTableKeyedController<TData>;
 export {};