sass-cms-template-common 0.0.8 → 0.0.9

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,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). */
@@ -5593,6 +5605,8 @@ export declare const ptMessages: {
         collapse: string;
         expand: string;
         newBadge: string;
+        pin: string;
+        unpin: string;
     };
     topBar: {
         openSidebar: string;
@@ -6195,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
@@ -6613,8 +6654,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;