sass-cms-template-common 0.0.10 → 0.0.12

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, 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, 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 type AppShellProps = {
     pathname: string;
@@ -44,6 +44,14 @@ 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). */
+    copilotSuggestionsHref?: string;
+    /** Clic en "Ver más" cuando no hay `copilotSuggestionsHref` (fallback). */
+    onEditorialSeeMore?: () => void;
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
@@ -706,76 +714,48 @@ export declare class CmsCkeditorServices {
 
 export declare type CmsColors = typeof cmsColors;
 
-/** Paleta de la librería. Valores semánticos, no por componente. */
+/**
+ * Paleta de la librería. Valores semánticos, no por componente.
+ *
+ * Casi todos son *mode-aware* (`var(--cms-…)`). La única excepción es `white`,
+ * que es blanco de contraste (texto sobre botón de color) y se mantiene blanco
+ * en ambos modos.
+ */
 export declare const cmsColors: {
-    /** Color de acción primaria (CTA "Publicar/Guardar", botones, foco activo). */
-    readonly primary: "#0067C4";
-    /** Hover del primario (mismo tono, un poco más oscuro). */
-    readonly primaryHover: "#005CAF";
-    /** Fondo de control primario deshabilitado (negro al 10%). */
-    readonly primaryDisabled: "#1D1B201A";
-    /** Color secundario / contenedor (estado activo o seleccionado). */
-    readonly secondary: "#D8E2FF";
-    /** Hover sobre superficies secundarias (opciones de desplegable). */
-    readonly secondaryHover: "#E1E2EA";
-    /**
-     * Texto / íconos sobre el contenedor `secondary` (chips de filtro activos,
-     * opciones marcadas en multiselect, etiquetas). Equivale al
-     * `onSecondaryContainer` de Material 3.
-     */
-    readonly onSecondaryContainer: "#2C4678";
-    /**
-     * Secundario sólido (tono fuerte de la paleta secundaria). Se usa, p. ej.,
-     * para resaltar el borde del avatar al hacer hover sobre una fila.
-     */
-    readonly secondaryStrong: "#455E91";
-    /** Borde por defecto de controles tipo select. */
-    readonly controlBorder: "#727784";
-    /** Texto por defecto de controles tipo select. */
-    readonly controlText: "#000000";
-    /** Fondo de hover de un control tipo select (sin valor activo). */
-    readonly controlHoverBg: "#F9F9FF";
-    /** Borde del botón en variante blanca (BtnDropdown). */
-    readonly whiteBtnBorder: "#DDDDDD";
-    /** Texto del botón en variante blanca (BtnDropdown). */
-    readonly whiteBtnText: "#515253";
-    /** Fondo de hover/activo del botón de ícono (disparador del SimpleDropdown). */
-    readonly iconButtonHoverBg: "#E6E6E6";
-    /** Color del ícono del disparador en reposo. */
-    readonly iconButtonIcon: "#929193";
-    /** Fondo de menús flotantes (perfil, selector de sitios). */
-    readonly menuSurface: "#ECEDF6";
-    /** Fondo de la opción activa/hover dentro de un menú desplegable simple. */
-    readonly menuItemActive: "#E1E2EB";
-    /** Hover neutro sobre superficies claras (sidebar, top bar). */
-    readonly surfaceHover: "#E3E2E6";
-    /** Texto tenue del índice alfabético (letras inactivas A–Z del listado). */
-    readonly alphabetIdle: "#B4BEDA";
-    /** Texto fuerte (títulos de ítems, nombre de perfil). */
-    readonly textStrong: "#191C22";
-    /** Texto de navegación / secundario. */
-    readonly textNav: "#414752";
-    /** Texto atenuado: títulos de sección, encabezados de columna (gris claro). */
-    readonly textMuted: "#94A2AA";
-    /**
-     * Azul para enlaces de texto y botones tipo texto (p. ej. el label
-     * "Cancelar" del modal de confirmación y los enlaces dentro de descripciones).
-     */
-    readonly link: "#004F99";
-    /** Acento de acción destructiva (CTA "Desactivar/Resetear", badge de riesgo). */
-    readonly danger: "#BA1A1A";
-    /** Hover del acento destructivo. */
-    readonly dangerHover: "#93000A";
-    /** Acento de acción positiva (badge de "Activar"). */
-    readonly success: "#1E8E3E";
-    /** Bordes y divisores sutiles. */
-    readonly border: "#C1C6D4";
-    /** Fondo del avatar de perfil. */
-    readonly avatarBg: "#F2F6FC";
-    /** Borde del avatar de perfil. */
-    readonly avatarBorder: "#DEE2E6";
-    /** Blanco base (superficies elevadas / botones blancos). */
+    /** Blanco de contraste (texto/íconos sobre botones de color). Fijo en ambos modos. */
     readonly white: "#FFFFFF";
+    readonly primary: string;
+    readonly primaryHover: string;
+    readonly primaryDisabled: string;
+    readonly secondary: string;
+    readonly secondaryHover: string;
+    readonly onSecondaryContainer: string;
+    readonly secondaryStrong: string;
+    readonly controlBorder: string;
+    readonly controlText: string;
+    readonly controlHoverBg: string;
+    readonly whiteBtnBorder: string;
+    readonly whiteBtnText: string;
+    readonly iconButtonHoverBg: string;
+    readonly iconButtonIcon: string;
+    readonly menuSurface: string;
+    readonly menuItemActive: string;
+    readonly surfaceHover: string;
+    readonly alphabetIdle: string;
+    readonly alphabetIdleSoft: string;
+    readonly alphabetLetter: string;
+    readonly alphabetLetterDisabled: string;
+    readonly textStrong: string;
+    readonly textNav: string;
+    readonly textMuted: string;
+    readonly link: string;
+    readonly danger: string;
+    readonly dangerHover: string;
+    readonly success: string;
+    readonly border: string;
+    readonly avatarBg: string;
+    readonly avatarBorder: string;
+    readonly surface: string;
 };
 
 /**
@@ -939,7 +919,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;
 };
 
@@ -980,6 +964,25 @@ export declare class CmsContributionsServices {
     getPaymentGateways: (filters?: PaymentGatewaysGetFilters) => Promise<PaymentGatewaysGetResponse>;
 }
 
+/**
+ * Servicios HTTP del módulo `copilot` del CMS (gateway hacia el microservicio
+ * Copilot/Kundera). Errores propios en la serie `030.x` (ver `commonErrors`).
+ *
+ * Se construye igual que `CmsCommonServices`, con `{ axiosApi, authentication }`.
+ */
+export declare class CmsCopilotServices {
+    protected props: ICopilotServices;
+    protected authentication: Authentication;
+    constructor(props: ICopilotServices);
+    /** POST /copilot/opportunities — feed de oportunidades (permiso COPILOT_VIEW). */
+    getOpportunities: (filters?: CopilotOpportunitiesFilters) => Promise<CopilotOpportunitiesResponse>;
+    /**
+     * POST /copilot/actions — ejecuta una acción del editor sobre una
+     * oportunidad: `save` | `like` | `dislike` | `assign` (permiso COPILOT_ACTION).
+     */
+    executeAction: (input: CopilotActionInput) => Promise<CopilotActionResponse>;
+}
+
 /**
  * Servicios HTTP del módulo `dashboard` del CMS.
  *
@@ -1053,10 +1056,40 @@ 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;
 };
 
+/**
+ * Página de error compartida por todos los gestores (mecanismo en la lib).
+ * Replica la de cmsmedios: ilustración + título + subtítulo + botón HOME, y en
+ * el 404 la línea "Error 404. Copiar detalle." que copia la URL al portapapeles.
+ * Los textos salen del i18n de la lib (namespace `errorPage`, es/en/pt), así que
+ * ningún gestor los duplica.
+ */
+export declare function CmsErrorPage({ variant, homeHref, LinkComponent, illustrationSrc, }: CmsErrorPageProps): JSX.Element;
+
+export declare type CmsErrorPageProps = {
+    /** Tipo de error a mostrar. */
+    variant: CmsErrorPageVariant;
+    /** Destino del botón HOME. Por defecto la raíz del gestor (`/`). */
+    homeHref?: string;
+    /** Componente de enlace del host (p. ej. `next/link`). Por defecto un `<a>`. */
+    LinkComponent?: CmsLinkComponent;
+    /**
+     * Ruta de la ilustración (servida desde el `public/` del gestor). Por defecto
+     * `/errors/notfound.png` o `/errors/not-allowed.png` según la variante.
+     */
+    illustrationSrc?: string;
+};
+
+/** Variante de error a mostrar: 404 (no encontrado) o sin permisos. */
+export declare type CmsErrorPageVariant = 'not-found' | 'not-allowed';
+
 /** Severidad de feedback derivada de un código de error. */
 export declare type CmsErrorSeverity = 'warning' | 'error';
 
@@ -2089,6 +2122,7 @@ export declare type CmsTranslator = {
     }) => string;
     toast: (key: ToastMessageKey) => string;
     userAvatar: (key: UserAvatarMessageKey) => string;
