sass-cms-template-common 0.0.17 → 0.0.18

package/dist/index.d.ts

@@ -13,6 +13,13 @@ import { Theme } from '@mui/material/styles';
  * Navegación lateral por defecto.
  * `module` debe coincidir exactamente con `module` en POST /auth/modulesAvailable
  * y con las claves en `messages.navigation`.
+ *
+ * Convención de destino por ítem:
+ * - `jsp: true`  → admin viejo (OpenCMS). Abre con form POST autenticado a
+ *   `cmsBaseUrl` (dev.cms-medios.com), en pestaña nueva. Tiene prioridad.
+ * - `legacy: true` (sin `jsp`) → Angular master (`legacyBaseUrl`). Enlace en
+ *   pestaña nueva.
+ * - sin flags → ruta interna del propio gestor React (misma pestaña).
  */
 export declare const ACCOUNT_NAV_BLOCKS: NavBlock[];
 
@@ -35,7 +42,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, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, LinkComponent, permissions, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
+export declare function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, LinkComponent, permissions, locale, language, messages, appMessages, baseUrl, profileServices, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
@@ -65,16 +72,12 @@ export declare type AppShellProps = {
     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"). */
+    /** Si el usuario es administrador (ve todos los ítems restringidos por permiso). */
     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;
@@ -304,7 +307,7 @@ declare type BaseFieldConfig = {
  * despliega opciones adicionales. Si no hay opciones visibles, la flecha se
  * oculta automáticamente.
  */
-export declare function BtnDropdown({ titleButton, options, icon, onAction, disabled, enableButton, whiteBtn, showDropdownOptions, testId, }: BtnDropdownProps): JSX.Element;
+export declare function BtnDropdown({ titleButton, options, icon, onAction, disabled, enableButton, whiteBtn, showDropdownOptions, openUpward, testId, }: BtnDropdownProps): JSX.Element;
 
 export declare type BtnDropdownProps = {
     /** Texto o nodo (ya traducido) del botón principal. */
@@ -323,6 +326,11 @@ export declare type BtnDropdownProps = {
     whiteBtn?: boolean;
     /** Muestra u oculta la flecha del desplegable. Por defecto `true`. */
     showDropdownOptions?: boolean;
+    /**
+     * Abre el menú hacia arriba (útil cuando el botón vive al pie de un footer o
+     * pegado al margen inferior). Por defecto `false` (abre hacia abajo).
+     */
+    openUpward?: boolean;
     /** Valor base para los `data-testid`. */
     testId?: string;
 };
@@ -2003,22 +2011,48 @@ export declare interface CmsResponseLike {
  * 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.
+ * Con la prop `chips` pasa a **buscador de chips**: cada término escrito se
+ * confirma como chip con `;` (sin buscar) o con Enter (que además ejecuta la
+ * búsqueda), y cada chip se muestra dentro del campo con su "x" para quitarlo
+ * (NAA-4820). Es presentacional y controlado: el texto, los chips y los textos
+ * visibles vienen por props; la decisión de qué abrir en "avanzadas" y cómo
+ * filtrar 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 function CmsSearchField({ value, onChange, onSearch, onClear, placeholder, chips, onChipsChange, chipSeparator, addPlaceholder, removeChipAriaLabel, showIcon, showAdvanced, advancedActive, onAdvancedClick, collapsible, width, grow, maxWidth, endGap, startGap, advancedAriaLabel, clearAriaLabel, ariaLabel, testId, }: CmsSearchFieldProps): JSX.Element;
 
 export declare type CmsSearchFieldProps = {
-    /** Valor del texto de búsqueda (controlado). */
+    /** Valor del texto de búsqueda en curso (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`. */
+    /**
+     * Callback al ejecutar la búsqueda. En modo texto simple recibe el `value`
+     * (string) al presionar Enter. En modo chips recibe la **lista de chips
+     * vigente** (string[]) cuando hay que aplicar la búsqueda: al presionar Enter,
+     * al quitar un chip y al limpiar. Con `;` NO se dispara (los chips se agregan y
+     * esperan; ver §NAA-4820).
+     */
+    onSearch?: (value: string | string[]) => void;
+    /** Callback al limpiar el campo. Si no se pasa, igual limpia `value` (y chips). */
     onClear?: () => void;
     /** Placeholder del input (ya traducido y modificable por el consumidor). */
     placeholder?: string;
+    /**
+     * Modo "chips": lista controlada de términos de búsqueda ya confirmados. Si se
+     * pasa (aunque sea `[]`), el buscador funciona como buscador de chips: cada
+     * término escrito se confirma como chip con `;` (sin buscar) o con Enter (que
+     * además ejecuta la búsqueda). Los chips se muestran dentro del campo, cada uno
+     * con su "x" para quitarlo. Sin esta prop, el campo es un buscador de texto simple.
+     */
+    chips?: string[];
+    /** Callback con la nueva lista de chips (al agregar o quitar). */
+    onChipsChange?: (chips: string[]) => void;
+    /** Tecla que confirma un chip sin ejecutar la búsqueda. Por defecto `;`. */
+    chipSeparator?: string;
+    /** Placeholder cuando ya hay chips (ya traducido). Por defecto el de la lib ("Agregar…"). */
+    addPlaceholder?: string;
+    /** `aria-label` del botón de quitar un chip. */
+    removeChipAriaLabel?: string;
     /** Muestra la lupa a la izquierda. Por defecto `true`. */
     showIcon?: boolean;
     /** Muestra el botón de opciones avanzadas (tres puntos). Por defecto `false`. */
@@ -2045,6 +2079,13 @@ export declare type CmsSearchFieldProps = {
     maxWidth?: number | string;
     /** Espacio mínimo a la derecha cuando `grow` está activo. Por defecto `40`. */
     endGap?: number;
+    /**
+     * Separación fija a la izquierda (px) cuando `grow` está activo. Si se pasa, el
+     * buscador **llena** el espacio restante dejando este hueco respecto del control
+     * previo (p. ej. un filtro), en reposo y expandido. Si se omite, en reposo se
+     * alinea a la derecha con ancho `width` y crece al enfocar.
+     */
+    startGap?: number;
     /** `aria-label` del botón de avanzadas. */
     advancedAriaLabel?: string;
     /** `aria-label` del botón de limpiar. */
@@ -3048,10 +3089,34 @@ export declare interface DashboardNotificationsResponse extends CmsResponse {
     newsTask?: DashboardNewsTask[];
     /** Actividades vencidas o por vencer. */
     expireTask?: DashboardExpireTask[];
+    /** Avisos de desasignación de tarea de planning (`person_remove`). */
+    unassignTask?: DashboardUnassignTask[];
     /** Oportunidades editoriales copilot (hasta 3, por `score` desc). NAA-4645. */
     copilot?: DashboardCopilotOpportunity[];
 }
 
+/**
+ * Aviso de desasignación de tarea de planning presente en POST
+ * /dashboard/notification (array `unassignTask`, mismos campos que `newsTask`).
+ * El back lo despacha solo cuando corresponde (cambio de responsable). El autor
+ * de la desasignación es OPCIONAL: puede venir como `userName` o `userCreation`,
+ * con `userLogin` entre paréntesis. Si no llega ninguno, se usa el texto genérico.
+ */
+export declare interface DashboardUnassignTask {
+    id?: string;
+    /** Título de la tarea de la que se desasignó al usuario. */
+    title?: string;
+    /** Autor de la desasignación (nombre). Opcional. */
+    userName?: string;
+    userCreation?: string;
+    /** Login del autor (se muestra entre paréntesis). Opcional. */
+    userLogin?: string;
+    /** Timestamp del aviso (epoch ms o `{ time }`). */
+    timeStamp?: unknown;
+    isRead?: boolean;
+    [key: string]: unknown;
+}
+
 /** Evento de encoder de video presente en POST /dashboard/notification. */
 export declare interface DashboardVideoNotification {
     actionId?: number;
@@ -3292,6 +3357,9 @@ export declare const enMessages: {
         readonly assignedYesterday: "Assigned yesterday";
         readonly assignedOn: "Assigned on";
         readonly expires: "Due";
+        readonly unassignedText: "You are no longer responsible for the task";
+        readonly unassignedRemovedYouFrom: "removed you from the task";
+        readonly unassignedNoLongerResponsible: "You are no longer responsible.";
         readonly editorialOpportunityLabel: "Editorial opportunity";
         readonly editorialOpportunityText: "{count} topics require your attention";
         readonly editorialOpportunityTop: "Top";
@@ -3304,8 +3372,10 @@ export declare const enMessages: {
     };
     readonly search: {
         readonly placeholder: "Search…";
+        readonly addPlaceholder: "Add…";
         readonly inputAriaLabel: "Search";
         readonly clearAriaLabel: "Clear search";
+        readonly removeChipAriaLabel: "Remove term";
         readonly advancedAriaLabel: "Advanced search";
         readonly title: "Advanced search";
         readonly apply: "Apply";
@@ -3513,6 +3583,9 @@ export declare const esMessages: {
         assignedYesterday: string;
         assignedOn: string;
         expires: string;
+        unassignedText: string;
+        unassignedRemovedYouFrom: string;
+        unassignedNoLongerResponsible: string;
         editorialOpportunityLabel: string;
         editorialOpportunityText: string;
         editorialOpportunityTop: string;
@@ -3525,8 +3598,10 @@ export declare const esMessages: {
     };
     search: {
         placeholder: string;
+        addPlaceholder: string;
         inputAriaLabel: string;
         clearAriaLabel: string;
+        removeChipAriaLabel: string;
         advancedAriaLabel: string;
         title: string;
         apply: string;
@@ -3969,6 +4044,14 @@ export declare function getProfileAvatarSrc(profile: ProfileGetResponse, options
 
 export declare function getProfileDisplayName(profile: ProfileGetResponse): string;
 
+/**
+ * Nombre y apellido del usuario, SIN el nickname/login. Para el título del
+ * desplegable de perfil, donde no debe aparecer el nickname (a diferencia de
+ * `getProfileDisplayName`, que puede caer en `fullName` —que incluye el
+ * nickname— o en `userName`). Solo cae a `userName` si no hay nombre ni apellido.
+ */
+export declare function getProfileFullName(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.
@@ -4525,6 +4608,15 @@ export declare type NavLinkItem = {
     accent?: 'ai';
     /** Si el href apunta al admin legacy (JSP/Angular), se prefija con `legacyBaseUrl`. */
     legacy?: boolean;
+    /**
+     * Si el href es una página del admin viejo JSP (OpenCMS). Estos NO se abren
+     * como enlace directo: requieren el form POST autenticado
+     * (`submitLegacyAdminPage`) al endpoint `adminBack/login` del CMS
+     * (`cmsBaseUrl`, p. ej. `https://dev.cms-medios.com`), igual que el
+     * `openExternalPage()` de cmsmedios. Abre en pestaña nueva. Tiene prioridad
+     * sobre `legacy` (que apunta al Angular master).
+     */
+    jsp?: 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
@@ -5106,6 +5198,11 @@ export declare const notificationColors: {
         readonly bg: string;
         readonly on: string;
     };
+    /** Desasignación de tarea (person_remove): mismo fondo/ícono que asignados. */
+    readonly unassigned: {
+        readonly bg: string;
+        readonly on: string;
+    };
 };
 
 /** Topic devuelto por notification/adminConfiguration (`{ name, value }`). */
@@ -6203,6 +6300,9 @@ export declare const ptMessages: {
         assignedYesterday: string;
         assignedOn: string;
         expires: string;
+        unassignedText: string;
+        unassignedRemovedYouFrom: string;
+        unassignedNoLongerResponsible: string;
         editorialOpportunityLabel: string;
         editorialOpportunityText: string;
         editorialOpportunityTop: string;
@@ -6215,8 +6315,10 @@ export declare const ptMessages: {
     };
     search: {
         placeholder: string;
+        addPlaceholder: string;
         inputAriaLabel: string;
         clearAriaLabel: string;
+        removeChipAriaLabel: string;
         advancedAriaLabel: string;
         title: string;
         apply: string;
@@ -6407,6 +6509,8 @@ export declare const radii: {
     readonly sm: "8px";
     /** Ítems de menú. */
     readonly md: "10px";
+    /** Flyout desplegable del menú lateral (submenús del Sidebar). */
+    readonly flyout: "12px";
     /** Papers de menú (dropdowns). */
     readonly lg: "14px";
     /** Menús flotantes de cuenta (perfil): esquinas 16px. */
@@ -6809,8 +6913,8 @@ export declare const shadows: {
     readonly accountMenu: "0 10px 30px rgba(25, 28, 32, 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)";
+    /** Submenús flotantes del sidebar (flyout del menú lateral). */
+    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;
@@ -6834,7 +6938,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, selectedPublicationId, items, profileServices, }: SidebarRailProps): JSX.Element;
+export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, cmsBaseUrl, legacySession, 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'>;
@@ -6843,8 +6947,12 @@ export declare type SidebarRailProps = {
     pathname: string;
     LinkComponent?: CmsLinkComponent;
     permissions: Array<NavItemPermissions>;
-    /** Dominio del admin legacy (JSP/Angular) para prefijar hrefs con `item.legacy`. */
+    /** Dominio del Angular master para prefijar hrefs `legacy` (no `jsp`). */
     legacyBaseUrl?: string;
+    /** Origen del CMS viejo (JSP) para el form POST de los ítems `jsp`. */
+    cmsBaseUrl?: string;
+    /** Sesión para el form POST al admin viejo (token, sitio, publicación, usuario). */
+    legacySession?: LegacyAdminSession;
     /** Id de publicación activa; se agrega a los ítems legacy con `appendPublicationId`. */
     selectedPublicationId?: string;
     /** Ítems de navegación. Por defecto, `ACCOUNT_NAV_BLOCKS`. */
@@ -7252,7 +7360,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, newContentGroups, previewFormats, operationPermissions, isAdmin, onNewContentSelect, onPreviewSelect, }: TopBarProps): JSX.Element;
+export declare function TopBar({ sites, sidebarOpen, onToggleSidebar, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, }: TopBarProps): JSX.Element;
 
 export declare type TopBarMessageKey = keyof CmsMessages['topBar'];
 
@@ -7290,19 +7398,15 @@ export declare type TopBarProps = {
      * 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.
+     * Operaciones concedidas al usuario (`POST /auth/permissions`). Filtran los
+     * ítems del menú de perfil según permisos.
      */
     operationPermissions?: string[];
-    /** Si el usuario es administrador (ve todos los ítems del menú "Nuevo"). */
+    /** Si el usuario es administrador (ve todos los ítems restringidos por permiso). */
     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;
 };
@@ -7622,7 +7726,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, inactive, neutralFallback, cmsOrigin, crossOrigin, isCurrentUser, onClick, testId, }: UserAvatarProps): JSX.Element;
+export declare function UserAvatar({ photo, description, username, size, showTooltip, inactive, neutralFallback, transparentFallbackBg, cmsOrigin, crossOrigin, isCurrentUser, onClick, testId, }: UserAvatarProps): JSX.Element;
 
 export declare type UserAvatarMessageKey = keyof CmsMessages['userAvatar'];
 
@@ -7652,6 +7756,12 @@ export declare type UserAvatarProps = {
      * cuenta del header/perfil. Sin efecto si hay foto o si `inactive`.
      */
     neutralFallback?: boolean;
+    /**
+     * Solo con `neutralFallback`: el fondo del fallback queda transparente (no
+     * pinta el círculo gris en reposo). Pensado para el disparador del perfil en
+     * el header, donde el botón contenedor pinta el círculo al hover.
+     */
+    transparentFallbackBg?: boolean;
     /** Origen del CMS para resolver rutas relativas de la foto. */
     cmsOrigin?: string;
     /**