sass-cms-template-common 0.0.19 → 0.0.21

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { AnchorHTMLAttributes } from 'react';
 import { AxiosInstance } from 'axios';
 import { Context } from 'react';
+import { CSSProperties } from 'react';
 import { ElementType } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { JSX } from 'react';
@@ -42,7 +43,7 @@ export declare type AppMessageNode = string | {
 /** Árbol de mensajes del gestor (namespaces → claves → string anidable). */
 export declare type AppMessages = Record<string, AppMessageNode>;
 
-export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, LinkComponent, permissions, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
+export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, showAppearanceMenu, LinkComponent, permissions, navHrefOverrides, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
@@ -80,8 +81,19 @@ export declare type AppShellProps = {
     isAdmin?: boolean;
     /** Integración: clic en un formato de previsualización (recibe su `id`). */
     onPreviewSelect?: (formatId: string) => void;
+    /** Muestra el menú "Apariencia" (claro/oscuro) del TopBar. Por defecto `true`. */
+    showAppearanceMenu?: boolean;
     LinkComponent?: CmsLinkComponent;
     permissions: Array<NavItemPermissions>;
+    /**
+     * Override de destino por `module` del sidebar, para los ítems que representan
+     * a un gestor del ecosistema. El gestor manda su propio ítem a `/` (home) y el
+     * del gestor hermano al dominio de su deploy (misma pestaña, redirección real).
+     * Gestor de usuarios: `{ USERS: '/', COPILOT: <deploy sugerencias> }`; gestor
+     * de sugerencias: `{ COPILOT: '/', USERS: <deploy usuarios> }`. Un valor vacío
+     * se ignora (navegación interna normal). Ver `resolveNavHrefOverride`.
+     */
+    navHrefOverrides?: Record<string, string>;
     locale?: Locale | string;
     /** Alias de `locale`. */
     language?: Locale | string;
@@ -1495,7 +1507,9 @@ export declare type CmsNetworkState = 'online' | 'offline';
  * 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".
+ * - Al recuperarla → cierra el anterior. No muestra "conexión restablecida":
+ *   era redundante (el toast "reintentando" de `useResilientAction` y el de
+ *   éxito de la acción ya evidencian que se reanudó) y apilaba toasts.
  *
  * Se monta una sola vez, dentro de `CmsNetworkProvider` + `CmsToastProvider`.
  * El reintento y "reanudar el llamado" por acción los maneja
@@ -2294,7 +2308,7 @@ export declare type CmsTextFieldProps = {
     testId?: string;
 };
 
-export declare function CmsToast({ item, t, localeTag, appVersion, onClose, }: CmsToastProps): JSX.Element;
+export declare const CmsToast: ForwardRefExoticComponent<CmsToastProps & RefAttributes<HTMLDivElement>>;
 
 export declare interface CmsToastApi {
     /** Toast de éxito (verde). */
@@ -2339,6 +2353,11 @@ export declare interface CmsToastProps {
     /** Versión a mostrar en el detalle del error (app o lib). */
     appVersion: string;
     onClose: (id: string) => void;
+    /**
+     * Estilos inline que inyecta la transición (`Slide` de MUI) para animar la
+     * entrada/salida del toast. Se aplican al nodo raíz.
+     */
+    style?: CSSProperties;
 }
 
 /**
@@ -3312,6 +3331,7 @@ export declare const enMessages: {
         readonly SECTIONS: "Sections";
         readonly TWITTERS: "Twitter Feeds";
         readonly USERS: "Users";
+        readonly COPILOT: "CoPilot";
         readonly ZONES: "Zones";
         readonly IA: "IA";
     };
@@ -3479,7 +3499,6 @@ export declare const enMessages: {
     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";
@@ -3538,6 +3557,7 @@ export declare const esMessages: {
         SECTIONS: string;
         TWITTERS: string;
         USERS: string;
+        COPILOT: string;
         ZONES: string;
         IA: string;
     };
@@ -3705,7 +3725,6 @@ export declare const esMessages: {
     network: {
         disconnected: string;
         retrying: string;
-        restored: string;
     };
     userAvatar: {
         alt: string;
@@ -6274,6 +6293,7 @@ export declare const ptMessages: {
         SECTIONS: string;
         TWITTERS: string;
         USERS: string;
+        COPILOT: string;
         ZONES: string;
         IA: string;
     };
@@ -6441,7 +6461,6 @@ export declare const ptMessages: {
     network: {
         disconnected: string;
         retrying: string;
-        restored: string;
     };
     userAvatar: {
         alt: string;
@@ -6966,7 +6985,7 @@ export declare const shadows: {
     readonly flyout: "0 6px 12px rgba(0, 0, 0, 0.15), 0 2px 4px rgba(0, 0, 0, 0.10)";
 };
 
-export declare function Sidebar({ open, pathname, permissions, LinkComponent, legacyBaseUrl, selectedPublicationId, }: SidebarProps): JSX.Element;
+export declare function Sidebar({ open, pathname, permissions, LinkComponent, legacyBaseUrl, selectedPublicationId, navHrefOverrides, }: SidebarProps): JSX.Element;
 
 export declare type SidebarMessageKey = keyof CmsMessages['sidebar'];
 
@@ -6978,6 +6997,8 @@ export declare type SidebarProps = {
     /** Dominio del admin legacy (JSP/Angular) para prefijar hrefs con `item.legacy`. */
     legacyBaseUrl?: string;
     selectedPublicationId: string;
+    /** Override de destino por `module` (home `/` o dominio del gestor hermano). Ver `resolveNavHrefOverride`. */
+    navHrefOverrides?: Record<string, string>;
 };
 
 /**
@@ -6987,7 +7008,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, cmsBaseUrl, legacySession, selectedPublicationId, items, profileServices, }: SidebarRailProps): JSX.Element;
+export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, cmsBaseUrl, legacySession, selectedPublicationId, navHrefOverrides, 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'>;
@@ -7004,6 +7025,11 @@ export declare type SidebarRailProps = {
     legacySession?: LegacyAdminSession;
     /** Id de publicación activa; se agrega a los ítems legacy con `appendPublicationId`. */
     selectedPublicationId?: string;
+    /**
+     * Override de destino por `module` (home `/` para el propio gestor, dominio del
+     * gestor hermano para el ajeno). Misma pestaña. Ver `resolveNavHrefOverride`.
+     */
+    navHrefOverrides?: Record<string, string>;
     /** Ítems de navegación. Por defecto, `ACCOUNT_NAV_BLOCKS`. */
     items?: NavLinkItem[];
     /**
@@ -7154,6 +7180,22 @@ export declare interface SubscriptionsGetResponse extends CmsResponse {
 
 export declare const SUPPORTED_LOCALES: readonly ["es", "en", "pt"];
 
+/**
+ * Superficie estándar de los menús desplegables (dropdowns, flyouts del menú
+ * lateral, kebab de acciones de fila, "Mi Perfil", etc.). Unifica **borde +
+ * radio + sombra** para que todos mantengan la misma estética (NAA-4799: algunos
+ * papers tenían solo sombra, sin el borde definido, y se perdían contra el
+ * fondo, que comparte el mismo gris).
+ *
+ * - Borde `divider` (= `outlineVariant`, #C4C6CF en claro / #3A3E46 en oscuro):
+ *   el mismo que ya usaba el flyout del menú lateral.
+ * - Radio `radii.flyout` (12px) y sombra `shadows.flyout` (dos capas suaves).
+ *
+ * Cada paper agrega aparte lo suyo (ancho mínimo, padding, `overflow`, margen de
+ * separación con el disparador). Se aplica con `...(sxMenuSurface as object)`.
+ */
+export declare const sxMenuSurface: SxProps<Theme>;
+
 /** Botón pill completo y autónomo. Reutilizable en cualquier CTA de la lib. */
 export declare function sxPillButton(variant?: CmsButtonVariant): SxProps<Theme>;
 
@@ -7409,7 +7451,7 @@ export declare interface ToastOptions {
 /** Severidad visual de un toast. */
 export declare type ToastSeverity = 'success' | 'error' | 'warning' | 'info';
 
-export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, }: TopBarProps): JSX.Element;
+export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, showAppearanceMenu, }: TopBarProps): JSX.Element;
 
 export declare type TopBarMessageKey = keyof CmsMessages['topBar'];
 
@@ -7458,6 +7500,8 @@ export declare type TopBarProps = {
     isAdmin?: boolean;
     /** Integración: clic en un formato de previsualización (recibe su `id`). */
     onPreviewSelect?: (formatId: string) => void;
+    /** Muestra el menú "Apariencia" (claro/oscuro). Por defecto `true`. */
+    showAppearanceMenu?: boolean;
 };
 
 /**