@caribeng/ui 22.2.0 → 22.5.0

package/types/caribeng-ui-period-picker.d.ts

@@ -0,0 +1,148 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbSize, CbRequiredIndicator } from '@caribeng/ui';
+import { ControlValueAccessor } from '@angular/forms';
+import { ConnectedPosition } from '@angular/cdk/overlay';
+
+/** Tipo de periodo contable. */
+type CbPeriodKind = 'month' | 'quarter' | 'year' | 'range';
+/** Periodo contable elegido. */
+interface CbPeriod {
+    readonly kind: CbPeriodKind;
+    /** Primer día (00:00). */
+    readonly from: Date;
+    /** Último día (00:00). */
+    readonly to: Date;
+    /** Clave estable: `2026-10`, `2026-Q3`, `2026` (año fiscal) o `2026-01-01_2026-10-23`. */
+    readonly key: string;
+}
+/** Atajos de periodo. */
+type CbPeriodPreset = 'thisMonth' | 'lastMonth' | 'thisQuarter' | 'lastQuarter' | 'yearToDate' | 'thisYear' | 'lastYear';
+/** Mes: `2026-10`. */
+declare function monthPeriod(year: number, month: number): CbPeriod;
+/**
+ * Año fiscal que empieza en `startMonth` (0 = enero). Se nombra por el año en
+ * que termina (con inicio en julio, el año fiscal 2026 va de jul 2025 a jun 2026).
+ */
+declare function fiscalYear(year: number, startMonth?: number): CbPeriod;
+/** Trimestre `q` (1–4) del año fiscal `year`. */
+declare function quarterPeriod(year: number, q: number, startMonth?: number): CbPeriod;
+declare function rangePeriod(from: Date, to: Date): CbPeriod;
+/** Año fiscal al que pertenece una fecha. */
+declare function fiscalYearOf(date: Date, startMonth?: number): number;
+/** Trimestre fiscal (1–4) de una fecha. */
+declare function quarterOf(date: Date, startMonth?: number): number;
+/** Periodo de un atajo respecto a `today`. */
+declare function presetPeriod(preset: CbPeriodPreset, today: Date, startMonth?: number): CbPeriod;
+/** Meses (`AAAA-MM`) que abarca un periodo. */
+declare function monthsOf(period: CbPeriod): string[];
+/** Periodo a partir de su clave (`2026-10`, `2026-Q3`, `2026`, `2026-01-01_2026-03-31`). */
+declare function periodFromKey(key: string, startMonth?: number): CbPeriod | null;
+
+type Mode = Exclude<CbPeriodKind, 'range'>;
+interface Cell {
+    readonly period: CbPeriod;
+    readonly text: string;
+    readonly label: string;
+    readonly closed: boolean;
+    readonly disabled: boolean;
+}
+/**
+ * Selector de periodo contable de CaribeNG: mes, trimestre o año (fiscal), con
+ * atajos («Mes anterior», «Año a la fecha»…) y periodos cerrados marcados.
+ *
+ * - `fiscalYearStart` mueve el inicio del año fiscal (trimestres y años incluidos).
+ * - `closed` marca meses cerrados con un candado; con `disableClosed` no se eligen
+ *   (útil al contabilizar), sin él se pueden consultar (útil en informes).
+ * - Funciona con Angular Forms o con `[(value)]`; el valor es un `CbPeriod` con
+ *   `from`, `to`, `kind` y `key`.
+ *
+ * @example
+ * ```html
+ * <cb-period-picker label="Periodo" [(value)]="periodo" [closed]="cerrados" />
+ * ```
+ */
+declare class CbPeriodPicker implements ControlValueAccessor {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly injector;
+    private readonly uid;
+    readonly value: _angular_core.ModelSignal<CbPeriod | null>;
+    /** Vista de la cuadrícula: mes, trimestre o año. */
+    readonly mode: _angular_core.ModelSignal<Mode>;
+    /** Vistas disponibles y su orden. */
+    readonly modes: _angular_core.InputSignal<readonly Mode[]>;
+    /** Atajos del panel (lista vacía para quitarlos). */
+    readonly presets: _angular_core.InputSignal<readonly CbPeriodPreset[]>;
+    /** Mes en que empieza el año fiscal (1 = enero). */
+    readonly fiscalYearStart: _angular_core.InputSignal<number>;
+    /** Meses cerrados (`AAAA-MM`): se marcan con un candado. */
+    readonly closed: _angular_core.InputSignal<readonly string[]>;
+    /** No deja elegir periodos que incluyan meses cerrados. */
+    readonly disableClosed: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Primer y último día que se pueden elegir. */
+    readonly min: _angular_core.InputSignal<Date | null>;
+    readonly max: _angular_core.InputSignal<Date | null>;
+    /** «Hoy» para los atajos y el periodo actual (por defecto, la fecha del sistema). */
+    readonly today: _angular_core.InputSignal<Date>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly hint: _angular_core.InputSignal<string>;
+    readonly error: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<CbSize>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly requiredIndicator: _angular_core.InputSignal<CbRequiredIndicator | undefined>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly inputId: _angular_core.InputSignal<string>;
+    readonly periodChange: _angular_core.OutputEmitterRef<CbPeriod | null>;
+    protected readonly fieldState: _caribeng_ui.CbFieldState;
+    protected readonly positions: ConnectedPosition[];
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    private readonly cvaDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    private readonly trigger;
+    private readonly startMonth;
+    private readonly closedSet;
+    /** Año (o primer año de la docena, en la vista de años) que muestra la cuadrícula. */
+    protected readonly year: _angular_core.WritableSignal<number>;
+    private readonly decadeStart;
+    protected readonly cells: _angular_core.Signal<Cell[]>;
+    /** Celda con el foco (la elegida, la del periodo actual o la primera). */
+    protected readonly focusIndex: _angular_core.WritableSignal<number>;
+    protected readonly navTitle: _angular_core.Signal<string>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    private onChange;
+    private onTouched;
+    writeValue(value: CbPeriod | null): void;
+    registerOnChange(fn: (value: CbPeriod | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(disabled: boolean): void;
+    /** Nombre de un periodo: «Octubre de 2026», «T3 2026», «2026», «1 ene – 23 oct 2026». */
+    labelOf(period: CbPeriod): string;
+    protected modeLabel(mode: Mode): string;
+    protected presetLabel(preset: CbPeriodPreset): string;
+    protected isClosed(period: CbPeriod): boolean;
+    protected isCurrent(period: CbPeriod): boolean;
+    protected isPresetActive(preset: CbPeriodPreset): boolean;
+    protected presetDisabled(preset: CbPeriodPreset): boolean;
+    protected toggle(): void;
+    protected onTriggerKeydown(event: KeyboardEvent): void;
+    protected onOutsideClick(event: MouseEvent): void;
+    protected setMode(mode: Mode): void;
+    protected step(delta: number): void;
+    protected choose(cell: Cell): void;
+    protected choosePreset(preset: CbPeriodPreset): void;
+    protected onGridKeydown(event: KeyboardEvent): void;
+    private openPanel;
+    /** Cierra el panel (y devuelve el foco al botón si se cerró desde dentro). */
+    close(refocus: boolean): void;
+    private focusCell;
+    private setValue;
+    private day;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPeriodPicker, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPeriodPicker, "cb-period-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "modes": { "alias": "modes"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "fiscalYearStart": { "alias": "fiscalYearStart"; "required": false; "isSignal": true; }; "closed": { "alias": "closed"; "required": false; "isSignal": true; }; "disableClosed": { "alias": "disableClosed"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "requiredIndicator": { "alias": "requiredIndicator"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "mode": "modeChange"; "periodChange": "periodChange"; }, never, never, true, never>;
+}
+
+export { CbPeriodPicker, fiscalYear, fiscalYearOf, monthPeriod, monthsOf, periodFromKey, presetPeriod, quarterOf, quarterPeriod, rangePeriod };
+export type { CbPeriod, CbPeriodKind, CbPeriodPreset };
+//# sourceMappingURL=caribeng-ui-period-picker.d.ts.map

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

@@ -0,0 +1,168 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbRequiredIndicator, CbSize } from '@caribeng/ui';
+import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
+
+/**
+ * Datos de numeración telefónica de un país (plan nacional, ITU-T E.164).
+ * El "número nacional" es el que va después del prefijo internacional, sin el
+ * 0 (o el dígito) que se marca dentro del país.
+ */
+interface CbPhoneCountry {
+    /** Código ISO 3166-1 alfa-2 (`CO`). */
+    readonly iso: string;
+    /** Prefijo internacional sin `+` (`57`). */
+    readonly dial: string;
+    /** Longitudes válidas del número nacional. */
+    readonly lengths: readonly number[];
+    /** Formato por longitud con `#` por dígito (`{ 10: '### ### ####' }`). Sin él, grupos de 3. */
+    readonly formats?: Readonly<Record<number, string>>;
+    /** Dígito que se marca delante dentro del país y se quita al guardar (`0`). */
+    readonly trunk?: string;
+    /** Comienzos del número nacional para distinguir países que comparten prefijo (+1). */
+    readonly leading?: readonly string[];
+    /** Ejemplo de número nacional (se usa como placeholder). */
+    readonly example?: string;
+}
+/**
+ * Países incluidos: América Latina y el Caribe, Norteamérica, la Europa más
+ * habitual y los mayores de Asia y Oceanía. Amplíalos con `[countries]`.
+ */
+declare const CB_PHONE_COUNTRIES: readonly CbPhoneCountry[];
+/** Emoji de bandera a partir del código ISO (indicadores regionales). */
+declare function cbFlagEmoji(iso: string): string;
+/** Aplica el formato del país al número nacional (solo dígitos), también a medio escribir. */
+declare function cbFormatNational(country: CbPhoneCountry, digits: string): string;
+interface CbParsedPhone {
+    readonly country: CbPhoneCountry | null;
+    /** Número nacional (solo dígitos, sin prefijo ni 0 nacional). */
+    readonly national: string;
+}
+/**
+ * Interpreta lo escrito o pegado. Con `+` o `00` detecta el país por el prefijo
+ * (el más largo que coincide; entre los que comparten prefijo, por el comienzo
+ * del número o, si no, el país actual). Sin prefijo, usa `current` y quita su 0 nacional.
+ */
+declare function cbParsePhone(text: string, current: CbPhoneCountry | null, countries: readonly CbPhoneCountry[]): CbParsedPhone;
+/** Número completo en formato E.164 (`+573001234567`), o `''` sin dígitos. */
+declare function cbToE164(country: CbPhoneCountry | null, national: string): string;
+/** Si la longitud del número nacional es válida para el país. */
+declare function cbIsValidPhone(country: CbPhoneCountry | null, national: string): boolean;
+
+/** Cambio del teléfono con todos sus datos. */
+interface CbPhoneChange {
+    /** Formato internacional E.164 (`+573001234567`), o `''`. */
+    readonly e164: string;
+    /** Número nacional (solo dígitos). */
+    readonly national: string;
+    /** Código ISO del país (`CO`). */
+    readonly country: string;
+    /** La longitud es válida para el país. */
+    readonly valid: boolean;
+}
+/**
+ * Teléfono internacional de CaribeNG: selector de país (bandera, nombre y
+ * prefijo, con buscador) y número que se formatea mientras se escribe. El
+ * valor es E.164 (`+573001234567`), listo para guardar o enviar. Al pegar un
+ * número con `+` o `00` detecta el país.
+ *
+ * Funciona con Angular Forms (`formControlName`, `ngModel`) y añade el error
+ * `{ phone: true }` si el número está incompleto o no es válido para el país.
+ *
+ * @example
+ * ```html
+ * <cb-phone-input label="Celular" formControlName="celular" country="CO" [preferredCountries]="['CO', 'MX', 'US']" />
+ * ```
+ */
+declare class CbPhoneInput implements ControlValueAccessor, Validator {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly overlay;
+    private readonly vcr;
+    private readonly injector;
+    private readonly triggerEl;
+    private readonly fieldEl;
+    private readonly searchEl;
+    private readonly panelTpl;
+    private overlayRef;
+    protected readonly inputId: string;
+    protected readonly listId: string;
+    /** Número en formato E.164 (`+573001234567`); `''` si está vacío. */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** País seleccionado (código ISO). */
+    readonly country: _angular_core.ModelSignal<string>;
+    /** Países disponibles. Por defecto, `CB_PHONE_COUNTRIES`; puedes pasar otros o filtrar por código ISO. */
+    readonly countries: _angular_core.InputSignal<readonly (string | CbPhoneCountry)[]>;
+    /** Países que aparecen primero en la lista (código ISO). */
+    readonly preferredCountries: _angular_core.InputSignal<readonly string[]>;
+    /** Bloquea el país (solo se escribe el número). */
+    readonly countryLocked: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Muestra la bandera (emoji). En Windows algunos navegadores la muestran como letras. */
+    readonly showFlag: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly hint: _angular_core.InputSignal<string>;
+    /** Error a mostrar. Por defecto, "Número de teléfono incompleto o no válido" cuando lo es. */
+    readonly error: _angular_core.InputSignal<string | undefined>;
+    readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly requiredIndicator: _angular_core.InputSignal<CbRequiredIndicator | undefined>;
+    /** Placeholder. Por defecto, un número de ejemplo del país. */
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly size: _angular_core.InputSignal<CbSize>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Cada cambio con el número E.164, el nacional, el país y si es válido. */
+    readonly phoneChange: _angular_core.OutputEmitterRef<CbPhoneChange>;
+    protected readonly fieldState: _caribeng_ui.CbFieldState;
+    /** Número nacional (solo dígitos). */
+    private readonly national;
+    private readonly touched;
+    private readonly cvaDisabled;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly open: _angular_core.WritableSignal<boolean>;
+    protected readonly query: _angular_core.WritableSignal<string>;
+    protected readonly active: _angular_core.WritableSignal<number>;
+    private readonly displayNames;
+    protected readonly list: _angular_core.Signal<CbPhoneCountry[]>;
+    protected readonly selected: _angular_core.Signal<CbPhoneCountry | null>;
+    protected readonly filtered: _angular_core.Signal<CbPhoneCountry[]>;
+    protected readonly activeId: _angular_core.Signal<string | null>;
+    protected readonly display: _angular_core.Signal<string>;
+    protected readonly examplePlaceholder: _angular_core.Signal<string>;
+    protected readonly isValid: _angular_core.Signal<boolean>;
+    protected readonly showInvalid: _angular_core.Signal<boolean>;
+    protected readonly errorText: _angular_core.Signal<string>;
+    protected readonly countryLabel: _angular_core.Signal<string>;
+    protected readonly describedBy: _angular_core.Signal<string | null>;
+    private onChange;
+    private onTouched;
+    private onValidatorChange;
+    constructor();
+    protected flag(c: CbPhoneCountry): string;
+    protected name(c: CbPhoneCountry): string;
+    private normalize;
+    writeValue(value: string | null): void;
+    registerOnChange(fn: (value: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    validate(_control: AbstractControl): ValidationErrors | null;
+    registerOnValidatorChange(fn: () => void): void;
+    protected onInput(event: Event): void;
+    protected onBlur(): void;
+    /** Interpreta texto escrito, pegado o recibido (E.164 o nacional). */
+    private applyText;
+    private publish;
+    toggle(): void;
+    protected openFromKeyboard(event: Event): void;
+    private openPanel;
+    /** Cierra la lista de países. */
+    close(focusTrigger?: boolean): void;
+    protected choose(c: CbPhoneCountry): void;
+    protected onSearchKeydown(event: KeyboardEvent): void;
+    private scrollActiveIntoView;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPhoneInput, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPhoneInput, "cb-phone-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "country": { "alias": "country"; "required": false; "isSignal": true; }; "countries": { "alias": "countries"; "required": false; "isSignal": true; }; "preferredCountries": { "alias": "preferredCountries"; "required": false; "isSignal": true; }; "countryLocked": { "alias": "countryLocked"; "required": false; "isSignal": true; }; "showFlag": { "alias": "showFlag"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "requiredIndicator": { "alias": "requiredIndicator"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "country": "countryChange"; "phoneChange": "phoneChange"; }, never, never, true, never>;
+}
+
+export { CB_PHONE_COUNTRIES, CbPhoneInput, cbFlagEmoji, cbFormatNational, cbIsValidPhone, cbParsePhone, cbToE164 };
+export type { CbParsedPhone, CbPhoneChange, CbPhoneCountry };
+//# sourceMappingURL=caribeng-ui-phone-input.d.ts.map

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

@@ -0,0 +1,116 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbSummary, cbFormat } from '@caribeng/ui';
+import { CbXlsxSheet } from '@caribeng/ui/xlsx';
+
+/** Medida de la tabla dinámica: qué campo se agrega y cómo. */
+interface CbPivotValue {
+    readonly field: string;
+    readonly aggregate?: CbSummary;
+    readonly label?: string;
+    /** `currency` (por defecto), `number` o `integer`. */
+    readonly format?: 'currency' | 'number' | 'integer';
+}
+/** Dimensión disponible para filas o columnas (o medida, si es numérica). */
+interface CbPivotField {
+    readonly key: string;
+    readonly label: string;
+    /** Texto de cada valor (p. ej. nombre de la cuenta a partir del código). */
+    readonly format?: (value: unknown) => string;
+}
+/** Nodo de filas: un valor de una dimensión con sus hijos (siguiente dimensión). */
+interface PivotRowNode {
+    readonly key: string;
+    /** Ruta de valores desde la raíz (`['5135', 'Enel']`). */
+    readonly path: readonly string[];
+    readonly level: number;
+    readonly label: string;
+    readonly records: readonly Record<string, unknown>[];
+    readonly children: readonly PivotRowNode[];
+}
+/** Valores distintos (combinados) de las dimensiones de columna, ordenados. */
+declare function columnKeys(data: readonly Record<string, unknown>[], fields: readonly string[]): string[];
+/** Árbol de filas agrupando por cada dimensión de `fields`, en orden. */
+declare function rowTree(data: readonly Record<string, unknown>[], fields: readonly string[], labelOf: (field: string, value: string) => string, level?: number, path?: string[]): PivotRowNode[];
+/** Valor agregado de una medida sobre unos registros. */
+declare function aggregate(records: readonly Record<string, unknown>[], value: CbPivotValue): number | null;
+
+interface FlatRow {
+    readonly node: PivotRowNode;
+    readonly hasChildren: boolean;
+}
+/**
+ * Tabla dinámica de CaribeNG: cruza los registros por dimensiones de filas y
+ * columnas (cuenta, tercero, centro de costo, mes…) y agrega una o varias medidas.
+ *
+ * - Filas anidadas que se contraen, con subtotales; totales por fila, por columna y general.
+ * - Con `configurable`, el usuario elige desde la propia tabla las dimensiones y la medida.
+ * - Importes con la moneda de `provideCaribeNG`, exportación a Excel con niveles.
+ *
+ * @example
+ * ```html
+ * <cb-pivot [data]="movimientos" [fields]="dimensiones" [(rows)]="filas" [(columns)]="columnas" [values]="[{ field: 'valor' }]" configurable />
+ * ```
+ */
+declare class CbPivot {
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly fmt: typeof cbFormat;
+    private readonly config;
+    protected readonly uid: string;
+    /** Registros a cruzar. */
+    readonly data: _angular_core.InputSignal<readonly Record<string, unknown>[]>;
+    /** Dimensiones disponibles (clave, etiqueta y formato de sus valores). */
+    readonly fields: _angular_core.InputSignal<readonly CbPivotField[]>;
+    /** Dimensiones de las filas, de la más general a la más detallada (bidireccional). */
+    readonly rows: _angular_core.ModelSignal<readonly string[]>;
+    /** Dimensiones de las columnas (bidireccional). */
+    readonly columns: _angular_core.ModelSignal<readonly string[]>;
+    /** Medidas (campo y agregación); por defecto, suma. */
+    readonly values: _angular_core.InputSignal<readonly CbPivotValue[]>;
+    /** Selectores de filas, columnas y agregación sobre la tabla. */
+    readonly configurable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Las filas con hijos empiezan contraídas. */
+    readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly currency: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    private readonly collapsedKeys;
+    protected readonly aggregateOverride: _angular_core.WritableSignal<CbSummary | null>;
+    protected readonly measures: _angular_core.Signal<CbPivotValue[]>;
+    protected readonly aggregateValue: _angular_core.Signal<CbSummary>;
+    private readonly fieldMap;
+    private labelOf;
+    protected readonly colKeys: _angular_core.Signal<string[]>;
+    protected readonly colKeysWithTotal: _angular_core.Signal<string[]>;
+    private readonly tree;
+    protected readonly flat: _angular_core.Signal<FlatRow[]>;
+    private collapsedSet;
+    protected readonly dimensionOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    protected readonly columnOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    protected readonly aggregateOptions: _angular_core.Signal<{
+        label: string;
+        value: string;
+    }[]>;
+    protected rowHeader(): string;
+    protected colLabel(key: string): string;
+    protected measureLabel(m: CbPivotValue): string;
+    protected cell(records: readonly Record<string, unknown>[], colKey: string, m: CbPivotValue): number | null;
+    protected text(value: number | null, m: CbPivotValue): string;
+    protected isCollapsed(key: string): boolean;
+    protected toggle(key: string): void;
+    protected setRows(keys: readonly string[]): void;
+    /** Hoja de Excel con todas las filas (con niveles plegables) y los totales. */
+    toExcelSheet(): CbXlsxSheet;
+    exportExcel(filename?: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPivot, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPivot, "cb-pivot", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "configurable": { "alias": "configurable"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "rows": "rowsChange"; "columns": "columnsChange"; }, never, never, true, never>;
+}
+
+export { CbPivot, aggregate, columnKeys, rowTree };
+export type { CbPivotField, CbPivotValue, PivotRowNode };
+//# sourceMappingURL=caribeng-ui-pivot.d.ts.map

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

@@ -3,10 +3,19 @@ import * as _caribeng_ui from '@caribeng/ui';
 
 /** Ciclo de facturación del selector de precios. */
 type CbPricingBilling = 'monthly' | 'annual';
-/** Una característica de un plan. Puede ser texto o un objeto con estado. */
+/**
+ * Disposición de los planes:
+ * - `grid`: tarjetas que se reparten en varias filas según el ancho.
+ * - `horizontal`: todas las tarjetas en una sola fila (con scroll si no caben),
+ *   selector de facturación a la derecha del título y precio anual expresado por mes.
+ * - `list`: cada plan es una fila (cabecera, características y CTA).
+ */
+type CbPricingLayout = 'grid' | 'horizontal' | 'list';
+/** Una característica de un plan. Puede ser texto o un objeto con estado e icono. */
 type CbPricingFeature = string | {
     label: string;
     included?: boolean;
+    icon?: string;
 };
 /** Definición de un plan de precios. */
 interface CbPricingPlan {
@@ -26,6 +35,8 @@ interface CbPricingPlan {
     features?: CbPricingFeature[];
     /** Resalta el plan (destacado). */
     featured?: boolean;
+    /** Etiqueta junto al nombre. En el plan destacado vale "Recomendado" si se omite; `''` la oculta. */
+    badge?: string;
     /** Texto del botón (por defecto "Elegir {name}"). */
     ctaLabel?: string;
 }
@@ -42,16 +53,27 @@ interface CbPricingPlan {
 declare class CbPricing {
     /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
     protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly host;
     /** Planes a mostrar. */
     readonly plans: _angular_core.InputSignal<readonly CbPricingPlan[]>;
     /** Ciclo activo (two-way). */
     readonly billing: _angular_core.ModelSignal<CbPricingBilling>;
     /** Muestra el selector Mensual/Anual. */
     readonly showToggle: _angular_core.InputSignal<boolean>;
-    /** Disposición de los planes: 'grid' (tarjetas) u 'horizontal' (filas). */
-    readonly layout: _angular_core.InputSignal<"grid" | "horizontal">;
+    /** Disposición de los planes (ver {@link CbPricingLayout}). */
+    readonly layout: _angular_core.InputSignal<CbPricingLayout>;
     /** Título opcional sobre la tabla. */
     readonly title: _angular_core.InputSignal<string>;
+    /** Texto de ayuda bajo el título (solo en `horizontal`). */
+    readonly subtitle: _angular_core.InputSignal<string>;
+    /** Etiqueta junto a la opción anual (p. ej. "25% OFF"; solo en `horizontal`). */
+    readonly annualBadge: _angular_core.InputSignal<string>;
+    /**
+     * Cómo se muestra el precio anual: `total` (importe del año, "/año") o `monthly`
+     * (equivalente mensual, "/mes", con el total facturado y el ahorro debajo).
+     * Por defecto `monthly` en `horizontal` y `total` en el resto.
+     */
+    readonly annualDisplay: _angular_core.InputSignal<"monthly" | "total" | undefined>;
     /** Símbolo de moneda. */
     readonly currency: _angular_core.InputSignal<string>;
     /** Etiquetas configurables. */
@@ -63,13 +85,28 @@ declare class CbPricing {
     readonly ctaLabel: _angular_core.InputSignal<string | undefined>;
     /** Emite el plan elegido. */
     readonly planSelect: _angular_core.OutputEmitterRef<CbPricingPlan>;
+    protected readonly choices: readonly CbPricingBilling[];
+    protected readonly horizontal: _angular_core.Signal<boolean>;
     protected readonly annual: _angular_core.Signal<boolean>;
+    private readonly annualMonthly;
+    /** El precio visible es mensual (ciclo mensual, o anual expresado por mes). */
+    protected readonly perMonthShown: _angular_core.Signal<boolean>;
+    private readonly numberFormat;
+    protected num(n: number): string;
+    private annualOf;
     protected priceOf(p: CbPricingPlan): number;
     protected oldPriceOf(p: CbPricingPlan): number | undefined;
+    protected billedOf(p: CbPricingPlan): string;
+    protected savingOf(p: CbPricingPlan): number;
+    protected savingLabel(p: CbPricingPlan): string;
+    protected badgeOf(p: CbPricingPlan): string;
     protected labelOf(f: CbPricingFeature): string;
     protected includedOf(f: CbPricingFeature): boolean;
+    protected iconOf(f: CbPricingFeature): string;
+    /** Flechas dentro del grupo de opciones de facturación (patrón radiogroup). */
+    protected onChoiceKey(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPricing, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPricing, "cb-pricing", never, { "plans": { "alias": "plans"; "required": false; "isSignal": true; }; "billing": { "alias": "billing"; "required": false; "isSignal": true; }; "showToggle": { "alias": "showToggle"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "monthlyLabel": { "alias": "monthlyLabel"; "required": false; "isSignal": true; }; "annualLabel": { "alias": "annualLabel"; "required": false; "isSignal": true; }; "perMonthLabel": { "alias": "perMonthLabel"; "required": false; "isSignal": true; }; "perYearLabel": { "alias": "perYearLabel"; "required": false; "isSignal": true; }; "ctaLabel": { "alias": "ctaLabel"; "required": false; "isSignal": true; }; }, { "billing": "billingChange"; "planSelect": "planSelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPricing, "cb-pricing", never, { "plans": { "alias": "plans"; "required": false; "isSignal": true; }; "billing": { "alias": "billing"; "required": false; "isSignal": true; }; "showToggle": { "alias": "showToggle"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "annualBadge": { "alias": "annualBadge"; "required": false; "isSignal": true; }; "annualDisplay": { "alias": "annualDisplay"; "required": false; "isSignal": true; }; "currency": { "alias": "currency"; "required": false; "isSignal": true; }; "monthlyLabel": { "alias": "monthlyLabel"; "required": false; "isSignal": true; }; "annualLabel": { "alias": "annualLabel"; "required": false; "isSignal": true; }; "perMonthLabel": { "alias": "perMonthLabel"; "required": false; "isSignal": true; }; "perYearLabel": { "alias": "perYearLabel"; "required": false; "isSignal": true; }; "ctaLabel": { "alias": "ctaLabel"; "required": false; "isSignal": true; }; }, { "billing": "billingChange"; "planSelect": "planSelect"; }, never, never, true, never>;
 }
 
 export { CbPricing };

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

@@ -0,0 +1,88 @@
+import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+
+/** Nivel de corrección de errores: recupera ~7 % (L), 15 % (M), 25 % (Q) o 30 % (H) del código. */
+type CbQrErrorCorrection = 'L' | 'M' | 'Q' | 'H';
+/** Matriz QR: `modules[y][x]` es `true` en los módulos oscuros. */
+interface CbQrMatrix {
+    /** Versión elegida (1–40). */
+    readonly version: number;
+    /** Módulos por lado (17 + 4 × versión). */
+    readonly size: number;
+    readonly errorCorrection: CbQrErrorCorrection;
+    /** Máscara aplicada (0–7). */
+    readonly mask: number;
+    readonly modules: readonly (readonly boolean[])[];
+}
+interface CbQrEncodeOptions {
+    /** Por defecto `M`. */
+    errorCorrection?: CbQrErrorCorrection;
+    /** Versión mínima (1–40). Por defecto 1. */
+    minVersion?: number;
+}
+/** Codewords de corrección de `data` (resto de la división por el generador). */
+declare function cbQrReedSolomon(data: readonly number[], degree: number): number[];
+/** 15 bits de formato (nivel + máscara), ya con la máscara XOR del estándar. */
+declare function cbQrFormatBits(ec: CbQrErrorCorrection, mask: number): number;
+/**
+ * Codifica `text` como matriz QR. Elige el modo más compacto, la versión más
+ * pequeña que lo contiene y la máscara con menor penalización.
+ *
+ * @throws RangeError si el texto no cabe en la versión 40 con ese nivel.
+ */
+declare function cbQrEncode(text: string, options?: CbQrEncodeOptions): CbQrMatrix;
+/** Niveles ordenados de menor a mayor corrección. */
+declare const CB_QR_ERROR_CORRECTION_LEVELS: readonly CbQrErrorCorrection[];
+
+/**
+ * Código QR de CaribeNG, generado en SVG con un codificador propio (sin
+ * dependencias). Elige solo la versión y la máscara; admite color, fondo,
+ * margen y un logo centrado.
+ *
+ * @example
+ * ```html
+ * <cb-qrcode value="https://caribeng.dev" [size]="180" />
+ * <cb-qrcode [value]="pago" errorCorrection="H" image="assets/logo.svg" />
+ * ```
+ */
+declare class CbQrcode {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Texto o URL a codificar. */
+    readonly value: _angular_core.InputSignal<string>;
+    /** Lado en píxeles. */
+    readonly size: _angular_core.InputSignal<number>;
+    /** Corrección de errores. Usa `H` si pones un logo encima. */
+    readonly errorCorrection: _angular_core.InputSignal<CbQrErrorCorrection>;
+    /** Color de los módulos (cualquier color CSS). */
+    readonly color: _angular_core.InputSignal<string>;
+    /** Color de fondo. Mantén buen contraste con `color` para que se pueda leer. */
+    readonly background: _angular_core.InputSignal<string>;
+    /** Margen claro alrededor, en módulos (el estándar pide 4). */
+    readonly margin: _angular_core.InputSignal<number>;
+    /** Logo centrado (URL). Ocupa ~20 % del lado; combínalo con `errorCorrection="H"`. */
+    readonly image: _angular_core.InputSignal<string>;
+    /** Nombre accesible. Por defecto, "Código QR" del idioma activo. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Matriz codificada, o `null` si el valor está vacío o no cabe en un QR. */
+    readonly matrix: _angular_core.Signal<CbQrMatrix | null>;
+    protected readonly extent: _angular_core.Signal<number>;
+    protected readonly viewBox: _angular_core.Signal<string>;
+    protected readonly label: _angular_core.Signal<string>;
+    /** Módulos oscuros como un único path; une los consecutivos de cada fila. */
+    protected readonly path: _angular_core.Signal<string>;
+    /** Caja del logo (en módulos), centrada y alineada a la rejilla. */
+    protected readonly logo: _angular_core.Signal<{
+        box: number;
+        pad: number;
+        inset: number;
+    } | null>;
+    /** Marcado SVG del QR, p. ej. para descargarlo (`new Blob([qr.toSvg()], { type: 'image/svg+xml' })`). */
+    toSvg(): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbQrcode, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbQrcode, "cb-qrcode", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "errorCorrection": { "alias": "errorCorrection"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; "margin": { "alias": "margin"; "required": false; "isSignal": true; }; "image": { "alias": "image"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { CB_QR_ERROR_CORRECTION_LEVELS, CbQrcode, cbQrEncode, cbQrFormatBits, cbQrReedSolomon };
+export type { CbQrEncodeOptions, CbQrErrorCorrection, CbQrMatrix };
+//# sourceMappingURL=caribeng-ui-qrcode.d.ts.map