@caribeng/ui 22.1.1 → 22.2.0

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

@@ -0,0 +1,34 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/**
+ * Empty de CaribeNG: estado vacío con icono o imagen, mensaje y acciones
+ * opcionales (proyectadas). Úsalo cuando una lista, búsqueda o tabla no tiene
+ * datos.
+ *
+ * @example
+ * ```html
+ * <cb-empty title="Aún no tienes movimientos" description="Cuando hagas tu primera compra aparecerá aquí.">
+ *   <cb-button size="sm">Hacer una transferencia</cb-button>
+ * </cb-empty>
+ * ```
+ */
+declare class CbEmpty {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Mensaje principal. Por defecto, "Sin datos" del idioma activo. */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    /** Texto de apoyo opcional. */
+    readonly description: _angular_core.InputSignal<string>;
+    /** Icono (se ignora si hay `image`). */
+    readonly icon: _angular_core.InputSignal<string>;
+    /** Ilustración opcional (decorativa). */
+    readonly image: _angular_core.InputSignal<string>;
+    /** `sm` para tablas, listas y paneles pequeños. */
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbEmpty, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbEmpty, "cb-empty", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "image": { "alias": "image"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { CbEmpty };
+//# sourceMappingURL=caribeng-ui-empty.d.ts.map

package/types/caribeng-ui-file-card.d.ts

@@ -24,7 +24,7 @@ declare class CbFileCard {
     readonly value: _angular_core.InputSignal<string>;
     /** Valor secundario a la derecha (p. ej. "26.4 GB"). */
     readonly valueSub: _angular_core.InputSignal<string>;
-    /** Fondo tintado derivado del color (con alpha). */
+    /** Fondo tintado derivado del color (cualquier color CSS: hex, rgb(), var(--…)). */
     protected tintBg(): string | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbFileCard, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbFileCard, "cb-file-card", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueSub": { "alias": "valueSub"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;

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

@@ -1,22 +1,42 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 interface CbFileUploadEvent {
     files: File[];
 }
+/** Archivos descartados al elegirlos o soltarlos, con el motivo. */
+interface CbFileRejectEvent {
+    files: {
+        file: File;
+        reason: 'size' | 'type';
+    }[];
+}
 /**
  * FileUpload de CaribeNG: selector de archivos con arrastrar y soltar,
  * validación de tamaño máximo y lista de archivos seleccionados.
  */
 declare class CbFileUpload {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly accept: _angular_core.InputSignal<string>;
     readonly multiple: _angular_core.InputSignal<boolean>;
     readonly maxFileSize: _angular_core.InputSignal<number | null>;
     readonly disabled: _angular_core.InputSignal<boolean>;
-    readonly chooseLabel: _angular_core.InputSignal<string>;
-    readonly uploadLabel: _angular_core.InputSignal<string>;
+    readonly chooseLabel: _angular_core.InputSignal<string | undefined>;
+    readonly uploadLabel: _angular_core.InputSignal<string | undefined>;
     readonly selectFiles: _angular_core.OutputEmitterRef<CbFileUploadEvent>;
     readonly uploadHandler: _angular_core.OutputEmitterRef<CbFileUploadEvent>;
+    /** Se emite con los archivos descartados por tamaño (`maxFileSize`) o tipo (`accept`). */
+    readonly rejectFiles: _angular_core.OutputEmitterRef<CbFileRejectEvent>;
     readonly files: _angular_core.WritableSignal<File[]>;
+    /** Archivos descartados en la última selección (se muestran como aviso). */
+    protected readonly rejected: _angular_core.WritableSignal<{
+        file: File;
+        reason: "size" | "type";
+    }[]>;
     readonly dragging: _angular_core.WritableSignal<boolean>;
     private readonly fileInputRef;
     openPicker(): void;
@@ -24,15 +44,18 @@ declare class CbFileUpload {
     protected onDragOver(event: DragEvent): void;
     protected onDragLeave(event: DragEvent): void;
     protected onDrop(event: DragEvent): void;
+    /** Añade archivos validando `accept` y `maxFileSize`; ignora los repetidos. */
     addFiles(incoming: File[]): void;
     removeAt(index: number): void;
     clear(): void;
     triggerUpload(): void;
     protected formatSize(bytes: number): string;
+    /** Comprueba `accept` (extensiones `.pdf`, tipos `image/png` o comodines `image/*`). */
+    private isAccepted;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbFileUpload, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbFileUpload, "cb-file-upload", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "chooseLabel": { "alias": "chooseLabel"; "required": false; "isSignal": true; }; "uploadLabel": { "alias": "uploadLabel"; "required": false; "isSignal": true; }; }, { "selectFiles": "selectFiles"; "uploadHandler": "uploadHandler"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbFileUpload, "cb-file-upload", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "chooseLabel": { "alias": "chooseLabel"; "required": false; "isSignal": true; }; "uploadLabel": { "alias": "uploadLabel"; "required": false; "isSignal": true; }; }, { "selectFiles": "selectFiles"; "uploadHandler": "uploadHandler"; "rejectFiles": "rejectFiles"; }, never, never, true, never>;
 }
 
 export { CbFileUpload };
-export type { CbFileUploadEvent };
+export type { CbFileRejectEvent, CbFileUploadEvent };
 //# sourceMappingURL=caribeng-ui-fileupload.d.ts.map

package/types/caribeng-ui-folder-card.d.ts

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Tarjeta de carpeta de CaribeNG: icono de carpeta, nombre y una fila con
@@ -12,12 +13,14 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbFolderCard {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     /** Nombre de la carpeta. */
     readonly name: _angular_core.InputSignal<string>;
     /** Número de archivos (texto o número). */
     readonly files: _angular_core.InputSignal<string | number>;
     /** Etiqueta tras el número de archivos. */
-    readonly filesLabel: _angular_core.InputSignal<string>;
+    readonly filesLabel: _angular_core.InputSignal<string | undefined>;
     /** Tamaño mostrado a la derecha. */
     readonly size: _angular_core.InputSignal<string>;
     /** Color del icono de carpeta. */

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

@@ -1,4 +1,6 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 interface CbGalleriaItem {
     itemImageSrc: string;
@@ -11,13 +13,20 @@ interface CbGalleriaItem {
  * barra de miniaturas seleccionables.
  */
 declare class CbGalleria {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly value: _angular_core.InputSignal<CbGalleriaItem[]>;
     readonly showThumbnails: _angular_core.InputSignal<boolean>;
     readonly circular: _angular_core.InputSignal<boolean>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
+    private readonly host;
     protected readonly activeItem: _angular_core.Signal<CbGalleriaItem | null>;
     prev(): void;
     next(): void;
+    /** Miniaturas (patrón *tabs*): flechas, Inicio y Fin cambian de imagen y mueven el foco. */
+    protected onThumbKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbGalleria, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbGalleria, "cb-galleria", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "showThumbnails": { "alias": "showThumbnails"; "required": false; "isSignal": true; }; "circular": { "alias": "circular"; "required": false; "isSignal": true; }; "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; }, never, never, true, never>;
 }

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

@@ -1,16 +1,25 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 /**
  * Image de CaribeNG: imagen con previsualización lightbox accesible y controles
  * de zoom/rotación.
  */
 declare class CbImage {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly src: _angular_core.InputSignal<string>;
     readonly alt: _angular_core.InputSignal<string>;
     readonly width: _angular_core.InputSignal<string>;
     readonly height: _angular_core.InputSignal<string>;
     readonly preview: _angular_core.InputSignal<boolean>;
     private readonly lightboxEl;
+    private readonly overlayBtn;
+    private readonly closeBtn;
+    private readonly injector;
     readonly lightboxOpen: _angular_core.WritableSignal<boolean>;
     readonly scale: _angular_core.WritableSignal<number>;
     readonly rotation: _angular_core.WritableSignal<number>;
@@ -19,6 +28,7 @@ declare class CbImage {
     /** Transform combinado (rotación + escala + volteo) de la imagen. */
     readonly transform: _angular_core.Signal<string>;
     openPreview(): void;
+    /** Cierra la previsualización y devuelve el foco al botón que la abrió. */
     closePreview(): void;
     zoomIn(): void;
     zoomOut(): void;

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

@@ -1,15 +1,23 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Inplace de CaribeNG: alterna entre una vista previa (`[cb-inplace-display]`)
  * y el contenido editable o completo (`[cb-inplace-content]`) al hacer clic.
  */
 declare class CbInplace {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly closable: _angular_core.InputSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly active: _angular_core.ModelSignal<boolean>;
+    private readonly host;
+    private readonly injector;
+    /** Muestra el contenido y mueve el foco a su primer elemento enfocable. */
     open(): void;
+    /** Vuelve a la vista previa y devuelve el foco a ella. */
     close(): void;
+    private focusAfterRender;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbInplace, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbInplace, "cb-inplace", never, { "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; }, never, ["[cb-inplace-display]", "[cb-inplace-content]"], true, never>;
 }

package/types/caribeng-ui-input-number.d.ts

@@ -1,6 +1,6 @@
+import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 import { CbSize, CbRequiredIndicator } from '@caribeng/ui';
-import * as _angular_core from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
@@ -15,6 +15,8 @@ import { ControlValueAccessor } from '@angular/forms';
  * ```
  */
 declare class CbInputNumber implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     /** Valor numérico (two-way opcional fuera de Angular Forms). */
     readonly value: _angular_core.ModelSignal<number | null>;
     readonly label: _angular_core.InputSignal<string>;

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

@@ -30,6 +30,11 @@ declare class CbInputMask implements ControlValueAccessor {
     setDisabledState(isDisabled: boolean): void;
     protected onInput(event: Event): void;
     protected onBlur(): void;
+    /**
+     * Aplica la máscara. Los literales (`-`, `(`, espacios…) se escriben solo
+     * cuando llega el carácter siguiente: así un literal inicial aparece y
+     * Backspace puede borrar el último literal sin que vuelva a añadirse.
+     */
     private applyMask;
     private matchesToken;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbInputMask, never>;

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

@@ -1,5 +1,6 @@
-import * as _caribeng_ui from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
@@ -7,6 +8,10 @@ import { ControlValueAccessor } from '@angular/forms';
  * con avance automático de foco, pegado desde portapapeles e integración CVA.
  */
 declare class CbInputOtp implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     private readonly hostRef;
     readonly length: _angular_core.InputSignal<number>;
     readonly integerOnly: _angular_core.InputSignal<boolean>;
@@ -16,7 +21,7 @@ declare class CbInputOtp implements ControlValueAccessor {
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Estado de validación: inputs manuales + estado de Angular Forms. */
     protected readonly fieldState: _caribeng_ui.CbFieldState;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly value: _angular_core.ModelSignal<string>;
     private readonly cvaDisabled;
     protected readonly isDisabled: _angular_core.Signal<boolean>;

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

@@ -0,0 +1,30 @@
+import * as i0 from '@angular/core';
+
+/** Filtros predefinidos (como el KeyFilter de PrimeNG). */
+type CbKeyFilterPreset = 'int' | 'pint' | 'num' | 'pnum' | 'money' | 'alpha' | 'alphanum' | 'hex' | 'email';
+/**
+ * KeyFilter de CaribeNG: limita los caracteres que se pueden escribir en un
+ * `input` o `textarea`. Usa el evento `beforeinput`, así filtra lo tecleado,
+ * lo pegado y lo autocompletado (no solo las teclas).
+ *
+ * Solo restringe la entrada: valida el formato final con Validators en el formulario.
+ *
+ * @example
+ * ```html
+ * <input cbKeyFilter="pint" inputmode="numeric" aria-label="Número de cédula" />
+ * <input [cbKeyFilter]="/[A-Z0-9]/" aria-label="Placa" />
+ * ```
+ */
+declare class CbKeyFilter {
+    /** Filtro predefinido o expresión que debe cumplir cada carácter. */
+    readonly cbKeyFilter: i0.InputSignal<RegExp | CbKeyFilterPreset>;
+    /** ¿Se acepta este texto? (cada carácter debe cumplir el filtro). */
+    allows(text: string): boolean;
+    protected onBeforeInput(e: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CbKeyFilter, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<CbKeyFilter, "input[cbKeyFilter], textarea[cbKeyFilter]", never, { "cbKeyFilter": { "alias": "cbKeyFilter"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CbKeyFilter };
+export type { CbKeyFilterPreset };
+//# sourceMappingURL=caribeng-ui-keyfilter.d.ts.map

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

@@ -1,5 +1,5 @@
-import * as _caribeng_ui from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
@@ -14,14 +14,16 @@ import { ControlValueAccessor } from '@angular/forms';
  * ```
  */
 declare class CbListBox implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly options: _angular_core.InputSignal<readonly unknown[]>;
     readonly optionLabel: _angular_core.InputSignal<string>;
     readonly optionValue: _angular_core.InputSignal<string | null>;
     readonly optionDisabled: _angular_core.InputSignal<string>;
     readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly filter: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly filterPlaceholder: _angular_core.InputSignal<string>;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    readonly filterPlaceholder: _angular_core.InputSignal<string | undefined>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Marca visual y ARIA de estado inválido (también se activa con Angular Forms). */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbMegaMenuLink {
     label: string;
@@ -15,17 +16,40 @@ interface CbMegaMenuItem {
     icon?: string;
     groups: readonly CbMegaMenuGroup[];
 }
-/** Horizontal category menu with multi-column panels. */
+/**
+ * Menú de categorías con paneles de varias columnas (patrón *disclosure
+ * navigation* de WAI-ARIA). Teclado: ←/→ entre categorías, ↓ abre el panel y
+ * entra al primer enlace, ↑/↓ recorre los enlaces y Escape cierra devolviendo
+ * el foco a la categoría.
+ *
+ * @example
+ * ```html
+ * <cb-megamenu [items]="categorias" (itemSelect)="navegar($event)" />
+ * ```
+ */
 declare class CbMegaMenu {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly host;
+    private readonly injector;
+    protected readonly panelId: string;
+    /** Categorías con sus grupos de enlaces. */
     readonly items: _angular_core.InputSignal<readonly CbMegaMenuItem[]>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Nombre accesible de la navegación. Por defecto, "Categorías" del idioma activo. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Se emite al elegir un enlace. */
     readonly itemSelect: _angular_core.OutputEmitterRef<CbMegaMenuLink>;
     protected readonly openIndex: _angular_core.WritableSignal<number | null>;
     toggle(index: number): void;
     select(link: CbMegaMenuLink): void;
     close(): void;
     onDocumentClick(event: MouseEvent): void;
+    /** Al salir el foco del componente (p. ej. con Tab), se cierra el panel. */
+    onFocusOut(event: FocusEvent): void;
+    protected onTriggerKeydown(event: KeyboardEvent, index: number): void;
+    protected onPanelKeydown(event: KeyboardEvent): void;
+    /** Enlaces navegables del panel abierto, en orden de lectura. */
+    private links;
+    private focusTrigger;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMegaMenu, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMegaMenu, "cb-megamenu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, never, never, true, never>;
 }

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbMenuItem {
     label: string;
@@ -10,12 +11,16 @@ interface CbMenuItem {
 }
 /** Popup menu anchored to any trigger element. */
 declare class CbMenu {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly overlay;
     private readonly vcr;
     private readonly destroyRef;
     readonly items: _angular_core.InputSignal<readonly CbMenuItem[]>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbMenuItem>;
+    /** Se emite al cerrarse el menú (clic fuera, Escape o al elegir una opción). */
+    readonly hidden: _angular_core.OutputEmitterRef<void>;
     private readonly content;
     private overlayRef;
     private trigger;
@@ -29,7 +34,7 @@ declare class CbMenu {
     onPanelClick(event: MouseEvent): void;
     private onKeydown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMenu, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMenu, "cb-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMenu, "cb-menu", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; "hidden": "hidden"; }, never, never, true, never>;
 }
 
 export { CbMenu };

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbMenubarItem {
     label: string;
@@ -10,9 +11,12 @@ interface CbMenubarItem {
 }
 /** Horizontal navigation bar with optional one-level dropdown menus. */
 declare class CbMenubar {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly host;
+    private readonly injector;
     readonly items: _angular_core.InputSignal<readonly CbMenubarItem[]>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbMenubarItem>;
     protected readonly openIndex: _angular_core.WritableSignal<number | null>;
     toggle(index: number): void;

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 import { CbSeverity } from '@caribeng/ui';
 
 /**
@@ -11,6 +12,8 @@ import { CbSeverity } from '@caribeng/ui';
  * ```
  */
 declare class CbMessage {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly severity: _angular_core.InputSignal<CbSeverity>;
     /** Muestra el botón de cerrar. */
     readonly closable: _angular_core.InputSignalWithTransform<boolean, unknown>;

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

@@ -12,11 +12,19 @@ interface CbMeterItem {
 declare class CbMeterGroup {
     readonly values: _angular_core.InputSignal<CbMeterItem[]>;
     readonly max: _angular_core.InputSignal<number>;
+    /** Nombre accesible del medidor (p. ej. "Almacenamiento"). */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Suma de los valores (valor actual del `role="meter"`). */
+    protected readonly total: _angular_core.Signal<number>;
+    /** Desglose legible para el lector de pantalla ("Apps 16 %, Fotos 8 %"). */
+    protected readonly valueText: _angular_core.Signal<string>;
     private readonly palette;
     protected percent(val: number): number;
+    /** Porcentaje respecto a `max`, redondeado a un decimal. */
+    protected format(val: number): number;
     protected defaultColor(idx: number): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMeterGroup, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMeterGroup, "cb-meter-group", never, { "values": { "alias": "values"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMeterGroup, "cb-meter-group", never, { "values": { "alias": "values"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { CbMeterGroup };

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

@@ -1,33 +1,72 @@
-import * as _caribeng_ui from '@caribeng/ui';
-import { CbSize } from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat, CbSize } from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 
+/** Opción con su posición en la lista filtrada (la que usan teclado y `aria-activedescendant`). */
+interface IndexedOption {
+    opt: unknown;
+    index: number;
+}
+/** Grupo de opciones ya filtrado; `label` es `null` cuando no se agrupa. */
+interface OptionGroup {
+    label: string | null;
+    options: IndexedOption[];
+}
+/** Fila del modo virtual: cabecera de grupo u opción, todas de la misma altura. */
+type VirtualRow = {
+    kind: 'group';
+    label: string;
+    key: string;
+} | ({
+    kind: 'option';
+} & IndexedOption);
 /**
  * Selección múltiple (multiselect) de CaribeNG. Listbox accesible sobre CDK
- * Overlay con casillas, filtro y seleccionar-todo. Integrado con Angular Forms
- * vía `ControlValueAccessor`; el modelo es un array de valores.
+ * Overlay con casillas, filtro, seleccionar-todo, grupos, búsqueda al teclear
+ * y scroll virtual. Integrado con Angular Forms vía `ControlValueAccessor`;
+ * el modelo es un array de valores.
  *
  * @example
  * ```html
  * <cb-multiselect [options]="ciudades" optionLabel="nombre" optionValue="id"
  *                 formControlName="ciudades" placeholder="Elige ciudades" />
+ *
+ * <!-- Agrupado: [{ label: 'Colombia', items: [...] }, …] -->
+ * <cb-multiselect [options]="paises" group filter />
  * ```
  */
 declare class CbMultiSelect implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
+    private readonly injector;
     readonly options: _angular_core.InputSignal<readonly unknown[]>;
     readonly optionLabel: _angular_core.InputSignal<string>;
     readonly optionValue: _angular_core.InputSignal<string | null>;
     readonly optionDisabled: _angular_core.InputSignal<string>;
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Las opciones son grupos (`{ label, items }`): se muestran con su título. */
+    readonly group: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Propiedad con el título de cada grupo. */
+    readonly optionGroupLabel: _angular_core.InputSignal<string>;
+    /** Propiedad con las opciones de cada grupo. */
+    readonly optionGroupChildren: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
     readonly size: _angular_core.InputSignal<CbSize>;
     readonly filter: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    readonly filterPlaceholder: _angular_core.InputSignal<string>;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    readonly filterPlaceholder: _angular_core.InputSignal<string | undefined>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
     readonly showToggleAll: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Nº máx. de etiquetas antes de mostrar "N seleccionados". */
     readonly maxSelectedLabels: _angular_core.InputSignal<number>;
+    /** Alto máximo de la lista (CSS). En modo virtual es su alto fijo. */
+    readonly scrollHeight: _angular_core.InputSignal<string>;
+    /** Pinta solo las opciones visibles: para listas de miles de elementos. */
+    readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Alto fijo de cada fila en modo virtual (px). */
+    readonly virtualScrollItemSize: _angular_core.InputSignal<number>;
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Estado de validación: inputs manuales + estado de Angular Forms. */
     protected readonly fieldState: _caribeng_ui.CbFieldState;
@@ -42,16 +81,30 @@ declare class CbMultiSelect implements ControlValueAccessor {
     protected readonly activeIndex: _angular_core.WritableSignal<number>;
     protected readonly filterText: _angular_core.WritableSignal<string>;
     protected readonly triggerWidth: _angular_core.WritableSignal<number>;
+    protected readonly scrollTop: _angular_core.WritableSignal<number>;
     private readonly cvaDisabled;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly listboxId: string;
     private readonly triggerRef;
     private readonly filterInputRef;
+    private readonly viewportRef;
     protected readonly positions: ConnectedPosition[];
-    protected readonly filteredOptions: _angular_core.Signal<readonly unknown[]>;
+    private typeahead;
+    private typeaheadTimer;
+    /** Todas las opciones (aplanando los grupos). */
+    protected readonly flatOptions: _angular_core.Signal<readonly unknown[]>;
+    protected readonly filteredGroups: _angular_core.Signal<OptionGroup[]>;
+    protected readonly filteredOptions: _angular_core.Signal<unknown[]>;
+    /** Filas del modo virtual (cabeceras de grupo + opciones). */
+    protected readonly virtualRows: _angular_core.Signal<VirtualRow[]>;
+    protected readonly viewportHeight: _angular_core.Signal<number>;
+    private readonly windowStart;
+    protected readonly windowOffset: _angular_core.Signal<number>;
+    protected readonly visibleRows: _angular_core.Signal<VirtualRow[]>;
     protected readonly selected: _angular_core.Signal<unknown[]>;
     protected readonly displayLabel: _angular_core.Signal<string>;
     protected readonly allSelected: _angular_core.Signal<boolean>;
+    protected readonly activeDescendant: _angular_core.Signal<string | null>;
     constructor();
     private onChange;
     private onTouched;
@@ -73,12 +126,20 @@ declare class CbMultiSelect implements ControlValueAccessor {
     protected isOptionDisabled(opt: unknown): boolean;
     protected isSelected(opt: unknown): boolean;
     protected optionId(index: number): string;
-    protected trackOption(opt: unknown): unknown;
+    protected groupId(index: number): string;
+    private groupLabelOf;
+    private childrenOf;
+    private toggleActive;
+    /** Cambia la opción activa y la desplaza a la vista. */
+    private setActive;
     private firstEnabledIndex;
+    private lastEnabledIndex;
     private move;
+    /** Teclear salta a la siguiente opción que empieza por lo escrito (se reinicia tras 500 ms). */
+    private searchByTyping;
     private commit;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMultiSelect, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMultiSelect, "cb-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "showToggleAll": { "alias": "showToggleAll"; "required": false; "isSignal": true; }; "maxSelectedLabels": { "alias": "maxSelectedLabels"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMultiSelect, "cb-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "optionGroupLabel": { "alias": "optionGroupLabel"; "required": false; "isSignal": true; }; "optionGroupChildren": { "alias": "optionGroupChildren"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "showToggleAll": { "alias": "showToggleAll"; "required": false; "isSignal": true; }; "maxSelectedLabels": { "alias": "maxSelectedLabels"; "required": false; "isSignal": true; }; "scrollHeight": { "alias": "scrollHeight"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 export { CbMultiSelect };