@caribeng/ui 22.2.0 → 22.5.0

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

@@ -0,0 +1,244 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/**
+ * Modelo del diagrama de Gantt: fechas, árbol de tareas, grupos calculados,
+ * dependencias (fin → inicio) y planificación automática. Funciones puras: el
+ * componente las usa y los tests las prueban sin DOM.
+ */
+/** Tarea del diagrama. Las fechas son días (`'AAAA-MM-DD'` o `Date`); el fin es inclusivo. */
+interface CbGanttTask {
+    readonly id: string;
+    readonly name: string;
+    readonly start: string | Date;
+    readonly end: string | Date;
+    /** Avance de 0 a 100. En los grupos se calcula con el de sus tareas. */
+    readonly progress?: number;
+    /** Tarea que la contiene (grupo). */
+    readonly parent?: string | null;
+    /** Tareas que deben terminar antes de que esta empiece (fin → inicio). */
+    readonly dependencies?: readonly string[];
+    /** `milestone` es un hito (un solo día, rombo); `group` agrupa tareas (sus fechas se calculan). */
+    readonly type?: 'task' | 'milestone' | 'group';
+    /** Color de la barra. */
+    readonly color?: string;
+    /** Texto de la columna Responsable. */
+    readonly assignee?: string;
+}
+/** Escala del diagrama: un día, una semana o un mes por columna. */
+type CbGanttScale = 'day' | 'week' | 'month';
+/** Columnas de la tabla de la izquierda. */
+type CbGanttColumn = 'name' | 'start' | 'end' | 'duration' | 'progress' | 'assignee';
+/** Una tarea cambió (al arrastrar, con el teclado o por la planificación automática). */
+interface CbGanttChange {
+    readonly task: CbGanttTask;
+    readonly previous: CbGanttTask;
+    readonly reason: 'move' | 'resize' | 'progress' | 'schedule';
+}
+/** Dependencia creada o quitada: `to` depende de `from`. */
+interface CbGanttLink {
+    readonly from: string;
+    readonly to: string;
+}
+/** Tarea con sus fechas ya resueltas (en los grupos, calculadas con sus tareas). */
+interface ResolvedTask {
+    readonly task: CbGanttTask;
+    readonly start: Date;
+    readonly end: Date;
+    readonly progress: number;
+    readonly level: number;
+    readonly isGroup: boolean;
+    readonly isMilestone: boolean;
+    readonly children: readonly string[];
+}
+/** ¿Se puede crear la dependencia `from` → `to`? (sin repetir, sin ciclos ni grupos que se contienen). */
+declare function canLink(tasks: readonly CbGanttTask[], from: string, to: string): boolean;
+/**
+ * Planificación automática: cada tarea empieza como pronto el día siguiente al
+ * fin de sus predecesoras; si no, se desplaza conservando su duración. Devuelve
+ * las tareas cambiadas (las de grupos se resuelven con sus hijas).
+ */
+declare function autoSchedule(tasks: readonly CbGanttTask[]): CbGanttTask[];
+
+type DragMode = 'move' | 'start' | 'end' | 'progress' | 'link';
+interface Preview {
+    readonly id: string;
+    readonly mode: DragMode;
+    /** Días desplazados (mover / cambiar inicio o fin). */
+    readonly delta: number;
+    /** Avance nuevo (al arrastrar el avance). */
+    readonly progress: number;
+    /** Punto del puntero en el diagrama (al crear una dependencia). */
+    readonly point: {
+        x: number;
+        y: number;
+    } | null;
+}
+interface Bar {
+    readonly row: ResolvedTask;
+    readonly index: number;
+    readonly x: number;
+    readonly width: number;
+    readonly y: number;
+    readonly start: Date;
+    readonly end: Date;
+    readonly progress: number;
+}
+interface Unit {
+    readonly key: string;
+    readonly label: string;
+    readonly x: number;
+    readonly width: number;
+    readonly weekend?: boolean;
+}
+/**
+ * Diagrama de Gantt de CaribeNG: tabla de tareas en árbol (grupos plegables) y
+ * barras en el tiempo, con escalas de día, semana y mes.
+ *
+ * - Arrastra una barra para moverla, sus bordes para cambiar inicio o fin, el
+ *   tirador inferior para el avance y el punto de la derecha hasta otra tarea
+ *   para crear una dependencia (fin → inicio).
+ * - Con `autoSchedule`, al retrasar una tarea se desplazan las que dependen de ella.
+ * - Los grupos abarcan a sus tareas y promedian su avance; los hitos son rombos.
+ * - Con el teclado, cada barra es un botón: flechas mueven, Mayús + flechas cambian
+ *   el fin, Alt + flechas el inicio, + / − el avance, Supr quita sus dependencias
+ *   y Enter abre la tarea. Cada cambio se anuncia.
+ *
+ * @example
+ * ```html
+ * <cb-gantt [(tasks)]="tareas" [(scale)]="escala" (taskChange)="guardar($event)" />
+ * ```
+ */
+declare class CbGantt {
+    /** 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 host;
+    protected readonly uid: string;
+    protected readonly row = 40;
+    protected readonly scales: readonly CbGanttScale[];
+    /** Tareas (bidireccional: se actualiza al arrastrar, con el teclado y al planificar). */
+    readonly tasks: _angular_core.ModelSignal<readonly CbGanttTask[]>;
+    /** Escala: un día, una semana o un mes por columna. */
+    readonly scale: _angular_core.ModelSignal<CbGanttScale>;
+    /** Columnas de la tabla de la izquierda y su orden. */
+    readonly columns: _angular_core.InputSignal<readonly CbGanttColumn[]>;
+    /** Ancho de la tabla de la izquierda; por defecto, el de sus columnas (como mucho, el 60 % del componente). */
+    readonly gridWidth: _angular_core.InputSignal<string>;
+    /** Alto del componente (con scroll). */
+    readonly height: _angular_core.InputSignal<string>;
+    /** Al retrasar una tarea, desplaza las que dependen de ella (fin → inicio). */
+    readonly autoSchedule: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Sin edición: no se arrastra ni se crean dependencias. */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Barra con la escala y el botón Hoy. */
+    readonly showToolbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Texto sin tareas. Por defecto, "Sin datos". */
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Una tarea cambió de fechas o de avance (también las desplazadas por la planificación). */
+    readonly taskChange: _angular_core.OutputEmitterRef<CbGanttChange>;
+    /** Doble clic o Enter sobre una tarea. */
+    readonly taskOpen: _angular_core.OutputEmitterRef<CbGanttTask>;
+    /** Dependencia creada (`to` depende de `from`). */
+    readonly linkAdd: _angular_core.OutputEmitterRef<CbGanttLink>;
+    /** Dependencia quitada. */
+    readonly linkRemove: _angular_core.OutputEmitterRef<CbGanttLink>;
+    protected readonly collapsed: _angular_core.WritableSignal<ReadonlySet<string>>;
+    protected readonly selected: _angular_core.WritableSignal<string | null>;
+    protected readonly selectedLink: _angular_core.WritableSignal<{
+        key: string;
+        from: string;
+        to: string;
+        fromName: string;
+        toName: string;
+        mid: {
+            x: number;
+            y: number;
+        };
+    } | null>;
+    protected readonly preview: _angular_core.WritableSignal<Preview | null>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private drag;
+    private readonly scroller;
+    private readonly chart;
+    private readonly resolved;
+    /** Ancho de la tabla: el indicado o el nombre (14rem) más el de cada columna. */
+    protected readonly gridSize: _angular_core.Signal<string>;
+    protected readonly rows: _angular_core.Signal<ResolvedTask[]>;
+    protected readonly dayWidth: _angular_core.Signal<number>;
+    /** Primer y último día del diagrama (con margen, alineados a la unidad de la escala). */
+    protected readonly range: _angular_core.Signal<{
+        start: Date;
+        end: Date;
+        days: number;
+    }>;
+    protected readonly chartWidth: _angular_core.Signal<number>;
+    private x;
+    /** Unidades de la escala (fila inferior de la cabecera y columnas del fondo). */
+    protected readonly units: _angular_core.Signal<Unit[]>;
+    /** Fila superior de la cabecera: meses (día y semana) o años (mes). */
+    protected readonly topUnits: _angular_core.Signal<Unit[]>;
+    protected readonly todayX: _angular_core.Signal<number | null>;
+    /** Geometría de las barras (con la vista previa del arrastre). */
+    protected readonly bars: _angular_core.Signal<Bar[]>;
+    /** Flechas de dependencias entre barras visibles. */
+    protected readonly links: _angular_core.Signal<{
+        key: string;
+        from: string;
+        to: string;
+        fromName: string;
+        toName: string;
+        path: string;
+        mid: {
+            x: number;
+            y: number;
+        };
+    }[]>;
+    /** Línea provisional al crear una dependencia. */
+    protected readonly linkLine: _angular_core.Signal<string | null>;
+    protected scaleLabel(s: CbGanttScale): string;
+    protected columnLabel(col: CbGanttColumn): string;
+    private dateText;
+    protected cellText(r: ResolvedTask, col: CbGanttColumn): string;
+    protected barLabel(b: Bar): string;
+    protected toggle(id: string): void;
+    /** Selecciona la tarea, lleva su barra a la vista y le da el foco. */
+    focusBar(id: string): void;
+    /** Desplaza el diagrama hasta hoy (centrado en la parte visible). */
+    scrollToToday(smooth?: boolean): void;
+    constructor();
+    private barEl;
+    /** Aplica un cambio a una tarea (y a las desplazadas por la planificación) y lo emite. */
+    private apply;
+    private commit;
+    private resolveFresh;
+    /** Crea la dependencia `from` → `to` (si no forma un ciclo). */
+    addLink(from: string, to: string): boolean;
+    /** Quita la dependencia `from` → `to`. */
+    removeLink(from: string, to: string): void;
+    protected selectLink(link: {
+        key: string;
+        from: string;
+        to: string;
+        fromName: string;
+        toName: string;
+        mid: {
+            x: number;
+            y: number;
+        };
+    }): void;
+    protected onPointerDown(event: PointerEvent, bar: Bar): void;
+    protected onPointerMove(event: PointerEvent): void;
+    protected onPointerUp(event: PointerEvent): void;
+    protected cancelDrag(): void;
+    protected onBarKeydown(event: KeyboardEvent, r: ResolvedTask): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbGantt, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbGantt, "cb-gantt", never, { "tasks": { "alias": "tasks"; "required": false; "isSignal": true; }; "scale": { "alias": "scale"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "gridWidth": { "alias": "gridWidth"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "autoSchedule": { "alias": "autoSchedule"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "tasks": "tasksChange"; "scale": "scaleChange"; "taskChange": "taskChange"; "taskOpen": "taskOpen"; "linkAdd": "linkAdd"; "linkRemove": "linkRemove"; }, never, never, true, never>;
+}
+
+export { CbGantt, autoSchedule as cbGanttAutoSchedule, canLink as cbGanttCanLink };
+export type { CbGanttChange, CbGanttColumn, CbGanttLink, CbGanttScale, CbGanttTask };
+//# sourceMappingURL=caribeng-ui-gantt.d.ts.map

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

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 
 /**
- * Header de Caribe Design: cabecera de pantalla con título, subtítulo opcional,
+ * Header: cabecera de pantalla con título, subtítulo opcional,
  * botón de retroceso y una zona de acciones proyectadas.
  *
  * @example
@@ -26,4 +26,4 @@ declare class CbHeader {
 }
 
 export { CbHeader };
-//# sourceMappingURL=caribeng-ui-caribe-header.d.ts.map
+//# sourceMappingURL=caribeng-ui-header.d.ts.map

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

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import * as _caribeng_ui from '@caribeng/ui';
 
 /**
- * Icon-button de Caribe Design: botón circular con un único icono. Útil para
+ * Icon-button: botón circular con un único icono. Útil para
  * acciones compactas en barras y cabeceras.
  *
  * @example
@@ -28,4 +28,4 @@ declare class CbIconButton {
 }
 
 export { CbIconButton };
-//# sourceMappingURL=caribeng-ui-caribe-icon-button.d.ts.map
+//# sourceMappingURL=caribeng-ui-icon-button.d.ts.map

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

@@ -12,4 +12,4 @@ declare class CbIllustration {
 }
 
 export { CbIllustration };
-//# sourceMappingURL=caribeng-ui-caribe-illustration.d.ts.map
+//# sourceMappingURL=caribeng-ui-illustration.d.ts.map

package/types/caribeng-ui-image-cropper.d.ts

@@ -0,0 +1,169 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Recuadro de recorte en fracciones de la imagen (0–1). */
+interface CbCropRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Opciones de la imagen recortada. */
+interface CbCropOutput {
+    /** `image/png` (por defecto, o el tipo de la original si es JPEG), `image/jpeg` o `image/webp`. */
+    readonly type?: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** Calidad de JPEG y WebP (0–1). */
+    readonly quality?: number;
+    /** Tamaño máximo en píxeles: el recorte se reduce (nunca se amplía) para no pasar de él. */
+    readonly maxWidth?: number;
+    readonly maxHeight?: number;
+    /** Recorte circular (PNG con fondo transparente), p. ej. para fotos de perfil. */
+    readonly circle?: boolean;
+}
+/** Mantiene el recuadro dentro de la imagen y con un tamaño mínimo. */
+declare function clampRect(rect: CbCropRect): CbCropRect;
+/**
+ * Ajusta el recuadro a una proporción (ancho / alto en píxeles), lo más grande
+ * posible dentro del actual y centrado en él. `ratio` null = libre.
+ */
+declare function fitRatio(rect: CbCropRect, ratio: number | null, imageWidth: number, imageHeight: number): CbCropRect;
+/** Recuadro inicial: el mayor posible con la proporción, centrado. */
+declare function initialRect(ratio: number | null, imageWidth: number, imageHeight: number): CbCropRect;
+/**
+ * Redimensiona arrastrando una esquina (`nw`, `ne`, `sw`, `se`) un desplazamiento
+ * (dx, dy) en fracciones; con proporción, el alto sigue al ancho.
+ */
+declare function resizeRect(rect: CbCropRect, corner: 'nw' | 'ne' | 'sw' | 'se', dx: number, dy: number, ratio: number | null, imageWidth: number, imageHeight: number): CbCropRect;
+/** Tamaño en píxeles del recorte, reducido para no pasar de `maxWidth` × `maxHeight`. */
+declare function outputSize(rect: CbCropRect, imageWidth: number, imageHeight: number, output?: CbCropOutput): {
+    w: number;
+    h: number;
+};
+/**
+ * Estilo de una vista previa del recorte hecha con CSS (sin canvas): la imagen como fondo,
+ * ampliada y desplazada para que solo se vea el recuadro.
+ */
+declare function previewStyle(src: string, rect: CbCropRect): Record<string, string>;
+/**
+ * Recorta los píxeles de la imagen. Las imágenes de otro dominio necesitan que
+ * su servidor permita CORS; si no, el navegador bloquea la lectura y se rechaza.
+ */
+declare function cropImage(src: string, rect: CbCropRect, doc: Document, output?: CbCropOutput): Promise<Blob>;
+/** Gira la imagen un cuarto de vuelta (`1` a la derecha, `-1` a la izquierda) y la devuelve como data URL PNG. */
+declare function rotateImage(src: string, turns: 1 | -1, doc: Document): Promise<string>;
+/** Lee un archivo como data URL. */
+declare function readFileAsDataUrl(file: Blob): Promise<string>;
+
+/** Proporción que se ofrece en la barra (`value` null = libre). */
+interface CbCropRatio {
+    readonly label: string;
+    readonly value: number | null;
+}
+/** Resultado del recorte. */
+interface CbCropResult {
+    readonly blob: Blob;
+    readonly dataUrl: string;
+    readonly rect: CbCropRect;
+    readonly width: number;
+    readonly height: number;
+}
+type Corner = 'nw' | 'ne' | 'sw' | 'se';
+/**
+ * Recortador de imagen de CaribeNG: recuadro que se mueve y redimensiona con ratón, dedo o
+ * teclado, proporciones fijas o libre, forma circular para fotos de perfil, giro, vista previa
+ * y selección de archivo (botón o arrastrar). Devuelve el recorte como `Blob` y data URL.
+ *
+ * @example
+ * ```html
+ * <cb-image-cropper [src]="foto" shape="circle" preview (cropped)="guardar($event.blob)" />
+ * ```
+ */
+declare class CbImageCropper {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly document;
+    private readonly injector;
+    private readonly destroyRef;
+    protected readonly helpId: string;
+    /** Imagen a recortar (URL o data URL). Las de otro dominio necesitan CORS para poder recortarse. */
+    readonly src: _angular_core.InputSignal<string>;
+    /** Recuadro en fracciones de la imagen (0–1). Se inicia al cargar la imagen si no se indica. */
+    readonly rect: _angular_core.ModelSignal<CbCropRect | null>;
+    /** Proporción ancho / alto (`null` = libre). Con `shape="circle"` siempre es 1. */
+    readonly ratio: _angular_core.ModelSignal<number | null>;
+    /** Proporciones de la barra (vacío para ocultarla). */
+    readonly ratios: _angular_core.InputSignal<readonly CbCropRatio[]>;
+    /** Recorte rectangular o circular (PNG con fondo transparente, para fotos de perfil). */
+    readonly shape: _angular_core.InputSignal<"rect" | "circle">;
+    /** Formato, calidad y tamaño máximo del recorte. */
+    readonly output: _angular_core.InputSignal<CbCropOutput>;
+    /** Botones de girar 90°. */
+    readonly rotatable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Vista previa del recorte. */
+    readonly preview: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Botón para elegir otra imagen (y arrastrar archivos al área vacía). */
+    readonly chooser: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Botón Recortar (sin él, recorta llamando a `crop()`). */
+    readonly showApply: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly accept: _angular_core.InputSignal<string>;
+    /** Alto máximo de la imagen en pantalla. */
+    readonly maxHeight: _angular_core.InputSignal<string>;
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Recorte hecho con el botón Recortar o Enter. */
+    readonly cropped: _angular_core.OutputEmitterRef<CbCropResult>;
+    /** Imagen elegida por el usuario (archivo). */
+    readonly fileSelect: _angular_core.OutputEmitterRef<File>;
+    /** No se pudo cargar o recortar la imagen. */
+    readonly cropError: _angular_core.OutputEmitterRef<unknown>;
+    protected readonly corners: readonly Corner[];
+    /** Imagen en pantalla: `src`, el archivo elegido o la imagen girada. */
+    protected readonly displaySrc: _angular_core.WritableSignal<string>;
+    protected readonly natural: _angular_core.WritableSignal<{
+        w: number;
+        h: number;
+    } | null>;
+    protected readonly busy: _angular_core.WritableSignal<boolean>;
+    protected readonly error: _angular_core.WritableSignal<string>;
+    protected readonly dragOver: _angular_core.WritableSignal<boolean>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private readonly effRatio;
+    /** El recuadro vigente (`rect` es null hasta que carga la imagen). */
+    protected readonly current: _angular_core.Signal<CbCropRect>;
+    protected readonly valueText: _angular_core.Signal<string>;
+    protected readonly previewCss: _angular_core.Signal<{
+        'aspect-ratio': string;
+    }>;
+    private readonly stage;
+    private readonly box;
+    private readonly fileInput;
+    constructor();
+    /** Recorta y devuelve el resultado (sin emitir `cropped`). */
+    crop(): Promise<CbCropResult>;
+    /** Abre el selector de archivos. */
+    choose(): void;
+    /** Proporción fija (ancho / alto) o libre (`null`). */
+    setRatio(ratio: number | null): void;
+    protected onLoad(event: Event): void;
+    protected onImageError(): void;
+    protected apply(): Promise<void>;
+    protected rotate(turns: 1 | -1): Promise<void>;
+    protected onFile(event: Event): Promise<void>;
+    protected onDragOver(event: DragEvent): void;
+    protected onDrop(event: DragEvent): Promise<void>;
+    /** Mueve (`corner` null) o redimensiona el recuadro arrastrando. */
+    protected startDrag(event: PointerEvent, corner: Corner | null): void;
+    /** Flechas: mover (2 %, 10 % con Ctrl); Mayús + flechas: tamaño desde la esquina inferior derecha; Enter: recortar. */
+    protected onKeydown(event: KeyboardEvent): void;
+    private load;
+    private useFile;
+    /** El recuadro aparece cuando carga la imagen: entonces recibe el foco. */
+    private focusWhenReady;
+    /** Un espacio duro alterno hace que el mismo texto cuente como cambio y se vuelva a anunciar. */
+    private announce;
+    private announceFlip;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbImageCropper, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbImageCropper, "cb-image-cropper", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "rect": { "alias": "rect"; "required": false; "isSignal": true; }; "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; "ratios": { "alias": "ratios"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "output": { "alias": "output"; "required": false; "isSignal": true; }; "rotatable": { "alias": "rotatable"; "required": false; "isSignal": true; }; "preview": { "alias": "preview"; "required": false; "isSignal": true; }; "chooser": { "alias": "chooser"; "required": false; "isSignal": true; }; "showApply": { "alias": "showApply"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; }, { "rect": "rectChange"; "ratio": "ratioChange"; "cropped": "cropped"; "fileSelect": "fileSelect"; "cropError": "cropError"; }, never, never, true, never>;
+}
+
+export { CbImageCropper, clampRect, cropImage, fitRatio, initialRect, outputSize, previewStyle, readFileAsDataUrl, resizeRect, rotateImage };
+export type { CbCropOutput, CbCropRatio, CbCropRect, CbCropResult };
+//# sourceMappingURL=caribeng-ui-image-cropper.d.ts.map

package/types/caribeng-ui-import-wizard.d.ts

@@ -0,0 +1,149 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+import { CbDataGridColumn } from '@caribeng/ui/datagrid';
+import { CbXlsxReadSheet } from '@caribeng/ui/xlsx';
+
+/** Tipo de un campo a importar (cómo se interpreta el texto). */
+type CbImportFieldType = 'text' | 'number' | 'date' | 'boolean';
+/** Campo de destino de la importación. */
+interface CbImportField {
+    readonly key: string;
+    readonly label: string;
+    readonly type?: CbImportFieldType;
+    readonly required?: boolean;
+    /** Otros nombres de columna con los que se asigna solo (p. ej. `['nit', 'documento']`). */
+    readonly aliases?: readonly string[];
+    /** Validación propia: mensaje de error o `null`. */
+    readonly validate?: (value: unknown, row: Record<string, unknown>) => string | null;
+}
+/** Error de una celda importada. */
+interface CbImportError {
+    /** Fila de datos (1 = la primera después del encabezado). */
+    readonly row: number;
+    readonly field: string;
+    readonly message: string;
+}
+/** Resultado de la importación. */
+interface CbImportResult<T = Record<string, unknown>> {
+    readonly rows: T[];
+    readonly errors: CbImportError[];
+    /** Filas descartadas por tener errores. */
+    readonly skipped: number;
+}
+type CbImportCell = string | number | boolean | null;
+interface ImportTexts {
+    readonly required: string;
+    readonly number: string;
+    readonly date: string;
+    readonly boolean: string;
+}
+/** Separador más probable de un texto delimitado (tabulador, punto y coma o coma). */
+declare function detectDelimiter(text: string): string;
+/** CSV / TSV a filas (comillas dobles, saltos de línea dentro de comillas, BOM). */
+declare function parseDelimited(text: string, delimiter?: string): string[][];
+/**
+ * Importe a partir de texto: `$ 1.234,56`, `1,234.56`, `(1.234)` (negativo),
+ * `-1234`, `1.234.567`. Con un solo separador repetido, o seguido de 3 cifras,
+ * se toma como de miles.
+ */
+declare function parseAmount(value: CbImportCell): number | null | undefined;
+/** Fecha a partir de texto (`AAAA-MM-DD`, `DD/MM/AAAA`, `DD-MM-AAAA`) o de un número de serie de Excel. */
+declare function parseDate(value: CbImportCell): Date | null | undefined;
+declare function parseBoolean(value: CbImportCell): boolean | null | undefined;
+/** Asigna cada campo a la columna cuyo encabezado coincide con su clave, etiqueta o alias. */
+declare function autoMap(headers: readonly string[], fields: readonly CbImportField[]): Record<string, number | null>;
+/** Convierte las filas con la asignación de columnas: valores con tipo y errores por celda. */
+declare function convertRows(rows: readonly (readonly CbImportCell[])[], mapping: Readonly<Record<string, number | null>>, fields: readonly CbImportField[], texts: ImportTexts): {
+    rows: Record<string, unknown>[];
+    errors: CbImportError[];
+};
+
+type Step = 'file' | 'map' | 'review';
+/**
+ * Asistente de importación de CaribeNG: archivo (CSV, TSV, Excel o datos pegados),
+ * asignación de columnas y revisión con validación fila a fila antes de importar.
+ *
+ * - Lee .xlsx en el navegador (varias hojas), CSV con `,` o `;` y lo copiado de una hoja de cálculo.
+ * - Asigna sola cada columna cuyo encabezado coincide con el campo (o sus `aliases`).
+ * - Interpreta importes (`$ 1.234,56`, `(1.234)`), fechas (`DD/MM/AAAA`, serie de Excel)
+ *   y casillas (Sí / No); marca cada celda con error y deja importar solo las filas válidas.
+ *
+ * @example
+ * ```html
+ * <cb-import-wizard [fields]="campos" (import)="guardar($event.rows)" />
+ * ```
+ */
+declare class CbImportWizard {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    protected readonly uid: string;
+    protected readonly steps: Step[];
+    protected readonly accept = ".csv,.tsv,.txt,.xlsx,text/csv,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    /** Campos de destino (clave, etiqueta, tipo, obligatorio, alias y validación). */
+    readonly fields: _angular_core.InputSignal<readonly CbImportField[]>;
+    /** Importa también las filas con errores (marcadas en `errors`). */
+    readonly allowInvalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Filas importadas (con tipo) y errores encontrados. */
+    readonly import: _angular_core.OutputEmitterRef<CbImportResult<Record<string, unknown>>>;
+    protected readonly step: _angular_core.WritableSignal<Step>;
+    protected readonly stepIndex: _angular_core.Signal<number>;
+    protected readonly dragging: _angular_core.WritableSignal<boolean>;
+    protected readonly pasteOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly fileName: _angular_core.WritableSignal<string>;
+    protected readonly error: _angular_core.WritableSignal<string>;
+    protected readonly sheets: _angular_core.WritableSignal<CbXlsxReadSheet[]>;
+    protected readonly sheetIndex: _angular_core.WritableSignal<number>;
+    private readonly text;
+    protected readonly hasHeader: _angular_core.WritableSignal<boolean>;
+    protected readonly mapping: _angular_core.WritableSignal<Record<string, number | null>>;
+    protected readonly onlyValid: _angular_core.WritableSignal<boolean>;
+    /** Filas leídas (de la hoja elegida o del texto). */
+    protected readonly raw: _angular_core.Signal<CbImportCell[][]>;
+    protected readonly headers: _angular_core.Signal<string[]>;
+    protected readonly dataRows: _angular_core.Signal<CbImportCell[][]>;
+    protected readonly sheetOptions: _angular_core.Signal<{
+        label: string;
+        value: number;
+    }[]>;
+    protected readonly columnOptions: _angular_core.Signal<{
+        label: string;
+        value: number;
+    }[]>;
+    protected readonly missing: _angular_core.Signal<string[]>;
+    private readonly texts;
+    private readonly converted;
+    protected readonly invalidRows: _angular_core.Signal<Set<number>>;
+    protected readonly validCount: _angular_core.Signal<number>;
+    private readonly errorIndex;
+    protected readonly previewRows: _angular_core.Signal<Record<string, unknown>[]>;
+    protected readonly previewColumns: _angular_core.Signal<CbDataGridColumn<Record<string, unknown>>[]>;
+    protected readonly importable: _angular_core.Signal<number>;
+    protected stepLabel(step: Step): string;
+    protected columnName(i: number): string;
+    protected example(key: string): string;
+    private plain;
+    protected onDrop(event: DragEvent): void;
+    protected onFile(event: Event): void;
+    protected onPaste(event: Event): void;
+    /** Carga un archivo (.xlsx, .csv, .tsv, .txt). */
+    load(file: File): Promise<void>;
+    /** Carga texto delimitado (CSV, TSV o lo pegado de una hoja de cálculo). */
+    loadText(text: string): void;
+    protected setHeader(value: boolean): void;
+    protected setMapping(key: string, column: number): void;
+    private remap;
+    protected canNext(): boolean;
+    protected next(): void;
+    protected back(): void;
+    protected finish(): void;
+    /** Vuelve al primer paso sin datos. */
+    reset(): void;
+    private focusHeading;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbImportWizard, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbImportWizard, "cb-import-wizard", never, { "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "allowInvalid": { "alias": "allowInvalid"; "required": false; "isSignal": true; }; }, { "import": "import"; }, never, never, true, never>;
+}
+
+export { CbImportWizard, autoMap, convertRows, detectDelimiter, parseAmount, parseBoolean, parseDate, parseDelimited };
+export type { CbImportError, CbImportField, CbImportFieldType, CbImportResult };
+//# sourceMappingURL=caribeng-ui-import-wizard.d.ts.map