@caribeng/ui 22.2.0 → 22.5.0

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

@@ -0,0 +1,36 @@
+import * as _angular_core from '@angular/core';
+
+/** Plataforma para la que se muestran las teclas. `auto` la detecta en el navegador. */
+type CbKbdPlatform = 'auto' | 'mac' | 'other';
+interface KeyLabel {
+    /** Texto visible. */
+    text: string;
+    /** Nombre leído por el lector de pantalla cuando el visible es un símbolo. */
+    spoken?: string;
+}
+/**
+ * Tecla o atajo de teclado de CaribeNG. Con contenido muestra una tecla; con
+ * `keys` muestra la combinación (⌘ K en Mac, Ctrl + K en el resto).
+ *
+ * @example
+ * ```html
+ * <cb-kbd>Esc</cb-kbd>
+ * <cb-kbd [keys]="['mod', 'K']" />
+ * ```
+ */
+declare class CbKbd {
+    private readonly doc;
+    /** Teclas de la combinación: nombres (`mod`, `shift`, `alt`, `enter`, `up`…) o texto libre (`K`, `F2`). */
+    readonly keys: _angular_core.InputSignal<readonly string[]>;
+    /** Plataforma a mostrar. `auto` la detecta (⌘ en Mac). */
+    readonly platform: _angular_core.InputSignal<CbKbdPlatform>;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
+    protected readonly isMac: _angular_core.Signal<boolean>;
+    protected readonly labels: _angular_core.Signal<KeyLabel[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKbd, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKbd, "cb-kbd", never, { "keys": { "alias": "keys"; "required": false; "isSignal": true; }; "platform": { "alias": "platform"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { CbKbd };
+export type { CbKbdPlatform };
+//# sourceMappingURL=caribeng-ui-kbd.d.ts.map

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

@@ -0,0 +1,64 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/** Formato del valor del indicador. */
+type CbKpiFormat = 'currency' | 'number' | 'integer' | 'percent';
+/**
+ * Indicador (KPI) de CaribeNG: valor, variación frente al periodo anterior,
+ * minigráfica de tendencia y avance hacia una meta.
+ *
+ * - `better` dice si subir es bueno (`up`, ingresos) o malo (`down`, gastos): el
+ *   color de la variación lo sigue.
+ * - La variación se calcula sola a partir de `previous` y se dice con texto
+ *   («sube 12,3 %»), no solo con el color o la flecha.
+ *
+ * @example
+ * ```html
+ * <cb-kpi label="Ingresos del mes" [value]="208330000" [previous]="167440000" [series]="ventas" compareLabel="vs. octubre 2025" />
+ * ```
+ */
+declare class CbKpi {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    protected readonly Math: Math;
+    private readonly config;
+    protected readonly uid: string;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly value: _angular_core.InputSignal<number | null>;
+    /** Valor del periodo con el que se compara. */
+    readonly previous: _angular_core.InputSignal<number | null>;
+    /** Texto de la comparación («vs. mes anterior»). */
+    readonly compareLabel: _angular_core.InputSignal<string>;
+    /** `up`: subir es bueno (ingresos); `down`: subir es malo (gastos); `none`: sin color. */
+    readonly better: _angular_core.InputSignal<"up" | "down" | "none">;
+    readonly format_: _angular_core.InputSignal<CbKpiFormat>;
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    readonly decimals: _angular_core.InputSignal<number | undefined>;
+    /** Serie para la minigráfica (del más antiguo al más reciente). */
+    readonly series: _angular_core.InputSignal<readonly number[]>;
+    /** Meta: muestra el avance del valor hacia ella. */
+    readonly target: _angular_core.InputSignal<number | null>;
+    private readonly locale;
+    protected format(v: number | null): string;
+    protected readonly delta: _angular_core.Signal<{
+        change: number;
+        good: boolean | null;
+        text: string;
+        spoken: string;
+    } | null>;
+    protected readonly points: _angular_core.Signal<{
+        line: string;
+        area: string;
+    } | null>;
+    protected readonly sparkLabel: _angular_core.Signal<string>;
+    protected readonly progress: _angular_core.Signal<{
+        pct: number;
+    } | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKpi, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKpi, "cb-kpi", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "previous": { "alias": "previous"; "required": false; "isSignal": true; }; "compareLabel": { "alias": "compareLabel"; "required": false; "isSignal": true; }; "better": { "alias": "better"; "required": false; "isSignal": true; }; "format_": { "alias": "format"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "decimals": { "alias": "decimals"; "required": false; "isSignal": true; }; "series": { "alias": "series"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CbKpi };
+export type { CbKpiFormat };
+//# sourceMappingURL=caribeng-ui-kpi.d.ts.map

package/types/{caribeng-ui-caribe-link.d.ts → caribeng-ui-link.d.ts}

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 
 /**
- * Enlace de Caribe Design. Renderiza un ancla accesible con estilos de marca,
+ * Enlace. Renderiza un ancla accesible con estilos de marca,
  * soporte de enlaces externos y estado deshabilitado.
  *
  * @example
@@ -27,4 +27,4 @@ declare class CbLink {
 }
 
 export { CbLink };
-//# sourceMappingURL=caribeng-ui-caribe-link.d.ts.map
+//# sourceMappingURL=caribeng-ui-link.d.ts.map

package/types/{caribeng-ui-caribe-logo.d.ts → caribeng-ui-logo.d.ts}

@@ -14,4 +14,4 @@ declare class CbLogo {
 
 export { CbLogo };
 export type { CbLogoFormat };
-//# sourceMappingURL=caribeng-ui-caribe-logo.d.ts.map
+//# sourceMappingURL=caribeng-ui-logo.d.ts.map

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

@@ -0,0 +1,32 @@
+import * as _angular_core from '@angular/core';
+
+/** Filas que ocupa un elemento de `height` px con un hueco de `gap` px debajo. */
+declare function masonrySpan(height: number, gap: number, row?: number): number;
+/**
+ * Masonry de CaribeNG: reparte los elementos proyectados en columnas de alturas distintas, sin
+ * huecos, como un tablero de Pinterest. Usa CSS Grid y mide la altura de cada elemento (también
+ * si cambia, p. ej. al cargar una imagen), así que el orden del DOM —el que siguen el teclado y
+ * los lectores de pantalla— es el orden visual por filas, a diferencia de las columnas de CSS.
+ *
+ * @example
+ * ```html
+ * <cb-masonry minColumnWidth="14rem" gap="12px" role="list">
+ *   @for (foto of fotos(); track foto.id) { <figure role="listitem">…</figure> }
+ * </cb-masonry>
+ * ```
+ */
+declare class CbMasonry {
+    private readonly host;
+    /** Número fijo de columnas (0 = las que quepan con `minColumnWidth`). */
+    readonly columns: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Ancho mínimo de columna cuando `columns` es 0. */
+    readonly minColumnWidth: _angular_core.InputSignal<string>;
+    /** Separación entre elementos (cualquier longitud CSS). */
+    readonly gap: _angular_core.InputSignal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMasonry, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMasonry, "cb-masonry", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "minColumnWidth": { "alias": "minColumnWidth"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { CbMasonry, masonrySpan as cbMasonrySpan };
+//# sourceMappingURL=caribeng-ui-masonry.d.ts.map

package/types/caribeng-ui-media-player.d.ts

@@ -0,0 +1,140 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/** Fuente del medio (varias para que el navegador elija el formato que soporte). */
+interface CbMediaSource {
+    readonly src: string;
+    /** Tipo MIME (`video/mp4`, `audio/mpeg`…). */
+    readonly type?: string;
+}
+/** Pista de texto: subtítulos, subtítulos para personas sordas (`captions`) o descripciones. */
+interface CbMediaTrack {
+    /** Archivo WebVTT. */
+    readonly src: string;
+    readonly kind?: 'subtitles' | 'captions' | 'descriptions' | 'chapters';
+    /** Idioma BCP 47 (`es`, `en`). */
+    readonly srclang: string;
+    readonly label: string;
+    readonly default?: boolean;
+}
+/** Velocidades por defecto. */
+declare const CB_MEDIA_RATES: readonly number[];
+/** "1:05" o "1:02:05" (con `total` de una hora o más, siempre con horas). */
+declare function formatTime(seconds: number, total?: number): string;
+
+/** Transcripción del medio (`<div cbMediaTranscript>…</div>`), en un desplegable bajo los controles. */
+declare class CbMediaTranscript {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMediaTranscript, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbMediaTranscript, "[cbMediaTranscript]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Reproductor de audio y vídeo de CaribeNG con controles propios y accesibles: reproducir,
+ * avanzar y retroceder, barra de progreso y volumen (sliders con su valor hablado), silencio,
+ * velocidad, subtítulos (WebVTT), imagen en imagen, pantalla completa, atajos de teclado como
+ * los de YouTube y transcripción desplegable. Los controles no se ocultan solos.
+ *
+ * @example
+ * ```html
+ * <cb-media-player src="/video/bienvenida.mp4" poster="/video/poster.jpg" [tracks]="subtitulos" heading="Bienvenida" />
+ * <cb-media-player kind="audio" src="/audio/podcast.mp3" heading="Episodio 12">
+ *   <div cbMediaTranscript>…</div>
+ * </cb-media-player>
+ * ```
+ */
+declare class CbMediaPlayer {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly host;
+    private readonly document;
+    protected readonly hintId: string;
+    /** Archivo a reproducir (o `sources` con varios formatos). */
+    readonly src: _angular_core.InputSignal<string>;
+    readonly sources: _angular_core.InputSignal<readonly CbMediaSource[]>;
+    readonly kind: _angular_core.InputSignal<"video" | "audio">;
+    readonly poster: _angular_core.InputSignal<string>;
+    /** Título: nombre del reproductor y, en audio, se muestra encima de los controles (no `title`, que daría un tooltip). */
+    readonly heading: _angular_core.InputSignal<string>;
+    /** Texto secundario en audio (autor, programa…). */
+    readonly subtitle: _angular_core.InputSignal<string>;
+    /** Subtítulos y descripciones (WebVTT). */
+    readonly tracks: _angular_core.InputSignal<readonly CbMediaTrack[]>;
+    readonly rates: _angular_core.InputSignal<readonly number[]>;
+    /** Segundos de los botones de retroceder y avanzar (0 los oculta). */
+    readonly skipSeconds: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly loop: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Empieza silenciado. */
+    readonly startMuted: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly preload: _angular_core.InputSignal<"none" | "metadata" | "auto">;
+    /** `anonymous` para subtítulos o medios de otro dominio con CORS. */
+    readonly crossorigin: _angular_core.InputSignal<"" | "anonymous" | "use-credentials">;
+    readonly errorMessage: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly played: _angular_core.OutputEmitterRef<void>;
+    readonly paused: _angular_core.OutputEmitterRef<void>;
+    readonly ended: _angular_core.OutputEmitterRef<void>;
+    /** Segundo actual, mientras se reproduce. */
+    readonly timeUpdate: _angular_core.OutputEmitterRef<number>;
+    readonly mediaError: _angular_core.OutputEmitterRef<MediaError | null>;
+    protected readonly transcript: _angular_core.Signal<CbMediaTranscript | undefined>;
+    private readonly mediaRef;
+    protected readonly playing: _angular_core.WritableSignal<boolean>;
+    protected readonly started: _angular_core.WritableSignal<boolean>;
+    protected readonly waiting: _angular_core.WritableSignal<boolean>;
+    protected readonly current: _angular_core.WritableSignal<number>;
+    protected readonly duration: _angular_core.WritableSignal<number>;
+    protected readonly volume: _angular_core.WritableSignal<number>;
+    protected readonly muted: _angular_core.WritableSignal<boolean>;
+    protected readonly rate: _angular_core.WritableSignal<number>;
+    protected readonly activeTrack: _angular_core.WritableSignal<number>;
+    protected readonly fullscreen: _angular_core.WritableSignal<boolean>;
+    protected readonly pip: _angular_core.WritableSignal<boolean>;
+    protected readonly error: _angular_core.WritableSignal<boolean>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    protected readonly pipSupported: boolean;
+    protected readonly sourceList: _angular_core.Signal<readonly CbMediaSource[]>;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly progress: _angular_core.Signal<number>;
+    protected readonly seekText: _angular_core.Signal<string>;
+    constructor();
+    play(): Promise<void>;
+    pause(): void;
+    toggle(): void;
+    /** Salta al segundo indicado. */
+    seekTo(seconds: number): void;
+    seekBy(seconds: number): void;
+    protected percent(v: number): number;
+    protected timeText(seconds: number): string;
+    protected rateText(r: number): string;
+    private spoken;
+    protected onSeekInput(event: Event): void;
+    /** En la barra de progreso, las flechas saltan 5 s y Re Pág / Av Pág 10 s (el paso nativo sería casi nulo). */
+    protected onSeekKeydown(event: KeyboardEvent): void;
+    protected onVolumeInput(event: Event): void;
+    protected toggleMute(): void;
+    protected setRate(rate: number): void;
+    protected toggleCaptions(): void;
+    protected setTrack(index: number): void;
+    protected toggleFullscreen(): Promise<void>;
+    protected togglePip(): Promise<void>;
+    /** Atajos con el foco en el reproductor, salvo las teclas que ya usa el control enfocado. */
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onPlay(): void;
+    protected onPause(): void;
+    protected onEnded(event: Event): void;
+    protected onTime(event: Event): void;
+    protected sync(event: Event): void;
+    protected onError(event: Event): void;
+    private run;
+    private media;
+    private syncFromMedia;
+    /** Un espacio duro alterno hace que el mismo texto cuente como cambio y se vuelva a anunciar. */
+    private announce;
+    private announceFlip;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMediaPlayer, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMediaPlayer, "cb-media-player", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "sources": { "alias": "sources"; "required": false; "isSignal": true; }; "kind": { "alias": "kind"; "required": false; "isSignal": true; }; "poster": { "alias": "poster"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "tracks": { "alias": "tracks"; "required": false; "isSignal": true; }; "rates": { "alias": "rates"; "required": false; "isSignal": true; }; "skipSeconds": { "alias": "skipSeconds"; "required": false; "isSignal": true; }; "loop": { "alias": "loop"; "required": false; "isSignal": true; }; "startMuted": { "alias": "muted"; "required": false; "isSignal": true; }; "preload": { "alias": "preload"; "required": false; "isSignal": true; }; "crossorigin": { "alias": "crossorigin"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "played": "played"; "paused": "paused"; "ended": "ended"; "timeUpdate": "timeUpdate"; "mediaError": "mediaError"; }, ["transcript"], ["[cbMediaTranscript]"], true, never>;
+}
+
+export { CB_MEDIA_RATES, CbMediaPlayer, CbMediaTranscript, formatTime as cbFormatMediaTime };
+export type { CbMediaSource, CbMediaTrack };
+//# sourceMappingURL=caribeng-ui-media-player.d.ts.map

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

@@ -1,20 +1,29 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { CbMenuCommandEvent } from '@caribeng/ui';
 
 interface CbMegaMenuLink {
     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<CbMegaMenuLink>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 interface CbMegaMenuGroup {
     label: string;
     items: readonly CbMegaMenuLink[];
+    /** `false` oculta el elemento. */
+    visible?: boolean;
 }
 interface CbMegaMenuItem {
     label: string;
     icon?: string;
     groups: readonly CbMegaMenuGroup[];
+    /** `false` oculta el elemento. */
+    visible?: boolean;
 }
 /**
  * Menú de categorías con paneles de varias columnas (patrón *disclosure
@@ -34,6 +43,8 @@ declare class CbMegaMenu {
     protected readonly panelId: string;
     /** Categorías con sus grupos de enlaces. */
     readonly items: _angular_core.InputSignal<readonly CbMegaMenuItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbMegaMenuItem[]>;
     /** 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. */

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

@@ -0,0 +1,127 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbRequiredIndicator } from '@caribeng/ui';
+import { ControlValueAccessor } from '@angular/forms';
+
+/** Persona, etiqueta o elemento que se puede mencionar. */
+interface CbMentionItem {
+    readonly id: string;
+    /** Texto que se inserta tras el disparador (`@Laura Gómez`). */
+    readonly label: string;
+    /** Texto secundario en la lista (cargo, correo…). */
+    readonly description?: string;
+    /** Imagen del avatar en la lista. */
+    readonly avatar?: string;
+    /** Disparador al que pertenece (`@` por defecto, `#` para etiquetas…). */
+    readonly trigger?: string;
+}
+/** Mención presente en el texto. */
+interface CbMention {
+    readonly id: string;
+    readonly label: string;
+    readonly trigger: string;
+}
+/** Búsqueda en curso (para pedir sugerencias al servidor). */
+interface CbMentionSearch {
+    readonly trigger: string;
+    readonly query: string;
+}
+/**
+ * Campo de texto con menciones de CaribeNG: al escribir `@` (u otro
+ * disparador como `#`) muestra sugerencias junto al cursor, que se filtran
+ * sin tildes y se eligen con el teclado o el ratón. Funciona con Angular Forms
+ * (el valor es el texto) y emite las menciones presentes con su `id`.
+ *
+ * @example
+ * ```html
+ * <cb-mentions label="Comentario" [suggestions]="equipo" formControlName="comentario" (mentionsChange)="menciones = $event" />
+ * ```
+ */
+declare class CbMentions implements ControlValueAccessor {
+    /** 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 injector;
+    private readonly fieldEl;
+    private readonly panelTpl;
+    private overlayRef;
+    protected readonly inputId: string;
+    protected readonly listId: string;
+    /** Texto (bidireccional y con Angular Forms). */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Elementos mencionables. Cada uno puede indicar su `trigger`. */
+    readonly suggestions: _angular_core.InputSignal<readonly CbMentionItem[]>;
+    /** Caracteres que abren las sugerencias. */
+    readonly triggers: _angular_core.InputSignal<readonly string[]>;
+    /** Filtra `suggestions` con lo escrito. Desactívalo si llegan ya filtradas del servidor. */
+    readonly filter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Máximo de sugerencias visibles. */
+    readonly maxResults: _angular_core.InputSignal<number>;
+    /** Muestra "Cargando" mientras no hay sugerencias. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly hint: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Nombre accesible sin `label` visible. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly rows: _angular_core.InputSignal<number>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly requiredIndicator: _angular_core.InputSignal<CbRequiredIndicator | undefined>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Lo escrito tras el disparador (para pedir sugerencias). */
+    readonly search: _angular_core.OutputEmitterRef<CbMentionSearch>;
+    /** Menciones presentes en el texto, cada vez que cambian. */
+    readonly mentionsChange: _angular_core.OutputEmitterRef<CbMention[]>;
+    protected readonly fieldState: _caribeng_ui.CbFieldState;
+    private readonly cvaDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    private readonly query;
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly active: _angular_core.WritableSignal<number>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    /** Menciones elegidas (se conservan mientras su texto siga en el campo). */
+    private chosen;
+    private lastMentions;
+    protected readonly results: _angular_core.Signal<CbMentionItem[]>;
+    protected readonly activeId: _angular_core.Signal<string | null>;
+    private onChange;
+    private onTouched;
+    protected initials(item: CbMentionItem): string;
+    writeValue(value: string | null): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    protected onInput(event: Event): void;
+    protected onBlur(): void;
+    /** Busca un disparador justo antes del cursor y abre (o cierra) las sugerencias. */
+    detect(): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    /** Inserta la mención elegida en lugar de lo escrito tras el disparador. */
+    protected choose(item: CbMentionItem): void;
+    /** Quita las menciones cuyo texto ya no está y avisa si cambió la lista. */
+    private syncMentions;
+    private openPanel;
+    private position;
+    /** Cierra las sugerencias. */
+    close(): void;
+    private scrollActiveIntoView;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbMentions, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbMentions, "cb-mentions", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "triggers": { "alias": "triggers"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "maxResults": { "alias": "maxResults"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "requiredIndicator": { "alias": "requiredIndicator"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "search": "search"; "mentionsChange": "mentionsChange"; }, never, never, true, never>;
+}
+
+/**
+ * Posición (px, relativa al campo) del carácter `index` de un textarea o
+ * input, con un div espejo invisible que copia su tipografía y su ancho.
+ * Sirve para abrir el panel de sugerencias justo bajo lo que se escribe.
+ */
+declare function cbCaretCoordinates(field: HTMLTextAreaElement | HTMLInputElement, index: number): {
+    top: number;
+    left: number;
+    height: number;
+};
+
+export { CbMentions, cbCaretCoordinates };
+export type { CbMention, CbMentionItem, CbMentionSearch };
+//# sourceMappingURL=caribeng-ui-mentions.d.ts.map

package/types/caribeng-ui-menu.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 CbMenuItem {
     label: string;
@@ -8,6 +9,10 @@ interface CbMenuItem {
     target?: string;
     disabled?: boolean;
     separator?: boolean;
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbMenuItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Popup menu anchored to any trigger element. */
 declare class CbMenu {
@@ -17,6 +22,8 @@ declare class CbMenu {
     private readonly vcr;
     private readonly destroyRef;
     readonly items: _angular_core.InputSignal<readonly CbMenuItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbMenuItem[]>;
     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). */

package/types/caribeng-ui-menubar.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 CbMenubarItem {
     label: string;
@@ -8,6 +9,10 @@ interface CbMenubarItem {
     target?: string;
     disabled?: boolean;
     items?: readonly CbMenubarItem[];
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbMenubarItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Horizontal navigation bar with optional one-level dropdown menus. */
 declare class CbMenubar {
@@ -16,6 +21,8 @@ declare class CbMenubar {
     private readonly host;
     private readonly injector;
     readonly items: _angular_core.InputSignal<readonly CbMenubarItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbMenubarItem[]>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbMenubarItem>;
     protected readonly openIndex: _angular_core.WritableSignal<number | null>;

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

@@ -21,6 +21,8 @@ declare class CbMessage {
     readonly icon: _angular_core.InputSignal<string | null>;
     /** Visibilidad (two-way). */
     readonly visible: _angular_core.ModelSignal<boolean>;
+    /** danger y warning se anuncian al momento (`alert`); el resto, sin interrumpir (`status`). */
+    protected readonly urgent: _angular_core.Signal<boolean>;
     /** Se emite al cerrar. */
     readonly closed: _angular_core.OutputEmitterRef<void>;
     protected readonly iconName: _angular_core.Signal<string>;