sass-cms-template-common 0.0.35 → 0.0.36

package/dist/index.d.ts

@@ -24,6 +24,9 @@ import { Theme } from '@mui/material/styles';
  */
 export declare const ACCOUNT_NAV_BLOCKS: NavBlock[];
 
+/** Módulo del Authenticator que guarda los pines del menú de cmsmedios. */
+export declare const ADMIN_ANGULAR_MODULE = "admin-angular";
+
 /**
  * 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`
@@ -43,7 +46,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, onNotificationsOpen, notificationsLoading, 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 function AppShell({ pathname, sites, children, notificationUnreadCount, notificationsData, copilotSuggestionsHref, onEditorialSeeMore, onEditorialRemindLater, onNotificationsOpen, notificationsLoading, profile, primaryLogo, brandLogo, selectedPublicationId, getPublicationHref, resolvePublicationImageUrl, profileAvatarOptions, legacyBaseUrl, cmsBaseUrl, legacySession, previewFormats, operationPermissions, isAdmin, onPreviewSelect, showAppearanceMenu, LinkComponent, permissions, navHrefOverrides, locale, language, messages, appMessages, baseUrl, profileServices, sidebarAuthService, }: AppShellProps): JSX.Element;
 
 export declare type AppShellProps = {
     pathname: string;
@@ -111,6 +114,11 @@ export declare type AppShellProps = {
      * accesos es solo visual y no persiste entre sesiones.
      */
     profileServices?: SidebarRailPinService;
+    /**
+     * Pines y módulos hermanos del Authenticator (como cmsmedios). Si se pasa, el
+     * menú lateral lo usa en vez de los pines de `profileServices`.
+     */
+    sidebarAuthService?: SidebarRailAuthService;
 };
 
 /** Traductor genérico de claves del gestor por ruta con puntos (`ns.clave`). */
@@ -264,6 +272,13 @@ export declare interface AuthPermissionsResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** Identidad del pin en el Authenticator. */
+declare type AuthPinRef = {
+    moduleName: string;
+    itemKey: string;
+    pinned: boolean;
+};
+
 /** Cuerpo de la respuesta de POST /auth/relogin. */
 export declare interface AuthReloginResponse extends CmsResponse, AuthSessionData {
 }
