@caribeng/ui 22.2.0 → 22.4.0

package/types/caribeng-ui-sidebar.d.ts

@@ -0,0 +1,167 @@
+import * as _caribeng_ui_sidebar from '@caribeng/ui/sidebar';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Signal } from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Enlace o acción del menú lateral. */
+interface CbSidebarItem {
+    /** Identificador para `active`. Por defecto, la `url` o el `label`. */
+    id?: string;
+    label: string;
+    icon?: string;
+    url?: string;
+    target?: string;
+    /** Contador o etiqueta a la derecha ("3", "Nuevo"). */
+    badge?: string | number;
+    disabled?: boolean;
+    /** Subelementos (un nivel): el item se convierte en un grupo desplegable. */
+    children?: readonly CbSidebarItem[];
+    /** Acción al elegirlo (además del evento `itemSelect`). */
+    command?: (event: CbSidebarSelectEvent) => void;
+}
+/** Sección del menú lateral con título opcional. */
+interface CbSidebarGroup {
+    label?: string;
+    items: readonly CbSidebarItem[];
+}
+interface CbSidebarSelectEvent {
+    readonly item: CbSidebarItem;
+    readonly originalEvent: Event;
+}
+/** Clave de un item para `active`. */
+declare function cbSidebarKey(item: CbSidebarItem): string;
+/** Estado del `cb-app-shell` compartido con el sidebar y los botones `cbSidebarToggle`. */
+interface CbAppShellState {
+    /** Ancho por debajo del punto de corte: el sidebar es un panel deslizante. */
+    readonly mobile: Signal<boolean>;
+    /** Panel abierto (solo en móvil). */
+    readonly sidebarOpen: Signal<boolean>;
+    /** Sidebar contraído a iconos (solo en escritorio). */
+    readonly collapsed: Signal<boolean>;
+    readonly sidebarId: string;
+    /** En móvil abre o cierra el panel; en escritorio contrae o expande. */
+    toggle(): void;
+    setCollapsed(collapsed: boolean): void;
+    /** Cierra el panel móvil (p. ej. al navegar). */
+    closeSidebar(): void;
+}
+declare const CB_APP_SHELL: InjectionToken<CbAppShellState>;
+
+/**
+ * Menú lateral de CaribeNG: secciones con título, enlaces con icono y badge,
+ * grupos desplegables de un nivel y modo contraído a iconos (con tooltip).
+ * Dentro de `cb-app-shell` se convierte en panel deslizante en móvil.
+ *
+ * @example
+ * ```html
+ * <cb-sidebar [groups]="menu" [(active)]="seccion" [navigate]="navigate">
+ *   <img cb-sidebar-header src="logo.svg" alt="Mi banco" />
+ * </cb-sidebar>
+ * ```
+ */
+declare class CbSidebar {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** `cb-app-shell` que lo contiene, si hay. */
+    protected readonly shell: _caribeng_ui_sidebar.CbAppShellState | null;
+    protected readonly uid: string;
+    readonly groups: _angular_core.InputSignal<readonly CbSidebarGroup[]>;
+    /** Clave del item activo (`id`, `url` o `label`); se marca con `aria-current="page"`. */
+    readonly active: _angular_core.ModelSignal<string | null>;
+    /** Contraído a iconos. Dentro de `cb-app-shell` lo controla el shell. */
+    readonly collapsed: _angular_core.ModelSignal<boolean>;
+    /** Muestra el botón de contraer/expandir en el pie. */
+    readonly collapsible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nombre de la navegación. Por defecto, "Navegación principal". */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Navegación SPA: si se indica, los enlaces internos (sin `target` ni teclas
+     * modificadoras) la llaman en lugar de recargar la página.
+     * Ej.: `navigate = (url: string) => this.router.navigateByUrl(url)`.
+     */
+    readonly navigate: _angular_core.InputSignal<((url: string) => unknown) | null>;
+    /** Item elegido. */
+    readonly itemSelect: _angular_core.OutputEmitterRef<CbSidebarSelectEvent>;
+    private readonly expanded;
+    protected readonly isCollapsed: _angular_core.Signal<boolean>;
+    constructor();
+    protected key(item: CbSidebarItem): string;
+    protected isActive(item: CbSidebarItem): boolean;
+    protected hasActiveChild(item: CbSidebarItem): boolean;
+    protected isExpanded(item: CbSidebarItem): boolean;
+    protected toggleGroup(item: CbSidebarItem): void;
+    protected toggleCollapsed(): void;
+    private setCollapsed;
+    /** Marca el item como activo, ejecuta su `command`, emite `itemSelect` y navega. */
+    select(item: CbSidebarItem, event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbSidebar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbSidebar, "cb-sidebar", never, { "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "navigate": { "alias": "navigate"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "collapsed": "collapsedChange"; "itemSelect": "itemSelect"; }, never, ["[cb-sidebar-header]", "[cb-sidebar-footer]"], true, never>;
+}
+
+/**
+ * Esqueleto de aplicación de CaribeNG: menú lateral, cabecera y contenido.
+ * En escritorio el sidebar es una columna que se puede contraer; por debajo de
+ * `breakpoint` (medido en el propio shell) pasa a ser un panel deslizante con
+ * fondo, cierre con Escape y foco atrapado mientras está abierto.
+ *
+ * @example
+ * ```html
+ * <cb-app-shell style="height: 100vh">
+ *   <cb-sidebar [groups]="menu" />
+ *   <header cb-app-shell-header>
+ *     <button type="button" cbSidebarToggle><cb-icon name="menu" /></button>
+ *   </header>
+ *   <router-outlet />
+ * </cb-app-shell>
+ * ```
+ */
+declare class CbAppShell implements CbAppShellState {
+    private readonly host;
+    private readonly document;
+    private readonly injector;
+    private readonly destroyRef;
+    private previouslyFocused;
+    readonly sidebarId: string;
+    /** Ancho (px) del shell por debajo del cual el sidebar es un panel deslizante. */
+    readonly breakpoint: _angular_core.InputSignal<number>;
+    /** Panel abierto en móvil. */
+    readonly sidebarOpen: _angular_core.ModelSignal<boolean>;
+    /** Sidebar contraído a iconos en escritorio. */
+    readonly collapsed: _angular_core.ModelSignal<boolean>;
+    /** Fuerza el modo móvil (útil en pruebas o vistas embebidas). */
+    readonly forceMobile: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly width;
+    readonly mobile: _angular_core.Signal<boolean>;
+    constructor();
+    toggle(): void;
+    setCollapsed(collapsed: boolean): void;
+    closeSidebar(): void;
+    protected onEscape(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbAppShell, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbAppShell, "cb-app-shell", never, { "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "sidebarOpen": { "alias": "sidebarOpen"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "forceMobile": { "alias": "forceMobile"; "required": false; "isSignal": true; }; }, { "sidebarOpen": "sidebarOpenChange"; "collapsed": "collapsedChange"; }, never, ["cb-sidebar, [cb-app-shell-sidebar]", "[cb-app-shell-header]", "*"], true, never>;
+}
+
+/**
+ * Convierte cualquier botón en el control del sidebar de `cb-app-shell`: en
+ * móvil abre o cierra el panel; en escritorio contrae o expande. Gestiona
+ * `aria-controls`, `aria-expanded` y un nombre accesible por defecto.
+ *
+ * @example
+ * ```html
+ * <button type="button" cbSidebarToggle><cb-icon name="menu" aria-hidden="true" /></button>
+ * ```
+ */
+declare class CbSidebarToggle {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly shell: _caribeng_ui_sidebar.CbAppShellState | null;
+    /** Nombre accesible. Por defecto, "Abrir menú" (móvil) o "Contraer/Expandir menú lateral". */
+    readonly cbSidebarToggle: _angular_core.InputSignal<string>;
+    protected readonly expanded: _angular_core.Signal<boolean | null>;
+    protected readonly label: _angular_core.Signal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbSidebarToggle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbSidebarToggle, "[cbSidebarToggle]", never, { "cbSidebarToggle": { "alias": "cbSidebarToggle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CB_APP_SHELL, CbAppShell, CbSidebar, CbSidebarToggle, cbSidebarKey };
+export type { CbAppShellState, CbSidebarGroup, CbSidebarItem, CbSidebarSelectEvent };
+//# sourceMappingURL=caribeng-ui-sidebar.d.ts.map

package/types/caribeng-ui-stepper.d.ts

@@ -23,6 +23,8 @@ declare class CbStepper {
     readonly activeIndex: _angular_core.WritableSignal<number>;
     isActive(step: CbStep): boolean;
     isComplete(step: CbStep): boolean;
+    /** Nombre del botón del paso: "Paso 2 de 3: Envío" (y ", completado" si ya pasó). */
+    protected stepName(step: CbStep, index: number): string;
     goTo(index: number): void;
     next(): void;
     prev(): void;

package/types/caribeng-ui-table.d.ts

@@ -7,7 +7,7 @@ import { CbPaginatorState } from '@caribeng/ui/paginator';
 /** Cómo compara un filtro el texto buscado con el valor de la celda (sin distinguir mayúsculas ni tildes). */
 type CbTableFilterMatchMode = 'contains' | 'startsWith' | 'equals';
 interface CbTableColumn {
-    /** Propiedad de la fila a mostrar. */
+    /** Propiedad de la fila a mostrar. Admite rutas (`cliente.nombre`). */
     field: string;
     /** Texto del encabezado. */
     header: string;

package/types/caribeng-ui-tabmenu.d.ts

@@ -1,17 +1,24 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { CbMenuCommandEvent } from '@caribeng/ui';
 
 interface CbTabMenuItem {
     label: string;
     url?: string;
     icon?: string;
     disabled?: boolean;
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbTabMenuItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Horizontal navigation menu with an active item. */
 declare class CbTabMenu {
     /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly items: _angular_core.InputSignal<readonly CbTabMenuItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbTabMenuItem[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbTabMenuItem>;

package/types/caribeng-ui-tieredmenu.d.ts

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { CbMenuCommandEvent } from '@caribeng/ui';
 
 interface CbTieredMenuItem {
     label: string;
@@ -8,6 +9,10 @@ interface CbTieredMenuItem {
     disabled?: boolean;
     separator?: boolean;
     items?: readonly CbTieredMenuItem[];
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbTieredMenuItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Popup menu with cascading submenus. */
 declare class CbTieredMenu {
@@ -17,6 +22,8 @@ declare class CbTieredMenu {
     private readonly vcr;
     private readonly destroyRef;
     readonly items: _angular_core.InputSignal<readonly CbTieredMenuItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbTieredMenuItem[]>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly triggerLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbTieredMenuItem>;
@@ -26,11 +33,20 @@ declare class CbTieredMenu {
     private readonly content;
     private overlayRef;
     private readonly positions;
+    private readonly injector;
+    private readonly trigger;
     constructor();
     toggle(event: MouseEvent): void;
     show(target: HTMLElement): void;
     select(item: CbTieredMenuItem): void;
-    hide(): void;
+    /** Cierra el menú; con `restoreFocus` (por defecto) el foco vuelve al botón que lo abre. */
+    hide(restoreFocus?: boolean): void;
+    protected onTriggerKeydown(event: KeyboardEvent): void;
+    /** Flechas, Inicio y Fin dentro de cada nivel; derecha abre el submenú e izquierda vuelve al nivel anterior. */
+    protected onMenuKeydown(event: KeyboardEvent): void;
+    private openSubmenu;
+    private menuItems;
+    private focusFirst;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTieredMenu, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTieredMenu, "cb-tieredmenu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, never, never, true, never>;
 }

package/types/caribeng-ui.d.ts

@@ -10,6 +10,8 @@ import { InjectionToken, EnvironmentProviders, Signal } from '@angular/core';
  * o, en caliente, `inject(CbLocaleService).use('en')`.
  */
 interface CbTranslation {
+    /** Idioma BCP 47 para `Intl` (nombres de países, fechas…): `es`, `en`. */
+    intlLocale: string;
     close: string;
     clear: string;
     remove: string;
@@ -27,6 +29,180 @@ interface CbTranslation {
     selectAll: string;
     options: string;
     moreActions: string;
+    copy: string;
+    copied: string;
+    copyFailed: string;
+    qrCode: string;
+    commandPalette: string;
+    commandPlaceholder: string;
+    /** `{0}`: cantidad. */
+    commandResults: string;
+    commandNavigate: string;
+    commandSelect: string;
+    expandSidebar: string;
+    collapseSidebar: string;
+    openMenu: string;
+    chatConversation: string;
+    chatYou: string;
+    chatAssistant: string;
+    chatPlaceholder: string;
+    chatMessage: string;
+    chatSend: string;
+    chatStop: string;
+    chatAttach: string;
+    chatSending: string;
+    chatError: string;
+    chatRetry: string;
+    chatTyping: string;
+    chatGenerating: string;
+    chatResponseReady: string;
+    chatJumpToLatest: string;
+    phoneCountry: string;
+    searchCountry: string;
+    phoneInvalid: string;
+    chatThinking: string;
+    /** `{0}`: segundos. */
+    chatThoughtFor: string;
+    chatReasoning: string;
+    /** `{0}`: nombre de la herramienta. */
+    chatToolRunning: string;
+    /** `{0}`: nombre de la herramienta. */
+    chatToolDone: string;
+    /** `{0}`: nombre de la herramienta. */
+    chatToolError: string;
+    chatToolInput: string;
+    chatToolOutput: string;
+    chatHelpful: string;
+    chatNotHelpful: string;
+    chatRegenerate: string;
+    chatAttachments: string;
+    kanbanCard: string;
+    kanbanInstructions: string;
+    /** `{0}`: tarjeta, `{1}`: columna, `{2}`: posición, `{3}`: total. */
+    kanbanGrabbed: string;
+    /** `{0}`: tarjeta, `{1}`: columna, `{2}`: posición, `{3}`: total. */
+    kanbanMoved: string;
+    /** `{0}`: tarjeta, `{1}`: columna, `{2}`: posición. */
+    kanbanDropped: string;
+    /** `{0}`: tarjeta, `{1}`: columna. */
+    kanbanCancelled: string;
+    /** `{0}`: columna. */
+    kanbanFull: string;
+    /** `{0}`: cantidad, `{1}`: límite. */
+    kanbanCount: string;
+    kanbanAdd: string;
+    kanbanEdit: string;
+    kanbanDelete: string;
+    /** `{0}`: columna. */
+    kanbanMoveTo: string;
+    /** `{0}`: tarjeta. */
+    kanbanCardActions: string;
+    kanbanCardTitle: string;
+    /** `{0}`: tarjeta. */
+    kanbanConfirmDelete: string;
+    /** `{0}`: tarjeta. */
+    kanbanDeleted: string;
+    /** `{0}`: tarjeta, `{1}`: columna. */
+    kanbanAdded: string;
+    /** `{0}`: título anterior, `{1}`: nuevo. */
+    kanbanRenamed: string;
+    kanbanAddColumn: string;
+    kanbanColumnName: string;
+    kanbanNewColumn: string;
+    /** `{0}`: columna. */
+    kanbanColumnActions: string;
+    kanbanRename: string;
+    /** `{0}`: columna. */
+    kanbanCollapse: string;
+    /** `{0}`: columna. */
+    kanbanExpand: string;
+    /** `{0}`: columna, `{1}`: cantidad de tarjetas. */
+    kanbanConfirmDeleteColumn: string;
+    kanbanDetails: string;
+    kanbanOpenDetails: string;
+    kanbanStatus: string;
+    kanbanAssignees: string;
+    kanbanNoAssignees: string;
+    /** `{0}`: persona. */
+    kanbanUnassign: string;
+    /** `{0}`: nombres. */
+    kanbanAssignedTo: string;
+    kanbanPriority: string;
+    kanbanNoPriority: string;
+    kanbanPriorityLow: string;
+    kanbanPriorityMedium: string;
+    kanbanPriorityHigh: string;
+    kanbanStartDate: string;
+    kanbanEndDate: string;
+    kanbanDates: string;
+    kanbanOverdue: string;
+    kanbanDescription: string;
+    kanbanDescriptionPlaceholder: string;
+    kanbanAttachments: string;
+    kanbanAttach: string;
+    kanbanDropFiles: string;
+    /** `{0}`: archivo. */
+    kanbanRemoveAttachment: string;
+    /** `{0}`: cantidad. */
+    kanbanAttachmentCount: string;
+    /** `{0}`: tarjeta. */
+    kanbanUpdated: string;
+    kanbanTaskName: string;
+    kanbanAddTask: string;
+    kanbanAddSection: string;
+    kanbanCompleted: string;
+    /** `{0}`: tarea. */
+    kanbanMarkComplete: string;
+    /** `{0}`: tarea. */
+    kanbanMarkIncomplete: string;
+    /** `{0}`: sección, `{1}`: cantidad. */
+    kanbanSectionCount: string;
+    kanbanListInstructions: string;
+    /** `{0}`: cantidad. */
+    kanbanNoDate: string;
+    /** `{0}`: día. */
+    kanbanAddTaskOn: string;
+    /** `{0}`: primer día, `{1}`: último. */
+    kanbanWeekOf: string;
+    kanbanCalendarInstructions: string;
+    /** `{0}`: tarea, `{1}`: fechas. */
+    kanbanRescheduled: string;
+    kanbanPreviousWeek: string;
+    kanbanNextWeek: string;
+    kanbanDays: string;
+    kanbanZoomIn: string;
+    kanbanZoomOut: string;
+    /** `{0}`: sección. */
+    kanbanAddTaskIn: string;
+    kanbanTimelineInstructions: string;
+    kanbanDashboard: string;
+    kanbanTotalCompleted: string;
+    kanbanTotalIncomplete: string;
+    kanbanTotalOverdue: string;
+    kanbanTotalTasks: string;
+    /** `{0}`: porcentaje. */
+    kanbanOfTotal: string;
+    kanbanIncompleteBySection: string;
+    kanbanByCompletion: string;
+    kanbanIncompleteByAssignee: string;
+    kanbanByWeek: string;
+    kanbanCompletedPlural: string;
+    kanbanPendingPlural: string;
+    kanbanOverduePlural: string;
+    kanbanIncompletePlural: string;
+    kanbanViews: string;
+    kanbanViewBoard: string;
+    kanbanViewList: string;
+    kanbanViewTimeline: string;
+    kanbanViewDashboard: string;
+    kanbanViewCalendar: string;
+    /** `{0}`: vista. */
+    kanbanHideView: string;
+    kanbanSideBySide: string;
+    kanbanViewsHint: string;
+    save: string;
+    /** `{0}`: cantidad. */
+    mentionsCount: string;
     add: string;
     onThisPage: string;
     trendUp: string;
@@ -50,6 +226,8 @@ interface CbTranslation {
     continue: string;
     /** `{0}`: paso actual, `{1}`: total. */
     stepOf: string;
+    /** Se añade al nombre de un paso terminado ("…, completado"). */
+    stepCompleted: string;
     expand: string;
     collapse: string;
     /** `{0}`: elemento. */
@@ -113,6 +291,11 @@ interface CbTranslation {
     color: string;
     colorPicker: string;
     hexColor: string;
+    /** Área de saturación y brillo del selector de color. */
+    colorArea: string;
+    /** Valor del área: {0} saturación, {1} brillo (en %). */
+    colorAreaValue: string;
+    hue: string;
     switch: string;
     /** `{0}`: valor, `{1}`: máximo. */
     ratingOf: string;
@@ -279,6 +462,15 @@ interface CbTranslation {
     chooseItem: string;
     perMonth: string;
     perYear: string;
+    billingCycle: string;
+    notIncluded: string;
+    payAnnually: string;
+    payMonthly: string;
+    /** `{0}`: importe anual. */
+    billedAnnually: string;
+    /** `{0}`: importe ahorrado. */
+    youSave: string;
+    recommended: string;
     textFormatting: string;
     paragraphStyle: string;
     normal: string;
@@ -527,6 +719,69 @@ declare class CbThemeService {
     static ɵprov: i0.ɵɵInjectableDeclaration<CbThemeService>;
 }
 
+/** Severidad del botón de aceptar de una confirmación. */
+type CbConfirmSeverity = 'primary' | 'danger' | 'success' | 'warning';
+/** Opciones de una confirmación pedida con {@link CbConfirmationService.confirm}. */
+interface CbConfirmation {
+    /** Pregunta a confirmar. Por defecto, la del idioma activo. */
+    message?: string;
+    /** Título (solo `cb-confirm-dialog`). Por defecto, "Confirmar" del idioma activo. */
+    header?: string;
+    acceptLabel?: string;
+    rejectLabel?: string;
+    /** Severidad del botón de aceptar (p. ej. `danger` para acciones destructivas). */
+    acceptSeverity?: CbConfirmSeverity;
+    /** Se ejecuta al aceptar. */
+    accept?: () => void;
+    /** Se ejecuta al cancelar (botón, Escape o clic fuera). */
+    reject?: () => void;
+    /**
+     * Elemento al que se ancla `cb-confirm-popup` (normalmente
+     * `event.currentTarget`). Sin `target` la atiende solo `cb-confirm-dialog`.
+     */
+    target?: EventTarget | null;
+    /**
+     * Para tener varias en la misma vista: la atiende el `cb-confirm-dialog` o
+     * `cb-confirm-popup` con el mismo `key`. Sin `key`, los que no tienen.
+     */
+    key?: string;
+}
+/** Confirmación en curso. */
+interface CbConfirmationRequest {
+    readonly id: number;
+    readonly confirmation: CbConfirmation;
+}
+/**
+ * Pide confirmaciones desde código, sin declarar un diálogo por cada una. Las
+ * muestra el `<cb-confirm-dialog service />` o `<cb-confirm-popup service />` de la vista
+ * (el input `service` los conecta), igual que `ConfirmationService` de PrimeNG.
+ *
+ * @example
+ * ```ts
+ * private readonly confirmation = inject(CbConfirmationService);
+ *
+ * borrar(item: Item, event: Event): void {
+ *   this.confirmation.confirm({
+ *     message: `¿Eliminar ${item.nombre}?`,
+ *     acceptSeverity: 'danger',
+ *     target: event.currentTarget, // solo para cb-confirm-popup
+ *     accept: () => this.api.eliminar(item.id),
+ *   });
+ * }
+ * ```
+ */
+declare class CbConfirmationService {
+    private readonly _request;
+    /** Confirmación en curso, o `null`. La leen `cb-confirm-dialog` y `cb-confirm-popup`. */
+    readonly request: i0.Signal<CbConfirmationRequest | null>;
+    /** Muestra una confirmación. Si había otra abierta, la sustituye (sin llamar a su `reject`). */
+    confirm(confirmation: CbConfirmation): void;
+    /** Cierra la confirmación en curso sin llamar a `accept` ni a `reject`. */
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CbConfirmationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CbConfirmationService>;
+}
+
 /**
  * Registra CaribeNG en una aplicación Angular (standalone o basada en módulos).
  *
@@ -542,6 +797,25 @@ declare class CbThemeService {
  */
 declare function provideCaribeNG(config?: Partial<CaribeNgConfig>): EnvironmentProviders;
 
+/** Argumento de `command` en los items de los menús. */
+interface CbMenuCommandEvent<T = unknown> {
+    /** Item elegido. */
+    readonly item: T;
+    /** Evento que lo eligió (clic o teclado), si lo hay. */
+    readonly originalEvent?: Event;
+}
+/**
+ * Ejecuta el `command` del item (si tiene). Los menús lo llaman al elegir un
+ * item, además de emitir su evento de selección.
+ */
+declare function cbRunCommand<T extends object>(item: T, originalEvent?: Event): void;
+/**
+ * Quita los items con `visible: false`, también dentro de `items` (submenús)
+ * y de `groups[].items` (MegaMenu). Devuelve los mismos objetos si no cambia
+ * nada, para que la selección emita el objeto original.
+ */
+declare function cbVisibleItems<T extends object>(items: readonly T[]): T[];
+
 /** Tamaños estándar compartidos por los componentes. */
 type CbSize = 'sm' | 'md' | 'lg';
 /**
@@ -643,6 +917,6 @@ declare class CbLocaleService {
 /** Traducciones activas de CaribeNG como signal (para usar en componentes). */
 declare function injectCbTranslation(): Signal<CbTranslation>;
 
-export { CB_COLOR_PRESETS, CB_CONFIG, CB_DEFAULT_CONFIG, CB_LOCALES, CB_LOCALE_EN, CB_LOCALE_ES, CbLocaleService, CbThemeService, cbFieldState, cbFormat, cbOverlayFocus, injectCbTranslation, provideCaribeNG };
-export type { CaribeNgConfig, CbColorPreset, CbFieldIndicator, CbFieldState, CbLocaleCode, CbOverlayFocusOptions, CbPrimaryScale, CbRequiredIndicator, CbSeverity, CbSize, CbTheme, CbThemePreference, CbTranslation };
+export { CB_COLOR_PRESETS, CB_CONFIG, CB_DEFAULT_CONFIG, CB_LOCALES, CB_LOCALE_EN, CB_LOCALE_ES, CbConfirmationService, CbLocaleService, CbThemeService, cbFieldState, cbFormat, cbOverlayFocus, cbRunCommand, cbVisibleItems, injectCbTranslation, provideCaribeNG };
+export type { CaribeNgConfig, CbColorPreset, CbConfirmSeverity, CbConfirmation, CbConfirmationRequest, CbFieldIndicator, CbFieldState, CbLocaleCode, CbMenuCommandEvent, CbOverlayFocusOptions, CbPrimaryScale, CbRequiredIndicator, CbSeverity, CbSize, CbTheme, CbThemePreference, CbTranslation };
 //# sourceMappingURL=caribeng-ui.d.ts.map