energy-components 2.3.1 → 2.5.0

package/llms/rdsaccordion-group.md

@@ -5,3 +5,9 @@
 | Slot | Descripción | Bindings |
 |---|---|---|
 | default | Aqui se cargan los elementos `RDSAccordion` |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| openAll | Abre todos los paneles del acordeón |
+| closeAll | Cierra todos los paneles del acordeón |

package/llms/rdsaccordion.md

@@ -22,3 +22,9 @@
 | Slot | Descripción | Bindings |
 |---|---|---|
 | default | Contenido principal del panel |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| openPanel | Abre el panel. |
+| closePanel | Cierra el panel. |

package/llms/rdsaction-button.md

@@ -13,3 +13,4 @@
 | id | string | No | undefined | <span>ID del botón para testing</span> |  |
 | tooltip | string | No |  | <span>Contenido del tooltip. Si se proporciona, se mostrará el tooltip al hacer hover</span> |  |
 | tooltipPosition | string | No | undefined | <span>Posición del tooltip (top, bottom, left, right). Si no se especifica, se posiciona automáticamente</span> |  |
+| tooltipProps | TooltipProps | No | () => ({}) | <span>Props adicionales para el RDSTooltip interno. Permite configurar cualquier prop de RDSTooltip (ej: teleportTo, offsetSpace, hideDelay, large…). Los valores aquí definidos sobreescriben los derivados de `tooltip` y `tooltipPosition`.</span> |  |

package/llms/rdsbadge.md

@@ -15,3 +15,8 @@
 | Slot | Descripción | Bindings |
 |---|---|---|
 | default |  |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| el |  |

package/llms/rdsbreadcrumbs.md

@@ -8,6 +8,8 @@
 | inverse | boolean | No | false | <span>Indica si el breadcrumb se mostrará en modo inverso. En modo inverso, el texto es claro sobre un fondo oscuro.</span> |  |
 | trimItems | boolean | No | false | <span>Indica si el breadcrumb debe ser recortado en el medio, y mostrar un botón en su lugar.</span> |  |
 | leftTrim | boolean | No | false | <span>Indica si el breadcrumb debe ser recortado por la izquierda, mostrando solo los dos últimos niveles.</span> |  |
+| ariaLabel | string | No | Breadcrumb | <span>Etiqueta accesible del landmark de navegación para i18n</span> |  |
+| ellipsisAriaLabel | string | No | Show hidden levels | <span>Etiqueta accesible del botón de elipsis para i18n</span> |  |
 | id | string | No | undefined | ID del breadcrumbs para testing |  |
 
 ## Eventos

package/llms/rdsdate-picker.md

@@ -63,3 +63,9 @@
 |---|---|---|
 | day | Modificar como se ve el numero del dia del calendario. | day: any, date: any |
 | slot | `GENERICO`, se puden pasar todos los slots de VueDatePicker | name: any |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| selectDate | Selecciona la fecha, comunmente usada para el boton de accion |
+| clearValue | Limpia el valor del datepicker |

package/llms/rdsdropdown.md

@@ -47,3 +47,9 @@
 | noResult |  | search: any |
 | limit |  |  |
 | maxElements |  |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| activate | Abre el dropdown |
+| deactivate | Cierra el dropdown |

package/llms/rdslink.md

@@ -10,7 +10,7 @@
   name: '',
   modifier: ''
 } | <span>Icono a mostrar en el link</span> |  |
-| tag | string | No | router-link | <span>Tag del link</span> |  |
+| tag | string | No | router-link | <span>Tag semántico del componente. Valores soportados: <code>router-link</code> (navegación interna), <code>a</code> (enlace externo) y <code>button</code> (acción sin navegación).</span> |  |
 | disabled | boolean | No | false | <span>Indica si el link esta deshabilitado</span> |  |
 | underline | boolean | No | false | <span>Indica si el link tiene underline</span> |  |
 | inverse | boolean | No | false | <span>Indica si el link es inverso</span> |  |

