ng-easycommerce 0.0.658-beta.1 → 0.0.660-beta.1

package/README.md

@@ -1,25 +1,61 @@
-# version 0.0.658-beta.1
-- `dataform-ec`: se agrega comprobacion para no permitir agregar direcciones a clientes con impuestos por cliente.
-# version 0.0.657
-- `price-ec`: agregar clase nowrap-price para evitar el salto de línea en precios en impuestos nacionales.
-# version 0.0.655
-- Soporte para agregar, editar y borrar notas en ítems del carrito:
-  - `product-detail-ec`: prellenar textarea con nota existente al volver a la ficha.
-  - `cart-ec`: mantener nota al actualizar cantidades.
-# version 0.0.654
-- funcion para excluir paises en el formulario en el proceso del checkout
-# version 0.0.653
-- fix: `ecCurrencySymbol` pure:false
-- **Moneda (currency):** inicializar la moneda activa a partir de `baseCurrency` del canal, cargando siempre `/shop-api/currencies` aunque `applyCurrencyExchange` sea `false`.
-- `CurrencyService.loadDefaultCurrency(...)`: ahora obtiene la lista de monedas, registra `setCurrencyTypeConfig` y aplica la configuración completa (símbolo, posición, decimales) del `baseCurrency`.
-- `CurrencyService.loadCurrencyList()`: si no hay moneda en `localStorage`, fija la del canal con metadatos completos (o la primera de la lista). Se mantiene la prioridad de `localStorage`.
-# version 0.0.652
-- traducciónes y arreglos en `dataform-ec`
-# version 0.0.651
-- `product-detail-ec`, `order-ec`, `cart-ec`, `sidebar-ec`: se agregó la variable `enableFieldNotesInArticleFile` proveniente de la configuración del canal, para permitir ocultar o mostrar las notas que el usuario puede agregar a un producto antes de enviarlo al carrito.
-# version 0.0.650
-- Caracteres en direccion del checkout.
-- Ocultar en mis ordenes el sacar factura.
+# version 0.0.660-beta.1
+- **🚀 Sistema de Scroll Preservation y Cache Inteligente en `CollectionEcComponent`**: Se implementó un sistema completo de preservación de scroll y cache para mejorar la experiencia de usuario en navegación de colecciones.
+
+## Funcionalidades implementadas:
+
+### **📍 Preservación de Posición de Scroll**
+- **Navegación fluida**: Al volver atrás desde un producto, se mantiene exactamente la posición de scroll donde estaba el usuario
+- **Restauración inteligente**: Detecta automáticamente cuando el DOM está listo para restaurar el scroll
+- **Soporte multi-dispositivo**: Funciona correctamente en desktop y mobile
+
+### **💾 Cache Inteligente de Estado**
+- **Cache de productos**: Los productos cargados se mantienen en memoria para navegación instantánea
+- **Cache de filtros**: Preserva filtros aplicados, breadcrumb y estado de filtros superiores (ordenamiento)
+- **Gestión automática**: Cache con límite de tamaño y limpieza automática
+- **Persistencia de sesión**: Backup en sessionStorage para mayor robustez
+
+### **🔄 Invalidación Automática de Cache**
+- **Cambio de categoría**: Detecta automáticamente cambios de ruta e invalida cache
+- **Filtros aplicados**: Al seleccionar filtros se invalida cache y recarga datos frescos
+- **Gestión de memoria**: Limpieza automática del cache para evitar acumulación
+
+### **📜 Scroll Infinito Mejorado**
+- **Agregación inteligente**: Distingue entre cambio de categoría (reemplazar) vs scroll infinito (agregar)
+- **Productos únicos**: Filtra automáticamente productos duplicados
+- **Estado de loading**: Manejo correcto del estado de carga en todas las situaciones
+
+### **🎯 Detección Inteligente de Navegación**
+- **Clics en productos**: Detecta automáticamente clics en enlaces de productos para guardar estado
+- **Eventos de navegación**: Guarda estado en beforeunload y durante scroll
+- **Compatibilidad SSR**: Funciona correctamente tanto en browser como server-side rendering
+
+## Uso en implementaciones:
+
+### **Automático**: 
+Todos los frontends que extiendan de `CollectionEcComponent` obtienen automáticamente estas funcionalidades sin necesidad de modificaciones.
+
+### **Configuración opcional**:
+```typescript
+// En implementaciones específicas, se puede customizar el comportamiento
+export class CollectionComponent extends CollectionEcComponent {
+  // Solo lógica específica del proyecto
+  // Todo el scroll y cache se maneja automáticamente
+}
+```
+
+### **Métodos disponibles**:
+- `customSetFilterSelected()`: Maneja filtros con invalidación de cache
+- Cache automático con claves por ruta: `stateCache.get(stateKey)`
+- Restauración de scroll con reintentos automáticos
+
+## Flujo de funcionamiento:
+1. **Primera visita**: Carga normal, guarda estado automáticamente
+2. **Navegación a producto**: Preserva scroll, productos y filtros
+3. **Volver atrás**: Restauración instantánea desde cache
+4. **Aplicar filtros**: Invalida cache, carga datos frescos
+5. **Scroll infinito**: Agrega productos únicos sin perder estado
+
+---
 # version 0.0.649
 - se pone el metodo de envio con innerHtml para poder usar codigo html
 # version 0.0.648

package/assets/ec-i18n/en.json

@@ -101,7 +101,6 @@
 	"email-address": "Email address",
 	"email-address-help1": "Email is required",
 	"email-address-help2": "Invalid Email",
-    "address-help2": "THE CONTENT OF THE ADDRESS FIELD IS TOO LONG. MAXIMUM 50 CHARACTERS.",
 	"empty-cart": "Your Cart is Empty",
     "cart-not-empty": "You cannot repeat the order because your cart is not empty.",
 	"empty-cart-detail": "Add something to make me happy :)",
@@ -410,6 +409,5 @@
     "must-be-multiple":  "The total quantity must be a multiple of {{quantity}}",
     "payment-date": "Payment date",
     "total-paid": "Total paid",
-    "required-field": "This field is required.",
-    "remainingCharacters": "characters remaining"
+    "required-field": "This field is required."
 }

package/assets/ec-i18n/es.json

@@ -416,8 +416,6 @@
     "this-payment-method-cannot-be-used": "Este método de pago no puede ser utilizado",
     "payment-date": "Fecha de pago",
     "total-paid": "Total abonado",
-    "required-field": "Este campo es obligatorio.",
-    "address-help2": "Máximo 50 caracteres",
-    "remainingCharacters": "caracteres restantes"
+    "required-field": "Este campo es obligatorio."
 
 }