@caribeng/ui 22.4.0 → 22.5.0

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