sass-cms-template-common 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { AnchorHTMLAttributes } from 'react';
 import { AxiosInstance } from 'axios';
+import { Context } from 'react';
 import { ElementType } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { JSX } from 'react';
@@ -15,14 +16,34 @@ import { Theme } from '@mui/material/styles';
  */
 export declare const ACCOUNT_NAV_BLOCKS: NavBlock[];
 
-export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notifications, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, LinkComponent, permissions, locale, language, messages, baseUrl, }: AppShellProps): JSX.Element;
+/**
+ * Catálogo de mensajes del gestor por idioma. Cada gestor declara su propio
+ * `en` como fuente de la forma y valida `es`/`pt` con `satisfies typeof enTree`
+ * para garantizar que las tres lenguas comparten las mismas claves.
+ */
+export declare type AppLocaleCatalog = Record<Locale, AppMessages>;
+
+/**
+ * Nodo de un árbol de mensajes propio de un gestor: una hoja string o un
+ * sub-árbol anidable. Permite namespaces arbitrarios (`usuarios.*`, etc.)
+ * que la lib desconoce.
+ */
+export declare type AppMessageNode = string | {
+    [key: string]: AppMessageNode;
+};
+
+/** Á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, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
     sites: SiteSection[];
     children: ReactNode;
     notificationUnreadCount: number;
-    notifications: DashboardNotification[];
+    /** Respuesta cruda de `POST /dashboard/notification` (newsTask/expireTask/videos). */
+    notificationsData?: DashboardNotificationsResponse | null;
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
@@ -30,15 +51,40 @@ export declare type AppShellProps = {
     getPublicationHref: (publication: Publication) => string;
     resolvePublicationImageUrl?: (imagePath: string) => string;
     profileAvatarOptions?: ProfileAvatarOptions;
+    /** Dominio del CMS Angular legacy (deploy nuevo) para enlaces de perfil. */
+    legacyBaseUrl?: string;
+    /**
+     * Origen del CMS (JSP) para Ayuda/Preview. Si se omite, se usa `baseUrl`.
+     */
+    cmsBaseUrl?: string;
+    /** Sesión para el redirect al admin viejo (token, sitio, publicación, usuario). */
+    legacySession?: LegacyAdminSession;
+    /** Columnas/ítems del menú "Nuevo". Por defecto, la estructura del CMS legacy. */
+    newContentGroups?: NewContentGroup[];
+    /** Formatos del menú de previsualización. Por defecto, Desktop/Mobile/Tablet. */
+    previewFormats?: PreviewFormat[];
+    /** Operaciones concedidas al usuario (`POST /auth/permissions`). */
+    operationPermissions?: string[];
+    /** Si el usuario es administrador (ve todos los ítems del menú "Nuevo"). */
+    isAdmin?: boolean;
+    /** Fallback (sin sesión) del clic en un ítem del menú "Nuevo" (recibe su `id`). */
+    onNewContentSelect?: (itemId: string) => void;
+    /** Integración: clic en un formato de previsualización (recibe su `id`). */
+    onPreviewSelect?: (formatId: string) => void;
     LinkComponent?: CmsLinkComponent;
     permissions: Array<NavItemPermissions>;
     locale?: Locale | string;
     /** Alias de `locale`. */
     language?: Locale | string;
     messages?: CmsMessagesOverride;
+    /** Catálogo de mensajes propio del gestor (namespaces libres, es/en/pt). */
+    appMessages?: AppLocaleCatalog;
     baseUrl: string;
 };
 
