@caribeng/ui 22.2.0 → 22.5.0

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

@@ -0,0 +1,269 @@
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbNegativeStyle, CbSummary, cbFormat } from '@caribeng/ui';
+import * as _angular_core from '@angular/core';
+import { ConnectedPosition } from '@angular/cdk/overlay';
+import { CbExcelExportOptions, CbXlsxSheet } from '@caribeng/ui/xlsx';
+
+/** Tipo de dato (y de editor) de una columna del Data Grid. */
+type CbDataGridColumnType = 'text' | 'number' | 'select' | 'autocomplete' | 'date' | 'checkbox';
+/** Opción de una columna `select` o `autocomplete`. */
+interface CbDataGridOption {
+    readonly label: string;
+    readonly value: unknown;
+    /** Texto secundario en la lista de `autocomplete` (p. ej. la ruta de una cuenta). */
+    readonly description?: string;
+    /** Se ve en la lista pero no se puede elegir. */
+    readonly disabled?: boolean;
+}
+/** Fila del Data Grid: un objeto con los campos de las columnas. */
+type CbDataGridRow = Record<string, unknown>;
+/** Columna del Data Grid. */
+interface CbDataGridColumn<T extends object = CbDataGridRow> {
+    /** Campo de la fila que muestra y edita. */
+    readonly field: string;
+    readonly header: string;
+    /** `text` por defecto. */
+    readonly type?: CbDataGridColumnType;
+    /** Ancho CSS (`8rem` por defecto; `checkbox`, `5rem`). */
+    readonly width?: string;
+    /** `false` la deja de solo lectura aunque el grid sea editable. */
+    readonly editable?: boolean;
+    /** No admite celdas vacías. */
+    readonly required?: boolean;
+    /** Opciones de una columna `select` o `autocomplete` (en esta se buscan escribiendo). */
+    readonly options?: readonly CbDataGridOption[];
+    /**
+     * Al editar (escribir, pegar, borrar o rellenar) esta celda, otros campos de la
+     * fila que cambian con ella, en el mismo paso de deshacer. P. ej., en un
+     * comprobante, escribir el débito borra el crédito: `onEdit: (v) => (v ? { credito: null } : null)`.
+     */
+    readonly onEdit?: (value: unknown, row: T) => Partial<T> | null;
+    /** Límites de una columna `number`. */
+    readonly min?: number;
+    readonly max?: number;
+    /** Decimales que se muestran en una columna `number`. */
+    readonly decimals?: number;
+    /**
+     * Importe en moneda (columna `number`): un código ISO 4217 (`COP`) o `true` para la
+     * moneda del grid / `provideCaribeNG({ currency })`.
+     */
+    readonly currency?: string | boolean;
+    /** Negativos con signo o entre paréntesis (si no, el del grid). */
+    readonly negative?: CbNegativeStyle;
+    /** Total en el pie: `sum`, `avg`, `count`, `min`, `max` o una función con las filas. */
+    readonly summary?: CbSummary | ((rows: readonly T[]) => unknown);
+    /** Texto fijo en el pie de esta columna (p. ej. "Total"). */
+    readonly footer?: string;
+    /** `false` quita la ordenación por esta columna. */
+    readonly sortable?: boolean;
+    readonly align?: 'start' | 'center' | 'end';
+    /** Validación propia: devuelve el mensaje de error o `null`. */
+    readonly validate?: (value: unknown, row: T) => string | null;
+    /** Texto que se muestra en la celda (no cambia el valor). */
+    readonly format?: (value: unknown, row: T) => string;
+}
+/** Cambio de una celda (`cellChange`). */
+interface CbDataGridCellChange<T extends object = CbDataGridRow> {
+    readonly row: T;
+    readonly field: string;
+    readonly value: unknown;
+    readonly previous: unknown;
+}
+/** Error de validación de una celda. */
+interface CbDataGridError {
+    /** Clave de la fila (`dataKey`). */
+    readonly key: unknown;
+    readonly field: string;
+    readonly message: string;
+}
+/** Celda en coordenadas de la vista (fila visible, columna). */
+interface CellPos {
+    readonly r: number;
+    readonly c: number;
+}
+/** Rango rectangular normalizado. */
+interface CellRange {
+    readonly r1: number;
+    readonly r2: number;
+    readonly c1: number;
+    readonly c2: number;
+}
+
+interface Editing {
+    readonly r: number;
+    readonly c: number;
+    readonly text: string;
+    /** `native`: editor propio del tipo (fecha, lista); `text`: se empezó escribiendo. */
+    readonly mode: 'native' | 'text';
+    readonly error: string | null;
+    /** `autocomplete`: opción resaltada en la lista. */
+    readonly active: number;
+}
+/**
+ * Data Grid editable de CaribeNG: una tabla que se edita como una hoja de cálculo.
+ *
+ * - Celdas con tipo (texto, número, lista, fecha, casilla), validación por columna
+ *   (`required`, `min`, `max`, `validate`) y marca de las celdas cambiadas.
+ * - Teclado de hoja de cálculo: flechas, Mayús + flechas para seleccionar, Enter o
+ *   F2 para editar, escribir para reemplazar, Supr para borrar, Ctrl + Z / Y,
+ *   Ctrl + D para rellenar hacia abajo.
+ * - Copiar, cortar y pegar rangos en el formato de Excel y Google Sheets (TSV).
+ * - Añadir y eliminar filas, ordenar por columna y deshacer cualquier cambio.
+ *
+ * @example
+ * ```html
+ * <cb-data-grid [(rows)]="filas" [columns]="columnas" dataKey="id" (cellChange)="guardar($event)" />
+ * ```
+ */
+declare class CbDataGrid<T extends object = CbDataGridRow> {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly injector;
+    private readonly host;
+    protected readonly uid: string;
+    /** Filas (bidireccional: se actualiza con cada edición, pegado, alta o baja). */
+    readonly rows: _angular_core.ModelSignal<readonly T[]>;
+    readonly columns: _angular_core.InputSignal<readonly CbDataGridColumn<T>[]>;
+    /** Campo que identifica cada fila. */
+    readonly dataKey: _angular_core.InputSignal<string>;
+    /** `false` deja todo el grid de solo lectura (se sigue navegando, seleccionando y copiando). */
+    readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Columna con el número de fila (y para seleccionar filas enteras). */
+    readonly rowNumbers: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Barra con Añadir fila, Eliminar, Deshacer, Rehacer y el resumen de errores. */
+    readonly toolbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Alto máximo del área con scroll (la cabecera y los números de fila quedan fijos). */
+    readonly scrollHeight: _angular_core.InputSignal<string | null>;
+    /** Crea la fila nueva al añadir o al pegar más filas de las que hay. */
+    readonly newRow: _angular_core.InputSignal<(() => T) | null>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Moneda de las columnas con `currency: true` (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>;
+    /** Una celda cambió de valor (al editar, pegar, borrar o rellenar; una vez por celda). */
+    readonly cellChange: _angular_core.OutputEmitterRef<CbDataGridCellChange<T>>;
+    readonly rowAdd: _angular_core.OutputEmitterRef<T>;
+    readonly rowsDelete: _angular_core.OutputEmitterRef<T[]>;
+    protected readonly sort: _angular_core.WritableSignal<{
+        field: string;
+        order: 1 | -1;
+    } | null>;
+    protected readonly active: _angular_core.WritableSignal<CellPos>;
+    private readonly anchor;
+    protected readonly editing: _angular_core.WritableSignal<Editing | null>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    protected dragging: boolean;
+    private readonly undoStack;
+    private readonly redoStack;
+    protected readonly canUndo: _angular_core.Signal<boolean>;
+    protected readonly canRedo: _angular_core.Signal<boolean>;
+    /** Filas tal como estaban al cargar o en el último `markClean()`. */
+    private readonly baseline;
+    protected readonly range: _angular_core.Signal<CellRange>;
+    protected readonly selectedRowCount: _angular_core.Signal<number>;
+    /** Filas en el orden en que se ven. */
+    protected readonly view: _angular_core.Signal<readonly T[]>;
+    private readonly texts;
+    /** Errores de validación de todas las celdas, en el orden de la vista. */
+    readonly errors: _angular_core.Signal<CbDataGridError[]>;
+    private readonly errorIndex;
+    /** Celdas cambiadas desde la carga (o el último `markClean()`), contando las filas nuevas. */
+    protected readonly dirtyCount: _angular_core.Signal<number>;
+    private readonly config;
+    private readonly amount;
+    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 del pie (columnas con `summary`), sobre todas las filas. */
+    readonly totals: _angular_core.Signal<Record<string, unknown>>;
+    protected readonly tableWidth: _angular_core.Signal<string>;
+    constructor();
+    /** Toma las filas actuales como estado original: borra las marcas de cambio. */
+    markClean(): void;
+    /** Filas añadidas, modificadas y eliminadas desde la carga o el último `markClean()`. */
+    getChanges(): {
+        added: T[];
+        updated: T[];
+        removed: T[];
+    };
+    /**
+     * Hoja de Excel con las filas en el orden en que se ven: números y fechas como
+     * valores con formato, listas con su etiqueta, casillas como Sí / No y totales.
+     */
+    toExcelSheet(options?: CbExcelExportOptions): CbXlsxSheet;
+    /** Descarga las filas en Excel (`nombre.xlsx`). */
+    exportExcel(filename?: string, options?: CbExcelExportOptions): void;
+    /** `true` si ninguna celda tiene errores de validación. */
+    isValid(): boolean;
+    undo(): void;
+    redo(): void;
+    /** Añade una fila al final y lleva el foco a su primera celda. */
+    addRow(): void;
+    /** Elimina las filas de la selección. */
+    deleteRows(): void;
+    protected keyOf(row: T): unknown;
+    protected get(row: T, field: string): unknown;
+    protected cellId(r: number, c: number): string;
+    protected widthOf(col: CbDataGridColumn<T>): string;
+    protected alignOf(col: CbDataGridColumn<T>): string;
+    protected canEdit(col: CbDataGridColumn<T>): boolean;
+    protected isSelected(r: number, c: number): boolean;
+    protected text(row: T, col: CbDataGridColumn<T>): string;
+    protected isNegative(value: unknown, col: CbDataGridColumn<T>): boolean;
+    protected totalText(col: CbDataGridColumn<T>): string;
+    protected errorOf(row: T, col: CbDataGridColumn<T>): string | null;
+    protected isNew(row: T): boolean;
+    protected isDirty(row: T, col: CbDataGridColumn<T>): boolean;
+    protected readonly listPositions: ConnectedPosition[];
+    /** Opciones de `autocomplete` que coinciden con lo escrito en el editor. */
+    protected readonly matches: _angular_core.Signal<CbDataGridOption[]>;
+    protected setActive(i: number): void;
+    /** Elige una opción de `autocomplete` con el ratón. */
+    protected pick(option: CbDataGridOption): void;
+    protected editorKind(col: CbDataGridColumn<T>): 'select' | 'autocomplete' | 'date' | 'text';
+    protected toggleSort(col: CbDataGridColumn<T>): void;
+    protected selectAll(): void;
+    protected selectRow(r: number, event: PointerEvent): void;
+    protected goToFirstError(): void;
+    protected onCellPointerDown(event: PointerEvent, r: number, c: number): void;
+    protected onCellPointerEnter(r: number, c: number): void;
+    protected toggleCheck(r: number, c: number): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onEditorKeydown(event: KeyboardEvent): void;
+    protected editText(event: Event): void;
+    /** Primera opción elegible de `autocomplete` para un texto. */
+    private firstEnabled;
+    /** Abre el editor de una celda (con `initial`, reemplaza el valor por ese texto). */
+    protected startEdit(r: number, c: number, initial?: string, mode?: 'native' | 'text'): void;
+    /** Confirma la edición en curso y, si se indica, se mueve a la celda vecina. */
+    protected commit(move: 'up' | 'down' | 'left' | 'right' | null): void;
+    private cancelEdit;
+    /** Borra los valores del rango seleccionado. */
+    private clearRange;
+    /** Ctrl + D: copia la primera fila del rango en las demás (o la de arriba si es una sola fila). */
+    private fillDown;
+    protected onCopy(event: ClipboardEvent, cut: boolean): void;
+    protected onPaste(event: ClipboardEvent): void;
+    /** Pega una matriz de textos desde la esquina del rango (un único valor rellena todo el rango). */
+    private paste;
+    private forRange;
+    /** Aplica cambios de celdas como un único paso de deshacer. */
+    private apply;
+    private pushHistory;
+    private createRow;
+    /** Mueve la celda activa (y la selección a esa sola celda). */
+    private select;
+    private focusActive;
+    private localNumber;
+    private say;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbDataGrid<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDataGrid<any>, "cb-data-grid", never, { "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "rowNumbers": { "alias": "rowNumbers"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "scrollHeight": { "alias": "scrollHeight"; "required": false; "isSignal": true; }; "newRow": { "alias": "newRow"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "negativeStyle": { "alias": "negativeStyle"; "required": false; "isSignal": true; }; }, { "rows": "rowsChange"; "cellChange": "cellChange"; "rowAdd": "rowAdd"; "rowsDelete": "rowsDelete"; }, never, never, true, never>;
+}
+
+export { CbDataGrid };
+export type { CbDataGridCellChange, CbDataGridColumn, CbDataGridColumnType, CbDataGridError, CbDataGridOption, CbDataGridRow };
+//# sourceMappingURL=caribeng-ui-datagrid.d.ts.map

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

@@ -1,6 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { TemplateRef } from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 /** Elemento con la forma de la presentación por defecto (título, categoría y descripción). */
 interface CbDataViewItem {
@@ -46,6 +47,7 @@ declare class CbDataViewHeader {
  */
 declare class CbDataView {
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
     /** Colección a mostrar. */
     readonly value: _angular_core.InputSignal<readonly unknown[]>;
     /** Vista: cuadrícula o lista (two-way). */

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

@@ -8,15 +8,27 @@ interface CbDockItem {
     url?: string;
     disabled?: boolean;
 }
-/** Compact application launcher with configurable orientation. */
+/**
+ * Compact application launcher with configurable orientation.
+ *
+ * Sigue el patrón WAI-ARIA *toolbar*: un solo elemento entra en el orden de
+ * tabulación y las flechas (según la orientación), Inicio y Fin recorren el resto.
+ */
 declare class CbDock {
+    private readonly host;
     /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly items: _angular_core.InputSignal<readonly CbDockItem[]>;
     readonly position: _angular_core.InputSignal<CbDockPosition>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbDockItem>;
+    protected readonly vertical: _angular_core.Signal<boolean>;
+    /** Último elemento enfocado (el que recibe Tab al volver). */
+    protected readonly active: _angular_core.WritableSignal<number>;
+    /** Elemento con `tabindex="0"`: el activo si se puede enfocar, si no el primero habilitado. */
+    protected readonly tabStop: _angular_core.Signal<number>;
     select(item: CbDockItem): void;
+    protected onKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbDock, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDock, "cb-dock", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; }, never, never, true, never>;
 }

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

@@ -0,0 +1,138 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Empresa que emite el documento. */
+interface CbDocumentIssuer {
+    readonly name: string;
+    /** NIT u otra identificación. */
+    readonly taxId?: string;
+    readonly address?: string;
+    readonly phone?: string;
+    readonly email?: string;
+    /** URL del logo. */
+    readonly logo?: string;
+}
+/** Tercero del documento (cliente, proveedor, beneficiario). */
+interface CbDocumentParty {
+    /** Rótulo («Cliente», «Pagado a»). */
+    readonly label?: string;
+    readonly name: string;
+    readonly taxId?: string;
+    readonly address?: string;
+    readonly phone?: string;
+    readonly email?: string;
+}
+/** Línea del documento. */
+interface CbDocumentLine {
+    readonly description: string;
+    readonly code?: string;
+    readonly quantity: number;
+    readonly unitPrice: number;
+    /** Descuento (0–1). */
+    readonly discount?: number;
+    /** Impuesto (0–1, p. ej. 0.19 para IVA del 19 %). */
+    readonly tax?: number;
+}
+/** Ajuste después de impuestos (retenciones con importe negativo, cargos con positivo). */
+interface CbDocumentAdjustment {
+    readonly label: string;
+    readonly amount: number;
+}
+/** Dato suelto de la cabecera (vencimiento, forma de pago, orden de compra…). */
+interface CbDocumentField {
+    readonly label: string;
+    readonly value: string;
+}
+/** Totales de un documento a partir de sus líneas. */
+declare function documentTotals(lines: readonly CbDocumentLine[], adjustments?: readonly CbDocumentAdjustment[]): {
+    subtotal: number;
+    discount: number;
+    net: number;
+    taxes: {
+        rate: number;
+        base: number;
+        amount: number;
+    }[];
+    taxTotal: number;
+    adjustments: readonly CbDocumentAdjustment[];
+    total: number;
+};
+/**
+ * Documento imprimible de CaribeNG: factura, cotización, comprobante o recibo con
+ * cabecera de la empresa, tercero, líneas, impuestos, retenciones, total en letras,
+ * notas y firmas.
+ *
+ * - Calcula subtotales, descuentos, impuestos por tarifa y ajustes (retenciones).
+ * - `print()` imprime solo el documento (o lo guarda en PDF) con sus estilos.
+ *
+ * @example
+ * ```html
+ * <cb-document #doc title="Factura de venta" number="FV-1252" [issuer]="empresa" [party]="cliente" [lines]="items" />
+ * <button (click)="doc.print()">Imprimir</button>
+ * ```
+ */
+declare class CbDocument {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly config;
+    private readonly sheet;
+    /** Título («Factura electrónica de venta», «Comprobante de egreso»). */
+    readonly title: _angular_core.InputSignal<string>;
+    readonly number: _angular_core.InputSignal<string>;
+    readonly date: _angular_core.InputSignal<Date | null>;
+    readonly issuer: _angular_core.InputSignal<CbDocumentIssuer>;
+    readonly party: _angular_core.InputSignal<CbDocumentParty | null>;
+    /** Datos sueltos de la cabecera (vencimiento, forma de pago…). */
+    readonly fields: _angular_core.InputSignal<readonly CbDocumentField[]>;
+    readonly lines: _angular_core.InputSignal<readonly CbDocumentLine[]>;
+    /** Retenciones (negativas) u otros cargos después de impuestos. */
+    readonly adjustments: _angular_core.InputSignal<readonly CbDocumentAdjustment[]>;
+    /** Nombre del impuesto en los totales («IVA»). */
+    readonly taxLabel: _angular_core.InputSignal<string>;
+    /** Muestra el total en letras. */
+    readonly words: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly notes: _angular_core.InputSignal<string>;
+    /** Rótulos de las firmas («Elaboró», «Aprobó», «Recibí conforme»). */
+    readonly signatures: _angular_core.InputSignal<readonly string[]>;
+    readonly footer: _angular_core.InputSignal<string>;
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    /** Subtotal, descuentos, impuestos por tarifa, ajustes y total. */
+    readonly totals: _angular_core.Signal<{
+        subtotal: number;
+        discount: number;
+        net: number;
+        taxes: {
+            rate: number;
+            base: number;
+            amount: number;
+        }[];
+        taxTotal: number;
+        adjustments: readonly CbDocumentAdjustment[];
+        total: number;
+    }>;
+    protected readonly hasCodes: _angular_core.Signal<boolean>;
+    protected readonly hasDiscounts: _angular_core.Signal<boolean>;
+    protected readonly hasTaxes: _angular_core.Signal<boolean>;
+    private readonly locale;
+    private readonly code;
+    protected join(...parts: (string | undefined)[]): string;
+    protected money(v: number): string;
+    protected qty(v: number): string;
+    protected pct(v: number): string;
+    protected longDate(d: Date): string;
+    protected readonly inWords: _angular_core.Signal<string>;
+    /** Imprime solo el documento (o lo guarda como PDF desde el diálogo de impresión). */
+    print(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbDocument, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDocument, "cb-document", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "number": { "alias": "number"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": false; "isSignal": true; }; "issuer": { "alias": "issuer"; "required": false; "isSignal": true; }; "party": { "alias": "party"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "lines": { "alias": "lines"; "required": false; "isSignal": true; }; "adjustments": { "alias": "adjustments"; "required": false; "isSignal": true; }; "taxLabel": { "alias": "taxLabel"; "required": false; "isSignal": true; }; "words": { "alias": "words"; "required": false; "isSignal": true; }; "notes": { "alias": "notes"; "required": false; "isSignal": true; }; "signatures": { "alias": "signatures"; "required": false; "isSignal": true; }; "footer": { "alias": "footer"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Imprime solo un elemento de la página, con sus estilos, en un marco oculto: la
+ * página no cambia y el diálogo de impresión (o «Guardar como PDF») muestra
+ * únicamente ese elemento.
+ */
+declare function cbPrintElement(element: HTMLElement, title?: string): void;
+
+export { CbDocument, cbPrintElement, documentTotals };
+export type { CbDocumentAdjustment, CbDocumentField, CbDocumentIssuer, CbDocumentLine, CbDocumentParty };
+//# sourceMappingURL=caribeng-ui-document.d.ts.map

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

@@ -3,7 +3,7 @@ import * as _caribeng_ui from '@caribeng/ui';
 import { cbFormat } from '@caribeng/ui';
 
 /**
- * Dots-indicator de Caribe Design: indicador de paginación por puntos. El punto
+ * Dots-indicator: indicador de paginación por puntos. El punto
  * activo se alarga; cada punto es navegable.
  *
  * @example
@@ -29,4 +29,4 @@ declare class CbDotsIndicator {
 }
 
 export { CbDotsIndicator };
-//# sourceMappingURL=caribeng-ui-caribe-dots-indicator.d.ts.map
+//# sourceMappingURL=caribeng-ui-dots-indicator.d.ts.map

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

@@ -27,6 +27,8 @@ declare class CbDrawer {
     readonly dismissableMask: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly closeOnEscape: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Ancho (izquierda/derecha) o alto (arriba/abajo) del panel, p. ej. `'32rem'`. */
+    readonly size: _angular_core.InputSignal<string>;
     readonly onShow: _angular_core.OutputEmitterRef<void>;
     readonly onHide: _angular_core.OutputEmitterRef<void>;
     protected readonly titleId: string;
@@ -39,7 +41,7 @@ declare class CbDrawer {
     private edgePosition;
     private disposeOverlay;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbDrawer, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDrawer, "cb-drawer", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "onShow": "onShow"; "onHide": "onHide"; }, never, ["*", "[cb-drawer-footer]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbDrawer, "cb-drawer", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "dismissableMask": { "alias": "dismissableMask"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "onShow": "onShow"; "onHide": "onHide"; }, never, ["*", "[cb-drawer-footer]"], true, never>;
 }
 
 export { CbDrawer };