sass-cms-template-common 0.0.13 → 0.0.15

package/dist/index.d.ts

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