@caribeng/ui 22.1.0 → 22.2.0

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

@@ -1,7 +1,11 @@
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
 import { TemplateRef } from '@angular/core';
 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. */
     field: string;
@@ -9,35 +13,110 @@ interface CbTableColumn {
     header: string;
     /** Permite ordenar por esta columna. */
     sortable?: boolean;
+    /** Muestra un campo de filtro bajo el encabezado. */
+    filter?: boolean;
+    /** Comparación del filtro de la columna. Por defecto `contains`. */
+    filterMatchMode?: CbTableFilterMatchMode;
+    /** Placeholder del filtro de la columna. */
+    filterPlaceholder?: string;
     /** Alineación del contenido. */
     align?: 'left' | 'center' | 'right';
     /** Ancho CSS de la columna. */
     width?: string;
+    /** Fija la columna a la izquierda al hacer scroll horizontal (las fijas se muestran primero). */
+    frozen?: boolean;
+    /** Incluir la columna en `toCSV()` / `exportCSV()`. Por defecto `true`. */
+    exportable?: boolean;
 }
-interface CbTableCellContext {
-    $implicit: unknown;
-    row: unknown;
-    value: unknown;
+interface CbTableCellContext<T = any> {
+    $implicit: T;
+    row: T;
+    value: any;
     col: CbTableColumn;
 }
+interface CbTableRowExpansionContext<T = any> {
+    $implicit: T;
+    /** Posición de la fila en los datos filtrados y ordenados. */
+    index: number;
+}
+interface CbTableGroupHeaderContext<T = any> {
+    /** Valor del campo `groupRowsBy` del grupo. */
+    $implicit: T;
+    /** Filas del grupo (en todos los datos filtrados). */
+    count: number;
+}
+/** Petición de datos en modo `lazy`: la tabla pide la página, el orden y los filtros al servidor. */
+interface CbTableLazyLoadEvent {
+    first: number;
+    rows: number;
+    sortField: string | null;
+    sortOrder: 1 | -1;
+    globalFilter: string;
+    filters: Readonly<Partial<Record<string, string>>>;
+}
+/** Opciones de `toCSV()` / `exportCSV()`. */
+interface CbTableCsvOptions {
+    /** Solo las filas seleccionadas. */
+    selectionOnly?: boolean;
+    /** Separador de columnas. Por defecto `,`. */
+    separator?: string;
+}
+/** Estado de los filtros, emitido por `filterChange`. */
+interface CbTableFilterState {
+    global: string;
+    /** Texto de filtro por campo de columna. */
+    columns: Readonly<Partial<Record<string, string>>>;
+}
+/** Plantilla de las celdas de una columna: `<ng-template cbTableCell="campo" let-row let-value="value">`. */
 declare class CbTableCellDirective {
     readonly cbTableCell: _angular_core.InputSignal<string>;
-    readonly template: TemplateRef<CbTableCellContext>;
+    readonly template: TemplateRef<CbTableCellContext<any>>;
+    static ngTemplateContextGuard(_dir: CbTableCellDirective, ctx: unknown): ctx is CbTableCellContext;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTableCellDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTableCellDirective, "ng-template[cbTableCell]", never, { "cbTableCell": { "alias": "cbTableCell"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+/** Contenido de la fila expandida: `<ng-template cbTableRowExpansion let-row>`. */
+declare class CbTableRowExpansion {
+    readonly template: TemplateRef<CbTableRowExpansionContext<any>>;
+    static ngTemplateContextGuard(_dir: CbTableRowExpansion, ctx: unknown): ctx is CbTableRowExpansionContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTableRowExpansion, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTableRowExpansion, "ng-template[cbTableRowExpansion]", never, {}, {}, never, never, true, never>;
+}
+/** Cabecera de grupo: `<ng-template cbTableGroupHeader let-valor let-count="count">`. */
+declare class CbTableGroupHeader {
+    readonly template: TemplateRef<CbTableGroupHeaderContext<any>>;
+    static ngTemplateContextGuard(_dir: CbTableGroupHeader, ctx: unknown): ctx is CbTableGroupHeaderContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTableGroupHeader, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTableGroupHeader, "ng-template[cbTableGroupHeader]", never, {}, {}, never, never, true, never>;
+}
 /**
  * Table de CaribeNG: tabla de datos con columnas declarativas, ordenación,
- * paginación y selección (simple/múltiple).
+ * filtros (global y por columna), paginación, selección (simple/múltiple),
+ * columnas redimensionables y fijas, cabecera fija, filas expandibles y
+ * agrupadas, exportación a CSV y carga desde el servidor (`lazy`).
  *
  * @example
  * ```html
- * <cb-table [value]="productos" [columns]="cols" [paginator]="true" [rows]="5"
- *           striped selectionMode="multiple" dataKey="id" [(selection)]="sel" />
+ * <input type="search" [(ngModel)]="busqueda" aria-label="Buscar" />
+ * <cb-table [value]="productos" [columns]="cols" [globalFilter]="busqueda" [paginator]="true" [rows]="5"
+ *           striped selectionMode="multiple" dataKey="id" [(selection)]="sel" resizableColumns>
+ *   <ng-template cbTableRowExpansion let-producto>{{ producto.descripcion }}</ng-template>
+ * </cb-table>
  * ```
  */
 declare class CbTable {
+    /** 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;
+    protected readonly minColumnWidth = 48;
+    private readonly document;
     private readonly cellTemplates;
+    /** Plantilla de fila expandida; si existe, se añade la columna de expandir. */
+    protected readonly expansion: _angular_core.Signal<CbTableRowExpansion | undefined>;
+    /** Plantilla de cabecera de grupo (con `groupRowsBy`). */
+    protected readonly groupHeader: _angular_core.Signal<CbTableGroupHeader | undefined>;
+    private readonly tableRef;
     readonly value: _angular_core.InputSignal<readonly unknown[]>;
     readonly columns: _angular_core.InputSignal<readonly CbTableColumn[]>;
     readonly paginator: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -46,40 +125,129 @@ declare class CbTable {
     readonly striped: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly rowHover: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
-    readonly emptyMessage: _angular_core.InputSignal<string>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Nombre accesible de la tabla. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     /** `single`, `multiple` o `null` (sin selección). */
     readonly selectionMode: _angular_core.InputSignal<"single" | "multiple" | null>;
-    /** Propiedad identificadora para comparar selección (si no, por referencia). */
+    /** Propiedad identificadora para comparar selección y filas expandidas (si no, por referencia). */
     readonly dataKey: _angular_core.InputSignal<string | null>;
+    /** Texto del filtro global (two-way). Busca en `globalFilterFields`. */
+    readonly globalFilter: _angular_core.ModelSignal<string>;
+    /** Campos en los que busca el filtro global. Por defecto, los de todas las columnas. */
+    readonly globalFilterFields: _angular_core.InputSignal<readonly string[] | null>;
+    /** Permite cambiar el ancho de las columnas arrastrando o con el teclado. */
+    readonly resizableColumns: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Claves (`dataKey`) o filas expandidas (two-way). */
+    readonly expandedRowKeys: _angular_core.ModelSignal<readonly unknown[]>;
+    /** Alto máximo (CSS) de la tabla: hace scroll con la cabecera fija. */
+    readonly scrollHeight: _angular_core.InputSignal<string | null>;
+    /** Agrupa las filas por este campo, con una fila de cabecera por grupo. */
+    readonly groupRowsBy: _angular_core.InputSignal<string | null>;
+    /**
+     * Datos desde el servidor: la tabla no filtra, ordena ni pagina; emite `lazyLoad`
+     * y muestra `value` tal cual (la página actual).
+     */
+    readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Total de filas en el servidor (modo `lazy`), para el paginador. */
+    readonly totalRecords: _angular_core.InputSignal<number | null>;
+    /** Muestra la capa de carga y marca la tabla con `aria-busy`. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly selection: _angular_core.ModelSignal<unknown>;
     readonly sortChange: _angular_core.OutputEmitterRef<{
         field: string | null;
         order: 1 | -1;
     }>;
-    protected readonly first: _angular_core.WritableSignal<number>;
+    readonly filterChange: _angular_core.OutputEmitterRef<CbTableFilterState>;
+    readonly columnResize: _angular_core.OutputEmitterRef<{
+        field: string;
+        width: number;
+    }>;
+    readonly rowExpand: _angular_core.OutputEmitterRef<unknown>;
+    readonly rowCollapse: _angular_core.OutputEmitterRef<unknown>;
+    /** En modo `lazy`: página, orden y filtros que hay que pedir al servidor. */
+    readonly lazyLoad: _angular_core.OutputEmitterRef<CbTableLazyLoadEvent>;
     private readonly sortField;
     private readonly sortOrder;
-    protected readonly sorted: _angular_core.Signal<unknown[]>;
-    protected readonly pageRows: _angular_core.Signal<unknown[]>;
+    protected readonly columnFilters: _angular_core.WritableSignal<Readonly<Partial<Record<string, string>>>>;
+    protected readonly widths: _angular_core.WritableSignal<Readonly<Partial<Record<string, number>>>>;
+    /** Columnas en orden de pantalla: las fijas primero. */
+    protected readonly displayColumns: _angular_core.Signal<CbTableColumn[]>;
+    protected readonly hasFrozen: _angular_core.Signal<boolean>;
+    protected readonly lastFrozen: _angular_core.Signal<string | null>;
+    /** Desplazamiento `left` (px) de cada celda fija, medido tras el render. */
+    private readonly frozenOffsets;
+    protected readonly hasColumnFilters: _angular_core.Signal<boolean>;
+    protected readonly isFiltering: _angular_core.Signal<boolean>;
+    protected readonly filtered: _angular_core.Signal<readonly unknown[]>;
+    protected readonly sorted: _angular_core.Signal<readonly unknown[]>;
+    /** Filas totales: las del servidor en modo `lazy`, las filtradas si no. */
+    protected readonly total: _angular_core.Signal<number>;
+    /** Primera fila de la página; vuelve a 0 al filtrar u ordenar (y, sin `lazy`, al cambiar los datos). */
+    protected readonly first: _angular_core.WritableSignal<number>;
+    /** Filas por grupo en todos los datos (no solo en la página). */
+    private readonly groupCounts;
+    protected readonly pageRows: _angular_core.Signal<readonly unknown[]>;
     protected readonly colspan: _angular_core.Signal<number>;
+    private readonly selectedCount;
     protected readonly allSelected: _angular_core.Signal<boolean>;
+    protected readonly someSelected: _angular_core.Signal<boolean>;
+    private readonly uid;
+    private stopResize;
+    constructor();
+    /** Aplica el filtro global (equivale a `[globalFilter]`). */
+    filterGlobal(text: string): void;
+    /** Aplica el filtro de una columna. */
+    filterColumn(field: string, text: string): void;
+    /** Quita todos los filtros. */
+    clearFilters(): void;
+    private emitFilters;
+    /** Pide al servidor la página actual (solo en modo `lazy`). */
+    private emitLazy;
+    private matchMode;
     protected onSort(col: CbTableColumn): void;
     protected sortIcon(col: CbTableColumn): string;
     protected ariaSort(col: CbTableColumn): string | null;
     protected onRowClick(row: unknown): void;
     protected toggleAll(): void;
     protected isSelected(row: unknown): boolean;
+    protected isExpanded(row: unknown): boolean;
+    /** Expande o contrae una fila. */
+    toggleExpansion(row: unknown): void;
+    protected expansionId(index: number): string;
+    protected columnWidth(col: CbTableColumn): string | null;
+    protected startResize(event: PointerEvent, col: CbTableColumn): void;
+    /** Flecha izquierda / derecha cambian el ancho (10 px; 50 px con Mayús). */
+    protected onResizerKeydown(event: KeyboardEvent, col: CbTableColumn): void;
+    private currentWidth;
+    private setWidth;
     protected onPageChange(state: CbPaginatorState): void;
+    protected groupOf(row: unknown): unknown;
+    protected groupCount(row: unknown): number;
+    /** La fila abre grupo si es la primera de la página o cambia el valor del grupo. */
+    protected isGroupStart(index: number): boolean;
+    protected frozenLeft(key: string): number | null;
+    /** Suma los anchos de las celdas fijas anteriores (expandir, selección y columnas `frozen`). */
+    private measureFrozen;
+    /**
+     * Datos en CSV: columnas visibles (salvo `exportable: false`) y todas las filas
+     * filtradas y ordenadas (no solo la página), o las seleccionadas con `selectionOnly`.
+     */
+    toCSV(options?: CbTableCsvOptions): string;
+    /** Descarga el CSV (`nombre.csv`), con BOM para que Excel respete tildes y eñes. */
+    exportCSV(filename?: string, options?: CbTableCsvOptions): void;
     protected cellValue(row: unknown, col: CbTableColumn): unknown;
     protected cellTemplate(field: string): CbTableCellDirective | undefined;
     protected cellContext(row: unknown, col: CbTableColumn): CbTableCellContext;
     protected rowKey(row: unknown, index: number): unknown;
+    /** Clave de una fila: su `dataKey` o la propia fila. */
+    private keyOf;
     private same;
     private compare;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTable, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTable, "cb-table", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "paginator": { "alias": "paginator"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "striped": { "alias": "striped"; "required": false; "isSignal": true; }; "rowHover": { "alias": "rowHover"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; }, { "rows": "rowsChange"; "selection": "selectionChange"; "sortChange": "sortChange"; }, ["cellTemplates"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTable, "cb-table", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "paginator": { "alias": "paginator"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "rowsPerPageOptions": { "alias": "rowsPerPageOptions"; "required": false; "isSignal": true; }; "striped": { "alias": "striped"; "required": false; "isSignal": true; }; "rowHover": { "alias": "rowHover"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; "globalFilter": { "alias": "globalFilter"; "required": false; "isSignal": true; }; "globalFilterFields": { "alias": "globalFilterFields"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "expandedRowKeys": { "alias": "expandedRowKeys"; "required": false; "isSignal": true; }; "scrollHeight": { "alias": "scrollHeight"; "required": false; "isSignal": true; }; "groupRowsBy": { "alias": "groupRowsBy"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; }, { "rows": "rowsChange"; "globalFilter": "globalFilterChange"; "expandedRowKeys": "expandedRowKeysChange"; "selection": "selectionChange"; "sortChange": "sortChange"; "filterChange": "filterChange"; "columnResize": "columnResize"; "rowExpand": "rowExpand"; "rowCollapse": "rowCollapse"; "lazyLoad": "lazyLoad"; }, ["cellTemplates", "expansion", "groupHeader"], ["[cbTableHeader]"], true, never>;
 }
 
-export { CbTable, CbTableCellDirective };
-export type { CbTableCellContext, CbTableColumn };
+export { CbTable, CbTableCellDirective, CbTableGroupHeader, CbTableRowExpansion };
+export type { CbTableCellContext, CbTableColumn, CbTableCsvOptions, CbTableFilterMatchMode, CbTableFilterState, CbTableGroupHeaderContext, CbTableLazyLoadEvent, CbTableRowExpansionContext };
 //# sourceMappingURL=caribeng-ui-table.d.ts.map

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbTabMenuItem {
     label: string;
@@ -8,9 +9,11 @@ interface CbTabMenuItem {
 }
 /** 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[]>;
     readonly activeIndex: _angular_core.ModelSignal<number>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbTabMenuItem>;
     select(item: CbTabMenuItem, index: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTabMenu, never>;

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbTerminalEntry {
     command: string;
@@ -8,13 +9,22 @@ interface CbTerminalEntry {
  * Terminal de CaribeNG: consola interactiva basada en señales con historial de comandos.
  */
 declare class CbTerminal {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly welcomeMessage: _angular_core.InputSignal<string>;
     readonly prompt: _angular_core.InputSignal<string>;
     readonly commandEntered: _angular_core.OutputEmitterRef<string>;
     readonly entries: _angular_core.WritableSignal<CbTerminalEntry[]>;
     readonly currentCommand: _angular_core.WritableSignal<string>;
+    /** Posición en el historial al recorrerlo con flechas (`null` = escribiendo uno nuevo). */
+    private historyIndex;
+    private readonly commandInput;
+    /** Fija el comando actual también en el DOM (el binding no detecta '' → '' si no hubo render entre medias). */
+    private setCommand;
     protected onInput(event: Event): void;
     submitCommand(): void;
+    /** Flecha arriba / abajo recorren los comandos anteriores. */
+    protected recall(event: Event, step: -1 | 1): void;
     sendResponse(response: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTerminal, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTerminal, "cb-terminal", never, { "welcomeMessage": { "alias": "welcomeMessage"; "required": false; "isSignal": true; }; "prompt": { "alias": "prompt"; "required": false; "isSignal": true; }; }, { "commandEntered": "commandEntered"; }, never, never, true, never>;

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

@@ -0,0 +1,32 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbThemeService, CbSize } from '@caribeng/ui';
+
+/**
+ * Botón de cambio de tema claro / oscuro sobre `CbThemeService` (con
+ * `provideCaribeNG({ persistTheme: true })` recuerda la elección).
+ *
+ * Su nombre accesible describe la acción ("Cambiar a tema oscuro"), por eso
+ * no usa `aria-pressed`.
+ *
+ * @example
+ * ```html
+ * <cb-theme-toggle />
+ * <cb-theme-toggle showLabel size="sm" />
+ * ```
+ */
+declare class CbThemeToggle {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly theme: CbThemeService;
+    readonly size: _angular_core.InputSignal<CbSize>;
+    /** Muestra el texto además del icono. */
+    readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Acción que hará el botón: cambiar al tema contrario al actual. */
+    protected readonly label: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbThemeToggle, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbThemeToggle, "cb-theme-toggle", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CbThemeToggle };
+//# sourceMappingURL=caribeng-ui-themetoggle.d.ts.map

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbTieredMenuItem {
     label: string;
@@ -10,12 +11,14 @@ interface CbTieredMenuItem {
 }
 /** Popup menu with cascading submenus. */
 declare class CbTieredMenu {
+    /** 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 CbTieredMenuItem[]>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
-    readonly triggerLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly triggerLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbTieredMenuItem>;
     protected readonly isOpen: _angular_core.WritableSignal<boolean>;
     protected readonly openIndex: _angular_core.WritableSignal<number | null>;

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

@@ -1,18 +1,77 @@
 import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbTimelineEvent {
     title: string;
+    /** Fecha o momento, tal como se muestra (p. ej. "Hoy, 10:30"). */
     date?: string;
+    /** Fecha legible por máquina para `<time datetime>` (p. ej. "2026-10-20T10:30"). */
+    datetime?: string;
     description?: string;
+    /** Icono dentro del marcador (nombre del set de iconos). */
+    icon?: string;
+    /** Color del marcador (cualquier color CSS). */
+    color?: string;
 }
+type CbTimelineAlign = 'left' | 'right' | 'alternate';
+/** Contexto de las plantillas `let-event let-index="index"`. */
+interface CbTimelineContext {
+    $implicit: CbTimelineEvent;
+    index: number;
+}
+/** Plantilla del contenido de cada evento. */
+declare class CbTimelineContentTemplate {
+    readonly template: TemplateRef<CbTimelineContext>;
+    static ngTemplateContextGuard(_dir: CbTimelineContentTemplate, ctx: unknown): ctx is CbTimelineContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTimelineContentTemplate, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTimelineContentTemplate, "ng-template[cbTimelineContent]", never, {}, {}, never, never, true, never>;
+}
+/** Plantilla del lado opuesto al contenido (p. ej. la fecha). */
+declare class CbTimelineOppositeTemplate {
+    readonly template: TemplateRef<CbTimelineContext>;
+    static ngTemplateContextGuard(_dir: CbTimelineOppositeTemplate, ctx: unknown): ctx is CbTimelineContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTimelineOppositeTemplate, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTimelineOppositeTemplate, "ng-template[cbTimelineOpposite]", never, {}, {}, never, never, true, never>;
+}
+/** Plantilla del marcador de cada evento. */
+declare class CbTimelineMarkerTemplate {
+    readonly template: TemplateRef<CbTimelineContext>;
+    static ngTemplateContextGuard(_dir: CbTimelineMarkerTemplate, ctx: unknown): ctx is CbTimelineContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTimelineMarkerTemplate, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTimelineMarkerTemplate, "ng-template[cbTimelineMarker]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Línea de tiempo de CaribeNG: eventos en vertical u horizontal, alineados a
+ * un lado o alternados, con plantillas para el contenido, el lado opuesto y
+ * el marcador.
+ *
+ * @example
+ * ```html
+ * <cb-timeline [value]="eventos" align="alternate" />
+ *
+ * <cb-timeline [value]="eventos">
+ *   <ng-template cbTimelineContent let-evento>{{ evento.title }}</ng-template>
+ * </cb-timeline>
+ * ```
+ */
 declare class CbTimeline {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Eventos, en orden. */
     readonly value: _angular_core.InputSignal<readonly CbTimelineEvent[]>;
+    /** Disposición: vertical (por defecto) u horizontal. */
     readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Lado del contenido respecto a la línea: izquierda, derecha o alternado. */
+    readonly align: _angular_core.InputSignal<CbTimelineAlign>;
+    /** Nombre accesible de la lista. Por defecto, el del idioma activo. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    protected readonly contentTemplate: _angular_core.Signal<CbTimelineContentTemplate | undefined>;
+    protected readonly oppositeTemplate: _angular_core.Signal<CbTimelineOppositeTemplate | undefined>;
+    protected readonly markerTemplate: _angular_core.Signal<CbTimelineMarkerTemplate | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTimeline, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTimeline, "cb-timeline", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTimeline, "cb-timeline", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, ["contentTemplate", "oppositeTemplate", "markerTemplate"], never, true, never>;
 }
 
-export { CbTimeline };
-export type { CbTimelineEvent };
+export { CbTimeline, CbTimelineContentTemplate, CbTimelineMarkerTemplate, CbTimelineOppositeTemplate };
+export type { CbTimelineAlign, CbTimelineContext, CbTimelineEvent };
 //# sourceMappingURL=caribeng-ui-timeline.d.ts.map

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

@@ -1,4 +1,5 @@
 import * as i0 from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 import { CbSeverity } from '@caribeng/ui';
 
 interface CbToastMessage {
@@ -58,6 +59,8 @@ type CbToastPosition = 'top-right' | 'top-left' | 'top-center' | 'bottom-right'
  * ```
  */
 declare class CbToast {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: i0.Signal<_caribeng_ui.CbTranslation>;
     protected readonly service: CbToastService;
     readonly position: i0.InputSignal<CbToastPosition>;
     protected iconFor(severity: CbSeverity): string;

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

@@ -1,6 +1,6 @@
+import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 import { CbSize } from '@caribeng/ui';
-import * as _angular_core from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
@@ -13,8 +13,10 @@ import { ControlValueAccessor } from '@angular/forms';
  * ```
  */
 declare class CbToggleButton implements ControlValueAccessor {
-    readonly onLabel: _angular_core.InputSignal<string>;
-    readonly offLabel: _angular_core.InputSignal<string>;
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    readonly onLabel: _angular_core.InputSignal<string | undefined>;
+    readonly offLabel: _angular_core.InputSignal<string | undefined>;
     readonly onIcon: _angular_core.InputSignal<string>;
     readonly offIcon: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<CbSize>;

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

@@ -1,4 +1,5 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Toolbar de CaribeNG: contenedor horizontal accesible (`role="toolbar"`) para
@@ -15,10 +16,12 @@ import * as i0 from '@angular/core';
  * ```
  */
 declare class CbToolbar {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     /** Etiqueta accesible para el contenedor `role="toolbar"`. */
-    readonly ariaLabel: i0.InputSignal<string>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CbToolbar, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CbToolbar, "cb-toolbar", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[cb-toolbar-start]", "*", "[cb-toolbar-center]", "[cb-toolbar-end]"], true, never>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbToolbar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbToolbar, "cb-toolbar", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[cb-toolbar-start]", "*", "[cb-toolbar-center]", "[cb-toolbar-end]"], true, never>;
 }
 
 export { CbToolbar };

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

@@ -1,19 +1,91 @@
 import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
+/** Nodo de un `<cb-tree>`. */
 interface CbTreeNode {
+    /** Identificador único en todo el árbol. */
     key: string;
     label: string;
+    /** Icono opcional (nombre del set de iconos). */
+    icon?: string;
+    /** El nodo no se puede seleccionar (sí expandir). */
+    disabled?: boolean;
     children?: readonly CbTreeNode[];
+    /** Datos propios, disponibles en la plantilla de nodo. */
+    data?: unknown;
 }
+/** Contexto de la plantilla `<ng-template cbTreeNode let-node let-level="level">`. */
+interface CbTreeNodeContext {
+    $implicit: CbTreeNode;
+    level: number;
+    expanded: boolean;
+    selected: boolean;
+}
+/** Plantilla para el contenido de cada nodo. */
+declare class CbTreeNodeTemplate {
+    readonly template: TemplateRef<CbTreeNodeContext>;
+    static ngTemplateContextGuard(_dir: CbTreeNodeTemplate, ctx: unknown): ctx is CbTreeNodeContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTreeNodeTemplate, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbTreeNodeTemplate, "ng-template[cbTreeNode]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Árbol jerárquico de CaribeNG con niveles ilimitados, selección simple y
+ * navegación con teclado según el patrón *tree* de WAI-ARIA.
+ *
+ * @example
+ * ```html
+ * <cb-tree [value]="nodes" [(selection)]="selected" ariaLabel="Documentos" />
+ *
+ * <cb-tree [value]="nodes">
+ *   <ng-template cbTreeNode let-node>{{ node.label }} ({{ node.children?.length ?? 0 }})</ng-template>
+ * </cb-tree>
+ * ```
+ */
 declare class CbTree {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly host;
+    private readonly uid;
+    /** Nodos raíz. */
     readonly value: _angular_core.InputSignal<readonly CbTreeNode[]>;
+    /** Nodo seleccionado (two-way). */
     readonly selection: _angular_core.ModelSignal<CbTreeNode | null>;
+    /** Nombre accesible del árbol. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Se emite al expandir un nodo. */
+    readonly nodeExpand: _angular_core.OutputEmitterRef<CbTreeNode>;
+    /** Se emite al contraer un nodo. */
+    readonly nodeCollapse: _angular_core.OutputEmitterRef<CbTreeNode>;
+    /** Se emite al seleccionar un nodo. */
+    readonly nodeSelect: _angular_core.OutputEmitterRef<CbTreeNode>;
+    protected readonly nodeTemplate: _angular_core.Signal<CbTreeNodeTemplate | undefined>;
     protected readonly expanded: _angular_core.WritableSignal<ReadonlySet<string>>;
-    protected toggle(key: string): void;
+    /** Último nodo enfocado por el usuario. */
+    protected readonly activeKey: _angular_core.WritableSignal<string | null>;
+    /** Nodo que recibe el foco con Tab (roving tabindex): el activo, el seleccionado o el primero. */
+    protected readonly tabbableKey: _angular_core.Signal<string>;
+    /** Nodos visibles en orden de lectura (solo ramas expandidas). */
+    private readonly visible;
+    /** Expande todos los nodos. */
+    expandAll(): void;
+    /** Contrae todos los nodos. */
+    collapseAll(): void;
+    protected hasChildren(node: CbTreeNode): boolean;
+    protected isExpanded(node: CbTreeNode): boolean;
+    protected isSelected(node: CbTreeNode): boolean;
+    protected itemId(node: CbTreeNode): string;
+    protected toggle(node: CbTreeNode, event?: Event): void;
+    protected onClick(event: Event, node: CbTreeNode): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    private select;
+    private setExpanded;
+    private focus;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTree, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTree, "cb-tree", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTree, "cb-tree", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "nodeExpand": "nodeExpand"; "nodeCollapse": "nodeCollapse"; "nodeSelect": "nodeSelect"; }, ["nodeTemplate"], never, true, never>;
 }
 
-export { CbTree };
-export type { CbTreeNode };
+export { CbTree, CbTreeNodeTemplate };
+export type { CbTreeNode, CbTreeNodeContext };
 //# sourceMappingURL=caribeng-ui-tree.d.ts.map