@caribeng/ui 22.2.0 → 22.4.0

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

@@ -0,0 +1,783 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef, TemplateRef } from '@angular/core';
+import { CdkDrag, CdkDropList, CdkDragDrop } from '@angular/cdk/drag-drop';
+import { CbMenuItem } from '@caribeng/ui/menu';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+import { CbChartType, CbChartData } from '@caribeng/ui/chart';
+import { CbEditorTool } from '@caribeng/ui/editor';
+
+/** Persona que se puede asignar a una tarea. */
+interface CbKanbanPerson {
+    readonly id: string;
+    readonly name: string;
+    /** Foto (si no hay, se muestran las iniciales). */
+    readonly image?: string;
+}
+/** Nivel de prioridad. `severity` da el color de la etiqueta. */
+interface CbKanbanPriority {
+    readonly id: string;
+    readonly label: string;
+    readonly severity?: 'secondary' | 'info' | 'success' | 'warning' | 'danger';
+}
+/** Archivo adjunto a una tarea. Los recién añadidos llevan `file` (para subirlo) y una `url` local. */
+interface CbKanbanAttachment {
+    readonly id: string;
+    readonly name: string;
+    /** Tamaño en bytes. */
+    readonly size?: number;
+    /** Tipo MIME. */
+    readonly type?: string;
+    /** Enlace para abrir o descargar el archivo. */
+    readonly url?: string;
+    /** Archivo elegido en el navegador (solo en los adjuntos nuevos). */
+    readonly file?: File;
+}
+/**
+ * Campos que entiende el panel de detalle y la tarjeta por defecto. Todos son
+ * opcionales salvo el id y el título (sus nombres los fijan `itemKey` e `itemLabel`).
+ * Las fechas se guardan como `'AAAA-MM-DD'` (también se aceptan `Date`).
+ */
+interface CbKanbanTask {
+    readonly id: string | number;
+    readonly title: string;
+    readonly description?: string;
+    /** Ids de las personas responsables (de `people`). */
+    readonly assignees?: readonly string[];
+    /** Id de la prioridad (de `priorities`). */
+    readonly priority?: string | null;
+    readonly startDate?: string | Date | null;
+    readonly endDate?: string | Date | null;
+    readonly attachments?: readonly CbKanbanAttachment[];
+    /** Tarea finalizada (la lista la marca con ✓ y el panel de resumen la cuenta). */
+    readonly completed?: boolean;
+}
+/** Cambios que el panel aplica a una tarea. */
+type CbKanbanTaskPatch = Partial<Omit<CbKanbanTask, 'id'>> & Record<string, unknown>;
+/** Iniciales de un nombre ("Laura Gómez" → "LG"). */
+declare function initials(name: string): string;
+
+/** Columna del tablero (en la lista, una sección). */
+interface CbKanbanColumn<T = any> {
+    readonly id: string;
+    readonly title: string;
+    readonly items: readonly T[];
+    /** Límite de tarjetas (WIP). Se avisa al superarlo; con `enforceLimit` no deja pasarlo. */
+    readonly limit?: number;
+    /** Color de la columna (borde superior). */
+    readonly color?: string;
+}
+/** Tarjeta movida (con ratón, dedo, teclado o el menú "Mover a"). */
+interface CbKanbanMove<T = any> {
+    readonly item: T;
+    readonly from: string;
+    readonly to: string;
+    readonly fromIndex: number;
+    readonly toIndex: number;
+}
+/** Tarjeta creada, editada o eliminada. */
+interface CbKanbanCardEvent<T = any> {
+    readonly item: T;
+    /** Id de la columna. */
+    readonly column: string;
+    readonly index: number;
+    /** Al editar, la tarjeta antes del cambio. */
+    readonly previous?: T;
+}
+/** Columna creada, renombrada o eliminada. */
+interface CbKanbanColumnEvent {
+    readonly column: CbKanbanColumn;
+    /** Al renombrar, el título anterior. */
+    readonly previousTitle?: string;
+}
+/**
+ * Base común de las vistas de tareas (tablero, lista…). Todas leen y escriben el
+ * mismo `[(columns)]` sin copia propia, así que varias vistas enlazadas a la misma
+ * señal se pueden mostrar a la vez y siempre están al día.
+ */
+declare abstract class CbKanbanView {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    protected readonly host: ElementRef<HTMLElement>;
+    private readonly injector;
+    /** Columnas con sus tarjetas (bidireccional: se actualiza al mover, crear, editar o eliminar). */
+    readonly columns: _angular_core.ModelSignal<readonly CbKanbanColumn<any>[]>;
+    /** Propiedad que identifica cada tarjeta. */
+    readonly itemKey: _angular_core.InputSignal<string>;
+    /** Propiedad con el nombre de la tarjeta (tarjeta por defecto, edición y anuncios). */
+    readonly itemLabel: _angular_core.InputSignal<string>;
+    /** No deja superar el `limit` de una columna. */
+    readonly enforceLimit: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Las tareas se editan (en el tablero, menú ⋮ y atajos F2 / Supr). */
+    readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Se pueden añadir tareas. */
+    readonly addable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Las columnas se renombran, se eliminan y se añaden. */
+    readonly columnsEditable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Las columnas se pueden contraer. */
+    readonly collapsible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Pide confirmación antes de eliminar (tarjetas, y columnas con tarjetas). */
+    readonly confirmDelete: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Crea la tarjeta nueva a partir del título. Por defecto, `{ [itemKey]: id, [itemLabel]: título }`. */
+    readonly createCard: _angular_core.InputSignal<((title: string, columnId: string) => any) | null>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Texto de una columna vacía. Por defecto, "Sin datos". */
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Nombre de la vista. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Al abrir una tarea (clic o Enter) se muestra el panel de detalle. */
+    readonly details: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Personas que se pueden asignar (campo `assignees` con sus ids). */
+    readonly people: _angular_core.InputSignal<readonly CbKanbanPerson[]>;
+    /** Niveles de prioridad (campo `priority` con su id). Por defecto: baja, media y alta. */
+    readonly priorities: _angular_core.InputSignal<readonly CbKanbanPriority[] | null>;
+    /** Tipos de archivo admitidos en los adjuntos (atributo `accept`, p. ej. `'image/*,.pdf'`). */
+    readonly accept: _angular_core.InputSignal<string>;
+    /** Tarjeta movida (al soltarla o con "Mover a"). */
+    readonly cardMove: _angular_core.OutputEmitterRef<CbKanbanMove<any>>;
+    /** Se pulsó (o Enter sobre) una tarjeta. */
+    readonly cardOpen: _angular_core.OutputEmitterRef<any>;
+    /** Tarjeta creada. */
+    readonly cardAdd: _angular_core.OutputEmitterRef<CbKanbanCardEvent<any>>;
+    /** Tarjeta editada: título, o cualquier campo desde el panel de detalle (`previous` es la tarjeta anterior). */
+    readonly cardEdit: _angular_core.OutputEmitterRef<CbKanbanCardEvent<any>>;
+    /** Tarjeta eliminada. */
+    readonly cardDelete: _angular_core.OutputEmitterRef<CbKanbanCardEvent<any>>;
+    /** Columna añadida. */
+    readonly columnAdd: _angular_core.OutputEmitterRef<CbKanbanColumnEvent>;
+    /** Columna renombrada. */
+    readonly columnRename: _angular_core.OutputEmitterRef<CbKanbanColumnEvent>;
+    /** Columna eliminada (con sus tarjetas). */
+    readonly columnDelete: _angular_core.OutputEmitterRef<CbKanbanColumnEvent>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private readonly detailKey;
+    /** @internal */
+    readonly detailOpen: _angular_core.WritableSignal<boolean>;
+    /** @internal La tarea abierta en el panel, siempre en su versión actual. */
+    readonly detailTask: _angular_core.Signal<any>;
+    /** @internal */
+    readonly detailColumnId: _angular_core.Signal<string>;
+    /** @internal */
+    readonly resolvedPriorities: _angular_core.Signal<readonly CbKanbanPriority[]>;
+    /** Lleva el foco a la tarea con esa clave (tras el render). */
+    protected abstract focusItem(key: unknown): void;
+    protected readonly initialsOf: typeof initials;
+    protected key(item: unknown): unknown;
+    protected keyAttr(item: unknown): string;
+    protected label(item: unknown): string;
+    protected field(item: unknown, name: string): unknown;
+    /** La descripción puede ser HTML (del editor): fuera del panel va como texto. */
+    protected plain(html: unknown): string;
+    protected priorityOf(item: unknown): CbKanbanPriority | undefined;
+    protected peopleOf(item: unknown): CbKanbanPerson[];
+    protected names(people: readonly CbKanbanPerson[]): string;
+    protected dateLabel(item: unknown): string;
+    /** La fecha de fin ya pasó (las tareas finalizadas no vencen). */
+    protected isOverdue(item: unknown): boolean;
+    protected isCompleted(item: unknown): boolean;
+    protected attachmentCount(item: unknown): number;
+    protected isFull(col: CbKanbanColumn): boolean;
+    protected isOver(col: CbKanbanColumn): boolean;
+    /** Copia de las columnas con listas mutables (para cambiarlas y publicar el resultado). */
+    protected cloneColumns(): (CbKanbanColumn & {
+        items: unknown[];
+    })[];
+    /** Mueve una tarjeta (de forma inmutable) y devuelve las columnas nuevas. */
+    protected moved(columns: readonly CbKanbanColumn[], from: number, fromIndex: number, to: number, toIndex: number): CbKanbanColumn[];
+    protected columnIndexOf(item: unknown): number;
+    protected indexOf(item: unknown): number;
+    protected moveCard(from: number, fromIndex: number, to: number, toIndex: number, focus?: boolean): void;
+    /** Aplica cambios a una tarjeta (emite `cardEdit`). */
+    updateTask(item: unknown, patch: CbKanbanTaskPatch): void;
+    /** Mueve una tarjeta al final de otra columna. */
+    moveTask(item: unknown, columnId: string): void;
+    /** Elimina una tarjeta (emite `cardDelete`). */
+    protected deleteCard(column: number, index: number): void;
+    /** Tras eliminar: cada vista decide a dónde va el foco. */
+    protected afterDelete(_columns: readonly CbKanbanColumn[], _column: number, _index: number): void;
+    /**
+     * Añade una tarjeta al final de la columna (`createCard` decide su forma) con los
+     * campos de `extra` (p. ej. las fechas del día en el calendario). Devuelve la tarjeta.
+     */
+    addCard(columnId: string, title: string, extra?: CbKanbanTaskPatch): unknown;
+    /** Crea una columna vacía al final y la devuelve. */
+    protected appendColumn(title: string): CbKanbanColumn;
+    protected renameColumnTo(col: CbKanbanColumn, title: string): void;
+    protected removeColumn(col: CbKanbanColumn): void;
+    protected openCard(item: unknown): void;
+    /** Abre el panel de detalle de una tarjeta. */
+    openDetails(item: unknown): void;
+    /** Cierra el panel de detalle. */
+    closeDetails(): void;
+    /** @internal */
+    onDetailsHidden(): void;
+    /** @internal */
+    removeFromDetails(item: unknown): void;
+    protected afterRender(fn: () => void): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanView, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbKanbanView, never, never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "itemKey": { "alias": "itemKey"; "required": false; "isSignal": true; }; "itemLabel": { "alias": "itemLabel"; "required": false; "isSignal": true; }; "enforceLimit": { "alias": "enforceLimit"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "addable": { "alias": "addable"; "required": false; "isSignal": true; }; "columnsEditable": { "alias": "columnsEditable"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "confirmDelete": { "alias": "confirmDelete"; "required": false; "isSignal": true; }; "createCard": { "alias": "createCard"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "details": { "alias": "details"; "required": false; "isSignal": true; }; "people": { "alias": "people"; "required": false; "isSignal": true; }; "priorities": { "alias": "priorities"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; }, { "columns": "columnsChange"; "cardMove": "cardMove"; "cardOpen": "cardOpen"; "cardAdd": "cardAdd"; "cardEdit": "cardEdit"; "cardDelete": "cardDelete"; "columnAdd": "columnAdd"; "columnRename": "columnRename"; "columnDelete": "columnDelete"; }, never, never, true, never>;
+}
+
+interface CbKanbanCardContext<T = any> {
+    $implicit: T;
+    column: CbKanbanColumn<T>;
+    index: number;
+}
+/** Plantilla de las tarjetas: `<ng-template cbKanbanCard let-item let-column="column">`. */
+declare class CbKanbanCardDirective {
+    readonly template: TemplateRef<CbKanbanCardContext<any>>;
+    static ngTemplateContextGuard(_dir: CbKanbanCardDirective, ctx: unknown): ctx is CbKanbanCardContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanCardDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbKanbanCardDirective, "ng-template[cbKanbanCard]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Tablero Kanban de CaribeNG. Las tarjetas se reordenan y se mueven entre
+ * columnas arrastrando (ratón o dedo, con `@angular/cdk/drag-drop`; toda la
+ * columna es zona de soltar y el tablero se desplaza solo hacia las columnas
+ * ocultas) o con el teclado (Espacio toma, flechas mueven, Espacio suelta,
+ * Escape cancela), con cada paso anunciado.
+ *
+ * Con `editable` cada tarjeta tiene un menú ⋮ (editar, mover a otra columna,
+ * eliminar) y atajos (F2 edita, Supr elimina); con `addable`, un campo para
+ * añadir tarjetas al pie de cada columna; con `columnsEditable`, las columnas se
+ * renombran, se eliminan y se añaden; con `collapsible`, se contraen.
+ *
+ * Con `details`, al abrir una tarjeta aparece un panel lateral para editar la
+ * tarea completa: columna, responsables (`people`), prioridad (`priorities`),
+ * fechas de inicio y fin, descripción y adjuntos (ver `CbKanbanTask`). La
+ * tarjeta por defecto muestra la prioridad, las fechas, los adjuntos y los
+ * responsables.
+ *
+ * @example
+ * ```html
+ * <cb-kanban [(columns)]="columnas" editable addable columnsEditable (cardMove)="guardar($event)">
+ *   <ng-template cbKanbanCard let-tarea>{{ tarea.title }}</ng-template>
+ * </cb-kanban>
+ * ```
+ */
+declare class CbKanban extends CbKanbanView {
+    private readonly menu;
+    protected readonly uid: string;
+    private readonly cardDirective;
+    /**
+     * Plantilla de las tarjetas pasada como input, para cuando el tablero lo pinta
+     * otro componente (p. ej. `cb-kanban-workspace`). La `ng-template cbKanbanCard`
+     * proyectada tiene prioridad.
+     */
+    readonly cardTemplate: _angular_core.InputSignal<TemplateRef<CbKanbanCardContext<any>> | undefined>;
+    protected readonly cardTpl: _angular_core.Signal<TemplateRef<CbKanbanCardContext<any>> | undefined>;
+    private readonly grab;
+    protected readonly editingKey: _angular_core.WritableSignal<unknown>;
+    protected readonly confirmingKey: _angular_core.WritableSignal<unknown>;
+    protected readonly composing: _angular_core.WritableSignal<string | null>;
+    protected readonly renamingColumn: _angular_core.WritableSignal<string | null>;
+    protected readonly confirmingColumn: _angular_core.WritableSignal<string | null>;
+    private readonly collapsed;
+    protected readonly menuItems: _angular_core.WritableSignal<CbMenuItem[]>;
+    protected readonly menuLabel: _angular_core.WritableSignal<string>;
+    /** Al renombrar con Enter, el blur posterior no vuelve a guardar. */
+    private renameDone;
+    protected hasMeta(item: unknown): boolean;
+    protected isGrabbed(item: unknown): boolean;
+    protected isCollapsed(col: CbKanbanColumn): boolean;
+    protected readonly canEnter: (drag: CdkDrag, drop: CdkDropList<CbKanbanColumn>) => boolean;
+    protected onDrop(event: CdkDragDrop<CbKanbanColumn>): void;
+    protected onCardKeydown(event: KeyboardEvent, column: number, index: number): void;
+    private applyKeyboardMove;
+    private announce;
+    protected openCardMenu(event: MouseEvent, column: number, index: number): void;
+    protected openColumnMenu(event: MouseEvent, col: CbKanbanColumn): void;
+    /** Pasa la tarjeta a modo edición (título). */
+    startEdit(item: unknown): void;
+    protected onEditorKeydown(event: KeyboardEvent, column: number, index: number, value: string): void;
+    protected saveEdit(column: number, index: number, value: string): void;
+    protected cancelEdit(item: unknown): void;
+    private requestDelete;
+    protected cancelDelete(item: unknown): void;
+    protected afterDelete(next: readonly CbKanbanColumn[], column: number, index: number): void;
+    protected openComposer(col: CbKanbanColumn): void;
+    protected closeComposer(col: CbKanbanColumn): void;
+    protected onComposerKeydown(event: KeyboardEvent, col: CbKanbanColumn, field: HTMLTextAreaElement): void;
+    protected addCardFrom(col: CbKanbanColumn, field: HTMLTextAreaElement): void;
+    protected toggleCollapse(col: CbKanbanColumn): void;
+    protected startColumnRename(col: CbKanbanColumn): void;
+    protected renameColumn(col: CbKanbanColumn, value: string): void;
+    protected cancelColumnRename(col: CbKanbanColumn): void;
+    private requestColumnDelete;
+    protected cancelColumnDelete(col: CbKanbanColumn): void;
+    protected deleteColumn(col: CbKanbanColumn): void;
+    /** Añade una columna al final y abre su nombre para editarlo. */
+    addColumn(title?: string): void;
+    private focusColumnMenu;
+    /** Elemento del tablero con `data-<nombre>` igual a `value` (sin depender de CSS.escape). */
+    private byData;
+    protected focusItem(key: unknown): void;
+    /** La tarjeta se vuelve a pintar al cambiar: se recupera el foco tras el render. */
+    private focusCard;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanban, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanban, "cb-kanban", never, { "cardTemplate": { "alias": "cardTemplate"; "required": false; "isSignal": true; }; }, {}, ["cardDirective"], never, true, never>;
+}
+
+interface CalendarDay {
+    readonly date: Date;
+    readonly iso: string;
+    /** Número del día ("1 nov" el primero de cada mes). */
+    readonly label: string;
+    /** Fecha completa para lectores de pantalla. */
+    readonly full: string;
+    readonly inMonth: boolean;
+    readonly today: boolean;
+}
+interface CalendarBar {
+    readonly item: unknown;
+    readonly key: unknown;
+    readonly column: CbKanbanColumn;
+    /** Columna de la semana (0–6) donde empieza la barra y cuántos días ocupa. */
+    readonly from: number;
+    readonly span: number;
+    readonly lane: number;
+    /** La tarea empezó antes de esta semana / sigue después. */
+    readonly continuesBefore: boolean;
+    readonly continuesAfter: boolean;
+}
+interface CalendarWeek {
+    readonly days: readonly CalendarDay[];
+    readonly bars: readonly CalendarBar[];
+    readonly lanes: number;
+    readonly label: string;
+}
+/**
+ * Vista de calendario de las tareas: un mes con cada tarea como una barra que va
+ * de su fecha de inicio a la de fin (`startDate` / `endDate`, ver `CbKanbanTask`).
+ *
+ * Usa el mismo `[(columns)]` que `cb-kanban` y `cb-kanban-list`, así que se puede
+ * mostrar a la vez que ellas. Con `editable`, las tareas cambian de día
+ * arrastrándolas (o con Alt + flechas); con `addable`, cada día tiene "Añadir
+ * tarea" (se crea con esa fecha en `newTaskColumn`). Las tareas sin fechas se
+ * listan en "Sin fecha".
+ *
+ * @example
+ * ```html
+ * <cb-kanban-calendar [(columns)]="columnas" [people]="personas" details editable addable />
+ * ```
+ */
+declare class CbKanbanCalendar extends CbKanbanView {
+    private readonly document;
+    protected readonly uid: string;
+    /** Mes visible (cualquier día del mes). Bidireccional: cambia con ‹ › y "Hoy". */
+    readonly viewDate: _angular_core.ModelSignal<Date>;
+    /** Primer día de la semana: 0 = domingo, 1 = lunes (por defecto). */
+    readonly firstDayOfWeek: _angular_core.InputSignal<number>;
+    /** Columna donde se crean las tareas nuevas (id). Por defecto, la primera. */
+    readonly newTaskColumn: _angular_core.InputSignal<string | null>;
+    protected readonly composing: _angular_core.WritableSignal<string | null>;
+    protected readonly showUndated: _angular_core.WritableSignal<boolean>;
+    /** Mientras se arrastra: la tarea y cuántos días se desplaza. */
+    private readonly preview;
+    protected readonly dragKey: _angular_core.Signal<unknown>;
+    protected readonly dropDay: _angular_core.WritableSignal<string | null>;
+    private drag;
+    private suppressClick;
+    private readonly today;
+    constructor();
+    protected canEdit(): boolean;
+    protected readonly monthLabel: _angular_core.Signal<string>;
+    protected readonly weekdays: _angular_core.Signal<string[]>;
+    /** Tareas con fechas (inicio ≤ fin), con el desplazamiento del arrastre aplicado. */
+    private readonly ranges;
+    protected readonly undated: _angular_core.Signal<{
+        item: any;
+        column: CbKanbanColumn<any>;
+    }[]>;
+    protected readonly weeks: _angular_core.Signal<CalendarWeek[]>;
+    /** Filas de la semana: número del día, un carril por barra y el hueco de "Añadir tarea". */
+    protected rows(week: CalendarWeek): string;
+    protected barLabel(bar: CalendarBar): string;
+    protected shiftMonth(step: number): void;
+    protected goToday(): void;
+    /** Desplaza las fechas de la tarea `days` días (mantiene la duración). */
+    shiftTask(item: unknown, days: number, focus?: boolean): void;
+    protected onBarKeydown(event: KeyboardEvent, item: unknown): void;
+    protected onBarClick(item: unknown): void;
+    protected onPointerDown(event: PointerEvent, bar: CalendarBar): void;
+    private readonly onPointerMove;
+    private readonly onPointerUp;
+    private readonly onPointerCancel;
+    private endDrag;
+    private stopListening;
+    /** Día del calendario bajo el puntero. */
+    private dateAt;
+    private targetColumn;
+    /** "Añadir tarea" de la barra: abre el campo en el día de hoy. */
+    protected addToday(): void;
+    protected openComposer(iso: string): void;
+    protected closeComposer(iso: string, focus?: boolean): void;
+    protected onComposerKeydown(event: KeyboardEvent, iso: string, field: HTMLInputElement): void;
+    protected focusItem(key: unknown): void;
+    /** Elemento con `name` igual a `value` (sin depender de CSS.escape). */
+    private byData;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanCalendar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanbanCalendar, "cb-kanban-calendar", never, { "viewDate": { "alias": "viewDate"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "newTaskColumn": { "alias": "newTaskColumn"; "required": false; "isSignal": true; }; }, { "viewDate": "viewDateChange"; }, never, never, true, never>;
+}
+
+/**
+ * Bloques del panel:
+ * - Indicadores: `completed`, `incomplete`, `overdue` y `total`.
+ * - Gráficos: `bySection` (sin finalizar por sección), `byStatus` (dona por estado),
+ *   `byAssignee` (sin finalizar por responsable) y `byWeek` (entregas por semana).
+ */
+type CbKanbanDashboardWidget = 'completed' | 'incomplete' | 'overdue' | 'total' | 'bySection' | 'byStatus' | 'byAssignee' | 'byWeek';
+interface Kpi {
+    readonly kind: 'kpi';
+    readonly id: CbKanbanDashboardWidget;
+    readonly title: string;
+    readonly value: number;
+    readonly hint?: string;
+    readonly tone?: 'success' | 'danger';
+}
+interface ChartWidget {
+    readonly kind: 'chart';
+    readonly id: CbKanbanDashboardWidget;
+    readonly title: string;
+    readonly type: CbChartType;
+    readonly data: CbChartData;
+    readonly stacked?: boolean;
+}
+/**
+ * Panel de resumen de las tareas: indicadores (finalizadas, sin finalizar, con
+ * retraso y total) y gráficos por sección, por estado, por responsable y por
+ * semana de entrega, calculados al momento desde el mismo `[(columns)]` que
+ * usan `cb-kanban`, `cb-kanban-list`, `cb-kanban-timeline` y `cb-kanban-calendar`.
+ *
+ * Una tarea cuenta como finalizada con `completed: true` y con retraso si su
+ * `endDate` ya pasó sin finalizarla. `widgets` elige qué bloques se ven y en qué orden.
+ *
+ * @example
+ * ```html
+ * <cb-kanban-dashboard [columns]="columnas" [people]="personas" />
+ * ```
+ */
+declare class CbKanbanDashboard extends CbKanbanView {
+    protected readonly uid: string;
+    protected readonly integer: Intl.NumberFormatOptions;
+    /** Bloques a mostrar y su orden. Por defecto, los cuatro indicadores y los cuatro gráficos. */
+    readonly widgets: _angular_core.InputSignal<readonly CbKanbanDashboardWidget[]>;
+    /** Nivel de encabezado de los títulos de cada bloque. */
+    readonly headingLevel: _angular_core.InputSignal<number>;
+    /** Alto de los gráficos (px). */
+    readonly chartHeight: _angular_core.InputSignal<number>;
+    /** Anima los gráficos al aparecer. */
+    readonly animate: _angular_core.InputSignal<boolean>;
+    private readonly today;
+    /** Todas las tareas con su estado. */
+    private readonly tasks;
+    private readonly counts;
+    protected readonly blocks: _angular_core.Signal<(Kpi | ChartWidget)[]>;
+    /** Sin finalizar por sección (columna). */
+    readonly bySection: _angular_core.Signal<CbChartData>;
+    /** Finalizadas, a tiempo y con retraso. */
+    readonly byStatus: _angular_core.Signal<CbChartData>;
+    /** Sin finalizar por responsable (una tarea con dos personas cuenta para las dos). */
+    readonly byAssignee: _angular_core.Signal<CbChartData>;
+    /** Tareas por semana de su fecha de fin, finalizadas y sin finalizar. */
+    readonly byWeek: _angular_core.Signal<CbChartData>;
+    protected num(n: number): string;
+    /** El panel no tiene tareas enfocables. */
+    protected focusItem(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanDashboard, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanbanDashboard, "cb-kanban-dashboard", never, { "widgets": { "alias": "widgets"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; "chartHeight": { "alias": "chartHeight"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Vista de lista de las tareas: una tabla con una sección (contraíble) por cada
+ * columna del tablero y, por tarea, responsables, fechas y prioridad.
+ *
+ * Usa el mismo `[(columns)]` que `cb-kanban`, así que ambas vistas se pueden
+ * mostrar a la vez sobre los mismos datos. Las filas se arrastran entre
+ * secciones (o Alt + ↑/↓ con el teclado); con `editable`, el círculo marca la
+ * tarea como finalizada (`completed`); con `addable`, cada sección tiene
+ * "Añadir tarea"; con `columnsEditable`, las secciones se renombran y se añaden.
+ *
+ * @example
+ * ```html
+ * <cb-kanban-list [(columns)]="columnas" [people]="personas" details editable addable />
+ * ```
+ */
+declare class CbKanbanList extends CbKanbanView {
+    protected readonly uid: string;
+    protected readonly composing: _angular_core.WritableSignal<string | null>;
+    protected readonly renaming: _angular_core.WritableSignal<string | null>;
+    private readonly collapsed;
+    /** Al renombrar con Enter, el blur posterior no vuelve a guardar. */
+    private renameDone;
+    protected canDrag(): boolean;
+    protected isCollapsed(col: CbKanbanColumn): boolean;
+    protected toggleCollapse(col: CbKanbanColumn): void;
+    protected toggleCompleted(item: unknown): void;
+    protected readonly canEnter: (drag: CdkDrag, drop: CdkDropList<CbKanbanColumn>) => boolean;
+    protected onDrop(event: CdkDragDrop<CbKanbanColumn>): void;
+    /** Alt + ↑/↓ mueve la fila (al llegar al borde, pasa a la sección vecina abierta). */
+    protected onRowKeydown(event: KeyboardEvent, column: number, index: number): void;
+    protected openComposer(col: CbKanbanColumn): void;
+    protected closeComposer(col: CbKanbanColumn, focus?: boolean): void;
+    protected onComposerKeydown(event: KeyboardEvent, col: CbKanbanColumn, field: HTMLInputElement): void;
+    /** Añade una sección al final y abre su nombre para editarlo. */
+    addSection(title?: string): void;
+    protected startRename(col: CbKanbanColumn): void;
+    protected rename(col: CbKanbanColumn, value: string): void;
+    protected cancelRename(col: CbKanbanColumn): void;
+    protected focusItem(key: unknown): void;
+    protected afterDelete(next: readonly CbKanbanColumn[], column: number, index: number): void;
+    private focusSection;
+    private rowOf;
+    /** Elemento con `name` igual a `value` (sin depender de CSS.escape). */
+    private byData;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanList, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanbanList, "cb-kanban-list", never, {}, {}, never, never, true, never>;
+}
+
+interface TimelineDay {
+    readonly date: Date;
+    readonly iso: string;
+    readonly label: string;
+    readonly weekend: boolean;
+    readonly today: boolean;
+}
+interface TimelineMonth {
+    readonly label: string;
+    /** Primer día visible del mes (índice) y cuántos días ocupa. */
+    readonly from: number;
+    readonly span: number;
+}
+interface TimelineBar {
+    readonly item: unknown;
+    readonly key: unknown;
+    readonly from: number;
+    readonly span: number;
+    readonly lane: number;
+    /** La tarea empezó antes del rango visible / sigue después. */
+    readonly continuesBefore: boolean;
+    readonly continuesAfter: boolean;
+    /** Barra corta: el nombre va fuera, a su derecha, ocupando estos días (0 = dentro). */
+    readonly outside: number;
+}
+interface TimelineSection {
+    readonly column: CbKanbanColumn;
+    readonly bars: readonly TimelineBar[];
+    readonly lanes: number;
+}
+/**
+ * Cronograma (diagrama de Gantt) de las tareas: una fila por sección (columna) y
+ * cada tarea como una barra desde su `startDate` hasta su `endDate`.
+ *
+ * Usa el mismo `[(columns)]` que `cb-kanban`, `cb-kanban-list` y
+ * `cb-kanban-calendar`. Con `editable`, las barras se arrastran para cambiar las
+ * fechas (los bordes cambian la duración) o para pasarlas a otra sección, también
+ * con Alt + flechas; con `addable`, cada sección tiene "Añadir tarea" (empieza
+ * hoy). `[(viewDate)]` es el primer día visible, `span` cuántos días se ven y
+ * `[(zoom)]` el ancho de los días.
+ *
+ * @example
+ * ```html
+ * <cb-kanban-timeline [(columns)]="columnas" [people]="personas" details editable addable />
+ * ```
+ */
+declare class CbKanbanTimeline extends CbKanbanView {
+    private readonly document;
+    protected readonly uid: string;
+    private readonly today;
+    /** Primer día visible. Bidireccional: cambia con ‹ › y "Hoy". Por defecto, unos días antes de hoy. */
+    readonly viewDate: _angular_core.ModelSignal<Date>;
+    /** Días visibles. */
+    readonly span: _angular_core.InputSignal<number>;
+    /** Ancho de los días: 0 (estrecho) a 3 (ancho). Bidireccional: cambia con − y +. */
+    readonly zoom: _angular_core.ModelSignal<number>;
+    /** Columna donde se crean las tareas de "Añadir tarea" de la barra (id). Por defecto, la primera. */
+    readonly newTaskColumn: _angular_core.InputSignal<string | null>;
+    protected readonly zoomMax: number;
+    protected readonly composing: _angular_core.WritableSignal<string | null>;
+    protected readonly showUndated: _angular_core.WritableSignal<boolean>;
+    private readonly collapsed;
+    private readonly preview;
+    protected readonly dragKey: _angular_core.Signal<unknown>;
+    protected readonly dropCell: _angular_core.WritableSignal<string | null>;
+    private drag;
+    private suppressClick;
+    constructor();
+    protected canEdit(): boolean;
+    private readonly start;
+    private readonly count;
+    protected readonly dayWidth: _angular_core.Signal<"1.75rem" | "2.5rem" | "3.5rem" | "5rem">;
+    protected readonly template: _angular_core.Signal<string>;
+    protected readonly days: _angular_core.Signal<TimelineDay[]>;
+    protected readonly todayIndex: _angular_core.Signal<number>;
+    protected readonly months: _angular_core.Signal<TimelineMonth[]>;
+    protected readonly rangeLabel: _angular_core.Signal<string>;
+    /** Fechas de cada tarea (inicio ≤ fin), con el arrastre en curso aplicado. */
+    private rangeOf;
+    protected readonly undated: _angular_core.Signal<{
+        item: any;
+        column: CbKanbanColumn<any>;
+    }[]>;
+    protected readonly sections: _angular_core.Signal<TimelineSection[]>;
+    /** Filas de la sección: un carril por barra (al menos uno) y el hueco de "Añadir tarea". */
+    protected rowsOf(sec: TimelineSection): string;
+    protected barLabel(bar: TimelineBar, column: CbKanbanColumn): string;
+    protected isCollapsed(col: CbKanbanColumn): boolean;
+    protected toggleCollapse(col: CbKanbanColumn): void;
+    /** Añade una sección vacía al final. */
+    addSection(title?: string): void;
+    protected shiftView(days: number): void;
+    protected goToday(): void;
+    protected setZoom(step: number): void;
+    /** Si la fecha queda fuera del rango visible, lo desplaza para mostrarla. */
+    private reveal;
+    /** Desplaza las fechas de la tarea `days` días (mantiene la duración). */
+    shiftTask(item: unknown, days: number, focus?: boolean): void;
+    /** Mueve el inicio o el fin de la tarea `days` días (sin pasar del otro extremo). */
+    resizeTask(item: unknown, edge: 'start' | 'end', days: number, focus?: boolean): void;
+    private applyDates;
+    /** Pasa la tarea a la sección vecina (`step` −1 o 1). */
+    private moveToSection;
+    protected onBarKeydown(event: KeyboardEvent, item: unknown): void;
+    protected onBarClick(item: unknown): void;
+    protected onPointerDown(event: PointerEvent, bar: TimelineBar): void;
+    private readonly onPointerMove;
+    private readonly onPointerUp;
+    private readonly onPointerCancel;
+    private endDrag;
+    private stopListening;
+    /** Día y sección bajo el puntero. */
+    private cellAt;
+    /** Día de las tareas nuevas: hoy si se ve; si no, el primer día visible. */
+    private newTaskDay;
+    /** "Añadir tarea" de la barra: abre el campo en `newTaskColumn` (o la primera sección). */
+    protected addTop(): void;
+    protected openComposer(id: string): void;
+    protected closeComposer(id: string, focus?: boolean): void;
+    protected onComposerKeydown(event: KeyboardEvent, column: CbKanbanColumn, field: HTMLInputElement): void;
+    protected focusItem(key: unknown): void;
+    /** Elemento con `name` igual a `value` (sin depender de CSS.escape). */
+    private byData;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanTimeline, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanbanTimeline, "cb-kanban-timeline", never, { "viewDate": { "alias": "viewDate"; "required": false; "isSignal": true; }; "span": { "alias": "span"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "newTaskColumn": { "alias": "newTaskColumn"; "required": false; "isSignal": true; }; }, { "viewDate": "viewDateChange"; "zoom": "zoomChange"; }, never, never, true, never>;
+}
+
+/**
+ * Detalle de una tarea del Kanban: título, columna, responsables, prioridad,
+ * fechas de inicio y fin, descripción y adjuntos. Cada cambio se aplica al
+ * momento (`patch`); el Kanban lo muestra dentro de un panel lateral.
+ */
+declare class CbKanbanTaskPanel {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    protected readonly uid: string;
+    private readonly host;
+    private readonly injector;
+    /** La tarea que se edita. */
+    readonly task: _angular_core.InputSignal<any>;
+    /** Propiedad con el título. */
+    readonly itemLabel: _angular_core.InputSignal<string>;
+    /** Columnas del tablero (para moverla). */
+    readonly columns: _angular_core.InputSignal<readonly CbKanbanColumn<any>[]>;
+    /** Columna en la que está. */
+    readonly columnId: _angular_core.InputSignal<string>;
+    readonly people: _angular_core.InputSignal<readonly CbKanbanPerson[]>;
+    readonly priorities: _angular_core.InputSignal<readonly CbKanbanPriority[]>;
+    readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Tipos de archivo admitidos (atributo `accept`). */
+    readonly accept: _angular_core.InputSignal<string>;
+    /** Pide confirmación antes de eliminar. */
+    readonly confirmDelete: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Campos cambiados. */
+    readonly patch: _angular_core.OutputEmitterRef<CbKanbanTaskPatch>;
+    /** Mover a otra columna (id). */
+    readonly move: _angular_core.OutputEmitterRef<string>;
+    /** Eliminar la tarea (ya confirmado). */
+    readonly remove: _angular_core.OutputEmitterRef<void>;
+    protected readonly dragOver: _angular_core.WritableSignal<boolean>;
+    protected readonly confirming: _angular_core.WritableSignal<boolean>;
+    protected readonly title: _angular_core.Signal<string>;
+    protected readonly description: _angular_core.Signal<string>;
+    protected readonly assigneeIds: _angular_core.Signal<string[]>;
+    protected readonly assigned: _angular_core.Signal<CbKanbanPerson[]>;
+    protected readonly priorityId: _angular_core.Signal<string | null>;
+    protected readonly start: _angular_core.Signal<Date | null>;
+    protected readonly end: _angular_core.Signal<Date | null>;
+    protected readonly attachments: _angular_core.Signal<readonly CbKanbanAttachment[]>;
+    private field;
+    protected initialsOf: typeof initials;
+    protected iso: (date: Date | null) => string | null;
+    protected size: (bytes: number) => string;
+    protected commitTitle(field: HTMLTextAreaElement): void;
+    /** Barra compacta del editor de la descripción. */
+    protected readonly editorToolbar: readonly CbEditorTool[];
+    private pendingDescription;
+    private descriptionTimer;
+    /** El editor cambia en cada tecla: se guarda tras una pausa (o al salir del editor). */
+    protected scheduleDescription(html: string): void;
+    protected flushDescription(): void;
+    constructor();
+    protected onColumn(id: unknown): void;
+    protected unassign(id: string): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    /** Añade archivos como adjuntos (con `file` para subirlos y una `url` local para verlos). */
+    addFiles(list: FileList | readonly File[] | null): void;
+    protected removeAttachment(file: CbKanbanAttachment): void;
+    protected requestRemove(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanTaskPanel, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanbanTaskPanel, "cb-kanban-task-panel", never, { "task": { "alias": "task"; "required": true; "isSignal": true; }; "itemLabel": { "alias": "itemLabel"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "columnId": { "alias": "columnId"; "required": false; "isSignal": true; }; "people": { "alias": "people"; "required": false; "isSignal": true; }; "priorities": { "alias": "priorities"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "confirmDelete": { "alias": "confirmDelete"; "required": false; "isSignal": true; }; }, { "patch": "patch"; "move": "move"; "remove": "remove"; }, never, never, true, never>;
+}
+
+/** Vistas del espacio de trabajo. */
+type CbKanbanViewType = 'list' | 'board' | 'timeline' | 'dashboard' | 'calendar';
+/**
+ * Espacio de trabajo con las vistas de las tareas (lista, tablero, cronograma,
+ * panel y calendario) sobre un mismo `[(columns)]`. Los botones de arriba
+ * encienden y apagan cada vista y se pueden ver varias a la vez (`[(views)]` es
+ * una lista), una debajo de otra o lado a lado (`[(sideBySide)]`); con
+ * `multiple = false` se comportan como pestañas (una sola vista).
+ *
+ * Recibe las mismas opciones que cada vista (`details`, `editable`, `addable`,
+ * `people`…) y reemite sus eventos (`cardMove`, `cardEdit`…). Una
+ * `ng-template cbKanbanCard` dentro del espacio de trabajo se usa como
+ * plantilla de las tarjetas del tablero.
+ *
+ * @example
+ * ```html
+ * <cb-kanban-workspace [(columns)]="columnas" [(views)]="vistas" [people]="personas" details editable addable>
+ *   <ng-template cbKanbanCard let-tarea>{{ tarea.title }}</ng-template>
+ * </cb-kanban-workspace>
+ * ```
+ */
+declare class CbKanbanWorkspace extends CbKanbanView {
+    protected readonly uid: string;
+    /** Plantilla de las tarjetas del tablero (`<ng-template cbKanbanCard>`). */
+    protected readonly cardTpl: _angular_core.Signal<CbKanbanCardDirective | undefined>;
+    /** Vistas visibles (bidireccional). Varias a la vez si `multiple`. */
+    readonly views: _angular_core.ModelSignal<readonly CbKanbanViewType[]>;
+    /** Vistas que se ofrecen arriba, en este orden. */
+    readonly available: _angular_core.InputSignal<readonly CbKanbanViewType[]>;
+    /** Se pueden ver varias vistas a la vez. Con `false`, los botones son pestañas. */
+    readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Con varias vistas, las pone lado a lado en lugar de una debajo de otra (bidireccional). */
+    readonly sideBySide: _angular_core.ModelSignal<boolean>;
+    /** Nivel de encabezado del título de cada vista (con varias a la vez). */
+    readonly headingLevel: _angular_core.InputSignal<number>;
+    /** Vistas a pintar, en el orden de `available`. Siempre hay al menos una. */
+    protected readonly shown: _angular_core.Signal<CbKanbanViewType[]>;
+    protected isOn(view: CbKanbanViewType): boolean;
+    protected viewName(view: CbKanbanViewType): string;
+    /** Enciende o apaga una vista (con `multiple = false`, la elige). La última no se apaga. */
+    toggleView(view: CbKanbanViewType): void;
+    /** Cada vista enfoca sus propias tareas. */
+    protected focusItem(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbKanbanWorkspace, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbKanbanWorkspace, "cb-kanban-workspace", never, { "views": { "alias": "views"; "required": false; "isSignal": true; }; "available": { "alias": "available"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "sideBySide": { "alias": "sideBySide"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; }, { "views": "viewsChange"; "sideBySide": "sideBySideChange"; }, ["cardTpl"], never, true, never>;
+}
+
+export { CbKanban, CbKanbanCalendar, CbKanbanCardDirective, CbKanbanDashboard, CbKanbanList, CbKanbanTaskPanel, CbKanbanTimeline, CbKanbanView, CbKanbanWorkspace };
+export type { CbKanbanAttachment, CbKanbanCardContext, CbKanbanCardEvent, CbKanbanColumn, CbKanbanColumnEvent, CbKanbanDashboardWidget, CbKanbanMove, CbKanbanPerson, CbKanbanPriority, CbKanbanTask, CbKanbanTaskPatch, CbKanbanViewType };
+//# sourceMappingURL=caribeng-ui-kanban.d.ts.map