@caribeng/ui 22.1.1 → 22.4.0

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

@@ -1,4 +1,6 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
 
 interface CbOrganizationChartNode {
     key: string;
@@ -9,9 +11,13 @@ interface CbOrganizationChartNode {
     children?: readonly CbOrganizationChartNode[];
 }
 declare class CbOrganizationChart {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    /** Rellena `{0}`, `{1}`… de un texto traducido. */
+    protected readonly fmt: typeof cbFormat;
     readonly value: _angular_core.InputSignal<readonly CbOrganizationChartNode[]>;
     readonly selection: _angular_core.ModelSignal<CbOrganizationChartNode | null>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     protected readonly expanded: _angular_core.WritableSignal<ReadonlySet<string>>;
     protected toggle(key: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbOrganizationChart, never>;

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 interface CbPaginatorState {
     /** Índice del primer registro de la página. */
@@ -21,6 +22,8 @@ interface CbPaginatorState {
  * ```
  */
 declare class CbPaginator {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly totalRecords: _angular_core.InputSignal<number>;
     readonly rows: _angular_core.ModelSignal<number>;
     readonly first: _angular_core.ModelSignal<number>;

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
 /**
  * Panel de CaribeNG: contenedor con encabezado, cuerpo colapsable opcional y pie.
@@ -12,6 +13,8 @@ import * as _angular_core from '@angular/core';
  * ```
  */
 declare class CbPanel {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly uid;
     /** Título mostrado en la cabecera del panel. */
     readonly header: _angular_core.InputSignal<string>;

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

@@ -1,4 +1,6 @@
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { CbMenuCommandEvent } from '@caribeng/ui';
 
 interface CbPanelMenuItem {
     label: string;
@@ -6,12 +8,20 @@ interface CbPanelMenuItem {
     url?: string;
     disabled?: boolean;
     items?: readonly CbPanelMenuItem[];
+    /** Acción al elegir el item (además del evento de selección), como `command` en PrimeNG. */
+    command?: (event: CbMenuCommandEvent<CbPanelMenuItem>) => void;
+    /** `false` oculta el item. */
+    visible?: boolean;
 }
 /** Vertical menu with collapsible sections. */
 declare class CbPanelMenu {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     private readonly uid;
     readonly items: _angular_core.InputSignal<readonly CbPanelMenuItem[]>;
-    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Items sin los de `visible: false`. */
+    protected readonly visibleItems: _angular_core.Signal<CbPanelMenuItem[]>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly multiple: _angular_core.InputSignal<boolean>;
     readonly itemSelect: _angular_core.OutputEmitterRef<CbPanelMenuItem>;
     private readonly openItems;

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

@@ -1,5 +1,5 @@
-import * as _caribeng_ui from '@caribeng/ui';
 import * as _angular_core from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 import { ControlValueAccessor } from '@angular/forms';
 
 type CbPasswordSize = 'sm' | 'md' | 'lg';
@@ -9,6 +9,8 @@ type CbPasswordStrength = 'none' | 'weak' | 'medium' | 'strong';
  * indicador de fortaleza e integración completa con Angular Forms (CVA).
  */
 declare class CbPassword implements ControlValueAccessor {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly invalid: _angular_core.InputSignal<boolean>;
@@ -25,7 +27,7 @@ declare class CbPassword implements ControlValueAccessor {
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     readonly strengthScore: _angular_core.Signal<0 | 1 | 2 | 3>;
     readonly strength: _angular_core.Signal<CbPasswordStrength>;
-    protected readonly strengthLabel: _angular_core.Signal<"" | "Fortaleza: Débil" | "Fortaleza: Media" | "Fortaleza: Fuerte">;
+    protected readonly strengthLabel: _angular_core.Signal<string>;
     private onChange;
     private onTouched;
     toggleReveal(): void;

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

@@ -0,0 +1,258 @@
+import * as _angular_core from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
+import { cbFormat } from '@caribeng/ui';
+import * as pdfjs_dist from 'pdfjs-dist';
+
+/** Módulo de pdf.js (`pdfjs-dist`) que usa el visor. */
+type CbPdfJs = typeof pdfjs_dist;
+/** Documento abierto por pdf.js. */
+type CbPdfDocument = pdfjs_dist.PDFDocumentProxy;
+/** Página de un documento de pdf.js. */
+type CbPdfPage = pdfjs_dist.PDFPageProxy;
+/** Origen del documento: URL, bytes o un `Blob` / `File`. */
+type CbPdfSource = string | URL | ArrayBuffer | Uint8Array | Blob;
+/** Opciones globales del visor (`provideCbPdfViewer`). */
+interface CbPdfViewerOptions {
+    /**
+     * URL del worker de pdf.js. Por defecto `pdfjs/build/pdf.worker.min.mjs`,
+     * relativa al `<base href>` (ver la configuración de assets en la documentación).
+     */
+    workerSrc?: string;
+    /**
+     * Carpeta con los recursos de pdf.js (`cmaps/`, `standard_fonts/`, `wasm/`,
+     * `iccs/`). Por defecto `pdfjs/`.
+     */
+    assetsUrl?: string;
+    /**
+     * Carga de pdf.js. Por defecto su build `legacy` (se descarga al abrir el primer PDF):
+     * la build moderna usa APIs que los navegadores estables aún no tienen
+     * (`Map.prototype.getOrInsertComputed`, `Math.sumPrecise`) y la legacy las incluye.
+     */
+    loader?: () => Promise<CbPdfJs>;
+}
+declare const CB_PDF_VIEWER_OPTIONS: InjectionToken<CbPdfViewerOptions>;
+/**
+ * Configura el visor de PDF (worker, recursos y carga de pdf.js).
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideCaribeNG(), provideCbPdfViewer({ workerSrc: '/static/pdf.worker.min.mjs' })],
+ * });
+ * ```
+ */
+declare function provideCbPdfViewer(options: CbPdfViewerOptions): EnvironmentProviders;
+/** Recursos que pdf.js necesita, ya resueltos como URLs absolutas. */
+interface CbPdfResources {
+    cMapUrl: string;
+    standardFontDataUrl: string;
+    wasmUrl: string;
+    iccUrl: string;
+}
+/**
+ * Carga pdf.js una sola vez y configura su worker. Las URLs se resuelven contra
+ * el `<base href>` del documento: el worker de pdf.js las pediría relativas a
+ * su propio script.
+ */
+declare class CbPdfEngine {
+    private readonly options;
+    private readonly document;
+    private pdfjs?;
+    load(): Promise<CbPdfJs>;
+    resources(): CbPdfResources;
+    /**
+     * Resuelve una URL contra el `<base href>`, como Angular y `<img>`; pdf.js
+     * la resolvería contra la ruta actual (`/components/visor/doc.pdf`).
+     */
+    resolve(url: string | URL): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPdfEngine, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<CbPdfEngine>;
+}
+
+/** Posición dentro del texto de una página: elemento de texto de pdf.js y desplazamiento. */
+interface CbPdfTextPosition {
+    item: number;
+    offset: number;
+}
+/** Coincidencia de búsqueda. `end.offset` es exclusivo. */
+interface CbPdfMatch {
+    page: number;
+    start: CbPdfTextPosition;
+    end: CbPdfTextPosition;
+}
+
+/** Zoom: factor (1 = 100 %), ajustar al ancho o página completa. */
+type CbPdfZoom = number | 'page-width' | 'page-fit';
+/** Giro del documento, en grados. */
+type CbPdfRotation = 0 | 90 | 180 | 270;
+type ViewerState = 'idle' | 'loading' | 'password' | 'ready' | 'error';
+/**
+ * Visor de PDF sobre [pdf.js](https://mozilla.github.io/pdf.js/) (`pdfjs-dist`,
+ * dependencia opcional que se carga al abrir el primer documento).
+ *
+ * Renderiza las páginas a medida que se ven, con texto seleccionable y
+ * legible por lectores de pantalla, búsqueda (ignora tildes y mayúsculas),
+ * miniaturas, zoom, giro, descarga, impresión y documentos con contraseña.
+ *
+ * @example
+ * ```html
+ * <cb-pdf-viewer src="/docs/extracto.pdf" [(page)]="pagina" zoom="page-width" />
+ * ```
+ */
+declare class CbPdfViewer {
+    /** Textos de interfaz en el idioma activo (`provideCaribeNG({ locale })`). */
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    protected readonly format: typeof cbFormat;
+    /** Documento: URL, `ArrayBuffer`, `Uint8Array`, `Blob` o `File`. */
+    readonly src: _angular_core.InputSignal<CbPdfSource | null | undefined>;
+    /** Nombre del archivo al descargar (por defecto, el de la URL o del `File`). */
+    readonly fileName: _angular_core.InputSignal<string | undefined>;
+    /** Contraseña para abrir el documento sin pedirla. */
+    readonly password: _angular_core.InputSignal<string | undefined>;
+    /** Envía cookies en peticiones a otro origen. */
+    readonly withCredentials: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Cabeceras HTTP para descargar el documento (p. ej. `Authorization`). */
+    readonly httpHeaders: _angular_core.InputSignal<Record<string, string> | undefined>;
+    /** Página actual (desde 1). */
+    readonly page: _angular_core.ModelSignal<number>;
+    readonly zoom: _angular_core.ModelSignal<CbPdfZoom>;
+    readonly rotation: _angular_core.ModelSignal<CbPdfRotation>;
+    /** Panel de miniaturas abierto. */
+    readonly sidebar: _angular_core.ModelSignal<boolean>;
+    readonly showToolbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showSearch: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showThumbnails: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showRotate: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly downloadable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly printable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Nombre accesible del visor (por defecto, "Visor de PDF"). */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Documento abierto. */
+    readonly loaded: _angular_core.OutputEmitterRef<{
+        numPages: number;
+    }>;
+    /** No se pudo abrir el documento. */
+    readonly loadError: _angular_core.OutputEmitterRef<unknown>;
+    private readonly engine;
+    private readonly document;
+    private readonly injector;
+    private readonly isBrowser;
+    protected readonly uid: string;
+    protected readonly state: _angular_core.WritableSignal<ViewerState>;
+    protected readonly progress: _angular_core.WritableSignal<number | null>;
+    protected readonly passwordIncorrect: _angular_core.WritableSignal<boolean>;
+    protected readonly printProgress: _angular_core.WritableSignal<{
+        done: number;
+        total: number;
+    } | null>;
+    protected readonly numPages: _angular_core.WritableSignal<number>;
+    private readonly sizes;
+    private readonly box;
+    protected readonly query: _angular_core.WritableSignal<string>;
+    protected readonly matches: _angular_core.WritableSignal<CbPdfMatch[]>;
+    protected readonly matchIndex: _angular_core.WritableSignal<number>;
+    protected readonly searching: _angular_core.WritableSignal<boolean>;
+    protected readonly zoomLevels: number[];
+    private readonly viewport;
+    private readonly pageEls;
+    private readonly thumbEls;
+    private readonly searchInput;
+    private readonly passwordInput;
+    /** Factor de zoom efectivo (1 = 100 %). */
+    readonly scale: _angular_core.Signal<number>;
+    /** Tamaño de cada página en píxeles CSS con el zoom y el giro actuales. */
+    protected readonly pageBoxes: _angular_core.Signal<{
+        width: number;
+        height: number;
+        scaleFactor: number;
+        userUnit: number;
+    }[]>;
+    protected readonly thumbBoxes: _angular_core.Signal<{
+        width: number;
+        height: number;
+    }[]>;
+    /** Valor del selector de zoom. */
+    protected readonly zoomValue: _angular_core.Signal<string>;
+    protected readonly customZoom: _angular_core.Signal<number | null>;
+    protected readonly searchStatus: _angular_core.Signal<string>;
+    private pdfjs?;
+    private pdf?;
+    private loadingTask?;
+    private passwordCallback?;
+    private loadToken;
+    private searchToken;
+    private searchTimer?;
+    private readonly pages;
+    private readonly texts;
+    private readonly indexes;
+    private readonly rendered;
+    private readonly thumbs;
+    private readonly visible;
+    private readonly visibleThumbs;
+    private pageObserver?;
+    private thumbObserver?;
+    private resizeObserver?;
+    /** Página que se ve al desplazarse (distingue el scroll del usuario de un cambio de `page`). */
+    private visiblePage;
+    private scrollFrame;
+    private scrollToMatch;
+    constructor();
+    goToPage(page: number): void;
+    previousPage(): void;
+    nextPage(): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    /** Gira 90° a la derecha (o a la izquierda con `-1`). */
+    rotate(direction?: 1 | -1): void;
+    /** Busca en todo el documento; resalta y lleva a la primera coincidencia. */
+    search(query: string): Promise<void>;
+    findNext(): void;
+    findPrevious(): void;
+    /** Descarga el documento original. */
+    download(): Promise<void>;
+    /** Imprime el documento (no la página de la aplicación). */
+    print(): Promise<void>;
+    private open;
+    protected submitPassword(event: Event, value: string): void;
+    /** Lee el tamaño real de todas las páginas (pueden ser distintas de la primera). */
+    private measurePages;
+    private close;
+    private getPage;
+    private textContent;
+    private textIndex;
+    /** Observa qué páginas están cerca de la vista para renderizar solo esas. */
+    private observePages;
+    private renderVisible;
+    private renderPage;
+    private unrender;
+    private observeThumbs;
+    private renderThumbs;
+    private renderThumb;
+    private selectMatch;
+    private refreshHighlights;
+    private highlightPage;
+    protected onSearchInput(value: string): void;
+    protected onSearchKeydown(event: KeyboardEvent, value: string): void;
+    protected onScroll(): void;
+    private mostVisiblePage;
+    private scrollToPage;
+    private readAnchor;
+    private restoreAnchor;
+    private observeResize;
+    private pageEl;
+    protected onPageInput(event: Event): void;
+    protected onZoomSelect(value: string): void;
+    protected onThumbKeydown(event: KeyboardEvent, n: number): void;
+    protected onHostKeydown(event: KeyboardEvent): void;
+    protected onWheel(event: WheelEvent): void;
+    protected percent(zoom: number): string;
+    private downloadName;
+    private rotatedPoints;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPdfViewer, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPdfViewer, "cb-pdf-viewer", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "password": { "alias": "password"; "required": false; "isSignal": true; }; "withCredentials": { "alias": "withCredentials"; "required": false; "isSignal": true; }; "httpHeaders": { "alias": "httpHeaders"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "rotation": { "alias": "rotation"; "required": false; "isSignal": true; }; "sidebar": { "alias": "sidebar"; "required": false; "isSignal": true; }; "showToolbar": { "alias": "showToolbar"; "required": false; "isSignal": true; }; "showSearch": { "alias": "showSearch"; "required": false; "isSignal": true; }; "showThumbnails": { "alias": "showThumbnails"; "required": false; "isSignal": true; }; "showRotate": { "alias": "showRotate"; "required": false; "isSignal": true; }; "downloadable": { "alias": "downloadable"; "required": false; "isSignal": true; }; "printable": { "alias": "printable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; "zoom": "zoomChange"; "rotation": "rotationChange"; "sidebar": "sidebarChange"; "loaded": "loaded"; "loadError": "loadError"; }, never, never, true, never>;
+}
+
+export { CB_PDF_VIEWER_OPTIONS, CbPdfEngine, CbPdfViewer, provideCbPdfViewer };
+export type { CbPdfDocument, CbPdfJs, CbPdfMatch, CbPdfPage, CbPdfRotation, CbPdfSource, CbPdfTextPosition, CbPdfViewerOptions, CbPdfZoom };
+//# sourceMappingURL=caribeng-ui-pdfviewer.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-picklist.d.ts

@@ -1,14 +1,74 @@
 import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _caribeng_ui from '@caribeng/ui';
 
+/** Contexto de `<ng-template cbPickListItem let-item let-list="list">`. */
+interface CbPickListItemContext<T = any> {
+    $implicit: T;
+    index: number;
+    list: 'source' | 'target';
+}
+/** Plantilla de cada elemento de un `<cb-picklist>`. */
+declare class CbPickListItemTemplate {
+    readonly template: TemplateRef<CbPickListItemContext<any>>;
+    static ngTemplateContextGuard(_dir: CbPickListItemTemplate, ctx: unknown): ctx is CbPickListItemContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPickListItemTemplate, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CbPickListItemTemplate, "ng-template[cbPickListItem]", never, {}, {}, never, never, true, never>;
+}
+/** Elementos transferidos entre listas. */
+interface CbPickListMoveEvent {
+    to: 'source' | 'target';
+    items: readonly unknown[];
+}
+type Side = 'source' | 'target';
+/**
+ * PickList de CaribeNG: transfiere elementos entre una lista de disponibles y
+ * otra de seleccionados, con botones, doble clic o teclado (Espacio marca,
+ * Enter transfiere).
+ *
+ * @example
+ * ```html
+ * <cb-picklist [(source)]="disponibles" [(target)]="asignados" sourceHeader="Permisos" targetHeader="Asignados">
+ *   <ng-template cbPickListItem let-permiso>{{ permiso.nombre }}</ng-template>
+ * </cb-picklist>
+ * ```
+ */
 declare class CbPickList {
-    readonly source: _angular_core.ModelSignal<readonly string[]>;
-    readonly target: _angular_core.ModelSignal<readonly string[]>;
-    protected readonly selected: _angular_core.WritableSignal<ReadonlySet<string>>;
-    protected toggle(item: string): void;
-    protected move(toTarget: boolean): void;
+    protected readonly t: _angular_core.Signal<_caribeng_ui.CbTranslation>;
+    private readonly host;
+    private readonly uid;
+    /** Elementos disponibles (two-way). */
+    readonly source: _angular_core.ModelSignal<readonly unknown[]>;
+    /** Elementos seleccionados (two-way). */
+    readonly target: _angular_core.ModelSignal<readonly unknown[]>;
+    /** Título de la lista de origen. Por defecto, "Disponibles" del idioma activo. */
+    readonly sourceHeader: _angular_core.InputSignal<string | undefined>;
+    /** Título de la lista de destino. Por defecto, "Seleccionados" del idioma activo. */
+    readonly targetHeader: _angular_core.InputSignal<string | undefined>;
+    /** Se emite tras transferir elementos. */
+    readonly moved: _angular_core.OutputEmitterRef<CbPickListMoveEvent>;
+    protected readonly itemTemplate: _angular_core.Signal<CbPickListItemTemplate | undefined>;
+    /** Posiciones marcadas en cada lista. */
+    protected readonly selected: _angular_core.WritableSignal<Record<Side, ReadonlySet<number>>>;
+    private readonly focused;
+    protected headerId(side: Side): string;
+    protected isSelected(side: Side, index: number): boolean;
+    protected tabbable(side: Side): number;
+    protected setFocused(side: Side, index: number): void;
+    protected toggle(side: Side, index: number): void;
+    /** Transfiere los elementos marcados al lado indicado. */
+    protected move(to: Side): void;
+    /** Transfiere todos los elementos al lado indicado. */
+    protected moveAll(to: Side): void;
+    /** Transfiere un único elemento al otro lado (doble clic). */
+    protected moveOne(from: Side, index: number): void;
+    protected onKeydown(event: KeyboardEvent, side: Side): void;
+    private list;
+    private transfer;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CbPickList, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPickList, "cb-picklist", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; }, { "source": "sourceChange"; "target": "targetChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CbPickList, "cb-picklist", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "sourceHeader": { "alias": "sourceHeader"; "required": false; "isSignal": true; }; "targetHeader": { "alias": "targetHeader"; "required": false; "isSignal": true; }; }, { "source": "sourceChange"; "target": "targetChange"; "moved": "moved"; }, ["itemTemplate"], never, true, never>;
 }
 
-export { CbPickList };
+export { CbPickList, CbPickListItemTemplate };
+export type { CbPickListItemContext, CbPickListMoveEvent };
 //# sourceMappingURL=caribeng-ui-picklist.d.ts.map