@sfperusacdev/sf-ui 0.2.8 → 0.3.0

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
@@ -19,6 +20,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 +121,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 +171,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 +207,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;
@@ -136,6 +267,18 @@ type CustomTableProps<TData extends Record<string, unknown>, TDetail extends Rec
      */
     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, 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.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 {};

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

@@ -1,5 +1,5 @@
 export { CustomTable } from './CustomTable';
-export type { CustomColumn, CustomTableDetail, CustomTableProps, CustomTableServerPagination, TableHeaderVariant, } from './CustomTable';
+export type { CustomColumn, CustomTableDetail, CustomTableExport, CustomTableExportCriteria, CustomTableExportRequest, CustomTableExportScope, CustomTableFooterContext, CustomTableProps, CustomTableRemote, CustomTableRowMenuItem, CustomTableServerPagination, CustomTableSort, TableHeaderVariant, } from './CustomTable';
 export { AsyncCustomTable } from './AsyncCustomTable';
 export type { AsyncCustomTableProps } from './AsyncCustomTable';
 export { PaginationRangeInput } from './PaginationRangeInput';
@@ -11,7 +11,7 @@ export { TableSortingPanel } from './TableSortingPanel';
 export { createLocalStorageAsyncStateStore } from './asyncStateStore';
 export type { AsyncStateStore } from './asyncStateStore';
 export { useCustomTableController } from './customTableController';
-export type { CustomTableController } from './customTableController';
+export type { CustomTableController, CustomTableKeyedController } from './customTableController';
 export { columnFilterFn, inferInitialFilterValue, isColumnFilterValue, STRING_FILTER_OPS, NUMBER_FILTER_OPS, } from './tableFilters';
 export type { ColumnFilterValue, StringFilterOp, NumberFilterOp } from './tableFilters';
 export { useTableColumnSettings } from './useTableColumnSettings';

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

@@ -0,0 +1,2 @@
+export declare const warnTableConfig: (message: string) => void;
+export declare const resetTableConfigWarnings: () => void;

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

@@ -0,0 +1,8 @@
+import { Table } from '@tanstack/react-table';
+export declare const ROW_NUMBER_COLUMN_ID = "__rownumber";
+/**
+ * Posición (desde 1) de una fila raíz de los datos en el conjunto filtrado y ordenado completo, antes de paginar.
+ * Raíz es una fila de primer nivel de `data`: con agrupación queda debajo de grupos sintéticos, así que `depth` no
+ * sirve para reconocerla. Grupos e hijas de `subRows` no tienen número. Sin desplazamiento de servidor.
+ */
+export declare function rowNumberOf<TData>(table: Table<TData>, rowId: string): number | undefined;

package/dist/types/src/components/visualization/DnaHelix.d.ts

@@ -0,0 +1,33 @@
+import { ReactNode } from 'react';
+export type DnaHelixItem = {
+    key: string;
+    label: string;
+    /** Valor 0-100. Se muestra como porcentaje junto a la etiqueta (`showLabels`) y en el nombre accesible. */
+    value?: number;
+    /** Color CSS del tramo, el peldaño y el nodo. Por defecto, la paleta de categorías en orden. */
+    color?: string;
+    /** Contenido del nodo. Por defecto, el número de orden («01», «02»…). */
+    icon?: ReactNode;
+};
+export type DnaHelixProps = {
+    items: DnaHelixItem[];
+    /** Nodo resaltado con halo. */
+    selectedKey?: string;
+    /** Si viene, cada nodo es un botón (clic, Enter, Espacio). Sin él la hélice es solo una imagen. */
+    onSelect?: (key: string) => void;
+    /** Escribe nombre y valor al costado de cada nodo: para usar la hélice sola o en pantalla angosta. */
+    showLabels?: boolean;
+    /** Alto por elemento, en unidades del lienzo (el dibujo escala con el ancho del contenedor). Por defecto 64. */
+    rowHeight?: number;
+    /** Ancho máximo en píxeles. Por defecto 220, o 520 con `showLabels`. */
+    maxWidth?: number;
+    ariaLabel?: string;
+    emptyMessage?: string;
+    className?: string;
+};
+/**
+ * Doble hélice vertical: un tramo, un peldaño y un nodo por elemento, alternando el lado. Es un índice visual de
+ * hasta unas 12 dimensiones; los datos van en las tarjetas o el panel que la acompañan. SVG puro, colores por
+ * tokens, escala con su contenedor.
+ */
+export declare const DnaHelix: ({ items, selectedKey, onSelect, showLabels, rowHeight, maxWidth, ariaLabel, emptyMessage, className, }: DnaHelixProps) => import('react').JSX.Element;

