sass-cms-template-common 0.0.12 → 0.0.14

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;
@@ -494,6 +492,22 @@ export declare interface CkeditorPrompt {
     [key: string]: unknown;
 }
 
+export declare interface ClassifiedNetworkError {
+    errorCode: NetworkErrorCode;
+    /** Si conviene reintentar la petición. */
+    retryable: boolean;
+    /** Mensaje crudo del error original (para el detalle copiable del toast). */
+    error: string;
+}
+
+/**
+ * Clasifica una excepción (error de axios en el servidor, o `TypeError:
+ * Failed to fetch` del navegador al invocar un server action) como error de
+ * red/servidor. Devuelve `null` si NO es un error de red (p. ej. un 4xx o una
+ * excepción de lógica): el caller lo trata entonces como error de negocio.
+ */
+export declare function classifyNetworkError(error: unknown): ClassifiedNetworkError | null;
+
 /**
  * Contenedor de "Búsqueda avanzada" reutilizable y declarativo. Recibe una lista
  * de `fields` y los renderiza en una grilla, manejando el estado del formulario
@@ -727,6 +741,8 @@ export declare const cmsColors: {
     readonly primary: string;
     readonly primaryHover: string;
     readonly primaryDisabled: string;
+    readonly kundera: string;
+    readonly kunderaHover: string;
     readonly secondary: string;
     readonly secondaryHover: string;
     readonly onSecondaryContainer: string;
@@ -734,6 +750,9 @@ export declare const cmsColors: {
     readonly controlBorder: string;
     readonly controlText: string;
     readonly controlHoverBg: string;
+    readonly searchHoverBg: string;
+    readonly searchFocusBg: string;
+    readonly searchClearHoverBg: string;
     readonly whiteBtnBorder: string;
     readonly whiteBtnText: string;
     readonly iconButtonHoverBg: string;
@@ -745,6 +764,11 @@ export declare const cmsColors: {
     readonly alphabetIdleSoft: string;
     readonly alphabetLetter: string;
     readonly alphabetLetterDisabled: string;
+    readonly rowHover: string;
+    readonly neutralHover: string;
+    readonly onPrimaryStateLayer: string;
+    readonly actionIcon: string;
+    readonly actionIconHover: string;
     readonly textStrong: string;
     readonly textNav: string;
     readonly textMuted: string;
@@ -755,6 +779,9 @@ export declare const cmsColors: {
     readonly border: string;
     readonly avatarBg: string;
     readonly avatarBorder: string;
+    readonly avatarInactiveBg: string;
+    readonly avatarInactiveIcon: string;
+    readonly tooltipSurface: string;
     readonly surface: string;
 };
 
@@ -880,10 +907,10 @@ export declare type CmsConfirmDialogProps = {
     icon?: ReactNode;
     /** Color de acento del badge del ícono. Por defecto el texto de navegación. */
     iconColor?: string;
-    /** Título opcional. Product Sans 32/400. Admite `\n` para saltos de línea. */
+    /** Título opcional. M3 title-large (Google Sans 500 22/28). Admite `\n` para saltos de línea. */
     title?: ReactNode;
     /**
-     * Descripción opcional. Roboto 14/400. Puede incluir negrita (`<b>`/`<strong>`)
+     * Descripción opcional. Google Sans 14/400. Puede incluir negrita (`<b>`/`<strong>`)
      * y enlaces (`<a>`); ambos se estilan según el diseño.
      */
     description?: ReactNode;
