@caribeng/ui 22.4.0 → 22.5.0

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

@@ -4,6 +4,64 @@ import * as _caribeng_ui from '@caribeng/ui';
 import { cbFormat } from '@caribeng/ui';
 import * as pdfjs_dist from 'pdfjs-dist';
 
+/** Rectángulo en puntos PDF de la página (`[x1, y1, x2, y2]`, con y hacia arriba, sin el giro del visor). */
+type CbPdfRect = readonly [number, number, number, number];
+/** Herramienta de anotación activa. */
+type CbPdfTool = 'none' | 'highlight' | 'note' | 'ink' | 'signature';
+/** Colores de anotación: el claro se usa para resaltar y el oscuro para notas y dibujos. */
+type CbPdfAnnotationColor = 'yellow' | 'green' | 'blue' | 'red';
+declare const CB_PDF_COLORS: Readonly<Record<CbPdfAnnotationColor, {
+    light: string;
+    dark: string;
+}>>;
+interface CbPdfAnnotationBase {
+    readonly id: string;
+    /** Página, desde 1. */
+    readonly page: number;
+    /** Autor (campo `T` del PDF). */
+    readonly author?: string;
+    /** Fecha de creación (ISO 8601). */
+    readonly date?: string;
+}
+/** Texto resaltado, con un comentario opcional (nota emergente en el PDF). */
+interface CbPdfHighlight extends CbPdfAnnotationBase {
+    readonly type: 'highlight';
+    /** Un rectángulo por línea resaltada. */
+    readonly rects: readonly CbPdfRect[];
+    readonly color: CbPdfAnnotationColor;
+    /** Texto que se resaltó. */
+    readonly text: string;
+    readonly comment?: string;
+}
+/** Nota de texto visible sobre la página (`FreeText` en el PDF). */
+interface CbPdfNote extends CbPdfAnnotationBase {
+    readonly type: 'note';
+    readonly rect: CbPdfRect;
+    /** Texto; cada salto de línea es una línea en el PDF. */
+    readonly text: string;
+    readonly color: CbPdfAnnotationColor;
+    /** Tamaño de letra en puntos (12 por defecto). */
+    readonly fontSize?: number;
+}
+/** Dibujo a mano alzada (`Ink` en el PDF). */
+interface CbPdfInk extends CbPdfAnnotationBase {
+    readonly type: 'ink';
+    /** Trazos, cada uno como puntos PDF seguidos: `[x1, y1, x2, y2, …]`. */
+    readonly paths: readonly (readonly number[])[];
+    readonly color: CbPdfAnnotationColor;
+    /** Grosor en puntos. */
+    readonly thickness: number;
+}
+/** Firma como imagen (`Stamp` en el PDF). */
+interface CbPdfSignature extends CbPdfAnnotationBase {
+    readonly type: 'signature';
+    readonly rect: CbPdfRect;
+    /** Imagen de la firma (data URL PNG, como la da `cb-signature-pad`). */
+    readonly image: string;
+}
+/** Anotación del visor. Las coordenadas son puntos PDF: no cambian con el zoom ni con el giro. */
+type CbPdfAnnotation = CbPdfHighlight | CbPdfNote | CbPdfInk | CbPdfSignature;
+
 /** Módulo de pdf.js (`pdfjs-dist`) que usa el visor. */
 type CbPdfJs = typeof pdfjs_dist;
 /** Documento abierto por pdf.js. */
@@ -87,13 +145,54 @@ type CbPdfZoom = number | 'page-width' | 'page-fit';
 /** Giro del documento, en grados. */
 type CbPdfRotation = 0 | 90 | 180 | 270;
 type ViewerState = 'idle' | 'loading' | 'password' | 'ready' | 'error';
