limbo-component 3.5.1 → 3.5.2

package/CHANGELOG.md

@@ -5,175 +5,358 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.5.2] - 2026-02-17
+
+Updated README.md & CHANGELOG.md
+
+## [3.5.1] - 2026-02-17
+
+### Added
+
+- **Filtro `accept`** — Nuevo parámetro para controlar tipos de archivo permitidos por instancia
+  - Sintaxis HTML `<input accept>`: `"image/*"`, `".pdf"`, `"image/*,.pdf"`, etc.
+  - Adaptación automática de UI: oculta tabs de IA/Stock/Portales y Cropper cuando las imágenes están excluidas
+  - Soporte en todos los métodos de integración: `Limbo.create()`, prefabs, AutoInputs (`data-accept`), API
+  - Nueva utilidad `acceptUtils.js` con `resolveAccept()`, `isMimeAllowed()`, `getAcceptLabel()`
+  - Backend: nuevo query param `accept` en `GET /api/assets` para filtrado por MIME type
+  - `FileValidationService`: nuevos métodos `getMimeTypesForExtension()` y `resolveAcceptFilter()`
+  - Filtro de tipo en galería se adapta automáticamente a los tipos permitidos por `accept`
+  - Compatible con `allowedCategories` (legacy) — se convierte internamente a formato `accept`
+
+### Fixed
+
+- **Cache de galería** — `invalidateCache()` ahora limpia todas las entradas de cache + sessionStorage
+  - Corregido: mover asset de carpeta no actualizaba la galería por cache stale
+  - Corregido: crear variantes no invalidaba cache (llamada estaba comentada)
+  - `refetch()` también limpia toda la cache antes de recargar
+
+## [3.5.0] - 2026-02-16
+
+### Added
+
+- **GIF inteligente** — Tratamiento especial para archivos GIF animados
+  - Backend: GIFs se almacenan sin conversión a WebP (preserva animación original)
+  - Nuevo `asset_subtype: "gif"` y `hasMasterWebp: false` para GIFs
+  - Galería: hover-to-animate — thumbnail estático por defecto, animación al pasar el ratón
+  - Visualizador: reproduce animación completa en ImageViewer
+  - Cropper deshabilitado automáticamente para GIFs
+  - Botón de recorte oculto en tarjetas de GIF
+
+## [3.4.0] - 2026-02-15
+
+### Added
+
+- **TextViewer** — Visualizador inline para archivos de texto (TXT, CSV)
+  - Renderizado del contenido con scroll
+  - Botón de descarga
+  - Integrado en ViewerShell
+- **Mejoras en AudioViewer** — Barra de progreso visual mejorada
+  - Timeline clickable para saltar a posición
+  - Indicador de tiempo transcurrido / duración total
+  - Animación de forma de onda
+
+### Fixed
+
+- Botón de descarga corregido en todos los visualizadores (VideoViewer, AudioViewer, PdfViewer)
+- DocumentViewer muestra tamaño de archivo formateado correctamente
+
+## [3.3.0] - 2026-02-13
+
+### Added
+
+- **Thumbnails multi-tipo** — Generación automática de miniaturas para todos los tipos de archivo
+  - Imágenes: thumbnail desde master WebP o GD resize
+  - Vídeos: frame extraído con FFmpeg
+  - Audio: forma de onda generada con FFmpeg
+  - PDFs: primera página renderizada con Ghostscript (fondo blanco)
+  - Documentos Office: conversión con LibreOffice + captura
+  - Texto: preview tipográfico generado con GD
+  - Formato WebP para todas las miniaturas
+  - Procesamiento asíncrono via `GenerateThumbnailMessage`
+
+### Changed
+
+- `ImageProcessingService`: pipeline de procesamiento ampliado para soportar todos los tipos de archivo
+- Thumbnail fallback a icono genérico si la generación falla
+
+## [3.2.0] - 2026-02-11
+
+### Added
+
+- **DocumentViewer** — Visualizador para archivos Office y genéricos
+  - Muestra información del archivo: nombre, tipo, tamaño
+  - Icono específico por tipo (Word, Excel, PowerPoint, texto)
+  - Botón de descarga directa
+- **PdfViewer** — Visualizador de PDFs en iframe
+  - Carga PDF como blob para bypass de X-Frame-Options
+  - Controles nativos del navegador (zoom, páginas, búsqueda)
+  - Botón de descarga
+
+### Changed
+
+- ImageCard detecta tipo de archivo y enruta al visualizador correcto
+- Iconos específicos por tipo en tarjetas de galería (PDF rojo, Word azul, Excel verde, etc.)
+
+## [3.1.0] - 2026-02-09
+
+### Added
+
+- **VideoViewer** — Reproductor de vídeo a pantalla completa
+  - Reproductor HTML5 nativo con controles
+  - Play/pause con barra espaciadora
+  - Descarga directa
+- **AudioViewer** — Reproductor de audio a pantalla completa
+  - Elemento audio HTML5 con controles
+  - Play/pause con barra espaciadora
+- **ViewerShell** — Componente base compartido para todos los visualizadores
+  - Overlay oscuro (z-10000)
+  - Cierre con ESC y clic en backdrop
+  - Bloqueo de scroll del body
+  - Cabecera con título/subtítulo y acciones
+  - Footer con atajos de teclado
+
+### Changed
+
+- ImageViewer refactorizado para usar ViewerShell (mantiene zoom/pan/drag)
+- Barrel export en `components/viewers/index.js`
+
+## [3.0.0] - 2026-02-05
+
+### Added
+
+- **Soporte multi-tipo de archivo** — El componente ya no es solo para imágenes
+  - Categorías: `image`, `video`, `audio`, `document`
+  - Detección automática de tipo por MIME type
+  - Subida, galería y gestión de cualquier tipo de archivo
+  - API backend ampliada con campos `assetType`, `assetSubtype`, `originalMime`
+- **Sistema de carpetas completo**
+  - `FolderSelector` — Dropdown unificado para selección de carpetas
+  - Filtro por carpeta en galería
+  - Badge de carpeta en tarjetas de la galería
+  - Mover archivos entre carpetas desde la galería
+  - Crear carpetas nuevas al subir o mover
+  - Configuración: `include`/`exclude` para whitelist/blacklist de carpetas
+  - API: `GET /api/folders`, `POST /api/folders`, `PATCH /api/assets/{id}` (move)
+- **AssetPreview** — Componente de preview unificado para todos los tipos de archivo
+  - Preview visual para imágenes/vídeos
+  - Info card para documentos/audio
+  - Edición de nombre de archivo
+  - Selector de carpeta en preview de subida
+  - Botones: descartar, descargar, seleccionar
+- **Filtro por tipo de archivo** en galería
+  - Dropdown "Tipo" con opciones: Todos, Imágenes, Vídeos, Documentos, Audio
+  - Configurable via `gallery.filters.showTypeFilter`
+- **Acciones por tipo** en tarjetas de galería
+  - Recortar solo disponible para imágenes
+  - Descarga disponible para todos los tipos
+  - Variantes solo para imágenes
+
+### Changed
+
+- `ImageCard` renombrado internamente pero mantiene nombre por compatibilidad — ahora soporta todos los tipos
+- `TabUpload` acepta cualquier tipo de archivo (no solo imágenes)
+- API `GET /api/assets` soporta filtro `asset_type`
+- `FileValidationService` ampliado con validación por categoría y MIME types multi-tipo
+
+### Breaking Changes
+
+- El objeto de asset ahora incluye `assetType` y `assetSubtype` (antes se asumía siempre imagen)
+- Las URLs de thumbnail pueden ser `null` para tipos sin thumbnail generado
+
+## [2.1.0] - 2026-01-15
+
+### Added
+
+- **Acciones de galería mejoradas**
+  - Botón de copiar URL al portapapeles
+  - Modal de variantes con lista de recortes existentes y descarga individual
+  - Contador de variantes visible en tarjeta
+
+### Fixed
+
+- Firma de variantes corregida — usa UUID en vez de filename
+- Coordenadas de recorte normalizadas (0-1) aplicadas correctamente al master
+- Transparencia GD cuando el selector excede los límites de la imagen
+
+## [2.0.0] - 2025-11-24
+
+### Added
+
+- **Arquitectura de subida diferida** — Las imágenes permanecen en memoria hasta confirmación en cropper
+  - No se suben al backend hasta que el usuario guarda los recortes o confirma
+  - Cancelar descarta sin tocar el servidor
+  - Detección: `image.file` indica imagen nueva sin subir
+- **ImagePreview unificado** — Componente de preview consistente en todas las tabs
+  - Edición de nombre de archivo con manejo de extensiones
+  - Lightbox para vista ampliada (clic para zoom, ESC para cerrar)
+  - Botones contextuales: Descartar, Descargar, Seleccionar, Reintentar (solo IA)
+  - Integrado en TabUpload, TabAI, TabStock, TabPortals
+- **Breadcrumbs inteligentes** — Navegación jerárquica de 3 niveles
+  - Nivel 1: Tab principal (Galería, Subir, Recortar)
+  - Nivel 2: Sub-tab (Subir archivo, Generar con IA, Stock, Portales)
+  - Nivel 3: Servicio/Modelo (DALL-E 3, Shutterstock, etc.)
+  - Eliminación automática de duplicados
+  - Clic para navegar hacia atrás
+- **Aislamiento CSS** — Prefijo `lb:` en todas las clases Tailwind para evitar colisiones
+- **Lógica de visibilidad de botones**
+  - "Eliminar" solo para imágenes existentes (con `image.id`)
+  - "Conservar original" solo para imágenes nuevas (con `image.file`)
+- **Precisión de dimensiones** — Recortes usan `naturalWidth`/`naturalHeight` reales
+- **Métodos prefab** en LimboCore
+  - `openGallery()`, `openUploader()`, `openCropper()` — modales
+  - `createInlineGallery()`, `createInlineUploader()`, `createStandaloneCropper()`, `createFullSelector()` — embebidos
+- **Arquitectura de managers** — Separación de responsabilidades
+  - ConfigManager, InstanceManager, EventManager, ModalManager, AutoInputManager
+  - Cada manager con responsabilidad única (SOLID)
+
+### Changed
+
+- Flujo de subida completamente rediseñado (deferred upload)
+- Token JWT expiración aumentada a 60 minutos (antes 10 min)
+- Auto-refresh de token mejorado
+
+### Breaking Changes
+
+- Las imágenes ya no se suben inmediatamente al seleccionarlas
+- ImagePreview reemplaza los previews específicos por tab
+- Breadcrumbs reemplazan la navegación de 2 niveles
+- Expiración de JWT cambiada de 600s a 3600s
+
+---
+
 ## [1.6.0] - LTS - 2025-10-21
 
 ### Fixed
