sass-cms-template-common 0.0.7 → 0.0.9

package/dist/index.d.ts

@@ -35,14 +35,15 @@ 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, notifications, 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 function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, LinkComponent, permissions, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
 
 export declare 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;
@@ -79,6 +80,12 @@ export declare type AppShellProps = {
     /** Catálogo de mensajes propio del gestor (namespaces libres, es/en/pt). */
     appMessages?: AppLocaleCatalog;
     baseUrl: string;
+    /**
+     * Servicio de pines del sidebar (`CmsProfileServices`, construido por el
+     * host con su `axiosApi`/`authentication`). Si se omite, el anclado de
+     * accesos es solo visual y no persiste entre sesiones.
+     */
+    profileServices?: SidebarRailPinService;
 };
 
 /** Traductor genérico de claves del gestor por ruta con puntos (`ns.clave`). */
@@ -2855,6 +2862,8 @@ export declare const enMessages: {
         readonly collapse: "Collapse";
         readonly expand: "Expand";
         readonly newBadge: "New";
+        readonly pin: "Pin to top";
+        readonly unpin: "Unpin";
     };
     readonly topBar: {
         readonly openSidebar: "Open sidebar menu";
@@ -2899,6 +2908,17 @@ 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…";
@@ -3028,6 +3048,8 @@ export declare const esMessages: {
         collapse: string;
         expand: string;
         newBadge: string;
+        pin: string;
+        unpin: string;
     };
     topBar: {
         openSidebar: string;
@@ -3072,6 +3094,17 @@ 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;
@@ -3221,6 +3254,36 @@ export declare interface ExplorerFolder {
     [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;
 
 /**
@@ -3245,6 +3308,16 @@ export declare const feedbackColors: {
     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";
 };
 
 /**
@@ -3400,6 +3473,8 @@ export declare function findPublicationLabel(sites: SiteSection[], publicationId
 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";
 };
 
 /**
@@ -3961,6 +4036,8 @@ export declare type NavLinkItem = {
     badge?: string;
     children?: NavLinkItem[];
     defaultOpen?: boolean;
+    /** Acento visual (p. ej. destacar un ítem generado/asistido por IA). */
+    accent?: 'ai';
 };
 
 /** Columna del menú "Nuevo" (Frecuentes / Otros / Videos). */
@@ -4500,6 +4577,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;
@@ -4542,13 +4647,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 }`). */
@@ -5492,6 +5605,8 @@ export declare const ptMessages: {
         collapse: string;
         expand: string;
         newBadge: string;
+        pin: string;
+        unpin: string;
     };
     topBar: {
         openSidebar: string;
@@ -5536,6 +5651,17 @@ 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;
@@ -5960,7 +6086,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, prefix, pinSelectedFirst, 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. */
@@ -5991,11 +6117,6 @@ export declare type SelectDropdownProps = {
      * normal y el valor seleccionado en negrita.
      */
     prefix?: ReactNode;
-    /**
-     * Al abrir el menú, mueve la opción seleccionada al tope y la separa del resto
-     * con un divisor. Por defecto `false` (mantiene el orden original).
-     */
-    pinSelectedFirst?: boolean;
     /** `aria-label` del disparador (accesibilidad). */
     ariaLabel?: string;
     /** Valor base para los `data-testid`. */
@@ -6017,6 +6138,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;
 };
@@ -6052,8 +6180,6 @@ export declare const SelectStyles: {
      * Peso normal incluso en la opción activa (la negrita vive en el trigger).
      */
     sxItem: (selected: boolean) => SxProps<Theme>;
-    /** Divisor entre la opción activa (fijada arriba) y el resto del listado. */
-    sxMenuDivider: SxProps<Theme>;
 };
 
 /** Sombras (elevaciones) reutilizables. */
@@ -6083,6 +6209,33 @@ export declare type SidebarProps = {
     selectedPublicationId: string;
 };
 
+/**
+ * Variante compacta del sidebar: rail vertical de íconos con etiqueta debajo,
+ * sin modo expandido. Los ítems con hijos abren un menú flotante a la derecha.
+ * Al pasar el mouse sobre un ítem aparece un botón para anclarlo arriba del
+ * 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, baseUrl, 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'>;
+
+export declare type SidebarRailProps = {
+    pathname: string;
+    LinkComponent?: CmsLinkComponent;
+    permissions: Array<NavItemPermissions>;
+    baseUrl: string;
+    /** Ítems de navegación. Por defecto, `ACCOUNT_NAV_BLOCKS`. */
+    items?: NavLinkItem[];
+    /**
+     * Servicio de pines (`CmsProfileServices`, construido por el host con su
+     * `axiosApi`/`authentication`). Si se omite, el anclado es solo visual y no
+     * persiste entre sesiones.
+     */
+    profileServices?: SidebarRailPinService;
+};
+
 /**
  * Menú desplegable genérico y presentacional. Renderiza una lista de opciones
  * recibidas por props y ejecuta el `onClick` de cada una. Soporta una o dos
@@ -6495,16 +6648,18 @@ 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, notifications, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, }: TopBarProps): JSX.Element;
+export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notificationsData, 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'];
 
 export declare type TopBarProps = {
     sites: SiteSection[];
-    sidebarOpen: boolean;
-    onToggleSidebar: () => void;
+    /** Solo aplica con un sidebar colapsable (p. ej. `Sidebar`). Omitir oculta el botón. */
+    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;