@imj_media/ui 1.2.51 → 1.2.53

package/CHANGELOG.md

@@ -5,6 +5,38 @@ Todos los cambios notables de este proyecto serán documentados en este archivo.
 El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/),
 y este proyecto adhiere a [Semantic Versioning](https://semver.org/lang/es/).
 
+## [1.2.53] - 2026-03-06
+
+### Added
+- **Table - Story Dropdown con API real**: Nueva story **DropdownOpcionesApiReal** que carga opciones desde JSONPlaceholder (GET /users y GET /albums) para validar el flujo completo de dropdowns con datos asíncronos.
+
+### Changed
+- **Table - Columna Acciones**: Línea divisoria a la izquierda de la columna de acciones (`ui-border-l ui-border-l-default`). La columna de acciones no puede ser bloqueada: `lockable={false}` y no se muestra el botón de bloquear en el header.
+- **StoryBox - Description**: El contenido de la descripción se envuelve en `<div>` en lugar de `<p>` para permitir listas (`<ul>`) y otros bloques sin warning de `validateDOMNesting`.
+- **Table - useTableColumns**: Menos re-renders innecesarios al comparar propiedades de columnas antes de devolver nuevo estado.
+- **Table - useTableConfig**: Uso de `useMemo` en la computación de columnas para actualizaciones más eficientes cuando cambian las dependencias.
+
+## [1.2.52] - 2026-03-03
+
+### Added
+- **Table - Dropdown con opciones asíncronas**: Sincronización de columnas cuando el padre actualiza las props (p. ej. `columnOptions` cargadas por API). El hook `useTableColumns` actualiza el estado interno al cambiar `initialColumns`, de modo que los dropdowns en modo edición reciben las opciones correctamente tras peticiones async (React Query, etc.).
+- **Table - Columna `columnOptionsLoading`**: Nueva prop opcional en `ColumnConfig`. Cuando es `true`, el Dropdown de la celda muestra un icono de carga (Font Awesome `faCircleNotch` animado) en el `leftSlot` del selector mientras se cargan las opciones.
+- **Table - Stories**: 
+  - **EdicionColumnasDropdown**: Ejemplo de edición con dropdown usando opciones en la columna (`columnOptions`) y opciones desde `render` (CellConfigValue).
+  - **Dropdown con opciones cargadas por API (escenario OBP)**: Reproduce el flujo de Medios fijos (OBP Data Editor) con opciones vacías al montar y carga simulada a los 2,5 s; incluye botón "Cargar opciones ahora" y uso de `columnOptionsLoading`.
+- **Dropdown - Prop `loading`**: Cuando `loading={true}`, el selector muestra el icono de carga en el `leftSlot` (faCircleNotch con animación de giro) en lugar del icono habitual.
+- **Input - Prop `leftSlotClassName`**: Clase CSS opcional aplicada al icono/slot izquierdo (p. ej. `ui-animate-spin` / `animate-spin` para iconos de carga).
+
+### Changed
+- **Table - useTableColumns**: Efecto que sincroniza el estado de columnas con `initialColumns` al cambiar la referencia. Se preservan `width`, `visible`, `locked` y el orden actual cuando el conjunto de columnas no cambia (solo el contenido, p. ej. `columnOptions`). Incluye JSDoc y recomendación de memoizar columnas con `useMemo(..., [columnOptions, ...])`.
+- **Dropdown**: Con `loading=true` se fuerza `leftSlot={faCircleNotch}` y `leftSlotClassName` con clases de giro para el icono de carga.
+- **Input**: La prop `leftSlotClassName` se aplica al componente `Icon`/`Visual` del leftSlot (no solo al contenedor) para que animaciones como el giro se vean correctamente.
+
+### Docs
+- **Table - README**: Nueva subsección "Opciones de dropdown cargadas por API (asíncronas)" con ejemplo de `useMemo` y referencia a la story OBP.
+- **Table - EJEMPLO_USO**: Nota sobre `columnOptions` asíncronas y uso de `useMemo` para las columnas.
+- **Dropdown / Table**: Documentación del estado de carga en el leftSlot del dropdown.
+
 ## [1.2.51] - 2026-03-02
 
 ### Changed