-- 🔧 Fixes in stock services and form generation
-- 🪨 Stable version LTS!
+
+- Correcciones en servicios de stock y generación de formularios
+- Versión estable LTS
 
 ## [1.5.1] - 2025-10-20
 
 ### Fixed
-- ⚖️ New license **[Propietary]**
+
+- Nueva licencia **Proprietary**
 
 ## [1.5.0] - 2025-10-20
 
 ### Fixed
-- 🛡️ fix external images proxy to retrieve urls
+
+- Corrección de proxy de imágenes externas para recuperar URLs
 
 ## [1.4.0] - 2025-10-19
 
 ### Added
-- 🆕 New variants menu for images (gestión avanzada de variantes desde la galería)
+
+- Nuevo menú de variantes para imágenes (gestión avanzada de variantes desde la galería)
 
 ## [1.3.1] - 2025-10-18
 
 ### Changed
-- ⏳ Token life time up to 3600s (mejora de experiencia de usuario y menos expiraciones)
+
+- Token lifetime aumentado a 3600s
 
 ## [1.3.0] - 2025-10-17
 
 ### Changed
-- 🛠️ Various fixes and pagination (mejoras en paginación y correcciones menores)
+
+- Varias correcciones y mejoras de paginación
 
 ## [1.2.0] - 2025-10-16
 
 ### Fixed
