@caribeng/ui 22.1.1 → 22.4.0

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

@@ -0,0 +1,299 @@
+import * as _caribeng_ui_chat from '@caribeng/ui/chat';
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/** Quién escribe el mensaje. */
+type CbChatRole = 'user' | 'assistant' | 'system';
+/** Estado de envío de un mensaje propio. */
+type CbChatStatus = 'sending' | 'sent' | 'error';
+/** Valoración de una respuesta. */
+type CbChatFeedback = 'up' | 'down' | null;
+/** Archivo adjunto a un mensaje. */
+interface CbChatAttachment {
+    readonly name: string;
+    /** Tipo MIME (`image/png`); las imágenes se muestran en miniatura. */
+    readonly type?: string;
+    /** Tamaño en bytes. */
+    readonly size?: number;
+    /** URL para ver o descargar (y la miniatura de las imágenes). */
+    readonly url?: string;
+}
+/**
+ * Mensaje de chat de CaribeNG: burbuja con autor, hora, avatar y estado de
+ * envío. `text` se pinta como markdown seguro y sus bloques de código con
+ * `cb-code-block` (resaltado y copiar). Admite adjuntos, valoración 👍/👎 y
+ * "Regenerar"; con `streaming` muestra un cursor mientras llega la respuesta.
+ * El contenido proyectado (p. ej. `cb-chat-reasoning`, `cb-chat-tool`) va
+ * antes del texto.
+ *
+ * @example
+ * ```html
+ * <cb-chat-message role="user" text="¿Cuál es mi saldo?" time="10:30" />
+ * <cb-chat-message role="assistant" [text]="respuesta" [streaming]="generando" copyable showFeedback [(feedback)]="voto" />
+ * ```
+ */
+declare class CbChatMessage {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    readonly role: _angular_core.InputSignal<CbChatRole>;
+    /** Contenido del mensaje (markdown por defecto). */
+    readonly text: _angular_core.InputSignal<string>;
+    /** Interpreta `text` como markdown seguro. Con `false` se muestra tal cual. */
+    readonly markdown: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nombre del autor. Por defecto, "Tú" o "Asistente". */
+    readonly author: _angular_core.InputSignal<string | undefined>;
+    /** Hora o fecha ya formateada ("10:30"). */
+    readonly time: _angular_core.InputSignal<string>;
+    /** Imagen del avatar. Sin ella, iniciales (usuario) o un icono (asistente). */
+    readonly avatar: _angular_core.InputSignal<string>;
+    readonly showAvatar: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showAuthor: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Estado de envío (mensajes propios). `error` muestra "Reintentar". */
+    readonly status: _angular_core.InputSignal<CbChatStatus | undefined>;
+    /** La respuesta sigue llegando: muestra un cursor y marca el mensaje como ocupado. */
+    readonly streaming: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Botón para copiar el texto (cuando termina de llegar). */
+    readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Archivos adjuntos (las imágenes con URL, en miniatura). */
+    readonly attachments: _angular_core.InputSignal<readonly CbChatAttachment[]>;
+    /** Muestra los botones 👍 / 👎. */
+    readonly showFeedback: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Valoración elegida (bidireccional). Pulsar la misma la quita. */
+    readonly feedback: _angular_core.ModelSignal<CbChatFeedback>;
+    /** Muestra el botón "Regenerar respuesta". */
+    readonly regenerable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Se pulsó "Reintentar" en un mensaje con error. */
+    readonly retry: _angular_core.OutputEmitterRef<void>;
+    /** Se pulsó "Regenerar respuesta". */
+    readonly regenerate: _angular_core.OutputEmitterRef<void>;
+    protected readonly blocks: _angular_core.Signal<_caribeng_ui_chat.CbMarkdownBlock[]>;
+    protected readonly authorName: _angular_core.Signal<string>;
+    protected readonly initials: _angular_core.Signal<string>;
+    protected readonly label: _angular_core.Signal<string | null>;
+    protected isImage(a: CbChatAttachment): boolean;
+    protected size(a: CbChatAttachment): string;
+    protected vote(value: 'up' | 'down'): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbChatMessage, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbChatMessage, "cb-chat-message", never, { "role": { "alias": "role"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "markdown": { "alias": "markdown"; "required": false; "isSignal": true; }; "author": { "alias": "author"; "required": false; "isSignal": true; }; "time": { "alias": "time"; "required": false; "isSignal": true; }; "avatar": { "alias": "avatar"; "required": false; "isSignal": true; }; "showAvatar": { "alias": "showAvatar"; "required": false; "isSignal": true; }; "showAuthor": { "alias": "showAuthor"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "showFeedback": { "alias": "showFeedback"; "required": false; "isSignal": true; }; "feedback": { "alias": "feedback"; "required": false; "isSignal": true; }; "regenerable": { "alias": "regenerable"; "required": false; "isSignal": true; }; }, { "feedback": "feedbackChange"; "retry": "retry"; "regenerate": "regenerate"; }, never, ["cb-chat-reasoning, cb-chat-tool, [cb-chat-message-before]", "*", "[cb-chat-message-actions]"], true, never>;
+}
+
+/**
+ * Lista de mensajes de chat de CaribeNG (`role="log"`). Se mantiene pegada al
+ * final mientras llegan mensajes o se alarga una respuesta en streaming, pero
+ * no mueve el scroll si el usuario subió a leer: entonces ofrece "Ir al último
+ * mensaje". Con `typing` muestra el indicador de escritura.
+ *
+ * Accesibilidad: con `busy` (respuesta generándose) el log se marca
+ * `aria-busy` para que el lector no lea cada fragmento, y al terminar se
+ * anuncia "Respuesta lista".
+ *
+ * @example
+ * ```html
+ * <cb-chat-messages [busy]="generando()" [typing]="pensando()" style="height: 30rem">
+ *   @for (m of mensajes(); track m.id) {
+ *     <cb-chat-message [role]="m.role" [text]="m.text" />
+ *   }
+ * </cb-chat-messages>
+ * ```
+ */
+declare class CbChatMessages {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly document;
+    private readonly destroyRef;
+    private readonly scroller;
+    private readonly content;
+    /** Una respuesta se está generando (marca el log como ocupado). */
+    readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra el indicador "Escribiendo…". */
+    readonly typing: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Texto del indicador (p. ej. "Laura está escribiendo…"). */
+    readonly typingLabel: _angular_core.InputSignal<string | undefined>;
+    /** Nombre del log. Por defecto, "Conversación". */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** La vista está en el final (sigue los mensajes nuevos). */
+    readonly pinned: _angular_core.WritableSignal<boolean>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private wasBusy;
+    constructor();
+    protected onScroll(): void;
+    /** Lleva la vista al último mensaje y vuelve a seguir los nuevos. */
+    scrollToBottom(smooth?: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbChatMessages, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbChatMessages, "cb-chat-messages", never, { "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "typing": { "alias": "typing"; "required": false; "isSignal": true; }; "typingLabel": { "alias": "typingLabel"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/** Mensaje que el usuario envía. */
+interface CbChatSendEvent {
+    readonly text: string;
+    readonly files: readonly File[];
+}
+/**
+ * Campo para escribir mensajes (prompt) de CaribeNG: crece con el texto hasta
+ * `maxRows`, envía con Enter (Shift + Enter = salto de línea, respetando la
+ * composición de teclados asiáticos), adjunta archivos (botón, pegar o
+ * arrastrar), muestra sugerencias y, mientras se genera una respuesta, cambia
+ * "Enviar" por "Detener".
+ *
+ * @example
+ * ```html
+ * <cb-chat-input [streaming]="generando()" attachments (send)="enviar($event)" (stop)="detener()" />
+ * ```
+ */
+declare class CbChatInput {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly injector;
+    private readonly textarea;
+    protected readonly inputId: string;
+    /** Texto escrito (bidireccional). */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Archivos adjuntos (bidireccional). */
+    readonly files: _angular_core.ModelSignal<readonly File[]>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    /** Nombre del campo. Por defecto, "Mensaje". */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Se está generando una respuesta: muestra "Detener" y no deja enviar. */
+    readonly streaming: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Permite adjuntar archivos (botón, pegar o arrastrar). */
+    readonly attachments: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Tipos aceptados (`image/*,.pdf`). */
+    readonly accept: _angular_core.InputSignal<string>;
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Máximo de caracteres, con contador. 0 = sin límite. */
+    readonly maxLength: _angular_core.InputSignal<number>;
+    /** Filas máximas antes de hacer scroll. */
+    readonly maxRows: _angular_core.InputSignal<number>;
+    /** Enter envía (Shift + Enter, salto de línea). Con `false`, Ctrl/⌘ + Enter envía. */
+    readonly submitOnEnter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Vacía el campo y los adjuntos al enviar. */
+    readonly clearOnSend: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Sugerencias de inicio (se muestran con el campo vacío; al pulsar, se envían). */
+    readonly suggestions: _angular_core.InputSignal<readonly string[]>;
+    /** El usuario envió un mensaje. */
+    readonly send: _angular_core.OutputEmitterRef<CbChatSendEvent>;
+    /** El usuario pidió detener la respuesta. */
+    readonly stop: _angular_core.OutputEmitterRef<void>;
+    protected readonly dragging: _angular_core.WritableSignal<boolean>;
+    protected readonly canSend: _angular_core.Signal<boolean>;
+    /** URLs temporales de las miniaturas, por archivo. */
+    private readonly previews;
+    constructor();
+    /** Miniatura de una imagen adjunta (`null` si no es imagen o el navegador no la admite). */
+    protected preview(file: File): string | null;
+    /** Enfoca el campo. */
+    focus(): void;
+    /** Envía el mensaje si hay texto o adjuntos. */
+    submit(): void;
+    protected size(file: File): string;
+    protected onInput(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected useSuggestion(text: string): void;
+    protected onFilesChosen(event: Event): void;
+    protected onPaste(event: ClipboardEvent): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    protected removeFile(index: number): void;
+    private addFiles;
+    private isAccepted;
+    private resize;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbChatInput, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbChatInput, "cb-chat-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "files": { "alias": "files"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "submitOnEnter": { "alias": "submitOnEnter"; "required": false; "isSignal": true; }; "clearOnSend": { "alias": "clearOnSend"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "files": "filesChange"; "send": "send"; "stop": "stop"; }, never, never, true, never>;
+}
+
+/**
+ * Razonamiento del modelo ("Pensando…"), plegable. Mientras llega se abre y
+ * muestra un brillo; al terminar se pliega solo (`autoCollapse`) y resume
+ * "Razonó durante N s". El texto admite markdown seguro.
+ *
+ * @example
+ * ```html
+ * <cb-chat-reasoning [text]="m.reasoning" [streaming]="m.pensando" [duration]="m.segundos" />
+ * ```
+ */
+declare class CbChatReasoning {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly uid: string;
+    /** Texto del razonamiento (markdown). */
+    readonly text: _angular_core.InputSignal<string>;
+    /** El razonamiento sigue llegando. */
+    readonly streaming: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Segundos que duró (se muestra al terminar). */
+    readonly duration: _angular_core.InputSignal<number | undefined>;
+    /** Desplegado. */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    /** Se abre mientras llega y se pliega al terminar. */
+    readonly autoCollapse: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected readonly html: _angular_core.Signal<string>;
+    protected readonly summary: _angular_core.Signal<string>;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbChatReasoning, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbChatReasoning, "cb-chat-reasoning", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "duration": { "alias": "duration"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "autoCollapse": { "alias": "autoCollapse"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
+}
+
+/** Estado de una llamada a herramienta. */
+type CbChatToolStatus = 'running' | 'done' | 'error';
+/**
+ * Llamada a una herramienta (función) del asistente: nombre, estado
+ * ("Usando buscar_movimientos…", "Usó…", "Falló…") y, al desplegar, la
+ * entrada y el resultado como JSON resaltado.
+ *
+ * @example
+ * ```html
+ * <cb-chat-tool name="buscar_movimientos" status="done" [input]="{ cuenta: '4829' }" [output]="resultado" />
+ * ```
+ */
+declare class CbChatTool {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly uid: string;
+    /** Nombre de la herramienta (`buscar_movimientos`). */
+    readonly name: _angular_core.InputSignal<string>;
+    /** Texto que sustituye al nombre en la cabecera ("Buscando movimientos"). */
+    readonly title: _angular_core.InputSignal<string>;
+    readonly status: _angular_core.InputSignal<CbChatToolStatus>;
+    /** Argumentos (objeto o JSON). */
+    readonly input: _angular_core.InputSignal<unknown>;
+    /** Resultado (objeto, JSON o texto). */
+    readonly output: _angular_core.InputSignal<unknown>;
+    /** Desplegado. */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    protected readonly shownInput: _angular_core.Signal<{
+        code: string;
+        language: string;
+    } | null>;
+    protected readonly shownOutput: _angular_core.Signal<{
+        code: string;
+        language: string;
+    } | null>;
+    protected readonly label: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbChatTool, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbChatTool, "cb-chat-tool", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "input": { "alias": "input"; "required": false; "isSignal": true; }; "output": { "alias": "output"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
+}
+
+/** URL permitida en un enlace, o `null`. */
+declare function cbSafeUrl(url: string): string | null;
+/** Trozo de un mensaje: HTML seguro o un bloque de código para pintar aparte. */
+type CbMarkdownBlock = {
+    readonly kind: 'html';
+    readonly html: string;
+} | {
+    readonly kind: 'code';
+    readonly code: string;
+    readonly language: string;
+};
+/** Convierte markdown en HTML seguro (todo el HTML de entrada se escapa). */
+declare function cbMarkdownToHtml(markdown: string): string;
+/**
+ * Como `cbMarkdownToHtml`, pero separa los bloques de código del nivel
+ * superior para pintarlos con un componente (resaltado, copiar).
+ */
+declare function cbMarkdownToBlocks(markdown: string): CbMarkdownBlock[];
+
+export { CbChatInput, CbChatMessage, CbChatMessages, CbChatReasoning, CbChatTool, cbMarkdownToBlocks, cbMarkdownToHtml, cbSafeUrl };
+export type { CbChatAttachment, CbChatFeedback, CbChatRole, CbChatSendEvent, CbChatStatus, CbChatToolStatus, CbMarkdownBlock };
+//# sourceMappingURL=caribeng-ui-chat.d.ts.map

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

@@ -1,10 +1,16 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 /**
  * Chip de CaribeNG: píldora compacta para representar entidades, filtros o etiquetas
  * individuales con imagen, icono y botón de cierre opcional.
  */
 declare class CbChip {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly label: _angular_core.InputSignal<string>;
     readonly icon: _angular_core.InputSignal<string>;
     readonly image: _angular_core.InputSignal<string>;

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

@@ -1,6 +1,6 @@
-import * as _caribeng_ui from '@caribeng/ui';
-import { CbSize } from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat, CbSize } from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
@@ -13,6 +13,10 @@ import { ControlValueAccessor } from '@angular/forms';
  * ```
  */
 declare class CbChips implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly value: _angular_core.ModelSignal<string[]>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<CbSize>;

package/types/caribeng-ui-code-block.d.ts

@@ -0,0 +1,65 @@
+import * as _caribeng_ui_code_block from '@caribeng/ui/code-block';
+import * as _angular_core from '@angular/core';
+
+/**
+ * Bloque de código de CaribeNG con resaltado de sintaxis propio (sin
+ * dependencias), nombre de archivo o lenguaje, botón de copiar, números de
+ * línea y líneas destacadas. Sigue el tema claro u oscuro.
+ *
+ * El código se pinta como texto (tokens), nunca como HTML.
+ *
+ * @example
+ * ```html
+ * <cb-code-block language="ts" filename="app.config.ts" [code]="codigo" lineNumbers highlightLines="3-4" />
+ * ```
+ */
+declare class CbCodeBlock {
+    /** Código a mostrar. */
+    readonly code: _angular_core.InputSignal<string>;
+    /** Lenguaje (`ts`, `html`, `css`, `json`, `bash`, `python`, `sql`…). Desconocido = texto. */
+    readonly language: _angular_core.InputSignal<string>;
+    /** Nombre de archivo en la cabecera (en lugar del lenguaje). */
+    readonly filename: _angular_core.InputSignal<string>;
+    readonly lineNumbers: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Número de la primera línea. */
+    readonly startLine: _angular_core.InputSignal<number>;
+    /** Líneas destacadas: `"2,5-7"` o `[2, 5, 6, 7]`. */
+    readonly highlightLines: _angular_core.InputSignal<string | readonly number[]>;
+    /** Parte las líneas largas en lugar de hacer scroll horizontal. */
+    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra la cabecera (lenguaje o archivo y copiar). */
+    readonly header: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Alto máximo con scroll (`20rem`). */
+    readonly maxHeight: _angular_core.InputSignal<string>;
+    /** Nombre del bloque. Por defecto, el archivo o el lenguaje. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Tokens por línea (sin la línea vacía final que deja un salto de línea al terminar). */
+    protected readonly lines: _angular_core.Signal<_caribeng_ui_code_block.CbCodeToken[][]>;
+    protected readonly highlighted: _angular_core.Signal<ReadonlySet<number>>;
+    protected readonly languageLabel: _angular_core.Signal<string>;
+    protected readonly showHeader: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCodeBlock, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbCodeBlock, "cb-code-block", never, { "code": { "alias": "code"; "required": false; "isSignal": true; }; "language": { "alias": "language"; "required": false; "isSignal": true; }; "filename": { "alias": "filename"; "required": false; "isSignal": true; }; "lineNumbers": { "alias": "lineNumbers"; "required": false; "isSignal": true; }; "startLine": { "alias": "startLine"; "required": false; "isSignal": true; }; "highlightLines": { "alias": "highlightLines"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+type CbCodeTokenType = 'plain' | 'keyword' | 'builtin' | 'string' | 'number' | 'comment' | 'function' | 'operator' | 'punctuation' | 'tag' | 'attr' | 'property' | 'variable';
+interface CbCodeToken {
+    readonly type: CbCodeTokenType;
+    readonly text: string;
+}
+/** Nombre visible de un lenguaje ("ts" → "TypeScript"). */
+declare function cbCodeLanguageLabel(language: string): string;
+/** Si hay reglas de resaltado para el lenguaje. */
+declare function cbCodeSupports(language: string): boolean;
+/**
+ * Tokeniza `code` y lo reparte en líneas (los comentarios y strings de varias
+ * líneas se parten en cada salto). Lenguaje desconocido = texto plano.
+ */
+declare function cbHighlight(code: string, language?: string): CbCodeToken[][];
+/** Interpreta `"1,3-5"` o `[1, 3, 4, 5]` como conjunto de números de línea. */
+declare function cbParseLineSet(value: string | readonly number[] | null | undefined): ReadonlySet<number>;
+
+export { CbCodeBlock, cbCodeLanguageLabel, cbCodeSupports, cbHighlight, cbParseLineSet };
+export type { CbCodeToken, CbCodeTokenType };
+//# sourceMappingURL=caribeng-ui-code-block.d.ts.map

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

@@ -1,6 +1,6 @@
-import * as _caribeng_ui from '@caribeng/ui';
-import { CbSize } from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat, CbSize } from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 import { ConnectedPosition } from '@angular/cdk/overlay';
 
@@ -15,6 +15,10 @@ import { ConnectedPosition } from '@angular/cdk/overlay';
  * ```
  */
 declare class CbColorPicker implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly injector;
     /** Color seleccionado (hex `#rrggbb`). Two-way opcional fuera de Forms. */
     readonly value: _angular_core.ModelSignal<string>;
     readonly size: _angular_core.InputSignal<CbSize>;
@@ -48,6 +52,8 @@ declare class CbColorPicker implements ControlValueAccessor {
     protected toggle(): void;
     protected close(): void;
     protected onOverlayKeydown(event: KeyboardEvent): void;
+    protected onSvKeydown(event: KeyboardEvent): void;
+    protected onHueKeydown(event: KeyboardEvent): void;
     protected onSvPointerDown(event: PointerEvent): void;
     protected onHuePointerDown(event: PointerEvent): void;
     private drag;

package/types/caribeng-ui-command-palette.d.ts

@@ -0,0 +1,133 @@
+import * as _caribeng_ui_command_palette from '@caribeng/ui/command-palette';
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Acción o página de la paleta de comandos. */
+interface CbCommandItem {
+    /** Identificador estable (para `track`). Por defecto, el `label`. */
+    id?: string;
+    label: string;
+    /** Texto secundario bajo el label. */
+    description?: string;
+    icon?: string;
+    /** Grupo en el que se muestra ("Páginas", "Acciones"…). */
+    group?: string;
+    /** Sinónimos que también encuentran el item (no se muestran). */
+    keywords?: readonly string[];
+    /** Atajo que se muestra a la derecha, en el formato de `cb-kbd` (`['mod', 'S']`). */
+    shortcut?: readonly string[];
+    disabled?: boolean;
+    /** Acción al elegirlo (además del evento `itemSelect`). */
+    command?: (event: CbCommandSelectEvent) => void;
+}
+/** Item elegido en la paleta. */
+interface CbCommandSelectEvent {
+    readonly item: CbCommandItem;
+    /** Texto buscado en ese momento. */
+    readonly query: string;
+    readonly originalEvent?: Event;
+}
+/** Grupo de resultados ya filtrados y ordenados. */
+interface CbCommandGroup {
+    readonly label: string;
+    readonly items: readonly CbCommandItem[];
+}
+/** Minúsculas y sin tildes, carácter a carácter (conserva las posiciones). */
+declare function cbCommandNormalize(text: string): string;
+/**
+ * Relevancia de `item` para `query` (0 = no coincide). Prioriza el label que
+ * empieza por la búsqueda, luego el inicio de una palabra, el texto contenido,
+ * los sinónimos y la descripción, y por último las letras en orden ("cfg" → "Configuración").
+ */
+declare function cbCommandScore(item: CbCommandItem, query: string): number;
+/**
+ * Filtra, ordena y agrupa los items. Sin búsqueda conserva el orden original;
+ * con búsqueda ordena por relevancia y los grupos siguen a su mejor resultado.
+ */
+declare function cbCommandFilter(items: readonly CbCommandItem[], query: string, filter?: boolean): CbCommandGroup[];
+/** Partes del label para resaltar la coincidencia contigua con la búsqueda. */
+declare function cbCommandHighlight(label: string, query: string): {
+    text: string;
+    match: boolean;
+}[];
+
+/**
+ * Paleta de comandos de CaribeNG (Ctrl/⌘ + K): buscador global de páginas y
+ * acciones con teclado. Filtra sin tildes ni mayúsculas, agrupa, resalta la
+ * coincidencia y muestra atajos con `cb-kbd`.
+ *
+ * Accesibilidad: diálogo modal con un combobox (`aria-activedescendant`) que
+ * controla una lista de opciones; el foco no sale del campo y vuelve al
+ * elemento anterior al cerrar.
+ *
+ * @example
+ * ```html
+ * <cb-command-palette [items]="comandos" (itemSelect)="ir($event.item)" />
+ * ```
+ */
+declare class CbCommandPalette {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly document;
+    private readonly injector;
+    private readonly tpl;
+    private readonly inputEl;
+    private overlayRef;
+    private previouslyFocused;
+    protected readonly listId: string;
+    /** Páginas y acciones. */
+    readonly items: _angular_core.InputSignal<readonly CbCommandItem[]>;
+    /** Abierta o cerrada. */
+    readonly visible: _angular_core.ModelSignal<boolean>;
+    /** Texto buscado (bidireccional, para búsquedas en servidor). */
+    readonly query: _angular_core.ModelSignal<string>;
+    /** Atajo global que abre o cierra la paleta. `''` lo desactiva. */
+    readonly shortcut: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    /** Mensaje sin resultados. Por defecto, "Sin resultados". */
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Nombre del diálogo. Por defecto, "Paleta de comandos". */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Filtra `items` con la búsqueda. Desactívalo si los resultados llegan ya filtrados (servidor). */
+    readonly filter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra "Cargando" mientras no hay resultados. */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Cierra la paleta al elegir un item. */
+    readonly closeOnSelect: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Item elegido (con clic o Enter). */
+    readonly itemSelect: _angular_core.OutputEmitterRef<CbCommandSelectEvent>;
+    protected readonly label: _angular_core.Signal<string>;
+    protected readonly groups: _angular_core.Signal<_caribeng_ui_command_palette.CbCommandGroup[]>;
+    /** Resultados en el orden en que se muestran (para el teclado). */
+    protected readonly flat: _angular_core.Signal<CbCommandItem[]>;
+    private readonly enabled;
+    protected readonly activeItem: _angular_core.WritableSignal<CbCommandItem | null>;
+    protected readonly activeOptionId: _angular_core.Signal<string | null>;
+    protected readonly announcement: _angular_core.Signal<string>;
+    constructor();
+    open(): void;
+    close(): void;
+    toggle(): void;
+    protected optionId(item: CbCommandItem): string;
+    protected highlight(item: CbCommandItem): {
+        text: string;
+        match: boolean;
+    }[];
+    protected onDocumentKeydown(event: KeyboardEvent): void;
+    protected onInput(event: Event): void;
+    protected hover(item: CbCommandItem): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    /** Elige un item: ejecuta su `command`, emite `itemSelect` y cierra (según `closeOnSelect`). */
+    select(item: CbCommandItem, originalEvent?: Event): void;
+    private setActive;
+    private attach;
+    private detach;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbCommandPalette, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbCommandPalette, "cb-command-palette", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "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; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "query": "queryChange"; "itemSelect": "itemSelect"; }, never, never, true, never>;
+}
+
+export { CbCommandPalette, cbCommandFilter, cbCommandHighlight, cbCommandNormalize, cbCommandScore };
+export type { CbCommandGroup, CbCommandItem, CbCommandSelectEvent };
+//# sourceMappingURL=caribeng-ui-command-palette.d.ts.map