package/llms/rdsmodal.md

@@ -30,3 +30,12 @@
 | header |  |  |
 | body |  |  |
 | footer |  |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| modalClickOutside | { () => void } Gestiona el clic fuera del modal. |
+| openModal | { () => void } Solicita abrir el modal. |
+| closeModal | { () => void } Solicita cerrar el modal. |
+| changeModalState | { (state: boolean) => void } Cambia el estado del modal. |
+| toggleModal | { () => void } Alterna el estado del modal. |

package/llms/rdspagination.md

@@ -15,6 +15,7 @@
 | enableEllipsis | boolean | No | false | Habilita la funcionalidad de elipsis (...) para mostrar páginas ocultas. Cuando se hace click en las elipsis, se emite un evento con las páginas ocultas. |  |
 | enablePageDropdown | boolean | No | false | Habilita la funcionalidad de selector de paginación. Añade un dropdown para seleccionar la página. Cómo máximo se muestran 3 páginas en la paginación |  |
 | pageDropdownLabel | string | No |  | Label para el dropdown de selección de página. |  |
+| legendText | string | No | undefined | Texto personalizado para la leyenda de paginación. Usa {start}, {end} y {total} como placeholders. Ejemplo: 'Showing {start}-{end} of {total} results' Si no se provee, se usa el texto por defecto. |  |
 | id | string | No | undefined | ID de la paginación para testing |  |
 
 ## Eventos
@@ -22,3 +23,8 @@
 |---|---|---|
 | pageChanged | PageChangedEventPayload | Se emite cuando el usuario interactúa con la paginación (cambia de página). El payload es un objeto con detalles sobre la nueva página y los límites de items. |
 | ellipsisClicked | { hiddenPages: number[], ellipsisType: string, currentPage: number, totalPages: number } | Se emite cuando el usuario hace click en las elipsis (...). El payload incluye las páginas ocultas y el tipo de elipsis. |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| resetPagination | Resetea la paginación a la primera página y emite el evento pageChanged. |

package/llms/rdspersistent-toast.md

@@ -10,6 +10,7 @@
 | icon | string | No |  | El icono asociado con el mensaje. Un icono opcional que se mostrará junto al mensaje. Puede ser el nombre de un icono de una biblioteca de iconos. |  |
 | close | boolean | No |  | Indica si se debe mostrar el botón de cierre. Si es `true`, se mostrará un botón para cerrar el mensaje. |  |
 | id | string | No | undefined | ID del persistent-toast para testing |  |
+| closeAriaLabel | string | No | Cerrar | <span>Etiqueta accesible del botón de cerrar. Por convención del sistema, el valor por defecto es español ('Cerrar'). En proyectos con i18n, se debe sobrescribir esta prop con el valor traducido.</span> |  |
 
 ## Eventos
 | Evento | Payload | Descripción |

package/llms/rdspopover-menu.md

@@ -27,3 +27,10 @@
 | trigger |  |  |
 | default |  |  |
 | item |  | item: any, index: any, on-select: any |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| toggle | Alterna el estado abierto/cerrado del popover |
+| close | Cierra programáticamente el popover |
+| isOpen | Ref reactiva del estado abierto |

package/llms/rdspopover.md

@@ -27,3 +27,10 @@
 | trigger |  |  |
 | default |  |  |
 | item |  | item: any, index: any, on-select: any |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| toggle |  |
+| close |  |
+| isOpen |  |

package/llms/rdssearch-field.md

@@ -12,6 +12,7 @@
 | maxLength | number | No |  | Número máximo de caracteres permitidos. |  |
 | id | string | No |  | Identificador único del campo. Se autogenera si no se proporciona. |  |
 | clearButtonAriaLabel | string | No | Limpiar campo | Texto accesible del botón de limpiar. Permite internacionalización. |  |
+| inverse | boolean | No | false | Activa los estilos de variante inversa para superficies oscuras. |  |
 
 ## Eventos
 | Evento | Payload | Descripción |
