sass-cms-template-common 0.0.11 → 0.0.13

package/dist/index.d.ts

@@ -35,7 +35,7 @@ export declare type AppMessageNode = string | {
 /** Árbol de mensajes del gestor (namespaces → claves → string anidable). */
 export declare type AppMessages = Record<string, AppMessageNode>;
 
-export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, editorialOpportunities, showEditorialOpportunities, copilotSuggestionsHref, onEditorialSeeMore, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, LinkComponent, permissions, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
+export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, LinkComponent, permissions, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
@@ -44,14 +44,12 @@ export declare type AppShellProps = {
     notificationUnreadCount: number;
     /** Respuesta cruda de `POST /dashboard/notification` (newsTask/expireTask/videos). */
     notificationsData?: DashboardNotificationsResponse | null;
-    /** Oportunidades editoriales copilot (card de la campanita). Si se omite, mock temporal. */
-    editorialOpportunities?: EditorialOpportunity[];
-    /** Muestra la card de oportunidades editoriales copilot. Por defecto `true`. */
-    showEditorialOpportunities?: boolean;
-    /** URL del gestor de sugerencias copilot para el "Ver más" (enlace real). */
+    /** Destino del "Ver más" / clic en una oportunidad copilot (página de sugerencias). */
     copilotSuggestionsHref?: string;
     /** Clic en "Ver más" cuando no hay `copilotSuggestionsHref` (fallback). */
     onEditorialSeeMore?: () => void;
+    /** "Recordar luego": recibe los `opportunity_id` mostrados para el snooze. */
+    onEditorialRemindLater?: (opportunityIds: string[]) => void;
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
@@ -919,7 +917,11 @@ export declare type CmsConfirmDialogProps = {
     minHeight?: number | string;
     /** Evita cerrar al hacer clic fuera o con Escape (p. ej. mientras carga). */
     disableBackdropClose?: boolean;
-    /** Base para los `data-testid`. */
+    /**
+     * Base para los `data-testid`. Emite: `${testId}` (modal),
+     * `${testId}-icon-btn-close` (botón X), `${testId}-actions` (fila de botones)
+     * y los botones `${testId}-actions-btn-cancel` y `${testId}-actions-btn-confirm`.
+     */
     testId?: string;
 };
 
@@ -977,6 +979,13 @@ export declare class CmsCopilotServices {
      * oportunidad: `save` | `like` | `dislike` | `assign` (permiso COPILOT_ACTION).
      */
     executeAction: (input: CopilotActionInput) => Promise<CopilotActionResponse>;
+    /**
+     * POST /copilot/snooze — "recordar luego" de una oportunidad de la campanita
+     * (permiso COPILOT_VIEW). La oportunidad desaparece de la campanita para el
+     * usuario y reaparece sola al vencer el plazo configurado.
+     * @param opportunityId - Id de la oportunidad a posponer.
+     */
+    snooze: (opportunityId: string) => Promise<CopilotSnoozeResponse>;
 }
 
 /**
@@ -1052,7 +1061,11 @@ export declare type CmsDialogActionsProps = {
     fullWidth?: boolean;
     /** Alineación horizontal de los botones. Por defecto `end`. */
     align?: CmsDialogActionsAlign;
-    /** Base para los `data-testid`. */
+    /**
+     * Base para los `data-testid`. El contenedor usa `testId`; el botón cancelar
+     * emite `${testId}-btn-cancel` y el de confirmar `${testId}-btn-confirm`
+     * (cada uno con su `data-action` `cancel` / `confirm` como atributo extra).
+     */
     testId?: string;
 };
 
@@ -2675,7 +2688,8 @@ export declare interface CopilotOpportunitiesResponse extends CmsResponse {
  *
  * La doc del gateway lista `id`, `topic` y `created_at`, pero el microservicio
  * (observado en dev) puede omitirlos: solo `title`, `status` y `score` están
- * garantizados. El consumidor debe tolerar los faltantes.
+ * garantizados. El consumidor debe tolerar los faltantes. En dev (2026-07-06) el
+ * micro también entrega `source`, `type`, `reasons` e `is_followed`.
  */
 export declare interface CopilotOpportunity {
     id?: string;
@@ -2687,8 +2701,23 @@ export declare interface CopilotOpportunity {
     score?: number;
     /** Fecha de creación (ISO 8601, p. ej. "2026-06-26T10:15:00Z"). */
     created_at?: string;
+    /** Fuente detectada (p. ej. "rss"). Verificado en dev 2026-07-06. */
+    source?: CopilotOpportunitySource;
+    /** Subtipo de match del micro (p. ej. "rss_match"). */
+    type?: string;
+    /** Motivos por los que el micro la propuso (para tooltip/detalle). */
+    reasons?: string[];
+    /** Si el editor ya la siguió/guardó (acción "save" de `copilot/actions`). */
+    is_followed?: boolean;
 }
 
+/**
+ * Fuente de la que el microservicio detectó la oportunidad. Valor observado en
+ * dev hoy: `"rss"`. Se deja abierto (passthrough) para no romper cuando el micro
+ * agregue fuentes nuevas.
+ */
+declare type CopilotOpportunitySource = 'rss' | 'gtrends' | 'sconsole' | 'x' | (string & {});
+
 /**
  * Estado de una oportunidad tal como lo entrega el microservicio (passthrough).
  * El único valor documentado hoy es `"open"`; se deja abierto para no romper
@@ -2696,6 +2725,18 @@ export declare interface CopilotOpportunity {
  */
 export declare type CopilotOpportunityStatus = 'open' | (string & {});
 
+/**
+ * Cuerpo de la respuesta de POST /copilot/snooze (NAA-4645). El "recordar luego"
+ * de la campanita: la oportunidad se oculta para ese usuario y reaparece sola al
+ * vencer el plazo configurado.
+ */
+export declare interface CopilotSnoozeResponse extends CmsResponse {
+    copilotEnabled?: boolean;
+    opportunity_id?: string;
+    /** Momento hasta el cual la oportunidad queda oculta (ISO 8601 o epoch). */
+    snoozed_until?: string | number;
+}
+
 /** POST /dashboard/countNotificatio */
 export declare interface CountNotificationsResponse {
     status: string;
@@ -2736,10 +2777,32 @@ export declare interface CurrentUserPhotoProviderProps {
     children: ReactNode;
 }
 
+/**
+ * Oportunidad editorial copilot presente en POST /dashboard/notification
+ * (NAA-4645). El back manda hasta 3, ordenadas por `score` desc, y solo si hay.
+ */
+export declare interface DashboardCopilotOpportunity {
+    /** Id de la oportunidad (opportunity_id, requerido para el snooze). */
+    id?: string;
+    title: string;
+    /** Tema/categoría de la oportunidad. */
+    topic?: string;
+    /** Puntaje de coincidencia editorial (0-100). */
+    score?: number;
+    /** Fecha de creación (ISO 8601, p. ej. "2026-06-26T10:15:00Z"). */
+    created_at?: string;
+    isRead?: boolean;
+}
+
 /** Cuerpo de la respuesta de POST /dashboard/countNotifications. */
 export declare interface DashboardCountNotificationsResponse extends CmsResponse {
     /** Total de notificaciones no leídas del usuario autenticado. */
     unreadNotifications?: number;
+    /**
+     * Oportunidades copilot no leídas (NAA-4645). Ya está **sumado** dentro de
+     * `unreadNotifications`; solo aparece si copilot aplica al usuario/publicación.
+     */
+    copilotOpportunities?: number;
 }
 
 /** Actividad vencida o por vencer presente en POST /dashboard/notification. */
@@ -2784,6 +2847,8 @@ export declare interface DashboardNotificationsResponse extends CmsResponse {
     newsTask?: DashboardNewsTask[];
     /** Actividades vencidas o por vencer. */
     expireTask?: DashboardExpireTask[];
+    /** Oportunidades editoriales copilot (hasta 3, por `score` desc). NAA-4645. */
+    copilot?: DashboardCopilotOpportunity[];
 }
 
 /** Evento de encoder de video presente en POST /dashboard/notification. */
@@ -2910,25 +2975,6 @@ export declare type DropdownOption = {
     testId?: string;
 };
 
-/**
- * Oportunidad editorial de un tema copilot (fuente de la card de la campanita).
- * Misma forma que el `getCopilotOpportunities()` del CMS Angular (NAA-4645): hoy
- * datos quemados; cuando el back libere el bloque en el WS de notificaciones se
- * reemplaza la fuente manteniendo esta forma.
- */
-export declare interface EditorialOpportunity {
-    id: number | string;
-    title: string;
-    /** % de coincidencia con la línea editorial. */
-    match: number;
-    trending: boolean;
-    isRead: boolean;
-    /** Momento de entrega (epoch ms), como `{ time }` o número. */
-    timeStamp?: {
-        time: number;
-    } | number | null;
-}
-
 export declare type EditorialOpportunityColors = typeof editorialOpportunityColors;
 
 export declare const editorialOpportunityColors: Record<"accent" | "text" | "topicBg" | "topicBorder" | "trending", string>;
@@ -3694,15 +3740,6 @@ export declare function getDefaultPublicationSlug(sites: SiteSection[]): string;
 /** BCP 47 tag for `Intl` / `toLocaleString` formatting. */
 export declare function getIntlLocaleTag(locale: Locale): string;
 
-/**
- * Oportunidades editoriales copilot QUEMADAS temporales (NAA-4837). El back aún
- * no envía este bloque; cuando lo haga, el gestor pasa las oportunidades reales
- * por la prop `editorialOpportunities` y este mock se elimina.
- *
- * @param now Instante actual (epoch ms) usado como hora de entrega de las cards.
- */
-export declare function getMockCopilotOpportunities(now: number): EditorialOpportunity[];
-
 export declare function getProfileAvatarSrc(profile: ProfileGetResponse, options?: ProfileAvatarOptions): string;
 
 export declare function getProfileDisplayName(profile: ProfileGetResponse): string;
@@ -4860,7 +4897,7 @@ export declare interface NotificationsListResponse {
     total?: number;
 }
 
-export declare function NotificationsMenu({ unreadCount, notificationsData, masterBaseUrl, currentPublicationId, gmtRedaction, editorialOpportunities, showEditorialOpportunities, copilotSuggestionsHref, onEditorialSeeMore, }: NotificationsMenuProps): JSX.Element;
+export declare function NotificationsMenu({ unreadCount, notificationsData, masterBaseUrl, currentPublicationId, gmtRedaction, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, }: NotificationsMenuProps): JSX.Element;
 
 export declare type NotificationsMenuMessageKey = keyof CmsMessages['notificationsMenu'];
 
@@ -4876,21 +4913,20 @@ export declare type NotificationsMenuProps = {
     /** Offset GMT de la publicación (para mostrar las fechas en zona de redacción). */
     gmtRedaction?: string | null;
     /**
-     * Oportunidades editoriales copilot (card de la campanita, NAA-4837). Si se
-     * omite y `showEditorialOpportunities` no es `false`, se usan datos QUEMADOS
-     * temporales; cuando el back libere el bloque, el gestor pasa las reales aquí.
-     */
-    editorialOpportunities?: EditorialOpportunity[];
-    /** Muestra la card de oportunidades editoriales copilot. Por defecto `true`. */
-    showEditorialOpportunities?: boolean;
-    /**
-     * URL del gestor de sugerencias copilot para el "Ver más" de la card. La arma
-     * el gestor con su deploy (env) + la publicación actual; si se pasa, el "Ver
-     * más" es un enlace real (nueva pestaña). Si no, cae al callback.
+     * Destino del "Ver más" / clic en una oportunidad copilot (página de
+     * sugerencias). Lo arma el gestor: URL absoluta al deploy de sugerencias
+     * (env) si estás en otro gestor → abre en pestaña nueva; ruta relativa si ya
+     * estás en el gestor de sugerencias → navega en la misma. Sin valor, cae al callback.
      */
     copilotSuggestionsHref?: string;
     /** Clic en "Ver más" cuando no hay `copilotSuggestionsHref` (fallback). */
     onEditorialSeeMore?: () => void;
+    /**
+     * "Recordar luego" de la card de oportunidades: recibe los `opportunity_id` de
+     * las oportunidades mostradas para que el gestor dispare `copilot/snooze` por
+     * cada una. La card se oculta de inmediato (optimista).
+     */
+    onEditorialRemindLater?: (opportunityIds: string[]) => void;
 };
 
 /** Topic devuelto por notification/topics (`{ name, description }`). */
@@ -6869,7 +6905,7 @@ export declare interface ToastOptions {
 /** Severidad visual de un toast. */
 export declare type ToastSeverity = 'success' | 'error' | 'warning' | 'info';
 
-export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notificationsData, editorialOpportunities, showEditorialOpportunities, copilotSuggestionsHref, onEditorialSeeMore, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, }: TopBarProps): JSX.Element;
+export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, }: TopBarProps): JSX.Element;
 
 export declare type TopBarMessageKey = keyof CmsMessages['topBar'];
 
@@ -6881,14 +6917,12 @@ export declare type TopBarProps = {
     notificationUnreadCount: number;
     /** Respuesta cruda de `POST /dashboard/notification` (newsTask/expireTask/videos). */
     notificationsData?: DashboardNotificationsResponse | null;
-    /** Oportunidades editoriales copilot (card de la campanita). Si se omite, mock temporal. */
-    editorialOpportunities?: EditorialOpportunity[];
-    /** Muestra la card de oportunidades editoriales copilot. Por defecto `true`. */
-    showEditorialOpportunities?: boolean;
-    /** URL del gestor de sugerencias copilot para el "Ver más" (enlace real). */
+    /** Destino del "Ver más" / clic en una oportunidad copilot (página de sugerencias). */
     copilotSuggestionsHref?: string;
     /** Clic en "Ver más" cuando no hay `copilotSuggestionsHref` (fallback). */
     onEditorialSeeMore?: () => void;
+    /** "Recordar luego": recibe los `opportunity_id` mostrados para el snooze. */
+    onEditorialRemindLater?: (opportunityIds: string[]) => void;
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
@@ -6937,6 +6971,28 @@ export declare type TopBarProps = {
  */
 export declare function toSiteWallClock(epochMs: number, gmtRedaction: string | null | undefined): number;
 
+/**
+ * Normaliza un valor a un `data-testid` estable en kebab-case ASCII.
+ *
+ * Equivalente React del pipe `toTestId` del CMS Angular (`cmsmedios-ux`):
+ * pasa a minúsculas, quita tildes/acentos y convierte cualquier separador
+ * (espacios, puntos, guiones bajos, barras) en un único guion.
+ *
+ * IMPORTANTE: el valor que se le pasa debe ser **independiente del idioma**
+ * (una clave i18n, un `id`/`value`/`slug`, un código o enum interno), nunca el
+ * texto traducido: si no, el `data-testid` cambiaría según el idioma del usuario
+ * y las pruebas no podrían apuntarlo de forma estable.
+ *
+ * @param value Valor de origen (clave i18n, id, código o índice).
+ * @returns El `data-testid` normalizado, o `''` si el valor es vacío/nulo.
+ *
+ * @example
+ * toTestId('modal.deactivate.title') // 'modal-deactivate-title'
+ * toTestId('Próximo evento')         // 'proximo-evento'
+ * toTestId(3)                        // '3'
+ */
+export declare function toTestId(value: string | number | null | undefined): string;
+
 /**
  * Cuerpo de la respuesta de POST /transcribe/get.
  *