@@ -296,6 +311,30 @@ export declare interface AuthSessionResult extends CmsResponse {
 /** Respuesta de POST /auth/setNewPassword. */
 export declare type AuthSetNewPasswordResponse = AuthSessionResult;
 
+/** Ítem de `GET /api/v1/auth/sidebar` (lo que el menú usa). */
+export declare type AuthSidebarItem = {
+    itemKey: string;
+    translations?: Record<string, string>;
+    icon?: string | null;
+    href?: string | null;
+    pinned?: boolean;
+};
+
+export declare type AuthSidebarResponse = {
+    sections?: AuthSidebarSection[];
+};
+
+/** Módulo (webapp) de `GET /api/v1/auth/sidebar`. */
+export declare type AuthSidebarSection = {
+    moduleName: string;
+    translations?: Record<string, string>;
+    icon?: string | null;
+    url?: string | null;
+    /** `false` = solo aporta ítems; no es una webapp a la que saltar. */
+    sidebarHost?: boolean;
+    items?: AuthSidebarItem[];
+};
+
 /** Propiedades comunes a todos los campos de la configuración. */
 declare type BaseFieldConfig = {
     /** Identificador único del campo (clave en `FieldValues`). */
@@ -351,6 +390,17 @@ export declare type BtnDropdownProps = {
     testId?: string;
 };
 
+/**
+ * Aplica sobre el menú lo mismo que cmsmedios toma del Authenticator:
+ * 1. Pines de `admin-angular` (su `itemKey` en mayúsculas = `module` del ítem).
+ *    Van arriba en el orden de cmsmedios: sección por sección, de atrás hacia
+ *    adelante (primero los hijos anclados de un ítem con submenú). Salen de su
+ *    lugar original.
+ * 2. Pines de otras apps: también arriba, como links a esa app.
+ * 3. Módulos hermanos (`sidebarHost !== false`): al final de la primera sección.
+ */
+export declare function buildCmsmediosMenu(groups: NavLinkItem[][], permissions: Array<NavItemPermissions>, sidebar: AuthSidebarResponse | null, locale: string, selectedPublicationId?: string): CmsmediosMenuLayout;
+
 /**
  * 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
@@ -532,6 +582,23 @@ export declare interface ClassifiedNetworkError {
  */
 export declare function classifyNetworkError(error: unknown): ClassifiedNetworkError | null;
 
+/**
+ * Menú lateral igual al de cmsmedios y al del gestor de noticias (NAA-5415):
+ * copia del `CMS_MENU_CATALOG` de `bluestack-cms-news`
+ * (`src/components/sidebar/cmsMenuCatalog.ts`), que a su vez copia el
+ * `defaultMenuSections` de `cmsmedios-ux` (`menu.service.ts`). Si cambia allá,
+ * se replica acá: entre gestores de React el menú tiene que ser el mismo.
+ *
+ * Tres secciones separadas por una línea. Dentro de cada una, el orden es el
+ * de cmsmedios (alfabético por el texto fijo en español, igual en todos los
+ * idiomas) con "Otros" al final de la primera. Ya viene ordenado: el filtro por
+ * módulos/permisos solo quita ítems, no reordena.
+ *
+ * Los ítems de otros gestores React (Noticias, CoPilot, Usuarios) los resuelve
+ * cada gestor con `navHrefOverrides`; el href de acá es el de respaldo.
+ */
+export declare const CMS_MENU_SECTIONS: NavLinkItem[][];
+
 /**
  * Contenedor de "Búsqueda avanzada" reutilizable y declarativo. Recibe una lista
  * de `fields` y los renderiza en una grilla, manejando el estado del formulario
@@ -1392,6 +1459,13 @@ export declare type CmsLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     children?: ReactNode;
 };
 
+/** Menú ya resuelto: anclados arriba, secciones y la identidad de pin de cada ítem. */
+declare type CmsmediosMenuLayout = {
+    pinned: NavLinkItem[];
+    groups: NavLinkItem[][];
+    pinRefs: Map<NavLinkItem, AuthPinRef>;
+};
+
 /** Message tree shape; values are strings, keys are inferred from `enMessages`. */
 export declare type CmsMessages = DeepStringMap<typeof enMessages>;
 
@@ -3425,29 +3499,29 @@ export declare const enMessages: {
         readonly COMMENTS: "Comments";
         readonly POLLS: "Polls";
         readonly MEDIA: "Media";
-        readonly AUDIOS: "Audio";
+        readonly AUDIOS: "Audios";
         readonly IMAGES: "Images";
         readonly PLAYLISTS: "Playlist";
         readonly VIDEOS: "Videos";
-        readonly NEWS: "News";
+        readonly NEWS: "Posts";
         readonly PLANNING: "Planning";
         readonly ANALYTICS: "Analytics";
         readonly TAGS: "Tags";
-        readonly TRIVIAS: "Trivia";
-        readonly OTHERS: "Other";
+        readonly TRIVIAS: "Trivias";
+        readonly OTHERS: "Others";
         readonly NEWSWIRES: "News Wires";
         readonly EVENTS: "Events";
-        readonly PAGES: "Pages";
+        readonly PAGES: "Explorer";
         readonly FEEDS: "Feed";
         readonly PERSONS: "People";
         readonly CONTRIBUTIONS: "Contributions";
         readonly RECIPES: "Recipes";
-        readonly POSTS: "Posts";
+        readonly POSTS: "UGC";
         readonly BANNERS: "Banners";
         readonly BLOCKS: "Blocks";
         readonly MENUS: "Menu";
-        readonly TOPICS: "Topics";
-        readonly ADVANCEDQUERYS: "Advanced search";
+        readonly TOPICS: "Themes";
+        readonly ADVANCEDQUERYS: "Search";
         readonly IMPORTS: "Imports";
         readonly NEWSLETTERS: "Newsletters";
         readonly NOTIFICATIONS: "Notifications";
@@ -3460,6 +3534,12 @@ export declare const enMessages: {
         readonly COPILOT: "CoPilot";
         readonly ZONES: "Zones";
         readonly IA: "IA";
+        readonly PRODUCTION: "Production";
+        readonly FREQUENCY: "Frequency";
+        readonly VODS: "Videos OnDemand";
+        readonly SUBSCRIPTIONS: "Subscriptions";
+        readonly MYPLAN: "Production";
+        readonly USERS_MANAGER: "Users";
     };
     readonly sidebar: {
         readonly navAriaLabel: "Main navigation";
@@ -3698,6 +3778,12 @@ export declare const esMessages: {
         COPILOT: string;
         ZONES: string;
         IA: string;
+        PRODUCTION: string;
+        FREQUENCY: string;
+        VODS: string;
+        SUBSCRIPTIONS: string;
+        MYPLAN: string;
+        USERS_MANAGER: string;
     };
     sidebar: {
         navAriaLabel: string;
@@ -4230,6 +4316,13 @@ export declare function formatSiteDateTime(epochMs: number, gmtRedaction: string
 
 export declare function getAllPublications(sites: SiteSection[]): Publication[];
 
+/**
+ * Ícono a partir del nombre que guarda el Authenticator (`"PollIcon"`), en su
+ * variante Outlined. El barrel de íconos se baja aparte y solo para estos
+ * ítems; mientras llega (o si el nombre no existe) se ve el genérico.
+ */
+export declare function getAuthSidebarIcon(name?: string | null): ElementType;
+
 /**
  * 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`)
@@ -4872,6 +4965,16 @@ export declare type NavLinkItem = {
     module: string;
     /** Override opcional del label traducido vía i18n (`navigation.{module}`). */
     label?: string;
+    /**
+     * Clave i18n de `navigation` cuando no coincide con `module` (p. ej. PLANS y
+     * MYPLAN se leen los dos como `PRODUCTION`). Si falta, se usa `module`.
+     */
+    labelKey?: string;
+    /**
+     * Se dibuja aunque su `module` no venga en `modulesAvailable` (ítems que manda
+     * el Authenticator: pines de otras apps y módulos hermanos).
+     */
+    alwaysVisible?: boolean;
     badge?: string;
     children?: NavLinkItem[];
     defaultOpen?: boolean;
@@ -6510,6 +6613,12 @@ export declare const ptMessages: {
         COPILOT: string;
         ZONES: string;
         IA: string;
+        PRODUCTION: string;
+        FREQUENCY: string;
+        VODS: string;
+        SUBSCRIPTIONS: string;
+        MYPLAN: string;
+        USERS_MANAGER: string;
     };
     sidebar: {
         navAriaLabel: string;
@@ -7271,7 +7380,20 @@ 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, navHrefOverrides, items, profileServices, }: SidebarRailProps): JSX.Element;
+export declare function SidebarRail({ pathname, permissions, LinkComponent, legacyBaseUrl, cmsBaseUrl, legacySession, selectedPublicationId, navHrefOverrides, items, sections, profileServices, authService, }: SidebarRailProps): JSX.Element;
+
+/**
+ * Pines y módulos hermanos del Authenticator, igual que cmsmedios
+ * (`MenuService.mergeWithAuthenticatorSidebar` + `PinesService`). El gestor lo
+ * arma con su token y la publicación actual:
+ * - `getSidebar` → `GET /api/v1/auth/sidebar?publicationId=N`
+ * - `pin` / `unpin` → `POST` / `DELETE /api/v1/auth/sidebar/pin`
+ */
+export declare type SidebarRailAuthService = {
+    getSidebar: () => Promise<AuthSidebarResponse>;
+    pin: (moduleName: string, itemKey: string) => Promise<void>;
+    unpin: (moduleName: string, itemKey: string) => Promise<void>;
+};
 
 /** Servicio de pines usado por el rail: solo necesita estos tres métodos. */
 export declare type SidebarRailPinService = Pick<CmsProfileServices, 'addPins' | 'deletePins' | 'getPins'>;
@@ -7293,14 +7415,28 @@ export declare type SidebarRailProps = {
      * gestor hermano para el ajeno). Misma pestaña. Ver `resolveNavHrefOverride`.
      */
     navHrefOverrides?: Record<string, string>;
-    /** Ítems de navegación. Por defecto, `ACCOUNT_NAV_BLOCKS`. */
+    /**
+     * Ítems en una sola lista, sin separadores. Si se pasa, gana sobre `sections`
+     * (compatibilidad con los gestores que mandaban su propia lista).
+     */
     items?: NavLinkItem[];
+    /**
+     * Ítems agrupados en secciones separadas por una línea. Por defecto,
+     * `CMS_MENU_SECTIONS`: el mismo menú que cmsmedios y el gestor de noticias.
+     */
+    sections?: 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;
+    /**
+     * Pines y módulos hermanos del Authenticator, como cmsmedios. Si se pasa,
+     * reemplaza a `profileServices` (pines viejos del perfil del CMS) y el orden
+     * de los anclados es el de cmsmedios. Ver `buildCmsmediosMenu`.
+     */
+    authService?: SidebarRailAuthService;
 };
 
 /**