package/dist/types/src/components/visualization/DnaHelix.test.d.ts

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

package/dist/types/src/components/visualization/NetworkLegend.d.ts

@@ -5,4 +5,4 @@ export type NetworkLegendProps = {
     placement?: "bottom-left" | "bottom-right";
     className?: string;
 };
-export declare const NetworkLegend: ({ nodes, edges, placement, className, }: NetworkLegendProps) => import("react").JSX.Element;
+export declare const NetworkLegend: ({ nodes, edges, placement, className, }: NetworkLegendProps) => import('react').JSX.Element;

package/dist/types/src/components/visualization/NetworkMap.d.ts

@@ -16,4 +16,4 @@ export type NetworkMapProps = {
     ariaLabel?: string;
     className?: string;
 };
-export declare const NetworkMap: ({ nodes, edges, center, zoom, height, selectedNodeId, onNodeClick, showLegend, fitBoundsToNodes, basemap: controlledBasemap, onBasemapChange, showBasemapSwitcher, ariaLabel, className, }: NetworkMapProps) => import("react").JSX.Element;
+export declare const NetworkMap: ({ nodes, edges, center, zoom, height, selectedNodeId, onNodeClick, showLegend, fitBoundsToNodes, basemap: controlledBasemap, onBasemapChange, showBasemapSwitcher, ariaLabel, className, }: NetworkMapProps) => import('react').JSX.Element;

package/dist/types/src/components/visualization/OrgTree.d.ts

@@ -17,4 +17,4 @@ export type OrgTreeProps<T extends OrgTreeNode = OrgTreeNode> = {
     maxHeight?: number | string;
     className?: string;
 };
-export declare const OrgTree: <T extends OrgTreeNode = OrgTreeNode>({ nodes, title, subtitle, loading, error, onRefresh, canEdit, onAddNode, onEditNode, onDeleteNode, showLegend, themes, onRenderNode, maxHeight, className, }: OrgTreeProps<T>) => import("react").JSX.Element;
+export declare const OrgTree: <T extends OrgTreeNode = OrgTreeNode>({ nodes, title, subtitle, loading, error, onRefresh, canEdit, onAddNode, onEditNode, onDeleteNode, showLegend, themes, onRenderNode, maxHeight, className, }: OrgTreeProps<T>) => import('react').JSX.Element;

package/dist/types/src/components/visualization/index.d.ts

@@ -1,3 +1,5 @@
+export { DnaHelix } from './DnaHelix';
+export type { DnaHelixProps, DnaHelixItem } from './DnaHelix';
 export { OrgTree } from './OrgTree';
 export type { OrgTreeProps } from './OrgTree';
 export { NetworkMap } from './NetworkMap';

package/dist/types/src/providers/SfProvider.d.ts

@@ -15,7 +15,7 @@ export type SfMapsRuntime = {
 type SfProviderValue = {
     maps?: SfMapsRuntime;
 };
-export declare const SfProvider: ({ maps, children }: SfProviderProps) => import("react").JSX.Element;
+export declare const SfProvider: ({ maps, children }: SfProviderProps) => import('react').JSX.Element;
 export declare const useSf: () => SfProviderValue;
 export declare const useSfMaps: () => SfMapsRuntime;
 export {};

package/dist/types/src/theme/paletaCategorias.test.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sfperusacdev/sf-ui",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "SF UI — librería de componentes React (inputs, tablas, hooks) para aplicaciones SF Perú.",
   "type": "module",
   "main": "./dist/sf-ui.umd.cjs",
@@ -120,9 +120,9 @@
     "tailwindcss": "^4.3.0",
     "typescript": "~6.0.2",
     "typescript-eslint": "^8.59.2",
-    "vite": "^8.0.12",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.1.9",
+    "vite": "^8.2.4",
+    "vite-plugin-dts": "^5.1.2",
+    "vitest": "^4.1.12",
     "yup": "^1.7.1"
   }
 }