@caribeng/ui 22.2.0 → 22.5.0

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

@@ -3,7 +3,7 @@ import * as _caribeng_ui from '@caribeng/ui';
 import { cbFormat } from '@caribeng/ui';
 
 /**
- * Step-indicator de Caribe Design: progreso por segmentos para flujos de varios
+ * Step-indicator: progreso por segmentos para flujos de varios
  * pasos (transferencias, onboarding). Muestra segmentos completados, activo y
  * pendientes, con una leyenda opcional.
  *
@@ -31,4 +31,4 @@ declare class CbStepIndicator {
 }
 
 export { CbStepIndicator };
-//# sourceMappingURL=caribeng-ui-caribe-step-indicator.d.ts.map
+//# sourceMappingURL=caribeng-ui-step-indicator.d.ts.map

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

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

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

@@ -1,13 +1,14 @@
 import * as _caribeng_ui from '@caribeng/ui';
-import { cbFormat } from '@caribeng/ui';
+import { cbFormat, CbNegativeStyle, CbSummary } from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
 import { TemplateRef } from '@angular/core';
 import { CbPaginatorState } from '@caribeng/ui/paginator';
+import { CbExcelExportOptions, CbXlsxSheet } from '@caribeng/ui/xlsx';
 
 /** Cómo compara un filtro el texto buscado con el valor de la celda (sin distinguir mayúsculas ni tildes). */
 type CbTableFilterMatchMode = 'contains' | 'startsWith' | 'equals';
 interface CbTableColumn {
-    /** Propiedad de la fila a mostrar. */
+    /** Propiedad de la fila a mostrar. Admite rutas (`cliente.nombre`). */
     field: string;
     /** Texto del encabezado. */
     header: string;
@@ -27,6 +28,27 @@ interface CbTableColumn {
     frozen?: boolean;
     /** Incluir la columna en `toCSV()` / `exportCSV()`. Por defecto `true`. */
     exportable?: boolean;
+    /**
+     * Formato del valor: `number` (separadores y decimales), `currency` (moneda) o
+     * `percent` (`0.15` → 15 %). Los numéricos se alinean a la derecha y los
+     * negativos se marcan en rojo.
+     */
+    type?: 'text' | 'number' | 'currency' | 'percent';
+    /** Moneda de una columna `currency` (si no, la de la tabla o `provideCaribeNG({ currency })`). */
+    currency?: string;
+    /** Decimales fijos de una columna numérica. */
+    decimals?: number;
+    /** Negativos con signo o entre paréntesis (si no, el de la tabla). */
+    negative?: CbNegativeStyle;
+    /** Texto propio de la celda (no cambia el valor con el que se ordena, filtra o exporta). */
+    format?: (value: any, row: any) => string;
+    /**
+     * Total de la columna en el pie (y en los subtotales de grupo): `sum`, `avg`,
+     * `count`, `min`, `max` o una función con las filas filtradas.
+     */
+    summary?: CbSummary | ((rows: readonly any[]) => unknown);
+    /** Texto fijo en el pie de esta columna (p. ej. "Total"). */
+    footer?: string;
 }
 interface CbTableCellContext<T = any> {
     $implicit: T;
@@ -153,6 +175,12 @@ declare class CbTable {
     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>;
+    /** Con `groupRowsBy`, una fila de subtotal al final de cada grupo (columnas con `summary`). */
+    readonly groupSubtotals: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Moneda de las columnas `currency` (si no, la de `provideCaribeNG({ currency })`). */
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    /** Negativos con signo o entre paréntesis (si no, el de `provideCaribeNG({ negativeStyle })`). */
+    readonly negativeStyle: _angular_core.InputSignal<CbNegativeStyle | undefined>;
     readonly selection: _angular_core.ModelSignal<unknown>;
     readonly sortChange: _angular_core.OutputEmitterRef<{
         field: string | null;
@@ -188,6 +216,21 @@ declare class CbTable {
     /** Filas por grupo en todos los datos (no solo en la página). */
     private readonly groupCounts;
     protected readonly pageRows: _angular_core.Signal<readonly unknown[]>;
+    private readonly config;
+    protected readonly hasSummary: _angular_core.Signal<boolean>;
+    protected readonly hasFooterText: _angular_core.Signal<boolean>;
+    protected readonly hasFooter: _angular_core.Signal<boolean>;
+    /** Columna donde va la etiqueta "Total" / "Subtotal": la primera sin total. */
+    protected readonly labelColumn: _angular_core.Signal<number>;
+    /**
+     * Columnas que ocupa la etiqueta: desde la suya hasta la siguiente con total
+     * (sin partir columnas fijas de no fijas).
+     */
+    protected readonly labelSpan: _angular_core.Signal<number>;
+    /** Totales del pie, sobre todas las filas filtradas (no solo la página). */
+    protected readonly totals: _angular_core.Signal<Record<string, unknown>>;
+    /** Totales por grupo (con `groupSubtotals`). */
+    private readonly groupTotals;
     protected readonly colspan: _angular_core.Signal<number>;
     private readonly selectedCount;
     protected readonly allSelected: _angular_core.Signal<boolean>;
@@ -224,11 +267,22 @@ declare class CbTable {
     protected onPageChange(state: CbPaginatorState): void;
     protected groupOf(row: unknown): unknown;
     protected groupCount(row: unknown): number;
+    /** La fila cierra grupo si es la última de la página o el siguiente cambia de grupo. */
+    protected isGroupEnd(index: number): boolean;
+    protected groupSummary(row: unknown, col: CbTableColumn): unknown;
     /** 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;
+    /**
+     * Hoja de Excel con las columnas visibles (salvo `exportable: false`) y todas las
+     * filas filtradas y ordenadas: importes como números con su formato, subtotales
+     * de grupo y totales en negrita.
+     */
+    toExcelSheet(options?: CbExcelExportOptions & CbTableCsvOptions): CbXlsxSheet;
+    /** Descarga las filas en Excel (`nombre.xlsx`) con formatos de número, subtotales y totales. */
+    exportExcel(filename?: string, options?: CbExcelExportOptions & CbTableCsvOptions): void;
     /**
      * 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`.
@@ -236,6 +290,16 @@ declare class CbTable {
     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;
+    /** Totales de las columnas con `summary` sobre unas filas. */
+    private summarize;
+    protected isNumeric(col: CbTableColumn): boolean;
+    protected alignOf(col: CbTableColumn): string | null;
+    protected isNegative(value: unknown, col: CbTableColumn): boolean;
+    /** Texto de una celda: `format`, o el formato de su `type`. */
+    protected display(value: unknown, col: CbTableColumn, row: unknown): unknown;
+    /** Texto de un total: con el formato de la columna (una cuenta, como número entero). */
+    protected summaryText(value: unknown, col: CbTableColumn): string;
+    private formatNumber;
     protected cellValue(row: unknown, col: CbTableColumn): unknown;
     protected cellTemplate(field: string): CbTableCellDirective | undefined;
     protected cellContext(row: unknown, col: CbTableColumn): CbTableCellContext;
@@ -245,7 +309,7 @@ declare class CbTable {
     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; }; "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>;
+    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; }; "groupSubtotals": { "alias": "groupSubtotals"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "negativeStyle": { "alias": "negativeStyle"; "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, CbTableGroupHeader, CbTableRowExpansion };

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

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

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 
 /**
- * Tag-button de Caribe Design: píldora pulsable usada como filtro o chip de
+ * Tag-button: píldora pulsable usada como filtro o chip de
  * acción. Alterna su estado seleccionado y emite el cambio.
  *
  * @example
@@ -24,4 +24,4 @@ declare class CbTagButton {
 }
 
 export { CbTagButton };
-//# sourceMappingURL=caribeng-ui-caribe-tag-button.d.ts.map
+//# sourceMappingURL=caribeng-ui-tag-button.d.ts.map

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

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

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

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 
 /**
- * Tracker de Caribe Design: indicador de progreso por pasos (stepper) con
+ * Tracker: indicador de progreso por pasos (stepper) con
  * marcadores completados, activo y pendientes conectados por líneas.
  *
  * @example
@@ -22,4 +22,4 @@ declare class CbTracker {
 }
 
 export { CbTracker };
-//# sourceMappingURL=caribeng-ui-caribe-tracker.d.ts.map
+//# sourceMappingURL=caribeng-ui-tracker.d.ts.map

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 
 /**
- * Transaction-status de Caribe Design: indicador del resultado de una
+ * Transaction-status: indicador del resultado de una
  * transacción (éxito, advertencia, error, info).
  *
  * @example
@@ -18,4 +18,4 @@ declare class CbTransactionStatus {
 }
 
 export { CbTransactionStatus };
-//# sourceMappingURL=caribeng-ui-caribe-transaction-status.d.ts.map
+//# sourceMappingURL=caribeng-ui-transaction-status.d.ts.map

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

@@ -1,6 +1,7 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 import { cbFormat } from '@caribeng/ui';
+import { ConnectedPosition } from '@angular/cdk/overlay';
 import { ControlValueAccessor } from '@angular/forms';
 
 interface CbTreeSelectNode {
@@ -44,6 +45,11 @@ declare class CbTreeSelect implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     private readonly trigger;
+    private readonly host;
+    protected readonly triggerWidth: _angular_core.WritableSignal<number>;
+    protected readonly positions: ConnectedPosition[];
+    /** Un clic fuera del panel lo cierra (el del disparador ya lo alterna). */
+    protected onOutsideClick(event: MouseEvent): void;
     /** Escape cierra el panel y devuelve el foco al disparador. */
     protected closeOnEscape(event: Event): void;
     toggleOpen(): void;

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

@@ -1,11 +1,30 @@
 import * as _caribeng_ui from '@caribeng/ui';
-import { cbFormat } from '@caribeng/ui';
+import { cbFormat, CbNegativeStyle, CbSummary } from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
 import { TemplateRef } from '@angular/core';
+import { CbExcelExportOptions, CbXlsxSheet } from '@caribeng/ui/xlsx';
 
 interface CbTreeTableColumn {
     field: string;
     header: string;
+    /** Formato: `number`, `currency` o `percent` (alineados a la derecha, negativos en rojo). */
+    type?: 'text' | 'number' | 'currency' | 'percent';
+    /** Moneda de una columna `currency` (si no, la de la tabla o `provideCaribeNG({ currency })`). */
+    currency?: string;
+    decimals?: number;
+    negative?: CbNegativeStyle;
+    align?: 'left' | 'center' | 'right';
+    width?: string;
+    /** Texto propio de la celda. */
+    format?: (value: unknown, node: CbTreeTableNode | null) => string;
+    /**
+     * Total de la columna: en el pie (sobre las hojas) y, con `rollup`, en cada fila
+     * padre (sobre sus descendientes). `sum`, `avg`, `count`, `min`, `max` o una
+     * función con los datos de las hojas.
+     */
+    summary?: CbSummary | ((leaves: readonly Record<string, unknown>[]) => unknown);
+    /** Texto fijo en el pie de esta columna. */
+    footer?: string;
 }
 interface CbTreeTableNode {
     /** Identificador único en toda la tabla. */
@@ -55,18 +74,54 @@ declare class CbTreeTable {
     readonly columns: _angular_core.InputSignal<readonly CbTreeTableColumn[]>;
     /** Nombre accesible de la tabla. */
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    /**
+     * Las filas padre muestran, en las columnas con `summary`, el total de sus
+     * descendientes (p. ej. el saldo de una cuenta mayor a partir de sus auxiliares).
+     */
+    readonly rollup: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Moneda de las columnas `currency` (si no, la de `provideCaribeNG({ currency })`). */
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    /** Muestra el pie con los totales de las columnas con `summary`. */
+    readonly showFooter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Clases CSS extra por fila (p. ej. para filas de total). */
+    readonly rowClass: _angular_core.InputSignal<((node: CbTreeTableNode) => string | null) | null>;
+    /** Las filas sin hijos se activan con clic o Enter (`nodeActivate`), p. ej. para ver sus movimientos. */
+    readonly activateLeaves: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Negativos con signo o entre paréntesis (si no, el de `provideCaribeNG({ negativeStyle })`). */
+    readonly negativeStyle: _angular_core.InputSignal<CbNegativeStyle | undefined>;
     /** Se emite al expandir una fila. */
     readonly nodeExpand: _angular_core.OutputEmitterRef<CbTreeTableNode>;
     /** Se emite al contraer una fila. */
     readonly nodeCollapse: _angular_core.OutputEmitterRef<CbTreeTableNode>;
+    /** Con `activateLeaves`: clic o Enter sobre una fila sin hijos. */
+    readonly nodeActivate: _angular_core.OutputEmitterRef<CbTreeTableNode>;
     private readonly cellTemplates;
     protected readonly expanded: _angular_core.WritableSignal<ReadonlySet<string>>;
     protected readonly activeKey: _angular_core.WritableSignal<string | null>;
     protected readonly tabbableKey: _angular_core.Signal<string>;
     /** Filas visibles: las de las ramas expandidas, en orden. */
     protected readonly rows: _angular_core.Signal<Row[]>;
+    private readonly config;
+    protected readonly hasFooterText: _angular_core.Signal<boolean>;
+    protected readonly hasFooter: _angular_core.Signal<boolean>;
+    /** Columna de la etiqueta "Total": la primera sin total. */
+    protected readonly labelColumn: _angular_core.Signal<number>;
+    /** Totales de cada nodo con hijos (sobre sus hojas), por columna con `summary`. */
+    private readonly aggregates;
+    /** Totales del pie (sobre todas las hojas). */
+    protected readonly totals: _angular_core.Signal<Record<string, unknown>>;
+    /**
+     * Hoja de Excel con todas las filas (también las contraídas) agrupadas por
+     * nivel con el esquema de Excel, sangría en la primera columna, filas padre en
+     * negrita (con sus totales si hay `rollup`) y el total al final.
+     */
+    toExcelSheet(options?: CbExcelExportOptions): CbXlsxSheet;
+    /** Descarga el árbol en Excel (`nombre.xlsx`), con los niveles plegables. */
+    exportExcel(filename?: string, options?: CbExcelExportOptions): void;
     /** Expande todas las filas. */
     expandAll(): void;
+    /** Expande las filas hasta el nivel `level` (1 = solo las raíces visibles) y contrae el resto. */
+    expandToLevel(level: number): void;
     /** Contrae todas las filas. */
     collapseAll(): void;
     protected hasChildren(node: CbTreeTableNode): boolean;
@@ -74,12 +129,22 @@ declare class CbTreeTable {
     protected rowId(node: CbTreeTableNode): string;
     /** Texto de la primera columna, para las etiquetas accesibles. */
     protected label(node: CbTreeTableNode): string;
+    /** Valor de una celda: el total de sus descendientes en las filas padre con `rollup`. */
+    protected valueOf(node: CbTreeTableNode, col: CbTreeTableColumn): unknown;
+    protected isNumeric(col: CbTreeTableColumn): boolean;
+    protected alignOf(col: CbTreeTableColumn): string | null;
+    protected isNegative(value: unknown, col: CbTreeTableColumn): boolean;
+    protected display(value: unknown, col: CbTreeTableColumn, node: CbTreeTableNode | null): unknown;
+    protected summaryText(value: unknown, col: CbTreeTableColumn): string;
+    private summarize;
+    private formatNumber;
     protected cellTemplate(field: string): TemplateRef<CbTreeTableCellContext> | null;
+    protected onRowClick(node: CbTreeTableNode): void;
     protected toggle(node: CbTreeTableNode): void;
     protected onKeydown(event: KeyboardEvent): void;
     private setExpanded;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbTreeTable, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTreeTable, "cb-treetable", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "nodeExpand": "nodeExpand"; "nodeCollapse": "nodeCollapse"; }, ["cellTemplates"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbTreeTable, "cb-treetable", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "rollup": { "alias": "rollup"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "showFooter": { "alias": "showFooter"; "required": false; "isSignal": true; }; "rowClass": { "alias": "rowClass"; "required": false; "isSignal": true; }; "activateLeaves": { "alias": "activateLeaves"; "required": false; "isSignal": true; }; "negativeStyle": { "alias": "negativeStyle"; "required": false; "isSignal": true; }; }, { "nodeExpand": "nodeExpand"; "nodeCollapse": "nodeCollapse"; "nodeActivate": "nodeActivate"; }, ["cellTemplates"], never, true, never>;
 }
 
 export { CbTreeTable, CbTreeTableCellTemplate };

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

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 
 /**
- * Voucher de Caribe Design: comprobante de operación con filas clave/valor y
+ * Voucher: comprobante de operación con filas clave/valor y
  * una acción para compartir.
  *
  * @example
@@ -25,4 +25,4 @@ declare class CbVoucher {
 }
 
 export { CbVoucher };
-//# sourceMappingURL=caribeng-ui-caribe-voucher.d.ts.map
+//# sourceMappingURL=caribeng-ui-voucher.d.ts.map

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

@@ -0,0 +1,79 @@
+/** Tipo de dato (y formato) de una columna de Excel. */
+type CbXlsxType = 'text' | 'number' | 'integer' | 'currency' | 'percent' | 'date';
+/** Columna de una hoja. */
+interface CbXlsxColumn {
+    readonly header: string;
+    readonly type?: CbXlsxType;
+    /** Ancho en caracteres (si no, se calcula con el contenido). */
+    readonly width?: number;
+    /** Decimales de `number`, `currency` y `percent` (2 por defecto). */
+    readonly decimals?: number;
+    /** Símbolo de moneda de `currency` (`$` por defecto). */
+    readonly symbol?: string;
+    /** Negativos con signo o entre paréntesis; siempre en rojo. */
+    readonly negative?: 'minus' | 'parens';
+}
+/** Fila con opciones. */
+interface CbXlsxRow {
+    readonly cells: readonly unknown[];
+    /** Nivel de agrupación (esquema de Excel, de 0 a 7): las filas se pliegan bajo su padre. */
+    readonly level?: number;
+    /** Fila en negrita (totales, cuentas mayores). */
+    readonly bold?: boolean;
+    /** Sangría de la primera celda (niveles de un árbol). */
+    readonly indent?: number;
+}
+/** Hoja del libro. */
+interface CbXlsxSheet {
+    /** Nombre de la pestaña (máx. 31 caracteres; se quitan `\ / ? * [ ] :`). */
+    readonly name: string;
+    readonly columns: readonly CbXlsxColumn[];
+    readonly rows: readonly (readonly unknown[] | CbXlsxRow)[];
+    /** Líneas de título sobre el encabezado (empresa, informe, periodo). */
+    readonly title?: readonly string[];
+    /** Fila de totales al final, en negrita. */
+    readonly totals?: readonly unknown[];
+    /** Deja fijo el encabezado al desplazarse (por defecto `true`). */
+    readonly freeze?: boolean;
+    /** Filtros en el encabezado (por defecto `true`). */
+    readonly autoFilter?: boolean;
+}
+/** Opciones de `exportExcel()` de Table, TreeTable y Data Grid. */
+interface CbExcelExportOptions {
+    /** Líneas de título sobre el encabezado (empresa, informe, periodo). */
+    readonly title?: readonly string[];
+    /** Nombre de la pestaña. */
+    readonly sheetName?: string;
+}
+/** Símbolo corto de una moneda (`COP` → `$`, `EUR` → `€`). */
+declare function currencySymbol(code: string, locale?: string): string;
+/** Letra(s) de columna: 0 → A, 26 → AA. */
+declare function columnName(index: number): string;
+/** Fecha a número de serie de Excel (días desde el 30/12/1899, hora local). */
+declare function excelDate(date: Date): number;
+/** Código de formato numérico de Excel para una columna. */
+declare function numberFormat(col: CbXlsxColumn): string | null;
+/** Bytes del libro .xlsx con una o varias hojas. */
+declare function cbXlsxBytes(sheets: CbXlsxSheet | readonly CbXlsxSheet[]): Uint8Array;
+/** Libro .xlsx como `Blob`. */
+declare function cbXlsx(sheets: CbXlsxSheet | readonly CbXlsxSheet[]): Blob;
+/** Descarga el libro (`nombre.xlsx`). */
+declare function cbDownloadXlsx(filename: string, sheets: CbXlsxSheet | readonly CbXlsxSheet[]): void;
+
+/** Hoja leída de un .xlsx: su nombre y las celdas como texto o número. */
+interface CbXlsxReadSheet {
+    readonly name: string;
+    readonly rows: (string | number | boolean | null)[][];
+}
+/**
+ * Lee un libro .xlsx (Excel, LibreOffice, Google Sheets) en el navegador: todas
+ * las hojas con sus celdas como texto, número o booleano. Las fechas quedan
+ * como número de serie de Excel (ver `excelSerialToDate`).
+ */
+declare function cbReadXlsx(input: Blob | ArrayBuffer | Uint8Array): Promise<CbXlsxReadSheet[]>;
+/** Número de serie de Excel a fecha local. */
+declare function excelSerialToDate(serial: number): Date;
+
+export { cbDownloadXlsx, cbReadXlsx, cbXlsx, cbXlsxBytes, columnName, currencySymbol, excelDate, excelSerialToDate, numberFormat };
+export type { CbExcelExportOptions, CbXlsxColumn, CbXlsxReadSheet, CbXlsxRow, CbXlsxSheet, CbXlsxType };
+//# sourceMappingURL=caribeng-ui-xlsx.d.ts.map