sass-cms-template-common 0.0.8 → 0.0.10

package/dist/index.d.ts

@@ -35,7 +35,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, 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;
@@ -80,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`). */
@@ -2856,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";
@@ -3040,6 +3048,8 @@ export declare const esMessages: {
         collapse: string;
         expand: string;
         newBadge: string;
+        pin: string;
+        unpin: string;
     };
     topBar: {
         openSidebar: string;
@@ -4026,6 +4036,10 @@ export declare type NavLinkItem = {
     badge?: string;
     children?: NavLinkItem[];
     defaultOpen?: boolean;
+    /** Acento visual (p. ej. destacar un ítem generado/asistido por IA). */
+    accent?: 'ai';
+    /** Si el href apunta al admin legacy (JSP/Angular), se prefija con `legacyBaseUrl`. */
+    legacy?: boolean;
 };
 
 /** Columna del menú "Nuevo" (Frecuentes / Otros / Videos). */
@@ -5593,6 +5607,8 @@ export declare const ptMessages: {
         collapse: string;
         expand: string;
         newBadge: string;
+        pin: string;
+        unpin: string;
     };
     topBar: {
         openSidebar: string;
@@ -6182,7 +6198,7 @@ export declare const shadows: {
     readonly flyout: "0px 8px 16px rgba(0, 0, 0, 0.18)";
 };
 
-export declare function Sidebar({ open, pathname, permissions, LinkComponent, baseUrl, selectedPublicationId, }: SidebarProps): JSX.Element;
+export declare function Sidebar({ open, pathname, permissions, LinkComponent, legacyBaseUrl, selectedPublicationId, }: SidebarProps): JSX.Element;
 
 export declare type SidebarMessageKey = keyof CmsMessages['sidebar'];
 
@@ -6191,10 +6207,39 @@ export declare type SidebarProps = {
     pathname: string;
     LinkComponent?: CmsLinkComponent;
     permissions: Array<NavItemPermissions>;
-    baseUrl: string;
+    /** Dominio del admin legacy (JSP/Angular) para prefijar hrefs con `item.legacy`. */
+    legacyBaseUrl?: string;
     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, legacyBaseUrl, 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>;
+    /** Dominio del admin legacy (JSP/Angular) para prefijar hrefs con `item.legacy`. */
+    legacyBaseUrl?: 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
@@ -6613,8 +6658,9 @@ 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;
     /** Respuesta cruda de `POST /dashboard/notification` (newsTask/expireTask/videos). */
     notificationsData?: DashboardNotificationsResponse | null;