ng-easycommerce 0.0.681 → 0.0.682

package/lib/ec-component/cart-ec/cart-ec.component.d.ts

@@ -39,11 +39,150 @@ export declare class CartEcComponent extends ComponentHelper implements OnInit {
     showTaxLegend: boolean;
     cartLoading: boolean;
     enableFieldNotesInArticleFile: boolean;
+    summaryPromotionAmount$: any;
+    hasAppliedCoupon$: any;
+    activeUnitPromotionItemId: number | null;
+    activeUnitPromotionSummaryStyles: {
+        [key: string]: string;
+    };
+    supportsUnitPromotionHover: boolean;
     constructor(cartService: CartService, authService: AuthService, consts: Constants, productsService: ProductsService, router: Router, modalService: BsModalService, toastrService: ToastService, addressingService: AddressingService, channelConfigService: ChannelConfigService);
     ngOnChanges(): void;
     updateLoggedIn(): void;
     ngOnInit(): void;
+    /**
+     * Convierte un monto crudo al formato decimal esperado por la UI.
+     *
+     * @param amount Monto en centavos o entero crudo.
+     * @returns Monto decimal.
+     */
     toDecimal: (amount: any) => any;
+    /** @param item Ítem del carrito. @returns Porcentaje de descuento legacy para el badge `% OFF`. */
+    getItemDiscount: (item: any) => number;
+    /**
+     * Devuelve el porcentaje efectivo total del ítem, considerando promociones unitarias.
+     *
+     * @param item Ítem del carrito.
+     * @returns Porcentaje entero calculado contra el precio de referencia del ítem.
+     *
+     * @remarks
+     * Si existe precio tachado, compara `finalPrice` contra `strikePrice`.
+     * Si no existe, usa `basePrice` como referencia.
+     * Esto permite mostrar un badge coherente cuando el precio visible ya incluye
+     * descuentos/promociones unitarias adicionales.
+     *
+     * @example
+     * ```ts
+     * // strikePrice 240000, finalPrice 45000 => 81
+     * this.getItemEffectiveDiscount(item);
+     * ```
+     */
+    getItemEffectiveDiscount: (item: any) => number;
+    /** @param item Ítem del carrito. @returns Subtotal actual del renglón según backend. */
+    getDisplayedItemTotal: (item: any) => number;
+    /** @param item Ítem del carrito. @returns `true` si el backend informó promociones unitarias. */
+    hasUnitPromotions: (item: any) => boolean;
+    /** @param item Ítem del carrito. @returns `true` si el resumen activo pertenece a ese ítem. */
+    isUnitPromotionSummaryOpen: (item: any) => boolean;
+    /**
+     * Abre el resumen del ítem al entrar con el mouse en desktop.
+     *
+     * @param item Ítem del carrito.
+     * @param anchor Elemento usado como ancla visual.
+     * @returns `void`
+     */
+    handleUnitPromotionMouseEnter: (item: any, anchor: HTMLElement) => void;
+    /**
+     * Cierra el resumen al salir con el mouse en desktop.
+     *
+     * @param item Ítem asociado al resumen.
+     * @returns `void`
+     */
+    handleUnitPromotionMouseLeave: (item: any) => void;
+    /**
+     * Abre el resumen de promociones unitarias para un ítem puntual.
+     *
+     * @param item Ítem del carrito.
+     * @param anchor Elemento de referencia para posicionamiento.
+     * @returns `void`
+     */
+    openUnitPromotionSummary: (item: any, anchor?: HTMLElement) => void;
+    /**
+     * Cierra el resumen activo.
+     *
+     * @param item Si se envía, solo cierra cuando coincide con el ítem activo.
+     * @returns `void`
+     */
+    closeUnitPromotionSummary: (item?: any) => void;
+    /**
+     * Alterna manualmente la apertura del resumen para un ítem.
+     *
+     * @param item Ítem del carrito.
+     * @param anchor Elemento de referencia.
+     * @param event Evento del puntero.
+     * @returns `void`
+     */
+    toggleUnitPromotionSummary: (item: any, anchor: HTMLElement, event: Event) => void;
+    /**
+     * Maneja el click/tap sobre el precio en dispositivos sin hover.
+     *
+     * @param item Ítem del carrito.
+     * @param anchor Elemento usado como trigger.
+     * @param event Evento de click/tap.
+     * @returns `void`
+     */
+    handleUnitPromotionPriceClick: (item: any, anchor: HTMLElement, event: Event) => void;
+    /**
+     * Evita que eventos dentro del resumen se propaguen al documento.
+     *
+     * @param event Evento del puntero.
+     * @returns `void`
+     */
+    stopUnitPromotionSummaryEvent: (event: Event) => void;
+    /** @param item Ítem del carrito. @returns Precio unitario base (`saleprice` o `price`). */
+    getOriginalUnitPrice: (item: any) => number;
+    /** @param item Ítem del carrito. @returns Precio tachado legacy o `0`. */
+    getStrikeThroughUnitPrice: (item: any) => number;
+    /** @param item Ítem del carrito. @returns Suma de promociones unitarias aplicadas. */
+    getUnitPromotionTotal: (item: any) => number;
+    /** @param item Ítem del carrito. @returns Precio final unitario luego de promociones. */
+    getFinalUnitPrice: (item: any) => number;
+    /** @param item Ítem del carrito. @returns Precio principal a mostrar junto al trigger. */
+    getDisplayedUnitPrice: (item: any) => number;
+    /** @param item Ítem del carrito. @returns `true` si debe mostrarse el precio base junto al final. */
+    shouldShowOriginalUnitPrice: (item: any) => boolean;
+    /** @param item Ítem del carrito. @returns `true` si además del base price existe tachado legacy. */
+    shouldShowLegacyPriceOrigin: (item: any) => boolean;
+    /** @param item Ítem del carrito. @returns Etiqueta final del resumen. */
+    getUnitPromotionFinalPriceLabel: (item: any) => string;
+    /**
+     * Busca dentro de una lista el ítem que tiene actualmente el resumen abierto.
+     *
+     * @param items Lista de ítems del carrito.
+     * @returns Ítem activo o `null`.
+     */
+    getActiveUnitPromotionItem: (items: any) => any;
+    /** @param item Ítem del carrito. @returns Promociones unitarias crudas del backend. */
+    getUnitPromotions: (item: any) => any[];
+    /** Cierra el resumen al hacer click fuera en desktop. */
+    handleDocumentClick(): void;
+    /** Recalcula el modo de interacción y cierra el resumen al cambiar el viewport. */
+    handleWindowResize(): void;
+    /** Cierra el resumen en mobile al hacer scroll para evitar desalineación visual. */
+    handleWindowScroll(): void;
+    /**
+     * Detecta si el dispositivo soporta `hover` real y debe comportarse como desktop.
+     *
+     * @returns `void`
+     */
+    private updateUnitPromotionViewportMode;
+    /**
+     * Calcula estilos inline para mantener el resumen mobile dentro del viewport.
+     *
+     * @param anchor Elemento usado como ancla visual.
+     * @returns `void`
+     */
+    private updateUnitPromotionSummaryStyles;
     protected actualizarCantidad(item: any, cantidad: number | string, stock: number, id?: string): void;
     cartItemPlus: (item: any) => void;
     cartItemLess: (item: any) => void;

package/lib/ec-component/checkout-ec/dataform-ec/dataform-ec.component.d.ts

@@ -12,6 +12,7 @@ import { Constants } from '../../../core.consts';
 import { ParametersService } from '../../../services/parameters.service';
 import { ChannelConfigService } from '../../../services/channel-config.service';
 import { CheckoutService } from '../../../services/checkout/checkout.service';
+import { OrderUtilityService } from '../../../utils/order-util.service';
 export declare class DataFormEcComponent extends ComponentHelper implements OnInit {
     authService: AuthService;
     fb: FormBuilder;
@@ -19,6 +20,7 @@ export declare class DataFormEcComponent extends ComponentHelper implements OnIn
     addressingService: AddressingService;
     cartService: CartService;
     checkoutService: CheckoutService;
+    private orderUtils;
     private modalService;
     paramsService: ParametersService;
     consts: Constants;
@@ -74,7 +76,7 @@ export declare class DataFormEcComponent extends ComponentHelper implements OnIn
     private suppressDirty;
     private addressSyncedForCompletion;
     private lastSummaryTotalsSnapshot;
-    constructor(authService: AuthService, fb: FormBuilder, toast: ToastService, addressingService: AddressingService, cartService: CartService, checkoutService: CheckoutService, modalService: BsModalService, paramsService: ParametersService, consts: Constants, channelConfig: ChannelConfigService);
+    constructor(authService: AuthService, fb: FormBuilder, toast: ToastService, addressingService: AddressingService, cartService: CartService, checkoutService: CheckoutService, orderUtils: OrderUtilityService, modalService: BsModalService, paramsService: ParametersService, consts: Constants, channelConfig: ChannelConfigService);
     ngOnInit(): void;
     /**
      * @description filtra los paises de acuerdo al a los codigos retornados en la funcion getCountries.

package/lib/ec-component/index.d.ts

@@ -34,6 +34,7 @@ export * from "./widgets-ec/loading-full-ec/loading-full-ec.component";
 export * from "./widgets-ec/loading-inline-ec/loading-inline-ec.component";
 export * from "./widgets-ec/mercadopago-ec/mpcredit-ec/mpcredit-ec.component";
 export * from "./widgets-ec/price-ec/price-ec.component";
+export * from "./widgets-ec/unit-promotion-price-ec/unit-promotion-price-ec.component";
 export * from "./widgets-ec/redsys-catch-ec/redsys-catch-ec.component";
 export * from "./widgets-ec/redsys-pro-ec/redsys-pro-ec.component";
 export * from "./widgets-ec/redsys-redirect-ec/redsys-redirect-ec.component";

package/lib/ec-component/sidebar-ec/sidebar-ec.component.d.ts

@@ -22,10 +22,62 @@ export declare class SidebarEcComponent {
     showTaxLegend: boolean;
     cartLoading: boolean;
     enableFieldNotesInArticleFile: boolean;
+    summaryPromotionAmount$: any;
+    hasAppliedCoupon$: any;
     constructor(cartService: CartService, consts: Constants, authService: AuthService, router: Router, toastrService: ToastService, channelConfigService: ChannelConfigService);
     ngOnInit(): void;
     protected actualizarCantidad(item: any, cantidad: number | string, stock: number, id?: string): void;
     redirectDetailProduct(product: any): void;
     getVariants: (product: any) => any[];
+    /**
+     * Construye el badge `% OFF` legacy a partir de `price` y `saleprice`.
+     *
+     * @param saleprice Precio de venta actual.
+     * @param price Precio original tachado.
+     * @returns Texto del badge o string vacío cuando no corresponde mostrar descuento.
+     */
     createDiscountMessage(saleprice: number, price: number): string;
+    /**
+     * Devuelve el porcentaje de descuento a mostrar para un ítem del sidebar.
+     *
+     * @param item Ítem del carrito.
+     * @returns Porcentaje entero de descuento.
+     */
+    getItemDiscount: (item: any) => number;
+    /**
+     * Devuelve el porcentaje efectivo total del ítem, considerando promociones unitarias.
+     *
+     * @param item Ítem del carrito.
+     * @returns Porcentaje entero calculado contra el precio de referencia del ítem.
+     *
+     * @remarks
+     * Si el frontend muestra el precio final unitario junto con un precio tachado legacy,
+     * este helper evita inconsistencias visuales en el badge `% OFF`.
+     *
+     * @example
+     * ```ts
+     * // strikePrice 240000, finalPrice 45000 => 81
+     * this.getItemEffectiveDiscount(item);
+     * ```
+     */
+    getItemEffectiveDiscount: (item: any) => number;
+    /**
+     * Devuelve el precio tachado del renglón completo, escalado por cantidad.
+     *
+     * @param item Ítem del carrito.
+     * @returns Total tachado del renglón o `0` cuando no corresponde mostrarlo.
+     *
+     * @remarks
+     * Este helper es útil en sidebars que renderizan precios por renglón, no unitarios.
+     * Ejemplo: si el precio tachado unitario es `15000` y la cantidad es `2`,
+     * el valor mostrado debe ser `30000`.
+     */
+    getDisplayedItemStrikeThroughTotal: (item: any) => number;
+    /**
+     * Devuelve el subtotal actual del renglón según backend.
+     *
+     * @param item Ítem del carrito.
+     * @returns Monto total del renglón.
+     */
+    getDisplayedItemTotal: (item: any) => number;
 }

package/lib/ec-component/widgets-ec/unit-promotion-price-ec/unit-promotion-price-ec.component.d.ts

@@ -0,0 +1,117 @@
+import { OnInit } from '@angular/core';
+import { CartService } from '../../../services/cart.service';
+export declare class UnitPromotionPriceEcComponent implements OnInit {
+    cartService: CartService;
+    /** Ítem del carrito normalizado que se va a renderizar. */
+    item: any;
+    /** Indica si el componente se está usando en un layout mobile. */
+    mobile: boolean;
+    summaryOpen: boolean;
+    summaryStyles: {
+        [key: string]: string;
+    };
+    supportsHover: boolean;
+    constructor(cartService: CartService);
+    /**
+     * Inicializa el modo de interacción según el dispositivo actual.
+     *
+     * @returns `void`
+     */
+    ngOnInit(): void;
+    /** @returns `true` cuando el ítem tiene promociones unitarias informadas por backend. */
+    hasUnitPromotions: () => boolean;
+    /** @returns `true` cuando el popover/resumen está abierto. */
+    isSummaryOpen: () => boolean;
+    /** @returns El precio base histórico del ítem (`saleprice` si existe, si no `price`). */
+    getOriginalUnitPrice: () => number;
+    /** @returns La suma de los descuentos/promociones unitarios aplicados al ítem. */
+    getUnitPromotionTotal: () => number;
+    /** @returns El precio unitario final luego de aplicar promociones unitarias. */
+    getFinalUnitPrice: () => number;
+    /** @returns El precio principal que se renderiza junto al icono de ayuda. */
+    getDisplayedUnitPrice: () => number;
+    /** @returns Etiqueta del bloque final dentro del popover. */
+    getUnitPromotionFinalPriceLabel: () => string;
+    /** @returns Lista cruda de promociones unitarias a mostrar en el detalle. */
+    getUnitPromotions: () => any[];
+    /**
+     * Abre el popover al pasar el mouse en dispositivos con hover real.
+     *
+     * @param anchor Elemento usado como referencia visual del popover.
+     * @returns `void`
+     */
+    handleMouseEnter: (anchor: HTMLElement) => void;
+    /**
+     * Cierra el popover al salir con el mouse en desktop.
+     *
+     * @returns `void`
+     */
+    handleMouseLeave: () => void;
+    /**
+     * Alterna la apertura del popover con click/tap en dispositivos sin hover.
+     *
+     * @param anchor Elemento usado como ancla para posicionar el detalle.
+     * @param event Evento del click/tap sobre el bloque de precio.
+     * @returns `void`
+     */
+    handlePriceClick: (anchor: HTMLElement, event: Event) => void;
+    /**
+     * Alterna manualmente el estado del resumen.
+     *
+     * @param anchor Elemento usado como ancla visual del popover.
+     * @param event Evento que dispara la interacción.
+     * @returns `void`
+     */
+    toggleSummary: (anchor: HTMLElement, event: Event) => void;
+    /**
+     * Cierra el popover y limpia los estilos calculados para mobile.
+     *
+     * @returns `void`
+     */
+    closeSummary: () => void;
+    /**
+     * Evita que un click dentro del popover se propague y lo cierre.
+     *
+     * @param event Evento del puntero.
+     * @returns `void`
+     */
+    stopSummaryEvent: (event: Event) => void;
+    /**
+     * Cierra el resumen cuando se hace click fuera del componente en desktop.
+     *
+     * @returns `void`
+     */
+    handleDocumentClick(): void;
+    /**
+     * Recalcula el modo de interacción al cambiar el viewport.
+     *
+     * @returns `void`
+     */
+    handleWindowResize(): void;
+    /**
+     * Cierra el resumen en mobile al hacer scroll para evitar que quede desacoplado del trigger.
+     *
+     * @returns `void`
+     */
+    handleWindowScroll(): void;
+    /**
+     * Abre el resumen y recalcula su posición.
+     *
+     * @param anchor Elemento de referencia para el posicionamiento.
+     * @returns `void`
+     */
+    private openSummary;
+    /**
+     * Detecta si la interacción debe comportarse como desktop (`hover`) o mobile (`click`).
+     *
+     * @returns `void`
+     */
+    private updateViewportMode;
+    /**
+     * Calcula estilos inline para que el resumen mobile quede dentro del viewport.
+     *
+     * @param anchor Elemento tocado por el usuario.
+     * @returns `void`
+     */
+    private updateSummaryStyles;
+}

package/lib/interfaces/cart-item.d.ts

@@ -1,8 +1,62 @@
 import { Product } from './product';
+/**
+ * Promoción aplicada a una unidad del producto.
+ *
+ * @remarks
+ * El backend nuevo informa estas promociones en `items[].unitPromotions`.
+ * Sus montos son negativos cuando representan descuentos.
+ */
+export interface CartItemPromotion {
+    /** Monto firmado aplicado sobre una unidad del producto. */
+    amount: number;
+    /** Tipo técnico de promoción informado por backend. */
+    type: string;
+    /** Nombre legible de la promoción o descuento. */
+    name: string;
+}
+/**
+ * Precios del ítem normalizados por el core para evitar duplicar lógica en cada frontend.
+ *
+ * @remarks
+ * Esta estructura separa tres conceptos distintos:
+ * - `basePrice`: precio unitario histórico de la tabla (`saleprice` si existe, si no `price`)
+ * - `strikePrice`: precio tachado de la lógica legacy `price/saleprice`
+ * - `finalPrice`: precio unitario neto luego de aplicar `unitPromotions`
+ */
+export interface CartItemPricing {
+    /** Precio unitario base que ya usaba el frontend antes de soportar promociones unitarias. */
+    basePrice: number;
+    /** Precio unitario tachado, o `null` cuando no corresponde mostrarlo. */
+    strikePrice: number | null;
+    /** Precio unitario final luego de aplicar promociones por unidad. */
+    finalPrice: number;
+    /** Suma de todos los descuentos/promociones unitarios. */
+    unitPromotionTotal: number;
+    /** Indica si el ítem tiene precio tachado legacy. */
+    hasStrikePrice: boolean;
+    /** Indica si el ítem recibió promociones unitarias desde backend. */
+    hasUnitPromotions: boolean;
+    /** Porcentaje de descuento legacy a mostrar en badge (`price` vs `saleprice`). */
+    discountPercent: number;
+    /** Porcentaje efectivo usando como referencia el precio final unitario luego de promociones. */
+    effectiveDiscountPercent: number;
+}
+/**
+ * Ítem del carrito normalizado por el core.
+ *
+ * @remarks
+ * Este contrato es el que consumen los componentes de carrito, sidebar y checkout.
+ * Se mantiene compatible con backends viejos: cuando no existe `unitPromotions`,
+ * el core completa `pricing` sin alterar la semántica legacy de `product.price`.
+ */
 export interface CartItem {
     productCode: any;
     product?: Product;
     quantity: number;
     variant_id: number;
     total: number;
+    /** Promociones unitarias crudas devueltas por backend. */
+    unitPromotions?: CartItemPromotion[];
+    /** Precios derivados listos para usar en la UI. */
+    pricing?: CartItemPricing;
 }

package/lib/services/cart.service.d.ts

@@ -1,5 +1,5 @@
 import { Product } from '../interfaces/product';
-import { CartItem } from '../interfaces/cart-item';
+import { CartItem, CartItemPricing } from '../interfaces/cart-item';
 import { Observable } from 'rxjs';
 import { ConnectionService } from '../api/connection.service';
 import { Constants } from '../core.consts';
@@ -75,9 +75,30 @@ export declare class CartService {
      *  CART CRUD SERVER'S SYNCRONIZED
      */
     private initializeCart;
+    /**
+     * Reasigna `product.price` al precio base legacy que espera el template histórico del carrito.
+     *
+     * @param items Ítems normalizados del carrito.
+     * @returns Los mismos ítems con `product.price` alineado al precio base mostrado en la tabla.
+     *
+     * @remarks
+     * Este método no modifica `pricing.finalPrice`. Solo preserva compatibilidad con templates
+     * viejos que todavía leen `item.product.price` directamente.
+     */
     private switchPriceInCartItem;
     private stepCart;
     private updateCartItems;
+    /**
+     * Sincroniza `cartItemsSubject` con la última respuesta del backend.
+     *
+     * @param cart Respuesta de carrito recibida desde cualquier endpoint que devuelva `items`.
+     * @returns `void`
+     *
+     * @remarks
+     * Se reutiliza después de actualizar cantidades, aplicar cupón o remover productos para evitar
+     * que la tabla quede con subtotales o promociones desactualizadas.
+     */
+    private syncCartItemsFromResponse;
     private updateCartItemQuantity;
     private appendToCart;
     private removeCartItem;
@@ -120,8 +141,47 @@ export declare class CartService {
     getCountCartItems: () => Observable<number>;
     getTaxesAmount: () => Observable<number>;
     getSubTotalAmount: () => Observable<number>;
+    /**
+     * Devuelve el descuento que debe mostrarse en el resumen de compra.
+     *
+     * @returns Observable con el monto de promociones de orden.
+     *
+     * @example
+     * ```ts
+     * this.summaryPromotionAmount$ = this.cartService.getSummaryPromotionAmount();
+     * ```
+     *
+     * @remarks
+     * Si el backend nuevo informa `totals.promotionBreakdown.orderPromotions`, se usa ese valor.
+     * Si todavía no existe, el método hace fallback a `totals.promotion` para mantener compatibilidad.
+     */
+    getSummaryPromotionAmount: () => Observable<number>;
+    /**
+     * Indica si existe un cupón aplicado en el carrito actual.
+     *
+     * @returns Observable booleano para controlar la visibilidad de `Quitar cupón`.
+     *
+     * @remarks
+     * No debe atarse a `getSummaryPromotionAmount()`, porque un cupón puede afectar
+     * solo promociones unitarias y dejar el descuento de orden en `0`.
+     */
+    hasAppliedCoupon: () => Observable<boolean>;
     toDecimal: (total: any) => any;
     getDiscount(): Observable<number>;
+    /**
+     * Obtiene el precio normalizado de un ítem.
+     *
+     * @param item Ítem de carrito normalizado.
+     * @returns Objeto `CartItemPricing` listo para renderizar precio base, tachado y final.
+     *
+     * @example
+     * ```ts
+     * const pricing = this.cartService.getItemPricing(item);
+     * const showTooltip = pricing.hasUnitPromotions;
+     * const finalPrice = pricing.finalPrice;
+     * ```
+     */
+    getItemPricing: (item: CartItem) => CartItemPricing;
     addCoupon: (code: any) => Promise<any>;
     removeCoupon: () => Promise<boolean>;
     formatCoupon: (cart: any) => void;
@@ -132,7 +192,44 @@ export declare class CartService {
     /**
      *  UTILS
      */
+    /**
+     * Transforma los ítems crudos del backend al contrato interno `CartItem`.
+     *
+     * @param server_item Respuesta `items` del endpoint de carrito.
+     * @returns Arreglo de ítems normalizados, cada uno con `pricing` precomputado.
+     *
+     * @remarks
+     * Este es el punto donde el core:
+     * - preserva `unitPromotions`
+     * - arma `pricing`
+     * - mantiene la forma histórica del item consumido por los templates
+     */
     transformItems: (server_item: any) => any;
+    /**
+     * Construye la normalización de precios para un ítem del carrito.
+     *
+     * @param item Ítem normalizado del carrito.
+     * @returns Estructura `CartItemPricing` con precio base, tachado, final y flags de UI.
+     *
+     * @example
+     * ```ts
+     * const pricing = this.buildCartItemPricing(item);
+     * // pricing.basePrice => saleprice si existe, si no price
+     * // pricing.finalPrice => basePrice + unitPromotionTotal
+     * // pricing.effectiveDiscountPercent => % total contra el precio de referencia
+     * ```
+     */
+    private buildCartItemPricing;
+    /**
+     * Normaliza valores de precio provenientes del backend a `number`.
+     *
+     * @param value Valor numérico o string con formato local (`120.000`, `120000`, `120000-1`, etc.).
+     * @returns Número parseado o `NaN` si el valor no es utilizable.
+     *
+     * @remarks
+     * Se usa para soportar respuestas con separadores de miles, coma decimal o rangos.
+     */
+    private parsePriceValue;
     getCreditAmount: () => Observable<number>;
     getClientTaxes: () => Observable<number>;
     getRemainingCredits: () => Observable<number>;

package/lib/utils/order-util.service.d.ts

@@ -7,6 +7,64 @@ export declare class OrderUtilityService {
      * @description Devuelve un listado con todas las promociones que posee el carro/orden
      */
     getPromotions: (cart: any, forCart?: boolean) => CheckoutData[];
+    /**
+     * Construye el resumen de promociones que debe mostrarse en checkout y resúmenes de compra.
+     *
+     * @param cart Carrito u orden con estructura `totals` compatible.
+     * @param forCart Cuando es `true`, omite subtotal y total para devolver solo las líneas intermedias.
+     * @returns Lista de líneas normalizadas para renderizar el resumen.
+     *
+     * @remarks
+     * A diferencia de `getPromotions`, este método solo considera descuentos de orden.
+     */
+    getSummaryPromotions: (cart: any, forCart?: boolean) => CheckoutData[];
+    /**
+     * Obtiene el monto de descuento que corresponde al resumen de la orden.
+     *
+     * @param cart Carrito u orden con `totals`.
+     * @returns Monto de promociones de orden.
+     *
+     * @example
+     * ```ts
+     * const amount = this.orderUtils.getSummaryPromotionAmount(cart);
+     * ```
+     *
+     * @remarks
+     * Si el backend nuevo informa `promotionBreakdown.orderPromotions`, ese valor tiene prioridad.
+     * Con backends viejos hace fallback a `totals.promotion` o `totals.discount`.
+     */
+    getSummaryPromotionAmount: (cart: any) => number;
+    /**
+     * Indica si el backend ya informa el desglose nuevo de promociones.
+     *
+     * @param cart Carrito u orden con `totals`.
+     * @returns `true` cuando existe `promotionBreakdown.orderPromotions`.
+     */
+    hasOrderPromotionsBreakdown: (cart: any) => boolean;
+    /**
+     * Indica si el carrito tiene un cupón aplicado, independientemente de cómo impacte en el resumen.
+     *
+     * @param cart Carrito actual.
+     * @returns `true` cuando hay un código de cupón o una línea de descuento de tipo cupón.
+     *
+     * @remarks
+     * Este helper evita atar la UI de `Quitar cupón` al monto de descuentos de orden.
+     * Un cupón puede afectar promociones unitarias y dejar `orderPromotions = 0`.
+     */
+    hasAppliedCoupon: (cart: any) => boolean;
+    /**
+     * Devuelve el monto efectivo de una línea de descuento/promoción.
+     *
+     * @param discount Línea cruda de descuento del backend.
+     * @param cart Carrito asociado.
+     * @returns Monto que debe mostrarse en UI.
+     */
     getAmount: (discount: any, cart: any) => number;
+    /**
+     * Homologa tipos crudos del backend al conjunto de tipos usado por checkout.
+     *
+     * @param type Tipo crudo (`order_promotion`, `order_coupon_promotion`, etc.).
+     * @returns Tipo normalizado consumido por los componentes del core.
+     */
     formatType: (type: string) => CheckoutDataType;
 }