@imj_media/ui 1.8.11 → 1.9.0

package/dist/modules/Message/components/molecules/NotificationItem.d.ts

@@ -1,8 +1,43 @@
-import { default as React } from 'react';
 import { NotificationGroup } from '../../../../shared/types/message';
-interface NotificationItemProps {
+/** Grupo activo del servicio de notificaciones (cola, color de mazo, `isLeaving`, etc.). */
+export interface NotificationItemProps {
+    /** Estado del mazo: cola, contador, progreso de temporizador y bandera de salida animada. */
     group: NotificationGroup;
 }
-export declare const NotificationItem: React.MemoExoticComponent<({ group }: NotificationItemProps) => import("react/jsx-runtime").JSX.Element | null>;
-export {};
+/**
+ * Stack superpuesto anclado por la base: como máximo **3** notificaciones en vista previa;
+ * con **hover** se muestran todas las de la cola. El desfase vertical aumenta al expandir.
+ * Con hover, un clic fuera de controles interactivos abre la lista vertical con toda la cola.
+ * La lista extendida no se cierra al salir el puntero del mazo (solo deja de contar como hover expandido).
+ * Cerrar una notificación no debe colapsar el mazo ya extendido por hover (se suprime el mouseleave espurio).
+ * Cierre **individual** por tarjeta (`dismiss(id)`). El **timer** (barra) solo en la más antigua del grupo
+ * (orden 1 / arriba) si está en la porción visible; en lista extendida solo en la primera fila.
+ * Con **hover** en el mazo (varias notas, vista **apilada**), el pie y la barra se atenúan con la misma
+ * transición que el stack (sin `display: none`), sin pausar el temporizador del servicio. Tras abrir la
+ * **lista completa** (clic en el grupo), el hover ya no atenúa la barra de progreso; el pie de total
+ * («N notificaciones más») no se muestra en esa vista. Al expirar el temporizador, se cierra la más antigua
+ * y avanza la cola.
+ * La cola del servicio mantiene **antigua → reciente**; al cerrar una, las demás suben de orden; al pasar
+ * `stackMax`, se expulsa la de arriba (más antigua). El estrechamiento horizontal sigue la profundidad visual
+ * (2ª = menos profunda / menos recorte; 3ª = más profunda / más recorte; al hover, 100%).
+ * Con **más de una** notificación en el mazo (vista apilada), las alertas usan `animation="none"` y anulan
+ * `transition-all` del `Alert` (`!ui-transition-none`) para no interpolar opacidad/layout sobre capas inferiores.
+ * El listado (`NotificationPositions`) usa una `key` estable por color para no remontar
+ * todo el mazo al entrar o salir notificaciones; el grupo se muta in-place en el servicio, así que este
+ * componente no debe envolverse en `React.memo` por referencia de `group` (bloquearía la cola en pantalla).
+ *
+ * Tras cada cambio de cola se aplica un breve “asentamiento” (ver `STACK_LAYOUT_SETTLE_MS`) sin
+ * transición de **padding** en el contenedor del mazo (evita solape con clics muy rápidos). Las capas
+ * conservan transición en `bottom` para que el hover expanda siempre con animación, incluso justo
+ * después de mostrar el stack.
+ *
+ * @example
+ * import { NotificationItem } from '@imj_media/ui';
+ *
+ * <NotificationItem group={notificationGroupFromService} />
+ */
+export declare const NotificationItem: {
+    ({ group }: NotificationItemProps): import("react/jsx-runtime").JSX.Element | null;
+    displayName: string;
+};
 //# sourceMappingURL=NotificationItem.d.ts.map

package/dist/modules/Message/components/molecules/NotificationItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationItem.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/NotificationItem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAqB,MAAM,wBAAwB,CAAC;AAQ9E,UAAU,qBAAqB;IAC7B,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,wCAA0B,qBAAqB,oDAqE1E,CAAC"}
+{"version":3,"file":"NotificationItem.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/NotificationItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAe3D,4FAA4F;AAC5F,MAAM,WAAW,qBAAqB;IACpC,6FAA6F;IAC7F,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,gBAAgB;gBAAe,qBAAqB;;CAqJhE,CAAC"}

package/dist/modules/Message/components/molecules/NotificationItemFullListPanel.d.ts

@@ -0,0 +1,45 @@
+import { NotificationIntent } from '../../../Notification';
+import { NotificationProps } from '../../../../shared/types/message';
+import type * as React from 'react';
+/** Props internas de la lista vertical “todas las notificaciones” dentro de un mazo. */
+export interface NotificationItemFullListPanelProps {
+    /** Cola completa del grupo (antigua → reciente). */
+    queue: NotificationProps[];
+    /** Intención visual aplicada a cada fila. */
+    intent: NotificationIntent;
+    /** Estado de salida común del contenedor durante dismiss del mazo. */
+    isLeaving: boolean;
+    /** Dispara la transición de entrada (opacidad / translate) al abrir la lista. */
+    listMotionEnter: boolean;
+    /** Si el servicio muestra barra de tiempo en las tarjetas. */
+    showTimer: boolean;
+    /** Duración por defecto del servicio cuando la entrada no define `duration`. */
+    notificationDuration: number;
+    /**
+     * Clases extra para envolver la barra (atenúación con hover en stack); recibe ms efectivos o `undefined`.
+     */
+    progressBarClassWhenStackHover: (durationMs: number | undefined) => string | undefined;
+    /** Handler de cierre por entrada (devuelve el manejador de botón). */
+    handleDismissOne: (n: NotificationProps) => (e: React.MouseEvent<HTMLButtonElement>) => void;
+}
+/**
+ * Lista vertical completa del mazo (todas las notificaciones en columna).
+ *
+ * @example
+ * // Uso normal vía `NotificationItem`; este fragmento ilustura la firma:
+ * <NotificationItemFullListPanel
+ *   queue={group.queue}
+ *   intent="critica"
+ *   isLeaving={group.isLeaving}
+ *   listMotionEnter={motion}
+ *   showTimer
+ *   notificationDuration={5000}
+ *   progressBarClassWhenStackHover={() => undefined}
+ *   handleDismissOne={(n) => (e) => { e.stopPropagation(); dismiss(n.id); }}
+ * />
+ */
+export declare function NotificationItemFullListPanel({ queue, intent, isLeaving, listMotionEnter, showTimer, notificationDuration, progressBarClassWhenStackHover, handleDismissOne, }: NotificationItemFullListPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace NotificationItemFullListPanel {
+    var displayName: string;
+}
+//# sourceMappingURL=NotificationItemFullListPanel.d.ts.map

package/dist/modules/Message/components/molecules/NotificationItemFullListPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationItemFullListPanel.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/NotificationItemFullListPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhE,wFAAwF;AACxF,MAAM,WAAW,kCAAkC;IACjD,oDAAoD;IACpD,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,MAAM,EAAE,kBAAkB,CAAC;IAC3B,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,8BAA8B,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IACvF,sEAAsE;IACtE,gBAAgB,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC9F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,MAAM,EACN,SAAS,EACT,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,8BAA8B,EAC9B,gBAAgB,GACjB,EAAE,kCAAkC,2CA2CpC;yBApDe,6BAA6B"}

package/dist/modules/Message/components/molecules/NotificationItemStackDeck.d.ts

@@ -0,0 +1,55 @@
+import { NotificationIntent } from '../../../Notification';
+import { NotificationProps } from '../../../../shared/types/message';
+import type * as React from 'react';
+/** Props de la vista apilada: capas bajo la frontal + frontal y pie del mazo. */
+export interface NotificationItemStackDeckProps {
+    /** Notificaciones que se pintan como capas absolutas bajo la frontal. */
+    stackUnderLayers: NotificationProps[];
+    /** Tarjeta visible al frente del stack. */
+    frontNotification: NotificationProps;
+    /** Clave estable de React para la frontal (id preferido). */
+    frontNotificationKey: number | undefined;
+    /** Píxeles de separación vertical entre capas (colapsado vs expandido). */
+    perLayerBottomPx: number;
+    /** Si el hover expande el stack a ancho completo. */
+    isStackExpanded: boolean;
+    /** Intención del mazo. */
+    intent: NotificationIntent;
+    /** Animación de salida del grupo. */
+    isLeaving: boolean;
+    /** Clases aplicadas al `Alert` del deck (p. ej. anular transiciones en multilayer). */
+    stackDeckAlertClassName: string;
+    /** Duración efectiva de barra para una id en el contexto del stack (más antigua visible, etc.). */
+    timerDurationInStack: (id: number | undefined) => number | undefined;
+    /** Wrapper de clases para la barra según hover y duración. */
+    progressBarClassWhenStackHover: (durationMs: number | undefined) => string | undefined;
+    /** Cierre por tarjeta. */
+    handleDismissOne: (n: NotificationProps) => (e: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Pie del stack (“N notificaciones más”) u otro chrome. */
+    stackListFooter: React.ReactNode;
+}
+/**
+ * Vista apilada: capas inferiores absolutas + frontal relativa.
+ *
+ * @example
+ * // Compuesto por `NotificationItem`; referencia de integración:
+ * <NotificationItemStackDeck
+ *   stackUnderLayers={tail}
+ *   frontNotification={head}
+ *   frontNotificationKey={head.id}
+ *   perLayerBottomPx={8}
+ *   isStackExpanded={false}
+ *   intent="informativa"
+ *   isLeaving={false}
+ *   stackDeckAlertClassName="ui-w-full"
+ *   timerDurationInStack={() => undefined}
+ *   progressBarClassWhenStackHover={() => undefined}
+ *   handleDismissOne={(n) => (e) => { e.stopPropagation(); }}
+ *   stackListFooter={null}
+ * />
+ */
+export declare function NotificationItemStackDeck({ stackUnderLayers, frontNotification, frontNotificationKey, perLayerBottomPx, isStackExpanded, intent, isLeaving, stackDeckAlertClassName, timerDurationInStack, progressBarClassWhenStackHover, handleDismissOne, stackListFooter, }: NotificationItemStackDeckProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace NotificationItemStackDeck {
+    var displayName: string;
+}
+//# sourceMappingURL=NotificationItemStackDeck.d.ts.map

package/dist/modules/Message/components/molecules/NotificationItemStackDeck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationItemStackDeck.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/NotificationItemStackDeck.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,iFAAiF;AACjF,MAAM,WAAW,8BAA8B;IAC7C,yEAAyE;IACzE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,2CAA2C;IAC3C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,6DAA6D;IAC7D,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,0BAA0B;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,uFAAuF;IACvF,uBAAuB,EAAE,MAAM,CAAC;IAChC,mGAAmG;IACnG,oBAAoB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IACrE,8DAA8D;IAC9D,8BAA8B,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IACvF,0BAA0B;IAC1B,gBAAgB,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC7F,4DAA4D;IAC5D,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,SAAS,EACT,uBAAuB,EACvB,oBAAoB,EACpB,8BAA8B,EAC9B,gBAAgB,EAChB,eAAe,GAChB,EAAE,8BAA8B,2CAwEhC;yBArFe,yBAAyB"}

package/dist/modules/Message/components/molecules/NotificationPositions.d.ts

@@ -1,8 +1,20 @@
-import { NotificationGroup, NotificationColor } from '../../../../shared/types/message';
+import { NotificationGroup } from '../../../../shared/types/message';
 import { default as React } from 'react';
-interface NotificationPositionsProps {
-    groups: Record<NotificationColor, NotificationGroup | null>;
+/** Estado de mazos de notificación (claves internas → grupo con cola y metadatos). */
+export interface NotificationPositionsProps {
+    /** Grupos procedentes de `useNotification().groups` o del servicio (`notificationService.getGroups()`). */
+    groups: Record<string, NotificationGroup>;
 }
+/**
+ * Un único ancla en pantalla según `notificationService` y un `NotificationItem` por mazo activo.
+ *
+ * @example
+ * import { NotificationPositions, useNotification } from '@imj_media/ui';
+ *
+ * function Demo() {
+ *   const { groups } = useNotification();
+ *   return <NotificationPositions groups={groups} />;
+ * }
+ */
 export declare const NotificationPositions: React.MemoExoticComponent<({ groups }: NotificationPositionsProps) => import("react/jsx-runtime").JSX.Element | null>;
-export {};
 //# sourceMappingURL=NotificationPositions.d.ts.map

package/dist/modules/Message/components/molecules/NotificationPositions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationPositions.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/NotificationPositions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI9E,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,0BAA0B;IAClC,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,eAAO,MAAM,qBAAqB,yCAA2B,0BAA0B,oDAmDrF,CAAC"}
+{"version":3,"file":"NotificationPositions.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/NotificationPositions.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,sFAAsF;AACtF,MAAM,WAAW,0BAA0B;IACzC,2GAA2G;IAC3G,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,yCAA2B,0BAA0B,oDAoDrF,CAAC"}

package/dist/modules/Message/components/molecules/notificationItemCardMapping.d.ts

@@ -0,0 +1,43 @@
+import { NotificationProps } from '../../../../shared/types/message';
+import { NotificationCardProps, NotificationIntent } from '../../../Notification';
+import { AnimationAlert } from '../../../../shared/types/alert';
+import type * as React from 'react';
+/**
+ * Mapea una notificación del servicio agrupado al componente **Notification** del design system.
+ *
+ * @param n - Entrada de la cola del servicio agrupado.
+ * @param intent - Intención visual compartida del mazo (`brand`, `neutral`, …).
+ * @param options - Overrides de presentación para esta capa (animación, timer, footer, botones).
+ * @returns Props listas para `<_notification.Notification />` (`NotificationCardProps`).
+ */
+export declare function messageQueueEntryToNotification(n: NotificationProps, intent: NotificationIntent, options: {
+    /** Clases Tailwind en el contenedor de la tarjeta (ancho, anulación de transición en capas, …). */
+    className?: string;
+    /** Indica fase de salida para animación de cierre. */
+    isLeaving: boolean;
+    /** Duración en ms para la barra de progreso; `undefined` oculta la barra en esa capa. */
+    duration?: number;
+    /** Atenúa la barra sin desmontarla (p. ej. hover en el mazo). */
+    progressBarClassName?: string;
+    /** Animación del `Alert` interno (`none` en capas inferiores del stack). */
+    animation: AnimationAlert;
+    /** Si es true, propaga textos y callbacks de botones primario/secundario desde `n`. */
+    showActionButtons: boolean;
+    /** Si se define, sustituye `n.showCloseButton` (p. ej. capas traseras del mazo). */
+    showCloseButton?: boolean;
+    /** Pie opcional reemplazando el slot `footer` de la tarjeta. */
+    footer?: React.ReactNode | null;
+    /** Cerrar desde el botón X (o overlay) con evento de botón. */
+    onClose?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Click en la superficie de la tarjeta cuando aplique. */
+    onClick?: () => void;
+}): NotificationCardProps;
+/**
+ * Fusiona overrides parciales sobre una tarjeta de notificación ya construida.
+ *
+ * @param base - Props completas de `Notification` (con `open`).
+ * @param over - Parcial por bloques (`content`, `appearance`, `meta`, `events`, `footer`) sin obligar `open`.
+ * @returns Nueva tarjeta con bloques fusionados superficialmente.
+ */
+export declare function mergeNotificationCard(base: NotificationCardProps, over?: Partial<Omit<NotificationCardProps, 'open'>>): NotificationCardProps;
+//# sourceMappingURL=notificationItemCardMapping.d.ts.map

package/dist/modules/Message/components/molecules/notificationItemCardMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationItemCardMapping.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/notificationItemCardMapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,CAAC,EAAE,iBAAiB,EACpB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE;IACP,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,SAAS,EAAE,cAAc,CAAC;IAC1B,uFAAuF;IACvF,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC3D,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,GACA,qBAAqB,CAuCvB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,qBAAqB,EAC3B,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,GAClD,qBAAqB,CAWvB"}

package/dist/modules/Message/components/molecules/notificationItemStackLayout.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Layout y clases de transición del mazo apilado en `NotificationItem`.
+ * Detalle UX: comentario de bloque del componente.
+ */
+/** Vista previa colapsada: máximo de tarjetas visibles (incluye la frontal). */
+export declare const STACK_PREVIEW_MAX_VISIBLE = 3;
+/** Desfase vertical base por capa (`bottom` negativo) en stack colapsado. */
+export declare const STACK_OFFSET_PX = 8;
+/** Recorte horizontal por nivel de profundidad sin hover (inset simétrico). */
+export declare const STACK_LAYER_COLLAPSED_TRIM_PER_LEVEL_PX = 22;
+/** Desfase vertical por capa con hover (stack más abierto). */
+export declare const STACK_OFFSET_EXPANDED_PX = 44;
+/** Gap entre filas en la vista lista completa. */
+export declare const FULL_LIST_GAP_PX = 8;
+/** Duración y easing compartidos (stack, lista, chrome). */
+export declare const STACK_MOTION_TIMING = "ui-duration-500 ui-ease-in-out motion-reduce:ui-transition-none";
+/** Alias de timing para expansión del stack (misma cadena que `STACK_MOTION_TIMING`). */
+export declare const STACK_EXPAND_EASE = "ui-duration-500 ui-ease-in-out motion-reduce:ui-transition-none";
+/** Transición del pie y envoltorio de barra (opacity + max-height). */
+export declare const STACK_CHROME_TRANSITION = "ui-transition-[opacity,max-height] ui-duration-500 ui-ease-in-out motion-reduce:ui-transition-none";
+/** Ventana sin transición de padding tras mutar la cola (ms). */
+export declare const STACK_LAYOUT_SETTLE_MS = 560;
+//# sourceMappingURL=notificationItemStackLayout.d.ts.map

package/dist/modules/Message/components/molecules/notificationItemStackLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationItemStackLayout.d.ts","sourceRoot":"","sources":["../../../../../src/modules/Message/components/molecules/notificationItemStackLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,+EAA+E;AAC/E,eAAO,MAAM,uCAAuC,KAAK,CAAC;AAE1D,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,oEAAoE,CAAC;AAErG,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,oEAAsB,CAAC;AAErD,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,uGAA8D,CAAC;AAEnG,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,MAAM,CAAC"}

package/dist/modules/Message/config/message.config.d.ts

@@ -1,5 +1,16 @@
 import { BaseMessageConfig } from '../../../shared/types/message';
+/**
+ * Valores iniciales del toast antes de cualquier `configure` / `configureMessage` en runtime.
+ */
 export declare const defaultMessageConfig: BaseMessageConfig;
+/**
+ * Configuración mutable de toasts; `MessageService.configure` y `configureMessage` la fusionan.
+ */
 export declare let messageConfig: BaseMessageConfig;
+/**
+ * Actualiza la configuración global de toasts (duración máxima, posición por defecto, textos de botones, etc.).
+ *
+ * @param newConfig - Parcial fusionado sobre `messageConfig` actual.
+ */
 export declare const configureMessage: (newConfig: Partial<BaseMessageConfig>) => void;
 //# sourceMappingURL=message.config.d.ts.map

package/dist/modules/Message/config/message.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.config.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/config/message.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,eAAO,MAAM,oBAAoB,EAAE,iBASlC,CAAC;AAEF,eAAO,IAAI,aAAa,EAAE,iBAA+C,CAAC;AAE1E,eAAO,MAAM,gBAAgB,GAAI,WAAW,OAAO,CAAC,iBAAiB,CAAC,SAErE,CAAC"}
+{"version":3,"file":"message.config.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/config/message.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBASlC,CAAC;AAEF;;GAEG;AACH,eAAO,IAAI,aAAa,EAAE,iBAA+C,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,OAAO,CAAC,iBAAiB,CAAC,SAErE,CAAC"}

package/dist/modules/Message/hooks/index.d.ts

@@ -1,4 +1,8 @@
+/**
+ * Re-export de hooks del módulo Message (toasts, notificaciones y subhook del mazo).
+ */
 export { useMessage } from './useMessage';
 export { useMessageStyles } from './useMessageStyles';
 export { useNotification } from './useNotification';
+export { useNotificationItemDeck } from './useNotificationItemDeck';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/Message/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/modules/Message/hooks/useMessage.d.ts

@@ -1,4 +1,13 @@
 import { BaseMessageProps } from '../../../shared/types/message';
+/**
+ * Suscripción al `messageService`: mantiene la lista plana de toasts y la agrupa por posición.
+ *
+ * Registra un único listener por montaje, programa auto-cierre según `duration` y aplica `maxMessages`.
+ *
+ * @returns Objeto con:
+ * - `messages` — array actual de `BaseMessageProps` en memoria.
+ * - `messagesByPosition` — mismo contenido agrupado por `MessagePosition` para `MessagePositions`.
+ */
 export declare const useMessage: () => {
     messagesByPosition: Partial<Record<import('../../../shared/types/message').MessagePosition, BaseMessageProps[]>>;
     messages: BaseMessageProps[];

package/dist/modules/Message/hooks/useMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMessage.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,wBAAwB,CAAC;AAI9E,eAAO,MAAM,UAAU;;;CAgHtB,CAAC"}
+{"version":3,"file":"useMessage.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,wBAAwB,CAAC;AAI9E;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;CAgHtB,CAAC"}

package/dist/modules/Message/hooks/useMessageStyles.d.ts

@@ -1,4 +1,9 @@
 import { MessagePosition } from '../../../shared/types/message';
+/**
+ * Clases Tailwind fijas (`ui-fixed` + offsets) para anclar toasts y notificaciones en la ventana.
+ *
+ * @returns `{ getPositionClasses }` — función que traduce una `MessagePosition` a cadena de clases (con fallback en desarrollo).
+ */
 export declare const useMessageStyles: () => {
     getPositionClasses: (position: MessagePosition) => string;
 };

package/dist/modules/Message/hooks/useMessageStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMessageStyles.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useMessageStyles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,gBAAgB;mCACW,eAAe;CA6BtD,CAAC"}
+{"version":3,"file":"useMessageStyles.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useMessageStyles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;mCACW,eAAe;CA6BtD,CAAC"}

package/dist/modules/Message/hooks/useNotification.d.ts

@@ -1,8 +1,19 @@
-import { NotificationGroup, NotificationColor } from '../../../shared/types/message';
+import { NotificationGroup, NotifyMessageStackGroup } from '../../../shared/types/message';
+/**
+ * Estado reactivo de los mazos de notificaciones (`notificationService`): mapa de grupos y helpers de cierre.
+ *
+ * @returns Objeto con:
+ * - `groups` — snapshot actual de todos los grupos (incluye los en `isLeaving` hasta que el servicio los retira).
+ * - `activeGroups` — valores de `groups` sin `isLeaving` (vista “solo activos”).
+ * - `leavingGroups` — grupos en animación de salida.
+ * - `dismissGroup` — vacía `primary` o `secondary`.
+ * - `dismissStack` — vacía por `stackKey` (p. ej. `'auto'`).
+ */
 export declare const useNotification: () => {
-    groups: Record<NotificationColor, NotificationGroup | null>;
+    groups: Record<string, NotificationGroup>;
     activeGroups: NotificationGroup[];
     leavingGroups: NotificationGroup[];
-    dismissGroup: (color: NotificationColor) => void;
+    dismissGroup: (stackGroup: NotifyMessageStackGroup) => void;
+    dismissStack: (stackKey: string) => void;
 };
 //# sourceMappingURL=useNotification.d.ts.map

package/dist/modules/Message/hooks/useNotification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useNotification.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useNotification.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG9E,eAAO,MAAM,eAAe;;;;0BAqCF,iBAAiB;CAE1C,CAAC"}
+{"version":3,"file":"useNotification.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useNotification.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGpF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;+BA8BG,uBAAuB;6BAEzB,MAAM;CAElC,CAAC"}

package/dist/modules/Message/hooks/useNotificationItemDeck.d.ts

@@ -0,0 +1,38 @@
+import { NotificationGroup, NotificationProps } from '../../../shared/types/message';
+import type * as React from 'react';
+/**
+ * Estado, temporizadores y manejadores del mazo apilado de notificaciones (`NotificationItem`).
+ *
+ * Encapsula visibilidad tras `isLeaving`, expansión por hover, lista completa, asentamiento de layout
+ * tras mutar la cola y supresión de `mouseleave` espurios al cerrar o al abrir la lista.
+ *
+ * @param group - Grupo de notificación del servicio (cola, contador, color, `isLeaving`).
+ * @returns Objeto con:
+ * - `deckHoverRef` — contenedor del mazo (padding inferior + hit area).
+ * - `isVisible` — oculta el mazo tras animación de salida cuando `isLeaving` es true.
+ * - `isStackExpanded` — hover: muestra todas las capas de la cola en vista previa.
+ * - `isFullListOpen` — lista vertical completa tras hover + clic.
+ * - `listMotionEnter` — pulso de entrada de la lista extendida (opacidad / translate).
+ * - `queueLayoutSettling` — ventana sin transición de padding tras cambiar la cola.
+ * - `showTimer` y `notificationDuration` — lectura actual de `notificationService.getConfig()` (timer global).
+ * - `handleDismissOne` — fábrica de cierre por id (`dismiss` + `onClose`).
+ * - `handleStackOpenListCapture` — captura de clic para abrir lista completa (sin interactivos).
+ * - `handleDeckMouseLeave` / `handleDeckMouseEnter` — hover del contenedor del mazo.
+ * - `hideStackHoverChrome` — atenuar pie y barra en stack apilado con hover (no en lista completa).
+ */
+export declare function useNotificationItemDeck(group: NotificationGroup): {
+    deckHoverRef: React.RefObject<HTMLDivElement>;
+    isVisible: boolean;
+    isStackExpanded: boolean;
+    isFullListOpen: boolean;
+    listMotionEnter: boolean;
+    queueLayoutSettling: boolean;
+    showTimer: boolean;
+    notificationDuration: number;
+    handleDismissOne: (n: NotificationProps) => (e: React.MouseEvent<HTMLButtonElement>) => void;
+    handleStackOpenListCapture: (e: React.MouseEvent<HTMLDivElement>) => void;
+    handleDeckMouseLeave: (e: React.MouseEvent<HTMLDivElement>) => void;
+    handleDeckMouseEnter: () => void;
+    hideStackHoverChrome: boolean;
+};
+//# sourceMappingURL=useNotificationItemDeck.d.ts.map

package/dist/modules/Message/hooks/useNotificationItemDeck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotificationItemDeck.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useNotificationItemDeck.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAInF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;0BAwGxD,iBAAiB,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC;oCAe5B,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC;8BAUtC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC;;;EA8BlE"}

package/dist/modules/Message/hooks/useNotificationItemDeck.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useNotificationItemDeck.test.d.ts.map

package/dist/modules/Message/hooks/useNotificationItemDeck.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotificationItemDeck.test.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/hooks/useNotificationItemDeck.test.ts"],"names":[],"mappings":""}

package/dist/modules/Message/services/MessageService.d.ts

@@ -53,7 +53,15 @@ declare class MessageService {
      */
     subscribe(listener: MessageListener): () => void;
 }
+/**
+ * Instancia singleton del servicio de toasts; la usan `toast`, `notify` y `useMessage`.
+ */
 export declare const messageService: MessageService;
+/**
+ * Expone el mismo singleton que `messageService` (útil en pruebas o integración imperativa sin React).
+ *
+ * @returns Instancia de `MessageService` compartida en toda la app.
+ */
 export declare const useMessageService: () => MessageService;
 export {};
 //# sourceMappingURL=MessageService.d.ts.map

package/dist/modules/Message/services/MessageService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageService.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/MessageService.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAA6B;IAEnD;;OAEG;IACH,IAAI,CACF,gBAAgB,EAAE,YAAY,EAC9B,KAAK,GAAE,YAAwB,EAC/B,OAAO,GAAE,kBAAuB,GAC/B,MAAM;IAkGT;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI7E;;OAEG;IACH,KAAK,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI3E;;OAEG;IACH,IAAI,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI1E;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI7E;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI7E;;OAEG;IACH,KAAK,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI3E;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAezB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,aAAa,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;CASjD;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAGnD,eAAO,MAAM,iBAAiB,sBAE7B,CAAC"}
+{"version":3,"file":"MessageService.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/MessageService.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAA6B;IAEnD;;OAEG;IACH,IAAI,CACF,gBAAgB,EAAE,YAAY,EAC9B,KAAK,GAAE,YAAwB,EAC/B,OAAO,GAAE,kBAAuB,GAC/B,MAAM;IAkGT;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI7E;;OAEG;IACH,KAAK,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI3E;;OAEG;IACH,IAAI,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI1E;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI7E;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI7E;;OAEG;IACH,KAAK,CAAC,gBAAgB,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAI3E;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAezB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,aAAa,CAAC,GAAG,IAAI;IAIvD;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;CASjD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sBAE7B,CAAC"}

package/dist/modules/Message/services/MessageService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MessageService.test.d.ts.map

package/dist/modules/Message/services/MessageService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageService.test.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/MessageService.test.ts"],"names":[],"mappings":""}

package/dist/modules/Message/services/NotificationService.d.ts

@@ -1,18 +1,8 @@
-import { NotificationOptions, NotificationColor, NotificationGroup, NotificationConfig } from '../../../shared/types/message';
-type NotificationInput = string | (NotificationOptions & {
-    message?: string;
-});
-type NotificationGroupListener = (groups: Record<NotificationColor, NotificationGroup | null>) => void;
+import { NotificationGroup, NotificationConfig, NotifyMessageOptions, NotifyMessageStackGroup } from '../../../shared/types/message';
+type NotificationGroupListener = (groups: Record<string, NotificationGroup>) => void;
 /**
- * Servicio de Notificaciones
- *
- * Comportamiento:
- * - Las notificaciones se agrupan por color (brand | neutral)
- * - Solo se muestra UNA notificación por grupo (la primera)
- * - Se mantiene un contador de notificaciones acumuladas
- * - El contador solo se muestra cuando > 1
- * - Cada nueva notificación reinicia el timer
- * - Al cerrar, se descartan todas las notificaciones del grupo
+ * Servicio de notificaciones agrupadas por `stackKey` (`primary` / `secondary` / `auto`), cola antigua → reciente
+ * y `stackMax`. `dismissGroup` / `dismissStack` vacían mazos; `dismiss(id)` retira una entrada.
  */
 declare class NotificationService {
     private listeners;
@@ -22,15 +12,21 @@ declare class NotificationService {
     private progressIntervals;
     private removeTimers;
     /**
-     * Muestra una notificación
+     * Encola una notificación agrupada (API unificada `notify.message`).
+     */
+    message(options: NotifyMessageOptions): number;
+    private enqueueFromOptions;
+    /**
+     * Si la cola supera `stackMax`, elimina la más antigua hasta cumplir el límite.
      */
-    show(messageOrOptions: NotificationInput, color?: NotificationColor, options?: NotificationOptions): number;
+    private evictOldestWhileOverCap;
     /**
      * Agrega una notificación al grupo correspondiente
      */
     private addToGroup;
     /**
-     * Inicia el timer para un grupo
+     * Inicia el timer del grupo solo para la notificación **más antigua** (`queue[0]`).
+     * Al expirar se elimina esa sola con `dismiss(id)` (no se cierra el grupo entero).
      */
     private startTimer;
     /**
@@ -42,30 +38,27 @@ declare class NotificationService {
      */
     private clearTimer;
     /**
-     * Cierra todas las notificaciones de un grupo
+     * Cierra todas las notificaciones de un mazo explícito (`primary` | `secondary`).
      */
-    dismissGroup(color: NotificationColor): void;
-    /**
-     * Cierra una notificación específica por ID
-     * (En el sistema de notificaciones, esto cierra todo el grupo)
-     */
-    dismiss(id: number): void;
+    dismissGroup(stackGroup: NotifyMessageStackGroup): void;
     /**
-     * Notificación de marca (brand)
+     * Cierra todas las notificaciones del mazo identificado por `stackKey` (`primary`, `secondary`, `auto`, …).
      */
-    brand(messageOrOptions: NotificationInput, options?: NotificationOptions): number;
+    dismissStack(stackKey: string): void;
     /**
-     * Notificación neutral
+     * Elimina una notificación concreta de su grupo por `id`.
+     * Si la cola queda vacía, el grupo se elimina.
+     * Si queda cola, se reinicia el timer para la más antigua actual (`queue[0]`) (incluye cierre manual de una notificación intermedia).
      */
-    neutral(messageOrOptions: NotificationInput, options?: NotificationOptions): number;
+    dismiss(id: number): void;
     /**
      * Configura las opciones del servicio
      */
     configure(options: Partial<NotificationConfig>): void;
     /**
-     * Obtiene los grupos actuales
+     * Obtiene los grupos actuales (solo mazos con cola activa).
      */
-    getGroups(): Record<NotificationColor, NotificationGroup | null>;
+    getGroups(): Record<string, NotificationGroup>;
     /**
      * Suscribirse a cambios
      */
@@ -79,7 +72,15 @@ declare class NotificationService {
      */
     getConfig(): NotificationConfig;
 }
+/**
+ * Instancia singleton del servicio de notificaciones agrupadas; la usan `notification`, `notify` y `useNotification`.
+ */
 export declare const notificationService: NotificationService;
+/**
+ * Expone el mismo singleton que `notificationService` (acceso directo al servicio desde componentes o pruebas).
+ *
+ * @returns Instancia de `NotificationService` compartida en toda la app.
+ */
 export declare const useNotificationService: () => NotificationService;
 export {};
 //# sourceMappingURL=NotificationService.d.ts.map

package/dist/modules/Message/services/NotificationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/NotificationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,wBAAwB,CAAC;AAGhC,KAAK,iBAAiB,GAAG,MAAM,GAAG,CAAC,mBAAmB,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAG/E,KAAK,yBAAyB,GAAG,CAC/B,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC,KACxD,IAAI,CAAC;AAaV;;;;;;;;;;GAUG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,SAAS,CAAK;IAGtB,OAAO,CAAC,MAAM,CAGZ;IAGF,OAAO,CAAC,MAAM,CAGZ;IAGF,OAAO,CAAC,iBAAiB,CAGvB;IAGF,OAAO,CAAC,YAAY,CAGlB;IAEF;;OAEG;IACH,IAAI,CACF,gBAAgB,EAAE,iBAAiB,EACnC,KAAK,GAAE,iBAA2B,EAClC,OAAO,GAAE,mBAAwB,GAChC,MAAM;IA6FT;;OAEG;IACH,OAAO,CAAC,UAAU;IA6BlB;;OAEG;IACH,OAAO,CAAC,UAAU;IA+BlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,iBAAiB;IAmBrC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;IAWlB;;OAEG;IACH,KAAK,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM;IAIjF;;OAEG;IACH,OAAO,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM;IAInF;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAI9C;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAIhE;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAU1D;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,SAAS,IAAI,kBAAkB;CAGhC;AAGD,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAG7D,eAAO,MAAM,sBAAsB,2BAElC,CAAC"}
+{"version":3,"file":"NotificationService.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/NotificationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EAEpB,uBAAuB,EAExB,MAAM,wBAAwB,CAAC;AAQhC,KAAK,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAAC;AAcrF;;;GAGG;AACH,cAAM,mBAAmB;IACvB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,MAAM,CAAwC;IAEtD,OAAO,CAAC,MAAM,CAA4C;IAE1D,OAAO,CAAC,iBAAiB,CAA4C;IAErE,OAAO,CAAC,YAAY,CAA4C;IAEhE;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAkB9C,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAuClB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAsClB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkBlB;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,uBAAuB;IAIhD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM;IAmB7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;IAyBlB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAiB9C;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI9C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAU1D;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,SAAS,IAAI,kBAAkB;CAGhC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,qBAA4B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2BAElC,CAAC"}

package/dist/modules/Message/services/NotificationService.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NotificationService.test.d.ts.map

package/dist/modules/Message/services/NotificationService.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationService.test.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/NotificationService.test.ts"],"names":[],"mappings":""}

package/dist/modules/Message/services/notificationServiceBuildEnqueueNotification.d.ts

@@ -0,0 +1,15 @@
+import { NotificationProps, NotificationOptions, NotifyMessageCardFields, NotificationColor, NotificationConfig } from '../../../shared/types/message';
+/**
+ * Construye la notificación persistida al encolar desde opciones ya separadas de metadatos de API.
+ *
+ * @param id - Identificador único asignado por el servicio.
+ * @param finalOptions - Opciones de `Notification` más título/mensaje ya normalizados.
+ * @param color - Color de cola interno (`brand` / `neutral`) derivado del mazo.
+ * @param notificationCard - Overrides tipados de tarjeta (`NotifyMessageCardFields`) o `undefined`.
+ * @param config - Snapshot de `NotificationConfig` (duración, tamaño, timer, posición, …).
+ * @returns Modelo `NotificationProps` listo para la cola del grupo.
+ */
+export declare function buildNotificationPropsForEnqueue(id: number, finalOptions: NotificationOptions & {
+    title?: string;
+}, color: NotificationColor, notificationCard: NotifyMessageCardFields | undefined, config: NotificationConfig): NotificationProps;
+//# sourceMappingURL=notificationServiceBuildEnqueueNotification.d.ts.map

package/dist/modules/Message/services/notificationServiceBuildEnqueueNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notificationServiceBuildEnqueueNotification.d.ts","sourceRoot":"","sources":["../../../../src/modules/Message/services/notificationServiceBuildEnqueueNotification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAGhC;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,mBAAmB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACtD,KAAK,EAAE,iBAAiB,EACxB,gBAAgB,EAAE,uBAAuB,GAAG,SAAS,EACrD,MAAM,EAAE,kBAAkB,GACzB,iBAAiB,CAgCnB"}