@@ -20,3 +21,9 @@
 | clear |  | Emitido cuando el usuario limpia el campo |
 | search | string | Emitido cuando el usuario pulsa Enter (sin sugerencia activa) |
 | select | string | Emitido cuando el usuario selecciona una sugerencia |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| focus |  |
+| blur |  |

package/llms/rdssidebar.md

@@ -23,3 +23,12 @@
 | content | Si se usa este slot se sustituyen los de por defecto y hay que manejar manualmente el estado de apertura y cierre |  |
 | collapsed |  |  |
 | expanded |  |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| isCollapsed | { boolean } Muestra el estado actual del sidebar. |
+| openSidebar | { () => void } Abre el sidebar. |
+| closeSidebar | { () => void } Cierra el sidebar. |
+| toogleSidebar | { (state: boolean) => void } Cambia el estado del sidebar. |
+| toggleSidebar | { () => void } Alterna el estado del sidebar. (Nombre correcto) |

package/llms/rdssidedrawer.md

@@ -9,6 +9,7 @@
 | blurOverlay | boolean | No | true | <span>Mostrar o no el Blur del overlay</span> |  |
 | containerWidth | string | No |  | <span>Define el ancho del componente al abrirse</span> |  |
 | persistent | boolean | No | false | <span>Indica si el sidedrawer permanece abierto al hacer click fuera de él</span> |  |
+| closeAriaLabel | string | No | Cerrar | <span>Etiqueta accesible del botón de cerrar. Por convención del sistema, el valor por defecto es español ('Cerrar'). En proyectos con i18n, se debe sobrescribir esta prop con el valor traducido.</span> |  |
 
 ## Eventos
 | Evento | Payload | Descripción |
@@ -21,3 +22,11 @@
 | title |  |  |
 | content |  |  |
 | footer |  |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| isHide | { boolean } Muestra el estado actual del sidebar. |
+| openSidedrawer | { () => void } Abre el sidebar. |
+| closeSidedrawer | { () => void } Cierra el sidedrawer. |
+| toogleSidedrawer | { (state: boolean) => void } Cambia el estado del sidedrawer. |

package/llms/rdstable.md

@@ -8,7 +8,7 @@
 | items | T | Sí | () => [] | Array de datos a mostrar. En modo 'server', son los datos de la página actual. En modo 'client', es el dataset completo. | T |
 | totalItemsLength | number | Sí |  | Número total de registros en la base de datos. Requerido para calcular el número de páginas en la paginación. |  |
 | rowKey | TSTypeOperator | No | id' as keyof T | Nombre de la propiedad única de cada fila (ej. 'id', 'uuid'). Fundamental para la selección y el renderizado eficiente (v-for key). |  |
-| asynchrone | boolean | No | true | Modo asíncrono. Cuando es `true`, el padre controla los datos (paginación/ordenación) y la tabla solo renderiza los elementos recibidos. Cuando es `false`, la tabla aplica paginación local sobre `items`. |  |
+| asynchrone | boolean | No | true | Modo asíncrono. Cuando es `true`, el padre controla los datos (paginación/ordenación) y la tabla solo renderiza los elementos recibidos. **⚠️ IMPORTANTE:** Debes utilizar bindings bidireccionales (`v-model:page`, `v-model:pageSize` y `v-model:sort`) para evitar desincronizaciones del estado visual del componente con tus llamadas API. No uses bindings simples (`:page`, `:sort`). Cuando es `false`, la tabla aplica paginación local sobre `items`. |  |
 | page | number | No | 1 | Página actual (v-model). Inicia en 1. |  |
 | pageSize | number | No | 15 | Cantidad de elementos por página (v-model). |  |
 | sort | SortDescriptor | null | No |  | Estado actual de la ordenación { key, order } (v-model). Pasar `null` para sin orden. | SortDescriptor, null |