+/** Traductor genérico de claves del gestor por ruta con puntos (`ns.clave`). */
+export declare type AppTranslate = (path: string, params?: TranslationParams) => string;
+
 /** Audio del VFS. Los metadatos exactos no están detallados en el doc. */
 declare interface Audio_2 {
     [key: string]: unknown;
@@ -219,6 +265,27 @@ export declare interface AuthSessionResult extends CmsResponse {
 /** Respuesta de POST /auth/setNewPassword. */
 export declare type AuthSetNewPasswordResponse = AuthSessionResult;
 
+/** Propiedades comunes a todos los campos de la configuración. */
+declare type BaseFieldConfig = {
+    /** Identificador único del campo (clave en `FieldValues`). */
+    name: string;
+    /** Etiqueta (ya traducida). Se muestra arriba del control. */
+    label?: ReactNode;
+    /** Placeholder (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control (ya traducido). */
+    hint?: ReactNode;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /**
+     * Columnas que ocupa en la grilla del modal (1, 2 o 3).
+     * En el panel lateral (drawer) siempre ocupa el ancho completo.
+     */
+    span?: 1 | 2 | 3;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Botón primario con menú desplegable integrado, en forma de píldora dividida.
  * Combina un botón principal de acción (emite `onAction`) con una flecha que
@@ -248,6 +315,22 @@ export declare type BtnDropdownProps = {
     testId?: string;
 };
 
+/**
+ * Construye el catálogo estándar de campos de "Búsqueda avanzada" del CMS con
+ * los textos por defecto de la librería (resueltos al idioma activo). Es lo que
+ * usa `CmsAdvancedSearch` cuando el consumidor no pasa `fields`.
+ *
+ * Los campos de datos (sección, categoría, creador, autor, grupos, zona) traen
+ * `options: []`: sus etiquetas/placeholder vienen traducidos de la lib, pero las
+ * opciones reales las inyecta cada gestor (son datos del backend). Los campos de
+ * enum fijo (tipo, estados, orden, prioridad, dirección) sí traen sus opciones
+ * por defecto, también traducidas.
+ *
+ * @param t - Traductor de la lib (`useCmsTranslation().t`).
+ * @returns Lista de campos lista para `CmsAdvancedSearch`.
+ */
+export declare function buildDefaultSearchFields(t: CmsTranslator): FieldConfig[];
+
 /** Filtro de POST /categories/get. */
 export declare interface CategoriesGetFilter {
     /**
@@ -305,6 +388,10 @@ export declare interface Category {
     [key: string]: unknown;
 }
 
+export declare type CheckboxFieldConfig = BaseFieldConfig & {
+    kind: 'checkbox';
+};
+
 /** Cuerpo de la respuesta de POST /ckeditor/adminConfiguration. */
 export declare interface CkeditorAdminConfigurationResponse extends CmsResponse {
     ckeditorParams?: CkeditorParams;
@@ -393,6 +480,55 @@ export declare interface CkeditorPrompt {
     [key: string]: unknown;
 }
 
+/**
+ * Contenedor de "Búsqueda avanzada" reutilizable y declarativo. Recibe una lista
+ * de `fields` y los renderiza en una grilla, manejando el estado del formulario
+ * internamente. Se presenta como modal centrado o panel lateral derecho según
+ * `variant`. El mismo componente sirve a cualquier gestor: solo cambian los
+ * campos que se le pasan.
+ */
+export declare function CmsAdvancedSearch({ open, onClose, variant, title, titleIcon, fields, initialValues, onApply, onReset, applyLabel, resetLabel, closeAriaLabel, columns, drawerWidth, testId, }: CmsAdvancedSearchProps): JSX.Element;
+
+export declare type CmsAdvancedSearchProps = {
+    /** Si el contenedor está abierto. */
+    open: boolean;
+    /** Callback al cerrar (botón X, scrim o Escape). */
+    onClose: () => void;
+    /** Modal centrado o panel lateral derecho. Por defecto `modal`. */
+    variant?: CmsAdvancedSearchVariant;
+    /** Título. Por defecto el de la lib ("Búsqueda avanzada", según idioma). */
+    title?: ReactNode;
+    /** Ícono de la cabecera. Por defecto un embudo de filtro. */
+    titleIcon?: ReactNode;
+    /**
+     * Campos a mostrar. Si se omite, usa el catálogo estándar de la lib
+     * (`buildDefaultSearchFields`) ya traducido. Cada gestor puede pasar solo los
+     * campos que necesita o partir del catálogo por defecto y ajustar opciones.
+     */
+    fields?: FieldConfig[];
+    /** Valores iniciales (al abrir se sincroniza el borrador con estos). */
+    initialValues?: FieldValues;
+    /** Callback al aplicar, con los valores del formulario. */
+    onApply: (values: FieldValues) => void;
+    /** Callback al restablecer (luego de limpiar el borrador). */
+    onReset?: () => void;
+    /** Texto del botón aplicar. Por defecto el de la lib. */
+    applyLabel?: ReactNode;
+    /** Texto del botón restablecer. Por defecto el de la lib. */
+    resetLabel?: ReactNode;
+    /** `aria-label` del botón cerrar. Por defecto el de la lib. */
+    closeAriaLabel?: string;
+    /** Columnas de la grilla en variante modal. Por defecto `3`. */
+    columns?: number;
+    /** Ancho del panel lateral. Por defecto `360`. */
+    drawerWidth?: number | string;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
+/** Presentación del contenedor de búsqueda avanzada. */
+export declare type CmsAdvancedSearchVariant = 'modal' | 'drawer';
+
 /**
  * Servicios HTTP del módulo `audios` del CMS (solo endpoints JSON POST).
  *
@@ -521,6 +657,25 @@ export declare class CmsCategoriesServices {
     testCategories: (filter?: CategoriesTestFilter) => Promise<CategoriesTestResponse>;
 }
 
+/**
+ * Checkbox con etiqueta. Activo = cuadro relleno con el color primario y check
+ * blanco (íconos por defecto de MUI, sin override). Controlado y reutilizable.
+ */
+export declare function CmsCheckboxField({ value, onChange, label, disabled, testId, }: CmsCheckboxFieldProps): JSX.Element;
+
+export declare type CmsCheckboxFieldProps = {
+    /** Estado actual (controlado). */
+    value: boolean;
+    /** Callback con el nuevo estado. */
+    onChange: (value: boolean) => void;
+    /** Etiqueta a la derecha del checkbox (ya traducida). */
+    label?: ReactNode;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `ckeditor` del CMS (solo endpoints JSON POST).
  *
@@ -557,6 +712,17 @@ export declare const cmsColors: {
     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. */
@@ -573,12 +739,29 @@ export declare const cmsColors: {
     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. */
@@ -589,6 +772,34 @@ export declare const cmsColors: {
     readonly white: "#FFFFFF";
 };
 
+/**
+ * Combobox de una sola opción con búsqueda escribiendo (equivale al campo
+ * "Creador" / "Autor" del diseño). Internamente usa `Autocomplete` de MUI pero
+ * expone una API por `value: string`. Controlado y reutilizable.
+ */
+export declare function CmsComboboxField({ value, onChange, options, label, placeholder, hint, noOptionsText, disabled, testId, }: CmsComboboxFieldProps): JSX.Element;
+
+export declare type CmsComboboxFieldProps = {
+    /** Valor seleccionado (value de la opción; vacío = ninguno). */
+    value: string;
+    /** Callback con el nuevo value (o '' al limpiar). */
+    onChange: (value: string) => void;
+    /** Opciones disponibles. */
+    options: FieldOption[];
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Placeholder (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Texto cuando no hay coincidencias (ya traducido). */
+    noOptionsText?: ReactNode;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `comments` del CMS.
  *
@@ -662,6 +873,70 @@ export declare class CmsCommonServices {
     getSitesAndPublications: () => Promise<SitesAndPublicationsResult>;
 }
 
+/** Color del botón "Confirmar/Enviar": CTA primario (azul) o destructivo (rojo). */
+declare type CmsConfirmColor = 'primary' | 'danger';
+
+/**
+ * Modal de confirmación reutilizable: ícono, título, descripción y 1–2 botones,
+ * todo opcional. Contenido alineado a la izquierda, acciones a la derecha y "X"
+ * de cerrar dentro del modal. Réplica funcional del `confirm-modal` del Angular
+ * legacy (`cmsmedios-ux`) con MUI + el theme de la lib. Los textos (i18n) los
+ * pasa el gestor; este componente solo presenta.
+ */
+export declare function CmsConfirmDialog({ open, onClose, icon, iconColor, title, description, showClose, closeAriaLabel, cancelLabel, onCancel, confirmLabel, onConfirm, confirmIcon, confirmColor, cancelDisabled, confirmDisabled, fullWidthActions, actionsAlign, width, minWidth, minHeight, disableBackdropClose, testId, }: CmsConfirmDialogProps): JSX.Element;
+
+export declare type CmsConfirmDialogProps = {
+    /** Si el modal está abierto. */
+    open: boolean;
+    /** Callback al cerrar (botón X, scrim o Escape). */
+    onClose: () => void;
+    /** Ícono opcional (se muestra en un badge circular sobre el título). */
+    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. */
+    title?: ReactNode;
+    /**
+     * Descripción opcional. Roboto 14/400. Puede incluir negrita (`<b>`/`<strong>`)
+     * y enlaces (`<a>`); ambos se estilan según el diseño.
+     */
+    description?: ReactNode;
+    /** Muestra el botón "X" de cerrar (dentro, arriba a la derecha). Por defecto `true`. */
+    showClose?: boolean;
+    /** `aria-label` del botón cerrar. */
+    closeAriaLabel?: string;
+    /** Label del botón "Cancelar". Si se omite, no se muestra. */
+    cancelLabel?: ReactNode;
+    /** Acción del botón "Cancelar". Por defecto cierra el modal (`onClose`). */
+    onCancel?: () => void;
+    /** Label del botón "Confirmar/Enviar". Si se omite, no se muestra. */
+    confirmLabel?: ReactNode;
+    /** Acción del botón "Confirmar/Enviar". */
+    onConfirm?: () => void;
+    /** Ícono opcional al inicio del botón "Confirmar/Enviar". */
+    confirmIcon?: ReactNode;
+    /** Color del botón "Confirmar/Enviar": `primary` (azul) o `danger` (rojo). */
+    confirmColor?: CmsConfirmColor;
+    /** Deshabilita el botón "Cancelar". */
+    cancelDisabled?: boolean;
+    /** Deshabilita el botón "Confirmar/Enviar". */
+    confirmDisabled?: boolean;
+    /** Los botones reparten el ancho del modal. Por defecto `false`. */
+    fullWidthActions?: boolean;
+    /** Alineación de los botones. Por defecto `end` (a la derecha). */
+    actionsAlign?: CmsDialogActionsAlign;
+    /** Ancho fijo del modal. Si se omite, crece con el contenido (respetando `minWidth`). */
+    width?: number | string;
+    /** Ancho mínimo del modal. Por defecto `420`. */
+    minWidth?: number | string;
+    /** Alto mínimo del modal (crece con el contenido). Por defecto `280`. */
+    minHeight?: number | string;
+    /** Evita cerrar al hacer clic fuera o con Escape (p. ej. mientras carga). */
+    disableBackdropClose?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `contributions` del CMS.
  *
@@ -714,6 +989,71 @@ export declare class CmsDashboardServices {
     getNotifications: () => Promise<DashboardNotificationsResponse>;
 }
 
+/**
+ * Campo de fecha con calendario Material 3 propio (no el selector nativo del
+ * navegador, que no se puede estilar). El valor se maneja en ISO `AAAA-MM-DD` y
+ * se muestra como `dd/mm/aaaa`. Los meses y días se rotulan según el idioma del
+ * provider. Controlado y reutilizable.
+ */
+export declare function CmsDateField({ value, onChange, label, hint, disabled, testId, }: CmsDateFieldProps): JSX.Element;
+
+export declare type CmsDateFieldProps = {
+    /** Valor en formato ISO `AAAA-MM-DD` (controlado; vacío = sin fecha). */
+    value: string;
+    /** Callback con la nueva fecha ISO (o '' al limpiar). */
+    onChange: (value: string) => void;
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
+/**
+ * Fila de acciones del modal de confirmación. Muestra 1 o 2 botones según los
+ * labels que reciba: el de "Cancelar" (tipo texto) y/o el de "Confirmar/Enviar"
+ * (CTA primario o destructivo, con ícono opcional). Reutilizable de forma
+ * independiente del modal.
+ */
+export declare function CmsDialogActions({ cancelLabel, onCancel, confirmLabel, onConfirm, confirmIcon, confirmColor, cancelDisabled, confirmDisabled, fullWidth, align, testId, }: CmsDialogActionsProps): JSX.Element | null;
+
+/** Alineación horizontal de la fila de botones. */
+declare type CmsDialogActionsAlign = 'start' | 'center' | 'end' | 'between';
+
+export declare type CmsDialogActionsProps = {
+    /** Label del botón "Cancelar". Si se omite, ese botón no se muestra. */
+    cancelLabel?: ReactNode;
+    /** Acción del botón "Cancelar". */
+    onCancel?: () => void;
+    /** Label del botón "Confirmar/Enviar". Si se omite, ese botón no se muestra. */
+    confirmLabel?: ReactNode;
+    /** Acción del botón "Confirmar/Enviar". */
+    onConfirm?: () => void;
+    /** Ícono opcional al inicio del botón "Confirmar/Enviar". */
+    confirmIcon?: ReactNode;
+    /** Color del botón "Confirmar/Enviar": `primary` (azul) o `danger` (rojo). */
+    confirmColor?: CmsConfirmColor;
+    /** Deshabilita el botón "Cancelar". */
+    cancelDisabled?: boolean;
+    /** Deshabilita el botón "Confirmar/Enviar". */
+    confirmDisabled?: boolean;
+    /**
+     * Si los botones crecen para repartir el ancho del contenedor padre. Por
+     * defecto `true`. Con un solo botón, ocupa todo el ancho disponible.
+     */
+    fullWidth?: boolean;
+    /** Alineación horizontal de los botones. Por defecto `end`. */
+    align?: CmsDialogActionsAlign;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
+/** Severidad de feedback derivada de un código de error. */
+export declare type CmsErrorSeverity = 'warning' | 'error';
+
 /** Evento del CMS. La forma exacta depende del recurso. */
 export declare interface CmsEvent {
     [key: string]: unknown;
@@ -754,6 +1094,19 @@ export declare class CmsFileExplorerServices {
     getFolders: (path: string) => Promise<FileExplorerGetFoldersResponse>;
 }
 
+/**
+ * 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.
+ */
+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`).
+ */
+export declare const cmsFontFaces: string;
+
 /**
  * Servicios HTTP de la raíz del módulo `general` del CMS que usan POST con body
  * JSON y objeto `authentication`.
@@ -770,7 +1123,7 @@ export declare class CmsGeneralServices {
     updateCDN: (path: string) => Promise<CmsResponse>;
 }
 
-export declare function CmsI18nProvider({ locale, language, messages, catalog, children, }: CmsI18nProviderProps): JSX.Element;
+export declare function CmsI18nProvider({ locale, language, messages, catalog, appMessages, children, }: CmsI18nProviderProps): JSX.Element;
 
 export declare type CmsI18nProviderProps = {
     locale?: Locale | string;
@@ -778,6 +1131,8 @@ export declare type CmsI18nProviderProps = {
     language?: Locale | string;
     messages?: CmsMessagesOverride;
     catalog?: LocaleCatalog;
+    /** Catálogo de mensajes propio del gestor (namespaces libres, es/en/pt). */
+    appMessages?: AppLocaleCatalog;
     children: ReactNode;
 };
 
@@ -868,6 +1223,34 @@ export declare type CmsMuiProviderProps = {
     children: ReactNode;
 };
 
+/**
+ * Campo de selección múltiple con chips y checkboxes en el desplegable
+ * (equivale al campo "Estados" del diseño). Internamente usa `Autocomplete`
+ * múltiple de MUI pero expone una API por `value: string[]`. Reutilizable.
+ */
+export declare function CmsMultiSelectField({ value, onChange, options, label, placeholder, hint, noOptionsText, disabled, testId, }: CmsMultiSelectFieldProps): JSX.Element;
+
+export declare type CmsMultiSelectFieldProps = {
+    /** Valores seleccionados (controlado). */
+    value: string[];
+    /** Callback con los nuevos valores. */
+    onChange: (value: string[]) => void;
+    /** Opciones disponibles. */
+    options: FieldOption[];
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Placeholder cuando no hay selección (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Texto cuando no hay coincidencias (ya traducido). */
+    noOptionsText?: ReactNode;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `news` del CMS (core + publish, unpublish, pin,
  * massive, freshness, views y analytics).
@@ -1013,6 +1396,33 @@ export declare class CmsNotificationServices {
     getTopics: () => Promise<NotificationTopicsResponse>;
 }
 
+/**
+ * Campo numérico con la estética estándar del CMS. Mantiene el valor como string
+ * para permitir el estado vacío. Controlado y reutilizable.
+ */
+export declare function CmsNumberField({ value, onChange, label, placeholder, hint, min, max, disabled, testId, }: CmsNumberFieldProps): JSX.Element;
+
+export declare type CmsNumberFieldProps = {
+    /** Valor actual como string (controlado; vacío = sin valor). */
+    value: string;
+    /** Callback con el nuevo valor (string para permitir el campo vacío). */
+    onChange: (value: string) => void;
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Placeholder (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Valor mínimo permitido. */
+    min?: number;
+    /** Valor máximo permitido. */
+    max?: number;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `people` (personas: periodistas, columnistas) del CMS.
  *
@@ -1336,6 +1746,71 @@ export declare interface CmsResponse {
     error?: string;
 }
 
+/** Envelope mínimo que `notifyCmsResponse` sabe interpretar. */
+export declare interface CmsResponseLike {
+    status?: 'ok' | 'fail' | 'error' | string;
+    errorCode?: string | number | Array<string | number>;
+    error?: string;
+}
+
+/**
+ * Buscador del CMS: input con lupa opcional, botón de limpiar y botón opcional
+ * de "opciones avanzadas" (tres puntos) que el consumidor cablea a un modal o
+ * panel lateral. Replica el comportamiento del `app-search` del Angular legacy
+ * (incluido el modo `collapsible` que crece al enfocar y colapsa al vaciarse).
+ *
+ * Es presentacional y controlado: el texto y los textos visibles vienen por
+ * props; la decisión de qué abrir en "avanzadas" vive en el gestor.
+ */
+export declare function CmsSearchField({ value, onChange, onSearch, onClear, placeholder, showIcon, showAdvanced, advancedActive, onAdvancedClick, collapsible, width, grow, maxWidth, endGap, advancedAriaLabel, clearAriaLabel, ariaLabel, testId, }: CmsSearchFieldProps): JSX.Element;
+
+export declare type CmsSearchFieldProps = {
+    /** Valor del texto de búsqueda (controlado). */
+    value: string;
+    /** Callback en cada cambio del texto. */
+    onChange: (value: string) => void;
+    /** Callback al presionar Enter (búsqueda). */
+    onSearch?: (value: string) => void;
+    /** Callback al limpiar el campo. Si no se pasa, igual limpia `value`. */
+    onClear?: () => void;
+    /** Placeholder del input (ya traducido y modificable por el consumidor). */
+    placeholder?: string;
+    /** Muestra la lupa a la izquierda. Por defecto `true`. */
+    showIcon?: boolean;
+    /** Muestra el botón de opciones avanzadas (tres puntos). Por defecto `false`. */
+    showAdvanced?: boolean;
+    /** Marca el botón de avanzadas como activo (hay filtros aplicados). */
+    advancedActive?: boolean;
+    /** Callback al hacer clic en opciones avanzadas (abre modal o panel). */
+    onAdvancedClick?: () => void;
+    /**
+     * Modo "crece/colapsa" como el `app-search` del Angular: arranca como un botón
+     * con lupa y se expande al hacer foco; colapsa al perder foco si está vacío.
+     * Por defecto `false` (input siempre expandido).
+     */
+    collapsible?: boolean;
+    /** Ancho del input cuando está expandido. */
+    width?: number | string;
+    /**
+     * Crece al enfocar hasta llenar el espacio disponible del contenedor (como el
+     * buscador clásico del CMS), dejando `endGap` px antes del borde. En reposo
+     * queda alineado a la derecha con ancho `width`. Por defecto `false`.
+     */
+    grow?: boolean;
+    /** Ancho máximo opcional cuando `grow` está activo (por defecto sin tope). */
+    maxWidth?: number | string;
+    /** Espacio mínimo a la derecha cuando `grow` está activo. Por defecto `40`. */
+    endGap?: number;
+    /** `aria-label` del botón de avanzadas. */
+    advancedAriaLabel?: string;
+    /** `aria-label` del botón de limpiar. */
+    clearAriaLabel?: string;
+    /** `aria-label` del input. */
+    ariaLabel?: string;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `sections` del CMS.
  *
@@ -1362,6 +1837,37 @@ export declare class CmsSectionsServices {
     updateSection: (section: SectionInput) => Promise<CmsResponse>;
 }
 
+/**
+ * Selector de una sola opción tipo formulario (subrayado M3). A diferencia de
+ * `SelectDropdown` (píldora para filtros de listado), este es un campo de
+ * formulario con etiqueta arriba. El menú resalta la opción activa en
+ * `secondary`, hace hover en `secondaryHover`, deja aire entre el borde del
+ * contenedor y el resaltado, y marca la activa con un check. Controlado y
+ * reutilizable.
+ */
+export declare function CmsSelectField({ value, onChange, options, label, placeholder, hint, disabled, showCheck, testId, }: CmsSelectFieldProps): JSX.Element;
+
+export declare type CmsSelectFieldProps = {
+    /** Valor seleccionado (controlado; vacío = ninguno). */
+    value: string;
+    /** Callback con el nuevo valor. */
+    onChange: (value: string) => void;
+    /** Opciones disponibles. */
+    options: FieldOption[];
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Placeholder mostrado cuando no hay valor (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Muestra el check en la opción activa. Por defecto `true`. */
+    showCheck?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 export declare type CmsShadows = typeof shadows;
 
 /**
@@ -1379,6 +1885,40 @@ export declare class CmsSitesServices {
 
 export declare type CmsSizes = typeof sizes;
 
+/**
+ * Campo de etiquetas libres: se escribe y se presiona Enter para agregar chips
+ * (equivale al campo "Etiquetas" del diseño). Internamente usa `Autocomplete`
+ * `freeSolo` múltiple. Controlado y reutilizable.
+ */
+export declare function CmsTagsField({ value, onChange, label, placeholder, hint, suggestions, startIcon, chipSx, disabled, testId, }: CmsTagsFieldProps): JSX.Element;
+
+export declare type CmsTagsFieldProps = {
+    /** Etiquetas actuales (controlado). */
+    value: string[];
+    /** Callback con las nuevas etiquetas. */
+    onChange: (value: string[]) => void;
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Placeholder cuando no hay etiquetas (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Sugerencias opcionales para el autocompletado. */
+    suggestions?: string[];
+    /** Ícono opcional a la izquierda del control (p. ej. una etiqueta/lupa). */
+    startIcon?: ReactNode;
+    /**
+     * `sx` de los chips de etiqueta. Si se pasa, **reemplaza** el estilo por
+     * defecto (`fieldStyles.sxChip`, primario tenue), permitiendo p. ej. usar el
+     * color secundario.
+     */
+    chipSx?: SxProps<Theme>;
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
 /**
  * Servicios HTTP del módulo `tags` del CMS.
  *
@@ -1416,6 +1956,100 @@ export declare class CmsTagsServices {
     changeStatus: (tag: TagChangeStatusInput) => Promise<TagChangeStatusResponse>;
 }
 
+/**
+ * Campo de texto de una línea con la estética estándar del CMS (etiqueta arriba,
+ * subrayado inferior). Controlado: el consumidor pasa `value` y `onChange`.
+ * Reutilizable en cualquier formulario.
+ */
+export declare function CmsTextField({ value, onChange, label, placeholder, hint, type, disabled, testId, }: CmsTextFieldProps): JSX.Element;
+
+export declare type CmsTextFieldProps = {
+    /** Valor actual (controlado). */
+    value: string;
+    /** Callback con el nuevo texto. */
+    onChange: (value: string) => void;
+    /** Etiqueta superior (ya traducida). */
+    label?: ReactNode;
+    /** Placeholder (ya traducido). */
+    placeholder?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** Tipo HTML del input. Por defecto `text`. */
+    type?: 'text' | 'email' | 'url';
+    /** Deshabilita el control. */
+    disabled?: boolean;
+    /** Base para los `data-testid`. */
+    testId?: string;
+};
+
+export declare function CmsToast({ item, t, localeTag, appVersion, onClose, }: CmsToastProps): JSX.Element;
+
+export declare interface CmsToastApi {
+    /** Toast de éxito (verde). */
+    success: (message: string, options?: ToastOptions) => string;
+    /** Toast informativo (azul). */
+    info: (message: string, options?: ToastOptions) => string;
+    /** Toast de advertencia (ámbar) — condición esperada/accionable. */
+    warning: (message: string, options?: ToastOptions) => string;
+    /** Toast de error (rojo, grande, con detalle copiable). */
+    error: (message: string, options?: ToastErrorOptions) => string;
+    /** Atajo genérico. */
+    show: (severity: ToastSeverity, message: string, options?: ToastErrorOptions) => string;
+    /** Cierra un toast por id; sin id, cierra todos. */
+    dismiss: (id?: string) => void;
+    /**
+     * Interpreta un envelope `CmsResponse` y dispara el toast adecuado:
+     * - `status: 'ok'` → success.
+     * - fallo → severidad por código (`resolveErrorSeverity`) y mensaje legible
+     *   (`getCommonError` → `error` crudo → default i18n).
+     */
+    notifyCmsResponse: (response: CmsResponseLike | null | undefined, options?: NotifyCmsResponseOptions) => string;
+}
+
+export declare const CmsToastContext: Context<CmsToastContextValue | null>;
+
+export declare interface CmsToastContextValue {
+    /** Encola un toast ya normalizado. Devuelve su id. */
+    enqueue: (item: Omit<ToastItem, 'id'>) => string;
+    /** Cierra un toast por id; sin id, cierra todos. */
+    dismiss: (id?: string) => void;
+    /** Translator resuelto al locale del provider (para resolver mensajes). */
+    t: CmsTranslator;
+    /** Locale activo del provider. */
+    locale: Locale;
+}
+
+export declare interface CmsToastProps {
+    item: ToastItem;
+    t: CmsTranslator;
+    /** Tag BCP 47 para formatear la fecha del detalle del error. */
+    localeTag: string;
+    /** Versión a mostrar en el detalle del error (app o lib). */
+    appVersion: string;
+    onClose: (id: string) => void;
+}
+
+/**
+ * Provee el sistema de toasts a toda la app. Renderiza una pila fija (abajo a
+ * la izquierda) y expone `useCmsToast()` para disparar feedback de operaciones.
+ *
+ * El mecanismo vive en la lib; el **disparo** lo hace el gestor (catch de un
+ * server action / handler de mutación).
+ */
+export declare function CmsToastProvider({ children, locale, language, appVersion, max, }: CmsToastProviderProps): JSX.Element;
+
+export declare interface CmsToastProviderProps {
+    children: ReactNode;
+    /** Locale del usuario (sale de `profile.locale` en el gestor). */
+    locale?: Locale | string;
+    /** Alias de `locale`. */
+    language?: Locale | string;
+    /** Versión a mostrar en el detalle del toast de error. Default: `LIB_VERSION`. */
+    appVersion?: string;
+    /** Máximo de toasts simultáneos (se descarta el más viejo). Default: 4. */
+    max?: number;
+}
+
 /**
  * Servicios HTTP del módulo `transcribe` del CMS.
  *
@@ -1436,13 +2070,30 @@ export declare class CmsTranscribeServices {
 
 export declare type CmsTranslator = {
     messages: CmsMessages;
+    /** Árbol de mensajes del gestor ya resuelto al locale activo (con fallback en). */
+    appMessages: AppMessages;
     navigation: (module: NavigationModule | string) => string;
     sidebar: (key: SidebarMessageKey) => string;
     topBar: (key: TopBarMessageKey) => string;
+    newMenu: (key: NewMenuMessageKey) => string;
+    previewMenu: (key: PreviewMenuMessageKey) => string;
     profileMenu: (key: ProfileMenuMessageKey) => string;
     notificationsMenu: (key: NotificationsMenuMessageKey, params?: {
         count?: number;
     }) => string;
+    toast: (key: ToastMessageKey) => string;
+    userAvatar: (key: UserAvatarMessageKey) => string;
+    /**
+     * Resuelve una clave propia del gestor por ruta con puntos
+     * (p. ej. `t.app('usuarios.modal.deactivate.title')`). Si falta, devuelve la
+     * ruta tal cual (útil para detectar claves ausentes en desarrollo).
+     */
+    app: AppTranslate;
+    /**
+     * Devuelve un traductor del gestor con un namespace fijado:
+     * `const tu = t.scoped('usuarios'); tu('modal.deactivate.title')`.
+     */
+    scoped: (namespace: string) => AppTranslate;
 };
 
 /**
@@ -1553,11 +2204,11 @@ export declare class CmsUsersServices {
     addPin: (pin: string) => Promise<UserPinAddResponse>;
     /** POST /users/pin/delete — elimina uno o más pins por ID. */
     deletePins: (ids: number[]) => Promise<CmsResponse>;
-    /** POST /users/action/setStatus — activa o desactiva un usuario. */
+    /** POST /users/actions/setStatus — activa o desactiva un usuario. */
     setUserStatus: (username: string, action: UserStatusAction) => Promise<CmsResponse>;
-    /** POST /users/action/resetPass — restablece la contraseña de un usuario. */
+    /** POST /users/actions/resetPass — restablece la contraseña de un usuario. */
     resetPassword: (username: string) => Promise<CmsResponse>;
-    /** POST /users/action/resetMfa — resetea la configuración MFA de un usuario. */
+    /** POST /users/actions/resetMfa — resetea la configuración MFA de un usuario. */
     resetMfa: (username: string, reason: string) => Promise<CmsResponse>;
 }
 
@@ -1721,6 +2372,11 @@ export declare class CmsZonesServices {
     orderZones: (ids: number[]) => Promise<CmsResponse>;
 }
 
+export declare type ComboboxFieldConfig = BaseFieldConfig & {
+    kind: 'combobox';
+    options: FieldOption[];
+};
+
 /** Comentario del CMS. La forma exacta no está documentada. */
 declare interface Comment_2 {
     commentId?: string;
@@ -1851,6 +2507,60 @@ export declare interface CommentUserGetResponse extends CmsResponse {
     phonenumber?: string;
 }
 
+/**
+ * CMS error code → readable message map (English).
+ *
+ * English counterpart of {@link commonErrorsEs}. See that file for the key
+ * convention and the `código → código+'a'` fallback handled by
+ * `getCommonError`.
+ */
+export declare const commonErrorsEn: Record<string, string>;
+
+/**
+ * Mapa de códigos de error del CMS → mensaje legible (español).
+ *
+ * Equivalente al `CommonErrorsEs` del Angular legacy (`cmsmedios-ux`). Es la
+ * base compartida por todos los gestores; **se va ampliando** con cada código
+ * nuevo que se aprenda durante el desarrollo (ver CLAUDE.md raíz).
+ *
+ * Convención de claves: el código tal cual lo devuelve el webservice
+ * (`000.005`, `999.000`, …). Algunos mensajes genéricos usan el sufijo `a`
+ * (`999.002a`) por compatibilidad con el legacy; `getCommonError` resuelve el
+ * fallback `código → código+'a'` automáticamente.
+ */
+export declare const commonErrorsEs: Record<string, string>;
+
+/**
+ * Mapa de código de erro do CMS → mensagem legível (português).
+ *
+ * Equivalente em português de {@link commonErrorsEs}.
+ */
+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";
+    };
+};
+
 /**
  * Contribución a actualizar (POST /contributions/edit).
  *
@@ -1896,7 +2606,36 @@ export declare interface CountNotificationsResponse {
 
 export declare function createAppTheme(): Theme;
 
-export declare function createTranslator(messages: CmsMessages): CmsTranslator;
+export declare function createTranslator(messages: CmsMessages, appMessages?: AppMessages): CmsTranslator;
+
+/**
+ * Estado compartido de la foto del usuario logueado.
+ *
+ * Es el equivalente React del `updateImageProfile` (BehaviorSubject) del CMS
+ * Angular legacy: cuando el usuario cambia su foto de perfil, la pantalla de
+ * edición llama a `setPhoto(...)` y todos los avatares marcados como
+ * `isCurrentUser` se actualizan al instante, sin recargar ni hacer
+ * prop-drilling.
+ */
+export declare interface CurrentUserPhotoContextValue {
+    /** Foto actual del usuario logueado: ruta/URL, '' o 'noPicture'. `null` = sin valor todavía. */
+    photo: string | null;
+    /** Notifica una foto nueva (o '' / 'noPicture' al borrarla). */
+    setPhoto: (photo: string | null) => void;
+}
+
+/**
+ * Provider de la foto del usuario logueado. Montarlo por encima de los avatares
+ * que representan al usuario actual (típicamente en el `AppShell` o el layout de
+ * la cuenta), sembrado con `profile.image`.
+ */
+export declare function CurrentUserPhotoProvider({ initialPhoto, children, }: CurrentUserPhotoProviderProps): JSX.Element;
+
+export declare interface CurrentUserPhotoProviderProps {
+    /** Foto inicial del usuario logueado (p. ej. `profile.image`). */
+    initialPhoto?: string | null;
+    children: ReactNode;
+}
 
 /** Cuerpo de la respuesta de POST /dashboard/countNotifications. */
 export declare interface DashboardCountNotificationsResponse extends CmsResponse {
@@ -1961,6 +2700,10 @@ export declare interface DashboardVideoNotification {
     [key: string]: unknown;
 }
 
+export declare type DateFieldConfig = BaseFieldConfig & {
+    kind: 'date';
+};
+
 declare type DeepStringMap<T> = {
     [K in keyof T]: T[K] extends Record<string, unknown> ? {
         [K2 in keyof T[K]]: string;
@@ -1969,6 +2712,27 @@ declare type DeepStringMap<T> = {
 
 export declare const DEFAULT_LOCALE: Locale;
 
+/**
+ * Estructura por defecto del menú "Nuevo", equivalente al `newContent` del
+ * header de cmsmedios (frecuentes / otros / videos) con sus permisos. El gestor
+ * puede sobreescribirla por props si su producto difiere.
+ */
+export declare const DEFAULT_NEW_CONTENT_GROUPS: NewContentGroup[];
+
+/**
+ * Formatos por defecto con la ruta EXACTA de cmsmedios. El redirect (form POST
+ * al CMS, como Ayuda) arma el campo `r` con `submitLegacyAdminPage`:
+ * - Desktop → `r = /index.html`
+ * - Mobile  → `r = /preview/mobile.html?path=/index.html`
+ * - Tablet  → `r = /preview/tablet.html?path=/index.html`
+ *
+ * `path` es la ruta de la publicación (`/index.html` para la principal). El
+ * `queryString` del device, al contener `/`, dispara la rama "redirect" de
+ * cmsmedios (`<queryString>?path=<path>`). El gestor puede sobrescribir estos
+ * formatos con los de `POST /news/previewFormats` por publicación.
+ */
+export declare const DEFAULT_PREVIEW_FORMATS: PreviewFormat[];
+
 export declare const DEFAULT_SITE_ID = "bluestack-es";
 
 export declare const DefaultCmsLink: ForwardRefExoticComponent<AnchorHTMLAttributes<HTMLAnchorElement> & {
@@ -2099,7 +2863,31 @@ export declare const enMessages: {
         readonly new: "New";
         readonly language: "Language";
         readonly analytics: "Analytics";
+        readonly preview: "Preview";
         readonly help: "Help";
+        readonly publication: "Publication";
+    };
+    readonly newMenu: {
+        readonly frequentsTitle: "Frequent";
+        readonly othersTitle: "Others";
+        readonly videosTitle: "Videos";
+        readonly post: "New Post";
+        readonly trivia: "New Trivia";
+        readonly poll: "New Poll";
+        readonly listicle: "New Listicle";
+        readonly tag: "New Tag";
+        readonly gamecast: "New Gamecast";
+        readonly liveblog: "New LiveBlog";
+        readonly aiPost: "New AI Post";
+        readonly aiListicle: "New AI Listicle";
+        readonly videoNative: "New Video Native";
+        readonly videoEmbedded: "New Video Embedded";
+        readonly videoYoutube: "New Video Youtube";
+    };
+    readonly previewMenu: {
+        readonly desktop: "Preview Desktop";
+        readonly mobile: "Preview Mobile";
+        readonly tablet: "Preview Tablet";
     };
     readonly profileMenu: {
         readonly ariaLabel: "My profile";
@@ -2112,6 +2900,98 @@ export declare const enMessages: {
         readonly unreadCount: "{count} unread";
         readonly empty: "No notifications";
         readonly ariaLabel: "Notifications";
+        readonly close: "Close";
+        readonly today: "Today";
+        readonly yesterday: "Yesterday";
+        readonly assignedBefore: "You have";
+        readonly assignedAfter: "new assigned topics.";
+        readonly pendingBefore: "You have";
+        readonly pendingAfter: "assigned topics about to expire.";
+        readonly assignedToday: "Assigned today";
+        readonly assignedYesterday: "Assigned yesterday";
+        readonly assignedOn: "Assigned on";
+        readonly expires: "Due";
+    };
+    readonly search: {
+        readonly placeholder: "Search…";
+        readonly inputAriaLabel: "Search";
+        readonly clearAriaLabel: "Clear search";
+        readonly advancedAriaLabel: "Advanced search";
+        readonly title: "Advanced search";
+        readonly apply: "Apply";
+        readonly reset: "Reset";
+        readonly close: "Close";
+        readonly noOptions: "No matches";
+        readonly dateToday: "Today";
+        readonly dateClear: "Clear";
+        readonly dateOpenAriaLabel: "Open calendar";
+        readonly prevMonthAriaLabel: "Previous month";
+        readonly nextMonthAriaLabel: "Next month";
+    };
+    readonly searchFields: {
+        readonly text: "Text";
+        readonly textPlaceholder: "Title, summary or body";
+        readonly type: "Type";
+        readonly typePlaceholder: "All types";
+        readonly section: "Section";
+        readonly sectionPlaceholder: "All sections";
+        readonly category: "Category";
+        readonly categoryPlaceholder: "All categories";
+        readonly states: "Statuses";
+        readonly statesPlaceholder: "All statuses";
+        readonly creator: "Creator";
+        readonly creatorPlaceholder: "Type to search a creator";
+        readonly author: "Author";
+        readonly authorPlaceholder: "Type to search an author";
+        readonly tags: "Tags";
+        readonly tagsPlaceholder: "Type and press Enter";
+        readonly groups: "Groups";
+        readonly groupsPlaceholder: "All groups";
+        readonly amount: "Amount to show";
+        readonly amountPlaceholder: "e.g. 50";
+        readonly dateFrom: "Date from";
+        readonly dateTo: "Date to";
+        readonly sortBy: "Sort by";
+        readonly sortByPlaceholder: "Relevance";
+        readonly zone: "Zone";
+        readonly zonePlaceholder: "Any zone";
+        readonly priority: "Priority";
+        readonly priorityPlaceholder: "All";
+        readonly order: "Order";
+        readonly orderPlaceholder: "Descending";
+        readonly includeDrafts: "Include drafts";
+        readonly includeHistory: "Include historical content";
+    };
+    readonly searchOptions: {
+        readonly typeNews: "Article";
+        readonly typeList: "List note";
+        readonly typeLiveblog: "LiveBlog";
+        readonly statePublished: "Published";
+        readonly stateDraft: "In drafting";
+        readonly stateScheduled: "Scheduled";
+        readonly stateReview: "In review";
+        readonly stateDone: "Finished";
+        readonly sortRelevance: "Relevance";
+        readonly sortDate: "Date";
+        readonly sortTitle: "Title";
+        readonly orderDesc: "Descending";
+        readonly orderAsc: "Ascending";
+        readonly priorityHigh: "High (1–10)";
+        readonly priorityMid: "Medium (11–30)";
+        readonly priorityLow: "Low (31+)";
+    };
+    readonly toast: {
+        readonly close: "Close";
+        readonly copyDetail: "Copy error detail";
+        readonly copied: "Copied";
+        readonly defaultSuccess: "Operation completed successfully.";
+        readonly defaultError: "An error occurred in the service.";
+        readonly defaultWarning: "Please review the request.";
+        readonly defaultInfo: "Information";
+    };
+    readonly userAvatar: {
+        readonly alt: "User avatar";
+        readonly unknownUser: "Unknown user";
     };
 };
 
@@ -2167,7 +3047,31 @@ export declare const esMessages: {
         new: string;
         language: string;
         analytics: string;
+        preview: string;
         help: string;
+        publication: string;
+    };
+    newMenu: {
+        frequentsTitle: string;
+        othersTitle: string;
+        videosTitle: string;
+        post: string;
+        trivia: string;
+        poll: string;
+        listicle: string;
+        tag: string;
+        gamecast: string;
+        liveblog: string;
+        aiPost: string;
+        aiListicle: string;
+        videoNative: string;
+        videoEmbedded: string;
+        videoYoutube: string;
+    };
+    previewMenu: {
+        desktop: string;
+        mobile: string;
+        tablet: string;
     };
     profileMenu: {
         ariaLabel: string;
@@ -2180,6 +3084,98 @@ export declare const esMessages: {
         unreadCount: string;
         empty: string;
         ariaLabel: string;
+        close: string;
+        today: string;
+        yesterday: string;
+        assignedBefore: string;
+        assignedAfter: string;
+        pendingBefore: string;
+        pendingAfter: string;
+        assignedToday: string;
+        assignedYesterday: string;
+        assignedOn: string;
+        expires: string;
+    };
+    search: {
+        placeholder: string;
+        inputAriaLabel: string;
+        clearAriaLabel: string;
+        advancedAriaLabel: string;
+        title: string;
+        apply: string;
+        reset: string;
+        close: string;
+        noOptions: string;
+        dateToday: string;
+        dateClear: string;
+        dateOpenAriaLabel: string;
+        prevMonthAriaLabel: string;
+        nextMonthAriaLabel: string;
+    };
+    searchFields: {
+        text: string;
+        textPlaceholder: string;
+        type: string;
+        typePlaceholder: string;
+        section: string;
+        sectionPlaceholder: string;
+        category: string;
+        categoryPlaceholder: string;
+        states: string;
+        statesPlaceholder: string;
+        creator: string;
+        creatorPlaceholder: string;
+        author: string;
+        authorPlaceholder: string;
+        tags: string;
+        tagsPlaceholder: string;
+        groups: string;
+        groupsPlaceholder: string;
+        amount: string;
+        amountPlaceholder: string;
+        dateFrom: string;
+        dateTo: string;
+        sortBy: string;
+        sortByPlaceholder: string;
+        zone: string;
+        zonePlaceholder: string;
+        priority: string;
+        priorityPlaceholder: string;
+        order: string;
+        orderPlaceholder: string;
+        includeDrafts: string;
+        includeHistory: string;
+    };
+    searchOptions: {
+        typeNews: string;
+        typeList: string;
+        typeLiveblog: string;
+        statePublished: string;
+        stateDraft: string;
+        stateScheduled: string;
+        stateReview: string;
+        stateDone: string;
+        sortRelevance: string;
+        sortDate: string;
+        sortTitle: string;
+        orderDesc: string;
+        orderAsc: string;
+        priorityHigh: string;
+        priorityMid: string;
+        priorityLow: string;
+    };
+    toast: {
+        close: string;
+        copyDetail: string;
+        copied: string;
+        defaultSuccess: string;
+        defaultError: string;
+        defaultWarning: string;
+        defaultInfo: string;
+    };
+    userAvatar: {
+        alt: string;
+        unknownUser: string;
     };
 };
 
@@ -2221,32 +3217,226 @@ export declare interface EventsGetFilters {
     position?: string;
 }
 
-/** Cuerpo de la respuesta de POST /events/get. */
-export declare interface EventsGetResponse extends CmsResponse {
-    /** Colección de eventos que cumplen los filtros. */
-    events: CmsEvent[];
-    total?: number;
-    [key: string]: unknown;
-}
+/** Cuerpo de la respuesta de POST /events/get. */
+export declare interface EventsGetResponse extends CmsResponse {
+    /** Colección de eventos que cumplen los filtros. */
+    events: CmsEvent[];
+    total?: number;
+    [key: string]: unknown;
+}
+
+/** Archivo del VFS devuelto por POST /fileExplorer/getFiles. */
+export declare interface ExplorerFile {
+    path?: string;
+    name?: string;
+    title?: string;
+    /** Tipo de recurso (ej. "image", "plain"). */
+    type?: string;
+    /** Fecha de última modificación (ej. "10/06/2024 03:45"). */
+    dateLastModified?: string;
+    [key: string]: unknown;
+}
+
+/** Carpeta del VFS devuelta por POST /fileExplorer/getFolders. */
+export declare interface ExplorerFolder {
+    path?: string;
+    name?: string;
+    [key: string]: unknown;
+}
+
+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.
+ */
+export declare const feedbackBadgeColors: {
+    /** Éxito: círculo verde menta con check verde oscuro. */
+    readonly success: {
+        readonly bg: "#92F7B7";
+        readonly on: "#002112";
+    };
+    /** Advertencia: círculo ámbar con ícono marrón. */
+    readonly warning: {
+        readonly bg: "#FFDDB0";
+        readonly on: "#5F4200";
+    };
+    /** Error: círculo rosado con ícono rojo oscuro. */
+    readonly error: {
+        readonly bg: "#FFDAD6";
+        readonly on: "#93000A";
+    };
+    /** Info: círculo azul tonal con ícono azul oscuro. */
+    readonly info: {
+        readonly bg: "#D8E2FF";
+        readonly on: "#001551";
+    };
+};
+
+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.
+ */
+export declare const feedbackColors: {
+    /** Fondo oscuro del toast (común a todas las severidades). */
+    readonly surface: "#2E2E2E";
+    /** Texto/íconos sobre la superficie oscura. */
+    readonly onSurface: "#FFFFFF";
+    /** Texto secundario (detalle, url, versión) sobre la superficie oscura. */
+    readonly onSurfaceMuted: "#C7C7C7";
+    /** Acento de éxito (verde). */
+    readonly success: "#00C853";
+    /** Acento de advertencia (ámbar). */
+    readonly warning: "#FFAB00";
+    /** Acento de error (rojo). */
+    readonly error: "#FF1744";
+    /** Acento informativo (azul). */
+    readonly info: "#2196F3";
+    /** Enlace (url del recurso) sobre la superficie oscura del toast. */
+    readonly link: "#9ECAFF";
+    /** Fondo sutil del detalle crudo del servidor del toast de error. */
+    readonly overlay: "#3B3B3B";
+    /** Texto atenuado del toast de error (descripción, chip de versión, fecha). */
+    readonly onSurfaceSoft: "#F0F0F7";
+    /** Fondo del chip de versión (blanco translúcido sobre la superficie oscura). */
+    readonly versionChipBg: "#F0F0F71A";
+    /** Punto separador entre versión y fecha (blanco translúcido). */
+    readonly separator: "#F0F0F7B3";
+};
+
+/**
+ * Configuración de un campo del formulario de búsqueda avanzada.
+ * Unión discriminada por `kind`: el contenedor renderiza el componente de campo
+ * que corresponda. Así un gestor "arma" su modal pasando solo los campos que
+ * necesita (`fields: FieldConfig[]`).
+ */
+export declare type FieldConfig = TextFieldConfig | NumberFieldConfig | DateFieldConfig | SelectFieldConfig | MultiSelectFieldConfig | ComboboxFieldConfig | TagsFieldConfig | CheckboxFieldConfig;
+
+/** Tipos de campo soportados por el contenedor de búsqueda avanzada. */
+export declare type FieldKind = 'text' | 'number' | 'date' | 'select' | 'multiselect' | 'combobox' | 'tags' | 'checkbox';
+
+/**
+ * Opción de un campo con opciones (select / combobox / multiselect).
+ * Mismo formato que el resto de la librería: `value` se compara/emite y `label`
+ * es el texto (ya traducido) a mostrar.
+ */
+export declare type FieldOption = {
+    /** Valor que se emite y se compara. */
+    value: string;
+    /** Texto o nodo (ya traducido) a mostrar. */
+    label: ReactNode;
+    /** Si es `false` la opción no se renderiza. Por defecto `true`. */
+    show?: boolean;
+    /** Deshabilita la opción individual. */
+    disabled?: boolean;
+    /**
+     * Color del puntito que precede a la opción (multiselección). Si se omite, la
+     * opción no muestra puntito. Útil para estados con color.
+     */
+    color?: string;
+};
+
+/**
+ * Renderiza el componente de campo que corresponde a una `FieldConfig`,
+ * resolviendo el tipo de valor por cada `kind`. Es el puente entre la
+ * configuración declarativa del modal y los componentes de campo concretos.
+ */
+export declare function FieldRenderer({ field, value, onChange }: FieldRendererProps): JSX.Element | null;
+
+export declare type FieldRendererProps = {
+    /** Configuración del campo a renderizar. */
+    field: FieldConfig;
+    /** Valor actual del campo. */
+    value: FieldValue | undefined;
+    /** Callback con el nuevo valor del campo. */
+    onChange: (value: FieldValue) => void;
+};
+
+/**
+ * Envoltorio común de un campo: etiqueta arriba + control + ayuda abajo.
+ *
+ * Centraliza la disposición vertical y la tipografía de la etiqueta para que
+ * todos los campos del CMS se vean idénticos. Se exporta para poder construir
+ * campos a medida que respeten el mismo layout.
+ */
+export declare function FieldShell({ label, htmlFor, hint, children }: FieldShellProps): JSX.Element;
+
+export declare type FieldShellProps = {
+    /** Etiqueta superior (ya traducida). Si se omite no se renderiza. */
+    label?: ReactNode;
+    /** `htmlFor` para asociar la etiqueta al control. */
+    htmlFor?: string;
+    /** Texto de ayuda bajo el control. */
+    hint?: ReactNode;
+    /** El control del campo. */
+    children: ReactNode;
+};
 
-/** Archivo del VFS devuelto por POST /fileExplorer/getFiles. */
-export declare interface ExplorerFile {
-    path?: string;
-    name?: string;
-    title?: string;
-    /** Tipo de recurso (ej. "image", "plain"). */
-    type?: string;
-    /** Fecha de última modificación (ej. "10/06/2024 03:45"). */
-    dateLastModified?: string;
-    [key: string]: unknown;
-}
+/**
+ * Estilos compartidos de los campos de formulario del CMS.
+ *
+ * Replican la estética "Material 3 standard" del diseño de referencia
+ * (etiqueta arriba en gris, control con subrayado inferior; el subrayado pasa a
+ * `primary` al enfocar). Viven juntos para que todos los campos
+ * (`CmsTextField`, `CmsSelectField`, etc.) compartan exactamente el mismo look y
+ * puedan reutilizarse en cualquier formulario de cualquier gestor.
+ */
+export declare const fieldStyles: {
+    /** Contenedor vertical: etiqueta + control + ayuda. */
+    sxField: SxProps<Theme>;
+    /** Etiqueta superior (gris, label-medium). */
+    sxLabel: SxProps<Theme>;
+    /** Texto de ayuda bajo el control. */
+    sxHint: SxProps<Theme>;
+    /**
+     * `sx` para los controles basados en `TextField variant="standard"`
+     * (texto, número, fecha, select) y para el `renderInput` de los
+     * `Autocomplete` (combobox, tags, multiselect). Unifica subrayado,
+     * tipografía y color del placeholder.
+     */
+    sxStandard: SxProps<Theme>;
+    /**
+     * Chips de los campos multiselección / etiquetas: fondo secundario, texto
+     * sobre contenedor secundario y radio "redondo cuadrado".
+     */
+    sxChip: SxProps<Theme>;
+    /** Paper del desplegable de los `Autocomplete` (con aire vertical). */
+    sxAutocompletePaper: SxProps<Theme>;
+    /**
+     * Listbox de los `Autocomplete`: opciones "embutidas" (con aire lateral y
+     * radio), hover en `secondaryHover` y opción activa en `secondary`.
+     */
+    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.
+     */
+    sxSelectMenuPaper: SxProps<Theme>;
+    /** Lista del menú del select (sin padding; el aire lo pone el paper). */
+    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.
+     */
+    sxSelectItem: SxProps<Theme>;
+    /** Check de la opción activa del select. */
+    sxSelectCheck: SxProps<Theme>;
+    /** Etiqueta del checkbox (alineada al control). */
+    sxCheckboxLabel: SxProps<Theme>;
+};
 
-/** Carpeta del VFS devuelta por POST /fileExplorer/getFolders. */
-export declare interface ExplorerFolder {
-    path?: string;
-    name?: string;
-    [key: string]: unknown;
-}
+/** Valor que puede contener un campo del formulario de búsqueda. */
+export declare type FieldValue = string | string[] | boolean;
+
+/** Mapa `nombre del campo` → `valor`. Es lo que emite el modal al aplicar. */
+export declare type FieldValues = Record<string, FieldValue>;
 
 /** Cuerpo de la respuesta de POST /fileExplorer/getFiles. */
 export declare interface FileExplorerGetFilesResponse extends CmsResponse {
@@ -2264,8 +3454,41 @@ 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. Usar estas variables en
+ * lugar de strings sueltos (mismo criterio que con los colores).
+ */
+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 mono: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
+};
+
+/**
+ * Formatea un instante (epoch ms) en la zona horaria del sitio, de forma
+ * estable entre navegadores.
+ *
+ * @param epochMs Instante en milisegundos (UTC).
+ * @param gmtRedaction Offset GMT de la publicación.
+ * @param localeTag Tag BCP 47 (p. ej. `"es-AR"`); usar `getIntlLocaleTag(locale)`.
+ * @param options Opciones de `Intl.DateTimeFormat` (se fuerza `timeZone: 'UTC'`).
+ */
+export declare function formatSiteDateTime(epochMs: number, gmtRedaction: string | null | undefined, localeTag: string, options?: Intl.DateTimeFormatOptions): string;
+
 export declare function getAllPublications(sites: SiteSection[]): Publication[];
 
+/**
+ * Resuelve el mensaje legible de un código de error en el idioma indicado.
+ * Aplica el fallback legacy `código → código+'a'` (p. ej. `999.002` → `999.002a`)
+ * y, si el idioma no tiene el código, cae a inglés. Devuelve `undefined` si el
+ * código es desconocido (el caller debe usar entonces el `error` crudo o un
+ * mensaje genérico).
+ */
+export declare function getCommonError(errorCode: string | number | Array<string | number> | null | undefined, locale?: Locale): string | undefined;
+
 export declare function getDefaultPublicationSlug(sites: SiteSection[]): string;
 
 /** BCP 47 tag for `Intl` / `toLocaleString` formatting. */
@@ -2275,6 +3498,16 @@ export declare function getProfileAvatarSrc(profile: ProfileGetResponse, options
 
 export declare function getProfileDisplayName(profile: ProfileGetResponse): string;
 
+/**
+ * Hora actual del sitio (equivalente al `getFormattedRedactionTimeUTC` del CMS
+ * Angular): "ahora" formateado en la zona de redacción de la publicación.
+ *
+ * @param gmtRedaction Offset GMT de la publicación.
+ * @param localeTag Tag BCP 47 (p. ej. `"es-AR"`).
+ * @param options Opciones de `Intl.DateTimeFormat`.
+ */
+export declare function getSiteNow(gmtRedaction: string | null | undefined, localeTag: string, options?: Intl.DateTimeFormatOptions): string;
+
 declare interface IAudiosServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -2584,6 +3817,19 @@ declare interface INotificationServices {
     authentication: Authentication;
 }
 
+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`.
+ */
+export declare const interestColors: {
+    /** Me gusta (verde). */
+    readonly like: "#1E8E3E";
+    /** No me gusta (rojo). */
+    readonly dislike: "#D93025";
+};
+
 declare interface IPeopleServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -2634,6 +3880,22 @@ declare interface ISitesServices {
     authentication: Authentication;
 }
 
+/**
+ * Decide si un ítem es visible según los permisos de operación del usuario.
+ *
+ * - Si `operationPermissions` es `undefined`, no hay gating (se muestra todo);
+ *   útil para maquetado/mock antes de cablear `/auth/permissions`.
+ * - Si el usuario es admin, ve todo.
+ * - Si el ítem no declara permiso, se muestra.
+ * - Con un array de permisos, se exigen todos.
+ *
+ * @param item - Ítem a evaluar.
+ * @param operationPermissions - Nombres de operaciones concedidas al usuario.
+ * @param isAdmin - Si el usuario es administrador.
+ * @returns `true` si el ítem debe mostrarse.
+ */
+export declare function isNewContentItemVisible(item: NewContentItem, operationPermissions: string[] | undefined, isAdmin: boolean | undefined): boolean;
+
 declare interface ITagsServices {
     axiosApi: AxiosInstance;
     authentication: Authentication;
@@ -2683,6 +3945,35 @@ declare interface IZonesServices {
     authentication: Authentication;
 }
 
+/** Parámetros de dispositivo para la previsualización (protocolo/queryString). */
+export declare type LegacyAdminDevice = {
+    /** `'https'` (por defecto) o `'http'`. */
+    protocol?: string;
+    /** QueryString específico del formato de preview (viene del backend). */
+    queryString?: string;
+};
+
+/**
+ * Redirección al admin viejo del CMS (JSP) replicando el `openExternalPage()` de
+ * cmsmedios-ux: en vez de un enlace, se arma y envía un formulario POST oculto
+ * al endpoint `auth/adminBack/login`, que re-establece la sesión en la pestaña
+ * nueva y luego redirige a la ruta pedida (campo `r`).
+ *
+ * Es código de navegador (usa `document`): debe llamarse desde un handler de
+ * cliente, no en SSR.
+ */
+/** Datos de sesión que el form POST envía al admin viejo. */
+export declare type LegacyAdminSession = {
+    /** Token de autenticación (se envía en base64, igual que el Angular legacy). */
+    token: string;
+    browserId: string;
+    siteName: string;
+    publication: string | number;
+    userName: string;
+    /** Proyecto del CMS. Por defecto `'Offline'`. */
+    project?: string;
+};
+
 export declare const LIB_VERSION: "0.0.0";
 
 export declare type Locale = (typeof SUPPORTED_LOCALES)[number];
@@ -2696,6 +3987,13 @@ declare type MenuOrigin = {
     horizontal: 'left' | 'center' | 'right';
 };
 
+/**
+ * Resuelve el árbol de mensajes del gestor para el locale activo, usando `en`
+ * como fallback (igual criterio que `mergeMessages`). Devuelve `{}` si no se
+ * pasó catálogo del gestor.
+ */
+export declare function mergeAppMessages(locale: Locale, appCatalog?: AppLocaleCatalog): AppMessages;
+
 /** Deep-merge custom overrides on top of the locale catalog entry. */
 export declare function mergeMessages(locale: Locale, catalog: LocaleCatalog, overrides?: CmsMessagesOverride): CmsMessages;
 
@@ -2704,6 +4002,11 @@ export declare interface ModulesAvailableResponse {
     modules: NavItemPermissions[];
 }
 
+export declare type MultiSelectFieldConfig = BaseFieldConfig & {
+    kind: 'multiselect';
+    options: FieldOption[];
+};
+
 export declare type NavBlock = NavLinkItem;
 
 export declare type NavigationModule = keyof CmsMessages['navigation'];
@@ -2725,6 +4028,68 @@ export declare type NavLinkItem = {
     defaultOpen?: boolean;
 };
 
+/** Columna del menú "Nuevo" (Frecuentes / Otros / Videos). */
+export declare type NewContentGroup = {
+    /** Clave i18n del título de la columna (namespace `newMenu`). */
+    titleKey: NewMenuMessageKey;
+    items: NewContentItem[];
+};
+
+/**
+ * Ítem del menú "Nuevo" (botón "+"). Replica la estructura del header del CMS
+ * Angular legacy (`newContent` de cmsmedios): cada ítem declara su clave i18n y
+ * el/los permiso(s) de operación que habilitan su visibilidad.
+ */
+export declare type NewContentItem = {
+    /** Identificador estable; lo recibe `onNewContentSelect` al hacer clic. */
+    id: string;
+    /** Clave i18n del namespace `newMenu`. */
+    labelKey: NewMenuMessageKey;
+    /**
+     * Permiso(s) de operación requeridos (p. ej. `NEWS_CREATE`). Si es un array,
+     * se exigen TODOS (criterio NAA-4038 del Angular legacy). Si se omite, el ítem
+     * no requiere permiso.
+     */
+    permission?: string | string[];
+};
+
+/**
+ * Menú desplegable del botón "Nuevo" (+) del header. Replica las tres columnas
+ * del header de cmsmedios (Frecuentes / Otros / Videos) con visibilidad por
+ * permisos. El comportamiento de cada ítem lo resuelve el gestor.
+ */
+export declare function NewContentMenu({ groups, operationPermissions, isAdmin, legacyBaseUrl, getRedirectPath, onSelect, }: NewContentMenuProps): JSX.Element;
+
+export declare type NewContentMenuProps = {
+    /** Columnas e ítems del menú. Por defecto, la estructura del CMS legacy. */
+    groups?: NewContentGroup[];
+    /**
+     * Nombres de operaciones concedidas al usuario (de `POST /auth/permissions`).
+     * Si se omite, no hay filtrado por permisos (se muestran todos los ítems).
+     */
+    operationPermissions?: string[];
+    /** Si el usuario es administrador (ve todos los ítems). */
+    isAdmin?: boolean;
+    /**
+     * Dominio del deploy nuevo (master) al que se redirige, p. ej.
+     * `https://master.d1c5iid93veq15.amplifyapp.com`. Se navega a
+     * `<legacyBaseUrl><getRedirectPath(id)>` en una pestaña nueva.
+     */
+    legacyBaseUrl?: string;
+    /**
+     * Ruta/parámetro por ítem que se concatena a `legacyBaseUrl`. Por defecto
+     * `/?new=<id>`: el deploy destino lee `new` y dispara la creación.
+     */
+    getRedirectPath?: (itemId: string) => string;
+    /**
+     * Fallback cuando no hay `legacyBaseUrl`: se invoca con el `id` del ítem
+     * (punto de integración para maquetado).
+     */
+    onSelect?: (itemId: string) => void;
+};
+
+export declare type NewMenuMessageKey = keyof CmsMessages['newMenu'];
+
 /** Cuerpo de la respuesta de POST /news/edit/adminNewsConfiguration. */
 export declare interface NewsAdminConfigurationResponse extends CmsResponse {
     [key: string]: unknown;
@@ -3182,6 +4547,13 @@ export declare type NextCmsMuiProviderProps = {
     children: ReactNode;
 };
 
+/**
+ * Normaliza un `errorCode` que puede venir como string, número o array (el CMS
+ * devuelve un array de códigos cuando hay varias violaciones de contraseña).
+ * Devuelve el primer código no vacío.
+ */
+export declare function normalizeErrorCode(errorCode: string | number | Array<string | number> | null | undefined): string | undefined;
+
 /** Normaliza códigos BCP 47 o variantes (`es-MX`, `pt_BR`) al `Locale` soportado. */
 export declare function normalizeLocale(value?: string | null): Locale;
 
@@ -3193,6 +4565,34 @@ export declare interface NotificationAdminConfigurationResponse extends CmsRespo
     types?: NotificationSendType[];
 }
 
+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";
+    };
+    /** Notificaciones del sistema / videos (verde). */
+    readonly system: {
+        readonly bg: "#DCEFE0";
+        readonly on: "#11663B";
+    };
+};
+
 /** Topic devuelto por notification/adminConfiguration (`{ name, value }`). */
 export declare interface NotificationConfigTopic {
     name: string;
@@ -3235,13 +4635,21 @@ export declare interface NotificationsListResponse {
     total?: number;
 }
 
-export declare function NotificationsMenu({ unreadCount, notifications, }: NotificationsMenuProps): JSX.Element;
+export declare function NotificationsMenu({ unreadCount, notificationsData, masterBaseUrl, currentPublicationId, gmtRedaction, }: NotificationsMenuProps): JSX.Element;
 
 export declare type NotificationsMenuMessageKey = keyof CmsMessages['notificationsMenu'];
 
 export declare type NotificationsMenuProps = {
+    /** Total de no leídas (badge de la campanita). */
     unreadCount: number;
-    notifications: DashboardNotification[];
+    /** Respuesta cruda de `POST /dashboard/notification` (newsTask/expireTask/videos). */
+    notificationsData?: DashboardNotificationsResponse | null;
+    /** Dominio de `master` (Angular) para la redirección de los temas. */
+    masterBaseUrl?: string;
+    /** Id de la publicación activa (fallback de la redirección). */
+    currentPublicationId?: number | string;
+    /** Offset GMT de la publicación (para mostrar las fechas en zona de redacción). */
+    gmtRedaction?: string | null;
 };
 
 /** Topic devuelto por notification/topics (`{ name, description }`). */
@@ -3256,6 +4664,49 @@ export declare interface NotificationTopicsResponse extends CmsResponse {
     topics?: NotificationTopic[];
 }
 
+/** Opciones del atajo `notifyCmsResponse`. */
+export declare interface NotifyCmsResponseOptions {
+    /** URL del servicio invocado (para el detalle del error). */
+    service?: string;
+    /** Parámetros enviados al servicio (para el detalle del error). */
+    params?: unknown;
+    /** Mensaje a mostrar cuando `status === 'ok'`. Default: i18n `toast.defaultSuccess`. */
+    successMessage?: string;
+    /** Título del toast de éxito. */
+    successTitle?: string;
+}
+
+export declare type NumberFieldConfig = BaseFieldConfig & {
+    kind: 'number';
+    min?: number;
+    max?: number;
+};
+
+/**
+ * Utilidades de hora del sitio (zona de redacción de la publicación).
+ *
+ * El backend entrega en cada `Publication` un offset GMT fijo
+ * (`gmtRedaction`, p. ej. `"-3"` / `"+0"`) — NO una zona IANA. Por eso la
+ * conversión se hace con un offset fijo y no contempla horario de verano
+ * (DST). Es el equivalente, en React, de lo que en el CMS Angular hacía
+ * `settings.service` (`getFormattedRedactionTimeStamp` /
+ * `getFormattedRedactionTimeUTC`).
+ *
+ * El criterio: un timestamp del CMS es un instante en UTC (epoch ms). Para
+ * mostrarlo "como lo ve la redacción" se desplaza el instante por el offset y
+ * se formatea en `timeZone: 'UTC'`, de modo que el resultado es estable e
+ * independiente de la zona horaria del navegador.
+ */
+/**
+ * Convierte el offset GMT de una publicación a minutos.
+ * Acepta `"-3"`, `"+3"`, `"3"`, `"+5:30"`, tolera prefijos `GMT`/`UTC` y
+ * espacios. Si el valor no es interpretable, devuelve `0` (UTC).
+ *
+ * @param gmt Offset tal como llega en `Publication.gmtRedaction`.
+ * @returns Offset en minutos respecto de UTC (negativo al oeste de Greenwich).
+ */
+export declare function parseGmtOffsetMinutes(gmt: string | null | undefined): number;
+
 export declare function parsePublicationSlug(slug: string): number;
 
 /** Filtros de POST /contributions/paymentGateways/get. */
@@ -3648,6 +5099,52 @@ export declare interface PollUnpublishResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/**
+ * Formato de previsualización (Desktop / Mobile / Tablet…). En el CMS legacy la
+ * lista es dinámica (`POST /news/previewFormats`); acá se reciben por props.
+ */
+export declare type PreviewFormat = {
+    /** Identificador estable; lo recibe `onSelect` al hacer clic. */
+    id: string;
+    /** Clave i18n del namespace `previewMenu` (cuando el texto es conocido). */
+    labelKey?: PreviewMenuMessageKey;
+    /** Texto ya resuelto (cuando el nombre viene dinámico del backend). */
+    label?: string;
+    /**
+     * Ruta de preview de la publicación (campo `r` del form), p. ej.
+     * `/sites/<sitio>/index.html`. Viene de `POST /news/previewFormats`. Si está
+     * presente (con sesión), el clic redirige al admin viejo; si no, usa `onSelect`.
+     */
+    path?: string;
+    /** QueryString del dispositivo (de `POST /news/previewFormats`). */
+    queryString?: string;
+    /** Protocolo del preview (`'https'` por defecto). */
+    protocol?: string;
+};
+
+/**
+ * Menú desplegable del botón de previsualización (icono de dispositivos) del
+ * header. Usa el `SimpleDropdown` de la lib. Igual que en cmsmedios, solo se
+ * renderiza si hay al menos un formato disponible.
+ */
+export declare function PreviewMenu({ formats, cmsBaseUrl, legacySession, onSelect, }: PreviewMenuProps): JSX.Element | null;
+
+export declare type PreviewMenuMessageKey = keyof CmsMessages['previewMenu'];
+
+export declare type PreviewMenuProps = {
+    /** Formatos de preview. Por defecto, Desktop / Mobile / Tablet. */
+    formats?: PreviewFormat[];
+    /** Origen del CMS (JSP) para el redirect al admin viejo. */
+    cmsBaseUrl?: string;
+    /** Sesión para el form POST del redirect (token, sitio, etc.). */
+    legacySession?: LegacyAdminSession;
+    /**
+     * Punto de integración: se invoca con el `id` del formato cuando no se puede
+     * redirigir directo (falta `path`/sesión). El gestor arma la URL y redirige.
+     */
+    onSelect?: (formatId: string) => void;
+};
+
 /** Plan de productividad. La forma exacta depende del recurso y del formato pedido. */
 export declare interface ProductivityPlan {
     [key: string]: unknown;
@@ -3975,13 +5472,15 @@ export declare interface ProfileGetResponse {
     documentation: unknown[];
 }
 
-export declare function ProfileMenu({ profile, avatarOptions }: ProfileMenuProps): JSX.Element;
+export declare function ProfileMenu({ profile, avatarOptions, legacyBaseUrl, }: ProfileMenuProps): JSX.Element;
 
 export declare type ProfileMenuMessageKey = keyof CmsMessages['profileMenu'];
 
 export declare type ProfileMenuProps = {
     profile: ProfileGetResponse;
     avatarOptions?: ProfileAvatarOptions;
+    /** Dominio del CMS Angular legacy para "Mi Perfil" / "Vista Webmaster". */
+    legacyBaseUrl?: string;
 };
 
 /** Cuerpo de la respuesta de POST /profile/moduleAlerts/hide. */
@@ -4101,7 +5600,31 @@ export declare const ptMessages: {
         new: string;
         language: string;
         analytics: string;
+        preview: string;
         help: string;
+        publication: string;
+    };
+    newMenu: {
+        frequentsTitle: string;
+        othersTitle: string;
+        videosTitle: string;
+        post: string;
+        trivia: string;
+        poll: string;
+        listicle: string;
+        tag: string;
+        gamecast: string;
+        liveblog: string;
+        aiPost: string;
+        aiListicle: string;
+        videoNative: string;
+        videoEmbedded: string;
+        videoYoutube: string;
+    };
+    previewMenu: {
+        desktop: string;
+        mobile: string;
+        tablet: string;
     };
     profileMenu: {
         ariaLabel: string;
@@ -4114,6 +5637,98 @@ export declare const ptMessages: {
         unreadCount: string;
         empty: string;
         ariaLabel: string;
+        close: string;
+        today: string;
+        yesterday: string;
+        assignedBefore: string;
+        assignedAfter: string;
+        pendingBefore: string;
+        pendingAfter: string;
+        assignedToday: string;
+        assignedYesterday: string;
+        assignedOn: string;
+        expires: string;
+    };
+    search: {
+        placeholder: string;
+        inputAriaLabel: string;
+        clearAriaLabel: string;
+        advancedAriaLabel: string;
+        title: string;
+        apply: string;
+        reset: string;
+        close: string;
+        noOptions: string;
+        dateToday: string;
+        dateClear: string;
+        dateOpenAriaLabel: string;
+        prevMonthAriaLabel: string;
+        nextMonthAriaLabel: string;
+    };
+    searchFields: {
+        text: string;
+        textPlaceholder: string;
+        type: string;
+        typePlaceholder: string;
+        section: string;
+        sectionPlaceholder: string;
+        category: string;
+        categoryPlaceholder: string;
+        states: string;
+        statesPlaceholder: string;
+        creator: string;
+        creatorPlaceholder: string;
+        author: string;
+        authorPlaceholder: string;
+        tags: string;
+        tagsPlaceholder: string;
+        groups: string;
+        groupsPlaceholder: string;
+        amount: string;
+        amountPlaceholder: string;
+        dateFrom: string;
+        dateTo: string;
+        sortBy: string;
+        sortByPlaceholder: string;
+        zone: string;
+        zonePlaceholder: string;
+        priority: string;
+        priorityPlaceholder: string;
+        order: string;
+        orderPlaceholder: string;
+        includeDrafts: string;
+        includeHistory: string;
+    };
+    searchOptions: {
+        typeNews: string;
+        typeList: string;
+        typeLiveblog: string;
+        statePublished: string;
+        stateDraft: string;
+        stateScheduled: string;
+        stateReview: string;
+        stateDone: string;
+        sortRelevance: string;
+        sortDate: string;
+        sortTitle: string;
+        orderDesc: string;
+        orderAsc: string;
+        priorityHigh: string;
+        priorityMid: string;
+        priorityLow: string;
+    };
+    toast: {
+        close: string;
+        copyDetail: string;
+        copied: string;
+        defaultSuccess: string;
+        defaultError: string;
+        defaultWarning: string;
+        defaultInfo: string;
+    };
+    userAvatar: {
+        alt: string;
+        unknownUser: string;
     };
 };
 
@@ -4149,6 +5764,12 @@ export declare interface Publication {
     timeFormat: string;
     type: string;
     updateAdmin: PublicationUpdateAdmin;
+    /**
+     * Sub-sitios (multisitio) de esta publicación. Opcional: hoy el servicio no
+     * lo devuelve y las publicaciones se listan planas. Cuando el backend lo
+     * incluya, el selector los muestra como filas hijas expandibles con contador.
+     */
+    children?: Publication[];
 }
 
 /**
@@ -4209,6 +5830,8 @@ export declare const radii: {
     readonly lg: "14px";
     /** Píldoras grandes / menús redondeados (M3). */
     readonly xl: "28px";
+    /** Diálogos / modales de confirmación. */
+    readonly dialog: "24px";
     /** Píldora completa. */
     readonly pill: "999px";
 };
@@ -4382,6 +6005,9 @@ export declare function resolveCmsAssetUrl(path: string, cmsOrigin?: string): st
 
 export declare function resolveCmsOrigin(cmsOrigin?: string): string;
 
+/** Devuelve la severidad de toast para un código de error (`warning`/`error`). */
+export declare function resolveErrorSeverity(errorCode: string | number | Array<string | number> | null | undefined): CmsErrorSeverity;
+
 /** Sección de una publicación del CMS (forma devuelta por get/exist). */
 export declare interface Section {
     id?: number;
@@ -4446,7 +6072,7 @@ export declare interface SectionsGetResponse extends CmsResponse {
  * "Todos / Activos / Inactivos"), reutilizable desde cualquier app que consuma
  * la librería.
  */
-export declare function SelectDropdown({ value, options, onChange, highlighted, showIcons, minWidth, disabled, placeholder, ariaLabel, testId, }: SelectDropdownProps): JSX.Element;
+export declare function SelectDropdown({ value, options, onChange, highlighted, showIcons, minWidth, disabled, placeholder, prefix, ariaLabel, testId, }: SelectDropdownProps): JSX.Element;
 
 export declare type SelectDropdownProps = {
     /** Valor seleccionado actualmente. */
@@ -4471,12 +6097,25 @@ export declare type SelectDropdownProps = {
     disabled?: boolean;
     /** Texto a mostrar cuando ningún valor coincide. */
     placeholder?: ReactNode;
+    /**
+     * Prefijo fijo antes del valor seleccionado en el disparador (p. ej.
+     * "Estado:"). Solo aparece en el trigger, no en el menú. El prefijo va en peso
+     * normal y el valor seleccionado en negrita.
+     */
+    prefix?: ReactNode;
     /** `aria-label` del disparador (accesibilidad). */
     ariaLabel?: string;
     /** Valor base para los `data-testid`. */
     testId?: string;
 };
 
+export declare type SelectFieldConfig = BaseFieldConfig & {
+    kind: 'select';
+    options: FieldOption[];
+    /** Muestra el check en la opción activa. Por defecto `true`. */
+    showCheck?: boolean;
+};
+
 /** Opción de un `SelectDropdown`. */
 export declare type SelectOption = {
     /** Valor que se emite en `onChange` y se compara con `value`. */
@@ -4485,6 +6124,13 @@ export declare type SelectOption = {
     label: ReactNode;
     /** Ícono opcional a la izquierda del label. */
     icon?: ReactNode;
+    /**
+     * Color del ícono de esta opción (en el disparador y en el menú). Acepta un
+     * valor de variable del theme (`cmsColors.*`, `feedbackColors.*`) o un path
+     * del tema MUI (p. ej. `'m3.onSurfaceVariant'`). Si se omite, el ícono usa el
+     * gris por defecto (`m3.onSurfaceVariant`).
+     */
+    iconColor?: string;
     /** Si es `false` la opción no se renderiza. Por defecto `true`. */
     show?: boolean;
 };
@@ -4497,7 +6143,7 @@ export declare type SelectOption = {
  * compartidos y reutilizables: cualquier proyecto que consuma la librería puede
  * importarlo para construir un trigger/menú coherente con el sistema.
  *
- * Reglas de color (todas con variables de `tokens.ts`):
+ * 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 activo (abierto) o resaltado (valor activo): fondo `secondary`
@@ -4530,6 +6176,8 @@ export declare const shadows: {
     readonly menu: "0px 1px 3px 0px rgba(0, 0, 0, 0.30), 0px 4px 8px 3px rgba(0, 0, 0, 0.15)";
     /** Paper suave y difuso (dropdowns genéricos). */
     readonly menuSoft: "0 10px 30px rgba(0, 0, 0, 0.18)";
+    /** Desplegable de opciones (M3 Elevation Light/5): dos capas suaves. */
+    readonly menuDropdown: "0px 4px 4px 0px rgba(0, 0, 0, 0.30), 0px 8px 12px 6px rgba(0, 0, 0, 0.15)";
     /** Submenús flotantes del sidebar. */
     readonly flyout: "0px 8px 16px rgba(0, 0, 0, 0.18)";
 };
@@ -4640,8 +6288,76 @@ 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;
+};
+
+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 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";
+    };
 };
 
+/**
+ * Arma y envía el formulario POST que abre una ruta del admin viejo en una
+ * pestaña nueva, pasando la sesión del usuario (igual que cmsmedios).
+ *
+ * @param params.cmsBaseUrl - Origen del CMS (p. ej. `https://dev.cms-medios.com`).
+ * @param params.path - Ruta destino dentro del CMS (campo `r`).
+ * @param params.session - Datos de sesión a enviar (token, sitio, etc.).
+ * @param params.device - Opcional: protocolo/queryString del preview.
+ * @returns void
+ */
+export declare function submitLegacyAdminPage(params: {
+    cmsBaseUrl: string;
+    path: string;
+    session: LegacyAdminSession;
+    device?: LegacyAdminDevice;
+}): void;
+
 /** Filtros de POST /contributions/getSuscriptions. */
 export declare interface SubscriptionsGetFilters {
     /** Filtra por estado de la suscripción. */
@@ -4743,6 +6459,10 @@ export declare interface TagsAdminConfigurationResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+export declare type TagsFieldConfig = BaseFieldConfig & {
+    kind: 'tags';
+};
+
 /** Filtros de POST /tags/get. */
 export declare interface TagsGetFilters {
     /** Tipo de términos: "claves" (default) o "ingredientes". */
@@ -4834,7 +6554,60 @@ export declare interface TagUpdateInput {
     [key: string]: unknown;
 }
 
-export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notifications, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, }: TopBarProps): JSX.Element;
+export declare type TextFieldConfig = BaseFieldConfig & {
+    kind: 'text';
+    /** Tipo HTML del input de texto. Por defecto `text`. */
+    type?: 'text' | 'email' | 'url';
+};
+
+/**
+ * Detalle extra que enriquece el toast de error (replica el toast de error del
+ * Angular legacy: detalle copiable con url/servicio/params/versión).
+ */
+export declare interface ToastErrorDetail {
+    /** Código de error del CMS. Se usa para mapear mensaje y severidad. */
+    errorCode?: string | number | Array<string | number>;
+    /** Texto crudo del error devuelto por el servidor. */
+    error?: string;
+    /** URL del servicio que falló (para el bloque copiable). */
+    service?: string;
+    /** Parámetros del request que falló (para el bloque copiable). */
+    params?: unknown;
+}
+
+/** Opciones del toast de error (comunes + detalle copiable). */
+export declare interface ToastErrorOptions extends ToastOptions, ToastErrorDetail {
+}
+
+/** Item de toast ya normalizado y encolado por el provider. */
+export declare interface ToastItem {
+    id: string;
+    severity: ToastSeverity;
+    message: string;
+    title?: string;
+    /** Null = no autocierra. */
+    duration: number | null;
+    /** Solo presente en toasts de error (habilita el bloque copiable). */
+    detail?: ToastErrorDetail;
+}
+
+export declare type ToastMessageKey = keyof CmsMessages['toast'];
+
+/** Opciones comunes a cualquier toast. */
+export declare interface ToastOptions {
+    /** Título opcional (en negrita, arriba del mensaje). */
+    title?: string;
+    /**
+     * Milisegundos antes de autocerrarse. `null` o `0` = no se cierra solo
+     * (requiere cierre manual). Si se omite, se usa el default por severidad.
+     */
+    duration?: number | null;
+}
+
+/** 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 type TopBarMessageKey = keyof CmsMessages['topBar'];
 
@@ -4843,7 +6616,8 @@ export declare type TopBarProps = {
     sidebarOpen: boolean;
     onToggleSidebar: () => void;
     notificationUnreadCount: number;
-    notifications: DashboardNotification[];
+    /** Respuesta cruda de `POST /dashboard/notification` (newsTask/expireTask/videos). */
+    notificationsData?: DashboardNotificationsResponse | null;
     profile: ProfileGetResponse;
     primaryLogo: ReactNode;
     brandLogo?: ReactNode;
@@ -4851,8 +6625,47 @@ export declare type TopBarProps = {
     getPublicationHref: (publication: Publication) => string;
     resolvePublicationImageUrl?: (imagePath: string) => string;
     profileAvatarOptions?: ProfileAvatarOptions;
+    /** Dominio del CMS Angular legacy (deploy nuevo) para enlaces de perfil. */
+    legacyBaseUrl?: string;
+    /**
+     * Origen del CMS (JSP), p. ej. `https://dev.cms-medios.com`. Se usa para Ayuda
+     * y Preview, que redirigen al admin viejo (NO al deploy de `legacyBaseUrl`).
+     */
+    cmsBaseUrl?: string;
+    /**
+     * Sesión para el redirect al admin viejo (token, sitio, publicación, usuario).
+     * Si se pasa, Ayuda/Preview usan el form POST de cmsmedios; si no, Ayuda cae a
+     * un enlace simple al CMS.
+     */
+    legacySession?: LegacyAdminSession;
+    /** Columnas/ítems del menú "Nuevo". Por defecto, la estructura del CMS legacy. */
+    newContentGroups?: NewContentGroup[];
+    /** Formatos del menú de previsualización. Por defecto, Desktop/Mobile/Tablet. */
+    previewFormats?: PreviewFormat[];
+    /**
+     * Operaciones concedidas al usuario (`POST /auth/permissions`). Si se omite,
+     * no se filtra el menú "Nuevo" por permisos.
+     */
+    operationPermissions?: string[];
+    /** Si el usuario es administrador (ve todos los ítems del menú "Nuevo"). */
+    isAdmin?: boolean;
+    /** Fallback (sin sesión) del clic en un ítem del menú "Nuevo" (recibe su `id`). */
+    onNewContentSelect?: (itemId: string) => void;
+    /** Integración: clic en un formato de previsualización (recibe su `id`). */
+    onPreviewSelect?: (formatId: string) => void;
 };
 
+/**
+ * Desplaza un instante (epoch ms en UTC) al "reloj de pared" de la zona de
+ * redacción del sitio. El número resultante, formateado con `timeZone: 'UTC'`,
+ * muestra la hora local del sitio sin importar la zona del navegador.
+ *
+ * @param epochMs Instante en milisegundos (UTC).
+ * @param gmtRedaction Offset GMT de la publicación.
+ * @returns Epoch ms desplazado por el offset del sitio.
+ */
+export declare function toSiteWallClock(epochMs: number, gmtRedaction: string | null | undefined): number;
+
 /**
  * Cuerpo de la respuesta de POST /transcribe/get.
  *
@@ -4867,6 +6680,9 @@ export declare interface TranscriptionGetResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** Parámetros de interpolación para placeholders `{nombre}` en un mensaje. */
+export declare type TranslationParams = Record<string, string | number>;
+
 /** Trivia del CMS. La forma exacta depende del recurso y del formato pedido. */
 export declare interface Trivia {
     [key: string]: unknown;
@@ -5094,6 +6910,11 @@ export declare interface UploadResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/**
+ * Hook para disparar toasts. Debe usarse dentro de `CmsToastProvider`.
+ */
+export declare function useCmsToast(): CmsToastApi;
+
 export declare function useCmsTranslation(options?: UseCmsTranslationOptions): {
     locale: "pt" | "es" | "en";
     t: CmsTranslator;
@@ -5103,6 +6924,61 @@ export declare type UseCmsTranslationOptions = {
     locale?: Locale;
     messages?: CmsMessagesOverride;
     catalog?: LocaleCatalog;
+    /** Catálogo propio del gestor cuando se usa el hook fuera del provider. */
+    appMessages?: AppLocaleCatalog;
+};
+
+/**
+ * Acceso al estado compartido de la foto del usuario logueado.
+ *
+ * Devuelve `null` si no hay provider montado: así `UserAvatar` y la pantalla de
+ * perfil funcionan también sin el provider (caso tabla de usuarios, donde cada
+ * avatar es otro usuario y no necesita actualización en vivo).
+ */
+export declare function useCurrentUserPhoto(): CurrentUserPhotoContextValue | null;
+
+/**
+ * Avatar de usuario compartible: muestra la foto del usuario y, si no tiene,
+ * el ícono `PersonOutlined` sobre fondo secundario. Incluye tooltip con el
+ * 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 type UserAvatarMessageKey = keyof CmsMessages['userAvatar'];
+
+export declare type UserAvatarProps = {
+    /**
+     * Foto del usuario: ruta relativa, URL absoluta, `''` o `'noPicture'`
+     * (misma forma que el campo `photo` en cmsmedios). Si falta o es `'noPicture'`,
+     * se muestra el ícono de persona sobre fondo secundario.
+     */
+    photo?: string | null;
+    /** Nombre legible del usuario (campo `description` en cmsmedios). Tooltip + alt. */
+    description?: string;
+    /** Login del usuario (campo `username`). Fallback del nombre. */
+    username?: string;
+    /** Diámetro del avatar en px. Por defecto 32. */
+    size?: number;
+    /** Muestra el tooltip con el nombre al pasar el mouse. Por defecto `true`. */
+    showTooltip?: boolean;
+    /** Origen del CMS para resolver rutas relativas de la foto. */
+    cmsOrigin?: string;
+    /**
+     * `crossOrigin` del `<img>`. Sin valor por defecto (lo más seguro para mostrar).
+     * El `TopBar` de la lib usa `'anonymous'`; pasarlo si el CMS lo requiere.
+     */
+    crossOrigin?: 'anonymous' | 'use-credentials';
+    /**
+     * Marca este avatar como el del usuario logueado: así reacciona al cambio de
+     * foto de perfil emitido por `CurrentUserPhotoProvider` (equivalente al
+     * `updateImageProfile` del Angular legacy). Sin provider, usa la prop `photo`.
+     */
+    isCurrentUser?: boolean;
+    /** Acción al hacer clic. Si se define, el avatar muestra cursor de puntero. */
+    onClick?: () => void;
+    /** Base para el `data-testid` (`avatar-<testId>`). */
+    testId?: string;
 };
 
 /** Grupo del sistema devuelto por POST /users/groups/get. */
@@ -5208,9 +7084,29 @@ export declare interface UsersPublicationResponse extends CmsResponse {
 /** Estado posible de un usuario del sistema. */
 export declare type UserStatus = 'active' | 'block' | 'pending';
 
-/** Acción soportada por POST /users/action/setStatus. */
+/** Acción soportada por POST /users/actions/setStatus. */
 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";
+    };
+};
+
 /** Video del CMS. La forma exacta depende del recurso y del formato pedido. */
 export declare interface Video {
     [key: string]: unknown;