@@ -981,6 +1008,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>;
 }
 
 /**
@@ -1064,6 +1098,24 @@ export declare type CmsDialogActionsProps = {
     testId?: string;
 };
 
+/**
+ * Bloque de "sin resultados" para listados y tablas: icono + título + subtítulo,
+ * centrado. Presentacional; los textos vienen por props (i18n del gestor).
+ * Replica el estado vacío del CMS Angular legacy.
+ */
+export declare function CmsEmptyState({ title, description, icon, testId, }: CmsEmptyStateProps): JSX.Element;
+
+export declare type CmsEmptyStateProps = {
+    /** Título principal (ya traducido). */
+    title: string;
+    /** Subtítulo / ayuda opcional (ya traducido). */
+    description?: string;
+    /** Icono a mostrar. Por defecto `search_off` (SearchOffOutlined). */
+    icon?: ReactNode;
+    /** Base para los `data-testid` (p. ej. `panel-users-empty`). */
+    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
@@ -1134,15 +1186,54 @@ export declare class CmsFileExplorerServices {
 }
 
 /**
- * Inyecta los `@font-face` de Roboto y Product Sans como estilos globales.
- * Va montado dentro de los providers MUI de la lib, así cada gestor que los use
- * tiene las fuentes disponibles sin configurar nada.
+ * Barra de filtros activos: aparece bajo la toolbar del listado con el label
+ * "Filtros:", un chip removible por cada filtro aplicado y un botón
+ * "Limpiar todo". Presentacional y controlado: los chips y los callbacks los
+ * arma el gestor (dominio del producto); la lib solo aporta la estética común.
+ *
+ * No renderiza nada si no hay chips activos.
+ */
+export declare function CmsFilterBar({ label, chips, onClearAll, clearAllLabel, testId, }: CmsFilterBarProps): JSX.Element | null;
+
+export declare type CmsFilterBarProps = {
+    /** Texto del prefijo (p. ej. "Filtros:"). */
+    label: string;
+    /** Chips de filtros activos. Si está vacío, la barra no se renderiza. */
+    chips: CmsFilterChip[];
+    /** Callback de "Limpiar todo" (limpia todos los filtros). Si se omite, no se muestra. */
+    onClearAll?: () => void;
+    /** Texto del botón "Limpiar todo" (ya traducido). */
+    clearAllLabel?: string;
+    /** `data-testid` base de la barra. */
+    testId?: string;
+};
+
+/** Chip de un filtro activo dentro del `CmsFilterBar`. */
+export declare type CmsFilterChip = {
+    /** Id estable del chip (para la key y el `data-testid`). */
+    id: string;
+    /** Texto o nodo a mostrar (ya traducido / formateado). */
+    label: ReactNode;
+    /** Icono opcional a la izquierda del label (p. ej. `search`). */
+    icon?: ReactNode;
+    /** Callback al quitar este filtro (clic en la X del chip). */
+    onRemove: () => void;
+    /** `aria-label` de la X del chip. */
+    removeAriaLabel?: string;
+    /** `data-testid` base del chip (la X será `${testId}-icon-btn-remove`). */
+    testId?: string;
+};
+
+/**
+ * Inyecta los `@font-face` de Google Sans (fuente única del CMS) como estilos
+ * globales. Va montado dentro de los providers MUI de la lib, así cada gestor que
+ * los use tiene la fuente disponible sin configurar nada.
  */
 export declare function CmsFontFaces(): JSX.Element;
 
 /**
- * Reglas `@font-face` de todas las fuentes del CMS, listas para inyectarse como
- * estilos globales (ver el componente `CmsFontFaces`).
+ * Reglas `@font-face` de Google Sans, listas para inyectarse como estilos
+ * globales (ver el componente `CmsFontFaces`).
  */
 export declare const cmsFontFaces: string;
 
@@ -1290,6 +1381,68 @@ export declare type CmsMultiSelectFieldProps = {
     testId?: string;
 };
 
+export declare const CmsNetworkContext: Context<CmsNetworkContextValue | null>;
+
+export declare interface CmsNetworkContextValue {
+    /** Estado actual de la conexión. */
+    status: CmsNetworkState;
+    /** Atajo: `status === 'online'`. */
+    isOnline: boolean;
+    /**
+     * Promesa que resuelve cuando la conexión vuelve a `online`. Si ya está
+     * online, resuelve al instante. La usa el reintento para "retomar el llamado"
+     * cuando vuelve internet.
+     */
+    waitForOnline: () => Promise<void>;
+    /**
+     * Fuerza una verificación por ping (útil cuando una petición falló por red
+     * pero `navigator.onLine` todavía dice `true`).
+     */
+    verifyConnectivity: () => void;
+}
+
+/**
+ * Provee el estado de conectividad a toda la app y una promesa `waitForOnline`
+ * para reanudar peticiones al recuperar internet.
+ *
+ * Replica el `NetworkService` del Angular legacy: combina `navigator.onLine`,
+ * los eventos `window` `online`/`offline` y un **ping activo con polling** que
+ * confirma la reconexión real (los eventos del navegador a veces mienten).
+ *
+ * El mecanismo vive en la lib; el **disparo** de toasts lo hace
+ * `CmsNetworkToaster` (globales) y `useResilientAction` (por petición).
+ */
+export declare function CmsNetworkProvider({ children, pingUrl, pingIntervalMs, }: CmsNetworkProviderProps): JSX.Element;
+
+export declare interface CmsNetworkProviderProps {
+    children: ReactNode;
+    /**
+     * URL de ping para confirmar conectividad real (además de los eventos del
+     * navegador). Debe responder rápido a un `GET` sin CORS. `null` desactiva el
+     * ping y deja solo los eventos `online`/`offline`. Default: endpoint 204 de
+     * Google (mismo que usa el Angular legacy).
+     */
+    pingUrl?: string | null;
+    /** Intervalo del polling de ping mientras siga offline (ms). Default 5000. */
+    pingIntervalMs?: number;
+}
+
+/** Estado de conectividad del navegador. */
+export declare type CmsNetworkState = 'online' | 'offline';
+
+/**
+ * Componente sin UI que observa el estado de conexión y dispara los toasts
+ * globales, replicando el Angular legacy:
+ *
+ * - Al perder internet → toast de error "sin conexión" (no se autocierra).
+ * - Al recuperarla → cierra el anterior y muestra "conexión restablecida".
+ *
+ * Se monta una sola vez, dentro de `CmsNetworkProvider` + `CmsToastProvider`.
+ * El reintento y "reanudar el llamado" por acción los maneja
+ * `useResilientAction`.
+ */
+export declare function CmsNetworkToaster(): null;
+
 /**
  * Servicios HTTP del módulo `news` del CMS (core + publish, unpublish, pin,
  * massive, freshness, views y analytics).
@@ -2121,6 +2274,7 @@ export declare type CmsTranslator = {
         count?: number;
     }) => string;
     toast: (key: ToastMessageKey) => string;
+    network: (key: NetworkMessageKey) => string;
     userAvatar: (key: UserAvatarMessageKey) => string;
     errorPage: (key: ErrorPageMessageKey) => string;
     /**
@@ -2683,7 +2837,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;
@@ -2695,8 +2850,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
@@ -2704,6 +2874,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;
@@ -2744,10 +2926,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. */
@@ -2792,6 +2996,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. */
@@ -2842,6 +3048,9 @@ export declare const DEFAULT_PREVIEW_FORMATS: PreviewFormat[];
 
 export declare const DEFAULT_SITE_ID = "bluestack-es";
 
+/** Preferencia por defecto (sin nada guardado): tema nuevo activo, modo claro. */
+export declare const DEFAULT_THEME_PREFERENCE: ThemePreference;
+
 export declare const DefaultCmsLink: ForwardRefExoticComponent<AnchorHTMLAttributes<HTMLAnchorElement> & {
 href: string;
 children?: ReactNode;
@@ -2918,25 +3127,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>;
@@ -3137,6 +3327,11 @@ export declare const enMessages: {
         readonly defaultWarning: "Please review the request.";
         readonly defaultInfo: "Information";
     };
+    readonly network: {
+        readonly disconnected: "No connection. Check your network or Wi-Fi status. We will retry when the connection is restored.";
+        readonly retrying: "Retrying requests.";
+        readonly restored: "Connection restored.";
+    };
     readonly userAvatar: {
         readonly alt: "User avatar";
         readonly unknownUser: "Unknown user";
@@ -3353,6 +3548,11 @@ export declare const esMessages: {
         defaultWarning: string;
         defaultInfo: string;
     };
+    network: {
+        disconnected: string;
+        retrying: string;
+        restored: string;
+    };
     userAvatar: {
         alt: string;
         unknownUser: string;
@@ -3606,16 +3806,17 @@ export declare const fieldStyles: {
      */
     sxAutocompleteListbox: SxProps<Theme>;
     /**
-     * Paper del menú de `CmsSelectField`. Con padding propio para que las opciones
-     * queden "embutidas" (hay aire entre el borde del contenedor y el resaltado de
-     * cada opción), igual que el diseño de referencia.
+     * Paper del menú de `CmsSelectField`. Menú M3 común a todos los desplegables:
+     * fondo `menuSurface` (#ECEDF6), sin padding lateral (ítems de borde a borde) y
+     * 8px arriba/abajo; `overflow: hidden` recorta las esquinas del hover.
      */
     sxSelectMenuPaper: SxProps<Theme>;
-    /** Lista del menú del select (sin padding; el aire lo pone el paper). */
+    /** Lista del menú del select (sin padding ni gap: los ítems van full-bleed). */
     sxSelectList: SxProps<Theme>;
     /**
-     * Opción del menú del select: redondeada, hover en `secondaryHover`, activa en
-     * `secondary` (y su hover también `secondaryHover`). El check va a la derecha.
+     * Opción del menú del select: full-bleed (sin radio), hover en `neutralHover`
+     * (state layer M3 `onSurface` al 8%, #191C20), activa en `secondary`. El check
+     * va a la derecha.
      */
     sxSelectItem: SxProps<Theme>;
     /** Check de la opción activa del select. */
@@ -3664,14 +3865,13 @@ export declare function findPublicationBySlug(sites: SiteSection[], slug: string
 export declare function findPublicationLabel(sites: SiteSection[], publicationId: string): string;
 
 /**
- * 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.
+ * Familias tipográficas del CMS. `googleSans` = fuente única de todo el CMS
+ * (texto, marca y títulos); reemplaza a Roboto y Product Sans. La `@font-face`
+ * que la carga vive en `theme/fonts.ts` y se inyecta vía el provider MUI.
  */
 export declare const fontFamilies: {
-    readonly roboto: "\"Roboto\",\"Helvetica\",\"Arial\",sans-serif";
-    readonly productSans: "\"Product Sans\",\"Roboto\",\"Helvetica\",\"Arial\",sans-serif";
-    /** Monoespaciada (url del toast de error, fragmentos de código). */
+    readonly googleSans: "\"Google Sans\",\"Helvetica\",\"Arial\",sans-serif";
+    /** Monoespaciada (url del toast de error, fragmentos de código). No es de marca. */
     readonly mono: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
 };
 
@@ -3699,17 +3899,19 @@ export declare function getCommonError(errorCode: string | number | Array<string
 
 export declare function getDefaultPublicationSlug(sites: SiteSection[]): string;
 
+/** Modo efectivo aplicado al sitio a partir de la preferencia. */
+export declare function getEffectiveThemeMode(pref: ThemePreference): ThemeMode;
+
 /** 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.
+ * Si un resultado ya devuelto por un server action es un envelope de error con
+ * un código de red (`{ status: 'error', errorCode: 'net.*' }`), devuelve ese
+ * código; si no, `null`. Permite reintentar cuando el fallo de red se detectó
+ * en el servidor (Next→OpenCms) y viajó como `CmsResponse`.
  */
-export declare function getMockCopilotOpportunities(now: number): EditorialOpportunity[];
+export declare function getNetworkErrorCodeFromResult(result: unknown): NetworkErrorCode | null;
 
 export declare function getProfileAvatarSrc(profile: ProfileGetResponse, options?: ProfileAvatarOptions): string;
 
@@ -4115,6 +4317,9 @@ declare interface ISitesServices {
     authentication: Authentication;
 }
 
+/** `true` si el código dado es uno de los códigos internos de red. */
+export declare function isNetworkErrorCode(code: string | null | undefined): boolean;
+
 /**
  * Decide si un ítem es visible según los permisos de operación del usuario.
  *
@@ -4131,6 +4336,9 @@ declare interface ISitesServices {
  */
 export declare function isNewContentItemVisible(item: NewContentItem, operationPermissions: string[] | undefined, isAdmin: boolean | undefined): boolean;
 
+/** `true` si un código de red debe reintentarse. */
+export declare function isRetryableNetworkCode(code: string | null | undefined): boolean;
+
 declare interface ITagsServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -4265,8 +4473,30 @@ export declare type NavLinkItem = {
     accent?: 'ai';
     /** Si el href apunta al admin legacy (JSP/Angular), se prefija con `legacyBaseUrl`. */
     legacy?: boolean;
+    /**
+     * Si la ruta del Angular master exige el id de publicación al final
+     * (p. ej. `/admin/tags/:idPub`, `/admin/planning/:idPub`), se le agrega
+     * `selectedPublicationId`. Solo aplica junto con `legacy`.
+     */
+    appendPublicationId?: boolean;
+};
+
+/** Códigos internos de error de red/servidor (no son del CMS). */
+export declare const NETWORK_ERROR_CODES: {
+    /** Sin conexión a internet (no se pudo alcanzar el servidor). */
+    readonly offline: "net.offline";
+    /** La petición excedió el timeout. */
+    readonly timeout: "net.timeout";
+    /** El backend no responde (502/503/504). */
+    readonly unavailable: "net.unavailable";
+    /** Error interno del servidor (5xx genérico). */
+    readonly server: "net.server";
 };
 
+export declare type NetworkErrorCode = (typeof NETWORK_ERROR_CODES)[keyof typeof NETWORK_ERROR_CODES];
+
+export declare type NetworkMessageKey = keyof CmsMessages['network'];
+
 /** Columna del menú "Nuevo" (Frecuentes / Otros / Videos). */
 export declare type NewContentGroup = {
     /** Clave i18n del título de la columna (namespace `newMenu`). */
@@ -4868,7 +5098,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'];
 
@@ -4884,21 +5114,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 }`). */
@@ -5993,6 +6222,11 @@ export declare const ptMessages: {
         defaultWarning: string;
         defaultInfo: string;
     };
+    network: {
+        disconnected: string;
+        retrying: string;
+        restored: string;
+    };
     userAvatar: {
         alt: string;
         unknownUser: string;
@@ -6115,6 +6349,12 @@ export declare const radii: {
     readonly pill: "999px";
 };
 
+/** Modo efectivo leído directo de `localStorage`. SSR-safe. */
+export declare function readEffectiveThemeMode(): ThemeMode;
+
+/** Lee la preferencia de `localStorage`. SSR-safe (fallback al default). */
+export declare function readThemePreference(): ThemePreference;
+
 /** Receta del CMS. La forma exacta depende del recurso y del formato pedido. */
 export declare interface Recipe {
     [key: string]: unknown;
@@ -6280,6 +6520,19 @@ export declare interface RecipesPublishCheckResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+export declare type ResilientRunner = <T>(fn: () => Promise<T>, options?: ResilientRunOptions) => Promise<T>;
+
+export declare interface ResilientRunOptions {
+    /** Servicio/endpoint (para el detalle del toast, si el resultado es error). */
+    service?: string;
+    /** Params de la llamada (para el detalle del toast). */
+    params?: Record<string, unknown>;
+    /** Máximo de reintentos con backoff (fallos de servidor/timeout). Default 3. */
+    maxRetries?: number;
+    /** Mostrar el toast "reintentando" al reanudar tras una desconexión. Default true. */
+    notifyRetry?: boolean;
+}
+
 export declare function resolveCmsAssetUrl(path: string, cmsOrigin?: string): string;
 
 export declare function resolveCmsOrigin(cmsOrigin?: string): string;
@@ -6423,13 +6676,15 @@ export declare type SelectOption = {
  * importarlo para construir un trigger/menú coherente con el sistema.
  *
  * Reglas de color (todas con variables de `variables.ts`):
- * - Trigger por defecto: borde `controlBorder` (#727784), texto `controlText`
- *   (#000) en negrita, fondo transparente; hover → `controlHoverBg` (#F9F9FF).
+ * - Trigger por defecto: borde `m3.outlineVariant` (#C4C6CF), texto `controlText`
+ *   (#000) en negrita, fondo transparente; hover → `neutralHover` (state layer
+ *   M3 `onSurface` al 8%, #191C20).
  * - Trigger activo (abierto) o resaltado (valor activo): fondo `secondary`
  *   (#D8E2FF), sin borde.
- * - Opción del menú: hover → `secondaryHover` (#E1E2EA); seleccionada →
- *   fondo `secondary` (#D8E2FF). El menú es full-bleed (sin padding lateral ni
- *   radio en los ítems): el resaltado llega de borde a borde.
+ * - Opción del menú: hover → `neutralHover` (state layer M3 `onSurface` al 8%,
+ *   #191C20); seleccionada → fondo `secondary` (#D8E2FF). El menú es full-bleed
+ *   (sin padding lateral ni radio en los ítems): el resaltado llega de borde a
+ *   borde, sobre el fondo `menuSurface` (#ECEDF6) común a todos los desplegables.
  */
 export declare const SelectStyles: {
     /**
@@ -6482,7 +6737,7 @@ export declare type SidebarProps = {
  * todo. El anclado se identifica por `item.module` y persiste vía
  * `profileServices.addPins`/`deletePins`/`getPins` (recurso de perfil).
  */
-export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, items, profileServices, }: SidebarRailProps): JSX.Element;
+export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, selectedPublicationId, items, profileServices, }: SidebarRailProps): JSX.Element;
 
 /** Servicio de pines usado por el rail: solo necesita estos tres métodos. */
 export declare type SidebarRailPinService = Pick<CmsProfileServices, 'addPins' | 'deletePins' | 'getPins'>;
@@ -6493,6 +6748,8 @@ export declare type SidebarRailProps = {
     permissions: Array<NavItemPermissions>;
     /** Dominio del admin legacy (JSP/Angular) para prefijar hrefs con `item.legacy`. */
     legacyBaseUrl?: string;
+    /** Id de publicación activa; se agrega a los ítems legacy con `appendPublicationId`. */
+    selectedPublicationId?: string;
     /** Ítems de navegación. Por defecto, `ACCOUNT_NAV_BLOCKS`. */
     items?: NavLinkItem[];
     /**
@@ -6596,8 +6853,8 @@ export declare const sizes: {
     readonly buttonHeight: 40;
     /** Alto de botones/triggers compactos (selector de sitios). */
     readonly buttonHeightSm: 34;
-    /** Alto del campo buscador (`CmsSearchField`). */
-    readonly searchHeight: 48;
+    /** Alto del campo buscador (`CmsSearchField`): igual al del filtro (`buttonHeight`). */
+    readonly searchHeight: 40;
 };
 
 export declare type SourceColors = typeof sourceColors;
@@ -6830,6 +7087,27 @@ export declare type TextFieldConfig = BaseFieldConfig & {
     type?: 'text' | 'email' | 'url';
 };
 
+/**
+ * Atributo que MUI togglea en `<html>` (coincide con `colorSchemeSelector` de
+ * `createAppTheme`). Las CSS vars `--cms-*` y `--mui-palette-*` se enganchan acá.
+ */
+export declare const THEME_COLOR_SCHEME_ATTRIBUTE = "data-mui-color-scheme";
+
+/** Clave de localStorage para el switch "Tema nuevo". */
+export declare const THEME_ENABLED_STORAGE_KEY = "cms-theme-enabled";
+
+/** Clave de localStorage para el modo deseado (`light`/`dark`). */
+export declare const THEME_MODE_STORAGE_KEY = "cms-theme-mode";
+
+export declare type ThemeMode = 'light' | 'dark';
+
+export declare type ThemePreference = {
+    /** Switch "Tema nuevo" del menú Apariencia. Off → se fuerza claro. */
+    enabled: boolean;
+    /** Modo deseado por el usuario (se recuerda aunque `enabled` esté off). */
+    mode: ThemeMode;
+};
+
 /**
  * Detalle extra que enriquece el toast de error (replica el toast de error del
  * Angular legacy: detalle copiable con url/servicio/params/versión).
@@ -6877,7 +7155,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'];
 
@@ -6889,14 +7167,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;
@@ -7211,6 +7487,11 @@ export declare interface UploadResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/**
+ * Lee el estado de conectividad. Debe usarse dentro de `<CmsNetworkProvider>`.
+ */
+export declare function useCmsNetworkStatus(): CmsNetworkContextValue;
+
 /**
  * Hook para disparar toasts. Debe usarse dentro de `CmsToastProvider`.
  */
@@ -7244,7 +7525,7 @@ export declare function useCurrentUserPhoto(): CurrentUserPhotoContextValue | nu
  * nombre y textos traducidos (es/en/pt). Reacciona al cambio de la prop `photo`;
  * para el usuario logueado, reacciona además al `CurrentUserPhotoProvider`.
  */
-export declare function UserAvatar({ photo, description, username, size, showTooltip, cmsOrigin, crossOrigin, isCurrentUser, onClick, testId, }: UserAvatarProps): JSX.Element;
+export declare function UserAvatar({ photo, description, username, size, showTooltip, inactive, cmsOrigin, crossOrigin, isCurrentUser, onClick, testId, }: UserAvatarProps): JSX.Element;
 
 export declare type UserAvatarMessageKey = keyof CmsMessages['userAvatar'];
 
@@ -7263,6 +7544,11 @@ export declare type UserAvatarProps = {
     size?: number;
     /** Muestra el tooltip con el nombre al pasar el mouse. Por defecto `true`. */
     showTooltip?: boolean;
+    /**
+     * Marca al usuario como inactivo/desactivado: el avatar cae a un gris apagado
+     * (fondo y ícono más grises). Por defecto `false`.
+     */
+    inactive?: boolean;
     /** Origen del CMS para resolver rutas relativas de la foto. */
     cmsOrigin?: string;
     /**
@@ -7282,6 +7568,31 @@ export declare type UserAvatarProps = {
     testId?: string;
 };
 
+/**
+ * Envuelve la invocación de un server action para hacerla **resiliente a la
+ * red**, replicando el comportamiento del Angular legacy:
+ *
+ * - **Sin internet (usuario offline):** no se pierde la acción. Se espera —sin
+ *   consumir reintentos— a que vuelva la conexión y entonces se **retoma el
+ *   llamado** automáticamente (muestra "reintentando…").
+ * - **Backend caído / timeout / 5xx (con internet):** reintenta con backoff
+ *   exponencial (1s, 2s, 4s, 8s) hasta `maxRetries`; luego devuelve el
+ *   resultado de error para que el caller muestre el toast.
+ * - **Error de negocio (4xx / `status:'fail'`):** no reintenta; devuelve el
+ *   resultado tal cual para que el caller decida (toast/update optimista).
+ *
+ * El toast global de "sin conexión" / "conexión restablecida" lo dispara
+ * `CmsNetworkToaster`; este hook solo añade el "reintentando…" por acción.
+ *
+ * Uso en el gestor:
+ * ```ts
+ * const run = useResilientAction();
+ * const res = await run(() => setUserStatus(slug, id, action),
+ *   { service: '/users/actions/setStatus', params: { id, action } });
+ * ```
+ */
+export declare function useResilientAction(): ResilientRunner;
+
 /** Grupo del sistema devuelto por POST /users/groups/get. */
 export declare interface UserGroup {
     id: string;
@@ -7816,6 +8127,12 @@ export declare interface WorkpaperStatusResponse extends CmsResponse {
     ediciones: WorkpaperEdition[];
 }
 
+/**
+ * Guarda la preferencia y refleja el modo efectivo en el atributo de `<html>`
+ * de una (para que el cambio se vea sin recargar). SSR-safe.
+ */
+export declare function writeThemePreference(pref: ThemePreference): void;
+
 /** Cuerpo de la respuesta de POST /videos/youtube/getThumbnails. */
 export declare interface YoutubeThumbnailsResponse extends CmsResponse {
     [key: string]: unknown;