@caribeng/ui 22.2.0 → 22.5.0

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

@@ -0,0 +1,109 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/** Movimiento del extracto o de los libros (positivo: entra; negativo: sale). */
+interface CbReconItem {
+    readonly id: string | number;
+    /** `Date` o `AAAA-MM-DD`. */
+    readonly date: Date | string;
+    readonly description: string;
+    readonly amount: number;
+    /** Referencia (cheque, transferencia, factura): si coincide, ayuda a emparejar. */
+    readonly reference?: string;
+}
+/** Emparejamiento: uno o varios movimientos del extracto con uno o varios de los libros. */
+interface CbReconMatch {
+    readonly statement: readonly (string | number)[];
+    readonly ledger: readonly (string | number)[];
+}
+declare function sumAmounts(items: readonly CbReconItem[]): number;
+/** Ids ya emparejados de cada lado. */
+declare function matchedIds(matches: readonly CbReconMatch[]): {
+    statement: Set<string | number>;
+    ledger: Set<string | number>;
+};
+/**
+ * Empareja solo, uno a uno, los movimientos pendientes con el mismo valor y una
+ * fecha cercana (`toleranceDays`): primero los de igual referencia, después los
+ * de fecha más próxima.
+ */
+declare function autoMatch(statement: readonly CbReconItem[], ledger: readonly CbReconItem[], existing: readonly CbReconMatch[], toleranceDays?: number): CbReconMatch[];
+
+type Side = 'statement' | 'ledger';
+/**
+ * Conciliación bancaria de CaribeNG: el extracto del banco frente a los
+ * movimientos en libros, para emparejarlos y ver qué queda pendiente.
+ *
+ * - «Conciliar automáticamente» empareja los de igual valor y fecha cercana
+ *   (`toleranceDays`), dando prioridad a la misma referencia.
+ * - Se marcan movimientos de cada lado y «Emparejar» los une cuando sus sumas
+ *   coinciden (uno con uno, uno con varios o varios con uno).
+ * - Resumen con los pendientes de cada lado y la diferencia; `createEntry` sirve
+ *   para registrar en libros un movimiento del extracto (comisiones, intereses).
+ *
+ * @example
+ * ```html
+ * <cb-reconciliation [statement]="extracto" [ledger]="libros" [(matches)]="conciliados" />
+ * ```
+ */
+declare class CbReconciliation {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly amount;
+    protected readonly uid: string;
+    protected readonly sides: Side[];
+    /** Movimientos del extracto bancario. */
+    readonly statement: _angular_core.InputSignal<readonly CbReconItem[]>;
+    /** Movimientos en libros (cuenta de bancos). */
+    readonly ledger: _angular_core.InputSignal<readonly CbReconItem[]>;
+    /** Emparejamientos (bidireccional). */
+    readonly matches: _angular_core.ModelSignal<readonly CbReconMatch[]>;
+    /** Días de diferencia admitidos al conciliar automáticamente. */
+    readonly toleranceDays: _angular_core.InputSignal<number>;
+    readonly statementLabel: _angular_core.InputSignal<string>;
+    readonly ledgerLabel: _angular_core.InputSignal<string>;
+    /** Botón «Crear asiento» en los movimientos del extracto sin pareja. */
+    readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    /** Registrar en libros un movimiento del extracto. */
+    readonly createEntry: _angular_core.OutputEmitterRef<CbReconItem>;
+    protected readonly onlyPending: _angular_core.WritableSignal<boolean>;
+    private readonly selection;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private readonly matched;
+    protected items(side: Side): readonly CbReconItem[];
+    protected visible(side: Side): CbReconItem[];
+    protected pending(side: Side): CbReconItem[];
+    protected pendingSum(side: Side): number;
+    protected total(side: Side): number;
+    protected readonly progress: _angular_core.Signal<number>;
+    protected isMatched(side: Side, item: CbReconItem): boolean;
+    protected isSelected(side: Side, item: CbReconItem): boolean;
+    protected selectedItems(side: Side): CbReconItem[];
+    protected selectedSum(side: Side): number;
+    protected readonly hasSelection: _angular_core.Signal<boolean>;
+    protected readonly selectionDiff: _angular_core.Signal<number>;
+    /** Se puede emparejar: hay de los dos lados, nada ya emparejado y las sumas coinciden. */
+    protected readonly canMatch: _angular_core.Signal<boolean>;
+    protected readonly selectedMatched: _angular_core.Signal<boolean>;
+    protected money(value: number): string;
+    protected pct(value: number): string;
+    protected shortDate(value: Date | string): string;
+    protected toggle(side: Side, item: CbReconItem): void;
+    /** Empareja los movimientos pendientes de igual valor y fecha cercana. */
+    runAuto(): void;
+    /** Une lo seleccionado de los dos lados (si sus sumas coinciden). */
+    matchSelection(): void;
+    /** Deshace los emparejamientos que tocan lo seleccionado. */
+    unmatchSelection(): void;
+    private clearSelection;
+    private say;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbReconciliation, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbReconciliation, "cb-reconciliation", never, { "statement": { "alias": "statement"; "required": false; "isSignal": true; }; "ledger": { "alias": "ledger"; "required": false; "isSignal": true; }; "matches": { "alias": "matches"; "required": false; "isSignal": true; }; "toleranceDays": { "alias": "toleranceDays"; "required": false; "isSignal": true; }; "statementLabel": { "alias": "statementLabel"; "required": false; "isSignal": true; }; "ledgerLabel": { "alias": "ledgerLabel"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; }, { "matches": "matchesChange"; "createEntry": "createEntry"; }, never, never, true, never>;
+}
+
+export { CbReconciliation, autoMatch, matchedIds, sumAmounts };
+export type { CbReconItem, CbReconMatch };
+//# sourceMappingURL=caribeng-ui-reconciliation.d.ts.map

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

@@ -0,0 +1,188 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+
+/**
+ * Modelo del calendario de eventos: fechas, rejilla del mes, eventos de cada
+ * día y colocación de los que se solapan. Funciones puras (sin DOM).
+ */
+/** Evento del calendario. `start` y `end` son fecha y hora (`Date` o ISO); en uno de día completo, días. */
+interface CbSchedulerEvent {
+    readonly id: string;
+    readonly title: string;
+    readonly start: string | Date;
+    /** Fin (exclusivo en eventos con hora; inclusivo en los de día completo). Por defecto, una hora después. */
+    readonly end?: string | Date;
+    /** Evento de día completo (va en la franja superior). */
+    readonly allDay?: boolean;
+    readonly color?: string;
+    readonly location?: string;
+    readonly description?: string;
+}
+/** Vista del calendario. */
+type CbSchedulerView = 'month' | 'week' | 'day' | 'agenda';
+/** Un evento cambió de fecha u hora (al arrastrarlo, redimensionarlo o con el teclado). */
+interface CbSchedulerChange {
+    readonly event: CbSchedulerEvent;
+    readonly previous: CbSchedulerEvent;
+}
+/** Hueco elegido para crear un evento. */
+interface CbSchedulerSlot {
+    readonly start: Date;
+    readonly end: Date;
+    readonly allDay: boolean;
+}
+/** Evento con sus fechas resueltas. En los de día completo, `end` es el último día (inclusivo). */
+interface ResolvedEvent {
+    readonly event: CbSchedulerEvent;
+    readonly start: Date;
+    readonly end: Date;
+    readonly allDay: boolean;
+}
+/** Posición de un evento con hora dentro de su día: columna y número de columnas del grupo que se solapa. */
+interface PlacedEvent {
+    readonly e: ResolvedEvent;
+    /** Minutos desde la medianoche, recortados al día. */
+    readonly from: number;
+    readonly to: number;
+    readonly column: number;
+    readonly columns: number;
+}
+
+interface Preview {
+    readonly id: string | null;
+    readonly days: number;
+    readonly minutes: number;
+    /** Hueco seleccionado (al arrastrar sobre una franja vacía). */
+    readonly select: {
+        day: Date;
+        from: number;
+        to: number;
+    } | null;
+}
+/**
+ * Calendario de eventos de CaribeNG: vistas de mes, semana, día y agenda.
+ *
+ * - En semana y día, los eventos con hora se colocan en su franja (los que se
+ *   solapan, uno al lado del otro) y los de día completo en la franja superior;
+ *   una línea marca la hora actual.
+ * - Arrastra un evento para moverlo y su borde inferior para cambiar la duración;
+ *   arrastra sobre una franja vacía (o haz clic) para elegir un hueco
+ *   (`slotSelect`). En el mes, los eventos se arrastran de un día a otro.
+ * - Con el teclado cada evento es un botón: flechas lo mueven (un día, o la
+ *   duración de una franja), Mayús + flechas arriba / abajo cambian la duración y
+ *   Enter lo abre; cada día tiene un botón para crear un evento.
+ *
+ * @example
+ * ```html
+ * <cb-scheduler [(events)]="eventos" [(view)]="vista" (slotSelect)="crear($event)" (eventOpen)="abrir($event)" />
+ * ```
+ */
+declare class CbScheduler {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    protected readonly Math: Math;
+    private readonly injector;
+    private readonly host;
+    protected readonly uid: string;
+    protected readonly hour = 48;
+    protected readonly ppm: number;
+    protected readonly hours: number[];
+    /** Eventos (bidireccional: se actualiza al moverlos o cambiar su duración). */
+    readonly events: _angular_core.ModelSignal<readonly CbSchedulerEvent[]>;
+    readonly view: _angular_core.ModelSignal<CbSchedulerView>;
+    /** Día de referencia de la vista (el mes, la semana o el día que se muestra). */
+    readonly date: _angular_core.ModelSignal<Date>;
+    /** Vistas disponibles y su orden. */
+    readonly views: _angular_core.InputSignal<readonly CbSchedulerView[]>;
+    /** Primer día de la semana (0 = domingo, 1 = lunes). */
+    readonly firstDayOfWeek: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Minutos de cada franja: paso al arrastrar y con el teclado. */
+    readonly slotMinutes: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Hora a la que se desplaza la vista de semana o día al abrirse. */
+    readonly scrollHour: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Días que muestra la agenda desde el día de referencia. */
+    readonly agendaDays: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Permite mover, cambiar la duración y elegir huecos. */
+    readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Alto del área del calendario. */
+    readonly height: _angular_core.InputSignal<string>;
+    /** Un evento cambió de fecha u hora. */
+    readonly eventChange: _angular_core.OutputEmitterRef<CbSchedulerChange>;
+    /** Clic o Enter sobre un evento. */
+    readonly eventOpen: _angular_core.OutputEmitterRef<CbSchedulerEvent>;
+    /** Se eligió un hueco (arrastrando o con clic en una franja, doble clic o el botón + de un día). */
+    readonly slotSelect: _angular_core.OutputEmitterRef<CbSchedulerSlot>;
+    protected readonly preview: _angular_core.WritableSignal<Preview | null>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    private readonly now;
+    private drag;
+    /** Tras arrastrar un evento no se emite el clic que lo sigue. */
+    private suppressClick;
+    private readonly scrollRef;
+    constructor();
+    private readonly resolved;
+    /** Eventos con la vista previa del arrastre aplicada. */
+    private readonly shown;
+    /** Días de la vista de semana o día. */
+    protected readonly days: _angular_core.Signal<Date[]>;
+    protected readonly weeks: _angular_core.Signal<Date[][]>;
+    protected readonly weekdayNames: _angular_core.Signal<string[]>;
+    protected readonly agenda: _angular_core.Signal<{
+        day: Date;
+        events: ResolvedEvent[];
+    }[]>;
+    protected readonly title: _angular_core.Signal<string>;
+    private rangeText;
+    protected readonly nowTop: _angular_core.Signal<number>;
+    /** Hueco seleccionado al arrastrar sobre una franja. */
+    protected readonly selection: _angular_core.Signal<{
+        day: Date;
+        from: number;
+        to: number;
+    } | null>;
+    /** Día bajo el puntero al arrastrar en el mes o en la franja de día completo. */
+    protected readonly dropDay: _angular_core.Signal<Date | null>;
+    protected viewLabel(v: CbSchedulerView): string;
+    protected time(d: Date): string;
+    protected hourLabel(h: number): string;
+    protected weekday(d: Date): string;
+    /** Cabecera de un día de la agenda (el número va aparte): "Viernes, octubre". */
+    protected agendaDay(d: Date): string;
+    protected longDay(d: Date): string;
+    protected eventLabel(e: ResolvedEvent): string;
+    protected isToday(d: Date): boolean;
+    protected isMulti(e: ResolvedEvent): boolean;
+    protected minuteDate(day: Date, minute: number): Date;
+    protected dayEvents(d: Date): ResolvedEvent[];
+    /** En el mes, si sobra uno se muestra (no "+1 más"). */
+    protected limitFor(d: Date): number;
+    protected allDayEvents(d: Date): ResolvedEvent[];
+    protected placed(d: Date): PlacedEvent[];
+    /** Periodo anterior (−1) o siguiente (1). */
+    step(direction: 1 | -1): void;
+    goToday(): void;
+    /** Abre la vista de día de una fecha. */
+    openDay(d: Date): void;
+    protected selectDay(d: Date): void;
+    protected selectTime(d: Date, minute: number): void;
+    /** Día (y minuto, en las columnas de hora) bajo el puntero. */
+    private pointAt;
+    private snap;
+    protected onEventPointerDown(event: PointerEvent, e: ResolvedEvent, mode: 'move' | 'resize', day: Date, dayOnly: boolean): void;
+    protected onColumnPointerDown(event: PointerEvent, d: Date): void;
+    protected onPointerMove(event: PointerEvent): void;
+    protected onPointerUp(): void;
+    private selectRange;
+    protected cancelDrag(): void;
+    protected onEventClick(e: ResolvedEvent): void;
+    private apply;
+    protected onEventKeydown(event: KeyboardEvent, e: ResolvedEvent, dayOnly: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbScheduler, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbScheduler, "cb-scheduler", never, { "events": { "alias": "events"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": false; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "slotMinutes": { "alias": "slotMinutes"; "required": false; "isSignal": true; }; "scrollHour": { "alias": "scrollHour"; "required": false; "isSignal": true; }; "agendaDays": { "alias": "agendaDays"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, { "events": "eventsChange"; "view": "viewChange"; "date": "dateChange"; "eventChange": "eventChange"; "eventOpen": "eventOpen"; "slotSelect": "slotSelect"; }, never, never, true, never>;
+}
+
+export { CbScheduler };
+export type { CbSchedulerChange, CbSchedulerEvent, CbSchedulerSlot, CbSchedulerView };
+//# sourceMappingURL=caribeng-ui-scheduler.d.ts.map

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 
 /**
- * Shortcut de Caribe Design: acceso directo con icono y etiqueta, presentado
+ * Shortcut: acceso directo con icono y etiqueta, presentado
  * como una tarjeta pulsable (típico de dashboards y home bancario).
  *
  * @example
@@ -25,4 +25,4 @@ declare class CbShortcut {
 }
 
 export { CbShortcut };
-//# sourceMappingURL=caribeng-ui-caribe-shortcut.d.ts.map
+//# sourceMappingURL=caribeng-ui-shortcut.d.ts.map

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

@@ -0,0 +1,167 @@
+import * as _caribeng_ui_sidebar from '@caribeng/ui/sidebar';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Signal } from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Enlace o acción del menú lateral. */
+interface CbSidebarItem {
+    /** Identificador para `active`. Por defecto, la `url` o el `label`. */
+    id?: string;
+    label: string;
+    icon?: string;
+    url?: string;
+    target?: string;
+    /** Contador o etiqueta a la derecha ("3", "Nuevo"). */
+    badge?: string | number;
+    disabled?: boolean;
+    /** Subelementos (un nivel): el item se convierte en un grupo desplegable. */
+    children?: readonly CbSidebarItem[];
+    /** Acción al elegirlo (además del evento `itemSelect`). */
+    command?: (event: CbSidebarSelectEvent) => void;
+}
+/** Sección del menú lateral con título opcional. */
+interface CbSidebarGroup {
+    label?: string;
+    items: readonly CbSidebarItem[];
+}
+interface CbSidebarSelectEvent {
+    readonly item: CbSidebarItem;
+    readonly originalEvent: Event;
+}
+/** Clave de un item para `active`. */
+declare function cbSidebarKey(item: CbSidebarItem): string;
+/** Estado del `cb-app-shell` compartido con el sidebar y los botones `cbSidebarToggle`. */
+interface CbAppShellState {
+    /** Ancho por debajo del punto de corte: el sidebar es un panel deslizante. */
+    readonly mobile: Signal<boolean>;
+    /** Panel abierto (solo en móvil). */
+    readonly sidebarOpen: Signal<boolean>;
+    /** Sidebar contraído a iconos (solo en escritorio). */
+    readonly collapsed: Signal<boolean>;
+    readonly sidebarId: string;
+    /** En móvil abre o cierra el panel; en escritorio contrae o expande. */
+    toggle(): void;
+    setCollapsed(collapsed: boolean): void;
+    /** Cierra el panel móvil (p. ej. al navegar). */
+    closeSidebar(): void;
+}
+declare const CB_APP_SHELL: InjectionToken<CbAppShellState>;
+
+/**
+ * Menú lateral de CaribeNG: secciones con título, enlaces con icono y badge,
+ * grupos desplegables de un nivel y modo contraído a iconos (con tooltip).
+ * Dentro de `cb-app-shell` se convierte en panel deslizante en móvil.
+ *
+ * @example
+ * ```html
+ * <cb-sidebar [groups]="menu" [(active)]="seccion" [navigate]="navigate">
+ *   <img cb-sidebar-header src="logo.svg" alt="Mi banco" />
+ * </cb-sidebar>
+ * ```
+ */
+declare class CbSidebar {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** `cb-app-shell` que lo contiene, si hay. */
+    protected readonly shell: _caribeng_ui_sidebar.CbAppShellState | null;
+    protected readonly uid: string;
+    readonly groups: _angular_core.InputSignal<readonly CbSidebarGroup[]>;
+    /** Clave del item activo (`id`, `url` o `label`); se marca con `aria-current="page"`. */
+    readonly active: _angular_core.ModelSignal<string | null>;
+    /** Contraído a iconos. Dentro de `cb-app-shell` lo controla el shell. */
+    readonly collapsed: _angular_core.ModelSignal<boolean>;
+    /** Muestra el botón de contraer/expandir en el pie. */
+    readonly collapsible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nombre de la navegación. Por defecto, "Navegación principal". */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Navegación SPA: si se indica, los enlaces internos (sin `target` ni teclas
+     * modificadoras) la llaman en lugar de recargar la página.
+     * Ej.: `navigate = (url: string) => this.router.navigateByUrl(url)`.
+     */
+    readonly navigate: _angular_core.InputSignal<((url: string) => unknown) | null>;
+    /** Item elegido. */
+    readonly itemSelect: _angular_core.OutputEmitterRef<CbSidebarSelectEvent>;
+    private readonly expanded;
+    protected readonly isCollapsed: _angular_core.Signal<boolean>;
+    constructor();
+    protected key(item: CbSidebarItem): string;
+    protected isActive(item: CbSidebarItem): boolean;
+    protected hasActiveChild(item: CbSidebarItem): boolean;
+    protected isExpanded(item: CbSidebarItem): boolean;
+    protected toggleGroup(item: CbSidebarItem): void;
+    protected toggleCollapsed(): void;
+    private setCollapsed;
+    /** Marca el item como activo, ejecuta su `command`, emite `itemSelect` y navega. */
+    select(item: CbSidebarItem, event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbSidebar, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbSidebar, "cb-sidebar", never, { "groups": { "alias": "groups"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "navigate": { "alias": "navigate"; "required": false; "isSignal": true; }; }, { "active": "activeChange"; "collapsed": "collapsedChange"; "itemSelect": "itemSelect"; }, never, ["[cb-sidebar-header]", "[cb-sidebar-footer]"], true, never>;
+}
+
+/**
+ * Esqueleto de aplicación de CaribeNG: menú lateral, cabecera y contenido.
+ * En escritorio el sidebar es una columna que se puede contraer; por debajo de
+ * `breakpoint` (medido en el propio shell) pasa a ser un panel deslizante con
+ * fondo, cierre con Escape y foco atrapado mientras está abierto.
+ *
+ * @example
+ * ```html
+ * <cb-app-shell style="height: 100vh">
+ *   <cb-sidebar [groups]="menu" />
+ *   <header cb-app-shell-header>
+ *     <button type="button" cbSidebarToggle><cb-icon name="menu" /></button>
+ *   </header>
+ *   <router-outlet />
+ * </cb-app-shell>
+ * ```
+ */
+declare class CbAppShell implements CbAppShellState {
+    private readonly host;
+    private readonly document;
+    private readonly injector;
+    private readonly destroyRef;
+    private previouslyFocused;
+    readonly sidebarId: string;
+    /** Ancho (px) del shell por debajo del cual el sidebar es un panel deslizante. */
+    readonly breakpoint: _angular_core.InputSignal<number>;
+    /** Panel abierto en móvil. */
+    readonly sidebarOpen: _angular_core.ModelSignal<boolean>;
+    /** Sidebar contraído a iconos en escritorio. */
+    readonly collapsed: _angular_core.ModelSignal<boolean>;
+    /** Fuerza el modo móvil (útil en pruebas o vistas embebidas). */
+    readonly forceMobile: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly width;
+    readonly mobile: _angular_core.Signal<boolean>;
+    constructor();
+    toggle(): void;
+    setCollapsed(collapsed: boolean): void;
+    closeSidebar(): void;
+    protected onEscape(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbAppShell, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbAppShell, "cb-app-shell", never, { "breakpoint": { "alias": "breakpoint"; "required": false; "isSignal": true; }; "sidebarOpen": { "alias": "sidebarOpen"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "forceMobile": { "alias": "forceMobile"; "required": false; "isSignal": true; }; }, { "sidebarOpen": "sidebarOpenChange"; "collapsed": "collapsedChange"; }, never, ["cb-sidebar, [cb-app-shell-sidebar]", "[cb-app-shell-header]", "*"], true, never>;
+}
+
+/**
+ * Convierte cualquier botón en el control del sidebar de `cb-app-shell`: en
+ * móvil abre o cierra el panel; en escritorio contrae o expande. Gestiona
+ * `aria-controls`, `aria-expanded` y un nombre accesible por defecto.
+ *
+ * @example
+ * ```html
+ * <button type="button" cbSidebarToggle><cb-icon name="menu" aria-hidden="true" /></button>
+ * ```
+ */
+declare class CbSidebarToggle {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly shell: _caribeng_ui_sidebar.CbAppShellState | null;
+    /** Nombre accesible. Por defecto, "Abrir menú" (móvil) o "Contraer/Expandir menú lateral". */
+    readonly cbSidebarToggle: _angular_core.InputSignal<string>;
+    protected readonly expanded: _angular_core.Signal<boolean | null>;
+    protected readonly label: _angular_core.Signal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbSidebarToggle, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbSidebarToggle, "[cbSidebarToggle]", never, { "cbSidebarToggle": { "alias": "cbSidebarToggle"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CB_APP_SHELL, CbAppShell, CbSidebar, CbSidebarToggle, cbSidebarKey };
+export type { CbAppShellState, CbSidebarGroup, CbSidebarItem, CbSidebarSelectEvent };
+//# sourceMappingURL=caribeng-ui-sidebar.d.ts.map

package/types/caribeng-ui-signature-pad.d.ts

@@ -0,0 +1,151 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { ControlValueAccessor } from '@angular/forms';
+
+/** Punto de un trazo, en unidades del `viewBox` (`t` en ms, `p` presión 0–1). */
+interface CbSignaturePoint {
+    readonly x: number;
+    readonly y: number;
+    readonly t: number;
+    readonly p: number;
+}
+type CbSignatureStroke = readonly CbSignaturePoint[];
+/** Firma serializable: trazos dibujados o nombre escrito, con su lienzo y su tinta. */
+interface CbSignatureData {
+    readonly width: number;
+    readonly height: number;
+    readonly strokes: readonly CbSignatureStroke[];
+    /** Nombre escrito (modo `type`); si hay texto, se pinta en lugar de los trazos. */
+    readonly text?: string;
+    readonly color: string;
+}
+/** Formato de `value`. */
+type CbSignatureFormat = 'png' | 'jpeg' | 'svg';
+/** Cómo se firma: a mano o escribiendo el nombre. */
+type CbSignatureMode = 'draw' | 'type';
+/** Segmento listo para pintar: un trozo de curva con su grosor. */
+interface CbSignatureSegment {
+    readonly d: string;
+    readonly width: number;
+}
+/** Tipografías manuscritas del sistema (sin descargar fuentes) para el modo escrito. */
+declare const CB_SIGNATURE_FONT = "'Segoe Script', 'Bradley Hand', 'Brush Script MT', 'Snell Roundhand', 'URW Chancery L', cursive";
+/**
+ * La firma como documento SVG independiente (sin dependencias de la página). `background`
+ * vacío o `transparent` lo deja sin fondo; `image` es una firma previa que va debajo.
+ */
+declare function signatureToSvg(data: CbSignatureData, options: {
+    minWidth: number;
+    maxWidth: number;
+    background?: string;
+    font?: string;
+    fontSize?: number;
+    image?: string;
+}): string;
+
+/**
+ * Firma digital de CaribeNG: área para firmar con ratón, dedo o lápiz (grosor según velocidad y
+ * presión) o, como alternativa accesible, escribiendo el nombre en letra manuscrita. Devuelve la
+ * firma como PNG, JPEG o SVG (`[(value)]`, también con Angular Forms) y permite deshacer y borrar.
+ *
+ * @example
+ * ```html
+ * <cb-signature-pad [(value)]="firma" format="png" />
+ * ```
+ */
+declare class CbSignaturePad implements ControlValueAccessor {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly injector;
+    private readonly destroyRef;
+    protected readonly hintId: string;
+    /** Firma como data URL en `format` (`''` si está vacía). Una firma que llega de fuera se muestra de fondo. */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Formato de `value`: PNG (por defecto), JPEG (fondo blanco) o SVG. */
+    readonly format: _angular_core.InputSignal<CbSignatureFormat>;
+    /** Dibujar a mano o escribir el nombre. */
+    readonly mode: _angular_core.ModelSignal<CbSignatureMode>;
+    /** Ofrece el modo escrito, la alternativa para quien no puede dibujar (teclado, lector de pantalla). */
+    readonly typing: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly penColor: _angular_core.InputSignal<string>;
+    /** Fondo del área y de la imagen exportada (`transparent` para PNG o SVG sin fondo). */
+    readonly background: _angular_core.InputSignal<string>;
+    /** Grosor mínimo y máximo del trazo (en píxeles del área). */
+    readonly minWidth: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly maxWidth: _angular_core.InputSignalWithTransform<number, unknown>;
+    readonly height: _angular_core.InputSignal<string>;
+    /** Tipografía del nombre escrito (por defecto, manuscritas del sistema). */
+    readonly font: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nombre del área (por defecto, "Área de firma"). */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Empieza un trazo. */
+    readonly signStart: _angular_core.OutputEmitterRef<void>;
+    /** Termina un trazo o cambia el nombre escrito (con la firma completa). */
+    readonly signEnd: _angular_core.OutputEmitterRef<CbSignatureData>;
+    readonly cleared: _angular_core.OutputEmitterRef<void>;
+    protected readonly fieldState: _caribeng_ui.CbFieldState;
+    private readonly cvaDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly strokes: _angular_core.WritableSignal<readonly CbSignatureStroke[]>;
+    private readonly current;
+    protected readonly text: _angular_core.WritableSignal<string>;
+    /** Firma previa (de `value`), pintada de fondo. */
+    protected readonly image: _angular_core.WritableSignal<string>;
+    /** Tamaño lógico del lienzo (el del área al montarse). */
+    protected readonly box: _angular_core.WritableSignal<{
+        w: number;
+        h: number;
+    }>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    protected readonly canDraw: _angular_core.Signal<boolean>;
+    protected readonly segments: _angular_core.Signal<CbSignatureSegment[]>;
+    /** Tamaño medido para que el nombre quepa (cada tipografía manuscrita tiene su ancho). */
+    private readonly fittedSize;
+    protected readonly fontSize: _angular_core.Signal<number>;
+    protected readonly empty: _angular_core.Signal<boolean>;
+    protected readonly padLabel: _angular_core.Signal<string>;
+    private readonly svg;
+    private pointerId;
+    private lastEmitted;
+    private emitToken;
+    private onChange;
+    protected onTouched: () => void;
+    constructor();
+    /** La firma actual (trazos o nombre escrito), para guardarla y restaurarla con `setData`. */
+    data(): CbSignatureData;
+    /** Restaura una firma guardada con `data()`. */
+    setData(data: CbSignatureData): void;
+    /** La firma como SVG independiente. */
+    toSvg(): string;
+    /** La firma como data URL (PNG y JPEG se generan en un canvas, de forma asíncrona). */
+    toDataUrl(format?: CbSignatureFormat): Promise<string>;
+    /** Borra la firma. */
+    clear(): void;
+    /** Deshace el último trazo. */
+    undo(): void;
+    writeValue(value: string | null | undefined): void;
+    registerOnChange(fn: (v: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(disabled: boolean): void;
+    protected setMode(mode: CbSignatureMode): void;
+    protected onType(event: Event): void;
+    private fitText;
+    protected onPointerDown(event: PointerEvent): void;
+    protected onPointerMove(event: PointerEvent): void;
+    protected onPointerUp(event: PointerEvent): void;
+    private point;
+    /** Recalcula `value` (PNG y JPEG llegan cuando termina el canvas; uno viejo se descarta). */
+    private emit;
+    /** 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<CbSignaturePad, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbSignaturePad, "cb-signature-pad", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "typing": { "alias": "typing"; "required": false; "isSignal": true; }; "penColor": { "alias": "penColor"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "font": { "alias": "font"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "mode": "modeChange"; "signStart": "signStart"; "signEnd": "signEnd"; "cleared": "cleared"; }, never, never, true, never>;
+}
+
+export { CB_SIGNATURE_FONT, CbSignaturePad, signatureToSvg as cbSignatureToSvg };
+export type { CbSignatureData, CbSignatureFormat, CbSignatureMode, CbSignaturePoint, CbSignatureStroke };
+//# sourceMappingURL=caribeng-ui-signature-pad.d.ts.map

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

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 
 /**
- * Status de Caribe Design: chip de estado con punto de color y etiqueta.
+ * Status: chip de estado con punto de color y etiqueta.
  *
  * @example
  * ```html
@@ -16,4 +16,4 @@ declare class CbStatus {
 }
 
 export { CbStatus };
-//# sourceMappingURL=caribeng-ui-caribe-status.d.ts.map
+//# sourceMappingURL=caribeng-ui-status.d.ts.map