@@ -19,6 +19,7 @@
 | hideHeaders | boolean | No |  | Oculta completamente la fila de cabecera (thead). |  |
 | hidePagination | boolean | No |  | Oculta el componente de paginación al pie de la tabla. |  |
 | hideLegend | boolean | No |  | Oculta el texto de "Mostrando X de Y" en la paginación. |  |
+| legendText | string | No |  | Texto personalizado para la leyenda de paginación. Usa {start}, {end} y {total} como placeholders. Ejemplo: 'Showing {start}-{end} of {total} results' Si no se provee, se usa el texto por defecto. |  |
 | hideSelectAll | boolean | No |  | Oculta el checkbox "Seleccionar Todo" de la cabecera (solo en modo 'multiple'). |  |
 | jumpTo | boolean | No |  | Habilita un input para saltar directamente a una página específica. |  |
 | disableFirstLoad | boolean | No |  | Evita emitir el evento de cambio de página al montar el componente. Útil si el padre ya carga los datos inicialmente. |  |
@@ -31,6 +32,7 @@
 | cellClass | TSFunctionType | No |  | Función para aplicar clases CSS condicionales a una celda específica (td). |  |
 | isRowDisabled | TSFunctionType | No |  | Predicado para deshabilitar la selección (checkbox/radio) de una fila específica. |  |
 | resizableColumns | boolean | No |  | Activa el resize de columnas arrastrando el borde derecho del encabezado. |  |
+| resetPageOnSort | boolean | No | false | Si es `true` (por defecto), al cambiar el orden de una columna la página se resetea a 1. Pasa `false` para mantener la página actual al ordenar (útil en modo server-side con lógica propia). |  |
 
 ## Eventos
 | Evento | Payload | Descripción |
@@ -49,3 +51,8 @@
 |---|---|---|
 | mobile |  | item: any, index: any |
 | slotName |  | name: any |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| reset |  |

package/llms/rdstext-field.md

@@ -55,3 +55,9 @@
 | suffix |  |  |
 | right-icon | Icono a mostrar en la parte derecha |  |
 | helper-text | Texto a mostrar en el hueco del helper |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| focus |  |
+| blur |  |

package/llms/rdstoggle.md

@@ -12,6 +12,11 @@
 | valueRight | number | string | No |  | Valor a emitir cuando el toggle está en la posición derecha (si `switchType` es `false`). | number, string |
 | labelLeft | string | No |  | Texto a mostrar en el botón izquierdo. |  |
 | labelRight | string | No |  | Texto a mostrar en el botón derecho. |  |
+| iconLeft | string | No |  | Nombre del icono a mostrar en el botón izquierdo (de la librería de iconos RDS). |  |
+| iconRight | string | No |  | Nombre del icono a mostrar en el botón derecho (de la librería de iconos RDS). |  |
+| ariaLabelLeft | string | No |  | aria-label del botón izquierdo. Obligatorio cuando se usa modo icon-only. |  |
+| ariaLabelRight | string | No |  | aria-label del botón derecho. Obligatorio cuando se usa modo icon-only. |  |
+| ariaLabel | string | No |  | aria-label descriptivo del grupo de opciones (role="radiogroup"). |  |
 | id | string | No |  | ID del toggle para testing |  |
 | variant | "default" | "navy" | "floating" | No |  | Variante visual del toggle según superficie de uso. - `default`: para superficies white/grey - `navy`: para superficies Navy (modo inverso) - `floating`: para superficies Ivory/Sand/Grey (flotante) | "default", "navy", "floating" |
 

package/llms/rdstooltip.md

@@ -35,3 +35,10 @@
 |---|---|---|
 | default |  |  |
 | tooltip-content |  |  |
+
+## Métodos expuestos
+| Método | Descripción |
+|---|---|
+| show |  |
+| hide |  |
+| isOpen |  |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "energy-components",
   "description": "",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "author": "Repsol",
   "auto-changelog": {
     "commitLimit": false,