+type SidebarView = 'thumbnails' | 'outline' | 'annotations';
+/** Una anotación ya colocada en su página dibujada (píxeles CSS). */
+interface Mark {
+    readonly a: CbPdfAnnotation;
+    readonly box: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** Resaltado: un rectángulo por línea, relativo a `box`. */
+    readonly rects?: readonly {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }[];
+    /** Dibujo: trazado SVG relativo a `box`. */
+    readonly d?: string;
+    readonly strokePx?: number;
+    /** Nota: tamaño de letra en píxeles. */
+    readonly fontPx?: number;
+    readonly light: string;
+    readonly dark: string;
+    readonly label: string;
+}
+/** Entrada del índice (marcadores) del documento. */
+interface CbPdfOutlineItem {
+    readonly title: string;
+    /** Destino interno (nombre o destino explícito de pdf.js). */
+    readonly dest: string | unknown[] | null;
+    /** Enlace externo. */
+    readonly url: string | null;
+    readonly bold: boolean;
+    readonly italic: boolean;
+    readonly items: readonly CbPdfOutlineItem[];
+}
+/** Valor de un campo de formulario: texto, casilla marcada u opciones elegidas. */
+type CbPdfFormValue = string | boolean | string[] | null;
 /**
  * Visor de PDF sobre [pdf.js](https://mozilla.github.io/pdf.js/) (`pdfjs-dist`,
  * dependencia opcional que se carga al abrir el primer documento).
  *
  * Renderiza las páginas a medida que se ven, con texto seleccionable y
  * legible por lectores de pantalla, búsqueda (ignora tildes y mayúsculas),
- * miniaturas, zoom, giro, descarga, impresión y documentos con contraseña.
+ * miniaturas, índice (marcadores), enlaces internos y externos, formularios
+ * rellenables (se descargan e imprimen con lo escrito), zoom, giro, descarga,
+ * impresión y documentos con contraseña.
  *
  * @example
  * ```html
@@ -126,17 +225,45 @@ declare class CbPdfViewer {
     readonly showRotate: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly downloadable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly printable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Pestaña Índice en el panel lateral (si el documento tiene marcadores). */
+    readonly showOutline: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Campos de formulario rellenables (si no, se pintan como imagen). */
+    readonly forms: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Enlaces externos del documento: se abren en otra pestaña. `false` los desactiva. */
+    readonly externalLinks: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Vista del panel lateral. */
+    readonly sidebarView: _angular_core.ModelSignal<SidebarView>;
     /** Nombre accesible del visor (por defecto, "Visor de PDF"). */
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Herramientas para resaltar, poner notas, dibujar y firmar (y la pestaña Anotaciones). */
+    readonly annotatable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Anotaciones del usuario, en puntos PDF. Se ven siempre; con `annotatable` se crean, mueven y
+     * borran. Al descargar o imprimir se escriben en el PDF como anotaciones estándar.
+     */
+    readonly annotations: _angular_core.ModelSignal<readonly CbPdfAnnotation[]>;
+    /** Herramienta activa (`none`, `highlight`, `note`, `ink`). Escape vuelve a `none`. */
+    readonly tool: _angular_core.ModelSignal<CbPdfTool>;
+    /** Color de las anotaciones nuevas. */
+    readonly annotationColor: _angular_core.ModelSignal<CbPdfAnnotationColor>;
+    /** Autor de las anotaciones nuevas (se guarda en el PDF). */
+    readonly author: _angular_core.InputSignal<string>;
     /** Documento abierto. */
     readonly loaded: _angular_core.OutputEmitterRef<{
         numPages: number;
     }>;
     /** No se pudo abrir el documento. */
     readonly loadError: _angular_core.OutputEmitterRef<unknown>;
+    /** El usuario cambió un campo del formulario (los valores, con `getFormData()`). */
+    readonly formChange: _angular_core.OutputEmitterRef<void>;
+    /** El usuario creó una anotación. */
+    readonly annotationAdd: _angular_core.OutputEmitterRef<CbPdfAnnotation>;
+    /** El usuario borró una anotación. */
+    readonly annotationRemove: _angular_core.OutputEmitterRef<CbPdfAnnotation>;
     private readonly engine;
     private readonly document;
     private readonly injector;
+    private readonly host;
     private readonly isBrowser;
     protected readonly uid: string;
     protected readonly state: _angular_core.WritableSignal<ViewerState>;