-- 🔧 Fix services calls (mejoras en llamadas a servicios internos)
 
-## [1.2.0] - 2025-10-15
-
-### Fixed
-- 🔧 Fix new cors for localdev and calls to API (mejoras CORS para desarrollo local y llamadas a la API)
+- Correcciones en llamadas a servicios internos
 
 ## [1.1.0] - 2025-10-14
 
 ### Added
 
-- 🌐 Integración completa con portales externos (proxy seguro, filtrado de duplicados)
-- 💾 Persistencia de estado en pestaña "Portales" (sessionStorage)
-- 🧩 Compatibilidad total con modos "solo selección" y "cropper-only"
-- 🪄 Mejoras en AutoInputs: configuración granular por dataset, botón de selección personalizable
-- 🛡️ Mejoras de seguridad y CORS en descargas externas
-- 🏷️ Ejemplos de integración avanzada en README
+- Integración completa con portales externos (proxy seguro, filtrado de duplicados)
+- Persistencia de estado en pestaña "Portales" (sessionStorage)
+- Compatibilidad total con modos "solo selección" y "cropper-only"
+- Mejoras en AutoInputs: configuración granular por dataset, botón personalizable
+- Mejoras de seguridad y CORS en descargas externas
 
 ### Changed
 
-- 🖼️ UX mejorada en UploadForm y Tabs (más compacto, accesible, placeholders inteligentes)
-- ♿ Accesibilidad mejorada en navegación por teclado y ARIA
-- 🔄 Refactor de lógica de selección para soportar todos los modos y callbacks
+- UX mejorada en UploadForm y Tabs (más compacto, accesible, placeholders inteligentes)
+- Accesibilidad mejorada en navegación por teclado y ARIA
+- Refactor de lógica de selección para soportar todos los modos y callbacks
 
 ### Fixed
 