+    errorPage: (key: ErrorPageMessageKey) => string;
     /**
      * Resuelve una clave propia del gestor por ruta con puntos
      * (p. ej. `t.app('usuarios.modal.deactivate.title')`). Si falta, devuelve la
@@ -2545,27 +2579,10 @@ export declare const commonErrorsPt: Record<string, string>;
 
 export declare type ConfidenceColors = typeof confidenceColors;
 
-/**
- * Colores de un badge de confianza/score por nivel. `bg` = fondo del badge;
- * `on` = texto. (Score de IA, relevancia, etc.)
- */
-export declare const confidenceColors: {
-    /** Alto, ≥85% (verde). */
-    readonly high: {
-        readonly bg: "#D7F5DD";
-        readonly on: "#0D5B2B";
-    };
-    /** Medio, 70–84% (ámbar). */
-    readonly medium: {
-        readonly bg: "#FFF0C8";
-        readonly on: "#6B4D00";
-    };
-    /** Bajo, <70% (gris). */
-    readonly low: {
-        readonly bg: "#E7E8EE";
-        readonly on: "#43474E";
-    };
-};
+export declare const confidenceColors: Record<"high" | "medium" | "low", {
+    bg: string;
+    on: string;
+}>;
 
 /**
  * Contribución a actualizar (POST /contributions/edit).
@@ -2603,6 +2620,90 @@ export declare interface ContributionsInsertCrmResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** Acción del editor sobre una oportunidad (POST /copilot/actions). */
+export declare type CopilotAction = 'save' | 'like' | 'dislike' | 'assign';
+
+/** Datos según la acción ejecutada (el backend lo omite si está vacío). */
+export declare interface CopilotActionData {
+    /** Acción `save` (bookmark, toggle). */
+    is_followed?: boolean;
+    /** Acciones `like` / `dislike`. */
+    interest_signal?: string;
+    /** Acción `assign`. */
+    assigned_to?: string;
+}
+
+/** Entrada de POST /copilot/actions. */
+export declare interface CopilotActionInput {
+    action: CopilotAction;
+    /** ID de la oportunidad sobre la que se acciona. */
+    opportunityId: string;
+    /**
+     * ID opaco y estable del redactor a asignar (NO el username).
+     * Obligatorio solo para `action = "assign"` (error 030.005 si falta).
+     */
+    userExternalId?: string;
+}
+
+/** Cuerpo de la respuesta de POST /copilot/actions. */
+export declare interface CopilotActionResponse extends CmsResponse {
+    copilotEnabled?: boolean;
+    action?: CopilotAction;
+    opportunity_id?: string;
+    /** Código de resultado devuelto por el microservicio (omitido si es nulo). */
+    code?: string;
+    data?: CopilotActionData;
+}
+
+/** Filtros opcionales de POST /copilot/opportunities (passthrough al micro). */
+export declare interface CopilotOpportunitiesFilters {
+    /** Filtro de estado de las oportunidades (p. ej. "open"). */
+    status?: CopilotOpportunityStatus;
+    /** Cantidad máxima de oportunidades a devolver. */
+    limit?: number;
+}
+
+/**
+ * Cuerpo de la respuesta de POST /copilot/opportunities.
+ *
+ * Si la publicación no tiene `KUNDERA_SITE_UUID` (Copilot desactivado) el CMS
+ * responde `status:"ok"` con `copilotEnabled:false` y lista vacía: NO es un
+ * error, el gestor decide qué mostrar.
+ */
+export declare interface CopilotOpportunitiesResponse extends CmsResponse {
+    copilotEnabled?: boolean;
+    /** UUID del sitio en Kundera (solo si `copilotEnabled = true`). */
+    site_uuid?: string;
+    count?: number;
+    opportunities?: CopilotOpportunity[];
+}
+
+/**
+ * Oportunidad editorial del feed de Copilot.
+ *
+ * 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.
+ */
+export declare interface CopilotOpportunity {
+    id?: string;
+    title: string;
+    /** Tema/categoría. */
+    topic?: string;
+    status: CopilotOpportunityStatus;
+    /** Puntaje (el backend lo omite si es nulo). */
+    score?: number;
+    /** Fecha de creación (ISO 8601, p. ej. "2026-06-26T10:15:00Z"). */
+    created_at?: 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
+ * cuando el microservicio agregue estados nuevos.
+ */
+export declare type CopilotOpportunityStatus = 'open' | (string & {});
+
 /** POST /dashboard/countNotificatio */
 export declare interface CountNotificationsResponse {
     status: string;
@@ -2817,6 +2918,29 @@ 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>;
+
 export declare const enMessages: {
     readonly navigation: {
         readonly COMMENTS: "Comments";
@@ -2874,6 +2998,13 @@ export declare const enMessages: {
         readonly preview: "Preview";
         readonly help: "Help";
         readonly publication: "Publication";
+        readonly appearance: "Appearance";
+        readonly newTheme: "New theme";
+        readonly newThemeSubtitle: "Redesigned interface";
+        readonly modeLabel: "Mode";
+        readonly modeLight: "Light";
+        readonly modeDark: "Dark";
+        readonly classicUnavailable: "The classic view is not available in this prototype.";
     };
     readonly newMenu: {
         readonly frequentsTitle: "Frequent";
@@ -2919,6 +3050,15 @@ export declare const enMessages: {
         readonly assignedYesterday: "Assigned yesterday";
         readonly assignedOn: "Assigned on";
         readonly expires: "Due";
+        readonly editorialOpportunityLabel: "Editorial opportunity";
+        readonly editorialOpportunityText: "{count} topics require your attention";
+        readonly editorialOpportunityTop: "Top";
+        readonly editorialOpportunityMatch: "Match";
+        readonly editorialOpportunityTrending: "Trending";
+        readonly editorialOpportunitySeeMoreOpportunities: "See {count} more opportunities";
+        readonly editorialOpportunityHide: "Hide";
+        readonly editorialOpportunityRemindLater: "Remind me later";
+        readonly editorialOpportunitySeeMore: "See more";
     };
     readonly search: {
         readonly placeholder: "Search…";
@@ -3001,8 +3141,22 @@ export declare const enMessages: {
         readonly alt: "User avatar";
         readonly unknownUser: "Unknown user";
     };
+    readonly errorPage: {
+        readonly homeButton: "Home";
+        readonly notFoundTitle: "Sorry an error occurred.";
+        readonly notFoundSubtitle: "This website is no longer available. Keep browsing!";
+        readonly notFoundCode: "404";
+        readonly errorLabel: "Error";
+        readonly copyDetail: "Copy detail.";
+        readonly copyDetailText: "The route {url} you are trying to access is no longer available.";
+        readonly copied: "Text copied to clipboard!";
+        readonly notAllowedTitle: "Sorry.\nYou do not have access.";
+        readonly notAllowedSubtitle: "What you want to see is restricted by permissions. Keep browsing!";
+    };
 };
 
+declare type ErrorPageMessageKey = keyof CmsMessages['errorPage'];
+
 export declare const esMessages: {
     navigation: {
         COMMENTS: string;
@@ -3060,6 +3214,13 @@ export declare const esMessages: {
         preview: string;
         help: string;
         publication: string;
+        appearance: string;
+        newTheme: string;
+        newThemeSubtitle: string;
+        modeLabel: string;
+        modeLight: string;
+        modeDark: string;
+        classicUnavailable: string;
     };
     newMenu: {
         frequentsTitle: string;
@@ -3105,6 +3266,15 @@ export declare const esMessages: {
         assignedYesterday: string;
         assignedOn: string;
         expires: string;
+        editorialOpportunityLabel: string;
+        editorialOpportunityText: string;
+        editorialOpportunityTop: string;
+        editorialOpportunityMatch: string;
+        editorialOpportunityTrending: string;
+        editorialOpportunitySeeMoreOpportunities: string;
+        editorialOpportunityHide: string;
+        editorialOpportunityRemindLater: string;
+        editorialOpportunitySeeMore: string;
     };
     search: {
         placeholder: string;
@@ -3187,6 +3357,18 @@ export declare const esMessages: {
         alt: string;
         unknownUser: string;
     };
+    errorPage: {
+        homeButton: string;
+        notFoundTitle: string;
+        notFoundSubtitle: string;
+        notFoundCode: string;
+        errorLabel: string;
+        copyDetail: string;
+        copyDetailText: string;
+        copied: string;
+        notAllowedTitle: string;
+        notAllowedSubtitle: string;
+    };
 };
 
 /** Cuerpo de la respuesta de POST /events/create. */
@@ -3258,8 +3440,8 @@ export declare type FeedbackBadgeColors = typeof feedbackBadgeColors;
 
 /**
  * Colores del círculo de ícono del toast por severidad. `bg` = fondo del
- * círculo; `on` = color del ícono. Contenedores tonales claros con ícono
- * oscuro (misma familia que Material 3), legibles sobre la superficie oscura.
+ * círculo; `on` = color del ícono. Como el toast es oscuro en ambos modos,
+ * estos tampoco cambian.
  */
 export declare const feedbackBadgeColors: {
     /** Éxito: círculo verde menta con check verde oscuro. */
@@ -3290,8 +3472,8 @@ export declare type FeedbackColors = typeof feedbackColors;
  * Colores de feedback de operaciones (toasts/notificaciones).
  *
  * El toast usa una superficie oscura (estilo de diseño del CMS) con texto
- * claro y un ícono de acento por severidad. Los acentos replican los del
- * Angular legacy (`cmsmedios-ux`): éxito verde, advertencia ámbar, error rojo.
+ * claro y un ícono de acento por severidad. Como ya es un componente oscuro por
+ * diseño, NO cambia entre modos (se mantiene igual en claro y oscuro).
  */
 export declare const feedbackColors: {
     /** Fondo oscuro del toast (común a todas las severidades). */
@@ -3460,6 +3642,23 @@ export declare interface FileExplorerGetFoldersResponse extends CmsResponse {
     folders: ExplorerFolder[];
 }
 
+/**
+ * Filtra los módulos de POST /auth/modulesAvailable dejando solo los que el
+ * usuario puede ver, replicando el cruce que hace `parseModuleIntoMenu` de
+ * cmsmedios: un admin ve todo; el resto solo ve un módulo si tiene la operación
+ * `${module}_VIEW` en POST /auth/permissions. La comparación es case-insensitive.
+ *
+ * Degrada con seguridad: si `permissions` es null/undefined (p. ej. porque
+ * /auth/permissions falló), NO filtra y devuelve los módulos tal cual (misma
+ * visibilidad que hoy). El acceso real lo sigue gobernando el guard de ruta
+ * (`hasModulePermission`), así que el menú puede degradar sin exponer nada.
+ *
+ * @param modules módulos crudos de POST /auth/modulesAvailable
+ * @param permissions respuesta de POST /auth/permissions (`isAdmin` + `operations`)
+ * @returns los módulos visibles para el usuario (preserva `isnew`)
+ */
+export declare function filterModulesByPermissions(modules: NavItemPermissions[], permissions: Pick<AuthPermissionsResponse, 'isAdmin' | 'operations'> | null | undefined): NavItemPermissions[];
+
 export declare function findPublicationBySlug(sites: SiteSection[], slug: string): Publication | undefined;
 
 export declare function findPublicationLabel(sites: SiteSection[], publicationId: string): string;
@@ -3467,8 +3666,7 @@ export declare function findPublicationLabel(sites: SiteSection[], publicationId
 /**
  * Familias tipográficas del CMS. `roboto` = texto general (default del theme);
  * `productSans` = marca / títulos. Las `@font-face` que las cargan viven en
- * `theme/fonts.ts` y se inyectan vía el provider MUI. Usar estas variables en
- * lugar de strings sueltos (mismo criterio que con los colores).
+ * `theme/fonts.ts` y se inyectan vía el provider MUI.
  */
 export declare const fontFamilies: {
     readonly roboto: "\"Roboto\",\"Helvetica\",\"Arial\",sans-serif";
@@ -3504,6 +3702,15 @@ 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;
@@ -3518,6 +3725,19 @@ export declare function getProfileDisplayName(profile: ProfileGetResponse): stri
  */
 export declare function getSiteNow(gmtRedaction: string | null | undefined, localeTag: string, options?: Intl.DateTimeFormatOptions): string;
 
+/**
+ * Decide si el usuario puede acceder a un módulo, replicando el
+ * `AccessPermissionsGuard` de cmsmedios: un admin siempre pasa, el comodín
+ * `All_VIEWS` siempre pasa, y en el resto el usuario debe tener una operación
+ * cuyo `name` coincida con el permiso requerido. La comparación es
+ * case-insensitive (cmsmedios pasa el permiso de la ruta a mayúsculas).
+ *
+ * @param permissions respuesta de POST /auth/permissions (`isAdmin` + `operations`)
+ * @param requiredPermission permiso que exige la ruta (p. ej. `'NEWS_VIEW'`)
+ * @returns `true` si tiene acceso; `false` si debería redirigirse a `/not-allowed`
+ */
+export declare function hasModulePermission(permissions: Pick<AuthPermissionsResponse, 'isAdmin' | 'operations'> | null | undefined, requiredPermission: string): boolean;
+
 declare interface IAudiosServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -3557,6 +3777,11 @@ declare interface IContributionsServices {
     authentication: Authentication;
 }
 
+declare interface ICopilotServices {
+    axiosApi: AxiosInstance;
+    authentication: Authentication;
+}
+
 declare interface IDashboardServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -3831,7 +4056,7 @@ export declare type InterestColors = typeof interestColors;
 
 /**
  * Feedback de interés del usuario sobre un ítem (me gusta / no me gusta).
- * Tonos semánticos; los fondos de hover se derivan con `alpha()` en el `sx`.
+ * Se mantienen literales (se usan con `alpha()` para los hovers).
  */
 export declare const interestColors: {
     /** Me gusta (verde). */
@@ -3911,9 +4136,9 @@ declare interface ITagsServices {
     authentication: Authentication;
 }
 
-export declare const ITEM_DEFAULT_BG: "#FFFFFF";
+export declare const ITEM_DEFAULT_BG: string;
 
-export declare const ITEM_HOVER_BG: "#D8E2FF";
+export declare const ITEM_HOVER_BG: string;
 
 declare interface ITranscribeServices {
     axiosApi: AxiosInstance;
@@ -3990,7 +4215,7 @@ export declare type Locale = (typeof SUPPORTED_LOCALES)[number];
 
 export declare type LocaleCatalog = Record<Locale, CmsMessages>;
 
-export declare const MENU_BG: "#ECEDF6";
+export declare const MENU_BG: string;
 
 declare type MenuOrigin = {
     vertical: 'top' | 'center' | 'bottom';
@@ -4581,29 +4806,23 @@ export declare interface NotificationAdminConfigurationResponse extends CmsRespo
 
 export declare type NotificationColors = typeof notificationColors;
 
-/**
- * Colores del avatar de ícono de cada tarjeta del centro de notificaciones
- * (campanita del TopBar). `bg` = fondo del contenedor cuadrado; `on` =
- * color del ícono. Replican los del centro de notificaciones del diseño
- * (mockup "Gestión de Noticias"): temas asignados en azul (misma familia
- * secundaria), actividades por vencer en naranja y notificaciones de sistema
- * (videos) en verde. Semánticos y reutilizables por cualquier gestor.
- */
 export declare const notificationColors: {
-    /** Temas asignados (azul): mismo contenedor secundario que los chips activos. */
-    readonly assigned: {
-        readonly bg: "#D8E2FF";
-        readonly on: "#2C4678";
-    };
-    /** Actividades por vencer (naranja). El `on` se reutiliza para la fecha de vencimiento. */
     readonly pending: {
-        readonly bg: "#FFE2D5";
-        readonly on: "#B3300A";
+        bg: string;
+        on: string;
     };
-    /** Notificaciones del sistema / videos (verde). */
     readonly system: {
-        readonly bg: "#DCEFE0";
-        readonly on: "#11663B";
+        bg: string;
+        on: string;
+    };
+    readonly editorialOpportunity: {
+        bg: string;
+        on: string;
+    };
+    /** Temas asignados (azul): mismo contenedor secundario que los chips activos. */
+    readonly assigned: {
+        readonly bg: string;
+        readonly on: string;
     };
 };
 
@@ -4649,7 +4868,7 @@ export declare interface NotificationsListResponse {
     total?: number;
 }
 
-export declare function NotificationsMenu({ unreadCount, notificationsData, masterBaseUrl, currentPublicationId, gmtRedaction, }: NotificationsMenuProps): JSX.Element;
+export declare function NotificationsMenu({ unreadCount, notificationsData, masterBaseUrl, currentPublicationId, gmtRedaction, editorialOpportunities, showEditorialOpportunities, copilotSuggestionsHref, onEditorialSeeMore, }: NotificationsMenuProps): JSX.Element;
 
 export declare type NotificationsMenuMessageKey = keyof CmsMessages['notificationsMenu'];
 
@@ -4664,6 +4883,22 @@ export declare type NotificationsMenuProps = {
     currentPublicationId?: number | string;
     /** 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.
+     */
+    copilotSuggestionsHref?: string;
+    /** Clic en "Ver más" cuando no hay `copilotSuggestionsHref` (fallback). */
+    onEditorialSeeMore?: () => void;
 };
 
 /** Topic devuelto por notification/topics (`{ name, description }`). */
@@ -5619,6 +5854,13 @@ export declare const ptMessages: {
         preview: string;
         help: string;
         publication: string;
+        appearance: string;
+        newTheme: string;
+        newThemeSubtitle: string;
+        modeLabel: string;
+        modeLight: string;
+        modeDark: string;
+        classicUnavailable: string;
     };
     newMenu: {
         frequentsTitle: string;
@@ -5664,6 +5906,15 @@ export declare const ptMessages: {
         assignedYesterday: string;
         assignedOn: string;
         expires: string;
+        editorialOpportunityLabel: string;
+        editorialOpportunityText: string;
+        editorialOpportunityTop: string;
+        editorialOpportunityMatch: string;
+        editorialOpportunityTrending: string;
+        editorialOpportunitySeeMoreOpportunities: string;
+        editorialOpportunityHide: string;
+        editorialOpportunityRemindLater: string;
+        editorialOpportunitySeeMore: string;
     };
     search: {
         placeholder: string;
@@ -5746,6 +5997,18 @@ export declare const ptMessages: {
         alt: string;
         unknownUser: string;
     };
+    errorPage: {
+        homeButton: string;
+        notFoundTitle: string;
+        notFoundSubtitle: string;
+        notFoundCode: string;
+        errorLabel: string;
+        copyDetail: string;
+        copyDetailText: string;
+        copied: string;
+        notAllowedTitle: string;
+        notAllowedSubtitle: string;
+    };
 };
 
 /** Publicación devuelta por POST /publications/get y POST /publications/default */
@@ -6339,52 +6602,14 @@ export declare const sizes: {
 
 export declare type SourceColors = typeof sourceColors;
 
-/**
- * Colores de marca por fuente de origen (puntos/indicadores de fuente en
- * filtros y chips). **Valores placeholder**: ajustar a los oficiales cuando se
- * definan. Semánticos y reutilizables por cualquier gestor.
- */
-export declare const sourceColors: {
-    /** RSS (naranja). */
-    readonly rss: "#FB923C";
-    /** Google Trends (azul). */
-    readonly gtrends: "#4285F4";
-    /** Search Console (verde). */
-    readonly sconsole: "#0F9D58";
-    /** X / Twitter (negro). */
-    readonly x: "#111111";
-};
+export declare const sourceColors: Record<"rss" | "gtrends" | "sconsole" | "x", string>;
 
 export declare type StateColors = typeof stateColors;
 
-/**
- * Colores de estado editorial para los chips de estado en listados de
- * contenido (sugerencias de CoPilot, noticias, etc.). `bg` = contenedor;
- * `on` = texto/ícono sobre el contenedor. Semánticos y reutilizables por
- * cualquier gestor (no atados a un componente puntual).
- */
-export declare const stateColors: {
-    /** Activo / publicado (verde). */
-    readonly active: {
-        readonly bg: "#D6F4DE";
-        readonly on: "#1D6B2E";
-    };
-    /** Generando con IA (azul Bluestack tonal). */
-    readonly generating: {
-        readonly bg: "#DCE3FF";
-        readonly on: "#001551";
-    };
-    /** Asignado / en redacción (púrpura, distinto de la familia IA). */
-    readonly assigned: {
-        readonly bg: "#EADDFF";
-        readonly on: "#4F378A";
-    };
-    /** Descartado / archivado (neutral). */
-    readonly discarded: {
-        readonly bg: "#ECEDF6";
-        readonly on: "#43474E";
-    };
-};
+export declare const stateColors: Record<"active" | "generating" | "assigned" | "discarded", {
+    bg: string;
+    on: string;
+}>;
 
 /**
  * Arma y envía el formulario POST que abre una ruta del admin viejo en una
@@ -6652,7 +6877,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, 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, 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 type TopBarMessageKey = keyof CmsMessages['topBar'];
 
@@ -6664,6 +6889,14 @@ 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). */
+    copilotSuggestionsHref?: string;
+    /** Clic en "Ver más" cuando no hay `copilotSuggestionsHref` (fallback). */
+    onEditorialSeeMore?: () => void;
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
@@ -6712,6 +6945,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.
  *
@@ -7135,23 +7390,10 @@ export declare type UserStatusAction = 'activate' | 'deactivate';
 
 export declare type UserStatusColors = typeof userStatusColors;
 
-/**
- * Colores del chip de estado de cuenta de usuario (activo / inactivo).
- * `bg` = contenedor; `on` = texto e ícono sobre el contenedor. El texto/ícono
- * es el mismo verde oscuro en ambos estados. Semánticos y reutilizables.
- */
-export declare const userStatusColors: {
-    /** Activo: contenedor verde menta. */
-    readonly active: {
-        readonly bg: "#92F7B7";
-        readonly on: "#002112";
-    };
-    /** Inactivo: contenedor neutro. */
-    readonly inactive: {
-        readonly bg: "#E1E2E9";
-        readonly on: "#002112";
-    };
-};
+export declare const userStatusColors: Record<"active" | "inactive", {
+    bg: string;
+    on: string;
+}>;
 
 /** Video del CMS. La forma exacta depende del recurso y del formato pedido. */
 export declare interface Video {