sapenlinea-components 0.6.68 → 0.7.69

package/README.md

@@ -1257,15 +1257,37 @@ Zona de arrastrar y soltar (Drag & Drop) para la **recepción de imágenes** de
 ### 36. Gráficas y Visualización: ECharts (Charts)
 
 **Qué hacen**  
-Subsistema de envolturas especializadas (wrappers) cimentado sobre `apache/echarts` para habilitar representaciones informativas sólidas a tamaño responsivo y dinámico, tolerando cambios visuales e interacciones al ocultarse o scroll.
+Subsistema de envolturas especializadas (wrappers) cimentado sobre `apache/echarts` para habilitar representaciones informativas sólidas a tamaño responsivo y dinámico. En la versión **0.6.69** se ha añadido soporte para interactividad y visualizaciones jerárquicas/agrupadas.
 
-**Componentes y Selectores disponibles:**
-- `lib-bar-chart` – Muestra gráficas de barras estandarizadas.
-- `lib-line-chart` – Muestra líneas analíticas en evolución.
-- `lib-donut-chart` – Gráfica de anillo jerarquizada.
+**Componentes disponibles:**
+
+#### `lib-bar-chart`
+Gráfica de barras estandarizada con soporte para una o múltiples series.
+- **Inputs:**
+  - `data: ChartItem[]` – Datos para gráfica de barra simple.
+  - `multiSeries: BarSeries[]` – (Opcional) Permite mostrar grupos de barras por cada sección.
+- **Interfases:**
+  ```ts
+  export interface BarSeries {
+    name: string;   // Nombre de la serie (aparece en la leyenda)
+    data: number[]; // Valores numéricos
+    color?: string; // Color personalizado opcional
+  }
+  ```
+
+#### `lib-donut-chart`
+Gráfica de anillo con capacidad de **Drill-down** y navegación interna.
+- **Inputs:**
+  - `data: ChartItem[]` – Datos granulares (ej. códigos de infracción `D01`, `D02`, `C01`).
+  - `drillDown: boolean = false` – Activa el modo de exploración jerárquica.
+  - `groupByPrefix: number = 0` – Agrupa los datos por los primeros N caracteres de la etiqueta (ej. `1` para agrupar por letras iniciales).
+- **Comportamiento:** Al activar el drill-down, el componente muestra inicialmente los totales agrupados y permite al usuario pulsar una sección para "abrirla" y ver su desglose, con un botón de "Volver" integrado.
+
+#### Otros:
+- `lib-line-chart` – Líneas analíticas en evolución.
 - `lib-heatmap` – Mapa de concentración de calor basado en coordenadas / categorías.
-- `lib-map-geo` – Gráfico de puntos de calor sobre mapa geofísico interactivo con tooltips nativos.
+- `lib-map-geo` – Puntos de calor sobre mapa geofísico interactivo.
 
-**Inputs habituales:**
-Generalmente aceptan su interfaz representativa principal `[data]="..."` o su objeto de ajuste avanzado `[config]="..."`.
+**Eventos Globales:**
+Todos los componentes de gráficas emiten el evento `chartClick`, permitiendo capturar clics en secciones específicas para lógicas personalizadas en el padre.