-- 🐞 Corrección de duplicados en resultados de portales externos
-- 🐞 Corrección de pérdida de estado al cambiar de pestaña
-
----
+- Corrección de duplicados en resultados de portales externos
+- Corrección de pérdida de estado al cambiar de pestaña
 
 ## [1.0.0] - 2025-10-13
 
 ### Added
 
-- 🎉 **Primera versión estable** lista para producción
-- ✨ Arquitectura SOLID con sistema de instancias múltiples
-- 🔐 Autenticación JWT v2 con auto-renovación
-- 📦 Build multi-formato: ESM, CJS, UMD
-- 🖼️ Sistema completo de gestión de imágenes:
+- **Primera versión estable** lista para producción
+- Arquitectura SOLID con sistema de instancias múltiples
+- Autenticación JWT v2 con auto-renovación
+- Build multi-formato: ESM, CJS, UMD
+- Sistema completo de gestión de imágenes:
   - Galería de imágenes del portal
   - Subida de imágenes con preview
   - Recortador avanzado (Cropper.js 2.0)
   - Integración con IA, Stock y servicios externos
-- 🎭 Múltiples modos UI:
-  - `embed`: Componente embebido en contenedor
-  - `modal`: Apertura en overlay modal
-  - `button`: Botón trigger que abre modal
-- 🎯 Modos funcionales configurables:
-  - `full`: Todas las funcionalidades
-  - `gallery-only`: Solo galería
-  - `upload-only`: Solo subida
-  - `crop-only`: Solo recortador
-  - `ia-only`: Solo IA
-- 🤖 Sistema AutoInputs:
-  - Detección automática de inputs con `data-limbo-input-file`
-  - Configuración vía datasets
-  - Múltiples formatos de retorno (url, base64, assetId, object, json)
-- 🎨 Sistema de presets:
-  - Aspect ratios configurables
-  - Tamaños predefinidos
-  - Presets obligatorios
-  - Bloqueo de recorte manual
-- 🌍 Sistema i18n completo (ES/EN)
-- 🎨 Sistema de theming extensible
-- 📡 Sistema de eventos robusto:
-  - Eventos DOM personalizados
-  - Callbacks programáticos
-  - Event Manager centralizado
-- ♿ Accesibilidad:
-  - Focus trap en modales
-  - ARIA labels
-  - Navegación por teclado
-  - Soporte ESC para cerrar modales
-- 📱 Responsive y mobile-friendly
-- 🔍 Container queries para adaptación automática
-- 🎯 APIs completas:
-  - `Limbo.configure()` - Configuración global
-  - `Limbo.create()` - Crear instancias
-  - `Limbo.mount()` / `unmount()` - Gestión de montaje
-  - `Limbo.open()` / `close()` - Control de modales
-  - `Limbo.configureAutoInputs()` - Configurar inputs automáticos
+- Múltiples modos UI: `embed`, `modal`, `button`
+- Modos funcionales: `full`, `gallery-only`, `upload-only`, `crop-only`, `ia-only`
+- Sistema AutoInputs con detección automática y configuración vía datasets
+- Sistema de presets (aspect ratios, tamaños, obligatorios)
+- Sistema i18n completo (ES/EN)
+- Sistema de theming extensible
+- Sistema de eventos (DOM + callbacks + EventManager)
+- Accesibilidad: focus trap, ARIA, teclado, ESC
+- Responsive y mobile-friendly con container queries
+- APIs: `configure()`, `create()`, `mount()`/`unmount()`, `open()`/`close()`, `configureAutoInputs()`
 
 ### Changed
 
