@caribeng/ui 22.2.0 → 22.5.0

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

@@ -0,0 +1,214 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+import { SafeHtml } from '@angular/platform-browser';
+import { CbEditorTool, CbEditorMentionSource } from '@caribeng/ui/editor';
+
+/** Persona que comenta, reacciona o a la que se menciona (compatible con `CbKanbanPerson`). */
+interface CbCommentPerson {
+    readonly id: string;
+    readonly name: string;
+    /** Foto (si no hay, se muestran las iniciales). */
+    readonly image?: string;
+    /** Texto secundario en la lista de menciones (cargo, correo…). */
+    readonly description?: string;
+}
+/** Reacción con un emoji y quién la puso (ids de persona). */
+interface CbCommentReaction {
+    readonly emoji: string;
+    readonly by: readonly string[];
+}
+/** Comentario del hilo. Las respuestas llevan `parentId` (un solo nivel, como en Asana o GitHub). */
+interface CbComment {
+    readonly id: string;
+    readonly author: CbCommentPerson;
+    /** Contenido en HTML del editor (se sanea al guardarlo y al pintarlo). Las menciones son `<span data-mention="id">`. */
+    readonly html: string;
+    /** Fecha de publicación (`Date` o ISO 8601). */
+    readonly date: Date | string;
+    /** Fecha de la última edición. */
+    readonly edited?: Date | string;
+    /** Comentario al que responde. */
+    readonly parentId?: string;
+    readonly reactions?: readonly CbCommentReaction[];
+    /** Eliminado, pero se conserva porque tiene respuestas. */
+    readonly deleted?: boolean;
+}
+/** Entrada del historial de cambios ("Ana movió esta tarea a En curso"). */
+interface CbActivity {
+    readonly id: string;
+    /** Texto de la acción, sin el nombre (se antepone `author`). */
+    readonly text: string;
+    readonly author?: CbCommentPerson;
+    readonly date: Date | string;
+    /** Icono (por defecto, un reloj). */
+    readonly icon?: string;
+}
+/** Qué muestra el hilo. */
+type CbCommentsFilter = 'all' | 'comments' | 'activity';
+/** Comentario publicado o editado, con los ids de las personas que menciona. */
+interface CbCommentEvent {
+    readonly comment: CbComment;
+    readonly mentions: readonly string[];
+}
+/** Reacción puesta (`added`) o quitada. */
+interface CbCommentReactionEvent {
+    readonly comment: CbComment;
+    readonly emoji: string;
+    readonly added: boolean;
+}
+/** Elemento del hilo ya ordenado: un comentario raíz con sus respuestas, o una actividad. */
+type CbFeedItem = {
+    readonly kind: 'comment';
+    readonly comment: CbComment;
+    readonly replies: readonly CbComment[];
+    readonly time: number;
+} | {
+    readonly kind: 'activity';
+    readonly activity: CbActivity;
+    readonly time: number;
+};
+/** Ids de las personas mencionadas en un HTML (`data-mention`), sin repetir y en orden. */
+declare function mentionIds(html: string): string[];
+/** Pone o quita la reacción `emoji` de `userId`; las reacciones que se quedan sin nadie desaparecen. */
+declare function toggleReaction(reactions: readonly CbCommentReaction[] | undefined, emoji: string, userId: string): {
+    reactions: CbCommentReaction[];
+    added: boolean;
+};
+/**
+ * Elimina un comentario. Si tiene respuestas se conserva como "eliminado" para no romper el hilo;
+ * si era la última respuesta de un comentario ya eliminado, también desaparece el padre.
+ */
+declare function removeComment(comments: readonly CbComment[], id: string): CbComment[];
+
+/** Barra del editor por defecto: lo justo para un comentario. */
+declare const CB_COMMENTS_TOOLBAR: readonly CbEditorTool[];
+/** Dónde se está escribiendo: comentario nuevo, respuesta a un hilo o edición. */
+type Draft = 'new' | {
+    reply: string;
+} | {
+    edit: string;
+};
+/**
+ * Hilo de comentarios y actividad de CaribeNG: comentarios con formato y @menciones
+ * (sobre `cb-editor`), respuestas de un nivel, reacciones con emoji, edición y borrado de los
+ * propios y, mezclado por fecha, el historial de cambios (`activity`).
+ *
+ * @example
+ * ```html
+ * <cb-comments [(comments)]="comentarios" [activity]="historial" [currentUser]="yo" [people]="equipo" />
+ * ```
+ */
+declare class CbComments {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly host;
+    private readonly injector;
+    private readonly sanitizer;
+    private readonly uid;
+    /** Comentarios (raíces y respuestas, en una lista plana). Se actualiza al publicar, editar, borrar o reaccionar. */
+    readonly comments: _angular_core.ModelSignal<readonly CbComment[]>;
+    /** Historial de cambios, que se intercala por fecha con los comentarios. */
+    readonly activity: _angular_core.InputSignal<readonly CbActivity[]>;
+    /** Quién escribe. Sin él, el hilo es de solo lectura. */
+    readonly currentUser: _angular_core.InputSignal<CbCommentPerson | null>;
+    /** Personas que se pueden mencionar con `@` y cuyos nombres aparecen en las reacciones. */
+    readonly people: _angular_core.InputSignal<readonly CbCommentPerson[]>;
+    /** Fuente propia de menciones (lista o función, también asíncrona); sustituye a `people` para `@`. */
+    readonly mentions: _angular_core.InputSignal<CbEditorMentionSource | null>;
+    /** Qué se muestra: todo, solo comentarios o solo actividad. */
+    readonly filter: _angular_core.ModelSignal<CbCommentsFilter>;
+    /** Orden del hilo. Con `oldest` la caja para comentar va al final; con `newest`, arriba. */
+    readonly order: _angular_core.InputSignal<"oldest" | "newest">;
+    /** Emojis para reaccionar (vacío para quitar las reacciones). */
+    readonly reactions: _angular_core.InputSignal<readonly string[]>;
+    /** Permite responder a un comentario. */
+    readonly replies: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Permite editar y eliminar los comentarios propios. */
+    readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra la caja para comentar (con `false` solo se responde, edita y reacciona). */
+    readonly composer: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Herramientas del editor. */
+    readonly toolbar: _angular_core.InputSignal<readonly CbEditorTool[]>;
+    /** Alto del área de escritura (crece hasta 16rem). */
+    readonly editorHeight: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Nombre del hilo para lectores de pantalla (por defecto, "Comentarios y actividad"). */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Comentario publicado (raíz o respuesta). */
+    readonly commentAdd: _angular_core.OutputEmitterRef<CbCommentEvent>;
+    readonly commentEdit: _angular_core.OutputEmitterRef<CbCommentEvent>;
+    readonly commentDelete: _angular_core.OutputEmitterRef<CbComment>;
+    readonly reactionToggle: _angular_core.OutputEmitterRef<CbCommentReactionEvent>;
+    protected readonly filters: readonly CbCommentsFilter[];
+    protected readonly feed: _angular_core.Signal<CbFeedItem[]>;
+    protected readonly showFilter: _angular_core.Signal<boolean>;
+    protected readonly canAct: _angular_core.Signal<boolean>;
+    protected readonly mentionSource: _angular_core.Signal<CbEditorMentionSource | null>;
+    private readonly names;
+    /** Borradores abiertos, por clave (`new`, `reply:<id>`, `edit:<id>`). */
+    private readonly drafts;
+    /** Hilo al que se está respondiendo y comentario en edición. */
+    private readonly replyTo;
+    private readonly editing;
+    protected readonly picker: _angular_core.WritableSignal<string | null>;
+    protected readonly confirming: _angular_core.WritableSignal<string | null>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    /** Hora de referencia de las fechas relativas (se refresca cada minuto). */
+    private readonly now;
+    private readonly safeCache;
+    constructor();
+    protected itemKey(item: CbFeedItem): string;
+    protected domId(id: string): string;
+    protected filterLabel(f: CbCommentsFilter): string;
+    protected initials(name: string): string;
+    protected iso(date: Date | string): string;
+    protected full(date: Date | string): string;
+    protected rel(date: Date | string): string;
+    /** HTML del comentario, saneado (lista blanca del editor) y marcado como seguro una sola vez. */
+    protected safe(html: string): SafeHtml;
+    protected mine(r: CbCommentReaction): boolean;
+    protected mineEmoji(c: CbComment, emoji: string): boolean;
+    /** "👍, 2: Ana López y tú". */
+    protected reactionLabel(r: CbCommentReaction): string;
+    protected canManage(c: CbComment): boolean;
+    protected isReplying(id: string): boolean;
+    protected isEditing(id: string): boolean;
+    protected isEdit(d: Draft): d is {
+        edit: string;
+    };
+    protected draftKey(d: Draft): string;
+    protected draftOf(d: Draft): string;
+    protected setDraft(d: Draft, html: string): void;
+    protected isEmpty(html: string): boolean;
+    protected placeholderOf(d: Draft): string;
+    protected editorLabel(d: Draft): string;
+    /** Ctrl / ⌘ + Enter envía; Escape cancela la respuesta o la edición (salvo que lo use el editor). */
+    protected onEditorKeydown(event: KeyboardEvent, d: Draft): void;
+    protected submit(d: Draft): void;
+    protected cancelDraft(d: Draft): void;
+    protected startReply(root: CbComment): void;
+    protected startEdit(c: CbComment): void;
+    protected askDelete(id: string): void;
+    protected cancelDelete(id: string): void;
+    protected confirmDelete(c: CbComment): void;
+    protected togglePicker(id: string): void;
+    protected closePicker(id: string, event?: Event): void;
+    /** El selector se cierra al salir de él con el teclado o el ratón. */
+    protected onPickerFocusOut(id: string, event: FocusEvent): void;
+    protected react(c: CbComment, emoji: string, fromPicker?: boolean): void;
+    private find;
+    private clearDraft;
+    /** 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<CbComments, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbComments, "cb-comments", never, { "comments": { "alias": "comments"; "required": false; "isSignal": true; }; "activity": { "alias": "activity"; "required": false; "isSignal": true; }; "currentUser": { "alias": "currentUser"; "required": false; "isSignal": true; }; "people": { "alias": "people"; "required": false; "isSignal": true; }; "mentions": { "alias": "mentions"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "order": { "alias": "order"; "required": false; "isSignal": true; }; "reactions": { "alias": "reactions"; "required": false; "isSignal": true; }; "replies": { "alias": "replies"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "composer": { "alias": "composer"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "editorHeight": { "alias": "editorHeight"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "comments": "commentsChange"; "filter": "filterChange"; "commentAdd": "commentAdd"; "commentEdit": "commentEdit"; "commentDelete": "commentDelete"; "reactionToggle": "reactionToggle"; }, never, never, true, never>;
+}
+
+export { CB_COMMENTS_TOOLBAR, CbComments, mentionIds as cbCommentMentions, removeComment as cbRemoveComment, toggleReaction as cbToggleReaction };
+export type { CbActivity, CbComment, CbCommentEvent, CbCommentPerson, CbCommentReaction, CbCommentReactionEvent, CbCommentsFilter };
+//# sourceMappingURL=caribeng-ui-comments.d.ts.map

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

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { CbConfirmSeverity } from '@caribeng/ui';
 
 /**
  * Diálogo de confirmación (`role="alertdialog"`) con trampa de foco, cierre con
@@ -16,10 +17,21 @@ import * as _caribeng_ui from '@caribeng/ui';
  *   (accepted)="eliminar()"
  * />
  * ```
+ *
+ * Con `service` muestra las confirmaciones pedidas desde código con
+ * `CbConfirmationService` (como `ConfirmationService` de PrimeNG):
+ *
+ * ```html
+ * <cb-confirm-dialog service />
+ * ```
+ * ```ts
+ * inject(CbConfirmationService).confirm({ message: '¿Eliminar?', accept: () => this.eliminar() });
+ * ```
  */
 declare class CbConfirmDialog {
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly document;
+    private readonly confirmation;
     /** Visibilidad (two-way). */
     readonly visible: _angular_core.ModelSignal<boolean>;
     /** Título. Por defecto, "Confirmar" del idioma activo. */
@@ -29,19 +41,39 @@ declare class CbConfirmDialog {
     readonly acceptLabel: _angular_core.InputSignal<string | undefined>;
     readonly rejectLabel: _angular_core.InputSignal<string | undefined>;
     /** Severidad del botón de aceptar (p. ej. `danger` para acciones destructivas). */
-    readonly acceptSeverity: _angular_core.InputSignal<"primary" | "danger" | "success" | "warning">;
+    readonly acceptSeverity: _angular_core.InputSignal<CbConfirmSeverity>;
+    /**
+     * Muestra las confirmaciones pedidas con `CbConfirmationService`. Sin él, el
+     * componente solo responde a `[(visible)]` (así un diálogo declarativo no se
+     * abre con las confirmaciones de otra parte de la app).
+     */
+    readonly service: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Con `service`: atiende solo las confirmaciones con este mismo `key` (o sin key si no se indica). */
+    readonly key: _angular_core.InputSignal<string | undefined>;
     readonly accepted: _angular_core.OutputEmitterRef<void>;
     readonly rejected: _angular_core.OutputEmitterRef<void>;
     protected readonly titleId: string;
     protected readonly messageId: string;
+    /** Confirmación pedida con `CbConfirmationService` que se está mostrando. */
+    private readonly active;
+    /** Textos visibles: los de la confirmación del servicio, si la hay; si no, los inputs y el idioma. */
+    protected readonly shown: _angular_core.Signal<{
+        header: string;
+        message: string;
+        acceptLabel: string;
+        rejectLabel: string;
+        acceptSeverity: CbConfirmSeverity;
+    }>;
     /** Elemento enfocado antes de abrir; recibe el foco de vuelta al cerrar. */
     private previouslyFocused;
     constructor();
     protected onEscape(): void;
     protected confirm(): void;
     protected reject(): void;
+    /** Cierra y, si venía del servicio, lo libera y ejecuta su callback (que puede pedir otra confirmación). */
+    private finish;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbConfirmDialog, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbConfirmDialog, "cb-confirm-dialog", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; "isSignal": true; }; "rejectLabel": { "alias": "rejectLabel"; "required": false; "isSignal": true; }; "acceptSeverity": { "alias": "acceptSeverity"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "accepted": "accepted"; "rejected": "rejected"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbConfirmDialog, "cb-confirm-dialog", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; "isSignal": true; }; "rejectLabel": { "alias": "rejectLabel"; "required": false; "isSignal": true; }; "acceptSeverity": { "alias": "acceptSeverity"; "required": false; "isSignal": true; }; "service": { "alias": "service"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "accepted": "accepted"; "rejected": "rejected"; }, never, never, true, never>;
 }
 
 export { CbConfirmDialog };

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

@@ -1,5 +1,6 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { CbConfirmSeverity } from '@caribeng/ui';
 
 /**
  * Confirmación breve de CaribeNG. Ábrela anclada al botón que la dispara con
@@ -11,12 +12,26 @@ import * as _caribeng_ui from '@caribeng/ui';
  * <cb-button severity="danger" (click)="borrar.confirm($event)">Eliminar</cb-button>
  * <cb-confirm-popup #borrar message="¿Eliminar este archivo?" (accepted)="eliminar()" />
  * ```
+ *
+ * Con `service` muestra las confirmaciones de `CbConfirmationService` que traen
+ * `target` (como `ConfirmationService` de PrimeNG):
+ *
+ * ```html
+ * <cb-button (click)="borrar($event)">Eliminar</cb-button>
+ * <cb-confirm-popup service />
+ * ```
+ * ```ts
+ * borrar(event: Event) {
+ *   inject(CbConfirmationService).confirm({ target: event.currentTarget, message: '¿Eliminar?', accept: () => this.eliminar() });
+ * }
+ * ```
  */
 declare class CbConfirmPopup {
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly overlay;
     private readonly vcr;
     private readonly injector;
+    private readonly confirmation;
     protected readonly messageId: string;
     /** Visibilidad (two-way). Con `[(visible)]` se muestra en línea. */
     readonly visible: _angular_core.ModelSignal<boolean>;
@@ -25,7 +40,15 @@ declare class CbConfirmPopup {
     readonly acceptLabel: _angular_core.InputSignal<string | undefined>;
     readonly rejectLabel: _angular_core.InputSignal<string | undefined>;
     /** Severidad del botón de aceptar (p. ej. `danger` para acciones destructivas). */
-    readonly acceptSeverity: _angular_core.InputSignal<"primary" | "danger" | "success" | "warning">;
+    readonly acceptSeverity: _angular_core.InputSignal<CbConfirmSeverity>;
+    /**
+     * Muestra las confirmaciones pedidas con `CbConfirmationService`. Sin él, el
+     * componente solo responde a `[(visible)]` (así un diálogo declarativo no se
+     * abre con las confirmaciones de otra parte de la app).
+     */
+    readonly service: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Con `service`: atiende solo las confirmaciones con este mismo `key` (o sin key si no se indica). */
+    readonly key: _angular_core.InputSignal<string | undefined>;
     readonly accepted: _angular_core.OutputEmitterRef<void>;
     readonly rejected: _angular_core.OutputEmitterRef<void>;
     private readonly panel;
@@ -33,6 +56,16 @@ declare class CbConfirmPopup {
     protected readonly anchored: _angular_core.WritableSignal<boolean>;
     private overlayRef;
     private trigger;
+    /** Confirmación pedida con `CbConfirmationService` que se está mostrando. */
+    private readonly active;
+    /** Textos visibles: los de la confirmación del servicio, si la hay; si no, los inputs y el idioma. */
+    protected readonly shown: _angular_core.Signal<{
+        message: string;
+        acceptLabel: string;
+        rejectLabel: string;
+        acceptSeverity: CbConfirmSeverity;
+    }>;
+    constructor();
     private readonly positions;
     /** Abre la confirmación anclada al elemento que recibió el evento. */
     confirm(event: Event): void;
@@ -40,9 +73,13 @@ declare class CbConfirmPopup {
     show(target: HTMLElement): void;
     protected accept(): void;
     protected reject(): void;
+    /** Cierra y, si venía del servicio, lo libera y ejecuta su callback (que puede pedir otra confirmación). */
+    private finish;
     private close;
+    /** Quita el overlay sin devolver el foco. */
+    private dispose;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbConfirmPopup, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbConfirmPopup, "cb-confirm-popup", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; "isSignal": true; }; "rejectLabel": { "alias": "rejectLabel"; "required": false; "isSignal": true; }; "acceptSeverity": { "alias": "acceptSeverity"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "accepted": "accepted"; "rejected": "rejected"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbConfirmPopup, "cb-confirm-popup", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; "isSignal": true; }; "rejectLabel": { "alias": "rejectLabel"; "required": false; "isSignal": true; }; "acceptSeverity": { "alias": "acceptSeverity"; "required": false; "isSignal": true; }; "service": { "alias": "service"; "required": false; "isSignal": true; }; "key": { "alias": "key"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "accepted": "accepted"; "rejected": "rejected"; }, never, never, true, never>;
 }
 
 export { CbConfirmPopup };

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

@@ -1,11 +1,16 @@
 import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
+import { CbMenuCommandEvent } from '@caribeng/ui';
 
 interface CbContextMenuItem {
     label: string;
     icon?: string;
     disabled?: boolean;
     separator?: boolean;
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbContextMenuItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Context menu that opens at the pointer position on right click. */
 declare class CbContextMenu {
@@ -15,6 +20,8 @@ declare class CbContextMenu {
     private readonly vcr;
     private readonly destroyRef;
     readonly items: _angular_core.InputSignal<readonly CbContextMenuItem[]>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbContextMenuItem[]>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbContextMenuItem>;
     private readonly content;

package/types/caribeng-ui-copy-button.d.ts

@@ -0,0 +1,90 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbSeverity, CbSize } from '@caribeng/ui';
+import { CbButtonVariant } from '@caribeng/ui/button';
+
+/**
+ * Botón que copia un texto al portapapeles y confirma con un ✓ durante unos
+ * segundos. El resultado se anuncia a los lectores de pantalla.
+ *
+ * @example
+ * ```html
+ * <span>0012 3456 7890</span> <cb-copy-button value="001234567890" />
+ * <cb-copy-button [value]="apiKey" showLabel variant="outlined" />
+ * ```
+ */
+declare class CbCopyButton {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly clipboard;
+    private timer;
+    /** Texto que se copia. */
+    readonly value: _angular_core.InputSignal<string | number | null | undefined>;
+    /** Muestra el texto ("Copiar" / "Copiado") junto al icono. */
+    readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Texto del botón y nombre accesible. Por defecto, "Copiar" del idioma activo. */
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    /** Texto tras copiar. Por defecto, "Copiado". */
+    readonly copiedLabel: _angular_core.InputSignal<string | undefined>;
+    /** Milisegundos que dura la confirmación. */
+    readonly timeout: _angular_core.InputSignal<number>;
+    readonly variant: _angular_core.InputSignal<CbButtonVariant>;
+    readonly severity: _angular_core.InputSignal<CbSeverity>;
+    readonly size: _angular_core.InputSignal<CbSize>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Texto copiado. */
+    readonly copied: _angular_core.OutputEmitterRef<string>;
+    /** El navegador no permitió copiar. */
+    readonly copyError: _angular_core.OutputEmitterRef<string>;
+    protected readonly state: _angular_core.WritableSignal<"idle" | "copied" | "error">;
+    protected readonly buttonLabel: _angular_core.Signal<string>;
+    protected readonly visibleLabel: _angular_core.Signal<string>;
+    protected readonly announcement: _angular_core.Signal<string>;
+    protected readonly iconSize: _angular_core.Signal<18 | 14 | 16>;
+    constructor();
+    /** Copia el valor y muestra la confirmación. Resuelve `true` si lo consiguió. */
+    copy(): Promise<boolean>;
+    private clearTimer;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCopyButton, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbCopyButton, "cb-copy-button", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "copiedLabel": { "alias": "copiedLabel"; "required": false; "isSignal": true; }; "timeout": { "alias": "timeout"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "copied": "copied"; "copyError": "copyError"; }, never, never, true, never>;
+}
+
+/**
+ * Copia un texto al portapapeles al pulsar el elemento (botón, enlace, icono…).
+ * Para el aviso visual usa `cb-copy-button`, o reacciona a `copied`.
+ *
+ * @example
+ * ```html
+ * <button type="button" [cbCopy]="cuenta" (copied)="toast.add({ summary: 'Copiado' })">Copiar</button>
+ * ```
+ */
+declare class CbCopy {
+    private readonly clipboard;
+    /** Texto que se copia. */
+    readonly cbCopy: _angular_core.InputSignal<string | number | null | undefined>;
+    /** Texto copiado. */
+    readonly copied: _angular_core.OutputEmitterRef<string>;
+    /** El navegador no permitió copiar. */
+    readonly copyError: _angular_core.OutputEmitterRef<string>;
+    /** Copia el texto. Resuelve `true` si lo consiguió. */
+    copy(): Promise<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCopy, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbCopy, "[cbCopy]", never, { "cbCopy": { "alias": "cbCopy"; "required": false; "isSignal": true; }; }, { "copied": "copied"; "copyError": "copyError"; }, never, never, true, never>;
+}
+
+/**
+ * Portapapeles de CaribeNG. Usa la API asíncrona del navegador y, si no está
+ * disponible (HTTP sin contexto seguro, navegadores antiguos), un textarea
+ * temporal con `execCommand('copy')`.
+ */
+declare class CbClipboard {
+    private readonly doc;
+    /** Copia `text`. Resuelve `true` si se copió y `false` si el navegador lo impidió. */
+    copy(text: string): Promise<boolean>;
+    private copyWithTextarea;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbClipboard, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<CbClipboard>;
+}
+
+export { CbClipboard, CbCopy, CbCopyButton };
+//# sourceMappingURL=caribeng-ui-copy-button.d.ts.map