@caribeng/ui 22.2.0 → 22.5.0

package/types/caribeng-ui-notification-center.d.ts

@@ -0,0 +1,153 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/** Acción propia de una notificación ("Aprobar", "Ver pedido"…). */
+interface CbNotificationAction {
+    readonly id: string;
+    readonly label: string;
+    /** `primary` para la acción principal; el resto se pinta como secundaria. */
+    readonly severity?: 'primary' | 'secondary';
+}
+/** Aviso del centro de notificaciones. */
+interface CbNotification {
+    readonly id: string;
+    readonly title: string;
+    /** Detalle en una o dos líneas. */
+    readonly text?: string;
+    /** Fecha (`Date` o ISO 8601). */
+    readonly date: Date | string;
+    readonly read?: boolean;
+    /** Persona que lo origina: se muestra su foto o sus iniciales en lugar del icono. */
+    readonly person?: {
+        readonly name: string;
+        readonly image?: string;
+    };
+    /** Icono (si no hay `person`); por defecto, según `severity`. */
+    readonly icon?: string;
+    /** Color del icono. */
+    readonly severity?: 'info' | 'success' | 'warning' | 'danger';
+    readonly actions?: readonly CbNotificationAction[];
+}
+/** Acción pulsada en una notificación. */
+interface CbNotificationActionEvent {
+    readonly notification: CbNotification;
+    readonly action: CbNotificationAction;
+}
+/** Qué muestra el panel. */
+type CbNotificationFilter = 'all' | 'unread';
+/** Grupo por fecha: hoy, ayer o antes. */
+type CbNotificationGroupKey = 'today' | 'yesterday' | 'earlier';
+interface CbNotificationGroup {
+    readonly key: CbNotificationGroupKey;
+    readonly items: readonly CbNotification[];
+}
+
+/**
+ * Centro de notificaciones de CaribeNG: campana con el número de avisos sin leer que abre un
+ * panel con la lista agrupada por fecha (Hoy, Ayer, Anteriores), filtro Todas / No leídas,
+ * marcar como leída (una o todas), eliminar y acciones propias en cada aviso. Con `inline` el
+ * panel se pinta en la página, sin campana.
+ *
+ * @example
+ * ```html
+ * <cb-notification-center [(notifications)]="avisos" (itemClick)="abrir($event)" />
+ * ```
+ */
+declare class CbNotificationCenter {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly host;
+    private readonly injector;
+    private readonly overlay;
+    private readonly vcr;
+    protected readonly panelId: string;
+    /** Avisos (el panel los ordena del más reciente al más antiguo). Se actualiza al leer o eliminar. */
+    readonly notifications: _angular_core.ModelSignal<readonly CbNotification[]>;
+    /** Todas o solo las no leídas. */
+    readonly filter: _angular_core.ModelSignal<CbNotificationFilter>;
+    /** Panel abierto (sin `inline`). */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    /** Pinta el panel en la página, sin campana ni ventana flotante. */
+    readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Agrupa por fecha: Hoy, Ayer y Anteriores. */
+    readonly groupByDate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra el botón de eliminar en cada aviso. */
+    readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Cierra el panel al elegir un aviso. */
+    readonly closeOnSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Anuncia a los lectores de pantalla los avisos nuevos sin leer. Si la misma lista se muestra en
+     * dos centros (la campana y una página), desactívalo en uno para no oírlo dos veces.
+     */
+    readonly announceNew: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra el pie con "Ver todas" (`viewAll`). */
+    readonly showViewAll: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** A partir de este número, la campana muestra "99+". */
+    readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Título del panel (por defecto, "Notificaciones"). No es `title` para no dar un tooltip al componente. */
+    readonly heading: _angular_core.InputSignal<string | undefined>;
+    /** Nivel del título (los grupos usan el siguiente). */
+    readonly headingLevel: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    readonly panelWidth: _angular_core.InputSignal<string>;
+    /** Alto máximo de la lista (con scroll). */
+    readonly maxHeight: _angular_core.InputSignal<string>;
+    /** Aviso elegido (ya marcado como leído). */
+    readonly itemClick: _angular_core.OutputEmitterRef<CbNotification>;
+    readonly actionClick: _angular_core.OutputEmitterRef<CbNotificationActionEvent>;
+    /** Un aviso pasó a leído (`read: true`) o a no leído. */
+    readonly readChange: _angular_core.OutputEmitterRef<CbNotification>;
+    readonly markAll: _angular_core.OutputEmitterRef<void>;
+    readonly itemRemove: _angular_core.OutputEmitterRef<CbNotification>;
+    readonly viewAll: _angular_core.OutputEmitterRef<void>;
+    protected readonly unread: _angular_core.Signal<number>;
+    protected readonly badge: _angular_core.Signal<string>;
+    protected readonly bellLabel: _angular_core.Signal<string>;
+    private readonly now;
+    protected readonly groups: _angular_core.Signal<CbNotificationGroup[]>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private readonly panelTpl;
+    private readonly bell;
+    private overlayRef;
+    /** El foco está (o estaba, si su elemento desapareció) dentro del panel. */
+    protected focusInside: boolean;
+    private readonly positions;
+    constructor();
+    toggle(): void;
+    show(): void;
+    hide(): void;
+    protected initials(name: string): string;
+    protected iconOf(n: CbNotification): string;
+    protected groupLabel(key: CbNotificationGroupKey): string;
+    protected itemId(n: CbNotification): string;
+    protected iso(date: Date | string): string;
+    protected full(date: Date | string): string;
+    protected rel(date: Date | string): string;
+    protected select(n: CbNotification): void;
+    protected runAction(n: CbNotification, action: CbNotificationAction): void;
+    protected setRead(n: CbNotification, read: boolean): void;
+    protected markAllRead(): void;
+    protected remove(n: CbNotification): void;
+    protected onViewAll(): void;
+    /** Escape cierra; Tab fuera del panel lo cierra y devuelve el foco a la campana. */
+    protected onPanelKeydown(event: KeyboardEvent): void;
+    /** Sale el foco hacia otro elemento de la página (no cuando su elemento desaparece). */
+    protected onPanelFocusOut(event: FocusEvent): void;
+    private patch;
+    /** Antes de quitar un aviso de la vista: foco al siguiente (o al anterior, o al título). */
+    private focusAfterRemoval;
+    private panelRoot;
+    private attach;
+    private detach;
+    /** Un espacio duro alterno hace que el mismo texto cuente como cambio y se vuelva a anunciar. */
+    private announce;
+    private announceFlip;
+    private focusLater;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbNotificationCenter, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbNotificationCenter, "cb-notification-center", never, { "notifications": { "alias": "notifications"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "groupByDate": { "alias": "groupByDate"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; "announceNew": { "alias": "announceNew"; "required": false; "isSignal": true; }; "showViewAll": { "alias": "showViewAll"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "panelWidth": { "alias": "panelWidth"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; }, { "notifications": "notificationsChange"; "filter": "filterChange"; "open": "openChange"; "itemClick": "itemClick"; "actionClick": "actionClick"; "readChange": "readChange"; "markAll": "markAll"; "itemRemove": "itemRemove"; "viewAll": "viewAll"; }, never, never, true, never>;
+}
+
+export { CbNotificationCenter };
+export type { CbNotification, CbNotificationAction, CbNotificationActionEvent, CbNotificationFilter };
+//# sourceMappingURL=caribeng-ui-notification-center.d.ts.map

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

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 
 /**
- * Off-canvas de Caribe Design: panel lateral deslizable con cabecera, botón de
+ * Off-canvas: panel lateral deslizable con cabecera, botón de
  * cierre y contenido proyectado.
  *
  * @example
@@ -26,4 +26,4 @@ declare class CbOffCanvas {
 }
 
 export { CbOffCanvas };
-//# sourceMappingURL=caribeng-ui-caribe-off-canvas.d.ts.map
+//# sourceMappingURL=caribeng-ui-off-canvas.d.ts.map

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

@@ -3,7 +3,7 @@ import * as _caribeng_ui from '@caribeng/ui';
 import { cbFormat } from '@caribeng/ui';
 
 /**
- * Onboarding de Caribe Design: panel de bienvenida paso a paso con progreso y
+ * Onboarding: panel de bienvenida paso a paso con progreso y
  * navegación.
  *
  * @example
@@ -27,4 +27,4 @@ declare class CbOnboarding {
 }
 
 export { CbOnboarding };
-//# sourceMappingURL=caribeng-ui-caribe-onboarding.d.ts.map
+//# sourceMappingURL=caribeng-ui-onboarding.d.ts.map

package/types/caribeng-ui-panelmenu.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 CbPanelMenuItem {
     label: string;
@@ -7,6 +8,10 @@ interface CbPanelMenuItem {
     url?: string;
     disabled?: boolean;
     items?: readonly CbPanelMenuItem[];
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbPanelMenuItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Vertical menu with collapsible sections. */
 declare class CbPanelMenu {
@@ -14,6 +19,8 @@ declare class CbPanelMenu {
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly uid;
     readonly items: _angular_core.InputSignal<readonly CbPanelMenuItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbPanelMenuItem[]>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly multiple: _angular_core.InputSignal<boolean>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbPanelMenuItem>;

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