@caribeng/ui 22.2.0 → 22.5.0

package/types/caribeng-ui-infinite-scroll.d.ts

@@ -0,0 +1,75 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** `auto`: carga al llegar al final; `button`: solo con el botón "Cargar más". */
+type CbInfiniteScrollMode = 'auto' | 'button';
+/** Quién pidió la carga. */
+type CbLoadMoreSource = 'scroll' | 'button' | 'retry';
+/**
+ * Scroll infinito de CaribeNG: envuelve una lista y pide más elementos (`loadMore`) al acercarse
+ * al final, con un botón "Cargar más" como alternativa. Tras `autoLimit` cargas automáticas pasa
+ * al botón, para que el pie de página siga siendo alcanzable; anuncia las cargas y, al cargar con
+ * el botón, lleva el foco al primer elemento nuevo.
+ *
+ * @example
+ * ```html
+ * <cb-infinite-scroll [loading]="cargando()" [hasMore]="hayMas()" [count]="items().length" (loadMore)="cargar()">
+ *   <ul>@for (i of items(); track i.id) { <li>{{ i.nombre }}</li> }</ul>
+ * </cb-infinite-scroll>
+ * ```
+ */
+declare class CbInfiniteScroll {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly host;
+    private readonly injector;
+    /** Hay una carga en curso (muestra el indicador y evita pedir otra). */
+    readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Quedan elementos por cargar. */
+    readonly hasMore: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** La última carga falló: muestra el aviso y "Reintentar". */
+    readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Número de elementos ya cargados: para anunciar cuántos llegaron y enfocar el primero nuevo. */
+    readonly count: _angular_core.InputSignal<number | undefined>;
+    /** Carga automática al llegar al final o solo con el botón. */
+    readonly mode: _angular_core.InputSignal<CbInfiniteScrollMode>;
+    /** Cargas automáticas seguidas antes de pasar al botón (0 = sin límite). */
+    readonly autoLimit: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Distancia al final a la que se empieza a cargar (margen del IntersectionObserver). */
+    readonly threshold: _angular_core.InputSignal<string>;
+    /** El propio componente hace scroll, con este alto máximo (si no, se usa la página). */
+    readonly scrollable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly height: _angular_core.InputSignal<string>;
+    /** Elementos de la lista, para llevar el foco al primero nuevo tras "Cargar más". */
+    readonly itemSelector: _angular_core.InputSignal<string>;
+    /** Mensaje al llegar al final (con `showEnd`). */
+    readonly showEnd: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly endMessage: _angular_core.InputSignal<string | undefined>;
+    readonly errorMessage: _angular_core.InputSignal<string | undefined>;
+    readonly loadMoreLabel: _angular_core.InputSignal<string | undefined>;
+    /** Pide la siguiente página. */
+    readonly loadMore: _angular_core.OutputEmitterRef<CbLoadMoreSource>;
+    protected readonly announcement: _angular_core.WritableSignal<string>;
+    /** Cargas automáticas desde la última con el botón. */
+    private readonly autoCount;
+    protected readonly showButton: _angular_core.Signal<boolean>;
+    private readonly sentinel;
+    private readonly observerSupported;
+    /** Cuántos había al pedir la carga y si la pidió el botón (para el anuncio y el foco). */
+    private pending;
+    private visible;
+    constructor();
+    /** Vuelve a permitir cargas automáticas (p. ej. al cambiar un filtro y reiniciar la lista). */
+    reset(): void;
+    protected request(source: CbLoadMoreSource): void;
+    private tryAuto;
+    private focusItem;
+    /** 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<CbInfiniteScroll, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbInfiniteScroll, "cb-infinite-scroll", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "hasMore": { "alias": "hasMore"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "autoLimit": { "alias": "autoLimit"; "required": false; "isSignal": true; }; "threshold": { "alias": "threshold"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "itemSelector": { "alias": "itemSelector"; "required": false; "isSignal": true; }; "showEnd": { "alias": "showEnd"; "required": false; "isSignal": true; }; "endMessage": { "alias": "endMessage"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "loadMoreLabel": { "alias": "loadMoreLabel"; "required": false; "isSignal": true; }; }, { "loadMore": "loadMore"; }, never, ["*"], true, never>;
+}
+
+export { CbInfiniteScroll };
+export type { CbInfiniteScrollMode, CbLoadMoreSource };
+//# sourceMappingURL=caribeng-ui-infinite-scroll.d.ts.map

package/types/caribeng-ui-input-number.d.ts

@@ -77,7 +77,7 @@ declare class CbInputNumber implements ControlValueAccessor {
     registerOnChange(fn: (value: number | null) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
-    protected onFocus(): void;
+    protected onFocus(event: FocusEvent): void;
     protected onInput(event: Event): void;
     protected onBlur(): void;
     protected onKeydown(event: KeyboardEvent): void;

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

@@ -3,7 +3,7 @@ import * as _caribeng_ui from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
- * Input-search de Caribe Design: campo de búsqueda con icono, botón de limpiar
+ * Input-search: campo de búsqueda con icono, botón de limpiar
  * e integración con Angular Forms (CVA).
  *
  * @example
@@ -37,4 +37,4 @@ declare class CbInputSearch implements ControlValueAccessor {
 }
 
 export { CbInputSearch };
-//# sourceMappingURL=caribeng-ui-caribe-input-search.d.ts.map
+//# sourceMappingURL=caribeng-ui-input-search.d.ts.map

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

@@ -4,7 +4,7 @@ import { cbFormat } from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 
 /**
- * Input-token de Caribe Design: entrada de código OTP con casillas por dígito,
+ * Input-token: entrada de código OTP con casillas por dígito,
  * enmascarado opcional y CVA.
  *
  * @example
@@ -51,4 +51,4 @@ declare class CbInputToken implements ControlValueAccessor {
 }
 
 export { CbInputToken };
-//# sourceMappingURL=caribeng-ui-caribe-input-token.d.ts.map
+//# sourceMappingURL=caribeng-ui-input-token.d.ts.map

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

@@ -18,6 +18,8 @@ declare class CbInputMask implements ControlValueAccessor {
     /** Estado de validación: inputs manuales + estado de Angular Forms. */
     protected readonly fieldState: _caribeng_ui.CbFieldState;
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** `id` del campo, para asociarlo a un `<label for>`. */
+    readonly inputId: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
     private readonly cvaDisabled;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
@@ -38,7 +40,7 @@ declare class CbInputMask implements ControlValueAccessor {
     private applyMask;
     private matchesToken;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbInputMask, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbInputMask, "cb-input-mask", never, { "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "unmask": { "alias": "unmask"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbInputMask, "cb-input-mask", never, { "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "unmask": { "alias": "unmask"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 export { CbInputMask };

package/types/caribeng-ui-journal-entry.d.ts

@@ -0,0 +1,110 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+import { CbAccount } from '@caribeng/ui/account-picker';
+import { CbDataGridColumn } from '@caribeng/ui/datagrid';
+
+/** Línea (movimiento) de un comprobante. */
+interface CbJournalLine {
+    readonly id: string | number;
+    /** Código de la cuenta. */
+    readonly account: string | null;
+    readonly thirdParty?: unknown;
+    readonly costCenter?: unknown;
+    /** Detalle de la línea (si queda vacío, al guardar toma la descripción del comprobante). */
+    readonly description?: string | null;
+    readonly debit: number | null;
+    readonly credit: number | null;
+}
+/** Comprobante contable (asiento). */
+interface CbJournalEntryData {
+    readonly date: Date | null;
+    /** Tipo de comprobante (`CE` egreso, `RC` recibo de caja…). */
+    readonly type?: unknown;
+    readonly number?: string | null;
+    readonly description?: string | null;
+    readonly lines: readonly CbJournalLine[];
+}
+/** Opción de tercero, centro de costo o tipo de comprobante. */
+interface CbJournalOption {
+    readonly label: string;
+    readonly value: unknown;
+    readonly description?: string;
+}
+/** Comprobante vacío con dos líneas. */
+declare function cbEmptyJournalEntry(date?: Date | null): CbJournalEntryData;
+/**
+ * Editor de comprobante contable de CaribeNG: cabecera (fecha, tipo, número y
+ * descripción) y líneas con cuenta, tercero, centro de costo, detalle, débito y
+ * crédito, editables como una hoja de cálculo.
+ *
+ * - La cuenta se busca por código o nombre en el plan de cuentas y solo admite
+ *   cuentas de movimiento; escribir el débito borra el crédito de la línea y al revés.
+ * - Totales de débitos y créditos con la diferencia en vivo; «Cuadrar» pone la
+ *   diferencia en la última línea vacía (o en una nueva).
+ * - Guardar (o Ctrl + Enter) valida fecha, líneas, cuentas y que cuadre, y emite `save`.
+ *
+ * @example
+ * ```html
+ * <cb-journal-entry [(entry)]="comprobante" [accounts]="puc" [thirdParties]="terceros" (save)="guardar($event)" />
+ * ```
+ */
+declare class CbJournalEntry {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly amount;
+    protected readonly uid: string;
+    private readonly grid;
+    /** Comprobante (bidireccional). */
+    readonly entry: _angular_core.ModelSignal<CbJournalEntryData>;
+    /** Plan de cuentas: solo se eligen cuentas de movimiento. */
+    readonly accounts: _angular_core.InputSignal<readonly CbAccount[]>;
+    /** Terceros (sin ellos no se muestra la columna). */
+    readonly thirdParties: _angular_core.InputSignal<readonly CbJournalOption[]>;
+    /** Centros de costo (sin ellos no se muestra la columna). */
+    readonly costCenters: _angular_core.InputSignal<readonly CbJournalOption[]>;
+    /** Tipos de comprobante (sin ellos no se muestra el campo). */
+    readonly types: _angular_core.InputSignal<readonly CbJournalOption[]>;
+    /** Cuentas que exigen tercero (por prefijo de código, p. ej. `['13', '22']`). */
+    readonly thirdPartyRequired: _angular_core.InputSignal<readonly string[]>;
+    /** Moneda de los importes (si no, la de `provideCaribeNG({ currency })`). */
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra el botón de guardar cargando. */
+    readonly saving: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly saveLabel: _angular_core.InputSignal<string | undefined>;
+    readonly scrollHeight: _angular_core.InputSignal<string | null>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Comprobante válido y cuadrado al guardar (líneas sin importe quitadas, detalles heredados). */
+    readonly save: _angular_core.OutputEmitterRef<CbJournalEntryData>;
+    /** Se intentó guardar con problemas: cuáles. */
+    readonly invalid: _angular_core.OutputEmitterRef<string[]>;
+    /** Se intentó guardar (desde entonces se muestran los problemas). */
+    protected readonly tried: _angular_core.WritableSignal<boolean>;
+    private readonly accountOptions;
+    protected readonly columns: _angular_core.Signal<CbDataGridColumn<CbJournalLine>[]>;
+    /** Totales de débitos y créditos y su diferencia. */
+    readonly totals: _angular_core.Signal<{
+        debit: number;
+        credit: number;
+        difference: number;
+    }>;
+    /** Débitos y créditos iguales y mayores que cero. */
+    readonly balanced: _angular_core.Signal<boolean>;
+    /** Problemas que impiden guardar. */
+    readonly problems: _angular_core.Signal<string[]>;
+    protected readonly newLine: () => CbJournalLine;
+    protected money(value: number): string;
+    protected patch(change: Partial<CbJournalEntryData>): void;
+    /** Pone la diferencia en la última línea sin importe (o en una nueva) para que cuadre. */
+    balance(): void;
+    /** Valida y, si está todo bien, emite `save`. */
+    submit(): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbJournalEntry, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbJournalEntry, "cb-journal-entry", never, { "entry": { "alias": "entry"; "required": false; "isSignal": true; }; "accounts": { "alias": "accounts"; "required": false; "isSignal": true; }; "thirdParties": { "alias": "thirdParties"; "required": false; "isSignal": true; }; "costCenters": { "alias": "costCenters"; "required": false; "isSignal": true; }; "types": { "alias": "types"; "required": false; "isSignal": true; }; "thirdPartyRequired": { "alias": "thirdPartyRequired"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "saving": { "alias": "saving"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": false; "isSignal": true; }; "scrollHeight": { "alias": "scrollHeight"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "entry": "entryChange"; "save": "save"; "invalid": "invalid"; }, never, never, true, never>;
+}
+
+export { CbJournalEntry, cbEmptyJournalEntry };
+export type { CbJournalEntryData, CbJournalLine, CbJournalOption };
+//# sourceMappingURL=caribeng-ui-journal-entry.d.ts.map