--- name: tanstack-table-and-charts description: >- Comprehensive guide and design patterns for building high-performance, accessible data tables and dynamic visualizations using @tanstack/react-table and @tanstack/charts in React. Integrated with glassmorphism, SENA institutional colors, responsive mobile-first scrolling, and dark mode. --- # TanStack Table and TanStack Charts Skill This skill guides the implementation of headless, high-density data tables (`@tanstack/react-table`) and declarative data visualizations (`@tanstack/charts`) in React, seamlessly styled with Tailwind CSS, glassmorphism, and the institutional CPIC/SENA design system. --- ## 1. Package Installation & Dependencies ```bash # TanStack Table (v8) npm install @tanstack/react-table # TanStack Charts (Latest) npm install @tanstack/charts ``` --- ## 2. TanStack Table (`@tanstack/react-table`) TanStack Table is a headless library providing 100% control over markup and styling while handling complex state (sorting, filtering, pagination, selection, grouping). ### A. Core Architecture Pattern ```jsx import React, { useMemo, useState } from 'react'; import { useReactTable, getCoreRowModel, getSortedRowModel, getFilteredRowModel, getPaginationRowModel, flexRender, createColumnHelper, } from '@tanstack/react-table'; const columnHelper = createColumnHelper(); export const DataTable = ({ data, columns }) => { const [sorting, setSorting] = useState([]); const [globalFilter, setGlobalFilter] = useState(''); const table = useReactTable({ data, columns, state: { sorting, globalFilter, }, onSortingChange: setSorting, onGlobalFilterChange: setGlobalFilter, getCoreRowModel: getCoreRowModel(), getSortedRowModel: getSortedRowModel(), getFilteredRowModel: getFilteredRowModel(), getPaginationRowModel: getPaginationRowModel(), initialState: { pagination: { pageSize: 10 }, }, }); return (
{/* 1. Barra de Búsqueda y Filtro */}
setGlobalFilter(e.target.value)} placeholder="Buscar en la tabla..." className="w-full pl-8 pr-3 py-1.5 text-xs rounded-xl bg-white/70 dark:bg-white/5 border border-black/10 dark:border-white/10 text-gray-900 dark:text-white placeholder:text-gray-400 dark:placeholder:text-white/30 focus:outline-none focus:border-[#39A900] dark:focus:border-lime transition-all" />
{/* 2. Contenedor Glassmorphism con Scrollbar Responsive */}
{/* Encabezado Institucional SENA */} {table.getHeaderGroups().map(headerGroup => ( {headerGroup.headers.map(header => { const canSort = header.column.getCanSort(); const isSorted = header.column.getIsSorted(); return ( ); })} ))} {/* Cuerpo con Zebra Striping y Hover Glass */} {table.getRowModel().rows.length > 0 ? ( table.getRowModel().rows.map(row => ( {row.getVisibleCells().map(cell => ( ))} )) ) : ( )}
{flexRender(header.column.columnDef.header, header.getContext())} {canSort && ( {isSorted === 'asc' ? ( ) : isSorted === 'desc' ? ( ) : ( )} )}
{flexRender(cell.column.columnDef.cell, cell.getContext())}
No se encontraron resultados
{/* 3. Paginación Glassmorphic */}
Página {table.getState().pagination.pageIndex + 1} de {table.getPageCount()} ({table.getFilteredRowModel().rows.length} registros)
); }; ``` --- ## 3. TanStack Charts (`@tanstack/charts`) `@tanstack/charts` es la biblioteca de gráficos moderna y modular de TanStack. Emplea una gramática declarativa de visualización (escalas, series, ejes y tooltips) optimizada para renderizado rápido. ### A. Estructura y Componente con React Adapter ```jsx import React from 'react'; import { Chart } from '@tanstack/charts/react'; import { defineChart, lineY, barY } from '@tanstack/charts'; export const PerformanceMetricsChart = ({ data }) => { // data: [{ timestamp: '10:00', latency: 120, tokens: 450 }] return (
{/* Título de la tarjeta */}

Latencia de Respuestas (ms)

En tiempo real
{/* Contenedor del Gráfico */}
{/* Usar Chart de @tanstack/charts/react con la paleta de colores institucional */}
); }; ``` ### B. Paleta de Colores y Gráficos Institucionales (SENA) Para gráficos consistentes con el diseño del sistema: - **Línea Principal / Métrica Primaria**: `#39A900` (Modo claro) / `#a3e635` (Modo oscuro / `lime-400`). - **Métrica Secundaria / Comparativa**: `#0284c7` (Cyan 600) / `#38bdf8` (Cyan 400). - **Métrica de Alerta / Errores**: `#ef4444` (Red 500). - **Gradiente de Área**: Gradiente vertical translúcido desde `rgba(57, 169, 0, 0.35)` hasta `rgba(57, 169, 0, 0.0)`. - **Líneas de Guía (Grid)**: `rgba(0, 0, 0, 0.06)` (Claro) / `rgba(255, 255, 255, 0.06)` (Oscuro). - **Tooltips**: Contenedores flotantes con `backdrop-blur-md`, fondo `rgba(10, 22, 10, 0.9)` y borde `border-white/10`. --- ## 4. Cuándo Usar Cada Herramienta | Caso de Uso | Herramienta Recomendada | Beneficios | | :--- | :--- | :--- | | **Tablas CRUD & Administración** | `@tanstack/react-table` | Control total de columnas, ordenamiento, filtrado global y renderizado de celdas con botones/acciones. | | **Horarios & Matriz CRONODE** | `CronodeTableView` + `@tanstack/react-table` | Visualización estructurada con exportación PDF/Excel y alternancia a tarjetas/calendario. | | **Monitoreo de Latencia / Tokens** | `@tanstack/charts` | Gráficos de series de tiempo reactivos, ligeros y estilizables con el tema del sistema. | | **Distribución de Roles & Categorías** | `@tanstack/charts` (Bar / Donut) | Claridad visual en el Dashboard Administrativo con paleta SENA. | --- ## 5. Reglas de Integración con el Sistema CPIC 1. **No mezclar CSS ad-hoc**: Siempre usar las clases de diseño institucional (`text-[#39A900]`, `dark:text-lime`, `border-black/8`, `dark:border-white/10`). 2. **Scroll Horizontal Obligatorio**: Nunca permitir que tablas de más de 4 columnas fuercen overflow en la página; siempre encerrarlas en un contenedor `overflow-x-auto custom-scrollbar`. 3. **Optimización con Memoization**: Las definiciones de columnas `columns` y la data deben envolverse en `useMemo` para evitar re-computación de la tabla en cada render.