-- 🔄 Migración completa de API v1 a v2
-- 🔄 Refactorización SOLID de toda la arquitectura
-- ⚡ Optimización de bundle sizes
-- 🔒 Mejoras de seguridad con JWT
+- Migración completa de API v1 a v2
+- Refactorización SOLID de toda la arquitectura
 
 ### Security
 
-- 🔐 Implementación de autenticación JWT segura
-- 🔒 Eliminación de API keys en cliente
-- 🛡️ Validación de CORS por portal
+- Autenticación JWT segura
+- Eliminación de API keys en cliente
+- Validación de CORS por portal
 
 ## [0.5.0] - 2025-10-10
 
 ### Added
 
-- 🚧 Versión beta con migración API v2
-- 📦 Sistema de build básico
-- 🎨 Integración inicial de Tailwind 4
-
-### Changed
-
-- 🔄 Adaptadores de respuesta v2
-- 🔄 Migración de hooks a APIs v2
+- Versión beta con migración API v2
+- Sistema de build básico
+- Integración inicial de Tailwind 4
 
 ## [0.4.0] - 2025-10-05
 
 ### Added
 
-- ⚡ Sistema de managers (Config, Event, Modal, AutoInputs)
-- 🎯 Soporte para múltiples instancias
+- Sistema de managers (Config, Event, Modal, AutoInputs)
+- Soporte para múltiples instancias
 
 ## [0.3.0] - 2025-09-28
 
 ### Added
 
-- 🖼️ Componente Gallery básico
-- 📤 Sistema de subida de imágenes
-- ✂️ Integración de Cropper.js
+- Componente Gallery básico
+- Sistema de subida de imágenes
+- Integración de Cropper.js
 
 ## [0.2.0] - 2025-09-20
 
 ### Added
 
-- ⚛️ Configuración inicial React 19
-- 📦 Setup Vite 7
-- 🎨 Configuración Tailwind 4
+- Configuración inicial React 19
+- Setup Vite 7
+- Configuración Tailwind 4
 
 ## [0.1.0] - 2025-09-15
 
 ### Added
 
-- 🎉 Proyecto inicial
-- 📋 Estructura base del componente
+- Proyecto inicial
+- Estructura base del componente