@@ -154,11 +281,19 @@ declare class CbPdfViewer {
     protected readonly matchIndex: _angular_core.WritableSignal<number>;
     protected readonly searching: _angular_core.WritableSignal<boolean>;
     protected readonly zoomLevels: number[];
+    /** Índice del documento (vacío si no tiene). */
+    readonly outline: _angular_core.WritableSignal<readonly CbPdfOutlineItem[]>;
+    /** Algún campo del formulario cambió desde que se abrió. */
+    readonly formModified: _angular_core.WritableSignal<boolean>;
+    private readonly collapsed;
+    /** Enlaces del documento (lo que la capa de anotaciones de pdf.js necesita). */
+    private readonly linkService;
     private readonly viewport;
     private readonly pageEls;
     private readonly thumbEls;
     private readonly searchInput;
     private readonly passwordInput;
+    private readonly cardText;
     /** Factor de zoom efectivo (1 = 100 %). */
     readonly scale: _angular_core.Signal<number>;
     /** Tamaño de cada página en píxeles CSS con el zoom y el giro actuales. */
@@ -176,6 +311,34 @@ declare class CbPdfViewer {
     protected readonly zoomValue: _angular_core.Signal<string>;
     protected readonly customZoom: _angular_core.Signal<number | null>;
     protected readonly searchStatus: _angular_core.Signal<string>;
+    protected readonly colors: Readonly<Record<CbPdfAnnotationColor, {
+        light: string;
+        dark: string;
+    }>>;
+    protected readonly colorNames: CbPdfAnnotationColor[];
+    protected readonly selectedId: _angular_core.WritableSignal<string | null>;
+    /** Anotación con el editor (texto de la nota o comentario del resaltado) abierto. */
+    protected readonly editingId: _angular_core.WritableSignal<string | null>;
+    /** Anotación mientras se arrastra o cambia de tamaño (se confirma al soltar). */
+    private readonly dragPreview;
+    /** Trazo que se está dibujando, en píxeles de la página. */
+    protected readonly stroke: _angular_core.WritableSignal<{
+        page: number;
+        points: number[];
+    } | null>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private announceFlip;
+    protected readonly signing: _angular_core.WritableSignal<boolean>;
+    protected readonly signatureValue: _angular_core.WritableSignal<string>;
+    private pendingFocus;
+    private readonly shownAnnotations;
+    /** Anotaciones de cada página, ya colocadas con el zoom y el giro actuales. */
+    protected readonly marks: _angular_core.Signal<Mark[][]>;
+    protected readonly editingMark: _angular_core.Signal<Mark | null>;
+    protected readonly sortedAnnotations: _angular_core.Signal<CbPdfAnnotation[]>;
+    protected readonly sidebarTabs: _angular_core.Signal<SidebarView[]>;
+    protected readonly activeView: _angular_core.Signal<SidebarView>;
+    protected readonly toolHint: _angular_core.Signal<string>;
     private pdfjs?;
     private pdf?;
     private loadingTask?;
@@ -209,11 +372,18 @@ declare class CbPdfViewer {
     search(query: string): Promise<void>;
     findNext(): void;
     findPrevious(): void;
-    /** Descarga el documento original. */
+    /** Lleva a un destino del documento (nombre o destino explícito), con su posición en la página. */
+    goToDestination(dest: string | unknown[] | null): Promise<void>;
+    /** Valores actuales del formulario, por nombre de campo. */
+    getFormData(): Promise<Record<string, CbPdfFormValue>>;
+    /** El PDF con lo escrito en el formulario y las anotaciones (o el original si no hay cambios). */
+    save(): Promise<Blob | null>;
+    /** Descarga el documento (con los datos del formulario y las anotaciones, si los hay). */
     download(): Promise<void>;
     /** Imprime el documento (no la página de la aplicación). */
     print(): Promise<void>;
     private open;
+    private loadOutline;
     protected submitPassword(event: Event, value: string): void;
     /** Lee el tamaño real de todas las páginas (pueden ser distintas de la primera). */
     private measurePages;
@@ -226,6 +396,8 @@ declare class CbPdfViewer {
     private renderVisible;
     private renderPage;
     private unrender;
+    /** Enlaces y campos de formulario de la página (capa de anotaciones de pdf.js). */
+    private renderAnnotations;
     private observeThumbs;
     private renderThumbs;
     private renderThumb;
@@ -237,10 +409,78 @@ declare class CbPdfViewer {
     protected onScroll(): void;
     private mostVisiblePage;
     private scrollToPage;
+    /** Desplaza hasta la altura `top` (puntos PDF, desde abajo) de la página `n`. */
+    private scrollToPoint;
     private readAnchor;
     private restoreAnchor;
     private observeResize;
     private pageEl;
+    protected toggleTool(tool: CbPdfTool): void;
+    /** Con texto seleccionado lo resalta al momento; si no, activa la herramienta. */
+    protected onHighlightTool(): void;
+    /** Con el teclado (sin puntero) la nota se pone directamente en la página que se ve. */
+    protected onNoteTool(event: MouseEvent): void;
+    protected openSignature(): void;
+    protected insertSignature(): Promise<void>;
+    /** El foco vuelve tras cerrar el diálogo: entonces se lleva a la firma recién puesta. */
+    protected onSignatureHide(): void;
+    /** Resalta el texto seleccionado en el documento (una anotación por página). */
+    protected highlightSelection(): boolean;
+    protected onPagesPointerUp(): void;
+    protected onMarksPointerDown(event: PointerEvent, page: number): void;
+    private finishStroke;
+    private addNote;
+    /** Añade una anotación, la anuncia y la selecciona. Devuelve su `id`. */
+    private addAnnotation;
+    /** Borra una anotación y deja el foco en la siguiente de la página (o en el documento). */
+    removeAnnotation(annotation: CbPdfAnnotation): void;
+    private replaceAnnotation;
+    protected select(id: string): void;
+    /** Lleva a la anotación (desde la lista del panel) y le da el foco. */
+    protected revealAnnotation(annotation: CbPdfAnnotation): void;
+    private focusMark;
+    protected openEditor(id: string): void;
+    protected onCardInput(value: string): void;
+    protected onCardKeydown(event: KeyboardEvent): void;
+    /** Cierra el editor: una nota vacía se borra y una con texto ajusta su caja a lo escrito. */
+    closeEditor(refocus: boolean): void;
+    /** La caja de la nota en el PDF es la que ocupa su texto en pantalla. */
+    private measureNote;
+    protected onMarkPointerDown(event: PointerEvent, annotation: CbPdfAnnotation): void;
+    protected onResizePointerDown(event: PointerEvent, annotation: CbPdfAnnotation): void;
+    /** Arrastre con vista previa: se confirma al soltar; sin moverse es un clic (`onClick`). */
+    private trackPointer;
+    protected onMarkKeydown(event: KeyboardEvent, rendered: CbPdfAnnotation): void;
+    /** Desplaza `dx`, `dy` píxeles de pantalla (con el giro, en el sentido en que se ven). */
+    private translated;
+    private announcePosition;
+    private announce;
+    /** Centro de la parte visible de la página `n`, en píxeles de la página. */
+    private visibleSpot;
+    private toMark;
+    protected labelOf(a: CbPdfAnnotation): string;
+    private nounOf;
+    protected swatchOf(a: CbPdfAnnotation): string;
+    protected colorLabel(color: CbPdfAnnotationColor): string;
+    /** Posición del editor: bajo la anotación, sin salirse de la página. */
+    protected cardLeft(m: Mark, pageWidth: number): number;
+    protected noteHeight(m: Mark): number;
+    private newBase;
+    private geomOf;
+    private viewOf;
+    /** Altura (para ordenar de arriba abajo en el panel). */
+    private topOf;
+    /**
+     * Escribe las anotaciones en el `annotationStorage` de pdf.js mientras dura `run` (guardar o
+     * tomar la copia para imprimir) y las quita después, sin marcar el formulario como cambiado.
+     */
+    private withAnnotations;
+    protected isCollapsed(path: string): boolean;
+    protected toggleOutline(path: string): void;
+    protected openOutlineItem(item: CbPdfOutlineItem): void;
+    /** Acciones con nombre de los enlaces (NextPage, PrevPage, FirstPage, LastPage). */
+    private namedAction;
+    protected onFormInput(): void;
     protected onPageInput(event: Event): void;
     protected onZoomSelect(value: string): void;
     protected onThumbKeydown(event: KeyboardEvent, n: number): void;
@@ -250,9 +490,9 @@ declare class CbPdfViewer {
     private downloadName;
     private rotatedPoints;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPdfViewer, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPdfViewer, "cb-pdf-viewer", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "password": { "alias": "password"; "required": false; "isSignal": true; }; "withCredentials": { "alias": "withCredentials"; "required": false; "isSignal": true; }; "httpHeaders": { "alias": "httpHeaders"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "rotation": { "alias": "rotation"; "required": false; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "showThumbnails": { "alias": "showThumbnails"; "required": false; "isSignal": true; }; "showRotate": { "alias": "showRotate"; "required": false; "isSignal": true; }; "downloadable": { "alias": "downloadable"; "required": false; "isSignal": true; }; "printable": { "alias": "printable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; "zoom": "zoomChange"; "rotation": "rotationChange"; "sidebar": "sidebarChange"; "loaded": "loaded"; "loadError": "loadError"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPdfViewer, "cb-pdf-viewer", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "password": { "alias": "password"; "required": false; "isSignal": true; }; "withCredentials": { "alias": "withCredentials"; "required": false; "isSignal": true; }; "httpHeaders": { "alias": "httpHeaders"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "rotation": { "alias": "rotation"; "required": false; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "showThumbnails": { "alias": "showThumbnails"; "required": false; "isSignal": true; }; "showRotate": { "alias": "showRotate"; "required": false; "isSignal": true; }; "downloadable": { "alias": "downloadable"; "required": false; "isSignal": true; }; "printable": { "alias": "printable"; "required": false; "isSignal": true; }; "showOutline": { "alias": "showOutline"; "required": false; "isSignal": true; }; "forms": { "alias": "forms"; "required": false; "isSignal": true; }; "externalLinks": { "alias": "externalLinks"; "required": false; "isSignal": true; }; "sidebarView": { "alias": "sidebarView"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "annotatable": { "alias": "annotatable"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; "tool": { "alias": "tool"; "required": false; "isSignal": true; }; "annotationColor": { "alias": "annotationColor"; "required": false; "isSignal": true; }; "author": { "alias": "author"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; "zoom": "zoomChange"; "rotation": "rotationChange"; "sidebar": "sidebarChange"; "sidebarView": "sidebarViewChange"; "annotations": "annotationsChange"; "tool": "toolChange"; "annotationColor": "annotationColorChange"; "loaded": "loaded"; "loadError": "loadError"; "formChange": "formChange"; "annotationAdd": "annotationAdd"; "annotationRemove": "annotationRemove"; }, never, never, true, never>;
 }
 
-export { CB_PDF_VIEWER_OPTIONS, CbPdfEngine, CbPdfViewer, provideCbPdfViewer };
-export type { CbPdfDocument, CbPdfJs, CbPdfMatch, CbPdfPage, CbPdfRotation, CbPdfSource, CbPdfTextPosition, CbPdfViewerOptions, CbPdfZoom };
+export { CB_PDF_COLORS, CB_PDF_VIEWER_OPTIONS, CbPdfEngine, CbPdfViewer, provideCbPdfViewer };
+export type { CbPdfAnnotation, CbPdfAnnotationColor, CbPdfDocument, CbPdfFormValue, CbPdfHighlight, CbPdfInk, CbPdfJs, CbPdfMatch, CbPdfNote, CbPdfOutlineItem, CbPdfPage, CbPdfRect, CbPdfRotation, CbPdfSignature, CbPdfSource, CbPdfTextPosition, CbPdfTool, CbPdfViewerOptions, CbPdfZoom };
 //# sourceMappingURL=caribeng-ui-pdfviewer.d.ts.map

package/types/caribeng-ui-period-picker.d.ts

@@ -0,0 +1,148 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbSize, CbRequiredIndicator } from '@caribeng/ui';
+import { ControlValueAccessor } from '@angular/forms';
+import { ConnectedPosition } from '@angular/cdk/overlay';
+
+/** Tipo de periodo contable. */
+type CbPeriodKind = 'month' | 'quarter' | 'year' | 'range';
+/** Periodo contable elegido. */
+interface CbPeriod {
+    readonly kind: CbPeriodKind;
+    /** Primer día (00:00). */
+    readonly from: Date;
+    /** Último día (00:00). */
+    readonly to: Date;
+    /** Clave estable: `2026-10`, `2026-Q3`, `2026` (año fiscal) o `2026-01-01_2026-10-23`. */
+    readonly key: string;
+}
+/** Atajos de periodo. */
+type CbPeriodPreset = 'thisMonth' | 'lastMonth' | 'thisQuarter' | 'lastQuarter' | 'yearToDate' | 'thisYear' | 'lastYear';
+/** Mes: `2026-10`. */
+declare function monthPeriod(year: number, month: number): CbPeriod;
+/**
+ * Año fiscal que empieza en `startMonth` (0 = enero). Se nombra por el año en
+ * que termina (con inicio en julio, el año fiscal 2026 va de jul 2025 a jun 2026).
+ */
+declare function fiscalYear(year: number, startMonth?: number): CbPeriod;
+/** Trimestre `q` (1–4) del año fiscal `year`. */
+declare function quarterPeriod(year: number, q: number, startMonth?: number): CbPeriod;
+declare function rangePeriod(from: Date, to: Date): CbPeriod;
+/** Año fiscal al que pertenece una fecha. */
+declare function fiscalYearOf(date: Date, startMonth?: number): number;
+/** Trimestre fiscal (1–4) de una fecha. */
+declare function quarterOf(date: Date, startMonth?: number): number;
+/** Periodo de un atajo respecto a `today`. */
+declare function presetPeriod(preset: CbPeriodPreset, today: Date, startMonth?: number): CbPeriod;
+/** Meses (`AAAA-MM`) que abarca un periodo. */
+declare function monthsOf(period: CbPeriod): string[];
+/** Periodo a partir de su clave (`2026-10`, `2026-Q3`, `2026`, `2026-01-01_2026-03-31`). */
+declare function periodFromKey(key: string, startMonth?: number): CbPeriod | null;
+
+type Mode = Exclude<CbPeriodKind, 'range'>;
+interface Cell {
+    readonly period: CbPeriod;
+    readonly text: string;
+    readonly label: string;
+    readonly closed: boolean;
+    readonly disabled: boolean;
+}
+/**
+ * Selector de periodo contable de CaribeNG: mes, trimestre o año (fiscal), con
+ * atajos («Mes anterior», «Año a la fecha»…) y periodos cerrados marcados.
+ *
+ * - `fiscalYearStart` mueve el inicio del año fiscal (trimestres y años incluidos).
+ * - `closed` marca meses cerrados con un candado; con `disableClosed` no se eligen
+ *   (útil al contabilizar), sin él se pueden consultar (útil en informes).
+ * - Funciona con Angular Forms o con `[(value)]`; el valor es un `CbPeriod` con
+ *   `from`, `to`, `kind` y `key`.
+ *
+ * @example
+ * ```html
+ * <cb-period-picker label="Periodo" [(value)]="periodo" [closed]="cerrados" />
+ * ```
+ */
+declare class CbPeriodPicker implements ControlValueAccessor {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly injector;
+    private readonly uid;
+    readonly value: _angular_core.ModelSignal<CbPeriod | null>;
+    /** Vista de la cuadrícula: mes, trimestre o año. */
+    readonly mode: _angular_core.ModelSignal<Mode>;
+    /** Vistas disponibles y su orden. */
+    readonly modes: _angular_core.InputSignal<readonly Mode[]>;
+    /** Atajos del panel (lista vacía para quitarlos). */
+    readonly presets: _angular_core.InputSignal<readonly CbPeriodPreset[]>;
+    /** Mes en que empieza el año fiscal (1 = enero). */
+    readonly fiscalYearStart: _angular_core.InputSignal<number>;
+    /** Meses cerrados (`AAAA-MM`): se marcan con un candado. */
+    readonly closed: _angular_core.InputSignal<readonly string[]>;
+    /** No deja elegir periodos que incluyan meses cerrados. */
+    readonly disableClosed: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Primer y último día que se pueden elegir. */
+    readonly min: _angular_core.InputSignal<Date | null>;
+    readonly max: _angular_core.InputSignal<Date | null>;
+    /** «Hoy» para los atajos y el periodo actual (por defecto, la fecha del sistema). */
+    readonly today: _angular_core.InputSignal<Date>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly hint: _angular_core.InputSignal<string>;
+    readonly error: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<CbSize>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly requiredIndicator: _angular_core.InputSignal<CbRequiredIndicator | undefined>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly inputId: _angular_core.InputSignal<string>;
+    readonly periodChange: _angular_core.OutputEmitterRef<CbPeriod | null>;
+    protected readonly fieldState: _caribeng_ui.CbFieldState;
+    protected readonly positions: ConnectedPosition[];
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    private readonly cvaDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    private readonly trigger;
+    private readonly startMonth;
+    private readonly closedSet;
+    /** Año (o primer año de la docena, en la vista de años) que muestra la cuadrícula. */
+    protected readonly year: _angular_core.WritableSignal<number>;
+    private readonly decadeStart;
+    protected readonly cells: _angular_core.Signal<Cell[]>;
+    /** Celda con el foco (la elegida, la del periodo actual o la primera). */
+    protected readonly focusIndex: _angular_core.WritableSignal<number>;
+    protected readonly navTitle: _angular_core.Signal<string>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    private onChange;
+    private onTouched;
+    writeValue(value: CbPeriod | null): void;
+    registerOnChange(fn: (value: CbPeriod | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(disabled: boolean): void;
+    /** Nombre de un periodo: «Octubre de 2026», «T3 2026», «2026», «1 ene – 23 oct 2026». */
+    labelOf(period: CbPeriod): string;
+    protected modeLabel(mode: Mode): string;
+    protected presetLabel(preset: CbPeriodPreset): string;
+    protected isClosed(period: CbPeriod): boolean;
+    protected isCurrent(period: CbPeriod): boolean;
+    protected isPresetActive(preset: CbPeriodPreset): boolean;
+    protected presetDisabled(preset: CbPeriodPreset): boolean;
+    protected toggle(): void;
+    protected onTriggerKeydown(event: KeyboardEvent): void;
+    protected onOutsideClick(event: MouseEvent): void;
+    protected setMode(mode: Mode): void;
+    protected step(delta: number): void;
+    protected choose(cell: Cell): void;
+    protected choosePreset(preset: CbPeriodPreset): void;
+    protected onGridKeydown(event: KeyboardEvent): void;
+    private openPanel;
+    /** Cierra el panel (y devuelve el foco al botón si se cerró desde dentro). */
+    close(refocus: boolean): void;
+    private focusCell;
+    private setValue;
+    private day;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPeriodPicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPeriodPicker, "cb-period-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "modes": { "alias": "modes"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "fiscalYearStart": { "alias": "fiscalYearStart"; "required": false; "isSignal": true; }; "closed": { "alias": "closed"; "required": false; "isSignal": true; }; "disableClosed": { "alias": "disableClosed"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "requiredIndicator": { "alias": "requiredIndicator"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "mode": "modeChange"; "periodChange": "periodChange"; }, never, never, true, never>;
+}
+
+export { CbPeriodPicker, fiscalYear, fiscalYearOf, monthPeriod, monthsOf, periodFromKey, presetPeriod, quarterOf, quarterPeriod, rangePeriod };
+export type { CbPeriod, CbPeriodKind, CbPeriodPreset };
+//# sourceMappingURL=caribeng-ui-period-picker.d.ts.map

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

@@ -0,0 +1,116 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbSummary, cbFormat } from '@caribeng/ui';
+import { CbXlsxSheet } from '@caribeng/ui/xlsx';
+
+/** Medida de la tabla dinámica: qué campo se agrega y cómo. */
+interface CbPivotValue {
+    readonly field: string;
+    readonly aggregate?: CbSummary;
+    readonly label?: string;
+    /** `currency` (por defecto), `number` o `integer`. */
+    readonly format?: 'currency' | 'number' | 'integer';
+}
+/** Dimensión disponible para filas o columnas (o medida, si es numérica). */
+interface CbPivotField {
+    readonly key: string;
+    readonly label: string;
+    /** Texto de cada valor (p. ej. nombre de la cuenta a partir del código). */
+    readonly format?: (value: unknown) => string;
+}
+/** Nodo de filas: un valor de una dimensión con sus hijos (siguiente dimensión). */
+interface PivotRowNode {
+    readonly key: string;
+    /** Ruta de valores desde la raíz (`['5135', 'Enel']`). */
+    readonly path: readonly string[];
+    readonly level: number;
+    readonly label: string;
+    readonly records: readonly Record<string, unknown>[];
+    readonly children: readonly PivotRowNode[];
+}
+/** Valores distintos (combinados) de las dimensiones de columna, ordenados. */
+declare function columnKeys(data: readonly Record<string, unknown>[], fields: readonly string[]): string[];
+/** Árbol de filas agrupando por cada dimensión de `fields`, en orden. */
+declare function rowTree(data: readonly Record<string, unknown>[], fields: readonly string[], labelOf: (field: string, value: string) => string, level?: number, path?: string[]): PivotRowNode[];
+/** Valor agregado de una medida sobre unos registros. */
+declare function aggregate(records: readonly Record<string, unknown>[], value: CbPivotValue): number | null;
+
+interface FlatRow {
+    readonly node: PivotRowNode;
+    readonly hasChildren: boolean;
+}
+/**
+ * Tabla dinámica de CaribeNG: cruza los registros por dimensiones de filas y
+ * columnas (cuenta, tercero, centro de costo, mes…) y agrega una o varias medidas.
+ *
+ * - Filas anidadas que se contraen, con subtotales; totales por fila, por columna y general.
+ * - Con `configurable`, el usuario elige desde la propia tabla las dimensiones y la medida.
+ * - Importes con la moneda de `provideCaribeNG`, exportación a Excel con niveles.
+ *
+ * @example
+ * ```html
+ * <cb-pivot [data]="movimientos" [fields]="dimensiones" [(rows)]="filas" [(columns)]="columnas" [values]="[{ field: 'valor' }]" configurable />
+ * ```
+ */
+declare class CbPivot {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly config;
+    protected readonly uid: string;
+    /** Registros a cruzar. */
+    readonly data: _angular_core.InputSignal<readonly Record<string, unknown>[]>;
+    /** Dimensiones disponibles (clave, etiqueta y formato de sus valores). */
+    readonly fields: _angular_core.InputSignal<readonly CbPivotField[]>;
+    /** Dimensiones de las filas, de la más general a la más detallada (bidireccional). */
+    readonly rows: _angular_core.ModelSignal<readonly string[]>;
+    /** Dimensiones de las columnas (bidireccional). */
+    readonly columns: _angular_core.ModelSignal<readonly string[]>;
+    /** Medidas (campo y agregación); por defecto, suma. */
+    readonly values: _angular_core.InputSignal<readonly CbPivotValue[]>;
+    /** Selectores de filas, columnas y agregación sobre la tabla. */
+    readonly configurable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Las filas con hijos empiezan contraídas. */
+    readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    private readonly collapsedKeys;
+    protected readonly aggregateOverride: _angular_core.WritableSignal<CbSummary | null>;
+    protected readonly measures: _angular_core.Signal<CbPivotValue[]>;
+    protected readonly aggregateValue: _angular_core.Signal<CbSummary>;
+    private readonly fieldMap;
+    private labelOf;
+    protected readonly colKeys: _angular_core.Signal<string[]>;
+    protected readonly colKeysWithTotal: _angular_core.Signal<string[]>;
+    private readonly tree;
+    protected readonly flat: _angular_core.Signal<FlatRow[]>;
+    private collapsedSet;
+    protected readonly dimensionOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    protected readonly columnOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    protected readonly aggregateOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    protected rowHeader(): string;
+    protected colLabel(key: string): string;
+    protected measureLabel(m: CbPivotValue): string;
+    protected cell(records: readonly Record<string, unknown>[], colKey: string, m: CbPivotValue): number | null;
+    protected text(value: number | null, m: CbPivotValue): string;
+    protected isCollapsed(key: string): boolean;
+    protected toggle(key: string): void;
+    protected setRows(keys: readonly string[]): void;
+    /** Hoja de Excel con todas las filas (con niveles plegables) y los totales. */
+    toExcelSheet(): CbXlsxSheet;
+    exportExcel(filename?: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPivot, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPivot, "cb-pivot", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "configurable": { "alias": "configurable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "rows": "rowsChange"; "columns": "columnsChange"; }, never, never, true, never>;
+}
+
+export { CbPivot, aggregate, columnKeys, rowTree };
+export type { CbPivotField, CbPivotValue, PivotRowNode };
+//# sourceMappingURL=caribeng-ui-pivot.d.ts.map